@fps-games/editor 0.2.1-beta.1 → 0.2.1-beta.3

package/dist/agent-bridge/capabilities/ui-regions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ui-regions.d.ts","sourceRoot":"","sources":["../../../src/agent-bridge/capabilities/ui-regions.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,cAAc,CAAC;AAoJvE,wBAAgB,oCAAoC,CAAC,SAAS,EAAE,MAAM,EACpE,KAAK,EAAE,kCAAkC,CAAC,SAAS,EAAE,MAAM,CAAC,GAC3D,8BAA8B,CAMhC"}
+{"version":3,"file":"ui-regions.d.ts","sourceRoot":"","sources":["../../../src/agent-bridge/capabilities/ui-regions.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,cAAc,CAAC;AAoKvE,wBAAgB,oCAAoC,CAAC,SAAS,EAAE,MAAM,EACpE,KAAK,EAAE,kCAAkC,CAAC,SAAS,EAAE,MAAM,CAAC,GAC3D,8BAA8B,CAMhC"}

package/dist/agent-bridge/capabilities/ui-regions.js

@@ -110,6 +110,22 @@ const AGENT_BRIDGE_WORKSPACE_REGIONS = Object.freeze([
             'Do not drag assets in the browser or hand-edit generated catalogs as the primary placement path.',
         ],
     },
+    {
+        id: 'bottom-console',
+        label: 'Editor Console',
+        location: 'bottom-global',
+        purpose: 'Session-scoped structured output for editor save, import, compile, run, plugin, and capability operations.',
+        primaryCapabilities: [
+            EDITOR_AGENT_BRIDGE_CAPABILITY_ID.EDITOR_DIAGNOSTICS_LIST,
+            EDITOR_AGENT_BRIDGE_CAPABILITY_ID.EDITOR_STATE_GET,
+        ],
+        fallbackTools: ['playwright', 'chrome'],
+        notes: [
+            'This Console is Editor-owned operation output and does not intercept browser console.* calls.',
+            'Validation Center remains the revision-aware diagnostics surface and Save/Run gate.',
+            'Agent Bridge Console remains a separate external observability plane.',
+        ],
+    },
     {
         id: 'agent-console',
         label: 'Agent Bridge Console',

package/dist/agent-bridge/capabilities/ui-regions.js.map

@@ -1 +1 @@
-{"version":3,"file":"ui-regions.js","sourceRoot":"","sources":["../../../src/agent-bridge/capabilities/ui-regions.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  EDITOR_AGENT_BRIDGE_CAPABILITY_ID,\n  type EditorAgentBridgeUiRegionsGetOutput,\n  type EditorAgentBridgeWorkspaceRegion,\n} from '@fps-games/editor-protocol';\nimport type { LocalEditorAgentBridgeUiSource } from '../source-types.js';\nimport type { LocalEditorAgentBridgeHarnessState } from '../shared.js';\n\nconst AGENT_BRIDGE_WORKSPACE_REGIONS: readonly EditorAgentBridgeWorkspaceRegion[] = Object.freeze([\n  {\n    id: 'top-toolbar',\n    label: 'Top Toolbar',\n    location: 'top',\n    purpose: 'Mode, transform tool, viewport utility, save/history, and Agent Bridge status controls.',\n    primaryCapabilities: [\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.HOST_MODE_GET,\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.HOST_EDITOR_ENTER,\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.HOST_EDITOR_WAIT_READY,\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.EDITOR_STATE_GET,\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.EDITOR_DIAGNOSTICS_LIST,\n    ],\n    fallbackTools: ['playwright', 'chrome'],\n    notes: [\n      'Use host.editor.enter instead of clicking the editor entry UI.',\n      'Use editor.diagnostics.list for the same revision-aware snapshot shown in the Validation Center.',\n    ],\n  },\n  {\n    id: 'left-hierarchy',\n    label: 'Hierarchy',\n    location: 'left',\n    purpose: 'Scene object tree, selection context, protected/locked object visibility, and hierarchy actions.',\n    primaryCapabilities: [\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.SCENE_OBJECTS_LIST,\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.OBJECT_RESOLVE,\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.SELECTION_SET,\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.OBJECT_CREATE_PRIMITIVE,\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.OBJECT_DELETE,\n    ],\n    fallbackTools: ['playwright', 'chrome'],\n    notes: [\n      'Prefer object ids from scene.objects.list or object.resolve over clicking hierarchy rows.',\n      'Creation and deletion must go through editor scene graph capabilities, not manual scene JSON edits.',\n    ],\n  },\n  {\n    id: 'center-preview',\n    label: 'Preview / Scene View',\n    location: 'center',\n    purpose: 'Rendered scene viewport, selection focus, transform gizmo, camera framing, and visual inspection.',\n    primaryCapabilities: [\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.VIEWPORT_FOCUS_OBJECT,\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.VIEWPORT_FRAME_SELECTION,\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.VIEWPORT_CAMERA_GET,\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.VIEWPORT_CAMERA_SET_PRESET,\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.VIEWPORT_CAMERA_ORBIT,\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.TRANSFORM_MOVE,\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.TRANSFORM_SET,\n    ],\n    fallbackTools: ['playwright', 'chrome', 'computer-use'],\n    notes: [\n      'Use viewport.camera.setPreset before L0 screenshots so visual evidence has a stable semantic view.',\n      'Use transform capabilities instead of dragging the gizmo when a structured transform target is known.',\n    ],\n  },\n  {\n    id: 'right-inspector',\n    label: 'Inspector',\n    location: 'right',\n    purpose: 'Selected object properties, Transform fields, project adapter sections, and editable component data.',\n    primaryCapabilities: [\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.EDITOR_STATE_GET,\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.EDITOR_DIAGNOSTICS_LIST,\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.EDITOR_SNAPSHOT_GET,\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.TRANSFORM_SET,\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.SELECTION_SET,\n    ],\n    fallbackTools: ['playwright', 'chrome'],\n    notes: [\n      'Prefer semantic capabilities for known fields; use Inspector UI only when a field has no capability yet.',\n      'Future material, shadow, and rendering property work should add focused capabilities before relying on form automation.',\n    ],\n  },\n  {\n    id: 'right-render-tabs',\n    label: 'Render / Diagnostics Tabs',\n    location: 'right',\n    purpose: 'Rendering-oriented panels, diagnostics, and project-specific inspector tabs when present.',\n    primaryCapabilities: [\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.EDITOR_STATE_GET,\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.EDITOR_SNAPSHOT_GET,\n    ],\n    fallbackTools: ['playwright', 'chrome'],\n    notes: [\n      'Treat render tab UI as fallback until rendering/shadow capabilities are added.',\n      'Capture tab screenshots as trace artifacts when using L0 fallback for visual diagnostics.',\n    ],\n  },\n  {\n    id: 'bottom-assets',\n    label: 'Asset Library',\n    location: 'bottom',\n    purpose: 'Project asset browsing, asset analysis, and asset placement into the scene.',\n    primaryCapabilities: [\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.ASSET_LIBRARY_LIST,\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.ASSET_INFO_GET,\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.ASSET_ANALYSIS_GET,\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.PREFAB_RESOLVE,\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.PREFAB_STAGE_OPEN,\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.PREFAB_STAGE_EXIT,\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.OBJECT_CREATE_FROM_ASSET,\n    ],\n    fallbackTools: ['playwright', 'chrome'],\n    notes: [\n      'Use asset.library.list and asset.analysis.get before object.createFromAsset.',\n      'Double-clicking a prefab asset opens the Prefab stage for users; agents should call prefab.resolve then prefab.stage.open.',\n      'Do not drag assets in the browser or hand-edit generated catalogs as the primary placement path.',\n    ],\n  },\n  {\n    id: 'agent-console',\n    label: 'Agent Bridge Console',\n    location: 'external-localhost',\n    purpose: 'Readonly observability for MCP health, editor sessions, capabilities, recent calls, logs, traces, diagnostics, and L0 artifacts.',\n    primaryCapabilities: [\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.EDITOR_STATE_GET,\n    ],\n    fallbackTools: ['browser', 'playwright', 'chrome'],\n    notes: [\n      'The console is an observability plane, not an editing UI.',\n      'Write L0 screenshot paths and console/page errors to /api/traces/events instead of embedding binary payloads.',\n    ],\n  },\n]);\n\nconst RECOMMENDED_OPERATION_ORDER = Object.freeze([\n  'get_bridge_health',\n  'list_editor_sessions',\n  'list_editor_capabilities',\n  'call_editor_capability(editor.ui.regions.get)',\n  'call_editor_capability(host.editor.enter)',\n  'call_editor_capability(host.editor.waitReady when needed)',\n  'L2 semantic capability for the target region',\n  'L0 browser automation only for missing capability, disconnected bridge, page load, or screenshot evidence',\n]);\n\nconst L0_FALLBACK_RULES = Object.freeze([\n  'Do not click Hierarchy rows when selection.set or object.resolve can provide the same semantic result.',\n  'Do not drag the Preview gizmo when transform.move or transform.set can express the edit.',\n  'Do not use browser screenshots for camera setup before trying viewport.camera.setPreset or viewport.camera.orbit.',\n  'Do not drag assets from the bottom panel when object.createFromAsset can place a standard asset.',\n  'When L0 fallback is required, record screenshot paths and console/page errors through Agent Operation Trace.',\n]);\n\nexport function createLocalEditorAgentBridgeUiSource<TDocument, TPatch>(\n  state: LocalEditorAgentBridgeHarnessState<TDocument, TPatch>,\n): LocalEditorAgentBridgeUiSource {\n  return {\n    getRegions() {\n      return createAgentBridgeUiRegions(state);\n    },\n  };\n}\n\nfunction createAgentBridgeUiRegions<TDocument, TPatch>(\n  state: LocalEditorAgentBridgeHarnessState<TDocument, TPatch>,\n): EditorAgentBridgeUiRegionsGetOutput {\n  return {\n    mode: state.mode,\n    editorReady: state.mode === 'editor' && !!state.session && !state.busy,\n    sessionActive: !!state.session,\n    regions: AGENT_BRIDGE_WORKSPACE_REGIONS.map(cloneRegion),\n    recommendedOperationOrder: [...RECOMMENDED_OPERATION_ORDER],\n    l0FallbackRules: [...L0_FALLBACK_RULES],\n  };\n}\n\nfunction cloneRegion(region: EditorAgentBridgeWorkspaceRegion): EditorAgentBridgeWorkspaceRegion {\n  return {\n    ...region,\n    primaryCapabilities: [...region.primaryCapabilities],\n    ...(region.fallbackTools ? { fallbackTools: [...region.fallbackTools] } : {}),\n    ...(region.notes ? { notes: [...region.notes] } : {}),\n  };\n}\n"]}
+{"version":3,"file":"ui-regions.js","sourceRoot":"","sources":["../../../src/agent-bridge/capabilities/ui-regions.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  EDITOR_AGENT_BRIDGE_CAPABILITY_ID,\n  type EditorAgentBridgeUiRegionsGetOutput,\n  type EditorAgentBridgeWorkspaceRegion,\n} from '@fps-games/editor-protocol';\nimport type { LocalEditorAgentBridgeUiSource } from '../source-types.js';\nimport type { LocalEditorAgentBridgeHarnessState } from '../shared.js';\n\nconst AGENT_BRIDGE_WORKSPACE_REGIONS: readonly EditorAgentBridgeWorkspaceRegion[] = Object.freeze([\n  {\n    id: 'top-toolbar',\n    label: 'Top Toolbar',\n    location: 'top',\n    purpose: 'Mode, transform tool, viewport utility, save/history, and Agent Bridge status controls.',\n    primaryCapabilities: [\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.HOST_MODE_GET,\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.HOST_EDITOR_ENTER,\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.HOST_EDITOR_WAIT_READY,\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.EDITOR_STATE_GET,\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.EDITOR_DIAGNOSTICS_LIST,\n    ],\n    fallbackTools: ['playwright', 'chrome'],\n    notes: [\n      'Use host.editor.enter instead of clicking the editor entry UI.',\n      'Use editor.diagnostics.list for the same revision-aware snapshot shown in the Validation Center.',\n    ],\n  },\n  {\n    id: 'left-hierarchy',\n    label: 'Hierarchy',\n    location: 'left',\n    purpose: 'Scene object tree, selection context, protected/locked object visibility, and hierarchy actions.',\n    primaryCapabilities: [\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.SCENE_OBJECTS_LIST,\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.OBJECT_RESOLVE,\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.SELECTION_SET,\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.OBJECT_CREATE_PRIMITIVE,\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.OBJECT_DELETE,\n    ],\n    fallbackTools: ['playwright', 'chrome'],\n    notes: [\n      'Prefer object ids from scene.objects.list or object.resolve over clicking hierarchy rows.',\n      'Creation and deletion must go through editor scene graph capabilities, not manual scene JSON edits.',\n    ],\n  },\n  {\n    id: 'center-preview',\n    label: 'Preview / Scene View',\n    location: 'center',\n    purpose: 'Rendered scene viewport, selection focus, transform gizmo, camera framing, and visual inspection.',\n    primaryCapabilities: [\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.VIEWPORT_FOCUS_OBJECT,\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.VIEWPORT_FRAME_SELECTION,\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.VIEWPORT_CAMERA_GET,\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.VIEWPORT_CAMERA_SET_PRESET,\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.VIEWPORT_CAMERA_ORBIT,\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.TRANSFORM_MOVE,\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.TRANSFORM_SET,\n    ],\n    fallbackTools: ['playwright', 'chrome', 'computer-use'],\n    notes: [\n      'Use viewport.camera.setPreset before L0 screenshots so visual evidence has a stable semantic view.',\n      'Use transform capabilities instead of dragging the gizmo when a structured transform target is known.',\n    ],\n  },\n  {\n    id: 'right-inspector',\n    label: 'Inspector',\n    location: 'right',\n    purpose: 'Selected object properties, Transform fields, project adapter sections, and editable component data.',\n    primaryCapabilities: [\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.EDITOR_STATE_GET,\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.EDITOR_DIAGNOSTICS_LIST,\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.EDITOR_SNAPSHOT_GET,\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.TRANSFORM_SET,\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.SELECTION_SET,\n    ],\n    fallbackTools: ['playwright', 'chrome'],\n    notes: [\n      'Prefer semantic capabilities for known fields; use Inspector UI only when a field has no capability yet.',\n      'Future material, shadow, and rendering property work should add focused capabilities before relying on form automation.',\n    ],\n  },\n  {\n    id: 'right-render-tabs',\n    label: 'Render / Diagnostics Tabs',\n    location: 'right',\n    purpose: 'Rendering-oriented panels, diagnostics, and project-specific inspector tabs when present.',\n    primaryCapabilities: [\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.EDITOR_STATE_GET,\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.EDITOR_SNAPSHOT_GET,\n    ],\n    fallbackTools: ['playwright', 'chrome'],\n    notes: [\n      'Treat render tab UI as fallback until rendering/shadow capabilities are added.',\n      'Capture tab screenshots as trace artifacts when using L0 fallback for visual diagnostics.',\n    ],\n  },\n  {\n    id: 'bottom-assets',\n    label: 'Asset Library',\n    location: 'bottom',\n    purpose: 'Project asset browsing, asset analysis, and asset placement into the scene.',\n    primaryCapabilities: [\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.ASSET_LIBRARY_LIST,\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.ASSET_INFO_GET,\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.ASSET_ANALYSIS_GET,\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.PREFAB_RESOLVE,\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.PREFAB_STAGE_OPEN,\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.PREFAB_STAGE_EXIT,\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.OBJECT_CREATE_FROM_ASSET,\n    ],\n    fallbackTools: ['playwright', 'chrome'],\n    notes: [\n      'Use asset.library.list and asset.analysis.get before object.createFromAsset.',\n      'Double-clicking a prefab asset opens the Prefab stage for users; agents should call prefab.resolve then prefab.stage.open.',\n      'Do not drag assets in the browser or hand-edit generated catalogs as the primary placement path.',\n    ],\n  },\n  {\n    id: 'bottom-console',\n    label: 'Editor Console',\n    location: 'bottom-global',\n    purpose: 'Session-scoped structured output for editor save, import, compile, run, plugin, and capability operations.',\n    primaryCapabilities: [\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.EDITOR_DIAGNOSTICS_LIST,\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.EDITOR_STATE_GET,\n    ],\n    fallbackTools: ['playwright', 'chrome'],\n    notes: [\n      'This Console is Editor-owned operation output and does not intercept browser console.* calls.',\n      'Validation Center remains the revision-aware diagnostics surface and Save/Run gate.',\n      'Agent Bridge Console remains a separate external observability plane.',\n    ],\n  },\n  {\n    id: 'agent-console',\n    label: 'Agent Bridge Console',\n    location: 'external-localhost',\n    purpose: 'Readonly observability for MCP health, editor sessions, capabilities, recent calls, logs, traces, diagnostics, and L0 artifacts.',\n    primaryCapabilities: [\n      EDITOR_AGENT_BRIDGE_CAPABILITY_ID.EDITOR_STATE_GET,\n    ],\n    fallbackTools: ['browser', 'playwright', 'chrome'],\n    notes: [\n      'The console is an observability plane, not an editing UI.',\n      'Write L0 screenshot paths and console/page errors to /api/traces/events instead of embedding binary payloads.',\n    ],\n  },\n]);\n\nconst RECOMMENDED_OPERATION_ORDER = Object.freeze([\n  'get_bridge_health',\n  'list_editor_sessions',\n  'list_editor_capabilities',\n  'call_editor_capability(editor.ui.regions.get)',\n  'call_editor_capability(host.editor.enter)',\n  'call_editor_capability(host.editor.waitReady when needed)',\n  'L2 semantic capability for the target region',\n  'L0 browser automation only for missing capability, disconnected bridge, page load, or screenshot evidence',\n]);\n\nconst L0_FALLBACK_RULES = Object.freeze([\n  'Do not click Hierarchy rows when selection.set or object.resolve can provide the same semantic result.',\n  'Do not drag the Preview gizmo when transform.move or transform.set can express the edit.',\n  'Do not use browser screenshots for camera setup before trying viewport.camera.setPreset or viewport.camera.orbit.',\n  'Do not drag assets from the bottom panel when object.createFromAsset can place a standard asset.',\n  'When L0 fallback is required, record screenshot paths and console/page errors through Agent Operation Trace.',\n]);\n\nexport function createLocalEditorAgentBridgeUiSource<TDocument, TPatch>(\n  state: LocalEditorAgentBridgeHarnessState<TDocument, TPatch>,\n): LocalEditorAgentBridgeUiSource {\n  return {\n    getRegions() {\n      return createAgentBridgeUiRegions(state);\n    },\n  };\n}\n\nfunction createAgentBridgeUiRegions<TDocument, TPatch>(\n  state: LocalEditorAgentBridgeHarnessState<TDocument, TPatch>,\n): EditorAgentBridgeUiRegionsGetOutput {\n  return {\n    mode: state.mode,\n    editorReady: state.mode === 'editor' && !!state.session && !state.busy,\n    sessionActive: !!state.session,\n    regions: AGENT_BRIDGE_WORKSPACE_REGIONS.map(cloneRegion),\n    recommendedOperationOrder: [...RECOMMENDED_OPERATION_ORDER],\n    l0FallbackRules: [...L0_FALLBACK_RULES],\n  };\n}\n\nfunction cloneRegion(region: EditorAgentBridgeWorkspaceRegion): EditorAgentBridgeWorkspaceRegion {\n  return {\n    ...region,\n    primaryCapabilities: [...region.primaryCapabilities],\n    ...(region.fallbackTools ? { fallbackTools: [...region.fallbackTools] } : {}),\n    ...(region.notes ? { notes: [...region.notes] } : {}),\n  };\n}\n"]}

package/dist/build-info.json

@@ -1,135 +1,135 @@
 {
   "schemaVersion": 1,
   "packageName": "@fps-games/editor",
-  "version": "0.2.1-beta.1",
-  "gitSha": "846bae327b1debfb8ae586d7bc7a354cbb3bd072",
-  "distHash": "ade74556aadf607a54b6b99036c3efd954d0101da481d4fba594d1905e7725e1",
-  "cacheKey": "0.2.1-beta.1-ade74556aadf",
+  "version": "0.2.1-beta.3",
+  "gitSha": "698fdec002644a60b9641c5e23b93755489e8cfe",
+  "distHash": "fcb8a51f1c5603abf0775987a7d4d1b8711c2871ca515c3711e8ec71b318aaf1",
+  "cacheKey": "0.2.1-beta.3-fcb8a51f1c56",
   "bundledPackages": [
     {
       "name": "@fps-games/babylon-renderer",
-      "version": "0.2.1-beta.1",
-      "distHash": "657e87be140dca67305023a0995a57f9a2a637e6031e2c93c6cb9c9537b0fde7"
+      "version": "0.2.1-beta.3",
+      "distHash": "f8ee94d224e29418a14c076e2087d81f59e2c81128cbde8a848ee03825e9849d"
     },
     {
       "name": "@fps-games/editor-babylon",
-      "version": "0.2.1-beta.1",
-      "distHash": "c76798b9aa7116e9a4a891ea1956581417f97eaa2ccbb4bf04ec45468b0153a9"
+      "version": "0.2.1-beta.3",
+      "distHash": "042ba72ad85a4798bc367380e57a5e9bfb118a4234bef798d102e726fb2e2d46"
     },
     {
       "name": "@fps-games/editor-browser",
-      "version": "0.2.1-beta.1",
-      "distHash": "4e508a90d6c32de362949958a8bae76a0560250ec43dc14a6d027c6f63f8d463"
+      "version": "0.2.1-beta.3",
+      "distHash": "d0ea7289047415397c5a3784f59c4f47a224591ad9f9b7413d1df830b9e82cc1"
     },
     {
       "name": "@fps-games/editor-core",
-      "version": "0.2.1-beta.1",
-      "distHash": "5a1215dbdef3bc3a3893022ebf1261157b866d555902acdf6c3e4cfb6067c644"
+      "version": "0.2.1-beta.3",
+      "distHash": "d45d91e0ead3e332bd619202c050235b34c6a53e1328d1ae3c3c42df82045e62"
     },
     {
       "name": "@fps-games/editor-forge-play",
-      "version": "0.2.1-beta.1",
+      "version": "0.2.1-beta.3",
       "distHash": "c76fb413ce05bbcae6481366d71aed662bc56c65827b6dddbde5478a2740e079"
     },
     {
       "name": "@fps-games/editor-playable-sdk",
-      "version": "0.2.1-beta.1",
-      "distHash": "94c35257d1ef392eb5585a0eb3d5a870a64bc8262898189a10dcde30be06e628"
+      "version": "0.2.1-beta.3",
+      "distHash": "1c3daa9b4125756031bda23e40640aab67f9cfc929bc577808159e3e4d5ef6eb"
     },
     {
       "name": "@fps-games/editor-protocol",
-      "version": "0.2.1-beta.1",
-      "distHash": "048d113da972fa39f4e4bd249e392a172c0f57b2b48fbcf6a8210b2c3b53bfa9"
+      "version": "0.2.1-beta.3",
+      "distHash": "085b5fd121a111de975194f4fe5c29f2f3a046294bb32a4687ff54fb5a386b26"
     },
     {
       "name": "@fps-games/editor-tooling",
-      "version": "0.2.1-beta.1",
+      "version": "0.2.1-beta.3",
       "distHash": "adb386db73f3001fecddf7a5961b1d896db58b0fc65ec30d306c41e16a887a07"
     },
     {
       "name": "@fps-games/editor-ui",
-      "version": "0.2.1-beta.1",
-      "distHash": "56fc9f9cf4ba70755aad00e6d3e0d9c98c415225420728e43b81163edf006515"
+      "version": "0.2.1-beta.3",
+      "distHash": "58b1a9a815d851715535ad7df93fd971bdc276f39195742dae79d539a62df674"
     },
     {
       "name": "@fps-games/playable-assets",
-      "version": "0.2.1-beta.1",
-      "distHash": "37a544c7fef71429562a181f3e74008b1d40ed8fcb26e19b604ddaa1298cbd18"
+      "version": "0.2.1-beta.3",
+      "distHash": "b75753686d5fd646cd3a504ad54849fa9466b7db624971208c4480c94f670736"
     },
     {
       "name": "@fps-games/playable-contracts",
-      "version": "0.2.1-beta.1",
+      "version": "0.2.1-beta.3",
       "distHash": "234d4c791465ed1911668589489210caa54c8198301b5a4ba644849c68eadbbb"
     },
     {
       "name": "@fps-games/playable-rendering",
-      "version": "0.2.1-beta.1",
+      "version": "0.2.1-beta.3",
       "distHash": "08bad015efd9c32ec9e61cb2ea826d1c87176d447ad28dea8d4604ea31de29b8"
     },
     {
       "name": "@fps-games/playable-runtime",
-      "version": "0.2.1-beta.1",
-      "distHash": "9e65be3d6503d94d2e6ae6d9bc305ad429bb395d1445d3f25260feab76abe1fc"
+      "version": "0.2.1-beta.3",
+      "distHash": "13370a129ad47a618f872b128d9d4fd6d76e7bd03bd947918383f8c3d9b3db70"
     },
     {
       "name": "@fps-games/playable-runtime-data",
-      "version": "0.2.1-beta.1",
+      "version": "0.2.1-beta.3",
       "distHash": "44bf5edaf873b0888d790a142895d24acae9896b5d38836d6cee1d85a5d9483e"
     },
     {
       "name": "@fps-games/playable-scene",
-      "version": "0.2.1-beta.1",
+      "version": "0.2.1-beta.3",
       "distHash": "c9988e0a517dbda0250812d61c3cca1b149b25ac36231f5f2b57346f3435dd92"
     },
     {
       "name": "@fps-games/plugin-api",
-      "version": "0.2.1-beta.1",
+      "version": "0.2.1-beta.3",
       "distHash": "06c15e6ba76748b069aae75d1ec325ad2842e38bad37f91a25fd878ed1bf73f6"
     },
     {
       "name": "@fps-games/plugin-assets",
-      "version": "0.2.1-beta.1",
-      "distHash": "52a05e755fa9db59f638bbf0789e0e2f3f6292705fb3c72c64ca07954a5a1790"
+      "version": "0.2.1-beta.3",
+      "distHash": "3a667ddb27a4ff89940418478fd5bd8a4945b37cdb0da03a2ccbc43ace3342be"
     },
     {
       "name": "@fps-games/plugin-hierarchy",
-      "version": "0.2.1-beta.1",
-      "distHash": "83886f88ae484caf578912b2cfc4b3782bc31843c2e0f855c1e6c887b513a425"
+      "version": "0.2.1-beta.3",
+      "distHash": "1ca61d273cf806af07368f1de4b224391b22ae72a4cbb24f39cc2ab3b70b6ed7"
     },
     {
       "name": "@fps-games/plugin-host",
-      "version": "0.2.1-beta.1",
+      "version": "0.2.1-beta.3",
       "distHash": "f46e8257e5ed78b4dff21a905d3cf7c54933a6ff1ae458ae2d73126dfc0d8f56"
     },
     {
       "name": "@fps-games/plugin-markers",
-      "version": "0.2.1-beta.1",
-      "distHash": "64081ad4672b16b6788880f848945d4d80b90e8c35e3bac5f88fa337f345866d"
+      "version": "0.2.1-beta.3",
+      "distHash": "19e1cfb54b824637347391359e289cfe034351166d0ad51ed1b4223281661b3b"
     },
     {
       "name": "@fps-games/plugin-materials",
-      "version": "0.2.1-beta.1",
-      "distHash": "435ec9725d2627951b96dff837f9042d18df06ddc3ffbb7478184e4b42e3d133"
+      "version": "0.2.1-beta.3",
+      "distHash": "6e39797ad6f3e513d2499df7525c190cf0c11c6f1c0eba8d770786327e1cd588"
     },
     {
       "name": "@fps-games/plugin-rendering",
-      "version": "0.2.1-beta.1",
-      "distHash": "eb0c6c63f051e5333baf97ef1057fb45c9c572aab550e6a953d0ca054c53e1c3"
+      "version": "0.2.1-beta.3",
+      "distHash": "4080802832051fe434ad89d2bd2b2498edb9034abb17ee06dc48d1dfea98c45d"
     },
     {
       "name": "@fps-games/plugin-scene",
-      "version": "0.2.1-beta.1",
-      "distHash": "ec52ee7f62af13bb1675f5a9329f240d51364432ddcf4df9eea5a8e9802621d4"
+      "version": "0.2.1-beta.3",
+      "distHash": "adbcf106fd86301ec624f901e8ea070827fded310c8118dfe70df212c5c7b7d2"
     },
     {
       "name": "@fps-games/plugin-shadow-map-experiment",
-      "version": "0.2.1-beta.1",
-      "distHash": "4a45a2a37921468390cefa4524a7971ce1bed7349e08ad7333af32a60f600973"
+      "version": "0.2.1-beta.3",
+      "distHash": "d550d6054766d3ba9ce5a9ada76e51ee44490c77bf15fea83362239226323135"
     },
     {
       "name": "@fps-games/plugin-shadows",
-      "version": "0.2.1-beta.1",
-      "distHash": "9d04acabad58e1daa45031532cafc3e2e19d4f50f11ec97cbb283c51d003bd2f"
+      "version": "0.2.1-beta.3",
+      "distHash": "afbc294dec97896421c113d1a232b993c796dd9ed984d8cb09190a44649ef44d"
     }
   ]
 }

package/dist/internal/material-preview.d.ts

@@ -0,0 +1,22 @@
+import type { LocalEditorBrowserMaterialPreviewCleanup, LocalEditorBrowserMaterialPreviewSource } from '@fps-games/editor-browser';
+interface NormalizedMaterialPreviewSettings {
+    baseColor: {
+        r: number;
+        g: number;
+        b: number;
+    };
+    emissionColor: {
+        r: number;
+        g: number;
+        b: number;
+    };
+    emissionIntensity: number;
+    materialKind: 'pbr' | 'standard';
+    metallic: number;
+    roughness: number;
+    textureUrl: string | null;
+}
+export declare function normalizeLocalEditorMaterialPreviewSettings(source: LocalEditorBrowserMaterialPreviewSource): NormalizedMaterialPreviewSettings;
+export declare function mountLocalEditorMaterialPreview(source: LocalEditorBrowserMaterialPreviewSource, canvas: HTMLCanvasElement): Promise<LocalEditorBrowserMaterialPreviewCleanup>;
+export {};
+//# sourceMappingURL=material-preview.d.ts.map

package/dist/internal/material-preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"material-preview.d.ts","sourceRoot":"","sources":["../../src/internal/material-preview.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wCAAwC,EACxC,uCAAuC,EACxC,MAAM,2BAA2B,CAAC;AAEnC,UAAU,iCAAiC;IACzC,SAAS,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,aAAa,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,KAAK,GAAG,UAAU,CAAC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,wBAAgB,2CAA2C,CACzD,MAAM,EAAE,uCAAuC,GAC9C,iCAAiC,CAUnC;AAED,wBAAsB,+BAA+B,CACnD,MAAM,EAAE,uCAAuC,EAC/C,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,wCAAwC,CAAC,CAoJnD"}

package/dist/internal/material-preview.js

@@ -0,0 +1,186 @@
+export function normalizeLocalEditorMaterialPreviewSettings(source) {
+    return {
+        baseColor: normalizeColor(source.preview.baseColor, { r: 0.56, g: 0.6, b: 0.66 }),
+        emissionColor: normalizeColor(source.preview.emissionColor, { r: 1, g: 1, b: 1 }),
+        emissionIntensity: clamp(source.preview.emissionIntensity ?? 0, 0, 8),
+        materialKind: source.materialKind === 'standard' ? 'standard' : 'pbr',
+        metallic: clamp(source.preview.metallic ?? 0, 0, 1),
+        roughness: clamp(source.preview.roughness ?? 0.55, 0.04, 1),
+        textureUrl: source.preview.textureUrl?.trim() || null,
+    };
+}
+export async function mountLocalEditorMaterialPreview(source, canvas) {
+    const settings = normalizeLocalEditorMaterialPreviewSettings(source);
+    const [{ Engine }, { Scene }, { ArcRotateCamera }, { DirectionalLight }, { HemisphericLight }, { MeshBuilder }, { PBRMaterial }, { StandardMaterial }, { Texture }, { Vector3 }, { Color3, Color4 },] = await Promise.all([
+        import('@babylonjs/core/Engines/engine'),
+        import('@babylonjs/core/scene'),
+        import('@babylonjs/core/Cameras/arcRotateCamera'),
+        import('@babylonjs/core/Lights/directionalLight'),
+        import('@babylonjs/core/Lights/hemisphericLight'),
+        import('@babylonjs/core/Meshes/meshBuilder'),
+        import('@babylonjs/core/Materials/PBR/pbrMaterial'),
+        import('@babylonjs/core/Materials/standardMaterial'),
+        import('@babylonjs/core/Materials/Textures/texture'),
+        import('@babylonjs/core/Maths/math.vector'),
+        import('@babylonjs/core/Maths/math.color'),
+    ]);
+    let disposed = false;
+    let engine = null;
+    let scene = null;
+    let camera = null;
+    let resizeObserver = null;
+    const cleanup = () => {
+        if (disposed)
+            return;
+        const errors = [];
+        try {
+            resizeObserver?.disconnect();
+            resizeObserver = null;
+        }
+        catch (error) {
+            errors.push(error);
+        }
+        try {
+            engine?.stopRenderLoop();
+        }
+        catch { }
+        try {
+            camera?.detachControl();
+            camera = null;
+        }
+        catch (error) {
+            errors.push(error);
+        }
+        try {
+            scene?.dispose();
+            scene = null;
+        }
+        catch (error) {
+            errors.push(error);
+        }
+        try {
+            engine?.dispose();
+            engine = null;
+        }
+        catch (error) {
+            errors.push(error);
+        }
+        disposed = !resizeObserver && !camera && !scene && !engine;
+        if (errors.length > 0) {
+            const error = new Error('Material preview cleanup failed.');
+            error.errors = errors;
+            throw error;
+        }
+    };
+    try {
+        engine = new Engine(canvas, true, {
+            antialias: true,
+            premultipliedAlpha: true,
+            preserveDrawingBuffer: true,
+            stencil: true,
+            limitDeviceRatio: 2,
+        }, true);
+        scene = new Scene(engine);
+        scene.clearColor = new Color4(0, 0, 0, 0);
+        scene.ambientColor = new Color3(0.08, 0.09, 0.1);
+        camera = new ArcRotateCamera('material-preview-camera', -Math.PI / 4, Math.PI / 2.35, 2.65, Vector3.Zero(), scene);
+        camera.lowerBetaLimit = 0.25;
+        camera.upperBetaLimit = Math.PI - 0.25;
+        camera.lowerRadiusLimit = 2.05;
+        camera.upperRadiusLimit = 4;
+        camera.wheelPrecision = 45;
+        camera.pinchPrecision = 130;
+        camera.panningSensibility = 0;
+        camera.attachControl(canvas, true);
+        const keyLight = new DirectionalLight('material-preview-key', new Vector3(0.55, -0.8, 0.65), scene);
+        keyLight.intensity = 2.15;
+        keyLight.diffuse = new Color3(1, 0.97, 0.92);
+        const rimLight = new DirectionalLight('material-preview-rim', new Vector3(-0.75, -0.25, -0.6), scene);
+        rimLight.intensity = 0.85;
+        rimLight.diffuse = new Color3(0.58, 0.72, 1);
+        const fillLight = new HemisphericLight('material-preview-fill', new Vector3(0, 1, 0), scene);
+        fillLight.intensity = 0.62;
+        fillLight.diffuse = new Color3(0.82, 0.87, 0.94);
+        fillLight.groundColor = new Color3(0.08, 0.09, 0.11);
+        const sphere = MeshBuilder.CreateSphere('material-preview-sphere', {
+            diameter: 1.72,
+            segments: 64,
+        }, scene);
+        let material;
+        if (settings.materialKind === 'standard') {
+            const standard = new StandardMaterial('material-preview-standard', scene);
+            standard.diffuseColor = new Color3(settings.baseColor.r, settings.baseColor.g, settings.baseColor.b);
+            standard.specularColor = Color3.Lerp(new Color3(0.16, 0.16, 0.16), new Color3(settings.baseColor.r, settings.baseColor.g, settings.baseColor.b), settings.metallic);
+            standard.specularPower = 4 + Math.pow(1 - settings.roughness, 2) * 252;
+            standard.emissiveColor = scaleColor(Color3, settings.emissionColor, settings.emissionIntensity);
+            material = standard;
+        }
+        else {
+            const pbr = new PBRMaterial('material-preview-pbr', scene);
+            pbr.albedoColor = new Color3(settings.baseColor.r, settings.baseColor.g, settings.baseColor.b);
+            pbr.metallic = settings.metallic;
+            pbr.roughness = settings.roughness;
+            pbr.emissiveColor = scaleColor(Color3, settings.emissionColor, settings.emissionIntensity);
+            pbr.environmentIntensity = 0.7;
+            material = pbr;
+        }
+        sphere.material = material;
+        if (settings.textureUrl) {
+            const texture = new Texture(settings.textureUrl, scene, false, true, Texture.TRILINEAR_SAMPLINGMODE);
+            if (material instanceof PBRMaterial)
+                material.albedoTexture = texture;
+            else
+                material.diffuseTexture = texture;
+        }
+        scene.imageProcessingConfiguration.toneMappingEnabled = true;
+        scene.imageProcessingConfiguration.exposure = 1.05;
+        scene.imageProcessingConfiguration.contrast = 1.08;
+        resizeObserver = typeof ResizeObserver === 'function'
+            ? new ResizeObserver(() => engine?.resize())
+            : null;
+        resizeObserver?.observe(canvas);
+        engine.resize();
+        engine.runRenderLoop(() => scene?.render());
+        return cleanup;
+    }
+    catch (error) {
+        try {
+            cleanup();
+        }
+        catch { }
+        throw error;
+    }
+}
+function normalizeColor(value, fallback) {
+    if (!value)
+        return fallback;
+    if (typeof value === 'string') {
+        const match = value.trim().match(/^#([0-9a-f]{6})$/i);
+        if (!match)
+            return fallback;
+        return {
+            r: Number.parseInt(match[1].slice(0, 2), 16) / 255,
+            g: Number.parseInt(match[1].slice(2, 4), 16) / 255,
+            b: Number.parseInt(match[1].slice(4, 6), 16) / 255,
+        };
+    }
+    return {
+        r: normalizeColorChannel(value.r),
+        g: normalizeColorChannel(value.g),
+        b: normalizeColorChannel(value.b),
+    };
+}
+function normalizeColorChannel(value) {
+    if (!Number.isFinite(value))
+        return 0;
+    return clamp(value > 1 ? value / 255 : value, 0, 1);
+}
+function scaleColor(Color3, color, intensity) {
+    return new Color3(color.r, color.g, color.b).scale(intensity);
+}
+function clamp(value, min, max) {
+    if (!Number.isFinite(value))
+        return min;
+    return Math.min(max, Math.max(min, value));
+}
+//# sourceMappingURL=material-preview.js.map

package/dist/internal/material-preview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"material-preview.js","sourceRoot":"","sources":["../../src/internal/material-preview.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  LocalEditorBrowserMaterialPreviewCleanup,\n  LocalEditorBrowserMaterialPreviewSource,\n} from '@fps-games/editor-browser';\n\ninterface NormalizedMaterialPreviewSettings {\n  baseColor: { r: number; g: number; b: number };\n  emissionColor: { r: number; g: number; b: number };\n  emissionIntensity: number;\n  materialKind: 'pbr' | 'standard';\n  metallic: number;\n  roughness: number;\n  textureUrl: string | null;\n}\n\nexport function normalizeLocalEditorMaterialPreviewSettings(\n  source: LocalEditorBrowserMaterialPreviewSource,\n): NormalizedMaterialPreviewSettings {\n  return {\n    baseColor: normalizeColor(source.preview.baseColor, { r: 0.56, g: 0.6, b: 0.66 }),\n    emissionColor: normalizeColor(source.preview.emissionColor, { r: 1, g: 1, b: 1 }),\n    emissionIntensity: clamp(source.preview.emissionIntensity ?? 0, 0, 8),\n    materialKind: source.materialKind === 'standard' ? 'standard' : 'pbr',\n    metallic: clamp(source.preview.metallic ?? 0, 0, 1),\n    roughness: clamp(source.preview.roughness ?? 0.55, 0.04, 1),\n    textureUrl: source.preview.textureUrl?.trim() || null,\n  };\n}\n\nexport async function mountLocalEditorMaterialPreview(\n  source: LocalEditorBrowserMaterialPreviewSource,\n  canvas: HTMLCanvasElement,\n): Promise<LocalEditorBrowserMaterialPreviewCleanup> {\n  const settings = normalizeLocalEditorMaterialPreviewSettings(source);\n  const [\n    { Engine },\n    { Scene },\n    { ArcRotateCamera },\n    { DirectionalLight },\n    { HemisphericLight },\n    { MeshBuilder },\n    { PBRMaterial },\n    { StandardMaterial },\n    { Texture },\n    { Vector3 },\n    { Color3, Color4 },\n  ] = await Promise.all([\n    import('@babylonjs/core/Engines/engine'),\n    import('@babylonjs/core/scene'),\n    import('@babylonjs/core/Cameras/arcRotateCamera'),\n    import('@babylonjs/core/Lights/directionalLight'),\n    import('@babylonjs/core/Lights/hemisphericLight'),\n    import('@babylonjs/core/Meshes/meshBuilder'),\n    import('@babylonjs/core/Materials/PBR/pbrMaterial'),\n    import('@babylonjs/core/Materials/standardMaterial'),\n    import('@babylonjs/core/Materials/Textures/texture'),\n    import('@babylonjs/core/Maths/math.vector'),\n    import('@babylonjs/core/Maths/math.color'),\n  ]);\n\n  let disposed = false;\n  let engine: InstanceType<typeof Engine> | null = null;\n  let scene: InstanceType<typeof Scene> | null = null;\n  let camera: InstanceType<typeof ArcRotateCamera> | null = null;\n  let resizeObserver: ResizeObserver | null = null;\n  const cleanup = (): void => {\n    if (disposed) return;\n    const errors: unknown[] = [];\n    try {\n      resizeObserver?.disconnect();\n      resizeObserver = null;\n    } catch (error) { errors.push(error); }\n    try { engine?.stopRenderLoop(); } catch {}\n    try {\n      camera?.detachControl();\n      camera = null;\n    } catch (error) { errors.push(error); }\n    try {\n      scene?.dispose();\n      scene = null;\n    } catch (error) { errors.push(error); }\n    try {\n      engine?.dispose();\n      engine = null;\n    } catch (error) { errors.push(error); }\n    disposed = !resizeObserver && !camera && !scene && !engine;\n    if (errors.length > 0) {\n      const error = new Error('Material preview cleanup failed.') as Error & { errors: unknown[] };\n      error.errors = errors;\n      throw error;\n    }\n  };\n\n  try {\n    engine = new Engine(canvas, true, {\n      antialias: true,\n      premultipliedAlpha: true,\n      preserveDrawingBuffer: true,\n      stencil: true,\n      limitDeviceRatio: 2,\n    }, true);\n    scene = new Scene(engine);\n    scene.clearColor = new Color4(0, 0, 0, 0);\n    scene.ambientColor = new Color3(0.08, 0.09, 0.1);\n\n    camera = new ArcRotateCamera(\n      'material-preview-camera',\n      -Math.PI / 4,\n      Math.PI / 2.35,\n      2.65,\n      Vector3.Zero(),\n      scene,\n    );\n    camera.lowerBetaLimit = 0.25;\n    camera.upperBetaLimit = Math.PI - 0.25;\n    camera.lowerRadiusLimit = 2.05;\n    camera.upperRadiusLimit = 4;\n    camera.wheelPrecision = 45;\n    camera.pinchPrecision = 130;\n    camera.panningSensibility = 0;\n    camera.attachControl(canvas, true);\n\n    const keyLight = new DirectionalLight('material-preview-key', new Vector3(0.55, -0.8, 0.65), scene);\n    keyLight.intensity = 2.15;\n    keyLight.diffuse = new Color3(1, 0.97, 0.92);\n    const rimLight = new DirectionalLight('material-preview-rim', new Vector3(-0.75, -0.25, -0.6), scene);\n    rimLight.intensity = 0.85;\n    rimLight.diffuse = new Color3(0.58, 0.72, 1);\n    const fillLight = new HemisphericLight('material-preview-fill', new Vector3(0, 1, 0), scene);\n    fillLight.intensity = 0.62;\n    fillLight.diffuse = new Color3(0.82, 0.87, 0.94);\n    fillLight.groundColor = new Color3(0.08, 0.09, 0.11);\n\n    const sphere = MeshBuilder.CreateSphere('material-preview-sphere', {\n      diameter: 1.72,\n      segments: 64,\n    }, scene);\n    let material: InstanceType<typeof PBRMaterial> | InstanceType<typeof StandardMaterial>;\n    if (settings.materialKind === 'standard') {\n      const standard = new StandardMaterial('material-preview-standard', scene);\n      standard.diffuseColor = new Color3(settings.baseColor.r, settings.baseColor.g, settings.baseColor.b);\n      standard.specularColor = Color3.Lerp(\n        new Color3(0.16, 0.16, 0.16),\n        new Color3(settings.baseColor.r, settings.baseColor.g, settings.baseColor.b),\n        settings.metallic,\n      );\n      standard.specularPower = 4 + Math.pow(1 - settings.roughness, 2) * 252;\n      standard.emissiveColor = scaleColor(Color3, settings.emissionColor, settings.emissionIntensity);\n      material = standard;\n    } else {\n      const pbr = new PBRMaterial('material-preview-pbr', scene);\n      pbr.albedoColor = new Color3(settings.baseColor.r, settings.baseColor.g, settings.baseColor.b);\n      pbr.metallic = settings.metallic;\n      pbr.roughness = settings.roughness;\n      pbr.emissiveColor = scaleColor(Color3, settings.emissionColor, settings.emissionIntensity);\n      pbr.environmentIntensity = 0.7;\n      material = pbr;\n    }\n    sphere.material = material;\n\n    if (settings.textureUrl) {\n      const texture = new Texture(settings.textureUrl, scene, false, true, Texture.TRILINEAR_SAMPLINGMODE);\n      if (material instanceof PBRMaterial) material.albedoTexture = texture;\n      else material.diffuseTexture = texture;\n    }\n\n    scene.imageProcessingConfiguration.toneMappingEnabled = true;\n    scene.imageProcessingConfiguration.exposure = 1.05;\n    scene.imageProcessingConfiguration.contrast = 1.08;\n    resizeObserver = typeof ResizeObserver === 'function'\n      ? new ResizeObserver(() => engine?.resize())\n      : null;\n    resizeObserver?.observe(canvas);\n    engine.resize();\n    engine.runRenderLoop(() => scene?.render());\n    return cleanup;\n  } catch (error) {\n    try { cleanup(); } catch {}\n    throw error;\n  }\n}\n\nfunction normalizeColor(\n  value: LocalEditorBrowserMaterialPreviewSource['preview']['baseColor'],\n  fallback: { r: number; g: number; b: number },\n): { r: number; g: number; b: number } {\n  if (!value) return fallback;\n  if (typeof value === 'string') {\n    const match = value.trim().match(/^#([0-9a-f]{6})$/i);\n    if (!match) return fallback;\n    return {\n      r: Number.parseInt(match[1].slice(0, 2), 16) / 255,\n      g: Number.parseInt(match[1].slice(2, 4), 16) / 255,\n      b: Number.parseInt(match[1].slice(4, 6), 16) / 255,\n    };\n  }\n  return {\n    r: normalizeColorChannel(value.r),\n    g: normalizeColorChannel(value.g),\n    b: normalizeColorChannel(value.b),\n  };\n}\n\nfunction normalizeColorChannel(value: number): number {\n  if (!Number.isFinite(value)) return 0;\n  return clamp(value > 1 ? value / 255 : value, 0, 1);\n}\n\nfunction scaleColor(\n  Color3: new(r: number, g: number, b: number) => { scale(value: number): any },\n  color: { r: number; g: number; b: number },\n  intensity: number,\n): any {\n  return new Color3(color.r, color.g, color.b).scale(intensity);\n}\n\nfunction clamp(value: number, min: number, max: number): number {\n  if (!Number.isFinite(value)) return min;\n  return Math.min(max, Math.max(min, value));\n}\n"]}

package/dist/internal/project-model-preview.d.ts

@@ -0,0 +1,4 @@
+import type { LocalEditorBrowserProjectMediaSource, LocalEditorBrowserProjectModelPreviewCleanup, LocalEditorBrowserProjectModelThumbnail } from '@fps-games/editor-browser';
+export declare function resolveLocalEditorProjectModelThumbnail(source: LocalEditorBrowserProjectMediaSource, signal?: AbortSignal): Promise<LocalEditorBrowserProjectModelThumbnail>;
+export declare function mountLocalEditorProjectModelPreview(source: LocalEditorBrowserProjectMediaSource, canvas: HTMLCanvasElement, signal?: AbortSignal): Promise<LocalEditorBrowserProjectModelPreviewCleanup>;
+//# sourceMappingURL=project-model-preview.d.ts.map

package/dist/internal/project-model-preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-model-preview.d.ts","sourceRoot":"","sources":["../../src/internal/project-model-preview.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oCAAoC,EACpC,4CAA4C,EAC5C,uCAAuC,EACxC,MAAM,2BAA2B,CAAC;AAInC,wBAAgB,uCAAuC,CACrD,MAAM,EAAE,oCAAoC,EAC5C,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,uCAAuC,CAAC,CAwBlD;AAED,wBAAsB,mCAAmC,CACvD,MAAM,EAAE,oCAAoC,EAC5C,MAAM,EAAE,iBAAiB,EACzB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,4CAA4C,CAAC,CA2HvD"}