@forgeax/view 0.2.1-beta-20260924075842

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

@@ -0,0 +1,389 @@
+import {
+  ViewWorkspaceError
+} from "./chunk-32GD5LL6.mjs";
+
+// packages/view-workspace-core/src/engine-adapter.mjs
+var VIEW_ENGINE_WORKSPACE_ADAPTER = Object.freeze({
+  openProject: "openProject({ root })",
+  closeProject: "closeProject({ project })",
+  listAssets: "assetList({ root }) | listAssets({ project })",
+  openPreview: "openPreview({ project, asset, width, height })",
+  closePreview: "preview.close()",
+  resizePreview: "preview.resize({ width, height })",
+  getCamera: "preview.getCamera()",
+  beginCamera: "preview.beginCameraInteraction({ interactionId, baseVersion, clientId })",
+  updateCamera: "preview.updateCameraDraft({ interactionId, input | camera })",
+  commitCamera: "preview.commitCamera({ interactionId, operationId, expectedVersion, camera })",
+  abortCamera: "preview.abortCamera({ interactionId, reason })",
+  capture: "preview.capture(options)",
+  assetInspect: "assetInspect({ root, subject })",
+  packInspect: "ScriptablePackAuthoringPort.inspect(sourcePath)",
+  packRebuild: "ScriptablePackAuthoringPort.rebuild(sourcePath, 'rebuild' | 'cold-cook')",
+  packGateway: "gateway.execute({ kind: 'inspect-meta' | 'rebuild' | 'cold-cook', sourcePath, requestId, expectedRevision })",
+  packTools: "ToolClient.run('asset-source.rebuild' | 'asset-source.cold-cook', args)"
+});
+var VIEW_ENGINE_ASSET_SOURCE_TOOLS = Object.freeze({
+  rebuild: "asset-source.rebuild",
+  "cold-cook": "asset-source.cold-cook"
+});
+function missing(name) {
+  throw new ViewWorkspaceError(
+    "view-engine-capability-unavailable",
+    `Engine workspace capability ${name} to be installed`,
+    "Build and install the matching Engine workspace plugin before opening a project.",
+    { capability: name }
+  );
+}
+function method(source, names, name, { optional = false } = {}) {
+  for (const candidate of names) {
+    if (typeof source?.[candidate] === "function") return source[candidate].bind(source);
+  }
+  return optional ? void 0 : () => missing(name);
+}
+function asObject(value, name) {
+  if (value === null || typeof value !== "object" || Array.isArray(value)) {
+    throw new ViewWorkspaceError(
+      "view-engine-invalid-result",
+      `Engine ${name} to return an object`,
+      "Inspect the Engine workspace plugin result contract.",
+      { capability: name }
+    );
+  }
+  return value;
+}
+function previewMethod(preview, names, name, { optional = false } = {}) {
+  for (const candidate of names) {
+    if (typeof preview?.[candidate] === "function") return preview[candidate].bind(preview);
+  }
+  return optional ? void 0 : () => missing(name);
+}
+function engineFailure(error, capability) {
+  if (error instanceof ViewWorkspaceError) throw error;
+  const payload = error !== null && typeof error === "object" ? error : { message: String(error) };
+  const message = typeof payload.message === "string" && payload.message.trim() !== "" ? payload.message : String(error);
+  const code = typeof payload.code === "string" && payload.code.length > 0 ? payload.code : "view-engine-invalid-result";
+  throw new ViewWorkspaceError(
+    code,
+    typeof payload.expected === "string" ? payload.expected : message,
+    typeof payload.hint === "string" ? payload.hint : message,
+    {
+      capability,
+      message,
+      ...typeof payload.name === "string" ? { name: payload.name } : {},
+      ...typeof payload.stack === "string" ? { stack: payload.stack } : {},
+      ...payload.detail !== null && typeof payload.detail === "object" && !Array.isArray(payload.detail) ? payload.detail : payload.detail === void 0 ? {} : { engineDetail: payload.detail },
+      ...typeof payload.actual === "string" ? { actual: payload.actual } : {}
+    }
+  );
+}
+function unwrapEngineResult(result, capability) {
+  if (Array.isArray(result)) return result;
+  if (result === void 0) return result;
+  if (result !== null && typeof result === "object") {
+    if ("ok" in result) {
+      if (result.ok === true) return result.value;
+      engineFailure(result.error ?? result, capability);
+    }
+    if (result.outcome === "succeeded") return result.result;
+    if (result.outcome === "failed") engineFailure(result.failure ?? result, capability);
+  }
+  return result;
+}
+function projectCatalogDdc(entry) {
+  if (!entry || typeof entry !== "object") return void 0;
+  if (entry.ddc !== null && typeof entry.ddc === "object" && !Array.isArray(entry.ddc)) {
+    return entry.ddc;
+  }
+  const receiptUrl = typeof entry.cookReceiptUrl === "string" ? entry.cookReceiptUrl : typeof entry.receiptUrl === "string" ? entry.receiptUrl : void 0;
+  const packageUrl = typeof entry.packageUrl === "string" ? entry.packageUrl : void 0;
+  const state = typeof entry.lifecycle === "string" ? entry.lifecycle : typeof entry.state === "string" ? entry.state : void 0;
+  if (receiptUrl === void 0 && packageUrl === void 0 && state === void 0) return void 0;
+  return {
+    ...entry.guid === void 0 ? {} : { guid: String(entry.guid) },
+    ...state === void 0 ? {} : { state },
+    ...receiptUrl === void 0 ? {} : { receiptUrl },
+    ...packageUrl === void 0 ? {} : { hint: packageUrl }
+  };
+}
+function packNamespace(source) {
+  return source?.pack ?? source?.scriptablePack ?? source?.authoring ?? source?.assetSource ?? null;
+}
+function gatewayOf(source, pack) {
+  const candidate = source?.gateway ?? pack?.gateway ?? source?.scriptablePackGateway ?? pack;
+  return typeof candidate?.execute === "function" ? candidate : null;
+}
+function toolClientOf(source) {
+  const candidate = source?.tools ?? source?.toolClient ?? source;
+  return typeof candidate?.run === "function" ? candidate : null;
+}
+function isPackTs(sourcePath) {
+  return typeof sourcePath === "string" && sourcePath.endsWith(".pack.ts");
+}
+function createEngineWorkspaceAdapter(engine) {
+  const source = engine?.workspace ?? engine;
+  const projectSource = source?.project ?? source;
+  const assetSource = source?.assets ?? source;
+  const previewSource = source?.preview ?? source;
+  const pack = packNamespace(source);
+  const gateway = gatewayOf(source, pack);
+  const tools = toolClientOf(source);
+  const openProject = method(projectSource, ["openProject", "open"], "project.open");
+  const closeProject = method(projectSource, ["closeProject", "close"], "project.close");
+  const listAssets = method(
+    assetSource,
+    ["listAssets", "list", "assetList", "asset.list"],
+    "assets.list"
+  );
+  const openPreview = method(previewSource, ["openPreview", "openAsset", "openScene", "open"], "asset.open");
+  const assetInspect = method(
+    assetSource,
+    ["assetInspect", "asset.inspect"],
+    "asset.inspect",
+    { optional: true }
+  );
+  const packInspect = method(
+    pack ?? {},
+    ["inspect", "inspectMeta"],
+    "asset-source.inspect-meta",
+    { optional: true }
+  );
+  const packPreflight = method(pack ?? {}, ["preflight"], "asset.preflight", { optional: true });
+  const packRebuild = method(pack ?? {}, ["rebuild"], "asset-source.rebuild", { optional: true });
+  async function runTool(id, args, capability) {
+    if (!tools) missing(capability);
+    return unwrapEngineResult(await tools.run(id, args), capability);
+  }
+  async function inspectPackMeta(sourcePath, requestId) {
+    if (typeof sourcePath !== "string" || sourcePath.length === 0) return void 0;
+    if (packInspect) {
+      return asObject(
+        unwrapEngineResult(await packInspect(sourcePath), "asset-source.inspect-meta"),
+        "asset-source.inspect-meta"
+      );
+    }
+    if (gateway) {
+      return asObject(
+        unwrapEngineResult(
+          await gateway.execute({
+            kind: "inspect-meta",
+            sourcePath,
+            requestId: requestId ?? "view-inspect-meta"
+          }),
+          "asset-source.inspect-meta"
+        ),
+        "asset-source.inspect-meta"
+      );
+    }
+    return void 0;
+  }
+  return Object.freeze({
+    async openProject(input) {
+      return asObject(await openProject(input), "project.open");
+    },
+    async closeProject(input) {
+      return closeProject(input);
+    },
+    async listAssets(input) {
+      const result = unwrapEngineResult(
+        await listAssets({
+          ...input,
+          root: input?.project?.root ?? input?.root
+        }),
+        "assets.list"
+      );
+      const entries = Array.isArray(result) ? result : Array.isArray(result?.entries) ? result.entries : void 0;
+      if (!Array.isArray(entries)) {
+        throw new ViewWorkspaceError(
+          "view-engine-invalid-result",
+          "Engine assets.list to return an array",
+          "Inspect the Engine asset catalog plugin result.",
+          { capability: "assets.list" }
+        );
+      }
+      return entries;
+    },
+    async openPreview(input) {
+      let rawResult;
+      try {
+        rawResult = await openPreview(input);
+      } catch (error) {
+        if (error?.code === "engine-workspace-preview-capability-unavailable" || error?.detail?.code === "engine-workspace-preview-capability-unavailable" || /workspace preview (?:does not support asset kind|only supports SceneAsset)/i.test(error?.message ?? "")) {
+          const kind = typeof error?.detail?.kind === "string" ? error.detail.kind : input.asset?.kind;
+          throw new ViewWorkspaceError(
+            "view-workspace-asset-unsupported",
+            `Engine asset.open to support asset kind ${kind}`,
+            "Use an Engine type-preview capability for this asset kind.",
+            { kind }
+          );
+        }
+        throw error;
+      }
+      const result = asObject(rawResult, "asset.open");
+      const target = asObject(result.target, "asset.open target");
+      if (typeof target.targetId !== "string" && typeof target.targetId !== "number") {
+        throw new ViewWorkspaceError(
+          "view-engine-invalid-result",
+          "Engine asset.open to return a stable target.targetId",
+          "The Engine preview target must expose its identity for API routing.",
+          { capability: "asset.open" }
+        );
+      }
+      const handle = result.handle ?? result.preview ?? result;
+      return Object.freeze({
+        ...result,
+        target: Object.freeze({ ...target, targetId: String(target.targetId) }),
+        handle
+      });
+    },
+    async closePreview(preview, input) {
+      const close = previewMethod(preview, ["close", "dispose"], "preview.close");
+      return close(input);
+    },
+    async getCamera(preview, input) {
+      const get = previewMethod(preview, ["getCamera", "cameraGet"], "camera.get");
+      return get(input);
+    },
+    async beginCamera(preview, input) {
+      const begin = previewMethod(preview, ["beginCameraInteraction", "beginCamera"], "camera.begin");
+      return begin(input);
+    },
+    async updateCamera(preview, input) {
+      const update = previewMethod(preview, ["updateCameraDraft", "updateCamera"], "camera.update");
+      return update(input);
+    },
+    async commitCamera(preview, input) {
+      const commit = previewMethod(preview, ["commitCamera", "setCamera"], "camera.commit");
+      return commit(input);
+    },
+    async abortCamera(preview, input) {
+      const abort = previewMethod(preview, ["abortCameraInteraction", "abortCamera"], "camera.abort");
+      return abort(input);
+    },
+    async capture(preview, input) {
+      const capture = previewMethod(preview, ["capture"], "preview.capture");
+      return capture(input);
+    },
+    async resizePreview(preview, input) {
+      const resize = previewMethod(preview, ["resize", "resizePreview", "setRenderSize"], "preview.resize");
+      return resize(input);
+    },
+    async inspectAsset(input) {
+      const asset = input?.asset ?? {};
+      const root = input?.project?.root ?? input?.root;
+      const subject = input?.subject ?? asset.guid;
+      let entry = asset;
+      if (assetInspect) {
+        entry = unwrapEngineResult(
+          await assetInspect({
+            ...input,
+            root,
+            subject
+          }),
+          "asset.inspect"
+        );
+        entry = asObject(entry, "asset.inspect");
+      } else if (tools) {
+        try {
+          entry = asObject(
+            unwrapEngineResult(
+              await tools.run("asset.inspect", { root, subject }),
+              "asset.inspect"
+            ),
+            "asset.inspect"
+          );
+        } catch (error) {
+          if (error?.code === "view-engine-capability-unavailable") throw error;
+          if (!asset?.guid) throw error;
+        }
+      }
+      const sourcePath = entry.sourcePath ?? asset.sourcePath;
+      const packMeta = isPackTs(sourcePath) ? await inspectPackMeta(sourcePath, input?.requestId) : void 0;
+      if (!entry?.guid && !asset?.guid) missing("asset.inspect");
+      const revision = packMeta?.revision ?? entry.revision ?? asset.revision;
+      return {
+        guid: entry.guid ?? asset.guid,
+        asset: { ...asset, ...entry },
+        ...sourcePath === void 0 ? {} : {
+          source: {
+            path: sourcePath,
+            ...isPackTs(sourcePath) ? { kind: "pack.ts" } : {},
+            ...revision === void 0 ? {} : { revision: String(revision) }
+          }
+        },
+        ...packMeta?.meta === void 0 ? {} : { meta: packMeta.meta },
+        ...revision === void 0 ? {} : { revision: String(revision) },
+        ...projectCatalogDdc({ ...asset, ...entry }) === void 0 ? {} : { ddc: projectCatalogDdc({ ...asset, ...entry }) }
+      };
+    },
+    async rebuild(input) {
+      const mode = input?.mode === "cold-cook" ? "cold-cook" : "rebuild";
+      const capability = VIEW_ENGINE_ASSET_SOURCE_TOOLS[mode];
+      const sourcePath = input?.sourcePath ?? input?.asset?.sourcePath;
+      const expectedRevision = input?.expectedRevision;
+      const requestId = input?.requestId;
+      const args = {
+        ...sourcePath === void 0 ? {} : { sourcePath },
+        ...input?.asset?.guid === void 0 ? {} : { guid: input.asset.guid, ownerGuid: input.asset.guid },
+        ...requestId === void 0 ? {} : { requestId },
+        ...expectedRevision === void 0 ? {} : { expectedRevision }
+      };
+      if (gateway && sourcePath) {
+        return asObject(
+          unwrapEngineResult(
+            await gateway.execute({
+              kind: mode,
+              sourcePath,
+              requestId: requestId ?? `view-${mode}`,
+              ...expectedRevision === void 0 ? {} : { expectedRevision }
+            }),
+            capability
+          ),
+          capability
+        );
+      }
+      if (packRebuild && sourcePath) {
+        if (packPreflight && expectedRevision !== void 0) {
+          const preflight = asObject(
+            unwrapEngineResult(await packPreflight(sourcePath), "asset.preflight"),
+            "asset.preflight"
+          );
+          if (String(preflight.revision) !== String(expectedRevision)) {
+            engineFailure(
+              {
+                code: "pack-source-revision-conflict",
+                expected: expectedRevision,
+                actual: preflight.revision,
+                hint: "inspect the current source revision, then retry the build with a new requestId",
+                detail: { sourcePath, requestId }
+              },
+              capability
+            );
+          }
+        }
+        return asObject(
+          unwrapEngineResult(await packRebuild(sourcePath, mode), capability),
+          capability
+        );
+      }
+      if (tools) {
+        return asObject(await runTool(capability, args, capability), capability);
+      }
+      missing(capability);
+    }
+  });
+}
+function isEngineWorkspaceAdapter(value) {
+  const assets = value?.assets ?? value;
+  const preview = value?.preview ?? value;
+  return Boolean(
+    value && typeof (value.openProject ?? value.open) === "function" && typeof (value.closeProject ?? value.close) === "function" && typeof (assets.listAssets ?? assets.list ?? assets.assetList ?? assets["asset.list"]) === "function" && typeof (preview.openPreview ?? preview.openAsset ?? preview.openScene ?? preview.open) === "function"
+  );
+}
+
+export {
+  VIEW_ENGINE_WORKSPACE_ADAPTER,
+  VIEW_ENGINE_ASSET_SOURCE_TOOLS,
+  createEngineWorkspaceAdapter,
+  isEngineWorkspaceAdapter
+};
+//# sourceMappingURL=chunk-FD4BAJ6K.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../packages/view-workspace-core/src/engine-adapter.mjs"],
+  "sourcesContent": ["import { ViewWorkspaceError } from './contract.mjs';\n\n/**\n * View binds the Engine public workspace / DevKit / ScriptablePack surfaces.\n * It does not invent inspectAsset, applyParams, cookAsset, or inspectDdc.\n *\n * Engine owners:\n * - catalog: `assetList` / `asset.list` / existing `listAssets` \u2192 PackEntry[]\n * - inspect: DevKit `assetInspect({ root, subject })` plus optional\n *   ScriptablePack `inspect(sourcePath)` / gateway `inspect-meta`\n * - cook: ScriptablePack `rebuild(sourcePath, mode)` / gateway\n *   `rebuild`|`cold-cook` / ToolClient `asset-source.rebuild`|`asset-source.cold-cook`\n */\nexport const VIEW_ENGINE_WORKSPACE_ADAPTER = Object.freeze({\n  openProject: 'openProject({ root })',\n  closeProject: 'closeProject({ project })',\n  listAssets: 'assetList({ root }) | listAssets({ project })',\n  openPreview: 'openPreview({ project, asset, width, height })',\n  closePreview: 'preview.close()',\n  resizePreview: 'preview.resize({ width, height })',\n  getCamera: 'preview.getCamera()',\n  beginCamera: 'preview.beginCameraInteraction({ interactionId, baseVersion, clientId })',\n  updateCamera: 'preview.updateCameraDraft({ interactionId, input | camera })',\n  commitCamera: 'preview.commitCamera({ interactionId, operationId, expectedVersion, camera })',\n  abortCamera: 'preview.abortCamera({ interactionId, reason })',\n  capture: 'preview.capture(options)',\n  assetInspect: 'assetInspect({ root, subject })',\n  packInspect: 'ScriptablePackAuthoringPort.inspect(sourcePath)',\n  packRebuild: \"ScriptablePackAuthoringPort.rebuild(sourcePath, 'rebuild' | 'cold-cook')\",\n  packGateway: \"gateway.execute({ kind: 'inspect-meta' | 'rebuild' | 'cold-cook', sourcePath, requestId, expectedRevision })\",\n  packTools: \"ToolClient.run('asset-source.rebuild' | 'asset-source.cold-cook', args)\",\n});\n\nexport const VIEW_ENGINE_ASSET_SOURCE_TOOLS = Object.freeze({\n  rebuild: 'asset-source.rebuild',\n  'cold-cook': 'asset-source.cold-cook',\n});\n\nfunction missing(name) {\n  throw new ViewWorkspaceError(\n    'view-engine-capability-unavailable',\n    `Engine workspace capability ${name} to be installed`,\n    'Build and install the matching Engine workspace plugin before opening a project.',\n    { capability: name },\n  );\n}\n\nfunction method(source, names, name, { optional = false } = {}) {\n  for (const candidate of names) {\n    if (typeof source?.[candidate] === 'function') return source[candidate].bind(source);\n  }\n  return optional ? undefined : () => missing(name);\n}\n\nfunction asObject(value, name) {\n  if (value === null || typeof value !== 'object' || Array.isArray(value)) {\n    throw new ViewWorkspaceError(\n      'view-engine-invalid-result',\n      `Engine ${name} to return an object`,\n      'Inspect the Engine workspace plugin result contract.',\n      { capability: name },\n    );\n  }\n  return value;\n}\n\nfunction previewMethod(preview, names, name, { optional = false } = {}) {\n  // Engine's public shape puts operations on the outer preview. `handle` is\n  // an opaque resource bundle and must never become a second operation\n  // surface, otherwise a client can accidentally bypass the Engine contract.\n  for (const candidate of names) {\n    if (typeof preview?.[candidate] === 'function') return preview[candidate].bind(preview);\n  }\n  return optional ? undefined : () => missing(name);\n}\n\nfunction engineFailure(error, capability) {\n  if (error instanceof ViewWorkspaceError) throw error;\n  const payload = error !== null && typeof error === 'object' ? error : { message: String(error) };\n  const message =\n    typeof payload.message === 'string' && payload.message.trim() !== ''\n      ? payload.message\n      : String(error);\n  const code =\n    typeof payload.code === 'string' && payload.code.length > 0\n      ? payload.code\n      : 'view-engine-invalid-result';\n  throw new ViewWorkspaceError(\n    code,\n    typeof payload.expected === 'string' ? payload.expected : message,\n    typeof payload.hint === 'string' ? payload.hint : message,\n    {\n      capability,\n      message,\n      ...(typeof payload.name === 'string' ? { name: payload.name } : {}),\n      ...(typeof payload.stack === 'string' ? { stack: payload.stack } : {}),\n      ...(payload.detail !== null && typeof payload.detail === 'object' && !Array.isArray(payload.detail)\n        ? payload.detail\n        : payload.detail === undefined\n          ? {}\n          : { engineDetail: payload.detail }),\n      ...(typeof payload.actual === 'string' ? { actual: payload.actual } : {}),\n    },\n  );\n}\n\nfunction unwrapEngineResult(result, capability) {\n  if (Array.isArray(result)) return result;\n  if (result === undefined) return result;\n  if (result !== null && typeof result === 'object') {\n    if ('ok' in result) {\n      if (result.ok === true) return result.value;\n      engineFailure(result.error ?? result, capability);\n    }\n    if (result.outcome === 'succeeded') return result.result;\n    if (result.outcome === 'failed') engineFailure(result.failure ?? result, capability);\n  }\n  return result;\n}\n\nfunction projectCatalogDdc(entry) {\n  if (!entry || typeof entry !== 'object') return undefined;\n  if (entry.ddc !== null && typeof entry.ddc === 'object' && !Array.isArray(entry.ddc)) {\n    return entry.ddc;\n  }\n  const receiptUrl =\n    typeof entry.cookReceiptUrl === 'string'\n      ? entry.cookReceiptUrl\n      : typeof entry.receiptUrl === 'string'\n        ? entry.receiptUrl\n        : undefined;\n  const packageUrl = typeof entry.packageUrl === 'string' ? entry.packageUrl : undefined;\n  const state =\n    typeof entry.lifecycle === 'string'\n      ? entry.lifecycle\n      : typeof entry.state === 'string'\n        ? entry.state\n        : undefined;\n  if (receiptUrl === undefined && packageUrl === undefined && state === undefined) return undefined;\n  return {\n    ...(entry.guid === undefined ? {} : { guid: String(entry.guid) }),\n    ...(state === undefined ? {} : { state }),\n    ...(receiptUrl === undefined ? {} : { receiptUrl }),\n    ...(packageUrl === undefined ? {} : { hint: packageUrl }),\n  };\n}\n\nfunction packNamespace(source) {\n  return source?.pack ?? source?.scriptablePack ?? source?.authoring ?? source?.assetSource ?? null;\n}\n\nfunction gatewayOf(source, pack) {\n  const candidate = source?.gateway ?? pack?.gateway ?? source?.scriptablePackGateway ?? pack;\n  return typeof candidate?.execute === 'function' ? candidate : null;\n}\n\nfunction toolClientOf(source) {\n  const candidate = source?.tools ?? source?.toolClient ?? source;\n  return typeof candidate?.run === 'function' ? candidate : null;\n}\n\nfunction isPackTs(sourcePath) {\n  return typeof sourcePath === 'string' && sourcePath.endsWith('.pack.ts');\n}\n\n/**\n * Normalize the Engine public workspace capability into one call surface.\n * This function only adapts naming; all project, asset, target, scene and\n * camera behavior remains in the supplied Engine implementation.\n */\nexport function createEngineWorkspaceAdapter(engine) {\n  const source = engine?.workspace ?? engine;\n  const projectSource = source?.project ?? source;\n  const assetSource = source?.assets ?? source;\n  const previewSource = source?.preview ?? source;\n  const pack = packNamespace(source);\n  const gateway = gatewayOf(source, pack);\n  const tools = toolClientOf(source);\n\n  const openProject = method(projectSource, ['openProject', 'open'], 'project.open');\n  const closeProject = method(projectSource, ['closeProject', 'close'], 'project.close');\n  const listAssets = method(\n    assetSource,\n    ['listAssets', 'list', 'assetList', 'asset.list'],\n    'assets.list',\n  );\n  const openPreview = method(previewSource, ['openPreview', 'openAsset', 'openScene', 'open'], 'asset.open');\n  const assetInspect = method(\n    assetSource,\n    ['assetInspect', 'asset.inspect'],\n    'asset.inspect',\n    { optional: true },\n  );\n  const packInspect = method(\n    pack ?? {},\n    ['inspect', 'inspectMeta'],\n    'asset-source.inspect-meta',\n    { optional: true },\n  );\n  const packPreflight = method(pack ?? {}, ['preflight'], 'asset.preflight', { optional: true });\n  const packRebuild = method(pack ?? {}, ['rebuild'], 'asset-source.rebuild', { optional: true });\n\n  async function runTool(id, args, capability) {\n    if (!tools) missing(capability);\n    return unwrapEngineResult(await tools.run(id, args), capability);\n  }\n\n  async function inspectPackMeta(sourcePath, requestId) {\n    if (typeof sourcePath !== 'string' || sourcePath.length === 0) return undefined;\n    if (packInspect) {\n      return asObject(\n        unwrapEngineResult(await packInspect(sourcePath), 'asset-source.inspect-meta'),\n        'asset-source.inspect-meta',\n      );\n    }\n    if (gateway) {\n      return asObject(\n        unwrapEngineResult(\n          await gateway.execute({\n            kind: 'inspect-meta',\n            sourcePath,\n            requestId: requestId ?? 'view-inspect-meta',\n          }),\n          'asset-source.inspect-meta',\n        ),\n        'asset-source.inspect-meta',\n      );\n    }\n    return undefined;\n  }\n\n  return Object.freeze({\n    async openProject(input) {\n      return asObject(await openProject(input), 'project.open');\n    },\n    async closeProject(input) {\n      return closeProject(input);\n    },\n    async listAssets(input) {\n      const result = unwrapEngineResult(\n        await listAssets({\n          ...input,\n          root: input?.project?.root ?? input?.root,\n        }),\n        'assets.list',\n      );\n      const entries = Array.isArray(result)\n        ? result\n        : Array.isArray(result?.entries)\n          ? result.entries\n          : undefined;\n      if (!Array.isArray(entries)) {\n        throw new ViewWorkspaceError(\n          'view-engine-invalid-result',\n          'Engine assets.list to return an array',\n          'Inspect the Engine asset catalog plugin result.',\n          { capability: 'assets.list' },\n        );\n      }\n      return entries;\n    },\n    async openPreview(input) {\n      let rawResult;\n      try {\n        rawResult = await openPreview(input);\n      } catch (error) {\n        if (\n          error?.code === 'engine-workspace-preview-capability-unavailable' ||\n          error?.detail?.code === 'engine-workspace-preview-capability-unavailable' ||\n          /workspace preview (?:does not support asset kind|only supports SceneAsset)/i.test(error?.message ?? '')\n        ) {\n          const kind =\n            typeof error?.detail?.kind === 'string' ? error.detail.kind : input.asset?.kind;\n          throw new ViewWorkspaceError(\n            'view-workspace-asset-unsupported',\n            `Engine asset.open to support asset kind ${kind}`,\n            'Use an Engine type-preview capability for this asset kind.',\n            { kind },\n          );\n        }\n        throw error;\n      }\n      const result = asObject(rawResult, 'asset.open');\n      const target = asObject(result.target, 'asset.open target');\n      if (typeof target.targetId !== 'string' && typeof target.targetId !== 'number') {\n        throw new ViewWorkspaceError(\n          'view-engine-invalid-result',\n          'Engine asset.open to return a stable target.targetId',\n          'The Engine preview target must expose its identity for API routing.',\n          { capability: 'asset.open' },\n        );\n      }\n      const handle = result.handle ?? result.preview ?? result;\n      return Object.freeze({\n        ...result,\n        target: Object.freeze({ ...target, targetId: String(target.targetId) }),\n        handle,\n      });\n    },\n    async closePreview(preview, input) {\n      const close = previewMethod(preview, ['close', 'dispose'], 'preview.close');\n      return close(input);\n    },\n    async getCamera(preview, input) {\n      const get = previewMethod(preview, ['getCamera', 'cameraGet'], 'camera.get');\n      return get(input);\n    },\n    async beginCamera(preview, input) {\n      const begin = previewMethod(preview, ['beginCameraInteraction', 'beginCamera'], 'camera.begin');\n      return begin(input);\n    },\n    async updateCamera(preview, input) {\n      const update = previewMethod(preview, ['updateCameraDraft', 'updateCamera'], 'camera.update');\n      return update(input);\n    },\n    async commitCamera(preview, input) {\n      const commit = previewMethod(preview, ['commitCamera', 'setCamera'], 'camera.commit');\n      return commit(input);\n    },\n    async abortCamera(preview, input) {\n      const abort = previewMethod(preview, ['abortCameraInteraction', 'abortCamera'], 'camera.abort');\n      return abort(input);\n    },\n    async capture(preview, input) {\n      const capture = previewMethod(preview, ['capture'], 'preview.capture');\n      return capture(input);\n    },\n    async resizePreview(preview, input) {\n      const resize = previewMethod(preview, ['resize', 'resizePreview', 'setRenderSize'], 'preview.resize');\n      return resize(input);\n    },\n    async inspectAsset(input) {\n      const asset = input?.asset ?? {};\n      const root = input?.project?.root ?? input?.root;\n      const subject = input?.subject ?? asset.guid;\n      let entry = asset;\n      if (assetInspect) {\n        entry = unwrapEngineResult(\n          await assetInspect({\n            ...input,\n            root,\n            subject,\n          }),\n          'asset.inspect',\n        );\n        entry = asObject(entry, 'asset.inspect');\n      } else if (tools) {\n        try {\n          entry = asObject(\n            unwrapEngineResult(\n              await tools.run('asset.inspect', { root, subject }),\n              'asset.inspect',\n            ),\n            'asset.inspect',\n          );\n        } catch (error) {\n          if (error?.code === 'view-engine-capability-unavailable') throw error;\n          if (!asset?.guid) throw error;\n        }\n      }\n      const sourcePath = entry.sourcePath ?? asset.sourcePath;\n      const packMeta = isPackTs(sourcePath) ? await inspectPackMeta(sourcePath, input?.requestId) : undefined;\n      if (!entry?.guid && !asset?.guid) missing('asset.inspect');\n      const revision = packMeta?.revision ?? entry.revision ?? asset.revision;\n      return {\n        guid: entry.guid ?? asset.guid,\n        asset: { ...asset, ...entry },\n        ...(sourcePath === undefined\n          ? {}\n          : {\n              source: {\n                path: sourcePath,\n                ...(isPackTs(sourcePath) ? { kind: 'pack.ts' } : {}),\n                ...(revision === undefined ? {} : { revision: String(revision) }),\n              },\n            }),\n        ...(packMeta?.meta === undefined ? {} : { meta: packMeta.meta }),\n        ...(revision === undefined ? {} : { revision: String(revision) }),\n        ...(projectCatalogDdc({ ...asset, ...entry }) === undefined\n          ? {}\n          : { ddc: projectCatalogDdc({ ...asset, ...entry }) }),\n      };\n    },\n    async rebuild(input) {\n      const mode = input?.mode === 'cold-cook' ? 'cold-cook' : 'rebuild';\n      const capability = VIEW_ENGINE_ASSET_SOURCE_TOOLS[mode];\n      const sourcePath = input?.sourcePath ?? input?.asset?.sourcePath;\n      const expectedRevision = input?.expectedRevision;\n      const requestId = input?.requestId;\n      const args = {\n        ...(sourcePath === undefined ? {} : { sourcePath }),\n        ...(input?.asset?.guid === undefined ? {} : { guid: input.asset.guid, ownerGuid: input.asset.guid }),\n        ...(requestId === undefined ? {} : { requestId }),\n        ...(expectedRevision === undefined ? {} : { expectedRevision }),\n      };\n\n      if (gateway && sourcePath) {\n        return asObject(\n          unwrapEngineResult(\n            await gateway.execute({\n              kind: mode,\n              sourcePath,\n              requestId: requestId ?? `view-${mode}`,\n              ...(expectedRevision === undefined ? {} : { expectedRevision }),\n            }),\n            capability,\n          ),\n          capability,\n        );\n      }\n\n      if (packRebuild && sourcePath) {\n        if (packPreflight && expectedRevision !== undefined) {\n          const preflight = asObject(\n            unwrapEngineResult(await packPreflight(sourcePath), 'asset.preflight'),\n            'asset.preflight',\n          );\n          if (String(preflight.revision) !== String(expectedRevision)) {\n            engineFailure(\n              {\n                code: 'pack-source-revision-conflict',\n                expected: expectedRevision,\n                actual: preflight.revision,\n                hint: 'inspect the current source revision, then retry the build with a new requestId',\n                detail: { sourcePath, requestId },\n              },\n              capability,\n            );\n          }\n        }\n        return asObject(\n          unwrapEngineResult(await packRebuild(sourcePath, mode), capability),\n          capability,\n        );\n      }\n\n      if (tools) {\n        return asObject(await runTool(capability, args, capability), capability);\n      }\n      missing(capability);\n    },\n  });\n}\n\nexport function isEngineWorkspaceAdapter(value) {\n  const assets = value?.assets ?? value;\n  const preview = value?.preview ?? value;\n  return Boolean(\n    value &&\n      typeof (value.openProject ?? value.open) === 'function' &&\n      typeof (value.closeProject ?? value.close) === 'function' &&\n      typeof (\n        assets.listAssets ??\n        assets.list ??\n        assets.assetList ??\n        assets['asset.list']\n      ) === 'function' &&\n      typeof (\n        preview.openPreview ??\n        preview.openAsset ??\n        preview.openScene ??\n        preview.open\n      ) === 'function',\n  );\n}\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,80 @@
+import {
+  workspaceUiFingerprint
+} from "./chunk-32GD5LL6.mjs";
+
+// packages/view-workspace-core/src/workspace-state.mjs
+function createWorkspaceObservation(reader, isCurrent) {
+  const controller = new AbortController();
+  let unsubscribe;
+  const dispose = () => {
+    controller.abort();
+    unsubscribe?.();
+    unsubscribe = void 0;
+  };
+  const check = () => {
+    if (!isCurrent(reader.getSnapshot())) dispose();
+  };
+  unsubscribe = reader.subscribe(check);
+  if (controller.signal.aborted) dispose();
+  else check();
+  return { signal: controller.signal, dispose };
+}
+function createWorkspaceStateReader(client) {
+  if (!client || typeof client.subscribe !== "function") {
+    return { getSnapshot: () => null, subscribe: () => () => {
+    }, dispose() {
+    } };
+  }
+  let snapshot = null;
+  let published = null;
+  let publishedFingerprint = "";
+  const listeners = /* @__PURE__ */ new Set();
+  let transportUnsubscribe;
+  let generation = 0;
+  const stop = () => {
+    generation++;
+    transportUnsubscribe?.();
+    transportUnsubscribe = void 0;
+  };
+  const start = () => {
+    const current = ++generation;
+    const accept = (next) => {
+      if (current !== generation || !next) return;
+      if (snapshot !== null && (next.revision ?? 0) < (snapshot.revision ?? 0)) return;
+      snapshot = next;
+      const fingerprint = workspaceUiFingerprint(next);
+      if (fingerprint === publishedFingerprint) return;
+      publishedFingerprint = fingerprint;
+      published = next;
+      for (const listener of listeners) listener();
+    };
+    transportUnsubscribe = client.subscribe(accept) ?? (() => {
+    });
+    void client.getState?.().then(accept).catch(() => {
+    });
+  };
+  return {
+    getSnapshot: () => published,
+    subscribe(listener) {
+      listeners.add(listener);
+      if (listeners.size === 1) start();
+      return () => {
+        if (!listeners.delete(listener)) return;
+        if (listeners.size === 0) stop();
+      };
+    },
+    dispose() {
+      stop();
+      listeners.clear();
+      snapshot = null;
+      published = null;
+      publishedFingerprint = "";
+    }
+  };
+}
+
+export {
+  createWorkspaceObservation,
+  createWorkspaceStateReader
+};
+//# sourceMappingURL=chunk-FJM6WWIY.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../packages/view-workspace-core/src/workspace-state.mjs"],
+  "sourcesContent": ["import { workspaceUiFingerprint } from './contract.mjs';\n\n/** Cancel a panel's reads at state publication, without waiting for React cleanup. */\nexport function createWorkspaceObservation(reader, isCurrent) {\n  const controller = new AbortController();\n  let unsubscribe;\n  const dispose = () => {\n    controller.abort();\n    unsubscribe?.();\n    unsubscribe = undefined;\n  };\n  const check = () => {\n    if (!isCurrent(reader.getSnapshot())) dispose();\n  };\n  unsubscribe = reader.subscribe(check);\n  // subscribe may synchronously publish, before its disposer has been assigned.\n  if (controller.signal.aborted) dispose();\n  else check();\n  return { signal: controller.signal, dispose };\n}\n\n/** A subscription owns its transport lease; snapshots remain Engine/View API results. */\nexport function createWorkspaceStateReader(client) {\n  if (!client || typeof client.subscribe !== 'function') {\n    return { getSnapshot: () => null, subscribe: () => () => {}, dispose() {} };\n  }\n  let snapshot = null;\n  let published = null;\n  let publishedFingerprint = '';\n  const listeners = new Set();\n  let transportUnsubscribe;\n  let generation = 0;\n  const stop = () => {\n    generation++;\n    transportUnsubscribe?.();\n    transportUnsubscribe = undefined;\n  };\n  const start = () => {\n    const current = ++generation;\n    const accept = next => {\n      if (current !== generation || !next) return;\n      if (snapshot !== null && (next.revision ?? 0) < (snapshot.revision ?? 0)) return;\n      snapshot = next;\n      const fingerprint = workspaceUiFingerprint(next);\n      if (fingerprint === publishedFingerprint) return;\n      publishedFingerprint = fingerprint;\n      published = next;\n      for (const listener of listeners) listener();\n    };\n    transportUnsubscribe = client.subscribe(accept) ?? (() => {});\n    void client.getState?.().then(accept).catch(() => {});\n  };\n  return {\n    getSnapshot: () => published,\n    subscribe(listener) {\n      listeners.add(listener);\n      if (listeners.size === 1) start();\n      return () => {\n        if (!listeners.delete(listener)) return;\n        if (listeners.size === 0) stop();\n      };\n    },\n    dispose() { stop(); listeners.clear(); snapshot = null; published = null; publishedFingerprint = ''; },\n  };\n}\n"],
+  "mappings": ";;;;;AAGO,SAAS,2BAA2B,QAAQ,WAAW;AAC5D,QAAM,aAAa,IAAI,gBAAgB;AACvC,MAAI;AACJ,QAAM,UAAU,MAAM;AACpB,eAAW,MAAM;AACjB,kBAAc;AACd,kBAAc;AAAA,EAChB;AACA,QAAM,QAAQ,MAAM;AAClB,QAAI,CAAC,UAAU,OAAO,YAAY,CAAC,EAAG,SAAQ;AAAA,EAChD;AACA,gBAAc,OAAO,UAAU,KAAK;AAEpC,MAAI,WAAW,OAAO,QAAS,SAAQ;AAAA,MAClC,OAAM;AACX,SAAO,EAAE,QAAQ,WAAW,QAAQ,QAAQ;AAC9C;AAGO,SAAS,2BAA2B,QAAQ;AACjD,MAAI,CAAC,UAAU,OAAO,OAAO,cAAc,YAAY;AACrD,WAAO,EAAE,aAAa,MAAM,MAAM,WAAW,MAAM,MAAM;AAAA,IAAC,GAAG,UAAU;AAAA,IAAC,EAAE;AAAA,EAC5E;AACA,MAAI,WAAW;AACf,MAAI,YAAY;AAChB,MAAI,uBAAuB;AAC3B,QAAM,YAAY,oBAAI,IAAI;AAC1B,MAAI;AACJ,MAAI,aAAa;AACjB,QAAM,OAAO,MAAM;AACjB;AACA,2BAAuB;AACvB,2BAAuB;AAAA,EACzB;AACA,QAAM,QAAQ,MAAM;AAClB,UAAM,UAAU,EAAE;AAClB,UAAM,SAAS,UAAQ;AACrB,UAAI,YAAY,cAAc,CAAC,KAAM;AACrC,UAAI,aAAa,SAAS,KAAK,YAAY,MAAM,SAAS,YAAY,GAAI;AAC1E,iBAAW;AACX,YAAM,cAAc,uBAAuB,IAAI;AAC/C,UAAI,gBAAgB,qBAAsB;AAC1C,6BAAuB;AACvB,kBAAY;AACZ,iBAAW,YAAY,UAAW,UAAS;AAAA,IAC7C;AACA,2BAAuB,OAAO,UAAU,MAAM,MAAM,MAAM;AAAA,IAAC;AAC3D,SAAK,OAAO,WAAW,EAAE,KAAK,MAAM,EAAE,MAAM,MAAM;AAAA,IAAC,CAAC;AAAA,EACtD;AACA,SAAO;AAAA,IACL,aAAa,MAAM;AAAA,IACnB,UAAU,UAAU;AAClB,gBAAU,IAAI,QAAQ;AACtB,UAAI,UAAU,SAAS,EAAG,OAAM;AAChC,aAAO,MAAM;AACX,YAAI,CAAC,UAAU,OAAO,QAAQ,EAAG;AACjC,YAAI,UAAU,SAAS,EAAG,MAAK;AAAA,MACjC;AAAA,IACF;AAAA,IACA,UAAU;AAAE,WAAK;AAAG,gBAAU,MAAM;AAAG,iBAAW;AAAM,kBAAY;AAAM,6BAAuB;AAAA,IAAI;AAAA,EACvG;AACF;",
+  "names": []
+}