@tu-design/vue 0.5.12 → 0.5.13
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 +22 -22
- package/dist/index.mjs +67 -1
- package/dist/registry/vue/alert-dialog.json +1 -1
- 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 +1 -1
- 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/package.json +1 -1
package/dist/index.d.mts
CHANGED
|
@@ -105,9 +105,9 @@ declare const __VLS_base$35: import("vue").DefineComponent<import("vue").Extract
|
|
|
105
105
|
"onUpdate:checked"?: ((checked: boolean) => any) | undefined;
|
|
106
106
|
}>, {
|
|
107
107
|
class: string;
|
|
108
|
+
disabled: boolean;
|
|
108
109
|
checked: boolean | "indeterminate" | undefined;
|
|
109
110
|
defaultChecked: boolean;
|
|
110
|
-
disabled: boolean;
|
|
111
111
|
name: string;
|
|
112
112
|
form: string;
|
|
113
113
|
}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
|
|
@@ -210,8 +210,8 @@ declare const __VLS_export$52: import("vue").DefineComponent<import("vue").Extra
|
|
|
210
210
|
}>, {
|
|
211
211
|
class: string;
|
|
212
212
|
modelValue: number | null | undefined;
|
|
213
|
-
disabled: boolean | undefined;
|
|
214
213
|
placeholder: string;
|
|
214
|
+
disabled: boolean | undefined;
|
|
215
215
|
invalid: boolean | undefined;
|
|
216
216
|
labelUnit: CurrencyUnit;
|
|
217
217
|
valueUnit: CurrencyUnit;
|
|
@@ -378,16 +378,16 @@ declare const __VLS_export$51: import("vue").DefineComponent<import("vue").Extra
|
|
|
378
378
|
"onUpdate:open"?: ((open: boolean) => any) | undefined;
|
|
379
379
|
}>, {
|
|
380
380
|
class: string;
|
|
381
|
-
max: string;
|
|
382
381
|
modelValue: string | null | undefined;
|
|
383
382
|
defaultValue: string;
|
|
384
383
|
min: string;
|
|
384
|
+
max: string;
|
|
385
385
|
isDateUnavailable: (date: DateValue) => boolean;
|
|
386
386
|
locale: string;
|
|
387
|
-
disabled: boolean | undefined;
|
|
388
387
|
open: boolean | undefined;
|
|
389
388
|
defaultOpen: boolean;
|
|
390
389
|
placeholder: string;
|
|
390
|
+
disabled: boolean | undefined;
|
|
391
391
|
invalid: boolean | undefined;
|
|
392
392
|
readOnly: boolean | undefined;
|
|
393
393
|
closeOnSelect: boolean;
|
|
@@ -552,17 +552,17 @@ declare const __VLS_export$50: import("vue").DefineComponent<import("vue").Extra
|
|
|
552
552
|
"onUpdate:open"?: ((open: boolean) => any) | undefined;
|
|
553
553
|
}>, {
|
|
554
554
|
class: string;
|
|
555
|
-
max: string;
|
|
556
555
|
numOfMonths: number;
|
|
557
556
|
modelValue: [string, string] | null | undefined;
|
|
558
557
|
defaultValue: [string, string] | undefined;
|
|
559
558
|
min: string;
|
|
559
|
+
max: string;
|
|
560
560
|
isDateUnavailable: (date: DateValue) => boolean;
|
|
561
561
|
locale: string;
|
|
562
|
-
disabled: boolean | undefined;
|
|
563
562
|
open: boolean | undefined;
|
|
564
563
|
defaultOpen: boolean;
|
|
565
564
|
placeholder: string;
|
|
565
|
+
disabled: boolean | undefined;
|
|
566
566
|
invalid: boolean | undefined;
|
|
567
567
|
readOnly: boolean | undefined;
|
|
568
568
|
closeOnSelect: boolean;
|
|
@@ -725,15 +725,15 @@ declare const __VLS_export$48: import("vue").DefineComponent<import("vue").Extra
|
|
|
725
725
|
"onUpdate:open"?: ((open: boolean) => any) | undefined;
|
|
726
726
|
}>, {
|
|
727
727
|
class: string;
|
|
728
|
-
max: string;
|
|
729
728
|
modelValue: string | null | undefined;
|
|
730
729
|
defaultValue: string;
|
|
731
730
|
min: string;
|
|
731
|
+
max: string;
|
|
732
732
|
locale: string;
|
|
733
|
-
disabled: boolean | undefined;
|
|
734
733
|
open: boolean | undefined;
|
|
735
734
|
defaultOpen: boolean;
|
|
736
735
|
placeholder: string;
|
|
736
|
+
disabled: boolean | undefined;
|
|
737
737
|
invalid: boolean | undefined;
|
|
738
738
|
readOnly: boolean | undefined;
|
|
739
739
|
closeOnSelect: boolean;
|
|
@@ -892,16 +892,16 @@ declare const __VLS_export$47: import("vue").DefineComponent<import("vue").Extra
|
|
|
892
892
|
"onUpdate:open"?: ((open: boolean) => any) | undefined;
|
|
893
893
|
}>, {
|
|
894
894
|
class: string;
|
|
895
|
-
max: string;
|
|
896
895
|
modelValue: string | null | undefined;
|
|
897
896
|
defaultValue: string;
|
|
898
897
|
min: string;
|
|
898
|
+
max: string;
|
|
899
899
|
isDateUnavailable: (date: DateValue) => boolean;
|
|
900
900
|
locale: string;
|
|
901
|
-
disabled: boolean | undefined;
|
|
902
901
|
open: boolean | undefined;
|
|
903
902
|
defaultOpen: boolean;
|
|
904
903
|
placeholder: string;
|
|
904
|
+
disabled: boolean | undefined;
|
|
905
905
|
invalid: boolean | undefined;
|
|
906
906
|
readOnly: boolean | undefined;
|
|
907
907
|
closeOnSelect: boolean;
|
|
@@ -990,9 +990,9 @@ declare const __VLS_base$34: import("vue").DefineComponent<import("vue").Extract
|
|
|
990
990
|
"onUpdate:modelValue"?: ((value: number | null) => any) | undefined;
|
|
991
991
|
}>, {
|
|
992
992
|
class: string;
|
|
993
|
-
max: number;
|
|
994
993
|
modelValue: number | null | undefined;
|
|
995
994
|
min: number;
|
|
995
|
+
max: number;
|
|
996
996
|
disabled: boolean | undefined;
|
|
997
997
|
invalid: boolean | undefined;
|
|
998
998
|
step: number;
|
|
@@ -1093,8 +1093,8 @@ declare const __VLS_base$33: import("vue").DefineComponent<import("vue").Extract
|
|
|
1093
1093
|
}>, {
|
|
1094
1094
|
class: string;
|
|
1095
1095
|
modelValue: string | undefined;
|
|
1096
|
-
disabled: boolean | undefined;
|
|
1097
1096
|
placeholder: string;
|
|
1097
|
+
disabled: boolean | undefined;
|
|
1098
1098
|
invalid: boolean | undefined;
|
|
1099
1099
|
visible: boolean | undefined;
|
|
1100
1100
|
autoComplete: "current-password" | "new-password";
|
|
@@ -1359,10 +1359,10 @@ declare const __VLS_export$43: import("vue").DefineComponent<import("vue").Extra
|
|
|
1359
1359
|
class: string;
|
|
1360
1360
|
modelValue: Key | Key[] | undefined;
|
|
1361
1361
|
defaultValue: Key | Key[] | undefined;
|
|
1362
|
-
disabled: boolean | undefined;
|
|
1363
1362
|
open: boolean | undefined;
|
|
1364
1363
|
defaultOpen: boolean;
|
|
1365
1364
|
placeholder: string;
|
|
1365
|
+
disabled: boolean | undefined;
|
|
1366
1366
|
positioning: import("@ark-ui/vue/select").SelectPositioningOptions | undefined;
|
|
1367
1367
|
multiple: boolean;
|
|
1368
1368
|
checkable: boolean;
|
|
@@ -1571,10 +1571,10 @@ declare const __VLS_export$42: import("vue").DefineComponent<import("vue").Extra
|
|
|
1571
1571
|
class: string;
|
|
1572
1572
|
modelValue: Key | Key[] | undefined;
|
|
1573
1573
|
defaultValue: Key | Key[] | undefined;
|
|
1574
|
-
disabled: boolean | undefined;
|
|
1575
1574
|
open: boolean | undefined;
|
|
1576
1575
|
defaultOpen: boolean;
|
|
1577
1576
|
placeholder: string;
|
|
1577
|
+
disabled: boolean | undefined;
|
|
1578
1578
|
positioning: import("@ark-ui/vue/select").SelectPositioningOptions | undefined;
|
|
1579
1579
|
multiple: boolean;
|
|
1580
1580
|
checkable: boolean;
|
|
@@ -1737,8 +1737,8 @@ declare const __VLS_export$40: import("vue").DefineComponent<__VLS_Props$11, {},
|
|
|
1737
1737
|
}, string, import("vue").PublicProps, Readonly<__VLS_Props$11> & Readonly<{
|
|
1738
1738
|
"onUpdate:modelValue"?: ((value: number[]) => any) | undefined;
|
|
1739
1739
|
}>, {
|
|
1740
|
-
max: number;
|
|
1741
1740
|
min: number;
|
|
1741
|
+
max: number;
|
|
1742
1742
|
step: number;
|
|
1743
1743
|
}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
|
|
1744
1744
|
declare const _default$40: typeof __VLS_export$40;
|
|
@@ -1788,9 +1788,9 @@ declare const __VLS_base$30: import("vue").DefineComponent<import("vue").Extract
|
|
|
1788
1788
|
"onUpdate:checked"?: ((checked: boolean) => any) | undefined;
|
|
1789
1789
|
}>, {
|
|
1790
1790
|
class: string;
|
|
1791
|
+
disabled: boolean;
|
|
1791
1792
|
checked: boolean | undefined;
|
|
1792
1793
|
defaultChecked: boolean;
|
|
1793
|
-
disabled: boolean;
|
|
1794
1794
|
}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
|
|
1795
1795
|
declare const __VLS_export$39: __VLS_WithSlots$30<typeof __VLS_base$30, __VLS_Slots$30>;
|
|
1796
1796
|
declare const _default$42: typeof __VLS_export$39;
|
|
@@ -1955,15 +1955,15 @@ declare const __VLS_export$37: import("vue").DefineComponent<import("vue").Extra
|
|
|
1955
1955
|
"onUpdate:open"?: ((open: boolean) => any) | undefined;
|
|
1956
1956
|
}>, {
|
|
1957
1957
|
class: string;
|
|
1958
|
-
max: string;
|
|
1959
1958
|
modelValue: string | null | undefined;
|
|
1960
1959
|
defaultValue: string;
|
|
1961
1960
|
min: string;
|
|
1961
|
+
max: string;
|
|
1962
1962
|
locale: string;
|
|
1963
|
-
disabled: boolean | undefined;
|
|
1964
1963
|
open: boolean | undefined;
|
|
1965
1964
|
defaultOpen: boolean;
|
|
1966
1965
|
placeholder: string;
|
|
1966
|
+
disabled: boolean | undefined;
|
|
1967
1967
|
invalid: boolean | undefined;
|
|
1968
1968
|
readOnly: boolean | undefined;
|
|
1969
1969
|
closeOnSelect: boolean;
|
|
@@ -2572,11 +2572,11 @@ declare const __VLS_base$24: import("vue").DefineComponent<import("vue").Extract
|
|
|
2572
2572
|
"onUpdate:modelValue"?: ((value: string | null) => any) | undefined;
|
|
2573
2573
|
}>, {
|
|
2574
2574
|
mode: "day" | "month" | "year";
|
|
2575
|
-
max: string;
|
|
2576
2575
|
numOfMonths: number;
|
|
2577
2576
|
modelValue: string | null | undefined;
|
|
2578
2577
|
defaultValue: string;
|
|
2579
2578
|
min: string;
|
|
2579
|
+
max: string;
|
|
2580
2580
|
isDateUnavailable: (date: DateValue) => boolean;
|
|
2581
2581
|
locale: string;
|
|
2582
2582
|
week: boolean;
|
|
@@ -3170,11 +3170,11 @@ declare const __VLS_base$14: import("vue").DefineComponent<import("vue").Extract
|
|
|
3170
3170
|
onComplete?: ((value: string[]) => any) | undefined;
|
|
3171
3171
|
}>, {
|
|
3172
3172
|
class: string;
|
|
3173
|
-
length: number;
|
|
3174
3173
|
type: "numeric" | "alphanumeric" | undefined;
|
|
3175
3174
|
modelValue: string[] | undefined;
|
|
3176
|
-
|
|
3175
|
+
length: number;
|
|
3177
3176
|
placeholder: string;
|
|
3177
|
+
disabled: boolean | undefined;
|
|
3178
3178
|
invalid: boolean | undefined;
|
|
3179
3179
|
otp: boolean | undefined;
|
|
3180
3180
|
mask: boolean | undefined;
|
|
@@ -3407,9 +3407,9 @@ declare const __VLS_base$13: import("vue").DefineComponent<import("vue").Extract
|
|
|
3407
3407
|
}>> & Readonly<{
|
|
3408
3408
|
"onUpdate:open"?: ((open: boolean) => any) | undefined;
|
|
3409
3409
|
}>, {
|
|
3410
|
-
disabled: boolean;
|
|
3411
3410
|
open: boolean | undefined;
|
|
3412
3411
|
defaultOpen: boolean;
|
|
3412
|
+
disabled: boolean;
|
|
3413
3413
|
lazyMount: boolean;
|
|
3414
3414
|
unmountOnExit: boolean;
|
|
3415
3415
|
contentClass: string;
|
package/dist/index.mjs
CHANGED
|
@@ -10161,6 +10161,64 @@ const _sfc_main$41 = /*@__PURE__*/ defineComponent({
|
|
|
10161
10161
|
};
|
|
10162
10162
|
}
|
|
10163
10163
|
});
|
|
10164
|
+
/** 全局幂等标记:Symbol.for 注册表键,抗 HMR 模块重载(同键恒等) */
|
|
10165
|
+
const GUARD_FLAG = Symbol.for("tu-design.raf-clock-guard");
|
|
10166
|
+
const NOOP_HANDLE = Object.freeze({
|
|
10167
|
+
installed: false,
|
|
10168
|
+
driftMs: NaN,
|
|
10169
|
+
restore: () => {}
|
|
10170
|
+
});
|
|
10171
|
+
/**
|
|
10172
|
+
* 安装 rAF 时钟守卫(幂等;同步包装、异步哨兵裁决)。
|
|
10173
|
+
*
|
|
10174
|
+
* 接线点:TuDesignProvider / ToastProvider setup 顶层(mode="none" 跳过)。
|
|
10175
|
+
* 任意环境可安全调用——干净时间线首帧即自恢复,零残留。
|
|
10176
|
+
*
|
|
10177
|
+
* @param win 宿主窗口(DI 入参;缺省全局 window,SSR 环境返回 no-op)
|
|
10178
|
+
* @returns 哨兵裁决后的句柄(幂等重入时返回已存在句柄的裁决)
|
|
10179
|
+
*/
|
|
10180
|
+
function ensureRafClockGuard(win) {
|
|
10181
|
+
const target = win ?? (typeof window !== "undefined" ? window : void 0);
|
|
10182
|
+
if (!target) return Promise.resolve(NOOP_HANDLE);
|
|
10183
|
+
const w = target;
|
|
10184
|
+
const existing = w[GUARD_FLAG];
|
|
10185
|
+
if (existing) return Promise.resolve(existing);
|
|
10186
|
+
const rawRef = w.requestAnimationFrame;
|
|
10187
|
+
const rawRaf = rawRef.bind(w);
|
|
10188
|
+
const perf = w.performance;
|
|
10189
|
+
let state = "probing";
|
|
10190
|
+
let driftMs = NaN;
|
|
10191
|
+
let resolveDecision;
|
|
10192
|
+
const wrapper = (cb) => {
|
|
10193
|
+
return rawRaf((ts) => {
|
|
10194
|
+
if (state === "probing") {
|
|
10195
|
+
driftMs = Math.round(Math.abs(ts - perf.now()));
|
|
10196
|
+
state = driftMs >= 100 ? "armed" : "clean";
|
|
10197
|
+
if (state === "clean") w.requestAnimationFrame = rawRef;
|
|
10198
|
+
else if (import.meta.env.DEV) console.info(`[tu-design] 检测到 rAF 时间线漂移 ${driftMs}ms(沙箱 rAF/performance 时钟混用),已安装时钟归一化守卫,回调时间戳改传本地 performance.now()。机制详注 overlay-shared/rafClock.ts(issue #6)。`);
|
|
10199
|
+
resolveDecision(handle);
|
|
10200
|
+
}
|
|
10201
|
+
cb(state === "armed" ? perf.now() : ts);
|
|
10202
|
+
});
|
|
10203
|
+
};
|
|
10204
|
+
const handle = {
|
|
10205
|
+
get installed() {
|
|
10206
|
+
return state === "armed";
|
|
10207
|
+
},
|
|
10208
|
+
get driftMs() {
|
|
10209
|
+
return driftMs;
|
|
10210
|
+
},
|
|
10211
|
+
restore() {
|
|
10212
|
+
w.requestAnimationFrame = rawRef;
|
|
10213
|
+
}
|
|
10214
|
+
};
|
|
10215
|
+
w[GUARD_FLAG] = handle;
|
|
10216
|
+
w.requestAnimationFrame = wrapper;
|
|
10217
|
+
wrapper(() => {});
|
|
10218
|
+
return new Promise((resolve) => {
|
|
10219
|
+
resolveDecision = resolve;
|
|
10220
|
+
});
|
|
10221
|
+
}
|
|
10164
10222
|
// src/components/toast/useToast.ts
|
|
10165
10223
|
/** Provider 缺省配置(与 Provider props 默认值保持一致) */
|
|
10166
10224
|
const DEFAULTS = {
|
|
@@ -10358,6 +10416,9 @@ const _hoisted_7 = { class: "flex shrink-0 items-center gap-1" };
|
|
|
10358
10416
|
*
|
|
10359
10417
|
* 兼容出口:新接入推荐 `<TuDesignProvider :toast="{...}">`(内部组合本组件)。
|
|
10360
10418
|
* 两者同时挂载即双宿主,dev 告警且后挂载者配置生效,请二选一。
|
|
10419
|
+
*
|
|
10420
|
+
* rAF 时钟守卫:独立挂载路径兜底(组合挂载时 TuDesignProvider 已装,幂等无害);
|
|
10421
|
+
* mode="none"(经 inject 继承)显式跳过,其余哨兵门控(详注 overlay-shared/rafClock.ts)。
|
|
10361
10422
|
*/
|
|
10362
10423
|
const rootBase = "flex w-[22rem] max-w-[calc(100vw-2rem)] items-start gap-3 rounded-md border p-4 shadow-lg duration-200 data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=open]:fade-in-0 data-[state=closed]:fade-out-0 data-[placement*=top]:data-[state=open]:slide-in-from-top-2 data-[placement*=top]:data-[state=closed]:slide-out-to-top-2 data-[placement*=bottom]:data-[state=open]:slide-in-from-bottom-2 data-[placement*=bottom]:data-[state=closed]:slide-out-to-bottom-2";
|
|
10363
10424
|
const _sfc_main$48 = /*@__PURE__*/ defineComponent({
|
|
@@ -10386,6 +10447,7 @@ const _sfc_main$48 = /*@__PURE__*/ defineComponent({
|
|
|
10386
10447
|
duration: props.duration,
|
|
10387
10448
|
max: props.max
|
|
10388
10449
|
}));
|
|
10450
|
+
if (useTuProvider().mode !== "none") ensureRafClockGuard();
|
|
10389
10451
|
onMounted(() => __setToastMounted(true));
|
|
10390
10452
|
onBeforeUnmount(() => __setToastMounted(false));
|
|
10391
10453
|
/** 语义 type → token 样式(tokens.css 的 success/warning/info/destructive) */
|
|
@@ -11111,8 +11173,11 @@ const timelineDotVariants = cva("relative z-10 mt-1 block shrink-0 rounded-full"
|
|
|
11111
11173
|
* 与独立挂载 ToastProvider 二选一,双挂载 dev 告警。
|
|
11112
11174
|
* 3. `:overlay`:滚动锁契约(present = enabled,语义 B:仅锁禁用拓扑生效);
|
|
11113
11175
|
* 经 provide 快照透传,消费判定见 overlayContract()。非锁禁用拓扑下 dev 告警。
|
|
11176
|
+
* 4. rAF 时钟守卫(无 prop,哨兵自动):沙箱时钟混用家族修复(issue #6,
|
|
11177
|
+
* 机制详注 overlay-shared/rafClock.ts);mode="none" 显式关闭,其余 mode
|
|
11178
|
+
* 哨兵命中才安装(幂等,干净环境首帧自恢复零残留)。
|
|
11114
11179
|
*
|
|
11115
|
-
*
|
|
11180
|
+
* 四者均为 mount-time 契约(provide 快照 / ToastProvider 挂载时消费),
|
|
11116
11181
|
* 动态变更用 :key 重挂载。须包住子应用根(inject 沿逻辑树,Teleport 子树同样命中;
|
|
11117
11182
|
* 组件挂载在 Provider 子树之外时回落 auto 兜底)。
|
|
11118
11183
|
*/
|
|
@@ -11142,6 +11207,7 @@ const _sfc_main$51 = /*@__PURE__*/ defineComponent({
|
|
|
11142
11207
|
mode: props.mode,
|
|
11143
11208
|
overlay: props.overlay
|
|
11144
11209
|
});
|
|
11210
|
+
if (props.mode !== "none") ensureRafClockGuard();
|
|
11145
11211
|
if (import.meta.env.DEV && props.overlay && preventScrollOverride(props.mode) !== false) console.warn("[tu-design] TuDesignProvider :overlay 仅锁禁用拓扑生效(语义 B):当前 mode 下滚动锁未被禁用,overlay 契约不会被消费。");
|
|
11146
11212
|
return (_ctx, _cache) => {
|
|
11147
11213
|
return openBlock(), createElementBlock(Fragment, null, [
|
|
@@ -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.
|
|
4
|
+
"version": "0.5.13",
|
|
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"],
|
|
@@ -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.
|
|
4
|
+
"version": "0.5.13",
|
|
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.
|
|
4
|
+
"version": "0.5.13",
|
|
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.
|
|
4
|
+
"version": "0.5.13",
|
|
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": "context-menu",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.13",
|
|
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.
|
|
4
|
+
"version": "0.5.13",
|
|
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.
|
|
4
|
+
"version": "0.5.13",
|
|
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.
|
|
4
|
+
"version": "0.5.13",
|
|
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.
|
|
4
|
+
"version": "0.5.13",
|
|
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.
|
|
4
|
+
"version": "0.5.13",
|
|
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"],
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
|
|
3
3
|
"name": "drawer",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.13",
|
|
5
5
|
"type": "registry:ui",
|
|
6
6
|
"description": "抽屉单组件:从四方向滑出的侧边/顶底面板,#trigger 放触发元素,title/description 传文案,#footer 注入 close 关闭;基于 Ark UI Drawer 原语,进出场动画随 placement 方向自适应,含焦点圈定、Escape/遮罩关闭,支持 v-model:open。",
|
|
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": "dropdown-menu",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.13",
|
|
5
5
|
"type": "registry:ui",
|
|
6
6
|
"description": "下拉菜单:单组件模式,items 描述菜单项(含分组/标题/分隔线,支持嵌套),内置键盘导航与选中回调,默认插槽为触发元素(asChild 透传)。",
|
|
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": "form-render",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.13",
|
|
5
5
|
"type": "registry:ui",
|
|
6
6
|
"description": "配置驱动表单渲染器:defineForm 聚合 TanStack Form 实例与字段配置,柯里化 widget DSL 声明控件,Tailwind 栅格自适应布局,复用 Form 家族 aria 接线。",
|
|
7
7
|
"registryDependencies": [
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
|
|
3
3
|
"name": "form",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.13",
|
|
5
5
|
"type": "registry:ui",
|
|
6
6
|
"description": "表单状态与校验:基于 TanStack Form,配合 Valibot(Standard Schema)声明式校验,aria 自动接线。",
|
|
7
7
|
"registryDependencies": ["utils", "input", "button", "label"],
|
|
@@ -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.13",
|
|
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.13",
|
|
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.13",
|
|
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.13",
|
|
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",
|