@a2ui/angular 0.9.1 → 0.10.0

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

@@ -1,9 +1,46 @@
 import * as _angular_core 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';
+import { Signal, Type, InjectionToken, OnDestroy, DestroyRef, NgZone } from '@angular/core';
+import * as _a2ui_web_core_v0_9 from '@a2ui/web_core/v0_9';
+import { ComponentApi, Catalog, A2uiClientAction, A2uiMessage, SurfaceGroupModel, ComponentContext, DataBindingSchema, FunctionCallSchema, Signal as Signal$1, FunctionImplementation } from '@a2ui/web_core/v0_9';
 export { signal as preactSignal } from '@a2ui/web_core/v0_9';
+import * as _a2ui_angular_v0_9 from '@a2ui/angular/v0_9';
+import * as zod from 'zod';
+import { z } from 'zod';
+import { TextApi, RowApi, ColumnApi, ButtonApi, TextFieldApi, ImageApi, IconApi, VideoApi, AudioPlayerApi, ListApi, CardApi, TabsApi, ModalApi, DividerApi, CheckBoxApi, ChoicePickerApi, SliderApi, DateTimeInputApi } from '@a2ui/web_core/v0_9/basic_catalog';
 export { BASIC_FUNCTIONS } from '@a2ui/web_core/v0_9/basic_catalog';
 
+/** Describes the properties that a Catalog component needs to implement. For ease of use, please extend CatalogComponent. */
+interface CatalogComponentInstance {
+    readonly props: Signal<Record<string, unknown>>;
+    readonly surfaceId: Signal<string>;
+    readonly componentId: Signal<string>;
+    readonly dataContextPath: Signal<string>;
+}
+/**
+ * Base class for A2UI catalog component in Angular.
+ *
+ * All Angular catalog components should extend this base class,
+ * which provides type safe access to props() and other common
+ * fields.
+ */
+declare abstract class CatalogComponent<Api extends ComponentApi> implements CatalogComponentInstance {
+    /**
+     * Reactive properties resolved from the A2UI ComponentModel.
+     */
+    readonly props: _angular_core.InputSignal<_a2ui_angular_v0_9.ExtendedProps<zod.TypeOf<Api["schema"]>> extends infer T ? { [K in keyof T]: K extends "children" ? _a2ui_angular_v0_9.BoundProperty<_a2ui_angular_v0_9.Child[]> : K extends "child" | "trigger" | "content" ? _a2ui_angular_v0_9.BoundProperty<_a2ui_angular_v0_9.Child> : _a2ui_angular_v0_9.BoundProperty<Exclude<T[K], {
+        path: string;
+    } | {
+        call: string;
+        args: Record<string, any>;
+        returnType: "string" | "number" | "boolean" | "object" | "array" | "void" | "any";
+    }>>; } : never>;
+    readonly surfaceId: _angular_core.InputSignal<string>;
+    readonly componentId: _angular_core.InputSignal<string>;
+    readonly dataContextPath: _angular_core.InputSignal<string>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CatalogComponent<any>, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<CatalogComponent<any>, never, never, { "props": { "alias": "props"; "required": false; "isSignal": true; }; "surfaceId": { "alias": "surfaceId"; "required": true; "isSignal": true; }; "componentId": { "alias": "componentId"; "required": true; "isSignal": true; }; "dataContextPath": { "alias": "dataContextPath"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
 /**
  * Copyright 2026 Google LLC
  *
@@ -20,6 +57,14 @@ export { BASIC_FUNCTIONS } from '@a2ui/web_core/v0_9/basic_catalog';
  * limitations under the License.
  */
 
+/**
+ * Temporary type used during basic catalog schema alignment to bypass strict type checking.
+ *
+ * To be removed once all properties implemented in Angular basic catalog components conform
+ * to the basic catalog schema.
+ * @see https://github.com/google/A2UI/issues/1303
+ */
+type AnyDuringSchemaAlignment = any;
 /**
  * Extends the generic {@link ComponentApi} to include Angular-specific component metadata.
  */
@@ -30,7 +75,7 @@ interface AngularComponentImplementation extends ComponentApi {
      * This class must be an Angular {@link Type} (e.g., a standalone component class)
      * that accepts `props`, `surfaceId`, and `dataContextPath` as inputs.
      */
-    readonly component: Type<any>;
+    readonly component: Type<CatalogComponentInstance>;
 }
 /**
  * A collection of Angular component and function implementations mapped to
@@ -108,6 +153,33 @@ declare class A2uiRendererService implements OnDestroy {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<A2uiRendererService>;
 }
 
+/** Represents a reference to a child component. */
+interface Child {
+    id: string;
+    basePath: string;
+}
+/**
+ * Binds A2UI ComponentModel properties to reactive Angular Signals.
+ *
+ * This service is used by {@link ComponentHostComponent} to resolve data bindings
+ * from the A2UI DataContext and expose them as Angular Signals. It ensures that
+ * property updates from the A2UI protocol are correctly reflected in Angular
+ * components and provides callbacks for updating the data model.
+ */
+declare class ComponentBinder {
+    private destroyRef;
+    private ngZone;
+    /**
+     * Binds all properties of a component to an object of Angular Signals.
+     *
+     * @param context The ComponentContext containing the model and data context.
+     * @returns An object where each key corresponds to a component prop and its value is an Angular Signal.
+     */
+    bind(context: ComponentContext): Record<string, BoundProperty>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ComponentBinder, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<ComponentBinder>;
+}
+
 /**
  * Copyright 2026 Google LLC
  *
@@ -124,6 +196,11 @@ declare class A2uiRendererService implements OnDestroy {
  * limitations under the License.
  */
 
+/** Data structure that represents a template used to render a collection of children. */
+interface ComponentTemplate {
+    id?: string;
+    path?: string;
+}
 /**
  * Represents a component property bound to an Angular Signal and update logic.
  *
@@ -133,7 +210,7 @@ declare class A2uiRendererService implements OnDestroy {
  *
  * @template T The type of the property value.
  */
-interface BoundProperty<T = any> {
+interface BoundProperty<T = unknown> {
     /**
      * The reactive Angular Signal containing the current resolved value.
      *
@@ -146,7 +223,9 @@ interface BoundProperty<T = any> {
      *
      * This may be a literal value or a data binding path object.
      */
-    readonly raw: any;
+    readonly raw: unknown;
+    /** This field is present for "children" props that define their children using a template. */
+    readonly template?: ComponentTemplate;
     /**
      * Callback to update the value in the A2UI DataContext.
      *
@@ -156,6 +235,36 @@ interface BoundProperty<T = any> {
      */
     readonly onUpdate: (newValue: T) => void;
 }
+type DataBindingType = z.infer<typeof DataBindingSchema>;
+type FunctionCallType = z.infer<typeof FunctionCallSchema>;
+type DynamicSchemaValueToRaw<Input> = Exclude<Input, DataBindingType | FunctionCallType>;
+type InferredInterfaceToProps<InferredSchema> = {
+    [K in keyof InferredSchema]: K extends 'children' ? BoundProperty<Child[]> : K extends 'child' | 'trigger' | 'content' ? BoundProperty<Child> : BoundProperty<DynamicSchemaValueToRaw<InferredSchema[K]>>;
+};
+interface CheckProps {
+    isValid: boolean;
+    validationErrors: string[];
+}
+/** The binder can add some properties to the Props object. This util adds them to the type. */
+type ExtendedProps<ComponentProps extends {
+    [key: string]: unknown;
+}> = 'checks' extends keyof ComponentProps ? Omit<ComponentProps, 'checks'> & CheckProps : ComponentProps;
+/**
+ * Utility to convert a component Api Type to the props Type, where the
+ * values are wrapped in BoundProperty. This is used to correctly type the props()
+ * in a UI component
+ *
+ * @example
+ * export const TextComponentApi = {
+ *   name: 'Text',
+ *   schema: z.object({
+ *     text: z.string(),
+ *   })
+ *   .strict(),
+ * } satisfies ComponentApi;
+ * export type TextComponentProps = ComponentApiToProps<typeof TextComponentApi>; // outputs { text: BoundProperty<string>; }
+ */
+type ComponentApiToProps<Api extends ComponentApi> = InferredInterfaceToProps<ExtendedProps<z.infer<Api['schema']>>>;
 
 /**
  * Dynamically renders an A2UI component as defined in the current surface model.
@@ -167,7 +276,7 @@ interface BoundProperty<T = any> {
  * Usually, you'll use the higher-level {@link SurfaceComponent} which automatically
  * sets up a host for the 'root' component.
  */
-declare class ComponentHostComponent implements OnInit {
+declare class ComponentHostComponent {
     /** 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;
@@ -179,13 +288,22 @@ declare class ComponentHostComponent implements OnInit {
     private readonly binder;
     private readonly destroyRef;
     private readonly cdr;
-    protected componentType: Type<any> | null;
+    protected componentType: Type<unknown> | null;
     protected props: Record<string, BoundProperty>;
     private context?;
     protected resolvedComponentId: string;
     protected resolvedDataContextPath: string;
-    ngOnInit(): void;
+    private propsSub?;
+    private createSub?;
+    constructor();
+    private setupComponent;
     private initializeComponent;
+    /**
+     * Resets the component host state, unsubscribing from active subscriptions
+     * and clearing component properties to avoid rendering stale data while
+     * a new component is being loaded.
+     */
+    private resetState;
     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>;
 }
@@ -209,33 +327,6 @@ declare class SurfaceComponent {
     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.
- *
- * This service is used by {@link ComponentHostComponent} to resolve data bindings
- * from the A2UI DataContext and expose them as Angular Signals. It ensures that
- * property updates from the A2UI protocol are correctly reflected in Angular
- * components and provides callbacks for updating the data model.
- */
-declare class ComponentBinder {
-    private destroyRef;
-    private ngZone;
-    /**
-     * Binds all properties of a component to an object of Angular Signals.
-     *
-     * @param context The ComponentContext containing the model and data context.
-     * @returns An object where each key corresponds to a component prop and its value is an Angular Signal.
-     */
-    bind(context: ComponentContext): Record<string, BoundProperty>;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ComponentBinder, never>;
-    static ɵprov: _angular_core.ɵɵInjectableDeclaration<ComponentBinder>;
-}
-
 /**
  * Copyright 2026 Google LLC
  *
@@ -264,7 +355,7 @@ declare function toAngularSignal<T>(preactSignal: Signal$1<T>, destroyRef: Destr
  * @param index The index of the child component.
  * @returns A fully normalized absolute path for the indexed child.
  */
-declare function getNormalizedPath(path: string, dataContextPath: string, index: number): string;
+declare function getNormalizedPath(path: string | undefined, dataContextPath: string, index: number): string;
 
 interface MarkdownRendererOptions {
     tagClassMap?: Record<string, string>;
@@ -292,6 +383,7 @@ declare function provideMarkdownRenderer(renderFn?: (markdown: string, options?:
 
 /**
  * The set of default Angular implementations for each component in the basic catalog.
+ * Using string literals as keys, to survive property renaming, as these names need to match the JSON payload.
  */
 declare const DEFAULT_COMPONENT_IMPLEMENTATIONS: Record<string, AngularComponentImplementation>;
 /**
@@ -346,26 +438,29 @@ declare class BasicCatalog extends BasicCatalogBase {
  * Base class for A2UI basic catalog components in Angular.
  *
  * Automatically injects the basic catalog styles when the component is instantiated.
- */
-declare abstract class BasicCatalogComponent {
-    /**
-     * Reactive properties resolved from the A2UI ComponentModel.
-     */
-    props: _angular_core.InputSignal<Record<string, BoundProperty<any>>>;
-    surfaceId: _angular_core.InputSignal<string>;
-    componentId: _angular_core.InputSignal<string>;
-    dataContextPath: _angular_core.InputSignal<string>;
+ * Also binds the primary brand color to the host element.
+ */
+declare abstract class BasicCatalogComponent<Api extends ComponentApi> extends CatalogComponent<Api> {
+    protected rendererService: A2uiRendererService;
+    readonly surface: _angular_core.Signal<_a2ui_web_core_v0_9.SurfaceModel<_a2ui_angular_v0_9.AngularComponentImplementation> | undefined>;
+    readonly theme: _angular_core.Signal<any>;
+    readonly primaryColor: _angular_core.Signal<any>;
+    /** Weight is applied as flex css property on the component host HTML element. */
+    protected readonly weight: _angular_core.Signal<NonNullable<Exclude<_a2ui_angular_v0_9.ExtendedProps<zod.TypeOf<Api["schema"]>>[string], {
+        path: string;
+    } | {
+        call: string;
+        args: Record<string, any>;
+        returnType: "string" | "number" | "boolean" | "object" | "array" | "void" | "any";
+    }>> | null>;
     constructor();
-    /**
-     * Computes the weight of the component from the properties.
-     */
-    protected readonly weight: _angular_core.Signal<any>;
     /**
      * Binds the flex style to the host element based on the weight.
      */
     get flexStyle(): string | null;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<BasicCatalogComponent, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<BasicCatalogComponent, never, never, { "props": { "alias": "props"; "required": false; "isSignal": true; }; "surfaceId": { "alias": "surfaceId"; "required": true; "isSignal": true; }; "componentId": { "alias": "componentId"; "required": true; "isSignal": true; }; "dataContextPath": { "alias": "dataContextPath"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    get primaryColorStyle(): string | null;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<BasicCatalogComponent<any>, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<BasicCatalogComponent<any>, never, never, {}, {}, never, never, true, never>;
 }
 
 /**
@@ -384,10 +479,10 @@ declare abstract class BasicCatalogComponent {
  * - `--a2ui-text-a-font-weight`: Controls the font weight for links.
  * - Font sizes: `--a2ui-font-size-2xl`, `--a2ui-font-size-xl`, `--a2ui-font-size-l`, `--a2ui-font-size-m`, `--a2ui-font-size-s`, `--a2ui-font-size-xs`.
  */
-declare class TextComponent extends BasicCatalogComponent {
+declare class TextComponent extends BasicCatalogComponent<typeof TextApi> {
     private markdownRenderer;
-    readonly variant: _angular_core.Signal<any>;
-    readonly text: _angular_core.Signal<any>;
+    readonly variant: _angular_core.Signal<"h1" | "h2" | "h3" | "h4" | "h5" | "caption" | "body">;
+    readonly text: _angular_core.Signal<string>;
     resolvedText: _angular_core.WritableSignal<string>;
     private renderRequestId;
     constructor();
@@ -404,12 +499,12 @@ declare class TextComponent extends BasicCatalogComponent {
  * Supported CSS variables:
  * - `--a2ui-row-gap`: Controls the gap between items in the row. Defaults to `--a2ui-spacing-m` (16px).
  */
-declare class RowComponent extends BasicCatalogComponent {
-    protected readonly justify: _angular_core.Signal<any>;
-    protected readonly align: _angular_core.Signal<any>;
-    protected readonly children: _angular_core.Signal<any[]>;
+declare class RowComponent extends BasicCatalogComponent<typeof RowApi> {
+    protected readonly justify: _angular_core.Signal<string | undefined>;
+    protected readonly align: _angular_core.Signal<string | undefined>;
+    protected readonly children: _angular_core.Signal<_a2ui_angular_v0_9.Child[]>;
     protected readonly isRepeating: _angular_core.Signal<boolean>;
-    protected readonly templateId: _angular_core.Signal<any>;
+    protected readonly templateId: _angular_core.Signal<string | undefined>;
     protected readonly normalizedChildren: _angular_core.Signal<{
         id: string;
         basePath: string;
@@ -428,12 +523,12 @@ declare class RowComponent extends BasicCatalogComponent {
  * Supported CSS variables:
  * - `--a2ui-column-gap`: Controls the gap between items in the column. Defaults to `--a2ui-spacing-m` (16px).
  */
-declare class ColumnComponent extends BasicCatalogComponent {
-    protected readonly justify: _angular_core.Signal<any>;
-    protected readonly align: _angular_core.Signal<any>;
-    protected readonly children: _angular_core.Signal<any[]>;
+declare class ColumnComponent extends BasicCatalogComponent<typeof ColumnApi> {
+    protected readonly justify: _angular_core.Signal<string | undefined>;
+    protected readonly align: _angular_core.Signal<string | undefined>;
+    protected readonly children: _angular_core.Signal<_a2ui_angular_v0_9.Child[]>;
     protected readonly isRepeating: _angular_core.Signal<boolean>;
-    protected readonly templateId: _angular_core.Signal<any>;
+    protected readonly templateId: _angular_core.Signal<string | undefined>;
     protected readonly normalizedChildren: _angular_core.Signal<{
         id: string;
         basePath: string;
@@ -458,11 +553,27 @@ declare class ColumnComponent extends BasicCatalogComponent {
  * - `--a2ui-button-box-shadow`: Controls the box shadow.
  * - `--a2ui-button-font-weight`: Controls the font weight.
  */
-declare class ButtonComponent extends BasicCatalogComponent {
-    private rendererService;
-    readonly variant: _angular_core.Signal<any>;
-    readonly child: _angular_core.Signal<any>;
-    readonly action: _angular_core.Signal<any>;
+declare class ButtonComponent extends BasicCatalogComponent<typeof ButtonApi> {
+    readonly variant: _angular_core.Signal<"default" | "primary" | "borderless">;
+    readonly child: _angular_core.Signal<_a2ui_angular_v0_9.Child>;
+    readonly action: _angular_core.Signal<{
+        event: {
+            name: string;
+            context?: Record<string, string | number | boolean | any[] | {
+                path: string;
+            } | {
+                call: string;
+                args: Record<string, any>;
+                returnType: "string" | "number" | "boolean" | "object" | "array" | "void" | "any";
+            }> | undefined;
+        };
+    } | {
+        functionCall: {
+            call: string;
+            args: Record<string, any>;
+            returnType: "string" | "number" | "boolean" | "object" | "array" | "void" | "any";
+        };
+    }>;
     handleClick(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ButtonComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ButtonComponent, "a2ui-v09-button", never, {}, {}, never, never, true, never>;
@@ -485,12 +596,12 @@ declare class ButtonComponent extends BasicCatalogComponent {
  * - `--a2ui-textfield-label-font-size`: Controls the font size of the label.
  * - `--a2ui-textfield-label-font-weight`: Controls the font weight of the label.
  */
-declare class TextFieldComponent extends BasicCatalogComponent {
-    readonly label: _angular_core.Signal<any>;
-    readonly value: _angular_core.Signal<any>;
+declare class TextFieldComponent extends BasicCatalogComponent<typeof TextFieldApi> {
+    readonly label: _angular_core.Signal<string>;
+    readonly value: _angular_core.Signal<string>;
     readonly placeholder: _angular_core.Signal<any>;
-    readonly variant: _angular_core.Signal<any>;
-    readonly inputType: _angular_core.Signal<"text" | "password" | "number">;
+    readonly variant: _angular_core.Signal<"number" | "shortText" | "longText" | "obscured" | undefined>;
+    readonly inputType: _angular_core.Signal<"text" | "number" | "password">;
     handleInput(event: Event): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TextFieldComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<TextFieldComponent, "a2ui-v09-text-field", never, {}, {}, never, never, true, never>;
@@ -509,11 +620,11 @@ declare class TextFieldComponent extends BasicCatalogComponent {
  * - `--a2ui-image-large-feature-size`: Max-height of largeFeature variant.
  * - `--a2ui-image-header-size`: Height of header variant.
  */
-declare class ImageComponent extends BasicCatalogComponent {
-    readonly url: _angular_core.Signal<any>;
-    readonly description: _angular_core.Signal<any>;
-    readonly fit: _angular_core.Signal<any>;
-    readonly variant: _angular_core.Signal<any>;
+declare class ImageComponent extends BasicCatalogComponent<typeof ImageApi> {
+    readonly url: _angular_core.Signal<string>;
+    readonly description: _angular_core.Signal<string>;
+    readonly fit: _angular_core.Signal<"fill" | "contain" | "cover" | "none" | "scaleDown">;
+    readonly variant: _angular_core.Signal<"default" | "icon" | "avatar" | "smallFeature" | "mediumFeature" | "largeFeature" | "header">;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ImageComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ImageComponent, "a2ui-v09-image", never, {}, {}, never, never, true, never>;
 }
@@ -529,11 +640,13 @@ declare class ImageComponent extends BasicCatalogComponent {
  * - `--a2ui-icon-color`: Controls the color of the icon.
  * - `--a2ui-icon-font-variation-settings`: Controls font variation settings (e.g. FILL).
  */
-declare class IconComponent extends BasicCatalogComponent {
+declare class IconComponent extends BasicCatalogComponent<typeof IconApi> {
     readonly color: _angular_core.Signal<any>;
-    readonly iconNameRaw: _angular_core.Signal<any>;
-    readonly isPath: _angular_core.Signal<boolean>;
-    readonly path: _angular_core.Signal<any>;
+    readonly iconNameRaw: _angular_core.Signal<"search" | "event" | "play" | "rewind" | "favoriteOff" | "starOff" | "accountCircle" | "add" | "arrowBack" | "arrowForward" | "attachFile" | "calendarToday" | "call" | "camera" | "check" | "close" | "delete" | "download" | "edit" | "error" | "fastForward" | "favorite" | "folder" | "help" | "home" | "info" | "locationOn" | "lock" | "lockOpen" | "mail" | "menu" | "moreVert" | "moreHoriz" | "notificationsOff" | "notifications" | "pause" | "payment" | "person" | "phone" | "photo" | "print" | "refresh" | "send" | "settings" | "share" | "shoppingCart" | "skipNext" | "skipPrevious" | "star" | "starHalf" | "stop" | "upload" | "visibility" | "visibilityOff" | "volumeDown" | "volumeMute" | "volumeOff" | "volumeUp" | "warning" | {
+        svgPath: string;
+    }>;
+    readonly isSvgPath: _angular_core.Signal<boolean>;
+    readonly svgPath: _angular_core.Signal<string>;
     readonly iconName: _angular_core.Signal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<IconComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<IconComponent, "a2ui-v09-icon", never, {}, {}, never, never, true, never>;
@@ -547,8 +660,8 @@ declare class IconComponent extends BasicCatalogComponent {
  * Supported CSS variables:
  * - `--a2ui-video-border-radius`: Controls the border radius of the video element.
  */
-declare class VideoComponent extends BasicCatalogComponent {
-    readonly url: _angular_core.Signal<any>;
+declare class VideoComponent extends BasicCatalogComponent<typeof VideoApi> {
+    readonly url: _angular_core.Signal<string>;
     readonly posterUrl: _angular_core.Signal<any>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<VideoComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<VideoComponent, "a2ui-v09-video", never, {}, {}, never, never, true, never>;
@@ -564,9 +677,9 @@ declare class VideoComponent extends BasicCatalogComponent {
  * - `--a2ui-audioplayer-border-radius`: Controls the border radius. Defaults to `0`.
  * - `--a2ui-audioplayer-padding`: Controls the padding. Defaults to `0`.
  */
-declare class AudioPlayerComponent extends BasicCatalogComponent {
-    readonly description: _angular_core.Signal<any>;
-    readonly url: _angular_core.Signal<any>;
+declare class AudioPlayerComponent extends BasicCatalogComponent<typeof AudioPlayerApi> {
+    readonly description: _angular_core.Signal<string | undefined>;
+    readonly url: _angular_core.Signal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AudioPlayerComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AudioPlayerComponent, "a2ui-v09-audio-player", never, {}, {}, never, never, true, never>;
 }
@@ -575,16 +688,16 @@ declare class AudioPlayerComponent extends BasicCatalogComponent {
  * Angular implementation of the A2UI List component (v0.9).
  *
  * Renders a list of child components with support for ordered, unordered,
- * and unstyled layouts in both vertical and horizontal orientations.
+ * and unstyled layouts in both vertical and horizontal directions.
  *
  * Supported CSS variables:
  * - `--a2ui-list-gap`: Controls the gap between items.
  * - `--a2ui-list-padding`: Controls the padding (applied to padding-inline-start).
  */
-declare class ListComponent extends BasicCatalogComponent {
-    readonly listStyle: _angular_core.Signal<any>;
-    readonly orientation: _angular_core.Signal<any>;
-    readonly children: _angular_core.Signal<any[]>;
+declare class ListComponent extends BasicCatalogComponent<typeof ListApi> {
+    readonly listStyle: _angular_core.Signal<"none" | "ordered" | "unordered" | undefined>;
+    readonly direction: _angular_core.Signal<"horizontal" | "vertical">;
+    readonly children: _angular_core.Signal<Child[]>;
     readonly listTag: _angular_core.Signal<"ol" | "ul" | "div">;
     readonly styleType: _angular_core.Signal<"" | "none">;
     /**
@@ -609,8 +722,8 @@ declare class ListComponent extends BasicCatalogComponent {
  * - `--a2ui-card-border`: Controls the border.
  * - `--a2ui-card-margin`: Controls the margin.
  */
-declare class CardComponent extends BasicCatalogComponent {
-    readonly child: _angular_core.Signal<any>;
+declare class CardComponent extends BasicCatalogComponent<typeof CardApi> {
+    readonly child: _angular_core.Signal<_a2ui_angular_v0_9.Child>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CardComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<CardComponent, "a2ui-v09-card", never, {}, {}, never, never, true, never>;
 }
@@ -629,11 +742,29 @@ declare class CardComponent extends BasicCatalogComponent {
  * - `--a2ui-tabs-header-color-active`: Controls the text color of the active tab button.
  * - `--a2ui-tabs-content-padding`: Controls the padding of the tab content.
  */
-declare class TabsComponent extends BasicCatalogComponent {
+declare class TabsComponent extends BasicCatalogComponent<typeof TabsApi> {
     activeTabIndex: _angular_core.WritableSignal<number>;
-    readonly tabs: _angular_core.Signal<any>;
-    readonly activeTab: _angular_core.Signal<any>;
-    protected readonly normalizedActiveTabContent: _angular_core.Signal<{
+    readonly tabs: _angular_core.Signal<{
+        title: string | {
+            path: string;
+        } | {
+            call: string;
+            args: Record<string, any>;
+            returnType: "string" | "number" | "boolean" | "object" | "array" | "void" | "any";
+        };
+        child: string;
+    }[]>;
+    readonly activeTab: _angular_core.Signal<{
+        title: string | {
+            path: string;
+        } | {
+            call: string;
+            args: Record<string, any>;
+            returnType: "string" | "number" | "boolean" | "object" | "array" | "void" | "any";
+        };
+        child: string;
+    }>;
+    protected readonly normalizedActiveTabChild: _angular_core.Signal<{
         id: string;
         basePath: string;
     } | null>;
@@ -654,10 +785,10 @@ declare class TabsComponent extends BasicCatalogComponent {
  * - `--a2ui-modal-box-shadow`: Controls the box shadow of the modal content.
  * - `--a2ui-modal-backdrop-bg`: Controls the background of the backdrop.
  */
-declare class ModalComponent extends BasicCatalogComponent {
+declare class ModalComponent extends BasicCatalogComponent<typeof ModalApi> {
     isOpen: _angular_core.WritableSignal<boolean>;
-    readonly trigger: _angular_core.Signal<any>;
-    readonly content: _angular_core.Signal<any>;
+    readonly trigger: _angular_core.Signal<_a2ui_angular_v0_9.Child>;
+    readonly content: _angular_core.Signal<_a2ui_angular_v0_9.Child>;
     openModal(): void;
     closeModal(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ModalComponent, never>;
@@ -673,8 +804,8 @@ declare class ModalComponent extends BasicCatalogComponent {
  * - `--a2ui-divider-border`: Controls the border of the divider (horizontal and vertical).
  * - `--a2ui-divider-spacing`: Controls the margin around the divider.
  */
-declare class DividerComponent extends BasicCatalogComponent {
-    readonly axis: _angular_core.Signal<any>;
+declare class DividerComponent extends BasicCatalogComponent<typeof DividerApi> {
+    readonly axis: _angular_core.Signal<"horizontal" | "vertical">;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DividerComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DividerComponent, "a2ui-v09-divider", never, {}, {}, never, never, true, never>;
 }
@@ -696,9 +827,9 @@ declare class DividerComponent extends BasicCatalogComponent {
  * - `--a2ui-checkbox-border-radius`: Controls the border radius of the checkbox.
  * - `--a2ui-checkbox-color-error`: Controls the color for error states.
  */
-declare class CheckBoxComponent extends BasicCatalogComponent {
+declare class CheckBoxComponent extends BasicCatalogComponent<typeof CheckBoxApi> {
     readonly value: _angular_core.Signal<boolean>;
-    readonly label: _angular_core.Signal<any>;
+    readonly label: _angular_core.Signal<string>;
     handleChange(event: Event): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CheckBoxComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<CheckBoxComponent, "a2ui-v09-check-box", never, {}, {}, never, never, true, never>;
@@ -720,11 +851,20 @@ declare class CheckBoxComponent extends BasicCatalogComponent {
  * - `--a2ui-choicepicker-chip-background`: Controls background of chips.
  * - `--a2ui-choicepicker-chip-background-selected`: Controls background of selected chips.
  */
-declare class ChoicePickerComponent extends BasicCatalogComponent {
-    readonly displayStyle: _angular_core.Signal<any>;
-    readonly choices: _angular_core.Signal<any>;
-    readonly variant: _angular_core.Signal<any>;
-    readonly selectedValue: _angular_core.Signal<any>;
+declare class ChoicePickerComponent extends BasicCatalogComponent<typeof ChoicePickerApi> {
+    readonly displayStyle: _angular_core.Signal<"checkbox" | "chips" | undefined>;
+    readonly options: _angular_core.Signal<{
+        value: string;
+        label: string | {
+            path: string;
+        } | {
+            call: string;
+            args: Record<string, any>;
+            returnType: "string" | "number" | "boolean" | "object" | "array" | "void" | "any";
+        };
+    }[]>;
+    readonly variant: _angular_core.Signal<"multipleSelection" | "mutuallyExclusive" | undefined>;
+    readonly selectedValue: _angular_core.Signal<string[]>;
     isMultiple(): boolean;
     isSelected(value: string): boolean;
     onCheckChange(value: string, event: Event): void;
@@ -746,12 +886,12 @@ declare class ChoicePickerComponent extends BasicCatalogComponent {
  * - `--a2ui-slider-thumb-color`: Controls the accent color of the thumb.
  * - `--a2ui-slider-track-color`: Controls the background of the track.
  */
-declare class SliderComponent extends BasicCatalogComponent {
-    readonly label: _angular_core.Signal<any>;
-    readonly value: _angular_core.Signal<any>;
-    readonly min: _angular_core.Signal<any>;
-    readonly max: _angular_core.Signal<any>;
-    readonly step: _angular_core.Signal<any>;
+declare class SliderComponent extends BasicCatalogComponent<typeof SliderApi> {
+    readonly label: _angular_core.Signal<string | undefined>;
+    readonly value: _angular_core.Signal<number>;
+    readonly min: _angular_core.Signal<number>;
+    readonly max: _angular_core.Signal<number>;
+    readonly step: _angular_core.Signal<number>;
     handleInput(event: Event): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SliderComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SliderComponent, "a2ui-v09-slider", never, {}, {}, never, never, true, never>;
@@ -772,18 +912,18 @@ declare class SliderComponent extends BasicCatalogComponent {
  * - `--a2ui-datetimeinput-label-font-size`: Controls the font size of the label.
  * - `--a2ui-datetimeinput-label-font-weight`: Controls the font weight of the label.
  */
-declare class DateTimeInputComponent extends BasicCatalogComponent {
-    readonly label: _angular_core.Signal<any>;
-    readonly enableDate: _angular_core.Signal<any>;
-    readonly enableTime: _angular_core.Signal<any>;
+declare class DateTimeInputComponent extends BasicCatalogComponent<typeof DateTimeInputApi> {
+    readonly label: _angular_core.Signal<string | undefined>;
+    readonly enableDate: _angular_core.Signal<boolean>;
+    readonly enableTime: _angular_core.Signal<boolean>;
     private readonly rawValue;
-    readonly dateValue: _angular_core.Signal<any>;
-    readonly timeValue: _angular_core.Signal<any>;
+    readonly dateValue: _angular_core.Signal<string>;
+    readonly timeValue: _angular_core.Signal<string>;
     handleDateChange(event: Event): void;
     handleTimeChange(event: Event): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DateTimeInputComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DateTimeInputComponent, "a2ui-v09-date-time-input", never, {}, {}, never, never, true, never>;
 }
 
-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 };
+export { A2UI_RENDERER_CONFIG, A2uiRendererService, AngularCatalog, AudioPlayerComponent, BASIC_COMPONENTS, BasicCatalog, BasicCatalogBase, ButtonComponent, CardComponent, CatalogComponent, 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, AnyDuringSchemaAlignment, BasicCatalogOptions, BoundProperty, CatalogComponentInstance, Child, ComponentApiToProps, ComponentTemplate, ExtendedProps, MarkdownRendererOptions, RendererConfiguration };