@3driseai/3drise-core 1.0.19 → 1.0.21

package/dist/utils/getAnimatableProperties.js

@@ -1,72 +1,20 @@
-import { getGenerativeAnimatable } from "./generativeAnimatable.js";
+import { getAnimatableSpecs, getPropertySpecs } from "../properties/registry.js";
 // =============================================================================
-// getAnimatableProperties — canonical per-domain property discovery
+// getAnimatableProperties — per-domain view of the property registry
 // =============================================================================
 //
-// Single source of truth for "what properties can the animations / mouseMove
-// system target on a given domain?". Both *PropsSection (keyframe animations UI)
-// and *MouseMoveSection (mouse-move UI) read from here, so the two systems
-// never drift.
+// What the keyframe Animation tab, the MouseMove tab and analyzeScene can drive on
+// one domain of an object. Since the property registry (src/properties) this is a
+// filter over getAnimatableSpecs: the animatable rule lives there, once, for the
+// timeline, mouse-move, the AI scene analysis and the controllers alike.
 //
-// Accepts any AnimatableTarget — CreatedObjectSettings, CloudsSettings, and
-// future env components (Sky/Ocean/...) all satisfy the structural interface.
+// Values are domain-relative names ('position', 'roughness', 'intensity'), which is
+// what the mouse-move / keyframe domains store.
 //
-// Domain rules:
-//   - transform: hardcoded ['position', 'rotation', 'scale']
-//   - material : keys of settings.materialSettings minus an excluded list
-//   - edges    : geometry props by edgesSettings.type + filtered material keys
-//   - light    : the generated LIGHTS_ANIMATABLE registry, by settings.config.type
-//   - clouds   : ['speed'] when settings.config.type === 'clouds'
+// Transform keeps its three vectors: `visible` is a timeline step track, not
+// something a pointer or a keyframe tween can drive.
 //
 // =============================================================================
-// CONSTANTS
-// =============================================================================
-const TRANSFORM_PROPS = [
-    { value: 'position', label: 'Position' },
-    { value: 'rotation', label: 'Rotation' },
-    { value: 'scale', label: 'Scale' },
-];
-const EXCLUDED_MATERIAL_KEYS = new Set([
-    'materialType', 'materialVariant', 'side',
-    'u_time', 'u_mouse',
-    'apply', 'visible', 'map', 'uHasTexture',
-]);
-// Volumetric cloud deck properties. Only scalars that can be interpolated per
-// frame without rebuilding the density field: altitudes and feature sizes are
-// deliberately absent, because the vertical profile is measured as a fraction of
-// base-to-top, so animating an altitude restretches the whole field and the deck
-// appears to pump rather than move.
-const CLOUDS_PROPS = [
-    { value: 'coverage', label: 'Coverage' },
-    { value: 'density', label: 'Density' },
-    { value: 'profile', label: 'Vertical profile' },
-    { value: 'detailStrength', label: 'Detail erosion' },
-    { value: 'curlStrength', label: 'Curl warp' },
-    { value: 'shear', label: 'Wind shear' },
-    { value: 'anvil', label: 'Anvil spread' },
-    { value: 'precipitation', label: 'Precipitation' },
-    { value: 'windBearing', label: 'Wind bearing' },
-    { value: 'windSpeed', label: 'Wind speed' },
-    { value: 'rise', label: 'Convective rise' },
-    { value: 'churn', label: 'Detail churn' },
-    { value: 'evolution', label: 'Formation / decay' },
-    { value: 'extinction', label: 'Extinction' },
-    { value: 'powder', label: 'Powder' },
-    { value: 'silverLining', label: 'Silver lining' },
-    { value: 'ambient', label: 'Ambient' },
-];
-const RAIN_PROPS = [
-    { value: 'color', label: 'Color' },
-    { value: 'size', label: 'Size' },
-    { value: 'opacity', label: 'Opacity' },
-    { value: 'speed', label: 'Speed' },
-    { value: 'windStrength', label: 'Wind Strength' },
-    { value: 'windDirection', label: 'Wind Direction' },
-    { value: 'turbulence', label: 'Turbulence' },
-];
-// =============================================================================
-// HELPERS
-// =============================================================================
 /** camelCase / kebab-ish → "Title Case". */
 export function toAnimatableLabel(key) {
     return key
@@ -74,94 +22,43 @@ export function toAnimatableLabel(key) {
         .replace(/^./, s => s.toUpperCase())
         .trim();
 }
-function getMaterialProperties(materialSettings) {
-    if (!materialSettings)
-        return [];
-    return Object.keys(materialSettings)
-        .filter(k => !EXCLUDED_MATERIAL_KEYS.has(k))
-        .map(k => ({ value: k, label: k }));
-}
-function getEdgesProperties(edgesSettings) {
-    if (!edgesSettings)
-        return [];
-    const props = [];
-    if (edgesSettings.type === 'tube')
-        props.push({ value: 'tubeRadius', label: 'Tube Radius' });
-    if (edgesSettings.type === 'cube')
-        props.push({ value: 'cubeSize', label: 'Cube Size' });
-    if (edgesSettings.materialSettings) {
-        for (const k of Object.keys(edgesSettings.materialSettings)) {
-            if (EXCLUDED_MATERIAL_KEYS.has(k))
-                continue;
-            props.push({ value: k, label: toAnimatableLabel(k) });
-        }
-    }
-    return props;
-}
-function getCloudsProperties() {
-    return [...CLOUDS_PROPS];
-}
-function getRainProperties() {
-    return [...RAIN_PROPS];
-}
-function isCloudsConfig(config) {
-    return config?.type === 'clouds';
-}
-function isRainConfig(config) {
-    return config?.type === 'rain';
-}
-// =============================================================================
-// MAIN
-// =============================================================================
+const toAnimatable = (s) => {
+    const out = { value: s.name, label: s.label, kind: s.kind };
+    if (s.min !== undefined)
+        out.min = s.min;
+    if (s.max !== undefined)
+        out.max = s.max;
+    if (s.step !== undefined)
+        out.step = s.step;
+    return out;
+};
 export function getAnimatableProperties(settings, domain) {
-    switch (domain) {
-        case 'transform':
-            return [...TRANSFORM_PROPS];
-        case 'material':
-            return getMaterialProperties(settings.materialSettings);
-        case 'edges':
-            return getEdgesProperties(settings.edgesSettings);
-        // Lights read the same generated registry as the generative families, so a
-        // new light type's knobs show up without touching this file.
-        case 'light':
-            return getGenerativeAnimatable('lights', settings.config);
-        case 'clouds':
-            return isCloudsConfig(settings.config) ? getCloudsProperties() : [];
-        case 'rain':
-            return isRainConfig(settings.config) ? getRainProperties() : [];
-        // Generative families read their knobs from the generated registry, so the
-        // panel always matches what the renderer can actually drive per frame.
-        case 'particles':
-            return getGenerativeAnimatable('particles', settings.config);
-        default:
-            return [];
-    }
+    if (!settings)
+        return [];
+    return getAnimatableSpecs('object', settings)
+        .filter(s => s.domain === domain)
+        .filter(s => domain !== 'transform' || s.kind === 'vec3')
+        .map(toAnimatable);
 }
+/** Domain priority when a name exists in more than one (edges before material: an edges key shadows the mesh's). */
+const DETECT_ORDER = ['edges', 'light', 'effect', 'grid', 'particles', 'clouds', 'rain', 'material'];
 /**
  * Detect which domain a property name belongs to, for a given target. Used by
  * the runtime + UI to migrate flat MouseMove arrays into the new per-domain
  * shape, and to route the runtime's combined dispatch.
+ *
+ * Reads every registry property (not only animatable ones), so an entry saved
+ * before the animatable rule tightened still routes to its domain.
  */
 export function detectAnimatableDomain(settings, propertyName) {
     const head = propertyName.split('.')[0];
     if (head === 'position' || head === 'rotation' || head === 'scale') {
         return 'transform';
     }
-    const edges = getEdgesProperties(settings.edgesSettings).map(p => p.value);
-    if (edges.includes(propertyName))
-        return 'edges';
-    if (getGenerativeAnimatable('lights', settings.config).some(p => p.value === propertyName))
-        return 'light';
-    if (isCloudsConfig(settings.config)) {
-        if (getCloudsProperties().some(p => p.value === propertyName))
-            return 'clouds';
-    }
-    if (isRainConfig(settings.config)) {
-        if (getRainProperties().some(p => p.value === propertyName))
-            return 'rain';
+    const specs = getPropertySpecs('object', settings);
+    for (const domain of DETECT_ORDER) {
+        if (specs.some(s => s.domain === domain && s.name === propertyName))
+            return domain;
     }
-    const material = getMaterialProperties(settings.materialSettings).map(p => p.value);
-    if (material.includes(propertyName))
-        return 'material';
     return null;
 }

package/dist/utils/index.d.ts

@@ -38,4 +38,5 @@ export * from './MaterialCompiler';
 export * from './nodeOverrides';
 export * from './settingsPatch';
 export * from './actionKeys';
+export * from './objectEffects';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,yBAAyB,CAAC;AACxC,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,yBAAyB,CAAC;AACxC,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC"}

package/dist/utils/index.js

@@ -38,3 +38,4 @@ export * from './MaterialCompiler.js';
 export * from './nodeOverrides.js';
 export * from './settingsPatch.js';
 export * from './actionKeys.js';
+export * from './objectEffects.js';

package/dist/utils/objectEffects.d.ts

@@ -0,0 +1,6 @@
+import type { ObjectEffect } from '../types/objectSettings';
+/** The object effects of a stored object — entries of any older shape (generative effects) are dropped. */
+export declare function objectEffectsOf(settings: {
+    effects?: unknown;
+} | null | undefined): ObjectEffect[];
+//# sourceMappingURL=objectEffects.d.ts.map

package/dist/utils/objectEffects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"objectEffects.d.ts","sourceRoot":"","sources":["../../src/utils/objectEffects.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D,2GAA2G;AAC3G,wBAAgB,eAAe,CAAC,QAAQ,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,GAAG,YAAY,EAAE,CAGlG"}

package/dist/utils/objectEffects.js

@@ -0,0 +1,5 @@
+/** The object effects of a stored object — entries of any older shape (generative effects) are dropped. */
+export function objectEffectsOf(settings) {
+    const list = settings?.effects;
+    return Array.isArray(list) ? list.filter((e) => e && typeof e.operation === 'string' && typeof e.id === 'string') : [];
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@3driseai/3drise-core",
-  "version": "1.0.19",
+  "version": "1.0.21",
   "private": false,
   "type": "module",
   "main": "./dist/index.js",