@pascal-app/viewer 1.0.0-beta.5 → 1.0.0

package/dist/components/viewer/scene-atmosphere.js

@@ -0,0 +1,89 @@
+'use client';
+import { useThree } from '@react-three/fiber';
+import { useLayoutEffect, useMemo, useRef } from 'react';
+import { cameraPosition, fog, positionWorld, reference, smoothstep } from 'three/tsl';
+import { useStore } from 'zustand';
+import { createStore } from 'zustand/vanilla';
+const sceneAtmospheres = new WeakMap();
+function registryFor(scene) {
+    let registry = sceneAtmospheres.get(scene);
+    if (!registry) {
+        registry = {
+            base: null,
+            owners: [],
+            store: createStore(() => ({
+                source: null,
+            })),
+        };
+        sceneAtmospheres.set(scene, registry);
+    }
+    return registry;
+}
+function applyActiveOwner(scene, registry) {
+    const active = registry.owners.at(-1);
+    if (active) {
+        scene.environmentNode = active.source.environmentNode;
+        scene.environmentIntensity = 1;
+        scene.fogNode = active.fogNode;
+        registry.store.setState({ source: active.source });
+        return;
+    }
+    const base = registry.base;
+    if (base) {
+        scene.environmentNode = base.environmentNode;
+        scene.environmentIntensity = base.environmentIntensity;
+        scene.fogNode = base.fogNode;
+    }
+    registry.base = null;
+    registry.store.setState({ source: null });
+}
+/** Returns the atmosphere currently owning this React Three Fiber scene. */
+export function useSceneAtmosphere() {
+    const scene = useThree((state) => state.scene);
+    const registry = useMemo(() => registryFor(scene), [scene]);
+    return useStore(registry.store, (state) => state.source);
+}
+/**
+ * Installs a generic radiance source into the current scene. The source object is
+ * expected to remain stable while its colors, vectors, and numbers mutate.
+ */
+export function SceneAtmosphere({ source }) {
+    const scene = useThree((state) => state.scene);
+    const invalidate = useThree((state) => state.invalidate);
+    const ownerId = useRef(Symbol('scene-atmosphere'));
+    const registry = useMemo(() => registryFor(scene), [scene]);
+    const fogNode = useMemo(() => {
+        const offset = positionWorld.sub(cameraPosition);
+        const direction = offset.normalize();
+        const fogRange = source;
+        const fogStart = reference('fogStart', 'float', fogRange);
+        const fogEnd = reference('fogEnd', 'float', fogRange);
+        const factor = smoothstep(fogStart, fogEnd, offset.length());
+        return fog(source.fogRadiance(direction), factor);
+    }, [source]);
+    useLayoutEffect(() => {
+        if (registry.owners.length === 0) {
+            registry.base = {
+                environmentNode: scene.environmentNode,
+                environmentIntensity: scene.environmentIntensity,
+                fogNode: scene.fogNode,
+            };
+        }
+        const owner = { id: ownerId.current, source, fogNode };
+        registry.owners.push(owner);
+        applyActiveOwner(scene, registry);
+        invalidate();
+        return () => {
+            const index = registry.owners.findIndex((entry) => entry.id === owner.id);
+            if (index < 0)
+                return;
+            const wasActive = index === registry.owners.length - 1;
+            registry.owners.splice(index, 1);
+            if (wasActive) {
+                applyActiveOwner(scene, registry);
+                invalidate();
+            }
+        };
+    }, [fogNode, invalidate, registry, scene, source]);
+    return null;
+}

package/dist/components/viewer/scene-environment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scene-environment.d.ts","sourceRoot":"","sources":["../../../src/components/viewer/scene-environment.tsx"],"names":[],"mappings":"AAmEA,wBAAgB,gBAAgB,SAkB/B"}
+{"version":3,"file":"scene-environment.d.ts","sourceRoot":"","sources":["../../../src/components/viewer/scene-environment.tsx"],"names":[],"mappings":"AAoEA,wBAAgB,gBAAgB,SA8B/B"}

package/dist/components/viewer/scene-environment.js

@@ -1,9 +1,10 @@
 'use client';
 import { useThree } from '@react-three/fiber';
-import { useEffect, useMemo } from 'react';
+import { useEffect, useMemo, useRef } from 'react';
 import * as THREE from 'three/webgpu';
 import { getSceneTheme } from '../../lib/scene-themes';
 import useViewer from '../../store/use-viewer';
+import { useSceneAtmosphere } from './scene-atmosphere';
 /**
  * Scene IBL — a small procedural gradient sky (cool zenith → warm horizon →
  * dim ground bounce) used purely as the environment light source. The visible
@@ -64,16 +65,29 @@ export function SceneEnvironment() {
     const scene = useThree((state) => state.scene);
     const texture = useMemo(buildGradientSky, []);
     const appearance = useViewer((state) => getSceneTheme(state.sceneTheme).appearance);
+    const atmosphere = useSceneAtmosphere();
+    const atmosphereRef = useRef(atmosphere);
+    atmosphereRef.current = atmosphere;
     useEffect(() => {
         const prevEnvironment = scene.environment;
         const prevIntensity = scene.environmentIntensity;
         scene.environment = texture;
-        scene.environmentIntensity = appearance === 'dark' ? ENV_INTENSITY_DARK : ENV_INTENSITY;
         return () => {
-            scene.environment = prevEnvironment;
-            scene.environmentIntensity = prevIntensity;
+            if (scene.environment === texture) {
+                scene.environment = prevEnvironment;
+                if (!atmosphereRef.current)
+                    scene.environmentIntensity = prevIntensity;
+            }
             texture.dispose();
         };
-    }, [scene, texture, appearance]);
+    }, [scene, texture]);
+    useEffect(() => {
+        // An atmosphere owns environmentIntensity while its environmentNode is
+        // active. The gradient remains installed as the fallback texture and takes
+        // over immediately when the atmosphere restores scene ownership.
+        if (atmosphere)
+            return;
+        scene.environmentIntensity = appearance === 'dark' ? ENV_INTENSITY_DARK : ENV_INTENSITY;
+    }, [appearance, atmosphere, scene]);
     return null;
 }

package/dist/components/viewer/scene-ground-replacement.d.ts

@@ -0,0 +1,5 @@
+/** Whether modeled exterior ground replaces this scene's fallback horizon disc. */
+export declare function useSceneGroundReplacement(): boolean;
+/** Mount alongside replacement ground. The last release restores the fallback. */
+export declare function SceneGroundReplacement(): null;
+//# sourceMappingURL=scene-ground-replacement.d.ts.map

package/dist/components/viewer/scene-ground-replacement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-ground-replacement.d.ts","sourceRoot":"","sources":["../../../src/components/viewer/scene-ground-replacement.tsx"],"names":[],"mappings":"AAoBA,mFAAmF;AACnF,wBAAgB,yBAAyB,IAAI,OAAO,CAInD;AAED,kFAAkF;AAClF,wBAAgB,sBAAsB,SAarC"}

package/dist/components/viewer/scene-ground-replacement.js

@@ -0,0 +1,35 @@
+'use client';
+import { useThree } from '@react-three/fiber';
+import { useLayoutEffect, useMemo } from 'react';
+import { useStore } from 'zustand';
+import { createStore } from 'zustand/vanilla';
+const sceneGrounds = new WeakMap();
+function groundStore(scene) {
+    let store = sceneGrounds.get(scene);
+    if (!store) {
+        store = createStore(() => ({ owners: 0 }));
+        sceneGrounds.set(scene, store);
+    }
+    return store;
+}
+/** Whether modeled exterior ground replaces this scene's fallback horizon disc. */
+export function useSceneGroundReplacement() {
+    const scene = useThree((state) => state.scene);
+    const store = useMemo(() => groundStore(scene), [scene]);
+    return useStore(store, (state) => state.owners > 0);
+}
+/** Mount alongside replacement ground. The last release restores the fallback. */
+export function SceneGroundReplacement() {
+    const scene = useThree((state) => state.scene);
+    const invalidate = useThree((state) => state.invalidate);
+    const store = useMemo(() => groundStore(scene), [scene]);
+    useLayoutEffect(() => {
+        store.setState((state) => ({ owners: state.owners + 1 }));
+        invalidate();
+        return () => {
+            store.setState((state) => ({ owners: state.owners - 1 }));
+            invalidate();
+        };
+    }, [invalidate, store]);
+    return null;
+}

package/dist/components/viewer/viewer-camera.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"viewer-camera.d.ts","sourceRoot":"","sources":["../../../src/components/viewer/viewer-camera.tsx"],"names":[],"mappings":"AAGA,eAAO,MAAM,YAAY,mCAQxB,CAAA"}
+{"version":3,"file":"viewer-camera.d.ts","sourceRoot":"","sources":["../../../src/components/viewer/viewer-camera.tsx"],"names":[],"mappings":"AAIA,eAAO,MAAM,YAAY,mCAUxB,CAAA"}

package/dist/components/viewer/viewer-camera.js

@@ -1,7 +1,10 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { OrthographicCamera, PerspectiveCamera } from '@react-three/drei';
 import useViewer from '../../store/use-viewer';
+import { useSceneGroundReplacement } from './scene-ground-replacement';
 export const ViewerCamera = () => {
     const cameraMode = useViewer((state) => state.cameraMode);
-    return cameraMode === 'perspective' ? (_jsx(PerspectiveCamera, { far: 1000, fov: 50, makeDefault: true, near: 0.1, position: [10, 10, 10] })) : (_jsx(OrthographicCamera, { far: 1000, makeDefault: true, near: -1000, position: [10, 10, 10], zoom: 20 }));
+    // Exterior ground can include a coarse ocean horizon beyond the local terrain.
+    const far = useSceneGroundReplacement() ? 20_000 : 1000;
+    return cameraMode === 'perspective' ? (_jsx(PerspectiveCamera, { far: far, fov: 50, makeDefault: true, near: 0.1, position: [10, 10, 10] })) : (_jsx(OrthographicCamera, { far: 1000, makeDefault: true, near: -1000, position: [10, 10, 10], zoom: 20 }));
 };

package/dist/components/viewer/viewer-presentations.d.ts

@@ -0,0 +1,67 @@
+import { type AnyNode, type LazyComponent } from '@pascal-app/core';
+import type { Object3D, Texture } from 'three';
+export type ViewerPresentationConfiguration = {
+    /** Returns a detached, versioned snapshot suitable for host-owned persistence. */
+    getSnapshot: () => unknown;
+    /** Validates and applies a previously persisted snapshot. */
+    restore: (snapshot: unknown) => void;
+    /** Restores the contribution's initial presentation state. */
+    reset: () => void;
+    /** Notifies the host only when persisted presentation state changes. */
+    subscribe: (onChange: () => void) => () => void;
+};
+export type ViewerPresentationExportContext = {
+    /** Full semantic snapshot; output selection never removes generation context. */
+    nodes: Readonly<Record<string, AnyNode>>;
+    /** Detached contribution configuration captured once when export starts. */
+    configuration: unknown;
+    onlyVisible: boolean;
+    excludedNodeTypes: readonly string[];
+};
+export type ViewerPresentationStaticExport = {
+    label: string;
+    build: (ctx: ViewerPresentationExportContext) => Object3D | null | Promise<Object3D | null>;
+};
+/**
+ * Marks a cached presentation texture handle as borrowed. Static export owns
+ * every returned resource by default; the host clones marked handles before
+ * attaching the contribution and never disposes the marked source handle.
+ */
+export declare function markViewerPresentationTextureBorrowed<T extends Texture>(texture: T): T;
+export declare function isViewerPresentationTextureBorrowed(texture: Texture): boolean;
+export type ViewerPresentationContribution = {
+    /** Globally unique contribution id, conventionally `${pluginId}:presentation`. */
+    id: string;
+    /** Project installation gate. Omit only for host-owned, always-on presentation. */
+    pluginId?: string;
+    /** Lazy R3F subtree mounted as a sibling of the authored scene renderer. */
+    component: LazyComponent;
+    /** Optional host persistence seam; never stored in the semantic scene graph. */
+    configuration?: ViewerPresentationConfiguration;
+    /**
+     * Explicit opt-in static artifact contribution. The returned root must be
+     * detached and uses the presentation's existing world coordinates.
+     */
+    staticExport?: ViewerPresentationStaticExport;
+};
+declare class ViewerPresentationRegistryImpl {
+    private readonly contributions;
+    private readonly listeners;
+    private cached;
+    subscribe: (onChange: () => void) => (() => void);
+    getSnapshot: () => ViewerPresentationContribution[];
+    reset(): void;
+    register(contribution: ViewerPresentationContribution): void;
+    private emit;
+}
+export declare const viewerPresentationRegistry: ViewerPresentationRegistryImpl;
+export declare function registerViewerPresentation(contribution: ViewerPresentationContribution): void;
+/**
+ * Mounts registered presentation-only R3F subtrees for the current project.
+ * Hosts place this once inside each Viewer they want to include presentation;
+ * semantic scene export remains isolated because the mount is a sibling of
+ * `scene-renderer`, not one of its authored descendants.
+ */
+export declare function ViewerPresentations(): (import("react").JSX.Element | null)[];
+export {};
+//# sourceMappingURL=viewer-presentations.d.ts.map

package/dist/components/viewer/viewer-presentations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer-presentations.d.ts","sourceRoot":"","sources":["../../../src/components/viewer/viewer-presentations.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,aAAa,EAAY,MAAM,kBAAkB,CAAA;AAE7E,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAG9C,MAAM,MAAM,+BAA+B,GAAG;IAC5C,kFAAkF;IAClF,WAAW,EAAE,MAAM,OAAO,CAAA;IAC1B,6DAA6D;IAC7D,OAAO,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAA;IACpC,8DAA8D;IAC9D,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,wEAAwE;IACxE,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAA;CAChD,CAAA;AACD,MAAM,MAAM,+BAA+B,GAAG;IAC5C,iFAAiF;IACjF,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IACxC,4EAA4E;IAC5E,aAAa,EAAE,OAAO,CAAA;IACtB,WAAW,EAAE,OAAO,CAAA;IACpB,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAA;CACrC,CAAA;AAED,MAAM,MAAM,8BAA8B,GAAG;IAC3C,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,CAAC,GAAG,EAAE,+BAA+B,KAAK,QAAQ,GAAG,IAAI,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAA;CAC5F,CAAA;AAGD;;;;GAIG;AACH,wBAAgB,qCAAqC,CAAC,CAAC,SAAS,OAAO,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CAGtF;AAED,wBAAgB,mCAAmC,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAE7E;AAED,MAAM,MAAM,8BAA8B,GAAG;IAC3C,kFAAkF;IAClF,EAAE,EAAE,MAAM,CAAA;IACV,mFAAmF;IACnF,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,4EAA4E;IAC5E,SAAS,EAAE,aAAa,CAAA;IACxB,gFAAgF;IAChF,aAAa,CAAC,EAAE,+BAA+B,CAAA;IAC/C;;;OAGG;IACH,YAAY,CAAC,EAAE,8BAA8B,CAAA;CAC9C,CAAA;AAeD,cAAM,8BAA8B;IAClC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAoD;IAClF,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwB;IAClD,OAAO,CAAC,MAAM,CAAuC;IAErD,SAAS,GAAI,UAAU,MAAM,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC,CAK/C;IAED,WAAW,QAAO,8BAA8B,EAAE,CAAe;IAEjE,KAAK,IAAI,IAAI;IAKb,QAAQ,CAAC,YAAY,EAAE,8BAA8B,GAAG,IAAI;IAmD5D,OAAO,CAAC,IAAI;CAIb;AAED,eAAO,MAAM,0BAA0B,gCAAuC,CAAA;AAE9E,wBAAgB,0BAA0B,CAAC,YAAY,EAAE,8BAA8B,GAAG,IAAI,CAE7F;AA2BD;;;;;GAKG;AACH,wBAAgB,mBAAmB,2CAalC"}

package/dist/components/viewer/viewer-presentations.js

@@ -0,0 +1,120 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useScene } from '@pascal-app/core';
+import { lazy, Suspense, useSyncExternalStore } from 'react';
+import { ErrorBoundary } from '../error-boundary';
+const borrowedStaticExportTextures = new WeakSet();
+/**
+ * Marks a cached presentation texture handle as borrowed. Static export owns
+ * every returned resource by default; the host clones marked handles before
+ * attaching the contribution and never disposes the marked source handle.
+ */
+export function markViewerPresentationTextureBorrowed(texture) {
+    borrowedStaticExportTextures.add(texture);
+    return texture;
+}
+export function isViewerPresentationTextureBorrowed(texture) {
+    return borrowedStaticExportTextures.has(texture);
+}
+function isDevMode() {
+    try {
+        const meta = import.meta;
+        if (typeof meta?.env?.DEV === 'boolean')
+            return meta.env.DEV;
+    }
+    catch {
+        // import.meta unavailable in some CJS contexts — fall through.
+    }
+    if (typeof process !== 'undefined' && process.env?.NODE_ENV) {
+        return process.env.NODE_ENV !== 'production';
+    }
+    return false;
+}
+class ViewerPresentationRegistryImpl {
+    contributions = new Map();
+    listeners = new Set();
+    cached = [];
+    subscribe = (onChange) => {
+        this.listeners.add(onChange);
+        return () => {
+            this.listeners.delete(onChange);
+        };
+    };
+    getSnapshot = () => this.cached;
+    reset() {
+        this.contributions.clear();
+        this.emit();
+    }
+    register(contribution) {
+        if (typeof contribution.id !== 'string' || contribution.id.length === 0) {
+            throw new Error('[viewer:presentations] contribution id must be a non-empty string');
+        }
+        if (contribution.pluginId !== undefined &&
+            (typeof contribution.pluginId !== 'string' || contribution.pluginId.length === 0)) {
+            throw new Error('[viewer:presentations] plugin id must be a non-empty string when provided');
+        }
+        if (typeof contribution.component !== 'function') {
+            throw new Error('[viewer:presentations] component must be a lazy component loader');
+        }
+        if (contribution.configuration !== undefined &&
+            (contribution.configuration === null ||
+                typeof contribution.configuration !== 'object' ||
+                typeof contribution.configuration.getSnapshot !== 'function' ||
+                typeof contribution.configuration.restore !== 'function' ||
+                typeof contribution.configuration.reset !== 'function' ||
+                typeof contribution.configuration.subscribe !== 'function')) {
+            throw new Error('[viewer:presentations] configuration must implement getSnapshot, restore, reset, and subscribe');
+        }
+        if (contribution.staticExport !== undefined &&
+            (contribution.staticExport === null ||
+                typeof contribution.staticExport !== 'object' ||
+                typeof contribution.staticExport.label !== 'string' ||
+                contribution.staticExport.label.length === 0 ||
+                typeof contribution.staticExport.build !== 'function')) {
+            throw new Error('[viewer:presentations] staticExport must provide a non-empty label and build function');
+        }
+        if (this.contributions.has(contribution.id)) {
+            if (isDevMode()) {
+                console.warn(`[viewer:presentations] re-registering "${contribution.id}" (HMR)`);
+            }
+            else {
+                throw new Error(`[viewer:presentations] duplicate id: "${contribution.id}" already registered`);
+            }
+        }
+        this.contributions.set(contribution.id, contribution);
+        this.emit();
+    }
+    emit() {
+        this.cached = Array.from(this.contributions.values());
+        for (const listener of this.listeners)
+            listener();
+    }
+}
+export const viewerPresentationRegistry = new ViewerPresentationRegistryImpl();
+export function registerViewerPresentation(contribution) {
+    viewerPresentationRegistry.register(contribution);
+}
+const lazyComponents = new WeakMap();
+function resolvePresentationComponent(loader) {
+    const cached = lazyComponents.get(loader);
+    if (cached)
+        return cached;
+    const component = lazy(loader);
+    lazyComponents.set(loader, component);
+    return component;
+}
+function RegisteredViewerPresentation({ contribution, }) {
+    const Component = resolvePresentationComponent(contribution.component);
+    return (_jsx(ErrorBoundary, { fallback: null, scope: `presentation:${contribution.id}`, children: _jsx(Suspense, { fallback: null, children: _jsx(Component, {}) }) }));
+}
+/**
+ * Mounts registered presentation-only R3F subtrees for the current project.
+ * Hosts place this once inside each Viewer they want to include presentation;
+ * semantic scene export remains isolated because the mount is a sibling of
+ * `scene-renderer`, not one of its authored descendants.
+ */
+export function ViewerPresentations() {
+    const contributions = useSyncExternalStore(viewerPresentationRegistry.subscribe, viewerPresentationRegistry.getSnapshot, viewerPresentationRegistry.getSnapshot);
+    const installedPlugins = useScene((state) => state.installedPlugins);
+    return contributions.map((contribution) => contribution.pluginId && !installedPlugins.includes(contribution.pluginId) ? null : (_jsx(RegisteredViewerPresentation, { contribution: contribution }, contribution.id)));
+}

package/dist/hooks/use-library-materials-version.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Re-render when dynamic library materials (un)register — AI-generated
+ * `library:mtl_*` presets arrive after mount, and material caches keyed on
+ * ref-resolution signatures must recompute once they land.
+ */
+export declare function useLibraryMaterialsVersion(): number;
+//# sourceMappingURL=use-library-materials-version.d.ts.map

package/dist/hooks/use-library-materials-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-library-materials-version.d.ts","sourceRoot":"","sources":["../../src/hooks/use-library-materials-version.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,CAMnD"}

package/dist/hooks/use-library-materials-version.js

@@ -0,0 +1,10 @@
+import { getLibraryMaterialsVersion, subscribeLibraryMaterials } from '@pascal-app/core';
+import { useSyncExternalStore } from 'react';
+/**
+ * Re-render when dynamic library materials (un)register — AI-generated
+ * `library:mtl_*` presets arrive after mount, and material caches keyed on
+ * ref-resolution signatures must recompute once they land.
+ */
+export function useLibraryMaterialsVersion() {
+    return useSyncExternalStore(subscribeLibraryMaterials, getLibraryMaterialsVersion, getLibraryMaterialsVersion);
+}

package/dist/hooks/use-node-events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-node-events.d.ts","sourceRoot":"","sources":["../../src/hooks/use-node-events.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,WAAW,EAIjB,MAAM,kBAAkB,CAAA;AACzB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAQpD,KAAK,UAAU,CAAC,CAAC,SAAS,WAAW,IAAI,OAAO,CAAC,OAAO,EAAE;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,CAAC,CAAA;AAEtE,wBAAgB,aAAa,CAAC,CAAC,SAAS,WAAW,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;uBAwC1D,UAAU,CAAC,YAAY,CAAC;qBAK1B,UAAU,CAAC,YAAY,CAAC;kBAQ3B,UAAU,CAAC,YAAY,CAAC;wBAIlB,UAAU,CAAC,YAAY,CAAC;wBAIxB,UAAU,CAAC,YAAY,CAAC;uBAIzB,UAAU,CAAC,YAAY,CAAC;uBAIxB,UAAU,CAAC,YAAY,CAAC;uBAIxB,UAAU,CAAC,YAAY,CAAC;EAK9C"}
+{"version":3,"file":"use-node-events.d.ts","sourceRoot":"","sources":["../../src/hooks/use-node-events.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,WAAW,EAIjB,MAAM,kBAAkB,CAAA;AACzB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAQpD,KAAK,UAAU,CAAC,CAAC,SAAS,WAAW,IAAI,OAAO,CAAC,OAAO,EAAE;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,CAAC,CAAA;AAEtE,wBAAgB,aAAa,CAAC,CAAC,SAAS,WAAW,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;uBAyC1D,UAAU,CAAC,YAAY,CAAC;qBAK1B,UAAU,CAAC,YAAY,CAAC;kBAQ3B,UAAU,CAAC,YAAY,CAAC;wBAIlB,UAAU,CAAC,YAAY,CAAC;wBAIxB,UAAU,CAAC,YAAY,CAAC;uBAIzB,UAAU,CAAC,YAAY,CAAC;uBAIxB,UAAU,CAAC,YAAY,CAAC;uBAIxB,UAAU,CAAC,YAAY,CAAC;EAK9C"}

package/dist/hooks/use-node-events.js

@@ -18,6 +18,7 @@ export function useNodeEvents(node, type) {
         // keys; the `as never` cast lets us emit a kind-specific payload
         // through that generic surface without enumerating every kind.
         emitter.emit(eventKey, payload);
+        emitter.emit(`node:${suffix}`, payload);
     };
     // Camera drags (orbit / pan / dolly) suppress ALL node pointer events.
     //

package/dist/index.d.ts

@@ -9,9 +9,13 @@ export { type GlbHover, type GlbIdentity, type GlbLevel, GlbScene, type GlbWalkt
 export { CROUCH_CAPSULE, CROUCH_EYE_OFFSET, CROUCH_FLOAT_HEIGHT, CROUCH_RUN_SPEED, CROUCH_WALK_SPEED, EYE_LERP_SPEED, GlbWalkthroughController, STAND_CAPSULE, STAND_CLEARANCE, STAND_FLOAT_HEIGHT, WALKTHROUGH_FOV, } from './components/viewer/glb-walkthrough-controller';
 export type { HoverStyle, HoverStyles } from './components/viewer/post-processing';
 export { DEFAULT_HOVER_STYLES, SSGI_PARAMS, } from './components/viewer/post-processing';
+export { SceneAtmosphere, type SceneAtmosphereSource, useSceneAtmosphere, } from './components/viewer/scene-atmosphere';
 export { SceneEnvironment } from './components/viewer/scene-environment';
+export { SceneGroundReplacement, useSceneGroundReplacement, } from './components/viewer/scene-ground-replacement';
+export { isViewerPresentationTextureBorrowed, markViewerPresentationTextureBorrowed, registerViewerPresentation, type ViewerPresentationConfiguration, type ViewerPresentationContribution, type ViewerPresentationExportContext, type ViewerPresentationStaticExport, ViewerPresentations, viewerPresentationRegistry, } from './components/viewer/viewer-presentations';
 export { useAssetUrl } from './hooks/use-asset-url';
 export { useGLTFKTX2 } from './hooks/use-gltf-ktx2';
+export { useLibraryMaterialsVersion } from './hooks/use-library-materials-version';
 export { useNodeEvents } from './hooks/use-node-events';
 export { ASSETS_CDN_URL, resolveAssetUrl, resolveCdnUrl } from './lib/asset-url';
 export { backdropGradient, deepSkyColor, horizonHazeColor } from './lib/backdrop';
@@ -19,16 +23,21 @@ export { applyWorldScaleBoxUVs } from './lib/box-uv';
 export { ADDITION, Brush, computeGeometryBoundsTree, csgEvaluator, csgGeometry, csgMaterials, INTERSECTION, prepareBrushForCSG, SUBTRACTION, } from './lib/csg-utils';
 export { disposeObject3DResources } from './lib/dispose-object3d';
 export type { EdgeMode } from './lib/edge-style';
+export { PERF_OVERLAY_ENABLED } from './lib/gpu-perf';
 export { computeHeroFraming, DEFAULT_FRAMING_EXCLUDED_TYPES, type HeroFraming, heroCameraPose, temporarilyHideNodeTypes, unionRegisteredNodeBounds, } from './lib/hero-pose';
 export { applyIsolation, clearIsolation, collectIsolationSubtree, isIsolationActive, } from './lib/isolation';
 export { configureKtx2Support, ensureKtx2Support } from './lib/ktx2-loader';
-export { BATCHED_LAYER, GRID_LAYER, OVERLAY_LAYER, SCENE_LAYER, setSurfaceRaycastLayers, ZONE_LAYER, } from './lib/layers';
-export { applyMaterialPresetToMaterials, BLUEPRINT_PALETTE, baseMaterial, CLAY_PALETTE, type ColorPreset, clearMaterialCache, createDefaultMaterial, createMaterial, createMaterialFromPresetRef, createSurfaceRoleMaterial, DEFAULT_CEILING_MATERIAL, DEFAULT_DOOR_MATERIAL, DEFAULT_ROOF_MATERIAL, DEFAULT_SHELF_MATERIAL, DEFAULT_SLAB_MATERIAL, DEFAULT_STAIR_MATERIAL, DEFAULT_WALL_MATERIAL, DEFAULT_WINDOW_MATERIAL, disposeMaterial, glassMaterial, MONO_PALETTE, PRESET_PALETTES, type RenderShading, resolveMaterialRef, resolveSlotDefaultMaterial, resolveSurfaceColor, WHITE_PALETTE, } from './lib/materials';
+export { LayerPassIndex } from './lib/layer-pass';
+export { BATCHED_LAYER, GRID_LAYER, OVERLAY_LAYER, SCENE_LAYER, SHADOW_ONLY_LAYER, setSurfaceRaycastLayers, ZONE_LAYER, } from './lib/layers';
+export { applyMaterialPresetToMaterials, BLUEPRINT_PALETTE, baseMaterial, CLAY_PALETTE, type ColorPreset, clearMaterialCache, createDefaultMaterial, createMaterial, createMaterialFromPresetRef, createSurfaceRoleMaterial, DEFAULT_CEILING_MATERIAL, DEFAULT_DOOR_MATERIAL, DEFAULT_ROOF_MATERIAL, DEFAULT_SHELF_MATERIAL, DEFAULT_SLAB_MATERIAL, DEFAULT_STAIR_MATERIAL, DEFAULT_WALL_MATERIAL, DEFAULT_WINDOW_MATERIAL, disposeMaterial, glassMaterial, MONO_PALETTE, PRESET_PALETTES, type RenderShading, registerMaterialCacheCleanup, resolveMaterialRef, resolveSlotDefaultMaterial, resolveSurfaceColor, WHITE_PALETTE, } from './lib/materials';
 export { mergedOutline } from './lib/merged-outline-node';
-export { unionPolygons } from './lib/polygon-union';
+export * from './lib/perf-actions';
+export { type PerfBatchStats, publishPerfBatchStats } from './lib/perf-panel-store';
+export * from './lib/perf-tracks';
+export { markPureRaycast } from './lib/pointer-events';
 export { detectRendererCapability, initializeGpuRenderer, type RendererBackendParameters, type RendererCapability, type RendererCapabilityCanvas, type RendererInitializationResult, type RendererPowerPreference, } from './lib/renderer-capability';
 export { getSceneTheme, SCENE_THEME_IDS, SCENE_THEMES, type SceneTheme, } from './lib/scene-themes';
-export { type HiddenReason, hideFromScene, showInScene } from './lib/scene-visibility';
+export { type HiddenReason, hideFromScene, showInScene, temporarilyShowShadowOnly, } from './lib/scene-visibility';
 export { createSnapshotPipeline, SNAPSHOT_MAX_EDGE, SNAPSHOT_MIME, SNAPSHOT_QUALITY, type SnapshotCaptureMode, type SnapshotCaptureResult, type SnapshotCropRegion, type SnapshotPipeline, type SnapshotSize, THUMBNAIL_HEIGHT, THUMBNAIL_WIDTH, } from './lib/snapshot-pipeline';
 export { buildTerrainPerimeterFillGeometry, type TerrainPerimeterPoint, } from './lib/terrain-perimeter-fill';
 export { getPascalTextureRef, type PascalTextureColorSpace, type PascalTextureMap, type PascalTextureRef, stampPascalTextureRef, textureMapForSlot, } from './lib/texture-reference';
@@ -47,7 +56,7 @@ export { InteractiveSystem } from './systems/interactive/interactive-system';
 export { ItemSystem } from './systems/item/item-system';
 export { ItemLightSystem } from './systems/item-light/item-light-system';
 export { LevelSystem } from './systems/level/level-system';
-export { snapLevelsToTruePositions } from './systems/level/level-utils';
+export { EXPLODED_GAP, getLevelPresentationY, snapLevelsToTruePositions, } from './systems/level/level-utils';
 export { getRoofMaterialArray } from './systems/roof/roof-materials';
 export { clipGeometryBySegmentTrim, generateRoofSegmentGeometry, getRoofOuterSurfaceFrameAtPoint, getRoofSegmentBrushes, mapRoofGroupMaterialIndex, ROOF_MATERIAL_SLOT_COUNT, RoofSystem, remapRoofShellFaces, roofCsgDummyMats, type SurfaceFrame, } from './systems/roof/roof-system';
 export { ScanSystem } from './systems/scan/scan-system';
@@ -57,7 +66,7 @@ export { StairSystem } from './systems/stair/stair-system';
 export { buildOpeningCutoutGeometry, getOpeningCutoutBottomPadding, hasFlatOpeningCutoutBottom, } from './systems/wall/opening-cutout-geometry';
 export { getWallHideState, WallCutout } from './systems/wall/wall-cutout';
 export { getVisibleWallMaterials } from './systems/wall/wall-materials';
-export { drainRebuiltWalls, getPendingWallRebuildCount, WallSystem, } from './systems/wall/wall-system';
+export { drainRebuiltWalls, getPendingWallRebuildCount, isWallInitialBuildActive, WallSystem, } from './systems/wall/wall-system';
 export { poseWindowMovingParts, WindowAnimationSystem, } from './systems/window/window-animation-system';
 export { buildWindowPreviewMesh, WindowSystem } from './systems/window/window-system';
 export { ZoneSystem } from './systems/zone/zone-system';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -17,9 +17,13 @@ export { buildGlbReferenceNodes, buildGlbReplaceNodes, } from './components/view
 export { GlbScene, } from './components/viewer/glb-scene';
 export { CROUCH_CAPSULE, CROUCH_EYE_OFFSET, CROUCH_FLOAT_HEIGHT, CROUCH_RUN_SPEED, CROUCH_WALK_SPEED, EYE_LERP_SPEED, GlbWalkthroughController, STAND_CAPSULE, STAND_CLEARANCE, STAND_FLOAT_HEIGHT, WALKTHROUGH_FOV, } from './components/viewer/glb-walkthrough-controller';
 export { DEFAULT_HOVER_STYLES, SSGI_PARAMS, } from './components/viewer/post-processing';
+export { SceneAtmosphere, useSceneAtmosphere, } from './components/viewer/scene-atmosphere';
 export { SceneEnvironment } from './components/viewer/scene-environment';
+export { SceneGroundReplacement, useSceneGroundReplacement, } from './components/viewer/scene-ground-replacement';
+export { isViewerPresentationTextureBorrowed, markViewerPresentationTextureBorrowed, registerViewerPresentation, ViewerPresentations, viewerPresentationRegistry, } from './components/viewer/viewer-presentations';
 export { useAssetUrl } from './hooks/use-asset-url';
 export { useGLTFKTX2 } from './hooks/use-gltf-ktx2';
+export { useLibraryMaterialsVersion } from './hooks/use-library-materials-version';
 export { useNodeEvents } from './hooks/use-node-events';
 export { ASSETS_CDN_URL, resolveAssetUrl, resolveCdnUrl } from './lib/asset-url';
 export { backdropGradient, deepSkyColor, horizonHazeColor } from './lib/backdrop';
@@ -29,16 +33,21 @@ export { applyWorldScaleBoxUVs } from './lib/box-uv';
 // because three-bvh-csg / three-mesh-bvh are viewer-only deps.
 export { ADDITION, Brush, computeGeometryBoundsTree, csgEvaluator, csgGeometry, csgMaterials, INTERSECTION, prepareBrushForCSG, SUBTRACTION, } from './lib/csg-utils';
 export { disposeObject3DResources } from './lib/dispose-object3d';
+export { PERF_OVERLAY_ENABLED } from './lib/gpu-perf';
 export { computeHeroFraming, DEFAULT_FRAMING_EXCLUDED_TYPES, heroCameraPose, temporarilyHideNodeTypes, unionRegisteredNodeBounds, } from './lib/hero-pose';
 export { applyIsolation, clearIsolation, collectIsolationSubtree, isIsolationActive, } from './lib/isolation';
 export { configureKtx2Support, ensureKtx2Support } from './lib/ktx2-loader';
-export { BATCHED_LAYER, GRID_LAYER, OVERLAY_LAYER, SCENE_LAYER, setSurfaceRaycastLayers, ZONE_LAYER, } from './lib/layers';
-export { applyMaterialPresetToMaterials, BLUEPRINT_PALETTE, baseMaterial, CLAY_PALETTE, clearMaterialCache, createDefaultMaterial, createMaterial, createMaterialFromPresetRef, createSurfaceRoleMaterial, DEFAULT_CEILING_MATERIAL, DEFAULT_DOOR_MATERIAL, DEFAULT_ROOF_MATERIAL, DEFAULT_SHELF_MATERIAL, DEFAULT_SLAB_MATERIAL, DEFAULT_STAIR_MATERIAL, DEFAULT_WALL_MATERIAL, DEFAULT_WINDOW_MATERIAL, disposeMaterial, glassMaterial, MONO_PALETTE, PRESET_PALETTES, resolveMaterialRef, resolveSlotDefaultMaterial, resolveSurfaceColor, WHITE_PALETTE, } from './lib/materials';
+export { LayerPassIndex } from './lib/layer-pass';
+export { BATCHED_LAYER, GRID_LAYER, OVERLAY_LAYER, SCENE_LAYER, SHADOW_ONLY_LAYER, setSurfaceRaycastLayers, ZONE_LAYER, } from './lib/layers';
+export { applyMaterialPresetToMaterials, BLUEPRINT_PALETTE, baseMaterial, CLAY_PALETTE, clearMaterialCache, createDefaultMaterial, createMaterial, createMaterialFromPresetRef, createSurfaceRoleMaterial, DEFAULT_CEILING_MATERIAL, DEFAULT_DOOR_MATERIAL, DEFAULT_ROOF_MATERIAL, DEFAULT_SHELF_MATERIAL, DEFAULT_SLAB_MATERIAL, DEFAULT_STAIR_MATERIAL, DEFAULT_WALL_MATERIAL, DEFAULT_WINDOW_MATERIAL, disposeMaterial, glassMaterial, MONO_PALETTE, PRESET_PALETTES, registerMaterialCacheCleanup, resolveMaterialRef, resolveSlotDefaultMaterial, resolveSurfaceColor, WHITE_PALETTE, } from './lib/materials';
 export { mergedOutline } from './lib/merged-outline-node';
-export { unionPolygons } from './lib/polygon-union';
+export * from './lib/perf-actions';
+export { publishPerfBatchStats } from './lib/perf-panel-store';
+export * from './lib/perf-tracks';
+export { markPureRaycast } from './lib/pointer-events';
 export { detectRendererCapability, initializeGpuRenderer, } from './lib/renderer-capability';
 export { getSceneTheme, SCENE_THEME_IDS, SCENE_THEMES, } from './lib/scene-themes';
-export { hideFromScene, showInScene } from './lib/scene-visibility';
+export { hideFromScene, showInScene, temporarilyShowShadowOnly, } from './lib/scene-visibility';
 export { createSnapshotPipeline, SNAPSHOT_MAX_EDGE, SNAPSHOT_MIME, SNAPSHOT_QUALITY, THUMBNAIL_HEIGHT, THUMBNAIL_WIDTH, } from './lib/snapshot-pipeline';
 export { buildTerrainPerimeterFillGeometry, } from './lib/terrain-perimeter-fill';
 export { getPascalTextureRef, stampPascalTextureRef, textureMapForSlot, } from './lib/texture-reference';
@@ -67,7 +76,7 @@ export { InteractiveSystem } from './systems/interactive/interactive-system';
 export { ItemSystem } from './systems/item/item-system';
 export { ItemLightSystem } from './systems/item-light/item-light-system';
 export { LevelSystem } from './systems/level/level-system';
-export { snapLevelsToTruePositions } from './systems/level/level-utils';
+export { EXPLODED_GAP, getLevelPresentationY, snapLevelsToTruePositions, } from './systems/level/level-utils';
 export { getRoofMaterialArray } from './systems/roof/roof-materials';
 // Generic roof-segment primitives. Kinds that compose CSG against
 // the roof shell (chimney's self-trim, dormer's virtual-segment cut)
@@ -90,7 +99,7 @@ export { getVisibleWallMaterials } from './systems/wall/wall-materials';
 // definition can compose them into `def.system` without duplicating the
 // 800+ lines of CSG / mitering logic during Phase 3. These exports are
 // removed in Phase 6 when the legacy mount points are deleted.
-export { drainRebuiltWalls, getPendingWallRebuildCount, WallSystem, } from './systems/wall/wall-system';
+export { drainRebuiltWalls, getPendingWallRebuildCount, isWallInitialBuildActive, WallSystem, } from './systems/wall/wall-system';
 export { poseWindowMovingParts, WindowAnimationSystem, } from './systems/window/window-animation-system';
 export { buildWindowPreviewMesh, WindowSystem } from './systems/window/window-system';
 export { ZoneSystem } from './systems/zone/zone-system';

package/dist/lib/csg-utils.d.ts

@@ -6,5 +6,6 @@ export declare function csgMaterials(brush: Brush): THREE.Material[];
 export declare const csgEvaluator: Evaluator;
 export declare function computeGeometryBoundsTree(geometry: THREE.BufferGeometry): void;
 export declare function prepareBrushForCSG(brush: Brush): void;
+export declare function subtractCsgBrush(left: Brush, right: Brush, evaluator: Evaluator): Brush;
 export { ADDITION, Brush, INTERSECTION, SUBTRACTION } from 'three-bvh-csg';
 //# sourceMappingURL=csg-utils.d.ts.map

package/dist/lib/csg-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"csg-utils.d.ts","sourceRoot":"","sources":["../../src/lib/csg-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,KAAK,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AA4CrD,wBAAgB,kCAAkC,CAChD,QAAQ,EAAE,KAAK,CAAC,cAAc,GAC7B,KAAK,CAAC,cAAc,CAoCtB;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAAC,cAAc,CAE9D;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAAC,QAAQ,EAAE,CAG3D;AAED,eAAO,MAAM,YAAY,WAAkB,CAAA;AAK3C,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,KAAK,CAAC,cAAc,QAMvE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,QAI9C;AAID,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA"}
+{"version":3,"file":"csg-utils.d.ts","sourceRoot":"","sources":["../../src/lib/csg-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,KAAK,KAAK,EAAE,SAAS,EAAe,MAAM,eAAe,CAAA;AA4ClE,wBAAgB,kCAAkC,CAChD,QAAQ,EAAE,KAAK,CAAC,cAAc,GAC7B,KAAK,CAAC,cAAc,CAoCtB;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAAC,cAAc,CAE9D;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAAC,QAAQ,EAAE,CAG3D;AAED,eAAO,MAAM,YAAY,WAAkB,CAAA;AAK3C,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,KAAK,CAAC,cAAc,QAMvE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,QAI9C;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,GAAG,KAAK,CAIvF;AAID,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA"}

package/dist/lib/csg-utils.js

@@ -1,5 +1,5 @@
 import * as THREE from 'three';
-import { Evaluator } from 'three-bvh-csg';
+import { Evaluator, SUBTRACTION } from 'three-bvh-csg';
 import { computeBoundsTree } from 'three-mesh-bvh';
 /**
  * Shared CSG primitives used by kinds whose geometry subtracts pieces
@@ -88,6 +88,11 @@ export function prepareBrushForCSG(brush) {
     computeGeometryBoundsTree(brush.geometry);
     brush.updateMatrixWorld();
 }
+export function subtractCsgBrush(left, right, evaluator) {
+    const result = evaluator.evaluate(left, right, SUBTRACTION);
+    prepareBrushForCSG(result);
+    return result;
+}
 // Re-export Brush + SUBTRACTION + ADDITION + INTERSECTION so kinds don't need a
 // direct `three-bvh-csg` dependency.
 export { ADDITION, Brush, INTERSECTION, SUBTRACTION } from 'three-bvh-csg';