dsh-worktree-groups 0.0.0-stage → 0.1.0
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/LICENSE +21 -0
- package/README.md +168 -2
- package/cordis.patch.yml +17 -0
- package/icon.svg +20 -0
- package/lib/activity.d.ts +78 -0
- package/lib/activity.d.ts.map +1 -0
- package/lib/activity.js +241 -0
- package/lib/activity.js.map +1 -0
- package/lib/client.d.ts +78 -0
- package/lib/client.d.ts.map +1 -0
- package/lib/client.js +4280 -0
- package/lib/git.d.ts +109 -0
- package/lib/git.d.ts.map +1 -0
- package/lib/git.js +317 -0
- package/lib/git.js.map +1 -0
- package/lib/icons.d.ts +148 -0
- package/lib/icons.d.ts.map +1 -0
- package/lib/icons.js +144 -0
- package/lib/icons.js.map +1 -0
- package/lib/index.d.ts +32 -0
- package/lib/index.d.ts.map +1 -0
- package/lib/index.js +47 -0
- package/lib/index.js.map +1 -0
- package/lib/ledger.d.ts +97 -0
- package/lib/ledger.d.ts.map +1 -0
- package/lib/ledger.js +276 -0
- package/lib/ledger.js.map +1 -0
- package/lib/live-merge.d.ts +44 -0
- package/lib/live-merge.d.ts.map +1 -0
- package/lib/live-merge.js +227 -0
- package/lib/live-merge.js.map +1 -0
- package/lib/live-state.d.ts +158 -0
- package/lib/live-state.d.ts.map +1 -0
- package/lib/live-state.js +281 -0
- package/lib/live-state.js.map +1 -0
- package/lib/locales.d.ts +71 -0
- package/lib/locales.d.ts.map +1 -0
- package/lib/locales.js +199 -0
- package/lib/locales.js.map +1 -0
- package/lib/projects.d.ts +88 -0
- package/lib/projects.d.ts.map +1 -0
- package/lib/projects.js +418 -0
- package/lib/projects.js.map +1 -0
- package/lib/routes.d.ts +376 -0
- package/lib/routes.d.ts.map +1 -0
- package/lib/routes.js +1875 -0
- package/lib/routes.js.map +1 -0
- package/lib/row-memo.d.ts +34 -0
- package/lib/row-memo.d.ts.map +1 -0
- package/lib/row-memo.js +46 -0
- package/lib/row-memo.js.map +1 -0
- package/lib/sidebar.d.ts +126 -0
- package/lib/sidebar.d.ts.map +1 -0
- package/lib/tree-model.d.ts +1226 -0
- package/lib/tree-model.d.ts.map +1 -0
- package/lib/tree-model.js +2143 -0
- package/lib/tree-model.js.map +1 -0
- package/lib/types.d.ts +98 -0
- package/lib/types.d.ts.map +1 -0
- package/lib/types.js +8 -0
- package/lib/types.js.map +1 -0
- package/locale/en.json +6 -0
- package/locale/zh.json +6 -0
- package/package.json +88 -4
|
@@ -0,0 +1,281 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 会话行的**客户端 live fact**:等待确认(琥珀)与后台完成未读(绿点)。
|
|
3
|
+
*
|
|
4
|
+
* ## 为什么单独成一个纯逻辑模块
|
|
5
|
+
*
|
|
6
|
+
* 这两个态**只能**从客户端快照取 —— 宿主 HTTP 面(`SessionSummary` 的
|
|
7
|
+
* `summarizeCold` / `summaryFor` / `listFields`)根本没有这两个字段。而客户端的取法
|
|
8
|
+
* 随宿主版本变化过两次,把它从 `sidebar.tsx` 抽出来,才能用 `node --test` 直接覆盖
|
|
9
|
+
* (`.tsx` 不进 `lib/`,无法单测)。
|
|
10
|
+
*
|
|
11
|
+
* ## 宿主事实(2026-10-19 核实,Desktop 2.0.18 / `@deepseek-ai/*@0.2.1-rc.2`)
|
|
12
|
+
*
|
|
13
|
+
* | 状态 | `0.1.5-rc.2` 的取法 | `0.2.1-rc.2` 的取法 |
|
|
14
|
+
* |---|---|---|
|
|
15
|
+
* | 等待确认 | root hook `useSessionPendingInteraction` → `Map<id, interaction>` | **该 source 已删除**;改由 `useSessionStatus` 提供 |
|
|
16
|
+
* | 后台完成未读 | `useSessions().byId[id].completed` | **该字段已删除**;改由 `useSessionStatus` 的 `completionUnread` |
|
|
17
|
+
*
|
|
18
|
+
* `useSessionStatus` 的快照形状(`dsh-client-ui-session/lib/client.js` 的
|
|
19
|
+
* `publishStatus()`):
|
|
20
|
+
*
|
|
21
|
+
* ```js
|
|
22
|
+
* new Map<SessionId, {
|
|
23
|
+
* running: boolean,
|
|
24
|
+
* pendingInteraction: { kind: 'approval' | 'plan-review' | 'question' | <其它> } | undefined,
|
|
25
|
+
* completionUnread: boolean,
|
|
26
|
+
* }>()
|
|
27
|
+
* ```
|
|
28
|
+
*
|
|
29
|
+
* ## 契约
|
|
30
|
+
*
|
|
31
|
+
* 1. **新源优先**:`status` 有该会话的数据就用它,旧取法不再覆盖;
|
|
32
|
+
* 2. **旧取法保留兜底**:宿主回退或其它组合下不至于两个态全灭;
|
|
33
|
+
* 3. **kind 白名单**:只有 `approval` / `plan-review` / `question` 算「等待确认」
|
|
34
|
+
* (对齐原生 `visiblePendingKind`,`dsh-client-ui-workspace/lib/client.js`);
|
|
35
|
+
* 4. **id 拼法兼容**:宿主有 `session-<uuid>` 与裸 `<uuid>` 两种拼法,查表归一化;
|
|
36
|
+
* 5. **绝不抛错**:任何不认识的形状都降级为「没有该态」。
|
|
37
|
+
*
|
|
38
|
+
* 纯逻辑:不 import react、不 import 任何 `@deepseek-ai/*`、无 IO。
|
|
39
|
+
*/
|
|
40
|
+
/** 原生 `visiblePendingKind` 的取值域(其余 kind 视为「没有待确认」)。 */
|
|
41
|
+
const VISIBLE_PENDING_KINDS = ['approval', 'plan-review', 'question'];
|
|
42
|
+
/**
|
|
43
|
+
* 复刻原生 `visiblePendingKind()`。
|
|
44
|
+
*
|
|
45
|
+
* 语义:只有 `approval` / `plan-review` / `question` 三种 kind 算「等待用户确认」,
|
|
46
|
+
* 其它(或非字符串)一律 `undefined` —— 客户端不能因为快照里有值就点琥珀。
|
|
47
|
+
*
|
|
48
|
+
* @param kind 快照里 interaction 的 `kind`(未知类型)。
|
|
49
|
+
* @returns 合法 kind,或 `undefined`。
|
|
50
|
+
*/
|
|
51
|
+
export function visiblePendingKind(kind) {
|
|
52
|
+
return typeof kind === 'string' && VISIBLE_PENDING_KINDS.includes(kind) ? kind : undefined;
|
|
53
|
+
}
|
|
54
|
+
/**
|
|
55
|
+
* 会话 id 归一化键(宿主有 `session-<uuid>` 与裸 `<uuid>` 两种拼法)。
|
|
56
|
+
*
|
|
57
|
+
* **只用于查表比较**,渲染与写回仍用原 id。
|
|
58
|
+
*
|
|
59
|
+
* @param id 会话 id。
|
|
60
|
+
* @returns 去掉 `session-` 前缀后的比较键。
|
|
61
|
+
*/
|
|
62
|
+
export function normalizeSessionKey(id) {
|
|
63
|
+
return id.startsWith('session-') ? id.slice('session-'.length) : id;
|
|
64
|
+
}
|
|
65
|
+
/** 从任意形状里按 id 取条目(兼容 `Map` 与 `get()` 形态)。 */
|
|
66
|
+
function entryOf(face, sessionId) {
|
|
67
|
+
if (face === null || face === undefined)
|
|
68
|
+
return undefined;
|
|
69
|
+
const map = face;
|
|
70
|
+
if (typeof map.get !== 'function')
|
|
71
|
+
return undefined;
|
|
72
|
+
try {
|
|
73
|
+
return map.get(sessionId);
|
|
74
|
+
}
|
|
75
|
+
catch {
|
|
76
|
+
return undefined;
|
|
77
|
+
}
|
|
78
|
+
}
|
|
79
|
+
/**
|
|
80
|
+
* 从 `useSessionStatus` 的快照里取某会话的状态条目。
|
|
81
|
+
*
|
|
82
|
+
* 先按原 id 精确命中(宿主绝大多数情况一致),再退归一化键遍历 —— 遍历是 O(n),
|
|
83
|
+
* 只在未命中时发生。
|
|
84
|
+
*
|
|
85
|
+
* @param status `useSessionStatus(identity)` 的结果。
|
|
86
|
+
* @param sessionId 渲染行的 `row.sessionId`。
|
|
87
|
+
* @returns 状态条目,或 `undefined`。
|
|
88
|
+
*/
|
|
89
|
+
export function sessionStatusOf(status, sessionId) {
|
|
90
|
+
if (typeof sessionId !== 'string' || sessionId === '')
|
|
91
|
+
return undefined;
|
|
92
|
+
const direct = entryOf(status, sessionId);
|
|
93
|
+
if (direct !== undefined)
|
|
94
|
+
return direct;
|
|
95
|
+
const iterable = status;
|
|
96
|
+
if (iterable === null || iterable === undefined || typeof iterable.entries !== 'function')
|
|
97
|
+
return undefined;
|
|
98
|
+
const key = normalizeSessionKey(sessionId);
|
|
99
|
+
if (key === '')
|
|
100
|
+
return undefined;
|
|
101
|
+
try {
|
|
102
|
+
for (const [id, value] of iterable.entries()) {
|
|
103
|
+
if (typeof id === 'string' && normalizeSessionKey(id) === key)
|
|
104
|
+
return value;
|
|
105
|
+
}
|
|
106
|
+
}
|
|
107
|
+
catch {
|
|
108
|
+
return undefined;
|
|
109
|
+
}
|
|
110
|
+
return undefined;
|
|
111
|
+
}
|
|
112
|
+
/** 旧源:`useSessionPendingInteraction` 的 `Map<id, interaction>`。 */
|
|
113
|
+
function pendingKindFromLegacy(pending, sessionId) {
|
|
114
|
+
const direct = visiblePendingKind(entryOf(pending, sessionId)?.kind);
|
|
115
|
+
if (direct !== undefined)
|
|
116
|
+
return direct;
|
|
117
|
+
const iterable = pending;
|
|
118
|
+
if (iterable === null || iterable === undefined || typeof iterable.entries !== 'function')
|
|
119
|
+
return undefined;
|
|
120
|
+
const key = normalizeSessionKey(sessionId);
|
|
121
|
+
if (key === '')
|
|
122
|
+
return undefined;
|
|
123
|
+
try {
|
|
124
|
+
for (const [id, interaction] of iterable.entries()) {
|
|
125
|
+
if (typeof id !== 'string' || normalizeSessionKey(id) !== key)
|
|
126
|
+
continue;
|
|
127
|
+
const kind = visiblePendingKind(interaction?.kind);
|
|
128
|
+
if (kind !== undefined)
|
|
129
|
+
return kind;
|
|
130
|
+
}
|
|
131
|
+
}
|
|
132
|
+
catch {
|
|
133
|
+
return undefined;
|
|
134
|
+
}
|
|
135
|
+
return undefined;
|
|
136
|
+
}
|
|
137
|
+
/** 旧源:`useSessions().byId[id].completed`。 */
|
|
138
|
+
function completedFromLegacy(sessions, sessionId) {
|
|
139
|
+
const byId = sessions?.byId;
|
|
140
|
+
if (byId === null || byId === undefined || typeof byId !== 'object')
|
|
141
|
+
return false;
|
|
142
|
+
if (byId[sessionId]?.completed === true)
|
|
143
|
+
return true;
|
|
144
|
+
const key = normalizeSessionKey(sessionId);
|
|
145
|
+
if (key === '')
|
|
146
|
+
return false;
|
|
147
|
+
for (const [id, entry] of Object.entries(byId)) {
|
|
148
|
+
if (entry?.completed === true && normalizeSessionKey(id) === key)
|
|
149
|
+
return true;
|
|
150
|
+
}
|
|
151
|
+
return false;
|
|
152
|
+
}
|
|
153
|
+
/**
|
|
154
|
+
* 运行中会话集合签名:只取 `running === true` 的会话 id,归一化去重、排序、逗号拼接。
|
|
155
|
+
*
|
|
156
|
+
* ## 用途(2026-10-20,运行中任务高亮)
|
|
157
|
+
*
|
|
158
|
+
* `sidebar.tsx` 把它放进**既有 220 ms 防抖**重取 effect 的依赖。签名只在「运行集合」
|
|
159
|
+
* 变化时变(宿主 `sameSessionStatus` 已先做内容去重)⇒ 不会因 `Map` 引用变化每帧重取,
|
|
160
|
+
* 也不会因审批弹窗 / 完成未读触发重取。
|
|
161
|
+
*
|
|
162
|
+
* ## 精确语义(`test/live-state.test.mjs` 的 B1–B8 逐条锁定)
|
|
163
|
+
*
|
|
164
|
+
* 1. 非对象 / 无 `entries()` ⇒ `''`;
|
|
165
|
+
* 2. 遍历 `entries()`:`id` 非字符串或空串 ⇒ 跳过;条目为 `null` / 非对象 ⇒ 跳过;
|
|
166
|
+
* `running !== true` ⇒ 跳过(**只认 `=== true`**,`undefined` / 真值对象都不算);
|
|
167
|
+
* 3. `normalizeSessionKey(id)` 归一化(`session-x` 与 `x` 只算一次),键为空 ⇒ 跳过;
|
|
168
|
+
* 4. `[...Set].sort()` 后 `join(',')`(默认 UTF-16 码元升序,结果确定);
|
|
169
|
+
* 5. 遍历过程中任何异常 ⇒ `''`(整体 try/catch,绝不抛)。
|
|
170
|
+
*
|
|
171
|
+
* **忽略** `pendingInteraction` 与 `completionUnread`:审批弹窗、完成未读都不是「运行中」。
|
|
172
|
+
*
|
|
173
|
+
* 纯函数:不 import react / 宿主包、无 IO、不读时间与随机数。
|
|
174
|
+
*
|
|
175
|
+
* @param status `useSessionStatus(identity)` 的快照(未知形状,防御式读取)。
|
|
176
|
+
* @returns 归一化运行中 id 的排序逗号串;空状态 / 异常形状 ⇒ `''`。
|
|
177
|
+
*/
|
|
178
|
+
export function runningSignature(status) {
|
|
179
|
+
const iterable = status;
|
|
180
|
+
if (iterable === null || iterable === undefined || typeof iterable.entries !== 'function')
|
|
181
|
+
return '';
|
|
182
|
+
try {
|
|
183
|
+
const keys = new Set();
|
|
184
|
+
for (const [id, entry] of iterable.entries()) {
|
|
185
|
+
if (typeof id !== 'string' || id === '')
|
|
186
|
+
continue;
|
|
187
|
+
if (entry === null || typeof entry !== 'object')
|
|
188
|
+
continue;
|
|
189
|
+
if (entry.running !== true)
|
|
190
|
+
continue;
|
|
191
|
+
const key = normalizeSessionKey(id);
|
|
192
|
+
if (key === '')
|
|
193
|
+
continue;
|
|
194
|
+
keys.add(key);
|
|
195
|
+
}
|
|
196
|
+
return [...keys].sort().join(',');
|
|
197
|
+
}
|
|
198
|
+
catch {
|
|
199
|
+
return '';
|
|
200
|
+
}
|
|
201
|
+
}
|
|
202
|
+
/**
|
|
203
|
+
* 取一个会话行的 live fact(新源优先,旧源兜底)。
|
|
204
|
+
*
|
|
205
|
+
* @param input 三个可选快照。
|
|
206
|
+
* @param sessionId 渲染行的 `row.sessionId`。
|
|
207
|
+
* @returns `pendingKind` 与 `completionUnread`;永不抛错。
|
|
208
|
+
*/
|
|
209
|
+
export function liveStateOf(input, sessionId) {
|
|
210
|
+
const status = sessionStatusOf(input.status, sessionId);
|
|
211
|
+
const pendingKind = status === undefined
|
|
212
|
+
? pendingKindFromLegacy(input.pending, sessionId)
|
|
213
|
+
: visiblePendingKind(status.pendingInteraction?.kind);
|
|
214
|
+
const completionUnread = typeof status?.completionUnread === 'boolean'
|
|
215
|
+
? status.completionUnread === true
|
|
216
|
+
: completedFromLegacy(input.sessions, sessionId);
|
|
217
|
+
return { pendingKind, completionUnread };
|
|
218
|
+
}
|
|
219
|
+
/**
|
|
220
|
+
* 解析当前在主视图打开的会话 id(2026-10-21 WSR3 / AC2)。
|
|
221
|
+
*
|
|
222
|
+
* ## 为什么需要它
|
|
223
|
+
*
|
|
224
|
+
* 宿主 `@deepseek-ai/dsh-api-session-controller@0.2.1-rc.2` 删除了 `sessions.list`
|
|
225
|
+
* 快照顶层的 `current` 字段(`lib/client.js:3814`),改为在 `byId[id].retainedBy.mainView`
|
|
226
|
+
* 计数上标记当前主视图持有的会话(`dsh-client-ui-workspace/lib/client.js:866, 3025-3027`)。
|
|
227
|
+
* 旧代码只读 `sessionsSnapshot?.current`,导致升级后 `currentSessionId` 恒为 `undefined`,
|
|
228
|
+
* 打开任何对话都没有选中效果。
|
|
229
|
+
*
|
|
230
|
+
* ## 优先级
|
|
231
|
+
*
|
|
232
|
+
* 1. 若 `panelInfo` 为对象且 `activePanelId !== null && activePanelId !== undefined`
|
|
233
|
+
* (其它面板占据主视图)⇒ 返回 `undefined`;
|
|
234
|
+
* 2. 新源(`0.2.1-rc.2`):`sessions.byId` 中 `retainedBy.mainView > 0` 的条目;
|
|
235
|
+
* 3. 旧源(`0.1.5-rc.2` 兜底):`sessions.current` 非空字符串;
|
|
236
|
+
* 4. 乐观选中兜底:`optimisticSessionId` 非空字符串(覆盖刚点击历史孤儿会话尚未完成
|
|
237
|
+
* `retainScope` 投影的窗口,或无 `byId` 的测试桩)。
|
|
238
|
+
*/
|
|
239
|
+
export function currentSessionIdOf(input) {
|
|
240
|
+
if (input === null || input === undefined || typeof input !== 'object')
|
|
241
|
+
return undefined;
|
|
242
|
+
try {
|
|
243
|
+
const panelInfo = input.panelInfo;
|
|
244
|
+
if (panelInfo !== null && panelInfo !== undefined && typeof panelInfo === 'object') {
|
|
245
|
+
const activePanelId = panelInfo.activePanelId;
|
|
246
|
+
if (activePanelId !== null && activePanelId !== undefined)
|
|
247
|
+
return undefined;
|
|
248
|
+
}
|
|
249
|
+
const sessions = input.sessions;
|
|
250
|
+
if (sessions !== null && sessions !== undefined && typeof sessions === 'object') {
|
|
251
|
+
const byId = sessions.byId;
|
|
252
|
+
if (byId !== null && byId !== undefined && typeof byId === 'object' && !Array.isArray(byId)) {
|
|
253
|
+
for (const [key, rawEntry] of Object.entries(byId)) {
|
|
254
|
+
if (rawEntry === null || rawEntry === undefined || typeof rawEntry !== 'object')
|
|
255
|
+
continue;
|
|
256
|
+
const entry = rawEntry;
|
|
257
|
+
const mainView = entry.retainedBy?.mainView;
|
|
258
|
+
if (typeof mainView === 'number' && Number.isFinite(mainView) && mainView > 0) {
|
|
259
|
+
if (typeof entry.id === 'string' && entry.id !== '')
|
|
260
|
+
return entry.id;
|
|
261
|
+
if (typeof entry.sessionId === 'string' && entry.sessionId !== '')
|
|
262
|
+
return entry.sessionId;
|
|
263
|
+
if (key !== '')
|
|
264
|
+
return key;
|
|
265
|
+
}
|
|
266
|
+
}
|
|
267
|
+
}
|
|
268
|
+
const legacyCurrent = sessions.current;
|
|
269
|
+
if (typeof legacyCurrent === 'string' && legacyCurrent !== '')
|
|
270
|
+
return legacyCurrent;
|
|
271
|
+
}
|
|
272
|
+
if (typeof input.optimisticSessionId === 'string' && input.optimisticSessionId !== '') {
|
|
273
|
+
return input.optimisticSessionId;
|
|
274
|
+
}
|
|
275
|
+
return undefined;
|
|
276
|
+
}
|
|
277
|
+
catch {
|
|
278
|
+
return undefined;
|
|
279
|
+
}
|
|
280
|
+
}
|
|
281
|
+
//# sourceMappingURL=live-state.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"live-state.js","sourceRoot":"","sources":["../src/live-state.ts"],"names":[],"mappings":"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"}
|
package/lib/locales.d.ts
ADDED
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 客户端词条表(中文)。
|
|
3
|
+
*
|
|
4
|
+
* 本文件是**纯逻辑**:不 import react、不 import 任何 `@deepseek-ai/*` 包、不做 IO,
|
|
5
|
+
* 因此可以被 `node --test` 直接覆盖。
|
|
6
|
+
*
|
|
7
|
+
* key 集合是 `docs/INTERFACES.md` §2.1 冻结的最小集:渲染层(T5)只会用到这些 key,
|
|
8
|
+
* 少一个就会在界面上露出裸 key。新增 key 请先改契约文件。
|
|
9
|
+
*
|
|
10
|
+
* 尾部 5 条(`worktree.menu` / `a11y.subagents` / `a11y.runningTask` /
|
|
11
|
+
* `state.loadingTree` / `worktree.createTitle`)是 T5 落地渲染层后补入的实测缺口,
|
|
12
|
+
* 属于同一冻结集(`a11y.runningTask` 由 2026-10-20 运行中高亮需求补入,仍定义在本块内);
|
|
13
|
+
* `docs/INTERFACES.md` §2.1 的最小集清单待主代理同步更新。
|
|
14
|
+
*/
|
|
15
|
+
/** 中文词条表(key 稳定,便于后续加英文表)。 */
|
|
16
|
+
export declare const zh: Record<string, string>;
|
|
17
|
+
/** 取词函数签名(`{name}` 占位符由 `vars.name` 替换)。 */
|
|
18
|
+
export type Translate = (key: string, vars?: Record<string, string | number>) => string;
|
|
19
|
+
/**
|
|
20
|
+
* 取词函数工厂。缺 key 时返回 key 本身(不崩、不返回 undefined);
|
|
21
|
+
* 占位符缺失时保留原样 `{n}`(不崩、不抛)。
|
|
22
|
+
*
|
|
23
|
+
* @param dict 词条表,缺省用 {@link zh}(便于后续挂英文表或测试注入)。
|
|
24
|
+
* @returns `t(key, vars?)`:把 `{name}` 形式的占位符替换为 `vars.name` 的字符串形式。
|
|
25
|
+
*
|
|
26
|
+
* @example
|
|
27
|
+
* const t = createT()
|
|
28
|
+
* t('sessions.expand', { n: 29 }) // '展开其余 29 个会话'
|
|
29
|
+
* t('not.exists') // 'not.exists'
|
|
30
|
+
* t('sessions.expand') // '展开其余 {n} 个会话'
|
|
31
|
+
*/
|
|
32
|
+
export declare function createT(dict?: Record<string, string>): Translate;
|
|
33
|
+
/**
|
|
34
|
+
* 把宿主 **locale seat** 包一层「解不出就回落内置中文」的兜底。
|
|
35
|
+
*
|
|
36
|
+
* ## 为什么需要它(2026-09-23 缺陷)
|
|
37
|
+
*
|
|
38
|
+
* 宿主 `locale` 服务的解析规则是:按当前语言的 fallback 链在本 entry 的**命名空间**查表,
|
|
39
|
+
* 再查 `common` 命名空间,**都查不到就返回 key 本身**
|
|
40
|
+
* (`@deepseek-ai/dsh-client-locale/lib/client.js` 的 `translate`)。
|
|
41
|
+
* 而 entry 一旦声明了 `locale`,renderer 就**一定**给组件 seat `t`
|
|
42
|
+
* (`dsh-client-ui-renderer` 的 `standardKit` → `localeSeat`),
|
|
43
|
+
* 于是 `sidebar.tsx` 的 `FALLBACK_T` **永远走不到** —— 词典没注册成功时,侧栏每个取词点
|
|
44
|
+
* (右键菜单项、按钮 `title`/`aria-label`、搜索占位符…)都会显示裸 key。
|
|
45
|
+
*
|
|
46
|
+
* 2026-09-23 的真实触发路径是**启动时序**:`client.tsx` 曾用一次性 `ctx.get('locale')`
|
|
47
|
+
* 探测服务并**静默跳过**注册,而 DSH web 启动**并发创建所有 client entry**
|
|
48
|
+
* (`Promise.all(loader.create(...))`),locale 插件自身还要等
|
|
49
|
+
* `slots`/`remote`/`settingsScope` ⇒ 本插件的 apply 可能先跑 ⇒ 注册被跳过 ⇒
|
|
50
|
+
* seat 绑定到空命名空间 ⇒ 满屏裸 key。
|
|
51
|
+
*
|
|
52
|
+
* 本函数是**治果**的一层:`client.tsx` 改成等 `locale` 出现再注册(治因)之后它仍然保留
|
|
53
|
+
* —— 任何时序、任何宿主语言、任何注册失败下,界面都不会再露 key。
|
|
54
|
+
*
|
|
55
|
+
* ## 语义(逐条有测试)
|
|
56
|
+
*
|
|
57
|
+
* 1. `seat` 返回的**不是** key ⇒ **逐字透传**(宿主 `common` 命名空间的译文、其它语言的
|
|
58
|
+
* 译文都不许被我们顶掉);
|
|
59
|
+
* 2. `seat` 返回的就是 key(未解析)或 `seat` 抛错 ⇒ 回落本表;本表也没有 ⇒ 返回 key;
|
|
60
|
+
* 3. 回落路径同样替换占位符(否则会显示「展开其余 {n} 个会话」)。
|
|
61
|
+
*
|
|
62
|
+
* @param seat 宿主 seat 取词函数(`kit.t`)。
|
|
63
|
+
* @param dict 兜底词条表,缺省 {@link zh}。
|
|
64
|
+
* @returns 与 `seat` 同签名的取词函数;**同一 (seat, dict) 组合返回同一引用**。
|
|
65
|
+
*
|
|
66
|
+
* @example
|
|
67
|
+
* const t = createSeatT(unresolvedSeat) // 宿主词典缺席
|
|
68
|
+
* t('menu.newSession') // '新建会话'(不是 'menu.newSession')
|
|
69
|
+
*/
|
|
70
|
+
export declare function createSeatT(seat: Translate, dict?: Record<string, string>): Translate;
|
|
71
|
+
//# sourceMappingURL=locales.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"locales.d.ts","sourceRoot":"","sources":["../src/locales.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,8BAA8B;AAC9B,eAAO,MAAM,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAsErC,CAAA;AAED,4CAA4C;AAC5C,MAAM,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,KAAK,MAAM,CAAA;AAkBvF;;;;;;;;;;;;GAYG;AACH,wBAAgB,OAAO,CAAC,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAAG,SAAS,CAOpE;AAcD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAAG,SAAS,CA0BzF"}
|
package/lib/locales.js
ADDED
|
@@ -0,0 +1,199 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 客户端词条表(中文)。
|
|
3
|
+
*
|
|
4
|
+
* 本文件是**纯逻辑**:不 import react、不 import 任何 `@deepseek-ai/*` 包、不做 IO,
|
|
5
|
+
* 因此可以被 `node --test` 直接覆盖。
|
|
6
|
+
*
|
|
7
|
+
* key 集合是 `docs/INTERFACES.md` §2.1 冻结的最小集:渲染层(T5)只会用到这些 key,
|
|
8
|
+
* 少一个就会在界面上露出裸 key。新增 key 请先改契约文件。
|
|
9
|
+
*
|
|
10
|
+
* 尾部 5 条(`worktree.menu` / `a11y.subagents` / `a11y.runningTask` /
|
|
11
|
+
* `state.loadingTree` / `worktree.createTitle`)是 T5 落地渲染层后补入的实测缺口,
|
|
12
|
+
* 属于同一冻结集(`a11y.runningTask` 由 2026-10-20 运行中高亮需求补入,仍定义在本块内);
|
|
13
|
+
* `docs/INTERFACES.md` §2.1 的最小集清单待主代理同步更新。
|
|
14
|
+
*/
|
|
15
|
+
/** 中文词条表(key 稳定,便于后续加英文表)。 */
|
|
16
|
+
export const zh = {
|
|
17
|
+
'section.workspaces': '工作区',
|
|
18
|
+
'section.ungrouped': '未分组',
|
|
19
|
+
'search.placeholder': '搜索会话…',
|
|
20
|
+
'search.empty': '无匹配结果',
|
|
21
|
+
'session.new': '新会话',
|
|
22
|
+
'session.blank': '新会话',
|
|
23
|
+
'sessions.expand': '展开其余 {n} 个会话',
|
|
24
|
+
/** 2026-11-14 PX1:渐进展开按钮(n = 本次多展开的条数)。 */
|
|
25
|
+
'sessions.expandMore': '展开更多 {n} 个',
|
|
26
|
+
'sessions.collapse': '收起',
|
|
27
|
+
'history.label': 'history-worktree-session',
|
|
28
|
+
'worktree.main': '主',
|
|
29
|
+
'worktree.create': '新建 worktree…',
|
|
30
|
+
'worktree.remove': '移除 worktree',
|
|
31
|
+
'worktree.creating': '正在创建…',
|
|
32
|
+
'worktree.removing': '正在移除…',
|
|
33
|
+
'worktree.newBranch': '新建分支',
|
|
34
|
+
'worktree.useExisting': '复用已有分支',
|
|
35
|
+
'worktree.branchName': '分支名',
|
|
36
|
+
'worktree.baseBranch': '起始分支',
|
|
37
|
+
'worktree.path': '路径',
|
|
38
|
+
'worktree.pathHint': '默认:<主仓父目录>/<主仓名>-<分支名>',
|
|
39
|
+
'worktree.confirm': '创建',
|
|
40
|
+
'worktree.cancel': '取消',
|
|
41
|
+
'worktree.removeConfirm': '确定移除 worktree “{name}”?',
|
|
42
|
+
'worktree.removeKeepBranch': '分支会保留,可用 git branch -d 删除。',
|
|
43
|
+
'worktree.forceRemove': '强制删除(丢失未提交改动)',
|
|
44
|
+
'worktree.dirty': '该 worktree 有未提交改动。',
|
|
45
|
+
// D10:`worktree-create` 返回 `ok:true` 但注册工作区失败时的**非阻塞**提示
|
|
46
|
+
// (worktree 确实建成了,只是没有 workspaceId ⇒ 不会自动开新会话)。
|
|
47
|
+
'worktree.workspaceWarning': 'worktree 已创建,但注册为工作区失败,未自动新建会话:{message}',
|
|
48
|
+
'project.add': '添加工作区…',
|
|
49
|
+
'menu.newSession': '新建会话',
|
|
50
|
+
'menu.reveal': '在文件管理器中打开',
|
|
51
|
+
'menu.copyPath': '复制路径',
|
|
52
|
+
'menu.rename': '重命名',
|
|
53
|
+
'menu.archive': '归档',
|
|
54
|
+
'menu.fork': '派生会话',
|
|
55
|
+
'menu.removeHistory': '移出 history',
|
|
56
|
+
'menu.deleteWorkspace': '删除工作区',
|
|
57
|
+
// D10(2026-09-21 用户决策变更):拖拽排序落地后,必须有一个**切回默认排序**的入口
|
|
58
|
+
// (「拖拽即切手动排序」的承诺是「直到你手动切回最近更新」)。菜单项即可,不做模式切换 UI。
|
|
59
|
+
'menu.resetOrder': '恢复默认排序',
|
|
60
|
+
'dialog.rename': '重命名',
|
|
61
|
+
'dialog.renameWorkspace': '重命名工作区',
|
|
62
|
+
'dialog.renameSession': '重命名会话',
|
|
63
|
+
'dialog.confirm': '确定',
|
|
64
|
+
'dialog.cancel': '取消',
|
|
65
|
+
'error.title': '侧栏渲染出错',
|
|
66
|
+
'error.retry': '重试',
|
|
67
|
+
'error.load': '加载失败',
|
|
68
|
+
'state.loading': '加载中…',
|
|
69
|
+
// 渲染层(T5)实际使用、原最小集遗漏的 4 条。原由 `sidebar.tsx` 的临时
|
|
70
|
+
// 兜底常量补齐,该常量已随清理彻底删除,这 4 条现为冻结集的正式成员
|
|
71
|
+
// (与 `state.loading` 并存,语义不同:本条专指树数据首拉)。
|
|
72
|
+
'worktree.menu': '更多操作',
|
|
73
|
+
'a11y.subagents': '{n} 个子代理运行中',
|
|
74
|
+
// 2026-10-20 运行中任务高亮:容器行 lead 图标的 `title`(key 唯一,见 INTERFACES §2.1)。
|
|
75
|
+
'a11y.runningTask': '有任务正在运行',
|
|
76
|
+
'state.loadingTree': '正在加载工作区…',
|
|
77
|
+
'worktree.createTitle': '在 {name} 下新建 worktree',
|
|
78
|
+
// 2026-10-21 新增:底部「最近」分区、归档工作空间与设置页恢复管理词条(WSR1/WSR2/WSR6)。
|
|
79
|
+
'section.recent': '最近',
|
|
80
|
+
'menu.archiveWorkspace': '归档工作空间',
|
|
81
|
+
'settings.archivedWorkspaces.title': '已归档的工作空间',
|
|
82
|
+
'settings.archivedWorkspaces.description': '归档后的工作空间及其会话不在侧栏显示,可在此放出恢复,或重新添加相同目录自动放出',
|
|
83
|
+
'settings.archivedWorkspaces.empty': '暂无已归档的工作空间',
|
|
84
|
+
'settings.archivedWorkspaces.restore': '放出',
|
|
85
|
+
};
|
|
86
|
+
/**
|
|
87
|
+
* 把 `{name}` 形式的占位符替换为 `vars.name` 的字符串形式。
|
|
88
|
+
*
|
|
89
|
+
* 占位符缺失时**保留原样** `{n}`(不崩、不抛、不返回 undefined)。
|
|
90
|
+
*
|
|
91
|
+
* @param template 词条模板。
|
|
92
|
+
* @param vars 占位符取值。
|
|
93
|
+
* @returns 替换后的字符串。
|
|
94
|
+
*/
|
|
95
|
+
function format(template, vars) {
|
|
96
|
+
if (vars === undefined)
|
|
97
|
+
return template;
|
|
98
|
+
return template.replace(/\{([A-Za-z0-9_]+)\}/g, (match, name) => Object.prototype.hasOwnProperty.call(vars, name) ? String(vars[name]) : match);
|
|
99
|
+
}
|
|
100
|
+
/**
|
|
101
|
+
* 取词函数工厂。缺 key 时返回 key 本身(不崩、不返回 undefined);
|
|
102
|
+
* 占位符缺失时保留原样 `{n}`(不崩、不抛)。
|
|
103
|
+
*
|
|
104
|
+
* @param dict 词条表,缺省用 {@link zh}(便于后续挂英文表或测试注入)。
|
|
105
|
+
* @returns `t(key, vars?)`:把 `{name}` 形式的占位符替换为 `vars.name` 的字符串形式。
|
|
106
|
+
*
|
|
107
|
+
* @example
|
|
108
|
+
* const t = createT()
|
|
109
|
+
* t('sessions.expand', { n: 29 }) // '展开其余 29 个会话'
|
|
110
|
+
* t('not.exists') // 'not.exists'
|
|
111
|
+
* t('sessions.expand') // '展开其余 {n} 个会话'
|
|
112
|
+
*/
|
|
113
|
+
export function createT(dict = zh) {
|
|
114
|
+
return (key, vars) => {
|
|
115
|
+
// 只用自有属性:避免 'toString' 这类原型链 key 被当成词条。
|
|
116
|
+
const template = Object.prototype.hasOwnProperty.call(dict, key) ? dict[key] : key;
|
|
117
|
+
if (template === undefined)
|
|
118
|
+
return key;
|
|
119
|
+
return format(template, vars);
|
|
120
|
+
};
|
|
121
|
+
}
|
|
122
|
+
/**
|
|
123
|
+
* 包装函数缓存:`seat` →(`dict` → 包装后的 `t`)。
|
|
124
|
+
*
|
|
125
|
+
* **为什么必须缓存**:`sidebar.tsx` 里以 `t` 为依赖的 `useMemo` 要求 `t` 引用稳定。
|
|
126
|
+
* 宿主 seat 本身按 (face, ns, revision) 缓存(`localeSeat`),若我们每次渲染都新建一个
|
|
127
|
+
* 包装闭包,那些 `useMemo` 会**每帧失效**(重算整棵树的排序 / 搜索候选)。
|
|
128
|
+
*
|
|
129
|
+
* 用 `WeakMap` 而不是 `Map`:seat 由宿主持有,宿主换掉 seat 后缓存条目可被回收,
|
|
130
|
+
* 不会把宿主对象钉在内存里。
|
|
131
|
+
*/
|
|
132
|
+
const seatCache = new WeakMap();
|
|
133
|
+
/**
|
|
134
|
+
* 把宿主 **locale seat** 包一层「解不出就回落内置中文」的兜底。
|
|
135
|
+
*
|
|
136
|
+
* ## 为什么需要它(2026-09-23 缺陷)
|
|
137
|
+
*
|
|
138
|
+
* 宿主 `locale` 服务的解析规则是:按当前语言的 fallback 链在本 entry 的**命名空间**查表,
|
|
139
|
+
* 再查 `common` 命名空间,**都查不到就返回 key 本身**
|
|
140
|
+
* (`@deepseek-ai/dsh-client-locale/lib/client.js` 的 `translate`)。
|
|
141
|
+
* 而 entry 一旦声明了 `locale`,renderer 就**一定**给组件 seat `t`
|
|
142
|
+
* (`dsh-client-ui-renderer` 的 `standardKit` → `localeSeat`),
|
|
143
|
+
* 于是 `sidebar.tsx` 的 `FALLBACK_T` **永远走不到** —— 词典没注册成功时,侧栏每个取词点
|
|
144
|
+
* (右键菜单项、按钮 `title`/`aria-label`、搜索占位符…)都会显示裸 key。
|
|
145
|
+
*
|
|
146
|
+
* 2026-09-23 的真实触发路径是**启动时序**:`client.tsx` 曾用一次性 `ctx.get('locale')`
|
|
147
|
+
* 探测服务并**静默跳过**注册,而 DSH web 启动**并发创建所有 client entry**
|
|
148
|
+
* (`Promise.all(loader.create(...))`),locale 插件自身还要等
|
|
149
|
+
* `slots`/`remote`/`settingsScope` ⇒ 本插件的 apply 可能先跑 ⇒ 注册被跳过 ⇒
|
|
150
|
+
* seat 绑定到空命名空间 ⇒ 满屏裸 key。
|
|
151
|
+
*
|
|
152
|
+
* 本函数是**治果**的一层:`client.tsx` 改成等 `locale` 出现再注册(治因)之后它仍然保留
|
|
153
|
+
* —— 任何时序、任何宿主语言、任何注册失败下,界面都不会再露 key。
|
|
154
|
+
*
|
|
155
|
+
* ## 语义(逐条有测试)
|
|
156
|
+
*
|
|
157
|
+
* 1. `seat` 返回的**不是** key ⇒ **逐字透传**(宿主 `common` 命名空间的译文、其它语言的
|
|
158
|
+
* 译文都不许被我们顶掉);
|
|
159
|
+
* 2. `seat` 返回的就是 key(未解析)或 `seat` 抛错 ⇒ 回落本表;本表也没有 ⇒ 返回 key;
|
|
160
|
+
* 3. 回落路径同样替换占位符(否则会显示「展开其余 {n} 个会话」)。
|
|
161
|
+
*
|
|
162
|
+
* @param seat 宿主 seat 取词函数(`kit.t`)。
|
|
163
|
+
* @param dict 兜底词条表,缺省 {@link zh}。
|
|
164
|
+
* @returns 与 `seat` 同签名的取词函数;**同一 (seat, dict) 组合返回同一引用**。
|
|
165
|
+
*
|
|
166
|
+
* @example
|
|
167
|
+
* const t = createSeatT(unresolvedSeat) // 宿主词典缺席
|
|
168
|
+
* t('menu.newSession') // '新建会话'(不是 'menu.newSession')
|
|
169
|
+
*/
|
|
170
|
+
export function createSeatT(seat, dict = zh) {
|
|
171
|
+
let perDict = seatCache.get(seat);
|
|
172
|
+
if (perDict === undefined) {
|
|
173
|
+
perDict = new WeakMap();
|
|
174
|
+
seatCache.set(seat, perDict);
|
|
175
|
+
}
|
|
176
|
+
const cached = perDict.get(dict);
|
|
177
|
+
if (cached !== undefined)
|
|
178
|
+
return cached;
|
|
179
|
+
const t = (key, vars) => {
|
|
180
|
+
let resolved;
|
|
181
|
+
try {
|
|
182
|
+
resolved = seat(key, vars);
|
|
183
|
+
}
|
|
184
|
+
catch {
|
|
185
|
+
// 宿主 locale 服务炸了也不许把异常抛到渲染层(PRD R6:缺失即降级,绝不崩)。
|
|
186
|
+
resolved = undefined;
|
|
187
|
+
}
|
|
188
|
+
// 判据只有「seat 是否真的解析了」:返回 key 本身 = 未解析(宿主 translate 的兜底)。
|
|
189
|
+
if (typeof resolved === 'string' && resolved !== key)
|
|
190
|
+
return resolved;
|
|
191
|
+
const template = Object.prototype.hasOwnProperty.call(dict, key) ? dict[key] : undefined;
|
|
192
|
+
if (template === undefined)
|
|
193
|
+
return key;
|
|
194
|
+
return format(template, vars);
|
|
195
|
+
};
|
|
196
|
+
perDict.set(dict, t);
|
|
197
|
+
return t;
|
|
198
|
+
}
|
|
199
|
+
//# sourceMappingURL=locales.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"locales.js","sourceRoot":"","sources":["../src/locales.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,8BAA8B;AAC9B,MAAM,CAAC,MAAM,EAAE,GAA2B;IACxC,oBAAoB,EAAE,KAAK;IAC3B,mBAAmB,EAAE,KAAK;IAC1B,oBAAoB,EAAE,OAAO;IAC7B,cAAc,EAAE,OAAO;IACvB,aAAa,EAAE,KAAK;IACpB,eAAe,EAAE,KAAK;IACtB,iBAAiB,EAAE,cAAc;IACjC,2CAA2C;IAC3C,qBAAqB,EAAE,YAAY;IACnC,mBAAmB,EAAE,IAAI;IACzB,eAAe,EAAE,0BAA0B;IAC3C,eAAe,EAAE,GAAG;IACpB,iBAAiB,EAAE,cAAc;IACjC,iBAAiB,EAAE,aAAa;IAChC,mBAAmB,EAAE,OAAO;IAC5B,mBAAmB,EAAE,OAAO;IAC5B,oBAAoB,EAAE,MAAM;IAC5B,sBAAsB,EAAE,QAAQ;IAChC,qBAAqB,EAAE,KAAK;IAC5B,qBAAqB,EAAE,MAAM;IAC7B,eAAe,EAAE,IAAI;IACrB,mBAAmB,EAAE,wBAAwB;IAC7C,kBAAkB,EAAE,IAAI;IACxB,iBAAiB,EAAE,IAAI;IACvB,wBAAwB,EAAE,yBAAyB;IACnD,2BAA2B,EAAE,4BAA4B;IACzD,sBAAsB,EAAE,eAAe;IACvC,gBAAgB,EAAE,oBAAoB;IACtC,yDAAyD;IACzD,gDAAgD;IAChD,2BAA2B,EAAE,0CAA0C;IACvE,aAAa,EAAE,QAAQ;IACvB,iBAAiB,EAAE,MAAM;IACzB,aAAa,EAAE,WAAW;IAC1B,eAAe,EAAE,MAAM;IACvB,aAAa,EAAE,KAAK;IACpB,cAAc,EAAE,IAAI;IACpB,WAAW,EAAE,MAAM;IACnB,oBAAoB,EAAE,YAAY;IAClC,sBAAsB,EAAE,OAAO;IAC/B,oDAAoD;IACpD,iDAAiD;IACjD,iBAAiB,EAAE,QAAQ;IAC3B,eAAe,EAAE,KAAK;IACtB,wBAAwB,EAAE,QAAQ;IAClC,sBAAsB,EAAE,OAAO;IAC/B,gBAAgB,EAAE,IAAI;IACtB,eAAe,EAAE,IAAI;IACrB,aAAa,EAAE,QAAQ;IACvB,aAAa,EAAE,IAAI;IACnB,YAAY,EAAE,MAAM;IACpB,eAAe,EAAE,MAAM;IACvB,+CAA+C;IAC/C,qCAAqC;IACrC,yCAAyC;IACzC,eAAe,EAAE,MAAM;IACvB,gBAAgB,EAAE,aAAa;IAC/B,qEAAqE;IACrE,kBAAkB,EAAE,SAAS;IAC7B,mBAAmB,EAAE,UAAU;IAC/B,sBAAsB,EAAE,uBAAuB;IAC/C,2DAA2D;IAC3D,gBAAgB,EAAE,IAAI;IACtB,uBAAuB,EAAE,QAAQ;IACjC,mCAAmC,EAAE,UAAU;IAC/C,yCAAyC,EACvC,0CAA0C;IAC5C,mCAAmC,EAAE,YAAY;IACjD,qCAAqC,EAAE,IAAI;CAC5C,CAAA;AAKD;;;;;;;;GAQG;AACH,SAAS,MAAM,CAAC,QAAgB,EAAE,IAAsC;IACtE,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAA;IACvC,OAAO,QAAQ,CAAC,OAAO,CAAC,sBAAsB,EAAE,CAAC,KAAa,EAAE,IAAY,EAAU,EAAE,CACtF,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAC9E,CAAA;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,OAAO,CAAC,OAA+B,EAAE;IACvD,OAAO,CAAC,GAAW,EAAE,IAAsC,EAAU,EAAE;QACrE,wCAAwC;QACxC,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAA;QAClF,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,GAAG,CAAA;QACtC,OAAO,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;IAC/B,CAAC,CAAA;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,SAAS,GAAG,IAAI,OAAO,EAAyD,CAAA;AAEtF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,UAAU,WAAW,CAAC,IAAe,EAAE,OAA+B,EAAE;IAC5E,IAAI,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IACjC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,GAAG,IAAI,OAAO,EAAE,CAAA;QACvB,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IAC9B,CAAC;IACD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAChC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAA;IAEvC,MAAM,CAAC,GAAc,CAAC,GAAW,EAAE,IAAsC,EAAU,EAAE;QACnF,IAAI,QAAiB,CAAA;QACrB,IAAI,CAAC;YACH,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,+CAA+C;YAC/C,QAAQ,GAAG,SAAS,CAAA;QACtB,CAAC;QACD,wDAAwD;QACxD,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,GAAG;YAAE,OAAO,QAAQ,CAAA;QACrE,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;QACxF,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,GAAG,CAAA;QACtC,OAAO,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;IAC/B,CAAC,CAAA;IAED,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;IACpB,OAAO,CAAC,CAAA;AACV,CAAC"}
|