@design-edito/tools 0.3.9 → 0.3.10

package/agnostic/misc/data-size/index.js

@@ -67,7 +67,7 @@ var DataSize = class {
     if (this.unit === "exbibyte") return this.value * 8 * Math.pow(1024, 6);
     return this.value;
   }
-  /* * * * * * * * * * * * * * * * * * 
+  /* * * * * * * * * * * * * * * * * *
    * Decimal unit converters
    * * * * * * * * * * * * * * * * * */
   toBytes() {
@@ -98,7 +98,7 @@ var DataSize = class {
     return this.toBytes() / 1e18;
   }
   toEB = this.toExabytes.bind(this);
-  /* * * * * * * * * * * * * * * * * * 
+  /* * * * * * * * * * * * * * * * * *
    * Binary unit converters
    * * * * * * * * * * * * * * * * * */
   toKibibytes() {

package/agnostic/misc/index.d.ts

@@ -1,12 +1,12 @@
-export * as connection from './connection/index.js'
-export * as cast from './cast/index.js'
 export * as assert from './assert/index.js'
+export * as cast from './cast/index.js'
+export * as connection from './connection/index.js'
 export * as crawler from './crawler/index.js'
 export * as dataSize from './data-size/index.js'
-export * as isNullish from './is-nullish/index.js'
 export * as isConstructorFunction from './is-constructor-function/index.js'
-export * as logs from './logs/index.js'
-export * as loremIpsum from './lorem-ipsum/index.js'
 export * as crossenv from './crossenv/index.js'
+export * as isNullish from './is-nullish/index.js'
+export * as logs from './logs/index.js'
 export * as outcome from './outcome/index.js'
+export * as loremIpsum from './lorem-ipsum/index.js'
 export * as normalizeExtension from './normalize-extension/index.js'

package/agnostic/misc/index.js

@@ -1,12 +1,12 @@
-export * as connection from './connection/index.js'
-export * as cast from './cast/index.js'
 export * as assert from './assert/index.js'
+export * as cast from './cast/index.js'
+export * as connection from './connection/index.js'
 export * as crawler from './crawler/index.js'
 export * as dataSize from './data-size/index.js'
-export * as isNullish from './is-nullish/index.js'
 export * as isConstructorFunction from './is-constructor-function/index.js'
-export * as logs from './logs/index.js'
-export * as loremIpsum from './lorem-ipsum/index.js'
 export * as crossenv from './crossenv/index.js'
+export * as isNullish from './is-nullish/index.js'
+export * as logs from './logs/index.js'
 export * as outcome from './outcome/index.js'
+export * as loremIpsum from './lorem-ipsum/index.js'
 export * as normalizeExtension from './normalize-extension/index.js'

package/agnostic/misc/is-constructor-function/index.d.ts

@@ -3,7 +3,7 @@
  *
  * @template T - The type of object constructed by the function.
  */
-export type ConstructorFunction<T extends any = any> = new (...args: any[]) => T;
+export type ConstructorFunction<T = any> = new (...args: any[]) => T;
 /**
  * Checks whether a given value is a constructor function (i.e., a class or function with a prototype).
  *

package/agnostic/misc/logs/index.d.ts

@@ -1,3 +1,3 @@
 export * as logger from './logger/index.js'
-export * as makeTextBlock from './make-text-block/index.js'
 export * as styles from './styles/index.js'
+export * as makeTextBlock from './make-text-block/index.js'

package/agnostic/misc/logs/index.js

@@ -1,3 +1,3 @@
 export * as logger from './logger/index.js'
-export * as makeTextBlock from './make-text-block/index.js'
 export * as styles from './styles/index.js'
+export * as makeTextBlock from './make-text-block/index.js'

package/agnostic/misc/logs/logger/index.d.ts

@@ -29,7 +29,7 @@ declare class Log<T extends ConsoleMethod = ConsoleMethod> {
     get displayStack(): string;
 }
 export declare class Logger {
-    _private_threads: Map<string, Log[]>;
+    _private_threads: Map<string, Log<ConsoleMethod>[]>;
     constructor();
     dir(thread?: string, ...args: ConsoleMethodsParams['dir']): void;
     error(thread?: string, ...args: ConsoleMethodsParams['error']): void;

package/agnostic/misc/outcome/index.d.ts

@@ -5,7 +5,7 @@
  * @property {true} success - Always `true`.
  * @property {Payload} payload - The success value.
  */
-export type Success<Payload extends any = any> = {
+export type Success<Payload = any> = {
     success: true;
     payload: Payload;
 };
@@ -16,7 +16,7 @@ export type Success<Payload extends any = any> = {
  * @property {false} success - Always `false`.
  * @property {Error} error - The error value.
  */
-export type Failure<Error extends any = any> = {
+export type Failure<Error = any> = {
     success: false;
     error: Error;
 };
@@ -26,7 +26,7 @@ export type Failure<Error extends any = any> = {
  * @template Payload - Type of success payload.
  * @template Error - Type of error.
  */
-export type Either<Payload extends any = any, Error extends any = any> = Success<Payload> | Failure<Error>;
+export type Either<Payload = any, Error = any> = Success<Payload> | Failure<Error>;
 /**
  * Creates a success outcome with the given payload.
  *
@@ -34,7 +34,7 @@ export type Either<Payload extends any = any, Error extends any = any> = Success
  * @param {Payload} payload - The success value.
  * @returns {Success<Payload>} A success outcome object.
  */
-export declare function makeSuccess<Payload extends any>(payload: Payload): Success<Payload>;
+export declare function makeSuccess<Payload>(payload: Payload): Success<Payload>;
 /**
  * Creates a failure outcome with the given error.
  *
@@ -42,7 +42,7 @@ export declare function makeSuccess<Payload extends any>(payload: Payload): Succ
  * @param {Error} error - The error value.
  * @returns {Failure<Error>} A failure outcome object.
  */
-export declare function makeFailure<Error extends any>(error: Error): Failure<Error>;
+export declare function makeFailure<Error>(error: Error): Failure<Error>;
 /**
  * Creates either a success or failure outcome based on a boolean flag.
  *
@@ -52,5 +52,5 @@ export declare function makeFailure<Error extends any>(error: Error): Failure<Er
  * @param {Payload | Error} payloadOrError - The payload if success, or the error if failure.
  * @returns {Either<Payload, Error>} The resulting outcome.
  */
-export declare function make<Payload extends any>(success: true, payload: Payload): Success<Payload>;
-export declare function make<Error extends any>(success: false, error: Error): Failure<Error>;
+export declare function make<Payload>(success: true, payload: Payload): Success<Payload>;
+export declare function make<Error>(success: false, error: Error): Failure<Error>;

package/agnostic/numbers/approximate-rational/index.js

@@ -44,8 +44,10 @@ function approximateRationalDumb(target, maxRounds) {
 function approximateRational(target, maxDenominator = 1e3) {
   const sign = target < 0 ? -1 : 1;
   const absTarget = Math.abs(target);
-  let h1 = 1, h2 = 0;
-  let k1 = 0, k2 = 1;
+  let h1 = 1;
+  let h2 = 0;
+  let k1 = 0;
+  let k2 = 1;
   let b = absTarget;
   do {
     const a = Math.floor(b);

package/agnostic/numbers/index.d.ts

@@ -1,6 +1,6 @@
-export * as absoluteModulo from './absolute-modulo/index.js'
+export * as approximateRational from './approximate-rational/index.js'
 export * as clamp from './clamp/index.js'
+export * as absoluteModulo from './absolute-modulo/index.js'
+export * as interpolate from './interpolate/index.js'
 export * as geometricProgressions from './geometric-progressions/index.js'
-export * as approximateRational from './approximate-rational/index.js'
 export * as round from './round/index.js'
-export * as interpolate from './interpolate/index.js'

package/agnostic/numbers/index.js

@@ -1,6 +1,6 @@
-export * as absoluteModulo from './absolute-modulo/index.js'
+export * as approximateRational from './approximate-rational/index.js'
 export * as clamp from './clamp/index.js'
+export * as absoluteModulo from './absolute-modulo/index.js'
+export * as interpolate from './interpolate/index.js'
 export * as geometricProgressions from './geometric-progressions/index.js'
-export * as approximateRational from './approximate-rational/index.js'
 export * as round from './round/index.js'
-export * as interpolate from './interpolate/index.js'

package/agnostic/objects/deep-get-property/index.js

@@ -6,14 +6,14 @@ function deepGetProperty(anythingThatHasProperties, pathString) {
   let returned = currentObject;
   pathChunks.forEach((chunk, pos) => {
     const isLast = pos === pathChunks.length - 1;
-    if (!isRecord(currentObject)) throw "PROPERTY_UNREACHABLE";
+    if (!isRecord(currentObject)) throw new Error("PROPERTY_UNREACHABLE");
     if (isLast) {
       const val = currentObject[chunk];
       returned = val;
     } else {
       const found = currentObject[chunk];
       if (isRecord(found)) currentObject = found;
-      else throw "PROPERTY_UNREACHABLE";
+      else throw new Error("PROPERTY_UNREACHABLE");
     }
   });
   return returned;

package/agnostic/objects/flatten-getters/index.js

@@ -5,7 +5,8 @@ function flattenGetters(obj) {
   ).filter(([_, desc]) => typeof desc.get === "function").map(([key]) => key);
   const returned = { ...obj };
   getters.forEach((getter) => {
-    returned[getter] = obj[getter];
+    const key = getter;
+    returned[getter] = obj[key];
   });
   return returned;
 }

package/agnostic/objects/index.d.ts

@@ -1,8 +1,9 @@
-export * as deepGetProperty from './deep-get-property/index.js'
+export * as enums from './enums/index.js'
 export * as flattenGetters from './flatten-getters/index.js'
 export * as isObject from './is-object/index.js'
 export * as isRecord from './is-record/index.js'
+export * as deepGetProperty from './deep-get-property/index.js'
+export * as recordMap from './record-map/index.js'
+export * as sortKeys from './sort-keys/index.js'
 export * as recordFormat from './record-format/index.js'
 export * as validation from './validation/index.js'
-export * as recordMap from './record-map/index.js'
-export * as enums from './enums/index.js'

package/agnostic/objects/index.js

@@ -1,8 +1,9 @@
-export * as deepGetProperty from './deep-get-property/index.js'
+export * as enums from './enums/index.js'
 export * as flattenGetters from './flatten-getters/index.js'
 export * as isObject from './is-object/index.js'
 export * as isRecord from './is-record/index.js'
+export * as deepGetProperty from './deep-get-property/index.js'
+export * as recordMap from './record-map/index.js'
+export * as sortKeys from './sort-keys/index.js'
 export * as recordFormat from './record-format/index.js'
 export * as validation from './validation/index.js'
-export * as recordMap from './record-map/index.js'
-export * as enums from './enums/index.js'

package/agnostic/objects/record-format/index.js

@@ -3,6 +3,7 @@ async function recordFormat(input, format) {
   const result = {};
   for (const key in format) {
     const formatter = format[key];
+    if (formatter === void 0) continue;
     result[key] = await formatter(input[key]);
   }
   return result;

package/agnostic/objects/sort-keys/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Returns a new object with the keys sorted according to the provided sorter.
+ *
+ * @template T - The type of the input object.
+ * @param {T} obj - The object whose keys should be sorted.
+ * @param {(a: keyof T, b: keyof T) => number} [sorter] - Optional function used to compare keys for sorting. Defaults to alphabetical order.
+ * @returns {{ [K in keyof T]: T[K] }} A new object with the same keys and values as the input, but sorted by key.
+ */
+export declare function sortKeys<T extends Record<string, unknown>>(obj: T, sorter?: (a: keyof T, b: keyof T) => number): {
+    [K in keyof T]: T[K];
+};

package/agnostic/objects/sort-keys/index.js

@@ -0,0 +1,12 @@
+// src/agnostic/objects/sort-keys/index.ts
+function sortKeys(obj, sorter = (a, b) => String(a).localeCompare(String(b))) {
+  const out = {};
+  const keys = Object.keys(obj);
+  for (const key of keys.sort(sorter)) {
+    out[key] = obj[key];
+  }
+  return out;
+}
+export {
+  sortKeys
+};

package/agnostic/objects/sort-keys/index.test.d.ts

@@ -0,0 +1 @@
+export {};

package/agnostic/optim/memoize/index.js

@@ -3,7 +3,7 @@ function memoize(toMemoizeFunc) {
   let cachedArgs;
   let cachedResult;
   const memoizedFunc = (...args) => {
-    const argsMatch = cachedArgs !== void 0 && args.length === cachedArgs.length && args.every((arg, i) => arg === cachedArgs[i]);
+    const argsMatch = cachedArgs !== void 0 && args.length === cachedArgs.length && args.every((arg, i) => arg === cachedArgs?.[i]);
     if (argsMatch && cachedResult !== void 0) return cachedResult.value;
     const result = toMemoizeFunc(...args);
     cachedArgs = args;

package/agnostic/optim/throttle-debounce/index.d.ts

@@ -1,10 +1,5 @@
 type BasicFunction = (...args: any[]) => any;
-/**
- * Returns a throttled version of the function passed as an argument
- * @param toThrottleFunc - The function that has to be throttled
- * @param delayMs - The throttle delay in ms
- */
-export declare function throttle<T extends BasicFunction = BasicFunction>(toThrottleFunc: T, delayMs: number): {
+type ThrottledResult<T extends BasicFunction> = {
     throttled: (...args: any[]) => {
         returnValue: ReturnType<T> | undefined;
         lastExecutedOn: number;
@@ -14,11 +9,12 @@ export declare function throttle<T extends BasicFunction = BasicFunction>(toThro
     setDelay: (delayMs: number) => void;
 };
 /**
- * Returns a debounced version of the function passed as an argument
- * @param toDebounceFunc - The function that has to be debounced
- * @param delayMs - The debounce delay in ms
+ * Returns a throttled version of the function passed as an argument
+ * @param toThrottleFunc - The function that has to be throttled
+ * @param delayMs - The throttle delay in ms
  */
-export declare function debounce<T extends BasicFunction = BasicFunction>(toDebounceFunc: T, delayMs: number): {
+export declare function throttle<T extends BasicFunction = BasicFunction>(toThrottleFunc: T, delayMs: number): ThrottledResult<T>;
+type DebounceResult<T extends BasicFunction> = {
     debounced: (...args: any[]) => {
         returnValue: ReturnType<T> | undefined;
         lastExecutedOn: number;
@@ -27,4 +23,10 @@ export declare function debounce<T extends BasicFunction = BasicFunction>(toDebo
     };
     setDelay: (delayMs: number) => void;
 };
+/**
+ * Returns a debounced version of the function passed as an argument
+ * @param toDebounceFunc - The function that has to be debounced
+ * @param delayMs - The debounce delay in ms
+ */
+export declare function debounce<T extends BasicFunction = BasicFunction>(toDebounceFunc: T, delayMs: number): DebounceResult<T>;
 export {};

package/agnostic/optim/throttle-debounce/index.js

@@ -3,7 +3,7 @@ function throttle(toThrottleFunc, delayMs) {
   let currentDelayMs = delayMs;
   let lastArgs = [];
   let lastExecutedOn = 0;
-  let lastReturnValue = void 0;
+  let lastReturnValue;
   let nextExecutionTimeout = null;
   function scheduleNextCall() {
     if (nextExecutionTimeout !== null) {
@@ -56,7 +56,7 @@ function debounce(toDebounceFunc, delayMs) {
   let lastArgs = [];
   let lastCalledOn = 0;
   let lastExecutedOn = 0;
-  let lastReturnValue = void 0;
+  let lastReturnValue;
   let nextExecutionTimeout = null;
   function scheduleNextCall() {
     if (nextExecutionTimeout !== null) {

package/agnostic/optim/throttle-debounce/types.d.ts

@@ -1,2 +1,2 @@
-import { setTimeout } from 'node:timers';
+import { type setTimeout } from 'node:timers';
 export type NodeTimeout = ReturnType<typeof setTimeout>;

package/agnostic/random/index.d.ts

@@ -1,3 +1,3 @@
 export * as hexChar from './hex-char/index.js'
-export * as uuid from './uuid/index.js'
 export * as random from './random/index.js'
+export * as uuid from './uuid/index.js'

package/agnostic/random/index.js

@@ -1,3 +1,3 @@
 export * as hexChar from './hex-char/index.js'
-export * as uuid from './uuid/index.js'
 export * as random from './random/index.js'
+export * as uuid from './uuid/index.js'

package/agnostic/random/random/index.js

@@ -1,7 +1,7 @@
 // src/agnostic/random/random/index.ts
 function random(bound1 = 1, bound2) {
   const min = bound2 === void 0 ? 0 : bound1;
-  const max = bound2 === void 0 ? bound1 : bound2;
+  const max = bound2 ?? bound1;
   if (min === max || min > max) return void 0;
   const range = max - min;
   return Math.random() * range + min;

package/agnostic/sanitization/html/index.js

@@ -27,12 +27,12 @@ function sanitizeElement(element, options = defaultOptions) {
   const normalizedTagName = tagName.toLowerCase().trim();
   const tagIsInForbidden = forbiddenTags.includes("*") || forbiddenTags.includes(normalizedTagName);
   if (tagIsInForbidden) {
-    if (verbose === true) console.warn(tagName, "tag is forbidden");
+    if (verbose) console.warn(tagName, "tag is forbidden");
     return null;
   }
   const tagIsInAllowed = allowedTags.includes("*") || allowedTags.includes(normalizedTagName);
   if (!tagIsInAllowed) {
-    if (verbose === true) console.warn(tagName, "tag is not allowed");
+    if (verbose) console.warn(tagName, "tag is not allowed");
     return null;
   }
   const returnedElement = Window.get().document.createElement(tagName);
@@ -47,20 +47,20 @@ function sanitizeElement(element, options = defaultOptions) {
       if (typeof nameTester === "string" && nameTester !== "*" && attributeName !== nameTester) return false;
       if (typeof nameTester !== "string" && !nameTester.test(attributeName)) return false;
       if (valTesters === void 0) {
-        if (verbose === true) console.warn(attributeName, "attribute on", tagName, "tag is forbidden");
+        if (verbose) console.warn(attributeName, "attribute on", tagName, "tag is forbidden");
         return true;
       }
       if (valTesters.includes("*")) {
-        if (verbose === true) console.warn(attributeName, "attribute on", tagName, "tag is forbidden");
+        if (verbose) console.warn(attributeName, "attribute on", tagName, "tag is forbidden");
         return true;
       }
       return valTesters.some((valTester) => {
         if (typeof valTester === "string" && attributeValue === valTester) {
-          if (verbose === true) console.warn(attributeValue, "value for", attributeName, "attribute on", tagName, "tag is forbidden. Rule:", valTester);
+          if (verbose) console.warn(attributeValue, "value for", attributeName, "attribute on", tagName, "tag is forbidden. Rule:", valTester);
           return true;
         }
         if (typeof valTester !== "string" && valTester.test(attributeValue)) {
-          if (verbose === true) console.warn(attributeValue, "value for", attributeName, "attribute on", tagName, "tag is forbidden. Rule:", valTester);
+          if (verbose) console.warn(attributeValue, "value for", attributeName, "attribute on", tagName, "tag is forbidden. Rule:", valTester);
           return true;
         }
         return false;
@@ -93,7 +93,7 @@ function sanitizeElement(element, options = defaultOptions) {
       });
     });
     if (!isInAllowed) {
-      if (verbose === true) console.warn(...latestNotAllowedReason);
+      if (verbose) console.warn(...latestNotAllowedReason);
       return false;
     }
     return true;

package/agnostic/sanitization/index.d.ts

@@ -1,4 +1,4 @@
-export * as fileName from './file-name/index.js'
-export * as html from './html/index.js'
 export * as path from './path/index.js'
+export * as html from './html/index.js'
+export * as fileName from './file-name/index.js'
 export * as userInput from './user-input/index.js'

package/agnostic/sanitization/index.js

@@ -1,4 +1,4 @@
-export * as fileName from './file-name/index.js'
-export * as html from './html/index.js'
 export * as path from './path/index.js'
+export * as html from './html/index.js'
+export * as fileName from './file-name/index.js'
 export * as userInput from './user-input/index.js'

package/agnostic/sanitization/types.d.ts

@@ -26,12 +26,8 @@ export type SanitizeHtmlOptions = {
     keepComments?: boolean;
     allowedTags?: string[];
     forbiddenTags?: string[];
-    allowedAttributes?: {
-        [tagName: string]: AttributeNameValPair[];
-    };
-    forbiddenAttributes?: {
-        [tagName: string]: AttributeNameValPair[];
-    };
+    allowedAttributes?: Record<string, AttributeNameValPair[]>;
+    forbiddenAttributes?: Record<string, AttributeNameValPair[]>;
     depth?: number;
     verbose?: boolean;
 };

package/agnostic/strings/char-codes/index.d.ts

@@ -43,25 +43,25 @@ export declare function charFromB36CharCode(b36CharCode: B36CharCode): string;
  * @param string - Input string.
  * @returns Array of character codes.
  */
-export declare function toCharCodes(string: string): Array<CharCode>;
+export declare function toCharCodes(string: string): CharCode[];
 /**
  * Converts a string into an array of base-36 encoded character codes.
  * @param string - Input string.
  * @returns Array of base-36 character codes.
  */
-export declare function toB36CharCodes(string: string): Array<B36CharCode>;
+export declare function toB36CharCodes(string: string): B36CharCode[];
 /**
  * Converts an array of Unicode character codes back to a string.
  * @param charCodes - Array of character codes.
  * @returns Reconstructed string.
  */
-export declare function fromCharCodes(charCodes: Array<CharCode>): string;
+export declare function fromCharCodes(charCodes: CharCode[]): string;
 /**
  * Converts an array of base-36 encoded character codes back to a string.
  * @param b36CharCodes - Array of base-36 character codes.
  * @returns Reconstructed string.
  */
-export declare function fromB36CharCodes(b36CharCodes: Array<B36CharCode>): string;
+export declare function fromB36CharCodes(b36CharCodes: B36CharCode[]): string;
 /**
  * Serializes an array of character codes (Unicode or base-36) into a string.
  * @param charCodes - Array of character codes to serialize.
@@ -73,7 +73,7 @@ export declare function serialize(charCodes: Array<CharCode | B36CharCode>): str
  * @param serializedCharCodes - Serialized string.
  * @returns Array of Unicode character codes.
  */
-export declare function deserialize(serializedCharCodes: string): Array<CharCode>;
+export declare function deserialize(serializedCharCodes: string): CharCode[];
 /**
  * Deserializes a string of base-36 character codes and reconstructs the original string.
  * @param serializedCharCodes - Serialized string.

package/agnostic/strings/char-codes/index.js

@@ -35,10 +35,10 @@ function toB36CharCodes(string) {
   return chars.map(charToB36CharCode);
 }
 function fromCharCodes(charCodes) {
-  return charCodes.map(charFromCharCode).map((char) => char === null ? "\0" : char).join("");
+  return charCodes.map(charFromCharCode).map((char) => char ?? "\0").join("");
 }
 function fromB36CharCodes(b36CharCodes) {
-  return b36CharCodes.map(charFromB36CharCode).map((char) => char === null ? "\0" : char).join("");
+  return b36CharCodes.map(charFromB36CharCode).map((char) => char ?? "\0").join("");
 }
 function serialize(charCodes) {
   return charCodes.map((c) => typeof c === "string" ? c : charCodeToB36(c)).join(",");

package/agnostic/strings/index.d.ts

@@ -1,7 +1,7 @@
 export * as charCodes from './char-codes/index.js'
 export * as matches from './matches/index.js'
+export * as normalizeIndent from './normalize-indent/index.js'
+export * as parseTable from './parse-table/index.js'
 export * as replaceAll from './replace-all/index.js'
 export * as toAlphanum from './to-alphanum/index.js'
 export * as trim from './trim/index.js'
-export * as normalizeIndent from './normalize-indent/index.js'
-export * as parseTable from './parse-table/index.js'

package/agnostic/strings/index.js

@@ -1,7 +1,7 @@
 export * as charCodes from './char-codes/index.js'
 export * as matches from './matches/index.js'
+export * as normalizeIndent from './normalize-indent/index.js'
+export * as parseTable from './parse-table/index.js'
 export * as replaceAll from './replace-all/index.js'
 export * as toAlphanum from './to-alphanum/index.js'
 export * as trim from './trim/index.js'
-export * as normalizeIndent from './normalize-indent/index.js'
-export * as parseTable from './parse-table/index.js'

package/agnostic/strings/matches/index.d.ts

@@ -17,7 +17,7 @@ export declare function matches(input: string, matcher: Matcher): boolean;
  * @param matchers - A matcher or array of matchers.
  * @returns `true` if the input matches at least one matcher, otherwise `false`.
  */
-export declare function matchesSome(input: string, matchers: Matcher | Array<Matcher>): boolean;
+export declare function matchesSome(input: string, matchers: Matcher | Matcher[]): boolean;
 /**
  * Checks whether a string matches every matcher in a list (or a single matcher).
  *
@@ -25,4 +25,4 @@ export declare function matchesSome(input: string, matchers: Matcher | Array<Mat
  * @param matchers - A matcher or array of matchers.
  * @returns `true` if the input matches all matchers, otherwise `false`.
  */
-export declare function matchesEvery(input: string, matchers: Matcher | Array<Matcher>): boolean;
+export declare function matchesEvery(input: string, matchers: Matcher | Matcher[]): boolean;

package/agnostic/time/dates/format-date/index.js

@@ -1,8 +1,6 @@
 // src/agnostic/time/dates/format-date/index.ts
 function formatDate(date, format, locale = "en") {
-  try {
-    new Intl.DateTimeFormat(locale);
-  } catch {
+  if (Intl.DateTimeFormat.supportedLocalesOf(locale).length === 0) {
     locale = "en";
   }
   const day = date.getDate();
@@ -13,23 +11,39 @@ function formatDate(date, format, locale = "en") {
   const minutes = date.getMinutes();
   const seconds = date.getSeconds();
   const isPM = hours >= 12;
-  const shortDateNames = [...Array(7)].map((_, i) => new Intl.DateTimeFormat(locale, { weekday: "short" }).format(new Date(2023, 0, i + 1)));
-  const dateNames = [...Array(7)].map((_, i) => new Intl.DateTimeFormat(locale, { weekday: "long" }).format(new Date(2023, 0, i + 1)));
-  const shortMonthNames = [...Array(12)].map((_, i) => new Intl.DateTimeFormat(locale, { month: "short" }).format(new Date(2023, i, 1)));
-  const monthNames = [...Array(12)].map((_, i) => new Intl.DateTimeFormat(locale, { month: "long" }).format(new Date(2023, i, 1)));
+  const shortDateNames = [...Array(7)].map((_, i) => new Intl.DateTimeFormat(
+    locale,
+    { weekday: "short" }
+  ).format(new Date(2023, 0, i + 1)));
+  const dateNames = [...Array(7)].map((_, i) => new Intl.DateTimeFormat(
+    locale,
+    { weekday: "long" }
+  ).format(new Date(2023, 0, i + 1)));
+  const shortMonthNames = [...Array(12)].map((_, i) => new Intl.DateTimeFormat(
+    locale,
+    { month: "short" }
+  ).format(new Date(2023, i, 1)));
+  const monthNames = [...Array(12)].map((_, i) => new Intl.DateTimeFormat(
+    locale,
+    { month: "long" }
+  ).format(new Date(2023, i, 1)));
   const replacements = {
     "DD": () => String(day).padStart(2, "0"),
     "D": () => String(day),
+    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
     "dd": () => dateNames[dayOfWeek],
+    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
     "d": () => shortDateNames[dayOfWeek],
     "MM": () => String(month + 1).padStart(2, "0"),
     "M": () => String(month + 1),
+    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
     "MMMM": () => monthNames[month],
+    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
     "MMM": () => shortMonthNames[month],
     "YYYY": () => String(year),
     "YY": () => String(year).slice(-2),
-    "hh": () => String(hours % 12 || 12).padStart(2, "0"),
-    "h": () => String(hours % 12 || 12),
+    "hh": () => String(hours % 12 !== 0 ? hours % 12 : 12).padStart(2, "0"),
+    "h": () => String(hours % 12 !== 0 ? hours % 12 : 12),
     "HH": () => String(hours).padStart(2, "0"),
     "H": () => String(hours),
     "mm": () => String(minutes).padStart(2, "0"),