@vanstack/solid-ark 0.0.1

package/dist/form/components/useDebouncedValue.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 输入防抖：本地值即时回显，onChange 延迟 debounce 毫秒提交；
+ * blur 时立即 flush 未提交值；外部 value 变化（重置/外部同步）同步本地展示。
+ */
+export declare function useDebouncedValue(p: {
+    debounce?: number;
+    onBlur: () => void;
+    onChange: (v: string) => void;
+    /** 值读取函数：保持响应式，外部 value 变化时能同步本地展示 */
+    value: () => unknown;
+}): {
+    local: import('solid-js').Accessor<string>;
+    handleInput: (v: string) => void;
+    handleBlur: () => void;
+    handleClear: () => void;
+};

package/dist/form/components/utils.d.ts

@@ -0,0 +1,6 @@
+import { FieldConfig } from '../type';
+export declare function isFieldType<T extends FieldConfig["fieldType"]>(field: FieldConfig, type: T): field is Extract<FieldConfig, {
+    fieldType: T;
+}>;
+/** 宽度配置 → CSS 值：数字转 px，字符串原样 */
+export declare function toCssWidth(width: number | string | undefined): string | undefined;

package/dist/form/index.d.ts

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

package/dist/form/index.mjs

@@ -0,0 +1,2 @@
+import { t as e } from "../form-TmnHhNkx.js";
+export { e as Form };

package/dist/form/type.d.ts

@@ -0,0 +1,127 @@
+import { JSX } from 'solid-js';
+import { z } from 'zod';
+/** 跨字段校验上下文：可读取其他字段的当前值 */
+export interface FieldRuleContext {
+    value: unknown;
+    /** 读取其他字段当前值，用于跨字段规则 */
+    getValue: (name: string) => unknown;
+}
+/** 校验规则：Zod schema 或同步函数（函数可访问其他字段做跨字段校验） */
+export type FieldRule = ((props: FieldRuleContext) => string | undefined) | z.ZodType;
+interface BaseFieldConfig {
+    name: string;
+    label?: string;
+    helperText?: string;
+    placeholder?: string;
+    /** 字段宽度：数字为 px（如 240），也支持字符串如 "240px" / "100%"；不传时按容器默认 */
+    fieldWidth?: number | string;
+    /** 校验规则：Zod schema 或函数；函数通过 getValue 读取其他字段 */
+    rule?: FieldRule;
+    /** 这些字段变化时重新触发本字段校验（跨字段规则） */
+    validateListenTo?: string[];
+    /** 自定义控件（优先级高于 fieldType） */
+    control?: (props: FieldControlProps) => JSX.Element;
+    /** 自定义 label */
+    renderLabel?: (label: string) => JSX.Element;
+    /** 自定义 error */
+    renderError?: (errors: string[]) => JSX.Element;
+}
+export interface InputFieldConfig extends BaseFieldConfig {
+    fieldType: "input";
+    type?: "email" | "number" | "password" | "tel" | "text" | "url";
+    /** 浏览器自动填充语义，如 "username" / "current-password" / "new-password" */
+    autocomplete?: string;
+    /** 输入防抖毫秒数；> 0 时开启（输入即时回显，onChange/校验延迟触发），默认即时 */
+    debounce?: number;
+    /** 前置内容（图标/文字） */
+    prefix?: JSX.Element | string;
+    /** 后置内容（图标/文字） */
+    suffix?: JSX.Element | string;
+    /** 有值时显示清除按钮，点击清空输入 */
+    clearable?: boolean;
+}
+export interface TextareaFieldConfig extends BaseFieldConfig {
+    fieldType: "textarea";
+    rows?: number;
+    /** 输入防抖毫秒数；> 0 时开启（输入即时回显，onChange/校验延迟触发），默认即时 */
+    debounce?: number;
+}
+export interface SelectFieldConfig extends BaseFieldConfig {
+    fieldType: "select";
+    options: {
+        label: string;
+        value: string;
+    }[];
+    /** 有值时显示清除按钮，点击清空已选值 */
+    clearable?: boolean;
+}
+export interface CheckboxFieldConfig extends BaseFieldConfig {
+    fieldType: "checkbox";
+}
+export interface RadioFieldConfig extends BaseFieldConfig {
+    fieldType: "radio";
+    options: {
+        label: string;
+        value: string;
+    }[];
+}
+export interface SwitchFieldConfig extends BaseFieldConfig {
+    fieldType: "switch";
+}
+export interface CheckboxGroupFieldConfig extends BaseFieldConfig {
+    fieldType: "checkbox-group";
+    options: {
+        label: string;
+        value: string;
+    }[];
+}
+export interface DatePickerFieldConfig extends BaseFieldConfig {
+    fieldType: "datePicker";
+    /** 选择粒度：year | month | week | date | datetime，默认 date */
+    mode?: "date" | "datetime" | "month" | "week" | "year";
+    /** 范围选择，默认 false（datetime 暂不支持 range；week 本身是区间，忽略该配置） */
+    range?: boolean;
+    /** 返回值类型：string=ISO 字符串（默认）；timestamp=UTC 毫秒时间戳 */
+    valueType?: "string" | "timestamp";
+    /** 每周起始日 0=周日…6=周六，week 模式默认 1（周一） */
+    startOfWeek?: number;
+    /** 相邻月份日期是否可点击，默认 true；设为 false 时面板中相邻月份的日期禁用 */
+    outsideDaySelectable?: boolean;
+    /** 区域设置，影响日历星期/月份文案，默认 "zh-CN" */
+    locale?: string;
+    /** 有值时显示清除按钮，点击清空已选值 */
+    clearable?: boolean;
+}
+/** datePicker 字段值：单值为 string/number，范围值为 string[]/number[]，空值单值为 undefined、范围为 [] */
+export type DatePickerStoredValue = number | number[] | string | string[] | undefined;
+export type FieldConfig = CheckboxFieldConfig | CheckboxGroupFieldConfig | DatePickerFieldConfig | InputFieldConfig | RadioFieldConfig | SelectFieldConfig | SwitchFieldConfig | TextareaFieldConfig;
+export interface FieldControlProps {
+    value: unknown;
+    onChange: (value: unknown) => void;
+    onBlur: () => void;
+    error?: string[];
+    id: string;
+}
+export interface FormInvalidSubmitProps<TData extends Record<string, unknown>> {
+    /** 提交被拦截时的表单值 */
+    value: TData;
+    /** 字段名 → 错误消息列表，只包含有错误的字段 */
+    errors: Record<string, string[]>;
+}
+export interface FormProps<TData extends Record<string, unknown>> {
+    /** 字段配置 */
+    fields: FieldConfig[];
+    /** 表单值：挂载时作为初始值；之后引用变化会同步进表单 */
+    values?: Partial<TData>;
+    /** 表单值变化通知：内部值变化（用户输入、外部 values 同步）时触发，配合 values 使用可实现双向绑定 */
+    onValuesChange?: (values: TData) => void;
+    /** 提交回调（仅在校验通过时触发） */
+    onSubmit: (props: {
+        value: TData;
+    }) => Promise<void> | void;
+    /** 提交被校验拦截时的回调 */
+    onSubmitInvalid?: (props: FormInvalidSubmitProps<TData>) => void;
+    /** 表单布局 class */
+    className?: string;
+}
+export {};