@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.
- package/LICENSE +21 -0
- package/README.md +36 -2
- package/agent-accounts.test.mjs +227 -0
- package/agent-accounts.ts +324 -0
- package/agent-capability-contract.test.mjs +129 -0
- package/agent-interaction.test.mjs +194 -0
- package/agent-interaction.ts +340 -0
- package/agent-launch.test.mjs +262 -0
- package/agent-spawn-env.test.mjs +169 -0
- package/agent-spawn-env.ts +548 -0
- package/aiti-editor-inject.mjs +49 -0
- package/backend-queue.test.mjs +336 -0
- package/backend-queue.ts +469 -0
- package/blob-save-route.ts +128 -0
- package/cbc-model-catalog.ts +86 -0
- package/check-client.mjs +273 -0
- package/check-ext-globals.mjs +144 -0
- package/controlled-login-dialog.mjs +270 -0
- package/controlled-login.mjs +398 -0
- package/controlled-login.test.mjs +466 -0
- package/convert-saveas.test.mjs +39 -0
- package/convert-saveas.ts +170 -0
- package/copy-client-bundle.mjs +39 -0
- package/cursor-cli-store.ts +377 -0
- package/dedupe-fetch.test.mjs +71 -0
- package/dedupe-fetch.ts +58 -0
- package/deploy-commit.mjs +52 -0
- package/dev-pack.mjs +246 -0
- package/dock-icons.ts +127 -0
- package/esbuild-bin.test.mjs +53 -0
- package/esbuild-bin.ts +66 -0
- package/exec-async.test.mjs +86 -0
- package/exec-async.ts +179 -0
- package/ext-display-names.ts +91 -0
- package/ext-entry-contracts.test.mjs +131 -0
- package/ext-float-dock-core.test.mjs +348 -0
- package/ext-float-dock-core.ts +783 -0
- package/ext-float-dock-lite.ts +52 -0
- package/ext-float-dock.test.mjs +286 -0
- package/ext-float-dock.ts +740 -0
- package/ext-icons-deploy.mjs +24 -0
- package/ext-lazy.test.mjs +186 -0
- package/ext-lazy.tsx +183 -0
- package/ext-model-state.test.mjs +272 -0
- package/ext-model-state.ts +324 -0
- package/ext-protocol.mjs +113 -0
- package/ext-protocol.test.mjs +88 -0
- package/ext-session-usage.test.mjs +219 -0
- package/ext-session-usage.ts +507 -0
- package/external-cli-governance.ts +153 -0
- package/git-ops-client/api.mjs +56 -0
- package/git-ops-client/branch-panel.tsx +987 -0
- package/git-ops-client/i18n.mjs +328 -0
- package/host-tools-allow.test.mjs +46 -0
- package/host-tools-allow.ts +84 -0
- package/icons/alert.svg +1 -0
- package/icons/bookmark.svg +1 -0
- package/icons/bot.svg +1 -0
- package/icons/chart-column.svg +1 -0
- package/icons/check-circle.svg +1 -0
- package/icons/clipboard-list.svg +1 -0
- package/icons/clock.svg +1 -0
- package/icons/coffee.svg +1 -0
- package/icons/edit.svg +1 -0
- package/icons/eye.svg +1 -0
- package/icons/git-branch.svg +1 -0
- package/icons/git-commit-horizontal.svg +1 -0
- package/icons/globe.svg +1 -0
- package/icons/history.svg +1 -0
- package/icons/import.svg +1 -0
- package/icons/inbox.svg +1 -0
- package/icons/key-round.svg +1 -0
- package/icons/layout-grid.svg +1 -0
- package/icons/mail.svg +1 -0
- package/icons/message-circle.svg +1 -0
- package/icons/message-square.svg +1 -0
- package/icons/meter-vertical.svg +1 -0
- package/icons/mic.svg +1 -0
- package/icons/monitor.svg +1 -0
- package/icons/pen-line.svg +1 -0
- package/icons/plug.svg +1 -0
- package/icons/radio-dot.svg +1 -0
- package/icons/radio.svg +1 -0
- package/icons/refresh.svg +1 -0
- package/icons/rocket.svg +1 -0
- package/icons/search.svg +1 -0
- package/icons/shield.svg +1 -0
- package/icons/sparkles.svg +1 -0
- package/icons/square-kanban.svg +1 -0
- package/icons/terminal.svg +1 -0
- package/icons/users.svg +1 -0
- package/icons/volume-2.svg +1 -0
- package/icons/wand.svg +1 -0
- package/icons/wrench.svg +1 -0
- package/icons/x-circle.svg +1 -0
- package/icons/x.svg +1 -0
- package/ignore-semantics.ts +76 -0
- package/lazy-loading-metrics.mjs +61 -0
- package/new-session-cwd.test.mjs +389 -0
- package/new-session-cwd.ts +253 -0
- package/open-viewer-window.ts +65 -0
- package/overlay-back-client.test.mjs +123 -0
- package/overlay-back-client.ts +87 -0
- package/package.json +65 -4
- package/pi-fork-rpc/README.md +12 -0
- package/pi-fork-rpc/cli-resolve.test.mjs +42 -0
- package/pi-fork-rpc/cli-resolve.ts +79 -0
- package/pi-fork-rpc/remote-queue.test.mjs +100 -0
- package/pi-fork-rpc/remote-queue.ts +140 -0
- package/pi-fork-rpc/spec.ts +106 -0
- package/pi-fork-rpc/wire.test.mjs +260 -0
- package/pi-fork-rpc/wire.ts +367 -0
- package/popup-anchor.ts +45 -0
- package/provider-priority-contract.test.mjs +55 -0
- package/reconcile-deps.mjs +41 -0
- package/reload-instances.mjs +60 -0
- package/seed-tool.test.mjs +95 -0
- package/seed-tool.ts +88 -0
- package/session-recycle.ts +109 -0
- package/shared-copy-sync.test.mjs +115 -0
- package/soffice-locate.ts +171 -0
- package/soffice-panel.ts +239 -0
- package/sync-dir.mjs +91 -0
- package/sync-dir.test.mjs +101 -0
- package/sync-gate.test.mjs +93 -0
- package/sync-mirror.test.mjs +85 -0
- package/task-list.test.mjs +91 -0
- package/task-list.ts +118 -0
- package/test-rm-rf.mjs +33 -0
- package/ui-dialogs.test.mjs +198 -0
- package/ui-dialogs.ts +310 -0
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* _shared/ext-float-dock-lite.ts — dock/present 状态机的 **壳用薄层**(P1-3,方案
|
|
3
|
+
* pi-web-eager-ext-split-plan.md §6 P1-3)。
|
|
4
|
+
*
|
|
5
|
+
* eager 薄壳(拆包扩展 entry)只需要:usePresent/useGate(门控 hooks)+ present
|
|
6
|
+
* 状态机小 API(openFloat/closePanel/seedDockDefault/declareDockZones…)。
|
|
7
|
+
* 本模块 = 这层最小面(hooks 在此、状态机 re-export 自 ext-float-dock-core),
|
|
8
|
+
* **不含 DockBody/头行 UI**——那些留在 ext-float-dock.ts(重模块,随懒 chunk 走)。
|
|
9
|
+
* 拆包扩展的壳 import 本文件,首屏不再连带 17+ KB 的 dock UI 层。
|
|
10
|
+
*
|
|
11
|
+
* 未拆包扩展可继续 import ext-float-dock.ts(全量面,re-export 本模块,行为不变)。
|
|
12
|
+
*/
|
|
13
|
+
import { useEffect, useState } from "react";
|
|
14
|
+
import { presentState, onPresentChange, CHANGE_EVENT } from "./ext-float-dock-core";
|
|
15
|
+
import type { PresentState, DockZone } from "./ext-float-dock-core";
|
|
16
|
+
|
|
17
|
+
// 纯状态层全量转出:壳只 import 本模块即可覆盖 register 期 + 门控 + 开关
|
|
18
|
+
export {
|
|
19
|
+
present, presentState, onPresentChange, dockPref,
|
|
20
|
+
openFloat, closePanel, dockTo, dockToSidebar, undockToFloat,
|
|
21
|
+
setDockPref, clearDockPref, seedDockDefault, declareDockZones,
|
|
22
|
+
positionMenuItems, DOCK_ZONE_LABELS,
|
|
23
|
+
sidebarZoneOf, isSidebarDockState,
|
|
24
|
+
type DockZone, type PresentState,
|
|
25
|
+
} from "./ext-float-dock-core";
|
|
26
|
+
|
|
27
|
+
export function usePresent(itemKey: string): PresentState {
|
|
28
|
+
const [state, setState] = useState<PresentState>(() => presentState(itemKey));
|
|
29
|
+
useEffect(() => {
|
|
30
|
+
setState(presentState(itemKey));
|
|
31
|
+
// 双通道订阅(时序免疫,2026-09-12 修「All Sessions 打不开」):本组件挂载若早于
|
|
32
|
+
// aiti-float install(bundle 就绪顺序竞态),floatApi() 为 null → onPresentChange
|
|
33
|
+
// 订阅落进下方降级 store,此后 __piweFloat 状态机的更新永远收不到 → 面板 gate
|
|
34
|
+
// 恒 closed 打不开。两条状态机(api 状态机与降级 localPresent)都广播同名
|
|
35
|
+
// window CHANGE_EVENT,挂 window 兜底监听即可双向覆盖;api 在场时双通道同值
|
|
36
|
+
// 触发,setState 同值幂等无害。
|
|
37
|
+
const h = ((e: CustomEvent<{ key: string; state: PresentState }>) => {
|
|
38
|
+
if (e.detail?.key === itemKey) setState(e.detail.state);
|
|
39
|
+
}) as EventListener;
|
|
40
|
+
window.addEventListener(CHANGE_EVENT, h);
|
|
41
|
+
const off = onPresentChange((d) => { if (d.key === itemKey) setState(d.state); });
|
|
42
|
+
return () => { window.removeEventListener(CHANGE_EVENT, h); off(); };
|
|
43
|
+
}, [itemKey]);
|
|
44
|
+
return state;
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
/** 渲染门控(结构性防双开):face="float" → 仅浮窗态渲染;face={dock:zone} → 仅对应嵌入态渲染。 */
|
|
48
|
+
export function useGate(itemKey: string, face: "float" | { dock: DockZone }): boolean {
|
|
49
|
+
const state = usePresent(itemKey);
|
|
50
|
+
if (face === "float") return state === "floating";
|
|
51
|
+
return state === `docked:${face.dock}`;
|
|
52
|
+
}
|
|
@@ -0,0 +1,286 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* ext-float-dock 降级层单测(node --test)。
|
|
3
|
+
*
|
|
4
|
+
* 覆盖点(dock v3.1 置前修复的降级语义,方案 position-picker-plan §11.3 补测三):
|
|
5
|
+
* 1. 未装 aiti-float 时 localPresent 可停靠/回浮窗/关闭;
|
|
6
|
+
* 2. 同态 docked 再 open/dock:同区 → 广播 piwe-float-present-activate(宿主置前依据);
|
|
7
|
+
* 3. floating 幂等 open 不发 activate;
|
|
8
|
+
* 4. declareDockZones/seedDockDefault 可用(TabBar ⇱ 菜单数据源)。
|
|
9
|
+
*
|
|
10
|
+
* helper 是 TS + react import(各扩展 vite 构建内联),node 直读不了——
|
|
11
|
+
* 先用 esbuild 打包为可测 bundle(react 用 stub 替身,本文件只驱动非 React 出口)。
|
|
12
|
+
* ⚠ 桩必须先于 bundle import 安装:helper 顶层在 import 时就注册 window 监听。
|
|
13
|
+
*/
|
|
14
|
+
import { test } from "node:test";
|
|
15
|
+
import assert from "node:assert/strict";
|
|
16
|
+
import { runEsbuild } from "./esbuild-bin.ts";
|
|
17
|
+
import { mkdtempSync, writeFileSync, rmSync } from "node:fs";
|
|
18
|
+
import { tmpdir } from "node:os";
|
|
19
|
+
import { join, dirname } from "node:path";
|
|
20
|
+
import { fileURLToPath, pathToFileURL } from "node:url";
|
|
21
|
+
|
|
22
|
+
const here = dirname(fileURLToPath(import.meta.url));
|
|
23
|
+
|
|
24
|
+
/** 极简 window/document/localStorage 桩:足够 helper 顶层监听注册与事件广播。 */
|
|
25
|
+
function makeDomStub() {
|
|
26
|
+
const listeners = new Map(); // type -> Set<fn>
|
|
27
|
+
const storage = new Map();
|
|
28
|
+
const makeEl = (tag = "div") => {
|
|
29
|
+
const el = {
|
|
30
|
+
tag, style: {}, className: "", textContent: "", children: [], attrs: {}, handlers: {}, parentElement: null,
|
|
31
|
+
setAttribute(k, v) { this.attrs[k] = String(v); },
|
|
32
|
+
getAttribute(k) { return this.attrs[k] ?? null; },
|
|
33
|
+
removeAttribute(k) { delete this.attrs[k]; },
|
|
34
|
+
appendChild(c) { this.children.push(c); c.parentElement = this; },
|
|
35
|
+
remove() {
|
|
36
|
+
const p = this.parentElement;
|
|
37
|
+
if (!p) return;
|
|
38
|
+
const i = p.children.indexOf(this);
|
|
39
|
+
if (i >= 0) p.children.splice(i, 1);
|
|
40
|
+
this.parentElement = null;
|
|
41
|
+
},
|
|
42
|
+
addEventListener(type, fn) { (this.handlers[type] ||= []).push(fn); },
|
|
43
|
+
removeEventListener(type, fn) { this.handlers[type] = (this.handlers[type] || []).filter((f) => f !== fn); },
|
|
44
|
+
click() { for (const fn of this.handlers.click || []) fn({ target: this, stopPropagation() {} }); },
|
|
45
|
+
querySelector: () => null,
|
|
46
|
+
querySelectorAll: (sel) => (sel === "button" ? this.children.filter((c) => c.tag === "button") : []),
|
|
47
|
+
contains: (n) => { for (const c of this.children) { if (c === n || c.contains(n)) return true; } return false; },
|
|
48
|
+
};
|
|
49
|
+
return el;
|
|
50
|
+
};
|
|
51
|
+
const window = {
|
|
52
|
+
addEventListener(type, fn) {
|
|
53
|
+
if (!listeners.has(type)) listeners.set(type, new Set());
|
|
54
|
+
listeners.get(type).add(fn);
|
|
55
|
+
},
|
|
56
|
+
removeEventListener(type, fn) { listeners.get(type)?.delete(fn); },
|
|
57
|
+
dispatchEvent(ev) {
|
|
58
|
+
for (const fn of listeners.get(ev.type) ?? []) fn(ev);
|
|
59
|
+
return true;
|
|
60
|
+
},
|
|
61
|
+
innerWidth: 1600, innerHeight: 900,
|
|
62
|
+
localStorage: {
|
|
63
|
+
getItem: (k) => (storage.has(k) ? storage.get(k) : null),
|
|
64
|
+
setItem: (k, v) => storage.set(k, String(v)),
|
|
65
|
+
removeItem: (k) => storage.delete(k),
|
|
66
|
+
},
|
|
67
|
+
};
|
|
68
|
+
const document = {
|
|
69
|
+
getElementById: () => makeEl(),
|
|
70
|
+
createElement: (tag) => makeEl(tag),
|
|
71
|
+
createElementNS: (_ns, tag) => makeEl(tag),
|
|
72
|
+
querySelector: () => null,
|
|
73
|
+
querySelectorAll: () => [],
|
|
74
|
+
addEventListener() {}, removeEventListener() {},
|
|
75
|
+
head: { appendChild() {} }, body: makeEl("body"),
|
|
76
|
+
};
|
|
77
|
+
return { window, document, listeners };
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
test("降级层:停靠/回浮窗/关闭 + 同态 open 广播 activate + 注册表", async (t) => {
|
|
81
|
+
const dir = mkdtempSync(join(tmpdir(), "efd-test-"));
|
|
82
|
+
t.after(() => rmSync(dir, { recursive: true, force: true }));
|
|
83
|
+
|
|
84
|
+
// 1) esbuild 打包 helper(react → stub)
|
|
85
|
+
const esbuildBin = join(here, "..", "aiti-float", "node_modules", "esbuild", "bin", "esbuild");
|
|
86
|
+
const reactStub = join(dir, "react-stub.js");
|
|
87
|
+
writeFileSync(reactStub,
|
|
88
|
+
"export const useEffect = () => {};\nexport const useState = (v) => [v, () => {}];\nexport const useLayoutEffect = () => {};\nexport const useRef = () => null;\nexport const createElement = () => null;\n");
|
|
89
|
+
const outfile = join(dir, "bundle.mjs");
|
|
90
|
+
await runEsbuild(esbuildBin, [join(here, "ext-float-dock.ts"), "--bundle", "--format=esm", "--platform=node",
|
|
91
|
+
"--alias:react=" + reactStub, "--outfile=" + outfile, "--log-level=error"]);
|
|
92
|
+
|
|
93
|
+
// 2) 先装全局桩,再 import bundle(helper 顶层注册 window 监听)
|
|
94
|
+
const dom = makeDomStub();
|
|
95
|
+
globalThis.window = dom.window;
|
|
96
|
+
globalThis.document = dom.document;
|
|
97
|
+
globalThis.CustomEvent = class {
|
|
98
|
+
constructor(type, opts) { this.type = type; if (opts && opts.detail !== undefined) this.detail = opts.detail; }
|
|
99
|
+
};
|
|
100
|
+
globalThis.localStorage = dom.window.localStorage;
|
|
101
|
+
t.after(() => {
|
|
102
|
+
delete globalThis.window;
|
|
103
|
+
delete globalThis.document;
|
|
104
|
+
delete globalThis.CustomEvent;
|
|
105
|
+
delete globalThis.localStorage;
|
|
106
|
+
});
|
|
107
|
+
|
|
108
|
+
const events = [];
|
|
109
|
+
dom.window.addEventListener("piwe-float-present-activate", (e) => events.push(["activate", e.detail.key, e.detail.state, e.detail.auto === true]));
|
|
110
|
+
dom.window.addEventListener("piwe-float-present-change", (e) => events.push(["change", e.detail.key, e.detail.state, e.detail.auto === true]));
|
|
111
|
+
|
|
112
|
+
const mod = await import(pathToFileURL(outfile).href);
|
|
113
|
+
|
|
114
|
+
// 关闭态 open → floating(降级语义),change 事件、无 activate
|
|
115
|
+
mod.present("t:panel", "open");
|
|
116
|
+
assert.equal(mod.presentState("t:panel"), "floating");
|
|
117
|
+
assert.ok(events.some(([type, key]) => type === "change" && key === "t:panel"), "closed→floating 应发 change");
|
|
118
|
+
assert.ok(!events.some(([type, key]) => type === "activate" && key === "t:panel"), "floating 不发 activate");
|
|
119
|
+
|
|
120
|
+
// 停靠右栏 → docked
|
|
121
|
+
mod.present("t:panel", "dock:right-panel");
|
|
122
|
+
assert.equal(mod.presentState("t:panel"), "docked:right-panel");
|
|
123
|
+
|
|
124
|
+
// 同态再 open → activate 广播(宿主置前依据),状态不变
|
|
125
|
+
events.length = 0;
|
|
126
|
+
mod.present("t:panel", "open");
|
|
127
|
+
assert.equal(mod.presentState("t:panel"), "docked:right-panel");
|
|
128
|
+
assert.deepEqual(events.find(([type]) => type === "activate")?.slice(1, 3), ["t:panel", "docked:right-panel"], "同态 docked open 应发 activate");
|
|
129
|
+
|
|
130
|
+
// auto 入栈(刷新恢复/项目联动同步)的 activate 透传 auto 标记:宿主据此不拉起小屏抽屉
|
|
131
|
+
events.length = 0;
|
|
132
|
+
mod.present("t:panel", "open", { auto: true });
|
|
133
|
+
assert.deepEqual(events.find(([type]) => type === "activate")?.slice(1), ["t:panel", "docked:right-panel", true], "auto 同态 open 的 activate 应带 auto");
|
|
134
|
+
|
|
135
|
+
// auto + 状态迁移(closed → docked)的 change 也透传 auto
|
|
136
|
+
events.length = 0;
|
|
137
|
+
mod.present("t:panel", "close");
|
|
138
|
+
events.length = 0;
|
|
139
|
+
mod.present("t:panel", "dock:right-panel", { auto: true });
|
|
140
|
+
assert.deepEqual(events.find(([type]) => type === "change")?.slice(1), ["t:panel", "docked:right-panel", true], "auto 迁移 change 应带 auto");
|
|
141
|
+
|
|
142
|
+
// 同态 dock:同区 → activate 同样广播
|
|
143
|
+
events.length = 0;
|
|
144
|
+
mod.present("t:panel", "dock:right-panel");
|
|
145
|
+
assert.ok(events.some(([type]) => type === "activate"), "dock:同区应发 activate");
|
|
146
|
+
|
|
147
|
+
// 浮窗态幂等 open 不发 activate
|
|
148
|
+
mod.present("t:panel", "float");
|
|
149
|
+
events.length = 0;
|
|
150
|
+
mod.present("t:panel", "open");
|
|
151
|
+
assert.equal(mod.presentState("t:panel"), "floating");
|
|
152
|
+
assert.ok(!events.some(([type]) => type === "activate"), "floating 幂等不发 activate");
|
|
153
|
+
|
|
154
|
+
// 注册表:declareDockZones/seedDockDefault 可用(⇱ 菜单数据源)
|
|
155
|
+
mod.declareDockZones("t:multi", ["sidebar-explorer", "right-panel"], "right-panel");
|
|
156
|
+
mod.seedDockDefault("t:multi", "right-panel");
|
|
157
|
+
assert.equal(mod.dockPref("t:multi"), "right-panel", "seed 已落 dockPref");
|
|
158
|
+
});
|
|
159
|
+
|
|
160
|
+
test("降级层:⇱ 菜单 DOM 构建与交互(float 缺席)", async (t) => {
|
|
161
|
+
const dir = mkdtempSync(join(tmpdir(), "efd-menu-"));
|
|
162
|
+
t.after(() => rmSync(dir, { recursive: true, force: true }));
|
|
163
|
+
|
|
164
|
+
const esbuildBin = join(here, "..", "aiti-float", "node_modules", "esbuild", "bin", "esbuild");
|
|
165
|
+
const reactStub = join(dir, "react-stub.js");
|
|
166
|
+
writeFileSync(reactStub,
|
|
167
|
+
"export const useEffect = () => {};\nexport const useState = (v) => [v, () => {}];\nexport const useLayoutEffect = () => {};\nexport const useRef = () => null;\nexport const createElement = () => null;\n");
|
|
168
|
+
const outfile = join(dir, "bundle.mjs");
|
|
169
|
+
await runEsbuild(esbuildBin, [join(here, "ext-float-dock.ts"), "--bundle", "--format=esm", "--platform=node",
|
|
170
|
+
"--alias:react=" + reactStub, "--outfile=" + outfile, "--log-level=error"]);
|
|
171
|
+
|
|
172
|
+
const dom = makeDomStub();
|
|
173
|
+
globalThis.window = dom.window;
|
|
174
|
+
globalThis.document = dom.document;
|
|
175
|
+
globalThis.CustomEvent = class {
|
|
176
|
+
constructor(type, opts) { this.type = type; if (opts && opts.detail !== undefined) this.detail = opts.detail; }
|
|
177
|
+
};
|
|
178
|
+
globalThis.localStorage = dom.window.localStorage;
|
|
179
|
+
// 注意:不删全局桩——菜单打开会注册 dismiss setTimeout(0),若测试同步结束后桩被删,
|
|
180
|
+
// 定时器回调将 ReferenceError 并把整个测试文件标记失败(node --test 文件级失败)。
|
|
181
|
+
t.after(() => rmSync(dir, { recursive: true, force: true }));
|
|
182
|
+
|
|
183
|
+
const mod = await import(pathToFileURL(outfile).href);
|
|
184
|
+
|
|
185
|
+
// 注册(多 zone + 默认)并停靠右栏(同时回归 docked: 规范态修复)
|
|
186
|
+
mod.declareDockZones("m:panel", ["right-panel"], "right-panel");
|
|
187
|
+
mod.present("m:panel", "dock:right-panel");
|
|
188
|
+
assert.equal(mod.presentState("m:panel"), "docked:right-panel", "停靠态应规范为 docked:<zone>");
|
|
189
|
+
|
|
190
|
+
// 派发宿主页签 ⇱ 事件 → 降级监听应构建统一位置菜单
|
|
191
|
+
dom.window.dispatchEvent({ type: "piwe-float-dock-menu", detail: { key: "m:panel", rect: { left: 100, bottom: 100 } } });
|
|
192
|
+
const menu = dom.document.body.children.find((c) => c.attrs["data-ext-dock-menu"]);
|
|
193
|
+
assert.ok(menu, "菜单应挂到 body");
|
|
194
|
+
// v5 图标排(方案 pi-web-dock-icon-row-plan):菜单内一行「名称 + 右对齐图标组」
|
|
195
|
+
const row = menu.children.find((c) => c.attrs["data-ext-dock-icon-row"] === "1");
|
|
196
|
+
assert.ok(row, "菜单内应有图标排行");
|
|
197
|
+
const label = row.children.find((c) => c.attrs["data-ext-dock-icon-row-label"] === "1");
|
|
198
|
+
assert.equal(label.textContent, "停靠方位", "行名称(参照菜单样式:名称左 + 图标右对齐)");
|
|
199
|
+
const group = row.children.find((c) => c.attrs["data-ext-dock-icon-group"] === "1");
|
|
200
|
+
assert.ok(group, "图标组容器");
|
|
201
|
+
const btns = group.children.filter((c) => c.tag === "button");
|
|
202
|
+
assert.equal(btns.length, 2, "浮窗 + 右栏 两个图标按钮");
|
|
203
|
+
const floatBtn = btns.find((b) => b.attrs["data-ext-dock-icon"] === "float");
|
|
204
|
+
const rightBtn = btns.find((b) => b.attrs["data-ext-dock-icon"] === "right-panel");
|
|
205
|
+
assert.ok(floatBtn && rightBtn, "图标按钮 data-ext-dock-icon 标注完整");
|
|
206
|
+
assert.equal(floatBtn.title, "浮窗", "浮窗 tooltip");
|
|
207
|
+
assert.equal(rightBtn.title, "右栏 · 面板(默认)", "默认位 tooltip 带(默认)");
|
|
208
|
+
assert.equal(rightBtn.attrs["aria-checked"], "true", "当前态 aria-checked");
|
|
209
|
+
assert.ok(rightBtn.children.some((g) => g.attrs["data-ext-dock-icon-default"] === "1"), "默认位圆点角标");
|
|
210
|
+
assert.ok(floatBtn.children.some((g) => g.tag === "svg"), "图标按钮内含 svg(桩 createElementNS)");
|
|
211
|
+
|
|
212
|
+
// 点「浮窗」→ 回浮窗
|
|
213
|
+
floatBtn.click();
|
|
214
|
+
assert.equal(mod.presentState("m:panel"), "floating", "选浮窗应回浮窗");
|
|
215
|
+
});
|
|
216
|
+
|
|
217
|
+
test("降级层:双内联副本共享 localStorage 状态——open/close 跨副本一致(folder 浮窗幽灵态回归)", async (t) => {
|
|
218
|
+
const dir = mkdtempSync(join(tmpdir(), "efd-twin-"));
|
|
219
|
+
t.after(() => rmSync(dir, { recursive: true, force: true }));
|
|
220
|
+
|
|
221
|
+
// 两份独立 bundle = 两个模块实例,模拟同一页面里 session-manager / aiti-folder
|
|
222
|
+
// 各自内联的 _shared 副本(本模块被多扩展构建期内联的现实形态)。
|
|
223
|
+
const esbuildBin = join(here, "..", "aiti-float", "node_modules", "esbuild", "bin", "esbuild");
|
|
224
|
+
const reactStub = join(dir, "react-stub.js");
|
|
225
|
+
writeFileSync(reactStub,
|
|
226
|
+
"export const useEffect = () => {};\nexport const useState = (v) => [v, () => {}];\nexport const useLayoutEffect = () => {};\nexport const useRef = () => null;\nexport const createElement = () => null;\n");
|
|
227
|
+
const bundle = async (name) => {
|
|
228
|
+
const outfile = join(dir, name);
|
|
229
|
+
// 派生形态(Linux 原生 ELF / Windows .exe 或 node 直跑 JS 入口)由 esbuild-bin 收口
|
|
230
|
+
await runEsbuild(esbuildBin, [join(here, "ext-float-dock.ts"), "--bundle", "--format=esm", "--platform=node",
|
|
231
|
+
"--alias:react=" + reactStub, "--outfile=" + outfile, "--log-level=error"]);
|
|
232
|
+
return outfile;
|
|
233
|
+
};
|
|
234
|
+
const outfileA = await bundle("bundle-a.mjs");
|
|
235
|
+
const outfileB = await bundle("bundle-b.mjs");
|
|
236
|
+
|
|
237
|
+
const dom = makeDomStub();
|
|
238
|
+
globalThis.window = dom.window;
|
|
239
|
+
globalThis.document = dom.document;
|
|
240
|
+
globalThis.CustomEvent = class {
|
|
241
|
+
constructor(type, opts) { this.type = type; if (opts && opts.detail !== undefined) this.detail = opts.detail; }
|
|
242
|
+
};
|
|
243
|
+
globalThis.localStorage = dom.window.localStorage;
|
|
244
|
+
// 注意:与上方 ⇱ 菜单测试同理,不删全局桩——另一副本的菜单/事件回调可能在
|
|
245
|
+
// 测试结束后异步触发(setTimeout(0) dismiss 注册),删桩会 ReferenceError 拖垮文件。
|
|
246
|
+
t.after(() => rmSync(dir, { recursive: true, force: true }));
|
|
247
|
+
|
|
248
|
+
const events = [];
|
|
249
|
+
dom.window.addEventListener("piwe-float-present-change", (e) => events.push(["change", e.detail.key, e.detail.state]));
|
|
250
|
+
|
|
251
|
+
const modA = await import(pathToFileURL(outfileA).href); // session-manager 内联份(open 发起方)
|
|
252
|
+
const modB = await import(pathToFileURL(outfileB).href); // aiti-folder 内联份(closePanel 所在 face)
|
|
253
|
+
|
|
254
|
+
// ── 场景 1(原 bug 直击):副本 A present(open)(floating 语义旧路径)→ 副本 B 必须
|
|
255
|
+
// 看到同一状态;副本 B close 必须生效并发事件(修复前 B 内存表为空 → no-op 永关不掉)。
|
|
256
|
+
modA.present("x:panel", "float");
|
|
257
|
+
assert.equal(modB.presentState("x:panel"), "floating", "副本 B 应读到副本 A 写入的 floating(共享 localStorage)");
|
|
258
|
+
events.length = 0;
|
|
259
|
+
modB.present("x:panel", "close");
|
|
260
|
+
assert.equal(modA.presentState("x:panel"), "closed", "副本 B close 后副本 A 也应读到 closed");
|
|
261
|
+
assert.equal(modB.presentState("x:panel"), "closed", "副本 B 自身状态 closed");
|
|
262
|
+
assert.ok(events.some(([type, key, st]) => type === "change" && key === "x:panel" && st === "closed"), "close 应广播 change(closed)(gate 卸载依据)");
|
|
263
|
+
|
|
264
|
+
// ── 场景 2:open 直达停靠新语义(aiti-float 缺席时不弹自带遮罩的模态浮窗)。
|
|
265
|
+
// 声明 zones + 默认位 → open 落 docked:<default>;用户 pref(非 float)优先于默认。
|
|
266
|
+
modA.declareDockZones("x:folder", ["sidebar-explorer", "right-panel"], "right-panel");
|
|
267
|
+
modA.present("x:folder", "open");
|
|
268
|
+
assert.equal(modA.presentState("x:folder"), "docked:right-panel", "声明过的面板 open 应直达默认停靠位");
|
|
269
|
+
assert.equal(modB.presentState("x:folder"), "docked:right-panel", "副本 B 一致");
|
|
270
|
+
// 用户 pref = sidebar-explorer(跨副本 localStorage 共享,B 写 A 读同键)
|
|
271
|
+
modB.present("x:folder", "dock:sidebar-explorer");
|
|
272
|
+
modA.present("x:folder", "close");
|
|
273
|
+
modA.present("x:folder", "open");
|
|
274
|
+
assert.equal(modA.presentState("x:folder"), "docked:sidebar-explorer", "open 尊重用户 pref 落位");
|
|
275
|
+
// pref = "float" 不认(降级层无浮窗形态)→ 回落默认位
|
|
276
|
+
modA.present("x:folder", "float");
|
|
277
|
+
modA.present("x:folder", "close");
|
|
278
|
+
try { dom.window.localStorage.setItem("pi-web:ext-float:dockpref:v1:x:folder", "float"); } catch { /* ignore */ }
|
|
279
|
+
modA.present("x:folder", "open");
|
|
280
|
+
assert.equal(modA.presentState("x:folder"), "docked:right-panel", "pref=float 在降级层回落默认停靠位");
|
|
281
|
+
|
|
282
|
+
// ── 场景 3:完全未声明 zones 的面板 open → floating 兜底(老语义保留)。
|
|
283
|
+
modA.present("x:legacy", "open");
|
|
284
|
+
assert.equal(modA.presentState("x:legacy"), "floating", "无声明面板 open 兜底 floating");
|
|
285
|
+
assert.equal(modB.presentState("x:legacy"), "floating", "副本 B 一致");
|
|
286
|
+
});
|