@a2ui-sdk/types 0.1.1 → 0.2.0

package/dist/0.8/index.d.ts

@@ -150,167 +150,4 @@ export interface A2UIMessage {
     dataModelUpdate?: DataModelUpdatePayload;
     deleteSurface?: DeleteSurfacePayload;
 }
-/**
- * Base props shared by all A2UI components.
- */
-export interface BaseComponentProps {
-    surfaceId: string;
-    componentId: string;
-    weight?: number;
-}
-/**
- * Text component properties.
- */
-export interface TextComponentProps extends BaseComponentProps {
-    text?: ValueSource;
-    usageHint?: 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'caption' | 'body';
-}
-/**
- * Image component properties.
- */
-export interface ImageComponentProps extends BaseComponentProps {
-    url?: ValueSource;
-    fit?: 'contain' | 'cover' | 'fill' | 'none' | 'scale-down';
-    usageHint?: 'icon' | 'avatar' | 'smallFeature' | 'mediumFeature' | 'largeFeature' | 'header';
-}
-/**
- * Icon component properties.
- */
-export interface IconComponentProps extends BaseComponentProps {
-    name?: ValueSource;
-}
-/**
- * Video component properties.
- */
-export interface VideoComponentProps extends BaseComponentProps {
-    url?: ValueSource;
-}
-/**
- * AudioPlayer component properties.
- */
-export interface AudioPlayerComponentProps extends BaseComponentProps {
-    url?: ValueSource;
-    description?: ValueSource;
-}
-/**
- * Divider component properties.
- */
-export interface DividerComponentProps extends BaseComponentProps {
-    axis?: 'horizontal' | 'vertical';
-}
-/**
- * Distribution values for flex layouts.
- */
-export type Distribution = 'start' | 'center' | 'end' | 'spaceBetween' | 'spaceAround' | 'spaceEvenly';
-/**
- * Alignment values for flex layouts.
- */
-export type Alignment = 'start' | 'center' | 'end' | 'stretch';
-/**
- * Row component properties.
- */
-export interface RowComponentProps extends BaseComponentProps {
-    children?: ChildrenDefinition;
-    distribution?: Distribution;
-    alignment?: Alignment;
-}
-/**
- * Column component properties.
- */
-export interface ColumnComponentProps extends BaseComponentProps {
-    children?: ChildrenDefinition;
-    distribution?: Distribution;
-    alignment?: Alignment;
-}
-/**
- * List component properties.
- */
-export interface ListComponentProps extends BaseComponentProps {
-    children?: ChildrenDefinition;
-    direction?: 'vertical' | 'horizontal';
-    alignment?: Alignment;
-}
-/**
- * Card component properties.
- */
-export interface CardComponentProps extends BaseComponentProps {
-    child?: string;
-}
-/**
- * Tab item definition.
- */
-export interface TabItem {
-    title?: ValueSource;
-    child: string;
-}
-/**
- * Tabs component properties.
- */
-export interface TabsComponentProps extends BaseComponentProps {
-    tabItems?: TabItem[];
-}
-/**
- * Modal component properties.
- */
-export interface ModalComponentProps extends BaseComponentProps {
-    entryPointChild?: string;
-    contentChild?: string;
-}
-/**
- * Button component properties.
- */
-export interface ButtonComponentProps extends BaseComponentProps {
-    child?: string;
-    primary?: boolean;
-    action?: Action;
-}
-/**
- * CheckBox component properties.
- */
-export interface CheckBoxComponentProps extends BaseComponentProps {
-    label?: ValueSource;
-    value?: ValueSource;
-}
-/**
- * TextField component properties.
- */
-export interface TextFieldComponentProps extends BaseComponentProps {
-    label?: ValueSource;
-    text?: ValueSource;
-    textFieldType?: 'date' | 'longText' | 'number' | 'shortText' | 'obscured';
-    validationRegexp?: string;
-}
-/**
- * DateTimeInput component properties.
- */
-export interface DateTimeInputComponentProps extends BaseComponentProps {
-    label?: ValueSource;
-    value?: ValueSource;
-    enableDate?: boolean;
-    enableTime?: boolean;
-}
-/**
- * MultipleChoice option definition.
- */
-export interface MultipleChoiceOption {
-    label?: ValueSource;
-    value: string;
-}
-/**
- * MultipleChoice component properties.
- */
-export interface MultipleChoiceComponentProps extends BaseComponentProps {
-    label?: ValueSource;
-    selections?: ValueSource;
-    options?: MultipleChoiceOption[];
-    maxAllowedSelections?: number;
-}
-/**
- * Slider component properties.
- */
-export interface SliderComponentProps extends BaseComponentProps {
-    label?: ValueSource;
-    value?: ValueSource;
-    minValue?: number;
-    maxValue?: number;
-}
+export * as StandardCatalog from './standard-catalog.js';

package/dist/0.8/index.js

@@ -4,4 +4,4 @@
  * Core type definitions for the A2UI SDK.
  * Based on the A2UI specification documents.
  */
-export {};
+export * as StandardCatalog from './standard-catalog.js';

package/dist/0.8/standard-catalog.d.ts

@@ -0,0 +1,157 @@
+import type { Action, ChildrenDefinition, ValueSource } from './index.js';
+/**
+ * Text component properties.
+ */
+export interface TextComponentProps {
+    text?: ValueSource;
+    usageHint?: 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'caption' | 'body';
+}
+/**
+ * Image component properties.
+ */
+export interface ImageComponentProps {
+    url?: ValueSource;
+    fit?: 'contain' | 'cover' | 'fill' | 'none' | 'scale-down';
+    usageHint?: 'icon' | 'avatar' | 'smallFeature' | 'mediumFeature' | 'largeFeature' | 'header';
+}
+/**
+ * Icon component properties.
+ */
+export interface IconComponentProps {
+    name?: ValueSource;
+}
+/**
+ * Video component properties.
+ */
+export interface VideoComponentProps {
+    url?: ValueSource;
+}
+/**
+ * AudioPlayer component properties.
+ */
+export interface AudioPlayerComponentProps {
+    url?: ValueSource;
+    description?: ValueSource;
+}
+/**
+ * Divider component properties.
+ */
+export interface DividerComponentProps {
+    axis?: 'horizontal' | 'vertical';
+}
+/**
+ * Distribution values for flex layouts.
+ */
+export type Distribution = 'start' | 'center' | 'end' | 'spaceBetween' | 'spaceAround' | 'spaceEvenly';
+/**
+ * Alignment values for flex layouts.
+ */
+export type Alignment = 'start' | 'center' | 'end' | 'stretch';
+/**
+ * Row component properties.
+ */
+export interface RowComponentProps {
+    children?: ChildrenDefinition;
+    distribution?: Distribution;
+    alignment?: Alignment;
+}
+/**
+ * Column component properties.
+ */
+export interface ColumnComponentProps {
+    children?: ChildrenDefinition;
+    distribution?: Distribution;
+    alignment?: Alignment;
+}
+/**
+ * List component properties.
+ */
+export interface ListComponentProps {
+    children?: ChildrenDefinition;
+    direction?: 'vertical' | 'horizontal';
+    alignment?: Alignment;
+}
+/**
+ * Card component properties.
+ */
+export interface CardComponentProps {
+    child?: string;
+}
+/**
+ * Tab item definition.
+ */
+export interface TabItem {
+    title?: ValueSource;
+    child: string;
+}
+/**
+ * Tabs component properties.
+ */
+export interface TabsComponentProps {
+    tabItems?: TabItem[];
+}
+/**
+ * Modal component properties.
+ */
+export interface ModalComponentProps {
+    entryPointChild?: string;
+    contentChild?: string;
+}
+/**
+ * Button component properties.
+ */
+export interface ButtonComponentProps {
+    child?: string;
+    primary?: boolean;
+    action?: Action;
+}
+/**
+ * CheckBox component properties.
+ */
+export interface CheckBoxComponentProps {
+    label?: ValueSource;
+    value?: ValueSource;
+}
+/**
+ * TextField component properties.
+ */
+export interface TextFieldComponentProps {
+    label?: ValueSource;
+    text?: ValueSource;
+    textFieldType?: 'date' | 'longText' | 'number' | 'shortText' | 'obscured';
+    validationRegexp?: string;
+}
+/**
+ * DateTimeInput component properties.
+ */
+export interface DateTimeInputComponentProps {
+    label?: ValueSource;
+    value?: ValueSource;
+    enableDate?: boolean;
+    enableTime?: boolean;
+}
+/**
+ * MultipleChoice option definition.
+ */
+export interface MultipleChoiceOption {
+    label?: ValueSource;
+    value: string;
+}
+/**
+ * MultipleChoice component properties.
+ */
+export interface MultipleChoiceComponentProps {
+    label?: ValueSource;
+    selections?: ValueSource;
+    options?: MultipleChoiceOption[];
+    maxAllowedSelections?: number;
+}
+/**
+ * Slider component properties.
+ */
+export interface SliderComponentProps {
+    label?: ValueSource;
+    value?: ValueSource;
+    minValue?: number;
+    maxValue?: number;
+}

package/dist/0.8/standard-catalog.js

@@ -0,0 +1 @@
+export {};

package/dist/0.9/index.d.ts

@@ -29,7 +29,7 @@ export interface CreateSurfacePayload {
  */
 export interface UpdateComponentsPayload {
     surfaceId: string;
-    components: Component[];
+    components: ComponentDefinition[];
 }
 /**
  * UpdateDataModel message payload - updates the data model at a specific path.
@@ -135,210 +135,27 @@ export interface Checkable {
     checks?: CheckRule[];
 }
 /**
- * Base component properties that all components share.
+ * Common properties for all components.
  */
-export interface ComponentBase {
+export interface ComponentCommon {
     id: string;
-    /** Discriminator: "Text", "Button", etc. */
-    component: string;
     /** flex-grow for Row/Column children */
     weight?: number;
 }
 /**
- * Text component.
- */
-export interface TextComponent extends ComponentBase {
-    component: 'Text';
-    text: DynamicString;
-    variant?: 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'caption' | 'body';
-}
-/**
- * Image component.
- */
-export interface ImageComponent extends ComponentBase {
-    component: 'Image';
-    url: DynamicString;
-    fit?: 'contain' | 'cover' | 'fill' | 'none' | 'scale-down';
-    variant?: 'icon' | 'avatar' | 'smallFeature' | 'mediumFeature' | 'largeFeature' | 'header';
-}
-/**
- * Icon component.
- */
-export interface IconComponent extends ComponentBase {
-    component: 'Icon';
-    name: DynamicString;
-}
-/**
- * Video component.
- */
-export interface VideoComponent extends ComponentBase {
-    component: 'Video';
-    url: DynamicString;
-}
-/**
- * AudioPlayer component.
- */
-export interface AudioPlayerComponent extends ComponentBase {
-    component: 'AudioPlayer';
-    url: DynamicString;
-    description?: DynamicString;
-}
-/**
- * Divider component.
- */
-export interface DividerComponent extends ComponentBase {
-    component: 'Divider';
-    axis?: 'horizontal' | 'vertical';
-}
-/**
- * Justify values for flex layouts (main axis distribution).
- */
-export type Justify = 'start' | 'center' | 'end' | 'spaceBetween' | 'spaceAround' | 'spaceEvenly' | 'stretch';
-/**
- * Align values for flex layouts (cross axis alignment).
- */
-export type Align = 'start' | 'center' | 'end' | 'stretch';
-/**
- * Row component.
- */
-export interface RowComponent extends ComponentBase {
-    component: 'Row';
-    children: ChildList;
-    justify?: Justify;
-    align?: Align;
-}
-/**
- * Column component.
- */
-export interface ColumnComponent extends ComponentBase {
-    component: 'Column';
-    children: ChildList;
-    justify?: Justify;
-    align?: Align;
-}
-/**
- * List component.
- */
-export interface ListComponent extends ComponentBase {
-    component: 'List';
-    children: ChildList;
-    direction?: 'vertical' | 'horizontal';
-    align?: Align;
-}
-/**
- * Card component.
- */
-export interface CardComponent extends ComponentBase {
-    component: 'Card';
-    /** Single child component ID */
-    child: string;
-}
-/**
- * Tab item definition.
- */
-export interface TabItem {
-    title: DynamicString;
-    /** Component ID */
-    child: string;
-}
-/**
- * Tabs component.
- */
-export interface TabsComponent extends ComponentBase {
-    component: 'Tabs';
-    tabs: TabItem[];
-}
-/**
- * Modal component.
- */
-export interface ModalComponent extends ComponentBase {
-    component: 'Modal';
-    /** Component ID for trigger */
-    trigger: string;
-    /** Component ID for content */
-    content: string;
-}
-/**
- * Action definition (attached to Button components).
- */
-export interface Action {
-    name: string;
-    context?: Record<string, DynamicValue>;
-}
-/**
- * Button component.
- */
-export interface ButtonComponent extends ComponentBase, Checkable {
-    component: 'Button';
-    /** Component ID (typically Text or Icon) */
-    child: string;
-    primary?: boolean;
-    action: Action;
-}
-/**
- * TextField component.
- */
-export interface TextFieldComponent extends ComponentBase, Checkable {
-    component: 'TextField';
-    label: DynamicString;
-    /** Two-way binding path */
-    value?: DynamicString;
-    variant?: 'longText' | 'number' | 'shortText' | 'obscured';
-}
-/**
- * CheckBox component.
- */
-export interface CheckBoxComponent extends ComponentBase, Checkable {
-    component: 'CheckBox';
-    label: DynamicString;
-    /** Two-way binding path */
-    value: DynamicBoolean;
-}
-/**
- * Choice option definition.
- */
-export interface ChoiceOption {
-    label: DynamicString;
-    value: string;
-}
-/**
- * ChoicePicker component (renamed from MultipleChoice).
- */
-export interface ChoicePickerComponent extends ComponentBase, Checkable {
-    component: 'ChoicePicker';
-    label?: DynamicString;
-    variant?: 'multipleSelection' | 'mutuallyExclusive';
-    options: ChoiceOption[];
-    /** Two-way binding path */
-    value: DynamicStringList;
-}
-/**
- * Slider component.
+ * Base component properties that all components share.
  */
-export interface SliderComponent extends ComponentBase, Checkable {
-    component: 'Slider';
-    label?: DynamicString;
-    min: number;
-    max: number;
-    /** Two-way binding path */
-    value: DynamicNumber;
+export interface BaseComponentDefinition extends ComponentCommon {
+    id: string;
+    /** Discriminator: "Text", "Button", etc. */
+    component: string;
 }
 /**
- * DateTimeInput component.
+ * Any components.
  */
-export interface DateTimeInputComponent extends ComponentBase, Checkable {
-    component: 'DateTimeInput';
-    /** Two-way binding path (ISO 8601) */
-    value: DynamicString;
-    enableDate?: boolean;
-    enableTime?: boolean;
-    outputFormat?: string;
-    label?: DynamicString;
+export interface ComponentDefinition extends BaseComponentDefinition {
+    [key: string]: unknown;
 }
-/**
- * Union type of all standard catalog components.
- */
-export type Component = TextComponent | ImageComponent | IconComponent | VideoComponent | AudioPlayerComponent | DividerComponent | RowComponent | ColumnComponent | ListComponent | CardComponent | TabsComponent | ModalComponent | ButtonComponent | TextFieldComponent | CheckBoxComponent | ChoicePickerComponent | SliderComponent | DateTimeInputComponent;
 /**
  * Data model type (hierarchical key-value store).
  */
@@ -349,17 +166,10 @@ export type DataModel = Record<string, unknown>;
 export interface SurfaceState {
     surfaceId: string;
     catalogId: string;
-    components: Map<string, Component>;
+    components: Map<string, ComponentDefinition>;
     dataModel: DataModel;
     created: boolean;
 }
-/**
- * Provider state managing multiple surfaces.
- */
-export interface ProviderState {
-    surfaces: Map<string, SurfaceState>;
-    messageBuffer: Map<string, A2UIMessage[]>;
-}
 /**
  * Scope value for collection scopes.
  */
@@ -375,6 +185,13 @@ export interface ValidationResult {
     /** List of failed check messages */
     errors: string[];
 }
+/**
+ * Action definition (attached to Button components).
+ */
+export interface Action {
+    name: string;
+    context?: Record<string, DynamicValue>;
+}
 /**
  * Resolved action payload sent to the action handler.
  */
@@ -389,3 +206,4 @@ export interface ActionPayload {
  * Action handler callback type.
  */
 export type ActionHandler = (action: ActionPayload) => void;
+export * as StandardCatalog from './standard-catalog.js';

package/dist/0.9/index.js

@@ -4,4 +4,4 @@
  * Core type definitions for the A2UI 0.9 React renderer.
  * Based on the A2UI 0.9 protocol specification.
  */
-export {};
+export * as StandardCatalog from './standard-catalog.js';

package/dist/0.9/standard-catalog.d.ts

@@ -0,0 +1,164 @@
+import type { Action, CheckRule, ChildList, DynamicBoolean, DynamicNumber, DynamicString, DynamicStringList } from './index.js';
+/**
+ * Justify values for flex layouts (main axis distribution).
+ */
+export type Justify = 'start' | 'center' | 'end' | 'spaceBetween' | 'spaceAround' | 'spaceEvenly' | 'stretch';
+/**
+ * Align values for flex layouts (cross axis alignment).
+ */
+export type Align = 'start' | 'center' | 'end' | 'stretch';
+/**
+ * Tab item definition.
+ */
+export interface TabItem {
+    title: DynamicString;
+    /** Component ID */
+    child: string;
+}
+/**
+ * Choice option definition.
+ */
+export interface ChoiceOption {
+    label: DynamicString;
+    value: string;
+}
+/**
+ * Text component props.
+ */
+export interface TextComponentProps {
+    text: DynamicString;
+    variant?: 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'caption' | 'body';
+}
+/**
+ * Image component props.
+ */
+export interface ImageComponentProps {
+    url: DynamicString;
+    fit?: 'contain' | 'cover' | 'fill' | 'none' | 'scale-down';
+    variant?: 'icon' | 'avatar' | 'smallFeature' | 'mediumFeature' | 'largeFeature' | 'header';
+}
+/**
+ * Icon component props.
+ */
+export interface IconComponentProps {
+    name: DynamicString;
+}
+/**
+ * Video component props.
+ */
+export interface VideoComponentProps {
+    url: DynamicString;
+}
+/**
+ * AudioPlayer component props.
+ */
+export interface AudioPlayerComponentProps {
+    url: DynamicString;
+    description?: DynamicString;
+}
+/**
+ * Divider component props.
+ */
+export interface DividerComponentProps {
+    axis?: 'horizontal' | 'vertical';
+}
+/**
+ * Row component props.
+ */
+export interface RowComponentProps {
+    children: ChildList;
+    justify?: Justify;
+    align?: Align;
+}
+/**
+ * Column component props.
+ */
+export interface ColumnComponentProps {
+    children: ChildList;
+    justify?: Justify;
+    align?: Align;
+}
+/**
+ * List component props.
+ */
+export interface ListComponentProps {
+    children: ChildList;
+    direction?: 'vertical' | 'horizontal';
+    align?: Align;
+}
+/**
+ * Card component props.
+ */
+export interface CardComponentProps {
+    child: string;
+}
+/**
+ * Tabs component props.
+ */
+export interface TabsComponentProps {
+    tabs: TabItem[];
+}
+/**
+ * Modal component props.
+ */
+export interface ModalComponentProps {
+    trigger: string;
+    content: string;
+}
+/**
+ * Checkable props mixin for validation.
+ */
+export interface CheckableProps {
+    checks?: CheckRule[];
+}
+/**
+ * Button component props.
+ */
+export interface ButtonComponentProps extends CheckableProps {
+    child: string;
+    primary?: boolean;
+    action: Action;
+}
+/**
+ * TextField component props.
+ */
+export interface TextFieldComponentProps extends CheckableProps {
+    label: DynamicString;
+    value?: DynamicString;
+    variant?: 'longText' | 'number' | 'shortText' | 'obscured';
+}
+/**
+ * CheckBox component props.
+ */
+export interface CheckBoxComponentProps extends CheckableProps {
+    label: DynamicString;
+    value: DynamicBoolean;
+}
+/**
+ * ChoicePicker component props.
+ */
+export interface ChoicePickerComponentProps extends CheckableProps {
+    label?: DynamicString;
+    variant?: 'multipleSelection' | 'mutuallyExclusive';
+    options: ChoiceOption[];
+    value: DynamicStringList;
+}
+/**
+ * Slider component props.
+ */
+export interface SliderComponentProps extends CheckableProps {
+    label?: DynamicString;
+    min: number;
+    max: number;
+    value: DynamicNumber;
+}
+/**
+ * DateTimeInput component props.
+ */
+export interface DateTimeInputComponentProps extends CheckableProps {
+    value: DynamicString;
+    enableDate?: boolean;
+    enableTime?: boolean;
+    outputFormat?: string;
+    label?: DynamicString;
+}

package/dist/0.9/standard-catalog.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a2ui-sdk/types",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "A2UI types",
   "homepage": "https://a2ui-sdk.js.org/",
   "repository": {
@@ -11,6 +11,7 @@
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "sideEffects": false,
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -20,9 +21,17 @@
       "types": "./dist/0.8/index.d.ts",
       "default": "./dist/0.8/index.js"
     },
+    "./0.8/standard-catalog": {
+      "types": "./dist/0.8/standard-catalog.d.ts",
+      "default": "./dist/0.8/standard-catalog.js"
+    },
     "./0.9": {
       "types": "./dist/0.9/index.d.ts",
       "default": "./dist/0.9/index.js"
+    },
+    "./0.9/standard-catalog": {
+      "types": "./dist/0.9/standard-catalog.d.ts",
+      "default": "./dist/0.9/standard-catalog.js"
     }
   },
   "files": [