auto-git:

[add] .prettierrc.json
 [add] eslint.config.js
 [add] index.html
 [add] package.json
 [add] playwright.config.ts
 [add] src/app/App.tsx
 [add] src/app/app.css
 [add] src/app/editor-store.ts
 [add] src/app/use-editor-store.ts
 [add] src/assets/.gitkeep
 [add] src/commands/command-history.ts
 [add] src/commands/command.ts
 [add] src/commands/set-scene-name-command.ts
 [add] src/core/ids.ts
 [add] src/core/selection.ts
 [add] src/core/tool-mode.ts
 [add] src/core/vector.ts
 [add] src/document/migrate-scene-document.ts
 [add] src/document/scene-document.ts
 [add] src/entities/.gitkeep
 [add] src/geometry/.gitkeep
 [add] src/main.tsx
 [add] src/materials/.gitkeep
 [add] src/runtime-three/.gitkeep
 [add] src/serialization/local-draft-storage.ts
 [add] src/serialization/scene-document-json.ts
 [add] src/shared-ui/Panel.tsx
 [add] src/viewport-three/ViewportCanvas.tsx
 [add] src/viewport-three/viewport-host.ts
 [add] src/vite-env.d.ts
 [add] tests/domain/create-empty-scene-document.test.ts
 [add] tests/domain/editor-store.test.ts
 [add] tests/e2e/app-smoke.e2e.ts
 [add] tests/serialization/scene-document-json.test.ts
 [add] tests/setup/vitest.setup.ts
 [add] tsconfig.json
 [add] vite.config.ts
 [add] vitest.config.ts

src/document/scene-document.ts

@@ -0,0 +1,71 @@
+import { DEFAULT_SUN_DIRECTION, type Vec3 } from "../core/vector";
+
+export const SCENE_DOCUMENT_VERSION = 1 as const;
+
+export interface WorldBackgroundSettings {
+  mode: "solid";
+  colorHex: string;
+}
+
+export interface WorldAmbientLightSettings {
+  colorHex: string;
+  intensity: number;
+}
+
+export interface WorldSunLightSettings {
+  colorHex: string;
+  intensity: number;
+  direction: Vec3;
+}
+
+export interface WorldSettings {
+  background: WorldBackgroundSettings;
+  ambientLight: WorldAmbientLightSettings;
+  sunLight: WorldSunLightSettings;
+}
+
+export interface SceneDocument {
+  version: typeof SCENE_DOCUMENT_VERSION;
+  name: string;
+  world: WorldSettings;
+  materials: Record<string, never>;
+  textures: Record<string, never>;
+  assets: Record<string, never>;
+  brushes: Record<string, never>;
+  modelInstances: Record<string, never>;
+  entities: Record<string, never>;
+  interactionLinks: Record<string, never>;
+}
+
+export function createDefaultWorldSettings(): WorldSettings {
+  return {
+    background: {
+      mode: "solid",
+      colorHex: "#2f3947"
+    },
+    ambientLight: {
+      colorHex: "#f7f1e8",
+      intensity: 1
+    },
+    sunLight: {
+      colorHex: "#fff1d5",
+      intensity: 1.75,
+      direction: DEFAULT_SUN_DIRECTION
+    }
+  };
+}
+
+export function createEmptySceneDocument(overrides: Partial<Pick<SceneDocument, "name" | "world">> = {}): SceneDocument {
+  return {
+    version: SCENE_DOCUMENT_VERSION,
+    name: overrides.name ?? "Untitled Scene",
+    world: overrides.world ?? createDefaultWorldSettings(),
+    materials: {},
+    textures: {},
+    assets: {},
+    brushes: {},
+    modelInstances: {},
+    entities: {},
+    interactionLinks: {}
+  };
+}