@bsm-form/react-renderer 0.39.0

package/dist/index.d.cts

@@ -0,0 +1,311 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as _bsm_form_core from '@bsm-form/core';
+import { RuntimeNode, FormEngineEnvironment, FormEngine, PaginationChangeResult } from '@bsm-form/core';
+import { FormSchema, PopoverAlign, PopoverSide, DropdownMenuItemVariant, DropdownMenuSide, DropdownMenuAlign, StepperConnector, StepperOrientation, DialogSize, DrawerSide, Node } from '@bsm-form/schema';
+import * as react from 'react';
+import { ReactNode, HTMLAttributes, ComponentType } from 'react';
+
+type RenderWrapper = (props: {
+    node: RuntimeNode;
+    children: React.ReactNode;
+}) => React.ReactNode;
+
+type Props$8 = {
+    node: RuntimeNode;
+    wrapper?: RenderWrapper;
+};
+declare function LayoutRenderer({ node }: Props$8): react_jsx_runtime.JSX.Element | null;
+
+type Props$7 = {
+    node: RuntimeNode;
+};
+declare function FieldRenderer({ node }: Props$7): react_jsx_runtime.JSX.Element | null;
+
+type Props$6 = {
+    node: RuntimeNode;
+};
+declare function ActionRenderer({ node }: Props$6): react_jsx_runtime.JSX.Element | null;
+
+type InvokeCatalogEntry = {
+    name: string;
+    label: string;
+};
+
+/** Read-only snapshot passed to a host slot renderer. */
+type SlotRenderContext = {
+    values: Record<string, unknown>;
+    resources: Record<string, unknown>;
+};
+/** Host-provided React content for a schema slot `name`. */
+type SlotRenderer = (ctx: SlotRenderContext) => ReactNode;
+type SlotCatalogEntry = {
+    name: string;
+    label: string;
+};
+type FormSlots = Record<string, SlotRenderer>;
+
+/** Host map of DB/schema id → FormSchema for nested `form-ref` nodes. */
+type FormRefRegistry = Record<string, FormSchema>;
+/**
+ * Live snapshot of one embedded form engine.
+ * Mirrored to every parent/sibling engine under `resources.embeds.{instanceKey}`.
+ */
+type EmbeddedFormSnapshot = {
+    values: Record<string, unknown>;
+    resources: Record<string, unknown>;
+};
+/**
+ * Parent-owned bag of embedded snapshots, keyed by `form-ref` `instanceKey`.
+ * Field names stay local to each nested engine; this bag never flattens them.
+ */
+type EmbeddedFormBag = Record<string, EmbeddedFormSnapshot>;
+/** @deprecated Prefer EmbeddedFormBag — kept as alias for values-only maps. */
+type EmbeddedFormValuesBag = Record<string, Record<string, unknown>>;
+type EmbeddedSnapshotChangeHandler = (instanceKey: string, snapshot: EmbeddedFormSnapshot) => void;
+/** @deprecated Prefer EmbeddedSnapshotChangeHandler. */
+type EmbeddedValuesChangeHandler = (instanceKey: string, values: Record<string, unknown>) => void;
+/** Resource root used for cross-form reads: `resources.embeds.<instanceKey>.*`. */
+declare const EMBEDS_RESOURCE_ROOT = "embeds";
+/**
+ * Compose parent field values with namespaced embedded values for submit/save.
+ * Instance keys overwrite same-named parent keys intentionally — authors should
+ * keep instance keys distinct from parent field names.
+ */
+declare function aggregateEmbeddedFormValues(parentValues: Record<string, unknown>, embeddedBag: EmbeddedFormBag | EmbeddedFormValuesBag): Record<string, unknown>;
+/** Full submit payload: parent values + per-instance values/resources. */
+declare function aggregateEmbeddedFormPayload(parentValues: Record<string, unknown>, parentResources: Record<string, unknown>, embeddedBag: EmbeddedFormBag): {
+    values: Record<string, unknown>;
+    resources: Record<string, unknown>;
+    embeds: EmbeddedFormBag;
+};
+/** Immutable bag update helper for host / FormRenderer state. */
+declare function setEmbeddedFormSnapshot(bag: EmbeddedFormBag, instanceKey: string, snapshot: EmbeddedFormSnapshot): EmbeddedFormBag;
+/** @deprecated Prefer setEmbeddedFormSnapshot. */
+declare function setEmbeddedFormValues(bag: EmbeddedFormValuesBag, instanceKey: string, values: Record<string, unknown>): EmbeddedFormValuesBag;
+/** Drop the mirrored embeds mirror so reporting it does not feedback-loop. */
+declare function resourcesWithoutEmbeds(resources: Record<string, unknown>): Record<string, unknown>;
+declare function snapshotFromEngine(parts: {
+    values: Record<string, unknown>;
+    resources: Record<string, unknown>;
+}): EmbeddedFormSnapshot;
+
+type Props$5 = {
+    tree: FormSchema;
+    renderWrapper?: RenderWrapper;
+    designMode?: boolean;
+    environment?: Partial<FormEngineEnvironment>;
+    invokeCatalog?: readonly InvokeCatalogEntry[];
+    /** Host React content keyed by slot `props.name`. */
+    slots?: FormSlots;
+    /** Optional Builder/Select labels for slot names. */
+    slotCatalog?: readonly SlotCatalogEntry[];
+    /** Host map of schemaId → FormSchema for `form-ref` nodes. */
+    forms?: FormRefRegistry;
+    /** Reports nested form values under each form-ref `instanceKey`. */
+    onEmbeddedValuesChange?: EmbeddedValuesChangeHandler;
+    /** Reports nested form values+resources under each form-ref `instanceKey`. */
+    onEmbeddedSnapshotChange?: EmbeddedSnapshotChangeHandler;
+    /** Reports this form's values (root or nested host). */
+    onValuesChange?: (values: Record<string, unknown>) => void;
+    /** Skip the root Sonner toaster (nested embeds should pass true). */
+    suppressToaster?: boolean;
+};
+declare function FormRenderer({ tree, renderWrapper, designMode, environment, invokeCatalog, slots, slotCatalog, forms, onEmbeddedValuesChange, onEmbeddedSnapshotChange, onValuesChange, suppressToaster, }: Props$5): react_jsx_runtime.JSX.Element;
+
+type Props$4 = {
+    node: RuntimeNode;
+};
+declare function NodeRenderer({ node }: Props$4): ReactNode;
+
+type Props$3 = {
+    node: RuntimeNode;
+};
+declare function DisplayRenderer({ node }: Props$3): react_jsx_runtime.JSX.Element | null;
+
+declare const ALERT_TYPES: readonly ["success", "error", "warning", "info", "default"];
+declare const ALERT_VARIANTS: readonly ["filled", "outline"];
+type AlertType = (typeof ALERT_TYPES)[number];
+type AlertVariant = (typeof ALERT_VARIANTS)[number];
+type AlertDisplayProps = Record<string, unknown>;
+declare function AlertDisplay({ type, variant, title, children, className, withIcon, closable, actionText, onClose, onAction, }: AlertDisplayProps): react_jsx_runtime.JSX.Element | null;
+declare function normalizeAlertType(value: unknown): AlertType;
+declare function normalizeAlertVariant(value: unknown): AlertVariant;
+declare function normalizeAlertText(value: unknown): string | undefined;
+
+declare const CHIPS_VARIANTS: readonly ["default", "secondary"];
+type ChipsVariant = (typeof CHIPS_VARIANTS)[number];
+type ChipsDisplayProps = Record<string, unknown>;
+declare function ChipsDisplay({ label, className, variant, rounded, disabled, onClose, onClick, }: ChipsDisplayProps): react_jsx_runtime.JSX.Element | null;
+declare function normalizeChipsLabel(value: unknown): string | undefined;
+declare function normalizeChipsVariant(value: unknown): ChipsVariant;
+
+type SkeletonDisplayProps = Record<string, unknown>;
+declare function SkeletonDisplay({ ariaLabel, className, }: SkeletonDisplayProps): react_jsx_runtime.JSX.Element;
+declare function normalizeSkeletonAriaLabel(value: unknown): string | undefined;
+declare function normalizeSkeletonClassName(value: unknown): string | undefined;
+
+type Props$2 = {
+    className?: string;
+    children?: React.ReactNode;
+    designPlaceholder?: string;
+};
+/** Host slot mount point — children come from the host registry, not schema. */
+declare function SlotDisplay({ className, children, designPlaceholder, }: Props$2): react_jsx_runtime.JSX.Element | null;
+
+type Props$1 = {
+    node: RuntimeNode;
+};
+/**
+ * Nested form host: one isolated FormEngine per referenced schema.
+ *
+ * Publishes `{ values, resources }` into the parent embed bag under
+ * `instanceKey`, and mirrors the full bag to `resources.embeds` so siblings
+ * and the parent can read live cross-form data without merging schemas.
+ */
+declare function FormRefRenderer({ node }: Props$1): react_jsx_runtime.JSX.Element | null;
+
+declare const TriggerBridge: react.ForwardRefExoticComponent<HTMLAttributes<HTMLSpanElement> & {
+    activateWhenNonInteractive?: boolean;
+    disabled?: boolean;
+} & react.RefAttributes<HTMLSpanElement>>;
+
+type Props = {
+    node: RuntimeNode;
+};
+declare function TooltipRenderer({ node }: Props): react_jsx_runtime.JSX.Element | null;
+
+declare function PopoverRenderer({ node }: {
+    node: RuntimeNode;
+}): react_jsx_runtime.JSX.Element | null;
+declare function buildPopoverRootProps(props: unknown): {
+    defaultOpen: boolean;
+    modal: boolean;
+};
+declare function normalizePopoverDefaultOpen(value: unknown): value is true;
+declare function normalizePopoverModal(value: unknown): value is true;
+
+declare function PopoverSlotRenderer({ node }: {
+    node: RuntimeNode;
+}): react_jsx_runtime.JSX.Element | null;
+declare function buildPopoverContentProps(props: unknown): {
+    align: PopoverAlign;
+    side: PopoverSide;
+    sideOffset: number;
+    alignOffset: number;
+    className: string | undefined;
+    "aria-label": string | undefined;
+};
+declare function normalizePopoverAlign(value: unknown): PopoverAlign;
+declare function normalizePopoverSide(value: unknown): PopoverSide;
+declare function normalizePopoverSideOffset(value: unknown): number;
+declare function normalizePopoverAlignOffset(value: unknown): number;
+declare function normalizePopoverClassName(value: unknown): string | undefined;
+declare function normalizePopoverAriaLabel(value: unknown): string | undefined;
+
+declare function DropdownMenuRenderer({ node }: {
+    node: RuntimeNode;
+}): react_jsx_runtime.JSX.Element | null;
+declare function buildDropdownMenuRootProps(props: unknown): {
+    defaultOpen: boolean;
+    modal: boolean;
+};
+declare function normalizeDropdownMenuDefaultOpen(value: unknown): value is true;
+declare function normalizeDropdownMenuModal(value: unknown): boolean;
+
+declare function DropdownMenuSlotRenderer({ node }: {
+    node: RuntimeNode;
+}): react_jsx_runtime.JSX.Element | null;
+type DropdownMenuItemViewProps = {
+    id: string;
+    label: string;
+    shortcut?: string;
+    disabled: boolean;
+    inset: boolean;
+    variant: DropdownMenuItemVariant;
+    className?: string;
+    onSelect: () => void;
+};
+declare function DropdownMenuItemView({ id, label, shortcut, disabled, inset, variant, className, onSelect, }: DropdownMenuItemViewProps): react_jsx_runtime.JSX.Element;
+declare function buildDropdownMenuContentProps(props: unknown): {
+    side: DropdownMenuSide;
+    sideOffset: number;
+    align: DropdownMenuAlign;
+    alignOffset: number;
+    collisionPadding: number;
+    className: string | undefined;
+    "aria-label": string | undefined;
+};
+declare function normalizeDropdownMenuSide(value: unknown): DropdownMenuSide;
+declare function normalizeDropdownMenuAlign(value: unknown): DropdownMenuAlign;
+declare function normalizeDropdownMenuSideOffset(value: unknown): number;
+declare function normalizeDropdownMenuAlignOffset(value: unknown): number;
+declare function normalizeDropdownMenuCollisionPadding(value: unknown): number;
+declare function normalizeDropdownMenuItemVariant(value: unknown): DropdownMenuItemVariant;
+declare function normalizeDropdownMenuBoolean(value: unknown): value is true;
+declare function normalizeDropdownMenuClassName(value: unknown): string | undefined;
+declare function normalizeDropdownMenuAriaLabel(value: unknown): string | undefined;
+declare function normalizeDropdownMenuText(value: unknown): string;
+declare function normalizeDropdownMenuOptionalText(value: unknown): string | undefined;
+
+declare function PaginationRenderer({ node }: {
+    node: RuntimeNode;
+}): react_jsx_runtime.JSX.Element | null;
+declare function normalizePageSizeOptions(value: unknown): number[];
+declare function normalizePositiveInteger(value: unknown, fallback: number): number;
+declare function normalizeNonNegativeInteger(value: unknown, fallback: number): number;
+
+declare function executeRendererPaginationChange(engine: FormEngine, paginationId: string, page: number, pageSize: number, designMode: boolean): Promise<PaginationChangeResult> | undefined;
+
+declare function StepperRenderer({ node }: {
+    node: RuntimeNode;
+}): react_jsx_runtime.JSX.Element | null;
+declare function normalizeStepperOrientation(value: unknown): StepperOrientation;
+declare function normalizeStepperConnector(value: unknown): StepperConnector;
+
+declare function StepRenderer({ node }: {
+    node: RuntimeNode;
+}): react_jsx_runtime.JSX.Element | null;
+declare function normalizeStepLabel(value: unknown): string;
+
+declare function executeRendererStepperNavigation(engine: FormEngine, stepperId: string, stepId: string, designMode: boolean): Promise<_bsm_form_core.StepperNavigationResult> | undefined;
+
+declare function DialogRenderer({ node }: {
+    node: RuntimeNode;
+}): react_jsx_runtime.JSX.Element | null;
+declare function normalizeDialogSize(value: unknown): DialogSize;
+
+declare function DialogSlotRenderer({ node }: {
+    node: RuntimeNode;
+}): react_jsx_runtime.JSX.Element | null;
+declare function normalizeDialogTitle(value: unknown): string;
+
+declare function executeRendererDialogChange(engine: FormEngine, dialogId: string, open: boolean, designMode: boolean): Promise<_bsm_form_core.DialogTransitionResult> | undefined;
+
+declare function DrawerRenderer({ node }: {
+    node: RuntimeNode;
+}): react_jsx_runtime.JSX.Element | null;
+declare function normalizeDrawerSide(value: unknown): DrawerSide;
+
+declare function DrawerSlotRenderer({ node }: {
+    node: RuntimeNode;
+}): react_jsx_runtime.JSX.Element | null;
+declare function normalizeDrawerTitle(value: unknown): string;
+
+declare function executeRendererDrawerChange(engine: FormEngine, drawerId: string, open: boolean, designMode: boolean): Promise<_bsm_form_core.DrawerTransitionResult> | undefined;
+
+type ReactFieldRegistryItem = {
+    type: Node["type"];
+    component: ComponentType<any>;
+};
+type ReactRegistry = Map<string, ReactFieldRegistryItem>;
+
+declare function FormProvider({ engine, children, }: {
+    engine: FormEngine;
+    children: ReactNode;
+}): react_jsx_runtime.JSX.Element;
+
+declare const FormContext: react.Context<FormEngine | null>;
+declare function useFormContext(): FormEngine;
+declare function useOptionalFormContext(): FormEngine | null;
+
+export { ActionRenderer, AlertDisplay, ChipsDisplay, DialogRenderer, DialogSlotRenderer, DisplayRenderer, DrawerRenderer, DrawerSlotRenderer, DropdownMenuItemView, DropdownMenuRenderer, DropdownMenuSlotRenderer, EMBEDS_RESOURCE_ROOT, type EmbeddedFormBag, type EmbeddedFormSnapshot, type EmbeddedFormValuesBag, type EmbeddedSnapshotChangeHandler, type EmbeddedValuesChangeHandler, FieldRenderer, FormContext, FormProvider, type FormRefRegistry, FormRefRenderer, FormRenderer, type FormSlots, type InvokeCatalogEntry, LayoutRenderer, NodeRenderer, PaginationRenderer, PopoverRenderer, PopoverSlotRenderer, type ReactFieldRegistryItem, type ReactRegistry, SkeletonDisplay, type SlotCatalogEntry, SlotDisplay, type SlotRenderContext, type SlotRenderer, StepRenderer, StepperRenderer, TooltipRenderer, TriggerBridge as TooltipTriggerBridge, aggregateEmbeddedFormPayload, aggregateEmbeddedFormValues, buildDropdownMenuContentProps, buildDropdownMenuRootProps, buildPopoverContentProps, buildPopoverRootProps, executeRendererDialogChange, executeRendererDrawerChange, executeRendererPaginationChange, executeRendererStepperNavigation, normalizeAlertText, normalizeAlertType, normalizeAlertVariant, normalizeChipsLabel, normalizeChipsVariant, normalizeDialogSize, normalizeDialogTitle, normalizeDrawerSide, normalizeDrawerTitle, normalizeDropdownMenuAlign, normalizeDropdownMenuAlignOffset, normalizeDropdownMenuAriaLabel, normalizeDropdownMenuBoolean, normalizeDropdownMenuClassName, normalizeDropdownMenuCollisionPadding, normalizeDropdownMenuDefaultOpen, normalizeDropdownMenuItemVariant, normalizeDropdownMenuModal, normalizeDropdownMenuOptionalText, normalizeDropdownMenuSide, normalizeDropdownMenuSideOffset, normalizeDropdownMenuText, normalizeNonNegativeInteger, normalizePageSizeOptions, normalizePopoverAlign, normalizePopoverAlignOffset, normalizePopoverAriaLabel, normalizePopoverClassName, normalizePopoverDefaultOpen, normalizePopoverModal, normalizePopoverSide, normalizePopoverSideOffset, normalizePositiveInteger, normalizeSkeletonAriaLabel, normalizeSkeletonClassName, normalizeStepLabel, normalizeStepperConnector, normalizeStepperOrientation, resourcesWithoutEmbeds, setEmbeddedFormSnapshot, setEmbeddedFormValues, snapshotFromEngine, useFormContext, useOptionalFormContext };

package/dist/index.d.ts

@@ -0,0 +1,311 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as _bsm_form_core from '@bsm-form/core';
+import { RuntimeNode, FormEngineEnvironment, FormEngine, PaginationChangeResult } from '@bsm-form/core';
+import { FormSchema, PopoverAlign, PopoverSide, DropdownMenuItemVariant, DropdownMenuSide, DropdownMenuAlign, StepperConnector, StepperOrientation, DialogSize, DrawerSide, Node } from '@bsm-form/schema';
+import * as react from 'react';
+import { ReactNode, HTMLAttributes, ComponentType } from 'react';
+
+type RenderWrapper = (props: {
+    node: RuntimeNode;
+    children: React.ReactNode;
+}) => React.ReactNode;
+
+type Props$8 = {
+    node: RuntimeNode;
+    wrapper?: RenderWrapper;
+};
+declare function LayoutRenderer({ node }: Props$8): react_jsx_runtime.JSX.Element | null;
+
+type Props$7 = {
+    node: RuntimeNode;
+};
+declare function FieldRenderer({ node }: Props$7): react_jsx_runtime.JSX.Element | null;
+
+type Props$6 = {
+    node: RuntimeNode;
+};
+declare function ActionRenderer({ node }: Props$6): react_jsx_runtime.JSX.Element | null;
+
+type InvokeCatalogEntry = {
+    name: string;
+    label: string;
+};
+
+/** Read-only snapshot passed to a host slot renderer. */
+type SlotRenderContext = {
+    values: Record<string, unknown>;
+    resources: Record<string, unknown>;
+};
+/** Host-provided React content for a schema slot `name`. */
+type SlotRenderer = (ctx: SlotRenderContext) => ReactNode;
+type SlotCatalogEntry = {
+    name: string;
+    label: string;
+};
+type FormSlots = Record<string, SlotRenderer>;
+
+/** Host map of DB/schema id → FormSchema for nested `form-ref` nodes. */
+type FormRefRegistry = Record<string, FormSchema>;
+/**
+ * Live snapshot of one embedded form engine.
+ * Mirrored to every parent/sibling engine under `resources.embeds.{instanceKey}`.
+ */
+type EmbeddedFormSnapshot = {
+    values: Record<string, unknown>;
+    resources: Record<string, unknown>;
+};
+/**
+ * Parent-owned bag of embedded snapshots, keyed by `form-ref` `instanceKey`.
+ * Field names stay local to each nested engine; this bag never flattens them.
+ */
+type EmbeddedFormBag = Record<string, EmbeddedFormSnapshot>;
+/** @deprecated Prefer EmbeddedFormBag — kept as alias for values-only maps. */
+type EmbeddedFormValuesBag = Record<string, Record<string, unknown>>;
+type EmbeddedSnapshotChangeHandler = (instanceKey: string, snapshot: EmbeddedFormSnapshot) => void;
+/** @deprecated Prefer EmbeddedSnapshotChangeHandler. */
+type EmbeddedValuesChangeHandler = (instanceKey: string, values: Record<string, unknown>) => void;
+/** Resource root used for cross-form reads: `resources.embeds.<instanceKey>.*`. */
+declare const EMBEDS_RESOURCE_ROOT = "embeds";
+/**
+ * Compose parent field values with namespaced embedded values for submit/save.
+ * Instance keys overwrite same-named parent keys intentionally — authors should
+ * keep instance keys distinct from parent field names.
+ */
+declare function aggregateEmbeddedFormValues(parentValues: Record<string, unknown>, embeddedBag: EmbeddedFormBag | EmbeddedFormValuesBag): Record<string, unknown>;
+/** Full submit payload: parent values + per-instance values/resources. */
+declare function aggregateEmbeddedFormPayload(parentValues: Record<string, unknown>, parentResources: Record<string, unknown>, embeddedBag: EmbeddedFormBag): {
+    values: Record<string, unknown>;
+    resources: Record<string, unknown>;
+    embeds: EmbeddedFormBag;
+};
+/** Immutable bag update helper for host / FormRenderer state. */
+declare function setEmbeddedFormSnapshot(bag: EmbeddedFormBag, instanceKey: string, snapshot: EmbeddedFormSnapshot): EmbeddedFormBag;
+/** @deprecated Prefer setEmbeddedFormSnapshot. */
+declare function setEmbeddedFormValues(bag: EmbeddedFormValuesBag, instanceKey: string, values: Record<string, unknown>): EmbeddedFormValuesBag;
+/** Drop the mirrored embeds mirror so reporting it does not feedback-loop. */
+declare function resourcesWithoutEmbeds(resources: Record<string, unknown>): Record<string, unknown>;
+declare function snapshotFromEngine(parts: {
+    values: Record<string, unknown>;
+    resources: Record<string, unknown>;
+}): EmbeddedFormSnapshot;
+
+type Props$5 = {
+    tree: FormSchema;
+    renderWrapper?: RenderWrapper;
+    designMode?: boolean;
+    environment?: Partial<FormEngineEnvironment>;
+    invokeCatalog?: readonly InvokeCatalogEntry[];
+    /** Host React content keyed by slot `props.name`. */
+    slots?: FormSlots;
+    /** Optional Builder/Select labels for slot names. */
+    slotCatalog?: readonly SlotCatalogEntry[];
+    /** Host map of schemaId → FormSchema for `form-ref` nodes. */
+    forms?: FormRefRegistry;
+    /** Reports nested form values under each form-ref `instanceKey`. */
+    onEmbeddedValuesChange?: EmbeddedValuesChangeHandler;
+    /** Reports nested form values+resources under each form-ref `instanceKey`. */
+    onEmbeddedSnapshotChange?: EmbeddedSnapshotChangeHandler;
+    /** Reports this form's values (root or nested host). */
+    onValuesChange?: (values: Record<string, unknown>) => void;
+    /** Skip the root Sonner toaster (nested embeds should pass true). */
+    suppressToaster?: boolean;
+};
+declare function FormRenderer({ tree, renderWrapper, designMode, environment, invokeCatalog, slots, slotCatalog, forms, onEmbeddedValuesChange, onEmbeddedSnapshotChange, onValuesChange, suppressToaster, }: Props$5): react_jsx_runtime.JSX.Element;
+
+type Props$4 = {
+    node: RuntimeNode;
+};
+declare function NodeRenderer({ node }: Props$4): ReactNode;
+
+type Props$3 = {
+    node: RuntimeNode;
+};
+declare function DisplayRenderer({ node }: Props$3): react_jsx_runtime.JSX.Element | null;
+
+declare const ALERT_TYPES: readonly ["success", "error", "warning", "info", "default"];
+declare const ALERT_VARIANTS: readonly ["filled", "outline"];
+type AlertType = (typeof ALERT_TYPES)[number];
+type AlertVariant = (typeof ALERT_VARIANTS)[number];
+type AlertDisplayProps = Record<string, unknown>;
+declare function AlertDisplay({ type, variant, title, children, className, withIcon, closable, actionText, onClose, onAction, }: AlertDisplayProps): react_jsx_runtime.JSX.Element | null;
+declare function normalizeAlertType(value: unknown): AlertType;
+declare function normalizeAlertVariant(value: unknown): AlertVariant;
+declare function normalizeAlertText(value: unknown): string | undefined;
+
+declare const CHIPS_VARIANTS: readonly ["default", "secondary"];
+type ChipsVariant = (typeof CHIPS_VARIANTS)[number];
+type ChipsDisplayProps = Record<string, unknown>;
+declare function ChipsDisplay({ label, className, variant, rounded, disabled, onClose, onClick, }: ChipsDisplayProps): react_jsx_runtime.JSX.Element | null;
+declare function normalizeChipsLabel(value: unknown): string | undefined;
+declare function normalizeChipsVariant(value: unknown): ChipsVariant;
+
+type SkeletonDisplayProps = Record<string, unknown>;
+declare function SkeletonDisplay({ ariaLabel, className, }: SkeletonDisplayProps): react_jsx_runtime.JSX.Element;
+declare function normalizeSkeletonAriaLabel(value: unknown): string | undefined;
+declare function normalizeSkeletonClassName(value: unknown): string | undefined;
+
+type Props$2 = {
+    className?: string;
+    children?: React.ReactNode;
+    designPlaceholder?: string;
+};
+/** Host slot mount point — children come from the host registry, not schema. */
+declare function SlotDisplay({ className, children, designPlaceholder, }: Props$2): react_jsx_runtime.JSX.Element | null;
+
+type Props$1 = {
+    node: RuntimeNode;
+};
+/**
+ * Nested form host: one isolated FormEngine per referenced schema.
+ *
+ * Publishes `{ values, resources }` into the parent embed bag under
+ * `instanceKey`, and mirrors the full bag to `resources.embeds` so siblings
+ * and the parent can read live cross-form data without merging schemas.
+ */
+declare function FormRefRenderer({ node }: Props$1): react_jsx_runtime.JSX.Element | null;
+
+declare const TriggerBridge: react.ForwardRefExoticComponent<HTMLAttributes<HTMLSpanElement> & {
+    activateWhenNonInteractive?: boolean;
+    disabled?: boolean;
+} & react.RefAttributes<HTMLSpanElement>>;
+
+type Props = {
+    node: RuntimeNode;
+};
+declare function TooltipRenderer({ node }: Props): react_jsx_runtime.JSX.Element | null;
+
+declare function PopoverRenderer({ node }: {
+    node: RuntimeNode;
+}): react_jsx_runtime.JSX.Element | null;
+declare function buildPopoverRootProps(props: unknown): {
+    defaultOpen: boolean;
+    modal: boolean;
+};
+declare function normalizePopoverDefaultOpen(value: unknown): value is true;
+declare function normalizePopoverModal(value: unknown): value is true;
+
+declare function PopoverSlotRenderer({ node }: {
+    node: RuntimeNode;
+}): react_jsx_runtime.JSX.Element | null;
+declare function buildPopoverContentProps(props: unknown): {
+    align: PopoverAlign;
+    side: PopoverSide;
+    sideOffset: number;
+    alignOffset: number;
+    className: string | undefined;
+    "aria-label": string | undefined;
+};
+declare function normalizePopoverAlign(value: unknown): PopoverAlign;
+declare function normalizePopoverSide(value: unknown): PopoverSide;
+declare function normalizePopoverSideOffset(value: unknown): number;
+declare function normalizePopoverAlignOffset(value: unknown): number;
+declare function normalizePopoverClassName(value: unknown): string | undefined;
+declare function normalizePopoverAriaLabel(value: unknown): string | undefined;
+
+declare function DropdownMenuRenderer({ node }: {
+    node: RuntimeNode;
+}): react_jsx_runtime.JSX.Element | null;
+declare function buildDropdownMenuRootProps(props: unknown): {
+    defaultOpen: boolean;
+    modal: boolean;
+};
+declare function normalizeDropdownMenuDefaultOpen(value: unknown): value is true;
+declare function normalizeDropdownMenuModal(value: unknown): boolean;
+
+declare function DropdownMenuSlotRenderer({ node }: {
+    node: RuntimeNode;
+}): react_jsx_runtime.JSX.Element | null;
+type DropdownMenuItemViewProps = {
+    id: string;
+    label: string;
+    shortcut?: string;
+    disabled: boolean;
+    inset: boolean;
+    variant: DropdownMenuItemVariant;
+    className?: string;
+    onSelect: () => void;
+};
+declare function DropdownMenuItemView({ id, label, shortcut, disabled, inset, variant, className, onSelect, }: DropdownMenuItemViewProps): react_jsx_runtime.JSX.Element;
+declare function buildDropdownMenuContentProps(props: unknown): {
+    side: DropdownMenuSide;
+    sideOffset: number;
+    align: DropdownMenuAlign;
+    alignOffset: number;
+    collisionPadding: number;
+    className: string | undefined;
+    "aria-label": string | undefined;
+};
+declare function normalizeDropdownMenuSide(value: unknown): DropdownMenuSide;
+declare function normalizeDropdownMenuAlign(value: unknown): DropdownMenuAlign;
+declare function normalizeDropdownMenuSideOffset(value: unknown): number;
+declare function normalizeDropdownMenuAlignOffset(value: unknown): number;
+declare function normalizeDropdownMenuCollisionPadding(value: unknown): number;
+declare function normalizeDropdownMenuItemVariant(value: unknown): DropdownMenuItemVariant;
+declare function normalizeDropdownMenuBoolean(value: unknown): value is true;
+declare function normalizeDropdownMenuClassName(value: unknown): string | undefined;
+declare function normalizeDropdownMenuAriaLabel(value: unknown): string | undefined;
+declare function normalizeDropdownMenuText(value: unknown): string;
+declare function normalizeDropdownMenuOptionalText(value: unknown): string | undefined;
+
+declare function PaginationRenderer({ node }: {
+    node: RuntimeNode;
+}): react_jsx_runtime.JSX.Element | null;
+declare function normalizePageSizeOptions(value: unknown): number[];
+declare function normalizePositiveInteger(value: unknown, fallback: number): number;
+declare function normalizeNonNegativeInteger(value: unknown, fallback: number): number;
+
+declare function executeRendererPaginationChange(engine: FormEngine, paginationId: string, page: number, pageSize: number, designMode: boolean): Promise<PaginationChangeResult> | undefined;
+
+declare function StepperRenderer({ node }: {
+    node: RuntimeNode;
+}): react_jsx_runtime.JSX.Element | null;
+declare function normalizeStepperOrientation(value: unknown): StepperOrientation;
+declare function normalizeStepperConnector(value: unknown): StepperConnector;
+
+declare function StepRenderer({ node }: {
+    node: RuntimeNode;
+}): react_jsx_runtime.JSX.Element | null;
+declare function normalizeStepLabel(value: unknown): string;
+
+declare function executeRendererStepperNavigation(engine: FormEngine, stepperId: string, stepId: string, designMode: boolean): Promise<_bsm_form_core.StepperNavigationResult> | undefined;
+
+declare function DialogRenderer({ node }: {
+    node: RuntimeNode;
+}): react_jsx_runtime.JSX.Element | null;
+declare function normalizeDialogSize(value: unknown): DialogSize;
+
+declare function DialogSlotRenderer({ node }: {
+    node: RuntimeNode;
+}): react_jsx_runtime.JSX.Element | null;
+declare function normalizeDialogTitle(value: unknown): string;
+
+declare function executeRendererDialogChange(engine: FormEngine, dialogId: string, open: boolean, designMode: boolean): Promise<_bsm_form_core.DialogTransitionResult> | undefined;
+
+declare function DrawerRenderer({ node }: {
+    node: RuntimeNode;
+}): react_jsx_runtime.JSX.Element | null;
+declare function normalizeDrawerSide(value: unknown): DrawerSide;
+
+declare function DrawerSlotRenderer({ node }: {
+    node: RuntimeNode;
+}): react_jsx_runtime.JSX.Element | null;
+declare function normalizeDrawerTitle(value: unknown): string;
+
+declare function executeRendererDrawerChange(engine: FormEngine, drawerId: string, open: boolean, designMode: boolean): Promise<_bsm_form_core.DrawerTransitionResult> | undefined;
+
+type ReactFieldRegistryItem = {
+    type: Node["type"];
+    component: ComponentType<any>;
+};
+type ReactRegistry = Map<string, ReactFieldRegistryItem>;
+
+declare function FormProvider({ engine, children, }: {
+    engine: FormEngine;
+    children: ReactNode;
+}): react_jsx_runtime.JSX.Element;
+
+declare const FormContext: react.Context<FormEngine | null>;
+declare function useFormContext(): FormEngine;
+declare function useOptionalFormContext(): FormEngine | null;
+
+export { ActionRenderer, AlertDisplay, ChipsDisplay, DialogRenderer, DialogSlotRenderer, DisplayRenderer, DrawerRenderer, DrawerSlotRenderer, DropdownMenuItemView, DropdownMenuRenderer, DropdownMenuSlotRenderer, EMBEDS_RESOURCE_ROOT, type EmbeddedFormBag, type EmbeddedFormSnapshot, type EmbeddedFormValuesBag, type EmbeddedSnapshotChangeHandler, type EmbeddedValuesChangeHandler, FieldRenderer, FormContext, FormProvider, type FormRefRegistry, FormRefRenderer, FormRenderer, type FormSlots, type InvokeCatalogEntry, LayoutRenderer, NodeRenderer, PaginationRenderer, PopoverRenderer, PopoverSlotRenderer, type ReactFieldRegistryItem, type ReactRegistry, SkeletonDisplay, type SlotCatalogEntry, SlotDisplay, type SlotRenderContext, type SlotRenderer, StepRenderer, StepperRenderer, TooltipRenderer, TriggerBridge as TooltipTriggerBridge, aggregateEmbeddedFormPayload, aggregateEmbeddedFormValues, buildDropdownMenuContentProps, buildDropdownMenuRootProps, buildPopoverContentProps, buildPopoverRootProps, executeRendererDialogChange, executeRendererDrawerChange, executeRendererPaginationChange, executeRendererStepperNavigation, normalizeAlertText, normalizeAlertType, normalizeAlertVariant, normalizeChipsLabel, normalizeChipsVariant, normalizeDialogSize, normalizeDialogTitle, normalizeDrawerSide, normalizeDrawerTitle, normalizeDropdownMenuAlign, normalizeDropdownMenuAlignOffset, normalizeDropdownMenuAriaLabel, normalizeDropdownMenuBoolean, normalizeDropdownMenuClassName, normalizeDropdownMenuCollisionPadding, normalizeDropdownMenuDefaultOpen, normalizeDropdownMenuItemVariant, normalizeDropdownMenuModal, normalizeDropdownMenuOptionalText, normalizeDropdownMenuSide, normalizeDropdownMenuSideOffset, normalizeDropdownMenuText, normalizeNonNegativeInteger, normalizePageSizeOptions, normalizePopoverAlign, normalizePopoverAlignOffset, normalizePopoverAriaLabel, normalizePopoverClassName, normalizePopoverDefaultOpen, normalizePopoverModal, normalizePopoverSide, normalizePopoverSideOffset, normalizePositiveInteger, normalizeSkeletonAriaLabel, normalizeSkeletonClassName, normalizeStepLabel, normalizeStepperConnector, normalizeStepperOrientation, resourcesWithoutEmbeds, setEmbeddedFormSnapshot, setEmbeddedFormValues, snapshotFromEngine, useFormContext, useOptionalFormContext };