@3driseai/3drise-core 1.0.20 → 1.0.22

package/dist/types/environment.d.ts

@@ -2,7 +2,14 @@ import type { MaterialSettings } from "./materials";
 import type { CustomHandlers } from "./handlerSettings";
 import type { GridSettings } from "./scene3d";
 import type { MouseMoveInteraction, MouseMoveInteractions, ObjectAnimations } from "./objectSettings";
+/** Scene id of the sky. It is the sky mesh's id too, so findById('3drise-sky')
+ *  reaches the mesh, its uniforms and the live handle the controllers drive. */
+export declare const SKY_ID = "3drise-sky";
 export interface SkySettings {
+    /** Always SKY_ID. Optional so an older save (which has none) still types. */
+    id?: string;
+    /** Discriminator the animation / mouse-move panels and the registry key off. */
+    type?: 'sky';
     visible: boolean;
     turbidity: number;
     rayleigh: number;
@@ -10,9 +17,35 @@ export interface SkySettings {
     mieDirectionalG: number;
     elevation: number;
     azimuth: number;
-    handlers?: CustomHandlers;
+    /** Per-domain keyframes; the `sky` domain drives the six Preetham / sun knobs. */
+    animations?: ObjectAnimations;
+    /** Per-domain pointer bindings; same `sky` domain. */
+    mouseMove?: MouseMoveInteractions;
     sunSystem: any;
+    /** Built-in night sky (SkyStars). Absent = on. */
+    stars?: SkyStarsSettings;
+}
+/** The built-in night sky (viewer SkyStars). Every field optional: an older save
+ *  fills in from SKY_STARS_DEFAULTS (normalizeSkyStars). */
+export interface SkyStarsSettings {
+    visible?: boolean;
+    /** Multiplier on star brightness, default 1. */
+    brightness?: number;
+    /** Number of stars (structural: rebuilds the dome). */
+    count?: number;
+    /** Point size multiplier. */
+    size?: number;
+    /** Twinkle depth, 0 = steady. */
+    twinkle?: number;
+    /** Fraction of the stars gathered into a Milky Way band, 0 = none (structural). */
+    milkyWay?: number;
+    /** Colour spread: 0 = all white, 1 = full blue / orange temperature range. */
+    warmth?: number;
 }
+export declare const SKY_STARS_DEFAULTS: Required<SkyStarsSettings>;
+/** Merge a saved stars block over the defaults — absent block = default stars (they
+ *  were always on before the block existed). */
+export declare const normalizeSkyStars: (stars?: SkyStarsSettings | null) => Required<SkyStarsSettings>;
 export interface MoonSettings {
     visible: boolean;
     position: [number, number, number];

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

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

package/dist/types/environment.js

@@ -1,3 +1,18 @@
+/** Scene id of the sky. It is the sky mesh's id too, so findById('3drise-sky')
+ *  reaches the mesh, its uniforms and the live handle the controllers drive. */
+export const SKY_ID = '3drise-sky';
+export const SKY_STARS_DEFAULTS = {
+    visible: true,
+    brightness: 1,
+    count: 4000,
+    size: 1,
+    twinkle: 0.5,
+    milkyWay: 0,
+    warmth: 0.5,
+};
+/** Merge a saved stars block over the defaults — absent block = default stars (they
+ *  were always on before the block existed). */
+export const normalizeSkyStars = (stars) => ({ ...SKY_STARS_DEFAULTS, ...(stars ?? {}) });
 export const defaultMoonSettings = {
     visible: true,
     position: [0, 5, 0],

package/dist/types/environmentObjects.d.ts

@@ -0,0 +1,152 @@
+export type EnvironmentObjectType = 'snow' | 'sandstorm' | 'rainbow' | 'tornado' | 'thunderstorm' | 'rain';
+export type EnvironmentQuality = 'low' | 'medium' | 'high';
+export interface BaseEnvironmentObjectConfig {
+    enabled: boolean;
+    intensity: number;
+    /** Time scale of the whole phenomenon (integrated, so animating it never jumps). */
+    speed: number;
+    color: string;
+    opacity: number;
+    /** How much of it there is (structural: rebuilds). */
+    density: number;
+    /** Detail level, scales counts and volume samples (structural). */
+    quality: EnvironmentQuality;
+    /** Random layout (structural). */
+    seed: number;
+    /** Wrap the volume around the camera instead of the object's box (in the shader; the object never moves). */
+    followCamera?: boolean;
+    /** Mean wind, 0..1 (Rain's range; 1 = 8 m/s). */
+    windStrength?: number;
+    /** Compass direction the wind blows toward, degrees. */
+    windDirection?: number;
+    /** Eddies on top of the wind, 0..1. */
+    turbulence?: number;
+    /** What the cursor is; 'none' = off. */
+    pointerMode: string;
+    pointerStrength: number;
+    pointerRadius: number;
+    pointerColor: string;
+    /** Shade / storm-light colour. */
+    shadeColor: string;
+}
+export interface SnowEnvironmentConfig extends BaseEnvironmentObjectConfig {
+    pointerMode: 'none' | 'gust' | 'shelter' | 'warmth';
+    /** Mean flake diameter; bigger flakes fall faster (0.01..0.12 m). */
+    flakeSize: number;
+    /** Side-to-side spiral of the falling flakes (0..1). */
+    flutter: number;
+    /** How much the crystals rock and flip as they fall (0..1). */
+    tumble: number;
+    /** Sparkle of sunlight off the tumbling crystals (0..2). */
+    glint: number;
+    /** Strength of the gust waves that sweep downwind (0..1). */
+    gustiness: number;
+    /** How strongly the gusts gather the snow into sweeping curtains (0..1). */
+    bands: number;
+    /** Sky-lit shade on the side away from the sun. */
+    shadeColor: string;
+}
+export interface SandstormEnvironmentConfig extends BaseEnvironmentObjectConfig {
+    pointerMode: 'none' | 'windbreak' | 'devil' | 'gust';
+    /** Scale height of the dust, as a share of the volume height (0.05..1). */
+    height: number;
+    /** Strength of the gust fronts: towering walls of dust rolling downwind (0..1). */
+    walls: number;
+    /** Fine dust hanging everywhere between the walls (0..1). */
+    haze: number;
+    /** Sand grains hopping along the ground (0..2). */
+    grains: number;
+    /** Size and hop length of the grains (0.3..3). */
+    grainSize: number;
+    /** Sky-lit colour of the dust in shadow. */
+    shadeColor: string;
+}
+/** A single rainbow on its own, seen through the object's volume. Its own small knob set: no weather around it (the shower is the mist object). */
+export interface RainbowEnvironmentConfig {
+    enabled: boolean;
+    pointerMode: 'none' | 'spray' | 'clear' | 'polarizer';
+    /** Brightness of the bow (0..2). */
+    intensity: number;
+    /** Overall opacity (0..1). */
+    opacity: number;
+    /** Raindrop diameter: big drops give a narrow, vivid bow; small ones pale fringes inside it; fog drops a white fogbow (0.03..3 mm). */
+    dropSize: number;
+    /** Strength of the secondary bow outside the primary (reversed colours, ~51°); 0 = a single rainbow (0..1). */
+    secondary: number;
+    /** Tint of the bow (white = the pure spectrum). */
+    color: string;
+    /** Brightness of the sprayed stretch, depth of the clearing, strength of the filter (0..3). */
+    pointerStrength: number;
+    /** Reach of the spray or clearing (1 = 6 m) (0.2..3). */
+    pointerRadius: number;
+    /** Tint of the bow in the sprayed mist. */
+    pointerColor: string;
+}
+export interface TornadoEnvironmentConfig extends BaseEnvironmentObjectConfig {
+    pointerMode: 'none' | 'steer' | 'feed' | 'gust';
+    /** Spin rate of the vortex (0..3). */
+    rotation: number;
+    /** Radius of the core, and so the width of the funnel (0.3..3). */
+    coreRadius: number;
+    /** How far down the condensation funnel reaches (1 = touchdown) (0..1). */
+    reach: number;
+    /** How much the axis wanders and bends like a rope (0..1). */
+    wander: number;
+    /** Updraft: how fast the streaks and dust climb (0..3). */
+    lift: number;
+    /** Ground dust drawn in and swirled up around the funnel (0..2). */
+    dust: number;
+    /** How far out the dust swirls (0.2..3). */
+    dustSpread: number;
+    /** Storm-light colour in shadow. */
+    shadeColor: string;
+    /** Colour of the swirling dust. */
+    dustColor: string;
+}
+export interface ThunderstormEnvironmentConfig extends BaseEnvironmentObjectConfig {
+    pointerMode: 'none' | 'strike' | 'clear';
+    /** Visibility of the dark storm curtains (0..1). */
+    shafts: number;
+    /** Lightning flashes per minute (random intervals) (0..30). */
+    flashRate: number;
+    /** Brightness of a flash, on the curtains and on the scene (0..3). */
+    flashIntensity: number;
+    /** Storm-dark tint of the curtains. */
+    shadeColor: string;
+    /** Colour of the lightning. */
+    flashColor: string;
+}
+/** Rain: streaks falling through the object's volume at a steady rate, carried by the wind and scattered by turbulence. Its own small knob set (no pointer modes, quality or seed). */
+export interface RainEnvironmentConfig {
+    enabled: boolean;
+    /** Colour of the drops. */
+    color: string;
+    /** Streak size (0.01..1). */
+    size: number;
+    /** Opacity of the drops (0..1). */
+    opacity: number;
+    /** Fall speed multiplier (0.1..5; 1 = 60 m/s across the volume's own metres). */
+    speed: number;
+    /** Drops in the volume, in hundreds (1..200; rebuilds). */
+    density: number;
+    /** Sideways push of the wind (0..1). */
+    windStrength: number;
+    /** Compass direction the wind blows toward (0..360°). */
+    windDirection: number;
+    /** Random sway of the drops (0..1). */
+    turbulence: number;
+}
+export type EnvironmentObjectConfig = ({
+    type: 'snow';
+} & SnowEnvironmentConfig) | ({
+    type: 'sandstorm';
+} & SandstormEnvironmentConfig) | ({
+    type: 'rainbow';
+} & RainbowEnvironmentConfig) | ({
+    type: 'tornado';
+} & TornadoEnvironmentConfig) | ({
+    type: 'thunderstorm';
+} & ThunderstormEnvironmentConfig) | ({
+    type: 'rain';
+} & RainEnvironmentConfig);
+//# sourceMappingURL=environmentObjects.d.ts.map

package/dist/types/environmentObjects.d.ts.map

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

package/dist/types/environmentObjects.js

@@ -0,0 +1,10 @@
+// =============================================================================
+// ENVIRONMENT OBJECTS — world-scale weather / atmosphere that fills a volume
+// =============================================================================
+//
+// Object type 'environment'; config.type picks the variant. The volume is the
+// object's transform: x / z span the scale, y rises from the object's origin
+// (the ground) to scale.y. Knobs describe the weather, never the box.
+// Generated from Claude outputs/environment-lab (gen_family.mjs).
+//
+export {};

package/dist/types/index.d.ts

@@ -3,6 +3,10 @@ export type * from './effects';
 export type * from './gallery';
 export type * from './generativeEffects';
 export type * from './generativeParticles';
+export type * from './environmentObjects';
+export type * from './spaceObjects';
+export type * from './landObjects';
+export type * from './textObjects';
 export type * from './handlerSettings';
 export type * from './lights';
 export type * from './materials';
@@ -12,13 +16,13 @@ export type * from './particles';
 export type * from './scene3d';
 export type * from './text';
 export type * from './actions';
+export type * from './commands';
 export type * from './cursor';
 export type * from './shaderEffects';
 export type * from './environment';
 export type * from './objectManager';
 export type * from './postprocessing';
 export type * from './types';
-export type * from './uiController';
 export type * from './users';
 export type * from './objectsConfigs';
 export {};

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,cAAc,CAAC;AAElC,mBAAmB,WAAW,CAAC;AAE/B,mBAAmB,WAAW,CAAC;AAE/B,mBAAmB,qBAAqB,CAAC;AAEzC,mBAAmB,uBAAuB,CAAC;AAE3C,mBAAmB,mBAAmB,CAAC;AAEvC,mBAAmB,UAAU,CAAC;AAE9B,mBAAmB,aAAa,CAAC;AAEjC,mBAAmB,QAAQ,CAAC;AAE5B,mBAAmB,kBAAkB,CAAC;AAEtC,mBAAmB,aAAa,CAAC;AAEjC,mBAAmB,WAAW,CAAC;AAE/B,mBAAmB,QAAQ,CAAC;AAE5B,mBAAmB,WAAW,CAAC;AAE/B,mBAAmB,UAAU,CAAC;AAE9B,mBAAmB,iBAAiB,CAAC;AAErC,mBAAmB,eAAe,CAAC;AAEnC,mBAAmB,iBAAiB,CAAC;AAErC,mBAAmB,kBAAkB,CAAC;AAEtC,mBAAmB,SAAS,CAAC;AAE7B,mBAAmB,gBAAgB,CAAC;AAEpC,mBAAmB,SAAS,CAAC;AAE7B,mBAAmB,kBAAkB,CAAC;AACtC,OAAO,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,cAAc,CAAC;AAElC,mBAAmB,WAAW,CAAC;AAE/B,mBAAmB,WAAW,CAAC;AAE/B,mBAAmB,qBAAqB,CAAC;AAEzC,mBAAmB,uBAAuB,CAAC;AAE3C,mBAAmB,sBAAsB,CAAC;AAE1C,mBAAmB,gBAAgB,CAAC;AACpC,mBAAmB,eAAe,CAAC;AACnC,mBAAmB,eAAe,CAAC;AAEnC,mBAAmB,mBAAmB,CAAC;AAEvC,mBAAmB,UAAU,CAAC;AAE9B,mBAAmB,aAAa,CAAC;AAEjC,mBAAmB,QAAQ,CAAC;AAE5B,mBAAmB,kBAAkB,CAAC;AAEtC,mBAAmB,aAAa,CAAC;AAEjC,mBAAmB,WAAW,CAAC;AAE/B,mBAAmB,QAAQ,CAAC;AAE5B,mBAAmB,WAAW,CAAC;AAE/B,mBAAmB,YAAY,CAAC;AAEhC,mBAAmB,UAAU,CAAC;AAE9B,mBAAmB,iBAAiB,CAAC;AAErC,mBAAmB,eAAe,CAAC;AAEnC,mBAAmB,iBAAiB,CAAC;AAErC,mBAAmB,kBAAkB,CAAC;AAEtC,mBAAmB,SAAS,CAAC;AAE7B,mBAAmB,SAAS,CAAC;AAE7B,mBAAmB,kBAAkB,CAAC;AACtC,OAAO,EAAE,CAAC"}

package/dist/types/landObjects.d.ts

@@ -0,0 +1,15 @@
+import type { TerrainConfig, TerrainType } from '../environment/terrainConfigs';
+export type LandObjectType = TerrainType;
+export type LandQuality = 'low' | 'medium' | 'high';
+export type LandObjectConfig = Omit<TerrainConfig, 'type' | 'terrainType' | 'seaLevel' | 'preset'> & {
+    /** The landform. Picking a shape of another landform switches it. */
+    type: LandObjectType;
+    /** Which piece of the endless field this patch shows (structural). */
+    seed: number;
+    /** How far in from the border the land eases down to its base, as a fraction
+     *  of the shorter side. 0 ends in a cliff. */
+    edgeFade: number;
+    /** Grid resolution: low 128, medium 256, high 384 cells a side (structural). */
+    quality: LandQuality;
+};
+//# sourceMappingURL=landObjects.d.ts.map

package/dist/types/landObjects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"landObjects.d.ts","sourceRoot":"","sources":["../../src/types/landObjects.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAEhF,MAAM,MAAM,cAAc,GAAG,WAAW,CAAC;AAEzC,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEpD,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,aAAa,GAAG,UAAU,GAAG,QAAQ,CAAC,GAAG;IACjG,qEAAqE;IACrE,IAAI,EAAE,cAAc,CAAC;IACrB,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb;kDAC8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,gFAAgF;IAChF,OAAO,EAAE,WAAW,CAAC;CACxB,CAAC"}

package/dist/types/landObjects.js

@@ -0,0 +1 @@
+export {};

package/dist/types/objectSettings.d.ts

@@ -1,4 +1,5 @@
 import type { AnimationOptions, Vector3 } from "./scene3d";
+import type { SceneCommand } from "./commands";
 import type { MaterialSettings } from "./materials";
 import type { ShaderEffect } from "./shaderEffects";
 import type { ColorEffectType, EffectTriggerMode, TransformEffectType } from "./effects";
@@ -71,6 +72,34 @@ export interface GridConfigEffects {
     /** Keyframe animations for a grid object's config properties (type 'grid'). */
     animations?: AnimationOptions[];
 }
+/** Keyframe animations for the sky's Preetham / sun knobs (SkySettings, root level). */
+export interface SkyEffects {
+    animations?: AnimationOptions[];
+}
+/** Keyframe animations for the water's own config knobs (OceanWaterSettings.config). */
+export interface OceanEffects {
+    animations?: AnimationOptions[];
+}
+/** Keyframe animations for the terrain surface's lighting / colour knobs (ProceduralTerrainSettings.config). */
+export interface TerrainEffects {
+    animations?: AnimationOptions[];
+}
+/** Keyframe animations for an environment object's config knobs (type 'environment': snow…). */
+export interface EnvironmentObjectEffects {
+    animations?: AnimationOptions[];
+}
+/** Keyframe animations for a land object's surface knobs (type 'land'). */
+export interface LandObjectEffects {
+    animations?: AnimationOptions[];
+}
+/** Keyframe animations for a space object's config knobs (type 'space': stars, earth, solarSystem, shootingStars). */
+export interface SpaceObjectEffects {
+    animations?: AnimationOptions[];
+}
+/** Keyframe animations for a text look's config knobs (type 'text', config.type set: handwriting, neonTube, fourierSketch). */
+export interface TextObjectEffects {
+    animations?: AnimationOptions[];
+}
 export interface RainEffects {
     /** Keyframe animations for rain config properties */
     animations?: AnimationOptions[];
@@ -95,6 +124,20 @@ export interface ObjectAnimations {
     effect?: EffectConfigEffects;
     /** Grid domain: a grid object's own config knobs (type 'grid'). */
     grid?: GridConfigEffects;
+    /** Environment domain: a weather object's own config knobs (type 'environment': snow…). */
+    environment?: EnvironmentObjectEffects;
+    /** Space domain: a space object's own config knobs (type 'space': stars, earth…). */
+    space?: SpaceObjectEffects;
+    /** Land domain: a land object's surface knobs (type 'land': mountains, hills, dunes, canyon). */
+    land?: LandObjectEffects;
+    /** Text domain: an animated text look's own config knobs (type 'text', config.type set). */
+    text?: TextObjectEffects;
+    /** Sky domain: the sky's turbidity / rayleigh / mie / elevation / azimuth. */
+    sky?: SkyEffects;
+    /** Ocean domain: the water's config knobs (OceanWaterSettings). */
+    ocean?: OceanEffects;
+    /** Terrain domain: the surface's lighting and colour knobs. */
+    terrain?: TerrainEffects;
 }
 export interface PropertyMutation {
     /** Property path: 'position' | 'rotation' | 'scale' | 'material.color' | ... */
@@ -118,13 +161,14 @@ export type InteractionTrigger = 'click' | 'mouseEnter' | 'mouseLeave';
  * An operation's name. The built-ins are listed; the viewer's operations registry
  * (packages/viewer/src/operations) is the source of truth and can grow.
  */
-export type OperationName = 'jelly' | 'flip' | 'spin' | 'swirl' | 'moveToFront' | 'glow' | 'rimLight' | 'dissolve' | 'emberAsh' | 'particleSwarm' | 'hologram' | 'shatter' | 'sandErosion' | 'teleport' | 'inkBloom' | 'flock' | 'metalize' | 'liquidMetal' | 'frost' | 'heatCracks' | 'petrify' | 'portal' | 'voxelize' | 'unweave' | 'petalPeel' | 'fade' | 'visibility' | 'displayImage' | 'zoom' | 'frame' | 'focus' | 'orbit' | (string & {});
+export type OperationName = 'jelly' | 'flip' | 'spin' | 'swirl' | 'moveToFront' | 'float' | 'sway' | 'bounce' | 'wobble' | 'pulse' | 'shake' | 'rotate' | 'grow' | 'glow' | 'rimLight' | 'dissolve' | 'emberAsh' | 'particleSwarm' | 'hologram' | 'shatter' | 'sandErosion' | 'teleport' | 'inkBloom' | 'flock' | 'metalize' | 'liquidMetal' | 'frost' | 'heatCracks' | 'petrify' | 'portal' | 'voxelize' | 'unweave' | 'petalPeel' | 'fade' | 'visibility' | 'displayImage' | 'zoom' | 'frame' | 'focus' | 'orbit' | (string & {});
 /**
  * What an operation acts on. An interaction holds at most one effect per channel,
  * so effects in one card never fight over the same thing.
  *   transform  the object's own position / rotation / scale
  *   visual     how the object is drawn (material, shader, visibility) — never its transform
  *   camera     the camera (zoom, look at)
+ *   effects    the object's own effects (its Effects tab): play / stop / toggle them
  */
 export type OperationChannel = 'transform' | 'visual' | 'camera';
 /** A value of an operation parameter (duration, distance, colour…). */
@@ -144,6 +188,13 @@ export interface OperationEffect {
     meshNames?: Record<string, string[]>;
     /** Overrides of the operation's parameter defaults. */
     params?: Record<string, OperationParamValue>;
+    /**
+     * Reverse / loop / yoyo, for operations that can also be object effects (the object's effects
+     * controller runs them). Autoplay and visible do not apply to a triggered effect.
+     */
+    playback?: EffectPlayback;
+    /** Targeting a group: a physical effect moves the whole group ('group', default) or each child on its own spot ('each'). Visual effects on a group always go to each child. */
+    scope?: 'group' | 'each';
 }
 /**
  * An effect that stays on the object (`CreatedObject.effects`) — the same
@@ -154,37 +205,143 @@ export interface OperationEffect {
  * (the viewer's definitions list 'object' in `usableIn`). Always on the object
  * itself — no targets, no channel.
  */
+/**
+ * How an effect plays. All optional; with none set it plays in once and holds.
+ *   autoplay  plays when the scene starts / the effect is switched on (default true).
+ *             Off: it waits at its start until something plays it.
+ *   reverse   starts at its end and plays back to the original
+ *   loop      when a pass ends, jumps back to its start and plays again
+ *   yoyo      plays there and back (once, or over and over with loop)
+ */
+export interface EffectPlayback {
+    autoplay?: boolean;
+    reverse?: boolean;
+    loop?: boolean;
+    yoyo?: boolean;
+}
 export interface ObjectEffect {
     id: string;
     operation: OperationName;
     enabled: boolean;
+    /** Autoplay / reverse / loop / yoyo — see EffectPlayback. */
+    playback?: EffectPlayback;
     /** Narrows a model to named nodes. */
     meshNames?: string[];
     /** Overrides of the operation's parameter defaults. */
     params?: Record<string, OperationParamValue>;
+    /**
+     * On a group, a physical effect moves the whole group as one piece ('group', the default) or
+     * every child on its own spot ('each', staggered by the clip's `spread`). Visual effects on a
+     * group always go to each child.
+     */
+    scope?: 'group' | 'each';
 }
-export type InteractionAnimationCommand = 'play' | 'pause' | 'stop' | 'toggle';
-export interface InteractionAnimation {
+/**
+ * How a group's effects reach its children one after another (see claude/group-effects-plan.md).
+ * Defaults: core `DEFAULT_EFFECT_SPREAD`.
+ */
+export interface EffectSpread {
+    /** Who goes first: scene-tree order, along an axis of the group, centre → out, or random (seeded by the group). */
+    order?: 'tree' | 'x' | 'y' | 'z' | 'radial' | 'random';
+    /** Seconds from the first child to the last (a fixed total, whatever the number of children). 0 = together. */
+    total?: number;
+    /** Going off: last in, first out ('reverse'), or the same order. */
+    out?: 'reverse' | 'same';
+}
+/**
+ * Effects that take turns on an object. The object's own `effects` run the whole time; on top
+ * of them one step is on at a time. A step holds effects that go together and owns the timing.
+ */
+export interface EffectStep {
     id: string;
-    kind: 'clip' | 'sequence';
-    /** Clip or sequence id. */
-    ref: string;
-    command: InteractionAnimationCommand;
+    /** Effects that go together (one take-over at most). Their own playback is not used: looks play in and hold, motions run while the step is on. */
+    effects: ObjectEffect[];
+    /** Seconds the step's looks take to play in — and out, when the step ends. Default 1. */
+    in?: number;
+    /** Seconds the step stays once its looks are on. Default 1. */
+    hold?: number;
+    /**
+     * How the step ends. Default: directly — the next step's take-over sweeps over this one,
+     * the plain object never shows. True: this step plays out first, back to the object, and
+     * only then does the next step start.
+     */
+    playOut?: boolean;
 }
-/** toggle: apply, then revert, … */
-export type InteractionActionCommand = 'apply' | 'revert' | 'toggle';
-export interface InteractionAction {
+export interface EffectSteps {
+    steps: EffectStep[];
+    /** After the last step, start again from the first. Off: it stays on the last step. */
+    loop?: boolean;
+    /** Through the steps there and back. */
+    yoyo?: boolean;
+}
+/**
+ * What an object's Effects tab holds — the object's own effect clip, stored as one value in
+ * `CreatedObject.effects`: Base effects (on the whole time), steps that take turns, the model
+ * parts they apply to, and the saved template it came from. Same shape as a template (EffectClip)
+ * plus what only an object has (parts, source). Read it with core `objectEffectClipOf`.
+ */
+export interface ObjectEffectClip {
+    /** Base: on the whole time. */
+    effects: ObjectEffect[];
+    /** Effects that take turns on top of the Base ones. */
+    steps?: EffectStep[];
+    loop?: boolean;
+    yoyo?: boolean;
+    /**
+     * The effects (Base and steps) follow the object's visibility: shown → they play in (the steps
+     * from the first), hidden → they play out first and then the object goes. Off: hiding cuts them.
+     */
+    visible?: boolean;
+    /** Groups: how the effects reach the children one after another. */
+    spread?: EffectSpread;
+    /** Model parts (node names) the effects apply to; none = the whole object. */
+    parts?: string[];
+    /** The saved effect clip (template) these effects were copied from / saved to. */
+    source?: {
+        id: string;
+    };
+}
+/**
+ * A saved effect clip — a TEMPLATE: always-on effects and steps, with no target inside.
+ * What an object's Effects tab holds is that object's own clip (ObjectEffectClip);
+ * importing a template copies it into the object. Interactions and actions point at a
+ * template by id and apply it to their targets (EffectClipUse).
+ */
+export interface EffectClip {
     id: string;
-    /** Action sequence id. */
-    ref: string;
-    command: InteractionActionCommand;
+    name: string;
+    effects: ObjectEffect[];
+    steps?: EffectStep[];
+    loop?: boolean;
+    yoyo?: boolean;
+    /** Imported into an object, its effects follow the object's visibility (applied by a command: not used). */
+    visible?: boolean;
+    /** Imported into a group: how its effects reach the children. */
+    spread?: EffectSpread;
+    /** Preview image (the asset's url), when one was taken. */
+    previewUrl?: string;
+    /** The asset's owner and privacy (only a private clip of your own is updated in place). */
+    creatorId?: string;
+    privacy?: string;
 }
+/** A template applied to targets: by an action (applied / reverted with it) or an interaction. */
+export interface EffectClipUse {
+    id: string;
+    /** EffectClip id. */
+    clip: string;
+    /** Scene object ids; interactions may also use 'self'. */
+    targets: string[];
+    /** Narrows a `model` target to named nodes, keyed by that model's object id. */
+    meshNames?: Record<string, string[]>;
+}
+export type InteractionAnimationCommand = 'play' | 'pause' | 'stop' | 'toggle';
+/** toggle: apply, then revert, … */
+export type InteractionActionCommand = 'apply' | 'revert' | 'toggle';
 export interface Interaction {
     mouseEvent: InteractionTrigger;
     enabled: boolean;
-    effects: OperationEffect[];
-    animations: InteractionAnimation[];
-    actions: InteractionAction[];
+    /** What happens, in order — run by the viewer's triggers engine. */
+    commands: SceneCommand[];
 }
 export interface ClickInteraction {
     interactions: Interaction[];
@@ -224,6 +381,20 @@ export interface MouseMoveInteractions {
     effect?: MouseMoveDomain;
     /** Grid domain: a grid object's own config knobs. */
     grid?: MouseMoveDomain;
+    /** Environment domain: a weather object's own config knobs. */
+    environment?: MouseMoveDomain;
+    /** Space domain: a space object's own config knobs. */
+    space?: MouseMoveDomain;
+    /** Land domain: a land object's surface knobs. */
+    land?: MouseMoveDomain;
+    /** Text domain: an animated text look's own config knobs. */
+    text?: MouseMoveDomain;
+    /** Sky domain: the sky's Preetham / sun knobs. */
+    sky?: MouseMoveDomain;
+    /** Ocean domain: the water's config knobs. */
+    ocean?: MouseMoveDomain;
+    /** Terrain domain: the surface's lighting and colour knobs. */
+    terrain?: MouseMoveDomain;
 }
 /**
  * Check if settings use the new structure