complete-common 1.0.0 → 1.1.0

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,mBAAmB,wBAAwB,CAAC;AAC5C,mBAAmB,yCAAyC,CAAC;AAC7D,mBAAmB,mBAAmB,CAAC;AACvC,mBAAmB,sBAAsB,CAAC;AAC1C,mBAAmB,mBAAmB,CAAC;AACvC,mBAAmB,mCAAmC,CAAC;AACvD,mBAAmB,4CAA4C,CAAC;AAChE,mBAAmB,yBAAyB,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,mBAAmB,2BAA2B,CAAC;AAC/C,cAAc,wBAAwB,CAAC;AACvC,mBAAmB,kBAAkB,CAAC;AACtC,mBAAmB,yBAAyB,CAAC;AAC7C,mBAAmB,sBAAsB,CAAC"}

package/dist/index.mjs

@@ -4,25 +4,21 @@ const HOUR_IN_MILLISECONDS = 60 * MINUTE_IN_MILLISECONDS;
 
 const ReadonlySet = Set;
 
-function getRandomInt(min, max, exceptions = []) {
-  min = Math.ceil(min);
-  max = Math.floor(max);
-  if (min > max) {
-    const oldMin = min;
-    const oldMax = max;
-    min = oldMax;
-    max = oldMin;
-  }
-  const exceptionsSet = new ReadonlySet(exceptions);
-  let randomInt;
-  do {
-    randomInt = Math.floor(Math.random() * (max - min + 1)) + min;
-  } while (exceptionsSet.has(randomInt));
-  return randomInt;
+function isObject(variable) {
+  return typeof variable === "object" && variable !== null && !Array.isArray(variable);
 }
 
-const FLOAT_REGEX = /^-?\d*\.?\d+$/;
-const INTEGER_REGEX = /^-?\d+$/;
+const TYPES_TO_VALIDATION_FUNCTIONS = {
+  string: (val) => typeof val === "string",
+  number: (val) => typeof val === "number",
+  boolean: (val) => typeof val === "boolean",
+  object: (val) => val !== null && typeof val === "object",
+  array: (val) => Array.isArray(val),
+  null: (val) => val === null,
+  undefined: (val) => val === void 0,
+  // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
+  function: (val) => typeof val === "function"
+};
 function assertDefined(value, ...[msg]) {
   if (value === void 0) {
     throw new TypeError(msg);
@@ -33,56 +29,33 @@ function assertNotNull(value, ...[msg]) {
     throw new TypeError(msg);
   }
 }
-function* eRange(start, end, increment = 1) {
-  if (end === void 0) {
-    yield* eRange(0, start, increment);
-    return;
-  }
-  for (let i = start; i < end; i += increment) {
-    yield i;
-  }
-}
-function* iRange(start, end, increment = 1) {
-  if (end === void 0) {
-    yield* iRange(0, start, increment);
-    return;
-  }
-  const exclusiveEnd = end + 1;
-  yield* eRange(start, exclusiveEnd, increment);
-}
-function isKeyOf(key, target) {
-  return key in target;
-}
-function noop() {
-}
-function parseFloatSafe(string) {
-  if (typeof string !== "string") {
-    return void 0;
-  }
-  const trimmedString = string.trim();
-  if (FLOAT_REGEX.exec(trimmedString) === null) {
-    return void 0;
+function assertObject(value, msg) {
+  if (!isObject(value)) {
+    throw new TypeError(msg);
   }
-  const number = Number.parseFloat(trimmedString);
-  return Number.isNaN(number) ? void 0 : number;
 }
-function parseIntSafe(string) {
-  if (typeof string !== "string") {
-    return void 0;
-  }
-  const trimmedString = string.trim();
-  if (INTEGER_REGEX.exec(trimmedString) === null) {
-    return void 0;
+function assertType(value, type, msg) {
+  const validationFunction = TYPES_TO_VALIDATION_FUNCTIONS[type];
+  if (!validationFunction(value)) {
+    throw new TypeError(msg);
   }
-  const number = Number.parseInt(trimmedString, 10);
-  return Number.isNaN(number) ? void 0 : number;
 }
-function repeat(num, func) {
-  for (let i = 0; i < num; i++) {
-    func(i);
+
+function getRandomInt(min, max, exceptions = []) {
+  min = Math.ceil(min);
+  max = Math.floor(max);
+  if (min > max) {
+    const oldMin = min;
+    const oldMax = max;
+    min = oldMax;
+    max = oldMin;
   }
-}
-function todo(...args) {
+  const exceptionsSet = new ReadonlySet(exceptions);
+  let randomInt;
+  do {
+    randomInt = Math.floor(Math.random() * (max - min + 1)) + min;
+  } while (exceptionsSet.has(randomInt));
+  return randomInt;
 }
 
 function arrayCopyTwoDimensional(array) {
@@ -115,7 +88,7 @@ function arrayRemoveInPlace(array, ...elementsToRemove) {
   const removedElements = [];
   for (const element of elementsToRemove) {
     const index = array.indexOf(element);
-    if (index > -1) {
+    if (index !== -1) {
       const removedElement = array.splice(index, 1);
       removedElements.push(...removedElement);
     }
@@ -217,16 +190,6 @@ function mapFind(map, predicate) {
   }
   return void 0;
 }
-function objectToMap(object) {
-  const map = /* @__PURE__ */ new Map();
-  for (const [key, value] of Object.entries(object)) {
-    map.set(key, value);
-  }
-  return map;
-}
-function objectToReadonlyMap(object) {
-  return objectToMap(object);
-}
 
 function clamp(num, min, max) {
   return Math.max(min, Math.min(num, max));
@@ -243,6 +206,26 @@ function objectFilter(object, predicate) {
   }
   return array;
 }
+function objectToMap(object) {
+  const map = /* @__PURE__ */ new Map();
+  for (const [key, value] of Object.entries(object)) {
+    map.set(key, value);
+  }
+  return map;
+}
+function objectToReadonlyMap(object) {
+  return objectToMap(object);
+}
+function objectToReverseMap(object) {
+  const map = /* @__PURE__ */ new Map();
+  for (const [key, value] of Object.entries(object)) {
+    map.set(value, key);
+  }
+  return map;
+}
+function objectToReverseReadonlyMap(object) {
+  return objectToReverseMap(object);
+}
 
 function addSetsToSet(mainSet, ...setsToAdd) {
   for (const set of setsToAdd) {
@@ -306,6 +289,60 @@ function sortCaseInsensitive(array) {
   return newArray;
 }
 
+const FLOAT_REGEX = /^-?\d*\.?\d+$/;
+const INTEGER_REGEX = /^-?\d+$/;
+function* eRange(start, end, increment = 1) {
+  if (end === void 0) {
+    yield* eRange(0, start, increment);
+    return;
+  }
+  for (let i = start; i < end; i += increment) {
+    yield i;
+  }
+}
+function* iRange(start, end, increment = 1) {
+  if (end === void 0) {
+    yield* iRange(0, start, increment);
+    return;
+  }
+  const exclusiveEnd = end + 1;
+  yield* eRange(start, exclusiveEnd, increment);
+}
+function isKeyOf(key, target) {
+  return key in target;
+}
+function noop() {
+}
+function parseFloatSafe(string) {
+  if (typeof string !== "string") {
+    return void 0;
+  }
+  const trimmedString = string.trim();
+  if (FLOAT_REGEX.exec(trimmedString) === null) {
+    return void 0;
+  }
+  const number = Number.parseFloat(trimmedString);
+  return Number.isNaN(number) ? void 0 : number;
+}
+function parseIntSafe(string) {
+  if (typeof string !== "string") {
+    return void 0;
+  }
+  const trimmedString = string.trim();
+  if (INTEGER_REGEX.exec(trimmedString) === null) {
+    return void 0;
+  }
+  const number = Number.parseInt(trimmedString, 10);
+  return Number.isNaN(number) ? void 0 : number;
+}
+function repeat(num, func) {
+  for (let i = 0; i < num; i++) {
+    func(i);
+  }
+}
+function todo(...args) {
+}
+
 const DIACRITIC_REGEX = /\p{Diacritic}/u;
 const EMOJI_REGEX = /(\p{Extended_Pictographic}|\p{Emoji_Component})/u;
 const FIRST_LETTER_CAPITALIZED_REGEX = /^\p{Lu}/u;
@@ -447,6 +484,13 @@ function truncateString(string, maxLength) {
   return string.slice(0, maxLength);
 }
 
+function getElapsedSeconds(startTime) {
+  const endTime = Date.now();
+  const elapsedMilliseconds = endTime - startTime;
+  const elapsedSeconds = elapsedMilliseconds / 1e3;
+  return Math.floor(elapsedSeconds);
+}
+
 function* tupleEntries(tuple) {
   yield* tuple.entries();
 }
@@ -454,10 +498,6 @@ function* tupleKeys(tuple) {
   yield* tuple.keys();
 }
 
-function isObject(variable) {
-  return typeof variable === "object" && variable !== null && !Array.isArray(variable);
-}
-
 const ReadonlyMap = Map;
 
-export { HOUR_IN_MILLISECONDS, MINUTE_IN_MILLISECONDS, ReadonlyMap, ReadonlySet, SECOND_IN_MILLISECONDS, addSetsToSet, arrayCopyTwoDimensional, arrayEquals, arrayRemove, arrayRemoveInPlace, assertDefined, assertNotNull, capitalizeFirstLetter, clamp, combineSets, copySet, eRange, emptyArray, escapeHTMLCharacters, filterMap, getEnumEntries, getEnumKeys, getEnumValues, getNumConsecutiveDiacritics, getRandomArrayElement, getRandomArrayIndex, getRandomInt, hasDiacritic, hasEmoji, hasWhitespace, iRange, includes, interfaceSatisfiesEnum, isArray, isEnumValue, isFirstLetterCapitalized, isKebabCase, isKeyOf, isObject, isSemanticVersion, kebabCaseToCamelCase, mapFilter, mapFind, newArray, noop, normalizeString, objectFilter, objectKeysToReadonlySet, objectKeysToSet, objectToMap, objectToReadonlyMap, objectValuesToReadonlySet, objectValuesToSet, parseFloatSafe, parseIntSafe, parseSemanticVersion, removeLinesBetweenMarkers, removeLinesMatching, removeNonPrintableCharacters, removeWhitespace, repeat, setAdd, setHas, sortCaseInsensitive, sumArray, todo, trimPrefix, trimSuffix, truncateString, tupleEntries, tupleKeys };
+export { HOUR_IN_MILLISECONDS, MINUTE_IN_MILLISECONDS, ReadonlyMap, ReadonlySet, SECOND_IN_MILLISECONDS, addSetsToSet, arrayCopyTwoDimensional, arrayEquals, arrayRemove, arrayRemoveInPlace, assertDefined, assertNotNull, assertObject, assertType, capitalizeFirstLetter, clamp, combineSets, copySet, eRange, emptyArray, escapeHTMLCharacters, filterMap, getElapsedSeconds, getEnumEntries, getEnumKeys, getEnumValues, getNumConsecutiveDiacritics, getRandomArrayElement, getRandomArrayIndex, getRandomInt, hasDiacritic, hasEmoji, hasWhitespace, iRange, includes, interfaceSatisfiesEnum, isArray, isEnumValue, isFirstLetterCapitalized, isKebabCase, isKeyOf, isObject, isSemanticVersion, kebabCaseToCamelCase, mapFilter, mapFind, newArray, noop, normalizeString, objectFilter, objectKeysToReadonlySet, objectKeysToSet, objectToMap, objectToReadonlyMap, objectToReverseMap, objectToReverseReadonlyMap, objectValuesToReadonlySet, objectValuesToSet, parseFloatSafe, parseIntSafe, parseSemanticVersion, removeLinesBetweenMarkers, removeLinesMatching, removeNonPrintableCharacters, removeWhitespace, repeat, setAdd, setHas, sortCaseInsensitive, sumArray, todo, trimPrefix, trimSuffix, truncateString, tupleEntries, tupleKeys };

package/dist/types/AddSubtract.d.cts

@@ -0,0 +1,23 @@
+/**
+ * Helper type to add two other types.
+ *
+ * From: https://gist.github.com/ryandabler/8b4ff4f36aed47bc09acc03174638468
+ */
+export type Add<A extends number, B extends number> = Length<[
+    ...BuildTuple<A>,
+    ...BuildTuple<B>
+]>;
+/**
+ * Helper type to subtract two other types.
+ *
+ * From: https://gist.github.com/ryandabler/8b4ff4f36aed47bc09acc03174638468
+ */
+export type Subtract<A extends number, B extends number> = A extends A ? BuildTuple<A> extends [...infer U, ...BuildTuple<B>] ? Length<U> : never : never;
+type BuildTuple<L extends number, T extends unknown[] = []> = T extends {
+    length: L;
+} ? T : BuildTuple<L, [...T, unknown]>;
+type Length<T extends unknown[]> = T extends {
+    length: infer L;
+} ? L : never;
+export {};
+//# sourceMappingURL=AddSubtract.d.ts.map

package/dist/types/AddSubtract.d.mts

@@ -0,0 +1,23 @@
+/**
+ * Helper type to add two other types.
+ *
+ * From: https://gist.github.com/ryandabler/8b4ff4f36aed47bc09acc03174638468
+ */
+export type Add<A extends number, B extends number> = Length<[
+    ...BuildTuple<A>,
+    ...BuildTuple<B>
+]>;
+/**
+ * Helper type to subtract two other types.
+ *
+ * From: https://gist.github.com/ryandabler/8b4ff4f36aed47bc09acc03174638468
+ */
+export type Subtract<A extends number, B extends number> = A extends A ? BuildTuple<A> extends [...infer U, ...BuildTuple<B>] ? Length<U> : never : never;
+type BuildTuple<L extends number, T extends unknown[] = []> = T extends {
+    length: L;
+} ? T : BuildTuple<L, [...T, unknown]>;
+type Length<T extends unknown[]> = T extends {
+    length: infer L;
+} ? L : never;
+export {};
+//# sourceMappingURL=AddSubtract.d.ts.map

package/dist/types/AddSubtract.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Helper type to add two other types.
+ *
+ * From: https://gist.github.com/ryandabler/8b4ff4f36aed47bc09acc03174638468
+ */
+export type Add<A extends number, B extends number> = Length<[
+    ...BuildTuple<A>,
+    ...BuildTuple<B>
+]>;
+/**
+ * Helper type to subtract two other types.
+ *
+ * From: https://gist.github.com/ryandabler/8b4ff4f36aed47bc09acc03174638468
+ */
+export type Subtract<A extends number, B extends number> = A extends A ? BuildTuple<A> extends [...infer U, ...BuildTuple<B>] ? Length<U> : never : never;
+type BuildTuple<L extends number, T extends unknown[] = []> = T extends {
+    length: L;
+} ? T : BuildTuple<L, [...T, unknown]>;
+type Length<T extends unknown[]> = T extends {
+    length: infer L;
+} ? L : never;
+export {};
+//# sourceMappingURL=AddSubtract.d.ts.map

package/dist/types/AddSubtract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AddSubtract.d.ts","sourceRoot":"","sources":["../../src/types/AddSubtract.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,GAAG,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,IAAI,MAAM,CAC1D;IAAC,GAAG,UAAU,CAAC,CAAC,CAAC;IAAE,GAAG,UAAU,CAAC,CAAC,CAAC;CAAC,CACrC,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,CAAC,GAClE,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,EAAE,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,GAClD,MAAM,CAAC,CAAC,CAAC,GACT,KAAK,GACP,KAAK,CAAC;AAEV,KAAK,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,SAAS;IACtE,MAAM,EAAE,CAAC,CAAC;CACX,GACG,CAAC,GACD,UAAU,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;AAEnC,KAAK,MAAM,CAAC,CAAC,SAAS,OAAO,EAAE,IAAI,CAAC,SAAS;IAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,CAAC,GAAG,KAAK,CAAC"}

package/dist/types/CompositionTypeSatisfiesEnum.d.cts

@@ -0,0 +1,35 @@
+/**
+ * Helper type to validate that a union of interfaces with a field of `type` that is based on an
+ * enum is complete.
+ *
+ * For example:
+ *
+ * ```ts
+ * enum ObjectiveType {
+ *   Foo,
+ *   Bar,
+ *   Baz,
+ * }
+ *
+ * interface FooObjective {
+ *   type: ObjectiveType.Foo;
+ *   fooThing: number;
+ * }
+ *
+ * interface BarObjective {
+ *   type: ObjectiveType.Bar;
+ *   barThing: string;
+ * }
+ *
+ * type Objective = FooObjective | BarObjective;
+ * type _Test = CompositionTypeSatisfiesEnum<Objective, ObjectiveType>;
+ * ```
+ *
+ * In this example, `Test` would be flagged by TypeScript because `Objective` does not contain an
+ * entry for `BazObjective`.
+ */
+export type CompositionTypeSatisfiesEnum<T extends {
+    /** The type of the discriminated union. */
+    type: unknown;
+}, _Enum extends T["type"]> = unknown;
+//# sourceMappingURL=CompositionTypeSatisfiesEnum.d.ts.map

package/dist/types/CompositionTypeSatisfiesEnum.d.mts

@@ -0,0 +1,35 @@
+/**
+ * Helper type to validate that a union of interfaces with a field of `type` that is based on an
+ * enum is complete.
+ *
+ * For example:
+ *
+ * ```ts
+ * enum ObjectiveType {
+ *   Foo,
+ *   Bar,
+ *   Baz,
+ * }
+ *
+ * interface FooObjective {
+ *   type: ObjectiveType.Foo;
+ *   fooThing: number;
+ * }
+ *
+ * interface BarObjective {
+ *   type: ObjectiveType.Bar;
+ *   barThing: string;
+ * }
+ *
+ * type Objective = FooObjective | BarObjective;
+ * type _Test = CompositionTypeSatisfiesEnum<Objective, ObjectiveType>;
+ * ```
+ *
+ * In this example, `Test` would be flagged by TypeScript because `Objective` does not contain an
+ * entry for `BazObjective`.
+ */
+export type CompositionTypeSatisfiesEnum<T extends {
+    /** The type of the discriminated union. */
+    type: unknown;
+}, _Enum extends T["type"]> = unknown;
+//# sourceMappingURL=CompositionTypeSatisfiesEnum.d.ts.map

package/dist/types/CompositionTypeSatisfiesEnum.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Helper type to validate that a union of interfaces with a field of `type` that is based on an
+ * enum is complete.
+ *
+ * For example:
+ *
+ * ```ts
+ * enum ObjectiveType {
+ *   Foo,
+ *   Bar,
+ *   Baz,
+ * }
+ *
+ * interface FooObjective {
+ *   type: ObjectiveType.Foo;
+ *   fooThing: number;
+ * }
+ *
+ * interface BarObjective {
+ *   type: ObjectiveType.Bar;
+ *   barThing: string;
+ * }
+ *
+ * type Objective = FooObjective | BarObjective;
+ * type _Test = CompositionTypeSatisfiesEnum<Objective, ObjectiveType>;
+ * ```
+ *
+ * In this example, `Test` would be flagged by TypeScript because `Objective` does not contain an
+ * entry for `BazObjective`.
+ */
+export type CompositionTypeSatisfiesEnum<T extends {
+    /** The type of the discriminated union. */
+    type: unknown;
+}, _Enum extends T["type"]> = unknown;
+//# sourceMappingURL=CompositionTypeSatisfiesEnum.d.ts.map

package/dist/types/CompositionTypeSatisfiesEnum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompositionTypeSatisfiesEnum.d.ts","sourceRoot":"","sources":["../../src/types/CompositionTypeSatisfiesEnum.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,MAAM,4BAA4B,CACtC,CAAC,SAAS;IACR,2CAA2C;IAC3C,IAAI,EAAE,OAAO,CAAC;CACf,EACD,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC,IACrB,OAAO,CAAC"}

package/dist/types/ERange.d.cts

@@ -0,0 +1,12 @@
+import type { NaturalNumbersLessThan } from "./NaturalNumbersLessThan.js";
+/**
+ * Helper type to get a range of integers. It is inclusive on the lower end and exclusive on the
+ * high end. (The "E" in the type name stands for exclusive.)
+ *
+ * For example, `ERange<3, 5>` will return `3 | 4`.
+ *
+ * From:
+ * https://stackoverflow.com/questions/39494689/is-it-possible-to-restrict-number-to-a-certain-range
+ */
+export type ERange<Low extends number, High extends number> = Exclude<NaturalNumbersLessThan<High>, NaturalNumbersLessThan<Low>>;
+//# sourceMappingURL=ERange.d.ts.map

package/dist/types/ERange.d.mts

@@ -0,0 +1,12 @@
+import type { NaturalNumbersLessThan } from "./NaturalNumbersLessThan.js";
+/**
+ * Helper type to get a range of integers. It is inclusive on the lower end and exclusive on the
+ * high end. (The "E" in the type name stands for exclusive.)
+ *
+ * For example, `ERange<3, 5>` will return `3 | 4`.
+ *
+ * From:
+ * https://stackoverflow.com/questions/39494689/is-it-possible-to-restrict-number-to-a-certain-range
+ */
+export type ERange<Low extends number, High extends number> = Exclude<NaturalNumbersLessThan<High>, NaturalNumbersLessThan<Low>>;
+//# sourceMappingURL=ERange.d.ts.map

package/dist/types/ERange.d.ts

@@ -0,0 +1,12 @@
+import type { NaturalNumbersLessThan } from "./NaturalNumbersLessThan.js";
+/**
+ * Helper type to get a range of integers. It is inclusive on the lower end and exclusive on the
+ * high end. (The "E" in the type name stands for exclusive.)
+ *
+ * For example, `ERange<3, 5>` will return `3 | 4`.
+ *
+ * From:
+ * https://stackoverflow.com/questions/39494689/is-it-possible-to-restrict-number-to-a-certain-range
+ */
+export type ERange<Low extends number, High extends number> = Exclude<NaturalNumbersLessThan<High>, NaturalNumbersLessThan<Low>>;
+//# sourceMappingURL=ERange.d.ts.map

package/dist/types/ERange.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ERange.d.ts","sourceRoot":"","sources":["../../src/types/ERange.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAE1E;;;;;;;;GAQG;AACH,MAAM,MAAM,MAAM,CAAC,GAAG,SAAS,MAAM,EAAE,IAAI,SAAS,MAAM,IAAI,OAAO,CACnE,sBAAsB,CAAC,IAAI,CAAC,EAC5B,sBAAsB,CAAC,GAAG,CAAC,CAC5B,CAAC"}

package/dist/types/IRange.d.cts

@@ -0,0 +1,13 @@
+import type { NaturalNumbersLessThan } from "./NaturalNumbersLessThan.js";
+import type { NaturalNumbersLessThanOrEqualTo } from "./NaturalNumbersLessThanOrEqualTo.js";
+/**
+ * Helper type to get a range of integers. It is inclusive on both ends. (The "I" in the type name
+ * stands for inclusive.)
+ *
+ * For example, `IRange<3, 5>` will return `3 | 4 | 5`.
+ *
+ * From:
+ * https://stackoverflow.com/questions/39494689/is-it-possible-to-restrict-number-to-a-certain-range
+ */
+export type IRange<Low extends number, High extends number> = Exclude<NaturalNumbersLessThanOrEqualTo<High>, NaturalNumbersLessThan<Low>>;
+//# sourceMappingURL=IRange.d.ts.map

package/dist/types/IRange.d.mts

@@ -0,0 +1,13 @@
+import type { NaturalNumbersLessThan } from "./NaturalNumbersLessThan.js";
+import type { NaturalNumbersLessThanOrEqualTo } from "./NaturalNumbersLessThanOrEqualTo.js";
+/**
+ * Helper type to get a range of integers. It is inclusive on both ends. (The "I" in the type name
+ * stands for inclusive.)
+ *
+ * For example, `IRange<3, 5>` will return `3 | 4 | 5`.
+ *
+ * From:
+ * https://stackoverflow.com/questions/39494689/is-it-possible-to-restrict-number-to-a-certain-range
+ */
+export type IRange<Low extends number, High extends number> = Exclude<NaturalNumbersLessThanOrEqualTo<High>, NaturalNumbersLessThan<Low>>;
+//# sourceMappingURL=IRange.d.ts.map

package/dist/types/IRange.d.ts

@@ -0,0 +1,13 @@
+import type { NaturalNumbersLessThan } from "./NaturalNumbersLessThan.js";
+import type { NaturalNumbersLessThanOrEqualTo } from "./NaturalNumbersLessThanOrEqualTo.js";
+/**
+ * Helper type to get a range of integers. It is inclusive on both ends. (The "I" in the type name
+ * stands for inclusive.)
+ *
+ * For example, `IRange<3, 5>` will return `3 | 4 | 5`.
+ *
+ * From:
+ * https://stackoverflow.com/questions/39494689/is-it-possible-to-restrict-number-to-a-certain-range
+ */
+export type IRange<Low extends number, High extends number> = Exclude<NaturalNumbersLessThanOrEqualTo<High>, NaturalNumbersLessThan<Low>>;
+//# sourceMappingURL=IRange.d.ts.map

package/dist/types/IRange.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IRange.d.ts","sourceRoot":"","sources":["../../src/types/IRange.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAC;AAE5F;;;;;;;;GAQG;AACH,MAAM,MAAM,MAAM,CAAC,GAAG,SAAS,MAAM,EAAE,IAAI,SAAS,MAAM,IAAI,OAAO,CACnE,+BAA+B,CAAC,IAAI,CAAC,EACrC,sBAAsB,CAAC,GAAG,CAAC,CAC5B,CAAC"}

package/dist/types/Immutable.d.cts

@@ -0,0 +1,17 @@
+/**
+ * Immutable is a utility type that will make the given array/map/set/object recursively read-only.
+ *
+ * You can use this type to easily build safe data structures.
+ *
+ * From: https://stackoverflow.com/questions/41879327/deepreadonly-object-typescript
+ */
+export type Immutable<T> = T extends ImmutablePrimitive ? T : T extends Array<infer U> ? ImmutableArray<U> : T extends Map<infer K, infer V> ? ImmutableMap<K, V> : T extends Set<infer M> ? ImmutableSet<M> : ImmutableObject<T>;
+type ImmutablePrimitive = undefined | null | boolean | string | number | Function;
+type ImmutableArray<T> = ReadonlyArray<Immutable<T>>;
+type ImmutableMap<K, V> = ReadonlyMap<Immutable<K>, Immutable<V>>;
+type ImmutableSet<T> = ReadonlySet<Immutable<T>>;
+type ImmutableObject<T> = {
+    readonly [K in keyof T]: Immutable<T[K]>;
+};
+export {};
+//# sourceMappingURL=Immutable.d.ts.map

package/dist/types/Immutable.d.mts

@@ -0,0 +1,17 @@
+/**
+ * Immutable is a utility type that will make the given array/map/set/object recursively read-only.
+ *
+ * You can use this type to easily build safe data structures.
+ *
+ * From: https://stackoverflow.com/questions/41879327/deepreadonly-object-typescript
+ */
+export type Immutable<T> = T extends ImmutablePrimitive ? T : T extends Array<infer U> ? ImmutableArray<U> : T extends Map<infer K, infer V> ? ImmutableMap<K, V> : T extends Set<infer M> ? ImmutableSet<M> : ImmutableObject<T>;
+type ImmutablePrimitive = undefined | null | boolean | string | number | Function;
+type ImmutableArray<T> = ReadonlyArray<Immutable<T>>;
+type ImmutableMap<K, V> = ReadonlyMap<Immutable<K>, Immutable<V>>;
+type ImmutableSet<T> = ReadonlySet<Immutable<T>>;
+type ImmutableObject<T> = {
+    readonly [K in keyof T]: Immutable<T[K]>;
+};
+export {};
+//# sourceMappingURL=Immutable.d.ts.map

package/dist/types/Immutable.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Immutable is a utility type that will make the given array/map/set/object recursively read-only.
+ *
+ * You can use this type to easily build safe data structures.
+ *
+ * From: https://stackoverflow.com/questions/41879327/deepreadonly-object-typescript
+ */
+export type Immutable<T> = T extends ImmutablePrimitive ? T : T extends Array<infer U> ? ImmutableArray<U> : T extends Map<infer K, infer V> ? ImmutableMap<K, V> : T extends Set<infer M> ? ImmutableSet<M> : ImmutableObject<T>;
+type ImmutablePrimitive = undefined | null | boolean | string | number | Function;
+type ImmutableArray<T> = ReadonlyArray<Immutable<T>>;
+type ImmutableMap<K, V> = ReadonlyMap<Immutable<K>, Immutable<V>>;
+type ImmutableSet<T> = ReadonlySet<Immutable<T>>;
+type ImmutableObject<T> = {
+    readonly [K in keyof T]: Immutable<T[K]>;
+};
+export {};
+//# sourceMappingURL=Immutable.d.ts.map

package/dist/types/Immutable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Immutable.d.ts","sourceRoot":"","sources":["../../src/types/Immutable.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,kBAAkB,GACnD,CAAC,GACD,CAAC,SAAS,KAAK,CAAC,MAAM,CAAC,CAAC,GACtB,cAAc,CAAC,CAAC,CAAC,GACjB,CAAC,SAAS,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,GAC7B,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,GAClB,CAAC,SAAS,GAAG,CAAC,MAAM,CAAC,CAAC,GACpB,YAAY,CAAC,CAAC,CAAC,GACf,eAAe,CAAC,CAAC,CAAC,CAAC;AAE7B,KAAK,kBAAkB,GACnB,SAAS,GACT,IAAI,GACJ,OAAO,GACP,MAAM,GACN,MAAM,GACN,QAAQ,CAAC;AACb,KAAK,cAAc,CAAC,CAAC,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;AACrD,KAAK,YAAY,CAAC,CAAC,EAAE,CAAC,IAAI,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;AAClE,KAAK,YAAY,CAAC,CAAC,IAAI,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;AACjD,KAAK,eAAe,CAAC,CAAC,IAAI;IAAE,QAAQ,EAAE,CAAC,IAAI,MAAM,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC"}

package/dist/types/NaturalNumbersLessThan.d.cts

@@ -0,0 +1,8 @@
+/**
+ * Helper type to get a range of integers between 0 and N - 1.
+ *
+ * From:
+ * https://stackoverflow.com/questions/39494689/is-it-possible-to-restrict-number-to-a-certain-range
+ */
+export type NaturalNumbersLessThan<N extends number, Acc extends number[] = []> = Acc["length"] extends N ? Acc[number] : NaturalNumbersLessThan<N, [...Acc, Acc["length"]]>;
+//# sourceMappingURL=NaturalNumbersLessThan.d.ts.map

package/dist/types/NaturalNumbersLessThan.d.mts

@@ -0,0 +1,8 @@
+/**
+ * Helper type to get a range of integers between 0 and N - 1.
+ *
+ * From:
+ * https://stackoverflow.com/questions/39494689/is-it-possible-to-restrict-number-to-a-certain-range
+ */
+export type NaturalNumbersLessThan<N extends number, Acc extends number[] = []> = Acc["length"] extends N ? Acc[number] : NaturalNumbersLessThan<N, [...Acc, Acc["length"]]>;
+//# sourceMappingURL=NaturalNumbersLessThan.d.ts.map

package/dist/types/NaturalNumbersLessThan.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Helper type to get a range of integers between 0 and N - 1.
+ *
+ * From:
+ * https://stackoverflow.com/questions/39494689/is-it-possible-to-restrict-number-to-a-certain-range
+ */
+export type NaturalNumbersLessThan<N extends number, Acc extends number[] = []> = Acc["length"] extends N ? Acc[number] : NaturalNumbersLessThan<N, [...Acc, Acc["length"]]>;
+//# sourceMappingURL=NaturalNumbersLessThan.d.ts.map

package/dist/types/NaturalNumbersLessThan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NaturalNumbersLessThan.d.ts","sourceRoot":"","sources":["../../src/types/NaturalNumbersLessThan.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,sBAAsB,CAChC,CAAC,SAAS,MAAM,EAChB,GAAG,SAAS,MAAM,EAAE,GAAG,EAAE,IACvB,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,GACvB,GAAG,CAAC,MAAM,CAAC,GACX,sBAAsB,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC"}

package/dist/types/NaturalNumbersLessThanOrEqualTo.d.cts

@@ -0,0 +1,8 @@
+/**
+ * Helper type to get a range of integers between 0 and N.
+ *
+ * From:
+ * https://stackoverflow.com/questions/39494689/is-it-possible-to-restrict-number-to-a-certain-range
+ */
+export type NaturalNumbersLessThanOrEqualTo<N extends number, T extends number[] = []> = T extends [unknown, ...infer Tail] ? Tail["length"] extends N ? T[number] : NaturalNumbersLessThanOrEqualTo<N, [...T, T["length"]]> : NaturalNumbersLessThanOrEqualTo<N, [...T, T["length"]]>;
+//# sourceMappingURL=NaturalNumbersLessThanOrEqualTo.d.ts.map

package/dist/types/NaturalNumbersLessThanOrEqualTo.d.mts

@@ -0,0 +1,8 @@
+/**
+ * Helper type to get a range of integers between 0 and N.
+ *
+ * From:
+ * https://stackoverflow.com/questions/39494689/is-it-possible-to-restrict-number-to-a-certain-range
+ */
+export type NaturalNumbersLessThanOrEqualTo<N extends number, T extends number[] = []> = T extends [unknown, ...infer Tail] ? Tail["length"] extends N ? T[number] : NaturalNumbersLessThanOrEqualTo<N, [...T, T["length"]]> : NaturalNumbersLessThanOrEqualTo<N, [...T, T["length"]]>;
+//# sourceMappingURL=NaturalNumbersLessThanOrEqualTo.d.ts.map