@zthun/helpful-fn 9.11.9 → 9.11.11

package/dist/index.cjs

@@ -1,2151 +1,1920 @@
-'use strict';
-
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-
-const uuid = require('uuid');
-const locale = require('date-fns/locale');
-const tz = require('@date-fns/tz');
-const dateFns = require('date-fns');
-
-/**
- * Represents a targeted point along a y axis.
- */ var ZVerticalAnchor = /*#__PURE__*/ function(ZVerticalAnchor) {
-    /**
-   * Top boundary.
-   *
-   * In vertical device space, this would equate to y = 0.
-   */ ZVerticalAnchor["Top"] = "top";
-    /**
-   * Centerpoint between the top and bottom.
-   */ ZVerticalAnchor["Middle"] = "middle";
-    /**
-   * Bottom boundary.
-   *
-   * In vertical device space, this would equate to y = Infinity.
-   */ ZVerticalAnchor["Bottom"] = "bottom";
-    return ZVerticalAnchor;
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let uuid = require("uuid");
+let date_fns_locale = require("date-fns/locale");
+let _date_fns_tz = require("@date-fns/tz");
+let date_fns = require("date-fns");
+//#region src/anchor/anchor.mts
+/**
+* Represents a targeted point along a y axis.
+*/ var ZVerticalAnchor = /* @__PURE__ */ function(ZVerticalAnchor) {
+	/**
+	* Top boundary.
+	*
+	* In vertical device space, this would equate to y = 0.
+	*/ ZVerticalAnchor["Top"] = "top";
+	/**
+	* Centerpoint between the top and bottom.
+	*/ ZVerticalAnchor["Middle"] = "middle";
+	/**
+	* Bottom boundary.
+	*
+	* In vertical device space, this would equate to y = Infinity.
+	*/ ZVerticalAnchor["Bottom"] = "bottom";
+	return ZVerticalAnchor;
 }({});
 /**
- * Represents a targeted point along an x axis.
- */ var ZHorizontalAnchor = /*#__PURE__*/ function(ZHorizontalAnchor) {
-    /**
-   * Left boundary.
-   *
-   * In horizontal device space, this would equate to x = 0.
-   */ ZHorizontalAnchor["Left"] = "left";
-    /**
-   * Centerpoint between the left and right boundary.
-   */ ZHorizontalAnchor["Center"] = "center";
-    /**
-   * Right boundary.
-   *
-   * In horizontal device space, this would equate to x = Infinity.
-   */ ZHorizontalAnchor["Right"] = "right";
-    return ZHorizontalAnchor;
+* Represents a targeted point along an x axis.
+*/ var ZHorizontalAnchor = /* @__PURE__ */ function(ZHorizontalAnchor) {
+	/**
+	* Left boundary.
+	*
+	* In horizontal device space, this would equate to x = 0.
+	*/ ZHorizontalAnchor["Left"] = "left";
+	/**
+	* Centerpoint between the left and right boundary.
+	*/ ZHorizontalAnchor["Center"] = "center";
+	/**
+	* Right boundary.
+	*
+	* In horizontal device space, this would equate to x = Infinity.
+	*/ ZHorizontalAnchor["Right"] = "right";
+	return ZHorizontalAnchor;
 }({});
-
-function _define_property$7(obj, key, value) {
-    if (key in obj) {
-        Object.defineProperty(obj, key, {
-            value: value,
-            enumerable: true,
-            configurable: true,
-            writable: true
-        });
-    } else {
-        obj[key] = value;
-    }
-    return obj;
+//#endregion
+//#region src/assert/assert.mts
+/**
+* Represents an object that can be used to build a list of assertions.
+*
+* @example
+*
+* ```ts
+* import { ZAssert, createError } from '@zthun/helpful-fn';
+*
+* const user = readUser();
+*
+* ZAssert
+*  .claim(user.name != null, 'User name is required')
+*  .claim(user.email != null, 'User email is required')
+*  .assert((m) => createError(m));
+* ```
+*/ var ZAssert = class ZAssert {
+	/**
+	* Initializes a new instance of a ZAssert with one claim.
+	*
+	* @param claim -
+	*        The claim to make.
+	* @param msg -
+	*        The message to throw if the claim is false.
+	*
+	* @returns
+	*        A new ZAssert object with an initial claim.
+	*/ static claim(claim, msg) {
+		return new ZAssert().claim(claim, msg);
+	}
+	_messages = [];
+	/**
+	* Initializes a new instance of this object.
+	*/ constructor() {}
+	/**
+	* Adds a claim.
+	*
+	* @param claim -
+	*        The claim predicate.
+	* @param msg -
+	*        The message to add if the claim fails.
+	*
+	* @returns This object.
+	*/ claim(claim, msg) {
+		if (!claim) this._messages.push(msg);
+		return this;
+	}
+	/**
+	* Runs the assertion.
+	*
+	* @param fail -
+	*        The factory that is responsible for returning the specified error to throw.
+	*/ assert(fail) {
+		if (this._messages.length === 1) throw fail(this._messages[0]);
+		if (this._messages.length) throw fail(this._messages);
+	}
+};
+//#endregion
+//#region src/enum/is-enum.mts
+/**
+* Gets whether the candidate can represent an enumeration object of type TEnum.
+*
+* This is mostly helpful for type guarding value options in a type.
+*
+* @param enumeration -
+*        The enumeration object that contains the values.
+* @param candidate -
+*        The candidate to check.
+*
+* @returns
+*        True if candidate can represents one of the white listed
+*        object values in enumeration.
+*/ function isEnum(enumeration, candidate) {
+	return candidate != null && (typeof candidate === "string" || typeof candidate === "number") && Object.values(enumeration).includes(candidate);
 }
-/**
- * Represents an object that can be used to build a list of assertions.
- *
- * @example
- *
- * ```ts
- * import { ZAssert, createError } from '@zthun/helpful-fn';
- *
- * const user = readUser();
- *
- * ZAssert
- *  .claim(user.name != null, 'User name is required')
- *  .claim(user.email != null, 'User email is required')
- *  .assert((m) => createError(m));
- * ```
- */ class ZAssert {
-    /**
-   * Initializes a new instance of a ZAssert with one claim.
-   *
-   * @param claim -
-   *        The claim to make.
-   * @param msg -
-   *        The message to throw if the claim is false.
-   *
-   * @returns
-   *        A new ZAssert object with an initial claim.
-   */ static claim(claim, msg) {
-        return new ZAssert().claim(claim, msg);
-    }
-    /**
-   * Adds a claim.
-   *
-   * @param claim -
-   *        The claim predicate.
-   * @param msg -
-   *        The message to add if the claim fails.
-   *
-   * @returns This object.
-   */ claim(claim, msg) {
-        if (!claim) {
-            this._messages.push(msg);
-        }
-        return this;
-    }
-    /**
-   * Runs the assertion.
-   *
-   * @param fail -
-   *        The factory that is responsible for returning the specified error to throw.
-   */ assert(fail) {
-        if (this._messages.length === 1) {
-            throw fail(this._messages[0]);
-        }
-        if (this._messages.length) {
-            throw fail(this._messages);
-        }
-    }
-    /**
-   * Initializes a new instance of this object.
-   */ constructor(){
-        _define_property$7(this, "_messages", []);
-    }
+//#endregion
+//#region src/cast/cast-enum.mts
+/**
+* Attempts to cast the candidate to an enumeration value.
+*
+* @param enumeration -
+*        The enumeration type.
+* @param candidate -
+*        The candidate to cast to the enum type.
+* @param fallback -
+*        The fallback to use in the case that candidate
+*        cannot represent the enumeration type.
+*
+* @returns
+*        The candidate if candidate represents the enumeration type,
+*        or fallback in the case that it does not.
+*/ function castEnum(enumeration, candidate, fallback) {
+	return isEnum(enumeration, candidate) ? candidate : fallback;
 }
-
-/**
- * Gets whether the candidate can represent an enumeration object of type TEnum.
- *
- * This is mostly helpful for type guarding value options in a type.
- *
- * @param enumeration -
- *        The enumeration object that contains the values.
- * @param candidate -
- *        The candidate to check.
- *
- * @returns
- *        True if candidate can represents one of the white listed
- *        object values in enumeration.
- */ function isEnum(enumeration, candidate) {
-    return candidate != null && (typeof candidate === "string" || typeof candidate === "number") && Object.values(enumeration).includes(candidate);
+//#endregion
+//#region src/cast/cast-extension.mts
+/**
+* Puts a . in front of name if one is not already there.
+*
+* If there are multiple dots in front of name, then
+* all dots but one is removed.
+*
+* @example
+*
+* ```ts
+* // Outputs .zip
+* castExtension('zip');
+*
+* // Outputs .zip
+* castExtension('.zip');
+*
+* // Outputs .zip
+* castExtension('...zip');
+* ```
+*
+* @param candidate -
+*        The candidate extension
+*
+* @returns
+*        The candidate prepended by a single dot.
+*        If candidate is undefined, null, the empty
+*        string, white space, or nothing but dots,
+*        then the empty string is returned.
+*/ function castExtension(candidate) {
+	if (candidate == null) return "";
+	const trimmed = candidate.trim();
+	if (!trimmed) return "";
+	const normalized = trimmed.replace(/^\.+/, "");
+	if (!normalized) return "";
+	return `.${normalized}`;
 }
-
-/**
- * Attempts to cast the candidate to an enumeration value.
- *
- * @param enumeration -
- *        The enumeration type.
- * @param candidate -
- *        The candidate to cast to the enum type.
- * @param fallback -
- *        The fallback to use in the case that candidate
- *        cannot represent the enumeration type.
- *
- * @returns
- *        The candidate if candidate represents the enumeration type,
- *        or fallback in the case that it does not.
- */ function castEnum(enumeration, candidate, fallback) {
-    return isEnum(enumeration, candidate) ? candidate : fallback;
+//#endregion
+//#region src/cast/cast-number.mts
+/**
+* Attempts to cast candidate to a number.
+*
+* This method assumes you want an actual number and
+* not NaN.  In the case that candidate results in
+* NaN, then the fallback condition applies.
+*
+* @param candidate -
+*        The candidate to cast.
+*
+* @returns
+*        The casted number or undefined in the cast
+*        that casting candidate would result in NaN.
+*/ /**
+* Attempts to cast candidate to a number.
+*
+* This method assumes you want an actual number and
+* not NaN.  In the case that candidate results in
+* NaN, then the fallback condition applies.
+*
+* @param candidate -
+*        The candidate to cast.
+* @param fallback -
+*        The fallback value in the case that the result
+*        of casting candidate would result in NaN
+*
+* @returns
+*        The casted number or fallback in the cast
+*        that casting candidate would result in NaN.
+*/ function castNumber(candidate, fallback) {
+	try {
+		const casted = Number(candidate);
+		return Number.isNaN(casted) ? fallback : casted;
+	} catch {
+		return fallback;
+	}
 }
-
-/**
- * Puts a . in front of name if one is not already there.
- *
- * If there are multiple dots in front of name, then
- * all dots but one is removed.
- *
- * @example
- *
- * ```ts
- * // Outputs .zip
- * castExtension('zip');
- *
- * // Outputs .zip
- * castExtension('.zip');
- *
- * // Outputs .zip
- * castExtension('...zip');
- * ```
- *
- * @param candidate -
- *        The candidate extension
- *
- * @returns
- *        The candidate prepended by a single dot.
- *        If candidate is undefined, null, the empty
- *        string, white space, or nothing but dots,
- *        then the empty string is returned.
- */ function castExtension(candidate) {
-    if (candidate == null) {
-        return "";
-    }
-    const trimmed = candidate.trim();
-    if (!trimmed) {
-        return "";
-    }
-    const normalized = trimmed.replace(/^\.+/, "");
-    if (!normalized) {
-        return "";
-    }
-    return `.${normalized}`;
+//#endregion
+//#region src/count-buckets/count-buckets.mts
+/**
+* Calculates the total number of buckets you need to
+* store a number of items where each bucket can hold a
+* maximum weight of items.
+*
+* You can use this function to calculate groupings of
+* items based on total counts and sizes.  A good example
+* usage would be to calculate the total number of pages
+* on a paginated list of items given a page size and item
+* count.
+*
+* @param weight -
+*        The maximum weight a bucket can store.  If this value receives
+*        Infinity, then it will result in 1 or min buckets being returned,
+*        whichever is larger.  If this receives NaN, then this method will
+*        result in NaN.  Finally, if this receives a negative value, then
+*        the result will be max.
+* @param items -
+*        The total number of items you need to store where each item
+*        counts as 1 towards the weight.  If the total number of items
+*        is Infinity, then this method will result in max buckets.
+*        If this receives NaN, then this method will result in NaN. Finally,
+*        if you pass 0, or a negative number of items, then result will be min.
+* @param min -
+*        The bounded minimum value.  If the total number of buckets
+*        evaluates to less than this value, then this value is returned.
+*        The default is 0.
+* @param max -
+*        The bounded maximum value.  If the total number of buckets
+*        evaluates to more than this value, then this value is returned.
+*        The default is Infinity.
+*
+* @returns
+*        The number of buckets you need to store the total number
+*        of items given that a single bucket can hold a max weight of items.
+*        If either weight or items is NaN, then NaN will be returned regardless
+*        of the opposite value.  Passing a negative number is the same as
+*        passing 0.
+*
+* @example
+*
+* ```ts
+* // The following will return 5 for numberOfPages since you need 5 buckets
+* // to store 101 number of items where each bucket can hold a max of 25
+* // items.  The 5th page would be a page of 1 item, since 1 is the remainder.
+* const numberOfPages = countBuckets(25, 101);
+*
+* // In this case, the numberOfPages would be 1 here since our minimum buckets
+* // is 1.  By default, this would be 0.
+* const numberOfPages = countBuckets(10, 0, 1);
+*
+* // In this case, we have more items that can be held in the number of buckets
+* // available, so only 4 is returned instead of the 5.
+* const numberOfPages = countBuckets(25, 101, undefined, 4);
+* ```
+*/ function countBuckets(weight, items, min = 0, max = Infinity) {
+	weight = Math.max(0, weight);
+	items = Math.max(0, items);
+	if (Number.isNaN(weight) || Number.isNaN(items)) return NaN;
+	if (items === 0) return min;
+	const boxes = weight === Infinity ? 1 : Math.ceil(items / weight);
+	return Math.min(max, Math.max(min, boxes));
 }
-
-/**
- * Attempts to cast candidate to a number.
- *
- * This method assumes you want an actual number and
- * not NaN.  In the case that candidate results in
- * NaN, then the fallback condition applies.
- *
- * @param candidate -
- *        The candidate to cast.
- *
- * @returns
- *        The casted number or undefined in the cast
- *        that casting candidate would result in NaN.
- */ /**
- * Attempts to cast candidate to a number.
- *
- * This method assumes you want an actual number and
- * not NaN.  In the case that candidate results in
- * NaN, then the fallback condition applies.
- *
- * @param candidate -
- *        The candidate to cast.
- * @param fallback -
- *        The fallback value in the case that the result
- *        of casting candidate would result in NaN
- *
- * @returns
- *        The casted number or fallback in the cast
- *        that casting candidate would result in NaN.
- */ function castNumber(candidate, fallback) {
-    try {
-        const casted = Number(candidate);
-        return Number.isNaN(casted) ? fallback : casted;
-    } catch  {
-        return fallback;
-    }
-}
-
-/**
- * Calculates the total number of buckets you need to
- * store a number of items where each bucket can hold a
- * maximum weight of items.
- *
- * You can use this function to calculate groupings of
- * items based on total counts and sizes.  A good example
- * usage would be to calculate the total number of pages
- * on a paginated list of items given a page size and item
- * count.
- *
- * @param weight -
- *        The maximum weight a bucket can store.  If this value receives
- *        Infinity, then it will result in 1 or min buckets being returned,
- *        whichever is larger.  If this receives NaN, then this method will
- *        result in NaN.  Finally, if this receives a negative value, then
- *        the result will be max.
- * @param items -
- *        The total number of items you need to store where each item
- *        counts as 1 towards the weight.  If the total number of items
- *        is Infinity, then this method will result in max buckets.
- *        If this receives NaN, then this method will result in NaN. Finally,
- *        if you pass 0, or a negative number of items, then result will be min.
- * @param min -
- *        The bounded minimum value.  If the total number of buckets
- *        evaluates to less than this value, then this value is returned.
- *        The default is 0.
- * @param max -
- *        The bounded maximum value.  If the total number of buckets
- *        evaluates to more than this value, then this value is returned.
- *        The default is Infinity.
- *
- * @returns
- *        The number of buckets you need to store the total number
- *        of items given that a single bucket can hold a max weight of items.
- *        If either weight or items is NaN, then NaN will be returned regardless
- *        of the opposite value.  Passing a negative number is the same as
- *        passing 0.
- *
- * @example
- *
- * ```ts
- * // The following will return 5 for numberOfPages since you need 5 buckets
- * // to store 101 number of items where each bucket can hold a max of 25
- * // items.  The 5th page would be a page of 1 item, since 1 is the remainder.
- * const numberOfPages = countBuckets(25, 101);
- *
- * // In this case, the numberOfPages would be 1 here since our minimum buckets
- * // is 1.  By default, this would be 0.
- * const numberOfPages = countBuckets(10, 0, 1);
- *
- * // In this case, we have more items that can be held in the number of buckets
- * // available, so only 4 is returned instead of the 5.
- * const numberOfPages = countBuckets(25, 101, undefined, 4);
- * ```
- */ function countBuckets(weight, items, min = 0, max = Infinity) {
-    weight = Math.max(0, weight);
-    items = Math.max(0, items);
-    if (Number.isNaN(weight) || Number.isNaN(items)) {
-        return NaN;
-    }
-    if (items === 0) {
-        return min;
-    }
-    const boxes = weight === Infinity ? 1 : Math.ceil(items / weight);
-    return Math.min(max, Math.max(min, boxes));
-}
-
-/**
- * A helper method to construct a JavaScript error object given a list of acceptable schema keys.
- *
- * @param problem -
- *        A generic representation of the problem that occurred.  This can be an Error object,
- *        another object representing some kind of error, or some message representing the error.
- *        If this is null or undefined, then a generic error is returned.
- * @param schema -
- *        The list of acceptable object keys to look into problem.  These will be recursively
- *        evaluated to strip out the real error message.  Note that this is in order of
- *        priority.  If schema[0] and schema[1] are both keys on problem, then schema[0] takes
- *        a higher precedence than schema[1].  By default, the schema will look for properties
- *        named, message, error, exception, and data, in that order.
- *
- * @returns
- *        An error object that is the best evaluation of what the problem actually is.
- *
- * @example
- *
- * ```ts
- * // All of these result an Error with the message, 'Something went wrong'
- * const errorWithStringProblem = createError('Something went wrong');
- * const errorWithObjectProblemInSchema = createError({ error: 'Something went wrong'});
- * const errorWithCustomSchema = createError({ issue: 'Something went wrong'}, ['issue']);
- * const errorRecursive = createError({ error: { message: 'Something went wrong' }});
- *
- * // This would result in '[Object object]' as there is no way to figure out how to deconstruct this problem.
- * const errorCannotBeFound = createError({ wut: 'Something went wrong' });
- * ```
- */ function createError(problem, schema = [
-    "message",
-    "error",
-    "exception",
-    "data"
+//#endregion
+//#region src/create-error/create-error.mts
+/**
+* A helper method to construct a JavaScript error object given a list of acceptable schema keys.
+*
+* @param problem -
+*        A generic representation of the problem that occurred.  This can be an Error object,
+*        another object representing some kind of error, or some message representing the error.
+*        If this is null or undefined, then a generic error is returned.
+* @param schema -
+*        The list of acceptable object keys to look into problem.  These will be recursively
+*        evaluated to strip out the real error message.  Note that this is in order of
+*        priority.  If schema[0] and schema[1] are both keys on problem, then schema[0] takes
+*        a higher precedence than schema[1].  By default, the schema will look for properties
+*        named, message, error, exception, and data, in that order.
+*
+* @returns
+*        An error object that is the best evaluation of what the problem actually is.
+*
+* @example
+*
+* ```ts
+* // All of these result an Error with the message, 'Something went wrong'
+* const errorWithStringProblem = createError('Something went wrong');
+* const errorWithObjectProblemInSchema = createError({ error: 'Something went wrong'});
+* const errorWithCustomSchema = createError({ issue: 'Something went wrong'}, ['issue']);
+* const errorRecursive = createError({ error: { message: 'Something went wrong' }});
+*
+* // This would result in '[Object object]' as there is no way to figure out how to deconstruct this problem.
+* const errorCannotBeFound = createError({ wut: 'Something went wrong' });
+* ```
+*/ function createError(problem, schema = [
+	"message",
+	"error",
+	"exception",
+	"data"
 ]) {
-    if (problem instanceof Error) {
-        return problem;
-    }
-    if (problem == null) {
-        return new Error();
-    }
-    for(let i = 0; i < schema.length; ++i){
-        const key = schema[i];
-        if (Object.prototype.hasOwnProperty.call(problem, key)) {
-            return createError(problem[key]);
-        }
-    }
-    return new Error(String(problem));
+	if (problem instanceof Error) return problem;
+	if (problem == null) return /* @__PURE__ */ new Error();
+	for (let i = 0; i < schema.length; ++i) {
+		const key = schema[i];
+		if (Object.prototype.hasOwnProperty.call(problem, key)) return createError(problem[key]);
+	}
+	return new Error(String(problem));
 }
-
-/**
- * Creates a globally unique identifier.
- *
- * The identifier holds to v4 of the UUID specification.  A summary
- * of the specification can be found at
- * {@link https://commons.apache.org/sandbox/commons-id/uuid.html | Apache Commons UUID Documentation}.
- *
- * The official documentation of the UUID specification is under
- * {@link https://www.rfc-editor.org/info/rfc4122 | RFC 4122}
- *
- * @returns
- *        A new generated globally unique identifier based on random bytes.
- *
- * @example
- *
- * ```ts
- * // Will get a value similar to 53e33fb6-d05a-4fa9-8dc0-b78e4feaa702
- * const guidA = createGuid();
- * // Will most likely not ever be equal to guidA
- * const guidB = createGuid();
- * ```
- */ const createGuid = uuid.v4;
-
-/**
- * Supported locales from date-fns.
- *
- * This should not be exported.  This is an internal helper.
- */ const LocaleLookup = {
-    [locale.enAU.code]: locale.enAU,
-    [locale.enCA.code]: locale.enCA,
-    [locale.enGB.code]: locale.enGB,
-    [locale.enIE.code]: locale.enIE,
-    [locale.enIN.code]: locale.enIN,
-    [locale.enNZ.code]: locale.enNZ,
-    [locale.enUS.code]: locale.enUS,
-    [locale.enZA.code]: locale.enZA,
-    [locale.ja.code]: locale.ja
+//#endregion
+//#region src/create-guid/create-guid.mts
+/**
+* Creates a globally unique identifier.
+*
+* The identifier holds to v4 of the UUID specification.  A summary
+* of the specification can be found at
+* {@link https://commons.apache.org/sandbox/commons-id/uuid.html | Apache Commons UUID Documentation}.
+*
+* The official documentation of the UUID specification is under
+* {@link https://www.rfc-editor.org/info/rfc4122 | RFC 4122}
+*
+* @returns
+*        A new generated globally unique identifier based on random bytes.
+*
+* @example
+*
+* ```ts
+* // Will get a value similar to 53e33fb6-d05a-4fa9-8dc0-b78e4feaa702
+* const guidA = createGuid();
+* // Will most likely not ever be equal to guidA
+* const guidB = createGuid();
+* ```
+*/ var createGuid = uuid.v4;
+//#endregion
+//#region src/culture/locale-lookup.mts
+/**
+* Supported locales from date-fns.
+*
+* This should not be exported.  This is an internal helper.
+*/ var LocaleLookup = {
+	[date_fns_locale.enAU.code]: date_fns_locale.enAU,
+	[date_fns_locale.enCA.code]: date_fns_locale.enCA,
+	[date_fns_locale.enGB.code]: date_fns_locale.enGB,
+	[date_fns_locale.enIE.code]: date_fns_locale.enIE,
+	[date_fns_locale.enIN.code]: date_fns_locale.enIN,
+	[date_fns_locale.enNZ.code]: date_fns_locale.enNZ,
+	[date_fns_locale.enUS.code]: date_fns_locale.enUS,
+	[date_fns_locale.enZA.code]: date_fns_locale.enZA,
+	[date_fns_locale.ja.code]: date_fns_locale.ja
 };
-
-/**
- * Returns the users current culture (locale).
- *
- * @returns
- *        The current locale.
- */ function culture() {
-    const locale = Intl.DateTimeFormat().resolvedOptions().locale;
-    return locale;
+//#endregion
+//#region src/culture/culture.mts
+/**
+* Returns the users current culture (locale).
+*
+* @returns
+*        The current locale.
+*/ function culture() {
+	return Intl.DateTimeFormat().resolvedOptions().locale;
 }
 /**
- * Returns all supported cultures.
- *
- * @returns
- *        A list of currently supported culture codes.
- */ function cultures() {
-    return Object.keys(LocaleLookup);
+* Returns all supported cultures.
+*
+* @returns
+*        A list of currently supported culture codes.
+*/ function cultures() {
+	return Object.keys(LocaleLookup);
 }
-
-/**
- * Returns the user's current timezone.
- *
- * @returns
- *        The users current timezone.
- */ function userTimeZone() {
-    return Intl.DateTimeFormat().resolvedOptions().timeZone;
+//#endregion
+//#region src/date/timezone.mts
+/**
+* Returns the user's current timezone.
+*
+* @returns
+*        The users current timezone.
+*/ function userTimeZone() {
+	return Intl.DateTimeFormat().resolvedOptions().timeZone;
 }
 /**
- * Returns the list of all supported timezones.
- *
- * @returns
- *        A list of all timezone values.
- */ function timeZones() {
-    return Intl.supportedValuesOf("timeZone");
+* Returns the list of all supported timezones.
+*
+* @returns
+*        A list of all timezone values.
+*/ function timeZones() {
+	return Intl.supportedValuesOf("timeZone");
 }
-
-/**
- * Parses a string value back to a date format.
- *
- *
- * @param value -
- *        The value to parse
- * @param options -
- *        The options to parse with.  The most important option here is format.
- *        If the format is not specified, then the standard zoned ISO 8601
- *        format is used.  The timezone is also used in the case the date
- *        does not supply it for string values.  If the timezone is not specified
- *        then the users timezone is assumed.  Finally, the cultural local will
- *        default to the users current culture if not specified.
- *
- * @returns
- *        The date object parsed from the value.  Returns null
- *        if the value parsed with the given options results in an
- *        invalid date.
- */ function parseDateTime(value, options = {}) {
-    const { fallback = null } = options;
-    if (value == null) {
-        return fallback;
-    }
-    if (typeof value === "number") {
-        const candidate = new Date(value);
-        return Number.isNaN(candidate.getTime()) ? fallback : candidate;
-    }
-    if (value instanceof Date) {
-        return Number.isNaN(value.getTime()) ? fallback : value;
-    }
-    const { format = ZDateFormats.Iso, culture: culture$1 = culture(), timeZone = userTimeZone() } = options;
-    const locale = LocaleLookup[culture$1];
-    const reference = new tz.TZDate(dateFns.startOfToday()).withTimeZone(timeZone);
-    const result = dateFns.parse(value, format, reference, {
-        locale
-    });
-    return Number.isNaN(result.getTime()) ? fallback : result;
+//#endregion
+//#region src/date/parse-date.mts
+/**
+* Parses a string value back to a date format.
+*
+*
+* @param value -
+*        The value to parse
+* @param options -
+*        The options to parse with.  The most important option here is format.
+*        If the format is not specified, then the standard zoned ISO 8601
+*        format is used.  The timezone is also used in the case the date
+*        does not supply it for string values.  If the timezone is not specified
+*        then the users timezone is assumed.  Finally, the cultural local will
+*        default to the users current culture if not specified.
+*
+* @returns
+*        The date object parsed from the value.  Returns null
+*        if the value parsed with the given options results in an
+*        invalid date.
+*/ function parseDateTime(value, options = {}) {
+	const { fallback = null } = options;
+	if (value == null) return fallback;
+	if (typeof value === "number") {
+		const candidate = new Date(value);
+		return Number.isNaN(candidate.getTime()) ? fallback : candidate;
+	}
+	if (value instanceof Date) return Number.isNaN(value.getTime()) ? fallback : value;
+	const { format = ZDateFormats.Iso, culture: culture$2 = culture(), timeZone = userTimeZone() } = options;
+	const locale = LocaleLookup[culture$2];
+	const result = (0, date_fns.parse)(value, format, new _date_fns_tz.TZDate((0, date_fns.startOfToday)()).withTimeZone(timeZone), { locale });
+	return Number.isNaN(result.getTime()) ? fallback : result;
 }
-
-/**
- * Similar to {@link parseDateTime} but tries multiple supported formats.
- *
- * @param value -
- *        The value to parse that may result in a date.
- * @param options -
- *        The options for guessing the date.  These will be forwarded to parse
- *        for processing.
- */ function guessDateTime(value, options = {}) {
-    const { fallback = null } = options;
-    if (value == null) {
-        return fallback;
-    }
-    const { supportedFormats = Object.values(ZDateFormats) } = options;
-    for (const fmt of supportedFormats){
-        const inner = {
-            ...options
-        };
-        inner.format = fmt;
-        const result = parseDateTime(value, inner);
-        if (result != null) {
-            return result;
-        }
-    }
-    return fallback;
+//#endregion
+//#region src/date/guess-date.mts
+/**
+* Similar to {@link parseDateTime} but tries multiple supported formats.
+*
+* @param value -
+*        The value to parse that may result in a date.
+* @param options -
+*        The options for guessing the date.  These will be forwarded to parse
+*        for processing.
+*/ function guessDateTime(value, options = {}) {
+	const { fallback = null } = options;
+	if (value == null) return fallback;
+	const { supportedFormats = Object.values(ZDateFormats) } = options;
+	for (const fmt of supportedFormats) {
+		const inner = { ...options };
+		inner.format = fmt;
+		const result = parseDateTime(value, inner);
+		if (result != null) return result;
+	}
+	return fallback;
 }
-
-/**
- * Basic date formats that are common for storage and usage.
- */ var ZDateFormats = /*#__PURE__*/ function(ZDateFormats) {
-    /**
-   * Standard {@link https://en.wikipedia.org/wiki/ISO_8601 | ISO-8601} format with date only.
-   *
-   * Using this should imply midnight user timezone.
-   */ ZDateFormats["IsoDateOnly"] = "yyyy-MM-dd";
-    /**
-   * Standard {@link https://en.wikipedia.org/wiki/ISO_8601 | ISO-8601} format with time only.
-   */ ZDateFormats["IsoTimeOnly"] = "HH:mm:ss.SSS";
-    /**
-   * Standard {@link https://en.wikipedia.org/wiki/ISO_8601 | ISO-8601} format without timezone specifier.
-   */ ZDateFormats["IsoNoTimeZone"] = "yyyy-MM-dd'T'HH:mm:ss.SSS";
-    /**
-   * Standard {@link https://en.wikipedia.org/wiki/ISO_8601 | ISO-8601} format.
-   */ ZDateFormats["Iso"] = "yyyy-MM-dd'T'HH:mm:ss.SSSXX";
-    /**
-   * Users local date (locale specific).
-   */ ZDateFormats["LocalDate"] = "P";
-    /**
-   * User local time (locale specific).
-   */ ZDateFormats["LocalTime"] = "p";
-    /**
-   * Date and time formatted with user specific locale.
-   */ ZDateFormats["LocalDateTime"] = "Pp";
-    return ZDateFormats;
+//#endregion
+//#region src/date/format-date.mts
+/**
+* Basic date formats that are common for storage and usage.
+*/ var ZDateFormats = /* @__PURE__ */ function(ZDateFormats) {
+	/**
+	* Standard {@link https://en.wikipedia.org/wiki/ISO_8601 | ISO-8601} format with date only.
+	*
+	* Using this should imply midnight user timezone.
+	*/ ZDateFormats["IsoDateOnly"] = "yyyy-MM-dd";
+	/**
+	* Standard {@link https://en.wikipedia.org/wiki/ISO_8601 | ISO-8601} format with time only.
+	*/ ZDateFormats["IsoTimeOnly"] = "HH:mm:ss.SSS";
+	/**
+	* Standard {@link https://en.wikipedia.org/wiki/ISO_8601 | ISO-8601} format without timezone specifier.
+	*/ ZDateFormats["IsoNoTimeZone"] = "yyyy-MM-dd'T'HH:mm:ss.SSS";
+	/**
+	* Standard {@link https://en.wikipedia.org/wiki/ISO_8601 | ISO-8601} format.
+	*/ ZDateFormats["Iso"] = "yyyy-MM-dd'T'HH:mm:ss.SSSXX";
+	/**
+	* Users local date (locale specific).
+	*/ ZDateFormats["LocalDate"] = "P";
+	/**
+	* User local time (locale specific).
+	*/ ZDateFormats["LocalTime"] = "p";
+	/**
+	* Date and time formatted with user specific locale.
+	*/ ZDateFormats["LocalDateTime"] = "Pp";
+	return ZDateFormats;
 }({});
 /**
- * Formats a given value.
- *
- * @param value -
- *        The value to format.
- * @param options -
- *        The given options for the format.
- *
- * @returns
- *        If value is null or undefined, then the empty string is returned.
- *        If value is a string, then the date is guessed from the string and
- *        reformatted to the format specified by options.  Otherwise,
- *        the date or number specified by value is formatted to the culture,
- *        timezone, and format specified in the options.
- */ function formatDateTime(value, options = {}) {
-    const { format = "Pp", culture: culture$1 = culture(), timeZone = userTimeZone(), fallback = "" } = options;
-    let date;
-    if (value == null) {
-        date = null;
-    } else if (typeof value === "string") {
-        date = guessDateTime(value, {
-            ...options,
-            fallback: null
-        });
-    } else {
-        date = new Date(value);
-    }
-    if (date == null || Number.isNaN(date.getTime())) {
-        return fallback;
-    }
-    const withTz = new tz.TZDate(date, timeZone);
-    return dateFns.formatDate(withTz, format, {
-        locale: LocaleLookup[culture$1]
-    });
-}
-
-/**
- * Does replacement of interpolation, ${}, tokens in a string.
- *
- * @param tokenized -
- *        The string that can contain interpolation tokens.
- * @param tokens -
- *         The tokens to replace.
- *
- * @returns
- *         A detokenized string that replaces the tokens with the values
- *         in the token dictionary.  If a value is missing in the token dictionary,
- *         then the tokens are preserved.  If the value of a token is null or
- *         undefined explicitly, then any tokens in the tokenized string are
- *         removed for that value.
- */ function detokenize(tokenized, tokens) {
-    if (tokenized == null) return "";
-    return tokenized.replace(/\$\{([^}]+)\}/g, (_, tokenName)=>{
-        if (tokenName in tokens) {
-            const value = tokens[tokenName];
-            if (value === null || value === undefined) {
-                return "";
-            }
-            return value;
-        }
-        return `\${${tokenName}}`; // leave token intact if not present in tokens
-    });
-}
-
-/**
- * Returns true if an object is empty, null, or undefined.
- *
- * Note that this is different than lodash's isEmpty method.
- * Checking an empty array or empty string will result
- * in false.
- *
- * @param candidate -
- *        The object to test.
- *
- * @returns
- *        True if candidate is the empty object or
- *        null.  False otherwise.
- */ function isEmptyObject(candidate) {
-    const candidateType = typeof candidate;
-    return candidate == null || candidateType === "object" && Object.keys(candidate).length === 0;
+* Formats a given value.
+*
+* @param value -
+*        The value to format.
+* @param options -
+*        The given options for the format.
+*
+* @returns
+*        If value is null or undefined, then the empty string is returned.
+*        If value is a string, then the date is guessed from the string and
+*        reformatted to the format specified by options.  Otherwise,
+*        the date or number specified by value is formatted to the culture,
+*        timezone, and format specified in the options.
+*/ function formatDateTime(value, options = {}) {
+	const { format = "Pp", culture: culture$1 = culture(), timeZone = userTimeZone(), fallback = "" } = options;
+	let date;
+	if (value == null) date = null;
+	else if (typeof value === "string") date = guessDateTime(value, {
+		...options,
+		fallback: null
+	});
+	else date = new Date(value);
+	if (date == null || Number.isNaN(date.getTime())) return fallback;
+	return (0, date_fns.formatDate)(new _date_fns_tz.TZDate(date, timeZone), format, { locale: LocaleLookup[culture$1] });
 }
-
-/**
- * Information for an enum value.
- *
- * This is useful for front end development when
- * you want to map an enumeration like value to
- * things like a display name, description, and
- * avatar.  ECMAScript does not support decorators
- * for literal fields so this is an alternative
- * to describe that kind of information.
- *
- * This is similar to Metadata from helpful-query,
- * but it's much more specific and specialized
- * to enumerations.
- */ function _define_property$6(obj, key, value) {
-    if (key in obj) {
-        Object.defineProperty(obj, key, {
-            value: value,
-            enumerable: true,
-            configurable: true,
-            writable: true
-        });
-    } else {
-        obj[key] = value;
-    }
-    return obj;
+//#endregion
+//#region src/detokenize/detokenize.mts
+/**
+* Does replacement of interpolation, ${}, tokens in a string.
+*
+* @param tokenized -
+*        The string that can contain interpolation tokens.
+* @param tokens -
+*         The tokens to replace.
+*
+* @returns
+*         A detokenized string that replaces the tokens with the values
+*         in the token dictionary.  If a value is missing in the token dictionary,
+*         then the tokens are preserved.  If the value of a token is null or
+*         undefined explicitly, then any tokens in the tokenized string are
+*         removed for that value.
+*/ function detokenize(tokenized, tokens) {
+	if (tokenized == null) return "";
+	return tokenized.replace(/\$\{([^}]+)\}/g, (_, tokenName) => {
+		if (tokenName in tokens) {
+			const value = tokens[tokenName];
+			if (value === null || value === void 0) return "";
+			return value;
+		}
+		return `\${${tokenName}}`;
+	});
 }
-/**
- * Builds information for an enum.
- */ class ZEnumInfoBuilder {
-    /**
-   * The display name of the enum.
-   *
-   * @param name -
-   *        The display name of the enum.
-   *
-   * @returns
-   *        This object.
-   */ name(name) {
-        this._metadata.name = name;
-        return this;
-    }
-    /**
-   * Text description of the enum.
-   *
-   * @param description -
-   *        Text description of what the value means.
-   *
-   * @returns
-   *        This object.
-   */ description(description) {
-        this._metadata.description = description;
-        return this;
-    }
-    /**
-   * The avatar representation of the enum.
-   *
-   * @param avatar -
-   *        The avatar representation of what the value
-   *        is.  This can be anything but should be related
-   *        to the framework it is being developed for.
-   *
-   * @returns
-   *        This object.
-   */ avatar(avatar) {
-        this._metadata.avatar = avatar;
-        return this;
-    }
-    /**
-   * Returns a shallow copy of the metadata.
-   *
-   * @returns
-   *        A shallow copy of the metadata.
-   */ build() {
-        return {
-            ...this._metadata
-        };
-    }
-    /**
-   * Initializes a new instance of this object.
-   *
-   * @param value -
-   *        The value to initialize with.
-   */ constructor(value){
-        _define_property$6(this, "_metadata", void 0);
-        this._metadata = {
-            value
-        };
-    }
+//#endregion
+//#region src/empty/is-empty-object.mts
+/**
+* Returns true if an object is empty, null, or undefined.
+*
+* Note that this is different than lodash's isEmpty method.
+* Checking an empty array or empty string will result
+* in false.
+*
+* @param candidate -
+*        The object to test.
+*
+* @returns
+*        True if candidate is the empty object or
+*        null.  False otherwise.
+*/ function isEmptyObject(candidate) {
+	return candidate == null || typeof candidate === "object" && Object.keys(candidate).length === 0;
 }
-
-const BYTES_PER_KIBIBYTE = 1024;
-const BYTES_PER_MEBIBYTE = 1048576; // 1024 ^ 2
-const BYTES_PER_GIBIBYTE = 1073741824; // 1024 ^ 3
-const BYTES_PER_TEBIBYTE = 1099511627776; // 1024 ^ 4
-const BYTES_PER_PEBIBYTE = 1125899906842624; // 1024 ^ 5
+//#endregion
+//#region src/enum/enum-info.mts
+/**
+* Information for an enum value.
+*
+* This is useful for front end development when
+* you want to map an enumeration like value to
+* things like a display name, description, and
+* avatar.  ECMAScript does not support decorators
+* for literal fields so this is an alternative
+* to describe that kind of information.
+*
+* This is similar to Metadata from helpful-query,
+* but it's much more specific and specialized
+* to enumerations.
+*/ /**
+* Builds information for an enum.
+*/ var ZEnumInfoBuilder = class {
+	_metadata;
+	/**
+	* Initializes a new instance of this object.
+	*
+	* @param value -
+	*        The value to initialize with.
+	*/ constructor(value) {
+		this._metadata = { value };
+	}
+	/**
+	* The display name of the enum.
+	*
+	* @param name -
+	*        The display name of the enum.
+	*
+	* @returns
+	*        This object.
+	*/ name(name) {
+		this._metadata.name = name;
+		return this;
+	}
+	/**
+	* Text description of the enum.
+	*
+	* @param description -
+	*        Text description of what the value means.
+	*
+	* @returns
+	*        This object.
+	*/ description(description) {
+		this._metadata.description = description;
+		return this;
+	}
+	/**
+	* The avatar representation of the enum.
+	*
+	* @param avatar -
+	*        The avatar representation of what the value
+	*        is.  This can be anything but should be related
+	*        to the framework it is being developed for.
+	*
+	* @returns
+	*        This object.
+	*/ avatar(avatar) {
+		this._metadata.avatar = avatar;
+		return this;
+	}
+	/**
+	* Returns a shallow copy of the metadata.
+	*
+	* @returns
+	*        A shallow copy of the metadata.
+	*/ build() {
+		return { ...this._metadata };
+	}
+};
+//#endregion
+//#region src/file-size/file-size.mts
+var BYTES_PER_KIBIBYTE = 1024;
+var BYTES_PER_MEBIBYTE = 1048576;
+var BYTES_PER_GIBIBYTE = 1073741824;
+var BYTES_PER_TEBIBYTE = 1099511627776;
+var BYTES_PER_PEBIBYTE = 0x4000000000000;
 function bytes(bytesPerUnit, amount) {
-    return Math.ceil(bytesPerUnit * amount);
+	return Math.ceil(bytesPerUnit * amount);
 }
 /**
- * Returns the total number of bytes for the wanted amount of kibibytes.
- *
- * A kibibyte is 1024 bytes.
- *
- * @param amount -
- *        The total number of kibibytes to convert to bytes.
- *
- * @returns
- *        The total number of bytes in the given amount of kibibytes.
- */ const kibibytes = bytes.bind(null, BYTES_PER_KIBIBYTE);
-/**
- * @see {@link kibibytes}
- */ const kib = kibibytes;
-/**
- * Returns the total number of bytes for the wanted number of mebibytes.
- *
- * A mebibyte is 1024 kibibytes.
- *
- * @param amount -
- *        The total amount of mebibytes to convert to bytes.
- *
- * @returns
- *        The total number of bytes in the given amount of mebibytes.
- */ const mebibytes = bytes.bind(null, BYTES_PER_MEBIBYTE);
-/**
- * @see {@link mebibytes}
- */ const mib = mebibytes;
-/**
- * Returns the total number of bytes for the wanted number of gibibytes.
- *
- * A gibibyte is 1024 mebibytes.
- *
- * @param amount -
- *        The total amount of gibibytes to convert to bytes.
- *
- * @returns
- *        The total number of bytes in the given amount of gibibytes.
- */ const gibibytes = bytes.bind(null, BYTES_PER_GIBIBYTE);
-/**
- * @see {@link gibibytes}
- */ const gib = gibibytes;
-/**
- * Returns the total number of bytes for the wanted number of tebibytes.
- *
- * A tebibyte is 1024 gibibytes.
- *
- * @param amount -
- *        The total amount of tebibytes to convert to bytes.
- *
- * @returns
- *        The total number of bytes in the given amount of tebibytes.
- */ const tebibytes = bytes.bind(null, BYTES_PER_TEBIBYTE);
-/**
- * @see {@link tebibytes}
- */ const tib = tebibytes;
-/**
- * Returns the total number of bytes for the wanted number of pebibytes.
- *
- * A pebibytes is 1024 tebibytes.
- *
- * @param amount -
- *        The total amount of pebibytes to convert to bytes.
- *
- * @returns
- *        The total number of bytes in the given amount of pebibytes.
- */ const pebibytes = bytes.bind(null, BYTES_PER_PEBIBYTE);
-/**
- * @see {@link pebibytes}
- */ const pib = pebibytes;
-
-/**
- * Returns the first value in an argument list that matches a predicate.
- *
- * @param predicate -
- *        The match method against each value argument.
- * @param fallback -
- *        The fallback value in the case that all arguments fail
- *        the predicate.
- * @param first -
- *        The first value to check.
- * @param remaining -
- *        The remaining values beyond the first to check.
- * @param T -
- *        The type of data that will be enumerated.
- *
- * @returns
- *        The first value for where predicate returns true for the given argument value.
- *        If first and all values of remaining fail the predicate then fallback is returned.
- */ function firstWhere(predicate, fallback, first, ...remaining) {
-    if (predicate(first)) {
-        return first;
-    }
-    for(let i = 0; i < remaining.length; ++i){
-        const val = remaining[i];
-        if (predicate(val)) {
-            return val;
-        }
-    }
-    return fallback;
-}
-/**
- * Returns the first value in args such that args is not null or undefined.
- *
- * @param fallback -
- *        The fallback value in the case that all values in args are null/undefined.
- * @param first -
- *        The first value to check.
- * @param remaining -
- *        The remaining values beyond the first to check.
- * @param T -
- *        The type of data that will be enumerated.
- *
- * @returns
- *        The first value if it is not null or undefined.  If first is undefined or null, then the first item
- *        in remaining such that remaining[i] is not null or undefined is returned.  If first and all values of
- *        remaining are null or undefined, then fallback is returned.
- *
- * @example
- *
- * ```ts
- * // 'Defined'
- * const shouldBeDefined = firstDefined('Fallback', null, undefined, 'Defined');
- * // 'Fallback'
- * const shouldBeFallback = firstDefined('Fallback', null, undefined);
- * const shouldAlsoBeFallback = firstDefined('Fallback', undefined);
- * // 'First'
- * const shouldBeFirst = firstDefined('Fallback', 'First', null, 'Third');
- * ```
- */ function firstDefined(fallback, first, ...remaining) {
-    return firstWhere((v)=>v != null, fallback, first, ...remaining);
+* Returns the total number of bytes for the wanted amount of kibibytes.
+*
+* A kibibyte is 1024 bytes.
+*
+* @param amount -
+*        The total number of kibibytes to convert to bytes.
+*
+* @returns
+*        The total number of bytes in the given amount of kibibytes.
+*/ var kibibytes = bytes.bind(null, BYTES_PER_KIBIBYTE);
+/**
+* @see {@link kibibytes}
+*/ var kib = kibibytes;
+/**
+* Returns the total number of bytes for the wanted number of mebibytes.
+*
+* A mebibyte is 1024 kibibytes.
+*
+* @param amount -
+*        The total amount of mebibytes to convert to bytes.
+*
+* @returns
+*        The total number of bytes in the given amount of mebibytes.
+*/ var mebibytes = bytes.bind(null, BYTES_PER_MEBIBYTE);
+/**
+* @see {@link mebibytes}
+*/ var mib = mebibytes;
+/**
+* Returns the total number of bytes for the wanted number of gibibytes.
+*
+* A gibibyte is 1024 mebibytes.
+*
+* @param amount -
+*        The total amount of gibibytes to convert to bytes.
+*
+* @returns
+*        The total number of bytes in the given amount of gibibytes.
+*/ var gibibytes = bytes.bind(null, BYTES_PER_GIBIBYTE);
+/**
+* @see {@link gibibytes}
+*/ var gib = gibibytes;
+/**
+* Returns the total number of bytes for the wanted number of tebibytes.
+*
+* A tebibyte is 1024 gibibytes.
+*
+* @param amount -
+*        The total amount of tebibytes to convert to bytes.
+*
+* @returns
+*        The total number of bytes in the given amount of tebibytes.
+*/ var tebibytes = bytes.bind(null, BYTES_PER_TEBIBYTE);
+/**
+* @see {@link tebibytes}
+*/ var tib = tebibytes;
+/**
+* Returns the total number of bytes for the wanted number of pebibytes.
+*
+* A pebibytes is 1024 tebibytes.
+*
+* @param amount -
+*        The total amount of pebibytes to convert to bytes.
+*
+* @returns
+*        The total number of bytes in the given amount of pebibytes.
+*/ var pebibytes = bytes.bind(null, BYTES_PER_PEBIBYTE);
+/**
+* @see {@link pebibytes}
+*/ var pib = pebibytes;
+//#endregion
+//#region src/first-where/first-where.mts
+/**
+* Returns the first value in an argument list that matches a predicate.
+*
+* @param predicate -
+*        The match method against each value argument.
+* @param fallback -
+*        The fallback value in the case that all arguments fail
+*        the predicate.
+* @param first -
+*        The first value to check.
+* @param remaining -
+*        The remaining values beyond the first to check.
+* @param T -
+*        The type of data that will be enumerated.
+*
+* @returns
+*        The first value for where predicate returns true for the given argument value.
+*        If first and all values of remaining fail the predicate then fallback is returned.
+*/ function firstWhere(predicate, fallback, first, ...remaining) {
+	if (predicate(first)) return first;
+	for (let i = 0; i < remaining.length; ++i) {
+		const val = remaining[i];
+		if (predicate(val)) return val;
+	}
+	return fallback;
 }
 /**
- * Returns the first value in args such that args is truthy
- *
- * @param fallback -
- *        The fallback value in the case that all values in args are falsy.
- * @param first -
- *        The first value to check.
- * @param remaining -
- *        The remaining values beyond the first to check.
- * @param T -
- *        The type of data that will be enumerated.
- *
- * @returns
- *        The first value if it is truthy.  If first is falsy, then the first item
- *        in remaining such that remaining[i] is truthy is returned.  If first and
- *        all values of remaining are falsy, then fallback is returned.
- *
- * @example
- *
- * ```ts
- * // 'Defined'
- * const shouldBeDefined = firstTruthy('Fallback', null, undefined, 'Defined');
- * // 'Fallback'
- * const shouldBeFallback = firstTruthy('Fallback', '', undefined);
- * const shouldAlsoBeFallback = firstDefined('Fallback', 0, false);
- * // 'First'
- * const shouldBeFirst = firstDefined('Fallback', 'First', null, false, 0, NaN);
- * ```
- */ function firstTruthy(fallback, first, ...remaining) {
-    return firstWhere((v)=>!!v, fallback, first, ...remaining);
-}
-
-function _define_property$5(obj, key, value) {
-    if (key in obj) {
-        Object.defineProperty(obj, key, {
-            value: value,
-            enumerable: true,
-            configurable: true,
-            writable: true
-        });
-    } else {
-        obj[key] = value;
-    }
-    return obj;
+* Returns the first value in args such that args is not null or undefined.
+*
+* @param fallback -
+*        The fallback value in the case that all values in args are null/undefined.
+* @param first -
+*        The first value to check.
+* @param remaining -
+*        The remaining values beyond the first to check.
+* @param T -
+*        The type of data that will be enumerated.
+*
+* @returns
+*        The first value if it is not null or undefined.  If first is undefined or null, then the first item
+*        in remaining such that remaining[i] is not null or undefined is returned.  If first and all values of
+*        remaining are null or undefined, then fallback is returned.
+*
+* @example
+*
+* ```ts
+* // 'Defined'
+* const shouldBeDefined = firstDefined('Fallback', null, undefined, 'Defined');
+* // 'Fallback'
+* const shouldBeFallback = firstDefined('Fallback', null, undefined);
+* const shouldAlsoBeFallback = firstDefined('Fallback', undefined);
+* // 'First'
+* const shouldBeFirst = firstDefined('Fallback', 'First', null, 'Third');
+* ```
+*/ function firstDefined(fallback, first, ...remaining) {
+	return firstWhere((v) => v != null, fallback, first, ...remaining);
 }
 /**
- * An object that can be used to build an {@link IZQuadrilateralCorners} object.
- *
- * @param T -
- *        The type of data to associate to each corner.
- */ class ZQuadrilateralCornersBuilder {
-    /**
-   * Sets the bottom left corner value.
-   *
-   * @param value -
-   *        The value to set.
-   *
-   * @returns
-   *        This object.
-   */ bottomLeft(value) {
-        this._corners.bottomLeft = value;
-        return this;
-    }
-    /**
-   * Sets the bottom right corner value.
-   *
-   * @param value -
-   *        The value to set.
-   *
-   * @returns
-   *        This object.
-   */ bottomRight(value) {
-        this._corners.bottomRight = value;
-        return this;
-    }
-    /**
-   * Sets the top left corner value.
-   *
-   * @param value -
-   *        The value to set.
-   *
-   * @returns
-   *        This object.
-   */ topLeft(value) {
-        this._corners.topLeft = value;
-        return this;
-    }
-    /**
-   * Sets the top right corner value.
-   *
-   * @param value -
-   *        The value to set.
-   *
-   * @returns
-   *        This object.
-   */ topRight(value) {
-        this._corners.topRight = value;
-        return this;
-    }
-    /**
-   * Sets the bottom left and bottom right values.
-   *
-   * @param value -
-   *        The value for bottom left and bottom right.
-   *
-   * @returns
-   *        This object.
-   */ bottom(value) {
-        return this.bottomLeft(value).bottomRight(value);
-    }
-    /**
-   * Sets the bottom left and top left values.
-   *
-   * @param value -
-   *        The value for bottom left and top left.
-   *
-   * @returns
-   *        This object.
-   */ left(value) {
-        return this.topLeft(value).bottomLeft(value);
-    }
-    /**
-   * Sets the bottom right and top right values.
-   *
-   * @param value -
-   *        The value for bottom right and top right.
-   *
-   * @returns
-   *        This object.
-   */ right(value) {
-        return this.bottomRight(value).topRight(value);
-    }
-    /**
-   * Sets the top left and top right  values.
-   *
-   * @param value -
-   *        The value for top left and top right.
-   *
-   * @returns
-   *        This object.
-   */ top(value) {
-        return this.topLeft(value).topRight(value);
-    }
-    /**
-   * Sets the corner values based on an object that
-   * describes a set of quadrilateral corners.
-   *
-   * @param other -
-   *        The object that describes the corners.
-   *
-   * @returns
-   *        This object.
-   */ from(other) {
-        function isVerticals(candidate) {
-            return candidate != null && (Object.prototype.hasOwnProperty.call(candidate, "bottom") || Object.prototype.hasOwnProperty.call(candidate, "top"));
-        }
-        function isHorizontals(candidate) {
-            return candidate != null && (Object.prototype.hasOwnProperty.call(candidate, "left") || Object.prototype.hasOwnProperty.call(candidate, "right"));
-        }
-        function isCorners(candidate) {
-            return candidate != null && (Object.prototype.hasOwnProperty.call(candidate, "bottomLeft") || Object.prototype.hasOwnProperty.call(candidate, "bottomRight") || Object.prototype.hasOwnProperty.call(candidate, "topLeft") || Object.prototype.hasOwnProperty.call(candidate, "topRight"));
-        }
-        const { bottomLeft, bottomRight, topLeft, topRight } = this._corners;
-        if (isCorners(other)) {
-            this._corners.bottomLeft = firstDefined(bottomLeft, other.bottomLeft);
-            this._corners.bottomRight = firstDefined(bottomRight, other.bottomRight);
-            this._corners.topLeft = firstDefined(topLeft, other.topLeft);
-            this._corners.topRight = firstDefined(topRight, other.topRight);
-            return this;
-        }
-        if (isVerticals(other)) {
-            this._corners.bottomLeft = firstDefined(bottomLeft, other.bottom);
-            this._corners.bottomRight = firstDefined(bottomRight, other.bottom);
-            this._corners.topLeft = firstDefined(topLeft, other.top);
-            this._corners.topRight = firstDefined(topRight, other.top);
-            return this;
-        }
-        if (isHorizontals(other)) {
-            this._corners.bottomLeft = firstDefined(bottomLeft, other.left);
-            this._corners.bottomRight = firstDefined(bottomRight, other.right);
-            this._corners.topLeft = firstDefined(topLeft, other.left);
-            this._corners.topRight = firstDefined(topRight, other.right);
-            return this;
-        }
-        if (!isEmptyObject(other)) {
-            this._corners.bottomLeft = firstDefined(bottomLeft, other);
-            this._corners.bottomRight = firstDefined(bottomRight, other);
-            this._corners.topLeft = firstDefined(topLeft, other);
-            this._corners.topRight = firstDefined(topRight, other);
-        }
-        return this;
-    }
-    /**
-   * Copies another corners object into this builder.
-   *
-   * @param other -
-   *        The corners object to copy.
-   *
-   * @returns
-   *        This object.
-   */ copy(other) {
-        this._corners = structuredClone(other);
-        return this;
-    }
-    /**
-   * Builds the corners.
-   *
-   * @returns
-   *        The built corners.
-   */ build() {
-        return structuredClone(this._corners);
-    }
-    constructor(start){
-        _define_property$5(this, "_corners", void 0);
-        this._corners = {
-            bottomLeft: start,
-            bottomRight: start,
-            topLeft: start,
-            topRight: start
-        };
-    }
+* Returns the first value in args such that args is truthy
+*
+* @param fallback -
+*        The fallback value in the case that all values in args are falsy.
+* @param first -
+*        The first value to check.
+* @param remaining -
+*        The remaining values beyond the first to check.
+* @param T -
+*        The type of data that will be enumerated.
+*
+* @returns
+*        The first value if it is truthy.  If first is falsy, then the first item
+*        in remaining such that remaining[i] is truthy is returned.  If first and
+*        all values of remaining are falsy, then fallback is returned.
+*
+* @example
+*
+* ```ts
+* // 'Defined'
+* const shouldBeDefined = firstTruthy('Fallback', null, undefined, 'Defined');
+* // 'Fallback'
+* const shouldBeFallback = firstTruthy('Fallback', '', undefined);
+* const shouldAlsoBeFallback = firstDefined('Fallback', 0, false);
+* // 'First'
+* const shouldBeFirst = firstDefined('Fallback', 'First', null, false, 0, NaN);
+* ```
+*/ function firstTruthy(fallback, first, ...remaining) {
+	return firstWhere((v) => !!v, fallback, first, ...remaining);
 }
-
-function _define_property$4(obj, key, value) {
-    if (key in obj) {
-        Object.defineProperty(obj, key, {
-            value: value,
-            enumerable: true,
-            configurable: true,
-            writable: true
-        });
-    } else {
-        obj[key] = value;
-    }
-    return obj;
-}
-/**
- * Represents a builder for a quadrilateral object.
- */ class ZQuadrilateralBuilder {
-    /**
-   * Sets the bottom value.
-   *
-   * @param bottom -
-   *        The bottom value.
-   *
-   * @returns
-   *        This object.
-   */ bottom(bottom) {
-        this._quad.bottom = bottom;
-        return this;
-    }
-    /**
-   * Sets the left value.
-   *
-   * @param left -
-   *        The left value.
-   *
-   * @returns
-   *        This object.
-   */ left(left) {
-        this._quad.left = left;
-        return this;
-    }
-    /**
-   * Sets the right value.
-   *
-   * @param right -
-   *        The right value.
-   *
-   * @returns
-   *        This object.
-   */ right(right) {
-        this._quad.right = right;
-        return this;
-    }
-    /**
-   * Sets the top value.
-   *
-   * @param top -
-   *        The top value.
-   *
-   * @returns
-   *        This object.
-   */ top(top) {
-        this._quad.top = top;
-        return this;
-    }
-    /**
-   * Sets the left and right value.
-   *
-   * @param x -
-   *        The left and right value.
-   *
-   * @returns
-   *        This object.
-   */ x(x) {
-        return this.left(x).right(x);
-    }
-    /**
-   * Sets the top and bottom value.
-   *
-   * @param y -
-   *        The top and bottom value.
-   *
-   * @returns
-   *        This object.
-   */ y(y) {
-        return this.bottom(y).top(y);
-    }
-    /**
-   * Constructs a full quadrilateral from an object that describes a quadrilateral.
-   *
-   * Note the limitations of this method.  If T is of type Quadrilateral or Point2d,
-   * then this method's behavior is undefined and it will most likely build a
-   * corrupt object.
-   *
-   * @param other -
-   *        The object to build from.
-   *
-   * @returns
-   *        This object.
-   */ from(other) {
-        function isPoint2d(candidate) {
-            return candidate != null && (Object.prototype.hasOwnProperty.call(candidate, "x") || Object.prototype.hasOwnProperty.call(candidate, "y"));
-        }
-        function isQuadrilateral(candidate) {
-            return candidate != null && (Object.prototype.hasOwnProperty.call(candidate, "bottom") || Object.prototype.hasOwnProperty.call(candidate, "left") || Object.prototype.hasOwnProperty.call(candidate, "right") || Object.prototype.hasOwnProperty.call(candidate, "top"));
-        }
-        if (isQuadrilateral(other)) {
-            this._quad.bottom = firstDefined(this._quad.bottom, other.bottom);
-            this._quad.left = firstDefined(this._quad.left, other.left);
-            this._quad.right = firstDefined(this._quad.right, other.right);
-            this._quad.top = firstDefined(this._quad.top, other.top);
-            return this;
-        }
-        if (isPoint2d(other)) {
-            this._quad.bottom = firstDefined(this._quad.bottom, other.y);
-            this._quad.left = firstDefined(this._quad.left, other.x);
-            this._quad.right = firstDefined(this._quad.right, other.x);
-            this._quad.top = firstDefined(this._quad.top, other.y);
-            return this;
-        }
-        if (!isEmptyObject(other)) {
-            this._quad.bottom = firstDefined(this._quad.bottom, other);
-            this._quad.left = firstDefined(this._quad.left, other);
-            this._quad.right = firstDefined(this._quad.right, other);
-            this._quad.top = firstDefined(this._quad.top, other);
-        }
-        return this;
-    }
-    /**
-   * Copies another quadrilateral object into the current instance.
-   *
-   * @param other -
-   *        The quadrilateral object to copy.
-   *
-   * @returns
-   *        This object.
-   */ copy(other) {
-        // The copy is done this way instead of a structured
-        // copy because we want to support things like
-        // copy(other.getBoundingClientRect()) which
-        // is immutable when working on the client.
-        this._quad.left = other.left;
-        this._quad.right = other.right;
-        this._quad.top = other.top;
-        this._quad.bottom = other.bottom;
-        return this;
-    }
-    /**
-   * Returns the built quadrilateral object.
-   *
-   * @returns
-   *        The built quadrilateral.
-   */ build() {
-        return structuredClone(this._quad);
-    }
-    /**
-   * Initializes a new instance of this object.
-   *
-   * @param start -
-   *        The starting value.
-   */ constructor(start){
-        _define_property$4(this, "_quad", void 0);
-        this._quad = {
-            bottom: start,
-            left: start,
-            right: start,
-            top: start
-        };
-    }
-}
-
-function _define_property$3(obj, key, value) {
-    if (key in obj) {
-        Object.defineProperty(obj, key, {
-            value: value,
-            enumerable: true,
-            configurable: true,
-            writable: true
-        });
-    } else {
-        obj[key] = value;
-    }
-    return obj;
-}
-/**
- * Represents a helper object that can run calculations on a numeric quadrilateral.
- */ class ZRectangle {
-    /**
-   * Calculates the width of the rectangle.
-   *
-   * @returns
-   *        The numeric width of the rectangle.
-   */ width() {
-        const { left, right } = this.sides;
-        return right - left;
-    }
-    /**
-   * Calculates the height of the rectangle.
-   *
-   * @returns
-   *        The numeric height of the rectangle.
-   */ height() {
-        const { top, bottom } = this.sides;
-        return bottom - top;
-    }
-    /**
-   * Calculates the area of the rectangle.
-   *
-   * @returns
-   *        The numeric area of the rectangle.
-   */ area() {
-        return this.width() * this.height();
-    }
-    /**
-   * Takes a candidate and attaches it to this rectangle that matches the anchor points.
-   *
-   * @param anchor -
-   *        The anchor point of this rectangle.
-   * @param candidate -
-   *        The candidate rectangle to move
-   * @param candidateAnchor -
-   *        The anchor point of the candidate rectangle.
-   *
-   * @returns
-   *        A new quadrilateral that has it's placement such that if candidate was moved
-   *        to this resulting position, would have its candidateAnchor be in the same
-   *        place as this rectangles specified anchor.
-   */ attach(anchor, candidate, candidateAnchor) {
-        const _candidate = new ZRectangle(candidate);
-        const { x: ax, y: ay } = this.point(anchor);
-        const { x: ox, y: oy } = new ZRectangle(candidate).point(candidateAnchor);
-        const left = candidate.left + (ax - ox);
-        const top = candidate.top + (ay - oy);
-        const bottom = top + _candidate.height();
-        const right = left + _candidate.width();
-        return new ZQuadrilateralBuilder(0).left(left).right(right).top(top).bottom(bottom).build();
-    }
-    /**
-   * Takes the candidate quadrilateral and adjusts it's coordinates to fit inside this rectangle.
-   *
-   * This is done by shifting the rectangle left, right, up, and down to make sure it is bounded
-   * inside.
-   *
-   * If the candidate width or height is larger than this rectangle, thus it cannot fit, then
-   * the candidate will be centered on the dimension where it is too big to fit.
-   *
-   * @param candidate -
-   *        The candidate quadrilateral to fit.
-   *
-   * @returns
-   *        A new quadrilateral that offsets candidate so that it can fit inside this
-   *        rectangle.
-   */ offsetToFit(candidate) {
-        let _candidate = candidate;
-        const candidateRectangle = new ZRectangle(candidate);
-        if (candidateRectangle.width() > this.width()) {
-            // Center the horizontal
-            const { x: cx } = candidateRectangle.middleCenter();
-            const { x: tx } = this.middleCenter();
-            _candidate = new ZQuadrilateralBuilder(0).copy(_candidate).left(_candidate.left - (cx - tx)).right(_candidate.right - (cx - tx)).build();
-        } else {
-            if (_candidate.left < this.sides.left) {
-                // Move the candidate to the right.
-                _candidate = new ZQuadrilateralBuilder(0).copy(_candidate).left(this.sides.left).right(_candidate.right + (this.sides.left - _candidate.left)).build();
-            }
-            if (_candidate.right > this.sides.right) {
-                // Move the candidate to the left.
-                _candidate = new ZQuadrilateralBuilder(0).copy(_candidate).right(this.sides.right).left(_candidate.left - (_candidate.right - this.sides.right)).build();
-            }
-        }
-        if (candidateRectangle.height() > this.height()) {
-            // Center the vertical
-            const { y: cy } = candidateRectangle.middleCenter();
-            const { y: ty } = this.middleCenter();
-            _candidate = new ZQuadrilateralBuilder(0).copy(_candidate).top(_candidate.top - (cy - ty)).bottom(_candidate.bottom - (cy - ty)).build();
-        } else {
-            if (_candidate.bottom > this.sides.bottom) {
-                // Move the candidate up.
-                _candidate = new ZQuadrilateralBuilder(0).copy(_candidate).bottom(this.sides.bottom).top(_candidate.top - (_candidate.bottom - this.sides.bottom)).build();
-            }
-            if (_candidate.top < this.sides.top) {
-                // Move the candidate down
-                _candidate = new ZQuadrilateralBuilder(0).copy(_candidate).top(this.sides.top).bottom(_candidate.bottom + (this.sides.top - _candidate.top)).build();
-            }
-        }
-        return _candidate;
-    }
-    /**
-   * Calculates the (x, y) point given an anchor target.
-   *
-   * @param anchor -
-   *        The anchor target to calculate the point for.
-   *
-   * @returns
-   *        The numeric width of the rectangle.
-   */ point(anchor) {
-        const { bottom, left, right, top } = this.sides;
-        const [vertical, horizontal] = anchor;
-        const v = {
-            [ZVerticalAnchor.Top]: top,
-            [ZVerticalAnchor.Middle]: (bottom + top) / 2,
-            [ZVerticalAnchor.Bottom]: bottom
-        };
-        const h = {
-            [ZHorizontalAnchor.Left]: left,
-            [ZHorizontalAnchor.Center]: (right + left) / 2,
-            [ZHorizontalAnchor.Right]: right
-        };
-        return {
-            x: h[horizontal],
-            y: v[vertical]
-        };
-    }
-    /**
-   * Initializes a new instance of this object.
-   *
-   * @param sides -
-   *        The numeric sides of a quadrilateral.
-   */ constructor(sides){
-        _define_property$3(this, "sides", void 0);
-        /**
-   * Calculates the top left point of the rectangle.
-   *
-   * @returns
-   *        The top left point of the rectangle.
-   */ _define_property$3(this, "topLeft", void 0);
-        /**
-   * Calculates the top center point of the rectangle.
-   *
-   * @returns
-   *        The top center point of the rectangle.
-   */ _define_property$3(this, "topCenter", void 0);
-        /**
-   * Calculates the top right point of the rectangle.
-   *
-   * @returns
-   *        The top right point of the rectangle.
-   */ _define_property$3(this, "topRight", void 0);
-        /**
-   * Calculates the middle left point of the rectangle.
-   *
-   * @returns
-   *        The middle left point of the rectangle.
-   */ _define_property$3(this, "middleLeft", void 0);
-        /**
-   * Calculates the middle center point of the rectangle.
-   *
-   * @returns
-   *        The middle center point of the rectangle.
-   */ _define_property$3(this, "middleCenter", void 0);
-        /**
-   * Calculates the middle right point of the rectangle.
-   *
-   * @returns
-   *        The middle right point of the rectangle.
-   */ _define_property$3(this, "middleRight", void 0);
-        /**
-   * Calculates the bottom left point of the rectangle.
-   *
-   * @returns
-   *        The bottom left point of the rectangle.
-   */ _define_property$3(this, "bottomLeft", void 0);
-        /**
-   * Calculates the bottom center point of the rectangle.
-   *
-   * @returns
-   *        The bottom center point of the rectangle.
-   */ _define_property$3(this, "bottomCenter", void 0);
-        /**
-   * Calculates the bottom right point of the rectangle.
-   *
-   * @returns
-   *        The bottom right point of the rectangle.
-   */ _define_property$3(this, "bottomRight", void 0);
-        this.sides = sides;
-        this.topLeft = this.point.bind(this, [
-            ZVerticalAnchor.Top,
-            ZHorizontalAnchor.Left
-        ]);
-        this.topCenter = this.point.bind(this, [
-            ZVerticalAnchor.Top,
-            ZHorizontalAnchor.Center
-        ]);
-        this.topRight = this.point.bind(this, [
-            ZVerticalAnchor.Top,
-            ZHorizontalAnchor.Right
-        ]);
-        this.middleLeft = this.point.bind(this, [
-            ZVerticalAnchor.Middle,
-            ZHorizontalAnchor.Left
-        ]);
-        this.middleCenter = this.point.bind(this, [
-            ZVerticalAnchor.Middle,
-            ZHorizontalAnchor.Center
-        ]);
-        this.middleRight = this.point.bind(this, [
-            ZVerticalAnchor.Middle,
-            ZHorizontalAnchor.Right
-        ]);
-        this.bottomLeft = this.point.bind(this, [
-            ZVerticalAnchor.Bottom,
-            ZHorizontalAnchor.Left
-        ]);
-        this.bottomCenter = this.point.bind(this, [
-            ZVerticalAnchor.Bottom,
-            ZHorizontalAnchor.Center
-        ]);
-        this.bottomRight = this.point.bind(this, [
-            ZVerticalAnchor.Bottom,
-            ZHorizontalAnchor.Right
-        ]);
-    }
-}
-
+//#endregion
+//#region src/geometry/quadrilateral.mts
+/**
+* Represents a builder for a quadrilateral object.
+*/ var ZQuadrilateralBuilder = class {
+	_quad;
+	/**
+	* Initializes a new instance of this object.
+	*
+	* @param start -
+	*        The starting value.
+	*/ constructor(start) {
+		this._quad = {
+			bottom: start,
+			left: start,
+			right: start,
+			top: start
+		};
+	}
+	/**
+	* Sets the bottom value.
+	*
+	* @param bottom -
+	*        The bottom value.
+	*
+	* @returns
+	*        This object.
+	*/ bottom(bottom) {
+		this._quad.bottom = bottom;
+		return this;
+	}
+	/**
+	* Sets the left value.
+	*
+	* @param left -
+	*        The left value.
+	*
+	* @returns
+	*        This object.
+	*/ left(left) {
+		this._quad.left = left;
+		return this;
+	}
+	/**
+	* Sets the right value.
+	*
+	* @param right -
+	*        The right value.
+	*
+	* @returns
+	*        This object.
+	*/ right(right) {
+		this._quad.right = right;
+		return this;
+	}
+	/**
+	* Sets the top value.
+	*
+	* @param top -
+	*        The top value.
+	*
+	* @returns
+	*        This object.
+	*/ top(top) {
+		this._quad.top = top;
+		return this;
+	}
+	/**
+	* Sets the left and right value.
+	*
+	* @param x -
+	*        The left and right value.
+	*
+	* @returns
+	*        This object.
+	*/ x(x) {
+		return this.left(x).right(x);
+	}
+	/**
+	* Sets the top and bottom value.
+	*
+	* @param y -
+	*        The top and bottom value.
+	*
+	* @returns
+	*        This object.
+	*/ y(y) {
+		return this.bottom(y).top(y);
+	}
+	/**
+	* Constructs a full quadrilateral from an object that describes a quadrilateral.
+	*
+	* Note the limitations of this method.  If T is of type Quadrilateral or Point2d,
+	* then this method's behavior is undefined and it will most likely build a
+	* corrupt object.
+	*
+	* @param other -
+	*        The object to build from.
+	*
+	* @returns
+	*        This object.
+	*/ from(other) {
+		function isPoint2d(candidate) {
+			return candidate != null && (Object.prototype.hasOwnProperty.call(candidate, "x") || Object.prototype.hasOwnProperty.call(candidate, "y"));
+		}
+		function isQuadrilateral(candidate) {
+			return candidate != null && (Object.prototype.hasOwnProperty.call(candidate, "bottom") || Object.prototype.hasOwnProperty.call(candidate, "left") || Object.prototype.hasOwnProperty.call(candidate, "right") || Object.prototype.hasOwnProperty.call(candidate, "top"));
+		}
+		if (isQuadrilateral(other)) {
+			this._quad.bottom = firstDefined(this._quad.bottom, other.bottom);
+			this._quad.left = firstDefined(this._quad.left, other.left);
+			this._quad.right = firstDefined(this._quad.right, other.right);
+			this._quad.top = firstDefined(this._quad.top, other.top);
+			return this;
+		}
+		if (isPoint2d(other)) {
+			this._quad.bottom = firstDefined(this._quad.bottom, other.y);
+			this._quad.left = firstDefined(this._quad.left, other.x);
+			this._quad.right = firstDefined(this._quad.right, other.x);
+			this._quad.top = firstDefined(this._quad.top, other.y);
+			return this;
+		}
+		if (!isEmptyObject(other)) {
+			this._quad.bottom = firstDefined(this._quad.bottom, other);
+			this._quad.left = firstDefined(this._quad.left, other);
+			this._quad.right = firstDefined(this._quad.right, other);
+			this._quad.top = firstDefined(this._quad.top, other);
+		}
+		return this;
+	}
+	/**
+	* Copies another quadrilateral object into the current instance.
+	*
+	* @param other -
+	*        The quadrilateral object to copy.
+	*
+	* @returns
+	*        This object.
+	*/ copy(other) {
+		this._quad.left = other.left;
+		this._quad.right = other.right;
+		this._quad.top = other.top;
+		this._quad.bottom = other.bottom;
+		return this;
+	}
+	/**
+	* Returns the built quadrilateral object.
+	*
+	* @returns
+	*        The built quadrilateral.
+	*/ build() {
+		return structuredClone(this._quad);
+	}
+};
+//#endregion
+//#region src/geometry/quadrilateral-corners.mts
+/**
+* An object that can be used to build an {@link IZQuadrilateralCorners} object.
+*
+* @param T -
+*        The type of data to associate to each corner.
+*/ var ZQuadrilateralCornersBuilder = class {
+	_corners;
+	constructor(start) {
+		this._corners = {
+			bottomLeft: start,
+			bottomRight: start,
+			topLeft: start,
+			topRight: start
+		};
+	}
+	/**
+	* Sets the bottom left corner value.
+	*
+	* @param value -
+	*        The value to set.
+	*
+	* @returns
+	*        This object.
+	*/ bottomLeft(value) {
+		this._corners.bottomLeft = value;
+		return this;
+	}
+	/**
+	* Sets the bottom right corner value.
+	*
+	* @param value -
+	*        The value to set.
+	*
+	* @returns
+	*        This object.
+	*/ bottomRight(value) {
+		this._corners.bottomRight = value;
+		return this;
+	}
+	/**
+	* Sets the top left corner value.
+	*
+	* @param value -
+	*        The value to set.
+	*
+	* @returns
+	*        This object.
+	*/ topLeft(value) {
+		this._corners.topLeft = value;
+		return this;
+	}
+	/**
+	* Sets the top right corner value.
+	*
+	* @param value -
+	*        The value to set.
+	*
+	* @returns
+	*        This object.
+	*/ topRight(value) {
+		this._corners.topRight = value;
+		return this;
+	}
+	/**
+	* Sets the bottom left and bottom right values.
+	*
+	* @param value -
+	*        The value for bottom left and bottom right.
+	*
+	* @returns
+	*        This object.
+	*/ bottom(value) {
+		return this.bottomLeft(value).bottomRight(value);
+	}
+	/**
+	* Sets the bottom left and top left values.
+	*
+	* @param value -
+	*        The value for bottom left and top left.
+	*
+	* @returns
+	*        This object.
+	*/ left(value) {
+		return this.topLeft(value).bottomLeft(value);
+	}
+	/**
+	* Sets the bottom right and top right values.
+	*
+	* @param value -
+	*        The value for bottom right and top right.
+	*
+	* @returns
+	*        This object.
+	*/ right(value) {
+		return this.bottomRight(value).topRight(value);
+	}
+	/**
+	* Sets the top left and top right  values.
+	*
+	* @param value -
+	*        The value for top left and top right.
+	*
+	* @returns
+	*        This object.
+	*/ top(value) {
+		return this.topLeft(value).topRight(value);
+	}
+	/**
+	* Sets the corner values based on an object that
+	* describes a set of quadrilateral corners.
+	*
+	* @param other -
+	*        The object that describes the corners.
+	*
+	* @returns
+	*        This object.
+	*/ from(other) {
+		function isVerticals(candidate) {
+			return candidate != null && (Object.prototype.hasOwnProperty.call(candidate, "bottom") || Object.prototype.hasOwnProperty.call(candidate, "top"));
+		}
+		function isHorizontals(candidate) {
+			return candidate != null && (Object.prototype.hasOwnProperty.call(candidate, "left") || Object.prototype.hasOwnProperty.call(candidate, "right"));
+		}
+		function isCorners(candidate) {
+			return candidate != null && (Object.prototype.hasOwnProperty.call(candidate, "bottomLeft") || Object.prototype.hasOwnProperty.call(candidate, "bottomRight") || Object.prototype.hasOwnProperty.call(candidate, "topLeft") || Object.prototype.hasOwnProperty.call(candidate, "topRight"));
+		}
+		const { bottomLeft, bottomRight, topLeft, topRight } = this._corners;
+		if (isCorners(other)) {
+			this._corners.bottomLeft = firstDefined(bottomLeft, other.bottomLeft);
+			this._corners.bottomRight = firstDefined(bottomRight, other.bottomRight);
+			this._corners.topLeft = firstDefined(topLeft, other.topLeft);
+			this._corners.topRight = firstDefined(topRight, other.topRight);
+			return this;
+		}
+		if (isVerticals(other)) {
+			this._corners.bottomLeft = firstDefined(bottomLeft, other.bottom);
+			this._corners.bottomRight = firstDefined(bottomRight, other.bottom);
+			this._corners.topLeft = firstDefined(topLeft, other.top);
+			this._corners.topRight = firstDefined(topRight, other.top);
+			return this;
+		}
+		if (isHorizontals(other)) {
+			this._corners.bottomLeft = firstDefined(bottomLeft, other.left);
+			this._corners.bottomRight = firstDefined(bottomRight, other.right);
+			this._corners.topLeft = firstDefined(topLeft, other.left);
+			this._corners.topRight = firstDefined(topRight, other.right);
+			return this;
+		}
+		if (!isEmptyObject(other)) {
+			this._corners.bottomLeft = firstDefined(bottomLeft, other);
+			this._corners.bottomRight = firstDefined(bottomRight, other);
+			this._corners.topLeft = firstDefined(topLeft, other);
+			this._corners.topRight = firstDefined(topRight, other);
+		}
+		return this;
+	}
+	/**
+	* Copies another corners object into this builder.
+	*
+	* @param other -
+	*        The corners object to copy.
+	*
+	* @returns
+	*        This object.
+	*/ copy(other) {
+		this._corners = structuredClone(other);
+		return this;
+	}
+	/**
+	* Builds the corners.
+	*
+	* @returns
+	*        The built corners.
+	*/ build() {
+		return structuredClone(this._corners);
+	}
+};
+//#endregion
+//#region src/geometry/rectangle.mts
+/**
+* Represents a helper object that can run calculations on a numeric quadrilateral.
+*/ var ZRectangle = class ZRectangle {
+	sides;
+	/**
+	* Initializes a new instance of this object.
+	*
+	* @param sides -
+	*        The numeric sides of a quadrilateral.
+	*/ constructor(sides) {
+		this.sides = sides;
+	}
+	/**
+	* Calculates the width of the rectangle.
+	*
+	* @returns
+	*        The numeric width of the rectangle.
+	*/ width() {
+		const { left, right } = this.sides;
+		return right - left;
+	}
+	/**
+	* Calculates the height of the rectangle.
+	*
+	* @returns
+	*        The numeric height of the rectangle.
+	*/ height() {
+		const { top, bottom } = this.sides;
+		return bottom - top;
+	}
+	/**
+	* Calculates the area of the rectangle.
+	*
+	* @returns
+	*        The numeric area of the rectangle.
+	*/ area() {
+		return this.width() * this.height();
+	}
+	/**
+	* Takes a candidate and attaches it to this rectangle that matches the anchor points.
+	*
+	* @param anchor -
+	*        The anchor point of this rectangle.
+	* @param candidate -
+	*        The candidate rectangle to move
+	* @param candidateAnchor -
+	*        The anchor point of the candidate rectangle.
+	*
+	* @returns
+	*        A new quadrilateral that has it's placement such that if candidate was moved
+	*        to this resulting position, would have its candidateAnchor be in the same
+	*        place as this rectangles specified anchor.
+	*/ attach(anchor, candidate, candidateAnchor) {
+		const _candidate = new ZRectangle(candidate);
+		const { x: ax, y: ay } = this.point(anchor);
+		const { x: ox, y: oy } = new ZRectangle(candidate).point(candidateAnchor);
+		const left = candidate.left + (ax - ox);
+		const top = candidate.top + (ay - oy);
+		const bottom = top + _candidate.height();
+		const right = left + _candidate.width();
+		return new ZQuadrilateralBuilder(0).left(left).right(right).top(top).bottom(bottom).build();
+	}
+	/**
+	* Takes the candidate quadrilateral and adjusts it's coordinates to fit inside this rectangle.
+	*
+	* This is done by shifting the rectangle left, right, up, and down to make sure it is bounded
+	* inside.
+	*
+	* If the candidate width or height is larger than this rectangle, thus it cannot fit, then
+	* the candidate will be centered on the dimension where it is too big to fit.
+	*
+	* @param candidate -
+	*        The candidate quadrilateral to fit.
+	*
+	* @returns
+	*        A new quadrilateral that offsets candidate so that it can fit inside this
+	*        rectangle.
+	*/ offsetToFit(candidate) {
+		let _candidate = candidate;
+		const candidateRectangle = new ZRectangle(candidate);
+		if (candidateRectangle.width() > this.width()) {
+			const { x: cx } = candidateRectangle.middleCenter();
+			const { x: tx } = this.middleCenter();
+			_candidate = new ZQuadrilateralBuilder(0).copy(_candidate).left(_candidate.left - (cx - tx)).right(_candidate.right - (cx - tx)).build();
+		} else {
+			if (_candidate.left < this.sides.left) _candidate = new ZQuadrilateralBuilder(0).copy(_candidate).left(this.sides.left).right(_candidate.right + (this.sides.left - _candidate.left)).build();
+			if (_candidate.right > this.sides.right) _candidate = new ZQuadrilateralBuilder(0).copy(_candidate).right(this.sides.right).left(_candidate.left - (_candidate.right - this.sides.right)).build();
+		}
+		if (candidateRectangle.height() > this.height()) {
+			const { y: cy } = candidateRectangle.middleCenter();
+			const { y: ty } = this.middleCenter();
+			_candidate = new ZQuadrilateralBuilder(0).copy(_candidate).top(_candidate.top - (cy - ty)).bottom(_candidate.bottom - (cy - ty)).build();
+		} else {
+			if (_candidate.bottom > this.sides.bottom) _candidate = new ZQuadrilateralBuilder(0).copy(_candidate).bottom(this.sides.bottom).top(_candidate.top - (_candidate.bottom - this.sides.bottom)).build();
+			if (_candidate.top < this.sides.top) _candidate = new ZQuadrilateralBuilder(0).copy(_candidate).top(this.sides.top).bottom(_candidate.bottom + (this.sides.top - _candidate.top)).build();
+		}
+		return _candidate;
+	}
+	/**
+	* Calculates the (x, y) point given an anchor target.
+	*
+	* @param anchor -
+	*        The anchor target to calculate the point for.
+	*
+	* @returns
+	*        The numeric width of the rectangle.
+	*/ point(anchor) {
+		const { bottom, left, right, top } = this.sides;
+		const [vertical, horizontal] = anchor;
+		const v = {
+			[ZVerticalAnchor.Top]: top,
+			[ZVerticalAnchor.Middle]: (bottom + top) / 2,
+			[ZVerticalAnchor.Bottom]: bottom
+		};
+		return {
+			x: {
+				[ZHorizontalAnchor.Left]: left,
+				[ZHorizontalAnchor.Center]: (right + left) / 2,
+				[ZHorizontalAnchor.Right]: right
+			}[horizontal],
+			y: v[vertical]
+		};
+	}
+	/**
+	* Calculates the top left point of the rectangle.
+	*
+	* @returns
+	*        The top left point of the rectangle.
+	*/ topLeft = this.point.bind(this, [ZVerticalAnchor.Top, ZHorizontalAnchor.Left]);
+	/**
+	* Calculates the top center point of the rectangle.
+	*
+	* @returns
+	*        The top center point of the rectangle.
+	*/ topCenter = this.point.bind(this, [ZVerticalAnchor.Top, ZHorizontalAnchor.Center]);
+	/**
+	* Calculates the top right point of the rectangle.
+	*
+	* @returns
+	*        The top right point of the rectangle.
+	*/ topRight = this.point.bind(this, [ZVerticalAnchor.Top, ZHorizontalAnchor.Right]);
+	/**
+	* Calculates the middle left point of the rectangle.
+	*
+	* @returns
+	*        The middle left point of the rectangle.
+	*/ middleLeft = this.point.bind(this, [ZVerticalAnchor.Middle, ZHorizontalAnchor.Left]);
+	/**
+	* Calculates the middle center point of the rectangle.
+	*
+	* @returns
+	*        The middle center point of the rectangle.
+	*/ middleCenter = this.point.bind(this, [ZVerticalAnchor.Middle, ZHorizontalAnchor.Center]);
+	/**
+	* Calculates the middle right point of the rectangle.
+	*
+	* @returns
+	*        The middle right point of the rectangle.
+	*/ middleRight = this.point.bind(this, [ZVerticalAnchor.Middle, ZHorizontalAnchor.Right]);
+	/**
+	* Calculates the bottom left point of the rectangle.
+	*
+	* @returns
+	*        The bottom left point of the rectangle.
+	*/ bottomLeft = this.point.bind(this, [ZVerticalAnchor.Bottom, ZHorizontalAnchor.Left]);
+	/**
+	* Calculates the bottom center point of the rectangle.
+	*
+	* @returns
+	*        The bottom center point of the rectangle.
+	*/ bottomCenter = this.point.bind(this, [ZVerticalAnchor.Bottom, ZHorizontalAnchor.Center]);
+	/**
+	* Calculates the bottom right point of the rectangle.
+	*
+	* @returns
+	*        The bottom right point of the rectangle.
+	*/ bottomRight = this.point.bind(this, [ZVerticalAnchor.Bottom, ZHorizontalAnchor.Right]);
+};
+//#endregion
+//#region src/global/global.mts
 /* v8 ignore start -- @preserve */ /* istanbul ignore file -- @preserve */ /**
- * Resolves the global object without referencing DOM globals so this can be
- * consumed in Node builds that do not include the `dom` lib.
- */ const $global = globalThis; /* v8 ignore end -- @preserve */
-
-/**
- * A set of parameters that can be used for a string join.
- *
- * Join lists can be a regular object, null, undefined, or a tuple where the
- * first item is the object to join, and the second item is a boolean that specifies
- * whether to include it if the value is truthy.
- *
- * @param T -
- *        The type of data to join.
- */ /**
- * Similar to Array.join but filters out null and undefined items.
- *
- * @param delimiter -
- *        The delimiter that separates the items.
- * @param items -
- *        The items to join.
- * @param T -
- *        The type of data to join.
- *
- * @returns
- *        A string that joins the items that are defined, separated by delimiter.
- *
- * @example
- *
- * ```ts
- * // 'a b d'
- * const joinBySpace = joinDefined(' ', 'a', 'b', ['c', false], null, undefined, ['d', true]);
- * // (Empty String)
- * const joinEmpty = joinDefined('?');
- * ```
- */ function joinDefined(delimiter, ...items) {
-    return items.map((item)=>item instanceof Array ? item[1] ? item[0] : null : item).filter((item)=>item != null).join(delimiter);
+* Resolves the global object without referencing DOM globals so this can be
+* consumed in Node builds that do not include the `dom` lib.
+*/ var $global = globalThis;
+//#endregion
+//#region src/join-defined/join-defined.mts
+/**
+* A set of parameters that can be used for a string join.
+*
+* Join lists can be a regular object, null, undefined, or a tuple where the
+* first item is the object to join, and the second item is a boolean that specifies
+* whether to include it if the value is truthy.
+*
+* @param T -
+*        The type of data to join.
+*/ /**
+* Similar to Array.join but filters out null and undefined items.
+*
+* @param delimiter -
+*        The delimiter that separates the items.
+* @param items -
+*        The items to join.
+* @param T -
+*        The type of data to join.
+*
+* @returns
+*        A string that joins the items that are defined, separated by delimiter.
+*
+* @example
+*
+* ```ts
+* // 'a b d'
+* const joinBySpace = joinDefined(' ', 'a', 'b', ['c', false], null, undefined, ['d', true]);
+* // (Empty String)
+* const joinEmpty = joinDefined('?');
+* ```
+*/ function joinDefined(delimiter, ...items) {
+	return items.map((item) => item instanceof Array ? item[1] ? item[0] : null : item).filter((item) => item != null).join(delimiter);
 }
 /**
- * Alias to joinList with a space delimiter.
- *
- * @param items -
- *        The items to join.
- *
- * @returns
- *        A string that joins the items that are defined, separated by space delimiter.
- *
- * @see
- *        {@link joinDefined} for more information and examples.
- */ const spaceJoinDefined = joinDefined.bind(null, " ");
-/**
- * Alias of spaceJoinList.
- *
- * @param items -
- *        The items to join.
- *
- * @returns
- *        A string that joins the items that are defined, separated by a space delimiter.
- *
- * @see
- *        {@link joinDefined} for more information and examples.
- */ const cssJoinDefined = spaceJoinDefined;
-/**
- * Alias of joinList with a comma delimiter.
- *
- * @param items -
- *        The items to join.
- *
- * @returns
- *        A string that joins the items that are defined, separated by a comma delimiter.
- *
- * @see
- *        {@link joinDefined} for more information and examples.
- */ const commaJoinDefined = joinDefined.bind(null, ",");
-/**
- * Alias of joinList with a semi-colon delimiter.
- *
- * @param items -
- *        The items to join.
- *
- * @returns
- *        A string that joins the items that are defined, separated by a semi-colon delimiter.
- *
- * @see
- *        {@link joinDefined} for more information and examples.
- */ const semiColonJoinDefined = joinDefined.bind(null, ";");
-/**
- * Alias of joinList with a pipe delimiter.
- *
- * @param items -
- *        The items to join.
- *
- * @returns
- *        A string that joins the items that are defined, separated by a pipe delimiter.
- *
- * @see
- *        {@link joinDefined} for more information and examples.
- */ const pipeJoinDefined = joinDefined.bind(null, "|");
-
-function _define_property$2(obj, key, value) {
-    if (key in obj) {
-        Object.defineProperty(obj, key, {
-            value: value,
-            enumerable: true,
-            configurable: true,
-            writable: true
-        });
-    } else {
-        obj[key] = value;
-    }
-    return obj;
-}
-class ZLazy {
-    initialized() {
-        return this._value != null;
-    }
-    async get() {
-        if (this._value == null) {
-            this._value = this._factory();
-        }
-        return this._value;
-    }
-    constructor(_factory){
-        _define_property$2(this, "_factory", void 0);
-        _define_property$2(this, "_value", void 0);
-        this._factory = _factory;
-    }
-}
-
-/**
- * A specific set of possible values that need to be checked for requirements.
- *
- * @param T -
- *        The type of value that is being checked.
- */ /**
- * Requires a value to be non null.
- *
- * @param val -
- *        The value to require.  This can be a promise
- *        that can return null or undefined in addition to the
- *        value.
- * @param T -
- *        The type of value that is being checked.
- *
- * @returns
- *        This method returns val if it is not null
- *        or undefined, otherwise, an error is thrown.
- *
- * @throws
- *        An error if the value is null or undefined.
- */ async function required(val) {
-    if (val == null) {
-        throw new Error("A required value was not provided");
-    }
-    const _val = await val;
-    if (_val == null) {
-        throw new Error("A required value was not provided");
-    }
-    return _val;
+* Alias to joinList with a space delimiter.
+*
+* @param items -
+*        The items to join.
+*
+* @returns
+*        A string that joins the items that are defined, separated by space delimiter.
+*
+* @see
+*        {@link joinDefined} for more information and examples.
+*/ var spaceJoinDefined = joinDefined.bind(null, " ");
+/**
+* Alias of spaceJoinList.
+*
+* @param items -
+*        The items to join.
+*
+* @returns
+*        A string that joins the items that are defined, separated by a space delimiter.
+*
+* @see
+*        {@link joinDefined} for more information and examples.
+*/ var cssJoinDefined = spaceJoinDefined;
+/**
+* Alias of joinList with a comma delimiter.
+*
+* @param items -
+*        The items to join.
+*
+* @returns
+*        A string that joins the items that are defined, separated by a comma delimiter.
+*
+* @see
+*        {@link joinDefined} for more information and examples.
+*/ var commaJoinDefined = joinDefined.bind(null, ",");
+/**
+* Alias of joinList with a semi-colon delimiter.
+*
+* @param items -
+*        The items to join.
+*
+* @returns
+*        A string that joins the items that are defined, separated by a semi-colon delimiter.
+*
+* @see
+*        {@link joinDefined} for more information and examples.
+*/ var semiColonJoinDefined = joinDefined.bind(null, ";");
+/**
+* Alias of joinList with a pipe delimiter.
+*
+* @param items -
+*        The items to join.
+*
+* @returns
+*        A string that joins the items that are defined, separated by a pipe delimiter.
+*
+* @see
+*        {@link joinDefined} for more information and examples.
+*/ var pipeJoinDefined = joinDefined.bind(null, "|");
+//#endregion
+//#region src/lazy/lazy.mts
+var ZLazy = class {
+	_factory;
+	_value;
+	constructor(_factory) {
+		this._factory = _factory;
+	}
+	initialized() {
+		return this._value != null;
+	}
+	async get() {
+		if (this._value == null) this._value = this._factory();
+		return this._value;
+	}
+};
+//#endregion
+//#region src/obligation/obligation.mts
+/**
+* A specific set of possible values that need to be checked for requirements.
+*
+* @param T -
+*        The type of value that is being checked.
+*/ /**
+* Requires a value to be non null.
+*
+* @param val -
+*        The value to require.  This can be a promise
+*        that can return null or undefined in addition to the
+*        value.
+* @param T -
+*        The type of value that is being checked.
+*
+* @returns
+*        This method returns val if it is not null
+*        or undefined, otherwise, an error is thrown.
+*
+* @throws
+*        An error if the value is null or undefined.
+*/ async function required(val) {
+	if (val == null) throw new Error("A required value was not provided");
+	const _val = await val;
+	if (_val == null) throw new Error("A required value was not provided");
+	return _val;
 }
 /**
- * Allows a value to be null or undefined and has a fallback.
- *
- * @param val -
- *        The value to check.  This can be a promise
- *        that can return null or undefined in addition to the
- *        value.
- * @param fallback -
- *        The fallback value in the case that val is
- *        null or undefined.
- * @param T -
- *        The type of value that is being checked.
- *
- * @returns
- *        This method returns val if it is not null
- *        or undefined, otherwise, the fallback is returned.
- *        If val is a promise and rejects, then fallback is
- *        also returned.
- */ async function optional(val, fallback = null) {
-    if (val == null) {
-        return fallback;
-    }
-    try {
-        const _val = await val;
-        return _val == null ? fallback : _val;
-    } catch  {
-        return fallback;
-    }
+* Allows a value to be null or undefined and has a fallback.
+*
+* @param val -
+*        The value to check.  This can be a promise
+*        that can return null or undefined in addition to the
+*        value.
+* @param fallback -
+*        The fallback value in the case that val is
+*        null or undefined.
+* @param T -
+*        The type of value that is being checked.
+*
+* @returns
+*        This method returns val if it is not null
+*        or undefined, otherwise, the fallback is returned.
+*        If val is a promise and rejects, then fallback is
+*        also returned.
+*/ async function optional(val, fallback = null) {
+	if (val == null) return fallback;
+	try {
+		const _val = await val;
+		return _val == null ? fallback : _val;
+	} catch {
+		return fallback;
+	}
 }
-
-/**
- * Represents a direction orientation.
- */ var ZOrientation = /*#__PURE__*/ function(ZOrientation) {
-    /**
-   * Horizontal orientation.
-   *
-   * This type of orientation is a row
-   * style orientation or flex-row orientation.
-   */ ZOrientation["Horizontal"] = "horizontal";
-    /**
-   * Vertical orientation.
-   *
-   * This type of orientation is a column
-   * style orientation or block orientation.
-   */ ZOrientation["Vertical"] = "vertical";
-    return ZOrientation;
+//#endregion
+//#region src/orientation/orientation.mts
+/**
+* Represents a direction orientation.
+*/ var ZOrientation = /* @__PURE__ */ function(ZOrientation) {
+	/**
+	* Horizontal orientation.
+	*
+	* This type of orientation is a row
+	* style orientation or flex-row orientation.
+	*/ ZOrientation["Horizontal"] = "horizontal";
+	/**
+	* Vertical orientation.
+	*
+	* This type of orientation is a column
+	* style orientation or block orientation.
+	*/ ZOrientation["Vertical"] = "vertical";
+	return ZOrientation;
 }({});
-
-/**
- * Peels a candidate string from the start of a string and splits it into two segments.
- *
- * @param str -
- *        The string to peel from.
- * @param candidates -
- *        The candidate list of values to peel from str.
- *
- * @returns
- *        A tuple where the first item is the peeled string and
- *        the second item is the remainder of the string.  If the string
- *        does not start with any given candidates, then the first
- *        item will be null and the second item will be str.
- */ function peel(str, candidates) {
-    for (const check of candidates){
-        if (str.startsWith(check)) {
-            return [
-                str.substring(0, check.length),
-                str.substring(check.length)
-            ];
-        }
-    }
-    return [
-        null,
-        str
-    ];
+//#endregion
+//#region src/peel/peel.mts
+/**
+* Peels a candidate string from the start of a string and splits it into two segments.
+*
+* @param str -
+*        The string to peel from.
+* @param candidates -
+*        The candidate list of values to peel from str.
+*
+* @returns
+*        A tuple where the first item is the peeled string and
+*        the second item is the remainder of the string.  If the string
+*        does not start with any given candidates, then the first
+*        item will be null and the second item will be str.
+*/ function peel(str, candidates) {
+	for (const check of candidates) if (str.startsWith(check)) return [str.substring(0, check.length), str.substring(check.length)];
+	return [null, str];
 }
 /**
- * Peels the values between an opening string set and a closing string set.
- *
- * The actual value will handle issues with internal opening and closing brackets
- *
- * @example
- *
- * ```ts
- * const [peeled, rest] = peelBetween('[a, b, [c1, c2],[d]] other', '[' ']');
- *
- * // Outputs 'a, b, [c1, c2], [d]'
- * console.log(peeled);
- *
- * // Outputs ' other' - white space is included'
- * console.log(rest);
- * ```
- *
- * @param str -
- *        The string to peel between.
- * @param open -
- *        The opening string.  This will test
- *        at the start of str.
- * @param close -
- *        The closing string.  This can be anywhere
- *        in the str.  If this is equal to open, then
- *        the open string is removed from the start of the
- *        string and the rest of the string would be returned.
- *
- * @returns
- *        A tuple where the first argument is string that was found between
- *        the opening and closing bracket. Returns null if no string could
- *        be found between an open and close pair.  The second argument will
- *        be the remaining text of the string, including whitespace.
- */ function peelBetween(str, open, close) {
-    if (!str.startsWith(open)) {
-        return [
-            null,
-            str
-        ];
-    }
-    let stack = 1;
-    const _str = str.substring(open.length);
-    for(let i = 0; i < _str.length; ++i){
-        if (_str.startsWith(open, i)) {
-            stack += 1;
-            i += open.length - 1;
-            continue;
-        }
-        if (_str.startsWith(close, i)) {
-            stack -= 1;
-            if (stack === 0) {
-                return [
-                    _str.substring(0, i),
-                    _str.substring(i + close.length)
-                ];
-            }
-            i += close.length - 1;
-        }
-    }
-    return [
-        null,
-        str
-    ];
+* Peels the values between an opening string set and a closing string set.
+*
+* The actual value will handle issues with internal opening and closing brackets
+*
+* @example
+*
+* ```ts
+* const [peeled, rest] = peelBetween('[a, b, [c1, c2],[d]] other', '[' ']');
+*
+* // Outputs 'a, b, [c1, c2], [d]'
+* console.log(peeled);
+*
+* // Outputs ' other' - white space is included'
+* console.log(rest);
+* ```
+*
+* @param str -
+*        The string to peel between.
+* @param open -
+*        The opening string.  This will test
+*        at the start of str.
+* @param close -
+*        The closing string.  This can be anywhere
+*        in the str.  If this is equal to open, then
+*        the open string is removed from the start of the
+*        string and the rest of the string would be returned.
+*
+* @returns
+*        A tuple where the first argument is string that was found between
+*        the opening and closing bracket. Returns null if no string could
+*        be found between an open and close pair.  The second argument will
+*        be the remaining text of the string, including whitespace.
+*/ function peelBetween(str, open, close) {
+	if (!str.startsWith(open)) return [null, str];
+	let stack = 1;
+	const _str = str.substring(open.length);
+	for (let i = 0; i < _str.length; ++i) {
+		if (_str.startsWith(open, i)) {
+			stack += 1;
+			i += open.length - 1;
+			continue;
+		}
+		if (_str.startsWith(close, i)) {
+			stack -= 1;
+			if (stack === 0) return [_str.substring(0, i), _str.substring(i + close.length)];
+			i += close.length - 1;
+		}
+	}
+	return [null, str];
 }
-
-/**
- * A function that reduces an object to keys and values that match a predicate.
- *
- * @param predicate -
- *        The predicate to match the key and value against.
- * @param target -
- *        The object to reduce.
- *
- * @returns
- *        A reduced object that only contains key-value pairs that match
- *        the predicate.
- */ function pickBy(predicate, target) {
-    const keys = Object.keys(target);
-    const reduced = {};
-    keys.forEach((key)=>{
-        const value = target[key];
-        if (predicate(key, value)) {
-            reduced[key] = value;
-        }
-    });
-    return reduced;
+//#endregion
+//#region src/pick/pick.mts
+/**
+* A function that reduces an object to keys and values that match a predicate.
+*
+* @param predicate -
+*        The predicate to match the key and value against.
+* @param target -
+*        The object to reduce.
+*
+* @returns
+*        A reduced object that only contains key-value pairs that match
+*        the predicate.
+*/ function pickBy(predicate, target) {
+	const keys = Object.keys(target);
+	const reduced = {};
+	keys.forEach((key) => {
+		const value = target[key];
+		if (predicate(key, value)) reduced[key] = value;
+	});
+	return reduced;
 }
 /**
- * An alias to pickBy with a predicate of (_, v) =&gt; v != null.
- *
- * @param target -
- *        The target object to reduce.
- *
- * @returns
- *        The reduced object.
- */ function pickDefined(target) {
-    return pickBy((_, v)=>v != null, target);
+* An alias to pickBy with a predicate of (_, v) =&gt; v != null.
+*
+* @param target -
+*        The target object to reduce.
+*
+* @returns
+*        The reduced object.
+*/ function pickDefined(target) {
+	return pickBy((_, v) => v != null, target);
 }
 /**
- * An alias to pickBy((k) =&gt; k.startsWith('data-')).
- *
- * @param target -
- *        The target object to reduce.
- *
- * @returns
- *        The reduced object.
- */ function pickDataAttributes(target) {
-    return pickBy((k)=>String(k).startsWith("data-"), target);
+* An alias to pickBy((k) =&gt; k.startsWith('data-')).
+*
+* @param target -
+*        The target object to reduce.
+*
+* @returns
+*        The reduced object.
+*/ function pickDataAttributes(target) {
+	return pickBy((k) => String(k).startsWith("data-"), target);
 }
 /**
- * An alias to pickBy((k) =&gt; k.startsWith('on')).
- *
- * @param target -
- *        The target object to reduce.
- *
- * @returns
- *        The reduced object.
- */ function pickEvents(target) {
-    return pickBy((k)=>String(k).startsWith("on"), target);
+* An alias to pickBy((k) =&gt; k.startsWith('on')).
+*
+* @param target -
+*        The target object to reduce.
+*
+* @returns
+*        The reduced object.
+*/ function pickEvents(target) {
+	return pickBy((k) => String(k).startsWith("on"), target);
 }
-
+//#endregion
+//#region src/purge/purge.mts
 function purge(obj, property) {
-    if (obj[property] === undefined) {
-        delete obj[property];
-    }
+	if (obj[property] === void 0) delete obj[property];
 }
-
-function _define_property$1(obj, key, value) {
-    if (key in obj) {
-        Object.defineProperty(obj, key, {
-            value: value,
-            enumerable: true,
-            configurable: true,
-            writable: true
-        });
-    } else {
-        obj[key] = value;
-    }
-    return obj;
-}
-/**
- * A deserializer that deserializes a JSON string.
- */ class ZDeserializeJson {
-    deserialize(candidate) {
-        const parsed = JSON.parse(candidate);
-        if (this._schema && !this._schema(parsed)) {
-            throw new Error("The parsed JSON does not conform to the given schema requirement");
-        }
-        return parsed;
-    }
-    constructor(_schema){
-        _define_property$1(this, "_schema", void 0);
-        this._schema = _schema;
-    }
-}
-
-function _define_property(obj, key, value) {
-    if (key in obj) {
-        Object.defineProperty(obj, key, {
-            value: value,
-            enumerable: true,
-            configurable: true,
-            writable: true
-        });
-    } else {
-        obj[key] = value;
-    }
-    return obj;
-}
-/**
- * A deserializer that attempts to deserialize multiple times through a series of supported languages.
- *
- * @param T -
- *        The type of data to deserialize.
- * @param S -
- *        The input type
- */ class ZDeserializeTry {
-    deserialize(candidate) {
-        const errors = [];
-        for (const child of this._children){
-            try {
-                return child.deserialize(candidate);
-            } catch (e) {
-                errors.push(e.message);
-            }
-        }
-        const msg = `Unable to deserialize candidate, ${candidate}.`;
-        errors.splice(0, 0, msg);
-        throw new Error(errors.join("\n\n"));
-    }
-    /**
-   * Initializes a new instance of this object.
-   *
-   * @param _children -
-   *        The list of deserializer objects to try on a specific candidate.
-   *        The first deserializer to succeed will return the target object.
-   *        If no deserializer is able to deserialize the candidate, then an
-   *        error is throw with a mapping of serialization errors between each
-   *        deserializer.
-   */ constructor(_children){
-        _define_property(this, "_children", void 0);
-        this._children = _children;
-    }
-}
-
-/**
- * Represents a serializer that serializes anything to a JSON string.
- */ class ZSerializeJson {
-    serialize(candidate) {
-        return JSON.stringify(candidate, undefined, 2);
-    }
-}
-
-/**
- * Represents a setter function for when you want to set a single value,
- * but you have an array instead.
- *
- * This is useful when you want to support lists of items, but you need
- * backwards compatibility for setting a single item. This is primarily meant
- * to be use with bind to construct a new method setter that takes an array
- * and forwards it to a setter method which will accept a single value of the
- * first item in the target value.
- *
- * @param setValue -
- *        The setter function that takes a single value.  This will receive
- *        the first item of the value list.
- * @param fallback -
- *        The fallback value in the case that there are no values.
- * @param value -
- *        The value list to retrieve the first item from.
- * @param T -
- *        The type of data that the array holds.
- *
- * @example
- *
- * ```ts
- * // An example of a react component that needs a value of an array, but you only care about a single selection.
- * const [value, setValue] = useState<TypesOfPie>();
- * const _values = useMemo(() => value ? [value] : [], [value]);
- * const _setValues = setFirst.bind(null, setValue, undefined);
- *
- * return <ComponentWithMultiSelectSupport values={_values} onValuesChange={_setValues} />
- * ```
- */ function setFirst(setValue, fallback, value) {
-    const _value = value?.length ? value[0] : fallback;
-    setValue(_value);
+//#endregion
+//#region src/serialize/deserialize-json.mts
+/**
+* A deserializer that deserializes a JSON string.
+*/ var ZDeserializeJson = class {
+	_schema;
+	constructor(_schema) {
+		this._schema = _schema;
+	}
+	deserialize(candidate) {
+		const parsed = JSON.parse(candidate);
+		if (this._schema && !this._schema(parsed)) throw new Error("The parsed JSON does not conform to the given schema requirement");
+		return parsed;
+	}
+};
+//#endregion
+//#region src/serialize/deserialize-try.mts
+/**
+* A deserializer that attempts to deserialize multiple times through a series of supported languages.
+*
+* @param T -
+*        The type of data to deserialize.
+* @param S -
+*        The input type
+*/ var ZDeserializeTry = class {
+	_children;
+	/**
+	* Initializes a new instance of this object.
+	*
+	* @param _children -
+	*        The list of deserializer objects to try on a specific candidate.
+	*        The first deserializer to succeed will return the target object.
+	*        If no deserializer is able to deserialize the candidate, then an
+	*        error is throw with a mapping of serialization errors between each
+	*        deserializer.
+	*/ constructor(_children) {
+		this._children = _children;
+	}
+	deserialize(candidate) {
+		const errors = [];
+		for (const child of this._children) try {
+			return child.deserialize(candidate);
+		} catch (e) {
+			errors.push(e.message);
+		}
+		const msg = `Unable to deserialize candidate, ${JSON.stringify(candidate)}.`;
+		errors.splice(0, 0, msg);
+		throw new Error(errors.join("\n\n"));
+	}
+};
+//#endregion
+//#region src/serialize/serialize-json.mts
+/**
+* Represents a serializer that serializes anything to a JSON string.
+*/ var ZSerializeJson = class {
+	serialize(candidate) {
+		return JSON.stringify(candidate, void 0, 2);
+	}
+};
+//#endregion
+//#region src/set-first/set-first.mts
+/**
+* Represents a setter function for when you want to set a single value,
+* but you have an array instead.
+*
+* This is useful when you want to support lists of items, but you need
+* backwards compatibility for setting a single item. This is primarily meant
+* to be use with bind to construct a new method setter that takes an array
+* and forwards it to a setter method which will accept a single value of the
+* first item in the target value.
+*
+* @param setValue -
+*        The setter function that takes a single value.  This will receive
+*        the first item of the value list.
+* @param fallback -
+*        The fallback value in the case that there are no values.
+* @param value -
+*        The value list to retrieve the first item from.
+* @param T -
+*        The type of data that the array holds.
+*
+* @example
+*
+* ```ts
+* // An example of a react component that needs a value of an array, but you only care about a single selection.
+* const [value, setValue] = useState<TypesOfPie>();
+* const _values = useMemo(() => value ? [value] : [], [value]);
+* const _setValues = setFirst.bind(null, setValue, undefined);
+*
+* return <ComponentWithMultiSelectSupport values={_values} onValuesChange={_setValues} />
+* ```
+*/ function setFirst(setValue, fallback, value) {
+	setValue(value?.length ? value[0] : fallback);
 }
-
-/**
- * Halts the current thread to invoke an event loop.
- *
- * @param ms -
- *        The total number of milliseconds to sleep.
- *
- * @returns
- *        A promise that resolves after ms milliseconds.
- */ /**
- * Halts the current thread to invoke an event loop.
- *
- * @param ms -
- *        The total number of milliseconds to sleep.
- * @param T -
- *        The type of value that will be resolved.
- *
- * @returns
- *        A promise that resolves with val after ms milliseconds.
- */ function sleep(ms = 0, val = undefined) {
-    return new Promise((resolve)=>setTimeout(()=>resolve(val), ms));
+//#endregion
+//#region src/sleep/sleep.mts
+/**
+* Halts the current thread to invoke an event loop.
+*
+* @param ms -
+*        The total number of milliseconds to sleep.
+*
+* @returns
+*        A promise that resolves after ms milliseconds.
+*/ /**
+* Halts the current thread to invoke an event loop.
+*
+* @param ms -
+*        The total number of milliseconds to sleep.
+* @param T -
+*        The type of value that will be resolved.
+*
+* @returns
+*        A promise that resolves with val after ms milliseconds.
+*/ function sleep(ms = 0, val = void 0) {
+	return new Promise((resolve) => setTimeout(() => resolve(val), ms));
 }
-
-/**
- * This is just a method that allows you to tag an interpolation
- * string as a syntax language.
- *
- * This is useful with IDE extensions that can detect the language
- * and do the syntax highlighting for you.
- *
- * @param strings -
- *        The string breaks for interpolation.
- * @param expressions -
- *        The equivalent expressions that break apart
- *        the single string literal.
- *
- * @returns
- *        The compiled string literal.  This is no different
- *        than letting native JavaScript do it for you.
- *
- * @example
- *
- * ```ts
- * const html = tag;
- * const css = tag;
- *
- * const $html = html`
- *  <div>Some IDE extensions will highlight this as html</div>
- * `
- *
- * const $css = css`
- *   button {
- *     display: grid;
- *   }
- * `
- * ```
- */ function tag(strings, ...expressions) {
-    let [result] = strings;
-    for(let i = 1, l = strings.length; i < l; i++){
-        result += expressions[i - 1];
-        result += strings[i];
-    }
-    return result;
+//#endregion
+//#region src/tag/tag.mts
+/**
+* This is just a method that allows you to tag an interpolation
+* string as a syntax language.
+*
+* This is useful with IDE extensions that can detect the language
+* and do the syntax highlighting for you.
+*
+* @param strings -
+*        The string breaks for interpolation.
+* @param expressions -
+*        The equivalent expressions that break apart
+*        the single string literal.
+*
+* @returns
+*        The compiled string literal.  This is no different
+*        than letting native JavaScript do it for you.
+*
+* @example
+*
+* ```ts
+* const html = tag;
+* const css = tag;
+*
+* const $html = html`
+*  <div>Some IDE extensions will highlight this as html</div>
+* `
+*
+* const $css = css`
+*   button {
+*     display: grid;
+*   }
+* `
+* ```
+*/ function tag(strings, ...expressions) {
+	let [result] = strings;
+	for (let i = 1, l = strings.length; i < l; i++) {
+		result += String(expressions[i - 1]);
+		result += strings[i];
+	}
+	return result;
 }
 /**
- * An alias for {@link tag}.
- *
- * Some {@link https://marketplace.visualstudio.com/items?itemName=Tobermory.es6-string-html | IDE extensions will detect the string}
- * interpolation as html when using this tag.
- */ const html = tag;
-/**
- * An alias for {@link tag}.
- *
- * Some {@link https://marketplace.visualstudio.com/items?itemName=bashmish.es6-string-css | IDE extensions will detect the string}
- * interpolation as css when using this tag.
- */ const css = tag;
-/**
- * An alias for {@link tag}.
- *
- * Some {@link https://marketplace.visualstudio.com/items?itemName=zjcompt.es6-string-javascript | IDE extensions will detect the string}
- * interpolation as javascript when using this tag.
- */ const js = tag;
-/**
- * See {@link js}
- */ const javascript = tag;
-/**
- * An alias for {@link tag}.
- *
- * Some {@link https://marketplace.visualstudio.com/items?itemName=jeoht.es6-string-markdown | IDE extensions will detect the string}
- * interpolation as markdown when using this tag.
- */ const md = tag;
-/**
- * See {@link md}
- */ const markdown = tag;
-/**
- * An alias for {@link tag}.
- *
- * Some {@link https://marketplace.visualstudio.com/items?itemName=HoodieCollin.es6-string-typescript | IDE extensions will detect the string}
- * interpolation as typescript when using this tag.
- */ const ts = tag;
-/**
- * See {@link ts}
- */ const typescript = tag;
-/**
- * An alias for {@link tag}.
- */ const sh = tag;
-/**
- * An alias for {@link tag}.
- */ const bash = tag;
-/**
- * An alias for {@link tag}.
- */ const zsh = tag;
-
-/**
- * Invokes the candidate function and returns undefined if an error is thrown from it.
- *
- * @param candidate -
- *        The candidate function to run.
- *
- * @returns
- *        The result from candidate.  Returns undefined if candidate throws an Error.
- */ /**
- * Invokes the candidate function and returns fallback if an error is thrown from it.
- *
- * @param candidate -
- *        The candidate function to run.
- * @param fallback -
- *        The fallback value to return if candidate throws an error.
- *
- * @returns
- *        The result from candidate.  Returns fallback if candidate throws an Error.
- *        If no fallback value is provided, then undefined is returned.
- */ function tryFallback(candidate, fallback) {
-    try {
-        return candidate();
-    } catch  {
-        return fallback;
-    }
+* An alias for {@link tag}.
+*
+* Some {@link https://marketplace.visualstudio.com/items?itemName=Tobermory.es6-string-html | IDE extensions will detect the string}
+* interpolation as html when using this tag.
+*/ var html = tag;
+/**
+* An alias for {@link tag}.
+*
+* Some {@link https://marketplace.visualstudio.com/items?itemName=bashmish.es6-string-css | IDE extensions will detect the string}
+* interpolation as css when using this tag.
+*/ var css = tag;
+/**
+* An alias for {@link tag}.
+*
+* Some {@link https://marketplace.visualstudio.com/items?itemName=zjcompt.es6-string-javascript | IDE extensions will detect the string}
+* interpolation as javascript when using this tag.
+*/ var js = tag;
+/**
+* See {@link js}
+*/ var javascript = tag;
+/**
+* An alias for {@link tag}.
+*
+* Some {@link https://marketplace.visualstudio.com/items?itemName=jeoht.es6-string-markdown | IDE extensions will detect the string}
+* interpolation as markdown when using this tag.
+*/ var md = tag;
+/**
+* See {@link md}
+*/ var markdown = tag;
+/**
+* An alias for {@link tag}.
+*
+* Some {@link https://marketplace.visualstudio.com/items?itemName=HoodieCollin.es6-string-typescript | IDE extensions will detect the string}
+* interpolation as typescript when using this tag.
+*/ var ts = tag;
+/**
+* See {@link ts}
+*/ var typescript = tag;
+/**
+* An alias for {@link tag}.
+*/ var sh = tag;
+/**
+* An alias for {@link tag}.
+*/ var bash = tag;
+/**
+* An alias for {@link tag}.
+*/ var zsh = tag;
+//#endregion
+//#region src/try/try-fallback.mts
+/**
+* Invokes the candidate function and returns undefined if an error is thrown from it.
+*
+* @param candidate -
+*        The candidate function to run.
+*
+* @returns
+*        The result from candidate.  Returns undefined if candidate throws an Error.
+*/ /**
+* Invokes the candidate function and returns fallback if an error is thrown from it.
+*
+* @param candidate -
+*        The candidate function to run.
+* @param fallback -
+*        The fallback value to return if candidate throws an error.
+*
+* @returns
+*        The result from candidate.  Returns fallback if candidate throws an Error.
+*        If no fallback value is provided, then undefined is returned.
+*/ function tryFallback(candidate, fallback) {
+	try {
+		return candidate();
+	} catch {
+		return fallback;
+	}
 }
 /**
- * Invokes the candidate function and returns undefined if an rejected promise is returned from it.
- *
- * @param candidate -
- *        The candidate function to run.
- * @param fallback -
- *        The optional fallback value to return if the candidate throws an Error.
- *
- * @returns
- *        A promise that resolves with the result from candidate or fallback
- *        if candidate returns a rejected promise.  Resolves with undefined
- *        if no fallback is provided.
- */ async function tryFallbackAsync(candidate, fallback) {
-    try {
-        return await candidate();
-    } catch  {
-        return fallback;
-    }
+* Invokes the candidate function and returns undefined if an rejected promise is returned from it.
+*
+* @param candidate -
+*        The candidate function to run.
+* @param fallback -
+*        The optional fallback value to return if the candidate throws an Error.
+*
+* @returns
+*        A promise that resolves with the result from candidate or fallback
+*        if candidate returns a rejected promise.  Resolves with undefined
+*        if no fallback is provided.
+*/ async function tryFallbackAsync(candidate, fallback) {
+	try {
+		return await candidate();
+	} catch {
+		return fallback;
+	}
 }
-
-/**
- * Attempts to parse the string buffer as json.
- *
- * This is similar to JSON.parse, but instead of throwing
- * an error, it returns the fallback.
- *
- * @param buffer -
- *        The string buffer that may be json.
- * @param fallback -
- *        The fallback value in the case that buffer
- *        cannot be parsed.  Note that parsing the text
- *        "null" will return null instead of the fallback.
- *        The default value for this is null.
- *
- * @returns
- *        The parsed value of the buffer when parsed as JSON. If
- *        buffer is null, undefined, or does not represent valid
- *        JSON, then the fallback is returned.
- */ function tryJsonParse(buffer, fallback = null) {
-    if (buffer == null) {
-        return fallback;
-    }
-    // This is not really necessary because it is handled in the
-    // JSON.parse method, but this avoids parsing random binary data.
-    // If someone tries to read a buffer that's 300MB, there's no point
-    // trying to parse it if it's just random binary data.  This can
-    // still happen if the first binary character is { or [, but
-    // most situations won't have this happen.
-    const [firstChar] = buffer;
-    if (firstChar !== "{" && firstChar !== "[") {
-        return fallback;
-    }
-    return tryFallback(()=>JSON.parse(buffer), fallback);
+//#endregion
+//#region src/try/try-json-parse.mts
+/**
+* Attempts to parse the string buffer as json.
+*
+* This is similar to JSON.parse, but instead of throwing
+* an error, it returns the fallback.
+*
+* @param buffer -
+*        The string buffer that may be json.
+* @param fallback -
+*        The fallback value in the case that buffer
+*        cannot be parsed.  Note that parsing the text
+*        "null" will return null instead of the fallback.
+*        The default value for this is null.
+*
+* @returns
+*        The parsed value of the buffer when parsed as JSON. If
+*        buffer is null, undefined, or does not represent valid
+*        JSON, then the fallback is returned.
+*/ function tryJsonParse(buffer, fallback = null) {
+	if (buffer == null) return fallback;
+	const [firstChar] = buffer;
+	if (firstChar !== "{" && firstChar !== "[") return fallback;
+	return tryFallback(() => JSON.parse(buffer), fallback);
 }
-
+//#endregion
 exports.$global = $global;
 exports.ZAssert = ZAssert;
 exports.ZDateFormats = ZDateFormats;
@@ -2221,4 +1990,5 @@ exports.ts = ts;
 exports.typescript = typescript;
 exports.userTimeZone = userTimeZone;
 exports.zsh = zsh;
-//# sourceMappingURL=index.cjs.map
+
+//# sourceMappingURL=index.cjs.map