@3driseai/3drise-core 1.0.21 → 1.0.23

package/dist/data/textDefaults.js

@@ -0,0 +1,219 @@
+// =============================================================================
+// TEXT OBJECTS — defaults, labels, animatable knobs
+// =============================================================================
+//
+// The animatable list of each look is what its push point applies per frame
+// (useTextObject -> the look's apply): the look's colours and numbers. Structural
+// knobs (text, font, draw / erase methods, a look's detail count), switches and
+// the playback timings are never listed.
+//
+export const DEFAULT_TEXT_OBJECTS = {
+    handwriting: { type: 'handwriting', shown: true, text: 'Hello, world', font: 'caveat', drawMethod: 'pen', drawDuration: 5, drawEase: 'easeInOut', drawStagger: 0.6, drawAngle: 0, eraseMethod: 'fade', eraseDuration: 2, eraseEase: 'easeInOut', eraseStagger: 0.6, eraseAngle: 0, autoPlay: true, loop: false, yoyo: false, holdTime: 2, hiddenTime: 0.5, color: '#efe6d2', color2: '#ffd9a0', weight: 1, wetTime: 1.1, sheen: 0.35, opacity: 1, penGlow: 1 },
+    neonTube: { type: 'neonTube', shown: true, text: 'Hello, world', font: 'caveat', drawMethod: 'trace', drawDuration: 5, drawEase: 'easeInOut', drawStagger: 0.6, drawAngle: 0, eraseMethod: 'undraw', eraseDuration: 2, eraseEase: 'easeInOut', eraseStagger: 0.6, eraseAngle: 0, autoPlay: true, loop: false, yoyo: false, holdTime: 2, hiddenTime: 0.5, color: '#ff2f9a', color2: '#ffd2ec', tube: 0.04, core: 0.22, glow: 1, flicker: 1, offLevel: 0.07, opacity: 1 },
+    fourierSketch: { type: 'fourierSketch', shown: true, text: 'Hello, world', font: 'caveat', drawMethod: 'epicycle', drawDuration: 5, drawEase: 'easeInOut', drawStagger: 0.6, drawAngle: 0, eraseMethod: 'fade', eraseDuration: 2, eraseEase: 'easeInOut', eraseStagger: 0.6, eraseAngle: 0, autoPlay: true, loop: false, yoyo: false, holdTime: 2, hiddenTime: 0.5, color: '#5fd0ff', color2: '#fff1c2', line: 0.03, terms: 96, circles: 1, trail: 0.9, bridges: 0.14, glint: 1, opacity: 1 },
+    frostGrowth: { type: 'frostGrowth', shown: true, text: 'Hello, world', font: 'caveat', drawMethod: 'grow', drawDuration: 6, drawEase: 'linear', drawStagger: 0.6, drawAngle: 0, eraseMethod: 'sublimate', eraseDuration: 3, eraseEase: 'linear', eraseStagger: 0.6, eraseAngle: 0, autoPlay: true, loop: false, yoyo: false, holdTime: 2, hiddenTime: 0.5, reach: 0.15, branching: 1, grains: 5, sparkle: 0.6, thickness: 1, seams: 0.75, haze: 0.5, seed: 7, color: '#d6edff', color2: '#4a90d4', opacity: 1 },
+    plasmaDischarge: { type: 'plasmaDischarge', shown: true, text: 'Hello, world', font: 'caveat', drawMethod: 'strike', drawDuration: 5, drawEase: 'easeInOut', drawStagger: 0.6, drawAngle: 0, eraseMethod: 'undraw', eraseDuration: 2, eraseEase: 'easeInOut', eraseStagger: 0.6, eraseAngle: 0, autoPlay: true, loop: false, yoyo: false, holdTime: 2, hiddenTime: 0.5, branches: 0.72, reach: 0.55, branchiness: 0.6, pulse: 0.8, glow: 1, spectrum: 0.5, core: 0.0065, color: '#6c3dff', color2: '#a9ceff', opacity: 1, seed: 7 },
+    burnAway: { type: 'burnAway', shown: true, text: 'Hello, world', font: 'caveat', drawMethod: 'trace', drawDuration: 5, drawEase: 'easeInOut', drawStagger: 0.6, drawAngle: 0, eraseMethod: 'burn', eraseDuration: 6, eraseEase: 'linear', eraseStagger: 0.6, eraseAngle: 0, autoPlay: true, loop: false, yoyo: false, holdTime: 2.5, hiddenTime: 0.5, color: '#efe2c4', color2: '#ff7a1c', char: 0.6, ashLace: 0.7, curl: 0.6, spread: 1, ember: 1, roughness: 0.6, singe: 0.55, opacity: 1, seed: 7 },
+    lightPainting: { type: 'lightPainting', shown: true, text: 'Hello, world', font: 'caveat', drawMethod: 'pen', drawDuration: 5, drawEase: 'easeInOut', drawStagger: 0.6, drawAngle: 0, eraseMethod: 'pen', eraseDuration: 2, eraseEase: 'easeInOut', eraseStagger: 0.6, eraseAngle: 0, autoPlay: true, loop: false, yoyo: false, holdTime: 2, hiddenTime: 0.5, exposure: 1, temperature: 3000, sparks: 110, spread: 0.7, bloom: 1, width: 0.012, strobe: 0, halation: 0.55, tremor: 0.5, color: '#ffe0b0', color2: '#ffffff', opacity: 1 },
+    constellation: { type: 'constellation', shown: true, text: 'Hello, world', font: 'caveat', drawMethod: 'pen', drawDuration: 5, drawEase: 'easeInOut', drawStagger: 0.6, drawAngle: 0, eraseMethod: 'undraw', eraseDuration: 2, eraseEase: 'easeInOut', eraseStagger: 0.6, eraseAngle: 0, autoPlay: true, loop: false, yoyo: false, holdTime: 2, hiddenTime: 0.5, stars: 5.5, brightness: 0, twinkle: 1, lines: 1, temperature: 0, seed: 7, color: '#7f9bd0', color2: '#dce8ff', opacity: 1 },
+    inkBleed: { type: 'inkBleed', shown: true, text: 'Hello, world', font: 'caveat', drawMethod: 'pen', drawDuration: 5, drawEase: 'easeInOut', drawStagger: 0.6, drawAngle: 0, eraseMethod: 'burn', eraseDuration: 6, eraseEase: 'linear', eraseStagger: 0.6, eraseAngle: 0, autoPlay: true, loop: false, yoyo: false, holdTime: 2.5, hiddenTime: 0.5, color: '#1b2d6a', color2: '#b0703c', bleed: 0.042, dryTime: 2.4, fibre: 0.7, pooling: 0.7, weight: 0.7, paper: 1, oxidation: 3.5, burn: 0.6, char: 0.6, spread: 1, opacity: 1 },
+    liquidMetal: { type: 'liquidMetal', shown: true, text: 'Hello, world', font: 'caveat', drawMethod: 'flow', drawDuration: 5, drawEase: 'easeInOut', drawStagger: 0.6, drawAngle: 0, eraseMethod: 'melt', eraseDuration: 4.5, eraseEase: 'linear', eraseStagger: 0.6, eraseAngle: 0, autoPlay: true, loop: false, yoyo: false, holdTime: 2, hiddenTime: 0.5, thickness: 0.06, roughness: 1, reflectivity: 0.8, environment: 1.15, tint: 0.7, rippleSpeed: 1, oxide: 0.4, spikes: 0, melt: 0.5, drips: 0.6, color: '#cdd5df', color2: '#f4f7ff', opacity: 1 },
+    embroidery: { type: 'embroidery', shown: true, text: 'Hello, world', font: 'caveat', drawMethod: 'stitch', drawDuration: 5, drawEase: 'easeInOut', drawStagger: 0.6, drawAngle: 0, eraseMethod: 'undraw', eraseDuration: 2, eraseEase: 'easeInOut', eraseStagger: 0.6, eraseAngle: 0, autoPlay: true, loop: false, yoyo: false, holdTime: 2, hiddenTime: 0.5, color: '#c92f48', color2: '#e8c47a', density: 44, slant: 66, thickness: 1.35, sheen: 1, relief: 1, outline: 0.65, fabric: 0.4, pucker: 0.6, style: 'auto', opacity: 1 },
+    chalkboard: { type: 'chalkboard', shown: true, text: 'Hello, world', font: 'caveat', drawMethod: 'pen', drawDuration: 5, drawEase: 'easeInOut', drawStagger: 0.6, drawAngle: 0, eraseMethod: 'smudge', eraseDuration: 2, eraseEase: 'easeInOut', eraseStagger: 0.6, eraseAngle: 0, autoPlay: true, loop: false, yoyo: false, holdTime: 2, hiddenTime: 0.5, pressure: 0.55, chatter: 0.6, grain: 0.55, weight: 1, dust: 0.6, ghost: 0.5, swing: 0.6, board: 0, opacity: 1, color: '#ebe6d8', color2: '#c4dcf2' },
+    plain: { type: 'plain', shown: true, text: 'Hello', font: 'inter', drawMethod: 'fade', drawDuration: 1.2, drawEase: 'easeInOut', drawStagger: 0.6, drawAngle: 0, eraseMethod: 'fade', eraseDuration: 0.8, eraseEase: 'easeInOut', eraseStagger: 0.6, eraseAngle: 0, autoPlay: true, loop: false, yoyo: false, holdTime: 2, hiddenTime: 0.5, color: '#ffffff', color2: '#111111', weight: 0, outline: 0, fill: 1, softness: 0, opacity: 1 },
+};
+export const TEXT_OBJECT_LABELS = {
+    handwriting: 'Handwriting',
+    neonTube: 'Neon Tube',
+    fourierSketch: 'Fourier Sketch',
+    frostGrowth: 'Frost Growth',
+    plasmaDischarge: 'Plasma Discharge',
+    burnAway: 'Burn Away',
+    lightPainting: 'Light Painting',
+    constellation: 'Constellation',
+    inkBleed: 'Ink Bleed',
+    liquidMetal: 'Liquid Metal',
+    embroidery: 'Embroidery',
+    chalkboard: 'Chalkboard',
+    plain: 'Plain',
+};
+export const TEXT_OBJECTS_ANIMATABLE = {
+    handwriting: [
+        { value: 'weight', label: 'Pen weight' },
+        { value: 'color', label: 'Ink' },
+        { value: 'color2', label: 'Wet ink' },
+        { value: 'wetTime', label: 'Drying time' },
+        { value: 'sheen', label: 'Sheen' },
+        { value: 'penGlow', label: 'Pen glow' },
+        { value: 'opacity', label: 'Opacity' },
+    ],
+    neonTube: [
+        { value: 'color', label: 'Tube colour' },
+        { value: 'glow', label: 'Glow' },
+        { value: 'tube', label: 'Tube thickness' },
+        { value: 'flicker', label: 'Flicker' },
+        { value: 'color2', label: 'Hot core' },
+        { value: 'core', label: 'Core width' },
+        { value: 'offLevel', label: 'Unlit glass' },
+        { value: 'opacity', label: 'Opacity' },
+    ],
+    fourierSketch: [
+        { value: 'color', label: 'Line colour' },
+        { value: 'circles', label: 'Circles' },
+        { value: 'glint', label: 'Glints' },
+        { value: 'color2', label: 'Hot colour' },
+        { value: 'line', label: 'Line width' },
+        { value: 'trail', label: 'Trail' },
+        { value: 'bridges', label: 'Bridges' },
+        { value: 'opacity', label: 'Opacity' },
+    ],
+    frostGrowth: [
+        { value: 'sparkle', label: 'Sparkle' },
+        { value: 'thickness', label: 'Thickness' },
+        { value: 'seams', label: 'Grain seams' },
+        { value: 'haze', label: 'Frost haze' },
+        { value: 'color', label: 'Ice' },
+        { value: 'color2', label: 'Deep ice' },
+        { value: 'opacity', label: 'Opacity' },
+    ],
+    plasmaDischarge: [
+        { value: 'branches', label: 'Branching' },
+        { value: 'reach', label: 'Reach' },
+        { value: 'glow', label: 'Glow' },
+        { value: 'pulse', label: 'Current pulses' },
+        { value: 'spectrum', label: 'Emission lines' },
+        { value: 'core', label: 'Core width' },
+        { value: 'color', label: 'Plasma' },
+        { value: 'color2', label: 'Hot core' },
+        { value: 'opacity', label: 'Opacity' },
+    ],
+    burnAway: [
+        { value: 'char', label: 'Char' },
+        { value: 'spread', label: 'Spread' },
+        { value: 'ember', label: 'Ember' },
+        { value: 'color', label: 'Paper' },
+        { value: 'color2', label: 'Ember colour' },
+        { value: 'roughness', label: 'Raggedness' },
+        { value: 'singe', label: 'Singe' },
+        { value: 'ashLace', label: 'Ash lace' },
+        { value: 'curl', label: 'Curl' },
+        { value: 'opacity', label: 'Opacity' },
+    ],
+    lightPainting: [
+        { value: 'exposure', label: 'Exposure' },
+        { value: 'temperature', label: 'Temperature' },
+        { value: 'strobe', label: 'Strobe' },
+        { value: 'sparks', label: 'Sparks' },
+        { value: 'width', label: 'Trail width' },
+        { value: 'halation', label: 'Halation' },
+        { value: 'spread', label: 'Spread' },
+        { value: 'bloom', label: 'Bloom' },
+        { value: 'color', label: 'Colour' },
+        { value: 'color2', label: 'Hot core' },
+        { value: 'opacity', label: 'Opacity' },
+    ],
+    constellation: [
+        { value: 'brightness', label: 'Brightness' },
+        { value: 'temperature', label: 'Temperature' },
+        { value: 'lines', label: 'Chart lines' },
+        { value: 'twinkle', label: 'Twinkle' },
+        { value: 'color', label: 'Line colour' },
+        { value: 'color2', label: 'Highlight / tint' },
+        { value: 'opacity', label: 'Opacity' },
+    ],
+    inkBleed: [
+        { value: 'bleed', label: 'Bleed' },
+        { value: 'color', label: 'Ink' },
+        { value: 'weight', label: 'Pen weight' },
+        { value: 'paper', label: 'Paper' },
+        { value: 'color2', label: 'Fringe dye' },
+        { value: 'dryTime', label: 'Drying time' },
+        { value: 'fibre', label: 'Fibre' },
+        { value: 'pooling', label: 'Pooling' },
+        { value: 'oxidation', label: 'Oxidation' },
+        { value: 'burn', label: 'Ink burn' },
+        { value: 'char', label: 'Char' },
+        { value: 'spread', label: 'Spread' },
+        { value: 'opacity', label: 'Opacity' },
+    ],
+    liquidMetal: [
+        { value: 'thickness', label: 'Thickness' },
+        { value: 'environment', label: 'Environment' },
+        { value: 'color', label: 'Metal colour' },
+        { value: 'tint', label: 'Metal tint' },
+        { value: 'melt', label: 'Melt' },
+        { value: 'drips', label: 'Drips' },
+        { value: 'spikes', label: 'Spikes' },
+        { value: 'oxide', label: 'Oxide skin' },
+        { value: 'reflectivity', label: 'Reflectivity' },
+        { value: 'roughness', label: 'Ripples' },
+        { value: 'rippleSpeed', label: 'Ripple speed' },
+        { value: 'color2', label: 'Edge tint' },
+        { value: 'opacity', label: 'Opacity' },
+    ],
+    embroidery: [
+        { value: 'color', label: 'Thread' },
+        { value: 'sheen', label: 'Sheen' },
+        { value: 'color2', label: 'Contrast thread' },
+        { value: 'relief', label: 'Relief' },
+        { value: 'outline', label: 'Border row' },
+        { value: 'fabric', label: 'Fabric' },
+        { value: 'pucker', label: 'Pucker' },
+        { value: 'opacity', label: 'Opacity' },
+    ],
+    chalkboard: [
+        { value: 'pressure', label: 'Pressure' },
+        { value: 'chatter', label: 'Chatter' },
+        { value: 'grain', label: 'Grain' },
+        { value: 'dust', label: 'Dust' },
+        { value: 'weight', label: 'Weight' },
+        { value: 'swing', label: 'Swing' },
+        { value: 'ghost', label: 'Ghost' },
+        { value: 'board', label: 'Board' },
+        { value: 'opacity', label: 'Opacity' },
+        { value: 'color', label: 'Chalk' },
+        { value: 'color2', label: 'Highlight' },
+    ],
+    plain: [
+        { value: 'color', label: 'Colour' },
+        { value: 'weight', label: 'Weight' },
+        { value: 'outline', label: 'Outline' },
+        { value: 'opacity', label: 'Opacity' },
+        { value: 'color2', label: 'Outline colour' },
+        { value: 'fill', label: 'Fill' },
+        { value: 'softness', label: 'Softness' },
+    ],
+};
+/** The typefaces every look can use: the id is stored, the family is the Google Fonts name used to preview it. */
+export const TEXT_FONTS = [
+    // clean text faces (plain labels, mesh text)
+    { id: 'inter', label: 'Inter', family: 'Inter' },
+    { id: 'roboto', label: 'Roboto', family: 'Roboto' },
+    { id: 'montserrat', label: 'Montserrat', family: 'Montserrat' },
+    { id: 'poppins', label: 'Poppins', family: 'Poppins' },
+    { id: 'oswald', label: 'Oswald', family: 'Oswald' },
+    { id: 'bebas-neue', label: 'Bebas Neue', family: 'Bebas Neue' },
+    { id: 'playfair-display', label: 'Playfair Display', family: 'Playfair Display' },
+    { id: 'lora', label: 'Lora', family: 'Lora' },
+    // handwriting faces (the pen looks)
+    { id: 'caveat', label: 'Caveat', family: 'Caveat' },
+    { id: 'kalam', label: 'Kalam', family: 'Kalam' },
+    { id: 'handlee', label: 'Handlee', family: 'Handlee' },
+    { id: 'patrick-hand', label: 'Patrick Hand', family: 'Patrick Hand' },
+    { id: 'architects-daughter', label: 'Architect\'s Daughter', family: 'Architects Daughter' },
+    { id: 'indie-flower', label: 'Indie Flower', family: 'Indie Flower' },
+    { id: 'gochi-hand', label: 'Gochi Hand', family: 'Gochi Hand' },
+    { id: 'nanum-pen-script', label: 'Nanum Pen', family: 'Nanum Pen Script' },
+    { id: 'mynerve', label: 'Mynerve', family: 'Mynerve' },
+    { id: 'dancing-script', label: 'Dancing Script', family: 'Dancing Script' },
+    { id: 'courgette', label: 'Courgette', family: 'Courgette' },
+    { id: 'satisfy', label: 'Satisfy', family: 'Satisfy' },
+    { id: 'kaushan-script', label: 'Kaushan Script', family: 'Kaushan Script' },
+    { id: 'sriracha', label: 'Sriracha', family: 'Sriracha' },
+    { id: 'pacifico', label: 'Pacifico', family: 'Pacifico' },
+];
+/** True when the config is one of the text looks (object type 'text', config.type set). */
+export function isTextObjectConfig(config) {
+    const t = config?.type;
+    return typeof t === 'string' && Object.prototype.hasOwnProperty.call(DEFAULT_TEXT_OBJECTS, t);
+}

package/dist/environment/oceanConfigs.d.ts

@@ -17,6 +17,7 @@
  * three of the four cloud types share one marcher and all four landforms share
  * one height field. `waterType` shapes the spectrum; `host` chooses the mesh.
  */
+import type { ObjectAnimations, MouseMoveInteractions } from '../types/objectSettings';
 /** The four water bodies the spectrum is shaped for. */
 export type WaterType = 'sea' | 'lake' | 'storm' | 'shore';
 /**
@@ -275,10 +276,10 @@ export interface OceanWaterSettings {
     quality: OceanQualityConfig;
     /** Object host only. */
     meshSettings?: OceanMeshSettings;
-    /** Per-domain keyframes. Object host only, like any other scene object. */
-    animations?: unknown;
-    /** Per-domain pointer interactions. Object host only. */
-    mouseMove?: unknown;
+    /** Per-domain keyframes; the `ocean` domain drives the water's config knobs. */
+    animations?: ObjectAnimations;
+    /** Per-domain pointer bindings; same `ocean` domain. */
+    mouseMove?: MouseMoveInteractions;
 }
 export declare const defaultOceanWaterSettings: OceanWaterSettings;
 /**

package/dist/environment/oceanConfigs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"oceanConfigs.d.ts","sourceRoot":"","sources":["../../src/environment/oceanConfigs.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"oceanConfigs.d.ts","sourceRoot":"","sources":["../../src/environment/oceanConfigs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEvF,wDAAwD;AACxD,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAE3D;;;;;;;;;GASG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE3C,uEAAuE;AACvE,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,KAAK,CAAC;AAE3C,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,KAAK,GAAG,KAAK,CAAC;AAEtD,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,IAAI,GAAG,KAAK,CAAC;AAEvD,iEAAiE;AACjE,MAAM,WAAW,kBAAkB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,SAAS,CAAC;IAChB;;8EAE0E;IAC1E,SAAS,EAAE,SAAS,CAAC;IAGrB;;;;0DAIsD;IACtD,QAAQ,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvB,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB;;mCAE+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IAEjB;;6EAEyE;IACzE,SAAS,EAAE,MAAM,CAAC;IAClB,+EAA+E;IAC/E,WAAW,EAAE,MAAM,CAAC;IACpB;;qCAEiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd;oEACgE;IAChE,iBAAiB,EAAE,MAAM,CAAC;IAC1B;mDAC+C;IAC/C,cAAc,EAAE,MAAM,CAAC;IACvB;8DAC0D;IAC1D,cAAc,EAAE,MAAM,CAAC;IACvB;;;0CAGsC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB;uEACmE;IACnE,KAAK,EAAE,MAAM,CAAC;IACd;iFAC6E;IAC7E,SAAS,EAAE,MAAM,CAAC;IAGlB,6DAA6D;IAC7D,UAAU,EAAE,MAAM,CAAC;IACnB;;8DAE0D;IAC1D,SAAS,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAC;IAGjB,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB;;2BAEuB;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,UAAU,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAC;IAChB;oCACgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB;iEAC6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB;6EACyE;IACzE,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB;uEACmE;IACnE,cAAc,EAAE,MAAM,CAAC;IACvB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IAGnB,UAAU,EAAE,cAAc,CAAC;IAC3B,yEAAyE;IACzE,UAAU,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;IAChB;mFAC+E;IAC/E,iBAAiB,EAAE,MAAM,CAAC;IAC1B;+EAC2E;IAC3E,QAAQ,EAAE,MAAM,CAAC;IAGjB;wEACoE;IACpE,kBAAkB,EAAE,kBAAkB,CAAC;IACvC;;oFAEgF;IAChF,aAAa,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,UAAU,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GAAG,kBAAkB,GAAG;IAC3C,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,SAAS,CAAC;IACrB;sEACkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;8BAE8B;AAC9B,MAAM,WAAW,kBAAkB;IAC/B;wDACoD;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB;qEACiE;IACjE,QAAQ,EAAE,MAAM,CAAC;IACjB;yEACqE;IACrE,SAAS,EAAE,MAAM,CAAC;IAClB;qEACiE;IACjE,eAAe,EAAE,MAAM,CAAC;IACxB,2EAA2E;IAC3E,eAAe,EAAE,MAAM,CAAC;IACxB,4EAA4E;IAC5E,kBAAkB,EAAE,MAAM,CAAC;IAC3B;oDACgD;IAChD,qBAAqB,EAAE,MAAM,CAAC;IAC9B,sEAAsE;IACtE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,8EAA8E;IAC9E,cAAc,EAAE,OAAO,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;CACtB;AAqDD,gFAAgF;AAChF,eAAO,MAAM,gBAAgB,EAAE,WAM9B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,WAoB/B,CAAC;AAEF,yEAAyE;AACzE,eAAO,MAAM,kBAAkB,EAAE,WAsBhC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,WAoBhC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,kBAYjC,CAAC;AAEF,6DAA6D;AAC7D,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,SAAS,EAAE,WAAW,CAKzD,CAAC;AAEF;0EAC0E;AAC1E,eAAO,MAAM,qBAAqB,EAAE,OAAO,CAAC,kBAAkB,CAa7D,CAAC;AAMF,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;AAEpF;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAmB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,kBAAkB,CAAC;IAC1B;;;kDAG8C;IAC9C,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC7D,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;sFACkF;IAClF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,yDAAyD;IACzD,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC;IACpB;;kDAE8C;IAC9C,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC;CACvB;AAED,eAAO,MAAM,YAAY,EAAE,mBAAmB,EAqC7C,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,mBAAmB,EAUrD,CAAC;AAMF,uEAAuE;AACvE,MAAM,WAAW,iBAAiB;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,kBAAkB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,kBAAkB,CAAC;IAC5B,wBAAwB;IACxB,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,gFAAgF;IAChF,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,wDAAwD;IACxD,SAAS,CAAC,EAAE,qBAAqB,CAAC;CACrC;AAED,eAAO,MAAM,yBAAyB,EAAE,kBAKvC,CAAC;AAkGF;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,WAAW,GAAG,IAAI,CA4BhF;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,kBAAkB,CAEtE;AAED,wDAAwD;AACxD,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,kBAAkB,CAqBvE"}

package/dist/environment/oceanConfigs.js

@@ -372,9 +372,9 @@ export function normalizeOceanSettings(raw) {
             scale: (Array.isArray(mesh.scale) ? mesh.scale : [1, 1, 1]),
         };
     }
-    if (source.animations)
+    if (isRecord(source.animations))
         settings.animations = source.animations;
-    if (source.mouseMove)
+    if (isRecord(source.mouseMove))
         settings.mouseMove = source.mouseMove;
     return settings;
 }

package/dist/environment/terrainConfigs.d.ts

@@ -15,8 +15,59 @@
  * 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.
  */
+import type { ObjectAnimations, MouseMoveInteractions } from '../types/objectSettings';
 /** The four landforms the height function shapes. */
 export type TerrainType = 'mountains' | 'dunes' | 'hills' | 'canyon';
+/** The four splat layers. Same four the colours have always been: low and mid by
+ *  height, rock by slope, peak (snow, salt, bleached stone) at the top. */
+export type TerrainLayerKey = 'low' | 'mid' | 'rock' | 'peak';
+export declare const TERRAIN_LAYER_KEYS: readonly TerrainLayerKey[];
+/** A texture set's map URLs. Filled by the client from the texture library when a
+ *  set is assigned, and stored, so an embed renders without the library. */
+export interface TerrainLayerMaps {
+    color?: string;
+    normal?: string;
+    roughness?: string;
+    ao?: string;
+    displacement?: string;
+}
+/**
+ * One splat layer's surface.
+ *
+ * A textured layer shows the set's OWN colours and detail — so picking a
+ * different set visibly changes the ground. Its exposure is automatic: scans are
+ * shot at all sorts of brightness, so the texture is first brought to the
+ * LUMINANCE of the layer's colour (`lowColor` … `peakColor`, set by the biome),
+ * then × `tint` × `brightness`. The distant ground is the texture's mean × the
+ * same factors, so near and far agree. A layer with no set is its flat colour.
+ */
+export interface TerrainTextureLayer {
+    /** Texture-library set name (e.g. 'Grass008'). '' = no texture: the layer is
+     *  drawn in its flat colour, as before textures existed. */
+    set: string;
+    /** Resolved map URLs for `set`. Empty until resolved. */
+    maps: TerrainLayerMaps;
+    /** Metres of ground one texture tile covers. */
+    tileSize: number;
+    /** Multiplies the texture's colour. '#ffffff' = as photographed. */
+    tint: string;
+    /** Multiplies the texture's brightness, on top of the automatic exposure.
+     *  1 = the ground's tuned brightness. */
+    brightness: number;
+    /** Normal-map strength. */
+    normalStrength: number;
+}
+export type TerrainTextures = Record<TerrainLayerKey, TerrainTextureLayer>;
+/** Partial form, for presets and patches: a set name and optionally the numbers. */
+export type TerrainTexturesPatch = Partial<Record<TerrainLayerKey, Partial<TerrainTextureLayer>>>;
+export declare const defaultTerrainTextureLayer: TerrainTextureLayer;
+export declare function emptyTerrainTextures(): TerrainTextures;
+/**
+ * Layer-wise merge. A patch that changes a layer's set without restating its maps
+ * clears the maps, so a stale URL from the previous set never draws under the
+ * new name.
+ */
+export declare function mergeTerrainTextures(base: TerrainTextures | undefined, patch: TerrainTexturesPatch | undefined): TerrainTextures;
 /** Fields every terrain shares, whatever its landform. */
 export interface TerrainSurfaceConfig {
     enabled: boolean;
@@ -110,6 +161,16 @@ export interface TerrainSurfaceConfig {
     roughness: number;
     /** Specular strength. Rock is nearly matte; wet sand and snow are not. */
     specular: number;
+    /** Real surfaces per splat layer, from the texture library. A layer with no set
+     *  keeps its flat colour. */
+    textures: TerrainTextures;
+    /** Distance, in metres, out to which the textures are drawn. Past it each
+     *  layer fades into its flat far colour (a textured layer's own mean colour),
+     *  which costs nothing per pixel — the horizon stays as cheap as it was. */
+    textureDistance: number;
+    /** 0 = layers cross-fade; 1 = the layer whose own surface is higher wins, so
+     *  rock pushes up through grass along its cracks instead of fading in. */
+    textureHeightBlend: number;
     /** Sky fill. Terrain is lit by the whole dome, not only the sun, and freezing
      *  this is what makes a night landscape glow. */
     ambient: number;
@@ -140,6 +201,18 @@ export type TerrainConfig = TerrainSurfaceConfig & {
     /** Name of the preset the numbers came from, or '' once any of them is edited.
      *  Purely a UI bookmark — the renderer never reads it. */
     preset?: string;
+    /** The shape (landform preset) last picked — a UI bookmark. The Basic tab's
+     *  Ruggedness slider is measured against this shape's own numbers. */
+    shape?: string;
+    /** The biome (ground look) last picked — a UI bookmark. The Rock & snow slider
+     *  is measured against this biome's snow line. */
+    biome?: string;
+    /** Basic-tab Ruggedness, 0..1, 0.5 = the shape as designed. A bookmark: the
+     *  numbers it drives (gain, ridge sharpness, erosion) are in the config. */
+    ruggedness?: number;
+    /** Basic-tab Rock & snow, 0..1, 0.5 = shape and biome as designed. A bookmark
+     *  for the slope-rock thresholds and the snow line it moves. */
+    coverage?: number;
 };
 /** Cost and extent knobs. */
 export interface TerrainQualityConfig {
@@ -234,6 +307,11 @@ export interface ProceduralTerrainSettings {
      *  editable block. */
     config: TerrainConfig;
     quality: TerrainQualityConfig;
+    /** Per-domain keyframes; the `terrain` domain drives the surface's lighting and
+     *  colour knobs. The land shape is never animatable (see TERRAIN_SCHEMA). */
+    animations?: ObjectAnimations;
+    /** Per-domain pointer bindings; same `terrain` domain. */
+    mouseMove?: MouseMoveInteractions;
 }
 export declare const defaultProceduralTerrainSettings: ProceduralTerrainSettings;
 /**

package/dist/environment/terrainConfigs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"terrainConfigs.d.ts","sourceRoot":"","sources":["../../src/environment/terrainConfigs.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"terrainConfigs.d.ts","sourceRoot":"","sources":["../../src/environment/terrainConfigs.ts"],"names":[],"mappings":"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"}

package/dist/environment/terrainConfigs.js

@@ -15,6 +15,55 @@
  * 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.
  */
+export const TERRAIN_LAYER_KEYS = ['low', 'mid', 'rock', 'peak'];
+export const defaultTerrainTextureLayer = {
+    set: '',
+    maps: {},
+    tileSize: 3,
+    tint: '#ffffff',
+    brightness: 1,
+    normalStrength: 1,
+};
+/** Per-layer default tile size: rock reads right a little larger than ground. */
+const LAYER_TILE = { low: 3, mid: 3, rock: 6, peak: 4 };
+export function emptyTerrainTextures() {
+    const out = {};
+    for (const k of TERRAIN_LAYER_KEYS)
+        out[k] = { ...defaultTerrainTextureLayer, maps: {}, tileSize: LAYER_TILE[k] };
+    return out;
+}
+/**
+ * Layer-wise merge. A patch that changes a layer's set without restating its maps
+ * clears the maps, so a stale URL from the previous set never draws under the
+ * new name.
+ */
+export function mergeTerrainTextures(base, patch) {
+    const from = base ?? emptyTerrainTextures();
+    const out = {};
+    for (const k of TERRAIN_LAYER_KEYS) {
+        const b = from[k] ?? { ...defaultTerrainTextureLayer, tileSize: LAYER_TILE[k] };
+        const p = patch?.[k];
+        if (!p) {
+            out[k] = { ...b, maps: { ...b.maps } };
+            continue;
+        }
+        const setChanged = p.set !== undefined && p.set !== b.set;
+        out[k] = {
+            ...b,
+            ...p,
+            maps: p.maps ? { ...p.maps } : setChanged ? {} : { ...b.maps },
+        };
+    }
+    return out;
+}
+function texturesOf(sets, tiles = {}) {
+    const patch = {};
+    for (const k of TERRAIN_LAYER_KEYS) {
+        if (sets[k] !== undefined || tiles[k] !== undefined)
+            patch[k] = { ...(sets[k] !== undefined ? { set: sets[k] } : {}), ...(tiles[k] !== undefined ? { tileSize: tiles[k] } : {}) };
+    }
+    return mergeTerrainTextures(emptyTerrainTextures(), patch);
+}
 // -----------------------------------------------------------------------------
 // Defaults
 // -----------------------------------------------------------------------------
@@ -52,6 +101,9 @@ const surfaceBase = {
     detailSize: 9,
     roughness: 0.82,
     specular: 0.06,
+    textures: texturesOf({ low: 'Grass001', mid: 'Gravel040', rock: 'Rock051', peak: 'Snow014' }, { low: 2.5, mid: 3, rock: 6, peak: 4 }),
+    textureDistance: 4000,
+    textureHeightBlend: 0.7,
     ambient: 1,
     bounce: 0.35,
     sunShadow: 1,
@@ -64,6 +116,7 @@ export const defaultMountainsConfig = {
     terrainType: 'mountains',
     preset: '',
     enabled: true,
+    biome: 'Alpine meadow',
 };
 export const defaultHillsConfig = {
     ...surfaceBase,
@@ -71,6 +124,7 @@ export const defaultHillsConfig = {
     terrainType: 'hills',
     preset: '',
     enabled: true,
+    biome: 'Green hills',
     elevation: 300,
     featureSize: 2200,
     octaves: 8,
@@ -92,6 +146,7 @@ export const defaultHillsConfig = {
     detailSize: 6,
     roughness: 0.9,
     specular: 0.03,
+    textures: texturesOf({ low: 'Grass008', mid: 'Grass001', rock: 'Rock061', peak: 'Ground033' }, { low: 2.5, mid: 2.5, rock: 5, peak: 3 }),
     aerialPerspective: 0.00009,
 };
 export const defaultDunesConfig = {
@@ -100,6 +155,7 @@ export const defaultDunesConfig = {
     terrainType: 'dunes',
     preset: '',
     enabled: true,
+    biome: 'Desert sand',
     elevation: 150,
     featureSize: 3000,
     octaves: 6,
@@ -125,6 +181,7 @@ export const defaultDunesConfig = {
     detailSize: 3.5,
     roughness: 0.55,
     specular: 0.16,
+    textures: texturesOf({ low: 'Ground097', mid: 'Ground097', rock: 'Ground105', peak: 'Ground093C' }, { low: 4, mid: 5, rock: 4, peak: 4 }),
     ambient: 1.1,
     bounce: 0.55,
     shadowSoftness: 22,
@@ -136,6 +193,7 @@ export const defaultCanyonConfig = {
     terrainType: 'canyon',
     preset: '',
     enabled: true,
+    biome: 'Red rock',
     elevation: 700,
     featureSize: 2600,
     octaves: 8,
@@ -163,6 +221,7 @@ export const defaultCanyonConfig = {
     detailSize: 7,
     roughness: 0.86,
     specular: 0.05,
+    textures: texturesOf({ low: 'Ground105', mid: 'Ground097', rock: 'Rock029', peak: 'Ground105' }, { low: 3, mid: 4, rock: 8, peak: 3 }),
     shadowSoftness: 8,
     aerialPerspective: 0.000075,
 };
@@ -215,6 +274,8 @@ export const TERRAIN_SCHEMA = [
     { key: 'detailSize', animatable: false, 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: 'textureDistance', animatable: false, label: 'Texture distance', group: 'surface', min: 100, max: 12000, step: 50, unit: 'm', description: 'How far out the ground is drawn with real textures. Past it every layer fades to its flat far colour, so the horizon costs nothing extra.' },
+    { key: 'textureHeightBlend', animatable: false, label: 'Texture height blend', group: 'surface', min: 0, max: 1, step: 0.01, description: '0 cross-fades the layers; 1 lets the layer whose own surface is higher win, so rock pushes up through grass along its cracks.' },
     { 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.' },
@@ -266,9 +327,13 @@ export function normalizeTerrain(raw) {
     const terrainType = TERRAIN_TYPES.includes(raw.terrainType)
         ? raw.terrainType
         : 'hills';
+    const base = TERRAIN_DEFAULTS[terrainType];
     return {
-        ...TERRAIN_DEFAULTS[terrainType],
+        ...base,
         ...raw,
+        // Layer-wise, not replaced: a stored or preset block may name only some
+        // layers, and a partial layer must not lose the type's defaults.
+        textures: mergeTerrainTextures(base.textures, isRecord(raw.textures) ? raw.textures : undefined),
         type: 'terrain',
         terrainType,
     };
@@ -283,10 +348,15 @@ export function normalizeTerrainQuality(raw) {
 export function normalizeTerrainSettings(raw) {
     const source = isRecord(raw) ? raw : {};
     const config = normalizeTerrain(source.config);
-    return {
+    const settings = {
         id: typeof source.id === 'string' ? source.id : defaultProceduralTerrainSettings.id,
         type: 'terrain',
         config: config ?? { ...defaultHillsConfig, enabled: false },
         quality: normalizeTerrainQuality(source.quality),
     };
+    if (isRecord(source.animations))
+        settings.animations = source.animations;
+    if (isRecord(source.mouseMove))
+        settings.mouseMove = source.mouseMove;
+    return settings;
 }

package/dist/index.d.ts

@@ -20,7 +20,7 @@ export type { EnvironmentManagerVOptions } from './three/EnvironmentManagerV';
 export type { RainVOptions } from './three/RainV';
 export type { SceneBuilderVOptions } from './three/SceneBuilderV';
 export type { ProjectLoaderVOptions } from './three/ProjectLoaderV';
-export { defaultMoonSettings } from './types/environment';
+export { defaultMoonSettings, SKY_ID, SKY_STARS_DEFAULTS, normalizeSkyStars } from './types/environment';
 export { DEFAULT_HDR_TRANSITION_SETTINGS, getTransitionSettings } from './utils/environmentUtils';
 export * from './types/index';
 export * from './utils/index';
@@ -32,6 +32,8 @@ export * from './autoAnimate/index';
 export * from './animations/index';
 export * from './environment/index';
 export * from './properties/index';
+export * from './catalog/index';
+export * from './ui/index';
 export { LightsManagerV } from './three/LightsManagerV';
 export { FrameV } from './three/FrameV';
 export { ImageGeometryV } from './three/ImageGeometryV';

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

@@ -1,4 +1,4 @@
-export { defaultMoonSettings } from './types/environment.js';
+export { defaultMoonSettings, SKY_ID, SKY_STARS_DEFAULTS, normalizeSkyStars } from './types/environment.js';
 export { DEFAULT_HDR_TRANSITION_SETTINGS, getTransitionSettings } from './utils/environmentUtils.js';
 // Barrel exports
 export * from './types/index.js';
@@ -11,6 +11,8 @@ export * from './autoAnimate/index.js';
 export * from './animations/index.js';
 export * from './environment/index.js';
 export * from './properties/index.js';
+export * from './catalog/index.js';
+export * from './ui/index.js';
 // Three.js vanilla classes
 export { LightsManagerV } from './three/LightsManagerV.js';
 export { FrameV } from './three/FrameV.js';