@aiti-ai/ext-shared 0.0.0-stage → 0.1.11

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.
Files changed (131) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +36 -2
  3. package/agent-accounts.test.mjs +227 -0
  4. package/agent-accounts.ts +324 -0
  5. package/agent-capability-contract.test.mjs +129 -0
  6. package/agent-interaction.test.mjs +194 -0
  7. package/agent-interaction.ts +340 -0
  8. package/agent-launch.test.mjs +262 -0
  9. package/agent-spawn-env.test.mjs +169 -0
  10. package/agent-spawn-env.ts +548 -0
  11. package/aiti-editor-inject.mjs +49 -0
  12. package/backend-queue.test.mjs +336 -0
  13. package/backend-queue.ts +469 -0
  14. package/blob-save-route.ts +128 -0
  15. package/cbc-model-catalog.ts +86 -0
  16. package/check-client.mjs +273 -0
  17. package/check-ext-globals.mjs +144 -0
  18. package/controlled-login-dialog.mjs +270 -0
  19. package/controlled-login.mjs +398 -0
  20. package/controlled-login.test.mjs +466 -0
  21. package/convert-saveas.test.mjs +39 -0
  22. package/convert-saveas.ts +170 -0
  23. package/copy-client-bundle.mjs +39 -0
  24. package/cursor-cli-store.ts +377 -0
  25. package/dedupe-fetch.test.mjs +71 -0
  26. package/dedupe-fetch.ts +58 -0
  27. package/deploy-commit.mjs +52 -0
  28. package/dev-pack.mjs +246 -0
  29. package/dock-icons.ts +127 -0
  30. package/esbuild-bin.test.mjs +53 -0
  31. package/esbuild-bin.ts +66 -0
  32. package/exec-async.test.mjs +86 -0
  33. package/exec-async.ts +179 -0
  34. package/ext-display-names.ts +91 -0
  35. package/ext-entry-contracts.test.mjs +131 -0
  36. package/ext-float-dock-core.test.mjs +348 -0
  37. package/ext-float-dock-core.ts +783 -0
  38. package/ext-float-dock-lite.ts +52 -0
  39. package/ext-float-dock.test.mjs +286 -0
  40. package/ext-float-dock.ts +740 -0
  41. package/ext-icons-deploy.mjs +24 -0
  42. package/ext-lazy.test.mjs +186 -0
  43. package/ext-lazy.tsx +183 -0
  44. package/ext-model-state.test.mjs +272 -0
  45. package/ext-model-state.ts +324 -0
  46. package/ext-protocol.mjs +113 -0
  47. package/ext-protocol.test.mjs +88 -0
  48. package/ext-session-usage.test.mjs +219 -0
  49. package/ext-session-usage.ts +507 -0
  50. package/external-cli-governance.ts +153 -0
  51. package/git-ops-client/api.mjs +56 -0
  52. package/git-ops-client/branch-panel.tsx +987 -0
  53. package/git-ops-client/i18n.mjs +328 -0
  54. package/host-tools-allow.test.mjs +46 -0
  55. package/host-tools-allow.ts +84 -0
  56. package/icons/alert.svg +1 -0
  57. package/icons/bookmark.svg +1 -0
  58. package/icons/bot.svg +1 -0
  59. package/icons/chart-column.svg +1 -0
  60. package/icons/check-circle.svg +1 -0
  61. package/icons/clipboard-list.svg +1 -0
  62. package/icons/clock.svg +1 -0
  63. package/icons/coffee.svg +1 -0
  64. package/icons/edit.svg +1 -0
  65. package/icons/eye.svg +1 -0
  66. package/icons/git-branch.svg +1 -0
  67. package/icons/git-commit-horizontal.svg +1 -0
  68. package/icons/globe.svg +1 -0
  69. package/icons/history.svg +1 -0
  70. package/icons/import.svg +1 -0
  71. package/icons/inbox.svg +1 -0
  72. package/icons/key-round.svg +1 -0
  73. package/icons/layout-grid.svg +1 -0
  74. package/icons/mail.svg +1 -0
  75. package/icons/message-circle.svg +1 -0
  76. package/icons/message-square.svg +1 -0
  77. package/icons/meter-vertical.svg +1 -0
  78. package/icons/mic.svg +1 -0
  79. package/icons/monitor.svg +1 -0
  80. package/icons/pen-line.svg +1 -0
  81. package/icons/plug.svg +1 -0
  82. package/icons/radio-dot.svg +1 -0
  83. package/icons/radio.svg +1 -0
  84. package/icons/refresh.svg +1 -0
  85. package/icons/rocket.svg +1 -0
  86. package/icons/search.svg +1 -0
  87. package/icons/shield.svg +1 -0
  88. package/icons/sparkles.svg +1 -0
  89. package/icons/square-kanban.svg +1 -0
  90. package/icons/terminal.svg +1 -0
  91. package/icons/users.svg +1 -0
  92. package/icons/volume-2.svg +1 -0
  93. package/icons/wand.svg +1 -0
  94. package/icons/wrench.svg +1 -0
  95. package/icons/x-circle.svg +1 -0
  96. package/icons/x.svg +1 -0
  97. package/ignore-semantics.ts +76 -0
  98. package/lazy-loading-metrics.mjs +61 -0
  99. package/new-session-cwd.test.mjs +389 -0
  100. package/new-session-cwd.ts +253 -0
  101. package/open-viewer-window.ts +65 -0
  102. package/overlay-back-client.test.mjs +123 -0
  103. package/overlay-back-client.ts +87 -0
  104. package/package.json +65 -4
  105. package/pi-fork-rpc/README.md +12 -0
  106. package/pi-fork-rpc/cli-resolve.test.mjs +42 -0
  107. package/pi-fork-rpc/cli-resolve.ts +79 -0
  108. package/pi-fork-rpc/remote-queue.test.mjs +100 -0
  109. package/pi-fork-rpc/remote-queue.ts +140 -0
  110. package/pi-fork-rpc/spec.ts +106 -0
  111. package/pi-fork-rpc/wire.test.mjs +260 -0
  112. package/pi-fork-rpc/wire.ts +367 -0
  113. package/popup-anchor.ts +45 -0
  114. package/provider-priority-contract.test.mjs +55 -0
  115. package/reconcile-deps.mjs +41 -0
  116. package/reload-instances.mjs +60 -0
  117. package/seed-tool.test.mjs +95 -0
  118. package/seed-tool.ts +88 -0
  119. package/session-recycle.ts +109 -0
  120. package/shared-copy-sync.test.mjs +115 -0
  121. package/soffice-locate.ts +171 -0
  122. package/soffice-panel.ts +239 -0
  123. package/sync-dir.mjs +91 -0
  124. package/sync-dir.test.mjs +101 -0
  125. package/sync-gate.test.mjs +93 -0
  126. package/sync-mirror.test.mjs +85 -0
  127. package/task-list.test.mjs +91 -0
  128. package/task-list.ts +118 -0
  129. package/test-rm-rf.mjs +33 -0
  130. package/ui-dialogs.test.mjs +198 -0
  131. package/ui-dialogs.ts +310 -0
@@ -0,0 +1,348 @@
1
+ /**
2
+ * ext-float-dock-core tests — 左栏 dock 区块栈纯状态层(排序/折叠/旧 key 迁移)。
3
+ *
4
+ * Run: node --experimental-strip-types --test pi-web-ext/_shared/ext-float-dock-core.test.mjs
5
+ *
6
+ * 覆盖(sidebar 统一 dock 方案 §3.1/§3.6/§3.8 实施期出过 tie-break bug 的逻辑):
7
+ * effectiveBlockOrder(用户序∩在场键 + priority 稳定补尾)/ moveBlockKey(邻居交换与
8
+ * 边界 no-op)/ moveBlockTo(拖拽落位前/后插入)/ 折叠与排序持久化事件 / 四旧折叠
9
+ * key 迁移(含 file-explorer 语义取反、旧 key 保留、新键不覆盖)。
10
+ *
11
+ * 桩:window(dispatchEvent/addEventListener 记录)+ localStorage(内存 Map)——
12
+ * core 顶层零副作用,仅在函数体内触碰全局,桩在 import 前就位即可。
13
+ */
14
+ import assert from "node:assert/strict";
15
+ import test from "node:test";
16
+
17
+ const store = new Map();
18
+ const dispatched = [];
19
+ globalThis.localStorage = {
20
+ getItem: (k) => (store.has(k) ? store.get(k) : null),
21
+ setItem: (k, v) => store.set(k, String(v)),
22
+ removeItem: (k) => store.delete(k),
23
+ };
24
+ globalThis.window = {
25
+ dispatchEvent: (e) => { dispatched.push(e); return true; },
26
+ addEventListener: () => {},
27
+ removeEventListener: () => {},
28
+ };
29
+
30
+ const {
31
+ SIDEBAR_COLLAPSE_EVENT,
32
+ SIDEBAR_ORDER_EVENT,
33
+ effectiveBlockOrder,
34
+ isSidebarDockState,
35
+ migrateLegacyCollapseKeys,
36
+ moveBlockKey,
37
+ moveBlockTo,
38
+ readBlockCollapsed,
39
+ readDockOrder,
40
+ seedBlockCollapsedDefault,
41
+ sidebarZoneOf,
42
+ writeBlockCollapsed,
43
+ writeDockOrder,
44
+ } = await import("./ext-float-dock-core.ts");
45
+
46
+ test("effectiveBlockOrder: 空用户序时按 priority 稳定排序(项目0→任务1→文件2→停靠3+)", () => {
47
+ const entries = [
48
+ { key: "asr", priority: 3 },
49
+ { key: "fleet", priority: 1 },
50
+ { key: "folder:b", priority: 2 },
51
+ { key: "projects", priority: 0 },
52
+ { key: "prompts", priority: 3 },
53
+ { key: "folder:a", priority: 2 },
54
+ ];
55
+ assert.deepEqual(
56
+ effectiveBlockOrder(entries, []).map((e) => e.key),
57
+ ["projects", "fleet", "folder:b", "folder:a", "asr", "prompts"],
58
+ );
59
+ });
60
+
61
+ test("effectiveBlockOrder: 用户序在前(∩ 在场键),其余按 priority 补尾", () => {
62
+ const entries = [
63
+ { key: "projects", priority: 0 },
64
+ { key: "fleet", priority: 1 },
65
+ { key: "folder:a", priority: 2 },
66
+ { key: "prompts", priority: 3 },
67
+ ];
68
+ assert.deepEqual(
69
+ effectiveBlockOrder(entries, ["prompts", "projects", "不存在键"]).map((e) => e.key),
70
+ ["prompts", "projects", "fleet", "folder:a"],
71
+ );
72
+ });
73
+
74
+ test("isSidebarDockState: 规范 sidebar:* 与旧 sidebar-explorer 都命中,右栏/浮窗不命中", () => {
75
+ assert.equal(isSidebarDockState("docked:sidebar:aiti-prompts:panel"), true);
76
+ assert.equal(isSidebarDockState("docked:sidebar-explorer"), true);
77
+ assert.equal(isSidebarDockState("docked:right-panel"), false);
78
+ assert.equal(isSidebarDockState("floating"), false);
79
+ assert.equal(isSidebarDockState("closed"), false);
80
+ });
81
+
82
+ test("sidebarZoneOf: blockKey 即 itemKey", () => {
83
+ assert.equal(sidebarZoneOf("aiti-prompts:panel"), "sidebar:aiti-prompts:panel");
84
+ });
85
+
86
+ test("writeBlockCollapsed/readBlockCollapsed 往返 + 事件广播", () => {
87
+ dispatched.length = 0;
88
+ assert.equal(readBlockCollapsed("x"), false);
89
+ writeBlockCollapsed("x", true);
90
+ assert.equal(readBlockCollapsed("x"), true);
91
+ assert.equal(dispatched.filter((e) => e.type === SIDEBAR_COLLAPSE_EVENT).length, 1);
92
+ });
93
+
94
+ test("seedBlockCollapsedDefault: 仅当无记录时播种,用户操作后永不覆盖", () => {
95
+ // 无记录 → 写默认折叠态
96
+ seedBlockCollapsedDefault("seed-proj", false);
97
+ assert.equal(readBlockCollapsed("seed-proj"), false);
98
+ seedBlockCollapsedDefault("seed-folder", true);
99
+ assert.equal(readBlockCollapsed("seed-folder"), true);
100
+ // 已有记录(用户手动)→ 不覆盖
101
+ writeBlockCollapsed("seed-folder", false);
102
+ seedBlockCollapsedDefault("seed-folder", true);
103
+ assert.equal(readBlockCollapsed("seed-folder"), false);
104
+ });
105
+
106
+ test("writeDockOrder/readDockOrder 往返 + 事件广播", () => {
107
+ dispatched.length = 0;
108
+ writeDockOrder(["b", "a"]);
109
+ assert.deepEqual(readDockOrder(), ["b", "a"]);
110
+ assert.equal(dispatched.filter((e) => e.type === SIDEBAR_ORDER_EVENT).length, 1);
111
+ });
112
+
113
+ test("moveBlockKey: 邻居交换 + 边界 no-op + 未知键 no-op", () => {
114
+ const keys = ["a", "b", "c"];
115
+ store.delete("pi:sidebar-dock:order");
116
+ moveBlockKey("b", -1, keys);
117
+ assert.deepEqual(readDockOrder(), ["b", "a", "c"]);
118
+ moveBlockKey("b", -1, keys); // 已在首位 → no-op
119
+ assert.deepEqual(readDockOrder(), ["b", "a", "c"]);
120
+ moveBlockKey("c", 1, keys); // 已在末位 → no-op
121
+ assert.deepEqual(readDockOrder(), ["b", "a", "c"]);
122
+ moveBlockKey("不存在", 1, keys);
123
+ assert.deepEqual(readDockOrder(), ["b", "a", "c"]);
124
+ });
125
+
126
+ test("moveBlockTo: 尊重既有用户序(真实有效序输入)", () => {
127
+ store.set("pi:sidebar-dock:order", JSON.stringify(["b", "a", "c"]));
128
+ moveBlockTo("a", "b", ["b", "a", "c"], true); // a 移到 b 之前
129
+ assert.deepEqual(readDockOrder(), ["a", "b", "c"]);
130
+ });
131
+
132
+ test("moveBlockTo: key===target no-op", () => {
133
+ store.set("pi:sidebar-dock:order", JSON.stringify(["a", "b"]));
134
+ moveBlockTo("a", "a", ["a", "b"], true);
135
+ assert.deepEqual(readDockOrder(), ["a", "b"]);
136
+ });
137
+
138
+ test("migrateLegacyCollapseKeys: 四旧 key 迁入(含 file-explorer 取反)且旧 key 保留", () => {
139
+ store.set("pi-web:sidebar-projects-collapsed", "1"); // sm 编码:折叠
140
+ store.set("pi-sidebar-tasks-collapsed", "false"); // 宿主编码:展开
141
+ store.set("pi-web:sidebar-explorer-dock-collapsed", "true"); // 折叠
142
+ store.set("pi-web:file-explorer:open", "false"); // 展开 → 折叠取反
143
+ migrateLegacyCollapseKeys();
144
+ assert.equal(readBlockCollapsed("projects"), true);
145
+ assert.equal(readBlockCollapsed("tasks"), false);
146
+ assert.equal(readBlockCollapsed("docks"), true);
147
+ assert.equal(readBlockCollapsed("files"), true);
148
+ // 旧 key 保留(回滚旧宿主仍可读)
149
+ assert.equal(store.get("pi-web:sidebar-projects-collapsed"), "1");
150
+ assert.equal(store.get("pi-web:file-explorer:open"), "false");
151
+ });
152
+
153
+ test("migrateLegacyCollapseKeys: 新 key 已存在时不覆盖", () => {
154
+ writeBlockCollapsed("projects", false);
155
+ migrateLegacyCollapseKeys(); // once 守卫在——直接断言不被覆盖即可
156
+ assert.equal(readBlockCollapsed("projects"), false);
157
+ });
158
+
159
+ /* ── v4 对齐分组:splitBlockAlign(上对齐/下对齐)── */
160
+
161
+ const { splitBlockAlign } = await import("./ext-float-dock-core.ts");
162
+
163
+ test("splitBlockAlign: 未声明 align 全部进默认组(top)", () => {
164
+ const entries = [{ key: "a" }, { key: "b" }];
165
+ const { top, bottom } = splitBlockAlign(entries);
166
+ assert.deepEqual(top.map((e) => e.key), ["a", "b"]);
167
+ assert.deepEqual(bottom, []);
168
+ });
169
+
170
+ test("splitBlockAlign: 混合分组保持有效序的组内相对序(项目/定时任务钉顶,文件夹/停靠钉底)", () => {
171
+ // 模拟 DockStack 构造产物:blocks 缺省 top、dockable item 缺省 bottom
172
+ const entries = [
173
+ { key: "projects", align: "top" },
174
+ { key: "aiti-ai-schedule:panel", align: "top" },
175
+ { key: "folder:/a", align: "bottom" },
176
+ { key: "aiti-prompts:panel", align: "bottom" },
177
+ { key: "aiti-ai-input:asr", align: "bottom" },
178
+ ];
179
+ const { top, bottom } = splitBlockAlign(entries, "top");
180
+ assert.deepEqual(top.map((e) => e.key), ["projects", "aiti-ai-schedule:panel"]);
181
+ assert.deepEqual(bottom.map((e) => e.key), ["folder:/a", "aiti-prompts:panel", "aiti-ai-input:asr"]);
182
+ });
183
+
184
+ test("splitBlockAlign: defaultAlign=bottom(dockable 缺省下对齐语义)", () => {
185
+ const entries = [{ key: "x" }, { key: "y", align: "top" }];
186
+ const { top, bottom } = splitBlockAlign(entries, "bottom");
187
+ assert.deepEqual(top.map((e) => e.key), ["y"]);
188
+ assert.deepEqual(bottom.map((e) => e.key), ["x"]);
189
+ });
190
+
191
+ test("splitBlockAlign: 用户改序后组内序跟随(跨组移动被容器钳制,此处只验分组纯函数)", () => {
192
+ // 用户把定时任务移到项目之前(同组内合法):有效序 [sched, projects] → top 组同序
193
+ const entries = [
194
+ { key: "aiti-ai-schedule:panel", align: "top" },
195
+ { key: "projects", align: "top" },
196
+ { key: "folder:/a", align: "bottom" },
197
+ ];
198
+ const { top, bottom } = splitBlockAlign(entries, "top");
199
+ assert.deepEqual(top.map((e) => e.key), ["aiti-ai-schedule:panel", "projects"]);
200
+ assert.deepEqual(bottom.map((e) => e.key), ["folder:/a"]);
201
+ });
202
+
203
+ /* ── v3 dock 头工具条 store:actions/commands/state/menuItems/pending ── */
204
+
205
+ const { createDockHeaderStore, DOCK_HEADER_PENDING_TTL } = await import("./ext-float-dock-core.ts");
206
+
207
+ function freshStore() {
208
+ const s = createDockHeaderStore();
209
+ const notes = new Map(); // key -> count
210
+ let sub = null;
211
+ return {
212
+ s,
213
+ notes,
214
+ watch(key) { notes.set(key, 0); sub = s.subscribe(key, () => notes.set(key, (notes.get(key) || 0) + 1)); },
215
+ unwatch() { sub && sub(); sub = null; },
216
+ };
217
+ }
218
+
219
+ test("headerStore: register 部分字段合并 + 读取", () => {
220
+ const { s } = freshStore();
221
+ const un = s.register("k", { actions: [{ id: "a", title: "A", onClick: () => {} }], state: { open: true } });
222
+ assert.equal(s.actionsOf("k")?.length, 1);
223
+ assert.deepEqual(s.stateOf("k"), { open: true });
224
+ assert.equal(s.commandsOf("k"), null);
225
+ assert.equal(s.menuItemsOf("k"), null);
226
+ // 再注册 commands/menuItems(合并)
227
+ s.register("k", { commands: { go: () => {} }, menuItems: [{ kind: "item", label: "X", run: () => {} }] });
228
+ assert.equal(typeof s.commandsOf("k")?.go, "function");
229
+ assert.equal(s.menuItemsOf("k")?.length, 1);
230
+ assert.equal(s.actionsOf("k")?.length, 1); // 未被覆盖
231
+ un(); // disposer 清本次 actions/state
232
+ assert.equal(s.actionsOf("k"), null);
233
+ assert.deepEqual(s.stateOf("k"), {});
234
+ assert.equal(s.menuItemsOf("k")?.length, 1); // 非本次注册字段保留
235
+ });
236
+
237
+ test("headerStore: state 签名去重(同值不通知,变化通知)", () => {
238
+ const { s, notes, watch } = freshStore();
239
+ watch("k");
240
+ s.register("k", { state: { a: 1 } });
241
+ assert.equal(notes.get("k"), 1);
242
+ s.register("k", { state: { a: 1 } }); // 同值(新引用)→ 不通知
243
+ assert.equal(notes.get("k"), 1);
244
+ s.register("k", { state: { a: 2 } });
245
+ assert.equal(notes.get("k"), 2);
246
+ });
247
+
248
+ test("headerStore: actions 签名变化通知(onClick 变化不通知,视觉字段变化通知)", () => {
249
+ const { s, notes, watch } = freshStore();
250
+ watch("k");
251
+ const mk = (active) => [{ id: "a", title: "A", active, onClick: () => {} }];
252
+ s.register("k", { actions: mk(false) });
253
+ assert.equal(notes.get("k"), 1);
254
+ s.register("k", { actions: mk(false) }); // 仅 onClick 新引用 → 不通知
255
+ assert.equal(notes.get("k"), 1);
256
+ s.register("k", { actions: mk(true) });
257
+ assert.equal(notes.get("k"), 2);
258
+ });
259
+
260
+ test("headerStore: request 命中命令(payload 透传)", () => {
261
+ const { s } = freshStore();
262
+ const seen = [];
263
+ s.register("k", { commands: { go: (p) => seen.push(p) } });
264
+ assert.equal(s.request("k", "go", { x: 1 }), true);
265
+ assert.deepEqual(seen, [{ x: 1 }]);
266
+ });
267
+
268
+ test("headerStore: request 未命中 → 展开 + pending,命令注册时补跑一次(payload 保留)", () => {
269
+ const { s } = freshStore();
270
+ const key = "aiti-demo:panel";
271
+ writeBlockCollapsed(key, true);
272
+ const seen = [];
273
+ assert.equal(s.request(key, "search", { anchor: { top: 10 } }), false);
274
+ assert.equal(readBlockCollapsed(key), false); // 自动展开
275
+ s.register(key, { commands: { search: (p) => seen.push(p) } });
276
+ assert.deepEqual(seen, [{ anchor: { top: 10 } }]); // 补跑
277
+ s.register(key, { commands: { search: (p) => seen.push(p) } }); // pending 已清,不重复
278
+ assert.equal(seen.length, 1);
279
+ });
280
+
281
+ test("headerStore: pending TTL 过期不执行", () => {
282
+ const { s } = freshStore();
283
+ const key = "aiti-demo:ttl";
284
+ const realNow = Date.now;
285
+ let now = 1_000_000;
286
+ Date.now = () => now;
287
+ try {
288
+ s.request(key, "x");
289
+ now += DOCK_HEADER_PENDING_TTL + 1;
290
+ const seen = [];
291
+ s.register(key, { commands: { x: () => seen.push(1) } });
292
+ assert.equal(seen.length, 0);
293
+ } finally {
294
+ Date.now = realNow;
295
+ }
296
+ });
297
+
298
+ test("headerStore: 多 key 隔离", () => {
299
+ const { s } = freshStore();
300
+ s.register("k1", { state: { v: 1 } });
301
+ s.register("k2", { state: { v: 2 } });
302
+ assert.deepEqual(s.stateOf("k1"), { v: 1 });
303
+ assert.deepEqual(s.stateOf("k2"), { v: 2 });
304
+ s.request("k2", "only2");
305
+ const seen = [];
306
+ s.register("k1", { commands: { only2: () => seen.push("k1") } });
307
+ assert.equal(seen.length, 0); // k1 不消费 k2 的 pending
308
+ s.register("k2", { commands: { only2: () => seen.push("k2") } });
309
+ assert.deepEqual(seen, ["k2"]);
310
+ });
311
+
312
+ test("positionMenuItems/positionMenuModel(v5 图标排):icon/isDefault/active 与浮窗项", async () => {
313
+ const { positionMenuItems, positionMenuModel } = await import("./ext-float-dock-core.ts");
314
+ // 两 zone(sidebar 族 + 右栏),默认 sidebar;当前态 = 右栏停靠
315
+ const items = positionMenuItems("x:p", ["sidebar:x:p", "right-panel"], "sidebar:x:p", "docked:right-panel");
316
+ assert.deepEqual(items.map((i) => i.key), ["sidebar-explorer", "right-panel"], "sidebar 族折叠成一项");
317
+ assert.deepEqual(items.map((i) => i.icon), ["panel-left", "panel-right"], "方位图标名");
318
+ assert.deepEqual(items.map((i) => i.isDefault), [true, false], "默认位判定");
319
+ assert.deepEqual(items.map((i) => i.active), [false, true], "当前态判定(族兼容)");
320
+ // 模型含浮窗项且在最前;浮窗态时 active
321
+ const model = positionMenuModel("x:p", ["sidebar:x:p", "right-panel"], "right-panel", "floating");
322
+ assert.deepEqual(model.map((i) => i.key), ["float", "sidebar-explorer", "right-panel"], "浮窗 → 各停靠位");
323
+ assert.equal(model[0].icon, "float");
324
+ assert.equal(model[0].active, true, "浮窗态高亮");
325
+ assert.equal(model[2].isDefault, true, "右栏默认位");
326
+ // 「新窗口打开」项(2026-09-15 拍板):提供 onNewWindow 时排最前(B 图标),
327
+ // 不提供且无注册 = 不显示(「有些暂时不支持」能力注册决定)
328
+ const withWin = positionMenuModel("x:p", ["sidebar:x:p", "right-panel"], "right-panel", "floating", { onNewWindow: () => {} });
329
+ assert.deepEqual(withWin.map((i) => i.key), ["new-window", "float", "sidebar-explorer", "right-panel"], "新窗口 → 浮窗 → 各停靠位");
330
+ assert.equal(withWin[0].icon, "new-window");
331
+ assert.equal(withWin[0].active, undefined, "新窗口项非位置态(role=menuitem)");
332
+ });
333
+
334
+ test("resolveDropZone/SIDEBAR_DROP_ZONE(drag-drop-unify §3.1):通配 sidebar 落点解析", async () => {
335
+ const { resolveDropZone, SIDEBAR_DROP_ZONE } = await import("./ext-float-dock-core.ts");
336
+ assert.equal(SIDEBAR_DROP_ZONE, "sidebar");
337
+ // 精确命中:marker 在面板声明 zones 里原样返回(现有右栏行为不变)
338
+ assert.equal(resolveDropZone("right-panel", ["sidebar:x:p", "right-panel"]), "right-panel");
339
+ // 通配:公共落点 "sidebar" → 面板声明的第一个 sidebar:* zone
340
+ assert.equal(resolveDropZone("sidebar", ["right-panel", "sidebar:x:p"]), "sidebar:x:p");
341
+ // 旧值 sidebar-explorer 一并认
342
+ assert.equal(resolveDropZone("sidebar", ["sidebar-explorer"]), "sidebar-explorer");
343
+ // 面板未声明 sidebar 族 → 不入位
344
+ assert.equal(resolveDropZone("sidebar", ["right-panel"]), null);
345
+ // marker 不在声明集且非通配 → 不入位
346
+ assert.equal(resolveDropZone("right-panel", ["sidebar:x:p"]), null);
347
+ assert.equal(resolveDropZone("", ["right-panel"]), null);
348
+ });