@holoscript/core 2.0.1 → 2.0.2

package/dist/types-D6g4ACjP.d.ts

@@ -0,0 +1,262 @@
+/**
+ * @holoscript/core Types
+ *
+ * Core type definitions for HoloScript AST and runtime
+ */
+interface SpatialPosition {
+    x: number;
+    y: number;
+    z: number;
+}
+interface Position2D {
+    x: number;
+    y: number;
+}
+interface Size2D {
+    width: number;
+    height: number;
+}
+type HologramShape = 'orb' | 'cube' | 'cylinder' | 'pyramid' | 'sphere';
+interface HologramProperties {
+    shape: HologramShape;
+    color: string;
+    size: number;
+    glow: boolean;
+    interactive: boolean;
+}
+interface VoiceCommand {
+    command: string;
+    confidence: number;
+    timestamp: number;
+    spatialContext?: SpatialPosition;
+}
+type GestureType = 'pinch' | 'swipe' | 'rotate' | 'grab' | 'release';
+type HandType = 'left' | 'right';
+interface GestureData {
+    type: GestureType;
+    position: SpatialPosition;
+    direction?: SpatialPosition;
+    magnitude: number;
+    hand: HandType;
+}
+interface ASTNode {
+    type: string;
+    position?: SpatialPosition;
+    hologram?: HologramProperties;
+    /** Source line number (1-indexed) */
+    line?: number;
+    /** Source column number (0-indexed) */
+    column?: number;
+}
+interface OrbNode extends ASTNode {
+    type: 'orb';
+    name: string;
+    properties: Record<string, unknown>;
+    methods: MethodNode[];
+}
+interface MethodNode extends ASTNode {
+    type: 'method';
+    name: string;
+    parameters: ParameterNode[];
+    body: ASTNode[];
+    returnType?: string;
+}
+interface ParameterNode extends ASTNode {
+    type: 'parameter';
+    name: string;
+    dataType: string;
+    defaultValue?: unknown;
+}
+interface ConnectionNode extends ASTNode {
+    type: 'connection';
+    from: string;
+    to: string;
+    dataType: string;
+    bidirectional: boolean;
+}
+interface GateNode extends ASTNode {
+    type: 'gate';
+    condition: string;
+    truePath: ASTNode[];
+    falsePath: ASTNode[];
+}
+interface StreamNode extends ASTNode {
+    type: 'stream';
+    name: string;
+    source: string;
+    transformations: TransformationNode[];
+}
+interface TransformationNode extends ASTNode {
+    type: 'transformation';
+    operation: string;
+    parameters: Record<string, unknown>;
+}
+interface GenericASTNode extends ASTNode {
+    [key: string]: unknown;
+}
+interface ForLoopNode extends ASTNode {
+    type: 'for-loop';
+    init: string;
+    condition: string;
+    update: string;
+    body: ASTNode[];
+}
+interface WhileLoopNode extends ASTNode {
+    type: 'while-loop';
+    condition: string;
+    body: ASTNode[];
+}
+interface ForEachLoopNode extends ASTNode {
+    type: 'foreach-loop';
+    variable: string;
+    collection: string;
+    body: ASTNode[];
+}
+interface ImportNode extends ASTNode {
+    type: 'import';
+    imports: string[];
+    defaultImport?: string;
+    modulePath: string;
+}
+type ImportLoader = (path: string) => Promise<string>;
+interface ExportNode extends ASTNode {
+    type: 'export';
+    exports?: string[];
+    declaration?: ASTNode;
+}
+interface VariableDeclarationNode extends ASTNode {
+    type: 'variable-declaration';
+    kind: 'const' | 'let' | 'var';
+    name: string;
+    dataType?: string;
+    value?: unknown;
+    isExpression?: boolean;
+}
+type UIElementType = 'canvas' | 'button' | 'textinput' | 'panel' | 'text' | 'image' | 'list' | 'modal' | 'slider' | 'toggle' | 'dropdown' | 'flex-container' | 'grid-container' | 'scroll-view' | 'tab-view' | 'dashboard' | 'card' | 'metric' | 'row' | 'col';
+interface UI2DNode {
+    type: '2d-element';
+    elementType: UIElementType;
+    name: string;
+    properties: Record<string, unknown>;
+    children?: UI2DNode[];
+    events?: Record<string, string>;
+}
+interface UIStyle {
+    backgroundColor?: string;
+    color?: string;
+    fontSize?: number;
+    fontFamily?: string;
+    borderColor?: string;
+    borderWidth?: number;
+    borderRadius?: number;
+    padding?: number;
+    margin?: number;
+}
+interface RuntimeContext {
+    variables: Map<string, unknown>;
+    functions: Map<string, MethodNode>;
+    exports: Map<string, unknown>;
+    connections: ConnectionNode[];
+    spatialMemory: Map<string, SpatialPosition>;
+    hologramState: Map<string, HologramProperties>;
+    executionStack: ASTNode[];
+}
+interface ExecutionResult {
+    success: boolean;
+    output?: unknown;
+    hologram?: HologramProperties;
+    spatialPosition?: SpatialPosition;
+    error?: string;
+    executionTime?: number;
+    learningSignals?: any;
+}
+interface ParticleSystem {
+    particles: SpatialPosition[];
+    color: string;
+    lifetime: number;
+    speed: number;
+}
+interface SecurityConfig {
+    maxCommandLength: number;
+    maxTokens: number;
+    maxHologramsPerUser: number;
+    suspiciousKeywords: string[];
+    allowedShapes: string[];
+    allowedUIElements: string[];
+}
+interface RuntimeSecurityLimits {
+    maxExecutionDepth: number;
+    maxTotalNodes: number;
+    maxExecutionTimeMs: number;
+    maxParticlesPerSystem: number;
+}
+interface Vector3 {
+    x: number;
+    y: number;
+    z: number;
+}
+interface Vector2 {
+    x: number;
+    y: number;
+}
+interface Color {
+    r: number;
+    g: number;
+    b: number;
+    a?: number;
+}
+interface Duration {
+    milliseconds: number;
+}
+interface Transform {
+    position: Vector3;
+    rotation: Vector3;
+    scale: Vector3;
+}
+type VRHand = 'left' | 'right' | 'both';
+interface ThrowVelocity {
+    magnitude: number;
+    direction: Vector3;
+    spin?: Vector3;
+}
+interface CollisionEvent {
+    object1: string;
+    object2: string;
+    position: Vector3;
+    normal: Vector3;
+    force: number;
+    timestamp: number;
+}
+interface GrabbableTrait {
+    snapToHand: boolean;
+    grip_type: 'palm' | 'pinch' | 'full';
+    haptic_feedback: boolean;
+}
+interface ThrowableTrait {
+    velocityMultiplier: number;
+    enableSpin: boolean;
+    gravityScale: number;
+}
+interface PointableTrait {
+    maxPointDistance: number;
+    interactionRadius: number;
+    hapticFeedback: boolean;
+}
+interface HoverableTrait {
+    hoverDistance: number;
+    hoverColor: Color;
+    hoverScale: number;
+    enableHighlight: boolean;
+}
+interface ScalableTrait {
+    minScale: number;
+    maxScale: number;
+    scaleSpeed: number;
+}
+interface RotatableTrait {
+    rotationSpeed: number;
+    freeRotation: boolean;
+    snapAngles?: number[];
+}
+
+export type { ASTNode as A, ExecutionResult as B, ConnectionNode as C, Duration as D, ExportNode as E, ForLoopNode as F, GestureData as G, HologramShape as H, ImportNode as I, ParticleSystem as J, SecurityConfig as K, RuntimeSecurityLimits as L, MethodNode as M, OrbNode as O, Position2D as P, RotatableTrait as R, SpatialPosition as S, TransformationNode as T, UI2DNode as U, VoiceCommand as V, WhileLoopNode as W, Size2D as a, HologramProperties as b, GestureType as c, HandType as d, ParameterNode as e, GateNode as f, StreamNode as g, GenericASTNode as h, Vector3 as i, Vector2 as j, Color as k, Transform as l, VRHand as m, ThrowVelocity as n, CollisionEvent as o, GrabbableTrait as p, ThrowableTrait as q, PointableTrait as r, HoverableTrait as s, ScalableTrait as t, ForEachLoopNode as u, ImportLoader as v, VariableDeclarationNode as w, UIElementType as x, UIStyle as y, RuntimeContext as z };

package/package.json

@@ -1,12 +1,15 @@
 {
   "name": "@holoscript/core",
-  "version": "2.0.1",
+  "version": "2.0.2",
   "description": "HoloScript+: VR language with declarative syntax, state management, reactive traits, and VR interactions. Full backward compatible with original HoloScript.",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
   "sideEffects": false,
+  "files": [
+    "dist"
+  ],
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -34,12 +37,6 @@
       "require": "./dist/debugger.js"
     }
   },
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "test": "vitest run",
-    "test:watch": "vitest"
-  },
   "keywords": [
     "holoscript",
     "vr",
@@ -63,5 +60,11 @@
     "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/HoloScript2DParser.js

@@ -1,227 +0,0 @@
-/**
- * HoloScript 2D Parser Extension
- *
- * Adds support for 2D UI elements to HoloScript for desktop/mobile apps.
- * Works alongside 3D VR syntax for hybrid applications.
- */
-import { logger } from './logger';
-const UI_SECURITY_CONFIG = {
-    maxUIElements: 500,
-    maxNestingDepth: 10,
-    maxPropertyLength: 500,
-    allowedEventHandlers: ['onClick', 'onChange', 'onSubmit', 'onFocus', 'onBlur', 'onHover'],
-};
-export class HoloScript2DParser {
-    constructor() {
-        this.uiElements = new Map();
-    }
-    /**
-     * Parse 2D UI element from HoloScript code
-     */
-    parse2DElement(code, depth = 0) {
-        if (depth > UI_SECURITY_CONFIG.maxNestingDepth) {
-            logger.warn('Max nesting depth exceeded', { depth });
-            return null;
-        }
-        const trimmedCode = code.trim();
-        const lines = trimmedCode.split('\n');
-        if (lines.length === 0)
-            return null;
-        const firstLine = lines[0].trim();
-        const headerMatch = firstLine.match(/^([\w-]+)\s+(\w+)\s*\{/);
-        if (!headerMatch) {
-            logger.warn('Invalid 2D element syntax', { line: firstLine });
-            return null;
-        }
-        const [, elementType, name] = headerMatch;
-        if (!this.isValidUIElementType(elementType)) {
-            logger.warn('Invalid UI element type', { elementType });
-            return null;
-        }
-        const startIndex = trimmedCode.indexOf('{');
-        const endIndex = trimmedCode.lastIndexOf('}');
-        if (startIndex === -1 || endIndex === -1 || endIndex <= startIndex) {
-            return null;
-        }
-        const innerContent = trimmedCode.slice(startIndex + 1, endIndex).trim();
-        const innerLines = this.splitIntoLogicalBlocks(innerContent);
-        const properties = {};
-        const events = {};
-        const children = [];
-        for (const block of innerLines) {
-            const line = block.trim();
-            if (!line)
-                continue;
-            if (line.includes('{')) {
-                const childNode = this.parse2DElement(line, depth + 1);
-                if (childNode)
-                    children.push(childNode);
-                continue;
-            }
-            const propMatch = line.match(/^(\w+):\s*(.+)$/);
-            if (propMatch) {
-                const [, key, rawValue] = propMatch;
-                if (UI_SECURITY_CONFIG.allowedEventHandlers.includes(key)) {
-                    events[key] = rawValue.trim();
-                }
-                else {
-                    properties[key] = this.parsePropertyValue(rawValue);
-                }
-            }
-        }
-        const node = {
-            type: '2d-element',
-            elementType: elementType,
-            name,
-            properties: { ...this.getDefaultProperties(elementType), ...properties },
-            events: Object.keys(events).length > 0 ? events : undefined,
-            children: children.length > 0 ? children : undefined,
-        };
-        if (depth === 0) {
-            if (this.uiElements.size >= UI_SECURITY_CONFIG.maxUIElements) {
-                logger.warn('Max UI elements limit reached');
-                return null;
-            }
-            this.uiElements.set(name, node);
-        }
-        return node;
-    }
-    splitIntoLogicalBlocks(content) {
-        const blocks = [];
-        let currentBlock = '';
-        let bracketDepth = 0;
-        for (let i = 0; i < content.length; i++) {
-            const char = content[i];
-            if (char === '{')
-                bracketDepth++;
-            if (char === '}')
-                bracketDepth--;
-            currentBlock += char;
-            if (bracketDepth === 0) {
-                if (char === '\n' || i === content.length - 1) {
-                    const trimmed = currentBlock.trim();
-                    if (trimmed)
-                        blocks.push(trimmed);
-                    currentBlock = '';
-                }
-            }
-        }
-        const finalTrimmed = currentBlock.trim();
-        if (finalTrimmed)
-            blocks.push(finalTrimmed);
-        return blocks;
-    }
-    /**
-     * Parse voice command for 2D UI creation
-     */
-    parse2DVoiceCommand(command) {
-        const tokens = command.toLowerCase().trim().split(/\s+/);
-        if (tokens.length < 3)
-            return null;
-        const action = tokens[0];
-        const elementType = tokens[1];
-        const name = tokens[2];
-        if (action !== 'create' && action !== 'add')
-            return null;
-        if (!this.isValidUIElementType(elementType))
-            return null;
-        const node = {
-            type: '2d-element',
-            elementType: elementType,
-            name,
-            properties: this.getDefaultProperties(elementType),
-        };
-        this.uiElements.set(name, node);
-        return node;
-    }
-    /**
-     * Parse gesture for 2D UI interaction
-     */
-    parse2DGesture(gestureType, position) {
-        switch (gestureType) {
-            case 'tap':
-                return this.createQuick2DElement('button', `button_${Date.now()}`, position);
-            case 'double-tap':
-                return this.createQuick2DElement('textinput', `input_${Date.now()}`, position);
-            case 'long-press':
-                return this.createQuick2DElement('panel', `panel_${Date.now()}`, position);
-            default:
-                return null;
-        }
-    }
-    createQuick2DElement(elementType, name, position) {
-        const node = {
-            type: '2d-element',
-            elementType,
-            name,
-            properties: {
-                ...this.getDefaultProperties(elementType),
-                x: position.x,
-                y: position.y,
-            },
-        };
-        this.uiElements.set(name, node);
-        return node;
-    }
-    isValidUIElementType(type) {
-        const validTypes = [
-            'canvas', 'button', 'textinput', 'panel', 'text', 'image',
-            'list', 'modal', 'slider', 'toggle', 'dropdown',
-            'flex-container', 'grid-container', 'scroll-view', 'tab-view'
-        ];
-        return validTypes.includes(type);
-    }
-    parsePropertyValue(value) {
-        const trimmed = value.trim();
-        if ((trimmed.startsWith('"') && trimmed.endsWith('"')) ||
-            (trimmed.startsWith("'") && trimmed.endsWith("'"))) {
-            return trimmed.slice(1, -1);
-        }
-        if (!isNaN(parseFloat(trimmed)) && isFinite(parseFloat(trimmed))) {
-            return parseFloat(trimmed);
-        }
-        if (trimmed === 'true')
-            return true;
-        if (trimmed === 'false')
-            return false;
-        if (trimmed.startsWith('[') && trimmed.endsWith(']')) {
-            const items = trimmed.slice(1, -1).split(',').map(item => this.parsePropertyValue(item.trim()));
-            return items;
-        }
-        return trimmed;
-    }
-    getDefaultProperties(elementType) {
-        const defaults = {
-            'canvas': { width: 800, height: 600, backgroundColor: '#ffffff' },
-            'button': { text: 'Button', width: 120, height: 40, backgroundColor: '#007bff', color: '#ffffff', borderRadius: 4 },
-            'textinput': { placeholder: '', width: 200, height: 36, fontSize: 14, borderColor: '#cccccc', borderWidth: 1, borderRadius: 4 },
-            'panel': { width: 200, height: 200, backgroundColor: '#f0f0f0', borderRadius: 0 },
-            'text': { content: 'Text', fontSize: 16, color: '#000000', fontFamily: 'sans-serif' },
-            'image': { src: '', width: 100, height: 100, fit: 'cover' },
-            'list': { items: [], itemHeight: 40, width: 200, height: 300 },
-            'modal': { title: 'Modal', width: 400, height: 300, visible: false, backgroundColor: '#ffffff' },
-            'slider': { min: 0, max: 100, value: 50, width: 200 },
-            'toggle': { checked: false, width: 50, height: 24 },
-            'dropdown': { options: [], selected: null, width: 200 },
-            'flex-container': { direction: 'row', gap: 10, padding: 10 },
-            'grid-container': { columns: 3, gap: 10, padding: 10 },
-            'scroll-view': { width: 300, height: 400, scrollDirection: 'vertical' },
-            'tab-view': { tabs: [], activeTabId: null, tabPosition: 'top', width: 400, height: 300 },
-            'dashboard': { title: 'Dashboard', width: 1200, height: 800, layout: 'grid', columns: 4 },
-            'card': { title: '', width: 300, height: 200, backgroundColor: '#ffffff', elevation: 2 },
-            'metric': { label: '', value: 0, unit: '', fontSize: 24, color: '#000000' },
-            'row': { height: 'auto', gap: 10, alignItems: 'center' },
-            'col': { width: 'auto', gap: 10, alignItems: 'stretch' },
-        };
-        return { ...defaults[elementType] };
-    }
-    getUIElements() {
-        return new Map(this.uiElements);
-    }
-    findElement(name) {
-        return this.uiElements.get(name) || null;
-    }
-    clear() {
-        this.uiElements.clear();
-    }
-}