@3driseai/3drise-viewer 0.1.7 → 0.1.8

package/dist/presets/landscapeTypes.js

@@ -0,0 +1,315 @@
+import { defaultLandscapeQuality, defaultLandscapeSurface } from '../types/landscapeConfigs.js';
+const S = (pack, band, metres, surface) => ({ pack, band, metres, surface });
+/** Texture repeats across the tile, from a real-world tile size. Clamped: below
+ *  about half a metre a ground texture aliases before it reads as detail, and
+ *  above about forty it is wallpaper. */
+export function repeatForMetres(size, metres) {
+    return Math.max(1, Math.round(size / Math.min(Math.max(metres, 0.5), 40)));
+}
+export const landscapeTypes = [
+    {
+        id: 'grassland',
+        label: 'Grassland',
+        description: 'Green slopes, bare soil in the hollows, rock where it is too steep to hold.',
+        packs: [
+            S('grass_meadow', 0.15, 2.5, { saturation: 0.85, tint: '#b6c4a8', roughness: 0.95, normalStrength: 0.45 }),
+            S('soil_mud', 0.55, 3.0, { saturation: 0.8, roughness: 0.88 }),
+            S('rock_cliff', 0.9, 4.0, { triplanar: true, tint: '#cfc9c2', roughness: 0.82 }),
+        ],
+        splat: { bandWidth: 0.5, slopeStart: 0.3, slopeEnd: 0.6, noise: 0.14, noiseSize: 350 },
+        settings: { macroVariation: 0.28, macroSize: 800 },
+    },
+    {
+        id: 'rocky',
+        label: 'Rocky',
+        description: 'Broken stone and scree with soil caught in the flats.',
+        packs: [
+            S('soil_mud', 0.1, 3.0, { saturation: 0.7 }),
+            S('rock_boulder', 0.5, 4.0, { triplanar: true, tint: '#c8c4bd' }),
+            S('rock_cliff', 0.85, 4.0, { triplanar: true }),
+        ],
+        splat: { bandWidth: 0.55, slopeStart: 0.22, slopeEnd: 0.5, noise: 0.18, noiseSize: 280 },
+        settings: { macroVariation: 0.22, macroSize: 600 },
+    },
+    {
+        id: 'cliffs',
+        label: 'Cliffs',
+        description: 'Bare rock almost everywhere — the shape does the talking.',
+        packs: [
+            S('rock_boulder', 0.25, 4.0, { triplanar: true }),
+            S('rock_cliff', 0.8, 4.0, { triplanar: true, tint: '#cfc9c2' }),
+        ],
+        splat: { bandWidth: 0.7, slopeStart: 0.12, slopeEnd: 0.38, noise: 0.2, noiseSize: 240 },
+        settings: { macroVariation: 0.18, macroSize: 900 },
+    },
+    {
+        id: 'meadow',
+        label: 'Meadow',
+        description: 'Lush low ground drying out as it rises.',
+        packs: [
+            S('grass_meadow', 0.12, 2.5, { tint: '#aec49c' }),
+            S('grass_dry', 0.55, 2.5, { tint: '#cbbf8e' }),
+            S('soil_mud', 0.92, 3.0, { repeat: 300 }),
+        ],
+        splat: { bandWidth: 0.5, slopeStart: 0.4, slopeEnd: 0.72, noise: 0.16, noiseSize: 420 },
+        settings: { macroVariation: 0.32, macroSize: 900 },
+    },
+    {
+        id: 'snow',
+        label: 'Snow',
+        description: 'Snow on the tops and the flats, rock on the faces that are too steep to hold it.',
+        packs: [
+            // Order matters: the LAST pack is the slope layer (see the auto-splat
+            // block in landscapeCore.glsl), so it must be the rock. The first
+            // version listed snow last and therefore painted snow onto exactly
+            // the faces too steep to hold it - the inverse of the description.
+            S('rock_cliff', 0.12, 4.0, { triplanar: true, tint: '#b9bcc2' }),
+            S('snow_fresh', 0.75, 3.0, { roughness: 0.55, saturation: 0.6, tint: '#f2f6ff' }),
+            S('rock_boulder', 0.95, 4.0, { triplanar: true, tint: '#c6c9cf' }),
+        ],
+        splat: { bandWidth: 0.42, slopeStart: 0.34, slopeEnd: 0.6, noise: 0.1, noiseSize: 500 },
+        settings: { macroVariation: 0.14, macroSize: 1200 },
+        thumbPack: 'snow_fresh',
+    },
+    {
+        id: 'sand',
+        label: 'Sand',
+        description: 'Dune sand, rippled where the wind reaches, rock breaking through at the steepest angles.',
+        packs: [
+            S('sand_dune', 0.2, 4.0, { roughness: 0.6, saturation: 0.9 }),
+            S('sand_rippled', 0.65, 3.5, { roughness: 0.55 }),
+            S('rock_boulder', 0.95, 4.0, { triplanar: true }),
+        ],
+        splat: { bandWidth: 0.6, slopeStart: 0.5, slopeEnd: 0.82, noise: 0.1, noiseSize: 600 },
+        settings: { macroVariation: 0.16, macroSize: 1600 },
+    },
+    {
+        id: 'desert',
+        label: 'Desert',
+        description: 'Cracked pan between sand flats, mesa rock above.',
+        packs: [
+            S('sand_dune', 0.15, 4.0, { roughness: 0.62 }),
+            S('soil_cracked', 0.5, 3.5, { saturation: 0.75 }),
+            S('rock_mesa', 0.9, 4.5, { triplanar: true, tint: '#c98f63' }),
+        ],
+        splat: { bandWidth: 0.5, slopeStart: 0.3, slopeEnd: 0.58, noise: 0.2, noiseSize: 380 },
+        settings: { macroVariation: 0.26, macroSize: 1100 },
+    },
+    {
+        id: 'forest_floor',
+        label: 'Forest floor',
+        description: 'Leaf litter and moss under the canopy, roots and rock on the banks.',
+        packs: [
+            S('forest_litter', 0.15, 2.5, { saturation: 0.8, tint: '#9c8a6c' }),
+            S('moss_ground', 0.55, 2.0, { tint: '#8ea882' }),
+            S('rock_boulder', 0.9, 4.0, { triplanar: true }),
+        ],
+        splat: { bandWidth: 0.52, slopeStart: 0.36, slopeEnd: 0.66, noise: 0.22, noiseSize: 260 },
+        settings: { macroVariation: 0.34, macroSize: 500 },
+    },
+    {
+        id: 'tundra',
+        label: 'Tundra',
+        description: 'Low moss over gravel, frost-shattered rock on the ridges.',
+        packs: [
+            S('tundra_moss', 0.18, 2.0, { saturation: 0.7, tint: '#9aa383' }),
+            S('gravel', 0.55, 2.0, { saturation: 0.65 }),
+            S('rock_cliff', 0.9, 4.0, { triplanar: true, tint: '#b8b4ae' }),
+        ],
+        splat: { bandWidth: 0.5, slopeStart: 0.28, slopeEnd: 0.55, noise: 0.18, noiseSize: 320 },
+        settings: { macroVariation: 0.24, macroSize: 700 },
+    },
+    {
+        id: 'volcanic',
+        label: 'Volcanic',
+        description: 'Ash fields over basalt, everything dark and matte.',
+        packs: [
+            S('ash_ground', 0.15, 3.0, { saturation: 0.4, tint: '#6b6663', roughness: 0.95 }),
+            S('basalt', 0.6, 3.5, { saturation: 0.35, tint: '#4f4c4a', triplanar: true }),
+            S('rock_boulder', 0.95, 4.0, { triplanar: true, tint: '#5a5652' }),
+        ],
+        splat: { bandWidth: 0.55, slopeStart: 0.25, slopeEnd: 0.55, noise: 0.2, noiseSize: 300 },
+        settings: { macroVariation: 0.3, macroSize: 650 },
+    },
+];
+export function getLandscapeType(id) {
+    return landscapeTypes.find((t) => t.id === id);
+}
+/** Every surface pack any type refers to — for a client that wants to know what
+ *  to upload, or which types it can offer. */
+export function landscapeTypePacks(type) {
+    return type.packs.map((p) => p.pack);
+}
+/**
+ * Every type, with the reason each unavailable one is unavailable.
+ *
+ * The packs in a type are NOT interchangeable, so "needs all of them" is the
+ * wrong rule and this is the right one. Two of them are load-bearing:
+ *
+ *   THE LAST PACK is the slope layer. The auto-splat block in
+ *   `landscapeCore.glsl` bands every surface by height, multiplies all but the
+ *   last by `1 - rock`, and then forces the last one on by slope. Drop it and
+ *   the next pack up is silently promoted into that role — a ground texture
+ *   smeared vertically up every cliff face, which is the ugliest thing this
+ *   material can do.
+ *
+ *   THE SIGNATURE PACK (`thumbPack`, else the first) is what makes the type
+ *   that type. Snow without `snow_fresh` is rock, and offering it under the
+ *   name Snow is worse than not offering it.
+ *
+ * Everything in between is a middle height band. Losing one widens the gap
+ * between the layers that remain; `resolveLandscapeType` already rebuilds the
+ * band array from the surfaces that actually resolved, so nothing lands at the
+ * wrong altitude. That is a poorer version of the biome, not a broken one, and
+ * it is not worth blocking a type over — Sand with dune sand and boulders but
+ * no ripple layer is still recognisably sand.
+ */
+export function landscapeTypeAvailability(havePacks) {
+    const have = new Set(havePacks);
+    return landscapeTypes.map((type) => {
+        const names = landscapeTypePacks(type);
+        const missingPacks = names.filter((p) => !have.has(p));
+        const loadBearing = new Set([names[names.length - 1], type.thumbPack ?? names[0]]);
+        const blockingPacks = missingPacks.filter((p) => loadBearing.has(p));
+        const reducedPacks = missingPacks.filter((p) => !loadBearing.has(p));
+        return {
+            type,
+            missingPacks,
+            blockingPacks,
+            reducedPacks,
+            available: blockingPacks.length === 0,
+        };
+    });
+}
+export const landscapeShapes = [
+    { id: 'highlands', label: 'Highlands', description: 'Broad ridges and wide valleys.', size: 2048, elevation: 340, hasSplatMaps: true },
+    { id: 'mountains', label: 'Mountains', description: 'Sharp peaks, deep cols.', size: 3000, elevation: 900 },
+    { id: 'rolling_hills', label: 'Rolling hills', description: 'Gentle, walkable ground.', size: 2400, elevation: 120 },
+    { id: 'foothills', label: 'Foothills', description: 'Low ridges rising toward a range.', size: 2200, elevation: 320 },
+    { id: 'valley', label: 'Valley', description: 'One floor between two walls.', size: 2600, elevation: 420 },
+    { id: 'dunes', label: 'Dunes', description: 'Wind-formed ridges, no rock.', size: 3000, elevation: 90 },
+    { id: 'plateau', label: 'Plateau', description: 'Flat tops with steep sides.', size: 2800, elevation: 300 },
+    { id: 'island', label: 'Island', description: 'Ground falling away to water on every side.', size: 2000, elevation: 260 },
+    { id: 'canyon', label: 'Canyon', description: 'Incised channels below a flat rim.', size: 2600, elevation: 500 },
+];
+export function getLandscapeShape(id) {
+    return landscapeShapes.find((s) => s.id === id);
+}
+/**
+ * The six knobs a non-expert cannot reason about individually but has a clear
+ * opinion about collectively. `meshError` is in world units and therefore scales
+ * with the landscape's relief, so it is applied as a FRACTION of elevation
+ * rather than as a constant — 1.5 m of error on a 90 m dune field is invisible,
+ * on a 900 m range it is a stepped silhouette.
+ */
+export const LANDSCAPE_DETAIL = {
+    draft: {
+        label: 'Draft',
+        description: 'Fastest. Coarse mesh, one surface per pixel, no stochastic tiling — for blocking out a scene.',
+        meshErrorFraction: 0.006,
+        surfaceSamples: 1,
+        quality: { arrayResolution: 512, stochastic: false, triplanar: false, anisotropy: 1, chunks: 4 },
+    },
+    balanced: {
+        label: 'Balanced',
+        description: 'The default. Two surfaces blended per pixel with stochastic tiling on.',
+        meshErrorFraction: 0.0018,
+        surfaceSamples: 2,
+        quality: { arrayResolution: 1024, stochastic: true, triplanar: true, anisotropy: 4, chunks: 4 },
+    },
+    high: {
+        label: 'High',
+        description: 'Three surfaces per pixel and 2K textures. Costs about four times the memory of Balanced.',
+        meshErrorFraction: 0.0006,
+        surfaceSamples: 3,
+        quality: { arrayResolution: 2048, stochastic: true, triplanar: true, anisotropy: 8, chunks: 6 },
+    },
+};
+export function landscapeQualityForDetail(detail, elevation) {
+    const spec = LANDSCAPE_DETAIL[detail] ?? LANDSCAPE_DETAIL.balanced;
+    return {
+        ...defaultLandscapeQuality,
+        ...spec.quality,
+        meshError: Math.max(0.05, Math.round(elevation * spec.meshErrorFraction * 100) / 100),
+    };
+}
+/** Best guess at which detail level a config came from, so the Basic tab can
+ *  show the right button after an Advanced edit — or show none, which is the
+ *  honest answer once someone has hand-tuned it. */
+export function detectLandscapeDetail(quality, surfaceSamples) {
+    for (const [id, spec] of Object.entries(LANDSCAPE_DETAIL)) {
+        const q = spec.quality;
+        if (quality.arrayResolution === q.arrayResolution
+            && quality.stochastic === q.stochastic
+            && quality.triplanar === q.triplanar
+            && surfaceSamples === spec.surfaceSamples)
+            return id;
+    }
+    return null;
+}
+/**
+ * Two picks and a detail level to a whole config.
+ *
+ * A pack with no albedo is dropped, not rendered as a hole — a surface with no
+ * albedo is skipped by the renderer anyway, and an empty slot in the middle of
+ * the list would shift the bands of every layer after it.
+ *
+ * The shape's own `size` and `elevation` are the starting point rather than a
+ * global default, because a dune field and an alpine range are not the same
+ * scene at the same numbers. The caller overrides them once the user touches a
+ * slider.
+ */
+export function resolveLandscapeType(typeId, shapeId, index, detail = 'balanced', override = {}) {
+    const type = getLandscapeType(typeId);
+    const shape = getLandscapeShape(shapeId);
+    const missing = [];
+    const heightMap = index.shape(shapeId, 'height');
+    if (!heightMap)
+        missing.push(`terrains/${shapeId}/height`);
+    const surfaces = [];
+    const bands = [];
+    for (const ref of type?.packs ?? []) {
+        const albedo = index.pack(ref.pack, 'albedo');
+        if (!albedo) {
+            missing.push(`surfaces/${ref.pack}/albedo`);
+            continue;
+        }
+        surfaces.push({
+            ...defaultLandscapeSurface,
+            name: ref.pack,
+            ...ref.surface,
+            repeat: repeatForMetres(override.size ?? shape?.size ?? 2048, ref.metres ?? 3),
+            diffuse: albedo,
+            normal: index.pack(ref.pack, 'normal') ?? '',
+            displacement: index.pack(ref.pack, 'height') ?? '',
+        });
+        bands.push(ref.band ?? 0.5);
+    }
+    const elevation = override.elevation ?? shape?.elevation ?? 340;
+    const size = override.size ?? shape?.size ?? 2048;
+    const splat = type?.splat ?? { bandWidth: 0.5, slopeStart: 0.35, slopeEnd: 0.62, noise: 0.12, noiseSize: 400 };
+    return {
+        config: {
+            ...(type?.settings ?? {}),
+            enabled: !!heightMap && surfaces.length > 0,
+            landscapeType: type?.id ?? '',
+            shape: shape?.id ?? '',
+            heightMap: heightMap ?? '',
+            heightEncoding: 'grayscale',
+            // Always the generated splat: a type is a recipe for placing surfaces
+            // by height and slope, and no shape x type pairing has an authored
+            // splat map. The Advanced tab is where an authored one goes.
+            splatSource: 'auto',
+            splatMaps: [],
+            aoMap: index.shape(shapeId, 'ao') ?? '',
+            size,
+            elevationScale: elevation,
+            surfaces,
+            surfaceSamples: LANDSCAPE_DETAIL[detail].surfaceSamples,
+            autoSplat: { ...splat, bands },
+            preset: '',
+        },
+        quality: landscapeQualityForDetail(detail, elevation),
+        missing,
+    };
+}

package/dist/presets/oceanSurfacePresets.d.ts

@@ -0,0 +1,33 @@
+import type { OceanSurfaceConfig, WaterType } from '../types/oceanConfigs';
+/**
+ * Presets for the ocean.
+ *
+ * They live here rather than in `core/src/presets` for the same reason the cloud
+ * and terrain presets do: they are `Partial<OceanSurfaceConfig>`, and that type
+ * is declared in this package next to the shader that consumes it. (Core's
+ * `oceanPresets.ts` is a different thing entirely — five *material* variants for
+ * the retired flat-plane ocean. Their five names are reused here on purpose:
+ * they were already the vocabulary, and `normalizeOcean` maps the old ones onto
+ * these.)
+ *
+ * Each entry is a *patch* over the type's defaults, not a full config, so a knob
+ * added to the renderer inherits its default everywhere instead of silently
+ * reverting to whatever a preset happened to be authored with — and switching
+ * between two presets never leaves a number behind from the previous one.
+ *
+ * The sea presets are named for the Beaufort scale, because a name someone can
+ * picture is worth more in a dropdown than "Ocean 3", and because the numbers
+ * behind them are the wind speeds that scale actually describes.
+ */
+export interface OceanPreset {
+    name: string;
+    waterType: WaterType;
+    description: string;
+    tags: string[];
+    settings: Partial<OceanSurfaceConfig>;
+}
+export declare const oceanSurfacePresets: OceanPreset[];
+export declare function getOceanPresetsForType(type: WaterType): OceanPreset[];
+export declare function getOceanPresetByName(name: string): OceanPreset | undefined;
+export declare function searchOceanPresetsByTags(tags: string[]): OceanPreset[];
+//# sourceMappingURL=oceanSurfacePresets.d.ts.map

package/dist/presets/oceanSurfacePresets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oceanSurfacePresets.d.ts","sourceRoot":"","sources":["../../src/presets/oceanSurfacePresets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAE3E;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,SAAS,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACzC;AAgPD,eAAO,MAAM,mBAAmB,EAAE,WAAW,EAK5C,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,SAAS,GAAG,WAAW,EAAE,CAErE;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAE1E;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE,CAGtE"}

package/dist/presets/oceanSurfacePresets.js

@@ -0,0 +1,245 @@
+// =============================================================================
+// Sea — open water, named for the wind that makes it
+// =============================================================================
+const seaPresets = [
+    {
+        name: 'Glassy',
+        waterType: 'sea',
+        description: 'Almost no wind. A slow swell left over from weather somewhere else, and a mirror everywhere between the crests.',
+        tags: ['calm', 'mirror', 'still', 'dawn'],
+        settings: {
+            windSpeed: 1.5, fetch: 400, directionalSpread: 12, swell: 0.9,
+            choppiness: 0.35, foamAmount: 0, roughness: 0.03, specular: 1.4,
+            waveComponents: 14, detailStrength: 0.25,
+        },
+    },
+    {
+        name: 'Light breeze',
+        waterType: 'sea',
+        description: 'Small wind waves over a low swell. The everyday sea, and the one most scenes want.',
+        tags: ['gentle', 'daylight', 'default'],
+        settings: {
+            windSpeed: 5.5, fetch: 250, directionalSpread: 28, swell: 0.45,
+            choppiness: 0.7, foamAmount: 0.15, roughness: 0.07,
+        },
+    },
+    {
+        name: 'Moderate sea',
+        waterType: 'sea',
+        description: 'Whitecaps starting to show on the steepest crests. Force 5.',
+        tags: ['whitecaps', 'wind', 'blue'],
+        settings: {
+            windSpeed: 9.5, fetch: 300, directionalSpread: 32, swell: 0.35,
+            choppiness: 0.9, foamAmount: 0.6,
+        },
+    },
+    {
+        name: 'Rough',
+        waterType: 'sea',
+        description: 'Long crests breaking regularly, spray beginning to blow off them. Force 7.',
+        tags: ['rough', 'foam', 'grey', 'wind'],
+        settings: {
+            windSpeed: 15, fetch: 450, directionalSpread: 38, swell: 0.4,
+            choppiness: 1.0, foamAmount: 1.05, foamDecay: 0.7,
+            deepColor: '#082a3a', shallowColor: '#276c78', roughness: 0.12,
+        },
+    },
+    {
+        name: 'Gale',
+        waterType: 'sea',
+        description: 'The whole surface breaking. Foam in streaks down the wind, and very little water left showing between them.',
+        tags: ['storm', 'gale', 'white', 'violent'],
+        settings: {
+            windSpeed: 21, fetch: 600, directionalSpread: 44, swell: 0.5,
+            choppiness: 1.15, steepness: 0.85, foamAmount: 1.6, foamDecay: 0.85, foamSize: 14,
+            deepColor: '#0a2028', shallowColor: '#2e6068', roughness: 0.17, sssStrength: 0.3,
+            aerialPerspective: 0.00018,
+        },
+    },
+];
+// =============================================================================
+// Lake — short fetch is the whole story
+// =============================================================================
+const lakePresets = [
+    {
+        name: 'Still',
+        waterType: 'lake',
+        description: 'A mirror with the faintest texture on it. Reflection is doing all the work.',
+        tags: ['calm', 'mirror', 'morning', 'reflection'],
+        settings: {
+            windSpeed: 1, fetch: 1.5, waveComponents: 10, choppiness: 0.3,
+            foamAmount: 0, roughness: 0.025, specular: 1.5, detailStrength: 0.4, detailSize: 1.6,
+        },
+    },
+    {
+        name: 'Ripples',
+        waterType: 'lake',
+        description: 'Cat’s paws crossing an otherwise flat surface. The short end of the spectrum and nothing else.',
+        tags: ['ripple', 'light', 'texture'],
+        settings: {
+            windSpeed: 2.5, fetch: 1.5, waveComponents: 12, choppiness: 0.45,
+            roughness: 0.05, detailStrength: 0.8, detailSize: 0.9,
+        },
+    },
+    {
+        name: 'Breeze',
+        waterType: 'lake',
+        description: 'Steady wind across open water. Short, regular waves with no swell under them at all.',
+        tags: ['wind', 'daylight', 'green'],
+        settings: {
+            windSpeed: 4.5, fetch: 3, choppiness: 0.6, foamAmount: 0.1,
+        },
+    },
+    {
+        name: 'Choppy',
+        waterType: 'lake',
+        description: 'The steep, short, disorganised chop that inland water produces and open ocean does not.',
+        tags: ['chop', 'steep', 'short'],
+        settings: {
+            windSpeed: 8, fetch: 4, directionalSpread: 40, choppiness: 0.95,
+            steepness: 0.85, foamAmount: 0.35, waveComponents: 16,
+        },
+    },
+    {
+        name: 'Wind-blown',
+        waterType: 'lake',
+        description: 'A gale on a lake: still small waves, because there is no room upwind for anything bigger, but every one of them breaking.',
+        tags: ['storm', 'chop', 'foam', 'grey'],
+        settings: {
+            windSpeed: 16, fetch: 5, directionalSpread: 45, choppiness: 1.1,
+            steepness: 0.9, foamAmount: 1.1, foamDecay: 0.6,
+            deepColor: '#12262a', shallowColor: '#38707a', roughness: 0.14,
+        },
+    },
+];
+// =============================================================================
+// Storm
+// =============================================================================
+const stormPresets = [
+    {
+        name: 'Building',
+        waterType: 'storm',
+        description: 'The sea before the weather arrives: long swell running ahead of the wind that made it.',
+        tags: ['swell', 'ominous', 'grey'],
+        settings: {
+            windSpeed: 14, swell: 0.75, choppiness: 0.85, foamAmount: 0.6,
+            deepColor: '#0d2430', shallowColor: '#33686e',
+        },
+    },
+    {
+        name: 'Full storm',
+        waterType: 'storm',
+        description: 'Twenty-five metres a second. Crests folding through themselves, which is where the whitecaps come from — they are not painted on.',
+        tags: ['storm', 'violent', 'foam', 'break'],
+        settings: {
+            windSpeed: 25, choppiness: 1.2, steepness: 0.9, foamAmount: 1.7, foamDecay: 0.8,
+        },
+    },
+    {
+        name: 'Hurricane',
+        waterType: 'storm',
+        description: 'The top of the scale. Confused, enormous, and almost entirely white.',
+        tags: ['hurricane', 'extreme', 'white', 'chaos'],
+        settings: {
+            windSpeed: 38, fetch: 900, directionalSpread: 55, waveComponents: 30,
+            choppiness: 1.3, steepness: 1, foamAmount: 2, foamDecay: 0.95, foamSize: 20,
+            deepColor: '#08171e', shallowColor: '#2a545c', roughness: 0.2,
+            sssStrength: 0.2, aerialPerspective: 0.00028,
+        },
+    },
+    {
+        name: 'Squall line',
+        waterType: 'storm',
+        description: 'A narrow, aligned sea driven hard from one quarter. Less confused than a full storm and steeper for it.',
+        tags: ['squall', 'aligned', 'steep'],
+        settings: {
+            windSpeed: 20, fetch: 200, directionalSpread: 18, choppiness: 1.15,
+            steepness: 0.95, foamAmount: 1.3,
+        },
+    },
+    {
+        name: 'After the storm',
+        waterType: 'storm',
+        description: 'The wind has dropped and left its swell behind. Large, smooth, and slow — the sea takes a day to forget.',
+        tags: ['swell', 'aftermath', 'smooth', 'large'],
+        settings: {
+            windSpeed: 8, swell: 1, directionalSpread: 16, choppiness: 0.7,
+            foamAmount: 0.2, waveComponents: 18, roughness: 0.07,
+        },
+    },
+];
+// =============================================================================
+// Shore
+// =============================================================================
+const shorePresets = [
+    {
+        name: 'Tropical shallows',
+        waterType: 'shore',
+        description: 'Clear water over pale sand. Almost all of the colour is the bottom coming through.',
+        tags: ['tropical', 'clear', 'turquoise', 'shallow'],
+        settings: {
+            windSpeed: 4, deepColor: '#0a5a7a', shallowColor: '#4fd6c8', sssColor: '#39c8b0',
+            absorption: 0.04, clarity: 0.1, shoreDepth: 8, shoreFoam: 1.2,
+        },
+    },
+    {
+        name: 'Rolling swell',
+        waterType: 'shore',
+        description: 'Long lines coming in square to the beach, the way waves do once they have refracted into the shallows.',
+        tags: ['swell', 'surf', 'aligned', 'beach'],
+        settings: {
+            windSpeed: 8, swell: 0.9, directionalSpread: 10, choppiness: 1.05,
+            foamAmount: 1.1, foamDecay: 0.85, shoreFoam: 1.6,
+        },
+    },
+    {
+        name: 'Cold coast',
+        waterType: 'shore',
+        description: 'Grey-green water over dark rock, and a hard foam line where it meets it.',
+        tags: ['cold', 'north', 'rock', 'grey'],
+        settings: {
+            windSpeed: 12, deepColor: '#12333a', shallowColor: '#40808a', sssColor: '#4f9c93',
+            clarity: 0.55, absorption: 0.13, foamAmount: 1.2, shoreDepth: 4, shoreFoam: 1.5,
+        },
+    },
+    {
+        name: 'Estuary',
+        waterType: 'shore',
+        description: 'Silty, slow and shallow. Barely any reflection left once the suspended matter has lifted the colour.',
+        tags: ['silt', 'brown', 'shallow', 'river'],
+        settings: {
+            windSpeed: 3, deepColor: '#2c3a2a', shallowColor: '#6b6c46', sssColor: '#7a7a4a',
+            clarity: 0.9, absorption: 0.35, foamAmount: 0.05, shoreDepth: 2, specular: 0.7,
+        },
+    },
+    {
+        name: 'Lagoon',
+        waterType: 'shore',
+        description: 'Enclosed and almost flat, with the reef taking the swell outside it.',
+        tags: ['lagoon', 'calm', 'clear', 'blue'],
+        settings: {
+            windSpeed: 2.5, fetch: 6, swell: 0.05, choppiness: 0.4,
+            deepColor: '#0d6b8c', shallowColor: '#63e0d2', absorption: 0.05, clarity: 0.12,
+            foamAmount: 0, shoreDepth: 5, detailStrength: 0.7, detailSize: 1,
+        },
+    },
+];
+// =============================================================================
+// Registry
+// =============================================================================
+export const oceanSurfacePresets = [
+    ...seaPresets,
+    ...lakePresets,
+    ...stormPresets,
+    ...shorePresets,
+];
+export function getOceanPresetsForType(type) {
+    return oceanSurfacePresets.filter((p) => p.waterType === type);
+}
+export function getOceanPresetByName(name) {
+    return oceanSurfacePresets.find((p) => p.name === name);
+}
+export function searchOceanPresetsByTags(tags) {
+    const wanted = tags.map((t) => t.toLowerCase());
+    return oceanSurfacePresets.filter((p) => p.tags.some((t) => wanted.includes(t.toLowerCase())));
+}

package/dist/presets/terrainPresets.d.ts

@@ -0,0 +1,28 @@
+import type { TerrainSurfaceConfig, TerrainType } from '../types/terrainConfigs';
+/**
+ * Presets for the procedural terrain system.
+ *
+ * They live here rather than in `core/src/presets` for the same reason the cloud
+ * presets do: they are `Partial<TerrainSurfaceConfig>`, and that type is declared
+ * in this package next to the shader that consumes it.
+ *
+ * Each entry is a *patch* over the type's defaults, not a full config, so a knob
+ * added to the renderer inherits its default everywhere instead of silently
+ * reverting to whatever a preset happened to be authored with — and switching
+ * between two presets never leaves a number behind from the previous one.
+ *
+ * The names are places and landform terms, because a name someone can picture is
+ * worth more in a dropdown than "Terrain 3".
+ */
+export interface TerrainPreset {
+    name: string;
+    terrainType: TerrainType;
+    description: string;
+    tags: string[];
+    settings: Partial<TerrainSurfaceConfig>;
+}
+export declare const terrainPresets: TerrainPreset[];
+export declare function getTerrainPresetsForType(type: TerrainType): TerrainPreset[];
+export declare function getTerrainPresetByName(name: string): TerrainPreset | undefined;
+export declare function searchTerrainPresetsByTags(tags: string[]): TerrainPreset[];
+//# sourceMappingURL=terrainPresets.d.ts.map

package/dist/presets/terrainPresets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terrainPresets.d.ts","sourceRoot":"","sources":["../../src/presets/terrainPresets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEjF;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,WAAW,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAC3C;AAgSD,eAAO,MAAM,cAAc,EAAE,aAAa,EAKzC,CAAC;AAEF,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,WAAW,GAAG,aAAa,EAAE,CAE3E;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAE9E;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,aAAa,EAAE,CAG1E"}