@holoscript/core 1.0.0-alpha.1 → 1.0.0-alpha.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@holoscript/core",
-  "version": "1.0.0-alpha.1",
+  "version": "1.0.0-alpha.2",
   "description": "Core HoloScript language - parser, runtime, and AST types",
   "type": "module",
   "main": "./dist/index.js",
@@ -34,6 +34,12 @@
       "require": "./dist/debugger.js"
     }
   },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
   "keywords": [
     "holoscript",
     "vr",
@@ -54,13 +60,8 @@
   },
   "devDependencies": {
     "tsup": "^8.0.1",
+    "typedoc": "^0.28.16",
     "typescript": "^5.3.3",
     "vitest": "^1.0.0"
-  },
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "test": "vitest run",
-    "test:watch": "vitest"
   }
-}
+}

package/src/HoloScriptRuntime.ts

@@ -24,6 +24,7 @@ import type {
   StreamNode,
   SpatialPosition,
   HologramProperties,
+  HologramShape,
   RuntimeContext,
   ExecutionResult,
   ParticleSystem,
@@ -316,6 +317,9 @@ export class HoloScriptRuntime {
         case 'return':
           result = await this.executeReturn(node as ASTNode & { value: unknown });
           break;
+        case 'generic':
+          result = await this.executeGeneric(node);
+          break;
         default:
           result = {
             success: false,
@@ -939,6 +943,242 @@ export class HoloScriptRuntime {
     };
   }
 
+  /**
+   * Execute generic voice commands
+   * Handles commands like: show, hide, animate, pulse, create
+   */
+  private async executeGeneric(_node: ASTNode): Promise<ExecutionResult> {
+    const genericNode = _node as any;
+    const command = String(genericNode.command || '').trim().toLowerCase();
+    const tokens = command.split(/\s+/);
+    const action = tokens[0];
+    const target = tokens[1];
+
+    logger.info('Executing generic command', { command, action, target });
+
+    try {
+      let result: any;
+
+      switch (action) {
+        case 'show':
+          result = await this.executeShowCommand(target, genericNode);
+          break;
+        case 'hide':
+          result = await this.executeHideCommand(target, genericNode);
+          break;
+        case 'create':
+        case 'summon':
+          result = await this.executeCreateCommand(tokens.slice(1), genericNode);
+          break;
+        case 'animate':
+          result = await this.executeAnimateCommand(target, tokens.slice(2), genericNode);
+          break;
+        case 'pulse':
+          result = await this.executePulseCommand(target, tokens.slice(2), genericNode);
+          break;
+        case 'move':
+          result = await this.executeMoveCommand(target, tokens.slice(2), genericNode);
+          break;
+        case 'delete':
+        case 'remove':
+          result = await this.executeDeleteCommand(target, genericNode);
+          break;
+        default:
+          // Default: create visual representation of the generic command
+          logger.warn('Unknown voice command action', { action, command });
+          result = {
+            executed: false,
+            message: `Unknown command: ${action}`,
+          };
+      }
+
+      return {
+        success: true,
+        output: result,
+      };
+    } catch (error) {
+      return {
+        success: false,
+        error: `Generic command execution failed: ${String(error)}`,
+      };
+    }
+  }
+
+  /**
+   * Execute 'show' command
+   */
+  private async executeShowCommand(target: string, _node: any): Promise<any> {
+    // Create or show orb for this target
+    const hologram = _node.hologram || {
+      shape: 'orb',
+      color: '#00ffff',
+      size: 0.8,
+      glow: true,
+      interactive: true,
+    };
+
+    const position = _node.position || { x: 0, y: 0, z: 0 };
+    this.context.spatialMemory.set(target, position);
+    this.createParticleEffect(`${target}_show`, position, hologram.color, 15);
+
+    logger.info('Show command executed', { target, position });
+
+    return {
+      showed: target,
+      hologram,
+      position,
+    };
+  }
+
+  /**
+   * Execute 'hide' command
+   */
+  private async executeHideCommand(target: string, _node: any): Promise<any> {
+    const position = this.context.spatialMemory.get(target) || { x: 0, y: 0, z: 0 };
+    this.createParticleEffect(`${target}_hide`, position, '#ff0000', 10);
+    
+    logger.info('Hide command executed', { target });
+
+    return {
+      hidden: target,
+    };
+  }
+
+  /**
+   * Execute 'create' command
+   */
+  private async executeCreateCommand(tokens: string[], _node: any): Promise<any> {
+    if (tokens.length < 2) {
+      return { error: 'Create command requires shape and name' };
+    }
+
+    const shape = tokens[0];
+    const name = tokens[1];
+    const position = _node.position || { x: 0, y: 0, z: 0 };
+
+    const hologram: HologramProperties = {
+      shape: shape as HologramShape,
+      color: _node.hologram?.color || '#00ffff',
+      size: _node.hologram?.size || 1,
+      glow: _node.hologram?.glow !== false,
+      interactive: _node.hologram?.interactive !== false,
+    };
+
+    this.context.spatialMemory.set(name, position);
+    this.createParticleEffect(`${name}_create`, position, hologram.color, 20);
+
+    logger.info('Create command executed', { shape, name, position });
+
+    return {
+      created: name,
+      shape,
+      hologram,
+      position,
+    };
+  }
+
+  /**
+   * Execute 'animate' command
+   */
+  private async executeAnimateCommand(target: string, tokens: string[], _node: any): Promise<any> {
+    const property = tokens[0] || 'position.y';
+    const duration = parseInt(tokens[1] || '1000', 10);
+    
+    const animation: Animation = {
+      target,
+      property,
+      from: 0,
+      to: 1,
+      duration,
+      startTime: Date.now(),
+      easing: 'ease-in-out',
+    };
+
+    this.animations.set(`${target}_${property}`, animation);
+
+    logger.info('Animate command executed', { target, property, duration });
+
+    return {
+      animating: target,
+      animation,
+    };
+  }
+
+  /**
+   * Execute 'pulse' command
+   */
+  private async executePulseCommand(target: string, tokens: string[], _node: any): Promise<any> {
+    const duration = parseInt(tokens[0] || '500', 10);
+    const position = this.context.spatialMemory.get(target) || { x: 0, y: 0, z: 0 };
+
+    // Create pulsing particle effect
+    this.createParticleEffect(`${target}_pulse`, position, '#ffff00', 30);
+
+    // Create animation for scale
+    const animation: Animation = {
+      target,
+      property: 'scale',
+      from: 1,
+      to: 1.5,
+      duration,
+      startTime: Date.now(),
+      easing: 'sine',
+      yoyo: true,
+      loop: true,
+    };
+
+    this.animations.set(`${target}_pulse`, animation);
+
+    logger.info('Pulse command executed', { target, duration });
+
+    return {
+      pulsing: target,
+      duration,
+    };
+  }
+
+  /**
+   * Execute 'move' command
+   */
+  private async executeMoveCommand(target: string, tokens: string[], _node: any): Promise<any> {
+    const x = parseFloat(tokens[0] || '0');
+    const y = parseFloat(tokens[1] || '0');
+    const z = parseFloat(tokens[2] || '0');
+    const position: SpatialPosition = { x, y, z };
+
+    const current = this.context.spatialMemory.get(target);
+    if (current) {
+      this.context.spatialMemory.set(target, position);
+      this.createConnectionStream(target, `${target}_move`, current, position, 'movement');
+    } else {
+      this.context.spatialMemory.set(target, position);
+    }
+
+    logger.info('Move command executed', { target, position });
+
+    return {
+      moved: target,
+      to: position,
+    };
+  }
+
+  /**
+   * Execute 'delete' command
+   */
+  private async executeDeleteCommand(target: string, _node: any): Promise<any> {
+    const position = this.context.spatialMemory.get(target);
+    if (position) {
+      this.createParticleEffect(`${target}_delete`, position, '#ff0000', 15);
+      this.context.spatialMemory.delete(target);
+    }
+
+    logger.info('Delete command executed', { target });
+
+    return {
+      deleted: target,
+    };
+  }
+
   private async executeStructure(node: ASTNode): Promise<ExecutionResult> {
     // Handle nexus, building, and other structural elements
     const hologram: HologramProperties = node.hologram || {

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2025-2026 HoloScript Contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/dist/chunk-3X2EGU7Z.cjs

@@ -1,52 +0,0 @@
-'use strict';
-
-// src/logger.ts
-var NoOpLogger = class {
-  debug() {
-  }
-  info() {
-  }
-  warn() {
-  }
-  error() {
-  }
-};
-var ConsoleLogger = class {
-  debug(message, meta) {
-    console.debug(`[HoloScript:DEBUG] ${message}`, meta ?? "");
-  }
-  info(message, meta) {
-    console.info(`[HoloScript:INFO] ${message}`, meta ?? "");
-  }
-  warn(message, meta) {
-    console.warn(`[HoloScript:WARN] ${message}`, meta ?? "");
-  }
-  error(message, meta) {
-    console.error(`[HoloScript:ERROR] ${message}`, meta ?? "");
-  }
-};
-var currentLogger = new NoOpLogger();
-function setHoloScriptLogger(logger2) {
-  currentLogger = logger2;
-}
-function enableConsoleLogging() {
-  currentLogger = new ConsoleLogger();
-}
-function resetLogger() {
-  currentLogger = new NoOpLogger();
-}
-var logger = {
-  debug: (msg, meta) => currentLogger.debug(msg, meta),
-  info: (msg, meta) => currentLogger.info(msg, meta),
-  warn: (msg, meta) => currentLogger.warn(msg, meta),
-  error: (msg, meta) => currentLogger.error(msg, meta)
-};
-
-exports.ConsoleLogger = ConsoleLogger;
-exports.NoOpLogger = NoOpLogger;
-exports.enableConsoleLogging = enableConsoleLogging;
-exports.logger = logger;
-exports.resetLogger = resetLogger;
-exports.setHoloScriptLogger = setHoloScriptLogger;
-//# sourceMappingURL=chunk-3X2EGU7Z.cjs.map
-//# sourceMappingURL=chunk-3X2EGU7Z.cjs.map

package/dist/chunk-3X2EGU7Z.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/logger.ts"],"names":["logger"],"mappings":";;;AAaA,IAAM,aAAN,MAA6C;AAAA,EAC3C,KAAA,GAAc;AAAA,EAAC;AAAA,EACf,IAAA,GAAa;AAAA,EAAC;AAAA,EACd,IAAA,GAAa;AAAA,EAAC;AAAA,EACd,KAAA,GAAc;AAAA,EAAC;AACjB;AAEA,IAAM,gBAAN,MAAgD;AAAA,EAC9C,KAAA,CAAM,SAAiB,IAAA,EAAsC;AAC3D,IAAA,OAAA,CAAQ,KAAA,CAAM,CAAA,mBAAA,EAAsB,OAAO,CAAA,CAAA,EAAI,QAAQ,EAAE,CAAA;AAAA,EAC3D;AAAA,EACA,IAAA,CAAK,SAAiB,IAAA,EAAsC;AAC1D,IAAA,OAAA,CAAQ,IAAA,CAAK,CAAA,kBAAA,EAAqB,OAAO,CAAA,CAAA,EAAI,QAAQ,EAAE,CAAA;AAAA,EACzD;AAAA,EACA,IAAA,CAAK,SAAiB,IAAA,EAAsC;AAC1D,IAAA,OAAA,CAAQ,IAAA,CAAK,CAAA,kBAAA,EAAqB,OAAO,CAAA,CAAA,EAAI,QAAQ,EAAE,CAAA;AAAA,EACzD;AAAA,EACA,KAAA,CAAM,SAAiB,IAAA,EAAsC;AAC3D,IAAA,OAAA,CAAQ,KAAA,CAAM,CAAA,mBAAA,EAAsB,OAAO,CAAA,CAAA,EAAI,QAAQ,EAAE,CAAA;AAAA,EAC3D;AACF;AAEA,IAAI,aAAA,GAAkC,IAAI,UAAA,EAAW;AAE9C,SAAS,oBAAoBA,OAAAA,EAAgC;AAClE,EAAA,aAAA,GAAgBA,OAAAA;AAClB;AAEO,SAAS,oBAAA,GAA6B;AAC3C,EAAA,aAAA,GAAgB,IAAI,aAAA,EAAc;AACpC;AAEO,SAAS,WAAA,GAAoB;AAClC,EAAA,aAAA,GAAgB,IAAI,UAAA,EAAW;AACjC;AAEO,IAAM,MAAA,GAA2B;AAAA,EACtC,OAAO,CAAC,GAAA,EAAK,SAAS,aAAA,CAAc,KAAA,CAAM,KAAK,IAAI,CAAA;AAAA,EACnD,MAAM,CAAC,GAAA,EAAK,SAAS,aAAA,CAAc,IAAA,CAAK,KAAK,IAAI,CAAA;AAAA,EACjD,MAAM,CAAC,GAAA,EAAK,SAAS,aAAA,CAAc,IAAA,CAAK,KAAK,IAAI,CAAA;AAAA,EACjD,OAAO,CAAC,GAAA,EAAK,SAAS,aAAA,CAAc,KAAA,CAAM,KAAK,IAAI;AACrD","file":"chunk-3X2EGU7Z.cjs","sourcesContent":["/**\n * @holoscript/core Logger\n *\n * Simple pluggable logger for HoloScript\n */\n\nexport interface HoloScriptLogger {\n  debug(message: string, meta?: Record<string, unknown>): void;\n  info(message: string, meta?: Record<string, unknown>): void;\n  warn(message: string, meta?: Record<string, unknown>): void;\n  error(message: string, meta?: Record<string, unknown>): void;\n}\n\nclass NoOpLogger implements HoloScriptLogger {\n  debug(): void {}\n  info(): void {}\n  warn(): void {}\n  error(): void {}\n}\n\nclass ConsoleLogger implements HoloScriptLogger {\n  debug(message: string, meta?: Record<string, unknown>): void {\n    console.debug(`[HoloScript:DEBUG] ${message}`, meta ?? '');\n  }\n  info(message: string, meta?: Record<string, unknown>): void {\n    console.info(`[HoloScript:INFO] ${message}`, meta ?? '');\n  }\n  warn(message: string, meta?: Record<string, unknown>): void {\n    console.warn(`[HoloScript:WARN] ${message}`, meta ?? '');\n  }\n  error(message: string, meta?: Record<string, unknown>): void {\n    console.error(`[HoloScript:ERROR] ${message}`, meta ?? '');\n  }\n}\n\nlet currentLogger: HoloScriptLogger = new NoOpLogger();\n\nexport function setHoloScriptLogger(logger: HoloScriptLogger): void {\n  currentLogger = logger;\n}\n\nexport function enableConsoleLogging(): void {\n  currentLogger = new ConsoleLogger();\n}\n\nexport function resetLogger(): void {\n  currentLogger = new NoOpLogger();\n}\n\nexport const logger: HoloScriptLogger = {\n  debug: (msg, meta) => currentLogger.debug(msg, meta),\n  info: (msg, meta) => currentLogger.info(msg, meta),\n  warn: (msg, meta) => currentLogger.warn(msg, meta),\n  error: (msg, meta) => currentLogger.error(msg, meta),\n};\n\nexport { NoOpLogger, ConsoleLogger };\n"]}