@warlock.js/core 4.0.174 → 4.1.2

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

@@ -1,394 +0,0 @@
-import { type FileOperations } from "./file-operations";
-import type { FileManifest, FileState, FileType, LayerType } from "./types";
-/**
- * Options for the process() method
- */
-export interface ProcessOptions {
-    /**
-     * Force reprocessing even if file hasn't changed
-     * @default false
-     */
-    force?: boolean;
-    /**
-     * Whether to transform imports to cache paths
-     * Set to false during batch operations where imports are transformed later
-     * @default true
-     */
-    transformImports?: boolean;
-    /**
-     * Whether to save to cache after processing
-     * Set to false if you need to do additional transformations before saving
-     * @default true
-     */
-    saveToCache?: boolean;
-}
-export type CleanupFunction = () => void;
-/**
- * FileManager - Manages the lifecycle of a single source file
- *
- * ## Lifecycle States
- *
- * ```
- * idle → loading → parsed → transpiled → ready
- *   ↑                                      │
- *   └──────────── (file changed) ──────────┘
- * ```
- *
- * ## Processing Pipeline
- *
- * All file processing flows through a unified pipeline:
- * 1. **Load** - Read source from disk
- * 2. **Hash** - Calculate content hash for change detection
- * 3. **Parse** - Discover imports and dependencies
- * 4. **Transpile** - Convert TypeScript to JavaScript
- * 5. **Transform** - Rewrite import paths to cache locations
- * 6. **Save** - Write transformed code to cache (ONCE)
- *
- * ## Usage Examples
- *
- * ```typescript
- * // Standard processing (full pipeline)
- * const file = new FileManager(absolutePath, filesMap, fileOps);
- * await file.process();
- *
- * // Batch processing (parse first, complete later)
- * await file.parse();
- * // ... after dependencies are ready ...
- * await file.complete();
- *
- * // Check for changes and reprocess if needed
- * const changed = await file.process(); // returns false if unchanged
- *
- * // Force reprocessing
- * await file.process({ force: true });
- * ```
- *
- * @class FileManager
- */
-export declare class FileManager {
-    readonly absolutePath: string;
-    files: Map<string, FileManager>;
-    fileOperations: FileOperations;
-    /**
-     * Relative path from the project root directory
-     * Used as the primary identifier for files throughout the system
-     * @example "src/app/users/controllers/get-user.controller.ts"
-     */
-    relativePath: string;
-    /**
-     * Unix timestamp of the last modification time
-     * Used with hash for change detection
-     */
-    lastModified: number;
-    /**
-     * SHA-256 hash of the source content
-     * Primary mechanism for detecting file changes
-     */
-    hash: string;
-    /**
-     * Original TypeScript/JavaScript source code
-     * Loaded from disk during processing
-     */
-    source: string;
-    /**
-     * Transpiled JavaScript code with transformed imports
-     * This is the final output that gets saved to cache and loaded at runtime
-     */
-    transpiled: string;
-    /**
-     * Set of relative paths that this file depends on (imports)
-     * Used to build the dependency graph for HMR invalidation
-     * @example Set(["src/app/users/models/user.model.ts", "src/config/database.ts"])
-     */
-    dependencies: Set<string>;
-    /**
-     * Map of original import specifiers to resolved absolute paths
-     * Key: the exact import string from source (e.g., "./user.model")
-     * Value: resolved absolute path (e.g., "D:/project/src/app/users/models/user.model.ts")
-     *
-     * Used during import transformation to rewrite paths to cache locations
-     */
-    importMap: Map<string, string>;
-    /**
-     * Set of relative paths that depend on this file
-     * Populated from the dependency graph after initial processing
-     * Used to determine what needs reloading when this file changes
-     */
-    dependents: Set<string>;
-    /**
-     * Version number incremented on each change
-     * Used for cache busting in dynamic imports
-     */
-    version: number;
-    /**
-     * Semantic type of the file based on its path/content
-     * Used to determine reload behavior and special handling
-     */
-    type: FileType | undefined;
-    /**
-     * Reload layer: HMR (hot module replacement) or FSR (full server restart)
-     * Determines how changes to this file are applied at runtime
-     */
-    layer: LayerType | undefined;
-    /**
-     * Path to the cached transpiled file (relative to .warlock/cache/)
-     * @example "src-app-users-controllers-get-user.controller.js"
-     */
-    cachePath: string;
-    /**
-     * Cleanup function called before the file is unloaded
-     * Set by module loader for files that export cleanup handlers
-     */
-    cleanup: CleanupFunction[];
-    /**
-     * Whether imports have been transformed to cache paths
-     * Prevents double transformation and tracks processing state
-     */
-    importsTransformed: boolean;
-    /**
-     * Whether this file contains only type definitions (no runtime code)
-     * Type-only files are excluded from circular dependency detection
-     */
-    isTypeOnlyFile: boolean;
-    /**
-     * Current processing state of the file
-     *
-     * - `idle`: Initial state, no processing started
-     * - `loading`: Reading source from disk
-     * - `parsed`: Source loaded and imports discovered
-     * - `transpiled`: TypeScript compiled to JavaScript
-     * - `ready`: Fully processed and available for use
-     * - `updating`: Being reprocessed after a change
-     * - `deleted`: File has been removed from disk
-     */
-    state: FileState;
-    /**
-     * Creates a new FileManager instance
-     *
-     * @param absolutePath - Full filesystem path to the source file
-     * @param files - Map of all tracked files (for import resolution)
-     * @param fileOperations - FileOperations instance (for adding missing dependencies)
-     *
-     * @example
-     * ```typescript
-     * const fileManager = new FileManager(
-     *   "D:/project/src/app/users/controllers/get-user.controller.ts",
-     *   filesMap,
-     *   fileOperations
-     * );
-     * ```
-     */
-    constructor(absolutePath: string, files: Map<string, FileManager>, fileOperations: FileOperations);
-    /**
-     * set the given cleanup method(s)
-     */
-    addCleanup(cleanup: CleanupFunction | CleanupFunction[]): void;
-    /**
-     * reset the cleanup methods
-     */
-    resetCleanup(): void;
-    /**
-     * Initialize the file manager from disk or manifest cache
-     *
-     * This is the primary entry point for file initialization.
-     * If manifest data is provided, it will attempt to use cached data
-     * and only reprocess if the file has changed.
-     *
-     * @param fileManifest - Optional cached manifest data from previous build
-     *
-     * @example
-     * ```typescript
-     * // Fresh initialization (no cache)
-     * await fileManager.init();
-     *
-     * // Initialize with cached manifest data
-     * await fileManager.init(manifestEntry);
-     * ```
-     */
-    init(fileManifest?: Partial<FileManifest>): Promise<void>;
-    /**
-     * Get the cache path as a file:// URL for dynamic import
-     * Includes cache busting query parameter based on version
-     *
-     * @returns File URL ready for dynamic import, or empty string if no cache
-     *
-     * @example
-     * ```typescript
-     * const module = await import(fileManager.cachePathUrl);
-     * ```
-     */
-    get cachePathUrl(): string;
-    /**
-     * Process the file through the unified pipeline
-     *
-     * This is the core method that handles all file processing.
-     * It implements a single-pass pipeline that:
-     * 1. Loads source from disk
-     * 2. Checks if content changed (skip if unchanged)
-     * 3. Parses imports to discover dependencies
-     * 4. Ensures all dependencies exist
-     * 5. Transpiles TypeScript to JavaScript
-     * 6. Transforms imports to cache paths
-     * 7. Saves to cache (ONCE - no duplicate writes)
-     *
-     * @param options - Processing options
-     * @param options.force - Force reprocessing even if unchanged
-     * @param options.transformImports - Whether to transform import paths (default: true)
-     * @param options.saveToCache - Whether to save to cache file (default: true)
-     *
-     * @returns True if file was processed, false if unchanged and skipped
-     *
-     * @example
-     * ```typescript
-     * // Normal processing
-     * const changed = await fileManager.process();
-     *
-     * // Force reprocess
-     * await fileManager.process({ force: true });
-     *
-     * // Batch mode: transform imports later
-     * await fileManager.process({ transformImports: false });
-     * ```
-     */
-    process(options?: ProcessOptions): Promise<boolean>;
-    /**
-     * Parse the file to discover dependencies (Phase 1 of batch processing)
-     *
-     * This method only performs the first half of processing:
-     * - Loads source from disk
-     * - Calculates hash
-     * - Parses imports to discover dependencies
-     * - Sets up file metadata
-     *
-     * Use this for batch file operations where you need to know
-     * dependencies before deciding processing order.
-     *
-     * **Important**: After calling parse(), you must call complete()
-     * to finish processing and make the file usable.
-     *
-     * @example
-     * ```typescript
-     * // Batch processing pattern
-     * const files = await Promise.all(
-     *   paths.map(async (path) => {
-     *     const file = new FileManager(path, filesMap, fileOps);
-     *     await file.parse();
-     *     return file;
-     *   })
-     * );
-     *
-     * // Order by dependencies, then complete
-     * for (const file of orderedFiles) {
-     *   await file.complete();
-     * }
-     * ```
-     */
-    parse(): Promise<void>;
-    /**
-     * Complete file processing after parse() (Phase 2 of batch processing)
-     *
-     * This method completes the processing pipeline:
-     * - Ensures dependencies exist
-     * - Transpiles TypeScript to JavaScript
-     * - Transforms imports to cache paths
-     * - Saves to cache
-     *
-     * **Important**: This must be called after parse() to finish processing.
-     * The file is not usable until complete() has been called.
-     *
-     * @example
-     * ```typescript
-     * await file.parse();
-     * // ... after dependencies are ready ...
-     * await file.complete();
-     * // File is now ready for use
-     * ```
-     */
-    complete(): Promise<void>;
-    /**
-     * Update the file after a change during development
-     *
-     * This is a convenience method that delegates to process().
-     * It checks if the file has actually changed and only reprocesses if needed.
-     *
-     * @returns True if file was reprocessed, false if unchanged
-     *
-     * @example
-     * ```typescript
-     * // Called by file watcher
-     * const changed = await fileManager.update();
-     * if (changed) {
-     *   console.log("File was updated");
-     * }
-     * ```
-     */
-    update(): Promise<boolean>;
-    /**
-     * Force reprocess the file regardless of hash match
-     *
-     * Use this when:
-     * - A dependency that was previously missing is now available
-     * - Import transformation needs to be redone
-     * - Cache is corrupted or missing
-     *
-     * @example
-     * ```typescript
-     * // After a missing dependency is added
-     * await fileManager.forceReprocess();
-     * ```
-     */
-    forceReprocess(): Promise<void>;
-    /**
-     * Initialize from cached manifest data
-     *
-     * Attempts to use cached data from a previous build.
-     * If the file has changed (hash mismatch) or cache is missing,
-     * falls back to full processing.
-     *
-     * @param fileManifest - Cached manifest entry
-     * @internal
-     */
-    protected initFromManifest(fileManifest: Partial<FileManifest>): Promise<void>;
-    /**
-     * Detect the file type and reload layer based on path patterns
-     *
-     * File types determine special handling:
-     * - `main`: Application entry point
-     * - `config`: Configuration files
-     * - `route`: Route definitions
-     * - `controller`: HTTP controllers
-     * - `service`: Business logic services
-     * - `model`: Database models
-     * - `event`: Event handlers
-     * - `other`: Everything else
-     *
-     * Layers determine reload behavior:
-     * - `HMR`: Hot module replacement (instant reload)
-     * - `FSR`: Full server restart (required for some changes)
-     *
-     * @internal
-     */
-    protected detectFileTypeAndLayer(): void;
-    /**
-     * Export file data as a manifest entry for caching
-     *
-     * The manifest stores metadata about each file to enable:
-     * - Fast startup by skipping unchanged files
-     * - Dependency tracking across restarts
-     * - Cache validation via hash comparison
-     *
-     * Note: Source code and transpiled output are NOT stored in manifest.
-     * - Source is always read from disk
-     * - Transpiled code is stored in .warlock/cache/
-     *
-     * @returns Manifest entry for this file
-     *
-     * @example
-     * ```typescript
-     * const entry = fileManager.toManifest();
-     * manifest.setFile(fileManager.relativePath, entry);
-     * ```
-     */
-    toManifest(): FileManifest;
-}
-//# sourceMappingURL=file-manager.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"file-manager.d.ts","sourceRoot":"","sources":["../../src/dev-server/file-manager.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAKxD,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAG5E;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC;AAEzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,qBAAa,WAAW;aA+HJ,YAAY,EAAE,MAAM;IAC7B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC;IAC/B,cAAc,EAAE,cAAc;IAhIvC;;;;OAIG;IACI,YAAY,SAAM;IAEzB;;;OAGG;IACI,YAAY,SAAK;IAExB;;;OAGG;IACI,IAAI,SAAM;IAEjB;;;OAGG;IACI,MAAM,SAAM;IAEnB;;;OAGG;IACI,UAAU,SAAM;IAEvB;;;;OAIG;IACI,YAAY,cAAqB;IAExC;;;;;;OAMG;IACI,SAAS,sBAA6B;IAE7C;;;;OAIG;IACI,UAAU,cAAqB;IAEtC;;;OAGG;IACI,OAAO,SAAK;IAEnB;;;OAGG;IACI,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;IAElC;;;OAGG;IACI,KAAK,EAAE,SAAS,GAAG,SAAS,CAAC;IAEpC;;;OAGG;IACI,SAAS,SAAM;IAEtB;;;OAGG;IACI,OAAO,EAAE,eAAe,EAAE,CAAM;IAEvC;;;OAGG;IACI,kBAAkB,UAAS;IAElC;;;OAGG;IACI,cAAc,UAAS;IAE9B;;;;;;;;;;OAUG;IACI,KAAK,EAAE,SAAS,CAAU;IAEjC;;;;;;;;;;;;;;;OAeG;gBAEe,YAAY,EAAE,MAAM,EAC7B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,EAC/B,cAAc,EAAE,cAAc;IAGvC;;OAEG;IACI,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,eAAe,EAAE;IAW9D;;OAEG;IACI,YAAY;IAInB;;;;;;;;;;;;;;;;;OAiBG;IACU,IAAI,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IActE;;;;;;;;;;OAUG;IACH,IAAW,YAAY,IAAI,MAAM,CAGhC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACU,OAAO,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;IA6EpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA4BnC;;;;;;;;;;;;;;;;;;;OAmBG;IACU,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IA4BtC;;;;;;;;;;;;;;;;OAgBG;IACU,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAIvC;;;;;;;;;;;;;OAaG;IACU,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5C;;;;;;;;;OASG;cACa,gBAAgB,CAAC,YAAY,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IA6CpF;;;;;;;;;;;;;;;;;;OAkBG;IACH,SAAS,CAAC,sBAAsB,IAAI,IAAI;IAuDxC;;;;;;;;;;;;;;;;;;;OAmBG;IACI,UAAU,IAAI,YAAY;CAclC"}