@chenzy-design/svelte 0.1.0

package/dist/form/FormTreeSelect.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormTreeSelect.svelte.d.ts","sourceRoot":"","sources":["../../src/form/FormTreeSelect.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAE7C,OAAO,UAAU,MAAM,kCAAkC,CAAC;AAGxD,KAAK,eAAe,GAAG,cAAc,CAAC,OAAO,UAAU,CAAC,CAAC;AAEzD,UAAU,KAAK;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;IACzE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,eAAe,GAAG,eAAe,EAAE,CAAC;IAE9C,QAAQ,CAAC,EAAE,eAAe,CAAC,UAAU,CAAC,CAAC;IACvC,QAAQ,CAAC,EAAE,eAAe,CAAC,UAAU,CAAC,CAAC;IACvC,WAAW,CAAC,EAAE,eAAe,CAAC,aAAa,CAAC,CAAC;IAC7C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,eAAe,CAAC,WAAW,CAAC,CAAC;IACzC,IAAI,CAAC,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;IAC/B,WAAW,CAAC,EAAE,eAAe,CAAC,aAAa,CAAC,CAAC;CAC9C;AAsDH,QAAA,MAAM,cAAc,2CAAwC,CAAC;AAC7D,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AACxD,eAAe,cAAc,CAAC"}

package/dist/form/FormUpload.svelte

@@ -0,0 +1,92 @@
+<!--
+  Form.Upload — convenience wrapper: <Form.Field> + <Upload> bound to a field.
+-->
+<script lang="ts">
+  import type { Rule, ValidateTrigger } from '@chenzy-design/core';
+  import type { ComponentProps, Snippet } from 'svelte';
+  import Field from './Field.svelte';
+  import Upload from '../upload/Upload.svelte';
+
+  type UploadProps = ComponentProps<typeof Upload>;
+
+  interface Props {
+    field: string;
+    label?: string;
+    rules?: Rule[];
+    initValue?: unknown;
+    required?: boolean;
+    validateStatus?: 'default' | 'warning' | 'error';
+    extraText?: string;
+    span?: number;
+    transform?: (value: unknown, values: Record<string, unknown>) => unknown;
+    dependencies?: string[];
+    trigger?: ValidateTrigger | ValidateTrigger[];
+    // Upload-specific props
+    accept?: UploadProps['accept'];
+    multiple?: UploadProps['multiple'];
+    limit?: UploadProps['limit'];
+    disabled?: boolean;
+    listType?: UploadProps['listType'];
+    drag?: UploadProps['drag'];
+    action?: UploadProps['action'];
+    size?: UploadProps['size'];
+    children?: Snippet;
+  }
+
+  let {
+    field,
+    label,
+    rules = [],
+    initValue,
+    required = false,
+    validateStatus,
+    extraText,
+    span,
+    transform,
+    dependencies,
+    trigger,
+    accept,
+    multiple,
+    limit,
+    disabled,
+    listType,
+    drag,
+    action,
+    size,
+    children,
+  }: Props = $props();
+
+  const fieldProps = $derived<ComponentProps<typeof Field>>({
+    field,
+    rules,
+    required,
+    ...(label !== undefined ? { label } : {}),
+    ...(initValue !== undefined ? { initValue } : {}),
+    ...(validateStatus !== undefined ? { validateStatus } : {}),
+    ...(extraText !== undefined ? { extraText } : {}),
+    ...(span !== undefined ? { span } : {}),
+    ...(transform !== undefined ? { transform } : {}),
+    ...(dependencies !== undefined ? { dependencies } : {}),
+    ...(trigger !== undefined ? { trigger } : {}),
+  });
+</script>
+
+<Field {...fieldProps}>
+  {#snippet children({ value, onChange, status, disabled: fieldDisabled })}
+    <Upload
+      value={Array.isArray(value) ? (value as UploadProps['value']) : undefined}
+      {accept}
+      {multiple}
+      {limit}
+      disabled={disabled ?? fieldDisabled}
+      {listType}
+      {drag}
+      {action}
+      {size}
+      status={status === 'error' ? 'error' : 'default'}
+      onChange={(list) => onChange(list)}
+    >
+      {@render children?.()}
+    </Upload>
+  {/snippet}
+</Field>

package/dist/form/FormUpload.svelte.d.ts

@@ -0,0 +1,30 @@
+import type { Rule, ValidateTrigger } from '@chenzy-design/core';
+import type { ComponentProps, Snippet } from 'svelte';
+import Upload from '../upload/Upload.svelte';
+type UploadProps = ComponentProps<typeof Upload>;
+interface Props {
+    field: string;
+    label?: string;
+    rules?: Rule[];
+    initValue?: unknown;
+    required?: boolean;
+    validateStatus?: 'default' | 'warning' | 'error';
+    extraText?: string;
+    span?: number;
+    transform?: (value: unknown, values: Record<string, unknown>) => unknown;
+    dependencies?: string[];
+    trigger?: ValidateTrigger | ValidateTrigger[];
+    accept?: UploadProps['accept'];
+    multiple?: UploadProps['multiple'];
+    limit?: UploadProps['limit'];
+    disabled?: boolean;
+    listType?: UploadProps['listType'];
+    drag?: UploadProps['drag'];
+    action?: UploadProps['action'];
+    size?: UploadProps['size'];
+    children?: Snippet;
+}
+declare const FormUpload: import("svelte").Component<Props, {}, "">;
+type FormUpload = ReturnType<typeof FormUpload>;
+export default FormUpload;
+//# sourceMappingURL=FormUpload.svelte.d.ts.map

package/dist/form/FormUpload.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormUpload.svelte.d.ts","sourceRoot":"","sources":["../../src/form/FormUpload.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEtD,OAAO,MAAM,MAAM,yBAAyB,CAAC;AAG3C,KAAK,WAAW,GAAG,cAAc,CAAC,OAAO,MAAM,CAAC,CAAC;AAEjD,UAAU,KAAK;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;IACzE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,eAAe,GAAG,eAAe,EAAE,CAAC;IAE9C,MAAM,CAAC,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC/B,QAAQ,CAAC,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC;IACnC,KAAK,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC;IACnC,IAAI,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC3B,MAAM,CAAC,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC/B,IAAI,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AA0DH,QAAA,MAAM,UAAU,2CAAwC,CAAC;AACzD,KAAK,UAAU,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;AAChD,eAAe,UAAU,CAAC"}

package/dist/form/context.d.ts

@@ -0,0 +1,34 @@
+import type { FormApi, FormState } from '@chenzy-design/core';
+export type FormLayout = 'vertical' | 'horizontal';
+export type FormLabelPosition = 'top' | 'left' | 'inset';
+export type FormSize = 'small' | 'default' | 'large';
+export type FormLabelAlign = 'left' | 'right';
+export interface GridCol {
+    span?: number;
+    offset?: number;
+}
+export interface FormContext {
+    /** the headless form instance from @chenzy-design/core */
+    form: FormApi;
+    /** getter keeps the bridged $state reactive across context boundary */
+    getFormState: () => FormState;
+    getLabelPosition: () => FormLabelPosition;
+    getLabelWidth: () => number | string | undefined;
+    /** Label text alignment (spec §4 L60). */
+    getLabelAlign: () => FormLabelAlign;
+    getSize: () => FormSize;
+    getDisabled: () => boolean;
+    getRequiredMark: () => boolean;
+    getColon: () => boolean;
+    /** whether error/warning text carries a status icon (spec §4 L66). */
+    getShowValidateIcon: () => boolean;
+    /** extra text position: 'middle' | 'bottom' (default 'bottom'). */
+    getExtraTextPosition: () => 'middle' | 'bottom';
+    /** 控件布局列配置（Grid 布局时）。 */
+    getWrapperCol: () => GridCol | undefined;
+    /** 标签布局列配置（Grid 布局时）。 */
+    getLabelCol: () => GridCol | undefined;
+}
+export declare function setFormContext(ctx: FormContext): void;
+export declare function getFormContext(): FormContext | undefined;
+//# sourceMappingURL=context.d.ts.map

package/dist/form/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/form/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAE9D,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,YAAY,CAAC;AACnD,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;AACzD,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;AACrD,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,OAAO,CAAC;AAE9C,MAAM,WAAW,OAAO;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,0DAA0D;IAC1D,IAAI,EAAE,OAAO,CAAC;IACd,uEAAuE;IACvE,YAAY,EAAE,MAAM,SAAS,CAAC;IAG9B,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;IAC1C,aAAa,EAAE,MAAM,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACjD,0CAA0C;IAC1C,aAAa,EAAE,MAAM,cAAc,CAAC;IACpC,OAAO,EAAE,MAAM,QAAQ,CAAC;IACxB,WAAW,EAAE,MAAM,OAAO,CAAC;IAC3B,eAAe,EAAE,MAAM,OAAO,CAAC;IAC/B,QAAQ,EAAE,MAAM,OAAO,CAAC;IACxB,sEAAsE;IACtE,mBAAmB,EAAE,MAAM,OAAO,CAAC;IACnC,mEAAmE;IACnE,oBAAoB,EAAE,MAAM,QAAQ,GAAG,QAAQ,CAAC;IAChD,yBAAyB;IACzB,aAAa,EAAE,MAAM,OAAO,GAAG,SAAS,CAAC;IACzC,yBAAyB;IACzB,WAAW,EAAE,MAAM,OAAO,GAAG,SAAS,CAAC;CACxC;AAID,wBAAgB,cAAc,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAErD;AAED,wBAAgB,cAAc,IAAI,WAAW,GAAG,SAAS,CAExD"}

package/dist/form/context.js

@@ -0,0 +1,8 @@
+import { getContext, setContext } from 'svelte';
+const KEY = Symbol('cd-form');
+export function setFormContext(ctx) {
+    setContext(KEY, ctx);
+}
+export function getFormContext() {
+    return getContext(KEY);
+}

package/dist/form/index.d.ts

@@ -0,0 +1,13 @@
+import Form_ from './Form.svelte';
+import Field from './Field.svelte';
+import FormInput from './FormInput.svelte';
+import FieldArray from './FieldArray.svelte';
+export declare const Form: typeof Form_ & {
+    Field: typeof Field;
+    Input: typeof FormInput;
+    List: typeof FieldArray;
+};
+export { Field as FormField, FormInput, FieldArray };
+export { meta as formMeta } from './meta.js';
+export { getFormContext, setFormContext, type FormContext, type FormLayout, type FormLabelPosition, type FormSize, type FormLabelAlign, } from './context.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/form/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,eAAe,CAAC;AAClC,OAAO,KAAK,MAAM,gBAAgB,CAAC;AACnC,OAAO,SAAS,MAAM,oBAAoB,CAAC;AAC3C,OAAO,UAAU,MAAM,qBAAqB,CAAC;AAE7C,eAAO,MAAM,IAAI,EAAE,OAAO,KAAK,GAAG;IAChC,KAAK,EAAE,OAAO,KAAK,CAAC;IACpB,KAAK,EAAE,OAAO,SAAS,CAAC;IACxB,IAAI,EAAE,OAAO,UAAU,CAAC;CAC6C,CAAC;AAExE,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;AACrD,OAAO,EAAE,IAAI,IAAI,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EACL,cAAc,EACd,cAAc,EACd,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,QAAQ,EACb,KAAK,cAAc,GACpB,MAAM,cAAc,CAAC"}

package/dist/form/index.js

@@ -0,0 +1,8 @@
+import Form_ from './Form.svelte';
+import Field from './Field.svelte';
+import FormInput from './FormInput.svelte';
+import FieldArray from './FieldArray.svelte';
+export const Form = Object.assign(Form_, { Field, Input: FormInput, List: FieldArray });
+export { Field as FormField, FormInput, FieldArray };
+export { meta as formMeta } from './meta.js';
+export { getFormContext, setFormContext, } from './context.js';

package/dist/form/meta.d.ts

@@ -0,0 +1,239 @@
+/**
+ * Machine-readable component metadata for AI/docs consumption.
+ * See specs/00-foundation/ai-friendly.spec.md.
+ */
+export declare const meta: {
+    readonly name: "Form";
+    readonly category: "input";
+    readonly description: "表单容器，桥接 headless createForm，提供字段注册、校验、布局与 a11y。";
+    readonly subComponents: readonly ["Form.Field", "Form.Input"];
+    readonly props: readonly [{
+        readonly name: "value";
+        readonly type: "Record<string, unknown>";
+        readonly default: "undefined";
+        readonly desc: "受控整表单值；变更经 onChange 上报";
+    }, {
+        readonly name: "initValues";
+        readonly type: "Record<string, unknown>";
+        readonly default: "{}";
+        readonly desc: "非受控初始值";
+    }, {
+        readonly name: "layout";
+        readonly type: "'vertical'|'horizontal'";
+        readonly default: "vertical";
+    }, {
+        readonly name: "labelPosition";
+        readonly type: "'top'|'left'|'inset'";
+        readonly default: "top";
+    }, {
+        readonly name: "labelWidth";
+        readonly type: "number | string";
+        readonly default: "undefined";
+    }, {
+        readonly name: "labelAlign";
+        readonly type: "'left'|'right'";
+        readonly default: "left";
+        readonly desc: "Label 文本对齐（spec §4）";
+    }, {
+        readonly name: "size";
+        readonly type: "'small'|'default'|'large'";
+        readonly default: "default";
+    }, {
+        readonly name: "disabled";
+        readonly type: "boolean";
+        readonly default: "false";
+    }, {
+        readonly name: "requiredMark";
+        readonly type: "boolean";
+        readonly default: "true";
+    }, {
+        readonly name: "colon";
+        readonly type: "boolean";
+        readonly default: "false";
+    }, {
+        readonly name: "scrollToError";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "提交校验失败时滚动并聚焦首个错误字段";
+    }, {
+        readonly name: "validateTrigger";
+        readonly type: "'change'|'blur'|'submit'|'mount'|string[]";
+        readonly default: "['blur','change']";
+        readonly desc: "全局默认校验时机，字段可经 trigger 覆盖（spec §4）";
+    }, {
+        readonly name: "showValidateIcon";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "错误/警告文案是否带状态图标（spec §4）";
+    }, {
+        readonly name: "stopValidateWithError";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "字段命中首条错误即停止该字段后续 rule（spec §4）";
+    }, {
+        readonly name: "preventDefault";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "是否拦截原生 submit 默认行为（spec §4）";
+    }, {
+        readonly name: "allowEmpty";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "收集值时是否保留空值字段键（spec §4）";
+    }, {
+        readonly name: "onSubmit";
+        readonly type: "(r: { valid; values; errors }) => void";
+        readonly default: "undefined";
+    }, {
+        readonly name: "onChange";
+        readonly type: "(values: Record<string, unknown>) => void";
+        readonly default: "undefined";
+    }, {
+        readonly name: "children";
+        readonly type: "Snippet";
+        readonly default: "undefined";
+    }, {
+        readonly name: "footer";
+        readonly type: "Snippet<[{ submitting: boolean }]>";
+        readonly default: "undefined";
+    }, {
+        readonly name: "Field.field";
+        readonly type: "string";
+        readonly default: "—";
+        readonly desc: "字段名（必填）";
+    }, {
+        readonly name: "Field.label";
+        readonly type: "string";
+        readonly default: "undefined";
+    }, {
+        readonly name: "Field.rules";
+        readonly type: "Rule[]";
+        readonly default: "[]";
+    }, {
+        readonly name: "Field.initValue";
+        readonly type: "unknown";
+        readonly default: "undefined";
+        readonly desc: "字段级初始值，覆盖容器 initValues（spec §4.2）";
+    }, {
+        readonly name: "Field.required";
+        readonly type: "boolean";
+        readonly default: "false";
+    }, {
+        readonly name: "Field.validateStatus";
+        readonly type: "'default'|'warning'|'error'";
+        readonly default: "undefined";
+        readonly desc: "外部强制校验态（受控展示，不经内部校验、不回写）（spec §4.2）";
+    }, {
+        readonly name: "Field.extraText";
+        readonly type: "string";
+        readonly default: "undefined";
+    }, {
+        readonly name: "Field.noStyle";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "仅注册收集、不渲染布局 DOM（纯收集）（spec §4.2 §190）";
+    }, {
+        readonly name: "Field.span";
+        readonly type: "number";
+        readonly default: "undefined";
+        readonly desc: "Form.Section 栅格内占列（grid-column: span N）（spec §4.2）";
+    }, {
+        readonly name: "Field.transform";
+        readonly type: "(v, values) => unknown";
+        readonly default: "undefined";
+        readonly desc: "提交前值转换（纯函数，不回写 state）（spec §4.2）";
+    }, {
+        readonly name: "Field.dependencies";
+        readonly type: "string[]";
+        readonly default: "undefined";
+        readonly desc: "依赖字段名；其值变化时本字段自动重校验";
+    }, {
+        readonly name: "Field.trigger";
+        readonly type: "'change'|'blur'|'submit'|'mount'|string[]";
+        readonly default: "继承容器";
+        readonly desc: "字段级校验时机覆盖（spec §4）";
+    }, {
+        readonly name: "Field.valuePropName";
+        readonly type: "string";
+        readonly default: "'value'";
+        readonly desc: "控件值属性名；如 Checkbox/Switch 用 'checked'，snippet 参数即多出同名别名映射字段值";
+    }, {
+        readonly name: "Field.children";
+        readonly type: "Snippet<[{ value; [valuePropName]; onChange; onBlur; status; id; describedBy; disabled }]>";
+        readonly default: "undefined";
+        readonly desc: "snippet 参数含通用 value 及按 valuePropName 命名的别名（默认 value）；id 用于 label for/id 关联，describedBy 用于控件 aria-describedby";
+    }, {
+        readonly name: "Input.field";
+        readonly type: "string";
+        readonly default: "—";
+        readonly desc: "字段名（必填）";
+    }, {
+        readonly name: "Input.label";
+        readonly type: "string";
+        readonly default: "undefined";
+    }, {
+        readonly name: "Input.rules";
+        readonly type: "Rule[]";
+        readonly default: "[]";
+    }, {
+        readonly name: "Input.initValue";
+        readonly type: "unknown";
+        readonly default: "undefined";
+        readonly desc: "字段级初始值，覆盖容器 initValues（spec §4.2）";
+    }, {
+        readonly name: "Input.required";
+        readonly type: "boolean";
+        readonly default: "false";
+    }, {
+        readonly name: "Input.validateStatus";
+        readonly type: "'default'|'warning'|'error'";
+        readonly default: "undefined";
+        readonly desc: "外部强制校验态（受控展示）（spec §4.2）";
+    }, {
+        readonly name: "Input.extraText";
+        readonly type: "string";
+        readonly default: "undefined";
+    }, {
+        readonly name: "Input.span";
+        readonly type: "number";
+        readonly default: "undefined";
+        readonly desc: "Form.Section 栅格内占列（spec §4.2）";
+    }, {
+        readonly name: "Input.transform";
+        readonly type: "(v, values) => unknown";
+        readonly default: "undefined";
+        readonly desc: "提交前值转换（纯函数）（spec §4.2）";
+    }, {
+        readonly name: "Input.placeholder";
+        readonly type: "string";
+        readonly default: "undefined";
+    }, {
+        readonly name: "Input.type";
+        readonly type: "'text'|'password'";
+        readonly default: "text";
+    }, {
+        readonly name: "Input.clearable";
+        readonly type: "boolean";
+        readonly default: "false";
+    }, {
+        readonly name: "Input.maxLength";
+        readonly type: "number";
+        readonly default: "undefined";
+    }, {
+        readonly name: "Input.dependencies";
+        readonly type: "string[]";
+        readonly default: "undefined";
+        readonly desc: "依赖字段名；其值变化时本字段自动重校验";
+    }, {
+        readonly name: "Input.trigger";
+        readonly type: "'change'|'blur'|'submit'|'mount'|string[]";
+        readonly default: "继承容器";
+        readonly desc: "字段级校验时机覆盖（spec §4）";
+    }];
+    readonly a11y: {
+        readonly role: "form";
+        readonly notes: readonly ["原生 <form>，submit 经 preventDefault 接管", "字段错误用 role=alert，经 aria-describedby 关联控件", "extraText 无错误时经 aria-describedby 关联", "必填星标 aria-hidden，必填语义由校验承载", "Form.Input 经 Field 自动生成的 id 用 label for/id 精确关联控件（点击 label 聚焦 input）；id 也可由 Input 外部传入"];
+    };
+    readonly tokens: readonly ["--cd-form-item-gap", "--cd-form-label-color", "--cd-form-label-gap", "--cd-form-required-color", "--cd-form-optional-color", "--cd-form-extra-color", "--cd-form-error-color", "--cd-form-error-font-size", "--cd-spacing-*", "--cd-color-*"];
+};
+//# sourceMappingURL=meta.d.ts.map

package/dist/form/meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../src/form/meta.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgFP,CAAC"}

package/dist/form/meta.js

@@ -0,0 +1,85 @@
+/**
+ * Machine-readable component metadata for AI/docs consumption.
+ * See specs/00-foundation/ai-friendly.spec.md.
+ */
+export const meta = {
+    name: 'Form',
+    category: 'input',
+    description: '表单容器，桥接 headless createForm，提供字段注册、校验、布局与 a11y。',
+    subComponents: ['Form.Field', 'Form.Input'],
+    props: [
+        { name: 'value', type: 'Record<string, unknown>', default: 'undefined', desc: '受控整表单值；变更经 onChange 上报' },
+        { name: 'initValues', type: 'Record<string, unknown>', default: '{}', desc: '非受控初始值' },
+        { name: 'layout', type: "'vertical'|'horizontal'", default: 'vertical' },
+        { name: 'labelPosition', type: "'top'|'left'|'inset'", default: 'top' },
+        { name: 'labelWidth', type: 'number | string', default: 'undefined' },
+        { name: 'labelAlign', type: "'left'|'right'", default: 'left', desc: 'Label 文本对齐（spec §4）' },
+        { name: 'size', type: "'small'|'default'|'large'", default: 'default' },
+        { name: 'disabled', type: 'boolean', default: 'false' },
+        { name: 'requiredMark', type: 'boolean', default: 'true' },
+        { name: 'colon', type: 'boolean', default: 'false' },
+        { name: 'scrollToError', type: 'boolean', default: 'false', desc: '提交校验失败时滚动并聚焦首个错误字段' },
+        { name: 'validateTrigger', type: "'change'|'blur'|'submit'|'mount'|string[]", default: "['blur','change']", desc: '全局默认校验时机，字段可经 trigger 覆盖（spec §4）' },
+        { name: 'showValidateIcon', type: 'boolean', default: 'true', desc: '错误/警告文案是否带状态图标（spec §4）' },
+        { name: 'stopValidateWithError', type: 'boolean', default: 'false', desc: '字段命中首条错误即停止该字段后续 rule（spec §4）' },
+        { name: 'preventDefault', type: 'boolean', default: 'true', desc: '是否拦截原生 submit 默认行为（spec §4）' },
+        { name: 'allowEmpty', type: 'boolean', default: 'false', desc: '收集值时是否保留空值字段键（spec §4）' },
+        { name: 'onSubmit', type: '(r: { valid; values; errors }) => void', default: 'undefined' },
+        { name: 'onChange', type: '(values: Record<string, unknown>) => void', default: 'undefined' },
+        { name: 'children', type: 'Snippet', default: 'undefined' },
+        { name: 'footer', type: 'Snippet<[{ submitting: boolean }]>', default: 'undefined' },
+        // Form.Field
+        { name: 'Field.field', type: 'string', default: '—', desc: '字段名（必填）' },
+        { name: 'Field.label', type: 'string', default: 'undefined' },
+        { name: 'Field.rules', type: 'Rule[]', default: '[]' },
+        { name: 'Field.initValue', type: 'unknown', default: 'undefined', desc: '字段级初始值，覆盖容器 initValues（spec §4.2）' },
+        { name: 'Field.required', type: 'boolean', default: 'false' },
+        { name: 'Field.validateStatus', type: "'default'|'warning'|'error'", default: 'undefined', desc: '外部强制校验态（受控展示，不经内部校验、不回写）（spec §4.2）' },
+        { name: 'Field.extraText', type: 'string', default: 'undefined' },
+        { name: 'Field.noStyle', type: 'boolean', default: 'false', desc: '仅注册收集、不渲染布局 DOM（纯收集）（spec §4.2 §190）' },
+        { name: 'Field.span', type: 'number', default: 'undefined', desc: 'Form.Section 栅格内占列（grid-column: span N）（spec §4.2）' },
+        { name: 'Field.transform', type: '(v, values) => unknown', default: 'undefined', desc: '提交前值转换（纯函数，不回写 state）（spec §4.2）' },
+        { name: 'Field.dependencies', type: 'string[]', default: 'undefined', desc: '依赖字段名；其值变化时本字段自动重校验' },
+        { name: 'Field.trigger', type: "'change'|'blur'|'submit'|'mount'|string[]", default: '继承容器', desc: '字段级校验时机覆盖（spec §4）' },
+        { name: 'Field.valuePropName', type: 'string', default: "'value'", desc: "控件值属性名；如 Checkbox/Switch 用 'checked'，snippet 参数即多出同名别名映射字段值" },
+        { name: 'Field.children', type: 'Snippet<[{ value; [valuePropName]; onChange; onBlur; status; id; describedBy; disabled }]>', default: 'undefined', desc: 'snippet 参数含通用 value 及按 valuePropName 命名的别名（默认 value）；id 用于 label for/id 关联，describedBy 用于控件 aria-describedby' },
+        // Form.Input
+        { name: 'Input.field', type: 'string', default: '—', desc: '字段名（必填）' },
+        { name: 'Input.label', type: 'string', default: 'undefined' },
+        { name: 'Input.rules', type: 'Rule[]', default: '[]' },
+        { name: 'Input.initValue', type: 'unknown', default: 'undefined', desc: '字段级初始值，覆盖容器 initValues（spec §4.2）' },
+        { name: 'Input.required', type: 'boolean', default: 'false' },
+        { name: 'Input.validateStatus', type: "'default'|'warning'|'error'", default: 'undefined', desc: '外部强制校验态（受控展示）（spec §4.2）' },
+        { name: 'Input.extraText', type: 'string', default: 'undefined' },
+        { name: 'Input.span', type: 'number', default: 'undefined', desc: 'Form.Section 栅格内占列（spec §4.2）' },
+        { name: 'Input.transform', type: '(v, values) => unknown', default: 'undefined', desc: '提交前值转换（纯函数）（spec §4.2）' },
+        { name: 'Input.placeholder', type: 'string', default: 'undefined' },
+        { name: 'Input.type', type: "'text'|'password'", default: 'text' },
+        { name: 'Input.clearable', type: 'boolean', default: 'false' },
+        { name: 'Input.maxLength', type: 'number', default: 'undefined' },
+        { name: 'Input.dependencies', type: 'string[]', default: 'undefined', desc: '依赖字段名；其值变化时本字段自动重校验' },
+        { name: 'Input.trigger', type: "'change'|'blur'|'submit'|'mount'|string[]", default: '继承容器', desc: '字段级校验时机覆盖（spec §4）' },
+    ],
+    a11y: {
+        role: 'form',
+        notes: [
+            '原生 <form>，submit 经 preventDefault 接管',
+            '字段错误用 role=alert，经 aria-describedby 关联控件',
+            'extraText 无错误时经 aria-describedby 关联',
+            '必填星标 aria-hidden，必填语义由校验承载',
+            'Form.Input 经 Field 自动生成的 id 用 label for/id 精确关联控件（点击 label 聚焦 input）；id 也可由 Input 外部传入',
+        ],
+    },
+    tokens: [
+        '--cd-form-item-gap',
+        '--cd-form-label-color',
+        '--cd-form-label-gap',
+        '--cd-form-required-color',
+        '--cd-form-optional-color',
+        '--cd-form-extra-color',
+        '--cd-form-error-color',
+        '--cd-form-error-font-size',
+        '--cd-spacing-*',
+        '--cd-color-*',
+    ],
+};