@kubuild/renderer 0.0.1 → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 kustora
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,105 @@
+# @kubuild/renderer
+
+[![npm version](https://img.shields.io/npm/v/@kubuild/renderer.svg)](https://www.npmjs.com/package/@kubuild/renderer)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.7-blue)](https://www.typescriptlang.org/)
+
+Pure recursive React renderer for **KUBUILD** page documents with Action Dispatcher, built-in action runners (API requests, modals, toasts, navigation), form runtime context, and CSS style compiler.
+
+---
+
+## 📦 Installation
+
+```bash
+# Using pnpm (recommended)
+pnpm add @kubuild/renderer @kubuild/components @kubuild/core @kubuild/schema react react-dom
+
+# Using npm
+npm install @kubuild/renderer @kubuild/components @kubuild/core @kubuild/schema react react-dom
+
+# Using yarn
+yarn add @kubuild/renderer @kubuild/components @kubuild/core @kubuild/schema react react-dom
+```
+
+---
+
+## ✨ Features
+
+- **Pure Recursive React Renderer**: High-performance `<Renderer />` component that walks the document node tree recursively and renders React elements.
+- **Action Dispatcher & Built-in Action Runners**:
+  - `apiRequest`: Performs HTTP requests with URL parameters, headers, method, body interpolation, and success/error branching.
+  - `showToast`: Renders toast notifications (success, error, warning, info) via `ToastContainer`.
+  - `openModal` / `closeModal`: Triggers modal dialogs with focus trap and backdrop handlers.
+  - `navigate`: Client-side or browser redirects with URL interpolation.
+  - `custom`: Extensible hooks for application-specific action handlers.
+- **Form Runtime Context**: `FormRuntimeProvider` and `useFormRuntime` for state management, field binding, live validation, and submission handling.
+- **Dynamic CSS & Animations**: Computes responsive styles across breakpoints (desktop, tablet, mobile), hover/focus pseudo-states, and keyframe animations.
+- **Security & XSS Defense**: Sanitizes dangerous `javascript:`, `data:text/html` URLs and prevents CSS injection.
+- **Code Generator**: Compiles KUBUILD document trees into production-ready standalone React JSX and Tailwind CSS code.
+
+---
+
+## 🚀 Quick Usage
+
+### Rendering a Page Document
+
+```tsx
+import React from 'react';
+import { Renderer } from '@kubuild/renderer';
+import type { PageDocument } from '@kubuild/schema';
+
+interface PageViewerProps {
+  document: PageDocument;
+}
+
+export const PageViewer: React.FC<PageViewerProps> = ({ document }) => {
+  return (
+    <div className="page-container">
+      <Renderer
+        document={document}
+        onAction={(action, context) => {
+          console.log('Action triggered:', action.name, context);
+        }}
+      />
+    </div>
+  );
+};
+```
+
+### Rendering with Toast Feedback & Action Dispatcher
+
+```tsx
+import React from 'react';
+import { Renderer, ToastContainer } from '@kubuild/renderer';
+import type { PageDocument } from '@kubuild/schema';
+
+export const InteractiveApp: React.FC<{ doc: PageDocument }> = ({ doc }) => {
+  return (
+    <>
+      <Renderer document={doc} />
+      {/* Toast container renders feedback notifications triggered by actions */}
+      <ToastContainer position="top-right" />
+    </>
+  );
+};
+```
+
+### Generating Standalone React Code
+
+```typescript
+import { generateReactCode } from '@kubuild/renderer';
+import type { PageDocument } from '@kubuild/schema';
+
+const tsxCode: string = generateReactCode(pageDocument.document, {
+  framework: 'react',
+  styling: 'tailwind'
+});
+
+console.log(tsxCode);
+```
+
+---
+
+## 📄 License
+
+MIT © [KUBUILD](https://github.com/kustora/kubuild)

package/dist/action-dispatcher.d.ts

@@ -0,0 +1,42 @@
+import type { PageDocument, Node, ActionTriggerType } from '@kubuild/schema';
+import { ActionPipelineExecutor, type Diagnostic } from '@kubuild/core';
+import type { RenderContext } from './render-context';
+import type { FormRuntimeContextValue } from './form-context';
+/**
+ * Options for executing node action pipelines.
+ */
+export interface ExecuteNodeActionsOptions {
+    node: Node;
+    trigger: ActionTriggerType | string;
+    document?: PageDocument;
+    context?: RenderContext;
+    formContext?: FormRuntimeContextValue | null;
+    extraContext?: Record<string, unknown>;
+    onDiagnostic?: (diagnostic: Diagnostic) => void;
+    onActionDispatch?: (actionType: string, payload: Record<string, unknown> | undefined, nodeId: string) => void;
+    executor?: ActionPipelineExecutor;
+}
+/**
+ * Execution outcome from executeNodeActions.
+ */
+export interface NodeActionExecutionOutcome {
+    executed: boolean;
+    success: boolean;
+    error?: unknown;
+}
+/**
+ * Executes all action pipelines defined on a node that match a specific trigger.
+ */
+export declare function executeNodeActions(options: ExecuteNodeActionsOptions): Promise<NodeActionExecutionOutcome>;
+/**
+ * Hook to execute `load` lifecycle action pipelines on component mount.
+ */
+export declare function useNodeLoadActions(node: Node, options: {
+    document?: PageDocument;
+    context?: RenderContext;
+    formContext?: FormRuntimeContextValue | null;
+    onDiagnostic?: (diagnostic: Diagnostic) => void;
+    onActionDispatch?: (actionType: string, payload: Record<string, unknown> | undefined, nodeId: string) => void;
+    mode?: 'editor' | 'runtime';
+}): void;
+//# sourceMappingURL=action-dispatcher.d.ts.map

package/dist/action-dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-dispatcher.d.ts","sourceRoot":"","sources":["../src/action-dispatcher.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,iBAAiB,EAAkB,MAAM,iBAAiB,CAAC;AAC7F,OAAO,EAAE,sBAAsB,EAAE,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAG9D;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,IAAI,CAAC;IACX,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAAC;IACpC,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,WAAW,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAC7C,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;IAChD,gBAAgB,CAAC,EAAE,CACjB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC5C,MAAM,EAAE,MAAM,KACX,IAAI,CAAC;IACV,QAAQ,CAAC,EAAE,sBAAsB,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,0BAA0B,CAAC,CA6ErC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE;IACP,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,WAAW,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAC7C,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;IAChD,gBAAgB,CAAC,EAAE,CACjB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC5C,MAAM,EAAE,MAAM,KACX,IAAI,CAAC;IACV,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;CAC7B,GACA,IAAI,CA2CN"}

package/dist/action-runners/api-request.d.ts

@@ -0,0 +1,77 @@
+import { type PipelineStepHandler } from '@kubuild/core';
+/**
+ * Standard API Request Response representation.
+ */
+export interface ApiRequestResponse<T = unknown> {
+    ok: boolean;
+    status: number;
+    statusText: string;
+    headers: Record<string, string>;
+    data: T;
+    body: T;
+    url: string;
+}
+/**
+ * Details passed to ApiRequestError.
+ */
+export interface ApiRequestErrorDetails {
+    status?: number;
+    statusText?: string;
+    url?: string;
+    method?: string;
+    data?: unknown;
+    headers?: Record<string, string>;
+    response?: ApiRequestResponse;
+    isTimeout?: boolean;
+    isCancelled?: boolean;
+    isNetworkError?: boolean;
+    stepId?: string;
+    cause?: unknown;
+}
+/**
+ * Custom Error thrown when an API request fails, times out, or returns a non-2xx status code.
+ */
+export declare class ApiRequestError extends Error {
+    readonly status?: number;
+    readonly statusText?: string;
+    readonly url?: string;
+    readonly method?: string;
+    readonly data?: unknown;
+    readonly headers?: Record<string, string>;
+    readonly response?: ApiRequestResponse;
+    readonly isTimeout: boolean;
+    readonly isCancelled: boolean;
+    readonly isNetworkError: boolean;
+    readonly stepId?: string;
+    readonly cause?: unknown;
+    constructor(message: string, details?: ApiRequestErrorDetails);
+}
+/**
+ * Options for configuring API Request Action Runner.
+ */
+export interface ApiRequestRunnerOptions {
+    fetchFn?: typeof fetch;
+    defaultTimeout?: number;
+    baseUrl?: string;
+    headers?: Record<string, string>;
+}
+/**
+ * Builds and validates the final API request URL with query parameters.
+ */
+export declare function buildApiUrl(rawUrl: string, queryParams?: Record<string, unknown>, baseUrl?: string): string;
+/**
+ * Prepares the request body and normalizes headers based on body payload and body format.
+ */
+export declare function prepareRequestBody(method: string, body: unknown, bodyFormat?: string, headers?: Record<string, string>): {
+    body: BodyInit | undefined;
+    headers: Record<string, string>;
+};
+/**
+ * Creates an API Request Step Handler configured with custom options or default settings.
+ */
+export declare function createApiRequestHandler(options?: ApiRequestRunnerOptions): PipelineStepHandler;
+/**
+ * Default built-in API Request Runner instance.
+ */
+export declare const apiRequestRunner: PipelineStepHandler;
+//# sourceMappingURL=api-request.d.ts.map

package/dist/action-runners/api-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-request.d.ts","sourceRoot":"","sources":["../../src/action-runners/api-request.ts"],"names":[],"mappings":"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"}

package/dist/action-runners/index.d.ts

@@ -0,0 +1,24 @@
+import type { ActionPipelineExecutor, PipelineStepHandler } from '@kubuild/core';
+import { type ApiRequestRunnerOptions } from './api-request';
+export * from './api-request';
+export * from './toast-manager';
+export * from './toast-container';
+export * from './modal-manager';
+export * from './ui-feedback';
+export * from './navigation-utils';
+/**
+ * Options for configuring built-in action runners.
+ */
+export interface ActionRunnerFactoryOptions {
+    apiRequest?: ApiRequestRunnerOptions;
+    handlers?: Record<string, PipelineStepHandler>;
+}
+/**
+ * Creates a map of all default built-in action runners for `@kubuild/renderer`.
+ */
+export declare function createDefaultActionRunners(options?: ActionRunnerFactoryOptions): Record<string, PipelineStepHandler>;
+/**
+ * Registers default built-in action runners onto an ActionPipelineExecutor instance.
+ */
+export declare function registerDefaultActionRunners(executor: ActionPipelineExecutor, options?: ActionRunnerFactoryOptions): ActionPipelineExecutor;
+//# sourceMappingURL=index.d.ts.map

package/dist/action-runners/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/action-runners/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACjF,OAAO,EAGL,KAAK,uBAAuB,EAC7B,MAAM,eAAe,CAAC;AAIvB,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AAEnC;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,UAAU,CAAC,EAAE,uBAAuB,CAAC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;CAChD;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,CAAC,EAAE,0BAA0B,GACnC,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAerC;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,sBAAsB,EAChC,OAAO,CAAC,EAAE,0BAA0B,GACnC,sBAAsB,CAQxB"}

package/dist/action-runners/modal-manager.d.ts

@@ -0,0 +1,68 @@
+export type ModalState = Record<string, boolean>;
+export type ModalListener = (modals: ModalState) => void;
+/**
+ * ModalManager manages visibility state of modals, stack ordering, and custom events.
+ */
+export declare class ModalManager {
+    private modals;
+    private activeStack;
+    private listeners;
+    /**
+     * Opens a modal dialog by ID.
+     */
+    openModal(modalId: string): void;
+    /**
+     * Closes a modal dialog by ID or closes the topmost modal if no ID is specified.
+     */
+    closeModal(modalId?: string): void;
+    /**
+     * Toggles visibility state of a modal.
+     */
+    toggleModal(modalId: string): boolean;
+    /**
+     * Checks whether a modal is currently open.
+     */
+    isModalOpen(modalId: string): boolean;
+    /**
+     * Returns a snapshot map of all modal states.
+     */
+    getState(): ModalState;
+    /**
+     * Returns list of currently open modal IDs in stack order.
+     */
+    getActiveModals(): string[];
+    /**
+     * Resets all modal states to closed.
+     */
+    reset(): void;
+    /**
+     * Subscribes a listener to modal state changes.
+     */
+    subscribe(listener: ModalListener): () => void;
+    private notify;
+}
+/**
+ * Singleton ModalManager instance.
+ */
+export declare const modalManager: ModalManager;
+/**
+ * React hook to observe and manipulate a single modal dialog state.
+ */
+export declare function useModal(modalId: string, manager?: ModalManager): {
+    isOpen: boolean;
+    open: () => void;
+    close: () => void;
+    toggle: () => boolean;
+};
+/**
+ * React hook to observe and manage all modal dialogs.
+ */
+export declare function useModals(manager?: ModalManager): {
+    modals: ModalState;
+    activeModals: string[];
+    isOpen: (modalId: string) => boolean;
+    openModal: (modalId: string) => void;
+    closeModal: (modalId?: string) => void;
+    toggleModal: (modalId: string) => boolean;
+};
+//# sourceMappingURL=modal-manager.d.ts.map

package/dist/action-runners/modal-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modal-manager.d.ts","sourceRoot":"","sources":["../../src/action-runners/modal-manager.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACjD,MAAM,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,CAAC;AAEzD;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,SAAS,CAA4B;IAE7C;;OAEG;IACI,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAwBvC;;OAEG;IACI,UAAU,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IA4CzC;;OAEG;IACI,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAW5C;;OAEG;IACI,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAK5C;;OAEG;IACI,QAAQ,IAAI,UAAU;IAQ7B;;OAEG;IACI,eAAe,IAAI,MAAM,EAAE;IAIlC;;OAEG;IACI,KAAK,IAAI,IAAI;IAMpB;;OAEG;IACI,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,IAAI;IAOrD,OAAO,CAAC,MAAM;CAUf;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,cAAqB,CAAC;AAE/C;;GAEG;AACH,wBAAgB,QAAQ,CACtB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,YAA2B,GACnC;IACD,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,MAAM,EAAE,MAAM,OAAO,CAAC;CACvB,CAeA;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,GAAE,YAA2B,GAAG;IAC/D,MAAM,EAAE,UAAU,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;IACrC,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,UAAU,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;CAC3C,CAkBA"}

package/dist/action-runners/navigation-utils.d.ts

@@ -0,0 +1,49 @@
+import { type PipelineStepHandler } from '@kubuild/core';
+/**
+ * Result returned by navigate runner.
+ */
+export interface NavigateResult {
+    url: string;
+    target?: string;
+    replace?: boolean;
+    scroll?: boolean;
+    behavior?: 'smooth' | 'auto';
+    navigated: boolean;
+    isAnchor: boolean;
+}
+/**
+ * Result returned by copy_clipboard runner.
+ */
+export interface CopyClipboardResult {
+    text: string;
+    copied: boolean;
+}
+/**
+ * Result returned by reset_form runner.
+ */
+export interface ResetFormResult {
+    formId?: string;
+    reset: boolean;
+}
+/**
+ * Helper to copy text to clipboard with legacy fallback.
+ */
+export declare function copyToClipboard(text: string, options?: {
+    copyFn?: (text: string) => Promise<void> | void;
+}): Promise<boolean>;
+/**
+ * Action Runner for `navigate`.
+ * Supports external redirects, target windows (_blank), SPA navigate hooks, and smooth anchor scrolling (#id).
+ */
+export declare const navigateRunner: PipelineStepHandler;
+/**
+ * Action Runner for `copy_clipboard`.
+ * Copies string or variable payload to user clipboard with fallback and optional toast notification.
+ */
+export declare const copyClipboardRunner: PipelineStepHandler;
+/**
+ * Action Runner for `reset_form`.
+ * Resets form context values and DOM form elements to default state.
+ */
+export declare const resetFormRunner: PipelineStepHandler;
+//# sourceMappingURL=navigation-utils.d.ts.map

package/dist/action-runners/navigation-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation-utils.d.ts","sourceRoot":"","sources":["../../src/action-runners/navigation-utils.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiC,KAAK,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAGxF;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC7B,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;CAAE,GAC5D,OAAO,CAAC,OAAO,CAAC,CA0ClB;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,mBA8G5B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,mBAwCjC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,mBAqC7B,CAAC"}

package/dist/action-runners/toast-container.d.ts

@@ -0,0 +1,20 @@
+import React from 'react';
+import { type ToastItem, type ToastPosition, type ToastManager as ToastManagerClass } from './toast-manager';
+export interface ToastContainerProps {
+    manager?: ToastManagerClass;
+    position?: ToastPosition;
+    className?: string;
+    maxVisible?: number;
+}
+/**
+ * Single Toast Item component rendering an alert card.
+ */
+export declare const ToastCard: React.FC<{
+    toast: ToastItem;
+}>;
+/**
+ * Built-in responsive Toast Container component.
+ * Renders floating toasts with smooth animations and auto-dismiss capabilities.
+ */
+export declare const ToastContainer: React.FC<ToastContainerProps>;
+//# sourceMappingURL=toast-container.d.ts.map

package/dist/action-runners/toast-container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toast-container.d.ts","sourceRoot":"","sources":["../../src/action-runners/toast-container.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkB,MAAM,OAAO,CAAC;AACvC,OAAO,EAGL,KAAK,SAAS,EACd,KAAK,aAAa,EAElB,KAAK,YAAY,IAAI,iBAAiB,EACvC,MAAM,iBAAiB,CAAC;AAGzB,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAkFD;;GAEG;AACH,eAAO,MAAM,SAAS,EAAE,KAAK,CAAC,EAAE,CAAC;IAAE,KAAK,EAAE,SAAS,CAAA;CAAE,CA8EpD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CA6ExD,CAAC"}

package/dist/action-runners/toast-manager.d.ts

@@ -0,0 +1,74 @@
+export type ToastType = 'success' | 'error' | 'warning' | 'info';
+export type ToastPosition = 'top-right' | 'top-left' | 'bottom-right' | 'bottom-left' | 'top-center' | 'bottom-center';
+/**
+ * Configuration options for spawning a toast notification.
+ */
+export interface ToastOptions {
+    message: string;
+    type?: ToastType;
+    variant?: ToastType;
+    title?: string;
+    duration?: number;
+    position?: ToastPosition;
+    dismissible?: boolean;
+    id?: string;
+}
+/**
+ * Internal active toast item structure.
+ */
+export interface ToastItem {
+    id: string;
+    type: ToastType;
+    message: string;
+    title?: string;
+    duration: number;
+    position: ToastPosition;
+    dismissible: boolean;
+    createdAt: number;
+    dismiss: () => void;
+}
+type ToastListener = (toasts: ToastItem[]) => void;
+/**
+ * ToastManager manages reactive toast state, timers, and event subscriptions.
+ */
+export declare class ToastManager {
+    private toasts;
+    private listeners;
+    private timers;
+    /**
+     * Spawns a new toast notification.
+     */
+    showToast(options: ToastOptions | string): ToastItem;
+    /**
+     * Dismisses a single toast by ID.
+     */
+    dismissToast(id: string): void;
+    /**
+     * Clears all active toasts.
+     */
+    clearToasts(): void;
+    /**
+     * Returns current active toasts.
+     */
+    getToasts(): ToastItem[];
+    /**
+     * Subscribes a listener to toast state changes.
+     */
+    subscribe(listener: ToastListener): () => void;
+    private notify;
+}
+/**
+ * Singleton ToastManager instance for global toast handling.
+ */
+export declare const toastManager: ToastManager;
+/**
+ * React hook to observe and trigger toast notifications.
+ */
+export declare function useToasts(manager?: ToastManager): {
+    toasts: ToastItem[];
+    showToast: (options: ToastOptions | string) => ToastItem;
+    dismissToast: (id: string) => void;
+    clearToasts: () => void;
+};
+export {};
+//# sourceMappingURL=toast-manager.d.ts.map

package/dist/action-runners/toast-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toast-manager.d.ts","sourceRoot":"","sources":["../../src/action-runners/toast-manager.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AACjE,MAAM,MAAM,aAAa,GACrB,WAAW,GACX,UAAU,GACV,cAAc,GACd,aAAa,GACb,YAAY,GACZ,eAAe,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,aAAa,CAAC;IACxB,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,KAAK,aAAa,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,IAAI,CAAC;AAInD;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,MAAM,CAAoD;IAElE;;OAEG;IACI,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS;IA2C3D;;OAEG;IACI,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAcrC;;OAEG;IACI,WAAW,IAAI,IAAI;IAS1B;;OAEG;IACI,SAAS,IAAI,SAAS,EAAE;IAI/B;;OAEG;IACI,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,IAAI;IAOrD,OAAO,CAAC,MAAM;CAUf;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,cAAqB,CAAC;AAE/C;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,GAAE,YAA2B,GAAG;IAC/D,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,SAAS,EAAE,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,KAAK,SAAS,CAAC;IACzD,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB,CAgBA"}

package/dist/action-runners/ui-feedback.d.ts

@@ -0,0 +1,33 @@
+import { type PipelineStepHandler } from '@kubuild/core';
+import { type ToastType, type ToastPosition } from './toast-manager';
+/**
+ * Result returned by show_toast runner.
+ */
+export interface ShowToastResult {
+    id: string;
+    message: string;
+    type: ToastType;
+    title?: string;
+    duration: number;
+    position: ToastPosition;
+}
+/**
+ * Result returned by open_modal or close_modal runner.
+ */
+export interface ModalActionResult {
+    modalId: string;
+    open: boolean;
+}
+/**
+ * Action Runner for `show_toast`.
+ */
+export declare const showToastRunner: PipelineStepHandler;
+/**
+ * Action Runner for `open_modal`.
+ */
+export declare const openModalRunner: PipelineStepHandler;
+/**
+ * Action Runner for `close_modal`.
+ */
+export declare const closeModalRunner: PipelineStepHandler;
+//# sourceMappingURL=ui-feedback.d.ts.map

package/dist/action-runners/ui-feedback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-feedback.d.ts","sourceRoot":"","sources":["../../src/action-runners/ui-feedback.ts"],"names":[],"mappings":"AACA,OAAO,EAAiC,KAAK,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACxF,OAAO,EAAmC,KAAK,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGtG;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,aAAa,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,mBAqC7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,mBAkC7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,mBAqC9B,CAAC"}

package/dist/animation.d.ts

@@ -0,0 +1,26 @@
+import { PageDocument, AnimationConfig } from '@kubuild/schema';
+/**
+ * Standard Keyframes for Entrance, Scroll, and Continuous Loop Animations (STORA-263, STORA-264)
+ */
+export declare const ANIMATION_KEYFRAMES_CSS: string;
+/**
+ * Generate CSS rules for Hover Micro-Interactions (STORA-264)
+ */
+export declare function getHoverEffectCss(nodeId: string, hoverEffect: string): string[];
+/**
+ * Generate CSS rules for Continuous Loop Effects (STORA-264)
+ */
+export declare function getLoopEffectCss(nodeId: string, loopEffect: string): string[];
+/**
+ * Generate CSS rules for Entrance / Scroll Animations (STORA-263)
+ */
+export declare function getEntranceAnimationCss(nodeId: string, anim: AnimationConfig): string[];
+/**
+ * Walk the document and collect all compiled CSS rules for animations, hover micro-interactions, and loop effects.
+ */
+export declare function collectAnimationStylesCss(document: PageDocument | undefined | null): string;
+/**
+ * Replay CSS animation on a specific DOM element by node ID (STORA-262)
+ */
+export declare function replayNodeAnimation(nodeId: string, rootElement?: HTMLElement | Document | null): boolean;
+//# sourceMappingURL=animation.d.ts.map

package/dist/animation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animation.d.ts","sourceRoot":"","sources":["../src/animation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAQ,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEtE;;GAEG;AACH,eAAO,MAAM,uBAAuB,QA4E5B,CAAC;AAST;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAkC/E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAmC7E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,GAAG,MAAM,EAAE,CAUvF;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,YAAY,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CA6B3F;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,WAAW,GAAG,QAAQ,GAAG,IAAI,GAAG,OAAO,CAgBxG"}

package/dist/code-generator.d.ts

@@ -0,0 +1,47 @@
+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 (tablet/mobile), and pseudo-classes.
+ */
+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.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"code-generator.d.ts","sourceRoot":"","sources":["../src/code-generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAIrD,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;AAiBD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,YAAY,GAAG,IAAI,EAC9B,OAAO,GAAE,kBAAuB,GAC/B,MAAM,CAgGR;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,YAAY,EACjB,OAAO,GAAE,qBAA0B,GAClC,MAAM,CA0BR"}

package/dist/error-boundary.d.ts

@@ -1,10 +1,12 @@
 import { Component, ErrorInfo, ReactNode } from 'react';
+import type { Diagnostic } from './render-context';
 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;