style: reformat source code

Author: thetutlage

src/debug.ts

@@ -12,9 +12,9 @@ import { debuglog } from 'node:util'
 /**
  * Debug logger instance configured for AdonisJS application debugging.
  * Uses Node.js built-in debuglog with the 'adonisjs:app' namespace.
- * 
+ *
  * Enable debug output by setting NODE_DEBUG=adonisjs:app environment variable.
- * 
+ *
  * @example
  * debug('Application state changed to: %s', newState)
  */

src/directories.ts

@@ -13,9 +13,9 @@ import type { DirectoriesNode } from './types.ts'
  * Default directory structure for AdonisJS applications.
  * These paths are relative to the application root and define
  * the conventional locations for different types of files.
- * 
+ *
  * Applications can override these defaults in their adonisrc.js file.
- * 
+ *
  * @example
  * // In adonisrc.js
  * export default defineConfig({

src/feature_flags.ts

@@ -10,27 +10,27 @@
 /**
  * A light weight implementation of feature flags to conditionally enable
  * experimental and legacy features.
- * 
+ *
  * @template FlagsList - Type definition for the feature flags object
- * 
+ *
  * @example
  * const flags = new FeatureFlags({ newUI: true, betaFeature: false })
  * if (flags.enabled('newUI')) {
  *   // Enable new UI
  * }
- * 
+ *
  * @example
  * const dynamicFlags = new FeatureFlags(() => getConfigFlags())
- * flags.when('betaFeature', 
- *   () => console.log('Beta enabled'), 
+ * flags.when('betaFeature',
+ *   () => console.log('Beta enabled'),
  *   () => console.log('Beta disabled')
  * )
  */
 export class FeatureFlags<FlagsList extends Record<any, any>> {
   /**
    * Static flags object containing feature flag values.
    * Used when flags are provided as a static object during construction.
-   * 
+   *
    * @private
    * @type {FlagsList | undefined}
    */
@@ -39,7 +39,7 @@ export class FeatureFlags<FlagsList extends Record<any, any>> {
   /**
    * Factory function to generate flags dynamically.
    * Used when flags need to be computed at runtime.
-   * 
+   *
    * @private
    * @type {(() => FlagsList) | undefined}
    */

src/managers/config.ts

@@ -14,15 +14,15 @@ import debug from '../debug.ts'
  * ConfigManager handles loading, parsing, and managing application configuration.
  * It can load configuration from file system directories or use explicitly
  * provided configuration objects (useful for testing).
- * 
+ *
  * The manager creates a Config instance that provides type-safe access to
  * configuration values throughout the application.
- * 
+ *
  * @example
  * const manager = new ConfigManager(new URL('file:///app/'))
  * await manager.process('config')
  * const dbConfig = manager.config.get('database')
- * 
+ *
  * @example
  * // Using explicit config for testing
  * const manager = new ConfigManager(appRoot)
@@ -32,7 +32,7 @@ import debug from '../debug.ts'
 export class ConfigManager {
   /**
    * The application root directory URL used to resolve the config directory path.
-   * 
+   *
    * @private
    * @type {URL}
    */
@@ -41,7 +41,7 @@ export class ConfigManager {
   /**
    * Configuration values set explicitly via useConfig() method.
    * When provided, prevents loading config files from the file system.
-   * 
+   *
    * @private
    * @type {Record<any, any> | undefined}
    */
@@ -50,7 +50,7 @@ export class ConfigManager {
   /**
    * Reference to the Config instance that provides access to
    * all configuration values. Available after process() method has been called.
-   * 
+   *
    * @type {Config}
    */
   config!: Config

src/managers/node_env.ts

@@ -30,7 +30,7 @@ const DEV_ENVS = ['dev', 'develop', 'development']
  * - The "prod" and "production" envs are normalized to "production"
  * - The "dev", "develop", and "development" envs are normalized to "development"
  * - Unknown or invalid environments remain as-is
- * 
+ *
  * @example
  * const manager = new NodeEnvManager()
  * manager.process()
@@ -39,15 +39,15 @@ const DEV_ENVS = ['dev', 'develop', 'development']
 export class NodeEnvManager {
   /**
    * The normalized node environment value. Defaults to 'unknown' until process() is called.
-   * 
+   *
    * @type {'unknown' | 'development' | 'production' | 'test' | string}
    * @default 'unknown'
    */
   nodeEnvironment: 'unknown' | 'development' | 'production' | 'test' | string = 'unknown'
 
   /**
    * Normalizes the NODE_ENV value to standard environment names.
-   * 
+   *
    * @private
    * @param {string} [env] - The environment string to normalize
    * @returns {string} The normalized environment string

src/managers/preloads.ts

@@ -17,7 +17,7 @@ import type { AppEnvironments, PreloadNode } from '../types.ts'
  *
  * The class relies on "import.meta.resolve" to resolve the provider modules from
  * the root of the application.
- * 
+ *
  * @example
  * const manager = new PreloadsManager({ environment: 'web' })
  * manager.use([{ file: () => import('./preloads/routes'), environment: ['web'] }])
@@ -27,7 +27,7 @@ export class PreloadsManager {
   /**
    * List of registered preload modules to be imported.
    * Each preload node contains the import function and environment restrictions.
-   * 
+   *
    * @private
    * @type {PreloadNode[]}
    * @default []
@@ -37,7 +37,7 @@ export class PreloadsManager {
   /**
    * Configuration options for the preloads manager.
    * Contains the current application environment used for filtering preloads.
-   * 
+   *
    * @private
    * @type {Object}
    * @property {AppEnvironments} environment - The current application environment

src/managers/providers.ts

@@ -22,17 +22,17 @@ import {
 /**
  * ProvidersManager handles the complete lifecycle of service providers in an AdonisJS application.
  * It manages provider registration, booting, starting, readying, and shutdown phases.
- * 
+ *
  * Service providers are classes that register services, bind dependencies, and set up
  * application components during different phases of the application lifecycle.
- * 
+ *
  * Lifecycle phases:
  * 1. **Register**: Bind services to the IoC container
  * 2. **Boot**: Initialize services after all providers are registered
  * 3. **Start**: Start services (e.g., HTTP server, background jobs)
  * 4. **Ready**: Notify services that application is ready to serve requests
  * 5. **Shutdown**: Gracefully shutdown services during app termination
- * 
+ *
  * @example
  * const manager = new ProvidersManager({ environment: 'web', providersState: [app] })
  * manager.use([
@@ -47,7 +47,7 @@ export class ProvidersManager {
   /**
    * Array of instantiated provider instances used throughout the application lifecycle.
    * These instances are created during the register phase and reused for all subsequent phases.
-   * 
+   *
    * @private
    * @type {ContainerProviderContract[]}
    * @default []
@@ -58,7 +58,7 @@ export class ProvidersManager {
    * Array of provider instances that implement the shutdown lifecycle method.
    * Kept separately to enable efficient shutdown processing without scanning all providers.
    * These providers are called during application termination for cleanup.
-   * 
+   *
    * @private
    * @type {ContainerProviderContract[]}
    * @default []
@@ -69,7 +69,7 @@ export class ProvidersManager {
    * Array of provider nodes from the adonisrc.js configuration.
    * Each node contains the import function and environment restrictions.
    * Cleared after providers are resolved and instantiated.
-   * 
+   *
    * @private
    * @type {ProviderNode[]}
    * @default []
@@ -78,7 +78,7 @@ export class ProvidersManager {
 
   /**
    * Configuration options for the providers manager.
-   * 
+   *
    * @private
    * @type {Object}
    * @property {AppEnvironments} environment - Current application environment for filtering providers

src/managers/rc_file.ts

@@ -15,11 +15,11 @@ import { RcFileParser } from '../rc_file/parser.ts'
  * RcFileManager handles loading, parsing, and processing of the AdonisJS
  * configuration file (adonisrc.js). This file contains application metadata,
  * directory mappings, providers, preloads, and other configuration.
- * 
+ *
  * The manager can work with:
  * - adonisrc.js file from disk
  * - Explicitly provided RC contents (useful for testing)
- * 
+ *
  * @example
  * const manager = new RcFileManager(new URL('file:///app/'))
  * await manager.process()
@@ -28,7 +28,7 @@ import { RcFileParser } from '../rc_file/parser.ts'
 export class RcFileManager {
   /**
    * The application root directory URL used to resolve the adonisrc.js file path.
-   * 
+   *
    * @private
    * @type {URL}
    */
@@ -37,7 +37,7 @@ export class RcFileManager {
   /**
    * RC file contents set explicitly via rcContents() method.
    * When set, prevents loading adonisrc.js from disk.
-   * 
+   *
    * @private
    * @type {Record<string, any> | undefined}
    */
@@ -46,7 +46,7 @@ export class RcFileManager {
   /**
    * Reference to the parsed and validated RC file configuration.
    * Available after the process() method has been called successfully.
-   * 
+   *
    * @type {RcFile}
    */
   rcFile!: RcFile

src/rc_file/parser.ts

@@ -41,14 +41,14 @@ const KNOWN_ASSEMBLER_HOOKS: (keyof NonNullable<RcFile['hooks']>)[] = [
  * RcFileParser processes and validates the adonisrc.js configuration file.
  * It merges user configuration with defaults, applies presets, validates structure,
  * and transforms the configuration into a normalized format.
- * 
+ *
  * The parser handles:
  * - Merging user config with framework defaults
  * - Applying configuration presets
  * - Validating providers, preloads, and hooks
  * - Normalizing directory paths
  * - Processing environment-specific configurations
- * 
+ *
  * @example
  * const parser = new RcFileParser({
  *   typescript: true,
@@ -92,7 +92,7 @@ export class RcFileParser {
   /**
    * Reference to the original raw configuration object before processing.
    * Preserved for debugging and error reporting purposes.
-   * 
+   *
    * @private
    * @type {Record<string, any>}
    */

src/stubs/manager.ts

@@ -20,12 +20,12 @@ import { readFileFromSources } from '../utils.ts'
 /**
  * StubsManager handles reading, copying, and building stubs from various sources.
  * Stubs are template files used for code generation in AdonisJS applications.
- * 
+ *
  * The manager can source stubs from:
  * - Application's local stubs directory (publishTarget)
  * - Custom file system paths
  * - Package exports with stubsRoot
- * 
+ *
  * @example
  * const stubsManager = new StubsManager(app, '/path/to/stubs')
  * const stub = await stubsManager.build('controller.stub')
@@ -35,7 +35,7 @@ export class StubsManager {
   /**
    * Reference to the application instance for importing packages
    * and accessing application context.
-   * 
+   *
    * @private
    * @type {Application<any>}
    */
@@ -45,7 +45,7 @@ export class StubsManager {
    * Absolute path to the directory where stubs should be published
    * or read from with highest priority. This is typically the
    * application's stubs directory.
-   * 
+   *
    * @private
    * @type {string}
    */