@forgeax/view 0.4.1 → 0.4.2

package/README.md

@@ -242,17 +242,23 @@ Engine candidate commit and overlays the proposed View source. Engine's required
 `view-integration` lane tests the pinned consumer; `primary-pnpm` retains main ancestry
 verification. A candidate pass does not authorize an unmerged final gitlink.
 
-The CI workload companion uses Engine candidate `7f6db3492b5ca0a5bf1da9380db7d9cd6ff7205c`.
-Its diagnostic sky oracle samples the outer margin clear of both Game 3D HUD cards;
-the earlier pinned probe sampled the card at 320x180. The blue/gradient assertions
-and real frame capture remain unchanged.
+The workflow's `FORGEAX_ENGINE_COMMIT` is the paired Engine candidate authority.
+CI checks Engine out at the workspace root and overlays View at `tools/view`, so
+Engine's composite build actions resolve their nested actions and source paths.
+Node and pnpm versions come from Engine's `.nvmrc` and `.pnpm-version`; build and
+browser lanes prepare the verified Rapier WASM payload before building Engine.
+The diagnostic probe explicitly selects RHI Debug after refresh or service restart;
+its sky oracle samples the outer margin clear of both Game 3D HUD cards, retaining
+the blue/gradient assertions and real frame capture.
 The separate Runtime Capture UI proof explicitly retains its qualified 1280x720
 independent-run image under CI, including DOM/Shadow DOM pixels, reload and View loss.
 
 Contributor Game 3D and runtime-content probes bind the actual Engine source root.
 SDK npm/ZIP consumers separately run the installed View scripts, retaining JS/TS
-live publication and cold reopening plus the installed-package Game 3D journey.
-Source qualification cannot replace that independent package evidence.
+live publication and cold reopening. SDK Project owns installed Game 3D build,
+input and rendering; Engine/View integration owns its complete Play, cancellation
+and View restart journey without repeating it in the installed View stages.
+Source qualification cannot replace the retained independent package evidence.
 
 The integration gate retains startup, page/plugin lifecycle, independent AI run and
 ordinary game-3d browser probes. It also verifies diagnostic artifact pages in both
@@ -320,7 +326,12 @@ and repeated sampling. SDK/template inputs remain immutable.
 | Runtime scene window | 60 completed frames | 300 completed frames |
 | Dedicated preview open/capture/close | 2 complete cycles | 6 complete cycles |
 | Browser viewport | 1000x700 | Runtime 1440x1000; Game 3D 1440x900 |
-| Game 3D directional shadow map | 256, three cascades | 2048, three cascades |
+| Game 3D directional shadow map | Shared Engine test profile: 256, two cascades | Authored template: 1024, three cascades |
+
+Game 3D uses the selected Engine checkout's `scripts/test/reduce-test-project.mjs`
+on its disposable copy. This shares shadow, procedural geometry and particle
+budgets with Engine's other browser probes without depending on an old template
+default. Entity identities, shader programs and material slots stay intact.
 
 Both JS and TS retain live admission and saved-source cold reopening. Every
 preview cycle creates one observed GPU device, renders real geometry, closes it,
@@ -815,3 +826,6 @@ entries, as well as their source closure. Native build metadata records a digest
 of the finalized viewer bytes. Engine integration checks the actual bytes and
 runs temporary served-only and native-entry mismatch falsifiers; matching
 metadata alone is not sufficient build identity.
+
+The required project dialog is modeless: Scene still requires a confirmed project,
+while artifact pages and workspace navigation remain available before opening one.

package/dist/build-revision.json

@@ -1 +1 @@
-{"codeRevision":"e12a08a46206522734144b820f19473089520d9844dad428d9bfdda324acfbe5","viewerDigest":"f01fe8a0d19fe0d229a043fbb7fd0f10bc8ae2271e2fff576387839b15d5e5d2"}
+{"codeRevision":"92a9f98a182bc24c5e570237d659d9fcc6a2093d3a2ba34b5e2bc2f763c0dbf9","viewerDigest":"8a1efe679e83a4f857238f3e4b299c7dec2d5a931a06af674ef173292ce56c37"}

package/dist/modules/backend.mjs

@@ -2,31 +2,31 @@ import {
   createViewBackend,
   createViewHostBinding,
   createViewPlatformBinding
-} from "./chunks/chunk-TBZZ37VI.mjs";
-import "./chunks/chunk-BCTPTLA6.mjs";
+} from "./chunks/chunk-KYTG2MKV.mjs";
+import "./chunks/chunk-XEE3E42Q.mjs";
 import "./chunks/chunk-YLCJNKIW.mjs";
 import "./chunks/chunk-GQANC3HH.mjs";
 import "./chunks/chunk-YY4G5LVX.mjs";
 import "./chunks/chunk-6KM24NH6.mjs";
-import "./chunks/chunk-3GIGTM7E.mjs";
-import "./chunks/chunk-MO5LILCP.mjs";
+import "./chunks/chunk-27XASYEH.mjs";
+import "./chunks/chunk-HWZCLROY.mjs";
 import "./chunks/chunk-55F55BQY.mjs";
 import "./chunks/chunk-N2GEQFFK.mjs";
-import "./chunks/chunk-TTFLJHQZ.mjs";
-import "./chunks/chunk-CRNEX7YH.mjs";
+import "./chunks/chunk-H4UIESCF.mjs";
+import "./chunks/chunk-D25SR5FS.mjs";
 import "./chunks/chunk-AGVLPYVE.mjs";
 import "./chunks/chunk-7IGFAI5H.mjs";
 import "./chunks/chunk-OKQ5RBKO.mjs";
 import "./chunks/chunk-EZSGDSCC.mjs";
 import "./chunks/chunk-EWSCJF77.mjs";
-import "./chunks/chunk-AIIYGGGC.mjs";
-import "./chunks/chunk-CWNB67UF.mjs";
+import "./chunks/chunk-X4NNZ5X6.mjs";
+import "./chunks/chunk-FMCHH5R4.mjs";
 import "./chunks/chunk-STQPRNEO.mjs";
-import "./chunks/chunk-OHVTNEQ2.mjs";
+import "./chunks/chunk-PZIAKZJC.mjs";
 import "./chunks/chunk-QUFVUMSY.mjs";
 import "./chunks/chunk-HRKW766Y.mjs";
-import "./chunks/chunk-BGK4ZEQ5.mjs";
-import "./chunks/chunk-45ZU2HHR.mjs";
+import "./chunks/chunk-KX2WU5Z6.mjs";
+import "./chunks/chunk-B6QUJ33G.mjs";
 import "./chunks/chunk-PJFFCRRD.mjs";
 import "./chunks/chunk-IM3H4F4X.mjs";
 import "./chunks/chunk-K2QZRFLE.mjs";

package/dist/modules/browser.mjs

@@ -11,15 +11,15 @@ import {
   connectViewFrontend,
   mountViewViewer,
   mountViewWorkspace
-} from "./chunks/chunk-CDO6LELS.mjs";
-import "./chunks/chunk-WHVPE2P6.mjs";
-import "./chunks/chunk-PG4AJFDC.mjs";
-import "./chunks/chunk-MHE5EBU4.mjs";
-import "./chunks/chunk-6WCG6WPC.mjs";
-import "./chunks/chunk-JZ3V27HQ.mjs";
-import "./chunks/chunk-W46L4HSP.mjs";
+} from "./chunks/chunk-Y2IAXE2C.mjs";
+import "./chunks/chunk-Q2ZYLFJM.mjs";
+import "./chunks/chunk-DJZGRO7W.mjs";
+import "./chunks/chunk-E3PJGTLI.mjs";
+import "./chunks/chunk-YNHEYXDG.mjs";
+import "./chunks/chunk-U64FRQKP.mjs";
+import "./chunks/chunk-U6UMATPV.mjs";
 import "./chunks/chunk-YFQGSDK3.mjs";
-import "./chunks/chunk-VXSD4FK5.mjs";
+import "./chunks/chunk-ZHO2G4JR.mjs";
 import "./chunks/chunk-CX5WREJC.mjs";
 import "./chunks/chunk-TTRUYO7Q.mjs";
 import "./chunks/chunk-F5RLQAPN.mjs";
@@ -36,8 +36,8 @@ import {
 import "./chunks/chunk-INTTYJVW.mjs";
 import "./chunks/chunk-Q2NO32WU.mjs";
 import "./chunks/chunk-OQXDADAS.mjs";
-import "./chunks/chunk-TTFLJHQZ.mjs";
-import "./chunks/chunk-CRNEX7YH.mjs";
+import "./chunks/chunk-H4UIESCF.mjs";
+import "./chunks/chunk-D25SR5FS.mjs";
 import {
   DISPLAY_SURFACE_ID
 } from "./chunks/chunk-AGVLPYVE.mjs";
@@ -54,14 +54,14 @@ import {
 import "./chunks/chunk-OKQ5RBKO.mjs";
 import "./chunks/chunk-EZSGDSCC.mjs";
 import "./chunks/chunk-EWSCJF77.mjs";
-import "./chunks/chunk-AIIYGGGC.mjs";
-import "./chunks/chunk-CWNB67UF.mjs";
+import "./chunks/chunk-X4NNZ5X6.mjs";
+import "./chunks/chunk-FMCHH5R4.mjs";
 import "./chunks/chunk-STQPRNEO.mjs";
-import "./chunks/chunk-OHVTNEQ2.mjs";
+import "./chunks/chunk-PZIAKZJC.mjs";
 import "./chunks/chunk-QUFVUMSY.mjs";
 import "./chunks/chunk-HRKW766Y.mjs";
-import "./chunks/chunk-BGK4ZEQ5.mjs";
-import "./chunks/chunk-45ZU2HHR.mjs";
+import "./chunks/chunk-KX2WU5Z6.mjs";
+import "./chunks/chunk-B6QUJ33G.mjs";
 import "./chunks/chunk-PJFFCRRD.mjs";
 import "./chunks/chunk-IM3H4F4X.mjs";
 import "./chunks/chunk-K2QZRFLE.mjs";
@@ -117,7 +117,7 @@ import {
   workspaceUiFingerprint
 } from "./chunks/chunk-E3Z7GLFU.mjs";
 import "./chunks/chunk-4XEXLHX4.mjs";
-import "./chunks/chunk-7MJUWNVI.mjs";
+import "./chunks/chunk-ZGOGO7SS.mjs";
 import "./chunks/chunk-QAXALJEY.mjs";
 import "./chunks/chunk-FLGC65SR.mjs";
 export {

package/dist/modules/chunks/{App-E3M52XTQ.mjs → App-4XQ5SNNT.mjs}

@@ -8,7 +8,7 @@ import {
   Spinner,
   Switch,
   TextInput
-} from "./chunk-FKLYSAVN.mjs";
+} from "./chunk-CXOD7FW6.mjs";
 import "./chunk-FLGC65SR.mjs";
 
 // ../../apps/rhi-debug-viewer/src/App.tsx
@@ -39066,4 +39066,4 @@ dockview-react/dist/package/main.esm.mjs:
    * @license MIT
    *)
 */
-//# sourceMappingURL=App-E3M52XTQ.mjs.map
+//# sourceMappingURL=App-4XQ5SNNT.mjs.map

package/dist/modules/chunks/{chunk-3GIGTM7E.mjs → chunk-27XASYEH.mjs}

@@ -1,6 +1,6 @@
 import {
   ViewWorkspaceBroker
-} from "./chunk-MO5LILCP.mjs";
+} from "./chunk-HWZCLROY.mjs";
 import {
   createWorkspaceToolContributions,
   defineWorkspaceOperations
@@ -75,4 +75,4 @@ export {
   viewWorkspaceCoreBackendPlugin,
   backend_default
 };
-//# sourceMappingURL=chunk-3GIGTM7E.mjs.map
+//# sourceMappingURL=chunk-27XASYEH.mjs.map

package/dist/modules/chunks/{chunk-UAGQZPAB.mjs → chunk-2Z5KEV6L.mjs}

@@ -8,7 +8,7 @@ import {
   InspectorForm,
   OverlayRootProvider,
   PanelHeader
-} from "./chunk-FKLYSAVN.mjs";
+} from "./chunk-CXOD7FW6.mjs";
 import {
   unwrapWorkspaceInspection
 } from "./chunk-ZYTHV373.mjs";
@@ -118,4 +118,4 @@ async function mountAssetPropertiesPanel(props) {
 export {
   mountAssetPropertiesPanel
 };
-//# sourceMappingURL=chunk-UAGQZPAB.mjs.map
+//# sourceMappingURL=chunk-2Z5KEV6L.mjs.map

package/dist/modules/chunks/{chunk-4NGODRIE.mjs → chunk-46UEGAXY.mjs}

@@ -9,16 +9,16 @@ import {
   OverlayRootProvider,
   PanelHeader,
   PropertyRow
-} from "./chunk-FKLYSAVN.mjs";
+} from "./chunk-CXOD7FW6.mjs";
 import {
   unwrapWorkspaceInspection
 } from "./chunk-ZYTHV373.mjs";
 import {
   RESOURCE_KINDS
-} from "./chunk-AIIYGGGC.mjs";
+} from "./chunk-X4NNZ5X6.mjs";
 import {
   bindWorkspacePreviewSurface
-} from "./chunk-45ZU2HHR.mjs";
+} from "./chunk-B6QUJ33G.mjs";
 import {
   selectWorkspaceResourcePreview,
   selectWorkspaceResourceSubject
@@ -241,4 +241,4 @@ export {
   mountMeshPreviewPanel,
   mountMeshPropertiesPanel
 };
-//# sourceMappingURL=chunk-4NGODRIE.mjs.map
+//# sourceMappingURL=chunk-46UEGAXY.mjs.map

package/dist/modules/chunks/{chunk-UZHTLAIZ.mjs → chunk-47RJSHLM.mjs}

@@ -25,7 +25,7 @@ import {
   resolveInspectorFieldKind,
   useOverlayRoot,
   useWorkspaceClientConnected
-} from "./chunk-FKLYSAVN.mjs";
+} from "./chunk-CXOD7FW6.mjs";
 import {
   createWorkspaceObservation,
   createWorkspaceStateReader
@@ -431,4 +431,4 @@ async function mountInspectorPanel(props) {
 export {
   mountInspectorPanel
 };
-//# sourceMappingURL=chunk-UZHTLAIZ.mjs.map
+//# sourceMappingURL=chunk-47RJSHLM.mjs.map

package/dist/modules/chunks/{chunk-L5EV6NEE.mjs → chunk-4JGCYD3Q.mjs}

@@ -7,7 +7,7 @@ import {
 } from "./chunk-5AKXNYKX.mjs";
 import {
   VIEW_PRODUCT_BACKEND_CATALOG
-} from "./chunk-BCTPTLA6.mjs";
+} from "./chunk-XEE3E42Q.mjs";
 import {
   startViewHostServer
 } from "./chunk-N2GEQFFK.mjs";
@@ -19,7 +19,7 @@ import {
   VIEW_FRONTEND_MODULE,
   createViewProductPlan,
   viewFrontendRoot
-} from "./chunk-TTFLJHQZ.mjs";
+} from "./chunk-H4UIESCF.mjs";
 import {
   workspaceDiagnosticRecord
 } from "./chunk-U5R6MVM4.mjs";
@@ -283,4 +283,4 @@ var product_default = {
 export {
   product_default
 };
-//# sourceMappingURL=chunk-L5EV6NEE.mjs.map
+//# sourceMappingURL=chunk-4JGCYD3Q.mjs.map

package/dist/modules/chunks/{chunk-ACOMGSSB.mjs → chunk-5PHAXNFO.mjs}

@@ -8,7 +8,7 @@ import {
   Surface,
   Text,
   Toolbar
-} from "./chunk-FKLYSAVN.mjs";
+} from "./chunk-CXOD7FW6.mjs";
 import {
   PLUGINS_ACTIONS
 } from "./chunk-UMKHEGRE.mjs";
@@ -441,4 +441,4 @@ function PluginsPanel(props) {
 export {
   PluginsPanel
 };
-//# sourceMappingURL=chunk-ACOMGSSB.mjs.map
+//# sourceMappingURL=chunk-5PHAXNFO.mjs.map

package/dist/modules/chunks/{chunk-45ZU2HHR.mjs → chunk-B6QUJ33G.mjs}

@@ -3,7 +3,6 @@ import {
 } from "./chunk-PJFFCRRD.mjs";
 import {
   keepSurfaceInContainer,
-  placeSurface,
   watchUntilReady
 } from "./chunk-QW3ZY2AD.mjs";
 import {
@@ -46,9 +45,6 @@ function isEditorOwnerSurface(surface, container, { target, editorTargetId } = {
   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, {
@@ -159,7 +155,12 @@ function bindWorkspacePreviewSurface({
     container.dataset.forgeaxPreviewPanel = surfaceOwner.panelId;
     container.dataset.forgeaxPreviewPage = surfaceOwner.pageType;
     container.dataset.forgeaxAssetPreview = String(target.targetId);
-    adoptSurface(container, surface);
+    const stopKeep = keepSurfaceInContainer({
+      document: container.ownerDocument,
+      getContainer: () => container,
+      getSurface: () => surface,
+      replace: true
+    });
     fillPresentationSurface(surface);
     const canvasNode = surfaceCanvas(surface);
     fillPresentationSurface(canvasNode);
@@ -177,26 +178,29 @@ function bindWorkspacePreviewSurface({
       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
-    });
+    const releasePlacement = () => {
+      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;
+    };
+    let attachment;
+    try {
+      attachment = typeof presentation.attach === "function" ? Promise.resolve(presentation.attach({ target, element: surface, owner: surfaceOwner })) : Promise.resolve();
+    } catch (cause) {
+      releasePlacement();
+      throw cause;
+    }
     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;
+        releasePlacement();
         const detach = await attachment;
         await detach?.();
       }
@@ -236,4 +240,4 @@ export {
   dedicatedPreviewPresentation,
   bindWorkspacePreviewSurface
 };
-//# sourceMappingURL=chunk-45ZU2HHR.mjs.map
+//# sourceMappingURL=chunk-B6QUJ33G.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../packages/view-workspace-core/src/preview-surface.ts"],
+  "sourcesContent": ["import type { EngineWorkspaceTarget } from '@forgeax/engine/app';\nimport type { WorkspaceTarget } from './contract.ts';\nimport type { ViewWorkspaceClient } from './client.ts';\nimport type { ViewPresentation, PreviewOwner } from './engine-presentation.ts';\nexport type PreviewSurfaceResult = { ok: true; dispose?: () => void | Promise<void> } | { ok: false; error: { code: string; expected: string; hint: string } };\nexport type PreviewSurfaceOptions = { presentation?: ViewPresentation; target?: WorkspaceTarget; container?: HTMLElement | null; canvas?: unknown; owner?: PreviewOwner; editorTargetId?: string; api?: Pick<ViewWorkspaceClient, 'resizePreview'> };\n\nimport { keepSurfaceInContainer, watchUntilReady } from './adopt-surface.ts';\nimport { logResourceOpen } from './resource-open.ts';\nimport { attachPreviewRenderResizeSync } from './render-resize-sync.ts';\n\nconst OWNER_PLACEMENT = 'owner';\nconst containerOwners = new WeakMap<HTMLElement, PreviewOwner>();\n\nfunction previewSurfaceError(code: string, expected: string, hint: string): Extract<PreviewSurfaceResult, { ok: false }> {\n  return Object.freeze({\n    ok: false,\n    error: Object.freeze({ code, expected, hint }),\n  });\n}\n\nfunction placementOf(presentation: ViewPresentation | undefined) {\n  return presentation?.surfacePlacement === OWNER_PLACEMENT ? OWNER_PLACEMENT : 'shell';\n}\n\nfunction isCanvasNode(node: unknown): node is HTMLCanvasElement {\n  return node != null && typeof node === 'object' && 'tagName' in node && typeof node.tagName === 'string' && node.tagName.toLowerCase() === 'canvas';\n}\n\nfunction isPanelContainer(node: unknown): node is HTMLElement {\n  if (!node || typeof node !== 'object' || isCanvasNode(node)) return false;\n  return ('replaceChildren' in node && typeof node.replaceChildren === 'function') || ('append' in node && typeof node.append === 'function');\n}\n\nfunction surfaceCanvas(surface: HTMLElement) {\n  if (isCanvasNode(surface)) return surface;\n  return typeof surface?.querySelector === 'function' ? surface.querySelector('canvas') : null;\n}\n\nfunction isEditorOwnerSurface(surface: HTMLElement, container: HTMLElement, { target, editorTargetId }: Pick<PreviewSurfaceOptions, '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 fillPresentationSurface(surface: HTMLElement | null) {\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: ViewPresentation | undefined, owner: PreviewOwner): ViewPresentation | undefined {\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}: PreviewSurfaceOptions = {}): PreviewSurfaceResult {\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: target as EngineWorkspaceTarget,\n      document: container.ownerDocument,\n    });\n    return surface && typeof surface === 'object' && 'tagName' in surface && typeof surface.tagName === 'string' ? surface as HTMLElement : null;\n  };\n\n  const installSurface = (surface: HTMLElement): Extract<PreviewSurfaceResult, { ok: true }> => {\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    const stopKeep = keepSurfaceInContainer({\n      document: container.ownerDocument,\n      getContainer: () => container,\n      getSurface: () => surface,\n      replace: true,\n    });\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 releasePlacement = () => {\n      // Return the borrowed surface to Engine parking before awaiting cleanup.\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    };\n    let attachment: Promise<void | (() => void)>;\n    try {\n      attachment = typeof presentation.attach === 'function'\n        ? Promise.resolve(presentation.attach({ target: target as EngineWorkspaceTarget, element: surface, owner: surfaceOwner }))\n        : Promise.resolve();\n    } catch (cause) {\n      releasePlacement();\n      throw cause;\n    }\n    return {\n      ok: true,\n      dispose: async () => {\n        releasePlacement();\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: Extract<PreviewSurfaceResult, { ok: true }> | undefined;\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-FKLYSAVN.mjs → chunk-CXOD7FW6.mjs}

@@ -694,6 +694,7 @@ function ContextMenu({
 }
 function Dialog({
   open,
+  modal = true,
   title,
   children,
   footer,
@@ -711,14 +712,15 @@ function Dialog({
     if (!dialog) return;
     if (open && !dialog.open) {
       returnFocusRef.current = document.activeElement instanceof HTMLElement ? document.activeElement : null;
-      dialog.showModal();
+      if (modal) dialog.showModal();
+      else dialog.show();
       requestAnimationFrame(() => initialFocusRef?.current?.focus());
     }
     if (!open && dialog.open) {
       dialog.close();
       returnFocusRef.current?.focus();
     }
-  }, [initialFocusRef, open]);
+  }, [initialFocusRef, modal, open]);
   return /* @__PURE__ */ jsxs(
     "dialog",
     {
@@ -739,7 +741,8 @@ function Dialog({
         requestAnimationFrame(() => {
           const dialog = ref.current;
           if (open && dialog && !dialog.open) {
-            dialog.showModal();
+            if (modal) dialog.showModal();
+            else dialog.show();
             initialFocusRef?.current?.focus();
           }
         });
@@ -2088,4 +2091,4 @@ export {
   ThemeProvider,
   useTheme
 };
-//# sourceMappingURL=chunk-FKLYSAVN.mjs.map
+//# sourceMappingURL=chunk-CXOD7FW6.mjs.map