@linkdesk/plugin-sdk 0.1.3 → 0.1.6

package/dev-host/linkdesk-mock.generated.ts

@@ -0,0 +1,363 @@
+/**
+ * 🔥 linkdesk-mock.generated.ts——dev 宿主 window.linkdesk mock 树（自动生成，勿手改）
+ *
+ * 生成源：src/core/api/linkdesk-api.ts + linkdesk-api/（LinkDeskAPI 交集——与 linkdesk.d.ts 同一标注源）
+ * 生成器：scripts/generate-contract.mjs（E6#27 第三产物，杜绝 mock/preload 双份漂移）
+ * 改契约源 → 跑 `node scripts/generate-contract.mjs`（npm run check 里 contracts:check 三产物逐字节强制）
+ *
+ * 消费方：packages/plugin-sdk/dev-host/mock.ts——injectDevMockApi() 用 Proxy 包本树：
+ *   树内方法 = 类型驱动中性默认 + 调用即打 [linkdesk-mock] 日志（mock vs 真 IPC 可感知）；
+ *   树外路径（契约里不存在的方法名） = Proxy 抛「不在 linkdesk API 契约」。
+ * 默认值策略（"不崩 + 可感知"，详见 02-本地预览环境.md §10.2）：
+ *   Promise<void/…数据对象> → async 返 undefined；Promise<数组> → []；Promise<string/boolean> → ""/false；
+ *   void → noop（registerCommand 等每插件必调，绝不抛）；返回退订句柄（onChange 等）→ noop 函数；
+ *   其余同步 → ""/undefined。真数据/真行为走真实 IPC / linkdesk-plugin-sdk dev --real（E6#28.5）。
+ */
+export const linkdeskMock: Record<string, unknown> = {
+  commands: {
+    execute: async (..._args: unknown[]) => { console.info("[linkdesk-mock] commands.execute", ..._args); },
+    executeCommand: async (..._args: unknown[]) => { console.info("[linkdesk-mock] commands.executeCommand", ..._args); },
+    registerCommand: (..._args: unknown[]) => { console.info("[linkdesk-mock] commands.registerCommand", ..._args); },
+    unregisterCommands: (..._args: unknown[]) => { console.info("[linkdesk-mock] commands.unregisterCommands", ..._args); },
+    getCommands: async (..._args: unknown[]) => { console.info("[linkdesk-mock] commands.getCommands", ..._args); return []; },
+    _executeShellLocal: async (..._args: unknown[]) => { console.info("[linkdesk-mock] commands._executeShellLocal", ..._args); },
+  },
+  configuration: {
+    get: async (..._args: unknown[]) => { console.info("[linkdesk-mock] configuration.get", ..._args); },
+    set: async (..._args: unknown[]) => { console.info("[linkdesk-mock] configuration.set", ..._args); },
+    getSchema: async (..._args: unknown[]) => { console.info("[linkdesk-mock] configuration.getSchema", ..._args); },
+    onChange: (..._args: unknown[]) => { console.info("[linkdesk-mock] configuration.onChange", ..._args); return () => {}; },
+    getConfigurationContributions: async (..._args: unknown[]) => { console.info("[linkdesk-mock] configuration.getConfigurationContributions", ..._args); return []; },
+    inspectConfiguration: async (..._args: unknown[]) => { console.info("[linkdesk-mock] configuration.inspectConfiguration", ..._args); },
+    getUserSettings: async (..._args: unknown[]) => { console.info("[linkdesk-mock] configuration.getUserSettings", ..._args); },
+    onDidChangeConfiguration: (..._args: unknown[]) => { console.info("[linkdesk-mock] configuration.onDidChangeConfiguration", ..._args); return () => {}; },
+    onPluginLifecycleChange: (..._args: unknown[]) => { console.info("[linkdesk-mock] configuration.onPluginLifecycleChange", ..._args); return () => {}; },
+    consumeSettingsGroup: async (..._args: unknown[]) => { console.info("[linkdesk-mock] configuration.consumeSettingsGroup", ..._args); },
+    onRequestSettingsGroup: (..._args: unknown[]) => { console.info("[linkdesk-mock] configuration.onRequestSettingsGroup", ..._args); return () => {}; },
+    consumeScrollToSetting: async (..._args: unknown[]) => { console.info("[linkdesk-mock] configuration.consumeScrollToSetting", ..._args); },
+    onRequestScrollToSetting: (..._args: unknown[]) => { console.info("[linkdesk-mock] configuration.onRequestScrollToSetting", ..._args); return () => {}; },
+    consumeOpenKeybindings: async (..._args: unknown[]) => { console.info("[linkdesk-mock] configuration.consumeOpenKeybindings", ..._args); },
+    onRequestOpenKeybindings: (..._args: unknown[]) => { console.info("[linkdesk-mock] configuration.onRequestOpenKeybindings", ..._args); return () => {}; },
+  },
+  config: {
+    get: async (..._args: unknown[]) => { console.info("[linkdesk-mock] config.get", ..._args); },
+    set: async (..._args: unknown[]) => { console.info("[linkdesk-mock] config.set", ..._args); },
+    getSchema: async (..._args: unknown[]) => { console.info("[linkdesk-mock] config.getSchema", ..._args); },
+    onChange: (..._args: unknown[]) => { console.info("[linkdesk-mock] config.onChange", ..._args); return () => {}; },
+    getConfigurationContributions: async (..._args: unknown[]) => { console.info("[linkdesk-mock] config.getConfigurationContributions", ..._args); return []; },
+    inspectConfiguration: async (..._args: unknown[]) => { console.info("[linkdesk-mock] config.inspectConfiguration", ..._args); },
+    getUserSettings: async (..._args: unknown[]) => { console.info("[linkdesk-mock] config.getUserSettings", ..._args); },
+    onDidChangeConfiguration: (..._args: unknown[]) => { console.info("[linkdesk-mock] config.onDidChangeConfiguration", ..._args); return () => {}; },
+    onPluginLifecycleChange: (..._args: unknown[]) => { console.info("[linkdesk-mock] config.onPluginLifecycleChange", ..._args); return () => {}; },
+    consumeSettingsGroup: async (..._args: unknown[]) => { console.info("[linkdesk-mock] config.consumeSettingsGroup", ..._args); },
+    onRequestSettingsGroup: (..._args: unknown[]) => { console.info("[linkdesk-mock] config.onRequestSettingsGroup", ..._args); return () => {}; },
+    consumeScrollToSetting: async (..._args: unknown[]) => { console.info("[linkdesk-mock] config.consumeScrollToSetting", ..._args); },
+    onRequestScrollToSetting: (..._args: unknown[]) => { console.info("[linkdesk-mock] config.onRequestScrollToSetting", ..._args); return () => {}; },
+    consumeOpenKeybindings: async (..._args: unknown[]) => { console.info("[linkdesk-mock] config.consumeOpenKeybindings", ..._args); },
+    onRequestOpenKeybindings: (..._args: unknown[]) => { console.info("[linkdesk-mock] config.onRequestOpenKeybindings", ..._args); return () => {}; },
+  },
+  theme: {
+    getCurrent: async (..._args: unknown[]) => { console.info("[linkdesk-mock] theme.getCurrent", ..._args); return ""; },
+    getAvailable: async (..._args: unknown[]) => { console.info("[linkdesk-mock] theme.getAvailable", ..._args); return []; },
+    apply: async (..._args: unknown[]) => { console.info("[linkdesk-mock] theme.apply", ..._args); },
+    listRecipes: async (..._args: unknown[]) => { console.info("[linkdesk-mock] theme.listRecipes", ..._args); return []; },
+    getActive: async (..._args: unknown[]) => { console.info("[linkdesk-mock] theme.getActive", ..._args); },
+    getEffectiveTokens: async (..._args: unknown[]) => { console.info("[linkdesk-mock] theme.getEffectiveTokens", ..._args); },
+    setRecipe: async (..._args: unknown[]) => { console.info("[linkdesk-mock] theme.setRecipe", ..._args); },
+    setColorway: async (..._args: unknown[]) => { console.info("[linkdesk-mock] theme.setColorway", ..._args); },
+    resetAppearance: async (..._args: unknown[]) => { console.info("[linkdesk-mock] theme.resetAppearance", ..._args); },
+    resetMix: async (..._args: unknown[]) => { console.info("[linkdesk-mock] theme.resetMix", ..._args); },
+    getBaselineSeeds: async (..._args: unknown[]) => { console.info("[linkdesk-mock] theme.getBaselineSeeds", ..._args); },
+  },
+  language: {
+    getCurrent: async (..._args: unknown[]) => { console.info("[linkdesk-mock] language.getCurrent", ..._args); return ""; },
+    getAvailable: async (..._args: unknown[]) => { console.info("[linkdesk-mock] language.getAvailable", ..._args); return []; },
+    set: async (..._args: unknown[]) => { console.info("[linkdesk-mock] language.set", ..._args); },
+    getInitial: (..._args: unknown[]) => { console.info("[linkdesk-mock] language.getInitial", ..._args); },
+    onChange: (..._args: unknown[]) => { console.info("[linkdesk-mock] language.onChange", ..._args); return () => {}; },
+  },
+  appearance: {
+    importImage: async (..._args: unknown[]) => { console.info("[linkdesk-mock] appearance.importImage", ..._args); return ""; },
+    revealStorage: async (..._args: unknown[]) => { console.info("[linkdesk-mock] appearance.revealStorage", ..._args); },
+  },
+  tabs: {
+    create: async (..._args: unknown[]) => { console.info("[linkdesk-mock] tabs.create", ..._args); },
+    openOrFocus: async (..._args: unknown[]) => { console.info("[linkdesk-mock] tabs.openOrFocus", ..._args); },
+    focus: async (..._args: unknown[]) => { console.info("[linkdesk-mock] tabs.focus", ..._args); },
+    close: async (..._args: unknown[]) => { console.info("[linkdesk-mock] tabs.close", ..._args); },
+    focusBySourceId: async (..._args: unknown[]) => { console.info("[linkdesk-mock] tabs.focusBySourceId", ..._args); },
+    updateLabelBySourceId: async (..._args: unknown[]) => { console.info("[linkdesk-mock] tabs.updateLabelBySourceId", ..._args); },
+    closeBySourceId: async (..._args: unknown[]) => { console.info("[linkdesk-mock] tabs.closeBySourceId", ..._args); },
+    onDidChangeActiveTab: (..._args: unknown[]) => { console.info("[linkdesk-mock] tabs.onDidChangeActiveTab", ..._args); return () => {}; },
+  },
+  keybindings: {
+    getKeybindings: async (..._args: unknown[]) => { console.info("[linkdesk-mock] keybindings.getKeybindings", ..._args); return []; },
+    getConflicts: async (..._args: unknown[]) => { console.info("[linkdesk-mock] keybindings.getConflicts", ..._args); },
+    registerKeybinding: async (..._args: unknown[]) => { console.info("[linkdesk-mock] keybindings.registerKeybinding", ..._args); },
+    saveUserKeybindings: async (..._args: unknown[]) => { console.info("[linkdesk-mock] keybindings.saveUserKeybindings", ..._args); },
+    removeKeybindingForCommand: async (..._args: unknown[]) => { console.info("[linkdesk-mock] keybindings.removeKeybindingForCommand", ..._args); },
+    resetKeybindingToDefault: async (..._args: unknown[]) => { console.info("[linkdesk-mock] keybindings.resetKeybindingToDefault", ..._args); },
+    findKeybindingForCommand: async (..._args: unknown[]) => { console.info("[linkdesk-mock] keybindings.findKeybindingForCommand", ..._args); },
+    setKeybindingCaptureActive: async (..._args: unknown[]) => { console.info("[linkdesk-mock] keybindings.setKeybindingCaptureActive", ..._args); },
+    keyboardEventToKeyString: (..._args: unknown[]) => { console.info("[linkdesk-mock] keybindings.keyboardEventToKeyString", ..._args); return ""; },
+    onChange: (..._args: unknown[]) => { console.info("[linkdesk-mock] keybindings.onChange", ..._args); return () => {}; },
+    syncToMainProcess: async (..._args: unknown[]) => { console.info("[linkdesk-mock] keybindings.syncToMainProcess", ..._args); },
+    onForwardedEvent: (..._args: unknown[]) => { console.info("[linkdesk-mock] keybindings.onForwardedEvent", ..._args); return () => {}; },
+  },
+  notifications: {
+    show: async (..._args: unknown[]) => { console.info("[linkdesk-mock] notifications.show", ..._args); },
+  },
+  menu: {
+    registerItems: async (..._args: unknown[]) => { console.info("[linkdesk-mock] menu.registerItems", ..._args); },
+    getItems: async (..._args: unknown[]) => { console.info("[linkdesk-mock] menu.getItems", ..._args); return []; },
+  },
+  contextKey: {
+    set: async (..._args: unknown[]) => { console.info("[linkdesk-mock] contextKey.set", ..._args); },
+    _getValue: (..._args: unknown[]) => { console.info("[linkdesk-mock] contextKey._getValue", ..._args); },
+  },
+  dialog: {
+    confirm: async (..._args: unknown[]) => { console.info("[linkdesk-mock] dialog.confirm", ..._args); return false; },
+    alert: async (..._args: unknown[]) => { console.info("[linkdesk-mock] dialog.alert", ..._args); },
+    open: async (..._args: unknown[]) => { console.info("[linkdesk-mock] dialog.open", ..._args); },
+    openFile: async (..._args: unknown[]) => { console.info("[linkdesk-mock] dialog.openFile", ..._args); },
+  },
+  quickPick: {
+    show: async (..._args: unknown[]) => { console.info("[linkdesk-mock] quickPick.show", ..._args); },
+  },
+  quickPickHost: {
+    registerHost: (..._args: unknown[]) => { console.info("[linkdesk-mock] quickPickHost.registerHost", ..._args); return () => {}; },
+    onShow: (..._args: unknown[]) => { console.info("[linkdesk-mock] quickPickHost.onShow", ..._args); return () => {}; },
+    select: (..._args: unknown[]) => { console.info("[linkdesk-mock] quickPickHost.select", ..._args); },
+    highlight: (..._args: unknown[]) => { console.info("[linkdesk-mock] quickPickHost.highlight", ..._args); },
+    close: (..._args: unknown[]) => { console.info("[linkdesk-mock] quickPickHost.close", ..._args); },
+    itemAction: (..._args: unknown[]) => { console.info("[linkdesk-mock] quickPickHost.itemAction", ..._args); },
+  },
+  toast: {
+    onShow: (..._args: unknown[]) => { console.info("[linkdesk-mock] toast.onShow", ..._args); return () => {}; },
+    dismiss: (..._args: unknown[]) => { console.info("[linkdesk-mock] toast.dismiss", ..._args); },
+    action: (..._args: unknown[]) => { console.info("[linkdesk-mock] toast.action", ..._args); },
+  },
+  dialogHost: {
+    onShow: (..._args: unknown[]) => { console.info("[linkdesk-mock] dialogHost.onShow", ..._args); return () => {}; },
+    confirm: (..._args: unknown[]) => { console.info("[linkdesk-mock] dialogHost.confirm", ..._args); },
+    cancel: (..._args: unknown[]) => { console.info("[linkdesk-mock] dialogHost.cancel", ..._args); },
+  },
+  floatingPanelHost: {
+    onShow: (..._args: unknown[]) => { console.info("[linkdesk-mock] floatingPanelHost.onShow", ..._args); return () => {}; },
+    action: (..._args: unknown[]) => { console.info("[linkdesk-mock] floatingPanelHost.action", ..._args); },
+  },
+  serial: {
+    listPorts: async (..._args: unknown[]) => { console.info("[linkdesk-mock] serial.listPorts", ..._args); return []; },
+    getStatus: async (..._args: unknown[]) => { console.info("[linkdesk-mock] serial.getStatus", ..._args); return []; },
+    openPort: async (..._args: unknown[]) => { console.info("[linkdesk-mock] serial.openPort", ..._args); },
+    closePort: async (..._args: unknown[]) => { console.info("[linkdesk-mock] serial.closePort", ..._args); },
+    sendData: async (..._args: unknown[]) => { console.info("[linkdesk-mock] serial.sendData", ..._args); },
+    sendText: async (..._args: unknown[]) => { console.info("[linkdesk-mock] serial.sendText", ..._args); },
+    setDtr: async (..._args: unknown[]) => { console.info("[linkdesk-mock] serial.setDtr", ..._args); },
+    setRts: async (..._args: unknown[]) => { console.info("[linkdesk-mock] serial.setRts", ..._args); },
+    onData: (..._args: unknown[]) => { console.info("[linkdesk-mock] serial.onData", ..._args); return () => {}; },
+    onStats: (..._args: unknown[]) => { console.info("[linkdesk-mock] serial.onStats", ..._args); return () => {}; },
+    onSystem: (..._args: unknown[]) => { console.info("[linkdesk-mock] serial.onSystem", ..._args); return () => {}; },
+  },
+  clipboard: {
+    readText: async (..._args: unknown[]) => { console.info("[linkdesk-mock] clipboard.readText", ..._args); return ""; },
+    writeText: async (..._args: unknown[]) => { console.info("[linkdesk-mock] clipboard.writeText", ..._args); },
+    writeFileList: async (..._args: unknown[]) => { console.info("[linkdesk-mock] clipboard.writeFileList", ..._args); },
+  },
+  p2p: {
+    send: (..._args: unknown[]) => { console.info("[linkdesk-mock] p2p.send", ..._args); },
+    on: (..._args: unknown[]) => { console.info("[linkdesk-mock] p2p.on", ..._args); return () => {}; },
+  },
+  events: {
+    on: (..._args: unknown[]) => { console.info("[linkdesk-mock] events.on", ..._args); return () => {}; },
+    emit: (..._args: unknown[]) => { console.info("[linkdesk-mock] events.emit", ..._args); },
+    heartbeat: (..._args: unknown[]) => { console.info("[linkdesk-mock] events.heartbeat", ..._args); },
+    notifyTheme: (..._args: unknown[]) => { console.info("[linkdesk-mock] events.notifyTheme", ..._args); },
+  },
+  pluginState: {
+    get: async (..._args: unknown[]) => { console.info("[linkdesk-mock] pluginState.get", ..._args); },
+    set: async (..._args: unknown[]) => { console.info("[linkdesk-mock] pluginState.set", ..._args); },
+    onChange: (..._args: unknown[]) => { console.info("[linkdesk-mock] pluginState.onChange", ..._args); return () => {}; },
+  },
+  workspace: {
+    getFolders: async (..._args: unknown[]) => { console.info("[linkdesk-mock] workspace.getFolders", ..._args); return []; },
+    getActive: async (..._args: unknown[]) => { console.info("[linkdesk-mock] workspace.getActive", ..._args); },
+    setActive: async (..._args: unknown[]) => { console.info("[linkdesk-mock] workspace.setActive", ..._args); },
+    openFolder: async (..._args: unknown[]) => { console.info("[linkdesk-mock] workspace.openFolder", ..._args); },
+    addFolder: async (..._args: unknown[]) => { console.info("[linkdesk-mock] workspace.addFolder", ..._args); },
+    removeFolder: async (..._args: unknown[]) => { console.info("[linkdesk-mock] workspace.removeFolder", ..._args); },
+    onDidChangeFolders: (..._args: unknown[]) => { console.info("[linkdesk-mock] workspace.onDidChangeFolders", ..._args); return () => {}; },
+    onDidChangeActiveWorkspace: (..._args: unknown[]) => { console.info("[linkdesk-mock] workspace.onDidChangeActiveWorkspace", ..._args); return () => {}; },
+  },
+  filesystem: {
+    readTextFile: async (..._args: unknown[]) => { console.info("[linkdesk-mock] filesystem.readTextFile", ..._args); return ""; },
+    writeTextFile: async (..._args: unknown[]) => { console.info("[linkdesk-mock] filesystem.writeTextFile", ..._args); },
+    exists: async (..._args: unknown[]) => { console.info("[linkdesk-mock] filesystem.exists", ..._args); return false; },
+    createDir: async (..._args: unknown[]) => { console.info("[linkdesk-mock] filesystem.createDir", ..._args); },
+    copy: async (..._args: unknown[]) => { console.info("[linkdesk-mock] filesystem.copy", ..._args); },
+    rename: async (..._args: unknown[]) => { console.info("[linkdesk-mock] filesystem.rename", ..._args); },
+    remove: async (..._args: unknown[]) => { console.info("[linkdesk-mock] filesystem.remove", ..._args); },
+    listDir: async (..._args: unknown[]) => { console.info("[linkdesk-mock] filesystem.listDir", ..._args); return []; },
+    readBinaryFile: async (..._args: unknown[]) => { console.info("[linkdesk-mock] filesystem.readBinaryFile", ..._args); },
+    writeBinaryFile: async (..._args: unknown[]) => { console.info("[linkdesk-mock] filesystem.writeBinaryFile", ..._args); },
+    watch: async (..._args: unknown[]) => { console.info("[linkdesk-mock] filesystem.watch", ..._args); },
+    readdir: async (..._args: unknown[]) => { console.info("[linkdesk-mock] filesystem.readdir", ..._args); return []; },
+  },
+  path: {
+    appDataDir: async (..._args: unknown[]) => { console.info("[linkdesk-mock] path.appDataDir", ..._args); return ""; },
+    normalize: (..._args: unknown[]) => { console.info("[linkdesk-mock] path.normalize", ..._args); return ""; },
+    join: (..._args: unknown[]) => { console.info("[linkdesk-mock] path.join", ..._args); return ""; },
+    basename: (..._args: unknown[]) => { console.info("[linkdesk-mock] path.basename", ..._args); return ""; },
+    dirname: (..._args: unknown[]) => { console.info("[linkdesk-mock] path.dirname", ..._args); return ""; },
+    extname: (..._args: unknown[]) => { console.info("[linkdesk-mock] path.extname", ..._args); return ""; },
+  },
+  env: {
+    get: async (..._args: unknown[]) => { console.info("[linkdesk-mock] env.get", ..._args); },
+  },
+  search: {
+    searchFiles: async (..._args: unknown[]) => { console.info("[linkdesk-mock] search.searchFiles", ..._args); return []; },
+  },
+  encoding: {
+    detect: async (..._args: unknown[]) => { console.info("[linkdesk-mock] encoding.detect", ..._args); return ""; },
+    decode: async (..._args: unknown[]) => { console.info("[linkdesk-mock] encoding.decode", ..._args); return ""; },
+    encode: async (..._args: unknown[]) => { console.info("[linkdesk-mock] encoding.encode", ..._args); },
+  },
+  decorations: {
+    registerProvider: (..._args: unknown[]) => { console.info("[linkdesk-mock] decorations.registerProvider", ..._args); },
+    unregisterProvider: (..._args: unknown[]) => { console.info("[linkdesk-mock] decorations.unregisterProvider", ..._args); },
+    getDecoration: async (..._args: unknown[]) => { console.info("[linkdesk-mock] decorations.getDecoration", ..._args); },
+    onDidChange: (..._args: unknown[]) => { console.info("[linkdesk-mock] decorations.onDidChange", ..._args); return () => {}; },
+  },
+  fileAssociation: {
+    getPluginFor: async (..._args: unknown[]) => { console.info("[linkdesk-mock] fileAssociation.getPluginFor", ..._args); },
+  },
+  langDef: {
+    get: async (..._args: unknown[]) => { console.info("[linkdesk-mock] langDef.get", ..._args); },
+  },
+  lsp: {
+    spawn: async (..._args: unknown[]) => { console.info("[linkdesk-mock] lsp.spawn", ..._args); return ""; },
+    write: (..._args: unknown[]) => { console.info("[linkdesk-mock] lsp.write", ..._args); },
+    dispose: async (..._args: unknown[]) => { console.info("[linkdesk-mock] lsp.dispose", ..._args); },
+    onData: (..._args: unknown[]) => { console.info("[linkdesk-mock] lsp.onData", ..._args); return () => {}; },
+  },
+  protocol: {
+    listProtocols: async (..._args: unknown[]) => { console.info("[linkdesk-mock] protocol.listProtocols", ..._args); return []; },
+    getActiveProtocolId: async (..._args: unknown[]) => { console.info("[linkdesk-mock] protocol.getActiveProtocolId", ..._args); return ""; },
+    setActiveProtocolId: async (..._args: unknown[]) => { console.info("[linkdesk-mock] protocol.setActiveProtocolId", ..._args); },
+  },
+  viewContainer: {
+    getViewContainer: async (..._args: unknown[]) => { console.info("[linkdesk-mock] viewContainer.getViewContainer", ..._args); },
+    getViews: async (..._args: unknown[]) => { console.info("[linkdesk-mock] viewContainer.getViews", ..._args); return []; },
+    getView: async (..._args: unknown[]) => { console.info("[linkdesk-mock] viewContainer.getView", ..._args); },
+    registerView: async (..._args: unknown[]) => { console.info("[linkdesk-mock] viewContainer.registerView", ..._args); },
+  },
+  plugins: {
+    resolvePath: async (..._args: unknown[]) => { console.info("[linkdesk-mock] plugins.resolvePath", ..._args); return ""; },
+    resolveEntry: async (..._args: unknown[]) => { console.info("[linkdesk-mock] plugins.resolveEntry", ..._args); },
+    listDirs: async (..._args: unknown[]) => { console.info("[linkdesk-mock] plugins.listDirs", ..._args); return []; },
+    listAll: async (..._args: unknown[]) => { console.info("[linkdesk-mock] plugins.listAll", ..._args); return []; },
+    listDisabledDirs: async (..._args: unknown[]) => { console.info("[linkdesk-mock] plugins.listDisabledDirs", ..._args); return []; },
+    readManifest: async (..._args: unknown[]) => { console.info("[linkdesk-mock] plugins.readManifest", ..._args); return ""; },
+    readAllManifests: async (..._args: unknown[]) => { console.info("[linkdesk-mock] plugins.readAllManifests", ..._args); },
+    packageDownload: async (..._args: unknown[]) => { console.info("[linkdesk-mock] plugins.packageDownload", ..._args); },
+    packageExtract: async (..._args: unknown[]) => { console.info("[linkdesk-mock] plugins.packageExtract", ..._args); },
+    packageUpdateCheck: async (..._args: unknown[]) => { console.info("[linkdesk-mock] plugins.packageUpdateCheck", ..._args); },
+    packageStageUpdate: async (..._args: unknown[]) => { console.info("[linkdesk-mock] plugins.packageStageUpdate", ..._args); },
+    packageCommitUpdate: async (..._args: unknown[]) => { console.info("[linkdesk-mock] plugins.packageCommitUpdate", ..._args); },
+  },
+  pluginManager: {
+    list: async (..._args: unknown[]) => { console.info("[linkdesk-mock] pluginManager.list", ..._args); return []; },
+    enable: async (..._args: unknown[]) => { console.info("[linkdesk-mock] pluginManager.enable", ..._args); },
+    disable: async (..._args: unknown[]) => { console.info("[linkdesk-mock] pluginManager.disable", ..._args); },
+    uninstall: async (..._args: unknown[]) => { console.info("[linkdesk-mock] pluginManager.uninstall", ..._args); },
+    install: async (..._args: unknown[]) => { console.info("[linkdesk-mock] pluginManager.install", ..._args); },
+    installWithProgress: async (..._args: unknown[]) => { console.info("[linkdesk-mock] pluginManager.installWithProgress", ..._args); },
+    reinstall: async (..._args: unknown[]) => { console.info("[linkdesk-mock] pluginManager.reinstall", ..._args); },
+    getDisabled: async (..._args: unknown[]) => { console.info("[linkdesk-mock] pluginManager.getDisabled", ..._args); return []; },
+    getUninstalled: async (..._args: unknown[]) => { console.info("[linkdesk-mock] pluginManager.getUninstalled", ..._args); return []; },
+    isDisabled: async (..._args: unknown[]) => { console.info("[linkdesk-mock] pluginManager.isDisabled", ..._args); return false; },
+    update: async (..._args: unknown[]) => { console.info("[linkdesk-mock] pluginManager.update", ..._args); },
+    checkUpdates: async (..._args: unknown[]) => { console.info("[linkdesk-mock] pluginManager.checkUpdates", ..._args); },
+    notifyManifestChanged: (..._args: unknown[]) => { console.info("[linkdesk-mock] pluginManager.notifyManifestChanged", ..._args); },
+  },
+  bridge: {
+    onRequest: (..._args: unknown[]) => { console.info("[linkdesk-mock] bridge.onRequest", ..._args); return () => {}; },
+    respond: (..._args: unknown[]) => { console.info("[linkdesk-mock] bridge.respond", ..._args); },
+    broadcast: (..._args: unknown[]) => { console.info("[linkdesk-mock] bridge.broadcast", ..._args); },
+    notifyConfigChanged: (..._args: unknown[]) => { console.info("[linkdesk-mock] bridge.notifyConfigChanged", ..._args); },
+  },
+  pool: {
+    pushLayout: (..._args: unknown[]) => { console.info("[linkdesk-mock] pool.pushLayout", ..._args); },
+    onReady: (..._args: unknown[]) => { console.info("[linkdesk-mock] pool.onReady", ..._args); return () => {}; },
+    toggleDevTools: (..._args: unknown[]) => { console.info("[linkdesk-mock] pool.toggleDevTools", ..._args); },
+    onSidebarAction: (..._args: unknown[]) => { console.info("[linkdesk-mock] pool.onSidebarAction", ..._args); return () => {}; },
+    onTabAction: (..._args: unknown[]) => { console.info("[linkdesk-mock] pool.onTabAction", ..._args); return () => {}; },
+    onTabBarRects: (..._args: unknown[]) => { console.info("[linkdesk-mock] pool.onTabBarRects", ..._args); return () => {}; },
+    onDragPosition: (..._args: unknown[]) => { console.info("[linkdesk-mock] pool.onDragPosition", ..._args); return () => {}; },
+    pushAdsorbHint: (..._args: unknown[]) => { console.info("[linkdesk-mock] pool.pushAdsorbHint", ..._args); },
+    onAdsorbIndex: (..._args: unknown[]) => { console.info("[linkdesk-mock] pool.onAdsorbIndex", ..._args); return () => {}; },
+    pushQuickPick: (..._args: unknown[]) => { console.info("[linkdesk-mock] pool.pushQuickPick", ..._args); },
+    onQuickPickAction: (..._args: unknown[]) => { console.info("[linkdesk-mock] pool.onQuickPickAction", ..._args); return () => {}; },
+    pushToast: (..._args: unknown[]) => { console.info("[linkdesk-mock] pool.pushToast", ..._args); },
+    onToastAction: (..._args: unknown[]) => { console.info("[linkdesk-mock] pool.onToastAction", ..._args); return () => {}; },
+    pushDialog: (..._args: unknown[]) => { console.info("[linkdesk-mock] pool.pushDialog", ..._args); },
+    onDialogAction: (..._args: unknown[]) => { console.info("[linkdesk-mock] pool.onDialogAction", ..._args); return () => {}; },
+    pushFloatingPanel: (..._args: unknown[]) => { console.info("[linkdesk-mock] pool.pushFloatingPanel", ..._args); },
+    onFloatingPanelAction: (..._args: unknown[]) => { console.info("[linkdesk-mock] pool.onFloatingPanelAction", ..._args); return () => {}; },
+    onMemoryPressure: (..._args: unknown[]) => { console.info("[linkdesk-mock] pool.onMemoryPressure", ..._args); return () => {}; },
+    createWindow: (..._args: unknown[]) => { console.info("[linkdesk-mock] pool.createWindow", ..._args); },
+    closeWindow: (..._args: unknown[]) => { console.info("[linkdesk-mock] pool.closeWindow", ..._args); },
+    onWindowClosed: (..._args: unknown[]) => { console.info("[linkdesk-mock] pool.onWindowClosed", ..._args); return () => {}; },
+    onWindowBoundsChanged: (..._args: unknown[]) => { console.info("[linkdesk-mock] pool.onWindowBoundsChanged", ..._args); return () => {}; },
+    onLayout: (..._args: unknown[]) => { console.info("[linkdesk-mock] pool.onLayout", ..._args); return () => {}; },
+    ready: (..._args: unknown[]) => { console.info("[linkdesk-mock] pool.ready", ..._args); },
+    sidebarAction: (..._args: unknown[]) => { console.info("[linkdesk-mock] pool.sidebarAction", ..._args); },
+    tabAction: (..._args: unknown[]) => { console.info("[linkdesk-mock] pool.tabAction", ..._args); },
+    tabBarRects: (..._args: unknown[]) => { console.info("[linkdesk-mock] pool.tabBarRects", ..._args); },
+    dragPosition: (..._args: unknown[]) => { console.info("[linkdesk-mock] pool.dragPosition", ..._args); },
+    onAdsorbHint: (..._args: unknown[]) => { console.info("[linkdesk-mock] pool.onAdsorbHint", ..._args); return () => {}; },
+    adsorbIndex: (..._args: unknown[]) => { console.info("[linkdesk-mock] pool.adsorbIndex", ..._args); },
+    registerBeforeClose: (..._args: unknown[]) => { console.info("[linkdesk-mock] pool.registerBeforeClose", ..._args); },
+    unregisterBeforeClose: (..._args: unknown[]) => { console.info("[linkdesk-mock] pool.unregisterBeforeClose", ..._args); },
+    beforeClose: async (..._args: unknown[]) => { console.info("[linkdesk-mock] pool.beforeClose", ..._args); return false; },
+  },
+  window: {
+    minimize: (..._args: unknown[]) => { console.info("[linkdesk-mock] window.minimize", ..._args); },
+    maximize: (..._args: unknown[]) => { console.info("[linkdesk-mock] window.maximize", ..._args); },
+    unmaximize: (..._args: unknown[]) => { console.info("[linkdesk-mock] window.unmaximize", ..._args); },
+    close: (..._args: unknown[]) => { console.info("[linkdesk-mock] window.close", ..._args); },
+    setZoom: (..._args: unknown[]) => { console.info("[linkdesk-mock] window.setZoom", ..._args); },
+    toggleDevTools: async (..._args: unknown[]) => { console.info("[linkdesk-mock] window.toggleDevTools", ..._args); },
+    isMaximized: async (..._args: unknown[]) => { console.info("[linkdesk-mock] window.isMaximized", ..._args); return false; },
+    onMaximizeChange: (..._args: unknown[]) => { console.info("[linkdesk-mock] window.onMaximizeChange", ..._args); return () => {}; },
+    setAlwaysOnTop: (..._args: unknown[]) => { console.info("[linkdesk-mock] window.setAlwaysOnTop", ..._args); },
+    isAlwaysOnTop: async (..._args: unknown[]) => { console.info("[linkdesk-mock] window.isAlwaysOnTop", ..._args); return false; },
+    onAlwaysOnTopChange: (..._args: unknown[]) => { console.info("[linkdesk-mock] window.onAlwaysOnTopChange", ..._args); return () => {}; },
+  },
+  shell: {
+    showItemInFolder: async (..._args: unknown[]) => { console.info("[linkdesk-mock] shell.showItemInFolder", ..._args); },
+    openInTerminal: async (..._args: unknown[]) => { console.info("[linkdesk-mock] shell.openInTerminal", ..._args); },
+    startDrag: (..._args: unknown[]) => { console.info("[linkdesk-mock] shell.startDrag", ..._args); },
+  },
+  hotExit: {
+    save: async (..._args: unknown[]) => { console.info("[linkdesk-mock] hotExit.save", ..._args); },
+    load: async (..._args: unknown[]) => { console.info("[linkdesk-mock] hotExit.load", ..._args); },
+    clear: async (..._args: unknown[]) => { console.info("[linkdesk-mock] hotExit.clear", ..._args); },
+  },
+  getFilePath: (..._args: unknown[]) => { console.info("[linkdesk-mock] getFilePath", ..._args); return ""; },
+  panel: {
+    reveal: async (..._args: unknown[]) => { console.info("[linkdesk-mock] panel.reveal", ..._args); },
+    revealFloating: async (..._args: unknown[]) => { console.info("[linkdesk-mock] panel.revealFloating", ..._args); },
+  },
+  settings: {
+    list: async (..._args: unknown[]) => { console.info("[linkdesk-mock] settings.list", ..._args); return []; },
+    getActive: async (..._args: unknown[]) => { console.info("[linkdesk-mock] settings.getActive", ..._args); },
+    setActive: async (..._args: unknown[]) => { console.info("[linkdesk-mock] settings.setActive", ..._args); },
+  },
+  factorySlots: {
+    listRoles: async (..._args: unknown[]) => { console.info("[linkdesk-mock] factorySlots.listRoles", ..._args); return []; },
+    list: async (..._args: unknown[]) => { console.info("[linkdesk-mock] factorySlots.list", ..._args); return []; },
+    getActive: async (..._args: unknown[]) => { console.info("[linkdesk-mock] factorySlots.getActive", ..._args); },
+    setActive: async (..._args: unknown[]) => { console.info("[linkdesk-mock] factorySlots.setActive", ..._args); },
+  },
+};

package/dev-host/mock.ts

@@ -1,34 +1,72 @@
 /**
- * dev 宿主 mock 注入锚点（E6#23.5c 位置定案）。
+ * dev 宿主 mock 注入锚点（E6#23.5c 位置定案）。`injectDevMockApi()` 签名与调用点不变。
  *
- * 纯浏览器 dev 没有真实 preload → `window.linkdesk` 不存在。现役注入体 = **throw-on-call 兜底**：
- * 任何未 mock 的 API 调用抛「仅在生产环境可用」而非静默 `undefined`/`TypeError`——防「dev 正常、
- * 装进 LinkDesk 才炸」的反向落差（E6#27b 精神，先落行为、后补方法表）。
+ * 注入体（E6#27 落地替换，2026-09-07）：
+ *   - 方法树 = 自动生成 [linkdesk-mock.generated.ts](./linkdesk-mock.generated.ts)——与 linkdesk.d.ts
+ *     同一标注源 `src/core/api/linkdesk-api.ts`（杜绝 mock/preload 双份漂移）。每个方法 = 类型驱动
+ *     中性默认 + 调用即打 `[linkdesk-mock] <path>` 日志（mock vs 真 IPC 可感知，不静默假成功）。
+ *   - #27b 兜底层 = 递归 Proxy：树内路径（契约里真实方法/命名空间）返回真子树/方法；**树外路径**
+ *     （契约里不存在的方法名，如拼写错）**调用时抛错**「不在 linkdesk API 契约」而非静默 undefined /
+ *     `undefined is not a function`——单源同构下，mock 缺 = 生产也缺，早抛早纠正。
  *
- * 🔵 承接锚：真方法默认值表 = E6#27（generate-contract.mjs 第二输出目标，第 2.3 轮）——
- * 届时替换本文件注入体（代理内填充生成的方法），`injectDevMockApi()` 签名与调用点不变。
+ * 真数据/真行为（串口/文件系统/IPC）不属于浏览器 mock——走真实 preload（装进 LinkDesk）或
+ * `linkdesk-plugin-sdk dev --real` 真机环（E6#28.5）。
  */
+import { linkdeskMock } from "./linkdesk-mock.generated.js";
+
+/** 常见 introspection 键——不当作 linkdesk API 路径，返回 undefined（防 console/JSON/运行时探测误触 throw-stub） */
+const SKIP_INTRINSIC = new Set([
+  "then",
+  "toJSON",
+  "toString",
+  "valueOf",
+  "constructor",
+  "__proto__",
+  "hasOwnProperty",
+  "isPrototypeOf",
+  "propertyIsEnumerable",
+]);
+
+/** 树外路径 call-stub——访问不抛（feature-detect 可安全探测），调用才抛（#27b）。
+ *  自身是 Proxy：继续取属性返回更深 stub（`linkdesk.foo.bar()` 整链报完整 dotted path，
+ *  而非裸 TypeError「not a function」）；symbol/intrinsic 键返回 undefined 防运行时探测误触。 */
+function missingApiStub(dotted: string): () => never {
+  const stub = () => {
+    throw new Error(
+      `[dev] window.linkdesk.${dotted} 不是 linkdesk API 方法——dev mock 与 src/core/api/linkdesk-api.ts` +
+        ` 同源自动生成（方法集与生产一致），契约里没有它 = 生产环境调用同样报错。请核对方法名/拼写。` +
+        `确需真实 IPC 行为 → linkdesk-plugin-sdk dev --real（E6#28.5 真机环）。`,
+    );
+  };
+  return new Proxy(stub, {
+    get(_t, prop) {
+      if (typeof prop === "symbol" || SKIP_INTRINSIC.has(String(prop))) return undefined;
+      return missingApiStub(`${dotted}.${String(prop)}`);
+    },
+  });
+}
+
+/** 递归 Proxy：树内路径返回真子树（命名空间再包一层 / 方法叶子直返），树外路径调用抛错 */
+function wrapNode(node: Record<string, unknown>, path: string[]): Record<string, unknown> {
+  return new Proxy(node, {
+    get(t, prop) {
+      if (typeof prop === "symbol") return undefined;
+      const key = String(prop);
+      if (SKIP_INTRINSIC.has(key)) return undefined;
+      if (key in t) {
+        const v = t[key];
+        if (typeof v === "function") return v; // 方法叶子（自打 [linkdesk-mock] 调用日志）
+        if (v !== null && typeof v === "object") return wrapNode(v as Record<string, unknown>, [...path, key]);
+        return v;
+      }
+      return missingApiStub([...path, key].join("."));
+    },
+  });
+}
+
 export function injectDevMockApi(): void {
   if (typeof window === "undefined") return;
   if ((window as unknown as Record<string, unknown>).linkdesk) return;
 
-  // path 跟踪代理：window.linkdesk.configuration.get() → 报「configuration.get 未 mock」
-  const makeNs = (path: string[]): unknown =>
-    new Proxy(function () {
-      /* placeholder: 调用时走 apply trap */
-    } as unknown as () => unknown, {
-      apply(): never {
-        const dotted = path.join(".") || "(根)";
-        throw new Error(
-          `[dev] window.linkdesk${dotted ? "." + dotted : ""} 未 mock——该 API 仅在生产环境可用` +
-            `（build → 装进 LinkDesk 走真实 IPC）。E6#27 生成 mock 落地前，UI 骨架开发请先不调真实 API。`,
-        );
-      },
-      get(_target, prop): unknown {
-        if (prop === "then") return undefined; // 防 Promise.resolve(proxy) 探测无限递归
-        return makeNs([...path, String(prop)]);
-      },
-    });
-
-  (window as unknown as Record<string, unknown>).linkdesk = makeNs([]);
+  (window as unknown as Record<string, unknown>).linkdesk = wrapNode(linkdeskMock, []);
 }

package/dist/bin.js

@@ -14,6 +14,8 @@ import { build } from "vite";
 import { validatePluginJson } from "./validate.js";
 import { defineLinkdeskPluginConfig } from "./vite-config.js";
 import { runPluginDev } from "./dev-server.js";
+import { runPluginDevReal } from "./dev-real.js";
+import { runPluginPublish } from "./publish.js";
 import { runPluginLint, renderPluginLintReport } from "./eslint/lint.js";
 const VITE_CONFIG_FILES = [
     "vite.config.ts",
@@ -28,7 +30,14 @@ const USAGE = `linkdesk-plugin-sdk <command>
 命令：
   dev         在插件工程根起 dev 宿主（E6#24）——读 plugin.json → Vite dev server（端口 1421）
               → 浏览器打开纯前端预览 + HMR。只支持带 entry 的视图插件（脚手架 tab 形态）
+  dev --real  E6#28.5 真机环——watch 作者源码 → 隔离单插件 build → 直写 {userData}/plugins/<id>
+              → CDP reload「LinkDesk Pool」（LinkDesk 须以 --remote-debugging-port=9222 启动）。
+              真 IPC/串口/LSP 类插件的秒级真机调试（壳零新代码；LINKDESK_USER_PLUGINS_DIR /
+              LINKDESK_CDP_PORT 可覆盖）
   build       在插件工程根构建 .linkdesk-plugin（读 plugin.json → Vite build → zip）
+  publish     一键发布（E6#26）——自动链路：建 GitHub Release → 上传 .linkdesk-plugin → 更新工程
+              origin 仓库根 marketplace.json（多市场源模型）。发前预览确认；--yes 跳过（CI）；
+              --dry-run 只预览不碰网络。token：env LINKDESK_GITHUB_TOKEN，或首跑交互输入存入本机
   validate    校验 plugin.json（参数 = 路径，默认 ./plugin.json）
   lint        E6#54d 门禁（eslint 12 规则 + 三 check 双轨，全 WARN 永不 fail；知情绕行 =
               eslint-disable 注释）。参数 = 工程根，默认 process.cwd()
@@ -62,22 +71,47 @@ function cmdValidate(target) {
     return 0;
 }
 async function main() {
-    const [, , command, arg] = process.argv;
+    const [, , command] = process.argv;
+    const rest = process.argv.slice(3); // 参数：dev --real / validate <path> / lint <root>
     let code;
     switch (command) {
-        case "dev":
-            // 挂起直到 Ctrl+C（server.close 后 resolve）——dev 无退出码语义，正常退出 = 0
-            await runPluginDev(process.cwd());
+        case "dev": {
+            // dev [--real]——真机环（E6#28.5）：build→直写 userData/plugins→CDP reload；挂起直到 Ctrl+C
+            if (rest.includes("--real")) {
+                await runPluginDevReal(process.cwd());
+            }
+            else if (rest.some((a) => a.startsWith("-") && a !== "--real")) {
+                console.error(USAGE);
+                code = 1;
+                break;
+            }
+            else {
+                // 挂起直到 Ctrl+C（server.close 后 resolve）——dev 无退出码语义，正常退出 = 0
+                await runPluginDev(process.cwd());
+            }
             code = 0;
             break;
+        }
         case "build":
             code = await cmdBuild();
             break;
+        case "publish": {
+            // publish [--yes|--dry-run]——E6#26 自动发布链路（发前预览确认）
+            const flags = rest.filter((a) => a.startsWith("-"));
+            const unknown = flags.filter((a) => a !== "--yes" && a !== "--dry-run");
+            if (unknown.length > 0 || rest.some((a) => !a.startsWith("-"))) {
+                console.error(USAGE);
+                code = 1;
+                break;
+            }
+            code = await runPluginPublish(process.cwd(), { yes: rest.includes("--yes"), dryRun: rest.includes("--dry-run") });
+            break;
+        }
         case "validate":
-            code = cmdValidate(arg ?? "plugin.json");
+            code = cmdValidate(rest[0] ?? "plugin.json");
             break;
         case "lint":
-            code = await cmdLint(arg ?? process.cwd());
+            code = await cmdLint(rest[0] ?? process.cwd());
             break;
         default:
             console.error(USAGE);

package/dist/bin.js.map

@@ -1 +1 @@
-{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":"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"}

package/dist/dev-real.d.ts

@@ -0,0 +1,24 @@
+/** CDP reload 端口默认 9222（与壳 dev electron:dev 尾部 --remote-debugging-port=9222 对齐）；LINKDESK_CDP_PORT 覆盖 */
+export declare const CDP_PORT: number;
+/** 作者当前平台 LinkDesk userData/plugins 代码根（Electron 默认 userData = appData/<appName>，dev/打包同名 "linkdesk"）。
+ *  LINKDESK_USER_PLUGINS_DIR 环境变量可覆盖（自定义安装布局 / CI 隔离 userData 的逃生门）。 */
+export declare function resolveUserPluginsDir(): string;
+/**
+ * 经 CDP 刷新「LinkDesk Pool」窗口——renderer 重 import = 直写产物生效。返回是否找到并刷新成功。
+ *
+ * E6#28.5 真机自验实证（2026-09-07）：单发 Page.reload 不足——`protocol.handle` 的 linkdesk:// 响应
+ * 无 Cache-Control 头 → Chromium 同 URL 二次请求命中缓存，index.bundle.js 陈旧副本永远被喂（直写磁盘
+ * 被遮蔽，protocol-debug.log 无新 200 行可证）。修复 = reload 前 Network.enable + Network.clearBrowserCache，
+ * 清掉缓存让 reload 后重 import 落到磁盘逐请求 readFileSync（纯 CDP，壳零代码）。
+ */
+export declare function cdpReloadPool(port?: number): Promise<boolean>;
+export interface RealLoopHooks {
+    /** 每次成功 build+直写后回调（默认 = CDP reload；测试/工具可注入） */
+    onInstalled?: (pluginId: string, targetDir: string) => Promise<void>;
+}
+/**
+ * 跑真机环并挂起进程（Ctrl+C → 关 watcher + 退出）。每次源码变更：debounce → 全量单插件 build →
+ * 直写 {userData}/plugins/<id> → CDP reload「LinkDesk Pool」。
+ */
+export declare function runPluginDevReal(root: string): Promise<void>;
+//# sourceMappingURL=dev-real.d.ts.map

package/dist/dev-real.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-real.d.ts","sourceRoot":"","sources":["../src/dev-real.ts"],"names":[],"mappings":"AA4BA,wGAAwG;AACxG,eAAO,MAAM,QAAQ,QAAgD,CAAC;AAEtE;wEACwE;AACxE,wBAAgB,qBAAqB,IAAI,MAAM,CAY9C;AAyED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,IAAI,SAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAgCrE;AAeD,MAAM,WAAW,aAAa;IAC5B,iDAAiD;IACjD,WAAW,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACtE;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgIlE"}