Lang Typescript

lang-typescript

Core Principles

• Prefer explicit types over any. If you need any, use unknown and narrow it.
• Favor interface for object shapes, type for unions, intersections, and mapped types.
• Keep functions pure where possible. Isolate side effects at the edges.
• Angular: keep components thin. Business logic belongs in services, not templates or components.

Reference

MUST DO

• Enable strict: true in tsconfig.json
• Type all function parameters and return values explicitly
• Use readonly on properties that should not be mutated
• Unsubscribe from Observables in Angular components (use takeUntilDestroyed or DestroyRef)
• Inject dependencies via constructor in Angular services, not inject() at module level
• Use const by default; let only when reassignment is necessary

MUST NOT

• Use any — use unknown and narrow, or define a proper type
• Subscribe inside a subscribe (use switchMap, mergeMap, etc.)
• Mutate objects passed as inputs or function arguments
• Use @ts-ignore without a comment explaining why
• Use setTimeout for async coordination — use Promises or Observables instead

Agent Behavior

• Before creating a new service or component, use tree-sitter find_similar_code to detect existing patterns that could be reused or extended.
• Use tree-sitter find_usage: subscribe to locate all Observable subscriptions and verify each has a corresponding takeUntilDestroyed or DestroyRef teardown.
• Use tree-sitter find_usage: any for a targeted audit of any type usages before enforcing strict types.
• Use tree-sitter get_symbols(symbol_types: ["functions", "classes"]) to map a module's public surface before modifying its interface.