@oazmi/superbuild 0.1.0

package/esm/deps/jsr.io/@oazmi/kitchensink/0.10.0/src/typedefs.d.ts

@@ -0,0 +1,391 @@
+/** utility typescript type and interface definitions.
+ *
+ * @module
+*/
+/** get the constructor function of type `T` */
+export type ConstructorOf<T, Args extends any[] = any[]> = new (...args: Args) => T;
+/** get the prototype object of a class `CLS` */
+export type PrototypeOf<CLS, Args extends any[] = any[]> = CLS extends {
+    new (...args: any[]): infer U;
+} ? U : never;
+/** turn optional properties `P` of interface `T` into required */
+export type Require<T, P extends keyof T> = Omit<T, P> & Required<Pick<T, P>>;
+/** turn properties `P` of interface `T` into optional */
+export type Optional<T, P extends keyof T> = Omit<T, P> & Partial<Pick<T, P>>;
+/** extract all optional fields from type `T` */
+export type OptionalKeysOf<T> = {
+    [K in keyof T as (undefined extends T[K] ? K : never)]: T[K];
+};
+/** get all non-symbol property keys of a particular type `T`. */
+export type NonSymbolKeys<T> = {
+    [K in keyof T]: K extends symbol ? never : K;
+}[keyof T];
+/** @deprecated
+ * use {@link MembersOf} instead
+*/
+export type ClassFieldsOf<T> = {
+    [K in keyof T as (T[K] extends Function ? never : K)]: T[K];
+};
+/** get all methods of a class-instance */
+export type MethodsOf<T> = {
+    [K in keyof T as (T[K] extends Function ? K : never)]: T[K];
+};
+/** get all functions of a class-instance */
+export type CallableFunctionsOf<T> = {
+    [K in keyof T as (T[K] extends (CallableFunction & ((this: T, ...args: any) => any)) ? K : never)]: T[K];
+};
+/** get all data members (non-methods) of a class-instance */
+export type MembersOf<T> = Omit<T, keyof MethodsOf<T>>;
+/** map each entry (key-value pair) of an object, to a tuple of the key and its corresponding value.
+ *
+ * the output of this type is what the builtin `Object.entries` static method should ideally return if it were typed strictly.
+ *
+ * @example
+ * ```ts
+ * const obj = { kill: "your", self: "ok", tomorrow: 420 } as const
+ * type EntriesOfObj = EntriesOf<typeof obj>
+ * // the IDE will now infer the type to be:
+ * // `type EntriesOfObj = Array<["kill", "your"] | ["self", "ok"] | ["tomorrow", 420]>`
+ * // had we not used the `as const` narrowing utility, the output would've then been:
+ * // `type EntriesOfObj = Array<["kill", string] | ["self", string] | ["tomorrow", number]>`
+ * ```
+*/
+export type EntriesOf<T> = Array<{
+    [K in keyof T]: [key: K, value: T[K]];
+}[keyof T]>;
+/** turn all fields of an object `T` to optional, deeply.
+ *
+ * > [!note]
+ * > we exclude many built-in types and classes so that they are not turned into partial types.
+ * > here is the full list of built-in types and classes (aside from primitives) that are not turned into partial objects:
+ * >
+ * > `Function | Array<any> | Set<any> | Map<any, any> | WeakSet<any> | WeakMap<any, any> | TypedArray | URL | String | BigInt | Number | Boolean | Symbol`
+ *
+ * @example
+ * ```ts
+ * const my_obj = {
+ * 	a: 1,
+ * 	b: { c: 2 },
+ * 	d: { e: { f: 3 }, g: 4 },
+ * 	h: { i: [{ j: 5 }, { k: 6 }] },
+ * 	l: { m: ((arg: string) => "hello") },
+ * 	n: new URL("https://example.com"),
+ * 	o: new Map<string, number>([["a", 1], ["b", 2]]),
+ * } as const
+ *
+ * type DeeplyPartial_my_obj = DeepPartial<typeof my_obj>
+ * type ManuallyConstructed_DeeplyPartial_my_obj = {
+ * 	a?: 1,
+ * 	b?: { c?: 2 },
+ * 	d?: { e?: { f?: 3 }, g?: 4 },
+ * 	h?: { i?: readonly [_0?: { j?: 5 } | undefined, _1?: { k?: 6 } | undefined] },
+ * 	l?: { m?: ((arg: string) => string) },
+ * 	n?: URL,
+ * 	o?: Map<string, number>,
+ * }
+ *
+ * type BothTypesAreEqual_1 = DeeplyPartial_my_obj extends ManuallyConstructed_DeeplyPartial_my_obj ? true : false
+ * type BothTypesAreEqual_2 = ManuallyConstructed_DeeplyPartial_my_obj extends DeeplyPartial_my_obj ? true : false
+ *
+ * const temp: true = true
+ * temp satisfies BothTypesAreEqual_1
+ * temp satisfies BothTypesAreEqual_2
+ * ```
+*/
+export type DeepPartial<T> = T extends (Function | Array<any> | Set<any> | Map<any, any> | WeakSet<any> | WeakMap<any, any> | TypedArray | URL | String | BigInt | Number | Boolean | Symbol) ? T : T extends Record<string, any> ? {
+    [P in keyof T]?: DeepPartial<T[P]>;
+} : T;
+/** turn all fields of an object `T` to required, deeply.
+ *
+ * > [!note]
+ * > we exclude many built-in types and classes so that they are not turned into required types.
+ * > here is the full list of built-in types and classes (aside from primitives) that are not turned into required objects:
+ * >
+ * > `Function | Array<any> | Set<any> | Map<any, any> | WeakSet<any> | WeakMap<any, any> | TypedArray | URL | String | BigInt | Number | Boolean | Symbol`
+ *
+ * @example
+ * ```ts
+ * type MyType = {
+ * 	a?: 1,
+ * 	b: { c?: 2 },
+ * 	d: { e?: { f: 3 }, g?: 4 },
+ * 	h: { i?: [_0?: { j?: 5 } | undefined, _1?: { k?: 6 } | undefined] },
+ * 	l?: { m?: ((arg: string) => string), n: 7 | undefined, o?: 8 | undefined },
+ * }
+ *
+ * type MyType_DeeplyRequired = DeepRequired<MyType>
+ *
+ * type ManuallyConstructed_MyType_DeeplyRequired = DeepRequired<{
+ * 	a: 1,
+ * 	b: { c: 2 },
+ * 	d: { e: { f: 3 }, g: 4 },
+ * 	h: { i: [_0?: { j?: 5 } | undefined, _1?: { k?: 6 } | undefined] },
+ * 	l: { m: ((arg: string) => string), n: 7 | undefined, o: 8 },
+ * }>
+ *
+ * type BothTypesAreEqual_1 = MyType_DeeplyRequired extends ManuallyConstructed_MyType_DeeplyRequired ? true : false
+ * type BothTypesAreEqual_2 = ManuallyConstructed_MyType_DeeplyRequired extends MyType_DeeplyRequired ? true : false
+ *
+ * const temp: true = true
+ * temp satisfies BothTypesAreEqual_1
+ * temp satisfies BothTypesAreEqual_2
+ * ```
+*/
+export type DeepRequired<T> = T extends (Function | Array<any> | Set<any> | Map<any, any> | WeakSet<any> | WeakMap<any, any> | TypedArray | URL | String | BigInt | Number | Boolean | Symbol) ? T : T extends Record<string, any> ? {
+    [P in keyof T]-?: DeepRequired<T[P]>;
+} : T;
+/** get the stringified type name of a type-parameter. */
+export type TypeName<T> = T extends string ? "string" : T extends BigInt ? "bigint" : T extends number ? "number" : T extends boolean ? "boolean" : T extends undefined ? "undefined" : T extends symbol ? "symbol" : T extends Function ? "function" : T extends Array<any> ? "array" : T extends null ? "null" : "object";
+/** add a prefix `PRE` to all property names of object `T` */
+export type PrefixProps<T, PRE extends string> = {
+    [K in keyof T & string as `${PRE}${K}`]: T[K];
+};
+/** add a postfix (suffix) `POST` to all property names of object `T` */
+export type PostfixProps<T, POST extends string> = {
+    [K in keyof T & string as `${K}${POST}`]: T[K];
+};
+/** allows one to declare static interface `CONSTRUCTOR` that must be implemented by a class `CLASS`.
+ *
+ * > [!important]
+ * > your `CONSTRUCTOR` static interface **must** contain a constructor method in it.
+ * > although, that constructor could be super generalized too, despite the other static methods being narrowly defined.
+ * > take the following for instance:
+ *
+ * ```ts
+ * // interface for a class that must implement a static `clone` method, which should return a clone of the provided object `obj`, but omit numeric keys
+ * interface Cloneable {
+ * 	constructor(...args: any[]): any
+ * 	clone<T>(obj: T): Omit<T, number>
+ * }
+ * ```
+ *
+ * to use this utility type, you must provide the static interface as the first parameter,
+ * and then `typeof CLASS_NAME` (which is the name of the class itself) as the second parameter.
+ *
+ * @example
+ * ```ts
+ * interface Stack<T> {
+ * 	push(...items: T[]): void
+ * 	pop(): T | undefined
+ * 	clear(): T[]
+ * }
+ *
+ * interface CloneableStack {
+ * 	new <V>(...args: any[]): Stack<V>
+ * 	// this static method should remove all function objects from the stack
+ * 	clone<T>(original_stack: Stack<T>): Stack<Exclude<T, Function>>
+ * }
+ *
+ * const stack_class_alias = class MyStack<T> implements StaticImplements<CloneableStack, typeof MyStack> {
+ * 	arr: T[]
+ * 	constructor(first_item?: T) {
+ * 		this.arr = first_item === undefined ? [] : [first_item]
+ * 	}
+ *
+ * 	push(...items: T[]): void { this.arr.push(...items) }
+ * 	pop(): T | undefined { return this.arr.pop() }
+ * 	clear(): T[] { return this.arr.splice(0) }
+ *
+ * 	static clone<V>(some_stack: Stack<V>) {
+ * 		const arr_no_func = (some_stack as MyStack<V>).arr.filter((v) => typeof v !== "function") as Array<Exclude<V, Function>>
+ * 		const new_stack = new this<Exclude<V, Function>>()
+ * 		new_stack.push(...arr_no_func)
+ * 		return new_stack
+ * 	}
+ * }
+ * ```
+*/
+export type StaticImplements<CONSTRUCTOR extends new (...args: any[]) => any, CLASS extends CONSTRUCTOR> = InstanceType<CONSTRUCTOR>;
+/** `DecrementNumber[N]` returns `N-1`, for up to `N = 10` */
+export type DecrementNumber = [never, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10];
+/** `IncrementNumber[N]` returns `N+1`, for up to `N = 10` */
+export type IncrementNumber = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10];
+/** repeat a string `S` for up to `N = 10` times */
+export type RepeatString<S extends string, N extends number> = N extends 1 ? S : `${S}${RepeatString<S, DecrementNumber[N]>}`;
+/** create an element-wise intersection between two tuples.
+ *
+ * > [!note]
+ * > the intersection `any & T` typically produces `any`,
+ * but when put through this utility type, it will produce `T` for convenience of usage with function parameters intersection.
+ *
+ * @example
+ * ```ts
+ * type A = TupleIntersect<[number, unknown, string, any], [5, number, string, boolean, 99]>
+ * // A === [5, number, string, boolean]
+ * ```
+*/
+export type TupleIntersect<ARR1 extends any[], ARR2 extends any[], N extends number | never = 0> = N extends number ? IntersectKnown<ARR1[N], ARR2[N]> extends (undefined | never) ? [] : [
+    IntersectKnown<ARR1[N], ARR2[N]>,
+    ...TupleIntersect<ARR1, ARR2, IncrementNumber[N]>
+] : [];
+/** create an element-wise intersection between two tuples. note that the intersection `any & T` does not produce `T` for some reason unfortunately.
+ * @example
+ * ```ts
+ * type A = TupleUnion<[number, unknown, string, boolean], [5, number, string, any, 99]>
+ * // A === [number, number, string, boolean>, undefined | 99]
+ * ```
+*/
+export type TupleUnion<ARR1 extends any[], ARR2 extends any[], N extends number | never = 0> = N extends number ? UnionKnown<ARR1[N], ARR2[N]> extends (undefined | never) ? [] : [
+    UnionKnown<ARR1[N], ARR2[N]>,
+    ...TupleUnion<ARR1, ARR2, IncrementNumber[N]>
+] : [];
+/** perform a union between two types, making sure that if either is `unknown`, then it'll be treated as `never`.
+ *
+ * why is this useful? because in typescript's `unknown` is a supertype of all types (similar to `any`), which means that something like `T | unknown = unknown`.
+ * thus, in a scenario where such a behavior is not desired, you can use this utility type: `UnionKnown<T, unknown> = T`
+*/
+export type UnionKnown<A, B> = (unknown extends A ? B : A) | (unknown extends B ? A : B);
+/** perform an intersection between two types, making sure that if either is `unknown` or `any`, then it'll be ignored, and only the known type will persevere.
+ *
+ * why is this useful? because in typescript's `any` is a subtype of all types, which means that something like `T & any = any` (strangely unintuitive).
+ * thus, in a scenario where such a behavior is not desired, you can use this utility type: `UnionKnown<T, any> = T`
+*/
+export type IntersectKnown<A, B> = (unknown extends A ? B : A) & (unknown extends B ? A : B);
+/** an array of type `T`, and fixed length `L`.
+ *
+ * this technique was copied from [stackexchange, user "mstephen19"](https://stackoverflow.com/a/73384647).
+ *
+ * the generic `R` type parameter is for recursion, and not intended for external use.
+*/
+export type ArrayFixedLength<T, L extends number, R extends T[] = []> = R["length"] extends L ? R : ArrayFixedLength<T, L, [...R, T]>;
+/** represents a scalar mathematical function of `ParamLength` number of input parameters (or variables).
+ *
+ * for instance, a scalar addition function is merely a mapping from domains:
+ * $X,Y \in \R$ to $Z \in \R$: $\text{Add} : X \times Y \rightarrow Z$ .
+ *
+ * ```ts
+ * const add_func: NumericMapFunc<2> = (x, y) => x + y
+ * ```
+*/
+export type NumericMapFunc<ParamLength extends number> = (...params: ArrayFixedLength<number, ParamLength>) => number;
+/** represents a higher-order scalar function of `ParamLength` number of array input parameters, which are then manipulated based on index `i`, for all possible `i`.
+ *
+ * for instance, to model an array addition function, you would simply do:
+ *
+ * ```ts
+ * const add_hof: IndexNumericMapFunc<2> = (arrX, arrY) => (i) => arrX[i] + arrY[i]
+ * ```
+*/
+export type IndexNumericMapFunc<ParamLength extends number> = (...params: ArrayFixedLength<NumericArray, ParamLength>) => (i: number) => number;
+/** unsigned integer, signed integer, or IEEE-754 float */
+export type NumericFormatType = "u" | "i" | "f";
+/** little-endian, big-endian, clamped 1-byte, or 1-byte */
+export type NumericEndianType = "l" | "b";
+/** specify 1-byte, 2-bytes, 4-bytes, or 8-bytes of numeric data*/
+export type DByteSize = "1" | "2" | "4" | "8";
+/** indicates the name of a numeric type.
+ *
+ * the collection of possible valid numeric types is:
+ * - `"u1"`, `"u2"`, `"u4"`, `"u8"`, `"i1"`, `"i2"`, `"i4"`, `"i8"`, `"f4"`, `"f8"`, `"u1c"`
+ *
+ * the first character specifies the format:
+ * - `u` = unsigned integer
+ * - `i` = signed integer
+ * - `f` = float IEEE-754
+ *
+ * the second character specifies the byte-size:
+ * - `1` = one byte
+ * - `2` = two bytes (short)
+ * - `4` = four bytes (word)
+ * - `8` = eight bytes (long)
+*/
+export type NumericDType = Exclude<`${NumericFormatType}${DByteSize}` | "u1c", "f1" | "f2" | "u8" | "i8">;
+/** abstract constructor of any typed array, such as `new Uint8Array(...)`
+ * you can narrow down the constructor through the use of a  {@link NumericDType} string annotation
+ * @example
+ * ```ts
+ * const clamp_arr_constructor: TypedArrayConstructor<"u1c"> = Uint8ClampedArray
+ * ```
+*/
+export type TypedArrayConstructor<DType extends NumericDType = NumericDType> = {
+    "u1": Uint8ArrayConstructor;
+    "u1c": Uint8ClampedArrayConstructor;
+    "u2": Uint16ArrayConstructor;
+    "u4": Uint32ArrayConstructor;
+    "i1": Int8ArrayConstructor;
+    "i2": Int16ArrayConstructor;
+    "i4": Int32ArrayConstructor;
+    "f4": Float32ArrayConstructor;
+    "f8": Float64ArrayConstructor;
+}[DType];
+/** an instance of any typed array, such as `Uint8Array`
+ * you can narrow down the type through the use of a  {@link NumericDType} string annotation
+ * @example
+ * ```ts
+ * const clammped_bytes_arr: TypedArray<"u1c"> = new Uint8ClampedArray(42)
+ * ```
+*/
+export type TypedArray<DType extends NumericDType = NumericDType> = {
+    "u1": Uint8Array;
+    "u1c": Uint8ClampedArray;
+    "u2": Uint16Array;
+    "u4": Uint32Array;
+    "i1": Int8Array;
+    "i2": Int16Array;
+    "i4": Int32Array;
+    "f4": Float32Array;
+    "f8": Float64Array;
+}[DType];
+/** any numeric array */
+export type NumericArray = TypedArray | Array<number>;
+/** indicates the name of a numeric type with required endian information, or the use of a variable-sized integer.
+ *
+ * the collection of possible valid numeric types is:
+ * - `"u1"`, `"i1"`, `"u2l"`, `"u2b"`, `"i2l"`, `"i2b"`, `"u4l"`, `"u4b"`, `"u8l"`, `"u8b"`, `"i4l"`, `"i4b"`, `"i8l"`, `"i8b"`, `"f4l"`, `"f4b"`, `"f8l"`, `"f8b"`, `"u1c"`,
+ *
+ * the first character specifies the format:
+ * - `u` = unsigned integer
+ * - `i` = signed integer
+ * - `f` = float IEEE-754
+ *
+ * the second character specifies the byte-size:
+ * - `1` = one byte
+ * - `2` = two bytes (short)
+ * - `4` = four bytes (word)
+ * - `8` = eight bytes (long)
+ *
+ * the third character specifies the endianness. but in the case of unsigned one byte integers, the `c` character specifies if the value is clamped to 255:
+ * - `l` = little endian
+ * - `b` = big endian
+ * - `c` = clamped (only valid for `"u1c"` type)
+ *
+ * for variable byte sized numbers, use {@link VarNumericType}.
+*/
+export type NumericType = Exclude<`${NumericDType}${NumericEndianType}` | "u1" | "u1c" | "i1", `${"u1" | "u1c" | "i1"}${NumericEndianType}`>;
+/** an array (regular javascript array) of numbers can be interpreted as an array of formatted binary numbers. */
+export type NumericArrayType = `${NumericType}[]`;
+/** indicates either a variable bytes sized unsigned or signed integer. see [wikipedia](https://en.wikipedia.org/wiki/Variable-length_quantity) to understand how they're represented in binary. */
+export type VarNumericType = "uv" | "iv";
+/** numeric array version of {@link VarNumericType}. */
+export type VarNumericArrayType = `${VarNumericType}[]`;
+/** a float number in the range `0.0` to `1.0` (inclusive) */
+export type UnitInterval = number;
+export declare const isUnitInterval: (value: number) => value is UnitInterval;
+/** an integer number in the range `0` to `255` (inclusive) */
+export type UByte = number;
+export declare const isUByte: (value: number) => value is UByte;
+/** a float number in the range `0` to `360` (inclusive), indicating the degree rotation angle. */
+export type Degrees = number;
+export declare const isDegrees: (value: number) => value is Degrees;
+/** a float number in the range `0` to `pi` (inclusive), indicating the radian rotation angle. */
+export type Radians = number;
+export declare const isRadians: (value: number) => value is Radians;
+/** represents either a regular 2d html canvas context, or an offscreen 2d canvas's context. */
+export type Ctx2D = CanvasRenderingContext2D | OffscreenCanvasRenderingContext2D;
+/** represents either a regular value `T` or a `Promise` thereof. */
+export type MaybePromise<T> = T | Promise<T>;
+/** represents either a regular value `T` or a `PromiseLike` thereof. */
+export type MaybePromiseLike<T> = T | PromiseLike<T>;
+/** the type definition of a `Promise` resolver function. */
+export type PromiseResolver<T> = ((value: T | PromiseLike<T>) => void);
+/** the type definition of a `Promise` rejector function. */
+export type PromiseRejector<T> = ((reason?: any) => void);
+/** represents a typical javasctipt object, something that pairs `keys` with `values` */
+export type Obj = {
+    [key: PropertyKey]: any;
+};
+/** represents an empty javasctipt object */
+export type EmptyObj = {
+    [key: PropertyKey]: never;
+};
+//# sourceMappingURL=typedefs.d.ts.map

package/esm/deps/jsr.io/@oazmi/kitchensink/0.10.0/src/typedefs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typedefs.d.ts","sourceRoot":"","sources":["../../../../../../../src/deps/jsr.io/@oazmi/kitchensink/0.10.0/src/typedefs.ts"],"names":[],"mappings":"AAAA;;;EAGE;AAIF,+CAA+C;AAC/C,MAAM,MAAM,aAAa,CAAC,CAAC,EAAE,IAAI,SAAS,GAAG,EAAE,GAAG,GAAG,EAAE,IAAI,KAAK,GAAG,IAAI,EAAE,IAAI,KAAK,CAAC,CAAA;AAEnF,gDAAgD;AAChD,MAAM,MAAM,WAAW,CAAC,GAAG,EAAE,IAAI,SAAS,GAAG,EAAE,GAAG,GAAG,EAAE,IAAI,GAAG,SAAS;IAAE,KAAI,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC,CAAA;CAAE,GAAG,CAAC,GAAG,KAAK,CAAA;AAEnH,kEAAkE;AAClE,MAAM,MAAM,OAAO,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;AAG7E,yDAAyD;AACzD,MAAM,MAAM,QAAQ,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;AAE7E,gDAAgD;AAChD,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,CAAA;AAEhG,iEAAiE;AACjE,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,SAAS,MAAM,GAAG,KAAK,GAAG,CAAC;CAAE,CAAC,MAAM,CAAC,CAAC,CAAA;AAExF;;EAEE;AACF,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,QAAQ,GAAG,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,CAAA;AAE9F,0CAA0C;AAC1C,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,QAAQ,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,CAAA;AAE1F,4CAA4C;AAC5C,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,gBAAgB,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,CAAA;AAEjJ,6DAA6D;AAC7D,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,MAAM,SAAS,CAAC,CAAC,CAAC,CAAC,CAAA;AAEtD;;;;;;;;;;;;;EAaE;AACF,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,KAAK,CAAC;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;AAEpF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsCE;AACF,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,CACpC,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,GACnF,UAAU,GAAG,GAAG,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAChE,GACE,CAAC,GAAG,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACjC;KAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GAAG,CAAC,CAAA;AAE7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmCE;AACF,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,SAAS,CACrC,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,GACnF,UAAU,GAAG,GAAG,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAChE,GACE,CAAC,GAAG,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACjC;KAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GAAG,CAAC,CAAA;AAE/C,yDAAyD;AACzD,MAAM,MAAM,QAAQ,CAAC,CAAC,IACrB,CAAC,SAAS,MAAM,GAAG,QAAQ,GAC3B,CAAC,SAAS,MAAM,GAAG,QAAQ,GAC3B,CAAC,SAAS,MAAM,GAAG,QAAQ,GAC3B,CAAC,SAAS,OAAO,GAAG,SAAS,GAC7B,CAAC,SAAS,SAAS,GAAG,WAAW,GACjC,CAAC,SAAS,MAAM,GAAG,QAAQ,GAC3B,CAAC,SAAS,QAAQ,GAAG,UAAU,GAC/B,CAAC,SAAS,KAAK,CAAC,GAAG,CAAC,GAAG,OAAO,GAC9B,CAAC,SAAS,IAAI,GAAG,MAAM,GACvB,QAAQ,CAAA;AAET,6DAA6D;AAC7D,MAAM,MAAM,WAAW,CAAC,CAAC,EAAE,GAAG,SAAS,MAAM,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM,IAAI,GAAG,GAAG,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,CAAA;AAElG,wEAAwE;AACxE,MAAM,MAAM,YAAY,CAAC,CAAC,EAAE,IAAI,SAAS,MAAM,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,CAAA;AAErG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkDE;AACF,MAAM,MAAM,gBAAgB,CAAC,WAAW,SAAS,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,KAAK,SAAS,WAAW,IAAI,YAAY,CAAC,WAAW,CAAC,CAAA;AAEpI,6DAA6D;AAC7D,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAA;AAEvE,6DAA6D;AAC7D,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAA;AAE7D,mDAAmD;AACnD,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,YAAY,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;AAE7H;;;;;;;;;;;EAWE;AACF,MAAM,MAAM,cAAc,CACzB,IAAI,SAAS,GAAG,EAAE,EAClB,IAAI,SAAS,GAAG,EAAE,EAClB,CAAC,SAAS,MAAM,GAAG,KAAK,GAAG,CAAC,IACzB,CAAC,SAAS,MAAM,GACnB,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,GAAG,KAAK,CAAC,GAAG,EAAE,GACjE;IAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAAE,GAAG,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;CAAC,GAAG,EAAE,CAAA;AAE3F;;;;;;EAME;AACF,MAAM,MAAM,UAAU,CACrB,IAAI,SAAS,GAAG,EAAE,EAClB,IAAI,SAAS,GAAG,EAAE,EAClB,CAAC,SAAS,MAAM,GAAG,KAAK,GAAG,CAAC,IACzB,CAAC,SAAS,MAAM,GACnB,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,GAAG,KAAK,CAAC,GAAG,EAAE,GAC7D;IAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAAE,GAAG,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC;CAAC,GAAG,EAAE,CAAA;AAEnF;;;;EAIE;AACF,MAAM,MAAM,UAAU,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,OAAO,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAA;AAExF;;;;EAIE;AACF,MAAM,MAAM,cAAc,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,OAAO,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAA;AAE5F;;;;;EAKE;AACF,MAAM,MAAM,gBAAgB,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,gBAAgB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;AAErI;;;;;;;;EAQE;AACF,MAAM,MAAM,cAAc,CAAC,WAAW,SAAS,MAAM,IAAI,CAAC,GAAG,MAAM,EAAE,gBAAgB,CAAC,MAAM,EAAE,WAAW,CAAC,KAAK,MAAM,CAAA;AAErH;;;;;;;EAOE;AACF,MAAM,MAAM,mBAAmB,CAAC,WAAW,SAAS,MAAM,IAAI,CAAC,GAAG,MAAM,EAAE,gBAAgB,CAAC,YAAY,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAA;AAI/I,0DAA0D;AAC1D,MAAM,MAAM,iBAAiB,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAA;AAE/C,2DAA2D;AAC3D,MAAM,MAAM,iBAAiB,GAAG,GAAG,GAAG,GAAG,CAAA;AAEzC,kEAAkE;AAClE,MAAM,MAAM,SAAS,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAA;AAE7C;;;;;;;;;;;;;;;EAeE;AACF,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,iBAAiB,GAAG,SAAS,EAAE,GAAG,KAAK,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,CAAA;AAEzG;;;;;;EAME;AACF,MAAM,MAAM,qBAAqB,CAAC,KAAK,SAAS,YAAY,GAAG,YAAY,IAAI;IAC9E,IAAI,EAAE,qBAAqB,CAAA;IAC3B,KAAK,EAAE,4BAA4B,CAAA;IACnC,IAAI,EAAE,sBAAsB,CAAA;IAC5B,IAAI,EAAE,sBAAsB,CAAA;IAE5B,IAAI,EAAE,oBAAoB,CAAA;IAC1B,IAAI,EAAE,qBAAqB,CAAA;IAC3B,IAAI,EAAE,qBAAqB,CAAA;IAE3B,IAAI,EAAE,uBAAuB,CAAA;IAC7B,IAAI,EAAE,uBAAuB,CAAA;CAC7B,CAAC,KAAK,CAAC,CAAA;AAER;;;;;;EAME;AACF,MAAM,MAAM,UAAU,CAAC,KAAK,SAAS,YAAY,GAAG,YAAY,IAAI;IACnE,IAAI,EAAE,UAAU,CAAA;IAChB,KAAK,EAAE,iBAAiB,CAAA;IACxB,IAAI,EAAE,WAAW,CAAA;IACjB,IAAI,EAAE,WAAW,CAAA;IAEjB,IAAI,EAAE,SAAS,CAAA;IACf,IAAI,EAAE,UAAU,CAAA;IAChB,IAAI,EAAE,UAAU,CAAA;IAEhB,IAAI,EAAE,YAAY,CAAA;IAClB,IAAI,EAAE,YAAY,CAAA;CAClB,CAAC,KAAK,CAAC,CAAA;AAER,wBAAwB;AACxB,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAA;AAErD;;;;;;;;;;;;;;;;;;;;;;EAsBE;AACF,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,YAAY,GAAG,iBAAiB,EAAE,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,EAAE,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,iBAAiB,EAAE,CAAC,CAAA;AAE5I,iHAAiH;AACjH,MAAM,MAAM,gBAAgB,GAAG,GAAG,WAAW,IAAI,CAAA;AAEjD,mMAAmM;AACnM,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,IAAI,CAAA;AAExC,uDAAuD;AACvD,MAAM,MAAM,mBAAmB,GAAG,GAAG,cAAc,IAAI,CAAA;AAIvD,6DAA6D;AAC7D,MAAM,MAAM,YAAY,GAAG,MAAM,CAAA;AACjC,eAAO,MAAM,cAAc,UAAW,MAAM,KAAG,KAAK,IAAI,YAAuD,CAAA;AAE/G,8DAA8D;AAC9D,MAAM,MAAM,KAAK,GAAG,MAAM,CAAA;AAC1B,eAAO,MAAM,OAAO,UAAW,MAAM,KAAG,KAAK,IAAI,KAA2E,CAAA;AAE5H,kGAAkG;AAClG,MAAM,MAAM,OAAO,GAAG,MAAM,CAAA;AAC5B,eAAO,MAAM,SAAS,UAAW,MAAM,KAAG,KAAK,IAAI,OAAoD,CAAA;AAEvG,iGAAiG;AACjG,MAAM,MAAM,OAAO,GAAG,MAAM,CAAA;AAC5B,eAAO,MAAM,SAAS,UAAW,MAAM,KAAG,KAAK,IAAI,OAAwD,CAAA;AAO3G,+FAA+F;AAC/F,MAAM,MAAM,KAAK,GAAG,wBAAwB,GAAG,iCAAiC,CAAA;AAEhF,oEAAoE;AACpE,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;AAE5C,wEAAwE;AACxE,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAA;AAEpD,4DAA4D;AAC5D,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAA;AAEtE,4DAA4D;AAC5D,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC,CAAA;AAEzD,wFAAwF;AACxF,MAAM,MAAM,GAAG,GAAG;IAAE,CAAC,GAAG,EAAE,WAAW,GAAG,GAAG,CAAA;CAAE,CAAA;AAE7C,4CAA4C;AAC5C,MAAM,MAAM,QAAQ,GAAG;IAAE,CAAC,GAAG,EAAE,WAAW,GAAG,KAAK,CAAA;CAAE,CAAA"}

package/esm/deps/jsr.io/@oazmi/kitchensink/0.10.0/src/typedefs.js

@@ -0,0 +1,8 @@
+/** utility typescript type and interface definitions.
+ *
+ * @module
+*/
+export const isUnitInterval = (value) => value >= 0 && value <= 1 ? true : false;
+export const isUByte = (value) => value >= 0 && value <= 255 && value === (value | 0) ? true : false;
+export const isDegrees = (value) => value >= 0 && value <= 360 ? true : false;
+export const isRadians = (value) => value >= 0 && value <= Math.PI ? true : false;

package/esm/deps.d.ts

@@ -0,0 +1,56 @@
+import type { MaybePromise } from "./deps/jsr.io/@oazmi/kitchensink/0.10.0/src/typedefs.js";
+export type * as esbuild from "./deps/jsr.io/@oazmi/esbuild-types/0.28.0/src/mod.js";
+export { array_isEmpty, console_log, date_now, dom_clearTimeout, dom_setTimeout, json_stringify, math_max, object_assign, object_entries, object_fromEntries, object_keys, promise_all, promise_outside } from "./deps/jsr.io/@oazmi/kitchensink/0.10.0/src/alias.js";
+export { bind_array_push } from "./deps/jsr.io/@oazmi/kitchensink/0.10.0/src/binder.js";
+export { ensureFile, getRuntimeCwd, identifyCurrentRuntime, statEntry, writeFile } from "./deps/jsr.io/@oazmi/kitchensink/0.10.0/src/crossenv.js";
+export { crc32 } from "./deps/jsr.io/@oazmi/kitchensink/0.10.0/src/cryptoman.js";
+export { ensureEndSlash, ensureFileUrlIsLocalPath, ensureStartDotSlash, fileUrlToLocalPath, getUriScheme, isAbsolutePath, parseFilepathInfo, pathToPosixPath, relativePath, resolveAsUrl, resolvePathFactory } from "./deps/jsr.io/@oazmi/kitchensink/0.10.0/src/pathman.js";
+export { promiseOutside, promiseTimeout } from "./deps/jsr.io/@oazmi/kitchensink/0.10.0/src/promiseman.js";
+export { escapeLiteralStringForRegex } from "./deps/jsr.io/@oazmi/kitchensink/0.10.0/src/stringman.js";
+export { isArray, isFunction, isRecord, isString } from "./deps/jsr.io/@oazmi/kitchensink/0.10.0/src/struct.js";
+export type { MaybePromise, MaybePromiseLike, Optional, Require } from "./deps/jsr.io/@oazmi/kitchensink/0.10.0/src/typedefs.js";
+/** flags used for minifying (or eliminating) debugging logs and asserts, when an intelligent bundler, such as `esbuild`, is used. */
+export declare const enum DEBUG {
+    LOG = 1,
+    ASSERT = 1,
+    ERROR = 1,
+    PRODUCTION = 1,
+    MINIFY = 0
+}
+/** check if `obj` is either `null` or `undefined`. */
+export declare const isNull: (obj: any) => obj is (null | undefined);
+export declare const noop: () => undefined;
+export declare const urlToString: (url: string | URL) => string;
+export declare const ensureRelativeDotSlash: (str: string) => string;
+export declare const textEncoder: TextEncoder, textDecoder: TextDecoder;
+/** this utility type lets makes your typescript LSP auto-suggest literals defined in the input generic type `T`,
+ * while also permitting arbitrary strings to be used.
+ *
+ * TODO: add this utility type to kitchensink.
+ *
+ * @example
+ * ```ts
+ * type InstallationPath = AutoSuggestOrString<0 | undefined | "$CWD" | "C-DRIVE" | "$ROOT">
+ *
+ * const installProgram = async (installation_path: InstallationPath) => {
+ * 	const abs_path = installation_path === undefined ? ""
+ * 		: installation_path === "$CWD" ? Deno.cwd()   // LSP will suggest `0 | "$CWD" | "C-DRIVE" | "$ROOT"`.
+ * 			: installation_path === "C-DRIVE" ? "C:/" // LSP will suggest `0 | "C-DRIVE" | "$ROOT"`.
+ * 				: installation_path === "$ROOT" ? "/" // LSP will suggest `0 | "$ROOT"`.
+ * 					: installation_path === 0 ? ""    // LSP will suggest `0`.
+ * 						: installation_path satisfies string // `(string & {})` is still a valid string.
+ * 	// perform installation
+ * }
+ *
+ * await installProgram("$CWD")             // valid, and LSP will suggest the default options first.
+ * await installProgram(undefined)          // valid.
+ * await installProgram(0)                  // valid.
+ * await installProgram("/etc/hello/world") // also valid.
+ * ```
+*/
+export type AutoSuggestOrString<T> = T | (string & {});
+/** represents either a regular value `T`, or nullable value (`null | undefined`), or a `Promise` thereof. */
+export type MaybePromiseOrNull<T> = MaybePromise<T | null | undefined>;
+/** represents either a regular value `T`, or void value (`null | undefined | void`), or a `Promise` thereof. */
+export type MaybePromiseOrVoid<T> = MaybePromise<T | null | undefined | void>;
+//# sourceMappingURL=deps.d.ts.map

package/esm/deps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deps.d.ts","sourceRoot":"","sources":["../src/deps.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yDAAyD,CAAA;AAG3F,YAAY,KAAK,OAAO,MAAM,sDAAsD,CAAA;AACpF,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,QAAQ,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,EAAE,QAAQ,EAAE,aAAa,EAAE,cAAc,EAAE,kBAAkB,EAAE,WAAW,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,sDAAsD,CAAA;AACrQ,OAAO,EAAE,eAAe,EAAE,MAAM,uDAAuD,CAAA;AACvF,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,sBAAsB,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,yDAAyD,CAAA;AACjJ,OAAO,EAAE,KAAK,EAAE,MAAM,0DAA0D,CAAA;AAChF,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,wDAAwD,CAAA;AAC5Q,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,2DAA2D,CAAA;AAC1G,OAAO,EAAE,2BAA2B,EAAE,MAAM,0DAA0D,CAAA;AACtG,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,uDAAuD,CAAA;AAC/G,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,yDAAyD,CAAA;AAEhI,qIAAqI;AACrI,0BAAkB,KAAK;IACtB,GAAG,IAAI;IACP,MAAM,IAAI;IACV,KAAK,IAAI;IACT,UAAU,IAAI;IACd,MAAM,IAAI;CACV;AAED,sDAAsD;AACtD,eAAO,MAAM,MAAM,QAAS,GAAG,KAAG,GAAG,IAAI,CAAC,IAAI,GAAG,SAAS,CAEzD,CAAA;AAED,eAAO,MAAM,IAAI,iBAAoB,CAAA;AAErC,eAAO,MAAM,WAAW,QAAS,MAAM,GAAG,GAAG,KAAG,MAAmD,CAAA;AAYnG,eAAO,MAAM,sBAAsB,QAAS,MAAM,KAAG,MAIpD,CAAA;AAED,eAAO,MACN,WAAW,aAAoB,EAC/B,WAAW,aAAoB,CAAA;AAEhC;;;;;;;;;;;;;;;;;;;;;;;;EAwBE;AACF,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAEtD,6GAA6G;AAC7G,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAAI,YAAY,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC,CAAA;AAEtE,gHAAgH;AAChH,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAAI,YAAY,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAAC,CAAA"}

package/esm/deps.js

@@ -0,0 +1,37 @@
+import { isString } from "./deps/jsr.io/@oazmi/kitchensink/0.10.0/src/struct.js";
+export { array_isEmpty, console_log, date_now, dom_clearTimeout, dom_setTimeout, json_stringify, math_max, object_assign, object_entries, object_fromEntries, object_keys, promise_all, promise_outside } from "./deps/jsr.io/@oazmi/kitchensink/0.10.0/src/alias.js";
+export { bind_array_push } from "./deps/jsr.io/@oazmi/kitchensink/0.10.0/src/binder.js";
+export { ensureFile, getRuntimeCwd, identifyCurrentRuntime, statEntry, writeFile } from "./deps/jsr.io/@oazmi/kitchensink/0.10.0/src/crossenv.js";
+export { crc32 } from "./deps/jsr.io/@oazmi/kitchensink/0.10.0/src/cryptoman.js";
+export { ensureEndSlash, ensureFileUrlIsLocalPath, ensureStartDotSlash, fileUrlToLocalPath, getUriScheme, isAbsolutePath, parseFilepathInfo, pathToPosixPath, relativePath, resolveAsUrl, resolvePathFactory } from "./deps/jsr.io/@oazmi/kitchensink/0.10.0/src/pathman.js";
+export { promiseOutside, promiseTimeout } from "./deps/jsr.io/@oazmi/kitchensink/0.10.0/src/promiseman.js";
+export { escapeLiteralStringForRegex } from "./deps/jsr.io/@oazmi/kitchensink/0.10.0/src/stringman.js";
+export { isArray, isFunction, isRecord, isString } from "./deps/jsr.io/@oazmi/kitchensink/0.10.0/src/struct.js";
+/** flags used for minifying (or eliminating) debugging logs and asserts, when an intelligent bundler, such as `esbuild`, is used. */
+export var DEBUG;
+(function (DEBUG) {
+    DEBUG[DEBUG["LOG"] = 1] = "LOG";
+    DEBUG[DEBUG["ASSERT"] = 1] = "ASSERT";
+    DEBUG[DEBUG["ERROR"] = 1] = "ERROR";
+    DEBUG[DEBUG["PRODUCTION"] = 1] = "PRODUCTION";
+    DEBUG[DEBUG["MINIFY"] = 0] = "MINIFY";
+})(DEBUG || (DEBUG = {}));
+/** check if `obj` is either `null` or `undefined`. */
+export const isNull = (obj) => {
+    return (obj === undefined) || (obj === null);
+};
+export const noop = (() => undefined);
+export const urlToString = (url) => { return isString(url) ? url : url.href; };
+const 
+// posix directory path separator.
+sep = "/", 
+// posix relative directory path navigator.
+dotslash = "./", 
+// posix relative parent directory path navigator.
+dotdotslash = "../", string_starts_with = (str, starts_with) => str.startsWith(starts_with), string_ends_with = (str, ends_with) => str.endsWith(ends_with);
+export const ensureRelativeDotSlash = (str) => {
+    return (string_starts_with(str, dotslash) || string_starts_with(str, dotdotslash)) ? str
+        : string_starts_with(str, sep) ? "." + str
+            : dotslash + str;
+};
+export const textEncoder = new TextEncoder(), textDecoder = new TextDecoder();

package/esm/esbuild/metafile.d.ts

@@ -0,0 +1,90 @@
+/** utility submodule for converting esbuild's metafile and output file interfaces into more convenient and manageable format.
+ *
+ * @module
+*/
+import type { SuperBuildContext } from "../super/build_context.js";
+import type { AbsolutePath, NamespacedPath, Path } from "../typedefs.js";
+import { OutputFileEntity, type OutputFileEntityMap } from "./outputfile.js";
+import type { EsbuildMetafile, EsbuildMetafileImportProps, EsbuildPartialMessage } from "./strongtypes.js";
+import type { EsbuildOutputFile } from "./typedefs.js";
+interface FormattedMetafileOutputProps {
+    /** namespaced and absolute resolved file path of entry-point that is directly the result of this output file. */
+    entryPoint?: NamespacedPath;
+    /** namespaced and absolute resolved file paths of input resources that contributed (i.e. were bundled) into this output file. */
+    inputs: NamespacedPath[];
+    /** the `path` field inside specifies the absolute file paths to other output files that need to be imported by this output file,
+     * unless the `external` flag is set to `true`, in which case the import `path` does not correspond to a local output file.
+    */
+    imports: Array<EsbuildMetafileImportProps>;
+}
+export interface MetafileConfig {
+    /** a reference to the {@link SuperBuildContext.resolvedResourceRegistry} dictionary,
+     * used for recalling the arguments returned by the resolver, loader, and transformer phases.
+    */
+    resolvedResourceRegistry: SuperBuildContext["resolvedResourceRegistry"];
+    /** a function that resolves the given path segment to an absolute path, with respect to `cwd` or `absWorkingDir`. */
+    resolvePath: (path: Path) => AbsolutePath;
+}
+export declare class Metafile implements MetafileConfig {
+    protected readonly value: EsbuildMetafile;
+    readonly inputs: Map<NamespacedPath, EsbuildMetafile["inputs"][string]>;
+    readonly outputs: Map<AbsolutePath, FormattedMetafileOutputProps>;
+    outputFileEntities: OutputFileEntityMap;
+    /** a copy of the {@link SuperBuildContext.resolvedResourceRegistry}, where all keys use lower case characters.
+     * this is extremely important, as we've internally standardized to using only lower casing for namespaced resolved paths,
+     * in order to evade the filesystem case-insesnsitivity problem when matching strings.
+    */
+    resolvedResourceRegistry: SuperBuildContext["resolvedResourceRegistry"];
+    /** a function that resolves the given path segment to an absolute path, with respect to `cwd` or `absWorkingDir`. */
+    resolvePath: (path: Path) => AbsolutePath;
+    /** holds all warnings that have occurred during method calls. */
+    warnings: EsbuildPartialMessage[];
+    constructor(esbuild_metafile: EsbuildMetafile, config: MetafileConfig);
+    addFile(esbuild_file: EsbuildOutputFile): OutputFileEntity;
+    /** this function is intended to run _after_ you have added **all** of your {@link EsbuildOutputFile | esbuild output files} via {@link addFile}.
+     * what it does is that it simply calls the {@link OutputFileEntity.scanEsbuildImports} method of each {@link outputFileEntities | registered file},
+     * so that they can discover the file entity associated which each of their esbuild-based imports.
+    */
+    scanEsbuildImports(): void;
+    /** find the file entity corresponding to the given absolute output path. you won't receive entities associated with external paths/references. */
+    getFile(output_path_key: string): OutputFileEntity | undefined;
+    /** find all file entities that incorporate (i.e. originate from) certain namespaced source files/resources into their bundled form. */
+    findFileFromSources(predicate_fn: (file_sources: Array<{
+        namespace: string;
+        path: string;
+    }>) => boolean): Array<OutputFileEntity>;
+    /** prepares a dependency graph from the current list of {@link outputFileEntities}. */
+    createFileDependencyGraph(): Map<OutputFileEntity, Set<OutputFileEntity>>;
+    /** write all output file entities (those with `entity.write !== false`) to the filesystem. */
+    writeFiles(allow_overwrite?: boolean): Promise<void>;
+    /** normalizes an esbuild metafile to use namespaced paths (`${namespace}:${resolved_path}`) for resolved paths,
+     * and absolute paths for output file paths.
+     *
+     * this function mutates the original metafile object passed to it.
+    */
+    static asNormalized(esbuild_metafile: EsbuildMetafile): EsbuildMetafile;
+    /** lower the casing of an esbuild metafile's namespaced resolved paths,
+     * output file paths, and external paths, based on your `config` configuration.
+     *
+     * lower casing helps in ensuring that there won't be any casing conflicts when searching for a particular resource.
+     *
+     * this function mutates the original metafile object passed to it.
+    */
+    static asLowercased(esbuild_metafile: EsbuildMetafile, config: {
+        /** specify if namespaced resolved paths should be lower cased. */
+        namespacedPaths: boolean;
+        /** specify if output file paths should be lower cased. */
+        outputPaths: boolean;
+        /** specify if external import paths should be lower cased. */
+        externalPaths: boolean;
+    }): EsbuildMetafile;
+    /** resolve all relative file paths in a {@link asNormalized | **normalized**} esbuild metafile to absolute file paths.
+     *
+     * this function mutates the original metafile object passed to it.
+    */
+    static asAbsolute(esbuild_metafile: EsbuildMetafile, config: {
+        resolvePath: (path: string) => string;
+    }): EsbuildMetafile;
+}
+export {};
+//# sourceMappingURL=metafile.d.ts.map

package/esm/esbuild/metafile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metafile.d.ts","sourceRoot":"","sources":["../../src/esbuild/metafile.ts"],"names":[],"mappings":"AAAA;;;EAGE;AAIF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,IAAI,EAAgB,MAAM,gBAAgB,CAAA;AACtF,OAAO,EAAE,gBAAgB,EAAE,KAAK,mBAAmB,EAAoB,MAAM,iBAAiB,CAAA;AAC9F,OAAO,KAAK,EAAE,eAAe,EAAE,0BAA0B,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAA;AAC1G,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAqCtD,UAAU,4BAA4B;IACrC,iHAAiH;IACjH,UAAU,CAAC,EAAE,cAAc,CAAA;IAE3B,iIAAiI;IACjI,MAAM,EAAE,cAAc,EAAE,CAAA;IAExB;;MAEE;IACF,OAAO,EAAE,KAAK,CAAC,0BAA0B,CAAC,CAAA;CAC1C;AAED,MAAM,WAAW,cAAc;IAC9B;;MAEE;IACF,wBAAwB,EAAE,iBAAiB,CAAC,0BAA0B,CAAC,CAAA;IAEvE,qHAAqH;IACrH,WAAW,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,YAAY,CAAA;CACzC;AAED,qBAAa,QAAS,YAAW,cAAc;IAC9C,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAA;IACzC,SAAgB,MAAM,EAAE,GAAG,CAAC,cAAc,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAA;IAC9E,SAAgB,OAAO,EAAE,GAAG,CAAC,YAAY,EAAE,4BAA4B,CAAC,CAAA;IACjE,kBAAkB,EAAE,mBAAmB,CAAY;IAE1D;;;MAGE;IACF,wBAAwB,EAAE,iBAAiB,CAAC,0BAA0B,CAAC,CAAA;IAEvE,qHAAqH;IAC9G,WAAW,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,YAAY,CAAA;IAEhD,iEAAiE;IAC1D,QAAQ,EAAE,qBAAqB,EAAE,CAAK;gBAEjC,gBAAgB,EAAE,eAAe,EAAE,MAAM,EAAE,cAAc;IAwB9D,OAAO,CAAC,YAAY,EAAE,iBAAiB,GAAG,gBAAgB;IAQjE;;;MAGE;IACK,kBAAkB,IAAI,IAAI;IAMjC,kJAAkJ;IAC3I,OAAO,CAAC,eAAe,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAOrE,uIAAuI;IAChI,mBAAmB,CACzB,YAAY,EAAE,CAAC,YAAY,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,KAAK,OAAO,GACjF,KAAK,CAAC,gBAAgB,CAAC;IAS1B,uFAAuF;IAChF,yBAAyB,IAAI,GAAG,CAAC,gBAAgB,EAAE,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAYhF,8FAA8F;IACjF,UAAU,CAAC,eAAe,GAAE,OAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBxE;;;;MAIE;IACF,MAAM,CAAC,YAAY,CAAC,gBAAgB,EAAE,eAAe,GAAG,eAAe;IAoCvE;;;;;;MAME;IACF,MAAM,CAAC,YAAY,CAAC,gBAAgB,EAAE,eAAe,EAAE,MAAM,EAAE;QAC9D,kEAAkE;QAClE,eAAe,EAAE,OAAO,CAAC;QACzB,0DAA0D;QAC1D,WAAW,EAAE,OAAO,CAAC;QACrB,8DAA8D;QAC9D,aAAa,EAAE,OAAO,CAAC;KACvB,GAAG,eAAe;IAyCnB;;;MAGE;IACF,MAAM,CAAC,UAAU,CAAC,gBAAgB,EAAE,eAAe,EAAE,MAAM,EAAE;QAC5D,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;KACtC,GAAG,eAAe;CA4BnB"}