@forgeax/view 0.2.1-beta-20260924075842

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

@@ -0,0 +1,158 @@
+import {
+  ViewResourceBroker
+} from "./chunk-XUYFV23R.mjs";
+import {
+  createDisplayApiTools,
+  runViewToolApi
+} from "./chunk-JHOURMYW.mjs";
+import {
+  BACKEND_MODULE,
+  BACKEND_PLUGIN_ID,
+  VIEW_STATUS_SERVICE,
+  VIEW_STATUS_TOPIC
+} from "./chunk-KNBAYU5I.mjs";
+import {
+  createViewCarrierAdapter
+} from "./chunk-CUH2G6UF.mjs";
+
+// packages/view-plugin-display/src/backend.mjs
+import { registerTools } from "@forgeax/engine-plugin";
+function bindPlatform(platform) {
+  return {
+    createPage: platform.createPage.bind(platform),
+    ...typeof platform.getCapabilities === "function" ? { getCapabilities: platform.getCapabilities.bind(platform) } : {},
+    ...typeof platform.dispose === "function" ? { dispose: platform.dispose.bind(platform) } : {}
+  };
+}
+var viewDisplayBackendPlugin = {
+  name: BACKEND_PLUGIN_ID,
+  inject: ["viewWorkspaceCore"],
+  provide: ["viewCapabilities", "viewStatus"],
+  async apply(ctx, config = {}) {
+    if (!config.platform) return installRunObserver(ctx);
+    const broker = new ViewResourceBroker({
+      platform: bindPlatform(config.platform),
+      capabilities: config.capabilities
+    });
+    const carrier = createViewCarrierAdapter({
+      broker,
+      attachTarget(target) {
+        const page = broker.getPage(target);
+        return {
+          page,
+          execution: broker.getExecution(target),
+          close: (reason = "engine-release") => broker.release(target, reason)
+        };
+      }
+    });
+    const status = () => broker.handshake();
+    const transport = ctx.get?.("hostTransport", false);
+    const unsubscribeStatus = broker.subscribe((snapshot) => {
+      transport?.publish?.(VIEW_STATUS_TOPIC, snapshot);
+    });
+    const toolApi = ctx.get?.("toolApi", false);
+    const workspace = ctx.get("viewWorkspaceCore");
+    const statusTools = toolApi ? createDisplayApiTools(broker, workspace) : void 0;
+    const statusProviderId = `view-display-status:${String(ctx.fiber.uid)}`;
+    let statusOwner;
+    if (toolApi && statusTools) {
+      ctx.effect(() => registerTools(ctx, statusTools, {
+        providerId: statusProviderId,
+        sourceId: "view-backend",
+        module: BACKEND_MODULE,
+        realm: "host"
+      }));
+      statusOwner = toolApi.describe(statusTools[0]?.descriptor.id, "view-backend")[0]?.owner;
+    }
+    const unregisterStatus = transport?.register?.(
+      VIEW_STATUS_SERVICE,
+      ({ payload, signal, caller }) => statusOwner === void 0 ? broker.handshake() : runViewToolApi(toolApi, {
+        operation: statusTools[0].descriptor.id,
+        args: payload ?? {},
+        signal,
+        caller,
+        providerId: statusOwner.providerId,
+        generation: statusOwner.generation
+      })
+    );
+    ctx.provide("viewBroker", broker);
+    ctx.provide("viewCarrier", carrier);
+    ctx.provide("viewCapabilities", broker.capabilities);
+    ctx.provide("viewStatus", status);
+    ctx.effect(() => async () => {
+      await broker.dispose();
+      unregisterStatus?.();
+      unsubscribeStatus();
+    });
+  }
+};
+var backend_default = viewDisplayBackendPlugin;
+async function installRunObserver(ctx) {
+  const transport = ctx.get("hostTransport");
+  const api = ctx.get("toolApi");
+  let binding = null;
+  let snapshot = { status: "idle", binding, observation: null };
+  let disposed = false;
+  let timer;
+  let controller = new AbortController();
+  const refresh = async () => {
+    const selected = binding;
+    const signal = controller.signal;
+    if (disposed || !selected || signal.aborted) return;
+    try {
+      const owner = api.describe("engine.run.observe", "engine-workspace").find((record) => record.callable)?.owner;
+      if (!owner) throw new Error("Engine run observation is unavailable.");
+      else {
+        const terminal = await api.run("engine.run.observe", { root: selected.root }, {
+          sourceId: "engine-workspace",
+          providerId: owner.providerId,
+          generation: owner.generation,
+          signal
+        }).terminal;
+        if (disposed || signal.aborted || binding !== selected) return;
+        if (terminal.outcome === "failed") throw new Error(terminal.failure.hint);
+        const observation = terminal.result;
+        snapshot = observation.status?.runId === selected.runId ? { status: observation.status?.phase === "ready" ? "running" : observation.status?.phase ?? "idle", binding, observation } : { status: "unavailable", binding, observation: null, error: "The bound run is no longer active. Bind the new run explicitly." };
+      }
+    } catch (error) {
+      if (!signal.aborted && binding === selected) snapshot = { status: "unavailable", binding, observation: null, error: String(error) };
+    } finally {
+      if (!disposed && !signal.aborted && binding === selected) {
+        transport.publish(VIEW_STATUS_TOPIC, snapshot);
+        timer = setTimeout(refresh, 1e3);
+        timer.unref?.();
+      }
+    }
+  };
+  const status = () => snapshot;
+  const unregister = transport.register(VIEW_STATUS_SERVICE, status);
+  const tools = createDisplayApiTools({ handshake: status, bind({ root, runId }) {
+    controller.abort();
+    clearTimeout(timer);
+    controller = new AbortController();
+    binding = root === null ? null : { root: root.trim(), runId: runId.trim() };
+    snapshot = { status: binding ? "connecting" : "idle", binding, observation: null };
+    transport.publish(VIEW_STATUS_TOPIC, snapshot);
+    void refresh();
+    return snapshot;
+  } });
+  ctx.effect(() => registerTools(ctx, tools, {
+    providerId: `view-observer:${ctx.fiber.uid}`,
+    sourceId: "view-backend",
+    realm: "host",
+    module: BACKEND_MODULE
+  }));
+  ctx.provide("viewStatus", status);
+  ctx.provide("viewCapabilities", { ready: true, supportsPage: false });
+  ctx.effect(() => () => {
+    disposed = true;
+    controller.abort();
+    clearTimeout(timer);
+    unregister();
+  });
+}
+
+export {
+  backend_default
+};
+//# sourceMappingURL=chunk-L45W6KM6.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../packages/view-plugin-display/src/backend.mjs"],
+  "sourcesContent": ["import { registerTools } from '@forgeax/engine-plugin';\nimport { ViewResourceBroker } from './page-broker.mjs';\nimport { createViewCarrierAdapter } from './carrier-adapter.mjs';\nimport { runViewToolApi } from './tool-runtime.mjs';\nimport {\n  BACKEND_PLUGIN_ID,\n  BACKEND_MODULE,\n  VIEW_STATUS_SERVICE,\n  VIEW_STATUS_TOPIC,\n} from './identity.mjs';\nimport { createDisplayApiTools } from './api.mjs';\n\nfunction bindPlatform(platform) {\n  return {\n    createPage: platform.createPage.bind(platform),\n    ...(typeof platform.getCapabilities === 'function'\n      ? { getCapabilities: platform.getCapabilities.bind(platform) }\n      : {}),\n    ...(typeof platform.dispose === 'function' ? { dispose: platform.dispose.bind(platform) } : {}),\n  };\n}\n\nconst viewDisplayBackendPlugin = {\n  name: BACKEND_PLUGIN_ID,\n  inject: ['viewWorkspaceCore'],\n  provide: ['viewCapabilities', 'viewStatus'],\n  async apply(ctx, config = {}) {\n    if (!config.platform) return installRunObserver(ctx);\n    const broker = new ViewResourceBroker({\n      platform: bindPlatform(config.platform),\n      capabilities: config.capabilities,\n    });\n    const carrier = createViewCarrierAdapter({\n      broker,\n      attachTarget(target) {\n        const page = broker.getPage(target);\n        return {\n          page,\n          execution: broker.getExecution(target),\n          close: (reason = 'engine-release') => broker.release(target, reason),\n        };\n      },\n    });\n    const status = () => broker.handshake();\n    const transport = ctx.get?.('hostTransport', false);\n    const unsubscribeStatus = broker.subscribe((snapshot) => {\n      transport?.publish?.(VIEW_STATUS_TOPIC, snapshot);\n    });\n    const toolApi = ctx.get?.('toolApi', false);\n    const workspace = ctx.get('viewWorkspaceCore');\n    const statusTools = toolApi ? createDisplayApiTools(broker, workspace) : undefined;\n    const statusProviderId = `view-display-status:${String(ctx.fiber.uid)}`;\n    let statusOwner;\n    if (toolApi && statusTools) {\n      ctx.effect(() => registerTools(ctx, statusTools, {\n        providerId: statusProviderId,\n        sourceId: 'view-backend',\n        module: BACKEND_MODULE,\n        realm: 'host',\n      }));\n      statusOwner = toolApi.describe(statusTools[0]?.descriptor.id, 'view-backend')[0]?.owner;\n    }\n    const unregisterStatus = transport?.register?.(VIEW_STATUS_SERVICE, ({ payload, signal, caller }) =>\n      statusOwner === undefined\n        ? broker.handshake()\n        : runViewToolApi(toolApi, {\n            operation: statusTools[0].descriptor.id,\n            args: payload ?? {},\n            signal,\n            caller,\n            providerId: statusOwner.providerId,\n            generation: statusOwner.generation,\n          }),\n    );\n    ctx.provide('viewBroker', broker);\n    ctx.provide('viewCarrier', carrier);\n    ctx.provide('viewCapabilities', broker.capabilities);\n    ctx.provide('viewStatus', status);\n    ctx.effect(() => async () => {\n      await broker.dispose();\n      unregisterStatus?.();\n      unsubscribeStatus();\n    });\n  },\n};\n\nexport default viewDisplayBackendPlugin;\n\n/** Observe cached Engine output; this plugin never owns or drives a run. */\nasync function installRunObserver(ctx) {\n  const transport = ctx.get('hostTransport');\n  const api = ctx.get('toolApi');\n  let binding = null;\n  let snapshot = { status: 'idle', binding, observation: null };\n  let disposed = false;\n  let timer;\n  let controller = new AbortController();\n  const refresh = async () => {\n    const selected = binding;\n    const signal = controller.signal;\n    if (disposed || !selected || signal.aborted) return;\n    try {\n      const owner = api.describe('engine.run.observe', 'engine-workspace').find(record => record.callable)?.owner;\n      if (!owner) throw new Error('Engine run observation is unavailable.');\n      else {\n        const terminal = await api.run('engine.run.observe', { root: selected.root }, {\n          sourceId: 'engine-workspace', providerId: owner.providerId, generation: owner.generation, signal,\n        }).terminal;\n        if (disposed || signal.aborted || binding !== selected) return;\n        if (terminal.outcome === 'failed') throw new Error(terminal.failure.hint);\n        const observation = terminal.result;\n        snapshot = observation.status?.runId === selected.runId\n          ? { status: observation.status?.phase === 'ready' ? 'running' : observation.status?.phase ?? 'idle', binding, observation }\n          : { status: 'unavailable', binding, observation: null, error: 'The bound run is no longer active. Bind the new run explicitly.' };\n      }\n    } catch (error) {\n      if (!signal.aborted && binding === selected) snapshot = { status: 'unavailable', binding, observation: null, error: String(error) };\n    } finally {\n      if (!disposed && !signal.aborted && binding === selected) {\n        transport.publish(VIEW_STATUS_TOPIC, snapshot);\n        timer = setTimeout(refresh, 1000);\n        timer.unref?.();\n      }\n    }\n  };\n  const status = () => snapshot;\n  const unregister = transport.register(VIEW_STATUS_SERVICE, status);\n  const tools = createDisplayApiTools({ handshake: status, bind({ root, runId }) {\n    controller.abort();\n    clearTimeout(timer);\n    controller = new AbortController();\n    binding = root === null ? null : { root: root.trim(), runId: runId.trim() };\n    snapshot = { status: binding ? 'connecting' : 'idle', binding, observation: null };\n    transport.publish(VIEW_STATUS_TOPIC, snapshot);\n    void refresh();\n    return snapshot;\n  } });\n  ctx.effect(() => registerTools(ctx, tools, {\n    providerId: `view-observer:${ctx.fiber.uid}`, sourceId: 'view-backend', realm: 'host',\n    module: BACKEND_MODULE,\n  }));\n  ctx.provide('viewStatus', status);\n  ctx.provide('viewCapabilities', { ready: true, supportsPage: false });\n  ctx.effect(() => () => {\n    disposed = true;\n    controller.abort();\n    clearTimeout(timer);\n    unregister();\n  });\n}\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,239 @@
+import {
+  attachPreviewRenderResizeSync
+} from "./chunk-ALT7XVMQ.mjs";
+import {
+  keepSurfaceInContainer,
+  placeSurface,
+  watchUntilReady
+} from "./chunk-C7R3YRA7.mjs";
+import {
+  logResourceOpen
+} from "./chunk-FKCQYDLX.mjs";
+
+// packages/view-workspace-core/src/preview-surface.mjs
+var OWNER_PLACEMENT = "owner";
+var containerOwners = /* @__PURE__ */ new WeakMap();
+function previewSurfaceError(code, expected, hint) {
+  return Object.freeze({
+    ok: false,
+    error: Object.freeze({ code, expected, hint })
+  });
+}
+function placementOf(presentation) {
+  return presentation?.surfacePlacement === OWNER_PLACEMENT ? OWNER_PLACEMENT : "shell";
+}
+function isCanvasNode(node) {
+  return node?.tagName?.toLowerCase?.() === "canvas";
+}
+function isPanelContainer(node) {
+  if (!node || typeof node !== "object" || isCanvasNode(node)) return false;
+  return typeof node.replaceChildren === "function" || typeof node.append === "function";
+}
+function surfaceCanvas(surface) {
+  if (isCanvasNode(surface)) return surface;
+  return typeof surface?.querySelector === "function" ? surface.querySelector("canvas") : null;
+}
+function isEditorOwnerSurface(surface, container, { target, editorTargetId } = {}) {
+  if (surface?.id === "app-shell" || surface?.id === "app") return true;
+  if (editorTargetId != null && target?.targetId != null && String(editorTargetId) === String(target.targetId)) {
+    return true;
+  }
+  const marker = surface?.dataset?.forgeaxViewSurface;
+  if (marker === "engine-canvas" || marker === "engine-target") return true;
+  if (typeof surface?.closest !== "function") return false;
+  const viewport = surface.closest('[data-forgeax-view-mount-host="viewport"]');
+  if (!viewport) return false;
+  if (container === viewport || container?.contains?.(viewport)) return false;
+  return true;
+}
+function adoptSurface(container, surface) {
+  placeSurface(container, surface, { replace: true });
+}
+function fillPresentationSurface(surface) {
+  if (!surface?.style) return;
+  Object.assign(surface.style, {
+    width: "100%",
+    height: "100%",
+    maxWidth: "100%",
+    maxHeight: "100%",
+    transform: "none",
+    position: "relative",
+    overflow: "hidden",
+    flex: "1 1 auto",
+    minWidth: "0",
+    minHeight: "0",
+    display: "block"
+  });
+}
+function dedicatedPreviewPresentation(presentation, owner) {
+  if (!presentation || typeof presentation !== "object") return void 0;
+  return {
+    get surfacePlacement() {
+      return presentation.surfacePlacement;
+    },
+    get owner() {
+      return owner ?? presentation.owner;
+    },
+    createSurface(input) {
+      return presentation.createSurface?.(input);
+    },
+    attach(input = {}) {
+      return presentation.attach?.({ ...input, owner });
+    },
+    detach(input) {
+      return presentation.detach?.(input);
+    }
+  };
+}
+function bindWorkspacePreviewSurface({
+  presentation,
+  target,
+  container,
+  canvas,
+  owner,
+  editorTargetId,
+  api
+} = {}) {
+  if (canvas !== void 0 || isCanvasNode(container)) {
+    throw new TypeError("bindWorkspacePreviewSurface requires a panel-owned container, not a canvas");
+  }
+  if (!isPanelContainer(container)) {
+    throw new TypeError("bindWorkspacePreviewSurface requires a panel-owned container");
+  }
+  if (!target || typeof target.targetId !== "string" && typeof target.targetId !== "number") {
+    return previewSurfaceError(
+      "view-preview-target-unavailable",
+      "an Engine preview target identity",
+      "Open the asset through Engine asset.open before attaching a preview surface."
+    );
+  }
+  if (placementOf(presentation) === OWNER_PLACEMENT) {
+    return previewSurfaceError(
+      "view-preview-surface-unavailable",
+      "a shell-placed Engine preview surface dedicated to this panel",
+      "The Engine owner surface stays on the Editor viewport; asset preview cannot relocate that iframe."
+    );
+  }
+  if (!presentation || typeof presentation.createSurface !== "function") {
+    return previewSurfaceError(
+      "view-preview-surface-unavailable",
+      "an Engine presentation that can create a type-preview surface",
+      "The asset tab hosts a DOM container; Engine createSurface places the live canvas into it."
+    );
+  }
+  const surfaceOwner = owner ?? presentation.owner;
+  if (!surfaceOwner?.panelId || !surfaceOwner?.pageType) {
+    return previewSurfaceError(
+      "view-preview-owner-unavailable",
+      "a stable asset preview panel owner",
+      "Bind the preview through its PageType panel contribution."
+    );
+  }
+  const claimedBy = containerOwners.get(container);
+  if (claimedBy !== void 0 && claimedBy !== surfaceOwner) {
+    return previewSurfaceError(
+      "view-preview-canvas-owned",
+      "a container used by exactly one asset preview panel",
+      "Create a new container for this asset preview panel."
+    );
+  }
+  const missingSurface = () => previewSurfaceError(
+    "view-preview-surface-unavailable",
+    "an Engine type-preview surface for this target",
+    "Engine must expose a type-preview surface via createSurface; the tab does not create a canvas."
+  );
+  const refuseEditor = () => previewSurfaceError(
+    "view-preview-surface-unavailable",
+    "a shell-placed Engine preview surface dedicated to this panel",
+    "The Engine owner surface stays on the Editor viewport; asset preview cannot relocate that iframe."
+  );
+  const resolveSurface = () => {
+    const surface = presentation.createSurface({
+      target,
+      document: container.ownerDocument
+    });
+    return surface && typeof surface === "object" ? surface : null;
+  };
+  const installSurface = (surface) => {
+    containerOwners.set(container, surfaceOwner);
+    container.dataset.forgeaxPreviewPanel = surfaceOwner.panelId;
+    container.dataset.forgeaxPreviewPage = surfaceOwner.pageType;
+    container.dataset.forgeaxAssetPreview = String(target.targetId);
+    adoptSurface(container, surface);
+    fillPresentationSurface(surface);
+    const canvasNode = surfaceCanvas(surface);
+    fillPresentationSurface(canvasNode);
+    const resizeTarget = Number.isSafeInteger(target.generation) ? { targetId: String(target.targetId), generation: target.generation } : null;
+    const detachResize = resizeTarget && api ? attachPreviewRenderResizeSync({ api, surface: container, target: resizeTarget }) : () => {
+    };
+    if (canvasNode?.dataset) {
+      canvasNode.dataset.forgeaxAssetPreview = String(target.targetId);
+      canvasNode.dataset.forgeaxPreviewPanel = surfaceOwner.panelId;
+      canvasNode.dataset.forgeaxPreviewPage = surfaceOwner.pageType;
+    }
+    logResourceOpen("preview-surface-hosted", {
+      pageType: surfaceOwner.pageType,
+      panelId: surfaceOwner.panelId,
+      targetId: String(target.targetId),
+      surfaceTag: surface.tagName ?? null
+    });
+    const attachment = typeof presentation.attach === "function" ? Promise.resolve(presentation.attach({ target, element: surface, owner: surfaceOwner })) : Promise.resolve();
+    const stopKeep = keepSurfaceInContainer({
+      document: container.ownerDocument,
+      getContainer: () => container,
+      getSurface: () => surface,
+      replace: true
+    });
+    return {
+      ok: true,
+      dispose: async () => {
+        stopKeep();
+        detachResize();
+        if (surface.parentNode === container) {
+          if (typeof container.removeChild === "function") container.removeChild(surface);
+          else container.replaceChildren?.();
+        }
+        if (containerOwners.get(container) === surfaceOwner) containerOwners.delete(container);
+        delete container.dataset.forgeaxPreviewPanel;
+        delete container.dataset.forgeaxPreviewPage;
+        delete container.dataset.forgeaxAssetPreview;
+        const detach = await attachment;
+        await detach?.();
+      }
+    };
+  };
+  const first = resolveSurface();
+  if (first) {
+    if (isEditorOwnerSurface(first, container, { target, editorTargetId })) return refuseEditor();
+    return installSurface(first);
+  }
+  const document = container.ownerDocument;
+  const win = document?.defaultView ?? globalThis;
+  const Observer = document?.defaultView?.MutationObserver ?? globalThis.MutationObserver;
+  const canWatch = typeof Observer === "function" || typeof win.requestAnimationFrame === "function";
+  if (!canWatch) return missingSurface();
+  let hosted;
+  const stopWatch = watchUntilReady({
+    document,
+    probe: () => {
+      if (hosted) return true;
+      const surface = resolveSurface();
+      if (!surface || isEditorOwnerSurface(surface, container, { target, editorTargetId })) return false;
+      hosted = installSurface(surface);
+      return true;
+    }
+  });
+  return {
+    ok: true,
+    dispose: async () => {
+      stopWatch();
+      await hosted?.dispose?.();
+    }
+  };
+}
+
+export {
+  dedicatedPreviewPresentation,
+  bindWorkspacePreviewSurface
+};
+//# sourceMappingURL=chunk-LERMYZRC.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../packages/view-workspace-core/src/preview-surface.mjs"],
+  "sourcesContent": ["import { keepSurfaceInContainer, placeSurface, watchUntilReady } from './adopt-surface.mjs';\nimport { logResourceOpen } from './resource-open.mjs';\nimport { attachPreviewRenderResizeSync } from './render-resize-sync.mjs';\n\nconst OWNER_PLACEMENT = 'owner';\nconst containerOwners = new WeakMap();\n\nfunction previewSurfaceError(code, expected, hint) {\n  return Object.freeze({\n    ok: false,\n    error: Object.freeze({ code, expected, hint }),\n  });\n}\n\nfunction placementOf(presentation) {\n  return presentation?.surfacePlacement === OWNER_PLACEMENT ? OWNER_PLACEMENT : 'shell';\n}\n\nfunction isCanvasNode(node) {\n  return node?.tagName?.toLowerCase?.() === 'canvas';\n}\n\nfunction isPanelContainer(node) {\n  if (!node || typeof node !== 'object' || isCanvasNode(node)) return false;\n  return typeof node.replaceChildren === 'function' || typeof node.append === 'function';\n}\n\nfunction surfaceCanvas(surface) {\n  if (isCanvasNode(surface)) return surface;\n  return typeof surface?.querySelector === 'function' ? surface.querySelector('canvas') : null;\n}\n\nfunction isEditorOwnerSurface(surface, container, { target, editorTargetId } = {}) {\n  if (surface?.id === 'app-shell' || surface?.id === 'app') return true;\n  if (\n    editorTargetId != null &&\n    target?.targetId != null &&\n    String(editorTargetId) === String(target.targetId)\n  ) {\n    return true;\n  }\n  const marker = surface?.dataset?.forgeaxViewSurface;\n  if (marker === 'engine-canvas' || marker === 'engine-target') return true;\n  if (typeof surface?.closest !== 'function') return false;\n  const viewport = surface.closest('[data-forgeax-view-mount-host=\"viewport\"]');\n  if (!viewport) return false;\n  if (container === viewport || container?.contains?.(viewport)) return false;\n  return true;\n}\n\nfunction adoptSurface(container, surface) {\n  placeSurface(container, surface, { replace: true });\n}\n\nfunction fillPresentationSurface(surface) {\n  if (!surface?.style) return;\n  Object.assign(surface.style, {\n    width: '100%',\n    height: '100%',\n    maxWidth: '100%',\n    maxHeight: '100%',\n    transform: 'none',\n    position: 'relative',\n    overflow: 'hidden',\n    flex: '1 1 auto',\n    minWidth: '0',\n    minHeight: '0',\n    display: 'block',\n  });\n}\n\n/**\n * Stamp a panel/page owner onto presentation. Asset pages only host the\n * Engine type-preview surface; they do not create a canvas.\n */\nexport function dedicatedPreviewPresentation(presentation, owner) {\n  if (!presentation || typeof presentation !== 'object') return undefined;\n  return {\n    get surfacePlacement() {\n      return presentation.surfacePlacement;\n    },\n    get owner() {\n      return owner ?? presentation.owner;\n    },\n    createSurface(input) {\n      return presentation.createSurface?.(input);\n    },\n    attach(input = {}) {\n      return presentation.attach?.({ ...input, owner });\n    },\n    detach(input) {\n      return presentation.detach?.(input);\n    },\n  };\n}\n\n/**\n * Place an Engine type-preview surface into the container owned by one asset\n * panel. The panel never creates a canvas; Engine `createSurface` returns the\n * live surface. Editor owner canvases are refused.\n *\n * @param {{\n *   presentation?: object,\n *   target?: { targetId?: string | number },\n *   container?: HTMLElement,\n *   owner?: { panelId?: string, pageType?: string },\n *   editorTargetId?: string | number,\n *   api?: { resizePreview?: (input: object) => Promise<unknown> },\n * }} [options]\n * @returns {{ ok: true, dispose?: () => unknown } | { ok: false, error: { code: string, expected: string, hint: string } }}\n */\nexport function bindWorkspacePreviewSurface({\n  presentation,\n  target,\n  container,\n  canvas,\n  owner,\n  editorTargetId,\n  api,\n} = {}) {\n  if (canvas !== undefined || isCanvasNode(container)) {\n    throw new TypeError('bindWorkspacePreviewSurface requires a panel-owned container, not a canvas');\n  }\n  if (!isPanelContainer(container)) {\n    throw new TypeError('bindWorkspacePreviewSurface requires a panel-owned container');\n  }\n  if (!target || (typeof target.targetId !== 'string' && typeof target.targetId !== 'number')) {\n    return previewSurfaceError(\n      'view-preview-target-unavailable',\n      'an Engine preview target identity',\n      'Open the asset through Engine asset.open before attaching a preview surface.',\n    );\n  }\n  if (placementOf(presentation) === OWNER_PLACEMENT) {\n    return previewSurfaceError(\n      'view-preview-surface-unavailable',\n      'a shell-placed Engine preview surface dedicated to this panel',\n      'The Engine owner surface stays on the Editor viewport; asset preview cannot relocate that iframe.',\n    );\n  }\n  if (!presentation || typeof presentation.createSurface !== 'function') {\n    return previewSurfaceError(\n      'view-preview-surface-unavailable',\n      'an Engine presentation that can create a type-preview surface',\n      'The asset tab hosts a DOM container; Engine createSurface places the live canvas into it.',\n    );\n  }\n  const surfaceOwner = owner ?? presentation.owner;\n  if (!surfaceOwner?.panelId || !surfaceOwner?.pageType) {\n    return previewSurfaceError(\n      'view-preview-owner-unavailable',\n      'a stable asset preview panel owner',\n      'Bind the preview through its PageType panel contribution.',\n    );\n  }\n  const claimedBy = containerOwners.get(container);\n  if (claimedBy !== undefined && claimedBy !== surfaceOwner) {\n    return previewSurfaceError(\n      'view-preview-canvas-owned',\n      'a container used by exactly one asset preview panel',\n      'Create a new container for this asset preview panel.',\n    );\n  }\n\n  const missingSurface = () => previewSurfaceError(\n    'view-preview-surface-unavailable',\n    'an Engine type-preview surface for this target',\n    'Engine must expose a type-preview surface via createSurface; the tab does not create a canvas.',\n  );\n  const refuseEditor = () => previewSurfaceError(\n    'view-preview-surface-unavailable',\n    'a shell-placed Engine preview surface dedicated to this panel',\n    'The Engine owner surface stays on the Editor viewport; asset preview cannot relocate that iframe.',\n  );\n\n  const resolveSurface = () => {\n    const surface = presentation.createSurface({\n      target,\n      document: container.ownerDocument,\n    });\n    return surface && typeof surface === 'object' ? surface : null;\n  };\n\n  const installSurface = (surface) => {\n    containerOwners.set(container, surfaceOwner);\n    container.dataset.forgeaxPreviewPanel = surfaceOwner.panelId;\n    container.dataset.forgeaxPreviewPage = surfaceOwner.pageType;\n    container.dataset.forgeaxAssetPreview = String(target.targetId);\n    adoptSurface(container, surface);\n    fillPresentationSurface(surface);\n    const canvasNode = surfaceCanvas(surface);\n    fillPresentationSurface(canvasNode);\n    const resizeTarget = Number.isSafeInteger(target.generation)\n      ? { targetId: String(target.targetId), generation: target.generation }\n      : null;\n    const detachResize = resizeTarget && api\n      ? attachPreviewRenderResizeSync({ api, surface: container, target: resizeTarget })\n      : () => {};\n    if (canvasNode?.dataset) {\n      canvasNode.dataset.forgeaxAssetPreview = String(target.targetId);\n      canvasNode.dataset.forgeaxPreviewPanel = surfaceOwner.panelId;\n      canvasNode.dataset.forgeaxPreviewPage = surfaceOwner.pageType;\n    }\n    logResourceOpen('preview-surface-hosted', {\n      pageType: surfaceOwner.pageType,\n      panelId: surfaceOwner.panelId,\n      targetId: String(target.targetId),\n      surfaceTag: surface.tagName ?? null,\n    });\n    const attachment = typeof presentation.attach === 'function'\n      ? Promise.resolve(presentation.attach({ target, element: surface, owner: surfaceOwner }))\n      : Promise.resolve();\n    const stopKeep = keepSurfaceInContainer({\n      document: container.ownerDocument,\n      getContainer: () => container,\n      getSurface: () => surface,\n      replace: true,\n    });\n    return {\n      ok: true,\n      dispose: async () => {\n        stopKeep();\n        detachResize();\n        // React may bind this same Engine surface again before detach resolves.\n        // Release this placement synchronously so old cleanup cannot remove it.\n        if (surface.parentNode === container) {\n          if (typeof container.removeChild === 'function') container.removeChild(surface);\n          else container.replaceChildren?.();\n        }\n        if (containerOwners.get(container) === surfaceOwner) containerOwners.delete(container);\n        delete container.dataset.forgeaxPreviewPanel;\n        delete container.dataset.forgeaxPreviewPage;\n        delete container.dataset.forgeaxAssetPreview;\n        const detach = await attachment;\n        await detach?.();\n      },\n    };\n  };\n\n  const first = resolveSurface();\n  if (first) {\n    if (isEditorOwnerSurface(first, container, { target, editorTargetId })) return refuseEditor();\n    return installSurface(first);\n  }\n\n  const document = container.ownerDocument;\n  const win = document?.defaultView ?? globalThis;\n  const Observer = document?.defaultView?.MutationObserver ?? globalThis.MutationObserver;\n  const canWatch = typeof Observer === 'function' || typeof win.requestAnimationFrame === 'function';\n  if (!canWatch) return missingSurface();\n\n  let hosted;\n  const stopWatch = watchUntilReady({\n    document,\n    probe: () => {\n      if (hosted) return true;\n      const surface = resolveSurface();\n      if (!surface || isEditorOwnerSurface(surface, container, { target, editorTargetId })) return false;\n      hosted = installSurface(surface);\n      return true;\n    },\n  });\n  return {\n    ok: true,\n    dispose: async () => {\n      stopWatch();\n      await hosted?.dispose?.();\n    },\n  };\n}\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,91 @@
+import {
+  createViewWorkspaceClient
+} from "./chunk-VY3S5BWI.mjs";
+import {
+  VIEW_FILE_GET_SERVICE,
+  VIEW_WORKSPACE_DOMAIN_OPERATIONS,
+  VIEW_WORKSPACE_SERVICES,
+  workspaceError
+} from "./chunk-32GD5LL6.mjs";
+
+// packages/view-workspace-core/src/extension-bridge.mjs
+var VIEW_EXTENSION_ID = "@forgeax-extension/view";
+var VIEW_EXTENSION_CAPABILITIES = Object.freeze({
+  read: "view.workspace.read",
+  author: "view.workspace.author",
+  inspect: "view.plugins.read"
+});
+var AUTHORING_OPERATIONS = /* @__PURE__ */ new Set(["asset-source.rebuild", "asset-source.cold-cook"]);
+var WORKSPACE_OPERATIONS = new Set(VIEW_WORKSPACE_DOMAIN_OPERATIONS);
+function requiredCapability(service, request) {
+  if (service === VIEW_WORKSPACE_SERVICES.call) {
+    if (!WORKSPACE_OPERATIONS.has(request?.operation)) {
+      throw workspaceError(
+        "view-extension-operation-unknown",
+        "operation to be declared by the View workspace contract",
+        "Refresh the View extension capability descriptor.",
+        { operation: request?.operation }
+      );
+    }
+    return AUTHORING_OPERATIONS.has(request.operation) ? VIEW_EXTENSION_CAPABILITIES.author : VIEW_EXTENSION_CAPABILITIES.read;
+  }
+  if (service === VIEW_WORKSPACE_SERVICES.capabilities) return VIEW_EXTENSION_CAPABILITIES.read;
+  if (service === VIEW_FILE_GET_SERVICE) return VIEW_EXTENSION_CAPABILITIES.read;
+  throw workspaceError(
+    "view-extension-service-unknown",
+    "service to be declared by the View extension contract",
+    "Use the typed View workspace client rather than a raw Host service name.",
+    { service }
+  );
+}
+function createViewExtensionTransport({
+  invoke,
+  extensionId = VIEW_EXTENSION_ID,
+  capabilities = []
+} = {}) {
+  if (typeof invoke !== "function") {
+    throw new TypeError("View extension transport requires a host capability invoke function");
+  }
+  if (extensionId !== VIEW_EXTENSION_ID) {
+    throw new TypeError(`View extension transport only admits ${VIEW_EXTENSION_ID}`);
+  }
+  const granted = new Set(capabilities);
+  return Object.freeze({
+    request(service, request, options = {}) {
+      const capability = requiredCapability(service, request);
+      if (!granted.has(capability)) {
+        return Promise.reject(workspaceError(
+          "view-extension-capability-denied",
+          `the ${capability} capability to be granted`,
+          "Install or re-authorize the View extension with the required permission.",
+          { extensionId, capability, service, operation: request?.operation }
+        ));
+      }
+      const { signal, generation } = options;
+      return Promise.resolve(invoke({
+        extensionId,
+        capability,
+        service,
+        request,
+        ...signal === void 0 ? {} : { signal },
+        ...generation === void 0 ? {} : { generation }
+      }));
+    },
+    close() {
+    }
+  });
+}
+function createViewExtensionWorkspaceClient({ invoke, capabilities, clientId } = {}) {
+  return createViewWorkspaceClient({
+    transport: createViewExtensionTransport({ invoke, capabilities }),
+    clientId
+  });
+}
+
+export {
+  VIEW_EXTENSION_ID,
+  VIEW_EXTENSION_CAPABILITIES,
+  createViewExtensionTransport,
+  createViewExtensionWorkspaceClient
+};
+//# sourceMappingURL=chunk-LKJCXYSJ.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../packages/view-workspace-core/src/extension-bridge.mjs"],
+  "sourcesContent": ["import { VIEW_FILE_GET_SERVICE, VIEW_WORKSPACE_SERVICES, VIEW_WORKSPACE_DOMAIN_OPERATIONS, workspaceError } from './contract.mjs';\nimport { createViewWorkspaceClient } from './client.mjs';\n\nexport const VIEW_EXTENSION_ID = '@forgeax-extension/view';\nexport const VIEW_EXTENSION_CAPABILITIES = Object.freeze({\n  read: 'view.workspace.read',\n  author: 'view.workspace.author',\n  inspect: 'view.plugins.read',\n});\n\nconst AUTHORING_OPERATIONS = new Set(['asset-source.rebuild', 'asset-source.cold-cook']);\nconst WORKSPACE_OPERATIONS = new Set(VIEW_WORKSPACE_DOMAIN_OPERATIONS);\n\nfunction requiredCapability(service, request) {\n  if (service === VIEW_WORKSPACE_SERVICES.call) {\n    if (!WORKSPACE_OPERATIONS.has(request?.operation)) {\n      throw workspaceError(\n        'view-extension-operation-unknown',\n        'operation to be declared by the View workspace contract',\n        'Refresh the View extension capability descriptor.',\n        { operation: request?.operation },\n      );\n    }\n    return AUTHORING_OPERATIONS.has(request.operation)\n      ? VIEW_EXTENSION_CAPABILITIES.author\n      : VIEW_EXTENSION_CAPABILITIES.read;\n  }\n  if (service === VIEW_WORKSPACE_SERVICES.capabilities) return VIEW_EXTENSION_CAPABILITIES.read;\n  if (service === VIEW_FILE_GET_SERVICE) return VIEW_EXTENSION_CAPABILITIES.read;\n  throw workspaceError(\n    'view-extension-service-unknown',\n    'service to be declared by the View extension contract',\n    'Use the typed View workspace client rather than a raw Host service name.',\n    { service },\n  );\n}\n\n/**\n * Browser-side adapter for an Editor-issued, session-bound View capability.\n * The host authenticates the iframe; this transport never receives or forwards\n * the resident Host endpoint or its bearer token.\n */\nexport function createViewExtensionTransport({\n  invoke,\n  extensionId = VIEW_EXTENSION_ID,\n  capabilities = [],\n} = {}) {\n  if (typeof invoke !== 'function') {\n    throw new TypeError('View extension transport requires a host capability invoke function');\n  }\n  if (extensionId !== VIEW_EXTENSION_ID) {\n    throw new TypeError(`View extension transport only admits ${VIEW_EXTENSION_ID}`);\n  }\n  const granted = new Set(capabilities);\n  return Object.freeze({\n    request(service, request, options = {}) {\n      const capability = requiredCapability(service, request);\n      if (!granted.has(capability)) {\n        return Promise.reject(workspaceError(\n          'view-extension-capability-denied',\n          `the ${capability} capability to be granted`,\n          'Install or re-authorize the View extension with the required permission.',\n          { extensionId, capability, service, operation: request?.operation },\n        ));\n      }\n      const { signal, generation } = options;\n      return Promise.resolve(invoke({\n        extensionId,\n        capability,\n        service,\n        request,\n        ...(signal === undefined ? {} : { signal }),\n        ...(generation === undefined ? {} : { generation }),\n      }));\n    },\n    close() {},\n  });\n}\n\nexport function createViewExtensionWorkspaceClient({ invoke, capabilities, clientId } = {}) {\n  return createViewWorkspaceClient({\n    transport: createViewExtensionTransport({ invoke, capabilities }),\n    clientId,\n  });\n}\n"],
+  "mappings": ";;;;;;;;;;;AAGO,IAAM,oBAAoB;AAC1B,IAAM,8BAA8B,OAAO,OAAO;AAAA,EACvD,MAAM;AAAA,EACN,QAAQ;AAAA,EACR,SAAS;AACX,CAAC;AAED,IAAM,uBAAuB,oBAAI,IAAI,CAAC,wBAAwB,wBAAwB,CAAC;AACvF,IAAM,uBAAuB,IAAI,IAAI,gCAAgC;AAErE,SAAS,mBAAmB,SAAS,SAAS;AAC5C,MAAI,YAAY,wBAAwB,MAAM;AAC5C,QAAI,CAAC,qBAAqB,IAAI,SAAS,SAAS,GAAG;AACjD,YAAM;AAAA,QACJ;AAAA,QACA;AAAA,QACA;AAAA,QACA,EAAE,WAAW,SAAS,UAAU;AAAA,MAClC;AAAA,IACF;AACA,WAAO,qBAAqB,IAAI,QAAQ,SAAS,IAC7C,4BAA4B,SAC5B,4BAA4B;AAAA,EAClC;AACA,MAAI,YAAY,wBAAwB,aAAc,QAAO,4BAA4B;AACzF,MAAI,YAAY,sBAAuB,QAAO,4BAA4B;AAC1E,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA;AAAA,IACA,EAAE,QAAQ;AAAA,EACZ;AACF;AAOO,SAAS,6BAA6B;AAAA,EAC3C;AAAA,EACA,cAAc;AAAA,EACd,eAAe,CAAC;AAClB,IAAI,CAAC,GAAG;AACN,MAAI,OAAO,WAAW,YAAY;AAChC,UAAM,IAAI,UAAU,qEAAqE;AAAA,EAC3F;AACA,MAAI,gBAAgB,mBAAmB;AACrC,UAAM,IAAI,UAAU,wCAAwC,iBAAiB,EAAE;AAAA,EACjF;AACA,QAAM,UAAU,IAAI,IAAI,YAAY;AACpC,SAAO,OAAO,OAAO;AAAA,IACnB,QAAQ,SAAS,SAAS,UAAU,CAAC,GAAG;AACtC,YAAM,aAAa,mBAAmB,SAAS,OAAO;AACtD,UAAI,CAAC,QAAQ,IAAI,UAAU,GAAG;AAC5B,eAAO,QAAQ,OAAO;AAAA,UACpB;AAAA,UACA,OAAO,UAAU;AAAA,UACjB;AAAA,UACA,EAAE,aAAa,YAAY,SAAS,WAAW,SAAS,UAAU;AAAA,QACpE,CAAC;AAAA,MACH;AACA,YAAM,EAAE,QAAQ,WAAW,IAAI;AAC/B,aAAO,QAAQ,QAAQ,OAAO;AAAA,QAC5B;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA,GAAI,WAAW,SAAY,CAAC,IAAI,EAAE,OAAO;AAAA,QACzC,GAAI,eAAe,SAAY,CAAC,IAAI,EAAE,WAAW;AAAA,MACnD,CAAC,CAAC;AAAA,IACJ;AAAA,IACA,QAAQ;AAAA,IAAC;AAAA,EACX,CAAC;AACH;AAEO,SAAS,mCAAmC,EAAE,QAAQ,cAAc,SAAS,IAAI,CAAC,GAAG;AAC1F,SAAO,0BAA0B;AAAA,IAC/B,WAAW,6BAA6B,EAAE,QAAQ,aAAa,CAAC;AAAA,IAChE;AAAA,EACF,CAAC;AACH;",
+  "names": []
+}

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

@@ -0,0 +1,25 @@
+import {
+  FRONTEND_PLUGIN_ID,
+  identity_exports
+} from "./chunk-EJGBVKFE.mjs";
+import {
+  applyResourcePagePlugin
+} from "./chunk-YYXQDUVT.mjs";
+
+// packages/view-plugin-mesh/src/frontend.mjs
+var VIEW_MESH_FRONTEND_PLUGIN_ID = FRONTEND_PLUGIN_ID;
+var viewMeshFrontendPlugin = {
+  name: VIEW_MESH_FRONTEND_PLUGIN_ID,
+  inject: ["viewOperationClient"],
+  async apply(ctx, config = {}) {
+    await applyResourcePagePlugin(ctx, config, identity_exports);
+  }
+};
+var frontend_default = viewMeshFrontendPlugin;
+
+export {
+  VIEW_MESH_FRONTEND_PLUGIN_ID,
+  viewMeshFrontendPlugin,
+  frontend_default
+};
+//# sourceMappingURL=chunk-MBS3EICT.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../packages/view-plugin-mesh/src/frontend.mjs"],
+  "sourcesContent": ["import * as identity from './identity.mjs';\nimport { applyResourcePagePlugin } from '@forgeax/view-workspace-core/resource-page';\n\nexport const VIEW_MESH_FRONTEND_PLUGIN_ID = identity.FRONTEND_PLUGIN_ID;\n\nconst viewMeshFrontendPlugin = {\n  name: VIEW_MESH_FRONTEND_PLUGIN_ID,\n  inject: ['viewOperationClient'],\n  async apply(ctx, config = {}) {\n    await applyResourcePagePlugin(ctx, config, identity);\n  },\n};\n\nexport { viewMeshFrontendPlugin };\nexport default viewMeshFrontendPlugin;\n"],
+  "mappings": ";;;;;;;;;AAGO,IAAM,+BAAwC;AAErD,IAAM,yBAAyB;AAAA,EAC7B,MAAM;AAAA,EACN,QAAQ,CAAC,qBAAqB;AAAA,EAC9B,MAAM,MAAM,KAAK,SAAS,CAAC,GAAG;AAC5B,UAAM,wBAAwB,KAAK,QAAQ,gBAAQ;AAAA,EACrD;AACF;AAGA,IAAO,mBAAQ;",
+  "names": []
+}