@chenzy-design/svelte 0.1.0

package/dist/breadcrumb/BreadcrumbKbdFixture.svelte

@@ -0,0 +1,23 @@
+<!--
+  仅供 Breadcrumb.kbd.test.ts（browser project）使用的折叠 disclosure 键盘 e2e 夹具。
+  maxItemCount=3 + 5 个路由 → 中间折叠为 … 触发器；moreType='popover' 使其成为
+  click 触发的 disclosure：折叠触发器经 Popover 包裹（cd-popover__trigger 承载 role=button
+  + aria-haspopup + aria-expanded），Enter/Space 展开浮层菜单（role=menu，portal 到 body）。
+-->
+<script lang="ts">
+  import { LocaleProvider } from '../locale-provider/index.js';
+  import Breadcrumb from './Breadcrumb.svelte';
+  import type { BreadcrumbRoute } from './types.js';
+
+  const routes: BreadcrumbRoute[] = [
+    { label: 'Home', href: '#home' },
+    { label: 'Library', href: '#library' },
+    { label: 'Data', href: '#data' },
+    { label: 'Reports', href: '#reports' },
+    { label: 'Q3', href: '#q3' },
+  ];
+</script>
+
+<LocaleProvider locale="en_US">
+  <Breadcrumb {routes} maxItemCount={3} moreType="popover" />
+</LocaleProvider>

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

package/dist/breadcrumb/BreadcrumbKbdFixture.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BreadcrumbKbdFixture.svelte.d.ts","sourceRoot":"","sources":["../../src/breadcrumb/BreadcrumbKbdFixture.svelte.ts"],"names":[],"mappings":"AA4BA,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,oBAAoB;;kBAA+E,CAAC;AACxF,KAAK,oBAAoB,GAAG,YAAY,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACxE,eAAe,oBAAoB,CAAC"}

package/dist/breadcrumb/Item.svelte

@@ -0,0 +1,77 @@
+<!--
+  BreadcrumbItem — declarative item for the `<Breadcrumb.Item>` mode of Breadcrumb.
+  - 分隔符由父级纯 CSS（:not(:last-child)::after）自动插入，本组件只渲染自身。
+  - 最后一项语义（当前页：不可点 + aria-current=page）由父 context 注册顺序派生。
+-->
+<script lang="ts">
+  import type { Snippet } from 'svelte';
+  import { getBreadcrumbContext } from './context.js';
+
+  interface Props {
+    href?: string;
+    /** 覆盖父级 separator，仅对本项末尾的分隔符生效（声明式 CSS 模式用 --cd-breadcrumb-separator-content 注入） */
+    separator?: string;
+    /** 禁止链接/按钮行为：渲染为普通 span（不可点击），忽略 href 和 onClick；末项始终 noLink */
+    noLink?: boolean;
+    /** 项前置图标 snippet */
+    icon?: Snippet;
+    class?: string;
+    children?: Snippet;
+    onClick?: (e: MouseEvent) => void;
+  }
+
+  let { href, separator, noLink = false, icon, class: className = '', children, onClick }: Props = $props();
+
+  const ctx = getBreadcrumbContext();
+
+  // mount 时按源码顺序注册，unmount 注销；据此由父派生「是否最后一项」。
+  let id = $state(-1);
+  $effect(() => {
+    if (!ctx) return;
+    const myId = ctx.register();
+    id = myId;
+    return () => ctx.unregister(myId);
+  });
+
+  // 红线 #2: 纯派生，render 期只读。无 context 时退化为普通链接项。
+  const isLast = $derived(ctx ? id !== -1 && ctx.isLast(id) : false);
+
+  const cls = $derived(['cd-breadcrumb__item', className].filter(Boolean).join(' '));
+</script>
+
+<!--
+  separator prop：传入时以内联 CSS 变量 --cd-breadcrumb-separator-content 覆盖本项分隔符（仅声明式 CSS 模式）。
+  noLink：非最后一项也渲染为普通 span（不可点击/键盘激活）；语义上表示该层级无可导航地址。
+  icon：前置图标 snippet，渲染在 children 前。
+-->
+<li
+  class={cls}
+  style={separator !== undefined ? `--cd-breadcrumb-separator-content: '${separator}'` : undefined}
+>
+  {#if isLast || noLink}
+    <span
+      class="cd-breadcrumb__current"
+      aria-current={isLast ? 'page' : undefined}
+    >
+      {#if icon}{@render icon()}{/if}{@render children?.()}
+    </span>
+  {:else if href}
+    <a class="cd-breadcrumb__link" {href} onclick={onClick}>
+      {#if icon}{@render icon()}{/if}{@render children?.()}
+    </a>
+  {:else}
+    <span
+      class="cd-breadcrumb__text"
+      role="link"
+      tabindex="0"
+      onclick={onClick}
+      onkeydown={(e) => {
+        if (e.key === 'Enter' || e.key === ' ') {
+          e.preventDefault();
+          onClick?.(e as unknown as MouseEvent);
+        }
+      }}
+    >{#if icon}{@render icon()}{/if}{@render children?.()}</span
+    >
+  {/if}
+</li>

package/dist/breadcrumb/Item.svelte.d.ts

@@ -0,0 +1,17 @@
+import type { Snippet } from 'svelte';
+interface Props {
+    href?: string;
+    /** 覆盖父级 separator，仅对本项末尾的分隔符生效（声明式 CSS 模式用 --cd-breadcrumb-separator-content 注入） */
+    separator?: string;
+    /** 禁止链接/按钮行为：渲染为普通 span（不可点击），忽略 href 和 onClick；末项始终 noLink */
+    noLink?: boolean;
+    /** 项前置图标 snippet */
+    icon?: Snippet;
+    class?: string;
+    children?: Snippet;
+    onClick?: (e: MouseEvent) => void;
+}
+declare const Item: import("svelte").Component<Props, {}, "">;
+type Item = ReturnType<typeof Item>;
+export default Item;
+//# sourceMappingURL=Item.svelte.d.ts.map

package/dist/breadcrumb/Item.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Item.svelte.d.ts","sourceRoot":"","sources":["../../src/breadcrumb/Item.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAIpC,UAAU,KAAK;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oFAAoF;IACpF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,oBAAoB;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,IAAI,CAAC;CACnC;AAgDH,QAAA,MAAM,IAAI,2CAAwC,CAAC;AACnD,KAAK,IAAI,GAAG,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC;AACpC,eAAe,IAAI,CAAC"}

package/dist/breadcrumb/context.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 父 Breadcrumb 向声明式 <Breadcrumb.Item> 暴露的上下文。
+ * 用 getter 跨 context 边界保持响应性（直接读快照会冻结初始值）。
+ *
+ * 红线 #2: isLast 为纯派生函数（基于注册顺序的纯比较），render 期只读不写。
+ * 注册/注销发生在 mount/unmount 副作用（$effect），与渲染派生分离。
+ */
+export interface BreadcrumbContext {
+    /** Item 挂载时注册自身（按源码顺序），返回稳定 id。 */
+    register: () => number;
+    /** Item 卸载时注销。 */
+    unregister: (id: number) => void;
+    /** 该 id 是否为最后一项（当前页：不可点 + aria-current=page）。纯派生。 */
+    isLast: (id: number) => boolean;
+}
+export declare function setBreadcrumbContext(ctx: BreadcrumbContext): void;
+export declare function getBreadcrumbContext(): BreadcrumbContext | undefined;
+//# sourceMappingURL=context.d.ts.map

package/dist/breadcrumb/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/breadcrumb/context.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,mCAAmC;IACnC,QAAQ,EAAE,MAAM,MAAM,CAAC;IACvB,kBAAkB;IAClB,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,qDAAqD;IACrD,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC;CACjC;AAID,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,iBAAiB,GAAG,IAAI,CAEjE;AAED,wBAAgB,oBAAoB,IAAI,iBAAiB,GAAG,SAAS,CAEpE"}

package/dist/breadcrumb/context.js

@@ -0,0 +1,8 @@
+import { getContext, setContext } from 'svelte';
+const KEY = Symbol('cd-breadcrumb');
+export function setBreadcrumbContext(ctx) {
+    setContext(KEY, ctx);
+}
+export function getBreadcrumbContext() {
+    return getContext(KEY);
+}

package/dist/breadcrumb/index.d.ts

@@ -0,0 +1,15 @@
+import BreadcrumbRoot from './Breadcrumb.svelte';
+import Item from './Item.svelte';
+/** Named exports (also usable directly). */
+export { default as BreadcrumbItem } from './Item.svelte';
+/**
+ * Aggregated namespace export: enables <Breadcrumb.Item />.
+ * Explicit type annotation avoids leaking component Props type errors.
+ */
+export declare const Breadcrumb: typeof BreadcrumbRoot & {
+    Item: typeof Item;
+};
+export { meta as breadcrumbMeta } from './meta.js';
+export type { BreadcrumbRoute } from './types.js';
+export { getBreadcrumbContext, setBreadcrumbContext, type BreadcrumbContext, } from './context.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/breadcrumb/index.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,MAAM,qBAAqB,CAAC;AACjD,OAAO,IAAI,MAAM,eAAe,CAAC;AAEjC,4CAA4C;AAC5C,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,eAAe,CAAC;AAE1D;;;GAGG;AACH,eAAO,MAAM,UAAU,EAAE,OAAO,cAAc,GAAG;IAC/C,IAAI,EAAE,OAAO,IAAI,CAAC;CACuB,CAAC;AAE5C,OAAO,EAAE,IAAI,IAAI,cAAc,EAAE,MAAM,WAAW,CAAC;AACnD,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,KAAK,iBAAiB,GACvB,MAAM,cAAc,CAAC"}

package/dist/breadcrumb/index.js

@@ -0,0 +1,11 @@
+import BreadcrumbRoot from './Breadcrumb.svelte';
+import Item from './Item.svelte';
+/** Named exports (also usable directly). */
+export { default as BreadcrumbItem } from './Item.svelte';
+/**
+ * Aggregated namespace export: enables <Breadcrumb.Item />.
+ * Explicit type annotation avoids leaking component Props type errors.
+ */
+export const Breadcrumb = Object.assign(BreadcrumbRoot, { Item });
+export { meta as breadcrumbMeta } from './meta.js';
+export { getBreadcrumbContext, setBreadcrumbContext, } from './context.js';

package/dist/breadcrumb/meta.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Machine-readable component metadata for AI/docs consumption.
+ * See specs/00-foundation/ai-friendly.spec.md.
+ */
+export declare const meta: {
+    readonly name: "Breadcrumb";
+    readonly category: "navigation";
+    readonly description: "面包屑导航，展示当前页面在层级结构中的位置。支持数据驱动 routes 与声明式 Item 两种用法。";
+    readonly props: readonly [{
+        readonly name: "routes";
+        readonly type: "BreadcrumbRoute[]";
+        readonly default: "[]";
+        readonly desc: "数据驱动的路由项，最后一项为当前页（aria-current=page）";
+    }, {
+        readonly name: "separator";
+        readonly type: "string";
+        readonly default: "'/'";
+        readonly desc: "分隔符文本";
+    }, {
+        readonly name: "maxItemCount";
+        readonly type: "number";
+        readonly default: "0";
+        readonly desc: "超出时中间折叠（0=不折叠）";
+    }, {
+        readonly name: "showTooltip";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "项文本超出 --cd-breadcrumb-item-max-width 被截断时，hover 用 Tooltip 展示完整 label";
+    }, {
+        readonly name: "moreType";
+        readonly type: "'tooltip'|'popover'";
+        readonly default: "undefined";
+        readonly desc: "折叠 … 的浮层类型：tooltip 悬浮列出被折叠项文本；popover 点击展开可点击跳转的折叠项列表。不设时点击 … 直接展开全部（向后兼容）";
+    }, {
+        readonly name: "size";
+        readonly type: "'small'|'default'|'large'";
+        readonly default: "default";
+    }, {
+        readonly name: "compact";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "紧凑模式；false 时根元素附加 cd-breadcrumb--loose 类（更大字号/间距）";
+    }, {
+        readonly name: "autoCollapse";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "超出 maxItemCount 时是否自动折叠；false 时始终展示全部项";
+    }, {
+        readonly name: "activeIndex";
+        readonly type: "number";
+        readonly default: "undefined";
+        readonly desc: "受控选中项索引（配合 onClick 使用，令对应项高亮）";
+    }, {
+        readonly name: "renderItem";
+        readonly type: "(route: BreadcrumbRoute, index: number, isLast: boolean) => Snippet";
+        readonly default: "undefined";
+        readonly desc: "自定义路由项渲染（routes 模式）；传入时替换默认的链接/文本/当前页渲染逻辑";
+    }, {
+        readonly name: "renderMore";
+        readonly type: "(restItems: CollapsedRoute[]) => Snippet";
+        readonly default: "undefined";
+        readonly desc: "自定义折叠 … 区域渲染；传入时接管折叠展示（替代 moreType 内置浮层），参数为被折叠路由列表";
+    }, {
+        readonly name: "class";
+        readonly type: "string";
+        readonly default: "''";
+    }, {
+        readonly name: "children";
+        readonly type: "Snippet";
+        readonly default: "undefined";
+        readonly desc: "声明式 <Breadcrumb.Item> 列表；项间分隔符按 separator 纯 CSS 自动插入，最后一项后无分隔符";
+    }, {
+        readonly name: "onClick";
+        readonly type: "(route: BreadcrumbRoute, index: number) => void";
+        readonly default: "undefined";
+    }];
+    readonly subComponents: readonly [{
+        readonly name: "BreadcrumbItem";
+        readonly usage: "<Breadcrumb.Item> 或 <BreadcrumbItem>，置于 <Breadcrumb> 的 children 内";
+        readonly desc: "声明式面包屑项；项间分隔符由父级纯 CSS 自动插入，最后一项自动渲染为当前页（不可点 + aria-current=page）";
+        readonly props: readonly [{
+            readonly name: "href";
+            readonly type: "string";
+            readonly default: "undefined";
+            readonly desc: "链接地址；最后一项忽略 href";
+        }, {
+            readonly name: "separator";
+            readonly type: "string";
+            readonly default: "undefined";
+            readonly desc: "覆盖父级 separator，仅对本项末尾分隔符生效（通过内联 CSS 变量实现）";
+        }, {
+            readonly name: "noLink";
+            readonly type: "boolean";
+            readonly default: "false";
+            readonly desc: "禁止链接/按钮行为，渲染为普通 span（不可点击）；忽略 href 和 onClick；末项始终无链接";
+        }, {
+            readonly name: "icon";
+            readonly type: "Snippet";
+            readonly default: "undefined";
+            readonly desc: "项前置图标 snippet，渲染在 children 之前";
+        }, {
+            readonly name: "class";
+            readonly type: "string";
+            readonly default: "''";
+        }, {
+            readonly name: "children";
+            readonly type: "Snippet";
+            readonly default: "undefined";
+        }, {
+            readonly name: "onClick";
+            readonly type: "(e: MouseEvent) => void";
+            readonly default: "undefined";
+            readonly desc: "点击/键盘激活回调；最后一项及 noLink=true 时不触发";
+        }];
+    }];
+    readonly a11y: {
+        readonly role: "navigation";
+        readonly keyboard: readonly ["Enter", "Space"];
+        readonly notes: readonly ["nav[aria-label] 包裹 ol 有序列表", "最后一项 aria-current=page，不可点击", "无 href 的中间项用 role=link + tabindex=0 + 键盘可激活", "分隔符 aria-hidden=true"];
+    };
+    readonly tokens: readonly ["--cd-breadcrumb-*", "--cd-breadcrumb-item-max-width", "--cd-focus-ring", "--cd-font-size-*", "--cd-radius-1"];
+};
+//# sourceMappingURL=meta.d.ts.map

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

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

package/dist/breadcrumb/meta.js

@@ -0,0 +1,127 @@
+/**
+ * Machine-readable component metadata for AI/docs consumption.
+ * See specs/00-foundation/ai-friendly.spec.md.
+ */
+export const meta = {
+    name: 'Breadcrumb',
+    category: 'navigation',
+    description: '面包屑导航，展示当前页面在层级结构中的位置。支持数据驱动 routes 与声明式 Item 两种用法。',
+    props: [
+        {
+            name: 'routes',
+            type: 'BreadcrumbRoute[]',
+            default: '[]',
+            desc: '数据驱动的路由项，最后一项为当前页（aria-current=page）',
+        },
+        { name: 'separator', type: 'string', default: "'/'", desc: '分隔符文本' },
+        { name: 'maxItemCount', type: 'number', default: '0', desc: '超出时中间折叠（0=不折叠）' },
+        {
+            name: 'showTooltip',
+            type: 'boolean',
+            default: 'false',
+            desc: '项文本超出 --cd-breadcrumb-item-max-width 被截断时，hover 用 Tooltip 展示完整 label',
+        },
+        {
+            name: 'moreType',
+            type: "'tooltip'|'popover'",
+            default: 'undefined',
+            desc: '折叠 … 的浮层类型：tooltip 悬浮列出被折叠项文本；popover 点击展开可点击跳转的折叠项列表。不设时点击 … 直接展开全部（向后兼容）',
+        },
+        { name: 'size', type: "'small'|'default'|'large'", default: 'default' },
+        {
+            name: 'compact',
+            type: 'boolean',
+            default: 'true',
+            desc: '紧凑模式；false 时根元素附加 cd-breadcrumb--loose 类（更大字号/间距）',
+        },
+        {
+            name: 'autoCollapse',
+            type: 'boolean',
+            default: 'true',
+            desc: '超出 maxItemCount 时是否自动折叠；false 时始终展示全部项',
+        },
+        {
+            name: 'activeIndex',
+            type: 'number',
+            default: 'undefined',
+            desc: '受控选中项索引（配合 onClick 使用，令对应项高亮）',
+        },
+        {
+            name: 'renderItem',
+            type: '(route: BreadcrumbRoute, index: number, isLast: boolean) => Snippet',
+            default: 'undefined',
+            desc: '自定义路由项渲染（routes 模式）；传入时替换默认的链接/文本/当前页渲染逻辑',
+        },
+        {
+            name: 'renderMore',
+            type: '(restItems: CollapsedRoute[]) => Snippet',
+            default: 'undefined',
+            desc: '自定义折叠 … 区域渲染；传入时接管折叠展示（替代 moreType 内置浮层），参数为被折叠路由列表',
+        },
+        { name: 'class', type: 'string', default: "''" },
+        {
+            name: 'children',
+            type: 'Snippet',
+            default: 'undefined',
+            desc: '声明式 <Breadcrumb.Item> 列表；项间分隔符按 separator 纯 CSS 自动插入，最后一项后无分隔符',
+        },
+        {
+            name: 'onClick',
+            type: '(route: BreadcrumbRoute, index: number) => void',
+            default: 'undefined',
+        },
+    ],
+    subComponents: [
+        {
+            name: 'BreadcrumbItem',
+            usage: '<Breadcrumb.Item> 或 <BreadcrumbItem>，置于 <Breadcrumb> 的 children 内',
+            desc: '声明式面包屑项；项间分隔符由父级纯 CSS 自动插入，最后一项自动渲染为当前页（不可点 + aria-current=page）',
+            props: [
+                { name: 'href', type: 'string', default: 'undefined', desc: '链接地址；最后一项忽略 href' },
+                {
+                    name: 'separator',
+                    type: 'string',
+                    default: 'undefined',
+                    desc: '覆盖父级 separator，仅对本项末尾分隔符生效（通过内联 CSS 变量实现）',
+                },
+                {
+                    name: 'noLink',
+                    type: 'boolean',
+                    default: 'false',
+                    desc: '禁止链接/按钮行为，渲染为普通 span（不可点击）；忽略 href 和 onClick；末项始终无链接',
+                },
+                {
+                    name: 'icon',
+                    type: 'Snippet',
+                    default: 'undefined',
+                    desc: '项前置图标 snippet，渲染在 children 之前',
+                },
+                { name: 'class', type: 'string', default: "''" },
+                { name: 'children', type: 'Snippet', default: 'undefined' },
+                {
+                    name: 'onClick',
+                    type: '(e: MouseEvent) => void',
+                    default: 'undefined',
+                    desc: '点击/键盘激活回调；最后一项及 noLink=true 时不触发',
+                },
+            ],
+        },
+    ],
+    a11y: {
+        role: 'navigation',
+        keyboard: ['Enter', 'Space'],
+        notes: [
+            'nav[aria-label] 包裹 ol 有序列表',
+            '最后一项 aria-current=page，不可点击',
+            '无 href 的中间项用 role=link + tabindex=0 + 键盘可激活',
+            '分隔符 aria-hidden=true',
+        ],
+    },
+    tokens: [
+        '--cd-breadcrumb-*',
+        '--cd-breadcrumb-item-max-width',
+        '--cd-focus-ring',
+        '--cd-font-size-*',
+        '--cd-radius-1',
+    ],
+};

package/dist/breadcrumb/types.d.ts

@@ -0,0 +1,5 @@
+export interface BreadcrumbRoute {
+    label: string;
+    href?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/breadcrumb/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/breadcrumb/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}

package/dist/breadcrumb/types.js

@@ -0,0 +1 @@
+export {};

package/dist/button/Button.a11y.test.d.ts

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

package/dist/button/Button.a11y.test.d.ts.map

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

package/dist/button/Button.a11y.test.js

@@ -0,0 +1,49 @@
+// Button a11y 试点：纯展示组件（无 useLocale）。验证 axe 0 violations + 基础 role/aria。
+import { describe, it, expect } from 'vitest';
+import { renderWithLocale, expectNoAxeViolations } from '../test-utils/a11y.js';
+import Button from './Button.svelte';
+describe('Button a11y', () => {
+    it('按钮：原生 <button>，type=button，无 axe violations', async () => {
+        // 无默认插槽文字时用 ariaLabel 提供可访问名（否则 axe button-name 报错）。
+        const { container } = renderWithLocale(Button, {
+            props: { type: 'primary', ariaLabel: 'Confirm' },
+        });
+        const btn = container.querySelector('button');
+        expect(btn).not.toBeNull();
+        expect(btn?.getAttribute('type')).toBe('button');
+        await expectNoAxeViolations(container);
+    });
+    it('icon-only 按钮：用 ariaLabel 提供可访问名，无 axe violations', async () => {
+        const { container } = renderWithLocale(Button, {
+            props: { ariaLabel: 'Close panel' },
+        });
+        const btn = container.querySelector('button');
+        expect(btn?.getAttribute('aria-label')).toBe('Close panel');
+        await expectNoAxeViolations(container);
+    });
+    it('disabled 按钮：原生 disabled 属性', async () => {
+        const { container } = renderWithLocale(Button, {
+            props: { ariaLabel: 'Submit', disabled: true },
+        });
+        const btn = container.querySelector('button');
+        expect(btn?.hasAttribute('disabled')).toBe(true);
+        await expectNoAxeViolations(container);
+    });
+    it('loading 按钮：aria-busy=true', async () => {
+        const { container } = renderWithLocale(Button, {
+            props: { ariaLabel: 'Saving', loading: true },
+        });
+        const btn = container.querySelector('button');
+        expect(btn?.getAttribute('aria-busy')).toBe('true');
+        await expectNoAxeViolations(container);
+    });
+    it('链接按钮（href）：role=button 的 <a>，无 axe violations', async () => {
+        const { container } = renderWithLocale(Button, {
+            props: { href: 'https://example.com', ariaLabel: 'Open docs' },
+        });
+        const link = container.querySelector('a');
+        expect(link?.getAttribute('role')).toBe('button');
+        expect(link?.getAttribute('href')).toBe('https://example.com');
+        await expectNoAxeViolations(container);
+    });
+});