@chenzy-design/svelte 0.3.1 → 0.4.1

package/dist/side-sheet/SideSheet.svelte.d.ts

@@ -1,76 +1,63 @@
 import type { Snippet } from 'svelte';
 type Placement = 'left' | 'right' | 'top' | 'bottom';
-type Size = 'small' | 'default' | 'large';
-type Reason = 'esc' | 'mask' | 'outside' | 'closeButton' | 'programmatic';
+type Size = 'small' | 'medium' | 'large';
 interface Props {
-    open?: boolean;
+    /** 面板是否可见（受控；受控时不回写）。对齐 Semi visible。 */
+    visible?: boolean;
+    /** 滑出位置，支持 top/bottom/left/right。对齐 Semi placement。 */
     placement?: Placement;
+    /** 尺寸：small(448)/medium(684)/large(920)，仅 left/right 生效。对齐 Semi size。 */
     size?: Size;
+    /** 宽度，位置为 left/right 时生效。对齐 Semi width（默认 448）。 */
     width?: number | string;
+    /** 高度，位置为 top/bottom 时生效。对齐 Semi height（默认 400）。 */
     height?: number | string;
+    /** 标题（string）。对齐 Semi title。 */
     title?: string;
-    /** 自定义标题区，覆盖 title prop。 */
+    /** 自定义标题区（Snippet），覆盖 title。对齐 Semi title(ReactNode)。 */
     titleSnippet?: Snippet;
-    /** Header 右侧额外操作（关闭按钮之前）。 */
-    headerExtra?: Snippet;
-    /** 自定义关闭图标。 */
-    closeIcon?: Snippet;
+    /** 是否显示右上角关闭按钮。对齐 Semi closable。 */
+    closable?: boolean;
+    /** 自定义关闭图标（Snippet）。传 null 不显示图标。对齐 Semi closeIcon。 */
+    closeIcon?: Snippet | null;
+    /** 是否显示遮罩；false 时允许操作外部区域。对齐 Semi mask。 */
     mask?: boolean;
+    /** 点击遮罩是否关闭。对齐 Semi maskClosable。 */
     maskClosable?: boolean;
-    /** mask=false 时点击面板外部是否关闭。默认 false。 */
-    outsideClosable?: boolean;
+    /** Esc 是否关闭。对齐 Semi closeOnEsc（默认 false）。 */
     closeOnEsc?: boolean;
-    closable?: boolean;
-    /** 首次打开前是否惰性挂载内容。默认 true。 */
-    lazyMount?: boolean;
-    /** keepDOM=false 等价于 lazyMount=true 的反义（保留 DOM）。lazyMount 优先。 */
+    /** 关闭后是否保留内部组件不销毁。对齐 Semi keepDOM。 */
     keepDOM?: boolean;
-    /** 关闭后是否销毁内部内容（释放资源）。默认 false。 */
-    destroyOnClose?: boolean;
-    /** Portal 挂载容器，缺省 document.body。 */
-    getContainer?: () => HTMLElement | null;
-    zIndex?: number;
-    /** 强制不锁背景滚动（即便 mask=true）。 */
-    disableScrollLock?: boolean;
-    /** 打开时给 body 加 overflow:hidden 防背景滚动。默认 true。false 等价于 disableScrollLock=true。 */
+    /** 渲染在 body 层时是否禁止 body 滚动（overflow:hidden）。对齐 Semi disableScroll。 */
     disableScroll?: boolean;
-    /** 关闭后焦点返回目标，缺省为打开时的触发元素。 */
-    returnFocusTo?: HTMLElement | (() => HTMLElement | null) | null;
-    /** 关闭进出动效（独立于 reduced-motion）。 */
-    motionDisabled?: boolean;
-    /** 是否启用动画过渡。false 等价于 motionDisabled=true。默认 true。 */
+    /** 指定父级 DOM，弹层渲染至该 DOM。对齐 Semi getPopupContainer。 */
+    getPopupContainer?: () => HTMLElement | null;
+    /** 弹层 z-index。对齐 Semi zIndex（默认 1000）。 */
+    zIndex?: number;
+    /** 是否允许动画。对齐 Semi motion。 */
     motion?: boolean;
-    /** Header 区域 style 字符串。 */
-    headerStyle?: string;
-    /** 内容区域 style 字符串。 */
+    /** 面板根内联样式。对齐 Semi style。 */
+    style?: string;
+    /** 内容区域内联样式。对齐 Semi bodyStyle。 */
     bodyStyle?: string;
-    /** 遮罩 style 字符串。 */
+    /** Header 区域内联样式。对齐 Semi headerStyle。 */
+    headerStyle?: string;
+    /** 遮罩内联样式。对齐 Semi maskStyle。 */
     maskStyle?: string;
-    /** Footer 操作区；提供 close() 以便按钮关闭面板。未提供不渲染。 */
+    /** 底部区域（Snippet），提供 close() 关闭面板。对齐 Semi footer(ReactNode)。 */
     footer?: Snippet<[{
         close: () => void;
     }]> | null;
+    /** 主内容区（可滚动）。对齐 Semi children。 */
     children?: Snippet;
-    /** 无可见标题时的 aria-label 兜底。 */
+    /** 无可见标题时的 aria-label。对齐 Semi aria-label。 */
     ariaLabel?: string;
+    /** 根元素自定义类名。对齐 Semi className。 */
     class?: string;
-    bodyClass?: string;
-    maskClass?: string;
-    /** 显隐意图变化（受控，需外部回写 open）。 */
-    onOpenChange?: (e: {
-        open: boolean;
-        reason: Reason;
-    }) => void;
-    /** 进入动效结束、内容完全可见后触发。 */
-    onAfterOpen?: () => void;
-    /** 退出动效结束、DOM 卸载（如适用）后触发。 */
-    onAfterClose?: () => void;
-    /** 动画结束后（入场或出场）触发，isVisible 为当前可见状态。 */
+    /** 面板展示/隐藏动画结束触发。对齐 Semi afterVisibleChange。 */
     afterVisibleChange?: (isVisible: boolean) => void;
-    /** 用户主动取消（Esc/遮罩/外部/关闭按钮）的语义快捷事件。 */
-    onCancel?: (e: {
-        reason: Reason;
-    }) => void;
+    /** 取消面板时的回调。对齐 Semi onCancel。 */
+    onCancel?: (e: MouseEvent | KeyboardEvent) => void;
 }
 declare const SideSheet: import("svelte").Component<Props, {}, "">;
 type SideSheet = ReturnType<typeof SideSheet>;

package/dist/side-sheet/SideSheet.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SideSheet.svelte.d.ts","sourceRoot":"","sources":["../../src/side-sheet/SideSheet.svelte.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"SideSheet.svelte.d.ts","sourceRoot":"","sources":["../../src/side-sheet/SideSheet.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAUpC,KAAK,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAC;AACrD,KAAK,IAAI,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEzC,UAAU,KAAK;IACb,yCAAyC;IACzC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,uDAAuD;IACvD,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,yEAAyE;IACzE,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uDAAuD;IACvD,SAAS,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3B,2CAA2C;IAC3C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,qCAAqC;IACrC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,sCAAsC;IACtC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,sEAAsE;IACtE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,qDAAqD;IACrD,iBAAiB,CAAC,EAAE,MAAM,WAAW,GAAG,IAAI,CAAC;IAC7C,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,6BAA6B;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC;QAAE,KAAK,EAAE,MAAM,IAAI,CAAA;KAAE,CAAC,CAAC,GAAG,IAAI,CAAC;IACjD,kCAAkC;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,kBAAkB,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,CAAC;IAClD,iCAAiC;IACjC,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,GAAG,aAAa,KAAK,IAAI,CAAC;CACpD;AA8SH,QAAA,MAAM,SAAS,2CAAwC,CAAC;AACxD,KAAK,SAAS,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC;AAC9C,eAAe,SAAS,CAAC"}

package/dist/side-sheet/meta.d.ts

@@ -1,130 +1,124 @@
 /**
  * Machine-readable component metadata for AI/docs consumption.
- * SideSheet — see specs/components/feedback/SideSheet.spec.md
+ * SideSheet — 严格镜像 Semi Design（semi-foundation/sideSheet + semi-ui/sideSheet）。
  */
 export declare const meta: {
     readonly name: "SideSheet";
-    readonly category: "feedback";
+    readonly category: "show";
     readonly stage: "M5";
     readonly semiEquivalent: "SideSheet";
-    readonly description: "侧边滑出浮层：从视口四边（left/right/top/bottom）滑入的容器，承载次要任务流/详情/筛选/表单，比 Modal 提供更大可滚动内容区。与 Modal 同构复用浮层基建——portal 到 body（或 getContainer）脱离父层叠上下文；role=dialog，mask 时加 aria-modal；useFocusTrap 焦点捕获与归还（仅 mask=true）、useDismiss Esc 关闭（closeOnEsc），mask 时 useScrollLock 锁背景滚动（可 disableScrollLock 关闭）。mask=true 模态（遮罩+锁滚+陷阱），mask=false 非模态（无遮罩、不锁滚动、不抢焦点，outsideClosable 时点外部关闭）。size(small/default/large) 预设宽（横向）/高（纵向），width/height 显式覆盖；窄视口近铺满。Header/Body/Footer 三段式，footer 暴露 close()。滑入过渡为 CSS transform/opacity（token 时长缓动，reduced-motion 与 motionDisabled 退化为即时显隐）。lazyMount 首开前惰性挂载，destroyOnClose 关闭即卸载内容（出场过渡结束后 onAfterClose）。堆叠 z-index 复用 modal/z-stack 模块级计数器，与 Modal 统一层栈、后开者在上、Esc 仅关栈顶。受控 open（不回写），仅经 onOpenChange({open, reason}) 通知，reason 覆盖 esc/mask/outside/closeButton/programmatic。";
+    readonly description: "滑动侧边栏：从视口四边（left/right/top/bottom）滑入的浮层容器，承载二级操作页面 / 详情 / 表单 / 筛选，比 Modal 提供更大可滚动内容区。DOM 结构与类名严格对齐 Semi：wrapper(.cd-sidesheet-{placement}) > mask + inner(.cd-sidesheet-inner.cd-sidesheet-inner-wrap.cd-sidesheet-size-{size}, role=dialog tabindex=-1) > content > header(role=heading aria-level=1)+body+footer。Portal 到 getPopupContainer()/body 脱离父层叠上下文；role=dialog，mask 时加 aria-modal；closeOnEsc（默认 false）时 window 监听 Esc 关闭；mask=true 默认锁 body 滚动（disableScroll），getPopupContainer 指向非 body 时为 popup 模式（wrapper position:static）。mask=false 为可操作外部区域形态（无遮罩、面板 box-shadow: --cd-shadow-elevated、宽度落在 wrapper）。size(small448/medium684/large920，默认 small) 仅 left/right 生效；width（默认 448，left/right）/ height（默认 400，top/bottom）显式覆盖。进出场动画对齐 Semi CSSAnimation：mask 淡入淡出 + inner 按 placement 滑入滑出，animationend 后卸载；motion=false 或 prefers-reduced-motion 退化即时显隐。关闭按钮用 IconButton（type=tertiary theme=borderless size=small）+ IconClose。受控 visible（不回写），仅经 onCancel(e) 通知；afterVisibleChange 于动画结束回调可见状态。keepDOM 关闭保留 DOM。";
     readonly exports: readonly ["SideSheet"];
     readonly a11yPattern: "dialog-modal";
     readonly apgRef: "dialog (modal)";
-    readonly replaces: readonly ["Drawer"];
     readonly relatedComponents: readonly ["Modal", "Popover", "Notification"];
-    readonly usageHints: "承载次要任务流/详情/筛选；模态用 mask=true，协作式（打开仍可操作主页面）用 mask=false。承载单一确认/决策用 Modal，不要混用。";
-    readonly dangerousActions: "footer 危险操作（删除/清空等不可逆）使用 --cd-color-danger 与具体动词文案，并由业务侧拦截 onOpenChange 对未保存内容做二次确认。";
+    readonly usageHints: "承载二级操作页面 / 详情 / 筛选 / 表单；模态用 mask=true，可操作外部区域用 mask=false。承载单一确认/决策用 Modal，不要混用。";
+    readonly dangerousActions: "footer 危险操作（删除/清空等不可逆）使用 --cd-color-danger 与具体动词文案，并由业务侧在 onCancel 对未保存内容做二次确认。";
     readonly props: readonly [{
-        readonly name: "open";
+        readonly name: "visible";
         readonly type: "boolean";
         readonly default: "false";
-        readonly desc: "受控显隐；受控时不回写，仅 onOpenChange 通知";
+        readonly desc: "面板是否可见（受控，不回写）";
     }, {
         readonly name: "placement";
         readonly type: "'left'|'right'|'top'|'bottom'";
         readonly default: "'right'";
-        readonly desc: "滑出方向（贴附边缘）；RTL 下 left/right 镜像";
+        readonly desc: "滑出位置";
     }, {
         readonly name: "size";
-        readonly type: "'small'|'default'|'large'";
-        readonly default: "'default'";
-        readonly desc: "预设尺度（横向→宽度，纵向→高度）";
+        readonly type: "'small'|'medium'|'large'";
+        readonly default: "'small'";
+        readonly desc: "尺寸（448/684/920px），仅 left/right 生效";
     }, {
         readonly name: "width";
         readonly type: "number|string";
-        readonly default: "undefined";
-        readonly desc: "left/right 显式宽度，覆盖 size；数字按 px";
+        readonly default: "448";
+        readonly desc: "left/right 宽度，数字按 px";
     }, {
         readonly name: "height";
         readonly type: "number|string";
-        readonly default: "undefined";
-        readonly desc: "top/bottom 显式高度，覆盖 size；数字按 px";
+        readonly default: "400";
+        readonly desc: "top/bottom 高度，数字按 px";
     }, {
         readonly name: "title";
         readonly type: "string";
         readonly default: "undefined";
-        readonly desc: "标题文案";
+        readonly desc: "面板标题";
     }, {
         readonly name: "titleSnippet";
         readonly type: "Snippet";
         readonly default: "undefined";
-        readonly desc: "自定义标题区，覆盖 title";
-    }, {
-        readonly name: "headerExtra";
-        readonly type: "Snippet";
-        readonly default: "undefined";
-        readonly desc: "Header 右侧额外操作（关闭按钮之前）";
-    }, {
-        readonly name: "closeIcon";
-        readonly type: "Snippet";
-        readonly default: "undefined";
-        readonly desc: "自定义关闭图标";
+        readonly desc: "自定义标题区（覆盖 title）；对齐 Semi title(ReactNode)";
     }, {
-        readonly name: "mask";
+        readonly name: "closable";
         readonly type: "boolean";
         readonly default: "true";
-        readonly desc: "显示遮罩并以模态呈现（锁滚动+focus trap）；false 非模态";
+        readonly desc: "是否显示右上角关闭按钮";
     }, {
-        readonly name: "maskClosable";
-        readonly type: "boolean";
-        readonly default: "true";
-        readonly desc: "点击遮罩是否关闭（mask=true 生效）";
+        readonly name: "closeIcon";
+        readonly type: "Snippet|null";
+        readonly default: "IconClose";
+        readonly desc: "关闭按钮 icon";
     }, {
-        readonly name: "outsideClosable";
+        readonly name: "closeOnEsc";
         readonly type: "boolean";
         readonly default: "false";
-        readonly desc: "mask=false 时点击面板外部是否关闭";
+        readonly desc: "是否允许 Esc 关闭";
     }, {
-        readonly name: "closeOnEsc";
+        readonly name: "mask";
         readonly type: "boolean";
         readonly default: "true";
-        readonly desc: "按 Esc 是否关闭（仅作用于浮层栈顶）";
+        readonly desc: "是否显示遮罩；false 时允许操作外部区域";
     }, {
-        readonly name: "closable";
+        readonly name: "maskClosable";
         readonly type: "boolean";
         readonly default: "true";
-        readonly desc: "Header 是否显示关闭按钮";
+        readonly desc: "是否允许点击遮罩关闭";
     }, {
-        readonly name: "lazyMount";
+        readonly name: "disableScroll";
         readonly type: "boolean";
         readonly default: "true";
-        readonly desc: "首次打开前是否惰性挂载内容";
+        readonly desc: "渲染在 body 层时是否禁止 body 滚动";
     }, {
         readonly name: "keepDOM";
         readonly type: "boolean";
-        readonly default: "undefined";
-        readonly desc: "true 时保留 DOM（禁用惰性挂载）；lazyMount 优先";
-    }, {
-        readonly name: "destroyOnClose";
-        readonly type: "boolean";
         readonly default: "false";
-        readonly desc: "关闭后是否销毁内部内容（出场过渡结束后卸载），重开重建";
+        readonly desc: "关闭时是否保留内部组件不销毁";
     }, {
-        readonly name: "getContainer";
+        readonly name: "getPopupContainer";
         readonly type: "() => HTMLElement | null";
-        readonly default: "() => document.body";
-        readonly desc: "Portal 挂载容器";
+        readonly default: "undefined";
+        readonly desc: "指定父级 DOM，弹层渲染至该 DOM";
     }, {
         readonly name: "zIndex";
         readonly type: "number";
         readonly default: "1000";
-        readonly desc: "浮层基准层级（栈内自动递增）";
+        readonly desc: "弹层 z-index";
     }, {
-        readonly name: "disableScrollLock";
+        readonly name: "motion";
         readonly type: "boolean";
-        readonly default: "false";
-        readonly desc: "强制不锁背景滚动（即便 mask=true）";
+        readonly default: "true";
+        readonly desc: "是否允许动画";
     }, {
-        readonly name: "returnFocusTo";
-        readonly type: "HTMLElement | (() => HTMLElement | null) | null";
-        readonly default: "触发元素";
-        readonly desc: "关闭后焦点返回目标";
+        readonly name: "style";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "面板根内联样式";
     }, {
-        readonly name: "motionDisabled";
-        readonly type: "boolean";
-        readonly default: "false";
-        readonly desc: "关闭进出动效（独立于 reduced-motion）";
+        readonly name: "bodyStyle";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "内容区域内联样式";
+    }, {
+        readonly name: "headerStyle";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "Header 区域内联样式";
+    }, {
+        readonly name: "maskStyle";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "遮罩内联样式";
     }, {
         readonly name: "footer";
         readonly type: "Snippet<[{ close: () => void }]>|null";
@@ -144,50 +138,24 @@ export declare const meta: {
         readonly name: "class";
         readonly type: "string";
         readonly default: "undefined";
-        readonly desc: "面板自定义类名";
+        readonly desc: "根元素自定义类名";
     }, {
-        readonly name: "bodyClass";
-        readonly type: "string";
+        readonly name: "afterVisibleChange";
+        readonly type: "(isVisible: boolean) => void";
         readonly default: "undefined";
-        readonly desc: "Body 自定义类名";
-    }, {
-        readonly name: "maskClass";
-        readonly type: "string";
-        readonly default: "undefined";
-        readonly desc: "遮罩自定义类名";
-    }, {
-        readonly name: "onOpenChange";
-        readonly type: "(e: { open: boolean; reason: Reason }) => void";
-        readonly default: "undefined";
-        readonly desc: "显隐意图变化（受控，需外部回写 open）";
-    }, {
-        readonly name: "onAfterOpen";
-        readonly type: "() => void";
-        readonly default: "undefined";
-        readonly desc: "进入动效结束、内容完全可见后触发";
-    }, {
-        readonly name: "onAfterClose";
-        readonly type: "() => void";
-        readonly default: "undefined";
-        readonly desc: "退出动效结束、DOM 卸载后触发";
+        readonly desc: "展示/隐藏动画结束触发";
     }, {
         readonly name: "onCancel";
-        readonly type: "(e: { reason: Reason }) => void";
+        readonly type: "(e: MouseEvent | KeyboardEvent) => void";
         readonly default: "undefined";
-        readonly desc: "用户主动取消（Esc/遮罩/外部/关闭按钮）";
+        readonly desc: "取消面板时的回调";
     }];
     readonly events: readonly [{
-        readonly name: "onOpenChange";
-        readonly desc: "显隐意图变化，payload { open, reason: esc|mask|outside|closeButton|programmatic }";
-    }, {
-        readonly name: "onAfterOpen";
-        readonly desc: "进入动效结束后触发";
-    }, {
-        readonly name: "onAfterClose";
-        readonly desc: "退出动效结束、DOM 卸载后触发";
-    }, {
         readonly name: "onCancel";
-        readonly desc: "用户主动取消，payload { reason }";
+        readonly desc: "取消面板（关闭按钮 / 遮罩 / Esc），payload 为触发事件";
+    }, {
+        readonly name: "afterVisibleChange";
+        readonly desc: "面板展示/隐藏动画结束触发，payload 为当前是否可见";
     }];
     readonly slots: readonly [{
         readonly name: "children";
@@ -195,9 +163,6 @@ export declare const meta: {
     }, {
         readonly name: "titleSnippet";
         readonly desc: "自定义标题区，覆盖 title";
-    }, {
-        readonly name: "headerExtra";
-        readonly desc: "Header 右侧额外操作（关闭按钮之前）";
     }, {
         readonly name: "footer";
         readonly desc: "Footer 操作区，提供 close()";
@@ -208,22 +173,22 @@ export declare const meta: {
     readonly a11y: {
         readonly hasRole: true;
         readonly focusable: true;
-        readonly note: "role=dialog；mask=true 加 aria-modal=true（非模态不设，避免误导锁定语义）；有 title 用 aria-labelledby，无则 ariaLabel；mask 时 useFocusTrap 捕获 Tab 焦点循环并在关闭归还 returnFocusTo/触发元素；closeOnEsc 控制 Esc（仅栈顶）；mask 时 useScrollLock 锁背景滚动；关闭按钮 aria-label 经 SideSheet.closeAriaLabel；reduced-motion / motionDisabled 退化即时显隐。";
+        readonly note: "wrapper > inner role=dialog tabindex=-1（mask=true 加 aria-modal=true）；内部 header role=heading aria-level=1；有 title 用 aria-labelledby，无则 ariaLabel；closeOnEsc 控制 Esc 关闭；关闭按钮 aria-label 经 SideSheet.closeAriaLabel；reduced-motion / motion=false 退化即时显隐。";
     };
-    readonly tokens: readonly ["--cd-sidesheet-bg", "--cd-sidesheet-color", "--cd-sidesheet-mask-bg", "--cd-sidesheet-border", "--cd-sidesheet-radius", "--cd-sidesheet-shadow", "--cd-sidesheet-padding", "--cd-sidesheet-header-padding", "--cd-sidesheet-footer-padding", "--cd-sidesheet-title-color", "--cd-sidesheet-title-size", "--cd-sidesheet-close-color", "--cd-sidesheet-close-color-hover", "--cd-sidesheet-close-hover-bg", "--cd-sidesheet-width-small", "--cd-sidesheet-width", "--cd-sidesheet-width-large", "--cd-sidesheet-height-small", "--cd-sidesheet-height", "--cd-sidesheet-height-large", "--cd-sidesheet-z", "--cd-sidesheet-motion-duration"];
+    readonly tokens: readonly ["--cd-color-side-sheet-mask-bg", "--cd-color-side-sheet-bg", "--cd-color-side-sheet-main-text", "--cd-color-side-sheet-header-border-bottom", "--cd-spacing-side-sheet-margin", "--cd-spacing-side-sheet-title-margin", "--cd-spacing-side-sheet-header-padding", "--cd-spacing-side-sheet-header-padding-bottom", "--cd-spacing-side-sheet-body-paddingy", "--cd-spacing-side-sheet-body-paddingx", "--cd-spacing-side-sheet-footer-padding", "--cd-width-side-sheet-header-border-bottom", "--cd-width-side-sheet-size-small", "--cd-width-side-sheet-size-medium", "--cd-width-side-sheet-size-large", "--cd-font-side-sheet-title-fontweight", "--cd-font-side-sheet-title-fontsize", "--cd-filter-side-sheet-mask-bg", "--cd-filter-side-sheet-bg", "--cd-animation-duration-side-sheet-mask-show", "--cd-animation-function-side-sheet-mask-show", "--cd-animation-delay-side-sheet-mask-show", "--cd-animation-duration-side-sheet-mask-hide", "--cd-animation-function-side-sheet-mask-hide", "--cd-animation-delay-side-sheet-mask-hide", "--cd-animation-duration-side-sheet-inner-show", "--cd-animation-function-side-sheet-inner-show", "--cd-animation-delay-side-sheet-inner-show", "--cd-animation-duration-side-sheet-inner-hide", "--cd-animation-function-side-sheet-inner-hide", "--cd-animation-delay-side-sheet-inner-hide"];
     readonly responsive: true;
     readonly examples: readonly [{
-        readonly title: "右侧模态面板";
-        readonly code: "<SideSheet open={visible} title=\"编辑用户\" onOpenChange={(e) => (visible = e.open)}>表单</SideSheet>";
+        readonly title: "基本";
+        readonly code: "<SideSheet title=\"滑动侧边栏\" visible={visible} onCancel={() => (visible = false)}>内容</SideSheet>";
     }, {
-        readonly title: "左侧导航面板";
-        readonly code: "<SideSheet open={visible} placement=\"left\" title=\"菜单\" onOpenChange={(e) => (visible = e.open)}>导航</SideSheet>";
+        readonly title: "自定义位置";
+        readonly code: "<SideSheet placement=\"left\" title=\"菜单\" visible={visible} onCancel={() => (visible = false)}>导航</SideSheet>";
     }, {
-        readonly title: "非模态协作面板";
-        readonly code: "<SideSheet open={visible} mask={false} outsideClosable title=\"通知中心\" onOpenChange={(e) => (visible = e.open)}>列表</SideSheet>";
+        readonly title: "自定义尺寸";
+        readonly code: "<SideSheet size=\"medium\" title=\"滑动侧边栏\" visible={visible} onCancel={() => (visible = false)}>内容</SideSheet>";
     }, {
-        readonly title: "Footer 操作区";
-        readonly code: "<SideSheet open={visible} title=\"筛选\" onOpenChange={(e) => (visible = e.open)}>{#snippet footer({ close })}<Button onclick={close}>取消</Button><Button type=\"primary\">应用筛选</Button>{/snippet}内容</SideSheet>";
+        readonly title: "可操作的外部区域";
+        readonly code: "<SideSheet mask={false} disableScroll={false} title=\"可操作外部\" visible={visible} onCancel={() => (visible = false)}>内容</SideSheet>";
     }];
 };
 //# sourceMappingURL=meta.d.ts.map

package/dist/side-sheet/meta.d.ts.map

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