angular_ts 0.34.0

Official Dart Web facade for authoring AngularTS applications.

AngularTS Dart Integration

This package is the official Dart Web facade for authoring AngularTS applications from Dart.

The integration is strict by default:

• Dependency injection uses typed Token<T> values.
• Factory helpers inject0 through inject8 preserve dependency types.
• Runtime config uses typed Dart objects before crossing into JavaScript.
• Dynamic interop is isolated under explicit unsafe APIs.

The package version follows the AngularTS runtime version and is published separately from the npm runtime.

Generated And Handwritten APIs

The package has two Dart API layers:

• lib/src/generated/ng_facades.dart is generated from @types/namespace.d.ts. It contains deterministic raw JavaScript facades for public ng namespace types and carries their TypeScript API descriptions as Dartdoc on generated types and members. Callable members preserve source parameter names and document every parameter.
• Handwritten files under lib/src/ expose the Dart-facing API: typed tokens, value objects, builders, config objects, and curated wrappers that convert Dart values at JavaScript boundaries.

Generated facades are intentionally thin and broad. Handwritten APIs remain the place for Dart-native types, ergonomic return values, and runtime conversion. When a handwritten wrapper can safely reuse generated raw access, it extends the generated facade and keeps only the curated members in handwritten code. make check enforces this split: wrappers must use generated bases when one is available, and every explicit manual override must have a handwritten Dart member. Type overrides in tool/generator-overrides.json are reserved for stable platform mappings such as DOM and stream types from package:web; parity checks reject stale type overrides.

Programmatic Views

Component.view and Directive.view receive a typed ProgrammaticViewContext. Its controller, required, scope, host, and transclude members map directly to the AngularTS runtime context. AngularTsRuntime.global().tags creates real DOM without parsing HTML:

final tags = AngularTsRuntime.global().tags;
final button = tags.tag(
  'button',
  properties: {'type': 'button'},
  children: [reactiveViewChild(() => controller.label)],
);

Use tags.namespace(uri) for SVG or MathML factories.

Install the published package with dart pub add angular_ts.

WASM Scope And App Models

Generated WasmScope facades, when enabled, represent the view-scope ABI only. They should be used for DOM/root-scoped controller or component state. App-owned state belongs to app.model(...); durable or shared state should synchronize with external runtimes through host-side AngularTS services or model.sync(...) targets. Dart wrappers should not add model handles or model watch imports unless the shared WASM ABI adds that surface.

Regenerate raw facades after public namespace type changes:

make generate

Check generated freshness:

make generate-check

See COVERAGE.md for the current AngularTS API coverage and NG_NAMESPACE_PARITY.md for the public ng namespace type parity checklist.

Checks

Run the complete Dart integration contract:

make check

That verifies generated bindings are fresh, Dart analysis is clean, Chrome tests pass, ng namespace type and member parity are current, manual override metadata matches handwritten members, wrappers use generated bases when available, and the demo compiles and runs against the repository dist runtime.

Local Demo

Build the Dart example:

make example-build

For a full runtime smoke test, build and test against the repository dist artifact:

make runtime-test

Start the repository static server from the repo root:

make serve

Open:

http://localhost:4000/integrations/dart/example/basic_app/