elrh-cosca 0.2.5 → 0.2.7

package/README.md

@@ -21,7 +21,7 @@ async function createFileFromTemplate(
 ): Promise<void>
 ```
 
-Takes a path to a template file from your project and will create a fresh copy in target project when invoked. 
+Gets a file definition from given `templateFile` and will create a fresh copy in target project.
 
 Path to `templateFile` must be prefixed with the package name to allow proper resolution, e.g. `your-package:path/to/template`. The package name can be scoped.
 
@@ -37,9 +37,9 @@ async function createFileWebFromTemplate(
 ): Promise<void>
 ```
 
-Gets a file definition from given `url` and will create a fresh copy in target project when invoked. 
+Gets a file definition from given `url` and will create a fresh copy in target project. 
 
-Contents of `url` must be accessible via `node:https.get` function and will be fetched as raw string data.
+Contents of `url` must be accessible via `node:https.get` function and will be fetched as raw text data.
 
 Path to `targetFile` is relative to `process.cwd()` which allows consumers to run `npx your-script` in their project roots during development.
 
@@ -102,11 +102,16 @@ By default the function asks for confirmation before attempting to alter the `ta
 #### `promptUser`
 
 ```ts
-async function promptUser(question: string): Promise<boolean>
+async function promptUser(
+  question: string,
+  options?: { input?: NodeJS.ReadableStream; output?: NodeJS.WritableStream }
+): Promise<boolean>
 ```
 
 Prints out a `question` to the console and waits for the input. Returns `true` when `y` is pressed and `false` otherwise.
 
+By default it uses `process.stdin` and `process.stdout` streams. To use custom NodeJS streams, `options` object with `input` and `output` properties can be optionally passed.
+
 #### `showMessage`
 
 ```ts

package/dist/elrh-cosca.mjs

@@ -1,16 +1,20 @@
-import { join as Ps, resolve as Qe } from "node:path";
-import { readFileSync as ss, access as Sa, constants as Ea, existsSync as ut, copyFileSync as Aa, writeFileSync as is, promises as wa } from "node:fs";
+import { join as Ps, resolve as Ye } from "node:path";
+import { readFileSync as ss, access as Sa, constants as Ea, existsSync as We, copyFileSync as Aa, writeFileSync as is, promises as wa } from "node:fs";
 import va from "node:readline";
 import Ca from "node:https";
 import "fs";
-async function Ye(a) {
-  const l = va.createInterface({
-    input: process.stdin,
-    output: process.stdout
+async function Ze(a, l) {
+  const i = va.createInterface({
+    input: l?.input || process.stdin,
+    output: l?.output || process.stdout
   });
-  return new Promise((i) => {
-    l.question(a + " (y/N): ", (r) => {
-      l.close(), i(/^y(es)?$/i.test(r.trim()));
+  return new Promise((r) => {
+    i.question(a + " (y/N): ", (o) => {
+      i.close();
+      const u = o.trim().toLowerCase();
+      r(/^y(es)?$/.test(u));
+    }), i.on("SIGINT", () => {
+      i.close();
     });
   });
 }
@@ -46,19 +50,22 @@ function Na(a) {
   throw new Error(`Cannot find package "${a}" from ${process.cwd()}. Make sure it's installed or linked in this project.`);
 }
 async function Il(a, l, i = !1, r = "") {
-  if (i || await Ye(
+  if (i || await Ze(
     r || `This will create '${l}' file. Continue?`
   )) {
-    const { pkg: u, file: h } = Ia(a), d = Na(u), g = Qe(d, h), b = Qe(process.cwd(), l);
-    if (!ut(g))
+    const { pkg: u, file: h } = Ia(a), d = Na(u), g = Ye(d, h), b = Ye(process.cwd(), l);
+    if (!We(g))
       throw new Error(`Template file not found at ${g}`);
-    if (ut(b) && !(i || await Ye(
+    if (We(b) && !(i || await Ze(
       `File '${l}' already exists. Overwrite?`
     ))) {
       console.log("Aborted.");
       return;
     }
-    Aa(g, b), console.log(`New file '${l}' successfully created.`);
+    if (Aa(g, b), We(b))
+      console.log(`New file '${l}' successfully created.`);
+    else
+      throw new Error(`Failed to create '${l}'.`);
   } else
     console.log(`Creation of '${l}' skipped.`);
 }
@@ -75,7 +82,7 @@ async function ka(a) {
   });
 }
 async function Nl(a, l, i = !1, r = "") {
-  if (i || await Ye(
+  if (i || await Ze(
     r || `This will create '${l}' file. Continue?`
   )) {
     let u;
@@ -85,14 +92,17 @@ async function Nl(a, l, i = !1, r = "") {
       throw new Error(`Failed to fetch template from external source ${a}:
 ${d}`);
     }
-    const h = Qe(process.cwd(), l);
-    if (ut(h) && !(i || await Ye(
+    const h = Ye(process.cwd(), l);
+    if (We(h) && !(i || await Ze(
       `File '${l}' already exists. Overwrite?`
     ))) {
       console.log("Aborted.");
       return;
     }
-    is(h, u, "utf8"), console.log(`New file '${l}' successfully created.`);
+    if (is(h, u, "utf8"), We(h))
+      console.log(`New file '${l}' successfully created.`);
+    else
+      throw new Error(`Failed to create '${l}'.`);
   } else
     console.log(`Creation of '${l}' skipped.`);
 }
@@ -1096,10 +1106,10 @@ function ja() {
 }
 var Ra = ja();
 const Us = /* @__PURE__ */ La(Ra);
-var it = {}, rr;
+var rt = {}, rr;
 function Ua() {
-  if (rr) return it;
-  rr = 1, Object.defineProperty(it, "__esModule", {
+  if (rr) return rt;
+  rr = 1, Object.defineProperty(rt, "__esModule", {
     value: !0
   });
   function a(p, t) {
@@ -1838,7 +1848,7 @@ function Ua() {
     var e, s, n, c;
     return ++z, Ne.set(p, z), X.push(p), Y.push((e = t.binop) != null ? e : -1), re.push((s = t.beforeExpr) != null ? s : !1), ne.push((n = t.startsExpr) != null ? n : !1), oe.push((c = t.prefix) != null ? c : !1), V.push(new Fe("name", t)), z;
   }
-  const Ze = {
+  const et = {
     bracketL: J("[", {
       beforeExpr: _,
       startsExpr: N
@@ -2236,7 +2246,7 @@ function Ua() {
   function se(p) {
     return p >= 93 && p <= 133;
   }
-  function Je(p) {
+  function He(p) {
     return p <= 92;
   }
   function Se(p) {
@@ -2317,7 +2327,7 @@ function Ua() {
   function _e(p) {
     return p < 65 ? p === 36 : p <= 90 ? !0 : p < 97 ? p === 95 : p <= 122 ? !0 : p <= 65535 ? p >= 170 && fn.test(String.fromCharCode(p)) : cs(p, Ks);
   }
-  function et(p) {
+  function tt(p) {
     return p < 48 ? p === 36 : p < 58 ? !0 : p < 65 ? !1 : p <= 90 ? !0 : p < 97 ? p === 95 : p <= 122 ? !0 : p <= 65535 ? p >= 170 && dn.test(String.fromCharCode(p)) : cs(p, Ks) || cs(p, mn);
   }
   const us = {
@@ -2883,8 +2893,8 @@ function Ua() {
             const qe = this.lookahead();
             Mt(qe.type) && (le = this.state.value, this.next());
           }
-          const Ke = this.flowParseObjectTypeProperty(fe, W, K, te, le, n, f ?? !C);
-          Ke === null ? (F = !0, ee = this.state.lastTokStartLoc) : x.properties.push(Ke);
+          const Xe = this.flowParseObjectTypeProperty(fe, W, K, te, le, n, f ?? !C);
+          Xe === null ? (F = !0, ee = this.state.lastTokStartLoc) : x.properties.push(Xe);
         }
         this.flowObjectTypeSemicolon(), ee && !this.match(8) && !this.match(9) && this.raise(G.UnexpectedExplicitInexactInObject, ee);
       }
@@ -4144,7 +4154,7 @@ function Ua() {
     hearts: "♥",
     diams: "♦"
   }, On = /\r\n|[\r\n\u2028\u2029]/, _t = new RegExp(On.source, "g");
-  function tt(p) {
+  function st(p) {
     switch (p) {
       case 10:
       case 13:
@@ -4157,7 +4167,7 @@ function Ua() {
   }
   function ei(p, t, e) {
     for (let s = t; s < e; s++)
-      if (tt(p.charCodeAt(s)))
+      if (st(p.charCodeAt(s)))
         return !0;
     return !1;
   }
@@ -4190,7 +4200,7 @@ function Ua() {
         return !1;
     }
   }
-  const He = P`jsx`({
+  const Ke = P`jsx`({
     AttributeIsEmpty: "JSX attributes must only be assigned a non-empty expression.",
     MissingClosingTagElement: ({
       openingTagName: p
@@ -4208,13 +4218,13 @@ function Ua() {
   function Ue(p) {
     return p ? p.type === "JSXOpeningFragment" || p.type === "JSXClosingFragment" : !1;
   }
-  function st(p) {
+  function it(p) {
     if (p.type === "JSXIdentifier")
       return p.name;
     if (p.type === "JSXNamespacedName")
       return p.namespace.name + ":" + p.name.name;
     if (p.type === "JSXMemberExpression")
-      return st(p.object) + "." + st(p.property);
+      return it(p.object) + "." + it(p.property);
     throw new Error("Node had unexpected type: " + p.type);
   }
   var Mn = (p) => class extends p {
@@ -4222,7 +4232,7 @@ function Ua() {
       let e = "", s = this.state.pos;
       for (; ; ) {
         if (this.state.pos >= this.length)
-          throw this.raise(He.UnterminatedJsxContent, this.state.startLoc);
+          throw this.raise(Ke.UnterminatedJsxContent, this.state.startLoc);
         const n = this.input.charCodeAt(this.state.pos);
         switch (n) {
           case 60:
@@ -4239,7 +4249,7 @@ function Ua() {
           case 62:
           case 125:
           default:
-            tt(n) ? (e += this.input.slice(s, this.state.pos), e += this.jsxReadNewLine(!0), s = this.state.pos) : ++this.state.pos;
+            st(n) ? (e += this.input.slice(s, this.state.pos), e += this.jsxReadNewLine(!0), s = this.state.pos) : ++this.state.pos;
         }
       }
     }
@@ -4257,7 +4267,7 @@ function Ua() {
           throw this.raise(m.UnterminatedString, this.state.startLoc);
         const c = this.input.charCodeAt(this.state.pos);
         if (c === e) break;
-        c === 38 ? (s += this.input.slice(n, this.state.pos), s += this.jsxReadEntity(), n = this.state.pos) : tt(c) ? (s += this.input.slice(n, this.state.pos), s += this.jsxReadNewLine(!1), n = this.state.pos) : ++this.state.pos;
+        c === 38 ? (s += this.input.slice(n, this.state.pos), s += this.jsxReadEntity(), n = this.state.pos) : st(c) ? (s += this.input.slice(n, this.state.pos), s += this.jsxReadNewLine(!1), n = this.state.pos) : ++this.state.pos;
       }
       s += this.input.slice(n, this.state.pos++), this.finishToken(134, s);
     }
@@ -4287,7 +4297,7 @@ function Ua() {
       const s = this.state.pos;
       do
         e = this.input.charCodeAt(++this.state.pos);
-      while (et(e) || e === 45);
+      while (tt(e) || e === 45);
       this.finishToken(141, this.input.slice(s, this.state.pos));
     }
     jsxParseIdentifier() {
@@ -4315,12 +4325,12 @@ function Ua() {
       let e;
       switch (this.state.type) {
         case 5:
-          return e = this.startNode(), this.setContext(k.brace), this.next(), e = this.jsxParseExpressionContainer(e, k.j_oTag), e.expression.type === "JSXEmptyExpression" && this.raise(He.AttributeIsEmpty, e), e;
+          return e = this.startNode(), this.setContext(k.brace), this.next(), e = this.jsxParseExpressionContainer(e, k.j_oTag), e.expression.type === "JSXEmptyExpression" && this.raise(Ke.AttributeIsEmpty, e), e;
         case 143:
         case 134:
           return this.parseExprAtom();
         default:
-          throw this.raise(He.UnsupportedJsxValue, this.state.startLoc);
+          throw this.raise(Ke.UnsupportedJsxValue, this.state.startLoc);
       }
     }
     jsxParseEmptyExpression() {
@@ -4381,14 +4391,14 @@ function Ua() {
             default:
               this.unexpected();
           }
-        Ue(c) && !Ue(f) && f !== null ? this.raise(He.MissingClosingTagFragment, f) : !Ue(c) && Ue(f) ? this.raise(He.MissingClosingTagElement, f, {
-          openingTagName: st(c.name)
-        }) : !Ue(c) && !Ue(f) && st(f.name) !== st(c.name) && this.raise(He.MissingClosingTagElement, f, {
-          openingTagName: st(c.name)
+        Ue(c) && !Ue(f) && f !== null ? this.raise(Ke.MissingClosingTagFragment, f) : !Ue(c) && Ue(f) ? this.raise(Ke.MissingClosingTagElement, f, {
+          openingTagName: it(c.name)
+        }) : !Ue(c) && !Ue(f) && it(f.name) !== it(c.name) && this.raise(Ke.MissingClosingTagElement, f, {
+          openingTagName: it(c.name)
         });
       }
       if (Ue(c) ? (s.openingFragment = c, s.closingFragment = f) : (s.openingElement = c, s.closingElement = f), s.children = n, this.match(47))
-        throw this.raise(He.UnwrappedAdjacentJSXElements, this.state.startLoc);
+        throw this.raise(Ke.UnwrappedAdjacentJSXElements, this.state.startLoc);
       return Ue(c) ? this.finishNode(s, "JSXFragment") : this.finishNode(s, "JSXElement");
     }
     jsxParseElement() {
@@ -4951,9 +4961,9 @@ function Ua() {
       const te = p.charCodeAt(t);
       let le;
       if (te === 95 && y !== "bail") {
-        const Ke = p.charCodeAt(t - 1), qe = p.charCodeAt(t + 1);
+        const Xe = p.charCodeAt(t - 1), qe = p.charCodeAt(t + 1);
         if (y) {
-          if (Number.isNaN(qe) || !$(qe) || F.has(Ke) || F.has(qe)) {
+          if (Number.isNaN(qe) || !$(qe) || F.has(Xe) || F.has(qe)) {
             if (E) return {
               n: null,
               pos: t
@@ -5153,7 +5163,7 @@ function Ua() {
       this.isLookahead || (s = this.state.curPosition());
       let n = this.input.charCodeAt(this.state.pos += t);
       if (this.state.pos < this.length)
-        for (; !tt(n) && ++this.state.pos < this.length; )
+        for (; !st(n) && ++this.state.pos < this.length; )
           n = this.input.charCodeAt(this.state.pos);
       if (this.isLookahead) return;
       const c = this.state.pos, y = {
@@ -5267,7 +5277,7 @@ function Ua() {
       let t = this.input.charCodeAt(this.state.pos + 1);
       if (t !== 33) return !1;
       const e = this.state.pos;
-      for (this.state.pos += 1; !tt(t) && ++this.state.pos < this.length; )
+      for (this.state.pos += 1; !st(t) && ++this.state.pos < this.length; )
         t = this.input.charCodeAt(this.state.pos);
       const s = this.input.slice(e + 2, this.state.pos);
       return this.finishToken(28, s), !0;
@@ -5521,7 +5531,7 @@ function Ua() {
         if (c >= this.length)
           throw this.raise(m.UnterminatedRegExp, r(t, 1));
         const E = this.input.charCodeAt(c);
-        if (tt(E))
+        if (st(E))
           throw this.raise(m.UnterminatedRegExp, r(t, 1));
         if (s)
           s = !1;
@@ -5543,7 +5553,7 @@ function Ua() {
         const E = this.codePointAtPos(c), C = String.fromCharCode(E);
         if (zn.has(E))
           E === 118 ? y.includes("u") && this.raise(m.IncompatibleRegExpUVFlags, x()) : E === 117 && y.includes("v") && this.raise(m.IncompatibleRegExpUVFlags, x()), y.includes(C) && this.raise(m.DuplicateRegExpFlags, x());
-        else if (et(E) || E === 92)
+        else if (tt(E) || E === 92)
           this.raise(m.MalformedRegExpFlags, x());
         else
           break;
@@ -5655,11 +5665,11 @@ function Ua() {
       let n = this.state.pos;
       for (t !== void 0 && (this.state.pos += t <= 65535 ? 1 : 2); this.state.pos < this.length; ) {
         const c = this.codePointAtPos(this.state.pos);
-        if (et(c))
+        if (tt(c))
           this.state.pos += c <= 65535 ? 1 : 2;
         else if (c === 92) {
           this.state.containsEsc = !0, e += this.input.slice(n, this.state.pos);
-          const f = this.state.curPosition(), y = this.state.pos === s ? _e : et;
+          const f = this.state.curPosition(), y = this.state.pos === s ? _e : tt;
           if (this.input.charCodeAt(++this.state.pos) !== 117) {
             this.raise(m.MissingUnicodeEscape, this.state.curPosition()), n = this.state.pos - 1;
             continue;
@@ -5884,7 +5894,7 @@ function Ua() {
     isUnparsedContextual(t, e) {
       if (this.input.startsWith(e, t)) {
         const s = this.input.charCodeAt(t + e.length);
-        return !(et(s) || (s & 64512) === 55296);
+        return !(tt(s) || (s & 64512) === 55296);
       }
       return !1;
     }
@@ -7930,7 +7940,7 @@ function Ua() {
       e[$] = E ? "type" : "value", C && this.eatContextual(93) && (e[f] = s ? this.parseIdentifier() : this.parseModuleExportName()), e[f] || (e[f] = this.cloneIdentifier(e[c])), s && this.checkIdentifier(e[f], E ? 4098 : 4096);
     }
     fillOptionalPropertiesForTSESLint(e) {
-      var s, n, c, f, y, x, E, C, F, $, W, K, ee, fe, te, le, Ke, qe, bi, Pi, Ti, Si, Ei, Ai, wi, vi, Ci, Ii, Ni, ki, Li, Oi, Di, Mi, Fi, Bi, _i, ji, Ri, Ui, $i, Vi, qi, zi, Wi, Ji;
+      var s, n, c, f, y, x, E, C, F, $, W, K, ee, fe, te, le, Xe, qe, bi, Pi, Ti, Si, Ei, Ai, wi, vi, Ci, Ii, Ni, ki, Li, Oi, Di, Mi, Fi, Bi, _i, ji, Ri, Ui, $i, Vi, qi, zi, Wi, Ji;
       switch (e.type) {
         case "ExpressionStatement":
           (s = e.directive) != null || (e.directive = void 0);
@@ -7962,7 +7972,7 @@ function Ua() {
         case "TSPropertySignature":
           (fe = e.optional) != null || (e.optional = !1);
         case "TSIndexSignature":
-          (te = e.accessibility) != null || (e.accessibility = void 0), (le = e.readonly) != null || (e.readonly = !1), (Ke = e.static) != null || (e.static = !1);
+          (te = e.accessibility) != null || (e.accessibility = void 0), (le = e.readonly) != null || (e.readonly = !1), (Xe = e.static) != null || (e.static = !1);
           return;
         case "TSAbstractPropertyDefinition":
         case "PropertyDefinition":
@@ -9114,7 +9124,7 @@ function Ua() {
         type: n
       } = this.state;
       Se(n) ? e = this.state.value : this.unexpected();
-      const c = Je(n);
+      const c = He(n);
       return t ? c && this.replaceToken(132) : this.checkReservedWord(e, s, c, !1), this.next(), e;
     }
     checkReservedWord(t, e, s, n) {
@@ -9490,7 +9500,7 @@ function Ua() {
       if (_e(t)) {
         if (bs.lastIndex = e, bs.test(this.input)) {
           const s = this.codePointAtPos(bs.lastIndex);
-          if (!et(s) && s !== 92)
+          if (!tt(s) && s !== 92)
             return !1;
         }
         return !0;
@@ -10453,7 +10463,7 @@ function Ua() {
       t[e] = Be(p[e]);
     return t;
   }
-  const Pa = ba(Ze);
+  const Pa = ba(et);
   function mt(p, t) {
     let e = gi;
     const s = /* @__PURE__ */ new Map();
@@ -10481,7 +10491,7 @@ function Ua() {
     }
     return s;
   }
-  return it.parse = ga, it.parseExpression = xa, it.tokTypes = Pa, it;
+  return rt.parse = ga, rt.parseExpression = xa, rt.tokTypes = Pa, rt;
 }
 var $a = Ua();
 function we(a) {
@@ -10769,22 +10779,22 @@ function pe(a) {
           var Q = this.allFields;
           if (!ve.call(Q, ne))
             throw new Error("" + ne);
-          var Ze = Q[ne], se = Ze.type, Je;
+          var et = Q[ne], se = et.type, He;
           if (J)
-            Je = oe;
-          else if (Ze.defaultFn)
-            Je = Ze.defaultFn.call(re);
+            He = oe;
+          else if (et.defaultFn)
+            He = et.defaultFn.call(re);
           else {
             var Se = "no value or default function given for field " + JSON.stringify(ne) + " of " + this.typeName + "(" + this.buildParams.map(function(Mt) {
               return Q[Mt];
             }).join(", ") + ")";
             throw new Error(Se);
           }
-          if (!se.check(Je))
+          if (!se.check(He))
             throw new Error(
-              $s(Je) + " does not match field " + Ze + " of type " + this.typeName
+              $s(He) + " does not match field " + et + " of type " + this.typeName
             );
-          re[ne] = Je;
+          re[ne] = He;
         }
       }, Y = (...re) => {
         var ne = re.length;
@@ -11137,7 +11147,7 @@ function Cr(a) {
   }, o;
 }
 ae(() => module);
-var rt = Object.prototype.hasOwnProperty;
+var nt = Object.prototype.hasOwnProperty;
 function Wa(a) {
   var l = a.use(pe), i = l.Type, r = l.namedTypes, o = r.Node, u = r.Expression, h = l.builtInTypes.array, d = l.builders;
   const g = function D(B, R) {
@@ -11187,9 +11197,9 @@ function Wa(a) {
   };
   var v = g.prototype;
   v.didScan = !1, v.declares = function(D) {
-    return this.scan(), rt.call(this.bindings, D);
+    return this.scan(), nt.call(this.bindings, D);
   }, v.declaresType = function(D) {
-    return this.scan(), rt.call(this.types, D);
+    return this.scan(), nt.call(this.types, D);
   }, v.declareTemporary = function(D) {
     if (D) {
       if (!/^[a-z$_]/i.test(D))
@@ -11267,7 +11277,7 @@ function Wa(a) {
     else if (b.check(q)) {
       if (r.CatchClause.check(q) && // TODO Broaden this to accept any pattern.
       r.Identifier.check(q.param)) {
-        var M = q.param.name, k = rt.call(B, M);
+        var M = q.param.name, k = nt.call(B, M);
         T(D.get("body"), B, R), k || delete B[M];
       }
     } else
@@ -11275,7 +11285,7 @@ function Wa(a) {
   }
   function m(D, B) {
     var R = D.value;
-    r.Pattern.assert(R), r.Identifier.check(R) ? rt.call(B, R.name) ? B[R.name].push(D) : B[R.name] = [D] : r.AssignmentPattern && r.AssignmentPattern.check(R) ? m(D.get("left"), B) : r.ObjectPattern && r.ObjectPattern.check(R) ? D.get("properties").each(function(q) {
+    r.Pattern.assert(R), r.Identifier.check(R) ? nt.call(B, R.name) ? B[R.name].push(D) : B[R.name] = [D] : r.AssignmentPattern && r.AssignmentPattern.check(R) ? m(D.get("left"), B) : r.ObjectPattern && r.ObjectPattern.check(R) ? D.get("properties").each(function(q) {
       var M = q.value;
       r.Pattern.check(M) ? m(q, B) : r.Property.check(M) || r.ObjectProperty && r.ObjectProperty.check(M) ? m(q.get("value"), B) : r.SpreadProperty && r.SpreadProperty.check(M) && m(q.get("argument"), B);
     }) : r.ArrayPattern && r.ArrayPattern.check(R) ? D.get("elements").each(function(q) {
@@ -11285,11 +11295,11 @@ function Wa(a) {
   }
   function O(D, B) {
     var R = D.value;
-    r.Pattern.assert(R), r.Identifier.check(R) && (rt.call(B, R.name) ? B[R.name].push(D) : B[R.name] = [D]);
+    r.Pattern.assert(R), r.Identifier.check(R) && (nt.call(B, R.name) ? B[R.name].push(D) : B[R.name] = [D]);
   }
   function U(D, B) {
     var R = D.value;
-    w.assert(R), rt.call(B, R.name) ? B[R.name].push(D) : B[R.name] = [D];
+    w.assert(R), nt.call(B, R.name) ? B[R.name].push(D) : B[R.name] = [D];
   }
   return v.lookup = function(D) {
     for (var B = this; B && !B.declares(D); B = B.parent)
@@ -12682,7 +12692,7 @@ function go(...a) {
 function ie(a, l) {
   return a.line - l.line || a.column - l.column;
 }
-function We(a) {
+function Je(a) {
   return {
     line: a.line,
     column: a.column
@@ -12707,7 +12717,7 @@ function xo(a, l) {
       return;
     o.addMapping({
       source: g,
-      original: We(d),
+      original: Je(d),
       generated: {
         line: h.generatedLine,
         column: h.generatedColumn
@@ -12728,7 +12738,7 @@ function Br(a, l) {
   function r(o) {
     Os(i, o.loc);
   }
-  return a.declaration && a.declaration.decorators && rs(a) && a.declaration.decorators.forEach(r), ie(i.start, i.end) < 0 && (i.start = We(i.start), l.skipSpaces(i.start, !1, !0), ie(i.start, i.end) < 0 && (i.end = We(i.end), l.skipSpaces(i.end, !0, !0))), a.comments && a.comments.forEach(r), i;
+  return a.declaration && a.declaration.decorators && rs(a) && a.declaration.decorators.forEach(r), ie(i.start, i.end) < 0 && (i.start = Je(i.start), l.skipSpaces(i.start, !1, !0), ie(i.start, i.end) < 0 && (i.end = Je(i.end), l.skipSpaces(i.end, !0, !0))), a.comments && a.comments.forEach(r), i;
 }
 function Os(a, l) {
   a && l && (ie(l.start, a.start) < 0 && (a.start = l.start), ie(a.end, l.end) < 0 && (a.end = l.end));
@@ -12750,14 +12760,14 @@ function Vs(a, l) {
   else if (a.type === "ObjectTypeProperty") {
     const r = a.loc;
     let o = r && r.end;
-    o && (o = We(o), l.prevPos(o) && l.charAt(o) === "," && (o = l.skipSpaces(o, !0, !0)) && (r.end = o));
+    o && (o = Je(o), l.prevPos(o) && l.charAt(o) === "," && (o = l.skipSpaces(o, !0, !0)) && (r.end = o));
   }
 }
 function bo(a, l) {
   if (a.type !== "ForStatement")
     return;
   function i(r) {
-    const o = r && r.loc, u = o && o.start, h = o && We(o.end);
+    const o = r && r.loc, u = o && o.start, h = o && Je(o.end);
     for (; u && h && ie(u, h) < 0 && (l.prevPos(h), l.charAt(h) === ";"); )
       o.end.line = h.line, o.end.column = h.column;
   }
@@ -12766,9 +12776,9 @@ function bo(a, l) {
 function Po(a, l) {
   if (a.type === "TemplateLiteral" && a.quasis.length !== 0) {
     if (a.loc) {
-      const i = We(a.loc.start), r = a.quasis[0];
+      const i = Je(a.loc.start), r = a.quasis[0];
       ie(r.loc.start, i) < 0 && (r.loc.start = i);
-      const o = We(a.loc.end), u = a.quasis[a.quasis.length - 1];
+      const o = Je(a.loc.end), u = a.quasis[a.quasis.length - 1];
       ie(o, u.loc.end) < 0 && (u.loc.end = o);
     }
     a.expressions.forEach(function(i, r) {
@@ -12854,7 +12864,7 @@ function ns(a) {
     tokens: !!i("tokens")
   };
 }
-class ct {
+class ut {
   constructor(l, i, r = i) {
     this.sourceLines = l, this.sourceLoc = i, this.targetLoc = r;
   }
@@ -12908,16 +12918,16 @@ class ct {
         end: ze(r, i.line, i.column)
       });
     }
-    return new ct(this.sourceLines, u, h);
+    return new ut(this.sourceLines, u, h);
   }
   add(l, i) {
-    return new ct(this.sourceLines, this.sourceLoc, {
+    return new ut(this.sourceLines, this.sourceLoc, {
       start: hr(this.targetLoc.start, l, i),
       end: hr(this.targetLoc.end, l, i)
     });
   }
   subtract(l, i) {
-    return new ct(this.sourceLines, this.sourceLoc, {
+    return new ut(this.sourceLines, this.sourceLoc, {
       start: ze(this.targetLoc.start, l, i),
       end: ze(this.targetLoc.end, l, i)
     });
@@ -12946,7 +12956,7 @@ class ct {
         column: r ? Math.max(0, d) : d
       };
     }
-    return new ct(this.sourceLines, this.sourceLoc, o);
+    return new ut(this.sourceLines, this.sourceLoc, o);
   }
 }
 function hr(a, l, i) {
@@ -12983,7 +12993,7 @@ var Eo = Object.defineProperty, Ao = (a, l, i) => l in a ? Eo(a, l, { enumerable
 class ke {
   constructor(l, i = null) {
     this.infos = l, bt(this, "length"), bt(this, "name"), bt(this, "mappings", []), bt(this, "cachedSourceMap", null), bt(this, "cachedTabWidth"), this.length = l.length, this.name = i || null, this.name && this.mappings.push(
-      new ct(this, {
+      new ut(this, {
         start: this.firstPos(),
         end: this.lastPos()
       })
@@ -13111,7 +13121,7 @@ class ke {
     let i = 0;
     for (let u = 1, h = this.length; u <= h; ++u) {
       const d = this.infos[u - 1], g = d.line.slice(d.sliceStart, d.sliceEnd);
-      if (nt(g))
+      if (at(g))
         continue;
       const b = Math.abs(d.indent - i);
       l[b] = ~~l[b] + 1, i = d.indent;
@@ -13131,14 +13141,14 @@ class ke {
     return o.length === 0 || o.slice(0, 2) === "//" || o.slice(0, 2) === "/*";
   }
   isOnlyWhitespace() {
-    return nt(this.toString());
+    return at(this.toString());
   }
   isPrecededOnlyByWhitespace(l) {
     const i = this.infos[l.line - 1], r = Math.max(i.indent, 0), o = l.column - r;
     if (o <= 0)
       return !0;
     const u = i.sliceStart, h = Math.min(u + o, i.sliceEnd), d = i.line.slice(u, h);
-    return nt(d);
+    return at(d);
   }
   getLineLength(l) {
     const i = this.infos[l - 1];
@@ -13173,11 +13183,11 @@ class ke {
       column: l.column
     } : i ? l = this.lastPos() : l = this.firstPos(), i) {
       for (; this.prevPos(l); )
-        if (!nt(this.charAt(l)) && this.nextPos(l))
+        if (!at(this.charAt(l)) && this.nextPos(l))
           return l;
       return null;
     } else {
-      for (; nt(this.charAt(l)); )
+      for (; at(this.charAt(l)); )
         if (!this.nextPos(l))
           return null;
       return l;
@@ -13185,18 +13195,18 @@ class ke {
   }
   trimLeft() {
     const l = this.skipSpaces(this.firstPos(), !1, !0);
-    return l ? this.slice(l) : Ge;
+    return l ? this.slice(l) : Qe;
   }
   trimRight() {
     const l = this.skipSpaces(this.lastPos(), !0, !0);
-    return l ? this.slice(this.firstPos(), l) : Ge;
+    return l ? this.slice(this.firstPos(), l) : Qe;
   }
   trim() {
     const l = this.skipSpaces(this.firstPos(), !1, !0);
     if (l === null)
-      return Ge;
+      return Qe;
     const i = this.skipSpaces(this.lastPos(), !0, !0);
-    return i === null ? Ge : this.slice(l, i);
+    return i === null ? Qe : this.slice(l, i);
   }
   eachPos(l, i = this.firstPos(), r = !1) {
     const o = this.firstPos();
@@ -13219,7 +13229,7 @@ class ke {
     if (!l)
       throw new Error("cannot slice with end but not start");
     const r = this.infos.slice(l.line - 1, i.line);
-    l.line === i.line ? r[0] = at(r[0], l.column, i.column) : (r[0] = at(r[0], l.column), r.push(at(r.pop(), 0, i.column)));
+    l.line === i.line ? r[0] = ot(r[0], l.column, i.column) : (r[0] = ot(r[0], l.column), r.push(ot(r.pop(), 0, i.column)));
     const o = new ke(r);
     if (this.mappings.length > 0) {
       const u = o.mappings;
@@ -13237,9 +13247,9 @@ class ke {
     const { tabWidth: o, useTabs: u, reuseWhitespace: h, lineTerminator: d } = ns(r), g = [];
     for (let b = l.line; b <= i.line; ++b) {
       let S = this.infos[b - 1];
-      b === l.line ? b === i.line ? S = at(S, l.column, i.column) : S = at(S, l.column) : b === i.line && (S = at(S, 0, i.column));
+      b === l.line ? b === i.line ? S = ot(S, l.column, i.column) : S = ot(S, l.column) : b === i.line && (S = ot(S, 0, i.column));
       const w = Math.max(S.indent, 0), v = S.line.slice(0, S.sliceStart);
-      if (h && nt(v) && jr(v, o) === w) {
+      if (h && at(v) && jr(v, o) === w) {
         g.push(S.line.slice(0, S.sliceEnd));
         continue;
       }
@@ -13278,13 +13288,13 @@ class ke {
     }).forEach((b, S) => {
       i.isEmpty() ? h(b) : d(b, S);
     }), r.length < 1)
-      return Ge;
+      return Qe;
     const g = new ke(r);
     return g.mappings = o, g;
   }
   concat(...l) {
     const i = [this];
-    return i.push.apply(i, l), Ge.join(i);
+    return i.push.apply(i, l), Qe.join(i);
   }
 }
 const Qt = {}, Ms = Qt.hasOwnProperty, wo = 10;
@@ -13334,10 +13344,10 @@ function j(a, l) {
   );
   return o && (Qt[a] = u), u;
 }
-function nt(a) {
+function at(a) {
   return !/\S/.test(a);
 }
-function at(a, l, i) {
+function ot(a, l, i) {
   let r = a.sliceStart, o = a.sliceEnd, u = Math.max(a.indent, 0), h = u + o - r;
   return typeof i > "u" && (i = h), l = Math.max(l, 0), i = Math.min(i, h), i = Math.max(i, l), i < u ? (u = i, o = r) : o -= h - i, h = i, h -= l, l < u ? u -= l : (l -= u, u = 0, r += l), a.indent === u && a.sliceStart === r && a.sliceEnd === o ? a : {
     line: a.line,
@@ -13349,9 +13359,9 @@ function at(a, l, i) {
   };
 }
 function L(a) {
-  return Ge.join(a);
+  return Qe.join(a);
 }
-const Ge = j(""), ht = Oe, Rr = De.array, Co = De.object, pr = /* @__PURE__ */ new WeakMap();
+const Qe = j(""), ht = Oe, Rr = De.array, Co = De.object, pr = /* @__PURE__ */ new WeakMap();
 function Ur(a, l, i) {
   if (!a)
     return i;
@@ -13974,7 +13984,7 @@ function $o(a) {
     };
 }
 function Vo(a, l, i) {
-  const r = We(l.start), o = a.prevPos(r) && a.charAt(r), u = i.charAt(i.firstPos());
+  const r = Je(l.start), o = a.prevPos(r) && a.charAt(r), u = i.charAt(i.firstPos());
   return o && es.test(o) && u && es.test(u);
 }
 function qo(a, l, i) {
@@ -14177,7 +14187,7 @@ function Xo(a, l, i) {
 `);
       }, "directives"), r.interpreter && o.push(a.call(i, "interpreter")), o.push(
         a.call(
-          (u) => ot(u, l, i),
+          (u) => lt(u, l, i),
           "body"
         )
       ), L(o);
@@ -14334,7 +14344,7 @@ function Xo(a, l, i) {
       o.push("static ");
     case "BlockStatement": {
       const u = a.call(
-        (h) => ot(h, l, i),
+        (h) => lt(h, l, i),
         "body"
       );
       return u.isEmpty() && (!r.directives || r.directives.length === 0) ? (o.push("{}"), L(o)) : (o.push(`{
@@ -14446,28 +14456,28 @@ function Xo(a, l, i) {
       return j("null");
     case "RegExpLiteral":
       return j(
-        lt(r) || `/${r.pattern}/${r.flags || ""}`,
+        ct(r) || `/${r.pattern}/${r.flags || ""}`,
         l
       );
     case "BigIntLiteral":
-      return j(lt(r) || r.value + "n", l);
+      return j(ct(r) || r.value + "n", l);
     case "NumericLiteral":
-      return j(lt(r) || r.value, l);
+      return j(ct(r) || r.value, l);
     case "DecimalLiteral":
-      return j(lt(r) || r.value + "m", l);
+      return j(ct(r) || r.value + "m", l);
     case "StringLiteral":
       return j(Et(r.value, l));
     case "BooleanLiteral":
     case "Literal":
       return j(
-        lt(r) || (typeof r.value == "string" ? Et(r.value, l) : r.value),
+        ct(r) || (typeof r.value == "string" ? Et(r.value, l) : r.value),
         l
       );
     case "Directive":
       return a.call(i, "value");
     case "DirectiveLiteral":
       return j(
-        lt(r) || Et(r.value, l),
+        ct(r) || Et(r.value, l),
         l
       );
     case "InterpreterDirective":
@@ -14518,17 +14528,17 @@ function Xo(a, l, i) {
         a.call(i, "body")
       ]);
     case "IfStatement": {
-      const u = Xe(a.call(i, "consequent"), l);
+      const u = Ge(a.call(i, "consequent"), l);
       return o.push("if (", a.call(i, "test"), ")", u), r.alternate && o.push(
         Tr(u) ? " else" : `
 else`,
-        Xe(a.call(i, "alternate"), l)
+        Ge(a.call(i, "alternate"), l)
       ), L(o);
     }
     case "ForStatement": {
       const u = a.call(i, "init"), h = u.length > 1 ? `;
 ` : "; ", d = "for (", g = j(h).join([u, a.call(i, "test"), a.call(i, "update")]).indentTail(d.length), b = L([d, g, ")"]);
-      let S = Xe(a.call(i, "body"), l);
+      let S = Ge(a.call(i, "body"), l);
       return o.push(b), b.length > 1 && (o.push(`
 `), S = S.trimLeft()), o.push(S), L(o);
     }
@@ -14537,7 +14547,7 @@ else`,
         "while (",
         a.call(i, "test"),
         ")",
-        Xe(a.call(i, "body"), l)
+        Ge(a.call(i, "body"), l)
       ]);
     case "ForInStatement":
       return L([
@@ -14546,7 +14556,7 @@ else`,
         " in ",
         a.call(i, "right"),
         ")",
-        Xe(a.call(i, "body"), l)
+        Ge(a.call(i, "body"), l)
       ]);
     case "ForOfStatement":
     case "ForAwaitStatement":
@@ -14556,19 +14566,19 @@ else`,
         " of ",
         a.call(i, "right"),
         ")",
-        Xe(a.call(i, "body"), l)
+        Ge(a.call(i, "body"), l)
       ), L(o);
     case "DoWhileStatement": {
       const u = L([
         "do",
-        Xe(a.call(i, "body"), l)
+        Ge(a.call(i, "body"), l)
       ]);
       return o.push(u), Tr(u) ? o.push(" while") : o.push(`
 while`), o.push(" (", a.call(i, "test"), ");"), L(o);
     }
     case "DoExpression": {
       const u = a.call(
-        (h) => ot(h, l, i),
+        (h) => lt(h, l, i),
         "body"
       );
       return L([`do {
@@ -14610,7 +14620,7 @@ while`), o.push(" (", a.call(i, "test"), ");"), L(o);
         `
 `,
         a.call(
-          (u) => ot(u, l, i),
+          (u) => lt(u, l, i),
           "consequent"
         ).indent(l.tabWidth)
       ), L(o);
@@ -14689,7 +14699,7 @@ while`), o.push(" (", a.call(i, "test"), ");"), L(o);
         `{
 `,
         a.call(
-          (u) => ot(u, l, i),
+          (u) => lt(u, l, i),
           "body"
         ).indent(l.tabWidth),
         `
@@ -15267,7 +15277,7 @@ while`), o.push(" (", a.call(i, "test"), ");"), L(o);
       return a.getParentNode().type === "TSModuleDeclaration" ? o.push(".") : (r.declare && o.push("declare "), r.global || (r.id.type === "StringLiteral" || r.id.type === "Literal" && typeof r.id.value == "string" || r.loc && r.loc.lines && r.id.loc && r.loc.lines.sliceString(r.loc.start, r.id.loc.start).indexOf("module") >= 0 ? o.push("module ") : o.push("namespace "))), o.push(a.call(i, "id")), r.body && (o.push(" "), o.push(a.call(i, "body"))), L(o);
     case "TSModuleBlock": {
       const u = a.call(
-        (h) => ot(h, l, i),
+        (h) => lt(h, l, i),
         "body"
       );
       return u.isEmpty() ? o.push("{}") : o.push(`{
@@ -15332,7 +15342,7 @@ function Go(a, l) {
     "decorators"
   ), L(i);
 }
-function ot(a, l, i) {
+function lt(a, l, i) {
   const r = [];
   a.each(function(d) {
     const g = d.getValue();
@@ -15505,7 +15515,7 @@ function St(a, l) {
     return r ? r === "plus" ? j("+") : r === "minus" ? j("-") : l(i) : j("");
   }, "variance");
 }
-function Xe(a, l) {
+function Ge(a, l) {
   return a.length > 1 ? L([" ", a]) : L([`
 `, Yt(a).indent(l.tabWidth)]);
 }
@@ -15523,7 +15533,7 @@ function Tr(a) {
 function Kt(a) {
   return a.replace(/['"]/g, (l) => l === '"' ? "'" : '"');
 }
-function lt(a) {
+function ct(a) {
   const l = je(a, "value"), i = je(a, "extra");
   if (i && typeof i.raw == "string" && l == i.rawValue)
     return i.raw;
@@ -16333,10 +16343,10 @@ function sn(a, l) {
     }
 }
 async function Bl(a, l, i = !1, r = "") {
-  if (i || await Ye(
+  if (i || await Ze(
     r || `This will update '${a}' file. Continue?`
   )) {
-    const u = Qe(process.cwd(), a), h = await Sl(u);
+    const u = Ye(process.cwd(), a), h = await Sl(u);
     let d = h.exports?.default;
     if (!d) {
       const w = Object.keys(h.exports);
@@ -16361,11 +16371,11 @@ async function Bl(a, l, i = !1, r = "") {
     console.log(`Updating '${a}' skipped.`);
 }
 async function _l(a, l, i, r = !1, o = "") {
-  if (r || await Ye(
+  if (r || await Ze(
     o || `This will update '${a}' file. Continue?`
   )) {
-    const h = Qe(process.cwd(), a);
-    if (!ut(h))
+    const h = Ye(process.cwd(), a);
+    if (!We(h))
       throw new Error(`No '${a}' found in project root — skipping updates.`);
     const d = ss(h, "utf8");
     let g;
@@ -16385,11 +16395,11 @@ ${S}`);
     console.log(`Updating '${a}' skipped.`);
 }
 async function jl(a, l, i = !1, r = "") {
-  if (i || await Ye(
+  if (i || await Ze(
     r || `This will update '${a}' file. Continue?`
   )) {
-    const u = Qe(process.cwd(), a);
-    if (!ut(u))
+    const u = Ye(process.cwd(), a);
+    if (!We(u))
       throw new Error(`No '${a}' found in project root — skipping updates.`);
     const d = ss(u, "utf8").split(/\r?\n/);
     let g = !1;
@@ -16413,8 +16423,8 @@ function Ul(a, l = 1) {
     process.stdout.write(`
 `);
 }
-function $l(a, l = Qe(process.cwd(), ".env")) {
-  if (!ut(l))
+function $l(a, l = Ye(process.cwd(), ".env")) {
+  if (!We(l))
     return;
   const i = ss(l, "utf-8");
   for (const r of i.split(/\r?\n/)) {
@@ -16432,7 +16442,7 @@ export {
   Nl as createFileFromWebTemplate,
   $l as getEnvValue,
   Ia as parseQualifiedPath,
-  Ye as promptUser,
+  Ze as promptUser,
   Na as resolvePackagePath,
   Rl as showError,
   Ul as showMessage,

package/dist/types/functions/create-file-from-template.d.ts

@@ -1 +1,11 @@
+/**
+ * Creates a new copy of given file from a local template.
+ *
+ * @param {string} templateFile - The path to the template file (prefixed with package name).
+ * @param {string} targetFile - The path to the target file to create (relative to CWD). Can overwrite existing files if confirmed.
+ * @param {boolean} force - Whether to force creation without prompting.
+ * @param {string} prompt - Custom prompt message displayed in terminal.
+ * @returns {Promise<void>} An empty promise that resolves when the file is created.
+ * @throws Will throw an error if the template file cannot be found or the target file failed to be created.
+ */
 export declare function createFileFromTemplate(templateFile: string, targetFile: string, force?: boolean, prompt?: string): Promise<void>;

package/dist/types/functions/create-file-from-web-template.d.ts

@@ -1 +1,11 @@
+/**
+ * Creates a new copy of given file from a web template.
+ *
+ * @param {string} url - The URL to the template file (must be accessible via `node:https.get` and return raw text data).
+ * @param {string} targetFile - The path to the target file to create (relative to CWD). Can overwrite existing files if confirmed.
+ * @param {boolean} force - Whether to force creation without prompting.
+ * @param {string} prompt - Custom prompt message displayed in terminal.
+ * @returns {Promise<void>} An empty promise that resolves when the file is created.
+ * @throws Will throw an error if the remote template cannot be fetched or the target file failed to be created.
+ */
 export declare function createFileFromWebTemplate(url: string, targetFile: string, force?: boolean, prompt?: string): Promise<void>;

package/dist/types/functions/update-config-file.d.ts

@@ -8,6 +8,7 @@
  *
  * @param {string} pathToFile - Path to file, relative to project root (process.cwd()).
  * @param {object} newConfig - Config to merge in (takes precedence).
- * @returns {Promise<void>}
+ * @returns {Promise<void>} An empty promise that resolves when the file is updated.
+ * @throws Will throw an error if no config export is found or it cannot be processed.
  */
 export declare function updateConfigFile(pathToFile: string, newConfig: Record<string | number | symbol, any>, force?: boolean, prompt?: string): Promise<void>;

package/dist/types/functions/update-json-file.d.ts

@@ -1 +1,12 @@
+/**
+ * Updates a JSON file by modifying a specific key with new values.
+ *
+ * @param {string} pathToFile - The path to the JSON file to update (relative to CWD).
+ * @param {string} jsonKey - The key in the JSON file to update (can be new or existing).
+ * @param {Record<string | number | symbol, any>} newValues - The new values to set for the specified key.
+ * @param {boolean} force - Whether to force the update without prompting.
+ * @param {string} prompt - Custom prompt message displayed in terminal.
+ * @returns {Promise<void>} An empty promise that resolves when the file is updated.
+ * @throws Will throw an error if the file does not exist or cannot be parsed as JSON.
+ */
 export declare function updateJsonFile(pathToFile: string, jsonKey: string, newValues: Record<string | number | symbol, any>, force?: boolean, prompt?: string): Promise<void>;

package/dist/types/functions/update-text-file.d.ts

@@ -1 +1,11 @@
+/**
+ * Updates a text file by adding new rows.
+ *
+ * @param {string} pathToFile - The path to the text file to update (relative to CWD).
+ * @param {string[]} rowsToAdd - New rows to be added at the end of the file.
+ * @param {boolean} force - Whether to force the update without prompting.
+ * @param {string} prompt - Custom prompt message displayed in terminal.
+ * @returns {Promise<void>} An empty promise that resolves when the file is updated.
+ * @throws Will throw an error if the file does not exist.
+ */
 export declare function updateTextFile(pathToFile: string, rowsToAdd: string[], force?: boolean, prompt?: string): Promise<void>;

package/dist/types/terminal/prompt-user.d.ts

@@ -1 +1,11 @@
-export declare function promptUser(question: string): Promise<boolean>;
+/**
+ * Prompts the user with a question and returns their response.
+ *
+ * @param {string} question - Question to ask the user
+ * @param {{ input?: NodeJS.ReadableStream; output?: NodeJS.WritableStream }} options - Optional setting of custom input/output stream
+ * @returns {Promise<boolean>} - true if the user answered yes (`y`, `Y`, `yes`, `YES`), false otherwise
+ */
+export declare function promptUser(question: string, options?: {
+    input?: NodeJS.ReadableStream;
+    output?: NodeJS.WritableStream;
+}): Promise<boolean>;

package/dist/types/terminal/show-error.d.ts

@@ -1 +1,7 @@
+/**
+ * Prints error message into stderr with specified number of newlines after it.
+ *
+ * @param {string} message - The error message text to display.
+ * @param {number} linesAfter - The number of newlines to print after the message (default is 1).
+ */
 export declare function showError(message: string, linesAfter?: number): void;

package/dist/types/terminal/show-message.d.ts

@@ -1 +1,7 @@
+/**
+ * Prints message into stdout with specified number of newlines after it.
+ *
+ * @param {string} message - The message text to display.
+ * @param {number} linesAfter - The number of newlines to print after the message (default is 1).
+ */
 export declare function showMessage(message: string, linesAfter?: number): void;

package/dist/types/utils/get-env-value.d.ts

@@ -1 +1,8 @@
+/**
+ * Retrieves the value of an environment variable from a .env file.
+ *
+ * @param {string} key - The name of the environment variable to retrieve.
+ * @param {string} envFilePath - The path to the .env file (default is the .env file in the project root).
+ * @returns {string | undefined} - The value of the environment variable, or undefined if not found.
+ */
 export declare function getEnvValue(key: string, envFilePath?: string): string | undefined;

package/dist/types/utils/parse-qualified-path.d.ts

@@ -1,6 +1,10 @@
 /**
  * Expects path to file in `"package:relative/path/to/file"` format and splits it into `{ pkg, file }`.
- * The package name can be scoped (e.g. `@scope/package`). Throws error on invalid input.
+ * The package name can be scoped (e.g. `@scope/package`).
+ *
+ * @param {string} path - The qualified path string to parse.
+ * @returns {{ pkg: string; file: string }} An object containing the package name and the relative file path.
+ * @throws Will throw an error if the input format is invalid.
  */
 export declare function parseQualifiedPath(path: string): {
     pkg: string;

package/dist/types/utils/resolve-package-path.d.ts

@@ -2,5 +2,9 @@
  * Resolve a package's installed root directory *from the target app*.
  * Package name can be scoped (e.g. `@scope/package`).
  * Works with npm/yarn/pnpm, hoisting or not.
+ *
+ * @param {string} packageName - The name of the package to resolve.
+ * @returns {string} The absolute path to the package's root directory.
+ * @throws Will throw an error if the package cannot be found or accessed.
  */
 export declare function resolvePackagePath(packageName: string): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "elrh-cosca",
-  "version": "0.2.5",
+  "version": "0.2.7",
   "type": "module",
   "files": [
     "dist"