depflow 3.0.0-dev.10 → 3.0.0-dev.12

package/dist/dependency/Dependency.d.ts

@@ -0,0 +1,81 @@
+import type Logger from "@netfeez/vterm";
+import schema from "../schema/schema.js";
+import type AliasCompiler from "../resolve/AliasCompiler.js";
+import type OutputPolicy from "../task/OutputPolicy.js";
+export declare abstract class Dependency {
+    readonly flowFolder: string;
+    readonly projectRoot: string;
+    /**
+     * The deadline every acquisition of a source runs under, in milliseconds. Acquisition is bounded so a
+     * repository that never answers is reported instead of waiting forever.
+     *
+     * @remarks It is not the deadline of a build step, which is the one the schema declares: a clone or an
+     * install of a large source legitimately takes longer than a build step, and cutting it at the build
+     * deadline would report a failure for work that is still on its way.
+     */
+    static readonly ACQUISITION_TIME_MS: number;
+    protected readonly logger: Logger | null;
+    protected readonly policy: OutputPolicy | null;
+    readonly name: string;
+    readonly builder: schema.Builder;
+    readonly resolver: AliasCompiler.Resolver;
+    /**
+     * Creates the dependency over the two roots it works between.
+     * @param flowFolder - The flow directory (`.depflow`) every checkout of the project lives in.
+     * @param projectRoot - The root of the project the artifacts of the dependency are meant to land in.
+     * @param info - The identity, the build pipeline and the resolver entries of the dependency.
+     * @param logger - Where the acquisition and the build of the dependency report to.
+     * @param policy - How the output of the commands the dependency runs is presented. Without it the
+     * dependency falls back to its logger, which streams the live output and says nothing else about it.
+     *
+     * @remarks The two roots are not the same and are not interchangeable: the flow folder owns the working
+     * copy of a dependency, the project root owns what the project consumes. A pipeline reads from the first
+     * and deposits into the second, which is why both travel together instead of one being derived from the
+     * other.
+     *
+     * @remarks The logger and the policy are not two ways of saying the same thing. The logger carries what
+     * the dependency decides to say about itself, and it says it whatever the user asked to be shown; the
+     * policy carries what the commands printed, and how much of it is shown depends on that. A dependency
+     * built through the CLI gets both, and a dependency built from a test gets neither.
+     */
+    constructor(flowFolder: string, projectRoot: string, info: Dependency.Info, logger?: Logger | null, policy?: OutputPolicy | null);
+    /**
+     * Resolves a folder of the dependency, relative to the flow folder, and guarantees it stays inside it.
+     * @param segments - The path of the folder inside the flow folder.
+     * @returns The normalized path of the folder.
+     * @throws { Error } When the segments escape the flow folder.
+     *
+     * @remarks A name is an identity, never a path: the schema rejects the ones that are not a single
+     * segment, and this is where the ones that reach a dependency any other way are stopped, before
+     * anything is cloned into them or removed from them.
+     */
+    protected resolve(...segments: string[]): string;
+    /**
+     * Whether the dependency is installed, which is the folder of its files being in place.
+     * @returns A promise resolving to `true` when the files of the dependency are there.
+     */
+    abstract isInstalled(): Promise<boolean>;
+    /**
+     * Install the dependency.
+     * This method should handle the installation process, such as downloading files, setting up configurations, etc.
+     */
+    abstract install(): Promise<void>;
+    /**
+     * Uninstall the dependency.
+     * This method should handle the uninstallation process, such as removing files, cleaning up configurations, etc.
+     */
+    abstract uninstall(): Promise<void>;
+    /**
+     * Build the dependency.
+     * This method should handle the build process, such as compiling code, bundling files, etc.
+     */
+    abstract build(): Promise<void>;
+}
+export declare namespace Dependency {
+    interface Info {
+        name: string;
+        builder?: schema.Builder;
+        resolver?: AliasCompiler.Resolver;
+    }
+}
+export default Dependency;

package/dist/dependency/Dependency.js

@@ -0,0 +1,71 @@
+/**
+ * @author NetFeez <netfeez.dev@gmail.com>.
+ * @description Base contract for installable dependencies with their build pipeline and resolver.
+ * @license Apache-2.0
+ */
+import { Path } from "@netfeez/common-node";
+export class Dependency {
+    flowFolder;
+    projectRoot;
+    /**
+     * The deadline every acquisition of a source runs under, in milliseconds. Acquisition is bounded so a
+     * repository that never answers is reported instead of waiting forever.
+     *
+     * @remarks It is not the deadline of a build step, which is the one the schema declares: a clone or an
+     * install of a large source legitimately takes longer than a build step, and cutting it at the build
+     * deadline would report a failure for work that is still on its way.
+     */
+    static ACQUISITION_TIME_MS = 300000;
+    logger;
+    policy;
+    name;
+    builder;
+    resolver;
+    /**
+     * Creates the dependency over the two roots it works between.
+     * @param flowFolder - The flow directory (`.depflow`) every checkout of the project lives in.
+     * @param projectRoot - The root of the project the artifacts of the dependency are meant to land in.
+     * @param info - The identity, the build pipeline and the resolver entries of the dependency.
+     * @param logger - Where the acquisition and the build of the dependency report to.
+     * @param policy - How the output of the commands the dependency runs is presented. Without it the
+     * dependency falls back to its logger, which streams the live output and says nothing else about it.
+     *
+     * @remarks The two roots are not the same and are not interchangeable: the flow folder owns the working
+     * copy of a dependency, the project root owns what the project consumes. A pipeline reads from the first
+     * and deposits into the second, which is why both travel together instead of one being derived from the
+     * other.
+     *
+     * @remarks The logger and the policy are not two ways of saying the same thing. The logger carries what
+     * the dependency decides to say about itself, and it says it whatever the user asked to be shown; the
+     * policy carries what the commands printed, and how much of it is shown depends on that. A dependency
+     * built through the CLI gets both, and a dependency built from a test gets neither.
+     */
+    constructor(flowFolder, projectRoot, info, logger, policy) {
+        this.flowFolder = flowFolder;
+        this.projectRoot = projectRoot;
+        this.name = info.name;
+        this.builder = info.builder || [];
+        this.resolver = info.resolver || {};
+        this.logger = logger || null;
+        this.policy = policy || null;
+    }
+    /**
+     * Resolves a folder of the dependency, relative to the flow folder, and guarantees it stays inside it.
+     * @param segments - The path of the folder inside the flow folder.
+     * @returns The normalized path of the folder.
+     * @throws { Error } When the segments escape the flow folder.
+     *
+     * @remarks A name is an identity, never a path: the schema rejects the ones that are not a single
+     * segment, and this is where the ones that reach a dependency any other way are stopped, before
+     * anything is cloned into them or removed from them.
+     */
+    resolve(...segments) {
+        const root = Path.normalize(this.flowFolder);
+        const folder = Path.normalize(Path.join(root, ...segments));
+        if (!Path.isInside(root, folder))
+            throw new Error(`Dependency "${this.name}" resolves outside of the flow folder: ${folder}`);
+        return folder;
+    }
+}
+export default Dependency;
+//# sourceMappingURL=Dependency.js.map

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/{build/support/PathResolver → dist/resolve}/AliasCompiler.d.ts

@@ -1,24 +1,37 @@
-import Config from '../../config/Config.js';
-import schema from '../../schema/schema.js';
+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.
+     * @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: Config.Config): AliasCompiler.CompiledAlias[];
+    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.
+     * @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;