dsh-plugin-core 0.32.0 → 0.33.0

package/dist/ui/layout/quick-toolbar-css.generated.js

@@ -0,0 +1,4 @@
+// ⚠️ 生成物，勿手改。真源 = src/ui/layout/quick-toolbar.css
+// 由 scripts/gen-css.mjs 生成（`pnpm run gen:css`）：改样式请改那个 .css 文件后重新生成。
+export const QUICK_TOOLBAR_CSS = "/* 快捷工具栏：右侧悬浮的一列独立圆钮。\n   横向 left / right 与 bottom、按钮直径、纵向间距由组件按 props 实时写入 style；\n   这里只放与位置无关的皮肤。 */\n.dshpc-quick-toolbar{\n  position:fixed;\n  z-index:var(--dshpc-z-dock);\n  display:flex;\n  flex-direction:column;\n  align-items:center;\n}\n/* 出现 / 消失：挂载即淡入，退场先播 fade-out（组件延迟卸载，见 QuickToolbar.ts）。 */\n@keyframes dshpc-quick-toolbar-in{\n  from{opacity:0;transform:translateY(6px) scale(.9);}\n  to{opacity:1;transform:none;}\n}\n@keyframes dshpc-quick-toolbar-out{\n  from{opacity:1;transform:none;}\n  to{opacity:0;transform:translateY(6px) scale(.9);}\n}\n.dshpc-quick-toolbar__item{\n  display:inline-flex;\n  align-items:center;\n  justify-content:center;\n  padding:0;\n  margin:0;\n  box-sizing:border-box;\n  border:1px solid var(--dshpc-border);\n  border-radius:50%;\n  /* 自定义底色 / 字色只写这两个变量（见 QuickToolbar.ts），hover/active 才能跟着混色。 */\n  background:var(--dshpc-quick-toolbar-bg, var(--dshpc-solid));\n  color:var(--dshpc-quick-toolbar-fg, var(--dshpc-on-solid));\n  box-shadow:var(--dshpc-shadow-2);\n  cursor:pointer;\n  animation:dshpc-quick-toolbar-in var(--dshpc-dur) var(--dshpc-ease);\n  transition:background-color var(--dshpc-dur-fast) var(--dshpc-ease),\n             color var(--dshpc-dur-fast) var(--dshpc-ease),\n             transform var(--dshpc-dur-fast) var(--dshpc-ease);\n}\n/* 退场期保留占位，避免同列其他按钮瞬时跳位。 */\n.dshpc-quick-toolbar__item.is-leaving{\n  animation:dshpc-quick-toolbar-out var(--dshpc-dur) var(--dshpc-ease) forwards;\n  pointer-events:none;\n}\n/* 变色与核心 Button 实心档同一套：按 --dshpc-fg 混出 hover / active 底色（自定义 color 也跟随）。 */\n.dshpc-quick-toolbar__item:hover{\n  background:color-mix(in srgb, var(--dshpc-quick-toolbar-bg, var(--dshpc-solid)) 82%, var(--dshpc-fg));\n}\n.dshpc-quick-toolbar__item:active{\n  background:color-mix(in srgb, var(--dshpc-quick-toolbar-bg, var(--dshpc-solid)) 70%, var(--dshpc-fg));\n  transform:scale(.94);\n}\n.dshpc-quick-toolbar__item:focus-visible{outline:2px solid var(--dshpc-focus);outline-offset:2px;}\n@media (prefers-reduced-motion: reduce){\n  .dshpc-quick-toolbar__item{transition:none;transform:none;animation:none;}\n  .dshpc-quick-toolbar__item.is-leaving{animation:none;opacity:0;}\n}\n";
+//# sourceMappingURL=quick-toolbar-css.generated.js.map

package/dist/ui/layout/quick-toolbar-css.generated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quick-toolbar-css.generated.js","sourceRoot":"","sources":["../../../src/ui/layout/quick-toolbar-css.generated.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,qEAAqE;AACrE,MAAM,CAAC,MAAM,iBAAiB,GAAG,4nEAA4nE,CAAA"}

package/dist/ui/layout/quick-toolbar-logic.d.ts

@@ -0,0 +1,76 @@
+/**
+ * QuickToolbar 的纯逻辑（零 DOM、零 React 运行时）。
+ *
+ * 只回答三件事：横向贴哪、按钮按什么顺序排、某一项此刻该不该出现。
+ * 真机尺寸 / 滚动 / 锚点解析留在组件里 —— 这里全部可直接进 Node 单测。
+ */
+import type { ReactNode } from 'react';
+/** 某一项的显隐时机：`always` 一直显示，`scroll` 滚过阈值才显示。 */
+export type QuickToolbarWhen = 'always' | 'scroll';
+/** 自定义按钮。 */
+export interface QuickToolbarItem {
+    /** 唯一标识；`onAction` 里原样回传。 */
+    id: string;
+    /** 图标（自绘或调用方自己的图标组件渲染结果）。 */
+    icon: ReactNode;
+    /** 无障碍名，同时作为 title。 */
+    label: string;
+    /** 单项点击回调（与 `onAction` 都会触发）。 */
+    onClick?: () => void;
+    /** `false` = 永久隐藏；默认显示。 */
+    visible?: boolean;
+    /** 默认 `always`。 */
+    when?: QuickToolbarWhen;
+    /** 排序值，越小越靠上；默认按数组下标 + 1（内置回顶部默认 0 在最上）。 */
+    order?: number;
+    /** `when: 'scroll'` 的触发阈值（px），默认 320。 */
+    threshold?: number;
+    /** 覆盖底色（任意 CSS 颜色值）。 */
+    color?: string;
+    /** 覆盖图标 / 文字色（任意 CSS 颜色值）。 */
+    fgColor?: string;
+}
+/** 内置回顶部的配置；传 `false` 关掉。 */
+export interface QuickToolbarBackToTop {
+    /** 排序值，默认 0（最上）。 */
+    order?: number;
+    /** 无障碍名，默认内置字典「回到顶部」。 */
+    label?: string;
+    /** 滚动超过这个距离（px）才出现，默认 320。 */
+    threshold?: number;
+}
+/** 滚过多少像素才触发 `when: 'scroll'`。 */
+export declare const DEFAULT_SCROLL_THRESHOLD = 320;
+/** 排序用条目：组件把内置回顶部与自定义项都摊平成这个形状。 */
+export interface ToolbarEntry {
+    id: string;
+    kind: 'backtop' | 'custom';
+    order: number;
+    /** 自定义项在 `items` 里的下标；内置项固定 0。 */
+    index: number;
+}
+/** 横向贴边所需的三个数。 */
+export interface ToolbarGeometry {
+    /** 视口宽（documentElement.clientWidth）。 */
+    viewportWidth: number;
+    /** 与屏幕 / 锚点右缘的距离。 */
+    offset: number;
+    /** 按钮直径。 */
+    size: number;
+}
+/**
+ * 算出工具栏左缘的 x 坐标。
+ *
+ * - 没有锚点（或锚点取不到）：贴视口右缘，留 `offset`。
+ * - 有锚点：贴锚点右缘外侧，留 `offset`；但右侧还必须再留 `offset`，
+ *   放不下（`锚点右缘 + offset + size + offset > 视口宽`）就退回贴视口右缘。
+ */
+export declare function resolveToolbarLeft(geometry: ToolbarGeometry, anchorRight: number | null): number;
+/**
+ * 排序：先按 `order`，相同 order 时内置回顶部在前、自定义项按数组顺序。
+ * 不修改入参。
+ */
+export declare function sortToolbarEntries<T extends ToolbarEntry>(entries: readonly T[]): T[];
+/** 某一项此刻是否该出现（显隐判定）。 */
+export declare function isToolbarEntryVisible(entry: Pick<QuickToolbarItem, 'visible' | 'when' | 'threshold'>, scrollTop: number): boolean;
+//# sourceMappingURL=quick-toolbar-logic.d.ts.map

package/dist/ui/layout/quick-toolbar-logic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quick-toolbar-logic.d.ts","sourceRoot":"","sources":["../../../src/ui/layout/quick-toolbar-logic.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,+CAA+C;AAC/C,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAElD,aAAa;AACb,MAAM,WAAW,gBAAgB;IAC/B,6BAA6B;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,6BAA6B;IAC7B,IAAI,EAAE,SAAS,CAAA;IACf,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB,2BAA2B;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,mBAAmB;IACnB,IAAI,CAAC,EAAE,gBAAgB,CAAA;IACvB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,6BAA6B;AAC7B,MAAM,WAAW,qBAAqB;IACpC,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,yBAAyB;IACzB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,kCAAkC;AAClC,eAAO,MAAM,wBAAwB,MAAM,CAAA;AAE3C,mCAAmC;AACnC,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,SAAS,GAAG,QAAQ,CAAA;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAA;CACd;AAED,kBAAkB;AAClB,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,aAAa,EAAE,MAAM,CAAA;IACrB,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAA;IACd,YAAY;IACZ,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAMhG;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,YAAY,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC,EAAE,CAMrF;AAED,wBAAwB;AACxB,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,IAAI,CAAC,gBAAgB,EAAE,SAAS,GAAG,MAAM,GAAG,WAAW,CAAC,EAC/D,SAAS,EAAE,MAAM,GAChB,OAAO,CAMT"}

package/dist/ui/layout/quick-toolbar-logic.js

@@ -0,0 +1,40 @@
+/** 滚过多少像素才触发 `when: 'scroll'`。 */
+export const DEFAULT_SCROLL_THRESHOLD = 320;
+/**
+ * 算出工具栏左缘的 x 坐标。
+ *
+ * - 没有锚点（或锚点取不到）：贴视口右缘，留 `offset`。
+ * - 有锚点：贴锚点右缘外侧，留 `offset`；但右侧还必须再留 `offset`，
+ *   放不下（`锚点右缘 + offset + size + offset > 视口宽`）就退回贴视口右缘。
+ */
+export function resolveToolbarLeft(geometry, anchorRight) {
+    const { viewportWidth, offset, size } = geometry;
+    const pinned = Math.max(0, viewportWidth - offset - size);
+    if (anchorRight === null || !Number.isFinite(anchorRight))
+        return pinned;
+    const anchored = anchorRight + offset;
+    return anchored + size + offset <= viewportWidth ? anchored : pinned;
+}
+/**
+ * 排序：先按 `order`，相同 order 时内置回顶部在前、自定义项按数组顺序。
+ * 不修改入参。
+ */
+export function sortToolbarEntries(entries) {
+    return [...entries].sort((a, b) => {
+        if (a.order !== b.order)
+            return a.order - b.order;
+        if (a.kind !== b.kind)
+            return a.kind === 'backtop' ? -1 : 1;
+        return a.index - b.index;
+    });
+}
+/** 某一项此刻是否该出现（显隐判定）。 */
+export function isToolbarEntryVisible(entry, scrollTop) {
+    if (entry.visible === false)
+        return false;
+    if ((entry.when ?? 'always') === 'scroll') {
+        return scrollTop > (entry.threshold ?? DEFAULT_SCROLL_THRESHOLD);
+    }
+    return true;
+}
+//# sourceMappingURL=quick-toolbar-logic.js.map

package/dist/ui/layout/quick-toolbar-logic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quick-toolbar-logic.js","sourceRoot":"","sources":["../../../src/ui/layout/quick-toolbar-logic.ts"],"names":[],"mappings":"AA6CA,kCAAkC;AAClC,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,CAAA;AAqB3C;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAyB,EAAE,WAA0B;IACtF,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,QAAQ,CAAA;IAChD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,CAAC,CAAA;IACzD,IAAI,WAAW,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC;QAAE,OAAO,MAAM,CAAA;IACxE,MAAM,QAAQ,GAAG,WAAW,GAAG,MAAM,CAAA;IACrC,OAAO,QAAQ,GAAG,IAAI,GAAG,MAAM,IAAI,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAA;AACtE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAyB,OAAqB;IAC9E,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAChC,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK;YAAE,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAA;QACjD,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI;YAAE,OAAO,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QAC3D,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAA;IAC1B,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,wBAAwB;AACxB,MAAM,UAAU,qBAAqB,CACnC,KAA+D,EAC/D,SAAiB;IAEjB,IAAI,KAAK,CAAC,OAAO,KAAK,KAAK;QAAE,OAAO,KAAK,CAAA;IACzC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,QAAQ,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1C,OAAO,SAAS,GAAG,CAAC,KAAK,CAAC,SAAS,IAAI,wBAAwB,CAAC,CAAA;IAClE,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/ui/layout/resizer.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 拖拽调宽共享逻辑（U20 #3，2026-10-05）。
+ *
+ * 编辑分栏与预览 dock 两处原本各抄一份 pointer plumbing（preventDefault + body.user-select:none
+ * + 清选区 + 监听生命周期 + 松手恢复）。现上提为本函数；调用方只给「clientX → 宽度（已 clamp）」
+ * 与写入 / 提交回调，方向、clamp、写入目标（CSS 变量 / 元素 style）、iframe 处理等差异各自保留。
+ */
+export interface ResizeOptions {
+    /** pointerdown 事件（含 clientX；可能带 preventDefault）。 */
+    startEvent: {
+        clientX: number;
+        preventDefault?: () => void;
+    };
+    /** clientX → 宽度（调用方已 clamp）。拖左变宽即 `startWidth + (startX - clientX)`。 */
+    compute: (clientX: number) => number;
+    /** 拖动期每帧：把新宽度写到目标（CSS 变量 / 元素 style）。 */
+    onMove: (width: number) => void;
+    /** 松手：提交最终宽度（落 state / 持久化）。 */
+    onCommit: (width: number) => void;
+    /** 拖拽期间挂 `rootClass` 的元素；不传则回落 `#dshpc-root`（多实例场景必须传自己的根，否则会挂到别人的根上）。 */
+    root?: HTMLElement | null;
+    /** 拖拽期间挂到 `root` 的类（如预览 dock 的 `dshpc-resizing` 令 iframe pointer-events:none）；松手移除。 */
+    rootClass?: string;
+    /** rAF 节流（预览 dock 用，避免每帧整页重排）。 */
+    rafThrottle?: boolean;
+}
+/** 开始一次拖拽调宽（监听 window 的 pointermove / pointerup，松手自动清理）。 */
+export declare function startResizeLayoutWidth(opts: ResizeOptions): void;
+//# sourceMappingURL=resizer.d.ts.map

package/dist/ui/layout/resizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resizer.d.ts","sourceRoot":"","sources":["../../../src/ui/layout/resizer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,oDAAoD;IACpD,UAAU,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,IAAI,CAAA;KAAE,CAAA;IAC5D,wEAAwE;IACxE,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAA;IACpC,yCAAyC;IACzC,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAC/B,gCAAgC;IAChC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACjC,0EAA0E;IAC1E,IAAI,CAAC,EAAE,WAAW,GAAG,IAAI,CAAA;IACzB,uFAAuF;IACvF,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,kCAAkC;IAClC,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAED,4DAA4D;AAC5D,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAkChE"}

package/dist/ui/layout/resizer.js

@@ -0,0 +1,42 @@
+/** 开始一次拖拽调宽（监听 window 的 pointermove / pointerup，松手自动清理）。 */
+export function startResizeLayoutWidth(opts) {
+    opts.startEvent.preventDefault?.();
+    const body = document.body;
+    const prevUserSelect = body.style.userSelect;
+    body.style.userSelect = 'none';
+    window.getSelection()?.removeAllRanges();
+    const rootEl = opts.root ?? document.getElementById('dshpc-root');
+    if (opts.rootClass !== undefined)
+        rootEl?.classList.add(opts.rootClass);
+    let frame = 0;
+    let pendingX = 0;
+    const emit = (clientX) => {
+        const w = opts.compute(clientX);
+        opts.onMove(w);
+        return w;
+    };
+    const onMove = (event) => {
+        if (opts.rafThrottle === true) {
+            pendingX = event.clientX;
+            if (frame !== 0)
+                return;
+            frame = requestAnimationFrame(() => { frame = 0; emit(pendingX); });
+        }
+        else {
+            emit(event.clientX);
+        }
+    };
+    const onUp = (event) => {
+        window.removeEventListener('pointermove', onMove);
+        window.removeEventListener('pointerup', onUp);
+        if (frame !== 0)
+            cancelAnimationFrame(frame);
+        body.style.userSelect = prevUserSelect;
+        if (opts.rootClass !== undefined)
+            rootEl?.classList.remove(opts.rootClass);
+        opts.onCommit(opts.compute(event.clientX));
+    };
+    window.addEventListener('pointermove', onMove);
+    window.addEventListener('pointerup', onUp);
+}
+//# sourceMappingURL=resizer.js.map

package/dist/ui/layout/resizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resizer.js","sourceRoot":"","sources":["../../../src/ui/layout/resizer.ts"],"names":[],"mappings":"AAwBA,4DAA4D;AAC5D,MAAM,UAAU,sBAAsB,CAAC,IAAmB;IACxD,IAAI,CAAC,UAAU,CAAC,cAAc,EAAE,EAAE,CAAA;IAClC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAA;IAC1B,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAA;IAC5C,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,MAAM,CAAA;IAC9B,MAAM,CAAC,YAAY,EAAE,EAAE,eAAe,EAAE,CAAA;IACxC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,IAAI,QAAQ,CAAC,cAAc,CAAC,YAAY,CAAC,CAAA;IACjE,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;QAAE,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IACvE,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,IAAI,QAAQ,GAAG,CAAC,CAAA;IAChB,MAAM,IAAI,GAAG,CAAC,OAAe,EAAU,EAAE;QACvC,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QAC/B,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;QACd,OAAO,CAAC,CAAA;IACV,CAAC,CAAA;IACD,MAAM,MAAM,GAAG,CAAC,KAAmB,EAAQ,EAAE;QAC3C,IAAI,IAAI,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;YAC9B,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAA;YACxB,IAAI,KAAK,KAAK,CAAC;gBAAE,OAAM;YACvB,KAAK,GAAG,qBAAqB,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA,CAAC,CAAC,CAAC,CAAA;QACpE,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QACrB,CAAC;IACH,CAAC,CAAA;IACD,MAAM,IAAI,GAAG,CAAC,KAAmB,EAAQ,EAAE;QACzC,MAAM,CAAC,mBAAmB,CAAC,aAAa,EAAE,MAAM,CAAC,CAAA;QACjD,MAAM,CAAC,mBAAmB,CAAC,WAAW,EAAE,IAAI,CAAC,CAAA;QAC7C,IAAI,KAAK,KAAK,CAAC;YAAE,oBAAoB,CAAC,KAAK,CAAC,CAAA;QAC5C,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,cAAc,CAAA;QACtC,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;YAAE,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QAC1E,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAA;IAC5C,CAAC,CAAA;IACD,MAAM,CAAC,gBAAgB,CAAC,aAAa,EAAE,MAAM,CAAC,CAAA;IAC9C,MAAM,CAAC,gBAAgB,CAAC,WAAW,EAAE,IAAI,CAAC,CAAA;AAC5C,CAAC"}

package/dist/ui/layout/split-group-css.generated.d.ts

@@ -0,0 +1,2 @@
+export declare const SPLIT_GROUP_CSS = "\n/* \u2500\u2500 \u62FC\u63A5\u5916\u58F3 SplitGroup \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n   \u804C\u8D23\u53EA\u6709\u4E00\u6761\uFF1A\u628A\u4E24\u4E2A\u63A7\u4EF6\u5728\u5916\u89C2\u4E0A\u710A\u6210\u4E00\u4F53\uFF08\u5916\u6846 / \u5706\u89D2 / \u4E2D\u95F4 1px \u5206\u9694 / \u6574\u4F53\u805A\u7126\u5708\uFF09\u3002\n   \u5B83**\u4E0D\u6301\u72B6\u6001\u3001\u4E0D\u51FA\u8054\u52A8\u56DE\u8C03** \u2014\u2014 \u9009\u4E2D\u4E0E\u8054\u52A8\u5168\u8D70\u5185\u4EF6\u81EA\u5DF1\u7684 value / onChange\n   \uFF08\u7528\u6237 2026-10-28 \u62CD\u677F\uFF1A\u5916\u58F3\u4E0D\u5FC5\u77E5\u9053\u53F3\u8FB9\u90A3\u4E2A\u4E0B\u62C9\u7BA1\u4EC0\u4E48\uFF09\u3002\n\n   \u26A0\uFE0F \u4E0E\u5185\u4EF6\u7C7B\u540D\u6709\u610F\u8026\u5408\uFF1A\u5185\u4EF6\u662F Picker / Segmented \u65F6\u7531\u4E0B\u9762\u51E0\u6761\u89C4\u5219\u628A\u5B83\u4EEC\u81EA\u5DF1\u7684\n   \u8FB9\u6846 / \u5E95\u8272 / \u5706\u89D2\u4EA4\u51FA\u6765\uFF0C\u7531\u5916\u58F3\u7EDF\u4E00\u753B\u3002\u5185\u4EF6\u6539\u540D\u6216\u6539\u7ED3\u6784\u8981\u540C\u6B65\u6539\u8FD9\u91CC\uFF0C\n   \u5426\u5219\u4F1A\u51FA\u73B0\u53CC\u8FB9\u6846\u3001\u53CC\u5E95\u8272\u3002\n\n   \u9AD8\u5EA6\u4E0D\u5199\u6B7B\uFF1A\u5185\u4EF6\u81EA\u5DF1\u6309 size \u6863\uFF08sm 24 / md 28 / lg 32\uFF09\u6491\u5F00\uFF0C\u5916\u58F3\u8DDF\u7740\u957F\u3002\n   \u4E24\u683C\u8981\u7B49\u9AD8\uFF0C\u5C31\u7ED9\u5185\u4EF6\u4F20**\u540C\u4E00\u4E2A size**\u3002\u4E07\u4E00\u4E24\u683C size \u4E0D\u4E00\u81F4\uFF0C\u5916\u58F3\u5185\u4EF6\u7528 align-items:center\n   \u5C45\u4E2D\uFF08\u4E0D\u4F1A\u9876\u5BF9\u9F50\u9732\u767D\uFF0C\u7528\u6237 2026-10-28 \u622A\u56FE\u53CD\u9988\u300C\u672C\u6708\u504F\u4E0A\u300D\u540E\u7684\u5904\u7406\uFF09\uFF1B**\u522B\u7528 height:100%**\uFF0C\n   \u5B83\u4F1A\u8986\u76D6\u4E09\u6863\u9AD8\u5EA6\uFF08\u4E0E --lg/--sm \u540C\u7279\u5F02\u6027\u4E14\u6CE8\u5165\u66F4\u665A\uFF09\u3002\n\n   \u5DE6\u683C\u7EDF\u4E00\u7070\u5E95\uFF08\u7528\u6237 2026-10-28 \u62CD\u677F\uFF09\uFF1A\u6ED1\u5757\u4FDD\u7559\u81EA\u5DF1\u7684\u7070\u8F68\uFF0C\u5DE6\u683C\u4E0B\u62C9\u628A\u5E95\u8272\u6362\u6210\n   surface-sunken\uFF1B\u53F3\u683C\u4FDD\u6301\u539F\u6837\u3002\u5C42\u6B21\u611F = \u5DE6\u683C\u662F\u300C\u6863\u4F4D/\u8303\u56F4\u300D\uFF0C\u53F3\u683C\u662F\u300C\u503C\u300D\u3002 */\n   .dshpc-split{display:inline-flex;align-items:stretch;max-width:100%;overflow:hidden;border:1px solid var(--dshpc-border);border-radius:var(--dshpc-radius-md);background:var(--dshpc-surface-1);}\n   /* \u4E24\u683C\u5BBD\u5EA6\u90FD\u7531\u5185\u5BB9\u7ED9\uFF1B\u5BB9\u5668\u518D\u7A84\u4E5F\u8BA9\u5185\u4EF6\u81EA\u5DF1\u7701\u7565\uFF0C\u4E0D\u8BA9\u5916\u58F3\u88AB\u6491\u7834 */\n   .dshpc-split > *{min-width:0;max-width:100%;}\n   /* \u5206\u9694\uFF1A\u76F8\u90BB\u5144\u5F1F\u7684\u5DE6\u63CF\u8FB9\uFF0C\u4E0D\u989D\u5916\u63D2 DOM\uFF0Chover / focus \u65F6\u4E5F\u4E0D\u4F1A\u65AD */\n   .dshpc-split > * + *{box-sizing:border-box;border-left:1px solid var(--dshpc-border);}\n   /* \u6574\u4F53\u805A\u7126\uFF1A\u53EA\u5728**\u4E0B\u62C9\u5C55\u5F00**\u65F6\u753B\u4E00\u6574\u5708\uFF08\u5224\u636E\u662F\u5185\u4EF6\u7684 aria-expanded\uFF0C\u4E0D\u662F :focus-within\uFF09\u3002\n      2026-11-02 \u7528\u6237\u5B9A\u7A3F\uFF1A\u6ED1\u5757\u90A3\u683C\u662F\u300C\u9009\u4E2D\u300D\u4E0D\u662F\u300C\u8F93\u5165\u805A\u7126\u300D\uFF0C\u9F20\u6807\u70B9\u5B83\u4E0D\u8BE5\u8BA9\u6574\u6846\u5E38\u4EAE\uFF1B\n      \u800C\u4E14\u9009\u53D6\u503C\u540E\u7126\u70B9\u4F1A\u7559\u5728\u6309\u94AE\u4E0A\uFF0C\u7528 :focus-within \u4F1A\u4E00\u76F4\u4EAE\u7740\u3002 */\n   .dshpc-split:has(.dshpc-picker__trigger[aria-expanded='true']){border-color:var(--dshpc-focus);box-shadow:0 0 0 1px var(--dshpc-focus);}\n   /* Picker\uFF1A\u53BB\u6389\u81EA\u8EAB\u5916\u6846\u4E0E\u5E95\u8272\uFF1Bdisplay \u6539\u6210 flex\uFF0C\u6D88\u6389 inline-block \u884C\u76D2\u5E26\u6765\u7684\u57FA\u7EBF\u95F4\u9699\u3002\n      \u6CE8\u610F**\u4E0D\u80FD\u7528 height:100%**\uFF1A\u5B83\u4F1A\u548C .dshpc-picker__trigger--lg / --sm \u540C\u7279\u5F02\u6027\uFF08\u90FD\u662F\u4E24\u4E2A\u7C7B\uFF09\uFF0C\n      \u4E14 split-group.css \u5728 picker.css \u4E4B\u540E\u6CE8\u5165\uFF0C\u4F1A\u628A\u4E09\u6863\u9AD8\u5EA6\u5168\u5403\u6389\uFF08md/lg \u770B\u8D77\u6765\u4E00\u6837\u5927\uFF09\u3002\n      \u6539\u7528 align-items:center \u2014\u2014 \u540C size \u65F6\u4E24\u683C\u81EA\u7136\u7B49\u9AD8\u7684\u540C\u65F6\u6587\u5B57\u5782\u76F4\u5C45\u4E2D\uFF1B\u4E07\u4E00\u4E24\u683C size \u4E0D\u4E00\u81F4\uFF0C\n      \u8F83\u77EE\u7684\u683C\u4E5F\u53EA\u662F\u5C45\u4E2D\u3001\u4E0D\u4F1A\u9876\u5BF9\u9F50\u9732\u767D\u3002 */\n   .dshpc-split .dshpc-picker{display:flex;align-items:center;}\n   .dshpc-split .dshpc-picker__trigger{border:0;border-radius:0;background:transparent;}\n   .dshpc-split .dshpc-picker__trigger:focus-visible{outline:0;}\n   /* \u5DE6\u683C\u4E0B\u62C9\uFF1A\u7070\u5E95\uFF08\u6ED1\u5757\u7684\u7070\u8F68\u662F\u5B83\u81EA\u5DF1\u7684 --dshpc-seg-track\uFF0C\u4E0D\u5728\u8FD9\u91CC\u8986\u76D6\uFF09 */\n   .dshpc-split > :first-child .dshpc-picker__trigger{background:var(--dshpc-surface-sunken);}\n   /* Segmented\uFF1A\u53EA\u53BB\u5916\u5706\u89D2\u4E0E\u63CF\u8FB9\uFF0C\u7070\u8F68\u4FDD\u7559\uFF1Bpadding \u4FDD\u6301 3px \u4E0D\u52A8 \u2014\u2014 \u5B83\u662F\u9AD8\u5EA6\u5951\u7EA6\u7684\u4E00\u90E8\u5206\n    \uFF083 + item + 3 = control-h\uFF09\u3002bordered \u90A3\u6863\u53BB\u6389\u63CF\u8FB9\u3001\u628A\u8BA9\u7ED9\u63CF\u8FB9\u7684 1px \u8FD8\u56DE padding\uFF0C\n    \u5426\u5219\u4F1A\u6BD4\u53F3\u8FB9\u77EE 2px\u3002 */\n   .dshpc-split .dshpc-seg{border-radius:0;border:0;}\n   .dshpc-split .dshpc-seg--bordered{padding:3px;}\n";
+//# sourceMappingURL=split-group-css.generated.d.ts.map

package/dist/ui/layout/split-group-css.generated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"split-group-css.generated.d.ts","sourceRoot":"","sources":["../../../src/ui/layout/split-group-css.generated.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,eAAe,0zLAA8zE,CAAA"}

package/dist/ui/layout/split-group-css.generated.js

@@ -0,0 +1,4 @@
+// ⚠️ 生成物，勿手改。真源 = src/ui/layout/split-group.css
+// 由 scripts/gen-css.mjs 生成（`pnpm run gen:css`）：改样式请改那个 .css 文件后重新生成。
+export const SPLIT_GROUP_CSS = "\n/* ── 拼接外壳 SplitGroup ──────────────────────────────────────────────\n   职责只有一条：把两个控件在外观上焊成一体（外框 / 圆角 / 中间 1px 分隔 / 整体聚焦圈）。\n   它**不持状态、不出联动回调** —— 选中与联动全走内件自己的 value / onChange\n   （用户 2026-10-28 拍板：外壳不必知道右边那个下拉管什么）。\n\n   ⚠️ 与内件类名有意耦合：内件是 Picker / Segmented 时由下面几条规则把它们自己的\n   边框 / 底色 / 圆角交出来，由外壳统一画。内件改名或改结构要同步改这里，\n   否则会出现双边框、双底色。\n\n   高度不写死：内件自己按 size 档（sm 24 / md 28 / lg 32）撑开，外壳跟着长。\n   两格要等高，就给内件传**同一个 size**。万一两格 size 不一致，外壳内件用 align-items:center\n   居中（不会顶对齐露白，用户 2026-10-28 截图反馈「本月偏上」后的处理）；**别用 height:100%**，\n   它会覆盖三档高度（与 --lg/--sm 同特异性且注入更晚）。\n\n   左格统一灰底（用户 2026-10-28 拍板）：滑块保留自己的灰轨，左格下拉把底色换成\n   surface-sunken；右格保持原样。层次感 = 左格是「档位/范围」，右格是「值」。 */\n   .dshpc-split{display:inline-flex;align-items:stretch;max-width:100%;overflow:hidden;border:1px solid var(--dshpc-border);border-radius:var(--dshpc-radius-md);background:var(--dshpc-surface-1);}\n   /* 两格宽度都由内容给；容器再窄也让内件自己省略，不让外壳被撑破 */\n   .dshpc-split > *{min-width:0;max-width:100%;}\n   /* 分隔：相邻兄弟的左描边，不额外插 DOM，hover / focus 时也不会断 */\n   .dshpc-split > * + *{box-sizing:border-box;border-left:1px solid var(--dshpc-border);}\n   /* 整体聚焦：只在**下拉展开**时画一整圈（判据是内件的 aria-expanded，不是 :focus-within）。\n      2026-11-02 用户定稿：滑块那格是「选中」不是「输入聚焦」，鼠标点它不该让整框常亮；\n      而且选取值后焦点会留在按钮上，用 :focus-within 会一直亮着。 */\n   .dshpc-split:has(.dshpc-picker__trigger[aria-expanded='true']){border-color:var(--dshpc-focus);box-shadow:0 0 0 1px var(--dshpc-focus);}\n   /* Picker：去掉自身外框与底色；display 改成 flex，消掉 inline-block 行盒带来的基线间隙。\n      注意**不能用 height:100%**：它会和 .dshpc-picker__trigger--lg / --sm 同特异性（都是两个类），\n      且 split-group.css 在 picker.css 之后注入，会把三档高度全吃掉（md/lg 看起来一样大）。\n      改用 align-items:center —— 同 size 时两格自然等高的同时文字垂直居中；万一两格 size 不一致，\n      较矮的格也只是居中、不会顶对齐露白。 */\n   .dshpc-split .dshpc-picker{display:flex;align-items:center;}\n   .dshpc-split .dshpc-picker__trigger{border:0;border-radius:0;background:transparent;}\n   .dshpc-split .dshpc-picker__trigger:focus-visible{outline:0;}\n   /* 左格下拉：灰底（滑块的灰轨是它自己的 --dshpc-seg-track，不在这里覆盖） */\n   .dshpc-split > :first-child .dshpc-picker__trigger{background:var(--dshpc-surface-sunken);}\n   /* Segmented：只去外圆角与描边，灰轨保留；padding 保持 3px 不动 —— 它是高度契约的一部分\n    （3 + item + 3 = control-h）。bordered 那档去掉描边、把让给描边的 1px 还回 padding，\n    否则会比右边矮 2px。 */\n   .dshpc-split .dshpc-seg{border-radius:0;border:0;}\n   .dshpc-split .dshpc-seg--bordered{padding:3px;}\n";
+//# sourceMappingURL=split-group-css.generated.js.map

package/dist/ui/layout/split-group-css.generated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"split-group-css.generated.js","sourceRoot":"","sources":["../../../src/ui/layout/split-group-css.generated.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,qEAAqE;AACrE,MAAM,CAAC,MAAM,eAAe,GAAG,2zEAA2zE,CAAA"}

package/dist/ui/navigation/Pagination.d.ts

@@ -0,0 +1,59 @@
+import { type CSSProperties, type ReactNode } from 'react';
+import { type Translate } from '../../utils/i18n.js';
+import { type PageTotalRenderer, type PaginationAlign } from './pagination-logic.js';
+/**
+ * 分页控件 props。
+ *
+ * 只收「当前页 / 每页条数 / 总条数」三件事，总页数与省略窗口由控件算 —— 消费方不自己算页数、
+ * 也不自己渲染页码（这是通行分页组件的共同约定，见 docs/help/ui）。
+ */
+export interface PaginationProps {
+    /** 当前页（1 起）；越界会被夹回 `[1, 总页数]`。 */
+    page: number;
+    /** 总条数（不是总页数）。 */
+    total: number;
+    /** 每页条数，默认 10。 */
+    pageSize?: number;
+    /** 切页 / 切每页条数时触发；切换每页条数时页码一并回到第 1 页（与 antd / MUI 同口径）。 */
+    onChange: (page: number, pageSize: number) => void;
+    /** 页码条对齐，默认 right。 */
+    align?: PaginationAlign;
+    /** 当前页两侧各留几页，默认 1。 */
+    siblingCount?: number;
+    /** 首尾各固定几页，默认 1。 */
+    boundaryCount?: number;
+    /** 传了才出现「每页条数」下拉（如 `[10, 20, 50]`）。 */
+    pageSizeOptions?: readonly number[];
+    /** 总数文案：`true` 走内置字典，也可给函数自定义（收到总条数、起始行、结束行）。 */
+    showTotal?: boolean | PageTotalRenderer;
+    /** 只有一页时整条不渲染。 */
+    hideOnSinglePage?: boolean;
+    /** 简洁模式：只留 `‹ 2 / 36 ›`，不铺页码。 */
+    simple?: boolean;
+    /** 整条禁用。 */
+    disabled?: boolean;
+    /** 无障碍名，默认走内置字典「分页」。 */
+    ariaLabel?: string;
+    /** 覆盖内置文案翻译（插件自带 i18n 时用）。 */
+    translate?: Translate;
+    className?: string;
+    style?: CSSProperties;
+}
+/**
+ * Table 内建分页的配置：与 {@link PaginationProps} 同参数，只把 `total` 放宽为可选。
+ *
+ * 语义分叉就在 `total` 上：**不传 = 本地分页**（`rows` 是全量，Table 按当前页切片，
+ * 总条数取 `rows.length`）；**传了 = 服务端分页**（`rows` 已是当前页的数据，Table 不再切片，
+ * 总条数按传入值算页数）。两种用法都不会让调用方自己算页数。
+ */
+export interface TablePaginationConfig extends Omit<PaginationProps, 'total'> {
+    total?: number;
+}
+/**
+ * 分页（`‹ Previous  1 [2] 3 … 36  Next ›`）。
+ *
+ * 受控组件：页码由调用方持有，这里只发 `onChange(page, pageSize)`。
+ * 样式只 import 自己那份 CSS（`PAGINATION_CSS`），引它就只打包这一份。
+ */
+export declare function Pagination(props: PaginationProps): ReactNode;
+//# sourceMappingURL=Pagination.d.ts.map

package/dist/ui/navigation/Pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Pagination.d.ts","sourceRoot":"","sources":["../../../src/ui/navigation/Pagination.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAC9E,OAAO,EAAK,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAOvD,OAAO,EAKL,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACrB,MAAM,uBAAuB,CAAA;AAE9B;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,kBAAkB;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,0DAA0D;IAC1D,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;IAClD,sBAAsB;IACtB,KAAK,CAAC,EAAE,eAAe,CAAA;IACvB,sBAAsB;IACtB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,oBAAoB;IACpB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,uCAAuC;IACvC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,iDAAiD;IACjD,SAAS,CAAC,EAAE,OAAO,GAAG,iBAAiB,CAAA;IACvC,kBAAkB;IAClB,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,iCAAiC;IACjC,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,YAAY;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,wBAAwB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,8BAA8B;IAC9B,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,aAAa,CAAA;CACtB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,qBAAsB,SAAQ,IAAI,CAAC,eAAe,EAAE,OAAO,CAAC;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,SAAS,CA0H5D"}

package/dist/ui/navigation/Pagination.js

@@ -0,0 +1,112 @@
+import { createElement as h } from 'react';
+import { t } from '../../utils/i18n.js';
+import { ensureComponentStyles } from '../infra/css.js';
+import { PAGINATION_CSS } from '../infra/controls-css.js';
+import { Picker } from '../inputs/Picker.js';
+import { Button } from '../actions/Button.js';
+import { Chevron } from '../infra/chevron.js';
+import { useOverlayLocked } from '../infra/overlay.js';
+import { clampPage, pageCountOf, pageItems, pageRange, } from './pagination-logic.js';
+/**
+ * 分页（`‹ Previous  1 [2] 3 … 36  Next ›`）。
+ *
+ * 受控组件：页码由调用方持有，这里只发 `onChange(page, pageSize)`。
+ * 样式只 import 自己那份 CSS（`PAGINATION_CSS`），引它就只打包这一份。
+ */
+export function Pagination(props) {
+    ensureComponentStyles('pagination', PAGINATION_CSS);
+    const tt = props.translate ?? t;
+    const pageSize = Math.max(1, Math.floor(props.pageSize ?? 10));
+    const total = Math.max(0, Math.floor(props.total));
+    const count = pageCountOf(total, pageSize);
+    const page = clampPage(props.page, count);
+    if (props.hideOnSinglePage === true && count <= 1)
+        return null;
+    const locked = useOverlayLocked();
+    const disabled = props.disabled === true || locked;
+    const [from, to] = pageRange(page, pageSize, total);
+    const go = (next) => {
+        if (disabled)
+            return;
+        const target = clampPage(next, count);
+        if (target !== page)
+            props.onChange(target, pageSize);
+    };
+    const navClass = [
+        'dshpc-pagination',
+        `dshpc-pagination--${props.align ?? 'right'}`,
+        props.simple === true ? 'dshpc-pagination--simple' : '',
+        props.className ?? '',
+    ]
+        .filter((s) => s !== '')
+        .join(' ');
+    const totalNode = (() => {
+        const showTotal = props.showTotal;
+        if (showTotal === undefined || showTotal === false)
+            return null;
+        if (typeof showTotal === 'function')
+            return showTotal(total, from, to);
+        return total === 0
+            ? tt('paginationTotalZero')
+            : tt('paginationTotal', { from, to, total });
+    })();
+    // 页码 / 上下页一律用核心 Button（ghost 档；当前页用 info = business 实心蓝），
+    // 箭头用全站唯一的 Chevron —— 不在分页里另写一套按钮外观与字形箭头。
+    const pageButton = (n) => h(Button, {
+        key: n,
+        variant: n === page ? 'info' : 'ghost',
+        size: 'md',
+        className: 'dshpc-pagination__page',
+        'aria-current': n === page ? 'page' : undefined,
+        'aria-label': tt('paginationPage', { n }),
+        disabled,
+        onClick: () => go(n),
+    }, n);
+    const navButton = (direction) => {
+        const isPrev = direction === 'prev';
+        const label = isPrev ? tt('paginationPrev') : tt('paginationNext');
+        return h(Button, {
+            variant: 'ghost',
+            size: 'md',
+            className: 'dshpc-pagination__nav',
+            icon: isPrev ? h(Chevron, { dir: 'left', size: 14 }) : undefined,
+            iconRight: isPrev ? undefined : h(Chevron, { dir: 'right', size: 14 }),
+            'aria-label': label,
+            disabled: disabled || (isPrev ? page <= 1 : page >= count),
+            onClick: () => go(isPrev ? page - 1 : page + 1),
+        }, h('span', { className: 'dshpc-pagination__text' }, label));
+    };
+    const middle = props.simple === true
+        ? [h('span', { key: 'simple', className: 'dshpc-pagination__simple' }, `${String(page)} / ${String(count)}`)]
+        : pageItems(page, count, props.siblingCount, props.boundaryCount).map((item, index) => item === 'gap'
+            ? h('span', { key: `gap-${String(index)}`, className: 'dshpc-pagination__ellipsis', 'aria-hidden': 'true' }, '…')
+            : pageButton(item));
+    // 每页条数下拉不再手搓原生 select（浏览器默认箭头与全站 Chevron 不一致）——直接用核心 Picker。
+    const options = props.pageSizeOptions ?? [];
+    const sizeNode = options.length === 0
+        ? null
+        : h(Picker, {
+            className: 'dshpc-pagination__size',
+            minWidth: 'auto',
+            mode: 'single',
+            options: options.map((size) => ({
+                value: String(size),
+                label: tt('paginationPageSizeOption', { n: size }),
+            })),
+            value: String(pageSize),
+            disabled,
+            ariaLabel: tt('paginationPageSizeAria'),
+            onChange: (value) => {
+                const next = Number(value);
+                if (!Number.isFinite(next) || next < 1)
+                    return;
+                props.onChange(1, next);
+            },
+        });
+    return h('nav', {
+        className: navClass,
+        style: props.style,
+        'aria-label': props.ariaLabel ?? tt('paginationAria'),
+    }, totalNode === null ? null : h('span', { className: 'dshpc-pagination__total' }, totalNode), h('div', { className: 'dshpc-pagination__pages' }, navButton('prev'), ...middle, navButton('next')), sizeNode);
+}
+//# sourceMappingURL=Pagination.js.map

package/dist/ui/navigation/Pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Pagination.js","sourceRoot":"","sources":["../../../src/ui/navigation/Pagination.ts"],"names":[],"mappings":"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"}

package/dist/ui/navigation/pagination-css.generated.d.ts

@@ -0,0 +1,2 @@
+export declare const PAGINATION_CSS = "/* \u2500\u2500 \u5206\u9875\uFF08\u2039 Previous 1 2 3 \u2026 36 Next \u203A\uFF09\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n   \u5F53\u524D\u9875 = \u84DD\u8272\u5706\u89D2\u65B9\u5757 + \u767D\u5B57\uFF08\u5B9E\u5FC3\u9762\u7684\u5B57\u5FC5\u987B\u8D70 --dshpc-on-signal\uFF0C\u4E0D\u8BB8\u7528\u4E3B\u9898\u53CD\u8272\uFF09\uFF1B\n   \u5176\u4F59\u9875\u7801\u662F\u7EAF\u6587\u5B57\u6309\u94AE\uFF0C\u60AC\u6D6E\u53EA\u7ED9\u6781\u6DE1\u4E2D\u6027\u5E95\u3002\u5BF9\u9F50\u7531 --left / --center / --right \u4E09\u4E2A\u4FEE\u9970\u51B3\u5B9A\uFF0C\n   \u7EC4\u4EF6\u9ED8\u8BA4 right\u3002\u989C\u8272\u5168\u90E8\u8D70 token\uFF0C\u660E\u6697\u81EA\u52A8\u8DDF\u968F\u5BBF\u4E3B\u3002 */\n\n.dshpc-pagination{display:flex;align-items:center;gap:var(--dshpc-space-2);flex-wrap:wrap;\n  font-size:var(--dshpc-font-sm);line-height:1;color:var(--dshpc-fg-2);}\n\n.dshpc-pagination--left{justify-content:flex-start;}\n.dshpc-pagination--center{justify-content:center;}\n.dshpc-pagination--right{justify-content:flex-end;}\n\n.dshpc-pagination__total{color:var(--dshpc-fg-3);margin-inline-end:var(--dshpc-space-1);}\n\n.dshpc-pagination__pages{display:flex;align-items:center;gap:2px;}\n\n/* \u9875\u7801 / \u4E0A\u4E0B\u9875 = \u6838\u5FC3 Button\uFF08\u5F53\u524D\u9875 info \u5B9E\u5FC3\u84DD\u3001\u5176\u4F59 ghost\uFF09\uFF0C\u7BAD\u5934 = \u5168\u7AD9\u552F\u4E00 Chevron\u3002\n   \u8FD9\u91CC\u53EA\u8865\u5C3A\u5BF8\u4E0E\u95F4\u8DDD\uFF0C\u4E0D\u91CD\u753B\u6309\u94AE\u76AE\u80A4\uFF1B\u4E24\u7EA7\u9009\u62E9\u5668\u538B\u8FC7 .dshpc-btn--md \u7684\u5185\u8DDD\u3002 */\n.dshpc-pagination .dshpc-pagination__page{padding:0 6px;min-width:28px;}\n.dshpc-pagination .dshpc-pagination__nav{padding:0 var(--dshpc-space-2);}\n\n.dshpc-pagination__ellipsis{display:inline-flex;align-items:center;justify-content:center;\n  min-width:28px;height:28px;color:var(--dshpc-fg-3);}\n\n.dshpc-pagination__simple{min-width:64px;text-align:center;font-variant-numeric:tabular-nums;\n  color:var(--dshpc-fg);}\n\n/* \u7B80\u6D01\u6A21\u5F0F\u53EA\u7559\u7BAD\u5934\uFF1A\u6587\u5B57\u6807\u7B7E\u9690\u85CF\uFF0C\u7BAD\u5934\u4ECD\u7136\u53EF\u89C1\uFF08\u65E0\u969C\u788D\u540D\u8FD8\u5728 aria-label \u4E0A\uFF09\u3002 */\n.dshpc-pagination--simple .dshpc-pagination__text{display:none;}\n\n/* \u6BCF\u9875\u6761\u6570\u4E0B\u62C9 = \u6838\u5FC3 Picker\uFF08\u7BAD\u5934\u662F\u5168\u7AD9\u552F\u4E00\u7684 Chevron\uFF09\uFF1A\u53EA\u6536\u7A84\u4E0D\u53C2\u4E0E\u4F38\u7F29\u3002 */\n.dshpc-pagination__size{flex:none;}\n";
+//# sourceMappingURL=pagination-css.generated.d.ts.map

package/dist/ui/navigation/pagination-css.generated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination-css.generated.d.ts","sourceRoot":"","sources":["../../../src/ui/navigation/pagination-css.generated.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,cAAc,4oFAAu9C,CAAA"}

package/dist/ui/navigation/pagination-css.generated.js

@@ -0,0 +1,4 @@
+// ⚠️ 生成物，勿手改。真源 = src/ui/navigation/pagination.css
+// 由 scripts/gen-css.mjs 生成（`pnpm run gen:css`）：改样式请改那个 .css 文件后重新生成。
+export const PAGINATION_CSS = "/* ── 分页（‹ Previous 1 2 3 … 36 Next ›）────────────────────────────────────\n   当前页 = 蓝色圆角方块 + 白字（实心面的字必须走 --dshpc-on-signal，不许用主题反色）；\n   其余页码是纯文字按钮，悬浮只给极淡中性底。对齐由 --left / --center / --right 三个修饰决定，\n   组件默认 right。颜色全部走 token，明暗自动跟随宿主。 */\n\n.dshpc-pagination{display:flex;align-items:center;gap:var(--dshpc-space-2);flex-wrap:wrap;\n  font-size:var(--dshpc-font-sm);line-height:1;color:var(--dshpc-fg-2);}\n\n.dshpc-pagination--left{justify-content:flex-start;}\n.dshpc-pagination--center{justify-content:center;}\n.dshpc-pagination--right{justify-content:flex-end;}\n\n.dshpc-pagination__total{color:var(--dshpc-fg-3);margin-inline-end:var(--dshpc-space-1);}\n\n.dshpc-pagination__pages{display:flex;align-items:center;gap:2px;}\n\n/* 页码 / 上下页 = 核心 Button（当前页 info 实心蓝、其余 ghost），箭头 = 全站唯一 Chevron。\n   这里只补尺寸与间距，不重画按钮皮肤；两级选择器压过 .dshpc-btn--md 的内距。 */\n.dshpc-pagination .dshpc-pagination__page{padding:0 6px;min-width:28px;}\n.dshpc-pagination .dshpc-pagination__nav{padding:0 var(--dshpc-space-2);}\n\n.dshpc-pagination__ellipsis{display:inline-flex;align-items:center;justify-content:center;\n  min-width:28px;height:28px;color:var(--dshpc-fg-3);}\n\n.dshpc-pagination__simple{min-width:64px;text-align:center;font-variant-numeric:tabular-nums;\n  color:var(--dshpc-fg);}\n\n/* 简洁模式只留箭头：文字标签隐藏，箭头仍然可见（无障碍名还在 aria-label 上）。 */\n.dshpc-pagination--simple .dshpc-pagination__text{display:none;}\n\n/* 每页条数下拉 = 核心 Picker（箭头是全站唯一的 Chevron）：只收窄不参与伸缩。 */\n.dshpc-pagination__size{flex:none;}\n";
+//# sourceMappingURL=pagination-css.generated.js.map

package/dist/ui/navigation/pagination-css.generated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination-css.generated.js","sourceRoot":"","sources":["../../../src/ui/navigation/pagination-css.generated.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,qEAAqE;AACrE,MAAM,CAAC,MAAM,cAAc,GAAG,o9CAAo9C,CAAA"}

package/dist/ui/navigation/pagination-logic.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 分页纯逻辑：总页数、页码夹取、省略号窗口、当前页可见区间。
+ *
+ * 零 React 运行时依赖（只 `import type`，编译后不留痕迹），可被 node 单测直接引。
+ *
+ * 口径照通行的分页约定（Ant Design / MUI / Element Plus 一致）：
+ * 调用方只给「当前页 / 每页条数 / 总条数」，总页数与省略窗口一律由这里算，
+ * **消费方永远不自己算页数、也不自己拼页码**。
+ */
+import type { ReactNode } from 'react';
+/** 页码条对齐：默认 right（放内容右下角）。 */
+export type PaginationAlign = 'left' | 'center' | 'right';
+/** 页码条里的一项：页码，或省略号占位。 */
+export type PageItem = number | 'gap';
+/** 总页数：`ceil(total / pageSize)`，至少 1 页（空数据也显示单页）。 */
+export declare function pageCountOf(total: number, pageSize: number): number;
+/** 把页码夹回 `[1, pageCount]`（越界 / NaN 一律落到第 1 页）。 */
+export declare function clampPage(page: number, pageCount: number): number;
+/**
+ * 当前页在数据里的区间（1 起的闭区间行号）。
+ * 空数据返回 `[0, 0]`（调用方据此显示「共 0 条」而不是「第 0-0 条」）。
+ */
+export declare function pageRange(page: number, pageSize: number, total: number): [number, number];
+/**
+ * 页码条上的项序列（含省略号占位）。
+ *
+ * 窗口算法照 MUI 的实现：首尾各固定 `boundaryCount` 页，当前页两侧各留 `siblingCount` 页，
+ * 中间不足的部分收成 `'gap'`。默认 1 / 1 —— 最多 7 个位置（与 Element Plus `pager-count: 7` 等价）。
+ *
+ * 关键细节（各家一致，别改成「有缝就画省略号」）：间隔**正好 1 页**时直接显示那个页号，
+ * 不画省略号，否则会出现 `1 2 … 4` 这种丑态。
+ */
+export declare function pageItems(page: number, pageCount: number, siblingCount?: number, boundaryCount?: number): PageItem[];
+/** `showTotal` 的两种写法：`true` 走内置字典，函数则拿到 (总条数, 起始行, 结束行)。 */
+export type PageTotalRenderer = (total: number, from: number, to: number) => ReactNode;
+//# sourceMappingURL=pagination-logic.d.ts.map

package/dist/ui/navigation/pagination-logic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination-logic.d.ts","sourceRoot":"","sources":["../../../src/ui/navigation/pagination-logic.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,8BAA8B;AAC9B,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAA;AAEzD,yBAAyB;AACzB,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,KAAK,CAAA;AAErC,qDAAqD;AACrD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAInE;AAED,kDAAkD;AAClD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAIjE;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAOzF;AAQD;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,YAAY,SAAI,EAChB,aAAa,SAAI,GAChB,QAAQ,EAAE,CA6BZ;AAED,4DAA4D;AAC5D,MAAM,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,SAAS,CAAA"}

package/dist/ui/navigation/pagination-logic.js

@@ -0,0 +1,73 @@
+/**
+ * 分页纯逻辑：总页数、页码夹取、省略号窗口、当前页可见区间。
+ *
+ * 零 React 运行时依赖（只 `import type`，编译后不留痕迹），可被 node 单测直接引。
+ *
+ * 口径照通行的分页约定（Ant Design / MUI / Element Plus 一致）：
+ * 调用方只给「当前页 / 每页条数 / 总条数」，总页数与省略窗口一律由这里算，
+ * **消费方永远不自己算页数、也不自己拼页码**。
+ */
+/** 总页数：`ceil(total / pageSize)`，至少 1 页（空数据也显示单页）。 */
+export function pageCountOf(total, pageSize) {
+    const size = Math.max(1, Math.floor(pageSize));
+    const rows = Math.max(0, Math.floor(total));
+    return Math.max(1, Math.ceil(rows / size));
+}
+/** 把页码夹回 `[1, pageCount]`（越界 / NaN 一律落到第 1 页）。 */
+export function clampPage(page, pageCount) {
+    const count = Math.max(1, Math.floor(pageCount));
+    if (!Number.isFinite(page))
+        return 1;
+    return Math.min(Math.max(1, Math.floor(page)), count);
+}
+/**
+ * 当前页在数据里的区间（1 起的闭区间行号）。
+ * 空数据返回 `[0, 0]`（调用方据此显示「共 0 条」而不是「第 0-0 条」）。
+ */
+export function pageRange(page, pageSize, total) {
+    const rows = Math.max(0, Math.floor(total));
+    if (rows === 0)
+        return [0, 0];
+    const size = Math.max(1, Math.floor(pageSize));
+    const current = clampPage(page, pageCountOf(rows, size));
+    const from = (current - 1) * size + 1;
+    return [from, Math.min(rows, from + size - 1)];
+}
+function range(start, end) {
+    const out = [];
+    for (let n = start; n <= end; n += 1)
+        out.push(n);
+    return out;
+}
+/**
+ * 页码条上的项序列（含省略号占位）。
+ *
+ * 窗口算法照 MUI 的实现：首尾各固定 `boundaryCount` 页，当前页两侧各留 `siblingCount` 页，
+ * 中间不足的部分收成 `'gap'`。默认 1 / 1 —— 最多 7 个位置（与 Element Plus `pager-count: 7` 等价）。
+ *
+ * 关键细节（各家一致，别改成「有缝就画省略号」）：间隔**正好 1 页**时直接显示那个页号，
+ * 不画省略号，否则会出现 `1 2 … 4` 这种丑态。
+ */
+export function pageItems(page, pageCount, siblingCount = 1, boundaryCount = 1) {
+    const count = Math.max(1, Math.floor(pageCount));
+    const current = clampPage(page, count);
+    const boundary = Math.max(0, Math.floor(boundaryCount));
+    const siblings = Math.max(0, Math.floor(siblingCount));
+    const startPages = range(1, Math.min(boundary, count));
+    const endPages = range(Math.max(count - boundary + 1, boundary + 1), count);
+    const siblingsStart = Math.max(Math.min(current - siblings, count - boundary - siblings * 2 - 1), boundary + 2);
+    const siblingsEnd = Math.min(Math.max(current + siblings, boundary + siblings * 2 + 2), endPages.length > 0 ? endPages[0] - 2 : count - 1);
+    const items = [...startPages];
+    if (siblingsStart > boundary + 2)
+        items.push('gap');
+    else if (boundary + 1 < count - boundary)
+        items.push(boundary + 1);
+    items.push(...range(siblingsStart, siblingsEnd));
+    if (siblingsEnd < count - boundary - 1)
+        items.push('gap');
+    else if (count - boundary > boundary)
+        items.push(count - boundary);
+    items.push(...endPages);
+    return items;
+}
+//# sourceMappingURL=pagination-logic.js.map

package/dist/ui/navigation/pagination-logic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination-logic.js","sourceRoot":"","sources":["../../../src/ui/navigation/pagination-logic.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAUH,qDAAqD;AACrD,MAAM,UAAU,WAAW,CAAC,KAAa,EAAE,QAAgB;IACzD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAA;IAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAA;IAC3C,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAA;AAC5C,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,SAAiB;IACvD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAA;IAChD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,CAAC,CAAA;IACpC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,CAAC,CAAA;AACvD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,QAAgB,EAAE,KAAa;IACrE,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAA;IAC3C,IAAI,IAAI,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAA;IAC9C,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,EAAE,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAA;IACxD,MAAM,IAAI,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAA;IACrC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAA;AAChD,CAAC;AAED,SAAS,KAAK,CAAC,KAAa,EAAE,GAAW;IACvC,MAAM,GAAG,GAAa,EAAE,CAAA;IACxB,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,IAAI,CAAC;QAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,SAAS,CACvB,IAAY,EACZ,SAAiB,EACjB,YAAY,GAAG,CAAC,EAChB,aAAa,GAAG,CAAC;IAEjB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAA;IAChD,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;IACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAA;IACvD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAA;IAEtD,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAA;IACtD,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,QAAQ,GAAG,CAAC,EAAE,QAAQ,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAA;IAE3E,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAC5B,IAAI,CAAC,GAAG,CAAC,OAAO,GAAG,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,CAAC,GAAG,CAAC,CAAC,EACjE,QAAQ,GAAG,CAAC,CACb,CAAA;IACD,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAC1B,IAAI,CAAC,GAAG,CAAC,OAAO,GAAG,QAAQ,EAAE,QAAQ,GAAG,QAAQ,GAAG,CAAC,GAAG,CAAC,CAAC,EACzD,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CACnD,CAAA;IAED,MAAM,KAAK,GAAe,CAAC,GAAG,UAAU,CAAC,CAAA;IACzC,IAAI,aAAa,GAAG,QAAQ,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;SAC9C,IAAI,QAAQ,GAAG,CAAC,GAAG,KAAK,GAAG,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAA;IAElE,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC,CAAA;IAEhD,IAAI,WAAW,GAAG,KAAK,GAAG,QAAQ,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;SACpD,IAAI,KAAK,GAAG,QAAQ,GAAG,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC,CAAA;IAElE,KAAK,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAA;IACvB,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/ui/official.js

@@ -47,9 +47,9 @@ export function pickOfficial(name, fallback) {
 // 故这里实现后通过 registerHostDialog 注入，confirmModal/alertModal 传 skin:"host" 即调用，保持 ui 入口零官方依赖。
 import { createElement as h } from 'react';
 import { createRoot } from 'react-dom/client';
-import { Button } from './Button.js';
+import { Button } from './actions/Button.js';
 import { t } from '../utils/i18n.js';
-import { registerHostDialog } from './modal-host.js';
+import { registerHostDialog } from './feedback/modal-host.js';
 function mountHostModal(render) {
     if (typeof document === 'undefined')
         return;