@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,783 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* _shared/ext-float-dock-core.ts — 左栏 dock 区块栈的**纯状态层**(零 react import)。
|
|
3
|
+
*
|
|
4
|
+
* 拆分动机(sidebar 统一 dock 方案 §3.8):aiti-float 自身 bundle 不做 react alias
|
|
5
|
+
* (产物零 React 引用),其 DockStack 容器需要折叠/排序的读写与迁移逻辑——这些是
|
|
6
|
+
* 纯 localStorage + window 事件,不含任何 React;React 绑定(useBlockCollapsed /
|
|
7
|
+
* useDockOrder / DockBody)留在 ext-float-dock.ts(各扩展 bundle 内联,react alias
|
|
8
|
+
* → host-shim)。
|
|
9
|
+
*
|
|
10
|
+
* 单一事实源 = localStorage(跨 bundle/跨扩展零共享模块实例也收敛);变更以 window
|
|
11
|
+
* 事件广播(事件驱动零轮询)。订阅方 = aiti-float DockStack 容器 + DockBody 头行。
|
|
12
|
+
*
|
|
13
|
+
* 图标排(v5,方案 docs/pi-web-dock-icon-row-plan.md):位置菜单/移动操作由文字项改
|
|
14
|
+
* 一排无歧义图标(图标数据在 ./dock-icons.ts);本文件的 positionMenuModel/positionMenuItems
|
|
15
|
+
* 产出统一模型,appendDockIconRow 供 DOM 端(D2 aiti-float / D3 降级层)共用渲染。
|
|
16
|
+
*/
|
|
17
|
+
import { dockIconOfZone, createDockIconSvg, type DockIconName } from "./dock-icons.ts";
|
|
18
|
+
|
|
19
|
+
/* ── 左栏区块 zone 泛化(sidebar 统一 dock 方案 §3.8)──
|
|
20
|
+
* 规范 zone 值 = `sidebar:<itemKey>`(每面板一个区块身份,blockKey 即 itemKey——
|
|
21
|
+
* 折叠/排序记忆直接按 itemKey 落 key);旧值 "sidebar-explorer" 永远兼容读
|
|
22
|
+
* (旧 dockpref 持久化 / 在网面板)。DockStack 以 isSidebarDockState 判定成员资格。 */
|
|
23
|
+
export type DockZone = "sidebar-explorer" | "right-panel" | `sidebar:${string}`;
|
|
24
|
+
export type PresentState = "closed" | "floating" | `docked:${string}`;
|
|
25
|
+
|
|
26
|
+
export function sidebarZoneOf(itemKey: string): `sidebar:${string}` {
|
|
27
|
+
return `sidebar:${itemKey}`;
|
|
28
|
+
}
|
|
29
|
+
/** 展示状态是否落在左栏区块(规范 sidebar:* 或旧值 sidebar-explorer)。 */
|
|
30
|
+
export function isSidebarDockState(state: PresentState | string): boolean {
|
|
31
|
+
return state === "docked:sidebar-explorer" || state.startsWith("docked:sidebar:");
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
/* ── 拖拽入位落点解析(aiti-float-dock-drag-drop-unify-plan §3.1)──
|
|
35
|
+
* 落点标记是公共 DOM(谁拥有停泊区谁盖 data-ext-float-dock-zone),而 sidebar 的
|
|
36
|
+
* zone 值是每面板私有的 sidebar:<itemKey>——公共落点只能盖通配值。标记值 = 通配
|
|
37
|
+
* "sidebar",拖拽命中后按拖拽面板自己声明的 zones 解析出真实落位。 */
|
|
38
|
+
export const SIDEBAR_DROP_ZONE = "sidebar";
|
|
39
|
+
|
|
40
|
+
/** 落点标记 zone → 拖拽面板真实落位:marker 在面板声明 zones 里原样返回(现有行为);
|
|
41
|
+
* 通配 "sidebar" → 面板声明的第一个 sidebar:* zone(旧值 sidebar-explorer 一并认);
|
|
42
|
+
* 无可落位返回 null(松手不入位,浮窗回原处)。 */
|
|
43
|
+
export function resolveDropZone(markerZone: string, declaredZones: readonly string[]): DockZone | null {
|
|
44
|
+
if (!markerZone) return null;
|
|
45
|
+
if (declaredZones.includes(markerZone)) return markerZone as DockZone;
|
|
46
|
+
if (markerZone === SIDEBAR_DROP_ZONE) {
|
|
47
|
+
const hit = declaredZones.find((z) => z === "sidebar-explorer" || z.startsWith("sidebar:"));
|
|
48
|
+
return (hit as DockZone | undefined) ?? null;
|
|
49
|
+
}
|
|
50
|
+
return null;
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
/* ── 左栏区块对齐分组(v4 补录设计:dock 区块上对齐 / 下对齐)──
|
|
54
|
+
* 核心区块(项目、定时任务)上对齐——钉在左栏顶部;重要性次级的区块(文件夹、
|
|
55
|
+
* 停靠面板、消息类)下对齐——钉在左栏底部;两组之间留弹性空隙。对齐是区块的
|
|
56
|
+
* 声明属性(props.blocks.align / slot item meta.align),不是用户可切换态(v1)。
|
|
57
|
+
* DockStack 以 splitBlockAlign 分组渲染:组内保持有效序,组界 = 排序硬边界。 */
|
|
58
|
+
export type BlockAlign = "top" | "bottom";
|
|
59
|
+
|
|
60
|
+
/** 按对齐属性分组(保持输入序 = 有效序的组内相对序)。defaultAlign:未声明 align
|
|
61
|
+
* 时的兜底(常驻 blocks 缺省 top;dockable items 在构造期已填默认 bottom)。 */
|
|
62
|
+
export function splitBlockAlign<T extends { align?: BlockAlign }>(entries: T[], defaultAlign: BlockAlign = "top"): { top: T[]; bottom: T[] } {
|
|
63
|
+
const top: T[] = [];
|
|
64
|
+
const bottom: T[] = [];
|
|
65
|
+
for (const e of entries) {
|
|
66
|
+
if ((e.align ?? defaultAlign) === "bottom") bottom.push(e);
|
|
67
|
+
else top.push(e);
|
|
68
|
+
}
|
|
69
|
+
return { top, bottom };
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
/* ── 左栏区块栈:折叠 / 排序 / 旧折叠 key 迁移(sidebar 统一 dock 方案 §3.1/§3.6)── */
|
|
73
|
+
export const SIDEBAR_COLLAPSE_PREFIX = "pi:sidebar-dock:collapsed:";
|
|
74
|
+
export const SIDEBAR_ORDER_KEY = "pi:sidebar-dock:order";
|
|
75
|
+
export const SIDEBAR_COLLAPSE_EVENT = "pi:sidebar-dock:collapsed-changed";
|
|
76
|
+
export const SIDEBAR_ORDER_EVENT = "pi:sidebar-dock:order-changed";
|
|
77
|
+
/** 上下移请求(DockBody ⋮ 菜单发出;DockStack 容器监听——全栈键集只有容器知道)。 */
|
|
78
|
+
export const SIDEBAR_MOVE_EVENT = "pi:sidebar-dock:move";
|
|
79
|
+
/** 拖拽排序落点请求(排序 v2:DockBody 头行 HTML5 DnD 发出;键集裁决同上)。 */
|
|
80
|
+
export const SIDEBAR_DROP_EVENT = "pi:sidebar-dock:drop";
|
|
81
|
+
|
|
82
|
+
export function readBlockCollapsed(blockKey: string): boolean {
|
|
83
|
+
try { return localStorage.getItem(SIDEBAR_COLLAPSE_PREFIX + blockKey) === "1"; } catch { return false; }
|
|
84
|
+
}
|
|
85
|
+
export function writeBlockCollapsed(blockKey: string, collapsed: boolean): void {
|
|
86
|
+
try { localStorage.setItem(SIDEBAR_COLLAPSE_PREFIX + blockKey, collapsed ? "1" : "0"); } catch { /* ignore */ }
|
|
87
|
+
try { window.dispatchEvent(new CustomEvent(SIDEBAR_COLLAPSE_EVENT, { detail: { key: blockKey, collapsed } })); } catch { /* ignore */ }
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
/** 播种默认折叠态(仅当该区块尚无折叠记录时写入;与 seedDockDefault 同模式)。
|
|
91
|
+
* 默认显示的常驻区块(项目/文件夹)据此获得「首次出现即折叠/展开」的规定默认态;
|
|
92
|
+
* 用户手动折叠/展开后(writeBlockCollapsed 已写 key)尊重用户操作,永不覆盖。 */
|
|
93
|
+
export function seedBlockCollapsedDefault(blockKey: string, collapsed: boolean): void {
|
|
94
|
+
try {
|
|
95
|
+
const k = SIDEBAR_COLLAPSE_PREFIX + blockKey;
|
|
96
|
+
if (localStorage.getItem(k) === null) localStorage.setItem(k, collapsed ? "1" : "0");
|
|
97
|
+
} catch { /* ignore */ }
|
|
98
|
+
}
|
|
99
|
+
|
|
100
|
+
export function readDockOrder(): string[] {
|
|
101
|
+
try {
|
|
102
|
+
const raw = JSON.parse(localStorage.getItem(SIDEBAR_ORDER_KEY) ?? "[]");
|
|
103
|
+
return Array.isArray(raw) ? raw.filter((x): x is string => typeof x === "string") : [];
|
|
104
|
+
} catch { return []; }
|
|
105
|
+
}
|
|
106
|
+
export function writeDockOrder(order: string[]): void {
|
|
107
|
+
try { localStorage.setItem(SIDEBAR_ORDER_KEY, JSON.stringify(order)); } catch { /* ignore */ }
|
|
108
|
+
try { window.dispatchEvent(new Event(SIDEBAR_ORDER_EVENT)); } catch { /* ignore */ }
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
/** 有效序:用户改序数组在前(∩ 在场键),其余按 priority 稳定补尾(默认 项目0→任务1→文件2→停靠3+)。 */
|
|
112
|
+
export function effectiveBlockOrder<T extends { key: string; priority?: number }>(entries: T[], order: string[]): T[] {
|
|
113
|
+
const byKey = new Map(entries.map((e) => [e.key, e] as const));
|
|
114
|
+
const head: T[] = [];
|
|
115
|
+
for (const k of order) {
|
|
116
|
+
const e = byKey.get(k);
|
|
117
|
+
if (e) { head.push(e); byKey.delete(k); }
|
|
118
|
+
}
|
|
119
|
+
const rest = [...byKey.values()];
|
|
120
|
+
const withIdx = rest.map((e, i) => ({ e, i }));
|
|
121
|
+
withIdx.sort((a, b) => (a.e.priority ?? 3) - (b.e.priority ?? 3) || a.i - b.i);
|
|
122
|
+
return [...head, ...withIdx.map((x) => x.e)];
|
|
123
|
+
}
|
|
124
|
+
|
|
125
|
+
/** 计算移动后的全栈键序(delta ±1;邻居交换),持久化并广播。 */
|
|
126
|
+
export function moveBlockKey(key: string, delta: number, allKeys: string[]): void {
|
|
127
|
+
const cur = effectiveBlockOrder(allKeys.map((k) => ({ key: k })), readDockOrder()).map((e) => e.key);
|
|
128
|
+
const idx = cur.indexOf(key);
|
|
129
|
+
if (idx < 0) return;
|
|
130
|
+
const to = idx + delta;
|
|
131
|
+
if (to < 0 || to >= cur.length) return;
|
|
132
|
+
const next = [...cur];
|
|
133
|
+
next.splice(idx, 1);
|
|
134
|
+
next.splice(to, 0, key);
|
|
135
|
+
writeDockOrder(next);
|
|
136
|
+
}
|
|
137
|
+
|
|
138
|
+
/** 拖拽排序落位(v2):把 key 移到 target 的前/后(其余键相对序不变),持久化并广播。 */
|
|
139
|
+
export function moveBlockTo(key: string, target: string, allKeys: string[], before: boolean): void {
|
|
140
|
+
if (key === target) return;
|
|
141
|
+
const cur = effectiveBlockOrder(allKeys.map((k) => ({ key: k })), readDockOrder()).map((e) => e.key);
|
|
142
|
+
const from = cur.indexOf(key);
|
|
143
|
+
const to = cur.indexOf(target);
|
|
144
|
+
if (from < 0 || to < 0) return;
|
|
145
|
+
const next = cur.filter((k) => k !== key);
|
|
146
|
+
let idx = next.indexOf(target);
|
|
147
|
+
if (!before) idx += 1;
|
|
148
|
+
next.splice(idx, 0, key);
|
|
149
|
+
writeDockOrder(next);
|
|
150
|
+
}
|
|
151
|
+
|
|
152
|
+
/** 旧折叠 key 一次性迁移(方案 §3.1:四旧 key 读一次迁入 pi:sidebar-dock:collapsed:*;
|
|
153
|
+
* 旧 key 保留不删——回滚旧宿主仍可读;新 key 已存在时不覆盖,模块级 once 守卫)。 */
|
|
154
|
+
let legacyCollapsedMigrated = false;
|
|
155
|
+
export function migrateLegacyCollapseKeys(): void {
|
|
156
|
+
if (legacyCollapsedMigrated || typeof localStorage === "undefined") return;
|
|
157
|
+
legacyCollapsedMigrated = true;
|
|
158
|
+
const legacy: Array<[string, string, (v: string) => boolean]> = [
|
|
159
|
+
// [旧 key, 新 blockKey, 值→折叠语义](sm 项目区写 "1"/"0",宿主区块写 "true"/"false")
|
|
160
|
+
["pi-web:sidebar-projects-collapsed", "projects", (v) => v === "1" || v === "true"],
|
|
161
|
+
["pi-sidebar-tasks-collapsed", "tasks", (v) => v === "true" || v === "1"],
|
|
162
|
+
["pi-web:sidebar-explorer-dock-collapsed", "docks", (v) => v === "true" || v === "1"],
|
|
163
|
+
// 宿主 saveExplorerOpen 存「展开」语义 → 折叠取反
|
|
164
|
+
["pi-web:file-explorer:open", "files", (v) => v === "false" || v === "0"],
|
|
165
|
+
];
|
|
166
|
+
for (const [oldKey, blockKey, parse] of legacy) {
|
|
167
|
+
try {
|
|
168
|
+
const oldVal = localStorage.getItem(oldKey);
|
|
169
|
+
if (oldVal === null) continue;
|
|
170
|
+
if (localStorage.getItem(SIDEBAR_COLLAPSE_PREFIX + blockKey) === null) {
|
|
171
|
+
localStorage.setItem(SIDEBAR_COLLAPSE_PREFIX + blockKey, parse(oldVal) ? "1" : "0");
|
|
172
|
+
}
|
|
173
|
+
} catch { /* ignore */ }
|
|
174
|
+
}
|
|
175
|
+
}
|
|
176
|
+
|
|
177
|
+
/* ── dock 头工具条 store(v3;公开服务 / 本地回落两层承载) ──
|
|
178
|
+
*
|
|
179
|
+
* 机制(方案 docs/pi-web-dock-header-toolbar-plan.md §2.3/§2.7):
|
|
180
|
+
* · 按钮定义(actions)由扩展自己声明(face prop / 服务 register),DockBody 自适应渲染;
|
|
181
|
+
* · 命令实现(commands)与状态(state)由内容组件注册(useDockCommands/useDockHeaderState);
|
|
182
|
+
* · 菜单项(menuItems)由内容注册(head/sep/item,渲染进 ⋮ 菜单,供复杂菜单使用);
|
|
183
|
+
* · 未命中命令 → pending(TTL 10s)+ 展开区块,命令注册时补跑一次。
|
|
184
|
+
*
|
|
185
|
+
* 承载:aiti-float 安装时用本工厂创建宿主级 store(ctx 服务 aiti-float.dock-header +
|
|
186
|
+
* window.__piweFloat.dockHeader core 保留口);服务缺席时 _shared 层回落 lazy 本地单例。
|
|
187
|
+
* 纯逻辑零 react(服务端/测试可直接导入)。
|
|
188
|
+
*/
|
|
189
|
+
|
|
190
|
+
export type DockHeaderVisibility = "always" | "expanded";
|
|
191
|
+
|
|
192
|
+
/** dock 头按钮定义(扩展声明)。badge=角标(变更数等);active=高亮态;done=完成绿态。 */
|
|
193
|
+
export type DockHeaderAction = {
|
|
194
|
+
id: string;
|
|
195
|
+
title: string;
|
|
196
|
+
icon?: unknown;
|
|
197
|
+
badge?: number | string;
|
|
198
|
+
active?: boolean;
|
|
199
|
+
done?: boolean;
|
|
200
|
+
disabled?: boolean;
|
|
201
|
+
/** 缺省 always:收起与展开都显示;"expanded" 仅展开时显示 */
|
|
202
|
+
visibility?: DockHeaderVisibility;
|
|
203
|
+
/** 点击回调;DockBody 会传原始事件(face 可据此取按钮矩形做弹层锚点) */
|
|
204
|
+
onClick: (ev?: unknown) => void;
|
|
205
|
+
};
|
|
206
|
+
|
|
207
|
+
/** 内容上报的状态(纯数据:标量/数组/普通对象——签名比较用 JSON)。 */
|
|
208
|
+
export type DockHeaderState = Record<string, unknown>;
|
|
209
|
+
|
|
210
|
+
/** 命令实现表(id → 函数);payload 可用于传递锚点矩形等参数。 */
|
|
211
|
+
export type DockHeaderCommands = Record<string, ((payload?: unknown) => void) | undefined>;
|
|
212
|
+
|
|
213
|
+
/** ⋮ 菜单附加项(内容注册,渲染在「工具」组之后的扩展分组)。 */
|
|
214
|
+
export type DockMenuItem =
|
|
215
|
+
| { kind: "item"; id?: string; label: string; icon?: unknown; hint?: string; active?: boolean; alwaysRun?: boolean; disabled?: boolean; run: () => void }
|
|
216
|
+
| { kind: "sep"; id?: string }
|
|
217
|
+
| { kind: "head"; label: string; id?: string };
|
|
218
|
+
|
|
219
|
+
export type DockHeaderRegistration = {
|
|
220
|
+
actions?: DockHeaderAction[] | null;
|
|
221
|
+
commands?: DockHeaderCommands | null;
|
|
222
|
+
state?: DockHeaderState | null;
|
|
223
|
+
menuItems?: DockMenuItem[] | null;
|
|
224
|
+
};
|
|
225
|
+
|
|
226
|
+
export type DockHeaderStore = {
|
|
227
|
+
/** 部分字段合并更新(仅更新传入字段);返回反注册(仅清本次提供字段)。 */
|
|
228
|
+
register(key: string, reg: DockHeaderRegistration): () => void;
|
|
229
|
+
/** 有命令→立即执行(payload 透传)返回 true;无→展开区块+pending 返回 false。 */
|
|
230
|
+
request(key: string, id: string, payload?: unknown): boolean;
|
|
231
|
+
actionsOf(key: string): DockHeaderAction[] | null;
|
|
232
|
+
commandsOf(key: string): DockHeaderCommands | null;
|
|
233
|
+
stateOf(key: string): DockHeaderState;
|
|
234
|
+
menuItemsOf(key: string): DockMenuItem[] | null;
|
|
235
|
+
subscribe(key: string, cb: () => void): () => void;
|
|
236
|
+
};
|
|
237
|
+
|
|
238
|
+
/** aiti-float 安装完成事件(install() 末尾广播;服务上线重解析信号)。 */
|
|
239
|
+
export const FLOAT_INSTALLED_EVENT = "piwe-float-installed";
|
|
240
|
+
|
|
241
|
+
/** pending 命令存活时长(命令注册晚于点击的窗口;超时丢弃——避免久后挂载意外执行)。 */
|
|
242
|
+
export const DOCK_HEADER_PENDING_TTL = 10_000;
|
|
243
|
+
|
|
244
|
+
function actionSig(list: DockHeaderAction[] | null): string {
|
|
245
|
+
if (!list) return "";
|
|
246
|
+
return list.map((a) => `${a.id}|${a.title}|${a.badge ?? ""}|${a.active ? 1 : 0}|${a.done ? 1 : 0}|${a.disabled ? 1 : 0}|${a.visibility ?? "always"}`).join("§");
|
|
247
|
+
}
|
|
248
|
+
function menuSig(list: DockMenuItem[] | null): string {
|
|
249
|
+
if (!list) return "";
|
|
250
|
+
return list.map((m) => m.kind === "item"
|
|
251
|
+
? `i:${m.id ?? m.label}:${m.label}:${m.hint ?? ""}:${m.active ? 1 : 0}:${m.alwaysRun ? 1 : 0}:${m.disabled ? 1 : 0}`
|
|
252
|
+
: m.kind === "head" ? `h:${m.label}` : "s").join("§");
|
|
253
|
+
}
|
|
254
|
+
function stateSig(s: DockHeaderState): string {
|
|
255
|
+
try { return JSON.stringify(s); } catch { return `keys:${Object.keys(s).length}`; }
|
|
256
|
+
}
|
|
257
|
+
|
|
258
|
+
type DockHeaderKeyState = {
|
|
259
|
+
actions: DockHeaderAction[] | null;
|
|
260
|
+
commands: DockHeaderCommands | null;
|
|
261
|
+
state: DockHeaderState;
|
|
262
|
+
menuItems: DockMenuItem[] | null;
|
|
263
|
+
pending: { id: string; at: number; payload?: unknown } | null;
|
|
264
|
+
sig: { actions: string; state: string; menu: string };
|
|
265
|
+
};
|
|
266
|
+
|
|
267
|
+
export function createDockHeaderStore(): DockHeaderStore {
|
|
268
|
+
const keys = new Map<string, DockHeaderKeyState>();
|
|
269
|
+
const subs = new Map<string, Set<() => void>>();
|
|
270
|
+
const keyState = (k: string): DockHeaderKeyState => {
|
|
271
|
+
let s = keys.get(k);
|
|
272
|
+
if (!s) {
|
|
273
|
+
s = { actions: null, commands: null, state: {}, menuItems: null, pending: null, sig: { actions: "", state: "{}", menu: "" } };
|
|
274
|
+
keys.set(k, s);
|
|
275
|
+
}
|
|
276
|
+
return s;
|
|
277
|
+
};
|
|
278
|
+
const notify = (k: string): void => {
|
|
279
|
+
const set = subs.get(k);
|
|
280
|
+
if (!set) return;
|
|
281
|
+
for (const cb of [...set]) { try { cb(); } catch { /* ignore */ } }
|
|
282
|
+
};
|
|
283
|
+
/** 命令注册后补跑排队命令(TTL 内、id 命中才执行;执行一次即清)。 */
|
|
284
|
+
const tryConsumePending = (k: string): void => {
|
|
285
|
+
const s = keyState(k);
|
|
286
|
+
const p = s.pending;
|
|
287
|
+
if (!p) return;
|
|
288
|
+
if (Date.now() - p.at > DOCK_HEADER_PENDING_TTL) { s.pending = null; return; }
|
|
289
|
+
const fn = s.commands?.[p.id];
|
|
290
|
+
if (typeof fn !== "function") return;
|
|
291
|
+
s.pending = null;
|
|
292
|
+
try { fn(p.payload); } catch { /* ignore */ }
|
|
293
|
+
};
|
|
294
|
+
return {
|
|
295
|
+
register(key, reg) {
|
|
296
|
+
const s = keyState(key);
|
|
297
|
+
if ("actions" in reg) {
|
|
298
|
+
const next = reg.actions ?? null;
|
|
299
|
+
s.actions = next;
|
|
300
|
+
const sig = actionSig(next);
|
|
301
|
+
if (sig !== s.sig.actions) { s.sig.actions = sig; notify(key); }
|
|
302
|
+
}
|
|
303
|
+
if ("state" in reg) {
|
|
304
|
+
const next = reg.state ?? {};
|
|
305
|
+
s.state = next; // 引用始终更新(闭包读最新值)
|
|
306
|
+
const sig = stateSig(next);
|
|
307
|
+
if (sig !== s.sig.state) { s.sig.state = sig; notify(key); }
|
|
308
|
+
}
|
|
309
|
+
if ("menuItems" in reg) {
|
|
310
|
+
const next = reg.menuItems ?? null;
|
|
311
|
+
s.menuItems = next;
|
|
312
|
+
const sig = menuSig(next);
|
|
313
|
+
if (sig !== s.sig.menu) { s.sig.menu = sig; notify(key); }
|
|
314
|
+
}
|
|
315
|
+
if ("commands" in reg) {
|
|
316
|
+
s.commands = reg.commands ?? null;
|
|
317
|
+
tryConsumePending(key);
|
|
318
|
+
}
|
|
319
|
+
return () => {
|
|
320
|
+
const cur = keys.get(key);
|
|
321
|
+
if (!cur) return;
|
|
322
|
+
if ("actions" in reg && cur.actions === (reg.actions ?? null)) {
|
|
323
|
+
cur.actions = null; cur.sig.actions = ""; notify(key);
|
|
324
|
+
}
|
|
325
|
+
if ("menuItems" in reg && cur.menuItems === (reg.menuItems ?? null)) {
|
|
326
|
+
cur.menuItems = null; cur.sig.menu = ""; notify(key);
|
|
327
|
+
}
|
|
328
|
+
if ("commands" in reg && cur.commands === (reg.commands ?? null)) cur.commands = null;
|
|
329
|
+
if ("state" in reg) { cur.state = {}; cur.sig.state = "{}"; notify(key); }
|
|
330
|
+
};
|
|
331
|
+
},
|
|
332
|
+
request(key, id, payload) {
|
|
333
|
+
const s = keyState(key);
|
|
334
|
+
const fn = s.commands?.[id];
|
|
335
|
+
if (typeof fn === "function") { try { fn(payload); } catch { /* ignore */ } return true; }
|
|
336
|
+
s.pending = { id, at: Date.now(), payload };
|
|
337
|
+
try { writeBlockCollapsed(key, false); } catch { /* ignore */ }
|
|
338
|
+
return false;
|
|
339
|
+
},
|
|
340
|
+
actionsOf(key) { return keys.get(key)?.actions ?? null; },
|
|
341
|
+
commandsOf(key) { return keys.get(key)?.commands ?? null; },
|
|
342
|
+
stateOf(key) { return keys.get(key)?.state ?? {}; },
|
|
343
|
+
menuItemsOf(key) { return keys.get(key)?.menuItems ?? null; },
|
|
344
|
+
subscribe(key, cb) {
|
|
345
|
+
let set = subs.get(key);
|
|
346
|
+
if (!set) { set = new Set(); subs.set(key, set); }
|
|
347
|
+
set.add(cb);
|
|
348
|
+
return () => { const cur = subs.get(key); if (!cur) return; cur.delete(cb); if (cur.size === 0) subs.delete(key); };
|
|
349
|
+
},
|
|
350
|
+
};
|
|
351
|
+
}
|
|
352
|
+
|
|
353
|
+
/** 本地回落单例(aiti-float 服务缺席时 _shared 层使用;模块级 = 同 bundle 共享)。 */
|
|
354
|
+
let localHeaderStore: DockHeaderStore | null = null;
|
|
355
|
+
export function localDockHeaderStore(): DockHeaderStore {
|
|
356
|
+
if (!localHeaderStore) localHeaderStore = createDockHeaderStore();
|
|
357
|
+
return localHeaderStore;
|
|
358
|
+
}
|
|
359
|
+
|
|
360
|
+
|
|
361
|
+
/* ── 展示状态机(present store)——P1-3 自 ext-float-dock.ts 下沉(方案
|
|
362
|
+
* pi-web-eager-ext-split-plan.md §6 P1-3):纯 localStorage + window 事件,零 react。
|
|
363
|
+
* 下沉动机:扩展薄壳(eager 侧)只须 usePresent/openFloat/seedDockDefault 这层小 API,
|
|
364
|
+
* 不该连带 DockBody/头行 UI——薄壳 import ext-float-dock-lite(hooks + 本层 re-export)
|
|
365
|
+
* 即可,重 UI 留在 ext-float-dock.ts 由懒 chunk 携带。aiti-float 本体仍只消费本 core
|
|
366
|
+
* (产物零 React 引用的红线不破)。 ── */
|
|
367
|
+
|
|
368
|
+
const ITEM_KEY_GLOBAL = "__piweFloat";
|
|
369
|
+
export const CHANGE_EVENT = "piwe-float-present-change";
|
|
370
|
+
const DOCKPREF_KEY = (k: string) => `pi-web:ext-float:dockpref:v1:${k}`;
|
|
371
|
+
|
|
372
|
+
type FloatApi = {
|
|
373
|
+
present(k: string, mode: "open" | "float" | `dock:${string}` | "close", opts?: { auto?: boolean }): void;
|
|
374
|
+
presented(k: string): PresentState;
|
|
375
|
+
onPresentChange(cb: (detail: { key: string; state: PresentState }) => void): () => void;
|
|
376
|
+
dockPref(k: string): string | null;
|
|
377
|
+
/** 「新窗口打开」能力注册表(面板声明自己能否开独立窗口;位置菜单据此显隐图标) */
|
|
378
|
+
registerWindowOpener?(k: string, fn: (() => void) | null): void;
|
|
379
|
+
windowOpenerOf?(k: string): (() => void) | null;
|
|
380
|
+
};
|
|
381
|
+
|
|
382
|
+
/** float 服务探测(ext-float-dock.ts 头行 store 也用;内部共享出口)。 */
|
|
383
|
+
export function floatApi(): FloatApi | null {
|
|
384
|
+
const api = (window as any)[ITEM_KEY_GLOBAL] as FloatApi | undefined;
|
|
385
|
+
return api && typeof api.present === "function" ? api : null;
|
|
386
|
+
}
|
|
387
|
+
|
|
388
|
+
/* ── 降级 store(未装 aiti-float):无浮窗形态,open 直达停靠(嵌入可用) ──
|
|
389
|
+
* ⚠ 状态必须落 localStorage(跨 bundle 单一事实源):本模块被各扩展 vite 构建内联,
|
|
390
|
+
* 每个 bundle 各持一份模块实例——内存 Map 会出现「open 走 A 副本(session-manager 内联份)、
|
|
391
|
+
* close 走 B 副本(aiti-folder 内联份)」的分叉:close 在 B 副本里 prev===next 走 no-op 分支
|
|
392
|
+
* 不发事件 → gate 永远 floating → 面板关不掉 + 自带遮罩挡屏(实证:folder 浮窗幽灵态)。
|
|
393
|
+
* 同源同 tab 的 localStorage 全 bundle 共享,本 Map 只是写穿缓存;跨刷新残留无害
|
|
394
|
+
* (closed/docked 残留与重 open 落位一致;floating 仅用户显式选浮窗才产生)。 */
|
|
395
|
+
const LOCAL_STATES_KEY = "pi-web:ext-float:localstates:v1";
|
|
396
|
+
const LOCAL_STATES_REV_KEY = "pi-web:ext-float:localstates-rev:v1";
|
|
397
|
+
function loadLocalStates(): Map<string, PresentState> {
|
|
398
|
+
try {
|
|
399
|
+
const raw = localStorage.getItem(LOCAL_STATES_KEY);
|
|
400
|
+
const obj = raw ? JSON.parse(raw) as Record<string, PresentState> : null;
|
|
401
|
+
return new Map(Object.entries(obj ?? {}));
|
|
402
|
+
} catch { return new Map(); }
|
|
403
|
+
}
|
|
404
|
+
const localStates = loadLocalStates();
|
|
405
|
+
/** 本副本已加载的版本戳:另一副本写入后 rev 变化 → 下次读前重拉(写穿读穿)。 */
|
|
406
|
+
let localStatesRev = "";
|
|
407
|
+
try { localStatesRev = localStorage.getItem(LOCAL_STATES_REV_KEY) ?? ""; } catch { /* ignore */ }
|
|
408
|
+
function syncLocalStates(): void {
|
|
409
|
+
let rev = "";
|
|
410
|
+
try { rev = localStorage.getItem(LOCAL_STATES_REV_KEY) ?? ""; } catch { /* ignore */ }
|
|
411
|
+
if (rev === localStatesRev) return;
|
|
412
|
+
localStatesRev = rev;
|
|
413
|
+
const loaded = loadLocalStates();
|
|
414
|
+
localStates.clear();
|
|
415
|
+
for (const [lk, lv] of loaded) localStates.set(lk, lv);
|
|
416
|
+
}
|
|
417
|
+
function persistLocalStates(): void {
|
|
418
|
+
const rev = String(Date.now()) + "-" + Math.random().toString(36).slice(2, 8);
|
|
419
|
+
try {
|
|
420
|
+
localStorage.setItem(LOCAL_STATES_KEY, JSON.stringify(Object.fromEntries(localStates)));
|
|
421
|
+
localStorage.setItem(LOCAL_STATES_REV_KEY, rev);
|
|
422
|
+
} catch { /* ignore */ }
|
|
423
|
+
localStatesRev = rev;
|
|
424
|
+
}
|
|
425
|
+
const localSubs = new Set<(detail: { key: string; state: PresentState }) => void>();
|
|
426
|
+
/** 降级层 activate 事件(与 aiti-float dock.ts 的 piwe-float-present-activate 同名同语义):
|
|
427
|
+
* 同态 docked 再 open 时宿主右栏据此置前对应 tab——降级模式不缺失「不置前」修复。 */
|
|
428
|
+
const ACTIVATE_EVENT = "piwe-float-present-activate";
|
|
429
|
+
|
|
430
|
+
function localPresent(k: string, mode: "open" | "float" | `dock:${string}` | "close", opts?: { auto?: boolean }) {
|
|
431
|
+
syncLocalStates();
|
|
432
|
+
const prev = localStates.get(k) ?? "closed";
|
|
433
|
+
let next: PresentState = prev;
|
|
434
|
+
if (mode === "open") {
|
|
435
|
+
// open 直达停靠(本层语义原意,aiti-float 缺席时不弹自带遮罩的模态浮窗):
|
|
436
|
+
// 已停靠保持原位(激活由下方 activate 广播兜底);关闭态按
|
|
437
|
+
// 用户 pref(zone;"float" 不认)> 扩展默认位 > 首个声明 zone 落位;
|
|
438
|
+
// 全无声明才 floating 兜底(未接入 dock 声明的老面板)。
|
|
439
|
+
if (prev.startsWith("docked:")) next = prev;
|
|
440
|
+
else {
|
|
441
|
+
const pref = dockPref(k);
|
|
442
|
+
const zones = localZones.get(k) ?? [];
|
|
443
|
+
const zone = pref && pref !== "float" && (zones.includes(pref as DockZone) || isSidebarDockState(`docked:${pref}`))
|
|
444
|
+
? pref
|
|
445
|
+
: (localDefaults.get(k) ?? zones[0]);
|
|
446
|
+
next = (zone ? `docked:${zone}` : "floating") as PresentState;
|
|
447
|
+
}
|
|
448
|
+
} else if (mode === "float") next = "floating";
|
|
449
|
+
else if (mode === "close") next = "closed";
|
|
450
|
+
else if (mode.startsWith("dock:")) {
|
|
451
|
+
const zone = mode.slice(5);
|
|
452
|
+
// 与 float 状态机 dock.ts 同语义:用户显式停靠即记忆偏好(下次 open 回该位)
|
|
453
|
+
try { localStorage.setItem(DOCKPREF_KEY(k), zone); } catch { /* ignore */ }
|
|
454
|
+
next = `docked:${zone}` as PresentState; // 规范态 docked:<zone>(旧实现误存 dock:<zone> → gate 永假,停靠 face 不渲染)
|
|
455
|
+
}
|
|
456
|
+
if (next === prev) {
|
|
457
|
+
// 同态 docked 再打开:与 float 状态机同语义——广播 activate 供宿主置前。
|
|
458
|
+
// auto 透传(与 dock.ts 一致):恢复性入栈的 activate 不得把宿主小屏抽屉拉起。
|
|
459
|
+
if (prev.startsWith("docked:")) {
|
|
460
|
+
try { window.dispatchEvent(new CustomEvent(ACTIVATE_EVENT, { detail: { key: k, state: prev, ...(opts?.auto ? { auto: true } : {}) } })); } catch { /* ignore */ }
|
|
461
|
+
}
|
|
462
|
+
return;
|
|
463
|
+
}
|
|
464
|
+
localStates.set(k, next);
|
|
465
|
+
persistLocalStates();
|
|
466
|
+
const detail = { key: k, state: next, ...(opts?.auto ? { auto: true } : {}) };
|
|
467
|
+
for (const cb of localSubs) { try { cb(detail); } catch { /* ignore */ } }
|
|
468
|
+
try { window.dispatchEvent(new CustomEvent(CHANGE_EVENT, { detail })); } catch { /* ignore */ }
|
|
469
|
+
}
|
|
470
|
+
|
|
471
|
+
/* ── 公共 API ── */
|
|
472
|
+
|
|
473
|
+
export function present(k: string, mode: "open" | "float" | `dock:${string}` | "close", opts?: { auto?: boolean }): void {
|
|
474
|
+
const api = floatApi();
|
|
475
|
+
if (api) { api.present(k, mode, opts); return; }
|
|
476
|
+
localPresent(k, mode, opts);
|
|
477
|
+
}
|
|
478
|
+
|
|
479
|
+
export function presentState(k: string): PresentState {
|
|
480
|
+
const api = floatApi();
|
|
481
|
+
if (api) return api.presented(k) ?? "closed";
|
|
482
|
+
syncLocalStates();
|
|
483
|
+
return localStates.get(k) ?? "closed";
|
|
484
|
+
}
|
|
485
|
+
|
|
486
|
+
export function onPresentChange(cb: (detail: { key: string; state: PresentState }) => void): () => void {
|
|
487
|
+
const api = floatApi();
|
|
488
|
+
if (api) return api.onPresentChange(cb);
|
|
489
|
+
localSubs.add(cb);
|
|
490
|
+
return () => localSubs.delete(cb);
|
|
491
|
+
}
|
|
492
|
+
|
|
493
|
+
export function dockPref(k: string): string | null {
|
|
494
|
+
const api = floatApi();
|
|
495
|
+
if (api) return api.dockPref(k) ?? null;
|
|
496
|
+
try { return localStorage.getItem(DOCKPREF_KEY(k)); } catch { return null; }
|
|
497
|
+
}
|
|
498
|
+
|
|
499
|
+
/* ── 语义糖 ── */
|
|
500
|
+
|
|
501
|
+
/** docked 态重复 open 的容器 flash 提示(方案 §3.2:不开第二个,提示面板在哪)。
|
|
502
|
+
* 定位 DockBody 根上的 data-ext-item 标注(自删 CSS class,零宿主逻辑)。 */
|
|
503
|
+
function flashDockContainer(k: string): void {
|
|
504
|
+
try {
|
|
505
|
+
const el = document.querySelector(`[data-ext-float-dock-body="${k}"]`);
|
|
506
|
+
if (!el) return;
|
|
507
|
+
el.classList.remove("piwe-dock-flash");
|
|
508
|
+
// 触发 reflow 重启动画
|
|
509
|
+
void (el as HTMLElement).offsetWidth;
|
|
510
|
+
el.classList.add("piwe-dock-flash");
|
|
511
|
+
setTimeout(() => el.classList.remove("piwe-dock-flash"), 2000);
|
|
512
|
+
} catch { /* ignore */ }
|
|
513
|
+
}
|
|
514
|
+
|
|
515
|
+
export function openFloat(k: string) {
|
|
516
|
+
// docked 态幂等 open:不开第二个,flash 提示(方案 §3.2);float 状态机内部同样幂等
|
|
517
|
+
const st = presentState(k);
|
|
518
|
+
if (st.startsWith("docked:")) flashDockContainer(k);
|
|
519
|
+
present(k, "open");
|
|
520
|
+
}
|
|
521
|
+
|
|
522
|
+
// 降级命令监听:未装 aiti-float 时由本层响应宿主命令事件(TabBar ✕ 等);
|
|
523
|
+
// float 在场时由 float 的监听处理(本层不重复执行)
|
|
524
|
+
if (typeof window !== "undefined") {
|
|
525
|
+
try {
|
|
526
|
+
window.addEventListener("piwe-float-present-command", ((e: CustomEvent<{ key: string; mode: "open" | "float" | `dock:${string}` | "close" }>) => {
|
|
527
|
+
if (floatApi()) return; // float 在场 → float 的监听已处理
|
|
528
|
+
if (!e.detail || !e.detail.key || !e.detail.mode) return;
|
|
529
|
+
localPresent(e.detail.key, e.detail.mode);
|
|
530
|
+
}) as EventListener);
|
|
531
|
+
} catch { /* ignore */ }
|
|
532
|
+
}
|
|
533
|
+
export function dockTo(k: string, zone: DockZone) { present(k, `dock:${zone}`); }
|
|
534
|
+
/** dock 到左栏区块(zone = sidebar:<itemKey>;sidebar 统一 dock 方案 §3.8)。 */
|
|
535
|
+
export function dockToSidebar(k: string) { present(k, `dock:${sidebarZoneOf(k)}`); }
|
|
536
|
+
/** 拉回浮窗(v3 Q1:同时记住浮窗偏好——下次 open 仍回浮窗;dock.ts present("float") 内已写) */
|
|
537
|
+
export function undockToFloat(k: string) { present(k, "float"); }
|
|
538
|
+
export function closePanel(k: string) { present(k, "close"); }
|
|
539
|
+
/** 直接写用户形态偏好(zone | "float"),不迁移状态——偏好下次 open 生效。 */
|
|
540
|
+
export function setDockPref(k: string, pref: "float" | DockZone) {
|
|
541
|
+
const api = floatApi();
|
|
542
|
+
if (api && typeof (api as any).setPref === "function") { (api as any).setPref(k, pref); return; }
|
|
543
|
+
try { localStorage.setItem(DOCKPREF_KEY(k), pref); } catch { /* ignore */ }
|
|
544
|
+
}
|
|
545
|
+
|
|
546
|
+
/** 清除用户形态偏好(不迁移状态)。用于「关闭即忘」语义的面板(文件夹区块拍板:
|
|
547
|
+
* 任何路径关闭后清偏好,下次 open/刷新自动入栈回落默认位——避免拉成浮窗关掉后
|
|
548
|
+
* 刷新又弹出)。float 状态机 dockprefOf 每次直读 localStorage 无缓存,删 key 即生效
|
|
549
|
+
* (float 在场/降级层同 key,两态通用)。 */
|
|
550
|
+
export function clearDockPref(k: string): void {
|
|
551
|
+
try { localStorage.removeItem(DOCKPREF_KEY(k)); } catch { /* ignore */ }
|
|
552
|
+
}
|
|
553
|
+
|
|
554
|
+
/** 播种扩展声明默认落位(v3 §2-B 实现修正):仅当用户尚无偏好时写 dockPref=zone。
|
|
555
|
+
* 为什么不是只靠面板属性:default 需要在**首次 open 时**生效,而面板 JSX 只在渲染后
|
|
556
|
+
* 存在(open 前状态机拿不到 DOM 属性,鸡生蛋)——故扩展 register 时调本函数预填。
|
|
557
|
+
* 用户 ⇲/选浮窗后偏好被覆盖,本函数永不再次覆盖(尊重用户选择)。
|
|
558
|
+
* createDockFaces 工厂自动调;手写接入在 register() 里显式调一次。 */
|
|
559
|
+
export function seedDockDefault(k: string, zone: DockZone) {
|
|
560
|
+
try { if (!localStorage.getItem(DOCKPREF_KEY(k))) localStorage.setItem(DOCKPREF_KEY(k), zone); } catch { /* ignore */ }
|
|
561
|
+
// 默认位进注册表(TabBar ⇱ 菜单「默认」尾标;v3.1)——与 declareDockZones 互不覆盖:
|
|
562
|
+
// 本函数只补 default,不动 zones 集合
|
|
563
|
+
const api = floatApi() as any;
|
|
564
|
+
if (api && typeof api.registerDefaultZone === "function") { try { api.registerDefaultZone(k, zone); } catch { /* ignore */ } }
|
|
565
|
+
localDefaults.set(k, zone);
|
|
566
|
+
}
|
|
567
|
+
|
|
568
|
+
/* ── 降级 ⇱ 菜单:未装 aiti-float 时宿主 TabBar ⇱ 也得出菜单(float 在场由其监听处理)。
|
|
569
|
+
* 数据源 = 降级注册表;动作 = localPresent(同态激活语义由宿主 activate 监听兜)。 ── */
|
|
570
|
+
let fbMenuKey: string | null = null;
|
|
571
|
+
let fbMenuEl: HTMLElement | null = null;
|
|
572
|
+
let fbDismiss: { key: string; at: number } | null = null;
|
|
573
|
+
|
|
574
|
+
if (typeof window !== "undefined") {
|
|
575
|
+
try {
|
|
576
|
+
window.addEventListener("piwe-float-dock-menu", ((e: CustomEvent<{ key: string; rect?: { left: number; bottom: number } }>) => {
|
|
577
|
+
if (floatApi()) return; // float 在场 → float 的监听已处理
|
|
578
|
+
const k = e.detail?.key;
|
|
579
|
+
if (!k) return;
|
|
580
|
+
// 同 key toggle(含锚按钮 mousedown dismiss 后 click 再触发的场景)
|
|
581
|
+
if (fbMenuKey === k || (fbDismiss && fbDismiss.key === k && Date.now() - fbDismiss.at < 350)) {
|
|
582
|
+
if (fbMenuEl) fbMenuEl.remove();
|
|
583
|
+
fbMenuEl = null; fbMenuKey = null;
|
|
584
|
+
return;
|
|
585
|
+
}
|
|
586
|
+
if (fbMenuEl) fbMenuEl.remove();
|
|
587
|
+
const zones = (localZones.get(k)?.length ? localZones.get(k)! : (presentState(k).startsWith("docked:") ? [presentState(k).slice(7) as DockZone] : []));
|
|
588
|
+
const def = localDefaults.get(k);
|
|
589
|
+
const cur = presentState(k);
|
|
590
|
+
const menu = document.createElement("div");
|
|
591
|
+
menu.setAttribute("data-ext-dock-menu", "1");
|
|
592
|
+
menu.style.cssText = "position:fixed;z-index:2147483600;background:var(--bg-panel,#1a1a1a);border:1px solid var(--border,#444);"
|
|
593
|
+
+ "border-radius:8px;padding:4px;display:flex;flex-direction:column;gap:2px;box-shadow:0 8px 24px rgba(0,0,0,0.4);min-width:190px;";
|
|
594
|
+
const rect = e.detail?.rect;
|
|
595
|
+
menu.style.left = Math.max(8, (rect?.left ?? window.innerWidth / 2 - 70) - 60) + "px";
|
|
596
|
+
menu.style.top = (rect?.bottom ?? 140) + 4 + "px";
|
|
597
|
+
// v5 图标排(方案 §3.4):统一模型(浮窗 + 各停靠位),共享 DOM 行构造
|
|
598
|
+
const items = positionMenuModel(k, zones as DockZone[], def, cur, { onNewWindow: dockWindowOpenerOf(k) });
|
|
599
|
+
appendDockIconRow(menu, items, { label: "停靠方位", onPick: () => { if (fbMenuEl === menu) { fbMenuEl = null; fbMenuKey = null; } } });
|
|
600
|
+
document.body.appendChild(menu);
|
|
601
|
+
fbMenuKey = k;
|
|
602
|
+
fbMenuEl = menu;
|
|
603
|
+
const dismiss = (ev: MouseEvent) => {
|
|
604
|
+
if (menu.contains(ev.target as Node)) return;
|
|
605
|
+
fbDismiss = { key: k, at: Date.now() };
|
|
606
|
+
menu.remove();
|
|
607
|
+
if (fbMenuEl === menu) { fbMenuEl = null; fbMenuKey = null; }
|
|
608
|
+
document.removeEventListener("mousedown", dismiss, true);
|
|
609
|
+
};
|
|
610
|
+
setTimeout(() => document.addEventListener("mousedown", dismiss, true), 0);
|
|
611
|
+
}) as EventListener);
|
|
612
|
+
} catch { /* ignore */
|
|
613
|
+
}
|
|
614
|
+
}
|
|
615
|
+
|
|
616
|
+
/* ── 位置菜单(v3 §2-D:DockBody 头行 📍,停靠态一键换位) ──
|
|
617
|
+
* 数据源 = 调用方传入的 zones/defaultZone(扩展自己知道自己声明了什么;
|
|
618
|
+
* createDockFaces 自动传)。float 状态机不存 DOM 属性,故不经全局查询。 */
|
|
619
|
+
export const DOCK_ZONE_LABELS: Record<string, string> = {
|
|
620
|
+
"sidebar-explorer": "左栏 · 区块",
|
|
621
|
+
"right-panel": "右栏 · 面板",
|
|
622
|
+
};
|
|
623
|
+
|
|
624
|
+
/** ── 图标排模型(v5,方案 docs/pi-web-dock-icon-row-plan.md §3.4)──────────────────
|
|
625
|
+
* D1/D2/D3 位置菜单与 D1 ⋮「移动」行共用同一形状(2026-09-15 用户拍板:移动回归单行图标排,
|
|
626
|
+
* 行首补 move-diagonal-2 行图标——行图标由 React 端 DockMenuRow 承载,不在本模型内)。
|
|
627
|
+
* · active:当前态(高亮 + 锁定,点击不生效)——语义同旧文字菜单 active;
|
|
628
|
+
* · isDefault:扩展声明默认位(右上角圆点角标;tooltip 后缀「(默认)」)。 */
|
|
629
|
+
export interface DockIconRowItem {
|
|
630
|
+
/** 稳定键(位置键 / move-up 等;DOM 端写 data-ext-dock-icon 供 e2e 断言) */
|
|
631
|
+
key: string;
|
|
632
|
+
icon: DockIconName;
|
|
633
|
+
/** tooltip / aria-label 文案 */
|
|
634
|
+
label: string;
|
|
635
|
+
active?: boolean;
|
|
636
|
+
isDefault?: boolean;
|
|
637
|
+
run: () => void;
|
|
638
|
+
}
|
|
639
|
+
|
|
640
|
+
/** 位置菜单项(v5 图标排):`key` = 位置键("float" 或 zone 值;sidebar 族折叠成一项)。 */
|
|
641
|
+
export interface PositionMenuItem extends DockIconRowItem {
|
|
642
|
+
/** 位置键:"float" 或 DockZone(sidebar 族多项折叠为 "sidebar-explorer") */
|
|
643
|
+
key: string;
|
|
644
|
+
/** 兼容字段(旧文字菜单「默认」尾标;图标排用 isDefault 圆点) */
|
|
645
|
+
hint?: string;
|
|
646
|
+
}
|
|
647
|
+
|
|
648
|
+
/** 位置菜单项构建(v4 统一 + v5 图标化):sidebar 族 zone 折叠成单个「左栏 · 区块」条目
|
|
649
|
+
* (栈内各区块行为一致,具体 zone 值无用户语义);active 按状态族判定
|
|
650
|
+
* (兼容旧 docked:sidebar-explorer)。浮窗/各物理位一族一项。 */
|
|
651
|
+
export function positionMenuItems(k: string, zones: DockZone[], defaultZone: DockZone | undefined, cur: PresentState): PositionMenuItem[] {
|
|
652
|
+
const hasSidebar = zones.some((z) => z === "sidebar-explorer" || z.startsWith("sidebar:"));
|
|
653
|
+
const items: PositionMenuItem[] = [];
|
|
654
|
+
if (hasSidebar) {
|
|
655
|
+
const isDef = defaultZone === "sidebar-explorer" || !!defaultZone?.startsWith("sidebar:");
|
|
656
|
+
items.push({
|
|
657
|
+
key: "sidebar-explorer",
|
|
658
|
+
icon: "panel-left",
|
|
659
|
+
label: DOCK_ZONE_LABELS["sidebar-explorer"],
|
|
660
|
+
hint: isDef ? "默认" : undefined,
|
|
661
|
+
isDefault: isDef,
|
|
662
|
+
active: isSidebarDockState(cur),
|
|
663
|
+
run: () => dockToSidebar(k),
|
|
664
|
+
});
|
|
665
|
+
}
|
|
666
|
+
for (const z of zones) {
|
|
667
|
+
if (z === "sidebar-explorer" || z.startsWith("sidebar:")) continue;
|
|
668
|
+
items.push({
|
|
669
|
+
key: z,
|
|
670
|
+
icon: dockIconOfZone(z),
|
|
671
|
+
label: DOCK_ZONE_LABELS[z] ?? z,
|
|
672
|
+
hint: z === defaultZone ? "默认" : undefined,
|
|
673
|
+
isDefault: z === defaultZone,
|
|
674
|
+
active: cur === `docked:${z}`,
|
|
675
|
+
run: () => dockTo(k, z),
|
|
676
|
+
});
|
|
677
|
+
}
|
|
678
|
+
return items;
|
|
679
|
+
}
|
|
680
|
+
|
|
681
|
+
/** 完整位置菜单模型(含浮窗项;序 = 浮窗 → 各停靠位)——D1/D2/D3 三处菜单共用,
|
|
682
|
+
* 消灭三份「浮窗 + zones」手工拼装。run 走本层动作糖(float 在场自动转 api 状态机)。
|
|
683
|
+
* opts.onNewWindow:面板支持「新窗口打开」时传打开函数——该项排最前(序:新窗口 →
|
|
684
|
+
* 浮窗 → 各停靠位);不传/无注册 → 不显示(「有些暂时不支持」由能力注册决定)。 */
|
|
685
|
+
export function positionMenuModel(k: string, zones: DockZone[], defaultZone: DockZone | undefined, cur: PresentState, opts?: { onNewWindow?: (() => void) | null }): PositionMenuItem[] {
|
|
686
|
+
const newWindow = opts?.onNewWindow ?? dockWindowOpenerOf(k);
|
|
687
|
+
return [
|
|
688
|
+
...(newWindow ? [{ key: "new-window", icon: "new-window" as const, label: "新窗口打开", run: newWindow }] : []),
|
|
689
|
+
{ key: "float", icon: "float", label: "浮窗", active: cur === "floating", run: () => undockToFloat(k) },
|
|
690
|
+
...positionMenuItems(k, zones, defaultZone, cur),
|
|
691
|
+
];
|
|
692
|
+
}
|
|
693
|
+
|
|
694
|
+
/* ── 「新窗口打开」能力注册表(跨 bundle 收敛)──
|
|
695
|
+
* 面板挂载/实例创建时调 declareDockWindowOpener(k, fn) 声明支持;位置菜单模型
|
|
696
|
+
* 据此显隐 B 图标(aiti-folder 文件夹面支持;文件走工具条入口)。
|
|
697
|
+
* float 在场 → 存 float 单例注册表(D2 TabBar ⇱ 菜单跨 bundle 可读);
|
|
698
|
+
* 缺席 → 本 bundle local map 兑底(D1 内联菜单同 bundle 可读;D3 降级菜单读不到
|
|
699
|
+
* 其他 bundle 的注册,故降级模式不显示该项——接受)。 */
|
|
700
|
+
const localWindowOpeners = new Map<string, () => void>();
|
|
701
|
+
export function declareDockWindowOpener(k: string, fn: (() => void) | null): void {
|
|
702
|
+
const api = floatApi() as (FloatApi & { registerWindowOpener?: (k2: string, f: (() => void) | null) => void }) | null;
|
|
703
|
+
if (api && typeof api.registerWindowOpener === "function") { try { api.registerWindowOpener(k, fn); } catch { /* ignore */ } }
|
|
704
|
+
if (typeof fn === "function") localWindowOpeners.set(k, fn);
|
|
705
|
+
else localWindowOpeners.delete(k);
|
|
706
|
+
}
|
|
707
|
+
/** 查面板「新窗口打开」能力(无注册返回 null)。 */
|
|
708
|
+
export function dockWindowOpenerOf(k: string): (() => void) | null {
|
|
709
|
+
const api = floatApi() as (FloatApi & { windowOpenerOf?: (k2: string) => (() => void) | null }) | null;
|
|
710
|
+
if (api && typeof api.windowOpenerOf === "function") {
|
|
711
|
+
try { const fn = api.windowOpenerOf(k); if (typeof fn === "function") return fn; } catch { /* ignore */ }
|
|
712
|
+
}
|
|
713
|
+
return localWindowOpeners.get(k) ?? null;
|
|
714
|
+
}
|
|
715
|
+
|
|
716
|
+
/** 图标排 DOM 渲染(D2 aiti-float / D3 降级层共用):一行「名称 + 右对齐图标组」
|
|
717
|
+
* (名称 12px 灰字居左;图标 28×28、gap 6、右对齐;当前态高亮锁定、默认位圆点、hover tooltip)。
|
|
718
|
+
* label 缺省时仅渲染图标组(兼容纯图标行)。onPick 在「可点项」点击时先于 run 调用
|
|
719
|
+
* (消费方用于关菜单)。返回行元素。 */
|
|
720
|
+
export function appendDockIconRow(parent: HTMLElement, items: DockIconRowItem[], opts?: { label?: string; onPick?: (it: DockIconRowItem) => void }): HTMLElement {
|
|
721
|
+
const row = document.createElement("div");
|
|
722
|
+
row.setAttribute("data-ext-dock-icon-row", "1");
|
|
723
|
+
row.style.cssText = "display:flex;align-items:center;justify-content:space-between;gap:16px;padding:5px 10px;";
|
|
724
|
+
if (opts?.label) {
|
|
725
|
+
const lab = document.createElement("span");
|
|
726
|
+
lab.setAttribute("data-ext-dock-icon-row-label", "1");
|
|
727
|
+
lab.textContent = opts.label;
|
|
728
|
+
lab.style.cssText = "font-size:12px;color:var(--text-dim,#888);flex-shrink:0;user-select:none;white-space:nowrap;";
|
|
729
|
+
row.appendChild(lab);
|
|
730
|
+
}
|
|
731
|
+
const group = document.createElement("div");
|
|
732
|
+
group.setAttribute("data-ext-dock-icon-group", "1");
|
|
733
|
+
group.style.cssText = "display:flex;gap:6px;margin-left:auto;flex-shrink:0;";
|
|
734
|
+
for (const it of items) {
|
|
735
|
+
const btn = document.createElement("button");
|
|
736
|
+
btn.type = "button";
|
|
737
|
+
const tip = it.isDefault ? `${it.label}(默认)` : it.label;
|
|
738
|
+
btn.title = tip;
|
|
739
|
+
btn.setAttribute("aria-label", tip);
|
|
740
|
+
if (it.active === true || it.active === false) {
|
|
741
|
+
btn.setAttribute("role", "menuitemradio");
|
|
742
|
+
btn.setAttribute("aria-checked", it.active ? "true" : "false");
|
|
743
|
+
} else {
|
|
744
|
+
btn.setAttribute("role", "menuitem");
|
|
745
|
+
}
|
|
746
|
+
btn.setAttribute("data-ext-dock-icon", it.key);
|
|
747
|
+
btn.style.cssText = "position:relative;width:28px;height:28px;display:inline-flex;align-items:center;justify-content:center;"
|
|
748
|
+
+ "border:none;background:none;border-radius:6px;padding:0;font-family:inherit;cursor:pointer;color:var(--text-muted,#888);"
|
|
749
|
+
+ (it.active ? "cursor:default;background:var(--bg-selected,#2a2a2a);color:var(--accent,#2563eb);" : "");
|
|
750
|
+
btn.appendChild(createDockIconSvg(it.icon, 16));
|
|
751
|
+
if (!it.active) {
|
|
752
|
+
btn.addEventListener("mouseenter", () => { btn.style.background = "var(--bg-hover,#262626)"; btn.style.color = "var(--text,#ddd)"; });
|
|
753
|
+
btn.addEventListener("mouseleave", () => { btn.style.background = "none"; btn.style.color = "var(--text-muted,#888)"; });
|
|
754
|
+
btn.addEventListener("click", () => { opts?.onPick?.(it); it.run(); });
|
|
755
|
+
}
|
|
756
|
+
if (it.isDefault) {
|
|
757
|
+
const dot = document.createElement("span");
|
|
758
|
+
dot.setAttribute("data-ext-dock-icon-default", "1");
|
|
759
|
+
dot.style.cssText = "position:absolute;top:3px;right:3px;width:4px;height:4px;border-radius:50%;background:var(--accent,#2563eb);pointer-events:none;";
|
|
760
|
+
btn.appendChild(dot);
|
|
761
|
+
}
|
|
762
|
+
group.appendChild(btn);
|
|
763
|
+
}
|
|
764
|
+
row.appendChild(group);
|
|
765
|
+
parent.appendChild(row);
|
|
766
|
+
return row;
|
|
767
|
+
}
|
|
768
|
+
/* ── zones/default 集中注册(v3.1):TabBar dock tab ⇱ 菜单的数据源。面板停靠 face
|
|
769
|
+
* 未挂载(后台 tab)时菜单只能靠这里;DOM 属性是兜底(DockBody 根上也有同名属性)。 */
|
|
770
|
+
const localZones = new Map<string, DockZone[]>();
|
|
771
|
+
const localDefaults = new Map<string, DockZone>();
|
|
772
|
+
|
|
773
|
+
/** 声明面板可停靠位 + 默认位(register 时调一次;createDockFaces 自动调)。
|
|
774
|
+
* float 在场 → 进状态机注册表;缺席 → 本层降级表(降级 ⇱ 菜单同源)。 */
|
|
775
|
+
export function declareDockZones(k: string, zones: DockZone[], defaultZone?: DockZone) {
|
|
776
|
+
const api = floatApi() as any;
|
|
777
|
+
if (api && typeof api.registerZones === "function") {
|
|
778
|
+
try { api.registerZones(k, zones); } catch { /* ignore */ }
|
|
779
|
+
if (defaultZone && typeof api.registerDefaultZone === "function") { try { api.registerDefaultZone(k, defaultZone); } catch { /* ignore */ } }
|
|
780
|
+
}
|
|
781
|
+
localZones.set(k, zones.filter(Boolean));
|
|
782
|
+
if (defaultZone) localDefaults.set(k, defaultZone);
|
|
783
|
+
}
|