depflow 3.0.0-dev.1 → 3.0.0-dev.11

package/dist/dependency/Dependency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Dependency.js","sourceRoot":"","sources":["../../src/dependency/Dependency.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAO5C,MAAM,OAAgB,UAAU;IAsCR,UAAU;IACV,WAAW;IAtC/B;;;;;;;OAOG;IACI,MAAM,CAAU,mBAAmB,GAAW,MAAM,CAAC;IAEzC,MAAM,CAAgB;IACtB,MAAM,CAAsB;IAE/B,IAAI,CAAS;IACb,OAAO,CAAiB;IACxB,QAAQ,CAAyB;IAEjD;;;;;;;;;;;;;;;;;;OAkBG;IACH,YACoB,UAAkB,EAClB,WAAmB,EACnC,IAAqB,EACrB,MAAsB,EACtB,MAA4B;0BAJZ,UAAU;2BACV,WAAW;QAK3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;QAClC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC;QACpC,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,IAAI,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,IAAI,CAAC;IACjC,CAAC;IACD;;;;;;;;;OASG;IACO,OAAO,CAAC,GAAG,QAAkB;QACnC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC;QAC5D,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,eAAe,IAAI,CAAC,IAAI,0CAA0C,MAAM,EAAE,CAAC,CAAC;QAC9H,OAAO,MAAM,CAAC;IAClB,CAAC;CAqBJ;AAQD,eAAe,UAAU,CAAC"}

package/dist/dependency/Git.d.ts

@@ -0,0 +1,75 @@
+/**
+ * @author NetFeez <netfeez.dev@gmail.com>.
+ * @description Runs git clone and pull operations as programs of their own, with real-time logging.
+ * @license Apache-2.0
+ */
+import type Logger from "@netfeez/vterm";
+import Task from "../task/Task.js";
+import OutputPolicy from "../task/OutputPolicy.js";
+export declare class Git {
+    /**
+     * Clones a Git repository from the specified URL to the target path, optionally checking out a
+     * specific tag after cloning.
+     * The repository, the path and the tag are passed as arguments of `git`, never as a script, so
+     * nothing in them can be reinterpreted as another command.
+     * @param repo - The URL of the Git repository to clone.
+     * @param path - The file system path where the repository should be cloned to.
+     * @param options - An object containing optional parameters for the clone operation, including:
+     *   - tag: An optional Git tag to check out after cloning the repository.
+     *   - logger: An optional Logger instance for real-time logging of command output and errors.
+     *   - policy: The policy the output of the commands is reported through, when the run asked for one.
+     *   - cwd: An optional current working directory to execute the commands from, defaulting to the process's current working directory if not provided.
+     */
+    static clone(repo: string, path: string, options: Git.RepoOptions): Promise<void>;
+    /**
+     * Brings an existing checkout of a repository to the revision that was asked for.
+     *
+     * The objects are fetched first, always, and then the revision is checked out: a tag is a
+     * revision, not a branch, so a checkout that already sits on one has a detached HEAD, where
+     * `git pull` has nothing to pull into and fails. Checking out the requested revision lands on the
+     * very same commit a fresh clone of that revision would.
+     * @param path - The file system path to the local Git repository to bring up to date.
+     * @param options - An object containing optional parameters for the pull operation, including:
+     *   - tag: An optional Git tag to check out, or the branch to fast forward when it is absent.
+     *   - logger: An optional Logger instance for real-time logging of command output and errors.
+     *   - policy: The policy the output of the commands is reported through, when the run asked for one.
+     *   - cwd: An optional current working directory to execute the commands from, defaulting to the process's current working directory if not provided.
+     */
+    static pull(path: string, options: Git.RepoOptions): Promise<void>;
+    /**
+     * Runs the instructions of a Git operation as a Task, reporting them through the policy of the run.
+     * The verdict of the task is the verdict of the operation: it is awaited, never read from an event.
+     *
+     * @remarks Without a policy the task is only streamed into the logger it was given, and nothing else
+     * is said about it: what a task reports about a command is the result of that command, and that
+     * result is presented by whoever owns the policy, never by the task itself.
+     *
+     * @param instructions - The git instructions to run.
+     * @param options - An object containing optional parameters for the operation, including:
+     *   - logger: An optional Logger instance for real-time logging of command output and errors.
+     *   - policy: The policy the output of the commands is reported through, when the run asked for one.
+     *   - cwd: The working directory of the task, defaulting to the process's current working directory.
+     * @returns A promise resolving once every instruction ran.
+     * @throws { Task.Failure } When any of the instructions fails.
+     *
+     * @remarks The operation is not named anywhere here. The name belonged to the diagnostic of a command,
+     * and that diagnostic is composed by the policy out of the command itself, so naming the operation
+     * here said the same thing twice, in two translations that never agreed.
+     */
+    protected static runTask(instructions: Task.Instruction[], options: Git.ShellOptions): Promise<void>;
+}
+export declare namespace Git {
+    interface ShellOptions {
+        cwd?: string;
+        logger?: Logger;
+        /**
+         * The policy the output of the commands of the operation is reported through. A Git operation has
+         * no step of a pipeline to be identified against, so the commands of it are reported as `C<M>`.
+         */
+        policy?: OutputPolicy | null;
+    }
+    interface RepoOptions extends ShellOptions {
+        tag?: string;
+    }
+}
+export default Git;

package/dist/dependency/Git.js

@@ -0,0 +1,97 @@
+import Task from "../task/Task.js";
+import Dependency from './Dependency.js';
+export class Git {
+    /**
+     * Clones a Git repository from the specified URL to the target path, optionally checking out a
+     * specific tag after cloning.
+     * The repository, the path and the tag are passed as arguments of `git`, never as a script, so
+     * nothing in them can be reinterpreted as another command.
+     * @param repo - The URL of the Git repository to clone.
+     * @param path - The file system path where the repository should be cloned to.
+     * @param options - An object containing optional parameters for the clone operation, including:
+     *   - tag: An optional Git tag to check out after cloning the repository.
+     *   - logger: An optional Logger instance for real-time logging of command output and errors.
+     *   - policy: The policy the output of the commands is reported through, when the run asked for one.
+     *   - cwd: An optional current working directory to execute the commands from, defaulting to the process's current working directory if not provided.
+     */
+    static async clone(repo, path, options) {
+        const { tag, logger, policy, cwd = process.cwd() } = options;
+        const instructions = [
+            { executable: 'git', args: ['clone', repo, path], cwd }
+        ];
+        if (tag)
+            instructions.push({ executable: 'git', args: ['checkout', tag], cwd: path });
+        await this.runTask(instructions, { cwd, logger, policy });
+    }
+    /**
+     * Brings an existing checkout of a repository to the revision that was asked for.
+     *
+     * The objects are fetched first, always, and then the revision is checked out: a tag is a
+     * revision, not a branch, so a checkout that already sits on one has a detached HEAD, where
+     * `git pull` has nothing to pull into and fails. Checking out the requested revision lands on the
+     * very same commit a fresh clone of that revision would.
+     * @param path - The file system path to the local Git repository to bring up to date.
+     * @param options - An object containing optional parameters for the pull operation, including:
+     *   - tag: An optional Git tag to check out, or the branch to fast forward when it is absent.
+     *   - logger: An optional Logger instance for real-time logging of command output and errors.
+     *   - policy: The policy the output of the commands is reported through, when the run asked for one.
+     *   - cwd: An optional current working directory to execute the commands from, defaulting to the process's current working directory if not provided.
+     */
+    static async pull(path, options) {
+        const { tag, logger, policy } = options;
+        const instructions = [
+            { executable: 'git', args: ['fetch', '--tags', '--force'], cwd: path }
+        ];
+        instructions.push(tag
+            ? { executable: 'git', args: ['checkout', tag], cwd: path }
+            : { executable: 'git', args: ['pull', '--ff-only'], cwd: path });
+        await this.runTask(instructions, { logger, policy });
+    }
+    /**
+     * Runs the instructions of a Git operation as a Task, reporting them through the policy of the run.
+     * The verdict of the task is the verdict of the operation: it is awaited, never read from an event.
+     *
+     * @remarks Without a policy the task is only streamed into the logger it was given, and nothing else
+     * is said about it: what a task reports about a command is the result of that command, and that
+     * result is presented by whoever owns the policy, never by the task itself.
+     *
+     * @param instructions - The git instructions to run.
+     * @param options - An object containing optional parameters for the operation, including:
+     *   - logger: An optional Logger instance for real-time logging of command output and errors.
+     *   - policy: The policy the output of the commands is reported through, when the run asked for one.
+     *   - cwd: The working directory of the task, defaulting to the process's current working directory.
+     * @returns A promise resolving once every instruction ran.
+     * @throws { Task.Failure } When any of the instructions fails.
+     *
+     * @remarks The operation is not named anywhere here. The name belonged to the diagnostic of a command,
+     * and that diagnostic is composed by the policy out of the command itself, so naming the operation
+     * here said the same thing twice, in two translations that never agreed.
+     */
+    static async runTask(instructions, options) {
+        const { cwd = process.cwd(), logger, policy } = options;
+        const task = new Task(cwd, instructions, { maxTimeMs: Dependency.ACQUISITION_TIME_MS });
+        if (policy) {
+            const identity = { step: null };
+            task.on('line', (line, ordinal) => policy.live(identity, line, ordinal, 'stdout'));
+            task.on('err', (line, ordinal) => policy.live(identity, line, ordinal, 'stderr'));
+            task.once('finish', (data) => policy.settleTask(identity, data));
+            try {
+                await task.run();
+            }
+            catch (failure) {
+                if (failure instanceof Task.Failure)
+                    policy.stepFailed(identity, failure);
+                throw failure;
+            }
+        }
+        else {
+            if (logger) {
+                task.on('line', (line) => logger.info(line));
+                task.on('err', (line) => logger.error(line));
+            }
+            await task.run();
+        }
+    }
+}
+export default Git;
+//# sourceMappingURL=Git.js.map

package/dist/dependency/Git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Git.js","sourceRoot":"","sources":["../../src/dependency/Git.ts"],"names":[],"mappings":"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"}

package/dist/dependency/GitDependency.d.ts

@@ -0,0 +1,30 @@
+import Logger from "@netfeez/vterm";
+import DepUtils from "./DepUtils.js";
+import Dependency from './Dependency.js';
+import type OutputPolicy from '../task/OutputPolicy.js';
+import schema from '../schema/schema.js';
+export declare class GitDependency extends Dependency implements GitDependency.Data {
+    readonly repo: GitDependency.repo;
+    readonly tag: string;
+    constructor(flowFolder: string, projectRoot: string, dependency: GitDependency.Data, logger?: Logger | null, policy?: OutputPolicy | null);
+    /** The folder of the checkout, the identity of the dependency inside the flow folder. **/
+    get folder(): string;
+    /** Whether the checkout of the dependency is in place. **/
+    isInstalled(): Promise<boolean>;
+    /**
+     * Installs the dependency, bringing the repository in and building it.
+     *
+     * @remarks The group of the acquisition is opened only when the run decorates its output, and it is
+     * closed in a `finally` so an acquisition that throws leaves the output as closed as one that
+     * succeeded: a box left open is a box every line after it is drawn inside.
+     */
+    install(): Promise<void>;
+    /** Removes the local clone from the flow folder, if present. **/
+    uninstall(): Promise<void>;
+    build(): Promise<void>;
+}
+export declare namespace GitDependency {
+    type repo = DepUtils.Repo;
+    type Data = schema.Dependency.GitDependency;
+}
+export default GitDependency;

package/dist/dependency/GitDependency.js

@@ -0,0 +1,79 @@
+/**
+ * @author NetFeez <netfeez.dev@gmail.com>.
+ * @description Dependency utility.
+ * @license Apache-2.0
+ */
+import { File } from '@netfeez/common-node';
+import DepUtils from "./DepUtils.js";
+import Git from "./Git.js";
+import Group from "../task/Group.js";
+import Dependency from './Dependency.js';
+import Builder from '../builder/Builder.js';
+export class GitDependency extends Dependency {
+    repo;
+    tag;
+    constructor(flowFolder, projectRoot, dependency, logger = null, policy = null) {
+        super(flowFolder, projectRoot, {
+            name: dependency.name,
+            builder: dependency.builder,
+            resolver: dependency.resolver || {}
+        }, logger, policy);
+        DepUtils.repo(dependency.repo);
+        this.repo = dependency.repo;
+        this.tag = dependency.tag;
+    }
+    /** The folder of the checkout, the identity of the dependency inside the flow folder. **/
+    get folder() { return this.resolve(this.name); }
+    /** Whether the checkout of the dependency is in place. **/
+    async isInstalled() { return File.exists(this.folder); }
+    /**
+     * Installs the dependency, bringing the repository in and building it.
+     *
+     * @remarks The group of the acquisition is opened only when the run decorates its output, and it is
+     * closed in a `finally` so an acquisition that throws leaves the output as closed as one that
+     * succeeded: a box left open is a box every line after it is drawn inside.
+     */
+    async install() {
+        const boxed = this.policy === null || this.policy.decoration === 'on';
+        if (boxed)
+            this.logger?.group(Group.create('#00B4FF'));
+        try {
+            if (await this.isInstalled()) {
+                this.logger?.log(`&C3Repository already exists, pulling latest changes...`);
+                await Git.pull(this.folder, { tag: this.tag, logger: this.logger ?? undefined, policy: this.policy });
+                this.logger?.log(`&C2Pull completed successfully.`);
+            }
+            else {
+                this.logger?.log(`&C5Cloning repository from &C6${this.repo}&C5...`);
+                await Git.clone(this.repo, this.folder, { tag: this.tag, logger: this.logger ?? undefined, policy: this.policy });
+                this.logger?.log(`&C2Clone completed successfully.`);
+            }
+            await this.build();
+        }
+        finally {
+            if (boxed)
+                this.logger?.end();
+        }
+    }
+    /** Removes the local clone from the flow folder, if present. **/
+    async uninstall() {
+        if (!await this.isInstalled())
+            return void this.logger?.log(`&C4No installation found for &C6${this.name}&C4, skipping.`);
+        this.logger?.log(`&C1Removing &C6${this.name}&C1 from &C4${this.folder}&C1...`);
+        await File.remove(this.folder);
+    }
+    async build() {
+        if (this.builder.length === 0)
+            return;
+        const builder = new Builder({
+            pipeline: this.builder,
+            cwd: this.folder,
+            projectRoot: this.projectRoot,
+            logger: this.logger,
+            policy: this.policy
+        });
+        await builder.run();
+    }
+}
+export default GitDependency;
+//# sourceMappingURL=GitDependency.js.map

package/dist/dependency/GitDependency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitDependency.js","sourceRoot":"","sources":["../../src/dependency/GitDependency.ts"],"names":[],"mappings":"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"}

package/dist/dependency/NpmDependency.d.ts

@@ -0,0 +1,27 @@
+import Logger from "@netfeez/vterm";
+import type OutputPolicy from "../task/OutputPolicy.js";
+import { Dependency } from "./Dependency.js";
+import schema from "../schema/schema.js";
+export declare class NpmDependency extends Dependency implements NpmDependency.Data {
+    version: string;
+    constructor(flowFolder: string, projectRoot: string, dependency: NpmDependency.Data, logger?: Logger | null, policy?: OutputPolicy | null);
+    /** The folder of the package, the identity of the dependency inside the flow folder. **/
+    get folder(): string;
+    /** Whether the package is installed in the flow folder. **/
+    isInstalled(): Promise<boolean>;
+    /**
+     * Installs the package and builds it with the pipeline of the dependency.
+     *
+     * @remarks The group of the acquisition is opened only when the run decorates its output, and it is
+     * closed in a `finally` so an installation that throws leaves the output as closed as one that
+     * succeeded: a box left open is a box every line after it is drawn inside.
+     */
+    install(): Promise<void>;
+    /** Removes the installed npm package folder, if present. **/
+    uninstall(): Promise<void>;
+    build(): Promise<void>;
+}
+export declare namespace NpmDependency {
+    type Data = schema.Dependency.NpmDependency;
+}
+export default NpmDependency;

package/dist/dependency/NpmDependency.js

@@ -0,0 +1,91 @@
+/**
+ * @author NetFeez <netfeez.dev@gmail.com>.
+ * @description NPM dependency: installs a package and builds it with the configured pipeline.
+ * @license Apache-2.0
+ */
+import { File } from "@netfeez/common-node";
+import Builder from "../builder/Builder.js";
+import Task from "../task/Task.js";
+import Group from "../task/Group.js";
+import { Dependency } from "./Dependency.js";
+export class NpmDependency extends Dependency {
+    version;
+    constructor(flowFolder, projectRoot, dependency, logger = null, policy = null) {
+        super(flowFolder, projectRoot, {
+            name: dependency.name,
+            builder: dependency.builder,
+            resolver: dependency.resolver || {}
+        }, logger, policy);
+        this.version = dependency.version;
+    }
+    /** The folder of the package, the identity of the dependency inside the flow folder. **/
+    get folder() { return this.resolve('node_modules', this.name); }
+    /** Whether the package is installed in the flow folder. **/
+    async isInstalled() { return File.exists(this.folder); }
+    /**
+     * Installs the package and builds it with the pipeline of the dependency.
+     *
+     * @remarks The group of the acquisition is opened only when the run decorates its output, and it is
+     * closed in a `finally` so an installation that throws leaves the output as closed as one that
+     * succeeded: a box left open is a box every line after it is drawn inside.
+     */
+    async install() {
+        const boxed = this.policy === null || this.policy.decoration === 'on';
+        if (boxed)
+            this.logger?.group(Group.create('#00B4FF'));
+        try {
+            this.logger?.log(`&C5Using npm to install &C6${this.name}&C5...`);
+            const identity = { step: null };
+            const task = new Task(this.flowFolder, [
+                { executable: 'npm', args: ['install', `${this.name}@${this.version}`, '--prefix', './', '--no-save'], cwd: this.flowFolder }
+            ], { maxTimeMs: Dependency.ACQUISITION_TIME_MS });
+            if (this.policy) {
+                task.on('line', (line, ordinal) => this.policy?.live(identity, line, ordinal, 'stdout'));
+                task.on('err', (line, ordinal) => this.policy?.live(identity, line, ordinal, 'stderr'));
+                task.once('finish', (data) => this.policy?.settleTask(identity, data));
+                try {
+                    await task.run();
+                }
+                catch (failure) {
+                    if (failure instanceof Task.Failure)
+                        this.policy.stepFailed(identity, failure);
+                    throw failure;
+                }
+            }
+            else {
+                if (this.logger) {
+                    task.on('line', (line) => this.logger?.log(`&C3${line}`));
+                    task.on('err', (line) => this.logger?.error(`&C1${line}`));
+                }
+                await task.run();
+            }
+            this.logger?.log(`&C2Installation of ${this.name} completed successfully.`);
+            await this.build();
+        }
+        finally {
+            if (boxed)
+                this.logger?.end();
+        }
+    }
+    /** Removes the installed npm package folder, if present. **/
+    async uninstall() {
+        if (!await this.isInstalled())
+            return void this.logger?.log(`&C4No installation found for &C6${this.name}&C4, skipping.`);
+        this.logger?.log(`&C1Removing &C6${this.name}&C1 from &C4${this.folder}&C1...`);
+        await File.remove(this.folder);
+    }
+    async build() {
+        if (this.builder.length === 0)
+            return;
+        const builder = new Builder({
+            pipeline: this.builder,
+            cwd: this.folder,
+            projectRoot: this.projectRoot,
+            logger: this.logger,
+            policy: this.policy
+        });
+        await builder.run();
+    }
+}
+export default NpmDependency;
+//# sourceMappingURL=NpmDependency.js.map

package/dist/dependency/NpmDependency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NpmDependency.js","sourceRoot":"","sources":["../../src/dependency/NpmDependency.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAG5C,OAAO,OAAO,MAAM,uBAAuB,CAAC;AAC5C,OAAO,IAAI,MAAM,iBAAiB,CAAC;AACnC,OAAO,KAAK,MAAM,kBAAkB,CAAC;AAErC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7C,MAAM,OAAO,aAAc,SAAQ,UAAU;IAClC,OAAO,CAAS;IAEvB,YACI,UAAkB,EAClB,WAAmB,EACnB,UAA8B,EAC9B,MAAM,GAAkB,IAAI,EAC5B,MAAM,GAAwB,IAAI;QAElC,KAAK,CAAC,UAAU,EAAE,WAAW,EAAE;YAC3B,IAAI,EAAE,UAAU,CAAC,IAAI;YACrB,OAAO,EAAE,UAAU,CAAC,OAAO;YAC3B,QAAQ,EAAE,UAAU,CAAC,QAAQ,IAAI,EAAE;SACtC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QACnB,IAAI,CAAC,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;IACtC,CAAC;IAED,yFAAyF;IACzF,IAAW,MAAM,KAAa,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAE/E,4DAA4D;IACrD,KAAK,CAAC,WAAW,KAAuB,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAEjF;;;;;;OAMG;IACI,KAAK,CAAC,OAAO;QAChB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,KAAK,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,KAAK,IAAI,CAAC;QACtE,IAAI,KAAK;YAAE,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;QACvD,IAAI,CAAC;YACD,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,8BAA8B,IAAI,CAAC,IAAI,QAAQ,CAAC,CAAC;YAElE,MAAM,QAAQ,GAA0B,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;YACvD,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE;gBACnC,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,CAAE,SAAS,EAAE,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,CAAE,EAAE,GAAG,EAAE,IAAI,CAAC,UAAU,EAAE;aAClI,EAAE,EAAE,SAAS,EAAE,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;YAElD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBACd,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;gBACzF,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;gBACxF,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;gBAEvE,IAAI,CAAC;oBAAC,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC;gBAAC,CAAC;gBACzB,OAAO,OAAO,EAAE,CAAC;oBACb,IAAI,OAAO,YAAY,IAAI,CAAC,OAAO;wBAAE,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;oBAC/E,MAAM,OAAO,CAAC;gBAClB,CAAC;YACL,CAAC;iBAAM,CAAC;gBACJ,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;oBACd,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC;oBAC1D,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC;gBAC/D,CAAC;gBACD,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC;YACrB,CAAC;YAED,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,sBAAsB,IAAI,CAAC,IAAI,0BAA0B,CAAC,CAAC;YAE5E,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;gBAAS,CAAC;YACP,IAAI,KAAK;gBAAE,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC;QAClC,CAAC;IACL,CAAC;IACD,6DAA6D;IACtD,KAAK,CAAC,SAAS;QAClB,IAAI,CAAC,MAAM,IAAI,CAAC,WAAW,EAAE;YAAE,OAAO,KAAK,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,mCAAmC,IAAI,CAAC,IAAI,gBAAgB,CAAC,CAAC;QAC1H,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,kBAAkB,IAAI,CAAC,IAAI,eAAe,IAAI,CAAC,MAAM,QAAQ,CAAC,CAAC;QAChF,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IACM,KAAK,CAAC,KAAK;QACd,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QACtC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC;YACxB,QAAQ,EAAE,IAAI,CAAC,OAAO;YACtB,GAAG,EAAE,IAAI,CAAC,MAAM;YAChB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,MAAM,EAAE,IAAI,CAAC,MAAM;SACtB,CAAC,CAAC;QACH,MAAM,OAAO,CAAC,GAAG,EAAE,CAAC;IACxB,CAAC;CACJ;AAID,eAAe,aAAa,CAAC"}

package/dist/resolve/AliasCompiler.d.ts

@@ -0,0 +1,45 @@
+import schema from '../schema/schema.js';
+export declare class AliasCompiler {
+    private projectRoot;
+    /** Matches the optional wildcard suffix of an alias or target (`/*` or `/`). */
+    private static readonly WILDCARD_SUFFIX_REGEX;
+    constructor(projectRoot: string);
+    /**
+     * Compiles alias configurations from the provided config object into a structured format for path resolution.
+     * It processes both regular and wildcard aliases, resolving local paths to absolute paths based on the project root.
+     * The resulting compiled aliases include information about the alias name, whether it's a wildcard, and its target paths for local and CDN usage.
+     * @param config - The configuration object containing dependencies with resolver entries to compile into aliases.
+     * @returns An array of compiled alias objects ready for use in path resolution.
+     */
+    compile(config: schema.Config): AliasCompiler.CompiledAlias[];
+    /**
+     * Resolves an array of resolver entries into compiled alias objects, handling both string and object target formats.
+     * It determines if each alias is a wildcard and resolves local paths to absolute paths based on the project root.
+     * The method also extracts type and CDN targets if provided in the resolver entry.
+     * @param resolver - An array of resolver entries to process into compiled aliases.
+     * @returns An array of compiled alias objects derived from the resolver entries.
+     */
+    protected resolve(resolver: AliasCompiler.Resolver): AliasCompiler.CompiledAlias[];
+    /**
+     * Checks whether an alias string carries the wildcard suffix (`/*` or `/`) that turns it into a mapping.
+     * @param alias - The alias string to check.
+     * @returns True if the alias ends with a wildcard suffix, false otherwise.
+     */
+    private static isWildcard;
+    /**
+     * Strips the wildcard suffix from an alias or target string, leaving its base form.
+     * @param pathStr - The string to normalize (e.g., `components/*` or `utils/`).
+     * @returns The string without its wildcard suffix (e.g., `components` or `utils`).
+     */
+    private static removeWildcardSuffix;
+}
+export declare namespace AliasCompiler {
+    type Resolver = schema.Resolver;
+    type Target = Exclude<schema.Target, string>;
+    interface CompiledAlias {
+        alias: string;
+        targets: Target;
+        isWildcard: boolean;
+    }
+}
+export default AliasCompiler;

package/dist/resolve/AliasCompiler.js

@@ -0,0 +1,84 @@
+/**
+ * @author NetFeez <netfeez.dev@gmail.com>.
+ * @description Compiles resolver entries from the configuration into absolute compiled aliases.
+ * @license Apache-2.0
+ */
+import path from 'node:path';
+export class AliasCompiler {
+    projectRoot;
+    /** Matches the optional wildcard suffix of an alias or target (`/*` or `/`). */
+    static WILDCARD_SUFFIX_REGEX = /\/\*?$/;
+    constructor(projectRoot) {
+        this.projectRoot = projectRoot;
+    }
+    /**
+     * Compiles alias configurations from the provided config object into a structured format for path resolution.
+     * It processes both regular and wildcard aliases, resolving local paths to absolute paths based on the project root.
+     * The resulting compiled aliases include information about the alias name, whether it's a wildcard, and its target paths for local and CDN usage.
+     * @param config - The configuration object containing dependencies with resolver entries to compile into aliases.
+     * @returns An array of compiled alias objects ready for use in path resolution.
+     */
+    compile(config) {
+        const result = [];
+        const allDeps = [
+            ...(config.dependencies || []),
+            ...(config.npmDependencies || [])
+        ];
+        const baseResolvers = config.resolver || {};
+        for (const dep of allDeps) {
+            if (typeof dep !== 'object' || !dep.resolver)
+                continue;
+            result.push(...this.resolve(dep.resolver));
+        }
+        result.push(...this.resolve(baseResolvers));
+        return result;
+    }
+    /**
+     * Resolves an array of resolver entries into compiled alias objects, handling both string and object target formats.
+     * It determines if each alias is a wildcard and resolves local paths to absolute paths based on the project root.
+     * The method also extracts type and CDN targets if provided in the resolver entry.
+     * @param resolver - An array of resolver entries to process into compiled aliases.
+     * @returns An array of compiled alias objects derived from the resolver entries.
+     */
+    resolve(resolver) {
+        const result = [];
+        for (const [crudeAlias, target] of Object.entries(resolver)) {
+            const isWildcard = AliasCompiler.isWildcard(crudeAlias);
+            const alias = AliasCompiler.removeWildcardSuffix(crudeAlias);
+            const rawLocal = typeof target === 'string' ? target : target.local;
+            const localTarget = path.isAbsolute(rawLocal)
+                ? AliasCompiler.removeWildcardSuffix(rawLocal)
+                : path.resolve(this.projectRoot, AliasCompiler.removeWildcardSuffix(rawLocal));
+            let cdnTarget;
+            let typeTarget;
+            if (typeof target === 'object') {
+                if (target.type) {
+                    typeTarget = AliasCompiler.removeWildcardSuffix(target.type);
+                }
+                if (target.cdn) {
+                    cdnTarget = AliasCompiler.removeWildcardSuffix(target.cdn);
+                }
+            }
+            result.push({ alias, isWildcard, targets: { local: localTarget, type: typeTarget, cdn: cdnTarget } });
+        }
+        return result;
+    }
+    /**
+     * Checks whether an alias string carries the wildcard suffix (`/*` or `/`) that turns it into a mapping.
+     * @param alias - The alias string to check.
+     * @returns True if the alias ends with a wildcard suffix, false otherwise.
+     */
+    static isWildcard(alias) {
+        return this.WILDCARD_SUFFIX_REGEX.test(alias);
+    }
+    /**
+     * Strips the wildcard suffix from an alias or target string, leaving its base form.
+     * @param pathStr - The string to normalize (e.g., `components/*` or `utils/`).
+     * @returns The string without its wildcard suffix (e.g., `components` or `utils`).
+     */
+    static removeWildcardSuffix(pathStr) {
+        return pathStr.replace(this.WILDCARD_SUFFIX_REGEX, '');
+    }
+}
+export default AliasCompiler;
+//# sourceMappingURL=AliasCompiler.js.map

package/dist/resolve/AliasCompiler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AliasCompiler.js","sourceRoot":"","sources":["../../src/resolve/AliasCompiler.ts"],"names":[],"mappings":"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"}

package/{build/support/PathResolver → dist/resolve}/PathResolver.d.ts

@@ -1,40 +1,57 @@
 import { Logger } from "@netfeez/vterm";
-import Schemas from '../../config/schemas.js';
 import PathRewriter from './PathRewriter.js';
 import AliasCompiler from './AliasCompiler.js';
+import schema from '../schema/schema.js';
 export declare class PathResolver {
-    readonly config: Schemas.Config['infer'];
     readonly options: PathResolver.Options;
-    static readonly PROJECT_ROOT: string;
+    /** The extensions of the built files the resolver owns, in any mode. */
     static readonly EXTENSIONS: string[];
     protected readonly logger: Logger;
     protected readonly rewriter: PathRewriter;
-    protected readonly absoluteOutDir: string;
+    protected readonly outDir: string;
     readonly aliases: AliasCompiler.CompiledAlias[];
-    constructor(config: Schemas.Config['infer'], options?: PathResolver.Options);
+    constructor(data: schema.Config, projectRoot: string, options?: PathResolver.Options);
+    /**
+     * The pattern that matches the built files the resolver owns, derived from the extensions it does.
+     * @returns The glob pattern of the files to rewrite.
+     **/
+    private static get filter();
     /**
      * Resolves and rewrites paths in built files based on the provided mode (local or CDN).
      * It processes all files in the output directory, rewriting import paths according to the configured aliases.
-     * @param mode The resolution mode ('local' or 'cdn') to determine which target paths to use.
+     * @param mode - The resolution mode ('local' or 'cdn') to determine which target paths to use.
+     * @throws { Error } When any of the files could not be rewritten, reporting all of them.
+     *
+     * @remarks A file that cannot be rewritten is not a file that was left alone: a build that reports
+     * success while some of its files still point at the source tree is a build that cannot be
+     * deployed, so the failure travels up to whoever asked for the resolution.
      */
     rewritePaths(mode: PathResolver.Mode): Promise<void>;
     /**
      * Processes a single file, rewriting import paths based on the configured aliases and the specified mode (local or CDN).
      * It reads the file content, applies the path rewriting logic, and writes the updated content back to the file system if any changes were made.
-     * @param file The path of the file to process.
-     * @param mode The resolution mode ('local' or 'cdn') to determine which target paths to use for rewriting.
+     * @param file - The path of the file to process.
+     * @param mode - The resolution mode ('local' or 'cdn') to determine which target paths to use for rewriting.
      * @returns A boolean indicating whether the file was modified (true if rewritten, false if no changes were made).
+     * @throws { Error } When the file cannot be read, rewritten or written.
      */
     protected processFile(file: string, mode: PathResolver.Mode): Promise<boolean>;
     /**
      * Watches the output directory for changes and automatically rewrites paths in modified files based on the configured aliases and specified mode (local or CDN).
      * It sets up a file system watcher that listens for changes in the output directory, and when a relevant file is modified, it triggers the path rewriting process for that file.
      * The method includes debouncing to prevent excessive processing during rapid file changes, ensuring efficient handling of updates while maintaining responsiveness.
-     * @param mode The resolution mode ('local' or 'cdn') to determine which target paths to use for rewriting when changes are detected.
+     * @param mode - The resolution mode ('local' or 'cdn') to determine which target paths to use for rewriting when changes are detected.
      * @returns A promise that resolves when the watcher is set up and running, allowing the application to continue monitoring for changes indefinitely until manually stopped.
      * @throws Will throw an error if there is an issue setting up the file system watcher or processing files, which can be caught by the caller to handle it appropriately.
      */
     watch(mode: PathResolver.Mode): Promise<void>;
+    /**
+     * Debounces a function so it only executes after the specified delay has passed since the last invocation.
+     * @param fn - The function to debounce.
+     * @param delay - The number of milliseconds to wait before executing the function.
+     * @returns A debounced version of the function that delays its execution.
+     */
+    private static debounce;
 }
 export declare namespace PathResolver {
     type Mode = 'local' | 'cdn';