@chenzy-design/svelte 0.3.1 → 0.4.1

package/dist/input/meta.d.ts

@@ -1,11 +1,14 @@
 /**
  * Machine-readable component metadata for AI/docs consumption.
  * See specs/00-foundation/ai-friendly.spec.md.
+ * 严格对齐 Semi Design（semi-ui/input）：props / DOM / token 全部镜像 Semi。
  */
 export declare const meta: {
     readonly name: "Input";
     readonly category: "input";
-    readonly description: "单行文本录入框，支持前后缀、清除、计数、密码显隐与 IME。";
+    readonly semiEquivalent: "Input";
+    readonly description: "单行文本录入框，支持前后缀、前后置标签、清除、密码显隐与 IME。严格对齐 Semi。配套 TextArea（多行）与 InputGroup（组合），对齐 Semi 同页三组件（Input / TextArea / InputGroup 均为顶层导出）。";
+    readonly exports: readonly ["Input", "TextArea", "InputGroup"];
     readonly props: readonly [{
         readonly name: "value";
         readonly type: "string";
@@ -19,7 +22,7 @@ export declare const meta: {
     }, {
         readonly name: "size";
         readonly type: "'small'|'default'|'large'";
-        readonly default: "default";
+        readonly default: "'default'";
     }, {
         readonly name: "disabled";
         readonly type: "boolean";
@@ -33,33 +36,115 @@ export declare const meta: {
         readonly type: "string";
         readonly default: "undefined";
     }, {
-        readonly name: "clearable";
-        readonly type: "boolean";
-        readonly default: "false";
-    }, {
-        readonly name: "showCount";
+        readonly name: "showClear";
         readonly type: "boolean";
         readonly default: "false";
+        readonly desc: "有内容且 hover/focus 时展示清除按钮（对齐 Semi showClear）";
     }, {
         readonly name: "maxLength";
         readonly type: "number";
         readonly default: "undefined";
+        readonly desc: "原生 maxlength（getValueLength 存在时不下发，改由 JS 按可见长度截断）";
     }, {
-        readonly name: "status";
-        readonly type: "'default'|'warning'|'error'";
-        readonly default: "default";
+        readonly name: "minLength";
+        readonly type: "number";
+        readonly default: "undefined";
+        readonly desc: "最小长度，下发原生 minlength 触发校验（getValueLength 存在时按可见长度换算，对齐 Semi）";
+    }, {
+        readonly name: "validateStatus";
+        readonly type: "'default'|'warning'|'error'|'success'";
+        readonly default: "'default'";
+        readonly desc: "校验状态，仅影响展示样式（对齐 Semi validateStatus；success 合法但无特殊样式）";
+    }, {
+        readonly name: "mode";
+        readonly type: "'password'";
+        readonly default: "undefined";
+        readonly desc: "输入框模式，password 启用密码显隐按钮（对齐 Semi mode）";
     }, {
         readonly name: "type";
-        readonly type: "'text'|'password'";
-        readonly default: "text";
+        readonly type: "string";
+        readonly default: "'text'";
+        readonly desc: "原生 input type，透传（对齐 Semi type，可为 number/email/search 等）";
     }, {
         readonly name: "prefix";
-        readonly type: "Snippet";
+        readonly type: "Snippet | string";
         readonly default: "undefined";
+        readonly desc: "前缀标签（输入框内左侧）；字符串直接渲染，Snippet 自定义（对齐 Semi）";
     }, {
         readonly name: "suffix";
+        readonly type: "Snippet | string";
+        readonly default: "undefined";
+        readonly desc: "后缀标签（输入框内右侧）；字符串直接渲染，Snippet 自定义（对齐 Semi）";
+    }, {
+        readonly name: "insetLabel";
+        readonly type: "Snippet | string";
+        readonly default: "undefined";
+        readonly desc: "内嵌标签（与 prefix 同槽，对齐 Semi insetLabel）";
+    }, {
+        readonly name: "insetLabelId";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "内嵌标签容器 id（对齐 Semi insetLabelId）";
+    }, {
+        readonly name: "clearIcon";
         readonly type: "Snippet";
         readonly default: "undefined";
+        readonly desc: "自定义清除图标（showClear 有值时替换默认图标，对齐 Semi）";
+    }, {
+        readonly name: "addonBefore";
+        readonly type: "Snippet | string";
+        readonly default: "undefined";
+        readonly desc: "前置标签（如 \"https://\"）";
+    }, {
+        readonly name: "addonAfter";
+        readonly type: "Snippet | string";
+        readonly default: "undefined";
+        readonly desc: "后置标签（如 \".com\"）";
+    }, {
+        readonly name: "borderless";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "无边框模式（对齐 Semi borderless）";
+    }, {
+        readonly name: "getValueLength";
+        readonly type: "(value: string) => number";
+        readonly default: "undefined";
+        readonly desc: "自定义字符计数函数，替代默认长度（存在时接管 maxLength 校验）";
+    }, {
+        readonly name: "hideSuffix";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "清除按钮与后缀并存时隐藏后缀（对齐 Semi hideSuffix）";
+    }, {
+        readonly name: "style";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "根容器内联样式（对齐 Semi style）";
+    }, {
+        readonly name: "class";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "根容器自定义类名（对齐 Semi className）";
+    }, {
+        readonly name: "inputStyle";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "input 元素内联样式（对齐 Semi inputStyle）";
+    }, {
+        readonly name: "preventScroll";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "调用 focus() 时传入 { preventScroll }（对齐 Semi）";
+    }, {
+        readonly name: "autoFocus";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "组件挂载时自动聚焦（对齐 Semi）";
+    }, {
+        readonly name: "composition";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "输入法模式：开启后 IME 未确认期间不触发 onChange，确认后触发一次（对齐 Semi）";
     }, {
         readonly name: "name";
         readonly type: "string";
@@ -73,46 +158,741 @@ export declare const meta: {
         readonly name: "ariaLabel";
         readonly type: "string";
         readonly default: "undefined";
+    }, {
+        readonly name: "ariaLabelledby";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "对齐 Semi aria-labelledby";
     }, {
         readonly name: "ariaDescribedby";
         readonly type: "string";
         readonly default: "undefined";
-        readonly desc: "透传到 aria-describedby，关联说明/错误文本";
+        readonly desc: "关联说明/错误文本";
+    }, {
+        readonly name: "ariaErrormessage";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "对齐 Semi aria-errormessage";
+    }, {
+        readonly name: "ariaRequired";
+        readonly type: "boolean";
+        readonly default: "undefined";
+        readonly desc: "必填语义（Form.Field required 透传）：输出 aria-required";
     }, {
         readonly name: "onChange";
-        readonly type: "(v: string) => void";
+        readonly type: "(value: string, e: Event) => void";
         readonly default: "undefined";
+        readonly desc: "内容变化（对齐 Semi：第二参为原生事件）";
     }, {
         readonly name: "onInput";
-        readonly type: "(v: string) => void";
+        readonly type: "(value: string, e: Event) => void";
         readonly default: "undefined";
     }, {
         readonly name: "onClear";
-        readonly type: "() => void";
+        readonly type: "(e: MouseEvent) => void";
         readonly default: "undefined";
+        readonly desc: "点击清除按钮（对齐 Semi：透传鼠标事件）";
     }, {
         readonly name: "onEnterPress";
         readonly type: "(e: KeyboardEvent) => void";
         readonly default: "undefined";
-        readonly desc: "回车按下（spec on:enterPress）";
+        readonly desc: "回车按下（composition 中不触发）";
+    }, {
+        readonly name: "onFocus";
+        readonly type: "(e: FocusEvent) => void";
+        readonly default: "undefined";
+    }, {
+        readonly name: "onBlur";
+        readonly type: "(e: FocusEvent) => void";
+        readonly default: "undefined";
+    }, {
+        readonly name: "onKeyDown";
+        readonly type: "(e: KeyboardEvent) => void";
+        readonly default: "undefined";
+        readonly desc: "透传原生 keydown（对齐 Semi）";
     }, {
-        readonly name: "onEnter";
+        readonly name: "onKeyUp";
         readonly type: "(e: KeyboardEvent) => void";
         readonly default: "undefined";
-        readonly desc: "已废弃，改用 onEnterPress";
+    }, {
+        readonly name: "onKeyPress";
+        readonly type: "(e: KeyboardEvent) => void";
+        readonly default: "undefined";
+    }, {
+        readonly name: "onCompositionStart";
+        readonly type: "(e: CompositionEvent) => void";
+        readonly default: "undefined";
+    }, {
+        readonly name: "onCompositionEnd";
+        readonly type: "(e: CompositionEvent) => void";
+        readonly default: "undefined";
+    }, {
+        readonly name: "onCompositionUpdate";
+        readonly type: "(e: CompositionEvent) => void";
+        readonly default: "undefined";
+    }];
+    readonly methods: readonly [{
+        readonly name: "focus()";
+        readonly desc: "命令式聚焦输入框（尊重 preventScroll，对齐 Semi）";
+    }, {
+        readonly name: "blur()";
+        readonly desc: "命令式移除焦点（对齐 Semi）";
+    }];
+    readonly a11y: {
+        readonly role: "textbox";
+        readonly notes: readonly ["原生 input", "error 时 aria-invalid", "密码切换按钮 role=button + tabindex + aria-label（对齐 Semi，无 aria-pressed）", "清除按钮为无 aria-label / role 的 div（对齐 Semi）"];
+    };
+    readonly tokens: readonly ["--cd-color-input-*", "--cd-height-input-*", "--cd-radius-input-wrapper", "--cd-spacing-input-*"];
+    readonly subComponents: readonly [{
+        readonly name: "TextArea";
+        readonly semiEquivalent: "TextArea";
+        readonly usage: "<TextArea autosize maxCount={100} showClear />";
+        readonly desc: "多行文本录入框，支持计数（maxCount/getValueLength）、清除、校验态、IME、autosize 自适应高度、行号、resize 全值域。严格对齐 Semi。";
+        readonly capabilities: readonly ["multiline", "autosize", "char-count", "clearable", "validation-status", "line-number"];
+        readonly props: readonly [{
+            readonly name: "value";
+            readonly type: "string";
+            readonly default: "undefined";
+            readonly desc: "受控值；提供则为受控";
+        }, {
+            readonly name: "defaultValue";
+            readonly type: "string";
+            readonly default: "''";
+            readonly desc: "非受控初始值";
+        }, {
+            readonly name: "size";
+            readonly type: "'small'|'default'|'large'";
+            readonly default: "'default'";
+        }, {
+            readonly name: "disabled";
+            readonly type: "boolean";
+            readonly default: "false";
+        }, {
+            readonly name: "readonly";
+            readonly type: "boolean";
+            readonly default: "false";
+        }, {
+            readonly name: "placeholder";
+            readonly type: "string";
+            readonly default: "undefined";
+        }, {
+            readonly name: "showCount";
+            readonly type: "boolean";
+            readonly default: "false";
+            readonly desc: "显示字数统计（对齐 Semi showCounter；maxCount 存在时亦显示）";
+        }, {
+            readonly name: "maxLength";
+            readonly type: "number";
+            readonly default: "undefined";
+            readonly desc: "原生硬性长度限制（截断输入）";
+        }, {
+            readonly name: "maxCount";
+            readonly type: "number";
+            readonly default: "undefined";
+            readonly desc: "计数上限（计数展示与超限提示，不截断，对齐 Semi）";
+        }, {
+            readonly name: "showClear";
+            readonly type: "boolean";
+            readonly default: "false";
+            readonly desc: "有内容且 hover/focus 时展示清除按钮（对齐 Semi）";
+        }, {
+            readonly name: "autoFocus";
+            readonly type: "boolean";
+            readonly default: "false";
+            readonly desc: "挂载后自动聚焦";
+        }, {
+            readonly name: "validateStatus";
+            readonly type: "'default'|'warning'|'error'|'success'";
+            readonly default: "'default'";
+            readonly desc: "校验态（对齐 Semi validateStatus）";
+        }, {
+            readonly name: "rows";
+            readonly type: "number";
+            readonly default: "4";
+            readonly desc: "默认行数（对齐 Semi）";
+        }, {
+            readonly name: "cols";
+            readonly type: "number";
+            readonly default: "undefined";
+            readonly desc: "默认列数（对齐 Semi cols）";
+        }, {
+            readonly name: "autosize";
+            readonly type: "boolean | { minRows?: number; maxRows?: number }";
+            readonly default: "false";
+            readonly desc: "随内容自适应高度（对齐 Semi）";
+        }, {
+            readonly name: "resize";
+            readonly type: "'none'|'both'|'horizontal'|'vertical'|'block'|'inline'";
+            readonly default: "undefined";
+            readonly desc: "拖拽调整方向（对齐 Semi resize 全值域）；autosize 时忽略；仅显式传入生效";
+        }, {
+            readonly name: "borderless";
+            readonly type: "boolean";
+            readonly default: "false";
+            readonly desc: "无边框模式（对齐 Semi borderless）";
+        }, {
+            readonly name: "showLineNumber";
+            readonly type: "boolean";
+            readonly default: "false";
+            readonly desc: "展示行号（对齐 Semi showLineNumber）";
+        }, {
+            readonly name: "lineNumberStart";
+            readonly type: "number";
+            readonly default: "1";
+            readonly desc: "行号起始值（对齐 Semi lineNumberStart）";
+        }, {
+            readonly name: "lineNumberClassName";
+            readonly type: "string";
+            readonly default: "undefined";
+            readonly desc: "行号区自定义类名（对齐 Semi）";
+        }, {
+            readonly name: "lineNumberStyle";
+            readonly type: "string";
+            readonly default: "undefined";
+            readonly desc: "行号区自定义样式（对齐 Semi）";
+        }, {
+            readonly name: "textareaStyle";
+            readonly type: "string";
+            readonly default: "undefined";
+            readonly desc: "textarea 元素样式，可设高度等（对齐 Semi textareaStyle）";
+        }, {
+            readonly name: "getValueLength";
+            readonly type: "(value: string) => number";
+            readonly default: "undefined";
+            readonly desc: "自定义字符计数函数（对齐 Semi getValueLength）";
+        }, {
+            readonly name: "disabledEnterStartNewLine";
+            readonly type: "boolean";
+            readonly default: "false";
+            readonly desc: "禁用 Enter 换行（Shift+Enter 才换行，对齐 Semi，Chat 场景用）";
+        }, {
+            readonly name: "composition";
+            readonly type: "boolean";
+            readonly default: "false";
+            readonly desc: "输入法模式：开启后 IME 未确认期间不触发 onChange，确认后触发一次（对齐 Semi）";
+        }, {
+            readonly name: "name";
+            readonly type: "string";
+            readonly default: "undefined";
+        }, {
+            readonly name: "id";
+            readonly type: "string";
+            readonly default: "undefined";
+        }, {
+            readonly name: "class";
+            readonly type: "string";
+            readonly default: "''";
+            readonly desc: "根容器自定义类名（对齐 Semi className）";
+        }, {
+            readonly name: "style";
+            readonly type: "string";
+            readonly default: "undefined";
+            readonly desc: "根容器内联样式（对齐 Semi style）";
+        }, {
+            readonly name: "ariaLabel";
+            readonly type: "string";
+            readonly default: "undefined";
+        }, {
+            readonly name: "ariaLabelledby";
+            readonly type: "string";
+            readonly default: "undefined";
+        }, {
+            readonly name: "ariaDescribedby";
+            readonly type: "string";
+            readonly default: "undefined";
+        }, {
+            readonly name: "ariaErrormessage";
+            readonly type: "string";
+            readonly default: "undefined";
+        }, {
+            readonly name: "ariaRequired";
+            readonly type: "boolean";
+            readonly default: "undefined";
+        }, {
+            readonly name: "onChange";
+            readonly type: "(value: string, e: Event) => void";
+            readonly default: "undefined";
+            readonly desc: "内容变化（对齐 Semi：第二参为原生事件）";
+        }, {
+            readonly name: "onInput";
+            readonly type: "(value: string, e: Event) => void";
+            readonly default: "undefined";
+        }, {
+            readonly name: "onClear";
+            readonly type: "(e: MouseEvent) => void";
+            readonly default: "undefined";
+            readonly desc: "点击清除按钮（对齐 Semi：透传鼠标事件）";
+        }, {
+            readonly name: "onFocus";
+            readonly type: "(e: FocusEvent) => void";
+            readonly default: "undefined";
+            readonly desc: "获得焦点";
+        }, {
+            readonly name: "onBlur";
+            readonly type: "(e: FocusEvent) => void";
+            readonly default: "undefined";
+            readonly desc: "失去焦点";
+        }, {
+            readonly name: "onEnterPress";
+            readonly type: "(e: KeyboardEvent) => void";
+            readonly default: "undefined";
+            readonly desc: "按下 Enter（透传原生事件，对齐 Semi；composition 中不触发）";
+        }, {
+            readonly name: "onPressEnter";
+            readonly type: "(e: KeyboardEvent) => void";
+            readonly default: "undefined";
+            readonly desc: "onEnterPress 别名（对齐 Semi onPressEnter）";
+        }, {
+            readonly name: "onResize";
+            readonly type: "(p: { height: number; width?: number }) => void";
+            readonly default: "undefined";
+            readonly desc: "autosize 高度变化，或 resize 拖拽（含 width，对齐 Semi）";
+        }, {
+            readonly name: "onKeyDown";
+            readonly type: "(e: KeyboardEvent) => void";
+            readonly default: "undefined";
+            readonly desc: "透传原生 keydown（对齐 Semi）";
+        }, {
+            readonly name: "onKeyUp";
+            readonly type: "(e: KeyboardEvent) => void";
+            readonly default: "undefined";
+        }, {
+            readonly name: "onKeyPress";
+            readonly type: "(e: KeyboardEvent) => void";
+            readonly default: "undefined";
+        }, {
+            readonly name: "onCompositionStart";
+            readonly type: "(e: CompositionEvent) => void";
+            readonly default: "undefined";
+            readonly desc: "IME 开始";
+        }, {
+            readonly name: "onCompositionEnd";
+            readonly type: "(e: CompositionEvent) => void";
+            readonly default: "undefined";
+            readonly desc: "IME 结束";
+        }, {
+            readonly name: "onCompositionUpdate";
+            readonly type: "(e: CompositionEvent) => void";
+            readonly default: "undefined";
+        }];
+        readonly methods: readonly [{
+            readonly name: "focus()";
+            readonly desc: "命令式聚焦（对齐 Semi）";
+        }, {
+            readonly name: "blur()";
+            readonly desc: "命令式失焦（对齐 Semi）";
+        }];
+        readonly slots: readonly [{
+            readonly name: "count";
+            readonly scope: "{ count, maxCount, overLimit }";
+            readonly desc: "自定义计数器渲染（覆盖内建，本库超集扩展）";
+        }, {
+            readonly name: "clearIcon";
+            readonly desc: "自定义清除图标";
+        }];
+        readonly a11y: {
+            readonly role: "textbox";
+            readonly notes: readonly ["原生 textarea", "error 时 aria-invalid", "IME composition 安全", "超限经 aria-live=polite 播报", "清除按钮为无 aria-label / role 的 div（对齐 Semi）"];
+        };
+        readonly i18nKeys: readonly ["Textarea.countFormat", "Textarea.countOnly", "Textarea.overLimitAnnounce"];
+        readonly tokens: readonly ["--cd-color-input-*", "--cd-color-textarea-*", "--cd-spacing-textarea-*", "--cd-radius-input-wrapper"];
+    }, {
+        readonly name: "InputGroup";
+        readonly semiEquivalent: "InputGroup";
+        readonly usage: "<InputGroup><Input /><Select /></InputGroup>";
+        readonly desc: "输入组合容器：将多个输入类控件（Input/Select/DatePicker 等）拼接为一体（相邻圆角合并 + 分隔线），统一 size/disabled 经 context 回退透传（控件显式 prop 优先），可选组 label。";
+        readonly props: readonly [{
+            readonly name: "size";
+            readonly type: "'small'|'default'|'large'";
+            readonly default: "undefined";
+            readonly desc: "整组尺寸，回退透传子控件（子控件显式 size 优先）";
+        }, {
+            readonly name: "disabled";
+            readonly type: "boolean";
+            readonly default: "undefined";
+            readonly desc: "整组禁用，回退透传子控件（子控件显式 disabled 优先）";
+        }, {
+            readonly name: "label";
+            readonly type: "{ text?: string; name?: string; required?: boolean; width?: number|string }";
+            readonly default: "undefined";
+            readonly desc: "整组标签（对齐 Semi LabelProps 子集）";
+        }, {
+            readonly name: "labelPosition";
+            readonly type: "'top'|'left'";
+            readonly default: "'top'";
+            readonly desc: "标签位置";
+        }, {
+            readonly name: "onFocus";
+            readonly type: "(e: FocusEvent) => void";
+            readonly default: "undefined";
+            readonly desc: "组级聚焦（子控件 focusin 冒泡）";
+        }, {
+            readonly name: "onBlur";
+            readonly type: "(e: FocusEvent) => void";
+            readonly default: "undefined";
+            readonly desc: "组级失焦（子控件 focusout 冒泡）";
+        }, {
+            readonly name: "class";
+            readonly type: "string";
+            readonly default: "undefined";
+            readonly desc: "根节点自定义类名";
+        }, {
+            readonly name: "style";
+            readonly type: "string";
+            readonly default: "undefined";
+            readonly desc: "根节点自定义内联样式";
+        }, {
+            readonly name: "children";
+            readonly type: "Snippet";
+            readonly default: "undefined";
+            readonly desc: "子输入控件";
+        }];
+        readonly events: readonly [{
+            readonly name: "onFocus";
+            readonly desc: "组内控件获得焦点";
+        }, {
+            readonly name: "onBlur";
+            readonly desc: "组内控件失去焦点";
+        }];
+        readonly slots: readonly [{
+            readonly name: "children";
+            readonly desc: "子输入控件（Input/Select/DatePicker 等）";
+        }];
+        readonly a11y: {
+            readonly role: "group";
+            readonly notes: readonly ["单层 span role=group（对齐 Semi）", "有 label 时 label[for] 关联 group[id]", "各子控件保留自身 a11y"];
+        };
+        readonly tokens: readonly ["--cd-color-input-group-border-default", "--cd-width-input-group-pseudo-border", "--cd-radius-input-wrapper"];
+    }];
+};
+/**
+ * InputGroup meta（保留具名导出供 InputGroup demo/文档局部引用）。
+ * 严格对齐 Semi：不带 category，故不作为独立组件进侧边栏——信息以 Input.subComponents 为准。
+ */
+export declare const inputGroupMeta: {
+    readonly name: "InputGroup";
+    readonly relatedTo: "Input";
+    readonly semiEquivalent: "InputGroup";
+    readonly description: "输入组合容器：将多个输入类控件（Input/Select/DatePicker 等）拼接为一体（相邻圆角合并 + 分隔线），统一 size/disabled 经 context 回退透传（控件显式 prop 优先），可选组 label。";
+    readonly props: readonly [{
+        readonly name: "size";
+        readonly type: "'small'|'default'|'large'";
+        readonly default: "undefined";
+        readonly desc: "整组尺寸，回退透传子控件（子控件显式 size 优先）";
+    }, {
+        readonly name: "disabled";
+        readonly type: "boolean";
+        readonly default: "undefined";
+        readonly desc: "整组禁用，回退透传子控件（子控件显式 disabled 优先）";
+    }, {
+        readonly name: "label";
+        readonly type: "{ text?: string; name?: string; required?: boolean; width?: number|string }";
+        readonly default: "undefined";
+        readonly desc: "整组标签（对齐 Semi LabelProps 子集）";
+    }, {
+        readonly name: "labelPosition";
+        readonly type: "'top'|'left'";
+        readonly default: "'top'";
+        readonly desc: "标签位置";
+    }, {
+        readonly name: "onFocus";
+        readonly type: "(e: FocusEvent) => void";
+        readonly default: "undefined";
+        readonly desc: "组级聚焦（子控件 focusin 冒泡）";
+    }, {
+        readonly name: "onBlur";
+        readonly type: "(e: FocusEvent) => void";
+        readonly default: "undefined";
+        readonly desc: "组级失焦（子控件 focusout 冒泡）";
+    }, {
+        readonly name: "class";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "根节点自定义类名";
+    }, {
+        readonly name: "style";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "根节点自定义内联样式";
+    }, {
+        readonly name: "children";
+        readonly type: "Snippet";
+        readonly default: "undefined";
+        readonly desc: "子输入控件";
+    }];
+    readonly events: readonly [{
+        readonly name: "onFocus";
+        readonly desc: "组内控件获得焦点";
+    }, {
+        readonly name: "onBlur";
+        readonly desc: "组内控件失去焦点";
+    }];
+    readonly slots: readonly [{
+        readonly name: "children";
+        readonly desc: "子输入控件（Input/Select/DatePicker 等）";
+    }];
+    readonly a11y: {
+        readonly role: "group";
+        readonly notes: readonly ["单层 span role=group（对齐 Semi）", "有 label 时 label[for] 关联 group[id]", "各子控件保留自身 a11y"];
+    };
+    readonly tokens: readonly ["--cd-color-input-group-border-default", "--cd-width-input-group-pseudo-border", "--cd-radius-input-wrapper"];
+};
+/**
+ * TextArea meta（保留具名导出供 TextArea demo/文档局部引用与测试）。
+ * 严格对齐 Semi：不带 category，故不作为独立组件进侧边栏——信息复用 Input.subComponents[0]。
+ */
+export declare const textareaMeta: {
+    readonly name: "TextArea";
+    readonly semiEquivalent: "TextArea";
+    readonly usage: "<TextArea autosize maxCount={100} showClear />";
+    readonly desc: "多行文本录入框，支持计数（maxCount/getValueLength）、清除、校验态、IME、autosize 自适应高度、行号、resize 全值域。严格对齐 Semi。";
+    readonly capabilities: readonly ["multiline", "autosize", "char-count", "clearable", "validation-status", "line-number"];
+    readonly props: readonly [{
+        readonly name: "value";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "受控值；提供则为受控";
+    }, {
+        readonly name: "defaultValue";
+        readonly type: "string";
+        readonly default: "''";
+        readonly desc: "非受控初始值";
+    }, {
+        readonly name: "size";
+        readonly type: "'small'|'default'|'large'";
+        readonly default: "'default'";
+    }, {
+        readonly name: "disabled";
+        readonly type: "boolean";
+        readonly default: "false";
+    }, {
+        readonly name: "readonly";
+        readonly type: "boolean";
+        readonly default: "false";
+    }, {
+        readonly name: "placeholder";
+        readonly type: "string";
+        readonly default: "undefined";
+    }, {
+        readonly name: "showCount";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "显示字数统计（对齐 Semi showCounter；maxCount 存在时亦显示）";
+    }, {
+        readonly name: "maxLength";
+        readonly type: "number";
+        readonly default: "undefined";
+        readonly desc: "原生硬性长度限制（截断输入）";
+    }, {
+        readonly name: "maxCount";
+        readonly type: "number";
+        readonly default: "undefined";
+        readonly desc: "计数上限（计数展示与超限提示，不截断，对齐 Semi）";
+    }, {
+        readonly name: "showClear";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "有内容且 hover/focus 时展示清除按钮（对齐 Semi）";
+    }, {
+        readonly name: "autoFocus";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "挂载后自动聚焦";
+    }, {
+        readonly name: "validateStatus";
+        readonly type: "'default'|'warning'|'error'|'success'";
+        readonly default: "'default'";
+        readonly desc: "校验态（对齐 Semi validateStatus）";
+    }, {
+        readonly name: "rows";
+        readonly type: "number";
+        readonly default: "4";
+        readonly desc: "默认行数（对齐 Semi）";
+    }, {
+        readonly name: "cols";
+        readonly type: "number";
+        readonly default: "undefined";
+        readonly desc: "默认列数（对齐 Semi cols）";
+    }, {
+        readonly name: "autosize";
+        readonly type: "boolean | { minRows?: number; maxRows?: number }";
+        readonly default: "false";
+        readonly desc: "随内容自适应高度（对齐 Semi）";
+    }, {
+        readonly name: "resize";
+        readonly type: "'none'|'both'|'horizontal'|'vertical'|'block'|'inline'";
+        readonly default: "undefined";
+        readonly desc: "拖拽调整方向（对齐 Semi resize 全值域）；autosize 时忽略；仅显式传入生效";
+    }, {
+        readonly name: "borderless";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "无边框模式（对齐 Semi borderless）";
+    }, {
+        readonly name: "showLineNumber";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "展示行号（对齐 Semi showLineNumber）";
+    }, {
+        readonly name: "lineNumberStart";
+        readonly type: "number";
+        readonly default: "1";
+        readonly desc: "行号起始值（对齐 Semi lineNumberStart）";
+    }, {
+        readonly name: "lineNumberClassName";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "行号区自定义类名（对齐 Semi）";
+    }, {
+        readonly name: "lineNumberStyle";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "行号区自定义样式（对齐 Semi）";
+    }, {
+        readonly name: "textareaStyle";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "textarea 元素样式，可设高度等（对齐 Semi textareaStyle）";
+    }, {
+        readonly name: "getValueLength";
+        readonly type: "(value: string) => number";
+        readonly default: "undefined";
+        readonly desc: "自定义字符计数函数（对齐 Semi getValueLength）";
+    }, {
+        readonly name: "disabledEnterStartNewLine";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "禁用 Enter 换行（Shift+Enter 才换行，对齐 Semi，Chat 场景用）";
+    }, {
+        readonly name: "composition";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "输入法模式：开启后 IME 未确认期间不触发 onChange，确认后触发一次（对齐 Semi）";
+    }, {
+        readonly name: "name";
+        readonly type: "string";
+        readonly default: "undefined";
+    }, {
+        readonly name: "id";
+        readonly type: "string";
+        readonly default: "undefined";
+    }, {
+        readonly name: "class";
+        readonly type: "string";
+        readonly default: "''";
+        readonly desc: "根容器自定义类名（对齐 Semi className）";
+    }, {
+        readonly name: "style";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "根容器内联样式（对齐 Semi style）";
+    }, {
+        readonly name: "ariaLabel";
+        readonly type: "string";
+        readonly default: "undefined";
+    }, {
+        readonly name: "ariaLabelledby";
+        readonly type: "string";
+        readonly default: "undefined";
+    }, {
+        readonly name: "ariaDescribedby";
+        readonly type: "string";
+        readonly default: "undefined";
+    }, {
+        readonly name: "ariaErrormessage";
+        readonly type: "string";
+        readonly default: "undefined";
+    }, {
+        readonly name: "ariaRequired";
+        readonly type: "boolean";
+        readonly default: "undefined";
+    }, {
+        readonly name: "onChange";
+        readonly type: "(value: string, e: Event) => void";
+        readonly default: "undefined";
+        readonly desc: "内容变化（对齐 Semi：第二参为原生事件）";
+    }, {
+        readonly name: "onInput";
+        readonly type: "(value: string, e: Event) => void";
+        readonly default: "undefined";
+    }, {
+        readonly name: "onClear";
+        readonly type: "(e: MouseEvent) => void";
+        readonly default: "undefined";
+        readonly desc: "点击清除按钮（对齐 Semi：透传鼠标事件）";
     }, {
         readonly name: "onFocus";
         readonly type: "(e: FocusEvent) => void";
         readonly default: "undefined";
+        readonly desc: "获得焦点";
     }, {
         readonly name: "onBlur";
         readonly type: "(e: FocusEvent) => void";
         readonly default: "undefined";
+        readonly desc: "失去焦点";
+    }, {
+        readonly name: "onEnterPress";
+        readonly type: "(e: KeyboardEvent) => void";
+        readonly default: "undefined";
+        readonly desc: "按下 Enter（透传原生事件，对齐 Semi；composition 中不触发）";
+    }, {
+        readonly name: "onPressEnter";
+        readonly type: "(e: KeyboardEvent) => void";
+        readonly default: "undefined";
+        readonly desc: "onEnterPress 别名（对齐 Semi onPressEnter）";
+    }, {
+        readonly name: "onResize";
+        readonly type: "(p: { height: number; width?: number }) => void";
+        readonly default: "undefined";
+        readonly desc: "autosize 高度变化，或 resize 拖拽（含 width，对齐 Semi）";
+    }, {
+        readonly name: "onKeyDown";
+        readonly type: "(e: KeyboardEvent) => void";
+        readonly default: "undefined";
+        readonly desc: "透传原生 keydown（对齐 Semi）";
+    }, {
+        readonly name: "onKeyUp";
+        readonly type: "(e: KeyboardEvent) => void";
+        readonly default: "undefined";
+    }, {
+        readonly name: "onKeyPress";
+        readonly type: "(e: KeyboardEvent) => void";
+        readonly default: "undefined";
+    }, {
+        readonly name: "onCompositionStart";
+        readonly type: "(e: CompositionEvent) => void";
+        readonly default: "undefined";
+        readonly desc: "IME 开始";
+    }, {
+        readonly name: "onCompositionEnd";
+        readonly type: "(e: CompositionEvent) => void";
+        readonly default: "undefined";
+        readonly desc: "IME 结束";
+    }, {
+        readonly name: "onCompositionUpdate";
+        readonly type: "(e: CompositionEvent) => void";
+        readonly default: "undefined";
+    }];
+    readonly methods: readonly [{
+        readonly name: "focus()";
+        readonly desc: "命令式聚焦（对齐 Semi）";
+    }, {
+        readonly name: "blur()";
+        readonly desc: "命令式失焦（对齐 Semi）";
+    }];
+    readonly slots: readonly [{
+        readonly name: "count";
+        readonly scope: "{ count, maxCount, overLimit }";
+        readonly desc: "自定义计数器渲染（覆盖内建，本库超集扩展）";
+    }, {
+        readonly name: "clearIcon";
+        readonly desc: "自定义清除图标";
     }];
     readonly a11y: {
         readonly role: "textbox";
-        readonly notes: readonly ["原生 input", "error 时 aria-invalid", "密码切换 aria-pressed", "清除按钮 aria-label"];
+        readonly notes: readonly ["原生 textarea", "error 时 aria-invalid", "IME composition 安全", "超限经 aria-live=polite 播报", "清除按钮为无 aria-label / role 的 div（对齐 Semi）"];
     };
-    readonly tokens: readonly ["--cd-input-*", "--cd-focus-ring", "--cd-motion-*"];
+    readonly i18nKeys: readonly ["Textarea.countFormat", "Textarea.countOnly", "Textarea.overLimitAnnounce"];
+    readonly tokens: readonly ["--cd-color-input-*", "--cd-color-textarea-*", "--cd-spacing-textarea-*", "--cd-radius-input-wrapper"];
 };
 //# sourceMappingURL=meta.d.ts.map