@bsm-form/schema 0.39.0

package/dist/index.d.ts

@@ -0,0 +1,981 @@
+type ConditionOperator = "equals" | "notEquals" | "greaterThan" | "lessThan" | "exists" | "empty" | "notEmpty";
+/** Operators that do not use a comparison `value`. */
+declare function isValuelessConditionOperator(operator: ConditionOperator): boolean;
+/** Field / state / pending comparison used by visibility, disabledWhen, and computed `if`. */
+type FieldCondition = {
+    field: string;
+    operator: ConditionOperator;
+    value?: unknown;
+};
+/**
+ * Host-registered predicate by name (`FormEngineEnvironment.predicates`).
+ * Schema stores only the name; function bodies never live in the condition.
+ */
+type InvokeCondition = {
+    type: "invoke";
+    name: string;
+};
+type Condition = FieldCondition | InvokeCondition;
+declare function isInvokeCondition(condition: Condition): condition is InvokeCondition;
+declare function isFieldCondition(condition: Condition): condition is FieldCondition;
+
+type NodeKind = "layout" | "field" | "action" | "display";
+type BaseNode = {
+    id: string;
+    kind: NodeKind;
+    type: string;
+    props?: Record<string, unknown>;
+    /**
+     * Disable when every condition passes (AND). Combined with
+     * `props.disabled === true` (static always wins / ORs in).
+     */
+    disabledWhen?: Condition[];
+};
+
+type ActionType = "submit" | "reset" | "custom";
+type StepperActionType = "stepper-next" | "stepper-previous";
+type BaseActionNode = Omit<BaseNode, "kind" | "type"> & {
+    kind: "action";
+    /** Visibility conditions (AND). Same model as field/display. */
+    conditions?: Condition[];
+};
+type SubmitActionNode = BaseActionNode & {
+    type: "submit";
+    action?: {
+        steps: Step[];
+    };
+    stepperId?: never;
+};
+type ResetActionNode = BaseActionNode & {
+    type: "reset";
+    action?: never;
+    stepperId?: never;
+};
+/** @deprecated Use SubmitActionNode | ResetActionNode */
+type SubmitOrResetActionNode = SubmitActionNode | ResetActionNode;
+type CustomActionNode = BaseActionNode & {
+    type: "custom";
+    action?: {
+        steps: Step[];
+    };
+    stepperId?: never;
+};
+type StepperActionNode = BaseActionNode & {
+    type: StepperActionType;
+    stepperId: string;
+    action?: never;
+};
+type ActionNode = SubmitActionNode | ResetActionNode | CustomActionNode | StepperActionNode;
+
+type ValidationRule = {
+    type: "required";
+    message?: string;
+} | {
+    type: "min";
+    value: number;
+    message?: string;
+} | {
+    type: "max";
+    value: number;
+    message?: string;
+} | {
+    type: "length";
+    value: number;
+    message?: string;
+} | {
+    /**
+     * Host-registered validator by name (`FormEngineEnvironment.validators`).
+     * Handler returns `true` when valid, or a string error message when invalid.
+     */
+    type: "invoke";
+    name: string;
+    /** Fallback when the handler returns a non-string failure value. */
+    message?: string;
+};
+
+type FieldType = "text" | "number" | "textarea" | "select" | "checkbox" | "switch" | "radio" | "segment-button" | "slider" | "time" | "otp" | "date";
+/**
+ * Text-like fields may declare `blur`. Discrete-choice fields may declare
+ * `change`. Slider may declare `commit`. The families are mutually exclusive.
+ */
+type FieldEventType = "blur" | "change" | "commit";
+type FieldEventConfig = {
+    steps: Step[];
+};
+declare const FIELD_TYPES_WITH_CHANGE_EVENT: readonly ["select", "radio", "segment-button", "checkbox", "switch"];
+declare const FIELD_TYPES_WITH_COMMIT_EVENT: readonly ["slider"];
+type FieldTypeWithChangeEvent = (typeof FIELD_TYPES_WITH_CHANGE_EVENT)[number];
+type FieldTypeWithCommitEvent = (typeof FIELD_TYPES_WITH_COMMIT_EVENT)[number];
+declare function fieldAllowsChangeEvent(type: FieldType): boolean;
+declare function fieldAllowsCommitEvent(type: FieldType): boolean;
+/** Text-like inputs: blur only (not discrete choice or slider). */
+declare function fieldAllowsBlurEvent(type: FieldType): boolean;
+declare function fieldAllowsEvent(type: FieldType, event: string): event is FieldEventType;
+type SliderMode = "single" | "range";
+type SliderRangeValue = [number, number];
+type SliderValue = number | SliderRangeValue;
+type TimeValue = {
+    hour: string;
+    minute: string;
+};
+type SelectMode = "select" | "multi";
+type SelectOptionValue = string | number;
+type SelectValue = SelectOptionValue | SelectOptionValue[];
+type SegmentButtonSize = "xs" | "sm" | "md" | "lg";
+type SegmentButtonValue = SelectOptionValue;
+type SegmentButtonFieldProps = Record<string, unknown> & {
+    value?: SegmentButtonValue;
+    label?: string;
+    hint?: string;
+    helperText?: string;
+    size?: SegmentButtonSize;
+    disabled?: boolean;
+    readOnly?: boolean;
+    rounded?: boolean;
+    fullWidth?: boolean;
+    className?: string;
+    ariaLabel?: string;
+};
+type SegmentButtonOptionsConfig = {
+    source: string;
+    label: string;
+    value: string;
+    disabled?: string;
+} | {
+    items: {
+        label: string;
+        value: SegmentButtonValue;
+        disabled?: boolean;
+    }[];
+};
+type ComputedInput = {
+    type: "field";
+    path: string;
+} | {
+    type: "constant";
+    value: unknown;
+};
+type ComputedOperator = "concat" | "sum" | "subtract" | "multiply" | "divide" | "coalesce" | "if" | "today" | "invoke";
+type ComputedCondition = Condition;
+type ComputedConfig = {
+    operator: "concat" | "sum" | "subtract" | "multiply" | "divide" | "coalesce" | "today";
+    inputs: ComputedInput[];
+    options?: Record<string, unknown>;
+} | {
+    operator: "if";
+    condition: ComputedCondition[];
+    then: ComputedInput;
+    else: ComputedInput;
+} | {
+    /**
+     * Host-registered computer by name (`FormEngineEnvironment.computers`).
+     * Sync return value becomes the field value.
+     */
+    operator: "invoke";
+    name: string;
+};
+type OptionsConfig = {
+    source: string;
+    label: string;
+    value: string;
+} | {
+    items: {
+        label: string;
+        value: SelectOptionValue;
+    }[];
+};
+type FieldNode = BaseNode & {
+    kind: "field";
+    type: FieldType;
+    name: string;
+    validation?: ValidationRule[];
+    conditions?: Condition[];
+    options?: OptionsConfig;
+    bind?: {
+        value: string;
+    };
+    computed?: ComputedConfig;
+    /**
+     * Serializable field interactions. Families are mutually exclusive:
+     * text-like → `blur`; select/radio/segment-button/checkbox/switch → `change`;
+     * slider → `commit`.
+     */
+    events?: Partial<Record<FieldEventType, FieldEventConfig>>;
+};
+type SegmentButtonFieldNode = Omit<FieldNode, "type" | "options" | "props"> & {
+    type: "segment-button";
+    props?: SegmentButtonFieldProps;
+    options: SegmentButtonOptionsConfig;
+};
+
+type DisplayType = "tag" | "alert" | "chips" | "skeleton" | "table" | "typography" | "slot";
+type AlertDisplayEventType = "close" | "action";
+type ChipsDisplayEventType = "close" | "click";
+type DisplayEventType = AlertDisplayEventType | ChipsDisplayEventType;
+type DisplayEventConfig = {
+    steps: Step[];
+};
+type BaseDisplayNode = BaseNode & {
+    kind: "display";
+    conditions?: Condition[];
+};
+type TableTagVariant = "default" | "secondary" | "error" | "success" | "warning" | "info" | "magenta" | "cyan" | "blue" | "lime" | "purple" | "volcano";
+type TableTagValueMapping = {
+    label?: string;
+    variant?: TableTagVariant;
+};
+type TagDisplayProps = Record<string, unknown> & {
+    variant?: TableTagVariant | string;
+    size?: string;
+    rounded?: boolean;
+    borderLess?: boolean;
+    className?: string;
+    /**
+     * When `from` resolves to a value matching a key, override label/variant
+     * (same semantics as table tag columns).
+     */
+    map?: Record<string, TableTagValueMapping>;
+} & ({
+    label?: string | number;
+    from?: never;
+} | {
+    from: string;
+    label?: never;
+});
+type TagDisplayNode = Omit<BaseDisplayNode, "props"> & {
+    type: "tag";
+    props?: TagDisplayProps;
+    events?: never;
+};
+type AlertDisplayNode = BaseDisplayNode & {
+    type: "alert";
+    events?: Partial<Record<AlertDisplayEventType, DisplayEventConfig>>;
+};
+type ChipsDisplayNode = BaseDisplayNode & {
+    type: "chips";
+    events?: Partial<Record<ChipsDisplayEventType, DisplayEventConfig>>;
+};
+type SkeletonDisplayProps = Record<string, unknown> & {
+    className?: string;
+    ariaLabel?: string;
+};
+type SkeletonDisplayNode = Omit<BaseDisplayNode, "props"> & {
+    type: "skeleton";
+    props?: SkeletonDisplayProps;
+    events?: never;
+};
+type TypographyAs = "p" | "span" | "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "label" | "strong" | "em";
+type TypographyDisplayProps = Record<string, unknown> & {
+    as: TypographyAs;
+    className?: string;
+} & ({
+    content: string;
+    from?: never;
+} | {
+    from: string;
+    content?: never;
+}
+/** When `computed` is set on the node, props omit both content and from. */
+ | {
+    content?: never;
+    from?: never;
+});
+type TypographyDisplayNode = Omit<BaseDisplayNode, "props"> & {
+    type: "typography";
+    props: TypographyDisplayProps;
+    /**
+     * Presentation-only computed text source (XOR with `props.content` / `props.from`).
+     * Evaluated on read via `getTypographyText`; never writes form values.
+     */
+    computed?: ComputedConfig;
+    events?: never;
+};
+/**
+ * Host-filled presentation hole. Schema stores only a registry `name`;
+ * the React implementation is injected by the host (`FormRenderer` slots map).
+ * Never owns values, validation, or events.
+ */
+type SlotDisplayProps = Record<string, unknown> & {
+    /** Host registry key (same family as invoke `name`). */
+    name: string;
+    className?: string;
+};
+type SlotDisplayNode = Omit<BaseDisplayNode, "props"> & {
+    type: "slot";
+    props: SlotDisplayProps;
+    events?: never;
+};
+type TableTextColumn = {
+    id: string;
+    header: string;
+    kind?: "text";
+    path: string;
+};
+type TableTagColumn = {
+    id: string;
+    header: string;
+    kind: "tag";
+    path: string;
+    /**
+     * When the path value equals a key, use that entry for Tag label/variant.
+     * Keys are matched against the string form of the cell value.
+     */
+    map?: Record<string, TableTagValueMapping>;
+    variantPath?: string;
+    variant?: TableTagVariant;
+};
+type TableColumnActionColor = "primary" | "secondary" | "success" | "error" | "info" | "warning";
+type TableColumnAction = {
+    id: string;
+    label: string;
+    variant?: "fill" | "outlined" | "ghost" | "text";
+    color?: TableColumnActionColor;
+    iconOnly?: boolean;
+    steps: Step[];
+};
+type TableActionsColumn = {
+    id: string;
+    header: string;
+    kind: "actions";
+    actions: TableColumnAction[];
+};
+type TableColumn = TableTextColumn | TableTagColumn | TableActionsColumn;
+type TableStaticData = {
+    items: Record<string, unknown>[];
+};
+type TableSourceData = {
+    source: string;
+};
+type TableData = TableStaticData | TableSourceData;
+type TableAlign = "left" | "right" | "center";
+type TableDisplayProps = Record<string, unknown> & {
+    align?: TableAlign;
+    bordered?: boolean;
+    separated?: boolean;
+    caption?: string;
+    className?: string;
+};
+type TableDisplayEventType = "rowClick";
+type TableDisplayNode = Omit<BaseDisplayNode, "props"> & {
+    type: "table";
+    props?: TableDisplayProps;
+    columns: TableColumn[];
+    data: TableData;
+    events?: Partial<Record<TableDisplayEventType, DisplayEventConfig>>;
+};
+type DisplayNode = TagDisplayNode | AlertDisplayNode | ChipsDisplayNode | SkeletonDisplayNode | TableDisplayNode | TypographyDisplayNode | SlotDisplayNode;
+type TableInteraction = {
+    kind: "rowClick";
+    rowIndex: number;
+} | {
+    kind: "action";
+    columnId: string;
+    actionId: string;
+    rowIndex: number;
+};
+
+type Node = LayoutNode | FieldNode | ActionNode | DisplayNode;
+
+type LayoutType = "section" | "div" | "grid" | "row" | "scroll-area" | "pagination" | "badge" | "tooltip" | "popover" | "popover-trigger" | "popover-content" | "dropdown-menu" | "dropdown-menu-trigger" | "dropdown-menu-content" | "dropdown-menu-group" | "dropdown-menu-label" | "dropdown-menu-item" | "dropdown-menu-separator" | "dropdown-menu-sub" | "dropdown-menu-sub-trigger" | "dropdown-menu-sub-content" | "card" | "card-header" | "card-content" | "card-footer" | "tabs" | "accordion" | "accordion-item" | "stepper" | "step" | "dialog" | "dialog-header" | "dialog-body" | "dialog-footer" | "drawer" | "drawer-header" | "drawer-body" | "drawer-footer" | "repeat" | "form-ref";
+type StepperOrientation = "horizontal" | "vertical";
+type StepperConnector = "solid" | "dashed";
+type ScrollAreaType = "hover" | "scroll" | "auto" | "always";
+type ScrollAreaDirection = "ltr" | "rtl";
+type ScrollAreaLayoutProps = Record<string, unknown> & {
+    className?: string;
+    viewportClassName?: string;
+    type?: ScrollAreaType;
+    dir?: ScrollAreaDirection;
+    scrollHideDelay?: number;
+    ariaLabel?: string;
+};
+type PaginationLayoutProps = Record<string, unknown> & {
+    totalItems: number;
+    initialPage?: number;
+    pageSize?: number;
+    pageSizeOptions?: number[];
+    siblings?: number;
+    showPageSizeSelector?: boolean;
+    showPageInfo?: boolean;
+    rounded?: boolean;
+    className?: string;
+    ariaLabel?: string;
+};
+type BadgeType = "default" | "success" | "error" | "warning" | "process" | "proccess";
+type BadgeLayoutProps = Record<string, unknown> & {
+    content?: string | number;
+    show?: boolean;
+    type?: BadgeType;
+    offsetX?: number;
+    offsetY?: number;
+    className?: string;
+    ariaLabel?: string;
+};
+type TooltipSide = "top" | "right" | "bottom" | "left";
+type TooltipLayoutProps = Record<string, unknown> & {
+    content: string;
+    side?: TooltipSide;
+    sideOffset?: number;
+    delayDuration?: number;
+    defaultOpen?: boolean;
+    className?: string;
+};
+type PopoverSide = "top" | "right" | "bottom" | "left";
+type PopoverAlign = "start" | "center" | "end";
+type PopoverLayoutProps = Record<string, unknown> & {
+    defaultOpen?: boolean;
+    modal?: boolean;
+};
+type PopoverTriggerLayoutProps = Record<string, unknown> & {
+    className?: string;
+    ariaLabel?: string;
+};
+type PopoverContentLayoutProps = Record<string, unknown> & {
+    align?: PopoverAlign;
+    side?: PopoverSide;
+    sideOffset?: number;
+    alignOffset?: number;
+    className?: string;
+    ariaLabel?: string;
+};
+type DropdownMenuSide = "top" | "right" | "bottom" | "left";
+type DropdownMenuAlign = "start" | "center" | "end";
+type DropdownMenuItemVariant = "default" | "destructive";
+type DropdownMenuLayoutProps = Record<string, unknown> & {
+    defaultOpen?: boolean;
+    modal?: boolean;
+};
+type DropdownMenuTriggerLayoutProps = Record<string, unknown> & {
+    disabled?: boolean;
+    className?: string;
+    ariaLabel?: string;
+};
+type DropdownMenuContentLayoutProps = Record<string, unknown> & {
+    side?: DropdownMenuSide;
+    sideOffset?: number;
+    align?: DropdownMenuAlign;
+    alignOffset?: number;
+    collisionPadding?: number;
+    className?: string;
+    ariaLabel?: string;
+};
+type DropdownMenuGroupLayoutProps = Record<string, unknown> & {
+    className?: string;
+};
+type DropdownMenuLabelLayoutProps = Record<string, unknown> & {
+    label: string;
+    inset?: boolean;
+    className?: string;
+};
+type DropdownMenuItemLayoutProps = Record<string, unknown> & {
+    label: string;
+    shortcut?: string;
+    disabled?: boolean;
+    inset?: boolean;
+    variant?: DropdownMenuItemVariant;
+    className?: string;
+};
+type DropdownMenuSeparatorLayoutProps = Record<string, unknown> & {
+    className?: string;
+};
+type DropdownMenuSubLayoutProps = Record<string, unknown> & {
+    defaultOpen?: boolean;
+};
+type DropdownMenuSubTriggerLayoutProps = Record<string, unknown> & {
+    label: string;
+    disabled?: boolean;
+    inset?: boolean;
+    className?: string;
+};
+type DropdownMenuSubContentLayoutProps = Record<string, unknown> & {
+    sideOffset?: number;
+    className?: string;
+    ariaLabel?: string;
+};
+type CardLayoutProps = Record<string, unknown> & {
+    className?: string;
+    ariaLabel?: string;
+};
+type CardHeaderLayoutProps = Record<string, unknown> & {
+    className?: string;
+    divider?: boolean;
+};
+type CardContentLayoutProps = Record<string, unknown> & {
+    className?: string;
+};
+type CardFooterLayoutProps = Record<string, unknown> & {
+    className?: string;
+    divider?: boolean;
+};
+type StepperLayoutProps = Record<string, unknown> & {
+    initialStep?: string;
+    orientation?: StepperOrientation;
+    clickable?: boolean;
+    linear?: boolean;
+    dotStyle?: boolean;
+    connector?: StepperConnector;
+    className?: string;
+    contentClassName?: string;
+    ariaLabel?: string;
+};
+type StepLayoutProps = Record<string, unknown> & {
+    label: string;
+    caption?: string;
+    disabled?: boolean;
+    className?: string;
+    /** CSS classes for the step actions row (Previous / Next / Submit / …). */
+    actionsClassName?: string;
+};
+type AccordionItemLayoutProps = Record<string, unknown> & {
+    className?: string;
+    disabled?: boolean;
+} & ({
+    title?: string;
+    titleFrom?: never;
+} | {
+    titleFrom: string;
+    title?: never;
+});
+type DialogSize = "sm" | "md" | "lg" | "xl" | "full";
+type DialogOperation = "open" | "close";
+type DialogEventType = DialogOperation;
+type DialogLayoutProps = Record<string, unknown> & {
+    initialOpen?: boolean;
+    size?: DialogSize;
+    disableCloseOutside?: boolean;
+};
+type DialogHeaderLayoutProps = Record<string, unknown> & {
+    title: string;
+    hideClose?: boolean;
+};
+type DialogSlotLayoutProps = Record<string, unknown> & {
+    className?: string;
+};
+type DialogEventConfig = {
+    steps: Step[];
+};
+type PaginationEventType = "pageChange";
+type PaginationEventConfig = {
+    steps: Step[];
+};
+/** Tabs, accordion, and stepper share a post-navigation `change` event. */
+type NavigationEventType = "change";
+type NavigationEventConfig = {
+    steps: Step[];
+};
+type DialogStep = {
+    type: "dialog";
+    target: string;
+    operation: DialogOperation;
+};
+type DrawerSide = "top" | "bottom" | "left" | "right";
+type DrawerOperation = "open" | "close";
+type DrawerEventType = DrawerOperation;
+type DrawerLayoutProps = Record<string, unknown> & {
+    initialOpen?: boolean;
+    side?: DrawerSide;
+    disableCloseOutside?: boolean;
+};
+type DrawerHeaderLayoutProps = Record<string, unknown> & {
+    title: string;
+    hideClose?: boolean;
+};
+type DrawerSlotLayoutProps = Record<string, unknown> & {
+    className?: string;
+};
+type RepeatMode = "count" | "source" | "values";
+/** Max static repeat iterations (design + runtime) to avoid accidental explosion. */
+declare const REPEAT_MAX_COUNT = 50;
+type RepeatLayoutProps = Record<string, unknown> & {
+    /**
+     * `count` repeats the template N times; `source` maps over a scoped-path
+     * array; `values` is a form-owned field array at `path`.
+     */
+    mode: RepeatMode;
+    /** Used when `mode` is `count`. Integer 0…REPEAT_MAX_COUNT. */
+    count?: number;
+    /**
+     * Used when `mode` is `source`. Scoped path to an array
+     * (typically `resources.*`). Non-arrays resolve to an empty list.
+     */
+    source?: string;
+    /**
+     * Used when `mode` is `values`. Dotted path relative to the parent item
+     * (or form values for a top-level repeat). Segments are identifiers, never
+     * indexes. Runtime field paths are `{path}.{index}.{fieldName}`.
+     */
+    path?: string;
+    /** Inclusive lower bound for values-mode length. Defaults to 0. */
+    minItems?: number;
+    /** Inclusive upper bound for values-mode length. Defaults to REPEAT_MAX_COUNT. */
+    maxItems?: number;
+    className?: string;
+};
+type RepeatEventType = "add" | "remove" | "move";
+type RepeatEventConfig = {
+    steps: Step[];
+};
+type RepeatOperation = "add" | "remove" | "move" | "duplicate";
+type RepeatStep = {
+    type: "repeat";
+    target: string;
+    operation: RepeatOperation;
+    /** Scoped path whose value seeds `add` (object merge, or scalar into `field`). */
+    from?: string;
+    /** Template field name when `from` resolves to a scalar. */
+    field?: string;
+    /** Explicit item index for remove / move / duplicate. */
+    index?: number;
+    /** Destination index for `move`. */
+    to?: number;
+};
+type DrawerEventConfig = {
+    steps: Step[];
+};
+type DrawerStep = {
+    type: "drawer";
+    target: string;
+    operation: DrawerOperation;
+};
+type ToastVariant = "default" | "success" | "error" | "info" | "warning";
+type ToastPosition = "top-left" | "top-center" | "top-right" | "bottom-left" | "bottom-center" | "bottom-right";
+type ToastPresentation = {
+    variant?: ToastVariant;
+    position?: ToastPosition;
+    /** Display duration in milliseconds. */
+    duration?: number;
+};
+type ToastStep = ({
+    type: "toast";
+    message: string;
+} & ToastPresentation) | ({
+    type: "toast";
+    from: string;
+} & ToastPresentation);
+type InvokeStep = {
+    type: "invoke";
+    name: string;
+};
+type WhenStep = {
+    type: "when";
+    conditions: Condition[];
+    then: Step[];
+    else?: Step[];
+};
+type Step = {
+    type: "log";
+    message: string;
+} | {
+    type: "log";
+    from: string;
+} | ApiStep | {
+    type: "setValue";
+    field: string;
+    value: unknown;
+} | {
+    type: "setValue";
+    field: string;
+    from: string;
+} | {
+    type: "navigate";
+    to: string;
+} | DialogStep | DrawerStep | ToastStep | InvokeStep | WhenStep | RepeatStep;
+type ApiRequestBody = {
+    body?: unknown;
+    bodyFrom?: never;
+} | {
+    bodyFrom: string;
+    body?: never;
+};
+type ApiRequestQuery = {
+    query?: Record<string, unknown>;
+    queryFrom?: never;
+} | {
+    queryFrom: string;
+    query?: never;
+};
+type ApiStep = {
+    type: "api";
+    request: {
+        url: string;
+        method: "GET" | "POST" | "PUT" | "DELETE";
+        headers?: Record<string, string>;
+    } & ApiRequestBody & ApiRequestQuery;
+    response?: {
+        saveAs?: string;
+    };
+    /** Run after request/mapping failure, then the original error is rethrown. */
+    onError?: Step[];
+};
+type BaseLayoutNode = Omit<BaseNode, "kind" | "type"> & {
+    kind: "layout";
+    children: readonly Node[];
+    load?: {
+        steps: Step[];
+    };
+};
+type StandardLayoutNode = BaseLayoutNode & {
+    type: Exclude<LayoutType, "badge" | "tooltip" | "popover" | "popover-trigger" | "popover-content" | "dropdown-menu" | "dropdown-menu-trigger" | "dropdown-menu-content" | "dropdown-menu-group" | "dropdown-menu-label" | "dropdown-menu-item" | "dropdown-menu-separator" | "dropdown-menu-sub" | "dropdown-menu-sub-trigger" | "dropdown-menu-sub-content" | "card" | "card-header" | "card-content" | "card-footer" | "scroll-area" | "pagination" | "tabs" | "accordion" | "stepper" | "step" | "dialog" | "dialog-header" | "dialog-body" | "dialog-footer" | "drawer" | "drawer-header" | "drawer-body" | "drawer-footer" | "repeat" | "form-ref">;
+};
+type BadgeLayoutNode = Omit<BaseLayoutNode, "children" | "props"> & {
+    type: "badge";
+    props?: BadgeLayoutProps;
+    children: readonly [Node];
+};
+type TooltipLayoutNode = Omit<BaseLayoutNode, "children" | "props"> & {
+    type: "tooltip";
+    props: TooltipLayoutProps;
+    children: readonly [] | readonly [Node];
+};
+type PopoverLayoutNode = Omit<BaseLayoutNode, "children" | "props"> & {
+    type: "popover";
+    props?: PopoverLayoutProps;
+    children: readonly [PopoverTriggerLayoutNode, PopoverContentLayoutNode];
+};
+type PopoverTriggerLayoutNode = Omit<BaseLayoutNode, "children" | "props"> & {
+    type: "popover-trigger";
+    props?: PopoverTriggerLayoutProps;
+    children: readonly [Node];
+};
+type PopoverContentLayoutNode = Omit<BaseLayoutNode, "props"> & {
+    type: "popover-content";
+    props?: PopoverContentLayoutProps;
+};
+type PopoverSlotLayoutNode = PopoverTriggerLayoutNode | PopoverContentLayoutNode;
+type DropdownMenuLayoutNode = Omit<BaseLayoutNode, "children" | "props"> & {
+    type: "dropdown-menu";
+    props?: DropdownMenuLayoutProps;
+    children: readonly [
+        DropdownMenuTriggerLayoutNode,
+        DropdownMenuContentLayoutNode
+    ];
+};
+type DropdownMenuTriggerLayoutNode = Omit<BaseLayoutNode, "children" | "props"> & {
+    type: "dropdown-menu-trigger";
+    props?: DropdownMenuTriggerLayoutProps;
+    children: readonly [Node];
+};
+type DropdownMenuContentLayoutNode = Omit<BaseLayoutNode, "children" | "props"> & {
+    type: "dropdown-menu-content";
+    props?: DropdownMenuContentLayoutProps;
+    children: readonly DropdownMenuEntryLayoutNode[];
+};
+type DropdownMenuGroupLayoutNode = Omit<BaseLayoutNode, "children" | "props"> & {
+    type: "dropdown-menu-group";
+    props?: DropdownMenuGroupLayoutProps;
+    children: readonly DropdownMenuGroupEntryLayoutNode[];
+};
+type DropdownMenuLabelLayoutNode = Omit<BaseLayoutNode, "children" | "props"> & {
+    type: "dropdown-menu-label";
+    props: DropdownMenuLabelLayoutProps;
+    children: readonly [];
+};
+type DropdownMenuItemLayoutNode = Omit<BaseLayoutNode, "children" | "props"> & {
+    type: "dropdown-menu-item";
+    props: DropdownMenuItemLayoutProps;
+    children: readonly [Extract<Node, {
+        kind: "action";
+    }>];
+};
+type DropdownMenuSeparatorLayoutNode = Omit<BaseLayoutNode, "children" | "props"> & {
+    type: "dropdown-menu-separator";
+    props?: DropdownMenuSeparatorLayoutProps;
+    children: readonly [];
+};
+type DropdownMenuSubLayoutNode = Omit<BaseLayoutNode, "children" | "props"> & {
+    type: "dropdown-menu-sub";
+    props?: DropdownMenuSubLayoutProps;
+    children: readonly [
+        DropdownMenuSubTriggerLayoutNode,
+        DropdownMenuSubContentLayoutNode
+    ];
+};
+type DropdownMenuSubTriggerLayoutNode = Omit<BaseLayoutNode, "children" | "props"> & {
+    type: "dropdown-menu-sub-trigger";
+    props: DropdownMenuSubTriggerLayoutProps;
+    children: readonly [];
+};
+type DropdownMenuSubContentLayoutNode = Omit<BaseLayoutNode, "children" | "props"> & {
+    type: "dropdown-menu-sub-content";
+    props?: DropdownMenuSubContentLayoutProps;
+    children: readonly DropdownMenuEntryLayoutNode[];
+};
+type DropdownMenuGroupEntryLayoutNode = DropdownMenuLabelLayoutNode | DropdownMenuItemLayoutNode | DropdownMenuSeparatorLayoutNode | DropdownMenuSubLayoutNode;
+type DropdownMenuEntryLayoutNode = DropdownMenuGroupEntryLayoutNode | DropdownMenuGroupLayoutNode;
+type DropdownMenuSlotLayoutNode = DropdownMenuTriggerLayoutNode | DropdownMenuContentLayoutNode | DropdownMenuEntryLayoutNode | DropdownMenuSubTriggerLayoutNode | DropdownMenuSubContentLayoutNode;
+type ScrollAreaLayoutNode = Omit<BaseLayoutNode, "props"> & {
+    type: "scroll-area";
+    props?: ScrollAreaLayoutProps;
+};
+type PaginationLayoutNode = Omit<BaseLayoutNode, "children" | "props"> & {
+    type: "pagination";
+    props: PaginationLayoutProps;
+    children: readonly [];
+    events?: Partial<Record<PaginationEventType, PaginationEventConfig>>;
+};
+type TabsLayoutNode = BaseLayoutNode & {
+    type: "tabs";
+    events?: Partial<Record<NavigationEventType, NavigationEventConfig>>;
+};
+type AccordionLayoutNode = BaseLayoutNode & {
+    type: "accordion";
+    events?: Partial<Record<NavigationEventType, NavigationEventConfig>>;
+};
+type CardLayoutNode = Omit<BaseLayoutNode, "children" | "props"> & {
+    type: "card";
+    props?: CardLayoutProps;
+    children: readonly CardSlotLayoutNode[];
+};
+type CardHeaderLayoutNode = Omit<BaseLayoutNode, "props"> & {
+    type: "card-header";
+    props?: CardHeaderLayoutProps;
+};
+type CardContentLayoutNode = Omit<BaseLayoutNode, "props"> & {
+    type: "card-content";
+    props?: CardContentLayoutProps;
+};
+type CardFooterLayoutNode = Omit<BaseLayoutNode, "props"> & {
+    type: "card-footer";
+    props?: CardFooterLayoutProps;
+};
+type CardSlotLayoutNode = CardHeaderLayoutNode | CardContentLayoutNode | CardFooterLayoutNode;
+type StepperLayoutNode = Omit<BaseLayoutNode, "children" | "props"> & {
+    type: "stepper";
+    props?: StepperLayoutProps;
+    children: readonly StepLayoutNode[];
+    events?: Partial<Record<NavigationEventType, NavigationEventConfig>>;
+};
+type StepLayoutNode = Omit<BaseLayoutNode, "props"> & {
+    type: "step";
+    props: StepLayoutProps;
+    conditions?: Condition[];
+};
+type DialogLayoutNode = Omit<BaseLayoutNode, "children" | "props"> & {
+    type: "dialog";
+    /** Authoring label for targeting this dialog from Steps / custom actions. */
+    name?: string;
+    props?: DialogLayoutProps;
+    events?: Partial<Record<DialogEventType, DialogEventConfig>>;
+    children: readonly DialogSlotLayoutNode[];
+};
+type DialogHeaderLayoutNode = Omit<BaseLayoutNode, "props"> & {
+    type: "dialog-header";
+    props: DialogHeaderLayoutProps;
+};
+type DialogBodyLayoutNode = Omit<BaseLayoutNode, "props"> & {
+    type: "dialog-body";
+    props?: DialogSlotLayoutProps;
+};
+type DialogFooterLayoutNode = Omit<BaseLayoutNode, "props"> & {
+    type: "dialog-footer";
+    props?: DialogSlotLayoutProps;
+};
+type DialogSlotLayoutNode = DialogHeaderLayoutNode | DialogBodyLayoutNode | DialogFooterLayoutNode;
+type DrawerLayoutNode = Omit<BaseLayoutNode, "children" | "props"> & {
+    type: "drawer";
+    /** Authoring label for targeting this drawer from Steps / custom actions. */
+    name?: string;
+    props?: DrawerLayoutProps;
+    events?: Partial<Record<DrawerEventType, DrawerEventConfig>>;
+    children: readonly DrawerSlotLayoutNode[];
+};
+type DrawerHeaderLayoutNode = Omit<BaseLayoutNode, "props"> & {
+    type: "drawer-header";
+    props: DrawerHeaderLayoutProps;
+};
+type DrawerBodyLayoutNode = Omit<BaseLayoutNode, "props"> & {
+    type: "drawer-body";
+    props?: DrawerSlotLayoutProps;
+};
+type DrawerFooterLayoutNode = Omit<BaseLayoutNode, "props"> & {
+    type: "drawer-footer";
+    props?: DrawerSlotLayoutProps;
+};
+type DrawerSlotLayoutNode = DrawerHeaderLayoutNode | DrawerBodyLayoutNode | DrawerFooterLayoutNode;
+type RepeatLayoutNode = Omit<BaseLayoutNode, "props"> & {
+    type: "repeat";
+    props: RepeatLayoutProps;
+    events?: Partial<Record<RepeatEventType, RepeatEventConfig>>;
+};
+/**
+ * Reference to another FormSchema resolved by the host (e.g. from a DB).
+ * Renders as an isolated nested engine — never merges field names into the parent.
+ */
+type FormRefLayoutProps = Record<string, unknown> & {
+    /** Host / DB schema identifier. */
+    schemaId: string;
+    /** Namespace key for the parent values bag (e.g. `employee`). */
+    instanceKey: string;
+    className?: string;
+};
+type FormRefLayoutNode = Omit<BaseLayoutNode, "children" | "props"> & {
+    type: "form-ref";
+    props: FormRefLayoutProps;
+    children: readonly [];
+};
+type LayoutNode = StandardLayoutNode | BadgeLayoutNode | TooltipLayoutNode | PopoverLayoutNode | PopoverSlotLayoutNode | DropdownMenuLayoutNode | DropdownMenuSlotLayoutNode | ScrollAreaLayoutNode | PaginationLayoutNode | TabsLayoutNode | AccordionLayoutNode | CardLayoutNode | CardSlotLayoutNode | StepperLayoutNode | StepLayoutNode | DialogLayoutNode | DialogSlotLayoutNode | DrawerLayoutNode | DrawerSlotLayoutNode | RepeatLayoutNode | FormRefLayoutNode;
+
+type FormSchema = LayoutNode & {
+    id: string;
+    version: number;
+    name?: string;
+    metadata?: {
+        createdAt?: string;
+        updatedAt?: string;
+    };
+};
+type PropertyDefinition = {
+    key: string;
+    label: string;
+    editor: "text" | "number" | "switch" | "select";
+    options?: Record<string, unknown>[];
+};
+type RegistryItem = {
+    type: Node["type"];
+    kind: Node["kind"];
+    displayName: string;
+    defaultProps?: Record<string, unknown>;
+    propsDefinition?: PropertyDefinition[];
+    customEditor?: string;
+};
+type Registry = Map<string, RegistryItem>;
+
+/** Virtual condition fields that read FormEngine initialization / validity state. */
+declare const STATE_CONDITION_FIELDS: readonly ["$state.isLoading", "$state.isValid", "$state.initializationStatus"];
+type StateConditionField = (typeof STATE_CONDITION_FIELDS)[number];
+declare const STATE_IS_LOADING_VALUES: readonly [true, false];
+/** Boolean `$state.*` fields (`isLoading`, `isValid`). */
+declare const STATE_BOOLEAN_VALUES: readonly [true, false];
+declare const STATE_INITIALIZATION_STATUS_VALUES: readonly ["idle", "loading", "ready", "failed"];
+type StateInitializationStatusValue = (typeof STATE_INITIALIZATION_STATUS_VALUES)[number];
+/** Values accepted by component `props.loading` (boolean or loading binding). */
+declare const LOADING_PROP_BINDINGS: readonly ["$state.isLoading"];
+type FixedLoadingPropBinding = (typeof LOADING_PROP_BINDINGS)[number];
+type LoadingPropBinding = FixedLoadingPropBinding | `$pending.action.${string}` | `$pending.resource.${string}`;
+type LoadingPropValue = boolean | LoadingPropBinding;
+/** Prefix for per-action pending conditions: `$pending.action.<actionNodeId>`. */
+declare const PENDING_ACTION_CONDITION_PREFIX: "$pending.action.";
+/**
+ * Prefix for per-resource in-flight conditions:
+ * `$pending.resource.<relativePath>` (e.g. `$pending.resource.data`).
+ */
+declare const PENDING_RESOURCE_CONDITION_PREFIX: "$pending.resource.";
+declare const PENDING_BOOLEAN_VALUES: readonly [true, false];
+declare function isStateConditionField(field: string): field is StateConditionField;
+declare function isBooleanStateConditionField(field: string): field is "$state.isLoading" | "$state.isValid";
+declare function isPendingActionConditionField(field: string): boolean;
+declare function isPendingResourceConditionField(field: string): boolean;
+declare function isPendingConditionField(field: string): boolean;
+/** Reserved virtual condition fields (not form value keys). */
+declare function isReservedConditionField(field: string): boolean;
+declare function pendingActionIdFromField(field: string): string | undefined;
+declare function pendingResourcePathFromField(field: string): string | undefined;
+declare function pendingActionConditionField(actionId: string): string;
+declare function pendingResourceConditionField(relativePath: string): string;
+declare function isLoadingPropBinding(value: unknown): value is LoadingPropBinding;
+declare function defaultStateConditionValue(field: StateConditionField): boolean | "ready";
+declare function defaultPendingConditionValue(): boolean;
+declare function isValidStateConditionValue(field: StateConditionField, value: unknown): boolean;
+declare function isValidPendingConditionValue(value: unknown): value is boolean;
+
+export { type AccordionItemLayoutProps, type AccordionLayoutNode, type ActionNode, type ActionType, type AlertDisplayEventType, type AlertDisplayNode, type BadgeLayoutNode, type BadgeLayoutProps, type BadgeType, type BaseNode, type CardContentLayoutNode, type CardContentLayoutProps, type CardFooterLayoutNode, type CardFooterLayoutProps, type CardHeaderLayoutNode, type CardHeaderLayoutProps, type CardLayoutNode, type CardLayoutProps, type CardSlotLayoutNode, type ChipsDisplayEventType, type ChipsDisplayNode, type ComputedCondition, type ComputedConfig, type ComputedInput, type ComputedOperator, type Condition, type ConditionOperator, type CustomActionNode, type DialogBodyLayoutNode, type DialogEventConfig, type DialogEventType, type DialogFooterLayoutNode, type DialogHeaderLayoutNode, type DialogHeaderLayoutProps, type DialogLayoutNode, type DialogLayoutProps, type DialogOperation, type DialogSize, type DialogSlotLayoutNode, type DialogSlotLayoutProps, type DialogStep, type DisplayEventConfig, type DisplayEventType, type DisplayNode, type DisplayType, type DrawerBodyLayoutNode, type DrawerEventConfig, type DrawerEventType, type DrawerFooterLayoutNode, type DrawerHeaderLayoutNode, type DrawerHeaderLayoutProps, type DrawerLayoutNode, type DrawerLayoutProps, type DrawerOperation, type DrawerSide, type DrawerSlotLayoutNode, type DrawerSlotLayoutProps, type DrawerStep, type DropdownMenuAlign, type DropdownMenuContentLayoutNode, type DropdownMenuContentLayoutProps, type DropdownMenuEntryLayoutNode, type DropdownMenuGroupEntryLayoutNode, type DropdownMenuGroupLayoutNode, type DropdownMenuGroupLayoutProps, type DropdownMenuItemLayoutNode, type DropdownMenuItemLayoutProps, type DropdownMenuItemVariant, type DropdownMenuLabelLayoutNode, type DropdownMenuLabelLayoutProps, type DropdownMenuLayoutNode, type DropdownMenuLayoutProps, type DropdownMenuSeparatorLayoutNode, type DropdownMenuSeparatorLayoutProps, type DropdownMenuSide, type DropdownMenuSlotLayoutNode, type DropdownMenuSubContentLayoutNode, type DropdownMenuSubContentLayoutProps, type DropdownMenuSubLayoutNode, type DropdownMenuSubLayoutProps, type DropdownMenuSubTriggerLayoutNode, type DropdownMenuSubTriggerLayoutProps, type DropdownMenuTriggerLayoutNode, type DropdownMenuTriggerLayoutProps, FIELD_TYPES_WITH_CHANGE_EVENT, FIELD_TYPES_WITH_COMMIT_EVENT, type FieldCondition, type FieldEventConfig, type FieldEventType, type FieldNode, type FieldType, type FieldTypeWithChangeEvent, type FieldTypeWithCommitEvent, type FixedLoadingPropBinding, type FormRefLayoutNode, type FormRefLayoutProps, type FormSchema, type InvokeCondition, type InvokeStep, LOADING_PROP_BINDINGS, type LayoutNode, type LayoutType, type LoadingPropBinding, type LoadingPropValue, type NavigationEventConfig, type NavigationEventType, type Node, type NodeKind, type OptionsConfig, PENDING_ACTION_CONDITION_PREFIX, PENDING_BOOLEAN_VALUES, PENDING_RESOURCE_CONDITION_PREFIX, type PaginationEventConfig, type PaginationEventType, type PaginationLayoutNode, type PaginationLayoutProps, type PopoverAlign, type PopoverContentLayoutNode, type PopoverContentLayoutProps, type PopoverLayoutNode, type PopoverLayoutProps, type PopoverSide, type PopoverSlotLayoutNode, type PopoverTriggerLayoutNode, type PopoverTriggerLayoutProps, type PropertyDefinition, REPEAT_MAX_COUNT, type Registry, type RegistryItem, type RepeatEventConfig, type RepeatEventType, type RepeatLayoutNode, type RepeatLayoutProps, type RepeatMode, type RepeatOperation, type RepeatStep, type ResetActionNode, STATE_BOOLEAN_VALUES, STATE_CONDITION_FIELDS, STATE_INITIALIZATION_STATUS_VALUES, STATE_IS_LOADING_VALUES, type ScrollAreaDirection, type ScrollAreaLayoutNode, type ScrollAreaLayoutProps, type ScrollAreaType, type SegmentButtonFieldNode, type SegmentButtonFieldProps, type SegmentButtonOptionsConfig, type SegmentButtonSize, type SegmentButtonValue, type SelectMode, type SelectOptionValue, type SelectValue, type SkeletonDisplayNode, type SkeletonDisplayProps, type SliderMode, type SliderRangeValue, type SliderValue, type SlotDisplayNode, type SlotDisplayProps, type StandardLayoutNode, type StateConditionField, type StateInitializationStatusValue, type Step, type StepLayoutNode, type StepLayoutProps, type StepperActionNode, type StepperActionType, type StepperConnector, type StepperLayoutNode, type StepperLayoutProps, type StepperOrientation, type SubmitActionNode, type SubmitOrResetActionNode, type TableActionsColumn, type TableAlign, type TableColumn, type TableColumnAction, type TableColumnActionColor, type TableData, type TableDisplayEventType, type TableDisplayNode, type TableDisplayProps, type TableInteraction, type TableSourceData, type TableStaticData, type TableTagColumn, type TableTagValueMapping, type TableTagVariant, type TableTextColumn, type TabsLayoutNode, type TagDisplayNode, type TagDisplayProps, type TimeValue, type ToastPosition, type ToastStep, type ToastVariant, type TooltipLayoutNode, type TooltipLayoutProps, type TooltipSide, type TypographyAs, type TypographyDisplayNode, type TypographyDisplayProps, type ValidationRule, type WhenStep, defaultPendingConditionValue, defaultStateConditionValue, fieldAllowsBlurEvent, fieldAllowsChangeEvent, fieldAllowsCommitEvent, fieldAllowsEvent, isBooleanStateConditionField, isFieldCondition, isInvokeCondition, isLoadingPropBinding, isPendingActionConditionField, isPendingConditionField, isPendingResourceConditionField, isReservedConditionField, isStateConditionField, isValidPendingConditionValue, isValidStateConditionValue, isValuelessConditionOperator, pendingActionConditionField, pendingActionIdFromField, pendingResourceConditionField, pendingResourcePathFromField };