@chenzy-design/svelte 0.1.0

package/dist/carousel/Carousel.svelte.d.ts

@@ -0,0 +1,67 @@
+import type { Snippet } from 'svelte';
+type Animation = 'slide' | 'fade';
+type IndicatorType = 'dot' | 'line' | 'columnar';
+type IndicatorPosition = 'left' | 'center' | 'right';
+type IndicatorSize = 'small' | 'medium';
+type Theme = 'primary' | 'light' | 'dark';
+type ArrowType = 'hover' | 'always';
+type SlideDirection = 'left' | 'right';
+type TriggerType = 'hover' | 'click';
+/** autoPlay 对象形式：{ interval?, hoverToPause? } */
+type AutoPlayConfig = {
+    interval?: number;
+    hoverToPause?: boolean;
+};
+interface ArrowSlotProps {
+    children?: Snippet;
+    onClick?: () => void;
+}
+interface Props {
+    slides?: Snippet[];
+    /** 受控当前激活索引（Semi API: activeIndex） */
+    activeIndex?: number;
+    value?: number;
+    defaultActiveIndex?: number;
+    /** 自动播放；支持布尔或对象形式 { interval?, hoverToPause? } */
+    autoPlay?: boolean | AutoPlayConfig;
+    /** @deprecated 请用 autoPlay */
+    autoplay?: boolean;
+    interval?: number;
+    loop?: boolean;
+    animation?: Animation;
+    speed?: number;
+    slidesToShow?: number;
+    slidesToScroll?: number;
+    vertical?: boolean;
+    draggable?: boolean;
+    showIndicator?: boolean;
+    indicatorType?: IndicatorType;
+    /** 指示器位置（横向：left/center/right） */
+    indicatorPosition?: IndicatorPosition;
+    /** 指示器尺寸 */
+    indicatorSize?: IndicatorSize;
+    showArrow?: boolean;
+    /** 箭头展示时机：hover=悬停时显示，always=始终显示 */
+    arrowType?: ArrowType;
+    /** 自定义箭头内容与点击回调 */
+    arrowProps?: {
+        leftArrow?: ArrowSlotProps;
+        rightArrow?: ArrowSlotProps;
+    };
+    hoverToPause?: boolean;
+    /** 主题 */
+    theme?: Theme;
+    /** 动画滑动方向 */
+    slideDirection?: SlideDirection;
+    /** 指示器触发切换的交互方式 */
+    trigger?: TriggerType;
+    height?: number | string;
+    ariaLabel?: string;
+    onChange?: (index: number) => void;
+    onPlayStateChange?: (playing: boolean) => void;
+    class?: string;
+}
+declare const Carousel: import("svelte").Component<Props, {}, "">;
+type Carousel = ReturnType<typeof Carousel>;
+export default Carousel;
+//# sourceMappingURL=Carousel.svelte.d.ts.map

package/dist/carousel/Carousel.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Carousel.svelte.d.ts","sourceRoot":"","sources":["../../src/carousel/Carousel.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAMpC,KAAK,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAClC,KAAK,aAAa,GAAG,KAAK,GAAG,MAAM,GAAG,UAAU,CAAC;AACjD,KAAK,iBAAiB,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AACrD,KAAK,aAAa,GAAG,OAAO,GAAG,QAAQ,CAAC;AACxC,KAAK,KAAK,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAC1C,KAAK,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;AACpC,KAAK,cAAc,GAAG,MAAM,GAAG,OAAO,CAAC;AACvC,KAAK,WAAW,GAAG,OAAO,GAAG,OAAO,CAAC;AAErC,iDAAiD;AACjD,KAAK,cAAc,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAEpE,UAAU,cAAc;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED,UAAU,KAAK;IACb,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;IACnB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kDAAkD;IAClD,QAAQ,CAAC,EAAE,OAAO,GAAG,cAAc,CAAC;IACpC,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,kCAAkC;IAClC,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,YAAY;IACZ,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,qCAAqC;IACrC,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,mBAAmB;IACnB,UAAU,CAAC,EAAE;QACX,SAAS,CAAC,EAAE,cAAc,CAAC;QAC3B,UAAU,CAAC,EAAE,cAAc,CAAC;KAC7B,CAAC;IACF,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,SAAS;IACT,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,aAAa;IACb,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,mBAAmB;IACnB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAqXH,QAAA,MAAM,QAAQ,2CAAwC,CAAC;AACvD,KAAK,QAAQ,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC;AAC5C,eAAe,QAAQ,CAAC"}

package/dist/carousel/CarouselA11yFixture.svelte

@@ -0,0 +1,25 @@
+<!--
+  仅供 Carousel.a11y.test.ts 使用的测试夹具：传入真实 slides Snippet[]。
+  count(3) > perView(1) 时渲染箭头/指示器；autoplay 时渲染播放/暂停按钮（WCAG 2.2.2）。
+-->
+<script lang="ts">
+  import { Carousel } from './index.js';
+
+  interface Props {
+    autoplay?: boolean;
+    ariaLabel?: string;
+  }
+  let { autoplay = false, ariaLabel = undefined }: Props = $props();
+</script>
+
+{#snippet s1()}
+  <div>Slide one</div>
+{/snippet}
+{#snippet s2()}
+  <div>Slide two</div>
+{/snippet}
+{#snippet s3()}
+  <div>Slide three</div>
+{/snippet}
+
+<Carousel slides={[s1, s2, s3]} {autoplay} {...ariaLabel !== undefined ? { ariaLabel } : {}} />

package/dist/carousel/CarouselA11yFixture.svelte.d.ts

@@ -0,0 +1,8 @@
+interface Props {
+    autoplay?: boolean;
+    ariaLabel?: string;
+}
+declare const CarouselA11yFixture: import("svelte").Component<Props, {}, "">;
+type CarouselA11yFixture = ReturnType<typeof CarouselA11yFixture>;
+export default CarouselA11yFixture;
+//# sourceMappingURL=CarouselA11yFixture.svelte.d.ts.map

package/dist/carousel/CarouselA11yFixture.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CarouselA11yFixture.svelte.d.ts","sourceRoot":"","sources":["../../src/carousel/CarouselA11yFixture.svelte.ts"],"names":[],"mappings":"AAME,UAAU,KAAK;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAsBH,QAAA,MAAM,mBAAmB,2CAAwC,CAAC;AAClE,KAAK,mBAAmB,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAClE,eAAe,mBAAmB,CAAC"}

package/dist/carousel/CarouselKbdFixture.svelte

@@ -0,0 +1,24 @@
+<!--
+  仅供 Carousel.kbd.test.ts（browser project）使用的键盘 e2e 夹具。
+  viewport（role=group, aria-roledescription=slides）count>perView 时 tabindex=0 可聚焦，
+  承接 ←/→/Home/End 切换 active slide。非 active slide 设 inert + aria-hidden。
+  autoplay 关闭、loop 关闭，使 active slide 变化可确定断言（首/末有界）。
+  每张 slide 含 data-slide 标记便于定位。
+-->
+<script lang="ts">
+  import { LocaleProvider } from '../locale-provider/index.js';
+  import Carousel from './Carousel.svelte';
+</script>
+
+{#snippet s0()}<div data-slide="0">Slide 0</div>{/snippet}
+{#snippet s1()}<div data-slide="1">Slide 1</div>{/snippet}
+{#snippet s2()}<div data-slide="2">Slide 2</div>{/snippet}
+
+<LocaleProvider locale="en_US">
+  <Carousel
+    slides={[s0, s1, s2]}
+    autoplay={false}
+    loop={false}
+    ariaLabel="Demo carousel"
+  />
+</LocaleProvider>

package/dist/carousel/CarouselKbdFixture.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 CarouselKbdFixture: $$__sveltets_2_IsomorphicComponent<Record<string, never>, {
+    [evt: string]: CustomEvent<any>;
+}, {}, {}, string>;
+type CarouselKbdFixture = InstanceType<typeof CarouselKbdFixture>;
+export default CarouselKbdFixture;
+//# sourceMappingURL=CarouselKbdFixture.svelte.d.ts.map

package/dist/carousel/CarouselKbdFixture.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CarouselKbdFixture.svelte.d.ts","sourceRoot":"","sources":["../../src/carousel/CarouselKbdFixture.svelte.ts"],"names":[],"mappings":"AAsBA,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,kBAAkB;;kBAA+E,CAAC;AACtF,KAAK,kBAAkB,GAAG,YAAY,CAAC,OAAO,kBAAkB,CAAC,CAAC;AACpE,eAAe,kBAAkB,CAAC"}

package/dist/carousel/index.d.ts

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

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

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

package/dist/carousel/index.js

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

package/dist/carousel/meta.d.ts

@@ -0,0 +1,138 @@
+/**
+ * Machine-readable component metadata for AI/docs consumption.
+ * Carousel — see specs/components/show/Carousel.spec.md
+ */
+export declare const meta: {
+    readonly name: "Carousel";
+    readonly category: "show";
+    readonly description: "走马灯：单/多 slide 同屏展示（slidesToShow/slidesToScroll），支持 slide/fade 动画、autoplay（含 hoverToPause）、loop 循环、dot/line/columnar 指示器、prev/next 箭头、vertical 纵向方向、pointer 拖拽手势与受控 value。slide 通过 Snippet[] 传入。";
+    readonly exports: readonly ["Carousel"];
+    readonly props: readonly [{
+        readonly name: "slides";
+        readonly type: "Snippet[]";
+        readonly default: "[]";
+        readonly desc: "每项一张幻灯片的 Snippet 数组";
+    }, {
+        readonly name: "value";
+        readonly type: "number";
+        readonly default: "undefined";
+        readonly desc: "受控当前索引（不回写）";
+    }, {
+        readonly name: "defaultActiveIndex";
+        readonly type: "number";
+        readonly default: "0";
+        readonly desc: "非受控初始索引";
+    }, {
+        readonly name: "autoplay";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "自动播放";
+    }, {
+        readonly name: "interval";
+        readonly type: "number";
+        readonly default: "3000";
+        readonly desc: "自动播放间隔（ms）";
+    }, {
+        readonly name: "loop";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "循环（取模）；false 时 clamp 边界";
+    }, {
+        readonly name: "animation";
+        readonly type: "'slide'|'fade'";
+        readonly default: "'slide'";
+        readonly desc: "切换动画";
+    }, {
+        readonly name: "speed";
+        readonly type: "number";
+        readonly default: "300";
+        readonly desc: "切换动画时长（ms）";
+    }, {
+        readonly name: "slidesToShow";
+        readonly type: "number";
+        readonly default: "1";
+        readonly desc: "一屏同时展示的 slide 数（>1 强制 slide 轨道）";
+    }, {
+        readonly name: "slidesToScroll";
+        readonly type: "number";
+        readonly default: "1";
+        readonly desc: "每次切换滚动的 slide 数（步长）";
+    }, {
+        readonly name: "vertical";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "纵向滚动方向（指示器移至右侧、箭头改上/下）";
+    }, {
+        readonly name: "draggable";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "pointer 拖拽/滑动切换（拖过半张进位，否则回弹）";
+    }, {
+        readonly name: "showIndicator";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "显示底部指示器（按页数渲染）";
+    }, {
+        readonly name: "indicatorType";
+        readonly type: "'dot'|'line'|'columnar'";
+        readonly default: "'dot'";
+        readonly desc: "指示器样式：dot 圆点 / line 横线条 / columnar 竖栏（激活态加长高亮，纯 CSS，与 vertical 协调）";
+    }, {
+        readonly name: "showArrow";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "显示左右箭头";
+    }, {
+        readonly name: "hoverToPause";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "悬停暂停自动播放";
+    }, {
+        readonly name: "height";
+        readonly type: "number|string";
+        readonly default: "240";
+        readonly desc: "容器高度（数字按 px）";
+    }, {
+        readonly name: "ariaLabel";
+        readonly type: "string";
+        readonly default: "i18n Carousel.ariaLabel";
+        readonly desc: "走马灯整体可访问名（root role=region）";
+    }, {
+        readonly name: "onChange";
+        readonly type: "(index: number) => void";
+        readonly default: "undefined";
+        readonly desc: "索引变更回调";
+    }, {
+        readonly name: "onPlayStateChange";
+        readonly type: "(playing: boolean) => void";
+        readonly default: "undefined";
+        readonly desc: "播放/暂停按钮切换回调";
+    }, {
+        readonly name: "class";
+        readonly type: "string";
+        readonly default: "''";
+        readonly desc: "根类名透传";
+    }];
+    readonly events: readonly [{
+        readonly name: "onChange";
+        readonly desc: "当前索引变更（index）";
+    }, {
+        readonly name: "onPlayStateChange";
+        readonly desc: "autoplay 播放/暂停切换（playing）";
+    }];
+    readonly slots: readonly [{
+        readonly name: "slides";
+        readonly desc: "幻灯片 Snippet 数组，每项一张";
+    }];
+    readonly a11y: {
+        readonly role: "region";
+        readonly focusable: true;
+        readonly notes: readonly ["根 role=region aria-roledescription=\"carousel\" aria-label（i18n / ariaLabel）", "slide 区 aria-live=polite；autoplay 实际播放中降级为 off", "视口 role=group aria-roledescription=\"slides\"，tabindex=0 承接键盘导航与拖拽手势", "键盘：←/→ 切换、Home/End 跳首末（vertical 增 ↑/↓）；RTL 下 ←/→ 镜像", "每张 role=group aria-roledescription=\"slide\" aria-label「第 N 张」，非可见窗口内的张 aria-hidden + inert（不可 Tab 进入）", "autoplay 提供可见播放/暂停按钮（WCAG 2.2.2，aria-pressed），hover/键盘 focus 进入容器自动暂停", "指示器按钮 aria-label「第 N 张」；箭头按钮 aria-label 上一张/下一张", "reduced-motion 下切换过渡时长归零且 autoplay 不自启"];
+    };
+    readonly tokens: readonly ["--cd-carousel-radius", "--cd-carousel-indicator-color", "--cd-carousel-indicator-color-active", "--cd-carousel-indicator-gap", "--cd-carousel-arrow-bg", "--cd-carousel-arrow-color", "--cd-carousel-arrow-size", "--cd-radius-full", "--cd-focus-ring", "--cd-motion-duration-fast", "--cd-motion-ease-standard", "--cd-spacing-2"];
+    readonly examples: readonly [{
+        readonly title: "基础";
+        readonly code: "{#snippet s1()}<img src=\"/1.jpg\" alt=\"\" />{/snippet}\n{#snippet s2()}<img src=\"/2.jpg\" alt=\"\" />{/snippet}\n<Carousel slides={[s1, s2]} autoplay />";
+    }];
+};
+//# sourceMappingURL=meta.d.ts.map

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

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

package/dist/carousel/meta.js

@@ -0,0 +1,72 @@
+/**
+ * Machine-readable component metadata for AI/docs consumption.
+ * Carousel — see specs/components/show/Carousel.spec.md
+ */
+export const meta = {
+    name: 'Carousel',
+    category: 'show',
+    description: '走马灯：单/多 slide 同屏展示（slidesToShow/slidesToScroll），支持 slide/fade 动画、autoplay（含 hoverToPause）、loop 循环、dot/line/columnar 指示器、prev/next 箭头、vertical 纵向方向、pointer 拖拽手势与受控 value。slide 通过 Snippet[] 传入。',
+    exports: ['Carousel'],
+    props: [
+        { name: 'slides', type: 'Snippet[]', default: '[]', desc: '每项一张幻灯片的 Snippet 数组' },
+        { name: 'value', type: 'number', default: 'undefined', desc: '受控当前索引（不回写）' },
+        { name: 'defaultActiveIndex', type: 'number', default: '0', desc: '非受控初始索引' },
+        { name: 'autoplay', type: 'boolean', default: 'false', desc: '自动播放' },
+        { name: 'interval', type: 'number', default: '3000', desc: '自动播放间隔（ms）' },
+        { name: 'loop', type: 'boolean', default: 'true', desc: '循环（取模）；false 时 clamp 边界' },
+        { name: 'animation', type: "'slide'|'fade'", default: "'slide'", desc: '切换动画' },
+        { name: 'speed', type: 'number', default: '300', desc: '切换动画时长（ms）' },
+        { name: 'slidesToShow', type: 'number', default: '1', desc: '一屏同时展示的 slide 数（>1 强制 slide 轨道）' },
+        { name: 'slidesToScroll', type: 'number', default: '1', desc: '每次切换滚动的 slide 数（步长）' },
+        { name: 'vertical', type: 'boolean', default: 'false', desc: '纵向滚动方向（指示器移至右侧、箭头改上/下）' },
+        { name: 'draggable', type: 'boolean', default: 'true', desc: 'pointer 拖拽/滑动切换（拖过半张进位，否则回弹）' },
+        { name: 'showIndicator', type: 'boolean', default: 'true', desc: '显示底部指示器（按页数渲染）' },
+        { name: 'indicatorType', type: "'dot'|'line'|'columnar'", default: "'dot'", desc: '指示器样式：dot 圆点 / line 横线条 / columnar 竖栏（激活态加长高亮，纯 CSS，与 vertical 协调）' },
+        { name: 'showArrow', type: 'boolean', default: 'true', desc: '显示左右箭头' },
+        { name: 'hoverToPause', type: 'boolean', default: 'true', desc: '悬停暂停自动播放' },
+        { name: 'height', type: 'number|string', default: '240', desc: '容器高度（数字按 px）' },
+        { name: 'ariaLabel', type: 'string', default: 'i18n Carousel.ariaLabel', desc: '走马灯整体可访问名（root role=region）' },
+        { name: 'onChange', type: '(index: number) => void', default: 'undefined', desc: '索引变更回调' },
+        { name: 'onPlayStateChange', type: '(playing: boolean) => void', default: 'undefined', desc: '播放/暂停按钮切换回调' },
+        { name: 'class', type: 'string', default: "''", desc: '根类名透传' },
+    ],
+    events: [
+        { name: 'onChange', desc: '当前索引变更（index）' },
+        { name: 'onPlayStateChange', desc: 'autoplay 播放/暂停切换（playing）' },
+    ],
+    slots: [{ name: 'slides', desc: '幻灯片 Snippet 数组，每项一张' }],
+    a11y: {
+        role: 'region',
+        focusable: true,
+        notes: [
+            '根 role=region aria-roledescription="carousel" aria-label（i18n / ariaLabel）',
+            'slide 区 aria-live=polite；autoplay 实际播放中降级为 off',
+            '视口 role=group aria-roledescription="slides"，tabindex=0 承接键盘导航与拖拽手势',
+            '键盘：←/→ 切换、Home/End 跳首末（vertical 增 ↑/↓）；RTL 下 ←/→ 镜像',
+            '每张 role=group aria-roledescription="slide" aria-label「第 N 张」，非可见窗口内的张 aria-hidden + inert（不可 Tab 进入）',
+            'autoplay 提供可见播放/暂停按钮（WCAG 2.2.2，aria-pressed），hover/键盘 focus 进入容器自动暂停',
+            '指示器按钮 aria-label「第 N 张」；箭头按钮 aria-label 上一张/下一张',
+            'reduced-motion 下切换过渡时长归零且 autoplay 不自启',
+        ],
+    },
+    tokens: [
+        '--cd-carousel-radius',
+        '--cd-carousel-indicator-color',
+        '--cd-carousel-indicator-color-active',
+        '--cd-carousel-indicator-gap',
+        '--cd-carousel-arrow-bg',
+        '--cd-carousel-arrow-color',
+        '--cd-carousel-arrow-size',
+        '--cd-radius-full',
+        '--cd-focus-ring',
+        '--cd-motion-duration-fast',
+        '--cd-motion-ease-standard',
+        '--cd-spacing-2',
+    ],
+    examples: [
+        {
+            title: '基础',
+            code: '{#snippet s1()}<img src="/1.jpg" alt="" />{/snippet}\n{#snippet s2()}<img src="/2.jpg" alt="" />{/snippet}\n<Carousel slides={[s1, s2]} autoplay />',
+        },
+    ],
+};

package/dist/cascader/Cascader.a11y.test.d.ts

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

package/dist/cascader/Cascader.a11y.test.d.ts.map

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

package/dist/cascader/Cascader.a11y.test.js

@@ -0,0 +1,55 @@
+// Cascader a11y：combobox 触发器 + 每列 listbox/option 浮层（use:floating portal 到 body）。
+// 只断言静态 ARIA + axe 0 violations，不测真实键盘/焦点（jsdom 限制）。
+// 打开态面板 portal 到 document.body，故扫描 document.body。
+import { describe, it, expect } from 'vitest';
+import { renderWithLocale, expectNoAxeViolations } from '../test-utils/a11y.js';
+import Cascader from './Cascader.svelte';
+const treeData = [
+    {
+        label: 'Zhejiang',
+        value: 'zj',
+        children: [
+            { label: 'Hangzhou', value: 'hz', children: [{ label: 'West Lake', value: 'xh' }] },
+        ],
+    },
+    {
+        label: 'Jiangsu',
+        value: 'js',
+        children: [{ label: 'Nanjing', value: 'nj' }],
+    },
+];
+describe('Cascader a11y', () => {
+    it('关闭态：触发器 role=combobox / aria-expanded=false，无 axe violations', async () => {
+        const { container } = renderWithLocale(Cascader, {
+            props: { treeData, ariaLabel: 'Region', placeholder: 'Select region' },
+        });
+        const combobox = container.querySelector('[role="combobox"]');
+        expect(combobox).not.toBeNull();
+        expect(combobox?.getAttribute('aria-expanded')).toBe('false');
+        expect(combobox?.getAttribute('aria-haspopup')).toBe('listbox');
+        expect(combobox?.getAttribute('aria-label')).toBe('Region');
+        await expectNoAxeViolations(container);
+    });
+    // 每列 listbox 经 locale Cascader.columnLabel 获可访问名（「第 N 级选项」）。
+    it('打开态：面板列 listbox + option 渲染（portal 到 body），无 axe violations', async () => {
+        renderWithLocale(Cascader, {
+            props: { treeData, defaultOpen: true, ariaLabel: 'Region' },
+        });
+        const listbox = document.querySelector('[role="listbox"]');
+        expect(listbox).not.toBeNull();
+        expect(listbox?.getAttribute('aria-label')).toBeTruthy();
+        const optionEls = document.querySelectorAll('[role="option"]');
+        expect(optionEls.length).toBeGreaterThan(0);
+        await expectNoAxeViolations(document.body);
+    });
+    it('已选路径：触发器 aria-expanded 切换，选中 option 标记 aria-selected', async () => {
+        renderWithLocale(Cascader, {
+            props: { treeData, defaultOpen: true, defaultValue: ['zj', 'hz', 'xh'], ariaLabel: 'Region' },
+        });
+        const combobox = document.querySelector('[role="combobox"]');
+        expect(combobox?.getAttribute('aria-expanded')).toBe('true');
+        const selected = document.querySelector('[role="option"][aria-selected="true"]');
+        expect(selected).not.toBeNull();
+        await expectNoAxeViolations(document.body);
+    });
+});

package/dist/cascader/Cascader.kbd.test.d.ts

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

package/dist/cascader/Cascader.kbd.test.d.ts.map

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

package/dist/cascader/Cascader.kbd.test.js

@@ -0,0 +1,47 @@
+// Cascader 键盘 e2e（browser project / 真实 chromium），浮层列内方向键 roving。
+// Cascader 高亮走 aria-activedescendant 模型：焦点留在 role=combobox 触发器上
+// （options tabindex=-1，从不真实聚焦），列内高亮由触发器 aria-activedescendant
+// 指向的 option id 表达。故断言 activedescendant 指向的 option 文本变化，而非 toHaveFocus。
+// 浮层经 use:floating portal 到 document.body —— 在 document 范围查列 listbox。
+//   1. 打开后首次 ↓ 进首列首项；再 ↓ 移列内下一项；↑ 回上一项。
+//   2. Home/End 跳列内首/末项。
+import { describe, it, expect } from 'vitest';
+import { renderKbdFixture, userEvent } from '../test-utils/kbd.js';
+import CascaderKbdFixture from './CascaderKbdFixture.svelte';
+// 读触发器 aria-activedescendant 指向的 option，断言其 label（剥离展开箭头 ›）。
+function activeOptionText(combobox) {
+    const id = combobox.getAttribute('aria-activedescendant');
+    if (!id)
+        return null;
+    const el = document.getElementById(id);
+    const label = el?.querySelector('.cd-cascader__option-label');
+    return label?.textContent?.trim() ?? null;
+}
+describe('Cascader 键盘 e2e（aria-activedescendant 列内 roving）', () => {
+    it('打开后 ↑↓ 列内移高亮 + Home/End 列内首末', async () => {
+        renderKbdFixture(CascaderKbdFixture);
+        const combobox = document.querySelector('[role="combobox"]');
+        expect(combobox).not.toBeNull();
+        // 点击触发器打开浮层（焦点留在 combobox）。
+        await userEvent.click(combobox);
+        const listbox = document.querySelector('.cd-cascader__column[role="listbox"]');
+        expect(listbox).not.toBeNull();
+        const options = Array.from(listbox.querySelectorAll('[role="option"]'));
+        expect(options.length).toBe(3);
+        expect(options.every((o) => o.tabIndex === -1)).toBe(true);
+        // 1. 首次 ↓ 进首列首项（Zhejiang）。
+        await userEvent.keyboard('{ArrowDown}');
+        expect(activeOptionText(combobox)).toBe('Zhejiang');
+        // 再 ↓ 列内移到第二项（Jiangsu）。
+        await userEvent.keyboard('{ArrowDown}');
+        expect(activeOptionText(combobox)).toBe('Jiangsu');
+        // ↑ 回到第一项（Zhejiang）。
+        await userEvent.keyboard('{ArrowUp}');
+        expect(activeOptionText(combobox)).toBe('Zhejiang');
+        // 2. End 跳列内末项（Fujian）；Home 回列内首项（Zhejiang）。
+        await userEvent.keyboard('{End}');
+        expect(activeOptionText(combobox)).toBe('Fujian');
+        await userEvent.keyboard('{Home}');
+        expect(activeOptionText(combobox)).toBe('Zhejiang');
+    });
+});