@adonisjs/assembler 8.0.0-next.6 → 8.0.0-next.7

package/build/{chunk-MC3FJR62.js → chunk-25Q3N5JR.js}

@@ -3,7 +3,7 @@ import {
   debug_default,
   removeExtension,
   throttle
-} from "./chunk-F4RAGKQN.js";
+} from "./chunk-PORDZS62.js";
 
 // src/index_generator/source.ts
 import string from "@poppinss/utils/string";
@@ -172,14 +172,6 @@ var IndexGeneratorSource = class {
       glob: this.#config.glob
     });
   }
-  /**
-   * Set the logger instance used for CLI output
-   *
-   * @param cliLogger - New logger instance to use
-   */
-  setLogger(cliLogger) {
-    this.#cliLogger = cliLogger;
-  }
   /**
    * Converts a recursive file tree to a string representation
    *
@@ -340,17 +332,6 @@ var IndexGenerator = class {
     this.#appRoot = appRoot;
     this.#cliLogger = cliLogger;
   }
-  /**
-   * Set the logger instance used for CLI output
-   *
-   * Updates the CLI logger instance for this index generator and all
-   * registered sources to use the new logger for output.
-   *
-   * @param cliLogger - New logger instance to use
-   */
-  setLogger(cliLogger) {
-    this.#cliLogger = cliLogger;
-  }
   /**
    * Add a new index generator source
    *

package/build/{chunk-F4RAGKQN.js → chunk-PORDZS62.js}

@@ -152,7 +152,11 @@ async function loadHooks(rcFileHooks, names) {
   const hooks = new Hooks();
   for (const { group, hooks: collection } of groups) {
     for (const item of collection) {
-      hooks.add(group, await importDefault(item));
+      if ("run" in item) {
+        hooks.add(group, item.run);
+      } else {
+        hooks.add(group, await importDefault(item));
+      }
     }
   }
   return hooks;

package/build/index.d.ts

@@ -1,3 +1,4 @@
+export { hooks } from './src/hooks.ts';
 export { Bundler } from './src/bundler.ts';
 export { DevServer } from './src/dev_server.ts';
 export { TestRunner } from './src/test_runner.ts';

package/build/index.js

@@ -1,6 +1,6 @@
 import {
   IndexGenerator
-} from "./chunk-MC3FJR62.js";
+} from "./chunk-25Q3N5JR.js";
 import {
   copyFiles,
   debug_default,
@@ -12,15 +12,240 @@ import {
   runNode,
   throttle,
   watch
-} from "./chunk-F4RAGKQN.js";
+} from "./chunk-PORDZS62.js";
+
+// src/hooks.ts
+var hooks = {
+  /**
+   * Hook called during application initialization. This is the first hook
+   * that gets executed when the assembler starts up.
+   *
+   * @param callback - Function to execute when the init event occurs
+   *
+   * @example
+   * ```js
+   * hooks.init((app) => {
+   *   console.log('Application is initializing')
+   *   // Setup global configurations
+   * })
+   * ```
+   */
+  init(callback) {
+    return callback;
+  },
+  /**
+   * Hook called after routes have been committed to the router.
+   * This occurs after all route definitions have been processed.
+   *
+   * @param callback - Function to execute when routes are committed
+   *
+   * @example
+   * ```js
+   * hooks.routesCommitted((router) => {
+   *   console.log('All routes have been committed to the router')
+   *   // Perform route-based setup
+   * })
+   * ```
+   */
+  routesCommitted(callback) {
+    return callback;
+  },
+  /**
+   * Hook called when the assembler starts scanning for route files.
+   * This happens before any route files are actually processed.
+   *
+   * @param callback - Function to execute when route scanning begins
+   *
+   * @example
+   * ```js
+   * hooks.routesScanning(() => {
+   *   console.log('Starting to scan for route files')
+   *   // Setup route scanning configurations
+   * })
+   * ```
+   */
+  routesScanning(callback) {
+    return callback;
+  },
+  /**
+   * Hook called after all route files have been scanned and processed.
+   * This occurs once the route scanning phase is complete.
+   *
+   * @param callback - Function to execute when route scanning is finished
+   *
+   * @example
+   * ```js
+   * hooks.routesScanned((scannedRoutes) => {
+   *   console.log('Route scanning completed')
+   *   // Process scanned route information
+   * })
+   * ```
+   */
+  routesScanned(callback) {
+    return callback;
+  },
+  /**
+   * Hook called when a file is modified during development.
+   * This is triggered by the file watcher when changes are detected.
+   *
+   * @param callback - Function to execute when a file changes
+   *
+   * @example
+   * ```js
+   * hooks.fileChanged((filePath, stats) => {
+   *   console.log(`File changed: ${filePath}`)
+   *   // Handle file change logic
+   * })
+   * ```
+   */
+  fileChanged(callback) {
+    return callback;
+  },
+  /**
+   * Hook called when a new file is added during development.
+   * This is triggered by the file watcher when new files are created.
+   *
+   * @param callback - Function to execute when a file is added
+   *
+   * @example
+   * ```js
+   * hooks.fileAdded((filePath, stats) => {
+   *   console.log(`New file added: ${filePath}`)
+   *   // Handle new file logic
+   * })
+   * ```
+   */
+  fileAdded(callback) {
+    return callback;
+  },
+  /**
+   * Hook called when a file is removed during development.
+   * This is triggered by the file watcher when files are deleted.
+   *
+   * @param callback - Function to execute when a file is removed
+   *
+   * @example
+   * ```js
+   * hooks.fileRemoved((filePath) => {
+   *   console.log(`File removed: ${filePath}`)
+   *   // Handle file removal logic
+   * })
+   * ```
+   */
+  fileRemoved(callback) {
+    return callback;
+  },
+  /**
+   * Hook called when the development server is about to start.
+   * This occurs before the server begins listening for connections.
+   *
+   * @param callback - Function to execute when dev server is starting
+   *
+   * @example
+   * ```js
+   * hooks.devServerStarting((server) => {
+   *   console.log('Development server is starting')
+   *   // Setup server configurations
+   * })
+   * ```
+   */
+  devServerStarting(callback) {
+    return callback;
+  },
+  /**
+   * Hook called after the development server has successfully started.
+   * This occurs once the server is listening and ready to accept requests.
+   *
+   * @param callback - Function to execute when dev server has started
+   *
+   * @example
+   * ```js
+   * hooks.devServerStarted((server) => {
+   *   console.log(`Development server started on port ${server.port}`)
+   *   // Notify external services or open browser
+   * })
+   * ```
+   */
+  devServerStarted(callback) {
+    return callback;
+  },
+  /**
+   * Hook called when the build process is about to start.
+   * This occurs before any build tasks are executed.
+   *
+   * @param callback - Function to execute when build is starting
+   *
+   * @example
+   * ```js
+   * hooks.buildStarting((buildConfig) => {
+   *   console.log('Build process is starting')
+   *   // Setup build configurations or clean directories
+   * })
+   * ```
+   */
+  buildStarting(callback) {
+    return callback;
+  },
+  /**
+   * Hook called after the build process has completed.
+   * This occurs once all build tasks have finished executing.
+   *
+   * @param callback - Function to execute when build is finished
+   *
+   * @example
+   * ```js
+   * hooks.buildFinished((buildResult) => {
+   *   console.log('Build process completed')
+   *   // Deploy artifacts or notify build completion
+   * })
+   * ```
+   */
+  buildFinished(callback) {
+    return callback;
+  },
+  /**
+   * Hook called when the test suite is about to start.
+   * This occurs before any test files are executed.
+   *
+   * @param callback - Function to execute when tests are starting
+   *
+   * @example
+   * ```js
+   * hooks.testsStarting((testConfig) => {
+   *   console.log('Test suite is starting')
+   *   // Setup test database or mock services
+   * })
+   * ```
+   */
+  testsStarting(callback) {
+    return callback;
+  },
+  /**
+   * Hook called after the test suite has completed.
+   * This occurs once all test files have finished executing.
+   *
+   * @param callback - Function to execute when tests are finished
+   *
+   * @example
+   * ```js
+   * hooks.testsFinished((testResults) => {
+   *   console.log('Test suite completed')
+   *   // Generate test reports or cleanup test resources
+   * })
+   * ```
+   */
+  testsFinished(callback) {
+    return callback;
+  }
+};
 
 // src/bundler.ts
 import dedent from "dedent";
 import fs from "fs/promises";
 import { cliui } from "@poppinss/cliui";
 import { fileURLToPath } from "url";
-import { join, relative } from "path";
 import string from "@poppinss/utils/string";
+import { join, relative } from "path/posix";
 import { detectPackageManager } from "@antfu/install-pkg";
 var SUPPORTED_PACKAGE_MANAGERS = {
   "npm": {
@@ -45,10 +270,6 @@ var SUPPORTED_PACKAGE_MANAGERS = {
   }
 };
 var Bundler = class {
-  /**
-   * The current working project directory path as string
-   */
-  #cwdPath;
   /**
    * Reference to the TypeScript module
    */
@@ -57,6 +278,10 @@ var Bundler = class {
    * Hooks to execute custom actions during the build process
    */
   #hooks;
+  /**
+   * Index generator for managing auto-generated index files
+   */
+  #indexGenerator;
   /**
    * CLI UI instance for displaying colorful messages and progress information
    */
@@ -65,6 +290,10 @@ var Bundler = class {
    * The current working directory URL
    */
   cwd;
+  /**
+   * The current working project directory path as string
+   */
+  cwdPath;
   /**
    * Bundler configuration options including hooks and meta files
    */
@@ -79,7 +308,7 @@ var Bundler = class {
   constructor(cwd, ts, options) {
     this.cwd = cwd;
     this.options = options;
-    this.#cwdPath = fileURLToPath(this.cwd);
+    this.cwdPath = string.toUnixSlash(fileURLToPath(this.cwd));
     this.#ts = ts;
   }
   /**
@@ -87,7 +316,7 @@ var Bundler = class {
    * file path
    */
   #getRelativeName(filePath) {
-    return string.toUnixSlash(relative(this.#cwdPath, filePath));
+    return string.toUnixSlash(relative(this.cwdPath, filePath));
   }
   /**
    * Cleans up the build directory
@@ -115,13 +344,13 @@ var Bundler = class {
    */
   async #copyMetaFiles(outDir, additionalFilesToCopy) {
     const metaFiles = (this.options.metaFiles || []).map((file) => file.pattern).concat(additionalFilesToCopy);
-    await copyFiles(metaFiles, this.#cwdPath, outDir);
+    await copyFiles(metaFiles, this.cwdPath, outDir);
   }
   /**
    * Detect the package manager used by the project
    */
   async #detectPackageManager() {
-    const pkgManager = await detectPackageManager(this.#cwdPath);
+    const pkgManager = await detectPackageManager(this.cwdPath);
     if (pkgManager === "deno") {
       return "npm";
     }
@@ -163,12 +392,18 @@ var Bundler = class {
    * const success = await bundler.bundle(true, 'npm')
    */
   async bundle(stopOnError = true, client) {
-    this.#hooks = await loadHooks(this.options.hooks, ["buildStarting", "buildFinished"]);
     this.packageManager = client ?? await this.#detectPackageManager() ?? "npm";
     const config = parseConfig(this.cwd, this.#ts);
     if (!config) {
       return false;
     }
+    this.ui.logger.info("loading hooks...");
+    this.#hooks = await loadHooks(this.options.hooks, ["init", "buildStarting", "buildFinished"]);
+    this.#indexGenerator = new IndexGenerator(this.cwdPath, this.ui.logger);
+    await this.#hooks.runner("init").run(this, this.#indexGenerator);
+    this.#hooks.clear("init");
+    this.ui.logger.info("generating indexes...");
+    await this.#indexGenerator.generate();
     const outDir = config.options.outDir || fileURLToPath(new URL("build/", this.cwd));
     this.ui.logger.info("cleaning up output directory", { suffix: this.#getRelativeName(outDir) });
     await this.#cleanupBuildDirectory(outDir);
@@ -649,10 +884,6 @@ var DevServer = class _DevServer {
     fullReload: true,
     hotReloaded: false
   };
-  /**
-   * File path computed from the cwd
-   */
-  #cwdPath;
   /**
    * External listeners that are invoked when child process
    * gets an error or closes
@@ -696,7 +927,7 @@ var DevServer = class _DevServer {
   /**
    * CLI UI instance for displaying colorful messages and progress information
    */
-  #ui = cliui2();
+  ui = cliui2();
   /**
    * Restarts the HTTP server and throttle concurrent calls to
    * ensure we do not end up with a long loop of restarts
@@ -734,19 +965,6 @@ var DevServer = class _DevServer {
   #cleanupKeyboardShortcuts() {
     this.#shortcutsManager?.cleanup();
   }
-  /**
-   * CLI UI instance to log colorful messages and progress information
-   */
-  get ui() {
-    return this.#ui;
-  }
-  /**
-   * CLI UI instance to log colorful messages and progress information
-   */
-  set ui(ui) {
-    this.#ui = ui;
-    this.#indexGenerator.setLogger(ui.logger);
-  }
   /**
    * The mode in which the DevServer is running.
    */
@@ -761,6 +979,10 @@ var DevServer = class _DevServer {
    * The current working directory URL
    */
   cwd;
+  /**
+   * File path computed from the cwd
+   */
+  cwdPath;
   /**
    * Development server configuration options including hooks and environment variables
    */
@@ -774,8 +996,7 @@ var DevServer = class _DevServer {
   constructor(cwd, options) {
     this.cwd = cwd;
     this.options = options;
-    this.#cwdPath = string3.toUnixSlash(fileURLToPath2(this.cwd));
-    this.#indexGenerator = new IndexGenerator(this.#cwdPath, this.ui.logger);
+    this.cwdPath = string3.toUnixSlash(fileURLToPath2(this.cwd));
   }
   /**
    * Type guard to check if child process message is from AdonisJS HTTP server
@@ -922,8 +1143,9 @@ var DevServer = class _DevServer {
     this.#mode = mode;
     this.#clearScreen();
     this.ui.logger.info(`starting server in ${this.#mode} mode...`);
+    this.#indexGenerator = new IndexGenerator(this.cwdPath, this.ui.logger);
     this.#stickyPort = String(await getPort(this.cwd));
-    this.#fileSystem = new FileSystem(this.#cwdPath, tsConfig, this.options);
+    this.#fileSystem = new FileSystem(this.cwdPath, tsConfig, this.options);
     this.ui.logger.info("loading hooks...");
     this.#hooks = await loadHooks(this.options.hooks, [
       "init",
@@ -972,7 +1194,7 @@ var DevServer = class _DevServer {
         } else if (this.#mode === "hmr" && this.#isHotHookMessage(message)) {
           debug_default("received hot-hook message %O", message);
           const absolutePath = message.path ? string3.toUnixSlash(message.path) : "";
-          const relativePath = relative3(this.#cwdPath, absolutePath);
+          const relativePath = relative3(this.cwdPath, absolutePath);
           if (message.type === "hot-hook:file-changed") {
             const { action } = message;
             if (action === "add") {
@@ -1074,7 +1296,7 @@ var DevServer = class _DevServer {
     await this.#startHTTPServer(this.#stickyPort);
     this.#watcher = watch({
       usePolling: options?.poll ?? false,
-      cwd: this.#cwdPath,
+      cwd: this.cwdPath,
       ignoreInitial: true,
       ignored: (file, stats) => {
         if (!stats) {
@@ -1097,17 +1319,17 @@ var DevServer = class _DevServer {
     });
     this.#watcher.on("add", (filePath) => {
       const relativePath = string3.toUnixSlash(filePath);
-      const absolutePath = join2(this.#cwdPath, relativePath);
+      const absolutePath = join2(this.cwdPath, relativePath);
       this.#hooks.runner("fileAdded").run(relativePath, absolutePath, this);
     });
     this.#watcher.on("change", (filePath) => {
       const relativePath = string3.toUnixSlash(filePath);
-      const absolutePath = join2(this.#cwdPath, relativePath);
+      const absolutePath = join2(this.cwdPath, relativePath);
       this.#hooks.runner("fileChanged").run(relativePath, absolutePath, _DevServer.#WATCHER_INFO, this);
     });
     this.#watcher.on("unlink", (filePath) => {
       const relativePath = string3.toUnixSlash(filePath);
-      const absolutePath = join2(this.#cwdPath, relativePath);
+      const absolutePath = join2(this.cwdPath, relativePath);
       this.#hooks.runner("fileRemoved").run(relativePath, absolutePath, this);
     });
   }
@@ -1148,10 +1370,6 @@ var TestRunner = class {
    * Hooks to execute custom actions during the tests runner lifecycle
    */
   #hooks;
-  /**
-   * The current working directory path as a string
-   */
-  #cwdPath;
   /**
    * Index generator for managing auto-generated index files
    */
@@ -1159,7 +1377,7 @@ var TestRunner = class {
   /**
    * CLI UI instance for displaying colorful messages and progress information
    */
-  #ui = cliui3();
+  ui = cliui3();
   /**
    * Re-runs the test child process and throttle concurrent calls to
    * ensure we do not end up with a long loop of restarts
@@ -1171,19 +1389,6 @@ var TestRunner = class {
     }
     await this.#runTests(this.#stickyPort, filters);
   }, "reRunTests");
-  /**
-   * CLI UI instance to log colorful messages and progress information
-   */
-  get ui() {
-    return this.#ui;
-  }
-  /**
-   * CLI UI instance to log colorful messages and progress information
-   */
-  set ui(ui) {
-    this.#ui = ui;
-    this.#indexGenerator.setLogger(ui.logger);
-  }
   /**
    * The script file to run as a child process
    */
@@ -1192,6 +1397,10 @@ var TestRunner = class {
    * The current working directory URL
    */
   cwd;
+  /**
+   * The current working directory path as a string
+   */
+  cwdPath;
   /**
    * Test runner configuration options including filters, reporters, and hooks
    */
@@ -1205,8 +1414,7 @@ var TestRunner = class {
   constructor(cwd, options) {
     this.cwd = cwd;
     this.options = options;
-    this.#cwdPath = string4.toUnixSlash(fileURLToPath3(this.cwd));
-    this.#indexGenerator = new IndexGenerator(this.#cwdPath, this.ui.logger);
+    this.cwdPath = string4.toUnixSlash(fileURLToPath3(this.cwd));
   }
   /**
    * Convert test runner options to the CLI args
@@ -1419,16 +1627,10 @@ var TestRunner = class {
    */
   async run() {
     this.#stickyPort = String(await getPort(this.cwd));
+    this.#indexGenerator = new IndexGenerator(this.cwdPath, this.ui.logger);
     this.#clearScreen();
     this.ui.logger.info("loading hooks...");
-    this.#hooks = await loadHooks(this.options.hooks, [
-      "init",
-      "testsStarting",
-      "testsFinished",
-      "fileAdded",
-      "fileChanged",
-      "fileRemoved"
-    ]);
+    this.#hooks = await loadHooks(this.options.hooks, ["init", "testsStarting", "testsFinished"]);
     await this.#hooks.runner("init").run(this, this.#indexGenerator);
     this.#hooks.clear("init");
     this.ui.logger.info("generating indexes...");
@@ -1454,7 +1656,8 @@ var TestRunner = class {
       return;
     }
     this.#stickyPort = String(await getPort(this.cwd));
-    this.#fileSystem = new FileSystem(this.#cwdPath, tsConfig, {
+    this.#indexGenerator = new IndexGenerator(this.cwdPath, this.ui.logger);
+    this.#fileSystem = new FileSystem(this.cwdPath, tsConfig, {
       ...this.options,
       suites: this.options.suites?.filter((suite) => {
         if (this.options.filters.suites) {
@@ -1482,7 +1685,7 @@ var TestRunner = class {
     await this.#runTests(this.#stickyPort);
     this.#watcher = watch({
       usePolling: options?.poll ?? false,
-      cwd: this.#cwdPath,
+      cwd: this.cwdPath,
       ignoreInitial: true,
       ignored: (file, stats) => {
         if (!stats) {
@@ -1505,12 +1708,12 @@ var TestRunner = class {
     });
     this.#watcher.on("add", (filePath) => {
       const relativePath = string4.toUnixSlash(filePath);
-      const absolutePath = join3(this.#cwdPath, filePath);
+      const absolutePath = join3(this.cwdPath, filePath);
       this.#hooks.runner("fileAdded").run(relativePath, absolutePath, this);
     });
     this.#watcher.on("change", (filePath) => {
       const relativePath = string4.toUnixSlash(filePath);
-      const absolutePath = join3(this.#cwdPath, filePath);
+      const absolutePath = join3(this.cwdPath, filePath);
       this.#hooks.runner("fileChanged").run(
         relativePath,
         absolutePath,
@@ -1524,7 +1727,7 @@ var TestRunner = class {
     });
     this.#watcher.on("unlink", (filePath) => {
       const relativePath = string4.toUnixSlash(filePath);
-      const absolutePath = join3(this.#cwdPath, filePath);
+      const absolutePath = join3(this.cwdPath, filePath);
       this.#hooks.runner("fileRemoved").run(relativePath, absolutePath, this);
     });
   }
@@ -1533,5 +1736,6 @@ export {
   Bundler,
   DevServer,
   SUPPORTED_PACKAGE_MANAGERS,
-  TestRunner
+  TestRunner,
+  hooks
 };

package/build/src/bundler.d.ts

@@ -52,6 +52,10 @@ export declare class Bundler {
      * The current working directory URL
      */
     cwd: URL;
+    /**
+     * The current working project directory path as string
+     */
+    cwdPath: string;
     /**
      * Bundler configuration options including hooks and meta files
      */

package/build/src/code_scanners/routes_scanner/main.js

@@ -10,7 +10,7 @@ import {
   VirtualFileSystem,
   debug_default,
   isRelative
-} from "../../../chunk-F4RAGKQN.js";
+} from "../../../chunk-PORDZS62.js";
 
 // src/code_scanners/routes_scanner/main.ts
 import { cliui } from "@poppinss/cliui";

package/build/src/dev_server.d.ts

@@ -1,5 +1,4 @@
 import type tsStatic from 'typescript';
-import { cliui } from '@poppinss/cliui';
 import type { DevServerOptions } from './types/common.ts';
 /**
  * Exposes the API to start the development server in HMR, watch or static mode.
@@ -18,13 +17,29 @@ import type { DevServerOptions } from './types/common.ts';
 export declare class DevServer {
     #private;
     /**
-     * CLI UI instance to log colorful messages and progress information
+     * CLI UI instance for displaying colorful messages and progress information
      */
-    get ui(): ReturnType<typeof cliui>;
-    /**
-     * CLI UI instance to log colorful messages and progress information
-     */
-    set ui(ui: ReturnType<typeof cliui>);
+    ui: {
+        colors: import("@poppinss/colors/types").Colors;
+        logger: import("@poppinss/cliui").Logger;
+        table: (tableOptions?: Partial<import("@poppinss/cliui/types").TableOptions>) => import("@poppinss/cliui").Table;
+        tasks: (tasksOptions?: Partial<import("@poppinss/cliui/types").TaskManagerOptions>) => import("@poppinss/cliui").TaskManager;
+        icons: {
+            tick: string;
+            cross: string;
+            bullet: string;
+            nodejs: string;
+            pointer: string;
+            info: string;
+            warning: string;
+            squareSmallFilled: string;
+        };
+        sticker: () => import("@poppinss/cliui").Instructions;
+        instructions: () => import("@poppinss/cliui").Instructions;
+        switchMode(modeToUse: "raw" | "silent" | "normal"): void;
+        useRenderer(rendererToUse: import("@poppinss/cliui/types").RendererContract): void;
+        useColors(colorsToUse: import("@poppinss/colors/types").Colors): void;
+    };
     /**
      * The mode in which the DevServer is running.
      */
@@ -37,6 +52,10 @@ export declare class DevServer {
      * The current working directory URL
      */
     cwd: URL;
+    /**
+     * File path computed from the cwd
+     */
+    cwdPath: string;
     /**
      * Development server configuration options including hooks and environment variables
      */

package/build/src/hooks.d.ts

@@ -0,0 +1,224 @@
+import { type AsyncOrSync } from '@poppinss/utils/types';
+import { type HookParams } from './types/hooks.ts';
+/**
+ * Collection of hooks that can be used to listen for various events during
+ * the application lifecycle. These hooks allow you to execute custom logic
+ * at specific points in the development server, build process, and testing.
+ *
+ * @example
+ * ```js
+ * const { hooks } = await import('@adonisjs/assembler/hooks')
+ *
+ * hooks.init((app) => {
+ *   console.log('Application initialized')
+ * })
+ *
+ * hooks.devServerStarted((server) => {
+ *   console.log('Dev server started on port', server.port)
+ * })
+ * ```
+ */
+export declare const hooks: {
+    /**
+     * Hook called during application initialization. This is the first hook
+     * that gets executed when the assembler starts up.
+     *
+     * @param callback - Function to execute when the init event occurs
+     *
+     * @example
+     * ```js
+     * hooks.init((app) => {
+     *   console.log('Application is initializing')
+     *   // Setup global configurations
+     * })
+     * ```
+     */
+    init(callback: (...args: HookParams<"init">) => AsyncOrSync<void>): (parent: import("./dev_server.ts").DevServer | import("./test_runner.ts").TestRunner | import("./bundler.ts").Bundler, indexGenerator: import("./index_generator/main.ts").IndexGenerator) => AsyncOrSync<void>;
+    /**
+     * Hook called after routes have been committed to the router.
+     * This occurs after all route definitions have been processed.
+     *
+     * @param callback - Function to execute when routes are committed
+     *
+     * @example
+     * ```js
+     * hooks.routesCommitted((router) => {
+     *   console.log('All routes have been committed to the router')
+     *   // Perform route-based setup
+     * })
+     * ```
+     */
+    routesCommitted(callback: (...args: HookParams<"routesCommitted">) => AsyncOrSync<void>): (parent: import("./dev_server.ts").DevServer, routes: Record<string, import("./types/code_scanners.ts").RoutesListItem[]>) => AsyncOrSync<void>;
+    /**
+     * Hook called when the assembler starts scanning for route files.
+     * This happens before any route files are actually processed.
+     *
+     * @param callback - Function to execute when route scanning begins
+     *
+     * @example
+     * ```js
+     * hooks.routesScanning(() => {
+     *   console.log('Starting to scan for route files')
+     *   // Setup route scanning configurations
+     * })
+     * ```
+     */
+    routesScanning(callback: (...args: HookParams<"routesScanning">) => AsyncOrSync<void>): (parent: import("./dev_server.ts").DevServer, routesScanner: import("./code_scanners/routes_scanner/main.ts").RoutesScanner) => AsyncOrSync<void>;
+    /**
+     * Hook called after all route files have been scanned and processed.
+     * This occurs once the route scanning phase is complete.
+     *
+     * @param callback - Function to execute when route scanning is finished
+     *
+     * @example
+     * ```js
+     * hooks.routesScanned((scannedRoutes) => {
+     *   console.log('Route scanning completed')
+     *   // Process scanned route information
+     * })
+     * ```
+     */
+    routesScanned(callback: (...args: HookParams<"routesScanned">) => AsyncOrSync<void>): (parent: import("./dev_server.ts").DevServer, routesScanner: import("./code_scanners/routes_scanner/main.ts").RoutesScanner) => AsyncOrSync<void>;
+    /**
+     * Hook called when a file is modified during development.
+     * This is triggered by the file watcher when changes are detected.
+     *
+     * @param callback - Function to execute when a file changes
+     *
+     * @example
+     * ```js
+     * hooks.fileChanged((filePath, stats) => {
+     *   console.log(`File changed: ${filePath}`)
+     *   // Handle file change logic
+     * })
+     * ```
+     */
+    fileChanged(callback: (...args: HookParams<"fileChanged">) => AsyncOrSync<void>): (relativePath: string, absolutePath: string, info: {
+        source: "hot-hook" | "watcher";
+        hotReloaded: boolean;
+        fullReload: boolean;
+    }, parent: import("./dev_server.ts").DevServer | import("./test_runner.ts").TestRunner) => AsyncOrSync<void>;
+    /**
+     * Hook called when a new file is added during development.
+     * This is triggered by the file watcher when new files are created.
+     *
+     * @param callback - Function to execute when a file is added
+     *
+     * @example
+     * ```js
+     * hooks.fileAdded((filePath, stats) => {
+     *   console.log(`New file added: ${filePath}`)
+     *   // Handle new file logic
+     * })
+     * ```
+     */
+    fileAdded(callback: (...args: HookParams<"fileAdded">) => AsyncOrSync<void>): (relativePath: string, absolutePath: string, server: import("./dev_server.ts").DevServer | import("./test_runner.ts").TestRunner) => AsyncOrSync<void>;
+    /**
+     * Hook called when a file is removed during development.
+     * This is triggered by the file watcher when files are deleted.
+     *
+     * @param callback - Function to execute when a file is removed
+     *
+     * @example
+     * ```js
+     * hooks.fileRemoved((filePath) => {
+     *   console.log(`File removed: ${filePath}`)
+     *   // Handle file removal logic
+     * })
+     * ```
+     */
+    fileRemoved(callback: (...args: HookParams<"fileRemoved">) => AsyncOrSync<void>): (relativePath: string, absolutePath: string, server: import("./dev_server.ts").DevServer | import("./test_runner.ts").TestRunner) => AsyncOrSync<void>;
+    /**
+     * Hook called when the development server is about to start.
+     * This occurs before the server begins listening for connections.
+     *
+     * @param callback - Function to execute when dev server is starting
+     *
+     * @example
+     * ```js
+     * hooks.devServerStarting((server) => {
+     *   console.log('Development server is starting')
+     *   // Setup server configurations
+     * })
+     * ```
+     */
+    devServerStarting(callback: (...args: HookParams<"devServerStarting">) => AsyncOrSync<void>): (server: import("./dev_server.ts").DevServer) => AsyncOrSync<void>;
+    /**
+     * Hook called after the development server has successfully started.
+     * This occurs once the server is listening and ready to accept requests.
+     *
+     * @param callback - Function to execute when dev server has started
+     *
+     * @example
+     * ```js
+     * hooks.devServerStarted((server) => {
+     *   console.log(`Development server started on port ${server.port}`)
+     *   // Notify external services or open browser
+     * })
+     * ```
+     */
+    devServerStarted(callback: (...args: HookParams<"devServerStarted">) => AsyncOrSync<void>): (server: import("./dev_server.ts").DevServer, info: {
+        port: number;
+        host: string;
+    }, uiInstructions: import("@poppinss/cliui").Instructions) => AsyncOrSync<void>;
+    /**
+     * Hook called when the build process is about to start.
+     * This occurs before any build tasks are executed.
+     *
+     * @param callback - Function to execute when build is starting
+     *
+     * @example
+     * ```js
+     * hooks.buildStarting((buildConfig) => {
+     *   console.log('Build process is starting')
+     *   // Setup build configurations or clean directories
+     * })
+     * ```
+     */
+    buildStarting(callback: (...args: HookParams<"buildStarting">) => AsyncOrSync<void>): (server: import("./bundler.ts").Bundler) => AsyncOrSync<void>;
+    /**
+     * Hook called after the build process has completed.
+     * This occurs once all build tasks have finished executing.
+     *
+     * @param callback - Function to execute when build is finished
+     *
+     * @example
+     * ```js
+     * hooks.buildFinished((buildResult) => {
+     *   console.log('Build process completed')
+     *   // Deploy artifacts or notify build completion
+     * })
+     * ```
+     */
+    buildFinished(callback: (...args: HookParams<"buildFinished">) => AsyncOrSync<void>): (server: import("./bundler.ts").Bundler, uiInstructions: import("@poppinss/cliui").Instructions) => AsyncOrSync<void>;
+    /**
+     * Hook called when the test suite is about to start.
+     * This occurs before any test files are executed.
+     *
+     * @param callback - Function to execute when tests are starting
+     *
+     * @example
+     * ```js
+     * hooks.testsStarting((testConfig) => {
+     *   console.log('Test suite is starting')
+     *   // Setup test database or mock services
+     * })
+     * ```
+     */
+    testsStarting(callback: (...args: HookParams<"testsStarting">) => AsyncOrSync<void>): (server: import("./test_runner.ts").TestRunner) => AsyncOrSync<void>;
+    /**
+     * Hook called after the test suite has completed.
+     * This occurs once all test files have finished executing.
+     *
+     * @param callback - Function to execute when tests are finished
+     *
+     * @example
+     * ```js
+     * hooks.testsFinished((testResults) => {
+     *   console.log('Test suite completed')
+     *   // Generate test reports or cleanup test resources
+     * })
+     * ```
+     */
+    testsFinished(callback: (...args: HookParams<"testsFinished">) => AsyncOrSync<void>): (server: import("./test_runner.ts").TestRunner) => AsyncOrSync<void>;
+};

package/build/src/index_generator/main.d.ts

@@ -26,15 +26,6 @@ export declare class IndexGenerator {
      * @param cliLogger - Logger instance for CLI output
      */
     constructor(appRoot: string, cliLogger: Logger);
-    /**
-     * Set the logger instance used for CLI output
-     *
-     * Updates the CLI logger instance for this index generator and all
-     * registered sources to use the new logger for output.
-     *
-     * @param cliLogger - New logger instance to use
-     */
-    setLogger(cliLogger: Logger): void;
     /**
      * Add a new index generator source
      *

package/build/src/index_generator/main.js

@@ -1,7 +1,7 @@
 import {
   IndexGenerator
-} from "../../chunk-MC3FJR62.js";
-import "../../chunk-F4RAGKQN.js";
+} from "../../chunk-25Q3N5JR.js";
+import "../../chunk-PORDZS62.js";
 export {
   IndexGenerator
 };

package/build/src/index_generator/source.d.ts

@@ -32,12 +32,6 @@ export declare class IndexGeneratorSource {
      * @param config - Configuration for this index generator source
      */
     constructor(name: string, appRoot: string, cliLogger: Logger, config: IndexGeneratorSourceConfig);
-    /**
-     * Set the logger instance used for CLI output
-     *
-     * @param cliLogger - New logger instance to use
-     */
-    setLogger(cliLogger: Logger): void;
     /**
      * Add a file to the virtual file system and regenerate index if needed
      *

package/build/src/test_runner.d.ts

@@ -1,5 +1,4 @@
 import type tsStatic from 'typescript';
-import { cliui } from '@poppinss/cliui';
 import type { TestRunnerOptions } from './types/common.ts';
 /**
  * Exposes the API to run Japa tests and optionally watch for file
@@ -27,13 +26,29 @@ import type { TestRunnerOptions } from './types/common.ts';
 export declare class TestRunner {
     #private;
     /**
-     * CLI UI instance to log colorful messages and progress information
+     * CLI UI instance for displaying colorful messages and progress information
      */
-    get ui(): ReturnType<typeof cliui>;
-    /**
-     * CLI UI instance to log colorful messages and progress information
-     */
-    set ui(ui: ReturnType<typeof cliui>);
+    ui: {
+        colors: import("@poppinss/colors/types").Colors;
+        logger: import("@poppinss/cliui").Logger;
+        table: (tableOptions?: Partial<import("@poppinss/cliui/types").TableOptions>) => import("@poppinss/cliui").Table;
+        tasks: (tasksOptions?: Partial<import("@poppinss/cliui/types").TaskManagerOptions>) => import("@poppinss/cliui").TaskManager;
+        icons: {
+            tick: string;
+            cross: string;
+            bullet: string;
+            nodejs: string;
+            pointer: string;
+            info: string;
+            warning: string;
+            squareSmallFilled: string;
+        };
+        sticker: () => import("@poppinss/cliui").Instructions;
+        instructions: () => import("@poppinss/cliui").Instructions;
+        switchMode(modeToUse: "raw" | "silent" | "normal"): void;
+        useRenderer(rendererToUse: import("@poppinss/cliui/types").RendererContract): void;
+        useColors(colorsToUse: import("@poppinss/colors/types").Colors): void;
+    };
     /**
      * The script file to run as a child process
      */
@@ -42,6 +57,10 @@ export declare class TestRunner {
      * The current working directory URL
      */
     cwd: URL;
+    /**
+     * The current working directory path as a string
+     */
+    cwdPath: string;
     /**
      * Test runner configuration options including filters, reporters, and hooks
      */

package/build/src/types/common.d.ts

@@ -1,8 +1,8 @@
 import type { Logger } from '@poppinss/cliui';
 import { type Prettify } from '@poppinss/utils/types';
+import { type AllHooks } from './hooks.ts';
 import { type FileBuffer } from '../file_buffer.ts';
 import { type VirtualFileSystem } from '../virtual_file_system.ts';
-import { type CommonHooks, type RouterHooks, type BundlerHooks, type WatcherHooks, type DevServerHooks, type TestRunnerHooks } from './hooks.ts';
 /**
  * Recursive file tree structure for representing nested directory hierarchies
  */
@@ -121,7 +121,7 @@ export type AssemblerRcFile = {
     /**
      * Hooks to execute at different stages of development and build processes
      */
-    hooks?: Partial<CommonHooks & WatcherHooks & DevServerHooks & BundlerHooks & TestRunnerHooks & RouterHooks>;
+    hooks?: Partial<AllHooks>;
     /**
      * An array of test suites configuration
      */

package/build/src/types/hooks.d.ts

@@ -4,8 +4,27 @@ import { type Bundler } from '../bundler.ts';
 import { type DevServer } from '../dev_server.ts';
 import { type TestRunner } from '../test_runner.ts';
 import { type RoutesListItem } from './code_scanners.ts';
-import { type RoutesScanner } from '../code_scanners/routes_scanner/main.ts';
 import { type IndexGenerator } from '../index_generator/main.ts';
+import { type RoutesScanner } from '../code_scanners/routes_scanner/main.ts';
+/**
+ * Defines a hook that can be either a lazy import or an object with a run method.
+ * This type provides flexibility in how hooks are defined and imported, supporting
+ * both dynamic imports for code splitting and direct object definitions.
+ *
+ * @template Fn - The function signature that the hook must conform to
+ *
+ * @example
+ * // Using lazy import
+ * const hook: DefineHook<(server: DevServer) => void> = () => import('./my-hook')
+ *
+ * // Using direct object
+ * const hook: DefineHook<(server: DevServer) => void> = {
+ *   run: (server) => console.log('Hook executed')
+ * }
+ */
+type DefineHook<Fn extends (...args: any) => any> = LazyImport<Fn> | {
+    run: Fn;
+};
 /**
  * Common hooks executed by the dev-server, test runner and the bundler.
  * These hooks are shared across all assembler operations and provide
@@ -26,7 +45,7 @@ export type CommonHooks = {
      *
      * @param parent - The parent instance (DevServer, TestRunner, or Bundler)
      */
-    init: LazyImport<(parent: DevServer | TestRunner | Bundler, indexGenerator: IndexGenerator) => AsyncOrSync<void>>[];
+    init: DefineHook<(parent: DevServer | TestRunner | Bundler, indexGenerator: IndexGenerator) => AsyncOrSync<void>>[];
 };
 /**
  * Hooks executed by the dev server around the router.
@@ -53,7 +72,7 @@ export type RouterHooks = {
      * @param parent - The DevServer instance
      * @param routes - Record of routes grouped by domain or method
      */
-    routesCommitted: LazyImport<(parent: DevServer, routes: Record<string, RoutesListItem[]>) => AsyncOrSync<void>>[];
+    routesCommitted: DefineHook<(parent: DevServer, routes: Record<string, RoutesListItem[]>) => AsyncOrSync<void>>[];
     /**
      * The hook is executed when dev server begins the routes scanning process.
      * Use this hook to prepare for route scanning or modify scanner configuration.
@@ -61,7 +80,7 @@ export type RouterHooks = {
      * @param parent - The DevServer instance
      * @param routesScanner - The RoutesScanner instance being used
      */
-    routesScanning: LazyImport<(parent: DevServer, routesScanner: RoutesScanner) => AsyncOrSync<void>>[];
+    routesScanning: DefineHook<(parent: DevServer, routesScanner: RoutesScanner) => AsyncOrSync<void>>[];
     /**
      * The hook is executed when routes scanning process has finished.
      * Use this hook to process the scanned routes or clean up resources.
@@ -69,7 +88,7 @@ export type RouterHooks = {
      * @param parent - The DevServer instance
      * @param routesScanner - The RoutesScanner instance that was used
      */
-    routesScanned: LazyImport<(parent: DevServer, routesScanner: RoutesScanner) => AsyncOrSync<void>>[];
+    routesScanned: DefineHook<(parent: DevServer, routesScanner: RoutesScanner) => AsyncOrSync<void>>[];
 };
 /**
  * Hooks executed by the file watcher during development and testing.
@@ -103,7 +122,7 @@ export type WatcherHooks = {
      * @param info.fullReload - Whether a full server reload is required
      * @param parent - The parent DevServer or TestRunner instance
      */
-    fileChanged: LazyImport<(relativePath: string, absolutePath: string, info: {
+    fileChanged: DefineHook<(relativePath: string, absolutePath: string, info: {
         /** Source of the file change notification */
         source: 'hot-hook' | 'watcher';
         /** Whether the file was hot reloaded without server restart */
@@ -118,7 +137,7 @@ export type WatcherHooks = {
      * @param filePath - The absolute path to the added file
      * @param server - The DevServer or TestRunner instance
      */
-    fileAdded: LazyImport<(relativePath: string, absolutePath: string, server: DevServer | TestRunner) => AsyncOrSync<void>>[];
+    fileAdded: DefineHook<(relativePath: string, absolutePath: string, server: DevServer | TestRunner) => AsyncOrSync<void>>[];
     /**
      * The hook is executed after a file has been removed from the filesystem.
      * Use this hook to clean up resources or update caches when files are deleted.
@@ -126,7 +145,7 @@ export type WatcherHooks = {
      * @param filePath - The absolute path to the removed file
      * @param server - The DevServer or TestRunner instance
      */
-    fileRemoved: LazyImport<(relativePath: string, absolutePath: string, server: DevServer | TestRunner) => AsyncOrSync<void>>[];
+    fileRemoved: DefineHook<(relativePath: string, absolutePath: string, server: DevServer | TestRunner) => AsyncOrSync<void>>[];
 };
 /**
  * Hooks executed when running the development server.
@@ -148,7 +167,7 @@ export type DevServerHooks = {
      *
      * @param server - The DevServer instance that is about to start
      */
-    devServerStarting: LazyImport<(server: DevServer) => AsyncOrSync<void>>[];
+    devServerStarting: DefineHook<(server: DevServer) => AsyncOrSync<void>>[];
     /**
      * The hook is executed after the child process has been started.
      * Use this hook to display additional information or perform post-startup tasks.
@@ -159,7 +178,7 @@ export type DevServerHooks = {
      * @param info.host - The host address the server is bound to
      * @param uiInstructions - UI instructions for displaying server information
      */
-    devServerStarted: LazyImport<(server: DevServer, info: {
+    devServerStarted: DefineHook<(server: DevServer, info: {
         port: number;
         host: string;
     }, uiInstructions: Instructions) => AsyncOrSync<void>>[];
@@ -184,7 +203,7 @@ export type BundlerHooks = {
      *
      * @param server - The Bundler instance that will create the build
      */
-    buildStarting: LazyImport<(server: Bundler) => AsyncOrSync<void>>[];
+    buildStarting: DefineHook<(server: Bundler) => AsyncOrSync<void>>[];
     /**
      * The hook is executed after the production build has been created.
      * Use this hook to perform post-build tasks or display build statistics.
@@ -192,7 +211,7 @@ export type BundlerHooks = {
      * @param server - The Bundler instance that created the build
      * @param uiInstructions - UI instructions for displaying build information
      */
-    buildFinished: LazyImport<(server: Bundler, uiInstructions: Instructions) => AsyncOrSync<void>>[];
+    buildFinished: DefineHook<(server: Bundler, uiInstructions: Instructions) => AsyncOrSync<void>>[];
 };
 /**
  * Hooks executed when running the test suite.
@@ -214,12 +233,50 @@ export type TestRunnerHooks = {
      *
      * @param server - The TestRunner instance that will execute the tests
      */
-    testsStarting: LazyImport<(server: TestRunner) => AsyncOrSync<void>>[];
+    testsStarting: DefineHook<(server: TestRunner) => AsyncOrSync<void>>[];
     /**
      * The hook is executed after the tests have been executed.
      * Use this hook to clean up resources or generate test reports.
      *
      * @param server - The TestRunner instance that executed the tests
      */
-    testsFinished: LazyImport<(server: TestRunner) => AsyncOrSync<void>>[];
+    testsFinished: DefineHook<(server: TestRunner) => AsyncOrSync<void>>[];
 };
+/**
+ * Combined type representing all available hooks across the assembler ecosystem.
+ * This intersection type merges all hook categories into a single type for
+ * comprehensive hook management and type safety.
+ *
+ * @example
+ * ```js
+ * const allHooks: AllHooks = {
+ *   init: [() => import('./hooks/init')],
+ *   fileChanged: [() => import('./hooks/file_changed')],
+ *   devServerStarted: [() => import('./hooks/dev_server_started')],
+ *   buildFinished: [() => import('./hooks/build_finished')],
+ *   testsFinished: [() => import('./hooks/tests_finished')],
+ *   routesCommitted: [() => import('./hooks/routes_committed')]
+ * }
+ * ```
+ */
+export type AllHooks = CommonHooks & WatcherHooks & DevServerHooks & BundlerHooks & TestRunnerHooks & RouterHooks;
+/**
+ * Utility type that extracts the parameter types for a specific hook.
+ * This type helps maintain type safety when working with hook callbacks
+ * by providing the exact parameter signature for any given hook name.
+ *
+ * @template Hook - The name of the hook to extract parameters for
+ *
+ * @example
+ * ```js
+ * // Get parameters for the fileChanged hook
+ * type FileChangedParams = HookParams<'fileChanged'>
+ * // Result: [string, string, {...}, DevServer | TestRunner]
+ *
+ * // Get parameters for the devServerStarted hook
+ * type DevServerStartedParams = HookParams<'devServerStarted')
+ * // Result: [DevServer, {port: number, host: string}, Instructions]
+ * ```
+ */
+export type HookParams<Hook extends keyof AllHooks> = AllHooks[Hook][number] extends DefineHook<infer A> ? Parameters<A> : never;
+export {};

package/build/src/utils.d.ts

@@ -1,9 +1,8 @@
 import Hooks from '@poppinss/hooks';
 import type tsStatic from 'typescript';
 import { type ChokidarOptions } from 'chokidar';
-import { type UnWrapLazyImport } from '@poppinss/utils/types';
 import type { RunScriptOptions } from './types/common.ts';
-import { type CommonHooks, type RouterHooks, type WatcherHooks, type BundlerHooks, type DevServerHooks, type TestRunnerHooks } from './types/hooks.ts';
+import { type AllHooks, type HookParams } from './types/hooks.ts';
 /**
  * Parses tsconfig.json and prints errors using typescript compiler host
  *
@@ -145,8 +144,7 @@ export declare function isRelative(pathValue: string): boolean;
  * @param names - Array of hook names to load
  * @returns Promise resolving to configured Hooks instance
  */
-type AllHooks = CommonHooks & RouterHooks & WatcherHooks & DevServerHooks & BundlerHooks & TestRunnerHooks;
-export declare function loadHooks<K extends keyof AllHooks>(rcFileHooks: Partial<AllHooks> | undefined, names: K[]): Promise<Hooks<{ [P in K]: [Parameters<UnWrapLazyImport<AllHooks[K][number]>>, Parameters<UnWrapLazyImport<AllHooks[K][number]>>]; }>>;
+export declare function loadHooks<K extends keyof AllHooks>(rcFileHooks: Partial<AllHooks> | undefined, names: K[]): Promise<Hooks<{ [P in K]: [HookParams<P>, HookParams<P>]; }>>;
 /**
  * Wraps a function inside another function that throttles the concurrent
  * executions of a function. If the function is called too quickly, then
@@ -167,4 +165,3 @@ export declare function throttle<Args extends any[]>(fn: (...args: Args) => Prom
  * @returns The file path without extension
  */
 export declare function removeExtension(filePath: string): string;
-export {};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@adonisjs/assembler",
   "description": "Provides utilities to run AdonisJS development server and build project for production",
-  "version": "8.0.0-next.6",
+  "version": "8.0.0-next.7",
   "engines": {
     "node": ">=24.0.0"
   },