@lynx-js/genui 0.0.1-rc.0

package/openui/dist/catalog/Stack/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/catalog/Stack/index.tsx"],"names":[],"mappings":";AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAC1D,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEjD,SAAS,aAAa,CAAC,KAA6C;IAClE,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,OAAO;YACV,OAAO,kBAAkB,CAAC;QAC5B,KAAK,QAAQ;YACX,OAAO,mBAAmB,CAAC;QAC7B,KAAK,KAAK;YACR,OAAO,gBAAgB,CAAC;QAC1B;YACE,OAAO,oBAAoB,CAAC;IAChC,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CACtB,OAA+C;IAE/C,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,QAAQ;YACX,OAAO,qBAAqB,CAAC;QAC/B,KAAK,KAAK;YACR,OAAO,kBAAkB,CAAC;QAC5B,KAAK,SAAS;YACZ,OAAO,sBAAsB,CAAC;QAChC;YACE,OAAO,oBAAoB,CAAC;IAChC,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,KAAK,GAAG,eAAe,CAAC;IACnC,IAAI,EAAE,OAAO;IACb,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;QAC1B,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE;QAC/C,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;QAC5B,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE;QAC3D,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE;QAC/D,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE;KAClE,CAAC;IACF,WAAW,EAAE,uBAAuB;IACpC,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE;QACnC,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,QAAQ,CAAC;QAC9C,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,GAAG,CAAC;QAC7B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,SAAS,CAAC;QACvC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,OAAO,CAAC;QAEzC,MAAM,SAAS,GAAG;YAChB,aAAa;YACb,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,mBAAmB;YAC5D,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE;YACnC,SAAS,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC,GAAG,CAAC;YAChC,aAAa,CAAC,KAAK,CAAC;YACpB,eAAe,CAAC,OAAO,CAAC;SACzB;aACE,MAAM,CAAC,OAAO,CAAC;aACf,IAAI,CAAC,GAAG,CAAC,CAAC;QAEb,OAAO,CACL,eAAM,SAAS,EAAE,SAAS,YAAG,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,GAAQ,CACzE,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/openui/dist/catalog/Tag/index.d.ts

@@ -0,0 +1,4 @@
+import { z } from 'zod/v4';
+export declare const Tag: import("../../core/library.js").DefinedComponent<z.ZodObject<{
+    text: z.ZodString;
+}, z.core.$strip>>;

package/openui/dist/catalog/Tag/index.js

@@ -0,0 +1,15 @@
+import { jsx as _jsx } from "@lynx-js/react/jsx-runtime";
+// Copyright 2026 The Lynx Authors. All rights reserved.
+// Licensed under the Apache License Version 2.0 that can be found in the
+// LICENSE file in the root directory of this source tree.
+import { z } from 'zod/v4';
+import { defineComponent } from '../../core/library.js';
+export const Tag = defineComponent({
+    name: 'Tag',
+    props: z.object({
+        text: z.string(),
+    }),
+    description: 'Tag',
+    component: ({ props }) => (_jsx("view", { className: 'OpenUITag', children: _jsx("text", { className: 'OpenUITagText', children: props.text }) })),
+});
+//# sourceMappingURL=index.js.map

package/openui/dist/catalog/Tag/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/catalog/Tag/index.tsx"],"names":[],"mappings":";AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAC1D,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,CAAC,MAAM,GAAG,GAAG,eAAe,CAAC;IACjC,IAAI,EAAE,KAAK;IACX,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;KACjB,CAAC;IACF,WAAW,EAAE,KAAK;IAClB,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CACxB,eAAM,SAAS,EAAC,WAAW,YACzB,eAAM,SAAS,EAAC,eAAe,YAAE,KAAK,CAAC,IAAI,GAAQ,GAC9C,CACR;CACF,CAAC,CAAC"}

package/openui/dist/catalog/TextContent/index.d.ts

@@ -0,0 +1,11 @@
+import { z } from 'zod/v4';
+export declare const TextContent: import("../../core/library.js").DefinedComponent<z.ZodObject<{
+    text: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>;
+    size: z.ZodOptional<z.ZodEnum<{
+        default: "default";
+        small: "small";
+        large: "large";
+        "small-heavy": "small-heavy";
+        "large-heavy": "large-heavy";
+    }>>;
+}, z.core.$strip>>;

package/openui/dist/catalog/TextContent/index.js

@@ -0,0 +1,33 @@
+import { jsx as _jsx } from "@lynx-js/react/jsx-runtime";
+// Copyright 2026 The Lynx Authors. All rights reserved.
+// Licensed under the Apache License Version 2.0 that can be found in the
+// LICENSE file in the root directory of this source tree.
+import { z } from 'zod/v4';
+import { defineComponent } from '../../core/library.js';
+export const TextContent = defineComponent({
+    name: 'TextContent',
+    props: z.object({
+        text: z.union([z.string(), z.number(), z.boolean()]),
+        size: z.enum(['small', 'default', 'large', 'small-heavy', 'large-heavy'])
+            .optional(),
+    }),
+    description: 'Text content with optional size.',
+    component: ({ props }) => {
+        const size = props.size ?? 'default';
+        let sizeClass = 'OpenUITextContentDefault';
+        if (size === 'small') {
+            sizeClass = 'OpenUITextContentSmall';
+        }
+        else if (size === 'large') {
+            sizeClass = 'OpenUITextContentLarge';
+        }
+        else if (size === 'small-heavy') {
+            sizeClass = 'OpenUITextContentSmallHeavy';
+        }
+        else if (size === 'large-heavy') {
+            sizeClass = 'OpenUITextContentLargeHeavy';
+        }
+        return (_jsx("text", { className: `OpenUITextContent ${sizeClass}`, children: String(props.text ?? '') }));
+    },
+});
+//# sourceMappingURL=index.js.map

package/openui/dist/catalog/TextContent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/catalog/TextContent/index.tsx"],"names":[],"mappings":";AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAC1D,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,CAAC,MAAM,WAAW,GAAG,eAAe,CAAC;IACzC,IAAI,EAAE,aAAa;IACnB,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QACpD,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC;aACtE,QAAQ,EAAE;KACd,CAAC;IACF,WAAW,EAAE,kCAAkC;IAC/C,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE;QACvB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,SAAS,CAAC;QACrC,IAAI,SAAS,GAAG,0BAA0B,CAAC;QAC3C,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;YACrB,SAAS,GAAG,wBAAwB,CAAC;QACvC,CAAC;aAAM,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;YAC5B,SAAS,GAAG,wBAAwB,CAAC;QACvC,CAAC;aAAM,IAAI,IAAI,KAAK,aAAa,EAAE,CAAC;YAClC,SAAS,GAAG,6BAA6B,CAAC;QAC5C,CAAC;aAAM,IAAI,IAAI,KAAK,aAAa,EAAE,CAAC;YAClC,SAAS,GAAG,6BAA6B,CAAC;QAC5C,CAAC;QAED,OAAO,CACL,eAAM,SAAS,EAAE,qBAAqB,SAAS,EAAE,YAC9C,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,GACpB,CACR,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/openui/dist/catalog/index.d.ts

@@ -0,0 +1,7 @@
+export { Button, Buttons } from './Button/index.js';
+export { Card } from './Card/index.js';
+export { CardHeader } from './CardHeader/index.js';
+export { Separator } from './Separator/index.js';
+export { Stack } from './Stack/index.js';
+export { Tag } from './Tag/index.js';
+export { TextContent } from './TextContent/index.js';

package/openui/dist/catalog/index.js

@@ -0,0 +1,11 @@
+// Copyright 2026 The Lynx Authors. All rights reserved.
+// Licensed under the Apache License Version 2.0 that can be found in the
+// LICENSE file in the root directory of this source tree.
+export { Button, Buttons } from './Button/index.js';
+export { Card } from './Card/index.js';
+export { CardHeader } from './CardHeader/index.js';
+export { Separator } from './Separator/index.js';
+export { Stack } from './Stack/index.js';
+export { Tag } from './Tag/index.js';
+export { TextContent } from './TextContent/index.js';
+//# sourceMappingURL=index.js.map

package/openui/dist/catalog/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/catalog/index.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAC1D,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC"}

package/openui/dist/catalog/utils.d.ts

@@ -0,0 +1,2 @@
+export declare const GAP_CLASS: Record<string, string>;
+export declare function asArray<T>(value: T | T[] | null | undefined): T[];

package/openui/dist/catalog/utils.js

@@ -0,0 +1,17 @@
+// Copyright 2026 The Lynx Authors. All rights reserved.
+// Licensed under the Apache License Version 2.0 that can be found in the
+// LICENSE file in the root directory of this source tree.
+export const GAP_CLASS = {
+    none: 'OpenUIGapNone',
+    xs: 'OpenUIGapXs',
+    s: 'OpenUIGapS',
+    m: 'OpenUIGapM',
+    l: 'OpenUIGapL',
+    xl: 'OpenUIGapXl',
+};
+export function asArray(value) {
+    if (value === null || value === undefined)
+        return [];
+    return Array.isArray(value) ? value : [value];
+}
+//# sourceMappingURL=utils.js.map

package/openui/dist/catalog/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/catalog/utils.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAC1D,MAAM,CAAC,MAAM,SAAS,GAA2B;IAC/C,IAAI,EAAE,eAAe;IACrB,EAAE,EAAE,aAAa;IACjB,CAAC,EAAE,YAAY;IACf,CAAC,EAAE,YAAY;IACf,CAAC,EAAE,YAAY;IACf,EAAE,EAAE,aAAa;CAClB,CAAC;AAEF,MAAM,UAAU,OAAO,CAAI,KAAiC;IAC1D,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACrD,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AAChD,CAAC"}

package/openui/dist/core/context.d.ts

@@ -0,0 +1,112 @@
+import type { ActionPlan, EvaluationContext, Library, OpenUIError, Store } from '@openuidev/lang-core';
+import type { ReactNode } from '@lynx-js/react';
+export interface OpenUIContextValue {
+    /** The active component library (schema + renderers). */
+    library: Library;
+    /**
+     * Render any value (element, array, primitive) into React nodes.
+     */
+    renderNode: (value: unknown) => ReactNode;
+    /**
+     * Trigger an action. Accepts either:
+     * - ActionPlan (v0.5): runs steps sequentially (Run, Set, ToAssistant, OpenUrl)
+     * - Legacy action config (v0.1): { type?: string, params?: Record<string, any> }
+     * - Nothing: fires ContinueConversation with the label
+     */
+    triggerAction: (userMessage: string, formName?: string, action?: ActionPlan | {
+        type?: string;
+        params?: Record<string, any>;
+    }) => void | Promise<void>;
+    /** Whether the LLM is currently streaming content. */
+    isStreaming: boolean;
+    /** Get a field value. Top-level for $bindings, nested under formName for form fields. */
+    getFieldValue: (formName: string | undefined, name: string) => any;
+    /**
+     * Set a form field value.
+     *
+     * @param formName  The form's name prop
+     * @param componentType  The component type (e.g. "Input", "Select") — optional
+     * @param name  The field's name prop
+     * @param value  The new value
+     * @param shouldTriggerSaveCallback  When true, persists state via onStateUpdate.
+     *   Text inputs should pass `false` on change and `true` on blur.
+     *   Discrete inputs (Select, RadioGroup, etc.) should always pass `true`.
+     */
+    setFieldValue: (formName: string | undefined, componentType: string | undefined, name: string, value: unknown, shouldTriggerSaveCallback?: boolean) => void;
+    /** Reactive binding store for $variables and form data. */
+    store: Store;
+    /** AST evaluation context used by runtime expression evaluation. */
+    evaluationContext: EvaluationContext;
+    /** Report a structured error (used internally by error boundary). */
+    reportError?: (error: OpenUIError) => void;
+}
+export declare const OpenUIContext: import("react").Context<OpenUIContextValue | null>;
+/**
+ * Access the full OpenUI context. Throws if used outside a <Renderer />.
+ */
+export declare function useOpenUI(): OpenUIContextValue;
+/**
+ * Get the renderNode function for rendering nested component values.
+ */
+export declare function useRenderNode(): (value: unknown) => ReactNode;
+/**
+ * Get the triggerAction function for firing structured action events.
+ *
+ * @example
+ * ```tsx
+ * const triggerAction = useTriggerAction();
+ * <button onClick={() => triggerAction("Submit", "myForm")}>
+ * ```
+ */
+export declare function useTriggerAction(): (userMessage: string, formName?: string, action?: ActionPlan | {
+    type?: string;
+    params?: Record<string, any>;
+}) => void | Promise<void>;
+/**
+ * Whether the LLM is currently streaming content.
+ */
+export declare function useIsStreaming(): boolean;
+/**
+ * Get a form field value from the form state context.
+ *
+ * @example
+ * ```tsx
+ * const getFieldValue = useGetFieldValue();
+ * const name = getFieldValue("contactForm", "name");
+ * ```
+ */
+export declare function useGetFieldValue(): (formName: string | undefined, name: string) => any;
+/**
+ * Get the setFieldValue function for updating form field values.
+ *
+ * @example
+ * ```tsx
+ * const setFieldValue = useSetFieldValue();
+ * <input onChange={(e) => setFieldValue("contactForm", "Input", "name", e.target.value, false)} />
+ * ```
+ */
+export declare function useSetFieldValue(): (formName: string | undefined, componentType: string | undefined, name: string, value: unknown, shouldTriggerSaveCallback?: boolean) => void;
+export declare const FormNameContext: import("react").Context<string | undefined>;
+/**
+ * Get the current form name (set by the nearest parent Form component).
+ * Returns undefined if not inside a Form.
+ */
+export declare function useFormName(): string | undefined;
+/**
+ * Persists a component's default/initial value into form state once streaming
+ * finishes — but only if the user hasn't already set a value.
+ *
+ * Call this inside any form component that has a `defaultValue` or
+ * `defaultChecked` prop. It is a no-op during streaming so that LLM
+ * prop changes don't fight with partial state.
+ *
+ * @param shouldTriggerSaveCallback — defaults to `false` (only local state, no message persistence)
+ */
+export declare function useSetDefaultValue({ formName, componentType, name, existingValue, defaultValue, shouldTriggerSaveCallback, }: {
+    formName?: string;
+    componentType?: string;
+    name: string;
+    existingValue: unknown;
+    defaultValue: unknown;
+    shouldTriggerSaveCallback?: boolean;
+}): void;

package/openui/dist/core/context.js

@@ -0,0 +1,99 @@
+import { createContext, useContext, useEffect } from '@lynx-js/react';
+export const OpenUIContext = createContext(null);
+/**
+ * Access the full OpenUI context. Throws if used outside a <Renderer />.
+ */
+export function useOpenUI() {
+    const ctx = useContext(OpenUIContext);
+    if (!ctx) {
+        throw new Error('useOpenUI must be used within a <Renderer /> component.');
+    }
+    return ctx;
+}
+/**
+ * Get the renderNode function for rendering nested component values.
+ */
+export function useRenderNode() {
+    return useOpenUI().renderNode;
+}
+/**
+ * Get the triggerAction function for firing structured action events.
+ *
+ * @example
+ * ```tsx
+ * const triggerAction = useTriggerAction();
+ * <button onClick={() => triggerAction("Submit", "myForm")}>
+ * ```
+ */
+export function useTriggerAction() {
+    return useOpenUI().triggerAction;
+}
+/**
+ * Whether the LLM is currently streaming content.
+ */
+export function useIsStreaming() {
+    return useOpenUI().isStreaming;
+}
+/**
+ * Get a form field value from the form state context.
+ *
+ * @example
+ * ```tsx
+ * const getFieldValue = useGetFieldValue();
+ * const name = getFieldValue("contactForm", "name");
+ * ```
+ */
+export function useGetFieldValue() {
+    return useOpenUI().getFieldValue;
+}
+/**
+ * Get the setFieldValue function for updating form field values.
+ *
+ * @example
+ * ```tsx
+ * const setFieldValue = useSetFieldValue();
+ * <input onChange={(e) => setFieldValue("contactForm", "Input", "name", e.target.value, false)} />
+ * ```
+ */
+export function useSetFieldValue() {
+    return useOpenUI().setFieldValue;
+}
+// ─── FormName context ───
+export const FormNameContext = createContext(undefined);
+/**
+ * Get the current form name (set by the nearest parent Form component).
+ * Returns undefined if not inside a Form.
+ */
+export function useFormName() {
+    return useContext(FormNameContext);
+}
+// ─── Default value helper ───
+/**
+ * Persists a component's default/initial value into form state once streaming
+ * finishes — but only if the user hasn't already set a value.
+ *
+ * Call this inside any form component that has a `defaultValue` or
+ * `defaultChecked` prop. It is a no-op during streaming so that LLM
+ * prop changes don't fight with partial state.
+ *
+ * @param shouldTriggerSaveCallback — defaults to `false` (only local state, no message persistence)
+ */
+export function useSetDefaultValue({ formName, componentType, name, existingValue, defaultValue, shouldTriggerSaveCallback = false, }) {
+    const setFieldValue = useSetFieldValue();
+    const isStreaming = useIsStreaming();
+    useEffect(() => {
+        if (!isStreaming && existingValue === undefined && defaultValue !== undefined) {
+            setFieldValue(formName, componentType, name, defaultValue, shouldTriggerSaveCallback);
+        }
+    }, [
+        defaultValue,
+        existingValue,
+        formName,
+        componentType,
+        name,
+        isStreaming,
+        setFieldValue,
+        shouldTriggerSaveCallback,
+    ]);
+}
+//# sourceMappingURL=context.js.map

package/openui/dist/core/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/core/context.tsx"],"names":[],"mappings":"AAYA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AA4DtE,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAA4B,IAAI,CAAC,CAAC;AAE5E;;GAEG;AACH,MAAM,UAAU,SAAS;IACvB,MAAM,GAAG,GAAG,UAAU,CAAC,aAAa,CAAC,CAAC;IACtC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,SAAS,EAAE,CAAC,UAAU,CAAC;AAChC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,SAAS,EAAE,CAAC,aAAa,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,SAAS,EAAE,CAAC,WAAW,CAAC;AACjC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,SAAS,EAAE,CAAC,aAAa,CAAC;AACnC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,SAAS,EAAE,CAAC,aAAa,CAAC;AACnC,CAAC;AAED,2BAA2B;AAE3B,MAAM,CAAC,MAAM,eAAe,GAAG,aAAa,CAAqB,SAAS,CAAC,CAAC;AAE5E;;;GAGG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO,UAAU,CAAC,eAAe,CAAC,CAAC;AACrC,CAAC;AAED,+BAA+B;AAE/B;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAAC,EACjC,QAAQ,EACR,aAAa,EACb,IAAI,EACJ,aAAa,EACb,YAAY,EACZ,yBAAyB,GAAG,KAAK,GAQlC;IACC,MAAM,aAAa,GAAG,gBAAgB,EAAE,CAAC;IACzC,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IAErC,SAAS,CAAC,GAAG,EAAE;QACb,IACE,CAAC,WAAW,IAAI,aAAa,KAAK,SAAS,IAAI,YAAY,KAAK,SAAS,EACzE,CAAC;YACD,aAAa,CACX,QAAQ,EACR,aAAa,EACb,IAAI,EACJ,YAAY,EACZ,yBAAyB,CAC1B,CAAC;QACJ,CAAC;IACH,CAAC,EAAE;QACD,YAAY;QACZ,aAAa;QACb,QAAQ;QACR,aAAa;QACb,IAAI;QACJ,WAAW;QACX,aAAa;QACb,yBAAyB;KAC1B,CAAC,CAAC;AACL,CAAC"}

package/openui/dist/core/createLibrary.d.ts

@@ -0,0 +1,10 @@
+import type { ComponentGroup, DefinedComponent, Library } from './library.js';
+export interface CreateOpenUiLibraryOptions {
+    /** Override the root component name. Defaults to `'Stack'`. */
+    root?: string;
+    /** Replace or extend the built-in component set. */
+    components?: DefinedComponent<any>[];
+    /** Replace or extend the built-in component groups. */
+    componentGroups?: ComponentGroup[];
+}
+export declare function createOpenUiLibrary(options?: CreateOpenUiLibraryOptions): Library;

package/openui/dist/core/createLibrary.js

@@ -0,0 +1,36 @@
+// Copyright 2026 The Lynx Authors. All rights reserved.
+// Licensed under the Apache License Version 2.0 that can be found in the
+// LICENSE file in the root directory of this source tree.
+import { createLibrary } from './library.js';
+import * as c from '../catalog/index.js';
+const DEFAULT_COMPONENTS = [
+    c.Stack,
+    c.Card,
+    c.CardHeader,
+    c.TextContent,
+    c.Separator,
+    c.Button,
+    c.Buttons,
+    c.Tag,
+];
+const DEFAULT_COMPONENT_GROUPS = [
+    { name: 'Layout', components: ['Stack'] },
+    {
+        name: 'Content',
+        components: ['Card', 'CardHeader', 'TextContent', 'Separator'],
+    },
+    { name: 'Buttons', components: ['Button', 'Buttons'] },
+    { name: 'Data Display', components: ['Tag'] },
+];
+export function createOpenUiLibrary(options) {
+    return createLibrary({
+        root: options?.root ?? 'Stack',
+        components: options?.components
+            ? [...DEFAULT_COMPONENTS, ...options.components]
+            : DEFAULT_COMPONENTS,
+        componentGroups: options?.componentGroups
+            ? [...DEFAULT_COMPONENT_GROUPS, ...options.componentGroups]
+            : DEFAULT_COMPONENT_GROUPS,
+    });
+}
+//# sourceMappingURL=createLibrary.js.map

package/openui/dist/core/createLibrary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createLibrary.js","sourceRoot":"","sources":["../../src/core/createLibrary.tsx"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,OAAO,KAAK,CAAC,MAAM,qBAAqB,CAAC;AAWzC,MAAM,kBAAkB,GAA4B;IAClD,CAAC,CAAC,KAAK;IACP,CAAC,CAAC,IAAI;IACN,CAAC,CAAC,UAAU;IACZ,CAAC,CAAC,WAAW;IACb,CAAC,CAAC,SAAS;IACX,CAAC,CAAC,MAAM;IACR,CAAC,CAAC,OAAO;IACT,CAAC,CAAC,GAAG;CACN,CAAC;AAEF,MAAM,wBAAwB,GAAqB;IACjD,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,OAAO,CAAC,EAAE;IACzC;QACE,IAAI,EAAE,SAAS;QACf,UAAU,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,CAAC;KAC/D;IACD,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE;IACtD,EAAE,IAAI,EAAE,cAAc,EAAE,UAAU,EAAE,CAAC,KAAK,CAAC,EAAE;CAC9C,CAAC;AAEF,MAAM,UAAU,mBAAmB,CACjC,OAAoC;IAEpC,OAAO,aAAa,CAAC;QACnB,IAAI,EAAE,OAAO,EAAE,IAAI,IAAI,OAAO;QAC9B,UAAU,EAAE,OAAO,EAAE,UAAU;YAC7B,CAAC,CAAC,CAAC,GAAG,kBAAkB,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC;YAChD,CAAC,CAAC,kBAAkB;QACtB,eAAe,EAAE,OAAO,EAAE,eAAe;YACvC,CAAC,CAAC,CAAC,GAAG,wBAAwB,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC;YAC3D,CAAC,CAAC,wBAAwB;KAC7B,CAAC,CAAC;AACL,CAAC"}

package/openui/dist/core/hooks/index.d.ts

@@ -0,0 +1,4 @@
+export { useOpenUIState } from './useOpenUIState.js';
+export type { OpenUIState, UseOpenUIStateOptions } from './useOpenUIState.js';
+export { FormValidationContext, useCreateFormValidation, useFormValidation, } from './useFormValidation.js';
+export type { FormValidationContextValue } from './useFormValidation.js';

package/openui/dist/core/hooks/index.js

@@ -0,0 +1,6 @@
+// Copyright 2026 The Lynx Authors. All rights reserved.
+// Licensed under the Apache License Version 2.0 that can be found in the
+// LICENSE file in the root directory of this source tree.
+export { useOpenUIState } from './useOpenUIState.js';
+export { FormValidationContext, useCreateFormValidation, useFormValidation, } from './useFormValidation.js';
+//# sourceMappingURL=index.js.map

package/openui/dist/core/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/hooks/index.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,wBAAwB,CAAC"}

package/openui/dist/core/hooks/useFormValidation.d.ts

@@ -0,0 +1,13 @@
+import type { ParsedRule } from '@openuidev/lang-core';
+export interface FormValidationContextValue {
+    errors: Record<string, string | undefined>;
+    getFieldError: (name: string) => string | undefined;
+    validateField: (name: string, value: unknown, rules: ParsedRule[]) => boolean;
+    registerField: (name: string, rules: ParsedRule[], getValue: () => unknown) => void;
+    unregisterField: (name: string) => void;
+    validateForm: () => boolean;
+    clearFieldError: (name: string) => void;
+}
+export declare const FormValidationContext: import("react").Context<FormValidationContextValue | null>;
+export declare function useFormValidation(): FormValidationContextValue | null;
+export declare function useCreateFormValidation(): FormValidationContextValue;

package/openui/dist/core/hooks/useFormValidation.js

@@ -0,0 +1,76 @@
+// Copyright 2026 The Lynx Authors. All rights reserved.
+// Licensed under the Apache License Version 2.0 that can be found in the
+// LICENSE file in the root directory of this source tree.
+import { validate } from '@openuidev/lang-core';
+import { createContext, useCallback, useContext, useMemo, useRef, useState, } from '@lynx-js/react';
+export const FormValidationContext = createContext(null);
+export function useFormValidation() {
+    return useContext(FormValidationContext);
+}
+export function useCreateFormValidation() {
+    const [errors, setErrors] = useState({});
+    const errorsRef = useRef(errors);
+    errorsRef.current = errors;
+    const fieldsRef = useRef({});
+    const getFieldError = useCallback((name) => errorsRef.current[name], []);
+    const validateField = useCallback((name, value, rules) => {
+        const error = validate(value, rules);
+        setErrors((prev) => {
+            if (prev[name] === error)
+                return prev;
+            return { ...prev, [name]: error };
+        });
+        return !error;
+    }, []);
+    const registerField = useCallback((name, rules, getValue) => {
+        fieldsRef.current[name] = { rules, getValue };
+    }, []);
+    const unregisterField = useCallback((name) => {
+        delete fieldsRef.current[name];
+    }, []);
+    const validateForm = useCallback(() => {
+        let allValid = true;
+        const newErrors = {};
+        for (const [name, reg] of Object.entries(fieldsRef.current)) {
+            let value = reg.getValue();
+            // Normalize: form state stores { value, componentType }; extract actual value if needed
+            if (value != null
+                && typeof value === 'object'
+                && 'value' in value
+                && 'componentType' in value) {
+                value = value.value;
+            }
+            const error = validate(value, reg.rules);
+            newErrors[name] = error;
+            if (error)
+                allValid = false;
+        }
+        setErrors(newErrors);
+        return allValid;
+    }, []);
+    const clearFieldError = useCallback((name) => {
+        setErrors((prev) => {
+            if (prev[name] === undefined)
+                return prev;
+            return { ...prev, [name]: undefined };
+        });
+    }, []);
+    return useMemo(() => ({
+        errors,
+        getFieldError,
+        validateField,
+        registerField,
+        unregisterField,
+        validateForm,
+        clearFieldError,
+    }), [
+        errors,
+        getFieldError,
+        validateField,
+        registerField,
+        unregisterField,
+        validateForm,
+        clearFieldError,
+    ]);
+}
+//# sourceMappingURL=useFormValidation.js.map

package/openui/dist/core/hooks/useFormValidation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormValidation.js","sourceRoot":"","sources":["../../../src/core/hooks/useFormValidation.ts"],"names":[],"mappings":"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"}

package/openui/dist/core/hooks/useOpenUIState.d.ts

@@ -0,0 +1,33 @@
+import type { ActionEvent, OpenUIError, ParseResult, ToolProvider } from '@openuidev/lang-core';
+import type React from 'react';
+import type { OpenUIContextValue } from '../context.js';
+import type { Library } from '../library.js';
+export interface UseOpenUIStateOptions {
+    response: string | null;
+    library: Library;
+    isStreaming: boolean;
+    onAction?: (event: ActionEvent) => void;
+    onStateUpdate?: (state: Record<string, unknown>) => void;
+    initialState?: Record<string, unknown>;
+    /** ToolProvider for Query data fetching — MCP, REST, GraphQL, or any backend. */
+    toolProvider?: ToolProvider | null;
+    /** Callback for structured, LLM-friendly errors. See OpenUIError type. */
+    onError?: (errors: OpenUIError[]) => void;
+}
+export interface OpenUIState {
+    /** Evaluated result (props resolved to concrete values). Used by Renderer. */
+    result: ParseResult | null;
+    /** Raw parse result (AST nodes in props). Used by onParseResult callback. */
+    parseResult: ParseResult | null;
+    contextValue: OpenUIContextValue;
+    /** Whether any Query is currently fetching data. */
+    isQueryLoading: boolean;
+}
+/**
+ * Core state hook — extracts all form state, action handling, parser
+ * management, and context assembly out of the Renderer component.
+ *
+ * Store holds everything: $bindings as top-level keys, form fields nested
+ * under formName as plain values.
+ */
+export declare function useOpenUIState({ response, library, isStreaming, onAction, onStateUpdate, initialState, toolProvider, onError, }: UseOpenUIStateOptions, renderDeep: (value: unknown) => React.ReactNode): OpenUIState;