@sorrell/utilities 1.2.7 → 1.2.9

package/Distribution/Types/Dependency/Dependency.Effect.d.cts.map

@@ -6,5 +6,5 @@
         "../../../Source/Dependency/Dependency.Effect.ts"
     ],
     "names": [],
-    "mappings": "AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAU,MAAM,QAAQ,CAAC;AAMvC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,2BAA2B,CACvC,WAAW,EAAE,MAAM,EACnB,uBAAuB,GAAE,MAAW,EACpC,8BAA8B,GAAE,MAAM,GAAG,SAAqB,GAC/D,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAyClC"
+    "mappings": "AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAU,MAAM,QAAQ,CAAC;AAMvC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,2BAA2B,CACvC,WAAW,EAAE,MAAM,EACnB,uBAAuB,GAAE,MAAW,EACpC,8BAA8B,GAAE,MAAM,GAAG,SAAqB,GAC/D,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CA6ClC"
 }

package/Distribution/Types/Dependency/Dependency.Effect.d.mts.map

@@ -6,5 +6,5 @@
         "../../../Source/Dependency/Dependency.Effect.ts"
     ],
     "names": [],
-    "mappings": "AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAU,MAAM,QAAQ,CAAC;AAMvC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,2BAA2B,CACvC,WAAW,EAAE,MAAM,EACnB,uBAAuB,GAAE,MAAW,EACpC,8BAA8B,GAAE,MAAM,GAAG,SAAqB,GAC/D,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAyClC"
+    "mappings": "AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAU,MAAM,QAAQ,CAAC;AAMvC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,2BAA2B,CACvC,WAAW,EAAE,MAAM,EACnB,uBAAuB,GAAE,MAAW,EACpC,8BAA8B,GAAE,MAAM,GAAG,SAAqB,GAC/D,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CA6ClC"
 }

package/Distribution/Types/Dependency/Dependency.Effect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Dependency.Effect.d.ts","sourceRoot":"","sources":["../../../Source/Dependency/Dependency.Effect.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAU,MAAM,QAAQ,CAAC;AAMvC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,2BAA2B,CACvC,WAAW,EAAE,MAAM,EACnB,uBAAuB,GAAE,MAAW,EACpC,8BAA8B,GAAE,MAAM,GAAG,SAAqB,GAC/D,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAyClC"}
+{"version":3,"file":"Dependency.Effect.d.ts","sourceRoot":"","sources":["../../../Source/Dependency/Dependency.Effect.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAU,MAAM,QAAQ,CAAC;AAMvC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,2BAA2B,CACvC,WAAW,EAAE,MAAM,EACnB,uBAAuB,GAAE,MAAW,EACpC,8BAA8B,GAAE,MAAM,GAAG,SAAqB,GAC/D,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CA6ClC"}

package/Distribution/Types/Dependency/Dependency.Internal.Types.d.cts

@@ -0,0 +1,8 @@
+/**
+ * @file      Dependency.Internal.Types.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+export type ConsoleLogFunctionKey = Extract<keyof typeof console, "log" | "info" | "debug" | "dir" | "warn" | "error">;
+//# sourceMappingURL=Dependency.Internal.Types.d.cts.map

package/Distribution/Types/Dependency/Dependency.Internal.Types.d.cts.map

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "Dependency.Internal.Types.d.cts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/Dependency/Dependency.Internal.Types.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAEH,MAAM,MAAM,qBAAqB,GAC7B,OAAO,CACH,MAAM,OAAO,OAAO,EAClB,KAAK,GACL,MAAM,GACN,OAAO,GACP,KAAK,GACL,MAAM,GACN,OAAO,CACZ,CAAC"
+}

package/Distribution/Types/Dependency/Dependency.Internal.Types.d.mts

@@ -0,0 +1,8 @@
+/**
+ * @file      Dependency.Internal.Types.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+export type ConsoleLogFunctionKey = Extract<keyof typeof console, "log" | "info" | "debug" | "dir" | "warn" | "error">;
+//# sourceMappingURL=Dependency.Internal.Types.d.mts.map

package/Distribution/Types/Dependency/Dependency.Internal.Types.d.mts.map

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "Dependency.Internal.Types.d.mts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/Dependency/Dependency.Internal.Types.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAEH,MAAM,MAAM,qBAAqB,GAC7B,OAAO,CACH,MAAM,OAAO,OAAO,EAClB,KAAK,GACL,MAAM,GACN,OAAO,GACP,KAAK,GACL,MAAM,GACN,OAAO,CACZ,CAAC"
+}

package/Distribution/Types/Dependency/Dependency.Internal.Types.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @file      Dependency.Internal.Types.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+export type ConsoleLogFunctionKey = Extract<keyof typeof console, "log" | "info" | "debug" | "dir" | "warn" | "error">;
+//# sourceMappingURL=Dependency.Internal.Types.d.ts.map

package/Distribution/Types/Dependency/Dependency.Internal.Types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Dependency.Internal.Types.d.ts","sourceRoot":"","sources":["../../../Source/Dependency/Dependency.Internal.Types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,qBAAqB,GAC7B,OAAO,CACH,MAAM,OAAO,OAAO,EAClB,KAAK,GACL,MAAM,GACN,OAAO,GACP,KAAK,GACL,MAAM,GACN,OAAO,CACZ,CAAC"}

package/Distribution/Types/Dependency/Dependency.Internal.d.cts

@@ -4,7 +4,8 @@
  * @copyright (c) 2026 Gage Sorrell
  * @license   MIT
  */
-export declare const DefaultTruthyValues: ReadonlyArray<string>;
+import type { TRuntimeModeProductionOptions } from "./Dependency.Types.cjs";
+export declare const DefaultOptions: TRuntimeModeProductionOptions<boolean>;
 /**
  * Formats a given {@link Message} to look like a code snippet (or path, *etc.*).
  *
@@ -13,4 +14,5 @@ export declare const DefaultTruthyValues: ReadonlyArray<string>;
  * @returns {string} The {@link Message}, formatted to look like code (or a path, *etc.*).
  */
 export declare function Code(Message: string): string;
+export declare function NormalizeLogMessage(Message: unknown): ReadonlyArray<unknown>;
 //# sourceMappingURL=Dependency.Internal.d.cts.map

package/Distribution/Types/Dependency/Dependency.Internal.d.cts.map

@@ -6,5 +6,5 @@
         "../../../Source/Dependency/Dependency.Internal.ts"
     ],
     "names": [],
-    "mappings": "AAAA;;;;;GAKG;AAMH,eAGA,MAAM,mBAAmB,EAAE,aAAa,CAAC,MAAM,CAOjC,CAAC;AAIf;;;;;;GAMG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAG5C"
+    "mappings": "AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AAc3E,eAGA,MAAM,cAAc,EAAE,6BAA6B,CAAC,OAAO,CAItD,CAAC;AAIN;;;;;;GAMG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAG5C;AAKD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,CAQ5E"
 }

package/Distribution/Types/Dependency/Dependency.Internal.d.mts

@@ -4,7 +4,8 @@
  * @copyright (c) 2026 Gage Sorrell
  * @license   MIT
  */
-export declare const DefaultTruthyValues: ReadonlyArray<string>;
+import type { TRuntimeModeProductionOptions } from "./Dependency.Types.mjs";
+export declare const DefaultOptions: TRuntimeModeProductionOptions<boolean>;
 /**
  * Formats a given {@link Message} to look like a code snippet (or path, *etc.*).
  *
@@ -13,4 +14,5 @@ export declare const DefaultTruthyValues: ReadonlyArray<string>;
  * @returns {string} The {@link Message}, formatted to look like code (or a path, *etc.*).
  */
 export declare function Code(Message: string): string;
+export declare function NormalizeLogMessage(Message: unknown): ReadonlyArray<unknown>;
 //# sourceMappingURL=Dependency.Internal.d.mts.map

package/Distribution/Types/Dependency/Dependency.Internal.d.mts.map

@@ -6,5 +6,5 @@
         "../../../Source/Dependency/Dependency.Internal.ts"
     ],
     "names": [],
-    "mappings": "AAAA;;;;;GAKG;AAMH,eAGA,MAAM,mBAAmB,EAAE,aAAa,CAAC,MAAM,CAOjC,CAAC;AAIf;;;;;;GAMG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAG5C"
+    "mappings": "AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AAc3E,eAGA,MAAM,cAAc,EAAE,6BAA6B,CAAC,OAAO,CAItD,CAAC;AAIN;;;;;;GAMG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAG5C;AAKD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,CAQ5E"
 }

package/Distribution/Types/Dependency/Dependency.Internal.d.ts

@@ -4,7 +4,8 @@
  * @copyright (c) 2026 Gage Sorrell
  * @license   MIT
  */
-export declare const DefaultTruthyValues: ReadonlyArray<string>;
+import type { TRuntimeModeProductionOptions } from "./Dependency.Types.ts";
+export declare const DefaultOptions: TRuntimeModeProductionOptions<boolean>;
 /**
  * Formats a given {@link Message} to look like a code snippet (or path, *etc.*).
  *
@@ -13,4 +14,5 @@ export declare const DefaultTruthyValues: ReadonlyArray<string>;
  * @returns {string} The {@link Message}, formatted to look like code (or a path, *etc.*).
  */
 export declare function Code(Message: string): string;
+export declare function NormalizeLogMessage(Message: unknown): ReadonlyArray<unknown>;
 //# sourceMappingURL=Dependency.Internal.d.ts.map

package/Distribution/Types/Dependency/Dependency.Internal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Dependency.Internal.d.ts","sourceRoot":"","sources":["../../../Source/Dependency/Dependency.Internal.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,eAGA,MAAM,mBAAmB,EAAE,aAAa,CAAC,MAAM,CAOjC,CAAC;AAIf;;;;;;GAMG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAG5C"}
+{"version":3,"file":"Dependency.Internal.d.ts","sourceRoot":"","sources":["../../../Source/Dependency/Dependency.Internal.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AAc3E,eAGA,MAAM,cAAc,EAAE,6BAA6B,CAAC,OAAO,CAItD,CAAC;AAIN;;;;;;GAMG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAG5C;AAKD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,CAQ5E"}

package/Distribution/Types/Dependency/Dependency.Types.d.cts

@@ -0,0 +1,32 @@
+/**
+ * @file      Dependency.Types.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+import type { ConsoleLogFunctionKey } from "./Dependency.Internal.Types";
+export type DependencyLogger = Pick<typeof console, ConsoleLogFunctionKey>;
+/**
+ * The options argument of {@link IsRuntimeModeProduction}.
+ * @property {string} DebugEnvironmentVariable - If specified, then this environment variable will be
+ * checked for, in addition to the other checks performed by this function to guess whether the current
+ * session is in *production mode*.
+ *
+ * @template UncertainType - The type of the {@link UncertainValue}.  By default, this is `boolean`.
+ *
+ * @property {ReadonlyArray<string>} TruthyValues - If {@link DebugEnvironmentVariable} is specified, and
+ * if {@link process.env} has a property with key {@link DebugEnvironmentVariable}, then this will return
+ * based on whether
+ * ```typescript
+ * TruthyValues.map(TruthyWord => TruthyWord.toLowerCase()).includes(DebugEnvironmentVariable.toLowerCase());
+ * ```
+ *
+ * @property {UncertainType} UncertainValue - The value that is returned in Step 3—that is, if this function
+ * is uncertain whether the current session is in *production mode.*  By default, this is `true`.
+ */
+export type TRuntimeModeProductionOptions<UncertainType = boolean> = Partial<{
+    DebugEnvironmentVariable: string;
+    UncertainValue: UncertainType;
+    TruthyValues: ReadonlyArray<string>;
+}>;
+//# sourceMappingURL=Dependency.Types.d.cts.map

package/Distribution/Types/Dependency/Dependency.Types.d.cts.map

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "Dependency.Types.d.cts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/Dependency/Dependency.Types.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAIzE,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,OAAO,OAAO,EAAE,qBAAqB,CAAC,CAAC;AAE3E;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,6BAA6B,CAAC,aAAa,GAAG,OAAO,IAC7D,OAAO,CAAC;IACJ,wBAAwB,EAAE,MAAM,CAAC;IACjC,cAAc,EAAE,aAAa,CAAC;IAC9B,YAAY,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACvC,CAAC,CAAC"
+}

package/Distribution/Types/Dependency/Dependency.Types.d.mts

@@ -0,0 +1,32 @@
+/**
+ * @file      Dependency.Types.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+import type { ConsoleLogFunctionKey } from "./Dependency.Internal.Types";
+export type DependencyLogger = Pick<typeof console, ConsoleLogFunctionKey>;
+/**
+ * The options argument of {@link IsRuntimeModeProduction}.
+ * @property {string} DebugEnvironmentVariable - If specified, then this environment variable will be
+ * checked for, in addition to the other checks performed by this function to guess whether the current
+ * session is in *production mode*.
+ *
+ * @template UncertainType - The type of the {@link UncertainValue}.  By default, this is `boolean`.
+ *
+ * @property {ReadonlyArray<string>} TruthyValues - If {@link DebugEnvironmentVariable} is specified, and
+ * if {@link process.env} has a property with key {@link DebugEnvironmentVariable}, then this will return
+ * based on whether
+ * ```typescript
+ * TruthyValues.map(TruthyWord => TruthyWord.toLowerCase()).includes(DebugEnvironmentVariable.toLowerCase());
+ * ```
+ *
+ * @property {UncertainType} UncertainValue - The value that is returned in Step 3—that is, if this function
+ * is uncertain whether the current session is in *production mode.*  By default, this is `true`.
+ */
+export type TRuntimeModeProductionOptions<UncertainType = boolean> = Partial<{
+    DebugEnvironmentVariable: string;
+    UncertainValue: UncertainType;
+    TruthyValues: ReadonlyArray<string>;
+}>;
+//# sourceMappingURL=Dependency.Types.d.mts.map

package/Distribution/Types/Dependency/Dependency.Types.d.mts.map

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "Dependency.Types.d.mts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/Dependency/Dependency.Types.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAIzE,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,OAAO,OAAO,EAAE,qBAAqB,CAAC,CAAC;AAE3E;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,6BAA6B,CAAC,aAAa,GAAG,OAAO,IAC7D,OAAO,CAAC;IACJ,wBAAwB,EAAE,MAAM,CAAC;IACjC,cAAc,EAAE,aAAa,CAAC;IAC9B,YAAY,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACvC,CAAC,CAAC"
+}

package/Distribution/Types/Dependency/Dependency.Types.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @file      Dependency.Types.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+import type { ConsoleLogFunctionKey } from "./Dependency.Internal.Types";
+export type DependencyLogger = Pick<typeof console, ConsoleLogFunctionKey>;
+/**
+ * The options argument of {@link IsRuntimeModeProduction}.
+ * @property {string} DebugEnvironmentVariable - If specified, then this environment variable will be
+ * checked for, in addition to the other checks performed by this function to guess whether the current
+ * session is in *production mode*.
+ *
+ * @template UncertainType - The type of the {@link UncertainValue}.  By default, this is `boolean`.
+ *
+ * @property {ReadonlyArray<string>} TruthyValues - If {@link DebugEnvironmentVariable} is specified, and
+ * if {@link process.env} has a property with key {@link DebugEnvironmentVariable}, then this will return
+ * based on whether
+ * ```typescript
+ * TruthyValues.map(TruthyWord => TruthyWord.toLowerCase()).includes(DebugEnvironmentVariable.toLowerCase());
+ * ```
+ *
+ * @property {UncertainType} UncertainValue - The value that is returned in Step 3—that is, if this function
+ * is uncertain whether the current session is in *production mode.*  By default, this is `true`.
+ */
+export type TRuntimeModeProductionOptions<UncertainType = boolean> = Partial<{
+    DebugEnvironmentVariable: string;
+    UncertainValue: UncertainType;
+    TruthyValues: ReadonlyArray<string>;
+}>;
+//# sourceMappingURL=Dependency.Types.d.ts.map

package/Distribution/Types/Dependency/Dependency.Types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Dependency.Types.d.ts","sourceRoot":"","sources":["../../../Source/Dependency/Dependency.Types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAIzE,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,OAAO,OAAO,EAAE,qBAAqB,CAAC,CAAC;AAE3E;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,6BAA6B,CAAC,aAAa,GAAG,OAAO,IAC7D,OAAO,CAAC;IACJ,wBAAwB,EAAE,MAAM,CAAC;IACjC,cAAc,EAAE,aAAa,CAAC;IAC9B,YAAY,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACvC,CAAC,CAAC"}

package/Distribution/Types/Dependency/Dependency.d.cts

@@ -4,6 +4,25 @@
  * @copyright (c) 2026 Gage Sorrell
  * @license   MIT
  */
+import type { DependencyLogger, TRuntimeModeProductionOptions } from "./Dependency.Types.cjs";
+/**
+ * Guess whether the current session is in *production mode* by,
+ *
+ * 1. If the function did not already return in Step 1, then {@link process.env} is checked for
+ * a property with key `"NODE_ENV"`.
+ *     - If there exists a property with this key, and if `process.env["NODE_ENV"] === "production"`
+ *       (or similar; see below), then this returns `true`.
+ * 2. If the function did not already return in Step 2, then `true` is returned.
+ *
+ * @note If Step 2 is executed, then this returns `true` when `process.env["NODE_ENV"].toLowerCase()`
+ * is any one of,
+ * - `"production"`
+ * - `"prod"`
+ *
+ * @returns {boolean} Whether the current session is likely in *production mode*, or,
+ * if unsure, `true` is returned.
+ */
+export declare function IsRuntimeModeProduction(): boolean;
 /**
  * Guess whether the current session is in *production mode* by,
  *
@@ -18,26 +37,38 @@
  * 3. If the function did not already return in Step 2, then {@link UncertainValue} is returned.
  * By default, this is `true`, but any value of any type can be used.
  *
+ * @template UncertainType - The type of the {@link UncertainValue}.  By default, this is `boolean`.
+ *
+ * @param Options - The {@link TRuntimeModeProductionOptions} options object.  All properties are optional.
+ *
  * @note If Step 2 is executed, then this returns `true` when `process.env["NODE_ENV"].toLowerCase()`
  * is any one of,
  * - `"production"`
  * - `"prod"`
  *
- * @param DebugEnvironmentVariable - If specified, then this environment variable will be checked for,
- * in addition to the other checks performed by this function to guess whether the current session is
- * in *production mode*.
+ * @returns {boolean | typeof UncertainValue} Whether the current session is likely in *production mode*, or,
+ * if unsure, the given {@link UncertainValue} is returned (by default, this is `true`).
+ */
+export declare function IsRuntimeModeProduction<UncertainType = boolean>(Options: TRuntimeModeProductionOptions<UncertainType>): boolean | Exclude<typeof Options.UncertainValue, undefined>;
+/**
+ * This patches the default logger so that the statements that are logged by your dependency package
+ * do not overwhelm or annoy the consuming developer.
  *
- * @param TruthyValues - If {@link DebugEnvironmentVariable} is specified, and if {@link process.env}
- * has a property with key {@link DebugEnvironmentVariable}, then this will return based on whether
- * ```
- * TruthyValues.map(TruthyWord => TruthyWord.toLowerCase()).includes(DebugEnvironmentVariable.toLowerCase());
- * ```
+ * {@link IsDependentModeProduction} is used to determine whether to return a no-op
+ * (iff `true`), or a function that wraps {@link Console} (iff `false`).
  *
- * @param UncertainValue - The value that is returned in Step 3—that is, if this function is uncertain whether
- * the current session is in *production mode.*  By default, this is `true`.
+ * @param PackageName - The name of your package.  It is strongly recommended, but not *enforced*,
+ * that this is exactly the `name` in your `package.json`.  Statements logged under this
+ * {@link Layer.Layer | Layer} are prefixed with `[${ PackageName }]`.
  *
- * @returns {boolean | typeof UncertainValue} Whether the current session is likely in *production mode*, or,
- * if unsure, the given {@link UncertainValue} is returned (by default, this is `true`).
+ * @param SuppressLoggerFrequency - When {@link SuppressLoggerFrequency} statements have been logged,
+ * a short message is *also* logged, explaining how to suppress output from your package.
+ *
+ * @param SuppressLogEnvironmentVariable - If specified, this is the environment variable name passed to
+ * {@link IsDependentModeProduction} to determine whether the logger will be a no-op.
+ *
+ * @returns {Layer.Layer} A {@link Layer.Layer | Layer} that provides the {@link DependencyLogger}
+ * with the {@link PackageName}.
  */
-export declare function IsRuntimeModeProduction(DebugEnvironmentVariable?: string | undefined, TruthyValues?: ReadonlyArray<string>, UncertainValue?: unknown): boolean | typeof UncertainValue;
+export declare function GetDependencyLogger(PackageName: string, SuppressLoggerFrequency?: number, SuppressLogEnvironmentVariable?: string | undefined): DependencyLogger;
 //# sourceMappingURL=Dependency.d.cts.map

package/Distribution/Types/Dependency/Dependency.d.cts.map

@@ -6,5 +6,5 @@
         "../../../Source/Dependency/Dependency.ts"
     ],
     "names": [],
-    "mappings": "AAAA;;;;;GAKG;AAMH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,uBAAuB,CACnC,wBAAwB,GAAE,MAAM,GAAG,SAAqB,EACxD,YAAY,GAAE,aAAa,CAAC,MAAM,CAAuB,EACzD,cAAc,GAAE,OAAc,GAC/B,OAAO,GAAG,OAAO,cAAc,CAsBjC"
+    "mappings": "AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AAK7F;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,uBAAuB,IAAI,OAAO,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,uBAAuB,CAAC,aAAa,GAAG,OAAO,EAC3D,OAAO,EAAE,6BAA6B,CAAC,aAAa,CAAC,GACtD,OAAO,GAAG,OAAO,CAAC,OAAO,OAAO,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;AAsC/D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,mBAAmB,CAC/B,WAAW,EAAE,MAAM,EACnB,uBAAuB,GAAE,MAAW,EACpC,8BAA8B,GAAE,MAAM,GAAG,SAAqB,GAC/D,gBAAgB,CAoGlB"
 }

package/Distribution/Types/Dependency/Dependency.d.mts

@@ -4,6 +4,25 @@
  * @copyright (c) 2026 Gage Sorrell
  * @license   MIT
  */
+import type { DependencyLogger, TRuntimeModeProductionOptions } from "./Dependency.Types.mjs";
+/**
+ * Guess whether the current session is in *production mode* by,
+ *
+ * 1. If the function did not already return in Step 1, then {@link process.env} is checked for
+ * a property with key `"NODE_ENV"`.
+ *     - If there exists a property with this key, and if `process.env["NODE_ENV"] === "production"`
+ *       (or similar; see below), then this returns `true`.
+ * 2. If the function did not already return in Step 2, then `true` is returned.
+ *
+ * @note If Step 2 is executed, then this returns `true` when `process.env["NODE_ENV"].toLowerCase()`
+ * is any one of,
+ * - `"production"`
+ * - `"prod"`
+ *
+ * @returns {boolean} Whether the current session is likely in *production mode*, or,
+ * if unsure, `true` is returned.
+ */
+export declare function IsRuntimeModeProduction(): boolean;
 /**
  * Guess whether the current session is in *production mode* by,
  *
@@ -18,26 +37,38 @@
  * 3. If the function did not already return in Step 2, then {@link UncertainValue} is returned.
  * By default, this is `true`, but any value of any type can be used.
  *
+ * @template UncertainType - The type of the {@link UncertainValue}.  By default, this is `boolean`.
+ *
+ * @param Options - The {@link TRuntimeModeProductionOptions} options object.  All properties are optional.
+ *
  * @note If Step 2 is executed, then this returns `true` when `process.env["NODE_ENV"].toLowerCase()`
  * is any one of,
  * - `"production"`
  * - `"prod"`
  *
- * @param DebugEnvironmentVariable - If specified, then this environment variable will be checked for,
- * in addition to the other checks performed by this function to guess whether the current session is
- * in *production mode*.
+ * @returns {boolean | typeof UncertainValue} Whether the current session is likely in *production mode*, or,
+ * if unsure, the given {@link UncertainValue} is returned (by default, this is `true`).
+ */
+export declare function IsRuntimeModeProduction<UncertainType = boolean>(Options: TRuntimeModeProductionOptions<UncertainType>): boolean | Exclude<typeof Options.UncertainValue, undefined>;
+/**
+ * This patches the default logger so that the statements that are logged by your dependency package
+ * do not overwhelm or annoy the consuming developer.
  *
- * @param TruthyValues - If {@link DebugEnvironmentVariable} is specified, and if {@link process.env}
- * has a property with key {@link DebugEnvironmentVariable}, then this will return based on whether
- * ```
- * TruthyValues.map(TruthyWord => TruthyWord.toLowerCase()).includes(DebugEnvironmentVariable.toLowerCase());
- * ```
+ * {@link IsDependentModeProduction} is used to determine whether to return a no-op
+ * (iff `true`), or a function that wraps {@link Console} (iff `false`).
  *
- * @param UncertainValue - The value that is returned in Step 3—that is, if this function is uncertain whether
- * the current session is in *production mode.*  By default, this is `true`.
+ * @param PackageName - The name of your package.  It is strongly recommended, but not *enforced*,
+ * that this is exactly the `name` in your `package.json`.  Statements logged under this
+ * {@link Layer.Layer | Layer} are prefixed with `[${ PackageName }]`.
  *
- * @returns {boolean | typeof UncertainValue} Whether the current session is likely in *production mode*, or,
- * if unsure, the given {@link UncertainValue} is returned (by default, this is `true`).
+ * @param SuppressLoggerFrequency - When {@link SuppressLoggerFrequency} statements have been logged,
+ * a short message is *also* logged, explaining how to suppress output from your package.
+ *
+ * @param SuppressLogEnvironmentVariable - If specified, this is the environment variable name passed to
+ * {@link IsDependentModeProduction} to determine whether the logger will be a no-op.
+ *
+ * @returns {Layer.Layer} A {@link Layer.Layer | Layer} that provides the {@link DependencyLogger}
+ * with the {@link PackageName}.
  */
-export declare function IsRuntimeModeProduction(DebugEnvironmentVariable?: string | undefined, TruthyValues?: ReadonlyArray<string>, UncertainValue?: unknown): boolean | typeof UncertainValue;
+export declare function GetDependencyLogger(PackageName: string, SuppressLoggerFrequency?: number, SuppressLogEnvironmentVariable?: string | undefined): DependencyLogger;
 //# sourceMappingURL=Dependency.d.mts.map

package/Distribution/Types/Dependency/Dependency.d.mts.map

@@ -6,5 +6,5 @@
         "../../../Source/Dependency/Dependency.ts"
     ],
     "names": [],
-    "mappings": "AAAA;;;;;GAKG;AAMH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,uBAAuB,CACnC,wBAAwB,GAAE,MAAM,GAAG,SAAqB,EACxD,YAAY,GAAE,aAAa,CAAC,MAAM,CAAuB,EACzD,cAAc,GAAE,OAAc,GAC/B,OAAO,GAAG,OAAO,cAAc,CAsBjC"
+    "mappings": "AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AAK7F;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,uBAAuB,IAAI,OAAO,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,uBAAuB,CAAC,aAAa,GAAG,OAAO,EAC3D,OAAO,EAAE,6BAA6B,CAAC,aAAa,CAAC,GACtD,OAAO,GAAG,OAAO,CAAC,OAAO,OAAO,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;AAsC/D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,mBAAmB,CAC/B,WAAW,EAAE,MAAM,EACnB,uBAAuB,GAAE,MAAW,EACpC,8BAA8B,GAAE,MAAM,GAAG,SAAqB,GAC/D,gBAAgB,CAoGlB"
 }

package/Distribution/Types/Dependency/Dependency.d.ts

@@ -4,6 +4,25 @@
  * @copyright (c) 2026 Gage Sorrell
  * @license   MIT
  */
+import type { DependencyLogger, TRuntimeModeProductionOptions } from "./Dependency.Types.ts";
+/**
+ * Guess whether the current session is in *production mode* by,
+ *
+ * 1. If the function did not already return in Step 1, then {@link process.env} is checked for
+ * a property with key `"NODE_ENV"`.
+ *     - If there exists a property with this key, and if `process.env["NODE_ENV"] === "production"`
+ *       (or similar; see below), then this returns `true`.
+ * 2. If the function did not already return in Step 2, then `true` is returned.
+ *
+ * @note If Step 2 is executed, then this returns `true` when `process.env["NODE_ENV"].toLowerCase()`
+ * is any one of,
+ * - `"production"`
+ * - `"prod"`
+ *
+ * @returns {boolean} Whether the current session is likely in *production mode*, or,
+ * if unsure, `true` is returned.
+ */
+export declare function IsRuntimeModeProduction(): boolean;
 /**
  * Guess whether the current session is in *production mode* by,
  *
@@ -18,26 +37,38 @@
  * 3. If the function did not already return in Step 2, then {@link UncertainValue} is returned.
  * By default, this is `true`, but any value of any type can be used.
  *
+ * @template UncertainType - The type of the {@link UncertainValue}.  By default, this is `boolean`.
+ *
+ * @param Options - The {@link TRuntimeModeProductionOptions} options object.  All properties are optional.
+ *
  * @note If Step 2 is executed, then this returns `true` when `process.env["NODE_ENV"].toLowerCase()`
  * is any one of,
  * - `"production"`
  * - `"prod"`
  *
- * @param DebugEnvironmentVariable - If specified, then this environment variable will be checked for,
- * in addition to the other checks performed by this function to guess whether the current session is
- * in *production mode*.
+ * @returns {boolean | typeof UncertainValue} Whether the current session is likely in *production mode*, or,
+ * if unsure, the given {@link UncertainValue} is returned (by default, this is `true`).
+ */
+export declare function IsRuntimeModeProduction<UncertainType = boolean>(Options: TRuntimeModeProductionOptions<UncertainType>): boolean | Exclude<typeof Options.UncertainValue, undefined>;
+/**
+ * This patches the default logger so that the statements that are logged by your dependency package
+ * do not overwhelm or annoy the consuming developer.
  *
- * @param TruthyValues - If {@link DebugEnvironmentVariable} is specified, and if {@link process.env}
- * has a property with key {@link DebugEnvironmentVariable}, then this will return based on whether
- * ```
- * TruthyValues.map(TruthyWord => TruthyWord.toLowerCase()).includes(DebugEnvironmentVariable.toLowerCase());
- * ```
+ * {@link IsDependentModeProduction} is used to determine whether to return a no-op
+ * (iff `true`), or a function that wraps {@link Console} (iff `false`).
  *
- * @param UncertainValue - The value that is returned in Step 3—that is, if this function is uncertain whether
- * the current session is in *production mode.*  By default, this is `true`.
+ * @param PackageName - The name of your package.  It is strongly recommended, but not *enforced*,
+ * that this is exactly the `name` in your `package.json`.  Statements logged under this
+ * {@link Layer.Layer | Layer} are prefixed with `[${ PackageName }]`.
  *
- * @returns {boolean | typeof UncertainValue} Whether the current session is likely in *production mode*, or,
- * if unsure, the given {@link UncertainValue} is returned (by default, this is `true`).
+ * @param SuppressLoggerFrequency - When {@link SuppressLoggerFrequency} statements have been logged,
+ * a short message is *also* logged, explaining how to suppress output from your package.
+ *
+ * @param SuppressLogEnvironmentVariable - If specified, this is the environment variable name passed to
+ * {@link IsDependentModeProduction} to determine whether the logger will be a no-op.
+ *
+ * @returns {Layer.Layer} A {@link Layer.Layer | Layer} that provides the {@link DependencyLogger}
+ * with the {@link PackageName}.
  */
-export declare function IsRuntimeModeProduction(DebugEnvironmentVariable?: string | undefined, TruthyValues?: ReadonlyArray<string>, UncertainValue?: unknown): boolean | typeof UncertainValue;
+export declare function GetDependencyLogger(PackageName: string, SuppressLoggerFrequency?: number, SuppressLogEnvironmentVariable?: string | undefined): DependencyLogger;
 //# sourceMappingURL=Dependency.d.ts.map

package/Distribution/Types/Dependency/Dependency.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Dependency.d.ts","sourceRoot":"","sources":["../../../Source/Dependency/Dependency.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,uBAAuB,CACnC,wBAAwB,GAAE,MAAM,GAAG,SAAqB,EACxD,YAAY,GAAE,aAAa,CAAC,MAAM,CAAuB,EACzD,cAAc,GAAE,OAAc,GAC/B,OAAO,GAAG,OAAO,cAAc,CAsBjC"}
+{"version":3,"file":"Dependency.d.ts","sourceRoot":"","sources":["../../../Source/Dependency/Dependency.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AAK7F;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,uBAAuB,IAAI,OAAO,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,uBAAuB,CAAC,aAAa,GAAG,OAAO,EAC3D,OAAO,EAAE,6BAA6B,CAAC,aAAa,CAAC,GACtD,OAAO,GAAG,OAAO,CAAC,OAAO,OAAO,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;AAsC/D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,mBAAmB,CAC/B,WAAW,EAAE,MAAM,EACnB,uBAAuB,GAAE,MAAW,EACpC,8BAA8B,GAAE,MAAM,GAAG,SAAqB,GAC/D,gBAAgB,CAoGlB"}

package/Distribution/Types/Dependency/index.d.cts

@@ -10,4 +10,5 @@
  * as dependencies of other packages.
  */
 export * from "./Dependency.cjs";
+export * from "./Dependency.Types.cjs";
 //# sourceMappingURL=index.d.cts.map

package/Distribution/Types/Dependency/index.d.cts.map

@@ -6,5 +6,5 @@
         "../../../Source/Dependency/index.ts"
     ],
     "names": [],
-    "mappings": "AAAA;;;;;GAKG;AAEH;;;;GAIG;AAEH,cAAc,iBAAiB,CAAC"
+    "mappings": "AAAA;;;;;GAKG;AAEH;;;;GAIG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC"
 }

package/Distribution/Types/Dependency/index.d.mts

@@ -10,4 +10,5 @@
  * as dependencies of other packages.
  */
 export * from "./Dependency.mjs";
+export * from "./Dependency.Types.mjs";
 //# sourceMappingURL=index.d.mts.map

package/Distribution/Types/Dependency/index.d.mts.map

@@ -6,5 +6,5 @@
         "../../../Source/Dependency/index.ts"
     ],
     "names": [],
-    "mappings": "AAAA;;;;;GAKG;AAEH;;;;GAIG;AAEH,cAAc,iBAAiB,CAAC"
+    "mappings": "AAAA;;;;;GAKG;AAEH;;;;GAIG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC"
 }

package/Distribution/Types/Dependency/index.d.ts

@@ -10,4 +10,5 @@
  * as dependencies of other packages.
  */
 export * from "./Dependency.ts";
+export * from "./Dependency.Types.ts";
 //# sourceMappingURL=index.d.ts.map

package/Distribution/Types/Dependency/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../Source/Dependency/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;GAIG;AAEH,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../Source/Dependency/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;GAIG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC"}