@sorrell/cli-utilities 1.0.41 → 1.0.43

package/Distribution/PackageConfig/Index.Inner.d.ts

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

package/Distribution/PackageConfig/Index.Inner.d.ts.map

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

package/Distribution/PackageConfig/Index.Inner.js

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

package/Distribution/PackageConfig/Index.Inner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Index.Inner.js","sourceRoot":"","sources":["../../Source/PackageConfig/Index.Inner.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,oBAAoB,CAAC"}

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

@@ -0,0 +1,16 @@
+/**
+ * @file      PackageConfig.Internal.Types.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+import type { ConfigError, Effect, ConfigProvider as EffectConfigProvider } from "effect";
+import type { IPackageJson } from "package-json-type";
+/**
+ * The base type for the `Record-like` of the desired
+ * {@link ConfigProvider!SettingsType | SettingsType}.
+ */
+export type FSettingsRecord = Readonly<Record<string, unknown>>;
+export type ELoadResolvedProvider = Effect.Effect<EffectConfigProvider.ConfigProvider, any, never>;
+export type EReadPackageJson = Effect.Effect<IPackageJson, ConfigError.ConfigError>;
+//# sourceMappingURL=PackageConfig.Internal.Types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PackageConfig.Internal.Types.d.ts","sourceRoot":"","sources":["../../Source/PackageConfig/PackageConfig.Internal.Types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,cAAc,IAAI,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAG1F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAGhE,MAAM,MAAM,qBAAqB,GAC7B,MAAM,CAAC,MAAM,CACT,oBAAoB,CAAC,cAAc,EAEnC,GAAG,EACH,KAAK,CACR,CAAC;AAGN,MAAM,MAAM,gBAAgB,GACxB,MAAM,CAAC,MAAM,CACT,YAAY,EACZ,WAAW,CAAC,WAAW,CAC1B,CAAC"}

package/Distribution/PackageConfig/PackageConfig.Internal.Types.js

@@ -0,0 +1,8 @@
+/**
+ * @file      PackageConfig.Internal.Types.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+export {};
+//# sourceMappingURL=PackageConfig.Internal.Types.js.map

package/Distribution/PackageConfig/PackageConfig.Internal.Types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PackageConfig.Internal.Types.js","sourceRoot":"","sources":["../../Source/PackageConfig/PackageConfig.Internal.Types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/Distribution/PackageConfig/PackageConfig.Internal.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @file      PackageConfig.Internal.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+import { ConfigError, ConfigProvider, Effect, Schema } from "effect";
+import type { EReadPackageJson, FSettingsRecord } from "./PackageConfig.Internal.Types.js";
+import { type RootDirectoryNotFoundError } from "@sorrell/utilities/npm";
+export declare function IsRecordLike(Value: unknown): Value is Record<string, unknown>;
+export declare function HasNodeErrorCode(Value: unknown, Code: string): boolean;
+export declare function ErrorToMessage(Value: unknown): string;
+export declare function DecodeSettingsProviderEffect<SettingsType extends FSettingsRecord, EncodedType>(Value: unknown, ConfigPath: ReadonlyArray<string>, SettingsSchema: Schema.Schema<SettingsType, EncodedType, never>): Effect.Effect<ConfigProvider.ConfigProvider, ConfigError.ConfigError>;
+export declare function LoadJsonFileProviderEffect<Settings extends FSettingsRecord, Encoded>(ConfigFilePath: string, ConfigPath: ReadonlyArray<string>, SettingsSchema: Schema.Schema<Settings, Encoded, never>): Effect.Effect<ConfigProvider.ConfigProvider, ConfigError.ConfigError>;
+export declare function BuildResolvedProviderEffect<Settings extends FSettingsRecord, Encoded>(PackageName: string, SettingsSchema: Schema.Schema<Settings, Encoded, never>, DefaultFileName: string | undefined): Effect.Effect<ConfigProvider.ConfigProvider, ConfigError.ConfigError | RootDirectoryNotFoundError>;
+export declare function ReadPackageJsonEffect(PackageName: string): EReadPackageJson;
+//# sourceMappingURL=PackageConfig.Internal.d.ts.map

package/Distribution/PackageConfig/PackageConfig.Internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PackageConfig.Internal.d.ts","sourceRoot":"","sources":["../../Source/PackageConfig/PackageConfig.Internal.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAS,WAAW,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC5E,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAC3F,OAAO,EAAkB,KAAK,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AASzF,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAG7E;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAGtE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQrD;AAED,wBAAgB,4BAA4B,CACxC,YAAY,SAAS,eAAe,EACpC,WAAW,EAEX,KAAK,EAAE,OAAO,EACd,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,EACjC,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,WAAW,EAAE,KAAK,CAAC,GAChE,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,cAAc,EAAE,WAAW,CAAC,WAAW,CAAC,CAkBvE;AAED,wBAAgB,0BAA0B,CACtC,QAAQ,SAAS,eAAe,EAChC,OAAO,EAEP,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,EACjC,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,GACxD,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,cAAc,EAAE,WAAW,CAAC,WAAW,CAAC,CA6CvE;AAED,wBAAgB,2BAA2B,CACvC,QAAQ,SAAS,eAAe,EAChC,OAAO,EAEP,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,EACvD,eAAe,EAAE,MAAM,GAAG,SAAS,GACpC,MAAM,CAAC,MAAM,CACZ,cAAc,CAAC,cAAc,EAC7B,WAAW,CAAC,WAAW,GAAG,0BAA0B,CACvD,CAgEA;AAED,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,gBAAgB,CAkB3E"}

package/Distribution/PackageConfig/PackageConfig.Internal.js

@@ -0,0 +1,88 @@
+/**
+ * @file      PackageConfig.Internal.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+import { Cause, ConfigError, ConfigProvider, Effect, Schema } from "effect";
+import { GetPackageJson } from "@sorrell/utilities/npm";
+import Fs from "fs/promises";
+import { GetPackageRootDirectory } from "@sorrell/utilities/npm/effect";
+import Path from "path";
+/* eslint-disable jsdoc/require-jsdoc */
+export function IsRecordLike(Value) {
+    return typeof Value === "object" && Value !== null && !Array.isArray(Value);
+}
+export function HasNodeErrorCode(Value, Code) {
+    return IsRecordLike(Value) && Value["code"] === Code;
+}
+export function ErrorToMessage(Value) {
+    if (Value instanceof Error && Value.message.length > 0) {
+        return Value.message;
+    }
+    return String(Value);
+}
+export function DecodeSettingsProviderEffect(Value, ConfigPath, SettingsSchema) {
+    return Schema.decodeUnknown(SettingsSchema, {
+        errors: "all",
+        onExcessProperty: "error"
+    })(Value).pipe(Effect.map((Settings) => ConfigProvider.fromJson(Settings)), Effect.mapError((TheParseError) => {
+        return ConfigError.InvalidData([...ConfigPath], `Config value does not conform to the settings schema: ${String(TheParseError)}`);
+    }));
+}
+export function LoadJsonFileProviderEffect(ConfigFilePath, ConfigPath, SettingsSchema) {
+    return Effect.gen(function* () {
+        const FileContents = yield* Effect.tryPromise({
+            catch: (ErrorCause) => {
+                if (HasNodeErrorCode(ErrorCause, "ENOENT")) {
+                    return ConfigError.MissingData([...ConfigPath], `Config file does not exist: ${ConfigFilePath}`);
+                }
+                return ConfigError.SourceUnavailable([...ConfigPath], `Could not read config file ${ConfigFilePath}: ${ErrorToMessage(ErrorCause)}`, Cause.fail(ErrorCause));
+            },
+            try: () => Fs.readFile(ConfigFilePath, "utf-8")
+        });
+        const JsonValue = yield* Effect.try({
+            catch: (ErrorCause) => {
+                return ConfigError.InvalidData([...ConfigPath], `Config file is not valid JSON: ${ErrorToMessage(ErrorCause)}`);
+            },
+            try: () => JSON.parse(FileContents)
+        });
+        return yield* DecodeSettingsProviderEffect(JsonValue, ConfigPath, SettingsSchema);
+    });
+}
+export function BuildResolvedProviderEffect(PackageName, SettingsSchema, DefaultFileName) {
+    return Effect.gen(function* () {
+        const PackageJson = yield* ReadPackageJsonEffect(PackageName);
+        const PackageJsonPath = yield* GetPackageRootDirectory();
+        const PackageJsonDirectory = Path.dirname(PackageJsonPath);
+        const ConfigSection = PackageJson.config;
+        if (IsRecordLike(ConfigSection) && Object.hasOwn(ConfigSection, PackageName)) {
+            const PackageConfigValue = ConfigSection[PackageName];
+            if (typeof PackageConfigValue === "string") {
+                const ConfigFilePath = Path.resolve(PackageJsonDirectory, PackageConfigValue);
+                return yield* LoadJsonFileProviderEffect(ConfigFilePath, ["config", PackageName], SettingsSchema);
+            }
+            if (IsRecordLike(PackageConfigValue)) {
+                return yield* DecodeSettingsProviderEffect(PackageConfigValue, ["config", PackageName], SettingsSchema);
+            }
+            return yield* Effect.fail(ConfigError.Unsupported(["config", PackageName], `Expected package.json config["${PackageName}"] to be ` +
+                "either a string path or a JSON object."));
+        }
+        if (DefaultFileName !== undefined) {
+            const DefaultConfigFilePath = Path.resolve(PackageJsonDirectory, DefaultFileName);
+            return yield* LoadJsonFileProviderEffect(DefaultConfigFilePath, [DefaultFileName], SettingsSchema);
+        }
+        return yield* Effect.fail(ConfigError.MissingData(["config", PackageName], `Missing package.json config["${PackageName}"], and no ` +
+            "default file name was provided."));
+    });
+}
+export function ReadPackageJsonEffect(PackageName) {
+    return Effect.tryPromise({
+        catch: (ErrorCause) => {
+            return ConfigError.SourceUnavailable([PackageName], ("Could not read the package.json for the current " +
+                `working directory: ${ErrorToMessage(ErrorCause)}`), Cause.fail(ErrorCause));
+        },
+        try: () => GetPackageJson()
+    });
+}
+//# sourceMappingURL=PackageConfig.Internal.js.map

package/Distribution/PackageConfig/PackageConfig.Internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PackageConfig.Internal.js","sourceRoot":"","sources":["../../Source/PackageConfig/PackageConfig.Internal.ts"],"names":[],"mappings":"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"}

package/Distribution/PackageConfig/PackageConfig.Types.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"PackageConfig.Types.d.ts","sourceRoot":"","sources":["../../Source/PackageConfig/PackageConfig.Types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/Distribution/PackageConfig/PackageConfig.Types.js

@@ -0,0 +1,8 @@
+/**
+ * @file      PackageConfig.Types.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+export {};
+//# sourceMappingURL=PackageConfig.Types.js.map

package/Distribution/PackageConfig/PackageConfig.Types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PackageConfig.Types.js","sourceRoot":"","sources":["../../Source/PackageConfig/PackageConfig.Types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/Distribution/PackageConfig/PackageConfig.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @file      PackageConfig.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+import type { Schema } from "effect";
+import { ConfigProvider as EffectConfigProvider } from "effect";
+import type { FSettingsRecord } from "./PackageConfig.Internal.Types.js";
+/**
+ * Allow dependents to provide configuration, with two supported workflows,
+ *
+ * 1. Check for a JSON file {@link DefaultFileName} in the root of the dependent,
+ * if a {@link DefaultFileName} is given.
+ *
+ * 2. Check the dependent's `package.json#config` for a `string` property with name
+ * {@link PackageName}, whose value is a path to a JSON file, relative to the
+ * dependent's root directory.
+ *
+ * Method (2) is attempted only if method (1) fails.
+ *
+ * @param PackageName - The name of your package.  It is recommended, but not enforced,
+ * for this to match your package's name exactly.
+ * @param SettingsSchema - The schema against which the found settings will be validated.
+ * @param DefaultFileName - The default name of the settings file for which this function
+ * will look, if specified.
+ *
+ * @returns {EffectConfigProvider.ConfigProvider} The {@link EffectConfigProvider.ConfigProvider}
+ * containing the desired {@link SettingsType}.
+ *
+ * @example @TODO
+ */
+export declare function ConfigProvider<SettingsType extends FSettingsRecord, EncodedType>(PackageName: string, SettingsSchema: Schema.Schema<SettingsType, EncodedType, never>, DefaultFileName?: `${string}.json`): EffectConfigProvider.ConfigProvider;
+//# sourceMappingURL=PackageConfig.d.ts.map

package/Distribution/PackageConfig/PackageConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PackageConfig.d.ts","sourceRoot":"","sources":["../../Source/PackageConfig/PackageConfig.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAU,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC7C,OAAO,EAAmC,cAAc,IAAI,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AACjG,OAAO,KAAK,EAAyB,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAGhG;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,cAAc,CAC1B,YAAY,SAAS,eAAe,EACpC,WAAW,EAEX,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,WAAW,EAAE,KAAK,CAAC,EAC/D,eAAe,CAAC,EAAE,GAAI,MAAO,OAAO,GACrC,oBAAoB,CAAC,cAAc,CA+CrC"}

package/Distribution/PackageConfig/PackageConfig.js

@@ -0,0 +1,49 @@
+/**
+ * @file      PackageConfig.ts
+ * @author    Gage Sorrell <gage@sorrell.sh>
+ * @copyright (c) 2026 Gage Sorrell
+ * @license   MIT
+ */
+import { ConfigProviderPathPatch, Effect, ConfigProvider as EffectConfigProvider } from "effect";
+import { BuildResolvedProviderEffect } from "./PackageConfig.Internal.js";
+/**
+ * Allow dependents to provide configuration, with two supported workflows,
+ *
+ * 1. Check for a JSON file {@link DefaultFileName} in the root of the dependent,
+ * if a {@link DefaultFileName} is given.
+ *
+ * 2. Check the dependent's `package.json#config` for a `string` property with name
+ * {@link PackageName}, whose value is a path to a JSON file, relative to the
+ * dependent's root directory.
+ *
+ * Method (2) is attempted only if method (1) fails.
+ *
+ * @param PackageName - The name of your package.  It is recommended, but not enforced,
+ * for this to match your package's name exactly.
+ * @param SettingsSchema - The schema against which the found settings will be validated.
+ * @param DefaultFileName - The default name of the settings file for which this function
+ * will look, if specified.
+ *
+ * @returns {EffectConfigProvider.ConfigProvider} The {@link EffectConfigProvider.ConfigProvider}
+ * containing the desired {@link SettingsType}.
+ *
+ * @example @TODO
+ */
+export function ConfigProvider(PackageName, SettingsSchema, DefaultFileName) {
+    const LoadResolvedProvider = BuildResolvedProviderEffect(PackageName, SettingsSchema, DefaultFileName);
+    return EffectConfigProvider.make({
+        load: (Configuration) => {
+            return LoadResolvedProvider.pipe(Effect.flatMap((Provider) => Provider.load(Configuration)));
+        },
+        flattened: EffectConfigProvider.makeFlat({
+            patch: ConfigProviderPathPatch.empty,
+            load: (PathSegments, Configuration, Split) => {
+                return LoadResolvedProvider.pipe(Effect.flatMap((Provider) => Provider.flattened.load(PathSegments, Configuration, Split)));
+            },
+            enumerateChildren: (PathSegments) => {
+                return LoadResolvedProvider.pipe(Effect.flatMap((Provider) => Provider.flattened.enumerateChildren(PathSegments)));
+            }
+        })
+    });
+}
+//# sourceMappingURL=PackageConfig.js.map

package/Distribution/PackageConfig/PackageConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PackageConfig.js","sourceRoot":"","sources":["../../Source/PackageConfig/PackageConfig.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,uBAAuB,EAAE,MAAM,EAAE,cAAc,IAAI,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAEjG,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAE1E;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,cAAc,CAI1B,WAAmB,EACnB,cAA+D,EAC/D,eAAoC;IAGpC,MAAM,oBAAoB,GAA0B,2BAA2B,CAC3E,WAAW,EACX,cAAc,EACd,eAAe,CAClB,CAAC;IAEF,OAAO,oBAAoB,CAAC,IAAI,CAC5B;QACI,IAAI,EAAE,CAAQ,aAAmC,EAAE,EAAE;YAEjD,OAAO,oBAAoB,CAAC,IAAI,CAC5B,MAAM,CAAC,OAAO,CAAC,CAAC,QAA6C,EAAE,EAAE,CAC7D,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CACpC,CAAC;QACN,CAAC;QAED,SAAS,EAAE,oBAAoB,CAAC,QAAQ,CACpC;YACI,KAAK,EAAE,uBAAuB,CAAC,KAAK;YAEpC,IAAI,EAAE,CACF,YAAmC,EACnC,aAA6C,EAC7C,KAAc,EAChB,EAAE;gBAEA,OAAO,oBAAoB,CAAC,IAAI,CAC5B,MAAM,CAAC,OAAO,CAAC,CAAC,QAA6C,EAAE,EAAE,CAC7D,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,YAAY,EAAE,aAAa,EAAE,KAAK,CAAC,CAC9D,CACJ,CAAC;YACN,CAAC;YAED,iBAAiB,EAAE,CAAC,YAAmC,EAAE,EAAE;gBAEvD,OAAO,oBAAoB,CAAC,IAAI,CAC5B,MAAM,CAAC,OAAO,CAAC,CAAC,QAA6C,EAAE,EAAE,CAC7D,QAAQ,CAAC,SAAS,CAAC,iBAAiB,CAAC,YAAY,CAAC,CACrD,CACJ,CAAC;YACN,CAAC;SACJ,CACJ;KACJ,CACJ,CAAC;AACN,CAAC"}

package/Distribution/PackageConfig/index.d.ts

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

package/Distribution/PackageConfig/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../Source/PackageConfig/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAC"}

package/Distribution/PackageConfig/index.js

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

package/Distribution/PackageConfig/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../Source/PackageConfig/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAC"}

package/Distribution/index.d.ts

@@ -11,4 +11,5 @@ export * as Inquirer from "./Inquirer/index.js";
 export * as PseudoTerminal from "./PseudoTerminal/index.js";
 export * as Format from "./Format/index.js";
 export * as Ora from "./Ora/index.js";
+export * from "./PackageConfig/index.js";
 //# sourceMappingURL=index.d.ts.map

package/Distribution/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../Source/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,uBAAuB,CAAC;AACtC,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,cAAc,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../Source/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,uBAAuB,CAAC;AACtC,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,cAAc,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,cAAc,0BAA0B,CAAC"}

package/Distribution/index.js

@@ -11,4 +11,5 @@ export * as Inquirer from "./Inquirer/index.js";
 export * as PseudoTerminal from "./PseudoTerminal/index.js";
 export * as Format from "./Format/index.js";
 export * as Ora from "./Ora/index.js";
+export * from "./PackageConfig/index.js";
 //# sourceMappingURL=index.js.map

package/Distribution/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../Source/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,uBAAuB,CAAC;AACtC,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,cAAc,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../Source/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,uBAAuB,CAAC;AACtC,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,cAAc,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,cAAc,0BAA0B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sorrell/cli-utilities",
-  "version": "1.0.41",
+  "version": "1.0.43",
   "description": "Utilities for CLI tools.",
   "keywords": [
     "cli",
@@ -72,7 +72,8 @@
   },
   "devDependencies": {
     "@types/node": "^25.5.0",
-    "@typescript/native-preview": "^7.0.0-dev.20260326.1"
+    "@typescript/native-preview": "^7.0.0-dev.20260326.1",
+    "package-json-type": "^1.1.2"
   },
   "dependencies": {
     "@effect/platform": "^0.96.0",
@@ -81,7 +82,7 @@
     "@inquirer/type": "^4.0.4",
     "@listr2/prompt-adapter-enquirer": "^4.2.1",
     "@sorrell/inquirer-file-selector": "^1.0.4",
-    "@sorrell/utilities": "^1.1.51",
+    "@sorrell/utilities": "^1.1.60",
     "chalk": "^5.6.2",
     "cli-table3": "^0.6.5",
     "clipboardy": "^5.3.1",