@base2datadesign/viewer-kit 0.1.3 → 0.2.0

package/dist/presets/sciencePresets.js

@@ -0,0 +1,473 @@
+import { BASELINE_MATERIAL_PRESET_ID } from "../materials/presets";
+const DEFAULT_LIGHTING_PRESET_ID = "architectural";
+const DEFAULT_ENVIRONMENT_PRESET_ID = "architectural";
+const DEFAULT_SCENE_EXTRAS = {
+    ground: true,
+    grid: true,
+    axes: true,
+    origin: true,
+    gridOpacity: 0.12,
+    gridDivisions: 80,
+    gridSize: 80,
+    groundRoughness: 0.8,
+    groundMetalness: 0.05,
+    lightTarget: [0, 1.5, 0],
+    originHighlight: true,
+    originLineColor: 0x94a3b8,
+    originLineLength: 40,
+    originLineThickness: 0.06,
+    axisLabelScale: 0.35,
+    axesLabels: {
+        lowerCase: true,
+        upperCase: true,
+        offset: 0.4,
+        secondaryOffset: 0.5,
+    },
+};
+const PRESET_SCENE_EXTRAS = {
+    architectural: {
+        ground: true,
+        grid: true,
+        axes: true,
+        origin: true,
+        groundColor: 0xf5f5f5,
+        groundRoughness: 0.75,
+        groundMetalness: 0.0,
+        gridColor: 0xdedede,
+        gridColorSecondary: 0xeaeaea,
+        gridOpacity: 0.12,
+        gridDivisions: 100,
+        gridSize: 100,
+        gridHeightOffset: 0.09,
+    },
+    studio: {
+        ground: true,
+        grid: true,
+        axes: true,
+        origin: false,
+        groundColor: 0x1f2024,
+        groundRoughness: 0.9,
+        groundMetalness: 0.08,
+        gridColor: 0x353840,
+        gridOpacity: 0.12,
+    },
+    daylight: {
+        ground: true,
+        grid: true,
+        axes: true,
+        origin: true,
+        groundColor: 0xe2d5c2,
+        groundRoughness: 0.7,
+        groundMetalness: 0.04,
+        gridColor: 0xf6ead7,
+        gridOpacity: 0.2,
+    },
+    "gallery-spot": {
+        ground: true,
+        grid: true,
+        axes: true,
+        origin: false,
+        groundColor: 0x131419,
+        groundRoughness: 0.85,
+        groundMetalness: 0.02,
+        gridColor: 0x2c3242,
+        gridOpacity: 0.1,
+        lightTarget: [0, 1.2, 0],
+    },
+    "lab-neutral": {
+        ground: true,
+        grid: true,
+        axes: true,
+        origin: true,
+        groundColor: 0xf4f5f7,
+        groundRoughness: 0.78,
+        groundMetalness: 0.03,
+        gridColor: 0xd0d6de,
+        gridOpacity: 0.16,
+    },
+    "atrium-suntrack": {
+        ground: true,
+        grid: true,
+        axes: true,
+        origin: false,
+        groundColor: 0xe3c7a4,
+        groundRoughness: 0.72,
+        groundMetalness: 0.05,
+        gridColor: 0xf4dfc2,
+        gridOpacity: 0.18,
+    },
+    "flow-horizon": {
+        ground: true,
+        grid: true,
+        axes: true,
+        origin: false,
+        groundColor: 0x1c212f,
+        groundRoughness: 0.82,
+        groundMetalness: 0.03,
+        gridColor: 0xffa66a,
+        gridOpacity: 0.22,
+        gridDivisions: 120,
+        gridSize: 200,
+    },
+    "biophilic-soft": {
+        ground: true,
+        grid: true,
+        axes: true,
+        origin: true,
+        groundColor: 0xcad8c9,
+        groundRoughness: 0.78,
+        groundMetalness: 0.02,
+        gridColor: 0xe2efe0,
+        gridOpacity: 0.18,
+        lightTarget: [0, 1.6, 0],
+    },
+};
+const PRESET_SKY_OVERRIDES = {
+    architectural: { mode: "gradient" },
+    studio: { mode: "gradient" },
+    daylight: { mode: "gradient" },
+    "gallery-spot": { mode: "gradient" },
+    "lab-neutral": { mode: "gradient" },
+    "atrium-suntrack": { mode: "gradient" },
+    "flow-horizon": { mode: "gradient" },
+    "biophilic-soft": { mode: "gradient" },
+};
+const COOL_WHITE = 0xf6fbff;
+const DEFAULT_INTERIOR_LIGHTS = [
+    { position: [0, 2.5, 0], intensity: 1.15, distance: 40, color: COOL_WHITE },
+    { position: [4, 2.5, 4], intensity: 0.55, distance: 25, color: COOL_WHITE },
+    { position: [-4, 2.5, -4], intensity: 0.55, distance: 25, color: COOL_WHITE },
+];
+const PRESET_MATERIAL_OVERRIDES = {
+    architectural: BASELINE_MATERIAL_PRESET_ID,
+    studio: "studio",
+    daylight: "daylight",
+    "gallery-spot": "gallery-spot",
+    "lab-neutral": "lab-neutral",
+    "atrium-suntrack": "atrium-suntrack",
+    "flow-horizon": "flow-horizon",
+    "biophilic-soft": "biophilic-soft",
+};
+const LIGHTING_PRESET_DATA = {
+    architectural: {
+        id: "architectural",
+        label: "architectural white",
+        description: "bright diffuse envelope with matte walls and calibrated AO",
+        includeInteriorLights: true,
+        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,
+        },
+    },
+    studio: {
+        id: "studio",
+        label: "studio lighting",
+        description: "three-point rig with dramatic contrast and deep background",
+        includeInteriorLights: false,
+        config: {
+            background: 0x1a1a1a,
+            ambient: { color: 0xffffff, intensity: 0.6 },
+            hemisphere: { sky: 0xffffff, ground: 0x1a1a1a, intensity: 0.6 },
+            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 },
+            ao: { enabled: true, intensity: 3.0, radius: 3.0, distanceFalloff: 1.2, halfRes: false },
+            toneMappingExposure: 1.1,
+        },
+    },
+    daylight: {
+        id: "daylight",
+        label: "natural daylight",
+        description: "outdoor sun and sky gradient for aperture studies",
+        includeInteriorLights: false,
+        config: {
+            background: 0x87ceeb,
+            ambient: { color: 0xffffff, intensity: 0.8 },
+            hemisphere: { sky: 0x87ceeb, ground: 0x8b7355, intensity: 1.0 },
+            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 },
+            ao: { enabled: true, intensity: 1.8, radius: 3.5, distanceFalloff: 1.0, halfRes: true },
+            toneMappingExposure: 1.2,
+        },
+    },
+    "gallery-spot": {
+        id: "gallery-spot",
+        label: "gallery spot",
+        description: "high contrast exhibit lighting with focused key beams",
+        includeInteriorLights: false,
+        config: {
+            background: 0x101012,
+            ambient: { color: 0x262626, intensity: 0.4 },
+            hemisphere: { sky: 0x2d2f38, ground: 0x131315, intensity: 0.5 },
+            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 },
+            ao: { enabled: true, intensity: 3.2, radius: 3.2, distanceFalloff: 1.4, halfRes: false },
+            toneMappingExposure: 1.15,
+        },
+    },
+    "lab-neutral": {
+        id: "lab-neutral",
+        label: "lab neutral",
+        description: "low contrast neutral lab benchmark for sensory baselines",
+        includeInteriorLights: false,
+        config: {
+            background: 0xf5f6f8,
+            ambient: { color: 0xffffff, intensity: 1.1 },
+            hemisphere: { sky: 0xf0f4f9, ground: 0xdfe2e6, intensity: 1.0 },
+            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 },
+            ao: { enabled: true, intensity: 1.2, radius: 2.5, distanceFalloff: 0.9, halfRes: true },
+            toneMappingExposure: 0.95,
+        },
+    },
+    "atrium-suntrack": {
+        id: "atrium-suntrack",
+        label: "atrium suntrack",
+        description: "zenith-focused atrium lighting with animated sun sweep",
+        includeInteriorLights: true,
+        config: {
+            background: 0xfdfcf8,
+            ambient: { color: 0xfff8ef, intensity: 0.9 },
+            hemisphere: { sky: 0xfff4d6, ground: 0xf3f0e6, intensity: 0.85 },
+            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 },
+            ao: { enabled: true, intensity: 2.2, radius: 3.8, distanceFalloff: 1.1, halfRes: false },
+            toneMappingExposure: 1.08,
+        },
+    },
+    "flow-horizon": {
+        id: "flow-horizon",
+        label: "flow horizon",
+        description: "warm optic-flow horizon line for evening sequences",
+        includeInteriorLights: false,
+        config: {
+            background: 0x1a1f28,
+            ambient: { color: 0x3a3d44, intensity: 0.5 },
+            hemisphere: { sky: 0x2a3342, ground: 0x14181f, intensity: 0.6 },
+            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 },
+            ao: { enabled: true, intensity: 2.6, radius: 3.0, distanceFalloff: 1.3, halfRes: false },
+            toneMappingExposure: 1.05,
+        },
+    },
+    "biophilic-soft": {
+        id: "biophilic-soft",
+        label: "biophilic soft",
+        description: "diffuse daylight with green bounce for recovery zones",
+        includeInteriorLights: true,
+        config: {
+            background: 0xeaf3ec,
+            ambient: { color: 0xf7fff2, intensity: 1.05 },
+            hemisphere: { sky: 0xe1f1e4, ground: 0xcad7c4, intensity: 0.9 },
+            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 },
+            ao: { enabled: true, intensity: 2.1, radius: 3.5, distanceFalloff: 1.05, halfRes: false },
+            toneMappingExposure: 1.03,
+        },
+    },
+};
+const ENVIRONMENT_PRESET_DATA = {
+    architectural: {
+        id: "architectural",
+        label: "architectural horizon",
+        topColor: 0xffffff,
+        horizonColor: 0xd8d8d8,
+        sunPosition: [0.3, 0.8, 0.4],
+        sunIntensity: 0.15,
+        sunSize: 0.08,
+        groundColor: 0xf5f5f5,
+    },
+    studio: {
+        id: "studio",
+        label: "studio dusk",
+        topColor: 0x111218,
+        horizonColor: 0x050608,
+        sunPosition: [0.2, 0.7, 0.4],
+        sunIntensity: 0.12,
+        sunSize: 0.05,
+        groundColor: 0x1a1a1d,
+    },
+    daylight: {
+        id: "daylight",
+        label: "daylight gradient",
+        topColor: 0xcfe7ff,
+        horizonColor: 0xf5d7ae,
+        sunPosition: [0.4, 0.85, 0.25],
+        sunIntensity: 0.22,
+        sunSize: 0.07,
+        groundColor: 0xe8ded0,
+    },
+    "gallery-spot": {
+        id: "gallery-spot",
+        label: "gallery noir",
+        topColor: 0x1b1d24,
+        horizonColor: 0x0c0d10,
+        sunPosition: [0.25, 0.75, 0.1],
+        sunIntensity: 0.14,
+        sunSize: 0.04,
+        groundColor: 0x0b0d12,
+    },
+    "lab-neutral": {
+        id: "lab-neutral",
+        label: "lab overcast",
+        topColor: 0xf0f2f5,
+        horizonColor: 0xe4e7eb,
+        sunPosition: [0.3, 0.8, 0.3],
+        sunIntensity: 0.16,
+        sunSize: 0.06,
+        groundColor: 0xf5f6f8,
+    },
+    "atrium-suntrack": {
+        id: "atrium-suntrack",
+        label: "atrium sun bloom",
+        topColor: 0xfff4d6,
+        horizonColor: 0xffd9a6,
+        sunPosition: [0.05, 0.95, 0.05],
+        sunIntensity: 0.28,
+        sunSize: 0.09,
+        groundColor: 0xe4c7a1,
+    },
+    "flow-horizon": {
+        id: "flow-horizon",
+        label: "flow horizon",
+        topColor: 0x0f1a2c,
+        horizonColor: 0xff8c4c,
+        sunPosition: [0.25, 0.6, -0.15],
+        sunIntensity: 0.32,
+        sunSize: 0.08,
+        groundColor: 0x0b0f19,
+    },
+    "biophilic-soft": {
+        id: "biophilic-soft",
+        label: "biophilic haze",
+        topColor: 0xdceedf,
+        horizonColor: 0xb6d3cc,
+        sunPosition: [0.3, 0.75, 0.2],
+        sunIntensity: 0.2,
+        sunSize: 0.07,
+        groundColor: 0xcadccf,
+    },
+};
+const colorToHex = (value) => `#${value.toString(16).padStart(6, "0")}`;
+const buildSky = (environment, override) => {
+    if (override?.mode === "hdr" && "hdr" in override) {
+        return { mode: "hdr", hdr: override.hdr };
+    }
+    if (override?.mode === "cube" && "cube" in override) {
+        return { mode: "cube", cube: override.cube };
+    }
+    return {
+        mode: "gradient",
+        gradient: {
+            topColor: colorToHex(environment.topColor),
+            horizonColor: colorToHex(environment.horizonColor),
+            sunPosition: environment.sunPosition,
+            sunIntensity: environment.sunIntensity,
+            sunSize: environment.sunSize,
+        },
+    };
+};
+const buildLightingRig = (preset) => ({
+    rig: preset.id === "studio"
+        ? "studio"
+        : preset.id === "gallery-spot"
+            ? "gallery"
+            : preset.id === "lab-neutral"
+                ? "neutral"
+                : undefined,
+    ambient: { color: colorToHex(preset.config.ambient.color), intensity: preset.config.ambient.intensity },
+    hemisphere: preset.config.hemisphere
+        ? {
+            skyColor: colorToHex(preset.config.hemisphere.sky),
+            groundColor: colorToHex(preset.config.hemisphere.ground),
+            intensity: preset.config.hemisphere.intensity,
+        }
+        : undefined,
+    key: {
+        color: colorToHex(preset.config.key.color),
+        intensity: preset.config.key.intensity,
+        position: preset.config.key.position,
+        castShadow: preset.config.shadows,
+    },
+    fill: {
+        color: colorToHex(preset.config.fill.color),
+        intensity: preset.config.fill.intensity,
+        position: preset.config.fill.position,
+    },
+    shadow: preset.config.shadow,
+});
+const buildRendererConfig = (preset) => ({
+    toneMapping: "neutral",
+    toneMappingExposure: preset.config.toneMappingExposure,
+    outputColorSpace: "srgb",
+    antialias: true,
+    shadowMap: {
+        enabled: preset.config.shadows,
+        type: "pcfsoft",
+    },
+});
+const buildPostFxConfig = (preset) => ({
+    ao: preset.config.ao
+        ? {
+            enabled: preset.config.ao.enabled,
+            intensity: preset.config.ao.intensity,
+            radius: preset.config.ao.radius,
+            distanceFalloff: preset.config.ao.distanceFalloff,
+            halfRes: preset.config.ao.halfRes,
+        }
+        : { enabled: false },
+});
+export const SCIENCE_PRESET_SUMMARIES = Object.fromEntries(Object.entries(LIGHTING_PRESET_DATA).map(([id, preset]) => [id, preset.description]));
+export const SCIENCE_DEFAULT_PRESET_ID = DEFAULT_LIGHTING_PRESET_ID;
+export function buildViewerPresets() {
+    const presets = {};
+    Object.entries(LIGHTING_PRESET_DATA).forEach(([id, lighting]) => {
+        const environment = ENVIRONMENT_PRESET_DATA[id] ?? ENVIRONMENT_PRESET_DATA[DEFAULT_ENVIRONMENT_PRESET_ID];
+        const sceneExtrasSource = PRESET_SCENE_EXTRAS[id] ?? DEFAULT_SCENE_EXTRAS;
+        const sceneExtras = { ...DEFAULT_SCENE_EXTRAS, ...sceneExtrasSource };
+        const includeInteriorLights = lighting.includeInteriorLights !== false;
+        const skyOverride = PRESET_SKY_OVERRIDES[id];
+        presets[id] = {
+            id,
+            label: lighting.label,
+            renderer: buildRendererConfig(lighting),
+            sky: buildSky(environment, skyOverride),
+            lighting: buildLightingRig(lighting),
+            postfx: buildPostFxConfig(lighting),
+            sceneExtras,
+            interiorLights: includeInteriorLights
+                ? DEFAULT_INTERIOR_LIGHTS.map((light) => ({
+                    position: light.position,
+                    intensity: light.intensity,
+                    distance: light.distance,
+                    color: colorToHex(light.color ?? 0xffffff),
+                }))
+                : undefined,
+            materialsPresetId: PRESET_MATERIAL_OVERRIDES[id] ?? BASELINE_MATERIAL_PRESET_ID,
+        };
+    });
+    return presets;
+}
+// Legacy alias kept for existing consumers; use buildViewerPresets instead.
+export const buildSciencePresets = buildViewerPresets;
+export const SCIENCE_PRESETS = buildViewerPresets();

package/dist/sky/scienceSky.d.ts

@@ -0,0 +1,10 @@
+import type { RenderPresetDefinition } from "../engine/types";
+export type ScienceSkyOption = {
+    id: string;
+    label: string;
+    description?: string;
+    sky?: RenderPresetDefinition["sky"];
+};
+export declare function listScienceSkyOptions(): ScienceSkyOption[];
+export declare function getScienceSkyOption(id: string): ScienceSkyOption | undefined;
+//# sourceMappingURL=scienceSky.d.ts.map

package/dist/sky/scienceSky.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scienceSky.d.ts","sourceRoot":"","sources":["../../src/sky/scienceSky.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAE9D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,sBAAsB,CAAC,KAAK,CAAC,CAAC;CACrC,CAAC;AAkEF,wBAAgB,qBAAqB,IAAI,gBAAgB,EAAE,CAE1D;AAED,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAE5E"}

package/dist/sky/scienceSky.js

@@ -0,0 +1,68 @@
+const HDR_BASE = "https://assets.treasury.space/science/hdr/shared";
+const SCIENCE_SKY_OPTIONS = [
+    {
+        id: "preset",
+        label: "Preset Dome",
+        description: "Use the sky gradient defined by the active render preset.",
+    },
+    {
+        id: "canary-wharf",
+        label: "Canary Wharf",
+        description: "Golden-hour skyline reflections",
+        sky: {
+            mode: "hdr",
+            hdr: { src: `${HDR_BASE}/canary_wharf_4k.hdr`, exposure: 1.1 },
+        },
+    },
+    {
+        id: "kloofendal",
+        label: "Kloofendal Sky",
+        description: "Bright partly cloudy daylight",
+        sky: {
+            mode: "hdr",
+            hdr: { src: `${HDR_BASE}/kloofendal_48d_partly_cloudy_puresky_4k.hdr`, exposure: 1.0 },
+        },
+    },
+    {
+        id: "venetian-crossroads",
+        label: "Venetian Crossroads",
+        description: "Cool overcast reflections",
+        sky: {
+            mode: "hdr",
+            hdr: { src: `${HDR_BASE}/venetian_crossroads_4k.hdr`, exposure: 1.05 },
+        },
+    },
+    {
+        id: "rural-road",
+        label: "Rural Evening",
+        description: "Warm sunset horizon",
+        sky: {
+            mode: "hdr",
+            hdr: { src: `${HDR_BASE}/rural_evening_road_4k.hdr`, exposure: 1.2 },
+        },
+    },
+    {
+        id: "spruit-sunrise",
+        label: "Spruit Sunrise",
+        description: "Soft morning bounce",
+        sky: {
+            mode: "hdr",
+            hdr: { src: `${HDR_BASE}/spruit_sunrise_4k.hdr`, exposure: 1.08 },
+        },
+    },
+    {
+        id: "dikhololo-night",
+        label: "Dikhololo Night",
+        description: "Night sky with subtle fill",
+        sky: {
+            mode: "hdr",
+            hdr: { src: `${HDR_BASE}/dikhololo_night_4k.hdr`, exposure: 0.65 },
+        },
+    },
+];
+export function listScienceSkyOptions() {
+    return SCIENCE_SKY_OPTIONS;
+}
+export function getScienceSkyOption(id) {
+    return SCIENCE_SKY_OPTIONS.find((option) => option.id === id);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@base2datadesign/viewer-kit",
-  "version": "0.1.3",
+  "version": "0.2.0",
   "type": "module",
   "license": "UNLICENSED",
   "main": "./dist/index.js",