@qilin-agent/client-ui-primitives 3.1.3 → 3.1.4

package/README.i18n.yaml

@@ -5,57 +5,57 @@
 /:
   en: b6701ad9280c43fb
   zh: bc1ed7854daac92e
-/qilin-client-ui-primitives:
-  en: caf20e08acd7dd2d
-  zh: a7a39f64482c32c0
-/qilin-client-ui-primitives/summary:
-  en: 74ba153bb28603a7
-  zh: f8b36ccf7e7ef2f8
-/qilin-client-ui-primitives/table-of-contents:
+/qilin-agent-client-ui-primitives:
+  en: 77c8b257195e8d1c
+  zh: e14d896c8f1374c2
+/qilin-agent-client-ui-primitives/summary:
+  en: cb45feeda688bec7
+  zh: bf5480fcaafc640e
+/qilin-agent-client-ui-primitives/table-of-contents:
   en: d152484eb41ac6b4
   zh: 09388d293f9be9cb
-/qilin-client-ui-primitives/use-this-package:
-  en: 9f8ec1ebc498b846
-  zh: 530b7a8eea6225a0
-/qilin-client-ui-primitives/use-this-package/component-catalog:
-  en: 1d9aa7cce776f16d
-  zh: 457ec4cab4fcca77
-/qilin-client-ui-primitives/use-this-package/controls-and-icons:
+/qilin-agent-client-ui-primitives/use-this-package:
+  en: ca3db95551971b07
+  zh: 083ba0e187ce544a
+/qilin-agent-client-ui-primitives/use-this-package/component-catalog:
+  en: 070f2305cb51f06d
+  zh: a5cbfdded55ec641
+/qilin-agent-client-ui-primitives/use-this-package/controls-and-icons:
   en: 219d402939f9c314
   zh: 3460e90d2e1c46df
-/qilin-client-ui-primitives/use-this-package/rendering-agent-output:
+/qilin-agent-client-ui-primitives/use-this-package/rendering-agent-output:
   en: 7aac8d4af442ee84
   zh: 484000023a699d59
-/qilin-client-ui-primitives/use-this-package/localizing-copy:
+/qilin-agent-client-ui-primitives/use-this-package/localizing-copy:
   en: 4aef65dea11de083
   zh: abc22cd7c65cdf38
-/qilin-client-ui-primitives/understand-the-implementation:
-  en: af4de4fc13d9f533
-  zh: 2927f1bd7d057ff9
-/qilin-client-ui-primitives/understand-the-implementation/source-map:
-  en: 7402d419c8f10f9a
-  zh: 551111cd47d929f1
-/qilin-client-ui-primitives/understand-the-implementation/input-modality:
+/qilin-agent-client-ui-primitives/understand-the-implementation:
+  en: ff71d06c5d21ac81
+  zh: f5739d0e28e73552
+/qilin-agent-client-ui-primitives/understand-the-implementation/source-map:
+  en: 5b8a88c0706a7c1c
+  zh: a3dcbfabffe4e5ec
+/qilin-agent-client-ui-primitives/understand-the-implementation/input-modality:
   en: 44dfc06332ca3b5b
   zh: 94df10cde37c18e6
-/qilin-client-ui-primitives/understand-the-implementation/streaming-markdown:
+/qilin-agent-client-ui-primitives/understand-the-implementation/streaming-markdown:
   en: 8bbfa14c27f3bfd7
   zh: 88f7548ac3a114e1
-/qilin-client-ui-primitives/understand-the-implementation/geometry-and-overflow:
-  en: 9b34b50a635532bc
-  zh: 8ea629e1ce951979
-/qilin-client-ui-primitives/further-exploration:
-  en: 684db5291d944d66
-  zh: 22a4538704d13d37
-/qilin-client-ui-primitives/model-experience:
+/qilin-agent-client-ui-primitives/understand-the-implementation/geometry-and-overflow:
+  en: 64cddabf7d398df4
+  zh: 0aad27f39486db06
+/qilin-agent-client-ui-primitives/further-exploration:
+  en: 1ef5e5fdbe3d2436
+  zh: af5cb7ace2ab6e64
+/qilin-agent-client-ui-primitives/model-experience:
   en: 3120df665299c634
   zh: 1d9f365d091d0d2a
-/qilin-client-ui-primitives/model-experience/kv-cache-effect:
+/qilin-agent-client-ui-primitives/model-experience/kv-cache-effect:
   en: ca75c51c89c2c9b0
   zh: de54f3467ef3b9be
-/qilin-client-ui-primitives/known-limitations-and-deferred-work:
-  en: 9fc810886181885e
-  zh: 3d001c4bf816a62d
-/qilin-client-ui-primitives/known-limitations-and-deferred-work/dev-note:
+/qilin-agent-client-ui-primitives/known-limitations-and-deferred-work:
+  en: de2ce8b129329ea0
+  zh: 53465e4a8255748a
+/qilin-agent-client-ui-primitives/known-limitations-and-deferred-work/dev-note:
   en: e67f633dc6fe7773
   zh: 3bb0c20c93f16f98

package/README.md

@@ -48,6 +48,7 @@ Check this table before writing a control in a feature package. A plugin cannot
 | `StateDot` | Status mark: `done`, `warning`, `ongoing`, `error`, or `idle`. `aria-hidden`, so the render site owns the name. |
 | `ConnectionIndicator` | Inline connection-recovery control across outage, retry, and recovered states. |
 | `DisclosureRow` | 24px compact disclosure that lays title and content side by side. |
+| `CommandText` | One command line, gaining a Tab stop, a group role, and its accessible name only while it overflows horizontally. |
 | `Modal` | Centered dialog over a page mask. |
 | `RiskConfirmation` | Sensitive action gated behind an explicit checkbox. |
 | `OnboardingSurface` | First-run stage that holds the application root inert. |
@@ -58,6 +59,7 @@ Check this table before writing a control in a feature package. A plugin cannot
 | `JsonTree`, `JsonBlock` | Read-only JSON inspection. |
 | `MarkdownText`, `MarkdownDelegateProvider`, `CodeBlock` | Untrusted GFM with TeX math, Mermaid diagrams, owner-delegated HTTP(S) navigation, and highlighted code. `CodeBlock` accepts opt-in `lineNumbers`; copied source excludes the gutter, and `contentRef` exposes its stable source wrapper to an owner that uses it as a scrollport. Set `showHeader={false}` when the owner supplies its own language and copy toolbar. |
 | `TerminalBlock`, `ReadBlock`, `DiffBlock`, `SearchBlock`, `WebBlock` | The agent-output card matching each tool-result intent. |
+| `SettingsForm`, `SettingsValueField`, `SettingsSecretField` | Staged configuration form over `SettingsFormModel`: fields report what the reader typed, and its save is the single point where a draft becomes a document mutation. |
 | `icons/*`, `QilinSeal`, `ReferenceIcon`, `LinkIcon` | Glyphs and brand marks. Use `LinkIcon` for 14px clickable-link categories and known-site marks. |
 | `FileTypeIcon`, `classifyFileType`, `fileExtension` | A category-colored 28px file or folder glyph and the shared case-insensitive filename mapping behind it. Code and configuration files use detailed full-color technology glyphs; use `LinkIcon` for link-leading glyphs and image previews for image content. |
 
@@ -109,6 +111,8 @@ The package enforces one separation: presentational React atoms with zero Kylin
 | [`src/index.ts`](src/index.ts) | Public atom exports |
 | [`src/markdown/`](src/markdown/) | Markdown and math pipeline: micromark parsing, KaTeX typesetting, incremental streaming renderer, `CodeBlock`/`JsonBlock` |
 | [`src/TerminalBlock.tsx`](src/TerminalBlock.tsx) | ANSI escape parsing (`anser`) and terminal card rendering |
+| [`src/CommandText.tsx`](src/CommandText.tsx) | One command line's horizontal scrollport and its overflow-only accessible name |
+| [`src/settings-form/`](src/settings-form/) | Staged configuration form, its field controls, and the draft/write model behind them |
 | [`src/ReadBlock.tsx`](src/ReadBlock.tsx) / [`src/DiffBlock.tsx`](src/DiffBlock.tsx) | Read and diff cards |
 | [`src/SearchBlock.tsx`](src/SearchBlock.tsx) / [`src/WebBlock.tsx`](src/WebBlock.tsx) | Search and web-retrieval cards |
 | [`src/icons/`](src/icons/) | `ic_ds_*` glyph components and brand marks |
@@ -126,7 +130,7 @@ While a reply streams, `MarkdownText` parses incrementally: all but the trailing
 
 ### Geometry and overflow
 
-The output cards share one geometry model: `white-space: pre` with horizontal scrolling so column-aligned content keeps its alignment, and a head-plus-tail slice behind an expand button past `maxLines` (default 16) so a long body never stretches the card. `TerminalBlock` parses ANSI into React spans with a per-line column buffer for cursor movement, honoring erase-in-line, tab stops, and character width.
+The output cards share one geometry model: `white-space: pre` with horizontal scrolling so column-aligned content keeps its alignment, and a head-plus-tail slice behind an expand button past `maxLines` (default 16) so a long body never stretches the card. `TerminalBlock` uses `CommandText` to keep each authored command line selectable and horizontally scrollable; the prompt and status stay fixed. Only horizontally overflowing text enters the Tab order as a named group, using the owner's localized `commandLine(line)` label. `TerminalBlock` parses ANSI into React spans with a per-line column buffer for cursor movement, honoring erase-in-line, tab stops, and character width.
 
 </details>
 
@@ -164,6 +168,8 @@ These limits define how the atoms behave at the edges; they are current package
 - **Diff search is bounded, input processing is linear** — the edit-distance limit trades precise alignment for a coarse replacement on heavily changed fragments. Normalization, fallback rows, and copied output still scale with input size; the height cap limits visible rows, not those allocations.
 - **Known-site marks are a fixed list** — only the named hosts resolve to their own mark, and every other external host keeps the globe; recognizing an arbitrary site would require fetching its icon over the network.
 - **Streaming defers cross-boundary reference resolution** — a reference-style link or footnote whose definition sits on the other side of the incremental freeze boundary renders as literal text while the reply streams; the settled full parse at finalize resolves it.
+- **Overlong lines stay uncolored** — a source line of 1,000 or more UTF-16 units renders as one plain run in every highlighted surface, because TextMate scanning cost grows superlinearly with line length and a single generated line can otherwise block the page for seconds. The grammar state skips that line, so a comment or template literal that opens or closes on it mis-colors the following line.
+
 - **A long highlighted fence retains its complete token DOM** — streaming avoids re-parsing, re-tokenizing, and reconciling the completed prefix, but it does not discard old colors or virtualize token spans. Final DOM cardinality therefore still follows the fence's token count; nested/container fences and a pathological single long line remain on the general tail path.
 - **Glyph-level icons are redrawn approximations** — the fish logo and the sparkle mark come from font glyphs whose vector geometry is not exportable from the local design data; hand-authored recreations stand in until an exact export path exists.
 - **`Pill` and `Input` have no design source** — both atoms are self-defined; the sidebar search field and view-tab strip that resemble them are consumer-owned compositions, not these atoms.

package/README.zh.md

@@ -48,6 +48,7 @@ kind: "package-library"
 | `StateDot` | 状态标记：`done`、`warning`、`ongoing`、`error` 或 `idle`。它是 `aria-hidden` 的，名称由渲染点提供。 |
 | `ConnectionIndicator` | 行内连接恢复控件，覆盖断线、重试与已恢复三种状态。 |
 | `DisclosureRow` | 24px 紧凑折叠行，标题与内容左右排列。 |
+| `CommandText` | 一行命令文本：仅在横向溢出时才获得 Tab 停靠、group 角色与可访问名。 |
 | `Modal` | 页面遮罩之上的居中对话框。 |
 | `RiskConfirmation` | 以显式复选框把关的敏感操作确认。 |
 | `OnboardingSurface` | 首次运行的引导舞台，期间保持应用根节点 inert。 |
@@ -58,6 +59,7 @@ kind: "package-library"
 | `JsonTree`、`JsonBlock` | 只读 JSON 查看。 |
 | `MarkdownText`、`MarkdownDelegateProvider`、`CodeBlock` | 不可信 GFM 与 TeX 数学、owner 委托的 HTTP(S) 导航，以及高亮代码。`CodeBlock` 可通过 `lineNumbers` 开启行号；复制的源码不含行号栏，`contentRef` 则向需要把稳定源码包装节点用作滚动区的 owner 提供该节点。调用方提供自己的语言与复制工具栏时，设置 `showHeader={false}`。 |
 | `TerminalBlock`、`ReadBlock`、`DiffBlock`、`SearchBlock`、`WebBlock` | 与各类工具结果意图对应的 agent 输出卡片。 |
+| `SettingsForm`、`SettingsValueField`、`SettingsSecretField` | 基于 `SettingsFormModel` 的分阶段配置表单：字段如实报告读者输入，保存是草稿变成文档变更的唯一入口。 |
 | `icons/*`、`QilinSeal`、`ReferenceIcon`、`LinkIcon` | 字形与品牌标识。`LinkIcon` 用于 14px 的可点击链接分类及已知站点标记。 |
 | `FileTypeIcon`、`classifyFileType`、`fileExtension` | 按类别着色的 28px 文件或文件夹图形，以及它背后共享的不区分大小写文件名映射。代码与配置文件使用细分的全彩技术图形；链接前置图形使用 `LinkIcon`，图片内容使用图片预览。 |
 
@@ -109,6 +111,8 @@ kind: "package-library"
 | [`src/index.ts`](src/index.ts) | 原子组件公开导出 |
 | [`src/markdown/`](src/markdown/) | Markdown 与数学公式流水线：micromark 解析、KaTeX 排版、增量流式渲染器、`CodeBlock`/`JsonBlock` |
 | [`src/TerminalBlock.tsx`](src/TerminalBlock.tsx) | ANSI 转义解析（`anser`）与终端卡片渲染 |
+| [`src/CommandText.tsx`](src/CommandText.tsx) | 单行命令的横向滚动区，以及仅在溢出时出现的可访问名 |
+| [`src/settings-form/`](src/settings-form/) | 分阶段配置表单、其字段控件，以及背后的草稿/写入模型 |
 | [`src/ReadBlock.tsx`](src/ReadBlock.tsx) / [`src/DiffBlock.tsx`](src/DiffBlock.tsx) | 读取与差异卡片 |
 | [`src/SearchBlock.tsx`](src/SearchBlock.tsx) / [`src/WebBlock.tsx`](src/WebBlock.tsx) | 搜索与网页检索卡片 |
 | [`src/icons/`](src/icons/) | `ic_ds_*` 字形组件与品牌标记 |
@@ -126,7 +130,7 @@ kind: "package-library"
 
 ### 几何与溢出
 
-输出卡片共享同一套几何模型：`white-space: pre` 并横向滚动，让按列对齐的内容保持对齐；超过 `maxLines`（默认 16）时折叠为头部切片加尾部切片，由展开按钮控制，长正文不会撑高卡片。`TerminalBlock` 把 ANSI 解析为 React span，并带逐行列缓冲处理光标移动，遵循行内擦除、制表位与字符宽度。
+输出卡片共享同一套几何模型：`white-space: pre` 并横向滚动，让按列对齐的内容保持对齐；超过 `maxLines`（默认 16）时折叠为头部切片加尾部切片，由展开按钮控制，长正文不会撑高卡片。`TerminalBlock` 用 `CommandText` 让每条作者写的命令行都可选中、可横向滚动；提示符与状态保持固定。只有横向溢出的文本才以具名 group 进入 Tab 顺序，名称取自 owner 本地化的 `commandLine(line)`。`TerminalBlock` 把 ANSI 解析为 React span，并带逐行列缓冲处理光标移动，遵循行内擦除、制表位与字符宽度。
 
 </details>
 
@@ -164,6 +168,8 @@ kind: "package-library"
 - **Diff 搜索有上限，输入处理仍为线性**：编辑距离上限使大量改动的片段采用粗粒度替换，不再精确对齐。规范化、回退行及复制内容仍随输入大小增长；高度限制只约束可见行数，不限制这些分配。
 - **已知站点标记是固定列表**：只有列名的主机解析为自己的标记，其余外部主机仍使用地球；要识别任意站点需要通过网络抓取它的图标。
 - **流式期间跨边界引用解析被推迟**：定义落在增量冻结边界另一侧的引用式链接或脚注，在回复流式输出期间渲染为字面文本；定稿时的全量解析会将其解析。
+- **超长行不着色**：1,000 个 UTF-16 单元及以上的源码行在所有高亮面中渲染为单个纯文本 run，因为 TextMate 的扫描成本随行长超线性增长，一条生成出来的长行足以阻塞页面数秒。语法状态会跳过该行，因此在其上开启或结束的注释或模板字符串会让下一行着色错误。
+
 - **长高亮 fence 会保留完整 token DOM**：流式路径避免重新解析、重新 tokenize 和 reconcile 已完成前缀，但不会丢弃旧颜色或虚拟化 token span。因此最终 DOM 数量仍随 fence 的 token 数增长；嵌套／容器内 fence 与病态的单个超长行仍走通用尾部路径。
 - **字形级图标是重新绘制的近似版本**：鱼形标志与闪光标记来自字体字形，而本地设计数据无法导出其矢量几何；在获得精确导出路径前，使用手工重建版本代替。
 - **`Pill` 与 `Input` 没有设计来源**：两个原子组件均自行定义；与其相似的侧边栏搜索字段和视图标签条由消费方组合，不是这些原子组件。

package/lib/CommandText.module.css

@@ -0,0 +1,12 @@
+.text {
+  display: block;
+  min-width: 0;
+  overflow-x: auto;
+  white-space: var(--qilin-command-whitespace, pre);
+  overflow-wrap: anywhere;
+}
+
+.text:focus-visible {
+  outline: var(--qilin-focus-ring-width) solid var(--qilin-focus-ring-color, var(--qilin-alias-state-business-primary));
+  outline-offset: -2px;
+}

package/lib/MenuSurface.module.css

@@ -23,7 +23,7 @@
   inset: 0;
   z-index: -1;
   border-radius: inherit;
-  background: var(--qilin-menu-surface-fill);
+  background: var(--qilin-menu-surface-fill, var(--qilin-specific-menu, var(--qilin-alias-bg-layer-2)));
   backdrop-filter: var(--qilin-menu-backdrop-filter);
   pointer-events: none;
 }