@3driseai/3drise-viewer 0.1.28 → 0.1.30

package/dist/operations/usePresentedVisibility.js

@@ -0,0 +1,53 @@
+// Presented visibility — what the renderer is told about an object's `visible`.
+//
+// An object's effects can follow its visibility (its effect clip's `visible`): shown → they
+// play in, hidden → they play out. Both ends need the renderers to wait:
+//   hide   the object must stay drawn until the effects have played out
+//   show   the object must stay undrawn until the effects are ready (compiled, their
+//          start state on) — a frost that paints the object in must never be preceded
+//          by a frame of the plain object
+// So a change of `visible` on such an object is HELD here: the renderers keep seeing
+// the old value until the object's effects controller says it is done, then get the
+// real one. The controller switches the group itself at the exact moment (see
+// ObjectEffectsController.setVisible); this hook keeps React's value out of its way
+// and brings it in line afterwards.
+//
+// One choke point: ObjectNode runs every scene object's settings through this
+// right after the action patches, so every renderer below sees the same value —
+// and every route to visibility (the tree eye, the controller, an action patch, a
+// sequence cue, the agent) plays the effects.
+import { useEffect, useMemo, useReducer, useRef } from 'react';
+import { findById, objectEffectClipOf } from '@3driseai/3drise-core';
+import { clipFollowsVisibility, setObjectEffectsVisible } from './objectEffects.js';
+export function usePresentedVisibility(object) {
+    const id = object?.id;
+    const visible = object?.meshSettings?.visible !== false;
+    const follows = clipFollowsVisibility(objectEffectClipOf(object));
+    const [, rerender] = useReducer((n) => n + 1, 0);
+    /** What the renderers are told. Decided while rendering, so a held change never leaks for a frame. */
+    const presented = useRef(visible);
+    if (!follows)
+        presented.current = visible; // nothing to play: straight through
+    const told = useRef(visible);
+    useEffect(() => {
+        if (told.current === visible)
+            return; // only a change plays anything (not the first mount)
+        told.current = visible;
+        const root = id ? findById(id) : null;
+        const run = setObjectEffectsVisible(root, visible);
+        let alive = true;
+        const release = () => {
+            if (!alive || presented.current === visible)
+                return;
+            presented.current = visible;
+            rerender();
+        };
+        if (run)
+            void run.then(release, release);
+        else
+            release();
+        return () => { alive = false; }; // changed again meanwhile: the newer change decides
+    }, [visible, id]);
+    const shown = presented.current;
+    return useMemo(() => (object && shown !== visible ? { ...object, meshSettings: { ...object.meshSettings, visible: shown } } : object), [object, shown, visible]);
+}

package/dist/presets/terrainBiomes.d.ts

@@ -0,0 +1,67 @@
+import { type TerrainConfig, type TerrainSurfaceConfig, type TerrainTexturesPatch } from '@3driseai/3drise-core';
+import { type TerrainPreset } from './terrainPresets';
+/**
+ * Terrain biomes — the GROUND, separate from the shape.
+ *
+ * A terrain is two independent choices: a shape (presets/terrainPresets — the
+ * landform) and a biome (this file — what the ground is made of). Any shape can
+ * wear any biome, so 20 shapes x 11 biomes are 220 looks from two clicks, and
+ * neither choice needs the user to know what a splat layer is.
+ *
+ * A biome owns: the four texture sets (with tile size, tint, brightness), the
+ * flat colours an untextured layer falls back to, the snow line, macro variation
+ * and the surface's roughness / specular. It does NOT own the slope at which rock
+ * shows: that depends on how steep the shape is, so it stays with the shape.
+ *
+ * Exposure is automatic: each textured layer is brought to the luminance of the
+ * biome's colour for that layer (lowColor … peakColor), keeping the scan's own hue
+ * and detail. So the colours below are the biome's tuned brightness per layer, and
+ * `brightness` on a layer is only for nudging on top of that.
+ */
+export interface TerrainBiome {
+    name: string;
+    description: string;
+    /** Gallery grouping: 'temperate' | 'cold' | 'arid' | 'volcanic' — or a new one. */
+    category: string;
+    tags: string[];
+    /** The ground's look: biome-owned config fields (see BIOME_KEYS) + textures. */
+    settings: Pick<Partial<TerrainSurfaceConfig>, (typeof BIOME_KEYS)[number]> & {
+        textures: TerrainTexturesPatch;
+    };
+}
+/** The config fields a biome sets. Everything else belongs to the shape. */
+export declare const BIOME_KEYS: readonly ["peakLevel", "peakBlend", "peakSlopeFalloff", "macroVariation", "macroSize", "roughness", "specular", "lowColor", "midColor", "rockColor", "peakColor"];
+export declare const terrainBiomes: TerrainBiome[];
+export declare function getTerrainBiomeByName(name: string): TerrainBiome | undefined;
+/** The biome's config fields, textures included (complete, layer by layer). */
+export declare function terrainBiomeFields(biome: TerrainBiome): Partial<TerrainConfig>;
+/**
+ * Change the landform, keep the ground. The shape's form, slope-rock thresholds,
+ * detail and lighting replace the current ones; the biome fields and the textures
+ * stay as they are. Ruggedness and Rock & snow go back to "as designed".
+ */
+export declare function applyTerrainShape(config: TerrainConfig, name: string): TerrainConfig | null;
+/**
+ * Change the ground, keep the landform. Textures are replaced whole (a biome is a
+ * set of four that belong together); the slope-rock thresholds go back to the
+ * shape's, the snow line to the biome's — Rock & snow back to "as designed".
+ */
+export declare function applyTerrainBiome(config: TerrainConfig, name: string): TerrainConfig | null;
+/** A preset = its shape + the biome it was designed with. */
+export declare function applyTerrainPreset(config: TerrainConfig, name: string): TerrainConfig | null;
+/**
+ * Ruggedness, 0..1. 0.5 is the shape as designed; up sharpens ridges, roughens the
+ * fractal and erodes less; down rounds everything off. One slider for the three
+ * numbers that together read as "rugged".
+ */
+export declare function terrainRuggednessPatch(config: TerrainConfig, r: number): Partial<TerrainConfig>;
+/**
+ * Rock & snow, 0..1. 0.5 is shape and biome as designed; up lets rock show on
+ * gentler slopes and brings the snow line down, down does the opposite.
+ */
+export declare function terrainCoveragePatch(config: TerrainConfig, c: number): Partial<TerrainConfig>;
+/** The keys the Basic tab's derived sliders write, for the live path. */
+export declare const RUGGEDNESS_KEYS: readonly ["gain", "ridgeSharpness", "erosion"];
+export declare const COVERAGE_KEYS: readonly ["slopeRockStart", "slopeRockEnd", "peakLevel"];
+export type { TerrainPreset };
+//# sourceMappingURL=terrainBiomes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"terrainBiomes.d.ts","sourceRoot":"","sources":["../../src/presets/terrainBiomes.ts"],"names":[],"mappings":"AAAA,OAAO,EAIH,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EAC5B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAA0B,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAE9E;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,WAAW,YAAY;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,mFAAmF;IACnF,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,gFAAgF;IAChF,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,oBAAoB,CAAC,EAAE,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG;QAAE,QAAQ,EAAE,oBAAoB,CAAA;KAAE,CAAC;CACnH;AAED,4EAA4E;AAC5E,eAAO,MAAM,UAAU,mKAIb,CAAC;AAgCX,eAAO,MAAM,aAAa,EAAE,YAAY,EAqIvC,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAG5E;AAYD,+EAA+E;AAC/E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CAG9E;AAcD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAsB3F;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAc3F;AAED,6DAA6D;AAC7D,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAM5F;AAID;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAS/F;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAW7F;AAED,yEAAyE;AACzE,eAAO,MAAM,eAAe,gDAAiD,CAAC;AAC9E,eAAO,MAAM,aAAa,0DAA2D,CAAC;AAEtF,YAAY,EAAE,aAAa,EAAE,CAAC"}

package/dist/presets/terrainBiomes.js

@@ -0,0 +1,294 @@
+import { TERRAIN_DEFAULTS, emptyTerrainTextures, mergeTerrainTextures, } from '@3driseai/3drise-core';
+import { getTerrainPresetByName } from './terrainPresets.js';
+/** The config fields a biome sets. Everything else belongs to the shape. */
+export const BIOME_KEYS = [
+    'peakLevel', 'peakBlend', 'peakSlopeFalloff',
+    'macroVariation', 'macroSize', 'roughness', 'specular',
+    'lowColor', 'midColor', 'rockColor', 'peakColor',
+];
+/** Metres per tile by surface kind, from the set's name. A grass scan covers
+ *  about two metres, a cliff scan five to ten. */
+function tileFor(set) {
+    if (/^(Grass|Moss|ScatteredLeaves)/.test(set))
+        return 2.5;
+    if (/^Gravel/.test(set))
+        return 3;
+    if (/^Ground/.test(set))
+        return 3.5;
+    if (/^Snow/.test(set))
+        return 4;
+    return 7; // Rock, Rocks, Granite, Travertine
+}
+/** Four layers: low and mid ground by height, rock by slope, peak at the top. */
+function T(low, mid, rock, peak) {
+    const one = (spec) => {
+        const o = typeof spec === 'string' ? { set: spec } : spec;
+        return {
+            set: o.set,
+            tileSize: o.tileSize ?? tileFor(o.set),
+            tint: o.tint ?? '#ffffff',
+            brightness: o.brightness ?? 1,
+            normalStrength: 1,
+        };
+    };
+    return { low: one(low), mid: one(mid), rock: one(rock), peak: one(peak) };
+}
+/** Straw, for grass scans in a dry biome — there is no dry-grass scan. */
+const DRY = '#f0a840';
+export const terrainBiomes = [
+    {
+        name: 'Green hills',
+        category: 'temperate',
+        description: 'Lush grass on the low ground and the tops, brown rock where it gets steep.',
+        tags: ['grass', 'green', 'pastoral'],
+        settings: {
+            textures: T('Grass008', 'Grass001', 'Rock061', 'Grass001'),
+            lowColor: '#3f5326', midColor: '#5b6b3c', rockColor: '#7a7266', peakColor: '#93a06a',
+            peakLevel: 0.9, peakBlend: 0.2, peakSlopeFalloff: 1.4,
+            macroVariation: 0.3, macroSize: 1400, roughness: 0.9, specular: 0.03,
+        },
+    },
+    {
+        name: 'Alpine meadow',
+        category: 'temperate',
+        description: 'Meadow in the valleys, scree above it, grey granite faces and a snow line.',
+        tags: ['alpine', 'snow', 'granite', 'meadow'],
+        settings: {
+            textures: T('Grass001', 'Gravel040', 'Granite002A', 'Snow014'),
+            lowColor: '#3c4a33', midColor: '#5b5a44', rockColor: '#6d6659', peakColor: '#f2f5fa',
+            peakLevel: 0.68, peakBlend: 0.1, peakSlopeFalloff: 1.6,
+            macroVariation: 0.25, macroSize: 2400, roughness: 0.82, specular: 0.06,
+        },
+    },
+    {
+        name: 'Snowfields',
+        category: 'cold',
+        description: 'Winter: snow everywhere it can lie, dark rock only on the faces too steep to hold it.',
+        tags: ['snow', 'winter', 'white', 'cold'],
+        settings: {
+            textures: T('Snow015', 'Snow012', 'Rocks011', 'Snow014'),
+            lowColor: '#dfe5ec', midColor: '#c9d1db', rockColor: '#5f5d58', peakColor: '#f4f7fb',
+            peakLevel: 0.3, peakBlend: 0.2, peakSlopeFalloff: 1.2,
+            macroVariation: 0.15, macroSize: 2000, roughness: 0.6, specular: 0.12,
+        },
+    },
+    {
+        name: 'Desert sand',
+        category: 'arid',
+        description: 'Warm dune sand, paler on the crests, dry packed earth where the slopes break.',
+        tags: ['sand', 'desert', 'dunes', 'warm'],
+        settings: {
+            textures: T('Ground097', 'Ground093C', 'Ground105', 'Ground092A'),
+            lowColor: '#b08a53', midColor: '#dcb87e', rockColor: '#9c7a4c', peakColor: '#f4e2bc',
+            peakLevel: 0.7, peakBlend: 0.24, peakSlopeFalloff: 0.6,
+            macroVariation: 0.14, macroSize: 3600, roughness: 0.55, specular: 0.16,
+        },
+    },
+    {
+        name: 'Red rock',
+        category: 'arid',
+        description: 'Red desert country: dry floors, iron-red sand and banded red cliffs.',
+        tags: ['red', 'canyon', 'sandstone', 'desert'],
+        settings: {
+            textures: T({ set: 'Ground105', tint: '#f0a080' }, { set: 'Ground097', tint: '#f0a27a' }, 'Rock029', { set: 'Ground105', tint: '#f0a080' }),
+            lowColor: '#7a4a30', midColor: '#a4643c', rockColor: '#c07a4a', peakColor: '#d9a877',
+            peakLevel: 0.85, peakBlend: 0.1, peakSlopeFalloff: 0.9,
+            macroVariation: 0.26, macroSize: 1800, roughness: 0.86, specular: 0.05,
+        },
+    },
+    {
+        name: 'Volcanic',
+        category: 'volcanic',
+        description: 'Black gravel and basalt cliffs, a dusting of snow on the summits.',
+        tags: ['volcanic', 'black', 'basalt', 'ash'],
+        settings: {
+            textures: T('Gravel024', 'Rocks022', 'Rock031', 'Snow012'),
+            lowColor: '#2a2622', midColor: '#3a342e', rockColor: '#4a423a', peakColor: '#d8d4cc',
+            peakLevel: 0.86, peakBlend: 0.06, peakSlopeFalloff: 2.2,
+            macroVariation: 0.34, macroSize: 1800, roughness: 0.94, specular: 0.02,
+        },
+    },
+    {
+        name: 'Tundra',
+        category: 'cold',
+        description: 'Frozen low ground: snow in the hollows, moss on the rises, gravel on the tops.',
+        tags: ['tundra', 'arctic', 'moss', 'cold'],
+        settings: {
+            textures: T('Snow015', { set: 'Moss002', tint: '#c8b48c' }, 'Rocks011', 'Gravel040'),
+            lowColor: '#8e9299', midColor: '#6d6f66', rockColor: '#5f5d58', peakColor: '#eaf0f6',
+            peakLevel: 0.82, peakBlend: 0.15, peakSlopeFalloff: 1.4,
+            macroVariation: 0.3, macroSize: 1400, roughness: 0.85, specular: 0.05,
+        },
+    },
+    {
+        name: 'Forest floor',
+        category: 'temperate',
+        description: 'Leaf litter and damp ground under a canopy, mossy rock on the steep banks.',
+        tags: ['forest', 'leaves', 'moss', 'damp'],
+        settings: {
+            textures: T('ScatteredLeaves009', 'Ground037', 'Rocks025', 'Moss002'),
+            lowColor: '#4a3f2a', midColor: '#4f5530', rockColor: '#5e5a4c', peakColor: '#5b6a34',
+            peakLevel: 0.9, peakBlend: 0.2, peakSlopeFalloff: 1.4,
+            macroVariation: 0.35, macroSize: 900, roughness: 0.9, specular: 0.04,
+        },
+    },
+    {
+        name: 'Moorland',
+        category: 'temperate',
+        description: 'Peat and moss over rough ground, pale granite breaking through on the tops.',
+        tags: ['moor', 'heather', 'peat', 'granite'],
+        settings: {
+            textures: T('Ground037', 'Moss002', 'Rocks025', 'Granite002A'),
+            lowColor: '#3a3626', midColor: '#4f4630', rockColor: '#6b6455', peakColor: '#6e6444',
+            peakLevel: 0.85, peakBlend: 0.2, peakSlopeFalloff: 1.4,
+            macroVariation: 0.4, macroSize: 1200, roughness: 0.92, specular: 0.03,
+        },
+    },
+    {
+        name: 'Dry grassland',
+        category: 'arid',
+        description: 'Steppe and savanna: straw-coloured grass on dry earth, grey rock outcrops.',
+        tags: ['dry', 'steppe', 'savanna', 'grass'],
+        settings: {
+            textures: T('Ground105', { set: 'Grass008', tint: DRY }, 'Rocks011', { set: 'Grass008', tint: DRY }),
+            lowColor: '#6b6836', midColor: '#8a8047', rockColor: '#7a7266', peakColor: '#a89a63',
+            peakLevel: 0.85, peakBlend: 0.2, peakSlopeFalloff: 1.4,
+            macroVariation: 0.3, macroSize: 2000, roughness: 0.9, specular: 0.03,
+        },
+    },
+    {
+        name: 'Salt flat',
+        category: 'arid',
+        description: 'A bright crust of salt and fine white sand, dry earth on the few slopes.',
+        tags: ['salt', 'white', 'flat', 'playa'],
+        settings: {
+            textures: T('Ground092A', 'Ground092A', 'Ground105', 'Ground092A'),
+            lowColor: '#cfc9bc', midColor: '#e8e4da', rockColor: '#9c8f7c', peakColor: '#f8f6f1',
+            peakLevel: 0.9, peakBlend: 0.2, peakSlopeFalloff: 0.6,
+            macroVariation: 0.12, macroSize: 3000, roughness: 0.7, specular: 0.08,
+        },
+    },
+];
+export function getTerrainBiomeByName(name) {
+    const n = name.trim().toLowerCase();
+    return terrainBiomes.find((b) => b.name.toLowerCase() === n);
+}
+// =============================================================================
+// Applying shapes and biomes — shared by the panel and the agent
+// =============================================================================
+function pick(o, keys) {
+    const out = {};
+    for (const k of keys)
+        if (o[k] !== undefined)
+            out[k] = o[k];
+    return out;
+}
+/** The biome's config fields, textures included (complete, layer by layer). */
+export function terrainBiomeFields(biome) {
+    const { textures, ...rest } = biome.settings;
+    return { ...rest, textures: mergeTerrainTextures(emptyTerrainTextures(), textures) };
+}
+/** The numbers a shape stands on: its type's defaults with its own patch over them. */
+function shapeBase(config) {
+    const shape = config.shape ? getTerrainPresetByName(config.shape) : undefined;
+    const type = shape?.terrainType ?? config.terrainType;
+    return { ...TERRAIN_DEFAULTS[type], ...(shape?.settings ?? {}) };
+}
+function biomeBase(config) {
+    const biome = config.biome ? getTerrainBiomeByName(config.biome) : undefined;
+    return biome ? pick(biome.settings, BIOME_KEYS) : TERRAIN_DEFAULTS[config.terrainType];
+}
+/**
+ * Change the landform, keep the ground. The shape's form, slope-rock thresholds,
+ * detail and lighting replace the current ones; the biome fields and the textures
+ * stay as they are. Ruggedness and Rock & snow go back to "as designed".
+ */
+export function applyTerrainShape(config, name) {
+    const shape = getTerrainPresetByName(name);
+    if (!shape)
+        return null;
+    const biome = config.biome ? getTerrainBiomeByName(config.biome) : undefined;
+    const look = biome ? pick(biome.settings, BIOME_KEYS) : pick(config, BIOME_KEYS);
+    return {
+        ...TERRAIN_DEFAULTS[shape.terrainType],
+        ...shape.settings,
+        ...look,
+        textures: config.textures,
+        textureDistance: config.textureDistance,
+        textureHeightBlend: config.textureHeightBlend,
+        enabled: config.enabled,
+        seaLevel: config.seaLevel,
+        type: 'terrain',
+        terrainType: shape.terrainType,
+        shape: shape.name,
+        biome: config.biome,
+        preset: config.biome === shape.biome ? shape.name : '',
+        ruggedness: 0.5,
+        coverage: 0.5,
+    };
+}
+/**
+ * Change the ground, keep the landform. Textures are replaced whole (a biome is a
+ * set of four that belong together); the slope-rock thresholds go back to the
+ * shape's, the snow line to the biome's — Rock & snow back to "as designed".
+ */
+export function applyTerrainBiome(config, name) {
+    const biome = getTerrainBiomeByName(name);
+    if (!biome)
+        return null;
+    const base = shapeBase(config);
+    const shape = config.shape ? getTerrainPresetByName(config.shape) : undefined;
+    return {
+        ...config,
+        ...terrainBiomeFields(biome),
+        slopeRockStart: base.slopeRockStart,
+        slopeRockEnd: base.slopeRockEnd,
+        biome: biome.name,
+        preset: shape && shape.biome === biome.name ? shape.name : '',
+        coverage: 0.5,
+    };
+}
+/** A preset = its shape + the biome it was designed with. */
+export function applyTerrainPreset(config, name) {
+    const shape = getTerrainPresetByName(name);
+    if (!shape)
+        return null;
+    const withBiome = applyTerrainBiome({ ...config, shape: shape.name }, shape.biome) ?? config;
+    const out = applyTerrainShape(withBiome, shape.name);
+    return out ? { ...out, preset: shape.name } : null;
+}
+const clamp = (v, lo, hi) => Math.min(hi, Math.max(lo, v));
+/**
+ * Ruggedness, 0..1. 0.5 is the shape as designed; up sharpens ridges, roughens the
+ * fractal and erodes less; down rounds everything off. One slider for the three
+ * numbers that together read as "rugged".
+ */
+export function terrainRuggednessPatch(config, r) {
+    const base = shapeBase(config);
+    const d = clamp(r, 0, 1) - 0.5;
+    return {
+        ruggedness: clamp(r, 0, 1),
+        gain: clamp(base.gain + d * 0.16, 0.3, 0.68),
+        ridgeSharpness: clamp(base.ridgeSharpness + d * 0.7, 0, 1),
+        erosion: clamp(base.erosion - d * 0.6, 0, 1),
+    };
+}
+/**
+ * Rock & snow, 0..1. 0.5 is shape and biome as designed; up lets rock show on
+ * gentler slopes and brings the snow line down, down does the opposite.
+ */
+export function terrainCoveragePatch(config, c) {
+    const shape = shapeBase(config);
+    const biome = biomeBase(config);
+    const d = clamp(c, 0, 1) - 0.5;
+    const start = clamp((shape.slopeRockStart ?? 0.35) - d * 0.5, 0.02, 0.95);
+    return {
+        coverage: clamp(c, 0, 1),
+        slopeRockStart: start,
+        slopeRockEnd: clamp((shape.slopeRockEnd ?? 0.62) - d * 0.5, start + 0.05, 1),
+        peakLevel: clamp((biome.peakLevel ?? 0.62) - d * 0.8, 0, 1),
+    };
+}
+/** The keys the Basic tab's derived sliders write, for the live path. */
+export const RUGGEDNESS_KEYS = ['gain', 'ridgeSharpness', 'erosion'];
+export const COVERAGE_KEYS = ['slopeRockStart', 'slopeRockEnd', 'peakLevel'];

package/dist/presets/terrainPresets.d.ts

@@ -19,7 +19,13 @@ export interface TerrainPreset {
     terrainType: TerrainType;
     description: string;
     tags: string[];
+    /** The SHAPE: the numbers that make the landform — form, slope-rock
+     *  thresholds, detail, lighting. Never the ground's look; that is a biome
+     *  (presets/terrainBiomes), so any shape can wear any ground. */
     settings: Partial<TerrainSurfaceConfig>;
+    /** The biome this shape was designed with. Picking the PRESET applies both;
+     *  picking it as a shape keeps whatever ground is on. */
+    biome: string;
 }
 export declare const terrainPresets: TerrainPreset[];
 export declare function getTerrainPresetsForType(type: TerrainType): TerrainPreset[];

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

@@ -1 +1 @@
-{"version":3,"file":"terrainPresets.d.ts","sourceRoot":"","sources":["../../src/presets/terrainPresets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAE/E;;;;;;;;;;;;;;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"}
+{"version":3,"file":"terrainPresets.d.ts","sourceRoot":"","sources":["../../src/presets/terrainPresets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAE/E;;;;;;;;;;;;;;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;;qEAEiE;IACjE,QAAQ,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACxC;6DACyD;IACzD,KAAK,EAAE,MAAM,CAAC;CACjB;AAoRD,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"}