@2112-lab/central-plant 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,259 @@
+// 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;

package/package.json

@@ -0,0 +1,53 @@
+{  "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"
+  }
+}