@pascal-app/viewer 0.9.2 → 1.0.0-beta.1

package/dist/lib/hero-pose.js

@@ -0,0 +1,227 @@
+import { sceneRegistry, useScene } from '@pascal-app/core';
+import { Box3, Vector3 } from 'three';
+export const DEFAULT_FRAMING_EXCLUDED_TYPES = ['site', 'scan', 'guide', 'spawn'];
+export function heroCameraPose({ boxes, aspect, aim, fovDeg = 60, azimuthRad = Math.PI / 4, elevationRad = (13 * Math.PI) / 180, padding = 1.03, minDistance = 4, frameShift = 0, }) {
+    const list = Array.isArray(boxes) ? boxes : [boxes];
+    const union = new Box3();
+    for (const box of list)
+        union.union(box);
+    const center = aim ? new Vector3(aim[0], aim[1], aim[2]) : union.getCenter(new Vector3());
+    const tanVertical = Math.tan(((fovDeg / 2) * Math.PI) / 180);
+    const tanHorizontal = tanVertical * aspect;
+    // Camera basis for the chosen azimuth/elevation: `dir` points from the
+    // target toward the camera, `forward` is the view direction.
+    const dir = new Vector3(Math.sin(azimuthRad) * Math.cos(elevationRad), Math.sin(elevationRad), Math.cos(azimuthRad) * Math.cos(elevationRad));
+    const forward = dir.clone().negate();
+    const right = new Vector3().crossVectors(forward, new Vector3(0, 1, 0)).normalize();
+    const up = new Vector3().crossVectors(right, forward);
+    // Exact fit: for every corner of every per-node box, the minimal camera
+    // distance along `dir` that keeps it inside the frustum. Fitting the corners
+    // of the UNION box instead reads far too wide at a diagonal azimuth — the
+    // union AABB's extreme corners are the empty diamond tips nothing actually
+    // occupies. (A bounding-sphere fit is worse still for flat, spread scenes.)
+    const corner = new Vector3();
+    const offset = new Vector3();
+    let distance = minDistance;
+    for (const box of list) {
+        for (const x of [box.min.x, box.max.x]) {
+            for (const y of [box.min.y, box.max.y]) {
+                for (const z of [box.min.z, box.max.z]) {
+                    corner.set(x, y, z);
+                    offset.subVectors(corner, center);
+                    const lateral = offset.dot(right);
+                    const vertical = offset.dot(up);
+                    const depth = offset.dot(forward);
+                    distance = Math.max(distance, (Math.abs(lateral) / tanHorizontal - depth) * padding, (Math.abs(vertical) / tanVertical - depth) * padding);
+                }
+            }
+        }
+    }
+    // Reframe: slide aim and camera together along the view-up axis — pure
+    // composition shift, no perspective change.
+    const drop = up.clone().multiplyScalar(-frameShift * distance * tanVertical);
+    const target = center.clone().add(drop);
+    return {
+        position: [
+            target.x + dir.x * distance,
+            target.y + dir.y * distance,
+            target.z + dir.z * distance,
+        ],
+        target: [target.x, target.y, target.z],
+    };
+}
+export function unionRegisteredNodeBounds({ excludeTypes, }) {
+    const excluded = new Set(excludeTypes);
+    const result = new Box3();
+    for (const [type, ids] of Object.entries(sceneRegistry.byType)) {
+        if (excluded.has(type))
+            continue;
+        for (const id of ids) {
+            const object = sceneRegistry.nodes.get(id);
+            if (!object)
+                continue;
+            const bounds = new Box3().setFromObject(object);
+            if (!bounds.isEmpty())
+                result.union(bounds);
+        }
+    }
+    return result.isEmpty() ? null : result;
+}
+function perNodeBoxes(excludeTypes) {
+    const excluded = new Set(excludeTypes);
+    const boxes = [];
+    for (const [type, ids] of Object.entries(sceneRegistry.byType)) {
+        if (excluded.has(type))
+            continue;
+        for (const id of ids) {
+            const object = sceneRegistry.nodes.get(id);
+            if (!object)
+                continue;
+            const bounds = new Box3().setFromObject(object);
+            if (!bounds.isEmpty())
+                boxes.push(bounds);
+        }
+    }
+    return boxes;
+}
+/**
+ * Matches the `SiteNode` bootstrap polygon (a 30×30 square at the origin) —
+ * same rule as the editor's `computeSceneBoundsXZ`: an untouched default lot
+ * says nothing about the user's intent, so it shouldn't drive framing.
+ */
+function isDefaultSitePolygon(points) {
+    if (points.length !== 4)
+        return false;
+    const expected = [
+        [-15, -15],
+        [15, -15],
+        [15, 15],
+        [-15, 15],
+    ];
+    for (let i = 0; i < 4; i++) {
+        const p = points[i];
+        const e = expected[i];
+        if (!Array.isArray(p) || p.length < 2)
+            return false;
+        if (p[0] !== e[0] || p[1] !== e[1])
+            return false;
+    }
+    return true;
+}
+/** Flat boxes for intentionally-shaped site plates, from scene DATA — the
+ *  site's Object3D can't be measured (it carries the ±400 m horizon disc). */
+function sitePlateBoxes() {
+    const boxes = [];
+    for (const node of Object.values(useScene.getState().nodes)) {
+        if (node.type !== 'site')
+            continue;
+        const polygon = node.polygon;
+        const points = polygon?.points;
+        if (!Array.isArray(points) || isDefaultSitePolygon(points))
+            continue;
+        const box = new Box3();
+        for (const point of points) {
+            if (Array.isArray(point) && point.length >= 2) {
+                box.expandByPoint(new Vector3(Number(point[0]), 0, Number(point[1])));
+            }
+        }
+        if (!box.isEmpty())
+            boxes.push(box);
+    }
+    return boxes;
+}
+/** Dominant wall direction folded to a 90°-periodic axis (length-weighted
+ *  vector sum of 4θ), so the hero azimuth sits at a true 45° to the building's
+ *  facades no matter how the user rotated their plan. */
+function dominantWallYaw() {
+    let vx = 0;
+    let vz = 0;
+    for (const node of Object.values(useScene.getState().nodes)) {
+        if (node.type !== 'wall')
+            continue;
+        const { start, end } = node;
+        if (!(Array.isArray(start) && Array.isArray(end)))
+            continue;
+        const dx = Number(end[0]) - Number(start[0]);
+        const dz = Number(end[1]) - Number(start[1]);
+        const length = Math.hypot(dx, dz);
+        if (!(Number.isFinite(length) && length > 0.01))
+            continue;
+        const theta = Math.atan2(dz, dx);
+        vx += length * Math.cos(4 * theta);
+        vz += length * Math.sin(4 * theta);
+    }
+    if (vx === 0 && vz === 0)
+        return null;
+    return Math.atan2(vz, vx) / 4;
+}
+/**
+ * Framing for a scene hero shot. The base set is the built structure (walls,
+ * roofs, slabs, …) plus any intentionally-shaped site plate; an item joins
+ * only when it sits near that base — one palm at the far lot corner must not
+ * shrink the building. `building`/`level` container groups are skipped (their
+ * Object3D holds the whole subtree). The aim keeps the building dead-center:
+ * XZ from the plate+structure union, Y from the structure alone so the
+ * building — not the ground — is vertically centered. Scenes with no
+ * structure (pure furniture arrangements) fall back to framing every
+ * non-helper node.
+ */
+export function computeHeroFraming() {
+    const structural = perNodeBoxes([...DEFAULT_FRAMING_EXCLUDED_TYPES, 'item', 'building', 'level']);
+    if (structural.length === 0) {
+        const all = perNodeBoxes([...DEFAULT_FRAMING_EXCLUDED_TYPES, 'building', 'level']);
+        if (all.length === 0)
+            return null;
+        const union = new Box3();
+        for (const box of all)
+            union.union(box);
+        const center = union.getCenter(new Vector3());
+        return { boxes: all, aim: [center.x, center.y, center.z], azimuthRad: Math.PI / 4 };
+    }
+    const structuralUnion = new Box3();
+    for (const box of structural)
+        structuralUnion.union(box);
+    const plates = sitePlateBoxes();
+    const groundUnion = structuralUnion.clone();
+    for (const box of plates)
+        groundUnion.union(box);
+    const nearby = groundUnion
+        .clone()
+        .expandByVector(groundUnion.getSize(new Vector3()).multiplyScalar(0.15));
+    const boxes = [...structural, ...plates];
+    const itemIds = sceneRegistry.byType.item;
+    for (const id of itemIds) {
+        const object = sceneRegistry.nodes.get(id);
+        if (!object)
+            continue;
+        const bounds = new Box3().setFromObject(object);
+        if (!bounds.isEmpty() && nearby.intersectsBox(bounds))
+            boxes.push(bounds);
+    }
+    const groundCenter = groundUnion.getCenter(new Vector3());
+    const structuralCenter = structuralUnion.getCenter(new Vector3());
+    const yaw = dominantWallYaw();
+    return {
+        boxes,
+        aim: [groundCenter.x, structuralCenter.y, groundCenter.z],
+        azimuthRad: Math.PI / 4 - (yaw ?? 0),
+    };
+}
+export function temporarilyHideNodeTypes(types) {
+    const saved = new Map();
+    for (const type of types) {
+        const ids = sceneRegistry.byType[type];
+        ids.forEach((id) => {
+            const node = sceneRegistry.nodes.get(id);
+            if (node) {
+                saved.set(node, node.visible);
+                node.visible = false;
+            }
+        });
+    }
+    return () => {
+        saved.forEach((wasVisible, node) => {
+            node.visible = wasVisible;
+        });
+    };
+}

package/dist/lib/ktx2-loader.d.ts

@@ -38,6 +38,9 @@ export declare const ktx2Loader: AlignmentSafeKTX2Loader;
 export declare function whenKtx2Ready(): Promise<void>;
 /** Returns true once support has been detected for this renderer (KTX2 safe to load). */
 export declare function ensureKtx2Support(renderer: unknown): boolean;
+export declare function configureKtx2Support<T>(loader: {
+    setKTX2Loader: (ktx2: T) => unknown;
+}, renderer: unknown): boolean;
 export declare function isKtx2Url(url: string): boolean;
 export {};
 //# sourceMappingURL=ktx2-loader.d.ts.map

package/dist/lib/ktx2-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ktx2-loader.d.ts","sourceRoot":"","sources":["../../src/lib/ktx2-loader.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,UAAU,EAAE,MAAM,0CAA0C,CAAA;AAwBrE;;;;;;;;;;GAUG;AACH,cAAM,uBAAwB,SAAQ,UAAU;IAC9C,OAAO,CAAC,YAAY,CAA0B;IAE9C,OAAO,CAAC,cAAc;IAkBtB;kEAC8D;IACxD,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAmC7F,OAAO,IAAI,IAAI;CAMhB;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,yBAAgC,CAAA;AAWvD;;;;;;GAMG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAE7C;AAED,yFAAyF;AACzF,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAkB5D;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE9C"}
+{"version":3,"file":"ktx2-loader.d.ts","sourceRoot":"","sources":["../../src/lib/ktx2-loader.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,UAAU,EAAE,MAAM,0CAA0C,CAAA;AAwBrE;;;;;;;;;;GAUG;AACH,cAAM,uBAAwB,SAAQ,UAAU;IAC9C,OAAO,CAAC,YAAY,CAA0B;IAE9C,OAAO,CAAC,cAAc;IAkBtB;kEAC8D;IACxD,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAmC7F,OAAO,IAAI,IAAI;CAMhB;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,yBAAgC,CAAA;AAWvD;;;;;;GAMG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAE7C;AAED,yFAAyF;AACzF,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAkB5D;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EACpC,MAAM,EAAE;IAAE,aAAa,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAA;CAAE,EAC/C,QAAQ,EAAE,OAAO,GAChB,OAAO,CAIT;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE9C"}

package/dist/lib/ktx2-loader.js

@@ -131,6 +131,12 @@ export function ensureKtx2Support(renderer) {
         return false;
     }
 }
+export function configureKtx2Support(loader, renderer) {
+    if (!ensureKtx2Support(renderer))
+        return false;
+    loader.setKTX2Loader(ktx2Loader);
+    return true;
+}
 export function isKtx2Url(url) {
     return url.toLowerCase().endsWith('.ktx2');
 }

package/dist/lib/materials.d.ts

@@ -10,6 +10,8 @@ export declare const BLUEPRINT_PALETTE: Record<SurfaceRole, string>;
 export declare const PRESET_PALETTES: Record<ColorPreset, Record<SurfaceRole, string>>;
 export declare function resolveSurfaceColor(role: SurfaceRole, preset: ColorPreset, sceneThemeId?: string): string;
 export declare const glassMaterial: MeshLambertNodeMaterial;
+export declare function resolveTextureRepeat(repeat: unknown, scale: unknown): [number, number];
+export declare function getTextureKey(material?: MaterialSchema): string;
 export declare function applyMaterialPresetToMaterials(materialInput: THREE.Material | THREE.Material[], preset: MaterialPresetPayload | null | undefined): void;
 export declare function createMaterialFromPreset(preset: MaterialPresetPayload, shading?: RenderShading): THREE.Material;
 export declare function createMaterialFromPresetRef(materialPreset?: string, shading?: RenderShading): THREE.Material | null;

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

@@ -1 +1 @@
-{"version":3,"file":"materials.d.ts","sourceRoot":"","sources":["../../src/lib/materials.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,qBAAqB,EAE1B,KAAK,cAAc,EAGnB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,WAAW,EACjB,MAAM,kBAAkB,CAAA;AACzB,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,OAAO,EAAE,uBAAuB,EAA4B,MAAM,cAAc,CAAA;AAMhF,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,UAAU,CAAA;AAChD,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,WAAW,CAAA;AAEjE,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAQpD,CAAA;AAID,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAQrD,CAAA;AAED,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAQpD,CAAA;AAED,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAQzD,CAAA;AAED,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAK5E,CAAA;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,WAAW,EACnB,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM,CAKR;AAOD,eAAO,MAAM,aAAa,yBAKxB,CAAA;AA0WF,wBAAgB,8BAA8B,CAC5C,aAAa,EAAE,KAAK,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,EAAE,EAChD,MAAM,EAAE,qBAAqB,GAAG,IAAI,GAAG,SAAS,QAcjD;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,qBAAqB,EAC7B,OAAO,GAAE,aAA0B,GAClC,KAAK,CAAC,QAAQ,CAchB;AAED,wBAAgB,2BAA2B,CACzC,cAAc,CAAC,EAAE,MAAM,EACvB,OAAO,GAAE,aAA0B,GAClC,KAAK,CAAC,QAAQ,GAAG,IAAI,CAIvB;AAED,wBAAgB,cAAc,CAC5B,QAAQ,CAAC,EAAE,cAAc,EACzB,OAAO,GAAE,aAA0B,GAClC,KAAK,CAAC,QAAQ,CAqChB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,cAAc,EAAE,MAAM,CAAC,eAAe,EAAE,aAAa,CAAC,GAAG,SAAS,EAClE,OAAO,GAAE,aAA0B,GAClC,KAAK,CAAC,QAAQ,GAAG,IAAI,CAOvB;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,aAA0B,EACnC,SAAS,SAAM,GACd,KAAK,CAAC,QAAQ,CAQhB;AAED,wBAAgB,qBAAqB,CACnC,KAAK,SAAY,EACjB,SAAS,SAAM,EACf,OAAO,GAAE,aAA0B,EACnC,IAAI,GAAE,KAAK,CAAC,IAAsB,GACjC,KAAK,CAAC,QAAQ,CAehB;AAmBD,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,WAAW,EACnB,IAAI,GAAE,KAAK,CAAC,IAAsB,EAClC,YAAY,CAAC,EAAE,MAAM,GACpB,KAAK,CAAC,QAAQ,CAgChB;AAED,wBAAgB,YAAY,CAAC,OAAO,GAAE,aAA0B,GAAG,KAAK,CAAC,QAAQ,CAEhF;AAED,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,aAA0B,GAAG,KAAK,CAAC,QAAQ,CAEzF;AAED,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,aAA0B,GAAG,KAAK,CAAC,QAAQ,CAEzF;AAED,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,aAA0B,GAAG,KAAK,CAAC,QAAQ,CAEzF;AAED,wBAAgB,uBAAuB,CAAC,OAAO,GAAE,aAA0B,GAAG,KAAK,CAAC,QAAQ,CA2B3F;AAED,wBAAgB,wBAAwB,CAAC,OAAO,GAAE,aAA0B,GAAG,KAAK,CAAC,QAAQ,CAE5F;AAED,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,aAA0B,GAAG,KAAK,CAAC,QAAQ,CAEzF;AAED,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,aAA0B,GAAG,KAAK,CAAC,QAAQ,CAE1F;AAED,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,aAA0B,GAAG,KAAK,CAAC,QAAQ,CAE1F;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ,GAAG,IAAI,CAE9D;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CAqBzC"}
+{"version":3,"file":"materials.d.ts","sourceRoot":"","sources":["../../src/lib/materials.ts"],"names":[],"mappings":"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"}

package/dist/lib/materials.js

@@ -5,6 +5,7 @@ import { MeshLambertNodeMaterial, MeshStandardNodeMaterial } from 'three/webgpu'
 import { resolveCdnUrl } from './asset-url';
 import { isKtx2Url, ktx2Loader, whenKtx2Ready } from './ktx2-loader';
 import { getSceneTheme } from './scene-themes';
+import { stampPascalTextureRef } from './texture-reference';
 export const CLAY_PALETTE = {
     wall: '#dcd6c7',
     floor: '#cfc8b6',
@@ -115,13 +116,29 @@ function getTextureChannel(slot) {
 function getCacheKey(props, shading) {
     return `${shading}-${props.color}-${props.roughness}-${props.metalness}-${props.opacity}-${props.transparent}-${props.side}`;
 }
-function getTextureKey(material) {
+function isFiniteNumber(value) {
+    return typeof value === 'number' && Number.isFinite(value);
+}
+export function resolveTextureRepeat(repeat, scale) {
+    const fallback = isFiniteNumber(scale) ? scale : 1;
+    if (Array.isArray(repeat) && isFiniteNumber(repeat[0]) && isFiniteNumber(repeat[1])) {
+        return [repeat[0], repeat[1]];
+    }
+    if (isFiniteNumber(repeat))
+        return [repeat, repeat];
+    if (repeat && typeof repeat === 'object' && 'x' in repeat && 'y' in repeat) {
+        const { x, y } = repeat;
+        if (isFiniteNumber(x) && isFiniteNumber(y))
+            return [x, y];
+    }
+    return [fallback, fallback];
+}
+export function getTextureKey(material) {
     const texture = material?.texture;
     if (!texture)
         return 'none';
-    const repeat = texture.repeat?.join('x') ?? 'default';
-    const scale = texture.scale ?? 'default';
-    return `${texture.url}-${repeat}-${scale}`;
+    const [repeatX, repeatY] = resolveTextureRepeat(texture.repeat, texture.scale);
+    return `${texture.url}-${repeatX}x${repeatY}`;
 }
 function getTexture(material) {
     const textureConfig = material?.texture;
@@ -131,14 +148,21 @@ function getTexture(material) {
     const cached = textureCache.get(cacheKey);
     if (cached)
         return cached;
-    const texture = pickTextureLoader(textureConfig.url).load(textureConfig.url);
+    const resolvedUrl = /^(?:asset|blob|data):/.test(textureConfig.url)
+        ? textureConfig.url
+        : (resolveCdnUrl(textureConfig.url) ?? textureConfig.url);
+    const texture = pickTextureLoader(resolvedUrl).load(resolvedUrl);
     texture.wrapS = THREE.RepeatWrapping;
     texture.wrapT = THREE.RepeatWrapping;
-    const repeatX = textureConfig.repeat?.[0] ?? textureConfig.scale ?? 1;
-    const repeatY = textureConfig.repeat?.[1] ?? textureConfig.scale ?? 1;
+    const [repeatX, repeatY] = resolveTextureRepeat(textureConfig.repeat, textureConfig.scale);
     texture.repeat.set(repeatX, repeatY);
     texture.updateMatrix();
     texture.colorSpace = THREE.SRGBColorSpace;
+    stampPascalTextureRef(texture, {
+        kind: 'project-asset',
+        src: resolvedUrl,
+        slot: 'map',
+    });
     textureCache.set(cacheKey, texture);
     return texture;
 }
@@ -179,6 +203,11 @@ function getPresetTexture(path, props, slot) {
         return cached;
     const texture = pickTextureLoader(resolvedPath).load(resolvedPath);
     applyTextureProperties(texture, props, slot);
+    stampPascalTextureRef(texture, {
+        kind: 'material',
+        src: resolvedPath,
+        slot: slot ?? 'map',
+    });
     setTextureCacheKey(texture, cacheKey);
     textureCache.set(cacheKey, texture);
     return texture;
@@ -220,6 +249,11 @@ async function loadPresetTexture(path, props, slot) {
     const promise = load
         .then((texture) => {
         applyTextureProperties(texture, props, slot);
+        stampPascalTextureRef(texture, {
+            kind: 'material',
+            src: resolvedPath,
+            slot: slot ?? 'map',
+        });
         setTextureCacheKey(texture, cacheKey);
         textureCache.set(cacheKey, texture);
         textureLoadPromises.delete(cacheKey);
@@ -236,7 +270,13 @@ async function loadPresetTexture(path, props, slot) {
 function queueTextureAssignment(material, slot, path, props) {
     const textureMaterial = material;
     if (!path) {
-        textureMaterial[slot] = null;
+        if (textureMaterial[slot] != null) {
+            // Rebuild the node graph: a cached WebGPU material keeps a TextureNode
+            // for the slot, whose per-frame material reference would pull the null
+            // and crash in TextureNode.update ("null (reading 'matrix')").
+            textureMaterial[slot] = null;
+            material.needsUpdate = true;
+        }
         return;
     }
     const resolvedPath = resolveCdnUrl(path) ?? path;
@@ -251,7 +291,14 @@ function queueTextureAssignment(material, slot, path, props) {
         material.needsUpdate = true;
         return;
     }
-    textureMaterial[slot] = null;
+    // Cold load: clear the slot for the fetch window, and rebuild the node
+    // graph if it previously held a texture — reused cached materials otherwise
+    // keep a TextureNode whose reference pulls the null and crashes the render
+    // pass. Cold loads are the norm for freshly generated library materials.
+    if (textureMaterial[slot] != null) {
+        textureMaterial[slot] = null;
+        material.needsUpdate = true;
+    }
     loadPresetTexture(path, props, slot).then((texture) => {
         if (!texture)
             return;

package/dist/lib/materials.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=materials.test.d.ts.map

package/dist/lib/materials.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"materials.test.d.ts","sourceRoot":"","sources":["../../src/lib/materials.test.ts"],"names":[],"mappings":""}

package/dist/lib/materials.test.js

@@ -0,0 +1,25 @@
+// @ts-expect-error — bun:test is provided by the Bun runtime; viewer does not
+// depend on @types/bun so the import type is unresolved at compile time.
+import { describe, expect, test } from 'bun:test';
+import { getTextureKey, resolveTextureRepeat } from './materials';
+function materialWithRepeat(repeat) {
+    return {
+        texture: {
+            url: 'https://example.com/texture.png',
+            repeat,
+        },
+    };
+}
+describe('legacy texture repeat values', () => {
+    test('normalizes tuple, scalar, and Vector2-shaped repeats', () => {
+        expect(resolveTextureRepeat([2, 3], undefined)).toEqual([2, 3]);
+        expect(resolveTextureRepeat(2, undefined)).toEqual([2, 2]);
+        expect(resolveTextureRepeat({ x: 2, y: 3 }, undefined)).toEqual([2, 3]);
+    });
+    test('falls back to scale for malformed repeats', () => {
+        expect(resolveTextureRepeat({ width: 2 }, 4)).toEqual([4, 4]);
+    });
+    test('keeps distinct Vector2-shaped repeats in distinct cache entries', () => {
+        expect(getTextureKey(materialWithRepeat({ x: 2, y: 3 }))).not.toBe(getTextureKey(materialWithRepeat({ x: 4, y: 5 })));
+    });
+});

package/dist/lib/merged-outline-node.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=merged-outline-node.test.d.ts.map

package/dist/lib/merged-outline-node.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merged-outline-node.test.d.ts","sourceRoot":"","sources":["../../src/lib/merged-outline-node.test.ts"],"names":[],"mappings":""}

package/dist/lib/merged-outline-node.test.js

@@ -0,0 +1,22 @@
+// @ts-expect-error — bun:test is provided by the Bun runtime; viewer does not
+// depend on @types/bun so the import type is unresolved at compile time.
+import { describe, expect, test } from 'bun:test';
+import { Object3D, PerspectiveCamera, Scene } from 'three';
+import { mergedOutline } from './merged-outline-node';
+describe('merged outline rendering', () => {
+    test('keeps selected outlines active during camera interaction', () => {
+        const cameraInteractionActive = true;
+        const params = {
+            enabled: () => !cameraInteractionActive,
+            primaryObjects: [new Object3D()],
+        };
+        const outline = mergedOutline(new Scene(), new PerspectiveCamera(), params);
+        const frame = {
+            get renderer() {
+                throw new Error('outline renderer was reached');
+            },
+        };
+        expect(() => outline.updateBefore(frame)).toThrow('outline renderer was reached');
+        outline.dispose();
+    });
+});

package/dist/lib/snapshot-pipeline.d.ts

@@ -0,0 +1,42 @@
+import { type Camera, type Scene } from 'three';
+import { type WebGPURenderer } from 'three/webgpu';
+import { type EdgeMode } from './edge-style';
+export declare const THUMBNAIL_WIDTH = 1920;
+export declare const THUMBNAIL_HEIGHT = 1080;
+export type SnapshotCaptureMode = 'standard' | 'viewport' | 'area';
+export type SnapshotCropRegion = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+export type SnapshotSize = {
+    w: number;
+    h: number;
+};
+export type SnapshotCaptureResult = {
+    blob: Blob;
+    outW: number;
+    outH: number;
+};
+export type SnapshotPipeline = {
+    applyEnvironment: ({ theme, transparent, grade, edges, camera, }: {
+        theme: string;
+        transparent: boolean;
+        grade: boolean;
+        edges: EdgeMode;
+        camera: Camera;
+    }) => void;
+    capture: ({ captureMode, cropRegion, standardSize, }: {
+        captureMode?: SnapshotCaptureMode;
+        cropRegion?: SnapshotCropRegion;
+        standardSize?: SnapshotSize;
+    }) => Promise<SnapshotCaptureResult>;
+    dispose: () => void;
+};
+export declare function createSnapshotPipeline({ renderer, scene, camera, }: {
+    renderer: WebGPURenderer;
+    scene: Scene;
+    camera: Camera;
+}): Promise<SnapshotPipeline | null>;
+//# sourceMappingURL=snapshot-pipeline.d.ts.map

package/dist/lib/snapshot-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-pipeline.d.ts","sourceRoot":"","sources":["../../src/lib/snapshot-pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAkB,KAAK,KAAK,EAAoB,MAAM,OAAO,CAAA;AAqBjF,OAAO,EAAgC,KAAK,cAAc,EAAE,MAAM,cAAc,CAAA;AAGhF,OAAO,EAAE,KAAK,QAAQ,EAAqC,MAAM,cAAc,CAAA;AAK/E,eAAO,MAAM,eAAe,OAAO,CAAA;AACnC,eAAO,MAAM,gBAAgB,OAAO,CAAA;AAEpC,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,CAAA;AAElE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACV,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,IAAI,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,gBAAgB,EAAE,CAAC,EACjB,KAAK,EACL,WAAW,EACX,KAAK,EACL,KAAK,EACL,MAAM,GACP,EAAE;QACD,KAAK,EAAE,MAAM,CAAA;QACb,WAAW,EAAE,OAAO,CAAA;QACpB,KAAK,EAAE,OAAO,CAAA;QACd,KAAK,EAAE,QAAQ,CAAA;QACf,MAAM,EAAE,MAAM,CAAA;KACf,KAAK,IAAI,CAAA;IACV,OAAO,EAAE,CAAC,EACR,WAAW,EACX,UAAU,EACV,YAAY,GACb,EAAE;QACD,WAAW,CAAC,EAAE,mBAAmB,CAAA;QACjC,UAAU,CAAC,EAAE,kBAAkB,CAAA;QAC/B,YAAY,CAAC,EAAE,YAAY,CAAA;KAC5B,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAA;IACpC,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB,CAAA;AAED,wBAAsB,sBAAsB,CAAC,EAC3C,QAAQ,EACR,KAAK,EACL,MAAM,GACP,EAAE;IACD,QAAQ,EAAE,cAAc,CAAA;IACxB,KAAK,EAAE,KAAK,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;CACf,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAoSnC"}