@jgengine/editor 0.10.0 → 0.12.0

package/dist/uiStore.d.ts

@@ -47,8 +47,23 @@ export interface SculptSettings {
 export declare const DEFAULT_SCULPT_SETTINGS: SculptSettings;
 /** Which transform gizmo is active for the current selection. */
 export type GizmoMode = "translate" | "rotate" | "scale";
+/** Gizmo handle orientation: world axes, or the selection's local (yaw-rotated) axes. */
+export type GizmoSpace = "world" | "local";
+/**
+ * Where multi-select gizmo handles sit:
+ * - `origin` — primary selection (first selected id)
+ * - `center` — arithmetic mean of selected object positions
+ * - `median` — per-axis median of selected object positions
+ */
+export type GizmoPivot = "origin" | "center" | "median";
 /** How gizmo drags land: stick to terrain height, quantize to a grid, or free. */
 export type SnapMode = "ground" | "grid" | "off";
+/** Editor viewport camera projection — perspective (default) or orthographic top-down-friendly view. */
+export type CameraProjectionMode = "perspective" | "orthographic";
+/** Rotation snap increments (degrees) offered by the toolbar snap menu. */
+export declare const ROTATION_SNAP_CHOICES_DEG: readonly number[];
+/** Scale snap increments offered by the toolbar snap menu. */
+export declare const SCALE_SNAP_CHOICES: readonly number[];
 /** The active creation tool — what a viewport click places next. */
 export type PlacementTool = {
     tool: "marker";
@@ -73,15 +88,33 @@ export interface EditorContextMenuState {
 /** Transient editor UI state shared between chrome, viewport, and gizmos. */
 export interface EditorUiState {
     gizmoMode: GizmoMode;
+    /** Whether gizmo handles align to world axes or the selection's yaw. */
+    gizmoSpace: GizmoSpace;
+    /** Multi-select gizmo pivot policy. */
+    gizmoPivot: GizmoPivot;
     snapMode: SnapMode;
     gridSize: number;
+    /** Rotation snap increment in degrees; `null` rotates freely. */
+    rotationSnapDeg: number | null;
+    /** Scale snap increment; `null` scales freely. */
+    scaleSnap: number | null;
+    /** Viewport camera projection (perspective vs orthographic). */
+    cameraProjection: CameraProjectionMode;
     showGrid: boolean;
+    /** Surface-following iso-elevation contour overlay (terrain readability). */
+    showContours: boolean;
+    /** Terrain-draped reference grid overlay that climbs relief instead of being occluded by it. */
+    showSurfaceGrid: boolean;
+    /** Measurable elevation HUD: cursor height/delta, region min/max/mean, contour interval. */
+    showElevation: boolean;
     placement: PlacementTool | null;
     pathDraft: readonly EditorVec3[];
     pathPoint: {
         pathId: string;
         index: number;
     } | null;
+    /** Viewport pre-selection hover (object under cursor); null when nothing is hovered. */
+    hoverId: string | null;
     tool: EditorTool;
     terrainMode: TerrainMode;
     sculpt: SculptSettings;

package/dist/uiStore.js

@@ -30,6 +30,10 @@ export const DEFAULT_SCULPT_SETTINGS = {
     invert: false,
     heightLimit: { min: null, max: null },
 };
+/** Rotation snap increments (degrees) offered by the toolbar snap menu. */
+export const ROTATION_SNAP_CHOICES_DEG = [5, 15, 45, 90];
+/** Scale snap increments offered by the toolbar snap menu. */
+export const SCALE_SNAP_CHOICES = [0.1, 0.25, 0.5, 1];
 function placementId(prefix) {
     return `${prefix}_${Date.now().toString(36)}_${Math.floor(Math.random() * 1296).toString(36)}`;
 }
@@ -37,12 +41,21 @@ function placementId(prefix) {
 export function createEditorUiStore() {
     let state = {
         gizmoMode: "translate",
+        gizmoSpace: "world",
+        gizmoPivot: "center",
         snapMode: "ground",
         gridSize: 1,
+        rotationSnapDeg: 15,
+        scaleSnap: null,
+        cameraProjection: "perspective",
         showGrid: true,
+        showContours: false,
+        showSurfaceGrid: false,
+        showElevation: false,
         placement: null,
         pathDraft: [],
         pathPoint: null,
+        hoverId: null,
         tool: "select",
         terrainMode: "sculpt",
         sculpt: { ...DEFAULT_SCULPT_SETTINGS },

package/dist/viewportContextMenu.d.ts

@@ -3,7 +3,7 @@ export declare const RIGHT_CLICK_SLOP_PX = 4;
 /** @internal True when the pointer released within the drag-vs-click threshold of its down position. */
 export declare function isPointerClick(startX: number, startY: number, endX: number, endY: number, thresholdPx?: number): boolean;
 /** @internal One entry in the editor viewport context menu. */
-export type EditorContextActionId = "frame" | "frameAll" | "duplicate" | "delete" | "createPrefab" | "copy" | "paste" | "addMarker" | "addVolume" | "addPath" | "addNote" | "openAssets";
+export type EditorContextActionId = "frame" | "frameAll" | "duplicate" | "delete" | "createPrefab" | "parentTo" | "unparent" | "copy" | "paste" | "addMarker" | "addVolume" | "addPath" | "addNote" | "openAssets";
 /** @internal Label + id for one editor context-menu verb. */
 export interface EditorContextAction {
     id: EditorContextActionId;
@@ -16,9 +16,11 @@ export interface BuildEditorContextMenuInput {
     hitId: string | null;
     selection: readonly string[];
     canPaste: boolean;
+    /** True when at least one selected/hit object has a parent (offers Unparent). */
+    canUnparent?: boolean;
 }
 /**
  * @internal Selection-aware editor context verbs (#866). Hit/selection → frame/duplicate/delete/copy/prefab;
- * empty ground → place tools + paste when clipboard has content.
+ * empty ground → place tools + paste when clipboard has content. Shared by viewport and hierarchy rows.
  */
 export declare function buildEditorContextMenu(input: BuildEditorContextMenuInput): readonly EditorContextAction[];

package/dist/viewportContextMenu.js

@@ -6,7 +6,7 @@ export function isPointerClick(startX, startY, endX, endY, thresholdPx = RIGHT_C
 }
 /**
  * @internal Selection-aware editor context verbs (#866). Hit/selection → frame/duplicate/delete/copy/prefab;
- * empty ground → place tools + paste when clipboard has content.
+ * empty ground → place tools + paste when clipboard has content. Shared by viewport and hierarchy rows.
  */
 export function buildEditorContextMenu(input) {
     const hasSelection = input.selection.length > 0 || input.hitId !== null;
@@ -17,6 +17,10 @@ export function buildEditorContextMenu(input) {
             { id: "copy", label: "Copy" },
             { id: "delete", label: "Delete", separatorBefore: true },
             { id: "createPrefab", label: "Create prefab…", separatorBefore: true },
+            { id: "parentTo", label: "Parent to…", separatorBefore: true },
+            ...(input.canUnparent === true
+                ? [{ id: "unparent", label: "Unparent" }]
+                : []),
             { id: "paste", label: "Paste", disabled: !input.canPaste, separatorBefore: true },
         ];
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jgengine/editor",
-  "version": "0.10.0",
+  "version": "0.12.0",
   "description": "Scene/world/asset editor for JGengine — loaded lazily by the runner; never import from game entrypoints.",
   "license": "Apache-2.0",
   "type": "module",
@@ -31,9 +31,9 @@
     "test": "bun test src"
   },
   "dependencies": {
-    "@jgengine/core": "^0.10.0",
-    "@jgengine/react": "^0.10.0",
-    "@jgengine/shell": "^0.10.0"
+    "@jgengine/core": "^0.12.0",
+    "@jgengine/react": "^0.12.0",
+    "@jgengine/shell": "^0.12.0"
   },
   "peerDependencies": {
     "@react-three/drei": "^10.0.0",