@2112-lab/central-plant 0.1.0 → 0.1.2

package/dist/index.d.ts

@@ -1,259 +1,255 @@
-// Type definitions for central-plant-utils
-// Project: https://github.com/your-username/central-plant-utils
-// Definitions by: Central Plant Team
-
-import * as THREE from 'three';
-
-// Common types
-export interface CentralPlantComponent {
-  scene?: THREE.Scene;
-  renderer?: THREE.WebGLRenderer;
-  camera?: THREE.Camera;
-  controls?: any;
-  textureLoader?: THREE.TextureLoader;
-  transformManager?: any;
-  currentSceneData?: any;
-  selectedObjectForTransform?: THREE.Object3D;
-  pathfindingManager?: any;
-  modelPreloader?: any;
-  [key: string]: any;
-}
-
-// ==============================
-// Debug Logger
-// ==============================
-export interface Logger {
-  info(message: string, ...args: any[]): void;
-  warn(message: string, ...args: any[]): void;
-  error(message: string, ...args: any[]): void;
-  success(message: string, ...args: any[]): void;
-  debug(message: string, ...args: any[]): void;
-  trace(message: string, ...args: any[]): void;
-}
-
-export const logger: Logger;
-export const transformLogger: Logger;
-export const pathfinderLogger: Logger;
-export const modelLogger: Logger;
-
-// ==============================
-// Name Utils
-// ==============================
-export function generateUuidFromName(name: string): string;
-export function getHardcodedUuid(object: any): string;
-export function findObjectByHardcodedUuid(root: THREE.Object3D, uuid: string): THREE.Object3D | null;
-
-// ==============================
-// Model Preloader
-// ==============================
-export interface CacheStats {
-  totalModels: number;
-  memoryUsage: number;
-  cached: string[];
-}
-
-export interface ModelPreloader {
-  preloadAllModels(componentDictionary: Record<string, string>): Promise<void>;
-  preloadModel(modelKey: string, modelUrl: string): Promise<THREE.Object3D>;
-  getModel(modelKey: string): THREE.Object3D | null;
-  clearCache(): void;
-  getCacheStats(): CacheStats;
-}
-
-export const modelPreloader: ModelPreloader;
-
-// ==============================
-// Pathfinding Manager
-// ==============================
-export class PathfindingManager {
-  constructor(component: CentralPlantComponent);
-  getPathfinderVersionInfo(): Promise<{ version: string; detectionMethod: string; timestamp: string }>;
-  logPathfinderVersion(context?: string): Promise<void>;
-  getPathColor(index: number): string;
-  initializePathfinder(data: any, crosscubeTextureSet: any): Promise<THREE.Object3D[]>;
-  removeAllPaths(): void;
-  createPipeMaterial(crosscubeTextureSet: any, pathIndex: number): THREE.Material;
-  createPipePaths(paths: any[], crosscubeTextureSet: any): THREE.Object3D[];
-}
-
-export function getPathfindingManager(component?: CentralPlantComponent): PathfindingManager;
-
-// ==============================
-// Hot Reload Manager
-// ==============================
-export class HotReloadManager {
-  constructor(componentInstance: any);
-  setupHotReloadHandling(): void;
-  cleanupHotReloadHandlers(): void;
-  trackTimeout(timeoutId: number): number;
-  trackInterval(intervalId: number): number;
-  clearTrackedTimeout(timeoutId: number): boolean;
-  clearTrackedInterval(intervalId: number): boolean;
-  clearAllTrackedTimers(): void;
-}
-
-export function handleHotReload(instanceId: string, cleanupMethod: () => void): void;
-export function isHotReloading(): boolean;
-export function cleanupForHotReload(instanceId: string): void;
-
-// ==============================
-// Environment Manager
-// ==============================
-export class EnvironmentManager {
-  constructor(component: CentralPlantComponent);
-  createSkybox(): Promise<void>;
-  setupLighting(): void;
-  createGround(): THREE.Mesh | null;
-  createWalls(): THREE.Mesh[];
-  setFog(color?: number, density?: number): void;
-  initializeEnvironment(): Promise<void>;
-}
-
-export function getEnvironmentManager(component?: CentralPlantComponent): EnvironmentManager;
-export function initializeEnvironment(component: CentralPlantComponent): Promise<EnvironmentManager>;
-
-// ==============================
-// Texture Config
-// ==============================
-export interface TextureSet {
-  path: string;
-  files: Record<string, string>;
-  repeat?: { x: number; y: number };
-  materialProps?: Record<string, any>;
-}
-
-export const TEXTURE_SETS: Record<string, TextureSet>;
-
-export function createTexture(
-  textureLoader: THREE.TextureLoader, 
-  url: string, 
-  repeat?: { x: number; y: number }
-): THREE.Texture | null;
-
-export function loadTextureSetAndCreateMaterial(
-  component: CentralPlantComponent, 
-  textureSetName: string
-): Promise<THREE.Material>;
-
-// ==============================
-// Scene Export Manager
-// ==============================
-export class SceneExportManager {
-  constructor(componentInstance: CentralPlantComponent);
-  exportSceneData(): any | null;
-  downloadSceneExport(filename?: string | null): boolean;
-  exportSceneDataAsString(pretty?: boolean): string | null;
-  getExportMetadata(): {
-    totalObjects: number;
-    hasCurrentSceneData: boolean;
-    connectionsCount: number;
-    exportTimestamp: string;
-  } | null;
-}
-
-export function getSceneExportManager(component?: CentralPlantComponent): SceneExportManager;
-
-// ==============================
-// Scene Operations Manager
-// ==============================
-export class SceneOperationsManager {
-  constructor(component: CentralPlantComponent);
-  clearSceneObjects(): void;
-  ensureTransformControlsAttached(attachToSelected?: boolean): void;
-  deselectObject(): void;
-  loadSceneData(sceneData: any | string): boolean;
-  findObjectByName(name: string): THREE.Object3D | null;
-  findObjectByUuid(uuid: string): THREE.Object3D | null;
-  removeObject(object: THREE.Object3D): boolean;
-  duplicateObject(sourceObject: THREE.Object3D, options?: {
-    positionOffset?: THREE.Vector3
-  }): THREE.Object3D | null;
-}
-
-export function getSceneOperationsManager(component?: CentralPlantComponent): SceneOperationsManager;
-
-// ==============================
-// Transform Controls Manager
-// ==============================
-export interface TransformControlsConfig {
-  size?: number;
-  enabled?: boolean;
-  showX?: boolean;
-  showY?: boolean;
-  showZ?: boolean;
-  snap?: number | null;
-  translationSnap?: number | null;
-  rotationSnap?: number | null;
-  scaleSnap?: number | null;
-  showBoundingBox?: boolean;
-  boundingBoxColor?: number;
-  useBoundingBoxSelection?: boolean;
-}
-
-export interface TransformCallbacks {
-  onObjectSelect?: (object: THREE.Object3D | null, selected: boolean) => void;
-  onTransformStart?: (object: THREE.Object3D, transform: any) => void;
-  onTransform?: (object: THREE.Object3D, currentTransform: any, initialTransform: any) => void;
-  onTransformEnd?: (object: THREE.Object3D, finalTransform: any, initialTransform: any) => void;
-  onModeChange?: (mode: 'translate' | 'rotate' | 'scale') => void;
-}
-
-export class TransformControlsManager {
-  constructor(scene: THREE.Scene, camera: THREE.Camera, renderer: THREE.WebGLRenderer, orbitControls?: any);
-  init(): Promise<void>;
-  on(callbacks: TransformCallbacks): void;
-  createTransformControls(): void;
-  setupEventListeners(): void;
-  setupKeyboardControls(): void;
-  removeEventListeners(): void;
-  selectObject(object: THREE.Object3D): THREE.Object3D | null;
-  deselectObject(): THREE.Object3D | null;
-  setMode(mode: 'translate' | 'rotate' | 'scale'): void;
-  toggleSpace(): void;
-  toggleVisibility(): void;
-  setEnabled(enabled: boolean): void;
-  updateAxisVisibility(): void;
-  showBoundingBox(object: THREE.Object3D): void;
-  hideBoundingBox(): void;
-  updateBoundingBox(): void;
-  captureObjectTransform(object: THREE.Object3D): any | null;
-  setSnapValues(options: {
-    translation?: number;
-    rotation?: number;
-    scale?: number;
-  }): void;
-  setSize(size: number): void;
-  dispose(): void;
-}
-
-export function getTransformControlsManager(
-  scene: THREE.Scene, 
-  camera: THREE.Camera, 
-  renderer: THREE.WebGLRenderer, 
-  orbitControls?: any
-): TransformControlsManager;
-
-// ==============================
-// Main Module
-// ==============================
-export interface CentralPlantUtils {
-  animation: any;
-  component: any;
-  debug: typeof import('./debugLogger');
-  disposal: any;
-  environment: typeof import('./environmentManager');
-  hotReload: typeof import('./hotReloadManager');
-  keyboardControls: any;
-  modelPreloader: typeof import('./modelPreloader');
-  name: typeof import('./nameUtils');
-  pathfinding: typeof import('./pathfindingManager');
-  performance: any;
-  sceneExport: any;
-  sceneInitialization: any;
-  sceneOperations: any;
-  texture: typeof import('./textureConfig');
-  transformControls: any;
-}
-
-declare const CentralPlantUtils: CentralPlantUtils;
-export default CentralPlantUtils;
+import * as THREE from 'three';
+
+// Common types
+export interface CentralPlantComponent {
+  scene?: THREE.Scene;
+  renderer?: THREE.WebGLRenderer;
+  camera?: THREE.Camera;
+  controls?: any;
+  textureLoader?: THREE.TextureLoader;
+  transformManager?: any;
+  currentSceneData?: any;
+  selectedObjectForTransform?: THREE.Object3D;
+  pathfindingManager?: any;
+  modelPreloader?: any;
+  [key: string]: any;
+}
+
+// ==============================
+// Debug Logger
+// ==============================
+export interface Logger {
+  info(message: string, ...args: any[]): void;
+  warn(message: string, ...args: any[]): void;
+  error(message: string, ...args: any[]): void;
+  success(message: string, ...args: any[]): void;
+  debug(message: string, ...args: any[]): void;
+  trace(message: string, ...args: any[]): void;
+}
+
+export const logger: Logger;
+export const transformLogger: Logger;
+export const pathfinderLogger: Logger;
+export const modelLogger: Logger;
+
+// ==============================
+// Name Utils
+// ==============================
+export function generateUuidFromName(name: string): string;
+export function getHardcodedUuid(object: any): string;
+export function findObjectByHardcodedUuid(root: THREE.Object3D, uuid: string): THREE.Object3D | null;
+
+// ==============================
+// Model Preloader
+// ==============================
+export interface CacheStats {
+  totalModels: number;
+  memoryUsage: number;
+  cached: string[];
+}
+
+export interface ModelPreloader {
+  preloadAllModels(componentDictionary: Record<string, string>): Promise<void>;
+  preloadModel(modelKey: string, modelUrl: string): Promise<THREE.Object3D>;
+  getModel(modelKey: string): THREE.Object3D | null;
+  clearCache(): void;
+  getCacheStats(): CacheStats;
+}
+
+export const modelPreloader: ModelPreloader;
+
+// ==============================
+// Pathfinding Manager
+// ==============================
+export class PathfindingManager {
+  constructor(component: CentralPlantComponent);
+  getPathfinderVersionInfo(): Promise<{ version: string; detectionMethod: string; timestamp: string }>;
+  logPathfinderVersion(context?: string): Promise<void>;
+  getPathColor(index: number): string;
+  initializePathfinder(data: any, crosscubeTextureSet: any): Promise<THREE.Object3D[]>;
+  removeAllPaths(): void;
+  createPipeMaterial(crosscubeTextureSet: any, pathIndex: number): THREE.Material;
+  createPipePaths(paths: any[], crosscubeTextureSet: any): THREE.Object3D[];
+}
+
+export function getPathfindingManager(component?: CentralPlantComponent): PathfindingManager;
+
+// ==============================
+// Hot Reload Manager
+// ==============================
+export class HotReloadManager {
+  constructor(componentInstance: any);
+  setupHotReloadHandling(): void;
+  cleanupHotReloadHandlers(): void;
+  trackTimeout(timeoutId: number): number;
+  trackInterval(intervalId: number): number;
+  clearTrackedTimeout(timeoutId: number): boolean;
+  clearTrackedInterval(intervalId: number): boolean;
+  clearAllTrackedTimers(): void;
+}
+
+export function handleHotReload(instanceId: string, cleanupMethod: () => void): void;
+export function isHotReloading(): boolean;
+export function cleanupForHotReload(instanceId: string): void;
+
+// ==============================
+// Environment Manager
+// ==============================
+export class EnvironmentManager {
+  constructor(component: CentralPlantComponent);
+  createSkybox(): Promise<void>;
+  setupLighting(): void;
+  createGround(): THREE.Mesh | null;
+  createWalls(): THREE.Mesh[];
+  setFog(color?: number, density?: number): void;
+  initializeEnvironment(): Promise<void>;
+}
+
+export function getEnvironmentManager(component?: CentralPlantComponent): EnvironmentManager;
+export function initializeEnvironment(component: CentralPlantComponent): Promise<EnvironmentManager>;
+
+// ==============================
+// Texture Config
+// ==============================
+export interface TextureSet {
+  path: string;
+  files: Record<string, string>;
+  repeat?: { x: number; y: number };
+  materialProps?: Record<string, any>;
+}
+
+export const TEXTURE_SETS: Record<string, TextureSet>;
+
+export function createTexture(
+  textureLoader: THREE.TextureLoader, 
+  url: string, 
+  repeat?: { x: number; y: number }
+): THREE.Texture | null;
+
+export function loadTextureSetAndCreateMaterial(
+  component: CentralPlantComponent, 
+  textureSetName: string
+): Promise<THREE.Material>;
+
+// ==============================
+// Scene Export Manager
+// ==============================
+export class SceneExportManager {
+  constructor(componentInstance: CentralPlantComponent);
+  exportSceneData(): any | null;
+  downloadSceneExport(filename?: string | null): boolean;
+  exportSceneDataAsString(pretty?: boolean): string | null;
+  getExportMetadata(): {
+    totalObjects: number;
+    hasCurrentSceneData: boolean;
+    connectionsCount: number;
+    exportTimestamp: string;
+  } | null;
+}
+
+export function getSceneExportManager(component?: CentralPlantComponent): SceneExportManager;
+
+// ==============================
+// Scene Operations Manager
+// ==============================
+export class SceneOperationsManager {
+  constructor(component: CentralPlantComponent);
+  clearSceneObjects(): void;
+  ensureTransformControlsAttached(attachToSelected?: boolean): void;
+  deselectObject(): void;
+  loadSceneData(sceneData: any | string): boolean;
+  findObjectByName(name: string): THREE.Object3D | null;
+  findObjectByUuid(uuid: string): THREE.Object3D | null;
+  removeObject(object: THREE.Object3D): boolean;
+  duplicateObject(sourceObject: THREE.Object3D, options?: {
+    positionOffset?: THREE.Vector3
+  }): THREE.Object3D | null;
+}
+
+export function getSceneOperationsManager(component?: CentralPlantComponent): SceneOperationsManager;
+
+// ==============================
+// Transform Controls Manager
+// ==============================
+export interface TransformControlsConfig {
+  size?: number;
+  enabled?: boolean;
+  showX?: boolean;
+  showY?: boolean;
+  showZ?: boolean;
+  snap?: number | null;
+  translationSnap?: number | null;
+  rotationSnap?: number | null;
+  scaleSnap?: number | null;
+  showBoundingBox?: boolean;
+  boundingBoxColor?: number;
+  useBoundingBoxSelection?: boolean;
+}
+
+export interface TransformCallbacks {
+  onObjectSelect?: (object: THREE.Object3D | null, selected: boolean) => void;
+  onTransformStart?: (object: THREE.Object3D, transform: any) => void;
+  onTransform?: (object: THREE.Object3D, currentTransform: any, initialTransform: any) => void;
+  onTransformEnd?: (object: THREE.Object3D, finalTransform: any, initialTransform: any) => void;
+  onModeChange?: (mode: 'translate' | 'rotate' | 'scale') => void;
+}
+
+export class TransformControlsManager {
+  constructor(scene: THREE.Scene, camera: THREE.Camera, renderer: THREE.WebGLRenderer, orbitControls?: any);
+  init(): Promise<void>;
+  on(callbacks: TransformCallbacks): void;
+  createTransformControls(): void;
+  setupEventListeners(): void;
+  setupKeyboardControls(): void;
+  removeEventListeners(): void;
+  selectObject(object: THREE.Object3D): THREE.Object3D | null;
+  deselectObject(): THREE.Object3D | null;
+  setMode(mode: 'translate' | 'rotate' | 'scale'): void;
+  toggleSpace(): void;
+  toggleVisibility(): void;
+  setEnabled(enabled: boolean): void;
+  updateAxisVisibility(): void;
+  showBoundingBox(object: THREE.Object3D): void;
+  hideBoundingBox(): void;
+  updateBoundingBox(): void;
+  captureObjectTransform(object: THREE.Object3D): any | null;
+  setSnapValues(options: {
+    translation?: number;
+    rotation?: number;
+    scale?: number;
+  }): void;
+  setSize(size: number): void;
+  dispose(): void;
+}
+
+export function getTransformControlsManager(
+  scene: THREE.Scene, 
+  camera: THREE.Camera, 
+  renderer: THREE.WebGLRenderer, 
+  orbitControls?: any
+): TransformControlsManager;
+
+// ==============================
+// Main Module
+// ==============================
+export interface CentralPlantUtils {
+  animation: any;
+  component: any;
+  debug: typeof import('./debugLogger');
+  disposal: any;
+  environment: typeof import('./environmentManager');
+  hotReload: typeof import('./hotReloadManager');
+  keyboardControls: any;
+  modelPreloader: typeof import('./modelPreloader');
+  name: typeof import('./nameUtils');
+  pathfinding: typeof import('./pathfindingManager');
+  performance: any;
+  sceneExport: any;
+  sceneInitialization: any;
+  sceneOperations: any;
+  texture: typeof import('./textureConfig');
+  transformControls: any;
+}
+
+declare const CentralPlantUtils: CentralPlantUtils;
+export default CentralPlantUtils;

package/package.json

@@ -1,53 +1,52 @@
-{  "name": "@2112-lab/central-plant",
-  "version": "0.1.0",
-  "description": "Utility modules for the Central Plant Application",
-  "main": "dist/bundle/index.js",
-  "module": "dist/esm/index.js",
-  "types": "dist/index.d.ts",
-  "publishConfig": {
-    "access": "public"
-  },
-  "exports": {
-    ".": {
-      "import": "./dist/esm/index.js",
-      "require": "./dist/cjs/index.js"
-    }
-  },
-  "files": [
-    "dist"
-  ],  
-  "scripts": {
-    "build": "rollup -c && npm run build:types",
-    "build:types": "node -e \"require('fs').copyFileSync('src/index.d.ts', 'dist/index.d.ts')\"",
-    "dev": "rollup -c -w",
-    "prepublishOnly": "npm run build"
-  },
-  "keywords": [
-    "central-plant",
-    "three.js",
-    "utilities",
-    "3d"
-  ],
-  "author": "CentralPlant Team",
-  "license": "MIT",  
-  "dependencies": {
-    "three": "^0.150.0",
-    "@2112-lab/pathfinder": "^1.0.15"
-  },  
-  "devDependencies": {
-    "@babel/core": "^7.23.3",
-    "@babel/preset-env": "^7.23.3",
-    "@rollup/plugin-babel": "^6.0.4",
-    "@rollup/plugin-commonjs": "^25.0.7",
-    "@rollup/plugin-node-resolve": "^15.2.3",    
-    "rollup": "^2.79.1",
-    "rollup-plugin-terser": "^7.0.2",
-    "typescript": "^5.0.0",
-    "rollup-plugin-typescript2": "^0.34.0",
-    "tslib": "^2.5.0",
-    "@types/three": "^0.150.0"
-  },
-  "peerDependencies": {
-    "three": ">=0.137.0"
-  }
-}
+{
+  "name": "@2112-lab/central-plant",
+  "version": "0.1.2",
+  "description": "Utility modules for the Central Plant Application",
+  "main": "dist/bundle/index.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "rollup -c && npm run build:types",
+    "build:types": "node -e \"require('fs').copyFileSync('src/index.d.ts', 'dist/index.d.ts')\"",
+    "dev": "rollup -c -w",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "central-plant",
+    "three.js",
+    "utilities",
+    "3d"
+  ],
+  "author": "CentralPlant Team",
+  "license": "MIT",
+  "dependencies": {
+    "@2112-lab/pathfinder": "^1.0.15",
+    "three": ">=0.137.0"
+  },
+  "devDependencies": {
+    "@babel/core": "^7.23.3",
+    "@babel/preset-env": "^7.23.3",
+    "@rollup/plugin-babel": "^6.0.4",
+    "@rollup/plugin-commonjs": "^25.0.7",
+    "@rollup/plugin-node-resolve": "^15.2.3",
+    "@types/three": "^0.150.0",
+    "rollup": "^2.79.1",
+    "rollup-plugin-copy": "^3.5.0",
+    "rollup-plugin-terser": "^7.0.2",
+    "rollup-plugin-typescript2": "^0.34.0",
+    "tslib": "^2.5.0",
+    "typescript": "^5.0.0"
+  },
+  "peerDependencies": {
+    "three": ">=0.137.0"
+  }
+}