@holoscript/core 2.0.0 → 2.0.2

package/dist/debugger.d.cts

@@ -0,0 +1,171 @@
+import { HoloScriptRuntime } from './runtime.cjs';
+import { A as ASTNode } from './types-D6g4ACjP.cjs';
+
+/**
+ * HoloScript Debugger
+ *
+ * Step-through debugging with breakpoints, call stack inspection,
+ * and variable watch capabilities.
+ */
+
+interface Breakpoint {
+    id: string;
+    line: number;
+    column?: number;
+    condition?: string;
+    hitCount: number;
+    enabled: boolean;
+    file?: string;
+}
+interface StackFrame {
+    id: number;
+    name: string;
+    file?: string;
+    line: number;
+    column: number;
+    variables: Map<string, unknown>;
+    node: ASTNode;
+}
+interface DebugState {
+    status: 'running' | 'paused' | 'stopped' | 'stepping';
+    currentLine: number;
+    currentColumn: number;
+    currentNode: ASTNode | null;
+    callStack: StackFrame[];
+    breakpoints: Breakpoint[];
+}
+type StepMode = 'into' | 'over' | 'out';
+interface DebugEvent {
+    type: 'breakpoint-hit' | 'step-complete' | 'exception' | 'output' | 'state-change';
+    data: unknown;
+}
+type DebugEventHandler = (event: DebugEvent) => void;
+/**
+ * HoloScript Debugger with breakpoints and step-through execution
+ */
+declare class HoloScriptDebugger {
+    private runtime;
+    private parser;
+    private breakpoints;
+    private callStack;
+    private currentAST;
+    private currentNodeIndex;
+    private frameIdCounter;
+    private breakpointIdCounter;
+    private eventHandlers;
+    private state;
+    constructor(runtime?: HoloScriptRuntime);
+    /**
+     * Load source code for debugging
+     */
+    loadSource(code: string, file?: string): {
+        success: boolean;
+        errors?: string[];
+    };
+    /**
+     * Set a breakpoint at a line
+     */
+    setBreakpoint(line: number, options?: Partial<Breakpoint>): Breakpoint;
+    /**
+     * Remove a breakpoint by ID
+     */
+    removeBreakpoint(id: string): boolean;
+    /**
+     * Remove all breakpoints at a line
+     */
+    removeBreakpointsAtLine(line: number): number;
+    /**
+     * Toggle breakpoint enabled state
+     */
+    toggleBreakpoint(id: string): boolean;
+    /**
+     * Get all breakpoints
+     */
+    getBreakpoints(): Breakpoint[];
+    /**
+     * Clear all breakpoints
+     */
+    clearBreakpoints(): void;
+    /**
+     * Start debugging from the beginning
+     */
+    start(): Promise<void>;
+    /**
+     * Continue execution until next breakpoint or end
+     */
+    continue(): Promise<void>;
+    /**
+     * Step into the next node
+     */
+    stepInto(): Promise<void>;
+    /**
+     * Step over the current node
+     */
+    stepOver(): Promise<void>;
+    /**
+     * Step out of the current function
+     */
+    stepOut(): Promise<void>;
+    /**
+     * Stop debugging
+     */
+    stop(): void;
+    /**
+     * Pause execution
+     */
+    pause(): void;
+    /**
+     * Get current debug state
+     */
+    getState(): DebugState;
+    /**
+     * Get call stack
+     */
+    getCallStack(): StackFrame[];
+    /**
+     * Get variables at a specific stack frame
+     */
+    getVariables(frameId?: number): Map<string, unknown>;
+    /**
+     * Evaluate an expression in the current context
+     */
+    evaluate(expression: string): Promise<{
+        value: unknown;
+        error?: string;
+    }>;
+    /**
+     * Set a watch expression
+     */
+    watch(expression: string): {
+        id: string;
+        expression: string;
+    };
+    /**
+     * Register an event handler
+     */
+    on(event: string, handler: DebugEventHandler): void;
+    /**
+     * Remove an event handler
+     */
+    off(event: string, handler: DebugEventHandler): void;
+    /**
+     * Get the underlying runtime
+     */
+    getRuntime(): HoloScriptRuntime;
+    private runUntilBreakpoint;
+    private executeStep;
+    private executeNode;
+    private shouldBreakAt;
+    private findBreakpointAtLine;
+    private pushStackFrame;
+    private popStackFrame;
+    private updateCurrentState;
+    private updateBreakpointList;
+    private emitEvent;
+}
+/**
+ * Create a debugger instance
+ */
+declare function createDebugger(runtime?: HoloScriptRuntime): HoloScriptDebugger;
+
+export { type Breakpoint, type DebugEvent, type DebugState, HoloScriptDebugger, type StackFrame, type StepMode, createDebugger };

package/dist/debugger.d.ts

@@ -0,0 +1,171 @@
+import { HoloScriptRuntime } from './runtime.js';
+import { A as ASTNode } from './types-D6g4ACjP.js';
+
+/**
+ * HoloScript Debugger
+ *
+ * Step-through debugging with breakpoints, call stack inspection,
+ * and variable watch capabilities.
+ */
+
+interface Breakpoint {
+    id: string;
+    line: number;
+    column?: number;
+    condition?: string;
+    hitCount: number;
+    enabled: boolean;
+    file?: string;
+}
+interface StackFrame {
+    id: number;
+    name: string;
+    file?: string;
+    line: number;
+    column: number;
+    variables: Map<string, unknown>;
+    node: ASTNode;
+}
+interface DebugState {
+    status: 'running' | 'paused' | 'stopped' | 'stepping';
+    currentLine: number;
+    currentColumn: number;
+    currentNode: ASTNode | null;
+    callStack: StackFrame[];
+    breakpoints: Breakpoint[];
+}
+type StepMode = 'into' | 'over' | 'out';
+interface DebugEvent {
+    type: 'breakpoint-hit' | 'step-complete' | 'exception' | 'output' | 'state-change';
+    data: unknown;
+}
+type DebugEventHandler = (event: DebugEvent) => void;
+/**
+ * HoloScript Debugger with breakpoints and step-through execution
+ */
+declare class HoloScriptDebugger {
+    private runtime;
+    private parser;
+    private breakpoints;
+    private callStack;
+    private currentAST;
+    private currentNodeIndex;
+    private frameIdCounter;
+    private breakpointIdCounter;
+    private eventHandlers;
+    private state;
+    constructor(runtime?: HoloScriptRuntime);
+    /**
+     * Load source code for debugging
+     */
+    loadSource(code: string, file?: string): {
+        success: boolean;
+        errors?: string[];
+    };
+    /**
+     * Set a breakpoint at a line
+     */
+    setBreakpoint(line: number, options?: Partial<Breakpoint>): Breakpoint;
+    /**
+     * Remove a breakpoint by ID
+     */
+    removeBreakpoint(id: string): boolean;
+    /**
+     * Remove all breakpoints at a line
+     */
+    removeBreakpointsAtLine(line: number): number;
+    /**
+     * Toggle breakpoint enabled state
+     */
+    toggleBreakpoint(id: string): boolean;
+    /**
+     * Get all breakpoints
+     */
+    getBreakpoints(): Breakpoint[];
+    /**
+     * Clear all breakpoints
+     */
+    clearBreakpoints(): void;
+    /**
+     * Start debugging from the beginning
+     */
+    start(): Promise<void>;
+    /**
+     * Continue execution until next breakpoint or end
+     */
+    continue(): Promise<void>;
+    /**
+     * Step into the next node
+     */
+    stepInto(): Promise<void>;
+    /**
+     * Step over the current node
+     */
+    stepOver(): Promise<void>;
+    /**
+     * Step out of the current function
+     */
+    stepOut(): Promise<void>;
+    /**
+     * Stop debugging
+     */
+    stop(): void;
+    /**
+     * Pause execution
+     */
+    pause(): void;
+    /**
+     * Get current debug state
+     */
+    getState(): DebugState;
+    /**
+     * Get call stack
+     */
+    getCallStack(): StackFrame[];
+    /**
+     * Get variables at a specific stack frame
+     */
+    getVariables(frameId?: number): Map<string, unknown>;
+    /**
+     * Evaluate an expression in the current context
+     */
+    evaluate(expression: string): Promise<{
+        value: unknown;
+        error?: string;
+    }>;
+    /**
+     * Set a watch expression
+     */
+    watch(expression: string): {
+        id: string;
+        expression: string;
+    };
+    /**
+     * Register an event handler
+     */
+    on(event: string, handler: DebugEventHandler): void;
+    /**
+     * Remove an event handler
+     */
+    off(event: string, handler: DebugEventHandler): void;
+    /**
+     * Get the underlying runtime
+     */
+    getRuntime(): HoloScriptRuntime;
+    private runUntilBreakpoint;
+    private executeStep;
+    private executeNode;
+    private shouldBreakAt;
+    private findBreakpointAtLine;
+    private pushStackFrame;
+    private popStackFrame;
+    private updateCurrentState;
+    private updateBreakpointList;
+    private emitEvent;
+}
+/**
+ * Create a debugger instance
+ */
+declare function createDebugger(runtime?: HoloScriptRuntime): HoloScriptDebugger;
+
+export { type Breakpoint, type DebugEvent, type DebugState, HoloScriptDebugger, type StackFrame, type StepMode, createDebugger };

package/dist/debugger.js

@@ -0,0 +1,7 @@
+export { HoloScriptDebugger, createDebugger } from './chunk-VYIDLUCV.js';
+import './chunk-MCP6D4LT.js';
+import './chunk-EU6CZMGJ.js';
+import './chunk-SATNCODL.js';
+import './chunk-4CV4JOE5.js';
+//# sourceMappingURL=debugger.js.map
+//# sourceMappingURL=debugger.js.map

package/dist/debugger.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"debugger.js"}