doxum 0.1.4 → 0.1.5

package/dist/integration.d.cts

@@ -1,4 +1,4 @@
-import { Dt as ImpactTarget, H as DocumentReader, o as DocumentReadable, xt as DocumentSchema } from "./contract-D8kjdfqT.cjs";
+import { Ot as ImpactTarget, V as DocumentReader, o as DocumentReadable, xt as DocumentSchema } from "./contract-uYJTmT8o.cjs";
 
 //#region core/src/integration.d.ts
 type TrackedSelection<TValue> = {

package/dist/integration.d.ts

@@ -1,4 +1,4 @@
-import { Dt as ImpactTarget, H as DocumentReader, o as DocumentReadable, xt as DocumentSchema } from "./contract-BsY1XLiG.js";
+import { Ot as ImpactTarget, V as DocumentReader, o as DocumentReadable, xt as DocumentSchema } from "./contract-4E3moCbY.js";
 
 //#region core/src/integration.d.ts
 type TrackedSelection<TValue> = {

package/dist/local-sync.d.cts

@@ -1,4 +1,4 @@
-import { c as DocumentRuntime, xt as DocumentSchema } from "./contract-D8kjdfqT.cjs";
+import { c as DocumentRuntime, xt as DocumentSchema } from "./contract-uYJTmT8o.cjs";
 
 //#region core/src/local-sync/json.d.ts
 type JsonPrimitive = null | boolean | number | string;

package/dist/local-sync.d.ts

@@ -1,4 +1,4 @@
-import { c as DocumentRuntime, xt as DocumentSchema } from "./contract-BsY1XLiG.js";
+import { c as DocumentRuntime, xt as DocumentSchema } from "./contract-4E3moCbY.js";
 
 //#region core/src/local-sync/json.d.ts
 type JsonPrimitive = null | boolean | number | string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "doxum",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "private": false,
   "license": "MIT",
   "description": "Doxum is a typed runtime for complex mutable documents.",

package/skills/doxum-runtime/references/guide.en.md

@@ -163,6 +163,11 @@ the same API except `move`, because it is unordered. Lists offer `insert`,
 specified in the schema. See [patterns.en.md](patterns.en.md) for complete
 collection and tree examples.
 
+Optional field, variant, dict, list, and tree writers expose `clear()`. Optional
+structured leaves can also be initialized from an absent state with `replace()`.
+Optional objects, tables, and maps have no whole-value clear; modify them through
+their child writers or collection operations.
+
 ## Replay operations at the boundary
 
 Use `apply` for operation batches that came from persistence, a network

package/skills/doxum-runtime/references/guide.zh-CN.md

@@ -135,6 +135,10 @@ runtime.update(tx => {
 
 table 支持 `create`、`item`、`remove` 和 `move`。map 与之相同，但没有 `move`，因为它无顺序。list 支持 `insert`、`move`、`remove` 与 `replace`；其身份来自 schema 中的 `keyOf`。完整的集合与 tree 模式见 [patterns.zh-CN.md](patterns.zh-CN.md)。
 
+optional 的 field、variant、dict、list 和 tree writer 提供 `clear()`；其中结构化叶子也可
+在当前缺失时直接调用 `replace()` 建立值。optional object、table 和 map 没有整体 clear，
+应通过子 writer 或集合操作修改。
+
 ## 在边界回放 operation
 
 来自持久化、网络适配器或其他外部边界的 operation batch 应通过 `apply` 回放。Doxum 会在 mutation code 看到数据前解码未知 operation payload，按 schema 解析每个地址，并原子地执行整个 batch。

package/skills/doxum-runtime/references/patterns.en.md

@@ -24,6 +24,13 @@ array of ids: that creates two mutation protocols and two sources of order.
 Use a list only when every item has a stable, unique application key; never use
 the current index as `keyOf`.
 
+Entry readers and writers for tables and maps are derived directly from the entry
+schema node. Structured entries retain their specialized tree, list, dict, or
+variant access instead of being reconstructed from runtime values into a broad
+object union. Optional fields and optional variant, dict, list, and tree leaves
+also expose `clear()` and can be initialized from an absent state with
+`replace()`; objects, tables, and maps keep their child or collection operations.
+
 ```ts
 import { field, list, map, object, schema, table, tree } from 'doxum';
 

package/skills/doxum-runtime/references/patterns.zh-CN.md

@@ -19,6 +19,12 @@
 
 当顺序对产品可见时使用 table。不要用 map 加另一份 ids array 表示顺序：这会产生两套 mutation protocol 和两个顺序来源。list 只适合每个条目都有稳定、唯一应用 key 的情形；不能把当前 index 当作 `keyOf`。
 
+table/map 的 entry reader 与 writer 直接由 entry schema node 推导。结构化 entry 会保留
+自己的 tree、list、dict、variant 等专用 access，而不会从运行时 value 反推成普通对象或
+产生 value union。optional field 以及 optional 的 variant、dict、list、tree 结构叶子额外
+提供 `clear()`，并可在缺失状态通过 `replace()` 初始化；object、table、map 仍使用各自的
+子 writer 或集合操作。
+
 ```ts
 import { field, list, map, object, schema, table, tree } from 'doxum';