@chenzy-design/svelte 0.1.0

package/dist/tabs/Tabs.svelte.d.ts

@@ -0,0 +1,89 @@
+import type { Snippet } from 'svelte';
+import type { TabItem } from './types.js';
+type TabKey = string | number;
+type TabType = 'line' | 'card' | 'button';
+type TabSize = 'small' | 'default' | 'large';
+type TabPosition = 'top' | 'bottom' | 'left' | 'right';
+type KeyboardActivation = 'auto' | 'manual';
+type OverflowMode = 'scroll' | 'dropdown';
+type MoreConfig = number | {
+    count?: number;
+    render?: Snippet;
+    dropdownProps?: Record<string, unknown>;
+};
+interface Props {
+    value?: TabKey;
+    defaultValue?: TabKey;
+    type?: TabType;
+    size?: TabSize;
+    tabPosition?: TabPosition;
+    tabList?: TabItem[];
+    closable?: boolean;
+    keyboardActivation?: KeyboardActivation;
+    /**
+     * 横向溢出处理方式：
+     * - 'scroll'（默认）：标签超出容器时显示前/后滚动箭头，命令式滚动；
+     * - 'dropdown'：把放不下的标签收纳进末尾「更多」下拉，点下拉项跳到对应 tab。
+     * 仅 top/bottom 横向标签栏生效；纵向（left/right）始终走滚动。
+     */
+    overflow?: OverflowMode;
+    /**
+     * line 风格横向溢出时启用折叠收纳（与 overflow='dropdown' 同效：放不下的标签进末尾「更多」下拉）。
+     * 便捷开关：为 true 时强制走 dropdown 收纳（仅 top/bottom 横向生效）。默认 false。
+     */
+    collapsible?: boolean;
+    /** 首次激活后才挂载面板内容 */
+    lazy?: boolean;
+    /** 激活过的面板切走后保留 DOM（display:none），而非卸载 */
+    keepDOM?: boolean;
+    /** 标签栏末尾显示「+」按钮，点击触发 onAdd（受控数据，由父组件追加） */
+    addable?: boolean;
+    /**
+     * 溢出折叠配置：数字时等价于 { count: n }；对象时含 count（收起阈值）、
+     * render（自定义「更多」触发器 Snippet）、dropdownProps（透传下拉参数）。
+     * 仅 overflow='dropdown'（或 collapsible=true）时生效。
+     */
+    more?: MoreConfig;
+    /** 标签栏末尾「更多」下拉折叠时，折叠箭头位置（scroll 模式中的前/后箭头）。默认 'both'。 */
+    arrowPosition?: 'start' | 'end' | 'both';
+    /** 自定义前/后折叠箭头 Snippet，接收 { type:'start'|'end', onClick:()=>void } */
+    renderArrow?: Snippet<[{
+        type: 'start' | 'end';
+        onClick: () => void;
+    }]>;
+    /** dropdown 折叠模式是否在下拉中展示收起 tabs（默认 true） */
+    showRestInDropdown?: boolean;
+    /** 透传给「更多」Dropdown 组件的 props */
+    dropdownProps?: Record<string, unknown>;
+    /** 溢出项变化回调，携带当前可见 tab keys */
+    onVisibleTabsChange?: (visibleTabKeys: TabKey[]) => void;
+    /** 内容区外层样式（string 或 CSSProperties 对象） */
+    contentStyle?: string | Record<string, string>;
+    /** Tab 聚焦是否阻止页面滚动（默认 false） */
+    preventScroll?: boolean;
+    /** 面板切换是否启用动画（默认 true） */
+    tabPaneMotion?: boolean;
+    /** 标签栏右侧额外内容 */
+    tabBarExtraContent?: Snippet;
+    onChange?: (key: TabKey) => void;
+    onTabClose?: (key: TabKey) => void;
+    /**
+     * 标签被点击回调（spec §4：on:tabClick）。含已选中标签（未必触发 onChange），
+     * 在 disabled 拦截前发出，可用于埋点。
+     */
+    onTabClick?: (key: TabKey, event: MouseEvent) => void;
+    /** addable=true 时点击「+」按钮回调（红线 #1：组件内部不改 tabList） */
+    onAdd?: () => void;
+    /**
+     * 自定义整个标签栏的渲染（调用方完全自绘标签栏）。
+     * 接收：当前 tab 列表（数据驱动 tabList 或声明式收集结果）、当前激活 key、
+     * 切换回调 setActive（受控时仅触发 onChange，不回写 value，红线 #1）。
+     * 传入时跳过内置标签栏与溢出处理；面板内容仍按 activeKey 显隐。
+     */
+    renderTabBar?: Snippet<[TabItem[], TabKey | undefined, (key: TabKey) => void]>;
+    children?: Snippet;
+}
+declare const Tabs: import("svelte").Component<Props, {}, "">;
+type Tabs = ReturnType<typeof Tabs>;
+export default Tabs;
+//# sourceMappingURL=Tabs.svelte.d.ts.map

package/dist/tabs/Tabs.svelte.d.ts.map

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

package/dist/tabs/TabsA11yFixture.svelte

@@ -0,0 +1,20 @@
+<!--
+  仅供 Tabs.a11y.test.ts 使用的测试夹具：声明式 <Tabs.Pane> 用法（含 role=tabpanel 面板），
+  使 tab 的 aria-controls 指向真实存在的面板 id（axe aria-valid-attr-value 通过）。
+  纯 tabList 用法不渲染面板，aria-controls 会悬空，不是 a11y-clean 路径。
+-->
+<script lang="ts">
+  import { Tabs } from './index.js';
+
+  interface Props {
+    defaultValue?: string | number;
+    type?: 'line' | 'card' | 'button';
+  }
+  let { defaultValue = 'overview', type = 'line' }: Props = $props();
+</script>
+
+<Tabs {defaultValue} {type}>
+  <Tabs.Pane itemKey="overview" tab="Overview">Overview content</Tabs.Pane>
+  <Tabs.Pane itemKey="details" tab="Details">Details content</Tabs.Pane>
+  <Tabs.Pane itemKey="history" tab="History">History content</Tabs.Pane>
+</Tabs>

package/dist/tabs/TabsA11yFixture.svelte.d.ts

@@ -0,0 +1,8 @@
+interface Props {
+    defaultValue?: string | number;
+    type?: 'line' | 'card' | 'button';
+}
+declare const TabsA11yFixture: import("svelte").Component<Props, {}, "">;
+type TabsA11yFixture = ReturnType<typeof TabsA11yFixture>;
+export default TabsA11yFixture;
+//# sourceMappingURL=TabsA11yFixture.svelte.d.ts.map

package/dist/tabs/TabsA11yFixture.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TabsA11yFixture.svelte.d.ts","sourceRoot":"","sources":["../../src/tabs/TabsA11yFixture.svelte.ts"],"names":[],"mappings":"AAME,UAAU,KAAK;IACb,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;CACnC;AAgBH,QAAA,MAAM,eAAe,2CAAwC,CAAC;AAC9D,KAAK,eAAe,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;AAC1D,eAAe,eAAe,CAAC"}

package/dist/tabs/TabsKbdFixture.svelte

@@ -0,0 +1,25 @@
+<!--
+  仅供 Tabs.kbd.test.ts（browser project）使用的 tablist roving 键盘 e2e 夹具。
+  声明式 <Tabs.Pane> 用法：tab 的 aria-controls 指向真实面板，面板按 activeKey 显隐，
+  便于断言 keyboardActivation='auto'（默认）下「焦点移动即激活」。
+  菜单前后各放一个按钮，用于验证 roving 单停靠点（Tab 只进一个 tab，其余 tabindex=-1）。
+-->
+<script lang="ts">
+  import { LocaleProvider } from '../locale-provider/index.js';
+  import { Tabs } from './index.js';
+
+  interface Props {
+    defaultValue?: string;
+  }
+  let { defaultValue = 'overview' }: Props = $props();
+</script>
+
+<LocaleProvider locale="en_US">
+  <button type="button" data-testid="before">before</button>
+  <Tabs {defaultValue} type="line">
+    <Tabs.Pane itemKey="overview" tab="Overview">Overview content</Tabs.Pane>
+    <Tabs.Pane itemKey="details" tab="Details">Details content</Tabs.Pane>
+    <Tabs.Pane itemKey="history" tab="History">History content</Tabs.Pane>
+  </Tabs>
+  <button type="button" data-testid="after">after</button>
+</LocaleProvider>

package/dist/tabs/TabsKbdFixture.svelte.d.ts

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

package/dist/tabs/TabsKbdFixture.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TabsKbdFixture.svelte.d.ts","sourceRoot":"","sources":["../../src/tabs/TabsKbdFixture.svelte.ts"],"names":[],"mappings":"AAOE,UAAU,KAAK;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAqBH,QAAA,MAAM,cAAc,2CAAwC,CAAC;AAC7D,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AACxD,eAAe,cAAc,CAAC"}

package/dist/tabs/context.d.ts

@@ -0,0 +1,33 @@
+/** 声明式 <Tabs.Pane> 向父 Tabs 注册时上报的标签元数据（推导 tabList 用）。 */
+export interface TabPaneRegistration {
+    itemKey: string | number;
+    tab: string;
+    disabled?: boolean;
+    closable?: boolean;
+}
+export interface TabsContext {
+    /** 当前激活 key 的 getter（响应式，TabPane 读取以决定显隐） */
+    getActiveKey: () => string | number | undefined;
+    /** 是否懒加载（首次激活才挂载） */
+    getLazy: () => boolean;
+    /** 是否保留激活过的面板 DOM（display:none 隐藏而非卸载） */
+    getKeepDOM: () => boolean;
+    /** 稳定 tab 按钮 id（与 panel 的 aria-labelledby 双向关联）。 */
+    getTabId: (key: string | number) => string;
+    /** 稳定 tabpanel id（与 tab 的 aria-controls 双向关联）。 */
+    getPanelId: (key: string | number) => string;
+    /**
+     * 纯声明式自动收集：父未传 tabList 时，TabPane 挂载时注册自身标签元数据（按源码顺序）。
+     * 返回稳定 id，TabPane 卸载时用它注销；元数据变化时调用 update 同步。
+     *
+     * 红线 #2：注册/注销/更新均发生在 TabPane 的 mount/unmount/同步 $effect（副作用），
+     * 写父级簿记普通数组 + 仅 bump 一个 version $state；父 render 派生只读 version 重建快照，
+     * 子 effect 绝不读该快照 → 副作用写 / 渲染读分离，无 effect 自循环。
+     */
+    registerPane?: (reg: TabPaneRegistration) => number;
+    updatePane?: (id: number, reg: TabPaneRegistration) => void;
+    unregisterPane?: (id: number) => void;
+}
+export declare function setTabsContext(ctx: TabsContext): void;
+export declare function getTabsContext(): TabsContext | undefined;
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/tabs/context.ts"],"names":[],"mappings":"AAIA,yDAAyD;AACzD,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,6CAA6C;IAC7C,YAAY,EAAE,MAAM,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAChD,qBAAqB;IACrB,OAAO,EAAE,MAAM,OAAO,CAAC;IACvB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,OAAO,CAAC;IAC1B,oDAAoD;IACpD,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,KAAK,MAAM,CAAC;IAC3C,kDAAkD;IAClD,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,KAAK,MAAM,CAAC;IAC7C;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,mBAAmB,KAAK,MAAM,CAAC;IACpD,UAAU,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAC5D,cAAc,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAErD;AAED,wBAAgB,cAAc,IAAI,WAAW,GAAG,SAAS,CAExD"}

package/dist/tabs/context.js

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

package/dist/tabs/index.d.ts

@@ -0,0 +1,13 @@
+import TabsComponent from './Tabs.svelte';
+import TabPane from './TabPane.svelte';
+/**
+ * 命名空间聚合导出：支持 <Tabs.Pane />。
+ * 显式类型注解避免泄漏组件内部 Props 类型导致的声明 emit 报错。
+ */
+export declare const Tabs: typeof TabsComponent & {
+    Pane: typeof TabPane;
+};
+export { default as TabPane } from './TabPane.svelte';
+export { meta as tabsMeta } from './meta.js';
+export type { TabItem } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tabs/index.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,eAAe,CAAC;AAC1C,OAAO,OAAO,MAAM,kBAAkB,CAAC;AAEvC;;;GAGG;AACH,eAAO,MAAM,IAAI,EAAE,OAAO,aAAa,GAAG;IACxC,IAAI,EAAE,OAAO,OAAO,CAAC;CAC4B,CAAC;AAEpD,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,IAAI,IAAI,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC7C,YAAY,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC"}

package/dist/tabs/index.js

@@ -0,0 +1,9 @@
+import TabsComponent from './Tabs.svelte';
+import TabPane from './TabPane.svelte';
+/**
+ * 命名空间聚合导出：支持 <Tabs.Pane />。
+ * 显式类型注解避免泄漏组件内部 Props 类型导致的声明 emit 报错。
+ */
+export const Tabs = Object.assign(TabsComponent, { Pane: TabPane });
+export { default as TabPane } from './TabPane.svelte';
+export { meta as tabsMeta } from './meta.js';

package/dist/tabs/meta.d.ts

@@ -0,0 +1,159 @@
+/**
+ * Machine-readable component metadata for AI/docs consumption.
+ * See specs/00-foundation/ai-friendly.spec.md.
+ */
+export declare const meta: {
+    readonly name: "Tabs";
+    readonly category: "navigation";
+    readonly description: "标签页，在同一区域内组织并切换多组对等内容。支持 line/card/button 类型、数据驱动 tabList 或纯声明式 <Tabs.Pane> 自动收集、renderTabBar 自定义标签栏、roving tabindex 键盘导航、可关闭标签与溢出滚动/下拉收纳（overflow）。";
+    readonly props: readonly [{
+        readonly name: "value";
+        readonly type: "string|number";
+        readonly default: "undefined";
+        readonly desc: "受控选中标签 key";
+    }, {
+        readonly name: "defaultValue";
+        readonly type: "string|number";
+        readonly default: "首个标签";
+        readonly desc: "非受控初始 key";
+    }, {
+        readonly name: "type";
+        readonly type: "'line'|'card'|'button'";
+        readonly default: "line";
+        readonly desc: "视觉风格（button=分段按钮组）";
+    }, {
+        readonly name: "size";
+        readonly type: "'small'|'default'|'large'";
+        readonly default: "default";
+    }, {
+        readonly name: "tabPosition";
+        readonly type: "'top'|'bottom'|'left'|'right'";
+        readonly default: "top";
+        readonly desc: "标签栏位置";
+    }, {
+        readonly name: "lazy";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "首次激活后才挂载面板";
+    }, {
+        readonly name: "keepDOM";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "激活过的面板保留 DOM";
+    }, {
+        readonly name: "tabList";
+        readonly type: "TabItem[]";
+        readonly default: "undefined";
+        readonly desc: "数据驱动标签定义；不传则从子 <Tabs.Pane> 的 tab/itemKey/disabled/closable 纯声明式自动收集";
+    }, {
+        readonly name: "closable";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "全局可关闭（单项可覆盖）";
+    }, {
+        readonly name: "addable";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "标签栏末尾显示「+」按钮，点击触发 onAdd（受控，由父组件追加）";
+    }, {
+        readonly name: "keyboardActivation";
+        readonly type: "'auto'|'manual'";
+        readonly default: "auto";
+        readonly desc: "方向键聚焦即激活 / 需 Enter/Space 激活";
+    }, {
+        readonly name: "overflow";
+        readonly type: "'scroll'|'dropdown'";
+        readonly default: "scroll";
+        readonly desc: "横向溢出处理：scroll 前/后滚动箭头；dropdown 收纳进末尾「更多」下拉（仅 top/bottom 生效，纵向始终滚动）";
+    }, {
+        readonly name: "collapsible";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "line 风格横向溢出时启用折叠收纳（便捷开关，等价 overflow=dropdown：放不下的标签进末尾「更多」下拉，仅 top/bottom 生效）";
+    }, {
+        readonly name: "more";
+        readonly type: "number | { count?: number; render?: Snippet; dropdownProps?: object }";
+        readonly default: "undefined";
+        readonly desc: "溢出折叠配置：数字简写或对象形式，仅 dropdown 模式有效";
+    }, {
+        readonly name: "arrowPosition";
+        readonly type: "'start'|'end'|'both'";
+        readonly default: "both";
+        readonly desc: "scroll 模式中前/后箭头位置";
+    }, {
+        readonly name: "renderArrow";
+        readonly type: "Snippet<[{ type: 'start'|'end'; onClick: () => void }]>";
+        readonly default: "undefined";
+        readonly desc: "自定义前/后滚动箭头";
+    }, {
+        readonly name: "showRestInDropdown";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "dropdown 折叠模式是否在下拉中展示收起 tabs";
+    }, {
+        readonly name: "dropdownProps";
+        readonly type: "object";
+        readonly default: "undefined";
+        readonly desc: "透传给「更多」Dropdown 组件的 props";
+    }, {
+        readonly name: "onVisibleTabsChange";
+        readonly type: "(visibleTabKeys: (string|number)[]) => void";
+        readonly default: "undefined";
+        readonly desc: "dropdown 模式下溢出项变化时回调，携带当前可见 tab keys";
+    }, {
+        readonly name: "contentStyle";
+        readonly type: "string | Record<string, string>";
+        readonly default: "undefined";
+        readonly desc: "内容区外层样式（string 或 CSSProperties 对象）";
+    }, {
+        readonly name: "preventScroll";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "Tab 聚焦时是否阻止页面滚动";
+    }, {
+        readonly name: "tabPaneMotion";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "面板切换是否启用动画";
+    }, {
+        readonly name: "tabBarExtraContent";
+        readonly type: "Snippet";
+        readonly default: "undefined";
+        readonly desc: "标签栏右侧额外内容";
+    }, {
+        readonly name: "onChange";
+        readonly type: "(key: string|number) => void";
+        readonly default: "undefined";
+    }, {
+        readonly name: "onTabClose";
+        readonly type: "(key: string|number) => void";
+        readonly default: "undefined";
+    }, {
+        readonly name: "onTabClick";
+        readonly type: "(key: string|number, event: MouseEvent) => void";
+        readonly default: "undefined";
+        readonly desc: "标签被点击触发（含已选中标签，未必触发 onChange；disabled 拦截前发出，可用于埋点）";
+    }, {
+        readonly name: "onAdd";
+        readonly type: "() => void";
+        readonly default: "undefined";
+        readonly desc: "addable=true 时点击「+」按钮回调（受控数据，组件内不改 tabList）";
+    }, {
+        readonly name: "renderTabBar";
+        readonly type: "Snippet<[TabItem[], string|number|undefined, (key) => void]>";
+        readonly default: "undefined";
+        readonly desc: "自定义整个标签栏渲染（接收 tab 列表、当前激活 key、切换回调 setActive）；传入时跳过内置标签栏与溢出处理，面板内容仍按 activeKey 显隐";
+    }, {
+        readonly name: "children";
+        readonly type: "Snippet";
+        readonly default: "undefined";
+        readonly desc: "声明式 TabPane 内容（<Tabs.Pane>）";
+    }];
+    readonly a11y: {
+        readonly role: "tablist";
+        readonly keyboard: readonly ["ArrowLeft", "ArrowRight", "ArrowUp", "ArrowDown", "Home", "End", "Enter", "Space"];
+        readonly notes: readonly ["tablist 内每个标签为 role=tab，aria-selected 标记激活，aria-controls 关联面板", "roving tabindex：仅激活标签 tabindex=0，其余 -1", "keyboardActivation=auto 聚焦即激活，manual 需 Enter/Space 确认", "面板 role=tabpanel；关闭叉为带 aria-label 的原生 button", "标签溢出时出现前/后滚动箭头（带 aria-label，tabindex=-1 不入 Tab 序），激活标签自动滚到可视区", "overflow=dropdown 时溢出标签收进末尾「更多」下拉（aria-haspopup=menu，带 aria-label），激活标签始终保持可见", "addable 的「+」为带 aria-label 的原生 button", "renderTabBar 自定义标签栏时由调用方负责无障碍语义（role=tab/aria-selected 等）", "preventScroll=true 时 Tab 聚焦不触发页面滚动"];
+    };
+    readonly tokens: readonly ["--cd-tabs-*", "--cd-focus-ring", "--cd-radius-1", "--cd-spacing-*"];
+};
+//# sourceMappingURL=meta.d.ts.map

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

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

package/dist/tabs/meta.js

@@ -0,0 +1,151 @@
+/**
+ * Machine-readable component metadata for AI/docs consumption.
+ * See specs/00-foundation/ai-friendly.spec.md.
+ */
+export const meta = {
+    name: 'Tabs',
+    category: 'navigation',
+    description: '标签页，在同一区域内组织并切换多组对等内容。支持 line/card/button 类型、数据驱动 tabList 或纯声明式 <Tabs.Pane> 自动收集、renderTabBar 自定义标签栏、roving tabindex 键盘导航、可关闭标签与溢出滚动/下拉收纳（overflow）。',
+    props: [
+        { name: 'value', type: 'string|number', default: 'undefined', desc: '受控选中标签 key' },
+        { name: 'defaultValue', type: 'string|number', default: '首个标签', desc: '非受控初始 key' },
+        { name: 'type', type: "'line'|'card'|'button'", default: 'line', desc: '视觉风格（button=分段按钮组）' },
+        { name: 'size', type: "'small'|'default'|'large'", default: 'default' },
+        {
+            name: 'tabPosition',
+            type: "'top'|'bottom'|'left'|'right'",
+            default: 'top',
+            desc: '标签栏位置',
+        },
+        { name: 'lazy', type: 'boolean', default: 'false', desc: '首次激活后才挂载面板' },
+        { name: 'keepDOM', type: 'boolean', default: 'false', desc: '激活过的面板保留 DOM' },
+        {
+            name: 'tabList',
+            type: 'TabItem[]',
+            default: 'undefined',
+            desc: '数据驱动标签定义；不传则从子 <Tabs.Pane> 的 tab/itemKey/disabled/closable 纯声明式自动收集',
+        },
+        { name: 'closable', type: 'boolean', default: 'false', desc: '全局可关闭（单项可覆盖）' },
+        {
+            name: 'addable',
+            type: 'boolean',
+            default: 'false',
+            desc: '标签栏末尾显示「+」按钮，点击触发 onAdd（受控，由父组件追加）',
+        },
+        {
+            name: 'keyboardActivation',
+            type: "'auto'|'manual'",
+            default: 'auto',
+            desc: '方向键聚焦即激活 / 需 Enter/Space 激活',
+        },
+        {
+            name: 'overflow',
+            type: "'scroll'|'dropdown'",
+            default: 'scroll',
+            desc: '横向溢出处理：scroll 前/后滚动箭头；dropdown 收纳进末尾「更多」下拉（仅 top/bottom 生效，纵向始终滚动）',
+        },
+        {
+            name: 'collapsible',
+            type: 'boolean',
+            default: 'false',
+            desc: 'line 风格横向溢出时启用折叠收纳（便捷开关，等价 overflow=dropdown：放不下的标签进末尾「更多」下拉，仅 top/bottom 生效）',
+        },
+        {
+            name: 'more',
+            type: "number | { count?: number; render?: Snippet; dropdownProps?: object }",
+            default: 'undefined',
+            desc: '溢出折叠配置：数字简写或对象形式，仅 dropdown 模式有效',
+        },
+        {
+            name: 'arrowPosition',
+            type: "'start'|'end'|'both'",
+            default: 'both',
+            desc: 'scroll 模式中前/后箭头位置',
+        },
+        {
+            name: 'renderArrow',
+            type: "Snippet<[{ type: 'start'|'end'; onClick: () => void }]>",
+            default: 'undefined',
+            desc: '自定义前/后滚动箭头',
+        },
+        {
+            name: 'showRestInDropdown',
+            type: 'boolean',
+            default: 'true',
+            desc: 'dropdown 折叠模式是否在下拉中展示收起 tabs',
+        },
+        {
+            name: 'dropdownProps',
+            type: 'object',
+            default: 'undefined',
+            desc: '透传给「更多」Dropdown 组件的 props',
+        },
+        {
+            name: 'onVisibleTabsChange',
+            type: '(visibleTabKeys: (string|number)[]) => void',
+            default: 'undefined',
+            desc: 'dropdown 模式下溢出项变化时回调，携带当前可见 tab keys',
+        },
+        {
+            name: 'contentStyle',
+            type: 'string | Record<string, string>',
+            default: 'undefined',
+            desc: '内容区外层样式（string 或 CSSProperties 对象）',
+        },
+        {
+            name: 'preventScroll',
+            type: 'boolean',
+            default: 'false',
+            desc: 'Tab 聚焦时是否阻止页面滚动',
+        },
+        {
+            name: 'tabPaneMotion',
+            type: 'boolean',
+            default: 'true',
+            desc: '面板切换是否启用动画',
+        },
+        {
+            name: 'tabBarExtraContent',
+            type: 'Snippet',
+            default: 'undefined',
+            desc: '标签栏右侧额外内容',
+        },
+        { name: 'onChange', type: '(key: string|number) => void', default: 'undefined' },
+        { name: 'onTabClose', type: '(key: string|number) => void', default: 'undefined' },
+        {
+            name: 'onTabClick',
+            type: '(key: string|number, event: MouseEvent) => void',
+            default: 'undefined',
+            desc: '标签被点击触发（含已选中标签，未必触发 onChange；disabled 拦截前发出，可用于埋点）',
+        },
+        {
+            name: 'onAdd',
+            type: '() => void',
+            default: 'undefined',
+            desc: 'addable=true 时点击「+」按钮回调（受控数据，组件内不改 tabList）',
+        },
+        {
+            name: 'renderTabBar',
+            type: 'Snippet<[TabItem[], string|number|undefined, (key) => void]>',
+            default: 'undefined',
+            desc: '自定义整个标签栏渲染（接收 tab 列表、当前激活 key、切换回调 setActive）；传入时跳过内置标签栏与溢出处理，面板内容仍按 activeKey 显隐',
+        },
+        { name: 'children', type: 'Snippet', default: 'undefined', desc: '声明式 TabPane 内容（<Tabs.Pane>）' },
+    ],
+    a11y: {
+        role: 'tablist',
+        keyboard: ['ArrowLeft', 'ArrowRight', 'ArrowUp', 'ArrowDown', 'Home', 'End', 'Enter', 'Space'],
+        notes: [
+            'tablist 内每个标签为 role=tab，aria-selected 标记激活，aria-controls 关联面板',
+            'roving tabindex：仅激活标签 tabindex=0，其余 -1',
+            'keyboardActivation=auto 聚焦即激活，manual 需 Enter/Space 确认',
+            '面板 role=tabpanel；关闭叉为带 aria-label 的原生 button',
+            '标签溢出时出现前/后滚动箭头（带 aria-label，tabindex=-1 不入 Tab 序），激活标签自动滚到可视区',
+            'overflow=dropdown 时溢出标签收进末尾「更多」下拉（aria-haspopup=menu，带 aria-label），激活标签始终保持可见',
+            'addable 的「+」为带 aria-label 的原生 button',
+            'renderTabBar 自定义标签栏时由调用方负责无障碍语义（role=tab/aria-selected 等）',
+            'preventScroll=true 时 Tab 聚焦不触发页面滚动',
+        ],
+    },
+    tokens: ['--cd-tabs-*', '--cd-focus-ring', '--cd-radius-1', '--cd-spacing-*'],
+};

package/dist/tabs/types.d.ts

@@ -0,0 +1,7 @@
+export interface TabItem {
+    tab: string;
+    itemKey: string | number;
+    disabled?: boolean;
+    closable?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tabs/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB"}

package/dist/tabs/types.js

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

package/dist/tag/Tag.a11y.test.d.ts

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

package/dist/tag/Tag.a11y.test.d.ts.map

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

package/dist/tag/Tag.a11y.test.js

@@ -0,0 +1,30 @@
+// Tag a11y：closable 关闭按钮有可访问名（locale 派生）；checkable 取 role=checkbox + aria-checked。
+// 经 TagA11yFixture 提供真实文本 children（自带 LocaleProvider，故直接 render）。
+import { describe, it, expect } from 'vitest';
+import { render } from '@testing-library/svelte';
+import { expectNoAxeViolations } from '../test-utils/a11y.js';
+import TagA11yFixture from './TagA11yFixture.svelte';
+describe('Tag a11y', () => {
+    it('基础：渲染文本内容，无 axe violations', async () => {
+        const { container } = render(TagA11yFixture, { props: { text: 'Done' } });
+        expect(container.querySelector('.cd-tag')?.textContent).toContain('Done');
+        await expectNoAxeViolations(container);
+    });
+    it('closable：关闭按钮带 aria-label（来自 locale），无 axe violations', async () => {
+        const { container } = render(TagA11yFixture, {
+            props: { text: 'Done', props: { closable: true, tagText: 'Done' } },
+        });
+        const closeBtn = container.querySelector('.cd-tag__close');
+        expect(closeBtn?.getAttribute('aria-label')).toBeTruthy();
+        await expectNoAxeViolations(container);
+    });
+    it('checkable：role=checkbox + aria-checked，无 axe violations', async () => {
+        const { container } = render(TagA11yFixture, {
+            props: { text: 'Filter', props: { checkable: true, checked: true } },
+        });
+        const root = container.querySelector('.cd-tag');
+        expect(root?.getAttribute('role')).toBe('checkbox');
+        expect(root?.getAttribute('aria-checked')).toBe('true');
+        await expectNoAxeViolations(container);
+    });
+});