@chenzy-design/svelte 0.1.0

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

@@ -0,0 +1,75 @@
+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;
+}
+interface Props {
+    content?: string | Snippet;
+    title?: string | Snippet;
+    open?: boolean;
+    defaultOpen?: boolean;
+    trigger?: TriggerKind;
+    position?: Position;
+    align?: Align;
+    /** 视口溢出时翻转到对侧 */
+    autoAdjustOverflow?: boolean;
+    showArrow?: boolean;
+    /** start/end 对齐时箭头指向触发器中心（默认 false：贴对齐边） */
+    arrowPointAtCenter?: boolean;
+    spacing?: number;
+    mouseEnterDelay?: number;
+    mouseLeaveDelay?: number;
+    disabled?: boolean;
+    /** 浮层挂载容器，缺省回退 ConfigProvider 全局，再回退 document.body。非 body 容器时 floating 改 absolute 定位。 */
+    getPopupContainer?: () => HTMLElement | null | undefined;
+    /** 浮层层级，缺省走 token var(--cd-popover-z) */
+    zIndex?: number;
+    /** 是否陷入焦点（Tab 循环），缺省随 trigger==='click' */
+    trapFocus?: boolean;
+    /** 关闭后焦点是否归还触发器（仅 trapFocus 时生效），默认 true */
+    returnFocus?: boolean;
+    /** Esc 关闭，默认 true（custom 触发不生效） */
+    closeOnEsc?: boolean;
+    /** 外部点击关闭，默认 true（custom 触发不生效） */
+    closeOnOutsideClick?: boolean;
+    /** 打开时锁定背景滚动，默认 false（非阻断） */
+    lockScroll?: boolean;
+    /** 关闭时销毁浮层 DOM，默认 false（首开后保留，仅 --hidden 隐藏） */
+    destroyOnClose?: boolean;
+    /** 重新打开时恢复上次浮层内焦点位置（仅 trapFocus 时生效），默认 false */
+    rememberFocus?: boolean;
+    /** 阻断浮层内事件冒泡，默认 false */
+    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;
+    children?: Snippet;
+    contentSlot?: Snippet;
+}
+declare const Popover: import("svelte").Component<Props, {}, "">;
+type Popover = ReturnType<typeof Popover>;
+export default Popover;
+//# sourceMappingURL=Popover.svelte.d.ts.map

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

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

package/dist/popover/PopoverA11yFixture.svelte

@@ -0,0 +1,35 @@
+<!--
+  Popover a11y 测试夹具：在 LocaleProvider 内渲染 Popover。
+  children 仅作触发文案（非交互）——dialog 模式下 Popover 的触发包裹 span 自身承载
+  role=button + tabindex=0 + Enter/Space 激活（对齐 Dropdown），故 children 不再嵌套
+  原生 <button>（否则 role=button 包裹可聚焦元素 → axe nested-interactive）。
+  仅供 Popover.a11y.test.ts 使用，不对外导出。
+-->
+<script lang="ts">
+  import { LocaleProvider } from '../locale-provider/index.js';
+  import Popover from './Popover.svelte';
+
+  interface Props {
+    open?: boolean;
+    content?: string;
+    title?: string | undefined;
+    trigger?: 'hover' | 'click' | 'focus' | 'custom';
+    locale?: string;
+  }
+
+  let {
+    open = false,
+    content = 'Popover body content',
+    title,
+    trigger = 'custom',
+    locale = 'en_US',
+  }: Props = $props();
+</script>
+
+<LocaleProvider {locale}>
+  {#if title !== undefined}
+    <Popover {open} {content} {title} {trigger}>Open</Popover>
+  {:else}
+    <Popover {open} {content} {trigger}>Open</Popover>
+  {/if}
+</LocaleProvider>

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

@@ -0,0 +1,11 @@
+interface Props {
+    open?: boolean;
+    content?: string;
+    title?: string | undefined;
+    trigger?: 'hover' | 'click' | 'focus' | 'custom';
+    locale?: string;
+}
+declare const PopoverA11yFixture: import("svelte").Component<Props, {}, "">;
+type PopoverA11yFixture = ReturnType<typeof PopoverA11yFixture>;
+export default PopoverA11yFixture;
+//# sourceMappingURL=PopoverA11yFixture.svelte.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PopoverA11yFixture.svelte.d.ts","sourceRoot":"","sources":["../../src/popover/PopoverA11yFixture.svelte.ts"],"names":[],"mappings":"AAOE,UAAU,KAAK;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA0BH,QAAA,MAAM,kBAAkB,2CAAwC,CAAC;AACjE,KAAK,kBAAkB,GAAG,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAChE,eAAe,kBAAkB,CAAC"}

package/dist/popover/PopoverKbdFixture.svelte

@@ -0,0 +1,18 @@
+<!--
+  仅供 Popover.kbd.test.ts（browser project）使用的 dialog 模式 Esc 归还 e2e 夹具。
+  trigger='click'：触发器 span 承载 role=button + tabindex=0，点击打开浮层（dialog 角色，
+  trapFocus 默认随 click），Esc 关闭并归还焦点到触发器。content 含一个按钮供焦点陷阱断言。
+-->
+<script lang="ts">
+  import { LocaleProvider } from '../locale-provider/index.js';
+  import Popover from './Popover.svelte';
+</script>
+
+<LocaleProvider locale="en_US">
+  <Popover trigger="click" title="More info">
+    {#snippet contentSlot()}
+      <button type="button" data-testid="pop-btn">action</button>
+    {/snippet}
+    Open
+  </Popover>
+</LocaleProvider>

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

@@ -0,0 +1,19 @@
+interface $$__sveltets_2_IsomorphicComponent<Props extends Record<string, any> = any, Events extends Record<string, any> = any, Slots extends Record<string, any> = any, Exports = {}, Bindings = string> {
+    new (options: import('svelte').ComponentConstructorOptions<Props>): import('svelte').SvelteComponent<Props, Events, Slots> & {
+        $$bindings?: Bindings;
+    } & Exports;
+    (internal: unknown, props: {
+        $$events?: Events;
+        $$slots?: Slots;
+    }): Exports & {
+        $set?: any;
+        $on?: any;
+    };
+    z_$$bindings?: Bindings;
+}
+declare const PopoverKbdFixture: $$__sveltets_2_IsomorphicComponent<Record<string, never>, {
+    [evt: string]: CustomEvent<any>;
+}, {}, {}, string>;
+type PopoverKbdFixture = InstanceType<typeof PopoverKbdFixture>;
+export default PopoverKbdFixture;
+//# sourceMappingURL=PopoverKbdFixture.svelte.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PopoverKbdFixture.svelte.d.ts","sourceRoot":"","sources":["../../src/popover/PopoverKbdFixture.svelte.ts"],"names":[],"mappings":"AAuBA,UAAU,kCAAkC,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,OAAO,GAAG,EAAE,EAAE,QAAQ,GAAG,MAAM;IACpM,KAAK,OAAO,EAAE,OAAO,QAAQ,EAAE,2BAA2B,CAAC,KAAK,CAAC,GAAG,OAAO,QAAQ,EAAE,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,GAAG;QAAE,UAAU,CAAC,EAAE,QAAQ,CAAA;KAAE,GAAG,OAAO,CAAC;IACjK,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,KAAK,CAAA;KAAC,GAAG,OAAO,GAAG;QAAE,IAAI,CAAC,EAAE,GAAG,CAAC;QAAC,GAAG,CAAC,EAAE,GAAG,CAAA;KAAE,CAAC;IACtG,YAAY,CAAC,EAAE,QAAQ,CAAC;CAC3B;AAKD,QAAA,MAAM,iBAAiB;;kBAA+E,CAAC;AACrF,KAAK,iBAAiB,GAAG,YAAY,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAClE,eAAe,iBAAiB,CAAC"}

package/dist/popover/index.d.ts

@@ -0,0 +1,3 @@
+export { default as Popover } from './Popover.svelte';
+export { meta as popoverMeta } from './meta.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/popover/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,IAAI,IAAI,WAAW,EAAE,MAAM,WAAW,CAAC"}

package/dist/popover/index.js

@@ -0,0 +1,2 @@
+export { default as Popover } from './Popover.svelte';
+export { meta as popoverMeta } from './meta.js';

package/dist/popover/meta.d.ts

@@ -0,0 +1,156 @@
+/**
+ * Machine-readable component metadata for AI/docs consumption.
+ * See specs/00-foundation/ai-friendly.spec.md.
+ */
+export declare const meta: {
+    readonly name: "Popover";
+    readonly category: "show";
+    readonly description: "气泡卡片，点击/悬停/聚焦触发元素时弹出富内容浮层。支持标题、常用 position、对齐、箭头与间距，浮层纯 CSS 定位。";
+    readonly props: readonly [{
+        readonly name: "content";
+        readonly type: "string | Snippet";
+        readonly default: "undefined";
+        readonly desc: "简单文本内容";
+    }, {
+        readonly name: "title";
+        readonly type: "string | Snippet";
+        readonly default: "undefined";
+        readonly desc: "标题，提供则渲染标题区与下边框";
+    }, {
+        readonly name: "open";
+        readonly type: "boolean";
+        readonly default: "undefined";
+        readonly desc: "受控显隐";
+    }, {
+        readonly name: "defaultOpen";
+        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 name: "position";
+        readonly type: "'top'|'bottom'|'left'|'right'";
+        readonly default: "bottom";
+        readonly desc: "浮层主方向";
+    }, {
+        readonly name: "align";
+        readonly type: "'start'|'center'|'end'";
+        readonly default: "center";
+        readonly desc: "交叉轴对齐";
+    }, {
+        readonly name: "showArrow";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "是否显示箭头";
+    }, {
+        readonly name: "arrowPointAtCenter";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "start/end 对齐时箭头指向触发器中心";
+    }, {
+        readonly name: "spacing";
+        readonly type: "number";
+        readonly default: "8";
+        readonly desc: "浮层与触发器间距(px)";
+    }, {
+        readonly name: "mouseEnterDelay";
+        readonly type: "number";
+        readonly default: "100";
+        readonly desc: "hover 进入延迟(ms)";
+    }, {
+        readonly name: "mouseLeaveDelay";
+        readonly type: "number";
+        readonly default: "100";
+        readonly desc: "hover 离开延迟(ms)";
+    }, {
+        readonly name: "disabled";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "禁用触发";
+    }, {
+        readonly name: "getPopupContainer";
+        readonly type: "() => HTMLElement";
+        readonly default: "() => body";
+        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 name: "returnFocus";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "关闭后焦点是否归还触发器（仅 trapFocus 生效）";
+    }, {
+        readonly name: "closeOnEsc";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "Esc 关闭";
+    }, {
+        readonly name: "closeOnOutsideClick";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "外部点击关闭";
+    }, {
+        readonly name: "lockScroll";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "打开时锁定背景滚动";
+    }, {
+        readonly name: "destroyOnClose";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "关闭时销毁浮层 DOM";
+    }, {
+        readonly name: "rememberFocus";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "重新打开时恢复上次浮层内焦点位置（仅 trapFocus 生效）";
+    }, {
+        readonly name: "stopPropagation";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "阻断浮层内事件冒泡";
+    }, {
+        readonly name: "size";
+        readonly type: "'small'|'default'|'large'";
+        readonly default: "default";
+        readonly desc: "内边距尺寸档位";
+    }, {
+        readonly name: "motion";
+        readonly type: "boolean | { duration?: number }";
+        readonly default: "true";
+        readonly desc: "动画开关/配置，reduced-motion 退化";
+    }, {
+        readonly name: "onOpenChange";
+        readonly type: "(open: boolean) => void";
+        readonly default: "undefined";
+    }, {
+        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 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 tokens: readonly ["--cd-popover-*", "--cd-spacing-*", "--cd-focus-ring", "--cd-motion-*"];
+};
+//# sourceMappingURL=meta.d.ts.map

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

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

package/dist/popover/meta.js

@@ -0,0 +1,102 @@
+/**
+ * Machine-readable component metadata for AI/docs consumption.
+ * See specs/00-foundation/ai-friendly.spec.md.
+ */
+export const meta = {
+    name: 'Popover',
+    category: 'show',
+    description: '气泡卡片，点击/悬停/聚焦触发元素时弹出富内容浮层。支持标题、常用 position、对齐、箭头与间距，浮层纯 CSS 定位。',
+    props: [
+        { name: 'content', type: 'string | Snippet', default: 'undefined', desc: '简单文本内容' },
+        { name: 'title', type: 'string | Snippet', default: 'undefined', desc: '标题，提供则渲染标题区与下边框' },
+        { name: 'open', type: 'boolean', default: 'undefined', desc: '受控显隐' },
+        { name: 'defaultOpen', type: 'boolean', default: 'false', desc: '非受控初始显隐' },
+        { name: 'trigger', type: "'hover'|'click'|'focus'|'custom'", default: 'hover', desc: "触发方式；custom 时显隐完全由受控 open + onOpenChange 控制，不自动响应交互、不启用外部点击/Esc 关闭" },
+        { name: 'position', type: "'top'|'bottom'|'left'|'right'", default: 'bottom', desc: '浮层主方向' },
+        { name: 'align', type: "'start'|'center'|'end'", default: 'center', desc: '交叉轴对齐' },
+        { name: 'showArrow', type: 'boolean', default: 'true', desc: '是否显示箭头' },
+        {
+            name: 'arrowPointAtCenter',
+            type: 'boolean',
+            default: 'false',
+            desc: 'start/end 对齐时箭头指向触发器中心',
+        },
+        { name: 'spacing', type: 'number', default: '8', desc: '浮层与触发器间距(px)' },
+        { name: 'mouseEnterDelay', type: 'number', default: '100', desc: 'hover 进入延迟(ms)' },
+        { name: 'mouseLeaveDelay', type: 'number', default: '100', desc: 'hover 离开延迟(ms)' },
+        { name: 'disabled', type: 'boolean', default: 'false', desc: '禁用触发' },
+        {
+            name: 'getPopupContainer',
+            type: '() => HTMLElement',
+            default: '() => body',
+            desc: '浮层挂载容器，回退 ConfigProvider 全局再回退 body',
+        },
+        { name: 'zIndex', type: 'number', default: 'var(--cd-popover-z)', desc: '浮层层级' },
+        {
+            name: 'trapFocus',
+            type: 'boolean',
+            default: "trigger==='click'",
+            desc: '是否陷入焦点（Tab 循环）',
+        },
+        {
+            name: 'returnFocus',
+            type: 'boolean',
+            default: 'true',
+            desc: '关闭后焦点是否归还触发器（仅 trapFocus 生效）',
+        },
+        { name: 'closeOnEsc', type: 'boolean', default: 'true', desc: 'Esc 关闭' },
+        {
+            name: 'closeOnOutsideClick',
+            type: 'boolean',
+            default: 'true',
+            desc: '外部点击关闭',
+        },
+        { name: 'lockScroll', type: 'boolean', default: 'false', desc: '打开时锁定背景滚动' },
+        {
+            name: 'destroyOnClose',
+            type: 'boolean',
+            default: 'false',
+            desc: '关闭时销毁浮层 DOM',
+        },
+        {
+            name: 'rememberFocus',
+            type: 'boolean',
+            default: 'false',
+            desc: '重新打开时恢复上次浮层内焦点位置（仅 trapFocus 生效）',
+        },
+        {
+            name: 'stopPropagation',
+            type: 'boolean',
+            default: 'false',
+            desc: '阻断浮层内事件冒泡',
+        },
+        {
+            name: 'size',
+            type: "'small'|'default'|'large'",
+            default: 'default',
+            desc: '内边距尺寸档位',
+        },
+        {
+            name: 'motion',
+            type: 'boolean | { duration?: number }',
+            default: 'true',
+            desc: '动画开关/配置，reduced-motion 退化',
+        },
+        { name: 'onOpenChange', type: '(open: boolean) => void', default: 'undefined' },
+        { name: 'children', type: 'Snippet', default: 'undefined', desc: '触发元素（必填）' },
+        { name: 'contentSlot', type: 'Snippet', default: 'undefined', desc: '富内容，优先于 content' },
+    ],
+    a11y: {
+        role: 'dialog',
+        keyboard: ['Escape', 'Tab', 'Shift+Tab'],
+        notes: [
+            '浮层 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，由调用方控制显隐',
+        ],
+    },
+    tokens: ['--cd-popover-*', '--cd-spacing-*', '--cd-focus-ring', '--cd-motion-*'],
+};

package/dist/progress/Progress.a11y.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Progress.a11y.test.d.ts.map

package/dist/progress/Progress.a11y.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Progress.a11y.test.d.ts","sourceRoot":"","sources":["../../src/progress/Progress.a11y.test.ts"],"names":[],"mappings":""}

package/dist/progress/Progress.a11y.test.js

@@ -0,0 +1,34 @@
+// Progress a11y：role=progressbar + aria-valuenow/min/max；indeterminate 省略 valuenow 并设 aria-busy。
+import { describe, it, expect } from 'vitest';
+import { renderWithLocale, expectNoAxeViolations } from '../test-utils/a11y.js';
+import Progress from './Progress.svelte';
+describe('Progress a11y', () => {
+    it('line：role=progressbar + aria-valuenow，无 axe violations', async () => {
+        const { container } = renderWithLocale(Progress, {
+            props: { percent: 42, ariaLabel: 'Upload progress' },
+        });
+        const bar = container.querySelector('[role="progressbar"]');
+        expect(bar).not.toBeNull();
+        expect(bar?.getAttribute('aria-valuenow')).toBe('42');
+        expect(bar?.getAttribute('aria-valuemin')).toBe('0');
+        expect(bar?.getAttribute('aria-valuemax')).toBe('100');
+        await expectNoAxeViolations(container);
+    });
+    it('circle：role=progressbar，无 axe violations', async () => {
+        const { container } = renderWithLocale(Progress, {
+            props: { type: 'circle', percent: 70, ariaLabel: 'Task' },
+        });
+        const bar = container.querySelector('[role="progressbar"]');
+        expect(bar?.getAttribute('aria-valuenow')).toBe('70');
+        await expectNoAxeViolations(container);
+    });
+    it('indeterminate：省略 aria-valuenow 并设 aria-busy，无 axe violations', async () => {
+        const { container } = renderWithLocale(Progress, {
+            props: { indeterminate: true, ariaLabel: 'Loading' },
+        });
+        const bar = container.querySelector('[role="progressbar"]');
+        expect(bar?.getAttribute('aria-valuenow')).toBeNull();
+        expect(bar?.getAttribute('aria-busy')).toBe('true');
+        await expectNoAxeViolations(container);
+    });
+});