@jgengine/editor 0.10.0 → 0.12.0

package/dist/TerrainReadoutHud.d.ts

@@ -0,0 +1,9 @@
+import type { TerrainReadoutStore } from "./terrainReadoutStore.js";
+/**
+ * The measurable terrain-readability legend: cursor elevation and delta from the `y = 0` reference,
+ * plus the region's min/max/mean relief and the active contour interval. Reads live measurements from
+ * the readout store the {@link TerrainReadout} overlay publishes; renders nothing until shown.
+ */
+export declare function TerrainReadoutHud({ readout }: {
+    readout: TerrainReadoutStore;
+}): import("react").JSX.Element;

package/dist/TerrainReadoutHud.js

@@ -0,0 +1,20 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useStoreSelector } from "./useStoreSelector.js";
+function fmt(value) {
+    return (Math.round(value * 100) / 100).toFixed(2);
+}
+function signed(value) {
+    const text = fmt(value);
+    return value > 0 ? `+${text}` : text;
+}
+/**
+ * The measurable terrain-readability legend: cursor elevation and delta from the `y = 0` reference,
+ * plus the region's min/max/mean relief and the active contour interval. Reads live measurements from
+ * the readout store the {@link TerrainReadout} overlay publishes; renders nothing until shown.
+ */
+export function TerrainReadoutHud({ readout }) {
+    const cursor = useStoreSelector(readout, (s) => s.cursor);
+    const summary = useStoreSelector(readout, (s) => s.summary);
+    const interval = useStoreSelector(readout, (s) => s.interval);
+    return (_jsxs("div", { className: "pointer-events-none absolute bottom-3 left-3 z-40 min-w-[180px] rounded-lg border border-white/[0.08] bg-black/70 px-3 py-2 font-mono text-[11px] leading-relaxed text-neutral-200 shadow-lg shadow-black/40 backdrop-blur-md", children: [_jsx("div", { className: "mb-1 text-[10px] font-semibold uppercase tracking-widest text-neutral-500", children: "Elevation" }), _jsxs("div", { className: "flex justify-between gap-4", children: [_jsx("span", { className: "text-neutral-400", children: "cursor" }), _jsx("span", { children: cursor === null ? "—" : `${fmt(cursor.height)} (${signed(cursor.delta)})` })] }), summary !== null ? (_jsxs(_Fragment, { children: [_jsxs("div", { className: "flex justify-between gap-4", children: [_jsx("span", { className: "text-neutral-400", children: "min / max" }), _jsxs("span", { children: [fmt(summary.min), " / ", fmt(summary.max)] })] }), _jsxs("div", { className: "flex justify-between gap-4", children: [_jsx("span", { className: "text-neutral-400", children: "mean / relief" }), _jsxs("span", { children: [fmt(summary.mean), " / ", fmt(summary.range)] })] }), _jsxs("div", { className: "flex justify-between gap-4", children: [_jsx("span", { className: "text-neutral-400", children: "contour" }), _jsx("span", { children: interval > 0 ? `${fmt(interval)} m` : "flat" })] })] })) : (_jsx("div", { className: "text-neutral-500", children: "no terrain sampled" }))] }));
+}

package/dist/TerrainSculpt.js

@@ -2,12 +2,13 @@ import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-run
 import { useThree } from "@react-three/fiber";
 import { memo, useEffect, useMemo, useRef, useState } from "react";
 import * as THREE from "three";
-import { createTerrainPaletteSampler } from "@jgengine/core/world/terrain";
+import { createTerrainPaletteSampler, raycastHeightField, } from "@jgengine/core/world/terrain";
 import { beginSurfaceStroke, beginTerraformStroke, editableTerrainFromSnapshot, } from "@jgengine/core/world/terraform";
 import { useGameContext } from "@jgengine/react/provider";
-import { normalizeHeightBlend, TerraformBrushCursor } from "@jgengine/shell/terrain";
+import { displaceHeightfieldGeometry, normalizeHeightBlend, TerraformBrushCursor, } from "@jgengine/shell/terrain";
 import { editorPerfMarks } from "./perfMarks.js";
-import { TERRAIN_MATERIAL_COLORS } from "./uiStore.js";
+import { TERRAIN_MATERIAL_COLORS, } from "./uiStore.js";
+import { useStoreSelector } from "./useStoreSelector.js";
 const GROUND_PLANE = new THREE.Plane(new THREE.Vector3(0, 1, 0), 0);
 const LOW = new THREE.Color("#3f5d34");
 const HIGH = new THREE.Color("#8f9c66");
@@ -64,9 +65,18 @@ function editFromSettings(settings, center, clickHeight) {
         ...(heightLimit === undefined ? {} : { heightLimit }),
     };
 }
-const PAINT_TINT = new THREE.Color();
 const BLEND_A = new THREE.Color();
 const BLEND_B = new THREE.Color();
+/** Parsed once — `toneAt` runs per vertex, so hex→Color parsing must not. */
+const SURFACE_COLOR_CACHE = new Map();
+function surfaceColor(hex) {
+    let color = SURFACE_COLOR_CACHE.get(hex);
+    if (color === undefined) {
+        color = new THREE.Color(hex);
+        SURFACE_COLOR_CACHE.set(hex, color);
+    }
+    return color;
+}
 /** World-unit spacing between topographic relief bands drawn on the sculpt preview. */
 const CONTOUR_INTERVAL = 1.5;
 /**
@@ -92,7 +102,7 @@ function applyRelief(out, height, strength) {
  * default — so `materialRegions`/base `colors`/`material` (worn paths, rock outcrops, biome tint)
  * show through in the editor the same way `TerrainGround` renders them at runtime.
  */
-function toneAt(terrain, x, z, height, out, paletteAt, heightRange) {
+function toneAt(terrain, x, z, height, out, paletteAt, heightRange, layerColors) {
     const layers = terrain.layers;
     if (layers.length > 0) {
         const weights = terrain.weightsAt(x, z);
@@ -105,10 +115,10 @@ function toneAt(terrain, x, z, height, out, paletteAt, heightRange) {
                 const w = weights[l] * (layers[l].opacity ?? 1);
                 if (w <= 0)
                     continue;
-                BLEND_B.set(layerColor(layers[l]));
-                r += BLEND_B.r * w;
-                g += BLEND_B.g * w;
-                b += BLEND_B.b * w;
+                const color = layerColors[l];
+                r += color.r * w;
+                g += color.g * w;
+                b += color.b * w;
                 total += w;
             }
             if (total > 0) {
@@ -120,7 +130,7 @@ function toneAt(terrain, x, z, height, out, paletteAt, heightRange) {
     const surface = terrain.surfaceAt(x, z);
     const painted = surface === null ? undefined : TERRAIN_MATERIAL_COLORS[surface];
     if (painted !== undefined) {
-        out.copy(PAINT_TINT.set(painted));
+        out.copy(surfaceColor(painted));
         return;
     }
     if (paletteAt !== null) {
@@ -133,42 +143,35 @@ function toneAt(terrain, x, z, height, out, paletteAt, heightRange) {
     out.copy(BLEND_A.copy(LOW).lerp(HIGH, t));
 }
 /**
- * Re-samples vertex Y and vertex color from the live terrain (in place — no reallocation). When a
- * dirty `region` is given, only vertices inside it re-sample — the whole-mesh resample per stamp is
- * the sculpt hot path — while normals recompute across the mesh for seamless shading. Painted/blended
- * layers win the vertex color; unpainted ground falls back to the runtime terrain palette (or the
- * flat height gradient with no descriptor). Records rebuild time.
+ * Re-samples vertex Y, vertex color, and vertex normals from the live terrain via the shared
+ * {@link displaceHeightfieldGeometry} primitive. A dirty `region` keeps a brush stamp O(brush
+ * footprint) — no whole-mesh normal or bounding pass per stamp. Painted/blended layers win the
+ * vertex color; unpainted ground falls back to the runtime terrain palette (or the flat height
+ * gradient with no descriptor). Records rebuild time.
  */
 function displace(geometry, terrain, bounds, region, paletteAt, heightRange, contourStrength) {
     const started = performance.now();
-    const position = geometry.attributes.position;
-    const cx = (bounds.minX + bounds.maxX) / 2;
-    const cz = (bounds.minZ + bounds.maxZ) / 2;
-    let colors = geometry.attributes.color;
-    const full = region === null || colors === undefined || colors.count !== position.count;
-    if (colors === undefined || colors.count !== position.count) {
-        colors = new THREE.BufferAttribute(new Float32Array(position.count * 3), 3);
-        geometry.setAttribute("color", colors);
-    }
-    const tone = new THREE.Color();
-    for (let index = 0; index < position.count; index += 1) {
-        const x = position.getX(index) + cx;
-        const z = position.getZ(index) + cz;
-        if (!full && (x < region.minX || x > region.maxX || z < region.minZ || z > region.maxZ))
-            continue;
-        const height = terrain.sampleHeight(x, z);
-        position.setY(index, height);
-        toneAt(terrain, x, z, height, tone, paletteAt, heightRange);
-        applyRelief(tone, height, contourStrength);
-        colors.setXYZ(index, tone.r, tone.g, tone.b);
-    }
-    position.needsUpdate = true;
-    colors.needsUpdate = true;
-    geometry.computeVertexNormals();
-    geometry.computeBoundingSphere();
+    const layerColors = terrain.layers.map((layer) => surfaceColor(layerColor(layer)));
+    displaceHeightfieldGeometry(geometry, terrain.sampleHeight, {
+        bounds,
+        region,
+        color: (x, z, height, out) => {
+            toneAt(terrain, x, z, height, out, paletteAt, heightRange, layerColors);
+            applyRelief(out, height, contourStrength);
+        },
+    });
     editorPerfMarks.record("rebuild", performance.now() - started);
 }
-function SculptMesh({ terrain, bounds, segments, revision, regionRef, meshRef, paletteAt, heightRange, contourStrength, }) {
+function unionRect(a, b) {
+    return {
+        minX: Math.min(a.minX, b.minX),
+        minZ: Math.min(a.minZ, b.minZ),
+        maxX: Math.max(a.maxX, b.maxX),
+        maxZ: Math.max(a.maxZ, b.maxZ),
+    };
+}
+/** 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 geometry = useMemo(() => {
         const width = Math.max(1, bounds.maxX - bounds.minX);
         const depth = Math.max(1, bounds.maxZ - bounds.minZ);
@@ -179,10 +182,33 @@ function SculptMesh({ terrain, bounds, segments, revision, regionRef, meshRef, p
     }, [boundsKey(bounds, segments)]);
     useEffect(() => () => geometry.dispose(), [geometry]);
     useEffect(() => {
-        displace(geometry, terrain, bounds, regionRef.current, paletteAt, heightRange, contourStrength);
+        // Consume the queued work; a re-run triggered by anything other than a stamp (palette,
+        // contour strength, fresh geometry) sees no pending entry and rebuilds the whole mesh.
+        const pending = pendingRef.current;
+        pendingRef.current = null;
+        const region = pending !== null && pending.kind === "region" ? pending.region : null;
+        displace(geometry, terrain, bounds, region, paletteAt, heightRange, contourStrength);
         // eslint-disable-next-line react-hooks/exhaustive-deps
     }, [geometry, terrain, revision, paletteAt, heightRange, contourStrength]);
-    return (_jsx("mesh", { ref: meshRef, geometry: geometry, receiveShadow: true, children: _jsx("meshStandardMaterial", { vertexColors: true, roughness: 0.95, metalness: 0, polygonOffset: true, polygonOffsetFactor: -1, polygonOffsetUnits: -1 }) }));
+    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) {
+    return {
+        tool: state.tool,
+        terrainMode: state.terrainMode,
+        sculptRadius: state.sculpt.radius,
+        sculptBrush: state.sculpt.brush,
+        sculptInvert: state.sculpt.invert,
+        paintRadius: state.paint.radius,
+    };
+}
+function sculptUiEqual(a, b) {
+    return (a.tool === b.tool &&
+        a.terrainMode === b.terrainMode &&
+        a.sculptRadius === b.sculptRadius &&
+        a.sculptBrush === b.sculptBrush &&
+        a.sculptInvert === b.sculptInvert &&
+        a.paintRadius === b.paintRadius);
 }
 /**
  * Terrain-sculpt viewport layer: renders the editable heightfield and, while the terrain tool is
@@ -199,26 +225,35 @@ export const TerrainSculpt = memo(function TerrainSculpt({ api, ui, world, }) {
     const terrainDescriptor = useMemo(() => terrainDescriptorOf(world), [world]);
     const paletteAt = useMemo(() => (terrainDescriptor === undefined ? null : createTerrainPaletteSampler(terrainDescriptor)), [terrainDescriptor]);
     const heightRange = useMemo(() => (terrainDescriptor === undefined ? [0, 1] : heightRangeOf(terrainDescriptor)), [terrainDescriptor]);
-    const [, setTick] = useState(0);
-    useEffect(() => session.subscribe(() => setTick((value) => value + 1)), [session]);
-    useEffect(() => ui.subscribe(() => setTick((value) => value + 1)), [ui]);
-    const snapshot = session.getState().document.terrain ?? null;
+    // Selector subscriptions: only the terrain snapshot and the sculpt-relevant UI slice re-render
+    // this layer — selection changes, marker edits, and unrelated UI churn no longer touch it.
+    const snapshot = useStoreSelector(session, (state) => state.document.terrain ?? null);
+    const uiSlice = useStoreSelector(ui, selectSculptUi, sculptUiEqual);
     const base = ctx.world.ground;
-    const uiState = ui.getState();
-    const toolActive = uiState.tool === "terrain";
+    const toolActive = uiSlice.tool === "terrain";
     const editableRef = useRef(null);
     const boundsRef = useRef(null);
-    const meshRef = useRef(null);
     const syncedRef = useRef(null);
     const gridKeyRef = useRef(null);
-    const regionRef = useRef(null);
+    const pendingRef = useRef({ kind: "full" });
     const [revision, setRevision] = useState(0);
     const [cursor, setCursor] = useState(null);
     const segments = snapshot === null ? 0 : segmentsFor(snapshot);
     const gridKey = snapshot === null ? null : `${boundsKey(snapshot.bounds, segments)}:${snapshot.cellSize}`;
-    // region === null forces a whole-mesh rebuild; a stamp passes only its dirty footprint.
+    // region === null queues a whole-mesh rebuild; a stamp queues only its dirty footprint. Queued
+    // regions union (two stamps before an effect flush both get displaced), and a queued full
+    // rebuild is never downgraded by a later stamp.
     const refresh = (region = null) => {
-        regionRef.current = region;
+        const pending = pendingRef.current;
+        if (region === null || pending?.kind === "full") {
+            pendingRef.current = { kind: "full" };
+        }
+        else if (pending === null) {
+            pendingRef.current = { kind: "region", region };
+        }
+        else {
+            pendingRef.current = { kind: "region", region: unionRect(pending.region, region) };
+        }
         setRevision((value) => value + 1);
     };
     // Rebuild the live terrain when the grid changes; otherwise re-sync offsets on undo/redo/import.
@@ -257,15 +292,19 @@ export const TerrainSculpt = memo(function TerrainSculpt({ api, ui, world, }) {
         let last = null;
         const pick = (clientX, clientY) => {
             const started = performance.now();
-            const mesh = meshRef.current;
             const rect = canvas.getBoundingClientRect();
             ndc.set(((clientX - rect.left) / rect.width) * 2 - 1, -((clientY - rect.top) / rect.height) * 2 + 1);
             raycaster.setFromCamera(ndc, camera);
             let result = null;
-            if (mesh !== null) {
-                const hit = raycaster.intersectObject(mesh, false)[0];
-                if (hit !== undefined)
-                    result = { x: hit.point.x, z: hit.point.z };
+            // Heightfield raymarch against the live terrain — O(steps along the ray) instead of a
+            // brute-force triangle raycast against the whole preview mesh on every pointer move.
+            const terrain = editableRef.current;
+            const terrainBounds = boundsRef.current;
+            if (terrain !== null && terrainBounds !== null) {
+                const { origin, direction } = raycaster.ray;
+                const hit = raycastHeightField(terrain.sampleHeight, [origin.x, origin.y, origin.z], [direction.x, direction.y, direction.z], { bounds: terrainBounds, step: Math.max(0.25, (snapshot?.cellSize ?? 1) / 2) });
+                if (hit !== null)
+                    result = { x: hit.x, z: hit.z };
             }
             if (result === null && raycaster.ray.intersectPlane(GROUND_PLANE, planeHit) !== null) {
                 result = { x: planeHit.x, z: planeHit.z };
@@ -411,5 +450,5 @@ export const TerrainSculpt = memo(function TerrainSculpt({ api, ui, world, }) {
     }, [toolActive, snapshot, gl, camera, controls, session, ui]);
     if (snapshot === null || editableRef.current === null || boundsRef.current === null)
         return null;
-    return (_jsxs(_Fragment, { children: [_jsx(SculptMesh, { terrain: editableRef.current, bounds: boundsRef.current, segments: segments, revision: revision, regionRef: regionRef, meshRef: meshRef, paletteAt: paletteAt, heightRange: heightRange, contourStrength: toolActive ? 1 : 0.45 }), toolActive && cursor !== null ? (_jsx(TerraformBrushCursor, { center: [cursor.x, cursor.z], y: cursor.y + 0.1, radius: uiState.terrainMode === "paint" ? uiState.paint.radius : uiState.sculpt.radius, mode: uiState.terrainMode === "paint" ? "paint" : effectiveBrush(uiState.sculpt.brush, uiState.sculpt.invert) })) : null] }));
+    return (_jsxs(_Fragment, { children: [_jsx(SculptMesh, { terrain: editableRef.current, bounds: boundsRef.current, segments: segments, revision: revision, pendingRef: pendingRef, paletteAt: paletteAt, heightRange: heightRange, contourStrength: toolActive ? 1 : 0.45 }), toolActive && cursor !== null ? (_jsx(TerraformBrushCursor, { center: [cursor.x, cursor.z], y: cursor.y + 0.1, radius: uiSlice.terrainMode === "paint" ? uiSlice.paintRadius : uiSlice.sculptRadius, mode: uiSlice.terrainMode === "paint" ? "paint" : effectiveBrush(uiSlice.sculptBrush, uiSlice.sculptInvert) })) : null] }));
 });

package/dist/agent/AgentPanel.d.ts

@@ -5,9 +5,12 @@ import { createDefaultAgentEndpoint } from "./endpoint.js";
  * Tool calls route through `EditorHostApi.handle`; patches appear in the transcript and can be undone.
  * @internal — mounted by `EditorChrome`.
  */
-export declare function AgentPanel({ api, onClose, }: {
+export declare function AgentPanel({ api, onClose, embedded, }: {
     api: EditorHostApi;
-    onClose: () => void;
+    /** Close affordance for the side-dock variant; omit when the host owns dismissal. */
+    onClose?: () => void;
+    /** Fill the parent (bottom-dock tab) instead of rendering the resizable right aside. */
+    embedded?: boolean;
 }): import("react").JSX.Element;
 /** Re-export for hosts that want a default endpoint without the panel. */
 export { createDefaultAgentEndpoint };

package/dist/agent/AgentPanel.js

@@ -1,6 +1,9 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
-import { BTN, INPUT, MICRO } from "../chromeStyles.js";
+import { BORDER, CONTROL, FOCUS_RING, INPUT_CLS, MICRO_LABEL, PANEL_BG } from "../shell/theme.js";
+const BTN = `${CONTROL} px-2 py-1 text-[11px] disabled:opacity-40`;
+const INPUT = `px-2 py-1 ${INPUT_CLS}`;
+const MICRO = MICRO_LABEL;
 import { createDefaultAgentEndpoint, createHttpAgentEndpoint, createLocalAgentEndpoint, EDITOR_AGENT_KEY_ENV, EDITOR_AGENT_URL_ENV, resolveAgentEndpointConfig, } from "./endpoint.js";
 import { packAgentContext } from "./context.js";
 import { runAgentTurn, undoAgentPatch, } from "./turn.js";
@@ -28,7 +31,7 @@ function buildEndpoint(url, apiKey) {
  * Tool calls route through `EditorHostApi.handle`; patches appear in the transcript and can be undone.
  * @internal — mounted by `EditorChrome`.
  */
-export function AgentPanel({ api, onClose, }) {
+export function AgentPanel({ api, onClose, embedded = false, }) {
     const stored = useMemo(() => readStoredConfig(), []);
     const [url, setUrl] = useState(stored.url);
     const [apiKey, setApiKey] = useState(stored.apiKey);
@@ -110,21 +113,23 @@ export function AgentPanel({ api, onClose, }) {
         setContextTick((v) => v + 1);
     }, [api, patches]);
     const envHint = resolveAgentEndpointConfig();
-    return (_jsxs("aside", { className: "pointer-events-auto flex w-80 min-w-64 max-w-[48vw] resize-x flex-col overflow-hidden border-l border-white/[0.08] bg-[#0d0f13]/95 backdrop-blur-md", children: [_jsxs("div", { className: "flex items-center gap-2 border-b border-white/[0.08] px-2 py-2", children: [_jsx("div", { className: MICRO, children: "Agent" }), _jsx("span", { className: `rounded-full px-1.5 py-0.5 text-[9px] font-semibold uppercase tracking-wider ${endpoint.id === "http"
+    return (_jsxs("aside", { className: embedded
+            ? "pointer-events-auto flex min-h-0 flex-1 flex-col overflow-hidden"
+            : `pointer-events-auto flex w-80 min-w-64 max-w-[48vw] resize-x flex-col overflow-hidden border-l ${BORDER} ${PANEL_BG}/95 backdrop-blur-md`, children: [_jsxs("div", { className: `flex items-center gap-2 border-b ${BORDER} px-2 py-2`, children: [_jsx("div", { className: MICRO, children: "Agent" }), _jsx("span", { className: `rounded-full px-1.5 py-0.5 text-[9px] font-semibold uppercase tracking-wider ${endpoint.id === "http"
                             ? "bg-violet-500/20 text-violet-200 ring-1 ring-inset ring-violet-400/30"
-                            : "bg-white/[0.06] text-neutral-400 ring-1 ring-inset ring-white/10"}`, title: endpoint.id === "http" ? "Remote endpoint" : "Local offline agent", children: endpoint.id }), _jsx("button", { type: "button", className: `${BTN} ml-auto text-[10px]`, onClick: () => setShowConfig((v) => !v), children: "Config" }), _jsx("button", { type: "button", className: "rounded-md px-2 py-1 text-neutral-500 transition-colors hover:bg-white/10 hover:text-neutral-200", onClick: onClose, "aria-label": "Close agent panel", children: "\u00D7" })] }), showConfig ? (_jsxs("div", { className: "space-y-2 border-b border-white/[0.08] p-2", children: [_jsx("div", { className: `${MICRO} text-neutral-500`, children: "Endpoint" }), _jsx("input", { className: `w-full text-[11px] ${INPUT}`, placeholder: `${EDITOR_AGENT_URL_ENV} or https://…`, value: url, onChange: (event) => setUrl(event.target.value), onBlur: persistConfig }), _jsx("input", { className: `w-full text-[11px] ${INPUT}`, type: "password", placeholder: `${EDITOR_AGENT_KEY_ENV} / ANTHROPIC_API_KEY`, value: apiKey, onChange: (event) => setApiKey(event.target.value), onBlur: persistConfig }), _jsxs("p", { className: "text-[10px] leading-snug text-neutral-500", children: ["Env: ", EDITOR_AGENT_URL_ENV, envHint.url !== undefined ? " ✓" : " (unset)", " \u00B7 ", EDITOR_AGENT_KEY_ENV, envHint.apiKey !== undefined ? " ✓" : " (unset)", ". Empty URL uses the local command agent (/help). Remote: POST JSON ", "{messages,context,tools}", " \u2192 ", "{message?,toolCalls?}", "."] }), _jsx("button", { type: "button", className: BTN, onClick: () => {
+                            : "bg-white/[0.06] text-neutral-400 ring-1 ring-inset ring-white/10"}`, title: endpoint.id === "http" ? "Remote endpoint" : "Local offline agent", children: endpoint.id }), _jsx("button", { type: "button", className: `${BTN} ml-auto text-[10px]`, onClick: () => setShowConfig((v) => !v), children: "Config" }), onClose !== undefined ? (_jsx("button", { type: "button", className: `rounded-[5px] px-2 py-1 text-neutral-500 transition-colors hover:bg-white/10 hover:text-neutral-200 ${FOCUS_RING}`, onClick: onClose, "aria-label": "Close agent panel", children: "\u00D7" })) : null] }), showConfig ? (_jsxs("div", { className: `space-y-2 border-b ${BORDER} p-2`, children: [_jsx("div", { className: MICRO, children: "Endpoint" }), _jsx("input", { className: `w-full text-[11px] ${INPUT}`, placeholder: `${EDITOR_AGENT_URL_ENV} or https://…`, value: url, onChange: (event) => setUrl(event.target.value), onBlur: persistConfig }), _jsx("input", { className: `w-full text-[11px] ${INPUT}`, type: "password", placeholder: `${EDITOR_AGENT_KEY_ENV} / ANTHROPIC_API_KEY`, value: apiKey, onChange: (event) => setApiKey(event.target.value), onBlur: persistConfig }), _jsxs("p", { className: "text-[10px] leading-snug text-neutral-500", children: ["Env: ", EDITOR_AGENT_URL_ENV, envHint.url !== undefined ? " ✓" : " (unset)", " \u00B7 ", EDITOR_AGENT_KEY_ENV, envHint.apiKey !== undefined ? " ✓" : " (unset)", ". Empty URL uses the local command agent (/help). Remote: POST JSON ", "{messages,context,tools}", " \u2192 ", "{message?,toolCalls?}", "."] }), _jsx("button", { type: "button", className: BTN, onClick: () => {
                             setUrl("");
                             setApiKey("");
                             if (typeof localStorage !== "undefined") {
                                 localStorage.removeItem(STORAGE_URL);
                                 localStorage.removeItem(STORAGE_KEY);
                             }
-                        }, children: "Use local agent" })] })) : null, _jsxs("div", { className: "border-b border-white/[0.08] px-2 py-1.5 text-[10px] text-neutral-500", children: [_jsx("span", { className: "text-neutral-400", children: context.mode }), _jsx("span", { className: "mx-1.5 text-neutral-700", children: "\u00B7" }), _jsxs("span", { children: ["sel ", context.selection.length === 0 ? "—" : context.selection.slice(0, 3).join(", "), context.selection.length > 3 ? ` +${context.selection.length - 3}` : ""] }), _jsx("span", { className: "mx-1.5 text-neutral-700", children: "\u00B7" }), _jsxs("span", { children: [context.summary.markers, "m ", context.summary.volumes, "v ", context.summary.paths, "p"] })] }), _jsxs("div", { ref: listRef, className: "min-h-0 flex-1 space-y-2 overflow-auto p-2", children: [transcript.length === 0 ? (_jsxs("div", { className: "rounded-lg border border-dashed border-white/10 bg-black/20 p-3 text-[11px] leading-relaxed text-neutral-500", children: ["Chat drives the live scene through the same RPC verbs as the MCP bridge. Edits share undo with the toolbar. Local: try ", _jsx("code", { className: "text-cyan-300", children: "/status" }), ",", " ", _jsx("code", { className: "text-cyan-300", children: "/help" }), ", or", " ", _jsx("code", { className: "text-cyan-300", children: "move id x y z" }), "."] })) : null, transcript.map((entry) => (_jsx(TranscriptRow, { entry: entry, patches: patches, onUndo: onUndoPatch }, entry.id))), busy ? _jsx("div", { className: "text-[10px] text-violet-300", children: "Thinking\u2026" }) : null] }), patches.some((p) => !p.undone) ? (_jsxs("div", { className: "max-h-28 overflow-auto border-t border-white/[0.08] p-2", children: [_jsx("div", { className: `${MICRO} mb-1`, children: "Agent patches" }), _jsx("ul", { className: "space-y-1", children: patches
+                        }, children: "Use local agent" })] })) : null, _jsxs("div", { className: `border-b ${BORDER} px-2 py-1.5 text-[10px] text-neutral-500`, children: [_jsx("span", { className: "text-neutral-400", children: context.mode }), _jsx("span", { className: "mx-1.5 text-neutral-700", children: "\u00B7" }), _jsxs("span", { children: ["sel ", context.selection.length === 0 ? "—" : context.selection.slice(0, 3).join(", "), context.selection.length > 3 ? ` +${context.selection.length - 3}` : ""] }), _jsx("span", { className: "mx-1.5 text-neutral-700", children: "\u00B7" }), _jsxs("span", { children: [context.summary.markers, "m ", context.summary.volumes, "v ", context.summary.paths, "p"] })] }), _jsxs("div", { ref: listRef, className: "min-h-0 flex-1 space-y-2 overflow-auto p-2", children: [transcript.length === 0 ? (_jsxs("div", { className: `rounded-[6px] border border-dashed ${BORDER} bg-black/20 p-3 text-[11px] leading-relaxed text-neutral-500`, children: ["Chat drives the live scene through the same RPC verbs as the MCP bridge. Edits share undo with the toolbar. Local: try ", _jsx("code", { className: "text-cyan-300", children: "/status" }), ",", " ", _jsx("code", { className: "text-cyan-300", children: "/help" }), ", or", " ", _jsx("code", { className: "text-cyan-300", children: "move id x y z" }), "."] })) : null, transcript.map((entry) => (_jsx(TranscriptRow, { entry: entry, patches: patches, onUndo: onUndoPatch }, entry.id))), busy ? _jsx("div", { className: "text-[10px] text-violet-300", children: "Thinking\u2026" }) : null] }), patches.some((p) => !p.undone) ? (_jsxs("div", { className: `max-h-28 overflow-auto border-t ${BORDER} p-2`, children: [_jsx("div", { className: `${MICRO} mb-1`, children: "Agent patches" }), _jsx("ul", { className: "space-y-1", children: patches
                             .filter((p) => !p.undone)
                             .map((patch, index, live) => {
                             const isTop = index === live.length - 1;
                             return (_jsxs("li", { className: "flex items-center gap-1 text-[10px] text-neutral-300", children: [_jsx("span", { className: "min-w-0 flex-1 truncate font-mono text-cyan-200/90", children: patch.summary }), _jsx("button", { type: "button", className: `${BTN} shrink-0 px-1.5 py-0.5 text-[10px] disabled:opacity-40`, disabled: !isTop, title: isTop ? "Undo this edit" : "Undo newer patches first", onClick: () => onUndoPatch(patch.id), children: "Undo" })] }, patch.id));
-                        }) })] })) : null, _jsxs("div", { className: "flex gap-1 border-t border-white/[0.08] p-2", children: [_jsx("input", { className: `min-w-0 flex-1 text-[12px] ${INPUT}`, placeholder: endpoint.id === "local" ? "/help · /status · move id x y z" : "Ask the agent to edit the scene…", value: input, disabled: busy, onChange: (event) => setInput(event.target.value), onKeyDown: (event) => {
+                        }) })] })) : null, _jsxs("div", { className: `flex gap-1 border-t ${BORDER} p-2`, children: [_jsx("input", { className: `min-w-0 flex-1 text-[12px] ${INPUT}`, placeholder: endpoint.id === "local" ? "/help · /status · move id x y z" : "Ask the agent to edit the scene…", value: input, disabled: busy, onChange: (event) => setInput(event.target.value), onKeyDown: (event) => {
                             if (event.key === "Enter" && !event.shiftKey) {
                                 event.preventDefault();
                                 void send();

package/dist/agent/toolBridge.js

@@ -1,4 +1,5 @@
 import { decodeEditorBridgeRequest } from "../mcp/rpcRequest.js";
+import { emitEditorConsole } from "../shell/consoleSink.js";
 /** Methods that never write the document (no undo step). */
 const READ_ONLY_METHODS = new Set([
     "editor_status",
@@ -49,6 +50,7 @@ function summarizeCall(name, args, response, mutated) {
 export function routeToolCall(api, call) {
     const built = toolCallToRequest(call);
     if (!built.ok) {
+        emitEditorConsole("error", "agent", `${call.name} rejected: ${built.error}`);
         return {
             id: call.id,
             name: call.name,
@@ -58,14 +60,17 @@ export function routeToolCall(api, call) {
             patchSummary: `${call.name} rejected: ${built.error}`,
         };
     }
+    emitEditorConsole("info", "agent", `tool ${call.name}`);
     const session = api.getSession();
     const before = session.exportJson(false);
     let response;
     try {
+        // RPC failures are logged once by the host handle sink; agent layer only records the call.
         response = api.handle(built.request);
     }
     catch (error) {
         const message = error instanceof Error ? error.message : String(error);
+        emitEditorConsole("error", "agent", `${call.name} threw: ${message}`);
         return {
             id: call.id,
             name: call.name,

package/dist/assetImport.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Shared model-import helpers used by the standalone editor strip and the in-game Content Browser.
+ * Host-agnostic and free of React/shell so unit tests can exercise the importer without a DOM or three.
+ */
+/** One user-supplied model the editor can place: a stable id and a resolvable URL. */
+export interface StandaloneAsset {
+    id: string;
+    url: string;
+    label?: string;
+}
+/**
+ * Persists a dropped model file through the editor host so it survives reload as a durable catalog asset,
+ * returning the host-assigned id/url (which the manifest scan re-lists on reload). Resolves `null` when no
+ * host is listening — a plain browser mount with no dev server — so the caller can fall back to a blob URL.
+ */
+export type AssetImporter = (file: File) => Promise<StandaloneAsset | null>;
+/**
+ * Uploads a model to the editor host plugin's import endpoint and returns the durable asset it persisted.
+ * Returns `null` on any failure (no host, non-model, network error) so imports degrade to ephemeral blobs.
+ * The default {@link AssetImporter} `StandaloneEditor` and the in-game Content Browser use.
+ * @internal
+ */
+export declare function importAssetToHost(file: File, route?: string): Promise<StandaloneAsset | null>;
+/**
+ * Turns dropped files into placeable assets: each model is persisted through `importer` when a host answers,
+ * else falls back to an ephemeral `blob:` URL (lost on reload). Non-model files are skipped. Pure and
+ * host-agnostic so the import wiring is testable without a DOM.
+ * @internal
+ */
+export declare function loadDroppedAssets(files: readonly File[], importer: AssetImporter): Promise<StandaloneAsset[]>;
+/**
+ * Appends freshly dropped assets, replacing any prior entry that shares an id (re-imports stay a
+ * single catalog entry). Shared by the standalone strip and the in-game Content Browser importer.
+ * @internal
+ */
+export declare function mergeStandaloneAssets(current: readonly StandaloneAsset[], next: readonly StandaloneAsset[]): StandaloneAsset[];

package/dist/assetImport.js

@@ -0,0 +1,66 @@
+/**
+ * Shared model-import helpers used by the standalone editor strip and the in-game Content Browser.
+ * Host-agnostic and free of React/shell so unit tests can exercise the importer without a DOM or three.
+ */
+const MODEL_FILE = /\.(glb|gltf)$/i;
+/** Route the `@jgengine/node` editor host plugin persists uploaded models on; must match its `IMPORT_ROUTE`. */
+const IMPORT_ASSET_ROUTE = "/__jgengine/import-asset";
+function assetId(name) {
+    return name.replace(MODEL_FILE, "").replace(/[^a-z0-9]+/gi, "-").replace(/^-+|-+$/g, "").toLowerCase() || "asset";
+}
+/**
+ * Uploads a model to the editor host plugin's import endpoint and returns the durable asset it persisted.
+ * Returns `null` on any failure (no host, non-model, network error) so imports degrade to ephemeral blobs.
+ * The default {@link AssetImporter} `StandaloneEditor` and the in-game Content Browser use.
+ * @internal
+ */
+export async function importAssetToHost(file, route = IMPORT_ASSET_ROUTE) {
+    try {
+        const response = await fetch(route, {
+            method: "POST",
+            headers: {
+                "content-type": "application/octet-stream",
+                "x-jg-filename": encodeURIComponent(file.name),
+            },
+            body: file,
+        });
+        if (!response.ok)
+            return null;
+        const asset = (await response.json());
+        if (typeof asset.id !== "string" || typeof asset.url !== "string")
+            return null;
+        return { id: asset.id, url: asset.url, label: asset.label ?? file.name };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Turns dropped files into placeable assets: each model is persisted through `importer` when a host answers,
+ * else falls back to an ephemeral `blob:` URL (lost on reload). Non-model files are skipped. Pure and
+ * host-agnostic so the import wiring is testable without a DOM.
+ * @internal
+ */
+export async function loadDroppedAssets(files, importer) {
+    const out = [];
+    for (const file of files) {
+        if (!MODEL_FILE.test(file.name))
+            continue;
+        const persisted = await importer(file);
+        out.push(persisted ?? { id: assetId(file.name), url: URL.createObjectURL(file), label: file.name });
+    }
+    return out;
+}
+/**
+ * Appends freshly dropped assets, replacing any prior entry that shares an id (re-imports stay a
+ * single catalog entry). Shared by the standalone strip and the in-game Content Browser importer.
+ * @internal
+ */
+export function mergeStandaloneAssets(current, next) {
+    if (next.length === 0)
+        return [...current];
+    const byId = new Map(current.map((asset) => [asset.id, asset]));
+    for (const asset of next)
+        byId.set(asset.id, asset);
+    return Array.from(byId.values());
+}

package/dist/authoredComponentMeta.d.ts

@@ -0,0 +1,25 @@
+import { type TriggerSourceKind } from "@jgengine/core/scene/authoredTriggers";
+/**
+ * True when an object's meta carries an authored behavior trigger (flat on/action or a multi-list).
+ * Empty `on` / no list means the trigger component is not installed.
+ * @internal
+ */
+export declare function hasAuthoredTrigger(meta: Record<string, unknown> | undefined): boolean;
+/** True when the game has registered at least one trigger action for this target kind. @internal */
+export declare function canAuthorTrigger(target: TriggerSourceKind): boolean;
+/**
+ * Meta patch that installs a default trigger (first registered action, enter event) without
+ * inventing action ids. Returns null when no actions are registered.
+ * @internal
+ */
+export declare function defaultTriggerInstallPatch(target: TriggerSourceKind, meta: Record<string, unknown> | undefined): Record<string, unknown> | null;
+/**
+ * Meta patch that clears the trigger vocabulary keys. Action-specific params are left in place so
+ * re-adding the same action keeps prior tuning; the component is considered removed once `on`/`action`/list are gone.
+ * @internal
+ */
+export declare function clearTriggerInstallPatch(): Record<string, unknown>;
+/** True when a material assignment is present on the object. @internal */
+export declare function hasMaterialAssignment(meta: Record<string, unknown> | undefined): boolean;
+/** Meta patch that removes material assignment. @internal */
+export declare function clearMaterialAssignmentPatch(): Record<string, unknown>;

package/dist/authoredComponentMeta.js

@@ -0,0 +1,65 @@
+import { listTriggerActions, readFlatTrigger, TRIGGER_ACTION_KEY, TRIGGER_LIST_KEY, TRIGGER_ON_KEY, TRIGGER_RADIUS_KEY, } from "@jgengine/core/scene/authoredTriggers";
+import { defaultParamMeta } from "@jgengine/core/scene/sceneKinds";
+/**
+ * True when an object's meta carries an authored behavior trigger (flat on/action or a multi-list).
+ * Empty `on` / no list means the trigger component is not installed.
+ * @internal
+ */
+export function hasAuthoredTrigger(meta) {
+    if (meta === undefined)
+        return false;
+    const list = meta[TRIGGER_LIST_KEY];
+    if (Array.isArray(list) && list.length > 0)
+        return true;
+    const flat = readFlatTrigger(meta);
+    return flat.on !== "" && flat.action.length > 0;
+}
+/** True when the game has registered at least one trigger action for this target kind. @internal */
+export function canAuthorTrigger(target) {
+    return listTriggerActions(target).length > 0;
+}
+/**
+ * Meta patch that installs a default trigger (first registered action, enter event) without
+ * inventing action ids. Returns null when no actions are registered.
+ * @internal
+ */
+export function defaultTriggerInstallPatch(target, meta) {
+    const actions = listTriggerActions(target);
+    const first = actions[0];
+    if (first === undefined)
+        return null;
+    const events = first.events;
+    const on = events !== undefined && events.length > 0 ? events[0] : "enter";
+    const patch = {
+        [TRIGGER_ON_KEY]: on,
+        [TRIGGER_ACTION_KEY]: first.id,
+        [TRIGGER_LIST_KEY]: [],
+    };
+    const defaults = defaultParamMeta(first.schema);
+    for (const [key, value] of Object.entries(defaults)) {
+        if (meta?.[key] === undefined)
+            patch[key] = value;
+    }
+    return patch;
+}
+/**
+ * Meta patch that clears the trigger vocabulary keys. Action-specific params are left in place so
+ * re-adding the same action keeps prior tuning; the component is considered removed once `on`/`action`/list are gone.
+ * @internal
+ */
+export function clearTriggerInstallPatch() {
+    return {
+        [TRIGGER_ON_KEY]: "",
+        [TRIGGER_ACTION_KEY]: "",
+        [TRIGGER_LIST_KEY]: [],
+        [TRIGGER_RADIUS_KEY]: undefined,
+    };
+}
+/** True when a material assignment is present on the object. @internal */
+export function hasMaterialAssignment(meta) {
+    return typeof meta?.["materialId"] === "string" && meta["materialId"].length > 0;
+}
+/** Meta patch that removes material assignment. @internal */
+export function clearMaterialAssignmentPatch() {
+    return { materialId: undefined };
+}

package/dist/gizmoPivot.d.ts

@@ -0,0 +1,4 @@
+import type { EditorVec3 } from "@jgengine/core/editor/index";
+import type { GizmoPivot } from "./uiStore.js";
+/** Aggregate a list of positions into a pivot according to the toolbar pivot mode. @internal */
+export declare function resolvePivotPosition(positions: readonly EditorVec3[], pivot: GizmoPivot, primary: EditorVec3 | null): EditorVec3 | null;

package/dist/gizmoPivot.js

@@ -0,0 +1,34 @@
+function medianOf(values) {
+    if (values.length === 0)
+        return 0;
+    const sorted = [...values].sort((a, b) => a - b);
+    const mid = Math.floor(sorted.length / 2);
+    return sorted.length % 2 === 0 ? (sorted[mid - 1] + sorted[mid]) / 2 : sorted[mid];
+}
+function meanOf(positions) {
+    let x = 0;
+    let y = 0;
+    let z = 0;
+    for (const point of positions) {
+        x += point.x;
+        y += point.y;
+        z += point.z;
+    }
+    const n = Math.max(1, positions.length);
+    return { x: x / n, y: y / n, z: z / n };
+}
+/** Aggregate a list of positions into a pivot according to the toolbar pivot mode. @internal */
+export function resolvePivotPosition(positions, pivot, primary) {
+    if (positions.length === 0)
+        return primary;
+    if (positions.length === 1 || pivot === "origin")
+        return primary ?? positions[0];
+    if (pivot === "median") {
+        return {
+            x: medianOf(positions.map((p) => p.x)),
+            y: medianOf(positions.map((p) => p.y)),
+            z: medianOf(positions.map((p) => p.z)),
+        };
+    }
+    return meanOf(positions);
+}