@tu-design/vue 0.2.2 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (37) hide show
  1. package/dist/index.d.mts +3365 -1104
  2. package/dist/index.mjs +7167 -1354
  3. package/dist/registry/vue/alert.json +22 -0
  4. package/dist/registry/vue/avatar-group.json +21 -0
  5. package/dist/registry/vue/avatar.json +3 -3
  6. package/dist/registry/vue/calendar.json +34 -0
  7. package/dist/registry/vue/card.json +3 -33
  8. package/dist/registry/vue/cascader.json +34 -0
  9. package/dist/registry/vue/checkbox.json +1 -1
  10. package/dist/registry/vue/currency-input.json +1 -1
  11. package/dist/registry/vue/date-picker.json +22 -0
  12. package/dist/registry/vue/date-range-picker.json +22 -0
  13. package/dist/registry/vue/date-shared.json +26 -0
  14. package/dist/registry/vue/dialog.json +3 -45
  15. package/dist/registry/vue/dropdown-menu.json +11 -35
  16. package/dist/registry/vue/empty.json +21 -0
  17. package/dist/registry/vue/form-render.json +115 -0
  18. package/dist/registry/vue/form.json +2 -2
  19. package/dist/registry/vue/month-picker.json +22 -0
  20. package/dist/registry/vue/number-input.json +1 -1
  21. package/dist/registry/vue/popover.json +3 -15
  22. package/dist/registry/vue/progress.json +22 -0
  23. package/dist/registry/vue/radio-group.json +2 -8
  24. package/dist/registry/vue/registry.json +114 -6
  25. package/dist/registry/vue/select.json +3 -27
  26. package/dist/registry/vue/slider.json +1 -1
  27. package/dist/registry/vue/spin.json +22 -0
  28. package/dist/registry/vue/table-render.json +62 -0
  29. package/dist/registry/vue/tabs.json +2 -20
  30. package/dist/registry/vue/toast.json +28 -0
  31. package/dist/registry/vue/tokens.json +1 -1
  32. package/dist/registry/vue/tooltip.json +2 -14
  33. package/dist/registry/vue/tree-select.json +34 -0
  34. package/dist/registry/vue/tree-shared.json +92 -0
  35. package/dist/registry/vue/week-picker.json +22 -0
  36. package/dist/registry/vue/year-picker.json +22 -0
  37. package/package.json +3 -1
@@ -10,19 +10,13 @@
10
10
  "path": "radio-group/RadioGroup.vue",
11
11
  "type": "registry:component",
12
12
  "target": "components/ui/radio-group/RadioGroup.vue",
13
- "content": "<script setup lang=\"ts\">\nimport { RadioGroup as ArkRadioGroup } from \"@ark-ui/vue/radio-group\";\nimport { cn } from \"@/lib/utils\";\n\ninterface Props {\n /** 当前值(配合 v-model:value);不传时为非受控 */\n value?: string;\n defaultValue?: string;\n disabled?: boolean;\n orientation?: \"horizontal\" | \"vertical\";\n class?: string;\n}\n\nconst props = defineProps<Props>();\n\nconst emit = defineEmits<{ \"update:value\": [value: string] }>();\n</script>\n\n<template>\n <ArkRadioGroup.Root\n :model-value=\"props.value\"\n :default-value=\"props.defaultValue\"\n :disabled=\"props.disabled\"\n :orientation=\"props.orientation\"\n :class=\"cn('grid gap-2', props.class)\"\n @update:model-value=\"(value: string) => emit('update:value', value)\"\n >\n <slot />\n </ArkRadioGroup.Root>\n</template>\n"
14
- },
15
- {
16
- "path": "radio-group/RadioGroupItem.vue",
17
- "type": "registry:component",
18
- "target": "components/ui/radio-group/RadioGroupItem.vue",
19
- "content": "<script setup lang=\"ts\">\nimport { RadioGroup as ArkRadioGroup } from \"@ark-ui/vue/radio-group\";\nimport { cn } from \"@/lib/utils\";\n\ninterface Props {\n value: string;\n disabled?: boolean;\n class?: string;\n}\n\nconst props = defineProps<Props>();\n</script>\n\n<template>\n <ArkRadioGroup.Item\n :value=\"props.value\"\n :disabled=\"props.disabled\"\n :class=\"cn('flex items-center gap-2', props.class)\"\n >\n <ArkRadioGroup.ItemHiddenInput />\n <ArkRadioGroup.ItemControl\n class=\"border-input text-primary shadow-xs focus-visible:border-ring focus-visible:ring-ring/50 group aspect-square size-4 shrink-0 rounded-full border outline-none focus-visible:ring-[3px] disabled:cursor-not-allowed disabled:opacity-50\"\n >\n <div\n class=\"bg-primary size-2 rounded-full opacity-0 transition-opacity group-data-[state=checked]:opacity-100\"\n />\n </ArkRadioGroup.ItemControl>\n <ArkRadioGroup.ItemText v-if=\"$slots.default\" class=\"text-sm\">\n <slot />\n </ArkRadioGroup.ItemText>\n </ArkRadioGroup.Item>\n</template>\n"
13
+ "content": "<script setup lang=\"ts\">\nimport { computed, ref } from \"vue\";\nimport { RadioGroup as ArkRadioGroup } from \"@ark-ui/vue/radio-group\";\nimport { cn } from \"@/lib/utils\";\n\n/** 单个选项配置项 */\ninterface RadioGroupOption {\n /** 选中后写入组值的唯一标识 */\n value: string;\n /** 选项文案 */\n label: string;\n /** 是否禁用该项(禁用项不响应点击且不参与键盘导航) */\n disabled?: boolean;\n /** 追加到选项根元素的样式类 */\n class?: string;\n}\n\ninterface Props {\n /** 选项列表(必填) */\n items: RadioGroupOption[];\n /** 当前值(配合 v-model:value);不传时为非受控(内部 ref 维护) */\n value?: string;\n defaultValue?: string;\n disabled?: boolean;\n /** 原生表单提交字段名 */\n name?: string;\n /** 关联的 form id */\n form?: string;\n required?: boolean;\n readOnly?: boolean;\n /** 校验无效态;zag 会级联 data-invalid 到 root/item/item-control */\n invalid?: boolean;\n orientation?: \"horizontal\" | \"vertical\";\n class?: string;\n}\n\nconst props = defineProps<Props>();\n\nconst emit = defineEmits<{ \"update:value\": [value: string] }>();\n\n// 对 Root 恒走受控模式,非受控语义由内部 ref 实现(Tabs/Checkbox 同款约定)\nconst internalValue = ref<string | null>(props.defaultValue ?? null);\nconst currentValue = computed(() => props.value ?? internalValue.value);\n\n// Ark 的 update:modelValue 实际类型为 string | null(单选交互不会产生 null,仅作守卫)\nfunction handleUpdate(value: string | null) {\n if (value === null) return;\n internalValue.value = value;\n emit(\"update:value\", value);\n}\n</script>\n\n<template>\n <ArkRadioGroup.Root\n :model-value=\"currentValue\"\n :disabled=\"props.disabled\"\n :name=\"props.name\"\n :form=\"props.form\"\n :required=\"props.required\"\n :read-only=\"props.readOnly\"\n :invalid=\"props.invalid\"\n :orientation=\"props.orientation\"\n :class=\"\n cn(\n 'grid gap-2',\n props.orientation === 'horizontal' && 'grid-flow-col auto-cols-max gap-4',\n props.class,\n )\n \"\n @update:model-value=\"handleUpdate\"\n >\n <ArkRadioGroup.Item\n v-for=\"item in props.items\"\n :key=\"item.value\"\n :value=\"item.value\"\n :disabled=\"item.disabled\"\n :class=\"cn('flex items-center gap-2', item.class)\"\n >\n <!-- 隐藏原生 input 始终渲染:name/required 等表单语义不因自定义渲染丢失 -->\n <ArkRadioGroup.ItemHiddenInput />\n <!-- #item 逃生口:接管圆点控件与文本的渲染;未提供时使用内置渲染 -->\n <slot name=\"item\" :item=\"item\" :checked=\"item.value === currentValue\">\n <ArkRadioGroup.ItemControl\n class=\"border-input text-primary shadow-xs focus-visible:border-ring focus-visible:ring-ring/50 group flex aspect-square size-4 shrink-0 items-center justify-center rounded-full border outline-none focus-visible:ring-[3px] disabled:cursor-not-allowed disabled:opacity-50 data-invalid:border-destructive data-invalid:ring-destructive/20 data-invalid:ring-[3px]\"\n >\n <div\n class=\"bg-primary group-data-[invalid]:bg-destructive size-2 rounded-full opacity-0 transition-opacity group-data-[state=checked]:opacity-100\"\n />\n </ArkRadioGroup.ItemControl>\n <ArkRadioGroup.ItemText class=\"text-sm\">{{ item.label }}</ArkRadioGroup.ItemText>\n </slot>\n </ArkRadioGroup.Item>\n </ArkRadioGroup.Root>\n</template>\n"
20
14
  },
21
15
  {
22
16
  "path": "radio-group/index.ts",
23
17
  "type": "registry:component",
24
18
  "target": "components/ui/radio-group/index.ts",
25
- "content": "export { default as RadioGroup } from \"./RadioGroup.vue\";\nexport { default as RadioGroupItem } from \"./RadioGroupItem.vue\";\n"
19
+ "content": "export { default as RadioGroup } from \"./RadioGroup.vue\";\n"
26
20
  }
27
21
  ]
28
22
  }
@@ -2,11 +2,23 @@
2
2
  "$schema": "https://ui.shadcn.com/schema/registry.json",
3
3
  "name": "tu-design",
4
4
  "items": [
5
+ {
6
+ "name": "alert",
7
+ "title": "Alert",
8
+ "type": "registry:ui",
9
+ "description": "语义化警示条,支持五种变体、内置图标与可关闭交互。"
10
+ },
5
11
  {
6
12
  "name": "avatar",
7
13
  "title": "Avatar",
8
14
  "type": "registry:ui",
9
- "description": "头像,含图片加载与回退(Ark UI)。"
15
+ "description": "头像,支持尺寸/形状、加载占位与失败回退(Ark UI)。"
16
+ },
17
+ {
18
+ "name": "avatar-group",
19
+ "title": "AvatarGroup",
20
+ "type": "registry:ui",
21
+ "description": "头像组,数量折叠、悬停展开与垂直排列。"
10
22
  },
11
23
  {
12
24
  "name": "badge",
@@ -20,11 +32,23 @@
20
32
  "type": "registry:ui",
21
33
  "description": "带变体与尺寸的按钮,支持 as 标签切换与 asChild 组合。"
22
34
  },
35
+ {
36
+ "name": "calendar",
37
+ "title": "Calendar",
38
+ "type": "registry:ui",
39
+ "description": "日历(TCalendar):紧凑日历卡。Picker 弹层内为 embedded 内嵌形态(TDatePicker/TDateRangePicker 自动挂靠,纯卡片内核);独立使用即 standalone 独立形态(自带日历状态与 v-model,恒开展示)。"
40
+ },
23
41
  {
24
42
  "name": "card",
25
43
  "title": "Card",
26
44
  "type": "registry:ui",
27
- "description": "卡片容器族:Header/Title/Description/Content/Footer。"
45
+ "description": "卡片容器:单组件 API,title/description 头部 + 命名插槽(cover/action/footer/header),支持尺寸、视觉变体、分段分隔与可关闭。"
46
+ },
47
+ {
48
+ "name": "cascader",
49
+ "title": "Cascader",
50
+ "type": "registry:ui",
51
+ "description": "级联选择:一站式 props 驱动,多列联动、勾选级联、路径回显与多标签。"
28
52
  },
29
53
  {
30
54
  "name": "checkbox",
@@ -38,17 +62,41 @@
38
62
  "type": "registry:ui",
39
63
  "description": "金额输入框:内置万/元/角/分单位后缀,labelUnit 输入单位与 valueUnit 存储单位自动换算(整数分最小精度),值以 number|null 受控。"
40
64
  },
65
+ {
66
+ "name": "date-picker",
67
+ "title": "DatePicker",
68
+ "type": "registry:ui",
69
+ "description": "日期选择器:输入框 + 日历弹层(月/年视图切换),支持手动键入/清空/min-max 边界/不可选谓词,值以 \"yyyy-MM-dd\" 字符串受控。"
70
+ },
71
+ {
72
+ "name": "date-range-picker",
73
+ "title": "DateRangePicker",
74
+ "type": "registry:ui",
75
+ "description": "日期范围选择器:双月日历弹层(月/年视图切换),点选起点与终点,值以 [\"yyyy-MM-dd\", \"yyyy-MM-dd\"] 有序元组受控,空值归一 null。"
76
+ },
77
+ {
78
+ "name": "date-shared",
79
+ "title": "DateShared",
80
+ "type": "registry:ui",
81
+ "description": "日期家族共享模块:ISO 值域解析(日期/月/年/区间)与日历样式常量。"
82
+ },
41
83
  {
42
84
  "name": "dialog",
43
85
  "title": "Dialog",
44
86
  "type": "registry:ui",
45
- "description": "模态对话框:基于 Ark UI Dialog 原语,含焦点圈定、Escape/遮罩关闭与进出场动画,支持 asChild 与 v-model:open。"
87
+ "description": "模态对话框单组件:#trigger 放触发元素,title/description 传文案,#footer 注入 close 关闭;基于 Ark UI Dialog 原语,含焦点圈定、Escape/遮罩关闭与进出场动画,支持 v-model:open。"
46
88
  },
47
89
  {
48
90
  "name": "dropdown-menu",
49
91
  "title": "DropdownMenu",
50
92
  "type": "registry:ui",
51
- "description": "下拉菜单:基于 Ark UI Menu 原语,含键盘导航、选中回调与分组/分隔线,Trigger 支持 asChild。"
93
+ "description": "下拉菜单:单组件模式,items 描述菜单项(含分组/标题/分隔线,支持嵌套),内置键盘导航与选中回调,默认插槽为触发元素(asChild 透传)。"
94
+ },
95
+ {
96
+ "name": "empty",
97
+ "title": "Empty",
98
+ "type": "registry:ui",
99
+ "description": "空状态占位,含默认插画与描述文案。"
52
100
  },
53
101
  {
54
102
  "name": "form",
@@ -56,6 +104,12 @@
56
104
  "type": "registry:ui",
57
105
  "description": "表单状态与校验:基于 TanStack Form,配合 Valibot(Standard Schema)声明式校验,aria 自动接线。"
58
106
  },
107
+ {
108
+ "name": "form-render",
109
+ "title": "FormRender",
110
+ "type": "registry:ui",
111
+ "description": "配置驱动表单渲染器:defineForm 聚合 TanStack Form 实例与字段配置,柯里化 widget DSL 声明控件,Tailwind 栅格自适应布局,复用 Form 家族 aria 接线。"
112
+ },
59
113
  {
60
114
  "name": "input",
61
115
  "title": "Input",
@@ -68,6 +122,12 @@
68
122
  "type": "registry:ui",
69
123
  "description": "表单标签。"
70
124
  },
125
+ {
126
+ "name": "month-picker",
127
+ "title": "MonthPicker",
128
+ "type": "registry:ui",
129
+ "description": "月份选择器:输入框 + 锁定月视图的日历弹层,值以 \"yyyy-MM\" 字符串受控,min/max 为月粒度闭区间(内部换算到当月末日)。"
130
+ },
71
131
  {
72
132
  "name": "number-input",
73
133
  "title": "NumberInput",
@@ -90,7 +150,13 @@
90
150
  "name": "popover",
91
151
  "title": "Popover",
92
152
  "type": "registry:ui",
93
- "description": "气泡弹层:基于 Ark UI Popover 原语,受控/非受控开关,Trigger 支持 asChild。"
153
+ "description": "气泡弹层:基于 Ark UI Popover 原语的单组件,默认插槽为触发元素本体(asChild 语义),面板内容放 #content 插槽,受控/非受控开关。"
154
+ },
155
+ {
156
+ "name": "progress",
157
+ "title": "Progress",
158
+ "type": "registry:ui",
159
+ "description": "进度条:基于 Ark UI Progress 原语,支持语义色、标签与百分比显示、不确定态。"
94
160
  },
95
161
  {
96
162
  "name": "radio-group",
@@ -102,7 +168,7 @@
102
168
  "name": "select",
103
169
  "title": "Select",
104
170
  "type": "registry:ui",
105
- "description": "下拉选择框:基于 Ark UI Select 原语,含键盘导航、选中回显与勾选指示,Trigger 支持 asChild。"
171
+ "description": "下拉选择框:单组件 API,传入 items 数据驱动渲染,内置触发器回显、键盘导航与勾选指示,支持 #item 插槽自定义选项。"
106
172
  },
107
173
  {
108
174
  "name": "separator",
@@ -128,12 +194,24 @@
128
194
  "type": "registry:ui",
129
195
  "description": "asChild 组合原语:将组件的 class 与 attrs 合并到子元素上,而不渲染额外 DOM。"
130
196
  },
197
+ {
198
+ "name": "spin",
199
+ "title": "Spin",
200
+ "type": "registry:ui",
201
+ "description": "加载中旋转指示器,支持独立 spinner 与包裹内容(半透明遮罩)两种形态。"
202
+ },
131
203
  {
132
204
  "name": "switch",
133
205
  "title": "Switch",
134
206
  "type": "registry:ui",
135
207
  "description": "开关:基于 Ark UI Switch 原语,支持标签插槽、受控/非受控与禁用。"
136
208
  },
209
+ {
210
+ "name": "table-render",
211
+ "title": "TableRender",
212
+ "type": "registry:ui",
213
+ "description": "配置驱动表格渲染器:defineTable 聚合 TanStack Table 实例与列配置,静态/服务端双模式(onLoad 回写分页排序),搜索表单联动(search 接 FormRender),左右固定列 sticky 横向滚动,表体虚拟滚动(virtual + height,TanStack Virtual 动态测量行高),树形数据(tree:子行展开/收起、depth 缩进、caret 位于首列),列显隐(columnSettings 面板 + visibleKeys 受控),错误态占位与重试(#error 插槽 + load-error),ellipsis 支持 tooltip 形态,v-model 受控(pageIndex/pageSize/sort/selectedKeys),Ark Pagination 分页条 + 原生 select 每页条数,排序表头 aria-sort、加载骨架与空态插槽,语义化 table + Tailwind tokens。"
214
+ },
137
215
  {
138
216
  "name": "tabs",
139
217
  "title": "Tabs",
@@ -146,6 +224,12 @@
146
224
  "type": "registry:ui",
147
225
  "description": "多行文本输入:纯样式封装,支持 invalid 校验态。"
148
226
  },
227
+ {
228
+ "name": "toast",
229
+ "title": "Toast",
230
+ "type": "registry:ui",
231
+ "description": "全局轻提示:ToastProvider 在应用根部挂载一次,useToast() 提供命令式 API(success/error/info/warning/loading/promise/dismiss);基于 Ark UI Toast 原语,语义 type 映射主题 token 配色。"
232
+ },
149
233
  {
150
234
  "name": "tokens",
151
235
  "title": "Tokens",
@@ -158,11 +242,35 @@
158
242
  "type": "registry:ui",
159
243
  "description": "文字提示气泡:悬停触发,基于 Ark UI Tooltip 原语,支持 asChild 与延迟配置。"
160
244
  },
245
+ {
246
+ "name": "tree-select",
247
+ "title": "TreeSelect",
248
+ "type": "registry:ui",
249
+ "description": "树形下拉选择:一站式 props 驱动,支持单/多选、勾选级联、过滤与多标签折叠。"
250
+ },
251
+ {
252
+ "name": "tree-shared",
253
+ "title": "TreeShared",
254
+ "type": "registry:ui",
255
+ "description": "树形数据层与共享类型(移植自 treemate v0.3.11,MIT)。"
256
+ },
161
257
  {
162
258
  "name": "utils",
163
259
  "title": "Utils",
164
260
  "type": "registry:lib",
165
261
  "description": "cn 类名合并工具(clsx + tailwind-merge)。"
262
+ },
263
+ {
264
+ "name": "week-picker",
265
+ "title": "WeekPicker",
266
+ "type": "registry:ui",
267
+ "description": "周选择器:输入框 + 日历弹层,点任意可选日归一到所在周并整周高亮,值以 \"yyyy-MM-dd\"(所在周起始日)字符串受控;周起点跟随 locale(zh-CN 周一起始),输入框回显 \"start ~ end\"。"
268
+ },
269
+ {
270
+ "name": "year-picker",
271
+ "title": "YearPicker",
272
+ "type": "registry:ui",
273
+ "description": "年份选择器:输入框 + 锁定年视图的日历弹层(decade 网格),值以 \"yyyy\" 字符串受控,min/max 为年粒度闭区间。"
166
274
  }
167
275
  ]
168
276
  }
@@ -2,7 +2,7 @@
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "select",
4
4
  "type": "registry:ui",
5
- "description": "下拉选择框:基于 Ark UI Select 原语,含键盘导航、选中回显与勾选指示,Trigger 支持 asChild。",
5
+ "description": "下拉选择框:单组件 API,传入 items 数据驱动渲染,内置触发器回显、键盘导航与勾选指示,支持 #item 插槽自定义选项。",
6
6
  "registryDependencies": ["utils"],
7
7
  "dependencies": ["@ark-ui/vue@^5.39.2"],
8
8
  "files": [
@@ -10,37 +10,13 @@
10
10
  "path": "select/Select.vue",
11
11
  "type": "registry:component",
12
12
  "target": "components/ui/select/Select.vue",
13
- "content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { computed, ref } from \"vue\";\nimport { createListCollection } from \"@ark-ui/vue/collection\";\nimport { Select as ArkSelect } from \"@ark-ui/vue/select\";\nimport type { SelectItemOption } from \"./types\";\n\n// modelValue 为 String 类型无 Boolean casting 问题;「未传」经 default: undefined 保持 undefined\nconst props = defineProps({\n /** 选项列表(构建键盘导航/回显所需的 collection) */\n items: { type: Array as PropType<(string | SelectItemOption)[]>, required: true },\n /** 当前值(配合 v-model);不传时为非受控 */\n modelValue: { type: String as PropType<string | undefined>, default: undefined },\n defaultValue: { type: String, default: undefined },\n open: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n defaultOpen: { type: Boolean, default: false },\n lazyMount: { type: Boolean, default: false },\n unmountOnExit: { type: Boolean, default: false },\n});\n\nconst emit = defineEmits<{\n \"update:modelValue\": [value: string];\n \"update:open\": [open: boolean];\n}>();\n\n// zag select 的 value 内部统一为数组,这里保持单选 string 的公开语义\nconst toArray = (v: string | undefined) => (v === undefined ? undefined : [v]);\n\n// 对 Root 恒走受控模式(Dialog 同款):非受控语义由内部 ref 实现\nconst internalValue = ref<string | undefined>(props.defaultValue);\nconst modelValue = computed(() => props.modelValue ?? internalValue.value);\nconst collection = computed(() =>\n createListCollection({\n items: props.items.map((item) =>\n typeof item === \"string\" ? { label: item, value: item } : item,\n ),\n }),\n);\n\nfunction handleModelUpdate(next: string | string[]) {\n const value = Array.isArray(next) ? next[0]! : next;\n internalValue.value = value;\n emit(\"update:modelValue\", value);\n}\n\nconst internalOpen = ref(props.defaultOpen);\nconst isOpen = computed(() => props.open ?? internalOpen.value);\n\nfunction handleOpenUpdate(open: boolean) {\n internalOpen.value = open;\n emit(\"update:open\", open);\n}\n</script>\n\n<template>\n <ArkSelect.Root\n :collection=\"collection\"\n :model-value=\"toArray(modelValue)\"\n :open=\"isOpen\"\n :lazy-mount=\"props.lazyMount\"\n :unmount-on-exit=\"props.unmountOnExit\"\n @update:model-value=\"handleModelUpdate\"\n @update:open=\"handleOpenUpdate\"\n >\n <slot />\n </ArkSelect.Root>\n</template>\n"
14
- },
15
- {
16
- "path": "select/SelectContent.vue",
17
- "type": "registry:component",
18
- "target": "components/ui/select/SelectContent.vue",
19
- "content": "<script setup lang=\"ts\">\nimport { Select as ArkSelect } from \"@ark-ui/vue/select\";\nimport { cn } from \"@/lib/utils\";\n\ninterface Props {\n class?: string;\n}\n\nconst props = defineProps<Props>();\n</script>\n\n<template>\n <ArkSelect.Positioner class=\"z-50\">\n <ArkSelect.Content\n :class=\"\n cn(\n 'bg-popover text-popover-foreground data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 relative z-50 max-h-96 min-w-[8rem] overflow-hidden rounded-md border shadow-md',\n props.class,\n )\n \"\n >\n <slot />\n </ArkSelect.Content>\n </ArkSelect.Positioner>\n</template>\n"
20
- },
21
- {
22
- "path": "select/SelectItem.vue",
23
- "type": "registry:component",
24
- "target": "components/ui/select/SelectItem.vue",
25
- "content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { computed } from \"vue\";\nimport { Select as ArkSelect } from \"@ark-ui/vue/select\";\nimport { cn } from \"@/lib/utils\";\nimport { normalizeSelectItem, type SelectItemOption } from \"./types\";\n\ninterface Props {\n /** 选项(与 TSelect 的 items 中对应项一致,或直接传字符串) */\n item: string | SelectItemOption;\n class?: string;\n}\n\nconst props = defineProps({\n item: {\n type: [String, Object] as PropType<string | SelectItemOption>,\n required: true,\n },\n class: { type: String, default: undefined },\n});\n\nconst normalized = computed(() => normalizeSelectItem(props.item));\n</script>\n\n<template>\n <ArkSelect.Item\n :item=\"normalized\"\n :class=\"\n cn(\n 'data-[highlighted]:bg-accent data-[highlighted]:text-accent-foreground relative flex w-full cursor-pointer items-center gap-2 rounded-sm py-1.5 pr-8 pl-2 text-sm outline-none select-none data-[disabled]:pointer-events-none data-[disabled]:opacity-50',\n props.class,\n )\n \"\n >\n <ArkSelect.ItemText>{{ normalized.label }}</ArkSelect.ItemText>\n <ArkSelect.ItemIndicator class=\"absolute right-2\">\n <svg\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"2\"\n stroke-linecap=\"round\"\n stroke-linejoin=\"round\"\n class=\"size-4\"\n >\n <path d=\"M20 6 9 17l-5-5\" />\n </svg>\n </ArkSelect.ItemIndicator>\n </ArkSelect.Item>\n</template>\n"
26
- },
27
- {
28
- "path": "select/SelectTrigger.vue",
29
- "type": "registry:component",
30
- "target": "components/ui/select/SelectTrigger.vue",
31
- "content": "<script setup lang=\"ts\">\nimport { Select as ArkSelect } from \"@ark-ui/vue/select\";\nimport { cn } from \"@/lib/utils\";\n\ninterface Props {\n /** 以默认插槽子元素为渲染目标(chevron 需自行放置) */\n asChild?: boolean;\n class?: string;\n}\n\nconst props = defineProps<Props>();\n</script>\n\n<template>\n <ArkSelect.Control class=\"w-fit\">\n <ArkSelect.Trigger\n :as-child=\"props.asChild\"\n :class=\"\n cn(\n 'border-input data-[placeholder]:text-muted-foreground focus-visible:border-ring focus-visible:ring-ring/50 flex h-9 w-fit items-center justify-between gap-2 rounded-md border bg-transparent px-3 py-2 text-sm whitespace-nowrap shadow-xs focus-visible:outline-none focus-visible:ring-[3px] disabled:cursor-not-allowed disabled:opacity-50 [&_svg]:shrink-0 [&_svg:not([class*=size-])]:size-4',\n props.class,\n )\n \"\n >\n <slot />\n <svg\n v-if=\"!props.asChild\"\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"2\"\n stroke-linecap=\"round\"\n stroke-linejoin=\"round\"\n class=\"size-4 opacity-50\"\n >\n <path d=\"m6 9 6 6 6-6\" />\n </svg>\n </ArkSelect.Trigger>\n </ArkSelect.Control>\n</template>\n"
32
- },
33
- {
34
- "path": "select/SelectValueText.vue",
35
- "type": "registry:component",
36
- "target": "components/ui/select/SelectValueText.vue",
37
- "content": "<script setup lang=\"ts\">\nimport { Select as ArkSelect } from \"@ark-ui/vue/select\";\n\ninterface Props {\n placeholder?: string;\n}\n\nconst props = defineProps<Props>();\n</script>\n\n<!-- 注意:不能向 ValueText 传插槽内容,其内部会对默认插槽做字符串化渲染 -->\n<template>\n <ArkSelect.ValueText :placeholder=\"props.placeholder\" />\n</template>\n"
13
+ "content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { computed, ref } from \"vue\";\nimport { createListCollection } from \"@ark-ui/vue/collection\";\nimport { Select as ArkSelect } from \"@ark-ui/vue/select\";\nimport { cn } from \"@/lib/utils\";\nimport { normalizeSelectItem, type SelectItemOption } from \"./types\";\n\n// modelValue 为 String 类型无 Boolean casting 问题;「未传」经 default: undefined 保持 undefined\nconst props = defineProps({\n /** 选项列表:字符串(label = value)或 { label, value, disabled? } */\n items: { type: Array as PropType<(string | SelectItemOption)[]>, required: true },\n /** 当前值(配合 v-model);不传时为非受控 */\n modelValue: { type: String as PropType<string | undefined>, default: undefined },\n defaultValue: { type: String, default: undefined },\n /** 弹层开合受控;undefined 走内部非受控(default: undefined 禁用 Boolean casting) */\n open: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n defaultOpen: { type: Boolean, default: false },\n /** 未选中时触发器显示的占位文案 */\n placeholder: { type: String, default: \"请选择\" },\n /** 透传合并到触发器(Trigger)的 class */\n triggerClass: { type: String, default: undefined },\n /** 透传合并到弹层(Content)的 class */\n contentClass: { type: String, default: undefined },\n});\n\nconst emit = defineEmits<{\n \"update:modelValue\": [value: string];\n \"update:open\": [open: boolean];\n}>();\n\n// zag select 的 value 内部统一为数组,这里保持单选 string 的公开语义\nconst toArray = (v: string | undefined) => (v === undefined ? undefined : [v]);\n\n// 对 Root 恒走受控模式(DatePicker 同款):非受控语义由内部 ref 实现\nconst internalValue = ref<string | undefined>(props.defaultValue);\nconst modelValue = computed(() => props.modelValue ?? internalValue.value);\n\n// 一次归一化(string → { label, value }),v-for 与 #item 插槽作用域共用\nconst normalizedItems = computed(() =>\n props.items.map((raw) => ({ raw, item: normalizeSelectItem(raw) })),\n);\n\nconst collection = computed(() =>\n createListCollection({\n items: normalizedItems.value.map((entry) => entry.item),\n isItemDisabled: (item) => item.disabled === true,\n }),\n);\n\nfunction handleModelUpdate(next: string | string[]) {\n const value = Array.isArray(next) ? next[0]! : next;\n internalValue.value = value;\n emit(\"update:modelValue\", value);\n}\n\nconst internalOpen = ref(props.defaultOpen);\nconst isOpen = computed(() => props.open ?? internalOpen.value);\n\nfunction handleOpenUpdate(open: boolean) {\n internalOpen.value = open;\n emit(\"update:open\", open);\n}\n</script>\n\n<template>\n <ArkSelect.Root\n :collection=\"collection\"\n :model-value=\"toArray(modelValue)\"\n :open=\"isOpen\"\n @update:model-value=\"handleModelUpdate\"\n @update:open=\"handleOpenUpdate\"\n >\n <!-- 触发器(收编自 SelectTrigger:内置选中回显与 chevron) -->\n <ArkSelect.Control class=\"w-fit\">\n <ArkSelect.Trigger\n :class=\"\n cn(\n 'border-input data-[placeholder]:text-muted-foreground focus-visible:border-ring focus-visible:ring-ring/50 flex h-9 w-fit items-center justify-between gap-2 rounded-md border bg-transparent px-3 py-2 text-sm whitespace-nowrap shadow-xs focus-visible:outline-none focus-visible:ring-[3px] disabled:cursor-not-allowed disabled:opacity-50 [&_svg]:shrink-0 [&_svg:not([class*=size-])]:size-4',\n props.triggerClass,\n )\n \"\n >\n <!-- 注意:不能向 ValueText 传插槽内容,其内部会对默认插槽做字符串化渲染 -->\n <ArkSelect.ValueText :placeholder=\"props.placeholder\" />\n <svg\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"2\"\n stroke-linecap=\"round\"\n stroke-linejoin=\"round\"\n class=\"size-4 opacity-50\"\n >\n <path d=\"m6 9 6 6 6-6\" />\n </svg>\n </ArkSelect.Trigger>\n </ArkSelect.Control>\n\n <ArkSelect.Positioner class=\"z-50\">\n <ArkSelect.Content\n :class=\"\n cn(\n 'bg-popover text-popover-foreground data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 relative z-50 max-h-96 min-w-[8rem] overflow-hidden rounded-md border shadow-md',\n props.contentClass,\n )\n \"\n >\n <ArkSelect.Item\n v-for=\"entry in normalizedItems\"\n :key=\"entry.item.value\"\n :item=\"entry.item\"\n class=\"data-[highlighted]:bg-accent data-[highlighted]:text-accent-foreground relative flex w-full cursor-pointer items-center gap-2 rounded-sm py-1.5 pr-8 pl-2 text-sm outline-none select-none data-[disabled]:pointer-events-none data-[disabled]:opacity-50\"\n >\n <slot\n name=\"item\"\n :item=\"entry.raw\"\n :label=\"entry.item.label\"\n :selected=\"entry.item.value === modelValue\"\n >\n <ArkSelect.ItemText>{{ entry.item.label }}</ArkSelect.ItemText>\n <ArkSelect.ItemIndicator class=\"absolute right-2\">\n <svg\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"2\"\n stroke-linecap=\"round\"\n stroke-linejoin=\"round\"\n class=\"size-4\"\n >\n <path d=\"M20 6 9 17l-5-5\" />\n </svg>\n </ArkSelect.ItemIndicator>\n </slot>\n </ArkSelect.Item>\n </ArkSelect.Content>\n </ArkSelect.Positioner>\n </ArkSelect.Root>\n</template>\n"
38
14
  },
39
15
  {
40
16
  "path": "select/index.ts",
41
17
  "type": "registry:component",
42
18
  "target": "components/ui/select/index.ts",
43
- "content": "export { default as Select } from \"./Select.vue\";\nexport { default as SelectContent } from \"./SelectContent.vue\";\nexport { default as SelectItem } from \"./SelectItem.vue\";\nexport { default as SelectTrigger } from \"./SelectTrigger.vue\";\nexport { default as SelectValueText } from \"./SelectValueText.vue\";\nexport type { SelectItemOption } from \"./types\";\n"
19
+ "content": "export { default as Select } from \"./Select.vue\";\nexport type { SelectItemOption } from \"./types\";\n"
44
20
  },
45
21
  {
46
22
  "path": "select/types.ts",
@@ -10,7 +10,7 @@
10
10
  "path": "slider/Slider.vue",
11
11
  "type": "registry:component",
12
12
  "target": "components/ui/slider/Slider.vue",
13
- "content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { computed } from \"vue\";\nimport { Slider as ArkSlider } from \"@ark-ui/vue/slider\";\nimport { cn } from \"@/lib/utils\";\n\ninterface Props {\n /** 当前值(配合 v-model);单值或区间数组,不传时为非受控 */\n value?: number | number[];\n defaultValue?: number | number[];\n min?: number;\n max?: number;\n step?: number;\n disabled?: boolean;\n class?: string;\n}\n\nconst props = withDefaults(\n defineProps<{\n value?: number | number[];\n defaultValue?: number | number[];\n min?: number;\n max?: number;\n step?: number;\n disabled?: boolean;\n class?: string;\n }>(),\n { min: 0, max: 100, step: 1 },\n);\n\nconst emit = defineEmits<{ \"update:modelValue\": [value: number[]] }>();\n\nconst toArray = (v: number | number[] | undefined) =>\n v === undefined ? undefined : Array.isArray(v) ? v : [v];\n\nconst thumbs = computed(() => toArray(props.value) ?? toArray(props.defaultValue) ?? [props.min]);\n</script>\n\n<template>\n <ArkSlider.Root\n :model-value=\"toArray(props.value)\"\n :default-value=\"toArray(props.defaultValue)\"\n :min=\"props.min\"\n :max=\"props.max\"\n :step=\"props.step\"\n :disabled=\"props.disabled\"\n :class=\"\n cn(\n 'relative flex w-full touch-none select-none items-center data-[disabled]:opacity-50',\n props.class,\n )\n \"\n @update:model-value=\"(value: number[]) => emit('update:modelValue', value)\"\n >\n <ArkSlider.Control class=\"relative flex h-5 w-full items-center\">\n <ArkSlider.Track class=\"bg-muted relative h-1 w-full grow overflow-hidden rounded-full\">\n <ArkSlider.Range class=\"bg-primary absolute h-full\" />\n </ArkSlider.Track>\n <ArkSlider.Thumb\n v-for=\"(_, index) in thumbs\"\n :key=\"index\"\n :index=\"index\"\n class=\"border-primary bg-background ring-ring/50 block size-4 shrink-0 rounded-full border shadow-sm transition-[color,box-shadow] outline-none focus-visible:ring-[3px] disabled:pointer-events-none disabled:opacity-50\"\n >\n <ArkSlider.HiddenInput />\n </ArkSlider.Thumb>\n </ArkSlider.Control>\n </ArkSlider.Root>\n</template>\n"
13
+ "content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { computed } from \"vue\";\nimport { Slider as ArkSlider } from \"@ark-ui/vue/slider\";\nimport { cn } from \"@/lib/utils\";\n\ninterface Props {\n min?: number;\n max?: number;\n step?: number;\n disabled?: boolean;\n class?: string;\n}\n\nconst props = withDefaults(\n defineProps<{\n /** 当前值(配合 v-model);单值或区间数组,不传时为非受控。出参恒为 number[] */\n modelValue?: number | number[];\n /** 同 modelValue(兼容别名,v-model 场景请直接用 modelValue) */\n value?: number | number[];\n defaultValue?: number | number[];\n min?: number;\n max?: number;\n step?: number;\n disabled?: boolean;\n class?: string;\n }>(),\n { min: 0, max: 100, step: 1 },\n);\n\nconst emit = defineEmits<{ \"update:modelValue\": [value: number[]] }>();\n\nconst toArray = (v: number | number[] | undefined) =>\n v === undefined ? undefined : Array.isArray(v) ? v : [v];\n\n// modelValue 未传时回落 value(兼容别名);都未传走非受控(defaultValue/内部状态)\nconst thumbs = computed(\n () =>\n toArray(props.modelValue) ?? toArray(props.value) ?? toArray(props.defaultValue) ?? [props.min],\n);\n</script>\n\n<template>\n <ArkSlider.Root\n :model-value=\"toArray(props.modelValue) ?? toArray(props.value)\"\n :default-value=\"toArray(props.defaultValue)\"\n :min=\"props.min\"\n :max=\"props.max\"\n :step=\"props.step\"\n :disabled=\"props.disabled\"\n :class=\"\n cn(\n 'relative flex w-full touch-none select-none items-center data-[disabled]:opacity-50',\n props.class,\n )\n \"\n @update:model-value=\"(value: number[]) => emit('update:modelValue', value)\"\n >\n <ArkSlider.Control class=\"relative flex h-5 w-full items-center\">\n <ArkSlider.Track class=\"bg-muted relative h-1 w-full grow overflow-hidden rounded-full\">\n <ArkSlider.Range class=\"bg-primary absolute h-full\" />\n </ArkSlider.Track>\n <ArkSlider.Thumb\n v-for=\"(_, index) in thumbs\"\n :key=\"index\"\n :index=\"index\"\n class=\"border-primary bg-background ring-ring/50 block size-4 shrink-0 rounded-full border shadow-sm transition-[color,box-shadow] outline-none focus-visible:ring-[3px] disabled:pointer-events-none disabled:opacity-50\"\n >\n <ArkSlider.HiddenInput />\n </ArkSlider.Thumb>\n </ArkSlider.Control>\n </ArkSlider.Root>\n</template>\n"
14
14
  },
15
15
  {
16
16
  "path": "slider/index.ts",
@@ -0,0 +1,22 @@
1
+ {
2
+ "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
+ "name": "spin",
4
+ "type": "registry:ui",
5
+ "description": "加载中旋转指示器,支持独立 spinner 与包裹内容(半透明遮罩)两种形态。",
6
+ "registryDependencies": ["utils"],
7
+ "dependencies": ["class-variance-authority@^0.7.1"],
8
+ "files": [
9
+ {
10
+ "path": "spin/Spin.vue",
11
+ "type": "registry:component",
12
+ "target": "components/ui/spin/Spin.vue",
13
+ "content": "<script setup lang=\"ts\">\nimport { cva } from \"class-variance-authority\";\nimport { computed, useSlots } from \"vue\";\nimport { cn } from \"@/lib/utils\";\n\nconst props = withDefaults(\n defineProps<{\n /** spinner 尺寸 */\n size?: \"sm\" | \"default\" | \"lg\";\n /** 是否处于加载中 */\n spinning?: boolean;\n /** 无障碍标签(role=\"status\" 的 aria-label) */\n label?: string;\n class?: string;\n }>(),\n {\n size: \"default\",\n spinning: true,\n label: \"加载中\",\n },\n);\n\nconst spinVariants = cva(\"text-primary\", {\n variants: {\n size: {\n sm: \"size-4\",\n default: \"size-6\",\n lg: \"size-8\",\n },\n },\n defaultVariants: {\n size: \"default\",\n },\n});\n\n// aria-busy + aria-label 只挂在 role=\"status\" 状态元素上(避免根/状态元素双重播报);\n// 包裹态(默认插槽有内容)渲染内容 + 半透明遮罩,独立态仅渲染 spinner;\n// 包裹态 spinning 时根元素置 inert,阻止被遮罩内容聚焦/交互\nconst slots = useSlots();\nconst hasContent = computed(() => !!slots.default);\n</script>\n\n<template>\n <div\n v-if=\"hasContent || spinning\"\n :class=\"cn(hasContent ? 'relative' : 'inline-flex', props.class)\"\n :inert=\"hasContent && spinning\"\n >\n <slot v-if=\"hasContent\" />\n\n <div\n v-if=\"spinning\"\n role=\"status\"\n :aria-busy=\"spinning\"\n :aria-label=\"label\"\n :class=\"\n hasContent\n ? 'absolute inset-0 z-10 flex items-center justify-center rounded-[inherit] bg-background/60'\n : 'flex'\n \"\n >\n <svg\n :class=\"cn('animate-spin', spinVariants({ size }))\"\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n aria-hidden=\"true\"\n >\n <circle cx=\"12\" cy=\"12\" r=\"10\" stroke=\"currentColor\" stroke-width=\"3\" class=\"opacity-25\" />\n <path\n d=\"M22 12a10 10 0 0 0-10-10\"\n stroke=\"currentColor\"\n stroke-width=\"3\"\n stroke-linecap=\"round\"\n />\n </svg>\n </div>\n </div>\n</template>\n"
14
+ },
15
+ {
16
+ "path": "spin/index.ts",
17
+ "type": "registry:component",
18
+ "target": "components/ui/spin/index.ts",
19
+ "content": "export { default as Spin } from \"./Spin.vue\";\n"
20
+ }
21
+ ]
22
+ }