$ show DesignLiquido/delegua
Delégua is a complete multi-dialect programming language implementation written in TypeScript, aimed at Portuguese-speaking learners and hobbyists. The repository contains the full language toolchain: lexers, recursive-descent parsers, tree-walking interpreters, a semantic analyzer, a code formatter, a rule-based stylizer/linter, debugger support, and translators to JavaScript, Python, Ruby, Elixir, AssemblyScript, MermaidJS, and back from Python and JavaScript. Instead of a single monolithic parser, the project implements a family of Portuguese-language dialects — Delégua, Pituguês, Égua Clássico, Calango, Portugol IPT, Tenda, Prisma, and Guarani — sharing a common AST, visitor interfaces, scope-stack model, and standard-library primitives. The main entry point is the npm package `@designliquido/delegua`, which powers a CLI, VSCode extension, and web editors. Source text flows through lexer → parser → AST → interpreter/translator/stylizer, with dialect-specific overrides at each layer. The architecture is genuinely well-layered: AST nodes implement the visitor pattern, interfaces in `fontes/interfaces` decouple subsystems, and each dialect extends shared base classes for lexing, parsing, and interpretation. The most notable subsystems are the base interpreter with its scope-stack/heap memory model, the Pituguês semantic analyzer with type inference and compile-time diagnostics, the ANTLR-based Python reverse translator, and the debugger implementation with breakpoints and step commands. The project has a large Jest test suite, CI workflows, CodeQL scanning, and dependabot configuration, indicating professional-level process. The codebase is not without significant debt. Multiple dialects duplicate standard-library primitives with small spelling variations, several visitor methods explicitly throw 'not implemented', translators have documented limitations, and the code relies heavily on `any` casts and copy-pasted validation logic. Some dialect modules appear unfinished or exploratory. This is best described as an ambitious, actively developed educational language project rather than a hardened production runtime; the core design is strong, but breadth and dialect churn create real maintenance risk. There is no data-processing or research component; this is purely an application/compiler project.
The LLM identified 3 files worth highlighting for reuse:
Implements class descriptors with C3 linearization for deterministic multiple-inheritance resolution, polymorphic method dispatch, abstract-class enforcement, and getter/setter metadata. The MRO algorithm and class metadata model are self-contained enough to be reusable in other interpreters, type checkers, or object systems needing safe multiple inheritance.
A complete Python-to-Delégua translator built as an ANTLR4 visitor. It maps Python builtins and methods such as print→escreva, append→adicionar, and join→juntar, and handles classes, exceptions, lambdas, list comprehensions, and control flow. This demonstrates a reusable pattern for converting a mainstream language into an educational pseudocode dialect and for building AST-driven translators with semantic mappings.
A deep semantic analyzer for the Pituguês dialect that validates types, checks function-call signatures, folds constants, detects division by zero at compile time, tracks variable initialization and unused variables, and returns structured diagnostics rather than throwing. Its combination of AST visiting, scope tracking, and non-blocking diagnostic reporting is a reusable blueprint for static analyzers in other small languages.