@3driseai/3drise-core 1.0.27 → 1.0.29

package/dist/data/imageDefaults.js

@@ -0,0 +1,212 @@
+// =============================================================================
+// IMAGE OBJECTS — defaults, labels, animatable knobs
+// =============================================================================
+//
+// The animatable list of each variant is what its push point applies per frame
+// (applyConfig): numbers and colours of the motion and the look. Structural knobs
+// (imageUrls, tilings, seeds), switches, selects and the timings (duration, interval)
+// are never listed.
+//
+export const DEFAULT_IMAGE_OBJECTS = {
+    shards: { type: 'shards', enabled: true, imageUrls: [], interval: 5, intensity: 1, opacity: 1, pointerMode: 'tilt', pointerStrength: 1, pointerRadius: 0.6, pointerColor: '#9ad7ff', cols: 40, rows: 25, tiling: 0.35, aspect: 0, seed: 7, duration: 1.6, spread: 0.5, order: 'sweep', sweepAngle: 0, delayJitter: 0.15, lift: 0.35, drift: 0.08, spin: 0.6, breathe: 0.5, kenBurns: 0.5, seams: 0.12, rim: 0.8, edgeColor: '#0b0d12', rimColor: '#ffd9a6', backColor: '#101218' },
+    projector: { type: 'projector', enabled: true, imageUrls: [], interval: 5, duration: 1.8, aspect: 0, breathe: 0.5, intensity: 1, opacity: 1, pointerStrength: 1, pointerRadius: 0.5, pointerColor: '#ffd9a6', pointerMode: 'stir', dustCount: 500, throw: 2.4, lensHeight: 1.3, haze: 0.6, dust: 0.5, dustDrift: 0.5, defocus: 0.8, hunt: 0.5, vignette: 0.35, flicker: 0.15, lampColor: '#fff3e2', screenGain: 1 },
+    relief: { type: 'relief', enabled: true, imageUrls: [], interval: 5, duration: 1.8, aspect: 0, breathe: 0.5, intensity: 1, opacity: 1, pointerStrength: 1, pointerRadius: 0.6, pointerColor: '#ffffff', pointerMode: 'press', detail: 256, depth: 1, crest: 0.7, spread: 0.45, sweepAngle: 0, roughness: 0.62, paperColor: '#e9e4da', selfLight: 0.12 },
+    pinscreen: { type: 'pinscreen', enabled: true, imageUrls: [], interval: 5, duration: 2.2, aspect: 0, breathe: 0.5, intensity: 1, opacity: 1, pointerStrength: 1, pointerRadius: 0.6, pointerColor: '#ffffff', pointerMode: 'press', cols: 110, depth: 1, dip: 0.85, spread: 0.55, sweepAngle: 0, pinSize: 0.86, metal: 0.6, roughness: 0.32, selfLight: 0.15, pinColor: '#9aa0a8', plateColor: '#0c0d10' },
+    prism: { type: 'prism', enabled: true, imageUrls: [], interval: 5, duration: 2, aspect: 0, breathe: 0.5, intensity: 1, opacity: 1, pointerStrength: 1, pointerRadius: 0.6, pointerColor: '#ffffff', pointerMode: 'tilt', count: 56, vertical: true, spread: 0.6, sweepAngle: 0, settle: 0.5, gap: 0.03, roughness: 0.45, slatColor: '#15171c', selfLight: 0.1 },
+    lenticular: { type: 'lenticular', enabled: true, imageUrls: [], interval: 5, duration: 1.6, aspect: 0, breathe: 0.5, intensity: 1, opacity: 1, pointerStrength: 1, pointerRadius: 0.6, pointerColor: '#ffffff', pointerMode: 'peek', lenses: 110, thickness: 1.1, sharpness: 0.55, ghost: 0.35, ridge: 0.5, spread: 0.5, sweepAngle: 0, roughness: 0.55, gloss: 0.12, selfLight: 0.1 },
+    frost: { type: 'frost', enabled: true, imageUrls: [], interval: 5, duration: 2.6, aspect: 0, breathe: 0.5, intensity: 1, opacity: 1, pointerStrength: 1, pointerRadius: 0.22, pointerColor: '#ffffff', pointerMode: 'fog', gap: 0.06, frost: 0.75, whiteness: 0.25, feather: 0.6, rim: 0.25, refrost: 3, frostColor: '#eef3f8', selfLight: 0.12 },
+    roll: { type: 'roll', enabled: true, imageUrls: [], interval: 5, duration: 2.2, aspect: 0, breathe: 0.5, intensity: 1, opacity: 1, pointerStrength: 1, pointerRadius: 0.6, pointerColor: '#ffffff', pointerMode: 'lift', detail: 220, rollSize: 0.7, sweepAngle: 0, skew: 0.12, roughness: 0.7, paperColor: '#efebe3', selfLight: 0.1 },
+    contour: { type: 'contour', enabled: true, imageUrls: [], interval: 5, duration: 2.8, aspect: 0, breathe: 0.5, intensity: 1, opacity: 1, pointerStrength: 1, pointerRadius: 0.6, pointerColor: '#9ad7ff', pointerMode: 'open', levels: 26, lineWidth: 0.9, depth: 1, open: 0.95, smoothing: 3.2, idleLines: 0.04, tint: 0.35, spread: 1, sweepAngle: 0, lineColor: '#cfe6ff' },
+    engraving: { type: 'engraving', enabled: true, imageUrls: [], interval: 5, duration: 2.4, aspect: 0, breathe: 0.5, intensity: 1, opacity: 1, pointerStrength: 1, pointerRadius: 0.6, pointerColor: '#ffffff', pointerMode: 'comb', cols: 160, length: 2.3, weight: 0.85, relief: 1, hatch: 35, lift: 1, flow: 3.2, fill: 0.12, tint: 0.6, spread: 0.6, sweepAngle: 0, plateColor: '#ece6d9', inkColor: '#1a1c22' },
+};
+export const IMAGE_OBJECT_LABELS = {
+    shards: 'Shards',
+    projector: 'Projector',
+    relief: 'Relief',
+    pinscreen: 'Pinscreen',
+    prism: 'Prism',
+    lenticular: 'Lenticular',
+    frost: 'Frost',
+    roll: 'Roll',
+    contour: 'Contour',
+    engraving: 'Engraving',
+};
+export const IMAGE_OBJECTS_ANIMATABLE = {
+    shards: [
+        { value: 'spread', label: 'Spread' },
+        { value: 'delayJitter', label: 'Delay jitter' },
+        { value: 'lift', label: 'Lift' },
+        { value: 'drift', label: 'Drift' },
+        { value: 'spin', label: 'Spin' },
+        { value: 'breathe', label: 'Breathe' },
+        { value: 'seams', label: 'Seams' },
+        { value: 'rim', label: 'Rim light' },
+        { value: 'intensity', label: 'Intensity' },
+        { value: 'opacity', label: 'Opacity' },
+        { value: 'sweepAngle', label: 'Sweep angle' },
+        { value: 'edgeColor', label: 'Seam colour' },
+        { value: 'rimColor', label: 'Rim colour' },
+        { value: 'backColor', label: 'Backing colour' },
+        { value: 'pointerColor', label: 'Pointer colour' },
+        { value: 'pointerStrength', label: 'Pointer strength' },
+        { value: 'pointerRadius', label: 'Pointer radius' },
+    ],
+    projector: [
+        { value: 'throw', label: 'Throw' },
+        { value: 'lensHeight', label: 'Lens height' },
+        { value: 'haze', label: 'Haze' },
+        { value: 'dust', label: 'Dust' },
+        { value: 'dustDrift', label: 'Dust drift' },
+        { value: 'defocus', label: 'Defocus' },
+        { value: 'hunt', label: 'Hunt' },
+        { value: 'vignette', label: 'Vignette' },
+        { value: 'flicker', label: 'Flicker' },
+        { value: 'screenGain', label: 'Screen gain' },
+        { value: 'breathe', label: 'Breathe' },
+        { value: 'intensity', label: 'Intensity' },
+        { value: 'opacity', label: 'Opacity' },
+        { value: 'pointerStrength', label: 'Pointer strength' },
+        { value: 'pointerRadius', label: 'Pointer radius' },
+        { value: 'lampColor', label: 'Lamp colour' },
+        { value: 'pointerColor', label: 'Pointer colour' },
+    ],
+    relief: [
+        { value: 'depth', label: 'Depth' },
+        { value: 'crest', label: 'Crest' },
+        { value: 'spread', label: 'Spread' },
+        { value: 'sweepAngle', label: 'Sweep angle' },
+        { value: 'roughness', label: 'Roughness' },
+        { value: 'selfLight', label: 'Self light' },
+        { value: 'breathe', label: 'Breathe' },
+        { value: 'intensity', label: 'Intensity' },
+        { value: 'opacity', label: 'Opacity' },
+        { value: 'pointerStrength', label: 'Pointer strength' },
+        { value: 'pointerRadius', label: 'Pointer radius' },
+        { value: 'paperColor', label: 'Paper colour' },
+        { value: 'pointerColor', label: 'Pointer colour' },
+    ],
+    pinscreen: [
+        { value: 'depth', label: 'Depth' },
+        { value: 'dip', label: 'Dip' },
+        { value: 'spread', label: 'Spread' },
+        { value: 'sweepAngle', label: 'Sweep angle' },
+        { value: 'pinSize', label: 'Head size' },
+        { value: 'metal', label: 'Metal' },
+        { value: 'roughness', label: 'Roughness' },
+        { value: 'selfLight', label: 'Self light' },
+        { value: 'breathe', label: 'Breathe' },
+        { value: 'intensity', label: 'Intensity' },
+        { value: 'opacity', label: 'Opacity' },
+        { value: 'pointerStrength', label: 'Pointer strength' },
+        { value: 'pointerRadius', label: 'Pointer radius' },
+        { value: 'pinColor', label: 'Pin colour' },
+        { value: 'plateColor', label: 'Plate colour' },
+        { value: 'pointerColor', label: 'Pointer colour' },
+    ],
+    prism: [
+        { value: 'spread', label: 'Spread' },
+        { value: 'sweepAngle', label: 'Sweep angle' },
+        { value: 'settle', label: 'Settle' },
+        { value: 'gap', label: 'Gap' },
+        { value: 'roughness', label: 'Roughness' },
+        { value: 'selfLight', label: 'Self light' },
+        { value: 'breathe', label: 'Breathe' },
+        { value: 'intensity', label: 'Intensity' },
+        { value: 'opacity', label: 'Opacity' },
+        { value: 'pointerStrength', label: 'Pointer strength' },
+        { value: 'pointerRadius', label: 'Pointer radius' },
+        { value: 'slatColor', label: 'Slat colour' },
+        { value: 'pointerColor', label: 'Pointer colour' },
+    ],
+    lenticular: [
+        { value: 'lenses', label: 'Lenses' },
+        { value: 'thickness', label: 'Thickness' },
+        { value: 'sharpness', label: 'Sharpness' },
+        { value: 'ghost', label: 'Ghost' },
+        { value: 'ridge', label: 'Ridge' },
+        { value: 'spread', label: 'Spread' },
+        { value: 'sweepAngle', label: 'Sweep angle' },
+        { value: 'roughness', label: 'Roughness' },
+        { value: 'gloss', label: 'Gloss' },
+        { value: 'selfLight', label: 'Self light' },
+        { value: 'breathe', label: 'Breathe' },
+        { value: 'intensity', label: 'Intensity' },
+        { value: 'opacity', label: 'Opacity' },
+        { value: 'pointerStrength', label: 'Pointer strength' },
+        { value: 'pointerRadius', label: 'Pointer radius' },
+        { value: 'pointerColor', label: 'Pointer colour' },
+    ],
+    frost: [
+        { value: 'gap', label: 'Gap' },
+        { value: 'frost', label: 'Frost' },
+        { value: 'whiteness', label: 'Whiteness' },
+        { value: 'feather', label: 'Feather' },
+        { value: 'rim', label: 'Rim' },
+        { value: 'refrost', label: 'Refrost' },
+        { value: 'selfLight', label: 'Self light' },
+        { value: 'breathe', label: 'Breathe' },
+        { value: 'intensity', label: 'Intensity' },
+        { value: 'opacity', label: 'Opacity' },
+        { value: 'pointerStrength', label: 'Pointer strength' },
+        { value: 'pointerRadius', label: 'Pointer radius' },
+        { value: 'frostColor', label: 'Frost colour' },
+        { value: 'pointerColor', label: 'Pointer colour' },
+    ],
+    roll: [
+        { value: 'rollSize', label: 'Roll size' },
+        { value: 'sweepAngle', label: 'Sweep angle' },
+        { value: 'skew', label: 'Skew' },
+        { value: 'roughness', label: 'Roughness' },
+        { value: 'selfLight', label: 'Self light' },
+        { value: 'breathe', label: 'Breathe' },
+        { value: 'intensity', label: 'Intensity' },
+        { value: 'opacity', label: 'Opacity' },
+        { value: 'pointerStrength', label: 'Pointer strength' },
+        { value: 'pointerRadius', label: 'Pointer radius' },
+        { value: 'paperColor', label: 'Paper colour' },
+        { value: 'pointerColor', label: 'Pointer colour' },
+    ],
+    contour: [
+        { value: 'levels', label: 'Levels' },
+        { value: 'lineWidth', label: 'Line width' },
+        { value: 'depth', label: 'Depth' },
+        { value: 'open', label: 'Open' },
+        { value: 'smoothing', label: 'Smoothing' },
+        { value: 'idleLines', label: 'Idle lines' },
+        { value: 'tint', label: 'Tint' },
+        { value: 'spread', label: 'Spread' },
+        { value: 'sweepAngle', label: 'Sweep angle' },
+        { value: 'breathe', label: 'Breathe' },
+        { value: 'intensity', label: 'Intensity' },
+        { value: 'opacity', label: 'Opacity' },
+        { value: 'pointerStrength', label: 'Pointer strength' },
+        { value: 'pointerRadius', label: 'Pointer radius' },
+        { value: 'lineColor', label: 'Line colour' },
+        { value: 'pointerColor', label: 'Pointer colour' },
+    ],
+    engraving: [
+        { value: 'length', label: 'Length' },
+        { value: 'weight', label: 'Weight' },
+        { value: 'relief', label: 'Relief' },
+        { value: 'hatch', label: 'Hatch' },
+        { value: 'lift', label: 'Lift' },
+        { value: 'flow', label: 'Flow' },
+        { value: 'fill', label: 'Fill' },
+        { value: 'tint', label: 'Tint' },
+        { value: 'spread', label: 'Spread' },
+        { value: 'sweepAngle', label: 'Sweep angle' },
+        { value: 'breathe', label: 'Breathe' },
+        { value: 'intensity', label: 'Intensity' },
+        { value: 'opacity', label: 'Opacity' },
+        { value: 'pointerStrength', label: 'Pointer strength' },
+        { value: 'pointerRadius', label: 'Pointer radius' },
+        { value: 'plateColor', label: 'Plate colour' },
+        { value: 'inkColor', label: 'Ink colour' },
+        { value: 'pointerColor', label: 'Pointer colour' },
+    ],
+};
+/** True when the config is one of the image variants (type 'image', config.type set). */
+export function isImageObjectConfig(config) {
+    const t = config?.type;
+    return typeof t === 'string' && Object.prototype.hasOwnProperty.call(DEFAULT_IMAGE_OBJECTS, t);
+}

package/dist/data/index.d.ts

@@ -11,6 +11,8 @@ export * from './environmentDefaults';
 export * from './spaceDefaults';
 export * from './landDefaults';
 export * from './textDefaults';
+export * from './imageDefaults';
+export * from './galleryDefaults';
 export * from './shadowDefaults';
 export * from './lightShadowDefaults';
 export * from './defaults';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/data/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC7D,cAAc,qBAAqB,CAAC;AACpC,cAAc,SAAS,CAAC;AACxB,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/data/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC7D,cAAc,qBAAqB,CAAC;AACpC,cAAc,SAAS,CAAC;AACxB,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/dist/data/index.js

@@ -11,6 +11,8 @@ export * from './environmentDefaults.js';
 export * from './spaceDefaults.js';
 export * from './landDefaults.js';
 export * from './textDefaults.js';
+export * from './imageDefaults.js';
+export * from './galleryDefaults.js';
 export * from './shadowDefaults.js';
 export * from './lightShadowDefaults.js';
 export * from './defaults.js';

package/dist/properties/registry.d.ts

@@ -7,7 +7,11 @@ export declare const RAIN_ANIMATABLE_KEYS: readonly ["color", "size", "opacity",
  * renderer, so they have no material properties. They animate through config.
  */
 export declare const SELF_MANAGED_MATERIAL_TYPES: Set<string>;
-/** True when the object draws with its own shaders (the object types above): it gets no material specs. */
+/**
+ * True when the object draws with its own shaders (the object types above), or a gallery variant that does: the
+ * layout gallery's frames take a material, so gallery is decided per object (config.type, galleryTakesMaterial).
+ * Such an object gets no material specs.
+ */
 export declare const selfManagesMaterial: (obj: {
     type?: string;
     config?: unknown;
@@ -34,7 +38,7 @@ export declare function isPropertyLive(element: PropertyElement, spec: PropertyS
 export declare function getAnimatableSpecs(element: PropertyElement, settings: any): PropertySpec[];
 /**
  * Object config families the animation timeline keys. The V2 applier drives
- * `config.*` through the object's live config handle, which these seven register;
+ * `config.*` through the object's live config handle, which these nine register;
  * rain and the legacy cloud object have per-frame knobs for the keyframe /
  * mouse-move systems only.
  */

package/dist/properties/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/properties/registry.ts"],"names":[],"mappings":"AAwDA,OAAO,EACH,KAAK,gBAAgB,EAMxB,MAAM,6BAA6B,CAAC;AAWrC,OAAO,KAAK,EACR,iBAAiB,EAAE,cAAc,EAAE,eAAe,EAAE,YAAY,EAAkB,YAAY,EACjG,MAAM,SAAS,CAAC;AAMjB,0CAA0C;AAC1C,eAAO,MAAM,oBAAoB,+FAAgG,CAAC;AAWlI;;;GAGG;AACH,eAAO,MAAM,2BAA2B,aAA4F,CAAC;AAErI,2GAA2G;AAC3G,eAAO,MAAM,mBAAmB,GAAI,KAAK;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,KAAG,OAClC,CAAC;AAmBjE,4DAA4D;AAC5D,eAAO,MAAM,aAAa,GAAI,KAAK,MAAM,KAAG,MACiC,CAAC;AAE9E,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAOpE;AAID,kGAAkG;AAClG,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,GAAG,YAAY,GAAG,IAAI,CAaxE;AAgCD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,gBAAgB,EAAE,EAAE,MAAM,SAAK,EAAE,MAAM,GAAE,cAAyB,GAAG,YAAY,EAAE,CAExH;AAsOD,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,GAAG,GAAG,YAAY,EAAE,CAIxF;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,GAAG,GAAG,OAAO,CAUnG;AAED,yEAAyE;AACzE,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,GAAG,GAAG,YAAY,EAAE,CAE1F;AAED;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,EAAE,WAAW,CAAC,cAAc,CAA6G,CAAC;AAE3K,wFAAwF;AACxF,wBAAgB,aAAa,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,GAAG,GAAG,YAAY,EAAE,CAIrF;AAgBD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,GAAG,GAAG,YAAY,EAAE,CAG7F;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAE9G;AAED,+CAA+C;AAC/C,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,GAAG,GAAG,iBAAiB,EAAE,CAE/F;AAED,wHAAwH;AACxH,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,KAAG,eAC+E,CAAC"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/properties/registry.ts"],"names":[],"mappings":"AA4DA,OAAO,EACH,KAAK,gBAAgB,EAMxB,MAAM,6BAA6B,CAAC;AAarC,OAAO,KAAK,EACR,iBAAiB,EAAE,cAAc,EAAE,eAAe,EAAE,YAAY,EAAkB,YAAY,EACjG,MAAM,SAAS,CAAC;AAMjB,0CAA0C;AAC1C,eAAO,MAAM,oBAAoB,+FAAgG,CAAC;AAWlI;;;GAGG;AACH,eAAO,MAAM,2BAA2B,aAAqG,CAAC;AAE9I;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,KAAK;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,KAAG,OACsE,CAAC;AAmBzK,4DAA4D;AAC5D,eAAO,MAAM,aAAa,GAAI,KAAK,MAAM,KAAG,MACiC,CAAC;AAE9E,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAOpE;AAID,kGAAkG;AAClG,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,GAAG,YAAY,GAAG,IAAI,CAcxE;AAkCD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,gBAAgB,EAAE,EAAE,MAAM,SAAK,EAAE,MAAM,GAAE,cAAyB,GAAG,YAAY,EAAE,CAExH;AA2OD,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,GAAG,GAAG,YAAY,EAAE,CAIxF;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,GAAG,GAAG,OAAO,CAUnG;AAED,yEAAyE;AACzE,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,GAAG,GAAG,YAAY,EAAE,CAE1F;AAED;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,EAAE,WAAW,CAAC,cAAc,CAAiI,CAAC;AAE/L,wFAAwF;AACxF,wBAAgB,aAAa,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,GAAG,GAAG,YAAY,EAAE,CAIrF;AAgBD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,GAAG,GAAG,YAAY,EAAE,CAG7F;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAE9G;AAED,+CAA+C;AAC/C,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,GAAG,GAAG,iBAAiB,EAAE,CAE/F;AAED,wHAAwH;AACxH,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,KAAG,eAC+E,CAAC"}

package/dist/properties/registry.js

@@ -7,6 +7,8 @@ import { ENVIRONMENT_OBJECTS_ANIMATABLE } from '../data/environmentDefaults.js';
 import { LAND_OBJECTS_ANIMATABLE } from '../data/landDefaults.js';
 import { SPACE_OBJECTS_ANIMATABLE } from '../data/spaceDefaults.js';
 import { TEXT_OBJECTS_ANIMATABLE } from '../data/textDefaults.js';
+import { IMAGE_OBJECTS_ANIMATABLE } from '../data/imageDefaults.js';
+import { GALLERY_OBJECTS_ANIMATABLE, isGalleryObjectConfig, galleryTakesMaterial } from '../data/galleryDefaults.js';
 import { CLOUD_ANIMATABLE_PROPERTIES } from '../environment/cloudConfigs.js';
 import { skyOptionalProperties, skyStarsOptionalProperties, cloudDeckOptionalProperties, cirrusOptionalProperties, thunderOptionalProperties, oceanSurfaceOptionalProperties, terrainOptionalProperties, rainOptionalProperties, cloudsOptionalProperties, plainOptionalProperties, pathOptionalProperties, edgesOptionalProperties, } from './tables/optionalProperties.js';
 import { SHAPE_CONTROLS, MODE_CONTROLS } from './tables/geometryProperties.js';
@@ -18,6 +20,8 @@ import { ENVIRONMENT_PROPERTIES } from './tables/environmentProperties.js';
 import { LAND_PROPERTIES } from './tables/landProperties.js';
 import { SPACE_PROPERTIES } from './tables/spaceProperties.js';
 import { TEXT_PROPERTIES } from './tables/textProperties.js';
+import { IMAGE_PROPERTIES } from './tables/imageProperties.js';
+import { GALLERY_PROPERTIES } from './tables/galleryProperties.js';
 import { MATERIAL_PROPERTY_BOUNDS } from './tables/materialBounds.js';
 // =============================================================================
 // Data owned here (was inline in getAnimatableProperties / the timeline)
@@ -36,9 +40,13 @@ const MATERIAL_STRUCTURAL = new Set([
  * Objects that own their shader: their materialSettings (if any) never reach the
  * renderer, so they have no material properties. They animate through config.
  */
-export const SELF_MANAGED_MATERIAL_TYPES = new Set(['effect', 'grid', 'light', 'particles', 'environment', 'space', 'land', 'text']);
-/** True when the object draws with its own shaders (the object types above): it gets no material specs. */
-export const selfManagesMaterial = (obj) => !!obj && SELF_MANAGED_MATERIAL_TYPES.has(obj.type);
+export const SELF_MANAGED_MATERIAL_TYPES = new Set(['effect', 'grid', 'light', 'particles', 'environment', 'space', 'land', 'text', 'image']);
+/**
+ * True when the object draws with its own shaders (the object types above), or a gallery variant that does: the
+ * layout gallery's frames take a material, so gallery is decided per object (config.type, galleryTakesMaterial).
+ * Such an object gets no material specs.
+ */
+export const selfManagesMaterial = (obj) => !!obj && (SELF_MANAGED_MATERIAL_TYPES.has(obj.type) || (obj.type === 'gallery' && isGalleryObjectConfig(obj.config) && !galleryTakesMaterial(obj.config)));
 const CAMERA_SPECS = [
     { key: 'position', name: 'position', label: 'Position', kind: 'vec3', domain: 'camera', animatable: true },
     { key: 'controls.target', name: 'target', label: 'Target', kind: 'vec3', domain: 'camera', animatable: true },
@@ -70,6 +78,8 @@ export function kindOfValue(key, v) {
     if (Array.isArray(v)) {
         if (v.every(n => typeof n === 'number'))
             return v.length === 3 ? 'vec3' : v.length === 2 ? 'vec2' : null;
+        if (v.every(n => typeof n === 'string'))
+            return 'objects';
         return null;
     }
     if (typeof v === 'number')
@@ -88,6 +98,8 @@ export function kindOfValue(key, v) {
 const OPTIONAL_KIND = {
     number: 'number', string: 'string', boolean: 'boolean', color: 'color',
     vector3: 'vec3', vector2: 'vec2', select: 'select',
+    object: 'string', // a scene object id (picked in the studio, stored as a string)
+    objects: 'objects', // a list of scene object ids (structural; never a track)
 };
 const toOptions = (p) => p.options?.length ? p.options.map((value, i) => (p.optionLabels?.[i] ? { value, label: p.optionLabels[i] } : { value })) : undefined;
 /** One controller row → spec. `animatable` is decided by the caller's rule. */
@@ -222,6 +234,8 @@ function familyOf(obj) {
     const space = () => ({ domain: 'space', list: SPACE_PROPERTIES[t] ?? [], animatable: tableOf(SPACE_OBJECTS_ANIMATABLE[t]) });
     const land = () => ({ domain: 'land', list: LAND_PROPERTIES[t] ?? [], animatable: tableOf(LAND_OBJECTS_ANIMATABLE[t]) });
     const text = () => ({ domain: 'text', list: TEXT_PROPERTIES[t] ?? [], animatable: tableOf(TEXT_OBJECTS_ANIMATABLE[t]) });
+    const image = () => ({ domain: 'image', list: IMAGE_PROPERTIES[t] ?? [], animatable: tableOf(IMAGE_OBJECTS_ANIMATABLE[t]) });
+    const gallery = () => ({ domain: 'gallery', list: GALLERY_PROPERTIES[t] ?? [], animatable: tableOf(GALLERY_OBJECTS_ANIMATABLE[t]) });
     // Environment elements seen through the object view, so the Animation and
     // MouseMove panels (getAnimatableProperties) work on them like on any object.
     // The sky is flat — no config block — so it is keyed before the config.type gate.
@@ -252,6 +266,11 @@ function familyOf(obj) {
         // Text looks only under the text object type (plain, handwriting, …).
         if (type === 'text' && TEXT_OBJECTS_ANIMATABLE[t])
             return text();
+        if (type === 'image' && IMAGE_OBJECTS_ANIMATABLE[t])
+            return image();
+        // Gallery variants only under the gallery object type (layout, carousel, …).
+        if (type === 'gallery' && GALLERY_OBJECTS_ANIMATABLE[t])
+            return gallery();
         if (t === 'rain')
             return { domain: 'rain', list: rainOptionalProperties, animatable: new Map(RAIN_ANIMATABLE_KEYS.map(k => [k, propertyLabel(k)])) };
         if (t === 'clouds')
@@ -390,11 +409,11 @@ export function getAnimatableSpecs(element, settings) {
 }
 /**
  * Object config families the animation timeline keys. The V2 applier drives
- * `config.*` through the object's live config handle, which these seven register;
+ * `config.*` through the object's live config handle, which these nine register;
  * rain and the legacy cloud object have per-frame knobs for the keyframe /
  * mouse-move systems only.
  */
-export const TRACK_CONFIG_DOMAINS = new Set(['light', 'particles', 'effect', 'grid', 'environment', 'space', 'land', 'text']);
+export const TRACK_CONFIG_DOMAINS = new Set(['light', 'particles', 'effect', 'grid', 'environment', 'space', 'land', 'text', 'image', 'gallery']);
 /** What an animation clip can key on this element (timeline track picker, AI clips). */
 export function getTrackSpecs(element, settings) {
     const specs = getAnimatableSpecs(element, settings);

package/dist/properties/tables/effectsProperties.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"effectsProperties.d.ts","sourceRoot":"","sources":["../../../src/properties/tables/effectsProperties.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAY1E,eAAO,MAAM,yBAAyB,EAAE,gBAAgB,EAcvD,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,gBAAgB,EAevD,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,gBAAgB,EAWlD,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,gBAAgB,EAaxD,CAAC;AAEF,eAAO,MAAM,6BAA6B,EAAE,gBAAgB,EAU3D,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,gBAAgB,EAUtD,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,gBAAgB,EAcpD,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,gBAAgB,EAUtD,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,gBAAgB,EAYjD,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,gBAAgB,EASvD,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,gBAAgB,EAQpD,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,gBAAgB,EAclD,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,gBAAgB,EAQxD,CAAC;AAEF,eAAO,MAAM,6BAA6B,EAAE,gBAAgB,EAS3D,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,gBAAgB,EAcvD,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,gBAAgB,EAYzD,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,gBAAgB,EAWxD,CAAC;AAEF,eAAO,MAAM,6BAA6B,EAAE,gBAAgB,EAa3D,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,gBAAgB,EAYvD,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,gBAAgB,EAaxD,CAAC;AAEF,eAAO,MAAM,gCAAgC,EAAE,gBAAgB,EAa9D,CAAC;AAEF,eAAO,MAAM,6BAA6B,EAAE,gBAAgB,EAY3D,CAAC;AAMF,eAAO,MAAM,sBAAsB,EAAE,gBAAgB,EAapD,CAAC;AAEF,eAAO,MAAM,4BAA4B,EAAE,gBAAgB,EAY1D,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,gBAAgB,EAWzD,CAAC;AAEF,eAAO,MAAM,8BAA8B,EAAE,gBAAgB,EAe5D,CAAC;AAEF,eAAO,MAAM,6BAA6B,EAAE,gBAAgB,EAW3D,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,gBAAgB,EAWrD,CAAC;AAEF,eAAO,MAAM,6BAA6B,EAAE,gBAAgB,EAY3D,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,gBAAgB,EAWzD,CAAC;AAEF,eAAO,MAAM,8BAA8B,EAAE,gBAAgB,EAY5D,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,gBAAgB,EASpD,CAAC;AAEF,eAAO,MAAM,6BAA6B,EAAE,gBAAgB,EAY3D,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,gBAAgB,EASrD,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,gBAAgB,EAapD,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,gBAAgB,EAmBzD,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,oBAAoB,EAAE,gBAAgB,EAAE,CAqC9E,CAAC"}
+{"version":3,"file":"effectsProperties.d.ts","sourceRoot":"","sources":["../../../src/properties/tables/effectsProperties.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAY1E,eAAO,MAAM,yBAAyB,EAAE,gBAAgB,EAcvD,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,gBAAgB,EAevD,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,gBAAgB,EAWlD,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,gBAAgB,EAaxD,CAAC;AAEF,eAAO,MAAM,6BAA6B,EAAE,gBAAgB,EAU3D,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,gBAAgB,EAUtD,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,gBAAgB,EAcpD,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,gBAAgB,EAUtD,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,gBAAgB,EAYjD,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,gBAAgB,EASvD,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,gBAAgB,EAQpD,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,gBAAgB,EAclD,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,gBAAgB,EAQxD,CAAC;AAEF,eAAO,MAAM,6BAA6B,EAAE,gBAAgB,EAS3D,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,gBAAgB,EAcvD,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,gBAAgB,EAYzD,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,gBAAgB,EAWxD,CAAC;AAEF,eAAO,MAAM,6BAA6B,EAAE,gBAAgB,EAa3D,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,gBAAgB,EAYvD,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,gBAAgB,EAaxD,CAAC;AAEF,eAAO,MAAM,gCAAgC,EAAE,gBAAgB,EAa9D,CAAC;AAEF,eAAO,MAAM,6BAA6B,EAAE,gBAAgB,EA6B3D,CAAC;AAMF,eAAO,MAAM,sBAAsB,EAAE,gBAAgB,EAapD,CAAC;AAEF,eAAO,MAAM,4BAA4B,EAAE,gBAAgB,EAY1D,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,gBAAgB,EAWzD,CAAC;AAEF,eAAO,MAAM,8BAA8B,EAAE,gBAAgB,EAe5D,CAAC;AAEF,eAAO,MAAM,6BAA6B,EAAE,gBAAgB,EAW3D,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,gBAAgB,EAWrD,CAAC;AAEF,eAAO,MAAM,6BAA6B,EAAE,gBAAgB,EAY3D,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,gBAAgB,EAWzD,CAAC;AAEF,eAAO,MAAM,8BAA8B,EAAE,gBAAgB,EAY5D,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,gBAAgB,EASpD,CAAC;AAEF,eAAO,MAAM,6BAA6B,EAAE,gBAAgB,EAY3D,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,gBAAgB,EASrD,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,gBAAgB,EAapD,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,gBAAgB,EAmBzD,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,oBAAoB,EAAE,gBAAgB,EAAE,CAqC9E,CAAC"}

package/dist/properties/tables/effectsProperties.js

@@ -285,6 +285,23 @@ export const harmonicShellEffectProperties = [
     { name: 'color', description: 'Base tint under the iridescence', type: 'color' },
     { name: 'rimColor', description: 'Rim and nodal-line colour', type: 'color' },
     { name: 'tint', description: 'How much the soap-film bands take on the base colour', type: 'number', min: 0, max: 1, step: 0.01 },
+    // the target: what the shell becomes when `morph` runs to 1
+    { name: 'target', description: 'What the shell becomes: nothing, a word, a shape, or another scene object', type: 'select', options: ['none', 'text', 'shape', 'object'], optionLabels: ['Sphere', 'Text', 'Shape', 'Object'], animatable: false },
+    { name: 'text', description: 'The word the shell becomes (up to 24 characters)', type: 'string', showWhen: [{ key: 'target', is: 'text' }], animatable: false },
+    { name: 'font', description: 'Typeface of the word', type: 'select', options: ['sans', 'display', 'serif', 'mono'], optionLabels: ['Sans', 'Display', 'Serif', 'Mono'], showWhen: [{ key: 'target', is: 'text' }], animatable: false },
+    { name: 'shape', description: 'The shape the shell becomes', type: 'select', options: ['star', 'heart', 'ring', 'hexagon', 'triangle', 'cross', 'disc', 'square', 'diamond', 'pentagon', 'octagon', 'sparkle', 'hexstar', 'crescent', 'drop', 'bolt', 'arrow', 'cloud', 'flower', 'gear', 'shield', 'leaf', 'capsule', 'infinity', 'chevron', 'hourglass', 'clover', 'spade', 'sun', 'halfmoon'], optionLabels: ['Star', 'Heart', 'Ring', 'Hexagon', 'Triangle', 'Cross', 'Disc', 'Square', 'Diamond', 'Pentagon', 'Octagon', 'Sparkle', 'Six star', 'Crescent', 'Drop', 'Bolt', 'Arrow', 'Cloud', 'Flower', 'Gear', 'Shield', 'Leaf', 'Capsule', 'Infinity', 'Chevron', 'Hourglass', 'Clover', 'Spade', 'Sun', 'Half moon'], showWhen: [{ key: 'target', is: 'shape' }], animatable: false },
+    { name: 'targetObject', description: 'Id of the scene object the shell wraps (target: object)', type: 'string', showWhen: [{ key: 'target', is: 'object' }], animatable: false },
+    { name: 'morph', description: 'How far the shell has become its target; animate it for the transition', type: 'number', min: 0, max: 1, step: 0.01, showWhen: [{ key: 'target', not: 'none' }] },
+    { name: 'depth', description: 'Depth of a word or shape, as a fraction of the bounding radius', type: 'number', min: 0.05, max: 1, step: 0.01, showWhen: [{ key: 'target', not: 'none' }] },
+    { name: 'breath', description: 'How much the harmonics keep rippling on the target', type: 'number', min: 0, max: 0.5, step: 0.01, showWhen: [{ key: 'target', not: 'none' }] },
+    { name: 'webCut', description: 'Distance from the target surface where stray pixels fade (hides the webbing between letters)', type: 'number', min: 0.005, max: 0.1, step: 0.005, showWhen: [{ key: 'target', not: 'none' }] },
+    // what the shell does to objects that cross it (runtime only, nothing saved on them)
+    { name: 'insideObjects', label: 'Inside', description: 'Objects that show the shell when they cross it: the inside takes the film, the crossing glows, the inside sways with the membrane (nothing is saved on them)', type: 'objects', animatable: false },
+    { name: 'insideLook', description: 'The inside look: the shell\'s soap film, or the object tinted with the shell colour', type: 'select', options: ['film', 'ghost'], optionLabels: ['Soap film', 'Ghost tint'], animatable: false },
+    { name: 'insideBands', description: 'Scan bands drifting through the inside', type: 'number', min: 0, max: 1, step: 0.01 },
+    { name: 'insideSeam', description: 'The membrane glow where an object crosses the shell', type: 'number', min: 0, max: 1, step: 0.01 },
+    { name: 'insideWarp', description: 'How much the inside of an object follows the membrane (needs a mesh with enough vertices to bend)', type: 'number', min: 0, max: 1.5, step: 0.01 },
+    { name: 'insideCore', description: 'How stiff an object\'s centre is under the warp', type: 'number', min: 0, max: 1, step: 0.01 },
 ];
 // =============================================================================
 // LOOKUP MAP — keyed by GenerativeEffectType

package/dist/properties/tables/galleryProperties.d.ts

@@ -0,0 +1,5 @@
+import type { OptionalProperty } from './optionalProperties';
+import type { GalleryObjectType } from '../../types/galleryObjects';
+export declare const layoutGalleryProperties: OptionalProperty[];
+export declare const GALLERY_PROPERTIES: Record<GalleryObjectType, OptionalProperty[]>;
+//# sourceMappingURL=galleryProperties.d.ts.map

package/dist/properties/tables/galleryProperties.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"galleryProperties.d.ts","sourceRoot":"","sources":["../../../src/properties/tables/galleryProperties.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAUpE,eAAO,MAAM,uBAAuB,EAAE,gBAAgB,EAMrD,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,iBAAiB,EAAE,gBAAgB,EAAE,CAmoB5E,CAAC"}