@chenzy-design/svelte 0.3.1 → 0.4.1

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

@@ -7,61 +7,69 @@ type Theme = 'primary' | 'light' | 'dark';
 type ArrowType = 'hover' | 'always';
 type SlideDirection = 'left' | 'right';
 type TriggerType = 'hover' | 'click';
-/** autoPlay 对象形式：{ interval?, hoverToPause? } */
+/** autoPlay 对象形式：{ interval?, hoverToPause? }（对齐 Semi）。 */
 type AutoPlayConfig = {
     interval?: number;
     hoverToPause?: boolean;
 };
-interface ArrowSlotProps {
+/** 单个箭头自定义：props 透传到箭头 div，children 覆盖默认 Icon（对齐 Semi ArrowButton）。 */
+interface ArrowButton {
+    props?: Record<string, unknown> & {
+        onClick?: () => void;
+        style?: string;
+        class?: string;
+    };
     children?: Snippet;
-    onClick?: () => void;
 }
 interface Props {
+    /** 每项一张幻灯片的 Snippet 数组（对齐 Semi children）。 */
     slides?: Snippet[];
-    /** 受控当前激活索引（Semi API: activeIndex） */
+    /** 受控当前激活索引（Semi API: activeIndex）。 */
     activeIndex?: number;
-    value?: number;
+    /** 非受控初始索引。 */
     defaultActiveIndex?: number;
-    /** 自动播放；支持布尔或对象形式 { interval?, hoverToPause? } */
+    /** 自动播放；布尔或 { interval?, hoverToPause? }（默认 true，对齐 Semi）。 */
     autoPlay?: boolean | AutoPlayConfig;
-    /** @deprecated 请用 autoPlay */
-    autoplay?: boolean;
-    interval?: number;
-    loop?: boolean;
+    /** 切换动画。 */
     animation?: Animation;
+    /** 切换速度（ms）。 */
     speed?: number;
-    slidesToShow?: number;
-    slidesToScroll?: number;
-    vertical?: boolean;
-    draggable?: boolean;
+    /** 是否展示指示器。 */
     showIndicator?: boolean;
+    /** 指示器类型：dot / line / columnar。 */
     indicatorType?: IndicatorType;
-    /** 指示器位置（横向：left/center/right） */
+    /** 指示器位置：left / center / right。 */
     indicatorPosition?: IndicatorPosition;
-    /** 指示器尺寸 */
+    /** 指示器尺寸：small / medium。 */
     indicatorSize?: IndicatorSize;
+    /** 是否展示箭头。 */
     showArrow?: boolean;
-    /** 箭头展示时机：hover=悬停时显示，always=始终显示 */
+    /** 箭头展示时机：hover 悬停显示 / always 始终显示。 */
     arrowType?: ArrowType;
-    /** 自定义箭头内容与点击回调 */
+    /** 自定义箭头内容与点击回调。 */
     arrowProps?: {
-        leftArrow?: ArrowSlotProps;
-        rightArrow?: ArrowSlotProps;
+        leftArrow?: ArrowButton;
+        rightArrow?: ArrowButton;
     };
-    hoverToPause?: boolean;
-    /** 主题 */
+    /** 指示器与箭头主题：primary / light / dark（默认 light，对齐 Semi）。 */
     theme?: Theme;
-    /** 动画滑动方向 */
+    /** animation=slide 时的滑动方向：left / right。 */
     slideDirection?: SlideDirection;
-    /** 指示器触发切换的交互方式 */
+    /** 指示器触发切换的交互方式：click / hover。 */
     trigger?: TriggerType;
-    height?: number | string;
-    ariaLabel?: string;
-    onChange?: (index: number) => void;
-    onPlayStateChange?: (playing: boolean) => void;
+    /** 索引变更回调（对齐 Semi：index, preIndex）。 */
+    onChange?: (index: number, preIndex: number) => void;
+    /** 根元素内联样式（对齐 Semi style；常用于设定宽高）。 */
+    style?: string;
     class?: string;
 }
-declare const Carousel: import("svelte").Component<Props, {}, "">;
+declare const Carousel: import("svelte").Component<Props, {
+    play: () => void;
+    stop: () => void;
+    goTo: (targetRaw: number) => void;
+    prev: () => void;
+    next: () => void;
+}, "">;
 type Carousel = ReturnType<typeof Carousel>;
 export default Carousel;
 //# sourceMappingURL=Carousel.svelte.d.ts.map

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

@@ -1 +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"}
+{"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;AAOpC,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,2DAA2D;AAC3D,KAAK,cAAc,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAEpE,uEAAuE;AACvE,UAAU,WAAW;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;QAAE,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3F,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,UAAU,KAAK;IACb,6CAA6C;IAC7C,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;IACnB,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe;IACf,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,OAAO,GAAG,cAAc,CAAC;IACpC,YAAY;IACZ,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,gBAAgB;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe;IACf,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,mCAAmC;IACnC,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,mCAAmC;IACnC,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,4BAA4B;IAC5B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,cAAc;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,uCAAuC;IACvC,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,oBAAoB;IACpB,UAAU,CAAC,EAAE;QACX,SAAS,CAAC,EAAE,WAAW,CAAC;QACxB,UAAU,CAAC,EAAE,WAAW,CAAC;KAC1B,CAAC;IACF,yDAAyD;IACzD,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,2CAA2C;IAC3C,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,kCAAkC;IAClC,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACrD,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA+UH,QAAA,MAAM,QAAQ;;;sBAzPa,MAAM;;;MAyPqB,CAAC;AACvD,KAAK,QAAQ,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC;AAC5C,eAAe,QAAQ,CAAC"}

package/dist/carousel/meta.d.ts

@@ -1,42 +1,32 @@
 /**
  * Machine-readable component metadata for AI/docs consumption.
- * Carousel — see specs/components/show/Carousel.spec.md
+ * Carousel — 对齐 Semi Design（@douyinfe/semi-ui/carousel）API 契约。
  */
 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 description: "走马灯：多张幻灯片轮流播放。支持 slide/fade 切换动画、autoPlay 自动播放（含 interval/hoverToPause）、dot/line/columnar 指示器（位置 left/center/right，尺寸 small/medium）、prev/next 箭头（always/hover）、自定义箭头 arrowProps、primary/light/dark 主题、受控 activeIndex 与 onChange。slide 通过 Snippet[] 传入。DOM 结构、tokens、动画逐项对齐 Semi。";
     readonly exports: readonly ["Carousel"];
     readonly props: readonly [{
         readonly name: "slides";
         readonly type: "Snippet[]";
         readonly default: "[]";
-        readonly desc: "每项一张幻灯片的 Snippet 数组";
+        readonly desc: "每项一张幻灯片的 Snippet 数组（对齐 Semi children）";
     }, {
-        readonly name: "value";
+        readonly name: "activeIndex";
         readonly type: "number";
         readonly default: "undefined";
-        readonly desc: "受控当前索引（不回写）";
+        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 name: "autoPlay";
+        readonly type: "boolean | { interval?: number; hoverToPause?: boolean }";
         readonly default: "true";
-        readonly desc: "循环（取模）；false 时 clamp 边界";
+        readonly desc: "自动播放；布尔或对象形式（interval 默认 2000ms，hoverToPause 默认 true）";
     }, {
         readonly name: "animation";
         readonly type: "'slide'|'fade'";
@@ -47,78 +37,96 @@ export declare const meta: {
         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 desc: "是否展示指示器（每张一个）";
     }, {
         readonly name: "indicatorType";
         readonly type: "'dot'|'line'|'columnar'";
         readonly default: "'dot'";
-        readonly desc: "指示器样式：dot 圆点 / line 横线条 / columnar 竖栏（激活态加长高亮，纯 CSS，与 vertical 协调）";
+        readonly desc: "指示器类型";
+    }, {
+        readonly name: "indicatorPosition";
+        readonly type: "'left'|'center'|'right'";
+        readonly default: "'center'";
+        readonly desc: "指示器位置";
+    }, {
+        readonly name: "indicatorSize";
+        readonly type: "'small'|'medium'";
+        readonly default: "'small'";
+        readonly desc: "指示器尺寸";
     }, {
         readonly name: "showArrow";
         readonly type: "boolean";
         readonly default: "true";
-        readonly desc: "显示左右箭头";
+        readonly desc: "是否展示左右箭头";
     }, {
-        readonly name: "hoverToPause";
-        readonly type: "boolean";
-        readonly default: "true";
-        readonly desc: "悬停暂停自动播放";
+        readonly name: "arrowType";
+        readonly type: "'always'|'hover'";
+        readonly default: "'always'";
+        readonly desc: "箭头展示时机：always 始终 / hover 悬停显示";
+    }, {
+        readonly name: "arrowProps";
+        readonly type: "{ leftArrow?: ArrowButton; rightArrow?: ArrowButton }";
+        readonly default: "undefined";
+        readonly desc: "自定义箭头（props 透传 onClick/style，children 覆盖默认 Icon）";
     }, {
-        readonly name: "height";
-        readonly type: "number|string";
-        readonly default: "240";
-        readonly desc: "容器高度（数字按 px）";
+        readonly name: "theme";
+        readonly type: "'primary'|'light'|'dark'";
+        readonly default: "'light'";
+        readonly desc: "指示器与箭头主题";
     }, {
-        readonly name: "ariaLabel";
-        readonly type: "string";
-        readonly default: "i18n Carousel.ariaLabel";
-        readonly desc: "走马灯整体可访问名（root role=region）";
+        readonly name: "slideDirection";
+        readonly type: "'left'|'right'";
+        readonly default: "'left'";
+        readonly desc: "slide 动画滑动方向";
+    }, {
+        readonly name: "trigger";
+        readonly type: "'click'|'hover'";
+        readonly default: "'click'";
+        readonly desc: "指示器触发切换的交互方式";
     }, {
         readonly name: "onChange";
-        readonly type: "(index: number) => void";
+        readonly type: "(index: number, preIndex: number) => void";
         readonly default: "undefined";
-        readonly desc: "索引变更回调";
+        readonly desc: "索引变更回调（对齐 Semi）";
     }, {
-        readonly name: "onPlayStateChange";
-        readonly type: "(playing: boolean) => void";
+        readonly name: "style";
+        readonly type: "string";
         readonly default: "undefined";
-        readonly desc: "播放/暂停按钮切换回调";
+        readonly desc: "根元素内联样式（常用于设定宽高）";
     }, {
         readonly name: "class";
         readonly type: "string";
         readonly default: "''";
         readonly desc: "根类名透传";
     }];
+    readonly methods: readonly [{
+        readonly name: "play";
+        readonly signature: "() => void";
+        readonly desc: "开始自动播放";
+    }, {
+        readonly name: "stop";
+        readonly signature: "() => void";
+        readonly desc: "停止自动播放";
+    }, {
+        readonly name: "goTo";
+        readonly signature: "(targetIndex: number) => void";
+        readonly desc: "切换到指定索引";
+    }, {
+        readonly name: "prev";
+        readonly signature: "() => void";
+        readonly desc: "切换到上一张";
+    }, {
+        readonly name: "next";
+        readonly signature: "() => void";
+        readonly desc: "切换到下一张";
+    }];
     readonly events: readonly [{
         readonly name: "onChange";
-        readonly desc: "当前索引变更（index）";
-    }, {
-        readonly name: "onPlayStateChange";
-        readonly desc: "autoplay 播放/暂停切换（playing）";
+        readonly desc: "当前索引变更（index, preIndex）";
     }];
     readonly slots: readonly [{
         readonly name: "slides";
@@ -127,12 +135,12 @@ export declare const meta: {
     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 notes: readonly ["根 role=region aria-roledescription=\"carousel\" aria-label（i18n）", "slide 区 aria-live=polite；autoPlay 实际播放中降级为 off", "根 tabindex=0 承接键盘导航：←/→ 切换、Home/End 跳首末；RTL 下 ←/→ 镜像", "每张 role=group aria-roledescription=\"slide\" aria-label「第 N 张」，非可见张 aria-hidden + inert", "指示器 role=tablist/tab，aria-selected，可 Enter/Space 触发", "箭头 role=button aria-label 上一张/下一张，可键盘操作", "autoPlay 提供可见播放/暂停按钮（WCAG 2.2.2，aria-pressed），hover/键盘 focus 进入自动暂停", "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-border-radius-full", "--cd-focus-ring", "--cd-motion-duration-fast", "--cd-motion-ease-standard", "--cd-spacing-tight"];
+    readonly tokens: readonly ["--cd-carousel-color-indicator-theme-dark-bg-default", "--cd-carousel-color-indicator-theme-dark-bg-hover", "--cd-carousel-color-indicator-theme-dark-bg-active", "--cd-carousel-color-indicator-theme-primary-bg-default", "--cd-carousel-color-indicator-theme-primary-bg-hover", "--cd-carousel-color-indicator-theme-primary-bg-active", "--cd-carousel-color-indicator-theme-light-bg-default", "--cd-carousel-color-indicator-theme-light-bg-hover", "--cd-carousel-color-indicator-theme-light-bg-active", "--cd-carousel-color-arrow-theme-dark-bg-default", "--cd-carousel-color-arrow-theme-dark-bg-hover", "--cd-carousel-color-arrow-theme-primary-bg-default", "--cd-carousel-color-arrow-theme-primary-bg-hover", "--cd-carousel-color-arrow-theme-light-bg-default", "--cd-carousel-color-arrow-theme-light-bg-hover", "--cd-carousel-width-indicator-line", "--cd-carousel-width-indicator-columnar-small", "--cd-carousel-width-indicator-columnar-medium", "--cd-carousel-width-indicator-dot-small", "--cd-carousel-width-indicator-dot-medium", "--cd-carousel-width-arrow", "--cd-carousel-height-indicator-columnar-small-default", "--cd-carousel-height-indicator-columnar-small-active", "--cd-carousel-height-indicator-columnar-medium-default", "--cd-carousel-height-indicator-columnar-medium-active", "--cd-carousel-height-indicator-line-small", "--cd-carousel-height-indicator-line-medium", "--cd-carousel-radius-indicator-dot", "--cd-carousel-spacing-indicator-padding", "--cd-carousel-spacing-indicator-columnar-marginx", "--cd-carousel-spacing-indicator-line-marginx", "--cd-carousel-spacing-indicator-dot-marginx", "--cd-carousel-spacing-arrow-left", "--cd-carousel-spacing-arrow-right", "--cd-carousel-animation-transition-function", "--cd-carousel-animation-transition-duration", "--cd-carousel-animation-transition-delay"];
     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 />";
+        readonly code: "{#snippet s1()}<img src=\"/1.jpg\" alt=\"\" />{/snippet}\n{#snippet s2()}<img src=\"/2.jpg\" alt=\"\" />{/snippet}\n<Carousel slides={[s1, s2]} style=\"width:100%;height:400px\" />";
     }];
 };
 //# sourceMappingURL=meta.d.ts.map

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

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

package/dist/carousel/meta.js

@@ -1,72 +1,114 @@
 /**
  * Machine-readable component metadata for AI/docs consumption.
- * Carousel — see specs/components/show/Carousel.spec.md
+ * Carousel — 对齐 Semi Design（@douyinfe/semi-ui/carousel）API 契约。
  */
 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[] 传入。',
+    description: '走马灯：多张幻灯片轮流播放。支持 slide/fade 切换动画、autoPlay 自动播放（含 interval/hoverToPause）、dot/line/columnar 指示器（位置 left/center/right，尺寸 small/medium）、prev/next 箭头（always/hover）、自定义箭头 arrowProps、primary/light/dark 主题、受控 activeIndex 与 onChange。slide 通过 Snippet[] 传入。DOM 结构、tokens、动画逐项对齐 Semi。',
     exports: ['Carousel'],
     props: [
-        { name: 'slides', type: 'Snippet[]', default: '[]', desc: '每项一张幻灯片的 Snippet 数组' },
-        { name: 'value', type: 'number', default: 'undefined', desc: '受控当前索引（不回写）' },
+        { name: 'slides', type: 'Snippet[]', default: '[]', desc: '每项一张幻灯片的 Snippet 数组（对齐 Semi children）' },
+        { name: 'activeIndex', 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: 'autoPlay',
+            type: 'boolean | { interval?: number; hoverToPause?: boolean }',
+            default: 'true',
+            desc: '自动播放；布尔或对象形式（interval 默认 2000ms，hoverToPause 默认 true）',
+        },
         { 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: 'showIndicator', type: 'boolean', default: 'true', desc: '是否展示指示器（每张一个）' },
+        { name: 'indicatorType', type: "'dot'|'line'|'columnar'", default: "'dot'", desc: '指示器类型' },
+        { name: 'indicatorPosition', type: "'left'|'center'|'right'", default: "'center'", desc: '指示器位置' },
+        { name: 'indicatorSize', type: "'small'|'medium'", default: "'small'", desc: '指示器尺寸' },
+        { name: 'showArrow', type: 'boolean', default: 'true', desc: '是否展示左右箭头' },
+        { name: 'arrowType', type: "'always'|'hover'", default: "'always'", desc: '箭头展示时机：always 始终 / hover 悬停显示' },
+        {
+            name: 'arrowProps',
+            type: '{ leftArrow?: ArrowButton; rightArrow?: ArrowButton }',
+            default: 'undefined',
+            desc: '自定义箭头（props 透传 onClick/style，children 覆盖默认 Icon）',
+        },
+        { name: 'theme', type: "'primary'|'light'|'dark'", default: "'light'", desc: '指示器与箭头主题' },
+        { name: 'slideDirection', type: "'left'|'right'", default: "'left'", desc: 'slide 动画滑动方向' },
+        { name: 'trigger', type: "'click'|'hover'", default: "'click'", desc: '指示器触发切换的交互方式' },
+        { name: 'onChange', type: '(index: number, preIndex: number) => void', default: 'undefined', desc: '索引变更回调（对齐 Semi）' },
+        { name: 'style', type: 'string', default: 'undefined', desc: '根元素内联样式（常用于设定宽高）' },
         { name: 'class', type: 'string', default: "''", desc: '根类名透传' },
     ],
-    events: [
-        { name: 'onChange', desc: '当前索引变更（index）' },
-        { name: 'onPlayStateChange', desc: 'autoplay 播放/暂停切换（playing）' },
+    methods: [
+        { name: 'play', signature: '() => void', desc: '开始自动播放' },
+        { name: 'stop', signature: '() => void', desc: '停止自动播放' },
+        { name: 'goTo', signature: '(targetIndex: number) => void', desc: '切换到指定索引' },
+        { name: 'prev', signature: '() => void', desc: '切换到上一张' },
+        { name: 'next', signature: '() => void', desc: '切换到下一张' },
     ],
+    events: [{ name: 'onChange', desc: '当前索引变更（index, preIndex）' }],
     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 不自启',
+            '根 role=region aria-roledescription="carousel" aria-label（i18n）',
+            'slide 区 aria-live=polite；autoPlay 实际播放中降级为 off',
+            '根 tabindex=0 承接键盘导航：←/→ 切换、Home/End 跳首末；RTL 下 ←/→ 镜像',
+            '每张 role=group aria-roledescription="slide" aria-label「第 N 张」，非可见张 aria-hidden + inert',
+            '指示器 role=tablist/tab，aria-selected，可 Enter/Space 触发',
+            '箭头 role=button aria-label 上一张/下一张，可键盘操作',
+            'autoPlay 提供可见播放/暂停按钮（WCAG 2.2.2，aria-pressed），hover/键盘 focus 进入自动暂停',
+            '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-border-radius-full',
-        '--cd-focus-ring',
-        '--cd-motion-duration-fast',
-        '--cd-motion-ease-standard',
-        '--cd-spacing-tight',
+        // 指示器主题色（primary/light/dark × default/hover/active）
+        '--cd-carousel-color-indicator-theme-dark-bg-default',
+        '--cd-carousel-color-indicator-theme-dark-bg-hover',
+        '--cd-carousel-color-indicator-theme-dark-bg-active',
+        '--cd-carousel-color-indicator-theme-primary-bg-default',
+        '--cd-carousel-color-indicator-theme-primary-bg-hover',
+        '--cd-carousel-color-indicator-theme-primary-bg-active',
+        '--cd-carousel-color-indicator-theme-light-bg-default',
+        '--cd-carousel-color-indicator-theme-light-bg-hover',
+        '--cd-carousel-color-indicator-theme-light-bg-active',
+        // 箭头主题色
+        '--cd-carousel-color-arrow-theme-dark-bg-default',
+        '--cd-carousel-color-arrow-theme-dark-bg-hover',
+        '--cd-carousel-color-arrow-theme-primary-bg-default',
+        '--cd-carousel-color-arrow-theme-primary-bg-hover',
+        '--cd-carousel-color-arrow-theme-light-bg-default',
+        '--cd-carousel-color-arrow-theme-light-bg-hover',
+        // 尺寸
+        '--cd-carousel-width-indicator-line',
+        '--cd-carousel-width-indicator-columnar-small',
+        '--cd-carousel-width-indicator-columnar-medium',
+        '--cd-carousel-width-indicator-dot-small',
+        '--cd-carousel-width-indicator-dot-medium',
+        '--cd-carousel-width-arrow',
+        '--cd-carousel-height-indicator-columnar-small-default',
+        '--cd-carousel-height-indicator-columnar-small-active',
+        '--cd-carousel-height-indicator-columnar-medium-default',
+        '--cd-carousel-height-indicator-columnar-medium-active',
+        '--cd-carousel-height-indicator-line-small',
+        '--cd-carousel-height-indicator-line-medium',
+        '--cd-carousel-radius-indicator-dot',
+        // 间距
+        '--cd-carousel-spacing-indicator-padding',
+        '--cd-carousel-spacing-indicator-columnar-marginx',
+        '--cd-carousel-spacing-indicator-line-marginx',
+        '--cd-carousel-spacing-indicator-dot-marginx',
+        '--cd-carousel-spacing-arrow-left',
+        '--cd-carousel-spacing-arrow-right',
+        // 动效
+        '--cd-carousel-animation-transition-function',
+        '--cd-carousel-animation-transition-duration',
+        '--cd-carousel-animation-transition-delay',
     ],
     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 />',
+            code: '{#snippet s1()}<img src="/1.jpg" alt="" />{/snippet}\n{#snippet s2()}<img src="/2.jpg" alt="" />{/snippet}\n<Carousel slides={[s1, s2]} style="width:100%;height:400px" />',
         },
     ],
 };