depflow 3.0.0-dev.11 → 3.0.0-dev.13

package/dist/cli/bin.d.ts

@@ -1,2 +1,8 @@
 #!/usr/bin/env node
+/**
+ * @author NetFeez <netfeez.dev@gmail.com>.
+ * @description Command-line entry point: hands the tokens of the invocation to the console interface, which
+ *              reads the command, its arguments and its flags, and answers the verdict of the line.
+ * @license Apache-2.0
+ */
 export {};

package/dist/cli/bin.js

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
 /**
  * @author NetFeez <netfeez.dev@gmail.com>.
- * @description Command-line entry point: parses arguments and dispatches the invoked command to the CLI.
+ * @description Command-line entry point: hands the tokens of the invocation to the console interface, which
+ *              reads the command, its arguments and its flags, and answers the verdict of the line.
  * @license Apache-2.0
  */
-import Logger from "@netfeez/vterm";
-import DepFlowCLI, { options } from "./DepFLowCLI.js";
+import DepflowCLI from "./DepflowCLI.js";
+/** The tokens Node puts in front of the invocation: the interpreter and the entry point. **/
 const skip = 2;
-const [commandName, ...argsList] = process.argv.slice(skip);
 /**
  * Reports a failure to the user and marks the process as failed.
  *
@@ -26,7 +26,7 @@ const [commandName, ...argsList] = process.argv.slice(skip);
  * of the commands is still in it. The status a user observes is the same one in both, because the run
  * is already over by the time this is called; what changes is whether the transcript survives it.
  *
- * @param out - The logger or engine the failure is reported to.
+ * @param out - The engine the failure is reported to.
  * @param error - The failure, either an error or a message.
  * @returns void
  */
@@ -34,35 +34,11 @@ function fail(out, error) {
     out.error(`&C1${error?.message || error}`);
     process.exitCode = 1;
 }
-let parsed;
+const cli = new DepflowCLI();
 try {
-    parsed = options.parse(argsList);
+    await cli.invoke(process.argv.slice(skip));
 }
 catch (error) {
-    fail(new Logger(), error);
-}
-// A failed parse leaves nothing to dispatch: the invocation was never understood, so there is no command
-// to run and no CLI to run it with. The process still ends here, with the status `fail` marked.
-if (parsed !== undefined) {
-    const { args, flags } = parsed;
-    const cli = new DepFlowCLI(flags.flow);
-    try {
-        if (commandName !== null) {
-            const command = cli.getCommand(commandName);
-            if (command) {
-                const exec = command.exec;
-                await exec.call(cli, commandName, args, flags);
-            }
-            else {
-                cli.out.error(`Unknown command: ${commandName}`);
-                cli.getCommand('help')?.exec.call(cli, 'help', []);
-            }
-        }
-        else
-            cli.start();
-    }
-    catch (error) {
-        fail(cli.out, error);
-    }
+    fail(cli.out, error);
 }
 //# sourceMappingURL=bin.js.map

package/dist/cli/bin.js.map

@@ -1 +1 @@
-{"version":3,"file":"bin.js","sourceRoot":"","sources":["../../src/cli/bin.ts"],"names":[],"mappings":";AACA;;;;GAIG;AACH,OAAO,MAAuB,MAAM,gBAAgB,CAAC;AAErD,OAAO,UAAU,EAAE,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAGtD,MAAM,IAAI,GAAG,CAAC,CAAC;AACf,MAAM,CAAC,WAAW,EAAE,GAAG,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,SAAS,IAAI,CAAC,GAAoB,EAAE,KAAU;IAC1C,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,EAAE,OAAO,IAAI,KAAK,EAAE,CAAC,CAAC;IAC3C,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACzB,CAAC;AAED,IAAI,MAAoD,CAAC;AACzD,IAAI,CAAC;IAAC,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;AAAC,CAAC;AACzC,OAAO,KAAU,EAAE,CAAC;IAAC,IAAI,CAAC,IAAI,MAAM,EAAE,EAAE,KAAK,CAAC,CAAC;AAAC,CAAC;AAEjD,yGAAyG;AACzG,gGAAgG;AAChG,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;IACvB,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;IAC/B,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAEvC,IAAI,CAAC;QACD,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;YACvB,MAAM,OAAO,GAAG,GAAG,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;YAC5C,IAAI,OAAO,EAAE,CAAC;gBACV,MAAM,IAAI,GAAG,OAAO,CAAC,IAAuB,CAAC;gBAC7C,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;YACnD,CAAC;iBAAM,CAAC;gBACJ,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,oBAAoB,WAAW,EAAE,CAAC,CAAC;gBACjD,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;YACvD,CAAC;QACL,CAAC;;YAAM,GAAG,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QAClB,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACzB,CAAC;AACL,CAAC"}
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../../src/cli/bin.ts"],"names":[],"mappings":";AACA;;;;;GAKG;AAIH,OAAO,UAAU,MAAM,iBAAiB,CAAC;AAEzC,6FAA6F;AAC7F,MAAM,IAAI,GAAG,CAAC,CAAC;AAEf;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,SAAS,IAAI,CAAC,GAAW,EAAE,KAAU;IACjC,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,EAAE,OAAO,IAAI,KAAK,EAAE,CAAC,CAAC;IAC3C,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,GAAG,GAAG,IAAI,UAAU,EAAE,CAAC;AAE7B,IAAI,CAAC;IAAC,MAAM,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;AAAC,CAAC;AACnD,OAAO,KAAU,EAAE,CAAC;IAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;AAAC,CAAC"}

package/dist/config/Config.d.ts

@@ -242,7 +242,7 @@ export declare class Config extends Settings<typeof schema.Config, Document> {
                             readonly type: "string";
                             readonly required: true;
                             readonly pattern: RegExp;
-                            readonly description: "Unique name used to reference the dependency in flows and path aliases. It is an identity, not a path: a single alphanumeric segment.";
+                            readonly description: "Unique name used to reference the dependency in flows and path aliases. It is an identity, not an arbitrary path: a `<user>/<repo>` pair or a single alphanumeric segment.";
                         };
                         readonly repo: {
                             readonly type: "string";

package/dist/dependency/DepUtils.d.ts

@@ -5,15 +5,43 @@
  */
 export declare namespace DepUtils {
     /**
-     * Anything `git clone` accepts as a repository: a remote over one of the transports it speaks, or
-     * a local path of a repository. The name of a dependency is never derived from it, only the repo
-     * itself is.
+     * A repository in the canonical form `git clone` accepts: a remote over one of the transports it
+     * speaks, or a local path of a repository, always ending in `.git`. The name of a dependency is
+     * never derived from it, only the repo itself is.
      *
      * @remarks Every transport is spelled out so the accepted shapes are readable, but the `.git`
      * suffix is what all of them share and what {@link DepUtils.repo} enforces, so the last member is
      * the one that decides.
      */
     type Repo = `https://${string}.git` | `http://${string}.git` | `ssh://${string}.git` | `git://${string}.git` | `file://${string}.git` | `git@${string}.git` | `${string}.git`;
+    /**
+     * What a repository reference resolves to: the URL `git clone` is given and the name GitHub
+     * derives from it.
+     */
+    interface Reference {
+        /** The repository, canonical: a value {@link DepUtils.Repo} accepts whatever form it came in. */
+        repo: Repo;
+        /** The `<user>/<name>` GitHub derives, or `null` when the reference is not a GitHub one. **/
+        name: string | null;
+    }
+    /**
+     * Parses a repository reference into the repository git clones from and the name GitHub derives.
+     *
+     * A GitHub repository may be written as the bare `user/repo` shorthand, as an HTTP(S) URL or as an
+     * SCP like ssh address, with or without the `.git` suffix; every one of them is canonicalized to
+     * the same repository. Any other repository is accepted as it stands when it is a value
+     * {@link DepUtils.Repo} accepts, and carries no derivable name.
+     * @param reference - The repository reference as a user writes it.
+     * @returns The canonical repository and the derived name, `null` when there is none.
+     * @throws { Error } When the reference is not a clonable repository.
+     *
+     * @example
+     * ```ts
+     * DepUtils.parse('netfeez/omega');
+     * // { repo: 'https://github.com/netfeez/omega.git', name: 'netfeez/omega' }
+     * ```
+     */
+    function parse(reference: string): Reference;
     /**
      * Validates that the provided value is a repository `git clone` accepts, and says what it is not when
      * it does not: a URL with its scheme, an SCP like address or a local path of a repository.
@@ -31,18 +59,18 @@ export declare namespace DepUtils {
      */
     function repo(repo: unknown): asserts repo is Repo;
     /**
-     * Extracts the name a dependency is known by from its repository URL.
+     * Extracts the name a dependency is known by from its repository reference.
      *
      * Only a GitHub repository has a name that can be derived without asking, and the name it derives
      * is the one the alias of the dependency takes everywhere else, so it is derived here and nowhere
      * else.
-     * @param repo - The repository URL.
-     * @returns The repository name, as `<user>.<name>`.
+     * @param repo - The repository reference, in any of the forms {@link DepUtils.parse} accepts.
+     * @returns The repository name, as `<user>/<name>`.
      * @throws { Error } When the repository is not a GitHub one, saying the name has to be given.
      *
      * @example
      * ```ts
-     * DepUtils.getRepoName('https://github.com/NetFeez/omega.git'); // 'NetFeez.omega'
+     * DepUtils.getRepoName('https://github.com/NetFeez/omega.git'); // 'NetFeez/omega'
      * ```
      */
     function getRepoName(repo: string): string;

package/dist/dependency/DepUtils.js

@@ -11,14 +11,68 @@ export var DepUtils;
      */
     const CLONEABLE_REGEX = /^(?:(?:https?|ssh|git|file):\/\/|git@)\S+$|\S*\.git$/;
     /**
-     * Matches a github repository URL and captures its user and name, tolerating a missing `.git` suffix.
+     * Matches a GitHub repository over HTTP, with or without the `.git` suffix, and captures its user
+     * and name.
      */
-    const GITHUB_REPO_REGEX = /^(?:https:\/\/github\.com\/([^/]+)\/([^/.]+)(?:\.git)?|git@github\.com:([^/]+)\/([^/.]+)(?:\.git)?)$/;
+    const GITHUB_HTTP_REGEX = /^(https?):\/\/github\.com\/([^/]+)\/([^/]+?)(?:\.git)?\/?$/;
+    /**
+     * Matches a GitHub repository over SSH in the SCP like form, with or without the `.git` suffix and
+     * tolerating the stray slash some clients write after the colon (`git@github.com:/user/repo`).
+     */
+    const GITHUB_SSH_REGEX = /^git@github\.com:?\/?([^/]+)\/([^/]+?)(?:\.git)?$/;
+    /**
+     * Matches the bare `user/repo` shorthand GitHub itself accepts, without a scheme and with or
+     * without the `.git` suffix.
+     */
+    const GITHUB_SHORT_REGEX = /^([A-Za-z0-9][A-Za-z0-9._-]*)\/([A-Za-z0-9][A-Za-z0-9._-]*?)(?:\.git)?$/;
     /**
      * The suffix that tells a repository from anything else, checked on the value as a whole instead of
      * anchoring it, so a local path of a repository keeps validating wherever it lives.
      */
     const GIT_SUFFIX_REGEX = /\.git$/;
+    /**
+     * The failure every rejected reference is reported with, so a caller sees what was expected of it.
+     * @param reference - The value that was refused.
+     * @returns The error describing what a repository reference may be.
+     **/
+    function notClonable(reference) {
+        return new Error(`Not a clonable git repository: "${reference}". Pass a user/repo pair, a repository ending in .git, a URL git can clone, an ssh address or a local path of a repository.`);
+    }
+    /**
+     * Parses a repository reference into the repository git clones from and the name GitHub derives.
+     *
+     * A GitHub repository may be written as the bare `user/repo` shorthand, as an HTTP(S) URL or as an
+     * SCP like ssh address, with or without the `.git` suffix; every one of them is canonicalized to
+     * the same repository. Any other repository is accepted as it stands when it is a value
+     * {@link DepUtils.Repo} accepts, and carries no derivable name.
+     * @param reference - The repository reference as a user writes it.
+     * @returns The canonical repository and the derived name, `null` when there is none.
+     * @throws { Error } When the reference is not a clonable repository.
+     *
+     * @example
+     * ```ts
+     * DepUtils.parse('netfeez/omega');
+     * // { repo: 'https://github.com/netfeez/omega.git', name: 'netfeez/omega' }
+     * ```
+     */
+    function parse(reference) {
+        if (typeof reference !== 'string' || !reference.trim())
+            throw notClonable(reference);
+        const value = reference.trim();
+        const http = value.match(GITHUB_HTTP_REGEX);
+        if (http)
+            return { repo: `${http[1]}://github.com/${http[2]}/${http[3]}.git`, name: `${http[2]}/${http[3]}` };
+        const ssh = value.match(GITHUB_SSH_REGEX);
+        if (ssh)
+            return { repo: `git@github.com:${ssh[1]}/${ssh[2]}.git`, name: `${ssh[1]}/${ssh[2]}` };
+        const short = value.match(GITHUB_SHORT_REGEX);
+        if (short)
+            return { repo: `https://github.com/${short[1]}/${short[2]}.git`, name: `${short[1]}/${short[2]}` };
+        if (!CLONEABLE_REGEX.test(value) || !GIT_SUFFIX_REGEX.test(value))
+            throw notClonable(value);
+        return { repo: value, name: null };
+    }
+    DepUtils.parse = parse;
     /**
      * Validates that the provided value is a repository `git clone` accepts, and says what it is not when
      * it does not: a URL with its scheme, an SCP like address or a local path of a repository.
@@ -42,28 +96,25 @@ export var DepUtils;
     }
     DepUtils.repo = repo;
     /**
-     * Extracts the name a dependency is known by from its repository URL.
+     * Extracts the name a dependency is known by from its repository reference.
      *
      * Only a GitHub repository has a name that can be derived without asking, and the name it derives
      * is the one the alias of the dependency takes everywhere else, so it is derived here and nowhere
      * else.
-     * @param repo - The repository URL.
-     * @returns The repository name, as `<user>.<name>`.
+     * @param repo - The repository reference, in any of the forms {@link DepUtils.parse} accepts.
+     * @returns The repository name, as `<user>/<name>`.
      * @throws { Error } When the repository is not a GitHub one, saying the name has to be given.
      *
      * @example
      * ```ts
-     * DepUtils.getRepoName('https://github.com/NetFeez/omega.git'); // 'NetFeez.omega'
+     * DepUtils.getRepoName('https://github.com/NetFeez/omega.git'); // 'NetFeez/omega'
      * ```
      */
     function getRepoName(repo) {
-        const match = repo.match(GITHUB_REPO_REGEX);
-        if (match) {
-            const user = match[1] || match[3];
-            const repoName = match[2] || match[4];
-            return `${user}.${repoName}`;
-        }
-        throw new Error(`Cannot derive a name from "${repo}": only GitHub repositories are named automatically, pass the name yourself.`);
+        const { name } = parse(repo);
+        if (!name)
+            throw new Error(`Cannot derive a name from "${repo}": only GitHub repositories are named automatically, pass the name yourself.`);
+        return name;
     }
     DepUtils.getRepoName = getRepoName;
 })(DepUtils || (DepUtils = {}));

package/dist/dependency/DepUtils.js.map

@@ -1 +1 @@
-{"version":3,"file":"DepUtils.js","sourceRoot":"","sources":["../../src/dependency/DepUtils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,KAAW,QAAQ,CAiFxB;AAjFD,WAAiB,QAAQ;IAmBrB;;;OAGG;IACH,MAAM,eAAe,GAAG,sDAAsD,CAAC;IAE/E;;OAEG;IACH,MAAM,iBAAiB,GAAG,sGAAsG,CAAC;IAEjI;;;OAGG;IACH,MAAM,gBAAgB,GAAG,QAAQ,CAAC;IAElC;;;;;;;;;;;;;;OAcG;IACH,SAAgB,IAAI,CAAC,IAAa;QAC9B,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,IAAI,IAAI,CAAC,CAAC;QAC3G,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,IAAI,2GAA2G,CAAC,CAAC;IAChP,CAAC;IAHe,SAAA,IAAI,OAGnB,CAAA;IAED;;;;;;;;;;;;;;OAcG;IACH,SAAgB,WAAW,CAAC,IAAY;QACpC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QAC5C,IAAI,KAAK,EAAE,CAAC;YACR,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC;YAClC,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC;YACtC,OAAO,GAAG,IAAI,IAAI,QAAQ,EAAE,CAAC;QACjC,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,8BAA8B,IAAI,8EAA8E,CAAC,CAAC;IACtI,CAAC;IATe,SAAA,WAAW,cAS1B,CAAA;AACL,CAAC,EAjFgB,QAAQ,KAAR,QAAQ,QAiFxB;AAED,eAAe,QAAQ,CAAC"}
+{"version":3,"file":"DepUtils.js","sourceRoot":"","sources":["../../src/dependency/DepUtils.ts"],"names":[],"mappings":"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"}

package/dist/schema/Config/Config.d.ts

@@ -239,7 +239,7 @@ export declare const Config: Schema<{
                         readonly type: "string";
                         readonly required: true;
                         readonly pattern: RegExp;
-                        readonly description: "Unique name used to reference the dependency in flows and path aliases. It is an identity, not a path: a single alphanumeric segment.";
+                        readonly description: "Unique name used to reference the dependency in flows and path aliases. It is an identity, not an arbitrary path: a `<user>/<repo>` pair or a single alphanumeric segment.";
                     };
                     readonly repo: {
                         readonly type: "string";

package/dist/schema/Config/Dependency.d.ts

@@ -5,7 +5,7 @@
  */
 import Schema from '@netfeez/schema';
 export declare namespace DependencyName {
-    /** A single path segment: the identity of a git source, also the name of its checkout folder. */
+    /** A `user/repo` identity or a single segment: the identity of a git source, also the name of its checkout folder. */
     const GIT: RegExp;
     /** A package name, optionally scoped: the identity of an npm source. */
     const NPM: RegExp;
@@ -18,7 +18,7 @@ export declare const GitDependency: Schema<{
             readonly type: "string";
             readonly required: true;
             readonly pattern: RegExp;
-            readonly description: "Unique name used to reference the dependency in flows and path aliases. It is an identity, not a path: a single alphanumeric segment.";
+            readonly description: "Unique name used to reference the dependency in flows and path aliases. It is an identity, not an arbitrary path: a `<user>/<repo>` pair or a single alphanumeric segment.";
         };
         readonly repo: {
             readonly type: "string";
@@ -450,7 +450,7 @@ export declare const Dependency: {
                 readonly type: "string";
                 readonly required: true;
                 readonly pattern: RegExp;
-                readonly description: "Unique name used to reference the dependency in flows and path aliases. It is an identity, not a path: a single alphanumeric segment.";
+                readonly description: "Unique name used to reference the dependency in flows and path aliases. It is an identity, not an arbitrary path: a `<user>/<repo>` pair or a single alphanumeric segment.";
             };
             readonly repo: {
                 readonly type: "string";

package/dist/schema/Config/Dependency.js

@@ -13,8 +13,8 @@ export var DependencyName;
      * The identities the flow folder reserves for itself, declared once so no source can claim them.
      */
     const RESERVED = 'schema\\.json|node_modules';
-    /** A single path segment: the identity of a git source, also the name of its checkout folder. */
-    DependencyName.GIT = new RegExp(`^(?!(${RESERVED})$)[A-Za-z0-9][A-Za-z0-9._-]*$`);
+    /** A `user/repo` identity or a single segment: the identity of a git source, also the name of its checkout folder. */
+    DependencyName.GIT = new RegExp(`^(?!(?:${RESERVED})(?:/|$))[A-Za-z0-9][A-Za-z0-9._-]*(?:/[A-Za-z0-9][A-Za-z0-9._-]*)?$`);
     /** A package name, optionally scoped: the identity of an npm source. */
     DependencyName.NPM = new RegExp(`^(?!(${RESERVED})$)@?[A-Za-z0-9][A-Za-z0-9._~-]*(/[A-Za-z0-9][A-Za-z0-9._~-]*)?$`);
 })(DependencyName || (DependencyName = {}));
@@ -25,7 +25,7 @@ export const GitDependency = new Schema({
             type: 'string',
             required: true,
             pattern: DependencyName.GIT,
-            description: 'Unique name used to reference the dependency in flows and path aliases. It is an identity, not a path: a single alphanumeric segment.'
+            description: 'Unique name used to reference the dependency in flows and path aliases. It is an identity, not an arbitrary path: a `<user>/<repo>` pair or a single alphanumeric segment.'
         },
         repo: {
             type: 'string',

package/dist/schema/Config/Dependency.js.map

@@ -1 +1 @@
-{"version":3,"file":"Dependency.js","sourceRoot":"","sources":["../../../src/schema/Config/Dependency.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,MAAM,MAAM,iBAAiB,CAAC;AACrC,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,QAAQ,MAAM,eAAe,CAAC;AACrC,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC,MAAM,KAAW,cAAc,CAa9B;AAbD,WAAiB,cAAc;IAE3B;;OAEG;IACH,MAAM,QAAQ,GAAG,4BAA4B,CAAC;IAE9C,iGAAiG;IACpF,kBAAG,GAAW,IAAI,MAAM,CAAC,QAAQ,QAAQ,gCAAgC,CAAC,CAAC;IAExF,wEAAwE;IAC3D,kBAAG,GAAW,IAAI,MAAM,CAAC,QAAQ,QAAQ,kEAAkE,CAAC,CAAC;AAE9H,CAAC,EAbgB,cAAc,KAAd,cAAc,QAa9B;AAGD,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,MAAM,CAAC;IACpC,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE;QACF,IAAI,EAAE;YACF,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,IAAI;YACd,OAAO,EAAE,cAAc,CAAC,GAAG;YAC3B,WAAW,EAAE,uIAAuI;SACvJ;QACD,IAAI,EAAE;YACF,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,kDAAkD;SAClE;QACD,GAAG,EAAE;YACD,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,MAAM;YACf,WAAW,EAAE,2EAA2E;SAC3F;QACD,OAAO,EAAE;YACL,GAAG,OAAO,CAAC,UAAU;YACrB,IAAI,OAAO,KAAK,OAAO,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAC1C,WAAW,EAAE,sDAAsD;SACtE;QACD,QAAQ,EAAE;YACN,GAAG,QAAQ,CAAC,UAAU;YACtB,IAAI,OAAO,KAAK,OAAO,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YAC3C,WAAW,EAAE,yDAAyD;SACzE;KACJ;CACJ,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,MAAM,CAAC;IACpC,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE;QACF,IAAI,EAAE;YACF,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,IAAI;YACd,OAAO,EAAE,cAAc,CAAC,GAAG;YAC3B,WAAW,EAAE,iDAAiD;SACjE;QACD,OAAO,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,iDAAiD;SACjE;QACD,OAAO,EAAE;YACL,GAAG,OAAO,CAAC,UAAU;YACrB,IAAI,OAAO,KAAK,OAAO,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAC1C,WAAW,EAAE,sDAAsD;SACtE;QACD,QAAQ,EAAE;YACN,GAAG,QAAQ,CAAC,UAAU;YACtB,IAAI,OAAO,KAAK,OAAO,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YAC3C,WAAW,EAAE,yDAAyD;SACzE;KACJ;CACJ,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,aAAa,EAAE,aAAa,EAAE,CAAC;AAK3D,eAAe,UAAU,CAAC"}
+{"version":3,"file":"Dependency.js","sourceRoot":"","sources":["../../../src/schema/Config/Dependency.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,MAAM,MAAM,iBAAiB,CAAC;AACrC,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,QAAQ,MAAM,eAAe,CAAC;AACrC,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC,MAAM,KAAW,cAAc,CAa9B;AAbD,WAAiB,cAAc;IAE3B;;OAEG;IACH,MAAM,QAAQ,GAAG,4BAA4B,CAAC;IAE9C,sHAAsH;IACzG,kBAAG,GAAW,IAAI,MAAM,CAAC,UAAU,QAAQ,sEAAsE,CAAC,CAAC;IAEhI,wEAAwE;IAC3D,kBAAG,GAAW,IAAI,MAAM,CAAC,QAAQ,QAAQ,kEAAkE,CAAC,CAAC;AAE9H,CAAC,EAbgB,cAAc,KAAd,cAAc,QAa9B;AAGD,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,MAAM,CAAC;IACpC,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE;QACF,IAAI,EAAE;YACF,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,IAAI;YACd,OAAO,EAAE,cAAc,CAAC,GAAG;YAC3B,WAAW,EAAE,4KAA4K;SAC5L;QACD,IAAI,EAAE;YACF,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,kDAAkD;SAClE;QACD,GAAG,EAAE;YACD,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,MAAM;YACf,WAAW,EAAE,2EAA2E;SAC3F;QACD,OAAO,EAAE;YACL,GAAG,OAAO,CAAC,UAAU;YACrB,IAAI,OAAO,KAAK,OAAO,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAC1C,WAAW,EAAE,sDAAsD;SACtE;QACD,QAAQ,EAAE;YACN,GAAG,QAAQ,CAAC,UAAU;YACtB,IAAI,OAAO,KAAK,OAAO,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YAC3C,WAAW,EAAE,yDAAyD;SACzE;KACJ;CACJ,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,MAAM,CAAC;IACpC,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE;QACF,IAAI,EAAE;YACF,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,IAAI;YACd,OAAO,EAAE,cAAc,CAAC,GAAG;YAC3B,WAAW,EAAE,iDAAiD;SACjE;QACD,OAAO,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,iDAAiD;SACjE;QACD,OAAO,EAAE;YACL,GAAG,OAAO,CAAC,UAAU;YACrB,IAAI,OAAO,KAAK,OAAO,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAC1C,WAAW,EAAE,sDAAsD;SACtE;QACD,QAAQ,EAAE;YACN,GAAG,QAAQ,CAAC,UAAU;YACtB,IAAI,OAAO,KAAK,OAAO,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YAC3C,WAAW,EAAE,yDAAyD;SACzE;KACJ;CACJ,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,aAAa,EAAE,aAAa,EAAE,CAAC;AAK3D,eAAe,UAAU,CAAC"}

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "depflow",
   "description": "is a simple dependency manager based on github repositories",
-  "version": "3.0.0-dev.11",
+  "version": "3.0.0-dev.13",
   "main": "dist/cli/bin.js",
   "type": "module",
   "bin": {
-    "dep": "dist/cli/bin.js"
+    "dep": "dist/cli/bin.js",
+    "depflow": "dist/cli/bin.js"
   },
   "scripts": {
     "clean": "node ./scripts/clean.mjs",

package/dist/cli/DepFLowCLI.d.ts

@@ -1,93 +0,0 @@
-/**
- * @author NetFeez <netfeez.dev@gmail.com>.
- * @description Main CLI surface: dependency management commands, builds and config conversions.
- * @license Apache-2.0
- */
-import CLI from "./CLI.js";
-import OutputPolicy from "../task/OutputPolicy.js";
-import Flags from "./Flags.js";
-/** The flags accepted by every command of the CLI. **/
-export declare const options: Flags<{
-    readonly flow: {
-        readonly type: "string";
-        readonly default: "depflow.yml";
-        readonly aliases: readonly ["p", "f"];
-        readonly description: "Path to the configuration file the command operates on.";
-    };
-    readonly watch: {
-        readonly type: "boolean";
-        readonly default: false;
-        readonly aliases: readonly ["w"];
-        readonly description: "Keeps watching the built files and rewrites their paths on every change.";
-    };
-    readonly cdn: {
-        readonly type: "boolean";
-        readonly default: false;
-        readonly description: "Resolves the dependency paths to their CDN target instead of their local one.";
-    };
-    readonly verbose: {
-        readonly type: "boolean";
-        readonly default: false;
-        readonly aliases: readonly ["v"];
-        readonly description: "Streams the output of every command as it runs, attributed to the command that wrote it, instead of only reporting how each of them ended. The indentation of that output is lost, and the complete buffer of every command reaches the evidence file whether this flag is given or not.";
-    };
-    readonly silent: {
-        readonly type: "boolean";
-        readonly default: false;
-        readonly description: "Says only what failed, one line per failed command. It silences the progress of DepFlow itself, such as \"Installing dependencies...\", and not the help, which belongs to the console interface. The exit status and the evidence file are the same as in any other mode.";
-    };
-    readonly decorate: {
-        readonly type: "boolean";
-        readonly default: true;
-        readonly description: "Draws boxes, indentation, timestamps, levels and names around what is reported. --decorate=false leaves the content alone and keeps the color of the markers and the diagnostics, which carry information and are not decoration.";
-    };
-}>;
-export declare class DepFlowCLI extends CLI {
-    readonly configPath: string;
-    protected readonly projectRoot: string;
-    constructor(configPath?: string);
-    /** Absolute path of the flow directory (`.depflow`) under the project root. **/
-    protected get flowDirectory(): string;
-    /**
-     * The policy the run is presented through, built for the mode the flags asked for.
-     * @param flags - The flags of the command being run.
-     * @returns The policy of the run, never `null`: the evidence is written whether it is asked for or not.
-     *
-     * @remarks The policy is also what settles the channel the lifecycle of the CLI is reported through, so
-     * every command asks for it first and reports through `policy.report`: a `silent` run that said
-     * "Installing dependencies..." would not be silent, and an undecorated run would still draw boxes
-     * around lines that carry nothing but what they say.
-     *
-     * @remarks A command reports through the policy and not through `this.out`, which belongs to the
-     * console interface DepFlow was built on: the help, the prompt and the verdict of an invocation are
-     * drawn by surfaces DepFlow does not own, and they stay visible in every mode.
-     *
-     * @example
-     * ```ts
-     * const policy = this.policy(flags);
-     * const out = policy.report;
-     * if (policy.decoration === 'on') out.group(Group.create('#FFB4DC'));
-     * ```
-     */
-    protected policy(flags: DepFlowCLI.Options): OutputPolicy;
-    commandAdd(command: string, args: string[], flags?: DepFlowCLI.Options): Promise<void>;
-    commandRemove(command: string, args: string[], flags?: DepFlowCLI.Options): Promise<void>;
-    commandInstall(command: string, args: string[], flags?: DepFlowCLI.Options): Promise<void>;
-    commandRun(command: string, args: string[], flags?: DepFlowCLI.Options): Promise<void>;
-    list(command: string, args: string[], flags?: DepFlowCLI.Options): Promise<void>;
-    rewritePaths(command: string, args: string[], flags?: DepFlowCLI.Options): Promise<void>;
-    commandSync(command: string, args: string[], flags?: DepFlowCLI.Options, caller?: OutputPolicy): Promise<void>;
-    /**
-     * Converts the depflow config file between JSON and YAML.
-     * @param command - The invoked command name ('json-to-yaml' or 'yaml-to-json').
-     * @param args - Optional output file path.
-     * @param flags - The flags of the command being run, which settle how the conversion is reported.
-     */
-    convert(command: string, args: string[], flags?: DepFlowCLI.Options): Promise<void>;
-}
-export declare namespace DepFlowCLI {
-    type Exec = (this: DepFlowCLI, command: string, args: string[], flags: Options) => Promise<void> | void;
-    /** The values of the flags accepted by the CLI. **/
-    type Options = typeof options.infer;
-}
-export default DepFlowCLI;