@tu-design/vue 0.5.11 → 0.5.12

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 (57) hide show
  1. package/dist/index.d.mts +45 -27
  2. package/dist/index.mjs +74 -5
  3. package/dist/registry/vue/alert-dialog.json +2 -2
  4. package/dist/registry/vue/alert.json +1 -1
  5. package/dist/registry/vue/avatar-group.json +1 -1
  6. package/dist/registry/vue/avatar.json +1 -1
  7. package/dist/registry/vue/badge.json +1 -1
  8. package/dist/registry/vue/button.json +1 -1
  9. package/dist/registry/vue/calendar.json +1 -1
  10. package/dist/registry/vue/card.json +1 -1
  11. package/dist/registry/vue/cascader.json +1 -1
  12. package/dist/registry/vue/checkbox.json +1 -1
  13. package/dist/registry/vue/context-menu.json +1 -1
  14. package/dist/registry/vue/currency-input.json +1 -1
  15. package/dist/registry/vue/date-picker.json +1 -1
  16. package/dist/registry/vue/date-range-picker.json +1 -1
  17. package/dist/registry/vue/date-shared.json +1 -1
  18. package/dist/registry/vue/dialog.json +2 -2
  19. package/dist/registry/vue/drawer.json +2 -2
  20. package/dist/registry/vue/dropdown-menu.json +1 -1
  21. package/dist/registry/vue/empty.json +1 -1
  22. package/dist/registry/vue/form-render.json +1 -1
  23. package/dist/registry/vue/form.json +1 -1
  24. package/dist/registry/vue/icon-shared.json +1 -1
  25. package/dist/registry/vue/input.json +1 -1
  26. package/dist/registry/vue/label.json +1 -1
  27. package/dist/registry/vue/month-picker.json +1 -1
  28. package/dist/registry/vue/number-input.json +1 -1
  29. package/dist/registry/vue/overlay-shared.json +8 -2
  30. package/dist/registry/vue/password-input.json +1 -1
  31. package/dist/registry/vue/pin-input.json +1 -1
  32. package/dist/registry/vue/popconfirm.json +1 -1
  33. package/dist/registry/vue/popover.json +1 -1
  34. package/dist/registry/vue/progress.json +1 -1
  35. package/dist/registry/vue/provider.json +2 -2
  36. package/dist/registry/vue/radio-group.json +1 -1
  37. package/dist/registry/vue/registry.json +53 -53
  38. package/dist/registry/vue/select.json +1 -1
  39. package/dist/registry/vue/separator.json +1 -1
  40. package/dist/registry/vue/skeleton.json +1 -1
  41. package/dist/registry/vue/slider.json +1 -1
  42. package/dist/registry/vue/slot.json +1 -1
  43. package/dist/registry/vue/spin.json +1 -1
  44. package/dist/registry/vue/switch.json +1 -1
  45. package/dist/registry/vue/table-render.json +1 -1
  46. package/dist/registry/vue/tabs.json +1 -1
  47. package/dist/registry/vue/textarea.json +1 -1
  48. package/dist/registry/vue/timeline.json +1 -1
  49. package/dist/registry/vue/toast.json +1 -1
  50. package/dist/registry/vue/tokens.json +1 -1
  51. package/dist/registry/vue/tooltip.json +1 -1
  52. package/dist/registry/vue/tree-select.json +1 -1
  53. package/dist/registry/vue/tree-shared.json +1 -1
  54. package/dist/registry/vue/utils.json +1 -1
  55. package/dist/registry/vue/week-picker.json +1 -1
  56. package/dist/registry/vue/year-picker.json +1 -1
  57. package/package.json +1 -1
package/dist/index.d.mts CHANGED
@@ -209,8 +209,8 @@ declare const __VLS_export$52: import("vue").DefineComponent<import("vue").Extra
209
209
  "onUpdate:modelValue"?: ((value: number | null) => any) | undefined;
210
210
  }>, {
211
211
  class: string;
212
- disabled: boolean | undefined;
213
212
  modelValue: number | null | undefined;
213
+ disabled: boolean | undefined;
214
214
  placeholder: string;
215
215
  invalid: boolean | undefined;
216
216
  labelUnit: CurrencyUnit;
@@ -379,18 +379,18 @@ declare const __VLS_export$51: import("vue").DefineComponent<import("vue").Extra
379
379
  }>, {
380
380
  class: string;
381
381
  max: string;
382
- disabled: boolean | undefined;
383
382
  modelValue: string | null | undefined;
384
383
  defaultValue: string;
384
+ min: string;
385
+ isDateUnavailable: (date: DateValue) => boolean;
386
+ locale: string;
387
+ disabled: boolean | undefined;
385
388
  open: boolean | undefined;
386
389
  defaultOpen: boolean;
387
390
  placeholder: string;
388
391
  invalid: boolean | undefined;
389
392
  readOnly: boolean | undefined;
390
- min: string;
391
- isDateUnavailable: (date: DateValue) => boolean;
392
393
  closeOnSelect: boolean;
393
- locale: string;
394
394
  positioning: import("@zag-js/popper").PositioningOptions;
395
395
  }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
396
396
  declare const _default$12: typeof __VLS_export$51;
@@ -553,20 +553,20 @@ declare const __VLS_export$50: import("vue").DefineComponent<import("vue").Extra
553
553
  }>, {
554
554
  class: string;
555
555
  max: string;
556
- disabled: boolean | undefined;
556
+ numOfMonths: number;
557
557
  modelValue: [string, string] | null | undefined;
558
558
  defaultValue: [string, string] | undefined;
559
+ min: string;
560
+ isDateUnavailable: (date: DateValue) => boolean;
561
+ locale: string;
562
+ disabled: boolean | undefined;
559
563
  open: boolean | undefined;
560
564
  defaultOpen: boolean;
561
565
  placeholder: string;
562
566
  invalid: boolean | undefined;
563
567
  readOnly: boolean | undefined;
564
- min: string;
565
- isDateUnavailable: (date: DateValue) => boolean;
566
568
  closeOnSelect: boolean;
567
- locale: string;
568
569
  positioning: import("@zag-js/popper").PositioningOptions;
569
- numOfMonths: number;
570
570
  }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
571
571
  declare const _default$13: typeof __VLS_export$50;
572
572
  type __VLS_Props$12 = {
@@ -726,17 +726,17 @@ declare const __VLS_export$48: import("vue").DefineComponent<import("vue").Extra
726
726
  }>, {
727
727
  class: string;
728
728
  max: string;
729
- disabled: boolean | undefined;
730
729
  modelValue: string | null | undefined;
731
730
  defaultValue: string;
731
+ min: string;
732
+ locale: string;
733
+ disabled: boolean | undefined;
732
734
  open: boolean | undefined;
733
735
  defaultOpen: boolean;
734
736
  placeholder: string;
735
737
  invalid: boolean | undefined;
736
738
  readOnly: boolean | undefined;
737
- min: string;
738
739
  closeOnSelect: boolean;
739
- locale: string;
740
740
  positioning: import("@zag-js/popper").PositioningOptions;
741
741
  }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
742
742
  declare const _default$29: typeof __VLS_export$48;
@@ -893,18 +893,18 @@ declare const __VLS_export$47: import("vue").DefineComponent<import("vue").Extra
893
893
  }>, {
894
894
  class: string;
895
895
  max: string;
896
- disabled: boolean | undefined;
897
896
  modelValue: string | null | undefined;
898
897
  defaultValue: string;
898
+ min: string;
899
+ isDateUnavailable: (date: DateValue) => boolean;
900
+ locale: string;
901
+ disabled: boolean | undefined;
899
902
  open: boolean | undefined;
900
903
  defaultOpen: boolean;
901
904
  placeholder: string;
902
905
  invalid: boolean | undefined;
903
906
  readOnly: boolean | undefined;
904
- min: string;
905
- isDateUnavailable: (date: DateValue) => boolean;
906
907
  closeOnSelect: boolean;
907
- locale: string;
908
908
  positioning: import("@zag-js/popper").PositioningOptions;
909
909
  }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
910
910
  declare const _default$52: typeof __VLS_export$47;
@@ -991,10 +991,10 @@ declare const __VLS_base$34: import("vue").DefineComponent<import("vue").Extract
991
991
  }>, {
992
992
  class: string;
993
993
  max: number;
994
- disabled: boolean | undefined;
995
994
  modelValue: number | null | undefined;
996
- invalid: boolean | undefined;
997
995
  min: number;
996
+ disabled: boolean | undefined;
997
+ invalid: boolean | undefined;
998
998
  step: number;
999
999
  formatOptions: Intl.NumberFormatOptions;
1000
1000
  }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
@@ -1092,8 +1092,8 @@ declare const __VLS_base$33: import("vue").DefineComponent<import("vue").Extract
1092
1092
  "onUpdate:visible"?: ((visible: boolean) => any) | undefined;
1093
1093
  }>, {
1094
1094
  class: string;
1095
- disabled: boolean | undefined;
1096
1095
  modelValue: string | undefined;
1096
+ disabled: boolean | undefined;
1097
1097
  placeholder: string;
1098
1098
  invalid: boolean | undefined;
1099
1099
  visible: boolean | undefined;
@@ -1357,9 +1357,9 @@ declare const __VLS_export$43: import("vue").DefineComponent<import("vue").Extra
1357
1357
  "onUpdate:show"?: ((open: boolean) => any) | undefined;
1358
1358
  }>, {
1359
1359
  class: string;
1360
- disabled: boolean | undefined;
1361
1360
  modelValue: Key | Key[] | undefined;
1362
1361
  defaultValue: Key | Key[] | undefined;
1362
+ disabled: boolean | undefined;
1363
1363
  open: boolean | undefined;
1364
1364
  defaultOpen: boolean;
1365
1365
  placeholder: string;
@@ -1569,9 +1569,9 @@ declare const __VLS_export$42: import("vue").DefineComponent<import("vue").Extra
1569
1569
  "onUpdate:expandedKeys"?: ((keys: Key[]) => any) | undefined;
1570
1570
  }>, {
1571
1571
  class: string;
1572
- disabled: boolean | undefined;
1573
1572
  modelValue: Key | Key[] | undefined;
1574
1573
  defaultValue: Key | Key[] | undefined;
1574
+ disabled: boolean | undefined;
1575
1575
  open: boolean | undefined;
1576
1576
  defaultOpen: boolean;
1577
1577
  placeholder: string;
@@ -1956,17 +1956,17 @@ declare const __VLS_export$37: import("vue").DefineComponent<import("vue").Extra
1956
1956
  }>, {
1957
1957
  class: string;
1958
1958
  max: string;
1959
- disabled: boolean | undefined;
1960
1959
  modelValue: string | null | undefined;
1961
1960
  defaultValue: string;
1961
+ min: string;
1962
+ locale: string;
1963
+ disabled: boolean | undefined;
1962
1964
  open: boolean | undefined;
1963
1965
  defaultOpen: boolean;
1964
1966
  placeholder: string;
1965
1967
  invalid: boolean | undefined;
1966
1968
  readOnly: boolean | undefined;
1967
- min: string;
1968
1969
  closeOnSelect: boolean;
1969
- locale: string;
1970
1970
  positioning: import("@zag-js/popper").PositioningOptions;
1971
1971
  }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
1972
1972
  declare const _default$53: typeof __VLS_export$37;
@@ -2573,12 +2573,12 @@ declare const __VLS_base$24: import("vue").DefineComponent<import("vue").Extract
2573
2573
  }>, {
2574
2574
  mode: "day" | "month" | "year";
2575
2575
  max: string;
2576
+ numOfMonths: number;
2576
2577
  modelValue: string | null | undefined;
2577
2578
  defaultValue: string;
2578
2579
  min: string;
2579
2580
  isDateUnavailable: (date: DateValue) => boolean;
2580
2581
  locale: string;
2581
- numOfMonths: number;
2582
2582
  week: boolean;
2583
2583
  }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
2584
2584
  declare const __VLS_export$31: __VLS_WithSlots$24<typeof __VLS_base$24, __VLS_Slots$24>;
@@ -3172,8 +3172,8 @@ declare const __VLS_base$14: import("vue").DefineComponent<import("vue").Extract
3172
3172
  class: string;
3173
3173
  length: number;
3174
3174
  type: "numeric" | "alphanumeric" | undefined;
3175
- disabled: boolean | undefined;
3176
3175
  modelValue: string[] | undefined;
3176
+ disabled: boolean | undefined;
3177
3177
  placeholder: string;
3178
3178
  invalid: boolean | undefined;
3179
3179
  otp: boolean | undefined;
@@ -5204,6 +5204,13 @@ export type TimelineDotVariants = VariantProps<typeof timelineDotVariants>;
5204
5204
  */
5205
5205
  /** 渲染环境声明(行为组名,非框架名) */
5206
5206
  type TuProviderMode = "auto" | "none" | "shadow" | "shadow-iframe";
5207
+ /**
5208
+ * overlay 滚动锁契约(issue #5):消费方提供 lock() → 解锁函数,
5209
+ * 契约层只负责「是否消费」的拓扑判定,不包装、不持有状态。
5210
+ */
5211
+ interface TuOverlayContract {
5212
+ lock(): VoidFunction;
5213
+ }
5207
5214
  /**
5208
5215
  * `TuDesignProvider` 的 `:toast` 命名空间配置(present = enabled)。
5209
5216
  * 各键语义与独立使用 ToastProvider 时的同名 prop 完全一致;mount-time 消费。
@@ -5239,6 +5246,11 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
5239
5246
  type: PropType<TuToastConfig>;
5240
5247
  default: undefined;
5241
5248
  };
5249
+ /** overlay 滚动锁契约(present = enabled):仅锁禁用拓扑消费(语义 B),mount-time */
5250
+ overlay: {
5251
+ type: PropType<TuOverlayContract>;
5252
+ default: undefined;
5253
+ };
5242
5254
  }>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
5243
5255
  /** 渲染环境声明(行为组名,非框架名);缺省 auto = 现行探测链 */
5244
5256
  mode: {
@@ -5250,9 +5262,15 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
5250
5262
  type: PropType<TuToastConfig>;
5251
5263
  default: undefined;
5252
5264
  };
5265
+ /** overlay 滚动锁契约(present = enabled):仅锁禁用拓扑消费(语义 B),mount-time */
5266
+ overlay: {
5267
+ type: PropType<TuOverlayContract>;
5268
+ default: undefined;
5269
+ };
5253
5270
  }>> & Readonly<{}>, {
5254
5271
  mode: TuProviderMode;
5255
5272
  toast: TuToastConfig;
5273
+ overlay: TuOverlayContract;
5256
5274
  }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
5257
5275
  declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
5258
5276
  declare const _default$51: typeof __VLS_export;
package/dist/index.mjs CHANGED
@@ -1682,6 +1682,18 @@ function preventScrollOverride(mode) {
1682
1682
  case "auto": return isInWujie() ? false : void 0;
1683
1683
  }
1684
1684
  }
1685
+ /**
1686
+ * overlay 契约消费判定(语义 B:仅锁禁用拓扑消费,issue #5)。
1687
+ * overlay 命名空间 prop present = enabled,mount-time 消费;
1688
+ * 仅当 preventScrollOverride(mode) === false(shadow-iframe 显式 / auto 探测命中 wujie)
1689
+ * 时透传契约引用,其余拓扑(none / shadow / auto 非 wujie / 未提供 overlay)一律 null。
1690
+ * 显式 mode 短路探测的性质由 preventScrollOverride 继承(marker 漂移免疫)。
1691
+ * @param config Provider 配置快照
1692
+ * @returns 锁禁用拓扑下为 config.overlay 同引用,否则 null
1693
+ */
1694
+ function overlayContract(config) {
1695
+ return config.overlay && preventScrollOverride(config.mode) === false ? config.overlay : null;
1696
+ }
1685
1697
  // src/components/overlay-shared/useSandboxOverlay.ts
1686
1698
  /**
1687
1699
  * 浮层沙箱适配公共层(Popover 0.5.3 修复的推广形态,机制与实测依据见 sandbox.ts 头注):
@@ -6218,6 +6230,46 @@ const cardVariants = cva("relative rounded-xl border border-border bg-card text-
6218
6230
  bordered: true
6219
6231
  }
6220
6232
  });
6233
+ // src/components/overlay-shared/useOverlayScrollLock.ts
6234
+ /**
6235
+ * overlay 滚动锁契约消费(issue #5):wujie graft 下 Ark 原生滚动锁被禁用(issue #4),
6236
+ * 「锁背景」改由宿主经 Provider overlay 命名空间 prop 提供 lock() → 解锁函数契约。
6237
+ *
6238
+ * 设计依据(冻结语义):
6239
+ * - 语义 B 拓扑闸:仅锁禁用拓扑消费契约(overlayContract 内判定,shadow-iframe 显式 /
6240
+ * auto 探测命中 wujie),其余拓扑 setup 顶层直接 return,零 watch 零副作用。
6241
+ * - RAII 配对:lock() 返回的 release 与开合状态一一对应——open 且模态时持锁,
6242
+ * 关闭/非模态时释放,onBeforeUnmount 补调防泄漏(打开态直接卸载不丢 release)。
6243
+ * - sync + immediate:flush:"sync" 使 lock/release 在 isOpen 转换内同步完成,
6244
+ * 无 nextTick 窗口、同 tick 快速翻转不合并(true-false-true → lock 2 次 release 1 次);
6245
+ * immediate 覆盖初始 open=true 的挂载即锁场景。
6246
+ * - isModal 仅在 isOpen 转换回调内求值,不 watch attrs:打开期间 modal 变化不触发
6247
+ * 锁状态变更(三组件接线 () => attrs.modal !== false && attrs.modal !== "false")。
6248
+ *
6249
+ * @param isOpen - 开合状态(受控桥 ComputedRef 或内部 ref 均可)
6250
+ * @param isModal - 模态判定读取器(仅转换回调内求值)
6251
+ */
6252
+ function useOverlayScrollLock(isOpen, isModal) {
6253
+ const contract = overlayContract(useTuProvider());
6254
+ if (!contract) return;
6255
+ let release = null;
6256
+ watch(isOpen, (open) => {
6257
+ if (open && isModal() && !release) release = contract.lock();
6258
+ else if ((!open || !isModal()) && release) {
6259
+ release();
6260
+ release = null;
6261
+ }
6262
+ }, {
6263
+ immediate: true,
6264
+ flush: "sync"
6265
+ });
6266
+ onBeforeUnmount(() => {
6267
+ if (release) {
6268
+ release();
6269
+ release = null;
6270
+ }
6271
+ });
6272
+ }
6221
6273
  // src/components/dialog/Dialog.vue
6222
6274
  const _hoisted_1$13 = {
6223
6275
  key: 0,
@@ -6273,7 +6325,8 @@ const _sfc_main$14 = /*@__PURE__*/ defineComponent({
6273
6325
  },
6274
6326
  emits: ["update:open"],
6275
6327
  setup(__props, { emit: __emit }) {
6276
- const { ids: rootIds } = useOverlayIds(useAttrs(), {
6328
+ const attrs = useAttrs();
6329
+ const { ids: rootIds } = useOverlayIds(attrs, {
6277
6330
  primary: "content",
6278
6331
  parts: [
6279
6332
  "content",
@@ -6292,6 +6345,7 @@ const _sfc_main$14 = /*@__PURE__*/ defineComponent({
6292
6345
  defaultValue: () => props.defaultOpen,
6293
6346
  onChange: (open) => emit("update:open", open)
6294
6347
  });
6348
+ useOverlayScrollLock(isOpen, () => attrs.modal !== false && attrs.modal !== "false");
6295
6349
  /** 关闭对话框(#footer 作用域插槽注入):走受控桥把 open 置 false,
6296
6350
  * 与原 TDialogClose(Ark CloseTrigger)的关闭语义等价,退出动画/焦点还原由 zag 处理 */
6297
6351
  function close() {
@@ -10454,7 +10508,8 @@ const _sfc_main$1 = /*@__PURE__*/ defineComponent({
10454
10508
  "cancel"
10455
10509
  ],
10456
10510
  setup(__props, { emit: __emit }) {
10457
- const { ids: rootIds } = useOverlayIds(useAttrs(), {
10511
+ const attrs = useAttrs();
10512
+ const { ids: rootIds } = useOverlayIds(attrs, {
10458
10513
  primary: "content",
10459
10514
  parts: [
10460
10515
  "content",
@@ -10473,6 +10528,7 @@ const _sfc_main$1 = /*@__PURE__*/ defineComponent({
10473
10528
  controlled: () => props.open,
10474
10529
  onChange: (open) => emit("update:open", open)
10475
10530
  });
10531
+ useOverlayScrollLock(isOpen, () => attrs.modal !== false && attrs.modal !== "false");
10476
10532
  function handleUpdate(open) {
10477
10533
  if (!open && loading.value) return;
10478
10534
  setOpen(open);
@@ -10667,7 +10723,8 @@ const _sfc_main$15 = /*@__PURE__*/ defineComponent({
10667
10723
  },
10668
10724
  emits: ["update:open"],
10669
10725
  setup(__props, { emit: __emit }) {
10670
- const { ids: rootIds } = useOverlayIds(useAttrs(), {
10726
+ const attrs = useAttrs();
10727
+ const { ids: rootIds } = useOverlayIds(attrs, {
10671
10728
  primary: "content",
10672
10729
  parts: [
10673
10730
  "content",
@@ -10690,6 +10747,7 @@ const _sfc_main$15 = /*@__PURE__*/ defineComponent({
10690
10747
  defaultValue: () => props.defaultOpen,
10691
10748
  onChange: (open) => emit("update:open", open)
10692
10749
  });
10750
+ useOverlayScrollLock(isOpen, () => attrs.modal !== false && attrs.modal !== "false");
10693
10751
  /** 关闭抽屉(#footer 作用域插槽注入) */
10694
10752
  function close() {
10695
10753
  setOpen(false);
@@ -11051,8 +11109,10 @@ const timelineDotVariants = cva("relative z-10 mt-1 block shrink-0 rounded-full"
11051
11109
  * 不挂载本组件或不传 mode 时,一切行为与自动探测现行版本完全一致。
11052
11110
  * 2. `:toast`:消息提示宿主(组合渲染 ToastProvider,present = enabled);
11053
11111
  * 与独立挂载 ToastProvider 二选一,双挂载 dev 告警。
11112
+ * 3. `:overlay`:滚动锁契约(present = enabled,语义 B:仅锁禁用拓扑生效);
11113
+ * 经 provide 快照透传,消费判定见 overlayContract()。非锁禁用拓扑下 dev 告警。
11054
11114
  *
11055
- * 两者均为 mount-time 契约(provide 快照 / ToastProvider 挂载时消费),
11115
+ * 三者均为 mount-time 契约(provide 快照 / ToastProvider 挂载时消费),
11056
11116
  * 动态变更用 :key 重挂载。须包住子应用根(inject 沿逻辑树,Teleport 子树同样命中;
11057
11117
  * 组件挂载在 Provider 子树之外时回落 auto 兜底)。
11058
11118
  */
@@ -11069,11 +11129,20 @@ const _sfc_main$51 = /*@__PURE__*/ defineComponent({
11069
11129
  toast: {
11070
11130
  type: Object,
11071
11131
  default: void 0
11132
+ },
11133
+ /** overlay 滚动锁契约(present = enabled):仅锁禁用拓扑消费(语义 B),mount-time */
11134
+ overlay: {
11135
+ type: Object,
11136
+ default: void 0
11072
11137
  }
11073
11138
  },
11074
11139
  setup(__props) {
11075
11140
  const props = __props;
11076
- provide(TU_PROVIDER_KEY, { mode: props.mode });
11141
+ provide(TU_PROVIDER_KEY, {
11142
+ mode: props.mode,
11143
+ overlay: props.overlay
11144
+ });
11145
+ if (import.meta.env.DEV && props.overlay && preventScrollOverride(props.mode) !== false) console.warn("[tu-design] TuDesignProvider :overlay 仅锁禁用拓扑生效(语义 B):当前 mode 下滚动锁未被禁用,overlay 契约不会被消费。");
11077
11146
  return (_ctx, _cache) => {
11078
11147
  return openBlock(), createElementBlock(Fragment, null, [
11079
11148
  createCommentVNode(" present = enabled::toast 传入即挂载消息宿主(组合复用 ToastProvider,零复制) "),
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "alert-dialog",
4
- "version": "0.5.11",
4
+ "version": "0.5.12",
5
5
  "type": "registry:ui",
6
6
  "description": "确认弹窗单组件:v-model:open 控制显隐,title/description 传文案,@confirm/@cancel 处理确认与取消;确认处理器返回 Promise 时按钮进入 loading 并锁定 ESC/遮罩关闭,resolve 自动关闭、reject 保持打开;内容节点为 role=alertdialog。",
7
7
  "registryDependencies": ["button", "utils", "overlay-shared"],
@@ -11,7 +11,7 @@
11
11
  "path": "alert-dialog/AlertDialog.vue",
12
12
  "type": "registry:component",
13
13
  "target": "components/ui/alert-dialog/AlertDialog.vue",
14
- "content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { computed, getCurrentInstance, useAttrs } from \"vue\";\nimport { Dialog as ArkDialog } from \"@ark-ui/vue/dialog\";\nimport { cn } from \"@/lib/utils\";\nimport { Button } from \"@/components/ui/button\";\nimport { useConfirmPending } from \"../overlay-shared/useConfirmPending\";\nimport { useControlledBoolean } from \"../overlay-shared/useControlledBoolean\";\nimport { useOverlayIds } from \"../overlay-shared/useOverlayIds\";\nimport { overlayPreventScroll } from \"../overlay-shared/useSandboxOverlay\";\n\n// ids 全量覆盖(无冒号):规避 wujie patch getElementById 对 zag 缺省冒号 id 的\n// SyntaxError 刷屏(详注见 useOverlayIds);复用 dialog machine,parts 同 Dialog\nconst { ids: rootIds } = useOverlayIds(useAttrs(), {\n primary: \"content\",\n parts: [\"content\", \"title\", \"description\", \"trigger\", \"closeTrigger\", \"positioner\", \"backdrop\"],\n});\n\n// 用运行时 props 显式 default: undefined:Boolean prop 缺省时 Vue 会 cast 成 false,\n// 导致无法区分「未传(非受控)」与「传了 false(受控关闭)」。与 Dialog.vue 同款约定。\nconst props = defineProps({\n /** 受控开关(配合 v-model:open);不传时为非受控,由内部状态管理 */\n open: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 标题文案(#title 插槽优先) */\n title: { type: String, required: true },\n /** 描述文案(#description 插槽优先,可不传) */\n description: { type: String, default: undefined },\n /** 确认按钮文案 */\n confirmText: { type: String, default: \"确定\" },\n /** 取消按钮文案 */\n cancelText: { type: String, default: \"取消\" },\n /** 确认按钮使用 destructive 语义色(危险操作场景) */\n destructive: { type: Boolean, default: false },\n});\n\nconst emit = defineEmits<{\n \"update:open\": [open: boolean];\n confirm: [];\n cancel: [];\n}>();\n\n// 对 Root 恒走受控模式(open 恒为布尔):非受控语义由内部 ref 实现,与 Dialog.vue 一致。\n// setup 期间捕获实例:getCurrentInstance 仅在 setup/生命周期内有效,事件回调里返回 null。\nconst instance = getCurrentInstance();\nconst { isOpen, setOpen } = useControlledBoolean({\n controlled: () => props.open,\n onChange: (open) => emit(\"update:open\", open),\n});\n\nfunction handleUpdate(open: boolean) {\n // pending 期间忽略一切关闭请求(走受控桥拒绝同步,弹窗保持打开)——\n // 与 Popconfirm 同款锁定方案;Root 仍保留 :close-on-escape/:close-on-interact-outside 双保险\n if (!open && loading.value) return;\n setOpen(open);\n}\n\n/** 关闭弹窗:走受控桥把 open 置 false,退出动画/焦点还原由 zag 处理 */\nfunction close() {\n handleUpdate(false);\n}\n\n// 确认 Promise pending 时锁定关闭通道(ESC/遮罩/取消按钮全部锁死),只能等 Promise 落定\nconst { loading, handleConfirm, handleCancel } = useConfirmPending({\n instance,\n emitConfirm: () => emit(\"confirm\"),\n emitCancel: () => emit(\"cancel\"),\n close,\n});\n\n// 面板样式:复用 Dialog 的内容面板类(含 --dialog 模态表面位,issue #2),宽度收窄为 sm:max-w-md 的确认弹窗尺度\nconst contentClass = computed(() =>\n cn(\n \"bg-dialog text-dialog-foreground data-[state=open]:animate-in data-[state=closed]:animate-out fixed left-1/2 top-1/2 z-[var(--z-modal,60)] grid w-full max-w-[calc(100%-2rem)] -translate-x-1/2 -translate-y-1/2 gap-4 rounded-lg border p-6 shadow-lg duration-200 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 sm:max-w-md\",\n ),\n);\n\n// 滚动锁沙箱降级(wujie graft 下禁用,机制与论证见 overlayPreventScroll / issue #4)\nconst preventScroll = overlayPreventScroll();\n</script>\n\n<template>\n <ArkDialog.Root\n :ids=\"rootIds\"\n :open=\"isOpen\"\n :prevent-scroll=\"preventScroll\"\n :close-on-escape=\"!loading\"\n :close-on-interact-outside=\"!loading\"\n @update:open=\"handleUpdate\"\n >\n <ArkDialog.Backdrop\n class=\"fixed inset-0 z-[var(--z-modal,60)] bg-black/50 data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0\"\n />\n <ArkDialog.Positioner\n class=\"fixed inset-0 z-[var(--z-modal,60)] flex items-center justify-center p-4\"\n >\n <!-- role=\"alertdialog\":覆盖 Ark Content 默认 role=\"dialog\",补偿无上游 AlertDialog 原语的角色语义 -->\n <ArkDialog.Content :class=\"contentClass\" role=\"alertdialog\" aria-modal=\"true\">\n <div class=\"flex flex-col gap-2 text-center sm:text-left\">\n <ArkDialog.Title class=\"text-lg font-semibold leading-none tracking-tight\">\n <slot name=\"title\">{{ props.title }}</slot>\n </ArkDialog.Title>\n <ArkDialog.Description\n v-if=\"$slots.description || props.description\"\n class=\"text-sm text-muted-foreground\"\n >\n <slot name=\"description\">{{ props.description }}</slot>\n </ArkDialog.Description>\n </div>\n\n <!-- 默认插槽:补充正文(可选) -->\n <slot />\n\n <!-- 底部操作区:取消 outline,确认按 destructive 切换语义色;pending 时确认钮转 loading -->\n <div class=\"flex flex-col-reverse gap-2 sm:flex-row sm:justify-end\">\n <Button variant=\"outline\" :disabled=\"loading\" @click=\"handleCancel\">\n {{ props.cancelText }}\n </Button>\n <Button\n :variant=\"props.destructive ? 'destructive' : 'default'\"\n :disabled=\"loading\"\n @click=\"handleConfirm\"\n >\n <svg\n v-if=\"loading\"\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"2\"\n stroke-linecap=\"round\"\n class=\"size-4 animate-spin\"\n aria-hidden=\"true\"\n >\n <path d=\"M21 12a9 9 0 1 1-6.219-8.56\" />\n </svg>\n {{ props.confirmText }}\n </Button>\n </div>\n </ArkDialog.Content>\n </ArkDialog.Positioner>\n </ArkDialog.Root>\n</template>\n"
14
+ "content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { computed, getCurrentInstance, useAttrs } from \"vue\";\nimport { Dialog as ArkDialog } from \"@ark-ui/vue/dialog\";\nimport { cn } from \"@/lib/utils\";\nimport { Button } from \"@/components/ui/button\";\nimport { useConfirmPending } from \"../overlay-shared/useConfirmPending\";\nimport { useControlledBoolean } from \"../overlay-shared/useControlledBoolean\";\nimport { useOverlayIds } from \"../overlay-shared/useOverlayIds\";\nimport { useOverlayScrollLock } from \"../overlay-shared/useOverlayScrollLock\";\nimport { overlayPreventScroll } from \"../overlay-shared/useSandboxOverlay\";\n\nconst attrs = useAttrs();\n\n// ids 全量覆盖(无冒号):规避 wujie patch getElementById 对 zag 缺省冒号 id 的\n// SyntaxError 刷屏(详注见 useOverlayIds);复用 dialog machine,parts 同 Dialog\nconst { ids: rootIds } = useOverlayIds(attrs, {\n primary: \"content\",\n parts: [\"content\", \"title\", \"description\", \"trigger\", \"closeTrigger\", \"positioner\", \"backdrop\"],\n});\n\n// 用运行时 props 显式 default: undefined:Boolean prop 缺省时 Vue 会 cast 成 false,\n// 导致无法区分「未传(非受控)」与「传了 false(受控关闭)」。与 Dialog.vue 同款约定。\nconst props = defineProps({\n /** 受控开关(配合 v-model:open);不传时为非受控,由内部状态管理 */\n open: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 标题文案(#title 插槽优先) */\n title: { type: String, required: true },\n /** 描述文案(#description 插槽优先,可不传) */\n description: { type: String, default: undefined },\n /** 确认按钮文案 */\n confirmText: { type: String, default: \"确定\" },\n /** 取消按钮文案 */\n cancelText: { type: String, default: \"取消\" },\n /** 确认按钮使用 destructive 语义色(危险操作场景) */\n destructive: { type: Boolean, default: false },\n});\n\nconst emit = defineEmits<{\n \"update:open\": [open: boolean];\n confirm: [];\n cancel: [];\n}>();\n\n// 对 Root 恒走受控模式(open 恒为布尔):非受控语义由内部 ref 实现,与 Dialog.vue 一致。\n// setup 期间捕获实例:getCurrentInstance 仅在 setup/生命周期内有效,事件回调里返回 null。\nconst instance = getCurrentInstance();\nconst { isOpen, setOpen } = useControlledBoolean({\n controlled: () => props.open,\n onChange: (open) => emit(\"update:open\", open),\n});\n\n// overlay 滚动锁契约(issue #5,语义 B 拓扑闸在 overlayContract 内);\n// isModal 仅在 isOpen 转换回调内求值(冻结语义,不 watch attrs)\nuseOverlayScrollLock(isOpen, () => attrs.modal !== false && attrs.modal !== \"false\");\n\nfunction handleUpdate(open: boolean) {\n // pending 期间忽略一切关闭请求(走受控桥拒绝同步,弹窗保持打开)——\n // 与 Popconfirm 同款锁定方案;Root 仍保留 :close-on-escape/:close-on-interact-outside 双保险\n if (!open && loading.value) return;\n setOpen(open);\n}\n\n/** 关闭弹窗:走受控桥把 open 置 false,退出动画/焦点还原由 zag 处理 */\nfunction close() {\n handleUpdate(false);\n}\n\n// 确认 Promise pending 时锁定关闭通道(ESC/遮罩/取消按钮全部锁死),只能等 Promise 落定\nconst { loading, handleConfirm, handleCancel } = useConfirmPending({\n instance,\n emitConfirm: () => emit(\"confirm\"),\n emitCancel: () => emit(\"cancel\"),\n close,\n});\n\n// 面板样式:复用 Dialog 的内容面板类(含 --dialog 模态表面位,issue #2),宽度收窄为 sm:max-w-md 的确认弹窗尺度\nconst contentClass = computed(() =>\n cn(\n \"bg-dialog text-dialog-foreground data-[state=open]:animate-in data-[state=closed]:animate-out fixed left-1/2 top-1/2 z-[var(--z-modal,60)] grid w-full max-w-[calc(100%-2rem)] -translate-x-1/2 -translate-y-1/2 gap-4 rounded-lg border p-6 shadow-lg duration-200 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 sm:max-w-md\",\n ),\n);\n\n// 滚动锁沙箱降级(wujie graft 下禁用,机制与论证见 overlayPreventScroll / issue #4)\nconst preventScroll = overlayPreventScroll();\n</script>\n\n<template>\n <ArkDialog.Root\n :ids=\"rootIds\"\n :open=\"isOpen\"\n :prevent-scroll=\"preventScroll\"\n :close-on-escape=\"!loading\"\n :close-on-interact-outside=\"!loading\"\n @update:open=\"handleUpdate\"\n >\n <ArkDialog.Backdrop\n class=\"fixed inset-0 z-[var(--z-modal,60)] bg-black/50 data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0\"\n />\n <ArkDialog.Positioner\n class=\"fixed inset-0 z-[var(--z-modal,60)] flex items-center justify-center p-4\"\n >\n <!-- role=\"alertdialog\":覆盖 Ark Content 默认 role=\"dialog\",补偿无上游 AlertDialog 原语的角色语义 -->\n <ArkDialog.Content :class=\"contentClass\" role=\"alertdialog\" aria-modal=\"true\">\n <div class=\"flex flex-col gap-2 text-center sm:text-left\">\n <ArkDialog.Title class=\"text-lg font-semibold leading-none tracking-tight\">\n <slot name=\"title\">{{ props.title }}</slot>\n </ArkDialog.Title>\n <ArkDialog.Description\n v-if=\"$slots.description || props.description\"\n class=\"text-sm text-muted-foreground\"\n >\n <slot name=\"description\">{{ props.description }}</slot>\n </ArkDialog.Description>\n </div>\n\n <!-- 默认插槽:补充正文(可选) -->\n <slot />\n\n <!-- 底部操作区:取消 outline,确认按 destructive 切换语义色;pending 时确认钮转 loading -->\n <div class=\"flex flex-col-reverse gap-2 sm:flex-row sm:justify-end\">\n <Button variant=\"outline\" :disabled=\"loading\" @click=\"handleCancel\">\n {{ props.cancelText }}\n </Button>\n <Button\n :variant=\"props.destructive ? 'destructive' : 'default'\"\n :disabled=\"loading\"\n @click=\"handleConfirm\"\n >\n <svg\n v-if=\"loading\"\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"2\"\n stroke-linecap=\"round\"\n class=\"size-4 animate-spin\"\n aria-hidden=\"true\"\n >\n <path d=\"M21 12a9 9 0 1 1-6.219-8.56\" />\n </svg>\n {{ props.confirmText }}\n </Button>\n </div>\n </ArkDialog.Content>\n </ArkDialog.Positioner>\n </ArkDialog.Root>\n</template>\n"
15
15
  },
16
16
  {
17
17
  "path": "alert-dialog/index.ts",
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "alert",
4
- "version": "0.5.11",
4
+ "version": "0.5.12",
5
5
  "type": "registry:ui",
6
6
  "description": "语义化警示条,支持五种变体、内置图标与可关闭交互。",
7
7
  "registryDependencies": ["icon-shared", "utils"],
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "avatar-group",
4
- "version": "0.5.11",
4
+ "version": "0.5.12",
5
5
  "type": "registry:ui",
6
6
  "description": "头像组,数量折叠、悬停展开与垂直排列。",
7
7
  "registryDependencies": ["utils", "avatar"],
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "avatar",
4
- "version": "0.5.11",
4
+ "version": "0.5.12",
5
5
  "type": "registry:ui",
6
6
  "description": "头像,支持尺寸/形状、加载占位与失败回退(Ark UI)。",
7
7
  "registryDependencies": ["utils"],
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "badge",
4
- "version": "0.5.11",
4
+ "version": "0.5.12",
5
5
  "type": "registry:ui",
6
6
  "description": "轻量状态徽标,支持四种变体。",
7
7
  "registryDependencies": ["utils"],
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "button",
4
- "version": "0.5.11",
4
+ "version": "0.5.12",
5
5
  "type": "registry:ui",
6
6
  "description": "带变体与尺寸的按钮,支持 as 标签切换与 asChild 组合。",
7
7
  "registryDependencies": ["utils", "slot"],
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "calendar",
4
- "version": "0.5.11",
4
+ "version": "0.5.12",
5
5
  "type": "registry:ui",
6
6
  "description": "日历(TCalendar):紧凑日历卡。Picker 弹层内为 embedded 内嵌形态(TDatePicker/TDateRangePicker 自动挂靠,纯卡片内核);独立使用即 standalone 独立形态(自带日历状态与 v-model,恒开展示)。",
7
7
  "registryDependencies": ["icon-shared", "utils", "date-shared"],
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "card",
4
- "version": "0.5.11",
4
+ "version": "0.5.12",
5
5
  "type": "registry:ui",
6
6
  "description": "卡片容器:单组件 API,title/description 头部 + 命名插槽(cover/action/footer/header),支持尺寸、视觉变体、分段分隔与可关闭。",
7
7
  "registryDependencies": ["utils"],
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "cascader",
4
- "version": "0.5.11",
4
+ "version": "0.5.12",
5
5
  "type": "registry:ui",
6
6
  "description": "级联选择:一站式 props 驱动,多列联动、勾选级联、路径回显与多标签。",
7
7
  "registryDependencies": ["icon-shared", "tree-shared", "utils", "date-shared", "overlay-shared"],
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "checkbox",
4
- "version": "0.5.11",
4
+ "version": "0.5.12",
5
5
  "type": "registry:ui",
6
6
  "description": "复选框:基于 Ark UI Checkbox 原语,支持标签插槽、受控/非受控与禁用。",
7
7
  "registryDependencies": ["utils"],
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "context-menu",
4
- "version": "0.5.11",
4
+ "version": "0.5.12",
5
5
  "type": "registry:ui",
6
6
  "description": "右键菜单:单组件模式,items 描述菜单项(与 dropdown-menu 同构,含分组/标题/分隔线,支持嵌套),默认插槽为触发元素(ContextTrigger as-child,右键唤出并定位到指针处),内置键盘导航与选中回调。",
7
7
  "registryDependencies": ["overlay-shared", "utils", "dropdown-menu"],
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "currency-input",
4
- "version": "0.5.11",
4
+ "version": "0.5.12",
5
5
  "type": "registry:ui",
6
6
  "description": "金额输入框:内置万/元/角/分单位后缀,labelUnit 输入单位与 valueUnit 存储单位自动换算(整数分最小精度),值以 number|null 受控。",
7
7
  "registryDependencies": ["utils"],
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "date-picker",
4
- "version": "0.5.11",
4
+ "version": "0.5.12",
5
5
  "type": "registry:ui",
6
6
  "description": "日期选择器:输入框 + 日历弹层(月/年视图切换),支持手动键入/清空/min-max 边界/不可选谓词,值以 \"yyyy-MM-dd\" 字符串受控。",
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": "date-range-picker",
4
- "version": "0.5.11",
4
+ "version": "0.5.12",
5
5
  "type": "registry:ui",
6
6
  "description": "日期范围选择器:双月日历弹层(月/年视图切换),点选起点与终点,值以 [\"yyyy-MM-dd\", \"yyyy-MM-dd\"] 有序元组受控,空值归一 null。",
7
7
  "registryDependencies": ["icon-shared", "utils", "date-shared", "calendar", "overlay-shared"],
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "date-shared",
4
- "version": "0.5.11",
4
+ "version": "0.5.12",
5
5
  "type": "registry:ui",
6
6
  "description": "日期家族共享模块:ISO 值域解析(日期/月/年/区间)、日历样式常量与单值选择器外壳(PickerShell/usePickerBridge)。",
7
7
  "registryDependencies": ["icon-shared", "utils", "overlay-shared"],
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "dialog",
4
- "version": "0.5.11",
4
+ "version": "0.5.12",
5
5
  "type": "registry:ui",
6
6
  "description": "模态对话框单组件:#trigger 放触发元素,title/description 传文案,#footer 注入 close 关闭;基于 Ark UI Dialog 原语,含焦点圈定、Escape/遮罩关闭与进出场动画,支持 v-model:open。",
7
7
  "registryDependencies": ["icon-shared", "utils", "overlay-shared"],
@@ -11,7 +11,7 @@
11
11
  "path": "dialog/Dialog.vue",
12
12
  "type": "registry:component",
13
13
  "target": "components/ui/dialog/Dialog.vue",
14
- "content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { computed, useAttrs } from \"vue\";\nimport { Dialog as ArkDialog } from \"@ark-ui/vue/dialog\";\nimport { cn } from \"@/lib/utils\";\nimport { useControlledBoolean } from \"../overlay-shared/useControlledBoolean\";\nimport { useOverlayIds } from \"../overlay-shared/useOverlayIds\";\nimport { overlayPreventScroll } from \"../overlay-shared/useSandboxOverlay\";\nimport CloseIcon from \"../icon-shared/CloseIcon.vue\";\n\n// ids 全量覆盖(无冒号):规避 wujie patch getElementById 对 zag 缺省冒号 id 的\n// SyntaxError 刷屏(详注见 useOverlayIds)\nconst { ids: rootIds } = useOverlayIds(useAttrs(), {\n primary: \"content\",\n parts: [\"content\", \"title\", \"description\", \"trigger\", \"closeTrigger\", \"positioner\", \"backdrop\"],\n});\n\n// 用运行时 props 显式 default: undefined:Boolean prop 缺省时 Vue 会 cast 成 false,\n// 导致无法区分「未传(非受控)」与「传了 false(受控关闭)」。\nconst props = defineProps({\n /** 受控开关(配合 v-model:open);不传时为非受控,由内部状态管理 */\n open: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 非受控时的初始开关 */\n defaultOpen: { type: Boolean, default: false },\n /** 首次打开前不挂载内容 */\n lazyMount: { type: Boolean, default: false },\n /** 关闭后卸载内容(关闭动画结束后) */\n unmountOnExit: { type: Boolean, default: false },\n /** 标题文案(#title 插槽优先,两者皆无则不渲染标题) */\n title: { type: String, default: undefined },\n /** 描述文案(#description 插槽优先,两者皆无则不渲染描述) */\n description: { type: String, default: undefined },\n /** 是否渲染右上角内置关闭按钮 */\n showCloseButton: { type: Boolean, default: true },\n /** 追加/覆盖面板样式类(默认 sm:max-w-lg 可由此覆盖,如 \"sm:max-w-xl\") */\n contentClass: { type: String, default: undefined },\n});\n\nconst emit = defineEmits<{ \"update:open\": [open: boolean] }>();\n\n// 对 Root 恒走受控模式(open 恒为布尔):非受控语义由内部 ref 实现,\n// 避开 zag uncontrolled 内部状态在部分环境下不同步的问题,两种模式行为一致。\nconst { isOpen, setOpen } = useControlledBoolean({\n controlled: () => props.open,\n defaultValue: () => props.defaultOpen,\n onChange: (open) => emit(\"update:open\", open),\n});\n\n/** 关闭对话框(#footer 作用域插槽注入):走受控桥把 open 置 false,\n * 与原 TDialogClose(Ark CloseTrigger)的关闭语义等价,退出动画/焦点还原由 zag 处理 */\nfunction close() {\n setOpen(false);\n}\n\n// 标题/描述有任一来源(props 或插槽)时才渲染头部区块(原 TDialogHeader 布局类)\nconst hasHeader = computed(() => Boolean(props.title || props.description));\n\n// 滚动锁沙箱降级(wujie graft 下禁用,机制与论证见 overlayPreventScroll / issue #4);\n// wujie marker 先于子应用脚本注入,setup 顶层求值时序可靠\nconst preventScroll = overlayPreventScroll();\n\n// 面板样式:内置类 + contentClass 合并(twMerge 自动去冲突,后者优先)。\n// 面板底色走 --dialog 模态表面位(issue #2):--background 是页面画布语义,画布带色的主题下面板不被染色。\nconst contentClass = computed(() =>\n cn(\n \"bg-dialog text-dialog-foreground data-[state=open]:animate-in data-[state=closed]:animate-out fixed left-1/2 top-1/2 z-[var(--z-modal,60)] grid w-full max-w-[calc(100%-2rem)] -translate-x-1/2 -translate-y-1/2 gap-4 rounded-lg border p-6 shadow-lg duration-200 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 sm:max-w-lg\",\n props.contentClass,\n ),\n);\n</script>\n\n<template>\n <ArkDialog.Root\n :ids=\"rootIds\"\n :open=\"isOpen\"\n :prevent-scroll=\"preventScroll\"\n :lazy-mount=\"props.lazyMount\"\n :unmount-on-exit=\"props.unmountOnExit\"\n @update:open=\"setOpen\"\n >\n <!-- #trigger:触发元素本体(asChild 语义合并到子元素,原 TDialogTrigger 同款实现);未提供则不渲染触发器 -->\n <ArkDialog.Trigger v-if=\"$slots.trigger\" as-child>\n <slot name=\"trigger\" />\n </ArkDialog.Trigger>\n\n <ArkDialog.Backdrop\n class=\"fixed inset-0 z-[var(--z-modal,60)] bg-black/50 data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0\"\n />\n <ArkDialog.Positioner\n class=\"fixed inset-0 z-[var(--z-modal,60)] flex items-center justify-center p-4\"\n >\n <ArkDialog.Content :class=\"contentClass\">\n <!-- 标题/描述:#title / #description 插槽优先,回退 title/description props;皆无则不渲染对应 DOM -->\n <div\n v-if=\"hasHeader || $slots.title || $slots.description\"\n class=\"flex flex-col gap-2 text-center sm:text-left\"\n >\n <ArkDialog.Title\n v-if=\"$slots.title || props.title\"\n class=\"text-lg font-semibold leading-none tracking-tight\"\n >\n <slot name=\"title\">{{ props.title }}</slot>\n </ArkDialog.Title>\n <ArkDialog.Description\n v-if=\"$slots.description || props.description\"\n class=\"text-sm text-muted-foreground\"\n >\n <slot name=\"description\">{{ props.description }}</slot>\n </ArkDialog.Description>\n </div>\n\n <!-- 默认插槽:弹层内容区(原 TDialogContent 的 body 部分) -->\n <slot />\n\n <!-- 底部操作区:#footer=\"{ close }\" 注入关闭函数,替代原 TDialogClose -->\n <div v-if=\"$slots.footer\" class=\"flex flex-col-reverse gap-2 sm:flex-row sm:justify-end\">\n <slot name=\"footer\" :close=\"close\" />\n </div>\n\n <ArkDialog.CloseTrigger\n v-if=\"props.showCloseButton\"\n class=\"absolute right-4 top-4 cursor-pointer rounded-sm opacity-70 transition-opacity hover:opacity-100 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring disabled:pointer-events-none\"\n >\n <slot name=\"close\">\n <CloseIcon class=\"size-4\" />\n <span class=\"sr-only\">关闭</span>\n </slot>\n </ArkDialog.CloseTrigger>\n </ArkDialog.Content>\n </ArkDialog.Positioner>\n </ArkDialog.Root>\n</template>\n"
14
+ "content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { computed, useAttrs } from \"vue\";\nimport { Dialog as ArkDialog } from \"@ark-ui/vue/dialog\";\nimport { cn } from \"@/lib/utils\";\nimport { useControlledBoolean } from \"../overlay-shared/useControlledBoolean\";\nimport { useOverlayIds } from \"../overlay-shared/useOverlayIds\";\nimport { useOverlayScrollLock } from \"../overlay-shared/useOverlayScrollLock\";\nimport { overlayPreventScroll } from \"../overlay-shared/useSandboxOverlay\";\nimport CloseIcon from \"../icon-shared/CloseIcon.vue\";\n\nconst attrs = useAttrs();\n\n// ids 全量覆盖(无冒号):规避 wujie patch getElementById 对 zag 缺省冒号 id 的\n// SyntaxError 刷屏(详注见 useOverlayIds)\nconst { ids: rootIds } = useOverlayIds(attrs, {\n primary: \"content\",\n parts: [\"content\", \"title\", \"description\", \"trigger\", \"closeTrigger\", \"positioner\", \"backdrop\"],\n});\n\n// 用运行时 props 显式 default: undefined:Boolean prop 缺省时 Vue 会 cast 成 false,\n// 导致无法区分「未传(非受控)」与「传了 false(受控关闭)」。\nconst props = defineProps({\n /** 受控开关(配合 v-model:open);不传时为非受控,由内部状态管理 */\n open: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 非受控时的初始开关 */\n defaultOpen: { type: Boolean, default: false },\n /** 首次打开前不挂载内容 */\n lazyMount: { type: Boolean, default: false },\n /** 关闭后卸载内容(关闭动画结束后) */\n unmountOnExit: { type: Boolean, default: false },\n /** 标题文案(#title 插槽优先,两者皆无则不渲染标题) */\n title: { type: String, default: undefined },\n /** 描述文案(#description 插槽优先,两者皆无则不渲染描述) */\n description: { type: String, default: undefined },\n /** 是否渲染右上角内置关闭按钮 */\n showCloseButton: { type: Boolean, default: true },\n /** 追加/覆盖面板样式类(默认 sm:max-w-lg 可由此覆盖,如 \"sm:max-w-xl\") */\n contentClass: { type: String, default: undefined },\n});\n\nconst emit = defineEmits<{ \"update:open\": [open: boolean] }>();\n\n// 对 Root 恒走受控模式(open 恒为布尔):非受控语义由内部 ref 实现,\n// 避开 zag uncontrolled 内部状态在部分环境下不同步的问题,两种模式行为一致。\nconst { isOpen, setOpen } = useControlledBoolean({\n controlled: () => props.open,\n defaultValue: () => props.defaultOpen,\n onChange: (open) => emit(\"update:open\", open),\n});\n\n// overlay 滚动锁契约(issue #5,语义 B 拓扑闸在 overlayContract 内);\n// isModal 仅在 isOpen 转换回调内求值(冻结语义,不 watch attrs)\nuseOverlayScrollLock(isOpen, () => attrs.modal !== false && attrs.modal !== \"false\");\n\n/** 关闭对话框(#footer 作用域插槽注入):走受控桥把 open 置 false,\n * 与原 TDialogClose(Ark CloseTrigger)的关闭语义等价,退出动画/焦点还原由 zag 处理 */\nfunction close() {\n setOpen(false);\n}\n\n// 标题/描述有任一来源(props 或插槽)时才渲染头部区块(原 TDialogHeader 布局类)\nconst hasHeader = computed(() => Boolean(props.title || props.description));\n\n// 滚动锁沙箱降级(wujie graft 下禁用,机制与论证见 overlayPreventScroll / issue #4);\n// wujie marker 先于子应用脚本注入,setup 顶层求值时序可靠\nconst preventScroll = overlayPreventScroll();\n\n// 面板样式:内置类 + contentClass 合并(twMerge 自动去冲突,后者优先)。\n// 面板底色走 --dialog 模态表面位(issue #2):--background 是页面画布语义,画布带色的主题下面板不被染色。\nconst contentClass = computed(() =>\n cn(\n \"bg-dialog text-dialog-foreground data-[state=open]:animate-in data-[state=closed]:animate-out fixed left-1/2 top-1/2 z-[var(--z-modal,60)] grid w-full max-w-[calc(100%-2rem)] -translate-x-1/2 -translate-y-1/2 gap-4 rounded-lg border p-6 shadow-lg duration-200 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 sm:max-w-lg\",\n props.contentClass,\n ),\n);\n</script>\n\n<template>\n <ArkDialog.Root\n :ids=\"rootIds\"\n :open=\"isOpen\"\n :prevent-scroll=\"preventScroll\"\n :lazy-mount=\"props.lazyMount\"\n :unmount-on-exit=\"props.unmountOnExit\"\n @update:open=\"setOpen\"\n >\n <!-- #trigger:触发元素本体(asChild 语义合并到子元素,原 TDialogTrigger 同款实现);未提供则不渲染触发器 -->\n <ArkDialog.Trigger v-if=\"$slots.trigger\" as-child>\n <slot name=\"trigger\" />\n </ArkDialog.Trigger>\n\n <ArkDialog.Backdrop\n class=\"fixed inset-0 z-[var(--z-modal,60)] bg-black/50 data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0\"\n />\n <ArkDialog.Positioner\n class=\"fixed inset-0 z-[var(--z-modal,60)] flex items-center justify-center p-4\"\n >\n <ArkDialog.Content :class=\"contentClass\">\n <!-- 标题/描述:#title / #description 插槽优先,回退 title/description props;皆无则不渲染对应 DOM -->\n <div\n v-if=\"hasHeader || $slots.title || $slots.description\"\n class=\"flex flex-col gap-2 text-center sm:text-left\"\n >\n <ArkDialog.Title\n v-if=\"$slots.title || props.title\"\n class=\"text-lg font-semibold leading-none tracking-tight\"\n >\n <slot name=\"title\">{{ props.title }}</slot>\n </ArkDialog.Title>\n <ArkDialog.Description\n v-if=\"$slots.description || props.description\"\n class=\"text-sm text-muted-foreground\"\n >\n <slot name=\"description\">{{ props.description }}</slot>\n </ArkDialog.Description>\n </div>\n\n <!-- 默认插槽:弹层内容区(原 TDialogContent 的 body 部分) -->\n <slot />\n\n <!-- 底部操作区:#footer=\"{ close }\" 注入关闭函数,替代原 TDialogClose -->\n <div v-if=\"$slots.footer\" class=\"flex flex-col-reverse gap-2 sm:flex-row sm:justify-end\">\n <slot name=\"footer\" :close=\"close\" />\n </div>\n\n <ArkDialog.CloseTrigger\n v-if=\"props.showCloseButton\"\n class=\"absolute right-4 top-4 cursor-pointer rounded-sm opacity-70 transition-opacity hover:opacity-100 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring disabled:pointer-events-none\"\n >\n <slot name=\"close\">\n <CloseIcon class=\"size-4\" />\n <span class=\"sr-only\">关闭</span>\n </slot>\n </ArkDialog.CloseTrigger>\n </ArkDialog.Content>\n </ArkDialog.Positioner>\n </ArkDialog.Root>\n</template>\n"
15
15
  },
16
16
  {
17
17
  "path": "dialog/index.ts",