inferred-types 0.37.6 → 0.40.2

package/dist/src/runtime/lists/intersection.js

@@ -0,0 +1,40 @@
+import { get, ifNotNull, isIndexable, getEach, toString } from "src/runtime";
+function intersectWithOffset(a, b, deref) {
+    const aIndexable = a.every(i => isIndexable(i));
+    const bIndexable = b.every(i => isIndexable(i));
+    if (!aIndexable || !bIndexable) {
+        if (!aIndexable) {
+            throw new Error(`The "a" array passed into intersect(a,b) was not fully composed of indexable properties: ${a.map(i => typeof i).join(", ")}`);
+        }
+        else {
+            throw new Error(`The "b" array passed into intersect(a,b) was not fully composed of indexable properties: ${b.map(i => typeof i).join(", ")}`);
+        }
+    }
+    const aMatches = getEach(a, toString(deref));
+    const bMatches = getEach(b, toString(deref));
+    const sharedKeys = ifNotNull(deref, v => [
+        a.filter(i => Array.from(bMatches).includes(get(i, v))),
+        b.filter(i => Array.from(aMatches).includes(get(i, v)))
+    ], () => a.filter(k => b.includes(k)));
+    return sharedKeys;
+}
+function intersectNoOffset(a, b) {
+    return a.length < b.length
+        ? a.filter((val) => b.includes(val))
+        : b.filter((val) => a.includes(val));
+}
+/**
+ * **intersection**(a,b,[deref])
+ *
+ * A set operation which provides the _intersection_ between
+ * between two array's `a` and `b`.
+ *
+ * - when passing in arrays, you may also pass in a _dereferencing_ property
+ * which will be used for arrays of objects (or sub-arrays) so that the comparison
+ * is done on the dereferenced value versus the value as a whole.
+ */
+export const intersection = (a, b, deref = null) => {
+    return (deref === null
+        ? intersectNoOffset(a, b)
+        : intersectWithOffset(a, b, deref));
+};

package/dist/src/runtime/lists/join.d.ts

@@ -0,0 +1,17 @@
+import { Tuple, Join } from "src/types";
+export type Joiner<TJoin extends string> = <TContent extends Tuple<string>>(...tuple: TContent) => Join<TContent, TJoin>;
+/**
+ * **join**(joinWith)(tuple) -> joined
+ *
+ * A higher order runtime utility which provides the ability to create
+ * type-strong join's with an array of string and a joining string.
+ *
+ * ```ts
+ * // "hello world"
+ * const helloWorld = join("")("hello", " ", "world");
+ * // "foo, bar, baz"
+ * const list = join(", ")("foo", "bar", "baz");
+ * ```
+ */
+export declare function join<TJoin extends string>(joinWith: TJoin): Joiner<TJoin>;
+//# sourceMappingURL=join.d.ts.map

package/dist/src/runtime/lists/join.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"join.d.ts","sourceRoot":"","sources":["../../../../src/runtime/lists/join.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAExC,MAAM,MAAM,MAAM,CAAC,KAAK,SAAS,MAAM,IAAI,CAAC,QAAQ,SAAS,KAAK,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC,QAAQ,EAAC,KAAK,CAAC,CAAC;AAExH;;;;;;;;;;;;GAYG;AACH,wBAAgB,IAAI,CAAC,KAAK,SAAS,MAAM,EAAE,QAAQ,EAAE,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAIzE"}

package/dist/src/runtime/lists/join.js

@@ -0,0 +1,18 @@
+/**
+ * **join**(joinWith)(tuple) -> joined
+ *
+ * A higher order runtime utility which provides the ability to create
+ * type-strong join's with an array of string and a joining string.
+ *
+ * ```ts
+ * // "hello world"
+ * const helloWorld = join("")("hello", " ", "world");
+ * // "foo, bar, baz"
+ * const list = join(", ")("foo", "bar", "baz");
+ * ```
+ */
+export function join(joinWith) {
+    return (...tuple) => {
+        return tuple.join(joinWith);
+    };
+}

package/dist/src/runtime/lists/last.d.ts

@@ -0,0 +1,3 @@
+import { Last } from "src/types";
+export declare const last: <T extends readonly unknown[]>(list: T) => Last<T>;
+//# sourceMappingURL=last.d.ts.map

package/dist/src/runtime/lists/last.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"last.d.ts","sourceRoot":"","sources":["../../../../src/runtime/lists/last.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAS,MAAM,WAAW,CAAC;AAExC,eAAO,MAAM,IAAI,oDAEhB,CAAC"}

package/dist/src/runtime/lists/last.js

@@ -0,0 +1,3 @@
+export const last = (list) => {
+    return [...list].pop();
+};

package/dist/src/runtime/lists/logicalReturns.d.ts

@@ -0,0 +1,3 @@
+import { LogicFunction } from "src/types";
+export declare function logicalReturns<TConditions extends readonly (boolean | LogicFunction<TParams>)[], TParams extends readonly unknown[] = []>(conditions: TConditions, ...params: TParams): boolean[];
+//# sourceMappingURL=logicalReturns.d.ts.map

package/dist/src/runtime/lists/logicalReturns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logicalReturns.d.ts","sourceRoot":"","sources":["../../../../src/runtime/lists/logicalReturns.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAG1C,wBAAgB,cAAc,CAC5B,WAAW,SAAS,SAAS,CAAC,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC,EAAE,EACjE,OAAO,SAAS,SAAS,OAAO,EAAE,GAAG,EAAE,EACvC,UAAU,EAAE,WAAW,EAAE,GAAG,MAAM,EAAE,OAAO,aAQ5C"}

package/dist/src/runtime/lists/logicalReturns.js

@@ -0,0 +1,4 @@
+import { ifBoolean, ifFunction } from "src/runtime";
+export function logicalReturns(conditions, ...params) {
+    return conditions.map(c => ifBoolean(c, v => v, v => ifFunction(v, (fn) => fn(...params), () => null)));
+}

package/dist/src/runtime/lists/pop.d.ts

@@ -0,0 +1,14 @@
+import { Narrowable, Slice, Tuple, IfIndexable, Last } from "src/types";
+export type PopResult<V, L extends Tuple> = [value: V, list: L];
+/**
+ * **pop**(list)
+ *
+ * Takes a list of elements and then returns a `PopResult` unless
+ * there were no more elements in which case the value _undefined_ is returned.
+ * ```ts
+ * // [3, [1,2]]
+ * const [val, list] = pop([1,2,3]);
+ * ```
+ */
+export declare const pop: <N extends Narrowable, K extends PropertyKey, T extends readonly (Narrowable | Record<K, N>)[]>(list: T) => IfIndexable<T, PopResult<Last<T>, Slice<T, 0, -1>>, undefined>;
+//# sourceMappingURL=pop.d.ts.map

package/dist/src/runtime/lists/pop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pop.d.ts","sourceRoot":"","sources":["../../../../src/runtime/lists/pop.ts"],"names":[],"mappings":"AAAA,OAAO,EAAG,UAAU,EAAE,KAAK,EAAE,KAAK,EAAG,WAAW,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAG1E,MAAM,MAAM,SAAS,CAAC,CAAC,EAAE,CAAC,SAAS,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAEhE;;;;;;;;;GASG;AACH,eAAO,MAAM,GAAG,4KAUf,CAAC"}

package/dist/src/runtime/lists/pop.js

@@ -0,0 +1,16 @@
+import { last, slice } from "src/runtime";
+/**
+ * **pop**(list)
+ *
+ * Takes a list of elements and then returns a `PopResult` unless
+ * there were no more elements in which case the value _undefined_ is returned.
+ * ```ts
+ * // [3, [1,2]]
+ * const [val, list] = pop([1,2,3]);
+ * ```
+ */
+export const pop = (list) => {
+    return (list.length > 0
+        ? [last(list), slice(list, 0, -1)]
+        : undefined);
+};

package/dist/src/runtime/lists/reverse.d.ts

@@ -0,0 +1,8 @@
+import { Reverse } from "src/types";
+/**
+ * **reverse**(list)
+ *
+ * Allows reversing the order of a readonly array and preserving the types.
+ */
+export declare const reverse: <T extends readonly unknown[]>(list: T) => Reverse<T>;
+//# sourceMappingURL=reverse.d.ts.map

package/dist/src/runtime/lists/reverse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reverse.d.ts","sourceRoot":"","sources":["../../../../src/runtime/lists/reverse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;;GAIG;AACH,eAAO,MAAM,OAAO,uDAEnB,CAAC"}

package/dist/src/runtime/lists/reverse.js

@@ -0,0 +1,8 @@
+/**
+ * **reverse**(list)
+ *
+ * Allows reversing the order of a readonly array and preserving the types.
+ */
+export const reverse = (list) => {
+    return [...list].reverse();
+};

package/dist/src/runtime/lists/shift.d.ts

@@ -0,0 +1,10 @@
+import { Narrowable, Slice, Tuple, IfIndexable } from "src/types";
+export type ShiftResult<V, L extends Tuple> = [value: V, list: L];
+/**
+ * **shift**(list)
+ *
+ * Takes a list of elements and then returns a `ShiftResult` unless
+ * there were no more elements in which case the value _undefined_ is returned.
+ */
+export declare const shift: <N extends Narrowable, K extends PropertyKey, T extends readonly (Narrowable | Record<K, N>)[]>(list: T) => IfIndexable<T, ShiftResult<T[0], Slice<T, 1>>, undefined>;
+//# sourceMappingURL=shift.d.ts.map

package/dist/src/runtime/lists/shift.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shift.d.ts","sourceRoot":"","sources":["../../../../src/runtime/lists/shift.ts"],"names":[],"mappings":"AAAA,OAAO,EAAG,UAAU,EAAE,KAAK,EAAE,KAAK,EAAG,WAAW,EAAE,MAAM,WAAW,CAAC;AAEpE,MAAM,MAAM,WAAW,CAAC,CAAC,EAAE,CAAC,SAAS,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAElE;;;;;GAKG;AACH,eAAO,MAAM,KAAK,uKAUjB,CAAC"}

package/dist/src/runtime/lists/shift.js

@@ -0,0 +1,11 @@
+/**
+ * **shift**(list)
+ *
+ * Takes a list of elements and then returns a `ShiftResult` unless
+ * there were no more elements in which case the value _undefined_ is returned.
+ */
+export const shift = (list) => {
+    return (list.length > 0
+        ? [list[0], list.slice(1)]
+        : undefined);
+};

package/dist/src/runtime/lists/slice.d.ts

@@ -0,0 +1,9 @@
+import { Slice } from "src/types";
+/**
+ * **slice**(list, start, end)
+ *
+ * Runtime utility to slice an array while maintaining strong
+ * types.
+ */
+export declare const slice: <TList extends readonly unknown[], TStart extends number, TEnd extends number>(list: TList, start: TStart, end: TEnd) => Slice<TList, TStart, TEnd>;
+//# sourceMappingURL=slice.d.ts.map

package/dist/src/runtime/lists/slice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slice.d.ts","sourceRoot":"","sources":["../../../../src/runtime/lists/slice.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAS,MAAM,WAAW,CAAC;AAEzC;;;;;GAKG;AACH,eAAO,MAAM,KAAK,qJAMjB,CAAC"}

package/dist/src/runtime/lists/slice.js

@@ -0,0 +1,9 @@
+/**
+ * **slice**(list, start, end)
+ *
+ * Runtime utility to slice an array while maintaining strong
+ * types.
+ */
+export const slice = (list, start, end) => {
+    return list.slice(start, end);
+};

package/dist/src/runtime/lists/unique.d.ts

@@ -0,0 +1,9 @@
+import { Tuple, Unique } from "src/types";
+/**
+ * **unique**
+ *
+ * Runtime utility which removes intersecting values from two sets and
+ * provides a unique values contained in each set.
+ */
+export declare function unique<A extends Tuple, B extends Tuple, TIndex extends string | number | null = null>(a: A, b: B, index?: TIndex): Unique<A, B, TIndex>;
+//# sourceMappingURL=unique.d.ts.map

package/dist/src/runtime/lists/unique.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unique.d.ts","sourceRoot":"","sources":["../../../../src/runtime/lists/unique.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGrD;;;;;GAKG;AACH,wBAAgB,MAAM,CACpB,CAAC,SAAS,KAAK,EACf,CAAC,SAAS,KAAK,EACf,MAAM,SAAS,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI,EAC5C,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,EAAC,CAAC,EAAC,MAAM,CAAC,CAehD"}

package/dist/src/runtime/lists/unique.js

@@ -0,0 +1,21 @@
+import { isString, indexOf } from "src/runtime";
+/**
+ * **unique**
+ *
+ * Runtime utility which removes intersecting values from two sets and
+ * provides a unique values contained in each set.
+ */
+export function unique(a, b, index) {
+    const offset = index
+        ? isString(index) ? index : String(index)
+        : null;
+    const bValues = offset === null
+        ? b
+        : b.map(i => indexOf(i, offset));
+    const aValues = offset === null
+        ? a
+        : a.map(i => indexOf(i, offset));
+    const forA = a.filter(i => !bValues.includes(indexOf(i, offset)));
+    const forB = b.filter(i => !aValues.includes(indexOf(i, offset)));
+    return [forA, forB];
+}

package/dist/src/runtime/literals/box.d.ts

@@ -0,0 +1,26 @@
+import type { Narrowable, Box, AnyObject } from "src/types";
+export type BoxValue<T extends Box<unknown>> = T extends Box<infer V> ? V : never;
+export type BoxedFnParams<T extends Box<unknown>> = T extends Box<infer V> ? V extends (...args: infer A) => unknown ? A : [] : [];
+/**
+ * Allows a value with an inner-type to be boxed into a dictionary
+ * so that this type inference is preserved with the help of
+ * [instantiation expressions](https://devblogs.microsoft.com/typescript/announcing-typescript-4-7-beta/#instantiation-expressions).
+ *
+ * NOTE: this feature is immature at best right now
+ */
+export declare function box<T extends Narrowable>(value: T): Box<T>;
+export declare function isBox(thing: Narrowable): thing is Box<unknown>;
+/**
+ * **boxDictionaryValues**(dict)
+ *
+ * Runtime utility which boxes each value in a dictionary
+ */
+export declare function boxDictionaryValues<T extends AnyObject>(dict: T): { [K in keyof T]: Box<T[K]>; };
+export type Unbox<T> = T extends Box<infer U> ? U : T;
+/**
+ * **unbox**(maybeBox)
+ *
+ * Unboxes a value if it was a box; otherwise it leaves _as is_.
+ */
+export declare function unbox<T extends Narrowable>(val: T): Unbox<T>;
+//# sourceMappingURL=box.d.ts.map

package/dist/src/runtime/literals/box.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"box.d.ts","sourceRoot":"","sources":["../../../../src/runtime/literals/box.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,GAAG,EACH,SAAS,EACV,MAAM,WAAW,CAAC;AAGnB,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAElF,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,MAAM,CAAC,CAAC,GACtE,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,OAAO,GACrC,CAAC,GACD,EAAE,GACJ,EAAE,CAAC;AAGP;;;;;;GAMG;AACH,wBAAgB,GAAG,CAAC,CAAC,SAAS,UAAU,EAAE,KAAK,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAU1D;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,CAK9D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,SAAS,EAAE,IAAI,EAAE,CAAC,kCAS/D;AAED,MAAM,MAAM,KAAK,CAAC,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAMtD;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,UAAU,EAAE,GAAG,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAK5D"}

package/dist/src/runtime/literals/box.js

@@ -0,0 +1,44 @@
+/**
+ * Allows a value with an inner-type to be boxed into a dictionary
+ * so that this type inference is preserved with the help of
+ * [instantiation expressions](https://devblogs.microsoft.com/typescript/announcing-typescript-4-7-beta/#instantiation-expressions).
+ *
+ * NOTE: this feature is immature at best right now
+ */
+export function box(value) {
+    const rtn = {
+        __type: "box",
+        value,
+        unbox: ((...p) => {
+            return typeof value === "function" ? value(...p) : value;
+        }),
+    };
+    return rtn;
+}
+export function isBox(thing) {
+    return (
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    typeof thing === "object" && "__type" in thing && thing.__type === "box");
+}
+/**
+ * **boxDictionaryValues**(dict)
+ *
+ * Runtime utility which boxes each value in a dictionary
+ */
+export function boxDictionaryValues(dict) {
+    const keys = Object.keys(dict);
+    return keys.reduce((acc, key) => ({ ...acc, [key]: box(dict[key]) }), {});
+}
+//TODO: it would make sense in the future to use `b.unbox` instead
+// of `b.value` to keep consistent but currently value behaves more
+// consistently and with somewhat stronger typing
+/**
+ * **unbox**(maybeBox)
+ *
+ * Unboxes a value if it was a box; otherwise it leaves _as is_.
+ */
+export function unbox(val) {
+    return (isBox(val)
+        ? val.value
+        : val);
+}

package/dist/src/runtime/literals/capitalize.d.ts

@@ -0,0 +1,8 @@
+/**
+ * **capitalize**()
+ *
+ * Run time utility which _un_-capitalizes a word/string and preserves
+ * string literal types.
+ */
+export declare function capitalize<T extends string>(str: T): Capitalize<T>;
+//# sourceMappingURL=capitalize.d.ts.map

package/dist/src/runtime/literals/capitalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capitalize.d.ts","sourceRoot":"","sources":["../../../../src/runtime/literals/capitalize.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAElE"}

package/dist/src/runtime/literals/capitalize.js

@@ -0,0 +1,9 @@
+/**
+ * **capitalize**()
+ *
+ * Run time utility which _un_-capitalizes a word/string and preserves
+ * string literal types.
+ */
+export function capitalize(str) {
+    return `${str?.slice(0, 1).toUpperCase()}${str?.slice(1)}`;
+}

package/dist/src/runtime/literals/ensureLeading.d.ts

@@ -0,0 +1,9 @@
+import { EnsureLeading } from "src/types";
+/**
+ * **ensureLeading**(content, strip)
+ *
+ * Runtime utility which ensures that last part of a string -- `content` -- has the
+ * substring `ensure` at the end and adds it if not present.
+ */
+export declare function ensureLeading<T extends string | number, U extends string>(content: T, ensure: U): EnsureLeading<T, U>;
+//# sourceMappingURL=ensureLeading.d.ts.map

package/dist/src/runtime/literals/ensureLeading.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensureLeading.d.ts","sourceRoot":"","sources":["../../../../src/runtime/literals/ensureLeading.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAY,MAAM,WAAW,CAAC;AAEpD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,CAAC,SAAS,MAAM,EACvE,OAAO,EAAE,CAAC,EACV,MAAM,EAAE,CAAC,GACR,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAMrB"}

package/dist/src/runtime/literals/ensureLeading.js

@@ -0,0 +1,11 @@
+/**
+ * **ensureLeading**(content, strip)
+ *
+ * Runtime utility which ensures that last part of a string -- `content` -- has the
+ * substring `ensure` at the end and adds it if not present.
+ */
+export function ensureLeading(content, ensure) {
+    return (String(content).startsWith(ensure)
+        ? content
+        : `${ensure}${content}`);
+}

package/dist/src/runtime/literals/ensureTrailing.d.ts

@@ -0,0 +1,9 @@
+import { EnsureTrailing } from "src/types";
+/**
+ * **ensureTrailing**(content, strip)
+ *
+ * Runtime utility which ensures that last part of a string -- `content` -- has the
+ * substring `ensure` at the end and adds it if not present.
+ */
+export declare function ensureTrailing<T extends string, U extends string>(content: T, ensure: U): EnsureTrailing<T, U>;
+//# sourceMappingURL=ensureTrailing.d.ts.map

package/dist/src/runtime/literals/ensureTrailing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensureTrailing.d.ts","sourceRoot":"","sources":["../../../../src/runtime/literals/ensureTrailing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE3C;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,EAC/D,OAAO,EAAE,CAAC,EACV,MAAM,EAAE,CAAC,GACR,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,CAKtB"}

package/dist/src/runtime/literals/ensureTrailing.js

@@ -0,0 +1,11 @@
+/**
+ * **ensureTrailing**(content, strip)
+ *
+ * Runtime utility which ensures that last part of a string -- `content` -- has the
+ * substring `ensure` at the end and adds it if not present.
+ */
+export function ensureTrailing(content, ensure) {
+    return (
+    //
+    (content.endsWith(ensure) ? content : `${content}${ensure}`));
+}

package/dist/src/runtime/literals/identity.d.ts

@@ -0,0 +1,6 @@
+/**
+ * An identity function for any type, with the goal of preserving literal type information
+ * where ever possible.
+ */
+export declare const identity: <T>(v: T) => T;
+//# sourceMappingURL=identity.d.ts.map

package/dist/src/runtime/literals/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../../../src/runtime/literals/identity.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,eAAO,MAAM,QAAQ,gBAIf,CAAC"}

package/dist/src/runtime/literals/identity.js

@@ -0,0 +1,5 @@
+/**
+ * An identity function for any type, with the goal of preserving literal type information
+ * where ever possible.
+ */
+export const identity = (v) => v;

package/dist/src/runtime/literals/ifLowercase.d.ts

@@ -0,0 +1,15 @@
+import { AfterFirst, IfExtends, LowerAlphaChar } from "src/types";
+type _Index<T extends readonly string[], IF, ELSE, Results extends readonly unknown[] = []> = [] extends T ? Results : _Index<AfterFirst<T>, IF, ELSE, [
+    ...Results,
+    IfExtends<T, LowerAlphaChar, IF, ELSE>
+]>;
+type Returns<T extends string | readonly string[], IF, ELSE> = T extends string ? IfExtends<T, LowerAlphaChar, IF, ELSE> : T extends readonly string[] ? _Index<T, IF, ELSE> : never;
+/**
+ * **ifLowercaseChar**(ch)
+ *
+ * Tests whether a passed in character is lowercase and then uses the appropriate callback to
+ * mutate the value.
+ */
+export declare function ifLowercaseChar<T extends string, IF, ELSE>(ch: T, callbackForMatch: <V extends T>(v: V) => IF, callbackForNoMatch: <V extends T>(v: V) => ELSE): Returns<T, IF, ELSE>;
+export {};
+//# sourceMappingURL=ifLowercase.d.ts.map

package/dist/src/runtime/literals/ifLowercase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ifLowercase.d.ts","sourceRoot":"","sources":["../../../../src/runtime/literals/ifLowercase.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAGlE,KAAK,MAAM,CACT,CAAC,SAAS,SAAS,MAAM,EAAE,EAC3B,EAAE,EACF,IAAI,EACJ,OAAO,SAAS,SAAS,OAAO,EAAE,GAAG,EAAE,IACrC,EAAE,SAAS,CAAC,GACZ,OAAO,GACP,MAAM,CACJ,UAAU,CAAC,CAAC,CAAC,EACb,EAAE,EACF,IAAI,EACJ;IACE,GAAG,OAAO;IACV,SAAS,CAAC,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,IAAI,CAAC;CACvC,CACF,CAAC;AAEN,KAAK,OAAO,CACV,CAAC,SAAS,MAAM,GAAG,SAAS,MAAM,EAAE,EACpC,EAAE,EACF,IAAI,IACF,CAAC,SAAS,MAAM,GAChB,SAAS,CAAC,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,IAAI,CAAC,GACtC,CAAC,SAAS,SAAS,MAAM,EAAE,GACzB,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,GACnB,KAAK,CAAC;AAGZ;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,CAAC,SAAS,MAAM,EAChB,EAAE,EACF,IAAI,EAEJ,EAAE,EAAE,CAAC,EACL,gBAAgB,EAAE,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,EAC3C,kBAAkB,EAAE,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,GAC5C,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,CAStB"}

package/dist/src/runtime/literals/ifLowercase.js

@@ -0,0 +1,16 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+import { LOWER_ALPHA_CHARS } from "src/constants";
+/**
+ * **ifLowercaseChar**(ch)
+ *
+ * Tests whether a passed in character is lowercase and then uses the appropriate callback to
+ * mutate the value.
+ */
+export function ifLowercaseChar(ch, callbackForMatch, callbackForNoMatch) {
+    if (ch.length !== 1) {
+        throw new Error(`call to ifUppercaseChar received ${ch.length} characters but is only valid when one character is passed in!`);
+    }
+    return (LOWER_ALPHA_CHARS.includes(ch)
+        ? callbackForMatch(ch)
+        : callbackForNoMatch(ch));
+}

package/dist/src/runtime/literals/ifUppercase.d.ts

@@ -0,0 +1,15 @@
+import { IfChar, IfExtends, Narrowable, UpperAlphaChar, ValueCallback } from "src/types";
+type Convert<T, IF, ELSE> = IfExtends<T, UpperAlphaChar, IF, ELSE>;
+/**
+ * **ifUppercaseChar**(ch, callbackForMatch, callbackForNoMatch)
+ *
+ * Tests whether a passed in _character_ is an uppercase character and uses appropriate callback to
+ * mutate the value.
+ *
+ * **Related:** `ifUppercase()`
+ */
+export declare function ifUppercaseChar<T extends string, IF extends Narrowable, ELSE extends Narrowable>(
+/** the character to be tested */
+ch: T & IfChar<T>, callbackForMatch: ValueCallback<T, IF>, callbackForNoMatch: ValueCallback<T, ELSE>): Convert<T, IF, ELSE>;
+export {};
+//# sourceMappingURL=ifUppercase.d.ts.map

package/dist/src/runtime/literals/ifUppercase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ifUppercase.d.ts","sourceRoot":"","sources":["../../../../src/runtime/literals/ifUppercase.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAEzF,KAAK,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,IAAI,SAAS,CAAC,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;AAEnE;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,CAAC,SAAS,MAAM,EAChB,EAAE,SAAS,UAAU,EACrB,IAAI,SAAS,UAAU;AAEvB,iCAAiC;AACjC,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,EACjB,gBAAgB,EAAE,aAAa,CAAC,CAAC,EAAE,EAAE,CAAC,EACtC,kBAAkB,EAAE,aAAa,CAAC,CAAC,EAAE,IAAI,CAAC,GACzC,OAAO,CAAC,CAAC,EAAC,EAAE,EAAC,IAAI,CAAC,CASpB"}

package/dist/src/runtime/literals/ifUppercase.js

@@ -0,0 +1,20 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+import { LOWER_ALPHA_CHARS } from "src/constants";
+/**
+ * **ifUppercaseChar**(ch, callbackForMatch, callbackForNoMatch)
+ *
+ * Tests whether a passed in _character_ is an uppercase character and uses appropriate callback to
+ * mutate the value.
+ *
+ * **Related:** `ifUppercase()`
+ */
+export function ifUppercaseChar(
+/** the character to be tested */
+ch, callbackForMatch, callbackForNoMatch) {
+    if (ch.length !== 1) {
+        throw new Error(`Invalid string length passed to ifUppercaseChar(ch); this function requires a single character but ${ch.length} were received`);
+    }
+    return (LOWER_ALPHA_CHARS.includes(ch)
+        ? callbackForMatch(ch)
+        : callbackForNoMatch(ch));
+}

package/dist/src/runtime/literals/index.d.ts

@@ -0,0 +1,31 @@
+export * from "./box";
+export * from "./identity";
+export * from "./literal";
+export * from "./stripTrailing";
+export * from "./stripLeading";
+export * from "./ensureTrailing";
+export * from "./ensureLeading";
+export * from "./ifUppercase";
+export * from "./pathJoin";
+export * from "./narrow";
+export * from "./split";
+export * from "./tuple";
+export * from "./capitalize";
+export * from "./uncapitalize";
+export * from "./uppercase";
+export * from "./lowercase";
+export * from "./widen";
+export * from "./toCamelCase";
+export * from "./toKebabCase";
+export * from "./ifLowercase";
+export * from "./toSnakeCase";
+export * from "./toString";
+export * from "./pluralize";
+export * from "./retainAfter";
+export * from "./surround";
+export * from "./stripAfter";
+export * from "./trim";
+export * from "./toPascalCase";
+export * from "./toUppercase";
+export * from "./toNumericArray";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/runtime/literals/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/runtime/literals/index.ts"],"names":[],"mappings":"AAMA,cAAc,OAAO,CAAC;AACtB,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AACvB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC"}

package/dist/src/runtime/literals/index.js

@@ -0,0 +1,38 @@
+// #autoindex
+// #region auto-indexed files
+// index last changed at: 8th Aug, 2022, 09:51 AM ( GMT-7 )
+// hash-code: 7a22bbbc
+// file exports
+export * from "./box";
+export * from "./identity";
+export * from "./literal";
+export * from "./stripTrailing";
+export * from "./stripLeading";
+export * from "./ensureTrailing";
+export * from "./ensureLeading";
+export * from "./ifUppercase";
+export * from "./pathJoin";
+export * from "./narrow";
+export * from "./split";
+export * from "./tuple";
+export * from "./capitalize";
+export * from "./uncapitalize";
+export * from "./uppercase";
+export * from "./lowercase";
+export * from "./widen";
+export * from "./toCamelCase";
+export * from "./toKebabCase";
+export * from "./ifLowercase";
+export * from "./toSnakeCase";
+export * from "./toString";
+export * from "./pluralize";
+export * from "./retainAfter";
+export * from "./surround";
+export * from "./stripAfter";
+export * from "./trim";
+export * from "./toPascalCase";
+export * from "./toUppercase";
+export * from "./toNumericArray";
+// #endregion auto-indexed files
+// see https://github.com/inocan-group/do-devops/docs/autoindex.md
+// for more info