@oliversalzburg/js-utils 0.8.1 → 0.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (14) hide show
  1. package/lib/cli/args.js +6 -3
  2. package/lib/cli/args.js.map +1 -1
  3. package/lib/cli/args.test.js +36 -0
  4. package/lib/cli/args.test.js.map +1 -1
  5. package/lib/cli/posix.d.ts +12 -0
  6. package/lib/cli/posix.js +80 -0
  7. package/lib/cli/posix.js.map +1 -0
  8. package/lib/data/array.d.ts +7 -0
  9. package/lib/data/array.js +10 -0
  10. package/lib/data/array.js.map +1 -1
  11. package/lib/data/array.test.d.ts +1 -0
  12. package/lib/data/array.test.js +16 -0
  13. package/lib/data/array.test.js.map +1 -0
  14. package/package.json +4 -4
package/lib/cli/args.js CHANGED
@@ -4,12 +4,15 @@
4
4
  * @param {boolean} expectUnlabeled - Is the command line expected to have
5
5
  * at least one trailing argument that is not labeled?
6
6
  */
7
- export const parseArgv = (argv, expectUnlabeled = false) => argv.slice(2).reduce((acc, _, index, array) => {
7
+ export const parseArgv = (argv, expectUnlabeled = false) => argv.slice(2).reduce((acc, _) => {
8
8
  let slot;
9
9
  let value;
10
+ if (_ === "--") {
11
+ expectUnlabeled = true;
12
+ return acc;
13
+ }
10
14
  if (!_.startsWith("--")) {
11
- if (acc.prev === undefined ||
12
- (expectUnlabeled && index === array.length - 1)) {
15
+ if (acc.prev === undefined || expectUnlabeled) {
13
16
  slot = "";
14
17
  }
15
18
  else {
package/lib/cli/args.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"args.js","sourceRoot":"","sources":["../../source/cli/args.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CACxB,IAAmB,EACnB,eAAe,GAAG,KAAK,EAItB,EAAE,CACH,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CACnB,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;IACxB,IAAI,IAAY,CAAC;IACjB,IAAI,KAAoB,CAAC;IAEzB,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,IACC,GAAG,CAAC,IAAI,KAAK,SAAS;YACtB,CAAC,eAAe,IAAI,KAAK,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,EAC9C,CAAC;YACF,IAAI,GAAG,EAAE,CAAC;QACX,CAAC;aAAM,CAAC;YACP,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;YAChB,GAAG,CAAC,IAAI,GAAG,SAAS,CAAC;QACtB,CAAC;QACD,KAAK,GAAG,CAAC,CAAC;IACX,CAAC;SAAM,CAAC;QACP,MAAM,QAAQ,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;QAC/D,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAClD,OAAO,GAAG,CAAC;QACZ,CAAC;QAED,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC;QAC/C,KAAK;YACJ,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,KAAK,EAAE;gBAClE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK;gBACpB,CAAC,CAAC,IAAI,CAAC;QACT,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,KAAK,EAAE,EAAE,CAAC;YAC/B,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,CAAC;IACF,CAAC;IAED,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/B,IACC,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,OAAO,KAAK,QAAQ,CAAC;QACvD,KAAK,KAAK,IAAI,EACb,CAAC;QACF,OAAO,GAAG,CAAC;IACZ,CAAC;IAED,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;QACb,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,KAAK,KAAK,QAAQ;YAClD,CAAC,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,CAAC;YACrB,CAAC,CAAC,IAAI,KAAK,EAAE,IAAI,OAAO,KAAK,KAAK,QAAQ;gBACzC,CAAC,CAAC,CAAC,KAAK,CAAC;gBACT,CAAC,CAAC,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,KAAK,KAAK,SAAS;oBAC7D,CAAC,CAAC,KAAK;oBACP,CAAC,CAAC,OAAO,OAAO,KAAK,SAAS;wBAC7B,CAAC,CAAC,KAAK;wBACP,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAElE,OAAO,GAAG,CAAC;AACZ,CAAC,EACD,EAAE,IAAI,EAAE,EAAE,EAMT,CACD,CAAC,IAAI,CAAC"}
1
+ {"version":3,"file":"args.js","sourceRoot":"","sources":["../../source/cli/args.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CACxB,IAAmB,EACnB,eAAe,GAAG,KAAK,EAItB,EAAE,CACH,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CACnB,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;IACV,IAAI,IAAY,CAAC;IACjB,IAAI,KAAoB,CAAC;IAEzB,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QAChB,eAAe,GAAG,IAAI,CAAC;QACvB,OAAO,GAAG,CAAC;IACZ,CAAC;IAED,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,eAAe,EAAE,CAAC;YAC/C,IAAI,GAAG,EAAE,CAAC;QACX,CAAC;aAAM,CAAC;YACP,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;YAChB,GAAG,CAAC,IAAI,GAAG,SAAS,CAAC;QACtB,CAAC;QACD,KAAK,GAAG,CAAC,CAAC;IACX,CAAC;SAAM,CAAC;QACP,MAAM,QAAQ,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;QAC/D,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAClD,OAAO,GAAG,CAAC;QACZ,CAAC;QAED,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC;QAC/C,KAAK;YACJ,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,KAAK,EAAE;gBAClE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK;gBACpB,CAAC,CAAC,IAAI,CAAC;QACT,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,KAAK,EAAE,EAAE,CAAC;YAC/B,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,CAAC;IACF,CAAC;IAED,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/B,IACC,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,OAAO,KAAK,QAAQ,CAAC;QACvD,KAAK,KAAK,IAAI,EACb,CAAC;QACF,OAAO,GAAG,CAAC;IACZ,CAAC;IAED,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;QACb,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,KAAK,KAAK,QAAQ;YAClD,CAAC,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,CAAC;YACrB,CAAC,CAAC,IAAI,KAAK,EAAE,IAAI,OAAO,KAAK,KAAK,QAAQ;gBACzC,CAAC,CAAC,CAAC,KAAK,CAAC;gBACT,CAAC,CAAC,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,KAAK,KAAK,SAAS;oBAC7D,CAAC,CAAC,KAAK;oBACP,CAAC,CAAC,OAAO,OAAO,KAAK,SAAS;wBAC7B,CAAC,CAAC,KAAK;wBACP,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAElE,OAAO,GAAG,CAAC;AACZ,CAAC,EACD,EAAE,IAAI,EAAE,EAAE,EAMT,CACD,CAAC,IAAI,CAAC"}
package/lib/cli/args.test.js CHANGED
@@ -50,4 +50,40 @@ it("aggregates multiple unlabeled parameters", () => {
50
50
  "": ["filename.ext", "otherfile.ext"],
51
51
  });
52
52
  });
53
+ /**
54
+ * Passing multiple unlabeled arguments requires a -- for separation in some cases.
55
+ * It's usually best to use it consistently to distinguish these types of arguments.
56
+ */
57
+ it("parses multiple unlabeled trailing arguments", () => {
58
+ assert.deepStrictEqual(parseArgv(["node", "script.js", "--yes"]), {
59
+ yes: true,
60
+ });
61
+ assert.deepStrictEqual(parseArgv(["node", "script.js", "--yes", "--", "filename.ext"], true), {
62
+ "": ["filename.ext"],
63
+ yes: true,
64
+ });
65
+ assert.deepStrictEqual(parseArgv([
66
+ "node",
67
+ "script.js",
68
+ "--yes",
69
+ "--",
70
+ "filename.ext",
71
+ "otherfile.ext",
72
+ ]), {
73
+ "": ["filename.ext", "otherfile.ext"],
74
+ yes: true,
75
+ });
76
+ assert.deepStrictEqual(parseArgv([
77
+ "node",
78
+ "script.js",
79
+ "--yes",
80
+ "--",
81
+ "filename.ext",
82
+ "otherfile.ext",
83
+ "directory",
84
+ ]), {
85
+ "": ["filename.ext", "otherfile.ext", "directory"],
86
+ yes: true,
87
+ });
88
+ });
53
89
  //# sourceMappingURL=args.test.js.map
package/lib/cli/args.test.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"args.test.js","sourceRoot":"","sources":["../../source/cli/args.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AAC/B,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACpC,MAAM,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,EAAE;QACjE,GAAG,EAAE,IAAI;KACT,CAAC,CAAC;IACH,MAAM,CAAC,eAAe,CACrB,SAAS,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,CAAC,EAAE,IAAI,CAAC,EAC/D;QACC,EAAE,EAAE,CAAC,cAAc,CAAC;QACpB,GAAG,EAAE,IAAI;KACT,CACD,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;IACtC,MAAM,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC,EAAE;QACtE,GAAG,EAAE,MAAM;KACX,CAAC,CAAC;IACH,MAAM,CAAC,eAAe,CACrB,SAAS,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,CAAC,CAAC,EAC9D;QACC,EAAE,EAAE,CAAC,cAAc,CAAC;QACpB,GAAG,EAAE,MAAM;KACX,CACD,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;IACtC,MAAM,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,EAAE;QACzE,GAAG,EAAE,MAAM;KACX,CAAC,CAAC;IACH,MAAM,CAAC,eAAe,CACrB,SAAS,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC,EACjE;QACC,EAAE,EAAE,CAAC,cAAc,CAAC;QACpB,GAAG,EAAE,MAAM;KACX,CACD,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;IAChE,MAAM,CAAC,eAAe,CACrB,SAAS,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,EAChE;QACC,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC;KAClB,CACD,CAAC;IACF,MAAM,CAAC,eAAe,CACrB,SAAS,CAAC;QACT,MAAM;QACN,WAAW;QACX,QAAQ;QACR,IAAI;QACJ,QAAQ;QACR,IAAI;QACJ,cAAc;KACd,CAAC,EACF;QACC,EAAE,EAAE,CAAC,cAAc,CAAC;QACpB,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC;KAClB,CACD,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;IACnD,MAAM,CAAC,eAAe,CACrB,SAAS,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,eAAe,CAAC,CAAC,EACjE;QACC,EAAE,EAAE,CAAC,cAAc,EAAE,eAAe,CAAC;KACrC,CACD,CAAC;AACH,CAAC,CAAC,CAAC"}
1
+ {"version":3,"file":"args.test.js","sourceRoot":"","sources":["../../source/cli/args.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AAC/B,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACpC,MAAM,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,EAAE;QACjE,GAAG,EAAE,IAAI;KACT,CAAC,CAAC;IACH,MAAM,CAAC,eAAe,CACrB,SAAS,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,CAAC,EAAE,IAAI,CAAC,EAC/D;QACC,EAAE,EAAE,CAAC,cAAc,CAAC;QACpB,GAAG,EAAE,IAAI;KACT,CACD,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;IACtC,MAAM,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC,EAAE;QACtE,GAAG,EAAE,MAAM;KACX,CAAC,CAAC;IACH,MAAM,CAAC,eAAe,CACrB,SAAS,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,CAAC,CAAC,EAC9D;QACC,EAAE,EAAE,CAAC,cAAc,CAAC;QACpB,GAAG,EAAE,MAAM;KACX,CACD,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;IACtC,MAAM,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,EAAE;QACzE,GAAG,EAAE,MAAM;KACX,CAAC,CAAC;IACH,MAAM,CAAC,eAAe,CACrB,SAAS,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC,EACjE;QACC,EAAE,EAAE,CAAC,cAAc,CAAC;QACpB,GAAG,EAAE,MAAM;KACX,CACD,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;IAChE,MAAM,CAAC,eAAe,CACrB,SAAS,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,EAChE;QACC,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC;KAClB,CACD,CAAC;IACF,MAAM,CAAC,eAAe,CACrB,SAAS,CAAC;QACT,MAAM;QACN,WAAW;QACX,QAAQ;QACR,IAAI;QACJ,QAAQ;QACR,IAAI;QACJ,cAAc;KACd,CAAC,EACF;QACC,EAAE,EAAE,CAAC,cAAc,CAAC;QACpB,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC;KAClB,CACD,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;IACnD,MAAM,CAAC,eAAe,CACrB,SAAS,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,eAAe,CAAC,CAAC,EACjE;QACC,EAAE,EAAE,CAAC,cAAc,EAAE,eAAe,CAAC;KACrC,CACD,CAAC;AACH,CAAC,CAAC,CAAC;AAEH;;;GAGG;AACH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;IACvD,MAAM,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,EAAE;QACjE,GAAG,EAAE,IAAI;KACT,CAAC,CAAC;IACH,MAAM,CAAC,eAAe,CACrB,SAAS,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,IAAI,CAAC,EACrE;QACC,EAAE,EAAE,CAAC,cAAc,CAAC;QACpB,GAAG,EAAE,IAAI;KACT,CACD,CAAC;IACF,MAAM,CAAC,eAAe,CACrB,SAAS,CAAC;QACT,MAAM;QACN,WAAW;QACX,OAAO;QACP,IAAI;QACJ,cAAc;QACd,eAAe;KACf,CAAC,EACF;QACC,EAAE,EAAE,CAAC,cAAc,EAAE,eAAe,CAAC;QACrC,GAAG,EAAE,IAAI;KACT,CACD,CAAC;IACF,MAAM,CAAC,eAAe,CACrB,SAAS,CAAC;QACT,MAAM;QACN,WAAW;QACX,OAAO;QACP,IAAI;QACJ,cAAc;QACd,eAAe;QACf,WAAW;KACX,CAAC,EACF;QACC,EAAE,EAAE,CAAC,cAAc,EAAE,eAAe,EAAE,WAAW,CAAC;QAClD,GAAG,EAAE,IAAI;KACT,CACD,CAAC;AACH,CAAC,CAAC,CAAC"}
package/lib/cli/posix.d.ts ADDED
@@ -0,0 +1,12 @@
1
+ export declare const POSIX_CHARACTER_CLASS_ALNUM: readonly ["A", "B", "C", "D", "E", "F", "G", "H", "I", "J", "K", "L", "M", "N", "O", "P", "Q", "R", "S", "T", "U", "V", "W", "X", "Y", "Z", "a", "b", "c", "d", "e", "f", "g", "h", "i", "j", "k", "l", "m", "n", "o", "p", "q", "r", "s", "t", "u", "v", "w", "x", "y", "z", "0", "1", "2", "3", "4", "5", "6", "7", "8", "9"];
2
+ export type ALNUM = (typeof POSIX_CHARACTER_CLASS_ALNUM)[number];
3
+ export type PosixOption = {
4
+ argument?: string;
5
+ help: string;
6
+ required?: boolean;
7
+ };
8
+ export type PosixOptions = Partial<Record<ALNUM, PosixOption>> & {
9
+ operands?: number;
10
+ };
11
+ export type PosixOptionsMutex = Array<PosixOptions>;
12
+ export declare const synopsis: () => void;
package/lib/cli/posix.js ADDED
@@ -0,0 +1,80 @@
1
+ export const POSIX_CHARACTER_CLASS_ALNUM = [
2
+ "A",
3
+ "B",
4
+ "C",
5
+ "D",
6
+ "E",
7
+ "F",
8
+ "G",
9
+ "H",
10
+ "I",
11
+ "J",
12
+ "K",
13
+ "L",
14
+ "M",
15
+ "N",
16
+ "O",
17
+ "P",
18
+ "Q",
19
+ "R",
20
+ "S",
21
+ "T",
22
+ "U",
23
+ "V",
24
+ "W",
25
+ "X",
26
+ "Y",
27
+ "Z",
28
+ "a",
29
+ "b",
30
+ "c",
31
+ "d",
32
+ "e",
33
+ "f",
34
+ "g",
35
+ "h",
36
+ "i",
37
+ "j",
38
+ "k",
39
+ "l",
40
+ "m",
41
+ "n",
42
+ "o",
43
+ "p",
44
+ "q",
45
+ "r",
46
+ "s",
47
+ "t",
48
+ "u",
49
+ "v",
50
+ "w",
51
+ "x",
52
+ "y",
53
+ "z",
54
+ "0",
55
+ "1",
56
+ "2",
57
+ "3",
58
+ "4",
59
+ "5",
60
+ "6",
61
+ "7",
62
+ "8",
63
+ "9",
64
+ ];
65
+ const _example = [
66
+ {
67
+ v: { help: "Show version" },
68
+ },
69
+ {
70
+ c: { argument: "all-lands.jsonl", help: "Scryfall cards JSONL export." },
71
+ d: { help: "Print debug information", required: false },
72
+ p: {
73
+ argument: "cardmarket_ids.json",
74
+ help: "MTGJSON-provided CardMarket product IDs JSON file.",
75
+ },
76
+ s: { argument: "sets.json", help: "Scryfall sets API response." },
77
+ },
78
+ ];
79
+ export const synopsis = () => { };
80
+ //# sourceMappingURL=posix.js.map
package/lib/cli/posix.js.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"file":"posix.js","sourceRoot":"","sources":["../../source/cli/posix.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,2BAA2B,GAAG;IAC1C,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;CACM,CAAC;AAYX,MAAM,QAAQ,GAAsB;IACnC;QACC,CAAC,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE;KAC3B;IACD;QACC,CAAC,EAAE,EAAE,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,8BAA8B,EAAE;QACxE,CAAC,EAAE,EAAE,IAAI,EAAE,yBAAyB,EAAE,QAAQ,EAAE,KAAK,EAAE;QACvD,CAAC,EAAE;YACF,QAAQ,EAAE,qBAAqB;YAC/B,IAAI,EAAE,oDAAoD;SAC1D;QACD,CAAC,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,6BAA6B,EAAE;KACjE;CACD,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAG,EAAE,GAAE,CAAC,CAAC"}
package/lib/data/array.d.ts CHANGED
@@ -53,3 +53,10 @@ export declare const chunkify: <TElements>(iterable: Iterable<TElements>, limit:
53
53
  * @returns A map that correlates the group key to an array of all elements with that group key.
54
54
  */
55
55
  export declare const groupBy: <TElements, TGroupKey>(array: Array<TElements>, ident: (element: TElements) => TGroupKey) => Map<TGroupKey, Array<TElements>>;
56
+ /**
57
+ * Generate an array with all numbers from start to end inclusive.
58
+ * @param start - The first number in the array.
59
+ * @param end - The last number in the array.
60
+ * @returns An array with all numbers in the requested range.
61
+ */
62
+ export declare const range: (start: number, end: number) => Array<number>;
package/lib/data/array.js CHANGED
@@ -87,4 +87,14 @@ export const groupBy = (array, ident) => {
87
87
  }
88
88
  return result;
89
89
  };
90
+ /**
91
+ * Generate an array with all numbers from start to end inclusive.
92
+ * @param start - The first number in the array.
93
+ * @param end - The last number in the array.
94
+ * @returns An array with all numbers in the requested range.
95
+ */
96
+ export const range = (start, end) => {
97
+ const length = Math.abs(start - end) + 1;
98
+ return Array.from({ length }).map((_, index) => start + index * (end < start ? -1 : 1));
99
+ };
90
100
  //# sourceMappingURL=array.js.map
package/lib/data/array.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"array.js","sourceRoot":"","sources":["../../source/data/array.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAE9B;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAY,KAAuB,EAAE,EAAE;IAClE,KAAK,IAAI,KAAK,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;QACvD,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;QAC5D,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1B,KAAK,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC;QAClC,KAAK,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC;IAC3B,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CACxB,CAAmB,EACnB,CAAmB,EAClB,EAAE;IACH,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AACvC,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CACzB,CAAmB,EACnB,CAAmB,EAClB,EAAE;IACH,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AACxC,CAAC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CACzB,KAAqB,EACrB,YAAsC,EACrC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,CAAC,CAAqB,CAAC;AAE9E;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,QAAQ,CAAC,EAChC,QAA6B,EAC7B,KAAa;IAEb,IAAI,KAAK,GAAG,EAAE,CAAC;IACf,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpB,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;YAC5B,MAAM,KAAK,CAAC;YACZ,KAAK,GAAG,EAAE,CAAC;QACZ,CAAC;IACF,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QAClB,MAAM,KAAK,CAAC;IACb,CAAC;AACF,CAAC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CACtB,KAAuB,EACvB,KAAwC,EACL,EAAE;IACrC,MAAM,MAAM,GAAG,IAAI,GAAG,EAA+B,CAAC;IACtD,KAAK,MAAM,OAAO,IAAI,KAAK,EAAE,CAAC;QAC7B,MAAM,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;QAC1B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YACrB,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,KAAK,EAAa,CAAC,CAAC;QACxC,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,MAAM,CAAC;AACf,CAAC,CAAC"}
1
+ {"version":3,"file":"array.js","sourceRoot":"","sources":["../../source/data/array.ts"],"names":[],"mappings":"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"}
package/lib/data/array.test.d.ts ADDED
@@ -0,0 +1 @@
1
+ export {};
package/lib/data/array.test.js ADDED
@@ -0,0 +1,16 @@
1
+ import assert from "node:assert";
2
+ import { it } from "node:test";
3
+ import { range } from "./array.js";
4
+ it("generates the expected range - zero to positive", () => {
5
+ assert.deepStrictEqual(range(0, 9), [0, 1, 2, 3, 4, 5, 6, 7, 8, 9]);
6
+ });
7
+ it("generates the expected range - negative to zero", () => {
8
+ assert.deepStrictEqual(range(-9, 0), [-9, -8, -7, -6, -5, -4, -3, -2, -1, 0]);
9
+ });
10
+ it("generates the expected range - negative to positive", () => {
11
+ assert.deepStrictEqual(range(-5, 5), [-5, -4, -3, -2, -1, 0, 1, 2, 3, 4, 5]);
12
+ });
13
+ it("generates the expected range - positive to negative", () => {
14
+ assert.deepStrictEqual(range(5, -5), [5, 4, 3, 2, 1, 0, -1, -2, -3, -4, -5]);
15
+ });
16
+ //# sourceMappingURL=array.test.js.map
package/lib/data/array.test.js.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"file":"array.test.js","sourceRoot":"","sources":["../../source/data/array.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AAC/B,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;IAC1D,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AACrE,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;IAC1D,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAC/E,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;IAC9D,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAC9E,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;IAC9D,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9E,CAAC,CAAC,CAAC"}
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://json.schemastore.org/package.json",
3
3
  "name": "@oliversalzburg/js-utils",
4
- "version": "0.8.1",
4
+ "version": "0.10.0",
5
5
  "license": "MIT",
6
6
  "author": "Oliver Salzburg <oliver.salzburg@gmail.com>",
7
7
  "repository": {
@@ -23,9 +23,9 @@
23
23
  "postversion": "git push"
24
24
  },
25
25
  "devDependencies": {
26
- "@biomejs/biome": "2.5.11",
27
- "@types/node": "26.4.1",
28
- "@types/web": "0.0.354",
26
+ "@biomejs/biome": "2.5.14",
27
+ "@types/node": "26.6.2",
28
+ "@types/web": "0.0.357",
29
29
  "typescript": "7.0.2"
30
30
  },
31
31
  "engines": {