@pascal-app/viewer 1.1.0 → 1.1.2

package/dist/sfx/player.d.ts

@@ -0,0 +1,31 @@
+import { type SoundName } from './sounds';
+/** A host cue with filenames relative to the configured SFX base URL. */
+export type SoundDefinition = {
+    src: string | string[];
+    rateRange?: [number, number];
+    volumeRange?: [number, number];
+    minIntervalMs?: number;
+    loop?: boolean;
+    volumeMultiplier?: number;
+    fadeInMs?: number;
+    fadeOutMs?: number;
+};
+/** Per-play gain, stereo position and local/remote repeat suppression. */
+export type SoundPlaybackOptions = {
+    source?: 'local' | 'remote';
+    stereo?: number;
+    volumeMultiplier?: number;
+};
+/** Warm built-in cues and optional host cues without playing them. */
+export declare function preloadSounds(extraSounds?: readonly SoundDefinition[]): void;
+/** Unload the shared sound cache and detach its settings subscription. */
+export declare function disposeSounds(): void;
+/** Start a host-defined loop, fading out the previously active loop. */
+export declare function startSoundLoop(name: SoundDefinition): void;
+/** Fade out the active loop and cancel any pending loop playback. */
+export declare function stopSoundLoop(): void;
+/** Play a built-in cue or host definition using the shared audio settings. */
+export declare function playSound(sound: SoundName | SoundDefinition, options?: SoundPlaybackOptions): void;
+/** Apply current volume and mute settings to cached sounds and the active loop. */
+export declare function updateSoundVolumes(): void;
+//# sourceMappingURL=player.d.ts.map

package/dist/sfx/player.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"player.d.ts","sourceRoot":"","sources":["../../src/sfx/player.ts"],"names":[],"mappings":"AAGA,OAAO,EAAU,KAAK,SAAS,EAAE,MAAM,UAAU,CAAA;AAEjD,yEAAyE;AACzE,MAAM,MAAM,eAAe,GAAG;IAC5B,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IACtB,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,0EAA0E;AAC1E,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAA;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B,CAAA;AA4ED,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,WAAW,GAAE,SAAS,eAAe,EAAO,QA6BzE;AAED,0EAA0E;AAC1E,wBAAgB,aAAa,SAK5B;AAED,wEAAwE;AACxE,wBAAgB,cAAc,CAAC,IAAI,EAAE,eAAe,QA4CnD;AAED,qEAAqE;AACrE,wBAAgB,aAAa,SAK5B;AAED,8EAA8E;AAC9E,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,eAAe,EAAE,OAAO,GAAE,oBAAyB,QA2D/F;AAED,mFAAmF;AACnF,wBAAgB,kBAAkB,SAuBjC"}

package/dist/sfx/player.js

@@ -0,0 +1,255 @@
+import { Howl, Howler } from 'howler';
+import { getViewerConfig } from '../lib/viewer-config';
+import { useAudioSettings } from './audio-settings';
+import { SOUNDS } from './sounds';
+const DEFAULT_MIN_INTERVAL_MS = 30;
+const SFX_FAILURE_BACKOFF_MS = 5_000;
+const DEFAULT_LOOP_FADE_MS = 90;
+function randomInRange([min, max]) {
+    return min + Math.random() * (max - min);
+}
+const sfxCache = new Map();
+let cachedBaseUrl = null;
+let unsubscribeAudio = null;
+const definitions = new Set();
+let sfxAudioContext = null;
+let sfxRetryAfter = 0;
+const lastPlayedAt = new Map();
+const lastVariation = new Map();
+let activeLoop = null;
+let pendingLoop = null;
+let requestedLoop = null;
+function loopVolume(name) {
+    const { masterVolume, sfxVolume } = useAudioSettings.getState();
+    return (masterVolume / 100) * (sfxVolume / 100) * (name.volumeMultiplier ?? 1);
+}
+function stopActiveLoop(fadeMs) {
+    const active = activeLoop;
+    if (!active)
+        return;
+    activeLoop = null;
+    if (fadeMs <= 0) {
+        active.sound.stop(active.id);
+        return;
+    }
+    active.sound.once('fade', () => active.sound.stop(active.id), active.id);
+    active.sound.fade(active.volume, 0, fadeMs, active.id);
+}
+function unloadCachedSounds(resetPlaybackState) {
+    requestedLoop = null;
+    pendingLoop = null;
+    stopActiveLoop(0);
+    for (const sounds of sfxCache.values()) {
+        for (const sound of sounds) {
+            try {
+                sound.unload();
+            }
+            catch { }
+        }
+    }
+    sfxCache.clear();
+    sfxAudioContext = null;
+    if (resetPlaybackState) {
+        sfxRetryAfter = 0;
+        lastPlayedAt.clear();
+        lastVariation.clear();
+    }
+}
+function cacheNeedsRebuild() {
+    if (sfxCache.size !== definitions.size || sfxCache.size === 0)
+        return true;
+    if (cachedBaseUrl !== getViewerConfig().sfxBaseUrl)
+        return true;
+    if (sfxAudioContext !== Howler.ctx)
+        return true;
+    for (const sounds of sfxCache.values()) {
+        if (sounds.some((sound) => sound.state() === 'unloaded'))
+            return true;
+    }
+    return false;
+}
+/** Warm built-in cues and optional host cues without playing them. */
+export function preloadSounds(extraSounds = []) {
+    for (const definition of [...Object.values(SOUNDS), ...extraSounds])
+        definitions.add(definition);
+    if (performance.now() < sfxRetryAfter)
+        return;
+    try {
+        if (!unsubscribeAudio)
+            unsubscribeAudio = useAudioSettings.subscribe(updateSoundVolumes);
+        if (!cacheNeedsRebuild())
+            return;
+        unloadCachedSounds(false);
+        const baseUrl = getViewerConfig().sfxBaseUrl.replace(/\/+$/, '');
+        cachedBaseUrl = getViewerConfig().sfxBaseUrl;
+        for (const config of definitions) {
+            const sources = Array.isArray(config.src) ? config.src : [config.src];
+            sfxCache.set(config, sources.map((src) => new Howl({
+                loop: config.loop ?? false,
+                src: [`${baseUrl}/${src}`],
+                preload: true,
+                volume: 0.5,
+            })));
+        }
+        sfxAudioContext = Howler.ctx ?? null;
+    }
+    catch {
+        unloadCachedSounds(false);
+        sfxRetryAfter = performance.now() + SFX_FAILURE_BACKOFF_MS;
+    }
+}
+/** Unload the shared sound cache and detach its settings subscription. */
+export function disposeSounds() {
+    unsubscribeAudio?.();
+    unsubscribeAudio = null;
+    unloadCachedSounds(true);
+    definitions.clear();
+}
+/** Start a host-defined loop, fading out the previously active loop. */
+export function startSoundLoop(name) {
+    definitions.add(name);
+    const { muted } = useAudioSettings.getState();
+    if (muted) {
+        stopSoundLoop();
+        return;
+    }
+    requestedLoop = name;
+    const current = activeLoop;
+    if (current?.name === name && current.sound.playing(current.id))
+        return;
+    if (current)
+        stopActiveLoop(current.name.fadeOutMs ?? DEFAULT_LOOP_FADE_MS);
+    const now = performance.now();
+    if (now < sfxRetryAfter)
+        return;
+    try {
+        preloadSounds();
+        // A fresh Howler context rebuilds the cache and clears stale playback
+        // state. Restore this current press after that cleanup so a first-use loop
+        // can still begin when its asset finishes loading.
+        requestedLoop = name;
+        const sound = sfxCache.get(name)?.[0];
+        if (!sound)
+            return;
+        if (sound.state() !== 'loaded') {
+            if (pendingLoop?.name === name && pendingLoop.sound === sound)
+                return;
+            pendingLoop = { name, sound };
+            sound.once('load', () => {
+                if (pendingLoop?.sound === sound)
+                    pendingLoop = null;
+                if (requestedLoop === name)
+                    startSoundLoop(name);
+            });
+            return;
+        }
+        const config = name;
+        const volume = loopVolume(name);
+        const id = sound.play();
+        sound.volume(0, id);
+        activeLoop = { id, name, sound, volume };
+        sound.fade(0, volume, config.fadeInMs ?? DEFAULT_LOOP_FADE_MS, id);
+    }
+    catch {
+        unloadCachedSounds(false);
+        sfxRetryAfter = now + SFX_FAILURE_BACKOFF_MS;
+    }
+}
+/** Fade out the active loop and cancel any pending loop playback. */
+export function stopSoundLoop() {
+    requestedLoop = null;
+    pendingLoop = null;
+    const fadeMs = activeLoop ? (activeLoop.name.fadeOutMs ?? DEFAULT_LOOP_FADE_MS) : 0;
+    stopActiveLoop(fadeMs);
+}
+/** Play a built-in cue or host definition using the shared audio settings. */
+export function playSound(sound, options = {}) {
+    const name = typeof sound === 'string' ? SOUNDS[sound] : sound;
+    const config = name;
+    definitions.add(config);
+    const { masterVolume, sfxVolume, muted } = useAudioSettings.getState();
+    if (muted)
+        return;
+    // Drop rapid repeats — two plays of the same SFX within minIntervalMs just
+    // smear into noise, they don't add useful information.
+    const now = performance.now();
+    if (now < sfxRetryAfter)
+        return;
+    const minInterval = config.minIntervalMs ?? DEFAULT_MIN_INTERVAL_MS;
+    const source = options.source ?? 'local';
+    const times = lastPlayedAt.get(name) ?? {};
+    const last = times[source];
+    if (last !== undefined && now - last < minInterval)
+        return;
+    // Local feedback stays legible when a collaborator makes the same kind of
+    // change at nearly the same time; the quieter remote cue yields instead.
+    const lastLocal = times.local;
+    if (source === 'remote' && lastLocal !== undefined && now - lastLocal < 120)
+        return;
+    times[source] = now;
+    lastPlayedAt.set(name, times);
+    try {
+        preloadSounds();
+        const sounds = sfxCache.get(name);
+        if (!sounds || sounds.length === 0)
+            return;
+        // Pick a random variation, avoiding an immediate repeat of the last one so
+        // consecutive plays don't land on the same file.
+        let index = Math.floor(Math.random() * sounds.length);
+        if (sounds.length > 1 && index === lastVariation.get(name)) {
+            index = (index + 1) % sounds.length;
+        }
+        lastVariation.set(name, index);
+        const sound = sounds[index];
+        // Howler queues per-play mutations while a sound is loading. If its global
+        // AudioContext is replaced before that queue drains, stereo setup can try
+        // to connect nodes from different contexts and throw asynchronously.
+        if (sound.state() !== 'loaded')
+            return;
+        const baseVolume = (masterVolume / 100) * (sfxVolume / 100);
+        const volumeJitter = config.volumeRange ? randomInRange(config.volumeRange) : 1;
+        const volumeMultiplier = Number.isFinite(options.volumeMultiplier)
+            ? Math.max(0, Math.min(2, options.volumeMultiplier))
+            : 1;
+        const rate = config.rateRange ? randomInRange(config.rateRange) : 1;
+        const id = sound.play();
+        sound.volume(baseVolume * volumeJitter * volumeMultiplier, id);
+        if (Number.isFinite(options.stereo)) {
+            sound.stereo(Math.max(-1, Math.min(1, options.stereo)), id);
+        }
+        if (rate !== 1)
+            sound.rate(rate, id);
+    }
+    catch {
+        // Optional audio must never abort an input callback. Rebuild from
+        // the current Howler context after a backoff instead of retrying every pointer cue.
+        unloadCachedSounds(false);
+        sfxRetryAfter = now + SFX_FAILURE_BACKOFF_MS;
+    }
+}
+/** Apply current volume and mute settings to cached sounds and the active loop. */
+export function updateSoundVolumes() {
+    const { masterVolume, muted, sfxVolume } = useAudioSettings.getState();
+    if (muted) {
+        stopSoundLoop();
+        return;
+    }
+    const finalVolume = (masterVolume / 100) * (sfxVolume / 100);
+    try {
+        if (performance.now() < sfxRetryAfter)
+            return;
+        sfxCache.forEach((sounds) => {
+            sounds.forEach((sound) => {
+                sound.volume(finalVolume);
+            });
+        });
+        if (activeLoop) {
+            activeLoop.volume = loopVolume(activeLoop.name);
+            activeLoop.sound.volume(activeLoop.volume, activeLoop.id);
+        }
+    }
+    catch {
+        unloadCachedSounds(false);
+        sfxRetryAfter = performance.now() + SFX_FAILURE_BACKOFF_MS;
+    }
+}

package/dist/sfx/sounds.d.ts

@@ -0,0 +1,60 @@
+/** Built-in interaction and viewer UI cues, keyed by their public names. */
+export declare const SOUNDS: {
+    menuHover: {
+        src: string;
+        rateRange: [number, number];
+        volumeRange: [number, number];
+        minIntervalMs: number;
+    };
+    menuClick: {
+        src: string;
+        rateRange: [number, number];
+        volumeRange: [number, number];
+    };
+    doorOpen: {
+        src: string;
+        rateRange: [number, number];
+        volumeRange: [number, number];
+    };
+    doorClose: {
+        src: string;
+        rateRange: [number, number];
+        volumeRange: [number, number];
+    };
+    doorSwing: {
+        src: string;
+        rateRange: [number, number];
+    };
+    garageDoor: {
+        src: string;
+        volumeRange: [number, number];
+    };
+    shuttersOpen: {
+        src: string;
+        rateRange: [number, number];
+    };
+    shuttersClose: {
+        src: string;
+        rateRange: [number, number];
+    };
+    switchOn: {
+        src: string;
+    };
+    switchOff: {
+        src: string;
+    };
+    viewerHover: {
+        src: string;
+        minIntervalMs: number;
+    };
+    viewerSelect: {
+        src: string;
+        minIntervalMs: number;
+    };
+    viewerDeselect: {
+        src: string;
+    };
+};
+/** A built-in interaction or viewer UI cue name. */
+export type SoundName = keyof typeof SOUNDS;
+//# sourceMappingURL=sounds.d.ts.map

package/dist/sfx/sounds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sounds.d.ts","sourceRoot":"","sources":["../../src/sfx/sounds.ts"],"names":[],"mappings":"AAEA,4EAA4E;AAC5E,eAAO,MAAM,MAAM;;QAEf,GAAG;QACH,SAAS;QACT,WAAW;QACX,aAAa;;;QAGb,GAAG;QACH,SAAS;QACT,WAAW;;;QAED,GAAG;QAAmB,SAAS;QAAgB,WAAW;;;QACzD,GAAG;QAAoB,SAAS;QAAgB,WAAW;;;QAC3D,GAAG;QAAoB,SAAS;;;QAC/B,GAAG;QAAqB,WAAW;;;QACjC,GAAG;QAAuB,SAAS;;;QAClC,GAAG;QAAwB,SAAS;;;QACzC,GAAG;;;QACF,GAAG;;;QACD,GAAG;QAAsB,aAAa;;;QACrC,GAAG;QAAuB,aAAa;;;QACrC,GAAG;;CACoB,CAAA;AAE3C,oDAAoD;AACpD,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,MAAM,CAAA"}

package/dist/sfx/sounds.js

@@ -0,0 +1,25 @@
+/** Built-in interaction and viewer UI cues, keyed by their public names. */
+export const SOUNDS = {
+    menuHover: {
+        src: 'menu_hover.mp3',
+        rateRange: [0.98, 1.02],
+        volumeRange: [0.2, 0.3],
+        minIntervalMs: 0,
+    },
+    menuClick: {
+        src: 'menu_click.mp3',
+        rateRange: [0.98, 1.02],
+        volumeRange: [0.5, 0.6],
+    },
+    doorOpen: { src: 'door_open.mp3', rateRange: [0.96, 1.04], volumeRange: [0.9, 1] },
+    doorClose: { src: 'door_close.mp3', rateRange: [0.96, 1.04], volumeRange: [0.9, 1] },
+    doorSwing: { src: 'door_swing.mp3', rateRange: [0.97, 1.03] },
+    garageDoor: { src: 'garage_door.mp3', volumeRange: [0.9, 1] },
+    shuttersOpen: { src: 'shutters_open.mp3', rateRange: [0.96, 1.04] },
+    shuttersClose: { src: 'shutters_close.mp3', rateRange: [0.96, 1.04] },
+    switchOn: { src: 'switch_on.mp3' },
+    switchOff: { src: 'switch_off.mp3' },
+    viewerHover: { src: 'viewer_hover.mp3', minIntervalMs: 95 },
+    viewerSelect: { src: 'viewer_select.mp3', minIntervalMs: 90 },
+    viewerDeselect: { src: 'viewer_deselect.mp3' },
+};

package/dist/sfx/use-viewer-ui-sounds.d.ts

@@ -0,0 +1,8 @@
+import type useViewer from '../store/use-viewer';
+type Selection = ReturnType<typeof useViewer.getState>['selection'];
+/** Which tick a selection change plays: anything newly picked selects, anything let go deselects. */
+export declare function selectionCue(previous: Selection, next: Selection): 'viewerSelect' | 'viewerDeselect' | null;
+/** Play selection and hover cues after user activation, except during walkthrough. */
+export declare function useViewerUiSounds(): void;
+export {};
+//# sourceMappingURL=use-viewer-ui-sounds.d.ts.map

package/dist/sfx/use-viewer-ui-sounds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-viewer-ui-sounds.d.ts","sourceRoot":"","sources":["../../src/sfx/use-viewer-ui-sounds.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,SAAS,MAAM,qBAAqB,CAAA;AAGhD,KAAK,SAAS,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC,QAAQ,CAAC,CAAC,WAAW,CAAC,CAAA;AAEnE,qGAAqG;AACrG,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,SAAS,EACnB,IAAI,EAAE,SAAS,GACd,cAAc,GAAG,gBAAgB,GAAG,IAAI,CAW1C;AAED,sFAAsF;AACtF,wBAAgB,iBAAiB,SAsBhC"}

package/dist/sfx/use-viewer-ui-sounds.js

@@ -0,0 +1,42 @@
+'use client';
+import { useEffect } from 'react';
+import { playSound, preloadSounds } from './player';
+/** Which tick a selection change plays: anything newly picked selects, anything let go deselects. */
+export function selectionCue(previous, next) {
+    const picked = (next.levelId && next.levelId !== previous.levelId) ||
+        (next.zoneId && next.zoneId !== previous.zoneId) ||
+        next.selectedIds.some((id) => !previous.selectedIds.includes(id));
+    if (picked)
+        return 'viewerSelect';
+    const released = (previous.levelId && !next.levelId) ||
+        (previous.zoneId && !next.zoneId) ||
+        previous.selectedIds.some((id) => !next.selectedIds.includes(id));
+    return released ? 'viewerDeselect' : null;
+}
+/** Play selection and hover cues after user activation, except during walkthrough. */
+export function useViewerUiSounds() {
+    useEffect(() => {
+        let disposed = false;
+        let unsubscribe;
+        preloadSounds();
+        void import('../store/use-viewer').then(({ default: viewer }) => {
+            if (disposed)
+                return;
+            unsubscribe = viewer.subscribe((state, previous) => {
+                if (state.walkthroughMode || !globalThis.navigator?.userActivation?.hasBeenActive)
+                    return;
+                if (state.selection !== previous.selection) {
+                    const cue = selectionCue(previous.selection, state.selection);
+                    if (cue)
+                        playSound(cue);
+                }
+                if (state.hoveredId && state.hoveredId !== previous.hoveredId && !state.cameraDragging)
+                    playSound('viewerHover');
+            });
+        });
+        return () => {
+            disposed = true;
+            unsubscribe?.();
+        };
+    }, []);
+}

package/dist/store/use-first-person-hud.d.ts

@@ -0,0 +1,13 @@
+export type WalkthroughInteract = {
+    label: string;
+    verb: string;
+} | null;
+export type FirstPersonHudState = {
+    floorLabel: string | null;
+    zoneLabel: string | null;
+    interact: WalkthroughInteract;
+    setHud: (hud: Partial<Pick<FirstPersonHudState, 'floorLabel' | 'zoneLabel' | 'interact'>>) => void;
+    reset: () => void;
+};
+export declare const useFirstPersonHud: import("zustand").UseBoundStore<import("zustand").StoreApi<FirstPersonHudState>>;
+//# sourceMappingURL=use-first-person-hud.d.ts.map

package/dist/store/use-first-person-hud.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-first-person-hud.d.ts","sourceRoot":"","sources":["../../src/store/use-first-person-hud.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,mBAAmB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAA;AAExE,MAAM,MAAM,mBAAmB,GAAG;IAChC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,QAAQ,EAAE,mBAAmB,CAAA;IAC7B,MAAM,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,mBAAmB,EAAE,YAAY,GAAG,WAAW,GAAG,UAAU,CAAC,CAAC,KAAK,IAAI,CAAA;IAClG,KAAK,EAAE,MAAM,IAAI,CAAA;CAClB,CAAA;AAED,eAAO,MAAM,iBAAiB,kFA2B3B,CAAA"}

package/dist/store/use-first-person-hud.js

@@ -0,0 +1,21 @@
+import { create } from 'zustand';
+export const useFirstPersonHud = create((set) => ({
+    floorLabel: null,
+    zoneLabel: null,
+    interact: null,
+    setHud: (hud) => set((state) => {
+        const floorLabel = hud.floorLabel === undefined ? state.floorLabel : hud.floorLabel;
+        const zoneLabel = hud.zoneLabel === undefined ? state.zoneLabel : hud.zoneLabel;
+        const interact = hud.interact === undefined ? state.interact : hud.interact;
+        if (floorLabel === state.floorLabel &&
+            zoneLabel === state.zoneLabel &&
+            interact?.label === state.interact?.label &&
+            interact?.verb === state.interact?.verb) {
+            return state;
+        }
+        return { floorLabel, zoneLabel, interact };
+    }),
+    reset: () => set((state) => state.floorLabel === null && state.zoneLabel === null && state.interact === null
+        ? state
+        : { floorLabel: null, zoneLabel: null, interact: null }),
+}));

package/dist/systems/roof/roof-system.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"roof-system.d.ts","sourceRoot":"","sources":["../../../src/systems/roof/roof-system.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EAgCZ,KAAK,eAAe,EAUrB,MAAM,kBAAkB,CAAA;AAGzB,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,OAAO,EAAY,KAAK,EAA0B,MAAM,eAAe,CAAA;AAmKvE;;;;;GAKG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAIjD;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,EACzB,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,KAAK,CAAC,QAAQ,GAAG,SAAS,GAClD,MAAM,CAIR;AAiFD,0EAA0E;AAC1E,MAAM,MAAM,mBAAmB,GAAG;IAChC,YAAY,EAAE,CAAC,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,KAAK,IAAI,CAAA;CAChE,CAAA;AAED,eAAO,MAAM,UAAU,yBAAyB;IAAE,eAAe,CAAC,EAAE,mBAAmB,CAAA;CAAE,SA6KxF,CAAA;AAmeD;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,EAAE;IAC7B,KAAK,CAAC,iBAAiB;IACvB,KAAK,CAAC,iBAAiB;IACvB,KAAK,CAAC,iBAAiB;IACvB,KAAK,CAAC,iBAAiB;CAMxB,CAAA;AAID,eAAO,MAAM,wBAAwB,IAAI,CAAA;AAEzC,KAAK,mBAAmB,GAAG;IACzB,QAAQ,EAAE,KAAK,CAAA;IACf,QAAQ,EAAE,KAAK,CAAA;IACf,SAAS,EAAE,KAAK,CAAA;IAChB,UAAU,EAAE,KAAK,CAAA;IACjB,UAAU,EAAE,KAAK,CAAC,cAAc,GAAG,IAAI,CAAA;CACxC,CAAA;AA8FD,wBAAgB,yBAAyB,CACvC,kBAAkB,EAAE,MAAM,GAAG,SAAS,EACtC,YAAY,EAAE,KAAK,CAAC,QAAQ,EAAE,EAC9B,UAAU,EAAE,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,GACtC,MAAM,CAuBR;AA4XD;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,KAAK,CAAC,cAAc,GAAG,IAAI,EACrC,OAAO,EAAE,eAAe,GACvB,KAAK,CAAC,cAAc,GAAG,IAAI,CAgC7B;AAiUD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAO9D;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,eAAe,EACrB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GACnD,mBAAmB,GAAG,IAAI,CA8b5B;AAkFD;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,eAAe,EACrB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAClC,KAAK,CAAC,cAAc,CA0HtB;AAED,wBAAgB,qCAAqC,CACnD,QAAQ,EAAE,KAAK,CAAC,cAAc,EAC9B,IAAI,EAAE,eAAe,EACrB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB,KAAK,CAAC,cAAc,CAiCtB;AAkwCD,KAAK,eAAe,GAAG;IACrB,IAAI,EAAE,eAAe,CAAA;IACrB,0EAA0E;IAC1E,OAAO,EAAE,KAAK,CAAC,OAAO,GAAG,IAAI,CAAA;CAC9B,CAAA;AA+CD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,KAAK,CAAC,cAAc,EAC9B,QAAQ,EAAE,SAAS,eAAe,EAAE,EACpC,MAAM,EAAE,OAAO,QA8DhB;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,KAAK,CAAC,cAAc,EAAE,IAAI,EAAE,eAAe,QA0ExF;AAirBD,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,KAAK,CAAC,OAAO,CAAA;IACpB,MAAM,EAAE,KAAK,CAAC,OAAO,CAAA;CACtB,CAAA;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,eAAe,EACxB,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,GACT,YAAY,CA+Ld"}
+{"version":3,"file":"roof-system.d.ts","sourceRoot":"","sources":["../../../src/systems/roof/roof-system.tsx"],"names":[],"mappings":"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"}

package/dist/systems/roof/roof-system.js

@@ -120,9 +120,14 @@ const MAX_ROOFS_PER_FRAME = 1;
 const MAX_SEGMENTS_PER_FRAME = 3;
 /** What each roof's shell was last merged from: its node and its segments, as the store held them. */
 const mergedFrom = new Map();
+/** A roof's shell is merged from the roof and its segments; its faces of other kinds draw apart. */
+const shellInputIds = (roof, nodes) => [
+    roof.id,
+    ...(roof.children ?? []).filter((id) => nodes[id]?.type === 'roof-segment'),
+];
 function rememberMergedInputs(roof, nodes) {
     const inputs = new Map();
-    for (const id of [roof.id, ...(roof.children ?? [])]) {
+    for (const id of shellInputIds(roof, nodes)) {
         const node = nodes[id];
         if (node)
             inputs.set(id, node);
@@ -135,7 +140,7 @@ function mergedFromStillHolds(roofId, nodes) {
     const roof = nodes[roofId];
     if (!inputs || roof?.type !== 'roof')
         return false;
-    const ids = [roofId, ...(roof.children ?? [])];
+    const ids = shellInputIds(roof, nodes);
     return ids.length === inputs.size && ids.every((id) => inputs.get(id) === nodes[id]);
 }
 /**
@@ -498,7 +503,7 @@ function getMergedRoofSegmentBrushes(roofNode, segment, nodes, framing) {
         return cloneCachedMergedRoofSegmentBrushes(cached);
     }
     const brushes = withSegmentUvMatrix(composeSegmentWorldMatrix(roofNode.position, roofNode.rotation ?? 0, segment.position, segment.rotation ?? 0), () => getRoofSegmentBrushes(segment, {
-        fascia: wearsFascia(segment, roofNode),
+        fascia: wearsFascia(segment, roofNode, nodes),
         framing: framingDepth,
     }));
     if (!brushes) {
@@ -562,10 +567,11 @@ function updateMergedRoofGeometry(roofNode, group, nodes, framing) {
     // Merge each child through `getEffectiveNode` so an in-flight handle
     // drag (live override on width / depth / wallHeight / pitch / rotation)
     // is reflected in the merged shell during the drag, not only on commit.
+    // Faces of other kinds (`capabilities.roofs`) render as their own kind, outside the shell.
     const children = (roofNode.children ?? [])
         .map((id) => {
         const scn = nodes[id];
-        return scn ? getEffectiveNode(scn) : undefined;
+        return scn?.type === 'roof-segment' ? getEffectiveNode(scn) : undefined;
     })
         .filter((n) => n !== undefined && !hasSegmentMaterialOverride(n) && !isIndependentRoofSegment(n));
     if (children.length === 0) {
@@ -628,7 +634,7 @@ function updateMergedRoofGeometry(roofNode, group, nodes, framing) {
         else {
             totalDeckSlab = brushes.deckSlab;
         }
-        if (!shouldIncludeRoofSegmentWallShell(child, roofNode)) {
+        if (!shouldIncludeRoofSegmentWallShell(child, roofNode, nodes)) {
             brushes.wallBrush.geometry.dispose();
             brushes.innerBrush.geometry.dispose();
         }
@@ -695,7 +701,7 @@ function updateMergedRoofGeometry(roofNode, group, nodes, framing) {
             }
             let finalGeo = addShedInsetEndPanels(resultGeo, csgChildren, true);
             splitRoofWallBandFaces(finalGeo, csgChildren
-                .filter((child) => shouldIncludeRoofSegmentWallShell(child, roofNode))
+                .filter((child) => shouldIncludeRoofSegmentWallShell(child, roofNode, nodes))
                 .map((child) => ({
                 node: child,
                 inverse: new THREE.Matrix4()
@@ -854,7 +860,7 @@ function getMergedRoofSegmentCacheKey(roofNode, segment, nodes, framing) {
         roofPosition: roofNode.position ?? [0, 0, 0],
         roofRotation: roofNode.rotation ?? 0,
         // a shed's fascia depends on whether its roof is a composite of pieces
-        composite: (roofNode.children?.length ?? 0) > 1,
+        composite: isCompositeRoof(roofNode, nodes),
         segment,
         accessories: getMergedRoofAccessoryCachePayload(segment, nodes),
         framing,
@@ -986,7 +992,15 @@ function readShedOpenEndSides(node) {
         return new Set();
     return new Set(value.filter((side) => side === 'left' || side === 'right'));
 }
-function shouldIncludeRoofSegmentWallShell(node, parentRoof) {
+/**
+ * Whether a roof's shell is pieced from several segments. Its faces of other kinds
+ * (`capabilities.roofs`) are no pieces of it; without the scene, every child counts.
+ */
+function isCompositeRoof(roof, nodes) {
+    const children = roof.children ?? [];
+    return (nodes ? children.filter((id) => nodes[id]?.type === 'roof-segment') : children).length > 1;
+}
+function shouldIncludeRoofSegmentWallShell(node, parentRoof, nodes) {
     if (node.wallShell === 'include')
         return true;
     if (node.wallShell === 'omit')
@@ -996,7 +1010,7 @@ function shouldIncludeRoofSegmentWallShell(node, parentRoof) {
     // Older composite roofs use overlapping shed segments as deck pieces. Their
     // wall volumes were never part of the rendered shell and make CSG grow
     // exponentially when unioned together.
-    return !parentRoof || (parentRoof.children?.length ?? 0) <= 1;
+    return !parentRoof || !isCompositeRoof(parentRoof, nodes);
 }
 function hasSegmentTrim(node) {
     const trim = normalizeRoofSegmentTrim(node);
@@ -1454,14 +1468,14 @@ function buildEaveCuts(node, reach, eave, seal) {
  * one deck (the same pieces whose wall shells are left out), so boards would
  * show between them.
  */
-function wearsFascia(node, parentRoof) {
+function wearsFascia(node, parentRoof, nodes) {
     if (node.fascia !== true)
         return false;
     if (node.roofType !== 'shed')
         return true;
     if (isLeanToShedSegment(node))
         return false;
-    return !parentRoof || (parentRoof.children?.length ?? 0) <= 1;
+    return !parentRoof || !isCompositeRoof(parentRoof, nodes);
 }
 /** What a framed roof's deck keeps over its open structure band at least: a 7/16 in sheet. */
 const ROOF_DECK_KEPT = 0.0111;
@@ -1967,7 +1981,7 @@ export function generateRoofSegmentGeometry(node, nodes, options = {}) {
         return result;
     }
     const brushes = withSegmentUvMatrix(segmentWorldMatrix, () => getRoofSegmentBrushes(node, {
-        fascia: wearsFascia(node, parentRoof),
+        fascia: wearsFascia(node, parentRoof, nodes),
         framing: options.framing ? roofFramingDepth(node) : 0,
     }));
     if (!brushes) {
@@ -1990,7 +2004,7 @@ export function generateRoofSegmentGeometry(node, nodes, options = {}) {
         prepareBrushForCSG(shinDeck);
         let combined = shinDeck;
         let hollowWall = null;
-        if (shouldIncludeRoofSegmentWallShell(node, parentRoof)) {
+        if (shouldIncludeRoofSegmentWallShell(node, parentRoof, nodes)) {
             hollowWall = csgEvaluator.evaluate(wallBrush, innerBrush, SUBTRACTION);
             prepareBrushForCSG(hollowWall);
             combined = csgEvaluator.evaluate(shinDeck, hollowWall, ADDITION);

package/dist/ui/components/action-button.d.ts

@@ -0,0 +1,14 @@
+import * as React from 'react';
+import { Button } from '../primitives/button';
+interface ActionButtonProps extends React.ComponentProps<typeof Button> {
+    label: string;
+    shortcut?: string;
+    isActive?: boolean;
+    tooltipContent?: React.ReactNode;
+    tooltipSide?: 'top' | 'right' | 'bottom' | 'left';
+    /** The tooltip portals to `<body>`, so a button in a themed scope passes the scope here. */
+    tooltipClassName?: string;
+}
+export declare const ActionButton: React.ForwardRefExoticComponent<Omit<ActionButtonProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;
+export {};
+//# sourceMappingURL=action-button.d.ts.map

package/dist/ui/components/action-button.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-button.d.ts","sourceRoot":"","sources":["../../../src/ui/components/action-button.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAG9B,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAI7C,UAAU,iBAAkB,SAAQ,KAAK,CAAC,cAAc,CAAC,OAAO,MAAM,CAAC;IACrE,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,cAAc,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAChC,WAAW,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAA;IACjD,4FAA4F;IAC5F,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED,eAAO,MAAM,YAAY,0GAkExB,CAAA"}