@2112-lab/central-plant 0.3.39 → 0.3.41

package/dist/bundle/index.js

@@ -37772,6 +37772,21 @@ function applyModelRootTranslation(mesh, modelRoot, origLocalPos, modelOffset) {
   mesh.position.copy(newWorldPos);
 }
 
+/**
+ * Apply a model-root-space translation from a cached rest world position (preview).
+ *
+ * @param {THREE.Object3D} mesh
+ * @param {THREE.Object3D} modelRoot
+ * @param {THREE.Vector3} baseWorldPos
+ * @param {{ x?: number, y?: number, z?: number }} modelOffset
+ */
+function applyModelRootTranslationFromWorldBase(mesh, modelRoot, baseWorldPos, modelOffset) {
+  if (!mesh || !modelRoot || !baseWorldPos) return;
+  var newWorldPos = baseWorldPos.clone().add(modelOffsetToWorldDelta(modelRoot, modelOffset));
+  if (mesh.parent) mesh.parent.worldToLocal(newWorldPos);
+  mesh.position.copy(newWorldPos);
+}
+
 var IoBehaviorManager = /*#__PURE__*/function (_BaseDisposable) {
   function IoBehaviorManager(sceneViewer) {
     var _this;
@@ -40651,7 +40666,7 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
    * Initialize the CentralPlant manager
    * 
    * @constructor
-   * @version 0.3.39
+   * @version 0.3.41
    * @updated 2025-10-22
    * 
    * @description Creates a new CentralPlant instance and initializes internal managers and utilities.
@@ -49329,6 +49344,8 @@ exports.SceneTooltipsManager = SceneTooltipsManager;
 exports.SnapshotManager = SnapshotManager;
 exports.ThreeJSResourceManager = ThreeJSResourceManager;
 exports.applyCrossComponentBehaviors = applyCrossComponentBehaviors;
+exports.applyModelRootTranslation = applyModelRootTranslation;
+exports.applyModelRootTranslationFromWorldBase = applyModelRootTranslationFromWorldBase;
 exports.buildCrossBehavior = buildCrossBehavior;
 exports.buildIntraBehavior = buildIntraBehavior;
 exports.cacheJsonData = cacheJsonData;
@@ -49376,6 +49393,7 @@ exports.loadTextureSetAndCreateMaterial = loadTextureSetAndCreateMaterial;
 exports.markAsComputed = markAsComputed;
 exports.markAsDeclared = markAsDeclared;
 exports.measureS3Transfer = measureS3Transfer;
+exports.modelOffsetToWorldDelta = modelOffsetToWorldDelta;
 exports.modelPreloader = modelPreloader;
 exports.normalizeBehavior = normalizeBehavior;
 exports.parseCrossBehavior = parseCrossBehavior;

package/dist/cjs/src/core/centralPlant.js

@@ -37,7 +37,7 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
    * Initialize the CentralPlant manager
    * 
    * @constructor
-   * @version 0.3.39
+   * @version 0.3.41
    * @updated 2025-10-22
    * 
    * @description Creates a new CentralPlant instance and initializes internal managers and utilities.

package/dist/cjs/src/index.js

@@ -18,6 +18,7 @@ var behaviorSchema = require('./utils/behaviorSchema.js');
 var behaviorRegistration = require('./utils/behaviorRegistration.js');
 var behaviorDispatch = require('./utils/behaviorDispatch.js');
 var behaviorSceneUtils = require('./utils/behaviorSceneUtils.js');
+var animationTransformUtils = require('./utils/animationTransformUtils.js');
 var componentManager = require('./managers/components/componentManager.js');
 var animationManager = require('./managers/scene/animationManager.js');
 var pathfindingManager = require('./managers/pathfinding/pathfindingManager.js');
@@ -87,6 +88,9 @@ exports.loadCrossComponentBehaviors = behaviorSceneUtils.loadCrossComponentBehav
 exports.refreshSceneIntraBehaviors = behaviorSceneUtils.refreshSceneIntraBehaviors;
 exports.reregisterSceneBehaviors = behaviorSceneUtils.reregisterSceneBehaviors;
 exports.scanSceneIoEndpoints = behaviorSceneUtils.scanSceneIoEndpoints;
+exports.applyModelRootTranslation = animationTransformUtils.applyModelRootTranslation;
+exports.applyModelRootTranslationFromWorldBase = animationTransformUtils.applyModelRootTranslationFromWorldBase;
+exports.modelOffsetToWorldDelta = animationTransformUtils.modelOffsetToWorldDelta;
 exports.ComponentManager = componentManager.ComponentManager;
 exports.AnimationManager = animationManager.AnimationManager;
 exports.PathfindingManager = pathfindingManager.PathfindingManager;

package/dist/cjs/src/utils/animationTransformUtils.js

@@ -62,5 +62,21 @@ function applyModelRootTranslation(mesh, modelRoot, origLocalPos, modelOffset) {
   mesh.position.copy(newWorldPos);
 }
 
+/**
+ * Apply a model-root-space translation from a cached rest world position (preview).
+ *
+ * @param {THREE.Object3D} mesh
+ * @param {THREE.Object3D} modelRoot
+ * @param {THREE.Vector3} baseWorldPos
+ * @param {{ x?: number, y?: number, z?: number }} modelOffset
+ */
+function applyModelRootTranslationFromWorldBase(mesh, modelRoot, baseWorldPos, modelOffset) {
+  if (!mesh || !modelRoot || !baseWorldPos) return;
+  var newWorldPos = baseWorldPos.clone().add(modelOffsetToWorldDelta(modelRoot, modelOffset));
+  if (mesh.parent) mesh.parent.worldToLocal(newWorldPos);
+  mesh.position.copy(newWorldPos);
+}
+
 exports.applyModelRootTranslation = applyModelRootTranslation;
+exports.applyModelRootTranslationFromWorldBase = applyModelRootTranslationFromWorldBase;
 exports.modelOffsetToWorldDelta = modelOffsetToWorldDelta;

package/dist/esm/src/core/centralPlant.js

@@ -33,7 +33,7 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
    * Initialize the CentralPlant manager
    * 
    * @constructor
-   * @version 0.3.39
+   * @version 0.3.41
    * @updated 2025-10-22
    * 
    * @description Creates a new CentralPlant instance and initializes internal managers and utilities.

package/dist/esm/src/index.js

@@ -14,6 +14,7 @@ export { buildCrossBehavior, buildIntraBehavior, normalizeBehavior, parseCrossBe
 export { registerBehaviorsForComponent, reloadBehaviorsForDeviceAsset } from './utils/behaviorRegistration.js';
 export { getIoBehaviorManager, getScopedAttachmentKey, resolveDataPoints } from './utils/behaviorDispatch.js';
 export { applyCrossComponentBehaviors, loadCrossComponentBehaviors, refreshSceneIntraBehaviors, reregisterSceneBehaviors, scanSceneIoEndpoints } from './utils/behaviorSceneUtils.js';
+export { applyModelRootTranslation, applyModelRootTranslationFromWorldBase, modelOffsetToWorldDelta } from './utils/animationTransformUtils.js';
 export { ComponentManager } from './managers/components/componentManager.js';
 export { AnimationManager } from './managers/scene/animationManager.js';
 export { PathfindingManager } from './managers/pathfinding/pathfindingManager.js';

package/dist/esm/src/utils/animationTransformUtils.js

@@ -38,4 +38,19 @@ function applyModelRootTranslation(mesh, modelRoot, origLocalPos, modelOffset) {
   mesh.position.copy(newWorldPos);
 }
 
-export { applyModelRootTranslation, modelOffsetToWorldDelta };
+/**
+ * Apply a model-root-space translation from a cached rest world position (preview).
+ *
+ * @param {THREE.Object3D} mesh
+ * @param {THREE.Object3D} modelRoot
+ * @param {THREE.Vector3} baseWorldPos
+ * @param {{ x?: number, y?: number, z?: number }} modelOffset
+ */
+function applyModelRootTranslationFromWorldBase(mesh, modelRoot, baseWorldPos, modelOffset) {
+  if (!mesh || !modelRoot || !baseWorldPos) return;
+  var newWorldPos = baseWorldPos.clone().add(modelOffsetToWorldDelta(modelRoot, modelOffset));
+  if (mesh.parent) mesh.parent.worldToLocal(newWorldPos);
+  mesh.position.copy(newWorldPos);
+}
+
+export { applyModelRootTranslation, applyModelRootTranslationFromWorldBase, modelOffsetToWorldDelta };

package/dist/index.d.ts

@@ -176,6 +176,23 @@ export declare function loadCrossComponentBehaviors(centralPlant: any): CrossCom
 export declare function refreshSceneIntraBehaviors(centralPlant: any, libraryId: string, behaviors: CrossComponentBehavior[]): void
 export declare function reregisterSceneBehaviors(centralPlant: any): void
 
+export declare function modelOffsetToWorldDelta(
+  modelRoot: any,
+  offset: { x?: number; y?: number; z?: number } | { clone(): any }
+): any
+export declare function applyModelRootTranslation(
+  mesh: any,
+  modelRoot: any,
+  origLocalPos: any,
+  modelOffset: { x?: number; y?: number; z?: number }
+): void
+export declare function applyModelRootTranslationFromWorldBase(
+  mesh: any,
+  modelRoot: any,
+  baseWorldPos: any,
+  modelOffset: { x?: number; y?: number; z?: number }
+): void
+
 export declare class IoBehaviorManager {
   constructor(sceneViewer: any)
   loadBehaviors(attachmentId: string, behaviorConfig: BehaviorEntry[] | { behaviors: BehaviorEntry[] }, deviceModelRoot: any, parentUuid: string): void

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@2112-lab/central-plant",
-  "version": "0.3.39",
+  "version": "0.3.41",
   "description": "Utility modules for the Central Plant Application",
   "main": "dist/bundle/index.js",
   "module": "dist/esm/src/index.js",