@holoscript/core 2.0.1 → 2.1.0

package/src/__tests__/performance.bench.ts

@@ -1,262 +0,0 @@
-/**
- * HoloScript Performance Benchmarks
- *
- * Measures parsing, execution, and type checking performance.
- * Run with: npx vitest bench
- */
-
-import { describe, bench, beforeAll } from 'vitest';
-import { HoloScriptCodeParser } from '../HoloScriptCodeParser';
-import { HoloScriptRuntime } from '../HoloScriptRuntime';
-import { HoloScriptTypeChecker } from '../HoloScriptTypeChecker';
-import type { ASTNode } from '../types';
-
-// Test data
-const SIMPLE_ORB = `
-orb testOrb {
-  name: "TestOrb"
-  color: "#ff0000"
-  glow: true
-}
-`;
-
-const MULTIPLE_ORBS = Array.from({ length: 10 }, (_, i) => `
-orb orb${i} {
-  name: "Orb${i}"
-  color: "#${i.toString(16).padStart(6, '0')}"
-  value: ${i * 10}
-}
-`).join('\n');
-
-const COMPLEX_PROGRAM = `
-orb dataSource {
-  name: "DataSource"
-  rate: 100
-}
-
-orb processor {
-  name: "Processor"
-  capacity: 1000
-}
-
-orb output {
-  name: "Output"
-  format: "json"
-}
-
-function processData(input: number): number {
-  return input * 2
-}
-
-function validateInput(data: object): boolean {
-  return true
-}
-
-connect dataSource to processor as "raw"
-connect processor to output as "processed"
-`;
-
-const FUNCTIONS_PROGRAM = Array.from({ length: 20 }, (_, i) => `
-function func${i}(x: number): number {
-  return x + ${i}
-}
-`).join('\n');
-
-describe('Parser Performance', () => {
-  let parser: HoloScriptCodeParser;
-
-  beforeAll(() => {
-    parser = new HoloScriptCodeParser();
-  });
-
-  bench('parse simple orb', () => {
-    parser.parse(SIMPLE_ORB);
-  });
-
-  bench('parse 10 orbs', () => {
-    parser.parse(MULTIPLE_ORBS);
-  });
-
-  bench('parse complex program', () => {
-    parser.parse(COMPLEX_PROGRAM);
-  });
-
-  bench('parse 20 functions', () => {
-    parser.parse(FUNCTIONS_PROGRAM);
-  });
-
-  bench('tokenize simple orb', () => {
-    // @ts-expect-error - accessing private method for benchmark
-    parser.tokenize(SIMPLE_ORB);
-  });
-
-  bench('tokenize complex program', () => {
-    // @ts-expect-error - accessing private method for benchmark
-    parser.tokenize(COMPLEX_PROGRAM);
-  });
-});
-
-describe('Runtime Performance', () => {
-  let parser: HoloScriptCodeParser;
-  let runtime: HoloScriptRuntime;
-  let simpleAST: ASTNode[];
-  let complexAST: ASTNode[];
-
-  beforeAll(() => {
-    parser = new HoloScriptCodeParser();
-    runtime = new HoloScriptRuntime();
-
-    const simpleResult = parser.parse(SIMPLE_ORB);
-    simpleAST = simpleResult.ast;
-
-    const complexResult = parser.parse(COMPLEX_PROGRAM);
-    complexAST = complexResult.ast;
-  });
-
-  bench('execute simple orb', async () => {
-    runtime.reset();
-    await runtime.executeProgram(simpleAST);
-  });
-
-  bench('execute complex program', async () => {
-    runtime.reset();
-    await runtime.executeProgram(complexAST);
-  });
-
-  bench('execute single node', async () => {
-    if (simpleAST.length > 0) {
-      await runtime.executeNode(simpleAST[0]);
-    }
-  });
-
-  bench('runtime reset', () => {
-    runtime.reset();
-  });
-
-  bench('get context', () => {
-    runtime.getContext();
-  });
-
-  bench('set/get variable', () => {
-    runtime.setVariable('benchVar', 42);
-    runtime.getVariable('benchVar');
-  });
-});
-
-describe('Type Checker Performance', () => {
-  let parser: HoloScriptCodeParser;
-  let typeChecker: HoloScriptTypeChecker;
-  let simpleAST: ASTNode[];
-  let complexAST: ASTNode[];
-  let functionsAST: ASTNode[];
-
-  beforeAll(() => {
-    parser = new HoloScriptCodeParser();
-    typeChecker = new HoloScriptTypeChecker();
-
-    const simpleResult = parser.parse(SIMPLE_ORB);
-    simpleAST = simpleResult.ast;
-
-    const complexResult = parser.parse(COMPLEX_PROGRAM);
-    complexAST = complexResult.ast;
-
-    const functionsResult = parser.parse(FUNCTIONS_PROGRAM);
-    functionsAST = functionsResult.ast;
-  });
-
-  bench('type check simple orb', () => {
-    typeChecker.check(simpleAST);
-  });
-
-  bench('type check complex program', () => {
-    typeChecker.check(complexAST);
-  });
-
-  bench('type check 20 functions', () => {
-    typeChecker.check(functionsAST);
-  });
-
-  bench('get all types', () => {
-    typeChecker.check(complexAST);
-    typeChecker.getAllTypes();
-  });
-});
-
-describe('Full Pipeline Performance', () => {
-  let parser: HoloScriptCodeParser;
-  let runtime: HoloScriptRuntime;
-  let typeChecker: HoloScriptTypeChecker;
-
-  beforeAll(() => {
-    parser = new HoloScriptCodeParser();
-    runtime = new HoloScriptRuntime();
-    typeChecker = new HoloScriptTypeChecker();
-  });
-
-  bench('full pipeline: parse -> type check -> execute (simple)', async () => {
-    const parseResult = parser.parse(SIMPLE_ORB);
-    typeChecker.check(parseResult.ast);
-    runtime.reset();
-    await runtime.executeProgram(parseResult.ast);
-  });
-
-  bench('full pipeline: parse -> type check -> execute (complex)', async () => {
-    const parseResult = parser.parse(COMPLEX_PROGRAM);
-    typeChecker.check(parseResult.ast);
-    runtime.reset();
-    await runtime.executeProgram(parseResult.ast);
-  });
-
-  bench('parse only (no execution)', () => {
-    parser.parse(COMPLEX_PROGRAM);
-  });
-});
-
-describe('Memory and Scalability', () => {
-  let parser: HoloScriptCodeParser;
-  let runtime: HoloScriptRuntime;
-
-  beforeAll(() => {
-    parser = new HoloScriptCodeParser();
-    runtime = new HoloScriptRuntime();
-  });
-
-  bench('parse 100 orbs', () => {
-    const largeProgram = Array.from({ length: 100 }, (_, i) => `
-      orb orb${i} {
-        name: "Orb${i}"
-        value: ${i}
-      }
-    `).join('\n');
-    parser.parse(largeProgram);
-  });
-
-  bench('execute 50 orbs', async () => {
-    const program = Array.from({ length: 50 }, (_, i) => `
-      orb orb${i} {
-        name: "Orb${i}"
-      }
-    `).join('\n');
-
-    const result = parser.parse(program);
-    runtime.reset();
-    await runtime.executeProgram(result.ast);
-  });
-
-  bench('many connections', () => {
-    const program = `
-      orb source { name: "Source" }
-      orb a { name: "A" }
-      orb b { name: "B" }
-      orb c { name: "C" }
-      orb d { name: "D" }
-      orb target { name: "Target" }
-      connect source to a as "data"
-      connect a to b as "data"
-      connect b to c as "data"
-      connect c to d as "data"
-      connect d to target as "data"
-    `;
-    parser.parse(program);
-  });
-});

package/src/__tests__/type-checker.test.js

@@ -1,60 +0,0 @@
-/**
- * HoloScriptTypeChecker Tests - Simplified
- *
- * Tests for type checking system
- */
-import { describe, it, expect, beforeEach } from 'vitest';
-import { HoloScriptTypeChecker } from '../HoloScriptTypeChecker';
-describe('HoloScriptTypeChecker', () => {
-    let typeChecker;
-    beforeEach(() => {
-        typeChecker = new HoloScriptTypeChecker();
-    });
-    describe('Type Inference', () => {
-        it('should initialize type checker', () => {
-            expect(typeChecker).toBeDefined();
-        });
-        it('should infer number type', () => {
-            const result = typeChecker.inferType(42);
-            expect(result.type).toBe('number');
-        });
-        it('should infer string type', () => {
-            const result = typeChecker.inferType('hello');
-            expect(result.type).toBe('string');
-        });
-        it('should infer boolean type', () => {
-            const result = typeChecker.inferType(true);
-            expect(result.type).toBe('boolean');
-        });
-        it('should infer array type', () => {
-            const result = typeChecker.inferType([1, 2, 3]);
-            expect(result.type).toBe('array');
-            expect(result.elementType).toBe('number');
-        });
-        it('should infer object type', () => {
-            const result = typeChecker.inferType({ x: 1 });
-            expect(result.type).toBe('object');
-            expect(result.properties?.size).toBeGreaterThan(0);
-        });
-        it('should infer null/undefined as any with nullable', () => {
-            const result = typeChecker.inferType(null);
-            expect(result.type).toBe('any');
-            expect(result.nullable).toBe(true);
-        });
-    });
-    describe('Type Checking', () => {
-        it('should check AST nodes', () => {
-            const ast = [];
-            const result = typeChecker.check(ast);
-            expect(result.valid).toBeDefined();
-            expect(result.diagnostics).toBeDefined();
-            expect(result.typeMap).toBeDefined();
-        });
-        it('should return valid result for empty AST', () => {
-            const ast = [];
-            const result = typeChecker.check(ast);
-            expect(result.valid).toBe(true);
-            expect(result.diagnostics.length).toBe(0);
-        });
-    });
-});

package/src/__tests__/type-checker.test.ts

@@ -1,73 +0,0 @@
-/**
- * HoloScriptTypeChecker Tests - Simplified
- *
- * Tests for type checking system
- */
-
-import { describe, it, expect, beforeEach } from 'vitest';
-import { HoloScriptTypeChecker } from '../HoloScriptTypeChecker';
-
-describe('HoloScriptTypeChecker', () => {
-  let typeChecker: HoloScriptTypeChecker;
-
-  beforeEach(() => {
-    typeChecker = new HoloScriptTypeChecker();
-  });
-
-  describe('Type Inference', () => {
-    it('should initialize type checker', () => {
-      expect(typeChecker).toBeDefined();
-    });
-
-    it('should infer number type', () => {
-      const result = typeChecker.inferType(42);
-      expect(result.type).toBe('number');
-    });
-
-    it('should infer string type', () => {
-      const result = typeChecker.inferType('hello');
-      expect(result.type).toBe('string');
-    });
-
-    it('should infer boolean type', () => {
-      const result = typeChecker.inferType(true);
-      expect(result.type).toBe('boolean');
-    });
-
-    it('should infer array type', () => {
-      const result = typeChecker.inferType([1, 2, 3]);
-      expect(result.type).toBe('array');
-      expect(result.elementType).toBe('number');
-    });
-
-    it('should infer object type', () => {
-      const result = typeChecker.inferType({ x: 1 });
-      expect(result.type).toBe('object');
-      expect(result.properties?.size).toBeGreaterThan(0);
-    });
-
-    it('should infer null/undefined as any with nullable', () => {
-      const result = typeChecker.inferType(null);
-      expect(result.type).toBe('any');
-      expect(result.nullable).toBe(true);
-    });
-  });
-
-  describe('Type Checking', () => {
-    it('should check AST nodes', () => {
-      const ast: any[] = [];
-      const result = typeChecker.check(ast);
-      expect(result.valid).toBeDefined();
-      expect(result.diagnostics).toBeDefined();
-      expect(result.typeMap).toBeDefined();
-    });
-
-    it('should return valid result for empty AST', () => {
-      const ast: any[] = [];
-      const result = typeChecker.check(ast);
-      expect(result.valid).toBe(true);
-      expect(result.diagnostics.length).toBe(0);
-    });
-  });
-});
-

package/src/index.js

@@ -1,217 +0,0 @@
-/**
- * @holoscript/core
- *
- * HoloScript+ - VR language with declarative syntax, state management, and VR interactions.
- * Enhanced version of HoloScript with:
- * - VR interaction traits (@grabbable, @throwable, @hoverable, etc.)
- * - Reactive state management (@state { ... })
- * - Control flow (@for, @if directives)
- * - TypeScript companion imports
- * - Expression interpolation ${...}
- *
- * Fully backward compatible with original HoloScript syntax.
- *
- * @example
- * ```typescript
- * import { HoloScriptPlusParser, HoloScriptPlusRuntime } from '@holoscript/core';
- *
- * const parser = new HoloScriptPlusParser();
- * const result = parser.parse(`
- *   orb#myOrb {
- *     position: [0, 0, 0]
- *     @grabbable(snap_to_hand: true)
- *     @throwable(bounce: true)
- *   }
- * `);
- *
- * const runtime = new HoloScriptPlusRuntime(result.ast);
- * await runtime.mount(document.body);
- * ```
- *
- * @packageDocumentation
- */
-// Import for use in utility functions
-import { HoloScriptParser } from './HoloScriptParser';
-import { HoloScriptRuntime } from './HoloScriptRuntime';
-// Parser
-export { HoloScriptParser } from './HoloScriptParser';
-export { HoloScript2DParser } from './HoloScript2DParser';
-export { HoloScriptCodeParser } from './HoloScriptCodeParser';
-// HoloScript+ Parser (NEW)
-export { HoloScriptPlusParser, createParser, parse as parseHoloScriptPlus } from './parser/HoloScriptPlusParser';
-// HoloScript+ Enhanced Parser with Trait Annotations (NEW - Phase 3)
-export { HoloScriptPlusParser as HoloScriptTraitAnnotationParser, } from './HoloScriptPlusParser';
-// Runtime
-export { HoloScriptRuntime } from './HoloScriptRuntime';
-// HoloScript+ Runtime (NEW)
-export { HoloScriptPlusRuntimeImpl } from './runtime/HoloScriptPlusRuntime';
-// HoloScript+ State Management (NEW)
-export { ReactiveState, createState, reactive, effect, computed, bind } from './state/ReactiveState';
-// HoloScript+ VR Traits (NEW)
-export { VRTraitRegistry } from './traits/VRTraitSystem';
-// HoloScript+ Voice Input Trait (NEW - Phase 1)
-export { VoiceInputTrait, createVoiceInputTrait, } from './traits/VoiceInputTrait';
-// HoloScript+ AI Driver NPC Trait (NEW - Phase 1)
-export { AIDriverTrait, createAIDriverTrait, BehaviorTreeRunner, GOAPPlanner, } from './traits/AIDriverTrait';
-// HoloScript+ Material Trait (NEW - Phase 2: Graphics)
-export { MaterialTrait, createMaterialTrait, MATERIAL_PRESETS, } from './traits/MaterialTrait';
-// HoloScript+ Lighting Trait (NEW - Phase 2: Graphics)
-export { LightingTrait, createLightingTrait, LIGHTING_PRESETS, } from './traits/LightingTrait';
-// HoloScript+ Rendering Trait (NEW - Phase 2: Graphics)
-export { RenderingTrait, createRenderingTrait, } from './traits/RenderingTrait';
-// Performance Telemetry (NEW - Phase 1)
-export { PerformanceTelemetry, getPerformanceTelemetry, } from './runtime/PerformanceTelemetry';
-// Hololand Graphics Pipeline Service (NEW - Phase 4)
-export { HololandGraphicsPipelineService, } from './services/HololandGraphicsPipelineService';
-// Platform Performance Optimizer (NEW - Phase 5)
-export { PlatformPerformanceOptimizer, } from './services/PlatformPerformanceOptimizer';
-// Type Checker
-export { HoloScriptTypeChecker, createTypeChecker, } from './HoloScriptTypeChecker';
-// Debugger
-export { HoloScriptDebugger, createDebugger, } from './HoloScriptDebugger';
-// Logger
-export { logger, setHoloScriptLogger, enableConsoleLogging, resetLogger, NoOpLogger, ConsoleLogger, } from './logger';
-// Version
-export const HOLOSCRIPT_VERSION = '1.0.0-alpha.1';
-// Supported Platforms
-export const HOLOSCRIPT_SUPPORTED_PLATFORMS = [
-    'WebXR',
-    'Oculus Quest',
-    'HTC Vive',
-    'Valve Index',
-    'Apple Vision Pro',
-    'Windows Mixed Reality',
-];
-// Voice Commands Reference
-export const HOLOSCRIPT_VOICE_COMMANDS = [
-    // 3D VR Commands
-    'create orb [name]',
-    'summon function [name]',
-    'connect [from] to [to]',
-    'execute [function]',
-    'debug program',
-    'visualize [data]',
-    'gate [condition]',
-    'stream [source] through [transformations]',
-    // 2D UI Commands
-    'create button [name]',
-    'add textinput [name]',
-    'create panel [name]',
-    'add slider [name]',
-];
-// Gesture Reference
-export const HOLOSCRIPT_GESTURES = [
-    'pinch - create object',
-    'swipe - connect objects',
-    'rotate - modify properties',
-    'grab - select object',
-    'spread - expand view',
-    'fist - execute action',
-];
-// Demo Scripts
-export const HOLOSCRIPT_DEMO_SCRIPTS = {
-    helloWorld: `orb greeting {
-  message: "Hello, HoloScript World!"
-  color: "#00ffff"
-  glow: true
-}
-
-function displayGreeting() {
-  show greeting
-}`,
-    aiAgent: `orb agentCore {
-  personality: "helpful"
-  capabilities: ["conversation", "problem_solving", "learning"]
-  energy: 100
-}
-
-function processQuery(query: string): string {
-  analyze query
-  generate response
-  return response
-}`,
-    neuralNetwork: `orb inputLayer { neurons: 784 }
-orb hiddenLayer { neurons: 128 }
-orb outputLayer { neurons: 10 }
-
-connect inputLayer to hiddenLayer as "weights"
-connect hiddenLayer to outputLayer as "weights"
-
-function trainNetwork(data: array): object {
-  forward_pass data
-  calculate_loss
-  backward_pass
-  update_weights
-  return metrics
-}`,
-    loginForm: `button loginBtn {
-  text: "Login"
-  x: 100
-  y: 150
-  width: 200
-  height: 40
-  onClick: handleLogin
-}
-
-textinput usernameInput {
-  placeholder: "Username"
-  x: 100
-  y: 50
-  width: 200
-  height: 36
-}
-
-textinput passwordInput {
-  placeholder: "Password"
-  x: 100
-  y: 100
-  width: 200
-  height: 36
-}`,
-    dashboard: `panel sidebar {
-  x: 0
-  y: 0
-  width: 200
-  height: 600
-  backgroundColor: "#2c3e50"
-}
-
-text title {
-  content: "Dashboard"
-  x: 220
-  y: 20
-  fontSize: 24
-  color: "#34495e"
-}
-
-button refreshBtn {
-  text: "Refresh Data"
-  x: 220
-  y: 60
-  onClick: refreshData
-}`,
-};
-// Utility Functions
-/**
- * Create a pre-configured HoloScript environment
- */
-export function createHoloScriptEnvironment() {
-    return {
-        parser: new HoloScriptParser(),
-        runtime: new HoloScriptRuntime(),
-        version: HOLOSCRIPT_VERSION,
-    };
-}
-/**
- * Check if the current environment supports VR/XR
- */
-export function isHoloScriptSupported() {
-    if (typeof globalThis === 'undefined')
-        return false;
-    const win = globalThis;
-    if (!win.window)
-        return false;
-    return !!(win.window.navigator?.xr ||
-        win.window.navigator?.getVRDisplays ||
-        win.window.webkitGetUserMedia);
-}