@jgengine/editor 0.12.0 → 0.14.0

package/CHANGELOG.md

@@ -10,7 +10,79 @@ let consumers pick up the better stuff, not just to list what moved.
 Agents building on the published SDK can also read this programmatically:
 `import { VERSION, CHANGELOG } from "@jgengine/core/meta/changelog"` gives the
 same data as typed values, so an updater can diff its installed version against
-the latest and surface the migration steps.
+the latest and surface the migration steps. Easier still: `npx jgengine upgrade`
+run inside a game project diffs the installed `@jgengine/*` versions against the
+latest release and prints every Migrate step and Adopt-worthy addition in
+between (`--json` for structured output).
+
+## [Unreleased]
+
+<!--
+Every PR that changes `packages/*/src` records its consumer-facing change here, so
+the next release's notes are complete by construction. Add a bullet under the right
+subhead below. `bun run check-changelog` fails a source PR whose `[Unreleased]` block
+is untouched; pure refactors/tests bypass with `[skip changelog]` in a commit message.
+At publish, rename this heading to the new version and mirror the entries into
+`packages/core/src/meta/changelog.ts` (the typed `CHANGELOG` export).
+-->
+
+### Migrate
+
+- _Nothing yet._
+
+### Added
+
+### Changed
+
+### Removed
+
+## 0.14.0
+
+### Migrate
+
+- **Nothing required** — this release is additive drop-in primitives, editor authoring, CLI discovery, and fixes. Bump `@jgengine/*` pins to `^0.14.0` (CLI `jgengine` is 0.11.0; `@jgengine/github` unchanged at 0.1.0) and rebuild.
+- One behavior fix to know about: in a `rig: "chase"` game, on-foot movement and aim are now camera-relative (the chase rig reports its yaw to the shell like every other rig). If a game somehow relied on world-yaw-0 movement under a chase camera, that was the bug this fixes.
+
+### Added
+
+- One authoring gesture for scatterable coverage: `@jgengine/core/world/scatterCoverage` owns shared density/budget semantics (per-kind unit, requested→count→capped, one clamp-and-warn phrasing) for `grass_field`/`scatter`/`city`; the editor inspector leads each kind with the same Area → Assets → Density coverage section, scatter truncates to the shared 250k instance budget, and city single-sources its 2,600-lot cap.
+- **Created games ship a drive/playtest script** (#1248) — `npx jgengine create` scaffolds now include `scripts/drive.mjs` (`bun run drive`): dependency-free headless play/testing of the running game — ordered `--click`/`--key`/`--wait`/`--shot`/`--rpc` steps against the agent bridge, plus `--playtest --strict` progress/softlock verdicts off `capture.probe`. Shared Chrome/CDP machinery lives in `scripts/browser.mjs`; `scripts/shoot.mjs` is unchanged in behavior, now a thin CLI over it.
+- Editor: viewport clip preview for rigged assets (Animation dock "Clips" mode — pick a rig or placed instance, play/scrub/loop/speed any catalog clip) and an Inspector "Animation" section that authors a placement's `ModelConfig.animation` (role→clip dropdowns, auto/none, walk/run/fade, one-shot event bindings) as undoable `marker.meta.animation` edits. New subpaths: `@jgengine/editor/shell/clipPreview`, `@jgengine/editor/modelAnimationAuthoring`, `@jgengine/editor/ClipPreviewLayer`.
+- **`npx jgengine find <intent>`** — active capability discovery: searches every shipped domain's `capabilities.md` (staged inside the CLI tarball, so it works regardless of which `@jgengine/*` packages a project installed) and prints the drop-in primitive + its import for an intent like `"toggleable window"`, `inventory`, or `minimap`. Scaffolded games are now briefed (in `AGENTS.md` and the `jgengine` intake skill) to reach for it before hand-rolling a HUD/inventory/window/rig.
+- **`EntityPreview`** (`@jgengine/shell/render/EntityPreview`) — drop-in live 3D entity portrait for character screens, unit inspectors, and loadout viewers. Owns the nested `<Canvas>`, the `GameContextBridge`, and a `StudioStage` lighting rig with optional turntable / face-camera; the game passes its own `renderEntity` as children (or a native `model` + `instanceId`) and, bound to a live entity, the portrait walks/flinches/topples in sync with the world.
+- **`GameContextBridge`** (`@jgengine/react`) — re-provide the running `GameContext` across a nested React reconciler boundary (the R3F `<Canvas>`), so a game building its own preview canvas no longer re-derives the bridge by hand.
+
+### Changed
+
+- **Chase rig reports its yaw to the shell** — `ChaseRig` now writes the camera yaw back to the shared yaw ref like every other player-facing rig, so on-foot movement and aim in a `rig: "chase"` game are camera-relative instead of frozen to world yaw 0 (WASD no longer fights the camera the moment it swings behind the player). Interior views (cockpit/hood/rear) report the vehicle heading.
+- **Combat VFX no longer render as black squares under AO/DOF post-processing** (#1247) — GTAO/Bokeh scene prepasses skip overlay effects. Games with custom additive overlay effects opt out the same way: spread `POSTFX_OVERLAY_USERDATA` (`@jgengine/shell/postfx/postfxOverlay`) onto the overlay group's `userData`.
+- **`PanelHost` windows stack above the HUD by default** (`@jgengine/react`) — the host establishes its own stacking context at `zIndexBase` (default 40), so open windows always paint over stat bars / nameplates / frames instead of bleeding through. Overridable per instance.
+
+## 0.13.0
+
+### Migrate
+
+- **Nothing required** — this release is additive fixes, defaults, and new drop-in primitives. Bump `@jgengine/*` pins to `^0.13.0` (CLI `jgengine` is 0.10.0; `@jgengine/github` unchanged at 0.1.0) and rebuild.
+- Two defaults changed in the player's favor, both overridable: **offline games now persist to localStorage automatically** (#1207) and **rigged catalog assets animate by default** via clip metadata + semantic clip roles (#1209). If a game relied on rigged models staying frozen or on saves being memory-only, opt out explicitly; otherwise you get better behavior for free.
+
+### Added
+
+- **Drop-in inventory grid, window manager, and character sheet** (#1220) — `@jgengine/react` ships `InventoryGrid` (real drag/stack/split), a toggleable-window system (`panels`: bag, character sheet, spellbook-style windows with `@jgengine/core/ui/panelModel` state), and a `CharacterSheet` paperdoll, all HudTheme-skinnable — wire in a line or two instead of re-deriving from raw divs.
+- **Serializable runtime snapshots** (#1179) — capture/restore of live runtime state, including magazine state (`@jgengine/core/combat/magazine`) and stat modifiers, for saves and replication.
+- **Portable weapon plumbing** (#1211) — `@jgengine/core/combat/weaponFire` composes trigger → magazine → spread → projectile/hitscan as data, no game-local glue.
+- **Portable leveling** (#1206) and **portable damage-pool access** (#1208) — progression and damage pools exposed as genre-agnostic seams on the game context.
+- **Named combat VFX presets** (#1204) — `@jgengine/core/combat/vfxPresets`: a visible attack is one line.
+- **Runtime-measured render-bounds hitboxes** (#1227) — colliders wrap what the shell actually mounts, not the raw asset bounds.
+- **Character motion feel** — procedural part motion for rig-less part-composed characters (#1222) plus squash & stretch and death splat (#1229).
+- **City fabric** (#1191) — `streetGenerator` + `cityGenerator`, editor bake verb, street-aware lots, road junctions, grounding, and a web playground.
+- **`jgengine recipe` CLI** (#1214, #1231) — vetted wired compositions, compile-pinned against the SDK, listed and copied from the CLI.
+- **Editor/debug modes mirror to the URL** with a proper editor exit (#1203); game template ships a dependency-free WebGL screenshot script (#1202).
+
+### Changed
+
+- Offline games persist to localStorage by default (#1207); rigged assets animate by default (#1209).
+- RTS camera pan inversion fixed (#1228); sprite raycast warning silenced and duplicate nameplate health bars removed (#1194); scaffolded F2+E editor Tailwind `@source` renders its theme (#1195).
+- Outside-game DX: stat-pool no-op stability, camera-transparent decor, cleaner install/version output, headless UI-intent seam (#1223); new-game briefs direct engine bugs/gaps upstream (#1200).
 
 ## 0.12.0
 

package/dist/AssetBrowser.d.ts

@@ -5,7 +5,13 @@ export interface EditorAssetEntry {
     label: string;
     kind: "model" | "catalog" | "marker";
     url?: string;
+    /** Animation clip names from the asset index — present on rigged catalog assets. */
+    clips?: readonly string[];
 }
+/** "idle · walk · run" summary of a rigged asset's detected animation roles for the browser row badge.
+ * @internal
+ */
+export declare function describeClipRoles(clips: readonly string[]): string;
 /** Custom drag mime carrying a material id — read by hierarchy rows and the viewport drop zone. */
 export declare const MATERIAL_DRAG_MIME = "application/x-jgengine-material";
 /**
@@ -26,6 +32,7 @@ export declare function AssetBrowser({ assets, session, onPlace, }: {
 /** Turns a game's asset catalog ids into editor asset entries for the browser panel. */
 export declare function assetsFromCatalog(ids: readonly string[], resolve?: (id: string) => {
     url?: string;
+    clips?: readonly string[];
 } | null): EditorAssetEntry[];
 /**
  * Converts a durable/ephemeral standalone import into a Content Browser entry.

package/dist/AssetBrowser.js

@@ -1,6 +1,14 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useMemo, useState } from "react";
+import { rolesFromClips } from "@jgengine/core/game/clipRoles";
 import { TERRAIN_MATERIALS } from "./uiStore.js";
+/** "idle · walk · run" summary of a rigged asset's detected animation roles for the browser row badge.
+ * @internal
+ */
+export function describeClipRoles(clips) {
+    const roles = Object.keys(rolesFromClips(clips));
+    return roles.length === 0 ? "no roles detected" : roles.join(" · ");
+}
 /** Custom drag mime carrying a material id — read by hierarchy rows and the viewport drop zone. */
 export const MATERIAL_DRAG_MIME = "application/x-jgengine-material";
 /**
@@ -46,7 +54,7 @@ export function AssetBrowser({ assets, session, onPlace, }) {
             return assets;
         return assets.filter((entry) => entry.id.toLowerCase().includes(needle) || entry.label.toLowerCase().includes(needle));
     }, [assets, query]);
-    return (_jsxs("div", { className: "flex min-h-0 flex-1 flex-col gap-1", children: [_jsx(MaterialsPalette, {}), _jsx("input", { type: "search", placeholder: "Search assets\u2026", value: query, onChange: (event) => setQuery(event.target.value), className: "rounded-md border border-white/10 bg-black/40 px-2.5 py-1.5 text-neutral-100 outline-none transition-colors placeholder:text-neutral-600 focus:border-cyan-400/60 focus:bg-black/60" }), _jsxs("div", { className: "min-h-0 flex-1 space-y-0.5 overflow-auto pr-1", children: [filtered.map((entry) => (_jsxs("div", { className: "group flex items-center gap-2 rounded-md px-1.5 py-1 transition-colors hover:bg-white/[0.06]", children: [_jsxs("div", { className: "min-w-0 flex-1 truncate", children: [_jsx("div", { className: "truncate text-neutral-100", children: entry.label }), _jsxs("div", { className: "truncate text-[10px] text-neutral-500", children: [entry.kind, " \u00B7 ", entry.id] })] }), _jsx("button", { type: "button", className: "shrink-0 rounded-md bg-cyan-500/20 px-2 py-0.5 text-cyan-200 opacity-0 ring-1 ring-inset ring-cyan-400/30 transition-all hover:bg-cyan-500/30 focus-visible:opacity-100 group-hover:opacity-100", onClick: () => onPlace(entry), children: "Place" })] }, entry.id))), filtered.length === 0 ? _jsx("div", { className: "text-neutral-500", children: "No assets match." }) : null] }), _jsx("button", { type: "button", className: "rounded-md bg-white/[0.05] px-2 py-1 text-neutral-300 ring-1 ring-inset ring-white/[0.06] transition-colors hover:bg-white/10 hover:text-neutral-100", onClick: () => {
+    return (_jsxs("div", { className: "flex min-h-0 flex-1 flex-col gap-1", children: [_jsx(MaterialsPalette, {}), _jsx("input", { type: "search", placeholder: "Search assets\u2026", value: query, onChange: (event) => setQuery(event.target.value), className: "rounded-md border border-white/10 bg-black/40 px-2.5 py-1.5 text-neutral-100 outline-none transition-colors placeholder:text-neutral-600 focus:border-cyan-400/60 focus:bg-black/60" }), _jsxs("div", { className: "min-h-0 flex-1 space-y-0.5 overflow-auto pr-1", children: [filtered.map((entry) => (_jsxs("div", { className: "group flex items-center gap-2 rounded-md px-1.5 py-1 transition-colors hover:bg-white/[0.06]", children: [_jsxs("div", { className: "min-w-0 flex-1 truncate", children: [_jsx("div", { className: "truncate text-neutral-100", children: entry.label }), _jsxs("div", { className: "truncate text-[10px] text-neutral-500", children: [entry.kind, " \u00B7 ", entry.id] }), entry.clips !== undefined && entry.clips.length > 0 ? (_jsxs("div", { className: "truncate text-[10px] text-emerald-400/80", title: `${entry.clips.length} animation clips (auto-animates when placed):\n${entry.clips.join("\n")}`, children: ["\u25B6 ", entry.clips.length, " clips \u00B7 ", describeClipRoles(entry.clips)] })) : null] }), _jsx("button", { type: "button", className: "shrink-0 rounded-md bg-cyan-500/20 px-2 py-0.5 text-cyan-200 opacity-0 ring-1 ring-inset ring-cyan-400/30 transition-all hover:bg-cyan-500/30 focus-visible:opacity-100 group-hover:opacity-100", onClick: () => onPlace(entry), children: "Place" })] }, entry.id))), filtered.length === 0 ? _jsx("div", { className: "text-neutral-500", children: "No assets match." }) : null] }), _jsx("button", { type: "button", className: "rounded-md bg-white/[0.05] px-2 py-1 text-neutral-300 ring-1 ring-inset ring-white/[0.06] transition-colors hover:bg-white/10 hover:text-neutral-100", onClick: () => {
                     const id = `marker_${Date.now().toString(36)}`;
                     const focus = null;
                     void focus;
@@ -71,6 +79,7 @@ export function assetsFromCatalog(ids, resolve) {
             label: id,
             kind: "model",
             ...(resolved?.url === undefined ? {} : { url: resolved.url }),
+            ...(resolved?.clips === undefined ? {} : { clips: resolved.clips }),
         };
     });
 }

package/dist/ClipPreviewLayer.d.ts

@@ -0,0 +1,15 @@
+import type { EditorHostApi } from "./session.js";
+import type { EditorUiStore } from "./uiStore.js";
+/**
+ * Viewport layer that renders the active clip-preview asset playing the selected clip, mounted by
+ * `EditorApp` inside the editor's R3F scene + GameContext. Reuses the shell's shared GLTF loader,
+ * scene clone, and `useModelAnimation` mixer — the same driver `EntityModel` runs at play time — so
+ * the preview IS the runtime playback. Reads the live session from the editor UI store and publishes
+ * the selected clip's measured duration back so the dock scrubber can normalize.
+ *
+ * @internal — not a game-author entry point.
+ */
+export declare function ClipPreviewLayer({ api, ui }: {
+    api: EditorHostApi;
+    ui: EditorUiStore;
+}): import("react").JSX.Element | null;

package/dist/ClipPreviewLayer.js

@@ -0,0 +1,60 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Suspense, useEffect, useMemo } from "react";
+import { useLoader } from "@react-three/fiber";
+import * as THREE from "three";
+import { sharedGltfLoader } from "@jgengine/shell/render/modelLoad";
+import { cloneModelScene, disposeClonedMaterials } from "@jgengine/shell/render/modelRender";
+import { useModelAnimation } from "@jgengine/shell/render/useModelAnimation";
+import { previewAnimationConfig } from "./shell/clipPreview.js";
+import { useStoreSelector } from "./useStoreSelector.js";
+/** World-unit height the previewed model is normalized to, so tiny/huge rigs are both framed. */
+const PREVIEW_TARGET_HEIGHT = 2;
+/**
+ * Viewport layer that renders the active clip-preview asset playing the selected clip, mounted by
+ * `EditorApp` inside the editor's R3F scene + GameContext. Reuses the shell's shared GLTF loader,
+ * scene clone, and `useModelAnimation` mixer — the same driver `EntityModel` runs at play time — so
+ * the preview IS the runtime playback. Reads the live session from the editor UI store and publishes
+ * the selected clip's measured duration back so the dock scrubber can normalize.
+ *
+ * @internal — not a game-author entry point.
+ */
+export function ClipPreviewLayer({ api, ui }) {
+    const session = useStoreSelector(ui, (state) => state.clipPreview);
+    if (session === null)
+        return null;
+    return (_jsx(Suspense, { fallback: null, children: _jsx(ClipPreviewModel, { session: session, api: api, ui: ui }, session.source.assetId) }));
+}
+function ClipPreviewModel({ session, api, ui, }) {
+    const { source, driver } = session;
+    const gltf = useLoader(sharedGltfLoader, source.url);
+    const scene = useMemo(() => cloneModelScene(gltf.scene), [gltf]);
+    useEffect(() => () => disposeClonedMaterials(scene), [scene]);
+    // Normalize height and center/ground so any rig frames nicely at the camera focus point.
+    const placement = useMemo(() => {
+        const box = new THREE.Box3().setFromObject(scene);
+        const height = box.max.y - box.min.y;
+        if (!Number.isFinite(height) || height <= 0)
+            return { scale: 1, minY: 0, centerX: 0, centerZ: 0 };
+        return {
+            scale: PREVIEW_TARGET_HEIGHT / height,
+            minY: box.min.y,
+            centerX: (box.min.x + box.max.x) / 2,
+            centerZ: (box.min.z + box.max.z) / 2,
+        };
+    }, [scene]);
+    const config = useMemo(() => previewAnimationConfig(driver), [driver]);
+    useModelAnimation(scene, gltf.animations, config, undefined);
+    // Publish the selected clip's duration once loaded so the dock scrubber can span it (0 = unknown).
+    const clipName = driver.clipName;
+    useEffect(() => {
+        const clip = clipName === null ? undefined : gltf.animations.find((entry) => entry.name === clipName);
+        const duration = clip?.duration ?? 0;
+        const current = ui.getState().clipPreview;
+        if (current !== null && current.source.assetId === source.assetId && current.duration !== duration) {
+            ui.patch({ clipPreview: { ...current, duration } });
+        }
+    }, [gltf, clipName, ui, source.assetId]);
+    const focus = api.getFocusTarget() ?? { x: 0, y: 0, z: 0 };
+    const s = placement.scale;
+    return (_jsx("group", { position: [focus.x, focus.y, focus.z], children: _jsx("primitive", { object: scene, scale: s, position: [-s * placement.centerX, -s * placement.minY, -s * placement.centerZ] }) }));
+}

package/dist/EditorApp.d.ts

@@ -23,6 +23,12 @@ export interface EditorAppProps {
      * session identity and presence rows. Omit when the host has nothing live — the panel stays honest.
      */
     networkPresence?: EditorNetworkPresenceInput;
+    /**
+     * Called to close the editor and return to the game. Passed by `GameHost` when the editor was
+     * summoned over a running game; when set, the chrome shows an "Exit to game" control. Omit for the
+     * standalone editor, which has no game to return to.
+     */
+    onExitEditor?: () => void;
 }
 /** Persists an exported document JSON; resolves with where it landed or why it failed. */
 export type EditorSaveFn = (json: string) => Promise<{
@@ -31,4 +37,4 @@ export type EditorSaveFn = (json: string) => Promise<{
     error?: string;
 }>;
 /** Top-level scene editor: author spawns/zones/paths/notes visually over edit, walk, or play modes. */
-export declare function EditorApp({ gameId, playable, layers, catalogs, save, modeChip, networkPresence }: EditorAppProps): import("react").JSX.Element;
+export declare function EditorApp({ gameId, playable, layers, catalogs, save, modeChip, networkPresence, onExitEditor }: EditorAppProps): import("react").JSX.Element;

package/dist/EditorApp.js

@@ -15,6 +15,7 @@ import { MaterialDropZone } from "./MaterialDropZone.js";
 import { PerfProbe } from "./PerfProbe.js";
 import { ScatterPreview } from "./ScatterPreview.js";
 import { CityPreview } from "./CityPreview.js";
+import { ClipPreviewLayer } from "./ClipPreviewLayer.js";
 import { SelectionGizmo, ViewportSelect } from "./SelectionGizmo.js";
 import { TerrainReadout } from "./TerrainReadout.js";
 import { TerrainReadoutHud } from "./TerrainReadoutHud.js";
@@ -153,7 +154,7 @@ function EditorWorldOverlay({ api, ui, world, readout, }) {
             unsubscribe();
         };
     }, [session, readoutActive]);
-    return (_jsxs(_Fragment, { children: [_jsx(PerfProbe, { api: api }), _jsx(EditorCameraDriver, { api: api }), _jsx(ViewportSelect, { api: api, ui: ui }), _jsx(MaterialDropZone, { api: api }), _jsx(AssetDropZone, { api: api }), _jsx(TerrainSculpt, { api: api, ui: ui, world: world }), _jsx(ScatterPreview, { api: api }), _jsx(CityPreview, { api: api }), showGrid ? _jsx("gridHelper", { args: [400, 80, "#3b4252", "#20242e"], position: [0, 0.05, 0] }) : null, readoutActive ? (_jsx(TerrainReadout, { groundHeightAt: groundHeightAt, region: readoutRegion, showContours: showContours, showSurfaceGrid: showSurfaceGrid, version: terrainVersion, readout: readout })) : null, _jsx(EditorLayerOverlays, { document: document, visibility: visibility, selection: selection, hoverId: hoverId, onSelect: (id) => session.dispatch({ type: "select", ids: [id] }), activePathPoint: pathPoint, groundHeightAt: groundHeightAt }), pathDraft.length > 0 ? _jsx(PathDraftPreview, { points: pathDraft }) : null, _jsx(SelectionGizmo, { session: session, ui: ui, groundSnap: groundHeightAt })] }));
+    return (_jsxs(_Fragment, { children: [_jsx(PerfProbe, { api: api }), _jsx(EditorCameraDriver, { api: api }), _jsx(ViewportSelect, { api: api, ui: ui }), _jsx(MaterialDropZone, { api: api }), _jsx(AssetDropZone, { api: api }), _jsx(TerrainSculpt, { api: api, ui: ui, world: world }), _jsx(ScatterPreview, { api: api }), _jsx(CityPreview, { api: api }), _jsx(ClipPreviewLayer, { api: api, ui: ui }), showGrid ? _jsx("gridHelper", { args: [400, 80, "#3b4252", "#20242e"], position: [0, 0.05, 0] }) : null, readoutActive ? (_jsx(TerrainReadout, { groundHeightAt: groundHeightAt, region: readoutRegion, showContours: showContours, showSurfaceGrid: showSurfaceGrid, version: terrainVersion, readout: readout })) : null, _jsx(EditorLayerOverlays, { document: document, visibility: visibility, selection: selection, hoverId: hoverId, onSelect: (id) => session.dispatch({ type: "select", ids: [id] }), activePathPoint: pathPoint, groundHeightAt: groundHeightAt }), pathDraft.length > 0 ? _jsx(PathDraftPreview, { points: pathDraft }) : null, _jsx(SelectionGizmo, { session: session, ui: ui, groundSnap: groundHeightAt })] }));
 }
 /** Default skin for the play/walk escape chip; swap via `EditorAppProps.modeChip`, or pass `null` to hide it (F2+E still exits). */
 function EditorModeChip({ mode, onExit }) {
@@ -244,7 +245,7 @@ function resolveEditorCamera(document) {
     };
 }
 /** Top-level scene editor: author spawns/zones/paths/notes visually over edit, walk, or play modes. */
-export function EditorApp({ gameId, playable, layers, catalogs, save, modeChip, networkPresence }) {
+export function EditorApp({ gameId, playable, layers, catalogs, save, modeChip, networkPresence, onExitEditor }) {
     const resolvedModeChip = modeChip === undefined ? EditorModeChip : modeChip;
     const saveFn = useMemo(() => save ?? endpointSaver(gameId), [save, gameId]);
     const networkSnapshot = useMemo(() => buildEditorNetworkSnapshot({
@@ -483,7 +484,7 @@ export function EditorApp({ gameId, playable, layers, catalogs, save, modeChip,
             }
         };
         const GameUI = function EditorUi() {
-            return (_jsx(EditorChrome, { gameId: gameId, session: host.api.getSession(), api: host.api, assets: catalogAssets, ui: ui, baselineDocument: host.baselineDocument, save: saveFn, networkSnapshot: networkSnapshot, onRegisterAsset: registerImportedAsset }));
+            return (_jsx(EditorChrome, { gameId: gameId, session: host.api.getSession(), api: host.api, assets: catalogAssets, ui: ui, baselineDocument: host.baselineDocument, save: saveFn, networkSnapshot: networkSnapshot, onRegisterAsset: registerImportedAsset, onExitEditor: onExitEditor }));
         };
         return {
             ...playable,
@@ -495,7 +496,7 @@ export function EditorApp({ gameId, playable, layers, catalogs, save, modeChip,
             // WorldOverlay above is the editor layers, not PandoraViewmodel.
             camera: inspectionCamera,
         };
-    }, [playable, host, gameId, initialCamera, cameraProjection, catalogAssets, ui, readout, mode, saveFn, resolvedModeChip, networkSnapshot]);
+    }, [playable, host, gameId, initialCamera, cameraProjection, catalogAssets, ui, readout, mode, saveFn, resolvedModeChip, networkSnapshot, onExitEditor]);
     const showElevation = useStoreSelector(ui, (s) => s.showElevation);
     const onPanelCommit = useCallback((id, panel) => {
         host.session.dispatch({ type: "setUiPanel", id, patch: panel });

package/dist/EditorChrome.d.ts

@@ -10,7 +10,7 @@ import type { EditorNetworkSnapshot } from "./networkSnapshot.js";
  * assistant), viewport overlays, and status bar — wired to the session, UI store, layout store,
  * and host RPC. Mounted by `EditorApp`; not a game-author entry point.
  */
-export declare function EditorChrome({ gameId, session, api, assets, ui, baselineDocument, save, networkSnapshot, importAsset, onRegisterAsset, }: {
+export declare function EditorChrome({ gameId, session, api, assets, ui, baselineDocument, save, networkSnapshot, importAsset, onRegisterAsset, onExitEditor, }: {
     gameId: string;
     session: EditorSession;
     api: EditorHostApi;
@@ -23,6 +23,8 @@ export declare function EditorChrome({ gameId, session, api, assets, ui, baselin
         path?: string;
         error?: string;
     }>;
+    /** Closes the editor and returns to the game; set only when summoned over a game. Shows "Exit to game". */
+    onExitEditor?: () => void;
     /**
      * Network workspace inspection payload (adapter config + optional host presence).
      * Built by `EditorApp` from the game definition; live presence rows only when the host injects them.

package/dist/EditorChrome.js

@@ -111,7 +111,7 @@ const LEFT_PAGES = [
  * assistant), viewport overlays, and status bar — wired to the session, UI store, layout store,
  * and host RPC. Mounted by `EditorApp`; not a game-author entry point.
  */
-export function EditorChrome({ gameId, session, api, assets, ui, baselineDocument, save, networkSnapshot, importAsset = importAssetToHost, onRegisterAsset, }) {
+export function EditorChrome({ gameId, session, api, assets, ui, baselineDocument, save, networkSnapshot, importAsset = importAssetToHost, onRegisterAsset, onExitEditor, }) {
     const [, setTick] = useState(0);
     const layoutRef = useRef(null);
     layoutRef.current ??= createShellLayoutStore(gameId);
@@ -169,6 +169,8 @@ export function EditorChrome({ gameId, session, api, assets, ui, baselineDocumen
         return { objects, foliage };
     }, [state.document]);
     useF2Chord("KeyE", () => api.setMode("play"));
+    // F2+Q leaves the editor entirely (back to the game) — only meaningful when summoned over one.
+    useF2Chord("KeyQ", useCallback(() => onExitEditor?.(), [onExitEditor]));
     useEffect(() => session.subscribe(() => setTick((value) => value + 1)), [session]);
     useEffect(() => ui.subscribe(() => setTick((value) => value + 1)), [ui]);
     useEffect(() => layout.subscribe(() => setTick((value) => value + 1)), [layout]);
@@ -672,7 +674,9 @@ export function EditorChrome({ gameId, session, api, assets, ui, baselineDocumen
             ? `Drawing ${placement.kind}: click to add points (${uiState.pathDraft.length}) · Enter finish · Esc cancel`
             : `Placing ${placement.tool === "note" ? "note" : placement.kind}: click the world · Shift-click places more · Esc cancel`;
     const railActive = uiState.tool === "terrain" ? "terrain" : layoutState.workspace;
-    return (_jsxs("div", { className: "pointer-events-none absolute inset-0 z-50 flex flex-col text-xs text-neutral-100", children: [_jsx(TopAppBar, { gameId: gameId, dirty: dirty, saveState: docSave.saveState, lastSavedAt: docSave.lastSavedAt, saveAvailable: docSave.available, saveError: docSave.saveError, canUndo: session.canUndo(), canRedo: session.canRedo(), onUndo: () => session.dispatch({ type: "undo" }), onRedo: () => session.dispatch({ type: "redo" }), onSave: docSave.doSave, onPlay: () => api.setMode("play"), onWalk: () => api.setMode("walk"), onHud: () => api.setMode("hud"), onImport: () => importInputRef.current?.click(), onExport: exportJson, onCopyJson: copyExportJson, onOpenPalette: () => setPaletteQuery(""), onToggleHelp: () => setHelpOpen((value) => !value), onResetLayout: () => layout.reset() }), _jsx("input", { ref: importInputRef, type: "file", accept: "application/json,.json", className: "hidden", onChange: (event) => {
+    // Only advertise the exit chord when there is a game to return to.
+    const shortcuts = onExitEditor !== undefined ? [...SHORTCUTS, { keys: "F2+Q", action: "Exit editor to game" }] : SHORTCUTS;
+    return (_jsxs("div", { className: "pointer-events-none absolute inset-0 z-50 flex flex-col text-xs text-neutral-100", children: [_jsx(TopAppBar, { gameId: gameId, onExitToGame: onExitEditor, dirty: dirty, saveState: docSave.saveState, lastSavedAt: docSave.lastSavedAt, saveAvailable: docSave.available, saveError: docSave.saveError, canUndo: session.canUndo(), canRedo: session.canRedo(), onUndo: () => session.dispatch({ type: "undo" }), onRedo: () => session.dispatch({ type: "redo" }), onSave: docSave.doSave, onPlay: () => api.setMode("play"), onWalk: () => api.setMode("walk"), onHud: () => api.setMode("hud"), onImport: () => importInputRef.current?.click(), onExport: exportJson, onCopyJson: copyExportJson, onOpenPalette: () => setPaletteQuery(""), onToggleHelp: () => setHelpOpen((value) => !value), onResetLayout: () => layout.reset() }), _jsx("input", { ref: importInputRef, type: "file", accept: "application/json,.json", className: "hidden", onChange: (event) => {
                     const file = event.target.files?.[0];
                     if (file !== undefined)
                         importFile(file);
@@ -741,11 +745,11 @@ export function EditorChrome({ gameId, session, api, assets, ui, baselineDocumen
                                                     ? `Parented to ${parentId}`
                                                     : `Parented ${ids.length} objects to ${parentId}`);
                                             }
-                                        }, onClose: () => setParentPicker(null) })) : null] }), layoutState.bottomOpen ? (_jsxs(_Fragment, { children: [_jsx(PanelResizer, { orientation: "horizontal", label: "Resize bottom dock", sign: -1, onResize: (delta) => layout.resize("bottomHeight", delta) }), _jsx("div", { className: "flex shrink-0 flex-col", style: { height: layoutState.bottomHeight }, children: _jsx(BottomDock, { tab: layoutState.bottomTab, onSelectTab: (tab) => layout.patch({ bottomTab: tab }), onClose: () => layout.patch({ bottomOpen: false }), assets: liveAssets, session: session, api: api, consoleStore: consoleStore, perfHistory: perfHistory, browserView: layoutState.browserView, onSetBrowserView: (view) => layout.patch({ browserView: view }), onPlaceAsset: placeAsset, onImportModels: importModels, importBusy: importBusy }) })] })) : (_jsxs("div", { className: `pointer-events-auto flex h-7 shrink-0 items-center gap-1 border-t ${BORDER} bg-[#0e1014] px-1.5`, children: [[
+                                        }, onClose: () => setParentPicker(null) })) : null] }), layoutState.bottomOpen ? (_jsxs(_Fragment, { children: [_jsx(PanelResizer, { orientation: "horizontal", label: "Resize bottom dock", sign: -1, onResize: (delta) => layout.resize("bottomHeight", delta) }), _jsx("div", { className: "flex shrink-0 flex-col", style: { height: layoutState.bottomHeight }, children: _jsx(BottomDock, { tab: layoutState.bottomTab, onSelectTab: (tab) => layout.patch({ bottomTab: tab }), onClose: () => layout.patch({ bottomOpen: false }), assets: liveAssets, session: session, api: api, ui: ui, consoleStore: consoleStore, perfHistory: perfHistory, browserView: layoutState.browserView, onSetBrowserView: (view) => layout.patch({ browserView: view }), onPlaceAsset: placeAsset, onImportModels: importModels, importBusy: importBusy }) })] })) : (_jsxs("div", { className: `pointer-events-auto flex h-7 shrink-0 items-center gap-1 border-t ${BORDER} bg-[#0e1014] px-1.5`, children: [[
                                         ["content", "Content Browser"],
                                         ["console", "Console"],
                                         ["profiler", "Profiler"],
                                         ["animation", "Animation"],
                                         ["assistant", "AI Assistant"],
-                                    ].map(([id, label]) => (_jsx("button", { type: "button", onClick: () => openBottomTab(id), className: `rounded-[4px] px-2 py-0.5 text-[10px] text-neutral-500 transition-colors hover:bg-white/[0.05] hover:text-neutral-300 ${FOCUS_RING}`, children: label }, id))), _jsx("span", { className: "ml-auto text-[9px] text-neutral-600", children: "Ctrl+B opens the content browser" })] }))] }), layoutState.rightOpen ? (_jsxs(_Fragment, { children: [_jsx(PanelResizer, { orientation: "vertical", label: "Resize inspector panel", sign: -1, onResize: (delta) => layout.resize("rightWidth", delta) }), _jsx("aside", { className: `pointer-events-auto hidden min-h-0 flex-col overflow-hidden border-l ${BORDER} bg-[#111318] md:flex`, style: { width: layoutState.rightWidth }, "aria-label": "Inspector dock", children: _jsx(InspectorPanel, { session: session, ui: ui, api: api, tab: layoutState.inspectorTab, onSelectTab: (tab) => layout.patch({ inspectorTab: tab }), collapsed: layoutState.collapsed, onToggleSection: (id) => layout.toggleSection(id), onClose: () => layout.patch({ rightOpen: false }) }) })] })) : null] }), _jsx(StatusBar, { api: api, history: perfHistory, objects: sceneStats.objects, foliage: sceneStats.foliage, selectionCount: state.selection.length, autosave: true }), paletteQuery !== null ? (_jsx(CommandPalette, { commands: paletteCommands, initialQuery: paletteQuery, onClose: () => setPaletteQuery(null) })) : null, helpOpen ? (_jsx("div", { className: "pointer-events-auto absolute inset-0 z-[70] flex items-center justify-center bg-black/50 backdrop-blur-[2px]", onClick: () => setHelpOpen(false), children: _jsxs("div", { className: "w-[28rem] max-w-[90vw] rounded-[10px] border border-white/10 bg-[#14171d] p-5 shadow-2xl shadow-black/60", onClick: (event) => event.stopPropagation(), role: "dialog", "aria-label": "Keyboard shortcuts", children: [_jsxs("div", { className: "mb-3 flex items-center", children: [_jsxs("div", { className: "flex items-center gap-2 text-sm font-semibold tracking-wide text-neutral-100", children: [_jsx(Icon, { name: "command", size: 15, className: "text-cyan-300" }), "Keyboard shortcuts"] }), _jsx(IconButton, { icon: "close", label: "Close shortcuts", tone: "ghost", className: "ml-auto", onClick: () => setHelpOpen(false) })] }), _jsx("div", { className: "grid max-h-[60vh] grid-cols-[auto_1fr] items-center gap-x-4 gap-y-1.5 overflow-auto", children: SHORTCUTS.map((entry) => (_jsxs("div", { className: "contents", children: [_jsx("span", { className: "justify-self-start", children: _jsx(Kbd, { children: entry.keys }) }), _jsx("span", { className: "text-neutral-300", children: entry.action })] }, entry.keys))) })] }) })) : null] }));
+                                    ].map(([id, label]) => (_jsx("button", { type: "button", onClick: () => openBottomTab(id), className: `rounded-[4px] px-2 py-0.5 text-[10px] text-neutral-500 transition-colors hover:bg-white/[0.05] hover:text-neutral-300 ${FOCUS_RING}`, children: label }, id))), _jsx("span", { className: "ml-auto text-[9px] text-neutral-600", children: "Ctrl+B opens the content browser" })] }))] }), layoutState.rightOpen ? (_jsxs(_Fragment, { children: [_jsx(PanelResizer, { orientation: "vertical", label: "Resize inspector panel", sign: -1, onResize: (delta) => layout.resize("rightWidth", delta) }), _jsx("aside", { className: `pointer-events-auto hidden min-h-0 flex-col overflow-hidden border-l ${BORDER} bg-[#111318] md:flex`, style: { width: layoutState.rightWidth }, "aria-label": "Inspector dock", children: _jsx(InspectorPanel, { session: session, ui: ui, api: api, assets: liveAssets, tab: layoutState.inspectorTab, onSelectTab: (tab) => layout.patch({ inspectorTab: tab }), collapsed: layoutState.collapsed, onToggleSection: (id) => layout.toggleSection(id), onClose: () => layout.patch({ rightOpen: false }) }) })] })) : null] }), _jsx(StatusBar, { api: api, history: perfHistory, objects: sceneStats.objects, foliage: sceneStats.foliage, selectionCount: state.selection.length, autosave: true }), paletteQuery !== null ? (_jsx(CommandPalette, { commands: paletteCommands, initialQuery: paletteQuery, onClose: () => setPaletteQuery(null) })) : null, helpOpen ? (_jsx("div", { className: "pointer-events-auto absolute inset-0 z-[70] flex items-center justify-center bg-black/50 backdrop-blur-[2px]", onClick: () => setHelpOpen(false), children: _jsxs("div", { className: "w-[28rem] max-w-[90vw] rounded-[10px] border border-white/10 bg-[#14171d] p-5 shadow-2xl shadow-black/60", onClick: (event) => event.stopPropagation(), role: "dialog", "aria-label": "Keyboard shortcuts", children: [_jsxs("div", { className: "mb-3 flex items-center", children: [_jsxs("div", { className: "flex items-center gap-2 text-sm font-semibold tracking-wide text-neutral-100", children: [_jsx(Icon, { name: "command", size: 15, className: "text-cyan-300" }), "Keyboard shortcuts"] }), _jsx(IconButton, { icon: "close", label: "Close shortcuts", tone: "ghost", className: "ml-auto", onClick: () => setHelpOpen(false) })] }), _jsx("div", { className: "grid max-h-[60vh] grid-cols-[auto_1fr] items-center gap-x-4 gap-y-1.5 overflow-auto", children: shortcuts.map((entry) => (_jsxs("div", { className: "contents", children: [_jsx("span", { className: "justify-self-start", children: _jsx(Kbd, { children: entry.keys }) }), _jsx("span", { className: "text-neutral-300", children: entry.action })] }, entry.keys))) })] }) })) : null] }));
 }

package/dist/InspectorPanel.d.ts

@@ -1,4 +1,5 @@
 import { type EditorSession } from "@jgengine/core/editor/index";
+import { type EditorAssetEntry } from "./AssetBrowser.js";
 import type { EditorHostApi } from "./session.js";
 import type { EditorUiStore } from "./uiStore.js";
 import type { InspectorTab } from "./shell/layoutStore.js";
@@ -9,12 +10,14 @@ import type { InspectorTab } from "./shell/layoutStore.js";
  * `pathPoint` slice, so UI-only churn never rerenders it on `EditorChrome`'s render tick.
  * @internal — mounted by `EditorChrome` inside the right dock.
  */
-export declare function InspectorPanel({ session, ui, onClose, api, tab, onSelectTab, collapsed, onToggleSection, }: {
+export declare function InspectorPanel({ session, ui, onClose, api, assets, tab, onSelectTab, collapsed, onToggleSection, }: {
     session: EditorSession;
     ui: EditorUiStore;
     onClose?: () => void;
     /** Host API for RPC-backed actions (material assignment, camera). */
     api?: EditorHostApi;
+    /** Live browser asset list, used to resolve a placed marker's rig clips for animation authoring. */
+    assets?: readonly EditorAssetEntry[];
     /** Controlled active tab; omit for local state. */
     tab?: InspectorTab;
     onSelectTab?: (tab: InspectorTab) => void;

package/dist/InspectorPanel.js

@@ -4,10 +4,13 @@ import { editorParentOf, findEditorNote, findEditorPath, isEditorObjectLocked, }
 import { readVegetationSettings, vegetationFootprint } from "@jgengine/core/world/vegetation";
 import { getSceneKind, isSceneKind, parseParams, } from "@jgengine/core/scene/sceneKinds";
 import { getAssetGenerator } from "@jgengine/core/scene/assetGenerator";
+import { markerCatalogId } from "@jgengine/core/world/authoredObjects";
 import { useGameContext } from "@jgengine/react/provider";
 import { canAuthorTrigger, clearMaterialAssignmentPatch, clearTriggerInstallPatch, defaultTriggerInstallPatch, hasAuthoredTrigger, hasMaterialAssignment, } from "./authoredComponentMeta.js";
 import { SchemaInspector } from "./SchemaInspector.js";
 import { TriggerInspector } from "./TriggerInspector.js";
+import { describeClipRoles } from "./AssetBrowser.js";
+import { animationMode, animationMetaPatch, LOCOMOTION_ROLES, ONE_SHOT_EVENTS, readAnimationSetting, setAnimationMode, setLocomotionClip, setLocomotionNumber, setOneShotClip, } from "./modelAnimationAuthoring.js";
 import { listParentCandidates } from "./parentCandidates.js";
 import { TERRAIN_MATERIALS } from "./uiStore.js";
 import { shallowArrayEqual, useStoreSelector } from "./useStoreSelector.js";
@@ -15,6 +18,7 @@ import { INPUT } from "./chromeStyles.js";
 import { NumberField } from "./chromeFields.js";
 import { AxisNumberField, FieldRow, SectionAction } from "./shell/fields.js";
 import { Icon, kindIcon } from "./shell/icons.js";
+import { CoverageSection } from "./shell/scatterCoverage.js";
 import { FOCUS_RING, INPUT_CLS, NUMERIC } from "./shell/theme.js";
 import { CollapsibleSection, EmptyState, IconButton, PanelTabs } from "./shell/ui.js";
 function VegetationFields({ volume, onMeta, }) {
@@ -49,8 +53,11 @@ function KindInspector({ object, meta, onMeta }) {
     const definition = getSceneKind(object.kind);
     if (definition === undefined)
         return null;
-    const note = definition.note?.(object, parseParams(definition.schema, object.meta));
-    return (_jsx(SchemaInspector, { schema: definition.schema, label: definition.label, meta: meta, onMeta: onMeta, ...(definition.accent === undefined ? {} : { accent: definition.accent }), ...(note === undefined ? {} : { note }) }));
+    const params = parseParams(definition.schema, object.meta);
+    const note = definition.note?.(object, params);
+    const coverage = definition.coverage;
+    const accent = definition.accent ?? "#34d399";
+    return (_jsxs("div", { className: "space-y-2", children: [coverage !== undefined ? (_jsx(CoverageSection, { schema: definition.schema, coverage: coverage, object: object, params: params, accent: accent, onMeta: onMeta, ...(note === undefined ? {} : { note }) })) : null, _jsx(SchemaInspector, { schema: definition.schema, label: definition.label, meta: meta, onMeta: onMeta, ...(definition.accent === undefined ? {} : { accent: definition.accent }), ...(coverage === undefined && note !== undefined ? { note } : {}), ...(coverage === undefined ? {} : { hideKeys: [coverage.densityKey] }) })] }));
 }
 /** Auto-generated inspector for a placed generator asset's params (building/bookcase/…). */
 function GeneratorInspector({ meta, onMeta }) {
@@ -107,6 +114,26 @@ function ComponentAddBar({ target, meta, onMeta, api, selectionIds, }) {
                                     event.currentTarget.value = "";
                                 }, children: [_jsx("option", { value: "", children: "+ Material\u2026" }), TERRAIN_MATERIALS.map((material) => (_jsx("option", { value: material.id, children: material.label }, material.id)))] })] })) : null] })] }));
 }
+/** A labeled clip dropdown (never free-text) for a role/event; "— none —" clears the binding. */
+function ClipSelectRow({ label, clips, value, onChange, }) {
+    return (_jsx(FieldRow, { label: label, children: _jsxs("select", { className: `h-6.5 w-full min-w-0 px-1.5 ${INPUT_CLS}`, value: value ?? "", "aria-label": `${label} clip`, onChange: (event) => onChange(event.target.value === "" ? null : event.target.value), children: [_jsx("option", { value: "", children: "\u2014 none \u2014" }), clips.map((clip) => (_jsx("option", { value: clip, children: clip }, clip)))] }) }));
+}
+const ANIMATION_MODE_HINT = {
+    default: "Inherits the catalog default: a rigged asset auto-animates from its clip roles.",
+    auto: "Forces derivation of idle/walk/run + hit/death/attack from this rig's clip names.",
+    none: "Renders the bind pose — no clip playback.",
+    custom: "Author explicit role→clip bindings below; unset roles fall back to the rig's defaults.",
+};
+/**
+ * Inspector section authoring a placement's `ModelConfig.animation` for a rigged catalog asset.
+ * Persists to `marker.meta.animation` through the passed `onChange` (an undoable `setMarker` dispatch).
+ * All clip picks are dropdowns over the asset's real clip list — never free-text.
+ */
+function ModelAnimationSection({ clips, setting, onChange, }) {
+    const mode = animationMode(setting);
+    const config = mode === "custom" && typeof setting === "object" ? setting : null;
+    return (_jsxs("div", { className: "space-y-2.5", children: [_jsxs("div", { className: "text-[10px] text-neutral-500", children: [clips.length, " clips \u00B7 ", describeClipRoles(clips)] }), _jsx(FieldRow, { label: "Mode", children: _jsxs("select", { className: `h-6.5 w-full min-w-0 px-1.5 ${INPUT_CLS}`, value: mode, "aria-label": "Animation mode", onChange: (event) => onChange(setAnimationMode(setting, event.target.value, clips)), children: [_jsx("option", { value: "default", children: "Default (catalog)" }), _jsx("option", { value: "auto", children: "Auto (derive)" }), _jsx("option", { value: "none", children: "None (bind pose)" }), _jsx("option", { value: "custom", children: "Custom" })] }) }), config === null ? (_jsx("div", { className: "text-[10px] leading-relaxed text-neutral-600", children: ANIMATION_MODE_HINT[mode] })) : (_jsxs(_Fragment, { children: [_jsxs("div", { className: "space-y-1.5 rounded-[6px] border border-white/[0.06] bg-white/[0.02] p-2", children: [_jsx("div", { className: "text-[9px] font-semibold uppercase tracking-wider text-neutral-500", children: "Locomotion states" }), LOCOMOTION_ROLES.map((role) => (_jsx(ClipSelectRow, { label: role, clips: clips, value: config.states?.[role] ?? null, onChange: (clip) => onChange(setLocomotionClip(setting, role, clip)) }, role))), _jsx(FieldRow, { label: "walkSpeed", title: "Speed (u/s) above which the entity counts as moving (walk).", children: _jsx(AxisNumberField, { label: "u/s", step: 0.1, value: config.states?.walkSpeed ?? 0.5, onCommit: (value) => onChange(setLocomotionNumber(setting, "walkSpeed", Math.max(0, value))) }) }), _jsx(FieldRow, { label: "runSpeed", title: "Speed above which the run clip plays (when a run clip is set).", children: _jsx(AxisNumberField, { label: "u/s", step: 0.5, value: config.states?.runSpeed ?? 6, onCommit: (value) => onChange(setLocomotionNumber(setting, "runSpeed", Math.max(0, value))) }) }), _jsx(FieldRow, { label: "fadeSec", title: "Crossfade duration (s) when the locomotion state changes.", children: _jsx(AxisNumberField, { label: "s", step: 0.05, value: config.states?.fadeSec ?? 0.2, onCommit: (value) => onChange(setLocomotionNumber(setting, "fadeSec", Math.max(0, value))) }) })] }), _jsxs("div", { className: "space-y-1.5 rounded-[6px] border border-white/[0.06] bg-white/[0.02] p-2", children: [_jsx("div", { className: "text-[9px] font-semibold uppercase tracking-wider text-neutral-500", children: "One-shot events" }), _jsx("div", { className: "text-[10px] text-neutral-600", children: "hit / death auto-fire on damage/death; others via playEntityAnimation." }), ONE_SHOT_EVENTS.map((event) => (_jsx(ClipSelectRow, { label: event, clips: clips, value: config.oneShots?.[event] ?? null, onChange: (clip) => onChange(setOneShotClip(setting, event, clip)) }, event)))] })] }))] }));
+}
 function Section({ id, title, icon, sections, children, trailing, }) {
     return (_jsx(CollapsibleSection, { title: title, ...(icon === undefined ? {} : { icon }), open: sections.collapsed[id] !== true, onToggle: () => sections.toggle(id), ...(trailing === undefined ? {} : { trailing }), children: children }));
 }
@@ -127,7 +154,7 @@ function MaterialsTab({ api, selection, meta, }) {
  * `pathPoint` slice, so UI-only churn never rerenders it on `EditorChrome`'s render tick.
  * @internal — mounted by `EditorChrome` inside the right dock.
  */
-export function InspectorPanel({ session, ui, onClose, api, tab, onSelectTab, collapsed, onToggleSection, }) {
+export function InspectorPanel({ session, ui, onClose, api, assets, tab, onSelectTab, collapsed, onToggleSection, }) {
     const document = useStoreSelector(session, (state) => state.document);
     const selection = useStoreSelector(session, (state) => state.selection, shallowArrayEqual);
     const pathPoint = useStoreSelector(ui, (state) => state.pathPoint);
@@ -198,12 +225,16 @@ export function InspectorPanel({ session, ui, onClose, api, tab, onSelectTab, co
     else if (selectedMarker !== undefined) {
         const marker = selectedMarker;
         const onMeta = (patch, coalesce) => session.dispatch({ type: "setMarker", id: marker.id, patch: { meta: { ...marker.meta, ...patch } } }, { coalesce: `${coalesce}:${marker.id}` });
+        // Rig clips for animation authoring: this placement's catalog asset must carry animation clips.
+        const markerCatalog = markerCatalogId(marker);
+        const markerRigAsset = markerCatalog === null ? undefined : assets?.find((entry) => entry.id === markerCatalog);
+        const markerRigClips = markerRigAsset?.clips !== undefined && markerRigAsset.clips.length > 0 ? markerRigAsset.clips : null;
         const hasTrigger = hasAuthoredTrigger(marker.meta);
         const hasMaterial = hasMaterialAssignment(marker.meta);
         const hasGenerator = typeof marker.meta?.["assetId"] === "string" && getAssetGenerator(marker.meta["assetId"]) !== undefined;
         const hasKindParams = isSceneKind(marker.kind);
         const componentCards = (_jsxs(_Fragment, { children: [_jsx(ComponentAddBar, { target: "marker", meta: marker.meta, onMeta: onMeta, api: api, selectionIds: [marker.id] }), hasKindParams ? (_jsx(Section, { id: "kindParams", title: "Kind parameters", icon: "settings", sections: sections, children: _jsx(KindInspector, { object: markerObject(marker), meta: marker.meta, onMeta: onMeta }) })) : null, hasTrigger ? (_jsx(Section, { id: "trigger", title: "Trigger", icon: "target", sections: sections, trailing: _jsx(SectionAction, { label: "Remove trigger component", onClick: () => onMeta(clearTriggerInstallPatch(), "component:remove-trigger"), children: "remove" }), children: _jsx(TriggerInspector, { target: "marker", meta: marker.meta, onMeta: onMeta }) })) : null, hasMaterial ? (_jsx(Section, { id: "material", title: "Material", icon: "sphere", sections: sections, trailing: _jsx(SectionAction, { label: "Remove material assignment", onClick: () => onMeta(clearMaterialAssignmentPatch(), "component:remove-material"), children: "remove" }), children: _jsxs("div", { className: "text-[11px] text-neutral-300", children: ["materialId: ", _jsx("span", { className: NUMERIC, children: String(marker.meta?.["materialId"]) })] }) })) : null, hasGenerator ? (_jsx(Section, { id: "generator", title: "Generator", icon: "cube", sections: sections, children: _jsx(GeneratorInspector, { meta: marker.meta, onMeta: onMeta }) })) : null, !hasKindParams && !hasTrigger && !hasMaterial && !hasGenerator && !canAuthorTrigger("marker") ? (_jsx(EmptyState, { icon: "settings", title: "No components", description: "This marker has no optional components. Games that register trigger actions enable Add trigger here." })) : null] }));
-        body = (_jsxs("div", { className: "space-y-2 p-2.5", children: [_jsx(ObjectHeader, { kind: marker.kind, id: marker.id, label: marker.label ?? "", placeholder: marker.id, locked: isEditorObjectLocked(document, marker.id), onLabel: (value) => session.dispatch({ type: "setMarker", id: marker.id, patch: { label: value } }, { coalesce: `label:${marker.id}` }) }), activeTab === "inspector" ? (_jsxs(_Fragment, { children: [_jsx(Section, { id: "transform", title: "Transform", icon: "move", sections: sections, trailing: _jsx(SectionAction, { label: "Reset position to origin", onClick: () => session.dispatch({ type: "setTransform", id: marker.id, position: { x: 0, y: 0, z: 0 } }), children: "reset" }), children: _jsxs("div", { className: "space-y-1.5", children: [_jsx(FieldRow, { label: "Position", children: ["x", "y", "z"].map((axis) => (_jsx(AxisNumberField, { axis: axis, label: axis, step: 0.5, value: marker.position[axis], onCommit: (value) => session.dispatch({ type: "setTransform", id: marker.id, position: { ...marker.position, [axis]: value } }, { coalesce: `pos:${axis}:${marker.id}` }) }, axis))) }), _jsx(FieldRow, { label: "Rotation", children: _jsx(AxisNumberField, { axis: "y", label: "y\u00B0", step: 5, precision: 1, value: Math.round((((marker.rotationY ?? 0) * 180) / Math.PI) * 10) / 10, onCommit: (value) => session.dispatch({ type: "setTransform", id: marker.id, rotationY: (value * Math.PI) / 180 }, { coalesce: `rot:${marker.id}` }) }) })] }) }), _jsx(Section, { id: "appearance", title: "Appearance", icon: "sphere", sections: sections, children: _jsx(KindColorFields, { kind: marker.kind, color: marker.color, onKind: (kind) => session.dispatch({ type: "setMarker", id: marker.id, patch: { kind } }, { coalesce: `kind:${marker.id}` }), onColor: (color) => session.dispatch({ type: "setMarker", id: marker.id, patch: { color } }, { coalesce: `color:${marker.id}` }) }) }), _jsx(Section, { id: "placement", title: "Placement", icon: "pin", sections: sections, children: _jsxs("div", { className: "space-y-2", children: [_jsx(ClearanceField, { meta: marker.meta, onMeta: onMeta }), _jsx(ParentField, { session: session, id: marker.id })] }) }), marker.meta !== undefined ? (_jsx(Section, { id: "meta", title: "Raw metadata", icon: "script", sections: sections, children: _jsx("pre", { className: "max-h-48 overflow-auto rounded-[5px] border border-white/[0.06] bg-black/40 p-2 text-[10px] text-neutral-400", children: JSON.stringify(marker.meta, null, 2) }) })) : null] })) : (componentCards)] }));
+        body = (_jsxs("div", { className: "space-y-2 p-2.5", children: [_jsx(ObjectHeader, { kind: marker.kind, id: marker.id, label: marker.label ?? "", placeholder: marker.id, locked: isEditorObjectLocked(document, marker.id), onLabel: (value) => session.dispatch({ type: "setMarker", id: marker.id, patch: { label: value } }, { coalesce: `label:${marker.id}` }) }), activeTab === "inspector" ? (_jsxs(_Fragment, { children: [_jsx(Section, { id: "transform", title: "Transform", icon: "move", sections: sections, trailing: _jsx(SectionAction, { label: "Reset position to origin", onClick: () => session.dispatch({ type: "setTransform", id: marker.id, position: { x: 0, y: 0, z: 0 } }), children: "reset" }), children: _jsxs("div", { className: "space-y-1.5", children: [_jsx(FieldRow, { label: "Position", children: ["x", "y", "z"].map((axis) => (_jsx(AxisNumberField, { axis: axis, label: axis, step: 0.5, value: marker.position[axis], onCommit: (value) => session.dispatch({ type: "setTransform", id: marker.id, position: { ...marker.position, [axis]: value } }, { coalesce: `pos:${axis}:${marker.id}` }) }, axis))) }), _jsx(FieldRow, { label: "Rotation", children: _jsx(AxisNumberField, { axis: "y", label: "y\u00B0", step: 5, precision: 1, value: Math.round((((marker.rotationY ?? 0) * 180) / Math.PI) * 10) / 10, onCommit: (value) => session.dispatch({ type: "setTransform", id: marker.id, rotationY: (value * Math.PI) / 180 }, { coalesce: `rot:${marker.id}` }) }) })] }) }), _jsx(Section, { id: "appearance", title: "Appearance", icon: "sphere", sections: sections, children: _jsx(KindColorFields, { kind: marker.kind, color: marker.color, onKind: (kind) => session.dispatch({ type: "setMarker", id: marker.id, patch: { kind } }, { coalesce: `kind:${marker.id}` }), onColor: (color) => session.dispatch({ type: "setMarker", id: marker.id, patch: { color } }, { coalesce: `color:${marker.id}` }) }) }), _jsx(Section, { id: "placement", title: "Placement", icon: "pin", sections: sections, children: _jsxs("div", { className: "space-y-2", children: [_jsx(ClearanceField, { meta: marker.meta, onMeta: onMeta }), _jsx(ParentField, { session: session, id: marker.id })] }) }), markerRigClips !== null ? (_jsx(Section, { id: "modelAnimation", title: "Animation", icon: "film", sections: sections, children: _jsx(ModelAnimationSection, { clips: markerRigClips, setting: readAnimationSetting(marker.meta), onChange: (next) => onMeta(animationMetaPatch(next), "animation") }) })) : null, marker.meta !== undefined ? (_jsx(Section, { id: "meta", title: "Raw metadata", icon: "script", sections: sections, children: _jsx("pre", { className: "max-h-48 overflow-auto rounded-[5px] border border-white/[0.06] bg-black/40 p-2 text-[10px] text-neutral-400", children: JSON.stringify(marker.meta, null, 2) }) })) : null] })) : (componentCards)] }));
     }
     else if (selectedVolume !== undefined) {
         const volume = selectedVolume;

package/dist/SchemaInspector.d.ts

@@ -9,11 +9,13 @@ export type MetaPatch = (patch: Record<string, unknown>, coalesce: string) => vo
  * seam owns the inspector. Replaces the hand-written per-kind field blocks (`ScatterFields`).
  * @internal — mounted by `EditorChrome`'s inspector; not a game-author entry point.
  */
-export declare function SchemaInspector({ schema, label, accent, note, meta, onMeta, }: {
+export declare function SchemaInspector({ schema, label, accent, note, meta, onMeta, hideKeys, }: {
     schema: ParamSchema;
     label: string;
     accent?: string;
     note?: string;
     meta: Record<string, unknown> | undefined;
     onMeta: MetaPatch;
+    /** Field keys to omit from this body — hoisted elsewhere (e.g. the density slider in `CoverageSection`). */
+    hideKeys?: readonly string[];
 }): import("react").JSX.Element;

package/dist/SchemaInspector.js

@@ -82,10 +82,15 @@ function GroupSection({ title, accent, fields, schema, meta, onMeta, defaultColl
  * seam owns the inspector. Replaces the hand-written per-kind field blocks (`ScatterFields`).
  * @internal — mounted by `EditorChrome`'s inspector; not a game-author entry point.
  */
-export function SchemaInspector({ schema, label, accent = "#34d399", note, meta, onMeta, }) {
+export function SchemaInspector({ schema, label, accent = "#34d399", note, meta, onMeta, hideKeys, }) {
     const groups = schema.groups ?? [];
     const grouped = new Set(groups.map((group) => group.id));
+    const hidden = hideKeys === undefined || hideKeys.length === 0 ? null : new Set(hideKeys);
+    const visible = hidden === null ? schema.fields : schema.fields.filter((field) => !hidden.has(field.key));
     // Fields with no group (or a group not declared in schema.groups) render first, headerless.
-    const ungrouped = schema.fields.filter((field) => field.group === undefined || !grouped.has(field.group));
-    return (_jsxs("div", { className: "space-y-2 rounded-lg border p-2.5", style: { borderColor: `${accent}26`, backgroundColor: `${accent}10` }, children: [_jsx("div", { className: "text-[9px] font-semibold uppercase tracking-[0.14em]", style: { color: accent }, children: label }), _jsx(PresetRow, { schema: schema, onMeta: onMeta }), ungrouped.map((field) => field.type === "action" ? (_jsx(ActionButton, { field: field, schema: schema, onMeta: onMeta }, field.key)) : (_jsx(FieldRow, { field: field, meta: meta, onMeta: onMeta }, field.key))), groups.map((group) => (_jsx(GroupSection, { title: group.label, accent: accent, fields: schema.fields.filter((field) => field.group === group.id), schema: schema, meta: meta, onMeta: onMeta, defaultCollapsed: group.collapsed ?? false }, group.id))), note !== undefined && note.length > 0 ? _jsx("div", { className: "text-[10px] text-neutral-500", children: note }) : null] }));
+    const ungrouped = visible.filter((field) => field.group === undefined || !grouped.has(field.group));
+    return (_jsxs("div", { className: "space-y-2 rounded-lg border p-2.5", style: { borderColor: `${accent}26`, backgroundColor: `${accent}10` }, children: [_jsx("div", { className: "text-[9px] font-semibold uppercase tracking-[0.14em]", style: { color: accent }, children: label }), _jsx(PresetRow, { schema: schema, onMeta: onMeta }), ungrouped.map((field) => field.type === "action" ? (_jsx(ActionButton, { field: field, schema: schema, onMeta: onMeta }, field.key)) : (_jsx(FieldRow, { field: field, meta: meta, onMeta: onMeta }, field.key))), groups
+                .map((group) => ({ group, fields: visible.filter((field) => field.group === group.id) }))
+                .filter((entry) => entry.fields.length > 0)
+                .map(({ group, fields }) => (_jsx(GroupSection, { title: group.label, accent: accent, fields: fields, schema: schema, meta: meta, onMeta: onMeta, defaultCollapsed: group.collapsed ?? false }, group.id))), note !== undefined && note.length > 0 ? _jsx("div", { className: "text-[10px] text-neutral-500", children: note }) : null] }));
 }

package/dist/handlers/index.js

@@ -4,6 +4,7 @@ import { documentHandlers } from "./document.js";
 import { gridHandlers } from "./grids.js";
 import { hierarchyHandlers } from "./hierarchy.js";
 import { minimapHandlers } from "./minimap.js";
+import { streetsHandlers } from "./streets.js";
 import { runtimeHandlers } from "./runtime.js";
 import { terrainHandlers } from "./terrain.js";
 /**
@@ -16,6 +17,7 @@ export const EDITOR_RPC_HANDLERS = {
     ...catalogHandlers,
     ...terrainHandlers,
     ...minimapHandlers,
+    ...streetsHandlers,
     ...hierarchyHandlers,
     ...collectionHandlers,
     ...gridHandlers,

package/dist/handlers/streets.d.ts

@@ -0,0 +1,3 @@
+import type { HandlerTable } from "./context.js";
+/** Document, selection, camera, mode, asset placement, and status verbs. */
+export declare const streetsHandlers: Pick<HandlerTable, "generate_streets">;