@tu-design/vue 0.5.12 → 0.5.14
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.
- package/dist/index.d.mts +19 -19
- package/dist/index.mjs +72 -6
- package/dist/registry/vue/alert-dialog.json +2 -2
- package/dist/registry/vue/alert.json +1 -1
- package/dist/registry/vue/avatar-group.json +1 -1
- package/dist/registry/vue/avatar.json +1 -1
- package/dist/registry/vue/badge.json +1 -1
- package/dist/registry/vue/button.json +1 -1
- package/dist/registry/vue/calendar.json +1 -1
- package/dist/registry/vue/card.json +1 -1
- package/dist/registry/vue/cascader.json +1 -1
- package/dist/registry/vue/checkbox.json +1 -1
- package/dist/registry/vue/context-menu.json +1 -1
- package/dist/registry/vue/currency-input.json +1 -1
- package/dist/registry/vue/date-picker.json +1 -1
- package/dist/registry/vue/date-range-picker.json +1 -1
- package/dist/registry/vue/date-shared.json +1 -1
- package/dist/registry/vue/dialog.json +2 -2
- package/dist/registry/vue/drawer.json +1 -1
- package/dist/registry/vue/dropdown-menu.json +1 -1
- package/dist/registry/vue/empty.json +1 -1
- package/dist/registry/vue/form-render.json +1 -1
- package/dist/registry/vue/form.json +1 -1
- package/dist/registry/vue/icon-shared.json +1 -1
- package/dist/registry/vue/input.json +1 -1
- package/dist/registry/vue/label.json +1 -1
- package/dist/registry/vue/month-picker.json +1 -1
- package/dist/registry/vue/number-input.json +1 -1
- package/dist/registry/vue/overlay-shared.json +7 -1
- package/dist/registry/vue/password-input.json +1 -1
- package/dist/registry/vue/pin-input.json +1 -1
- package/dist/registry/vue/popconfirm.json +1 -1
- package/dist/registry/vue/popover.json +1 -1
- package/dist/registry/vue/progress.json +1 -1
- package/dist/registry/vue/provider.json +2 -2
- package/dist/registry/vue/radio-group.json +1 -1
- package/dist/registry/vue/registry.json +53 -53
- package/dist/registry/vue/select.json +1 -1
- package/dist/registry/vue/separator.json +1 -1
- package/dist/registry/vue/skeleton.json +1 -1
- package/dist/registry/vue/slider.json +1 -1
- package/dist/registry/vue/slot.json +1 -1
- package/dist/registry/vue/spin.json +1 -1
- package/dist/registry/vue/switch.json +1 -1
- package/dist/registry/vue/table-render.json +1 -1
- package/dist/registry/vue/tabs.json +1 -1
- package/dist/registry/vue/textarea.json +1 -1
- package/dist/registry/vue/timeline.json +1 -1
- package/dist/registry/vue/toast.json +3 -3
- package/dist/registry/vue/tokens.json +1 -1
- package/dist/registry/vue/tooltip.json +1 -1
- package/dist/registry/vue/tree-select.json +1 -1
- package/dist/registry/vue/tree-shared.json +1 -1
- package/dist/registry/vue/utils.json +1 -1
- package/dist/registry/vue/week-picker.json +1 -1
- package/dist/registry/vue/year-picker.json +1 -1
- package/dist/style.css +21 -0
- package/package.json +1 -1
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
|
|
3
3
|
"name": "icon-shared",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.14",
|
|
5
5
|
"type": "registry:ui",
|
|
6
6
|
"description": "内置功能性图标(CloseIcon/ChevronIcon/CalendarIcon/GripIcon),内部共享,非公共 API。图标组件零默认类:尺寸/旋转/过渡类由使用处显式传入,避免 fallthrough 拼接时同名工具类排序冲突。",
|
|
7
7
|
"files": [
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
|
|
3
3
|
"name": "month-picker",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.14",
|
|
5
5
|
"type": "registry:ui",
|
|
6
6
|
"description": "月份选择器:输入框 + 锁定月视图的日历弹层,值以 \"yyyy-MM\" 字符串受控,min/max 为月粒度闭区间(内部换算到当月末日)。",
|
|
7
7
|
"registryDependencies": ["utils", "date-shared", "calendar"],
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
|
|
3
3
|
"name": "number-input",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.14",
|
|
5
5
|
"type": "registry:ui",
|
|
6
6
|
"description": "数字输入框:内置加减步进按钮与数值边界,值以 number|null 受控(空值归一 null),支持 Intl 数字格式化。",
|
|
7
7
|
"registryDependencies": ["utils"],
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
|
|
3
3
|
"name": "overlay-shared",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.14",
|
|
5
5
|
"type": "registry:ui",
|
|
6
6
|
"description": "弹层家族共享逻辑:受控开合桥接(useControlledBoolean)与确认 pending 语义(useConfirmPending)。",
|
|
7
7
|
"files": [
|
|
@@ -11,6 +11,12 @@
|
|
|
11
11
|
"target": "components/ui/overlay-shared/config.ts",
|
|
12
12
|
"content": "import type { InjectionKey } from \"vue\";\nimport { inject } from \"vue\";\nimport { isInIframeRealm, isInWujie } from \"./sandbox\";\n\n/**\n * TuDesignProvider 应用级显式配置层(plan: tu-design-provider-mode)。\n *\n * 动机:自动探测(marker / realm / 结构信号)存在固有边界——marker 随 wujie 版本漂移、\n * degrade 模式无法区分、故障静默。本模块新增手动声明层,解析优先级:\n * 组件显式 prop(to / positioning.strategy 等,已有) > Provider mode(本模块) > 自动探测(auto 缺省)。\n *\n * mode 语义 = 「隔离构成」行为组,判据是拓扑而非框架品牌(机制详注见 sandbox.ts 头注):\n * - none = { } // 独立运行 / qiankun / micro-app lightDOM / 纯 iframe 嵌入 / wujie degrade\n * - shadow = { teleport降级 } // micro-app strictStyleIsolation / web component\n * - shadow-iframe = { teleport降级, fixed策略, 锁禁用 } // wujie 默认模式(iframe realm + shadow graft 双重隔离)\n * - auto(缺省) = 现行探测链,行为与历史版本逐字节一致\n *\n * 纪律:\n * - 显式 mode 一律短路,不进入任何探测代码(marker 漂移免疫的可证性质);\n * - mode 只表达渲染环境单维度;新的根部能力走 Provider 命名空间对象 prop(present = enabled),\n * 且每个 prop 必须注明 mount-time / reactive(缺省 mount-time);\n * - `none` 是「显式关全部适配」,不保证与 auto 逐位等值(如纯 iframe 下 auto 会注入无害 fixed)。\n */\n\n/** 渲染环境声明(行为组名,非框架名) */\nexport type TuProviderMode = \"auto\" | \"none\" | \"shadow\" | \"shadow-iframe\";\n\n/** Provider 注入的配置快照(mount-time 消费;动态变更用 :key 重挂载) */\nexport interface TuProviderConfig {\n mode: TuProviderMode;\n /**\n * overlay 命名空间 prop(present = enabled,mount-time;issue #5)。\n * 可选键:既有 provide({ mode }) 字面量与 DEFAULT_CONFIG 不受影响。\n */\n overlay?: TuOverlayContract;\n}\n\n/** provide/inject 契约键(沿逻辑树传递,Teleport 子树同样命中) */\nexport const TU_PROVIDER_KEY: InjectionKey<TuProviderConfig> = Symbol(\"tu-provider\");\n\nconst DEFAULT_CONFIG: TuProviderConfig = { mode: \"auto\" };\n\n/**\n * 读取应用级配置;无 Provider 时缺省 auto(= 未引入本特性前的行为,向后兼容兜底)。\n * 须在 setup 顶层调用(inject 约束)。\n * @returns 最近 Provider 的配置快照,或 { mode: \"auto\" }\n */\nexport function useTuProvider(): TuProviderConfig {\n return inject(TU_PROVIDER_KEY, DEFAULT_CONFIG);\n}\n\n/**\n * Teleport 目标降级判定:shadow / shadow-iframe → 降级到应用挂载容器;\n * none → 恒 body;auto → 现行 isInWujie 探测(结构 shadowRoot 信号在\n * useSandboxTeleportTarget 内与本结果 OR,仅 auto 分支参与)。\n * @param mode 环境声明\n * @returns 是否强制降级(显式 mode 下不执行任何探测)\n */\nexport function teleportDegrade(mode: TuProviderMode): boolean {\n switch (mode) {\n case \"none\":\n return false;\n case \"shadow\":\n case \"shadow-iframe\":\n return true;\n case \"auto\":\n return isInWujie();\n }\n}\n\n/**\n * positioning.strategy 缺省 fixed 判定:仅 shadow-iframe(iframe realm + graft 坐标错位)\n * 与 auto 的 isInIframeRealm 探测注入;用户显式 strategy 的优先级在调用方\n * (withSandboxStrategy)先行短路。\n * @param mode 环境声明\n * @returns 用户未指定 strategy 时是否注入 fixed\n */\nexport function strategyFixed(mode: TuProviderMode): boolean {\n switch (mode) {\n case \"none\":\n case \"shadow\":\n return false;\n case \"shadow-iframe\":\n return true;\n case \"auto\":\n return isInIframeRealm();\n }\n}\n\n/**\n * 模态滚动锁策略:shadow-iframe → false(禁用,issue #4 的 graft 坐标系误补偿);\n * none / shadow → undefined(交还 Ark preventScroll=modal 派生默认);\n * auto → 现行 isInWujie ? false : undefined。\n * 传硬编码 true 永远禁止——attrs 透传 :modal=false 的既有用法会被强加滚动锁(行为回归)。\n * @param mode 环境声明\n * @returns false=显式禁用;undefined=不覆盖 Ark 缺省\n */\nexport function preventScrollOverride(mode: TuProviderMode): boolean | undefined {\n switch (mode) {\n case \"none\":\n case \"shadow\":\n return undefined;\n case \"shadow-iframe\":\n return false;\n case \"auto\":\n return isInWujie() ? false : undefined;\n }\n}\n\n/**\n * overlay 滚动锁契约(issue #5):消费方提供 lock() → 解锁函数,\n * 契约层只负责「是否消费」的拓扑判定,不包装、不持有状态。\n */\nexport interface TuOverlayContract {\n lock(): VoidFunction;\n}\n\n/**\n * overlay 契约消费判定(语义 B:仅锁禁用拓扑消费,issue #5)。\n * overlay 命名空间 prop present = enabled,mount-time 消费;\n * 仅当 preventScrollOverride(mode) === false(shadow-iframe 显式 / auto 探测命中 wujie)\n * 时透传契约引用,其余拓扑(none / shadow / auto 非 wujie / 未提供 overlay)一律 null。\n * 显式 mode 短路探测的性质由 preventScrollOverride 继承(marker 漂移免疫)。\n * @param config Provider 配置快照\n * @returns 锁禁用拓扑下为 config.overlay 同引用,否则 null\n */\nexport function overlayContract(config: TuProviderConfig): TuOverlayContract | null {\n return config.overlay && preventScrollOverride(config.mode) === false ? config.overlay : null;\n}\n"
|
|
13
13
|
},
|
|
14
|
+
{
|
|
15
|
+
"path": "overlay-shared/rafClock.ts",
|
|
16
|
+
"type": "registry:lib",
|
|
17
|
+
"target": "components/ui/overlay-shared/rafClock.ts",
|
|
18
|
+
"content": "/**\n * rAF 时钟守卫——「沙箱时钟混用」家族修复(issue #6)。\n *\n * 机制链(wujie 2.1.0 真机实证):\n * 1. wujie `windowRegWhiteList` 含 `/animationFrame$/i`,patchWindowEffect 把子应用\n * iframe window 的 `requestAnimationFrame` 替换为宿主 rAF 的 bind 包装(own\n * property,name 为 \"bound requestAnimationFrame\");`performance` 不在白名单,\n * 保持 iframe 本地 → 子应用内两时钟分属两条时间线,偏移 = 宿主加载→子应用\n * 打开间隔(秒~分钟级);\n * 2. `@zag-js/utils` 的 Timer(1.47.0/1.48.0 同构)混用两时钟:`start()` 取\n * `performance.now()`(本地),`tick()` 取 rAF 回调时间戳(宿主)→\n * `deltaMs ≈ 偏移 ≫ duration`,有限时长 toast 首 tick 即 DISMISS;\n * loading/duration:Infinity 走 shouldPersist 直通不启计时器,故完全正常\n * (与真机差分症状逐条吻合);\n * 3. 同族消费方:@zag-js/toast / clipboard / splitter / timer 四个机器,\n * 单点修复(本守卫)全部覆盖;\n * 4. 注:现代 Chrome 对「原始」同源 iframe 的 rAF 时间戳按 document 自身\n * timeOrigin 相对化(whatwg/html#9823 后的规范),普通 iframe 嵌入无此 bug\n * ——守卫 therefore 必须按运行时哨兵门控,不能按拓扑 mode 门控(否则普通\n * iframe 下反而注入 duration+偏移 的反向 bug,真机实证 3000ms → 7044ms)。\n *\n * 归一化形态:回调时间戳整体改传本地 `performance.now()`(上游单时钟方案的\n * 应用层同构),不做 timeOrigin 偏移算术——不访问 `window.parent`,跨域沙箱\n * 免疫,无符号错误面;误差预算 ≤1 帧(zag Timer 仅做 `deltaMs >= delay`\n * 比较,不依赖同帧同值,影响可忽略)。\n *\n * 门控:哨兵 = 安装后首个 rAF 回调测 `|ts − performance.now()|`;正常环境帧内\n * 抖动 ≤16ms,阈值 100ms(≈6 帧)零误伤。zag 上游修复(tick 单时钟)落地后,\n * 哨兵测得漂移≈0,守卫自动休眠——可与上游修复安全共存,无需回改本文件。\n *\n * 时序:同步安装包装(setup 顶层调用,零空窗)→ 主动排一帧空回调做哨兵 →\n * 裁决:干净则恢复全局原引用(已排队的 in-flight 回调仍经包装无害放行),\n * 漂移则保持武装。裁决前(首帧内)回调原样放行(= 原生行为)。\n *\n * 已知边界:\n * - wujie 同白名单替换了 cancelAnimationFrame,宿主 rAF id 配宿主 cancel,\n * 链路自洽;「只换 rAF 不换 cancel」的沙箱 frameId 会失配,属该沙箱自身缺陷;\n * - `mode: \"none\"` 不安装(语义 B「显式关全部适配」,与 config.ts 纪律一致),\n * 该拓扑下若仍存在时钟混用由应用自担;\n * - 哨兵仅在安装时测量一次;偏移在 iframe 创建即固定(timeOrigin 差),\n * 会话内恒定,无需复测。\n */\n\n/** 哨兵漂移阈值(ms):正常环境 rAF ts 与 performance.now() 同帧差 ≤1 帧(~16ms),留 6 帧余量 */\nexport const RAF_DRIFT_THRESHOLD_MS = 100;\n\n/** 守卫裁决结果句柄 */\nexport interface RafClockGuardHandle {\n /** 哨兵是否命中(安装归一化);裁决前为 false */\n readonly installed: boolean;\n /** 哨兵测量值 |ts − performance.now()|(ms);裁决前为 NaN */\n readonly driftMs: number;\n /** 还原全局 rAF 引用(测试/热更新用);in-flight 已排队回调仍经包装放行 */\n restore(): void;\n}\n\n/** 守卫所需的最小 window 结构(DI 入参,测试用假窗口即可满足) */\nexport interface ClockWindow {\n requestAnimationFrame: (cb: (ts: number) => void) => number;\n performance: { now(): number };\n}\n\n/** 全局幂等标记:Symbol.for 注册表键,抗 HMR 模块重载(同键恒等) */\nconst GUARD_FLAG = Symbol.for(\"tu-design.raf-clock-guard\");\n\ntype FlaggedClockWindow = ClockWindow & Record<PropertyKey, unknown>;\n\nconst NOOP_HANDLE: RafClockGuardHandle = Object.freeze({\n installed: false,\n driftMs: Number.NaN,\n restore: () => {},\n});\n\n/**\n * 安装 rAF 时钟守卫(幂等;同步包装、异步哨兵裁决)。\n *\n * 接线点:TuDesignProvider / ToastProvider setup 顶层(mode=\"none\" 跳过)。\n * 任意环境可安全调用——干净时间线首帧即自恢复,零残留。\n *\n * @param win 宿主窗口(DI 入参;缺省全局 window,SSR 环境返回 no-op)\n * @returns 哨兵裁决后的句柄(幂等重入时返回已存在句柄的裁决)\n */\nexport function ensureRafClockGuard(win?: ClockWindow): Promise<RafClockGuardHandle> {\n const target: ClockWindow | undefined =\n win ?? (typeof window !== \"undefined\" ? window : undefined);\n // SSR / 非浏览器环境:无时钟可守\n if (!target) return Promise.resolve(NOOP_HANDLE);\n\n const w = target as FlaggedClockWindow;\n const existing = w[GUARD_FLAG] as RafClockGuardHandle | undefined;\n if (existing) return Promise.resolve(existing);\n\n // 原引用必须先于 bind 捕获:restore() 要求还原到 === 相等的原始值\n const rawRef = w.requestAnimationFrame;\n const rawRaf = rawRef.bind(w);\n const perf = w.performance;\n\n let state: \"probing\" | \"armed\" | \"clean\" = \"probing\";\n let driftMs = Number.NaN;\n let resolveDecision!: (handle: RafClockGuardHandle) => void;\n\n const wrapper = (cb: (ts: number) => void): number => {\n return rawRaf((ts) => {\n if (state === \"probing\") {\n driftMs = Math.round(Math.abs(ts - perf.now()));\n state = driftMs >= RAF_DRIFT_THRESHOLD_MS ? \"armed\" : \"clean\";\n if (state === \"clean\") {\n // 干净时间线:恢复全局原引用(本包装仅剩 in-flight 排队回调,放行语义不变)\n w.requestAnimationFrame = rawRef;\n } else if (import.meta.env.DEV) {\n console.info(\n `[tu-design] 检测到 rAF 时间线漂移 ${driftMs}ms(沙箱 rAF/performance ` +\n \"时钟混用),已安装时钟归一化守卫,回调时间戳改传本地 performance.now()。\" +\n \"机制详注 overlay-shared/rafClock.ts(issue #6)。\",\n );\n }\n resolveDecision(handle);\n }\n // 裁决前原样放行(= 原生行为);武装后改传本地时钟;干净后原样\n cb(state === \"armed\" ? perf.now() : ts);\n });\n };\n\n const handle: RafClockGuardHandle = {\n get installed() {\n return state === \"armed\";\n },\n get driftMs() {\n return driftMs;\n },\n restore() {\n w.requestAnimationFrame = rawRef;\n },\n };\n\n // 同步注册幂等标记(先于任何 await,双调用零窗口)\n w[GUARD_FLAG] = handle;\n // 同步包装全局引用:此后所有 rAF 消费方(zag Timer 等)经守卫解析\n w.requestAnimationFrame = wrapper;\n // 主动排一帧哨兵:裁决在首个真实消费计时器之前完成(~16ms)\n wrapper(() => {});\n\n return new Promise<RafClockGuardHandle>((resolve) => {\n resolveDecision = resolve;\n });\n}\n"
|
|
19
|
+
},
|
|
14
20
|
{
|
|
15
21
|
"path": "overlay-shared/sandbox.ts",
|
|
16
22
|
"type": "registry:lib",
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
|
|
3
3
|
"name": "password-input",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.14",
|
|
5
5
|
"type": "registry:ui",
|
|
6
6
|
"description": "密码输入框:内置明文/掩码切换按钮(Eye/EyeOff,带 aria 语义),值与可见性均支持 v-model 受控。",
|
|
7
7
|
"registryDependencies": ["utils"],
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
|
|
3
3
|
"name": "pin-input",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.14",
|
|
5
5
|
"type": "registry:ui",
|
|
6
6
|
"description": "多格验证码输入:length 指定格数,支持 otp/mask/字符类型、焦点自动跳格与填满回调,可选分隔符插槽。",
|
|
7
7
|
"registryDependencies": ["utils"],
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
|
|
3
3
|
"name": "popconfirm",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.14",
|
|
5
5
|
"type": "registry:ui",
|
|
6
6
|
"description": "气泡确认:Popover 薄壳变体单组件,默认插槽为触发元素本体(asChild),title/description 传文案,@confirm/@cancel 处理确认与取消;确认处理器返回 Promise 时确认钮 loading 并锁定关闭通道,resolve 自动关闭、reject 保持打开。",
|
|
7
7
|
"registryDependencies": ["utils", "popover", "button", "overlay-shared"],
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
|
|
3
3
|
"name": "popover",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.14",
|
|
5
5
|
"type": "registry:ui",
|
|
6
6
|
"description": "气泡弹层:基于 Ark UI Popover 原语的单组件,默认插槽为触发元素本体(asChild 语义),面板内容放 #content 插槽,受控/非受控开关。",
|
|
7
7
|
"registryDependencies": ["utils", "overlay-shared"],
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
|
|
3
3
|
"name": "provider",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.14",
|
|
5
5
|
"type": "registry:ui",
|
|
6
6
|
"description": "应用根组件(可选):mode 显式声明微前端渲染环境(覆盖浮层沙箱自动探测),:toast 聚合消息提示宿主;不使用时一切行为与自动探测一致。",
|
|
7
7
|
"registryDependencies": ["overlay-shared", "toast"],
|
|
@@ -10,7 +10,7 @@
|
|
|
10
10
|
"path": "provider/TuDesignProvider.vue",
|
|
11
11
|
"type": "registry:component",
|
|
12
12
|
"target": "components/ui/provider/TuDesignProvider.vue",
|
|
13
|
-
"content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { provide } from \"vue\";\nimport { preventScrollOverride, TU_PROVIDER_KEY } from \"../overlay-shared/config\";\nimport type { TuOverlayContract, TuProviderMode } from \"../overlay-shared/config\";\nimport { ToastProvider } from \"../toast\";\nimport type { TuToastConfig } from \"./types\";\n\n/**\n * 应用根组件(可选层):微前端环境显式声明 + 根部能力聚合。\n *\n * 1. `mode`:声明渲染环境,覆盖浮层组件的自动沙箱探测(Teleport 降级 /\n * 定位策略 / 模态滚动锁)。解析优先级:组件显式 prop > 本 mode > 自动探测。\n * 行为组语义与框架映射表见文档「微前端与沙箱 · 手动声明运行环境」。\n * 不挂载本组件或不传 mode 时,一切行为与自动探测现行版本完全一致。\n * 2. `:toast`:消息提示宿主(组合渲染 ToastProvider,present = enabled);\n * 与独立挂载 ToastProvider 二选一,双挂载 dev 告警。\n * 3. `:overlay`:滚动锁契约(present = enabled,语义 B:仅锁禁用拓扑生效);\n * 经 provide 快照透传,消费判定见 overlayContract()。非锁禁用拓扑下 dev 告警。\n *\n *
|
|
13
|
+
"content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { provide } from \"vue\";\nimport { preventScrollOverride, TU_PROVIDER_KEY } from \"../overlay-shared/config\";\nimport type { TuOverlayContract, TuProviderMode } from \"../overlay-shared/config\";\nimport { ensureRafClockGuard } from \"../overlay-shared/rafClock\";\nimport { ToastProvider } from \"../toast\";\nimport type { TuToastConfig } from \"./types\";\n\n/**\n * 应用根组件(可选层):微前端环境显式声明 + 根部能力聚合。\n *\n * 1. `mode`:声明渲染环境,覆盖浮层组件的自动沙箱探测(Teleport 降级 /\n * 定位策略 / 模态滚动锁)。解析优先级:组件显式 prop > 本 mode > 自动探测。\n * 行为组语义与框架映射表见文档「微前端与沙箱 · 手动声明运行环境」。\n * 不挂载本组件或不传 mode 时,一切行为与自动探测现行版本完全一致。\n * 2. `:toast`:消息提示宿主(组合渲染 ToastProvider,present = enabled);\n * 与独立挂载 ToastProvider 二选一,双挂载 dev 告警。\n * 3. `:overlay`:滚动锁契约(present = enabled,语义 B:仅锁禁用拓扑生效);\n * 经 provide 快照透传,消费判定见 overlayContract()。非锁禁用拓扑下 dev 告警。\n * 4. rAF 时钟守卫(无 prop,哨兵自动):沙箱时钟混用家族修复(issue #6,\n * 机制详注 overlay-shared/rafClock.ts);mode=\"none\" 显式关闭,其余 mode\n * 哨兵命中才安装(幂等,干净环境首帧自恢复零残留)。\n *\n * 四者均为 mount-time 契约(provide 快照 / ToastProvider 挂载时消费),\n * 动态变更用 :key 重挂载。须包住子应用根(inject 沿逻辑树,Teleport 子树同样命中;\n * 组件挂载在 Provider 子树之外时回落 auto 兜底)。\n */\ndefineOptions({ inheritAttrs: false });\n\nconst props = defineProps({\n /** 渲染环境声明(行为组名,非框架名);缺省 auto = 现行探测链 */\n mode: { type: String as PropType<TuProviderMode>, default: \"auto\" },\n /** 消息提示宿主配置:未传不渲染 Toaster;传 {} 全走缺省 */\n toast: { type: Object as PropType<TuToastConfig>, default: undefined },\n /** overlay 滚动锁契约(present = enabled):仅锁禁用拓扑消费(语义 B),mount-time */\n overlay: { type: Object as PropType<TuOverlayContract>, default: undefined },\n});\n\n// mount-time 快照:mode / overlay 变更不响应(契约见组件头注)\nprovide(TU_PROVIDER_KEY, { mode: props.mode, overlay: props.overlay });\n\n// rAF 时钟守卫(setup 顶层同步安装,零空窗——toast/clipboard 等 zag rAF 计时\n// 全部发生在用户交互,恒晚于根挂载):mode=\"none\" 显式关闭,其余哨兵门控\nif (props.mode !== \"none\") void ensureRafClockGuard();\n\n// dev 告警(每次 mount 一次,setup 顶层求值;auto 探测时机已探针实证):\n// 语义 B——overlay 契约仅锁禁用拓扑生效,其余拓扑传入即静默不消费,须显式提示\nif (import.meta.env.DEV && props.overlay && preventScrollOverride(props.mode) !== false) {\n console.warn(\n \"[tu-design] TuDesignProvider :overlay 仅锁禁用拓扑生效(语义 B):当前 mode 下滚动锁未被禁用,overlay 契约不会被消费。\",\n );\n}\n</script>\n\n<template>\n <!-- present = enabled::toast 传入即挂载消息宿主(组合复用 ToastProvider,零复制) -->\n <ToastProvider v-if=\"props.toast\" v-bind=\"props.toast\" />\n <slot />\n</template>\n"
|
|
14
14
|
},
|
|
15
15
|
{
|
|
16
16
|
"path": "provider/index.ts",
|
|
@@ -4,371 +4,371 @@
|
|
|
4
4
|
"items": [
|
|
5
5
|
{
|
|
6
6
|
"name": "alert",
|
|
7
|
-
"version": "0.5.
|
|
7
|
+
"version": "0.5.14",
|
|
8
8
|
"title": "Alert",
|
|
9
9
|
"type": "registry:ui",
|
|
10
10
|
"description": "语义化警示条,支持五种变体、内置图标与可关闭交互。"
|
|
11
11
|
},
|
|
12
12
|
{
|
|
13
13
|
"name": "alert-dialog",
|
|
14
|
-
"version": "0.5.
|
|
14
|
+
"version": "0.5.14",
|
|
15
15
|
"title": "AlertDialog",
|
|
16
16
|
"type": "registry:ui",
|
|
17
17
|
"description": "确认弹窗单组件:v-model:open 控制显隐,title/description 传文案,@confirm/@cancel 处理确认与取消;确认处理器返回 Promise 时按钮进入 loading 并锁定 ESC/遮罩关闭,resolve 自动关闭、reject 保持打开;内容节点为 role=alertdialog。"
|
|
18
18
|
},
|
|
19
19
|
{
|
|
20
20
|
"name": "avatar",
|
|
21
|
-
"version": "0.5.
|
|
21
|
+
"version": "0.5.14",
|
|
22
22
|
"title": "Avatar",
|
|
23
23
|
"type": "registry:ui",
|
|
24
24
|
"description": "头像,支持尺寸/形状、加载占位与失败回退(Ark UI)。"
|
|
25
25
|
},
|
|
26
26
|
{
|
|
27
27
|
"name": "avatar-group",
|
|
28
|
-
"version": "0.5.
|
|
28
|
+
"version": "0.5.14",
|
|
29
29
|
"title": "AvatarGroup",
|
|
30
30
|
"type": "registry:ui",
|
|
31
31
|
"description": "头像组,数量折叠、悬停展开与垂直排列。"
|
|
32
32
|
},
|
|
33
33
|
{
|
|
34
34
|
"name": "badge",
|
|
35
|
-
"version": "0.5.
|
|
35
|
+
"version": "0.5.14",
|
|
36
36
|
"title": "Badge",
|
|
37
37
|
"type": "registry:ui",
|
|
38
38
|
"description": "轻量状态徽标,支持四种变体。"
|
|
39
39
|
},
|
|
40
40
|
{
|
|
41
41
|
"name": "button",
|
|
42
|
-
"version": "0.5.
|
|
42
|
+
"version": "0.5.14",
|
|
43
43
|
"title": "Button",
|
|
44
44
|
"type": "registry:ui",
|
|
45
45
|
"description": "带变体与尺寸的按钮,支持 as 标签切换与 asChild 组合。"
|
|
46
46
|
},
|
|
47
47
|
{
|
|
48
48
|
"name": "calendar",
|
|
49
|
-
"version": "0.5.
|
|
49
|
+
"version": "0.5.14",
|
|
50
50
|
"title": "Calendar",
|
|
51
51
|
"type": "registry:ui",
|
|
52
52
|
"description": "日历(TCalendar):紧凑日历卡。Picker 弹层内为 embedded 内嵌形态(TDatePicker/TDateRangePicker 自动挂靠,纯卡片内核);独立使用即 standalone 独立形态(自带日历状态与 v-model,恒开展示)。"
|
|
53
53
|
},
|
|
54
54
|
{
|
|
55
55
|
"name": "card",
|
|
56
|
-
"version": "0.5.
|
|
56
|
+
"version": "0.5.14",
|
|
57
57
|
"title": "Card",
|
|
58
58
|
"type": "registry:ui",
|
|
59
59
|
"description": "卡片容器:单组件 API,title/description 头部 + 命名插槽(cover/action/footer/header),支持尺寸、视觉变体、分段分隔与可关闭。"
|
|
60
60
|
},
|
|
61
61
|
{
|
|
62
62
|
"name": "cascader",
|
|
63
|
-
"version": "0.5.
|
|
63
|
+
"version": "0.5.14",
|
|
64
64
|
"title": "Cascader",
|
|
65
65
|
"type": "registry:ui",
|
|
66
66
|
"description": "级联选择:一站式 props 驱动,多列联动、勾选级联、路径回显与多标签。"
|
|
67
67
|
},
|
|
68
68
|
{
|
|
69
69
|
"name": "checkbox",
|
|
70
|
-
"version": "0.5.
|
|
70
|
+
"version": "0.5.14",
|
|
71
71
|
"title": "Checkbox",
|
|
72
72
|
"type": "registry:ui",
|
|
73
73
|
"description": "复选框:基于 Ark UI Checkbox 原语,支持标签插槽、受控/非受控与禁用。"
|
|
74
74
|
},
|
|
75
75
|
{
|
|
76
76
|
"name": "context-menu",
|
|
77
|
-
"version": "0.5.
|
|
77
|
+
"version": "0.5.14",
|
|
78
78
|
"title": "ContextMenu",
|
|
79
79
|
"type": "registry:ui",
|
|
80
80
|
"description": "右键菜单:单组件模式,items 描述菜单项(与 dropdown-menu 同构,含分组/标题/分隔线,支持嵌套),默认插槽为触发元素(ContextTrigger as-child,右键唤出并定位到指针处),内置键盘导航与选中回调。"
|
|
81
81
|
},
|
|
82
82
|
{
|
|
83
83
|
"name": "currency-input",
|
|
84
|
-
"version": "0.5.
|
|
84
|
+
"version": "0.5.14",
|
|
85
85
|
"title": "CurrencyInput",
|
|
86
86
|
"type": "registry:ui",
|
|
87
87
|
"description": "金额输入框:内置万/元/角/分单位后缀,labelUnit 输入单位与 valueUnit 存储单位自动换算(整数分最小精度),值以 number|null 受控。"
|
|
88
88
|
},
|
|
89
89
|
{
|
|
90
90
|
"name": "date-picker",
|
|
91
|
-
"version": "0.5.
|
|
91
|
+
"version": "0.5.14",
|
|
92
92
|
"title": "DatePicker",
|
|
93
93
|
"type": "registry:ui",
|
|
94
94
|
"description": "日期选择器:输入框 + 日历弹层(月/年视图切换),支持手动键入/清空/min-max 边界/不可选谓词,值以 \"yyyy-MM-dd\" 字符串受控。"
|
|
95
95
|
},
|
|
96
96
|
{
|
|
97
97
|
"name": "date-range-picker",
|
|
98
|
-
"version": "0.5.
|
|
98
|
+
"version": "0.5.14",
|
|
99
99
|
"title": "DateRangePicker",
|
|
100
100
|
"type": "registry:ui",
|
|
101
101
|
"description": "日期范围选择器:双月日历弹层(月/年视图切换),点选起点与终点,值以 [\"yyyy-MM-dd\", \"yyyy-MM-dd\"] 有序元组受控,空值归一 null。"
|
|
102
102
|
},
|
|
103
103
|
{
|
|
104
104
|
"name": "date-shared",
|
|
105
|
-
"version": "0.5.
|
|
105
|
+
"version": "0.5.14",
|
|
106
106
|
"title": "DateShared",
|
|
107
107
|
"type": "registry:ui",
|
|
108
108
|
"description": "日期家族共享模块:ISO 值域解析(日期/月/年/区间)、日历样式常量与单值选择器外壳(PickerShell/usePickerBridge)。"
|
|
109
109
|
},
|
|
110
110
|
{
|
|
111
111
|
"name": "dialog",
|
|
112
|
-
"version": "0.5.
|
|
112
|
+
"version": "0.5.14",
|
|
113
113
|
"title": "Dialog",
|
|
114
114
|
"type": "registry:ui",
|
|
115
115
|
"description": "模态对话框单组件:#trigger 放触发元素,title/description 传文案,#footer 注入 close 关闭;基于 Ark UI Dialog 原语,含焦点圈定、Escape/遮罩关闭与进出场动画,支持 v-model:open。"
|
|
116
116
|
},
|
|
117
117
|
{
|
|
118
118
|
"name": "drawer",
|
|
119
|
-
"version": "0.5.
|
|
119
|
+
"version": "0.5.14",
|
|
120
120
|
"title": "Drawer",
|
|
121
121
|
"type": "registry:ui",
|
|
122
122
|
"description": "抽屉单组件:从四方向滑出的侧边/顶底面板,#trigger 放触发元素,title/description 传文案,#footer 注入 close 关闭;基于 Ark UI Drawer 原语,进出场动画随 placement 方向自适应,含焦点圈定、Escape/遮罩关闭,支持 v-model:open。"
|
|
123
123
|
},
|
|
124
124
|
{
|
|
125
125
|
"name": "dropdown-menu",
|
|
126
|
-
"version": "0.5.
|
|
126
|
+
"version": "0.5.14",
|
|
127
127
|
"title": "DropdownMenu",
|
|
128
128
|
"type": "registry:ui",
|
|
129
129
|
"description": "下拉菜单:单组件模式,items 描述菜单项(含分组/标题/分隔线,支持嵌套),内置键盘导航与选中回调,默认插槽为触发元素(asChild 透传)。"
|
|
130
130
|
},
|
|
131
131
|
{
|
|
132
132
|
"name": "empty",
|
|
133
|
-
"version": "0.5.
|
|
133
|
+
"version": "0.5.14",
|
|
134
134
|
"title": "Empty",
|
|
135
135
|
"type": "registry:ui",
|
|
136
136
|
"description": "空状态占位,含默认插画与描述文案。"
|
|
137
137
|
},
|
|
138
138
|
{
|
|
139
139
|
"name": "form",
|
|
140
|
-
"version": "0.5.
|
|
140
|
+
"version": "0.5.14",
|
|
141
141
|
"title": "Form",
|
|
142
142
|
"type": "registry:ui",
|
|
143
143
|
"description": "表单状态与校验:基于 TanStack Form,配合 Valibot(Standard Schema)声明式校验,aria 自动接线。"
|
|
144
144
|
},
|
|
145
145
|
{
|
|
146
146
|
"name": "form-render",
|
|
147
|
-
"version": "0.5.
|
|
147
|
+
"version": "0.5.14",
|
|
148
148
|
"title": "FormRender",
|
|
149
149
|
"type": "registry:ui",
|
|
150
150
|
"description": "配置驱动表单渲染器:defineForm 聚合 TanStack Form 实例与字段配置,柯里化 widget DSL 声明控件,Tailwind 栅格自适应布局,复用 Form 家族 aria 接线。"
|
|
151
151
|
},
|
|
152
152
|
{
|
|
153
153
|
"name": "icon-shared",
|
|
154
|
-
"version": "0.5.
|
|
154
|
+
"version": "0.5.14",
|
|
155
155
|
"title": "IconShared",
|
|
156
156
|
"type": "registry:ui",
|
|
157
157
|
"description": "内置功能性图标(CloseIcon/ChevronIcon/CalendarIcon/GripIcon),内部共享,非公共 API。图标组件零默认类:尺寸/旋转/过渡类由使用处显式传入,避免 fallthrough 拼接时同名工具类排序冲突。"
|
|
158
158
|
},
|
|
159
159
|
{
|
|
160
160
|
"name": "input",
|
|
161
|
-
"version": "0.5.
|
|
161
|
+
"version": "0.5.14",
|
|
162
162
|
"title": "Input",
|
|
163
163
|
"type": "registry:ui",
|
|
164
164
|
"description": "文本输入框,支持 v-model、attrs 透传与 invalid 校验态。"
|
|
165
165
|
},
|
|
166
166
|
{
|
|
167
167
|
"name": "label",
|
|
168
|
-
"version": "0.5.
|
|
168
|
+
"version": "0.5.14",
|
|
169
169
|
"title": "Label",
|
|
170
170
|
"type": "registry:ui",
|
|
171
171
|
"description": "表单标签。"
|
|
172
172
|
},
|
|
173
173
|
{
|
|
174
174
|
"name": "month-picker",
|
|
175
|
-
"version": "0.5.
|
|
175
|
+
"version": "0.5.14",
|
|
176
176
|
"title": "MonthPicker",
|
|
177
177
|
"type": "registry:ui",
|
|
178
178
|
"description": "月份选择器:输入框 + 锁定月视图的日历弹层,值以 \"yyyy-MM\" 字符串受控,min/max 为月粒度闭区间(内部换算到当月末日)。"
|
|
179
179
|
},
|
|
180
180
|
{
|
|
181
181
|
"name": "number-input",
|
|
182
|
-
"version": "0.5.
|
|
182
|
+
"version": "0.5.14",
|
|
183
183
|
"title": "NumberInput",
|
|
184
184
|
"type": "registry:ui",
|
|
185
185
|
"description": "数字输入框:内置加减步进按钮与数值边界,值以 number|null 受控(空值归一 null),支持 Intl 数字格式化。"
|
|
186
186
|
},
|
|
187
187
|
{
|
|
188
188
|
"name": "overlay-shared",
|
|
189
|
-
"version": "0.5.
|
|
189
|
+
"version": "0.5.14",
|
|
190
190
|
"title": "OverlayShared",
|
|
191
191
|
"type": "registry:ui",
|
|
192
192
|
"description": "弹层家族共享逻辑:受控开合桥接(useControlledBoolean)与确认 pending 语义(useConfirmPending)。"
|
|
193
193
|
},
|
|
194
194
|
{
|
|
195
195
|
"name": "password-input",
|
|
196
|
-
"version": "0.5.
|
|
196
|
+
"version": "0.5.14",
|
|
197
197
|
"title": "PasswordInput",
|
|
198
198
|
"type": "registry:ui",
|
|
199
199
|
"description": "密码输入框:内置明文/掩码切换按钮(Eye/EyeOff,带 aria 语义),值与可见性均支持 v-model 受控。"
|
|
200
200
|
},
|
|
201
201
|
{
|
|
202
202
|
"name": "pin-input",
|
|
203
|
-
"version": "0.5.
|
|
203
|
+
"version": "0.5.14",
|
|
204
204
|
"title": "PinInput",
|
|
205
205
|
"type": "registry:ui",
|
|
206
206
|
"description": "多格验证码输入:length 指定格数,支持 otp/mask/字符类型、焦点自动跳格与填满回调,可选分隔符插槽。"
|
|
207
207
|
},
|
|
208
208
|
{
|
|
209
209
|
"name": "popconfirm",
|
|
210
|
-
"version": "0.5.
|
|
210
|
+
"version": "0.5.14",
|
|
211
211
|
"title": "Popconfirm",
|
|
212
212
|
"type": "registry:ui",
|
|
213
213
|
"description": "气泡确认:Popover 薄壳变体单组件,默认插槽为触发元素本体(asChild),title/description 传文案,@confirm/@cancel 处理确认与取消;确认处理器返回 Promise 时确认钮 loading 并锁定关闭通道,resolve 自动关闭、reject 保持打开。"
|
|
214
214
|
},
|
|
215
215
|
{
|
|
216
216
|
"name": "popover",
|
|
217
|
-
"version": "0.5.
|
|
217
|
+
"version": "0.5.14",
|
|
218
218
|
"title": "Popover",
|
|
219
219
|
"type": "registry:ui",
|
|
220
220
|
"description": "气泡弹层:基于 Ark UI Popover 原语的单组件,默认插槽为触发元素本体(asChild 语义),面板内容放 #content 插槽,受控/非受控开关。"
|
|
221
221
|
},
|
|
222
222
|
{
|
|
223
223
|
"name": "progress",
|
|
224
|
-
"version": "0.5.
|
|
224
|
+
"version": "0.5.14",
|
|
225
225
|
"title": "Progress",
|
|
226
226
|
"type": "registry:ui",
|
|
227
227
|
"description": "进度条:基于 Ark UI Progress 原语,支持语义色、标签与百分比显示、不确定态。"
|
|
228
228
|
},
|
|
229
229
|
{
|
|
230
230
|
"name": "provider",
|
|
231
|
-
"version": "0.5.
|
|
231
|
+
"version": "0.5.14",
|
|
232
232
|
"title": "Provider",
|
|
233
233
|
"type": "registry:ui",
|
|
234
234
|
"description": "应用根组件(可选):mode 显式声明微前端渲染环境(覆盖浮层沙箱自动探测),:toast 聚合消息提示宿主;不使用时一切行为与自动探测一致。"
|
|
235
235
|
},
|
|
236
236
|
{
|
|
237
237
|
"name": "radio-group",
|
|
238
|
-
"version": "0.5.
|
|
238
|
+
"version": "0.5.14",
|
|
239
239
|
"title": "RadioGroup",
|
|
240
240
|
"type": "registry:ui",
|
|
241
241
|
"description": "单选组:基于 Ark UI Radio Group 原语,键盘导航与受控/非受控双模式。"
|
|
242
242
|
},
|
|
243
243
|
{
|
|
244
244
|
"name": "select",
|
|
245
|
-
"version": "0.5.
|
|
245
|
+
"version": "0.5.14",
|
|
246
246
|
"title": "Select",
|
|
247
247
|
"type": "registry:ui",
|
|
248
248
|
"description": "下拉选择框:单组件 API,传入 items 数据驱动渲染,内置触发器回显、键盘导航与勾选指示,支持 #item 插槽自定义选项。"
|
|
249
249
|
},
|
|
250
250
|
{
|
|
251
251
|
"name": "separator",
|
|
252
|
-
"version": "0.5.
|
|
252
|
+
"version": "0.5.14",
|
|
253
253
|
"title": "Separator",
|
|
254
254
|
"type": "registry:ui",
|
|
255
255
|
"description": "分隔线,支持水平与垂直方向。"
|
|
256
256
|
},
|
|
257
257
|
{
|
|
258
258
|
"name": "skeleton",
|
|
259
|
-
"version": "0.5.
|
|
259
|
+
"version": "0.5.14",
|
|
260
260
|
"title": "Skeleton",
|
|
261
261
|
"type": "registry:ui",
|
|
262
262
|
"description": "加载占位骨架屏。"
|
|
263
263
|
},
|
|
264
264
|
{
|
|
265
265
|
"name": "slider",
|
|
266
|
-
"version": "0.5.
|
|
266
|
+
"version": "0.5.14",
|
|
267
267
|
"title": "Slider",
|
|
268
268
|
"type": "registry:ui",
|
|
269
269
|
"description": "滑块:基于 Ark UI Slider 原语,支持单值/区间、步进与键盘微调。"
|
|
270
270
|
},
|
|
271
271
|
{
|
|
272
272
|
"name": "slot",
|
|
273
|
-
"version": "0.5.
|
|
273
|
+
"version": "0.5.14",
|
|
274
274
|
"title": "Slot",
|
|
275
275
|
"type": "registry:ui",
|
|
276
276
|
"description": "asChild 组合原语:将组件的 class 与 attrs 合并到子元素上,而不渲染额外 DOM。"
|
|
277
277
|
},
|
|
278
278
|
{
|
|
279
279
|
"name": "spin",
|
|
280
|
-
"version": "0.5.
|
|
280
|
+
"version": "0.5.14",
|
|
281
281
|
"title": "Spin",
|
|
282
282
|
"type": "registry:ui",
|
|
283
283
|
"description": "加载中旋转指示器,支持独立 spinner 与包裹内容(半透明遮罩)两种形态。"
|
|
284
284
|
},
|
|
285
285
|
{
|
|
286
286
|
"name": "switch",
|
|
287
|
-
"version": "0.5.
|
|
287
|
+
"version": "0.5.14",
|
|
288
288
|
"title": "Switch",
|
|
289
289
|
"type": "registry:ui",
|
|
290
290
|
"description": "开关:基于 Ark UI Switch 原语,支持标签插槽、受控/非受控与禁用。"
|
|
291
291
|
},
|
|
292
292
|
{
|
|
293
293
|
"name": "table-render",
|
|
294
|
-
"version": "0.5.
|
|
294
|
+
"version": "0.5.14",
|
|
295
295
|
"title": "TableRender",
|
|
296
296
|
"type": "registry:ui",
|
|
297
297
|
"description": "配置驱动表格渲染器:defineTable 聚合 TanStack Table 实例与列配置,静态/服务端双模式(onLoad 回写分页排序),搜索表单联动(search 接 FormRender),左右固定列 sticky 横向滚动,表体虚拟滚动(virtual + height,TanStack Virtual 动态测量行高),树形数据(tree:子行展开/收起、depth 缩进、caret 位于首列),行拖拽排序(draggable:把手列页内 DnD + drag-sort 事件,静态模式引擎先行重排、服务端模式只发事件;与 tree/virtual 互斥,排序激活/rowKey 缺失时把手置灰),列显隐(columnSettings 面板 + visibleKeys 受控,面板树形三态),表头分组(任意层级多级表头,分组列/固定列/多行 sticky 全兼容),错误态占位与重试(#error 插槽 + load-error),ellipsis 支持 tooltip 形态,v-model 受控(pageIndex/pageSize/sort/selectedKeys),Ark Pagination 分页条 + 原生 select 每页条数,排序表头 aria-sort、加载骨架与空态插槽,语义化 table + Tailwind tokens。"
|
|
298
298
|
},
|
|
299
299
|
{
|
|
300
300
|
"name": "tabs",
|
|
301
|
-
"version": "0.5.
|
|
301
|
+
"version": "0.5.14",
|
|
302
302
|
"title": "Tabs",
|
|
303
303
|
"type": "registry:ui",
|
|
304
304
|
"description": "选项卡:基于 Ark UI Tabs 原语,键盘导航与受控/非受控双模式。"
|
|
305
305
|
},
|
|
306
306
|
{
|
|
307
307
|
"name": "textarea",
|
|
308
|
-
"version": "0.5.
|
|
308
|
+
"version": "0.5.14",
|
|
309
309
|
"title": "Textarea",
|
|
310
310
|
"type": "registry:ui",
|
|
311
311
|
"description": "多行文本输入:纯样式封装,支持 invalid 校验态。"
|
|
312
312
|
},
|
|
313
313
|
{
|
|
314
314
|
"name": "timeline",
|
|
315
|
-
"version": "0.5.
|
|
315
|
+
"version": "0.5.14",
|
|
316
316
|
"title": "Timeline",
|
|
317
317
|
"type": "registry:ui",
|
|
318
318
|
"description": "时间轴:数据驱动 items 渲染竖向事件流,支持单列/左右交替、五种语义节点色与空心节点、#item 作用域插槽自定义内容。"
|
|
319
319
|
},
|
|
320
320
|
{
|
|
321
321
|
"name": "toast",
|
|
322
|
-
"version": "0.5.
|
|
322
|
+
"version": "0.5.14",
|
|
323
323
|
"title": "Toast",
|
|
324
324
|
"type": "registry:ui",
|
|
325
325
|
"description": "全局轻提示:ToastProvider 在应用根部挂载一次,useToast() 提供命令式 API(success/error/info/warning/loading/promise/dismiss);基于 Ark UI Toast 原语,语义 type 映射主题 token 配色。"
|
|
326
326
|
},
|
|
327
327
|
{
|
|
328
328
|
"name": "tokens",
|
|
329
|
-
"version": "0.5.
|
|
329
|
+
"version": "0.5.14",
|
|
330
330
|
"title": "Tokens",
|
|
331
331
|
"type": "registry:style",
|
|
332
332
|
"description": "Tailwind CSS v4 语义 tokens(shadcn 官方 v4 集合)。"
|
|
333
333
|
},
|
|
334
334
|
{
|
|
335
335
|
"name": "tooltip",
|
|
336
|
-
"version": "0.5.
|
|
336
|
+
"version": "0.5.14",
|
|
337
337
|
"title": "Tooltip",
|
|
338
338
|
"type": "registry:ui",
|
|
339
339
|
"description": "文字提示气泡:悬停触发,基于 Ark UI Tooltip 原语,支持 asChild 与延迟配置。"
|
|
340
340
|
},
|
|
341
341
|
{
|
|
342
342
|
"name": "tree-select",
|
|
343
|
-
"version": "0.5.
|
|
343
|
+
"version": "0.5.14",
|
|
344
344
|
"title": "TreeSelect",
|
|
345
345
|
"type": "registry:ui",
|
|
346
346
|
"description": "树形下拉选择:一站式 props 驱动,支持单/多选、勾选级联、过滤与多标签折叠。"
|
|
347
347
|
},
|
|
348
348
|
{
|
|
349
349
|
"name": "tree-shared",
|
|
350
|
-
"version": "0.5.
|
|
350
|
+
"version": "0.5.14",
|
|
351
351
|
"title": "TreeShared",
|
|
352
352
|
"type": "registry:ui",
|
|
353
353
|
"description": "树形数据层与共享类型(移植自 treemate v0.3.11,MIT)。"
|
|
354
354
|
},
|
|
355
355
|
{
|
|
356
356
|
"name": "utils",
|
|
357
|
-
"version": "0.5.
|
|
357
|
+
"version": "0.5.14",
|
|
358
358
|
"title": "Utils",
|
|
359
359
|
"type": "registry:lib",
|
|
360
360
|
"description": "cn 类名合并工具(clsx + tailwind-merge)。"
|
|
361
361
|
},
|
|
362
362
|
{
|
|
363
363
|
"name": "week-picker",
|
|
364
|
-
"version": "0.5.
|
|
364
|
+
"version": "0.5.14",
|
|
365
365
|
"title": "WeekPicker",
|
|
366
366
|
"type": "registry:ui",
|
|
367
367
|
"description": "周选择器:输入框 + 日历弹层,点任意可选日归一到所在周并整周高亮,值以 \"yyyy-MM-dd\"(所在周起始日)字符串受控;周起点跟随 locale(zh-CN 周一起始),输入框回显 \"start ~ end\"。"
|
|
368
368
|
},
|
|
369
369
|
{
|
|
370
370
|
"name": "year-picker",
|
|
371
|
-
"version": "0.5.
|
|
371
|
+
"version": "0.5.14",
|
|
372
372
|
"title": "YearPicker",
|
|
373
373
|
"type": "registry:ui",
|
|
374
374
|
"description": "年份选择器:输入框 + 锁定年视图的日历弹层(decade 网格),值以 \"yyyy\" 字符串受控,min/max 为年粒度闭区间。"
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
|
|
3
3
|
"name": "select",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.14",
|
|
5
5
|
"type": "registry:ui",
|
|
6
6
|
"description": "下拉选择框:单组件 API,传入 items 数据驱动渲染,内置触发器回显、键盘导航与勾选指示,支持 #item 插槽自定义选项。",
|
|
7
7
|
"registryDependencies": ["icon-shared", "utils", "overlay-shared"],
|