@chenzy-design/svelte 0.1.0

package/dist/modal/command.svelte.js

@@ -0,0 +1,72 @@
+/**
+ * modal — 命令式 modal.confirm/info/success/warning/error 入口。
+ * 每次调用 mount 一个独立 ConfirmModal 到 body 的临时 host，关闭后 unmount 并移除。
+ * z-index 随打开计数递增以支持堆叠。复用基础 Modal（焦点捕获/滚动锁/Esc）。
+ * `.svelte.ts` 以使用 $state props 容器支持 update。
+ * See specs/components/feedback/Modal.spec.md（命令式工厂）。
+ */
+import { acquireZIndex } from './z-stack.js';
+// Module-level registry of all active handles for destroyAll()
+const activeHandles = new Set();
+function noop() {
+    return { destroy: () => { }, update: () => { } };
+}
+function spawn(type, config) {
+    if (typeof document === 'undefined')
+        return noop();
+    const { zIndex, release } = acquireZIndex();
+    const host = document.createElement('div');
+    host.className = 'cd-modal-command-host';
+    document.body.appendChild(host);
+    let unmounted = false;
+    let api = null;
+    function cleanup() {
+        if (unmounted)
+            return;
+        unmounted = true;
+        release();
+        api?.destroy();
+        if (host.parentNode)
+            host.parentNode.removeChild(host);
+        activeHandles.delete(handle);
+    }
+    void (async () => {
+        const { mount, unmount } = await import('svelte');
+        const { default: ConfirmModal } = await import('./ConfirmModal.svelte');
+        if (unmounted) {
+            if (host.parentNode)
+                host.parentNode.removeChild(host);
+            return;
+        }
+        const props = $state({
+            type,
+            ...config,
+            zIndex,
+            onClose: () => cleanup(),
+        });
+        const instance = mount(ConfirmModal, { target: host, props });
+        api = {
+            destroy: () => unmount(instance, { outro: false }),
+            update: (p) => Object.assign(props, p),
+        };
+    })();
+    const handle = {
+        destroy: cleanup,
+        update: (next) => api?.update(next),
+    };
+    activeHandles.add(handle);
+    return handle;
+}
+export function destroyAll() {
+    for (const handle of [...activeHandles]) {
+        handle.destroy();
+    }
+}
+export const modal = {
+    confirm: (config) => spawn('confirm', { showCancel: true, ...config }),
+    info: (config) => spawn('info', config),
+    success: (config) => spawn('success', config),
+    warning: (config) => spawn('warning', config),
+    error: (config) => spawn('error', config),
+    destroyAll,
+};

package/dist/modal/index.d.ts

@@ -0,0 +1,17 @@
+import ModalComponent from './Modal.svelte';
+import type { ModalCommandConfig, ModalCommandHandle } from './command.svelte.js';
+type ModalCommands = {
+    confirm: (config: ModalCommandConfig) => ModalCommandHandle;
+    info: (config: ModalCommandConfig) => ModalCommandHandle;
+    success: (config: ModalCommandConfig) => ModalCommandHandle;
+    warning: (config: ModalCommandConfig) => ModalCommandHandle;
+    error: (config: ModalCommandConfig) => ModalCommandHandle;
+};
+/**
+ * Modal —— 声明式组件 + 命令式工厂（Modal.confirm/info/success/warning/error）。
+ * 同时保留独立的 `modal` 对象供解构使用；两者共享同一实现。
+ */
+export declare const Modal: typeof ModalComponent & ModalCommands;
+export { meta as modalMeta } from './meta.js';
+export { modal, type ModalCommandConfig, type ModalCommandHandle, } from './command.svelte.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/modal/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/modal/index.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,MAAM,gBAAgB,CAAC;AAE5C,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAElF,KAAK,aAAa,GAAG;IACnB,OAAO,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,kBAAkB,CAAC;IAC5D,IAAI,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,kBAAkB,CAAC;IACzD,OAAO,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,kBAAkB,CAAC;IAC5D,OAAO,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,kBAAkB,CAAC;IAC5D,KAAK,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,kBAAkB,CAAC;CAC3D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,KAAK,EAAE,OAAO,cAAc,GAAG,aAM1C,CAAC;AAEH,OAAO,EAAE,IAAI,IAAI,SAAS,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EACL,KAAK,EACL,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,GACxB,MAAM,qBAAqB,CAAC"}

package/dist/modal/index.js

@@ -0,0 +1,15 @@
+import ModalComponent from './Modal.svelte';
+import { modal } from './command.svelte.js';
+/**
+ * Modal —— 声明式组件 + 命令式工厂（Modal.confirm/info/success/warning/error）。
+ * 同时保留独立的 `modal` 对象供解构使用；两者共享同一实现。
+ */
+export const Modal = Object.assign(ModalComponent, {
+    confirm: modal.confirm,
+    info: modal.info,
+    success: modal.success,
+    warning: modal.warning,
+    error: modal.error,
+});
+export { meta as modalMeta } from './meta.js';
+export { modal, } from './command.svelte.js';

package/dist/modal/meta.d.ts

@@ -0,0 +1,236 @@
+/**
+ * Machine-readable component metadata for AI/docs consumption.
+ * Modal — see specs/components/feedback/Modal.spec.md
+ */
+export declare const meta: {
+    readonly name: "Modal";
+    readonly category: "feedback";
+    readonly description: "模态对话框：fixed 遮罩 + 面板，portal 到 body（或 getContainer）脱离父层叠上下文，role=dialog aria-modal；useFocusTrap 焦点捕获与归还、Esc/遮罩点击关闭（受 keyboard/maskClosable 控制）、useScrollLock 锁背景滚动；头/体/尾结构，ok/cancel 默认按钮可换自定义尾部，danger okType；reduced-motion 关闭过渡。受控 open 不回写，仅 onOpenChange/onCancel 通知。destroyOnClose 关闭即卸载内容、重开重建（默认 false 保留 DOM）。draggable 按住标题栏拖动面板（偏移派生 transform 叠加定位，重开重置，pointer 事件绑 window）。堆叠 z-index 由模块级计数器分配（声明式与命令式共享，后开者在上、关闭回收）。命令式工厂 Modal.confirm/info/success/warning/error（亦可解构 modal）：mount 到 body 临时 host、async onOk 自动 loading、返回 { destroy, update }。";
+    readonly exports: readonly ["Modal", "modal"];
+    readonly props: readonly [{
+        readonly name: "open";
+        readonly type: "boolean";
+        readonly default: "undefined";
+        readonly desc: "受控显隐；受控时不回写";
+    }, {
+        readonly name: "title";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "标题文案";
+    }, {
+        readonly name: "titleSnippet";
+        readonly type: "Snippet";
+        readonly default: "undefined";
+        readonly desc: "自定义标题，覆盖 title";
+    }, {
+        readonly name: "width";
+        readonly type: "number|string";
+        readonly default: "448";
+        readonly desc: "面板宽度";
+    }, {
+        readonly name: "centered";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "垂直居中（否则距顶）";
+    }, {
+        readonly name: "closable";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "右上角关闭按钮";
+    }, {
+        readonly name: "maskClosable";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "点遮罩关闭";
+    }, {
+        readonly name: "keyboard";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "Esc 关闭";
+    }, {
+        readonly name: "draggable";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "按住标题栏拖动面板（偏移叠加在定位上，重开重置）；鼠标增强不影响键盘/焦点";
+    }, {
+        readonly name: "confirmLoading";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "确认按钮 loading 态";
+    }, {
+        readonly name: "okText";
+        readonly type: "string";
+        readonly default: "'确定'";
+    }, {
+        readonly name: "cancelText";
+        readonly type: "string";
+        readonly default: "'取消'";
+    }, {
+        readonly name: "okType";
+        readonly type: "'primary'|'danger'";
+        readonly default: "'primary'";
+        readonly desc: "确认按钮类型";
+    }, {
+        readonly name: "destroyOnClose";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "关闭即卸载内部内容（{#if} 卸载），重开重建；默认保留 DOM 仅隐藏";
+    }, {
+        readonly name: "getContainer";
+        readonly type: "() => HTMLElement | null";
+        readonly default: "undefined";
+        readonly desc: "Portal 容器，缺省 document.body";
+    }, {
+        readonly name: "footer";
+        readonly type: "Snippet<[{ ok; cancel }]>|null";
+        readonly default: "undefined";
+        readonly desc: "null 隐藏默认按钮；snippet 自定义尾部";
+    }, {
+        readonly name: "children";
+        readonly type: "Snippet";
+        readonly default: "undefined";
+        readonly desc: "内容主体";
+    }, {
+        readonly name: "ariaLabel";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "无 title 时的 aria-label";
+    }, {
+        readonly name: "onOk";
+        readonly type: "() => void";
+        readonly default: "undefined";
+    }, {
+        readonly name: "onCancel";
+        readonly type: "() => void";
+        readonly default: "undefined";
+    }, {
+        readonly name: "onOpenChange";
+        readonly type: "(open: boolean) => void";
+        readonly default: "undefined";
+    }, {
+        readonly name: "onAfterClose";
+        readonly type: "() => void";
+        readonly default: "undefined";
+        readonly desc: "关闭过渡结束触发";
+    }, {
+        readonly name: "okButtonProps";
+        readonly type: "Record<string, unknown>";
+        readonly default: "undefined";
+        readonly desc: "透传给确定按钮的额外 props（如 disabled、size 等）";
+    }, {
+        readonly name: "cancelButtonProps";
+        readonly type: "Record<string, unknown>";
+        readonly default: "undefined";
+        readonly desc: "透传给取消按钮的额外 props";
+    }, {
+        readonly name: "hasCancel";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "是否显示取消按钮";
+    }, {
+        readonly name: "size";
+        readonly type: "'small'|'medium'|'large'|'full-width'";
+        readonly default: "undefined";
+        readonly desc: "预设宽度枚举（small=480px, medium=600px, large=800px, full-width=100vw），优先级低于 width";
+    }, {
+        readonly name: "fullScreen";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "全屏模式";
+    }, {
+        readonly name: "keepDOM";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "关闭时保留 DOM（display:none 隐藏），与 destroyOnClose 反义";
+    }, {
+        readonly name: "lazyRender";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "配合 keepDOM 的懒挂载：true 时首次打开前不渲染内容";
+    }, {
+        readonly name: "bodyStyle";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "内容区内联 style 字符串";
+    }, {
+        readonly name: "maskStyle";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "遮罩层内联 style 字符串";
+    }, {
+        readonly name: "height";
+        readonly type: "number|string";
+        readonly default: "undefined";
+        readonly desc: "Modal 高度";
+    }, {
+        readonly name: "footerFill";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "底部按钮撑满宽度";
+    }, {
+        readonly name: "modalContentClass";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "内容区域额外 class";
+    }, {
+        readonly name: "closeIcon";
+        readonly type: "Snippet";
+        readonly default: "undefined";
+        readonly desc: "自定义关闭图标";
+    }, {
+        readonly name: "mask";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "是否显示遮罩";
+    }];
+    readonly events: readonly [{
+        readonly name: "onOk";
+        readonly desc: "确认按钮点击（非受控自动关闭）";
+    }, {
+        readonly name: "onCancel";
+        readonly desc: "取消/关闭按钮/遮罩/Esc 关闭";
+    }, {
+        readonly name: "onOpenChange";
+        readonly desc: "显隐变化通知";
+    }, {
+        readonly name: "onAfterClose";
+        readonly desc: "关闭过渡结束";
+    }];
+    readonly slots: readonly [{
+        readonly name: "children";
+        readonly desc: "内容主体";
+    }, {
+        readonly name: "titleSnippet";
+        readonly desc: "自定义标题";
+    }, {
+        readonly name: "footer";
+        readonly desc: "自定义尾部（接收 { ok, cancel }）";
+    }, {
+        readonly name: "closeIcon";
+        readonly desc: "自定义关闭图标";
+    }];
+    readonly a11y: {
+        readonly hasRole: true;
+        readonly focusable: true;
+        readonly note: "role=dialog + aria-modal=true；有 title 用 aria-labelledby，无则 aria-label；useFocusTrap 捕获 Tab 焦点并在关闭时归还触发元素；Esc 关闭受 keyboard 控制；useScrollLock 锁背景滚动；关闭按钮 aria-label「关闭」。";
+    };
+    readonly tokens: readonly ["--cd-modal-radius", "--cd-modal-bg", "--cd-modal-shadow", "--cd-modal-mask-bg", "--cd-modal-padding", "--cd-modal-header-gap", "--cd-modal-footer-gap", "--cd-modal-title-color", "--cd-modal-title-size", "--cd-modal-body-color", "--cd-modal-close-color", "--cd-modal-close-hover-bg", "--cd-modal-z", "--cd-modal-motion-duration"];
+    readonly responsive: false;
+    readonly examples: readonly [{
+        readonly title: "基础确认框";
+        readonly code: "<Modal open={visible} title=\"提示\" onOk={() => (visible = false)} onCancel={() => (visible = false)}>确认操作？</Modal>";
+    }, {
+        readonly title: "自定义尾部";
+        readonly code: "<Modal open={visible} title=\"标题\">\n  内容\n  {#snippet footer({ cancel })}<Button onclick={cancel}>知道了</Button>{/snippet}\n</Modal>";
+    }, {
+        readonly title: "danger 确认";
+        readonly code: "<Modal open={visible} title=\"删除\" okType=\"danger\" okText=\"删除\" onOk={remove}>不可恢复，确定删除？</Modal>";
+    }, {
+        readonly title: "命令式确认（异步 onOk 自动 loading）";
+        readonly code: "Modal.confirm({ title: '确认操作', content: '确定执行？', onOk: () => fetch('/api/do') });";
+    }, {
+        readonly title: "destroyOnClose 重开重建";
+        readonly code: "<Modal open={visible} title=\"表单\" destroyOnClose>...每次重开重置内部状态...</Modal>";
+    }];
+};
+//# sourceMappingURL=meta.d.ts.map

package/dist/modal/meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../src/modal/meta.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgKP,CAAC"}

package/dist/modal/meta.js

@@ -0,0 +1,164 @@
+/**
+ * Machine-readable component metadata for AI/docs consumption.
+ * Modal — see specs/components/feedback/Modal.spec.md
+ */
+export const meta = {
+    name: 'Modal',
+    category: 'feedback',
+    description: '模态对话框：fixed 遮罩 + 面板，portal 到 body（或 getContainer）脱离父层叠上下文，role=dialog aria-modal；useFocusTrap 焦点捕获与归还、Esc/遮罩点击关闭（受 keyboard/maskClosable 控制）、useScrollLock 锁背景滚动；头/体/尾结构，ok/cancel 默认按钮可换自定义尾部，danger okType；reduced-motion 关闭过渡。受控 open 不回写，仅 onOpenChange/onCancel 通知。destroyOnClose 关闭即卸载内容、重开重建（默认 false 保留 DOM）。draggable 按住标题栏拖动面板（偏移派生 transform 叠加定位，重开重置，pointer 事件绑 window）。堆叠 z-index 由模块级计数器分配（声明式与命令式共享，后开者在上、关闭回收）。命令式工厂 Modal.confirm/info/success/warning/error（亦可解构 modal）：mount 到 body 临时 host、async onOk 自动 loading、返回 { destroy, update }。',
+    exports: ['Modal', 'modal'],
+    props: [
+        { name: 'open', type: 'boolean', default: 'undefined', desc: '受控显隐；受控时不回写' },
+        { name: 'title', type: 'string', default: 'undefined', desc: '标题文案' },
+        {
+            name: 'titleSnippet',
+            type: 'Snippet',
+            default: 'undefined',
+            desc: '自定义标题，覆盖 title',
+        },
+        { name: 'width', type: 'number|string', default: '448', desc: '面板宽度' },
+        { name: 'centered', type: 'boolean', default: 'false', desc: '垂直居中（否则距顶）' },
+        { name: 'closable', type: 'boolean', default: 'true', desc: '右上角关闭按钮' },
+        { name: 'maskClosable', type: 'boolean', default: 'true', desc: '点遮罩关闭' },
+        { name: 'keyboard', type: 'boolean', default: 'true', desc: 'Esc 关闭' },
+        {
+            name: 'draggable',
+            type: 'boolean',
+            default: 'false',
+            desc: '按住标题栏拖动面板（偏移叠加在定位上，重开重置）；鼠标增强不影响键盘/焦点',
+        },
+        {
+            name: 'confirmLoading',
+            type: 'boolean',
+            default: 'false',
+            desc: '确认按钮 loading 态',
+        },
+        { name: 'okText', type: 'string', default: "'确定'" },
+        { name: 'cancelText', type: 'string', default: "'取消'" },
+        { name: 'okType', type: "'primary'|'danger'", default: "'primary'", desc: '确认按钮类型' },
+        {
+            name: 'destroyOnClose',
+            type: 'boolean',
+            default: 'false',
+            desc: '关闭即卸载内部内容（{#if} 卸载），重开重建；默认保留 DOM 仅隐藏',
+        },
+        {
+            name: 'getContainer',
+            type: '() => HTMLElement | null',
+            default: 'undefined',
+            desc: 'Portal 容器，缺省 document.body',
+        },
+        {
+            name: 'footer',
+            type: 'Snippet<[{ ok; cancel }]>|null',
+            default: 'undefined',
+            desc: 'null 隐藏默认按钮；snippet 自定义尾部',
+        },
+        { name: 'children', type: 'Snippet', default: 'undefined', desc: '内容主体' },
+        { name: 'ariaLabel', type: 'string', default: 'undefined', desc: '无 title 时的 aria-label' },
+        { name: 'onOk', type: '() => void', default: 'undefined' },
+        { name: 'onCancel', type: '() => void', default: 'undefined' },
+        { name: 'onOpenChange', type: '(open: boolean) => void', default: 'undefined' },
+        { name: 'onAfterClose', type: '() => void', default: 'undefined', desc: '关闭过渡结束触发' },
+        {
+            name: 'okButtonProps',
+            type: 'Record<string, unknown>',
+            default: 'undefined',
+            desc: '透传给确定按钮的额外 props（如 disabled、size 等）',
+        },
+        {
+            name: 'cancelButtonProps',
+            type: 'Record<string, unknown>',
+            default: 'undefined',
+            desc: '透传给取消按钮的额外 props',
+        },
+        { name: 'hasCancel', type: 'boolean', default: 'true', desc: '是否显示取消按钮' },
+        {
+            name: 'size',
+            type: "'small'|'medium'|'large'|'full-width'",
+            default: 'undefined',
+            desc: '预设宽度枚举（small=480px, medium=600px, large=800px, full-width=100vw），优先级低于 width',
+        },
+        { name: 'fullScreen', type: 'boolean', default: 'false', desc: '全屏模式' },
+        {
+            name: 'keepDOM',
+            type: 'boolean',
+            default: 'false',
+            desc: '关闭时保留 DOM（display:none 隐藏），与 destroyOnClose 反义',
+        },
+        {
+            name: 'lazyRender',
+            type: 'boolean',
+            default: 'true',
+            desc: '配合 keepDOM 的懒挂载：true 时首次打开前不渲染内容',
+        },
+        { name: 'bodyStyle', type: 'string', default: 'undefined', desc: '内容区内联 style 字符串' },
+        { name: 'maskStyle', type: 'string', default: 'undefined', desc: '遮罩层内联 style 字符串' },
+        { name: 'height', type: 'number|string', default: 'undefined', desc: 'Modal 高度' },
+        { name: 'footerFill', type: 'boolean', default: 'false', desc: '底部按钮撑满宽度' },
+        {
+            name: 'modalContentClass',
+            type: 'string',
+            default: 'undefined',
+            desc: '内容区域额外 class',
+        },
+        { name: 'closeIcon', type: 'Snippet', default: 'undefined', desc: '自定义关闭图标' },
+        { name: 'mask', type: 'boolean', default: 'true', desc: '是否显示遮罩' },
+    ],
+    events: [
+        { name: 'onOk', desc: '确认按钮点击（非受控自动关闭）' },
+        { name: 'onCancel', desc: '取消/关闭按钮/遮罩/Esc 关闭' },
+        { name: 'onOpenChange', desc: '显隐变化通知' },
+        { name: 'onAfterClose', desc: '关闭过渡结束' },
+    ],
+    slots: [
+        { name: 'children', desc: '内容主体' },
+        { name: 'titleSnippet', desc: '自定义标题' },
+        { name: 'footer', desc: '自定义尾部（接收 { ok, cancel }）' },
+        { name: 'closeIcon', desc: '自定义关闭图标' },
+    ],
+    a11y: {
+        hasRole: true,
+        focusable: true,
+        note: 'role=dialog + aria-modal=true；有 title 用 aria-labelledby，无则 aria-label；useFocusTrap 捕获 Tab 焦点并在关闭时归还触发元素；Esc 关闭受 keyboard 控制；useScrollLock 锁背景滚动；关闭按钮 aria-label「关闭」。',
+    },
+    tokens: [
+        '--cd-modal-radius',
+        '--cd-modal-bg',
+        '--cd-modal-shadow',
+        '--cd-modal-mask-bg',
+        '--cd-modal-padding',
+        '--cd-modal-header-gap',
+        '--cd-modal-footer-gap',
+        '--cd-modal-title-color',
+        '--cd-modal-title-size',
+        '--cd-modal-body-color',
+        '--cd-modal-close-color',
+        '--cd-modal-close-hover-bg',
+        '--cd-modal-z',
+        '--cd-modal-motion-duration',
+    ],
+    responsive: false,
+    examples: [
+        {
+            title: '基础确认框',
+            code: '<Modal open={visible} title="提示" onOk={() => (visible = false)} onCancel={() => (visible = false)}>确认操作？</Modal>',
+        },
+        {
+            title: '自定义尾部',
+            code: '<Modal open={visible} title="标题">\n  内容\n  {#snippet footer({ cancel })}<Button onclick={cancel}>知道了</Button>{/snippet}\n</Modal>',
+        },
+        {
+            title: 'danger 确认',
+            code: '<Modal open={visible} title="删除" okType="danger" okText="删除" onOk={remove}>不可恢复，确定删除？</Modal>',
+        },
+        {
+            title: '命令式确认（异步 onOk 自动 loading）',
+            code: "Modal.confirm({ title: '确认操作', content: '确定执行？', onOk: () => fetch('/api/do') });",
+        },
+        {
+            title: 'destroyOnClose 重开重建',
+            code: '<Modal open={visible} title="表单" destroyOnClose>...每次重开重置内部状态...</Modal>',
+        },
+    ],
+};

package/dist/modal/z-stack.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 模块级 z-index 堆叠管理：多个 Modal（声明式 <Modal> + 命令式 modal.confirm）
+ * 共享同一计数器，后开者在上；关闭时回收，避免无限增长。
+ * 用递增整数（不用 Math.random/Date.now，红线 #3）。
+ */
+/** 申请一个堆叠层级，返回 z-index 与回收函数。回收幂等。 */
+export declare function acquireZIndex(): {
+    zIndex: number;
+    release: () => void;
+};
+//# sourceMappingURL=z-stack.d.ts.map

package/dist/modal/z-stack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"z-stack.d.ts","sourceRoot":"","sources":["../../src/modal/z-stack.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,sCAAsC;AACtC,wBAAgB,aAAa,IAAI;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CAYvE"}

package/dist/modal/z-stack.js

@@ -0,0 +1,24 @@
+/**
+ * 模块级 z-index 堆叠管理：多个 Modal（声明式 <Modal> + 命令式 modal.confirm）
+ * 共享同一计数器，后开者在上；关闭时回收，避免无限增长。
+ * 用递增整数（不用 Math.random/Date.now，红线 #3）。
+ */
+// 与 --cd-modal-z token 基线一致；每开一个 +10，给遮罩/面板留间隙。
+const Z_BASE = 1000;
+const STEP = 10;
+let counter = 0;
+/** 申请一个堆叠层级，返回 z-index 与回收函数。回收幂等。 */
+export function acquireZIndex() {
+    counter += 1;
+    const zIndex = Z_BASE + counter * STEP;
+    let released = false;
+    return {
+        zIndex,
+        release() {
+            if (released)
+                return;
+            released = true;
+            counter = Math.max(0, counter - 1);
+        },
+    };
+}