@vanstack/solid-ark 0.0.22 → 0.0.23

package/dist/data-table/index.mjs

@@ -1,7 +1,7 @@
 import "../solid-ark.css";
 import { t as e } from "../button-Br_upy12.js";
 import { t } from "../badge-Dt0uZnmA.js";
-import { t as n } from "../form-IwL17HZI.js";
+import { t as n } from "../form-B5rMsobe.js";
 import { t as r } from "../table-Dl0ngdNr.js";
 import { className as i, createComponent as a, effect as o, insert as s, memo as c, setAttribute as l, setStyleProperty as u, template as d, use as f } from "solid-js/web";
 import { For as p, Show as m, createEffect as ee, createMemo as h, createSignal as g, mergeProps as _, on as te, onCleanup as v, onMount as y } from "solid-js";

package/dist/form/index.d.ts

@@ -1,2 +1,2 @@
 export { Form } from './Form';
-export type { DatePickerStoredValue, FieldConfig, FieldControlProps, FieldRule, FieldRuleContext, FormInvalidSubmitProps, FormProps, FormSize, FormSubmitProps, } from './type';
+export type { DatePickerStoredValue, FieldConfig, FieldControlProps, FieldRule, FieldRuleContext, FormExposed, FormInvalidSubmitProps, FormProps, FormSize, FormSubmitProps, } from './type';

package/dist/form/index.mjs

@@ -1,3 +1,3 @@
 import "../solid-ark.css";
-import { t as e } from "../form-IwL17HZI.js";
+import { t as e } from "../form-B5rMsobe.js";
 export { e as Form };

package/dist/form/type.d.ts

@@ -123,6 +123,21 @@ export interface FormSubmitProps<TData extends Record<string, unknown>> {
     /** patch=true 时提供：patch 是否非空 */
     changed?: boolean;
 }
+/** 暴露给外部的表单实例（Form ref） */
+export interface FormExposed<TData extends Record<string, unknown>> {
+    /** 校验全部字段（等待异步规则）；返回是否全部通过，不触发提交 */
+    validate: () => Promise<boolean>;
+    /** 重置表单 */
+    reset: () => void;
+    /** 读取全部字段值（快照副本，非响应式引用） */
+    getFieldValues: () => TData;
+    /** 批量写入字段值（逐字段触发校验与 onValuesChange） */
+    setFieldValues: (values: Partial<TData>) => void;
+    /** 读取字段值 */
+    getFieldValue: (name: string) => unknown;
+    /** 写入字段值 */
+    setFieldValue: (name: string, value: unknown) => void;
+}
 export interface FormProps<TData extends Record<string, unknown>> {
     /** 字段配置 */
     fields: FieldConfig[];
@@ -132,10 +147,13 @@ export interface FormProps<TData extends Record<string, unknown>> {
     onValuesChange?: (values: TData) => void;
     /** 是否计算变更集：默认 false；开启后 onSubmit 额外收到 { patch, changed }（与初始值比较，提交时计算） */
     patch?: boolean;
+    /** 暴露表单实例（Solid ref 语义，挂载时回调一次），用于外部主动校验/提交 */
+    ref?: (api: FormExposed<TData>) => void;
     /** 控件尺寸：small | default（默认）| large，控制 input/textarea/select/datePicker 等输入类控件 */
     size?: FormSize;
     /** 提交回调（仅在校验通过时触发） */
-    onSubmit: (props: FormSubmitProps<TData>) => Promise<void> | void;
+    /** 提交回调（仅在校验通过时触发）；只做展示/受控绑定时可不传 */
+    onSubmit?: (props: FormSubmitProps<TData>) => Promise<void> | void;
     /** 提交被校验拦截时的回调 */
     onSubmitInvalid?: (props: FormInvalidSubmitProps<TData>) => void;
     /** 表单布局 class */

package/dist/{form-IwL17HZI.js → form-B5rMsobe.js}

@@ -466,14 +466,14 @@ function oe(e) {
 			let t = e;
 			if (r.patch) {
 				let { patch: e, changed: n } = ne(l, t, r.fields);
-				await r.onSubmit({
+				await r.onSubmit?.({
 					value: t,
 					patch: e,
 					changed: n
 				});
 				return;
 			}
-			await r.onSubmit({ value: t });
+			await r.onSubmit?.({ value: t });
 		},
 		onSubmitInvalid: ({ value: e, formApi: t }) => {
 			if (!r.onSubmitInvalid) return;
@@ -487,7 +487,18 @@ function oe(e) {
 				errors: n
 			});
 		}
-	})), b = _.useStore((e) => e.isSubmitting), C = _.useStore((e) => e.values), w = _.setFieldValue;
+	}));
+	r.ref?.({
+		validate: async () => (await _.validateAllFields("change"), _.state.canSubmit),
+		reset: () => _.reset(),
+		getFieldValues: () => ({ ..._.state.values }),
+		setFieldValues: (e) => {
+			for (let [t, n] of Object.entries(e)) _.setFieldValue(t, n);
+		},
+		getFieldValue: (e) => _.getFieldValue(e),
+		setFieldValue: (e, t) => _.setFieldValue(e, t)
+	});
+	let b = _.useStore((e) => e.isSubmitting), C = _.useStore((e) => e.values), w = _.setFieldValue;
 	return p(y(() => r.values, (e) => {
 		for (let [t, n] of Object.entries(e ?? {})) _.state.values[t] !== n && w(t, n);
 	}, { defer: !0 })), p(y(C, (e) => r.onValuesChange?.(e), { defer: !0 })), (() => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vanstack/solid-ark",
-  "version": "0.0.22",
+  "version": "0.0.23",
   "private": false,
   "license": "MIT",
   "type": "module",
@@ -71,8 +71,8 @@
     "vite-plugin-solid": "^2.11.0",
     "vitest": "^4.1.10",
     "zod": "^4.4.0",
-    "@vanstack/eslint-config": "0.0.1",
     "@vanstack/prettier-config": "0.0.1",
+    "@vanstack/eslint-config": "0.0.1",
     "@vanstack/tsconfig": "0.0.1",
     "@vanstack/vite-config": "0.0.2"
   },