@a2ui/angular 0.8.2 → 0.9.0-alpha.0

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

@@ -0,0 +1,813 @@
+import * as _angular_core from '@angular/core';
+import { Type, InjectionToken, OnDestroy, OnInit, Signal, 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';
+
+/**
+ * Copyright 2026 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * Extends the generic {@link ComponentApi} to include Angular-specific component metadata.
+ */
+interface AngularComponentImplementation extends ComponentApi {
+    /**
+     * The Angular component class used to render this component.
+     *
+     * 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>;
+}
+/**
+ * A collection of Angular component and function implementations mapped to
+ * A2UI protocol types.
+ *
+ * Catalogs are used by the {@link MessageProcessor} to resolve component
+ * definitions and by {@link ComponentHostComponent} to instantiate the
+ * correct Angular components.
+ */
+declare class AngularCatalog extends Catalog<AngularComponentImplementation> {
+}
+
+/**
+ * Copyright 2026 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * Configuration for the A2UI renderer.
+ */
+interface RendererConfiguration {
+    /** The catalogs containing the available components and functions. */
+    catalogs: AngularCatalog[];
+    /**
+     * Optional handler for actions dispatched from any surface.
+     *
+     * This callback is invoked whenever a component in any surface triggers an action
+     * (e.g., clicking a button with an `onTap` property).
+     */
+    actionHandler?: (action: A2uiClientAction) => void;
+}
+/**
+ * Injection token for the A2UI renderer configuration.
+ */
+declare const A2UI_RENDERER_CONFIG: InjectionToken<RendererConfiguration>;
+/**
+ * Manages A2UI v0.9 rendering sessions by bridging the MessageProcessor to Angular.
+ *
+ * This service is the central entry point for the A2UI renderer. It maintains a
+ * {@link MessageProcessor} that turns A2UI protocol messages into a reactive
+ * {@link SurfaceGroupModel}.
+ */
+declare class A2uiRendererService implements OnDestroy {
+    private config;
+    private _messageProcessor;
+    private _catalogs;
+    constructor(config: RendererConfiguration);
+    /**
+     * Processes a list of A2UI messages and updates the internal surface models.
+     *
+     * This should be called whenever new messages arrive from an agent or orchestrator.
+     *
+     * @param messages The list of {@link A2uiMessage}s to process.
+     */
+    processMessages(messages: A2uiMessage[]): void;
+    /**
+     * The current surface group model containing all active surfaces.
+     *
+     * Surfaces can be retrieved from this group using their `surfaceId`.
+     */
+    get surfaceGroup(): SurfaceGroupModel<AngularComponentImplementation>;
+    ngOnDestroy(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<A2uiRendererService, never>;
+    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
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * Represents a component property bound to an Angular Signal and update logic.
+ *
+ * This interface is used by {@link ComponentBinder} to expose properties to
+ * Angular components. It contains the current value as a Signal, the raw
+ * property definition, and an update function.
+ *
+ * @template T The type of the property value.
+ */
+interface BoundProperty<T = any> {
+    /**
+     * The reactive Angular Signal containing the current resolved value.
+     *
+     * This signal automatically updates whenever the underlying A2UI data
+     * model changes.
+     */
+    readonly value: Signal<T>;
+    /**
+     * The raw value from the A2UI ComponentModel.
+     *
+     * This may be a literal value or a data binding path object.
+     */
+    readonly raw: any;
+    /**
+     * Callback to update the value in the A2UI DataContext.
+     *
+     * If the property is bound to a path in the data model, calling this
+     * will update that path. If the property is a literal value, this
+     * is typically a no-op.
+     */
+    readonly onUpdate: (newValue: T) => void;
+}
+
+/**
+ * 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
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+declare function toAngularSignal<T>(preactSignal: Signal$1<T>, destroyRef: DestroyRef, ngZone?: NgZone): Signal<T>;
+/**
+ * Normalizes a data model path by combining a relative path with a base context.
+ *
+ * This is used to create unique absolute paths for components within a repeating
+ * collection or nested structure.
+ *
+ * @param path The relative or absolute path from the component properties.
+ * @param dataContextPath The current base data context path.
+ * @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;
+
+/**
+ * The set of default Angular implementations for each component in the basic catalog.
+ */
+declare const DEFAULT_COMPONENT_IMPLEMENTATIONS: Record<string, AngularComponentImplementation>;
+/**
+ * Interface for specifying overrides and configuration for the basic catalog.
+ */
+interface BasicCatalogOptions {
+    /**
+     * An optional override for the catalog's unique identifier.
+     */
+    id?: string;
+    /**
+     * Optional overrides for individual components in the catalog.
+     */
+    components?: Partial<{
+        [K in keyof typeof DEFAULT_COMPONENT_IMPLEMENTATIONS]: AngularComponentImplementation;
+    }>;
+    /**
+     * Optional additional components to include in the catalog beyond
+     * the standard basic catalog components.
+     */
+    extraComponents?: AngularComponentImplementation[];
+    /**
+     * An optional set of function implementations to use instead of the defaults.
+     */
+    functions?: FunctionImplementation[];
+}
+/**
+ * The set of Angular UI components provided by the basic catalog.
+ */
+declare const BASIC_COMPONENTS: AngularComponentImplementation[];
+
+/**
+ * A base class for basic catalogs, providing extensibility for non-DI use cases.
+ */
+declare class BasicCatalogBase extends AngularCatalog {
+    constructor(options?: BasicCatalogOptions);
+}
+/**
+ * A basic catalog of components and functions for v0.9 verification.
+ *
+ * This catalog includes a wide range of UI components (Text, Button, Row, etc.)
+ * and utility functions (capitalize, formatString) defined in the A2UI v0.9
+ * basic catalog specification.
+ */
+declare class BasicCatalog extends BasicCatalogBase {
+    constructor();
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<BasicCatalog, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<BasicCatalog>;
+}
+
+/**
+ * Angular implementation of the A2UI Text component (v0.9).
+ *
+ * Renders text with support for simple Markdown.
+ */
+declare class TextComponent {
+    /**
+     * Reactive properties resolved from the A2UI {@link ComponentModel}.
+     *
+     * Expected properties:
+     * - `text`: The string content to display.
+     * - `variant`: A hint for the base text style ('h1', 'h2', 'h3', 'h4', 'h5', 'caption', 'body').
+     */
+    props: _angular_core.InputSignal<Record<string, BoundProperty<any>>>;
+    surfaceId: _angular_core.InputSignal<string>;
+    componentId: _angular_core.InputSignal<string | undefined>;
+    dataContextPath: _angular_core.InputSignal<string>;
+    private markdownRenderer;
+    variant: _angular_core.Signal<any>;
+    text: _angular_core.Signal<any>;
+    resolvedText: _angular_core.WritableSignal<string>;
+    private renderRequestId;
+    constructor();
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TextComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TextComponent, "a2ui-v09-text", 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>;
+}
+
+/**
+ * Angular implementation of the A2UI Row component (v0.9).
+ *
+ * Arranges child components in a horizontal flex layout. Supports both static
+ * lists of children and repeating templates bound to a data collection.
+ */
+declare class RowComponent {
+    /**
+     * Reactive properties resolved from the A2UI {@link ComponentModel}.
+     *
+     * Expected properties:
+     * - `children`: A list of component IDs OR a repeating collection definition.
+     * - `justify`: Flexbox justify-content value (e.g., 'flex-start', 'center').
+     * - `align`: Flexbox align-items value (e.g., 'flex-start', 'center').
+     */
+    props: _angular_core.InputSignal<Record<string, BoundProperty<any>>>;
+    surfaceId: _angular_core.InputSignal<string>;
+    componentId: _angular_core.InputSignal<string | undefined>;
+    dataContextPath: _angular_core.InputSignal<string>;
+    protected justify: _angular_core.Signal<any>;
+    protected align: _angular_core.Signal<any>;
+    protected children: _angular_core.Signal<any[]>;
+    protected isRepeating: _angular_core.Signal<boolean>;
+    protected templateId: _angular_core.Signal<any>;
+    protected normalizedChildren: _angular_core.Signal<{
+        id: string;
+        basePath: string;
+    }[]>;
+    protected getNormalizedPath(index: number): string;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<RowComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<RowComponent, "a2ui-v09-row", 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>;
+}
+
+/**
+ * Angular implementation of the A2UI Column component (v0.9).
+ *
+ * Arranges child components in a vertical flex layout. Supports both static
+ * lists of children and repeating templates bound to a data collection.
+ */
+declare class ColumnComponent {
+    /**
+     * Reactive properties resolved from the A2UI {@link ComponentModel}.
+     *
+     * Expected properties:
+     * - `children`: A list of component IDs OR a repeating collection definition.
+     * - `justify`: Flexbox justify-content value (e.g., 'flex-start', 'center').
+     * - `align`: Flexbox align-items value (e.g., 'flex-start', 'center').
+     */
+    props: _angular_core.InputSignal<Record<string, BoundProperty<any>>>;
+    surfaceId: _angular_core.InputSignal<string>;
+    componentId: _angular_core.InputSignal<string | undefined>;
+    dataContextPath: _angular_core.InputSignal<string>;
+    protected justify: _angular_core.Signal<any>;
+    protected align: _angular_core.Signal<any>;
+    protected children: _angular_core.Signal<any[]>;
+    protected isRepeating: _angular_core.Signal<boolean>;
+    protected templateId: _angular_core.Signal<any>;
+    protected normalizedChildren: _angular_core.Signal<{
+        id: string;
+        basePath: string;
+    }[]>;
+    protected getNormalizedPath(index: number): string;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ColumnComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ColumnComponent, "a2ui-v09-column", 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>;
+}
+
+/**
+ * Angular implementation of the A2UI Button component (v0.9).
+ *
+ * Renders a clickable button with a single child component (usually Text).
+ * Dispatches an action when clicked if an `action` property is provided.
+ */
+declare class ButtonComponent {
+    /**
+     * Reactive properties resolved from the A2UI {@link ComponentModel}.
+     *
+     * Expected properties:
+     * - `child`: The ID of the component to render inside the button.
+     * - `variant`: Button style variant ('default', 'primary', 'borderless').
+     * - `action`: The A2UI action to dispatch on click.
+     * - `checks`: Optional validation rules.
+     */
+    props: _angular_core.InputSignal<Record<string, BoundProperty<any>>>;
+    surfaceId: _angular_core.InputSignal<string>;
+    componentId: _angular_core.InputSignal<string>;
+    dataContextPath: _angular_core.InputSignal<string>;
+    private rendererService;
+    variant: _angular_core.Signal<any>;
+    child: _angular_core.Signal<any>;
+    action: _angular_core.Signal<any>;
+    handleClick(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ButtonComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ButtonComponent, "a2ui-v09-button", 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>;
+}
+
+/**
+ * Angular implementation of the A2UI TextField component (v0.9).
+ *
+ * Renders a text input field with an optional label and placeholder.
+ * Updates the bound data model property on every input change.
+ */
+declare class TextFieldComponent {
+    /**
+     * Reactive properties resolved from the A2UI {@link ComponentModel}.
+     *
+     * Expected properties:
+     * - `value`: The current string value of the input.
+     * - `label`: Optional label text to display above the input.
+     * - `placeholder`: Hint text shown when the input is empty.
+     * - `variant`: Input type variant ('default', 'obscured' (password), 'number').
+     * - `checks`: Optional validation rules.
+     */
+    props: _angular_core.InputSignal<Record<string, BoundProperty<any>>>;
+    surfaceId: _angular_core.InputSignal<string>;
+    componentId: _angular_core.InputSignal<string | undefined>;
+    dataContextPath: _angular_core.InputSignal<string>;
+    label: _angular_core.Signal<any>;
+    value: _angular_core.Signal<any>;
+    placeholder: _angular_core.Signal<any>;
+    variant: _angular_core.Signal<any>;
+    inputType: _angular_core.Signal<"text" | "password" | "number">;
+    handleInput(event: Event): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TextFieldComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TextFieldComponent, "a2ui-v09-text-field", 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>;
+}
+
+/**
+ * Angular implementation of the A2UI Image component (v0.9).
+ *
+ * Renders an image with configurable fit and shape variants.
+ */
+declare class ImageComponent {
+    /**
+     * Reactive properties resolved from the A2UI {@link ComponentModel}.
+     *
+     * Expected properties:
+     * - `url`: The absolute URL of the image.
+     * - `description`: Accessibility text for the image.
+     * - `fit`: Object-fit mode ('cover', 'contain', 'fill', 'none', 'scale-down').
+     * - `variant`: Style variant ('default', 'circle', 'rounded', 'icon', 'avatar', 'smallFeature', 'mediumFeature', 'largeFeature', 'header').
+     */
+    props: _angular_core.InputSignal<Record<string, BoundProperty<any>>>;
+    surfaceId: _angular_core.InputSignal<string>;
+    componentId: _angular_core.InputSignal<string | undefined>;
+    dataContextPath: _angular_core.InputSignal<string>;
+    url: _angular_core.Signal<any>;
+    description: _angular_core.Signal<any>;
+    fit: _angular_core.Signal<any>;
+    variant: _angular_core.Signal<any>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ImageComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ImageComponent, "a2ui-v09-image", 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>;
+}
+
+/**
+ * Angular implementation of the A2UI Icon component (v0.9).
+ *
+ * Supports both Material Icons (by name) and custom SVG icons (by path).
+ */
+declare class IconComponent {
+    /**
+     * Reactive properties resolved from the A2UI {@link ComponentModel}.
+     *
+     * Expected properties:
+     * - `name`: The name of the icon (e.g., 'home', 'settings') OR an object
+     *           with a `path` property for SVG icons.
+     * - `color`: The CSS color to apply to the icon.
+     */
+    props: _angular_core.InputSignal<Record<string, BoundProperty<any>>>;
+    surfaceId: _angular_core.InputSignal<string>;
+    componentId: _angular_core.InputSignal<string | undefined>;
+    dataContextPath: _angular_core.InputSignal<string>;
+    color: _angular_core.Signal<any>;
+    iconNameRaw: _angular_core.Signal<any>;
+    isPath: _angular_core.Signal<boolean>;
+    path: _angular_core.Signal<any>;
+    iconName: _angular_core.Signal<string>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<IconComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<IconComponent, "a2ui-v09-icon", 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>;
+}
+
+/**
+ * Angular implementation of the A2UI Video component (v0.9).
+ *
+ * Renders a video player with standard controls and an optional poster image.
+ */
+declare class VideoComponent {
+    /**
+     * Reactive properties resolved from the A2UI {@link ComponentModel}.
+     *
+     * Expected properties:
+     * - `url`: The absolute URL of the video file.
+     * - `posterUrl`: The URL of an image to show before the video starts.
+     */
+    props: _angular_core.InputSignal<Record<string, BoundProperty<any>>>;
+    surfaceId: _angular_core.InputSignal<string>;
+    componentId: _angular_core.InputSignal<string | undefined>;
+    dataContextPath: _angular_core.InputSignal<string>;
+    url: _angular_core.Signal<any>;
+    posterUrl: _angular_core.Signal<any>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<VideoComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<VideoComponent, "a2ui-v09-video", 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>;
+}
+
+/**
+ * Angular implementation of the A2UI AudioPlayer component (v0.9).
+ *
+ * Renders an audio player with standard controls and an optional description.
+ */
+declare class AudioPlayerComponent {
+    /**
+     * Reactive properties resolved from the A2UI {@link ComponentModel}.
+     *
+     * Expected properties:
+     * - `url`: The absolute URL of the audio file.
+     * - `description`: Optional text to display above the player.
+     */
+    props: _angular_core.InputSignal<Record<string, BoundProperty<any>>>;
+    surfaceId: _angular_core.InputSignal<string | undefined>;
+    componentId: _angular_core.InputSignal<string | undefined>;
+    dataContextPath: _angular_core.InputSignal<string | undefined>;
+    description: _angular_core.Signal<any>;
+    url: _angular_core.Signal<any>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AudioPlayerComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AudioPlayerComponent, "a2ui-v09-audio-player", never, { "props": { "alias": "props"; "required": false; "isSignal": true; }; "surfaceId": { "alias": "surfaceId"; "required": false; "isSignal": true; }; "componentId": { "alias": "componentId"; "required": false; "isSignal": true; }; "dataContextPath": { "alias": "dataContextPath"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * 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.
+ */
+declare class ListComponent {
+    /**
+     * Reactive properties resolved from the A2UI {@link ComponentModel}.
+     *
+     * Expected properties:
+     * - `children`: A list of component IDs to render as list items.
+     * - `listStyle`: The type of list ('ordered', 'unordered', 'none').
+     * - `orientation`: The layout direction ('vertical', 'horizontal').
+     */
+    props: _angular_core.InputSignal<Record<string, BoundProperty<any>>>;
+    surfaceId: _angular_core.InputSignal<string>;
+    componentId: _angular_core.InputSignal<string | undefined>;
+    dataContextPath: _angular_core.InputSignal<string>;
+    listStyle: _angular_core.Signal<any>;
+    orientation: _angular_core.Signal<any>;
+    children: _angular_core.Signal<any[]>;
+    listTag: _angular_core.Signal<"ol" | "ul" | "div">;
+    styleType: _angular_core.Signal<"" | "none">;
+    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>;
+}
+
+/**
+ * Angular implementation of the A2UI Card component (v0.9).
+ *
+ * Renders a container with a shadow and rounded corners for grouping related content.
+ */
+declare class CardComponent {
+    /**
+     * Reactive properties resolved from the A2UI {@link ComponentModel}.
+     *
+     * Expected properties:
+     * - `child`: The component ID to render inside the card.
+     */
+    props: _angular_core.InputSignal<Record<string, BoundProperty<any>>>;
+    surfaceId: _angular_core.InputSignal<string>;
+    componentId: _angular_core.InputSignal<string | undefined>;
+    dataContextPath: _angular_core.InputSignal<string>;
+    child: _angular_core.Signal<any>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CardComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CardComponent, "a2ui-v09-card", 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>;
+}
+
+/**
+ * Angular implementation of the A2UI Tabs component (v0.9).
+ *
+ * Renders a set of tabs where each tab has a label and associated content.
+ * Manages the active tab state internally.
+ */
+declare class TabsComponent {
+    /**
+     * Reactive properties resolved from the A2UI {@link ComponentModel}.
+     *
+     * Expected properties:
+     * - `tabs`: A list of tab objects, each containing a `label` and `content` ID.
+     */
+    props: _angular_core.InputSignal<Record<string, BoundProperty<any>>>;
+    surfaceId: _angular_core.InputSignal<string>;
+    componentId: _angular_core.InputSignal<string | undefined>;
+    dataContextPath: _angular_core.InputSignal<string>;
+    activeTabIndex: _angular_core.WritableSignal<number>;
+    tabs: _angular_core.Signal<any>;
+    activeTab: _angular_core.Signal<any>;
+    protected normalizedActiveTabContent: _angular_core.Signal<{
+        id: string;
+        basePath: string;
+    } | null>;
+    setActiveTab(index: number): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TabsComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TabsComponent, "a2ui-v09-tabs", 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>;
+}
+
+/**
+ * Angular implementation of the A2UI Modal component (v0.9).
+ *
+ * Renders a trigger component that opening an overlay containing a content component.
+ */
+declare class ModalComponent {
+    /**
+     * Reactive properties resolved from the A2UI {@link ComponentModel}.
+     *
+     * Expected properties:
+     * - `trigger`: The ID of the component that opens the modal.
+     * - `content`: The ID of the component to display inside the modal.
+     */
+    props: _angular_core.InputSignal<Record<string, BoundProperty<any>>>;
+    surfaceId: _angular_core.InputSignal<string>;
+    componentId: _angular_core.InputSignal<string | undefined>;
+    dataContextPath: _angular_core.InputSignal<string>;
+    isOpen: _angular_core.WritableSignal<boolean>;
+    trigger: _angular_core.Signal<any>;
+    content: _angular_core.Signal<any>;
+    openModal(): void;
+    closeModal(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ModalComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ModalComponent, "a2ui-v09-modal", 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>;
+}
+
+/**
+ * Angular implementation of the A2UI Divider component (v0.9).
+ *
+ * Renders a horizontal or vertical line to separate content.
+ */
+declare class DividerComponent {
+    /**
+     * Reactive properties resolved from the A2UI {@link ComponentModel}.
+     *
+     * Expected properties:
+     * - `axis`: The orientation of the divider ('horizontal' (default) or 'vertical').
+     */
+    props: _angular_core.InputSignal<Record<string, BoundProperty<any>>>;
+    surfaceId: _angular_core.InputSignal<string>;
+    componentId: _angular_core.InputSignal<string | undefined>;
+    dataContextPath: _angular_core.InputSignal<string>;
+    axis: _angular_core.Signal<any>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<DividerComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DividerComponent, "a2ui-v09-divider", 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>;
+}
+
+/**
+ * Angular implementation of the A2UI CheckBox component (v0.9).
+ *
+ * Renders a checkbox with a label. Updates the bound data model property
+ * when the checked state changes.
+ */
+declare class CheckBoxComponent {
+    /**
+     * Reactive properties resolved from the A2UI {@link ComponentModel}.
+     *
+     * Expected properties:
+     * - `label`: The text to display next to the checkbox.
+     * - `value`: Boolean indicating whether the checkbox is checked.
+     */
+    props: _angular_core.InputSignal<Record<string, BoundProperty<any>>>;
+    surfaceId: _angular_core.InputSignal<string>;
+    componentId: _angular_core.InputSignal<string | undefined>;
+    dataContextPath: _angular_core.InputSignal<string>;
+    value: _angular_core.Signal<boolean>;
+    label: _angular_core.Signal<any>;
+    handleChange(event: Event): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<CheckBoxComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CheckBoxComponent, "a2ui-v09-check-box", 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>;
+}
+
+/**
+ * Angular implementation of the A2UI ChoicePicker component (v0.9).
+ *
+ * Renders a set of options as either radio buttons/checkboxes or chips.
+ * Supports both single and multiple selection.
+ */
+declare class ChoicePickerComponent {
+    /**
+     * Reactive properties resolved from the A2UI {@link ComponentModel}.
+     *
+     * Expected properties:
+     * - `value`: The currently selected value(s).
+     * - `choices` or `options`: List of choice objects (label and value).
+     * - `displayStyle`: How to render the choices ('default' or 'chips').
+     * - `variant`: Selection mode ('singleSelection' or 'multipleSelection').
+     */
+    props: _angular_core.InputSignal<Record<string, BoundProperty<any>>>;
+    surfaceId: _angular_core.InputSignal<string>;
+    componentId: _angular_core.InputSignal<string | undefined>;
+    dataContextPath: _angular_core.InputSignal<string>;
+    displayStyle: _angular_core.Signal<any>;
+    choices: _angular_core.Signal<any>;
+    variant: _angular_core.Signal<any>;
+    selectedValue: _angular_core.Signal<any>;
+    isMultiple(): boolean;
+    isSelected(value: string): boolean;
+    onCheckChange(value: string, event: Event): void;
+    toggleActive(value: string): void;
+    private updateValue;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChoicePickerComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChoicePickerComponent, "a2ui-v09-choice-picker", 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>;
+}
+
+/**
+ * Angular implementation of the A2UI Slider component (v0.9).
+ *
+ * Renders a range input slider with a label and its current value.
+ */
+declare class SliderComponent {
+    /**
+     * Reactive properties resolved from the A2UI {@link ComponentModel}.
+     *
+     * Expected properties:
+     * - `value`: The current numeric value.
+     * - `label`: Label text to display.
+     * - `min`: Minimum value (default: 0).
+     * - `max`: Maximum value (default: 100).
+     * - `step`: Increment step (default: 1).
+     */
+    props: _angular_core.InputSignal<Record<string, BoundProperty<any>>>;
+    surfaceId: _angular_core.InputSignal<string>;
+    componentId: _angular_core.InputSignal<string | undefined>;
+    dataContextPath: _angular_core.InputSignal<string>;
+    label: _angular_core.Signal<any>;
+    value: _angular_core.Signal<any>;
+    min: _angular_core.Signal<any>;
+    max: _angular_core.Signal<any>;
+    step: _angular_core.Signal<any>;
+    handleInput(event: Event): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<SliderComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SliderComponent, "a2ui-v09-slider", 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>;
+}
+
+/**
+ * Angular implementation of the A2UI DateTimeInput component (v0.9).
+ *
+ * Renders date and/or time input fields. Combines them into an ISO string
+ * for the bound data model property.
+ */
+declare class DateTimeInputComponent {
+    /**
+     * Reactive properties resolved from the A2UI {@link ComponentModel}.
+     *
+     * Expected properties:
+     * - `value`: The current ISO date/time string.
+     * - `label`: Optional label text.
+     * - `enableDate`: Whether to show the date picker (default: true).
+     * - `enableTime`: Whether to show the time picker (default: false).
+     */
+    props: _angular_core.InputSignal<Record<string, BoundProperty<any>>>;
+    surfaceId: _angular_core.InputSignal<string>;
+    componentId: _angular_core.InputSignal<string | undefined>;
+    dataContextPath: _angular_core.InputSignal<string>;
+    label: _angular_core.Signal<any>;
+    enableDate: _angular_core.Signal<any>;
+    enableTime: _angular_core.Signal<any>;
+    private rawValue;
+    dateValue: _angular_core.Signal<any>;
+    timeValue: _angular_core.Signal<any>;
+    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, { "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 };