dsh-plugin-core 0.32.0 → 0.33.0

package/dist/ui/inputs/ModelPicker.d.ts

@@ -0,0 +1,48 @@
+import { createElement as h, type ReactNode } from 'react';
+import { type Translate } from '../../utils/i18n.js';
+import { type PickerSize } from './Picker.js';
+import { type PickerGroup } from './picker-logic.js';
+/**
+ * 模型选择器的两种形态（消费者自选）：
+ * - `grouped`（分组，默认）：**一个下拉、完全独立**，供应商做组头、模型列在下面，不与任何东西联动。
+ * - `cascade`（联动）：**两个下拉、彼此联动** —— 先选供应商，后面模型列表跟着筛；
+ *   换供应商会清空已选模型（旧模型不属于新供应商）。
+ *
+ * **返回口径一致**：`onChange` 一律发最终模型值（`${provider}/${id}`）；级联态换供应商先发 `''`。
+ * 选「默认模型」也发 `''` —— 表示没选，调用方自己处理。
+ *
+ * **数据自带**：不传 `groups` 就读 `connectHost(ctx, { modelsPath })` 喂进的真实目录。
+ */
+export type ModelPickerVariant = 'grouped' | 'cascade';
+export interface ModelPickerProps {
+    /** 覆盖内置目录（一般不用；测试或特殊数据源时才传）。 */
+    groups?: PickerGroup[];
+    variant?: ModelPickerVariant;
+    /** 最终模型值；`''` = 默认模型（没选）。 */
+    value?: string;
+    /** 非受控初始值。 */
+    defaultValue?: string;
+    onChange?: (value: string) => void;
+    /** 是否提供「默认模型」选项（默认提供；不需要就传 false）。 */
+    allowDefault?: boolean;
+    /** 「默认模型」的文案（默认取内置字典）。 */
+    defaultLabel?: string;
+    /** 未选时的文字（默认「模型」）。 */
+    placeholder?: string;
+    /** 触发器前置图标：不传 = 默认星形；传 `null` = 不显示；传元素 = 自定义。 */
+    icon?: ReactNode | null;
+    /** 问号提示文字（传了才显示）。 */
+    hint?: string;
+    /** 目录不可用时的如实提示（不传则由目录状态决定）。 */
+    degraded?: boolean;
+    disabled?: boolean;
+    clearable?: boolean;
+    /** 下拉内搜索框（默认开；要关传 false）。 */
+    searchable?: boolean;
+    size?: PickerSize;
+    placement?: 'down' | 'up';
+    className?: string;
+    translate?: Translate;
+}
+export declare function ModelPicker(props: ModelPickerProps): ReturnType<typeof h>;
+//# sourceMappingURL=ModelPicker.d.ts.map

package/dist/ui/inputs/ModelPicker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModelPicker.d.ts","sourceRoot":"","sources":["../../../src/ui/inputs/ModelPicker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,IAAI,CAAC,EAA6C,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AACrG,OAAO,EAAK,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,EAAU,KAAK,UAAU,EAAE,MAAM,aAAa,CAAA;AACrD,OAAO,EAA2B,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAM7E;;;;;;;;;;GAUG;AACH,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,SAAS,CAAA;AAEtD,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,MAAM,CAAC,EAAE,WAAW,EAAE,CAAA;IACtB,OAAO,CAAC,EAAE,kBAAkB,CAAA;IAC5B,6BAA6B;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,cAAc;IACd,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAClC,sCAAsC;IACtC,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,0BAA0B;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,sBAAsB;IACtB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,kDAAkD;IAClD,IAAI,CAAC,EAAE,SAAS,GAAG,IAAI,CAAA;IACvB,qBAAqB;IACrB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,6BAA6B;IAC7B,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,SAAS,CAAA;CACtB;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAqGzE"}

package/dist/ui/inputs/ModelPicker.js

@@ -0,0 +1,101 @@
+import { createElement as h, useEffect, useState, useSyncExternalStore } from 'react';
+import { t } from '../../utils/i18n.js';
+import { Picker } from './Picker.js';
+import { flattenOptions, groupOf } from './picker-logic.js';
+import { modelCatalog } from '../infra/host-data.js';
+import { sparkleIcon } from './picker-icons.js';
+import { ensureComponentStyles } from '../infra/css.js';
+import { PICKER_CSS } from './picker-css.js';
+export function ModelPicker(props) {
+    ensureComponentStyles('picker', PICKER_CSS);
+    const tt = props.translate ?? t;
+    const value = props.value;
+    const variant = props.variant ?? 'grouped';
+    const searchable = props.searchable ?? true;
+    const defaultOption = props.allowDefault === false
+        ? undefined
+        : { value: '', label: props.defaultLabel ?? tt('modelDefault') };
+    // 目录状态：外部没喂目录（Node 自检 / 宿主缺服务）⇒ 空 + 如实降级，不编数据。
+    const catalog = useSyncExternalStore(modelCatalog.subscribe, modelCatalog.getSnapshot);
+    const groups = props.groups ??
+        (catalog.status === 'ready'
+            ? catalog.routes.map((route) => ({
+                value: route.provider,
+                label: route.displayName,
+                options: route.models.map((model) => ({
+                    value: `${route.provider}/${model.id}`,
+                    label: model.name ?? model.id,
+                })),
+            }))
+            : []);
+    // 目录不可用、或读出来是空的 ⇒ 如实提示「候选可能不完整」，别让空列表看起来像坏了。
+    const degraded = props.degraded ?? (catalog.status === 'unavailable' || (catalog.status === 'ready' && groups.length === 0));
+    const icon = props.icon === undefined ? sparkleIcon() : props.icon ?? undefined;
+    const emitModel = (v) => {
+        props.onChange?.(typeof v === 'string' ? v : v[0] ?? '');
+    };
+    // 联动态的厂商选择必须组件自己记 —— 值是从模型值反推的，换厂商会把模型清成 ''
+    // （拍板口径），反推就再也找不到刚点的厂商（2026-10-20 真机：选完厂商后面仍是黑的）。
+    const [pickedProvider, setPickedProvider] = useState('');
+    const curGroup = groupOf(groups, value ?? '');
+    const provider = pickedProvider !== '' && groups.some((g) => g.value === pickedProvider)
+        ? pickedProvider
+        : curGroup?.value ?? '';
+    // 值定到某模型上 ⇒ 临时选的厂商功成身退，回到按值反推
+    useEffect(() => {
+        if (value !== undefined && value !== '')
+            setPickedProvider('');
+    }, [value]);
+    if (variant === 'grouped') {
+        return h(Picker, {
+            // 「默认模型」放最上面：空 label 的组，Picker 只渲染选项不渲染组头
+            groups: defaultOption === undefined
+                ? groups
+                : [{ value: '', label: '', options: [defaultOption] }, ...groups],
+            value,
+            defaultValue: props.defaultValue,
+            icon,
+            placeholder: props.placeholder ?? tt('modelModel'),
+            degraded,
+            disabled: props.disabled,
+            clearable: props.clearable,
+            searchable,
+            hint: props.hint,
+            size: props.size,
+            placement: props.placement,
+            className: props.className,
+            onChange: emitModel,
+        });
+    }
+    // cascade：两个下拉联动 —— 供应商筛模型；换供应商清空模型
+    const group = groups.find((g) => g.value === provider);
+    const options = group === undefined ? [] : flattenOptions([group]);
+    return h('div', { className: 'dshpc-picker__row' }, h(Picker, {
+        options: groups.map((g) => ({ value: g.value, label: g.label })),
+        value: provider === '' ? undefined : provider,
+        placeholder: tt('modelProvider'),
+        degraded,
+        disabled: props.disabled,
+        searchable: false,
+        onChange: (v) => {
+            setPickedProvider(typeof v === 'string' ? v : v[0] ?? '');
+            props.onChange?.('');
+        },
+    }), h(Picker, {
+        options: defaultOption === undefined ? options : [defaultOption, ...options],
+        value,
+        defaultValue: props.defaultValue,
+        icon,
+        placeholder: props.placeholder ?? tt('modelModel'),
+        degraded,
+        disabled: props.disabled === true || provider === '',
+        clearable: props.clearable,
+        searchable,
+        hint: props.hint,
+        size: props.size,
+        placement: props.placement,
+        className: props.className,
+        onChange: emitModel,
+    }));
+}
+//# sourceMappingURL=ModelPicker.js.map

package/dist/ui/inputs/ModelPicker.js.map

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

package/dist/ui/inputs/Picker.d.ts

@@ -0,0 +1,56 @@
+import { createElement as h, type ReactNode } from 'react';
+import { type Translate } from '../../utils/i18n.js';
+import { type PickerGroup, type PickerOption } from './picker-logic.js';
+export type { PickerGroup, PickerOption };
+export type PickerSize = 'sm' | 'md' | 'lg';
+export interface PickerProps {
+    /** 分组数据（模型选择里一组 = 一个 provider）。 */
+    groups?: PickerGroup[];
+    /** 扁平数据的快捷写法；与 `groups` 二选一。 */
+    options?: PickerOption[];
+    /** 受控值。给了它就是受控；不给就内部管（配 `defaultValue`）。 */
+    value?: string | string[];
+    /** 非受控模式下的初始值。 */
+    defaultValue?: string | string[];
+    onChange?: (value: string | string[]) => void;
+    mode?: 'single' | 'multiple';
+    /** 多选上限；到上限后其余选项置灰并提示（不静默截断）。 */
+    max?: number;
+    searchable?: boolean;
+    /** 单选时允许「不选」——选项列表顶部多一项清除。 */
+    clearable?: boolean;
+    placeholder?: string;
+    /** 候选可能不完整（宿主没接上服务之类）⇒ 如实告诉用户，不编造。 */
+    degraded?: boolean;
+    disabled?: boolean;
+    size?: PickerSize;
+    /** 菜单首选展开方向：靠近视口底部时传 `up`；实际会按可用空间自动翻转（flip）。 */
+    placement?: 'down' | 'up';
+    /** 选中后是否收起菜单；多选默认**不收起**（方便连续选）。 */
+    closeOnSelect?: boolean;
+    /** 触发器文字对齐：默认 `left`；`center` 只在确实需要居中的地方显式传（2026-10-20）。 */
+    align?: 'left' | 'center';
+    /** 多选时是否把已选项列在触发器上（默认列）。 */
+    showLabels?: boolean;
+    /** 触发器文字前的图标（任意 ReactNode；不传就没有这一段）。 */
+    icon?: ReactNode;
+    /** 问号提示文字：给了就在触发器后面挂标准 FieldHint（排版收进组件，调用方不再手动拼）。 */
+    hint?: string;
+    className?: string;
+    /** 定宽（px 或任意 CSS 长度）。给了即忽略 minWidth / maxWidth，触发器固定此宽，内容超长省略 + hover 跑马灯。 */
+    width?: number | string;
+    /** 最小宽（px 或任意 CSS 长度）；内容不到此宽时触发器也不会更窄（缺省沿用 CSS 的 120px）。 */
+    minWidth?: number | string;
+    /** 最大宽（px 或任意 CSS 长度）；内容超过此宽时省略 + hover 跑马灯。 */
+    maxWidth?: number | string;
+    ariaLabel?: string;
+    translate?: Translate;
+}
+/**
+ * 通用选择器：单选 / 多选 / 上限 / 搜索 / 分组 / 空态 / 降级。
+ *
+ * **纯零件，不自己取数** —— 选项由调用方传入（工作区列表、模型列表这类数据要跨 host↔client
+ * 边界，通道是插件私有的，组件取不到，见需求文档 §6）。
+ */
+export declare function Picker(props: PickerProps): ReturnType<typeof h>;
+//# sourceMappingURL=Picker.d.ts.map

package/dist/ui/inputs/Picker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Picker.d.ts","sourceRoot":"","sources":["../../../src/ui/inputs/Picker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,IAAI,CAAC,EAAqD,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAG7G,OAAO,EAAK,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAGvD,OAAO,EAOL,KAAK,WAAW,EAChB,KAAK,YAAY,EAClB,MAAM,mBAAmB,CAAA;AAO1B,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,CAAA;AAEzC,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;AAE3C,MAAM,WAAW,WAAW;IAC1B,mCAAmC;IACnC,MAAM,CAAC,EAAE,WAAW,EAAE,CAAA;IACtB,gCAAgC;IAChC,OAAO,CAAC,EAAE,YAAY,EAAE,CAAA;IACxB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IACzB,kBAAkB;IAClB,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IAChC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,IAAI,CAAA;IAC7C,IAAI,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAA;IAC5B,iCAAiC;IACjC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,8BAA8B;IAC9B,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,oCAAoC;IACpC,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAA;IACzB,4BAA4B;IAC5B,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,wCAAwC;IACxC,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACvB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC1B,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,SAAS,CAAA;CACtB;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAgR/D"}

package/dist/ui/inputs/Picker.js

@@ -0,0 +1,244 @@
+import { createElement as h, useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { useFloating, FloatingPortal, flip, shift, offset, autoUpdate, size as floatingSize } from '@floating-ui/react';
+import { Chevron } from '../infra/chevron.js';
+import { t } from '../../utils/i18n.js';
+import { FieldHint } from '../display/FieldHint.js';
+import { MarqueeText } from '../display/MarqueeText.js';
+import { filterGroups, flattenOptions, labelsOf, resolveTriggerSizing, toGroups, toggleValue, } from './picker-logic.js';
+import { ensureComponentStyles } from '../infra/css.js';
+import { useOverlayLocked } from '../infra/overlay.js';
+import { PANEL_CSS } from '../infra/panel-css.js';
+import { PICKER_CSS } from './picker-css.js';
+import { FIELD_CSS } from '../infra/controls-css.js';
+/**
+ * 通用选择器：单选 / 多选 / 上限 / 搜索 / 分组 / 空态 / 降级。
+ *
+ * **纯零件，不自己取数** —— 选项由调用方传入（工作区列表、模型列表这类数据要跨 host↔client
+ * 边界，通道是插件私有的，组件取不到，见需求文档 §6）。
+ */
+export function Picker(props) {
+    ensureComponentStyles('picker', PICKER_CSS);
+    // 下拉面板的表皮来自 panel.css 的 menu 档（2026-11-03 皮肤统一）：这里只留定位与滚动。
+    ensureComponentStyles('panel', PANEL_CSS);
+    ensureComponentStyles('field', FIELD_CSS);
+    const tt = props.translate ?? t;
+    const mode = props.mode ?? 'single';
+    const size = props.size ?? 'md';
+    const placement = props.placement ?? 'down';
+    const clearable = props.clearable === true;
+    const showLabels = props.showLabels !== false;
+    const triggerStyle = resolveTriggerSizing(props);
+    const groups = useMemo(() => toGroups(props.groups, props.options), [props.groups, props.options]);
+    const controlled = props.value !== undefined;
+    const [inner, setInner] = useState(() => toArray(props.defaultValue));
+    const selected = controlled
+        ? toArray(props.value)
+        : inner;
+    const emit = (next) => {
+        if (!controlled)
+            setInner(next);
+        props.onChange?.(mode === 'single' ? (next[0] ?? '') : next);
+    };
+    const [open, setOpen] = useState(false);
+    const [query, setQuery] = useState('');
+    const [active, setActive] = useState(-1);
+    const rootRef = useRef(null);
+    const searchRef = useRef(null);
+    // 浮层定位：portal 到 body + viewport 相对 + 滚动/缩放自动跟随 + 贴边自动翻转，
+    // 彻底避开祖先 overflow/transform 裁剪（核心缺陷修复）。宽度/最大高由 size 中间件内联设置。
+    const { refs, floatingStyles } = useFloating({
+        open,
+        onOpenChange: setOpen,
+        placement: placement === 'up' ? 'top-start' : 'bottom-start',
+        middleware: [
+            offset(4),
+            flip(),
+            shift({ padding: 8 }),
+            floatingSize({
+                apply({ elements, rects, availableWidth, availableHeight }) {
+                    Object.assign(elements.floating.style, {
+                        // 触发器可以限宽，菜单不能跟着限：至少与触发器同宽，随内容变宽，封顶 480 免得太夸张
+                        minWidth: `${rects.reference.width}px`,
+                        maxWidth: `${Math.min(480, availableWidth ?? 480)}px`,
+                        maxHeight: `${Math.max(80, Math.min(280, (availableHeight ?? 320) - 8))}px`,
+                    });
+                },
+            }),
+        ],
+        whileElementsMounted: autoUpdate,
+        strategy: 'fixed',
+    });
+    // 展开即聚焦搜索框（2026-10-20 用户：点开就能直接打字，不用再点一下）。
+    // 用回调 ref 在搜索框「真正挂载」时聚焦：菜单经 FloatingPortal 延后挂载，
+    // 普通 useEffect(open) 会在输入框还没挂上时跑（searchRef 仍为 null），导致失效。
+    const setSearchRef = useCallback((el) => {
+        searchRef.current = el;
+        if (el !== null && open)
+            el.focus();
+    }, [open]);
+    // 点外面收起（同时认 root 与浮层两个 DOM 子树：菜单 portal 到 body 后不在 root 内）
+    useEffect(() => {
+        if (!open)
+            return;
+        const onDown = (e) => {
+            const root = rootRef.current;
+            const floatingEl = refs.floating.current;
+            if (root?.contains(e.target) === true)
+                return;
+            if (floatingEl?.contains(e.target) === true)
+                return;
+            setOpen(false);
+        };
+        document.addEventListener('mousedown', onDown);
+        return () => document.removeEventListener('mousedown', onDown);
+    }, [open]);
+    // 外层浮层锁死就收起：菜单是 portal 到 body 的，不在面板的 inert 子树里，锁不住。
+    const overlayLocked = useOverlayLocked();
+    const off = props.disabled === true || overlayLocked;
+    useEffect(() => {
+        if (overlayLocked)
+            setOpen(false);
+    }, [overlayLocked]);
+    // 收起时清掉搜索词与键盘游标，别让下次打开带着上次的过滤条件
+    useEffect(() => {
+        if (open)
+            return;
+        setQuery('');
+        setActive(-1);
+    }, [open]);
+    const shown = filterGroups(groups, query);
+    const flat = flattenOptions(shown);
+    const atMax = mode === 'multiple' && props.max !== undefined && selected.length >= props.max;
+    const summary = selected.length === 0
+        ? (props.placeholder ?? tt('pickerPlaceholder'))
+        : mode === 'multiple' && !showLabels
+            ? tt('pickerSelected', { n: selected.length })
+            : labelsOf(groups, selected).join('、') || (props.placeholder ?? tt('pickerPlaceholder'));
+    const pick = (value) => {
+        if (mode === 'single') {
+            emit([value]);
+            setOpen(false);
+            return;
+        }
+        emit(toggleValue(selected, value, props.max));
+        if (props.closeOnSelect === true)
+            setOpen(false);
+    };
+    const clear = () => {
+        emit([]);
+        setOpen(false);
+    };
+    // 键盘可达：Esc 关、上下移、回车选（没有 aria 树那么全，但能用键盘走完一遍）
+    const onKeyDown = (e) => {
+        if (!open)
+            return;
+        if (e.key === 'Escape') {
+            setOpen(false);
+            return;
+        }
+        if (flat.length === 0)
+            return;
+        if (e.key === 'ArrowDown' || e.key === 'ArrowUp') {
+            e.preventDefault();
+            const dir = e.key === 'ArrowDown' ? 1 : -1;
+            setActive((cur) => (cur + dir + flat.length) % flat.length);
+            return;
+        }
+        if (e.key === 'Enter' && active >= 0) {
+            e.preventDefault();
+            const hit = flat[active];
+            if (hit !== undefined)
+                pick(hit.value);
+        }
+    };
+    // 触发器（右侧箭头 = 全站唯一的 Chevron，与官方 ⌄ 同形；ui 零官方依赖故自绘）。
+    const trigger = h('button', {
+        type: 'button',
+        'aria-label': props.ariaLabel,
+        'aria-expanded': open,
+        ref: refs.setReference,
+        className: `dshpc-picker__trigger dshpc-picker__trigger--${size}${props.align === 'center' ? ' dshpc-picker__trigger--center' : ''}`,
+        style: triggerStyle,
+        disabled: off,
+        onClick: () => {
+            if (!off)
+                setOpen(!open);
+        },
+    }, props.icon !== undefined && props.icon !== null
+        ? h('span', { className: 'dshpc-picker__icon' }, props.icon)
+        : null, 
+    // 文字吃掉剩余宽度并靠左（默认）；超长时外层省略号、hover 跑马灯（MarqueeText 自带）。
+    h(MarqueeText, { text: summary, className: 'dshpc-picker__label' }), h(Chevron, { size: 12, className: 'dshpc-picker__caret' }));
+    // hint 给了就把触发器与 FieldHint 包进同一行（间距/对齐收进组件）。
+    const triggerRow = props.hint === undefined
+        ? trigger
+        : h('span', { className: 'dshpc-fieldwrap dshpc-fieldwrap--inline' }, trigger, h(FieldHint, { text: props.hint }));
+    return h('div', {
+        className: `dshpc-picker${props.className === undefined ? '' : ` ${props.className}`}`,
+        ref: rootRef,
+        onKeyDown,
+    }, triggerRow, open
+        ? h(FloatingPortal, null, h('div', {
+            className: 'dshpc-panel dshpc-panel--menu dshpc-picker__menu',
+            ref: refs.setFloating,
+            style: floatingStyles,
+        }, props.degraded === true
+            ? h('div', { className: 'dshpc-picker__degraded' }, tt('pickerDegraded'))
+            : null, atMax ? h('div', { className: 'dshpc-picker__degraded' }, tt('pickerMaxReached', { n: props.max ?? 0 })) : null, props.searchable === true
+            ? h('input', {
+                ref: setSearchRef,
+                className: 'dshpc-picker__search',
+                placeholder: tt('pickerSearch'),
+                value: query,
+                onChange: (e) => setQuery(e.target.value),
+            })
+            : null, flat.length === 0 && groups.length === 0
+            ? h('div', { className: 'dshpc-picker__empty' }, tt('pickerEmpty'))
+            : flat.length === 0
+                ? h('div', { className: 'dshpc-picker__empty' }, tt('pickerNoMatch'))
+                : [
+                    clearable && mode === 'single' && selected.length > 0
+                        ? h('div', {
+                            key: '__clear__',
+                            className: 'dshpc-picker__option dshpc-picker__option--clear',
+                            onClick: clear,
+                        }, tt('pickerClear'))
+                        : null,
+                    ...shown.map((g) => h('div', { key: g.value || '_' }, g.label === ''
+                        ? null
+                        : h('div', { className: 'dshpc-picker__group-label' }, g.label), g.options.map((o) => {
+                        // 到上限后：未选项置灰，**已选项保持可点**（点了是取消，不是再加）。
+                        const blocked = o.disabled === true || (atMax && !selected.includes(o.value));
+                        const activeCls = [
+                            'dshpc-picker__option',
+                            selected.includes(o.value) ? 'dshpc-picker__option--active' : '',
+                            blocked ? 'dshpc-picker__option--disabled' : '',
+                        ]
+                            .filter((s) => s !== '')
+                            .join(' ');
+                        const idx = flat.indexOf(o);
+                        return h('div', {
+                            key: o.value,
+                            className: activeCls,
+                            'data-active': idx === active ? 'true' : undefined,
+                            onClick: () => {
+                                if (!blocked)
+                                    pick(o.value);
+                            },
+                        }, mode === 'multiple'
+                            ? h('span', { className: 'dshpc-picker__tick' }, selected.includes(o.value) ? '✓' : '')
+                            : null, o.icon !== undefined && o.icon !== null
+                            ? h('span', { className: 'dshpc-picker__option-icon' }, o.icon)
+                            : null, 
+                        // 选项文字超长时省略号 + hover 跑马灯（与触发器同一套逻辑），不把菜单撑出横向滚动条。
+                        h(MarqueeText, { text: o.label, className: 'dshpc-picker__option-label' }));
+                    }))),
+                ]))
+        : null);
+}
+function toArray(v) {
+    if (v === undefined)
+        return [];
+    return Array.isArray(v) ? [...v] : [v];
+}
+//# sourceMappingURL=Picker.js.map

package/dist/ui/inputs/Picker.js.map

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

package/dist/ui/inputs/Segmented.d.ts

@@ -0,0 +1,99 @@
+/**
+ * 分段控件（滑动块）—— **全站唯一实现**（L2 组件皮肤，P1）
+ *
+ * 它是「同一份结构 + 两个受控轴」的样板：
+ *  - `size`：`sm`(24) / `md`(28) / `lg`(32) —— **离散三档**，调用点**不许**自己写高度
+ *    （真不够用才允许在调用点本地覆盖 `--dshpc-control-h-*`，属例外而非常态）；
+ *  - `bordered`（默认 false）：最外再包一圈 1px 描边；总高与无框版逐像素一致
+ *    （border 由 padding 抵消），两种模式整行混排不跳高。
+ *
+ * 外观只有一套（灰底轨道 + 白色选中片，阴影来自宿主 elevation token）。
+ * 唯一的配色入口是 `tone`（2026-10-29）：传内置色名则由核心定底 / 字（两主题各自成立），
+ * 传 `{ bg, fg }` 则两个主题都用调用方这一对颜色。
+ * 2026-10-26 删掉 `variant` 轴（原 default / inset 两档在 CSS 里只差 1px 内距，
+ * 且 default 比 `size` 承诺矮 2px，下游照 demo 对图时反复查不出原因 —— 见 docs/design/style.md）。
+ *
+ * 用法：
+ *   // 单选
+ *   h(Segmented<'a' | 'b'>, { value: v, size: 'md', items: [{ value: 'a', label: '甲' }], onChange: setV })
+ *   // 多选（如星期）
+ *   h(Segmented<'1' | '2'>, { multiple: true, value: vs, items: [...], onChange: setVs })
+ *
+ * ⚠️ 不许在任何使用点就地写分段样式；要多一档高度 / 多一个外观 ⇒ 走
+ * docs/design/ui-style-guide.md §五 的流程（改基础层，一处改全站生效）。
+ */
+import type { ChipTone } from '../display/Chip.js';
+import { createElement as h, type CSSProperties, type ReactNode } from 'react';
+/** 一段（一个可选值）。 */
+export interface SegmentedItem<T extends string = string> {
+    /** 该段代表的值（唯一）。 */
+    value: T;
+    /** 段内文字（也接受任意节点；只有图标时可省略）。 */
+    label?: ReactNode;
+    /** 前置图标（官方图标组件 / 数组 / 调用方自绘节点均可）。 */
+    icon?: ReactNode;
+    /** 读屏名：只有图标、没有文字时给（缺省退回 tooltip）。 */
+    ariaLabel?: string;
+    /** 段内角标（如「异常 3」）；数字 ≤0 视为没东西可数、不显示，字符串原样显示（如 `'99+'`）。danger 红圆标。 */
+    badge?: number | string;
+    /** 段内中性计数（如筛选条「全部 11」）；口径同 badge，字符串照样显示（如 `'1K'`）。弱化灰字，不做角标。 */
+    count?: number | string;
+    /** 置灰不可点。 */
+    disabled?: boolean;
+    /** 段级悬停提示（核心 Tooltip 本体，官方气泡）：鼠标移入该项浮出书面化说明；需宿主注入 renderer。 */
+    tooltip?: string;
+}
+/**
+ * 选中片配色（默认 = 主题亮片，字跟主题走）：
+ *  - 内置色名（与 Chip 同一套）：底色 / 字色由核心定，深浅两个主题各自成立；
+ *  - `{ bg, fg }`：一组背景 + 一组文字，**两个主题都一样**（调用方自己负责对比度）。
+ */
+export type SegmentedTone = Exclude<ChipTone, 'neutral'> | {
+    bg: string;
+    fg: string;
+};
+interface SegmentedBaseProps<T extends string = string> {
+    /** 段定义。 */
+    items: readonly SegmentedItem<T>[];
+    /** 高度档（默认 lg = 32 标准行）。 */
+    size?: 'sm' | 'md' | 'lg';
+    /** 撑满父宽、各段等分。 */
+    block?: boolean;
+    /** 最外层 1px 描边框（默认 false）。总高与无框版逐像素一致。 */
+    bordered?: boolean;
+    /** 选中片配色（默认主题亮片）。见 {@link SegmentedTone}。 */
+    tone?: SegmentedTone;
+    /** 无障碍组名（读屏用）。 */
+    label?: string;
+    /** 根节点 id（锚点 / 自动化测试用）。 */
+    id?: string;
+    /** 追加到根节点的 class（只允许补布局，不许覆盖皮肤）。 */
+    className?: string;
+    /** 整组禁用（表单只读态用）。 */
+    disabled?: boolean;
+    /** 外层追加样式（只允许补布局，不许覆盖皮肤）。 */
+    style?: CSSProperties;
+}
+export interface SegmentedSingleProps<T extends string = string> extends SegmentedBaseProps<T> {
+    multiple?: false;
+    /** 当前选中值。 */
+    value: T;
+    onChange: (value: T) => void;
+}
+export interface SegmentedMultiProps<T extends string = string> extends SegmentedBaseProps<T> {
+    /** 多选模式（如星期）。 */
+    multiple: true;
+    /** 当前选中值集合。 */
+    value: T[];
+    onChange: (value: T[]) => void;
+}
+export type SegmentedProps<T extends string = string> = SegmentedSingleProps<T> | SegmentedMultiProps<T>;
+/**
+ * 渲染一个分段控件（单选 / 多选同体）。
+ *
+ * @param props 见 {@link SegmentedProps}。
+ * @returns 分段控件元素。
+ */
+export declare function Segmented<T extends string>(props: SegmentedProps<T>): ReturnType<typeof h>;
+export {};
+//# sourceMappingURL=Segmented.d.ts.map

package/dist/ui/inputs/Segmented.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Segmented.d.ts","sourceRoot":"","sources":["../../../src/ui/inputs/Segmented.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EACL,aAAa,IAAI,CAAC,EAKlB,KAAK,aAAa,EAClB,KAAK,SAAS,EACf,MAAM,OAAO,CAAA;AAwBd,iBAAiB;AACjB,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IACtD,kBAAkB;IAClB,KAAK,EAAE,CAAC,CAAA;IACR,8BAA8B;IAC9B,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,qCAAqC;IACrC,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACvB,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACvB,aAAa;IACb,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,QAAQ,EAAE,SAAS,CAAC,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAA;AAErF,UAAU,kBAAkB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IACpD,WAAW;IACX,KAAK,EAAE,SAAS,aAAa,CAAC,CAAC,CAAC,EAAE,CAAA;IAClC,2BAA2B;IAC3B,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;IACzB,iBAAiB;IACjB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,yCAAyC;IACzC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,6CAA6C;IAC7C,IAAI,CAAC,EAAE,aAAa,CAAA;IACpB,kBAAkB;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,2BAA2B;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,oBAAoB;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,6BAA6B;IAC7B,KAAK,CAAC,EAAE,aAAa,CAAA;CACtB;AAED,MAAM,WAAW,oBAAoB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAE,SAAQ,kBAAkB,CAAC,CAAC,CAAC;IAC5F,QAAQ,CAAC,EAAE,KAAK,CAAA;IAChB,aAAa;IACb,KAAK,EAAE,CAAC,CAAA;IACR,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAA;CAC7B;AAED,MAAM,WAAW,mBAAmB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAE,SAAQ,kBAAkB,CAAC,CAAC,CAAC;IAC3F,iBAAiB;IACjB,QAAQ,EAAE,IAAI,CAAA;IACd,eAAe;IACf,KAAK,EAAE,CAAC,EAAE,CAAA;IACV,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,IAAI,CAAA;CAC/B;AAED,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI,oBAAoB,CAAC,CAAC,CAAC,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAAA;AAExG;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAmH1F"}