@chenzy-design/svelte 0.1.0

package/dist/steps/Steps.kbd.test.js

@@ -0,0 +1,59 @@
+// Steps 键盘 e2e（browser project / 真实 chromium）。
+// type="nav"（→ clickable）启用 roving，可点击步骤组为单一 Tab 停靠点。
+// 测真实焦点移动——jsdom 测不了（命令式 focus() 不可靠）：
+//   1. roving 单停靠点：Tab 进入只停在一个 step button（其余 tabindex=-1）。
+//   2. ↑↓/←→ 真实移动焦点到相邻步骤（无 wrap：clamp 在两端，源码 nextRovingIndex(...,false)）。
+//   3. Home/End 跳首/末步。
+//
+// 真实焦点断言用 page locator 的 .toHaveFocus()。
+import { describe, it, expect } from 'vitest';
+import { page } from 'vitest/browser';
+import { renderKbdFixture, userEvent } from '../test-utils/kbd.js';
+import StepsKbdFixture from './StepsKbdFixture.svelte';
+function loc(el) {
+    return page.elementLocator(el);
+}
+describe('Steps 键盘 e2e（nav/clickable roving，真实焦点）', () => {
+    it('Tab 单停靠点 + 方向键移动焦点（clamp）+ Home/End 跳首末', async () => {
+        const { baseElement } = renderKbdFixture(StepsKbdFixture);
+        const buttons = Array.from(baseElement.querySelectorAll('button[data-step-index]'));
+        expect(buttons.length).toBe(3);
+        const [first, second, third] = buttons;
+        // 1. roving 单停靠点：恰一个 tabindex=0（默认收敛到 activeIndex=0 首步）。
+        expect(buttons.filter((el) => el.tabIndex === 0).length).toBe(1);
+        expect(first.tabIndex).toBe(0);
+        const before = baseElement.querySelector('[data-testid="before"]');
+        before.focus();
+        await expect.element(loc(before)).toHaveFocus();
+        await userEvent.tab();
+        await expect.element(loc(first)).toHaveFocus();
+        // 2. → / ↓ 移动焦点到下一步（真实焦点 + 停靠点同步）。
+        await userEvent.keyboard('{ArrowRight}');
+        await expect.element(loc(second)).toHaveFocus();
+        expect(second.tabIndex).toBe(0);
+        expect(first.tabIndex).toBe(-1);
+        await userEvent.keyboard('{ArrowDown}');
+        await expect.element(loc(third)).toHaveFocus();
+        // 无 wrap：末步再 → 停在末步（clamp）。
+        await userEvent.keyboard('{ArrowRight}');
+        await expect.element(loc(third)).toHaveFocus();
+        // ← / ↑ 回退。
+        await userEvent.keyboard('{ArrowLeft}');
+        await expect.element(loc(second)).toHaveFocus();
+        // 首步再 ← 停在首步（clamp）。
+        await userEvent.keyboard('{ArrowUp}');
+        await expect.element(loc(first)).toHaveFocus();
+        await userEvent.keyboard('{ArrowUp}');
+        await expect.element(loc(first)).toHaveFocus();
+        // 3. Home/End 跳首/末。
+        await userEvent.keyboard('{End}');
+        await expect.element(loc(third)).toHaveFocus();
+        await userEvent.keyboard('{Home}');
+        await expect.element(loc(first)).toHaveFocus();
+        // Tab 离开步骤组 → after 按钮（单停靠点，不困在组内）。
+        const after = baseElement.querySelector('[data-testid="after"]');
+        await userEvent.keyboard('{End}');
+        await userEvent.tab();
+        await expect.element(loc(after)).toHaveFocus();
+    });
+});

package/dist/steps/Steps.svelte

@@ -0,0 +1,392 @@
+<!--
+  Steps — see specs/components/navigation/Steps.spec.md
+  Base subset: horizontal/vertical, fill/nav/basic types, clickable, status, dot mode.
+  dot：图标渲染为小圆点（不显数字/✓），process 态高亮放大。
+  basic：线框/简洁型——节点圆圈描边而非实心填充，process 态高亮描边。
+  icon：自定义图标 snippet，提供时替代默认序号/✓/✕。
+-->
+<script lang="ts">
+  import type { Snippet } from 'svelte';
+  import { nextRovingIndex, rovingKeyFromEvent, type RovingKey } from '@chenzy-design/core';
+  import { useLocale } from '../locale-provider/index.js';
+  import type { StepItem } from './types.js';
+
+  type StepDirection = 'horizontal' | 'vertical';
+  type StepType = 'fill' | 'nav' | 'basic';
+  type StepStatus = 'process' | 'finish' | 'error' | 'warning';
+  type StepSize = 'small' | 'default' | 'large';
+  type DerivedStatus = 'wait' | 'process' | 'finish' | 'error' | 'warning';
+
+  interface Props {
+    current?: number;
+    defaultCurrent?: number;
+    steps?: StepItem[];
+    direction?: StepDirection;
+    type?: StepType;
+    status?: StepStatus;
+    size?: StepSize;
+    initial?: number;
+    clickable?: boolean;
+    /** 点状步骤：图标渲染为小圆点，不显数字/✓ */
+    dot?: boolean;
+    /** 自定义图标渲染器，提供时替代默认序号/✓/✕（dot 模式不渲染图标） */
+    icon?: Snippet<[{ step: StepItem; index: number; status: DerivedStatus }]>;
+    onChange?: (current: number) => void;
+    onClick?: (e: MouseEvent) => void;
+    onKeyDown?: (e: KeyboardEvent) => void;
+    class?: string;
+  }
+
+  let {
+    current,
+    defaultCurrent = 0,
+    steps = [],
+    direction = 'horizontal',
+    type = 'fill',
+    status = 'process',
+    size = 'default',
+    initial = 0,
+    clickable,
+    dot = false,
+    icon,
+    onChange,
+    onClick,
+    onKeyDown,
+    class: className = '',
+  }: Props = $props();
+
+  // Controlled / uncontrolled (red line #1): never write back the prop.
+  const isControlled = $derived(current !== undefined);
+  let inner = $state(getInitialCurrent());
+  const activeIndex = $derived(isControlled ? (current as number) : inner);
+
+  function getInitialCurrent(): number {
+    return defaultCurrent;
+  }
+
+  const isClickable = $derived(clickable ?? type === 'nav');
+
+  function statusOf(index: number): DerivedStatus {
+    // 显式 step.status 优先于由 current 推断的状态
+    const explicit = steps[index]?.status;
+    if (explicit) return explicit;
+    if (index < activeIndex) return 'finish';
+    if (index === activeIndex) return status;
+    return 'wait';
+  }
+
+  const cls = $derived(
+    [
+      'cd-steps',
+      `cd-steps--${direction}`,
+      `cd-steps--${type}`,
+      `cd-steps--${size}`,
+      dot && 'cd-steps--dot',
+      className,
+    ]
+      .filter(Boolean)
+      .join(' '),
+  );
+
+  function select(index: number) {
+    if (!isClickable) return;
+    if (steps[index]?.disabled) return; // 禁用步不可激活
+    if (index === activeIndex) return;
+    if (!isControlled) inner = index;
+    onChange?.(index);
+  }
+
+  const loc = useLocale();
+
+  // 视觉隐藏的状态文本（WCAG 1.4.1：颜色非唯一信息载体）。
+  // 组合「步骤 N，共 M 步，<状态>」供屏幕阅读器朗读。
+  function statusText(st: DerivedStatus): string {
+    switch (st) {
+      case 'finish':
+        return loc().t('Steps.statusFinish');
+      case 'process':
+        return loc().t('Steps.statusProcess');
+      case 'error':
+        return loc().t('Steps.statusError');
+      case 'warning':
+        return loc().t('Steps.statusWarning');
+      default:
+        return loc().t('Steps.statusWait');
+    }
+  }
+  function srLabel(index: number, st: DerivedStatus): string {
+    // 分隔符 ofTotal 已带（zh「，共 N 步」/ en「 of N」），状态前再以 locale 分隔符停顿。
+    const sep = loc().t('Steps.statusSeparator');
+    return (
+      loc().t('Steps.stepLabel', { index: index + 1 + initial }) +
+      loc().t('Steps.ofTotal', { total: steps.length }) +
+      sep +
+      statusText(st)
+    );
+  }
+
+  // --- roving tabindex（a11y §6）：可点击步骤组为单一 Tab 停靠点。 ---
+  // rootEl 普通引用（bind:this），命令式 focus() 用，非 render 期读 DOM。
+  let rootEl = $state<HTMLElement | null>(null);
+  // 当前焦点步索引；-1 = 尚无焦点 -> 首个可点击步作为 Tab 停靠点。
+  let focusedIndex = $state(-1);
+
+  // 可点击（且未禁用）的步骤索引序列；roving 在其中漫游，跳过 disabled（红线 #2：纯派生）。
+  const focusableIndices = $derived<number[]>(
+    isClickable
+      ? steps.map((s, i) => (s.disabled ? -1 : i)).filter((i) => i >= 0)
+      : [],
+  );
+
+  // 纯派生 tabindex：当前焦点步（或无焦点时回退到 activeIndex/首个可点击步）为 0，其余 -1。
+  // 不在 render 期写 $state（红线 #2）。
+  function stepTabindex(index: number): 0 | -1 {
+    if (!isClickable || steps[index]?.disabled) return -1;
+    const anchor =
+      focusedIndex >= 0
+        ? focusedIndex
+        : focusableIndices.includes(activeIndex)
+          ? activeIndex
+          : (focusableIndices[0] ?? -1);
+    return index === anchor ? 0 : -1;
+  }
+
+  function focusStep(index: number): void {
+    focusedIndex = index;
+    rootEl
+      ?.querySelector<HTMLElement>(`[data-step-index="${index}"]`)
+      ?.focus();
+  }
+
+  // 步骤 keydown：方向键 roving（纯函数 nextRovingIndex 派生，仅在可点击步间移动）、
+  // Home/End 跳首尾可点击步。Enter/Space 交给原生 <button>（向后兼容）。
+  function onStepKeydown(e: KeyboardEvent, index: number): void {
+    const intent: RovingKey | null = rovingKeyFromEvent(e.key);
+    if (!intent) return;
+    e.preventDefault();
+    const list = focusableIndices;
+    if (list.length === 0) return;
+    const cur = list.indexOf(index);
+    const next = nextRovingIndex(cur, list.length, intent, false);
+    const target = list[next];
+    if (target != null) focusStep(target);
+  }
+</script>
+
+{#snippet head(step: StepItem, index: number, st: DerivedStatus)}
+  <span class="cd-steps__icon" aria-hidden="true">
+    {#if dot}{:else if icon}{@render icon({ step, index, status: st })}{:else if st === 'finish'}✓{:else if st === 'error'}✕{:else}{index + 1 + initial}{/if}
+  </span>
+  <span class="cd-steps__content">
+    <span class="cd-steps__title">{step.title}</span>
+    {#if step.description}
+      <span class="cd-steps__desc">{step.description}</span>
+    {/if}
+  </span>
+  <!-- WCAG 1.4.1：视觉隐藏的「步骤 N，共 M 步，<状态>」供屏幕阅读器朗读，颜色非唯一信息载体。 -->
+  <span class="cd-sr-only">{srLabel(index, st)}</span>
+{/snippet}
+
+{#snippet stepsList()}
+  <ol class={cls} bind:this={rootEl}>
+    {#each steps as step, index (index)}
+      {@const st = statusOf(index)}
+      {@const last = index === steps.length - 1}
+      {@const isDisabled = step.disabled === true}
+      <li class="cd-steps__item cd-steps__item--{st}" class:cd-steps__item--disabled={isDisabled}>
+        {#if isClickable}
+          <button
+            type="button"
+            class="cd-steps__head"
+            data-step-index={index}
+            aria-current={index === activeIndex ? 'step' : undefined}
+            disabled={isDisabled}
+            aria-disabled={isDisabled || undefined}
+            tabindex={stepTabindex(index)}
+            onclick={(e) => { select(index); onClick?.(e); }}
+            onkeydown={(e) => { onStepKeydown(e, index); onKeyDown?.(e); }}
+            onfocus={() => {
+              focusedIndex = index;
+            }}
+          >
+            {@render head(step, index, st)}
+          </button>
+        {:else}
+          <div
+            class="cd-steps__head"
+            aria-current={index === activeIndex ? 'step' : undefined}
+            aria-disabled={isDisabled || undefined}
+          >
+            {@render head(step, index, st)}
+          </div>
+        {/if}
+        {#if !last}
+          <span
+            class="cd-steps__line"
+            class:cd-steps__line--finish={index < activeIndex}
+            aria-hidden="true"
+          ></span>
+        {/if}
+      </li>
+    {/each}
+  </ol>
+{/snippet}
+
+{#if type === 'nav'}
+  <nav aria-label={loc().t('Steps.navAriaLabel')}>
+    {@render stepsList()}
+  </nav>
+{:else}
+  {@render stepsList()}
+{/if}
+
+<style>
+  /* 视觉隐藏的状态文本（class="cd-sr-only"）复用 tokens.css 全局工具类，
+     令颜色非唯一信息载体（WCAG 1.4.1）。 */
+  .cd-steps {
+    display: flex;
+    margin: 0;
+    padding: 0;
+    list-style: none;
+  }
+  .cd-steps--horizontal {
+    flex-direction: row;
+    align-items: flex-start;
+  }
+  .cd-steps--vertical {
+    flex-direction: column;
+  }
+  .cd-steps__item {
+    position: relative;
+    display: flex;
+    flex: 1 1 auto;
+    align-items: center;
+    gap: var(--cd-spacing-2);
+  }
+  .cd-steps--vertical .cd-steps__item {
+    flex-direction: column;
+    align-items: flex-start;
+  }
+  .cd-steps__head {
+    display: inline-flex;
+    align-items: center;
+    gap: var(--cd-spacing-2);
+    margin: 0;
+    padding: 0;
+    border: none;
+    background: transparent;
+    color: inherit;
+    font: inherit;
+    text-align: start;
+  }
+  button.cd-steps__head {
+    cursor: pointer;
+  }
+  /* 禁用步：置灰、不可点击 */
+  .cd-steps__item--disabled .cd-steps__head {
+    cursor: not-allowed;
+    opacity: 0.4;
+  }
+  button.cd-steps__head:disabled {
+    cursor: not-allowed;
+  }
+  button.cd-steps__head:focus-visible {
+    outline: none;
+    box-shadow: var(--cd-focus-ring);
+    border-radius: var(--cd-radius-1);
+  }
+  .cd-steps__icon {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    inline-size: var(--cd-steps-icon-size);
+    block-size: var(--cd-steps-icon-size);
+    border-radius: var(--cd-radius-full);
+    background: var(--cd-steps-icon-bg);
+    color: var(--cd-steps-icon-color);
+    flex: 0 0 auto;
+  }
+  .cd-steps__item--process .cd-steps__icon {
+    background: var(--cd-steps-icon-bg-process);
+    color: var(--cd-steps-icon-color-active);
+  }
+  .cd-steps__item--finish .cd-steps__icon {
+    background: var(--cd-steps-icon-bg-finish);
+    color: var(--cd-steps-icon-color-active);
+  }
+  .cd-steps__item--error .cd-steps__icon {
+    background: var(--cd-steps-icon-bg-error);
+    color: var(--cd-steps-icon-color-active);
+  }
+  .cd-steps__content {
+    display: inline-flex;
+    flex-direction: column;
+  }
+  .cd-steps__title {
+    color: var(--cd-steps-title-color);
+  }
+  .cd-steps__desc {
+    color: var(--cd-steps-desc-color);
+    font-size: var(--cd-font-size-1);
+  }
+  .cd-steps__line {
+    flex: 1 1 auto;
+    background: var(--cd-steps-line-color);
+  }
+  .cd-steps--horizontal .cd-steps__line {
+    block-size: 1px;
+    min-inline-size: var(--cd-spacing-4);
+  }
+  .cd-steps--vertical .cd-steps__line {
+    inline-size: 1px;
+    min-block-size: var(--cd-spacing-4);
+    margin-inline-start: calc(var(--cd-steps-icon-size) / 2);
+  }
+  .cd-steps__line--finish {
+    background: var(--cd-steps-line-color-finish);
+  }
+
+  /* --- basic 线框型：节点圆圈用描边而非实心填充 --- */
+  .cd-steps--basic .cd-steps__icon {
+    background: transparent;
+    color: var(--cd-steps-basic-color, var(--cd-color-text-2));
+    border: 1px solid var(--cd-steps-basic-border, var(--cd-color-border));
+  }
+  .cd-steps--basic .cd-steps__item--process .cd-steps__icon {
+    background: transparent;
+    color: var(--cd-steps-basic-color-process, var(--cd-color-primary));
+    border-color: var(--cd-steps-basic-border-process, var(--cd-color-primary));
+  }
+  .cd-steps--basic .cd-steps__item--finish .cd-steps__icon {
+    background: transparent;
+    color: var(--cd-steps-basic-color-finish, var(--cd-color-primary));
+    border-color: var(--cd-steps-basic-border-finish, var(--cd-color-primary));
+  }
+  .cd-steps--basic .cd-steps__item--error .cd-steps__icon {
+    background: transparent;
+    color: var(--cd-steps-basic-color-error, var(--cd-color-danger));
+    border-color: var(--cd-steps-basic-border-error, var(--cd-color-danger));
+  }
+
+  /* --- dot 模式：图标缩为小圆点，process 态放大高亮 --- */
+  .cd-steps--dot .cd-steps__icon {
+    inline-size: var(--cd-steps-dot-size, 8px);
+    block-size: var(--cd-steps-dot-size, 8px);
+    background: var(--cd-steps-line-color);
+  }
+  .cd-steps--dot .cd-steps__item--process .cd-steps__icon {
+    inline-size: var(--cd-steps-dot-size-active, 10px);
+    block-size: var(--cd-steps-dot-size-active, 10px);
+    background: var(--cd-steps-icon-bg-process);
+  }
+  .cd-steps--dot .cd-steps__item--finish .cd-steps__icon {
+    background: var(--cd-steps-icon-bg-finish);
+  }
+  .cd-steps--dot .cd-steps__item--error .cd-steps__icon {
+    background: var(--cd-steps-icon-bg-error);
+  }
+  /* dot 模式垂直对齐 line 与圆点中心 */
+  .cd-steps--dot.cd-steps--vertical .cd-steps__line {
+    margin-inline-start: calc(var(--cd-steps-dot-size, 8px) / 2);
+  }
+</style>

package/dist/steps/Steps.svelte.d.ts

@@ -0,0 +1,34 @@
+import type { Snippet } from 'svelte';
+import type { StepItem } from './types.js';
+type StepDirection = 'horizontal' | 'vertical';
+type StepType = 'fill' | 'nav' | 'basic';
+type StepStatus = 'process' | 'finish' | 'error' | 'warning';
+type StepSize = 'small' | 'default' | 'large';
+type DerivedStatus = 'wait' | 'process' | 'finish' | 'error' | 'warning';
+interface Props {
+    current?: number;
+    defaultCurrent?: number;
+    steps?: StepItem[];
+    direction?: StepDirection;
+    type?: StepType;
+    status?: StepStatus;
+    size?: StepSize;
+    initial?: number;
+    clickable?: boolean;
+    /** 点状步骤：图标渲染为小圆点，不显数字/✓ */
+    dot?: boolean;
+    /** 自定义图标渲染器，提供时替代默认序号/✓/✕（dot 模式不渲染图标） */
+    icon?: Snippet<[{
+        step: StepItem;
+        index: number;
+        status: DerivedStatus;
+    }]>;
+    onChange?: (current: number) => void;
+    onClick?: (e: MouseEvent) => void;
+    onKeyDown?: (e: KeyboardEvent) => void;
+    class?: string;
+}
+declare const Steps: import("svelte").Component<Props, {}, "">;
+type Steps = ReturnType<typeof Steps>;
+export default Steps;
+//# sourceMappingURL=Steps.svelte.d.ts.map

package/dist/steps/Steps.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Steps.svelte.d.ts","sourceRoot":"","sources":["../../src/steps/Steps.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAGtC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGzC,KAAK,aAAa,GAAG,YAAY,GAAG,UAAU,CAAC;AAC/C,KAAK,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,CAAC;AACzC,KAAK,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAC7D,KAAK,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;AAC9C,KAAK,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAEzE,UAAU,KAAK;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;IACnB,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,2BAA2B;IAC3B,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,0CAA0C;IAC1C,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,aAAa,CAAA;KAAE,CAAC,CAAC,CAAC;IAC3E,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,IAAI,CAAC;IAClC,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,aAAa,KAAK,IAAI,CAAC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA0MH,QAAA,MAAM,KAAK,2CAAwC,CAAC;AACpD,KAAK,KAAK,GAAG,UAAU,CAAC,OAAO,KAAK,CAAC,CAAC;AACtC,eAAe,KAAK,CAAC"}

package/dist/steps/StepsKbdFixture.svelte

@@ -0,0 +1,21 @@
+<!--
+  仅供 Steps.kbd.test.ts（browser project）使用的键盘 e2e 夹具。
+  type="nav" 启用 clickable，可点击步骤组为单一 Tab 停靠点（roving，真实焦点）。
+  前后各放一个按钮，验证 Tab 从 before 进入只停靠单一步骤、Tab 出去落到 after。
+-->
+<script lang="ts">
+  import { LocaleProvider } from '../locale-provider/index.js';
+  import Steps from './Steps.svelte';
+
+  const steps = [
+    { title: 'First' },
+    { title: 'Second' },
+    { title: 'Third' },
+  ];
+</script>
+
+<LocaleProvider locale="en_US">
+  <button type="button" data-testid="before">before</button>
+  <Steps {steps} type="nav" defaultCurrent={0} />
+  <button type="button" data-testid="after">after</button>
+</LocaleProvider>

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

package/dist/steps/StepsKbdFixture.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StepsKbdFixture.svelte.d.ts","sourceRoot":"","sources":["../../src/steps/StepsKbdFixture.svelte.ts"],"names":[],"mappings":"AA0BA,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,eAAe;;kBAA+E,CAAC;AACnF,KAAK,eAAe,GAAG,YAAY,CAAC,OAAO,eAAe,CAAC,CAAC;AAC9D,eAAe,eAAe,CAAC"}

package/dist/steps/index.d.ts

@@ -0,0 +1,4 @@
+export { default as Steps } from './Steps.svelte';
+export { meta as stepsMeta } from './meta.js';
+export type { StepItem } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/steps/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,IAAI,IAAI,SAAS,EAAE,MAAM,WAAW,CAAC;AAC9C,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/steps/index.js

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

package/dist/steps/meta.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Machine-readable component metadata for AI/docs consumption.
+ * See specs/00-foundation/ai-friendly.spec.md.
+ */
+export declare const meta: {
+    readonly name: "Steps";
+    readonly category: "navigation";
+    readonly description: "步骤条，引导用户按流程完成任务。支持横向/纵向、fill/nav/basic 类型、自定义图标、可点击与状态展示。";
+    readonly props: readonly [{
+        readonly name: "current";
+        readonly type: "number";
+        readonly default: "undefined";
+        readonly desc: "受控当前步";
+    }, {
+        readonly name: "defaultCurrent";
+        readonly type: "number";
+        readonly default: "0";
+    }, {
+        readonly name: "steps";
+        readonly type: "StepItem[]";
+        readonly default: "[]";
+        readonly desc: "步骤数据";
+    }, {
+        readonly name: "direction";
+        readonly type: "'horizontal'|'vertical'";
+        readonly default: "horizontal";
+    }, {
+        readonly name: "type";
+        readonly type: "'fill'|'nav'|'basic'";
+        readonly default: "fill";
+        readonly desc: "basic 为线框/描边型";
+    }, {
+        readonly name: "status";
+        readonly type: "'process'|'finish'|'error'|'warning'";
+        readonly default: "process";
+        readonly desc: "当前步状态";
+    }, {
+        readonly name: "size";
+        readonly type: "'small'|'default'|'large'";
+        readonly default: "default";
+    }, {
+        readonly name: "initial";
+        readonly type: "number";
+        readonly default: "0";
+        readonly desc: "起始序号偏移";
+    }, {
+        readonly name: "clickable";
+        readonly type: "boolean";
+        readonly default: "type==='nav'";
+    }, {
+        readonly name: "dot";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "点状步骤，图标渲染为小圆点";
+    }, {
+        readonly name: "icon";
+        readonly type: "Snippet<[{ step: StepItem; index: number; status: DerivedStatus }]>";
+        readonly default: "undefined";
+        readonly desc: "自定义图标渲染器，提供时替代默认序号/✓/✕";
+    }, {
+        readonly name: "onChange";
+        readonly type: "(current: number) => void";
+        readonly default: "undefined";
+    }, {
+        readonly name: "onClick";
+        readonly type: "(e: MouseEvent) => void";
+        readonly default: "undefined";
+        readonly desc: "步骤 button 点击事件（仅 clickable 模式下渲染 button 时触发）";
+    }, {
+        readonly name: "onKeyDown";
+        readonly type: "(e: KeyboardEvent) => void";
+        readonly default: "undefined";
+        readonly desc: "步骤 button 键盘按下事件（仅 clickable 模式下渲染 button 时触发）";
+    }, {
+        readonly name: "class";
+        readonly type: "string";
+        readonly default: "''";
+    }];
+    readonly stepItemProps: readonly [{
+        readonly name: "title";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "步骤标题";
+    }, {
+        readonly name: "description";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "步骤描述（次要信息）";
+    }, {
+        readonly name: "status";
+        readonly type: "'wait'|'process'|'finish'|'error'|'warning'";
+        readonly default: "undefined";
+        readonly desc: "显式覆盖该步状态；不传时由 current 推断";
+    }, {
+        readonly name: "disabled";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "禁用该步：不可点击、不可聚焦、置灰";
+    }];
+    readonly a11y: {
+        readonly role: "list";
+        readonly keyboard: readonly ["Tab", "Enter", "Space"];
+        readonly notes: readonly ["ol/li 结构", "clickable 时每步为原生 button，当前步 aria-current=step", "图标对勾/✕ 用 aria-hidden，状态靠文本与 aria-current 表达", "连接线 aria-hidden=true"];
+    };
+    readonly tokens: readonly ["--cd-steps-*", "--cd-focus-ring", "--cd-radius-full", "--cd-spacing-*", "--cd-font-size-1"];
+};
+//# sourceMappingURL=meta.d.ts.map

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

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