dsh-plugin-core 0.31.0 → 0.33.0

package/dist/ui/inputs/Field.js

@@ -0,0 +1,175 @@
+/**
+ * 输入类控件 —— **全站唯一实现**（L2 组件皮肤，P3）
+ *
+ * - `Input`：文本输入（size sm 24 / md 28 / lg 32，error 描红）；
+ * - `PrefixedInput`：前缀 + 文本输入（如路径 / 接口前缀）；
+ * - `NumberInput`：数字步进（显式 `− / +`，替换原生 `<input type="number">` 的浏览器 spinner，
+ *   支持 step / min / max、clamp、Enter 提交、失焦回弹）。
+ *
+ * 高度一律吃 `--dshpc-control-h-*`；有边 / 无边同高（边框在内部补回）。
+ */
+import { createElement as h, useEffect, useState } from 'react';
+import { IconButton } from '../actions/Button.js';
+import { FieldHint } from '../display/FieldHint.js';
+import { useOverlayLocked } from '../infra/overlay.js';
+import { ensureComponentStyles } from '../infra/css.js';
+import { FIELD_CSS } from '../infra/controls-css.js';
+import { t } from '../../utils/i18n.js';
+/**
+ * 字段 hint 的统一包法：控件 + 问号提示同一行（间距/对齐收进组件，调用方传个
+ * `hint` 字符串就行，不再手动拼排版 —— 用户 2026-10-20 拍板）。
+ */
+export function withHint(control, hint) {
+    if (hint === undefined)
+        return control;
+    return h('span', { className: 'dshpc-fieldwrap' }, control, h(FieldHint, { text: hint }));
+}
+function sizeClass(size) {
+    return size === 'lg' ? '--lg' : size === 'md' ? '--md' : '--sm';
+}
+/** 文本输入。默认铺满容器（width:100%，与 Textarea 同口径）；要定宽由调用方在外面包壳（如 192px 搜索槽）。 */
+export function Input(props) {
+    ensureComponentStyles('field', FIELD_CSS);
+    const { value, onChange, placeholder, size = 'lg', error, disabled, type, icon, className, style } = props;
+    // 外层浮层锁死：按自己的禁用态渲染，只做「或」—— 不写回调用方的 disabled。
+    const locked = useOverlayLocked();
+    const off = disabled === true || locked;
+    const [focused, setFocused] = useState(false);
+    // 搜索框的清空钮：只在「有焦点 + 有内容」时出现。原生 ::-webkit-search-cancel-button 由壳的 CSS 隐掉，
+    // 换成与 NumberInput 加减号同款的 plain IconButton（2026-10-28 用户：原生那个不好看）。
+    const search = type === 'search';
+    const showClear = search && value !== '' && focused && !off;
+    const input = h('input', {
+        ref: props.inputRef,
+        type: type ?? 'text',
+        value,
+        placeholder,
+        disabled: off,
+        'aria-label': props['aria-label'],
+        title: props.title,
+        className: `dshpc-input dshpc-input${sizeClass(size)}${error === true ? ' dshpc-input--error' : ''}${className !== undefined && className !== '' ? ` ${className}` : ''}`,
+        style,
+        onChange: (event) => { onChange(event.target.value); },
+        onKeyDown: props.onKeyDown,
+        onFocus: () => { setFocused(true); },
+        onBlur: () => { setFocused(false); if (props.onBlur !== undefined)
+            props.onBlur(); },
+    });
+    // 定位壳：图标槽和清空钮都得有个壳挂（两样都没有时 DOM 不变，className / style / ref 仍落在 <input> 上）。
+    const hasIcon = icon !== undefined && icon !== null;
+    if (!hasIcon && !search)
+        return withHint(input, props.hint);
+    return withHint(h('span', { className: `dshpc-iwrap dshpc-iwrap${sizeClass(size)}${showClear ? ' dshpc-iwrap--clear' : ''}` }, hasIcon ? h('span', { className: 'dshpc-iwrap__icon' }, icon) : null, input, 
+    // 只在 mousedown 上拦焦点：不拦的话 input 先 blur ⇒ 按钮被卸掉 ⇒ 随后的 click 落空。
+    showClear
+        ? h(IconButton, {
+            className: 'dshpc-iwrap__clear', variant: 'plain', size, icon: '×', label: t('fieldClear'),
+            onMouseDown: (event) => { event.preventDefault(); },
+            onClick: () => { onChange(''); },
+        })
+        : null), props.hint);
+}
+/** 前缀 + 文本输入。 */
+export function PrefixedInput(props) {
+    ensureComponentStyles('field', FIELD_CSS);
+    const { prefix, value, onChange, placeholder, size = 'lg', error, disabled, type, className, style } = props;
+    const locked = useOverlayLocked();
+    const off = disabled === true || locked;
+    return h('div', {
+        className: `dshpc-pfx dshpc-pfx${sizeClass(size)}${error === true ? ' dshpc-pfx--error' : ''}${className !== undefined && className !== '' ? ` ${className}` : ''}`,
+        style,
+    }, h('span', { className: 'dshpc-pfx__label' }, prefix), h('input', {
+        type: type ?? 'text',
+        value,
+        placeholder,
+        disabled: off,
+        'aria-label': props['aria-label'],
+        title: props.title,
+        className: 'dshpc-pfx__input',
+        onChange: (event) => { onChange(event.target.value); },
+    }));
+}
+/**
+ * 数字步进输入：显式 `− / +` 按钮 + 可输入数字。
+ *
+ * @param props 见 {@link NumberInputProps}。
+ * @returns 数字步进控件。
+ */
+export function NumberInput(props) {
+    ensureComponentStyles('field', FIELD_CSS);
+    const { value, onChange, min = -Infinity, max = Infinity, step = 1, size = 'lg', inputWidth, disabled, suffix, label, decreaseLabel = t('fieldDecrease'), increaseLabel = t('fieldIncrease'), className, style, } = props;
+    const locked = useOverlayLocked();
+    const off = disabled === true || locked;
+    const [text, setText] = useState(String(value));
+    // 外部值变化（如切档位重置）时同步回输入框。
+    useEffect(() => { setText(String(value)); }, [value]);
+    const clamp = (n) => Math.min(max, Math.max(min, n));
+    const commit = (raw) => {
+        // ⚠️ 空串按「输入无效」回弹，**不能**当成 0（2026-10-08 真机 bug：`Number('') === 0` ⇒
+        // 用户按 Delete 把数字删空后失焦，值被 clamp 成 min，看起来就是「按 Delete 不管用」）。
+        if (raw.trim() === '') {
+            setText(String(value));
+            return;
+        }
+        const n = Number(raw);
+        if (!Number.isFinite(n)) {
+            setText(String(value));
+            return;
+        }
+        const next = clamp(n);
+        setText(String(next));
+        if (next !== value)
+            onChange(next);
+    };
+    const bump = (dir) => {
+        const base = Number.isFinite(Number(text)) ? Number(text) : value;
+        const next = clamp(base + dir * step);
+        setText(String(next));
+        if (next !== value)
+            onChange(next);
+    };
+    return withHint(h('div', {
+        className: `dshpc-num dshpc-num${sizeClass(size)}${off ? ' dshpc-num--disabled' : ''}${className !== undefined && className !== '' ? ` ${className}` : ''}`,
+        style,
+    }, h(IconButton, { variant: 'plain', size, icon: '−', label: decreaseLabel, disabled: off, onClick: () => { bump(-1); } }), 
+    // 中段（数字 + 后缀）成组居中：消费端把宽度拉大时，「−」钉最左、「+」钉最右、数字组始终居中
+    // （用户 2026-10-18：加减号必须在最左 / 最右，宽度由消费端调）。
+    h('span', { className: 'dshpc-num__mid' }, h('input', {
+        className: 'dshpc-num__input',
+        ...(inputWidth === undefined ? {} : { style: { width: `${inputWidth}px` } }),
+        value: text,
+        disabled: off,
+        inputMode: 'numeric',
+        'aria-label': label,
+        onChange: (event) => { setText(event.target.value); },
+        onBlur: () => { commit(text); },
+        onKeyDown: (event) => { if (event.key === 'Enter')
+            commit(text); },
+    }), suffix !== undefined ? h('span', { className: 'dshpc-num__suffix' }, suffix) : null), h(IconButton, { variant: 'plain', size, icon: '+', label: increaseLabel, disabled: off, onClick: () => { bump(1); } })), props.hint);
+}
+/**
+ * 下拉锚点的统一样式（**全站唯一一份**）：`SelectField` 与 `TaskPicker` 共用 —— 两者是同一类锚点，
+ * 不许各抄一份（2026-10-04 评审：TaskPicker 曾抄第二/第三份，观感会持续漂移）。
+ */
+export const FIELD_ANCHOR_STYLE = {
+    display: 'inline-flex', alignItems: 'center', gap: '6px', height: 'var(--dshpc-control-h-lg)', boxSizing: 'border-box',
+    minWidth: 0, maxWidth: '100%', padding: '0 var(--dshpc-space-2)',
+    border: '0.5px solid var(--dshpc-border-heavy)', borderRadius: 'var(--dshpc-radius-md)', background: 'var(--dshpc-surface-1)',
+    color: 'var(--dshpc-fg)', font: 'inherit', fontSize: 'var(--dshpc-font-md)', lineHeight: 'var(--dshpc-line-md)', cursor: 'pointer',
+    transition: 'background var(--dshpc-dur-fast) var(--dshpc-ease), color var(--dshpc-dur-fast) var(--dshpc-ease), border-color var(--dshpc-dur-fast) var(--dshpc-ease)',
+};
+/** 下拉锚点里那行文字（省略号三件套收敛到 `.dshpc-ellipsis`，见 ui-style-guide §三 待抽象 #1）。 */
+export const FIELD_LABEL_STYLE = {
+    flex: '1 1 auto', minWidth: 0, textAlign: 'left',
+};
+/** 尺寸档 → 锚点几何（高度 / 字号 / 行高 / 图标 / 间距）。**翻译只此一处**，下拉类控件共用。 */
+export function fieldMetricsOf(size) {
+    return {
+        height: size === 'sm' ? 'var(--dshpc-control-h-sm)' : size === 'md' ? 'var(--dshpc-control-h-md)' : 'var(--dshpc-control-h-lg)',
+        font: size === 'sm' ? 'var(--dshpc-font-sm)' : 'var(--dshpc-font-md)',
+        line: size === 'sm' ? 'var(--dshpc-line-sm)' : 'var(--dshpc-line-md)',
+        icon: size === 'sm' ? 14 : 16,
+        gap: size === 'sm' ? 'var(--dshpc-space-1)' : '6px',
+    };
+}
+//# sourceMappingURL=Field.js.map

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

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

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

@@ -0,0 +1,91 @@
+/**
+ * 组合输入框 —— 输入框 + 后置按钮组（+ 可选前置标题）焊成一体（L2 组件皮肤，P3）
+ *
+ * 外观与 {@link SplitGroup} 同一套口径：外框 / 圆角 / 相邻 1px 分隔 / 整体聚焦圈都由外壳画，
+ * 内件（Input、Button、IconButton）把自己的边框、圆角、外圈交出来。区别只有一条：
+ * **这里持状态** —— 输入值受控于调用方，提交点与撤销栈在控件内部。
+ *
+ * 用法：
+ *   h(InputGroup, {
+ *     label: '任务名', value, onChange: setValue, undoable: true,
+ *     actions: [
+ *       { label: '返回', variant: 'ghost', onClick: () => close() },
+ *       { label: '确定', variant: 'primary', onClick: save },
+ *     ],
+ *   })
+ *
+ * 撤销口径：Enter / 失焦 / 点任一动作 = 一次提交，把提交前的值压栈；点撤销弹回栈顶。
+ * 父级直接改 `value`（如外部清空）不算编辑，不进栈。
+ */
+import { createElement as h, type CSSProperties, type ReactNode } from 'react';
+import { type ButtonVariant } from '../actions/Button.js';
+import { type FieldSize } from './Field.js';
+/** 后置按钮：只给 icon = 纯图标钮（正方形）；给 label = 文字钮；两个都给 = 图标 + 文字。 */
+export interface InputGroupAction {
+    /** 图标（任意 ReactNode）。 */
+    icon?: ReactNode;
+    /** 文案。不给且没图标 ⇒ 不渲染。 */
+    label?: string;
+    /**
+     * 外观档（默认 `info`）。要语义色就直接传这一档 —— `success` / `info` / `warning` / `danger`
+     * 都是 Button 现成的档，不是另外调色（用户 2026-11-02 定：别自造颜色，用这几档语义色，主要 success 与 info）。
+     */
+    variant?: ButtonVariant;
+    /** 单钮禁用。 */
+    disabled?: boolean;
+    /** 定宽（px 或任意 CSS 宽度值）；loading 转圈会把按钮撑宽并挤到输入框，定宽后不跳。 */
+    width?: number | string;
+    /**
+     * loading 时是否保留按钮文案（默认 true）。传 `false`：loading 期间清文字、
+     * 锁在「有文案」的宽度上、只留一枚居中的圈（见 `Button.loadingText`）。
+     */
+    loadingText?: boolean;
+    /** 无障碍名：只有图标时必给（否则读屏只知道「按钮」）。 */
+    ariaLabel?: string;
+    /** 点击。**返回 Promise 时按钮自动转圈禁用**（同 Button / IconButton）。 */
+    onClick: () => unknown;
+}
+export interface InputGroupProps {
+    /** 当前值。 */
+    value: string;
+    /** 变更回调。 */
+    onChange: (value: string) => void;
+    /** 前置标题：与输入框同格、灰底，和控件是一体的。 */
+    label?: string;
+    /** 占位。 */
+    placeholder?: string;
+    /** 高度档（默认 lg）。 */
+    size?: FieldSize;
+    /** 自定义高度（px）：给了就压过 size 档。 */
+    height?: number;
+    /** 校验不通过：整组描红。 */
+    error?: boolean;
+    /** 禁用整组。 */
+    disabled?: boolean;
+    /** 后置按钮，顺序即布局顺序；一枚或多枚都行（如「返回」+「确定」）。 */
+    actions?: InputGroupAction[];
+    /** 开启撤销：按钮组最前面多一枚撤销钮，回到上一次提交前的值。 */
+    undoable?: boolean;
+    /** 撤销钮的无障碍名（默认「撤销」）。 */
+    undoLabel?: string;
+    /** Enter 提交回调（提交点之一，撤销栈照记）。 */
+    onSubmit?: (value: string) => void;
+    /** 无障碍名（整组 role=group）。 */
+    'aria-label'?: string;
+    /** 根节点 id。 */
+    id?: string;
+    /** 追加 class（只补布局，不覆盖皮肤）。 */
+    className?: string;
+    /** 追加样式（只补布局）。 */
+    style?: CSSProperties;
+    /** 问号提示文字：给了就在整组后面挂标准 FieldHint。 */
+    hint?: string;
+}
+/**
+ * 渲染一个「输入框 + 按钮组」组合控件。
+ *
+ * @param props 见 {@link InputGroupProps}。
+ * @returns 组合控件元素。
+ */
+export declare function InputGroup(props: InputGroupProps): ReturnType<typeof h>;
+//# sourceMappingURL=InputGroup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"InputGroup.d.ts","sourceRoot":"","sources":["../../../src/ui/inputs/InputGroup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,aAAa,IAAI,CAAC,EAAoB,KAAK,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAChG,OAAO,EAAsB,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAC7E,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,YAAY,CAAA;AAK5D,6DAA6D;AAC7D,MAAM,WAAW,gBAAgB;IAC/B,wBAAwB;IACxB,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,uBAAuB;IACvB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;OAGG;IACH,OAAO,CAAC,EAAE,aAAa,CAAA;IACvB,YAAY;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACvB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,0DAA0D;IAC1D,OAAO,EAAE,MAAM,OAAO,CAAA;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW;IACX,KAAK,EAAE,MAAM,CAAA;IACb,YAAY;IACZ,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACjC,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU;IACV,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,kBAAkB;IAClB,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,8BAA8B;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,kBAAkB;IAClB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,YAAY;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,wCAAwC;IACxC,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAA;IAC5B,oCAAoC;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,wBAAwB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAClC,2BAA2B;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,cAAc;IACd,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,kBAAkB;IAClB,KAAK,CAAC,EAAE,aAAa,CAAA;IACrB,oCAAoC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CA4FvE"}

package/dist/ui/inputs/InputGroup.js

@@ -0,0 +1,125 @@
+/**
+ * 组合输入框 —— 输入框 + 后置按钮组（+ 可选前置标题）焊成一体（L2 组件皮肤，P3）
+ *
+ * 外观与 {@link SplitGroup} 同一套口径：外框 / 圆角 / 相邻 1px 分隔 / 整体聚焦圈都由外壳画，
+ * 内件（Input、Button、IconButton）把自己的边框、圆角、外圈交出来。区别只有一条：
+ * **这里持状态** —— 输入值受控于调用方，提交点与撤销栈在控件内部。
+ *
+ * 用法：
+ *   h(InputGroup, {
+ *     label: '任务名', value, onChange: setValue, undoable: true,
+ *     actions: [
+ *       { label: '返回', variant: 'ghost', onClick: () => close() },
+ *       { label: '确定', variant: 'primary', onClick: save },
+ *     ],
+ *   })
+ *
+ * 撤销口径：Enter / 失焦 / 点任一动作 = 一次提交，把提交前的值压栈；点撤销弹回栈顶。
+ * 父级直接改 `value`（如外部清空）不算编辑，不进栈。
+ */
+import { createElement as h, useRef, useState } from 'react';
+import { Button, IconButton } from '../actions/Button.js';
+import { Input, withHint } from './Field.js';
+import { ensureComponentStyles } from '../infra/css.js';
+import { BUTTON_CSS, FIELD_CSS, INPUT_GROUP_CSS } from '../infra/controls-css.js';
+import { t } from '../../utils/i18n.js';
+/**
+ * 渲染一个「输入框 + 按钮组」组合控件。
+ *
+ * @param props 见 {@link InputGroupProps}。
+ * @returns 组合控件元素。
+ */
+export function InputGroup(props) {
+    ensureComponentStyles('input-group', INPUT_GROUP_CSS);
+    ensureComponentStyles('field', FIELD_CSS);
+    ensureComponentStyles('button', BUTTON_CSS);
+    const { value, onChange, label, placeholder, size = 'lg', height, error, disabled, actions = [], undoable = false, undoLabel = t('inputUndo'), onSubmit, } = props;
+    const committed = useRef(value);
+    const [undoStack, setUndoStack] = useState([]);
+    const commit = () => {
+        if (value === committed.current)
+            return;
+        const prev = committed.current;
+        committed.current = value;
+        setUndoStack((stack) => [...stack, prev]);
+    };
+    const undo = () => {
+        const prev = undoStack[undoStack.length - 1];
+        if (prev === undefined)
+            return;
+        setUndoStack((stack) => stack.slice(0, -1));
+        committed.current = prev;
+        onChange(prev);
+    };
+    const nodes = [];
+    if (label !== undefined)
+        nodes.push(h('span', { key: 'label', className: 'dshpc-igroup__label' }, label));
+    nodes.push(h(Input, {
+        key: 'input',
+        value,
+        onChange,
+        placeholder,
+        size,
+        disabled,
+        'aria-label': props['aria-label'],
+        onBlur: commit,
+        onKeyDown: (event) => {
+            if (event.key !== 'Enter')
+                return;
+            event.preventDefault();
+            commit();
+            if (onSubmit !== undefined)
+                onSubmit(value);
+        },
+    }));
+    if (undoable) {
+        nodes.push(h(IconButton, {
+            key: 'undo',
+            variant: 'plain',
+            size,
+            icon: '↶',
+            label: undoLabel,
+            disabled: disabled === true || undoStack.length === 0,
+            onClick: undo,
+        }));
+    }
+    actions.forEach((action, i) => {
+        if (action.label === undefined && (action.icon === undefined || action.icon === null))
+            return;
+        // 必须把返回值透出去：Button / IconButton 靠「返回值是不是 Promise」决定要不要转圈
+        const run = () => { commit(); return action.onClick(); };
+        const off = disabled === true || action.disabled === true;
+        const onlyIcon = action.label === undefined;
+        nodes.push(onlyIcon
+            ? h(IconButton, {
+                key: `action-${String(i)}`,
+                variant: 'plain',
+                size,
+                icon: action.icon,
+                label: action.ariaLabel ?? t('inputAction'),
+                disabled: off,
+                onClick: run,
+            })
+            : h(Button, {
+                key: `action-${String(i)}`,
+                variant: action.variant ?? 'info',
+                size,
+                icon: action.icon,
+                width: action.width,
+                loadingText: action.loadingText,
+                disabled: off,
+                onClick: run,
+            }, action.label));
+    });
+    const className = `dshpc-igroup dshpc-igroup--${size}`
+        + `${error === true ? ' dshpc-igroup--error' : ''}`
+        + `${props.className !== undefined && props.className !== '' ? ` ${props.className}` : ''}`;
+    return withHint(h('div', {
+        role: 'group',
+        'aria-label': props['aria-label'] ?? label,
+        id: props.id,
+        className,
+        style: height === undefined ? props.style : { height, ...props.style },
+    }, nodes), props.hint);
+}
+//# sourceMappingURL=InputGroup.js.map

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

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

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