@xbeeant/form-engine-react 0.0.3 → 0.0.4

package/dist/es/hooks/use-form-submitting.d.ts

@@ -0,0 +1,7 @@
+import { FormController } from '../components/form-controller';
+/**
+ * useFormSubmitting — 订阅表单提交中状态（formily submitting 对齐）
+ *
+ * submit() 全流程（校验 + onFinish）期间返回 true，供提交按钮展示 loading。
+ */
+export declare function useFormSubmitting(form: FormController): boolean;

package/dist/es/hooks/use-form-submitting.js

@@ -0,0 +1,11 @@
+import { useSyncExternalStore as i } from "react";
+function u(t) {
+  return i(
+    (n) => t.onSubmittingChange(n),
+    () => t.getSubmitting(),
+    () => t.getSubmitting()
+  );
+}
+export {
+  u as useFormSubmitting
+};

package/dist/es/hooks/use-form.d.ts

@@ -0,0 +1,22 @@
+import { NexusEngine } from '@xbeeant/form-engine';
+import { FormController } from '../components/form-controller';
+/**
+ * useForm — 创建 Form 实例
+ *
+ * 一个 Form 绑定一个引擎宿主（引擎为独立实体）：
+ * - 同一 form 引用传给多个 NexusForm → 共享引擎宿主（组件/插件注册共享），
+ *   每个 NexusForm 挂载自动获得独立实例（schema/值/订阅互不影响），
+ *   form 的 API 聚合作用于全部实例
+ * - 需要完全独立的表单：各自 useForm()（独立引擎宿主）
+ *
+ * 支持：
+ * - `useForm()`：创建独立实例（引擎宿主内部创建，未注册，不参与跨表单联动）
+ * - `useForm(formId)`：创建带 formId 的实例，自动注册到默认表单注册表，
+ *   可通过 schema `crossForm` reaction / `engine.linkForm` 与其他表单联动
+ * - `useForm(formId, engine)`：复用外部创建的引擎（如 `new NexusEngine({ formId })`），
+ *   实现多个 form 共享同一引擎宿主
+ *
+ * @param formId - 可选，表单实例唯一标识（跨表单联动寻址）
+ * @param engine - 可选，外部引擎宿主（缺省内部创建）
+ */
+export declare function useForm(formId?: string, engine?: NexusEngine): [FormController];

package/dist/es/hooks/use-form.js

@@ -0,0 +1,12 @@
+import { NexusEngine as n } from "@xbeeant/form-engine";
+import { useRef as t } from "react";
+import { FormController as u } from "../components/form-controller.js";
+function c(e, o) {
+  const r = t(null);
+  return r.current || (r.current = new u(
+    o ?? (e ? new n({ formId: e }) : void 0)
+  )), [r.current];
+}
+export {
+  c as useForm
+};

package/dist/es/hooks/use-nexus-context.d.ts

@@ -0,0 +1,11 @@
+import { NexusEngine } from '@xbeeant/form-engine';
+import { FormController } from '../components/form-controller';
+import { NexusFormConfig } from '../components/nexus-form';
+interface NexusContextValue {
+    engine: NexusEngine;
+    config: NexusFormConfig;
+    form: FormController;
+}
+export declare const NexusContext: import('react').Context<NexusContextValue | null>;
+export declare function useNexusContext(): NexusContextValue;
+export {};

package/dist/es/hooks/use-nexus-context.js

@@ -0,0 +1,12 @@
+import { createContext as t, useContext as o } from "react";
+const r = t(null);
+function u() {
+  const e = o(r);
+  if (!e)
+    throw new Error("[NexusField] Must be used within <NexusFormProvider>");
+  return e;
+}
+export {
+  r as NexusContext,
+  u as useNexusContext
+};

package/dist/es/hooks/use-watch-all.d.ts

@@ -0,0 +1,19 @@
+import { NexusEngine } from '@xbeeant/form-engine';
+/**
+ * useWatchAll Hook - 监听整个表单数据变化
+ *
+ * @param engine - NexusEngine实例
+ * @param callback - 变化回调函数
+ * @param deep - 是否深度比较值（默认false，仅浅比较）
+ *
+ * @example
+ * ```tsx
+ * // 监听整个表单
+ * useWatchAll(engine, (formData) => {
+ *   console.log('Form data changed:', formData);
+ * }, { deep: true });
+ * ```
+ */
+export declare function useWatchAll(engine: NexusEngine | null, callback: (formData: Record<string, unknown>) => void, options?: {
+    deep?: boolean;
+}): Record<string, unknown>;

package/dist/es/hooks/use-watch-all.js

@@ -0,0 +1,29 @@
+import { useRef as n, useEffect as h } from "react";
+function g(c, i, b) {
+  const { deep: l = !1 } = b || {}, t = n({}), e = n({}), u = n(i);
+  return u.current = i, h(() => {
+    if (!c)
+      return;
+    const s = c.getFormData();
+    t.current = s, e.current = s, u.current(s);
+    const d = c.subscribeAll((r) => {
+      if (l)
+        JSON.stringify(r) !== JSON.stringify(t.current) && (t.current = r, e.current = r, u.current(r));
+      else {
+        let f = !1;
+        for (const o in r)
+          if (r[o] !== t.current[o]) {
+            f = !0;
+            break;
+          }
+        f && (t.current = r, e.current = r, u.current(r));
+      }
+    });
+    return () => {
+      d();
+    };
+  }, [c, l]), e.current;
+}
+export {
+  g as useWatchAll
+};

package/dist/es/hooks/use-watch-multiple.d.ts

@@ -0,0 +1,20 @@
+import { NexusEngine } from '@xbeeant/form-engine';
+/**
+ * useWatchMultiple Hook - 监听多个字段值变化
+ *
+ * @param engine - NexusEngine实例
+ * @param paths - 字段路径数组
+ * @param callback - 变化回调函数
+ * @param deep - 是否深度比较值（默认false，仅浅比较）
+ *
+ * @example
+ * ```tsx
+ * // 监听多个字段
+ * const values = useWatchMultiple(engine, ['name', 'email', 'age'], (values) => {
+ *   console.log('Values changed:', values);
+ * }, { deep: true });
+ * ```
+ */
+export declare function useWatchMultiple(engine: NexusEngine | null, paths: string[], callback: (values: Record<string, unknown>) => void, options?: {
+    deep?: boolean;
+}): Record<string, unknown>;

package/dist/es/hooks/use-watch-multiple.js

@@ -0,0 +1,29 @@
+import { useRef as s, useEffect as p } from "react";
+function v(r, u, a, R) {
+  const { deep: l = !1 } = R || {}, o = s({}), e = s({}), f = s(a);
+  f.current = a;
+  const i = s(u);
+  i.current = u;
+  const V = [...u].sort().join(",");
+  return p(() => {
+    if (!r)
+      return;
+    const b = i.current, c = {};
+    for (const t of b)
+      c[t] = r.getFieldValue(t);
+    o.current = c, e.current = c, f.current(c);
+    const h = b.map(
+      (t) => r.subscribe(t, (m) => {
+        const n = m.value, d = o.current[t];
+        (l ? JSON.stringify(n) !== JSON.stringify(d) : n !== d) && (o.current[t] = n, e.current = { [t]: n }, f.current(e.current));
+      })
+    );
+    return () => {
+      for (const t of h)
+        t();
+    };
+  }, [r, l, V]), e.current;
+}
+export {
+  v as useWatchMultiple
+};

package/dist/es/hooks/use-watch-state.d.ts

@@ -0,0 +1,18 @@
+import { FieldState, NexusEngine } from '@xbeeant/form-engine';
+/**
+ * useWatchState Hook - 监听单个字段状态变化
+ *
+ * @param engine - NexusEngine实例
+ * @param path - 字段路径
+ * @param callback - 状态变化回调函数
+ *
+ * @example
+ * ```tsx
+ * // 监听字段状态（visible/disabled/loading等）
+ * const isDisabled = useWatchState(engine, 'email', (state) => {
+ *   console.log('Disabled:', state.disabled);
+ *   console.log('Loading:', state.loading);
+ * });
+ * ```
+ */
+export declare function useWatchState(engine: NexusEngine | null, path: string, callback: (state: FieldState) => void): FieldState;

package/dist/es/hooks/use-watch-state.js

@@ -0,0 +1,19 @@
+import { useRef as n, useEffect as i } from "react";
+function R(r, t, s) {
+  const e = n(void 0), u = n(s);
+  return u.current = s, i(() => {
+    if (!r)
+      return;
+    const c = r.getFieldState(t);
+    e.current = c, c && u.current(c);
+    const o = r.subscribe(t, (f) => {
+      e.current = f, u.current(f);
+    });
+    return () => {
+      o();
+    };
+  }, [r, t]), e.current || {};
+}
+export {
+  R as useWatchState
+};

package/dist/es/hooks/use-watch.d.ts

@@ -0,0 +1,25 @@
+import { NexusEngine } from '@xbeeant/form-engine';
+/**
+ * useWatch Hook - 监听单个字段值变化
+ *
+ * @param engine - NexusEngine实例
+ * @param path - 字段路径
+ * @param callback - 变化回调函数
+ * @param deep - 是否深度比较值（默认false，仅浅比较）
+ *
+ * @example
+ * ```tsx
+ * // 监听单个字段
+ * const name = useWatch(engine, 'profile.name', (value) => {
+ *   console.log('Name changed:', value);
+ * });
+ *
+ * // 深度比较对象
+ * const profile = useWatch(engine, 'profile', (value) => {
+ *   console.log('Profile changed:', value);
+ * }, { deep: true });
+ * ```
+ */
+export declare function useWatch(engine: NexusEngine | null, path: string, callback: (value: unknown) => void, options?: {
+    deep?: boolean;
+}): unknown;

package/dist/es/hooks/use-watch.js

@@ -0,0 +1,20 @@
+import { useRef as f, useEffect as d } from "react";
+function J(e, c, o, i) {
+  const { deep: n = !1 } = i || {}, r = f(void 0), s = f(o);
+  return s.current = o, d(() => {
+    if (!e)
+      return;
+    const t = e.getFieldValue(c);
+    r.current === void 0 && (r.current = t), (n ? JSON.stringify(t) !== JSON.stringify(r.current) : t !== r.current) && (r.current = t, s.current(t));
+    const l = e.subscribe(c, (a) => {
+      const u = a.value;
+      (n ? JSON.stringify(u) !== JSON.stringify(r.current) : u !== r.current) && (r.current = u, s.current(u));
+    });
+    return () => {
+      l();
+    };
+  }, [e, c, n]), r.current;
+}
+export {
+  J as useWatch
+};

package/dist/es/hooks/useForm.d.ts

@@ -3,13 +3,20 @@ import { FormController } from '../components/FormController';
 /**
  * useForm — 创建 Form 实例
  *
- * 支持一个页面挂载多个表单实例：
- * - `useForm()`：独立实例（未注册，不参与跨表单联动）
+ * 一个 Form 绑定一个引擎宿主（引擎为独立实体）：
+ * - 同一 form 引用传给多个 NexusForm → 共享引擎宿主（组件/插件注册共享），
+ *   每个 NexusForm 挂载自动获得独立实例（schema/值/订阅互不影响），
+ *   form 的 API 聚合作用于全部实例
+ * - 需要完全独立的表单：各自 useForm()（独立引擎宿主）
+ *
+ * 支持：
+ * - `useForm()`：创建独立实例（引擎宿主内部创建，未注册，不参与跨表单联动）
  * - `useForm(formId)`：创建带 formId 的实例，自动注册到默认表单注册表，
  *   可通过 schema `crossForm` reaction / `engine.linkForm` 与其他表单联动
- * - `useForm(formId, engine)`：复用外部创建的引擎（如 `new NexusEngine({ formId })`）
+ * - `useForm(formId, engine)`：复用外部创建的引擎（如 `new NexusEngine({ formId })`），
+ *   实现多个 form 共享同一引擎宿主
  *
  * @param formId - 可选，表单实例唯一标识（跨表单联动寻址）
- * @param engine - 可选，外部引擎实例（缺省内部创建）
+ * @param engine - 可选，外部引擎宿主（缺省内部创建）
  */
 export declare function useForm(formId?: string, engine?: NexusEngine): [FormController];

package/dist/es/hooks/useFormData.js

@@ -1,13 +1,13 @@
-import { useSyncExternalStore as o, useMemo as n } from "react";
-import { useEngine as r } from "./useEngine.js";
-function i() {
-  const e = r(), t = o(
-    e.subscribeStore,
-    e.getSnapshot,
-    e.getSnapshot
+import { useSyncExternalStore as n, useMemo as r } from "react";
+import { useEngine as s } from "./useEngine.js";
+function m() {
+  const e = s(), t = n(
+    (o) => e.subscribeStore(o),
+    () => e.getSnapshot(),
+    () => e.getSnapshot()
   );
-  return n(() => e.getFormData(), [e, t]);
+  return r(() => e.getFormData(), [e, t]);
 }
 export {
-  i as useFormData
+  m as useFormData
 };

package/dist/es/hooks/useFormSubmitting.d.ts

@@ -0,0 +1,7 @@
+import { FormController } from '../components/FormController';
+/**
+ * useFormSubmitting — 订阅表单提交中状态（formily submitting 对齐）
+ *
+ * submit() 全流程（校验 + onFinish）期间返回 true，供提交按钮展示 loading。
+ */
+export declare function useFormSubmitting(form: FormController): boolean;

package/dist/es/hooks/useFormSubmitting.js

@@ -0,0 +1,11 @@
+import { useSyncExternalStore as i } from "react";
+function u(t) {
+  return i(
+    (n) => t.onSubmittingChange(n),
+    () => t.getSubmitting(),
+    () => t.getSubmitting()
+  );
+}
+export {
+  u as useFormSubmitting
+};

package/dist/es/index.d.ts

@@ -1,24 +1,26 @@
-export { FormController } from './components/FormController';
-export { NexusField } from './components/NexusField';
-export type { NexusFormConfig } from './components/NexusForm';
-export { NexusForm } from './components/NexusForm';
-export { NexusFormProvider } from './components/NexusFormProvider';
-export { NexusLayout } from './components/NexusLayout';
-export { NexusObject } from './components/NexusObject';
-export type { FieldInheritValue } from './contexts/FieldInheritContext';
-export { FieldInheritContext } from './contexts/FieldInheritContext';
-export type { GridContextValue } from './contexts/GridContext';
-export { GridContext } from './contexts/GridContext';
-export type { LayoutConfigContextValue } from './contexts/LayoutConfigContext';
-export { LayoutConfigContext } from './contexts/LayoutConfigContext';
-export { useEngine } from './hooks/useEngine';
-export { useFieldState } from './hooks/useFieldState';
-export { useFieldValidator } from './hooks/useFieldValidator';
-export { useFieldValue } from './hooks/useFieldValue';
-export { useForm } from './hooks/useForm';
-export { useFormConfig } from './hooks/useFormConfig';
-export { useFormData } from './hooks/useFormData';
-export { useWatch } from './hooks/useWatch';
-export { useWatchAll } from './hooks/useWatchAll';
-export { useWatchMultiple } from './hooks/useWatchMultiple';
-export { useWatchState } from './hooks/useWatchState';
+export { FormController } from './components/form-controller';
+export { NexusField } from './components/nexus-field';
+export type { NexusFormConfig, NexusFormProps } from './components/nexus-form';
+export { NexusForm } from './components/nexus-form';
+export { NexusFormProvider } from './components/nexus-form-provider';
+export { NexusLayout } from './components/nexus-layout';
+export { NexusObject } from './components/nexus-object';
+export type { FieldInheritValue } from './contexts/field-inherit-context';
+export { FieldInheritContext } from './contexts/field-inherit-context';
+export type { GridContextValue } from './contexts/grid-context';
+export { GridContext } from './contexts/grid-context';
+export type { LayoutConfigContextValue } from './contexts/layout-config-context';
+export { LayoutConfigContext } from './contexts/layout-config-context';
+export { NexusContext } from './contexts/nexus-context';
+export { useEngine } from './hooks/use-engine';
+export { useFieldState } from './hooks/use-field-state';
+export { useFieldValidator } from './hooks/use-field-validator';
+export { useFieldValue } from './hooks/use-field-value';
+export { useForm } from './hooks/use-form';
+export { useFormConfig } from './hooks/use-form-config';
+export { useFormData } from './hooks/use-form-data';
+export { useFormSubmitting } from './hooks/use-form-submitting';
+export { useWatch } from './hooks/use-watch';
+export { useWatchAll } from './hooks/use-watch-all';
+export { useWatchMultiple } from './hooks/use-watch-multiple';
+export { useWatchState } from './hooks/use-watch-state';

package/dist/es/index.js

@@ -1,43 +1,47 @@
 import './styles.css';/* empty css           */
-import { FormController as t } from "./components/FormController.js";
-import { NexusField as m } from "./components/NexusField.js";
-import { NexusForm as p } from "./components/NexusForm.js";
-import { NexusFormProvider as s } from "./components/NexusFormProvider.js";
-import { NexusLayout as a } from "./components/NexusLayout.js";
-import { NexusObject as F } from "./components/NexusObject.js";
-import { FieldInheritContext as d } from "./contexts/FieldInheritContext.js";
-import { GridContext as c } from "./contexts/GridContext.js";
-import { LayoutConfigContext as N } from "./contexts/LayoutConfigContext.js";
-import { useEngine as g } from "./hooks/useEngine.js";
-import { useFieldState as L } from "./hooks/useFieldState.js";
-import { useFieldValidator as V } from "./hooks/useFieldValidator.js";
-import { useFieldValue as j } from "./hooks/useFieldValue.js";
-import { useForm as A } from "./hooks/useForm.js";
-import { useFormConfig as E } from "./hooks/useFormConfig.js";
-import { useFormData as I } from "./hooks/useFormData.js";
-import { useWatch as O } from "./hooks/useWatch.js";
-import { useWatchAll as k } from "./hooks/useWatchAll.js";
-import { useWatchMultiple as w } from "./hooks/useWatchMultiple.js";
-import { useWatchState as B } from "./hooks/useWatchState.js";
+import { FormController as t } from "./components/form-controller.js";
+import { NexusField as m } from "./components/nexus-field.js";
+import { NexusForm as p } from "./components/nexus-form.js";
+import { NexusFormProvider as s } from "./components/nexus-form-provider.js";
+import { NexusLayout as a } from "./components/nexus-layout.js";
+import { NexusObject as F } from "./components/nexus-object.js";
+import { FieldInheritContext as d } from "./contexts/field-inherit-context.js";
+import { GridContext as N } from "./contexts/grid-context.js";
+import { LayoutConfigContext as h } from "./contexts/layout-config-context.js";
+import { NexusContext as W } from "./contexts/nexus-context.js";
+import { useEngine as b } from "./hooks/use-engine.js";
+import { useFieldState as L } from "./hooks/use-field-state.js";
+import { useFieldValidator as j } from "./hooks/use-field-validator.js";
+import { useFieldValue as A } from "./hooks/use-field-value.js";
+import { useForm as E } from "./hooks/use-form.js";
+import { useFormConfig as I } from "./hooks/use-form-config.js";
+import { useFormData as O } from "./hooks/use-form-data.js";
+import { useFormSubmitting as k } from "./hooks/use-form-submitting.js";
+import { useWatch as w } from "./hooks/use-watch.js";
+import { useWatchAll as B } from "./hooks/use-watch-all.js";
+import { useWatchMultiple as J } from "./hooks/use-watch-multiple.js";
+import { useWatchState as Q } from "./hooks/use-watch-state.js";
 export {
   d as FieldInheritContext,
   t as FormController,
-  c as GridContext,
-  N as LayoutConfigContext,
+  N as GridContext,
+  h as LayoutConfigContext,
+  W as NexusContext,
   m as NexusField,
   p as NexusForm,
   s as NexusFormProvider,
   a as NexusLayout,
   F as NexusObject,
-  g as useEngine,
+  b as useEngine,
   L as useFieldState,
-  V as useFieldValidator,
-  j as useFieldValue,
-  A as useForm,
-  E as useFormConfig,
-  I as useFormData,
-  O as useWatch,
-  k as useWatchAll,
-  w as useWatchMultiple,
-  B as useWatchState
+  j as useFieldValidator,
+  A as useFieldValue,
+  E as useForm,
+  I as useFormConfig,
+  O as useFormData,
+  k as useFormSubmitting,
+  w as useWatch,
+  B as useWatchAll,
+  J as useWatchMultiple,
+  Q as useWatchState
 };

package/dist/es/styles.css

@@ -1 +1 @@
-@layer properties{@supports (((-webkit-hyphens:none)) and (not (margin-trim:inline))) or ((-moz-orient:inline) and (not (color:rgb(from red r g b)))){*,:before,:after,::backdrop{--tw-font-weight:initial;--tw-blur:initial;--tw-brightness:initial;--tw-contrast:initial;--tw-grayscale:initial;--tw-hue-rotate:initial;--tw-invert:initial;--tw-opacity:initial;--tw-saturate:initial;--tw-sepia:initial;--tw-drop-shadow:initial;--tw-drop-shadow-color:initial;--tw-drop-shadow-alpha:100%;--tw-drop-shadow-size:initial;--tw-duration:initial;--tw-ease:initial}}}:root,:host{--color-red-500:oklch(63.7% .237 25.331);--spacing:.25rem;--text-xs:.75rem;--text-xs--line-height:calc(1 / .75);--font-weight-bold:700;--ease-in-out:cubic-bezier(.4, 0, .2, 1);--default-transition-duration:.15s;--default-transition-timing-function:cubic-bezier(.4, 0, .2, 1)}.visible{visibility:visible}.mt-4{margin-top:calc(var(--spacing) * 4)}.mb-2{margin-bottom:calc(var(--spacing) * 2)}.mb-4{margin-bottom:calc(var(--spacing) * 4)}.block{display:block}.flex{display:flex}.grid{display:grid}.hidden{display:none}.inline{display:inline}.rotate-0{rotate:0deg}.rotate-90{rotate:90deg}.cursor-pointer{cursor:pointer}.gap-1{gap:var(--spacing)}.gap-x-4{column-gap:calc(var(--spacing) * 4)}.border-none{--tw-border-style:none;border-style:none}.bg-transparent{background-color:#0000}.p-0{padding:0}.align-middle{vertical-align:middle}.text-xs{font-size:var(--text-xs);line-height:var(--tw-leading,var(--text-xs--line-height))}.font-bold{--tw-font-weight:var(--font-weight-bold);font-weight:var(--font-weight-bold)}.text-red-500{color:var(--color-red-500)}.blur{--tw-blur:blur(8px);filter:var(--tw-blur,) var(--tw-brightness,) var(--tw-contrast,) var(--tw-grayscale,) var(--tw-hue-rotate,) var(--tw-invert,) var(--tw-saturate,) var(--tw-sepia,) var(--tw-drop-shadow,)}.transition-transform{transition-property:transform,translate,scale,rotate;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.duration-200{--tw-duration:.2s;transition-duration:.2s}.ease-in-out{--tw-ease:var(--ease-in-out);transition-timing-function:var(--ease-in-out)}.select-none{-webkit-user-select:none;user-select:none}@property --tw-font-weight{syntax:"*";inherits:false}@property --tw-blur{syntax:"*";inherits:false}@property --tw-brightness{syntax:"*";inherits:false}@property --tw-contrast{syntax:"*";inherits:false}@property --tw-grayscale{syntax:"*";inherits:false}@property --tw-hue-rotate{syntax:"*";inherits:false}@property --tw-invert{syntax:"*";inherits:false}@property --tw-opacity{syntax:"*";inherits:false}@property --tw-saturate{syntax:"*";inherits:false}@property --tw-sepia{syntax:"*";inherits:false}@property --tw-drop-shadow{syntax:"*";inherits:false}@property --tw-drop-shadow-color{syntax:"*";inherits:false}@property --tw-drop-shadow-alpha{syntax:"<percentage>";inherits:false;initial-value:100%}@property --tw-drop-shadow-size{syntax:"*";inherits:false}@property --tw-duration{syntax:"*";inherits:false}@property --tw-ease{syntax:"*";inherits:false}
+@layer properties{@supports (((-webkit-hyphens:none)) and (not (margin-trim:inline))) or ((-moz-orient:inline) and (not (color:rgb(from red r g b)))){*,:before,:after,::backdrop{--tw-font-weight:initial;--tw-blur:initial;--tw-brightness:initial;--tw-contrast:initial;--tw-grayscale:initial;--tw-hue-rotate:initial;--tw-invert:initial;--tw-opacity:initial;--tw-saturate:initial;--tw-sepia:initial;--tw-drop-shadow:initial;--tw-drop-shadow-color:initial;--tw-drop-shadow-alpha:100%;--tw-drop-shadow-size:initial;--tw-duration:initial;--tw-ease:initial}}}:root,:host{--color-red-500:oklch(63.7% .237 25.331);--spacing:.25rem;--text-xs:.75rem;--text-xs--line-height:calc(1 / .75);--font-weight-bold:700;--ease-in-out:cubic-bezier(.4, 0, .2, 1);--default-transition-duration:.15s;--default-transition-timing-function:cubic-bezier(.4, 0, .2, 1)}.visible{visibility:visible}.container{width:100%}@media(min-width:40rem){.container{max-width:40rem}}@media(min-width:48rem){.container{max-width:48rem}}@media(min-width:64rem){.container{max-width:64rem}}@media(min-width:80rem){.container{max-width:80rem}}@media(min-width:96rem){.container{max-width:96rem}}.mt-4{margin-top:calc(var(--spacing) * 4)}.mb-2{margin-bottom:calc(var(--spacing) * 2)}.mb-4{margin-bottom:calc(var(--spacing) * 4)}.block{display:block}.flex{display:flex}.grid{display:grid}.hidden{display:none}.inline{display:inline}.rotate-0{rotate:0deg}.rotate-90{rotate:90deg}.cursor-pointer{cursor:pointer}.gap-1{gap:var(--spacing)}.gap-x-4{column-gap:calc(var(--spacing) * 4)}.border-none{--tw-border-style:none;border-style:none}.bg-transparent{background-color:#0000}.p-0{padding:0}.align-middle{vertical-align:middle}.text-xs{font-size:var(--text-xs);line-height:var(--tw-leading,var(--text-xs--line-height))}.font-bold{--tw-font-weight:var(--font-weight-bold);font-weight:var(--font-weight-bold)}.text-red-500{color:var(--color-red-500)}.blur{--tw-blur:blur(8px);filter:var(--tw-blur,) var(--tw-brightness,) var(--tw-contrast,) var(--tw-grayscale,) var(--tw-hue-rotate,) var(--tw-invert,) var(--tw-saturate,) var(--tw-sepia,) var(--tw-drop-shadow,)}.transition-transform{transition-property:transform,translate,scale,rotate;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.duration-200{--tw-duration:.2s;transition-duration:.2s}.ease-in-out{--tw-ease:var(--ease-in-out);transition-timing-function:var(--ease-in-out)}.select-none{-webkit-user-select:none;user-select:none}@property --tw-font-weight{syntax:"*";inherits:false}@property --tw-blur{syntax:"*";inherits:false}@property --tw-brightness{syntax:"*";inherits:false}@property --tw-contrast{syntax:"*";inherits:false}@property --tw-grayscale{syntax:"*";inherits:false}@property --tw-hue-rotate{syntax:"*";inherits:false}@property --tw-invert{syntax:"*";inherits:false}@property --tw-opacity{syntax:"*";inherits:false}@property --tw-saturate{syntax:"*";inherits:false}@property --tw-sepia{syntax:"*";inherits:false}@property --tw-drop-shadow{syntax:"*";inherits:false}@property --tw-drop-shadow-color{syntax:"*";inherits:false}@property --tw-drop-shadow-alpha{syntax:"<percentage>";inherits:false;initial-value:100%}@property --tw-drop-shadow-size{syntax:"*";inherits:false}@property --tw-duration{syntax:"*";inherits:false}@property --tw-ease{syntax:"*";inherits:false}

package/dist/es/utils/omit-nil.d.ts

@@ -0,0 +1,9 @@
+/**
+ * omitNilDeep — 递归移除空值（undefined / null / ''）
+ *
+ * ProForm omitNil 对齐：提交/取值时过滤掉未填写的空值字段。
+ * - 对象：移除值为空的键（递归处理嵌套对象）
+ * - 数组：逐项递归处理（保留数组结构与长度）
+ * - 0 / false / NaN 等非空值保留
+ */
+export declare function omitNilDeep(value: unknown): unknown;

package/dist/es/utils/omit-nil.js

@@ -0,0 +1,14 @@
+function i(t) {
+  if (Array.isArray(t))
+    return t.map((r) => i(r));
+  if (t !== null && typeof t == "object") {
+    const r = {};
+    for (const [o, n] of Object.entries(t))
+      n == null || n === "" || (r[o] = i(n));
+    return r;
+  }
+  return t;
+}
+export {
+  i as omitNilDeep
+};

package/dist/es/utils/omitNil.d.ts

@@ -0,0 +1,9 @@
+/**
+ * omitNilDeep — 递归移除空值（undefined / null / ''）
+ *
+ * ProForm omitNil 对齐：提交/取值时过滤掉未填写的空值字段。
+ * - 对象：移除值为空的键（递归处理嵌套对象）
+ * - 数组：逐项递归处理（保留数组结构与长度）
+ * - 0 / false / NaN 等非空值保留
+ */
+export declare function omitNilDeep(value: unknown): unknown;

package/dist/es/utils/omitNil.js

@@ -0,0 +1,14 @@
+function i(t) {
+  if (Array.isArray(t))
+    return t.map((r) => i(r));
+  if (t !== null && typeof t == "object") {
+    const r = {};
+    for (const [o, n] of Object.entries(t))
+      n == null || n === "" || (r[o] = i(n));
+    return r;
+  }
+  return t;
+}
+export {
+  i as omitNilDeep
+};

package/dist/es/utils/persist.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 表单草稿持久化（NexusForm persist 选项实现）
+ *
+ * 将表单数据自动保存到 Web Storage（localStorage / sessionStorage），
+ * 下次挂载时自动恢复为初始值（草稿续填）。
+ *
+ * 约束：
+ * - 所有存储访问均 try/catch 包裹（SSR 无 window / Safari 隐私模式抛错）
+ * - 存储键为完整路径前缀，避免多表单实例冲突
+ * - 提交成功后默认清除草稿（clearOnSubmit: false 可关闭）
+ */
+export interface PersistOptions {
+    /** 存储键（必填，多表单实例需唯一） */
+    key: string;
+    /** 存储介质，默认 localStorage */
+    storage?: 'localStorage' | 'sessionStorage';
+    /** 保存防抖毫秒数，默认 300 */
+    debounce?: number;
+    /** 提交成功后清除草稿，默认 true */
+    clearOnSubmit?: boolean;
+}
+export declare function loadPersisted(options: PersistOptions): Record<string, unknown> | undefined;
+export declare function savePersisted(options: PersistOptions, data: Record<string, unknown>): void;
+export declare function clearPersisted(options: PersistOptions): void;

package/dist/es/utils/persist.js

@@ -0,0 +1,43 @@
+function s(t) {
+  if (!(typeof window > "u"))
+    try {
+      const e = t === "sessionStorage" ? window.sessionStorage : window.localStorage;
+      return e.setItem("__nexus_persist_probe__", "1"), e.removeItem("__nexus_persist_probe__"), e;
+    } catch {
+      return;
+    }
+}
+function n(t) {
+  const e = s(t.storage);
+  if (e)
+    try {
+      const r = e.getItem(t.key);
+      if (!r)
+        return;
+      const o = JSON.parse(r);
+      return typeof o == "object" && o !== null ? o : void 0;
+    } catch {
+      return;
+    }
+}
+function i(t, e) {
+  const r = s(t.storage);
+  if (r)
+    try {
+      r.setItem(t.key, JSON.stringify(e));
+    } catch {
+    }
+}
+function a(t) {
+  const e = s(t.storage);
+  if (e)
+    try {
+      e.removeItem(t.key);
+    } catch {
+    }
+}
+export {
+  a as clearPersisted,
+  n as loadPersisted,
+  i as savePersisted
+};

package/dist/es/utils/render-tree-node.d.ts

@@ -0,0 +1,6 @@
+import { RenderTreeNode } from '@xbeeant/form-engine';
+import { ReactElement } from 'react';
+/**
+ * renderTreeNode — 递归渲染
+ */
+export declare function renderTreeNode(node: RenderTreeNode, index: number): ReactElement;

package/dist/es/utils/render-tree-node.js

@@ -0,0 +1,17 @@
+import { jsx as r } from "react/jsx-runtime";
+import { NexusField as e } from "../components/nexus-field.js";
+import { NexusLayout as u } from "../components/nexus-layout.js";
+import { NexusObject as y } from "../components/nexus-object.js";
+function p(t, a) {
+  return t.type === "field" ? /* @__PURE__ */ r(
+    e,
+    {
+      dataPath: t.dataPath,
+      layoutKey: t.layoutKey
+    },
+    t.layoutKey || t.dataPath
+  ) : t.type === "object" ? /* @__PURE__ */ r(y, { node: t }, `object-${t.layoutKey}-${a}`) : /* @__PURE__ */ r(u, { node: t }, `layout-${t.type}-${a}`);
+}
+export {
+  p as renderTreeNode
+};