@morlay/dsh-client-ui-primitives 0.0.7 → 0.0.9

package/README.md

@@ -1,9 +1,12 @@
 # @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 与设置页共用的**基础面**：上游那套样式、官方基础组件的统一出口（`Button` / `Menu` / `Input` / `Modal` /
+`Switch` / `SettingsForm` / 图标 …）、布局原语（`Stack` / `Row` / `Text`）、这套界面自有的控件（字段行 / 可搜索
+选择器 / 标签输入 / 图标按钮 …）、按 schema 自动生成的行配置页，以及引用解析与渲染（host 与 client 共用唯一一份
+源码，[`@morlay/dsh-reference`](../../context/dsh-reference/README.md) 的引用展开复用 host 那半）。
+
+样式与控件的写法约束见[规范 how-to-write](./.agents/standards/how-to-write.md)；schema 表单、字段槽与装配形态的
+机制见[设计 按 schema 自动生成行配置表单与字段槽注入](./.agents/designs/20260924-schema自动生成行配置表单与字段槽注入.md)。
 
 ## 用法
 
@@ -21,7 +24,7 @@ export const Config = z.object({
 ```
 
 ```tsx
-// 想给某个字段换控件或只改文案：注册 chain 槽（select 返回 null 才是不认领）
+// 想给某个字段换控件或只改文案：注册 chain 槽
 import {
   SchemaFieldDefault,
   type SchemaFieldComponentProps,
@@ -40,7 +43,7 @@ ctx.slots.inject("settings.schema-form.field", () =>
 );
 ```
 
-设置表单原语是暂存式的：控件只上报用户输入，`save` 是唯一写盘点。
+设置表单原语：
 
 ```ts
 import { SettingsFormModel, settingsNumberField } from "@morlay/dsh-client-ui-primitives/client";
@@ -48,6 +51,26 @@ import { SettingsFormModel, settingsNumberField } from "@morlay/dsh-client-ui-pr
 const form = new SettingsFormModel(scope, [settingsNumberField("timeoutMs")]);
 ```
 
-装配：**不是装配行**——client 半随用到它的 client 行内联（清单里标 `dsh.client.inline`，devkit 因此不把它当
-模块表里的行外置），装配入口 `apply` 由那些行各自调用、按服务在场与否幂等去重；`styling` 单例跨副本共享一份。
-取舍见 [ADR 基础面暂时内联而不是装配行](./.agents/adrs/20261001-暂时内联而不是装配行.md)。
+业务页面组设置面时，控件与字段摆位都从这里取：
+
+```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 行内联，`apply` 由那些行各自调用、幂等去重。取舍见
+[ADR 基础面暂时内联而不是装配行](./.agents/adrs/20261001-暂时内联而不是装配行.md)。