@morlay/dsh-client-ui-primitives 0.0.6 → 0.0.8

package/README.md

@@ -1,9 +1,13 @@
 # @morlay/dsh-client-ui-primitives
 
-对话 UI 与设置页共用的**基础面**：**css-in-js 样式层**（`styled` / `Token` / `dsw`，消费官方主题注入的
-`--dsw-*`，源码可直接加载）、**引用解析与渲染转换**（host 与 client 共用唯一一份源码，
-[`@morlay/dsh-reference`](../../context/dsh-reference/README.md) 的引用展开复用 host 那半），以及**设置面原语**
-（从上游 fork 的暂存式表单原语，与按 schema 自动生成的行配置页）。
+对话 UI 与设置页共用的**基础面**：**上游那套样式**（每件组件一个 `*.module.css`，token 直接写
+`var(--dsw-*)`，与官方 `ui-primitives` 同一套技术栈）、**官方基础组件的统一出口**（`Button` / `Menu` / `Input` /
+`Tag` / `Modal` / `Switch` / `SettingsForm` / 图标 … 由本包 `export *` 转出，业务包只向本包取控件）、**布局原语**
+（`Stack` / `Row` / `Text`，间距 / 内距 / 文本档位集中在 `layout` 的档位表里）、**这套界面自有的控件**（字段行
+`SettingsFieldRow`、可搜索选择器 `SearchSelect`、模型路由清单 `ModelRouteList`、标签输入 `TagInput`、多行文本
+`MultilineField`、图标按钮 `IconButton`、按钮 `Button`、`Tabs` / `Spinner` / `Bubble` / `PopoverPanel` …）、
+**按 schema 自动生成的行配置页**，以及**引用解析与渲染转换**（host 与 client 共用唯一一份源码，
+[`@morlay/dsh-reference`](../../context/dsh-reference/README.md) 的引用展开复用 host 那半）。
 
 ## 用法
 
@@ -48,5 +52,26 @@ import { SettingsFormModel, settingsNumberField } from "@morlay/dsh-client-ui-pr
 const form = new SettingsFormModel(scope, [settingsNumberField("timeoutMs")]);
 ```
 
-装配：一行 insert（行 id `ui-primitives-fork`，各 bundle 都插同一行，同 id 重复插入由 Loader 幂等处理），见
-[`@morlay/better-session`](../../bundles/better-session/cordis.patch.yml) 的 patch。
+业务页面组设置面时，控件与字段摆位都从这里取（**业务层不写控件外观**；每个控件带稳定的 `data-role` 供样式、测试与
+自动化定位）：
+
+```tsx
+import {
+  IconButton, SearchSelect, SettingsFieldRow, TagInput,
+} from "@morlay/dsh-client-ui-primitives/client";
+
+<SettingsFieldRow label="允许的工具" hint="留空 = 不限制" divider layout="inline">
+  <TagInput
+    value={tools}
+    onChange={setTools}
+    placeholder="加一个后回车，或粘贴一串"
+    label="允许的工具"
+    removeLabel={(name) => `移除 ${name}`}
+  />
+</SettingsFieldRow>
+```
+
+装配：**不是装配行**——client 半随用到它的 client 行内联（清单里标 `dsh.client.inline`，devkit 因此不把它当
+模块表里的行外置），装配入口 `apply` 由那些行各自调用、按服务在场与否幂等去重；样式由构建期内联成
+"模块执行即注入 `<style>`"，同名 `<style data-plugin-css>` 只注入一份。
+取舍见 [ADR 基础面暂时内联而不是装配行](./.agents/adrs/20261001-暂时内联而不是装配行.md)。