@volter/editor-game 0.5.65 → 0.5.67

package/contributions/state-watch.menu.ts

@@ -3,7 +3,7 @@
  * same predicate the drawer tab's own `available` gate reads. `disabled` is
  * asked at render, so it follows the session.
  */
-import { getActiveDebug } from '@volter/editor-core/authoring/active-systems';
+import { getActiveDebug } from '@volter/editor-sdk/kit/authoring/active-systems';
 import type { MenuContribution } from '@volter/editor-sdk/chrome';
 import { editorHost } from '@volter/editor-sdk/host';
 

package/contributions/state-watch.utility.tsx

@@ -7,7 +7,7 @@
  * `available` reads the PRIMARY authoring mount's debug adapter, exactly what
  * the panel itself reads, so the gate and the content can never disagree.
  */
-import { getActiveDebug } from '@volter/editor-core/authoring/active-systems';
+import { getActiveDebug } from '@volter/editor-sdk/kit/authoring/active-systems';
 import { StateWatchPanel } from '../src/state-watch/StateWatchPanel';
 
 export const point = 'workspace.utility';

package/contributions/team-playtest.service.ts

@@ -11,10 +11,10 @@
  * through the `@editor/*` alias.
  */
 
-import { getActiveNetworking, subscribeActiveNetworking } from '@volter/editor-core/authoring/active-systems';
-import { connectCollaboration } from '@volter/editor-core/collaboration-client';
-import { reportCollaborationPresence } from '@volter/editor-core/collaboration-presence';
-import { EDITOR_PARTICIPANT_ID } from '@volter/editor-core/editor-presence';
+import { getActiveNetworking, subscribeActiveNetworking } from '@volter/editor-sdk/kit/authoring/active-systems';
+import { connectCollaboration } from '@volter/editor-sdk/kit/collaboration-client';
+import { reportCollaborationPresence } from '@volter/editor-sdk/kit/collaboration-presence';
+import { EDITOR_PARTICIPANT_ID } from '@volter/editor-sdk/kit/editor-presence';
 import { activePlaytest, enterPlayMode, exitPlayMode } from '../src/play/play-mode';
 
 export const point = 'workspace.service';

package/contributions/three/component-board.service.ts

@@ -14,7 +14,7 @@
  * the same question as "do you want three?".
  */
 
-import { registerComponentBoard } from '@volter/editor-core/component-board-registry';
+import { registerComponentBoard } from '@volter/editor-sdk/kit/component-board-registry';
 import { threeComponentBoard } from '../../src/three/three-board/three-component-board';
 
 export const point = 'workspace.service';

package/contributions/three/component-verbs.command.ts

@@ -24,14 +24,14 @@
  * the two cannot drift.
  */
 
-import { getActiveAuthoring } from '@volter/editor-core/authoring/active-adapter';
-import type { EditorShellStore } from '@volter/editor-core/editor-shell-store';
+import { getActiveAuthoring } from '@volter/editor-sdk/kit/authoring/active-adapter';
+import type { EditorShellStore } from '@volter/editor-threejs/kit/editor-shell-store';
 import { canExtractNode, isExtractedHint } from '../../src/host/instance-extract-actions';
 import { canForkInstance, isForkedHint } from '../../src/host/instance-fork-actions';
-import { shellStoreForHost } from '@volter/editor-core/shell-store-door';
 import type { CommandContribution } from '@volter/editor-sdk/commands';
 import { instanceExtractSourceFor } from '../../src/three/component-verbs/extract-menu';
 import { instanceForkSourceFor } from '../../src/three/component-verbs/fork-menu';
+import { threeStoreForHost } from '@volter/editor-threejs/kit/three-state';
 
 /** The shell store, or the refusal that says the page has not installed one —
  *  the same shape `bridge.command.ts` takes it in, made explicit because both
@@ -42,7 +42,7 @@ const NO_STORE = { ok: false as const, error: 'the editor shell has not started
 function subjectId(cmd: Record<string, unknown>, store: EditorShellStore): string | undefined {
   const given = cmd['id'];
   if (typeof given === 'string' && given.trim() !== '') return given;
-  return [...store.selectedEntityIds][0];
+  return [...store.shell.selectedEntityIds][0];
 }
 
 export const commands: CommandContribution['commands'] = {
@@ -51,11 +51,11 @@ export const commands: CommandContribution['commands'] = {
     derivedRefresh: 'always',
     handle: async (cmd) => {
       try {
-        const store = shellStoreForHost();
+        const store = threeStoreForHost();
         if (!store) return NO_STORE;
         const id = subjectId(cmd, store);
         if (!id) return { ok: false, error: 'extract-component needs an id or a selected row.' };
-        const adapter = getActiveAuthoring(store);
+        const adapter = getActiveAuthoring(store.shell);
         const source = instanceExtractSourceFor(adapter, id);
         if (!canExtractNode(adapter.hierarchy.node(id), source, id)) {
           return {
@@ -82,11 +82,11 @@ export const commands: CommandContribution['commands'] = {
     derivedRefresh: 'always',
     handle: async (cmd) => {
       try {
-        const store = shellStoreForHost();
+        const store = threeStoreForHost();
         if (!store) return NO_STORE;
         const id = subjectId(cmd, store);
         if (!id) return { ok: false, error: 'fork-component needs an id or a selected row.' };
-        const adapter = getActiveAuthoring(store);
+        const adapter = getActiveAuthoring(store.shell);
         const source = instanceForkSourceFor(adapter, id);
         if (!canForkInstance(adapter.hierarchy.node(id), source, id)) {
           return {

package/contributions/three/three-authoring.service.ts

@@ -25,11 +25,13 @@
  * product that composes this package pays for it.
  */
 
-import { setBaseAuthoringFactory } from '@volter/editor-core/authoring/active-adapter';
-import { registerDesignTimeMount } from '@volter/editor-core/authoring/design-time-mount-registry';
-import { queueEditModeRebuild } from '@volter/editor-core/authoring/edit-mode-authoring';
+import { setBaseAuthoringFactory } from '@volter/editor-sdk/kit/authoring/active-adapter';
+import { registerDesignTimeMount } from '@volter/editor-sdk/kit/authoring/design-time-mount-registry';
+import { queueEditModeRebuild } from '@volter/editor-sdk/kit/authoring/edit-mode-authoring';
 import { authoringJournal } from '../../src/host/history/json-history-resource';
 import { oidThree } from '../../src/three/authoring/three-authoring-adapter';
+import type { WorldRootSessionContext } from '../../src/host/components/world-root-stage';
+import { threeStateOf } from '@volter/editor-threejs/kit/three-state';
 
 export const point = 'workspace.service';
 
@@ -45,12 +47,13 @@ export function start(): () => void {
     // R3F design session's fiber scene, once it adopts) is what the hierarchy
     // shows, and an unmounted world honestly shows nothing rather than a
     // fabricated document.
-    oidThree(store, () => store.scene, worldId, authoringJournal(worldId)),
+    oidThree(threeStateOf(store), () => threeStateOf(store).scene, worldId, authoringJournal(worldId)),
   );
   const stopMount = registerDesignTimeMount({
     kind: 'three',
     owner: '@volter/editor-game/three/three-authoring',
-    mountWorldRootSession: async (context) => {
+    async mountWorldRootSession(stage) {
+      const context = stage as WorldRootSessionContext;
       const { mountR3FDesignSession } = await session;
       return mountR3FDesignSession(context.store, context.composite, context.renderer);
     },

package/contributions/three-story-capture.service.ts

@@ -0,0 +1,12 @@
+/**
+ * The three.js story thumbnail capture (`@volter/editor-sdk/kit/story-thumbnails`), installed at
+ * boot (`workspace.service`): a prefab story renders in an offscreen React Three Fiber stage
+ * (`src/host/stories/three-story-captures.ts`). It is the game's, because prefab stories are R3F.
+ */
+import { registerThreeStoryCapture } from '../src/host/stories/three-story-captures';
+
+export const point = 'workspace.service';
+
+export function start(): () => void {
+  return registerThreeStoryCapture();
+}

package/contributions/unity.palette.json

@@ -0,0 +1,102 @@
+{
+  "schemaVersion": 3,
+  "name": "Unity",
+  "theme": {
+    "id": "unity",
+    "color": {
+      "surface": {
+        "shell": "#191919",
+        "panel": "#383838",
+        "chrome": "#282828",
+        "raised": "#585858",
+        "inset": "#2a2a2a",
+        "overlay": "rgba(40,40,40,0.96)"
+      },
+      "boundary": {
+        "default": "#232323",
+        "strong": "#191919",
+        "area": "#191919",
+        "indent": "#4a4a4a",
+        "divider": "#2f2f2f"
+      },
+      "content": {
+        "primary": "#d2d2d2",
+        "muted": "#c4c4c4",
+        "dim": "#8f8f8f",
+        "onAccent": "#ffffff",
+        "menu": "#d2d2d2",
+        "status": "#a0a0a0",
+        "placeholder": "#6f6f6f",
+        "active": "#7bbcff",
+        "selected": "#ffffff",
+        "onBright": {
+          "primary": "#191919",
+          "muted": "rgba(25,25,25,0.82)",
+          "dim": "rgba(25,25,25,0.7)"
+        }
+      },
+      "accent": {
+        "default": "#3a79bb",
+        "muted": "#2c5d87"
+      },
+      "widget": {
+        "regular": "#585858",
+        "menu": "#383838",
+        "field": "#2a2a2a",
+        "emboss": "rgba(0,0,0,0.2)"
+      },
+      "viewport": {
+        "background": "#474747",
+        "grid": "#76726f",
+        "axisX": "#db3e1d",
+        "axisY": "#9af348",
+        "axisZ": "#3a7af8",
+        "selection": "#ff6600",
+        "wire": "#5e779b",
+        "active": "#ff6600"
+      },
+      "gizmo": {
+        "x": "#db3e1d",
+        "y": "#9af348",
+        "z": "#3a7af8",
+        "hover": "#c9c890",
+        "drag": "#f6f232"
+      },
+      "region": {
+        "outliner": "#383838",
+        "properties": "#383838"
+      },
+      "category": {
+        "object": "#8fb8f0",
+        "modifier": "#8fb8f0",
+        "material": "#e0a060",
+        "data": "#9fd88c",
+        "scene": "#d2d2d2",
+        "collection": "#d2d2d2",
+        "tool": "#d2d2d2",
+        "operator": "#9fd88c"
+      },
+      "semantic": {
+        "danger": "#ff6b5b",
+        "dangerMuted": "rgba(255,120,107,0.28)",
+        "dangerFaint": "rgba(255,120,107,0.12)",
+        "warning": "#ffc107",
+        "warningMuted": "rgba(255,221,101,0.28)",
+        "success": "#7cc576",
+        "successMuted": "rgba(69,255,139,0.28)",
+        "dynamic": "#ffdd65",
+        "dynamicMuted": "rgba(255,221,101,0.18)",
+        "instance": "#7bbcff"
+      },
+      "neutralOverlay": {
+        "hover": "rgba(255,255,255,0.07)",
+        "active": "rgba(255,255,255,0.13)"
+      },
+      "scrim": "rgba(0,0,0,0.6)"
+    },
+    "typography": {
+      "sans": "'Inter', 'Segoe UI', system-ui, sans-serif",
+      "mono": "'Roboto Mono', Menlo, monospace"
+    }
+  }
+}

package/contributions/unity.style.ts

@@ -0,0 +1,72 @@
+/**
+ * THE UNITY LOOK — Unity 6's dark editor skin and its Scene view's colours,
+ * made only of values (`docs/VIEWPORT-STAGE.md`, the Unity column).
+ *
+ * The viewport group transcribes UnityCsReference: the fill is the Scene
+ * view's flat colour with the skybox off (0.278, 0.278, 0.278); selection is
+ * `Handles.selectedColor`'s outline `#ff6600`. The grid (0.5, 0.5, 0.5, 0.4)
+ * is fitted against `engine-reference/unity/NewEmptyScene_01.png`: its lines
+ * sit about 10 levels over the skybox ground (104, 97, 92). The axis colours, named by the world's axes, are
+ * `Handles.xAxisColor`, `yAxisColor` and `zAxisColor`; Unity's floor draws no axis
+ * lines, which is its view's presentation (`overlays.axes` all off), not this look's.
+ * Light, skybox and overlays are the VIEW's presentation, not this look's.
+ */
+import type { StyleContribution } from '@volter/editor-sdk/looks';
+import palette from './unity.palette.json';
+
+export const point = 'workspace.style';
+export const style: StyleContribution = {
+  id: 'unity',
+  title: 'Unity',
+  paletteId: 'unity',
+  materialId: 'unity',
+  material: {
+    id: 'unity',
+    title: 'Unity',
+    description: 'Flat grey panels, three-pixel control corners, a shadow under popups.',
+    shape: { small: '3px', medium: '3px', large: '4px', full: '9999px' },
+    elevation: {
+      small: 'none',
+      medium: '0 2px 8px rgba(0,0,0,0.5)',
+      large: '0 6px 18px rgba(0,0,0,0.55)',
+    },
+    stage: {
+      // THE SCENE VIEW'S OWN CHROME (`NewEmptyScene_01.png`, `PrimitiveCube.png`): the Scene
+      // view's toolbar is a flush band with the draw mode first ("Shaded"); the tools are
+      // Unity's Tools overlay at the view's left; the view's name is the label under the scene
+      // gizmo ("Persp"), which toggles the projection.
+      chrome: { bar: 'strip', viewName: 'gizmo', tools: 'shelf', display: 'bar-start' },
+      // Unity's draw modes and its Gizmos menu (`NewEmptyScene_01.png`: `Shaded`, `Gizmos`).
+      words: { shading: { solid: 'Shaded', wireframe: 'Wireframe' }, helpers: 'Gizmos' },
+      // A handle is 80 points on screen whatever the distance (`HandleUtility.GetHandleSize`,
+      // `k_KHandleSize`), the radius of the rotate disc; the stage's ring radius is this many
+      // CSS px. The documentation's frames are small Scene views at about half scale, so their
+      // arrows look long beside the object; on screen they are these points.
+      gizmoSize: 80,
+      // Unity's scene gizmo: cones round a grey cube (`Editor-SceneGizmo.png`).
+      navigationGizmo: 'cones',
+      // `Handles.ArrowHandleCap`: a shaft to 0.9 of the handle and a cone centred at 1.0, scaled
+      // 0.2 of it. The cone mesh's own proportions are the editor's resource, so they are read
+      // off `TransformGizmo35.png` at 1x: a tip at about 1.1 handles and a cone about 0.25 of
+      // the handle long, 1.25 of three's head.
+      gizmoArrowLength: 1.1,
+      gizmoArrowHead: 1.25,
+      // The axis colours' alpha (`Handles.cs`); hover and drag are fixed colours (the palette).
+      gizmoOpacity: 0.93,
+      // `SceneViewGrid`: one-pixel lines at both levels, the ten-cell level a little stronger.
+      gridLineWidth: 1,
+      gridMajorWidth: 1,
+      gridMajorContrast: 1.25,
+      // Unity's selection outline is a hard orange line about two pixels wide at 1x, around
+      // the whole silhouette, occluded parts included (`game-objects-transform-modes.png`,
+      // `SceneVisExVisible.png`, where it crosses the rock in front of the structure); at 3
+      // device px the crisp line measures one full and one partial pixel on a 1x capture, as there.
+      outlineStyle: 'crisp',
+      outlineWidth: 3,
+      outlineHidden: true,
+      // The Selection Wire's alpha: `(94, 119, 155, 64)` (the palette holds its colour).
+      wireOpacity: 0.25,
+    },
+  },
+  palette,
+};

package/contributions/unity.view.ts

@@ -0,0 +1,82 @@
+/**
+ * UNITY'S DEFAULT SCENE VIEW: its procedural sky with a narrow horizon band (colours fitted to
+ * `NewEmptyScene_01.png`, not transcribed), the grid, no axis lines, the outline alone, the Move
+ * tool without a free-move centre.
+ * A named view (`@volter/editor-sdk/kit/viewport-presentation` `ViewPreset`): what the view does
+ * and how it is lit, never its look — pair it with the Unity style for the whole target.
+ */
+import type { ViewPreset } from '@volter/editor-sdk/kit/viewport-presentation';
+
+export const point = 'workspace.view';
+export const view: ViewPreset = {
+  id: 'unity',
+  title: 'Unity',
+  layer: {
+    // Unity's Scene camera: `kDefaultPerspectiveFov` 60, vertical when the view is wider than tall
+    // and horizontal otherwise (`SceneView.GetVerticalFOV`) — on its smaller side.
+    camera: { fov: { degrees: 60, axis: 'smaller' } },
+    all: {
+      lighting: {
+        source: 'preview',
+        preview: {
+          sun: {
+            enabled: true,
+            color: '#fff4d6',
+            energy: 1,
+            altitude: 50,
+            azimuth: 150,
+            shadowDistance: 100,
+          },
+          environment: {
+            enabled: true,
+            sky: {
+              top: '#4a84c2',
+              horizon: '#f0ffff',
+              ground: '#68615c',
+              topCurve: 0.04,
+              groundCurve: 0.003,
+            },
+            energy: 1,
+            rotation: 0,
+          },
+        },
+        tone: {
+          mapper: 'none',
+          exposure: 1,
+        },
+      },
+      backdrop: {
+        source: 'environment',
+        opacity: 1,
+        blur: 0,
+      },
+    },
+    overlays: {
+      // No zoom and pan buttons under the gizmo and no camera readout: the engine draws neither.
+      navigationControls: false,
+      cameraReadout: false,
+      grid: {
+        visible: true,
+        majorEvery: 10,
+      },
+      selection: {
+        outline: true,
+        wire: false,
+        box: false,
+      },
+      axes: {
+        x: false,
+        y: false,
+        z: false,
+      },
+    },
+    interaction: {
+      bootTool: 'move',
+      transformHandles: {
+        scale: false,
+        viewRotate: false,
+        freeMove: false,
+      },
+    },
+  },
+};

package/contributions/unreal.palette.json

@@ -0,0 +1,105 @@
+{
+  "schemaVersion": 3,
+  "name": "Unreal",
+  "theme": {
+    "id": "unreal",
+    "color": {
+      "surface": {
+        "shell": "#151515",
+        "panel": "#242424",
+        "chrome": "#151515",
+        "raised": "#383838",
+        "inset": "#0f0f0f",
+        "overlay": "rgba(36,36,36,0.97)"
+      },
+      "boundary": {
+        "default": "#151515",
+        "strong": "#0f0f0f",
+        "area": "#151515",
+        "indent": "#383838",
+        "divider": "#1a1a1a"
+      },
+      "content": {
+        "primary": "#c0c0c0",
+        "muted": "#b4b4b4",
+        "dim": "#858585",
+        "onAccent": "#ffffff",
+        "menu": "#c0c0c0",
+        "status": "#a7a7a7",
+        "placeholder": "#6d6d6d",
+        "active": "#4d9be9",
+        "selected": "#ffffff",
+        "onBright": {
+          "primary": "#151515",
+          "muted": "rgba(21,21,21,0.82)",
+          "dim": "rgba(21,21,21,0.7)"
+        }
+      },
+      "accent": {
+        "default": "#0f6ece",
+        "muted": "#40576f"
+      },
+      "widget": {
+        "regular": "#383838",
+        "menu": "#242424",
+        "field": "#0f0f0f",
+        "emboss": "rgba(0,0,0,0.2)"
+      },
+      "viewport": {
+        "background": "#000000",
+        "grid": "#5a5a5a",
+        "axisX": "#c02800",
+        "axisY": "#66a600",
+        "axisZ": "#2e75df",
+        "selection": "#eaa112",
+        "wire": "#eaa112",
+        "active": "#eaa112"
+      },
+      "gizmo": {
+        "x": "#c02800",
+        "y": "#66a600",
+        "z": "#2e75df",
+        "navigationX": "#ff0000",
+        "navigationY": "#00ff00",
+        "navigationZ": "#0000ff",
+        "hover": "#ffff00",
+        "drag": "#ffff00"
+      },
+      "region": {
+        "outliner": "#242424",
+        "properties": "#242424"
+      },
+      "category": {
+        "object": "#8fb8f0",
+        "modifier": "#8fb8f0",
+        "material": "#a27f4b",
+        "data": "#9fd88c",
+        "scene": "#c0c0c0",
+        "collection": "#c0c0c0",
+        "tool": "#c0c0c0",
+        "operator": "#9fd88c"
+      },
+      "semantic": {
+        "danger": "#ff6b5b",
+        "dangerMuted": "rgba(255,120,107,0.28)",
+        "dangerFaint": "rgba(255,120,107,0.12)",
+        "warning": "#ffc107",
+        "warningMuted": "rgba(255,221,101,0.28)",
+        "success": "#7cc576",
+        "successMuted": "rgba(69,255,139,0.28)",
+        "dynamic": "#ffdd65",
+        "dynamicMuted": "rgba(255,221,101,0.18)",
+        "instance": "#7bbcff"
+      },
+      "neutralOverlay": {
+        "hover": "rgba(255,255,255,0.1)",
+        "active": "rgba(255,255,255,0.16)"
+      },
+      "scrim": "rgba(0,0,0,0.6)"
+    },
+    "typography": {
+      "sans": "'Inter', 'Segoe UI', system-ui, sans-serif",
+      "mono": "'Roboto Mono', Menlo, monospace"
+    }
+  }
+}

package/contributions/unreal.style.ts

@@ -0,0 +1,66 @@
+/**
+ * THE UNREAL LOOK — Unreal Engine 5's dark editor skin and its Level Editor viewport's
+ * colours, made only of values (`docs/VIEWPORT-STAGE.md`, the Unreal column).
+ *
+ * Unreal is not installed here and its documentation states none of these numbers, so every
+ * value is READ from the documentation's frames (`engine-reference/unreal/level-editor.png`,
+ * 1920 x 1020), not transcribed from source. The chrome: panels #242424 on a #151515 shell,
+ * #0f0f0f fields, the #0f6ece armed-tool blue, #40576f selected rows. The viewport: the
+ * selection outline's core #eaa112, about three pixels wide; the Move widget's axes, their
+ * brightest unshaded pixels (#c02800, #66a600, #2e75df); the corner triad's pure #ff0000,
+ * #00ff00, #0000ff. The fill is black, what an Unreal level with no sky shows.
+ * Light, sky and overlays are the VIEW's presentation, not this look's.
+ */
+import type { StyleContribution } from '@volter/editor-sdk/looks';
+import palette from './unreal.palette.json';
+
+export const point = 'workspace.style';
+export const style: StyleContribution = {
+  id: 'unreal',
+  title: 'Unreal',
+  paletteId: 'unreal',
+  materialId: 'unreal',
+  material: {
+    id: 'unreal',
+    title: 'Unreal',
+    description: 'Near-black flat panels, four-pixel corners, pill-shaped viewport toolbar buttons.',
+    shape: { small: '4px', medium: '4px', large: '6px', full: '9999px' },
+    elevation: {
+      small: 'none',
+      medium: '0 2px 8px rgba(0,0,0,0.55)',
+      large: '0 6px 18px rgba(0,0,0,0.6)',
+    },
+    stage: {
+      // THE LEVEL VIEWPORT'S OWN CHROME (`level-editor.png`): one row of rounded pills over the
+      // view that runs on from its start: the view's name ("Perspective") and the view mode
+      // ("Lit"), then the transform tools, then the transform controls with the snap steps
+      // (`10`, `10°`, `0.5`).
+      chrome: { bar: 'pills', viewName: 'bar', tools: 'bar-start', display: 'bar-start', transformControls: 'bar' },
+      // Unreal's words for the view modes and the Show menu (`level-editor.png`: `Lit`, `Show`).
+      words: { shading: { solid: 'Lit', unlit: 'Unlit', wireframe: 'Wireframe' }, helpers: 'Show' },
+      // Unreal keeps its widget a constant size on screen; in `level-editor.png` the Move
+      // arrows reach 85 to 100 px from the centre sphere. Fitted, not transcribed: the stage's
+      // ring radius is this many CSS px, so the 0.85 tip below stands at 94 px.
+      gizmoSize: 110,
+      // The axis triad in the viewport's bottom-left corner (`level-editor.png`).
+      navigationGizmo: 'triad',
+      navigationCorner: 'bottom-left',
+      navigationSize: 1.3,
+      // Unreal's arrows end in slim cones about 14 px long on ~85 px shafts (`level-editor.png`),
+      // fitted side by side at 1x.
+      gizmoArrowLength: 0.85,
+      gizmoArrowHead: 0.8,
+      // A hard yellow-orange line about three pixels wide around the whole silhouette; the
+      // parts other objects hide are drawn too (dotted in Unreal, behind the table). Widths
+      // over 4 widen the blur kernel and the band goes pale and soft (measured: 5 peaks at
+      // #dfad6b over the sky), so 3 is the widest solid band the crisp form draws.
+      outlineStyle: 'crisp',
+      outlineWidth: 3,
+      outlineHidden: true,
+      gridLineWidth: 1,
+      gridMajorWidth: 1,
+      gridMajorContrast: 1.3,
+    },
+  },
+  palette,
+};

package/contributions/unreal.view.ts

@@ -0,0 +1,93 @@
+/**
+ * UNREAL'S DEFAULT LEVEL VIEWPORT: a preview sky standing in for the level's own, no grid, the
+ * outline, the Move tool with its free-move centre, a Z-up LEFT-handed world, and the axis
+ * triad as an indicator, and a preview floor taking the sun's shadow. The view's behaviour (tool,
+ * handles, axes, world, grid off) is read from `default-interface.png`; the sky, cloud and floor
+ * values are FITTED to `level-editor.png` (sampled pixel colours and a side-by-side), not
+ * transcribed from Unreal's own BP_Sky_Sphere or floor material.
+ * A named view (`@volter/editor-sdk/kit/viewport-presentation` `ViewPreset`): what the view does
+ * and how it is lit, never its look — pair it with the Unreal style for the whole target.
+ */
+import type { ViewPreset } from '@volter/editor-sdk/kit/viewport-presentation';
+
+export const point = 'workspace.view';
+export const view: ViewPreset = {
+  id: 'unreal',
+  title: 'Unreal',
+  layer: {
+    // Unreal's level viewport: a 90° horizontal field of view, its viewport setting's default.
+    camera: { fov: { degrees: 90, axis: 'horizontal' } },
+    all: {
+      lighting: {
+        source: 'preview',
+        preview: {
+          sun: {
+            enabled: true,
+            color: '#ffffff',
+            energy: 2.5,
+            altitude: 45,
+            azimuth: 300,
+            shadowDistance: 100,
+          },
+          environment: {
+            enabled: true,
+            sky: {
+              top: '#566b8c',
+              horizon: '#8ea6bf',
+              ground: '#2b323b',
+              topCurve: 0.1,
+              groundCurve: 0.12,
+              clouds: { cover: 0.55, opacity: 0.9, scale: 16 },
+            },
+            energy: 1,
+            rotation: 0,
+          },
+        },
+        tone: {
+          mapper: 'none',
+          exposure: 1,
+        },
+      },
+      backdrop: {
+        source: 'environment',
+        opacity: 1,
+        blur: 0,
+      },
+    },
+    overlays: {
+      // No zoom and pan buttons under the gizmo and no camera readout: the engine draws neither.
+      navigationControls: false,
+      cameraReadout: false,
+      navigation: 'indicator',
+      grid: {
+        visible: false,
+      },
+      floor: {
+        visible: true,
+        color: '#0a1428',
+      },
+      selection: {
+        outline: true,
+        wire: false,
+        box: false,
+      },
+      axes: {
+        x: false,
+        y: false,
+        z: false,
+      },
+    },
+    interaction: {
+      bootTool: 'move',
+      transformHandles: {
+        scale: false,
+        viewRotate: false,
+        freeMove: true,
+      },
+    },
+    world: {
+      upAxis: 'z',
+      handedness: 'left',
+    },
+  },
+};