@jgengine/editor 0.19.0 → 0.21.0

package/dist/CreatorApp.js

@@ -0,0 +1,107 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { importCreatorDocument, validateCreatorDocument } from "@jgengine/core/editor/creatorStorage";
+import { EditorApp } from "./EditorApp.js";
+/** Production creator catalog and embedded editor, reached through the game's menu.
+ * @capability player-creator create, edit, save, playtest and reopen bounded player scenes through the production editor
+ */
+export function CreatorApp({ gameId, config, onExit }) {
+    const [documents, setDocuments] = useState([]);
+    const [selected, setSelected] = useState(null);
+    const [name, setName] = useState("");
+    const [error, setError] = useState(null);
+    const [busy, setBusy] = useState(false);
+    const revision = useRef(null);
+    const pending = useRef(false);
+    const generation = useRef(0);
+    const refresh = useCallback(async () => {
+        try {
+            const values = await config.storage.list();
+            if (values.length > config.policy.maxDocuments)
+                throw new Error("Creator catalog exceeds document budget");
+            setDocuments(values);
+        }
+        catch (failure) {
+            setError(failure instanceof Error ? failure.message : String(failure));
+        }
+    }, [config]);
+    useEffect(() => { void refresh(); return () => { generation.current += 1; }; }, [refresh]);
+    const validate = useCallback((document) => { validateCreatorDocument(document, config.policy); }, [config]);
+    const playable = useMemo(() => selected === null ? null : config.createPlayable(selected.document), [selected, config]);
+    const save = useCallback(async (json) => {
+        if (selected === null || pending.current)
+            return { ok: false, error: "A save is already in progress" };
+        pending.current = true;
+        const currentGeneration = generation.current;
+        try {
+            const document = importCreatorDocument(json, config.policy);
+            const next = await config.storage.save({ ...selected, document }, revision.current);
+            if (generation.current === currentGeneration) {
+                revision.current = next.revision;
+                setError(null);
+            }
+            return { ok: true, path: next.name };
+        }
+        catch (failure) {
+            return { ok: false, error: failure instanceof Error ? failure.message : String(failure) };
+        }
+        finally {
+            pending.current = false;
+        }
+    }, [selected, config]);
+    const run = async (action) => {
+        if (busy)
+            return;
+        setBusy(true);
+        setError(null);
+        try {
+            await action();
+        }
+        catch (failure) {
+            setError(failure instanceof Error ? failure.message : String(failure));
+        }
+        finally {
+            setBusy(false);
+        }
+    };
+    const create = () => run(async () => {
+        if (documents.length >= config.policy.maxDocuments)
+            throw new Error("Creator catalog is full");
+        const document = validateCreatorDocument(config.initialDocument(), config.policy);
+        const value = await config.storage.save({ version: 1, id: config.createId?.() ?? crypto.randomUUID(), name: name.trim(), revision: 0, document }, null);
+        revision.current = value.revision;
+        setSelected(value);
+    });
+    const importFile = (file) => run(async () => {
+        if (documents.length >= config.policy.maxDocuments)
+            throw new Error("Creator catalog is full");
+        if (file.size > config.policy.maxBytes)
+            throw new Error("Scene exceeds byte budget");
+        const document = importCreatorDocument(await file.text(), config.policy);
+        const value = await config.storage.save({ version: 1, id: config.createId?.() ?? crypto.randomUUID(), name: name.trim(), revision: 0, document }, null);
+        revision.current = value.revision;
+        setSelected(value);
+    });
+    const reopen = (id) => run(async () => {
+        const value = await config.storage.load(id);
+        if (value === null)
+            throw new Error("Scene no longer exists");
+        validate(value.document);
+        revision.current = value.revision;
+        setSelected(value);
+    });
+    const returnToCatalog = () => {
+        generation.current += 1;
+        setSelected(null);
+        void refresh();
+    };
+    if (selected !== null && playable !== null) {
+        return _jsx(EditorApp, { gameId: `${gameId}:${selected.id}`, playable: playable, layers: selected.document, catalogs: playable.editorCatalogs, save: save, createPlaytest: config.createPlayable, validateDocument: validate, playerCreator: true, allowedAssets: config.policy.allowedAssets, allowedKinds: config.policy.allowedKinds, maxImportBytes: config.policy.maxBytes, creatorPolicy: config.policy, onExitEditor: returnToCatalog });
+    }
+    return (_jsxs("section", { "aria-label": "Scene creator", style: { padding: 24, color: "#eef2ff", background: "#111827", minHeight: "100%", fontFamily: "sans-serif" }, children: [_jsx("h1", { children: "Create and edit" }), _jsx("button", { type: "button", onClick: onExit, children: "Return to game" }), _jsxs("form", { onSubmit: (event) => { event.preventDefault(); void create(); }, style: { marginBlock: 24 }, children: [_jsxs("label", { children: ["Scene name ", _jsx("input", { value: name, maxLength: 80, onChange: (event) => setName(event.target.value) })] }), " ", _jsx("button", { type: "submit", disabled: busy || name.trim().length === 0 || documents.length >= config.policy.maxDocuments, children: "Create scene" })] }), _jsxs("label", { children: ["Import scene JSON ", _jsx("input", { type: "file", accept: "application/json,.json", "aria-label": "Import scene JSON", disabled: busy || name.trim().length === 0 || documents.length >= config.policy.maxDocuments, onChange: (event) => {
+                            const file = event.target.files?.[0];
+                            if (file !== undefined)
+                                void importFile(file);
+                            event.target.value = "";
+                        } })] }), _jsxs("p", { children: [documents.length, " / ", config.policy.maxDocuments, " saved scenes"] }), error === null ? null : _jsx("p", { role: "alert", children: error }), _jsx("ul", { children: documents.map((value) => _jsxs("li", { children: [value.name, " ", _jsxs("button", { type: "button", disabled: busy, onClick: () => void reopen(value.id), children: ["Edit ", value.name] })] }, value.id)) })] }));
+}

package/dist/DebugDraw.js

@@ -2,6 +2,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Html } from "@react-three/drei";
 import { memo, useEffect, useMemo } from "react";
 import * as THREE from "three";
+import { markerCatalogId } from "@jgengine/core/world/authoredObjects";
 const DEFAULT_COLORS = {
     player_spawn: "#22d3ee",
     boss: "#f43f5e",
@@ -103,10 +104,11 @@ const MarkerMesh = memo(function MarkerMesh({ marker, selected, hovered, onSelec
     const scale = selected ? 1.28 : hovered ? 1.12 : 1;
     const baseY = groundHeightAt !== undefined ? groundHeightAt(marker.position.x, marker.position.z) : marker.position.y;
     const fill = emphasisColor(selected, hovered, color);
+    const modelBacked = markerCatalogId(marker) !== null;
     return (_jsxs("group", { position: [marker.position.x, baseY + 1.2, marker.position.z], "rotation-y": marker.rotationY ?? 0, scale: scale, userData: { jgEditorId: marker.id }, onClick: (event) => {
             event.stopPropagation();
             onSelect(marker.id);
-        }, children: [_jsx("mesh", { geometry: sharedSphere, children: _jsx("meshBasicMaterial", { color: fill, transparent: true, opacity: selected ? 1 : hovered ? 0.9 : 1 }) }), selected || hovered ? (_jsx("mesh", { geometry: sharedSphere, scale: 1.18, children: _jsx("meshBasicMaterial", { color: fill, transparent: true, opacity: selected ? 0.28 : 0.18, depthWrite: false }) })) : null, _jsx("mesh", { position: [0, 1.35, 0], geometry: sharedCone, children: _jsx("meshBasicMaterial", { color: selected || hovered ? fill : color }) })] }));
+        }, children: [_jsx("mesh", { geometry: sharedSphere, children: _jsx("meshBasicMaterial", { color: fill, transparent: true, opacity: selected ? 1 : hovered ? 0.9 : 1, wireframe: modelBacked, depthWrite: !modelBacked }) }), selected || hovered ? (_jsx("mesh", { geometry: sharedSphere, scale: 1.18, children: _jsx("meshBasicMaterial", { color: fill, transparent: true, opacity: selected ? 0.28 : 0.18, wireframe: modelBacked, depthWrite: false }) })) : null, _jsx("mesh", { position: [0, 1.35, 0], geometry: sharedCone, children: _jsx("meshBasicMaterial", { color: selected || hovered ? fill : color }) })] }));
 });
 /** Shape-true wireframe — ground ring plus vertical profile for spheres, cylinders, and boxes. */
 const VolumeShapeLines = memo(function VolumeShapeLines({ volume, selected, hovered, onSelect, }) {

package/dist/EditorApp.d.ts

@@ -1,8 +1,9 @@
 import { type ComponentType } from "react";
-import type { EditorCatalogDefinition, EditorLayersInput } from "@jgengine/core/editor/index";
+import type { EditorCatalogDefinition, EditorDocument, EditorLayersInput } from "@jgengine/core/editor/index";
 import type { PlayableGame } from "@jgengine/shell/registry";
 import { type EditorNetworkPresenceInput } from "./networkSnapshot.js";
 import { type EditorRunMode } from "./session.js";
+import type { CreatorPolicy } from "@jgengine/core/editor/creatorStorage";
 /** Props for mounting the scene editor over a playable game. */
 export interface EditorAppProps {
     gameId: string;
@@ -29,6 +30,17 @@ export interface EditorAppProps {
      * standalone editor, which has no game to return to.
      */
     onExitEditor?: () => void;
+    /** Build a fresh playable from a captured document for each isolated playtest. */
+    createPlaytest?: (document: EditorDocument) => PlayableGame;
+    /** Reject document edits before they enter history, live sync, or saves. */
+    validateDocument?: (document: EditorDocument) => void;
+    /** Disable developer host publication and recovery drafts for a player creator. */
+    playerCreator?: boolean;
+    /** Catalog entries the player creator may place. */
+    allowedAssets?: readonly string[];
+    allowedKinds?: readonly string[];
+    maxImportBytes?: number;
+    creatorPolicy?: CreatorPolicy;
 }
 /** Persists an exported document JSON; resolves with where it landed or why it failed. */
 export type EditorSaveFn = (json: string) => Promise<{
@@ -37,4 +49,4 @@ export type EditorSaveFn = (json: string) => Promise<{
     error?: string;
 }>;
 /** Top-level scene editor: author spawns/zones/paths/notes visually over edit, walk, or play modes. */
-export declare function EditorApp({ gameId, playable, layers, catalogs, save, modeChip, networkPresence, onExitEditor }: EditorAppProps): import("react").JSX.Element;
+export declare function EditorApp({ gameId, playable, layers, catalogs, save, modeChip, networkPresence, onExitEditor, createPlaytest, validateDocument, playerCreator, allowedAssets, allowedKinds, maxImportBytes, creatorPolicy }: EditorAppProps): import("react").JSX.Element;

package/dist/EditorApp.js

@@ -27,6 +27,8 @@ import { createEditorHost } from "./session.js";
 import { createEditorUiStore, } from "./uiStore.js";
 import { useF2Chord } from "./useF2Chord.js";
 import { shallowArrayEqual, useStoreSelector } from "./useStoreSelector.js";
+import { EditorDocumentSaveContext, useDocumentSave } from "./useDocumentSave.js";
+import { PlayModeBar } from "./shell/PlayModeBar.js";
 function endpointSaver(gameId) {
     const endpoint = getSaveEndpoint();
     if (endpoint === null)
@@ -245,7 +247,7 @@ function resolveEditorCamera(document) {
     };
 }
 /** Top-level scene editor: author spawns/zones/paths/notes visually over edit, walk, or play modes. */
-export function EditorApp({ gameId, playable, layers, catalogs, save, modeChip, networkPresence, onExitEditor }) {
+export function EditorApp({ gameId, playable, layers, catalogs, save, modeChip, networkPresence, onExitEditor, createPlaytest, validateDocument, playerCreator, allowedAssets, allowedKinds, maxImportBytes, creatorPolicy }) {
     const resolvedModeChip = modeChip === undefined ? EditorModeChip : modeChip;
     const saveFn = useMemo(() => save ?? endpointSaver(gameId), [save, gameId]);
     const networkSnapshot = useMemo(() => buildEditorNetworkSnapshot({
@@ -263,13 +265,13 @@ export function EditorApp({ gameId, playable, layers, catalogs, save, modeChip,
     const readout = readoutStoreRef.current;
     const catalogAssets = useMemo(() => {
         try {
-            const ids = playable.game.assets.ids();
+            const ids = playable.game.assets.ids().filter((id) => allowedAssets === undefined || allowedAssets.includes(id));
             return assetsFromCatalog(ids, (id) => playable.game.assets.resolve(id));
         }
         catch {
             return [];
         }
-    }, [playable]);
+    }, [playable, allowedAssets]);
     const resolvedLayers = layers ?? playable.editorLayers;
     const host = useMemo(() => {
         const created = createEditorHost({
@@ -277,18 +279,25 @@ export function EditorApp({ gameId, playable, layers, catalogs, save, modeChip,
             layers: resolvedLayers,
             catalogs,
             assets: catalogAssets,
+            validateDocument,
+            isolatedPlaytest: createPlaytest !== undefined,
+            publishGlobal: playerCreator !== true,
+            persistAssetUrls: playerCreator !== true,
         });
         return {
             ...created,
             baselineJson: created.session.exportJson(true),
             baselineDocument: created.session.getState().document,
         };
-    }, [gameId, resolvedLayers, catalogs, catalogAssets]);
+    }, [gameId, resolvedLayers, catalogs, catalogAssets, createPlaytest, validateDocument, playerCreator]);
     useEffect(() => host.dispose, [host]);
+    const documentSave = useDocumentSave(host.session, saveFn);
     const modeStore = useMemo(() => ({ getState: host.api.getMode, subscribe: host.api.subscribeMode }), [host]);
     const mode = useStoreSelector(modeStore, (m) => m);
     const [pendingDraft, setPendingDraft] = useState(null);
     useEffect(() => {
+        if (playerCreator)
+            return;
         const draft = readDraft(gameId);
         if (draft !== null && draft !== host.baselineJson)
             setPendingDraft(draft);
@@ -306,7 +315,7 @@ export function EditorApp({ gameId, playable, layers, catalogs, save, modeChip,
                 clearTimeout(timer);
             unsubscribe();
         };
-    }, [gameId, host]);
+    }, [gameId, host, playerCreator]);
     const restoreDraft = () => {
         if (pendingDraft === null)
             return;
@@ -385,6 +394,10 @@ export function EditorApp({ gameId, playable, layers, catalogs, save, modeChip,
     }, [gameId]);
     const initialCamera = useMemo(() => resolveEditorCamera(host.session.getState().document), [host]);
     const cameraProjection = useStoreSelector(ui, (state) => state.cameraProjection);
+    const playtestPlayable = useMemo(() => {
+        const snapshot = host.api.getPlayDocument();
+        return mode === "play" && createPlaytest !== undefined && snapshot !== null ? createPlaytest(snapshot) : playable;
+    }, [mode, host, createPlaytest, playable]);
     const editorPlayable = useMemo(() => {
         const frozenLoop = {
             onInit: playable.loop.onInit,
@@ -444,15 +457,16 @@ export function EditorApp({ gameId, playable, layers, catalogs, save, modeChip,
             };
         }
         if (mode === "play") {
-            const BaseUI = playable.GameUI;
-            const BaseOverlay = playable.WorldOverlay;
+            const playtest = playtestPlayable;
+            const BaseUI = playtest.GameUI;
+            const BaseOverlay = playtest.WorldOverlay;
             const useBuiltinPlayChrome = resolvedModeChip === EditorModeChip;
             return {
-                ...playable,
+                ...playtest,
                 GameUI: function EditorPlayUi() {
                     const onExit = useCallback(() => host.api.setMode("edit"), []);
                     useF2Chord("KeyE", onExit);
-                    return (_jsxs(_Fragment, { children: [BaseUI !== undefined ? _jsx(BaseUI, {}) : null, useBuiltinPlayChrome ? (_jsx(RuntimePlayInspectorChrome, { gameId: gameId, api: host.api, onExit: onExit })) : (_jsx(EditorModeChipHost, { api: host.api, mode: "play", chip: resolvedModeChip }))] }));
+                    return (_jsxs(_Fragment, { children: [BaseUI !== undefined ? _jsx(BaseUI, {}) : null, playerCreator ? (_jsx(PlayModeBar, { gameId: gameId, api: host.api, onExit: onExit, exitLabel: "Return to editor" })) : useBuiltinPlayChrome ? (_jsx(RuntimePlayInspectorChrome, { gameId: gameId, api: host.api, onExit: onExit })) : (_jsx(EditorModeChipHost, { api: host.api, mode: "play", chip: resolvedModeChip }))] }));
                 },
                 WorldOverlay: function EditorPlayOverlay({ ctx }) {
                     return (_jsxs(_Fragment, { children: [BaseOverlay !== undefined ? _jsx(BaseOverlay, { ctx: ctx }) : null, _jsx(PerfProbe, { api: host.api }), _jsx(RuntimePlayPublisher, { api: host.api })] }));
@@ -472,8 +486,9 @@ export function EditorApp({ gameId, playable, layers, catalogs, save, modeChip,
                 loop: frozenLoop,
             };
         }
-        const WorldOverlay = function EditorOverlay() {
-            return _jsx(EditorWorldOverlay, { api: host.api, ui: ui, world: playable.game.world, readout: readout });
+        const BaseOverlay = playable.WorldOverlay;
+        const WorldOverlay = function EditorOverlay({ ctx }) {
+            return _jsxs(_Fragment, { children: [BaseOverlay !== undefined ? _jsx(BaseOverlay, { ctx: ctx }) : null, _jsx(EditorWorldOverlay, { api: host.api, ui: ui, world: playable.game.world, readout: readout })] });
         };
         const registerImportedAsset = (id, url) => {
             try {
@@ -484,7 +499,7 @@ export function EditorApp({ gameId, playable, layers, catalogs, save, modeChip,
             }
         };
         const GameUI = function EditorUi() {
-            return (_jsx(EditorChrome, { gameId: gameId, session: host.api.getSession(), api: host.api, assets: catalogAssets, ui: ui, baselineDocument: host.baselineDocument, save: saveFn, networkSnapshot: networkSnapshot, onRegisterAsset: registerImportedAsset, onExitEditor: onExitEditor }));
+            return (_jsx(EditorChrome, { gameId: gameId, session: host.api.getSession(), api: host.api, assets: catalogAssets, ui: ui, baselineDocument: host.baselineDocument, save: saveFn, networkSnapshot: networkSnapshot, onRegisterAsset: registerImportedAsset, onExitEditor: onExitEditor, allowedKinds: allowedKinds, exitLabel: playerCreator ? "Return to saved scenes" : undefined, maxImportBytes: maxImportBytes, draftAutosave: playerCreator !== true, creatorPolicy: creatorPolicy, ...(playerCreator ? { importAsset: async () => { throw new Error("Choose an asset from the approved catalog"); } } : {}) }));
         };
         return {
             ...playable,
@@ -496,10 +511,10 @@ export function EditorApp({ gameId, playable, layers, catalogs, save, modeChip,
             // WorldOverlay above is the editor layers, not PandoraViewmodel.
             camera: inspectionCamera,
         };
-    }, [playable, host, gameId, initialCamera, cameraProjection, catalogAssets, ui, readout, mode, saveFn, resolvedModeChip, networkSnapshot, onExitEditor]);
+    }, [playable, host, gameId, initialCamera, cameraProjection, catalogAssets, ui, readout, mode, saveFn, resolvedModeChip, networkSnapshot, onExitEditor, playtestPlayable, allowedKinds, playerCreator, maxImportBytes, creatorPolicy]);
     const showElevation = useStoreSelector(ui, (s) => s.showElevation);
     const onPanelCommit = useCallback((id, panel) => {
         host.session.dispatch({ type: "setUiPanel", id, patch: panel });
     }, [host]);
-    return (_jsxs("div", { className: "relative h-full w-full bg-neutral-950", "data-jg-editor": "1", "data-jg-editor-game": gameId, children: [_jsx(HudLayoutPersistProvider, { onPanelCommit: onPanelCommit, children: _jsx(GamePlayerShell, { playable: editorPlayable }) }), mode === "edit" && showElevation ? _jsx(TerrainReadoutHud, { readout: readout }) : null, pendingDraft !== null && mode === "edit" ? (_jsxs("div", { className: "absolute left-1/2 top-14 z-[60] flex -translate-x-1/2 items-center gap-3 rounded-xl border border-amber-400/30 bg-amber-950/90 px-4 py-2 text-xs text-amber-100 shadow-2xl shadow-black/50 backdrop-blur-md", children: [_jsx("span", { children: "Unsaved edits from a previous session found." }), _jsx("button", { type: "button", className: "rounded-md bg-gradient-to-b from-amber-500 to-amber-600 px-2.5 py-1 font-semibold text-white shadow-md shadow-amber-950/50 transition-colors hover:from-amber-400 hover:to-amber-500", onClick: restoreDraft, children: "Restore" }), _jsx("button", { type: "button", className: "rounded-md bg-white/[0.07] px-2.5 py-1 ring-1 ring-inset ring-white/[0.06] transition-colors hover:bg-white/15", onClick: discardDraft, children: "Discard" })] })) : null] }));
+    return (_jsxs("div", { className: "relative h-full w-full bg-neutral-950", "data-jg-editor": "1", "data-jg-editor-game": gameId, children: [_jsx(HudLayoutPersistProvider, { onPanelCommit: onPanelCommit, children: _jsx(EditorDocumentSaveContext.Provider, { value: documentSave, children: _jsx(GamePlayerShell, { playable: editorPlayable }, mode) }) }), mode === "edit" && showElevation ? _jsx(TerrainReadoutHud, { readout: readout }) : null, pendingDraft !== null && mode === "edit" ? (_jsxs("div", { className: "absolute left-1/2 top-14 z-[60] flex -translate-x-1/2 items-center gap-3 rounded-xl border border-amber-400/30 bg-amber-950/90 px-4 py-2 text-xs text-amber-100 shadow-2xl shadow-black/50 backdrop-blur-md", children: [_jsx("span", { children: "Unsaved edits from a previous session found." }), _jsx("button", { type: "button", className: "rounded-md bg-gradient-to-b from-amber-500 to-amber-600 px-2.5 py-1 font-semibold text-white shadow-md shadow-amber-950/50 transition-colors hover:from-amber-400 hover:to-amber-500", onClick: restoreDraft, children: "Restore" }), _jsx("button", { type: "button", className: "rounded-md bg-white/[0.07] px-2.5 py-1 ring-1 ring-inset ring-white/[0.06] transition-colors hover:bg-white/15", onClick: discardDraft, children: "Discard" })] })) : null] }));
 }

package/dist/EditorChrome.d.ts

@@ -4,13 +4,15 @@ import type { EditorHostApi } from "./session.js";
 import { type AssetImporter } from "./assetImport.js";
 import { type EditorUiStore } from "./uiStore.js";
 import type { EditorNetworkSnapshot } from "./networkSnapshot.js";
+import { type EditorDocumentSave } from "./useDocumentSave.js";
+import type { CreatorPolicy } from "@jgengine/core/editor/creatorStorage";
 /**
  * The full editor UI shell — global app bar, contextual scene toolbar, workspace rail, resizable
  * hierarchy/inspector docks, tabbed bottom dock (content browser, console, profiler, AI
  * assistant), viewport overlays, and status bar — wired to the session, UI store, layout store,
  * and host RPC. Mounted by `EditorApp`; not a game-author entry point.
  */
-export declare function EditorChrome({ gameId, session, api, assets, ui, baselineDocument, save, networkSnapshot, importAsset, onRegisterAsset, onExitEditor, }: {
+export declare function EditorChrome({ gameId, session, api, assets, ui, baselineDocument, save, networkSnapshot, importAsset, onRegisterAsset, onExitEditor, allowedKinds, exitLabel, maxImportBytes, documentSave, draftAutosave, creatorPolicy, }: {
     gameId: string;
     session: EditorSession;
     api: EditorHostApi;
@@ -25,6 +27,12 @@ export declare function EditorChrome({ gameId, session, api, assets, ui, baselin
     }>;
     /** Closes the editor and returns to the game; set only when summoned over a game. Shows "Exit to game". */
     onExitEditor?: () => void;
+    allowedKinds?: readonly string[];
+    exitLabel?: string;
+    maxImportBytes?: number;
+    documentSave?: EditorDocumentSave;
+    draftAutosave?: boolean;
+    creatorPolicy?: CreatorPolicy;
     /**
      * Network workspace inspection payload (adapter config + optional host presence).
      * Built by `EditorApp` from the game definition; live presence rows only when the host injects them.

package/dist/EditorChrome.js

@@ -1,5 +1,5 @@
 import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { useContext, useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { editorDocumentSize, editorParentOf, extractEditorFragment, } from "@jgengine/core/editor/index";
 import { scatterRegionEstimate, SCATTER_PATH_KIND } from "@jgengine/core/world/scatterRegion";
 import { editorAssetFromImport, mergeEditorAssets, } from "./AssetBrowser.js";
@@ -7,6 +7,9 @@ import { CatalogsPanel } from "./CatalogsPanel.js";
 import { CollectionsPanel } from "./CollectionsPanel.js";
 import { EditorContextMenu } from "./EditorContextMenu.js";
 import { ParentPickerMenu } from "./ParentPickerMenu.js";
+import { modelWithAuthoredMaterials } from "@jgengine/core/editor/materialAuthoring";
+import { modelWithAuthoredNodeVisibility } from "@jgengine/core/editor/modelNodeVisibility";
+import { MaterialPreview } from "./MaterialPreview.js";
 import { MaterialsWorkspacePanel } from "./MaterialsWorkspacePanel.js";
 import { PrefabsPanel } from "./PrefabsPanel.js";
 import { listParentCandidates } from "./parentCandidates.js";
@@ -37,6 +40,7 @@ import { createPerfHistoryStore } from "./shell/perfHistory.js";
 import { BORDER, FOCUS_RING } from "./shell/theme.js";
 import { IconButton, Kbd, PanelResizer } from "./shell/ui.js";
 import { ScriptingPanel } from "./ScriptingPanel.js";
+import { EditorDocumentSaveContext, useDocumentSave } from "./useDocumentSave.js";
 let clipboardFragment = null;
 const SHORTCUTS = [
     { keys: "W / E / R", action: "Move · rotate · scale gizmo" },
@@ -72,34 +76,6 @@ function downloadText(filename, text) {
     anchor.click();
     URL.revokeObjectURL(url);
 }
-function useDocumentSave(session, save, onResult) {
-    const [saveState, setSaveState] = useState("idle");
-    const [saveError, setSaveError] = useState(null);
-    const [lastSavedAt, setLastSavedAt] = useState(null);
-    const savedDocRef = useRef(session.getState().document);
-    const dirty = session.getState().document !== savedDocRef.current;
-    const doSave = () => {
-        if (save === undefined || saveState === "saving")
-            return;
-        const document = session.getState().document;
-        setSaveState("saving");
-        void save(session.exportJson(true)).then((result) => {
-            if (result.ok) {
-                savedDocRef.current = document;
-                setSaveError(null);
-                setSaveState("saved");
-                setLastSavedAt(Date.now());
-                onResult?.(true, result.path === undefined ? "Scene saved" : `Scene saved to ${result.path}`);
-            }
-            else {
-                setSaveError(result.error ?? "save failed");
-                setSaveState("error");
-                onResult?.(false, `Save failed: ${result.error ?? "unknown error"}`);
-            }
-        });
-    };
-    return { available: save !== undefined, dirty, saveState, saveError, lastSavedAt, doSave };
-}
 const LEFT_PAGES = [
     { id: "hierarchy", label: "Hierarchy" },
     { id: "collections", label: "Sets" },
@@ -114,7 +90,7 @@ const ANIMATION_DOCK_HEIGHT = 400;
  * assistant), viewport overlays, and status bar — wired to the session, UI store, layout store,
  * and host RPC. Mounted by `EditorApp`; not a game-author entry point.
  */
-export function EditorChrome({ gameId, session, api, assets, ui, baselineDocument, save, networkSnapshot, importAsset = importAssetToHost, onRegisterAsset, onExitEditor, }) {
+export function EditorChrome({ gameId, session, api, assets, ui, baselineDocument, save, networkSnapshot, importAsset = importAssetToHost, onRegisterAsset, onExitEditor, allowedKinds, exitLabel, maxImportBytes, documentSave, draftAutosave = true, creatorPolicy, }) {
     const layoutRef = useRef(null);
     layoutRef.current ??= createShellLayoutStore(gameId);
     const layout = layoutRef.current;
@@ -128,6 +104,8 @@ export function EditorChrome({ gameId, session, api, assets, ui, baselineDocumen
     /** Models added this session via Content Browser Import / drop — merged over the game catalog. */
     const [importedAssets, setImportedAssets] = useState([]);
     const [importBusy, setImportBusy] = useState(false);
+    const [materialInventory, setMaterialInventory] = useState(null);
+    const [materialPreviewFailure, setMaterialPreviewFailure] = useState(null);
     // Bridge global RPC/agent console emits into the dock console for this chrome instance.
     useEffect(() => installEditorConsoleSink((severity, source, message) => {
         consoleStore.log(severity, source, message);
@@ -156,7 +134,44 @@ export function EditorChrome({ gameId, session, api, assets, ui, baselineDocumen
     const state = session.getState();
     const uiState = ui.getState();
     const layoutState = layout.getState();
-    const docSave = useDocumentSave(session, save, (ok, detail) => consoleStore.log(ok ? "info" : "error", "save", detail));
+    const materialMarker = state.document.markers.find((item) => state.selection.includes(item.id));
+    const materialSourceUrl = liveAssets.find((item) => item.id === (materialMarker?.catalogId ?? materialMarker?.meta?.catalogId))?.url;
+    const materialPreviewConfig = useMemo(() => {
+        try {
+            return { model: materialSourceUrl && materialMarker ? modelWithAuthoredNodeVisibility(modelWithAuthoredMaterials({ url: materialSourceUrl, targetHeight: 1.8, animation: "none" }, state.document, materialMarker.id), materialMarker) : undefined, error: null };
+        }
+        catch (failure) {
+            return { model: undefined, error: failure instanceof Error ? failure.message : String(failure) };
+        }
+    }, [materialSourceUrl, materialMarker, state.document]);
+    const materialSourceKey = JSON.stringify([materialMarker?.id, materialSourceUrl, materialPreviewConfig]);
+    const materialMarkerId = materialMarker?.id;
+    useEffect(() => {
+        if (layoutState.workspace !== "materials" || !materialMarkerId || !materialSourceUrl)
+            return;
+        if (api.getMaterialSlots(materialMarkerId).status === "ready")
+            return;
+        api.reportMaterialSlots(materialMarkerId, materialSourceUrl, materialPreviewConfig.error
+            ? { status: "unavailable", reason: materialPreviewConfig.error }
+            : { status: "loading" });
+        return () => {
+            const current = api.getMaterialSlots(materialMarkerId);
+            if (current.sourceUrl === materialSourceUrl && current.status === "loading")
+                api.reportMaterialSlots(materialMarkerId, materialSourceUrl, { status: "unavailable", reason: "The model preview closed before slot inspection completed." });
+        };
+    }, [api, materialMarkerId, materialSourceUrl, layoutState.workspace, materialPreviewConfig.error]);
+    const reportMaterialSlots = useCallback((slots) => {
+        if (materialMarkerId && materialSourceUrl && api.reportMaterialSlots(materialMarkerId, materialSourceUrl, { status: "ready", slots }))
+            setMaterialInventory({ source: materialSourceKey, slots });
+    }, [api, materialMarkerId, materialSourceUrl, materialSourceKey]);
+    const reportMaterialError = useCallback((message) => {
+        setMaterialPreviewFailure({ source: materialSourceKey, message });
+        if (message && materialMarkerId && materialSourceUrl && api.getMaterialSlots(materialMarkerId).status !== "ready")
+            api.reportMaterialSlots(materialMarkerId, materialSourceUrl, { status: "unavailable", reason: message });
+    }, [api, materialMarkerId, materialSourceUrl, materialSourceKey]);
+    const sharedSave = useContext(EditorDocumentSaveContext) ?? documentSave;
+    const localSave = useDocumentSave(session, sharedSave === undefined ? save : undefined, (ok, detail) => consoleStore.log(ok ? "info" : "error", "save", detail));
+    const docSave = sharedSave ?? localSave;
     const docSaveRef = useRef(docSave);
     docSaveRef.current = docSave;
     const outlinerGroups = useMemo(() => buildOutlinerGroups(state.document), [state.document]);
@@ -577,6 +592,10 @@ export function EditorChrome({ gameId, session, api, assets, ui, baselineDocumen
         }
     }, [importAsset, importBusy, layout, notify, onRegisterAsset]);
     const importFile = (file) => {
+        if (maxImportBytes !== undefined && file.size > maxImportBytes) {
+            notify("Import failed: scene exceeds byte budget", "error");
+            return;
+        }
         void file.text().then((text) => {
             try {
                 session.dispatch({ type: "importJson", json: text });
@@ -681,12 +700,12 @@ export function EditorChrome({ gameId, session, api, assets, ui, baselineDocumen
     const railActive = uiState.tool === "terrain" ? "terrain" : layoutState.workspace;
     // Only advertise the exit chord when there is a game to return to.
     const shortcuts = onExitEditor !== undefined ? [...SHORTCUTS, { keys: "F2+Q", action: "Exit editor to game" }] : SHORTCUTS;
-    return (_jsxs("div", { className: "pointer-events-none absolute inset-0 z-50 flex flex-col text-xs text-neutral-100", children: [_jsx(TopAppBar, { gameId: gameId, onExitToGame: onExitEditor, dirty: dirty, saveState: docSave.saveState, lastSavedAt: docSave.lastSavedAt, saveAvailable: docSave.available, saveError: docSave.saveError, canUndo: session.canUndo(), canRedo: session.canRedo(), onUndo: () => session.dispatch({ type: "undo" }), onRedo: () => session.dispatch({ type: "redo" }), onSave: docSave.doSave, onPlay: () => api.setMode("play"), onWalk: () => api.setMode("walk"), onHud: () => api.setMode("hud"), onImport: () => importInputRef.current?.click(), onExport: exportJson, onCopyJson: copyExportJson, onOpenPalette: () => setPaletteQuery(""), onToggleHelp: () => setHelpOpen((value) => !value), onResetLayout: () => layout.reset() }), _jsx("input", { ref: importInputRef, type: "file", accept: "application/json,.json", className: "hidden", onChange: (event) => {
+    return (_jsxs("div", { className: "pointer-events-none absolute inset-0 z-50 flex flex-col text-xs text-neutral-100", children: [_jsx(TopAppBar, { exitLabel: exitLabel, gameId: gameId, onExitToGame: onExitEditor, dirty: dirty, saveState: docSave.saveState, lastSavedAt: docSave.lastSavedAt, saveAvailable: docSave.available, saveError: docSave.saveError, canUndo: session.canUndo(), canRedo: session.canRedo(), onUndo: () => session.dispatch({ type: "undo" }), onRedo: () => session.dispatch({ type: "redo" }), onSave: docSave.doSave, onPlay: () => api.setMode("play"), onWalk: () => api.setMode("walk"), onHud: () => api.setMode("hud"), onImport: () => importInputRef.current?.click(), onExport: exportJson, onCopyJson: copyExportJson, onOpenPalette: () => setPaletteQuery(""), onToggleHelp: () => setHelpOpen((value) => !value), onResetLayout: () => layout.reset() }), _jsx("input", { ref: importInputRef, type: "file", accept: "application/json,.json", className: "hidden", onChange: (event) => {
                     const file = event.target.files?.[0];
                     if (file !== undefined)
                         importFile(file);
                     event.target.value = "";
-                } }), _jsx(SceneToolbar, { tool: uiState.tool, gizmoMode: uiState.gizmoMode, gizmoSpace: uiState.gizmoSpace, gizmoPivot: uiState.gizmoPivot, snapMode: uiState.snapMode, gridSize: uiState.gridSize, rotationSnapDeg: uiState.rotationSnapDeg, scaleSnap: uiState.scaleSnap, cameraProjection: uiState.cameraProjection, showGrid: uiState.showGrid, showContours: uiState.showContours, showSurfaceGrid: uiState.showSurfaceGrid, showElevation: uiState.showElevation, placementActive: placement !== null, onSetTool: (tool) => ui.setTool(tool), onSetGizmoMode: (mode) => ui.patch({ gizmoMode: mode }), onSetGizmoSpace: (space) => ui.patch({ gizmoSpace: space }), onSetGizmoPivot: (pivot) => ui.patch({ gizmoPivot: pivot }), onSetSnapMode: (mode) => ui.patch({ snapMode: mode }), onSetGridSize: (size) => ui.patch({ gridSize: size }), onSetRotationSnapDeg: (deg) => ui.patch({ rotationSnapDeg: deg }), onSetScaleSnap: (snap) => ui.patch({ scaleSnap: snap }), onSetCameraProjection: (projection) => ui.patch({ cameraProjection: projection }), onToggleGrid: () => ui.patch({ showGrid: !uiState.showGrid }), onToggleContours: () => ui.patch({ showContours: !uiState.showContours }), onToggleSurfaceGrid: () => ui.patch({ showSurfaceGrid: !uiState.showSurfaceGrid }), onToggleElevation: () => ui.patch({ showElevation: !uiState.showElevation }), onFrame: () => {
+                } }), _jsx(SceneToolbar, { allowedKinds: allowedKinds, tool: uiState.tool, gizmoMode: uiState.gizmoMode, gizmoSpace: uiState.gizmoSpace, gizmoPivot: uiState.gizmoPivot, snapMode: uiState.snapMode, gridSize: uiState.gridSize, rotationSnapDeg: uiState.rotationSnapDeg, scaleSnap: uiState.scaleSnap, cameraProjection: uiState.cameraProjection, showGrid: uiState.showGrid, showContours: uiState.showContours, showSurfaceGrid: uiState.showSurfaceGrid, showElevation: uiState.showElevation, placementActive: placement !== null, onSetTool: (tool) => ui.setTool(tool), onSetGizmoMode: (mode) => ui.patch({ gizmoMode: mode }), onSetGizmoSpace: (space) => ui.patch({ gizmoSpace: space }), onSetGizmoPivot: (pivot) => ui.patch({ gizmoPivot: pivot }), onSetSnapMode: (mode) => ui.patch({ snapMode: mode }), onSetGridSize: (size) => ui.patch({ gridSize: size }), onSetRotationSnapDeg: (deg) => ui.patch({ rotationSnapDeg: deg }), onSetScaleSnap: (snap) => ui.patch({ scaleSnap: snap }), onSetCameraProjection: (projection) => ui.patch({ cameraProjection: projection }), onToggleGrid: () => ui.patch({ showGrid: !uiState.showGrid }), onToggleContours: () => ui.patch({ showContours: !uiState.showContours }), onToggleSurfaceGrid: () => ui.patch({ showSurfaceGrid: !uiState.showSurfaceGrid }), onToggleElevation: () => ui.patch({ showElevation: !uiState.showElevation }), onFrame: () => {
                     const selected = session.getState().selection[0];
                     if (selected !== undefined)
                         api.handle({ method: "camera_goto", id: selected });
@@ -708,7 +727,7 @@ export function EditorChrome({ gameId, session, api, assets, ui, baselineDocumen
                                                             : null;
                                                 const selected = layoutState.leftPage === page.id;
                                                 return (_jsxs("button", { type: "button", role: "tab", "aria-selected": selected, onClick: () => layout.patch({ leftPage: page.id }), className: `flex h-6.5 items-center gap-1 rounded-[5px] px-2 text-[11px] transition-colors ${FOCUS_RING} ${selected ? "bg-white/[0.08] text-neutral-100" : "text-neutral-500 hover:bg-white/[0.04] hover:text-neutral-300"}`, children: [page.label, badge !== null && badge > 0 ? _jsx("span", { className: "text-[9px] tabular-nums text-neutral-500", children: badge }) : null] }, page.id));
-                                            })), _jsx(IconButton, { icon: "close", label: "Collapse left panel", size: 11, tone: "ghost", className: "ml-auto", onClick: () => layout.patch({ leftOpen: false }) })] }), layoutState.workspace === "multiplayer" ? (_jsx(NetworkWorkspacePanel, { snapshot: networkSnapshot })) : layoutState.workspace === "materials" ? (_jsx(MaterialsWorkspacePanel, { session: session, api: api })) : layoutState.workspace === "scripting" ? (_jsx(ScriptingPanel, { session: session, api: api })) : layoutState.leftPage === "collections" ? (_jsx(CollectionsPanel, { session: session })) : layoutState.leftPage === "prefabs" ? (_jsx(PrefabsPanel, { session: session, api: api })) : layoutState.leftPage === "catalogs" ? (_jsx(CatalogsPanel, { session: session, definitions: api.getCatalogDefinitions() })) : (_jsx(HierarchyPanel, { session: session, api: api, onAdd: () => setPaletteQuery("add "), onRowContextMenu: (point, id) => {
+                                            })), _jsx(IconButton, { icon: "close", label: "Collapse left panel", size: 11, tone: "ghost", className: "ml-auto", onClick: () => layout.patch({ leftOpen: false }) })] }), layoutState.workspace === "multiplayer" ? (_jsx(NetworkWorkspacePanel, { snapshot: networkSnapshot })) : layoutState.workspace === "materials" ? (_jsx(MaterialsWorkspacePanel, { session: session, api: api, materialSlots: materialInventory?.source === materialSourceKey ? materialInventory.slots : [], previewError: materialPreviewConfig.error ?? (materialPreviewFailure?.source === materialSourceKey ? materialPreviewFailure.message : null), onSave: docSave.available ? docSave.doSave : undefined, preview: (asset, mode) => materialPreviewConfig.error || (!materialPreviewConfig.model && !asset) ? null : _jsx(MaterialPreview, { asset: asset, mode: mode, model: materialPreviewConfig.model, onSlots: reportMaterialSlots, onError: reportMaterialError, environment: state.document.environment }) })) : layoutState.workspace === "scripting" ? (_jsx(ScriptingPanel, { session: session, api: api })) : layoutState.leftPage === "collections" ? (_jsx(CollectionsPanel, { session: session })) : layoutState.leftPage === "prefabs" ? (_jsx(PrefabsPanel, { session: session, api: api })) : layoutState.leftPage === "catalogs" ? (_jsx(CatalogsPanel, { session: session, definitions: api.getCatalogDefinitions() })) : (_jsx(HierarchyPanel, { session: session, api: api, onAdd: () => setPaletteQuery("add "), onRowContextMenu: (point, id) => {
                                             const current = session.getState().selection;
                                             if (!current.includes(id))
                                                 session.dispatch({ type: "select", ids: [id] });
@@ -756,5 +775,5 @@ export function EditorChrome({ gameId, session, api, assets, ui, baselineDocumen
                                         ["profiler", "Profiler"],
                                         ["animation", "Animation"],
                                         ["assistant", "AI Assistant"],
-                                    ].map(([id, label]) => (_jsx("button", { type: "button", onClick: () => openBottomTab(id), className: `rounded-[4px] px-2 py-0.5 text-[10px] text-neutral-500 transition-colors hover:bg-white/[0.05] hover:text-neutral-300 ${FOCUS_RING}`, children: label }, id))), _jsx("span", { className: "ml-auto text-[9px] text-neutral-600", children: "Ctrl+B opens the content browser" })] }))] }), layoutState.rightOpen ? (_jsxs(_Fragment, { children: [_jsx(PanelResizer, { orientation: "vertical", label: "Resize inspector panel", sign: -1, onResize: (delta) => layout.resize("rightWidth", delta) }), _jsx("aside", { className: `pointer-events-auto hidden min-h-0 flex-col overflow-hidden border-l ${BORDER} bg-[#111318] md:flex`, style: { width: layoutState.rightWidth }, "aria-label": "Inspector dock", children: _jsx(InspectorPanel, { session: session, ui: ui, api: api, assets: liveAssets, tab: layoutState.inspectorTab, onSelectTab: (tab) => layout.patch({ inspectorTab: tab }), collapsed: layoutState.collapsed, onToggleSection: (id) => layout.toggleSection(id), onClose: () => layout.patch({ rightOpen: false }) }) })] })) : null] }), _jsx(StatusBar, { api: api, history: perfHistory, objects: sceneStats.objects, foliage: sceneStats.foliage, selectionCount: state.selection.length, autosave: true }), paletteQuery !== null ? (_jsx(CommandPalette, { commands: paletteCommands, initialQuery: paletteQuery, onClose: () => setPaletteQuery(null) })) : null, helpOpen ? (_jsx("div", { className: "pointer-events-auto absolute inset-0 z-[70] flex items-center justify-center bg-black/50 backdrop-blur-[2px]", onClick: () => setHelpOpen(false), children: _jsxs("div", { className: "w-[28rem] max-w-[90vw] rounded-[10px] border border-white/10 bg-[#14171d] p-5 shadow-2xl shadow-black/60", onClick: (event) => event.stopPropagation(), role: "dialog", "aria-label": "Keyboard shortcuts", children: [_jsxs("div", { className: "mb-3 flex items-center", children: [_jsxs("div", { className: "flex items-center gap-2 text-sm font-semibold tracking-wide text-neutral-100", children: [_jsx(Icon, { name: "command", size: 15, className: "text-cyan-300" }), "Keyboard shortcuts"] }), _jsx(IconButton, { icon: "close", label: "Close shortcuts", tone: "ghost", className: "ml-auto", onClick: () => setHelpOpen(false) })] }), _jsx("div", { className: "grid max-h-[60vh] grid-cols-[auto_1fr] items-center gap-x-4 gap-y-1.5 overflow-auto", children: shortcuts.map((entry) => (_jsxs("div", { className: "contents", children: [_jsx("span", { className: "justify-self-start", children: _jsx(Kbd, { children: entry.keys }) }), _jsx("span", { className: "text-neutral-300", children: entry.action })] }, entry.keys))) })] }) })) : null] }));
+                                    ].map(([id, label]) => (_jsx("button", { type: "button", onClick: () => openBottomTab(id), className: `rounded-[4px] px-2 py-0.5 text-[10px] text-neutral-500 transition-colors hover:bg-white/[0.05] hover:text-neutral-300 ${FOCUS_RING}`, children: label }, id))), _jsx("span", { className: "ml-auto text-[9px] text-neutral-600", children: "Ctrl+B opens the content browser" })] }))] }), layoutState.rightOpen ? (_jsxs(_Fragment, { children: [_jsx(PanelResizer, { orientation: "vertical", label: "Resize inspector panel", sign: -1, onResize: (delta) => layout.resize("rightWidth", delta) }), _jsx("aside", { className: `pointer-events-auto hidden min-h-0 flex-col overflow-hidden border-l ${BORDER} bg-[#111318] md:flex`, style: { width: layoutState.rightWidth }, "aria-label": "Inspector dock", children: _jsx(InspectorPanel, { creatorPolicy: creatorPolicy, session: session, ui: ui, api: api, assets: liveAssets, tab: layoutState.inspectorTab, onSelectTab: (tab) => layout.patch({ inspectorTab: tab }), collapsed: layoutState.collapsed, onToggleSection: (id) => layout.toggleSection(id), onClose: () => layout.patch({ rightOpen: false }) }) })] })) : null] }), _jsx(StatusBar, { api: api, history: perfHistory, objects: sceneStats.objects, foliage: sceneStats.foliage, selectionCount: state.selection.length, autosave: draftAutosave }), paletteQuery !== null ? (_jsx(CommandPalette, { commands: paletteCommands, initialQuery: paletteQuery, onClose: () => setPaletteQuery(null) })) : null, helpOpen ? (_jsx("div", { className: "pointer-events-auto absolute inset-0 z-[70] flex items-center justify-center bg-black/50 backdrop-blur-[2px]", onClick: () => setHelpOpen(false), children: _jsxs("div", { className: "w-[28rem] max-w-[90vw] rounded-[10px] border border-white/10 bg-[#14171d] p-5 shadow-2xl shadow-black/60", onClick: (event) => event.stopPropagation(), role: "dialog", "aria-label": "Keyboard shortcuts", children: [_jsxs("div", { className: "mb-3 flex items-center", children: [_jsxs("div", { className: "flex items-center gap-2 text-sm font-semibold tracking-wide text-neutral-100", children: [_jsx(Icon, { name: "command", size: 15, className: "text-cyan-300" }), "Keyboard shortcuts"] }), _jsx(IconButton, { icon: "close", label: "Close shortcuts", tone: "ghost", className: "ml-auto", onClick: () => setHelpOpen(false) })] }), _jsx("div", { className: "grid max-h-[60vh] grid-cols-[auto_1fr] items-center gap-x-4 gap-y-1.5 overflow-auto", children: shortcuts.map((entry) => (_jsxs("div", { className: "contents", children: [_jsx("span", { className: "justify-self-start", children: _jsx(Kbd, { children: entry.keys }) }), _jsx("span", { className: "text-neutral-300", children: entry.action })] }, entry.keys))) })] }) })) : null] }));
 }

package/dist/InspectorPanel.d.ts

@@ -1,3 +1,4 @@
+import type { CreatorPolicy } from "@jgengine/core/editor/creatorStorage";
 import { type EditorSession } from "@jgengine/core/editor/index";
 import { type EditorAssetEntry } from "./AssetBrowser.js";
 import type { EditorHostApi } from "./session.js";
@@ -10,9 +11,10 @@ import type { InspectorTab } from "./shell/layoutStore.js";
  * `pathPoint` slice, so UI-only churn never rerenders it on `EditorChrome`'s render tick.
  * @internal — mounted by `EditorChrome` inside the right dock.
  */
-export declare function InspectorPanel({ session, ui, onClose, api, assets, tab, onSelectTab, collapsed, onToggleSection, }: {
+export declare function InspectorPanel({ session, ui, onClose, api, assets, tab, onSelectTab, collapsed, onToggleSection, creatorPolicy, }: {
     session: EditorSession;
     ui: EditorUiStore;
+    creatorPolicy?: CreatorPolicy;
     onClose?: () => void;
     /** Host API for RPC-backed actions (material assignment, camera). */
     api?: EditorHostApi;