@warlock.js/core 4.0.162 → 4.0.164

package/esm/dev-server/runtime-import-helper.js

@@ -0,0 +1,158 @@
+import {pathToFileURL}from'node:url';import {warlockCachePath}from'./utils.js';/**
+ * Runtime Import Helper
+ *
+ * This module provides a global __import function that handles cache busting
+ * for HMR. Instead of static imports, we transform them to use this helper
+ * which appends timestamps to force module reloads.
+ *
+ * Example transformation:
+ *   FROM: import { foo } from "./bar.js"
+ *   TO:   const { foo } = await __import("./bar.js")
+ */
+/**
+ * Module version registry
+ * Maps module paths to their current version timestamp
+ */
+const moduleVersions = new Map();
+/**
+ * Modules currently being loaded
+ * Used to detect and handle circular dependencies
+ */
+const loadingModules = new Set();
+/**
+ * Module import promise cache
+ * Maps module paths to their import promises
+ * Prevents duplicate imports and handles circular dependencies
+ */
+const modulePromises = new Map();
+function normalizePath(modulePath) {
+    return modulePath.startsWith("./") ? modulePath.slice(2) : modulePath;
+}
+/**
+ * Get last version of timestamp for a module
+ * if not found set it then return it
+ */
+function useModuleVersion(modulePath) {
+    const cleanPath = normalizePath(modulePath);
+    if (!moduleVersions.has(cleanPath)) {
+        moduleVersions.set(cleanPath, Date.now());
+    }
+    return moduleVersions.get(cleanPath);
+}
+/**
+ * Dynamic import with cache busting and circular dependency protection
+ *
+ * @param modulePath - The relative cache path (e.g., "./src-app-users-shared-utils.js")
+ * @returns The imported module
+ */
+async function __import(modulePath) {
+    const cleanPath = normalizePath(modulePath);
+    const { filesOrchestrator } = await import('./files-orchestrator.js');
+    // Check if this module is already being loaded (circular dependency detected)
+    if (loadingModules.has(cleanPath)) {
+        // Return the existing promise - this prevents deadlock
+        // The promise should already be cached since we cache it before marking as loading
+        const existingPromise = modulePromises.get(cleanPath);
+        if (existingPromise) {
+            return existingPromise;
+        }
+        // This should rarely happen, but handle the edge case where promise isn't cached yet
+        // This can occur in a race condition scenario
+        throw new Error(`Circular dependency detected: Module "${cleanPath}" is being loaded but no promise is cached. This may indicate a timing issue in module loading.`);
+    }
+    // Get the current version timestamp for this module
+    const timestamp = useModuleVersion(modulePath);
+    // Resolve the module path relative to the cache directory
+    const absolutePath = warlockCachePath(cleanPath);
+    // Convert to file:// URL for cross-platform compatibility
+    const fileUrl = pathToFileURL(absolutePath).href;
+    // Append timestamp as query parameter to bust cache
+    const moduleUrl = `${fileUrl}?t=${timestamp}`;
+    // Create the import promise and cache it BEFORE marking as loading
+    // This ensures circular dependencies can always find the promise
+    const importPromise = import(moduleUrl);
+    modulePromises.set(cleanPath, importPromise);
+    // Mark module as loading AFTER caching the promise
+    // This order is critical for circular dependency handling
+    loadingModules.add(cleanPath);
+    try {
+        // Wait for the import to complete
+        const module = await importPromise;
+        if (module) {
+            const fileManager = Array.from(filesOrchestrator.files.values()).find((fileManager) => {
+                return fileManager.cachePath === cleanPath;
+            });
+            if (fileManager) {
+                if (module.cleanup) {
+                    fileManager.addCleanup(module.cleanup);
+                }
+                else {
+                    // another workaround is to auto detect if any of the imports has a $cleanup methods
+                    // if yes, then execute them all
+                    const cleanups = [];
+                    for (const exportedValue of Object.values(module)) {
+                        const cleanup = exportedValue?.$cleanup;
+                        if (cleanup) {
+                            cleanups.push(cleanup.bind(exportedValue));
+                        }
+                    }
+                    if (cleanups.length > 0) {
+                        fileManager.addCleanup(cleanups);
+                    }
+                }
+            }
+        }
+        return module;
+    }
+    catch (error) {
+        console.log("Error while importing ", cleanPath, error);
+        // Remove from cache on error so it can be retried
+        modulePromises.delete(cleanPath);
+        throw error;
+    }
+    finally {
+        // Mark module as no longer loading
+        loadingModules.delete(cleanPath);
+    }
+}
+/**
+ * Clear version for a module (reset to default behavior)
+ *
+ * @param modulePath - The path to the module
+ */
+function __clearModuleVersion(modulePath) {
+    const cleanPath = normalizePath(modulePath);
+    moduleVersions.delete(cleanPath);
+    // Clear cached promise if not currently loading
+    if (!loadingModules.has(cleanPath)) {
+        modulePromises.delete(cleanPath);
+    }
+}
+/**
+ * Clear all module versions and caches
+ */
+function __clearAllModuleVersions() {
+    moduleVersions.clear();
+    // Clear all cached promises that aren't currently loading
+    for (const [path] of modulePromises) {
+        if (!loadingModules.has(path)) {
+            modulePromises.delete(path);
+        }
+    }
+}
+/**
+ * Get current version timestamp for a module
+ *
+ * @param modulePath - The path to the module
+ * @returns The timestamp or undefined if not set
+ */
+function __getModuleVersion(modulePath) {
+    return moduleVersions.get(modulePath);
+}
+// Export for initialization
+function initializeRuntimeImportHelper() {
+    global.__import = __import;
+    global.__clearModuleVersion = __clearModuleVersion;
+    global.__clearAllModuleVersions = __clearAllModuleVersions;
+    global.__getModuleVersion = __getModuleVersion;
+}export{initializeRuntimeImportHelper};//# sourceMappingURL=runtime-import-helper.js.map

package/esm/dev-server/runtime-import-helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-import-helper.js","sources":["../../src/dev-server/runtime-import-helper.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/esm/dev-server/special-files-collector.d.ts

@@ -0,0 +1,114 @@
+import { FileManager } from "./file-manager";
+/**
+ * Special File Types
+ */
+export type SpecialFileType = "config" | "main" | "route" | "event" | "locale";
+/**
+ * Special Files Collector
+ * Detects and categorizes special files in the project
+ * Provides query APIs for accessing special files by type
+ */
+export declare class SpecialFilesCollector {
+    /**
+     * Categorized special files
+     */
+    private readonly configFiles;
+    private readonly mainFiles;
+    private readonly routeFiles;
+    private readonly eventFiles;
+    private readonly localeFiles;
+    /**
+     * Collect special files from all tracked files
+     * @param files Map of all tracked files
+     */
+    collect(files: Map<string, FileManager>): void;
+    /**
+     * Categorize a single file
+     * @param relativePath Relative path of the file
+     * @param fileManager FileManager instance
+     */
+    private categorizeFile;
+    /**
+     * Check if file is a config file
+     * Pattern: src/config/$config.ts
+     */
+    private isConfigFile;
+    /**
+     * Check if file is a main file
+     * Pattern: src/app/$module/main.ts
+     */
+    private isMainFile;
+    /**
+     * Check if file is a route file
+     * Pattern: src/app/$module/routes.ts
+     */
+    private isRouteFile;
+    /**
+     * Check if file is an event file
+     * Pattern: src/app/$module/events/$event.ts
+     */
+    private isEventFile;
+    /**
+     * Check if file is a locale file
+     * Pattern: src/app/$module/utils/locales.ts
+     */
+    private isLocaleFile;
+    /**
+     * Add a new file to the appropriate collection
+     * @param fileManager FileManager instance
+     */
+    addFile(fileManager: FileManager): void;
+    /**
+     * Remove a file from all collections
+     * @param relativePath Relative path of the file
+     */
+    removeFile(relativePath: string): void;
+    /**
+     * Update a file in the collections
+     * @param fileManager FileManager instance
+     */
+    updateFile(fileManager: FileManager): void;
+    /**
+     * Get all config files
+     * @returns Array of FileManager instances
+     */
+    getConfigFiles(): FileManager[];
+    /**
+     * Get all main files
+     * Sort order does not matter here
+     * @TODO later we can allow export const priority from the main file itself
+     * @returns Array of FileManager instances
+     */
+    getMainFiles(): FileManager[];
+    /**
+     * Get all route files
+     * Sorted alphabetically by path
+     * @returns Array of FileManager instances
+     */
+    getRouteFiles(): FileManager[];
+    /**
+     * Get all event files
+     * @returns Array of FileManager instances
+     */
+    getEventFiles(): FileManager[];
+    /**
+     * Get all locale files
+     * @returns Array of FileManager instances
+     */
+    getLocaleFiles(): FileManager[];
+    /**
+     * Get statistics about collected special files
+     */
+    getStats(): Record<SpecialFileType, number>;
+    /**
+     * Check if a file is a special file
+     * @param relativePath Relative path of the file
+     * @returns Special file type or null
+     */
+    getFileType(relativePath: string): SpecialFileType | null;
+    /**
+     * Clear all collections
+     */
+    clear(): void;
+}
+//# sourceMappingURL=special-files-collector.d.ts.map

package/esm/dev-server/special-files-collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"special-files-collector.d.ts","sourceRoot":"","sources":["../../src/dev-server/special-files-collector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE/E;;;;GAIG;AACH,qBAAa,qBAAqB;IAChC;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAkC;IAC9D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkC;IAC5D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkC;IAC7D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkC;IAC7D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAkC;IAE9D;;;OAGG;IACI,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,IAAI;IAcrD;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAgCtB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAIpB;;;OAGG;IACH,OAAO,CAAC,UAAU;IAOlB;;;OAGG;IACH,OAAO,CAAC,WAAW;IAInB;;;OAGG;IACH,OAAO,CAAC,WAAW;IAInB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAIpB;;;OAGG;IACI,OAAO,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI;IAK9C;;;OAGG;IACI,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAQ7C;;;OAGG;IACI,UAAU,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI;IAUjD;;;OAGG;IACI,cAAc,IAAI,WAAW,EAAE;IAItC;;;;;OAKG;IACI,YAAY,IAAI,WAAW,EAAE;IAIpC;;;;OAIG;IACI,aAAa,IAAI,WAAW,EAAE;IAUrC;;;OAGG;IACI,aAAa,IAAI,WAAW,EAAE;IAIrC;;;OAGG;IACI,cAAc,IAAI,WAAW,EAAE;IAItC;;OAEG;IACI,QAAQ,IAAI,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC;IAUlD;;;;OAIG;IACI,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI;IAUhE;;OAEG;IACI,KAAK,IAAI,IAAI;CAOrB"}

package/esm/dev-server/special-files-collector.js

@@ -0,0 +1,212 @@
+/**
+ * Special Files Collector
+ * Detects and categorizes special files in the project
+ * Provides query APIs for accessing special files by type
+ */
+class SpecialFilesCollector {
+    /**
+     * Categorized special files
+     */
+    configFiles = new Map();
+    mainFiles = new Map();
+    routeFiles = new Map();
+    eventFiles = new Map();
+    localeFiles = new Map();
+    /**
+     * Collect special files from all tracked files
+     * @param files Map of all tracked files
+     */
+    collect(files) {
+        // Clear existing collections
+        this.configFiles.clear();
+        this.mainFiles.clear();
+        this.routeFiles.clear();
+        this.eventFiles.clear();
+        this.localeFiles.clear();
+        // Categorize each file
+        for (const [relativePath, fileManager] of files) {
+            this.categorizeFile(relativePath, fileManager);
+        }
+    }
+    /**
+     * Categorize a single file
+     * @param relativePath Relative path of the file
+     * @param fileManager FileManager instance
+     */
+    categorizeFile(relativePath, fileManager) {
+        // Config files: src/config/**/*.{ts,tsx}
+        if (this.isConfigFile(relativePath)) {
+            this.configFiles.set(relativePath, fileManager);
+            return;
+        }
+        // Main files: src/app/**/main.{ts,tsx}
+        if (this.isMainFile(relativePath)) {
+            this.mainFiles.set(relativePath, fileManager);
+            return;
+        }
+        // Route files: src/app/**/routes.{ts,tsx}
+        if (this.isRouteFile(relativePath)) {
+            this.routeFiles.set(relativePath, fileManager);
+            return;
+        }
+        // Event files: src/app/**/events/**/*.{ts,tsx}
+        if (this.isEventFile(relativePath)) {
+            this.eventFiles.set(relativePath, fileManager);
+            return;
+        }
+        // Locale files: src/app/**/utils/locales.{ts,tsx}
+        if (this.isLocaleFile(relativePath)) {
+            this.localeFiles.set(relativePath, fileManager);
+            return;
+        }
+    }
+    /**
+     * Check if file is a config file
+     * Pattern: src/config/$config.ts
+     */
+    isConfigFile(path) {
+        return /^src\/config\/.*\.(ts|tsx)$/.test(path);
+    }
+    /**
+     * Check if file is a main file
+     * Pattern: src/app/$module/main.ts
+     */
+    isMainFile(path) {
+        return (/^src\/app\/[^/]+\/main\.(ts|tsx)$/.test(path) ||
+            ["src/app/main.ts", "src/app/main.tsx"].includes(path));
+    }
+    /**
+     * Check if file is a route file
+     * Pattern: src/app/$module/routes.ts
+     */
+    isRouteFile(path) {
+        return /^src\/app\/[^/]+\/routes\.(ts|tsx)$/.test(path);
+    }
+    /**
+     * Check if file is an event file
+     * Pattern: src/app/$module/events/$event.ts
+     */
+    isEventFile(path) {
+        return /^src\/app\/[^/]+\/events\/[^/]+\.(ts|tsx)$/.test(path);
+    }
+    /**
+     * Check if file is a locale file
+     * Pattern: src/app/$module/utils/locales.ts
+     */
+    isLocaleFile(path) {
+        return /^src\/app\/[^/]+\/utils\/locales\.(ts|tsx)$/.test(path);
+    }
+    /**
+     * Add a new file to the appropriate collection
+     * @param fileManager FileManager instance
+     */
+    addFile(fileManager) {
+        const relativePath = fileManager.relativePath;
+        this.categorizeFile(relativePath, fileManager);
+    }
+    /**
+     * Remove a file from all collections
+     * @param relativePath Relative path of the file
+     */
+    removeFile(relativePath) {
+        this.configFiles.delete(relativePath);
+        this.mainFiles.delete(relativePath);
+        this.routeFiles.delete(relativePath);
+        this.eventFiles.delete(relativePath);
+        this.localeFiles.delete(relativePath);
+    }
+    /**
+     * Update a file in the collections
+     * @param fileManager FileManager instance
+     */
+    updateFile(fileManager) {
+        const relativePath = fileManager.relativePath;
+        // Remove from all collections first
+        this.removeFile(relativePath);
+        // Re-categorize
+        this.categorizeFile(relativePath, fileManager);
+    }
+    /**
+     * Get all config files
+     * @returns Array of FileManager instances
+     */
+    getConfigFiles() {
+        return Array.from(this.configFiles.values());
+    }
+    /**
+     * Get all main files
+     * Sort order does not matter here
+     * @TODO later we can allow export const priority from the main file itself
+     * @returns Array of FileManager instances
+     */
+    getMainFiles() {
+        return Array.from(this.mainFiles.values());
+    }
+    /**
+     * Get all route files
+     * Sorted alphabetically by path
+     * @returns Array of FileManager instances
+     */
+    getRouteFiles() {
+        const routeFiles = Array.from(this.routeFiles.values());
+        return routeFiles.sort((a, b) => {
+            const pathA = a.relativePath;
+            const pathB = b.relativePath;
+            return pathA.localeCompare(pathB);
+        });
+    }
+    /**
+     * Get all event files
+     * @returns Array of FileManager instances
+     */
+    getEventFiles() {
+        return Array.from(this.eventFiles.values());
+    }
+    /**
+     * Get all locale files
+     * @returns Array of FileManager instances
+     */
+    getLocaleFiles() {
+        return Array.from(this.localeFiles.values());
+    }
+    /**
+     * Get statistics about collected special files
+     */
+    getStats() {
+        return {
+            config: this.configFiles.size,
+            main: this.mainFiles.size,
+            route: this.routeFiles.size,
+            event: this.eventFiles.size,
+            locale: this.localeFiles.size,
+        };
+    }
+    /**
+     * Check if a file is a special file
+     * @param relativePath Relative path of the file
+     * @returns Special file type or null
+     */
+    getFileType(relativePath) {
+        if (this.configFiles.has(relativePath))
+            return "config";
+        if (this.mainFiles.has(relativePath))
+            return "main";
+        if (this.routeFiles.has(relativePath))
+            return "route";
+        if (this.eventFiles.has(relativePath))
+            return "event";
+        if (this.localeFiles.has(relativePath))
+            return "locale";
+        return null;
+    }
+    /**
+     * Clear all collections
+     */
+    clear() {
+        this.configFiles.clear();
+        this.mainFiles.clear();
+        this.routeFiles.clear();
+        this.eventFiles.clear();
+        this.localeFiles.clear();
+    }
+}export{SpecialFilesCollector};//# sourceMappingURL=special-files-collector.js.map

package/esm/dev-server/special-files-collector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"special-files-collector.js","sources":["../../src/dev-server/special-files-collector.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/esm/dev-server/start-development-server.d.ts

@@ -0,0 +1,7 @@
+import { DevelopmentServer } from "./development-server";
+/**
+ * Start the development server
+ * Main entry point for the dev server
+ */
+export declare function startDevelopmentServer(): Promise<DevelopmentServer>;
+//# sourceMappingURL=start-development-server.d.ts.map

package/esm/dev-server/start-development-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-development-server.d.ts","sourceRoot":"","sources":["../../src/dev-server/start-development-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD;;;GAGG;AACH,wBAAsB,sBAAsB,+BAoB3C"}

package/esm/dev-server/start-development-server.js

@@ -0,0 +1,21 @@
+import {DevelopmentServer}from'./development-server.js';/**
+ * Start the development server
+ * Main entry point for the dev server
+ */
+async function startDevelopmentServer() {
+    const devServer = new DevelopmentServer();
+    // Handle graceful shutdown
+    process.on("SIGINT", async () => {
+        console.log("\n\n📡 Received SIGINT signal");
+        await devServer.shutdown();
+        process.exit(0);
+    });
+    process.on("SIGTERM", async () => {
+        console.log("\n\n📡 Received SIGTERM signal");
+        await devServer.shutdown();
+        process.exit(0);
+    });
+    // Start the server
+    await devServer.start();
+    return devServer;
+}export{startDevelopmentServer};//# sourceMappingURL=start-development-server.js.map

package/esm/dev-server/start-development-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-development-server.js","sources":["../../src/dev-server/start-development-server.ts"],"sourcesContent":[null],"names":[],"mappings":"wDAEA;;;AAGG;AACI,eAAe,sBAAsB,GAAA;AAC1C,IAAA,MAAM,SAAS,GAAG,IAAI,iBAAiB,EAAE,CAAC;;AAG1C,IAAA,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAW;AAC9B,QAAA,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;AAC7C,QAAA,MAAM,SAAS,CAAC,QAAQ,EAAE,CAAC;AAC3B,QAAA,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,KAAC,CAAC,CAAC;AAEH,IAAA,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,YAAW;AAC/B,QAAA,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;AAC9C,QAAA,MAAM,SAAS,CAAC,QAAQ,EAAE,CAAC;AAC3B,QAAA,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,KAAC,CAAC,CAAC;;AAGH,IAAA,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC;AAExB,IAAA,OAAO,SAAS,CAAC;AACnB"}

package/esm/dev-server/transpile-file.d.ts

@@ -0,0 +1,11 @@
+import type { FileManager } from "./file-manager";
+/**
+ * Using esbuild to transpile the given code
+ * Uses external sourcemaps for better performance:
+ * - Inline sourcemaps double file size and require base64 parsing on every import
+ * - External sourcemaps keep files small and fast to parse
+ * - Sourcemap files are written separately and only loaded when debugging
+ */
+export declare function transpileFile(fileManager: FileManager): Promise<any>;
+export declare function transpile(sourceCode: string, filePath: string): Promise<any>;
+//# sourceMappingURL=transpile-file.d.ts.map

package/esm/dev-server/transpile-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transpile-file.d.ts","sourceRoot":"","sources":["../../src/dev-server/transpile-file.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAGlD;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,WAAW,EAAE,WAAW,gBAE3D;AASD,wBAAsB,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,gBAWnE"}

package/esm/dev-server/transpile-file.js

@@ -0,0 +1,30 @@
+import {transform}from'esbuild';import {tsconfigManager}from'./tsconfig-manager.js';/**
+ * Using esbuild to transpile the given code
+ * Uses external sourcemaps for better performance:
+ * - Inline sourcemaps double file size and require base64 parsing on every import
+ * - External sourcemaps keep files small and fast to parse
+ * - Sourcemap files are written separately and only loaded when debugging
+ */
+async function transpileFile(fileManager) {
+    return transpile(fileManager.source, fileManager.absolutePath);
+}
+function getFileLoader(filePath) {
+    if (filePath.endsWith(".css"))
+        return "css";
+    if (filePath.endsWith(".tsx"))
+        return "tsx";
+    if (filePath.endsWith(".ts"))
+        return "ts";
+    return "file";
+}
+async function transpile(sourceCode, filePath) {
+    const { code: transpiled } = await transform(sourceCode, {
+        loader: getFileLoader(filePath),
+        format: "esm",
+        sourcemap: "inline",
+        target: "es2022",
+        sourcefile: filePath,
+        tsconfigRaw: tsconfigManager.tsconfig,
+    });
+    return transpiled;
+}export{transpile,transpileFile};//# sourceMappingURL=transpile-file.js.map

package/esm/dev-server/transpile-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transpile-file.js","sources":["../../src/dev-server/transpile-file.ts"],"sourcesContent":[null],"names":[],"mappings":"oFAIA;;;;;;AAMG;AACI,eAAe,aAAa,CAAC,WAAwB,EAAA;IAC1D,OAAO,SAAS,CAAC,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,YAAY,CAAC,CAAC;AACjE,CAAC;AAED,SAAS,aAAa,CAAC,QAAgB,EAAA;AACrC,IAAA,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC;AAAE,QAAA,OAAO,KAAK,CAAC;AAC5C,IAAA,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC;AAAE,QAAA,OAAO,KAAK,CAAC;AAC5C,IAAA,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC;AAAE,QAAA,OAAO,IAAI,CAAC;AAC1C,IAAA,OAAO,MAAM,CAAC;AAChB,CAAC;AAEM,eAAe,SAAS,CAAC,UAAkB,EAAE,QAAgB,EAAA;IAClE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,MAAM,SAAS,CAAC,UAAU,EAAE;AACvD,QAAA,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC;AAC/B,QAAA,MAAM,EAAE,KAAK;AACb,QAAA,SAAS,EAAE,QAAQ;AACnB,QAAA,MAAM,EAAE,QAAQ;AAChB,QAAA,UAAU,EAAE,QAAQ;QACpB,WAAW,EAAE,eAAe,CAAC,QAAQ;AACtC,KAAA,CAAC,CAAC;AAEH,IAAA,OAAO,UAAU,CAAC;AACpB"}

package/esm/dev-server/tsconfig-manager.d.ts

@@ -0,0 +1,45 @@
+export declare class TSConfigManager {
+    /**
+     * Aliases list (from tsconfig paths)
+     */
+    aliases: Record<string, string[]>;
+    /**
+     * Base URL for resolving paths
+     */
+    baseUrl: string;
+    /**
+     * TSConfig
+     */
+    tsconfig: any;
+    init(): void;
+    /**
+     * Check if the given path is an alias
+     * This checks if it's a REAL path alias (not an external package alias)
+     *
+     * Real aliases map to local paths (e.g., app/* -> src/app/*, src/* -> src/*)
+     * External package aliases map to themselves with @ prefix (e.g., @warlock.js/core -> @warlock.js/core)
+     */
+    isAlias(path: string): boolean;
+    /**
+     * Get the alias key that matches the given import path
+     */
+    getMatchingAlias(path: string): string | null;
+    /**
+     * Resolve an alias import path to a relative path based on tsconfig paths
+     * Example: "app/users/services/get-users.service" -> "src/app/users/services/get-users.service"
+     *
+     * @param path - The import path with alias (e.g., "app/users/services/get-users.service")
+     * @returns The resolved relative path or null if alias not found
+     */
+    resolveAliasPath(checkingPath: string): string | null;
+    /**
+     * Resolve an alias import path to an absolute path
+     * Example: "app/users/services/get-users.service" -> "/absolute/path/to/src/app/users/services/get-users.service"
+     *
+     * @param path - The import path with alias
+     * @returns The resolved absolute path or null if alias not found
+     */
+    resolveAliasToAbsolute(path: string): string | null;
+}
+export declare const tsconfigManager: TSConfigManager;
+//# sourceMappingURL=tsconfig-manager.d.ts.map

package/esm/dev-server/tsconfig-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsconfig-manager.d.ts","sourceRoot":"","sources":["../../src/dev-server/tsconfig-manager.ts"],"names":[],"mappings":"AAIA,qBAAa,eAAe;IAC1B;;OAEG;IACI,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAM;IAE9C;;OAEG;IACI,OAAO,EAAE,MAAM,CAAO;IAE7B;;OAEG;IACI,QAAQ,EAAE,GAAG,CAAC;IAEd,IAAI;IAaX;;;;;;OAMG;IACI,OAAO,CAAC,IAAI,EAAE,MAAM;IAgC3B;;OAEG;IACI,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IASpD;;;;;;OAMG;IACI,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IA0B5D;;;;;;OAMG;IACI,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;CAO3D;AAED,eAAO,MAAM,eAAe,iBAAwB,CAAC"}