@deepseek-ai/dsh-chunked-list 0.1.5-rc.2 → 0.1.6-alpha.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.i18n.yaml +1 -1
- package/README.zh.md +5 -5
- package/package.json +1 -1
package/README.i18n.yaml
CHANGED
|
@@ -3,4 +3,4 @@
|
|
|
3
3
|
# after editing either side, bring the other along and re-record with:
|
|
4
4
|
# pnpm run verify-translation-pairing --write packages/util/chunked-list/README.md
|
|
5
5
|
README.md: f0af89e5dd6cfdc6388fe90aaeaf2fb70b149827
|
|
6
|
-
README.zh.md:
|
|
6
|
+
README.zh.md: 429554742a19d275d494b00919720d05a7d09380
|
package/README.zh.md
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
description: "用于 projection state
|
|
2
|
+
description: "用于 projection state 的不可变的仅追加列表，提供有界追加复制、按插入顺序迭代和 Zod 检查点校验。"
|
|
3
3
|
kind: "package-library"
|
|
4
4
|
---
|
|
5
5
|
|
|
@@ -35,7 +35,7 @@ const second = appendChunkedList(first, 'second')
|
|
|
35
35
|
console.log([...iterateChunkedList(second)])
|
|
36
36
|
```
|
|
37
37
|
|
|
38
|
-
示例输出 `['first', 'second']`；`first` 仍只包含原来的值。`chunkedListSchema(valueSchema)` 校验 JSON
|
|
38
|
+
示例输出 `['first', 'second']`；`first` 仍只包含原来的值。`chunkedListSchema(valueSchema)` 校验 JSON 检查点并拒绝未知字段、无效值和空分片或超大分片。当外层字段也允许空列表时，在 schema 上使用 `.optional()`。各操作详见[源码约定](src/index.ts)。
|
|
39
39
|
|
|
40
40
|
-----
|
|
41
41
|
|
|
@@ -45,12 +45,12 @@ console.log([...iterateChunkedList(second)])
|
|
|
45
45
|
<details>
|
|
46
46
|
<summary>实现内部机制——点击展开</summary>
|
|
47
47
|
|
|
48
|
-
|
|
48
|
+
最新的分片最多存储 64 个值。追加最多复制该分片并共享较旧的节点，工作量为有界 O(1)。容量控制存储布局，不限制列表总长度。迭代以 O(N) 时间访问全部 N 个值，并使用 O(N / 64) 临时空间按从旧到新的顺序访问各分片。追加换片与递归 Zod 校验共用一个容量常量。
|
|
49
49
|
|
|
50
50
|
| 文件 | 职责 |
|
|
51
51
|
|---|---|
|
|
52
52
|
| [`src/index.ts`](src/index.ts) | 持久化列表操作与检查点校验 |
|
|
53
|
-
| [`tests/chunked-list.spec.ts`](tests/chunked-list.spec.ts) |
|
|
53
|
+
| [`tests/chunked-list.spec.ts`](tests/chunked-list.spec.ts) | 版本隔离、顺序、结构共享与检查点接受条件 |
|
|
54
54
|
|
|
55
55
|
此库没有独立变化的观测值，因此不发布运行时不变式伴随模块；其操作返回调用方拥有的不可变值。
|
|
56
56
|
|
|
@@ -62,7 +62,7 @@ console.log([...iterateChunkedList(second)])
|
|
|
62
62
|
## 进一步探索
|
|
63
63
|
|
|
64
64
|
- [工具包映射](../README.zh.md)——共享原语。
|
|
65
|
-
- [Subagent 目录决策](../../../.agents/notes/implemented/architecture/2026-09-01-parent-owned-subagent-catalog.zh.md)——projection state
|
|
65
|
+
- [Subagent 目录决策](../../../.agents/notes/implemented/architecture/2026-09-01-parent-owned-subagent-catalog.zh.md)——projection state 使用分片的原因。
|
|
66
66
|
|
|
67
67
|
-----
|
|
68
68
|
|
package/package.json
CHANGED