@jgengine/editor 0.18.1 → 0.21.0

package/dist/MaterialPreview.js

@@ -0,0 +1,41 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Canvas, useLoader } from "@react-three/fiber";
+import { Component, Suspense, useEffect, useState } from "react";
+import * as THREE from "three";
+import { inspectModelMaterialSlots } from "@jgengine/shell/render/materialAsset";
+import { sharedGltfLoader } from "@jgengine/shell/render/modelLoad";
+import { EntityModel } from "@jgengine/shell/render/SceneModels";
+import { DEFAULT_SUN_ELEVATION_DEG, sunDirectionFromBearing } from "@jgengine/shell/environment/daylightCycle";
+import { MaterialAssetSurface } from "@jgengine/shell/render/materialAsset";
+import { EnvironmentLighting } from "@jgengine/shell/render/EnvironmentLighting";
+import { INPUT_CLS } from "./shell/theme.js";
+function SlotProbe({ model, onSlots }) {
+    const gltf = useLoader(sharedGltfLoader, model.url);
+    useEffect(() => { onSlots?.(inspectModelMaterialSlots(gltf.scene)); }, [gltf.scene, onSlots]);
+    return null;
+}
+function PreviewReady({ onError }) {
+    useEffect(() => { onError?.(null); }, [onError]);
+    return null;
+}
+class PreviewBoundary extends Component {
+    state = { failed: false };
+    static getDerivedStateFromError() { return { failed: true }; }
+    componentDidCatch(error) { this.props.onError?.(error instanceof Error ? error.message : String(error)); }
+    render() { return this.state.failed ? null : this.props.children; }
+}
+/**
+ * Material preview lighting uses an isolated renderer; document settings never modify the game.
+ * @internal Mounted by the material workspace.
+ */
+export function MaterialPreview({ asset, mode, environment, model, onSlots, onError }) {
+    const [view, setView] = useState("front");
+    const [orientation, setOrientation] = useState(0);
+    const game = mode === "game";
+    const sky = game ? environment?.zenithColor ?? "#87b5e0" : "#eeeeee";
+    const ground = game ? environment?.horizonColor ?? "#3d4a38" : "#666666";
+    const sceneLight = sunDirectionFromBearing(environment?.sunAzimuth ?? 0, environment?.sunElevation ?? DEFAULT_SUN_ELEVATION_DEG).map((axis) => axis * 5);
+    const light = game ? sceneLight : view === "back" ? [0, 1, -4] : view === "grazing" ? [4, 0.5, 0.2] : [2, 3, 4];
+    const flat = asset?.family === "hair" || asset?.family === "fabric";
+    return _jsxs("div", { className: "space-y-1", children: [_jsxs("div", { className: "flex flex-wrap items-center gap-1 text-[10px]", children: [!game ? _jsxs("select", { "aria-label": "Material lighting view", value: view, onChange: (event) => setView(event.target.value), className: INPUT_CLS, children: [_jsx("option", { value: "front", children: "Front light" }), _jsx("option", { value: "grazing", children: "Grazing light" }), _jsx("option", { value: "back", children: "Back light" })] }) : _jsx("span", { children: "Document sun direction" }), _jsxs("label", { children: [model ? "Model yaw" : "Surface orientation", _jsx("input", { "aria-label": "Preview orientation", style: { width: 100 }, type: "range", min: 0, max: 360, value: orientation, onChange: (event) => setOrientation(Number(event.target.value)) })] })] }), _jsx("div", { style: { height: 210 }, "data-jg-material-preview": "", children: _jsxs(Canvas, { dpr: 1, camera: { position: [0, 0.35, 3.6], fov: 38 }, shadows: true, gl: { antialias: true, toneMapping: THREE.ACESFilmicToneMapping, toneMappingExposure: 1, outputColorSpace: THREE.SRGBColorSpace }, children: [_jsx("color", { attach: "background", args: ["#24272c"] }), _jsx("ambientLight", { intensity: game ? environment?.ambientIntensity ?? 0.2 : 0.12 }), _jsx("directionalLight", { position: light, intensity: game ? environment?.sunIntensity ?? 3 : 3, castShadow: true, "shadow-bias": -0.0004, "shadow-normalBias": 0.02 }), _jsx(PreviewBoundary, { onError: onError, children: _jsxs(Suspense, { fallback: null, children: [_jsx(EnvironmentLighting, { ...(game && environment?.source !== undefined ? { source: environment.source } : {}), intensity: 0.65, skyColor: sky, groundColor: ground, sunDirection: light }), model ? _jsxs("group", { "rotation-y": orientation * Math.PI / 180, "position-y": -0.85, children: [_jsx(SlotProbe, { model: model, onSlots: onSlots }), _jsx(EntityModel, { model: model })] }) : asset ? _jsxs("mesh", { rotation: [0, 0, orientation * Math.PI / 180], castShadow: true, receiveShadow: true, children: [flat ? _jsx("planeGeometry", { args: [2.1, 1.7, 24, 20] }) : _jsx("sphereGeometry", { args: [0.8, 64, 32] }), _jsx(MaterialAssetSurface, { asset: asset })] }) : null, _jsxs("mesh", { position: [0, -0.95, 0], rotation: [-Math.PI / 2, 0, 0], receiveShadow: true, children: [_jsx("planeGeometry", { args: [7, 7] }), _jsx("meshStandardMaterial", { color: "#393b3f", roughness: 0.95 })] }), _jsx(PreviewReady, { onError: onError })] }) }, JSON.stringify([asset, model]))] }, `${view}:${asset?.id ?? model?.url ?? "empty"}`) }), _jsxs("p", { className: "text-[9px] text-neutral-500", children: [model ? "Selected model displays its saved slot assignments. Choosing another library asset changes controls; assign it to a slot to change this model." : "Parameter sample; imported values require a selected model.", " ", game ? "Document environment and fixed sun; game lighting may add other lights or motion." : "Neutral front, grazing or back light.", " ACES, exposure 1. Geometry, tangents and UVs determine the response."] })] });
+}

package/dist/MaterialsWorkspacePanel.d.ts

@@ -1,12 +1,24 @@
-import type { EditorSession } from "@jgengine/core/editor/index";
+import { type ReactNode } from "react";
+import type { EditorDocument, EditorSession } from "@jgengine/core/editor/index";
+import { type MaterialAsset, type MaterialAssignment } from "@jgengine/core/material/materialAsset";
 import type { EditorHostApi } from "./session.js";
+/** Read the selected model's first usable assignment for workspace initialization. @internal */
+export declare function initialMaterialAssignment(document: Pick<EditorDocument, "markers" | "materialAssets">, selection: readonly string[]): MaterialAssignment | null;
 /**
  * Materials workspace home panel: browse every placeable's real `meta.materialId` from the live
  * document, filter by assignment/palette id/text, select into the hierarchy, and assign/clear via
  * the existing `assign_material` / `batch_set_properties` RPC seams. No fake thumbnails.
  * @internal — mounted by `EditorChrome` when the materials workspace is active.
  */
-export declare function MaterialsWorkspacePanel({ session, api, }: {
+export declare function MaterialsWorkspacePanel({ session, api, preview, onSave, materialSlots, previewError, }: {
     session: EditorSession;
     api: EditorHostApi;
+    preview?: (asset: MaterialAsset | undefined, mode: "neutral" | "game") => ReactNode;
+    onSave?: () => void;
+    materialSlots?: readonly {
+        mesh: string;
+        slot: string;
+        slotIndex: number;
+    }[];
+    previewError?: string | null;
 }): import("react").JSX.Element;

package/dist/MaterialsWorkspacePanel.js

@@ -1,6 +1,8 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useMemo, useState } from "react";
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useMemo, useState } from "react";
+import { createMaterialTemplate, parseMaterialAssignments } from "@jgengine/core/material/materialAsset";
 import { clearMaterialAssignmentPatch } from "./authoredComponentMeta.js";
+import { MaterialAssetEditor } from "./MaterialAssetEditor.js";
 import { filterMaterialAssignments, listMaterialAssignments, summarizeMaterialUsage, } from "./materialAssignments.js";
 import { TERRAIN_MATERIALS } from "./uiStore.js";
 import { FOCUS_RING, INPUT_CLS, MICRO_LABEL } from "./shell/theme.js";
@@ -17,17 +19,69 @@ function materialColor(materialId) {
 function materialLabel(materialId) {
     return TERRAIN_MATERIALS.find((material) => material.id === materialId)?.label ?? materialId;
 }
+/** Read the selected model's first usable assignment for workspace initialization. @internal */
+export function initialMaterialAssignment(document, selection) {
+    const marker = document.markers.find((item) => selection.includes(item.id));
+    const value = marker?.meta?.materialAssignments;
+    if (!Array.isArray(value))
+        return null;
+    for (const item of value) {
+        try {
+            const assignment = parseMaterialAssignments([item])[0];
+            if (document.materialAssets?.some((asset) => asset.id === assignment.materialId))
+                return assignment;
+        }
+        catch {
+            continue;
+        }
+    }
+    return null;
+}
 /**
  * Materials workspace home panel: browse every placeable's real `meta.materialId` from the live
  * document, filter by assignment/palette id/text, select into the hierarchy, and assign/clear via
  * the existing `assign_material` / `batch_set_properties` RPC seams. No fake thumbnails.
  * @internal — mounted by `EditorChrome` when the materials workspace is active.
  */
-export function MaterialsWorkspacePanel({ session, api, }) {
+export function MaterialsWorkspacePanel({ session, api, preview, onSave, materialSlots, previewError, }) {
     const document = useStoreSelector(session, (state) => state.document);
     const selection = useStoreSelector(session, (state) => state.selection, shallowArrayEqual);
     const [query, setQuery] = useState("");
     const [filter, setFilter] = useState("all");
+    const [tab, setTab] = useState("assets");
+    const [initialAssignment] = useState(() => { const state = session.getState(); return initialMaterialAssignment(state.document, state.selection); });
+    const [activeAssetId, setActiveAssetId] = useState(initialAssignment?.materialId ?? null);
+    const [template, setTemplate] = useState("wool");
+    const [newId, setNewId] = useState("");
+    const [mesh, setMesh] = useState(initialAssignment?.selector.mesh ?? "");
+    const [slot, setSlot] = useState(initialAssignment?.selector.slot ?? "");
+    const [slotIndex, setSlotIndex] = useState(initialAssignment?.selector.slotIndex === undefined ? "" : String(initialAssignment.selector.slotIndex));
+    const [error, setError] = useState(null);
+    const selectionKey = selection.join("\0");
+    useEffect(() => {
+        const state = session.getState();
+        const assignment = initialMaterialAssignment(state.document, state.selection);
+        if (assignment)
+            setActiveAssetId(assignment.materialId);
+        setMesh(assignment?.selector.mesh ?? "");
+        setSlot(assignment?.selector.slot ?? "");
+        setSlotIndex(assignment?.selector.slotIndex === undefined ? "" : String(assignment.selector.slotIndex));
+    }, [selectionKey, session]);
+    const assets = document.materialAssets ?? [];
+    const activeAsset = assets.find((asset) => asset.id === activeAssetId) ?? assets[0];
+    const assignmentErrors = [];
+    const selectedAssignments = document.markers.filter((marker) => selection.includes(marker.id)).flatMap((marker) => {
+        const value = marker.meta?.materialAssignments;
+        if (!Array.isArray(value))
+            return [];
+        try {
+            return parseMaterialAssignments(value).map((assignment) => ({ ...assignment, objectId: marker.id, objectName: marker.label ?? marker.id }));
+        }
+        catch (failure) {
+            assignmentErrors.push(`${marker.id}: ${failure instanceof Error ? failure.message : String(failure)}`);
+            return [];
+        }
+    });
     const rows = useMemo(() => listMaterialAssignments(document), [document]);
     const filtered = useMemo(() => filterMaterialAssignments(rows, query, filter), [rows, query, filter]);
     const usage = useMemo(() => summarizeMaterialUsage(rows), [rows]);
@@ -59,7 +113,27 @@ export function MaterialsWorkspacePanel({ session, api, }) {
             return filter.materialId === candidate.materialId;
         return filter === candidate;
     };
-    return (_jsxs("div", { className: "flex min-h-0 flex-1 flex-col", children: [_jsxs("div", { className: "space-y-2 border-b border-white/[0.06] p-2", children: [_jsx("div", { className: MICRO_LABEL, children: "Materials" }), _jsx("p", { className: "text-[10px] leading-snug text-neutral-500", children: "Document material assignments \u2014 select a row to inspect, assign from the palette, or clear." }), _jsx("input", { type: "search", value: query, onChange: (event) => setQuery(event.target.value), placeholder: "Filter objects\u2026", "aria-label": "Filter material assignments", className: `h-7 w-full px-2 ${INPUT_CLS}` }), _jsx("div", { className: "flex flex-wrap gap-1", role: "group", "aria-label": "Assignment filters", children: [
+    const tabs = _jsx("div", { className: "flex shrink-0 gap-1 border-b border-white/[0.06] p-2", role: "tablist", "aria-label": "Material workspace views", children: ["assets", "assignments"].map((view) => _jsx("button", { type: "button", role: "tab", "aria-selected": tab === view, className: `${CHIP} flex-1 ${tab === view ? CHIP_ACTIVE : CHIP_IDLE}`, onClick: () => setTab(view), children: view === "assets" ? "Surface assets" : "Legacy assignments" }, view)) });
+    if (tab === "assets")
+        return _jsxs("div", { className: "flex min-h-0 flex-1 flex-col", children: [tabs, _jsxs("div", { className: "min-h-0 flex-1 overflow-auto", children: [_jsxs("div", { className: "space-y-2 border-b border-white/[0.06] p-2", children: [_jsxs("label", { className: "block space-y-1", children: [_jsx("span", { className: MICRO_LABEL, children: "Reusable material asset" }), _jsx("select", { "aria-label": "Choose material asset", value: activeAsset?.id ?? "", className: `w-full px-2 py-1 ${INPUT_CLS}`, onChange: (event) => setActiveAssetId(event.target.value), children: assets.length ? assets.map((asset) => _jsx("option", { value: asset.id, children: asset.name }, asset.id)) : _jsx("option", { value: "", children: "No authored materials" }) })] }), activeAsset ? _jsx("button", { type: "button", className: `${CHIP} border-rose-400/25 text-rose-200`, onClick: () => { const result = api.handle({ method: "remove_material_asset", id: activeAsset.id }); setError(result.ok ? null : result.error ?? "Material operation failed."); }, children: "Remove unused asset" }) : null, _jsxs("details", { children: [_jsx("summary", { className: `cursor-pointer text-[11px] text-neutral-400 ${FOCUS_RING}`, children: "Create from an editable starting point" }), _jsxs("div", { className: "mt-2 space-y-2", children: [_jsx("select", { "aria-label": "Material starting point", className: `w-full px-2 py-1 ${INPUT_CLS}`, value: template, onChange: (event) => setTemplate(event.target.value), children: ["wool", "cotton", "silk", "brushed-metal", "glass", "coated-plastic", "stone", "hair-cards"].map((entry) => _jsx("option", { value: entry, children: entry }, entry)) }), _jsx("input", { "aria-label": "New material stable ID", value: newId, onChange: (event) => setNewId(event.target.value), placeholder: "game/my-original-surface", className: `w-full px-2 py-1 ${INPUT_CLS}` }), _jsx("button", { type: "button", disabled: !newId.trim() || assets.some((asset) => asset.id === newId.trim()), className: `${CHIP} ${CHIP_IDLE}`, onClick: () => { const asset = createMaterialTemplate(template, newId.trim()); const result = api.handle({ method: "upsert_material_asset", asset }); if (!result.ok)
+                                                        setError(result.error ?? "Material operation failed.");
+                                                    else {
+                                                        setActiveAssetId(asset.id);
+                                                        setNewId("");
+                                                        setError(null);
+                                                    } }, children: "Create asset" }), _jsx("p", { className: "text-[10px] text-neutral-500", children: "Starting points contain authored response parameters; your game supplies original textures, geometry and art direction." })] })] }), activeAsset ? _jsxs("details", { children: [_jsx("summary", { className: `cursor-pointer text-[11px] text-neutral-400 ${FOCUS_RING}`, children: "Assign to selected material slot" }), _jsxs("div", { className: "mt-2 space-y-2", children: [_jsx("p", { className: "text-[10px] text-neutral-500", children: "Choose a loaded material slot. Assignments preserve other slots on the model." }), materialSlots?.length ? _jsxs("select", { "aria-label": "Choose imported material slot", className: `w-full px-2 py-1 ${INPUT_CLS}`, value: String(materialSlots.findIndex((entry) => entry.mesh === mesh && entry.slot === slot && String(entry.slotIndex) === slotIndex)), onChange: (event) => { const entry = materialSlots[Number(event.target.value)]; if (!entry)
+                                                        return; setMesh(entry.mesh); setSlot(entry.slot); setSlotIndex(String(entry.slotIndex)); }, children: [_jsx("option", { value: "-1", children: "Choose a slot\u2026" }), materialSlots.map((entry, index) => _jsxs("option", { value: String(index), children: [entry.mesh || "Unnamed mesh", " / ", entry.slot || `slot ${entry.slotIndex}`] }, `${entry.mesh}:${entry.slotIndex}:${index}`))] }) : _jsx("p", { className: "text-[10px] text-neutral-500", children: "Select a model to inspect its imported slots, or enter an exact selector below." }), _jsxs("details", { children: [_jsx("summary", { className: `cursor-pointer text-[10px] text-neutral-400 ${FOCUS_RING}`, children: "Advanced exact selector" }), _jsxs("div", { className: "mt-2 space-y-2", children: [_jsx("input", { "aria-label": "Assignment mesh name", placeholder: "Mesh name (optional)", value: mesh, onChange: (event) => setMesh(event.target.value), className: `w-full px-2 py-1 ${INPUT_CLS}` }), _jsx("input", { "aria-label": "Assignment material slot name", placeholder: "Material slot name (optional)", value: slot, onChange: (event) => setSlot(event.target.value), className: `w-full px-2 py-1 ${INPUT_CLS}` }), _jsx("input", { "aria-label": "Assignment material slot index", type: "number", min: "0", step: "1", placeholder: "Slot index (optional)", value: slotIndex, onChange: (event) => setSlotIndex(event.target.value), className: `w-full px-2 py-1 ${INPUT_CLS}` })] })] }), _jsxs("button", { type: "button", className: `${CHIP} ${CHIP_IDLE}`, disabled: selection.length === 0 || (!mesh.trim() && !slot.trim() && !slotIndex), onClick: () => {
+                                                        const selector = {};
+                                                        if (mesh.trim())
+                                                            selector.mesh = mesh.trim();
+                                                        if (slot.trim())
+                                                            selector.slot = slot.trim();
+                                                        if (slotIndex)
+                                                            selector.slotIndex = Number(slotIndex);
+                                                        const result = api.handle({ method: "assign_material_asset", ids: [...selection], materialId: activeAsset.id, selector });
+                                                        setError(result.ok ? null : result.error ?? "Material operation failed.");
+                                                    }, children: ["Assign to selection (", selection.length, ")"] }), selectedAssignments.map((assignment, index) => _jsxs("button", { type: "button", className: `${CHIP} ${CHIP_IDLE} block w-full text-left`, onClick: () => { setActiveAssetId(assignment.materialId); setMesh(assignment.selector.mesh ?? ""); setSlot(assignment.selector.slot ?? ""); setSlotIndex(assignment.selector.slotIndex === undefined ? "" : String(assignment.selector.slotIndex)); }, children: [assignment.objectName, ": ", assignment.selector.mesh ?? "any mesh", " / ", assignment.selector.slot ?? `slot ${assignment.selector.slotIndex ?? "any"}`, " \u2192 ", assignment.materialId] }, `${assignment.objectId}:${index}`)), selectedAssignments.length ? _jsx("button", { type: "button", className: `${CHIP} border-rose-400/25 text-rose-200`, onClick: () => { const result = api.handle({ method: "clear_material_assets", ids: [...selection] }); setError(result.ok ? null : result.error ?? "Material operation failed."); }, children: "Restore selected objects' imported materials" }) : null] })] }) : null, _jsxs("div", { className: "flex gap-1", children: [_jsx("button", { type: "button", className: `${CHIP} ${CHIP_IDLE}`, onClick: () => api.handle({ method: "undo" }), children: "Undo" }), _jsx("button", { type: "button", className: `${CHIP} ${CHIP_IDLE}`, onClick: () => api.handle({ method: "redo" }), children: "Redo" }), onSave ? _jsx("button", { type: "button", className: `${CHIP} ${CHIP_IDLE}`, onClick: onSave, children: "Save scene" }) : null] }), error ? _jsx("p", { role: "alert", className: "text-[10px] text-rose-300", children: error }) : null, previewError ? _jsxs("p", { role: "alert", className: "text-[10px] text-rose-300", children: ["Preview: ", previewError] }) : null, assignmentErrors.map((message) => _jsx("p", { role: "alert", className: "text-[10px] text-rose-300", children: message }, message))] }), activeAsset ? _jsx(MaterialAssetEditor, { asset: activeAsset, preview: preview, onChange: (asset, coalesce) => { const result = api.handle({ method: "upsert_material_asset", asset, coalesce }); setError(result.ok ? null : result.error ?? "Material operation failed."); } }, activeAsset.id) : _jsxs(_Fragment, { children: [_jsx("div", { className: "p-2", children: preview?.(undefined, "neutral") }), _jsx(EmptyState, { icon: "sphere", title: "No material assets", description: "Create an editable starting point, then assign it to a named mesh or material slot. Existing imported materials remain intact." })] })] })] });
+    return (_jsxs("div", { className: "flex min-h-0 flex-1 flex-col", children: [tabs, _jsxs("div", { className: "space-y-2 border-b border-white/[0.06] p-2", children: [_jsx("div", { className: MICRO_LABEL, children: "Materials" }), _jsx("p", { className: "text-[10px] leading-snug text-neutral-500", children: "Document material assignments \u2014 select a row to inspect, assign from the palette, or clear." }), _jsx("input", { type: "search", value: query, onChange: (event) => setQuery(event.target.value), placeholder: "Filter objects\u2026", "aria-label": "Filter material assignments", className: `h-7 w-full px-2 ${INPUT_CLS}` }), _jsx("div", { className: "flex flex-wrap gap-1", role: "group", "aria-label": "Assignment filters", children: [
                             { id: "all", label: `All (${rows.length})` },
                             { id: "assigned", label: `Assigned (${assignedCount})` },
                             { id: "unassigned", label: `None (${rows.length - assignedCount})` },

package/dist/RuntimePlayBridge.js

@@ -65,15 +65,10 @@ export function RuntimePlayPublisher({ api }) {
             api.setPlayControl({ paused: true, pendingSteps: play.pendingSteps - 1 });
             return;
         }
+        // Freeze before the next simulation frame; positive priorities would take over canvas rendering.
         if (!ctx.time.isPaused())
             ctx.time.pause();
     }, -1);
-    useFrame(() => {
-        const play = api.getPlayControl();
-        if (play.paused && play.pendingSteps === 0 && !ctx.time.isPaused()) {
-            ctx.time.pause();
-        }
-    }, 1);
     return null;
 }
 /**

package/dist/SelectionGizmo.js

@@ -4,6 +4,7 @@ import { memo, useEffect, useMemo } from "react";
 import * as THREE from "three";
 import { findEditorMarker, findEditorNote, findEditorPath, findEditorVolume, } from "@jgengine/core/editor/index";
 import { TransformGizmo, } from "@jgengine/shell/structures/TransformGizmo";
+import { placementGround, pathSegmentDistance, selectionGizmoMode, snapPlacement } from "./authoringPlacement.js";
 import { isPointerClick } from "./viewportContextMenu.js";
 import { resolvePivotPosition } from "./gizmoPivot.js";
 import { newPlacementId, } from "./uiStore.js";
@@ -108,13 +109,17 @@ export const ViewportSelect = memo(function ViewportSelect({ api, ui }) {
         const planeHit = new THREE.Vector3();
         let down = null;
         const session = () => api.getSession();
-        const screenDistance = (point, lift, clickX, clickY, rect) => {
+        const screenPoint = (point, lift, rect) => {
             projected.set(point.x, point.y + lift, point.z).project(camera);
             if (projected.z < -1 || projected.z > 1)
                 return null;
             const px = (projected.x * 0.5 + 0.5) * rect.width;
             const py = (-projected.y * 0.5 + 0.5) * rect.height;
-            return Math.hypot(px - clickX, py - clickY);
+            return { x: px, y: py };
+        };
+        const screenDistance = (point, lift, clickX, clickY, rect) => {
+            const projectedPoint = screenPoint(point, lift, rect);
+            return projectedPoint === null ? null : Math.hypot(projectedPoint.x - clickX, projectedPoint.y - clickY);
         };
         const groundPoint = (clickX, clickY, rect) => {
             ndc.set((clickX / rect.width) * 2 - 1, -(clickY / rect.height) * 2 + 1);
@@ -135,6 +140,11 @@ export const ViewportSelect = memo(function ViewportSelect({ api, ui }) {
             const placement = ui.getState().placement;
             if (placement === null)
                 return;
+            const ground = placementGround(session().getState().document.terrain, api.getTerrainSampler());
+            const snapped = snapPlacement(point, ui.getState().snapMode, ui.getState().gridSize, (x, z) => ground?.sampleHeight(x, z) ?? 0);
+            if (snapped === null)
+                return;
+            point = snapped;
             if (placement.tool === "path") {
                 ui.pushDraftPoint(point);
                 return;
@@ -201,11 +211,17 @@ export const ViewportSelect = memo(function ViewportSelect({ api, ui }) {
                 if (visibility[path.kind] === false || path.hidden === true)
                     continue;
                 let best = null;
+                let previous = null;
                 for (const point of path.points) {
-                    const distance = screenDistance(point, 0.8, clickX, clickY, rect);
-                    if (distance !== null && distance < SCREEN_PICK_RADIUS_PX && (best === null || distance < best)) {
-                        best = distance;
+                    const projectedPoint = screenPoint(point, 0.8, rect);
+                    if (projectedPoint !== null) {
+                        const distance = previous === null
+                            ? Math.hypot(projectedPoint.x - clickX, projectedPoint.y - clickY)
+                            : pathSegmentDistance({ x: clickX, y: clickY }, previous, projectedPoint);
+                        if (distance < SCREEN_PICK_RADIUS_PX && (best === null || distance < best))
+                            best = distance;
                     }
+                    previous = projectedPoint;
                 }
                 if (best !== null)
                     candidates.push({ id: path.id, distance: best });
@@ -410,7 +426,7 @@ export const ViewportSelect = memo(function ViewportSelect({ api, ui }) {
 });
 function resolveTarget(session, selection, pathPoint, pivot) {
     const { document } = session.getState();
-    if (pathPoint !== null) {
+    if (pathPoint !== null && selection.length === 1 && selection[0] === pathPoint.pathId) {
         const path = findEditorPath(document, pathPoint.pathId);
         const point = path?.points[pathPoint.index];
         if (point !== undefined)
@@ -436,13 +452,6 @@ function resolveTarget(session, selection, pathPoint, pivot) {
     // Multi-select always translates as a group from the pivot; rotation/scale stay primary-kind limited.
     return { position: pivotPos, lift: primary.lift, rotationY: primary.rotationY, kind: primary.kind };
 }
-function effectiveMode(mode, kind) {
-    if (kind === "marker")
-        return mode === "scale" ? "translate" : mode;
-    if (kind === "volume")
-        return mode === "rotate" ? "translate" : mode;
-    return "translate";
-}
 /**
  * Drag-to-transform gizmo bound to the current selection, dispatching editor commands on
  * release. Mounts the shared shell `TransformGizmo` and maps release poses onto editor
@@ -453,7 +462,7 @@ export const SelectionGizmo = memo(function SelectionGizmo({ session, ui, ground
     const state = session.getState();
     const selectedId = state.selection[0];
     const target = useMemo(() => resolveTarget(session, state.selection, uiState.pathPoint, uiState.gizmoPivot), [state, uiState.pathPoint, uiState.gizmoPivot, session]);
-    const mode = target === null ? "translate" : effectiveMode(uiState.gizmoMode, target.kind);
+    const mode = target === null ? "translate" : selectionGizmoMode(uiState.gizmoMode, target.kind, target.kind === "pathPoint" ? 1 : state.selection.length);
     if (target === null)
         return null;
     const onRelease = (pose) => {

package/dist/SimulationInspector.d.ts

@@ -0,0 +1,9 @@
+import type { CreatorPolicy } from "@jgengine/core/editor/creatorStorage";
+import type { EditorSession } from "@jgengine/core/editor/commands";
+/** Production authoring controls share the same validated command and undo history as RPC.
+ * @capability simulation-inspector author weather schedules, effects, fire, wind zones, forces and habitats with validated undoable controls
+ */
+export declare function SimulationInspector({ session, creatorPolicy }: {
+    session: EditorSession;
+    creatorPolicy?: CreatorPolicy;
+}): import("react").JSX.Element;

package/dist/SimulationInspector.js

@@ -0,0 +1,47 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from "react";
+import { useStoreSelector } from "./useStoreSelector.js";
+const modes = ["clear", "rain", "snow", "mixed", "dust"];
+function NumberInput({ label, value, onChange, min = 0, step = 0.1 }) {
+    return _jsxs("label", { className: "flex items-center justify-between gap-2", children: [_jsx("span", { children: label }), _jsx("input", { "aria-label": label, className: "w-24 rounded border border-neutral-700 bg-neutral-900 p-1", type: "number", min: min, step: step, value: value, onChange: (event) => onChange(Number(event.target.value)) })] });
+}
+/** Production authoring controls share the same validated command and undo history as RPC.
+ * @capability simulation-inspector author weather schedules, effects, fire, wind zones, forces and habitats with validated undoable controls
+ */
+export function SimulationInspector({ session, creatorPolicy }) {
+    const simulation = useStoreSelector(session, (state) => state.document.simulation);
+    const [error, setError] = useState(null);
+    const [advanced, setAdvanced] = useState(null);
+    const [species, setSpecies] = useState("");
+    const weather = simulation?.weather ?? {};
+    const allowWeather = creatorPolicy === undefined || (creatorPolicy.maxSimulationParticles ?? 0) >= 5556;
+    const allowEmitters = creatorPolicy === undefined || (creatorPolicy.maxSimulationParticles ?? 0) > 0;
+    const allowFire = creatorPolicy === undefined || (creatorPolicy.maxFireCells ?? 0) > 0;
+    const allowFlocks = creatorPolicy === undefined || (creatorPolicy.maxPopulation ?? 0) > 0;
+    const allowForces = creatorPolicy === undefined || (creatorPolicy.maxForceFields ?? 0) > 0;
+    function update(next) {
+        try {
+            session.dispatch({ type: "setSimulation", simulation: next });
+            setError(null);
+        }
+        catch (reason) {
+            setError(reason instanceof Error ? reason.message : String(reason));
+        }
+    }
+    function setWeather(next) { update({ ...simulation, weather: next }); }
+    function id(prefix, rows) {
+        let index = 1;
+        while (rows.some((row) => row.id === `${prefix}-${index}`))
+            index += 1;
+        return `${prefix}-${index}`;
+    }
+    return _jsxs("section", { "aria-label": "Simulation authoring", className: "space-y-4 p-3 text-xs text-neutral-300", children: [_jsx("h3", { className: "text-sm font-semibold text-neutral-100", children: "Weather & simulation" }), _jsx("p", { children: "Metres \u00B7 game seconds \u00B7 wind on world X/Z. Save stores authored inputs; play state saves separately." }), error !== null ? _jsx("p", { role: "alert", className: "text-red-300", children: error }) : null, _jsxs("fieldset", { hidden: !allowWeather, className: "space-y-2", children: [_jsx("legend", { children: "Ambient weather" }), _jsxs("label", { className: "flex justify-between", children: ["Mode", _jsx("select", { "aria-label": "Weather mode", value: weather.ambient?.mode ?? "clear", onChange: (event) => setWeather({ ...weather, ambient: { ...weather.ambient, mode: event.target.value, intensity: weather.ambient?.intensity ?? 1 } }), children: modes.map((mode) => _jsx("option", { children: mode }, mode)) })] }), _jsx(NumberInput, { label: "Weather intensity", value: weather.ambient?.intensity ?? 0, onChange: (intensity) => setWeather({ ...weather, ambient: { mode: "clear", ...weather.ambient, intensity } }) }), _jsx(NumberInput, { label: "Temperature offset \u00B0C", min: -100, value: weather.ambient?.temperatureOffset ?? 0, onChange: (temperatureOffset) => setWeather({ ...weather, ambient: { mode: "clear", intensity: 0, ...weather.ambient, temperatureOffset } }) }), _jsx(NumberInput, { label: "Wind speed m/s", value: weather.wind?.speed ?? 0, onChange: (speed) => setWeather({ ...weather, wind: { ...weather.wind, speed } }) }), _jsx(NumberInput, { label: "Wind X direction", min: -1, value: weather.wind?.direction?.[0] ?? 1, onChange: (x) => setWeather({ ...weather, wind: { ...weather.wind, direction: [x, weather.wind?.direction?.[1] ?? 0] } }) }), _jsx(NumberInput, { label: "Wind Z direction", min: -1, value: weather.wind?.direction?.[1] ?? 0, onChange: (z) => setWeather({ ...weather, wind: { ...weather.wind, direction: [weather.wind?.direction?.[0] ?? 1, z] } }) })] }), _jsxs("fieldset", { hidden: !allowWeather, className: "space-y-2", children: [_jsx("legend", { children: "Named profiles" }), (weather.profiles ?? []).map((profile, index) => _jsxs("div", { className: "space-y-1 border-l border-neutral-700 pl-2", children: [_jsxs("label", { children: ["Profile id", _jsx("input", { "aria-label": `Profile ${index + 1} id`, value: profile.id, onChange: (event) => {
+                                            const nextId = event.target.value;
+                                            setWeather({ ...weather, initialProfileId: weather.initialProfileId === profile.id ? nextId : weather.initialProfileId, profiles: weather.profiles.map((row, i) => i === index ? { ...row, id: nextId } : row), schedule: weather.schedule?.map((row) => row.profileId === profile.id ? { ...row, profileId: nextId } : row) });
+                                        } })] }), _jsx("select", { "aria-label": `Profile ${profile.id} mode`, value: profile.mode, onChange: (event) => setWeather({ ...weather, profiles: weather.profiles.map((row, i) => i === index ? { ...row, mode: event.target.value } : row) }), children: modes.map((mode) => _jsx("option", { children: mode }, mode)) }), _jsx(NumberInput, { label: `Profile ${profile.id} intensity`, value: profile.intensity, onChange: (intensity) => setWeather({ ...weather, profiles: weather.profiles.map((row, i) => i === index ? { ...row, intensity } : row) }) }), _jsx("button", { type: "button", onClick: () => setWeather({ ...weather, profiles: weather.profiles.filter((_, i) => i !== index), initialProfileId: weather.initialProfileId === profile.id ? undefined : weather.initialProfileId, schedule: weather.schedule?.filter((row) => row.profileId !== profile.id) }), children: "Remove profile" })] }, profile.id)), _jsx("button", { type: "button", onClick: () => setWeather({ ...weather, profiles: [...(weather.profiles ?? []), { id: id("profile", weather.profiles ?? []), mode: "rain", intensity: 0.5 }] }), children: "Add weather profile" })] }), _jsxs("fieldset", { hidden: !allowWeather, className: "space-y-2", children: [_jsx("legend", { children: "Schedule" }), (weather.schedule ?? []).map((transition, index) => _jsxs("div", { className: "space-y-1 border-l border-neutral-700 pl-2", children: [_jsx("select", { "aria-label": `Transition ${index + 1} profile`, value: transition.profileId, onChange: (event) => setWeather({ ...weather, schedule: weather.schedule.map((row, i) => i === index ? { ...row, profileId: event.target.value } : row) }), children: weather.profiles?.map((profile) => _jsx("option", { children: profile.id }, profile.id)) }), _jsx(NumberInput, { label: `Transition ${index + 1} at seconds`, value: transition.atSeconds, onChange: (atSeconds) => setWeather({ ...weather, schedule: weather.schedule.map((row, i) => i === index ? { ...row, atSeconds } : row) }) }), _jsx(NumberInput, { label: `Transition ${index + 1} duration seconds`, value: transition.transitionSeconds ?? 0, onChange: (transitionSeconds) => setWeather({ ...weather, schedule: weather.schedule.map((row, i) => i === index ? { ...row, transitionSeconds } : row) }) }), _jsx("button", { type: "button", onClick: () => setWeather({ ...weather, schedule: weather.schedule.filter((_, i) => i !== index) }), children: "Remove transition" })] }, index)), _jsx("button", { type: "button", disabled: !weather.profiles?.length, onClick: () => setWeather({ ...weather, schedule: [...(weather.schedule ?? []), { atSeconds: (weather.schedule?.at(-1)?.atSeconds ?? 0) + 10, profileId: weather.profiles[0].id, transitionSeconds: 2 }] }), children: "Add transition" })] }), _jsxs("fieldset", { hidden: !allowWeather, className: "space-y-2", children: [_jsx("legend", { children: "Local wind zones" }), (weather.zones ?? []).map((zone, index) => _jsxs("div", { className: "space-y-1 border-l border-neutral-700 pl-2", children: [_jsx("span", { children: zone.id }), _jsx(NumberInput, { label: `${zone.id} X metres`, min: -1e6, value: zone.center[0], onChange: (x) => setWeather({ ...weather, zones: weather.zones.map((row, i) => i === index ? { ...row, center: [x, row.center[1]] } : row) }) }), _jsx(NumberInput, { label: `${zone.id} Z metres`, min: -1e6, value: zone.center[1], onChange: (z) => setWeather({ ...weather, zones: weather.zones.map((row, i) => i === index ? { ...row, center: [row.center[0], z] } : row) }) }), _jsx(NumberInput, { label: `${zone.id} radius metres`, value: zone.radius, onChange: (radius) => setWeather({ ...weather, zones: weather.zones.map((row, i) => i === index ? { ...row, radius } : row) }) }), _jsx(NumberInput, { label: `${zone.id} speed m/s`, value: zone.wind?.speed ?? 0, onChange: (speed) => setWeather({ ...weather, zones: weather.zones.map((row, i) => i === index ? { ...row, wind: { ...row.wind, speed } } : row) }) }), _jsxs("label", { children: [_jsx("input", { type: "checkbox", checked: zone.radial ?? false, onChange: (event) => setWeather({ ...weather, zones: weather.zones.map((row, i) => i === index ? { ...row, radial: event.target.checked } : row) }) }), " Radial wind"] }), _jsx("button", { type: "button", onClick: () => setWeather({ ...weather, zones: weather.zones.filter((_, i) => i !== index) }), children: "Remove wind zone" })] }, zone.id)), _jsx("button", { type: "button", onClick: () => setWeather({ ...weather, zones: [...(weather.zones ?? []), { id: id("wind", weather.zones ?? []), center: [0, 0], radius: 10, falloff: 5, wind: { direction: [1, 0], speed: 3 } }] }), children: "Add wind zone" })] }), _jsxs("fieldset", { hidden: !allowForces, className: "space-y-2", children: [_jsx("legend", { children: "Spatial forces" }), (simulation?.forces ?? []).map((field, index) => _jsxs("div", { className: "space-y-1 border-l border-neutral-700 pl-2", children: [[0, 1, 2].map((axis) => _jsx(NumberInput, { label: `Force ${index + 1} ${["X", "Y", "Z"][axis]} metres`, min: -1e6, value: field.center[axis], onChange: (value) => update({ ...simulation, forces: simulation.forces.map((row, i) => i === index ? { ...row, center: row.center.map((entry, j) => j === axis ? value : entry) } : row) }) }, axis)), field.shape.kind === "sphere" ? _jsx(NumberInput, { label: `Force ${index + 1} radius metres`, value: field.shape.radius, onChange: (radius) => update({ ...simulation, forces: simulation.forces.map((row, i) => i === index ? { ...row, shape: { kind: "sphere", radius } } : row) }) }) : _jsx("span", { children: "Box bounds are available in advanced editing." }), _jsx(NumberInput, { label: `Force ${index + 1} attraction m/s²`, min: -1e6, value: field.strength, onChange: (strength) => update({ ...simulation, forces: simulation.forces.map((row, i) => i === index ? { ...row, strength } : row) }) }), _jsx(NumberInput, { label: `Force ${index + 1} vortex m/s²`, min: -1e6, value: field.vortex?.strength ?? 0, onChange: (strength) => update({ ...simulation, forces: simulation.forces.map((row, i) => i === index ? { ...row, vortex: { axis: [0, 1, 0], ...row.vortex, strength } } : row) }) }), _jsx(NumberInput, { label: `Force ${index + 1} lift m/s²`, min: -1e6, value: field.vortex?.lift ?? 0, onChange: (lift) => update({ ...simulation, forces: simulation.forces.map((row, i) => i === index ? { ...row, vortex: { axis: [0, 1, 0], strength: 0, ...row.vortex, lift } } : row) }) }), _jsx(NumberInput, { label: `Force ${index + 1} falloff`, value: field.attenuation ?? 1, onChange: (attenuation) => update({ ...simulation, forces: simulation.forces.map((row, i) => i === index ? { ...row, attenuation } : row) }) }), _jsx("button", { type: "button", onClick: () => update({ ...simulation, forces: simulation.forces.filter((_, i) => i !== index) }), children: "Remove force" })] }, index)), _jsx("button", { type: "button", onClick: () => update({ ...simulation, forces: [...(simulation?.forces ?? []), { center: [0, 0, 0], shape: { kind: "sphere", radius: 10 }, strength: 0, attenuation: 1, vortex: { axis: [0, 1, 0], strength: 2, lift: 1 }, mask: 1 }] }), children: "Add spatial force" })] }), _jsxs("fieldset", { hidden: !allowEmitters, className: "space-y-2", children: [_jsx("legend", { children: "Named effects" }), (simulation?.emitters ?? []).map((emitter, index) => _jsxs("div", { className: "space-y-1 border-l border-neutral-700 pl-2", children: [_jsx("span", { children: emitter.id }), _jsx("select", { "aria-label": `${emitter.id} appearance`, value: emitter.options?.render?.shape ?? "point", onChange: (event) => update({ ...simulation, emitters: simulation.emitters.map((row, i) => i === index ? { ...row, options: { ...row.options, render: { shape: event.target.value } } } : row) }), children: ["point", "streak", "flake", "flame", "smoke", "ribbon", "ripple"].map((shape) => _jsx("option", { children: shape }, shape)) }), _jsx(NumberInput, { label: `${emitter.id} particles/second`, value: emitter.config.rate ?? 0, onChange: (rate) => update({ ...simulation, emitters: simulation.emitters.map((row, i) => i === index ? { ...row, config: { ...row.config, rate } } : row) }) }), _jsx(NumberInput, { label: `${emitter.id} particle capacity`, step: 1, value: emitter.config.max ?? 512, onChange: (max) => update({ ...simulation, emitters: simulation.emitters.map((row, i) => i === index ? { ...row, config: { ...row.config, max } } : row) }) }), ["x", "y", "z"].map((axis) => _jsx(NumberInput, { label: `${emitter.id} ${axis.toUpperCase()} metres`, min: -1e6, value: emitter.position[axis], onChange: (value) => update({ ...simulation, emitters: simulation.emitters.map((row, i) => i === index ? { ...row, position: { ...row.position, [axis]: value } } : row) }) }, axis)), _jsxs("label", { children: [_jsx("input", { type: "checkbox", checked: emitter.options?.active !== false, onChange: (event) => update({ ...simulation, emitters: simulation.emitters.map((row, i) => i === index ? { ...row, options: { ...row.options, active: event.target.checked } } : row) }) }), " Spawning"] }), _jsxs("label", { children: ["Fire binding", _jsxs("select", { "aria-label": `${emitter.id} fire area`, value: emitter.fireAreaId ?? "", onChange: (event) => update({ ...simulation, emitters: simulation.emitters.map((row, i) => i === index ? { ...row, fireAreaId: event.target.value || undefined } : row) }), children: [_jsx("option", { value: "", children: "Independent" }), simulation?.fires?.map((area) => _jsx("option", { children: area.id }, area.id))] })] }), _jsx("button", { type: "button", onClick: () => update({ ...simulation, emitters: simulation.emitters.filter((_, i) => i !== index) }), children: "Remove emitter" })] }, emitter.id)), _jsx("button", { type: "button", onClick: () => update({ ...simulation, emitters: [...(simulation?.emitters ?? []), { id: id("emitter", simulation?.emitters ?? []), position: { x: 0, y: 1, z: 0 }, config: { rate: 8, max: 64, lifetime: { min: 1, max: 2 }, seed: "authored" }, options: { render: { shape: "smoke" } } }] }), children: "Add named emitter" })] }), _jsxs("fieldset", { hidden: !allowFire, className: "space-y-2", children: [_jsx("legend", { children: "Fire areas" }), (simulation?.fires ?? []).map((area, index) => _jsxs("div", { className: "space-y-1 border-l border-neutral-700 pl-2", children: [_jsx("span", { children: area.id }), ["x", "y", "z"].map((axis) => _jsx(NumberInput, { label: `${area.id} ${axis.toUpperCase()} metres`, min: -1e6, value: area.position[axis], onChange: (value) => update({ ...simulation, fires: simulation.fires.map((row, i) => i === index ? { ...row, position: { ...row.position, [axis]: value } } : row) }) }, axis)), _jsx(NumberInput, { label: `${area.id} cell size metres`, value: area.config.cellSize, onChange: (cellSize) => update({ ...simulation, fires: simulation.fires.map((row, i) => i === index ? { ...row, config: { ...row.config, cellSize } } : row) }) }), _jsx(NumberInput, { label: `${area.id} fuel consumed/second`, value: area.config.burnRate ?? 0.25, onChange: (burnRate) => update({ ...simulation, fires: simulation.fires.map((row, i) => i === index ? { ...row, config: { ...row.config, burnRate } } : row) }) }), _jsx(NumberInput, { label: `${area.id} rain cooling heat/second`, value: area.extinguishRate ?? 0, onChange: (extinguishRate) => update({ ...simulation, fires: simulation.fires.map((row, i) => i === index ? { ...row, extinguishRate } : row) }) }), _jsxs("label", { children: [_jsx("input", { type: "checkbox", checked: (area.ignitions?.length ?? 0) > 0, onChange: (event) => update({ ...simulation, fires: simulation.fires.map((row, i) => i === index ? { ...row, ignitions: event.target.checked ? [{ col: 0, row: 0 }] : [] } : row) }) }), " Ignite first cell on play"] }), _jsx("button", { type: "button", onClick: () => update({ ...simulation, fires: simulation.fires.filter((_, i) => i !== index), emitters: simulation?.emitters?.map((emitter) => emitter.fireAreaId === area.id ? { ...emitter, fireAreaId: undefined } : emitter) }), children: "Remove fire area" })] }, area.id)), _jsx("button", { type: "button", onClick: () => update({ ...simulation, fires: [...(simulation?.fires ?? []), { id: id("fire", simulation?.fires ?? []), position: { x: 0, y: 0, z: 0 }, config: { cols: 4, rows: 4, cellSize: 1 }, ignitions: [] }] }), children: "Add fire area" })] }), _jsxs("fieldset", { hidden: !allowFlocks, className: "space-y-2", children: [_jsx("legend", { children: "Flock habitats" }), (simulation?.habitats ?? []).map((habitat, index) => _jsxs("div", { className: "space-y-1 border-l border-neutral-700 pl-2", children: [_jsxs("span", { children: [habitat.id, " \u00B7 ", habitat.species] }), _jsxs("select", { "aria-label": `${habitat.id} role`, value: habitat.role, onChange: (event) => update({ ...simulation, habitats: simulation.habitats.map((row, i) => i === index ? { ...row, role: event.target.value } : row) }), children: [_jsx("option", { children: "cosmetic" }), _jsx("option", { children: "gameplay" })] }), _jsx(NumberInput, { label: `${habitat.id} bird count`, step: 1, value: habitat.count, onChange: (count) => update({ ...simulation, habitats: simulation.habitats.map((row, i) => i === index ? { ...row, count } : row) }) }), _jsx(NumberInput, { label: `${habitat.id} radius metres`, value: habitat.radius, onChange: (radius) => update({ ...simulation, habitats: simulation.habitats.map((row, i) => i === index ? { ...row, radius } : row) }) }), ["x", "y", "z"].map((axis) => _jsx(NumberInput, { label: `${habitat.id} ${axis.toUpperCase()} metres`, min: -1e6, value: habitat.position[axis], onChange: (value) => update({ ...simulation, habitats: simulation.habitats.map((row, i) => i === index ? { ...row, position: { ...row.position, [axis]: value } } : row) }) }, axis)), _jsxs("select", { "aria-label": `${habitat.id} route`, value: habitat.routeId ?? "", onChange: (event) => update({ ...simulation, habitats: simulation.habitats.map((row, i) => i === index ? { ...row, routeId: event.target.value || undefined } : row) }), children: [_jsx("option", { value: "", children: "Stay in habitat" }), session.getState().document.paths.filter((path) => path.points.length > 1).map((path) => _jsx("option", { value: path.id, children: path.label ?? path.id }, path.id))] }), _jsx("button", { type: "button", onClick: () => update({ ...simulation, habitats: simulation.habitats.filter((_, i) => i !== index) }), children: "Remove habitat" })] }, habitat.id)), _jsxs("label", { children: ["Game species", _jsx("input", { "aria-label": "Game species", value: species, onChange: (event) => setSpecies(event.target.value) })] }), _jsx("button", { type: "button", disabled: !species.trim(), onClick: () => update({ ...simulation, habitats: [...(simulation?.habitats ?? []), { id: id("habitat", simulation?.habitats ?? []), species: species.trim(), position: { x: 0, y: 4, z: 0 }, radius: 8, count: 8, seed: "authored", role: "cosmetic", steering: { maxSpeed: 4, separationRadius: 1, neighborRadius: 5 } }] }), children: "Add flock habitat" })] }), _jsx("button", { type: "button", onClick: () => setAdvanced(JSON.stringify(simulation ?? {}, null, 2)), children: "Edit complete simulation data" }), advanced !== null ? _jsxs("div", { className: "space-y-2", children: [_jsx("textarea", { "aria-label": "Simulation JSON", className: "h-60 w-full bg-neutral-900 p-2 font-mono", value: advanced, onChange: (event) => setAdvanced(event.target.value) }), _jsx("button", { type: "button", onClick: () => { try {
+                            update(JSON.parse(advanced));
+                        }
+                        catch (reason) {
+                            setError(String(reason));
+                        } }, children: "Apply simulation data" }), _jsx("button", { type: "button", onClick: () => setAdvanced(null), children: "Close data editor" })] }) : null] });
+}

package/dist/TerrainSculpt.js

@@ -172,6 +172,7 @@ function unionRect(a, b) {
 }
 /** Memoized so cursor-hover state updates in the parent never reconcile the mesh subtree. */
 const SculptMesh = memo(function SculptMesh({ terrain, bounds, segments, revision, pendingRef, paletteAt, heightRange, contourStrength, }) {
+    const invalidate = useThree((state) => state.invalidate);
     const geometry = useMemo(() => {
         const width = Math.max(1, bounds.maxX - bounds.minX);
         const depth = Math.max(1, bounds.maxZ - bounds.minZ);
@@ -188,8 +189,9 @@ const SculptMesh = memo(function SculptMesh({ terrain, bounds, segments, revisio
         pendingRef.current = null;
         const region = pending !== null && pending.kind === "region" ? pending.region : null;
         displace(geometry, terrain, bounds, region, paletteAt, heightRange, contourStrength);
+        invalidate();
         // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, [geometry, terrain, revision, paletteAt, heightRange, contourStrength]);
+    }, [geometry, terrain, revision, paletteAt, heightRange, contourStrength, invalidate]);
     return (_jsx("mesh", { geometry: geometry, receiveShadow: true, children: _jsx("meshStandardMaterial", { vertexColors: true, roughness: 0.95, metalness: 0, polygonOffset: true, polygonOffsetFactor: -1, polygonOffsetUnits: -1 }) }));
 });
 function selectSculptUi(state) {

package/dist/agent/toolBridge.js

@@ -10,6 +10,8 @@ const READ_ONLY_METHODS = new Set([
     "camera_goto",
     "camera_frame",
     "scene_summary",
+    "get_simulation",
+    "set_simulation",
     "export_document",
     "list_assets",
     "perf_report",

package/dist/authoringPlacement.d.ts

@@ -0,0 +1,21 @@
+import type { EditorVec3 } from "@jgengine/core/editor/index";
+import type { TerrainField } from "@jgengine/core/world/terrain";
+import { type TerraformSnapshot } from "@jgengine/core/world/terraform";
+import type { GizmoMode, SnapMode } from "./uiStore.js";
+/** Compose authored sculpt offsets over the same base field as the terrain preview. @internal */
+export declare function placementGround(terrain: TerraformSnapshot | undefined, base: TerrainField | null): TerrainField | null;
+/** Snap XZ and resample the shared ground field; reject a nonfinite surface height. @internal */
+export declare function snapPlacement(point: EditorVec3, mode: SnapMode, gridSize: number, groundHeightAt: (x: number, z: number) => number): EditorVec3 | null;
+/** Distance from a pointer to a projected path segment, including either endpoint. @internal */
+export declare function pathSegmentDistance(pointer: {
+    x: number;
+    y: number;
+}, a: {
+    x: number;
+    y: number;
+}, b: {
+    x: number;
+    y: number;
+}): number;
+/** Group transforms use the translation command for every selected object. @internal */
+export declare function selectionGizmoMode(mode: GizmoMode, kind: string, count: number): GizmoMode;

package/dist/authoringPlacement.js

@@ -0,0 +1,34 @@
+import { editableTerrainFromSnapshot } from "@jgengine/core/world/terraform";
+/** Compose authored sculpt offsets over the same base field as the terrain preview. @internal */
+export function placementGround(terrain, base) {
+    return terrain === undefined ? base : editableTerrainFromSnapshot(terrain, base ?? undefined);
+}
+/** Snap XZ and resample the shared ground field; reject a nonfinite surface height. @internal */
+export function snapPlacement(point, mode, gridSize, groundHeightAt) {
+    if (mode !== "grid" || !Number.isFinite(gridSize) || gridSize <= 0)
+        return point;
+    const x = Math.round(point.x / gridSize) * gridSize;
+    const z = Math.round(point.z / gridSize) * gridSize;
+    if (!Number.isFinite(x) || !Number.isFinite(z))
+        return null;
+    const y = groundHeightAt(x, z);
+    return Number.isFinite(y) ? { x, y, z } : null;
+}
+/** Distance from a pointer to a projected path segment, including either endpoint. @internal */
+export function pathSegmentDistance(pointer, a, b) {
+    const dx = b.x - a.x;
+    const dy = b.y - a.y;
+    const lengthSquared = dx * dx + dy * dy;
+    const t = lengthSquared === 0 ? 0 : Math.max(0, Math.min(1, ((pointer.x - a.x) * dx + (pointer.y - a.y) * dy) / lengthSquared));
+    return Math.hypot(pointer.x - a.x - t * dx, pointer.y - a.y - t * dy);
+}
+/** Group transforms use the translation command for every selected object. @internal */
+export function selectionGizmoMode(mode, kind, count) {
+    if (count > 1)
+        return "translate";
+    if (kind === "marker")
+        return mode === "scale" ? "translate" : mode;
+    if (kind === "volume")
+        return mode === "rotate" ? "translate" : mode;
+    return "translate";
+}

package/dist/handlers/context.d.ts

@@ -16,6 +16,7 @@ export interface HandlerContext {
     api: EditorHostApi;
     session: EditorSession;
     liveSync: DocumentLiveSync;
+    persistAssetUrls?: boolean;
     gameId: string;
     catalogDefinitions: readonly EditorCatalogDefinition[];
     catalogById: ReadonlyMap<string, EditorCatalogDefinition>;

package/dist/handlers/document.d.ts

@@ -1,3 +1,3 @@
 import type { HandlerTable } from "./context.js";
 /** Document, selection, camera, mode, asset placement, and status verbs. */
-export declare const documentHandlers: Pick<HandlerTable, "editor_status" | "set_mode" | "perf_report" | "list_layers" | "list_selection" | "get_marker" | "get_volume" | "set_transform" | "set_volume" | "set_path" | "add_path" | "add_marker" | "set_marker" | "set_note" | "set_meta" | "apply_preset" | "select" | "clear_selection" | "camera_goto" | "camera_frame" | "scene_summary" | "export_document" | "import_document" | "dispatch" | "undo" | "redo" | "list_assets" | "place_asset" | "batch_set_properties" | "assign_material" | "set_object_flags">;
+export declare const documentHandlers: Pick<HandlerTable, "editor_status" | "set_mode" | "perf_report" | "list_layers" | "list_selection" | "get_marker" | "get_volume" | "set_transform" | "set_volume" | "set_path" | "add_path" | "add_marker" | "set_marker" | "set_note" | "set_meta" | "apply_preset" | "select" | "clear_selection" | "camera_goto" | "camera_frame" | "scene_summary" | "get_simulation" | "set_simulation" | "export_document" | "import_document" | "dispatch" | "undo" | "redo" | "list_assets" | "place_asset" | "batch_set_properties" | "list_material_assets" | "list_material_slots" | "upsert_material_asset" | "remove_material_asset" | "assign_material_asset" | "clear_material_assets" | "assign_material" | "set_object_flags">;

package/dist/handlers/document.js

@@ -1,3 +1,4 @@
+import { parseEditorMaterialAsset } from "@jgengine/core/editor/materialAuthoring";
 import { editorDocumentBounds, listEditorKinds, summarizeEditorSession, } from "@jgengine/core/editor/index";
 import { resolvePlaceAsset, toEditorMarker } from "@jgengine/core/world/placeAsset";
 import { findSchemaPreset, getSceneKind, validateParams } from "@jgengine/core/scene/sceneKinds";
@@ -182,6 +183,7 @@ export const documentHandlers = {
             ...(request.rotationY === undefined ? {} : { rotationY: request.rotationY }),
             ...(request.color === undefined ? {} : { color: request.color }),
             ...(request.label === undefined ? {} : { label: request.label }),
+            ...(request.catalogId === undefined ? {} : { catalogId: request.catalogId }),
             ...(request.meta === undefined ? {} : { meta: request.meta }),
         };
         // addMarker re-ids on a document-global collision, so read the created id back from the selection.
@@ -207,6 +209,7 @@ export const documentHandlers = {
                 ...(request.color === undefined ? {} : { color: request.color }),
                 ...(request.label === undefined ? {} : { label: request.label }),
                 ...(request.rotationY === undefined ? {} : { rotationY: request.rotationY }),
+                ...(request.catalogId === undefined ? {} : { catalogId: request.catalogId }),
                 ...(merged === undefined ? {} : { meta: merged }),
             },
         });
@@ -312,6 +315,11 @@ export const documentHandlers = {
         ctx.api.setFocusTarget(target);
         return { ok: true, result: { target, bounds } };
     },
+    get_simulation: (ctx) => ({ ok: true, result: { simulation: structuredClone(ctx.session.getState().document.simulation ?? {}) } }),
+    set_simulation: (ctx, request) => {
+        ctx.session.dispatch({ type: "setSimulation", simulation: request.simulation === null ? undefined : request.simulation });
+        return { ok: true, result: { simulation: structuredClone(ctx.session.getState().document.simulation ?? {}) } };
+    },
     scene_summary: (ctx) => ({
         ok: true,
         result: {
@@ -359,7 +367,7 @@ export const documentHandlers = {
             kind: request.kind,
             knownKind: asset?.kind,
             knownLabel: asset?.label,
-            knownUrl: asset?.url,
+            knownUrl: ctx.persistAssetUrls === false ? undefined : asset?.url,
         });
         const placedMarker = toEditorMarker(placed);
         // URL-backed catalog models need a first-class catalogId so AuthoredObjects places the mesh;
@@ -409,6 +417,28 @@ export const documentHandlers = {
         });
         return { ok: true, result: summarizeEditorSession(ctx.session.getState()) };
     },
+    list_material_assets: (ctx) => ({ ok: true, result: { assets: ctx.session.getState().document.materialAssets ?? [], assignments: ctx.session.getState().document.markers.filter((marker) => marker.meta?.materialAssignments !== undefined).map((marker) => ({ id: marker.id, assignments: marker.meta.materialAssignments })) } }),
+    list_material_slots: (ctx, request) => {
+        const inventory = ctx.api.getMaterialSlots(request.id);
+        return inventory.status === "ready" ? { ok: true, result: inventory } : { ok: false, result: inventory, error: inventory.status === "loading" ? "Material slots are still loading." : inventory.reason };
+    },
+    upsert_material_asset: (ctx, request) => {
+        const asset = parseEditorMaterialAsset(request.asset);
+        ctx.session.dispatch({ type: "upsertMaterialAsset", asset }, request.coalesce === undefined ? undefined : { coalesce: request.coalesce });
+        return { ok: true, result: { asset } };
+    },
+    remove_material_asset: (ctx, request) => {
+        const result = ctx.session.transaction([{ type: "removeMaterialAsset", id: request.id }]);
+        return result.ok ? { ok: true, result: summarizeEditorSession(result.state) } : { ok: false, error: result.error };
+    },
+    assign_material_asset: (ctx, request) => {
+        const result = ctx.session.transaction([{ type: "assignMaterialAsset", ids: request.ids, materialId: request.materialId, selector: request.selector }]);
+        return result.ok ? { ok: true, result: summarizeEditorSession(result.state) } : { ok: false, error: result.error };
+    },
+    clear_material_assets: (ctx, request) => {
+        const result = ctx.session.transaction([{ type: "clearMaterialAssets", ids: request.ids }]);
+        return result.ok ? { ok: true, result: summarizeEditorSession(result.state) } : { ok: false, error: result.error };
+    },
     assign_material: (ctx, request) => {
         if (!documentHasAnyId(ctx.session.getState().document, request.ids)) {
             return { ok: false, error: "assign_material matched no objects" };

package/dist/handlers/hierarchy.d.ts

@@ -1,3 +1,3 @@
 import type { HandlerTable } from "./context.js";
 /** Parent/child hierarchy and prefab library verbs. */
-export declare const hierarchyHandlers: Pick<HandlerTable, "set_parent" | "hierarchy" | "list_prefabs" | "create_prefab" | "insert_prefab" | "detach_prefab_instance" | "delete_prefab">;
+export declare const hierarchyHandlers: Pick<HandlerTable, "set_parent" | "hierarchy" | "list_prefabs" | "create_prefab" | "insert_prefab" | "detach_prefab_instance" | "delete_prefab" | "set_prefab_static_bake">;

package/dist/handlers/hierarchy.js

@@ -45,6 +45,10 @@ export const hierarchyHandlers = {
         ctx.session.dispatch({ type: "detachPrefabInstance", instanceId: request.instanceId });
         return { ok: true, result: summarizeEditorSession(ctx.session.getState()) };
     },
+    set_prefab_static_bake: (ctx, request) => {
+        const result = ctx.session.transaction([{ type: "setPrefabStaticBake", prefabId: request.prefabId, bake: request.bake }]);
+        return result.ok ? { ok: true, result: findEditorPrefab(ctx.session.getState().document, request.prefabId) } : { ok: false, error: result.error };
+    },
     delete_prefab: (ctx, request) => {
         if (findEditorPrefab(ctx.session.getState().document, request.prefabId) === undefined) {
             return { ok: false, error: `prefab not found: ${request.prefabId}` };