@kubuild/renderer 0.8.0 → 0.8.2

package/dist/artboard-portal-host.d.cts

@@ -0,0 +1,70 @@
+import React from 'react';
+import type { Artboard, Node } from '@kubuild/schema';
+import { type ComponentRegistry } from '@kubuild/components';
+import { RenderContext, Diagnostic } from './render-context.cjs';
+import { type ModalManager } from './action-runners/index.cjs';
+import { type KubuildRendererProps } from './renderer.cjs';
+import { type ResponsiveMode } from './styles.cjs';
+export interface ArtboardPortalHostProps {
+    /**
+     * Component artboards eligible for portal rendering. Defaults to
+     * `context.componentArtboards` when omitted.
+     */
+    artboards?: readonly Artboard[];
+    registry?: ComponentRegistry;
+    context?: RenderContext;
+    viewport?: 'desktop' | 'tablet' | 'mobile';
+    /** Same semantics and defaulting as `KubuildRenderer`'s `responsive` prop. */
+    responsive?: ResponsiveMode;
+    /**
+     * Editor mode renders nothing: while authoring, a component artboard is shown as its own
+     * canvas surface instead, which is precisely what keeps it from covering the page being
+     * edited. Portals exist only for runtime/preview.
+     */
+    mode?: 'editor' | 'runtime';
+    modalManager?: ModalManager;
+    /** Portal target; defaults to `document.body`. */
+    container?: Element | null;
+    onDiagnostic?: (diagnostic: Diagnostic) => void;
+    onActionDispatch?: (actionType: string, payload: Record<string, unknown> | undefined, nodeId: string) => void;
+}
+/**
+ * Returns the node a component artboard actually represents: its synthetic `page` root
+ * holds the detached subtree as its only child.
+ */
+export declare function getArtboardContentNode(artboard: Artboard): Node | undefined;
+/**
+ * Pick the component artboards that should currently be on screen, given ModalManager's
+ * state snapshot. Kept as a pure function so the open/closed decision is testable without
+ * a DOM, and so the portal component itself stays a thin shell around it.
+ */
+export declare function selectOpenComponentArtboards(artboards: readonly Artboard[], modalState: Record<string, boolean>): Artboard[];
+/**
+ * Renders every open component artboard into a portal.
+ *
+ * Detaching a modal/drawer into its own artboard means its content is no longer part of the
+ * page's own node tree, so at runtime something has to put it back on screen when a trigger
+ * fires. ModalManager is a plain string-keyed singleton, so a trigger in one artboard already
+ * addresses content in another with no extra wiring — this host just watches that state and
+ * renders whichever component artboards are currently open.
+ */
+export declare const ArtboardPortalHost: React.FC<ArtboardPortalHostProps>;
+export interface KubuildProjectRendererProps extends KubuildRendererProps {
+    /**
+     * Component artboards belonging to the same project as `document`. Their content is
+     * portal-rendered on top of the page whenever a trigger opens them (runtime only).
+     * Defaults to `context.componentArtboards`.
+     */
+    componentArtboards?: readonly Artboard[];
+    modalManager?: ModalManager;
+    portalContainer?: Element | null;
+}
+/**
+ * Renders one page artboard plus the portal host for its project's component artboards.
+ *
+ * Use this instead of KubuildRenderer wherever a published page must be able to open
+ * detached modals/drawers. Dependency direction stays one-way (this composes the renderer;
+ * the renderer knows nothing about projects), so single-document rendering is unaffected.
+ */
+export declare const KubuildProjectRenderer: React.FC<KubuildProjectRendererProps>;
+//# sourceMappingURL=artboard-portal-host.d.cts.map

package/dist/artboard-portal-host.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artboard-portal-host.d.cts","sourceRoot":"","sources":["../src/artboard-portal-host.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,KAAK,iBAAiB,EAAkC,MAAM,qBAAqB,CAAC;AAC7F,OAAO,EAAE,aAAa,EAA0B,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACxF,OAAO,EAA2B,KAAK,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACvF,OAAO,EAIL,KAAK,oBAAoB,EAC1B,MAAM,eAAe,CAAC;AACvB,OAAO,EAA8B,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAG9E,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;IAChC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,QAAQ,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC3C,8EAA8E;IAC9E,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B;;;;OAIG;IACH,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC5B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,kDAAkD;IAClD,SAAS,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3B,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;IAChD,gBAAgB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/G;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,GAAG,SAAS,CAI3E;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,SAAS,QAAQ,EAAE,EAC9B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,QAAQ,EAAE,CAQZ;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,EAAE,KAAK,CAAC,EAAE,CAAC,uBAAuB,CAuFhE,CAAC;AAEF,MAAM,WAAW,2BAA4B,SAAQ,oBAAoB;IACvE;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;IACzC,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,eAAe,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAClC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,EAAE,KAAK,CAAC,EAAE,CAAC,2BAA2B,CAuBxE,CAAC"}

package/dist/artboard-portal-host.d.ts

@@ -1,10 +1,10 @@
 import React from 'react';
 import type { Artboard, Node } from '@kubuild/schema';
 import { type ComponentRegistry } from '@kubuild/components';
-import { RenderContext, Diagnostic } from './render-context';
-import { type ModalManager } from './action-runners';
-import { type KubuildRendererProps } from './renderer';
-import { type ResponsiveMode } from './styles';
+import { RenderContext, Diagnostic } from './render-context.js';
+import { type ModalManager } from './action-runners/index.js';
+import { type KubuildRendererProps } from './renderer.js';
+import { type ResponsiveMode } from './styles.js';
 export interface ArtboardPortalHostProps {
     /**
      * Component artboards eligible for portal rendering. Defaults to

package/dist/artboard-portal-host.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"artboard-portal-host.d.ts","sourceRoot":"","sources":["../src/artboard-portal-host.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,KAAK,iBAAiB,EAAkC,MAAM,qBAAqB,CAAC;AAC7F,OAAO,EAAE,aAAa,EAA0B,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACrF,OAAO,EAA2B,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC9E,OAAO,EAIL,KAAK,oBAAoB,EAC1B,MAAM,YAAY,CAAC;AACpB,OAAO,EAA8B,KAAK,cAAc,EAAE,MAAM,UAAU,CAAC;AAG3E,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;IAChC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,QAAQ,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC3C,8EAA8E;IAC9E,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B;;;;OAIG;IACH,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC5B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,kDAAkD;IAClD,SAAS,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3B,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;IAChD,gBAAgB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/G;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,GAAG,SAAS,CAI3E;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,SAAS,QAAQ,EAAE,EAC9B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,QAAQ,EAAE,CAQZ;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,EAAE,KAAK,CAAC,EAAE,CAAC,uBAAuB,CAuFhE,CAAC;AAEF,MAAM,WAAW,2BAA4B,SAAQ,oBAAoB;IACvE;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;IACzC,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,eAAe,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAClC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,EAAE,KAAK,CAAC,EAAE,CAAC,2BAA2B,CAuBxE,CAAC"}
+{"version":3,"file":"artboard-portal-host.d.ts","sourceRoot":"","sources":["../src/artboard-portal-host.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,KAAK,iBAAiB,EAAkC,MAAM,qBAAqB,CAAC;AAC7F,OAAO,EAAE,aAAa,EAA0B,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACxF,OAAO,EAA2B,KAAK,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACvF,OAAO,EAIL,KAAK,oBAAoB,EAC1B,MAAM,eAAe,CAAC;AACvB,OAAO,EAA8B,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAG9E,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;IAChC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,QAAQ,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC3C,8EAA8E;IAC9E,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B;;;;OAIG;IACH,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC5B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,kDAAkD;IAClD,SAAS,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3B,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;IAChD,gBAAgB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/G;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,GAAG,SAAS,CAI3E;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,SAAS,QAAQ,EAAE,EAC9B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,QAAQ,EAAE,CAQZ;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,EAAE,KAAK,CAAC,EAAE,CAAC,uBAAuB,CAuFhE,CAAC;AAEF,MAAM,WAAW,2BAA4B,SAAQ,oBAAoB;IACvE;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;IACzC,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,eAAe,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAClC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,EAAE,KAAK,CAAC,EAAE,CAAC,2BAA2B,CAuBxE,CAAC"}

package/dist/code-generator.d.cts

@@ -0,0 +1,51 @@
+import { PageDocument, Node } from '@kubuild/schema';
+export interface GenerateHtmlOptions {
+    /**
+     * Whether to include internal node ID classes (`kb-node-{id}`).
+     * Defaults to true so generated CSS matches HTML elements.
+     */
+    includeNodeClasses?: boolean;
+    /**
+     * Indentation width in spaces. Defaults to 2.
+     */
+    indentSize?: number;
+    /**
+     * Root tag for the page container ('main' | 'div'). Defaults to 'main'.
+     */
+    rootTag?: 'main' | 'div';
+}
+export interface GenerateCssOptions {
+    /**
+     * Whether to include the baseline CSS reset. Defaults to true.
+     */
+    includeReset?: boolean;
+    /**
+     * Custom CSS class prefix for node selectors. Defaults to 'kb-node-'.
+     */
+    classPrefix?: string;
+}
+export interface StandaloneHtmlOptions {
+    htmlOptions?: GenerateHtmlOptions;
+    cssOptions?: GenerateCssOptions;
+    /** Custom language attribute for <html>. Defaults to 'en'. */
+    lang?: string;
+}
+/**
+ * Generates a clean, formatted semantic HTML string for a PageDocument or Node.
+ */
+export declare function generateSemanticHtml(docOrNode: PageDocument | Node, options?: GenerateHtmlOptions): string;
+/**
+ * Generates structured, readable CSS for the given document, compiling
+ * base styles, responsive breakpoints (desktop/tablet/mobile), and pseudo-classes.
+ *
+ * Breakpoint layers use the shared `BREAKPOINTS` ranges from `@kubuild/schema` and the same
+ * per-layer overrides as the runtime renderer's `responsive: 'css'` mode
+ * (`collectResponsiveCssRules`), so exported HTML lays out identically at every width.
+ */
+export declare function generateDocumentCss(docOrNode: PageDocument | Node, options?: GenerateCssOptions): string;
+/**
+ * Generates a complete, standalone, production-ready HTML document string
+ * with metadata, responsive viewport tags, embedded stylesheet, and semantic body markup.
+ */
+export declare function generateStandaloneHtml(doc: PageDocument, options?: StandaloneHtmlOptions): string;
+//# sourceMappingURL=code-generator.d.cts.map

package/dist/code-generator.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-generator.d.cts","sourceRoot":"","sources":["../src/code-generator.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,IAAI,EAKL,MAAM,iBAAiB,CAAC;AAUzB,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AA4ZD;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,YAAY,GAAG,IAAI,EAC9B,OAAO,GAAE,mBAAwB,GAChC,MAAM,CAIR;AAuBD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,YAAY,GAAG,IAAI,EAC9B,OAAO,GAAE,kBAAuB,GAC/B,MAAM,CAoFR;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,YAAY,EACjB,OAAO,GAAE,qBAA0B,GAClC,MAAM,CA0BR"}

package/dist/error-boundary.d.cts

@@ -0,0 +1,22 @@
+import { Component, ErrorInfo, ReactNode } from 'react';
+import type { Diagnostic } from './render-context.cjs';
+export interface ComponentErrorBoundaryProps {
+    nodeId: string;
+    componentType: string;
+    mode?: 'editor' | 'runtime';
+    children: ReactNode;
+    onError?: (error: Error, info: ErrorInfo) => void;
+    onDiagnostic?: (diagnostic: Diagnostic) => void;
+}
+interface ComponentErrorBoundaryState {
+    hasError: boolean;
+    error?: Error;
+}
+export declare class ComponentErrorBoundary extends Component<ComponentErrorBoundaryProps, ComponentErrorBoundaryState> {
+    constructor(props: ComponentErrorBoundaryProps);
+    static getDerivedStateFromError(error: Error): ComponentErrorBoundaryState;
+    componentDidCatch(error: Error, errorInfo: ErrorInfo): void;
+    render(): ReactNode;
+}
+export {};
+//# sourceMappingURL=error-boundary.d.cts.map

package/dist/error-boundary.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-boundary.d.cts","sourceRoot":"","sources":["../src/error-boundary.tsx"],"names":[],"mappings":"AAAA,OAAc,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAE/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC5B,QAAQ,EAAE,SAAS,CAAC;IACpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;IAClD,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;CACjD;AAED,UAAU,2BAA2B;IACnC,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,qBAAa,sBAAuB,SAAQ,SAAS,CACnD,2BAA2B,EAC3B,2BAA2B,CAC5B;gBACa,KAAK,EAAE,2BAA2B;IAK9C,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,KAAK,GAAG,2BAA2B;IAI1E,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI;IAe3D,MAAM,IAAI,SAAS;CA8CpB"}

package/dist/error-boundary.d.ts

@@ -1,5 +1,5 @@
 import { Component, ErrorInfo, ReactNode } from 'react';
-import type { Diagnostic } from './render-context';
+import type { Diagnostic } from './render-context.js';
 export interface ComponentErrorBoundaryProps {
     nodeId: string;
     componentType: string;

package/dist/error-boundary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-boundary.d.ts","sourceRoot":"","sources":["../src/error-boundary.tsx"],"names":[],"mappings":"AAAA,OAAc,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAE/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC5B,QAAQ,EAAE,SAAS,CAAC;IACpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;IAClD,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;CACjD;AAED,UAAU,2BAA2B;IACnC,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,qBAAa,sBAAuB,SAAQ,SAAS,CACnD,2BAA2B,EAC3B,2BAA2B,CAC5B;gBACa,KAAK,EAAE,2BAA2B;IAK9C,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,KAAK,GAAG,2BAA2B;IAI1E,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI;IAe3D,MAAM,IAAI,SAAS;CA8CpB"}
+{"version":3,"file":"error-boundary.d.ts","sourceRoot":"","sources":["../src/error-boundary.tsx"],"names":[],"mappings":"AAAA,OAAc,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAE/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC5B,QAAQ,EAAE,SAAS,CAAC;IACpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;IAClD,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;CACjD;AAED,UAAU,2BAA2B;IACnC,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,qBAAa,sBAAuB,SAAQ,SAAS,CACnD,2BAA2B,EAC3B,2BAA2B,CAC5B;gBACa,KAAK,EAAE,2BAA2B;IAK9C,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,KAAK,GAAG,2BAA2B;IAI1E,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI;IAe3D,MAAM,IAAI,SAAS;CA8CpB"}

package/dist/form-context.d.cts

@@ -0,0 +1,114 @@
+import React from 'react';
+import type { FormConfig, FormFieldBinding, ActionPipeline, PageDocument, ValidationRule, ValidateOnEvent } from '@kubuild/schema';
+import { type Diagnostic } from '@kubuild/core';
+/**
+ * Form Runtime State representation.
+ */
+export interface FormRuntimeState {
+    values: Record<string, unknown>;
+    errors: Record<string, string>;
+    touched: Record<string, boolean>;
+    isSubmitting: boolean;
+    isValid: boolean;
+    dirty: boolean;
+}
+/**
+ * Partial / input structure for registering a field binding.
+ */
+export interface FormFieldBindingInput {
+    name: string;
+    label?: string;
+    defaultValue?: unknown;
+    rules?: ValidationRule[];
+    validateOn?: ValidateOnEvent;
+    transform?: 'trim' | 'lowercase' | 'uppercase' | 'number';
+    disabled?: boolean;
+    required?: boolean;
+}
+/**
+ * Form Runtime Context Value containing state and mutation callbacks.
+ */
+export interface FormRuntimeContextValue extends FormRuntimeState {
+    formId: string;
+    formConfig?: FormConfig;
+    initialValues: Record<string, unknown>;
+    setFieldValue: (name: string, value: unknown, shouldValidate?: boolean) => void;
+    setFieldTouched: (name: string, isTouched?: boolean, shouldValidate?: boolean) => void;
+    setFieldError: (name: string, error: string | null) => void;
+    setErrors: (errors: Record<string, string>) => void;
+    setValues: (values: Record<string, unknown>, replace?: boolean) => void;
+    setSubmitting: (isSubmitting: boolean) => void;
+    resetForm: (nextInitialValues?: Record<string, unknown>) => void;
+    validateField: (name: string, value?: unknown) => string | null;
+    validateForm: (valuesToValidate?: Record<string, unknown>) => Record<string, string>;
+    handleFormSubmit: (e?: React.FormEvent | Event) => Promise<boolean>;
+    registerField: (binding: FormFieldBindingInput) => () => void;
+    getFieldBinding: (name: string) => FormFieldBinding | undefined;
+}
+/**
+ * FormRuntimeContext for consuming form state across the React tree.
+ */
+export declare const FormRuntimeContext: React.Context<FormRuntimeContextValue | null>;
+/**
+ * Props for FormRuntimeProvider.
+ */
+export interface FormRuntimeProviderProps {
+    formId?: string;
+    formConfig?: FormConfig;
+    initialValues?: Record<string, unknown>;
+    onSubmit?: (values: Record<string, unknown>, helpers: {
+        formId: string;
+        setSubmitting: (isSubmitting: boolean) => void;
+        resetForm: (nextInitialValues?: Record<string, unknown>) => void;
+        setErrors: (errors: Record<string, string>) => void;
+    }) => Promise<void> | void;
+    onSuccess?: (values: Record<string, unknown>) => void;
+    onError?: (errors: Record<string, string>) => void;
+    actions?: ActionPipeline[];
+    nodeId?: string;
+    document?: PageDocument;
+    onDiagnostic?: (diagnostic: Diagnostic) => void;
+    children: React.ReactNode;
+}
+/**
+ * FormRuntimeProvider manages local reactive form state, field validation,
+ * submission handling, and action pipeline execution.
+ */
+export declare const FormRuntimeProvider: React.FC<FormRuntimeProviderProps>;
+/**
+ * Hook to access the current FormRuntimeContext.
+ * Returns null if invoked outside of a FormRuntimeProvider.
+ */
+export declare function useFormRuntime(): FormRuntimeContextValue | null;
+/**
+ * Hook to access the current FormRuntimeContext (alias for useFormRuntime).
+ */
+export declare function useFormContext(): FormRuntimeContextValue | null;
+/**
+ * Hook providing status properties of the nearest form context.
+ */
+export declare function useFormStatus(): {
+    isSubmitting: boolean;
+    isValid: boolean;
+    dirty: boolean;
+    errors: Record<string, string>;
+};
+/**
+ * Result returned by the `useFormField` hook.
+ */
+export interface UseFormFieldReturn<T = unknown> {
+    value: T;
+    error?: string;
+    touched: boolean;
+    isInvalid: boolean;
+    setValue: (value: T, shouldValidate?: boolean) => void;
+    setTouched: (touched?: boolean, shouldValidate?: boolean) => void;
+    setError: (error: string | null) => void;
+    onChange: (e: React.ChangeEvent<HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement> | T) => void;
+    onBlur: (e?: React.FocusEvent<HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement>) => void;
+}
+/**
+ * Hook to bind a field component to the nearest FormRuntimeContext.
+ */
+export declare function useFormField<T = unknown>(name: string, binding?: FormFieldBindingInput): UseFormFieldReturn<T>;
+//# sourceMappingURL=form-context.d.cts.map

package/dist/form-context.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-context.d.cts","sourceRoot":"","sources":["../src/form-context.tsx"],"names":[],"mappings":"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"}