@pascal-app/viewer 1.0.3 → 1.0.4

package/dist/index.d.ts

@@ -1,17 +1,18 @@
 export type { SurfaceRole } from '@pascal-app/core';
 export { ErrorBoundary } from './components/error-boundary';
 export { NodeRenderer } from './components/renderers/node-renderer';
-export { default as Viewer, type ViewerHandle, type ViewerImmersiveSession, } from './components/viewer';
+export { default as Viewer, pendingSceneBuildCount, type ViewerHandle, type ViewerImmersiveSession, } from './components/viewer';
 export { type BVHEcctrlApi, default as BVHEcctrl, type MovementInput, } from './components/viewer/bvh-ecctrl';
 export { buildGlbInteractiveItems, GlbInteractive, type GlbInteractiveItem, } from './components/viewer/glb-interactive';
 export { buildGlbReferenceNodes, buildGlbReplaceNodes, } from './components/viewer/glb-reference-nodes';
-export { type GlbHover, type GlbIdentity, type GlbLevel, GlbScene, type GlbWalkthrough, } from './components/viewer/glb-scene';
+export { type GlbPickEvent, GlbScene, type GlbWalkthrough, resolveGlbPick, } 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 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 { claimSceneGround, SceneGroundReplacement, useSceneGroundReplacement, } from './components/viewer/scene-ground-replacement';
+export { applyWalkthroughCameraClipping } from './components/viewer/viewer-camera';
 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';
@@ -21,43 +22,52 @@ export { ASSETS_CDN_URL, resolveAssetUrl, resolveCdnUrl } from './lib/asset-url'
 export { backdropGradient, deepSkyColor, horizonHazeColor } from './lib/backdrop';
 export { applyWorldScaleBoxUVs } from './lib/box-uv';
 export { ADDITION, Brush, computeGeometryBoundsTree, csgEvaluator, csgGeometry, csgMaterials, Evaluator, ensureRenderableGeometryAttributes, INTERSECTION, prepareBrushForCSG, SUBTRACTION, } from './lib/csg-utils';
+export type { DisplayState } from './lib/display-state';
 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, refreshIsolation, } from './lib/isolation';
+export { setKeyLightDirectionOverride } from './lib/key-light-override';
 export { configureKtx2Support, ensureKtx2Support } from './lib/ktx2-loader';
 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 { holdLiveFrame } from './lib/live-frame-hold';
+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, materialCastsShadow, PRESET_PALETTES, type RenderShading, registerMaterialCacheCleanup, resolveMaterialRef, resolveSlotDefaultMaterial, resolveSurfaceColor, setSlotDefaultOverrides, WHITE_PALETTE, } from './lib/materials';
 export { mergedOutline } from './lib/merged-outline-node';
+export { createNodeTopSurfaceHeightSampler } from './lib/node-top-surface-height';
 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 { hasMaterialsForGroups, markPureRaycast } from './lib/pointer-events';
+export { cloneWithProceduralEmission, decorateProceduralEmission, proceduralSlotMeshes, setProceduralEmission, } from './lib/procedural-emission';
 export { detectRendererCapability, initializeGpuRenderer, type RendererBackendParameters, type RendererCapability, type RendererCapabilityCanvas, type RendererInitializationResult, type RendererPowerPreference, } from './lib/renderer-capability';
+export { createSceneSupportHeightSampler } from './lib/scene-support-height';
 export { getSceneTheme, SCENE_THEME_IDS, SCENE_THEMES, type SceneTheme, } from './lib/scene-themes';
-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 { type HiddenReason, hideFromScene, showInScene, temporarilyShowPresentation, temporarilyShowShadowOnly, } from './lib/scene-visibility';
+export { SCRIPTED_MODEL_FLAG } from './lib/scripted-opening';
+export { createPlainSnapshotPipeline, createSnapshotPipeline, SNAPSHOT_MAX_EDGE, SNAPSHOT_MIME, SNAPSHOT_QUALITY, type SnapshotCaptureMode, type SnapshotCaptureResult, type SnapshotCropRegion, type SnapshotPipeline, type SnapshotSize, type StudioBackdrop, 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';
 export { packNormalToRGB, unpackRGBToNormal } from './lib/tsl-compat';
-export { useItemLightPool } from './store/use-item-light-pool';
+export { createZoneShape, createZoneWallGeometry } from './lib/zone-geometry';
+export type { LightSource } from './store/use-item-light-pool';
+export { catalogLightSource, useItemLightPool } from './store/use-item-light-pool';
 export { applyCountryUnitDefault, default as useViewer, type MetricNotation, type WallMode, } from './store/use-viewer';
-export { CeilingSystem } from './systems/ceiling/ceiling-system';
+export { CEILING_REGION_MESH, type CeilingRegionMaterial, CeilingSystem, } from './systems/ceiling/ceiling-system';
 export { createColumnBoxGeometry, createColumnCylinderGeometry, createColumnSphereGeometry, createColumnTorusGeometry, } from './systems/column/column-geometry';
 export { DoorAnimationSystem } from './systems/door/door-animation-system';
 export { buildDoorPreviewMesh, DoorSystem, poseDoorMovingParts } from './systems/door/door-system';
 export { ElevatorInteractionSystem } from './systems/elevator/elevator-interaction-system';
-export { FenceSystem, generateFenceGeometry, generateFenceSlotGeometries, } from './systems/fence/fence-system';
 export { FloorElevationSystem } from './systems/floor-elevation/floor-elevation-system';
 export { GuideSystem } from './systems/guide/guide-system';
 export { InteractiveSystem } from './systems/interactive/interactive-system';
+export { type ScriptedClipActions, ScriptedClips, useClipActions, } from './systems/interactive/scripted-clips';
 export { ItemSystem } from './systems/item/item-system';
 export { ItemLightSystem } from './systems/item-light/item-light-system';
 export { LevelSystem } from './systems/level/level-system';
 export { EXPLODED_GAP, getLevelPresentationY, snapLevelsToTruePositions, } from './systems/level/level-utils';
-export { getRoofMaterialArray } from './systems/roof/roof-materials';
+export { getRoofMaterialArray, levelWallCladdingRef } 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';
 export { generateSlabGeometry } from './systems/slab/slab-system';
@@ -66,6 +76,7 @@ export { StairSystem } from './systems/stair/stair-system';
 export { buildOpeningCutoutGeometry, buildOpeningCutoutShape, getOpeningCutoutBottomPadding, hasFlatOpeningCutoutBottom, } from './systems/wall/opening-cutout-geometry';
 export { getWallHideState, WallCutout } from './systems/wall/wall-cutout';
 export { WallCutoutCache, type WallCutoutViewerState, type WallCutoutViewerStore, } from './systems/wall/wall-cutout-cache';
+export { getWallFaceBaseAt, getWallFinishData, getWallFinishRefs, type WallFinishGeometryData, } from './systems/wall/wall-finish-data';
 export { getMaterialsForWall, getVisibleWallMaterials, type WallMaterialOverride, type WallMaterials, type WallMaterialsResolver, } from './systems/wall/wall-materials';
 export { drainRebuiltWalls, generateExtrudedWall, getPendingWallRebuildCount, isWallInitialBuildActive, runWallBuildFrame, type WallGeometryAdapter, type WallGeometryAdapterContext, WallSystem, } from './systems/wall/wall-system';
 export { poseWindowMovingParts, WindowAnimationSystem, } from './systems/window/window-animation-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

@@ -10,16 +10,17 @@ export { ErrorBoundary } from './components/error-boundary';
 // `@pascal-app/nodes/<kind>/renderer.tsx` and are loaded by the registry
 // — no per-kind re-exports needed.
 export { NodeRenderer } from './components/renderers/node-renderer';
-export { default as Viewer, } from './components/viewer';
+export { default as Viewer, pendingSceneBuildCount, } from './components/viewer';
 export { default as BVHEcctrl, } from './components/viewer/bvh-ecctrl';
 export { buildGlbInteractiveItems, GlbInteractive, } from './components/viewer/glb-interactive';
 export { buildGlbReferenceNodes, buildGlbReplaceNodes, } from './components/viewer/glb-reference-nodes';
-export { GlbScene, } from './components/viewer/glb-scene';
+export { GlbScene, resolveGlbPick, } 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 { claimSceneGround, SceneGroundReplacement, useSceneGroundReplacement, } from './components/viewer/scene-ground-replacement';
+export { applyWalkthroughCameraClipping } from './components/viewer/viewer-camera';
 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';
@@ -36,33 +37,36 @@ 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, refreshIsolation, } from './lib/isolation';
+export { setKeyLightDirectionOverride } from './lib/key-light-override';
 export { configureKtx2Support, ensureKtx2Support } from './lib/ktx2-loader';
 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 { holdLiveFrame } from './lib/live-frame-hold';
+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, materialCastsShadow, PRESET_PALETTES, registerMaterialCacheCleanup, resolveMaterialRef, resolveSlotDefaultMaterial, resolveSurfaceColor, setSlotDefaultOverrides, WHITE_PALETTE, } from './lib/materials';
 export { mergedOutline } from './lib/merged-outline-node';
+export { createNodeTopSurfaceHeightSampler } from './lib/node-top-surface-height';
 export * from './lib/perf-actions';
 export { publishPerfBatchStats } from './lib/perf-panel-store';
 export * from './lib/perf-tracks';
-export { markPureRaycast } from './lib/pointer-events';
+export { hasMaterialsForGroups, markPureRaycast } from './lib/pointer-events';
+export { cloneWithProceduralEmission, decorateProceduralEmission, proceduralSlotMeshes, setProceduralEmission, } from './lib/procedural-emission';
 export { detectRendererCapability, initializeGpuRenderer, } from './lib/renderer-capability';
+export { createSceneSupportHeightSampler } from './lib/scene-support-height';
 export { getSceneTheme, SCENE_THEME_IDS, SCENE_THEMES, } from './lib/scene-themes';
-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 { hideFromScene, showInScene, temporarilyShowPresentation, temporarilyShowShadowOnly, } from './lib/scene-visibility';
+export { SCRIPTED_MODEL_FLAG } from './lib/scripted-opening';
+export { createPlainSnapshotPipeline, 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';
 export { packNormalToRGB, unpackRGBToNormal } from './lib/tsl-compat';
-export { useItemLightPool } from './store/use-item-light-pool';
+export { createZoneShape, createZoneWallGeometry } from './lib/zone-geometry';
+export { catalogLightSource, useItemLightPool } from './store/use-item-light-pool';
 export { applyCountryUnitDefault, default as useViewer, } from './store/use-viewer';
-export { CeilingSystem } from './systems/ceiling/ceiling-system';
+export { CEILING_REGION_MESH, CeilingSystem, } from './systems/ceiling/ceiling-system';
 export { createColumnBoxGeometry, createColumnCylinderGeometry, createColumnSphereGeometry, createColumnTorusGeometry, } from './systems/column/column-geometry';
 export { DoorAnimationSystem } from './systems/door/door-animation-system';
 export { buildDoorPreviewMesh, DoorSystem, poseDoorMovingParts } from './systems/door/door-system';
 export { ElevatorInteractionSystem } from './systems/elevator/elevator-interaction-system';
-// Fence system follows the wall re-export pattern — composed into the
-// registry-driven fence definition's `def.system`. Removed in Phase 6
-// alongside the legacy fence mount point.
-export { FenceSystem, generateFenceGeometry, generateFenceSlotGeometries, } from './systems/fence/fence-system';
 // Generic floor-elevation system. Lifts the rendered mesh of any kind
 // whose definition declares `capabilities.floorPlaced` by the slab
 // elevation under its footprint. Replaces the per-kind elevation block
@@ -70,6 +74,7 @@ export { FenceSystem, generateFenceGeometry, generateFenceSlotGeometries, } from
 export { FloorElevationSystem } from './systems/floor-elevation/floor-elevation-system';
 export { GuideSystem } from './systems/guide/guide-system';
 export { InteractiveSystem } from './systems/interactive/interactive-system';
+export { ScriptedClips, useClipActions, } from './systems/interactive/scripted-clips';
 // Item systems for the registry-driven item definition. ItemSystem
 // applies attachTo-driven transforms each frame; ItemLightSystem
 // manages item-mounted light sources.
@@ -77,7 +82,7 @@ export { ItemSystem } from './systems/item/item-system';
 export { ItemLightSystem } from './systems/item-light/item-light-system';
 export { LevelSystem } from './systems/level/level-system';
 export { EXPLODED_GAP, getLevelPresentationY, snapLevelsToTruePositions, } from './systems/level/level-utils';
-export { getRoofMaterialArray } from './systems/roof/roof-materials';
+export { getRoofMaterialArray, levelWallCladdingRef } 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)
 // read these through the public surface. No kind-specific helpers
@@ -95,6 +100,7 @@ export { StairSystem } from './systems/stair/stair-system';
 export { buildOpeningCutoutGeometry, buildOpeningCutoutShape, getOpeningCutoutBottomPadding, hasFlatOpeningCutoutBottom, } from './systems/wall/opening-cutout-geometry';
 export { getWallHideState, WallCutout } from './systems/wall/wall-cutout';
 export { WallCutoutCache, } from './systems/wall/wall-cutout-cache';
+export { getWallFaceBaseAt, getWallFinishData, getWallFinishRefs, } from './systems/wall/wall-finish-data';
 export { getMaterialsForWall, getVisibleWallMaterials, } from './systems/wall/wall-materials';
 // Wall internals re-exported so `@pascal-app/nodes`' registry-driven wall
 // definition can compose them into `def.system` without duplicating the

package/dist/lib/asset-url.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"asset-url.d.ts","sourceRoot":"","sources":["../../src/lib/asset-url.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,cAAc,QAAwE,CAAA;AAEnG;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgB5F;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAiB3E"}
+{"version":3,"file":"asset-url.d.ts","sourceRoot":"","sources":["../../src/lib/asset-url.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,cAAc,QAAwE,CAAA;AAEnG;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAkB5F;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAoB3E"}

package/dist/lib/asset-url.js

@@ -1,4 +1,4 @@
-import { loadAssetUrl } from '@pascal-app/core';
+import { loadAssetUrl, resolveArtifactUrl } from '@pascal-app/core';
 export const ASSETS_CDN_URL = process.env.NEXT_PUBLIC_ASSETS_CDN_URL || 'https://editor.pascal.app';
 /**
  * Resolves an asset URL to the appropriate format:
@@ -10,6 +10,8 @@ export const ASSETS_CDN_URL = process.env.NEXT_PUBLIC_ASSETS_CDN_URL || 'https:/
 export async function resolveAssetUrl(url) {
     if (!url)
         return null;
+    if (url.startsWith('artifact://'))
+        return resolveArtifactUrl(url);
     // External URL - use as-is
     if (url.startsWith('http://') || url.startsWith('https://')) {
         return url;
@@ -29,6 +31,10 @@ export async function resolveAssetUrl(url) {
 export function resolveCdnUrl(url) {
     if (!url)
         return null;
+    if (url.startsWith('artifact://'))
+        return resolveArtifactUrl(url);
+    if (url.startsWith('blob:'))
+        return url;
     // External URL - use as-is
     if (url.startsWith('http://') || url.startsWith('https://')) {
         return url;

package/dist/lib/display-state.d.ts

@@ -0,0 +1,25 @@
+import type { Discipline, DisplayFamily, DisplayMode } from '@pascal-app/core';
+/**
+ * Personal display state (F4, owner decision O3, frozen): kept per project in
+ * this browser like `showScans`, never shared with collaborators and never a
+ * geometry edit. Additive to `levelMode` / `wallMode`, which keep their
+ * meaning. It composes through a `display` layer-hold reason and never
+ * touches `object.visible`. Inside it `isolate` wins over `families`, which
+ * win over the mode default. "Save look" writes the project default to
+ * `site.presentation` (core `SitePresentation`); the canonical bake is
+ * independent of both. Not wired into the viewer store yet.
+ */
+export type DisplayState = {
+    mode: DisplayMode;
+    families?: Partial<Record<DisplayFamily, boolean>>;
+    disciplines: Record<Discipline, boolean>;
+    xray: boolean;
+    /** 0..1 presentation offset. */
+    separation: number;
+    colorBy: 'material' | 'service';
+    isolate?: {
+        kind: 'system' | 'owner';
+        id: string;
+    };
+};
+//# sourceMappingURL=display-state.d.ts.map

package/dist/lib/display-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display-state.d.ts","sourceRoot":"","sources":["../../src/lib/display-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAE9E;;;;;;;;;GASG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,WAAW,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAA;IAClD,WAAW,EAAE,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,CAAA;IACxC,IAAI,EAAE,OAAO,CAAA;IACb,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,UAAU,GAAG,SAAS,CAAA;IAC/B,OAAO,CAAC,EAAE;QAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAA;CACnD,CAAA"}

package/dist/lib/display-state.js

@@ -0,0 +1 @@
+export {};

package/dist/lib/hero-pose.d.ts

@@ -1,6 +1,6 @@
 import { Box3 } from 'three';
 export declare const DEFAULT_FRAMING_EXCLUDED_TYPES: readonly ["site", "scan", "guide", "spawn"];
-export declare function heroCameraPose({ boxes, aspect, aim, fovDeg, azimuthRad, elevationRad, padding, minDistance, frameShift, }: {
+export declare function heroCameraPose({ boxes, aspect, aim, fovDeg, azimuthRad, elevationRad, padding, minDistance, frameShift, tightFit, }: {
     boxes: Box3 | readonly Box3[];
     aspect: number;
     /** Where the camera looks (frame center). Defaults to the union-box center;
@@ -16,6 +16,11 @@ export declare function heroCameraPose({ boxes, aspect, aim, fovDeg, azimuthRad,
     /** Fraction of the frustum half-height to drop the aim by. 0 keeps the aim
      *  (the building center) exactly at frame center. */
     frameShift?: number;
+    /** Fit the PROJECTED extents instead of a symmetric fit around `aim`: the
+     *  aim may drift off-center so the subject fills the frame. A symmetric fit
+     *  pins the nearest corner to one edge and leaves the far side empty, since
+     *  far corners project smaller. */
+    tightFit?: boolean;
 }): {
     position: [number, number, number];
     target: [number, number, number];
@@ -30,6 +35,8 @@ export type HeroFraming = {
     aim: [number, number, number];
     /** 45° to the dominant facade (falls back to world 45°). */
     azimuthRad: number;
+    /** Items left out of `boxes` because they sit away from the structure. */
+    detachedItemIds: string[];
 };
 /**
  * Framing for a scene hero shot. The base set is the built structure (walls,
@@ -42,6 +49,9 @@ export type HeroFraming = {
  * structure (pure furniture arrangements) fall back to framing every
  * non-helper node.
  */
-export declare function computeHeroFraming(): HeroFraming | null;
+export declare function computeHeroFraming({ sitePlates, }?: {
+    /** false frames the built structure only, ignoring shaped site plates. */
+    sitePlates?: boolean;
+}): HeroFraming | null;
 export declare function temporarilyHideNodeTypes(types: readonly string[]): () => void;
 //# sourceMappingURL=hero-pose.d.ts.map

package/dist/lib/hero-pose.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hero-pose.d.ts","sourceRoot":"","sources":["../../src/lib/hero-pose.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAA0B,MAAM,OAAO,CAAA;AAEpD,eAAO,MAAM,8BAA8B,6CAA8C,CAAA;AAEzF,wBAAgB,cAAc,CAAC,EAC7B,KAAK,EACL,MAAM,EACN,GAAG,EACH,MAAW,EACX,UAAwB,EACxB,YAAmC,EACnC,OAAc,EACd,WAAe,EACf,UAAc,GACf,EAAE;IACD,KAAK,EAAE,IAAI,GAAG,SAAS,IAAI,EAAE,CAAA;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd;;;qDAGiD;IACjD,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;yDACqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,GAAG;IACF,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAClC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC,CA2DA;AAED,wBAAgB,yBAAyB,CAAC,EACxC,YAAY,GACb,EAAE;IACD,YAAY,EAAE,SAAS,MAAM,EAAE,CAAA;CAChC,GAAG,IAAI,GAAG,IAAI,CAgBd;AAiFD,MAAM,MAAM,WAAW,GAAG;IACxB,4DAA4D;IAC5D,KAAK,EAAE,IAAI,EAAE,CAAA;IACb,wEAAwE;IACxE,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7B,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAA;CACnB,CAAA;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,IAAI,WAAW,GAAG,IAAI,CAuCvD;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,IAAI,CAiB7E"}
+{"version":3,"file":"hero-pose.d.ts","sourceRoot":"","sources":["../../src/lib/hero-pose.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAA0B,MAAM,OAAO,CAAA;AAEpD,eAAO,MAAM,8BAA8B,6CAA8C,CAAA;AAEzF,wBAAgB,cAAc,CAAC,EAC7B,KAAK,EACL,MAAM,EACN,GAAG,EACH,MAAW,EACX,UAAwB,EACxB,YAAmC,EACnC,OAAc,EACd,WAAe,EACf,UAAc,EACd,QAAgB,GACjB,EAAE;IACD,KAAK,EAAE,IAAI,GAAG,SAAS,IAAI,EAAE,CAAA;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd;;;qDAGiD;IACjD,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;yDACqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;uCAGmC;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,GAAG;IACF,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAClC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC,CAgHA;AAED,wBAAgB,yBAAyB,CAAC,EACxC,YAAY,GACb,EAAE;IACD,YAAY,EAAE,SAAS,MAAM,EAAE,CAAA;CAChC,GAAG,IAAI,GAAG,IAAI,CAgBd;AAiFD,MAAM,MAAM,WAAW,GAAG;IACxB,4DAA4D;IAC5D,KAAK,EAAE,IAAI,EAAE,CAAA;IACb,wEAAwE;IACxE,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7B,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAA;IAClB,0EAA0E;IAC1E,eAAe,EAAE,MAAM,EAAE,CAAA;CAC1B,CAAA;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,UAAiB,GAClB,GAAE;IACD,0EAA0E;IAC1E,UAAU,CAAC,EAAE,OAAO,CAAA;CAChB,GAAG,WAAW,GAAG,IAAI,CAgD1B;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,IAAI,CAiB7E"}

package/dist/lib/hero-pose.js

@@ -1,7 +1,7 @@
 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, }) {
+export function heroCameraPose({ boxes, aspect, aim, fovDeg = 60, azimuthRad = Math.PI / 4, elevationRad = (13 * Math.PI) / 180, padding = 1.03, minDistance = 4, frameShift = 0, tightFit = false, }) {
     const list = Array.isArray(boxes) ? boxes : [boxes];
     const union = new Box3();
     for (const box of list)
@@ -37,6 +37,62 @@ export function heroCameraPose({ boxes, aspect, aim, fovDeg = 60, azimuthRad = M
             }
         }
     }
+    if (tightFit) {
+        // Every corner as (lateral, vertical, depth) around `center`. For a camera
+        // distance d, a shift (sx, sy) of aim+camera along right/up keeps a corner
+        // in frame iff |lateral − sx| ≤ tanH·(d + depth) (same vertically), so each
+        // corner bounds the feasible shift window; the tightest d whose windows
+        // still intersect is the fit, bisected from the symmetric distance.
+        const samples = [];
+        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]) {
+                        offset.subVectors(corner.set(x, y, z), center);
+                        samples.push([offset.dot(right), offset.dot(up), offset.dot(forward)]);
+                    }
+                }
+            }
+        }
+        const tanH = tanHorizontal / padding;
+        const tanV = tanVertical / padding;
+        const shiftWindow = (d) => {
+            let loX = Number.NEGATIVE_INFINITY;
+            let hiX = Number.POSITIVE_INFINITY;
+            let loY = Number.NEGATIVE_INFINITY;
+            let hiY = Number.POSITIVE_INFINITY;
+            for (const [lateral, vertical, depth] of samples) {
+                const z = d + depth;
+                if (z <= 0.1)
+                    return null;
+                loX = Math.max(loX, lateral - tanH * z);
+                hiX = Math.min(hiX, lateral + tanH * z);
+                loY = Math.max(loY, vertical - tanV * z);
+                hiY = Math.min(hiY, vertical + tanV * z);
+            }
+            return loX <= hiX && loY <= hiY ? { sx: (loX + hiX) / 2, sy: (loY + hiY) / 2 } : null;
+        };
+        let lo = minDistance;
+        let hi = distance;
+        while (!shiftWindow(hi))
+            hi *= 1.5;
+        for (let i = 0; i < 40; i++) {
+            const mid = (lo + hi) / 2;
+            if (shiftWindow(mid))
+                hi = mid;
+            else
+                lo = mid;
+        }
+        const shift = shiftWindow(hi);
+        const target = center
+            .clone()
+            .addScaledVector(right, shift.sx)
+            .addScaledVector(up, shift.sy - frameShift * hi * tanVertical);
+        return {
+            position: [target.x + dir.x * hi, target.y + dir.y * hi, target.z + dir.z * hi],
+            target: [target.x, target.y, target.z],
+        };
+    }
     // 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);
@@ -166,7 +222,7 @@ function dominantWallYaw() {
  * structure (pure furniture arrangements) fall back to framing every
  * non-helper node.
  */
-export function computeHeroFraming() {
+export function computeHeroFraming({ sitePlates = true, } = {}) {
     const structural = perNodeBoxes([...DEFAULT_FRAMING_EXCLUDED_TYPES, 'item', 'building', 'level']);
     if (structural.length === 0) {
         const all = perNodeBoxes([...DEFAULT_FRAMING_EXCLUDED_TYPES, 'building', 'level']);
@@ -176,12 +232,17 @@ export function computeHeroFraming() {
         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 };
+        return {
+            boxes: all,
+            aim: [center.x, center.y, center.z],
+            azimuthRad: Math.PI / 4,
+            detachedItemIds: [],
+        };
     }
     const structuralUnion = new Box3();
     for (const box of structural)
         structuralUnion.union(box);
-    const plates = sitePlateBoxes();
+    const plates = sitePlates ? sitePlateBoxes() : [];
     const groundUnion = structuralUnion.clone();
     for (const box of plates)
         groundUnion.union(box);
@@ -189,14 +250,19 @@ export function computeHeroFraming() {
         .clone()
         .expandByVector(groundUnion.getSize(new Vector3()).multiplyScalar(0.15));
     const boxes = [...structural, ...plates];
+    const detachedItemIds = [];
     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))
+        if (bounds.isEmpty())
+            continue;
+        if (nearby.intersectsBox(bounds))
             boxes.push(bounds);
+        else
+            detachedItemIds.push(id);
     }
     const groundCenter = groundUnion.getCenter(new Vector3());
     const structuralCenter = structuralUnion.getCenter(new Vector3());
@@ -205,6 +271,7 @@ export function computeHeroFraming() {
         boxes,
         aim: [groundCenter.x, structuralCenter.y, groundCenter.z],
         azimuthRad: Math.PI / 4 - (yaw ?? 0),
+        detachedItemIds,
     };
 }
 export function temporarilyHideNodeTypes(types) {

package/dist/lib/ink-edges.d.ts

@@ -1,5 +1,7 @@
-export declare function inkedEdges({ depthTex, normalTex, inkColor, radius, opacity, sceneRgb, }: {
-    depthTex: any;
+import type { Camera } from 'three';
+export declare function createEdgeDepthSampler(depthTex: any, camera: Camera): (uv: any) => any;
+export declare function inkedEdges({ sampleDepth, normalTex, inkColor, radius, opacity, sceneRgb, }: {
+    sampleDepth: (uv: any) => any;
     normalTex: any;
     inkColor: any;
     radius: number;

package/dist/lib/ink-edges.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ink-edges.d.ts","sourceRoot":"","sources":["../../src/lib/ink-edges.ts"],"names":[],"mappings":"AAoBA,wBAAgB,UAAU,CAAC,EACzB,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,MAAM,EACN,OAAO,EACP,QAAQ,GACT,EAAE;IACD,QAAQ,EAAE,GAAG,CAAA;IACb,SAAS,EAAE,GAAG,CAAA;IACd,QAAQ,EAAE,GAAG,CAAA;IAKb,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,GAAG,CAAA;IACZ,QAAQ,EAAE,GAAG,CAAA;CACd,OAsCA"}
+{"version":3,"file":"ink-edges.d.ts","sourceRoot":"","sources":["../../src/lib/ink-edges.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAqB,MAAM,OAAO,CAAA;AAkBtD,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,QACd,GAAG,SAYxD;AAkBD,wBAAgB,UAAU,CAAC,EACzB,WAAW,EACX,SAAS,EACT,QAAQ,EACR,MAAM,EACN,OAAO,EACP,QAAQ,GACT,EAAE;IACD,WAAW,EAAE,CAAC,EAAE,EAAE,GAAG,KAAK,GAAG,CAAA;IAC7B,SAAS,EAAE,GAAG,CAAA;IACd,QAAQ,EAAE,GAAG,CAAA;IAKb,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,GAAG,CAAA;IACZ,QAAQ,EAAE,GAAG,CAAA;CACd,OAsCA"}

package/dist/lib/ink-edges.js

@@ -1,5 +1,15 @@
-import { abs, float, max, min, mix, screenSize, screenUV, smoothstep, vec2 } from 'three/tsl';
+import { abs, float, max, min, mix, perspectiveDepthToViewZ, screenSize, screenUV, smoothstep, uniform, vec2, viewZToPerspectiveDepth, } from 'three/tsl';
 import { unpackRGBToNormal } from './tsl-compat';
+export function createEdgeDepthSampler(depthTex, camera) {
+    if (!('isPerspectiveCamera' in camera))
+        return (uv) => depthTex.sample(uv).r;
+    const perspective = camera;
+    const near = uniform(perspective.near).onRenderUpdate(() => perspective.near);
+    const far = uniform(perspective.far).onRenderUpdate(() => perspective.far);
+    // Ink and AO thresholds were calibrated at near 0.1 / far 1000. Keep
+    // their world distances when orbit, walkthrough or capture clipping changes.
+    return (uv) => viewZToPerspectiveDepth(perspectiveDepthToViewZ(depthTex.sample(uv).r, near, far), float(0.1), float(1000));
+}
 // Screen-space ink outline (SketchUp / Moebius look). Reads the scene-pass
 // depth + normal MRT and inks two signals:
 //
@@ -16,14 +26,14 @@ import { unpackRGBToNormal } from './tsl-compat';
 // Topology-agnostic: works on CSG triangle soup, organic GLBs, anything — it
 // only sees the rendered buffers. `intensity` scales the final mask; `inkColor`
 // should track the background luminance (dark lines on light scenes).
-export function inkedEdges({ depthTex, normalTex, inkColor, radius, opacity, sceneRgb, }) {
+export function inkedEdges({ sampleDepth, normalTex, inkColor, radius, opacity, sceneRgb, }) {
     const px = vec2(1, 1).div(screenSize).mul(radius);
     const uvN = screenUV;
-    const dC = depthTex.sample(uvN).r;
-    const dR = depthTex.sample(uvN.add(vec2(px.x, 0))).r;
-    const dL = depthTex.sample(uvN.sub(vec2(px.x, 0))).r;
-    const dU = depthTex.sample(uvN.add(vec2(0, px.y))).r;
-    const dD = depthTex.sample(uvN.sub(vec2(0, px.y))).r;
+    const dC = sampleDepth(uvN);
+    const dR = sampleDepth(uvN.add(vec2(px.x, 0)));
+    const dL = sampleDepth(uvN.sub(vec2(px.x, 0)));
+    const dU = sampleDepth(uvN.add(vec2(0, px.y)));
+    const dD = sampleDepth(uvN.sub(vec2(0, px.y)));
     const depthLap = abs(dR.add(dL).add(dU).add(dD).sub(dC.mul(4)));
     const invDepth = float(1).sub(dC);
     const depthMetric = depthLap.div(invDepth.mul(invDepth).add(float(0.00002)));

package/dist/lib/key-light-override.d.ts

@@ -0,0 +1,11 @@
+import type { Vector3Tuple } from 'three';
+/**
+ * Aims the key (shadow-casting) light along a world direction, ahead of the
+ * theme or atmosphere source. For captures that compose their own camera —
+ * the worker thumbnail sets the sun relative to its hero angle so shadows
+ * read instead of falling straight behind the building. `null` restores the
+ * theme/atmosphere direction.
+ */
+export declare function setKeyLightDirectionOverride(direction: Vector3Tuple | null): void;
+export declare function getKeyLightDirectionOverride(): Vector3Tuple | null;
+//# sourceMappingURL=key-light-override.d.ts.map

package/dist/lib/key-light-override.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-light-override.d.ts","sourceRoot":"","sources":["../../src/lib/key-light-override.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AAIzC;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,YAAY,GAAG,IAAI,QAE1E;AAED,wBAAgB,4BAA4B,IAAI,YAAY,GAAG,IAAI,CAElE"}

package/dist/lib/key-light-override.js

@@ -0,0 +1,14 @@
+let keyLightDirection = null;
+/**
+ * Aims the key (shadow-casting) light along a world direction, ahead of the
+ * theme or atmosphere source. For captures that compose their own camera —
+ * the worker thumbnail sets the sun relative to its hero angle so shadows
+ * read instead of falling straight behind the building. `null` restores the
+ * theme/atmosphere direction.
+ */
+export function setKeyLightDirectionOverride(direction) {
+    keyLightDirection = direction;
+}
+export function getKeyLightDirectionOverride() {
+    return keyLightDirection;
+}

package/dist/lib/live-frame-hold.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Holds the viewport's LAST presented frame on screen while a capture works
+ * on the shared scene: the frame loop keeps ticking (useFrame systems still
+ * run, a capture can pump frames by hand) but the live draw is skipped, so
+ * whatever a capture swaps in for its own renders — a presentation flip, a
+ * hidden ground, an override material held across a GPU readback — never
+ * reaches the canvas.
+ *
+ * Holds nest; each one expires on its own after `maxMs` so a capture that
+ * never settles cannot freeze the viewport for the session.
+ */
+export declare function holdLiveFrame(maxMs?: number): () => void;
+export declare function isLiveFrameHeld(): boolean;
+//# sourceMappingURL=live-frame-hold.d.ts.map

package/dist/lib/live-frame-hold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-frame-hold.d.ts","sourceRoot":"","sources":["../../src/lib/live-frame-hold.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,wBAAgB,aAAa,CAAC,KAAK,SAAS,GAAG,MAAM,IAAI,CAWxD;AAED,wBAAgB,eAAe,IAAI,OAAO,CAEzC"}

package/dist/lib/live-frame-hold.js

@@ -0,0 +1,28 @@
+/**
+ * Holds the viewport's LAST presented frame on screen while a capture works
+ * on the shared scene: the frame loop keeps ticking (useFrame systems still
+ * run, a capture can pump frames by hand) but the live draw is skipped, so
+ * whatever a capture swaps in for its own renders — a presentation flip, a
+ * hidden ground, an override material held across a GPU readback — never
+ * reaches the canvas.
+ *
+ * Holds nest; each one expires on its own after `maxMs` so a capture that
+ * never settles cannot freeze the viewport for the session.
+ */
+let holds = 0;
+export function holdLiveFrame(maxMs = 60_000) {
+    holds += 1;
+    let released = false;
+    const release = () => {
+        if (released)
+            return;
+        released = true;
+        clearTimeout(expiry);
+        holds -= 1;
+    };
+    const expiry = setTimeout(release, maxMs);
+    return release;
+}
+export function isLiveFrameHeld() {
+    return holds > 0;
+}