@chenzy-design/svelte 0.3.0 → 0.4.1

package/dist/popover/Popover.svelte.d.ts

@@ -1,73 +1,103 @@
 import type { Snippet } from 'svelte';
-import { type Align } from '@chenzy-design/core';
-type TriggerKind = 'hover' | 'click' | 'focus' | 'custom';
-type Position = 'top' | 'bottom' | 'left' | 'right';
-type Size = 'small' | 'default' | 'large';
-/** motion 配置：传 number 覆盖时长（ms），传 false 关闭过渡 */
-interface MotionConfig {
-    /** 过渡时长（ms），缺省走 token --cd-popover-motion-duration */
-    duration?: number;
+import { type Position } from '../tooltip/index.js';
+type TriggerKind = 'hover' | 'focus' | 'click' | 'custom' | 'contextMenu';
+/** content 带参 Snippet 入参：将 initialFocusRef action 绑定到浮层内可聚焦元素，打开时自动聚焦。
+ *  （对齐 Semi content 函数形态 ({ initialFocusRef }) => …，Svelte 中即带参数 Snippet） */
+interface RenderContentProps {
+    initialFocusRef: (node: HTMLElement) => void;
+}
+/** 箭头颜色定制（对齐 Semi arrowStyle，Popover 专有；Semi Tooltip 无此 prop）。 */
+interface ArrowStyle {
+    borderColor?: string;
+    backgroundColor?: string;
+    borderOpacity?: string | number;
 }
 interface Props {
-    content?: string | Snippet;
+    /**
+     * 浮层内容：文本 / Snippet。Snippet 可选接收 { initialFocusRef } 入参
+     * （对齐 Semi content 函数形态 ({ initialFocusRef }) => …）：绑定到浮层内可聚焦元素，
+     * 打开时自动聚焦。不声明参数的普通内容 Snippet 也可直接传（多余入参被忽略）。
+     */
+    content?: string | Snippet<[RenderContentProps]>;
+    /** 标题，提供则渲染 .cd-popover-title 标题区与下边框 */
     title?: string | Snippet;
-    open?: boolean;
-    defaultOpen?: boolean;
+    /** 受控显隐（配合 trigger='custom'），对齐 Semi visible */
+    visible?: boolean;
+    /** 非受控初始显隐 */
+    defaultVisible?: boolean;
+    /** 触发方式；custom 完全受控（仅 visible + onVisibleChange） */
     trigger?: TriggerKind;
+    /** 弹出方位（Semi 12 方位命名 + 2 Over），默认 bottom */
     position?: Position;
-    align?: Align;
     /** 视口溢出时翻转到对侧 */
     autoAdjustOverflow?: boolean;
+    /** 是否显示箭头，默认 false（对齐 Semi Popover） */
     showArrow?: boolean;
-    /** start/end 对齐时箭头指向触发器中心（默认 false：贴对齐边） */
+    /** 箭头是否指向触发元素中心（需 showArrow），默认 true */
     arrowPointAtCenter?: boolean;
-    spacing?: number;
+    /** 箭头颜色定制（border/bg/opacity），对齐 Semi arrowStyle */
+    arrowStyle?: ArrowStyle;
+    /** 浮层与触发器距离(px)；缺省按 showArrow 取 10 / 4（对齐 Semi） */
+    spacing?: number | {
+        x: number;
+        y: number;
+    };
+    /** 计算溢出翻转时增加的冗余安全边距（对齐 Semi margin） */
+    margin?: number | {
+        marginLeft?: number;
+        marginTop?: number;
+        marginRight?: number;
+        marginBottom?: number;
+    };
     mouseEnterDelay?: number;
     mouseLeaveDelay?: number;
+    /** 是否允许触发显示；false 时不响应 hover/click/focus（custom 不受影响），对齐 Semi condition */
+    condition?: boolean;
+    /** 点击浮层及内部任一元素时自动关闭，对齐 Semi clickToHide */
+    clickToHide?: boolean;
+    /** 关闭时保留浮层 DOM 不销毁（--hidden 隐藏），对齐 Semi keepDOM */
+    keepDOM?: boolean;
+    /** hover 触发时不响应键盘 focus 显隐，对齐 Semi disableFocusListener */
+    disableFocusListener?: boolean;
     disabled?: boolean;
-    /** 浮层挂载容器，缺省回退 ConfigProvider 全局，再回退 document.body。非 body 容器时 floating 改 absolute 定位。 */
+    /** 是否展示进出场动画 */
+    motion?: boolean;
+    /** 浮层挂载容器，缺省回退 ConfigProvider 全局，再回退 body */
     getPopupContainer?: () => HTMLElement | null | undefined;
-    /** 浮层层级，缺省走 token var(--cd-popover-z) */
+    /** 浮层 z-index，缺省走 token */
     zIndex?: number;
-    /** 是否陷入焦点（Tab 循环），缺省随 trigger==='click' */
-    trapFocus?: boolean;
-    /** 关闭后焦点是否归还触发器（仅 trapFocus 时生效），默认 true */
-    returnFocus?: boolean;
-    /** Esc 关闭，默认 true（custom 触发不生效） */
+    /** Esc 关闭浮层 */
     closeOnEsc?: boolean;
-    /** 外部点击关闭，默认 true（custom 触发不生效） */
-    closeOnOutsideClick?: boolean;
-    /** 打开时锁定背景滚动，默认 false（非阻断） */
-    lockScroll?: boolean;
-    /** 关闭时销毁浮层 DOM，默认 false（首开后保留，仅 --hidden 隐藏） */
-    destroyOnClose?: boolean;
-    /** 重新打开时恢复上次浮层内焦点位置（仅 trapFocus 时生效），默认 false */
-    rememberFocus?: boolean;
-    /** 阻断浮层内事件冒泡，默认 false */
+    /** 焦点处于浮层内时 Tab 是否循环（对齐 Semi guardFocus），默认随 dialog 模式 */
+    guardFocus?: boolean;
+    /** 关闭后焦点归还触发器（仅 guardFocus 时生效），对齐 Semi returnFocusOnClose */
+    returnFocusOnClose?: boolean;
+    /** 阻止浮层上的点击事件冒泡，对齐 Semi stopPropagation */
     stopPropagation?: boolean;
-    /** 内边距尺寸档位，默认 default */
-    size?: Size;
-    /** 动画开关/配置，默认 true */
-    motion?: boolean | MotionConfig;
-    /** 浮层右上角显示关闭按钮，默认 false */
-    showCloseButton?: boolean;
-    /** 自定义关闭按钮图标（showCloseButton=true 时有效） */
-    closeIcon?: Snippet;
-    /** 确定按钮文案（默认来自 locale） */
-    okText?: string;
-    /** 取消按钮文案（默认来自 locale） */
-    cancelText?: string;
-    /** 透传给确定 Button 的 props */
-    okButtonProps?: Record<string, unknown>;
-    /** 透传给取消 Button 的 props */
-    cancelButtonProps?: Record<string, unknown>;
-    /** 点击确定按钮回调 */
-    onOk?: () => void;
-    /** 点击取消按钮回调 */
-    onCancel?: () => void;
-    onOpenChange?: (open: boolean) => void;
+    /** 更新该值手动触发浮层重新定位，对齐 Semi rePosKey */
+    rePosKey?: string | number;
+    /** 浮层自定义类名 */
+    class?: string;
+    /** 浮层自定义内联样式 */
+    style?: string;
+    /** 显隐切换回调，对齐 Semi onVisibleChange */
+    onVisibleChange?: (visible: boolean) => void;
+    /** 点击浮层与触发器外部区域的回调（仅 custom/click），对齐 Semi onClickOutSide */
+    onClickOutSide?: (e: MouseEvent) => void;
+    /** 浮层完全关闭后的回调 */
+    afterClose?: () => void;
+    /**
+     * dialog 模式浮层的 aria-labelledby（外部封装者传入，指向自绘标题元素 id）。
+     * Popconfirm 等封装 Popover 时，标题渲染在 content 内，用此项关联浮层与标题。
+     * 优先于 Popover 自身 title 生成的 id。
+     */
+    ariaLabelledby?: string;
+    /** 外层包裹 span（定位参照宿主）的类名（对齐 Semi wrapperClassName） */
+    wrapperClassName?: string;
+    /** 外层包裹 span（定位参照宿主）的内联样式；用于让包裹 span 直接承载触发盒 */
+    triggerStyle?: string;
+    /** 触发元素（必填） */
     children?: Snippet;
-    contentSlot?: Snippet;
 }
 declare const Popover: import("svelte").Component<Props, {}, "">;
 type Popover = ReturnType<typeof Popover>;

package/dist/popover/Popover.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Popover.svelte.d.ts","sourceRoot":"","sources":["../../src/popover/Popover.svelte.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Popover.svelte.d.ts","sourceRoot":"","sources":["../../src/popover/Popover.svelte.ts"],"names":[],"mappings":"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"}

package/dist/popover/meta.d.ts

@@ -1,156 +1,184 @@
 /**
  * Machine-readable component metadata for AI/docs consumption.
  * See specs/00-foundation/ai-friendly.spec.md.
+ * 严格对齐 Semi Design semi-ui/popover 的 API 表。
+ * 架构：Popover 封装 Tooltip（对齐 Semi `Popover extends Tooltip`），定位/触发/焦点/dismiss/箭头复用 Tooltip。
  */
 export declare const meta: {
     readonly name: "Popover";
     readonly category: "show";
-    readonly description: "气泡卡片，点击/悬停/聚焦触发元素时弹出富内容浮层。支持标题、常用 position、对齐、箭头与间距，浮层纯 CSS 定位。";
+    readonly description: "气泡卡片，点击/悬停/聚焦触发元素时弹出富内容浮层。封装 Tooltip（对齐 Semi 继承链），支持标题、12 方位 position、SVG 箭头、间距、custom 完全受控与 condition 条件触发，浮层命令式定位。";
     readonly props: readonly [{
         readonly name: "content";
-        readonly type: "string | Snippet";
+        readonly type: "string | Snippet<[{ initialFocusRef }]>";
         readonly default: "undefined";
-        readonly desc: "简单文本内容";
+        readonly desc: "浮层内容；Snippet 可接收 { initialFocusRef } 入参，绑定到浮层内元素打开时自动聚焦（对齐 Semi content 函数）";
     }, {
         readonly name: "title";
         readonly type: "string | Snippet";
         readonly default: "undefined";
         readonly desc: "标题，提供则渲染标题区与下边框";
     }, {
-        readonly name: "open";
+        readonly name: "visible";
         readonly type: "boolean";
         readonly default: "undefined";
-        readonly desc: "受控显隐";
+        readonly desc: "受控显隐（配合 trigger=custom）";
     }, {
-        readonly name: "defaultOpen";
+        readonly name: "defaultVisible";
         readonly type: "boolean";
         readonly default: "false";
         readonly desc: "非受控初始显隐";
     }, {
         readonly name: "trigger";
-        readonly type: "'hover'|'click'|'focus'|'custom'";
-        readonly default: "hover";
-        readonly desc: "触发方式；custom 时显隐完全由受控 open + onOpenChange 控制，不自动响应交互、不启用外部点击/Esc 关闭";
+        readonly type: "'hover'|'click'|'focus'|'custom'|'contextMenu'";
+        readonly default: "'hover'";
+        readonly desc: "触发方式；custom 完全受控（仅 visible + onVisibleChange）；contextMenu 右键触发。click/custom → dialog role，hover/focus/contextMenu → tooltip role";
     }, {
         readonly name: "position";
-        readonly type: "'top'|'bottom'|'left'|'right'";
-        readonly default: "bottom";
-        readonly desc: "浮层主方向";
+        readonly type: "'top'|'topLeft'|'topRight'|'left'|'leftTop'|'leftBottom'|'right'|'rightTop'|'rightBottom'|'bottom'|'bottomLeft'|'bottomRight'|'leftTopOver'|'rightTopOver'";
+        readonly default: "'bottom'";
+        readonly desc: "弹出方位（Semi 12 方位命名 + 2 Over）";
     }, {
-        readonly name: "align";
-        readonly type: "'start'|'center'|'end'";
-        readonly default: "center";
-        readonly desc: "交叉轴对齐";
+        readonly name: "autoAdjustOverflow";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "视口溢出时翻转到对侧";
     }, {
         readonly name: "showArrow";
         readonly type: "boolean";
-        readonly default: "true";
-        readonly desc: "是否显示箭头";
+        readonly default: "false";
+        readonly desc: "是否显示 SVG 小三角（对齐 Semi 默认 false）";
     }, {
         readonly name: "arrowPointAtCenter";
         readonly type: "boolean";
-        readonly default: "false";
-        readonly desc: "start/end 对齐时箭头指向触发器中心";
+        readonly default: "true";
+        readonly desc: "小三角是否指向元素中心（需 showArrow）";
+    }, {
+        readonly name: "arrowStyle";
+        readonly type: "{ borderColor?; backgroundColor?; borderOpacity? }";
+        readonly default: "undefined";
+        readonly desc: "箭头颜色定制（border/bg/opacity）";
     }, {
         readonly name: "spacing";
-        readonly type: "number";
-        readonly default: "8";
-        readonly desc: "浮层与触发器间距(px)";
+        readonly type: "number | { x: number; y: number }";
+        readonly default: "showArrow ? 10 : 4";
+        readonly desc: "浮层与触发器距离(px)，缺省按 showArrow 取 10 / 4（对齐 Semi SPACING_WITH_ARROW / SPACING）";
+    }, {
+        readonly name: "margin";
+        readonly type: "number | { marginLeft; marginTop; marginRight; marginBottom }";
+        readonly default: "0";
+        readonly desc: "计算溢出翻转时增加的冗余安全边距";
     }, {
         readonly name: "mouseEnterDelay";
         readonly type: "number";
-        readonly default: "100";
+        readonly default: "50";
         readonly desc: "hover 进入延迟(ms)";
     }, {
         readonly name: "mouseLeaveDelay";
         readonly type: "number";
-        readonly default: "100";
+        readonly default: "50";
         readonly desc: "hover 离开延迟(ms)";
+    }, {
+        readonly name: "condition";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "false 时不响应 hover/click/focus 触发（custom 不受影响）";
+    }, {
+        readonly name: "clickToHide";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "点击浮层及内部任一元素时自动关闭";
+    }, {
+        readonly name: "keepDOM";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "关闭时保留浮层 DOM 不销毁（--hidden 隐藏）";
+    }, {
+        readonly name: "disableFocusListener";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "hover 触发时不响应键盘 focus 显隐";
     }, {
         readonly name: "disabled";
         readonly type: "boolean";
         readonly default: "false";
         readonly desc: "禁用触发";
+    }, {
+        readonly name: "motion";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "是否展示进出场动画，reduced-motion 退化";
     }, {
         readonly name: "getPopupContainer";
-        readonly type: "() => HTMLElement";
-        readonly default: "() => body";
-        readonly desc: "浮层挂载容器，回退 ConfigProvider 全局再回退 body";
+        readonly type: "() => HTMLElement | null | undefined";
+        readonly default: "undefined";
+        readonly desc: "浮层挂载容器，缺省回退 ConfigProvider 全局，再回退 body";
     }, {
         readonly name: "zIndex";
         readonly type: "number";
-        readonly default: "var(--cd-popover-z)";
-        readonly desc: "浮层层级";
-    }, {
-        readonly name: "trapFocus";
-        readonly type: "boolean";
-        readonly default: "trigger==='click'";
-        readonly desc: "是否陷入焦点（Tab 循环）";
+        readonly default: "undefined";
+        readonly desc: "浮层 z-index（缺省走 token --cd-z-popover = 1030）";
     }, {
-        readonly name: "returnFocus";
+        readonly name: "closeOnEsc";
         readonly type: "boolean";
         readonly default: "true";
-        readonly desc: "关闭后焦点是否归还触发器（仅 trapFocus 生效）";
+        readonly desc: "Esc 关闭浮层";
     }, {
-        readonly name: "closeOnEsc";
+        readonly name: "guardFocus";
         readonly type: "boolean";
-        readonly default: "true";
-        readonly desc: "Esc 关闭";
+        readonly default: "role==='dialog'";
+        readonly desc: "焦点处于浮层内时 Tab 是否循环（缺省随 dialog 模式）";
     }, {
-        readonly name: "closeOnOutsideClick";
+        readonly name: "returnFocusOnClose";
         readonly type: "boolean";
         readonly default: "true";
-        readonly desc: "外部点击关闭";
+        readonly desc: "关闭后焦点归还触发器（仅 guardFocus 时生效）";
     }, {
-        readonly name: "lockScroll";
+        readonly name: "stopPropagation";
         readonly type: "boolean";
         readonly default: "false";
-        readonly desc: "打开时锁定背景滚动";
+        readonly desc: "阻止浮层上的点击事件冒泡";
     }, {
-        readonly name: "destroyOnClose";
-        readonly type: "boolean";
-        readonly default: "false";
-        readonly desc: "关闭时销毁浮层 DOM";
+        readonly name: "rePosKey";
+        readonly type: "string | number";
+        readonly default: "undefined";
+        readonly desc: "更新该值手动触发浮层重新定位";
     }, {
-        readonly name: "rememberFocus";
-        readonly type: "boolean";
-        readonly default: "false";
-        readonly desc: "重新打开时恢复上次浮层内焦点位置（仅 trapFocus 生效）";
+        readonly name: "class";
+        readonly type: "string";
+        readonly default: "''";
+        readonly desc: "浮层自定义类名";
     }, {
-        readonly name: "stopPropagation";
-        readonly type: "boolean";
-        readonly default: "false";
-        readonly desc: "阻断浮层内事件冒泡";
+        readonly name: "style";
+        readonly type: "string";
+        readonly default: "''";
+        readonly desc: "浮层自定义内联样式";
     }, {
-        readonly name: "size";
-        readonly type: "'small'|'default'|'large'";
-        readonly default: "default";
-        readonly desc: "内边距尺寸档位";
+        readonly name: "onVisibleChange";
+        readonly type: "(visible: boolean) => void";
+        readonly default: "undefined";
+        readonly desc: "显隐切换回调";
     }, {
-        readonly name: "motion";
-        readonly type: "boolean | { duration?: number }";
-        readonly default: "true";
-        readonly desc: "动画开关/配置，reduced-motion 退化";
+        readonly name: "onClickOutSide";
+        readonly type: "(e: MouseEvent) => void";
+        readonly default: "undefined";
+        readonly desc: "点击浮层与触发器外部的回调（仅 custom/click）";
     }, {
-        readonly name: "onOpenChange";
-        readonly type: "(open: boolean) => void";
+        readonly name: "afterClose";
+        readonly type: "() => void";
         readonly default: "undefined";
+        readonly desc: "浮层完全关闭后的回调";
     }, {
         readonly name: "children";
         readonly type: "Snippet";
         readonly default: "undefined";
         readonly desc: "触发元素（必填）";
-    }, {
-        readonly name: "contentSlot";
-        readonly type: "Snippet";
-        readonly default: "undefined";
-        readonly desc: "富内容，优先于 content";
     }];
     readonly a11y: {
-        readonly role: "dialog";
+        readonly role: "dialog | tooltip";
         readonly keyboard: readonly ["Escape", "Tab", "Shift+Tab"];
-        readonly notes: readonly ["浮层 role=dialog aria-modal=false，使用 useId 生成唯一 id；有标题时 aria-labelledby，无标题兜底 aria-label（Popover.dialogLabel）", "触发元素 aria-haspopup=dialog + aria-expanded，open 时 aria-controls 指向浮层", "click 触发用 useDismiss 处理 Escape（closeOnEsc）与外部点击（closeOnOutsideClick）关闭", "trapFocus（默认随 click）用 useFocusTrap 陷入焦点并循环 Tab，关闭后 returnFocus 归还触发器；rememberFocus 可恢复上次焦点", "lockScroll 用 useScrollLock 锁背景滚动；motion 进场动画在 reduced-motion 下退化", "custom 触发完全受控，不启用 useDismiss，由调用方控制显隐"];
+        readonly notes: readonly ["role 派生：trigger=click/custom → dialog（承可交互富内容，aria-modal=false，有标题 aria-labelledby、无标题兜底 aria-label Popover.dialogLabel）；hover/focus → tooltip", "触发元素在 dialog 模式承载 button 角色 + aria-haspopup=dialog / aria-expanded / aria-controls；tooltip 模式为纯 span + aria-describedby", "click/custom 触发用 useDismiss 处理 Escape（closeOnEsc）与外部点击（onClickOutSide）关闭", "dialog 模式 guardFocus 用 useFocusTrap 陷入焦点循环 Tab，关闭后 returnFocusOnClose 归还触发器", "content 函数形态可将初始焦点落到 initialFocusRef 指定元素；condition=false 禁止一切自动触发（custom 不受影响）", "定位/触发/焦点/dismiss 复用 Tooltip（prefixCls=cd-popover 切换整套浮层类名前缀），对齐 Semi Popover extends Tooltip；箭头为 Popover 独立双 path SVG（描边+背景，8px），与 Tooltip 单 path 解耦"];
     };
-    readonly tokens: readonly ["--cd-popover-*", "--cd-spacing-*", "--cd-focus-ring", "--cd-motion-*"];
+    readonly tokens: readonly ["--cd-color-popover-bg-default", "--cd-color-popover-border-default", "--cd-radius-popover", "--cd-shadow-elevated", "--cd-filter-popover-bg", "--cd-z-popover", "--cd-spacing-popover-title-padding", "--cd-spacing-popover-witharrow-padding", "--cd-width-popover-title-border", "--cd-color-text-0", "--cd-color-popover-arrow-bg", "--cd-color-popover-arrow-border", "--cd-width-popover-arrow", "--cd-height-popover-arrow", "--cd-width-popover-arrow-vertical", "--cd-height-popover-arrow-vertical", "--cd-spacing-popover-arrow-adjusted-offset-x", "--cd-spacing-popover-arrow-adjusted-offset-y", "--cd-spacing-tooltip-arrow-offset-x", "--cd-spacing-tooltip-arrow-offset-y", "--cd-animation-duration-tooltip-in", "--cd-animation-function-tooltip-in"];
 };
 //# sourceMappingURL=meta.d.ts.map

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

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