@xemahq/ui-kernel 0.6.1 → 0.7.0

package/dist/ui/capture/use-prefill.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.usePrefill = usePrefill;
+const react_1 = require("react");
+function usePrefill(options) {
+    const { fetchDefaults, initialValues, enabled = true } = options;
+    const [values, setValuesState] = (0, react_1.useState)(() => ({ ...(initialValues ?? {}) }));
+    const [suggested, setSuggested] = (0, react_1.useState)(() => new Set());
+    const [loading, setLoading] = (0, react_1.useState)(false);
+    const [error, setError] = (0, react_1.useState)(null);
+    const touched = (0, react_1.useRef)(new Set());
+    const requestId = (0, react_1.useRef)(0);
+    const setValue = (0, react_1.useCallback)((key, value) => {
+        touched.current.add(key);
+        setValuesState((prev) => ({ ...prev, [key]: value }));
+        setSuggested((prev) => {
+            if (!prev.has(key))
+                return prev;
+            const next = new Set(prev);
+            next.delete(key);
+            return next;
+        });
+    }, []);
+    const setValues = (0, react_1.useCallback)((updater) => {
+        setValuesState((prev) => {
+            const next = typeof updater === 'function' ? updater(prev) : { ...prev, ...updater };
+            const changed = new Set();
+            for (const k of Object.keys(next)) {
+                if (next[k] !== prev[k]) {
+                    touched.current.add(k);
+                    changed.add(k);
+                }
+            }
+            if (changed.size > 0) {
+                setSuggested((prevSug) => {
+                    if (![...changed].some((k) => prevSug.has(k)))
+                        return prevSug;
+                    const n = new Set(prevSug);
+                    for (const k of changed)
+                        n.delete(k);
+                    return n;
+                });
+            }
+            return next;
+        });
+    }, []);
+    const run = (0, react_1.useCallback)(() => {
+        const id = ++requestId.current;
+        setLoading(true);
+        setError(null);
+        void fetchDefaults()
+            .then((defaults) => {
+            if (id !== requestId.current)
+                return;
+            const applied = [];
+            setValuesState((prev) => {
+                const next = { ...prev };
+                for (const [key, value] of Object.entries(defaults)) {
+                    const current = prev[key];
+                    const isEmpty = current === undefined || current === null || current === '';
+                    if (!touched.current.has(key) && isEmpty && value !== undefined) {
+                        next[key] = value;
+                        applied.push(key);
+                    }
+                }
+                return next;
+            });
+            setSuggested((prev) => {
+                if (applied.length === 0)
+                    return prev;
+                const n = new Set(prev);
+                for (const k of applied)
+                    n.add(k);
+                return n;
+            });
+        })
+            .catch((e) => {
+            if (id !== requestId.current)
+                return;
+            setError(e);
+        })
+            .finally(() => {
+            if (id === requestId.current)
+                setLoading(false);
+        });
+    }, [fetchDefaults]);
+    (0, react_1.useEffect)(() => {
+        if (enabled)
+            run();
+    }, [enabled]);
+    const isSuggested = (0, react_1.useCallback)((key) => suggested.has(key), [suggested]);
+    return { values, setValue, setValues, suggestedKeys: suggested, isSuggested, loading, error, reload: run };
+}
+//# sourceMappingURL=use-prefill.js.map

package/dist/ui/capture/use-prefill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-prefill.js","sourceRoot":"","sources":["../../../src/ui/capture/use-prefill.ts"],"names":[],"mappings":";;AAsDA,gCA+FC;AA5ID,iCAAiE;AA6CjE,SAAgB,UAAU,CACxB,OAA6B;IAE7B,MAAM,EAAE,aAAa,EAAE,aAAa,EAAE,OAAO,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IAEjE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,IAAA,gBAAQ,EAAI,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,aAAa,IAAK,EAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1F,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,IAAA,gBAAQ,EAAsB,GAAG,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;IACjF,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,IAAA,gBAAQ,EAAC,KAAK,CAAC,CAAC;IAC9C,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,IAAA,gBAAQ,EAAU,IAAI,CAAC,CAAC;IAGlD,MAAM,OAAO,GAAG,IAAA,cAAM,EAAc,IAAI,GAAG,EAAE,CAAC,CAAC;IAG/C,MAAM,SAAS,GAAG,IAAA,cAAM,EAAC,CAAC,CAAC,CAAC;IAE5B,MAAM,QAAQ,GAAG,IAAA,mBAAW,EAAC,CAAC,GAAW,EAAE,KAAc,EAAE,EAAE;QAC3D,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACzB,cAAc,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QACtD,YAAY,CAAC,CAAC,IAAI,EAAE,EAAE;YACpB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,OAAO,IAAI,CAAC;YAChC,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;YAC3B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjB,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,SAAS,GAAG,IAAA,mBAAW,EAAC,CAAC,OAAsC,EAAE,EAAE;QACvE,cAAc,CAAC,CAAC,IAAI,EAAE,EAAE;YACtB,MAAM,IAAI,GAAG,OAAO,OAAO,KAAK,UAAU,CAAC,CAAC,CAAE,OAAuB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC;YACtG,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;YAClC,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAClC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;oBACxB,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;oBACvB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBACjB,CAAC;YACH,CAAC;YACD,IAAI,OAAO,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;gBACrB,YAAY,CAAC,CAAC,OAAO,EAAE,EAAE;oBACvB,IAAI,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;wBAAE,OAAO,OAAO,CAAC;oBAC9D,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;oBAC3B,KAAK,MAAM,CAAC,IAAI,OAAO;wBAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;oBACrC,OAAO,CAAC,CAAC;gBACX,CAAC,CAAC,CAAC;YACL,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,GAAG,GAAG,IAAA,mBAAW,EAAC,GAAG,EAAE;QAC3B,MAAM,EAAE,GAAG,EAAE,SAAS,CAAC,OAAO,CAAC;QAC/B,UAAU,CAAC,IAAI,CAAC,CAAC;QACjB,QAAQ,CAAC,IAAI,CAAC,CAAC;QACf,KAAK,aAAa,EAAE;aACjB,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;YACjB,IAAI,EAAE,KAAK,SAAS,CAAC,OAAO;gBAAE,OAAO;YACrC,MAAM,OAAO,GAAa,EAAE,CAAC;YAC7B,cAAc,CAAC,CAAC,IAAI,EAAE,EAAE;gBACtB,MAAM,IAAI,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;gBACzB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAEpD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;oBAC1B,MAAM,OAAO,GAAG,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,EAAE,CAAC;oBAC5E,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,OAAO,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;wBAC/D,IAAsB,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;wBACrC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;oBACpB,CAAC;gBACH,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC,CAAC,CAAC;YACH,YAAY,CAAC,CAAC,IAAI,EAAE,EAAE;gBACpB,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;oBAAE,OAAO,IAAI,CAAC;gBACtC,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;gBACxB,KAAK,MAAM,CAAC,IAAI,OAAO;oBAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBAClC,OAAO,CAAC,CAAC;YACX,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,CAAU,EAAE,EAAE;YACpB,IAAI,EAAE,KAAK,SAAS,CAAC,OAAO;gBAAE,OAAO;YACrC,QAAQ,CAAC,CAAC,CAAC,CAAC;QACd,CAAC,CAAC;aACD,OAAO,CAAC,GAAG,EAAE;YACZ,IAAI,EAAE,KAAK,SAAS,CAAC,OAAO;gBAAE,UAAU,CAAC,KAAK,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;IACP,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC;IAEpB,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,IAAI,OAAO;YAAE,GAAG,EAAE,CAAC;IAGrB,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAEd,MAAM,WAAW,GAAG,IAAA,mBAAW,EAAC,CAAC,GAAW,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IAElF,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;AAC7G,CAAC"}

package/dist/ui/capture/use-schema-validation.d.ts

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+import { type CaptureFieldSpec, type CaptureSchema, type CaptureSection, type CaptureValues } from './field-spec';
+export interface SchemaValidationResult {
+    readonly errors: Readonly<Record<string, string>>;
+    readonly missingRequired: readonly string[];
+    readonly isValid: boolean;
+}
+type ValidationInput = z.ZodType | CaptureSchema | readonly CaptureFieldSpec[] | readonly CaptureSection[];
+export declare function useSchemaValidation(input: ValidationInput, values: CaptureValues): SchemaValidationResult;
+export {};
+//# sourceMappingURL=use-schema-validation.d.ts.map

package/dist/ui/capture/use-schema-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-schema-validation.d.ts","sourceRoot":"","sources":["../../../src/ui/capture/use-schema-validation.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAoB,KAAK,gBAAgB,EAAE,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAe,MAAM,cAAc,CAAC;AAGjJ,MAAM,WAAW,sBAAsB;IAErC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAElD,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAE5C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,KAAK,eAAe,GAChB,CAAC,CAAC,OAAO,GACT,aAAa,GACb,SAAS,gBAAgB,EAAE,GAC3B,SAAS,cAAc,EAAE,CAAC;AA4C9B,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,aAAa,GAAG,sBAAsB,CAwCzG"}

package/dist/ui/capture/use-schema-validation.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useSchemaValidation = useSchemaValidation;
+const react_1 = require("react");
+const field_spec_1 = require("./field-spec");
+const field_spec_to_zod_1 = require("./field-spec-to-zod");
+function isZodSchema(input) {
+    return typeof input?.safeParse === 'function';
+}
+function sweepMissing(fields, values, prefix = '') {
+    const missing = [];
+    for (const field of fields) {
+        const path = prefix ? `${prefix}.${field.key}` : field.key;
+        const value = values?.[field.key];
+        if (field.type === field_spec_1.CaptureFieldType.Object) {
+            if (field.required && (0, field_spec_to_zod_1.isEmptyValue)(value))
+                missing.push(path);
+            if (value && typeof value === 'object' && !Array.isArray(value)) {
+                missing.push(...sweepMissing(field.fields ?? [], value, path));
+            }
+            continue;
+        }
+        if (field.type === field_spec_1.CaptureFieldType.List) {
+            if (field.required && (0, field_spec_to_zod_1.isEmptyValue)(value))
+                missing.push(path);
+            if (Array.isArray(value)) {
+                value.forEach((item, i) => {
+                    if (item && typeof item === 'object') {
+                        missing.push(...sweepMissing(field.fields ?? [], item, `${path}.${i}`));
+                    }
+                });
+            }
+            continue;
+        }
+        if (field.required && (0, field_spec_to_zod_1.isEmptyValue)(value))
+            missing.push(path);
+    }
+    return missing;
+}
+function useSchemaValidation(input, values) {
+    const fields = (0, react_1.useMemo)(() => (isZodSchema(input) ? null : (0, field_spec_1.toFieldList)(input)), [input]);
+    const schema = (0, react_1.useMemo)(() => (isZodSchema(input) ? input : (0, field_spec_to_zod_1.fieldSpecToZod)(input)), [input]);
+    return (0, react_1.useMemo)(() => {
+        const errors = {};
+        const result = schema.safeParse(values);
+        if (!result.success) {
+            for (const issue of result.error.issues) {
+                const path = issue.path.map(String).join('.');
+                if (!(path in errors))
+                    errors[path] = issue.message;
+            }
+        }
+        const missingRequired = fields
+            ? sweepMissing(fields, values)
+            : Object.keys(errors).filter((path) => {
+                const segments = path.split('.');
+                let cur = values;
+                for (const seg of segments)
+                    cur = cur?.[seg];
+                return (0, field_spec_to_zod_1.isEmptyValue)(cur);
+            });
+        return {
+            errors,
+            missingRequired,
+            isValid: Object.keys(errors).length === 0 && missingRequired.length === 0,
+        };
+    }, [schema, fields, values]);
+}
+//# sourceMappingURL=use-schema-validation.js.map

package/dist/ui/capture/use-schema-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-schema-validation.js","sourceRoot":"","sources":["../../../src/ui/capture/use-schema-validation.ts"],"names":[],"mappings":"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"}

package/dist/ui/capture/use-wizard.d.ts

@@ -0,0 +1,28 @@
+import { FormStepStatus } from '../primitives/form-stepper';
+export interface WizardStepDef {
+    readonly key: string;
+    readonly label: string;
+    readonly hint?: string;
+}
+export interface UseWizardOptions {
+    readonly steps: readonly WizardStepDef[];
+    readonly canAdvance?: (index: number) => boolean;
+    readonly initialStep?: number;
+    readonly step?: number;
+    readonly onStepChange?: (index: number) => void;
+}
+export interface WizardApi {
+    readonly steps: readonly WizardStepDef[];
+    readonly activeIndex: number;
+    readonly activeStep: WizardStepDef;
+    readonly isFirst: boolean;
+    readonly isLast: boolean;
+    readonly canAdvance: boolean;
+    readonly progress: number;
+    readonly next: () => void;
+    readonly prev: () => void;
+    readonly goTo: (index: number) => void;
+    readonly status: (index: number) => FormStepStatus;
+}
+export declare function useWizard(options: UseWizardOptions): WizardApi;
+//# sourceMappingURL=use-wizard.d.ts.map

package/dist/ui/capture/use-wizard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-wizard.d.ts","sourceRoot":"","sources":["../../../src/ui/capture/use-wizard.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE5D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IAMzC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IAEjD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEvB,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACjD;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IACzC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAEzB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAE7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC;IAE1B,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAEvC,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,cAAc,CAAC;CACpD;AAaD,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CAsE9D"}

package/dist/ui/capture/use-wizard.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useWizard = useWizard;
+const react_1 = require("react");
+const form_stepper_1 = require("../primitives/form-stepper");
+function useWizard(options) {
+    const { steps, canAdvance, initialStep = 0, step, onStepChange } = options;
+    const count = steps.length;
+    const clamp = (0, react_1.useCallback)((i) => Math.max(0, Math.min(count - 1, i)), [count]);
+    const isControlled = step !== undefined;
+    const [internal, setInternal] = (0, react_1.useState)(() => clamp(initialStep));
+    const activeIndex = clamp(isControlled ? step : internal);
+    const gate = (0, react_1.useCallback)((i) => (canAdvance ? canAdvance(i) : true), [canAdvance]);
+    const request = (0, react_1.useCallback)((target) => {
+        const next = clamp(target);
+        if (next === activeIndex)
+            return;
+        onStepChange?.(next);
+        if (!isControlled)
+            setInternal(next);
+    }, [activeIndex, clamp, isControlled, onStepChange]);
+    const goTo = (0, react_1.useCallback)((index) => {
+        const target = clamp(index);
+        if (target <= activeIndex) {
+            request(target);
+            return;
+        }
+        for (let i = activeIndex; i < target; i += 1) {
+            if (!gate(i))
+                return;
+        }
+        request(target);
+    }, [activeIndex, clamp, gate, request]);
+    const next = (0, react_1.useCallback)(() => {
+        if (activeIndex >= count - 1)
+            return;
+        if (!gate(activeIndex))
+            return;
+        request(activeIndex + 1);
+    }, [activeIndex, count, gate, request]);
+    const prev = (0, react_1.useCallback)(() => request(activeIndex - 1), [activeIndex, request]);
+    const status = (0, react_1.useCallback)((index) => {
+        if (index < activeIndex)
+            return form_stepper_1.FormStepStatus.DONE;
+        if (index === activeIndex)
+            return form_stepper_1.FormStepStatus.ACTIVE;
+        return form_stepper_1.FormStepStatus.PENDING;
+    }, [activeIndex]);
+    return (0, react_1.useMemo)(() => ({
+        steps,
+        activeIndex,
+        activeStep: steps[activeIndex],
+        isFirst: activeIndex === 0,
+        isLast: activeIndex === count - 1,
+        canAdvance: gate(activeIndex),
+        progress: count <= 1 ? 1 : activeIndex / (count - 1),
+        next,
+        prev,
+        goTo,
+        status,
+    }), [steps, activeIndex, count, gate, next, prev, goTo, status]);
+}
+//# sourceMappingURL=use-wizard.js.map

package/dist/ui/capture/use-wizard.js.map

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

package/dist/ui/capture/value-format.d.ts

@@ -0,0 +1,4 @@
+import { type CaptureFieldSpec } from './field-spec';
+export declare function asString(value: unknown): string;
+export declare function formatScalar(field: CaptureFieldSpec, value: unknown, emptyText: string): string;
+//# sourceMappingURL=value-format.d.ts.map

package/dist/ui/capture/value-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-format.d.ts","sourceRoot":"","sources":["../../../src/ui/capture/value-format.ts"],"names":[],"mappings":"AAGA,OAAO,EAAoB,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGvE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAI/C;AAGD,wBAAgB,YAAY,CAAC,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAQ/F"}

package/dist/ui/capture/value-format.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.asString = asString;
+exports.formatScalar = formatScalar;
+const field_spec_1 = require("./field-spec");
+function asString(value) {
+    if (typeof value === 'string')
+        return value;
+    if (value === undefined || value === null)
+        return '';
+    return String(value);
+}
+function formatScalar(field, value, emptyText) {
+    if (value === undefined || value === null || value === '')
+        return emptyText;
+    switch (field.type) {
+        case field_spec_1.CaptureFieldType.Boolean:
+            return value === true ? 'Yes' : 'No';
+        default:
+            return asString(value);
+    }
+}
+//# sourceMappingURL=value-format.js.map

package/dist/ui/capture/value-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-format.js","sourceRoot":"","sources":["../../../src/ui/capture/value-format.ts"],"names":[],"mappings":";;AAMA,4BAIC;AAGD,oCAQC;AAlBD,6CAAuE;AAGvE,SAAgB,QAAQ,CAAC,KAAc;IACrC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IACrD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAGD,SAAgB,YAAY,CAAC,KAAuB,EAAE,KAAc,EAAE,SAAiB;IACrF,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IAC5E,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,6BAAgB,CAAC,OAAO;YAC3B,OAAO,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;QACvC;YACE,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC"}

package/dist/ui/capture/wizard.d.ts

@@ -0,0 +1,19 @@
+import { type ReactNode } from 'react';
+import type { WizardApi } from './use-wizard';
+export interface WizardStepProps {
+    readonly stepKey: string;
+    readonly children: ReactNode;
+}
+export declare function WizardStep(_props: WizardStepProps): null;
+export interface WizardProps {
+    readonly api: WizardApi;
+    readonly children: ReactNode;
+    readonly onFinish?: () => void;
+    readonly nextLabel?: string;
+    readonly backLabel?: string;
+    readonly finishLabel?: string;
+    readonly hideNav?: boolean;
+    readonly className?: string;
+}
+export declare function Wizard({ api, children, onFinish, nextLabel, backLabel, finishLabel, hideNav, className, }: WizardProps): import("react").JSX.Element;
+//# sourceMappingURL=wizard.d.ts.map

package/dist/ui/capture/wizard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wizard.d.ts","sourceRoot":"","sources":["../../../src/ui/capture/wizard.tsx"],"names":[],"mappings":"AAQA,OAAO,EAA+C,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAMpF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,WAAW,eAAe;IAE9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;CAC9B;AAMD,wBAAgB,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAGxD;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAE7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IAC/B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAaD,wBAAgB,MAAM,CAAC,EACrB,GAAG,EACH,QAAQ,EACR,QAAQ,EACR,SAAsB,EACtB,SAAkB,EAClB,WAAsB,EACtB,OAAe,EACf,SAAS,GACV,EAAE,WAAW,+BAmCb"}

package/dist/ui/capture/wizard.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WizardStep = WizardStep;
+exports.Wizard = Wizard;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const cn_1 = require("../cn");
+const button_1 = require("../primitives/button");
+const form_stepper_1 = require("../primitives/form-stepper");
+function WizardStep(_props) {
+    return null;
+}
+function stepBodies(children) {
+    const map = new Map();
+    react_1.Children.forEach(children, (child) => {
+        if ((0, react_1.isValidElement)(child) && child.props?.stepKey) {
+            const p = child.props;
+            map.set(p.stepKey, p.children);
+        }
+    });
+    return map;
+}
+function Wizard({ api, children, onFinish, nextLabel = 'Continue', backLabel = 'Back', finishLabel = 'Finish', hideNav = false, className, }) {
+    const bodies = stepBodies(children);
+    const formSteps = api.steps.map((step, index) => ({
+        key: step.key,
+        label: step.label,
+        hint: step.hint,
+        status: api.status(index),
+        children: index === api.activeIndex ? bodies.get(step.key) ?? null : null,
+    }));
+    return ((0, jsx_runtime_1.jsxs)("div", { className: (0, cn_1.cn)('space-y-5', className), children: [(0, jsx_runtime_1.jsx)(form_stepper_1.FormStepper, { steps: formSteps }), !hideNav && ((0, jsx_runtime_1.jsxs)("div", { className: "flex items-center justify-between gap-2 border-t border-rule pt-4", children: [(0, jsx_runtime_1.jsx)(button_1.Button, { variant: "ghost", onClick: api.prev, disabled: api.isFirst, children: backLabel }), api.isLast ? ((0, jsx_runtime_1.jsx)(button_1.Button, { onClick: onFinish, disabled: !api.canAdvance, children: finishLabel })) : ((0, jsx_runtime_1.jsx)(button_1.Button, { onClick: api.next, disabled: !api.canAdvance, children: nextLabel }))] }))] }));
+}
+//# sourceMappingURL=wizard.js.map

package/dist/ui/capture/wizard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wizard.js","sourceRoot":"","sources":["../../../src/ui/capture/wizard.tsx"],"names":[],"mappings":";;AA0BA,gCAGC;AA0BD,wBA4CC;;AA3FD,iCAAoF;AAEpF,8BAA2B;AAC3B,iDAA8C;AAC9C,6DAAwE;AAcxE,SAAgB,UAAU,CAAC,MAAuB;IAEhD,OAAO,IAAI,CAAC;AACd,CAAC;AAeD,SAAS,UAAU,CAAC,QAAmB;IACrC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAqB,CAAC;IACzC,gBAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE;QACnC,IAAI,IAAA,sBAAc,EAAC,KAAK,CAAC,IAAK,KAAuC,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC;YACrF,MAAM,CAAC,GAAI,KAAuC,CAAC,KAAK,CAAC;YACzD,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC;QACjC,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAgB,MAAM,CAAC,EACrB,GAAG,EACH,QAAQ,EACR,QAAQ,EACR,SAAS,GAAG,UAAU,EACtB,SAAS,GAAG,MAAM,EAClB,WAAW,GAAG,QAAQ,EACtB,OAAO,GAAG,KAAK,EACf,SAAS,GACG;IACZ,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAEpC,MAAM,SAAS,GAAe,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QAC5D,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC;QAGzB,QAAQ,EAAE,KAAK,KAAK,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI;KAC1E,CAAC,CAAC,CAAC;IAEJ,OAAO,CACL,iCAAK,SAAS,EAAE,IAAA,OAAE,EAAC,WAAW,EAAE,SAAS,CAAC,aACxC,uBAAC,0BAAW,IAAC,KAAK,EAAE,SAAS,GAAI,EAEhC,CAAC,OAAO,IAAI,CACX,iCAAK,SAAS,EAAC,mEAAmE,aAChF,uBAAC,eAAM,IAAC,OAAO,EAAC,OAAO,EAAC,OAAO,EAAE,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,CAAC,OAAO,YAC7D,SAAS,GACH,EACR,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CACZ,uBAAC,eAAM,IAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,UAAU,YACjD,WAAW,GACL,CACV,CAAC,CAAC,CAAC,CACF,uBAAC,eAAM,IAAC,OAAO,EAAE,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,UAAU,YACjD,SAAS,GACH,CACV,IACG,CACP,IACG,CACP,CAAC;AACJ,CAAC"}

package/dist/ui/index.d.ts

@@ -44,4 +44,5 @@ export { default as PageHeader, PageToolbar } from './chrome/PageHeader';
 export { default as LoadingState, type LoadingStateVariant } from './chrome/LoadingState';
 export { default as AsyncBoundary } from './chrome/AsyncBoundary';
 export { PdfPreview, type PdfPreviewProps } from './pdf/pdf-preview';
+export * from './capture';
 //# sourceMappingURL=index.d.ts.map

package/dist/ui/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,EAAE,EAAE,MAAM,MAAM,CAAC;AAG1B,cAAc,iBAAiB,CAAC;AAGhC,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGlD,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGpD,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,OAAO,EACL,kBAAkB,EAClB,KAAK,aAAa,GACnB,MAAM,mCAAmC,CAAC;AAG3C,cAAc,UAAU,CAAC;AAGzB,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,qBAAqB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,GAC7B,MAAM,kCAAkC,CAAC;AAG1C,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,KAAK,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AACtF,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC5G,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACnF,OAAO,EACL,OAAO,IAAI,mBAAmB,EAC9B,KAAK,wBAAwB,GAC9B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EACL,OAAO,IAAI,UAAU,EACrB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,uBAAuB,GAC7B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC1F,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAElE,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,EAAE,EAAE,MAAM,MAAM,CAAC;AAG1B,cAAc,iBAAiB,CAAC;AAGhC,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGlD,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGpD,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,OAAO,EACL,kBAAkB,EAClB,KAAK,aAAa,GACnB,MAAM,mCAAmC,CAAC;AAG3C,cAAc,UAAU,CAAC;AAGzB,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,qBAAqB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,GAC7B,MAAM,kCAAkC,CAAC;AAG1C,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,KAAK,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AACtF,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC5G,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACnF,OAAO,EACL,OAAO,IAAI,mBAAmB,EAC9B,KAAK,wBAAwB,GAC9B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EACL,OAAO,IAAI,UAAU,EACrB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,uBAAuB,GAC7B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC1F,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAElE,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGrE,cAAc,WAAW,CAAC"}

package/dist/ui/index.js

@@ -84,4 +84,5 @@ var AsyncBoundary_1 = require("./chrome/AsyncBoundary");
 Object.defineProperty(exports, "AsyncBoundary", { enumerable: true, get: function () { return __importDefault(AsyncBoundary_1).default; } });
 var pdf_preview_1 = require("./pdf/pdf-preview");
 Object.defineProperty(exports, "PdfPreview", { enumerable: true, get: function () { return pdf_preview_1.PdfPreview; } });
+__exportStar(require("./capture"), exports);
 //# sourceMappingURL=index.js.map

package/dist/ui/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;AAYA,2BAA0B;AAAjB,wFAAA,EAAE,OAAA;AAGX,kDAAgC;AAGhC,6CAAkD;AAAzC,gHAAA,iBAAiB,OAAA;AAG1B,mEAAgE;AAAvD,wHAAA,iBAAiB,OAAA;AAC1B,uDAAoD;AAA3C,4GAAA,WAAW,OAAA;AAGpB,sDAAoC;AACpC,qDAAmC;AACnC,qDAAmC;AACnC,qDAAmC;AACnC,sDAAoC;AACpC,sDAAoC;AACpC,oDAAkC;AAClC,wDAAsC;AACtC,oDAAkC;AAClC,6DAA2C;AAC3C,wDAAsC;AACtC,wDAAsC;AACtC,qDAAmC;AACnC,uDAAqC;AACrC,sDAAoC;AACpC,yDAAuC;AACvC,2DAAyC;AACzC,4DAA0C;AAC1C,uDAAqC;AACrC,2DAAyC;AACzC,yDAAuC;AACvC,2DAAyC;AACzC,6DAA2C;AAC3C,gEAA8C;AAC9C,qDAAmC;AACnC,4DAA0C;AAC1C,8DAA4C;AAC5C,0EAG2C;AAFzC,0HAAA,kBAAkB,OAAA;AAKpB,2CAAyB;AAGzB,0EAM0C;AALxC,4HAAA,mBAAmB,OAAA;AACnB,uHAAA,cAAc,OAAA;AACd,8HAAA,qBAAqB,OAAA;AAMvB,gDAAsF;AAA7E,uHAAA,OAAO,OAAa;AAC7B,sDAA4G;AAAnG,4HAAA,OAAO,OAAe;AAC/B,oDAAmF;AAA1E,0HAAA,OAAO,OAAc;AAC9B,wEAGwC;AAFtC,6IAAA,OAAO,OAAuB;AAGhC,kDAA2D;AAAlD,wHAAA,OAAO,OAAa;AAC7B,kDAK6B;AAJ3B,yHAAA,OAAO,OAAc;AAKvB,gDAA+C;AAAtC,sGAAA,SAAS,OAAA;AAClB,kDAAyE;AAAhE,yHAAA,OAAO,OAAc;AAAE,yGAAA,WAAW,OAAA;AAC3C,sDAA0F;AAAjF,6HAAA,OAAO,OAAgB;AAChC,wDAAkE;AAAzD,+HAAA,OAAO,OAAiB;AAEjC,iDAAqE;AAA5D,yGAAA,UAAU,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;AAYA,2BAA0B;AAAjB,wFAAA,EAAE,OAAA;AAGX,kDAAgC;AAGhC,6CAAkD;AAAzC,gHAAA,iBAAiB,OAAA;AAG1B,mEAAgE;AAAvD,wHAAA,iBAAiB,OAAA;AAC1B,uDAAoD;AAA3C,4GAAA,WAAW,OAAA;AAGpB,sDAAoC;AACpC,qDAAmC;AACnC,qDAAmC;AACnC,qDAAmC;AACnC,sDAAoC;AACpC,sDAAoC;AACpC,oDAAkC;AAClC,wDAAsC;AACtC,oDAAkC;AAClC,6DAA2C;AAC3C,wDAAsC;AACtC,wDAAsC;AACtC,qDAAmC;AACnC,uDAAqC;AACrC,sDAAoC;AACpC,yDAAuC;AACvC,2DAAyC;AACzC,4DAA0C;AAC1C,uDAAqC;AACrC,2DAAyC;AACzC,yDAAuC;AACvC,2DAAyC;AACzC,6DAA2C;AAC3C,gEAA8C;AAC9C,qDAAmC;AACnC,4DAA0C;AAC1C,8DAA4C;AAC5C,0EAG2C;AAFzC,0HAAA,kBAAkB,OAAA;AAKpB,2CAAyB;AAGzB,0EAM0C;AALxC,4HAAA,mBAAmB,OAAA;AACnB,uHAAA,cAAc,OAAA;AACd,8HAAA,qBAAqB,OAAA;AAMvB,gDAAsF;AAA7E,uHAAA,OAAO,OAAa;AAC7B,sDAA4G;AAAnG,4HAAA,OAAO,OAAe;AAC/B,oDAAmF;AAA1E,0HAAA,OAAO,OAAc;AAC9B,wEAGwC;AAFtC,6IAAA,OAAO,OAAuB;AAGhC,kDAA2D;AAAlD,wHAAA,OAAO,OAAa;AAC7B,kDAK6B;AAJ3B,yHAAA,OAAO,OAAc;AAKvB,gDAA+C;AAAtC,sGAAA,SAAS,OAAA;AAClB,kDAAyE;AAAhE,yHAAA,OAAO,OAAc;AAAE,yGAAA,WAAW,OAAA;AAC3C,sDAA0F;AAAjF,6HAAA,OAAO,OAAgB;AAChC,wDAAkE;AAAzD,+HAAA,OAAO,OAAiB;AAEjC,iDAAqE;AAA5D,yGAAA,UAAU,OAAA;AAGnB,4CAA0B"}

package/dist/ui/primitives/badge.d.ts

@@ -1,7 +1,7 @@
 import { type VariantProps } from "class-variance-authority";
 import * as React from "react";
 declare const badgeVariants: (props?: ({
-    variant?: "default" | "outline" | "destructive" | "secondary" | null | undefined;
+    variant?: "default" | "destructive" | "outline" | "secondary" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 export interface BadgeProps extends React.HTMLAttributes<HTMLSpanElement>, VariantProps<typeof badgeVariants> {
 }

package/dist/ui/primitives/button.d.ts

@@ -1,7 +1,7 @@
 import { type VariantProps } from "class-variance-authority";
 import * as React from "react";
 declare const buttonVariants: (props?: ({
-    variant?: "link" | "default" | "outline" | "destructive" | "ghost" | "secondary" | null | undefined;
+    variant?: "link" | "default" | "destructive" | "outline" | "secondary" | "ghost" | null | undefined;
     size?: "icon" | "default" | "sm" | "lg" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 export interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement>, VariantProps<typeof buttonVariants> {

package/dist/ui/primitives/sheet.d.ts

@@ -7,7 +7,7 @@ declare const SheetClose: React.ForwardRefExoticComponent<SheetPrimitive.DialogC
 declare const SheetPortal: React.FC<SheetPrimitive.DialogPortalProps>;
 declare const SheetOverlay: React.ForwardRefExoticComponent<Omit<SheetPrimitive.DialogOverlayProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
 declare const sheetVariants: (props?: ({
-    side?: "left" | "right" | "bottom" | "top" | null | undefined;
+    side?: "bottom" | "left" | "right" | "top" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 interface SheetContentProps extends React.ComponentPropsWithoutRef<typeof SheetPrimitive.Content>, VariantProps<typeof sheetVariants> {
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xemahq/ui-kernel",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "description": "Host-framework-agnostic UI kernel for the Xema OS. Defines the SystemBus orchestration contract (capability.invoke, cross-biome intents, command palette, xema:// deeplinks, window manager) AND the biome-host contract surface (FrontendBiome/FrontendBiomeFactory, HostBridge, the singleton biomeRegistry, session contributions) that every frontend biome composes against. No Vite, Next.js, or React-Router — React itself IS allowed as the shared component model (the contracts traffic in ReactNode/ComponentType and a React context). Concrete host adapters (router/auth/toast wiring) live in separate packages that consume this kernel. The SystemBus is pure orchestration: it never authorizes, the backend capability-router enforces all policy.",
   "keywords": [
     "xema",
@@ -55,7 +55,8 @@
     "lucide-react": "^0.462.0",
     "react-pdf": "^9.1.1",
     "react-resizable-panels": "^4.9.0",
-    "tailwind-merge": "^2.5.4"
+    "tailwind-merge": "^2.5.4",
+    "zod": "^4.4.3"
   },
   "peerDependencies": {
     "@tanstack/react-query": "^5.0.0",
@@ -74,7 +75,7 @@
     "prettier": "3.6.2",
     "react": "^18.3.1",
     "typescript": "5.9.3",
-    "@xemahq/kernel-contracts": "^0.36.0"
+    "@xemahq/kernel-contracts": "^0.39.0"
   },
   "exports": {
     ".": {

package/src/index.ts

@@ -1,3 +1,8 @@
 export * from './lib/system-bus';
 export * from './lib/biome-host';
 export * from './lib/capabilities';
+
+// Guided-capture UX kit (B5). Also available at the `@xemahq/ui-kernel/ui`
+// subpath alongside the rest of the shared UI surface; re-exported here so the
+// capture primitives are reachable from the package root too.
+export * from './ui/capture';

package/src/ui/capture/document-preview.tsx

@@ -0,0 +1,101 @@
+// ═══════════════════════════════════════════════════════════════════════════
+// <DocumentPreview> — read-only "final document" view for the review step
+//
+// Renders a structured record as the document it will become — grouped by
+// section, one labelled row per field, nested objects/lists expanded inline.
+// Presentational + theme-aware (semantic tokens, light/dark) + responsive.
+// Feed it the SAME schema you gave `<SchemaForm>` so the review mirrors input.
+// ═══════════════════════════════════════════════════════════════════════════
+import { type ReactNode } from 'react';
+
+import { cn } from '../cn';
+
+import { CaptureFieldType, type CaptureFieldSpec, type CaptureSchema, type CaptureSection, type CaptureValues, toSections } from './field-spec';
+import { formatScalar } from './value-format';
+
+export interface DocumentPreviewProps {
+  readonly fields?: readonly CaptureFieldSpec[];
+  readonly sections?: readonly CaptureSection[];
+  readonly schema?: CaptureSchema;
+  readonly values: CaptureValues;
+  readonly title?: string;
+  /** Text shown for an unset field (default "—"). */
+  readonly emptyText?: string;
+  readonly className?: string;
+}
+
+/**
+ * @example
+ * <DocumentPreview title="Review" sections={sections} values={values} />
+ */
+export function DocumentPreview({ fields, sections, schema, values, title, emptyText = '—', className }: DocumentPreviewProps) {
+  const resolved = toSections(sections ?? (fields ? fields : schema) ?? []);
+  return (
+    <article className={cn('rounded-xl border border-border bg-card p-5 text-card-foreground shadow-sm sm:p-6', className)}>
+      {title ? <h2 className="mb-4 text-title font-semibold tracking-tight text-ink">{title}</h2> : null}
+      <div className="space-y-6">
+        {resolved.map((section) => (
+          <section key={section.key}>
+            {section.title ? <h3 className="mb-2 border-b border-rule pb-1 text-caption font-semibold uppercase tracking-wider text-ink-3">{section.title}</h3> : null}
+            <dl className="grid grid-cols-1 gap-x-6 gap-y-3 sm:grid-cols-[minmax(8rem,12rem)_1fr]">
+              {section.fields.map((field) => (
+                <FieldRow key={field.key} field={field} value={values[field.key]} emptyText={emptyText} />
+              ))}
+            </dl>
+          </section>
+        ))}
+      </div>
+    </article>
+  );
+}
+
+function FieldRow({ field, value, emptyText }: { field: CaptureFieldSpec; value: unknown; emptyText: string }) {
+  return (
+    <>
+      <dt className="text-body-1 font-medium text-ink-3 sm:text-right">{field.label}</dt>
+      <dd className="min-w-0 text-body-1 text-ink">{renderValue(field, value, emptyText)}</dd>
+    </>
+  );
+}
+
+function renderValue(field: CaptureFieldSpec, value: unknown, emptyText: string): ReactNode {
+  if (field.type === CaptureFieldType.Object) {
+    const record = (value && typeof value === 'object' && !Array.isArray(value) ? value : null) as CaptureValues | null;
+    if (!record) return <span className="text-ink-3">{emptyText}</span>;
+    return (
+      <dl className="space-y-1 rounded-md border border-rule bg-paper-elev/40 p-2">
+        {(field.fields ?? []).map((child) => (
+          <div key={child.key} className="flex flex-wrap gap-2">
+            <dt className="text-caption font-medium text-ink-3">{child.label}:</dt>
+            <dd className="text-caption text-ink">{renderValue(child, record[child.key], emptyText)}</dd>
+          </div>
+        ))}
+      </dl>
+    );
+  }
+  if (field.type === CaptureFieldType.List) {
+    const items = (Array.isArray(value) ? value : []) as CaptureValues[];
+    if (items.length === 0) return <span className="text-ink-3">{emptyText}</span>;
+    return (
+      <ol className="space-y-2">
+        {items.map((item, index) => (
+          <li key={index} className="rounded-md border border-rule bg-paper-elev/40 p-2">
+            <p className="mb-1 text-caption font-medium text-ink-3">
+              {field.label} #{index + 1}
+            </p>
+            <dl className="space-y-1">
+              {(field.fields ?? []).map((child) => (
+                <div key={child.key} className="flex flex-wrap gap-2">
+                  <dt className="text-caption font-medium text-ink-3">{child.label}:</dt>
+                  <dd className="text-caption text-ink">{renderValue(child, item[child.key], emptyText)}</dd>
+                </div>
+              ))}
+            </dl>
+          </li>
+        ))}
+      </ol>
+    );
+  }
+  const text = formatScalar(field, value, emptyText);
+  return <span className={cn(text === emptyText && 'text-ink-3')}>{text}</span>;
+}