@greensecurity/javascript-sdk 0.46.0-beta.5 → 0.46.0-beta.6

package/dist/commonjs/apps/components.d.ts

@@ -0,0 +1,1497 @@
+import { type RouteDescriptor } from "./route.js";
+export declare const SPACING: readonly ["0", "xxsmall", "xsmall", "small", "medium", "large", "xlarge", "xxlarge"];
+export declare const TEXT_COLORS: readonly ["primary", "secondary", "disabled", "info", "success", "attention", "critical", "brand"];
+export declare const FONTS: readonly ["body", "bodyEmphasized", "caption", "heading", "kicker", "lead", "subheading", "subtitle", "title"];
+export declare const FONT_WEIGHTS: readonly ["regular", "semibold", "bold"];
+export declare const WIDTHS: readonly ["fill", "fit", "1/2", "1/3", "2/3", "1/4", "3/4"];
+export declare const SIZES: readonly ["small", "medium", "large"];
+export declare const ALIGN_X: readonly ["start", "center", "end", "stretch"];
+export declare const ALIGN_Y: readonly ["top", "center", "baseline", "bottom", "stretch"];
+/** Icons an app may name. The host maps each to an icon it already ships. */
+export declare const ICON_NAMES: readonly ["add", "alert", "arrowLeft", "arrowRight", "calendar", "check", "chevronDown", "chevronRight", "clipboard", "close", "copy", "credential", "delete", "document", "download", "edit", "external", "facility", "filter", "info", "link", "lock", "mail", "more", "person", "phone", "refresh", "search", "settings", "star", "upload", "warning"];
+export type PropSpec = 
+/** `format: "date"` additionally requires an ISO 8601 calendar date (`YYYY-MM-DD`) that exists. */
+{
+    readonly type: "string";
+    readonly required?: boolean;
+    readonly maxLength?: number;
+    readonly format?: "date";
+}
+/** A finite number, optionally an integer and within `[min, max]`. */
+ | {
+    readonly type: "number";
+    readonly required?: boolean;
+    readonly integer?: boolean;
+    readonly min?: number;
+    readonly max?: number;
+} | {
+    readonly type: "boolean";
+    readonly required?: boolean;
+} | {
+    readonly type: "enum";
+    readonly values: readonly string[];
+    readonly required?: boolean;
+}
+/** A `RouteDescriptor`, or an https URL the host opens through `HostApi.openExternalUrl`. */
+ | {
+    readonly type: "href";
+    readonly required?: boolean;
+}
+/** An https or `data:image/` URL; the host additionally requires it to match the manifest's `image_src`. */
+ | {
+    readonly type: "imageSrc";
+    readonly required?: boolean;
+}
+/** A plain JSON value of a fixed shape, checked by `check`. */
+ | {
+    readonly type: "json";
+    readonly required?: boolean;
+    readonly check: (v: unknown) => boolean;
+    readonly __t?: unknown;
+};
+/** An event the host dispatches. `detail` is the single argument the app's handler receives. */
+export interface EventSpec<Detail = void> {
+    readonly event: string;
+    readonly __detail?: Detail;
+}
+export interface ComponentSpec {
+    readonly tagName: string;
+    readonly props: Readonly<Record<string, PropSpec>>;
+    readonly events: Readonly<Record<string, EventSpec<unknown>>>;
+    readonly slots: readonly string[];
+    /** Whether bare text children are allowed. The host wraps them in its text component. */
+    readonly text: boolean;
+    /** Tag names allowed as direct children; `null` means any non-root component. */
+    readonly children: readonly string[] | null;
+    readonly root?: true;
+}
+export interface ExternalLink {
+    href: string;
+    label: string;
+}
+export interface ConfirmCloseMessages {
+    title: string;
+    description: string;
+    cancelAction: string;
+    exitAction: string;
+}
+export declare const COMPONENTS: {
+    readonly ContextView: {
+        root?: true;
+        tagName: string;
+        props: {
+            readonly title: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            } & {
+                readonly required: true;
+            };
+            readonly description: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            };
+            readonly externalLink: {
+                readonly type: "json";
+                readonly check: (v: unknown) => boolean;
+                readonly __t?: ExternalLink;
+            };
+        };
+        events: {};
+        slots: readonly ["actions", "banner", "footerContent", "primaryAction", "secondaryAction"];
+        text: boolean;
+        children: readonly string[] | null;
+    };
+    readonly FocusView: {
+        root?: true;
+        tagName: string;
+        props: {
+            readonly title: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            } & {
+                readonly required: true;
+            };
+            readonly shown: {
+                readonly type: "boolean";
+            };
+            readonly size: {
+                readonly type: "enum";
+                readonly values: readonly ["small", "large"];
+            };
+            readonly confirmCloseMessages: {
+                readonly type: "json";
+                readonly check: (v: unknown) => boolean;
+                readonly __t?: ConfirmCloseMessages;
+            };
+        };
+        events: {
+            readonly onShownChange: EventSpec<boolean>;
+        };
+        slots: readonly ["footerContent", "primaryAction", "secondaryAction"];
+        text: boolean;
+        children: readonly string[] | null;
+    };
+    readonly SettingsView: {
+        root?: true;
+        tagName: string;
+        props: {
+            readonly statusMessage: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            };
+        };
+        events: {
+            readonly onSave: EventSpec<Record<string, string>>;
+        };
+        slots: [];
+        text: boolean;
+        children: readonly string[] | null;
+    };
+    readonly Box: {
+        root?: true;
+        tagName: string;
+        props: {
+            readonly font: {
+                readonly type: "enum";
+                readonly values: readonly ["body", "bodyEmphasized", "caption", "heading", "kicker", "lead", "subheading", "subtitle", "title"];
+            };
+            readonly color: {
+                readonly type: "enum";
+                readonly values: readonly ["primary", "secondary", "disabled", "info", "success", "attention", "critical", "brand"];
+            };
+            readonly fontWeight: {
+                readonly type: "enum";
+                readonly values: readonly ["regular", "semibold", "bold"];
+            };
+            readonly align: {
+                readonly type: "enum";
+                readonly values: readonly ["start", "center", "end"];
+            };
+            readonly stack: {
+                readonly type: "enum";
+                readonly values: readonly ["x", "y"];
+            };
+            readonly gap: {
+                readonly type: "enum";
+                readonly values: readonly ["0", "xxsmall", "xsmall", "small", "medium", "large", "xlarge", "xxlarge"];
+            };
+            readonly padding: {
+                readonly type: "enum";
+                readonly values: readonly ["0", "xxsmall", "xsmall", "small", "medium", "large", "xlarge", "xxlarge"];
+            };
+            readonly paddingX: {
+                readonly type: "enum";
+                readonly values: readonly ["0", "xxsmall", "xsmall", "small", "medium", "large", "xlarge", "xxlarge"];
+            };
+            readonly paddingY: {
+                readonly type: "enum";
+                readonly values: readonly ["0", "xxsmall", "xsmall", "small", "medium", "large", "xlarge", "xxlarge"];
+            };
+            readonly marginTop: {
+                readonly type: "enum";
+                readonly values: readonly ["0", "xxsmall", "xsmall", "small", "medium", "large", "xlarge", "xxlarge"];
+            };
+            readonly marginBottom: {
+                readonly type: "enum";
+                readonly values: readonly ["0", "xxsmall", "xsmall", "small", "medium", "large", "xlarge", "xxlarge"];
+            };
+            readonly alignX: {
+                readonly type: "enum";
+                readonly values: readonly ["start", "center", "end", "stretch"];
+            };
+            readonly alignY: {
+                readonly type: "enum";
+                readonly values: readonly ["top", "center", "baseline", "bottom", "stretch"];
+            };
+            readonly distribute: {
+                readonly type: "enum";
+                readonly values: readonly ["packed", "space-between"];
+            };
+            readonly wrap: {
+                readonly type: "boolean";
+            };
+            readonly width: {
+                readonly type: "enum";
+                readonly values: readonly ["fill", "fit", "1/2", "1/3", "2/3", "1/4", "3/4"];
+            };
+            readonly background: {
+                readonly type: "enum";
+                readonly values: readonly ["container", "surface"];
+            };
+            readonly border: {
+                readonly type: "enum";
+                readonly values: readonly ["none", "neutral", "critical"];
+            };
+            readonly radius: {
+                readonly type: "enum";
+                readonly values: readonly ["none", "small", "medium", "large", "rounded"];
+            };
+        };
+        events: {};
+        slots: [];
+        text: boolean;
+        children: readonly string[] | null;
+    };
+    readonly Inline: {
+        root?: true;
+        tagName: string;
+        props: {
+            font: {
+                readonly type: "enum";
+                readonly values: readonly ["body", "bodyEmphasized", "caption", "heading", "kicker", "lead", "subheading", "subtitle", "title"];
+            };
+            color: {
+                readonly type: "enum";
+                readonly values: readonly ["primary", "secondary", "disabled", "info", "success", "attention", "critical", "brand"];
+            };
+            fontWeight: {
+                readonly type: "enum";
+                readonly values: readonly ["regular", "semibold", "bold"];
+            };
+            align: {
+                readonly type: "enum";
+                readonly values: readonly ["start", "center", "end"];
+            };
+        };
+        events: {};
+        slots: [];
+        text: boolean;
+        children: readonly string[] | null;
+    };
+    readonly Divider: {
+        root?: true;
+        tagName: string;
+        props: {
+            readonly orientation: {
+                readonly type: "enum";
+                readonly values: readonly ["horizontal", "vertical"];
+            };
+        };
+        events: {};
+        slots: [];
+        text: boolean;
+        children: readonly string[] | null;
+    };
+    readonly Card: {
+        root?: true;
+        tagName: string;
+        props: {
+            readonly variant: {
+                readonly type: "enum";
+                readonly values: readonly ["elevated", "outline", "ghost", "filled"];
+            };
+            readonly padding: {
+                readonly type: "enum";
+                readonly values: readonly ["0", "xxsmall", "xsmall", "small", "medium", "large", "xlarge", "xxlarge"];
+            };
+        };
+        events: {};
+        slots: [];
+        text: boolean;
+        children: readonly string[] | null;
+    };
+    readonly Text: {
+        root?: true;
+        tagName: string;
+        props: {
+            readonly truncate: {
+                readonly type: "boolean";
+            };
+            readonly font: {
+                readonly type: "enum";
+                readonly values: readonly ["body", "bodyEmphasized", "caption", "heading", "kicker", "lead", "subheading", "subtitle", "title"];
+            };
+            readonly color: {
+                readonly type: "enum";
+                readonly values: readonly ["primary", "secondary", "disabled", "info", "success", "attention", "critical", "brand"];
+            };
+            readonly fontWeight: {
+                readonly type: "enum";
+                readonly values: readonly ["regular", "semibold", "bold"];
+            };
+            readonly align: {
+                readonly type: "enum";
+                readonly values: readonly ["start", "center", "end"];
+            };
+        };
+        events: {};
+        slots: [];
+        text: boolean;
+        children: readonly string[] | null;
+    };
+    readonly Heading: {
+        root?: true;
+        tagName: string;
+        props: {
+            readonly size: {
+                readonly type: "enum";
+                readonly values: readonly ["small", "medium", "large"];
+            };
+        };
+        events: {};
+        slots: [];
+        text: boolean;
+        children: readonly string[] | null;
+    };
+    readonly Badge: {
+        root?: true;
+        tagName: string;
+        props: {
+            readonly type: {
+                readonly type: "enum";
+                readonly values: readonly ["neutral", "info", "positive", "negative", "warning", "urgent"];
+            };
+        };
+        events: {};
+        slots: [];
+        text: boolean;
+        children: readonly string[] | null;
+    };
+    readonly Banner: {
+        root?: true;
+        tagName: string;
+        props: {
+            readonly type: {
+                readonly type: "enum";
+                readonly values: readonly ["default", "caution", "critical"];
+            };
+            readonly title: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            };
+            readonly description: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            };
+        };
+        events: {
+            readonly onDismiss: EventSpec<unknown>;
+        };
+        slots: readonly ["actions"];
+        text: boolean;
+        children: readonly string[] | null;
+    };
+    readonly Spinner: {
+        root?: true;
+        tagName: string;
+        props: {
+            readonly size: {
+                readonly type: "enum";
+                readonly values: readonly ["small", "medium", "large"];
+            };
+        };
+        events: {};
+        slots: [];
+        text: boolean;
+        children: readonly string[] | null;
+    };
+    readonly Progress: {
+        root?: true;
+        tagName: string;
+        props: {
+            readonly value: {
+                readonly type: "number";
+                readonly integer?: boolean;
+                readonly min?: number;
+                readonly max?: number;
+            } & {
+                readonly required: true;
+            };
+            readonly label: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            };
+        };
+        events: {};
+        slots: [];
+        text: boolean;
+        children: readonly string[] | null;
+    };
+    readonly Icon: {
+        root?: true;
+        tagName: string;
+        props: {
+            readonly name: {
+                readonly type: "enum";
+                readonly values: readonly ["add", "alert", "arrowLeft", "arrowRight", "calendar", "check", "chevronDown", "chevronRight", "clipboard", "close", "copy", "credential", "delete", "document", "download", "edit", "external", "facility", "filter", "info", "link", "lock", "mail", "more", "person", "phone", "refresh", "search", "settings", "star", "upload", "warning"];
+            } & {
+                readonly required: true;
+            };
+            readonly size: {
+                readonly type: "enum";
+                readonly values: readonly ["small", "medium", "large"];
+            };
+            readonly color: {
+                readonly type: "enum";
+                readonly values: readonly ["primary", "secondary", "disabled", "info", "success", "attention", "critical", "brand"];
+            };
+        };
+        events: {};
+        slots: [];
+        text: boolean;
+        children: readonly string[] | null;
+    };
+    readonly Img: {
+        root?: true;
+        tagName: string;
+        props: {
+            readonly src: {
+                readonly type: "imageSrc";
+            } & {
+                readonly required: true;
+            };
+            readonly alt: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            } & {
+                readonly required: true;
+            };
+            readonly width: {
+                readonly type: "number";
+                readonly integer?: boolean;
+                readonly min?: number;
+                readonly max?: number;
+            };
+            readonly height: {
+                readonly type: "number";
+                readonly integer?: boolean;
+                readonly min?: number;
+                readonly max?: number;
+            };
+        };
+        events: {};
+        slots: [];
+        text: boolean;
+        children: readonly string[] | null;
+    };
+    readonly Avatar: {
+        root?: true;
+        tagName: string;
+        props: {
+            readonly name: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            } & {
+                readonly required: true;
+            };
+            readonly src: {
+                readonly type: "imageSrc";
+            };
+            readonly size: {
+                readonly type: "enum";
+                readonly values: readonly ["small", "medium", "large"];
+            };
+        };
+        events: {};
+        slots: [];
+        text: boolean;
+        children: readonly string[] | null;
+    };
+    readonly Button: {
+        root?: true;
+        tagName: string;
+        props: {
+            readonly type: {
+                readonly type: "enum";
+                readonly values: readonly ["primary", "secondary", "destructive"];
+            };
+            readonly size: {
+                readonly type: "enum";
+                readonly values: readonly ["small", "medium", "large"];
+            };
+            readonly disabled: {
+                readonly type: "boolean";
+            };
+            readonly pending: {
+                readonly type: "boolean";
+            };
+            readonly href: {
+                readonly type: "href";
+            };
+            readonly width: {
+                readonly type: "enum";
+                readonly values: readonly ["fill", "fit", "1/2", "1/3", "2/3", "1/4", "3/4"];
+            };
+            readonly accessibilityLabel: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            };
+        };
+        events: {
+            readonly onPress: EventSpec<unknown>;
+        };
+        slots: [];
+        text: boolean;
+        children: readonly string[] | null;
+    };
+    readonly ButtonGroup: {
+        root?: true;
+        tagName: string;
+        props: {
+            readonly direction: {
+                readonly type: "enum";
+                readonly values: readonly ["row", "column"];
+            };
+        };
+        events: {};
+        slots: [];
+        text: boolean;
+        children: readonly string[] | null;
+    };
+    readonly Link: {
+        root?: true;
+        tagName: string;
+        props: {
+            readonly type: {
+                readonly type: "enum";
+                readonly values: readonly ["primary", "secondary"];
+            };
+            readonly href: {
+                readonly type: "href";
+            };
+            readonly disabled: {
+                readonly type: "boolean";
+            };
+            readonly accessibilityLabel: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            };
+        };
+        events: {
+            readonly onPress: EventSpec<unknown>;
+        };
+        slots: [];
+        text: boolean;
+        children: readonly string[] | null;
+    };
+    readonly Menu: {
+        root?: true;
+        tagName: string;
+        props: {};
+        events: {
+            readonly onAction: EventSpec<string>;
+        };
+        slots: readonly ["trigger"];
+        text: boolean;
+        children: readonly string[] | null;
+    };
+    readonly MenuGroup: {
+        root?: true;
+        tagName: string;
+        props: {
+            readonly title: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            };
+        };
+        events: {};
+        slots: [];
+        text: boolean;
+        children: readonly string[] | null;
+    };
+    readonly MenuItem: {
+        root?: true;
+        tagName: string;
+        props: {
+            readonly id: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            } & {
+                readonly required: true;
+            };
+            readonly disabled: {
+                readonly type: "boolean";
+            };
+        };
+        events: {
+            readonly onPress: EventSpec<unknown>;
+        };
+        slots: [];
+        text: boolean;
+        children: readonly string[] | null;
+    };
+    readonly Accordion: {
+        root?: true;
+        tagName: string;
+        props: {};
+        events: {};
+        slots: [];
+        text: boolean;
+        children: readonly string[] | null;
+    };
+    readonly AccordionItem: {
+        root?: true;
+        tagName: string;
+        props: {
+            readonly title: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            } & {
+                readonly required: true;
+            };
+            readonly subtitle: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            };
+            readonly defaultOpen: {
+                readonly type: "boolean";
+            };
+        };
+        events: {};
+        slots: [];
+        text: boolean;
+        children: readonly string[] | null;
+    };
+    readonly List: {
+        root?: true;
+        tagName: string;
+        props: {};
+        events: {
+            readonly onAction: EventSpec<string>;
+        };
+        slots: [];
+        text: boolean;
+        children: readonly string[] | null;
+    };
+    readonly ListItem: {
+        root?: true;
+        tagName: string;
+        props: {
+            readonly id: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            } & {
+                readonly required: true;
+            };
+            readonly title: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            } & {
+                readonly required: true;
+            };
+            readonly secondaryTitle: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            };
+            readonly icon: {
+                readonly type: "enum";
+                readonly values: readonly ["add", "alert", "arrowLeft", "arrowRight", "calendar", "check", "chevronDown", "chevronRight", "clipboard", "close", "copy", "credential", "delete", "document", "download", "edit", "external", "facility", "filter", "info", "link", "lock", "mail", "more", "person", "phone", "refresh", "search", "settings", "star", "upload", "warning"];
+            };
+            readonly size: {
+                readonly type: "enum";
+                readonly values: readonly ["default", "large"];
+            };
+        };
+        events: {};
+        slots: readonly ["value"];
+        text: boolean;
+        children: readonly string[] | null;
+    };
+    readonly PropertyList: {
+        root?: true;
+        tagName: string;
+        props: {
+            readonly orientation: {
+                readonly type: "enum";
+                readonly values: readonly ["vertical", "horizontal"];
+            };
+        };
+        events: {};
+        slots: [];
+        text: boolean;
+        children: readonly string[] | null;
+    };
+    readonly PropertyListItem: {
+        root?: true;
+        tagName: string;
+        props: {
+            readonly label: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            } & {
+                readonly required: true;
+            };
+            readonly value: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            };
+        };
+        events: {};
+        slots: readonly ["value"];
+        text: boolean;
+        children: readonly string[] | null;
+    };
+    readonly Table: {
+        root?: true;
+        tagName: string;
+        props: {};
+        events: {};
+        slots: [];
+        text: boolean;
+        children: readonly string[] | null;
+    };
+    readonly TableHead: {
+        root?: true;
+        tagName: string;
+        props: {};
+        events: {};
+        slots: [];
+        text: boolean;
+        children: readonly string[] | null;
+    };
+    readonly TableBody: {
+        root?: true;
+        tagName: string;
+        props: {};
+        events: {};
+        slots: [];
+        text: boolean;
+        children: readonly string[] | null;
+    };
+    readonly TableRow: {
+        root?: true;
+        tagName: string;
+        props: {};
+        events: {};
+        slots: [];
+        text: boolean;
+        children: readonly string[] | null;
+    };
+    readonly TableHeaderCell: {
+        root?: true;
+        tagName: string;
+        props: {
+            align: {
+                readonly type: "enum";
+                readonly values: readonly ["start", "center", "end"];
+            };
+            width: {
+                readonly type: "enum";
+                readonly values: readonly ["fill", "fit", "1/2", "1/3", "2/3", "1/4", "3/4"];
+            };
+        };
+        events: {};
+        slots: [];
+        text: boolean;
+        children: readonly string[] | null;
+    };
+    readonly TableCell: {
+        root?: true;
+        tagName: string;
+        props: {
+            align: {
+                readonly type: "enum";
+                readonly values: readonly ["start", "center", "end"];
+            };
+            width: {
+                readonly type: "enum";
+                readonly values: readonly ["fill", "fit", "1/2", "1/3", "2/3", "1/4", "3/4"];
+            };
+        };
+        events: {};
+        slots: [];
+        text: boolean;
+        children: readonly string[] | null;
+    };
+    readonly Tabs: {
+        root?: true;
+        tagName: string;
+        props: {
+            readonly selectedKey: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            };
+            readonly fitted: {
+                readonly type: "boolean";
+            };
+        };
+        events: {
+            readonly onSelectionChange: EventSpec<string>;
+        };
+        slots: [];
+        text: boolean;
+        children: readonly string[] | null;
+    };
+    readonly TabList: {
+        root?: true;
+        tagName: string;
+        props: {};
+        events: {};
+        slots: [];
+        text: boolean;
+        children: readonly string[] | null;
+    };
+    readonly Tab: {
+        root?: true;
+        tagName: string;
+        props: {
+            readonly id: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            } & {
+                readonly required: true;
+            };
+            readonly disabled: {
+                readonly type: "boolean";
+            };
+        };
+        events: {};
+        slots: [];
+        text: boolean;
+        children: readonly string[] | null;
+    };
+    readonly TabPanels: {
+        root?: true;
+        tagName: string;
+        props: {};
+        events: {};
+        slots: [];
+        text: boolean;
+        children: readonly string[] | null;
+    };
+    readonly TabPanel: {
+        root?: true;
+        tagName: string;
+        props: {
+            readonly id: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            } & {
+                readonly required: true;
+            };
+        };
+        events: {};
+        slots: [];
+        text: boolean;
+        children: readonly string[] | null;
+    };
+    readonly TextField: {
+        root?: true;
+        tagName: string;
+        props: {
+            readonly placeholder: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            };
+            readonly value: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            };
+            readonly defaultValue: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            };
+            readonly type: {
+                readonly type: "enum";
+                readonly values: readonly ["text", "number", "email", "tel", "url", "password", "search"];
+            };
+            readonly readOnly: {
+                readonly type: "boolean";
+            };
+            readonly maxLength: {
+                readonly type: "number";
+                readonly integer?: boolean;
+                readonly min?: number;
+                readonly max?: number;
+            };
+            readonly autoFocus: {
+                readonly type: "boolean";
+            };
+            readonly label: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            } & {
+                readonly required: true;
+            };
+            readonly hideLabel: {
+                readonly type: "boolean";
+            };
+            readonly description: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            };
+            readonly error: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            };
+            readonly name: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            };
+            readonly disabled: {
+                readonly type: "boolean";
+            };
+            readonly required: {
+                readonly type: "boolean";
+            };
+        };
+        events: {
+            readonly onChange: EventSpec<string>;
+            readonly onBlur: EventSpec<unknown>;
+            readonly onFocus: EventSpec<unknown>;
+        };
+        slots: [];
+        text: boolean;
+        children: readonly string[] | null;
+    };
+    readonly TextArea: {
+        root?: true;
+        tagName: string;
+        props: {
+            readonly placeholder: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            };
+            readonly value: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            };
+            readonly defaultValue: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            };
+            readonly rows: {
+                readonly type: "number";
+                readonly integer?: boolean;
+                readonly min?: number;
+                readonly max?: number;
+            };
+            readonly readOnly: {
+                readonly type: "boolean";
+            };
+            readonly maxLength: {
+                readonly type: "number";
+                readonly integer?: boolean;
+                readonly min?: number;
+                readonly max?: number;
+            };
+            readonly label: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            } & {
+                readonly required: true;
+            };
+            readonly hideLabel: {
+                readonly type: "boolean";
+            };
+            readonly description: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            };
+            readonly error: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            };
+            readonly name: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            };
+            readonly disabled: {
+                readonly type: "boolean";
+            };
+            readonly required: {
+                readonly type: "boolean";
+            };
+        };
+        events: {
+            readonly onChange: EventSpec<string>;
+            readonly onBlur: EventSpec<unknown>;
+            readonly onFocus: EventSpec<unknown>;
+        };
+        slots: [];
+        text: boolean;
+        children: readonly string[] | null;
+    };
+    readonly Select: {
+        root?: true;
+        tagName: string;
+        props: {
+            readonly placeholder: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            };
+            readonly value: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            };
+            readonly defaultValue: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            };
+            readonly label: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            } & {
+                readonly required: true;
+            };
+            readonly hideLabel: {
+                readonly type: "boolean";
+            };
+            readonly description: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            };
+            readonly error: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            };
+            readonly name: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            };
+            readonly disabled: {
+                readonly type: "boolean";
+            };
+            readonly required: {
+                readonly type: "boolean";
+            };
+        };
+        events: {
+            readonly onChange: EventSpec<string>;
+        };
+        slots: [];
+        text: boolean;
+        children: readonly string[] | null;
+    };
+    readonly SelectOption: {
+        root?: true;
+        tagName: string;
+        props: {
+            readonly value: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            } & {
+                readonly required: true;
+            };
+            readonly label: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            } & {
+                readonly required: true;
+            };
+            readonly disabled: {
+                readonly type: "boolean";
+            };
+        };
+        events: {};
+        slots: [];
+        text: boolean;
+        children: readonly string[] | null;
+    };
+    readonly Checkbox: {
+        root?: true;
+        tagName: string;
+        props: {
+            readonly checked: {
+                readonly type: "boolean";
+            };
+            readonly defaultChecked: {
+                readonly type: "boolean";
+            };
+            readonly invalid: {
+                readonly type: "boolean";
+            };
+            readonly label: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            } & {
+                readonly required: true;
+            };
+            readonly hideLabel: {
+                readonly type: "boolean";
+            };
+            readonly description: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            };
+            readonly error: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            };
+            readonly name: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            };
+            readonly disabled: {
+                readonly type: "boolean";
+            };
+            readonly required: {
+                readonly type: "boolean";
+            };
+        };
+        events: {
+            readonly onChange: EventSpec<boolean>;
+        };
+        slots: [];
+        text: boolean;
+        children: readonly string[] | null;
+    };
+    readonly RadioGroup: {
+        root?: true;
+        tagName: string;
+        props: {
+            readonly value: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            };
+            readonly defaultValue: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            };
+            readonly label: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            } & {
+                readonly required: true;
+            };
+            readonly hideLabel: {
+                readonly type: "boolean";
+            };
+            readonly description: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            };
+            readonly error: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            };
+            readonly name: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            };
+            readonly disabled: {
+                readonly type: "boolean";
+            };
+            readonly required: {
+                readonly type: "boolean";
+            };
+        };
+        events: {
+            readonly onChange: EventSpec<string>;
+        };
+        slots: [];
+        text: boolean;
+        children: readonly string[] | null;
+    };
+    readonly Radio: {
+        root?: true;
+        tagName: string;
+        props: {
+            readonly value: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            } & {
+                readonly required: true;
+            };
+            readonly label: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            } & {
+                readonly required: true;
+            };
+            readonly disabled: {
+                readonly type: "boolean";
+            };
+        };
+        events: {};
+        slots: [];
+        text: boolean;
+        children: readonly string[] | null;
+    };
+    readonly Switch: {
+        root?: true;
+        tagName: string;
+        props: {
+            readonly checked: {
+                readonly type: "boolean";
+            };
+            readonly defaultChecked: {
+                readonly type: "boolean";
+            };
+            readonly label: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            } & {
+                readonly required: true;
+            };
+            readonly hideLabel: {
+                readonly type: "boolean";
+            };
+            readonly description: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            };
+            readonly error: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            };
+            readonly name: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            };
+            readonly disabled: {
+                readonly type: "boolean";
+            };
+            readonly required: {
+                readonly type: "boolean";
+            };
+        };
+        events: {
+            readonly onChange: EventSpec<boolean>;
+        };
+        slots: [];
+        text: boolean;
+        children: readonly string[] | null;
+    };
+    readonly DateField: {
+        root?: true;
+        tagName: string;
+        props: {
+            readonly value: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            };
+            readonly defaultValue: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            };
+            readonly min: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            };
+            readonly max: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            };
+            readonly label: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            } & {
+                readonly required: true;
+            };
+            readonly hideLabel: {
+                readonly type: "boolean";
+            };
+            readonly description: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            };
+            readonly error: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            };
+            readonly name: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            };
+            readonly disabled: {
+                readonly type: "boolean";
+            };
+            readonly required: {
+                readonly type: "boolean";
+            };
+        };
+        events: {
+            readonly onChange: EventSpec<string>;
+        };
+        slots: [];
+        text: boolean;
+        children: readonly string[] | null;
+    };
+    readonly FormFieldGroup: {
+        root?: true;
+        tagName: string;
+        props: {
+            readonly legend: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            };
+            readonly description: {
+                readonly type: "string";
+                readonly maxLength?: number;
+                readonly format?: "date";
+            };
+            readonly layout: {
+                readonly type: "enum";
+                readonly values: readonly ["row", "column"];
+            };
+        };
+        events: {};
+        slots: [];
+        text: boolean;
+        children: readonly string[] | null;
+    };
+};
+export type ComponentName = keyof typeof COMPONENTS;
+export type TagName = (typeof COMPONENTS)[ComponentName]["tagName"];
+type ValueOf<S> = S extends {
+    type: "string";
+} ? string : S extends {
+    type: "number";
+} ? number : S extends {
+    type: "boolean";
+} ? boolean : S extends {
+    type: "enum";
+    values: readonly (infer V)[];
+} ? V : S extends {
+    type: "href";
+} ? RouteDescriptor | string : S extends {
+    type: "imageSrc";
+} ? string : S extends {
+    type: "json";
+    __t?: infer T;
+} ? T : never;
+type RequiredKeys<P> = {
+    [K in keyof P]: P[K] extends {
+        required: true;
+    } ? K : never;
+}[keyof P];
+type OptionalKeys<P> = Exclude<keyof P, RequiredKeys<P>>;
+type DataProps<P> = {
+    [K in RequiredKeys<P>]: ValueOf<P[K]>;
+} & {
+    [K in OptionalKeys<P>]?: ValueOf<P[K]>;
+};
+type EventProps<E> = {
+    [K in keyof E]?: E[K] extends EventSpec<infer D> ? ([D] extends [void] ? () => unknown : (detail: D) => unknown) : never;
+};
+type SlotNames<S> = S extends readonly (infer N extends string)[] ? N : never;
+type SlotProps<P, S, Node> = {
+    [K in SlotNames<S>]?: Node | (K extends keyof P ? ValueOf<P[K]> : never);
+};
+/**
+ * Props an app passes to a component. `Node` is the app's element type (React's `ReactNode` in
+ * the SDK). `children` is always accepted here; which children a tag may hold is enforced at
+ * runtime by the host from `children` / `text` in the catalog.
+ */
+export type ComponentProps<Name extends ComponentName, Node = unknown> = Omit<DataProps<(typeof COMPONENTS)[Name]["props"]>, SlotNames<(typeof COMPONENTS)[Name]["slots"]>> & EventProps<(typeof COMPONENTS)[Name]["events"]> & SlotProps<(typeof COMPONENTS)[Name]["props"], (typeof COMPONENTS)[Name]["slots"], Node> & {
+    children?: Node;
+};
+export declare function getComponentByTag(tagName: string): ComponentSpec | undefined;
+export declare function isValidHref(value: unknown): value is RouteDescriptor | string;
+/**
+ * Largest `data:image/` URL an app may pass, in characters (~64 KB decoded). This bounds the work of
+ * reading it, not the memory of drawing it: a small compressed image can declare huge dimensions,
+ * so {@link isValidImageSrc} also checks the dimensions in its header.
+ */
+export declare const DATA_IMAGE_MAX_CHARS = 90000;
+/** Largest width or height of a `data:` image, in pixels. */
+export declare const DATA_IMAGE_MAX_EDGE = 2048;
+/** Largest area of a `data:` image, in pixels: 4 MB once decoded to RGBA. */
+export declare const DATA_IMAGE_MAX_PIXELS: number;
+/**
+ * An https URL, or a base64 `data:` PNG, JPEG or WebP no longer than
+ * {@link DATA_IMAGE_MAX_CHARS} whose header declares a non-empty size within
+ * {@link DATA_IMAGE_MAX_EDGE} and {@link DATA_IMAGE_MAX_PIXELS}. The host additionally requires an
+ * https URL to match the manifest's `image_src`.
+ */
+export declare function isValidImageSrc(value: unknown): value is string;
+/** An ISO 8601 calendar date, `YYYY-MM-DD`, naming a day that exists (leap years included). */
+export declare function isCalendarDate(value: unknown): value is string;
+export interface SanitizedProps {
+    props: Record<string, unknown>;
+    /** Names of props that were unknown or failed their type check. */
+    dropped: string[];
+    /** Required props that were missing or invalid; the host should not render the element. */
+    missing: string[];
+}
+/**
+ * Keeps only the props the catalog declares for a tag, each of the declared type. Event and slot
+ * props are not handled here: remote-dom delivers them separately (event listeners and slotted
+ * children). An unknown tag keeps nothing.
+ */
+export declare function sanitizeProps(tagName: string, raw: Readonly<Record<string, unknown>>): SanitizedProps;
+/** A JSON-safe description of the catalog, for docs and the CLI. */
+export declare function componentsCatalogJson(): Array<{
+    name: string;
+    tagName: string;
+    root: boolean;
+    text: boolean;
+    children: readonly string[] | null;
+    slots: readonly string[];
+    props: Record<string, {
+        type: string;
+        required: boolean;
+        values?: readonly string[];
+        maxLength?: number;
+        minLength?: number;
+        format?: "date";
+        integer?: boolean;
+        minimum?: number;
+        maximum?: number;
+    }>;
+    events: Record<string, string>;
+}>;
+export {};
+//# sourceMappingURL=components.d.ts.map