@remotex-labs/xbuild 1.5.11 → 1.5.12

package/dist/cli.d.ts

@@ -1,106 +1,11 @@
-
-/**
- * This file was automatically generated by xBuild.
- * DO NOT EDIT MANUALLY.
- */
- import type { SourceService } from '@remotex-labs/xmap';
-import { SourceService } from '@remotex-labs/xmap';
-export type { BuildResult, OnLoadArgs, OnLoadResult, OnResolveArgs, OnResolveResult, PluginBuild } from 'esbuild';
-import type { BuildResult } from 'esbuild';
-import type { BuildOptions } from 'esbuild';
-import type { IncomingMessage, ServerResponse } from 'http';
-import type { Loader, OnLoadArgs, BuildResult, OnEndResult, PluginBuild, OnLoadResult, OnResolveArgs, OnResolveResult } from 'esbuild';
-import type { Format } from 'esbuild';
-import type { Argv } from 'yargs';
-import type { ChildProcessWithoutNullStreams } from 'child_process';
-import type { Loader, Metafile, OnLoadArgs, OnLoadResult } from 'esbuild';
-import type { BuildOptions, BuildResult, Metafile } from 'esbuild';
-import type { Message } from 'esbuild';
-import type { Plugin } from 'esbuild';
-import type { ParsedCommandLine, Diagnostic } from 'typescript';
-import type { OutputFile } from 'typescript';
-import type { FormatDiagnosticsHost } from 'typescript';
-import type { CompilerOptions, IScriptSnapshot } from 'typescript';
-import type { ParsedCommandLine, LanguageService } from 'typescript';
-import type { Context } from 'vm';
-
 #!/usr/bin/env node
-/**
- * Import will remove at compile time
- */
-export {};
-
-/**
- * Imports
- */
-/**
- * Represents an error specific to the xBuild process.
- *
- * The `xBuildError` class extends the `BaseError` class to provide a custom error type for the xBuild system.
- * It includes additional functionality to maintain stack trace information and assigns a specific name to
- * the error, making it easier to identify and handle in different parts of the application.
- *
- * @augments BaseError
- */
-declare class xBuildError extends BaseError {
-    /**
-     * Original error stack
-     */
-    originalErrorStack: string | undefined;
-    /**
-     * Creates an instance of `xBuildError`.
-     *
-     * @param message - The error message that describes the error. This message is passed to the base class
-     *   `BaseError` constructor and is used to provide context about the nature of the error.
-     * @param options - Optional configuration for the error. This can include additional properties or settings
-     *   that customize the error's behavior.
-     */
-    constructor(message: string, options?: ErrorOptions);
-}
-
-/**
- * Import will remove at compile time
- */
-/**
- * A base class for custom errors with enhanced stack trace formatting and source code information.
- *
- * The `BaseError` class extends the native `Error` class, adding functionality to format the error stack
- * trace and include details from a source map service. This is useful for debugging errors in compiled
- * or transpiled code by providing clearer information about the source of the error.
- */
-export declare abstract class BaseError extends Error {
-    readonly sourceMap?: SourceService | undefined;
-    callStacks: Array<NodeJS.CallSite>;
-    /**
-     * Creates a new instance of `BaseError`.
-     *
-     * This constructor initializes a new `BaseError` instance by setting the error message and formatting
-     * the stack trace using the provided source map information. It also ensures the stack trace is maintained
-     * correctly by using `Error.captureStackTrace` (if available). The default source map service is used if
-     * none is provided.
-     *
-     * @param message - A descriptive error message to be associated with the error.
-     * @param sourceMap - (Optional) The `SourceService` instance used to format and resolve the stack trace.
-     *                    If not provided, the default source map service (`defaultSourceService`) is used.
-     */
-    protected constructor(message: string, sourceMap?: SourceService | undefined);
-    /**
-     * Reformats the error stack trace using source map information.
-     *
-     * This function enhances the original error stack trace by attempting to map each entry
-     * back to its original position in the source file using the provided source map service.
-     * If the source map information is not available, it returns the original stack trace.
-     *
-     * @param error - The original error with stack trace of the error.
-     * @returns The reformatted stack trace or the original stack trace if no mapping is available.
-     */
-    protected reformatStack(error: ErrorType): string;
-}
-
-/**
- * A custom error type that extends the native `Error` object by adding a `callStacks` property.
- * This property contains an array of `NodeJS.CallSite` objects, representing the call stack details.
- */
+import type { SourceService } from "@remotex-labs/xmap";
+import type { Loader, OnLoadArgs, BuildResult, OnEndResult, PluginBuild, OnLoadResult, OnResolveArgs, OnResolveResult, BuildOptions, Format, Metafile, Message, Plugin } from "esbuild";
+import type { IncomingMessage, ServerResponse } from "http";
+import type { Argv } from "yargs";
+import type { ChildProcessWithoutNullStreams } from "child_process";
+import type { OutputFile, FormatDiagnosticsHost, CompilerOptions, IScriptSnapshot, ParsedCommandLine, LanguageService, Diagnostic } from "typescript";
+import type { Context } from "vm";
 /**
  * Represents an enhanced error type that extends the built-in Error object.
  * This type adds an optional property to store call stack information.
@@ -120,7 +25,7 @@ export declare abstract class BaseError extends Error {
  * console.error(myError);
  * ```
  */
-type ErrorType = Error & {
+export type ErrorType = Error & {
     callStacks?: Array<NodeJS.CallSite>;
 };
 /**
@@ -131,7 +36,7 @@ type ErrorType = Error & {
  * @property blockCode - The block of code (if any) related to the error, or `null` if unavailable.
  * @property formattedError - A formatted string representing the error details.
  */
-interface StackTraceStateInterface {
+export interface StackTraceStateInterface {
     error: ErrorType & BaseError;
     blockCode: null | string;
     formattedError: string;
@@ -145,31 +50,12 @@ interface StackTraceStateInterface {
  * @property source - The source file path where the frame occurred.
  * @property functionName - The name of the function being executed at this frame, or an empty string if not available.
  */
-interface FrameDetailsInterface {
+export interface FrameDetailsInterface {
     line: number;
     column: number;
     source: string;
     functionName: string;
 }
-
-/**
- * Import will remove at compile time
- */
-declare const xBuildLazy: {
-    service: SourceService;
-};
-/**
- * Prepares the error stack trace for display.
- *
- * This function overrides the default stack trace preparation to provide a custom format,
- * including enhanced stack trace information and error details.
- *
- * @param error - The error object (Error or BaseError).
- * @param stackEntries - The array of stack entries from the call stack.
- * @returns The formatted stack trace as a string.
- */
-declare function formatStackTrace(error: ErrorType & BaseError, stackEntries: Array<NodeJS.CallSite>): string;
-
 /**
  * An enumeration of ANSI color codes used for text formatting in the terminal.
  *
@@ -184,7 +70,7 @@ declare function formatStackTrace(error: ErrorType & BaseError, stackEntries: Ar
  * console.log(Color.BrightPink, 'This is bright pink text', Color.Reset);
  * ```
  */
-declare const enum Colors {
+export declare const enum Colors {
     Reset = "\u001B[0m",
     Red = "\u001B[38;5;9m",
     Gray = "\u001B[38;5;243m",
@@ -228,14 +114,80 @@ declare const enum Colors {
  * console.log(plainMessage); // Output will be without color formatting
  * ```
  */
-declare function setColor(color: Colors, msg: string, activeColor?: boolean): string;
-
+export declare function setColor(color: Colors, msg: string, activeColor?: boolean): string;
+export declare const xBuildLazy: {
+    service: SourceService;
+};
+/**
+ * Prepares the error stack trace for display.
+ *
+ * This function overrides the default stack trace preparation to provide a custom format,
+ * including enhanced stack trace information and error details.
+ *
+ * @param error - The error object (Error or BaseError).
+ * @param stackEntries - The array of stack entries from the call stack.
+ * @returns The formatted stack trace as a string.
+ */
+export declare function formatStackTrace(error: ErrorType & BaseError, stackEntries: Array<NodeJS.CallSite>): string;
 /**
- * Import will remove at compile time
+ * A base class for custom errors with enhanced stack trace formatting and source code information.
+ *
+ * The `BaseError` class extends the native `Error` class, adding functionality to format the error stack
+ * trace and include details from a source map service. This is useful for debugging errors in compiled
+ * or transpiled code by providing clearer information about the source of the error.
  */
+export declare abstract class BaseError extends Error {
+    readonly sourceMap?: SourceService | undefined;
+    callStacks: Array<NodeJS.CallSite>;
+    /**
+     * Creates a new instance of `BaseError`.
+     *
+     * This constructor initializes a new `BaseError` instance by setting the error message and formatting
+     * the stack trace using the provided source map information. It also ensures the stack trace is maintained
+     * correctly by using `Error.captureStackTrace` (if available). The default source map service is used if
+     * none is provided.
+     *
+     * @param message - A descriptive error message to be associated with the error.
+     * @param sourceMap - (Optional) The `SourceService` instance used to format and resolve the stack trace.
+     *                    If not provided, the default source map service (`defaultSourceService`) is used.
+     */
+    protected constructor(message: string, sourceMap?: SourceService | undefined);
+    /**
+     * Reformats the error stack trace using source map information.
+     *
+     * This function enhances the original error stack trace by attempting to map each entry
+     * back to its original position in the source file using the provided source map service.
+     * If the source map information is not available, it returns the original stack trace.
+     *
+     * @param error - The original error with stack trace of the error.
+     * @returns The reformatted stack trace or the original stack trace if no mapping is available.
+     */
+    protected reformatStack(error: ErrorType): string;
+}
 /**
- * Imports
+ * Represents an error specific to the xBuild process.
+ *
+ * The `xBuildError` class extends the `BaseError` class to provide a custom error type for the xBuild system.
+ * It includes additional functionality to maintain stack trace information and assigns a specific name to
+ * the error, making it easier to identify and handle in different parts of the application.
+ *
+ * @augments BaseError
  */
+export declare class xBuildError extends BaseError {
+    /**
+     * Original error stack
+     */
+    originalErrorStack: string | undefined;
+    /**
+     * Creates an instance of `xBuildError`.
+     *
+     * @param message - The error message that describes the error. This message is passed to the base class
+     *   `BaseError` constructor and is used to provide context about the nature of the error.
+     * @param options - Optional configuration for the error. This can include additional properties or settings
+     *   that customize the error's behavior.
+     */
+    constructor(message: string, options?: ErrorOptions);
+}
 /**
  * A custom error class to handle errors occurring within a virtual machine (VM) execution context.
  *
@@ -256,7 +208,7 @@ declare function setColor(color: Colors, msg: string, activeColor?: boolean): st
  * }
  * ```
  */
-declare class VMRuntimeError extends BaseError {
+export declare class VMRuntimeError extends BaseError {
     /**
      * The original error thrown during the VM execution.
      */
@@ -288,73 +240,58 @@ declare class VMRuntimeError extends BaseError {
      */
     constructor(originalError: ErrorType, sourceMap?: SourceService);
 }
-
-/**
- * Exports
- */
 /**
- * Import will remove at compile time
+ * Interface for the build state that users can modify.
+ *
+ * This interface allows users to store and manage any custom data related to the build process.
+ *
+ * @template T - The type of values that can be stored in the state.
  */
+export interface PluginsBuildStateInterface {
+    [key: string]: unknown;
+}
 /**
- * Imports
+ * A type that defines the possible return values of a plugin function.
+ *
+ * The function can return a Promise that resolves to `null` or `void`, or it can return `null` or `void` directly.
  */
-import '@errors/stack.error';
-import '@errors/uncaught.error';
+export type PluginResultType = Promise<null | void> | null | void;
 /**
- * Main run function that initiates the build process based on CLI arguments.
- *
- * This function parses the CLI arguments, configures the build settings, and executes
- * the appropriate build tasks, including type checking, serving, or running in debug mode.
- *
- * @param argv - An array of strings representing the CLI arguments.
- *
- * @returns A promise that resolves when all build tasks are completed.
+ * Defines the signature of a function that is called at the end of the build process.
  *
- * @example
- * ```ts
- * await buildWithArgv(process.argv);
- * ```
+ * @param result - The `BuildResult` object that contains information about the outcome of the build process.
+ * @param state - The current build state that users can modify.
+ * @returns A `PluginResultType`, which may include asynchronous operations.
  */
-declare function buildWithArgv(argv: Array<string>): Promise<void>;
+export type OnEndType = (result: BuildResult, state: PluginsBuildStateInterface) => PluginResultType | OnEndResult | Promise<OnEndResult>;
 /**
- * Builds the project using a configuration file specified by its path.
- *
- * This function reads the configuration from the provided file path, processes it,
- * and initiates the build tasks.
- *
- * @param configFilePath - The path to the configuration file to be used for the build.
- *
- * @returns A promise that resolves to an array of `BuildResult` objects once all build tasks are completed.
- *
- * @throws Error Throws an error if the configuration file does not exist or is invalid.
+ * Defines the signature of a function that is called at the start of the build process.
  *
- * @example
- * ```ts
- * const results = await buildWithPath('./config.ts');
- * console.log('Build results:', results);
- * ```
+ * @param build - The `PluginBuild` object that contains information about the build process and allows modifying build options.
+ * @param state - The current build state that users can modify.
+ * @returns A `PluginResultType`, which may include asynchronous operations.
  */
-declare function buildWithConfigPath(configFilePath: string): Promise<BuildResult[]>;
+export type OnStartType = (build: PluginBuild, state: PluginsBuildStateInterface) => PluginResultType | OnEndResult | Promise<OnEndResult>;
 /**
- * Builds the project based on the provided configuration object.
- *
- * This function processes the given configuration and executes the build tasks accordingly.
- *
- * @param config - A partial configuration object used to define the build settings.
- *
- * @returns A promise that resolves to an array of `BuildResult` objects once all build tasks are completed.
+ * Defines the signature of a function that is called during the resolution of an import path.
  *
- * @example
- * ```ts
- * const results = await build({ entryPoints: ['./src/index.ts'] });
- * console.log('Build results:', results);
- * ```
+ * @param args - The `OnResolveArgs` object, containing information about the file being resolved, such as its path, importer, namespace, etc.
+ * @param state - The current build state that users can modify.
+ * @returns A `Promise` or a direct `OnResolveResult` which can modify the resolved path, or a `PluginResultType` for
+ * performing additional async tasks without altering resolution.
  */
-declare function build(config: PartialDeepConfigurationsType): Promise<BuildResult[]>;
-
+export type OnResolveType = (args: OnResolveArgs, state: PluginsBuildStateInterface) => Promise<OnResolveResult | PluginResultType> | OnResolveResult | PluginResultType;
 /**
- * Import will remove at compile time
+ * Defines the signature of a function that is called when a file is loaded.
+ *
+ * @param content - The content of the file being loaded, as either a `string` or `Uint8Array`.
+ * @param loader - The type of loader used for the file, such as `js`, `ts`, `json`, or others. It can also be `undefined`.
+ * @param args - The `OnLoadArgs` object, containing information about the file being loaded, such as its path, namespace, etc.
+ * @param state - The current build state that users can modify.
+ * @returns A `Promise` or direct `OnLoadResult`, which can modify the file content and loader, or a `PluginResultType`
+ * for performing additional async tasks without altering the content.
  */
+export type OnLoadType = (content: string | Uint8Array, loader: Loader | undefined, args: OnLoadArgs, state: PluginsBuildStateInterface) => Promise<OnLoadResult | PluginResultType> | OnLoadResult | PluginResultType;
 /**
  * Represents the format for specifying entry points in TypeScript declaration generation and esbuild configuration.
  *
@@ -395,7 +332,7 @@ declare function build(config: PartialDeepConfigurationsType): Promise<BuildResu
  * When used with esbuild configuration, the format determines how output files are named and structured.
  * When used for TypeScript declaration generation, it affects how declaration files are generated and organized.
  */
-type EntryPointsType = (string | {
+export type EntryPointsType = (string | {
     in: string;
     out: string;
 })[] | Record<string, string> | undefined;
@@ -444,7 +381,7 @@ type EntryPointsType = (string | {
  * // }
  * ```
  */
-type PartialDeepType<T> = {
+export type PartialDeepType<T> = {
     [P in keyof T]?: T[P] extends object ? PartialDeepType<T[P]> : T[P];
 };
 /**
@@ -464,7 +401,7 @@ type PartialDeepType<T> = {
  * @property [exports.default] - An optional default export.
  * The default export, if present, is of type `ConfigurationInterface`.
  */
-interface ModuleInterface {
+export interface ModuleInterface {
     /**
      * An object representing the exports of the module.
      * The keys are strings representing export names, and the values can be of any type.
@@ -504,7 +441,7 @@ interface ModuleInterface {
  *
  * @public
  */
-interface ServeInterface {
+export interface ServeInterface {
     port: number;
     host: string;
     active: boolean;
@@ -558,7 +495,7 @@ interface ServeInterface {
  * @see OnStartType
  * @see OnResolveType
  */
-interface HooksInterface {
+export interface HooksInterface {
     onEnd: OnEndType;
     onLoad: OnLoadType;
     onStart: OnStartType;
@@ -603,7 +540,7 @@ interface HooksInterface {
  * @public
  * @category Configuration
  */
-interface ConfigurationInterface {
+export interface ConfigurationInterface {
     /**
      * Build and run entryPoint for development
      */
@@ -737,7 +674,7 @@ interface ExportedConfigurationInterface extends ConfigurationInterface {
  * `ConfigurationInterface` are optional. It allows for flexible configuration
  * objects where only a subset of properties need to be specified.
  */
-type xBuildConfig = PartialDeepType<ExportedConfigurationInterface>;
+export type xBuildConfig = PartialDeepType<ExportedConfigurationInterface>;
 /**
  * Represents a partially deep configuration type based on the `ConfigurationInterface`.
  *
@@ -745,7 +682,7 @@ type xBuildConfig = PartialDeepType<ExportedConfigurationInterface>;
  * missing or undefined. It leverages the `PartialDeepType` utility type to allow
  * for flexibility in configuration management.
  */
-type PartialDeepConfigurationsType = PartialDeepType<ConfigurationInterface>;
+export type PartialDeepConfigurationsType = PartialDeepType<ConfigurationInterface>;
 /**
  * Defines the possible types for configurations.
  *
@@ -786,88 +723,27 @@ type PartialDeepConfigurationsType = PartialDeepType<ConfigurationInterface>;
  * ];
  * ```
  */
-type ConfigurationsType = PartialDeepConfigurationsType | Array<PartialDeepConfigurationsType>;
-export {};
-
-/**
- * Import will remove at compile time
- */
+export type ConfigurationsType = PartialDeepConfigurationsType | Array<PartialDeepConfigurationsType>;
 /**
- * Interface for the build state that users can modify.
- *
- * This interface allows users to store and manage any custom data related to the build process.
+ * Interface representing the command-line arguments for the build tool.
  *
- * @template T - The type of values that can be stored in the state.
+ * @interface ArgvInterface
+ * @property typeCheck - Flag indicating if the tool should perform type checking only.
+ * @property node - Flag indicating if the build is intended for Node.js environment.
+ * @property file - The entry file(s) to build.
+ * @property dev - List of development-related options for the build.
+ * @property debug - List of debugging-related options for the build.
+ * @property serve - Flag indicating if an HTTP server should be started for the build folder.
+ * @property outdir - The output directory for the build files.
+ * @property declaration - Flag indicating if TypeScript declaration files should be generated.
+ * @property watch - Flag indicating if the build should watch for file changes.
+ * @property config - Path to the build configuration file (JavaScript or TypeScript).
+ * @property tsconfig - Path to the TypeScript configuration file to use.
+ * @property minify - Flag indicating if the code should be minified.
+ * @property bundle - Flag indicating if the code should be bundled.
+ * @property format - Defines the formats for the build output.
  */
-interface PluginsBuildStateInterface {
-    [key: string]: unknown;
-}
-/**
- * A type that defines the possible return values of a plugin function.
- *
- * The function can return a Promise that resolves to `null` or `void`, or it can return `null` or `void` directly.
- */
-type PluginResultType = Promise<null | void> | null | void;
-/**
- * Defines the signature of a function that is called at the end of the build process.
- *
- * @param result - The `BuildResult` object that contains information about the outcome of the build process.
- * @param state - The current build state that users can modify.
- * @returns A `PluginResultType`, which may include asynchronous operations.
- */
-type OnEndType = (result: BuildResult, state: PluginsBuildStateInterface) => PluginResultType | OnEndResult | Promise<OnEndResult>;
-/**
- * Defines the signature of a function that is called at the start of the build process.
- *
- * @param build - The `PluginBuild` object that contains information about the build process and allows modifying build options.
- * @param state - The current build state that users can modify.
- * @returns A `PluginResultType`, which may include asynchronous operations.
- */
-type OnStartType = (build: PluginBuild, state: PluginsBuildStateInterface) => PluginResultType | OnEndResult | Promise<OnEndResult>;
-/**
- * Defines the signature of a function that is called during the resolution of an import path.
- *
- * @param args - The `OnResolveArgs` object, containing information about the file being resolved, such as its path, importer, namespace, etc.
- * @param state - The current build state that users can modify.
- * @returns A `Promise` or a direct `OnResolveResult` which can modify the resolved path, or a `PluginResultType` for
- * performing additional async tasks without altering resolution.
- */
-type OnResolveType = (args: OnResolveArgs, state: PluginsBuildStateInterface) => Promise<OnResolveResult | PluginResultType> | OnResolveResult | PluginResultType;
-/**
- * Defines the signature of a function that is called when a file is loaded.
- *
- * @param content - The content of the file being loaded, as either a `string` or `Uint8Array`.
- * @param loader - The type of loader used for the file, such as `js`, `ts`, `json`, or others. It can also be `undefined`.
- * @param args - The `OnLoadArgs` object, containing information about the file being loaded, such as its path, namespace, etc.
- * @param state - The current build state that users can modify.
- * @returns A `Promise` or direct `OnLoadResult`, which can modify the file content and loader, or a `PluginResultType`
- * for performing additional async tasks without altering the content.
- */
-type OnLoadType = (content: string | Uint8Array, loader: Loader | undefined, args: OnLoadArgs, state: PluginsBuildStateInterface) => Promise<OnLoadResult | PluginResultType> | OnLoadResult | PluginResultType;
-
-/**
- * Import will remove at compile time
- */
-/**
- * Interface representing the command-line arguments for the build tool.
- *
- * @interface ArgvInterface
- * @property typeCheck - Flag indicating if the tool should perform type checking only.
- * @property node - Flag indicating if the build is intended for Node.js environment.
- * @property file - The entry file(s) to build.
- * @property dev - List of development-related options for the build.
- * @property debug - List of debugging-related options for the build.
- * @property serve - Flag indicating if an HTTP server should be started for the build folder.
- * @property outdir - The output directory for the build files.
- * @property declaration - Flag indicating if TypeScript declaration files should be generated.
- * @property watch - Flag indicating if the build should watch for file changes.
- * @property config - Path to the build configuration file (JavaScript or TypeScript).
- * @property tsconfig - Path to the TypeScript configuration file to use.
- * @property minify - Flag indicating if the code should be minified.
- * @property bundle - Flag indicating if the code should be bundled.
- * @property format - Defines the formats for the build output.
- */
-interface ArgvInterface {
+export interface ArgvInterface {
     typeCheck: boolean;
     node: boolean;
     file: string;
@@ -883,36 +759,6 @@ interface ArgvInterface {
     bundle: boolean;
     format: Format;
 }
-
-/**
- * Handles uncaught exceptions in the Node.js process.
- *
- * This handler is triggered when an error is thrown that is not caught by any try-catch blocks.
- * It captures such exceptions and logs them to the console. If the exception is an instance of `Error`,
- * its string representation is logged. Otherwise, the raw error object is logged.
- *
- * This setup helps in debugging by ensuring that all uncaught exceptions are logged, providing visibility
- * into errors that might otherwise go unnoticed.
- *
- * @example
- * ```ts
- * process.on('uncaughtException', (error) => {
- *     if (error instanceof Error) {
- *         console.error(error.toString());
- *     } else {
- *         console.error(error);
- *     }
- * });
- * ```
- *
- * @throws Will log uncaught exceptions to the console.
- * Custom handling logic should be added if additional error handling or logging is required.
- */
-export {};
-
-/**
- * Import will remove at compile time
- */
 /**
  * Parses command-line arguments into an `ArgvInterface` object using `yargs`.
  *
@@ -930,414 +776,45 @@ export {};
  * console.log(args.file); // Output: the file to build
  * console.log(args.dev); // Output: true or false based on the --dev flag
  */
-declare function argvParser(argv: Array<string>): Argv<ArgvInterface>;
-
+export declare function argvParser(argv: Array<string>): Argv<ArgvInterface>;
 /**
- * Import will remove at compile time
+ * The `BuildStateInterface` extends the `PluginsBuildStateInterface` interface to include additional properties related to the build
+ * process, specifically for handling `ifdef` conditions and function removals in macros.
+ *
+ * @interface BuildStateInterface
  */
+export interface BuildStateInterface extends PluginsBuildStateInterface {
+    ifdef: Array<string>;
+    macros: {
+        removeFunctions: Set<string>;
+    };
+}
 /**
- * Manages the build process for a TypeScript project using esbuild.
+ * Custom error class to represent type-related errors.
  *
- * The `BuildService` class orchestrates the build process, including TypeScript compilation, handling of build errors,
- * and lifecycle management of the build. It can operate in various modes, such as watching for file changes or running
- * in development mode. It also provides functionality for spawning development processes and processing entry points.
+ * This class extends the built-in `Error` class to provide more specific
+ * error handling for issues related to types. It can be used to distinguish
+ * errors that occur due to type mismatches or other type-related problems
+ * in your application.
  *
- * @remarks
- * - The build process can be configured using the provided `ConfigurationInterface`.
- * - Errors related to TypeScript are handled separately and are not logged by default.
- * - The class supports various build modes, including watch mode and development mode, and handles different scenarios
- *   based on the configuration.
+ * @example
+ * ```ts
+ * throw new TypesError('Invalid type encountered.');
+ * ```
  *
- * @public
- * @category Services
+ * @augments Error
  */
-declare class BuildService {
-    private config;
-    /**
-     * Provides TypeScript-related functionality for the build process.
-     */
-    readonly typescriptModule: TypescriptModule;
-    /**
-     * Keeps track of active development processes spawned during the build.
-     * This property holds an array of `ChildProcessWithoutNullStreams` instances that represent Node.js processes spawned
-     * for running development tasks. These processes are used to handle development builds or runtime tasks and are managed
-     * by the `BuildService` class to ensure they are properly started and stopped.
-     *
-     * @remarks
-     * - The array is populated when development processes are spawned, such as when specific development files are
-     *   processed or when running in development mode.
-     * - The processes are terminated gracefully at the end of the build to avoid leaving orphaned processes running.
-     * - It is important to manage these processes correctly to avoid resource leaks and ensure proper cleanup.
-     *
-     * @see ChildProcessWithoutNullStreams
-     */
-    private activePossess;
-    /**
-     * Plugin provider
-     *
-     * @private
-     */
-    private pluginsProvider;
-    /**
-     * A mapping of output filenames to their corresponding source file paths.
-     *
-     * @remarks
-     * This property stores the entry points configuration for TypeScript compilation.
-     * - Keys represent the output filenames (with or without .d.ts extension)
-     * - Values represent the source file paths to use as entry points
-     *
-     * Used by declaration bundling operations to determine which files to process
-     * and how to name the resulting declaration outputs.
-     *
-     * @example
-     * ```ts
-     * // Example entryPoints structure
-     * {
-     *   'index': 'src/index.ts',
-     *   'components/button': 'src/components/button.ts'
-     * }
-     * ```
-     *
-     * @private
-     * @since 1.5.9
-     */
-    private readonly entryPoints;
-    /**
-     * Initializes the build service with the provided configuration.
-     *
-     * The constructor configures the TypeScript provider, suppresses esbuild logging,
-     * sets up development modes, and registers the necessary plugins.
-     *
-     * Declaration files will be output based on the following order of precedence:
-     * 1. If `declarationOutDir` is set in the configuration, it will be used.
-     * 2. If `declarationOutDir` is not provided, it will use the `outDir` value from the tsconfig.
-     * 3. If neither of the above is available, it falls back to using the `outdir` specified in the esbuild configuration.
-     *
-     * @param config - The configuration object for the build process, including esbuild and TypeScript settings.
-     */
-    constructor(config: ConfigurationInterface);
-    /**
-     * Executes the build process.
-     * This method performs the build and handles any errors that occur during the execution.
-     * If watching or development mode is enabled in the configuration, it starts watching for changes
-     * to automatically rebuild as needed.
-     * The method logs errors that are not related to TypeScript
-     * compilation issues.
-     *
-     * @returns A promise that resolves with a `BuildResult` when the build process is complete,
-     *          or `undefined` if an error occurs during execution.
-     *
-     * @throws Error Throws an error if the build process encounters issues that are not related
-     *                 to TypeScript. Such errors are logged, but the method does not rethrow them.
-     *
-     * @example
-     * ```ts
-     * import { BuildService } from './build-service';
-     *
-     * const buildService = new BuildService(config);
-     * buildService.run().then(() => {
-     *     console.log('Build process completed successfully.');
-     * }).catch((error) => {
-     *     console.error('Build process failed:', error);
-     * });
-     * ```
-     *
-     * In this example, the `run` method is invoked to execute the build process. It handles both successful
-     * completion and logs any encountered errors, allowing the user to understand the outcome of the build.
-     */
-    run(): Promise<BuildResult | void>;
-    /**
-     * Runs the build process in debug mode for the specified entry points.
-     * This method temporarily disables development and watch mode, initiates the build process, and spawns development processes
-     * for the specified entry points. If any errors occur during the build, they are handled appropriately.
-     *
-     * @param entryPoints - An array of entry point file names for which the development processes will be spawned.
-     * These entry points are matched against the build output files.
-     *
-     * @returns A `Promise<void>` that resolves when the build and process spawning have completed.
-     *
-     * @throws Handles any build-related errors using the `handleErrors` method.
-     *
-     * @remarks
-     * - The `config.dev` and `config.watch` settings are temporarily disabled to prevent development mode or file watching during the build.
-     * - The `build()` method is called to generate the necessary build outputs.
-     * - The `spawnDev` method is then invoked to spawn processes for the matching entry points.
-     * - If any errors occur during the build, they are caught and passed to the `handleErrors` method.
-     *
-     * @example
-     * ```ts
-     * const entryPoints = ['index', 'main'];
-     * await this.runDebug(entryPoints);
-     * ```
-     *
-     * In this example, the `runDebug` method runs the build process and spawns development processes for `index` and `main`.
-     *
-     * @public
-     */
-    runDebug(entryPoints: Array<string>): Promise<void>;
+export declare class TypesError extends Error {
     /**
-     * Serves the project and watches for changes.
-     * This method starts the development server using the `ServerProvider`, builds the project using esbuild,
-     * and watches for file changes to automatically rebuild as needed. It initializes the server and invokes
-     * the build process, enabling continuous development mode.
-     *
-     * @returns A promise that resolves when the server is started and the build process is complete.
-     *
-     * @throws This method catches any errors thrown during the build process and handles them using the
-     * `handleErrors` method.
-     *
-     * @example
-     * ```ts
-     * const buildService = new BuildService(config);
-     * buildService.serve().then(() => {
-     *     console.log('Server is running and watching for changes.');
-     * }).catch((error) => {
-     *     console.error('Failed to start the server:', error);
-     * });
-     * ```
+     * Creates an instance of `TypesError`.
      *
-     * In this example, the `serve` method starts the server and watches for changes. If an error occurs during
-     * the build or server startup, it is handled and logged.
-     */
-    serve(): Promise<void>;
-    /**
-     * Executes a provided asynchronous callback function within a try-catch block.
-     * This method ensures that any errors thrown during the execution of the callback
-     * are properly handled and logged. If the error appears to be an `esbuild`-related
-     * `OnEndResult` error with an array of errors, it avoids redundant logging.
-     * Otherwise, it wraps the error in a `VMRuntimeError` and logs the stack trace.
-     *
-     * @template T - The return type of the callback function, allowing flexibility
-     *               in the expected result type. Defaults to `BuildResult`.
-     *
-     * @param callback - A function that returns a `Promise<T>`, which is executed asynchronously.
-     *                   The callback is wrapped in error handling logic to catch and process any exceptions.
-     *
-     * @returns A `Promise<T | void>` that resolves with the result of the callback function if successful,
-     *          or `void` if an error was thrown and handled. This allows for optional chaining on the return value.
-     *
-     * @throws This method does not throw explicitly but will log an error message if an exception is caught
-     *         and is not an `esbuild`-related error. The error stack is logged via `VMRuntimeError` for non-esbuild errors.
-     *
-     * @example
-     * ```ts
-     * await execute(async () => {
-     *   // Perform some asynchronous operation here
-     *   return someResult;
-     * });
-     * ```
-     */
-    private execute;
-    /**
-     * Configures the development mode by ensuring that `config.dev` is set properly.
-     */
-    private configureDevelopmentMode;
-    /**
-     * Sets up the plugin's provider and registers the plugin HooksInterface.
-     */
-    private setupPlugins;
-    /**
-     * Registers the plugin HooksInterface for start, end, and load events.
-     *
-     * @param paths - The resolved path aliases.
-     * @param rootDir - The root directory for resolving paths.
-     */
-    private registerPluginHooks;
-    /**
-     * Generates a path alias object from the TypeScript provider's path options.
-     * This method processes the `paths` property from the TypeScript provider's options,
-     * which is expected to be an object where each key represents a path alias pattern,
-     * and the corresponding value is an array of paths. The method removes any wildcard
-     * characters (`*`) from both the keys and the first values of the arrays. It also
-     * resolves the paths relative to the specified `rootDir`, returning a simplified
-     * object that maps the cleaned keys to their respective paths.
-     *
-     * The resolved paths will be formatted to use a relative path notation.
-     *
-     * Example:
-     * Given the following paths:
-     * ```ts
-     * {
-     *   '@core/*': ['src/core/*'],
-     *   '@utils/*': ['src/utils/*']
-     * }
-     * ```
-     * And assuming `rootDir` is set to the base directory of your project, the method
-     * will return:
-     * ```ts
-     * {
-     *   '@core/': './core/',
-     *   '@utils/': './utils/'
-     * }
-     * ```
-     *
-     * @param rootDir - The root directory to resolve paths against.
-     * @returns An object mapping cleaned path aliases to their respective resolved paths.
-     */
-    private generatePathAlias;
-    /**
-     * Handles errors during the build process.
-     * This method processes and logs errors that occur during the esbuild process. It specifically filters out
-     * errors related to TypeScript (`TypesError`) to prevent them from being logged, while logging all other errors
-     * to the console. The error object is assumed to contain a list of messages, each with detailed information.
-     *
-     * @param esbuildError - The error object returned by esbuild, which is expected to contain an array of
-     * error messages.
-     *
-     * @private
-     *
-     * @remarks
-     * - TypeScript errors (denoted as `TypesError`) are skipped and not logged.
-     * - Other errors are logged to the console with their text descriptions.
-     *
-     * @example
-     * ```ts
-     * try {
-     *     await buildService.run();
-     * } catch (esbuildError) {
-     *     buildService.handleErrors(esbuildError);
-     * }
-     * ```
-     *
-     * In this example, if an error occurs during the build process, the `handleErrors` method is used to
-     * process and log the errors.
-     */
-    private handleErrors;
-    /**
-     * Injects a configuration object (banner or footer) into the `esbuild` options.
-     * This method will update the `esbuild` object by adding or modifying the `banner` or `footer`
-     * property based on the provided configuration.
-     * The function handles both static values
-     * and functions within the configuration.
-     *
-     * @param esbuild - The `esbuild` configuration object where the `banner` or `footer`
-     *                  should be injected or updated.
-     * @param object - The configuration object that contains the properties to inject.
-     *                 The properties can either be static values or functions.
-     * @param name - A string that determines whether the method modifies the `banner` or `footer`
-     *               property of the `esbuild` object.
-     *
-     * @returns void - This method does not return any value.
-     * It modifies the `esbuild` object directly.
-     *
-     * @throws Error - If the `object` parameter is not provided, nothing is injected.
-     *                   No action will be taken if the specific `name` property (either
-     *                   'banner' or 'footer') does not exist in the `esbuild` object.
-     */
-    private injects;
-    /**
-     * Builds the project based on the configuration.
-     * Depending on the configuration, this method either uses esbuild's `context` for watching or `build` for a one-time build.
-     *
-     * @returns A promise that resolves with the build context or result.
-     *
-     * @private
-     */
-    private build;
-    /**
-     * Manages development processes for specified entry points.*
-     * This method spawns development processes for each file in the metafile that matches any of the specified entry points.
-     * It enables features like source maps and optional debugging mode for each spawned process.
-     *
-     * @param meta - The metafile containing information about build outputs.
-     * This typically includes a mapping of output files and their dependencies.
-     * @param entryPoint - An array of entry point file names to match against the metafile outputs.
-     * Only files that match these entry points will have development processes spawned.
-     * @param debug - A boolean flag to enable debugging mode for spawned processes.
-     * If `true`, the processes will start in debug mode with the `--inspect-brk` option. Defaults to `false`.
-     *
-     * @returns void
-     *
-     * @remarks
-     * - Files that contain 'map' in their names (e.g., source map files) are ignored and no process is spawned for them.
-     * - For each matching file in the metafile outputs, a new development process is spawned using the `spawn` function.
-     * - The `activePossess` array tracks all spawned processes, allowing further management (e.g., termination).
-     *
-     * @example
-     * ```ts
-     * const meta = {
-     *   outputs: {
-     *     'dist/index.js': { \/* ... *\/ },
-     *     'dist/index.js.map': { \/* ... *\/ }
-     *   }
-     * };
-     * const entryPoints = ['index'];
-     *
-     * this.spawnDev(meta, entryPoints, true); // Spawns processes in debug mode
-     * ```
-     *
-     * @private
-     */
-    private spawnDev;
-    /**
-     * Starts the build process and type checking.
-     * This method performs initial setup for the build and ensures that any child processes are terminated properly.
-     *
-     * @private
-     */
-    private start;
-    /**
-     * Finalizes the build process and logs results.
-     * This method handles the end of the build process, logs build results, and processes development files if applicable.
-     *
-     * @private
-     */
-    private end;
-    /**
-     * Processes and updates entry points based on project dependencies.
-     * This method analyzes the project's dependencies and adjusts entry points configuration as needed.
-     *
-     * @private
-     */
-    private processEntryPoints;
-}
-
-/**
- * Import will remove at compile time
- */
-/**
- * The `BuildStateInterface` extends the `PluginsBuildStateInterface` interface to include additional properties related to the build
- * process, specifically for handling `ifdef` conditions and function removals in macros.
- *
- * @interface BuildStateInterface
- */
-interface BuildStateInterface extends PluginsBuildStateInterface {
-    ifdef: Array<string>;
-    macros: {
-        removeFunctions: Set<string>;
-    };
-}
-
-/**
- * Custom error class to represent type-related errors.
- *
- * This class extends the built-in `Error` class to provide more specific
- * error handling for issues related to types. It can be used to distinguish
- * errors that occur due to type mismatches or other type-related problems
- * in your application.
- *
- * @example
- * ```ts
- * throw new TypesError('Invalid type encountered.');
- * ```
- *
- * @augments Error
- */
-declare class TypesError extends Error {
-    /**
-     * Creates an instance of `TypesError`.
-     *
-     * @param message - A human-readable message providing details about the error.
-     * @param options - Optional configuration for the error, such as a `cause` (ECMAScript 2022+).
+     * @param message - A human-readable message providing details about the error.
+     * @param options - Optional configuration for the error, such as a `cause` (ECMAScript 2022+).
      */
     constructor(message?: string, options?: {
         cause?: Error;
     });
 }
-
-/**
- * Import will remove at compile time
- */
 /**
  * Spawns a new Node.js process to execute the provided JavaScript file, with optional debugging support.
  *
@@ -1388,101 +865,44 @@ declare class TypesError extends Error {
  * @public
  * @category Services
  */
-declare function spawn(filePath: string, debug?: boolean): ChildProcessWithoutNullStreams;
-
-/**
- * Import will remove at compile time
- */
+export declare function spawn(filePath: string, debug?: boolean): ChildProcessWithoutNullStreams;
 /**
- * The `collectFunctionNames` function analyzes the provided TypeScript code and collects the names of functions
- * that should be removed based on specific conditions. The function searches for function declarations and variable
- * declarations where the function name or variable is prefixed with `$$`, and adds these function names to the
- * `removeFunctions` set in the provided `state` object.
+ * Represents the result of transpiling a TypeScript file.
  *
- * - **Input**:
- *   - `code`: A string containing the TypeScript code to be analyzed.
- *   - `state`: An object representing the current build state, specifically the `mocks` state, which includes
- *     a `removeFunctions` set that will hold the names of functions that need to be removed.
+ * This interface defines the structure of the output returned from a TypeScript transpilation process,
+ * including the transpiled JavaScript code and the associated source map.
  *
- * - **Output**: The function does not return any value. Instead, it modifies the `removeFunctions` set inside the
- *   `state` object by adding function names that meet the criteria for removal.
+ * @property code - The transpiled JavaScript code generated from the TypeScript file.
+ * @property sourceMap - The source map associated with the transpiled JavaScript code.
  *
- * ## Error Handling:
- * - The function does not explicitly handle errors. If invalid TypeScript code is provided, `ts.createSourceFile`
- *   may throw an error, which should be handled by the caller if necessary.
+ * @remarks
+ * - The `code` property contains the JavaScript code after TypeScript transpilation.
+ * - The `sourceMap` property provides the source map that maps the transpiled JavaScript code back to the original TypeScript source.
+ * - The source map is useful for debugging as it allows developers to trace errors in the generated JavaScript back to the original TypeScript code.
  *
- * @param code - The TypeScript code as a string that will be analyzed.
- * @param state - The build state containing the `removeFunctions` set to store the names of functions to be removed.
- * @returns `void` - The function modifies the `state` directly and does not return a value.
- */
-declare function collectFunctionNames(code: string, state: BuildStateInterface['macros']): void;
-/**
- * The `collectDeclaredFunctions` function processes the provided `meta` metafile and reads each file's contents
- * to find function declarations within preprocessor directives. It uses regular expressions to match `// ifdef` and
- * `// endif` blocks in the code and collects the function names from the code inside the `ifdef` block, based on the
- * `define` configuration in the `config` object. If the condition defined in the `ifdef` is not met (i.e., not defined
- * in the `config.define`), the function names found inside the block will be collected and added to the `removeFunctions`
- * set in the `state` object.
- *
- * - **Input**:
- *   - `meta`: The `Metafile` object that contains the input files. The keys are file paths, and the values contain
- *     metadata about those files.
- *   - `config`: The configuration object containing a `define` field, which is an object of conditions that may be used
- *     in the `ifdef` blocks. If a condition in an `ifdef` block is not defined in `config.define`, the functions in
- *     that block will be collected.
- *   - `state`: The build state, specifically the `mocks` state, which includes a `removeFunctions` set that stores
- *     function names to be removed.
- *
- * - **Output**: This function does not return a value. It modifies the `removeFunctions` set within the provided `state`
- *   object by adding the names of functions found inside unprocessed `ifdef` blocks.
- *
- * ## Error Handling:
- * - If a file cannot be read due to a filesystem error, the function will throw an error.
- * - If the provided `meta` or `config` is malformed, it may result in runtime errors. The caller should ensure valid input.
- *
- * @param meta - The `Metafile` object containing the list of input files and their metadata.
- * @param config - The configuration object that defines conditions used in `ifdef` blocks.
- * @param state - The build state containing the `removeFunctions` set to store function names to be removed.
- * @returns `void` - The function modifies the `state` directly and does not return a value.
- */
-declare function collectDeclaredFunctions(meta: Metafile, config: ConfigurationInterface, state: BuildStateInterface['macros']): Promise<void>;
-/**
- * The `parseMacros` function processes TypeScript or JavaScript files to transform macros defined within the content.
- * It ensures that the build state is initialized if necessary, analyzes file dependencies, collects declared functions
- * that are marked for removal, and applies transformations to the source code based on the macros.
- * If the file's extension is not `.ts` or `.js`, the function returns `undefined`. Otherwise, it transforms the code
- * and returns the result in the specified loader format.
+ * @example
+ * ```typescript
+ * import { TranspileFileInterface } from './TranspileFileInterface';
  *
- * - **Input**:
- *   - `content`: The content of the file as a string or `Uint8Array` to be parsed.
- *   - `loader`: A string representing the loader type for transforming the code (e.g., `'ts'`, `'js'`).
- *   - `args`: The `OnLoadArgs` object containing metadata for the current loading process, including the file path.
- *   - `state`: The build state containing the `mocks` object, which includes a `removeFunctions` set that tracks
- *     functions to be removed.
- *   - `config`: The configuration object that defines how macros should be handled (e.g., conditions for macro processing).
+ * const result: TranspileFileInterface = {
+ *     code: 'console.log("Hello, world!");',
+ *     sourceMap: 'version: 3\nfile: out.js\nsources: ["file.ts"]\n'
+ * };
  *
- * - **Output**: A `Promise` that resolves to an `OnLoadResult`, `PluginResultType`, or `undefined`. If the file is
- *   of type `.ts` or `.js`, the transformed code is returned in the specified loader format (e.g., `'ts'`). If the file
- *   extension is not recognized, the function returns `undefined`.
+ * console.log(result.code); // Output: console.log("Hello, world!");
+ * console.log(result.sourceMap); // Output: version: 3\nfile: out.js\nsources: ["file.ts"]\n
+ * ```
  *
- * ## Error Handling:
- * - If the file path does not end with `.ts` or `.js`, the function returns `undefined`.
- * - If `state.mocks` is not initialized, it will be set up by analyzing the file dependencies and collecting declared functions.
- * - If any errors occur during the analysis, function collection, or transformation, the function may throw an error.
+ * In this example, the `TranspileFileInterface` is used to represent the result of transpiling a TypeScript file.
+ * The `code` contains the JavaScript code, while the `sourceMap` provides the mapping information for debugging purposes.
  *
- * @param content - The content of the file as a string or `Uint8Array` to be parsed.
- * @param loader - The loader type for transforming the code (e.g., `'ts'` or `'js'`).
- * @param args - The `OnLoadArgs` containing metadata, including the file path.
- * @param state - The build state that includes `mocks` with the `removeFunctions` set.
- * @param config - The configuration object defining how macros should be handled.
- * @returns A `Promise` that resolves to the transformed code (`OnLoadResult` or `PluginResultType`), or `undefined`
- *          if the file is not of type `.ts` or `.js`.
- */
-declare function parseMacros(content: string | Uint8Array, loader: Loader | undefined, args: OnLoadArgs, state: BuildStateInterface, config: ConfigurationInterface): Promise<OnLoadResult | PluginResultType | undefined>;
-
-/**
- * Import will remove at compile time
+ * @public
+ * @category Interfaces
  */
+export interface TranspileFileInterface {
+    code: string;
+    sourceMap: string;
+}
 /**
  * Default build options for esbuild bundler in RemoteX framework.
  *
@@ -1492,7 +912,7 @@ declare function parseMacros(content: string | Uint8Array, loader: Loader | unde
  * @public
  * @category Configuration
  */
-declare const defaultBuildOptions: BuildOptions;
+export declare const defaultBuildOptions: BuildOptions;
 /**
  * Extracts the source map from the provided data string and returns the modified code and source map separately.
  *
@@ -1506,7 +926,7 @@ declare const defaultBuildOptions: BuildOptions;
  *
  * @public
  */
-declare function extractSourceMap(dataString: string): TranspileFileInterface;
+export declare function extractSourceMap(dataString: string): TranspileFileInterface;
 /**
  * Transpiles a TypeScript file and extracts the source map.
  *
@@ -1521,7 +941,7 @@ declare function extractSourceMap(dataString: string): TranspileFileInterface;
  * @public
  * @category Services
  */
-declare function transpileFile(filePath: string, buildOptions?: BuildOptions): Promise<TranspileFileInterface>;
+export declare function transpileFile(filePath: string, buildOptions?: BuildOptions): Promise<TranspileFileInterface>;
 /**
  * The `analyzeDependencies` function analyzes the dependencies of a given entry point for a specified platform.
  * It performs a bundling operation and generates a metafile that contains detailed information about the
@@ -1554,51 +974,95 @@ declare function transpileFile(filePath: string, buildOptions?: BuildOptions): P
  * @returns A `Promise` that resolves to a `BuildResult` object along with a `metafile` containing dependency details.
  * @throws Error If the build process fails for any reason.
  */
-declare function analyzeDependencies(entryPoint: EntryPointsType, platform?: BuildOptions['platform']): Promise<BuildResult & {
+export declare function analyzeDependencies(entryPoint: EntryPointsType, platform?: BuildOptions['platform']): Promise<BuildResult & {
     metafile: Metafile;
 }>;
-
 /**
- * Represents the result of transpiling a TypeScript file.
+ * The `collectFunctionNames` function analyzes the provided TypeScript code and collects the names of functions
+ * that should be removed based on specific conditions. The function searches for function declarations and variable
+ * declarations where the function name or variable is prefixed with `$$`, and adds these function names to the
+ * `removeFunctions` set in the provided `state` object.
  *
- * This interface defines the structure of the output returned from a TypeScript transpilation process,
- * including the transpiled JavaScript code and the associated source map.
+ * - **Input**:
+ *   - `code`: A string containing the TypeScript code to be analyzed.
+ *   - `state`: An object representing the current build state, specifically the `mocks` state, which includes
+ *     a `removeFunctions` set that will hold the names of functions that need to be removed.
  *
- * @property code - The transpiled JavaScript code generated from the TypeScript file.
- * @property sourceMap - The source map associated with the transpiled JavaScript code.
+ * - **Output**: The function does not return any value. Instead, it modifies the `removeFunctions` set inside the
+ *   `state` object by adding function names that meet the criteria for removal.
  *
- * @remarks
- * - The `code` property contains the JavaScript code after TypeScript transpilation.
- * - The `sourceMap` property provides the source map that maps the transpiled JavaScript code back to the original TypeScript source.
- * - The source map is useful for debugging as it allows developers to trace errors in the generated JavaScript back to the original TypeScript code.
+ * ## Error Handling:
+ * - The function does not explicitly handle errors. If invalid TypeScript code is provided, `ts.createSourceFile`
+ *   may throw an error, which should be handled by the caller if necessary.
  *
- * @example
- * ```typescript
- * import { TranspileFileInterface } from './TranspileFileInterface';
+ * @param code - The TypeScript code as a string that will be analyzed.
+ * @param state - The build state containing the `removeFunctions` set to store the names of functions to be removed.
+ * @returns `void` - The function modifies the `state` directly and does not return a value.
+ */
+export declare function collectFunctionNames(code: string, state: BuildStateInterface['macros']): void;
+/**
+ * The `collectDeclaredFunctions` function processes the provided `meta` metafile and reads each file's contents
+ * to find function declarations within preprocessor directives. It uses regular expressions to match `// ifdef` and
+ * `// endif` blocks in the code and collects the function names from the code inside the `ifdef` block, based on the
+ * `define` configuration in the `config` object. If the condition defined in the `ifdef` is not met (i.e., not defined
+ * in the `config.define`), the function names found inside the block will be collected and added to the `removeFunctions`
+ * set in the `state` object.
  *
- * const result: TranspileFileInterface = {
- *     code: 'console.log("Hello, world!");',
- *     sourceMap: 'version: 3\nfile: out.js\nsources: ["file.ts"]\n'
- * };
+ * - **Input**:
+ *   - `meta`: The `Metafile` object that contains the input files. The keys are file paths, and the values contain
+ *     metadata about those files.
+ *   - `config`: The configuration object containing a `define` field, which is an object of conditions that may be used
+ *     in the `ifdef` blocks. If a condition in an `ifdef` block is not defined in `config.define`, the functions in
+ *     that block will be collected.
+ *   - `state`: The build state, specifically the `mocks` state, which includes a `removeFunctions` set that stores
+ *     function names to be removed.
  *
- * console.log(result.code); // Output: console.log("Hello, world!");
- * console.log(result.sourceMap); // Output: version: 3\nfile: out.js\nsources: ["file.ts"]\n
- * ```
+ * - **Output**: This function does not return a value. It modifies the `removeFunctions` set within the provided `state`
+ *   object by adding the names of functions found inside unprocessed `ifdef` blocks.
  *
- * In this example, the `TranspileFileInterface` is used to represent the result of transpiling a TypeScript file.
- * The `code` contains the JavaScript code, while the `sourceMap` provides the mapping information for debugging purposes.
+ * ## Error Handling:
+ * - If a file cannot be read due to a filesystem error, the function will throw an error.
+ * - If the provided `meta` or `config` is malformed, it may result in runtime errors. The caller should ensure valid input.
  *
- * @public
- * @category Interfaces
+ * @param meta - The `Metafile` object containing the list of input files and their metadata.
+ * @param config - The configuration object that defines conditions used in `ifdef` blocks.
+ * @param state - The build state containing the `removeFunctions` set to store function names to be removed.
+ * @returns `void` - The function modifies the `state` directly and does not return a value.
  */
-interface TranspileFileInterface {
-    code: string;
-    sourceMap: string;
-}
-
+export declare function collectDeclaredFunctions(meta: Metafile, config: ConfigurationInterface, state: BuildStateInterface['macros']): Promise<void>;
 /**
- * Import will remove at compile time
+ * The `parseMacros` function processes TypeScript or JavaScript files to transform macros defined within the content.
+ * It ensures that the build state is initialized if necessary, analyzes file dependencies, collects declared functions
+ * that are marked for removal, and applies transformations to the source code based on the macros.
+ * If the file's extension is not `.ts` or `.js`, the function returns `undefined`. Otherwise, it transforms the code
+ * and returns the result in the specified loader format.
+ *
+ * - **Input**:
+ *   - `content`: The content of the file as a string or `Uint8Array` to be parsed.
+ *   - `loader`: A string representing the loader type for transforming the code (e.g., `'ts'`, `'js'`).
+ *   - `args`: The `OnLoadArgs` object containing metadata for the current loading process, including the file path.
+ *   - `state`: The build state containing the `mocks` object, which includes a `removeFunctions` set that tracks
+ *     functions to be removed.
+ *   - `config`: The configuration object that defines how macros should be handled (e.g., conditions for macro processing).
+ *
+ * - **Output**: A `Promise` that resolves to an `OnLoadResult`, `PluginResultType`, or `undefined`. If the file is
+ *   of type `.ts` or `.js`, the transformed code is returned in the specified loader format (e.g., `'ts'`). If the file
+ *   extension is not recognized, the function returns `undefined`.
+ *
+ * ## Error Handling:
+ * - If the file path does not end with `.ts` or `.js`, the function returns `undefined`.
+ * - If `state.mocks` is not initialized, it will be set up by analyzing the file dependencies and collecting declared functions.
+ * - If any errors occur during the analysis, function collection, or transformation, the function may throw an error.
+ *
+ * @param content - The content of the file as a string or `Uint8Array` to be parsed.
+ * @param loader - The loader type for transforming the code (e.g., `'ts'` or `'js'`).
+ * @param args - The `OnLoadArgs` containing metadata, including the file path.
+ * @param state - The build state that includes `mocks` with the `removeFunctions` set.
+ * @param config - The configuration object defining how macros should be handled.
+ * @returns A `Promise` that resolves to the transformed code (`OnLoadResult` or `PluginResultType`), or `undefined`
+ *          if the file is not of type `.ts` or `.js`.
  */
+export declare function parseMacros(content: string | Uint8Array, loader: Loader | undefined, args: OnLoadArgs, state: BuildStateInterface, config: ConfigurationInterface): Promise<OnLoadResult | PluginResultType | undefined>;
 /**
  * Represents an error that occurs during the esbuild process.
  *
@@ -1609,7 +1073,7 @@ interface TranspileFileInterface {
  * @class esBuildError
  * @extends BaseError
  */
-declare class esBuildError extends BaseError {
+export declare class esBuildError extends BaseError {
     originalErrorStack?: string;
     /**
      * Creates an instance of the EsbuildError class.
@@ -1649,10 +1113,6 @@ declare class esBuildError extends BaseError {
      */
     private applyColor;
 }
-
-/**
- * Imports
- */
 /**
  * ASCII Logo and Version Information
  *
@@ -1663,8 +1123,8 @@ declare class esBuildError extends BaseError {
  *
  * The `cleanScreen` constant contains an ANSI escape code to clear the terminal screen.
  */
-declare const asciiLogo = "\n     ______       _ _     _\n     | ___ \\     (_) |   | |\n__  _| |_/ /_   _ _| | __| |\n\\ \\/ / ___ \\ | | | | |/ _` |\n >  <| |_/ / |_| | | | (_| |\n/_/\\_\\____/ \\__,_|_|_|\\__,_|\n";
-declare const cleanScreen = "\u001Bc";
+export declare const asciiLogo = "\n     ______       _ _     _\n     | ___ \\     (_) |   | |\n__  _| |_/ /_   _ _| | __| |\n\\ \\/ / ___ \\ | | | | |/ _` |\n >  <| |_/ / |_| | | | (_| |\n/_/\\_\\____/ \\__,_|_|_|\\__,_|\n";
+export declare const cleanScreen = "\u001Bc";
 /**
  * Renders the banner with the ASCII logo and version information.
  *
@@ -1697,16 +1157,12 @@ declare const cleanScreen = "\u001Bc";
  *
  * @public
  */
-declare function bannerComponent(activeColor?: boolean): string;
+export declare function bannerComponent(activeColor?: boolean): string;
 /**
  * A formatted string prefix used for logging build-related messages.
  * // todo optimize this
  */
-declare function prefix(): string;
-
-/**
- * Import will remove at compile time
- */
+export declare function prefix(): string;
 /**
  * Manages the HTTP or HTTPS server based on the provided configuration.
  *
@@ -1716,7 +1172,7 @@ declare function prefix(): string;
  *
  * @class
  */
-declare class ServerProvider {
+export declare class ServerProvider {
     /**
      * Root dir to serve
      */
@@ -1911,15 +1367,11 @@ declare class ServerProvider {
      */
     private sendError;
 }
-
-/**
- * Import will remove at compile time
- */
 /**
  * Plugin provider for esbuild that registers hooks for lifecycle events such as onStart, onEnd, onResolve, and onLoad.
  * This class allows dynamic behavior by registering multiple hooks for different stages of the build process.
  */
-declare class PluginsProvider {
+export declare class PluginsProvider {
     /**
      * Holds the build state that hooks can modify.
      */
@@ -2133,7 +1585,6 @@ declare class PluginsProvider {
      */
     private handleOnLoad;
 }
-
 /**
  * Parses and filters content based on conditional directives.
  *
@@ -2146,890 +1597,1237 @@ declare class PluginsProvider {
  * @returns The processed code contents with conditional blocks removed
  *   according to the `defines` object.
  */
-declare function parseIfDefConditionals(contents: string, defines: Record<string, unknown>): string;
-
+export declare function parseIfDefConditionals(contents: string, defines: Record<string, unknown>): string;
+/**
+ * Represents the result of a TypeScript compilation emit operation.
+ *
+ * @property outputFile - The emitted output file information,
+ *   or undefined if no file was emitted. Contains details such as file name, content,
+ *   and any related metadata.
+ *
+ * @property emitSkipped - Indicates whether the emit operation was skipped.
+ *   When true, typically indicates compilation errors prevented emission or the operation
+ *   was explicitly configured to skip emission.
+ *
+ * @remarks
+ * This interface is used to represent the result of TypeScript declaration emit operations.
+ *
+ * @since 1.5.9
+ */
+export interface EmitOutputInterface {
+    outputFile: OutputFile | undefined;
+    emitSkipped: boolean;
+}
 /**
- * Import will remove at compile time
+ * A host object that provides formatting functionality for typescript diagnostic messages
+ *
+ * @remarks
+ * This constant implements the FormatDiagnosticsHost interface from TypeScript,
+ * providing methods needed for proper diagnostic message formatting.
+ *
+ * @default Uses TypeScript's system utilities for line breaks and directory information
+ *
+ * @see FormatDiagnosticsHost - The TypeScript interface this implements
+ *
+ * @since 1.5.9
  */
+export declare const formatHost: FormatDiagnosticsHost;
 /**
- * Manages TypeScript compilation, type checking, and declaration file generation using TypeScript's
- * language service API.
+ * Header text included at the top of generated declaration bundle files
  *
  * @remarks
- * This module provides an interface to TypeScript's compiler API for performing type checking
- * and generating declaration files. It uses the language service API rather than the direct
- * compiler API for better performance with incremental compilation.
+ * This constant provides a standardized header comment that prepended to all
+ * declaration bundle files generated by the DeclarationBundlerService. The header
+ * clearly indicates that the file was automatically generated and should not be
+ * edited manually.
  *
- * @see ts.LanguageService
+ * @example
+ * ```ts
+ * const bundledContent = `${HeaderDeclarationBundle}${actualContent}`;
+ * writeFileSync('dist/index.d.ts', bundledContent);
+ * ```
+ *
+ * @since 1.5.9
+ */
+export declare const HeaderDeclarationBundle = "\n/**\n * This file was automatically generated by xBuild.\n * DO NOT EDIT MANUALLY.\n */\n ";
+/**
+ * Service that implements TypeScript's language service host interfaces required for compiler operations.
+ * This class provides the necessary methods for the TypeScript language service to interact with the
+ * file system and manage compilation resources.
+ *
+ * @remarks
+ * This service implements the TypeScript LanguageServiceHost interface, which is required
+ * for creating a TypeScript language service using ts.createLanguageService().
+ *
+ * @see ts.LanguageServiceHost
  * @see ts.createLanguageService
  *
  * @since 1.5.9
  */
-declare class TypescriptModule {
+export declare class LanguageHostService {
+    private readonly options;
     /**
-     * The root directory of the TypeScript project.
+     * Map to track file versions for detecting changes in source files.
+     * Keys are absolute file paths and values are incrementing version numbers.
+     *
      * @since 1.5.9
      */
-    readonly root: string;
+    private readonly fileVersions;
     /**
-     * Parsed TypeScript configuration from tsconfig.
+     * Creates a new language host service with TypeScript compiler options.
+     *
+     * @param options - Compiler options to use for TypeScript operations
+     *
      * @since 1.5.9
      */
-    readonly config: ParsedCommandLine;
+    constructor(options: CompilerOptions);
     /**
-     * TypeScript language service instance for compiler operations.
+     * Increments the version number of a file to indicate it has changed.
+     * Used to signal to the language service that a file needs to be reprocessed.
+     *
+     * @param touchFiles - Path to the file that has been modified
+     *
      * @since 1.5.9
      */
-    private readonly languageService;
+    touchFiles(touchFiles: string): void;
     /**
-     * Language service host that provides file system access to the language service.
+     * Checks if a file exists at the specified path.
+     * Required by the LanguageServiceHost interface.
+     *
+     * @param path - Path to check for file existence
+     * @returns True if the file exists, false otherwise
+     *
+     * @see ts.LanguageServiceHost.fileExists
      * @since 1.5.9
      */
-    private readonly languageServiceHost;
+    fileExists(path: string): boolean;
     /**
-     * Service for bundling TypeScript declaration files
-     *
-     * @remarks
-     * This service instance handles the bundling of TypeScript declaration files (.d.ts)
-     * by traversing the dependency graph starting from entry points, collecting exports,
-     * and generating single bundled declaration files.
+     * Reads the content of a file at the specified path.
+     * Required by the LanguageServiceHost interface.
      *
-     * @see DeclarationBundlerService
+     * @param path - Path to the file to read
+     * @param encoding - Optional encoding to use when reading the file
+     * @returns The content of the file as a string, or undefined if the file cannot be read
      *
+     * @see ts.LanguageServiceHost.readFile
      * @since 1.5.9
      */
-    private readonly declarationBundlerService;
+    readFile(path: string, encoding?: string): string | undefined;
     /**
-     * Creates a new TypeScript module with the specified configuration.
-     *
-     * @param tsconfigPath - Path to the tsconfig.json file
-     * @param outDir - Optional output directory to override the one in tsconfig
-     * @param fallbackOutDir - Optional fallback output directory to use if outDir is not specified in tsconfig or outDir
+     * Reads the contents of a directory with filtering options.
+     * Required by the LanguageServiceHost interface.
      *
-     * @throws Error - If the TypeScript configuration cannot be parsed
+     * @param path - Path to the directory to read
+     * @param extensions - Optional array of file extensions to filter by
+     * @param exclude - Optional array of glob patterns to exclude
+     * @param include - Optional array of glob patterns to include
+     * @param depth - Optional maximum depth to search
+     * @returns Array of file paths found in the directory
      *
+     * @see ts.LanguageServiceHost.readDirectory
      * @since 1.5.9
      */
-    constructor(tsconfigPath: string, outDir?: string, fallbackOutDir?: string);
+    readDirectory(path: string, extensions?: Array<string>, exclude?: Array<string>, include?: Array<string>, depth?: number): Array<string>;
     /**
-     * Updates the version of one or more files to indicate they have changed.
+     * Gets all subdirectories within a directory.
+     * Required by the LanguageServiceHost interface.
      *
-     * @param touchFiles - Path or array of paths to files that have been modified
+     * @param path - Path to the directory to search
+     * @returns Array of directory paths found
      *
+     * @see ts.LanguageServiceHost.getDirectories
      * @since 1.5.9
      */
-    updateFiles(touchFiles: string | Array<string>): void;
+    getDirectories(path: string): Array<string>;
     /**
-     * Performs type checking on all source files in the project.
+     * Checks if a directory exists at the specified path.
      *
-     * @returns Array of diagnostic
+     * @param path - Path to check for directory existence
+     * @returns True if the directory exists, false otherwise
      *
      * @since 1.5.9
      */
-    check(): Array<Diagnostic>;
+    directoryExists(path: string): boolean;
     /**
-     * Generates TypeScript declaration (.d.ts) files for all source files.
+     * Gets the current working directory.
+     * Required by the LanguageServiceHost interface.
      *
-     * @throws Error - If outDir is not specified in the compiler options
+     * @returns The current working directory path
      *
+     * @see ts.LanguageServiceHost.getCurrentDirectory
      * @since 1.5.9
      */
-    emitDeclarations(): void;
+    getCurrentDirectory(): string;
     /**
-     * Generates and writes bundled declaration files for specified entry points
-     *
-     * @param entryPoints - Record mapping output filenames to source file paths
+     * Gets all script file names tracked by this language host.
+     * Required by the LanguageServiceHost interface to identify the set of source files.
      *
-     * @throws Error - If the language service program is not available
-     * @throws Error - If file system operations fail during writing
+     * @returns Array of script file paths that should be included in the program
      *
-     * @remarks
-     * This method generates bundled declaration files from the provided entry points
-     * and writes them to the configured output directory. The input is a record where:
-     * - Keys represent the output filenames (with or without .d.ts extension)
-     * - Values represent the source file paths to use as entry points
+     * @see ts.LanguageServiceHost.getScriptFileNames
+     * @since 1.5.9
+     */
+    getScriptFileNames(): Array<string>;
+    /**
+     * Gets the compiler options used by this language host.
+     * Required by the LanguageServiceHost interface to configure the TypeScript compiler.
      *
-     * The method handles directory creation, ensuring all necessary parent directories
-     * exist before writing the output files. If the output filename doesn't end with
-     * '.d.ts', the extension will be appended automatically.
+     * @returns The compiler options for program creation
      *
-     * @example
-     * ```ts
-     * // Generate bundled declarations for multiple entry points
-     * typescriptModule.emitBundleDeclarations({
-     *   'index': 'src/index.ts',
-     *   'components/index': 'src/components/index.ts'
-     * });
-     * ```
+     * @see ts.LanguageServiceHost.getCompilationSettings
+     * @since 1.5.9
+     */
+    getCompilationSettings(): CompilerOptions;
+    /**
+     * Gets the default library file name for TypeScript compilation.
+     * Required by the LanguageServiceHost interface to include standard TypeScript definitions.
      *
-     * @see DeclarationBundlerService.emitBundledDeclarations
+     * @param options - Compiler options to use for determining the default library
+     * @returns Path to the default library file
      *
+     * @see ts.LanguageServiceHost.getDefaultLibFileName
      * @since 1.5.9
      */
-    emitBundleDeclarations(entryPoints: Record<string, string>): void;
+    getDefaultLibFileName(options: CompilerOptions): string;
     /**
-     * Formats TypeScript diagnostic messages into human-readable, colored strings.
+     * Gets the current version of a script file.
+     * Required by the LanguageServiceHost interface to determine if a file has changed.
      *
-     * @param diagnostics - Array of TypeScript diagnostic objects to format
-     * @returns Array of formatted diagnostic messages with location and error information
+     * @param fileName - Path to the script file
+     * @returns The version of the file as a string
      *
-     * @remarks
-     * This method transforms raw TypeScript diagnostic objects into user-friendly
-     * colored console output strings. For each diagnostic, it:
-     * - Extracts file path, line, and character position information
-     * - Formats error messages with proper indentation and coloring
-     * - Includes error codes and prefixes with consistent styling
+     * @see ts.LanguageServiceHost.getScriptVersion
+     * @since 1.5.9
+     */
+    getScriptVersion(fileName: string): string;
+    /**
+     * Gets a script snapshot for a file which represents its content.
+     * Required by the LanguageServiceHost interface to provide file content to the language service.
      *
-     * For diagnostics with file information, the output format is:
-     * `[TS] filename:line:column - error TS1234: Error message`
+     * @param fileName - Path to the script file
+     * @returns A script snapshot object or undefined if the file doesn't exist or can't be read
      *
-     * For diagnostics without file information, only the flattened message text is returned.
+     * @see ts.LanguageServiceHost.getScriptSnapshot
+     * @see ts.IScriptSnapshot
+     * @since 1.5.9
+     */
+    getScriptSnapshot(fileName: string): IScriptSnapshot | undefined;
+}
+/**
+ * Service responsible for bundling TypeScript declaration files by collecting
+ * all exports from entry points and generating a single declaration bundle
+ *
+ * @throws Error - If the language service program is not available
+ * @throws Error - If a source file cannot be found
+ *
+ * @remarks
+ * This service handles the process of bundling TypeScript declaration files (.d.ts)
+ * by traversing the dependency graph starting from specified entry points.
+ * It collects all necessary files and symbols, processes their declarations,
+ * and generates a single bundled declaration file that can be used in place
+ * of multiple individual declaration files.
+ *
+ * The service maintains a cache of processed files to improve performance
+ * when processing multiple entry points or when called multiple times.
+ *
+ * @example
+ * ```ts
+ * const bundler = new DeclarationBundlerService(config, languageService);
+ * const bundledDeclarations = bundler.emitBundledDeclarations(['src/index.ts']);
+ * writeFileSync('dist/index.d.ts', bundledDeclarations[0]);
+ * ```
+ *
+ * @see ts.LanguageService
+ * @see ts.ParsedCommandLine
+ *
+ * @since 1.5.9
+ */
+export declare class DeclarationBundlerService {
+    private readonly config;
+    private readonly languageService;
+    /**
+     * Creates a new DeclarationBundlerService instance
      *
-     * @example
-     * ```ts
-     * const ts = new TypescriptModule('tsconfig.json');
-     * const diagnostics = ts.check();
-     * const formattedMessages = ts.formatDiagnostics(diagnostics);
-     * console.log(formattedMessages.join('\n'));
-     * ```
+     * @param config - TypeScript configuration with compiler options
+     * @param languageService - TypeScript language service for compilation
      *
      * @since 1.5.9
      */
-    formatDiagnostics(diagnostics: readonly Diagnostic[]): Array<string>;
+    constructor(config: ParsedCommandLine, languageService: LanguageService);
     /**
-     * Generates TypeScript declaration file output for a specified file
-     *
-     * @param fileName - The path to the TypeScript file for which to generate declaration output
-     * @returns The result of the emit operation, including the declaration file content or an indication that emit was skipped
+     * Generates bundled declaration files for the provided entry points
      *
-     * @throws Error - When the language service fails to generate valid output
+     * @param entryPoints - Array of file paths to use as entry points
+     * @returns Array of bundled declaration content strings
      *
-     * @see ts.transform
-     * @see ts.LanguageService.getEmitOutput
+     * @remarks
+     * This method clears any existing cache and processes each entry point
+     * to generate bundled declarations. Entry points should be absolute paths
+     * to TypeScript source files.
      *
      * @since 1.5.9
      */
-    private getEmitOutput;
+    emitBundledDeclarations(entryPoints: Array<string>): Array<string>;
     /**
-     * Resolves a module specifier to its file path relative to the root directory
-     *
-     * @param specifier - The module specifier string to resolve
-     * @returns The resolved file path relative to the root directory, or undefined if resolution fails
+     * Generates a bundled declaration for a single entry point
      *
-     * @remarks
-     * This private method uses TypeScript's module resolution system to convert an import specifier
-     * into an actual file path. It specifically filters out node_modules dependencies and ensures
-     * paths are relative to the project's root directory.
+     * @param entryPath - Path to the entry point file
+     * @returns Bundled declaration content or undefined if generation fails
      *
-     * When rootDir is set to 'src' and baseUrl is set to the project root:
-     * - The method will only resolve files contained within the 'src' directory
-     * - All paths will be calculated relative to 'src', not the project root
-     * - For example, with project structure:
-     * ```text
-     *   /project-root/
-     *     ├── src/
-     *     │   ├── components/
-     *     │   │   └── button.ts
-     *     │   └── utils/
-     *     │       └── helpers.ts
-     *     └── tsconfig.json
-     * ```
-     * - A resolved path might be 'components/button.ts' relative to 'src'
-     * - This maintains proper path structure for TypeScript's internal module resolution
+     * @throws EntryPointError - When the specified entry point file cannot be found
+     * @throws CompilationError - When the TypeScript program cannot be accessed
      *
-     * @example
-     * ```ts
-     * // For a specifier like '@components/button' with rootDir='src'
-     * const relativePath = this.resolveModuleFileName('@components/button');
-     * // Might return 'components/button.ts' (relative to src/)
-     * ```
+     * @remarks
+     * This method processes a single entry point to generate a bundled declaration file.
+     * It collects all necessary files and exported symbols, processes them, and
+     * combines them into a single declaration output.
      *
-     * @see ts.resolveModuleName
+     * The method requires that the entry point file exists and is included in the
+     * TypeScript project configuration.
      *
      * @since 1.5.9
      */
-    private resolveModuleFileName;
+    private generateBundledDeclaration;
     /**
-     * Calculates the relative path from a source file to a target file in the output directory
+     * Resolves a module name to its file path
      *
-     * @param fromFile - The source file path from which the relative path is calculated
-     * @param toFile - The target file path in the output directory
-     * @returns A properly formatted relative path string that can be used in import statements
+     * @param moduleName - The module name to resolve
+     * @param containingFile - The file containing the import
+     * @param program - The TypeScript program
      *
-     * @remarks
-     * This private method computes a relative path from one file to another in the output directory,
-     * ensuring the path is properly formatted for JavaScript module imports.
+     * @returns The resolved file path or undefined if resolution fails
      *
-     * This is particularly useful when generating import statements in emitted files that
-     * need to reference other modules in the output directory structure.
+     * @since 1.5.9
+     */
+    private resolveModule;
+    /**
+     * Recursively collects all files by following imports and exports
      *
-     * @example
-     * ```ts
-     * // If fromFile is '/project/dist/components/button.js'
-     * // toFile is 'utils/helpers.js'
-     * // outDir is '/project/dist'
-     * this.getRelativePathToOutDir(fromFile, toFile);
-     * // Returns '../utils/helpers'
-     * ```
+     * @param sourceFile - The source file to process
+     * @param program - The TypeScript program
+     * @param collectedFiles - Set of collected file paths
+     *
+     * @remarks
+     * This method traverses the dependency graph starting from the provided source file
+     * and collects all files that contribute to the final bundle, excluding node_modules.
      *
      * @since 1.5.9
      */
-    private getRelativePathToOutDir;
+    private collectFilesRecursive;
     /**
-     * Creates a TypeScript transformer visitor that updates import and export paths
+     * Recursively collects exports from a module symbol
      *
-     * @param fileName - The current file being transformed
-     * @param context - The TypeScript transformation context
-     * @returns A transformer function that processes a source file
+     * @param symbol - The module symbol to process
+     * @param checker - The TypeScript type checker
+     * @param collectedSymbols - Set of collected symbol names
      *
      * @remarks
-     * This private method creates a visitor function that transforms import and export declarations
-     * in TypeScript source files. The main purpose is to rewrite module specifiers to ensure they
-     * correctly point to the compiled output files.
+     * This method collects all exported symbols from a module, including
+     * nested module exports for namespace declarations.
      *
-     * This is crucial for maintaining correct module references when TypeScript files are compiled
-     * and moved to an output directory with potentially different structure.
+     * @since 1.5.9
+     */
+    private collectExportsRecursive;
+    /**
+     * Processes all collected files and extracts their declarations
      *
-     * When rootDir is set to 'src' and baseUrl is the project root:
-     * - Module paths are resolved within the 'src' directory
-     * - The new paths will be calculated relative to each file's position in the output structure
-     * - This ensures imports continue to work correctly after compilation
+     * @param collectedFiles - Set of file paths to process
+     * @param collectedSymbols - Set of exported symbol names
+     * @returns Object containing bundled content and external imports
      *
      * @since 1.5.9
      */
-    private createVisitor;
+    private processDeclaredFiles;
     /**
-     * Parses the TypeScript configuration file.
+     * Collects all exported symbols from a source file
      *
-     * @param tsconfigPath - Path to the tsconfig.json file
-     * @param outDir - Optional output directory to override the one in tsconfig
-     * @param fallbackOutDir - Optional fallback output directory to use if outDir is not specified in tsconfig or outDir
+     * @param sourceFile - The source file to process
+     * @param checker - The TypeScript type checker
+     * @param collectedSymbols - Set to store collected symbol names
      *
-     * @returns Parsed command line object containing compiler options
+     * @since 1.5.9
+     */
+    private collectExportsFromSourceFile;
+    /**
+     * Processes a declaration file to extract its content
      *
-     * @throws Error - If the TypeScript configuration cannot be parsed
+     * @param fileName - Path to the declaration file
+     * @param collectedSymbols - Set of exported symbol names
+     * @param externalImports - Set to store external import statements
+     * @returns Processed declaration content or undefined if processing fails
+     *
+     * @remarks
+     * This method processes a single declaration file, filtering its content
+     * to include only relevant declarations and collecting external imports.
+     * It uses a cache to avoid reprocessing the same file multiple times.
      *
      * @since 1.5.9
      */
-    private parseConfig;
+    private processDeclarationFile;
     /**
-     * Creates a TypeScript language service.
+     * Checks if a line is an import or export statement with a from clause
      *
-     * @returns Language service instance
+     * @param line - The line to check
+     * @returns True if the line is an import or export with from clause
      *
-     * @see ts.createLanguageService
      * @since 1.5.9
      */
-    private createLanguageService;
+    private isImportOrExportWithFrom;
     /**
-     * Initializes diagnostic plugins for macro supports
+     * Extracts the module path from an import or export statement
+     *
+     * @param line - The import or export statement
+     * @returns The extracted module path or undefined if not found
+     *
      * @since 1.5.9
      */
-    private initializeDiagnostics;
+    private extractModulePath;
     /**
-     * Retrieves all diagnostics for a specified file.
+     * Determines if a module is external (from node_modules)
      *
-     * @param fileName - Path to the TypeScript file to analyze
-     * @returns Combined array of semantic, syntactic, and suggestion diagnostics
+     * @param modulePath - The module path to check
+     * @param fileName - The file containing the import
+     * @returns True if the module is external
      *
      * @remarks
-     * This method aggregates all three types of TypeScript diagnostics:
-     * - Semantic diagnostics (type errors, etc.)
-     * - Syntactic diagnostics (parsing errors)
-     * - Suggestion diagnostics (code improvement hints)
+     * This method determines if a module is external by checking if it's a relative
+     * or absolute path, and by resolving the module to see if it's in node_modules.
      *
-     * @see ts.LanguageService.getSemanticDiagnostics
-     * @see ts.LanguageService.getSyntacticDiagnostics
-     * @see ts.LanguageService.getSuggestionDiagnostics
+     * @since 1.5.9
+     */
+    private isExternalModule;
+    /**
+     * Processes an export line, removing 'export' if needed
+     *
+     * @param line - The export statement to process
+     * @param collectedSymbols - Set of exported symbol names
+     * @returns The processed line
+     *
+     * @remarks
+     * This method processes an export declaration line, removing the 'export'
+     * keyword if the symbol is not in the collected exports.
      *
      * @since 1.5.9
      */
-    private getDiagnostics;
-}
-
-/**
- * Import will remove at compile time
- */
-/**
- * Represents the result of a TypeScript compilation emit operation.
- *
- * @property outputFile - The emitted output file information,
- *   or undefined if no file was emitted. Contains details such as file name, content,
- *   and any related metadata.
- *
- * @property emitSkipped - Indicates whether the emit operation was skipped.
- *   When true, typically indicates compilation errors prevented emission or the operation
- *   was explicitly configured to skip emission.
- *
- * @remarks
- * This interface is used to represent the result of TypeScript declaration emit operations.
- *
- * @since 1.5.9
- */
-interface EmitOutputInterface {
-    outputFile: OutputFile | undefined;
-    emitSkipped: boolean;
+    private processExportLine;
+    /**
+     * Creates the final bundled declaration content
+     *
+     * @param externalImports - Set of external import statements
+     * @param bundledContent - Array of processed declaration content
+     * @returns The final bundled declaration content
+     *
+     * @since 1.5.9
+     */
+    private createFinalBundleContent;
 }
-
-/**
- * Import will remove at compile time
- */
-/**
- * A host object that provides formatting functionality for typescript diagnostic messages
- *
- * @remarks
- * This constant implements the FormatDiagnosticsHost interface from TypeScript,
- * providing methods needed for proper diagnostic message formatting.
- *
- * @default Uses TypeScript's system utilities for line breaks and directory information
- *
- * @see FormatDiagnosticsHost - The TypeScript interface this implements
- *
- * @since 1.5.9
- */
-declare const formatHost: FormatDiagnosticsHost;
-/**
- * Header text included at the top of generated declaration bundle files
- *
- * @remarks
- * This constant provides a standardized header comment that prepended to all
- * declaration bundle files generated by the DeclarationBundlerService. The header
- * clearly indicates that the file was automatically generated and should not be
- * edited manually.
- *
- * @example
- * ```ts
- * const bundledContent = `${HeaderDeclarationBundle}${actualContent}`;
- * writeFileSync('dist/index.d.ts', bundledContent);
- * ```
- *
- * @since 1.5.9
- */
-declare const HeaderDeclarationBundle = "\n/**\n * This file was automatically generated by xBuild.\n * DO NOT EDIT MANUALLY.\n */\n ";
-
-/**
- * Import will remove at compile time
- */
 /**
- * Service that implements TypeScript's language service host interfaces required for compiler operations.
- * This class provides the necessary methods for the TypeScript language service to interact with the
- * file system and manage compilation resources.
+ * Manages TypeScript compilation, type checking, and declaration file generation using TypeScript's
+ * language service API.
  *
  * @remarks
- * This service implements the TypeScript LanguageServiceHost interface, which is required
- * for creating a TypeScript language service using ts.createLanguageService().
+ * This module provides an interface to TypeScript's compiler API for performing type checking
+ * and generating declaration files. It uses the language service API rather than the direct
+ * compiler API for better performance with incremental compilation.
  *
- * @see ts.LanguageServiceHost
+ * @see ts.LanguageService
  * @see ts.createLanguageService
  *
  * @since 1.5.9
  */
-declare class LanguageHostService {
-    private readonly options;
+export declare class TypescriptModule {
     /**
-     * Map to track file versions for detecting changes in source files.
-     * Keys are absolute file paths and values are incrementing version numbers.
-     *
+     * The root directory of the TypeScript project.
      * @since 1.5.9
      */
-    private readonly fileVersions;
+    readonly root: string;
     /**
-     * Creates a new language host service with TypeScript compiler options.
-     *
-     * @param options - Compiler options to use for TypeScript operations
-     *
+     * Parsed TypeScript configuration from tsconfig.
      * @since 1.5.9
      */
-    constructor(options: CompilerOptions);
+    readonly config: ParsedCommandLine;
     /**
-     * Increments the version number of a file to indicate it has changed.
-     * Used to signal to the language service that a file needs to be reprocessed.
-     *
-     * @param touchFiles - Path to the file that has been modified
-     *
+     * TypeScript language service instance for compiler operations.
      * @since 1.5.9
      */
-    touchFiles(touchFiles: string): void;
+    private readonly languageService;
     /**
-     * Checks if a file exists at the specified path.
-     * Required by the LanguageServiceHost interface.
-     *
-     * @param path - Path to check for file existence
-     * @returns True if the file exists, false otherwise
-     *
-     * @see ts.LanguageServiceHost.fileExists
+     * Language service host that provides file system access to the language service.
      * @since 1.5.9
      */
-    fileExists(path: string): boolean;
+    private readonly languageServiceHost;
     /**
-     * Reads the content of a file at the specified path.
-     * Required by the LanguageServiceHost interface.
-     *
-     * @param path - Path to the file to read
-     * @param encoding - Optional encoding to use when reading the file
-     * @returns The content of the file as a string, or undefined if the file cannot be read
+     * Service for bundling TypeScript declaration files
+     *
+     * @remarks
+     * This service instance handles the bundling of TypeScript declaration files (.d.ts)
+     * by traversing the dependency graph starting from entry points, collecting exports,
+     * and generating single bundled declaration files.
+     *
+     * @see DeclarationBundlerService
      *
-     * @see ts.LanguageServiceHost.readFile
      * @since 1.5.9
      */
-    readFile(path: string, encoding?: string): string | undefined;
+    private readonly declarationBundlerService;
     /**
-     * Reads the contents of a directory with filtering options.
-     * Required by the LanguageServiceHost interface.
+     * Creates a new TypeScript module with the specified configuration.
      *
-     * @param path - Path to the directory to read
-     * @param extensions - Optional array of file extensions to filter by
-     * @param exclude - Optional array of glob patterns to exclude
-     * @param include - Optional array of glob patterns to include
-     * @param depth - Optional maximum depth to search
-     * @returns Array of file paths found in the directory
+     * @param tsconfigPath - Path to the tsconfig.json file
+     * @param outDir - Optional output directory to override the one in tsconfig
+     * @param fallbackOutDir - Optional fallback output directory to use if outDir is not specified in tsconfig or outDir
+     *
+     * @throws Error - If the TypeScript configuration cannot be parsed
      *
-     * @see ts.LanguageServiceHost.readDirectory
      * @since 1.5.9
      */
-    readDirectory(path: string, extensions?: Array<string>, exclude?: Array<string>, include?: Array<string>, depth?: number): Array<string>;
+    constructor(tsconfigPath: string, outDir?: string, fallbackOutDir?: string);
     /**
-     * Gets all subdirectories within a directory.
-     * Required by the LanguageServiceHost interface.
+     * Updates the version of one or more files to indicate they have changed.
      *
-     * @param path - Path to the directory to search
-     * @returns Array of directory paths found
+     * @param touchFiles - Path or array of paths to files that have been modified
      *
-     * @see ts.LanguageServiceHost.getDirectories
      * @since 1.5.9
      */
-    getDirectories(path: string): Array<string>;
+    updateFiles(touchFiles: string | Array<string>): void;
     /**
-     * Checks if a directory exists at the specified path.
+     * Performs type checking on all source files in the project.
      *
-     * @param path - Path to check for directory existence
-     * @returns True if the directory exists, false otherwise
+     * @returns Array of diagnostic
      *
      * @since 1.5.9
      */
-    directoryExists(path: string): boolean;
+    check(): Array<Diagnostic>;
     /**
-     * Gets the current working directory.
-     * Required by the LanguageServiceHost interface.
+     * Generates TypeScript declaration (.d.ts) files for all source files.
      *
-     * @returns The current working directory path
+     * @throws Error - If outDir is not specified in the compiler options
      *
-     * @see ts.LanguageServiceHost.getCurrentDirectory
      * @since 1.5.9
      */
-    getCurrentDirectory(): string;
+    emitDeclarations(): void;
     /**
-     * Gets all script file names tracked by this language host.
-     * Required by the LanguageServiceHost interface to identify the set of source files.
+     * Generates and writes bundled declaration files for specified entry points
      *
-     * @returns Array of script file paths that should be included in the program
+     * @param entryPoints - Record mapping output filenames to source file paths
+     *
+     * @throws Error - If the language service program is not available
+     * @throws Error - If file system operations fail during writing
+     *
+     * @remarks
+     * This method generates bundled declaration files from the provided entry points
+     * and writes them to the configured output directory. The input is a record where:
+     * - Keys represent the output filenames (with or without .d.ts extension)
+     * - Values represent the source file paths to use as entry points
+     *
+     * The method handles directory creation, ensuring all necessary parent directories
+     * exist before writing the output files. If the output filename doesn't end with
+     * '.d.ts', the extension will be appended automatically.
+     *
+     * @example
+     * ```ts
+     * // Generate bundled declarations for multiple entry points
+     * typescriptModule.emitBundleDeclarations({
+     *   'index': 'src/index.ts',
+     *   'components/index': 'src/components/index.ts'
+     * });
+     * ```
+     *
+     * @see DeclarationBundlerService.emitBundledDeclarations
      *
-     * @see ts.LanguageServiceHost.getScriptFileNames
      * @since 1.5.9
      */
-    getScriptFileNames(): Array<string>;
+    emitBundleDeclarations(entryPoints: Record<string, string>): void;
     /**
-     * Gets the compiler options used by this language host.
-     * Required by the LanguageServiceHost interface to configure the TypeScript compiler.
+     * Formats TypeScript diagnostic messages into human-readable, colored strings.
      *
-     * @returns The compiler options for program creation
+     * @param diagnostics - Array of TypeScript diagnostic objects to format
+     * @returns Array of formatted diagnostic messages with location and error information
+     *
+     * @remarks
+     * This method transforms raw TypeScript diagnostic objects into user-friendly
+     * colored console output strings. For each diagnostic, it:
+     * - Extracts file path, line, and character position information
+     * - Formats error messages with proper indentation and coloring
+     * - Includes error codes and prefixes with consistent styling
+     *
+     * For diagnostics with file information, the output format is:
+     * `[TS] filename:line:column - error TS1234: Error message`
+     *
+     * For diagnostics without file information, only the flattened message text is returned.
+     *
+     * @example
+     * ```ts
+     * const ts = new TypescriptModule('tsconfig.json');
+     * const diagnostics = ts.check();
+     * const formattedMessages = ts.formatDiagnostics(diagnostics);
+     * console.log(formattedMessages.join('\n'));
+     * ```
      *
-     * @see ts.LanguageServiceHost.getCompilationSettings
      * @since 1.5.9
      */
-    getCompilationSettings(): CompilerOptions;
+    formatDiagnostics(diagnostics: readonly Diagnostic[]): Array<string>;
     /**
-     * Gets the default library file name for TypeScript compilation.
-     * Required by the LanguageServiceHost interface to include standard TypeScript definitions.
+     * Generates TypeScript declaration file output for a specified file
      *
-     * @param options - Compiler options to use for determining the default library
-     * @returns Path to the default library file
+     * @param fileName - The path to the TypeScript file for which to generate declaration output
+     * @returns The result of the emit operation, including the declaration file content or an indication that emit was skipped
+     *
+     * @throws Error - When the language service fails to generate valid output
+     *
+     * @see ts.transform
+     * @see ts.LanguageService.getEmitOutput
      *
-     * @see ts.LanguageServiceHost.getDefaultLibFileName
      * @since 1.5.9
      */
-    getDefaultLibFileName(options: CompilerOptions): string;
+    private getEmitOutput;
     /**
-     * Gets the current version of a script file.
-     * Required by the LanguageServiceHost interface to determine if a file has changed.
+     * Resolves a module specifier to its file path relative to the root directory
      *
-     * @param fileName - Path to the script file
-     * @returns The version of the file as a string
+     * @param specifier - The module specifier string to resolve
+     * @returns The resolved file path relative to the root directory, or undefined if resolution fails
+     *
+     * @remarks
+     * This private method uses TypeScript's module resolution system to convert an import specifier
+     * into an actual file path. It specifically filters out node_modules dependencies and ensures
+     * paths are relative to the project's root directory.
+     *
+     * When rootDir is set to 'src' and baseUrl is set to the project root:
+     * - The method will only resolve files contained within the 'src' directory
+     * - All paths will be calculated relative to 'src', not the project root
+     * - For example, with project structure:
+     * ```text
+     *   /project-root/
+     *     ├── src/
+     *     │   ├── components/
+     *     │   │   └── button.ts
+     *     │   └── utils/
+     *     │       └── helpers.ts
+     *     └── tsconfig.json
+     * ```
+     * - A resolved path might be 'components/button.ts' relative to 'src'
+     * - This maintains proper path structure for TypeScript's internal module resolution
+     *
+     * @example
+     * ```ts
+     * // For a specifier like '@components/button' with rootDir='src'
+     * const relativePath = this.resolveModuleFileName('@components/button');
+     * // Might return 'components/button.ts' (relative to src/)
+     * ```
+     *
+     * @see ts.resolveModuleName
      *
-     * @see ts.LanguageServiceHost.getScriptVersion
      * @since 1.5.9
      */
-    getScriptVersion(fileName: string): string;
+    private resolveModuleFileName;
     /**
-     * Gets a script snapshot for a file which represents its content.
-     * Required by the LanguageServiceHost interface to provide file content to the language service.
+     * Calculates the relative path from a source file to a target file in the output directory
      *
-     * @param fileName - Path to the script file
-     * @returns A script snapshot object or undefined if the file doesn't exist or can't be read
+     * @param fromFile - The source file path from which the relative path is calculated
+     * @param toFile - The target file path in the output directory
+     * @returns A properly formatted relative path string that can be used in import statements
+     *
+     * @remarks
+     * This private method computes a relative path from one file to another in the output directory,
+     * ensuring the path is properly formatted for JavaScript module imports.
+     *
+     * This is particularly useful when generating import statements in emitted files that
+     * need to reference other modules in the output directory structure.
+     *
+     * @example
+     * ```ts
+     * // If fromFile is '/project/dist/components/button.js'
+     * // toFile is 'utils/helpers.js'
+     * // outDir is '/project/dist'
+     * this.getRelativePathToOutDir(fromFile, toFile);
+     * // Returns '../utils/helpers'
+     * ```
      *
-     * @see ts.LanguageServiceHost.getScriptSnapshot
-     * @see ts.IScriptSnapshot
      * @since 1.5.9
      */
-    getScriptSnapshot(fileName: string): IScriptSnapshot | undefined;
+    private getRelativePathToOutDir;
+    /**
+     * Creates a TypeScript transformer visitor that updates import and export paths
+     *
+     * @param fileName - The current file being transformed
+     * @param context - The TypeScript transformation context
+     * @returns A transformer function that processes a source file
+     *
+     * @remarks
+     * This private method creates a visitor function that transforms import and export declarations
+     * in TypeScript source files. The main purpose is to rewrite module specifiers to ensure they
+     * correctly point to the compiled output files.
+     *
+     * This is crucial for maintaining correct module references when TypeScript files are compiled
+     * and moved to an output directory with potentially different structure.
+     *
+     * When rootDir is set to 'src' and baseUrl is the project root:
+     * - Module paths are resolved within the 'src' directory
+     * - The new paths will be calculated relative to each file's position in the output structure
+     * - This ensures imports continue to work correctly after compilation
+     *
+     * @since 1.5.9
+     */
+    private createVisitor;
+    /**
+     * Parses the TypeScript configuration file.
+     *
+     * @param tsconfigPath - Path to the tsconfig.json file
+     * @param outDir - Optional output directory to override the one in tsconfig
+     * @param fallbackOutDir - Optional fallback output directory to use if outDir is not specified in tsconfig or outDir
+     *
+     * @returns Parsed command line object containing compiler options
+     *
+     * @throws Error - If the TypeScript configuration cannot be parsed
+     *
+     * @since 1.5.9
+     */
+    private parseConfig;
+    /**
+     * Creates a TypeScript language service.
+     *
+     * @returns Language service instance
+     *
+     * @see ts.createLanguageService
+     * @since 1.5.9
+     */
+    private createLanguageService;
+    /**
+     * Initializes diagnostic plugins for macro supports
+     * @since 1.5.9
+     */
+    private initializeDiagnostics;
+    /**
+     * Retrieves all diagnostics for a specified file.
+     *
+     * @param fileName - Path to the TypeScript file to analyze
+     * @returns Combined array of semantic, syntactic, and suggestion diagnostics
+     *
+     * @remarks
+     * This method aggregates all three types of TypeScript diagnostics:
+     * - Semantic diagnostics (type errors, etc.)
+     * - Syntactic diagnostics (parsing errors)
+     * - Suggestion diagnostics (code improvement hints)
+     *
+     * @see ts.LanguageService.getSemanticDiagnostics
+     * @see ts.LanguageService.getSyntacticDiagnostics
+     * @see ts.LanguageService.getSuggestionDiagnostics
+     *
+     * @since 1.5.9
+     */
+    private getDiagnostics;
 }
-
 /**
- * Import will remove at compile time
+ * Resolves path aliases in the provided content based on the specified paths and root directory.
+ *
+ * This function takes a string of content and replaces occurrences of defined path alias keys
+ * with their corresponding relative paths derived from the specified source file and root directory.
+ * It ensures that the resulting paths are relative to the directory of the source file and formatted
+ * correctly for use in a JavaScript/TypeScript environment.
+ *
+ * Example:
+ * Given the following inputs:
+ * ```ts
+ * const content = "import { foo } from '@core/foo';";
+ * const sourceFile = "/project/src/index.ts";
+ * const paths = {
+ *   '@core/': 'src/core',
+ *   '@utils/': 'src/utils'
+ * };
+ * const rootDir = "/project";
+ * ```
+ * The function will replace `@core/foo` with a relative path based on the source file's location,
+ * potentially resulting in:
+ * ```ts
+ * const content = "import { foo } from './core/foo';";
+ * ```
+ *
+ * @param content - The content in which path aliases need to be resolved.
+ * @param sourceFile - The path of the source file from which relative paths will be calculated.
+ * @param paths - An object mapping path alias keys to their corresponding paths.
+ * @param esm -  A flag indicating whether ESM is enabled.
+ * @returns The updated content with resolved path aliases.
  */
+export declare function resolveAliasPlugin(content: string, sourceFile: string, paths: Record<string, string>, esm: boolean): string;
 /**
- * Service responsible for bundling TypeScript declaration files by collecting
- * all exports from entry points and generating a single declaration bundle
+ * Maps an array of file paths to an object where the keys are filenames (without extensions)
+ * and the values are the corresponding file paths.
  *
- * @throws Error - If the language service program is not available
- * @throws Error - If a source file cannot be found
+ * Each key in the resulting object is derived from the filename by removing the file extension.
+ * For example, given a file path `src/index.ts`, the key in the resulting object will be `src/index`.
  *
- * @remarks
- * This service handles the process of bundling TypeScript declaration files (.d.ts)
- * by traversing the dependency graph starting from specified entry points.
- * It collects all necessary files and symbols, processes their declarations,
- * and generates a single bundled declaration file that can be used in place
- * of multiple individual declaration files.
+ * @param filePaths - An array of file paths to map. Each file path should be a string.
+ * @returns An object where the keys are filenames (without extensions) and the values are the corresponding file paths.
  *
- * The service maintains a cache of processed files to improve performance
- * when processing multiple entry points or when called multiple times.
+ * @example
+ * ```ts
+ * const filePaths = ['src/index.ts', 'src/utils.ts'];
+ * const result = mapFilePathsToNames(filePaths);
+ * console.log(result);
+ * // Output: {
+ * //   'src/index': 'src/index.ts',
+ * //   'src/utils': 'src/utils.ts'
+ * // }
+ * ```
+ */
+export declare function mapFilePathsToNames(filePaths: Array<string>): Record<string, string>;
+/**
+ * Extracts and returns an object mapping output file paths to input file paths from the provided `EntryPointsType` object.
+ *
+ * This function handles multiple formats of entry points, including:
+ * - An array of strings representing file paths.
+ * - An array of objects containing `in` and `out` properties, where `in` is the input file path and `out` is the output file path.
+ * - A `Record<string, string>` where the keys represent input file paths and the values represent output file paths.
+ *
+ * Depending on the format, the function constructs an object with the output file paths as keys and the input file paths as values.
+ * If the output path is not available, the filename (without extension) is used as the key.
+ *
+ * If a regular object with string keys and values (not in the supported formats) is provided, it will be returned as is.
+ *
+ * @param entryPoints - The entry points to extract from, which can be in different formats: an array of strings,
+ * an array of objects with `in` and `out` properties, or a `Record<string, string>`.
+ *
+ * @returns An object mapping output file paths to input file paths, or filename (without extension) to file path.
+ *
+ * @throws Will throw an `Error` if the entry points format is unsupported.
  *
  * @example
  * ```ts
- * const bundler = new DeclarationBundlerService(config, languageService);
- * const bundledDeclarations = bundler.emitBundledDeclarations(['src/index.ts']);
- * writeFileSync('dist/index.d.ts', bundledDeclarations[0]);
+ * const entryPoints = extractEntryPoints(['src/index.ts', 'src/utils.ts']);
+ * console.log(entryPoints); // { 'index': 'src/index.ts', 'utils': 'src/utils.ts' }
  * ```
  *
- * @see ts.LanguageService
- * @see ts.ParsedCommandLine
+ * @example
+ * ```ts
+ * const entryPoints = extractEntryPoints([{ in: 'src/index.ts', out: 'dist/index.js' }]);
+ * console.log(entryPoints); // { 'dist/index.js': 'src/index.ts' }
+ * ```
  *
- * @since 1.5.9
+ * @example
+ * ```ts
+ * const entryPoints = extractEntryPoints({ index: 'src/index.ts', index2: 'dist/index2.js' });
+ * console.log(entryPoints); // { index: 'src/index.ts', index2: 'dist/index2.js' }
+ * ```
  */
-declare class DeclarationBundlerService {
-    private readonly config;
-    private readonly languageService;
+export declare function extractEntryPoints(entryPoints: EntryPointsType): Record<string, string>;
+/**
+ * Generates a `package.json` file with the appropriate `type` field
+ * based on the format specified in the configuration.
+ *
+ * - If the format is `esm`, the `type` will be set to `"module"`.
+ * - If the format is `cjs`, the `type` will be set to `"commonjs"`.
+ *
+ * The function will ensure that the specified output directory exists, and if it doesn't,
+ * it will create the necessary directories before writing the `package.json` file.
+ *
+ * @param config - The build configuration object containing
+ * esbuild-related settings, such as the format (`format`).
+ *
+ * - `config.esbuild.format`: The module format, either `'esm'` or `'cjs'`, that determines the `type` field.
+ *
+ * @throws Will throw an error if there is a problem creating the directory or writing the file.
+ *
+ * Example usage:
+ *
+ * ```ts
+ * const config = {
+ *   esbuild: {
+ *     format: 'esm'
+ *   }
+ * };
+ * packageTypeComponent(config);
+ * // This will create 'dist/package.json' with the content: {"type": "module"}
+ * ```
+ */
+export declare function packageTypeComponent(config: ConfigurationInterface): void;
+/**
+ * Manages the build process for a TypeScript project using esbuild.
+ *
+ * The `BuildService` class orchestrates the build process, including TypeScript compilation, handling of build errors,
+ * and lifecycle management of the build. It can operate in various modes, such as watching for file changes or running
+ * in development mode. It also provides functionality for spawning development processes and processing entry points.
+ *
+ * @remarks
+ * - The build process can be configured using the provided `ConfigurationInterface`.
+ * - Errors related to TypeScript are handled separately and are not logged by default.
+ * - The class supports various build modes, including watch mode and development mode, and handles different scenarios
+ *   based on the configuration.
+ *
+ * @public
+ * @category Services
+ */
+export declare class BuildService {
+    private config;
+    /**
+     * Provides TypeScript-related functionality for the build process.
+     */
+    readonly typescriptModule: TypescriptModule;
     /**
-     * Cache of processed declaration files to avoid redundant processing
+     * Keeps track of active development processes spawned during the build.
+     * This property holds an array of `ChildProcessWithoutNullStreams` instances that represent Node.js processes spawned
+     * for running development tasks. These processes are used to handle development builds or runtime tasks and are managed
+     * by the `BuildService` class to ensure they are properly started and stopped.
      *
-     * @since 1.5.9
+     * @remarks
+     * - The array is populated when development processes are spawned, such as when specific development files are
+     *   processed or when running in development mode.
+     * - The processes are terminated gracefully at the end of the build to avoid leaving orphaned processes running.
+     * - It is important to manage these processes correctly to avoid resource leaks and ensure proper cleanup.
+     *
+     * @see ChildProcessWithoutNullStreams
      */
-    private readonly processedFiles;
+    private activePossess;
     /**
-     * Creates a new DeclarationBundlerService instance
+     * Plugin provider
      *
-     * @param config - TypeScript configuration with compiler options
-     * @param languageService - TypeScript language service for compilation
+     * @private
+     */
+    private pluginsProvider;
+    /**
+     * A mapping of output filenames to their corresponding source file paths.
+     *
+     * @remarks
+     * This property stores the entry points configuration for TypeScript compilation.
+     * - Keys represent the output filenames (with or without .d.ts extension)
+     * - Values represent the source file paths to use as entry points
+     *
+     * Used by declaration bundling operations to determine which files to process
+     * and how to name the resulting declaration outputs.
+     *
+     * @example
+     * ```ts
+     * // Example entryPoints structure
+     * {
+     *   'index': 'src/index.ts',
+     *   'components/button': 'src/components/button.ts'
+     * }
+     * ```
      *
+     * @private
      * @since 1.5.9
      */
-    constructor(config: ParsedCommandLine, languageService: LanguageService);
+    private readonly entryPoints;
     /**
-     * Generates bundled declaration files for the provided entry points
+     * Initializes the build service with the provided configuration.
      *
-     * @param entryPoints - Array of file paths to use as entry points
-     * @returns Array of bundled declaration content strings
+     * The constructor configures the TypeScript provider, suppresses esbuild logging,
+     * sets up development modes, and registers the necessary plugins.
      *
-     * @remarks
-     * This method clears any existing cache and processes each entry point
-     * to generate bundled declarations. Entry points should be absolute paths
-     * to TypeScript source files.
+     * Declaration files will be output based on the following order of precedence:
+     * 1. If `declarationOutDir` is set in the configuration, it will be used.
+     * 2. If `declarationOutDir` is not provided, it will use the `outDir` value from the tsconfig.
+     * 3. If neither of the above is available, it falls back to using the `outdir` specified in the esbuild configuration.
+     *
+     * @param config - The configuration object for the build process, including esbuild and TypeScript settings.
+     */
+    constructor(config: ConfigurationInterface);
+    /**
+     * Executes the build process.
+     * This method performs the build and handles any errors that occur during the execution.
+     * If watching or development mode is enabled in the configuration, it starts watching for changes
+     * to automatically rebuild as needed.
+     * The method logs errors that are not related to TypeScript
+     * compilation issues.
+     *
+     * @returns A promise that resolves with a `BuildResult` when the build process is complete,
+     *          or `undefined` if an error occurs during execution.
+     *
+     * @throws Error Throws an error if the build process encounters issues that are not related
+     *                 to TypeScript. Such errors are logged, but the method does not rethrow them.
+     *
+     * @example
+     * ```ts
+     * import { BuildService } from './build-service';
+     *
+     * const buildService = new BuildService(config);
+     * buildService.run().then(() => {
+     *     console.log('Build process completed successfully.');
+     * }).catch((error) => {
+     *     console.error('Build process failed:', error);
+     * });
+     * ```
      *
-     * @since 1.5.9
+     * In this example, the `run` method is invoked to execute the build process. It handles both successful
+     * completion and logs any encountered errors, allowing the user to understand the outcome of the build.
      */
-    emitBundledDeclarations(entryPoints: Array<string>): Array<string>;
+    run(): Promise<BuildResult | void>;
     /**
-     * Generates a bundled declaration for a single entry point
+     * Runs the build process in debug mode for the specified entry points.
+     * This method temporarily disables development and watch mode, initiates the build process, and spawns development processes
+     * for the specified entry points. If any errors occur during the build, they are handled appropriately.
      *
-     * @param entryPath - Path to the entry point file
-     * @returns Bundled declaration content or undefined if generation fails
+     * @param entryPoints - An array of entry point file names for which the development processes will be spawned.
+     * These entry points are matched against the build output files.
      *
-     * @throws EntryPointError - When the specified entry point file cannot be found
-     * @throws CompilationError - When the TypeScript program cannot be accessed
+     * @returns A `Promise<void>` that resolves when the build and process spawning have completed.
+     *
+     * @throws Handles any build-related errors using the `handleErrors` method.
      *
      * @remarks
-     * This method processes a single entry point to generate a bundled declaration file.
-     * It collects all necessary files and exported symbols, processes them, and
-     * combines them into a single declaration output.
+     * - The `config.dev` and `config.watch` settings are temporarily disabled to prevent development mode or file watching during the build.
+     * - The `build()` method is called to generate the necessary build outputs.
+     * - The `spawnDev` method is then invoked to spawn processes for the matching entry points.
+     * - If any errors occur during the build, they are caught and passed to the `handleErrors` method.
      *
-     * The method requires that the entry point file exists and is included in the
-     * TypeScript project configuration.
+     * @example
+     * ```ts
+     * const entryPoints = ['index', 'main'];
+     * await this.runDebug(entryPoints);
+     * ```
      *
-     * @since 1.5.9
+     * In this example, the `runDebug` method runs the build process and spawns development processes for `index` and `main`.
+     *
+     * @public
      */
-    private generateBundledDeclaration;
+    runDebug(entryPoints: Array<string>): Promise<void>;
     /**
-     * Resolves a module name to its file path
+     * Serves the project and watches for changes.
+     * This method starts the development server using the `ServerProvider`, builds the project using esbuild,
+     * and watches for file changes to automatically rebuild as needed. It initializes the server and invokes
+     * the build process, enabling continuous development mode.
      *
-     * @param moduleName - The module name to resolve
-     * @param containingFile - The file containing the import
-     * @param program - The TypeScript program
+     * @returns A promise that resolves when the server is started and the build process is complete.
      *
-     * @returns The resolved file path or undefined if resolution fails
+     * @throws This method catches any errors thrown during the build process and handles them using the
+     * `handleErrors` method.
      *
-     * @since 1.5.9
+     * @example
+     * ```ts
+     * const buildService = new BuildService(config);
+     * buildService.serve().then(() => {
+     *     console.log('Server is running and watching for changes.');
+     * }).catch((error) => {
+     *     console.error('Failed to start the server:', error);
+     * });
+     * ```
+     *
+     * In this example, the `serve` method starts the server and watches for changes. If an error occurs during
+     * the build or server startup, it is handled and logged.
      */
-    private resolveModule;
+    serve(): Promise<void>;
     /**
-     * Recursively collects all files by following imports and exports
-     *
-     * @param sourceFile - The source file to process
-     * @param program - The TypeScript program
-     * @param collectedFiles - Set of collected file paths
+     * Executes a provided asynchronous callback function within a try-catch block.
+     * This method ensures that any errors thrown during the execution of the callback
+     * are properly handled and logged. If the error appears to be an `esbuild`-related
+     * `OnEndResult` error with an array of errors, it avoids redundant logging.
+     * Otherwise, it wraps the error in a `VMRuntimeError` and logs the stack trace.
      *
-     * @remarks
-     * This method traverses the dependency graph starting from the provided source file
-     * and collects all files that contribute to the final bundle, excluding node_modules.
+     * @template T - The return type of the callback function, allowing flexibility
+     *               in the expected result type. Defaults to `BuildResult`.
      *
-     * @since 1.5.9
-     */
-    private collectFilesRecursive;
-    /**
-     * Recursively collects exports from a module symbol
+     * @param callback - A function that returns a `Promise<T>`, which is executed asynchronously.
+     *                   The callback is wrapped in error handling logic to catch and process any exceptions.
      *
-     * @param symbol - The module symbol to process
-     * @param checker - The TypeScript type checker
-     * @param collectedSymbols - Set of collected symbol names
+     * @returns A `Promise<T | void>` that resolves with the result of the callback function if successful,
+     *          or `void` if an error was thrown and handled. This allows for optional chaining on the return value.
      *
-     * @remarks
-     * This method collects all exported symbols from a module, including
-     * nested module exports for namespace declarations.
+     * @throws This method does not throw explicitly but will log an error message if an exception is caught
+     *         and is not an `esbuild`-related error. The error stack is logged via `VMRuntimeError` for non-esbuild errors.
      *
-     * @since 1.5.9
+     * @example
+     * ```ts
+     * await execute(async () => {
+     *   // Perform some asynchronous operation here
+     *   return someResult;
+     * });
+     * ```
      */
-    private collectExportsRecursive;
+    private execute;
     /**
-     * Processes all collected files and extracts their declarations
-     *
-     * @param collectedFiles - Set of file paths to process
-     * @param collectedSymbols - Set of exported symbol names
-     * @returns Object containing bundled content and external imports
+     * Configures the development mode by ensuring that `config.dev` is set properly.
+     */
+    private configureDevelopmentMode;
+    /**
+     * Sets up the plugin's provider and registers the plugin HooksInterface.
+     */
+    private setupPlugins;
+    /**
+     * Registers the plugin HooksInterface for start, end, and load events.
      *
-     * @since 1.5.9
+     * @param paths - The resolved path aliases.
+     * @param rootDir - The root directory for resolving paths.
      */
-    private processDeclaredFiles;
+    private registerPluginHooks;
     /**
-     * Collects all exported symbols from a source file
+     * Generates a path alias object from the TypeScript provider's path options.
+     * This method processes the `paths` property from the TypeScript provider's options,
+     * which is expected to be an object where each key represents a path alias pattern,
+     * and the corresponding value is an array of paths. The method removes any wildcard
+     * characters (`*`) from both the keys and the first values of the arrays. It also
+     * resolves the paths relative to the specified `rootDir`, returning a simplified
+     * object that maps the cleaned keys to their respective paths.
      *
-     * @param sourceFile - The source file to process
-     * @param checker - The TypeScript type checker
-     * @param collectedSymbols - Set to store collected symbol names
+     * The resolved paths will be formatted to use a relative path notation.
      *
-     * @since 1.5.9
+     * Example:
+     * Given the following paths:
+     * ```ts
+     * {
+     *   '@core/*': ['src/core/*'],
+     *   '@utils/*': ['src/utils/*']
+     * }
+     * ```
+     * And assuming `rootDir` is set to the base directory of your project, the method
+     * will return:
+     * ```ts
+     * {
+     *   '@core/': './core/',
+     *   '@utils/': './utils/'
+     * }
+     * ```
+     *
+     * @param rootDir - The root directory to resolve paths against.
+     * @returns An object mapping cleaned path aliases to their respective resolved paths.
      */
-    private collectExportsFromSourceFile;
+    private generatePathAlias;
     /**
-     * Processes a declaration file to extract its content
+     * Handles errors during the build process.
+     * This method processes and logs errors that occur during the esbuild process. It specifically filters out
+     * errors related to TypeScript (`TypesError`) to prevent them from being logged, while logging all other errors
+     * to the console. The error object is assumed to contain a list of messages, each with detailed information.
      *
-     * @param fileName - Path to the declaration file
-     * @param collectedSymbols - Set of exported symbol names
-     * @param externalImports - Set to store external import statements
-     * @returns Processed declaration content or undefined if processing fails
+     * @param esbuildError - The error object returned by esbuild, which is expected to contain an array of
+     * error messages.
+     *
+     * @private
      *
      * @remarks
-     * This method processes a single declaration file, filtering its content
-     * to include only relevant declarations and collecting external imports.
-     * It uses a cache to avoid reprocessing the same file multiple times.
+     * - TypeScript errors (denoted as `TypesError`) are skipped and not logged.
+     * - Other errors are logged to the console with their text descriptions.
      *
-     * @since 1.5.9
+     * @example
+     * ```ts
+     * try {
+     *     await buildService.run();
+     * } catch (esbuildError) {
+     *     buildService.handleErrors(esbuildError);
+     * }
+     * ```
+     *
+     * In this example, if an error occurs during the build process, the `handleErrors` method is used to
+     * process and log the errors.
      */
-    private processDeclarationFile;
+    private handleErrors;
     /**
-     * Checks if a line is an import or export statement with a from clause
+     * Injects a configuration object (banner or footer) into the `esbuild` options.
+     * This method will update the `esbuild` object by adding or modifying the `banner` or `footer`
+     * property based on the provided configuration.
+     * The function handles both static values
+     * and functions within the configuration.
      *
-     * @param line - The line to check
-     * @returns True if the line is an import or export with from clause
+     * @param esbuild - The `esbuild` configuration object where the `banner` or `footer`
+     *                  should be injected or updated.
+     * @param object - The configuration object that contains the properties to inject.
+     *                 The properties can either be static values or functions.
+     * @param name - A string that determines whether the method modifies the `banner` or `footer`
+     *               property of the `esbuild` object.
      *
-     * @since 1.5.9
+     * @returns void - This method does not return any value.
+     * It modifies the `esbuild` object directly.
+     *
+     * @throws Error - If the `object` parameter is not provided, nothing is injected.
+     *                   No action will be taken if the specific `name` property (either
+     *                   'banner' or 'footer') does not exist in the `esbuild` object.
      */
-    private isImportOrExportWithFrom;
+    private injects;
     /**
-     * Extracts the module path from an import or export statement
+     * Builds the project based on the configuration.
+     * Depending on the configuration, this method either uses esbuild's `context` for watching or `build` for a one-time build.
      *
-     * @param line - The import or export statement
-     * @returns The extracted module path or undefined if not found
+     * @returns A promise that resolves with the build context or result.
      *
-     * @since 1.5.9
+     * @private
      */
-    private extractModulePath;
+    private build;
     /**
-     * Determines if a module is external (from node_modules)
+     * Manages development processes for specified entry points.*
+     * This method spawns development processes for each file in the metafile that matches any of the specified entry points.
+     * It enables features like source maps and optional debugging mode for each spawned process.
      *
-     * @param modulePath - The module path to check
-     * @param fileName - The file containing the import
-     * @returns True if the module is external
+     * @param meta - The metafile containing information about build outputs.
+     * This typically includes a mapping of output files and their dependencies.
+     * @param entryPoint - An array of entry point file names to match against the metafile outputs.
+     * Only files that match these entry points will have development processes spawned.
+     * @param debug - A boolean flag to enable debugging mode for spawned processes.
+     * If `true`, the processes will start in debug mode with the `--inspect-brk` option. Defaults to `false`.
+     *
+     * @returns void
      *
      * @remarks
-     * This method determines if a module is external by checking if it's a relative
-     * or absolute path, and by resolving the module to see if it's in node_modules.
+     * - Files that contain 'map' in their names (e.g., source map files) are ignored and no process is spawned for them.
+     * - For each matching file in the metafile outputs, a new development process is spawned using the `spawn` function.
+     * - The `activePossess` array tracks all spawned processes, allowing further management (e.g., termination).
+     *
+     * @example
+     * ```ts
+     * const meta = {
+     *   outputs: {
+     *     'dist/index.js': { \/* ... *\/ },
+     *     'dist/index.js.map': { \/* ... *\/ }
+     *   }
+     * };
+     * const entryPoints = ['index'];
+     *
+     * this.spawnDev(meta, entryPoints, true); // Spawns processes in debug mode
+     * ```
      *
-     * @since 1.5.9
+     * @private
      */
-    private isExternalModule;
+    private spawnDev;
     /**
-     * Processes an export line, removing 'export' if needed
-     *
-     * @param line - The export statement to process
-     * @param collectedSymbols - Set of exported symbol names
-     * @returns The processed line
-     *
-     * @remarks
-     * This method processes an export declaration line, removing the 'export'
-     * keyword if the symbol is not in the collected exports.
+     * Starts the build process and type checking.
+     * This method performs initial setup for the build and ensures that any child processes are terminated properly.
      *
-     * @since 1.5.9
+     * @private
      */
-    private processExportLine;
+    private start;
     /**
-     * Creates the final bundled declaration content
+     * Finalizes the build process and logs results.
+     * This method handles the end of the build process, logs build results, and processes development files if applicable.
      *
-     * @param externalImports - Set of external import statements
-     * @param bundledContent - Array of processed declaration content
-     * @returns The final bundled declaration content
+     * @private
+     */
+    private end;
+    /**
+     * Processes and updates entry points based on project dependencies.
+     * This method analyzes the project's dependencies and adjusts entry points configuration as needed.
      *
-     * @since 1.5.9
+     * @private
      */
-    private createFinalBundleContent;
+    private processEntryPoints;
 }
-
-/**
- * Imports
- */
-/**
- * Resolves path aliases in the provided content based on the specified paths and root directory.
- *
- * This function takes a string of content and replaces occurrences of defined path alias keys
- * with their corresponding relative paths derived from the specified source file and root directory.
- * It ensures that the resulting paths are relative to the directory of the source file and formatted
- * correctly for use in a JavaScript/TypeScript environment.
- *
- * Example:
- * Given the following inputs:
- * ```ts
- * const content = "import { foo } from '@core/foo';";
- * const sourceFile = "/project/src/index.ts";
- * const paths = {
- *   '@core/': 'src/core',
- *   '@utils/': 'src/utils'
- * };
- * const rootDir = "/project";
- * ```
- * The function will replace `@core/foo` with a relative path based on the source file's location,
- * potentially resulting in:
- * ```ts
- * const content = "import { foo } from './core/foo';";
- * ```
- *
- * @param content - The content in which path aliases need to be resolved.
- * @param sourceFile - The path of the source file from which relative paths will be calculated.
- * @param paths - An object mapping path alias keys to their corresponding paths.
- * @param esm -  A flag indicating whether ESM is enabled.
- * @returns The updated content with resolved path aliases.
- */
-declare function resolveAliasPlugin(content: string, sourceFile: string, paths: Record<string, string>, esm: boolean): string;
-
-/**
- * Import will remove at compile time
- */
-/**
- * Maps an array of file paths to an object where the keys are filenames (without extensions)
- * and the values are the corresponding file paths.
- *
- * Each key in the resulting object is derived from the filename by removing the file extension.
- * For example, given a file path `src/index.ts`, the key in the resulting object will be `src/index`.
- *
- * @param filePaths - An array of file paths to map. Each file path should be a string.
- * @returns An object where the keys are filenames (without extensions) and the values are the corresponding file paths.
- *
- * @example
- * ```ts
- * const filePaths = ['src/index.ts', 'src/utils.ts'];
- * const result = mapFilePathsToNames(filePaths);
- * console.log(result);
- * // Output: {
- * //   'src/index': 'src/index.ts',
- * //   'src/utils': 'src/utils.ts'
- * // }
- * ```
- */
-declare function mapFilePathsToNames(filePaths: Array<string>): Record<string, string>;
 /**
- * Extracts and returns an object mapping output file paths to input file paths from the provided `EntryPointsType` object.
- *
- * This function handles multiple formats of entry points, including:
- * - An array of strings representing file paths.
- * - An array of objects containing `in` and `out` properties, where `in` is the input file path and `out` is the output file path.
- * - A `Record<string, string>` where the keys represent input file paths and the values represent output file paths.
- *
- * Depending on the format, the function constructs an object with the output file paths as keys and the input file paths as values.
- * If the output path is not available, the filename (without extension) is used as the key.
- *
- * If a regular object with string keys and values (not in the supported formats) is provided, it will be returned as is.
+ * Executes JavaScript code within a sandboxed environment using Node.js's `vm` module.
  *
- * @param entryPoints - The entry points to extract from, which can be in different formats: an array of strings,
- * an array of objects with `in` and `out` properties, or a `Record<string, string>`.
+ * @param code - The JavaScript code to be executed within the sandbox.
+ * @param sandbox - An optional context object to be used as the global scope for the executed code.
  *
- * @returns An object mapping output file paths to input file paths, or filename (without extension) to file path.
+ * @returns The result of executing the provided code within the sandboxed environment.
  *
- * @throws Will throw an `Error` if the entry points format is unsupported.
+ * @remarks
+ * The `sandboxExecute` function creates a new `Script` instance with the provided code and
+ * runs it within a sandboxed context using the `createContext` function from the `vm` module.
+ * This approach ensures that the executed code is isolated from the rest of the application,
+ * mitigating potential security risks.
  *
- * @example
- * ```ts
- * const entryPoints = extractEntryPoints(['src/index.ts', 'src/utils.ts']);
- * console.log(entryPoints); // { 'index': 'src/index.ts', 'utils': 'src/utils.ts' }
- * ```
+ * The `sandbox` parameter allows you to provide a custom context or global object for the
+ * sandboxed code. If not provided, an empty context is used. The function also supports
+ * breaking execution on interrupt signals (e.g., Ctrl+C) with the `breakOnSigint` option.
  *
- * @example
- * ```ts
- * const entryPoints = extractEntryPoints([{ in: 'src/index.ts', out: 'dist/index.js' }]);
- * console.log(entryPoints); // { 'dist/index.js': 'src/index.ts' }
- * ```
+ * @throws Error Throws an error if the code cannot be compiled or executed within the context.
  *
  * @example
  * ```ts
- * const entryPoints = extractEntryPoints({ index: 'src/index.ts', index2: 'dist/index2.js' });
- * console.log(entryPoints); // { index: 'src/index.ts', index2: 'dist/index2.js' }
+ * const result = sandboxExecute('return 2 + 2;', { myGlobal: 10 });
+ * console.log(result); // Output: 4
  * ```
- */
-declare function extractEntryPoints(entryPoints: EntryPointsType): Record<string, string>;
-
-/**
- * Import will remove at compile time
- */
-/**
- * Generates a `package.json` file with the appropriate `type` field
- * based on the format specified in the configuration.
  *
- * - If the format is `esm`, the `type` will be set to `"module"`.
- * - If the format is `cjs`, the `type` will be set to `"commonjs"`.
- *
- * The function will ensure that the specified output directory exists, and if it doesn't,
- * it will create the necessary directories before writing the `package.json` file.
- *
- * @param config - The build configuration object containing
- * esbuild-related settings, such as the format (`format`).
- *
- * - `config.esbuild.format`: The module format, either `'esm'` or `'cjs'`, that determines the `type` field.
- *
- * @throws Will throw an error if there is a problem creating the directory or writing the file.
- *
- * Example usage:
+ * In this example, the `sandboxExecute` function runs a simple JavaScript expression and returns
+ * the result. The `sandbox` parameter is provided with an empty object in this case.
  *
- * ```ts
- * const config = {
- *   esbuild: {
- *     format: 'esm'
- *   }
- * };
- * packageTypeComponent(config);
- * // This will create 'dist/package.json' with the content: {"type": "module"}
- * ```
- */
-declare function packageTypeComponent(config: ConfigurationInterface): void;
-
-/**
- * Import will remove at compile time
+ * @public
+ * @category Services
  */
+export declare function sandboxExecute(code: string, sandbox?: Context): unknown;
 /**
  * Parses a configuration file and returns a wrapped `ConfigurationInterface` object.
  *
@@ -3046,54 +2844,30 @@ declare function packageTypeComponent(config: ConfigurationInterface): void;
  *
  * @throws Will throw an error if the transpilation or execution of the configuration file fails.
  * The thrown error will have sourcemap information attached if available.
+
  * @example
  * ```ts
  * const config = await parseConfigurationFile('./config.jet.ts');
  * console.log(config);
  * ```
  */
-declare function parseConfigurationFile(file: string): Promise<ConfigurationInterface>;
-
-/**
- * Import will remove at compile time
- */
+export declare function parseConfigurationFile(file: string): Promise<ConfigurationInterface>;
 /**
- * Executes JavaScript code within a sandboxed environment using Node.js's `vm` module.
- *
- * @param code - The JavaScript code to be executed within the sandbox.
- * @param sandbox - An optional context object to be used as the global scope for the executed code.
- *
- * @returns The result of executing the provided code within the sandboxed environment.
- *
- * @remarks
- * The `sandboxExecute` function creates a new `Script` instance with the provided code and
- * runs it within a sandboxed context using the `createContext` function from the `vm` module.
- * This approach ensures that the executed code is isolated from the rest of the application,
- * mitigating potential security risks.
- *
- * The `sandbox` parameter allows you to provide a custom context or global object for the
- * sandboxed code. If not provided, an empty context is used. The function also supports
- * breaking execution on interrupt signals (e.g., Ctrl+C) with the `breakOnSigint` option.
- *
- * @throws Error Throws an error if the code cannot be compiled or executed within the context.
+ * The default configuration options for the build.
  *
  * @example
  * ```ts
- * const result = sandboxExecute('return 2 + 2;', { myGlobal: 10 });
- * console.log(result); // Output: 4
+ * import { defaultConfiguration } from '@configuration/default-configuration';
+ *
+ * console.log(defaultConfiguration);
  * ```
  *
- * In this example, the `sandboxExecute` function runs a simple JavaScript expression and returns
- * the result. The `sandbox` parameter is provided with an empty object in this case.
+ * In this example, the `defaultConfiguration` is imported and logged to the console to view the default settings.
  *
  * @public
- * @category Services
- */
-declare function sandboxExecute(code: string, sandbox?: Context): unknown;
-
-/**
- * Import will remove at compile time
+ * @category Configuration
  */
+export declare const defaultConfiguration: ConfigurationInterface;
 /**
  * Merges user configurations with CLI configurations and default settings
  * to produce a final configuration object for the build process.
@@ -3124,7 +2898,7 @@ declare function sandboxExecute(code: string, sandbox?: Context): unknown;
  * console.log('Merged Configuration:', finalConfigs);
  * ```
  */
-declare function configuration(userConfig: Array<PartialDeepConfigurationsType> | PartialDeepConfigurationsType, cliConfig?: PartialDeepConfigurationsType): Promise<Array<ConfigurationInterface>>;
+export declare function configuration(userConfig: Array<PartialDeepConfigurationsType> | PartialDeepConfigurationsType, cliConfig?: PartialDeepConfigurationsType): Promise<Array<ConfigurationInterface>>;
 /**
  * Merges CLI arguments with a configuration file to produce a final configuration object.
  * This function reads the specified configuration file and merges its contents with
@@ -3152,24 +2926,55 @@ declare function configuration(userConfig: Array<PartialDeepConfigurationsType>
  * });
  * ```
  */
-declare function cliConfiguration(configFile: string, cli: Argv<ArgvInterface>): Promise<Array<ConfigurationInterface>>;
-
+export declare function cliConfiguration(configFile: string, cli: Argv<ArgvInterface>): Promise<Array<ConfigurationInterface>>;
 /**
- * Import will remove at compile time
+ * Main run function that initiates the build process based on CLI arguments.
+ *
+ * This function parses the CLI arguments, configures the build settings, and executes
+ * the appropriate build tasks, including type checking, serving, or running in debug mode.
+ *
+ * @param argv - An array of strings representing the CLI arguments.
+ *
+ * @returns A promise that resolves when all build tasks are completed.
+ *
+ * @example
+ * ```ts
+ * await buildWithArgv(process.argv);
+ * ```
  */
+export declare function buildWithArgv(argv: Array<string>): Promise<void>;
 /**
- * The default configuration options for the build.
+ * Builds the project using a configuration file specified by its path.
+ *
+ * This function reads the configuration from the provided file path, processes it,
+ * and initiates the build tasks.
+ *
+ * @param configFilePath - The path to the configuration file to be used for the build.
+ *
+ * @returns A promise that resolves to an array of `BuildResult` objects once all build tasks are completed.
+ *
+ * @throws Error Throws an error if the configuration file does not exist or is invalid.
  *
  * @example
  * ```ts
- * import { defaultConfiguration } from '@configuration/default-configuration';
- *
- * console.log(defaultConfiguration);
+ * const results = await buildWithPath('./config.ts');
+ * console.log('Build results:', results);
  * ```
+ */
+export declare function buildWithConfigPath(configFilePath: string): Promise<BuildResult[]>;
+/**
+ * Builds the project based on the provided configuration object.
  *
- * In this example, the `defaultConfiguration` is imported and logged to the console to view the default settings.
+ * This function processes the given configuration and executes the build tasks accordingly.
  *
- * @public
- * @category Configuration
+ * @param config - A partial configuration object used to define the build settings.
+ *
+ * @returns A promise that resolves to an array of `BuildResult` objects once all build tasks are completed.
+ *
+ * @example
+ * ```ts
+ * const results = await build({ entryPoints: ['./src/index.ts'] });
+ * console.log('Build results:', results);
+ * ```
  */
-declare const defaultConfiguration: ConfigurationInterface;
+export declare function build(config: PartialDeepConfigurationsType): Promise<BuildResult[]>;