@warlock.js/core 3.0.40 → 4.0.2

package/cjs/dev2-server/path.d.ts

@@ -0,0 +1,39 @@
+export declare class Path {
+    /**
+     * Convert the given absolute path to a relative path
+     */
+    static toRelative(absolutePath: string): string;
+    /**
+     * Get relative path of the given path
+     */
+    static relative(relativePath: string): string;
+    /**
+     * Get normalized absolute path of the given path
+     */
+    static toNormalizedAbsolute(relativePath: string): string;
+    /**
+     * Get absolute path of the given path
+     */
+    static toAbsolute(relativePath: string): string;
+    /**
+     * Normalize the given path (convert backslashes to forward slashes)
+     */
+    static normalize(filePath: string): string;
+    /**
+     * Join paths and normalize
+     */
+    static join(...paths: string[]): string;
+    /**
+     * Get directory name of a path
+     */
+    static dirname(filePath: string): string;
+    /**
+     * Get base name of a path
+     */
+    static basename(filePath: string, ext?: string): string;
+    /**
+     * Get extension of a path
+     */
+    static extname(filePath: string): string;
+}
+//# sourceMappingURL=path.d.ts.map

package/cjs/dev2-server/path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../src/dev2-server/path.ts"],"names":[],"mappings":"AAEA,qBAAa,IAAI;IACf;;OAEG;WACW,UAAU,CAAC,YAAY,EAAE,MAAM;IAI7C;;OAEG;WACW,QAAQ,CAAC,YAAY,EAAE,MAAM;IAI3C;;OAEG;WACW,oBAAoB,CAAC,YAAY,EAAE,MAAM;IAIvD;;OAEG;WACW,UAAU,CAAC,YAAY,EAAE,MAAM;IAI7C;;OAEG;WACW,SAAS,CAAC,QAAQ,EAAE,MAAM;IAIxC;;OAEG;WACW,IAAI,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE;IAIrC;;OAEG;WACW,OAAO,CAAC,QAAQ,EAAE,MAAM;IAItC;;OAEG;WACW,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM;IAIrD;;OAEG;WACW,OAAO,CAAC,QAAQ,EAAE,MAAM;CAGvC"}

package/cjs/dev2-server/path.js

@@ -0,0 +1,56 @@
+'use strict';var path=require('node:path');function _interopDefault(e){return e&&e.__esModule?e:{default:e}}var path__default=/*#__PURE__*/_interopDefault(path);class Path {
+    /**
+     * Convert the given absolute path to a relative path
+     */
+    static toRelative(absolutePath) {
+        return this.normalize(path__default.default.relative(process.cwd(), absolutePath));
+    }
+    /**
+     * Get relative path of the given path
+     */
+    static relative(relativePath) {
+        return this.normalize(path__default.default.relative(process.cwd(), relativePath));
+    }
+    /**
+     * Get normalized absolute path of the given path
+     */
+    static toNormalizedAbsolute(relativePath) {
+        return this.normalize(path__default.default.resolve(process.cwd(), relativePath));
+    }
+    /**
+     * Get absolute path of the given path
+     */
+    static toAbsolute(relativePath) {
+        return this.normalize(path__default.default.resolve(process.cwd(), relativePath));
+    }
+    /**
+     * Normalize the given path (convert backslashes to forward slashes)
+     */
+    static normalize(filePath) {
+        return filePath.replace(/\\/g, "/");
+    }
+    /**
+     * Join paths and normalize
+     */
+    static join(...paths) {
+        return this.normalize(path__default.default.join(...paths));
+    }
+    /**
+     * Get directory name of a path
+     */
+    static dirname(filePath) {
+        return this.normalize(path__default.default.dirname(filePath));
+    }
+    /**
+     * Get base name of a path
+     */
+    static basename(filePath, ext) {
+        return path__default.default.basename(filePath, ext);
+    }
+    /**
+     * Get extension of a path
+     */
+    static extname(filePath) {
+        return path__default.default.extname(filePath);
+    }
+}exports.Path=Path;//# sourceMappingURL=path.js.map

package/cjs/dev2-server/path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.js","sources":["../../src/dev2-server/path.ts"],"sourcesContent":[null],"names":["path"],"mappings":"uKAEa,IAAI,CAAA;AACf;;AAEG;IACI,OAAO,UAAU,CAAC,YAAoB,EAAA;AAC3C,QAAA,OAAO,IAAI,CAAC,SAAS,CAACA,qBAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC;KACnE;AAED;;AAEG;IACI,OAAO,QAAQ,CAAC,YAAoB,EAAA;AACzC,QAAA,OAAO,IAAI,CAAC,SAAS,CAACA,qBAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC;KACnE;AAED;;AAEG;IACI,OAAO,oBAAoB,CAAC,YAAoB,EAAA;AACrD,QAAA,OAAO,IAAI,CAAC,SAAS,CAACA,qBAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC;KAClE;AAED;;AAEG;IACI,OAAO,UAAU,CAAC,YAAoB,EAAA;AAC3C,QAAA,OAAO,IAAI,CAAC,SAAS,CAACA,qBAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,YAAY,CAAC,CAAC,CAAC;KAClE;AAED;;AAEG;IACI,OAAO,SAAS,CAAC,QAAgB,EAAA;QACtC,OAAO,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;KACrC;AAED;;AAEG;AACI,IAAA,OAAO,IAAI,CAAC,GAAG,KAAe,EAAA;AACnC,QAAA,OAAO,IAAI,CAAC,SAAS,CAACA,qBAAI,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;KAC5C;AAED;;AAEG;IACI,OAAO,OAAO,CAAC,QAAgB,EAAA;QACpC,OAAO,IAAI,CAAC,SAAS,CAACA,qBAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;KAC/C;AAED;;AAEG;AACI,IAAA,OAAO,QAAQ,CAAC,QAAgB,EAAE,GAAY,EAAA;QACnD,OAAOA,qBAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;KACrC;AAED;;AAEG;IACI,OAAO,OAAO,CAAC,QAAgB,EAAA;AACpC,QAAA,OAAOA,qBAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;KAC/B;AACF"}

package/cjs/dev2-server/runtime-import-helper.d.ts

@@ -0,0 +1,9 @@
+declare global {
+    var __import: (modulePath: string) => Promise<any>;
+    var __updateModuleVersion: (modulePath: string, timestamp?: number) => void;
+    var __clearModuleVersion: (modulePath: string) => void;
+    var __clearAllModuleVersions: () => void;
+    var __getModuleVersion: (modulePath: string) => number | undefined;
+}
+export declare function initializeRuntimeImportHelper(): void;
+//# sourceMappingURL=runtime-import-helper.d.ts.map

package/cjs/dev2-server/runtime-import-helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-import-helper.d.ts","sourceRoot":"","sources":["../../src/dev2-server/runtime-import-helper.ts"],"names":[],"mappings":"AA4LA,OAAO,CAAC,MAAM,CAAC;IACb,IAAI,QAAQ,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;IACnD,IAAI,qBAAqB,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5E,IAAI,oBAAoB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IACvD,IAAI,wBAAwB,EAAE,MAAM,IAAI,CAAC;IACzC,IAAI,kBAAkB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CACpE;AAGD,wBAAgB,6BAA6B,IAAI,IAAI,CAMpD"}

package/cjs/dev2-server/runtime-import-helper.js

@@ -0,0 +1,157 @@
+'use strict';var node_url=require('node:url'),utils=require('./utils.js');function _interopNamespace(e){if(e&&e.__esModule)return e;var n=Object.create(null);if(e){Object.keys(e).forEach(function(k){if(k!=='default'){var d=Object.getOwnPropertyDescriptor(e,k);Object.defineProperty(n,k,d.get?d:{enumerable:true,get:function(){return e[k]}});}})}n.default=e;return Object.freeze(n)}/**
+ * 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();
+/**
+ * Get last version of timestamp for a module
+ * if not found set it then return it
+ */
+function useModuleVersion(modulePath) {
+    const cleanPath = modulePath.startsWith("./")
+        ? modulePath.slice(2)
+        : 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) {
+    // Normalize the module path (remove leading "./" if present)
+    const cleanPath = modulePath.startsWith("./")
+        ? modulePath.slice(2)
+        : modulePath;
+    // 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 = utils.warlockCachePath(cleanPath);
+    // Convert to file:// URL for cross-platform compatibility
+    const fileUrl = node_url.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 = (function(t){return Promise.resolve().then(function(){return /*#__PURE__*/_interopNamespace(require(t))})})(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;
+        return module;
+    }
+    catch (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);
+    }
+}
+/**
+ * Update the version timestamp for a module
+ * This forces the next import to load a fresh version
+ *
+ * @param modulePath - The path to the module
+ * @param timestamp - Optional timestamp (defaults to current time)
+ */
+function __updateModuleVersion(modulePath, timestamp) {
+    // Normalize the module path
+    const cleanPath = modulePath.startsWith("./")
+        ? modulePath.slice(2)
+        : modulePath;
+    // Update the version timestamp
+    moduleVersions.set(modulePath, timestamp || Date.now());
+    // Clear the cached promise so the new version gets loaded
+    // Only clear if the module is not currently loading (to avoid breaking circular deps)
+    if (!loadingModules.has(cleanPath)) {
+        modulePromises.delete(cleanPath);
+    }
+}
+/**
+ * Clear version for a module (reset to default behavior)
+ *
+ * @param modulePath - The path to the module
+ */
+function __clearModuleVersion(modulePath) {
+    const cleanPath = modulePath.startsWith("./")
+        ? modulePath.slice(2)
+        : modulePath;
+    moduleVersions.delete(modulePath);
+    // 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.__updateModuleVersion = __updateModuleVersion;
+    global.__clearModuleVersion = __clearModuleVersion;
+    global.__clearAllModuleVersions = __clearAllModuleVersions;
+    global.__getModuleVersion = __getModuleVersion;
+}exports.initializeRuntimeImportHelper=initializeRuntimeImportHelper;//# sourceMappingURL=runtime-import-helper.js.map

package/cjs/dev2-server/runtime-import-helper.js.map

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

package/cjs/dev2-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/cjs/dev2-server/special-files-collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"special-files-collector.d.ts","sourceRoot":"","sources":["../../src/dev2-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/cjs/dev2-server/special-files-collector.js

@@ -0,0 +1,212 @@
+'use strict';/**
+ * 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();
+    }
+}exports.SpecialFilesCollector=SpecialFilesCollector;//# sourceMappingURL=special-files-collector.js.map

package/cjs/dev2-server/special-files-collector.js.map

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

package/cjs/dev2-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/cjs/dev2-server/start-development-server.d.ts.map

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

package/cjs/dev2-server/start-development-server.js

@@ -0,0 +1,21 @@
+'use strict';var developmentServer=require('./development-server.js');/**
+ * Start the development server
+ * Main entry point for the dev server
+ */
+async function startDevelopmentServer() {
+    const devServer = new developmentServer.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;
+}exports.startDevelopmentServer=startDevelopmentServer;//# sourceMappingURL=start-development-server.js.map

package/cjs/dev2-server/start-development-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-development-server.js","sources":["../../src/dev2-server/start-development-server.ts"],"sourcesContent":[null],"names":["DevelopmentServer"],"mappings":"sEAEA;;;AAGG;AACI,eAAe,sBAAsB,GAAA;AAC1C,IAAA,MAAM,SAAS,GAAG,IAAIA,mCAAiB,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"}