@pascal-app/viewer 1.0.4 → 1.0.6

package/dist/index.d.ts

@@ -19,43 +19,52 @@ 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';
+export { backdropColors, 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 { BLOCK_MASONRY, concreteMaterial, type Masonry, masonryMaterial, STRUCTURE_COLORS, } from './lib/foundation-materials';
+export { preserveGltfUnlit } from './lib/gltf-unlit';
 export { PERF_OVERLAY_ENABLED } from './lib/gpu-perf';
+export { groundWindowBoxNow, groundWindowContains, groundWindowEnabledNode, groundWindowMaskNode, inGroundWindowNode, setGroundWindow, temporarilyGroundWindowForCapture, } from './lib/ground-window';
 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 { configureKtx2Support, ensureKtx2Support, ktx2TextureLoadState } 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 { 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 { applyMaterialPresetToMaterials, BLUEPRINT_PALETTE, baseMaterial, CLAY_PALETTE, type ColorPreset, clearMaterialCache, createDefaultMaterial, createMaterial, createMaterialFromPreset, 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, getMaterialTextureVersion, glassMaterial, MONO_PALETTE, materialCastsShadow, materialTextureLoadState, 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 { hasMaterialsForGroups, markPureRaycast } from './lib/pointer-events';
+export { hasMaterialsForGroups, markPureRaycast, type ViewerBreadcrumb, type ViewerBreadcrumbHandler, } 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 { commitEditCandidates, commitRevealCandidates } from './lib/reveal-candidates';
+export { ANIMATION_SPEEDS, type AnimationSpeed, DEFAULT_ANIMATION_SPEED, FRAMING_PACE, LAZY_REVEAL_BASE_TIMING, LAZY_REVEAL_TIMING, type LazyRevealTiming, lazyTimingAt, normalizeAnimationSpeed, type PlannedReveal, pacedLazyTiming, planLazyReveal, type RevealCandidate, retractTimingAt, revealTimingAt, } from './lib/reveal-schedule';
+export { planRevealWindows, type RevealWindow } from './lib/reveal-windows';
 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, temporarilyShowPresentation, temporarilyShowShadowOnly, } from './lib/scene-visibility';
 export { SCRIPTED_MODEL_FLAG } from './lib/scripted-opening';
+export { SITE_FOUNDATION, SITE_GROUND, type SiteGroundRole, siteFoundation, siteGround, siteSurfaces, temporarilyVeilGround, } from './lib/site-surfaces';
 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 { AMBIANCE_SECONDS, ambianceNow, ambianceTarget, easeAmbiance, eyeUnderTheGround, FADE_SECONDS, groundHoleOpenNode, groundHoleOpenNow, stepAmbianceProgress, temporarilyWithoutAmbiance, UNDERGROUND_RIM, UNDERGROUND_RING, undergroundAmbianceNode, } from './lib/underground-ambiance';
 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 { anyGroundVeiled, applyCountryUnitDefault, DEFAULT_UNDERGROUND_LOOK, default as useViewer, type GroundMode, groundVeiled, type MetricNotation, siteGroundShown, type UndergroundEdge, type UndergroundLook, type UndergroundTransition, type WallMode, } from './store/use-viewer';
 export { CEILING_REGION_MESH, type CeilingRegionMaterial, CeilingSystem, } from './systems/ceiling/ceiling-system';
 export { createColumnBoxGeometry, createColumnCylinderGeometry, createColumnSphereGeometry, createColumnTorusGeometry, } from './systems/column/column-geometry';
+export { ConstructionReveal, type ConstructionRevealDriver, type ConstructionRevealLevel, type ConstructionRevealOptions, emitRevealPuff, getRetractTurn, getRevealPlanSpeed, getRevealPlanState, getRevealTurn, isNodeRevealing, isRevealAssembling, type RetractResult, type RevealCompleteEvent, type RevealEvent, type RevealFinaleEvent, type RevealGroupEvent, type RevealNodeStartEvent, type RevealPhaseEvent, type RevealPlanState, type RevealPreroll, type RevealRetractEvent, retractNodes, revealChangedNodeIds, revealClockMs, revealMotionOff, seatLiftedNow, setRevealPreroll, startConstructionReveal, subscribeRevealAssembling, subscribeRevealEvents, subscribeRevealPhases, subscribeRevealTicks, useRevealPending, useRevealPlanActive, useRevealWaiting, } from './systems/construction-reveal/construction-reveal';
 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';
@@ -66,9 +75,9 @@ export { type ScriptedClipActions, ScriptedClips, useClipActions, } from './syst
 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 { EXPLODED_GAP, getLevelPresentationY, presentLevelsForCapture, snapLevelsToTruePositions, } from './systems/level/level-utils';
 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 { clipDirectRoofGeometryAgainstSiblings, clipGeometryBySegmentTrim, generateRoofSegmentGeometry, getPendingRoofMergeCount, getRoofOuterSurfaceFrameAtPoint, getRoofSegmentBrushes, mapRoofGroupMaterialIndex, ROOF_MATERIAL_SLOT_COUNT, type RoofGeometryAdapter, RoofSystem, remapRoofShellFaces, roofCsgDummyMats, type SurfaceFrame, } from './systems/roof/roof-system';
 export { ScanSystem } from './systems/scan/scan-system';
 export { generateSlabGeometry } from './systems/slab/slab-system';
 export { getStairBodyMaterials, getStairRailingMaterial, getStraightStairSegmentBodyMaterials, type StairBodyMaterials, } from './systems/stair/stair-materials';

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

@@ -27,43 +27,52 @@ 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';
+export { backdropColors, backdropGradient, deepSkyColor, horizonHazeColor } from './lib/backdrop';
 export { applyWorldScaleBoxUVs } from './lib/box-uv';
 // CSG primitives — used by chimney's roof-trim and other kinds whose
 // geometry subtracts pieces against their host. Lives in viewer
 // because three-bvh-csg / three-mesh-bvh are viewer-only deps.
 export { ADDITION, Brush, computeGeometryBoundsTree, csgEvaluator, csgGeometry, csgMaterials, Evaluator, ensureRenderableGeometryAttributes, INTERSECTION, prepareBrushForCSG, SUBTRACTION, } from './lib/csg-utils';
 export { disposeObject3DResources } from './lib/dispose-object3d';
+export { BLOCK_MASONRY, concreteMaterial, masonryMaterial, STRUCTURE_COLORS, } from './lib/foundation-materials';
+export { preserveGltfUnlit } from './lib/gltf-unlit';
 export { PERF_OVERLAY_ENABLED } from './lib/gpu-perf';
+export { groundWindowBoxNow, groundWindowContains, groundWindowEnabledNode, groundWindowMaskNode, inGroundWindowNode, setGroundWindow, temporarilyGroundWindowForCapture, } from './lib/ground-window';
 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 { configureKtx2Support, ensureKtx2Support, ktx2TextureLoadState } 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 { 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 { applyMaterialPresetToMaterials, BLUEPRINT_PALETTE, baseMaterial, CLAY_PALETTE, clearMaterialCache, createDefaultMaterial, createMaterial, createMaterialFromPreset, 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, getMaterialTextureVersion, glassMaterial, MONO_PALETTE, materialCastsShadow, materialTextureLoadState, 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 { hasMaterialsForGroups, 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 { commitEditCandidates, commitRevealCandidates } from './lib/reveal-candidates';
+export { ANIMATION_SPEEDS, DEFAULT_ANIMATION_SPEED, FRAMING_PACE, LAZY_REVEAL_BASE_TIMING, LAZY_REVEAL_TIMING, lazyTimingAt, normalizeAnimationSpeed, pacedLazyTiming, planLazyReveal, retractTimingAt, revealTimingAt, } from './lib/reveal-schedule';
+export { planRevealWindows } from './lib/reveal-windows';
 export { createSceneSupportHeightSampler } from './lib/scene-support-height';
 export { getSceneTheme, SCENE_THEME_IDS, SCENE_THEMES, } from './lib/scene-themes';
 export { hideFromScene, showInScene, temporarilyShowPresentation, temporarilyShowShadowOnly, } from './lib/scene-visibility';
 export { SCRIPTED_MODEL_FLAG } from './lib/scripted-opening';
+export { SITE_FOUNDATION, SITE_GROUND, siteFoundation, siteGround, siteSurfaces, temporarilyVeilGround, } from './lib/site-surfaces';
 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 { AMBIANCE_SECONDS, ambianceNow, ambianceTarget, easeAmbiance, eyeUnderTheGround, FADE_SECONDS, groundHoleOpenNode, groundHoleOpenNow, stepAmbianceProgress, temporarilyWithoutAmbiance, UNDERGROUND_RIM, UNDERGROUND_RING, undergroundAmbianceNode, } from './lib/underground-ambiance';
 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 { anyGroundVeiled, applyCountryUnitDefault, DEFAULT_UNDERGROUND_LOOK, default as useViewer, groundVeiled, siteGroundShown, } from './store/use-viewer';
 export { CEILING_REGION_MESH, CeilingSystem, } from './systems/ceiling/ceiling-system';
 export { createColumnBoxGeometry, createColumnCylinderGeometry, createColumnSphereGeometry, createColumnTorusGeometry, } from './systems/column/column-geometry';
+export { ConstructionReveal, emitRevealPuff, getRetractTurn, getRevealPlanSpeed, getRevealPlanState, getRevealTurn, isNodeRevealing, isRevealAssembling, retractNodes, revealChangedNodeIds, revealClockMs, revealMotionOff, seatLiftedNow, setRevealPreroll, startConstructionReveal, subscribeRevealAssembling, subscribeRevealEvents, subscribeRevealPhases, subscribeRevealTicks, useRevealPending, useRevealPlanActive, useRevealWaiting, } from './systems/construction-reveal/construction-reveal';
 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';
@@ -81,13 +90,13 @@ export { ScriptedClips, useClipActions, } from './systems/interactive/scripted-c
 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 { EXPLODED_GAP, getLevelPresentationY, presentLevelsForCapture, snapLevelsToTruePositions, } from './systems/level/level-utils';
 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
 // belong here — those live in `@pascal-app/nodes/<kind>/`.
-export { clipGeometryBySegmentTrim, generateRoofSegmentGeometry, getRoofOuterSurfaceFrameAtPoint, getRoofSegmentBrushes, mapRoofGroupMaterialIndex, ROOF_MATERIAL_SLOT_COUNT, RoofSystem, remapRoofShellFaces, roofCsgDummyMats, } from './systems/roof/roof-system';
+export { clipDirectRoofGeometryAgainstSiblings, clipGeometryBySegmentTrim, generateRoofSegmentGeometry, getPendingRoofMergeCount, getRoofOuterSurfaceFrameAtPoint, getRoofSegmentBrushes, mapRoofGroupMaterialIndex, ROOF_MATERIAL_SLOT_COUNT, RoofSystem, remapRoofShellFaces, roofCsgDummyMats, } from './systems/roof/roof-system';
 export { ScanSystem } from './systems/scan/scan-system';
 // Pure slab geometry generator — composed into the registry-driven slab
 // definition's `def.geometry` in `@pascal-app/nodes`.

package/dist/lib/backdrop.d.ts

@@ -1,3 +1,20 @@
+import { type ToneMapping } from 'three';
+import type { SceneTheme } from './scene-themes';
+/** Null explicitly removes the gradient; an omitted sky keeps the theme's derived atmosphere. */
+export declare function backdropColors(theme: Pick<SceneTheme, 'background' | 'backgroundSky' | 'appearance'>): {
+    background: string;
+    sky: string;
+    haze: string;
+    skyDeep: string;
+};
+/** Flat authored colours are display colours; only the foreground is exposed and tone mapped. */
+export declare function flatBackdropOutput({ background, foreground, alpha, toneMapping, outputColorSpace, }: {
+    background: any;
+    foreground: any;
+    alpha: any;
+    toneMapping: ToneMapping;
+    outputColorSpace: string;
+}): any;
 /**
  * Shared backdrop gradient: flat background looking down, a warm haze band
  * hugging the horizon, the theme sky arriving just above it and deepening

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

@@ -1 +1 @@
-{"version":3,"file":"backdrop.d.ts","sourceRoot":"","sources":["../../src/lib/backdrop.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,IAAI,EACJ,UAAU,EACV,IAAI,EACJ,GAAG,EACH,OAAO,GACR,EAAE;IACD,IAAI,EAAE,GAAG,CAAA;IACT,UAAU,EAAE,GAAG,CAAA;IACf,IAAI,EAAE,GAAG,CAAA;IACT,GAAG,EAAE,GAAG,CAAA;IACR,OAAO,EAAE,GAAG,CAAA;CACb,GAAG,GAAG,CAUN;AAMD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAWlF;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAyChD"}
+{"version":3,"file":"backdrop.d.ts","sourceRoot":"","sources":["../../src/lib/backdrop.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,WAAW,EAAE,MAAM,OAAO,CAAA;AAEvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAEhD,iGAAiG;AACjG,wBAAgB,cAAc,CAC5B,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,YAAY,GAAG,eAAe,GAAG,YAAY,CAAC;;;;;EASvE;AAED,iGAAiG;AACjG,wBAAgB,kBAAkB,CAAC,EACjC,UAAU,EACV,UAAU,EACV,KAAK,EACL,WAAW,EACX,gBAAgB,GACjB,EAAE;IACD,UAAU,EAAE,GAAG,CAAA;IACf,UAAU,EAAE,GAAG,CAAA;IACf,KAAK,EAAE,GAAG,CAAA;IACV,WAAW,EAAE,WAAW,CAAA;IACxB,gBAAgB,EAAE,MAAM,CAAA;CACzB,GAAG,GAAG,CAIN;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,IAAI,EACJ,UAAU,EACV,IAAI,EACJ,GAAG,EACH,OAAO,GACR,EAAE;IACD,IAAI,EAAE,GAAG,CAAA;IACT,UAAU,EAAE,GAAG,CAAA;IACf,IAAI,EAAE,GAAG,CAAA;IACT,GAAG,EAAE,GAAG,CAAA;IACR,OAAO,EAAE,GAAG,CAAA;CACb,GAAG,GAAG,CAUN;AAMD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAWlF;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAyChD"}

package/dist/lib/backdrop.js

@@ -1,4 +1,21 @@
-import { abs, exp, mix, smoothstep } from 'three/tsl';
+import { NoToneMapping } from 'three';
+import { abs, exp, mix, renderOutput, smoothstep, vec4 } from 'three/tsl';
+/** Null explicitly removes the gradient; an omitted sky keeps the theme's derived atmosphere. */
+export function backdropColors(theme) {
+    const sky = theme.backgroundSky ?? theme.background;
+    return {
+        background: theme.background,
+        sky,
+        haze: theme.backgroundSky === null ? theme.background : horizonHazeColor(sky, theme.appearance),
+        skyDeep: theme.backgroundSky === null ? theme.background : deepSkyColor(sky),
+    };
+}
+/** Flat authored colours are display colours; only the foreground is exposed and tone mapped. */
+export function flatBackdropOutput({ background, foreground, alpha, toneMapping, outputColorSpace, }) {
+    const backdrop = renderOutput(vec4(background, 1), NoToneMapping, outputColorSpace).rgb;
+    const scene = renderOutput(vec4(foreground, 1), toneMapping, outputColorSpace).rgb;
+    return vec4(mix(backdrop, scene, alpha), 1);
+}
 /**
  * Shared backdrop gradient: flat background looking down, a warm haze band
  * hugging the horizon, the theme sky arriving just above it and deepening

package/dist/lib/construction-dust.d.ts

@@ -0,0 +1,57 @@
+import type { Camera, Vector3 } from 'three';
+/**
+ * One pool for every puff on screen; a full pool reuses the oldest sprite. A big agent build
+ * (Victor run 11: 1,545 walls in 6 s) puffs about 2,000 sprites a lifetime.
+ */
+export declare const DUST_CAPACITY = 2048;
+/** A sprite never draws smaller than this on screen, so a whole-building view still shows its dust. */
+export declare const DUST_MIN_PX = 12;
+/** How long a sprite lives, in milliseconds. */
+export declare const DUST_LIFE_MS = 800;
+/**
+ * Construction dust as plain numbers: a fixed ring of sprites, each with its
+ * birth time, start point, velocity and size. Nothing allocates after
+ * construction. The ring order is the birth order, so the slot after the
+ * newest is always the oldest — the one a full pool gives up first.
+ */
+export declare class DustPool {
+    readonly capacity: number;
+    private readonly lifeMs;
+    private readonly born;
+    private readonly data;
+    private next;
+    private warmFrames;
+    private latestMs;
+    private lastEmitMs;
+    constructor(capacity?: number, lifeMs?: number);
+    /** Sprites alive at the latest time the pool has seen. */
+    get live(): number;
+    /** True when nothing emitted within a lifetime of `nowMs` can still be alive: a cheap idle check. */
+    quietAt(nowMs: number): boolean;
+    emit(x: number, y: number, z: number, vx: number, vy: number, vz: number, size: number, nowMs: number): void;
+    /**
+     * Advances to `nowMs`: expired sprites are dropped, and `write` receives
+     * every live one with its current position, size and opacity. Returns how
+     * many are alive.
+     */
+    step(nowMs: number, write: (slot: number, x: number, y: number, z: number, size: number, alpha: number) => void): number;
+    /**
+     * Asks the drawing side for a few frames of one invisible sprite: the first puff of a build would
+     * otherwise pay for the sprite material's first draw in the middle of the walls rising.
+     */
+    requestWarm(frames?: number): void;
+    /** One warm frame, if any is asked for. */
+    takeWarm(): boolean;
+    clear(): void;
+}
+/** A sprite's size in metres at `point`: its own, or DUST_MIN_PX on a screen `heightPx` tall. */
+export declare function dustSpriteSize(size: number, camera: Camera, heightPx: number, point: Vector3): number;
+/** A rising wall's puff: sprites along its base line, pushed out to either side. */
+export declare function emitAlongBase(pool: DustPool, from: Vector3, to: Vector3, nowMs: number): void;
+/**
+ * A landing's puff: sprites around the footprint `corners` (four points of
+ * its base, in order), pushed outwards. `strength` in [0, 1] scales the
+ * cloud, so a crate makes less dust than a column.
+ */
+export declare function emitAroundFoot(pool: DustPool, corners: readonly Vector3[], strength: number, nowMs: number): void;
+//# sourceMappingURL=construction-dust.d.ts.map

package/dist/lib/construction-dust.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"construction-dust.d.ts","sourceRoot":"","sources":["../../src/lib/construction-dust.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAyC,OAAO,EAAE,MAAM,OAAO,CAAA;AAEnF;;;GAGG;AACH,eAAO,MAAM,aAAa,OAAO,CAAA;AACjC,uGAAuG;AACvG,eAAO,MAAM,WAAW,KAAK,CAAA;AAC7B,gDAAgD;AAChD,eAAO,MAAM,YAAY,MAAM,CAAA;AAQ/B;;;;;GAKG;AACH,qBAAa,QAAQ;IACnB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAc;IACnC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAc;IACnC,OAAO,CAAC,IAAI,CAAI;IAChB,OAAO,CAAC,UAAU,CAAI;IACtB,OAAO,CAAC,QAAQ,CAA2B;IAC3C,OAAO,CAAC,UAAU,CAA2B;IAE7C,YAAY,QAAQ,SAAgB,EAAE,MAAM,SAAe,EAK1D;IAED,0DAA0D;IAC1D,IAAI,IAAI,IAAI,MAAM,CAOjB;IAED,qGAAqG;IACrG,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE9B;IAED,IAAI,CACF,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,QAed;IAED;;;;OAIG;IACH,IAAI,CACF,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GAC1F,MAAM,CAsBR;IAED;;;OAGG;IACH,WAAW,CAAC,MAAM,SAAI,QAErB;IAED,2CAA2C;IAC3C,QAAQ,IAAI,OAAO,CAIlB;IAED,KAAK,SAIJ;CACF;AAED,iGAAiG;AACjG,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,UAc5F;AAYD,oFAAoF;AACpF,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,QAsBtF;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,SAAS,OAAO,EAAE,EAC3B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,QA+Cd"}

package/dist/lib/construction-dust.js

@@ -0,0 +1,187 @@
+/**
+ * One pool for every puff on screen; a full pool reuses the oldest sprite. A big agent build
+ * (Victor run 11: 1,545 walls in 6 s) puffs about 2,000 sprites a lifetime.
+ */
+export const DUST_CAPACITY = 2048;
+/** A sprite never draws smaller than this on screen, so a whole-building view still shows its dust. */
+export const DUST_MIN_PX = 12;
+/** How long a sprite lives, in milliseconds. */
+export const DUST_LIFE_MS = 800;
+/** Sprites slow down as the cloud spreads, rise a little, and grow as they thin out. */
+const DRAG_PER_S = 2.2;
+const RISE_M_PER_S = 0.25;
+const GROWTH = 1.8;
+const ALPHA = 0.42;
+/**
+ * Construction dust as plain numbers: a fixed ring of sprites, each with its
+ * birth time, start point, velocity and size. Nothing allocates after
+ * construction. The ring order is the birth order, so the slot after the
+ * newest is always the oldest — the one a full pool gives up first.
+ */
+export class DustPool {
+    capacity;
+    lifeMs;
+    born;
+    data;
+    next = 0;
+    warmFrames = 0;
+    latestMs = Number.NEGATIVE_INFINITY;
+    lastEmitMs = Number.NEGATIVE_INFINITY;
+    constructor(capacity = DUST_CAPACITY, lifeMs = DUST_LIFE_MS) {
+        this.capacity = capacity;
+        this.lifeMs = lifeMs;
+        this.born = new Float64Array(capacity).fill(Number.NEGATIVE_INFINITY);
+        this.data = new Float32Array(capacity * 7);
+    }
+    /** Sprites alive at the latest time the pool has seen. */
+    get live() {
+        let alive = 0;
+        for (let slot = 0; slot < this.capacity; slot += 1) {
+            const age = this.latestMs - this.born[slot];
+            if (age >= 0 && age < this.lifeMs)
+                alive += 1;
+        }
+        return alive;
+    }
+    /** True when nothing emitted within a lifetime of `nowMs` can still be alive: a cheap idle check. */
+    quietAt(nowMs) {
+        return nowMs - this.lastEmitMs >= this.lifeMs;
+    }
+    emit(x, y, z, vx, vy, vz, size, nowMs) {
+        const slot = this.next;
+        this.next = (slot + 1) % this.capacity;
+        this.latestMs = Math.max(this.latestMs, nowMs);
+        this.lastEmitMs = Math.max(this.lastEmitMs, nowMs);
+        this.born[slot] = nowMs;
+        const offset = slot * 7;
+        this.data[offset] = x;
+        this.data[offset + 1] = y;
+        this.data[offset + 2] = z;
+        this.data[offset + 3] = vx;
+        this.data[offset + 4] = vy;
+        this.data[offset + 5] = vz;
+        this.data[offset + 6] = size;
+    }
+    /**
+     * Advances to `nowMs`: expired sprites are dropped, and `write` receives
+     * every live one with its current position, size and opacity. Returns how
+     * many are alive.
+     */
+    step(nowMs, write) {
+        this.latestMs = Math.max(this.latestMs, nowMs);
+        let alive = 0;
+        for (let slot = 0; slot < this.capacity; slot += 1) {
+            const age = nowMs - this.born[slot];
+            if (!(age >= 0 && age < this.lifeMs))
+                continue;
+            const life = age / this.lifeMs;
+            const seconds = age / 1000;
+            // Distance travelled under linear drag: v·(1 − e^(−k·t))/k.
+            const travel = (1 - Math.exp(-DRAG_PER_S * seconds)) / DRAG_PER_S;
+            const offset = slot * 7;
+            write(alive, this.data[offset] + this.data[offset + 3] * travel, this.data[offset + 1] + this.data[offset + 4] * travel + RISE_M_PER_S * seconds, this.data[offset + 2] + this.data[offset + 5] * travel, this.data[offset + 6] * (1 + GROWTH * Math.sqrt(life)), ALPHA * (1 - life) ** 2);
+            alive += 1;
+        }
+        return alive;
+    }
+    /**
+     * Asks the drawing side for a few frames of one invisible sprite: the first puff of a build would
+     * otherwise pay for the sprite material's first draw in the middle of the walls rising.
+     */
+    requestWarm(frames = 3) {
+        this.warmFrames = Math.max(this.warmFrames, frames);
+    }
+    /** One warm frame, if any is asked for. */
+    takeWarm() {
+        if (this.warmFrames <= 0)
+            return false;
+        this.warmFrames -= 1;
+        return true;
+    }
+    clear() {
+        this.born.fill(Number.NEGATIVE_INFINITY);
+        this.next = 0;
+        this.lastEmitMs = Number.NEGATIVE_INFINITY;
+    }
+}
+/** A sprite's size in metres at `point`: its own, or DUST_MIN_PX on a screen `heightPx` tall. */
+export function dustSpriteSize(size, camera, heightPx, point) {
+    const metresPerPx = 'isOrthographicCamera' in camera
+        ? (camera.top - camera.bottom) /
+            camera.zoom /
+            heightPx
+        : 'isPerspectiveCamera' in camera
+            ? (2 *
+                camera.position.distanceTo(point) *
+                Math.tan((camera.fov * Math.PI) / 360)) /
+                camera.zoom /
+                heightPx
+            : 0;
+    return Math.max(size, DUST_MIN_PX * metresPerPx);
+}
+/** A fixed pseudo-random sequence: the same build puffs the same way, and tests stay stable. */
+let seed = 0x2f6b9d1;
+function random() {
+    seed = (Math.imul(seed ^ (seed >>> 15), 0x2c1b3c6d) + 0x6d2b79f5) | 0;
+    return ((seed >>> 0) % 100_000) / 100_000;
+}
+const PUFF_SPACING_M = 0.35;
+const MAX_PUFFS = 16;
+/** A rising wall's puff: sprites along its base line, pushed out to either side. */
+export function emitAlongBase(pool, from, to, nowMs) {
+    const dx = to.x - from.x;
+    const dz = to.z - from.z;
+    const length = Math.hypot(dx, dz);
+    const count = Math.max(3, Math.min(MAX_PUFFS, Math.round(length / PUFF_SPACING_M) + 1));
+    const nx = length > 1e-6 ? -dz / length : 1;
+    const nz = length > 1e-6 ? dx / length : 0;
+    for (let index = 0; index < count; index += 1) {
+        const along = (index + 0.25 + random() * 0.5) / count;
+        const side = random() < 0.5 ? -1 : 1;
+        const speed = 0.35 + random() * 0.45;
+        pool.emit(from.x + dx * along, from.y + (to.y - from.y) * along + 0.05, from.z + dz * along, side * nx * speed + (random() - 0.5) * 0.2, 0.08 + random() * 0.12, side * nz * speed + (random() - 0.5) * 0.2, 0.22 + random() * 0.14, nowMs);
+    }
+}
+/**
+ * A landing's puff: sprites around the footprint `corners` (four points of
+ * its base, in order), pushed outwards. `strength` in [0, 1] scales the
+ * cloud, so a crate makes less dust than a column.
+ */
+export function emitAroundFoot(pool, corners, strength, nowMs) {
+    let cx = 0;
+    let cy = 0;
+    let cz = 0;
+    let perimeter = 0;
+    for (let index = 0; index < corners.length; index += 1) {
+        const a = corners[index];
+        const b = corners[(index + 1) % corners.length];
+        cx += a.x / corners.length;
+        cy += a.y / corners.length;
+        cz += a.z / corners.length;
+        perimeter += Math.hypot(b.x - a.x, b.z - a.z);
+    }
+    const count = Math.max(4, Math.min(MAX_PUFFS, Math.round((perimeter / 0.5) * strength) + 4));
+    for (let index = 0; index < count; index += 1) {
+        // A point on the perimeter, at an even share of its length.
+        let along = ((index + random() * 0.6) / count) * perimeter;
+        let x = cx;
+        let z = cz;
+        for (let edge = 0; edge < corners.length; edge += 1) {
+            const a = corners[edge];
+            const b = corners[(edge + 1) % corners.length];
+            const span = Math.hypot(b.x - a.x, b.z - a.z);
+            if (along <= span || edge === corners.length - 1) {
+                const f = span > 1e-6 ? Math.min(1, along / span) : 0;
+                x = a.x + (b.x - a.x) * f;
+                z = a.z + (b.z - a.z) * f;
+                break;
+            }
+            along -= span;
+        }
+        const ox = x - cx;
+        const oz = z - cz;
+        const reach = Math.hypot(ox, oz) || 1;
+        const speed = (0.3 + random() * 0.4) * (0.5 + strength / 2);
+        pool.emit(x, cy + 0.04, z, (ox / reach) * speed, 0.05 + random() * 0.1, (oz / reach) * speed, (0.14 + random() * 0.12) * (0.6 + strength * 0.4), nowMs);
+    }
+}

package/dist/lib/csg-utils.js

@@ -81,7 +81,7 @@ export function computeGeometryBoundsTree(geometry) {
     ;
     geometry.computeBoundsTree =
         computeBoundsTree;
-    geometry.computeBoundsTree({ maxLeafSize: 10 });
+    geometry.computeBoundsTree({ targetLeafSize: 10 });
 }
 export function prepareBrushForCSG(brush) {
     ensureRenderableGeometryAttributes(brush.geometry);

package/dist/lib/foundation-materials.d.ts

@@ -0,0 +1,26 @@
+import { MeshLambertNodeMaterial } from 'three/webgpu';
+/** The flat colour each structure reads as where only a colour is wanted (the cutaway palette). */
+export declare const STRUCTURE_COLORS: {
+    readonly cmu: "#97978f";
+    readonly concrete: "#8a8a86";
+};
+export type Masonry = {
+    course: number;
+    length: number;
+    joint: number;
+    colors: {
+        light: string;
+        dark: string;
+    };
+    mortar: string;
+};
+export declare const BLOCK_MASONRY: Masonry;
+/**
+ * Courses of running bond: each course half a unit over the one under it, mortar between. The
+ * courses are the world's (`positionWorld.y`), so a wall above a foundation bonds on its courses;
+ * `along` is the metres along the run, the foundation's own attribute by default, a wall's
+ * world-planar U where the geometry has none.
+ */
+export declare function masonryMaterial({ course: courseHeight, length, joint, colors, mortar }: Masonry, along?: any): MeshLambertNodeMaterial;
+export declare function concreteMaterial(): MeshLambertNodeMaterial;
+//# sourceMappingURL=foundation-materials.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"foundation-materials.d.ts","sourceRoot":"","sources":["../../src/lib/foundation-materials.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAA;AAkBtD,mGAAmG;AACnG,eAAO,MAAM,gBAAgB;aAC3B,GAAG;aACH,QAAQ;CACA,CAAA;AAUV,MAAM,MAAM,OAAO,GAAG;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IACvC,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED,eAAO,MAAM,aAAa,EAAE,OAM3B,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,EAChE,KAAK,GAAE,GAA0C,2BAkBlD;AAED,wBAAgB,gBAAgB,4BAO/B"}

package/dist/lib/foundation-materials.js

@@ -0,0 +1,65 @@
+import { FrontSide } from 'three';
+import { attribute, color, float, floor, fract, mix, mod, mx_noise_float, normalLocal, positionWorld, smoothstep, step, vec3, } from 'three/tsl';
+import { MeshLambertNodeMaterial } from 'three/webgpu';
+/**
+ * How bare structure looks: courses of block, and cast concrete. The generic foundation under a
+ * building draws them (nodes `generic-foundation.tsx`), and a wall whose assembly has no cladding
+ * over a masonry or concrete core shows the same on its exterior face (`wall-materials.ts`), so a
+ * basement's walls above grade read as the foundation under them.
+ */
+const INCH = 0.0254;
+/** A nominal 8 × 8 × 16 in block: the course is 8 in with its joint, a block 16 in long. */
+const COURSE = 8 * INCH;
+const BLOCK_LENGTH = 16 * INCH;
+const JOINT = (3 / 8) * INCH;
+const JOINT_SOFTNESS = 0.05;
+const BLOCK_COLORS = { light: '#97978f', dark: '#827f78' };
+const MORTAR_COLOR = '#b5b3aa';
+const CONCRETE_COLORS = { light: '#8a8a86', dark: '#6f6e6a' };
+/** The flat colour each structure reads as where only a colour is wanted (the cutaway palette). */
+export const STRUCTURE_COLORS = {
+    cmu: BLOCK_COLORS.light,
+    concrete: CONCRETE_COLORS.light,
+};
+// TSL's own typings widen a float to a vec4 here, so the pieces are untyped.
+function jointMask(inside, joint) {
+    const edge = joint / 2;
+    return smoothstep(float(edge), float(edge + JOINT_SOFTNESS), inside).mul(smoothstep(float(edge), float(edge + JOINT_SOFTNESS), float(1).sub(inside)));
+}
+export const BLOCK_MASONRY = {
+    course: COURSE,
+    length: BLOCK_LENGTH,
+    joint: JOINT,
+    colors: BLOCK_COLORS,
+    mortar: MORTAR_COLOR,
+};
+/**
+ * Courses of running bond: each course half a unit over the one under it, mortar between. The
+ * courses are the world's (`positionWorld.y`), so a wall above a foundation bonds on its courses;
+ * `along` is the metres along the run, the foundation's own attribute by default, a wall's
+ * world-planar U where the geometry has none.
+ */
+export function masonryMaterial({ course: courseHeight, length, joint, colors, mortar }, along = attribute('along', 'float')) {
+    const material = new MeshLambertNodeMaterial({ side: FrontSide });
+    const rows = positionWorld.y.div(courseHeight);
+    const course = floor(rows);
+    const columns = along.div(length).add(mod(course, 2).mul(0.5));
+    const face = jointMask(fract(rows), joint / courseHeight).mul(jointMask(fract(columns), joint / length));
+    const shade = mx_noise_float(vec3(floor(columns), course, 0.5))
+        .mul(0.5)
+        .add(0.5);
+    const block = mix(color(colors.dark), color(colors.light), shade);
+    const patterned = mix(color(mortar), block, face);
+    // The top of a run is the plain block, whatever course the shader finds there.
+    const flat = step(float(0.5), normalLocal.y.abs());
+    material.colorNode = mix(patterned, block, flat);
+    return material;
+}
+export function concreteMaterial() {
+    const material = new MeshLambertNodeMaterial({ side: FrontSide });
+    const grain = mx_noise_float(positionWorld.mul(vec3(2.5, 2.5, 2.5)))
+        .mul(0.5)
+        .add(0.5);
+    material.colorNode = mix(color(CONCRETE_COLORS.dark), color(CONCRETE_COLORS.light), grain);
+    return material;
+}

package/dist/lib/gltf-unlit.d.ts

@@ -0,0 +1,10 @@
+import type { Material, Object3D } from 'three';
+export declare function importedUnlitMaterial(material: Material | null): boolean;
+/** Native basic materials still use AO; imported unlit assets already own their lighting. */
+export declare function preserveGltfUnlit(): {
+    name: string;
+    afterRoot({ scenes }: {
+        scenes: Object3D[];
+    }): null;
+};
+//# sourceMappingURL=gltf-unlit.d.ts.map

package/dist/lib/gltf-unlit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gltf-unlit.d.ts","sourceRoot":"","sources":["../../src/lib/gltf-unlit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAQ,QAAQ,EAAE,MAAM,OAAO,CAAA;AAErD,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,GAAG,OAAO,CAExE;AAED,6FAA6F;AAC7F,wBAAgB,iBAAiB;IAE7B,IAAI;IACJ,SAAS,aAAa;QAAE,MAAM,EAAE,QAAQ,EAAE,CAAA;KAAE;EAa/C"}