@forgeax/view 0.5.0-dev.13604.c415409c3b9d → 0.5.0-dev.13713.d28c4863d779

package/dist/modules/chunks/{chunk-HWZCLROY.mjs → chunk-CN6YN4HP.mjs}

@@ -1,11 +1,11 @@
 import {
   runWorkspaceToolApi
-} from "./chunk-EZSGDSCC.mjs";
+} from "./chunk-ZRE7BDDB.mjs";
 import {
   isWorkspaceTargetRecoveryCode,
   resolveWorkspaceFailure,
   resolveWorkspaceReopenRoot
-} from "./chunk-K2QZRFLE.mjs";
+} from "./chunk-KJTMDFFX.mjs";
 import {
   editorSceneTargetIds,
   isEditorWorkspaceAsset,
@@ -13,13 +13,16 @@ import {
   logResourceOpen,
   selectEditorWorkspacePreview,
   summarizeResourceAsset
-} from "./chunk-ZIDEETK4.mjs";
+} from "./chunk-E4G4HDOC.mjs";
 import {
   workspaceDiagnosticRecord
-} from "./chunk-U5R6MVM4.mjs";
+} from "./chunk-RFTLGEB5.mjs";
 import {
   VIEW_DISPLAY_TAB_ID,
   VIEW_FILE_GET_SERVICE,
+  VIEW_PACK_REVEAL_ACK_SERVICE,
+  VIEW_PACK_REVEAL_TOPIC,
+  VIEW_PACK_SOURCES_SERVICE,
   VIEW_WORKSPACE_API_VERSION,
   VIEW_WORKSPACE_OPERATIONS,
   VIEW_WORKSPACE_SERVICES,
@@ -35,7 +38,7 @@ import {
   workspaceCapabilities,
   workspaceError,
   workspaceUiFingerprint
-} from "./chunk-E3Z7GLFU.mjs";
+} from "./chunk-QJHQN6OD.mjs";
 import {
   createWorkspaceId
 } from "./chunk-4XEXLHX4.mjs";
@@ -158,6 +161,15 @@ async function readWorkspaceFilePreview(workspace, payload = {}) {
 // packages/view-workspace-core/src/broker.ts
 var ENGINE_SOURCE = "engine-workspace";
 var UI_OPERATIONS = Object.freeze({
+  "summary.get": (workspace) => workspace.summary(),
+  "pages.list": (workspace) => workspace.pages(),
+  "pack.reveal": (workspace, args, context) => workspace.revealPack({
+    projectId: requireWorkspaceString(args.projectId, "projectId"),
+    sourcePath: requireWorkspaceString(args.sourcePath, "sourcePath"),
+    revision: requireWorkspaceString(args.revision, "revision"),
+    ...args.packageId === void 0 ? {} : { packageId: requireWorkspaceString(args.packageId, "packageId") },
+    ...args.connectionId === void 0 ? {} : { connectionId: requireWorkspaceString(args.connectionId, "connectionId") }
+  }, context.signal),
   "target.select": (workspace, args) => workspace.selectTarget(args),
   "tabs.get": (workspace) => workspace.snapshot(),
   "tabs.select": (workspace, args) => workspace.selectTab(args),
@@ -165,13 +177,30 @@ var UI_OPERATIONS = Object.freeze({
   "scene.pick": (workspace, args, context) => workspace.pickSceneEntity(args, context),
   "scene.clear": (workspace, args, context) => workspace.clearSceneSelection(args, context)
 });
-var ViewWorkspaceBroker = class {
-  constructor({ engine, toolApi, display = () => void 0, accessToken = randomUUID(), authorize } = {}) {
+var PAGE_OPERATIONS = /* @__PURE__ */ new Set([
+  "tabs.get",
+  "tabs.select",
+  "target.select",
+  "scene.select",
+  "scene.pick",
+  "scene.clear",
+  "asset.open",
+  "preview.close",
+  "play.start",
+  "play.ready",
+  "play.stop"
+]);
+var ViewWorkspaceBroker = class _ViewWorkspaceBroker {
+  constructor({ engine, engineForCaller, projectIntent, toolApi, display = () => void 0, accessToken = randomUUID(), authorize, packSources } = {}, caller) {
     this.engine = engine;
+    this.engineForCaller = engineForCaller;
+    this.projectIntent = projectIntent;
+    this.caller = caller;
     this.toolApi = toolApi;
     this.display = display;
     this.accessToken = accessToken;
     this.authorize = authorize;
+    this.packSources = packSources;
     this.selectedTabId = VIEW_WORKSPACE_TAB_ID;
     this.targetBinding = "editor";
     this.editorTargetId = void 0;
@@ -192,6 +221,8 @@ var ViewWorkspaceBroker = class {
     this.catalogEpoch = -1;
     this.disposing = false;
     this.publishFingerprint = "";
+    this.pageSessions = /* @__PURE__ */ new Map();
+    this.pendingReveals = /* @__PURE__ */ new Map();
   }
   get project() {
     return this.engine?.project?.project ?? null;
@@ -273,6 +304,35 @@ var ViewWorkspaceBroker = class {
       } : null;
     }
   }
+  summary() {
+    const project = this.project;
+    const previews = this.previews();
+    const projectTarget = this.projectTarget && this.engine?.preview?.target.targetId === this.projectTarget.targetId ? this.engine.preview.target : this.projectTarget;
+    const active = [
+      ...projectTarget ? [{ target: projectTarget, role: "project" }] : [],
+      ...this.engine?.play ? [{ target: this.engine.play.target, role: "play" }] : []
+    ];
+    const targets = [...active, ...previews.slice(0, Math.max(0, 16 - active.length)).map((preview) => ({ target: preview.target, role: "preview" }))];
+    return {
+      revision: this.revision,
+      project: project ? { id: project.id, root: project.root, name: project.name } : null,
+      projectPhase: this.engine?.project?.phase ?? null,
+      browserGeneration: this.engine?.project?.browserGeneration ?? null,
+      targets: targets.map(({ target, role }) => ({
+        targetId: target.targetId,
+        ...target.generation === void 0 ? {} : { generation: target.generation },
+        role
+      })),
+      hasMoreTargets: active.length + previews.length > 16
+    };
+  }
+  pages() {
+    const entries = [...this.pageSessions.entries()];
+    return {
+      pages: entries.slice(0, 16).map(([connectionId, page]) => ({ connectionId, ...page.broker.summary() })),
+      hasMorePages: entries.length > 16
+    };
+  }
   snapshot() {
     this.syncBindings();
     const display = this.display?.();
@@ -299,6 +359,7 @@ var ViewWorkspaceBroker = class {
       ],
       project: this.project,
       projectTarget: this.projectTarget,
+      ...!this.project && this.projectIntent?.() ? { projectIntent: { root: this.projectIntent() } } : {},
       ...this.engine?.project?.phase === void 0 ? {} : { projectPhase: this.engine.project.phase },
       ...this.engine?.project?.browserGeneration === void 0 ? {} : { browserGeneration: this.engine.project.browserGeneration },
       assets: this.assets,
@@ -352,7 +413,21 @@ var ViewWorkspaceBroker = class {
   }
   async call(rawRequest, { signal, caller } = {}) {
     const request = assertWorkspaceRequest(rawRequest);
+    if (request.operation === "pages.list" || request.operation === "pack.reveal") {
+      await this.authorizeRequest(request, caller);
+      return UI_OPERATIONS[request.operation](this, request.args, { signal, caller, clientId: request.clientId });
+    }
+    const page = caller?.connectionId && this.pageSessions.get(caller.connectionId);
+    if (page) return page.broker.call(rawRequest, { signal, caller });
     await this.authorizeRequest(request, caller);
+    if (PAGE_OPERATIONS.has(request.operation) && this.pageSessions.size > 0) {
+      if (this.pageSessions.size !== 1) throw workspaceError(
+        "view-page-ambiguous",
+        "one View page for this page operation",
+        "Select the exact View page before retrying."
+      );
+      return this.pageSessions.values().next().value.broker.call(request, { signal, caller });
+    }
     const ui = UI_OPERATIONS[request.operation];
     if (ui) return ui(this, request.args, { signal, caller, clientId: request.clientId });
     if (request.operation === "project.reopen") {
@@ -367,12 +442,15 @@ var ViewWorkspaceBroker = class {
     return this.invoke(request.operation, request.args, { signal, caller, clientId: request.clientId, token: request.token, requestId: request.requestId });
   }
   async invoke(operation, args = {}, { signal, caller, clientId = "view-owner", token, requestId } = {}) {
+    caller ??= this.caller;
     const { tabId, ...input } = args;
     if (tabId !== void 0) this.assertWorkspaceTab(tabId);
     const inspector = operation.startsWith("plugins.");
     const presentation = operation.startsWith("display.");
     const id = inspector ? operation : `${presentation ? "view" : "engine"}.${operation}`;
     const sourceId = inspector || presentation ? "view-backend" : ENGINE_SOURCE;
+    if (this.caller && !inspector && !presentation && !operation.startsWith("run.") && input.targetId === void 0 && this.projectTarget)
+      input.targetId = this.projectTarget.targetId;
     const owner = this.toolApi?.describe(id, sourceId).find((record) => record.callable)?.owner;
     if (!owner) throw workspaceError("view-workspace-operation-unavailable", `Engine operation ${operation} to be installed`, "Enable the Engine capability; UI plugins do not provide domain APIs.", { operation });
     this.syncBindings();
@@ -415,7 +493,7 @@ var ViewWorkspaceBroker = class {
       this.previewProjection.cameraVersion = result?.version;
       this.previewProjection.interaction = result?.interaction ?? null;
     }
-    if (!["scene-tree.get", "entity.inspect", "workspace.get", "preview.capture"].includes(operation)) this.changed();
+    if (!["scene.tree.get", "entity.inspect", "workspace.get", "preview.capture"].includes(operation)) this.changed();
     if (["project.open", "project.close", "project.reopen", "asset.open", "preview.close", "camera.abort", "play.start", "play.ready", "play.stop"].includes(operation)) {
       if (operation === "project.open" || operation === "project.reopen") this.workspaceTargetLost = false;
       return this.snapshot();
@@ -499,7 +577,7 @@ var ViewWorkspaceBroker = class {
     return this.invoke("asset.inspect", args, context);
   }
   rebuildAssetSource(args, { mode = "rebuild", ...context } = {}) {
-    return this.invoke(`asset-source.${mode}`, args, context);
+    return this.invoke(`asset.source.${mode}`, args, context);
   }
   bindOpenedAsset(result, guid) {
     this.targetBinding = "editor";
@@ -601,10 +679,22 @@ var ViewWorkspaceBroker = class {
     return this.invoke("camera.abort", args, context);
   }
   getSceneTree(args, context) {
-    return this.invoke("scene-tree.get", args, context);
+    return this.invoke("scene.tree.get", args, context);
   }
   async revokeConnection(connectionId) {
     if (typeof connectionId !== "string") return;
+    if (!this.pageSessions.has(connectionId) && ![...this.pendingReveals.values()].some((pending) => pending.connectionId === connectionId)) return;
+    for (const [requestId, pending] of this.pendingReveals) {
+      if (pending.connectionId !== connectionId) continue;
+      this.pendingReveals.delete(requestId);
+      pending.settle({ ok: false, code: "view-page-gone", requestId });
+    }
+    const page = this.pageSessions.get(connectionId);
+    if (page) {
+      this.pageSessions.delete(connectionId);
+      page.unsubscribe();
+      await page.broker.dispose();
+    }
     for (const preview of [this.engine?.preview, this.engine?.play]) {
       if (!preview) continue;
       try {
@@ -619,37 +709,94 @@ var ViewWorkspaceBroker = class {
     }
     this.changed();
   }
-  /**
-   * Reset per-page UI session state when a new View frontend page is admitted.
-   * The open project and its Engine session stay; everything the previous page
-   * accumulated after project.open returns to the just-opened state, so a
-   * refreshed page's first snapshot does not inherit the old page's history.
-   */
-  resetPageSession() {
-    if (this.disposing) return;
-    this.selectedTabId = VIEW_WORKSPACE_TAB_ID;
-    this.targetBinding = "editor";
-    this.previewTargetId = void 0;
-    this.inspection = null;
-    this.openRequest = null;
-    this.openRequestSequence = 0;
-    this.resourceOpens = /* @__PURE__ */ new Map();
-    this.sceneSelection = null;
-    this.selectionAbort?.abort();
-    this.selectionAbort = void 0;
-    this.previewOwner = void 0;
-    this.syncBindings();
-    this.changed();
-    const project = this.project;
-    if (project) {
-      void this.invoke("assets.list", { projectId: project.id }).catch(() => {
-      });
+  /** One accepted View frontend owns one presentation projection and event stream. */
+  attachPageSession(caller, transport) {
+    const engine = this.engineForCaller ? this.engineForCaller(caller) : this.engine;
+    const projectTarget = engine?.project?.target;
+    const projectCaller = projectTarget && caller.sourceId === `forgeax-workspace:${projectTarget.sessionId}:${projectTarget.targetId}`;
+    if (caller.kind !== "frontend" || caller.sourceId !== "view-frontend" && !projectCaller || this.pageSessions.has(caller.connectionId)) return;
+    const broker = new _ViewWorkspaceBroker({
+      engine,
+      toolApi: this.toolApi,
+      display: () => this.display(caller),
+      ...this.engineForCaller && caller.sourceId === "view-frontend" ? { projectIntent: () => this.project?.root } : {},
+      accessToken: this.accessToken,
+      authorize: this.authorize,
+      packSources: this.packSources
+    }, caller);
+    broker.snapshot();
+    if (engine === this.engine) broker.assets = this.assets;
+    const unsubscribe = broker.subscribe((state) => transport.publish(VIEW_WORKSPACE_STATE_TOPIC, state, { connectionId: caller.connectionId }));
+    this.pageSessions.set(caller.connectionId, { broker, unsubscribe });
+  }
+  publishPageSessions() {
+    for (const { broker } of this.pageSessions.values()) {
+      broker.snapshot();
+      if (broker.engine === this.engine && this.assets !== null) broker.assets = this.assets;
+      broker.changed();
     }
   }
+  async revealPack(input, signal) {
+    const transport = this.transport;
+    if (!transport) return { ok: false, code: "view-page-unavailable" };
+    if (signal?.aborted) return { ok: false, code: "view-reveal-cancelled" };
+    const candidates = [...this.pageSessions.keys()];
+    if (!input.connectionId && candidates.length !== 1)
+      return { ok: false, code: candidates.length ? "view-page-ambiguous" : "view-page-unavailable", candidates };
+    const connectionId = input.connectionId ?? candidates[0];
+    const page = this.pageSessions.get(connectionId);
+    if (!page) return { ok: false, code: "view-page-gone" };
+    const project = page.broker.project;
+    if (!project || project.id !== input.projectId) return { ok: false, code: "view-project-stale" };
+    if (!this.packSources) return { ok: false, code: "view-pack-sources-unavailable" };
+    const source = (await this.packSources(project.root)).sources.find((row) => row.sourcePath === input.sourcePath);
+    if (signal?.aborted) return { ok: false, code: "view-reveal-cancelled" };
+    if (!source || source.revision !== input.revision || input.packageId && source.packageId !== input.packageId)
+      return { ok: false, code: "view-pack-stale" };
+    const requestId = randomUUID();
+    const intent = {
+      requestId,
+      connectionId,
+      projectId: input.projectId,
+      sourcePath: input.sourcePath,
+      revision: input.revision,
+      ...source.packageId ? { packageId: source.packageId } : {}
+    };
+    return new Promise((resolve2) => {
+      const retire = (code) => {
+        this.pendingReveals.delete(requestId);
+        transport.publish(VIEW_PACK_REVEAL_TOPIC, { ...intent, cancelled: true }, { connectionId });
+        settle({ ok: false, code, requestId });
+      };
+      const cancel = () => {
+        retire("view-reveal-cancelled");
+      };
+      const settle = (value) => {
+        clearTimeout(timeout);
+        signal?.removeEventListener("abort", cancel);
+        resolve2(value);
+      };
+      const timeout = setTimeout(() => {
+        retire("view-reveal-timeout");
+      }, 12e3);
+      timeout.unref?.();
+      this.pendingReveals.set(requestId, {
+        connectionId,
+        projectId: input.projectId,
+        sourcePath: input.sourcePath,
+        revision: input.revision,
+        settle
+      });
+      signal?.addEventListener("abort", cancel, { once: true });
+      transport.publish(VIEW_PACK_REVEAL_TOPIC, intent, { connectionId });
+    });
+  }
   registerTransport(transport, { routeThroughTools = false } = {}) {
+    this.transport = transport;
     const capabilities = transport.register(VIEW_WORKSPACE_SERVICES.capabilities, () => this.capabilities());
     const call = transport.register(VIEW_WORKSPACE_SERVICES.call, async ({ payload, signal, caller }) => {
       try {
+        this.attachPageSession(caller, transport);
         return routeThroughTools ? await runWorkspaceToolApi(this.toolApi, {
           operation: `view.workspace.${payload.operation}`,
           args: payload.args,
@@ -672,9 +819,9 @@ var ViewWorkspaceBroker = class {
         });
       }
     });
-    const fileGet = transport.register(VIEW_FILE_GET_SERVICE, async ({ payload }) => {
+    const fileGet = transport.register(VIEW_FILE_GET_SERVICE, async ({ payload, caller }) => {
       try {
-        return await readWorkspaceFilePreview(this, payload);
+        return await readWorkspaceFilePreview(this.pageSessions.get(caller.connectionId)?.broker ?? this, payload);
       } catch (error) {
         const failure = workspaceDiagnosticRecord(error);
         if (typeof failure.code !== "string" || !failure.code.startsWith("view-")) throw error;
@@ -687,27 +834,77 @@ var ViewWorkspaceBroker = class {
         });
       }
     });
-    const subscription = this.subscribe((state) => transport.publish(VIEW_WORKSPACE_STATE_TOPIC, state));
+    const packSources = transport.register(VIEW_PACK_SOURCES_SERVICE, async ({ payload, caller }) => {
+      const project = (this.pageSessions.get(caller.connectionId)?.broker ?? this).project;
+      if (!project || payload?.projectId !== project.id) throw workspaceError("view-project-stale", "the currently open project", "Refresh the workspace before listing Pack sources.");
+      if (!this.packSources) throw workspaceError("view-pack-sources-unavailable", "an installed Pack source provider", "Update the View Host Pack.");
+      return this.packSources(project.root);
+    });
+    const revealAck = transport.register(VIEW_PACK_REVEAL_ACK_SERVICE, async ({ payload, caller }) => {
+      const requestId = typeof payload?.requestId === "string" ? payload.requestId : "";
+      const pending = this.pendingReveals.get(requestId);
+      if (!pending || pending.connectionId !== caller.connectionId) return { ok: false, code: "view-reveal-stale" };
+      if (pending.projectId !== payload.projectId || pending.sourcePath !== payload.sourcePath || pending.revision !== payload.revision)
+        return { ok: false, code: "view-reveal-identity-mismatch" };
+      const page = this.pageSessions.get(caller.connectionId);
+      const project = page?.broker.project;
+      const source = project && this.packSources ? (await this.packSources(project.root)).sources.find((row) => row.sourcePath === pending.sourcePath) : void 0;
+      if (this.pendingReveals.get(requestId) !== pending) return { ok: false, code: "view-reveal-stale" };
+      if (!project || project.id !== pending.projectId || source?.revision !== pending.revision) {
+        this.pendingReveals.delete(requestId);
+        pending.settle({ ok: false, code: "view-reveal-stale", requestId });
+        return { ok: false, code: "view-reveal-stale" };
+      }
+      this.pendingReveals.delete(requestId);
+      pending.settle({
+        ok: payload.shown === true,
+        code: payload.shown === true ? "shown" : "view-reveal-not-shown",
+        requestId,
+        connectionId: caller.connectionId,
+        projectId: payload.projectId,
+        sourcePath: payload.sourcePath,
+        revision: payload.revision,
+        ...typeof payload.reason === "string" ? { reason: payload.reason.slice(0, 160) } : {}
+      });
+      return { ok: true };
+    });
+    const subscription = this.subscribe((state) => transport.publish(VIEW_WORKSPACE_STATE_TOPIC, state, {
+      excludeConnectionIds: [...this.pageSessions.keys()]
+    }));
+    const removeConnect = transport.onClientConnect((caller) => this.attachPageSession(caller, transport));
+    const removeDisconnect = transport.onClientDisconnect((caller) => {
+      void this.revokeConnection(caller.connectionId);
+    });
     const observer = transport.connect();
     const engineSubscription = observer.subscribe("engine.workspace.state", (snapshot) => {
       const epoch = snapshot && typeof snapshot.catalogEpoch === "number" ? snapshot.catalogEpoch : void 0;
       if (epoch === void 0 || epoch <= this.catalogEpoch) {
         this.changed();
+        this.publishPageSessions();
         return;
       }
       this.catalogEpoch = epoch;
-      const project = this.project;
-      if (!project) return;
-      const lost = this.workspaceTargetLost;
-      void this.invoke("assets.list", { projectId: project.id }).catch(() => {
-        this.workspaceTargetLost = lost;
-      });
+      for (const broker of [this, ...[...this.pageSessions.values()].map((page) => page.broker)]) {
+        broker.catalogEpoch = epoch;
+        const project = broker.project;
+        if (!project || broker.engine?.project?.phase !== void 0 && broker.engine.project.phase !== "running") continue;
+        const lost = broker.workspaceTargetLost;
+        void broker.invoke("assets.list", { projectId: project.id }).catch(() => {
+          broker.workspaceTargetLost = lost;
+        }).finally(() => broker.changed());
+      }
+      this.publishPageSessions();
     });
     return () => {
+      if (this.transport === transport) this.transport = void 0;
       capabilities();
       call();
       fileGet();
+      packSources();
+      revealAck();
       subscription();
+      removeConnect();
+      removeDisconnect();
       engineSubscription();
       observer.close();
     };
@@ -716,10 +913,19 @@ var ViewWorkspaceBroker = class {
     this.selectionAbort?.abort();
     this.disposing = true;
     this.listeners.clear();
+    for (const [requestId, pending] of this.pendingReveals) {
+      this.pendingReveals.delete(requestId);
+      pending.settle({ ok: false, code: "view-page-gone", requestId });
+    }
+    for (const [connectionId, page] of this.pageSessions) {
+      this.pageSessions.delete(connectionId);
+      page.unsubscribe();
+      await page.broker.dispose();
+    }
   }
 };
 
 export {
   ViewWorkspaceBroker
 };
-//# sourceMappingURL=chunk-HWZCLROY.mjs.map
+//# sourceMappingURL=chunk-CN6YN4HP.mjs.map