@forgeax/view 0.2.1-beta-20260924075842

package/dist/modules/chunks/chunk-FKCQYDLX.mjs

@@ -0,0 +1,162 @@
+import {
+  traceView
+} from "./chunk-2IJKOG2F.mjs";
+import {
+  createWorkspaceStateReader
+} from "./chunk-FJM6WWIY.mjs";
+
+// packages/view-workspace-core/src/resource-open.mjs
+var LOG_PREFIX = "[forgeax.view.resource-open]";
+var EDITOR_ASSET_KIND = "scene";
+var TYPE_PREVIEW_KINDS = Object.freeze(["material", "mesh", "texture"]);
+function summarizeResourceAsset(asset) {
+  if (!asset || typeof asset !== "object") return null;
+  return {
+    guid: typeof asset.guid === "string" ? asset.guid : null,
+    kind: typeof asset.kind === "string" ? asset.kind : null
+  };
+}
+function isEditorWorkspaceAsset(asset) {
+  return asset?.kind === EDITOR_ASSET_KIND;
+}
+function isTypePreviewAsset(asset) {
+  return TYPE_PREVIEW_KINDS.includes(asset?.kind);
+}
+function selectEditorWorkspacePreview(previews, preferredTargetId) {
+  const list = (Array.isArray(previews) ? previews : []).filter(
+    (entry) => entry?.target?.targetId != null
+  );
+  if (preferredTargetId != null && preferredTargetId !== "") {
+    const preferred = list.find(
+      (entry) => String(entry.target.targetId) === String(preferredTargetId)
+    );
+    if (preferred && !isTypePreviewAsset(preferred.asset)) return preferred;
+  }
+  const scenes = list.filter((entry) => isEditorWorkspaceAsset(entry.asset));
+  if (scenes.length === 1) return scenes[0];
+  const editorWorlds = list.filter((entry) => !isTypePreviewAsset(entry.asset));
+  return editorWorlds.length === 1 ? editorWorlds[0] : void 0;
+}
+function selectWorkspaceEditorSurfaceTarget(state) {
+  if (state?.editorPreview?.target) return state.editorPreview.target;
+  const preview = state?.preview;
+  if (preview?.target && !isTypePreviewAsset(preview.asset)) return preview.target;
+  return null;
+}
+function editorSceneTargetIds(previews, editorPreview) {
+  const ids = /* @__PURE__ */ new Set();
+  const add = (entry) => {
+    if (entry?.target?.targetId == null) return;
+    ids.add(String(entry.target.targetId));
+  };
+  add(editorPreview);
+  for (const entry of Array.isArray(previews) ? previews : []) {
+    if (isEditorWorkspaceAsset(entry?.asset)) add(entry);
+  }
+  return ids;
+}
+function logResourceOpen(event, data = {}, { level = "info" } = {}) {
+  const logger = typeof console === "undefined" ? void 0 : console[level];
+  if (typeof logger === "function") logger(LOG_PREFIX, event, data);
+  try {
+    traceView("resource-open", event, data);
+  } catch {
+  }
+}
+function isKind(asset, kinds) {
+  return Boolean(asset && kinds.includes(asset.kind) && typeof asset.guid === "string" && asset.guid !== "");
+}
+function extraPreviewEntries(snapshot) {
+  const editorIds = editorSceneTargetIds(snapshot?.previews, snapshot?.editorPreview);
+  return (Array.isArray(snapshot?.previews) ? snapshot.previews : []).filter((entry) => {
+    if (!entry?.asset || entry.target?.targetId == null) return false;
+    if (isEditorWorkspaceAsset(entry.asset)) return false;
+    if (editorIds.has(String(entry.target.targetId))) return false;
+    return true;
+  });
+}
+function resourceOpenEntry(snapshot, kind) {
+  const opens = snapshot?.resourceOpens;
+  if (!opens || typeof opens !== "object" || kind == null) return void 0;
+  return opens[kind];
+}
+function selectWorkspaceResourceSubject(snapshot, kinds) {
+  const accepted = Array.isArray(kinds) ? kinds : [];
+  if (accepted.length === 0) {
+    const asset = snapshot?.openRequest?.asset;
+    return typeof asset?.guid === "string" && asset.guid !== "" ? asset : void 0;
+  }
+  const extras = extraPreviewEntries(snapshot);
+  const candidates = [
+    snapshot?.openRequest?.asset,
+    snapshot?.openRequest?.preview?.asset,
+    ...accepted.flatMap((kind) => [
+      resourceOpenEntry(snapshot, kind)?.asset,
+      resourceOpenEntry(snapshot, kind)?.preview?.asset
+    ]),
+    ...[...extras].reverse().map((entry) => entry.asset),
+    snapshot?.inspection?.asset
+  ];
+  return candidates.find((asset) => isKind(asset, accepted));
+}
+function selectWorkspaceResourcePreview(snapshot, guid) {
+  if (typeof guid !== "string" || guid === "") return void 0;
+  return extraPreviewEntries(snapshot).find((entry) => entry.asset.guid === guid);
+}
+function openRequestSequence(request) {
+  return request && Number.isSafeInteger(request.sequence) ? request.sequence : 0;
+}
+function observeWorkspaceOpenRequests(client, onOpen) {
+  if (typeof onOpen !== "function") {
+    throw new TypeError("observeWorkspaceOpenRequests requires onOpen");
+  }
+  const reader = createWorkspaceStateReader(client);
+  let lastSequence = 0;
+  let primed = false;
+  const unsubscribe = reader.subscribe(() => {
+    const snapshot = reader.getSnapshot();
+    if (!snapshot) return;
+    const request = snapshot.openRequest;
+    const sequence = openRequestSequence(request);
+    if (!primed) {
+      primed = true;
+      lastSequence = sequence;
+      logResourceOpen("open-request-baseline", {
+        requestId: request?.requestId ?? null,
+        sequence: lastSequence,
+        asset: summarizeResourceAsset(request?.asset)
+      });
+      return;
+    }
+    if (!request || sequence <= lastSequence) return;
+    lastSequence = sequence;
+    logResourceOpen("open-request-observed", {
+      requestId: request.requestId,
+      sequence: request.sequence,
+      asset: summarizeResourceAsset(request.asset),
+      hasPreview: Boolean(request.preview?.target),
+      previewTargetId: request.preview?.target?.targetId ?? null
+    });
+    onOpen(request);
+  });
+  return () => {
+    unsubscribe();
+    reader.dispose();
+  };
+}
+
+export {
+  EDITOR_ASSET_KIND,
+  TYPE_PREVIEW_KINDS,
+  summarizeResourceAsset,
+  isEditorWorkspaceAsset,
+  isTypePreviewAsset,
+  selectEditorWorkspacePreview,
+  selectWorkspaceEditorSurfaceTarget,
+  editorSceneTargetIds,
+  logResourceOpen,
+  selectWorkspaceResourceSubject,
+  selectWorkspaceResourcePreview,
+  observeWorkspaceOpenRequests
+};
+//# sourceMappingURL=chunk-FKCQYDLX.mjs.map

package/dist/modules/chunks/chunk-FKCQYDLX.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../packages/view-workspace-core/src/resource-open.mjs"],
+  "sourcesContent": ["import { createWorkspaceStateReader } from './workspace-state.mjs';\nimport { traceView } from './view-trace.mjs';\n\nconst LOG_PREFIX = '[forgeax.view.resource-open]';\n\n/** Editor viewport hosts the scene world. All other kinds are type-previews. */\nexport const EDITOR_ASSET_KIND = 'scene';\nexport const TYPE_PREVIEW_KINDS = Object.freeze(['material', 'mesh', 'texture']);\n\nexport function summarizeResourceAsset(asset) {\n  if (!asset || typeof asset !== 'object') return null;\n  return {\n    guid: typeof asset.guid === 'string' ? asset.guid : null,\n    kind: typeof asset.kind === 'string' ? asset.kind : null,\n  };\n}\n\nexport function isEditorWorkspaceAsset(asset) {\n  return asset?.kind === EDITOR_ASSET_KIND;\n}\n\nexport function isTypePreviewAsset(asset) {\n  return TYPE_PREVIEW_KINDS.includes(asset?.kind);\n}\n\n/**\n * Editor identity is the scene world, never Engine array order.\n * A pinned editor target wins even when Engine omits kind on the live preview.\n * Otherwise the unique remaining non-type-preview world is the editor.\n */\nexport function selectEditorWorkspacePreview(previews, preferredTargetId) {\n  const list = (Array.isArray(previews) ? previews : []).filter(\n    (entry) => entry?.target?.targetId != null,\n  );\n  if (preferredTargetId != null && preferredTargetId !== '') {\n    const preferred = list.find(\n      (entry) => String(entry.target.targetId) === String(preferredTargetId),\n    );\n    if (preferred && !isTypePreviewAsset(preferred.asset)) return preferred;\n  }\n  const scenes = list.filter((entry) => isEditorWorkspaceAsset(entry.asset));\n  if (scenes.length === 1) return scenes[0];\n  const editorWorlds = list.filter((entry) => !isTypePreviewAsset(entry.asset));\n  return editorWorlds.length === 1 ? editorWorlds[0] : undefined;\n}\n\n/**\n * Viewport overlay target. Dock claim can render before editorPreview is\n * classified; the bound preview is the live scene world until then.\n */\nexport function selectWorkspaceEditorSurfaceTarget(state) {\n  if (state?.editorPreview?.target) return state.editorPreview.target;\n  const preview = state?.preview;\n  if (preview?.target && !isTypePreviewAsset(preview.asset)) return preview.target;\n  return null;\n}\n\nexport function editorSceneTargetIds(previews, editorPreview) {\n  const ids = new Set();\n  const add = (entry) => {\n    if (entry?.target?.targetId == null) return;\n    ids.add(String(entry.target.targetId));\n  };\n  add(editorPreview);\n  for (const entry of Array.isArray(previews) ? previews : []) {\n    if (isEditorWorkspaceAsset(entry?.asset)) add(entry);\n  }\n  return ids;\n}\n\n/** Console breadcrumb for the asset.open \u2192 openRequest \u2192 openPage path. */\nexport function logResourceOpen(event, data = {}, { level = 'info' } = {}) {\n  const logger = typeof console === 'undefined' ? undefined : console[level];\n  if (typeof logger === 'function') logger(LOG_PREFIX, event, data);\n  try {\n    traceView('resource-open', event, data);\n  } catch {\n    // Trace dump is optional; console breadcrumbs still stand alone.\n  }\n}\n\nfunction isKind(asset, kinds) {\n  return Boolean(asset && kinds.includes(asset.kind) && typeof asset.guid === 'string' && asset.guid !== '');\n}\n\nfunction extraPreviewEntries(snapshot) {\n  const editorIds = editorSceneTargetIds(snapshot?.previews, snapshot?.editorPreview);\n  return (Array.isArray(snapshot?.previews) ? snapshot.previews : []).filter((entry) => {\n    if (!entry?.asset || entry.target?.targetId == null) return false;\n    if (isEditorWorkspaceAsset(entry.asset)) return false;\n    if (editorIds.has(String(entry.target.targetId))) return false;\n    return true;\n  });\n}\n\nfunction resourceOpenEntry(snapshot, kind) {\n  const opens = snapshot?.resourceOpens;\n  if (!opens || typeof opens !== 'object' || kind == null) return undefined;\n  return opens[kind];\n}\n\n/**\n * Each asset editor page keeps the last matching asset after later opens.\n * `openRequest` is only the most recent open, so material/mesh tabs must\n * fall back to live extras and per-kind resourceOpens.\n */\nexport function selectWorkspaceResourceSubject(snapshot, kinds) {\n  const accepted = Array.isArray(kinds) ? kinds : [];\n  if (accepted.length === 0) {\n    const asset = snapshot?.openRequest?.asset;\n    return typeof asset?.guid === 'string' && asset.guid !== '' ? asset : undefined;\n  }\n  const extras = extraPreviewEntries(snapshot);\n  const candidates = [\n    snapshot?.openRequest?.asset,\n    snapshot?.openRequest?.preview?.asset,\n    ...accepted.flatMap((kind) => [\n      resourceOpenEntry(snapshot, kind)?.asset,\n      resourceOpenEntry(snapshot, kind)?.preview?.asset,\n    ]),\n    ...[...extras].reverse().map((entry) => entry.asset),\n    snapshot?.inspection?.asset,\n  ];\n  return candidates.find((asset) => isKind(asset, accepted));\n}\n\nexport function selectWorkspaceResourcePreview(snapshot, guid) {\n  if (typeof guid !== 'string' || guid === '') return undefined;\n  // Open requests retain the last asset for each editor page. Only Engine's\n  // current preview projection proves that a target is still alive.\n  return extraPreviewEntries(snapshot).find((entry) => entry.asset.guid === guid);\n}\n\nfunction openRequestSequence(request) {\n  return request && Number.isSafeInteger(request.sequence) ? request.sequence : 0;\n}\n\n/**\n * Observe later workspace openRequest sequences once each. The first snapshot\n * only baselines a retained sequence so a reconnect does not reopen pages.\n * Fiber owners must call the returned disposer; this helper holds no domain state.\n */\nexport function observeWorkspaceOpenRequests(client, onOpen) {\n  if (typeof onOpen !== 'function') {\n    throw new TypeError('observeWorkspaceOpenRequests requires onOpen');\n  }\n  const reader = createWorkspaceStateReader(client);\n  let lastSequence = 0;\n  let primed = false;\n  const unsubscribe = reader.subscribe(() => {\n    const snapshot = reader.getSnapshot();\n    if (!snapshot) return;\n    const request = snapshot.openRequest;\n    const sequence = openRequestSequence(request);\n    if (!primed) {\n      primed = true;\n      lastSequence = sequence;\n      logResourceOpen('open-request-baseline', {\n        requestId: request?.requestId ?? null,\n        sequence: lastSequence,\n        asset: summarizeResourceAsset(request?.asset),\n      });\n      return;\n    }\n    if (!request || sequence <= lastSequence) return;\n    lastSequence = sequence;\n    logResourceOpen('open-request-observed', {\n      requestId: request.requestId,\n      sequence: request.sequence,\n      asset: summarizeResourceAsset(request.asset),\n      hasPreview: Boolean(request.preview?.target),\n      previewTargetId: request.preview?.target?.targetId ?? null,\n    });\n    onOpen(request);\n  });\n  return () => {\n    unsubscribe();\n    reader.dispose();\n  };\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/chunks/chunk-FLGC65SR.mjs

@@ -0,0 +1,10 @@
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+export {
+  __export
+};
+//# sourceMappingURL=chunk-FLGC65SR.mjs.map

package/dist/modules/chunks/chunk-FLGC65SR.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/modules/chunks/chunk-FMCACPX5.mjs

@@ -0,0 +1,289 @@
+import {
+  VIEW_WORKSPACE_TAB_ID
+} from "./chunk-32GD5LL6.mjs";
+
+// packages/view-workspace-core/src/project-session.mjs
+var KEY = "forgeax.view.project-session/1";
+var HASH = "forgeaxViewRestore";
+var PREFERENCES = ["forgeax-view-theme", "forgeax.view.locale"];
+var isLoopback = (hostname) => ["localhost", "127.0.0.1", "[::1]"].includes(hostname);
+function restoreProjectPreferences(window = globalThis) {
+  const record = readProjectSession(window);
+  for (const key of PREFERENCES) {
+    const value = record?.preferences?.[key];
+    if (typeof value === "string") {
+      try {
+        window.localStorage?.setItem(key, value);
+      } catch {
+      }
+    }
+  }
+}
+function readProjectSession(window = globalThis) {
+  try {
+    const hash = new URLSearchParams(new URL(window.location.href).hash.slice(1));
+    const raw = hash.get(HASH) ?? window.sessionStorage?.getItem(KEY) ?? "null";
+    if (raw.length > 64e3) return null;
+    const value = JSON.parse(raw);
+    if (value?.version !== 1 || typeof value.root !== "string" || !value.root.trim()) return null;
+    if (value.targetId !== void 0 && typeof value.targetId !== "string") return null;
+    if (value.resources !== void 0 && (!Array.isArray(value.resources) || value.resources.length > 32 || !value.resources.every((guid) => typeof guid === "string"))) return null;
+    const presentation = value.presentation;
+    if (presentation !== void 0 && (!presentation || typeof presentation !== "object" || Array.isArray(presentation) || presentation.pageOrder !== void 0 && (!Array.isArray(presentation.pageOrder) || !presentation.pageOrder.every((type) => typeof type === "string")) || presentation.activeType !== void 0 && typeof presentation.activeType !== "string" || presentation.layouts !== void 0 && (!presentation.layouts || typeof presentation.layouts !== "object" || Array.isArray(presentation.layouts)))) return null;
+    if (value.entry) {
+      const entry = new URL(value.entry);
+      const current = new URL(window.location.href);
+      const sameHost = entry.hostname === current.hostname || isLoopback(entry.hostname) && isLoopback(current.hostname);
+      if (!sameHost || entry.protocol !== current.protocol || !["http:", "https:"].includes(entry.protocol) || entry.username || entry.password) return null;
+    }
+    return { version: 1, root: value.root, entry: value.entry, targetId: value.targetId, preferences: value.preferences };
+  } catch {
+    return null;
+  }
+}
+function save(window, value) {
+  if (!value) return;
+  value.preferences = {};
+  for (const key of PREFERENCES) {
+    try {
+      const preference = window.localStorage?.getItem(key);
+      if (preference) value.preferences[key] = preference;
+    } catch {
+    }
+  }
+  try {
+    window.sessionStorage?.setItem(KEY, JSON.stringify(value));
+  } catch {
+  }
+}
+function projectSessionUrl(url, record) {
+  const next = new URL(url);
+  next.hash = new URLSearchParams({ [HASH]: JSON.stringify(record) }).toString();
+  return next.href;
+}
+function navigateProjectSession(snapshot, window = globalThis, record = readProjectSession(window)) {
+  const url = snapshot?.projectTarget?.url;
+  if (!url || !window.location?.assign) return;
+  if (!snapshot.project?.root) {
+    window.location.assign(url);
+    return;
+  }
+  const current = new URL(window.location.href);
+  const next = {
+    ...record,
+    version: 1,
+    root: snapshot.project.root,
+    targetId: snapshot.projectTarget.targetId,
+    entry: record?.entry ?? current.origin + current.pathname
+  };
+  save(window, next);
+  window.location.assign(projectSessionUrl(url, next));
+}
+function createProjectSession(client, { window = globalThis } = {}) {
+  let disposed = false;
+  let record = readProjectSession(window);
+  const location = window.location;
+  const url = location?.href ? new URL(location.href) : null;
+  const explicitRoot = url?.searchParams.get("project")?.trim();
+  const pageTarget = url?.searchParams.get("forgeaxWorkspaceTarget");
+  const navigation = window.performance?.getEntriesByType?.("navigation")?.[0];
+  let state = {
+    snapshot: {},
+    busy: false,
+    error: null,
+    restoring: Boolean(pageTarget ? navigation?.type === "reload" : explicitRoot || record?.root && record?.targetId)
+  };
+  let initializing = true;
+  let retryTimer;
+  let cancelDelay;
+  let reconnecting;
+  let cancelNavigation;
+  const listeners = /* @__PURE__ */ new Set();
+  const controller = new AbortController();
+  const options = { tabId: VIEW_WORKSPACE_TAB_ID, signal: controller.signal };
+  const changed = (patch) => {
+    if (disposed) return;
+    state = { ...state, ...patch };
+    for (const listener of listeners) listener(state);
+  };
+  const accept = (snapshot) => {
+    if (disposed || (snapshot.revision ?? 0) < (state.snapshot.revision ?? -1)) return;
+    changed({ snapshot });
+    const remoteTargetUrl = snapshot?.projectTarget?.url;
+    if (!pageTarget && !explicitRoot && !record?.targetId && !initializing && snapshot?.workspaceTargetLost !== true && typeof snapshot?.project?.root === "string" && snapshot.project.root.trim() !== "" && typeof remoteTargetUrl === "string" && remoteTargetUrl.trim() !== "") {
+      void Promise.resolve(navigate(snapshot)).catch(fail);
+      return;
+    }
+    if (initializing || !pageTarget || snapshot.projectTarget?.targetId !== pageTarget || !snapshot.project?.root) return;
+    record = {
+      ...record,
+      version: 1,
+      root: snapshot.project.root,
+      targetId: pageTarget
+    };
+    save(window, record);
+  };
+  const fail = (error) => changed({ busy: false, error: error instanceof Error ? error.message : String(error) });
+  const run = async (action) => {
+    if (disposed || state.busy) return;
+    changed({ busy: true, error: null, restoring: true });
+    try {
+      await action();
+    } catch (error) {
+      if (!controller.signal.aborted) fail(error);
+    } finally {
+      changed({ busy: false });
+    }
+  };
+  const navigate = (snapshot) => {
+    if (disposed) return;
+    record = {
+      ...record,
+      version: 1,
+      root: snapshot?.project?.root,
+      targetId: snapshot?.projectTarget?.targetId
+    };
+    if (!snapshot?.projectTarget?.url || !window.addEventListener) return navigateProjectSession(snapshot, window, record);
+    return new Promise((resolve) => {
+      const leave = () => {
+        window.removeEventListener("pagehide", leave);
+        cancelNavigation = void 0;
+        resolve();
+      };
+      cancelNavigation = leave;
+      window.addEventListener("pagehide", leave, { once: true });
+      try {
+        navigateProjectSession(snapshot, window, record);
+      } catch (error) {
+        leave();
+        throw error;
+      }
+    });
+  };
+  const recover = async () => {
+    const snapshot = await client.getState({ signal: controller.signal });
+    accept(snapshot);
+    const expectedTargetId = pageTarget ?? record?.targetId;
+    if (!expectedTargetId || snapshot.projectTarget?.targetId !== expectedTargetId)
+      throw new Error("The project changed in another page. Open the current View entry and choose a project explicitly.");
+    return navigate(await client.reopenProject({ ...options, expectedTargetId, expectedTargetState: "lost" }));
+  };
+  const open = (root) => run(async () => {
+    const snapshot = await client.getState({ signal: controller.signal });
+    accept(snapshot);
+    if (snapshot.project) {
+      if (snapshot.project.root !== root) throw new Error("Another project is already open. Close it explicitly before opening a different project.");
+      record = { ...record, version: 1, root, targetId: snapshot.projectTarget?.targetId };
+      await recover();
+      return;
+    }
+    record = { version: 1, root, entry: url ? url.origin + url.pathname : void 0 };
+    return navigate(await client.openProject(root, { ...options, expectedTargetId: null }));
+  });
+  const reconnect = () => run(recover);
+  const stop = client.subscribe(accept);
+  const probeEntry = async () => {
+    if (!record?.entry || disposed) return;
+    changed({ busy: true, error: null, restoring: true });
+    for (const delay of [0, 250, 500, 1e3, 2e3, 4e3]) {
+      await new Promise((resolve) => {
+        cancelDelay = resolve;
+        retryTimer = setTimeout(resolve, delay);
+      });
+      cancelDelay = void 0;
+      if (disposed) return;
+      try {
+        const response = await window.fetch(new URL("/__forgeax/view/health", record.entry), {
+          cache: "no-store",
+          signal: AbortSignal.any([controller.signal, AbortSignal.timeout(2e3)])
+        });
+        if (!response.ok) throw new Error("View entry is unavailable");
+        if (!disposed) {
+          const destination = projectSessionUrl(record.entry, record);
+          if (!window.addEventListener) location.replace(destination);
+          else await new Promise((resolve) => {
+            const leave = () => {
+              window.removeEventListener("pagehide", leave);
+              cancelNavigation = void 0;
+              resolve();
+            };
+            cancelNavigation = leave;
+            window.addEventListener("pagehide", leave, { once: true });
+            try {
+              location.replace(destination);
+            } catch (error) {
+              leave();
+              throw error;
+            }
+          });
+        }
+        return;
+      } catch (error) {
+        if (disposed) return;
+      }
+    }
+    fail(new Error("View is unavailable. Start or reconnect the backend and View, then retry."));
+  };
+  const returnToEntry = () => reconnecting ??= probeEntry().finally(() => {
+    reconnecting = void 0;
+  });
+  const disconnect = pageTarget ? client.onDisconnect?.((error) => {
+    if (/stopped|stopping|unauthorized|forbidden|incompatible/i.test(error?.message ?? "")) {
+      fail(error);
+    } else void returnToEntry();
+  }) : void 0;
+  const ready = (async () => {
+    if (!url) return;
+    if (url.hash.includes(HASH)) {
+      save(window, record);
+      url.hash = "";
+      window.history?.replaceState(null, "", url.href);
+    }
+    if (pageTarget && navigation?.type === "reload") {
+      if (!record?.entry) throw new Error("The View entry for this project session is unavailable. Open View and choose the project again.");
+      await returnToEntry();
+      return;
+    }
+    const snapshot = await client.getState({ signal: controller.signal });
+    accept(snapshot);
+    if (!pageTarget) {
+      if (explicitRoot) await open(explicitRoot);
+      else if (record?.root && record?.targetId) await reconnect();
+      return;
+    }
+  })().catch(fail).finally(() => {
+    initializing = false;
+    accept(state.snapshot);
+  });
+  return {
+    ready,
+    open,
+    reconnect,
+    reconnectHost: returnToEntry,
+    getSnapshot: () => state,
+    subscribe(listener) {
+      listeners.add(listener);
+      listener(state);
+      return () => listeners.delete(listener);
+    },
+    dispose() {
+      disposed = true;
+      controller.abort();
+      clearTimeout(retryTimer);
+      cancelDelay?.();
+      cancelNavigation?.();
+      disconnect?.();
+      stop();
+      listeners.clear();
+    }
+  };
+}
+
+export {
+  restoreProjectPreferences,
+  readProjectSession,
+  projectSessionUrl,
+  navigateProjectSession,
+  createProjectSession
+};
+//# sourceMappingURL=chunk-FMCACPX5.mjs.map

package/dist/modules/chunks/chunk-FMCACPX5.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../packages/view-workspace-core/src/project-session.mjs"],
+  "sourcesContent": ["import { VIEW_WORKSPACE_TAB_ID } from './contract.mjs';\n\nconst KEY = 'forgeax.view.project-session/1';\nconst HASH = 'forgeaxViewRestore';\nconst PREFERENCES = ['forgeax-view-theme', 'forgeax.view.locale'];\nconst isLoopback = hostname => ['localhost', '127.0.0.1', '[::1]'].includes(hostname);\n\nexport function restoreProjectPreferences(window = globalThis) {\n  const record = readProjectSession(window);\n  for (const key of PREFERENCES) {\n    const value = record?.preferences?.[key];\n    if (typeof value === 'string') {\n      try { window.localStorage?.setItem(key, value); } catch { /* Optional preference. */ }\n    }\n  }\n}\n\nexport function readProjectSession(window = globalThis) {\n  try {\n    const hash = new URLSearchParams(new URL(window.location.href).hash.slice(1));\n    const raw = hash.get(HASH) ?? window.sessionStorage?.getItem(KEY) ?? 'null';\n    if (raw.length > 64000) return null;\n    const value = JSON.parse(raw);\n    if (value?.version !== 1 || typeof value.root !== 'string' || !value.root.trim()) return null;\n    if (value.targetId !== undefined && typeof value.targetId !== 'string') return null;\n    if (value.resources !== undefined && (!Array.isArray(value.resources) ||\n        value.resources.length > 32 || !value.resources.every(guid => typeof guid === 'string'))) return null;\n    const presentation = value.presentation;\n    if (presentation !== undefined && (!presentation || typeof presentation !== 'object' || Array.isArray(presentation) ||\n        (presentation.pageOrder !== undefined && (!Array.isArray(presentation.pageOrder) ||\n          !presentation.pageOrder.every(type => typeof type === 'string'))) ||\n        (presentation.activeType !== undefined && typeof presentation.activeType !== 'string') ||\n        (presentation.layouts !== undefined && (!presentation.layouts || typeof presentation.layouts !== 'object' ||\n          Array.isArray(presentation.layouts))))) return null;\n    if (value.entry) {\n      const entry = new URL(value.entry);\n      const current = new URL(window.location.href);\n      const sameHost = entry.hostname === current.hostname || (isLoopback(entry.hostname) && isLoopback(current.hostname));\n      if (!sameHost || entry.protocol !== current.protocol ||\n          !['http:', 'https:'].includes(entry.protocol) || entry.username || entry.password) return null;\n    }\n    // Read old records without reviving their resource, camera or layout history.\n    return { version: 1, root: value.root, entry: value.entry, targetId: value.targetId, preferences: value.preferences };\n  } catch { return null; }\n}\n\nfunction save(window, value) {\n  if (!value) return;\n  value.preferences = {};\n  for (const key of PREFERENCES) {\n    try {\n      const preference = window.localStorage?.getItem(key);\n      if (preference) value.preferences[key] = preference;\n    } catch { /* Storage is optional. */ }\n  }\n  try { window.sessionStorage?.setItem(KEY, JSON.stringify(value)); } catch { /* Storage is optional. */ }\n}\n\nexport function projectSessionUrl(url, record) {\n  const next = new URL(url);\n  next.hash = new URLSearchParams({ [HASH]: JSON.stringify(record) }).toString();\n  return next.href;\n}\n\n/** Transfer the confirmed project identity across origins, never runtime history. */\nexport function navigateProjectSession(snapshot, window = globalThis, record = readProjectSession(window)) {\n  const url = snapshot?.projectTarget?.url;\n  if (!url || !window.location?.assign) return;\n  if (!snapshot.project?.root) { window.location.assign(url); return; }\n  const current = new URL(window.location.href);\n  const next = {\n    ...record, version: 1, root: snapshot.project.root,\n    targetId: snapshot.projectTarget.targetId,\n    entry: record?.entry ?? current.origin + current.pathname,\n  };\n  save(window, next);\n  window.location.assign(projectSessionUrl(url, next));\n}\n\n/** One Cordis-owned project intent/recovery projection shared by all React consumers. */\nexport function createProjectSession(client, { window = globalThis } = {}) {\n  let disposed = false;\n  let record = readProjectSession(window);\n  const location = window.location;\n  const url = location?.href ? new URL(location.href) : null;\n  const explicitRoot = url?.searchParams.get('project')?.trim();\n  const pageTarget = url?.searchParams.get('forgeaxWorkspaceTarget');\n  const navigation = window.performance?.getEntriesByType?.('navigation')?.[0];\n  let state = {\n    snapshot: {}, busy: false, error: null,\n    restoring: Boolean(pageTarget ? navigation?.type === 'reload' : explicitRoot || (record?.root && record?.targetId)),\n  };\n  let initializing = true;\n  let retryTimer;\n  let cancelDelay;\n  let reconnecting;\n  let cancelNavigation;\n  const listeners = new Set();\n  const controller = new AbortController();\n  const options = { tabId: VIEW_WORKSPACE_TAB_ID, signal: controller.signal };\n  const changed = patch => {\n    if (disposed) return;\n    state = { ...state, ...patch };\n    for (const listener of listeners) listener(state);\n  };\n  const accept = snapshot => {\n    if (disposed || (snapshot.revision ?? 0) < (state.snapshot.revision ?? -1)) return;\n    changed({ snapshot });\n    // A project opened outside this page (for example `view project open`)\n    // is adopted by an empty shell that holds no earlier target identity.\n    // Headed documents carry pageTarget and never adopt; a page remembering\n    // another target keeps its explicit conflict instead of chasing someone\n    // else's session.\n    const remoteTargetUrl = snapshot?.projectTarget?.url;\n    if (!pageTarget && !explicitRoot && !record?.targetId && !initializing\n      && snapshot?.workspaceTargetLost !== true\n      && typeof snapshot?.project?.root === 'string' && snapshot.project.root.trim() !== ''\n      && typeof remoteTargetUrl === 'string' && remoteTargetUrl.trim() !== '') {\n      void Promise.resolve(navigate(snapshot)).catch(fail);\n      return;\n    }\n    if (initializing || !pageTarget || snapshot.projectTarget?.targetId !== pageTarget || !snapshot.project?.root) return;\n    record = {\n      ...record, version: 1, root: snapshot.project.root, targetId: pageTarget,\n    };\n    save(window, record);\n  };\n  const fail = error => changed({ busy: false, error: error instanceof Error ? error.message : String(error) });\n  const run = async action => {\n    if (disposed || state.busy) return;\n    changed({ busy: true, error: null, restoring: true });\n    try { await action(); }\n    catch (error) { if (!controller.signal.aborted) fail(error); }\n    finally { changed({ busy: false }); }\n  };\n  const navigate = snapshot => {\n    if (disposed) return;\n    record = { ...record, version: 1, root: snapshot?.project?.root,\n      targetId: snapshot?.projectTarget?.targetId };\n    if (!snapshot?.projectTarget?.url || !window.addEventListener) return navigateProjectSession(snapshot, window, record);\n    // Keep this document's activation pending until the browser leaves. Starting\n    // another App here races the old project server's guarded replacement.\n    return new Promise(resolve => {\n      const leave = () => {\n        window.removeEventListener('pagehide', leave);\n        cancelNavigation = undefined;\n        resolve();\n      };\n      cancelNavigation = leave;\n      window.addEventListener('pagehide', leave, { once: true });\n      try { navigateProjectSession(snapshot, window, record); }\n      catch (error) { leave(); throw error; }\n    });\n  };\n  const recover = async () => {\n    const snapshot = await client.getState({ signal: controller.signal });\n    accept(snapshot);\n    const expectedTargetId = pageTarget ?? record?.targetId;\n    if (!expectedTargetId || snapshot.projectTarget?.targetId !== expectedTargetId)\n      throw new Error('The project changed in another page. Open the current View entry and choose a project explicitly.');\n    return navigate(await client.reopenProject({ ...options, expectedTargetId, expectedTargetState: 'lost' }));\n  };\n  const open = root => run(async () => {\n    const snapshot = await client.getState({ signal: controller.signal });\n    accept(snapshot);\n    if (snapshot.project) {\n      if (snapshot.project.root !== root) throw new Error('Another project is already open. Close it explicitly before opening a different project.');\n      record = { ...record, version: 1, root, targetId: snapshot.projectTarget?.targetId };\n      await recover();\n      return;\n    }\n    record = { version: 1, root, entry: url ? url.origin + url.pathname : undefined };\n    return navigate(await client.openProject(root, { ...options, expectedTargetId: null }));\n  });\n  const reconnect = () => run(recover);\n  const stop = client.subscribe(accept);\n  const probeEntry = async () => {\n    if (!record?.entry || disposed) return;\n    changed({ busy: true, error: null, restoring: true });\n    for (const delay of [0, 250, 500, 1000, 2000, 4000]) {\n      await new Promise(resolve => {\n        cancelDelay = resolve;\n        retryTimer = setTimeout(resolve, delay);\n      });\n      cancelDelay = undefined;\n      if (disposed) return;\n      try {\n        const response = await window.fetch(new URL('/__forgeax/view/health', record.entry), {\n          cache: 'no-store', signal: AbortSignal.any([controller.signal, AbortSignal.timeout(2000)]),\n        });\n        if (!response.ok) throw new Error('View entry is unavailable');\n        if (!disposed) {\n          const destination = projectSessionUrl(record.entry, record);\n          if (!window.addEventListener) location.replace(destination);\n          else await new Promise(resolve => {\n            const leave = () => {\n              window.removeEventListener('pagehide', leave);\n              cancelNavigation = undefined;\n              resolve();\n            };\n            cancelNavigation = leave;\n            window.addEventListener('pagehide', leave, { once: true });\n            try { location.replace(destination); }\n            catch (error) { leave(); throw error; }\n          });\n        }\n        return;\n      } catch (error) { if (disposed) return; }\n    }\n    fail(new Error('View is unavailable. Start or reconnect the backend and View, then retry.'));\n  };\n  const returnToEntry = () => reconnecting ??= probeEntry().finally(() => { reconnecting = undefined; });\n  const disconnect = pageTarget ? client.onDisconnect?.(error => {\n    if (/stopped|stopping|unauthorized|forbidden|incompatible/i.test(error?.message ?? '')) {\n      fail(error);\n    } else void returnToEntry();\n  }) : undefined;\n  const ready = (async () => {\n    if (!url) return;\n    if (url.hash.includes(HASH)) {\n      save(window, record);\n      url.hash = '';\n      window.history?.replaceState(null, '', url.href);\n    }\n    // The client uses the resident View endpoint, so closing the old project\n    // server cannot interrupt this guarded replacement. Never revive its World.\n    if (pageTarget && navigation?.type === 'reload') {\n      if (!record?.entry) throw new Error('The View entry for this project session is unavailable. Open View and choose the project again.');\n      await returnToEntry();\n      return;\n    }\n    const snapshot = await client.getState({ signal: controller.signal });\n    accept(snapshot);\n    if (!pageTarget) {\n      if (explicitRoot) await open(explicitRoot);\n      else if (record?.root && record?.targetId) await reconnect();\n      // A project remote-opened before this page loaded leaves no explicit\n      // intent and no remembered target here; the post-initialization accept\n      // below adopts its headed document.\n      return;\n    }\n  })().catch(fail).finally(() => { initializing = false; accept(state.snapshot); });\n  return {\n    ready, open, reconnect,\n    reconnectHost: returnToEntry,\n    getSnapshot: () => state,\n    subscribe(listener) { listeners.add(listener); listener(state); return () => listeners.delete(listener); },\n    dispose() {\n      disposed = true;\n      controller.abort();\n      clearTimeout(retryTimer);\n      cancelDelay?.();\n      cancelNavigation?.();\n      disconnect?.();\n      stop();\n      listeners.clear();\n    },\n  };\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/chunks/chunk-FOBRLUQV.mjs

@@ -0,0 +1,51 @@
+// packages/view-workspace-core/src/locale-bridge.mjs
+var pluginSinks = /* @__PURE__ */ new Set();
+var shellListeners = /* @__PURE__ */ new Set();
+var viewLocale = "zh";
+function notifyPlugins(locale) {
+  for (const sink of pluginSinks) {
+    try {
+      sink(locale);
+    } catch {
+    }
+  }
+}
+function notifyShell() {
+  for (const listener of shellListeners) listener();
+}
+function getViewLocale() {
+  return viewLocale;
+}
+function subscribeViewLocale(listener) {
+  if (typeof listener !== "function") {
+    throw new TypeError("subscribeViewLocale requires a listener function");
+  }
+  shellListeners.add(listener);
+  return () => shellListeners.delete(listener);
+}
+function setViewLocale(locale) {
+  if (locale !== "en" && locale !== "zh") return;
+  if (viewLocale === locale) return;
+  viewLocale = locale;
+  notifyPlugins(locale);
+  notifyShell();
+  if (typeof document !== "undefined") {
+    document.documentElement.lang = locale;
+  }
+}
+function registerViewLocaleSink(setLocale) {
+  if (typeof setLocale !== "function") {
+    throw new TypeError("registerViewLocaleSink requires a setLocale function");
+  }
+  pluginSinks.add(setLocale);
+  setLocale(viewLocale);
+  return () => pluginSinks.delete(setLocale);
+}
+
+export {
+  getViewLocale,
+  subscribeViewLocale,
+  setViewLocale,
+  registerViewLocaleSink
+};
+//# sourceMappingURL=chunk-FOBRLUQV.mjs.map

package/dist/modules/chunks/chunk-FOBRLUQV.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../packages/view-workspace-core/src/locale-bridge.mjs"],
+  "sourcesContent": ["/** @typedef {'en' | 'zh'} ViewLocale */\n\nconst pluginSinks = new Set();\nconst shellListeners = new Set();\n\n/** @type {ViewLocale} */\nlet viewLocale = 'zh';\n\nfunction notifyPlugins(locale) {\n  for (const sink of pluginSinks) {\n    try {\n      sink(locale);\n    } catch {\n      /* isolated plugin failure */\n    }\n  }\n}\n\nfunction notifyShell() {\n  for (const listener of shellListeners) listener();\n}\n\n/**\n * Active UI locale for the entire View shell (single source of truth).\n */\nexport function getViewLocale() {\n  return viewLocale;\n}\n\nexport function subscribeViewLocale(listener) {\n  if (typeof listener !== 'function') {\n    throw new TypeError('subscribeViewLocale requires a listener function');\n  }\n  shellListeners.add(listener);\n  return () => shellListeners.delete(listener);\n}\n\n/**\n * Change locale for shell React trees and every registered product-plugin i18n sink.\n */\nexport function setViewLocale(locale) {\n  if (locale !== 'en' && locale !== 'zh') return;\n  if (viewLocale === locale) return;\n  viewLocale = locale;\n  notifyPlugins(locale);\n  notifyShell();\n  if (typeof document !== 'undefined') {\n    document.documentElement.lang = locale;\n  }\n}\n\n/**\n * @param {(locale: ViewLocale) => void} setLocale\n * @returns {() => void} unregister\n */\nexport function registerViewLocaleSink(setLocale) {\n  if (typeof setLocale !== 'function') {\n    throw new TypeError('registerViewLocaleSink requires a setLocale function');\n  }\n  pluginSinks.add(setLocale);\n  setLocale(viewLocale);\n  return () => pluginSinks.delete(setLocale);\n}\n"],
+  "mappings": ";AAEA,IAAM,cAAc,oBAAI,IAAI;AAC5B,IAAM,iBAAiB,oBAAI,IAAI;AAG/B,IAAI,aAAa;AAEjB,SAAS,cAAc,QAAQ;AAC7B,aAAW,QAAQ,aAAa;AAC9B,QAAI;AACF,WAAK,MAAM;AAAA,IACb,QAAQ;AAAA,IAER;AAAA,EACF;AACF;AAEA,SAAS,cAAc;AACrB,aAAW,YAAY,eAAgB,UAAS;AAClD;AAKO,SAAS,gBAAgB;AAC9B,SAAO;AACT;AAEO,SAAS,oBAAoB,UAAU;AAC5C,MAAI,OAAO,aAAa,YAAY;AAClC,UAAM,IAAI,UAAU,kDAAkD;AAAA,EACxE;AACA,iBAAe,IAAI,QAAQ;AAC3B,SAAO,MAAM,eAAe,OAAO,QAAQ;AAC7C;AAKO,SAAS,cAAc,QAAQ;AACpC,MAAI,WAAW,QAAQ,WAAW,KAAM;AACxC,MAAI,eAAe,OAAQ;AAC3B,eAAa;AACb,gBAAc,MAAM;AACpB,cAAY;AACZ,MAAI,OAAO,aAAa,aAAa;AACnC,aAAS,gBAAgB,OAAO;AAAA,EAClC;AACF;AAMO,SAAS,uBAAuB,WAAW;AAChD,MAAI,OAAO,cAAc,YAAY;AACnC,UAAM,IAAI,UAAU,sDAAsD;AAAA,EAC5E;AACA,cAAY,IAAI,SAAS;AACzB,YAAU,UAAU;AACpB,SAAO,MAAM,YAAY,OAAO,SAAS;AAC3C;",
+  "names": []
+}

package/dist/modules/chunks/chunk-FV3DSKZB.mjs

@@ -0,0 +1,33 @@
+import {
+  createWorkspaceStateReader
+} from "./chunk-FJM6WWIY.mjs";
+
+// packages/view-workspace-core/src/page-title.mjs
+function editorPageTitleFromWorkspace(state) {
+  const asset = state && typeof state === "object" ? state.preview?.asset : void 0;
+  if (!asset || typeof asset !== "object") return void 0;
+  for (const candidate of [asset.name, asset.label]) {
+    if (typeof candidate === "string" && candidate.trim() !== "") return candidate.trim();
+  }
+  return void 0;
+}
+function createEditorPageTitleController(client) {
+  const reader = createWorkspaceStateReader(client);
+  return Object.freeze({
+    getTitle() {
+      return editorPageTitleFromWorkspace(reader.getSnapshot());
+    },
+    subscribeTitle(listener) {
+      return reader.subscribe(listener);
+    },
+    dispose() {
+      reader.dispose();
+    }
+  });
+}
+
+export {
+  editorPageTitleFromWorkspace,
+  createEditorPageTitleController
+};
+//# sourceMappingURL=chunk-FV3DSKZB.mjs.map

package/dist/modules/chunks/chunk-FV3DSKZB.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../packages/view-workspace-core/src/page-title.mjs"],
+  "sourcesContent": ["import { createWorkspaceStateReader } from './workspace-state.mjs';\n\n/**\n * Live title for the editor page. The Host workspace snapshot is the SSOT:\n * when a preview/scene is bound, the tab shows that asset's name. The page\n * type's titleKey remains the idle fallback \u2014 this helper never invents a\n * static label, so the shell stays decoupled from scene vocabulary.\n *\n * @param {unknown} state\n * @returns {string | undefined}\n */\nexport function editorPageTitleFromWorkspace(state) {\n  const asset = state && typeof state === 'object' ? state.preview?.asset : undefined;\n  if (!asset || typeof asset !== 'object') return undefined;\n  for (const candidate of [asset.name, asset.label]) {\n    if (typeof candidate === 'string' && candidate.trim() !== '') return candidate.trim();\n  }\n  return undefined;\n}\n\n/**\n * Page controller matching forgeax-interface: `getTitle()` reads now,\n * `subscribeTitle()` fires when the workspace snapshot changes. No polling,\n * and ViewerShell does not read preview.asset itself.\n *\n * @param {unknown} client\n */\nexport function createEditorPageTitleController(client) {\n  const reader = createWorkspaceStateReader(client);\n  return Object.freeze({\n    getTitle() {\n      return editorPageTitleFromWorkspace(reader.getSnapshot());\n    },\n    subscribeTitle(listener) {\n      return reader.subscribe(listener);\n    },\n    dispose() {\n      reader.dispose();\n    },\n  });\n}\n"],
+  "mappings": ";;;;;AAWO,SAAS,6BAA6B,OAAO;AAClD,QAAM,QAAQ,SAAS,OAAO,UAAU,WAAW,MAAM,SAAS,QAAQ;AAC1E,MAAI,CAAC,SAAS,OAAO,UAAU,SAAU,QAAO;AAChD,aAAW,aAAa,CAAC,MAAM,MAAM,MAAM,KAAK,GAAG;AACjD,QAAI,OAAO,cAAc,YAAY,UAAU,KAAK,MAAM,GAAI,QAAO,UAAU,KAAK;AAAA,EACtF;AACA,SAAO;AACT;AASO,SAAS,gCAAgC,QAAQ;AACtD,QAAM,SAAS,2BAA2B,MAAM;AAChD,SAAO,OAAO,OAAO;AAAA,IACnB,WAAW;AACT,aAAO,6BAA6B,OAAO,YAAY,CAAC;AAAA,IAC1D;AAAA,IACA,eAAe,UAAU;AACvB,aAAO,OAAO,UAAU,QAAQ;AAAA,IAClC;AAAA,IACA,UAAU;AACR,aAAO,QAAQ;AAAA,IACjB;AAAA,EACF,CAAC;AACH;",
+  "names": []
+}