@irrelon/battlescript 3.2.6 → 4.0.1

package/dist/services/moduleResolver.d.ts

@@ -0,0 +1,151 @@
+/**
+ * Module Resolver Service
+ *
+ * Handles ES module-style import/export resolution for BattleScript.
+ * Supports:
+ * - Named imports with aliasing: import {foo, bar as baz} from "./module"
+ * - Named exports: export {foo, bar} and export {foo as bar}
+ * - Inline exports: export int a = 1;
+ * - Re-exports: export {foo, bar} from "./other"
+ * - Circular dependency resolution via static hoisting
+ * - Module deduplication (diamond dependency pattern)
+ */
+import type { AstNode, RootNode } from "@/types";
+/** Information about an exported symbol */
+export interface ExportedSymbol {
+    /** Name used locally in the module */
+    localName: string;
+    /** Name exposed for import */
+    exportedName: string;
+    /** The AST node being exported */
+    node: AstNode;
+    /** File path of the module that defines this export */
+    moduleId: string;
+    /** Whether this is a re-export from another module */
+    isReExport: boolean;
+    /** For re-exports, the source module path */
+    reExportSource?: string;
+}
+/** Information about an imported symbol */
+export interface ImportedSymbol {
+    /** Name used in the importing module */
+    localName: string;
+    /** Name as exported from the source module */
+    importedName: string;
+    /** File path of the source module */
+    sourceModule: string;
+}
+/** Complete information about a parsed module */
+export interface ModuleInfo {
+    /** Unique identifier (absolute file path) */
+    id: string;
+    /** Parsed AST of the module */
+    ast: RootNode;
+    /** Map of exported symbol names to their info */
+    exports: Map<string, ExportedSymbol>;
+    /** Map of local imported names to their info */
+    imports: Map<string, ImportedSymbol>;
+    /** Set of module IDs this module depends on */
+    dependencies: Set<string>;
+    /** Whether this module has been fully processed */
+    processed: boolean;
+    /** Whether this module is currently being processed (for cycle detection) */
+    processing: boolean;
+}
+/** Options for the module resolver */
+export interface ModuleResolverOptions {
+    /** Entry module file path */
+    entryPath: string;
+    /** Function to resolve source code from a file path */
+    sourceResolver: (filePath: string) => string;
+    /** Function to parse source code into AST */
+    parseSource: (source: string, filePath: string) => RootNode;
+    /** Whether to include metadata */
+    includeMetaData?: boolean;
+}
+/** Result of module resolution */
+export interface ModuleResolutionResult {
+    /** Flattened body with all modules merged */
+    body: AstNode[];
+    /** Map of module IDs to their info */
+    modules: Map<string, ModuleInfo>;
+    /** Order in which modules should be processed (topological sort) */
+    moduleOrder: string[];
+}
+/**
+ * Module Resolver
+ *
+ * Resolves ES module imports/exports and produces a flattened AST
+ * with all dependencies merged in the correct order.
+ */
+export declare class ModuleResolver {
+    private modules;
+    private options;
+    private moduleOrder;
+    constructor(options: ModuleResolverOptions);
+    /**
+     * Resolve all modules starting from the entry point
+     */
+    resolve(): ModuleResolutionResult;
+    /**
+     * Build the module dependency graph by parsing all modules
+     */
+    private buildModuleGraph;
+    /**
+     * Extract export information from a module's AST
+     */
+    private extractExportsFromModule;
+    /**
+     * Extract import information from a module's AST
+     */
+    private extractImportsFromModule;
+    /**
+     * Resolve all re-exports to their actual source declarations
+     */
+    private resolveAllExports;
+    /**
+     * Resolve a re-export to its actual source declaration
+     */
+    private resolveReExport;
+    /**
+     * Topological sort of modules for correct ordering
+     */
+    private topologicalSort;
+    /**
+     * Flatten all modules into a single body array
+     */
+    private flattenModules;
+    /**
+     * Add module metadata to a node
+     */
+    private addModuleMetadata;
+    /**
+     * Check if a node is an exportable declaration type
+     */
+    private isExportableDeclaration;
+    /**
+     * Get the name of a declaration node
+     */
+    private getDeclarationName;
+    /**
+     * Find a local declaration by name in a module's AST
+     */
+    private findLocalDeclaration;
+    /**
+     * Resolve a relative import path to an absolute path
+     */
+    private resolveImportPath;
+    /**
+     * Validate that an imported symbol is actually exported
+     */
+    validateImport(importingModule: string, importedName: string, sourceModule: string): void;
+    /**
+     * Get the exported symbols from a module
+     */
+    getModuleExports(moduleId: string): Map<string, ExportedSymbol> | null;
+}
+/**
+ * Helper function to resolve modules for a given entry point
+ */
+export declare function resolveModules(options: ModuleResolverOptions): ModuleResolutionResult;
+//# sourceMappingURL=moduleResolver.d.ts.map

package/dist/services/moduleResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"moduleResolver.d.ts","sourceRoot":"","sources":["../../services/moduleResolver.ts"],"names":[],"mappings":"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"}

package/dist/services/treeShaker/DependencyAnalyzer.d.ts

@@ -0,0 +1,38 @@
+import type { AstNode } from "@/types";
+import type { DependencyGraph } from "./types";
+/**
+ * Analyzes AST to build a dependency graph of which nodes reference which symbols.
+ * Currently focused on function call dependencies.
+ */
+export declare class DependencyAnalyzer {
+    private graph;
+    /**
+     * Build the dependency graph for the given AST body
+     */
+    analyze(body: AstNode[], entryPoints: Set<AstNode>): DependencyGraph;
+    /**
+     * Index all function declarations by name
+     */
+    private indexDeclarations;
+    /**
+     * Analyze a node and its children for dependencies
+     */
+    private analyzeNode;
+    /**
+     * Walk a node recursively to find all dependencies
+     */
+    private walkNode;
+    /**
+     * Handle a function call expression
+     */
+    private handleCallExpression;
+    /**
+     * Get the function name from a call expression callee
+     */
+    private getFunctionName;
+    /**
+     * Walk all properties of a node that could contain AST nodes
+     */
+    private walkNodeProperties;
+}
+//# sourceMappingURL=DependencyAnalyzer.d.ts.map

package/dist/services/treeShaker/DependencyAnalyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DependencyAnalyzer.d.ts","sourceRoot":"","sources":["../../../services/treeShaker/DependencyAnalyzer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,OAAO,EAA4G,MAAM,SAAS,CAAC;AAChJ,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,SAAS,CAAC;AAE7C;;;GAGG;AACH,qBAAa,kBAAkB;IAC9B,OAAO,CAAC,KAAK,CAIX;IAEF;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,WAAW,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,eAAe;IAkBpE;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;OAEG;IACH,OAAO,CAAC,WAAW;IAanB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAoBhB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAkC5B;;OAEG;IACH,OAAO,CAAC,eAAe;IAqBvB;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAiB1B"}

package/dist/services/treeShaker/EntryPointCollector.d.ts

@@ -0,0 +1,17 @@
+import type { AstNode } from "@/types";
+/**
+ * Collects entry point nodes that must be retained during tree-shaking.
+ * Entry points are nodes that are executed or can be called at runtime.
+ */
+export declare class EntryPointCollector {
+    private entryPoints;
+    /**
+     * Collect all entry point nodes from the AST body
+     */
+    collect(body: AstNode[]): Set<AstNode>;
+    /**
+     * Determine if a node is an entry point that must be retained
+     */
+    private isEntryPoint;
+}
+//# sourceMappingURL=EntryPointCollector.d.ts.map

package/dist/services/treeShaker/EntryPointCollector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntryPointCollector.d.ts","sourceRoot":"","sources":["../../../services/treeShaker/EntryPointCollector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,SAAS,CAAC;AAErC;;;GAGG;AACH,qBAAa,mBAAmB;IAC/B,OAAO,CAAC,WAAW,CAA2B;IAE9C;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC;IAYtC;;OAEG;IACH,OAAO,CAAC,YAAY;CA6DpB"}

package/dist/services/treeShaker/TreeShaker.d.ts

@@ -0,0 +1,17 @@
+import type { AstNode } from "@/types";
+import type { TreeShakeOptions, TreeShakeResult } from "./types";
+/**
+ * Main tree-shaking implementation.
+ * Removes unused function declarations from the AST.
+ */
+export declare class TreeShaker {
+    private options;
+    private entryPointCollector;
+    private dependencyAnalyzer;
+    constructor(options?: TreeShakeOptions);
+    /**
+     * Perform tree-shaking on the given AST body
+     */
+    shake(body: AstNode[]): TreeShakeResult;
+}
+//# sourceMappingURL=TreeShaker.d.ts.map

package/dist/services/treeShaker/TreeShaker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TreeShaker.d.ts","sourceRoot":"","sources":["../../../services/treeShaker/TreeShaker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,OAAO,EAAkE,MAAM,SAAS,CAAC;AAGtG,OAAO,KAAK,EAAC,gBAAgB,EAAE,eAAe,EAAC,MAAM,SAAS,CAAC;AAE/D;;;GAGG;AACH,qBAAa,UAAU;IACtB,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,mBAAmB,CAAsB;IACjD,OAAO,CAAC,kBAAkB,CAAqB;gBAEnC,OAAO,GAAE,gBAAqB;IAS1C;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,eAAe;CA+DvC"}

package/dist/services/treeShaker/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./types";
+export * from "./TreeShaker";
+export * from "./EntryPointCollector";
+export * from "./DependencyAnalyzer";
+export * from "./treeShake";
+//# sourceMappingURL=index.d.ts.map

package/dist/services/treeShaker/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../services/treeShaker/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,aAAa,CAAC"}

package/dist/services/treeShaker/treeShake.d.ts

@@ -0,0 +1,12 @@
+import type { AstNode } from "@/types";
+import type { TreeShakeOptions } from "./types";
+/**
+ * Convenience function to tree-shake an AST body.
+ * Removes unused function declarations.
+ *
+ * @param body - The AST body nodes to tree-shake
+ * @param options - Tree-shaking options
+ * @returns The filtered body with unused functions removed
+ */
+export declare const treeShake: (body: AstNode[], options?: TreeShakeOptions) => AstNode[];
+//# sourceMappingURL=treeShake.d.ts.map

package/dist/services/treeShaker/treeShake.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"treeShake.d.ts","sourceRoot":"","sources":["../../../services/treeShaker/treeShake.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,SAAS,CAAC;AAErC,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,SAAS,CAAC;AAE9C;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,GAAI,MAAM,OAAO,EAAE,EAAE,UAAS,gBAAqB,KAAG,OAAO,EAIlF,CAAC"}

package/dist/services/treeShaker/types.d.ts

@@ -0,0 +1,50 @@
+import type { AstNode } from "@/types";
+/**
+ * Configuration options for tree-shaking
+ */
+export interface TreeShakeOptions {
+    /**
+     * If true, enables tree-shaking. Default: true
+     */
+    enabled?: boolean;
+    /**
+     * If true, provides verbose logging of tree-shaking decisions
+     */
+    verbose?: boolean;
+}
+/**
+ * Result of tree-shaking analysis
+ */
+export interface TreeShakeResult {
+    /**
+     * The filtered AST body with unused nodes removed
+     */
+    body: AstNode[];
+    /**
+     * Statistics about what was removed
+     */
+    stats: {
+        originalCount: number;
+        retainedCount: number;
+        removedCount: number;
+        removedNodes: string[];
+    };
+}
+/**
+ * Internal type for tracking dependencies
+ */
+export interface DependencyGraph {
+    /**
+     * Map of symbol name to the nodes that depend on it
+     */
+    dependencies: Map<string, Set<AstNode>>;
+    /**
+     * Set of all retained node references
+     */
+    retained: Set<AstNode>;
+    /**
+     * Map of symbol name to its declaration node
+     */
+    declarations: Map<string, AstNode>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/services/treeShaker/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../services/treeShaker/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,SAAS,CAAC;AAErC;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B;;OAEG;IACH,IAAI,EAAE,OAAO,EAAE,CAAC;IAEhB;;OAEG;IACH,KAAK,EAAE;QACN,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,EAAE,CAAC;KACvB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B;;OAEG;IACH,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IAExC;;OAEG;IACH,QAAQ,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IAEvB;;OAEG;IACH,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC"}

package/dist/tests/ast/export.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=export.test.d.ts.map

package/dist/tests/ast/export.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.test.d.ts","sourceRoot":"","sources":["../../../tests/ast/export.test.ts"],"names":[],"mappings":""}

package/dist/tests/ast/import.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=import.test.d.ts.map

package/dist/tests/ast/import.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import.test.d.ts","sourceRoot":"","sources":["../../../tests/ast/import.test.ts"],"names":[],"mappings":""}

package/dist/tests/ast/moduleResolver.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=moduleResolver.test.d.ts.map

package/dist/tests/ast/moduleResolver.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"moduleResolver.test.d.ts","sourceRoot":"","sources":["../../../tests/ast/moduleResolver.test.ts"],"names":[],"mappings":""}

package/dist/tests/ast/tree-shaking.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tree-shaking.test.d.ts.map

package/dist/tests/ast/tree-shaking.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-shaking.test.d.ts","sourceRoot":"","sources":["../../../tests/ast/tree-shaking.test.ts"],"names":[],"mappings":""}