@treasuryspatial/viewer-kit 0.2.45 → 0.2.50

package/dist/materials/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/materials/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAChC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,sBAAsB,CAAC;IACjC,GAAG,EAAE,iBAAiB,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,aAAa,CAAC,kBAAkB,CAAC,CAAC;CAC9C,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,kBAAkB,CAAC,YAAY,CAAC,CAAC;AAE1D,MAAM,MAAM,aAAa,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhE,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,UAAU,GAAG,QAAQ,CAAC;IAC5B,KAAK,EAAE,aAAa,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,qBAAqB,CAAC;IAC7B,KAAK,EAAE,qBAAqB,CAAC;IAC7B,OAAO,EAAE,qBAAqB,CAAC;CAChC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/materials/types.ts"],"names":[],"mappings":"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"}

package/dist/presets/defaults.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/presets/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,eAAO,MAAM,iBAAiB,mBAAmB,CAAC;AAElD,eAAO,MAAM,eAAe,EAAE,aA2C7B,CAAC"}
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/presets/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,eAAO,MAAM,iBAAiB,mBAAmB,CAAC;AAElD,eAAO,MAAM,eAAe,EAAE,aA2D7B,CAAC"}

package/dist/presets/defaults.js

@@ -8,6 +8,7 @@ export const DEFAULT_PRESETS = {
             toneMappingExposure: 1.0,
             outputColorSpace: "srgb",
             maxPixelRatio: 1.75,
+            powerPreference: "high-performance",
             antialias: true,
             alpha: true,
             shadowMap: {
@@ -31,6 +32,7 @@ export const DEFAULT_PRESETS = {
             hemisphere: { skyColor: "#ffffff", groundColor: "#f4f4f4", intensity: 1.2 },
             key: { color: "#ffffff", intensity: 1.6, position: [10, 15, 5], castShadow: true },
             fill: { color: "#ffffff", intensity: 0.6, position: [-10, 10, -5] },
+            shadow: { autoFit: true, cameraSize: 25, near: 0.1, far: 60, bias: -0.0001, normalBias: 0.035, radius: 3 },
         },
         postfx: {
             ao: { enabled: false, intensity: 1.0, radius: 2.0, distanceFalloff: 1.0, halfRes: false },
@@ -38,8 +40,22 @@ export const DEFAULT_PRESETS = {
         sceneExtras: {
             grid: true,
             ground: true,
+            groundMode: "infinite",
+            gridMode: "infinite",
             axes: false,
-            origin: true,
+            origin: false,
+            originHighlight: false,
+            groundColor: 0xf2f1ec,
+            gridColor: 0xd7d3ca,
+            gridColorSecondary: 0xe4e0d7,
+            gridUnit: 1,
+            gridMajorEvery: 5,
+            gridSuperMajorEvery: 10,
+            gridOpacity: 0.055,
+            gridMajorOpacity: 0.12,
+            gridSuperMajorOpacity: 0.2,
+            gridSize: 120,
+            gridHeightOffset: 0.035,
         },
     },
 };

package/dist/presets/sciencePresets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sciencePresets.d.ts","sourceRoot":"","sources":["../../src/presets/sciencePresets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EAOd,MAAM,iBAAiB,CAAC;AAkgBzB,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAE3D,CAAC;AAEF,eAAO,MAAM,yBAAyB,kBAA6B,CAAC;AAEpE,wBAAgB,kBAAkB,IAAI,aAAa,CA6BlD;AAGD,eAAO,MAAM,mBAAmB,2BAAqB,CAAC;AAEtD,eAAO,MAAM,eAAe,eAAuB,CAAC"}
+{"version":3,"file":"sciencePresets.d.ts","sourceRoot":"","sources":["../../src/presets/sciencePresets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EAOd,MAAM,iBAAiB,CAAC;AA+nBzB,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAE3D,CAAC;AAEF,eAAO,MAAM,yBAAyB,kBAA6B,CAAC;AAEpE,wBAAgB,kBAAkB,IAAI,aAAa,CA6BlD;AAGD,eAAO,MAAM,mBAAmB,2BAAqB,CAAC;AAEtD,eAAO,MAAM,eAAe,eAAuB,CAAC"}

package/dist/presets/sciencePresets.js

@@ -1,18 +1,26 @@
-import { BASELINE_MATERIAL_PRESET_ID } from "../materials/presets";
+import { ARCHITECTURAL_WHITE_MATERIAL_PRESET_ID, MONOCHROME_CLAY_MATERIAL_PRESET_ID, } from "../materials/presets";
 const DEFAULT_LIGHTING_PRESET_ID = "architectural";
 const DEFAULT_ENVIRONMENT_PRESET_ID = "architectural";
 const DEFAULT_SCENE_EXTRAS = {
     ground: true,
+    groundMode: "infinite",
+    gridMode: "infinite",
     grid: true,
-    axes: true,
-    origin: true,
-    gridOpacity: 0.12,
-    gridDivisions: 80,
-    gridSize: 80,
+    axes: false,
+    origin: false,
+    gridUnit: 1,
+    gridMajorEvery: 5,
+    gridSuperMajorEvery: 10,
+    gridOpacity: 0.055,
+    gridMajorOpacity: 0.12,
+    gridSuperMajorOpacity: 0.2,
+    gridSize: 120,
+    gridPlane: "floor",
+    gridHeightOffset: 0.035,
     groundRoughness: 0.8,
     groundMetalness: 0.05,
     lightTarget: [0, 1.5, 0],
-    originHighlight: true,
+    originHighlight: false,
     originLineColor: 0x94a3b8,
     originLineLength: 40,
     originLineThickness: 0.06,
@@ -27,23 +35,66 @@ const DEFAULT_SCENE_EXTRAS = {
 const PRESET_SCENE_EXTRAS = {
     architectural: {
         ground: true,
+        groundMode: "infinite",
         grid: true,
-        axes: true,
-        origin: true,
-        groundColor: 0xf5f5f5,
-        groundRoughness: 0.75,
+        axes: false,
+        origin: false,
+        groundColor: 0xf2f1ec,
+        groundRoughness: 0.82,
         groundMetalness: 0.0,
-        gridColor: 0xdedede,
-        gridColorSecondary: 0xeaeaea,
-        gridOpacity: 0.12,
-        gridDivisions: 100,
-        gridSize: 100,
-        gridHeightOffset: 0.09,
+        gridColor: 0xd7d3ca,
+        gridColorSecondary: 0xe4e0d7,
+        gridOpacity: 0.055,
+        gridMajorOpacity: 0.12,
+        gridSuperMajorOpacity: 0.2,
+        gridSize: 120,
+        gridHeightOffset: 0.035,
+    },
+    "monochrome-clay": {
+        ground: true,
+        groundMode: "infinite",
+        grid: true,
+        axes: false,
+        origin: false,
+        groundColor: 0xefeee8,
+        groundRoughness: 0.86,
+        groundMetalness: 0.0,
+        gridColor: 0xd8d5cc,
+        gridColorSecondary: 0xe5e2da,
+        gridOpacity: 0.05,
+        gridMajorOpacity: 0.11,
+        gridSuperMajorOpacity: 0.18,
+        gridSize: 120,
+        gridHeightOffset: 0.035,
+        outline: false,
+    },
+    "outline-monochrome": {
+        ground: true,
+        groundMode: "infinite",
+        grid: true,
+        axes: false,
+        origin: false,
+        groundColor: 0xf3f2ed,
+        groundRoughness: 0.88,
+        groundMetalness: 0.0,
+        gridColor: 0xd6d2c8,
+        gridColorSecondary: 0xe7e3da,
+        gridOpacity: 0.045,
+        gridMajorOpacity: 0.105,
+        gridSuperMajorOpacity: 0.17,
+        gridSize: 120,
+        gridHeightOffset: 0.035,
+        outline: true,
+        outlineColor: 0x1f2937,
+        outlineOpacity: 0.34,
+        outlineThresholdAngle: 32,
+        outlineDepthTest: true,
     },
     studio: {
         ground: true,
+        groundMode: "infinite",
         grid: true,
-        axes: true,
+        axes: false,
         origin: false,
         groundColor: 0x1f2024,
         groundRoughness: 0.9,
@@ -53,9 +104,10 @@ const PRESET_SCENE_EXTRAS = {
     },
     daylight: {
         ground: true,
+        groundMode: "infinite",
         grid: true,
-        axes: true,
-        origin: true,
+        axes: false,
+        origin: false,
         groundColor: 0xe2d5c2,
         groundRoughness: 0.7,
         groundMetalness: 0.04,
@@ -64,8 +116,9 @@ const PRESET_SCENE_EXTRAS = {
     },
     "gallery-spot": {
         ground: true,
+        groundMode: "infinite",
         grid: true,
-        axes: true,
+        axes: false,
         origin: false,
         groundColor: 0x131419,
         groundRoughness: 0.85,
@@ -76,9 +129,10 @@ const PRESET_SCENE_EXTRAS = {
     },
     "lab-neutral": {
         ground: true,
+        groundMode: "infinite",
         grid: true,
-        axes: true,
-        origin: true,
+        axes: false,
+        origin: false,
         groundColor: 0xf4f5f7,
         groundRoughness: 0.78,
         groundMetalness: 0.03,
@@ -87,8 +141,9 @@ const PRESET_SCENE_EXTRAS = {
     },
     "atrium-suntrack": {
         ground: true,
+        groundMode: "infinite",
         grid: true,
-        axes: true,
+        axes: false,
         origin: false,
         groundColor: 0xe3c7a4,
         groundRoughness: 0.72,
@@ -98,8 +153,9 @@ const PRESET_SCENE_EXTRAS = {
     },
     "flow-horizon": {
         ground: true,
+        groundMode: "infinite",
         grid: true,
-        axes: true,
+        axes: false,
         origin: false,
         groundColor: 0x1c212f,
         groundRoughness: 0.82,
@@ -111,9 +167,10 @@ const PRESET_SCENE_EXTRAS = {
     },
     "biophilic-soft": {
         ground: true,
+        groundMode: "infinite",
         grid: true,
-        axes: true,
-        origin: true,
+        axes: false,
+        origin: false,
         groundColor: 0xcad8c9,
         groundRoughness: 0.78,
         groundMetalness: 0.02,
@@ -124,6 +181,8 @@ const PRESET_SCENE_EXTRAS = {
 };
 const PRESET_SKY_OVERRIDES = {
     architectural: { mode: "gradient" },
+    "monochrome-clay": { mode: "gradient" },
+    "outline-monochrome": { mode: "gradient" },
     studio: { mode: "gradient" },
     daylight: { mode: "gradient" },
     "gallery-spot": { mode: "gradient" },
@@ -139,7 +198,9 @@ const DEFAULT_INTERIOR_LIGHTS = [
     { position: [-4, 2.5, -4], intensity: 0.55, distance: 25, color: COOL_WHITE },
 ];
 const PRESET_MATERIAL_OVERRIDES = {
-    architectural: BASELINE_MATERIAL_PRESET_ID,
+    architectural: ARCHITECTURAL_WHITE_MATERIAL_PRESET_ID,
+    "monochrome-clay": MONOCHROME_CLAY_MATERIAL_PRESET_ID,
+    "outline-monochrome": MONOCHROME_CLAY_MATERIAL_PRESET_ID,
     studio: "studio",
     daylight: "daylight",
     "gallery-spot": "gallery-spot",
@@ -152,18 +213,51 @@ const LIGHTING_PRESET_DATA = {
     architectural: {
         id: "architectural",
         label: "architectural white",
-        description: "bright diffuse envelope with matte walls and calibrated AO",
-        includeInteriorLights: true,
+        description: "neutral off-axis daylight with balanced fill, no cast shadows, and controlled AO for clean architectural reading",
+        includeInteriorLights: false,
         config: {
             background: 0xffffff,
-            ambient: { color: 0xf5fbff, intensity: 1.0 },
-            hemisphere: { sky: 0xf8fbff, ground: 0xf1f4f8, intensity: 1.3 },
-            key: { color: 0xf8fcff, intensity: 2.0, position: [10, 15, 5] },
-            fill: { color: 0xeaf2ff, intensity: 0.85, position: [-10, 10, -5] },
-            shadows: true,
-            shadow: { cameraSize: 28, near: 0.5, far: 80, bias: -0.00008, radius: 2.5 },
-            ao: { enabled: true, intensity: 2.5, radius: 4.0, distanceFalloff: 1.0, halfRes: false },
-            toneMappingExposure: 1.05,
+            ambient: { color: 0xfffcf6, intensity: 0.9 },
+            hemisphere: { sky: 0xf4f7fb, ground: 0xd4d0c8, intensity: 0.75 },
+            key: { color: 0xfff7ed, intensity: 1.55, position: [18, 24, 16] },
+            fill: { color: 0xdcecff, intensity: 0.65, position: [-10, 10, -8] },
+            shadows: false,
+            ao: { enabled: true, intensity: 1.25, radius: 1.6, distanceFalloff: 0.85, halfRes: false },
+            toneMappingExposure: 1.03,
+        },
+    },
+    "monochrome-clay": {
+        id: "monochrome-clay",
+        label: "monochrome clay",
+        description: "stable Rhino-style clay/white model view with soft AO, finite ground, and no outline overlay",
+        includeInteriorLights: false,
+        config: {
+            background: 0xf7f6f1,
+            ambient: { color: 0xffffff, intensity: 0.95 },
+            hemisphere: { sky: 0xf7f8fb, ground: 0xdedbd2, intensity: 0.82 },
+            key: { color: 0xfffbf2, intensity: 1.35, position: [16, 22, 14] },
+            fill: { color: 0xe7f0ff, intensity: 0.55, position: [-10, 8, -8] },
+            shadows: false,
+            shadow: { autoFit: true, cameraSize: 28, near: 0.2, far: 120, bias: -0.00008, normalBias: 0.035, radius: 2.5, mapSize: 1024 },
+            ao: { enabled: true, intensity: 1.35, radius: 1.35, distanceFalloff: 0.9, halfRes: false },
+            toneMappingExposure: 1.0,
+        },
+    },
+    "outline-monochrome": {
+        id: "outline-monochrome",
+        label: "outline monochrome",
+        description: "monochrome model inspection view with edge overlay for reading segmented meshes and apertures",
+        includeInteriorLights: false,
+        config: {
+            background: 0xf8f7f2,
+            ambient: { color: 0xffffff, intensity: 0.98 },
+            hemisphere: { sky: 0xf8f9fb, ground: 0xdedbd2, intensity: 0.86 },
+            key: { color: 0xfffbf2, intensity: 1.32, position: [16, 22, 14] },
+            fill: { color: 0xe7f0ff, intensity: 0.56, position: [-10, 8, -8] },
+            shadows: false,
+            shadow: { autoFit: true, cameraSize: 28, near: 0.2, far: 120, bias: -0.00008, normalBias: 0.035, radius: 2.5, mapSize: 1024 },
+            ao: { enabled: true, intensity: 1.25, radius: 1.2, distanceFalloff: 0.9, halfRes: false },
+            toneMappingExposure: 1.0,
         },
     },
     studio: {
@@ -178,7 +272,7 @@ const LIGHTING_PRESET_DATA = {
             key: { color: 0xffffff, intensity: 1.8, position: [12, 14, 8] },
             fill: { color: 0xffffff, intensity: 0.9, position: [-8, 6, -6] },
             shadows: true,
-            shadow: { cameraSize: 24, near: 0.4, far: 70, bias: -0.00006, radius: 2 },
+            shadow: { autoFit: true, cameraSize: 24, near: 0.4, far: 70, bias: -0.00006, normalBias: 0.035, radius: 2 },
             ao: { enabled: true, intensity: 3.0, radius: 3.0, distanceFalloff: 1.2, halfRes: false },
             toneMappingExposure: 1.1,
         },
@@ -195,7 +289,7 @@ const LIGHTING_PRESET_DATA = {
             key: { color: 0xfff5e1, intensity: 2.0, position: [20, 30, 15] },
             fill: { color: 0xadd8e6, intensity: 0.3, position: [-5, 5, -10] },
             shadows: true,
-            shadow: { cameraSize: 32, near: 0.5, far: 90, bias: -0.00008, radius: 2.8 },
+            shadow: { autoFit: true, cameraSize: 32, near: 0.5, far: 90, bias: -0.00008, normalBias: 0.04, radius: 2.8 },
             ao: { enabled: true, intensity: 1.8, radius: 3.5, distanceFalloff: 1.0, halfRes: true },
             toneMappingExposure: 1.2,
         },
@@ -212,7 +306,7 @@ const LIGHTING_PRESET_DATA = {
             key: { color: 0xfff1d6, intensity: 2.6, position: [6, 7, 2] },
             fill: { color: 0x4f5a6a, intensity: 0.9, position: [-4, 5, -3] },
             shadows: true,
-            shadow: { cameraSize: 18, near: 0.3, far: 45, bias: -0.00002, radius: 1.5 },
+            shadow: { autoFit: true, cameraSize: 18, near: 0.3, far: 45, bias: -0.00002, normalBias: 0.025, radius: 1.5 },
             ao: { enabled: true, intensity: 3.2, radius: 3.2, distanceFalloff: 1.4, halfRes: false },
             toneMappingExposure: 1.15,
         },
@@ -229,7 +323,7 @@ const LIGHTING_PRESET_DATA = {
             key: { color: 0xf8fbff, intensity: 1.2, position: [8, 6, 4] },
             fill: { color: 0xebeff5, intensity: 0.9, position: [-6, 5, -4] },
             shadows: false,
-            shadow: { cameraSize: 24, near: 0.5, far: 60, bias: -0.00005, radius: 2 },
+            shadow: { autoFit: true, cameraSize: 24, near: 0.5, far: 60, bias: -0.00005, normalBias: 0.035, radius: 2 },
             ao: { enabled: true, intensity: 1.2, radius: 2.5, distanceFalloff: 0.9, halfRes: true },
             toneMappingExposure: 0.95,
         },
@@ -246,7 +340,7 @@ const LIGHTING_PRESET_DATA = {
             key: { color: 0xfff1cc, intensity: 2.4, position: [0, 18, 0] },
             fill: { color: 0xd6e4f7, intensity: 0.6, position: [-10, 8, -5] },
             shadows: true,
-            shadow: { cameraSize: 26, near: 0.4, far: 75, bias: -0.00004, radius: 2.3 },
+            shadow: { autoFit: true, cameraSize: 26, near: 0.4, far: 75, bias: -0.00004, normalBias: 0.035, radius: 2.3 },
             ao: { enabled: true, intensity: 2.2, radius: 3.8, distanceFalloff: 1.1, halfRes: false },
             toneMappingExposure: 1.08,
         },
@@ -263,7 +357,7 @@ const LIGHTING_PRESET_DATA = {
             key: { color: 0xffcba8, intensity: 2.2, position: [15, 6, -4] },
             fill: { color: 0x93b6ff, intensity: 0.7, position: [-10, 4, 6] },
             shadows: true,
-            shadow: { cameraSize: 18, near: 0.3, far: 45, bias: -0.00002, radius: 1.4 },
+            shadow: { autoFit: true, cameraSize: 18, near: 0.3, far: 45, bias: -0.00002, normalBias: 0.03, radius: 1.4 },
             ao: { enabled: true, intensity: 2.6, radius: 3.0, distanceFalloff: 1.3, halfRes: false },
             toneMappingExposure: 1.05,
         },
@@ -280,7 +374,7 @@ const LIGHTING_PRESET_DATA = {
             key: { color: 0xffefd6, intensity: 1.9, position: [8, 9, 5] },
             fill: { color: 0xb7d7ff, intensity: 0.7, position: [-6, 6, -4] },
             shadows: true,
-            shadow: { cameraSize: 24, near: 0.4, far: 65, bias: -0.00005, radius: 2.2 },
+            shadow: { autoFit: true, cameraSize: 24, near: 0.4, far: 65, bias: -0.00005, normalBias: 0.035, radius: 2.2 },
             ao: { enabled: true, intensity: 2.1, radius: 3.5, distanceFalloff: 1.05, halfRes: false },
             toneMappingExposure: 1.03,
         },
@@ -291,11 +385,31 @@ const ENVIRONMENT_PRESET_DATA = {
         id: "architectural",
         label: "architectural horizon",
         topColor: 0xffffff,
-        horizonColor: 0xd8d8d8,
-        sunPosition: [0.3, 0.8, 0.4],
-        sunIntensity: 0.15,
+        horizonColor: 0xe5e1d8,
+        sunPosition: [0.35, 0.82, 0.35],
+        sunIntensity: 0.12,
         sunSize: 0.08,
-        groundColor: 0xf5f5f5,
+        groundColor: 0xf2f1ec,
+    },
+    "monochrome-clay": {
+        id: "monochrome-clay",
+        label: "monochrome horizon",
+        topColor: 0xffffff,
+        horizonColor: 0xe9e6de,
+        sunPosition: [0.34, 0.82, 0.34],
+        sunIntensity: 0.1,
+        sunSize: 0.07,
+        groundColor: 0xefeee8,
+    },
+    "outline-monochrome": {
+        id: "outline-monochrome",
+        label: "outline horizon",
+        topColor: 0xffffff,
+        horizonColor: 0xe9e6de,
+        sunPosition: [0.34, 0.82, 0.34],
+        sunIntensity: 0.1,
+        sunSize: 0.07,
+        groundColor: 0xf3f2ed,
     },
     studio: {
         id: "studio",
@@ -407,12 +521,14 @@ const buildLightingRig = (preset) => ({
         color: colorToHex(preset.config.key.color),
         intensity: preset.config.key.intensity,
         position: preset.config.key.position,
+        positionMode: "target-offset",
         castShadow: preset.config.shadows,
     },
     fill: {
         color: colorToHex(preset.config.fill.color),
         intensity: preset.config.fill.intensity,
         position: preset.config.fill.position,
+        positionMode: "target-offset",
     },
     shadow: preset.config.shadow,
 });
@@ -421,6 +537,7 @@ const buildRendererConfig = (preset) => ({
     toneMappingExposure: preset.config.toneMappingExposure,
     outputColorSpace: "srgb",
     maxPixelRatio: 1.75,
+    powerPreference: "high-performance",
     antialias: true,
     shadowMap: {
         enabled: preset.config.shadows,
@@ -468,7 +585,7 @@ export function buildViewerPresets() {
                     color: colorToHex(light.color ?? 0xffffff),
                 }))
                 : undefined,
-            materialsPresetId: PRESET_MATERIAL_OVERRIDES[id] ?? BASELINE_MATERIAL_PRESET_ID,
+            materialsPresetId: PRESET_MATERIAL_OVERRIDES[id] ?? ARCHITECTURAL_WHITE_MATERIAL_PRESET_ID,
         };
     });
     return presets;

package/dist/scene.d.ts

@@ -1,31 +1,55 @@
 import * as THREE from "three";
-import type { ViewerHandle } from "./engine/types";
+import type { CameraKind, ViewerHandle } from "./engine/types";
 import type { CameraFrameConfig, CameraNormalizationConfig, CameraNormalizationResult } from "./camera";
-import type { MaterialsConfig } from "./materials/types";
+import type { MaterialApplicationPolicy, MaterialsConfig } from "./materials/types";
 export type CameraRigConfig = CameraFrameConfig & CameraNormalizationConfig;
 export declare const DEFAULT_CAMERA_RIG: CameraRigConfig;
 export type SceneStats = {
     meshCount: number;
     vertexCount: number;
     triangleCount: number;
+    shadowCastingMeshCount: number;
+    shadowReceivingMeshCount: number;
     size: {
         x: number;
         y: number;
         z: number;
     };
 };
+export type SceneClippingConfig = {
+    nearSafety?: number;
+    farSafety?: number;
+    minimumFar?: number;
+};
+export type ScenePresentationPolicy = {
+    kind?: "object3d" | "plan2d";
+    cameraKind?: CameraKind;
+    clipping?: SceneClippingConfig;
+};
+export declare const resolveSceneUnitScale: (units?: string | null) => number;
+export declare const applyUnitScaleToGroup: (group?: THREE.Group | null, units?: string | null) => number;
 export declare function computeSceneStats(root?: THREE.Object3D | null): SceneStats;
-export declare const setCameraToBounds: (handle: ViewerHandle, bounds: THREE.Box3, config?: CameraFrameConfig) => void;
-export declare const setCameraTopDown: (handle: ViewerHandle, bounds: THREE.Box3) => void;
+export declare const setCameraToBounds: (handle: ViewerHandle, bounds: THREE.Box3, config?: CameraFrameConfig, options?: {
+    kind?: CameraKind;
+    clipping?: SceneClippingConfig;
+}) => void;
+export declare const setCameraTopDown: (handle: ViewerHandle, bounds: THREE.Box3, options?: {
+    kind?: CameraKind;
+    clipping?: SceneClippingConfig;
+}) => void;
 export type ApplyGroupToViewerOptions = {
     viewer?: ViewerHandle | null;
     group: THREE.Group;
     cameraRig?: CameraRigConfig;
+    preserveSceneAnchor?: boolean;
     viewMode?: "2d" | "3d" | "auto";
     frameConfig?: CameraFrameConfig;
+    presentation?: ScenePresentationPolicy;
     materialsConfig?: MaterialsConfig | null;
+    materialsPolicy?: MaterialApplicationPolicy;
     floorLevel?: number;
     ceilingHeight?: number;
+    preserveCamera?: boolean;
 };
 export type ApplyGroupToViewerResult = {
     bounds: THREE.Box3;

package/dist/scene.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scene.d.ts","sourceRoot":"","sources":["../src/scene.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAExG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGzD,MAAM,MAAM,eAAe,GAAG,iBAAiB,GAAG,yBAAyB,CAAC;AAE5E,eAAO,MAAM,kBAAkB,EAAE,eAMhC,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3C,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,QAAQ,GAAG,IAAI,GAAG,UAAU,CA0C1E;AAED,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,YAAY,EACpB,QAAQ,KAAK,CAAC,IAAI,EAClB,SAAS,iBAAiB,SA0B3B,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,QAAQ,YAAY,EAAE,QAAQ,KAAK,CAAC,IAAI,SA0BxE,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7B,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC;IACnB,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,QAAQ,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;IAChC,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,eAAe,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC;IACnB,KAAK,EAAE,UAAU,CAAC;IAClB,aAAa,EAAE,yBAAyB,CAAC;IACzC,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1E,eAAO,MAAM,kBAAkB,GAAI,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,WAcrE,CAAC;AAyEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAI,QAAQ,KAAK,CAAC,KAAK,GAAG,IAAI,EAAE,UAAS,qBAA0B,SAYnG,CAAC;AAEF,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,yBAAyB,GACjC,wBAAwB,GAAG,IAAI,CA2CjC"}
+{"version":3,"file":"scene.d.ts","sourceRoot":"","sources":["../src/scene.ts"],"names":[],"mappings":"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"}