@zerodep-dev/vue-tsx-pro-ui 0.0.0-stage → 0.1.0

package/dist/input/TagsInput.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TagsInput.js","names":["_isVNode","_vtp_bindable","_vtp_readonlyProp","_vtp_childrenProp","_vtp_restProps","_vue_shallowRef","_createVNode","_Fragment","_mergeProps","_withDirectives","_vModelText"],"sources":["../../src/input/TagsInput.tsx"],"sourcesContent":["/**\n * 标签输入（多选的组合框）：输入框里排着已选的 Tag，输入文字后回车（或输入逗号）加一个，可以从建议列表里选。\n * 关键词、收件人、标签、多个城市。参考 Mantine TagsInput、React Aria TagGroup + ComboBox。\n *\n *   <TagsInput _value={keywords} aria-label=\"关键词\" />                          自由输入\n *   <TagsInput _value={cities} items={cityOptions} allowCustomValue={false} />   只能从建议里选\n *\n * - 回车、输入分隔符（默认 , ， ; ；）把文字加成标签；粘贴时按分隔符与换行拆成多个；重复的不加；\n * - 输入框为空时按退格删掉最后一个标签；每个标签有移除按钮（离场后其余的平移补位）；\n * - 有 items 时边输入边过滤建议（同 Combobox），↑↓ 移动、回车加入或移除高亮项（已选的打勾）；\n *   异步取建议时绑定 inputValue 去请求、写 filter={false} 与 loading，结果没回来时列表显示加载中；\n * - 写了 name 时每个值一个隐藏的 input 随表单提交。\n *\n * 未声明的属性落到 input（主元素）上。部件：Root（外壳）、Tag、Input、Clear、Popover、Listbox。\n */\nimport { _component } from '@zerodep-dev/vue-tsx-pro-tsx';\nimport * as css from '@zerodep-dev/vue-tsx-pro-tsx/styles';\nimport { useId, watch, type VNodeChild } from 'vue';\nimport type { PresetIconButtonProps } from '../base/CloseButton';\nimport { Tag, type TagProps } from '../base/Tag';\nimport { useTextMatcher } from '../config/context';\nimport { isComposingKey } from '../utils/dom/hotkeys';\nimport { useAnchoredPopover, type FloatingPlacement } from '../utils/dom/floating';\nimport { openSetter, type OpenChangeProps } from '../utils/dom/open-change';\nimport { ListPopover } from './ListPopover';\nimport { useLayoutAnimation } from '../utils/motion/layout';\nimport { mergeAttrs, mergePartProps, type PartProps } from '../utils/props';\nimport {\n  controlClear,\n  controlParts,\n  focusOnShell,\n  controlIcon,\n  useControlAppearance,\n  type ControlIconOptions,\n  type ControlOptions,\n} from './control';\nimport { useFieldControl } from '../form/Field';\nimport { FormValue } from '../form/FormValue';\nimport { activeOptionId, type ListboxViewProps, type OptionRenderState } from './Listbox';\nimport {\n  handleListKeydown,\n  useListState,\n  useSelectedOptions,\n  type ListboxOption,\n  type OptionMapping,\n  toListboxOption,\n} from './list-state';\n\n/** 角色、展开状态与可用性由组件管理 */\nexport type TagsInputManaged =\n  | 'value'\n  | 'role'\n  | 'size'\n  | 'disabled'\n  | 'readonly'\n  | 'autocomplete'\n  | 'aria-autocomplete'\n  | 'aria-expanded'\n  | 'aria-controls'\n  | 'aria-activedescendant'\n  | 'aria-invalid'\n  | 'aria-required'\n  | 'aria-describedby';\n\n/** TagsInput 除 toOption 外的属性；未声明的属性落到 input（主元素）上，外壳用 propsRoot */\nexport interface TagsInputBaseProps<T>\n  extends\n    PartProps<'input', TagsInputManaged>,\n    ControlOptions,\n    ControlIconOptions,\n    OpenChangeProps {\n  /** 已选的值：父级写 _value={list} */\n  _value?: string[];\n  /** 建议：ListboxOption、字符串，或任意数据加 toOption；不给时是纯自由输入 */\n  items?: readonly T[];\n  /** 允许加入不在建议里的文字，默认 true */\n  allowCustomValue?: boolean;\n  /** 失焦时把输入框里还没确认的文字加成标签，默认 true（同 Mantine）；false 时文字留在框里 */\n  acceptOnBlur?: boolean;\n  /** 把输入拆成标签的分隔符，默认 [',', '，', ';', '；']；回车与粘贴里的换行总是分隔 */\n  delimiters?: readonly string[];\n  /** 最多几个标签；到了上限不再加入 */\n  max?: number;\n  /** 输入框里的文字：父级可以写 _inputValue={x}（异步取建议时据此搜索） */\n  _inputValue?: string;\n  /** 建议列表是否打开 */\n  _open?: boolean;\n  /** 过滤建议：默认按显示文字包含输入；false 不过滤（异步搜索） */\n  filter?: false | ((item: T, query: string) => boolean);\n  /** 正在取建议 */\n  loading?: boolean;\n  /** 弹出位置，默认 bottom-start */\n  placement?: FloatingPlacement;\n  /** 有标签时显示清空按钮 */\n  clearable?: boolean;\n  /** 表单提交时的 name（每个值一个隐藏的 input） */\n  name?: string;\n  /** 不可用 */\n  disabled?: boolean;\n  /** 只读：标签不能移除，不能输入 */\n  readonly?: boolean;\n  /** 必填：至少要有一个标签（读屏念“必填”；校验交给表单） */\n  required?: boolean;\n  /** 校验未通过 */\n  invalid?: boolean;\n  /** 自定义建议的内容 */\n  children?: (item: T, state: OptionRenderState) => VNodeChild;\n  /** 外壳的部件属性 */\n  propsRoot?: PartProps<'div'>;\n  /** 每个标签的部件属性，可以按值计算 */\n  propsTag?: Partial<TagProps> | ((value: string) => Partial<TagProps>);\n  /** 清空按钮的部件属性 */\n  propsClear?: Partial<PresetIconButtonProps>;\n  /** 弹出层的部件属性 */\n  propsPopover?: PartProps<'div', 'id' | 'popover'>;\n  /** 建议列表的部件属性 */\n  propsListbox?: Partial<ListboxViewProps<T>>;\n}\n\n/** 标签输入的属性；items 不是 ListboxOption 或字符串时要给 toOption */\nexport type TagsInputProps<T = ListboxOption> = TagsInputBaseProps<T> & OptionMapping<T>;\n\n/** TagsInput 的样式：root、input、popover */\nexport const tagsInputStyles = css.create({\n  // 标签多了换行；行与行之间留出间距\n  root: { flexWrap: 'wrap', rowGap: '_xs', paddingBlock: '_xs' },\n  // 输入框至少留出几个字的位置，放不下时换到下一行\n  input: { flexBasis: '6em' },\n});\n\n/** 默认的分隔符：英文、中文的逗号与分号 */\nconst DELIMITERS = [',', '，', ';', '；'];\n\n/** 标签输入：输入框里排着 Tag，回车或分隔符加入，退格删最后一个 */\nexport const TagsInput = _component(\n  <T = ListboxOption,>({\n    _value: value = _bindable<string[]>([]),\n    items = [],\n    toOption,\n    allowCustomValue = true,\n    acceptOnBlur = true,\n    delimiters = DELIMITERS,\n    max,\n    _inputValue: inputValue = _bindable(''),\n    _open: open = _bindable(false),\n    onOpenChange,\n    filter,\n    loading = false,\n    placement = 'bottom-start',\n    clearable = false,\n    name,\n    variant,\n    size,\n    radius,\n    disabled,\n    readonly,\n    required,\n    invalid,\n    id,\n    children,\n    propsRoot,\n    icon,\n    propsIcon,\n    propsTag,\n    propsClear,\n    propsPopover,\n    propsListbox,\n    ...rest\n  }: TagsInputProps<T>) => {\n    const textMatcher = useTextMatcher();\n    const listId = useId();\n    const appearance = useControlAppearance(() => ({ variant, size, radius }));\n    const control = useFieldControl(() => ({ id, invalid, required, disabled, readonly }));\n    let shell = _state.raw<HTMLElement | null>(null);\n    let input = _state.raw<HTMLInputElement | null>(null);\n    let panel = _state.raw<HTMLElement | null>(null);\n    // 标签增删时其余的平移补位\n    const layout = useLayoutAnimation(() => shell, { children: '[data-tag]' });\n\n    const setOpen = openSetter(\n      () => open,\n      (next) => (open = next),\n      () => onOpenChange,\n    );\n    const optionOf = (item: T) => toListboxOption(item, toOption);\n    // 异步搜索（filter={false}）时结果可能还没回来：建议列表与 combobox 角色一直在，等待时显示加载中\n    const suggestions = () => items.length > 0 || filter === false;\n    // 标签的文字：异步建议换了 items 之后，已选的仍按之前见过的文字显示；自定义的值就是文字\n    const selectedOf = useSelectedOptions({ items: () => items, toOption: optionOf });\n    const labelOf = (tag: string) => selectedOf([tag])[0]!.label;\n\n    const list = useListState({\n      items: () => {\n        const query = inputValue.trim();\n        if (filter === false || !query) return items;\n        const matcher = textMatcher();\n        return items.filter((item) =>\n          filter ? filter(item, query) : matcher(optionOf(item).label, query),\n        );\n      },\n      toOption: optionOf,\n      selected: () => value,\n      mode: () => 'multiple',\n      onChange: (next) => void layout.change(() => (value = [...next])),\n    });\n\n    /** 把一段文字变成值：是建议的文字或值时取建议的值，否则（允许时）原样 */\n    function resolve(text: string): string | undefined {\n      const trimmed = text.trim();\n      if (!trimmed) return undefined;\n      const item = items.find((candidate) => {\n        const option = optionOf(candidate);\n        return option.value === trimmed || option.label === trimmed;\n      });\n      if (item !== undefined) return optionOf(item).value;\n      return allowCustomValue ? trimmed : undefined;\n    }\n\n    /** 加入几段文字；重复的、超出上限的不加；返回是否加入了 */\n    function add(texts: readonly string[]) {\n      const next = [...value];\n      for (const text of texts) {\n        const tag = resolve(text);\n        if (tag === undefined || next.includes(tag) || (max != null && next.length >= max))\n          continue;\n        next.push(tag);\n      }\n      if (next.length === value.length) return false;\n      void layout.change(() => (value = next));\n      return true;\n    }\n\n    const remove = (tag: string) =>\n      void layout.change(() => (value = value.filter((item) => item !== tag)));\n\n    const splitter = () =>\n      new RegExp(\n        `[${[...delimiters, '\\n', '\\r', '\\t'].map((d) => d.replace(/[\\\\\\]^-]/g, '\\\\$&')).join('')}]`,\n      );\n\n    // 输入了分隔符：分隔符前的部分加成标签，剩下的留在输入框里\n    watch(\n      () => inputValue,\n      (text) => {\n        const parts = text.split(splitter());\n        if (parts.length > 1) {\n          add(parts.slice(0, -1));\n          inputValue = parts.at(-1)!;\n          return;\n        }\n        if (suggestions() && text && !control().readonly) {\n          setOpen(true, 'trigger');\n          list.move('first');\n        }\n      },\n    );\n\n    function onKeydown(event: KeyboardEvent) {\n      const state = control();\n      if (state.disabled || state.readonly || isComposingKey(event)) return;\n      if (event.key === 'Backspace' && !inputValue && value.length) {\n        event.preventDefault();\n        remove(value.at(-1)!);\n        return;\n      }\n      if (open && suggestions()) {\n        if (handleListKeydown(list, event, { homeEnd: false })) {\n          event.preventDefault();\n          if (event.key === 'Enter') inputValue = '';\n          return;\n        }\n      } else if (event.key === 'ArrowDown' && suggestions()) {\n        event.preventDefault();\n        list.activateDefault();\n        setOpen(true, 'trigger', event);\n        return;\n      }\n      if (event.key === 'Enter' && inputValue.trim()) {\n        event.preventDefault();\n        if (add([inputValue])) inputValue = '';\n      }\n    }\n\n    // 粘贴多段（有分隔符、换行）时拆开加入；只有一段时照常粘贴\n    function onPaste(event: ClipboardEvent) {\n      const text = event.clipboardData?.getData('text') ?? '';\n      const parts = text.split(splitter());\n      if (parts.length < 2) return;\n      event.preventDefault();\n      add(parts);\n    }\n\n    const { onToggle } = useAnchoredPopover(\n      () => ({\n        open: open && suggestions(),\n        anchor: shell,\n        panel,\n        floating: { placement, matchWidth: true, fitHeight: true },\n        restoreFocus: false,\n      }),\n      { close: (reason, event) => setOpen(false, reason, event) },\n    );\n\n    return () => {\n      const state = control();\n      const s = controlParts(appearance(), state);\n      const editable = !state.disabled && !state.readonly;\n      return (\n        <>\n          <div\n            {...mergeAttrs<'div'>({ ...s.root, sx: [s.root.sx, tagsInputStyles.root] }, propsRoot, {\n              ref: _toRef(shell),\n              // 外壳里的标签不是原生控件的一部分：不可用要写在外壳上，辅助技术才把它们一起当作不可用\n              'aria-disabled': state.disabled || undefined,\n              onPointerdown: focusOnShell(() => input),\n            })}\n            data-state={open ? 'open' : 'closed'}\n            data-invalid={state.invalid || undefined}\n            data-disabled={state.disabled || undefined}\n          >\n            {controlIcon(s, icon, propsIcon)}\n            {value.map((tag) => {\n              const own = typeof propsTag === 'function' ? propsTag(tag) : propsTag;\n              return (\n                <Tag\n                  key={tag}\n                  {...mergePartProps<TagProps>({ variant: 'surface' }, own, {\n                    onRemove: editable ? () => remove(tag) : undefined,\n                  })}\n                  data-tag=\"\"\n                >\n                  {labelOf(tag)}\n                </Tag>\n              );\n            })}\n            <input\n              {...mergeAttrs<'input'>(\n                { ...s.input, sx: [s.input.sx, tagsInputStyles.input] },\n                rest,\n                {\n                  ref: _toRef(input),\n                  id: state.id,\n                  role: suggestions() ? 'combobox' : undefined,\n                  autocomplete: 'off',\n                  disabled: state.disabled,\n                  readonly: state.readonly,\n                  'aria-autocomplete': suggestions() ? 'list' : undefined,\n                  'aria-expanded': suggestions() ? open : undefined,\n                  'aria-controls': suggestions() ? listId : undefined,\n                  'aria-activedescendant':\n                    open && suggestions() ? activeOptionId(list, listId) : undefined,\n                  'aria-invalid': state.invalid || undefined,\n                  'aria-required': state.required || undefined,\n                  'aria-describedby': state.describedBy,\n                  onKeydown,\n                  onPaste,\n                  onBlur: (event: FocusEvent) => {\n                    setOpen(false, 'focus', event);\n                    if (\n                      acceptOnBlur &&\n                      inputValue.trim() &&\n                      !control().readonly &&\n                      add([inputValue])\n                    )\n                      inputValue = '';\n                  },\n                },\n              )}\n              _value={inputValue}\n            />\n            {clearable &&\n              value.length > 0 &&\n              editable &&\n              controlClear(s, propsClear, () => {\n                void layout.change(() => (value = []));\n                input?.focus();\n              })}\n            <FormValue name={name} value={value} disabled={state.disabled} />\n          </div>\n          {suggestions() && (\n            <ListPopover\n              panelRef={_toRef(panel)}\n              onToggle={onToggle}\n              size={appearance().size}\n              labelledBy={state.labelledBy}\n              label={rest['aria-label']}\n              loading={loading}\n              onPick={() => {\n                inputValue = '';\n                input?.focus();\n              }}\n              listbox={{ list, id: listId, multiple: true, renderOption: children }}\n              propsListbox={propsListbox}\n              propsPopover={propsPopover}\n            />\n          )}\n        </>\n      );\n    };\n  },\n);\n"],"mappings":"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"}

package/dist/input/TextField.d.ts

@@ -0,0 +1,51 @@
+import { type VNodeChild } from 'vue';
+import type { PresetIconButtonProps } from '../base/CloseButton';
+import type { IconData, IconProps } from '../base/Icon';
+import { type IconButtonProps } from '../base/IconButton';
+import { type CharacterCountProps } from './CharacterCount';
+import { type TextFormat } from './text-format';
+import { type PartProps } from '../utils/props';
+import { type ControlIconOptions, type ControlOptions } from './control';
+/** 值与状态由组件管理；原生的 size 属性（字符宽度）让给字号档位，prefix 属性（RDFa）让给前缀 */
+export type TextFieldManaged = 'value' | 'disabled' | 'readonly' | 'required' | 'size' | 'prefix' | 'aria-invalid' | 'aria-describedby';
+/** 未声明的属性落到 input（主元素）上；外壳用 propsRoot */
+export interface TextFieldProps extends PartProps<'input', TextFieldManaged>, ControlOptions, ControlIconOptions {
+    /** 输入值：父级写 _value={x} 双向绑定 */
+    _value?: string;
+    /** 显示格式：输入时自动分组（phoneFormat、idCardFormat、bankCardFormat 或 createGroupedFormat），值是去掉分隔的原文 */
+    format?: TextFormat;
+    /** 不可用 */
+    disabled?: boolean;
+    /** 只读：可以选中、复制，不能修改 */
+    readonly?: boolean;
+    /** 必填 */
+    required?: boolean;
+    /** 校验未通过 */
+    invalid?: boolean;
+    /** 有内容时显示清空按钮 */
+    clearable?: boolean;
+    /** 后置图标 */
+    iconEnd?: IconData;
+    /** 输入框前的固定文字（如 `https://`、`¥`），不算在值里 */
+    prefix?: VNodeChild;
+    /** 输入框后的固定文字（如 `.com`、`元`），不算在值里 */
+    suffix?: VNodeChild;
+    /** 显示字数计数；上限取 maxlength（含 zod 推出的约束），超出时用危险色 */
+    showCount?: boolean;
+    /** 外壳（边框、焦点环）的部件属性 */
+    propsRoot?: PartProps<'div'>;
+    /** 后置图标的部件属性 */
+    propsIconEnd?: Partial<IconProps>;
+    /** 前缀文字的部件属性（指向输入框的 label） */
+    propsPrefix?: PartProps<'label'>;
+    /** 后缀文字的部件属性（指向输入框的 label） */
+    propsSuffix?: PartProps<'label'>;
+    /** 字数计数的部件属性 */
+    propsCount?: Partial<CharacterCountProps>;
+    /** 清空按钮的部件属性 */
+    propsClear?: Partial<PresetIconButtonProps>;
+    /** 显示 / 隐藏密码按钮的部件属性 */
+    propsReveal?: Partial<IconButtonProps>;
+}
+/** 单行文本框：未声明的属性落到 input 上 */
+export declare const TextField: import("@zerodep-dev/vue-tsx-pro-tsx").TsxComponent<TextFieldProps>;

package/dist/input/TextField.js

@@ -0,0 +1,185 @@
+import { useLang } from "../config/context.js";
+import { mergeAttrs, mergePartProps } from "../utils/props.js";
+import { IconButton } from "../base/IconButton.js";
+import { useFieldControl } from "../form/Field.js";
+import { CharacterCount } from "./CharacterCount.js";
+import { controlAffix, controlClear, controlIcon, controlParts, focusOnShell, useControlAppearance } from "./control.js";
+import { displayPosition } from "./text-format.js";
+import { createVNode, mergeProps, ref, shallowRef, useId, vModelText, withDirectives } from "vue";
+import { _component, bindable, readonlyProp, restProps } from "@zerodep-dev/vue-tsx-pro-tsx";
+import { Eye, EyeOff } from "@lucide/icons";
+//#region src/input/TextField.tsx
+/**
+* 单行文本框：外壳（div）里放原生 input，前后可以带图标，可以一键清空；type="password" 时带显示 / 隐藏密码的按钮。
+*
+*   <TextField _value={keyword} type="search" icon={Search} clearable aria-label="搜索" />
+*   <Field label="密码" error={errors.password}><TextField _value={password} type="password" /></Field>
+*
+* 未声明的属性落到 input（主元素）上，外壳用 propsRoot（COMPONENTS.md §2）。
+* 双向绑定经 v-model：中文输入法组合输入期间不写回，组合结束才写回。
+* format 让输入时自动分组显示（手机号 138 0000 1111、身份证号、银行卡号，见 text-format.ts）：值是去掉分隔的原文，
+* 重新分组后光标留在刚输入的字符后面。
+* 在 Field 里时自动关联标签、说明、错误信息，并沿用 Field 的 invalid / required / disabled / readonly。
+*
+* 部件：Root（外壳）、Input、Icon、IconEnd、Prefix、Suffix（固定文字）、Clear（ClearButton）、Reveal（显示密码的 IconButton）、
+* Count（字数计数 CharacterCount）。
+*/
+/** 值与状态由组件管理；原生的 size 属性（字符宽度）让给字号档位，prefix 属性（RDFa）让给前缀 */
+/** schema 的格式（JSON Schema format）→ 输入框的 type：手机上弹出对应的键盘 */
+var FORMAT_TYPES = {
+	email: "email",
+	uri: "url"
+};
+/** 未声明的属性落到 input（主元素）上；外壳用 propsRoot */
+/** 单行文本框：未声明的属性落到 input 上 */
+var TextField = /*#__PURE__*/ _component((_props, _ctx) => {
+	const value = bindable(_props, "_value", () => "", _ctx.emit);
+	const format = readonlyProp(_props, "format");
+	const type = readonlyProp(_props, "type");
+	const variant = readonlyProp(_props, "variant");
+	const size = readonlyProp(_props, "size");
+	const radius = readonlyProp(_props, "radius");
+	const disabled = readonlyProp(_props, "disabled");
+	const readonly = readonlyProp(_props, "readonly");
+	const required = readonlyProp(_props, "required");
+	const invalid = readonlyProp(_props, "invalid");
+	const clearable = readonlyProp(_props, "clearable", false);
+	const icon = readonlyProp(_props, "icon");
+	const iconEnd = readonlyProp(_props, "iconEnd");
+	const prefix = readonlyProp(_props, "prefix");
+	const suffix = readonlyProp(_props, "suffix");
+	const showCount = readonlyProp(_props, "showCount", false);
+	const id = readonlyProp(_props, "id");
+	const propsRoot = readonlyProp(_props, "propsRoot");
+	const propsIcon = readonlyProp(_props, "propsIcon");
+	const propsIconEnd = readonlyProp(_props, "propsIconEnd");
+	const propsPrefix = readonlyProp(_props, "propsPrefix");
+	const propsSuffix = readonlyProp(_props, "propsSuffix");
+	const propsCount = readonlyProp(_props, "propsCount");
+	const propsClear = readonlyProp(_props, "propsClear");
+	const propsReveal = readonlyProp(_props, "propsReveal");
+	const rest = restProps(_props, _ctx, true);
+	const lang = useLang();
+	const appearance = useControlAppearance(() => ({
+		variant: variant.value,
+		size: size.value,
+		radius: radius.value
+	}));
+	const control = useFieldControl(() => ({
+		id: id.value,
+		invalid: invalid.value,
+		required: required.value,
+		disabled: disabled.value,
+		readonly: readonly.value
+	}));
+	let input = shallowRef(null);
+	let revealed = ref(false);
+	const countId = useId();
+	const ownId = useId();
+	function clear() {
+		value.value = "";
+		input.value?.focus();
+	}
+	/** 有 format 时的输入：取出原文写回，再按格式显示，光标放回刚才那个字符的后面 */
+	function onFormattedInput(event) {
+		const element = event.target;
+		const caret = element.selectionStart ?? element.value.length;
+		const before = format.value.parse(element.value.slice(0, caret)).length;
+		const raw = format.value.parse(element.value);
+		value.value = raw;
+		const shown = format.value.format(raw);
+		if (element.value !== shown) {
+			element.value = shown;
+			const position = displayPosition(format.value, raw, before);
+			element.setSelectionRange(position, position);
+		}
+	}
+	return () => {
+		const state = control();
+		const s = controlParts(appearance(), state);
+		const editable = !state.disabled && !state.readonly;
+		const constraints = state.constraints;
+		const inputType = type.value ?? FORMAT_TYPES[constraints.format ?? ""] ?? "text";
+		const password = inputType === "password";
+		const limit = rest.maxlength ?? constraints.maxLength;
+		const describedBy = [state.describedBy, showCount.value && countId].filter(Boolean).join(" ");
+		const inputId = state.id ?? ownId;
+		const inputAttrs = mergeAttrs({
+			...s.input,
+			minlength: format.value ? void 0 : constraints.minLength,
+			maxlength: format.value ? void 0 : constraints.maxLength,
+			inputmode: format.value?.inputmode
+		}, rest, {
+			ref: input,
+			id: inputId,
+			type: password && revealed.value ? "text" : inputType,
+			disabled: state.disabled,
+			readonly: state.readonly,
+			required: state.required,
+			"aria-invalid": state.invalid || void 0,
+			"aria-describedby": describedBy || void 0
+		});
+		return createVNode("div", mergeProps(mergeAttrs(s.root, propsRoot.value, { onPointerdown: focusOnShell(() => input.value) }), {
+			"data-invalid": state.invalid || void 0,
+			"data-disabled": state.disabled || void 0
+		}), [
+			controlIcon(s, icon.value, propsIcon.value),
+			controlAffix(s, prefix.value, inputId, propsPrefix.value),
+			format.value ? createVNode("input", mergeProps(inputAttrs, {
+				"value": format.value.format(value.value),
+				"onInput": onFormattedInput
+			}), null) : withDirectives(createVNode("input", mergeProps(inputAttrs, { "onUpdate:modelValue": ($event) => value.value = $event }), null), [[vModelText, value.value]]),
+			controlAffix(s, suffix.value, inputId, propsSuffix.value),
+			clearable.value && value.value && editable && controlClear(s, propsClear.value, clear),
+			password && createVNode(IconButton, mergePartProps({
+				...s.button,
+				radius: "full",
+				icon: revealed.value ? EyeOff : Eye,
+				"aria-label": lang.passwordShow
+			}, propsReveal.value, {
+				disabled: state.disabled,
+				"aria-pressed": revealed.value,
+				onClick: () => revealed.value = !revealed.value
+			}), null),
+			showCount.value && createVNode(CharacterCount, mergePartProps({
+				count: value.value.length,
+				max: limit == null ? void 0 : Number(limit)
+			}, propsCount.value, { id: countId }), null),
+			controlIcon(s, iconEnd.value, propsIconEnd.value)
+		]);
+	};
+}, {
+	name: "TextField",
+	props: [
+		"_value",
+		"onUpdate:_value",
+		"format",
+		"type",
+		"variant",
+		"size",
+		"radius",
+		"disabled",
+		"readonly",
+		"required",
+		"invalid",
+		"clearable",
+		"icon",
+		"iconEnd",
+		"prefix",
+		"suffix",
+		"showCount",
+		"id",
+		"propsRoot",
+		"propsIcon",
+		"propsIconEnd",
+		"propsPrefix",
+		"propsSuffix",
+		"propsCount",
+		"propsClear",
+		"propsReveal"
+	]
+});
+//#endregion
+export { TextField };
+
+//# sourceMappingURL=TextField.js.map

package/dist/input/TextField.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextField.js","names":["_vtp_bindable","_vtp_readonlyProp","_vtp_restProps","_vue_shallowRef","_vue_ref","_createVNode","_mergeProps","_withDirectives","_vModelText"],"sources":["../../src/input/TextField.tsx"],"sourcesContent":["/**\n * 单行文本框：外壳（div）里放原生 input，前后可以带图标，可以一键清空；type=\"password\" 时带显示 / 隐藏密码的按钮。\n *\n *   <TextField _value={keyword} type=\"search\" icon={Search} clearable aria-label=\"搜索\" />\n *   <Field label=\"密码\" error={errors.password}><TextField _value={password} type=\"password\" /></Field>\n *\n * 未声明的属性落到 input（主元素）上，外壳用 propsRoot（COMPONENTS.md §2）。\n * 双向绑定经 v-model：中文输入法组合输入期间不写回，组合结束才写回。\n * format 让输入时自动分组显示（手机号 138 0000 1111、身份证号、银行卡号，见 text-format.ts）：值是去掉分隔的原文，\n * 重新分组后光标留在刚输入的字符后面。\n * 在 Field 里时自动关联标签、说明、错误信息，并沿用 Field 的 invalid / required / disabled / readonly。\n *\n * 部件：Root（外壳）、Input、Icon、IconEnd、Prefix、Suffix（固定文字）、Clear（ClearButton）、Reveal（显示密码的 IconButton）、\n * Count（字数计数 CharacterCount）。\n */\nimport { Eye, EyeOff } from '@lucide/icons';\nimport { _component } from '@zerodep-dev/vue-tsx-pro-tsx';\nimport { useId, type VNodeChild } from 'vue';\nimport type { PresetIconButtonProps } from '../base/CloseButton';\nimport type { IconData, IconProps } from '../base/Icon';\nimport { IconButton, type IconButtonProps } from '../base/IconButton';\nimport { useLang } from '../config/context';\nimport { CharacterCount, type CharacterCountProps } from './CharacterCount';\nimport { displayPosition, type TextFormat } from './text-format';\nimport { useFieldControl } from '../form/Field';\nimport { mergeAttrs, mergePartProps, type PartProps } from '../utils/props';\nimport {\n  controlClear,\n  controlParts,\n  focusOnShell,\n  controlAffix,\n  controlIcon,\n  useControlAppearance,\n  type ControlIconOptions,\n  type ControlOptions,\n} from './control';\n\n/** 值与状态由组件管理；原生的 size 属性（字符宽度）让给字号档位，prefix 属性（RDFa）让给前缀 */\nexport type TextFieldManaged =\n  | 'value'\n  | 'disabled'\n  | 'readonly'\n  | 'required'\n  | 'size'\n  | 'prefix'\n  | 'aria-invalid'\n  | 'aria-describedby';\n\n/** schema 的格式（JSON Schema format）→ 输入框的 type：手机上弹出对应的键盘 */\nconst FORMAT_TYPES: Readonly<Record<string, 'email' | 'url'>> = { email: 'email', uri: 'url' };\n\n/** 未声明的属性落到 input（主元素）上；外壳用 propsRoot */\nexport interface TextFieldProps\n  extends PartProps<'input', TextFieldManaged>, ControlOptions, ControlIconOptions {\n  /** 输入值：父级写 _value={x} 双向绑定 */\n  _value?: string;\n  /** 显示格式：输入时自动分组（phoneFormat、idCardFormat、bankCardFormat 或 createGroupedFormat），值是去掉分隔的原文 */\n  format?: TextFormat;\n  /** 不可用 */\n  disabled?: boolean;\n  /** 只读：可以选中、复制，不能修改 */\n  readonly?: boolean;\n  /** 必填 */\n  required?: boolean;\n  /** 校验未通过 */\n  invalid?: boolean;\n  /** 有内容时显示清空按钮 */\n  clearable?: boolean;\n  /** 后置图标 */\n  iconEnd?: IconData;\n  /** 输入框前的固定文字（如 `https://`、`¥`），不算在值里 */\n  prefix?: VNodeChild;\n  /** 输入框后的固定文字（如 `.com`、`元`），不算在值里 */\n  suffix?: VNodeChild;\n  /** 显示字数计数；上限取 maxlength（含 zod 推出的约束），超出时用危险色 */\n  showCount?: boolean;\n  /** 外壳（边框、焦点环）的部件属性 */\n  propsRoot?: PartProps<'div'>;\n  /** 后置图标的部件属性 */\n  propsIconEnd?: Partial<IconProps>;\n  /** 前缀文字的部件属性（指向输入框的 label） */\n  propsPrefix?: PartProps<'label'>;\n  /** 后缀文字的部件属性（指向输入框的 label） */\n  propsSuffix?: PartProps<'label'>;\n  /** 字数计数的部件属性 */\n  propsCount?: Partial<CharacterCountProps>;\n  /** 清空按钮的部件属性 */\n  propsClear?: Partial<PresetIconButtonProps>;\n  /** 显示 / 隐藏密码按钮的部件属性 */\n  propsReveal?: Partial<IconButtonProps>;\n}\n\n/** 单行文本框：未声明的属性落到 input 上 */\nexport const TextField = _component(\n  ({\n    _value: value = _bindable(''),\n    format,\n    type,\n    variant,\n    size,\n    radius,\n    disabled,\n    readonly,\n    required,\n    invalid,\n    clearable = false,\n    icon,\n    iconEnd,\n    prefix,\n    suffix,\n    showCount = false,\n    id,\n    propsRoot,\n    propsIcon,\n    propsIconEnd,\n    propsPrefix,\n    propsSuffix,\n    propsCount,\n    propsClear,\n    propsReveal,\n    ...rest\n  }: TextFieldProps) => {\n    const lang = useLang();\n    const appearance = useControlAppearance(() => ({ variant, size, radius }));\n    const control = useFieldControl(() => ({ id, invalid, required, disabled, readonly }));\n    let input = _state.raw<HTMLInputElement | null>(null);\n    let revealed = _state(false);\n    const countId = useId();\n    // 前后缀的 label 要指向输入框：不在 Field 里、也没写 id 时用自己生成的\n    const ownId = useId();\n\n    function clear() {\n      value = '';\n      input?.focus();\n    }\n\n    /** 有 format 时的输入：取出原文写回，再按格式显示，光标放回刚才那个字符的后面 */\n    function onFormattedInput(event: Event) {\n      const element = event.target as HTMLInputElement;\n      const caret = element.selectionStart ?? element.value.length;\n      const before = format!.parse(element.value.slice(0, caret)).length;\n      const raw = format!.parse(element.value);\n      value = raw;\n      const shown = format!.format(raw);\n      if (element.value !== shown) {\n        element.value = shown;\n        const position = displayPosition(format!, raw, before);\n        element.setSelectionRange(position, position);\n      }\n    }\n\n    return () => {\n      const state = control();\n      const s = controlParts(appearance(), state);\n      const editable = !state.disabled && !state.readonly;\n      const constraints = state.constraints;\n      // 不写 type 时按 schema 的格式选：z.email() → email、z.url() → url\n      const inputType = type ?? FORMAT_TYPES[constraints.format ?? ''] ?? 'text';\n      const password = inputType === 'password';\n      const limit = rest.maxlength ?? constraints.maxLength;\n      const describedBy = [state.describedBy, showCount && countId].filter(Boolean).join(' ');\n      const inputId = state.id ?? ownId;\n      const inputAttrs = mergeAttrs<'input'>(\n        {\n          ...s.input,\n          // 有 format 时输入框里多了分隔，按原文的长度限制交给 format.parse 截断\n          minlength: format ? undefined : constraints.minLength,\n          maxlength: format ? undefined : constraints.maxLength,\n          inputmode: format?.inputmode,\n        },\n        rest,\n        {\n          ref: _toRef(input),\n          id: inputId,\n          type: password && revealed ? 'text' : inputType,\n          disabled: state.disabled,\n          readonly: state.readonly,\n          required: state.required,\n          'aria-invalid': state.invalid || undefined,\n          'aria-describedby': describedBy || undefined,\n        },\n      );\n      return (\n        <div\n          {...mergeAttrs<'div'>(s.root, propsRoot, {\n            onPointerdown: focusOnShell(() => input),\n          })}\n          data-invalid={state.invalid || undefined}\n          data-disabled={state.disabled || undefined}\n        >\n          {controlIcon(s, icon, propsIcon)}\n          {controlAffix(s, prefix, inputId, propsPrefix)}\n          {format ? (\n            <input {...inputAttrs} value={format.format(value)} onInput={onFormattedInput} />\n          ) : (\n            // _bind 编译为 v-model：复用 Vue 对输入法组合输入的处理，组合结束才写回\n            <input {...inputAttrs} _value={value} />\n          )}\n          {controlAffix(s, suffix, inputId, propsSuffix)}\n          {clearable && value && editable && controlClear(s, propsClear, clear)}\n          {password && (\n            <IconButton\n              {...mergePartProps<IconButtonProps>(\n                {\n                  ...s.button,\n                  radius: 'full',\n                  icon: revealed ? EyeOff : Eye,\n                  // 名称不变、用 aria-pressed 表示状态：读屏念“显示密码，已按下”（名称跟着变会和按下状态打架）\n                  'aria-label': lang.passwordShow,\n                },\n                propsReveal,\n                {\n                  disabled: state.disabled,\n                  'aria-pressed': revealed,\n                  onClick: () => (revealed = !revealed),\n                },\n              )}\n            />\n          )}\n          {showCount && (\n            <CharacterCount\n              {...mergePartProps<CharacterCountProps>(\n                { count: value.length, max: limit == null ? undefined : Number(limit) },\n                propsCount,\n                { id: countId },\n              )}\n            />\n          )}\n          {controlIcon(s, iconEnd, propsIconEnd)}\n        </div>\n      );\n    };\n  },\n);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiDA,IAAM,eAA0D;CAAE,OAAO;CAAS,KAAK;AAAM;;;AA4C7F,IAAa,YAAY,0BACvB,QAAA,SA2BsB;CAAA,MAAA,QAAAA,SAAA,QAAA,gBA1BM,IAAE,KAAA,IAAA;CAAA,MAAA,SAAAC,aAAA,QAAA,QAAA;CAAA,MAAA,OAAAA,aAAA,QAAA,MAAA;CAAA,MAAA,UAAAA,aAAA,QAAA,SAAA;CAAA,MAAA,OAAAA,aAAA,QAAA,MAAA;CAAA,MAAA,SAAAA,aAAA,QAAA,QAAA;CAAA,MAAA,WAAAA,aAAA,QAAA,UAAA;CAAA,MAAA,WAAAA,aAAA,QAAA,UAAA;CAAA,MAAA,WAAAA,aAAA,QAAA,UAAA;CAAA,MAAA,UAAAA,aAAA,QAAA,SAAA;CAAA,MAAA,YAAAA,aAAA,QAAA,aAUhB,KAAK;CAAA,MAAA,OAAAA,aAAA,QAAA,MAAA;CAAA,MAAA,UAAAA,aAAA,QAAA,SAAA;CAAA,MAAA,SAAAA,aAAA,QAAA,QAAA;CAAA,MAAA,SAAAA,aAAA,QAAA,QAAA;CAAA,MAAA,YAAAA,aAAA,QAAA,aAKL,KAAK;CAAA,MAAA,KAAAA,aAAA,QAAA,IAAA;CAAA,MAAA,YAAAA,aAAA,QAAA,WAAA;CAAA,MAAA,YAAAA,aAAA,QAAA,WAAA;CAAA,MAAA,eAAAA,aAAA,QAAA,cAAA;CAAA,MAAA,cAAAA,aAAA,QAAA,aAAA;CAAA,MAAA,cAAAA,aAAA,QAAA,aAAA;CAAA,MAAA,aAAAA,aAAA,QAAA,YAAA;CAAA,MAAA,aAAAA,aAAA,QAAA,YAAA;CAAA,MAAA,cAAAA,aAAA,QAAA,aAAA;CAAA,MAUd,OAAIC,UAAA,QAAA,MAAA,IAAA;CAEP,MAAM,OAAO,QAAQ;CACrB,MAAM,aAAa,4BAA4B;EAAE,SAAO,QAAA;EAAE,MAAI,KAAA;EAAE,QAAM,OAAA;CAAC,EAAE;CACzE,MAAM,UAAU,uBAAuB;EAAE,IAAE,GAAA;EAAE,SAAO,QAAA;EAAE,UAAQ,SAAA;EAAE,UAAQ,SAAA;EAAE,UAAQ,SAAA;CAAC,EAAE;CACrF,IAAI,QAAKC,WAAuC,IAAI;CACpD,IAAI,WAAQC,IAAU,KAAK;CAC3B,MAAM,UAAU,MAAM;CAEtB,MAAM,QAAQ,MAAM;CAEpB,SAAS,QAAQ;EACf,MAAA,QAAQ;EACR,MAAA,OAAO,MAAM;CACf;;CAGA,SAAS,iBAAiB,OAAc;EACtC,MAAM,UAAU,MAAM;EACtB,MAAM,QAAQ,QAAQ,kBAAkB,QAAQ,MAAM;EACtD,MAAM,SAAS,OAAA,MAAQ,MAAM,QAAQ,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC;EAC5D,MAAM,MAAM,OAAA,MAAQ,MAAM,QAAQ,KAAK;EACvC,MAAA,QAAQ;EACR,MAAM,QAAQ,OAAA,MAAQ,OAAO,GAAG;EAChC,IAAI,QAAQ,UAAU,OAAO;GAC3B,QAAQ,QAAQ;GAChB,MAAM,WAAW,gBAAe,OAAA,OAAU,KAAK,MAAM;GACrD,QAAQ,kBAAkB,UAAU,QAAQ;EAC9C;CACF;CAEA,aAAa;EACX,MAAM,QAAQ,QAAQ;EACtB,MAAM,IAAI,aAAa,WAAW,GAAG,KAAK;EAC1C,MAAM,WAAW,CAAC,MAAM,YAAY,CAAC,MAAM;EAC3C,MAAM,cAAc,MAAM;EAE1B,MAAM,YAAY,KAAA,SAAQ,aAAa,YAAY,UAAU,OAAO;EACpE,MAAM,WAAW,cAAc;EAC/B,MAAM,QAAQ,KAAK,aAAa,YAAY;EAC5C,MAAM,cAAc,CAAC,MAAM,aAAa,UAAA,SAAa,OAAO,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,KAAK,GAAG;EACtF,MAAM,UAAU,MAAM,MAAM;EAC5B,MAAM,aAAa,WACjB;GACE,GAAG,EAAE;GAEL,WAAW,OAAA,QAAS,KAAA,IAAY,YAAY;GAC5C,WAAW,OAAA,QAAS,KAAA,IAAY,YAAY;GAC5C,WAAW,OAAA,OAAQ;EACrB,GACA,MACA;GACE,KAAG;GACH,IAAI;GACJ,MAAM,YAAQ,SAAA,QAAe,SAAS;GACtC,UAAU,MAAM;GAChB,UAAU,MAAM;GAChB,UAAU,MAAM;GAChB,gBAAgB,MAAM,WAAW,KAAA;GACjC,oBAAoB,eAAe,KAAA;EACrC,CACF;EACA,OAAAC,YAAA,OAAAC,WAEQ,WAAkB,EAAE,MAAI,UAAA,OAAa,EACvC,eAAe,mBAAa,MAAA,KAAW,EACzC,CAAC,GAAC;GAAA,gBACY,MAAM,WAAW,KAAA;GAAS,iBACzB,MAAM,YAAY,KAAA;EAAS,CAAA,GAAA;GAEzC,YAAY,GAAC,KAAA,OAAA,UAAA,KAAiB;GAC9B,aAAa,GAAC,OAAA,OAAU,SAAO,YAAA,KAAa;GAC5C,OAAA,QAAAD,YAAA,SAAAC,WACY,YAAU;IAAA,SAAS,OAAA,MAAO,OAAM,MAAA,KAAM;IAAC,WAAW;GAAgB,CAAA,GAAA,IAAA,IAE7EC,eAAAF,YAAA,SAAAC,WACW,YAAU,EAAA,wBAAA,WAAA,MAAA,QAAA,OAAA,CAAA,GAAA,IAAA,GAAA,CAAA,CAAAE,YAAA,MAAA,KAAA,CAAA,CAAA;GAEtB,aAAa,GAAC,OAAA,OAAU,SAAO,YAAA,KAAa;GAC5C,UAAA,SAAA,MAAA,SAAsB,YAAY,aAAa,GAAC,WAAA,OAAc,KAAK;GACnE,YAAQH,YAAA,YAED,eACF;IACE,GAAG,EAAE;IACL,QAAQ;IACR,MAAM,SAAA,QAAW,SAAS;IAE1B,cAAc,KAAK;GACrB,GAAC,YAAA,OAED;IACE,UAAU,MAAM;IAChB,gBAAc,SAAA;IACd,eAAgB,SAAA,QAAW,CAAA,SAAA;GAC7B,CACF,GAAC,IAAA;GAGJ,UAAA,SAAAA,YAAA,gBAEO,eACF;IAAE,OAAO,MAAA,MAAM;IAAQ,KAAK,SAAS,OAAO,KAAA,IAAY,OAAO,KAAK;GAAE,GAAC,WAAA,OAEvE,EAAE,IAAI,QAAQ,CAChB,GAAC,IAAA;GAGJ,YAAY,GAAC,QAAA,OAAA,aAAA,KAAuB;EAAC,CAAA;CAG5C;AACF,GAAC;CAAA,MAAA;CAAA,OAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;CAAA;AAAA,CACH"}

package/dist/input/Textarea.d.ts

@@ -0,0 +1,50 @@
+import * as css from '@zerodep-dev/vue-tsx-pro-tsx/styles';
+import { type CharacterCountProps } from './CharacterCount';
+import { type PartProps } from '../utils/props';
+import type { PresetIconButtonProps } from '../base/CloseButton';
+import { type ControlOptions } from './control';
+/** 值与状态由组件管理 */
+export type TextareaManaged = 'value' | 'rows' | 'disabled' | 'readonly' | 'required' | 'aria-invalid' | 'aria-describedby';
+/** 未声明的属性落到 textarea（主元素）上；外壳用 propsRoot */
+export interface TextareaProps extends PartProps<'textarea', TextareaManaged>, ControlOptions {
+    /** 输入值：父级写 _value={x} 双向绑定 */
+    _value?: string;
+    /** 最少显示几行，默认 3 */
+    rows?: number;
+    /** 最多增高到几行，之后出现滚动条；默认不限 */
+    maxRows?: number;
+    /** 不随内容增高，固定为 rows 行（可以拖动右下角改变高度） */
+    fixed?: boolean;
+    /** 不可用 */
+    disabled?: boolean;
+    /** 只读 */
+    readonly?: boolean;
+    /** 必填 */
+    required?: boolean;
+    /** 校验未通过 */
+    invalid?: boolean;
+    /** 显示字数计数（右下角）；上限取 maxlength（含 zod 推出的约束），超出时用危险色 */
+    showCount?: boolean;
+    /** 有内容时在右上角显示清空按钮 */
+    clearable?: boolean;
+    /** 清空按钮的部件属性 */
+    propsClear?: Partial<PresetIconButtonProps>;
+    /** 外壳的部件属性 */
+    propsRoot?: PartProps<'div'>;
+    /** 字数计数的部件属性 */
+    propsCount?: Partial<CharacterCountProps>;
+}
+/** Textarea 的样式：textarea、fixed、count、clear */
+export declare const textareaStyles: Readonly<{
+    clear: css.CompiledStyles;
+    count: css.CompiledStyles;
+    fixed: css.CompiledStyles;
+    textarea: css.CompiledStyles;
+}>;
+/** Textarea 的样式：min、max */
+export declare const textareaRowStyles: Readonly<{
+    readonly min: (rows: number) => Readonly<[css.CompiledStyles, css.InlineStyles]>;
+    readonly max: (rows: number) => Readonly<[css.CompiledStyles, css.InlineStyles]>;
+}>;
+/** 多行文本框：高度随内容增长 */
+export declare const Textarea: import("@zerodep-dev/vue-tsx-pro-tsx").TsxComponent<TextareaProps>;

package/dist/input/Textarea.js

@@ -0,0 +1,146 @@
+import { mergeAttrs, mergePartProps } from "../utils/props.js";
+import { useFieldControl } from "../form/Field.js";
+import { CharacterCount } from "./CharacterCount.js";
+import { controlClear, controlParts, useControlAppearance } from "./control.js";
+import { createVNode, mergeProps, nextTick, shallowRef, useId, vModelText, withDirectives } from "vue";
+import { _component, bindable, effect, readonlyProp, restProps } from "@zerodep-dev/vue-tsx-pro-tsx";
+import * as css from "@zerodep-dev/vue-tsx-pro-tsx/styles";
+//#region src/input/Textarea.tsx
+/** 值与状态由组件管理 */
+/** 未声明的属性落到 textarea（主元素）上；外壳用 propsRoot */
+/** Textarea 的样式：textarea、fixed、count、clear */
+var textareaStyles = css.create({
+	textarea: {
+		alignSelf: "stretch",
+		resize: "none",
+		overflowY: "auto"
+	},
+	fixed: { resize: "vertical" },
+	count: {
+		alignSelf: "flex-end",
+		paddingBlockEnd: "_xs"
+	},
+	clear: {
+		alignSelf: "flex-start",
+		marginBlockStart: "_xs"
+	}
+});
+/** Textarea 的样式：min、max */
+var textareaRowStyles = css.create({
+	min: (rows) => ({ minHeight: `${rows}lh` }),
+	max: (rows) => ({ maxHeight: `${rows}lh` })
+});
+/** 多行文本框：高度随内容增长 */
+var Textarea = /*#__PURE__*/ _component((_props, _ctx) => {
+	const value = bindable(_props, "_value", () => "", _ctx.emit);
+	const rows = readonlyProp(_props, "rows", 3);
+	const maxRows = readonlyProp(_props, "maxRows");
+	const fixed = readonlyProp(_props, "fixed", false);
+	const variant = readonlyProp(_props, "variant");
+	const size = readonlyProp(_props, "size");
+	const radius = readonlyProp(_props, "radius");
+	const disabled = readonlyProp(_props, "disabled");
+	const readonly = readonlyProp(_props, "readonly");
+	const required = readonlyProp(_props, "required");
+	const invalid = readonlyProp(_props, "invalid");
+	const showCount = readonlyProp(_props, "showCount", false);
+	const clearable = readonlyProp(_props, "clearable", false);
+	const id = readonlyProp(_props, "id");
+	const propsRoot = readonlyProp(_props, "propsRoot");
+	const propsCount = readonlyProp(_props, "propsCount");
+	const propsClear = readonlyProp(_props, "propsClear");
+	const rest = restProps(_props, _ctx, true);
+	const countId = useId();
+	const appearance = useControlAppearance(() => ({
+		variant: variant.value,
+		size: size.value,
+		radius: radius.value
+	}));
+	const control = useFieldControl(() => ({
+		id: id.value,
+		invalid: invalid.value,
+		required: required.value,
+		disabled: disabled.value,
+		readonly: readonly.value
+	}));
+	let textarea = shallowRef(null);
+	effect(() => {
+		if (fixed.value || !textarea.value) return;
+		value.value;
+		const element = textarea.value;
+		nextTick(() => {
+			element.style.height = "auto";
+			element.style.height = `${element.scrollHeight}px`;
+		});
+	});
+	return () => {
+		const state = control();
+		const s = controlParts(appearance(), state, true);
+		const limit = rest.maxlength ?? state.constraints.maxLength;
+		const describedBy = [state.describedBy, showCount.value && countId].filter(Boolean).join(" ");
+		return createVNode("div", mergeProps(mergeAttrs(s.root, propsRoot.value), {
+			"data-invalid": state.invalid || void 0,
+			"data-disabled": state.disabled || void 0
+		}), [
+			withDirectives(createVNode("textarea", mergeProps(mergeAttrs({
+				...s.input,
+				sx: [
+					s.input.sx,
+					textareaStyles.textarea,
+					fixed.value && textareaStyles.fixed,
+					css.bind(textareaRowStyles.min, () => [rows.value], true),
+					maxRows.value != null && !fixed.value && css.bind(textareaRowStyles.max, () => [maxRows.value], true)
+				],
+				minlength: state.constraints.minLength,
+				maxlength: state.constraints.maxLength
+			}, rest, {
+				ref: textarea,
+				id: state.id,
+				rows: rows.value,
+				disabled: state.disabled,
+				readonly: state.readonly,
+				required: state.required,
+				"aria-invalid": state.invalid || void 0,
+				"aria-describedby": describedBy || void 0
+			}), { "onUpdate:modelValue": ($event) => value.value = $event }), null), [[vModelText, value.value]]),
+			clearable.value && value.value && !state.disabled && !state.readonly && controlClear(s, {
+				...propsClear.value,
+				sx: [textareaStyles.clear, propsClear.value?.sx]
+			}, () => {
+				value.value = "";
+				textarea.value?.focus();
+			}),
+			showCount.value && createVNode(CharacterCount, mergePartProps({
+				sx: textareaStyles.count,
+				count: value.value.length,
+				max: limit == null ? void 0 : Number(limit)
+			}, propsCount.value, { id: countId }), null)
+		]);
+	};
+}, {
+	name: "Textarea",
+	props: [
+		"_value",
+		"onUpdate:_value",
+		"rows",
+		"maxRows",
+		"fixed",
+		"variant",
+		"size",
+		"radius",
+		"disabled",
+		"readonly",
+		"required",
+		"invalid",
+		"showCount",
+		"clearable",
+		"id",
+		"propsRoot",
+		"propsCount",
+		"propsClear"
+	]
+});
+//#endregion
+export { Textarea, textareaRowStyles, textareaStyles };
+
+//# sourceMappingURL=Textarea.js.map

package/dist/input/Textarea.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Textarea.js","names":["_vtp_bindable","_vtp_readonlyProp","_vtp_restProps","_vue_shallowRef","_createVNode","_mergeProps","_withDirectives","_vModelText"],"sources":["../../src/input/Textarea.tsx"],"sourcesContent":["/**\n * 多行文本框：外壳与 TextField 相同（control），高度随内容增长，在 rows 与 maxRows 之间。\n *\n *   <Field label=\"备注\"><Textarea _value={note} rows={3} maxRows={8} /></Field>\n *\n * 自动增高：内容变化后（含父级改值）把高度设为 scrollHeight，上下限用 lh 单位（行高的倍数）由 CSS 夹住。\n * 没用 field-sizing: content：Firefox 还不支持，样式的类型表里也没有。中文输入法照常（v-model）。\n *\n * 未声明的属性落到 textarea（主元素）上，外壳用 propsRoot。部件：Root（外壳）、Textarea。\n */\nimport { _component } from '@zerodep-dev/vue-tsx-pro-tsx';\nimport * as css from '@zerodep-dev/vue-tsx-pro-tsx/styles';\nimport { nextTick, useId } from 'vue';\nimport { CharacterCount, type CharacterCountProps } from './CharacterCount';\nimport { useFieldControl } from '../form/Field';\nimport { mergeAttrs, mergePartProps, type PartProps } from '../utils/props';\nimport type { PresetIconButtonProps } from '../base/CloseButton';\nimport { controlClear, controlParts, useControlAppearance, type ControlOptions } from './control';\n\n/** 值与状态由组件管理 */\nexport type TextareaManaged =\n  'value' | 'rows' | 'disabled' | 'readonly' | 'required' | 'aria-invalid' | 'aria-describedby';\n\n/** 未声明的属性落到 textarea（主元素）上；外壳用 propsRoot */\nexport interface TextareaProps extends PartProps<'textarea', TextareaManaged>, ControlOptions {\n  /** 输入值：父级写 _value={x} 双向绑定 */\n  _value?: string;\n  /** 最少显示几行，默认 3 */\n  rows?: number;\n  /** 最多增高到几行，之后出现滚动条；默认不限 */\n  maxRows?: number;\n  /** 不随内容增高，固定为 rows 行（可以拖动右下角改变高度） */\n  fixed?: boolean;\n  /** 不可用 */\n  disabled?: boolean;\n  /** 只读 */\n  readonly?: boolean;\n  /** 必填 */\n  required?: boolean;\n  /** 校验未通过 */\n  invalid?: boolean;\n  /** 显示字数计数（右下角）；上限取 maxlength（含 zod 推出的约束），超出时用危险色 */\n  showCount?: boolean;\n  /** 有内容时在右上角显示清空按钮 */\n  clearable?: boolean;\n  /** 清空按钮的部件属性 */\n  propsClear?: Partial<PresetIconButtonProps>;\n  /** 外壳的部件属性 */\n  propsRoot?: PartProps<'div'>;\n  /** 字数计数的部件属性 */\n  propsCount?: Partial<CharacterCountProps>;\n}\n\n/** Textarea 的样式：textarea、fixed、count、clear */\nexport const textareaStyles = css.create({\n  // 随外壳拉伸：外壳给了高度（propsRoot 的 height）时文字区占满，不停在基线上\n  textarea: { alignSelf: 'stretch', resize: 'none', overflowY: 'auto' },\n  fixed: { resize: 'vertical' },\n  // 计数贴在右下角\n  count: { alignSelf: 'flex-end', paddingBlockEnd: '_xs' },\n  // 清空按钮贴在第一行（多行时不随内容居中）\n  clear: { alignSelf: 'flex-start', marginBlockStart: '_xs' },\n});\n\n// 行数是任意值，用动态样式；单独一个 create，见 COMPONENTS.md §4\n/** Textarea 的样式：min、max */\nexport const textareaRowStyles = css.create({\n  min: (rows: number) => ({ minHeight: `${rows}lh` }),\n  max: (rows: number) => ({ maxHeight: `${rows}lh` }),\n});\n\n/** 多行文本框：高度随内容增长 */\nexport const Textarea = _component(\n  ({\n    _value: value = _bindable(''),\n    rows = 3,\n    maxRows,\n    fixed = false,\n    variant,\n    size,\n    radius,\n    disabled,\n    readonly,\n    required,\n    invalid,\n    showCount = false,\n    clearable = false,\n    id,\n    propsRoot,\n    propsCount,\n    propsClear,\n    ...rest\n  }: TextareaProps) => {\n    const countId = useId();\n    const appearance = useControlAppearance(() => ({ variant, size, radius }));\n    const control = useFieldControl(() => ({ id, invalid, required, disabled, readonly }));\n    let textarea = _state.raw<HTMLTextAreaElement | null>(null);\n\n    // 内容变化（含父级改值）后按内容高度重设\n    _effect(() => {\n      if (fixed || !textarea) return;\n      void value;\n      const element = textarea;\n      void nextTick(() => {\n        element.style.height = 'auto';\n        element.style.height = `${element.scrollHeight}px`;\n      });\n    });\n\n    return () => {\n      const state = control();\n      const s = controlParts(appearance(), state, true);\n      const limit = rest.maxlength ?? state.constraints.maxLength;\n      const describedBy = [state.describedBy, showCount && countId].filter(Boolean).join(' ');\n      return (\n        <div\n          {...mergeAttrs<'div'>(s.root, propsRoot)}\n          data-invalid={state.invalid || undefined}\n          data-disabled={state.disabled || undefined}\n        >\n          <textarea\n            {...mergeAttrs<'textarea'>(\n              {\n                ...s.input,\n                sx: [\n                  s.input.sx,\n                  textareaStyles.textarea,\n                  fixed && textareaStyles.fixed,\n                  textareaRowStyles.min(rows),\n                  maxRows != null && !fixed && textareaRowStyles.max(maxRows),\n                ],\n                minlength: state.constraints.minLength,\n                maxlength: state.constraints.maxLength,\n              },\n              rest,\n              {\n                ref: _toRef(textarea),\n                id: state.id,\n                rows,\n                disabled: state.disabled,\n                readonly: state.readonly,\n                required: state.required,\n                'aria-invalid': state.invalid || undefined,\n                'aria-describedby': describedBy || undefined,\n              },\n            )}\n            _value={value}\n          />\n          {clearable &&\n            value &&\n            !state.disabled &&\n            !state.readonly &&\n            // 使用方的 sx 接在贴顶的样式之后，不把它整个换掉\n            controlClear(s, { ...propsClear, sx: [textareaStyles.clear, propsClear?.sx] }, () => {\n              value = '';\n              textarea?.focus();\n            })}\n          {showCount && (\n            <CharacterCount\n              {...mergePartProps<CharacterCountProps>(\n                {\n                  sx: textareaStyles.count,\n                  count: value.length,\n                  max: limit == null ? undefined : Number(limit),\n                },\n                propsCount,\n                { id: countId },\n              )}\n            />\n          )}\n        </div>\n      );\n    };\n  },\n);\n"],"mappings":"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"}

package/dist/input/ToggleGroup.d.ts

@@ -0,0 +1,82 @@
+import * as css from '@zerodep-dev/vue-tsx-pro-tsx/styles';
+import type { VNodeChild } from 'vue';
+import { type ButtonOptions } from '../base/button-core';
+import type { IconData, IconProps } from '../base/Icon';
+import { type PartProps } from '../utils/props';
+import { type SelectionProps } from '../utils/data/selection';
+import type { TextSize } from '../utils/style/typography';
+/** ToggleGroup 交给组内 ToggleGroupItem 的状态 */
+export interface ToggleGroupState {
+    /** 按下（选中）的项的值 */
+    readonly selected: readonly string[];
+    /** 字号档位；不写时继承 */
+    readonly size: TextSize | undefined;
+    /** 整组不可用 */
+    readonly disabled: boolean;
+    /** 整组只读：按钮照常显示与聚焦，点了不切换 */
+    readonly readonly: boolean;
+    /** 波纹；不写时沿用配置 */
+    readonly ripple: boolean | undefined;
+    /** 单选：选中底色由组里的滑块（Indicator）画，项本身不画底色 */
+    readonly sliding: boolean;
+    /** 切换一项（单选、多选的规则由组决定） */
+    toggle(value: string): void;
+}
+/** ToggleGroup 的上下文：自定义的项可以 inject 它接入组 */
+export declare const ToggleGroupContext: import("@zerodep-dev/vue-tsx-pro-tsx").Context<ToggleGroupState>;
+/** 方向 */
+export interface ToggleGroupOrientations {
+    /** 横排（默认），左右键移动 */
+    horizontal: unknown;
+    /** 竖排，上下键移动 */
+    vertical: unknown;
+}
+/** 角色由组件管理（role="group" 不允许 aria-orientation，方向只写在 data-orientation 上） */
+export type ToggleGroupManaged = 'role';
+/** 两种选择方式共有的选项；未声明的属性落到 role="group" 的 div 上，aria-label 是这组的名称 */
+export interface ToggleGroupBaseProps extends PartProps<'div', ToggleGroupManaged> {
+    /** 必须有选中项：最后一项不能取消（分段控件通常要求）；在必填的 Field 里默认开启 */
+    required?: boolean;
+    /** 整组不可用 */
+    disabled?: boolean;
+    /** 整组只读：选中项照常显示、按钮能聚焦，点了不切换（查看详情、审批时） */
+    readonly?: boolean;
+    /** 方向，默认 horizontal */
+    orientation?: keyof ToggleGroupOrientations;
+    /** 字号档位，按钮随之缩放 */
+    size?: TextSize;
+    /** 按下时的波纹；不写时沿用全局配置 */
+    ripple?: boolean;
+    /** 单选时选中项下面的滑块（切换时滑过去）的部件属性 */
+    propsIndicator?: PartProps<'span'>;
+    children?: VNodeChild;
+}
+/** 单选或多选 */
+export type ToggleGroupProps = ToggleGroupBaseProps & SelectionProps;
+/** ToggleGroup 的样式：root、vertical、indicator */
+export declare const toggleGroupStyles: Readonly<{
+    indicator: css.CompiledStyles;
+    readonlyItem: css.CompiledStyles;
+    root: css.CompiledStyles;
+    vertical: css.CompiledStyles;
+}>;
+/** 切换按钮组：单选或多选，整组一个 Tab 位置 */
+export declare const ToggleGroup: import("@zerodep-dev/vue-tsx-pro-tsx").TsxComponent<ToggleGroupProps>;
+/** 选中、不可用由组件管理 */
+export type ToggleGroupItemManaged = 'aria-pressed' | 'disabled' | 'type';
+/** 未声明的属性落到 button 上；只有图标时写 aria-label */
+export interface ToggleItemProps extends PartProps<'button', ToggleGroupItemManaged>, Pick<ButtonOptions, 'radius'> {
+    /** 这一项的值 */
+    value: string;
+    /** 图标 */
+    icon?: IconData;
+    /** 不可用 */
+    disabled?: boolean;
+    /** 图标的部件属性 */
+    propsIcon?: Partial<IconProps>;
+    /** 内容层的部件属性 */
+    propsContent?: PartProps<'span'>;
+    children?: VNodeChild;
+}
+/** 切换按钮组里的一项（button，aria-pressed 表示是否选中） */
+export declare const ToggleItem: import("@zerodep-dev/vue-tsx-pro-tsx").TsxComponent<ToggleItemProps>;