@chenzy-design/svelte 0.1.0

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

package/dist/overflow-list/OverflowListKbdFixture.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OverflowListKbdFixture.svelte.d.ts","sourceRoot":"","sources":["../../src/overflow-list/OverflowListKbdFixture.svelte.ts"],"names":[],"mappings":"AAyBA,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,sBAAsB;;kBAA+E,CAAC;AAC1F,KAAK,sBAAsB,GAAG,YAAY,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAC5E,eAAe,sBAAsB,CAAC"}

package/dist/overflow-list/index.d.ts

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

package/dist/overflow-list/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/overflow-list/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,IAAI,IAAI,gBAAgB,EAAE,MAAM,WAAW,CAAC"}

package/dist/overflow-list/index.js

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

package/dist/overflow-list/meta.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Machine-readable component metadata for AI/docs consumption.
+ * OverflowList — see specs/components/show/OverflowList.spec.md
+ */
+export declare const meta: {
+    readonly name: "OverflowList";
+    readonly category: "show";
+    readonly description: "溢出列表：collapse 折叠模式把溢出项收纳进 +N 折叠节点（collapseFrom 决定从尾 end / 头 start 折叠），或 scroll 滚动模式不折叠改为可滚动容器；direction 支持 horizontal 横向 / vertical 纵向。ResizeObserver 命令式测量 + requestAnimationFrame 合批 + hysteresis 滞后防抖动，复用 @chenzy-design/core 收纳算法（computeOverflowPartition）。命令式方法（bind:this 暴露）：forceMeasure() 强制立即重测重算（容器尺寸变化未被 RO 捕获时手动触发）；scrollTo(index, opts?) scroll 模式滚动到指定项（opts.align start/center/end）。";
+    readonly exports: readonly ["OverflowList"];
+    readonly props: readonly [{
+        readonly name: "items";
+        readonly type: "T[]";
+        readonly default: "[]";
+        readonly desc: "数据驱动的列表项";
+    }, {
+        readonly name: "size";
+        readonly type: "'small'|'default'|'large'";
+        readonly default: "'default'";
+        readonly desc: "影响 gap（small 4 / default 8 / large 12 px）";
+    }, {
+        readonly name: "mode";
+        readonly type: "'collapse'|'scroll'";
+        readonly default: "'collapse'";
+        readonly desc: "collapse 折叠溢出项为 +N（默认）；scroll 不折叠，可见层沿主轴可滚动";
+    }, {
+        readonly name: "direction";
+        readonly type: "'horizontal'|'vertical'";
+        readonly default: "'horizontal'";
+        readonly desc: "主轴方向：横向（测项宽 + clientWidth）/ 纵向（测项高 + clientHeight，根容器需有高度约束）";
+    }, {
+        readonly name: "collapseFrom";
+        readonly type: "'end'|'start'";
+        readonly default: "'end'";
+        readonly desc: "collapse 模式下从尾部（end）还是头部（start）折叠；start 时折叠节点渲染在头部，尾部项保持可见";
+    }, {
+        readonly name: "gap";
+        readonly type: "number";
+        readonly default: "undefined";
+        readonly desc: "显式覆盖项间距（px）";
+    }, {
+        readonly name: "minVisibleItems";
+        readonly type: "number";
+        readonly default: "0";
+        readonly desc: "永不折叠到少于该数量的可见项";
+    }, {
+        readonly name: "alwaysVisibleIndexes";
+        readonly type: "number[]";
+        readonly default: "[]";
+        readonly desc: "永不被折叠的项索引";
+    }, {
+        readonly name: "threshold";
+        readonly type: "number";
+        readonly default: "8";
+        readonly desc: "hysteresis 滞后阈值（px），抑制边界宽度抖动";
+    }, {
+        readonly name: "item";
+        readonly type: "Snippet<[{ item: T; index: number }]>";
+        readonly default: "undefined";
+        readonly desc: "渲染单个可见项";
+    }, {
+        readonly name: "overflow";
+        readonly type: "Snippet<[{ overflowItems: T[]; overflowCount: number }]>";
+        readonly default: "undefined";
+        readonly desc: "自定义折叠节点；缺省渲染 +N 按钮";
+    }, {
+        readonly name: "onOverflowChange";
+        readonly type: "(info: { overflowCount: number; visibleCount: number; overflowItems: T[] }) => void";
+        readonly default: "undefined";
+        readonly desc: "收纳结果变化时通知（去重，仅真实变化触发）";
+    }, {
+        readonly name: "ariaLabel";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "容器无障碍标签";
+    }, {
+        readonly name: "class";
+        readonly type: "string";
+        readonly default: "''";
+        readonly desc: "附加根类名";
+    }];
+    readonly events: readonly [{
+        readonly name: "onOverflowChange";
+        readonly desc: "可见数 / 溢出数变化时回调，携带 overflowItems";
+    }];
+    readonly methods: readonly [{
+        readonly name: "forceMeasure";
+        readonly type: "() => void";
+        readonly desc: "命令式强制立即重新测量 + 重算可见/溢出划分（bind:this 后调用）。用于容器尺寸变化未被 ResizeObserver 捕获的场景：父级 display 切回、字体加载、缩放等。同步执行，去重 onOverflowChange 同样生效。";
+    }, {
+        readonly name: "scrollTo";
+        readonly type: "(index: number, opts?: { align?: 'start' | 'center' | 'end' }) => void";
+        readonly desc: "scroll 模式下命令式滚动到指定项（bind:this 后调用）。align 默认 start；vertical 写 scrollTop，horizontal 写 scrollLeft；index 自动 clamp。collapse 模式为 no-op。";
+    }];
+    readonly slots: readonly [{
+        readonly name: "item";
+        readonly desc: "单个可见项渲染模板";
+    }, {
+        readonly name: "overflow";
+        readonly desc: "自定义 +N 折叠节点";
+    }];
+    readonly a11y: {
+        readonly hasRole: false;
+        readonly focusable: false;
+        readonly note: "根容器 role=group 透明保留子项语义；折叠节点为 button + aria-label「显示其余 N 项」；离屏测量层 aria-hidden 且不进 Tab 序（tabindex=-1）；被折叠项随之移出 Tab 序。";
+    };
+    readonly tokens: readonly ["--cd-overflow-list-gap", "--cd-overflow-list-gap-small", "--cd-overflow-list-gap-large", "--cd-overflow-list-overflow-color", "--cd-overflow-list-overflow-color-hover", "--cd-overflow-list-overflow-bg", "--cd-overflow-list-overflow-bg-hover", "--cd-overflow-list-overflow-radius", "--cd-overflow-list-focus-ring"];
+    readonly responsive: true;
+    readonly examples: readonly [{
+        readonly title: "基础工具栏收纳";
+        readonly code: "<OverflowList items={tags}>{#snippet item({ item })}<Tag>{item}</Tag>{/snippet}</OverflowList>";
+    }, {
+        readonly title: "自定义折叠节点";
+        readonly code: "<OverflowList {items}>\n  {#snippet item({ item })}<Tag>{item}</Tag>{/snippet}\n  {#snippet overflow({ overflowCount })}<Dropdown>更多 {overflowCount}</Dropdown>{/snippet}\n</OverflowList>";
+    }, {
+        readonly title: "start 头部折叠（保留尾部最新项）";
+        readonly code: "<OverflowList {items} collapseFrom=\"start\">{#snippet item({ item })}<Tag>{item}</Tag>{/snippet}</OverflowList>";
+    }, {
+        readonly title: "scroll 滚动模式（不折叠）";
+        readonly code: "<OverflowList {items} mode=\"scroll\">{#snippet item({ item })}<Tag>{item}</Tag>{/snippet}</OverflowList>";
+    }, {
+        readonly title: "vertical 纵向（容器需有高度）";
+        readonly code: "<div style=\"height:200px\"><OverflowList {items} direction=\"vertical\">{#snippet item({ item })}<Tag>{item}</Tag>{/snippet}</OverflowList></div>";
+    }];
+};
+//# sourceMappingURL=meta.d.ts.map

package/dist/overflow-list/meta.d.ts.map

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

package/dist/overflow-list/meta.js

@@ -0,0 +1,137 @@
+/**
+ * Machine-readable component metadata for AI/docs consumption.
+ * OverflowList — see specs/components/show/OverflowList.spec.md
+ */
+export const meta = {
+    name: 'OverflowList',
+    category: 'show',
+    description: '溢出列表：collapse 折叠模式把溢出项收纳进 +N 折叠节点（collapseFrom 决定从尾 end / 头 start 折叠），或 scroll 滚动模式不折叠改为可滚动容器；direction 支持 horizontal 横向 / vertical 纵向。ResizeObserver 命令式测量 + requestAnimationFrame 合批 + hysteresis 滞后防抖动，复用 @chenzy-design/core 收纳算法（computeOverflowPartition）。命令式方法（bind:this 暴露）：forceMeasure() 强制立即重测重算（容器尺寸变化未被 RO 捕获时手动触发）；scrollTo(index, opts?) scroll 模式滚动到指定项（opts.align start/center/end）。',
+    exports: ['OverflowList'],
+    props: [
+        { name: 'items', type: 'T[]', default: '[]', desc: '数据驱动的列表项' },
+        {
+            name: 'size',
+            type: "'small'|'default'|'large'",
+            default: "'default'",
+            desc: '影响 gap（small 4 / default 8 / large 12 px）',
+        },
+        {
+            name: 'mode',
+            type: "'collapse'|'scroll'",
+            default: "'collapse'",
+            desc: 'collapse 折叠溢出项为 +N（默认）；scroll 不折叠，可见层沿主轴可滚动',
+        },
+        {
+            name: 'direction',
+            type: "'horizontal'|'vertical'",
+            default: "'horizontal'",
+            desc: '主轴方向：横向（测项宽 + clientWidth）/ 纵向（测项高 + clientHeight，根容器需有高度约束）',
+        },
+        {
+            name: 'collapseFrom',
+            type: "'end'|'start'",
+            default: "'end'",
+            desc: 'collapse 模式下从尾部（end）还是头部（start）折叠；start 时折叠节点渲染在头部，尾部项保持可见',
+        },
+        { name: 'gap', type: 'number', default: 'undefined', desc: '显式覆盖项间距（px）' },
+        {
+            name: 'minVisibleItems',
+            type: 'number',
+            default: '0',
+            desc: '永不折叠到少于该数量的可见项',
+        },
+        {
+            name: 'alwaysVisibleIndexes',
+            type: 'number[]',
+            default: '[]',
+            desc: '永不被折叠的项索引',
+        },
+        {
+            name: 'threshold',
+            type: 'number',
+            default: '8',
+            desc: 'hysteresis 滞后阈值（px），抑制边界宽度抖动',
+        },
+        {
+            name: 'item',
+            type: 'Snippet<[{ item: T; index: number }]>',
+            default: 'undefined',
+            desc: '渲染单个可见项',
+        },
+        {
+            name: 'overflow',
+            type: 'Snippet<[{ overflowItems: T[]; overflowCount: number }]>',
+            default: 'undefined',
+            desc: '自定义折叠节点；缺省渲染 +N 按钮',
+        },
+        {
+            name: 'onOverflowChange',
+            type: '(info: { overflowCount: number; visibleCount: number; overflowItems: T[] }) => void',
+            default: 'undefined',
+            desc: '收纳结果变化时通知（去重，仅真实变化触发）',
+        },
+        { name: 'ariaLabel', type: 'string', default: 'undefined', desc: '容器无障碍标签' },
+        { name: 'class', type: 'string', default: "''", desc: '附加根类名' },
+    ],
+    events: [
+        {
+            name: 'onOverflowChange',
+            desc: '可见数 / 溢出数变化时回调，携带 overflowItems',
+        },
+    ],
+    methods: [
+        {
+            name: 'forceMeasure',
+            type: '() => void',
+            desc: '命令式强制立即重新测量 + 重算可见/溢出划分（bind:this 后调用）。用于容器尺寸变化未被 ResizeObserver 捕获的场景：父级 display 切回、字体加载、缩放等。同步执行，去重 onOverflowChange 同样生效。',
+        },
+        {
+            name: 'scrollTo',
+            type: "(index: number, opts?: { align?: 'start' | 'center' | 'end' }) => void",
+            desc: 'scroll 模式下命令式滚动到指定项（bind:this 后调用）。align 默认 start；vertical 写 scrollTop，horizontal 写 scrollLeft；index 自动 clamp。collapse 模式为 no-op。',
+        },
+    ],
+    slots: [
+        { name: 'item', desc: '单个可见项渲染模板' },
+        { name: 'overflow', desc: '自定义 +N 折叠节点' },
+    ],
+    a11y: {
+        hasRole: false,
+        focusable: false,
+        note: '根容器 role=group 透明保留子项语义；折叠节点为 button + aria-label「显示其余 N 项」；离屏测量层 aria-hidden 且不进 Tab 序（tabindex=-1）；被折叠项随之移出 Tab 序。',
+    },
+    tokens: [
+        '--cd-overflow-list-gap',
+        '--cd-overflow-list-gap-small',
+        '--cd-overflow-list-gap-large',
+        '--cd-overflow-list-overflow-color',
+        '--cd-overflow-list-overflow-color-hover',
+        '--cd-overflow-list-overflow-bg',
+        '--cd-overflow-list-overflow-bg-hover',
+        '--cd-overflow-list-overflow-radius',
+        '--cd-overflow-list-focus-ring',
+    ],
+    responsive: true,
+    examples: [
+        {
+            title: '基础工具栏收纳',
+            code: '<OverflowList items={tags}>{#snippet item({ item })}<Tag>{item}</Tag>{/snippet}</OverflowList>',
+        },
+        {
+            title: '自定义折叠节点',
+            code: '<OverflowList {items}>\n  {#snippet item({ item })}<Tag>{item}</Tag>{/snippet}\n  {#snippet overflow({ overflowCount })}<Dropdown>更多 {overflowCount}</Dropdown>{/snippet}\n</OverflowList>',
+        },
+        {
+            title: 'start 头部折叠（保留尾部最新项）',
+            code: '<OverflowList {items} collapseFrom="start">{#snippet item({ item })}<Tag>{item}</Tag>{/snippet}</OverflowList>',
+        },
+        {
+            title: 'scroll 滚动模式（不折叠）',
+            code: '<OverflowList {items} mode="scroll">{#snippet item({ item })}<Tag>{item}</Tag>{/snippet}</OverflowList>',
+        },
+        {
+            title: 'vertical 纵向（容器需有高度）',
+            code: '<div style="height:200px"><OverflowList {items} direction="vertical">{#snippet item({ item })}<Tag>{item}</Tag>{/snippet}</OverflowList></div>',
+        },
+    ],
+};

package/dist/pagination/Pagination.a11y.test.d.ts

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

package/dist/pagination/Pagination.a11y.test.d.ts.map

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

package/dist/pagination/Pagination.a11y.test.js

@@ -0,0 +1,57 @@
+// Pagination a11y：分页器。
+// nav[aria-label] 包裹，页码为原生 button，当前页 aria-current=page。
+//
+// 修复记录：
+//   1. showSizeChanger 内置 Select 现经 ariaLabel=Pagination.itemsPerPage 获可访问名。
+//   2. showQuickJumper 跳页 Input 现经 ariaLabel=Pagination.jumpTo 获可访问名。
+//   两处 axe aria-input-field-name / label 均消除。
+import { describe, it, expect } from 'vitest';
+import { renderWithLocale, expectNoAxeViolations } from '../test-utils/a11y.js';
+import Pagination from './Pagination.svelte';
+describe('Pagination a11y', () => {
+    it('默认渲染：nav landmark + 可访问名，无 axe violations', async () => {
+        const { container } = renderWithLocale(Pagination, {
+            props: { total: 100, defaultPageSize: 10 },
+        });
+        const nav = container.querySelector('nav');
+        expect(nav).not.toBeNull();
+        // ariaLabel 缺省时来自 locale，应非空
+        expect(nav?.getAttribute('aria-label')).toBeTruthy();
+        await expectNoAxeViolations(container);
+    });
+    it('当前页 aria-current=page，无 axe violations', async () => {
+        const { container } = renderWithLocale(Pagination, {
+            props: { total: 100, defaultPageSize: 10, defaultCurrentPage: 3 },
+        });
+        const current = container.querySelector('[aria-current="page"]');
+        expect(current).not.toBeNull();
+        expect(current?.textContent?.trim()).toContain('3');
+        await expectNoAxeViolations(container);
+    });
+    it('自定义 ariaLabel + showTotal，无 axe violations', async () => {
+        const { container } = renderWithLocale(Pagination, {
+            props: {
+                total: 200,
+                defaultPageSize: 20,
+                ariaLabel: 'Results pagination',
+                showTotal: true,
+            },
+        });
+        expect(container.querySelector('nav')?.getAttribute('aria-label')).toBe('Results pagination');
+        await expectNoAxeViolations(container);
+    });
+    // 内置 Select 经 ariaLabel=Pagination.itemsPerPage 获可访问名。
+    it('showSizeChanger axe 0 violations（内置 Select 有 aria-label）', async () => {
+        const { container } = renderWithLocale(Pagination, {
+            props: { total: 200, defaultPageSize: 20, showSizeChanger: true },
+        });
+        await expectNoAxeViolations(container);
+    });
+    // 跳页 input 经 ariaLabel=Pagination.jumpTo 获可访问名。
+    it('showQuickJumper axe 0 violations（跳页 input 有 aria-label）', async () => {
+        const { container } = renderWithLocale(Pagination, {
+            props: { total: 200, defaultPageSize: 20, showQuickJumper: true },
+        });
+        await expectNoAxeViolations(container);
+    });
+});

package/dist/pagination/Pagination.kbd.test.d.ts

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

package/dist/pagination/Pagination.kbd.test.d.ts.map

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

package/dist/pagination/Pagination.kbd.test.js

@@ -0,0 +1,54 @@
+// Pagination 键盘 e2e（browser project / 真实 chromium）。
+// 页码按钮组 roving（真实焦点）：方向键移动焦点但不切页（切页交给 Enter/Space → click）。
+// 测真实焦点移动——jsdom 测不了（命令式 focus() 不可靠）：
+//   1. roving 单停靠点：页码组只有当前页 tabindex=0（默认 current=1），其余 -1。
+//   2. ←→/↑↓ 真实移动焦点到相邻页码，但 current/aria-current 不变（仅移动焦点）。
+//   3. 无 wrap：末页再 → clamp 在末页；首页再 ← clamp 在首页。
+//
+// 真实焦点断言用 page locator 的 .toHaveFocus()。
+import { describe, it, expect } from 'vitest';
+import { page } from 'vitest/browser';
+import { renderKbdFixture, userEvent } from '../test-utils/kbd.js';
+import PaginationKbdFixture from './PaginationKbdFixture.svelte';
+function loc(el) {
+    return page.elementLocator(el);
+}
+describe('Pagination 键盘 e2e（页码 roving，真实焦点，移动≠切页）', () => {
+    it('roving 单停靠点 + 方向键移动焦点不切页（clamp）', async () => {
+        const { baseElement } = renderKbdFixture(PaginationKbdFixture);
+        const pages = Array.from(baseElement.querySelectorAll('.cd-pagination__page[data-page]'));
+        expect(pages.length).toBe(3);
+        const [p1, p2, p3] = pages;
+        // 1. roving 单停靠点：当前页（1）tabindex=0，其余 -1。
+        expect(pages.filter((el) => el.tabIndex === 0).length).toBe(1);
+        expect(p1.tabIndex).toBe(0);
+        expect(p1.getAttribute('aria-current')).toBe('page');
+        p1.focus();
+        await expect.element(loc(p1)).toHaveFocus();
+        // 2. → 移动焦点到下一页码，但不切页（aria-current 仍在第 1 页）。
+        await userEvent.keyboard('{ArrowRight}');
+        await expect.element(loc(p2)).toHaveFocus();
+        expect(p2.tabIndex).toBe(0);
+        expect(p1.tabIndex).toBe(-1);
+        // 移动焦点 ≠ 切页：current 仍为 1。
+        expect(p1.getAttribute('aria-current')).toBe('page');
+        expect(p2.getAttribute('aria-current')).toBe(null);
+        await userEvent.keyboard('{ArrowRight}');
+        await expect.element(loc(p3)).toHaveFocus();
+        // 无 wrap：末页再 → 停在末页（clamp）。
+        await userEvent.keyboard('{ArrowRight}');
+        await expect.element(loc(p3)).toHaveFocus();
+        // ← 回退；首页再 ← 停在首页（clamp）。
+        await userEvent.keyboard('{ArrowLeft}');
+        await expect.element(loc(p2)).toHaveFocus();
+        await userEvent.keyboard('{ArrowLeft}');
+        await expect.element(loc(p1)).toHaveFocus();
+        await userEvent.keyboard('{ArrowLeft}');
+        await expect.element(loc(p1)).toHaveFocus();
+        // Home/End 跳首/末页码。
+        await userEvent.keyboard('{End}');
+        await expect.element(loc(p3)).toHaveFocus();
+        await userEvent.keyboard('{Home}');
+        await expect.element(loc(p1)).toHaveFocus();
+    });
+});