dsh-plugin-core 0.32.0 → 0.33.0

package/dist/ui/actions/button-css.generated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"button-css.generated.js","sourceRoot":"","sources":["../../../src/ui/actions/button-css.generated.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,qEAAqE;AACrE,MAAM,CAAC,MAAM,UAAU,GAAG,gkTAAgkT,CAAA"}

package/dist/ui/display/Card.d.ts

@@ -0,0 +1,65 @@
+import { createElement as h, type CSSProperties, type ReactNode } from 'react';
+import { type Translate } from '../../utils/i18n.js';
+/** 色条档位（映射到 design 的 token，不新增 token；也接受任意 CSS 颜色值）。 */
+export declare const CARD_ACCENTS: readonly ["business", "success", "warning", "danger", "neutral", "purple", "pink", "cyan", "teal", "orange", "indigo", "rose", "slate"];
+export type CardAccent = (typeof CARD_ACCENTS)[number];
+/** 色条方位与几何；不给就用默认（左侧、6px 宽、距边 12、距内容 12）。 */
+export interface CardBarOptions {
+    /** 贴哪条边（默认 `left`）；`StripCard` 固定贴左，忽略此项。 */
+    side?: 'left' | 'right' | 'top' | 'bottom';
+    /** 条子粗细（默认 6px）。 */
+    size?: number | string;
+    /** 条子距卡片边缘的距离（默认 12px）。 */
+    inset?: number | string;
+    /** 条子距内容的距离（默认 12px）。 */
+    gap?: number | string;
+    /** 上下方位时的条长（默认 `100%` = 跟内容同宽）；左右方位忽略。 */
+    length?: number | string;
+}
+export interface CardSharedProps {
+    /** 色条档位或任意 CSS 颜色值（如 `'#f59e0b'`）。 */
+    accent?: CardAccent | string;
+    /** 色条方位与几何；默认左侧。 */
+    bar?: CardBarOptions;
+    /** 展开态（决定箭头朝向与 `panel` 显隐）。 */
+    expanded?: boolean;
+    /** 传了才显示右侧折叠箭头（全站唯一的 Chevron）；由调用方管展开状态。 */
+    onToggle?: () => void;
+    /** 右上角操作区（如「跳过」「查看会话」）。 */
+    action?: ReactNode;
+    /** 主内容：想写几行、左边右边随你。 */
+    children?: ReactNode;
+    /** 展开后才显示的额外内容。 */
+    panel?: ReactNode;
+    className?: string;
+    style?: CSSProperties;
+    translate?: Translate;
+}
+/**
+ * 卡片（框式）：复用 `Surface` 外框（surface 底 + 1px 边框 + 圆角 12），
+ * 色条默认贴左缘、6px 粗、圆角短条（高度随内容）；`bar.side` 可换成右/上/下。
+ * 头部整体垂直居中；悬停浮出的按钮、一行两行由调用方在框内自定。
+ *
+ * ```tsx
+ * h(Card, {
+ *   accent: 'warning',
+ *   bar: { side: 'right', inset: 10, gap: 8 },
+ *   action: h(Button, { size: 'sm', variant: 'ghost' }, '跳过'),
+ * }, h('div', null, '标题 + 内容'))
+ * ```
+ */
+export declare function Card(props: CardSharedProps): ReturnType<typeof h>;
+/**
+ * 条带卡片（浅底式）：同色系浅底 + 1px 不可见占位边框 + 方角 + 左缘 4px 通高方角色条（贴左缘）。
+ * 与 `Card` 同一份 props，头部同样整体垂直居中。
+ *
+ * ```tsx
+ * h(StripCard, {
+ *   accent: 'success',
+ *   expanded: open, onToggle: () => setOpen(!open),
+ *   panel: h('div', null, '展开详情'),
+ * }, h('div', null, '标题 + 元信息'))
+ * ```
+ */
+export declare function StripCard(props: CardSharedProps): ReturnType<typeof h>;
+//# sourceMappingURL=Card.d.ts.map

package/dist/ui/display/Card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Card.d.ts","sourceRoot":"","sources":["../../../src/ui/display/Card.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,IAAI,CAAC,EAAE,KAAK,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAE9E,OAAO,EAAK,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAMvD,wDAAwD;AACxD,eAAO,MAAM,YAAY,yIAGf,CAAA;AACV,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA;AAEtD,6CAA6C;AAC7C,MAAM,WAAW,cAAc;IAC7B,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAA;IAC1C,oBAAoB;IACpB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACtB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACvB,yBAAyB;IACzB,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACrB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,CAAA;IAC5B,oBAAoB;IACpB,GAAG,CAAC,EAAE,cAAc,CAAA;IACpB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IACrB,2BAA2B;IAC3B,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB,uBAAuB;IACvB,QAAQ,CAAC,EAAE,SAAS,CAAA;IACpB,mBAAmB;IACnB,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,aAAa,CAAA;IACrB,SAAS,CAAC,EAAE,SAAS,CAAA;CACtB;AA0FD;;;;;;;;;;;;GAYG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,eAAe,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAEjE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,eAAe,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAEtE"}

package/dist/ui/display/Card.js

@@ -0,0 +1,109 @@
+import { createElement as h } from 'react';
+import { Chevron } from '../infra/chevron.js';
+import { t } from '../../utils/i18n.js';
+import { ensureComponentStyles } from '../infra/css.js';
+import { CARD_CSS } from './card-css.js';
+import { SURFACE_CSS } from './surface-css.js';
+import { surfaceClass } from './Surface.js';
+/** 色条档位（映射到 design 的 token，不新增 token；也接受任意 CSS 颜色值）。 */
+export const CARD_ACCENTS = [
+    'business', 'success', 'warning', 'danger', 'neutral',
+    'purple', 'pink', 'cyan', 'teal', 'orange', 'indigo', 'rose', 'slate',
+];
+/** 数字按 px 写进 CSS 变量，字符串原样透传。 */
+function lengthOf(value) {
+    return typeof value === 'number' ? `${value}px` : value;
+}
+/**
+ * 内部共享壳：两个公开组件（`Card` / `StripCard`）只是 `kind` 不同——
+ * 一个组件一种外观，import 即表明用的是哪种。
+ *
+ * 外框（底 / 边框 / 圆角）来自 `Surface`（圆角统一 12）；本壳只管色条几何与头部布局。
+ * 两种外观的头部都是**整体垂直居中**（`align-items:center`）：调用方在 `action` 里
+ * 裸放一个元素（按钮 / 文字 / 图标）即垂直居中，不用自己套容器；框内一行两行、
+ * 右侧放什么、悬停浮出的按钮，都由调用方在框内自定——外壳只提供框与居中。
+ */
+function CardShell(kind, props) {
+    // Surface 是外框契约（圆角统一 12）：先注入它，再注入本皮肤。两份都按需注入、幂等。
+    ensureComponentStyles('surface', SURFACE_CSS);
+    ensureComponentStyles('card', CARD_CSS);
+    const tt = props.translate ?? t;
+    const accent = props.accent ?? 'business';
+    const isPreset = CARD_ACCENTS.includes(accent);
+    const bar = props.bar ?? {};
+    // StripCard 固定贴左；Card 默认左侧，可换任意一边。
+    const side = kind === 'strip' ? 'left' : bar.side ?? 'left';
+    const classes = [
+        // strip = 方角 + 透明占位边框；两种外观都**不吃 Surface 的内距**（内距由色条贴边算）。
+        surfaceClass(kind === 'strip' ? { radius: 'none', border: 'none', padding: null } : { padding: null }),
+        'dshpc-card',
+        kind === 'strip' ? 'dshpc-card--strip' : 'dshpc-card--bordered',
+        `dshpc-card--bar-${side}`,
+        isPreset ? `dshpc-card--${accent}` : '',
+        props.className ?? '',
+    ]
+        .filter((s) => s !== '')
+        .join(' ');
+    // 自定义色与色条几何都走 CSS 变量（档位则用 class 里的 token）
+    const vars = {};
+    if (!isPreset)
+        vars['--card-accent'] = accent;
+    if (bar.size !== undefined)
+        vars['--card-bar-size'] = lengthOf(bar.size);
+    if (bar.inset !== undefined)
+        vars['--card-bar-inset'] = lengthOf(bar.inset);
+    if (bar.gap !== undefined)
+        vars['--card-bar-gap'] = lengthOf(bar.gap);
+    if (bar.length !== undefined)
+        vars['--card-bar-length'] = lengthOf(bar.length);
+    const style = { ...props.style, ...vars };
+    return h('div', { className: classes, style }, h('div', { className: 'dshpc-card__body' }, 
+    // 色条是 body 的第一个子元素：DOM 顺序恒定，左/上 = 天然在前，右/下靠 order 排到头部之后。
+    h('span', { className: 'dshpc-card__bar', 'aria-hidden': true }), h('div', { className: 'dshpc-card__head' }, h('div', { className: 'dshpc-card__main' }, props.children ?? null), props.action === undefined && props.onToggle === undefined
+        ? null
+        : h('div', { className: 'dshpc-card__side' }, props.action ?? null, props.onToggle === undefined
+            ? null
+            : h('button', {
+                type: 'button',
+                className: 'dshpc-card__toggle',
+                'aria-label': tt('cardToggle'),
+                'aria-expanded': props.expanded === true,
+                onClick: props.onToggle,
+            }, 
+            // 箭头走全站唯一的 Chevron（不再写 ▾ 字形）；旋转由外层 .is-open 承担，动画不变。
+            h('span', { className: props.expanded === true ? 'dshpc-card__caret is-open' : 'dshpc-card__caret' }, h(Chevron, { size: 12 })))))), props.panel === undefined || props.expanded !== true
+        ? null
+        : h('div', { className: 'dshpc-card__panel' }, props.panel));
+}
+/**
+ * 卡片（框式）：复用 `Surface` 外框（surface 底 + 1px 边框 + 圆角 12），
+ * 色条默认贴左缘、6px 粗、圆角短条（高度随内容）；`bar.side` 可换成右/上/下。
+ * 头部整体垂直居中；悬停浮出的按钮、一行两行由调用方在框内自定。
+ *
+ * ```tsx
+ * h(Card, {
+ *   accent: 'warning',
+ *   bar: { side: 'right', inset: 10, gap: 8 },
+ *   action: h(Button, { size: 'sm', variant: 'ghost' }, '跳过'),
+ * }, h('div', null, '标题 + 内容'))
+ * ```
+ */
+export function Card(props) {
+    return CardShell('bordered', props);
+}
+/**
+ * 条带卡片（浅底式）：同色系浅底 + 1px 不可见占位边框 + 方角 + 左缘 4px 通高方角色条（贴左缘）。
+ * 与 `Card` 同一份 props，头部同样整体垂直居中。
+ *
+ * ```tsx
+ * h(StripCard, {
+ *   accent: 'success',
+ *   expanded: open, onToggle: () => setOpen(!open),
+ *   panel: h('div', null, '展开详情'),
+ * }, h('div', null, '标题 + 元信息'))
+ * ```
+ */
+export function StripCard(props) {
+    return CardShell('strip', props);
+}
+//# sourceMappingURL=Card.js.map

package/dist/ui/display/Card.js.map

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

package/dist/ui/display/Chip.d.ts

@@ -0,0 +1,28 @@
+import { createElement as h, type ReactNode } from 'react';
+/** 标签语义色档（非 neutral 为实心信号面，字色配对见 chip.css）。 */
+export type ChipTone = 'neutral' | 'business' | 'success' | 'warning' | 'danger' | 'purple' | 'pink' | 'cyan' | 'teal' | 'orange' | 'indigo' | 'rose' | 'slate';
+/** 标签尺寸档（sm 即旧版默认，逐像素不变；xs 为 2026-10-20 新增的超小档）。 */
+export type ChipSize = 'sm' | 'md' | 'xs';
+export interface ChipProps {
+    children?: ReactNode;
+    /** 语义色（默认 neutral 灰面）。 */
+    tone?: ChipTone;
+    /** 尺寸（默认 sm）。 */
+    size?: ChipSize;
+    /**
+     * 固定宽（px 或任意 CSS 宽度值）。与 `minWidth` / `maxWidth` 互斥：一旦设定，后两者自动失效。
+     */
+    width?: number | string;
+    /** 最小宽：`width` 未设时生效，内容不足此宽时以它为准。 */
+    minWidth?: number | string;
+    /**
+     * 最大宽：`width` 未设时生效，文字超出时折叠成省略号，hover 以跑马灯展开全名。
+     */
+    maxWidth?: number | string;
+    onClick?: () => void;
+    /** 追加 class（只允许补布局，不许覆盖皮肤）。 */
+    className?: string;
+}
+/** 小标签（neutral 用现成的 `--dshpc-chip-bg`；传 `onClick` 才是可点的）。 */
+export declare function Chip(props: ChipProps): ReturnType<typeof h>;
+//# sourceMappingURL=Chip.d.ts.map

package/dist/ui/display/Chip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Chip.d.ts","sourceRoot":"","sources":["../../../src/ui/display/Chip.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,IAAI,CAAC,EAAsB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAK9E,+CAA+C;AAC/C,MAAM,MAAM,QAAQ,GAChB,SAAS,GACT,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAC7C,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAA;AAEhF,oDAAoD;AACpD,MAAM,MAAM,QAAQ,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;AAEzC,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,SAAS,CAAA;IACpB,0BAA0B;IAC1B,IAAI,CAAC,EAAE,QAAQ,CAAA;IACf,iBAAiB;IACjB,IAAI,CAAC,EAAE,QAAQ,CAAA;IACf;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACvB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC1B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC1B,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB,+BAA+B;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,6DAA6D;AAC7D,wBAAgB,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAgC3D"}

package/dist/ui/display/Chip.js

@@ -0,0 +1,36 @@
+import { createElement as h } from 'react';
+import { MarqueeText } from './MarqueeText.js';
+import { ensureComponentStyles } from '../infra/css.js';
+import { CHIP_CSS } from './chip-css.js';
+/** 小标签（neutral 用现成的 `--dshpc-chip-bg`；传 `onClick` 才是可点的）。 */
+export function Chip(props) {
+    ensureComponentStyles('chip', CHIP_CSS);
+    const { children, tone = 'neutral', size = 'sm', width, minWidth, maxWidth, onClick, className, } = props;
+    const clickable = onClick !== undefined;
+    // 三轴互斥：固定宽优先，min / max 失效；否则 min / max 各自生效。
+    const widthStyle = {};
+    if (width !== undefined) {
+        widthStyle.width = width;
+    }
+    else {
+        if (minWidth !== undefined)
+            widthStyle.minWidth = minWidth;
+        if (maxWidth !== undefined)
+            widthStyle.maxWidth = maxWidth;
+    }
+    // 最大宽 + 纯文字内容 ⇒ 折叠省略号、hover 跑马灯（复用全站唯一 MarqueeText）。
+    const marqueeLabel = maxWidth !== undefined && width === undefined && typeof children === 'string';
+    return h(clickable ? 'button' : 'span', {
+        type: clickable ? 'button' : undefined,
+        className: `dshpc-chip`
+            + `${tone !== 'neutral' ? ` dshpc-chip--${tone}` : ''}`
+            + `${size !== 'sm' ? ` dshpc-chip--${size}` : ''}`
+            + `${clickable ? ' dshpc-chip--clickable' : ''}`
+            + `${className === undefined ? '' : ` ${className}`}`,
+        style: widthStyle,
+        onClick,
+    }, marqueeLabel
+        ? h(MarqueeText, { text: children, className: 'dshpc-chip__label' })
+        : children ?? null);
+}
+//# sourceMappingURL=Chip.js.map

package/dist/ui/display/Chip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Chip.js","sourceRoot":"","sources":["../../../src/ui/display/Chip.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,IAAI,CAAC,EAAsC,MAAM,OAAO,CAAA;AAC9E,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAA;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAgCxC,6DAA6D;AAC7D,MAAM,UAAU,IAAI,CAAC,KAAgB;IACnC,qBAAqB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IACvC,MAAM,EACJ,QAAQ,EAAE,IAAI,GAAG,SAAS,EAAE,IAAI,GAAG,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,GACvF,GAAG,KAAK,CAAA;IACT,MAAM,SAAS,GAAG,OAAO,KAAK,SAAS,CAAA;IACvC,6CAA6C;IAC7C,MAAM,UAAU,GAAkB,EAAE,CAAA;IACpC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,UAAU,CAAC,KAAK,GAAG,KAAK,CAAA;IAC1B,CAAC;SAAM,CAAC;QACN,IAAI,QAAQ,KAAK,SAAS;YAAE,UAAU,CAAC,QAAQ,GAAG,QAAQ,CAAA;QAC1D,IAAI,QAAQ,KAAK,SAAS;YAAE,UAAU,CAAC,QAAQ,GAAG,QAAQ,CAAA;IAC5D,CAAC;IACD,qDAAqD;IACrD,MAAM,YAAY,GAAG,QAAQ,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,QAAQ,KAAK,QAAQ,CAAA;IAClG,OAAO,CAAC,CACN,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAC7B;QACE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;QACtC,SAAS,EAAE,YAAY;cACnB,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;cACrD,GAAG,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;cAChD,GAAG,SAAS,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,EAAE,EAAE;cAC9C,GAAG,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,SAAS,EAAE,EAAE;QACvD,KAAK,EAAE,UAAU;QACjB,OAAO;KACR,EACD,YAAY;QACV,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,mBAAmB,EAAE,CAAC;QACpE,CAAC,CAAC,QAAQ,IAAI,IAAI,CACrB,CAAA;AACH,CAAC"}

package/dist/ui/display/CodeViewer.d.ts

@@ -0,0 +1,38 @@
+/**
+ * CodeViewer —— 只读源码查看器（替代官方 Shiki CodeBlock），DSH 共享底座版。
+ *
+ * 为什么换成 CodeMirror 6：官方 CodeBlock 把整篇 tokenize 成 <pre> + 每 token 一个
+ * <span> 的巨型 DOM，拖动改宽会触发整棵子树重排，大文件首屏与拖拽都卡。CodeMirror
+ * 是行级视图 + Lezer 增量高亮，宽度变化只重排可视区，天然不为整篇买单。
+ *
+ * 移植自兄弟项目 dsh-task-dispatch-table（src/client/ui/CodeViewer.tsx），按本仓约定重写：
+ * 类名 dshpc-cv*、颜色吃 --dshpc-* token、官方图标 / writeClipboard 经 ui/official.ts 单一入口。
+ *
+ * 只读但可选中：仅用 <CodeMirror readOnly>（= EditorState.readOnly，挡住一切输入），
+ * 不设置 editable=false —— 后者会把内容设为不可编辑并连带禁用鼠标选区，导致无法框选复制。
+ *
+ * 明暗判据（唯一）：body[data-ds-dark-theme]（见 design/style-kit.ts DARK_THEME_SELECTOR），
+ * 禁用 prefers-color-scheme。
+ */
+import { type CSSProperties, type ReactElement } from 'react';
+import type { Translate } from '../../utils/i18n.js';
+export interface CodeViewerProps {
+    /** 源码文本。 */
+    text: string;
+    /** 文件路径（用于按扩展名选语言）。 */
+    path: string;
+    /** 翻译函数（核心内置字典自带 codeCopy / codeCopied）。 */
+    t: Translate;
+    /** 可选：透传调用方样式类名（保留既有皮肤与高度上下文）。 */
+    className?: string;
+    /** 可选：透传根 div 行内样式。 */
+    style?: CSSProperties;
+    /** 可选：编辑器高度，默认 "100%"（填满父容器）；无确定高度上下文（如工具卡代码）传 "auto" 随内容撑高。 */
+    height?: string;
+    /** 可选：是否显示行号，默认 true（文件预览要行号；文档里的代码片段一般不要）。 */
+    lineNumbers?: boolean;
+    /** 可选：挂载/换文本后把这一行滚到视口中部（超出现有文本则不动）。 */
+    focusLine?: number;
+}
+export declare function CodeViewer(props: CodeViewerProps): ReactElement;
+//# sourceMappingURL=CodeViewer.d.ts.map

package/dist/ui/display/CodeViewer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CodeViewer.d.ts","sourceRoot":"","sources":["../../../src/ui/display/CodeViewer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAA4D,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,OAAO,CAAA;AAMvH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAepD,MAAM,WAAW,eAAe;IAC9B,YAAY;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,4CAA4C;IAC5C,CAAC,EAAE,SAAS,CAAA;IACZ,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,uBAAuB;IACvB,KAAK,CAAC,EAAE,aAAa,CAAA;IACrB,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,+CAA+C;IAC/C,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,YAAY,CA+E/D"}

package/dist/ui/display/CodeViewer.js

@@ -0,0 +1,107 @@
+/**
+ * CodeViewer —— 只读源码查看器（替代官方 Shiki CodeBlock），DSH 共享底座版。
+ *
+ * 为什么换成 CodeMirror 6：官方 CodeBlock 把整篇 tokenize 成 <pre> + 每 token 一个
+ * <span> 的巨型 DOM，拖动改宽会触发整棵子树重排，大文件首屏与拖拽都卡。CodeMirror
+ * 是行级视图 + Lezer 增量高亮，宽度变化只重排可视区，天然不为整篇买单。
+ *
+ * 移植自兄弟项目 dsh-task-dispatch-table（src/client/ui/CodeViewer.tsx），按本仓约定重写：
+ * 类名 dshpc-cv*、颜色吃 --dshpc-* token、官方图标 / writeClipboard 经 ui/official.ts 单一入口。
+ *
+ * 只读但可选中：仅用 <CodeMirror readOnly>（= EditorState.readOnly，挡住一切输入），
+ * 不设置 editable=false —— 后者会把内容设为不可编辑并连带禁用鼠标选区，导致无法框选复制。
+ *
+ * 明暗判据（唯一）：body[data-ds-dark-theme]（见 design/style-kit.ts DARK_THEME_SELECTOR），
+ * 禁用 prefers-color-scheme。
+ */
+import { createElement as h, useEffect, useMemo, useRef, useState } from 'react';
+import CodeMirror from '@uiw/react-codemirror';
+import { EditorView } from '@codemirror/view';
+import { IconButton } from '../actions/Button.js';
+import { IconCheckOutlineRegular, IconCopyOutlineRegular, writeClipboard } from '../official.js';
+import { languageForPath } from './code-viewer-lang.js';
+import { codeMirrorTheme } from './code-viewer-theme.js';
+import { ensureComponentStyles } from '../infra/css.js';
+import { CODE_VIEWER_CSS } from './code-viewer-css.js';
+/** 唯一明暗判据属性名（宿主启动脚本 toggleAttribute 写入 body）。 */
+const DARK_ATTR = 'data-ds-dark-theme';
+function hostDark() {
+    if (typeof document === 'undefined')
+        return false;
+    const body = document.body;
+    return body === null ? false : body.hasAttribute(DARK_ATTR);
+}
+export function CodeViewer(props) {
+    ensureComponentStyles('code-viewer', CODE_VIEWER_CSS);
+    const { text, path, t, className, style, height = '100%', lineNumbers = true } = props;
+    const [copied, setCopied] = useState(false);
+    const [dark, setDark] = useState(hostDark);
+    /** 编辑器实例（定位到行要 dispatch scrollIntoView）。 */
+    const viewRef = useRef(null);
+    // 用户切主题 = 宿主 toggleAttribute 写 body[data-ds-dark-theme] ⇒ 用 MutationObserver 跟。
+    // 挂载时先 sync 一次：插件挂载可能早于宿主写好该属性。
+    useEffect(() => {
+        if (typeof document === 'undefined' || typeof MutationObserver !== 'function')
+            return;
+        const body = document.body;
+        if (body === null)
+            return;
+        const sync = () => { setDark(body.hasAttribute(DARK_ATTR)); };
+        sync();
+        const observer = new MutationObserver(sync);
+        observer.observe(body, { attributeFilter: [DARK_ATTR] });
+        return () => { observer.disconnect(); };
+    }, []);
+    const language = useMemo(() => languageForPath(path), [path]);
+    const extensions = useMemo(() => [
+        ...codeMirrorTheme(dark),
+        EditorView.lineWrapping, // 默认全换行，避免横向滚动条
+        ...(language !== null ? [language] : []),
+    ], [dark, language]);
+    const copy = () => {
+        void writeClipboard(text).then((ok) => {
+            if (ok) {
+                setCopied(true);
+                window.setTimeout(() => setCopied(false), 1500);
+            }
+        });
+    };
+    // 定位到行：预览分页是逐步追加的，文本到了才能滚 ⇒ 跟着 text 再试一次。
+    useEffect(() => {
+        const view = viewRef.current;
+        if (view === null || props.focusLine === undefined)
+            return;
+        if (props.focusLine > view.state.doc.lines)
+            return;
+        view.dispatch({ effects: EditorView.scrollIntoView(view.state.doc.line(props.focusLine).from, { y: 'center' }) });
+    }, [text, props.focusLine]);
+    return h('div', { className: `dshpc-cv${className ? ` ${className}` : ''}`, style }, h(IconButton, {
+        variant: 'outline',
+        size: 'md',
+        icon: copied ? h(IconCheckOutlineRegular) : h(IconCopyOutlineRegular),
+        label: copied ? t('codeCopied') : t('codeCopy'),
+        className: 'dshpc-cv__copy',
+        onClick: copy,
+    }), h(CodeMirror, {
+        value: text,
+        className: 'dshpc-cv__editor',
+        theme: 'none',
+        extensions,
+        readOnly: true,
+        height,
+        onCreateEditor: (view) => { viewRef.current = view; },
+        style: { flex: '1 1 auto', minHeight: 0, overflow: 'hidden' },
+        basicSetup: {
+            lineNumbers,
+            foldGutter: false,
+            highlightActiveLine: false,
+            highlightActiveLineGutter: false,
+            autocompletion: false,
+            bracketMatching: true,
+            closeBrackets: false,
+            indentOnInput: false,
+            searchKeymap: false,
+        },
+    }));
+}
+//# sourceMappingURL=CodeViewer.js.map

package/dist/ui/display/CodeViewer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CodeViewer.js","sourceRoot":"","sources":["../../../src/ui/display/CodeViewer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,aAAa,IAAI,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAyC,MAAM,OAAO,CAAA;AACvH,OAAO,UAAU,MAAM,uBAAuB,CAAA;AAE9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACjD,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAEhG,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAA;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAEtD,iDAAiD;AACjD,MAAM,SAAS,GAAG,oBAAoB,CAAA;AAEtC,SAAS,QAAQ;IACf,IAAI,OAAO,QAAQ,KAAK,WAAW;QAAE,OAAO,KAAK,CAAA;IACjD,MAAM,IAAI,GAAuB,QAAQ,CAAC,IAAI,CAAA;IAC9C,OAAO,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAA;AAC7D,CAAC;AAqBD,MAAM,UAAU,UAAU,CAAC,KAAsB;IAC/C,qBAAqB,CAAC,aAAa,EAAE,eAAe,CAAC,CAAA;IACrD,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,WAAW,GAAG,IAAI,EAAE,GAAG,KAAK,CAAA;IACtF,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IAC3C,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAU,QAAQ,CAAC,CAAA;IACnD,4CAA4C;IAC5C,MAAM,OAAO,GAAG,MAAM,CAAoB,IAAI,CAAC,CAAA;IAE/C,gFAAgF;IAChF,gCAAgC;IAChC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,OAAO,QAAQ,KAAK,WAAW,IAAI,OAAO,gBAAgB,KAAK,UAAU;YAAE,OAAM;QACrF,MAAM,IAAI,GAAuB,QAAQ,CAAC,IAAI,CAAA;QAC9C,IAAI,IAAI,KAAK,IAAI;YAAE,OAAM;QACzB,MAAM,IAAI,GAAG,GAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAA,CAAC,CAAC,CAAA;QAClE,IAAI,EAAE,CAAA;QACN,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAA;QAC3C,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,eAAe,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAA;QACxD,OAAO,GAAG,EAAE,GAAG,QAAQ,CAAC,UAAU,EAAE,CAAA,CAAC,CAAC,CAAA;IACxC,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAA;IAE7D,MAAM,UAAU,GAAG,OAAO,CAAc,GAAG,EAAE,CAAC;QAC5C,GAAG,eAAe,CAAC,IAAI,CAAC;QACxB,UAAU,CAAC,YAAY,EAAE,gBAAgB;QACzC,GAAG,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KACzC,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAA;IAEpB,MAAM,IAAI,GAAG,GAAS,EAAE;QACtB,KAAK,cAAc,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,EAAW,EAAE,EAAE;YAC7C,IAAI,EAAE,EAAE,CAAC;gBACP,SAAS,CAAC,IAAI,CAAC,CAAA;gBACf,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,CAAA;YACjD,CAAC;QACH,CAAC,CAAC,CAAA;IACJ,CAAC,CAAA;IAED,0CAA0C;IAC1C,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAA;QAC5B,IAAI,IAAI,KAAK,IAAI,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS;YAAE,OAAM;QAC1D,IAAI,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK;YAAE,OAAM;QAClD,IAAI,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAA;IACnH,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAA;IAE3B,OAAO,CAAC,CACN,KAAK,EACL,EAAE,SAAS,EAAE,WAAW,SAAS,CAAC,CAAC,CAAC,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,EACnE,CAAC,CAAC,UAAU,EAAE;QACZ,OAAO,EAAE,SAAS;QAClB,IAAI,EAAE,IAAI;QACV,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,sBAAsB,CAAC;QACrE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;QAC/C,SAAS,EAAE,gBAAgB;QAC3B,OAAO,EAAE,IAAI;KACd,CAAC,EACF,CAAC,CAAC,UAAU,EAAE;QACZ,KAAK,EAAE,IAAI;QACX,SAAS,EAAE,kBAAkB;QAC7B,KAAK,EAAE,MAAM;QACb,UAAU;QACV,QAAQ,EAAE,IAAI;QACd,MAAM;QACN,cAAc,EAAE,CAAC,IAAgB,EAAE,EAAE,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAA,CAAC,CAAC;QAChE,KAAK,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE;QAC7D,UAAU,EAAE;YACV,WAAW;YACX,UAAU,EAAE,KAAK;YACjB,mBAAmB,EAAE,KAAK;YAC1B,yBAAyB,EAAE,KAAK;YAChC,cAAc,EAAE,KAAK;YACrB,eAAe,EAAE,IAAI;YACrB,aAAa,EAAE,KAAK;YACpB,aAAa,EAAE,KAAK;YACpB,YAAY,EAAE,KAAK;SACpB;KACF,CAAC,CACH,CAAA;AACH,CAAC"}

package/dist/ui/display/FieldHint.d.ts

@@ -0,0 +1,18 @@
+import { createElement as h, type CSSProperties } from 'react';
+export interface FieldHintProps {
+    /** 气泡里的说明文字（也是读屏播报的 aria-label）；`\n` 是真实换行。 */
+    text: string;
+    /** 气泡方位（走官方；默认 top）。 */
+    side?: 'top' | 'bottom' | 'right';
+    /** 上 / 下气泡的水平对齐（走官方）。 */
+    align?: 'center' | 'end';
+    /** 气泡宽度上限 px（走官方）。 */
+    maxWidth?: number;
+    /** 追加 class。 */
+    className?: string;
+    /** 追加样式（只允许补布局）。 */
+    style?: CSSProperties;
+}
+/** 问号提示图标：hover / focus 浮出说明气泡（官方 Tooltip 渲染）。 */
+export declare function FieldHint(props: FieldHintProps): ReturnType<typeof h>;
+//# sourceMappingURL=FieldHint.d.ts.map

package/dist/ui/display/FieldHint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FieldHint.d.ts","sourceRoot":"","sources":["../../../src/ui/display/FieldHint.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,aAAa,IAAI,CAAC,EAAE,KAAK,aAAa,EAAE,MAAM,OAAO,CAAA;AAI9D,MAAM,WAAW,cAAc;IAC7B,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAA;IACZ,wBAAwB;IACxB,IAAI,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAA;IACjC,yBAAyB;IACzB,KAAK,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAA;IACxB,sBAAsB;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,gBAAgB;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,oBAAoB;IACpB,KAAK,CAAC,EAAE,aAAa,CAAA;CACtB;AAED,kDAAkD;AAClD,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAqBrE"}

package/dist/ui/display/FieldHint.js

@@ -0,0 +1,40 @@
+/**
+ * 问号提示 —— **全站唯一实现、独立组件**（L2，P4）
+ *
+ * ⚠️ 它**不属于 Input 家族**：任何地方都能挂——表单行尾、标题后面、卡片角落……
+ * 调用点自己把它排进自己的 flex / label 里即可（组件只是 14px 的内联图标 + 气泡）。
+ *
+ * 气泡渲染 = **官方 Tooltip 本体**（2026-10-19 用户拍板「必须和悬停提示用同一个」）：
+ * 插件启动时 `setTooltipRenderer` 把官方 Tooltip 交给 core，本组件直接走它。
+ * ⚠️ **不做降级兜底**（用户同日明确：宿主内官方包恒在；官方改版 = 我们重新适配，不另造一套）。
+ * 未注入 renderer 的环境（node 自检）只出问号图标、没有气泡——那是非宿主环境，不是产品形态。
+ */
+import { getTooltipRenderer } from '../infra/tooltip.js';
+import { createElement as h } from 'react';
+import { ensureComponentStyles } from '../infra/css.js';
+import { HINT_CSS } from '../infra/controls-css.js';
+/** 问号提示图标：hover / focus 浮出说明气泡（官方 Tooltip 渲染）。 */
+export function FieldHint(props) {
+    ensureComponentStyles('hint', HINT_CSS);
+    const { text, side, align, maxWidth, className, style } = props;
+    // 官方往子元素挂 ref / 事件 ⇒ 锚点必须是真实 DOM 元素（兄弟仓踩过两次的坑），这里恒为原生 span。
+    const anchor = h('span', {
+        className: `dshpc-hint${className !== undefined && className !== '' ? ` ${className}` : ''}`,
+        style,
+        tabIndex: 0,
+        role: 'note',
+        'aria-label': text,
+    }, '?');
+    const renderer = getTooltipRenderer();
+    // 宿主内 renderer 恒被注入（demo 与各插件启动时做一次）；未注入 ⇒ 非宿主环境，只出图标。
+    if (renderer === undefined)
+        return anchor;
+    return renderer({
+        label: text,
+        side: side ?? 'top',
+        ...(align !== undefined ? { align } : {}),
+        ...(maxWidth !== undefined ? { maxWidth } : {}),
+        children: anchor,
+    });
+}
+//# sourceMappingURL=FieldHint.js.map

package/dist/ui/display/FieldHint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FieldHint.js","sourceRoot":"","sources":["../../../src/ui/display/FieldHint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,EAAE,aAAa,IAAI,CAAC,EAAsB,MAAM,OAAO,CAAA;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAA;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AAiBnD,kDAAkD;AAClD,MAAM,UAAU,SAAS,CAAC,KAAqB;IAC7C,qBAAqB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IACvC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,KAAK,CAAA;IAC/D,4DAA4D;IAC5D,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE;QACvB,SAAS,EAAE,aAAa,SAAS,KAAK,SAAS,IAAI,SAAS,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;QAC5F,KAAK;QACL,QAAQ,EAAE,CAAC;QACX,IAAI,EAAE,MAAM;QACZ,YAAY,EAAE,IAAI;KACnB,EAAE,GAAG,CAAC,CAAA;IACP,MAAM,QAAQ,GAAG,kBAAkB,EAAE,CAAA;IACrC,uDAAuD;IACvD,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,MAAM,CAAA;IACzC,OAAO,QAAQ,CAAC;QACd,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,IAAI,IAAI,KAAK;QACnB,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzC,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/C,QAAQ,EAAE,MAAM;KACjB,CAAC,CAAA;AACJ,CAAC"}

package/dist/ui/display/FlipText.d.ts

@@ -0,0 +1,43 @@
+/**
+ * 翻牌文本 —— 一行文字，换字时旧的上移出、新的从下进（机场翻牌那种）。
+ *
+ * 与 `MarqueeText` 的分工：跑马灯（三点省略 + hover 滚）由它负责，本组件只管「换字动效 + 裁剪」，
+ * 所以两层叠放的每一层就是一个 `MarqueeText`，不重复实现测宽。
+ *
+ * 宽度三档与 `Button` / `Chip` 同一口径：`width` 优先，`width` 未设时 `minWidth` / `maxWidth` 生效。
+ * 全不传 = 随父容器（flex 子项自然伸缩），这也是弹窗 footer 里的用法。
+ *
+ * 空串 = 没有文案：不渲染、不占位。所以「同一块地方复用」时传 `''` 就把上一句清干净了，
+ * 之后第一次给值是从无到有，直接出现（没有上一句可翻）。
+ */
+import { type ReactElement } from 'react';
+export interface FlipTextProps {
+    /** 当前文本。变了就翻一次；没变不动（同一句重复设置不会重播）；空串 = 无文案。 */
+    text: string;
+    /** 定宽（px 或任意 CSS 宽度）；给了即忽略 minWidth / maxWidth。 */
+    width?: number | string;
+    /** 最小宽（width 未设时生效）。 */
+    minWidth?: number | string;
+    /** 最大宽（width 未设时生效）；超出折叠成省略号，hover 以跑马灯展开。 */
+    maxWidth?: number | string;
+    /**
+     * 常驻扫光：一道斜光每 1.5s 扫过文字，让**停在原地**的提示也看得出在动。
+     * 默认关；`Modal` / `SideSheet` 的 `notice` 默认打开（确认框 / 底部过程提示的场景）。
+     */
+    sweep?: boolean;
+    /** 追加 class（只允许补字体 / 颜色这类皮肤）。 */
+    className?: string;
+}
+/** 当前帧 + 上一帧；`seq` 只用来换 key，让两层每次都重新挂载、动效从头播。 */
+export interface FlipSlot {
+    curr: string;
+    prev: string | null;
+    seq: number;
+}
+/**
+ * 换字推导：文本没变原样返回（同一句重复设置不重播）；变了把当前帧降为上一帧、seq+1。
+ * 上一帧是空串 ⇒ 不设 prev：第一句直接出现，不从下方翻上来。
+ */
+export declare function nextFlipSlot(slot: FlipSlot, text: string): FlipSlot;
+export declare function FlipText(props: FlipTextProps): ReactElement | null;
+//# sourceMappingURL=FlipText.d.ts.map

package/dist/ui/display/FlipText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlipText.d.ts","sourceRoot":"","sources":["../../../src/ui/display/FlipText.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAA+D,KAAK,YAAY,EAAE,MAAM,OAAO,CAAA;AAQtG,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAA;IACZ,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACvB,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC1B,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC1B;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,iDAAiD;AACjD,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,GAAG,EAAE,MAAM,CAAA;CACZ;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,CAGnE;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,YAAY,GAAG,IAAI,CAuClE"}

package/dist/ui/display/FlipText.js

@@ -0,0 +1,59 @@
+/**
+ * 翻牌文本 —— 一行文字，换字时旧的上移出、新的从下进（机场翻牌那种）。
+ *
+ * 与 `MarqueeText` 的分工：跑马灯（三点省略 + hover 滚）由它负责，本组件只管「换字动效 + 裁剪」，
+ * 所以两层叠放的每一层就是一个 `MarqueeText`，不重复实现测宽。
+ *
+ * 宽度三档与 `Button` / `Chip` 同一口径：`width` 优先，`width` 未设时 `minWidth` / `maxWidth` 生效。
+ * 全不传 = 随父容器（flex 子项自然伸缩），这也是弹窗 footer 里的用法。
+ *
+ * 空串 = 没有文案：不渲染、不占位。所以「同一块地方复用」时传 `''` 就把上一句清干净了，
+ * 之后第一次给值是从无到有，直接出现（没有上一句可翻）。
+ */
+import { createElement as h, useEffect, useState } from 'react';
+import { ensureComponentStyles } from '../infra/css.js';
+import { FLIP_CSS } from './flip-css.js';
+import { MarqueeText } from './MarqueeText.js';
+/** 与 flip.css 的 --dshpc-flip-dur（260ms）对齐，留一点余量给慢帧。 */
+const FLIP_MS = 300;
+/**
+ * 换字推导：文本没变原样返回（同一句重复设置不重播）；变了把当前帧降为上一帧、seq+1。
+ * 上一帧是空串 ⇒ 不设 prev：第一句直接出现，不从下方翻上来。
+ */
+export function nextFlipSlot(slot, text) {
+    if (slot.curr === text)
+        return slot;
+    return { curr: text, prev: slot.curr === '' ? null : slot.curr, seq: slot.seq + 1 };
+}
+export function FlipText(props) {
+    ensureComponentStyles('flip', FLIP_CSS);
+    const [slot, setSlot] = useState({ curr: props.text, prev: null, seq: 0 });
+    // 换字在 render 期调整（React 官方推荐的「props 变了就调 state」写法）：
+    // 同一次渲染就带上新值，不会先按旧帧画一屏再动画。
+    const next = nextFlipSlot(slot, props.text);
+    if (next !== slot)
+        setSlot(next);
+    // 旧帧到点就摘。用定时器而不是 animationend：reduced-motion 下动画被关掉，
+    // 事件永远不会来，旧帧会一直压在新帧上（同格叠放，两层都可见）。
+    useEffect(() => {
+        if (slot.prev === null)
+            return undefined;
+        const id = window.setTimeout(() => setSlot((s) => (s.prev === null ? s : { ...s, prev: null })), FLIP_MS);
+        return () => window.clearTimeout(id);
+    }, [slot.seq, slot.prev]);
+    if (props.text === '')
+        return null;
+    const style = props.width !== undefined
+        ? { width: props.width }
+        : { minWidth: props.minWidth, maxWidth: props.maxWidth };
+    const item = 'dshpc-flip__item';
+    const root = `dshpc-flip${props.sweep === true ? ' dshpc-flip--sweep' : ''}${props.className === undefined ? '' : ` ${props.className}`}`;
+    return h('span', { className: root, style }, 
+    // 旧帧：只在换字后存在，到点摘掉
+    slot.prev === null
+        ? null
+        : h('span', { key: `p${String(slot.seq)}`, className: `${item} dshpc-flip__out` }, h(MarqueeText, { text: slot.prev })), 
+    // 新帧：没有上一帧（首帧 / 从无到有）不放动画
+    h('span', { key: `c${String(slot.seq)}`, className: slot.prev === null ? item : `${item} dshpc-flip__in` }, h(MarqueeText, { text: slot.curr })));
+}
+//# sourceMappingURL=FlipText.js.map

package/dist/ui/display/FlipText.js.map

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

package/dist/ui/display/LiveText.d.ts

@@ -0,0 +1,13 @@
+import { type ReactNode } from 'react';
+/**
+ * 每秒自刷新的一小块：只有它自己重渲染（`render` 永远取最新闭包，ref 转发）。
+ * 2026-09-30（决策 54）：`render` 由「只能返回字符串」放宽为**可返回节点** —— 「到点未派发」
+ * 时要在这里就地换成三个方块的活动指示（文案换不出来，只能给节点）。
+ */
+export declare function LiveText(props: {
+    render: (nowMs: number) => ReactNode;
+    style?: Record<string, string | number>;
+}): import("react").DetailedReactHTMLElement<{
+    style: Record<string, string | number> | undefined;
+}, HTMLElement>;
+//# sourceMappingURL=LiveText.d.ts.map