dsh-plugin-core 0.31.0 → 0.33.0

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"}

package/dist/ui/inputs/Segmented.js

@@ -0,0 +1,135 @@
+import { createElement as h, useCallback, useLayoutEffect, useRef, useState, } from 'react';
+import { getTooltipRenderer } from '../infra/tooltip.js';
+import { useOverlayLocked } from '../infra/overlay.js';
+import { ensureComponentStyles } from '../infra/css.js';
+import { SEGMENTED_CSS } from '../infra/controls-css.js';
+/**
+ * 角标 / 计数要不要显示，返回要显示的文本。
+ * 数字 ≤0 是「没东西可数」的老口径；字符串（`'1K'` / `'99+'`）由调用方决定，原样显示，空串不显示。
+ */
+function countText(value) {
+    if (value === undefined)
+        return null;
+    if (typeof value === 'number')
+        return value > 0 ? String(value) : null;
+    return value === '' ? null : value;
+}
+/**
+ * 渲染一个分段控件（单选 / 多选同体）。
+ *
+ * @param props 见 {@link SegmentedProps}。
+ * @returns 分段控件元素。
+ */
+export function Segmented(props) {
+    // 幂等：token 层 + 控件皮肤（首次渲染时挂上，之后是空转）
+    ensureComponentStyles('segmented', SEGMENTED_CSS);
+    ensureComponentStyles('segmented', SEGMENTED_CSS);
+    const size = props.size ?? 'lg';
+    const multiple = props.multiple === true;
+    // 外层浮层锁死 ⇒ 每一段都按自己的禁用态渲染（只做「或」，不写回 props）。
+    const locked = useOverlayLocked();
+    const value = props.value;
+    const onChange = props.onChange;
+    // 单选：选中底由一块共用「滑动块」承担，点选后从旧段滑到新段（多选每段各自着色，没有唯一滑块可滑）。
+    const sliding = !multiple && props.items.length > 1;
+    const rootRef = useRef(null);
+    const [thumb, setThumb] = useState(null);
+    // 量选中段的位置：容器 width 由内容决定，段宽又随文案 / 角标变，只能读一次布局。
+    const measure = useCallback(() => {
+        const sel = rootRef.current?.querySelector('.dshpc-seg__item[aria-pressed="true"]');
+        if (sel === undefined || sel === null) {
+            setThumb(null);
+            return;
+        }
+        const next = { left: sel.offsetLeft, top: sel.offsetTop, width: sel.offsetWidth, height: sel.offsetHeight };
+        // 尺寸没变就不 set，免得 ResizeObserver 与渲染互相打转。
+        setThumb((cur) => cur !== null && cur.left === next.left && cur.top === next.top && cur.width === next.width && cur.height === next.height
+            ? cur
+            : next);
+    }, []);
+    useLayoutEffect(() => {
+        if (!sliding) {
+            setThumb(null);
+            return;
+        }
+        measure();
+        const root = rootRef.current;
+        // 容器被布局改宽（block / 换行 / webfont 到位）时重测；首帧 thumb 是插入的新元素，不触发过渡。
+        if (root === null || typeof ResizeObserver === 'undefined')
+            return;
+        const ro = new ResizeObserver(measure);
+        ro.observe(root);
+        return () => ro.disconnect();
+    }, [sliding, measure, value, size, props.items, props.bordered, props.block]);
+    // 核心 Tooltip 渲染器（宿主启动注入官方 Tooltip；未注入则段级提示降级为无）。
+    const renderer = getTooltipRenderer();
+    // tone：内置色名走 CSS 类（底 / 字配对在 segmented.css，两主题各自成立）；
+    // 自定义一对颜色只能内联写根节点那两条局部变量（内联恒胜，两主题同值）。
+    const tone = props.tone;
+    const toneClass = typeof tone === 'string' ? ` dshpc-seg--tone-${tone}` : '';
+    const toneStyle = tone !== undefined && typeof tone !== 'string'
+        ? { '--seg-thumb': tone.bg, '--seg-on': tone.fg }
+        : undefined;
+    return h('div', {
+        role: 'group',
+        'aria-label': props.label,
+        id: props.id,
+        ref: rootRef,
+        // 结构一套、皮肤只在 controls-css 里；此处只拼「轴」类名，不写任何颜色 / 尺寸字面值。
+        className: `dshpc-seg dshpc-seg--${size}${sliding ? ' dshpc-seg--slide' : ''}${props.block === true ? ' dshpc-seg--block' : ''}${props.bordered === true ? ' dshpc-seg--bordered' : ''}${toneClass}${props.className !== undefined ? ` ${props.className}` : ''}`,
+        style: toneStyle === undefined ? props.style : { ...toneStyle, ...props.style },
+    }, [
+        sliding && thumb !== null
+            ? h('span', {
+                key: '__thumb__',
+                className: 'dshpc-seg__thumb',
+                'aria-hidden': true,
+                style: {
+                    left: `${String(thumb.left)}px`,
+                    top: `${String(thumb.top)}px`,
+                    width: `${String(thumb.width)}px`,
+                    height: `${String(thumb.height)}px`,
+                },
+            })
+            : null,
+        ...props.items.map(item => {
+            const on = multiple ? value.includes(item.value) : value === item.value;
+            const disabled = item.disabled === true || props.disabled === true || locked;
+            const handle = () => {
+                if (disabled)
+                    return;
+                if (multiple) {
+                    const arr = value;
+                    const next = arr.includes(item.value) ? arr.filter(v => v !== item.value) : [...arr, item.value];
+                    onChange(next);
+                }
+                else {
+                    ;
+                    onChange(item.value);
+                }
+            };
+            const count = countText(item.count);
+            const badge = countText(item.badge);
+            // 图标 / 文字 / 计数三者都没有文字内容时，这一段只有图标 ⇒ 要正方形（CSS 归零左右内距）。
+            const hasLabel = item.label !== undefined && item.label !== null && item.label !== '';
+            const hasIcon = item.icon !== undefined && item.icon !== null;
+            const iconOnly = hasIcon && !hasLabel && count === null && badge === null;
+            const itemButton = h('button', {
+                key: item.value,
+                type: 'button',
+                className: `dshpc-seg__item${iconOnly ? ' dshpc-seg__item--icon-only' : ''}`,
+                // 选中态用 aria-pressed 表达 ⇒ 读屏可读，皮肤也只认这一个选择器
+                'aria-pressed': on,
+                'aria-label': item.ariaLabel ?? (iconOnly ? item.tooltip : undefined),
+                disabled,
+                onClick: handle,
+            }, hasIcon ? h('span', { className: 'dshpc-seg__icon' }, item.icon) : null, hasLabel ? item.label : null, count === null ? null : h('span', { className: 'dshpc-seg__count' }, count), badge === null ? null : h('span', { className: 'dshpc-seg__badge' }, badge));
+            // 段级悬停提示：走注入的官方 Tooltip（与 FieldHint 同一条路），不破坏分段布局。
+            if (item.tooltip !== undefined && renderer !== undefined) {
+                return renderer({ label: item.tooltip, side: 'top', children: itemButton });
+            }
+            return itemButton;
+        }),
+    ]);
+}
+//# sourceMappingURL=Segmented.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Segmented.js","sourceRoot":"","sources":["../../../src/ui/inputs/Segmented.ts"],"names":[],"mappings":"AAyBA,OAAO,EACL,aAAa,IAAI,CAAC,EAClB,WAAW,EACX,eAAe,EACf,MAAM,EACN,QAAQ,GAGT,MAAM,OAAO,CAAA;AACd,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAA;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAExD;;;GAGG;AACH,SAAS,SAAS,CAAC,KAAkC;IACnD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAA;IACpC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IACtE,OAAO,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAA;AACpC,CAAC;AA6ED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAmB,KAAwB;IAClE,mCAAmC;IACnC,qBAAqB,CAAC,WAAW,EAAE,aAAa,CAAC,CAAA;IACjD,qBAAqB,CAAC,WAAW,EAAE,aAAa,CAAC,CAAA;IACjD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,IAAI,CAAA;IAC/B,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,KAAK,IAAI,CAAA;IACxC,2CAA2C;IAC3C,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAA;IACjC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAA;IACzB,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAA;IAC/B,oDAAoD;IACpD,MAAM,OAAO,GAAG,CAAC,QAAQ,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAA;IACnD,MAAM,OAAO,GAAG,MAAM,CAAwB,IAAI,CAAC,CAAA;IACnD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAmB,IAAI,CAAC,CAAA;IAE1D,+CAA+C;IAC/C,MAAM,OAAO,GAAG,WAAW,CAAC,GAAS,EAAE;QACrC,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,EAAE,aAAa,CAAc,uCAAuC,CAAC,CAAA;QAChG,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACtC,QAAQ,CAAC,IAAI,CAAC,CAAA;YACd,OAAM;QACR,CAAC;QACD,MAAM,IAAI,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC,UAAU,EAAE,GAAG,EAAE,GAAG,CAAC,SAAS,EAAE,KAAK,EAAE,GAAG,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,CAAC,YAAY,EAAE,CAAA;QAC3G,wCAAwC;QACxC,QAAQ,CAAC,CAAC,GAAG,EAAE,EAAE,CACf,GAAG,KAAK,IAAI,IAAI,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,GAAG,KAAK,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,IAAI,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM;YACtH,CAAC,CAAC,GAAG;YACL,CAAC,CAAC,IAAI,CACT,CAAA;IACH,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,eAAe,CAAC,GAAG,EAAE;QACnB,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,QAAQ,CAAC,IAAI,CAAC,CAAA;YACd,OAAM;QACR,CAAC;QACD,OAAO,EAAE,CAAA;QACT,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAA;QAC5B,8DAA8D;QAC9D,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,cAAc,KAAK,WAAW;YAAE,OAAM;QAClE,MAAM,EAAE,GAAG,IAAI,cAAc,CAAC,OAAO,CAAC,CAAA;QACtC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QAChB,OAAO,GAAG,EAAE,CAAC,EAAE,CAAC,UAAU,EAAE,CAAA;IAC9B,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAA;IAC7E,iDAAiD;IACjD,MAAM,QAAQ,GAAG,kBAAkB,EAAE,CAAA;IACrC,oDAAoD;IACpD,sCAAsC;IACtC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAA;IACvB,MAAM,SAAS,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,oBAAoB,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IAC5E,MAAM,SAAS,GAA8B,IAAI,KAAK,SAAS,IAAI,OAAO,IAAI,KAAK,QAAQ;QACzF,CAAC,CAAE,EAAE,aAAa,EAAE,IAAI,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,EAAoB;QACpE,CAAC,CAAC,SAAS,CAAA;IACb,OAAO,CAAC,CAAC,KAAK,EAAE;QACd,IAAI,EAAE,OAAO;QACb,YAAY,EAAE,KAAK,CAAC,KAAK;QACzB,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,GAAG,EAAE,OAAO;QACZ,qDAAqD;QACrD,SAAS,EAAE,wBAAwB,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,EAAE,GAAG,SAAS,GAAG,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;QACjQ,KAAK,EAAE,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,SAAS,EAAE,GAAG,KAAK,CAAC,KAAK,EAAE;KAChF,EAAE;QACD,OAAO,IAAI,KAAK,KAAK,IAAI;YACvB,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE;gBACR,GAAG,EAAE,WAAW;gBAChB,SAAS,EAAE,kBAAkB;gBAC7B,aAAa,EAAE,IAAI;gBACnB,KAAK,EAAE;oBACL,IAAI,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI;oBAC/B,GAAG,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI;oBAC7B,KAAK,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI;oBACjC,MAAM,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI;iBACpC;aACF,CAAC;YACJ,CAAC,CAAC,IAAI;QACR,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;YAC1B,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAE,KAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,CAAA;YAChF,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,KAAK,IAAI,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI,IAAI,MAAM,CAAA;YAC5E,MAAM,MAAM,GAAG,GAAS,EAAE;gBACxB,IAAI,QAAQ;oBAAE,OAAM;gBACpB,IAAI,QAAQ,EAAE,CAAC;oBACb,MAAM,GAAG,GAAG,KAAY,CAAA;oBACxB,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAC/F;oBAAC,QAA6B,CAAC,IAAI,CAAC,CAAA;gBACvC,CAAC;qBAAM,CAAC;oBACN,CAAC;oBAAC,QAA2B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;gBAC3C,CAAC;YACH,CAAC,CAAA;YACD,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YACnC,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YACnC,qDAAqD;YACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,IAAI,IAAI,CAAC,KAAK,KAAK,EAAE,CAAA;YACrF,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CAAA;YAC7D,MAAM,QAAQ,GAAG,OAAO,IAAI,CAAC,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,IAAI,CAAA;YACzE,MAAM,UAAU,GAAG,CAAC,CAAC,QAAQ,EAAE;gBAC7B,GAAG,EAAE,IAAI,CAAC,KAAK;gBACf,IAAI,EAAE,QAAQ;gBACd,SAAS,EAAE,kBAAkB,QAAQ,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC,EAAE,EAAE;gBAC5E,0CAA0C;gBAC1C,cAAc,EAAE,EAAE;gBAClB,YAAY,EAAE,IAAI,CAAC,SAAS,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;gBACrE,QAAQ;gBACR,OAAO,EAAE,MAAM;aAChB,EACC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,iBAAiB,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EACvE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAC5B,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,kBAAkB,EAAE,EAAE,KAAK,CAAC,EAC3E,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,kBAAkB,EAAE,EAAE,KAAK,CAAC,CAAC,CAAA;YAC9E,mDAAmD;YACnD,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBACzD,OAAO,QAAQ,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAA;YAC7E,CAAC;YACD,OAAO,UAAU,CAAA;QACjB,CAAC,CAAC;KACH,CAAC,CAAA;AACJ,CAAC"}

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

@@ -0,0 +1,36 @@
+/**
+ * 多行文本输入（P3 输入类家族唯一实现；皮肤见 controls-css.ts 的 `.dshpc-textarea`）。
+ *
+ * 以前提示词框是 `task-editor.tsx` 里手写的 `<textarea>` + 业务 CSS `.dshpc-ed-prompt`；
+ * 现上提为基础层件（U20 #6，2026-10-05），业务文件只 `import { Textarea }`。
+ */
+import { createElement as h, type CSSProperties } from 'react';
+export interface TextareaProps {
+    /** 当前值。 */
+    value: string;
+    /** 变更回调（原生 textarea value）。 */
+    onChange: (value: string) => void;
+    /** 占位。 */
+    placeholder?: string;
+    /** 校验不通过：描红盒。 */
+    error?: boolean;
+    /** 禁用。 */
+    disabled?: boolean;
+    /** 原生 id（用于 label 关联 / 锚点）。 */
+    id?: string;
+    /** 原生 rows（默认不传，靠 CSS min-height 撑开）。 */
+    rows?: number;
+    /** 拼写检查（默认关）。 */
+    spellCheck?: boolean;
+    /** 无障碍名。 */
+    'aria-label'?: string;
+    /** 追加 class。 */
+    className?: string;
+    /** 追加样式（只允许补布局）。 */
+    style?: CSSProperties;
+    /** 问号提示文字：给了就在输入框后面挂标准 FieldHint。 */
+    hint?: string;
+}
+/** 多行文本输入。 */
+export declare function Textarea(props: TextareaProps): ReturnType<typeof h>;
+//# sourceMappingURL=Textarea.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Textarea.d.ts","sourceRoot":"","sources":["../../../src/ui/inputs/Textarea.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,aAAa,IAAI,CAAC,EAAE,KAAK,aAAa,EAAE,MAAM,OAAO,CAAA;AAM9D,MAAM,WAAW,aAAa;IAC5B,WAAW;IACX,KAAK,EAAE,MAAM,CAAA;IACb,+BAA+B;IAC/B,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACjC,UAAU;IACV,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,iBAAiB;IACjB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,UAAU;IACV,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,+BAA+B;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,iBAAiB;IACjB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,YAAY;IACZ,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,gBAAgB;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,oBAAoB;IACpB,KAAK,CAAC,EAAE,aAAa,CAAA;IACrB,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,cAAc;AACd,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAoBnE"}

package/dist/ui/inputs/Textarea.js

@@ -0,0 +1,35 @@
+/**
+ * 多行文本输入（P3 输入类家族唯一实现；皮肤见 controls-css.ts 的 `.dshpc-textarea`）。
+ *
+ * 以前提示词框是 `task-editor.tsx` 里手写的 `<textarea>` + 业务 CSS `.dshpc-ed-prompt`；
+ * 现上提为基础层件（U20 #6，2026-10-05），业务文件只 `import { Textarea }`。
+ */
+import { createElement as h } from 'react';
+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';
+/** 多行文本输入。 */
+export function Textarea(props) {
+    ensureComponentStyles('field', FIELD_CSS);
+    const { value, onChange, placeholder, error, disabled, id, rows, spellCheck, className, style } = props;
+    // 锁定时按自己的禁用态渲染，只做「或」—— 不写回调用方的 disabled，解锁即还原。
+    const off = disabled === true || useOverlayLocked();
+    const box = h('textarea', {
+        id,
+        rows,
+        value,
+        placeholder,
+        disabled: off,
+        spellCheck: spellCheck === true,
+        'aria-label': props['aria-label'],
+        className: `dshpc-textarea${error === true ? ' dshpc-textarea--error' : ''}${className !== undefined && className !== '' ? ` ${className}` : ''}`,
+        style,
+        onChange: (event) => { onChange(event.target.value); },
+    });
+    // 多行的问号放**右下角**（2026-10-20 用户：不要垂直居中，那样像贴在中间的空白上）
+    if (props.hint === undefined)
+        return box;
+    return h('span', { className: 'dshpc-fieldwrap dshpc-fieldwrap--block' }, box, h(FieldHint, { text: props.hint }));
+}
+//# sourceMappingURL=Textarea.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Textarea.js","sourceRoot":"","sources":["../../../src/ui/inputs/Textarea.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,aAAa,IAAI,CAAC,EAAsB,MAAM,OAAO,CAAA;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAA;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AA6BpD,cAAc;AACd,MAAM,UAAU,QAAQ,CAAC,KAAoB;IAC3C,qBAAqB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;IACzC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,KAAK,CAAA;IACvG,+CAA+C;IAC/C,MAAM,GAAG,GAAG,QAAQ,KAAK,IAAI,IAAI,gBAAgB,EAAE,CAAA;IACnD,MAAM,GAAG,GAAG,CAAC,CAAC,UAAU,EAAE;QACxB,EAAE;QACF,IAAI;QACJ,KAAK;QACL,WAAW;QACX,QAAQ,EAAE,GAAG;QACb,UAAU,EAAE,UAAU,KAAK,IAAI;QAC/B,YAAY,EAAE,KAAK,CAAC,YAAY,CAAC;QACjC,SAAS,EAAE,iBAAiB,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,EAAE,GAAG,SAAS,KAAK,SAAS,IAAI,SAAS,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;QACjJ,KAAK;QACL,QAAQ,EAAE,CAAC,KAAoC,EAAE,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA,CAAC,CAAC;KAC5E,CAAC,CAAA;IACX,kDAAkD;IAClD,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,GAAG,CAAA;IACxC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,wCAAwC,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;AACpH,CAAC"}

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

@@ -0,0 +1,35 @@
+import { createElement as h, type ReactNode } from 'react';
+import { type PickerSize } from './Picker.js';
+import { type Translate } from '../../utils/i18n.js';
+export interface WorkspacePickerProps {
+    value?: string | string[];
+    defaultValue?: string | string[];
+    mode?: 'single' | 'multiple';
+    max?: number;
+    onChange?: (value: string | string[]) => void;
+    /**
+     * 是否提供「所有工作区」默认项（**默认提供**；只在单选形态下出现）：
+     * 选中即发 `''` —— 表示不筛，是否当「全部」由消费方自己处理。
+     */
+    allowDefault?: boolean;
+    /** 「所有工作区」的文案（默认取内置字典）。 */
+    defaultLabel?: string;
+    /** 允许「不选」。 */
+    clearable?: boolean;
+    /** 下拉内搜索框（默认关；要就传 true）。 */
+    searchable?: boolean;
+    disabled?: boolean;
+    size?: PickerSize;
+    placement?: 'down' | 'up';
+    className?: string;
+    /** 未选时的文字（默认「工作区」；想叫「选择工作区」就传它）。 */
+    placeholder?: string;
+    /** 触发器前置图标：不传 = 默认文件夹；传 `null` = 不显示；传元素 = 自定义。 */
+    icon?: ReactNode | null;
+    /** 问号提示文字（传了才显示）。 */
+    hint?: string;
+    translate?: Translate;
+}
+/** 选工作区（交互全管：单选 / 多选 / 上限 / 空态；数据自动来自宿主工作区快照）。 */
+export declare function WorkspacePicker(props: WorkspacePickerProps): ReturnType<typeof h>;
+//# sourceMappingURL=WorkspacePicker.d.ts.map