@sorrell/utilities 1.2.5 → 1.2.6

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

@@ -0,0 +1,15 @@
+/**
+ * @file      index.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+/**
+ * @module Npm
+ * Utilities for working with `npm` (NodeJS) packages.
+ * Many of these likely work with packages of other NodeJS
+ * package managers and adjacent runtimes (*e.g.*, `bun` or `deno`).
+ */
+export * from "./Npm.mjs";
+export * from "./Npm.Error.mjs";
+//# sourceMappingURL=index.d.mts.map

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

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "index.d.mts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/Npm/index.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAEH;;;;;GAKG;AAEH,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC"
+}

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

@@ -0,0 +1,15 @@
+/**
+ * @file      index.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+/**
+ * @module Npm
+ * Utilities for working with `npm` (NodeJS) packages.
+ * Many of these likely work with packages of other NodeJS
+ * package managers and adjacent runtimes (*e.g.*, `bun` or `deno`).
+ */
+export * from "./Npm.ts";
+export * from "./Npm.Error.ts";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../Source/Npm/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;GAKG;AAEH,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC"}

package/Distribution/Types/Path/Path.d.cts

@@ -0,0 +1,17 @@
+/**
+ * @file      Path.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+import { Operator } from "tsover-runtime";
+export declare class FPath {
+    readonly Raw: string;
+    toString(): string;
+    constructor(String: string);
+    constructor(Other: FPath);
+    [Operator.slash](A: FPath, B: FPath): FPath;
+    [Operator.slash](A: string, B: FPath): FPath;
+    [Operator.slash](A: FPath, B: string): FPath;
+}
+//# sourceMappingURL=Path.d.cts.map

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

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "Path.d.cts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/Path/Path.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,qBAAa,KAAK;IAEd,SAAgB,GAAG,EAAE,MAAM,CAAC;IAErB,QAAQ,IAAI,MAAM;gBAKN,MAAM,EAAE,MAAM;gBACd,KAAK,EAAE,KAAK;IAa/B,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,GAAG,KAAK;IAC3C,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,GAAG,KAAK;IAC5C,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,GAAG,KAAK;CAgB/C"
+}

package/Distribution/Types/Path/Path.d.mts

@@ -0,0 +1,17 @@
+/**
+ * @file      Path.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+import { Operator } from "tsover-runtime";
+export declare class FPath {
+    readonly Raw: string;
+    toString(): string;
+    constructor(String: string);
+    constructor(Other: FPath);
+    [Operator.slash](A: FPath, B: FPath): FPath;
+    [Operator.slash](A: string, B: FPath): FPath;
+    [Operator.slash](A: FPath, B: string): FPath;
+}
+//# sourceMappingURL=Path.d.mts.map

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

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "Path.d.mts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/Path/Path.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,qBAAa,KAAK;IAEd,SAAgB,GAAG,EAAE,MAAM,CAAC;IAErB,QAAQ,IAAI,MAAM;gBAKN,MAAM,EAAE,MAAM;gBACd,KAAK,EAAE,KAAK;IAa/B,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,GAAG,KAAK;IAC3C,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,GAAG,KAAK;IAC5C,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,GAAG,KAAK;CAgB/C"
+}

package/Distribution/Types/Path/Path.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @file      Path.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+import { Operator } from "tsover-runtime";
+export declare class FPath {
+    readonly Raw: string;
+    toString(): string;
+    constructor(String: string);
+    constructor(Other: FPath);
+    [Operator.slash](A: FPath, B: FPath): FPath;
+    [Operator.slash](A: string, B: FPath): FPath;
+    [Operator.slash](A: FPath, B: string): FPath;
+}
+//# sourceMappingURL=Path.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Path.d.ts","sourceRoot":"","sources":["../../../Source/Path/Path.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,qBAAa,KAAK;IAEd,SAAgB,GAAG,EAAE,MAAM,CAAC;IAErB,QAAQ,IAAI,MAAM;gBAKN,MAAM,EAAE,MAAM;gBACd,KAAK,EAAE,KAAK;IAa/B,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,GAAG,KAAK;IAC3C,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,GAAG,KAAK;IAC5C,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,GAAG,KAAK;CAgB/C"}

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

@@ -0,0 +1,8 @@
+/**
+ * @file      index.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+export * from "./Path.cjs";
+//# sourceMappingURL=index.d.cts.map

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

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "index.d.cts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/Path/index.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAEH,cAAc,WAAW,CAAC"
+}

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

@@ -0,0 +1,8 @@
+/**
+ * @file      index.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+export * from "./Path.mjs";
+//# sourceMappingURL=index.d.mts.map

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

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "index.d.mts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/Path/index.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAEH,cAAc,WAAW,CAAC"
+}

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

@@ -0,0 +1,8 @@
+/**
+ * @file      index.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+export * from "./Path.ts";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../Source/Path/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,WAAW,CAAC"}

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

@@ -0,0 +1,32 @@
+/**
+ * @file      Record.Internal.Types.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+import type { TPath } from "./Record.Types.cjs";
+type FDepthMap = {
+    3: 2;
+    2: 1;
+    1: 0;
+};
+type FDepth = keyof FDepthMap | 0;
+type FValidDepth = keyof FDepthMap;
+type TDepthMinusOne<DepthType extends FDepth> = DepthType extends FValidDepth ? FDepthMap[DepthType] : 0;
+export type TFromPathInternal<RecordType, PathType extends TPath<RecordType>, DepthType extends FDepth = 3> = DepthType extends FValidDepth ? PathType extends `${infer HeadType}.${infer RemainingPathType}` ? HeadType extends keyof RecordType ? RemainingPathType extends keyof RecordType[HeadType] ? TFromPathInternal<RecordType[HeadType], Extract<RemainingPathType, string>, TDepthMinusOne<DepthType>> : never : never : PathType extends keyof RecordType ? RecordType[PathType] : never : PathType extends keyof RecordType ? RecordType[PathType] : never;
+/**
+ * @template RecordType - The {@link Record} type from which this path is constructed.
+ *
+ * @template ParentKey - The use of this parameter--for reasons that I do not
+ * understand--prevent an error regarding stack depth when evaluating this type.
+ */
+export type TPathInternal<RecordType, ParentKey extends string | undefined = undefined> = (ParentKey extends string ? `${ParentKey}.${Extract<keyof RecordType, string>}` : Extract<keyof RecordType, string>) | (TMapToPath<RecordType>[keyof TMapToPath<RecordType>]);
+type TGetRecordProperties<RecordType> = {
+    [Key in keyof RecordType as RecordType[Extract<Key, string>] extends Record<PropertyKey, unknown> ? Key : never]: RecordType[Key];
+};
+type TGetRecordKeys<RecordType> = keyof TGetRecordProperties<RecordType>;
+type TMapToPath<RecordType> = {
+    [Key in Extract<TGetRecordKeys<RecordType>, string>]: `${Key}.${TPathInternal<TGetRecordProperties<RecordType>[Key]>}`;
+};
+export {};
+//# sourceMappingURL=Record.Internal.Types.d.cts.map

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

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "Record.Internal.Types.d.cts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/Record/Record.Internal.Types.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C,KAAK,SAAS,GACV;IACI,CAAC,EAAE,CAAC,CAAC;IACL,CAAC,EAAE,CAAC,CAAC;IACL,CAAC,EAAE,CAAC,CAAC;CACR,CAAC;AAEN,KAAK,MAAM,GAAG,MAAM,SAAS,GAAG,CAAC,CAAC;AAClC,KAAK,WAAW,GAAG,MAAM,SAAS,CAAC;AAEnC,KAAK,cAAc,CAAC,SAAS,SAAS,MAAM,IAAI,SAAS,SAAS,WAAW,GACvE,SAAS,CAAC,SAAS,CAAC,GACpB,CAAC,CAAC;AAIR,MAAM,MAAM,iBAAiB,CACzB,UAAU,EACV,QAAQ,SAAS,KAAK,CAAC,UAAU,CAAC,EAClC,SAAS,SAAS,MAAM,GAAG,CAAC,IAE5B,SAAS,SAAS,WAAW,GACvB,QAAQ,SAAS,GAAI,MAAM,QAAS,IAAK,MAAM,iBAAkB,EAAE,GAC/D,QAAQ,SAAS,MAAM,UAAU,GAC7B,iBAAiB,SAAS,MAAM,UAAU,CAAC,QAAQ,CAAC,GAChD,iBAAiB,CACf,UAAU,CAAC,QAAQ,CAAC,EACpB,OAAO,CAAC,iBAAiB,EAAE,MAAM,CAAC,EAClC,cAAc,CAAC,SAAS,CAAC,CAC5B,GACC,KAAK,GACT,KAAK,GACT,QAAQ,SAAS,MAAM,UAAU,GAC7B,UAAU,CAAC,QAAQ,CAAC,GACpB,KAAK,GACb,QAAQ,SAAS,MAAM,UAAU,GAC7B,UAAU,CAAC,QAAQ,CAAC,GACpB,KAAK,CAAC;AAIpB;;;;;GAKG;AACH,MAAM,MAAM,aAAa,CACrB,UAAU,EACV,SAAS,SAAS,MAAM,GAAG,SAAS,GAAG,SAAS,IAE9C,CACE,SAAS,SAAS,MAAM,GAClB,GAAI,SAAU,IAAK,OAAO,CAAC,MAAM,UAAU,EAAE,MAAM,CAAE,EAAE,GACvD,OAAO,CAAC,MAAM,UAAU,EAAE,MAAM,CAAC,CAC1C,GACC,CACE,UAAU,CAAC,UAAU,CAAC,CAAC,MAAM,UAAU,CAAC,UAAU,CAAC,CAAC,CACvD,CAAC;AAEN,KAAK,oBAAoB,CAAC,UAAU,IAChC;KAEI,GAAG,IAAI,MAAM,UAAU,IAAI,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,GAC1F,GAAG,GACH,KAAK,GACR,UAAU,CAAC,GAAG,CAAC;CACrB,CAAC;AAEN,KAAK,cAAc,CAAC,UAAU,IAAI,MAAM,oBAAoB,CAAC,UAAU,CAAC,CAAC;AAEzE,KAAK,UAAU,CAAC,UAAU,IACtB;KACM,GAAG,IAAI,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,GACpD,GAAI,GAAI,IAAK,aAAa,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAE,EAAE;CACvE,CAAC"
+}

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

@@ -0,0 +1,32 @@
+/**
+ * @file      Record.Internal.Types.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+import type { TPath } from "./Record.Types.mjs";
+type FDepthMap = {
+    3: 2;
+    2: 1;
+    1: 0;
+};
+type FDepth = keyof FDepthMap | 0;
+type FValidDepth = keyof FDepthMap;
+type TDepthMinusOne<DepthType extends FDepth> = DepthType extends FValidDepth ? FDepthMap[DepthType] : 0;
+export type TFromPathInternal<RecordType, PathType extends TPath<RecordType>, DepthType extends FDepth = 3> = DepthType extends FValidDepth ? PathType extends `${infer HeadType}.${infer RemainingPathType}` ? HeadType extends keyof RecordType ? RemainingPathType extends keyof RecordType[HeadType] ? TFromPathInternal<RecordType[HeadType], Extract<RemainingPathType, string>, TDepthMinusOne<DepthType>> : never : never : PathType extends keyof RecordType ? RecordType[PathType] : never : PathType extends keyof RecordType ? RecordType[PathType] : never;
+/**
+ * @template RecordType - The {@link Record} type from which this path is constructed.
+ *
+ * @template ParentKey - The use of this parameter--for reasons that I do not
+ * understand--prevent an error regarding stack depth when evaluating this type.
+ */
+export type TPathInternal<RecordType, ParentKey extends string | undefined = undefined> = (ParentKey extends string ? `${ParentKey}.${Extract<keyof RecordType, string>}` : Extract<keyof RecordType, string>) | (TMapToPath<RecordType>[keyof TMapToPath<RecordType>]);
+type TGetRecordProperties<RecordType> = {
+    [Key in keyof RecordType as RecordType[Extract<Key, string>] extends Record<PropertyKey, unknown> ? Key : never]: RecordType[Key];
+};
+type TGetRecordKeys<RecordType> = keyof TGetRecordProperties<RecordType>;
+type TMapToPath<RecordType> = {
+    [Key in Extract<TGetRecordKeys<RecordType>, string>]: `${Key}.${TPathInternal<TGetRecordProperties<RecordType>[Key]>}`;
+};
+export {};
+//# sourceMappingURL=Record.Internal.Types.d.mts.map

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

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "Record.Internal.Types.d.mts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/Record/Record.Internal.Types.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C,KAAK,SAAS,GACV;IACI,CAAC,EAAE,CAAC,CAAC;IACL,CAAC,EAAE,CAAC,CAAC;IACL,CAAC,EAAE,CAAC,CAAC;CACR,CAAC;AAEN,KAAK,MAAM,GAAG,MAAM,SAAS,GAAG,CAAC,CAAC;AAClC,KAAK,WAAW,GAAG,MAAM,SAAS,CAAC;AAEnC,KAAK,cAAc,CAAC,SAAS,SAAS,MAAM,IAAI,SAAS,SAAS,WAAW,GACvE,SAAS,CAAC,SAAS,CAAC,GACpB,CAAC,CAAC;AAIR,MAAM,MAAM,iBAAiB,CACzB,UAAU,EACV,QAAQ,SAAS,KAAK,CAAC,UAAU,CAAC,EAClC,SAAS,SAAS,MAAM,GAAG,CAAC,IAE5B,SAAS,SAAS,WAAW,GACvB,QAAQ,SAAS,GAAI,MAAM,QAAS,IAAK,MAAM,iBAAkB,EAAE,GAC/D,QAAQ,SAAS,MAAM,UAAU,GAC7B,iBAAiB,SAAS,MAAM,UAAU,CAAC,QAAQ,CAAC,GAChD,iBAAiB,CACf,UAAU,CAAC,QAAQ,CAAC,EACpB,OAAO,CAAC,iBAAiB,EAAE,MAAM,CAAC,EAClC,cAAc,CAAC,SAAS,CAAC,CAC5B,GACC,KAAK,GACT,KAAK,GACT,QAAQ,SAAS,MAAM,UAAU,GAC7B,UAAU,CAAC,QAAQ,CAAC,GACpB,KAAK,GACb,QAAQ,SAAS,MAAM,UAAU,GAC7B,UAAU,CAAC,QAAQ,CAAC,GACpB,KAAK,CAAC;AAIpB;;;;;GAKG;AACH,MAAM,MAAM,aAAa,CACrB,UAAU,EACV,SAAS,SAAS,MAAM,GAAG,SAAS,GAAG,SAAS,IAE9C,CACE,SAAS,SAAS,MAAM,GAClB,GAAI,SAAU,IAAK,OAAO,CAAC,MAAM,UAAU,EAAE,MAAM,CAAE,EAAE,GACvD,OAAO,CAAC,MAAM,UAAU,EAAE,MAAM,CAAC,CAC1C,GACC,CACE,UAAU,CAAC,UAAU,CAAC,CAAC,MAAM,UAAU,CAAC,UAAU,CAAC,CAAC,CACvD,CAAC;AAEN,KAAK,oBAAoB,CAAC,UAAU,IAChC;KAEI,GAAG,IAAI,MAAM,UAAU,IAAI,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,GAC1F,GAAG,GACH,KAAK,GACR,UAAU,CAAC,GAAG,CAAC;CACrB,CAAC;AAEN,KAAK,cAAc,CAAC,UAAU,IAAI,MAAM,oBAAoB,CAAC,UAAU,CAAC,CAAC;AAEzE,KAAK,UAAU,CAAC,UAAU,IACtB;KACM,GAAG,IAAI,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,GACpD,GAAI,GAAI,IAAK,aAAa,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAE,EAAE;CACvE,CAAC"
+}

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

@@ -0,0 +1,32 @@
+/**
+ * @file      Record.Internal.Types.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+import type { TPath } from "./Record.Types.ts";
+type FDepthMap = {
+    3: 2;
+    2: 1;
+    1: 0;
+};
+type FDepth = keyof FDepthMap | 0;
+type FValidDepth = keyof FDepthMap;
+type TDepthMinusOne<DepthType extends FDepth> = DepthType extends FValidDepth ? FDepthMap[DepthType] : 0;
+export type TFromPathInternal<RecordType, PathType extends TPath<RecordType>, DepthType extends FDepth = 3> = DepthType extends FValidDepth ? PathType extends `${infer HeadType}.${infer RemainingPathType}` ? HeadType extends keyof RecordType ? RemainingPathType extends keyof RecordType[HeadType] ? TFromPathInternal<RecordType[HeadType], Extract<RemainingPathType, string>, TDepthMinusOne<DepthType>> : never : never : PathType extends keyof RecordType ? RecordType[PathType] : never : PathType extends keyof RecordType ? RecordType[PathType] : never;
+/**
+ * @template RecordType - The {@link Record} type from which this path is constructed.
+ *
+ * @template ParentKey - The use of this parameter--for reasons that I do not
+ * understand--prevent an error regarding stack depth when evaluating this type.
+ */
+export type TPathInternal<RecordType, ParentKey extends string | undefined = undefined> = (ParentKey extends string ? `${ParentKey}.${Extract<keyof RecordType, string>}` : Extract<keyof RecordType, string>) | (TMapToPath<RecordType>[keyof TMapToPath<RecordType>]);
+type TGetRecordProperties<RecordType> = {
+    [Key in keyof RecordType as RecordType[Extract<Key, string>] extends Record<PropertyKey, unknown> ? Key : never]: RecordType[Key];
+};
+type TGetRecordKeys<RecordType> = keyof TGetRecordProperties<RecordType>;
+type TMapToPath<RecordType> = {
+    [Key in Extract<TGetRecordKeys<RecordType>, string>]: `${Key}.${TPathInternal<TGetRecordProperties<RecordType>[Key]>}`;
+};
+export {};
+//# sourceMappingURL=Record.Internal.Types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Record.Internal.Types.d.ts","sourceRoot":"","sources":["../../../Source/Record/Record.Internal.Types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C,KAAK,SAAS,GACV;IACI,CAAC,EAAE,CAAC,CAAC;IACL,CAAC,EAAE,CAAC,CAAC;IACL,CAAC,EAAE,CAAC,CAAC;CACR,CAAC;AAEN,KAAK,MAAM,GAAG,MAAM,SAAS,GAAG,CAAC,CAAC;AAClC,KAAK,WAAW,GAAG,MAAM,SAAS,CAAC;AAEnC,KAAK,cAAc,CAAC,SAAS,SAAS,MAAM,IAAI,SAAS,SAAS,WAAW,GACvE,SAAS,CAAC,SAAS,CAAC,GACpB,CAAC,CAAC;AAIR,MAAM,MAAM,iBAAiB,CACzB,UAAU,EACV,QAAQ,SAAS,KAAK,CAAC,UAAU,CAAC,EAClC,SAAS,SAAS,MAAM,GAAG,CAAC,IAE5B,SAAS,SAAS,WAAW,GACvB,QAAQ,SAAS,GAAI,MAAM,QAAS,IAAK,MAAM,iBAAkB,EAAE,GAC/D,QAAQ,SAAS,MAAM,UAAU,GAC7B,iBAAiB,SAAS,MAAM,UAAU,CAAC,QAAQ,CAAC,GAChD,iBAAiB,CACf,UAAU,CAAC,QAAQ,CAAC,EACpB,OAAO,CAAC,iBAAiB,EAAE,MAAM,CAAC,EAClC,cAAc,CAAC,SAAS,CAAC,CAC5B,GACC,KAAK,GACT,KAAK,GACT,QAAQ,SAAS,MAAM,UAAU,GAC7B,UAAU,CAAC,QAAQ,CAAC,GACpB,KAAK,GACb,QAAQ,SAAS,MAAM,UAAU,GAC7B,UAAU,CAAC,QAAQ,CAAC,GACpB,KAAK,CAAC;AAIpB;;;;;GAKG;AACH,MAAM,MAAM,aAAa,CACrB,UAAU,EACV,SAAS,SAAS,MAAM,GAAG,SAAS,GAAG,SAAS,IAE9C,CACE,SAAS,SAAS,MAAM,GAClB,GAAI,SAAU,IAAK,OAAO,CAAC,MAAM,UAAU,EAAE,MAAM,CAAE,EAAE,GACvD,OAAO,CAAC,MAAM,UAAU,EAAE,MAAM,CAAC,CAC1C,GACC,CACE,UAAU,CAAC,UAAU,CAAC,CAAC,MAAM,UAAU,CAAC,UAAU,CAAC,CAAC,CACvD,CAAC;AAEN,KAAK,oBAAoB,CAAC,UAAU,IAChC;KAEI,GAAG,IAAI,MAAM,UAAU,IAAI,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,GAC1F,GAAG,GACH,KAAK,GACR,UAAU,CAAC,GAAG,CAAC;CACrB,CAAC;AAEN,KAAK,cAAc,CAAC,UAAU,IAAI,MAAM,oBAAoB,CAAC,UAAU,CAAC,CAAC;AAEzE,KAAK,UAAU,CAAC,UAAU,IACtB;KACM,GAAG,IAAI,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,GACpD,GAAI,GAAI,IAAK,aAAa,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAE,EAAE;CACvE,CAAC"}

package/Distribution/Types/Record/Record.Types.d.cts

@@ -0,0 +1,78 @@
+/**
+ * @file      Record.Types.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+import type { TFromPathInternal, TPathInternal } from "./Record.Internal.Types.cjs";
+import type { TMaybeArray } from "../Array/index.cjs";
+/**
+ * Given a {@link RecordType} and a {@link PathType} of the given {@link RecordType},
+ * this type evaluates to the type of the property given by the {@link PathType} of
+ * the given {@link RecordType}.
+ *
+ * @template RecordType - The {@link Record} type to which the given {@link PathType}
+ * will be applied.
+ *
+ * @template PathType - The {@link TPath} type that describes the property within the
+ * given {@link RecordType} whose type to which this will evaluate.
+ */
+export type TFromPath<RecordType, PathType extends TPath<RecordType>> = TFromPathInternal<RecordType, PathType, 3>;
+/**
+ * Given a {@link RecordType}, this type is the union of `.`-delimited paths to properties
+ * with the {@link RecordType}.  Nested properties are supported.
+ *
+ * @template RecordType - The {@link Record} type to which the given {@link PathType}
+ * will be applied.
+ */
+export type TPath<RecordType> = TPathInternal<RecordType>;
+/**
+ * A simple wrapper to allow passing primitives to functions by-reference.
+ *
+ * @template Type - The type of the value wrapped by this.
+ */
+export type TRef<Type> = {
+    Ref: Type | undefined;
+};
+/**
+ * The function that maps a {@link Record} to an {@link Array} via {@link MapRecord}.
+ *
+ * @template KeyType - The type of the keys of the {@link Record} that is transformed by this.
+ * @template PropertyType - The type of the values of the properties in the {@link Record}
+ * that is transformed by this.
+ * @template ElementType - The type of the elements in the {@link Array} that is returned by this.
+ */
+export type TMapRecordTransformer<KeyType extends PropertyKey, PropertyType, ElementType> = {
+    /**
+     * The function that maps a {@link Record} to an {@link Array} via {@link MapRecord}.
+     *
+     * @param Key - The key of the property that is being mapped.
+     * @param Property - The value of the property that is being mapped.
+     * @param Index - The index at which this property appears in the {@link Record}
+     * that is transformed by this.
+     */
+    (Key: KeyType, Property: PropertyType, Index: number): ElementType;
+};
+/**
+ * The function that maps a {@link Record} to an {@link Array} via {@link FlatMapRecord}.
+ *
+ * @template KeyType - The type of the keys of the {@link Record} that is transformed by this.
+ * @template PropertyType - The type of the values of the properties in the {@link Record}
+ * that is transformed by this.
+ * @template ElementType - The type of the elements in the {@link Array} that is returned by this.
+ */
+export type TFlatMapRecordTransformer<KeyType extends PropertyKey, PropertyType, ElementType> = {
+    /**
+     * The function that maps a {@link Record} to an {@link Array} via {@link FlatMapRecord}.
+     *
+     * @param Key - The key of the property that is being mapped.
+     * @param Property - The value of the property that is being mapped.
+     * @param Index - The index at which this property appears in the {@link Record}
+     * that is transformed by this.
+     *
+     * @returns {TMaybeArray<ElementType>} A single element, or an {@link Array} that resulted
+     * from the given property being transformed.
+     */
+    (Key: KeyType, Property: PropertyType, Index: number): TMaybeArray<ElementType>;
+};
+//# sourceMappingURL=Record.Types.d.cts.map

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

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "Record.Types.d.cts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/Record/Record.Types.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AACnF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,SAAS,CACjB,UAAU,EACV,QAAQ,SAAS,KAAK,CAAC,UAAU,CAAC,IAClC,iBAAiB,CAAC,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;AAE/C;;;;;;GAMG;AACH,MAAM,MAAM,KAAK,CAAC,UAAU,IAAI,aAAa,CAAC,UAAU,CAAC,CAAC;AAE1D;;;;GAIG;AACH,MAAM,MAAM,IAAI,CAAC,IAAI,IAAI;IAAE,GAAG,EAAE,IAAI,GAAG,SAAS,CAAA;CAAE,CAAC;AAEnD;;;;;;;GAOG;AACH,MAAM,MAAM,qBAAqB,CAC7B,OAAO,SAAS,WAAW,EAC3B,YAAY,EACZ,WAAW,IAEX;IACI;;;;;;;OAOG;IACH,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CAAC;CACtE,CAAC;AAEN;;;;;;;GAOG;AACH,MAAM,MAAM,yBAAyB,CACjC,OAAO,SAAS,WAAW,EAC3B,YAAY,EACZ,WAAW,IAEX;IACI;;;;;;;;;;OAUG;IACH,CACI,GAAG,EAAE,OAAO,EACZ,QAAQ,EAAE,YAAY,EACtB,KAAK,EAAE,MAAM,GACd,WAAW,CAAC,WAAW,CAAC,CAAC;CAC/B,CAAC"
+}

package/Distribution/Types/Record/Record.Types.d.mts

@@ -0,0 +1,78 @@
+/**
+ * @file      Record.Types.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+import type { TFromPathInternal, TPathInternal } from "./Record.Internal.Types.mjs";
+import type { TMaybeArray } from "../Array/index.mjs";
+/**
+ * Given a {@link RecordType} and a {@link PathType} of the given {@link RecordType},
+ * this type evaluates to the type of the property given by the {@link PathType} of
+ * the given {@link RecordType}.
+ *
+ * @template RecordType - The {@link Record} type to which the given {@link PathType}
+ * will be applied.
+ *
+ * @template PathType - The {@link TPath} type that describes the property within the
+ * given {@link RecordType} whose type to which this will evaluate.
+ */
+export type TFromPath<RecordType, PathType extends TPath<RecordType>> = TFromPathInternal<RecordType, PathType, 3>;
+/**
+ * Given a {@link RecordType}, this type is the union of `.`-delimited paths to properties
+ * with the {@link RecordType}.  Nested properties are supported.
+ *
+ * @template RecordType - The {@link Record} type to which the given {@link PathType}
+ * will be applied.
+ */
+export type TPath<RecordType> = TPathInternal<RecordType>;
+/**
+ * A simple wrapper to allow passing primitives to functions by-reference.
+ *
+ * @template Type - The type of the value wrapped by this.
+ */
+export type TRef<Type> = {
+    Ref: Type | undefined;
+};
+/**
+ * The function that maps a {@link Record} to an {@link Array} via {@link MapRecord}.
+ *
+ * @template KeyType - The type of the keys of the {@link Record} that is transformed by this.
+ * @template PropertyType - The type of the values of the properties in the {@link Record}
+ * that is transformed by this.
+ * @template ElementType - The type of the elements in the {@link Array} that is returned by this.
+ */
+export type TMapRecordTransformer<KeyType extends PropertyKey, PropertyType, ElementType> = {
+    /**
+     * The function that maps a {@link Record} to an {@link Array} via {@link MapRecord}.
+     *
+     * @param Key - The key of the property that is being mapped.
+     * @param Property - The value of the property that is being mapped.
+     * @param Index - The index at which this property appears in the {@link Record}
+     * that is transformed by this.
+     */
+    (Key: KeyType, Property: PropertyType, Index: number): ElementType;
+};
+/**
+ * The function that maps a {@link Record} to an {@link Array} via {@link FlatMapRecord}.
+ *
+ * @template KeyType - The type of the keys of the {@link Record} that is transformed by this.
+ * @template PropertyType - The type of the values of the properties in the {@link Record}
+ * that is transformed by this.
+ * @template ElementType - The type of the elements in the {@link Array} that is returned by this.
+ */
+export type TFlatMapRecordTransformer<KeyType extends PropertyKey, PropertyType, ElementType> = {
+    /**
+     * The function that maps a {@link Record} to an {@link Array} via {@link FlatMapRecord}.
+     *
+     * @param Key - The key of the property that is being mapped.
+     * @param Property - The value of the property that is being mapped.
+     * @param Index - The index at which this property appears in the {@link Record}
+     * that is transformed by this.
+     *
+     * @returns {TMaybeArray<ElementType>} A single element, or an {@link Array} that resulted
+     * from the given property being transformed.
+     */
+    (Key: KeyType, Property: PropertyType, Index: number): TMaybeArray<ElementType>;
+};
+//# sourceMappingURL=Record.Types.d.mts.map

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

@@ -0,0 +1,10 @@
+{
+    "version": 3,
+    "file": "Record.Types.d.mts",
+    "sourceRoot": "",
+    "sources": [
+        "../../../Source/Record/Record.Types.ts"
+    ],
+    "names": [],
+    "mappings": "AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AACnF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,SAAS,CACjB,UAAU,EACV,QAAQ,SAAS,KAAK,CAAC,UAAU,CAAC,IAClC,iBAAiB,CAAC,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;AAE/C;;;;;;GAMG;AACH,MAAM,MAAM,KAAK,CAAC,UAAU,IAAI,aAAa,CAAC,UAAU,CAAC,CAAC;AAE1D;;;;GAIG;AACH,MAAM,MAAM,IAAI,CAAC,IAAI,IAAI;IAAE,GAAG,EAAE,IAAI,GAAG,SAAS,CAAA;CAAE,CAAC;AAEnD;;;;;;;GAOG;AACH,MAAM,MAAM,qBAAqB,CAC7B,OAAO,SAAS,WAAW,EAC3B,YAAY,EACZ,WAAW,IAEX;IACI;;;;;;;OAOG;IACH,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CAAC;CACtE,CAAC;AAEN;;;;;;;GAOG;AACH,MAAM,MAAM,yBAAyB,CACjC,OAAO,SAAS,WAAW,EAC3B,YAAY,EACZ,WAAW,IAEX;IACI;;;;;;;;;;OAUG;IACH,CACI,GAAG,EAAE,OAAO,EACZ,QAAQ,EAAE,YAAY,EACtB,KAAK,EAAE,MAAM,GACd,WAAW,CAAC,WAAW,CAAC,CAAC;CAC/B,CAAC"
+}

package/Distribution/Types/Record/Record.Types.d.ts

@@ -0,0 +1,78 @@
+/**
+ * @file      Record.Types.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+import type { TFromPathInternal, TPathInternal } from "./Record.Internal.Types.ts";
+import type { TMaybeArray } from "../Array/index.ts";
+/**
+ * Given a {@link RecordType} and a {@link PathType} of the given {@link RecordType},
+ * this type evaluates to the type of the property given by the {@link PathType} of
+ * the given {@link RecordType}.
+ *
+ * @template RecordType - The {@link Record} type to which the given {@link PathType}
+ * will be applied.
+ *
+ * @template PathType - The {@link TPath} type that describes the property within the
+ * given {@link RecordType} whose type to which this will evaluate.
+ */
+export type TFromPath<RecordType, PathType extends TPath<RecordType>> = TFromPathInternal<RecordType, PathType, 3>;
+/**
+ * Given a {@link RecordType}, this type is the union of `.`-delimited paths to properties
+ * with the {@link RecordType}.  Nested properties are supported.
+ *
+ * @template RecordType - The {@link Record} type to which the given {@link PathType}
+ * will be applied.
+ */
+export type TPath<RecordType> = TPathInternal<RecordType>;
+/**
+ * A simple wrapper to allow passing primitives to functions by-reference.
+ *
+ * @template Type - The type of the value wrapped by this.
+ */
+export type TRef<Type> = {
+    Ref: Type | undefined;
+};
+/**
+ * The function that maps a {@link Record} to an {@link Array} via {@link MapRecord}.
+ *
+ * @template KeyType - The type of the keys of the {@link Record} that is transformed by this.
+ * @template PropertyType - The type of the values of the properties in the {@link Record}
+ * that is transformed by this.
+ * @template ElementType - The type of the elements in the {@link Array} that is returned by this.
+ */
+export type TMapRecordTransformer<KeyType extends PropertyKey, PropertyType, ElementType> = {
+    /**
+     * The function that maps a {@link Record} to an {@link Array} via {@link MapRecord}.
+     *
+     * @param Key - The key of the property that is being mapped.
+     * @param Property - The value of the property that is being mapped.
+     * @param Index - The index at which this property appears in the {@link Record}
+     * that is transformed by this.
+     */
+    (Key: KeyType, Property: PropertyType, Index: number): ElementType;
+};
+/**
+ * The function that maps a {@link Record} to an {@link Array} via {@link FlatMapRecord}.
+ *
+ * @template KeyType - The type of the keys of the {@link Record} that is transformed by this.
+ * @template PropertyType - The type of the values of the properties in the {@link Record}
+ * that is transformed by this.
+ * @template ElementType - The type of the elements in the {@link Array} that is returned by this.
+ */
+export type TFlatMapRecordTransformer<KeyType extends PropertyKey, PropertyType, ElementType> = {
+    /**
+     * The function that maps a {@link Record} to an {@link Array} via {@link FlatMapRecord}.
+     *
+     * @param Key - The key of the property that is being mapped.
+     * @param Property - The value of the property that is being mapped.
+     * @param Index - The index at which this property appears in the {@link Record}
+     * that is transformed by this.
+     *
+     * @returns {TMaybeArray<ElementType>} A single element, or an {@link Array} that resulted
+     * from the given property being transformed.
+     */
+    (Key: KeyType, Property: PropertyType, Index: number): TMaybeArray<ElementType>;
+};
+//# sourceMappingURL=Record.Types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Record.Types.d.ts","sourceRoot":"","sources":["../../../Source/Record/Record.Types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AACnF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,SAAS,CACjB,UAAU,EACV,QAAQ,SAAS,KAAK,CAAC,UAAU,CAAC,IAClC,iBAAiB,CAAC,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;AAE/C;;;;;;GAMG;AACH,MAAM,MAAM,KAAK,CAAC,UAAU,IAAI,aAAa,CAAC,UAAU,CAAC,CAAC;AAE1D;;;;GAIG;AACH,MAAM,MAAM,IAAI,CAAC,IAAI,IAAI;IAAE,GAAG,EAAE,IAAI,GAAG,SAAS,CAAA;CAAE,CAAC;AAEnD;;;;;;;GAOG;AACH,MAAM,MAAM,qBAAqB,CAC7B,OAAO,SAAS,WAAW,EAC3B,YAAY,EACZ,WAAW,IAEX;IACI;;;;;;;OAOG;IACH,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CAAC;CACtE,CAAC;AAEN;;;;;;;GAOG;AACH,MAAM,MAAM,yBAAyB,CACjC,OAAO,SAAS,WAAW,EAC3B,YAAY,EACZ,WAAW,IAEX;IACI;;;;;;;;;;OAUG;IACH,CACI,GAAG,EAAE,OAAO,EACZ,QAAQ,EAAE,YAAY,EACtB,KAAK,EAAE,MAAM,GACd,WAAW,CAAC,WAAW,CAAC,CAAC;CAC/B,CAAC"}