@chenzy-design/svelte 0.3.0 → 0.4.1

package/dist/tag-input/TagInput.svelte.d.ts

@@ -1,46 +1,78 @@
 import type { Snippet } from 'svelte';
 type Size = 'small' | 'default' | 'large';
-type Status = 'default' | 'warning' | 'error';
+type ValidateStatus = 'default' | 'warning' | 'error';
+/** showContentTooltip 传对象时透传给 Popover 的配置（对齐 Semi ShowTooltip）。 */
+type ShowTooltip = {
+    type?: 'popover' | 'tooltip';
+    opts?: Record<string, unknown>;
+};
 interface Props {
     value?: string[];
     defaultValue?: string[];
     inputValue?: string;
-    defaultInputValue?: string;
     placeholder?: string;
     size?: Size;
-    status?: Status;
+    /** 校验状态样式（对齐 Semi validateStatus）。 */
+    validateStatus?: ValidateStatus;
     disabled?: boolean;
-    readonly?: boolean;
     max?: number;
     maxLength?: number;
-    maxTagTextLength?: number;
+    /** 分隔符：Enter 提交时按此拆分输入为多标签（对齐 Semi，默认 ','）。 */
     separator?: string | string[];
     addOnBlur?: boolean;
+    /** 是否允许重复标签（对齐 Semi，默认 true）。 */
     allowDuplicates?: boolean;
-    trimWhitespace?: boolean;
     draggable?: boolean;
+    /** 自定义分隔处理函数：给定输入文本与分隔符，返回拆分后的标签数组（对齐 Semi split，优先于内置拆分）。 */
+    split?: (value: string, separator: string | string[]) => string[];
+    /** 输入框前缀（string/图标自动带间隔）。 */
+    prefix?: string | Snippet;
+    /** 内嵌 label（前缀位，对齐 Semi insetLabel）。 */
+    insetLabel?: string | Snippet;
+    /** 内嵌 label 的 id（关联输入，对齐 Semi insetLabelId）。 */
+    insetLabelId?: string;
+    /** 输入框后缀。 */
+    suffix?: string | Snippet;
+    /** 标签最大展示数量，超出部分折叠为 +N。 */
+    maxTagCount?: number;
+    /** 超出 maxTagCount 后 hover +N 是否用 Popover 展示剩余标签（默认 true）。 */
+    showRestTagsPopover?: boolean;
+    /** +N 的 Popover 配置透传（position/spacing/zIndex 等，对齐 Semi restTagsPopoverProps）。 */
+    restTagsPopoverProps?: Record<string, unknown>;
+    /** 点击 +N 是否展开剩余标签（默认 true）。 */
+    expandRestTagsOnClick?: boolean;
+    /** 标签文本截断时 hover 是否用 Tooltip 显示全文（默认 true；对齐 Semi showContentTooltip）。 */
+    showContentTooltip?: boolean | ShowTooltip;
     onChange?: (tags: string[]) => void;
     onInputChange?: (value: string) => void;
     ariaLabel?: string;
-    /** 透传给内部 input 的额外属性（除 value/onChange/onKeyDown 外） */
-    inputProps?: Record<string, unknown>;
-    /** 完全自定义 tag 渲染 */
+    /** aria-labelledby：关联外部 label 元素（Form.Field 透传 labelId，对齐 Semi）。 */
+    ariaLabelledby?: string;
+    /** aria-describedby：关联 helpText / extraText（Form.Field 透传）。 */
+    ariaDescribedby?: string;
+    /** aria-errormessage：error 态关联错误信息容器（Form.Field 透传）。 */
+    ariaErrormessage?: string;
+    /** aria-required：必填语义（Form.Field required 透传）。 */
+    ariaRequired?: boolean;
+    /** 完全自定义 tag 渲染（对齐 Semi renderTagItem(value, index, onClose)）。 */
     renderTagItem?: Snippet<[{
         value: string;
         index: number;
         onClose: () => void;
     }]>;
-    /** 超出可见时 hover 显示 Popover（预留，当前仅存储，浮层功能可后续扩展） */
-    showRestTagsPopover?: boolean;
-    /** Popover 配置（预留） */
-    restTagsPopoverProps?: Record<string, unknown>;
     /** 显示清除全部按钮 */
     showClear?: boolean;
     /** 自定义清除图标 */
     clearIcon?: Snippet;
-    /** 超出 max 时触发 */
-    onExceed?: (value: string) => void;
-    /** 单 tag 超出 maxLength 时触发 */
+    /** 新增标签后触发，传当前完整标签数组（对齐 Semi onAdd）。 */
+    onAdd?: (addedValue: string[]) => void;
+    /** 移除单个标签时触发，传被移除值与其索引（对齐 Semi onRemove）。 */
+    onRemove?: (removedValue: string, index: number) => void;
+    /** 输入框 keydown 透传（对齐 Semi onKeyDown）。 */
+    onKeyDown?: (e: KeyboardEvent) => void;
+    /** 超出 max 时触发，传当前标签数组（对齐 Semi onExceed）。 */
+    onExceed?: (value: string[]) => void;
+    /** 单 tag 超出 maxLength 时触发（对齐 Semi onInputExceed）。 */
     onInputExceed?: (value: string) => void;
     /** 输入框失焦 */
     onBlur?: (e: FocusEvent) => void;
@@ -51,7 +83,10 @@ interface Props {
     /** 挂载自动聚焦 */
     autoFocus?: boolean;
 }
-declare const TagInput: import("svelte").Component<Props, {}, "">;
+declare const TagInput: import("svelte").Component<Props, {
+    focus: () => void;
+    blur: () => void;
+}, "">;
 type TagInput = ReturnType<typeof TagInput>;
 export default TagInput;
 //# sourceMappingURL=TagInput.svelte.d.ts.map

package/dist/tag-input/TagInput.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TagInput.svelte.d.ts","sourceRoot":"","sources":["../../src/tag-input/TagInput.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAKpC,KAAK,IAAI,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;AAC1C,KAAK,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAE9C,UAAU,KAAK;IACb,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC9B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IACpC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,mBAAmB;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,IAAI,CAAA;KAAE,CAAC,CAAC,CAAC;IACjF,iDAAiD;IACjD,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,qBAAqB;IACrB,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/C,eAAe;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,cAAc;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iBAAiB;IACjB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,6BAA6B;IAC7B,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,YAAY;IACZ,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,IAAI,CAAC;IACjC,YAAY;IACZ,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,IAAI,CAAC;IAClC,kBAAkB;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,aAAa;IACb,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAwTH,QAAA,MAAM,QAAQ,2CAAwC,CAAC;AACvD,KAAK,QAAQ,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC;AAC5C,eAAe,QAAQ,CAAC"}
+{"version":3,"file":"TagInput.svelte.d.ts","sourceRoot":"","sources":["../../src/tag-input/TagInput.svelte.ts"],"names":[],"mappings":"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"}

package/dist/tag-input/meta.d.ts

@@ -1,27 +1,27 @@
 /**
  * Machine-readable component metadata for AI/docs consumption.
  * See specs/00-foundation/ai-friendly.spec.md.
+ * 严格对齐 Semi tagInput props（去超集，补 insetLabel/validateStatus）。
  */
 export declare const meta: {
     readonly name: "TagInput";
     readonly category: "input";
-    readonly description: "标签输入框，支持回车 / 分隔符提交、退格删除、去重、上限与失焦提交。";
+    readonly description: "标签输入框，复用 Tag 渲染标签，支持回车 / 分隔符提交、退格删除、去重、上限与失焦提交。";
     readonly props: readonly [{
         readonly name: "value";
         readonly type: "string[]";
         readonly default: "undefined";
+        readonly desc: "受控标签数组（不回写，仅 onChange）";
     }, {
         readonly name: "defaultValue";
         readonly type: "string[]";
         readonly default: "[]";
+        readonly desc: "非受控初始标签";
     }, {
         readonly name: "inputValue";
         readonly type: "string";
         readonly default: "undefined";
-    }, {
-        readonly name: "defaultInputValue";
-        readonly type: "string";
-        readonly default: "''";
+        readonly desc: "受控输入框文本（不回写，仅 onInputChange）";
     }, {
         readonly name: "placeholder";
         readonly type: "string";
@@ -31,49 +31,119 @@ export declare const meta: {
         readonly type: "'small'|'default'|'large'";
         readonly default: "default";
     }, {
-        readonly name: "status";
+        readonly name: "validateStatus";
         readonly type: "'default'|'warning'|'error'";
         readonly default: "default";
+        readonly desc: "校验状态样式（对齐 Semi）";
     }, {
         readonly name: "disabled";
         readonly type: "boolean";
         readonly default: "false";
-    }, {
-        readonly name: "readonly";
-        readonly type: "boolean";
-        readonly default: "false";
     }, {
         readonly name: "max";
         readonly type: "number";
         readonly default: "undefined";
+        readonly desc: "标签数量上限，超出触发 onExceed 并截断";
     }, {
         readonly name: "maxLength";
         readonly type: "number";
         readonly default: "undefined";
-    }, {
-        readonly name: "maxTagTextLength";
-        readonly type: "number";
-        readonly default: "undefined";
+        readonly desc: "单个标签最大字符数";
     }, {
         readonly name: "separator";
         readonly type: "string|string[]";
-        readonly default: "['Enter']";
+        readonly default: "','";
+        readonly desc: "Enter 提交时按此拆分输入为多标签（对齐 Semi 默认逗号）";
     }, {
         readonly name: "addOnBlur";
         readonly type: "boolean";
         readonly default: "false";
+        readonly desc: "失焦时自动提交输入";
     }, {
         readonly name: "allowDuplicates";
         readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "是否允许重复标签（对齐 Semi 默认 true）";
+    }, {
+        readonly name: "draggable";
+        readonly type: "boolean";
         readonly default: "false";
+        readonly desc: "标签可拖拽重排";
+    }, {
+        readonly name: "split";
+        readonly type: "(value: string, separator: string | string[]) => string[]";
+        readonly default: "undefined";
+        readonly desc: "自定义分隔处理函数（对齐 Semi，优先于内置拆分）";
+    }, {
+        readonly name: "prefix";
+        readonly type: "string | Snippet";
+        readonly default: "undefined";
+        readonly desc: "输入框前缀（string/图标自动带间隔）";
     }, {
-        readonly name: "trimWhitespace";
+        readonly name: "insetLabel";
+        readonly type: "string | Snippet";
+        readonly default: "undefined";
+        readonly desc: "内嵌 label（前缀位，对齐 Semi）";
+    }, {
+        readonly name: "insetLabelId";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "内嵌 label 的 id（对齐 Semi）";
+    }, {
+        readonly name: "suffix";
+        readonly type: "string | Snippet";
+        readonly default: "undefined";
+        readonly desc: "输入框后缀";
+    }, {
+        readonly name: "maxTagCount";
+        readonly type: "number";
+        readonly default: "undefined";
+        readonly desc: "标签最大展示数量，超出折叠为 +N";
+    }, {
+        readonly name: "showRestTagsPopover";
         readonly type: "boolean";
         readonly default: "true";
+        readonly desc: "hover +N 是否用 Popover 展示剩余标签";
     }, {
-        readonly name: "draggable";
+        readonly name: "restTagsPopoverProps";
+        readonly type: "Record<string, unknown>";
+        readonly default: "undefined";
+        readonly desc: "+N Popover 配置透传（对齐 Semi）";
+    }, {
+        readonly name: "expandRestTagsOnClick";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "点击 +N 是否展开剩余标签";
+    }, {
+        readonly name: "showContentTooltip";
+        readonly type: "boolean | { type?: string; opts?: object }";
+        readonly default: "true";
+        readonly desc: "标签文本截断时 hover 显示全文（对齐 Semi，可传 Popover 配置）";
+    }, {
+        readonly name: "showClear";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "显示清除全部按钮";
+    }, {
+        readonly name: "clearIcon";
+        readonly type: "Snippet";
+        readonly default: "undefined";
+        readonly desc: "自定义清除图标";
+    }, {
+        readonly name: "preventScroll";
         readonly type: "boolean";
         readonly default: "false";
+        readonly desc: "focus 时阻止滚动";
+    }, {
+        readonly name: "autoFocus";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "挂载自动聚焦";
+    }, {
+        readonly name: "renderTagItem";
+        readonly type: "Snippet<[{ value: string; index: number; onClose: () => void }]>";
+        readonly default: "undefined";
+        readonly desc: "完全自定义 tag 渲染（对齐 Semi renderTagItem(value, index, onClose)）";
     }, {
         readonly name: "onChange";
         readonly type: "(tags: string[]) => void";
@@ -82,16 +152,58 @@ export declare const meta: {
         readonly name: "onInputChange";
         readonly type: "(value: string) => void";
         readonly default: "undefined";
+    }, {
+        readonly name: "onAdd";
+        readonly type: "(addedValue: string[]) => void";
+        readonly default: "undefined";
+        readonly desc: "新增标签后触发，传当前完整数组（对齐 Semi）";
+    }, {
+        readonly name: "onRemove";
+        readonly type: "(removedValue: string, index: number) => void";
+        readonly default: "undefined";
+        readonly desc: "移除单个标签时触发（对齐 Semi）";
+    }, {
+        readonly name: "onKeyDown";
+        readonly type: "(e: KeyboardEvent) => void";
+        readonly default: "undefined";
+        readonly desc: "输入框 keydown 透传（对齐 Semi）";
+    }, {
+        readonly name: "onExceed";
+        readonly type: "(value: string[]) => void";
+        readonly default: "undefined";
+        readonly desc: "超出 max 时触发，传当前标签数组（对齐 Semi）";
+    }, {
+        readonly name: "onInputExceed";
+        readonly type: "(value: string) => void";
+        readonly default: "undefined";
+        readonly desc: "单 tag 超出 maxLength 时触发";
+    }, {
+        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: "ariaLabel";
         readonly type: "string";
         readonly default: "undefined";
     }];
+    readonly methods: readonly [{
+        readonly name: "focus()";
+        readonly desc: "命令式聚焦输入框（尊重 preventScroll，对齐 Semi）";
+    }, {
+        readonly name: "blur()";
+        readonly desc: "命令式移除焦点（对齐 Semi）";
+    }];
     readonly a11y: {
         readonly role: "group";
-        readonly notes: readonly ["容器 role=group + aria-label", "每个标签删除按钮含 aria-label，文案取自 locale（TagInput.remove，默认中文「删除」）", "键盘：分隔符（默认 Enter）提交、输入为空时 Backspace 删除末尾标签", "draggable 仅为鼠标增强（HTML5 DnD）；键盘增删标签交互不受影响", "error 状态时 aria-invalid 标注于内部输入"];
+        readonly notes: readonly ["容器 role=group + aria-label", "标签复用 Tag 组件，关闭按钮由 Tag 提供（closable）", "键盘：Enter 提交（按 separator 拆分）、输入为空时 Backspace 删除末尾标签", "draggable 仅为鼠标增强（HTML5 DnD）；键盘交互不受影响", "error 状态时 aria-invalid 标注于容器"];
     };
-    readonly i18nKeys: readonly ["TagInput.remove"];
-    readonly tokens: readonly ["--cd-input-*", "--cd-focus-ring", "--cd-motion-*", "--cd-color-fill-*"];
+    readonly i18nKeys: readonly ["TagInput.clear"];
+    readonly tokens: readonly ["--cd-tag-input-*"];
 };
 //# sourceMappingURL=meta.d.ts.map

package/dist/tag-input/meta.d.ts.map

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

package/dist/tag-input/meta.js

@@ -1,43 +1,71 @@
 /**
  * Machine-readable component metadata for AI/docs consumption.
  * See specs/00-foundation/ai-friendly.spec.md.
+ * 严格对齐 Semi tagInput props（去超集，补 insetLabel/validateStatus）。
  */
 export const meta = {
     name: 'TagInput',
     category: 'input',
-    description: '标签输入框，支持回车 / 分隔符提交、退格删除、去重、上限与失焦提交。',
+    description: '标签输入框，复用 Tag 渲染标签，支持回车 / 分隔符提交、退格删除、去重、上限与失焦提交。',
     props: [
-        { name: 'value', type: 'string[]', default: 'undefined' },
-        { name: 'defaultValue', type: 'string[]', default: '[]' },
-        { name: 'inputValue', type: 'string', default: 'undefined' },
-        { name: 'defaultInputValue', type: 'string', default: "''" },
+        { name: 'value', type: 'string[]', default: 'undefined', desc: '受控标签数组（不回写，仅 onChange）' },
+        { name: 'defaultValue', type: 'string[]', default: '[]', desc: '非受控初始标签' },
+        { name: 'inputValue', type: 'string', default: 'undefined', desc: '受控输入框文本（不回写，仅 onInputChange）' },
         { name: 'placeholder', type: 'string', default: 'undefined' },
         { name: 'size', type: "'small'|'default'|'large'", default: 'default' },
-        { name: 'status', type: "'default'|'warning'|'error'", default: 'default' },
+        { name: 'validateStatus', type: "'default'|'warning'|'error'", default: 'default', desc: '校验状态样式（对齐 Semi）' },
         { name: 'disabled', type: 'boolean', default: 'false' },
-        { name: 'readonly', type: 'boolean', default: 'false' },
-        { name: 'max', type: 'number', default: 'undefined' },
-        { name: 'maxLength', type: 'number', default: 'undefined' },
-        { name: 'maxTagTextLength', type: 'number', default: 'undefined' },
-        { name: 'separator', type: 'string|string[]', default: "['Enter']" },
-        { name: 'addOnBlur', type: 'boolean', default: 'false' },
-        { name: 'allowDuplicates', type: 'boolean', default: 'false' },
-        { name: 'trimWhitespace', type: 'boolean', default: 'true' },
-        { name: 'draggable', type: 'boolean', default: 'false' },
+        { name: 'max', type: 'number', default: 'undefined', desc: '标签数量上限，超出触发 onExceed 并截断' },
+        { name: 'maxLength', type: 'number', default: 'undefined', desc: '单个标签最大字符数' },
+        { name: 'separator', type: 'string|string[]', default: "','", desc: 'Enter 提交时按此拆分输入为多标签（对齐 Semi 默认逗号）' },
+        { name: 'addOnBlur', type: 'boolean', default: 'false', desc: '失焦时自动提交输入' },
+        { name: 'allowDuplicates', type: 'boolean', default: 'true', desc: '是否允许重复标签（对齐 Semi 默认 true）' },
+        { name: 'draggable', type: 'boolean', default: 'false', desc: '标签可拖拽重排' },
+        { name: 'split', type: '(value: string, separator: string | string[]) => string[]', default: 'undefined', desc: '自定义分隔处理函数（对齐 Semi，优先于内置拆分）' },
+        { name: 'prefix', type: 'string | Snippet', default: 'undefined', desc: '输入框前缀（string/图标自动带间隔）' },
+        { name: 'insetLabel', type: 'string | Snippet', default: 'undefined', desc: '内嵌 label（前缀位，对齐 Semi）' },
+        { name: 'insetLabelId', type: 'string', default: 'undefined', desc: '内嵌 label 的 id（对齐 Semi）' },
+        { name: 'suffix', type: 'string | Snippet', default: 'undefined', desc: '输入框后缀' },
+        { name: 'maxTagCount', type: 'number', default: 'undefined', desc: '标签最大展示数量，超出折叠为 +N' },
+        { name: 'showRestTagsPopover', type: 'boolean', default: 'true', desc: 'hover +N 是否用 Popover 展示剩余标签' },
+        { name: 'restTagsPopoverProps', type: 'Record<string, unknown>', default: 'undefined', desc: '+N Popover 配置透传（对齐 Semi）' },
+        { name: 'expandRestTagsOnClick', type: 'boolean', default: 'true', desc: '点击 +N 是否展开剩余标签' },
+        { name: 'showContentTooltip', type: 'boolean | { type?: string; opts?: object }', default: 'true', desc: '标签文本截断时 hover 显示全文（对齐 Semi，可传 Popover 配置）' },
+        { name: 'showClear', type: 'boolean', default: 'false', desc: '显示清除全部按钮' },
+        { name: 'clearIcon', type: 'Snippet', default: 'undefined', desc: '自定义清除图标' },
+        { name: 'preventScroll', type: 'boolean', default: 'false', desc: 'focus 时阻止滚动' },
+        { name: 'autoFocus', type: 'boolean', default: 'false', desc: '挂载自动聚焦' },
+        {
+            name: 'renderTagItem',
+            type: 'Snippet<[{ value: string; index: number; onClose: () => void }]>',
+            default: 'undefined',
+            desc: '完全自定义 tag 渲染（对齐 Semi renderTagItem(value, index, onClose)）',
+        },
         { name: 'onChange', type: '(tags: string[]) => void', default: 'undefined' },
         { name: 'onInputChange', type: '(value: string) => void', default: 'undefined' },
+        { name: 'onAdd', type: '(addedValue: string[]) => void', default: 'undefined', desc: '新增标签后触发，传当前完整数组（对齐 Semi）' },
+        { name: 'onRemove', type: '(removedValue: string, index: number) => void', default: 'undefined', desc: '移除单个标签时触发（对齐 Semi）' },
+        { name: 'onKeyDown', type: '(e: KeyboardEvent) => void', default: 'undefined', desc: '输入框 keydown 透传（对齐 Semi）' },
+        { name: 'onExceed', type: '(value: string[]) => void', default: 'undefined', desc: '超出 max 时触发，传当前标签数组（对齐 Semi）' },
+        { name: 'onInputExceed', type: '(value: string) => void', default: 'undefined', desc: '单 tag 超出 maxLength 时触发' },
+        { name: 'onFocus', type: '(e: FocusEvent) => void', default: 'undefined', desc: '输入框聚焦' },
+        { name: 'onBlur', type: '(e: FocusEvent) => void', default: 'undefined', desc: '输入框失焦' },
         { name: 'ariaLabel', type: 'string', default: 'undefined' },
     ],
+    methods: [
+        { name: 'focus()', desc: '命令式聚焦输入框（尊重 preventScroll，对齐 Semi）' },
+        { name: 'blur()', desc: '命令式移除焦点（对齐 Semi）' },
+    ],
     a11y: {
         role: 'group',
         notes: [
             '容器 role=group + aria-label',
-            '每个标签删除按钮含 aria-label，文案取自 locale（TagInput.remove，默认中文「删除」）',
-            '键盘：分隔符（默认 Enter）提交、输入为空时 Backspace 删除末尾标签',
-            'draggable 仅为鼠标增强（HTML5 DnD）；键盘增删标签交互不受影响',
-            'error 状态时 aria-invalid 标注于内部输入',
+            '标签复用 Tag 组件，关闭按钮由 Tag 提供（closable）',
+            '键盘：Enter 提交（按 separator 拆分）、输入为空时 Backspace 删除末尾标签',
+            'draggable 仅为鼠标增强（HTML5 DnD）；键盘交互不受影响',
+            'error 状态时 aria-invalid 标注于容器',
         ],
     },
-    i18nKeys: ['TagInput.remove'],
-    tokens: ['--cd-input-*', '--cd-focus-ring', '--cd-motion-*', '--cd-color-fill-*'],
+    i18nKeys: ['TagInput.clear'],
+    tokens: ['--cd-tag-input-*'],
 };

package/dist/tag-input/split.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 输入文本按分隔符拆分（对齐 Semi semi-foundation/tagInput/utils/getSplitedArray）。
+ * 纯函数，便于单测。
+ * - separator 为 string：直接 String.split。
+ * - separator 为 string[]：以首个为临时分隔符，把其余全部替换为它后再一次性拆分。
+ */
+export declare function getSplitedArray(originString: string, separators: string | string[]): string[];
+//# sourceMappingURL=split.d.ts.map

package/dist/tag-input/split.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"split.d.ts","sourceRoot":"","sources":["../../src/tag-input/split.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,GAC5B,MAAM,EAAE,CAcV"}

package/dist/tag-input/split.js

@@ -0,0 +1,22 @@
+/**
+ * 输入文本按分隔符拆分（对齐 Semi semi-foundation/tagInput/utils/getSplitedArray）。
+ * 纯函数，便于单测。
+ * - separator 为 string：直接 String.split。
+ * - separator 为 string[]：以首个为临时分隔符，把其余全部替换为它后再一次性拆分。
+ */
+export function getSplitedArray(originString, separators) {
+    if (typeof separators === 'string') {
+        return originString.split(separators);
+    }
+    if (Array.isArray(separators)) {
+        const [tempChar, ...rest] = separators; // 首个作临时分隔符
+        if (tempChar === undefined)
+            return [originString];
+        let joined = originString;
+        for (const sep of rest) {
+            joined = joined.split(sep).join(tempChar);
+        }
+        return joined.split(tempChar);
+    }
+    return [originString];
+}