@base2datadesign/viewer-kit 0.2.0 → 0.2.2

package/dist/systems/debugSystem.js

@@ -2,9 +2,133 @@ import * as THREE from "three";
 const DEFAULT_EXTRAS = {
     grid: true,
     ground: true,
-    axes: false,
+    axes: true,
     origin: true,
 };
+const DEFAULT_GRID_SIZE = 80;
+const DEFAULT_GRID_DIVISIONS = 80;
+const DEFAULT_GRID_OPACITY = 0.15;
+const DEFAULT_GRID_HEIGHT_OFFSET = 0.099;
+const HDR_GROUND_SIZE = 60;
+const AXIS_COLORS = {
+    x: 0xef4444,
+    y: 0x22c55e,
+    z: 0x3b82f6,
+};
+function createCanvasLabel(text, color) {
+    if (typeof document === "undefined")
+        return null;
+    const canvas = document.createElement("canvas");
+    const size = 128;
+    canvas.width = canvas.height = size;
+    const ctx = canvas.getContext("2d");
+    if (!ctx)
+        return null;
+    ctx.clearRect(0, 0, size, size);
+    ctx.font = 'bold 68px "IBM Plex Mono", monospace';
+    ctx.textAlign = "center";
+    ctx.textBaseline = "middle";
+    ctx.fillStyle = new THREE.Color(color).getStyle();
+    ctx.fillText(text, size / 2, size / 2 + 6);
+    const texture = new THREE.CanvasTexture(canvas);
+    texture.generateMipmaps = false;
+    texture.needsUpdate = true;
+    return texture;
+}
+function createAxisLabelSprite(text, color, scale) {
+    const texture = createCanvasLabel(text, color);
+    if (!texture)
+        return null;
+    const material = new THREE.SpriteMaterial({ map: texture, transparent: true, depthTest: false, depthWrite: false });
+    const sprite = new THREE.Sprite(material);
+    sprite.scale.set(scale, scale, scale);
+    sprite.renderOrder = 5;
+    return sprite;
+}
+function buildAxisHelper(extras) {
+    const group = new THREE.Group();
+    const length = 1.8;
+    const coneHeight = 0.25;
+    const coneRadius = 0.07;
+    const labelScale = extras.axisLabelScale ?? 0.35;
+    const labelConfig = extras.axesLabels ?? {};
+    const lowerEnabled = labelConfig.lowerCase !== false;
+    const upperEnabled = labelConfig.upperCase !== false;
+    const lowerOffset = labelConfig.offset ?? 0.35;
+    const upperOffset = lowerOffset + (labelConfig.secondaryOffset ?? 0.2);
+    const rhinoAxisMap = { x: "X", y: "Z", z: "Y" };
+    ["x", "y", "z"].forEach((axis) => {
+        const dir = new THREE.Vector3(axis === "x" ? 1 : 0, axis === "y" ? 1 : 0, axis === "z" ? 1 : 0);
+        const color = AXIS_COLORS[axis];
+        const lineGeometry = new THREE.BufferGeometry().setFromPoints([
+            new THREE.Vector3(0, 0, 0),
+            dir.clone().multiplyScalar(length),
+        ]);
+        const lineMaterial = new THREE.LineBasicMaterial({ color, linewidth: 2 });
+        const line = new THREE.Line(lineGeometry, lineMaterial);
+        group.add(line);
+        const cone = new THREE.Mesh(new THREE.ConeGeometry(coneRadius, coneHeight, 16), new THREE.MeshBasicMaterial({ color }));
+        cone.position.copy(dir.clone().multiplyScalar(length));
+        cone.lookAt(dir.clone().multiplyScalar(length + 0.5));
+        group.add(cone);
+        if (lowerEnabled) {
+            const lowerLabel = createAxisLabelSprite(axis, color, labelScale);
+            if (lowerLabel) {
+                lowerLabel.position.copy(dir.clone().multiplyScalar(length + lowerOffset));
+                group.add(lowerLabel);
+            }
+        }
+        if (upperEnabled) {
+            const rhinoAxis = rhinoAxisMap[axis];
+            const upperLabel = createAxisLabelSprite(rhinoAxis, color, labelScale * 1.1);
+            if (upperLabel) {
+                const offsetDir = dir.clone().multiplyScalar(length + upperOffset);
+                upperLabel.position.copy(offsetDir);
+                group.add(upperLabel);
+            }
+        }
+    });
+    return group;
+}
+function buildOriginCross(extras, gridSize, groundY) {
+    const group = new THREE.Group();
+    const length = extras.originLineLength ?? gridSize / 2;
+    const thickness = extras.originLineThickness ?? 0.06;
+    const color = extras.originLineColor ?? 0x94a3b8;
+    const material = new THREE.MeshBasicMaterial({ color, transparent: true, opacity: 0.9, depthWrite: false });
+    const yPos = groundY + thickness * 0.5;
+    const xLine = new THREE.Mesh(new THREE.BoxGeometry(length * 2, thickness, thickness), material);
+    xLine.position.y = yPos;
+    const zLine = new THREE.Mesh(new THREE.BoxGeometry(thickness, thickness, length * 2), material.clone());
+    zLine.position.y = yPos;
+    group.add(xLine, zLine);
+    const markerCount = 5;
+    const markerThickness = thickness * 0.5;
+    for (let i = 1; i <= markerCount; i += 1) {
+        const offset = i;
+        const tickXPos = offset;
+        const tickZPos = offset;
+        const xTick = new THREE.Mesh(new THREE.BoxGeometry(markerThickness, thickness * 0.75, thickness * 4), material.clone());
+        xTick.position.set(tickXPos, yPos, 0);
+        const xTickNeg = xTick.clone();
+        xTickNeg.position.x = -tickXPos;
+        const zTick = new THREE.Mesh(new THREE.BoxGeometry(thickness * 4, thickness * 0.75, markerThickness), material.clone());
+        zTick.position.set(0, yPos, tickZPos);
+        const zTickNeg = zTick.clone();
+        zTickNeg.position.z = -tickZPos;
+        group.add(xTick, xTickNeg, zTick, zTickNeg);
+    }
+    return group;
+}
+function adjustGridColor(groundHex) {
+    const base = new THREE.Color(groundHex);
+    const hsl = { h: 0, s: 0, l: 0 };
+    base.getHSL(hsl);
+    hsl.l = Math.min(1, hsl.l + 0.15);
+    const adjusted = new THREE.Color();
+    adjusted.setHSL(hsl.h, hsl.s, hsl.l);
+    return adjusted.getHex();
+}
 export class DebugSystem {
     scene;
     objects = [];
@@ -14,13 +138,21 @@ export class DebugSystem {
     apply(preset) {
         const extras = { ...DEFAULT_EXTRAS, ...(preset.sceneExtras ?? {}) };
         this.clear();
-        if (extras.ground) {
-            const size = extras.groundSize ?? 300;
+        const skyMode = preset.sky?.mode ?? "gradient";
+        const isHdr = skyMode === "hdr";
+        const gradientSkyEnabled = !preset.sky?.mode || skyMode === "gradient";
+        const groundEnabled = extras.ground !== false;
+        const gridEnabled = extras.grid !== false && gradientSkyEnabled && !isHdr;
+        const axesEnabled = extras.axes !== false;
+        const originEnabled = extras.origin !== false;
+        const groundColor = extras.groundColor ?? 0x2c2f33;
+        if (groundEnabled) {
+            const size = extras.groundSize ?? (isHdr ? HDR_GROUND_SIZE : 400);
             const groundGeometry = new THREE.PlaneGeometry(size, size);
             const groundMaterial = new THREE.MeshStandardMaterial({
-                color: extras.groundColor ?? 0xf5f5f5,
-                roughness: extras.groundRoughness ?? 0.75,
-                metalness: extras.groundMetalness ?? 0.0,
+                color: groundColor,
+                roughness: extras.groundRoughness ?? (isHdr ? 0.6 : 0.8),
+                metalness: extras.groundMetalness ?? (isHdr ? 0.02 : 0.05),
                 toneMapped: false,
             });
             const ground = new THREE.Mesh(groundGeometry, groundMaterial);
@@ -29,38 +161,35 @@ export class DebugSystem {
             ground.receiveShadow = true;
             this.add(ground);
         }
-        if (extras.grid) {
-            const gridSize = extras.gridSize ?? 100;
-            const divisions = extras.gridDivisions ?? 50;
-            const gridHelper = new THREE.GridHelper(gridSize, divisions, extras.gridColor ?? 0xdedede, extras.gridColorSecondary ?? 0xeaeaea);
-            gridHelper.position.y = extras.gridHeightOffset ?? -0.09;
-            const gridOpacity = extras.gridOpacity;
-            if (typeof gridOpacity === "number") {
-                const material = gridHelper.material;
-                const applyOpacity = (mat) => {
-                    mat.opacity = gridOpacity;
-                    mat.transparent = gridOpacity < 1;
-                };
-                if (Array.isArray(material)) {
-                    material.forEach(applyOpacity);
-                }
-                else if (material) {
-                    applyOpacity(material);
-                }
-            }
-            this.add(gridHelper);
-        }
-        if (extras.axes) {
-            const axes = new THREE.AxesHelper(3);
-            if (extras.axesPosition) {
-                axes.position.set(...extras.axesPosition);
+        let lastGridPositionY = 0;
+        if (gridEnabled) {
+            const gridPrimary = new THREE.Color(extras.gridColor ?? adjustGridColor(groundColor));
+            const gridSecondary = new THREE.Color(extras.gridColorSecondary ?? gridPrimary.getHex());
+            const gridSize = extras.gridSize ?? DEFAULT_GRID_SIZE;
+            const gridDivisions = extras.gridDivisions ?? Math.max(1, gridSize);
+            const grid = new THREE.GridHelper(gridSize, gridDivisions, gridPrimary, gridSecondary);
+            const offset = extras.gridHeightOffset ?? DEFAULT_GRID_HEIGHT_OFFSET;
+            grid.position.y = groundEnabled ? -offset : -offset * 0.9;
+            lastGridPositionY = grid.position.y;
+            const gridMaterial = grid.material;
+            const setTransparency = (mat) => {
+                mat.transparent = true;
+                mat.opacity = extras.gridOpacity ?? DEFAULT_GRID_OPACITY;
+            };
+            if (Array.isArray(gridMaterial)) {
+                gridMaterial.forEach((mat) => setTransparency(mat));
             }
-            else {
-                axes.position.set(-15, 0.1, -15);
+            else if (gridMaterial) {
+                setTransparency(gridMaterial);
             }
-            this.add(axes);
+            this.add(grid);
+        }
+        const originPlaneY = groundEnabled ? -0.11 : lastGridPositionY || -(extras.gridHeightOffset ?? DEFAULT_GRID_HEIGHT_OFFSET);
+        if (extras.originHighlight !== false) {
+            const originCross = buildOriginCross(extras, extras.gridSize ?? DEFAULT_GRID_SIZE, originPlaneY);
+            this.add(originCross);
         }
-        if (extras.origin) {
+        if (originEnabled) {
             const originSize = extras.originSize ?? 0.1;
             const originGeometry = new THREE.SphereGeometry(originSize, 16, 16);
             const originMaterial = new THREE.MeshBasicMaterial({ color: extras.originColor ?? 0x666666 });
@@ -68,6 +197,9 @@ export class DebugSystem {
             origin.position.set(0, 0, 0);
             this.add(origin);
         }
+        if (axesEnabled) {
+            this.add(buildAxisHelper(extras));
+        }
     }
     dispose() {
         this.clear();
@@ -89,6 +221,27 @@ export class DebugSystem {
                 else {
                     material.dispose?.();
                 }
+                return;
+            }
+            if (object instanceof THREE.Line) {
+                object.geometry.dispose();
+                const material = object.material;
+                if (Array.isArray(material)) {
+                    material.forEach((mat) => mat.dispose?.());
+                }
+                else {
+                    material?.dispose?.();
+                }
+                return;
+            }
+            if (object instanceof THREE.Sprite) {
+                const material = object.material;
+                if (material) {
+                    if (material.map) {
+                        material.map.dispose?.();
+                    }
+                    material.dispose?.();
+                }
             }
         });
         this.objects = [];

package/dist/systems/environmentSystem.d.ts

@@ -16,6 +16,7 @@ export declare class EnvironmentSystem {
     private objectUrls;
     private loadToken;
     private state;
+    private fallbackGradient;
     constructor(scene: THREE.Scene, renderer: THREE.WebGLRenderer, assetResolver?: AssetResolver);
     getState(): EnvironmentState;
     apply(preset: RenderPresetDefinition): Promise<void>;

package/dist/systems/environmentSystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"environmentSystem.d.ts","sourceRoot":"","sources":["../../src/systems/environmentSystem.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,aAAa,EAAE,sBAAsB,EAA8C,MAAM,iBAAiB,CAAC;AAEzH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,KAAK,GAAG,MAAM,CAAC;IAC3C,iBAAiB,EAAE,OAAO,CAAC;IAC3B,eAAe,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,QAAQ,CAAsB;IACtC,OAAO,CAAC,aAAa,CAAC,CAAgB;IACtC,OAAO,CAAC,cAAc,CAAqC;IAE3D,OAAO,CAAC,cAAc,CAAwB;IAC9C,OAAO,CAAC,iBAAiB,CAAkD;IAC3E,OAAO,CAAC,kBAAkB,CAAkD;IAC5E,OAAO,CAAC,UAAU,CAAgB;IAClC,OAAO,CAAC,SAAS,CAAK;IAEtB,OAAO,CAAC,KAAK,CAAwF;gBAEzF,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,aAAa,EAAE,aAAa,CAAC,EAAE,aAAa;IAM5F,QAAQ,IAAI,gBAAgB;IAItB,KAAK,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IA2B1D,OAAO,IAAI,IAAI;IAQf,OAAO,CAAC,cAAc;IAqCtB,OAAO,CAAC,gBAAgB;YA6CV,YAAY;YAaZ,WAAW;YAsDX,YAAY;IAoD1B,OAAO,CAAC,oBAAoB;CAY7B"}
+{"version":3,"file":"environmentSystem.d.ts","sourceRoot":"","sources":["../../src/systems/environmentSystem.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,aAAa,EAAE,sBAAsB,EAA8C,MAAM,iBAAiB,CAAC;AAEzH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,KAAK,GAAG,MAAM,CAAC;IAC3C,iBAAiB,EAAE,OAAO,CAAC;IAC3B,eAAe,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,QAAQ,CAAsB;IACtC,OAAO,CAAC,aAAa,CAAC,CAAgB;IACtC,OAAO,CAAC,cAAc,CAAqC;IAE3D,OAAO,CAAC,cAAc,CAAwB;IAC9C,OAAO,CAAC,iBAAiB,CAAkD;IAC3E,OAAO,CAAC,kBAAkB,CAAkD;IAC5E,OAAO,CAAC,UAAU,CAAgB;IAClC,OAAO,CAAC,SAAS,CAAK;IAEtB,OAAO,CAAC,KAAK,CAAwF;IACrG,OAAO,CAAC,gBAAgB,CAMtB;gBAEU,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,aAAa,EAAE,aAAa,CAAC,EAAE,aAAa;IAM5F,QAAQ,IAAI,gBAAgB;IAItB,KAAK,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAuC1D,OAAO,IAAI,IAAI;IAQf,OAAO,CAAC,cAAc;IAqCtB,OAAO,CAAC,gBAAgB;YA6CV,YAAY;YAaZ,WAAW;YAsDX,YAAY;IAoD1B,OAAO,CAAC,oBAAoB;CAY7B"}

package/dist/systems/environmentSystem.js

@@ -1,5 +1,5 @@
 import * as THREE from "three";
-import { RGBELoader } from "three/examples/jsm/loaders/RGBELoader.js";
+import { HDRLoader } from "three/examples/jsm/loaders/HDRLoader.js";
 export class EnvironmentSystem {
     scene;
     renderer;
@@ -11,6 +11,13 @@ export class EnvironmentSystem {
     objectUrls = [];
     loadToken = 0;
     state = { mode: "none", backgroundEnabled: false, lightingEnabled: false };
+    fallbackGradient = {
+        topColor: "#f8fafc",
+        horizonColor: "#e2e8f0",
+        sunPosition: [0.3, 0.8, 0.4],
+        sunIntensity: 0.12,
+        sunSize: 0.06,
+    };
     constructor(scene, renderer, assetResolver) {
         this.scene = scene;
         this.renderer = renderer;
@@ -34,11 +41,25 @@ export class EnvironmentSystem {
             return;
         }
         if (sky.mode === "hdr") {
-            await this.applyHdrSky(sky.hdr);
+            try {
+                await this.applyHdrSky(sky.hdr);
+            }
+            catch (error) {
+                console.warn("[viewer-kit] HDR sky failed, falling back to gradient.", error);
+                this.applyGradientSky(this.fallbackGradient);
+                this.state = { mode: "gradient", backgroundEnabled: true, lightingEnabled: false };
+            }
             return;
         }
         if (sky.mode === "cube") {
-            await this.applyCubeSky(sky.cube);
+            try {
+                await this.applyCubeSky(sky.cube);
+            }
+            catch (error) {
+                console.warn("[viewer-kit] Cube sky failed, falling back to gradient.", error);
+                this.applyGradientSky(this.fallbackGradient);
+                this.state = { mode: "gradient", backgroundEnabled: true, lightingEnabled: false };
+            }
         }
     }
     dispose() {
@@ -147,11 +168,11 @@ export class EnvironmentSystem {
         const token = ++this.loadToken;
         const backgroundEnabled = hdr.showBackground !== false;
         const lightingEnabled = hdr.showLighting !== false;
-        const usePmrem = hdr.usePmrem !== false;
+        const usePmrem = hdr.usePmrem ?? false;
         const resolved = await this.resolveAsset(hdr.src, "hdr");
         if (token !== this.loadToken)
             return;
-        const loader = new RGBELoader();
+        const loader = new HDRLoader();
         const texture = await loader.loadAsync(resolved);
         if (token !== this.loadToken) {
             texture.dispose();

package/dist/systems/lightingSystem.d.ts

@@ -3,10 +3,12 @@ import type { RenderPresetDefinition } from "../engine/types";
 export declare class LightingSystem {
     private scene;
     private lights;
+    private targets;
     constructor(scene: THREE.Scene);
     apply(preset: RenderPresetDefinition): void;
     dispose(): void;
     private add;
+    private addTarget;
     private clear;
     private configureShadow;
 }

package/dist/systems/lightingSystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lightingSystem.d.ts","sourceRoot":"","sources":["../../src/systems/lightingSystem.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAqB,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAUjF,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,MAAM,CAAqB;gBAEvB,KAAK,EAAE,KAAK,CAAC,KAAK;IAI9B,KAAK,CAAC,MAAM,EAAE,sBAAsB,GAAG,IAAI;IAkD3C,OAAO,IAAI,IAAI;IAIf,OAAO,CAAC,GAAG;IAKX,OAAO,CAAC,KAAK;IAOb,OAAO,CAAC,eAAe;CAcxB"}
+{"version":3,"file":"lightingSystem.d.ts","sourceRoot":"","sources":["../../src/systems/lightingSystem.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAqB,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAUjF,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,OAAO,CAAwB;gBAE3B,KAAK,EAAE,KAAK,CAAC,KAAK;IAI9B,KAAK,CAAC,MAAM,EAAE,sBAAsB,GAAG,IAAI;IAuD3C,OAAO,IAAI,IAAI;IAIf,OAAO,CAAC,GAAG;IAKX,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,KAAK;IAWb,OAAO,CAAC,eAAe;CAcxB"}

package/dist/systems/lightingSystem.js

@@ -9,12 +9,14 @@ const DEFAULT_LIGHTING = {
 export class LightingSystem {
     scene;
     lights = [];
+    targets = [];
     constructor(scene) {
         this.scene = scene;
     }
     apply(preset) {
         this.clear();
         const config = preset.lighting ?? DEFAULT_LIGHTING;
+        const lightTarget = preset.sceneExtras?.lightTarget ?? [0, 1.5, 0];
         if (config.rig === "none")
             return;
         const ambient = config.ambient ?? DEFAULT_LIGHTING.ambient;
@@ -35,12 +37,16 @@ export class LightingSystem {
             if (light.castShadow) {
                 this.configureShadow(light, config.shadow);
             }
+            light.target.position.set(lightTarget[0], lightTarget[1], lightTarget[2]);
+            this.addTarget(light.target);
             this.add(light);
         }
         const fill = config.fill ?? DEFAULT_LIGHTING.fill;
         if (fill && fill.intensity > 0) {
             const light = new THREE.DirectionalLight(new THREE.Color(fill.color), fill.intensity);
             light.position.set(...fill.position);
+            light.target.position.set(lightTarget[0], lightTarget[1], lightTarget[2]);
+            this.addTarget(light.target);
             this.add(light);
         }
         if (preset.interiorLights?.length) {
@@ -60,12 +66,21 @@ export class LightingSystem {
         this.scene.add(light);
         this.lights.push(light);
     }
+    addTarget(target) {
+        this.scene.add(target);
+        this.targets.push(target);
+    }
     clear() {
         this.lights.forEach((light) => {
             if (light.parent)
                 light.parent.remove(light);
         });
         this.lights = [];
+        this.targets.forEach((target) => {
+            if (target.parent)
+                target.parent.remove(target);
+        });
+        this.targets = [];
     }
     configureShadow(light, config) {
         if (!light.shadow)

package/dist/systems/postfxSystem.d.ts

@@ -11,11 +11,15 @@ export declare class PostFxSystem {
     private bloomEffect;
     private vignetteEffect;
     private enabled;
+    private lastWidth;
+    private lastHeight;
+    private pendingConfig;
     constructor(renderer: THREE.WebGLRenderer, scene: THREE.Scene, camera: THREE.PerspectiveCamera);
     apply(config?: PostFxConfig): void;
     render(): void;
     resize(width: number, height: number): void;
     dispose(): void;
+    invalidate(): void;
     getState(): {
         aoEnabled: boolean;
         bloomEnabled: boolean;

package/dist/systems/postfxSystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"postfxSystem.d.ts","sourceRoot":"","sources":["../../src/systems/postfxSystem.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAsB;IACtC,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,QAAQ,CAA+B;IAC/C,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,OAAO,CAAS;gBAEZ,QAAQ,EAAE,KAAK,CAAC,aAAa,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,iBAAiB;IAM9F,KAAK,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI;IA6ElC,MAAM,IAAI,IAAI;IAQd,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAS3C,OAAO,IAAI,IAAI;IAaf,QAAQ,IAAI;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,YAAY,EAAE,OAAO,CAAC;QAAC,eAAe,EAAE,OAAO,CAAA;KAAE;CAOpF"}
+{"version":3,"file":"postfxSystem.d.ts","sourceRoot":"","sources":["../../src/systems/postfxSystem.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAsB;IACtC,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,QAAQ,CAA+B;IAC/C,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,aAAa,CAA6B;gBAEtC,QAAQ,EAAE,KAAK,CAAC,aAAa,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,iBAAiB;IAM9F,KAAK,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI;IA2GlC,MAAM,IAAI,IAAI;IAUd,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAY3C,OAAO,IAAI,IAAI;IAaf,UAAU,IAAI,IAAI;IAMlB,QAAQ,IAAI;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,YAAY,EAAE,OAAO,CAAC;QAAC,eAAe,EAAE,OAAO,CAAA;KAAE;CAOpF"}

package/dist/systems/postfxSystem.js

@@ -1,3 +1,4 @@
+import * as THREE from "three";
 import { BloomEffect, EffectComposer, EffectPass, RenderPass, VignetteEffect } from "postprocessing";
 import { N8AOPostPass } from "n8ao";
 export class PostFxSystem {
@@ -11,6 +12,9 @@ export class PostFxSystem {
     bloomEffect = null;
     vignetteEffect = null;
     enabled = false;
+    lastWidth = 0;
+    lastHeight = 0;
+    pendingConfig = null;
     constructor(renderer, scene, camera) {
         this.renderer = renderer;
         this.scene = scene;
@@ -23,21 +27,32 @@ export class PostFxSystem {
         const shouldEnable = Boolean(ao?.enabled || bloom?.enabled || vignette?.enabled);
         if (!shouldEnable) {
             this.enabled = false;
+            this.pendingConfig = null;
             if (this.aoPass)
                 this.aoPass.enabled = false;
             if (this.effectPass)
                 this.effectPass.enabled = false;
             return;
         }
+        this.pendingConfig = config ?? null;
+        if (this.lastWidth < 2 || this.lastHeight < 2) {
+            this.enabled = false;
+            return;
+        }
         if (!this.composer) {
             this.composer = new EffectComposer(this.renderer);
             this.renderPass = new RenderPass(this.scene, this.camera);
             this.composer.addPass(this.renderPass);
+            this.composer.setSize(this.lastWidth, this.lastHeight);
         }
+        this.composer.autoRenderToScreen = false;
         if (!this.aoPass) {
-            this.aoPass = new N8AOPostPass(this.scene, this.camera, this.renderer.domElement.width, this.renderer.domElement.height);
+            this.aoPass = new N8AOPostPass(this.scene, this.camera, this.lastWidth, this.lastHeight);
             this.composer.addPass(this.aoPass);
         }
+        else {
+            this.aoPass.setSize(this.lastWidth, this.lastHeight);
+        }
         if (!this.bloomEffect) {
             this.bloomEffect = new BloomEffect({
                 intensity: bloom?.intensity ?? 0.0,
@@ -52,11 +67,13 @@ export class PostFxSystem {
                 darkness: vignette?.darkness ?? 0.5,
             });
         }
-        if (!this.effectPass) {
+        const enableEffectPass = Boolean(bloom?.enabled || vignette?.enabled);
+        if (enableEffectPass && !this.effectPass) {
             this.effectPass = new EffectPass(this.camera, this.bloomEffect, this.vignetteEffect);
             this.composer.addPass(this.effectPass);
         }
         this.enabled = true;
+        this.pendingConfig = null;
         if (this.aoPass) {
             this.aoPass.enabled = Boolean(ao?.enabled);
             if (ao?.intensity !== undefined)
@@ -67,6 +84,12 @@ export class PostFxSystem {
                 this.aoPass.configuration.distanceFalloff = ao.distanceFalloff;
             if (ao?.halfRes !== undefined)
                 this.aoPass.configuration.halfRes = ao.halfRes;
+            const quality = (ao?.quality ?? "high").toLowerCase();
+            const qualityMode = quality === "low" ? "Low" : quality === "medium" ? "Medium" : "High";
+            this.aoPass.setQualityMode(qualityMode);
+            if (ao?.color) {
+                this.aoPass.configuration.color = new THREE.Color(ao.color);
+            }
             this.aoPass.firstFrame?.();
         }
         if (this.bloomEffect) {
@@ -86,22 +109,39 @@ export class PostFxSystem {
             this.vignetteEffect.darkness = darkness;
         }
         if (this.effectPass) {
-            this.effectPass.enabled = Boolean(bloom?.enabled || vignette?.enabled);
+            this.effectPass.enabled = enableEffectPass;
+        }
+        // Ensure the last enabled pass renders to screen.
+        const passes = [this.renderPass, this.aoPass, this.effectPass].filter(Boolean);
+        passes.forEach((pass) => {
+            pass.renderToScreen = false;
+        });
+        const enabledPasses = passes.filter((pass) => pass.enabled);
+        const lastPass = enabledPasses[enabledPasses.length - 1];
+        if (lastPass) {
+            lastPass.renderToScreen = true;
         }
     }
     render() {
         if (this.enabled && this.composer) {
+            // EffectComposer disables autoClear; force a clean frame to avoid AO ghosting.
+            this.renderer.clear(true, true, true);
             this.composer.render();
             return;
         }
         this.renderer.render(this.scene, this.camera);
     }
     resize(width, height) {
-        if (this.composer) {
+        this.lastWidth = width;
+        this.lastHeight = height;
+        if (this.composer)
             this.composer.setSize(width, height);
-        }
-        if (this.aoPass) {
+        if (this.aoPass)
             this.aoPass.setSize(width, height);
+        if (this.pendingConfig) {
+            const pending = this.pendingConfig;
+            this.pendingConfig = null;
+            this.apply(pending);
         }
     }
     dispose() {
@@ -116,6 +156,11 @@ export class PostFxSystem {
         this.composer = null;
         this.enabled = false;
     }
+    invalidate() {
+        if (this.aoPass) {
+            this.aoPass.firstFrame?.();
+        }
+    }
     getState() {
         return {
             aoEnabled: Boolean(this.aoPass?.enabled),

package/dist/uploads/grasshopper.d.ts

@@ -0,0 +1,12 @@
+import type { GrasshopperInput, GrasshopperSolveResult, GrasshopperValue } from "./types";
+export type SolveGrasshopperOptions = {
+    apiRoute?: string;
+    values?: GrasshopperValue[];
+    preview?: Record<string, unknown>;
+    onStatus?: (status: string) => void;
+};
+export declare function solveGrasshopperFile(file: File, { apiRoute, values, preview, onStatus }?: SolveGrasshopperOptions): Promise<GrasshopperSolveResult>;
+export declare const mapGrasshopperInputType: (inputType?: string) => string;
+export declare const buildGrasshopperValues: (inputs: GrasshopperInput[], valuesByKey: Record<string, unknown>, keyResolver?: (input: GrasshopperInput, index: number) => string) => GrasshopperValue[];
+export declare const buildGrasshopperDefaults: (inputs: GrasshopperInput[], keyResolver?: (input: GrasshopperInput, index: number) => string) => Record<string, unknown>;
+//# sourceMappingURL=grasshopper.d.ts.map

package/dist/uploads/grasshopper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grasshopper.d.ts","sourceRoot":"","sources":["../../src/uploads/grasshopper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE1F,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC,CAAC;AAuBF,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,IAAI,EACV,EAAE,QAA0B,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAE,uBAA4B,GACtF,OAAO,CAAC,sBAAsB,CAAC,CA+BjC;AAED,eAAO,MAAM,uBAAuB,GAAI,YAAY,MAAM,KAAG,MAM5D,CAAC;AAsBF,eAAO,MAAM,sBAAsB,GACjC,QAAQ,gBAAgB,EAAE,EAC1B,aAAa,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,cAAc,CAAC,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,KAC/D,gBAAgB,EAWlB,CAAC;AAEF,eAAO,MAAM,wBAAwB,GACnC,QAAQ,gBAAgB,EAAE,EAC1B,cAAc,CAAC,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,KAC/D,MAAM,CAAC,MAAM,EAAE,OAAO,CAexB,CAAC"}