@3driseai/3drise-viewer 0.1.26 → 0.1.27

package/dist/types/terrainConfigs.js

@@ -1,292 +1,2 @@
-/**
- * Config shapes for the procedural terrain system that lives in this package.
- *
- * Declared locally rather than in `@3driseai/3drise-core`, alongside
- * `cloudConfigs.ts` and `gridConfigs.ts`, because the material and the renderer
- * are here and nothing outside the viewer needs to construct these by hand.
- *
- * Core's `TerrainSettings` is the retired flat shape (`visible` +
- * `displacementScale`) and is deliberately left alone: a saved project still
- * carries it, and `normalizeTerrain` below is what turns one into nothing rather
- * than into a mountain range the scene was never authored with.
- *
- * A terrain is ONE landform model with per-type shaping, not four renderers —
- * the same way three of the four cloud types share one marcher. What separates
- * mountains from dunes is the operator applied to the fBm and the numbers around
- * it, so the type is a config field the shader branches on.
- */
-// -----------------------------------------------------------------------------
-// Defaults
-// -----------------------------------------------------------------------------
-const surfaceBase = {
-    elevation: 1200,
-    seaLevel: 0,
-    featureSize: 2600,
-    octaves: 9,
-    lacunarity: 2.06,
-    gain: 0.52,
-    ridgeSharpness: 0.62,
-    warpStrength: 0.28,
-    warpSize: 0.6,
-    erosion: 0.7,
-    terraces: 0,
-    terraceSharpness: 0.6,
-    bearing: 78,
-    duneWavelength: 320,
-    duneAsymmetry: 0.6,
-    plateau: 0,
-    valleyDepth: 0,
-    valleyWidth: 0.25,
-    lowColor: '#4a4636',
-    midColor: '#6b6248',
-    rockColor: '#6a6259',
-    peakColor: '#eef1f6',
-    slopeRockStart: 0.35,
-    slopeRockEnd: 0.62,
-    peakLevel: 0.62,
-    peakBlend: 0.12,
-    peakSlopeFalloff: 1.4,
-    macroVariation: 0.22,
-    macroSize: 2400,
-    detailStrength: 0.45,
-    detailSize: 9,
-    roughness: 0.82,
-    specular: 0.06,
-    ambient: 1,
-    bounce: 0.35,
-    sunShadow: 1,
-    shadowSoftness: 12,
-    aerialPerspective: 0.00007,
-};
-export const defaultMountainsConfig = {
-    ...surfaceBase,
-    type: 'terrain',
-    terrainType: 'mountains',
-    preset: '',
-    enabled: true,
-};
-export const defaultHillsConfig = {
-    ...surfaceBase,
-    type: 'terrain',
-    terrainType: 'hills',
-    preset: '',
-    enabled: true,
-    elevation: 300,
-    featureSize: 2200,
-    octaves: 8,
-    gain: 0.46,
-    ridgeSharpness: 0.05,
-    warpStrength: 0.35,
-    erosion: 0.45,
-    lowColor: '#3f5326',
-    midColor: '#55663a',
-    rockColor: '#7a7266',
-    peakColor: '#8d9a6a',
-    slopeRockStart: 0.5,
-    slopeRockEnd: 0.78,
-    peakLevel: 0.78,
-    peakBlend: 0.2,
-    macroVariation: 0.3,
-    macroSize: 1400,
-    detailStrength: 0.5,
-    detailSize: 6,
-    roughness: 0.9,
-    specular: 0.03,
-    aerialPerspective: 0.00009,
-};
-export const defaultDunesConfig = {
-    ...surfaceBase,
-    type: 'terrain',
-    terrainType: 'dunes',
-    preset: '',
-    enabled: true,
-    elevation: 150,
-    featureSize: 3000,
-    octaves: 6,
-    gain: 0.42,
-    ridgeSharpness: 0.15,
-    warpStrength: 0.2,
-    warpSize: 0.8,
-    erosion: 0.2,
-    duneWavelength: 340,
-    duneAsymmetry: 0.62,
-    lowColor: '#b08a53',
-    midColor: '#d6b077',
-    rockColor: '#9c7a4c',
-    peakColor: '#f0dcb4',
-    slopeRockStart: 0.62,
-    slopeRockEnd: 0.9,
-    peakLevel: 0.7,
-    peakBlend: 0.24,
-    peakSlopeFalloff: 0.6,
-    macroVariation: 0.14,
-    macroSize: 3600,
-    detailStrength: 0.3,
-    detailSize: 3.5,
-    roughness: 0.55,
-    specular: 0.16,
-    ambient: 1.1,
-    bounce: 0.55,
-    shadowSoftness: 22,
-    aerialPerspective: 0.00008,
-};
-export const defaultCanyonConfig = {
-    ...surfaceBase,
-    type: 'terrain',
-    terrainType: 'canyon',
-    preset: '',
-    enabled: true,
-    elevation: 700,
-    featureSize: 2600,
-    octaves: 8,
-    gain: 0.48,
-    ridgeSharpness: 0.3,
-    warpStrength: 0.18,
-    erosion: 0.85,
-    terraces: 14,
-    terraceSharpness: 0.72,
-    plateau: 0.55,
-    valleyDepth: 0.8,
-    valleyWidth: 0.22,
-    lowColor: '#7a4a30',
-    midColor: '#a4643c',
-    rockColor: '#c07a4a',
-    peakColor: '#d9a877',
-    slopeRockStart: 0.28,
-    slopeRockEnd: 0.5,
-    peakLevel: 0.72,
-    peakBlend: 0.08,
-    peakSlopeFalloff: 0.9,
-    macroVariation: 0.26,
-    macroSize: 1800,
-    detailStrength: 0.4,
-    detailSize: 7,
-    roughness: 0.86,
-    specular: 0.05,
-    shadowSoftness: 8,
-    aerialPerspective: 0.000075,
-};
-export const defaultTerrainQuality = {
-    levels: 9,
-    segments: 128,
-    cellSize: 2,
-    curvature: 1 / (2 * 6371000),
-    shadowSteps: 12,
-    shadowDistance: 5000,
-    detailFadeDistance: 1200,
-    receiveShadows: true,
-    exposure: 1,
-    wireframe: false,
-};
-/** Per-type defaults, for the controller's type switcher. */
-export const TERRAIN_DEFAULTS = {
-    mountains: defaultMountainsConfig,
-    dunes: defaultDunesConfig,
-    hills: defaultHillsConfig,
-    canyon: defaultCanyonConfig,
-};
-export const TERRAIN_SCHEMA = [
-    { key: 'elevation', label: 'Elevation', group: 'form', min: 5, max: 6000, step: 5, unit: 'm', description: 'Peak height above sea level. Every height-keyed splat threshold is a fraction of this, so raising it does not move the snow line.' },
-    { key: 'seaLevel', label: 'Sea level', group: 'form', min: -2000, max: 2000, step: 5, unit: 'm', description: 'World Y the terrain is built around — where flat ground sits, and where a placed object meets it.' },
-    { key: 'featureSize', label: 'Feature size', group: 'form', min: 200, max: 40000, step: 50, unit: 'm', description: 'Horizontal size of the primary landform. The one knob that decides whether this reads as a mountain range or a gravel pile.' },
-    { key: 'octaves', label: 'Octaves', group: 'form', min: 3, max: 12, step: 1, description: 'fBm detail levels. Past ~10 the extra octaves are finer than the closest clipmap cell and only cost; distant rings drop them automatically.' },
-    { key: 'lacunarity', label: 'Lacunarity', group: 'form', min: 1.7, max: 2.6, step: 0.01, advanced: true, description: 'Frequency step per octave. Slightly off 2.0 breaks the grid alignment that otherwise shows as a faint square lattice.' },
-    { key: 'gain', label: 'Gain', group: 'form', min: 0.25, max: 0.72, step: 0.005, description: 'Amplitude step per octave. Below 0.5 smooth and rolling, above it jagged and fractal.' },
-    { key: 'ridgeSharpness', label: 'Ridge sharpness', group: 'form', min: 0, max: 1, step: 0.005, description: '0 gives rounded billow hills, 1 knife ridges. The strongest single cue between a mountain and a dune field.' },
-    { key: 'warpStrength', label: 'Domain warp', group: 'form', min: 0, max: 1, step: 0.005, description: 'Bends ridge lines into curved, branching shapes. At 0 the silhouette reads as noise rather than landscape.' },
-    { key: 'warpSize', label: 'Warp size', group: 'form', min: 0.1, max: 2, step: 0.01, advanced: true, description: 'Scale of the warp field relative to feature size. Above ~1 it drifts the terrain instead of bending it.' },
-    { key: 'erosion', label: 'Erosion', group: 'form', min: 0, max: 1, step: 0.005, description: 'Damps octaves where slope is already steep — flattens valley floors, sharpens flanks. The cheapest approximation of erosion there is.' },
-    { key: 'terraces', label: 'Strata', group: 'form', min: 0, max: 40, step: 1, types: ['canyon', 'mountains'], description: 'Sedimentary banding step count. 0 is off. Most of what makes a mesa read as a mesa.' },
-    { key: 'terraceSharpness', label: 'Strata hardness', group: 'form', min: 0, max: 1, step: 0.01, types: ['canyon', 'mountains'], description: '0 is a smooth ramp between bands, 1 a near-vertical riser.' },
-    { key: 'plateau', label: 'Plateau', group: 'form', min: 0, max: 1, step: 0.005, types: ['canyon'], description: 'Fraction of the height range flattened into mesa tops.' },
-    { key: 'valleyDepth', label: 'Incision depth', group: 'form', min: 0, max: 1.5, step: 0.005, types: ['canyon'], description: 'Depth of the carved channel network as a fraction of elevation. At 0 the mesas have nothing between them.' },
-    { key: 'valleyWidth', label: 'Incision width', group: 'form', min: 0.03, max: 1, step: 0.005, types: ['canyon'], description: 'Narrow cuts slot canyons; wide ones cut broad washes.' },
-    { key: 'bearing', label: 'Wind bearing', group: 'form', min: 0, max: 360, step: 1, unit: 'deg', types: ['dunes'], description: 'Dunes are transverse to the wind, so this rotates the whole crest train.' },
-    { key: 'duneWavelength', label: 'Dune wavelength', group: 'form', min: 40, max: 2000, step: 5, unit: 'm', types: ['dunes'], description: 'Crest-to-crest distance of the dune train.' },
-    { key: 'duneAsymmetry', label: 'Slip face', group: 'form', min: 0, max: 1, step: 0.005, types: ['dunes'], description: 'Lee-slope steepening. At 0 the dunes are sine waves; real ones have a long windward ramp and a short face at the angle of repose.' },
-    { key: 'slopeRockStart', label: 'Rock from slope', group: 'surface', min: 0, max: 1, step: 0.005, description: 'Slope at which rock starts showing through. Splatting rock by slope rather than height is what makes a cliff read as a cliff at any altitude.' },
-    { key: 'slopeRockEnd', label: 'Bare rock at slope', group: 'surface', min: 0, max: 1, step: 0.005, description: 'Slope at which the surface is fully bare rock.' },
-    { key: 'peakLevel', label: 'Peak line', group: 'surface', min: 0, max: 1, step: 0.005, description: 'Height fraction where the peak layer (snow, salt, bleached stone) begins.' },
-    { key: 'peakBlend', label: 'Peak blend', group: 'surface', min: 0.01, max: 0.5, step: 0.005, description: 'Width of that transition. A hard line is physically right for temperature but reads as a decal.' },
-    { key: 'peakSlopeFalloff', label: 'Peak slope falloff', group: 'surface', min: 0, max: 3, step: 0.01, description: 'Peak coverage lost per unit slope. Snow does not sit on a vertical face; without this a summit looks dipped in paint.' },
-    { key: 'macroVariation', label: 'Macro variation', group: 'surface', min: 0, max: 1, step: 0.005, description: 'Large-scale albedo break-up. Without it a splat layer is one flat colour across kilometres and reads as untextured.' },
-    { key: 'macroSize', label: 'Macro size', group: 'surface', min: 200, max: 12000, step: 50, unit: 'm', description: 'Size of that variation.' },
-    { key: 'detailStrength', label: 'Detail bump', group: 'surface', min: 0, max: 1.5, step: 0.005, description: 'High-frequency normal detail added per fragment — bumps far below the mesh resolution.' },
-    { key: 'detailSize', label: 'Detail size', group: 'surface', min: 0.5, max: 60, step: 0.25, unit: 'm', description: 'Size of that detail. Below about a metre it aliases before it fades.' },
-    { key: 'roughness', label: 'Roughness', group: 'surface', min: 0.05, max: 1, step: 0.005, description: 'Widens the specular lobe. Rock is nearly matte; wet sand and snow are not.' },
-    { key: 'specular', label: 'Specular', group: 'surface', min: 0, max: 1, step: 0.005, description: 'Specular strength. The grazing sheen on sand at low sun comes from here.' },
-    { key: 'ambient', label: 'Ambient', group: 'lighting', min: 0, max: 3, step: 0.01, description: 'Sky-dome fill, taken from the same atmosphere the sky and clouds use, so it darkens and warms as the sun sets instead of freezing.' },
-    { key: 'bounce', label: 'Ground bounce', group: 'lighting', min: 0, max: 2, step: 0.01, description: 'Fill on downward-facing surfaces, tinted by the low colour. Keeps overhangs and north faces off pure black.' },
-    { key: 'sunShadow', label: 'Self shadow', group: 'lighting', min: 0, max: 1, step: 0.01, description: 'Strength of the analytic shadow marched down the sun vector. This is what puts a mountain shadow in its own valley, with no shadow-map resolution to run out of.' },
-    { key: 'shadowSoftness', label: 'Shadow softness', group: 'lighting', min: 1, max: 60, step: 0.5, description: 'Penumbra width of that shadow. Larger reads as a hazier day.' },
-    { key: 'aerialPerspective', label: 'Aerial perspective', group: 'lighting', min: 0, max: 0.0004, step: 0.000002, unit: '1/m', description: 'Rate distant terrain fades into the sky behind it. The main cue for how large the landscape reads, and what makes the horizon a horizon rather than a cut-out.' },
-];
-export const TERRAIN_QUALITY_SCHEMA = [
-    { key: 'levels', label: 'Clipmap levels', group: 'quality', min: 2, max: 12, step: 1, description: 'Each ring doubles its cell size, so visible radius is roughly cellSize x segments x 2^(levels-1). 9 levels of 192 at 2 m reaches ~98 km, which is past where haze has dissolved the ground.' },
-    { key: 'segments', label: 'Ring resolution', group: 'quality', min: 32, max: 320, step: 8, description: 'Grid resolution per ring side, and the one knob that sets how polygonal the terrain looks: a clipmap triangle subtends about 2/segments radians whatever the distance, so 192 is roughly 12 px at 1080p. Vertex cost is levels x segments^2 x 0.75, since every ring above the first is hollow.' },
-    { key: 'cellSize', label: 'Cell size', group: 'quality', min: 0.25, max: 32, step: 0.25, unit: 'm', description: 'Finest cell, at the camera. Lower it for a walkable scene, raise it for a flyover.' },
-    { key: 'shadowSteps', label: 'Shadow steps', group: 'quality', min: 0, max: 48, step: 1, description: 'Steps in the analytic sun-shadow march, nearest the camera. 0 disables terrain self-shadowing entirely, which is the single biggest thing you can turn off; below ~12 long shadows at low sun start to leak.' },
-    { key: 'shadowDistance', label: 'Shadow distance', group: 'quality', min: 0, max: 40000, step: 100, unit: 'm', description: 'Range over which the self-shadow fades out. The march runs per vertex, so lowering this drops whole clipmap rings out of it — the cheapest quality dial there is after turning shadows off.' },
-    { key: 'detailFadeDistance', label: 'Detail fade distance', group: 'quality', min: 50, max: 8000, step: 25, unit: 'm', description: 'Distance over which fragment-stage bump fades out. Removes far-field shimmer and buys back most of its own cost.' },
-    { key: 'curvature', label: 'Planetary curvature', group: 'quality', min: 0, max: 0.0000012, step: 0.00000001, advanced: true, description: '1/(2R). Drops the surface with the square of distance so it meets a real horizon. Zero gives a flat world, which at these extents looks wrong long before it looks flat.' },
-    { key: 'exposure', label: 'Exposure', group: 'quality', min: 0.2, max: 4, step: 0.01, description: 'Radiance scale, so terrain matches the sky and clouds whether or not the cloud composite is what tonemaps the frame.' },
-];
-export const defaultProceduralTerrainSettings = {
-    id: '3drise-terrain',
-    type: 'terrain',
-    config: { ...defaultHillsConfig, enabled: false },
-    quality: { ...defaultTerrainQuality },
-};
-// =============================================================================
-// Normalisation
-// =============================================================================
-//
-// A published scene loads whatever was in the database the day it was saved, and
-// a scene saved before this system existed carries core's flat TerrainSettings
-// (`visible` + `displacementScale`) under the same key. Reading that straight
-// into the renderer is how an embed dies: the clipmap sizes its rings from
-// `quality.segments` on its first frame.
-//
-// Each block merges over its own defaults SEPARATELY, not through one merge over
-// the settings object, so a quality edit does not hand the surface a new config
-// object and rebuild the clipmap geometry.
-const TERRAIN_TYPES = ['mountains', 'dunes', 'hills', 'canyon'];
-const isRecord = (v) => typeof v === 'object' && v !== null;
-/**
- * Surface block merged over its type's defaults, or null when there is nothing to
- * render — including the retired flat shape, which has no `config` and must draw
- * nothing rather than a landscape the project was never authored with.
- *
- * An unknown or missing `terrainType` falls back to hills rather than rendering
- * nothing: a scene that says `enabled: true` should show ground.
- */
-export function normalizeTerrain(raw) {
-    if (!isRecord(raw))
-        return null;
-    const terrainType = TERRAIN_TYPES.includes(raw.terrainType)
-        ? raw.terrainType
-        : 'hills';
-    return {
-        ...TERRAIN_DEFAULTS[terrainType],
-        ...raw,
-        type: 'terrain',
-        terrainType,
-    };
-}
-export function normalizeTerrainQuality(raw) {
-    return { ...defaultTerrainQuality, ...(isRecord(raw) ? raw : {}) };
-}
-/**
- * A whole settings blob, from a project of any age. The flat legacy shape has no
- * `config`, so it normalises to a disabled terrain rather than to a default one.
- */
-export function normalizeTerrainSettings(raw) {
-    const source = isRecord(raw) ? raw : {};
-    const config = normalizeTerrain(source.config);
-    return {
-        id: typeof source.id === 'string' ? source.id : defaultProceduralTerrainSettings.id,
-        type: 'terrain',
-        config: config ?? { ...defaultHillsConfig, enabled: false },
-        quality: normalizeTerrainQuality(source.quality),
-    };
-}
+// Moved to @3driseai/3drise-core (src/environment/terrainConfigs.ts). Re-exported for existing viewer imports.
+export { TERRAIN_DEFAULTS, TERRAIN_QUALITY_SCHEMA, TERRAIN_SCHEMA, defaultCanyonConfig, defaultDunesConfig, defaultHillsConfig, defaultMountainsConfig, defaultProceduralTerrainSettings, defaultTerrainQuality, normalizeTerrain, normalizeTerrainQuality, normalizeTerrainSettings, } from '@3driseai/3drise-core';

package/dist/utils/cloudUniforms.d.ts

@@ -1,5 +1,5 @@
 import * as THREE from 'three';
-import type { CloudDeckConfig, CirrusLayerConfig, CloudsQualityConfig, ThunderConfig } from '../types/cloudConfigs';
+import type { CloudDeckConfig, CirrusLayerConfig, CloudsQualityConfig, ThunderConfig } from '@3driseai/3drise-core';
 import type { CloudSunState } from '../hooks/useCloudSun';
 export declare function applyDeckUniforms(material: THREE.ShaderMaterial, deck: CloudDeckConfig, quality: CloudsQualityConfig): void;
 /**

package/dist/utils/configAnimations.d.ts

@@ -40,4 +40,10 @@ export declare function applyConfigMouseMove(properties: MouseMoveProperty[] | u
 export declare function hasConfigOverrides(override: ConfigOverride): boolean;
 /** Merge overrides into a config, returning the original when nothing is driving it. */
 export declare function resolveConfig<T extends object>(config: T, ...overrides: (ConfigOverride | undefined)[]): T;
+/**
+ * The committed config laid over the type's defaults, skipping explicit `undefined`
+ * (a controller writing a cleared field), so every knob has a value to render and for a
+ * keyframe or pointer binding to interpolate from.
+ */
+export declare function withConfigDefaults<D extends object, C extends object>(defaults: D, config: C | undefined | null): D & C;
 //# sourceMappingURL=configAnimations.d.ts.map

package/dist/utils/configAnimations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"configAnimations.d.ts","sourceRoot":"","sources":["../../src/utils/configAnimations.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAEjF;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;AAE7D,yFAAyF;AACzF,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;AAEhE;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CACzC,UAAU,EAAE,gBAAgB,EAAE,GAAG,SAAS,EAC1C,WAAW,EAAE,iBAAiB,EAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,QAAQ,EAAE,cAAc,EACxB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GAC9B,IAAI,CAqBN;AAED,mFAAmF;AACnF,wBAAgB,oBAAoB,CAChC,UAAU,EAAE,iBAAiB,EAAE,GAAG,SAAS,EAC3C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EACjC,OAAO,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GAC9B,IAAI,CAYN;AAED,oDAAoD;AACpD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAGpE;AAED,wFAAwF;AACxF,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,SAAS,EAAE,CAAC,cAAc,GAAG,SAAS,CAAC,EAAE,GAAG,CAAC,CAK1G"}
+{"version":3,"file":"configAnimations.d.ts","sourceRoot":"","sources":["../../src/utils/configAnimations.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAEjF;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;AAE7D,yFAAyF;AACzF,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;AAEhE;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CACzC,UAAU,EAAE,gBAAgB,EAAE,GAAG,SAAS,EAC1C,WAAW,EAAE,iBAAiB,EAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,QAAQ,EAAE,cAAc,EACxB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GAC9B,IAAI,CAqBN;AAED,mFAAmF;AACnF,wBAAgB,oBAAoB,CAChC,UAAU,EAAE,iBAAiB,EAAE,GAAG,SAAS,EAC3C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EACjC,OAAO,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GAC9B,IAAI,CAYN;AAED,oDAAoD;AACpD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAGpE;AAED,wFAAwF;AACxF,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,SAAS,EAAE,CAAC,cAAc,GAAG,SAAS,CAAC,EAAE,GAAG,CAAC,CAK1G;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,SAAS,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAMvH"}

package/dist/utils/configAnimations.js

@@ -71,3 +71,17 @@ export function resolveConfig(config, ...overrides) {
         return config;
     return Object.assign({}, config, ...overrides.filter(Boolean));
 }
+/**
+ * The committed config laid over the type's defaults, skipping explicit `undefined`
+ * (a controller writing a cleared field), so every knob has a value to render and for a
+ * keyframe or pointer binding to interpolate from.
+ */
+export function withConfigDefaults(defaults, config) {
+    const out = { ...defaults };
+    if (config) {
+        for (const [k, v] of Object.entries(config))
+            if (v !== undefined)
+                out[k] = v;
+    }
+    return out;
+}

package/dist/utils/gridConfig.d.ts

@@ -0,0 +1,19 @@
+import type * as THREE from 'three';
+/** Numeric uniforms every grid material has, named u_<key>. */
+export declare const GRID_SURFACE_NUMERIC: readonly ["cellSize", "lineWidth", "sectionSize", "sectionWidth", "lineMode", "cellMode", "animSpeed", "animScale", "animIntensity", "fadeStrength", "displace", "bgOpacity"];
+/** Colour uniforms every grid material has (THREE.Color values). */
+export declare const GRID_SURFACE_COLORS: readonly ["lineColor", "sectionColor", "cellColor", "glowColor", "bgColor"];
+/**
+ * Knobs that reshape the plane or pick a mode — never driven per frame. `displace`
+ * is here because the plane is only subdivided when it is > 0 at commit time, and
+ * `sectionSize` because it is a whole number of cells per accent group.
+ */
+export declare const GRID_STRUCTURAL: readonly ["size", "flat", "segments", "displace", "lineMode", "cellMode", "sectionSize"];
+/** A uniform computed from the config (a clamp, a rounding, an enum index, a bool as 0/1). */
+export type GridDerive = Readonly<Record<string, (c: Record<string, any>) => number>>;
+/**
+ * @param variant the grid's own numeric knobs, each pushed as-is to u_<key>
+ * @param derive  the grid's computed uniforms: u_<key> = derive[key](config)
+ */
+export declare function applyGridConfig(material: THREE.ShaderMaterial | null | undefined, c: Record<string, any>, variant: readonly string[], derive?: GridDerive): void;
+//# sourceMappingURL=gridConfig.d.ts.map

package/dist/utils/gridConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gridConfig.d.ts","sourceRoot":"","sources":["../../src/utils/gridConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAkBpC,+DAA+D;AAC/D,eAAO,MAAM,oBAAoB,+KAGvB,CAAC;AAEX,oEAAoE;AACpE,eAAO,MAAM,mBAAmB,6EAA8E,CAAC;AAE/G;;;;GAIG;AACH,eAAO,MAAM,eAAe,0FAA2F,CAAC;AAIxH,8FAA8F;AAC9F,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC;AAEtF;;;GAGG;AACH,wBAAgB,eAAe,CAC3B,QAAQ,EAAE,KAAK,CAAC,cAAc,GAAG,IAAI,GAAG,SAAS,EACjD,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACtB,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,MAAM,GAAE,UAAe,GACxB,IAAI,CASN"}

package/dist/utils/gridConfig.js

@@ -0,0 +1,52 @@
+// =============================================================================
+// applyGridConfig — the one push point for the shader-plane grids
+// =============================================================================
+//
+// Every grid shares the GridSurfaceConfig vocabulary, and every material names its
+// uniforms `u_<configKey>`, so one function pushes any grid's config: the shared
+// surface knobs, the colours, plus the variant's own numeric knobs. Both the
+// committed config (on mount / on commit) and the per-frame merged config
+// (committed + live drag + keyframes + pointer, via useConfigDriver) go through
+// here, so the two can never disagree about how a knob reaches the shader.
+//
+// What is *not* here: time, pointer NDC, focus and reveal — those are the host's,
+// driven by useGridSurface — and `size` / `flat` / `segments`, which shape the
+// plane geometry in JSX.
+//
+/** Numeric uniforms every grid material has, named u_<key>. */
+export const GRID_SURFACE_NUMERIC = [
+    'cellSize', 'lineWidth', 'sectionSize', 'sectionWidth', 'lineMode', 'cellMode',
+    'animSpeed', 'animScale', 'animIntensity', 'fadeStrength', 'displace', 'bgOpacity',
+];
+/** Colour uniforms every grid material has (THREE.Color values). */
+export const GRID_SURFACE_COLORS = ['lineColor', 'sectionColor', 'cellColor', 'glowColor', 'bgColor'];
+/**
+ * Knobs that reshape the plane or pick a mode — never driven per frame. `displace`
+ * is here because the plane is only subdivided when it is > 0 at commit time, and
+ * `sectionSize` because it is a whole number of cells per accent group.
+ */
+export const GRID_STRUCTURAL = ['size', 'flat', 'segments', 'displace', 'lineMode', 'cellMode', 'sectionSize'];
+/**
+ * @param variant the grid's own numeric knobs, each pushed as-is to u_<key>
+ * @param derive  the grid's computed uniforms: u_<key> = derive[key](config)
+ */
+export function applyGridConfig(material, c, variant, derive = {}) {
+    const u = material?.uniforms;
+    if (!u)
+        return;
+    for (const k of GRID_SURFACE_NUMERIC)
+        if (u['u_' + k] && c[k] !== undefined)
+            u['u_' + k].value = c[k];
+    for (const k of variant)
+        if (u['u_' + k] && c[k] !== undefined)
+            u['u_' + k].value = c[k];
+    for (const k in derive)
+        if (u['u_' + k])
+            u['u_' + k].value = derive[k](c);
+    // a pointer binding hands back a THREE.Color, the config a hex string: set() takes both
+    for (const k of GRID_SURFACE_COLORS)
+        if (u['u_' + k] && c[k] !== undefined)
+            u['u_' + k].value.set(c[k]);
+    if (u.u_fadeDistance)
+        u.u_fadeDistance.value = c.fadeDistance ?? c.size * 0.5;
+}

package/dist/utils/handleCloudsAnimations.d.ts

@@ -1,5 +1,5 @@
 import type { AnimationOptions, MouseMoveProperty } from '@3driseai/3drise-core';
-import type { CloudDeckConfig } from '../types/cloudConfigs';
+import type { CloudDeckConfig } from '@3driseai/3drise-core';
 export type CloudPropertyOverride = Partial<Record<string, number>>;
 /** Cache of the value a property started at, so `from`-less keyframes have an origin. */
 export type CloudStartValues = Record<string, number>;

package/dist/utils/handleCloudsAnimations.js

@@ -1,5 +1,5 @@
 import { calculateTimeProgress, applyEasing, gsapEasingMap, interpolateValue, interpolateMouseMoveProperty, } from '@3driseai/3drise-core';
-import { CLOUD_ANIMATABLE_PROPERTIES } from '../types/cloudConfigs.js';
+import { CLOUD_ANIMATABLE_PROPERTIES } from '@3driseai/3drise-core';
 /**
  * The `clouds` animation and mouse-move domains, applied to a deck config.
  *

package/dist/utils/hasHoverAnimation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hasHoverAnimation.d.ts","sourceRoot":"","sources":["../../src/utils/hasHoverAnimation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,gBAAgB,GAAG,SAAS,GAAG,OAAO,CAcnF"}
+{"version":3,"file":"hasHoverAnimation.d.ts","sourceRoot":"","sources":["../../src/utils/hasHoverAnimation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,gBAAgB,GAAG,SAAS,GAAG,OAAO,CAYnF"}

package/dist/utils/hasHoverAnimation.js

@@ -9,7 +9,5 @@ export function hasHoverAnimation(animations) {
         return true;
     if (animations.edges?.animations?.some(a => a.triggerMode === 'hover'))
         return true;
-    if (animations.effects?.animations?.some(a => a.triggerMode === 'hover'))
-        return true;
     return false;
 }

package/dist/utils/landscapeUniforms.d.ts

@@ -1,5 +1,5 @@
 import * as THREE from 'three';
-import type { LandscapeConfig, LandscapeQualityConfig } from '../types/landscapeConfigs';
+import type { LandscapeConfig, LandscapeQualityConfig } from '@3driseai/3drise-core';
 import type { LandscapeUniforms } from '../shaders/landscape/LandscapeMaterial';
 export interface LandscapeMapUniforms {
     height: THREE.Texture | null;

package/dist/utils/landscapeUniforms.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"landscapeUniforms.d.ts","sourceRoot":"","sources":["../../src/utils/landscapeUniforms.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,KAAK,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAA;AACxF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAA;AAa/E,MAAM,WAAW,oBAAoB;IACjC,MAAM,EAAE,KAAK,CAAC,OAAO,GAAG,IAAI,CAAA;IAC5B,UAAU,EAAE,KAAK,CAAC,OAAO,CAAA;IACzB,oDAAoD;IACpD,KAAK,EAAE,KAAK,CAAC,OAAO,GAAG,IAAI,CAAA;IAC3B,SAAS,EAAE,KAAK,CAAC,OAAO,CAAA;IACxB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,KAAK,CAAC,gBAAgB,GAAG,IAAI,CAAA;IACtC,MAAM,EAAE,KAAK,CAAC,gBAAgB,GAAG,IAAI,CAAA;IACrC,MAAM,EAAE,KAAK,CAAC,OAAO,GAAG,IAAI,CAAA;IAC5B,MAAM,EAAE,KAAK,CAAC,OAAO,GAAG,IAAI,CAAA;IAC5B,EAAE,EAAE,KAAK,CAAC,OAAO,GAAG,IAAI,CAAA;IACxB,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,CAAA;CACzB;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,oBAAoB,GAAG,IAAI,CAoBhG;AAED,wBAAgB,sBAAsB,CAClC,QAAQ,EAAE,iBAAiB,EAC3B,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,sBAAsB,GAChC,IAAI,CAmDN"}
+{"version":3,"file":"landscapeUniforms.d.ts","sourceRoot":"","sources":["../../src/utils/landscapeUniforms.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,KAAK,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AACpF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAA;AAa/E,MAAM,WAAW,oBAAoB;IACjC,MAAM,EAAE,KAAK,CAAC,OAAO,GAAG,IAAI,CAAA;IAC5B,UAAU,EAAE,KAAK,CAAC,OAAO,CAAA;IACzB,oDAAoD;IACpD,KAAK,EAAE,KAAK,CAAC,OAAO,GAAG,IAAI,CAAA;IAC3B,SAAS,EAAE,KAAK,CAAC,OAAO,CAAA;IACxB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,KAAK,CAAC,gBAAgB,GAAG,IAAI,CAAA;IACtC,MAAM,EAAE,KAAK,CAAC,gBAAgB,GAAG,IAAI,CAAA;IACrC,MAAM,EAAE,KAAK,CAAC,OAAO,GAAG,IAAI,CAAA;IAC5B,MAAM,EAAE,KAAK,CAAC,OAAO,GAAG,IAAI,CAAA;IAC5B,EAAE,EAAE,KAAK,CAAC,OAAO,GAAG,IAAI,CAAA;IACxB,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,CAAA;CACzB;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,oBAAoB,GAAG,IAAI,CAoBhG;AAED,wBAAgB,sBAAsB,CAClC,QAAQ,EAAE,iBAAiB,EAC3B,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,sBAAsB,GAChC,IAAI,CAmDN"}

package/dist/utils/oceanUniforms.d.ts

@@ -1,5 +1,5 @@
 import * as THREE from 'three';
-import type { OceanConfig, OceanQualityConfig } from '../types/oceanConfigs';
+import type { OceanConfig, OceanQualityConfig } from '@3driseai/3drise-core';
 export interface WaveTable {
     /** (dirX, dirZ, amplitude, wavenumber) */
     a: THREE.Vector4[];

package/dist/utils/particleShape.d.ts

@@ -0,0 +1,33 @@
+import * as THREE from 'three';
+import type { ParticleShapeConfig } from '@3driseai/3drise-core';
+/** Mesh-builder units -> particle world units (the builders' defaults come out ~1.6 wide). */
+export declare const SHAPE_SCALE = 1.6;
+/** The shape with every parameter filled in from the builder defaults (unknown types -> cone). */
+export declare function shapeConfig(shape?: Partial<ParticleShapeConfig> | null): ParticleShapeConfig;
+/** Geometry of a shape, built by the core mesh builders, axis along y. The caller disposes it. */
+export declare function shapeGeometry(shape?: Partial<ParticleShapeConfig> | null): THREE.BufferGeometry;
+/** Radial map of a closed shape: R(theta, h) = distance from the y axis to the outermost surface,
+ *  on an nTh x nH grid (slice the triangles at each height, cast rays in the slice). The axis goes
+ *  through the vertex centroid (a tetrahedron's footprint is not centred on its bounding box). */
+export declare function radialMap(geometry: THREE.BufferGeometry, nTh?: number, nH?: number): {
+    R: Float32Array<ArrayBuffer>;
+    ymin: number;
+    ymax: number;
+    nTh: number;
+    nH: number;
+};
+/** The shape as a surface field: R(theta, h) in world units (scale x builder units), centred on the
+ *  origin. rAt(theta, h), rmAt(h) (mean radius), Y0..Y1, RW (widest mean), rMax (widest radius). */
+export declare function shapeField(shape: Partial<ParticleShapeConfig> | null | undefined, scale?: number, nTh?: number, nH?: number): {
+    rAt: (th: number, h: number) => number;
+    rmAt: (h: number) => number;
+    Y0: number;
+    Y1: number;
+    RW: number;
+    rMax: number;
+    scale: number;
+};
+/** n points spread evenly over the shape's surface (area-weighted, stratified, shuffled so any prefix
+ *  covers the whole shape), in the same world frame as shapeField. Returns Float32Array n*3. */
+export declare function sampleSurface(shape: Partial<ParticleShapeConfig> | null | undefined, n: number, rng: () => number, scale?: number): Float32Array<ArrayBuffer>;
+//# sourceMappingURL=particleShape.d.ts.map

package/dist/utils/particleShape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"particleShape.d.ts","sourceRoot":"","sources":["../../src/utils/particleShape.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjE,8FAA8F;AAC9F,eAAO,MAAM,WAAW,MAAM,CAAC;AAE/B,kGAAkG;AAClG,wBAAgB,WAAW,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,IAAI,GAAG,mBAAmB,CAG5F;AAED,kGAAkG;AAClG,wBAAgB,aAAa,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,IAAI,GAAG,KAAK,CAAC,cAAc,CAgB/F;AAED;;kGAEkG;AAClG,wBAAgB,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,cAAc,EAAE,GAAG,SAAK,EAAE,EAAE,SAAK;;;;;;EA4C1E;AAED;oGACoG;AACpG,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,IAAI,GAAG,SAAS,EAAE,KAAK,SAAc,EAAE,GAAG,SAAK,EAAE,EAAE,SAAK;cAwBtG,MAAM,KAAK,MAAM;cADjB,MAAM;;;;;;EAWxB;AAED;gGACgG;AAChG,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,IAAI,GAAG,SAAS,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,MAAM,EAAE,KAAK,SAAc,6BAyCtI"}