@a2ui/angular 0.9.0-alpha.3 → 0.9.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a2ui/angular",
-  "version": "0.9.0-alpha.3",
+  "version": "0.9.0",
   "license": "Apache-2.0",
   "homepage": "https://a2ui.org/",
   "repository": {
@@ -20,7 +20,7 @@
     "renderer"
   ],
   "dependencies": {
-    "@a2ui/web_core": "^0.9.1-alpha.3",
+    "@a2ui/web_core": "^0.9.1",
     "@preact/signals-core": "^1.13.0",
     "tslib": "^2.3.0",
     "zod": "^3.25.76"
@@ -29,7 +29,7 @@
     "@angular/common": "^21.2.0",
     "@angular/core": "^21.2.0",
     "@angular/platform-browser": "^21.2.0",
-    "@a2ui/markdown-it": "^0.0.2-alpha.3"
+    "@a2ui/markdown-it": "^0.0.2"
   },
   "peerDependenciesMeta": {
     "@a2ui/markdown-it": {

package/types/a2ui-angular-src-v0_9.d.ts

@@ -1,5 +1,5 @@
 import * as _angular_core from '@angular/core';
-import { Type, InjectionToken, OnDestroy, OnInit, Signal, DestroyRef, NgZone } from '@angular/core';
+import { Type, InjectionToken, OnDestroy, Signal, OnInit, DestroyRef, NgZone } from '@angular/core';
 import { Catalog, ComponentApi, A2uiClientAction, A2uiMessage, SurfaceGroupModel, ComponentContext, Signal as Signal$1, FunctionImplementation } from '@a2ui/web_core/v0_9';
 export { signal as preactSignal } from '@a2ui/web_core/v0_9';
 export { BASIC_FUNCTIONS } from '@a2ui/web_core/v0_9/basic_catalog';
@@ -108,56 +108,6 @@ declare class A2uiRendererService implements OnDestroy {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<A2uiRendererService>;
 }
 
-/**
- * Dynamically renders an A2UI component as defined in the current surface model.
- *
- * This component acts as a bridge between the A2UI surface model and Angular components.
- * It resolves the appropriate component from the catalog based on the component's type,
- * and uses {@link ComponentBinder} to create reactive property bindings.
- *
- * Usually, you'll use the higher-level {@link SurfaceComponent} which automatically
- * sets up a host for the 'root' component.
- */
-declare class ComponentHostComponent implements OnInit {
-    /** The key of the component to render, either an ID string or an object with ID and basePath. Defaults to 'root'. */
-    componentKey: _angular_core.InputSignal<string | {
-        id: string;
-        basePath: string;
-    }>;
-    /** The unique identifier of the surface this component belongs to. */
-    surfaceId: _angular_core.InputSignal<string>;
-    private rendererService;
-    private binder;
-    private destroyRef;
-    protected componentType: Type<any> | null;
-    protected props: any;
-    private context?;
-    protected resolvedComponentId: string;
-    protected resolvedDataContextPath: string;
-    ngOnInit(): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ComponentHostComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ComponentHostComponent, "a2ui-v09-component-host", never, { "componentKey": { "alias": "componentKey"; "required": false; "isSignal": true; }; "surfaceId": { "alias": "surfaceId"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
-}
-
-/**
- * High-level component for rendering an entire A2UI surface.
- *
- * This component handles the boilerplate of setting up a {@link ComponentHostComponent}
- * for the 'root' component of a surface. It is the recommended way to embed an
- * A2UI surface in an Angular application.
- */
-declare class SurfaceComponent {
-    /** The unique identifier of the surface to render. */
-    surfaceId: _angular_core.InputSignal<string>;
-    /**
-     * The path within the surface's data model that represents the current state.
-     * Defaults to the root ('/').
-     */
-    dataContextPath: _angular_core.InputSignal<string>;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SurfaceComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SurfaceComponent, "a2ui-v09-surface", never, { "surfaceId": { "alias": "surfaceId"; "required": true; "isSignal": true; }; "dataContextPath": { "alias": "dataContextPath"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
-}
-
 /**
  * Copyright 2026 Google LLC
  *
@@ -207,6 +157,65 @@ interface BoundProperty<T = any> {
     readonly onUpdate: (newValue: T) => void;
 }
 
+/**
+ * Dynamically renders an A2UI component as defined in the current surface model.
+ *
+ * This component acts as a bridge between the A2UI surface model and Angular components.
+ * It resolves the appropriate component from the catalog based on the component's type,
+ * and uses {@link ComponentBinder} to create reactive property bindings.
+ *
+ * Usually, you'll use the higher-level {@link SurfaceComponent} which automatically
+ * sets up a host for the 'root' component.
+ */
+declare class ComponentHostComponent implements OnInit {
+    /** The key of the component to render, either an ID string or an object with ID and basePath. Defaults to 'root'. */
+    componentKey: _angular_core.InputSignal<string | {
+        id: string;
+        basePath: string;
+    }>;
+    /** The unique identifier of the surface this component belongs to. */
+    surfaceId: _angular_core.InputSignal<string>;
+    private readonly rendererService;
+    private readonly binder;
+    private readonly destroyRef;
+    private readonly cdr;
+    protected componentType: Type<any> | null;
+    protected props: Record<string, BoundProperty>;
+    private context?;
+    protected weight: _angular_core.WritableSignal<string | number | null>;
+    get flexStyle(): string;
+    protected resolvedComponentId: string;
+    protected resolvedDataContextPath: string;
+    ngOnInit(): void;
+    private initializeComponent;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ComponentHostComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ComponentHostComponent, "a2ui-v09-component-host", never, { "componentKey": { "alias": "componentKey"; "required": false; "isSignal": true; }; "surfaceId": { "alias": "surfaceId"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * High-level component for rendering an entire A2UI surface.
+ *
+ * This component handles the boilerplate of setting up a {@link ComponentHostComponent}
+ * for the 'root' component of a surface. It is the recommended way to embed an
+ * A2UI surface in an Angular application.
+ */
+declare class SurfaceComponent {
+    /** The unique identifier of the surface to render. */
+    surfaceId: _angular_core.InputSignal<string>;
+    /**
+     * The path within the surface's data model that represents the current state.
+     * Defaults to the root ('/').
+     */
+    dataContextPath: _angular_core.InputSignal<string>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SurfaceComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SurfaceComponent, "a2ui-v09-surface", never, { "surfaceId": { "alias": "surfaceId"; "required": true; "isSignal": true; }; "dataContextPath": { "alias": "dataContextPath"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/** Represents a reference to a child component. */
+interface Child {
+    id: string;
+    basePath: string;
+}
 /**
  * Binds A2UI ComponentModel properties to reactive Angular Signals.
  *
@@ -259,6 +268,30 @@ declare function toAngularSignal<T>(preactSignal: Signal$1<T>, destroyRef: Destr
  */
 declare function getNormalizedPath(path: string, dataContextPath: string, index: number): string;
 
+interface MarkdownRendererOptions {
+    tagClassMap?: Record<string, string>;
+}
+declare abstract class MarkdownRenderer {
+    abstract render(markdown: string, options?: MarkdownRendererOptions): Promise<string>;
+}
+declare class DefaultMarkdownRenderer extends MarkdownRenderer {
+    private static warningLogged;
+    render(markdown: string, options?: MarkdownRendererOptions): Promise<string>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DefaultMarkdownRenderer, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<DefaultMarkdownRenderer>;
+}
+declare function provideMarkdownRenderer(renderFn?: (markdown: string, options?: MarkdownRendererOptions) => Promise<string>): {
+    provide: typeof MarkdownRenderer;
+    useValue: {
+        render: (markdown: string, options?: MarkdownRendererOptions) => Promise<string>;
+    };
+    useClass?: undefined;
+} | {
+    provide: typeof MarkdownRenderer;
+    useClass: typeof DefaultMarkdownRenderer;
+    useValue?: undefined;
+};
+
 /**
  * The set of default Angular implementations for each component in the basic catalog.
  */
@@ -675,6 +708,11 @@ declare class ListComponent extends BasicCatalogComponent {
     children: _angular_core.Signal<any[]>;
     listTag: _angular_core.Signal<"ol" | "ul" | "div">;
     styleType: _angular_core.Signal<"" | "none">;
+    /**
+     * Track-by function to ensure stable change detection for list items.
+     * Uses the full resolved path (`basePath/id`) to uniquely identify items.
+     */
+    readonly trackBy: (index: number, item: Child) => string;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ListComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ListComponent, "a2ui-v09-list", never, { "props": { "alias": "props"; "required": false; "isSignal": true; }; "surfaceId": { "alias": "surfaceId"; "required": true; "isSignal": true; }; "componentId": { "alias": "componentId"; "required": false; "isSignal": true; }; "dataContextPath": { "alias": "dataContextPath"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
@@ -960,5 +998,5 @@ declare class DateTimeInputComponent extends BasicCatalogComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DateTimeInputComponent, "a2ui-v09-date-time-input", never, { "props": { "alias": "props"; "required": false; "isSignal": true; }; "surfaceId": { "alias": "surfaceId"; "required": true; "isSignal": true; }; "componentId": { "alias": "componentId"; "required": false; "isSignal": true; }; "dataContextPath": { "alias": "dataContextPath"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-export { A2UI_RENDERER_CONFIG, A2uiRendererService, AngularCatalog, AudioPlayerComponent, BASIC_COMPONENTS, BasicCatalog, BasicCatalogBase, ButtonComponent, CardComponent, CheckBoxComponent, ChoicePickerComponent, ColumnComponent, ComponentBinder, ComponentHostComponent, DateTimeInputComponent, DividerComponent, IconComponent, ImageComponent, ListComponent, ModalComponent, RowComponent, SliderComponent, SurfaceComponent, TabsComponent, TextComponent, TextFieldComponent, VideoComponent, getNormalizedPath, toAngularSignal };
-export type { AngularComponentImplementation, BasicCatalogOptions, BoundProperty, RendererConfiguration };
+export { A2UI_RENDERER_CONFIG, A2uiRendererService, AngularCatalog, AudioPlayerComponent, BASIC_COMPONENTS, BasicCatalog, BasicCatalogBase, ButtonComponent, CardComponent, CheckBoxComponent, ChoicePickerComponent, ColumnComponent, ComponentBinder, ComponentHostComponent, DateTimeInputComponent, DefaultMarkdownRenderer, DividerComponent, IconComponent, ImageComponent, ListComponent, MarkdownRenderer, ModalComponent, RowComponent, SliderComponent, SurfaceComponent, TabsComponent, TextComponent, TextFieldComponent, VideoComponent, getNormalizedPath, provideMarkdownRenderer, toAngularSignal };
+export type { AngularComponentImplementation, BasicCatalogOptions, BoundProperty, Child, MarkdownRendererOptions, RendererConfiguration };

package/types/a2ui-angular-v0_9.d.ts

@@ -1,5 +1,5 @@
 import * as _angular_core from '@angular/core';
-import { Type, InjectionToken, OnDestroy, OnInit, Signal, DestroyRef, NgZone } from '@angular/core';
+import { Type, InjectionToken, OnDestroy, Signal, OnInit, DestroyRef, NgZone } from '@angular/core';
 import { Catalog, ComponentApi, A2uiClientAction, A2uiMessage, SurfaceGroupModel, ComponentContext, Signal as Signal$1, FunctionImplementation } from '@a2ui/web_core/v0_9';
 export { signal as preactSignal } from '@a2ui/web_core/v0_9';
 export { BASIC_FUNCTIONS } from '@a2ui/web_core/v0_9/basic_catalog';
@@ -108,56 +108,6 @@ declare class A2uiRendererService implements OnDestroy {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<A2uiRendererService>;
 }
 
-/**
- * Dynamically renders an A2UI component as defined in the current surface model.
- *
- * This component acts as a bridge between the A2UI surface model and Angular components.
- * It resolves the appropriate component from the catalog based on the component's type,
- * and uses {@link ComponentBinder} to create reactive property bindings.
- *
- * Usually, you'll use the higher-level {@link SurfaceComponent} which automatically
- * sets up a host for the 'root' component.
- */
-declare class ComponentHostComponent implements OnInit {
-    /** The key of the component to render, either an ID string or an object with ID and basePath. Defaults to 'root'. */
-    componentKey: _angular_core.InputSignal<string | {
-        id: string;
-        basePath: string;
-    }>;
-    /** The unique identifier of the surface this component belongs to. */
-    surfaceId: _angular_core.InputSignal<string>;
-    private rendererService;
-    private binder;
-    private destroyRef;
-    protected componentType: Type<any> | null;
-    protected props: any;
-    private context?;
-    protected resolvedComponentId: string;
-    protected resolvedDataContextPath: string;
-    ngOnInit(): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ComponentHostComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ComponentHostComponent, "a2ui-v09-component-host", never, { "componentKey": { "alias": "componentKey"; "required": false; "isSignal": true; }; "surfaceId": { "alias": "surfaceId"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
-}
-
-/**
- * High-level component for rendering an entire A2UI surface.
- *
- * This component handles the boilerplate of setting up a {@link ComponentHostComponent}
- * for the 'root' component of a surface. It is the recommended way to embed an
- * A2UI surface in an Angular application.
- */
-declare class SurfaceComponent {
-    /** The unique identifier of the surface to render. */
-    surfaceId: _angular_core.InputSignal<string>;
-    /**
-     * The path within the surface's data model that represents the current state.
-     * Defaults to the root ('/').
-     */
-    dataContextPath: _angular_core.InputSignal<string>;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SurfaceComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SurfaceComponent, "a2ui-v09-surface", never, { "surfaceId": { "alias": "surfaceId"; "required": true; "isSignal": true; }; "dataContextPath": { "alias": "dataContextPath"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
-}
-
 /**
  * Copyright 2026 Google LLC
  *
@@ -207,6 +157,65 @@ interface BoundProperty<T = any> {
     readonly onUpdate: (newValue: T) => void;
 }
 
+/**
+ * Dynamically renders an A2UI component as defined in the current surface model.
+ *
+ * This component acts as a bridge between the A2UI surface model and Angular components.
+ * It resolves the appropriate component from the catalog based on the component's type,
+ * and uses {@link ComponentBinder} to create reactive property bindings.
+ *
+ * Usually, you'll use the higher-level {@link SurfaceComponent} which automatically
+ * sets up a host for the 'root' component.
+ */
+declare class ComponentHostComponent implements OnInit {
+    /** The key of the component to render, either an ID string or an object with ID and basePath. Defaults to 'root'. */
+    componentKey: _angular_core.InputSignal<string | {
+        id: string;
+        basePath: string;
+    }>;
+    /** The unique identifier of the surface this component belongs to. */
+    surfaceId: _angular_core.InputSignal<string>;
+    private readonly rendererService;
+    private readonly binder;
+    private readonly destroyRef;
+    private readonly cdr;
+    protected componentType: Type<any> | null;
+    protected props: Record<string, BoundProperty>;
+    private context?;
+    protected weight: _angular_core.WritableSignal<string | number | null>;
+    get flexStyle(): string;
+    protected resolvedComponentId: string;
+    protected resolvedDataContextPath: string;
+    ngOnInit(): void;
+    private initializeComponent;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ComponentHostComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ComponentHostComponent, "a2ui-v09-component-host", never, { "componentKey": { "alias": "componentKey"; "required": false; "isSignal": true; }; "surfaceId": { "alias": "surfaceId"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * High-level component for rendering an entire A2UI surface.
+ *
+ * This component handles the boilerplate of setting up a {@link ComponentHostComponent}
+ * for the 'root' component of a surface. It is the recommended way to embed an
+ * A2UI surface in an Angular application.
+ */
+declare class SurfaceComponent {
+    /** The unique identifier of the surface to render. */
+    surfaceId: _angular_core.InputSignal<string>;
+    /**
+     * The path within the surface's data model that represents the current state.
+     * Defaults to the root ('/').
+     */
+    dataContextPath: _angular_core.InputSignal<string>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SurfaceComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SurfaceComponent, "a2ui-v09-surface", never, { "surfaceId": { "alias": "surfaceId"; "required": true; "isSignal": true; }; "dataContextPath": { "alias": "dataContextPath"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/** Represents a reference to a child component. */
+interface Child {
+    id: string;
+    basePath: string;
+}
 /**
  * Binds A2UI ComponentModel properties to reactive Angular Signals.
  *
@@ -259,6 +268,30 @@ declare function toAngularSignal<T>(preactSignal: Signal$1<T>, destroyRef: Destr
  */
 declare function getNormalizedPath(path: string, dataContextPath: string, index: number): string;
 
+interface MarkdownRendererOptions {
+    tagClassMap?: Record<string, string>;
+}
+declare abstract class MarkdownRenderer {
+    abstract render(markdown: string, options?: MarkdownRendererOptions): Promise<string>;
+}
+declare class DefaultMarkdownRenderer extends MarkdownRenderer {
+    private static warningLogged;
+    render(markdown: string, options?: MarkdownRendererOptions): Promise<string>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DefaultMarkdownRenderer, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<DefaultMarkdownRenderer>;
+}
+declare function provideMarkdownRenderer(renderFn?: (markdown: string, options?: MarkdownRendererOptions) => Promise<string>): {
+    provide: typeof MarkdownRenderer;
+    useValue: {
+        render: (markdown: string, options?: MarkdownRendererOptions) => Promise<string>;
+    };
+    useClass?: undefined;
+} | {
+    provide: typeof MarkdownRenderer;
+    useClass: typeof DefaultMarkdownRenderer;
+    useValue?: undefined;
+};
+
 /**
  * The set of default Angular implementations for each component in the basic catalog.
  */
@@ -675,6 +708,11 @@ declare class ListComponent extends BasicCatalogComponent {
     children: _angular_core.Signal<any[]>;
     listTag: _angular_core.Signal<"ol" | "ul" | "div">;
     styleType: _angular_core.Signal<"" | "none">;
+    /**
+     * Track-by function to ensure stable change detection for list items.
+     * Uses the full resolved path (`basePath/id`) to uniquely identify items.
+     */
+    readonly trackBy: (index: number, item: Child) => string;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ListComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ListComponent, "a2ui-v09-list", never, { "props": { "alias": "props"; "required": false; "isSignal": true; }; "surfaceId": { "alias": "surfaceId"; "required": true; "isSignal": true; }; "componentId": { "alias": "componentId"; "required": false; "isSignal": true; }; "dataContextPath": { "alias": "dataContextPath"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
@@ -960,5 +998,5 @@ declare class DateTimeInputComponent extends BasicCatalogComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DateTimeInputComponent, "a2ui-v09-date-time-input", never, { "props": { "alias": "props"; "required": false; "isSignal": true; }; "surfaceId": { "alias": "surfaceId"; "required": true; "isSignal": true; }; "componentId": { "alias": "componentId"; "required": false; "isSignal": true; }; "dataContextPath": { "alias": "dataContextPath"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-export { A2UI_RENDERER_CONFIG, A2uiRendererService, AngularCatalog, AudioPlayerComponent, BASIC_COMPONENTS, BasicCatalog, BasicCatalogBase, ButtonComponent, CardComponent, CheckBoxComponent, ChoicePickerComponent, ColumnComponent, ComponentBinder, ComponentHostComponent, DateTimeInputComponent, DividerComponent, IconComponent, ImageComponent, ListComponent, ModalComponent, RowComponent, SliderComponent, SurfaceComponent, TabsComponent, TextComponent, TextFieldComponent, VideoComponent, getNormalizedPath, toAngularSignal };
-export type { AngularComponentImplementation, BasicCatalogOptions, BoundProperty, RendererConfiguration };
+export { A2UI_RENDERER_CONFIG, A2uiRendererService, AngularCatalog, AudioPlayerComponent, BASIC_COMPONENTS, BasicCatalog, BasicCatalogBase, ButtonComponent, CardComponent, CheckBoxComponent, ChoicePickerComponent, ColumnComponent, ComponentBinder, ComponentHostComponent, DateTimeInputComponent, DefaultMarkdownRenderer, DividerComponent, IconComponent, ImageComponent, ListComponent, MarkdownRenderer, ModalComponent, RowComponent, SliderComponent, SurfaceComponent, TabsComponent, TextComponent, TextFieldComponent, VideoComponent, getNormalizedPath, provideMarkdownRenderer, toAngularSignal };
+export type { AngularComponentImplementation, BasicCatalogOptions, BoundProperty, Child, MarkdownRendererOptions, RendererConfiguration };