@ue-shed/config-explorer 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 UE Shed contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,15 @@
+# Config Explorer
+
+`@ue-shed/config-explorer` is the headless Config Explorer library. It explains the effective
+saved-source value of one Unreal `.ini` section/key for an explicit project and platform, with an
+ordered contribution timeline and complete layer coverage.
+
+Use the root export for the Effect-native Node service and adapters. Use `./browser` for schemas,
+parsing, folding, and comparison projections that do not import Node or filesystem authority. The
+module never reads user-private config locations and does not claim to represent live CVars, Device
+Profiles, command-line overrides, or cooked configuration.
+
+## License
+
+MIT. Unreal Engine is a trademark of Epic Games, Inc. This project is not affiliated with or
+endorsed by Epic Games.

package/dist/browser.d.ts

@@ -0,0 +1,4 @@
+export * from "./schema.js";
+export * from "./merge.js";
+export * from "./parser.js";
+//# sourceMappingURL=browser.d.ts.map

package/dist/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}

package/dist/browser.js

@@ -0,0 +1,4 @@
+export * from "./schema.js";
+export * from "./merge.js";
+export * from "./parser.js";
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}

package/dist/file-access.d.ts

@@ -0,0 +1,25 @@
+import { Context, Effect, Layer, Schema } from "effect";
+declare const ConfigFileAccessError_base: Schema.Class<ConfigFileAccessError, Schema.TaggedStruct<"ConfigFileAccessError", {
+    readonly operation: Schema.Literals<readonly ["read", "list", "stat"]>;
+    readonly message: Schema.String;
+    readonly retrySafe: Schema.Boolean;
+}>, import("effect/Cause").YieldableError>;
+export declare class ConfigFileAccessError extends ConfigFileAccessError_base {
+}
+export interface ConfigDirectoryEntry {
+    readonly name: string;
+    readonly kind: "file" | "directory" | "other";
+}
+export interface ConfigFileAccessApi {
+    readonly exists: (path: string) => Effect.Effect<boolean>;
+    readonly isFile: (path: string) => Effect.Effect<boolean, ConfigFileAccessError>;
+    readonly list: (path: string) => Effect.Effect<readonly ConfigDirectoryEntry[], ConfigFileAccessError>;
+    readonly readText: (path: string) => Effect.Effect<string, ConfigFileAccessError>;
+}
+declare const ConfigFileAccess_base: Context.ServiceClass<ConfigFileAccess, "@ue-shed/config-explorer/ConfigFileAccess", ConfigFileAccessApi>;
+export declare class ConfigFileAccess extends ConfigFileAccess_base {
+}
+export declare const ConfigFileAccessLive: Layer.Layer<ConfigFileAccess, never, never>;
+export declare function makeConfigFileAccessTestLayer(service: ConfigFileAccessApi): Layer.Layer<ConfigFileAccess>;
+export {};
+//# sourceMappingURL=file-access.d.ts.map

package/dist/file-access.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-access.d.ts","sourceRoot":"","sources":["../src/file-access.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;;;;;;AAExD,qBAAa,qBAAsB,SAAQ,0BAO1C;CAAG;AAEJ,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,OAAO,CAAC;CAC9C;AAED,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC1D,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAC;IACjF,QAAQ,CAAC,IAAI,EAAE,CACd,IAAI,EAAE,MAAM,KACR,MAAM,CAAC,MAAM,CAAC,SAAS,oBAAoB,EAAE,EAAE,qBAAqB,CAAC,CAAC;IAC3E,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;CAClF;;AAED,qBAAa,gBAAiB,SAAQ,qBAErC;CAAG;AAUJ,eAAO,MAAM,oBAAoB,6CAqChC,CAAC;AAEF,wBAAgB,6BAA6B,CAC5C,OAAO,EAAE,mBAAmB,GAC1B,KAAK,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAE/B"}

package/dist/file-access.js

@@ -0,0 +1,39 @@
+import { access, readdir, readFile, stat } from "node:fs/promises";
+import { Context, Effect, Layer, Schema } from "effect";
+export class ConfigFileAccessError extends Schema.TaggedErrorClass()("ConfigFileAccessError", {
+    operation: Schema.Literals(["read", "list", "stat"]),
+    message: Schema.String,
+    retrySafe: Schema.Boolean
+}) {
+}
+export class ConfigFileAccess extends Context.Service()("@ue-shed/config-explorer/ConfigFileAccess") {
+}
+function fileError(operation, message, retrySafe = true) {
+    return new ConfigFileAccessError({ operation, message, retrySafe });
+}
+export const ConfigFileAccessLive = Layer.succeed(ConfigFileAccess, ConfigFileAccess.of({
+    exists: Effect.fn("ConfigFileAccess.exists")((path) => Effect.tryPromise({ try: () => access(path), catch: () => undefined }).pipe(Effect.match({ onFailure: () => false, onSuccess: () => true }))),
+    isFile: Effect.fn("ConfigFileAccess.isFile")((path) => Effect.tryPromise({
+        try: () => stat(path).then((value) => value.isFile()),
+        catch: () => fileError("stat", "The selected project path could not be inspected.")
+    })),
+    list: Effect.fn("ConfigFileAccess.list")((path) => Effect.tryPromise({
+        try: () => readdir(path, { withFileTypes: true }).then((entries) => entries.map((entry) => ({
+            name: entry.name,
+            kind: entry.isFile()
+                ? "file"
+                : entry.isDirectory()
+                    ? "directory"
+                    : "other"
+        }))),
+        catch: () => fileError("list", "A required config directory could not be listed.")
+    })),
+    readText: Effect.fn("ConfigFileAccess.readText")((path) => Effect.tryPromise({
+        try: (signal) => readFile(path, { encoding: "utf8", signal }),
+        catch: () => fileError("read", "A selected config file could not be read.")
+    }))
+}));
+export function makeConfigFileAccessTestLayer(service) {
+    return Layer.succeed(ConfigFileAccess, ConfigFileAccess.of(service));
+}
+//# sourceMappingURL=file-access.js.map

package/dist/file-access.js.map

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

package/dist/hierarchy.d.ts

@@ -0,0 +1,26 @@
+import { Effect } from "effect";
+import { ConfigFileAccess, ConfigFileAccessError } from "./file-access.js";
+import type { ConfigSource } from "./schema.js";
+export interface ConfigProject {
+    readonly root: string;
+    readonly descriptor: string;
+    readonly label: string;
+}
+export interface ConfigHierarchyLayer {
+    readonly name: string;
+    readonly path: string;
+    readonly source: ConfigSource;
+}
+export declare function resolveConfigProject(project: string): Effect.Effect<ConfigProject, ConfigFileAccessError, ConfigFileAccess>;
+export declare function buildConfigHierarchy(options: {
+    readonly engineRoot: string;
+    readonly projectRoot: string;
+    readonly family: string;
+    readonly platforms: readonly string[];
+}): readonly ConfigHierarchyLayer[];
+export declare function resolvePlatformChain(options: {
+    readonly engineRoot: string;
+    readonly projectRoot: string;
+    readonly platform: string;
+}): Effect.Effect<readonly string[], ConfigFileAccessError, ConfigFileAccess>;
+//# sourceMappingURL=hierarchy.d.ts.map

package/dist/hierarchy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hierarchy.d.ts","sourceRoot":"","sources":["../src/hierarchy.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;CAC9B;AAUD,wBAAgB,oBAAoB,CACnC,OAAO,EAAE,MAAM,GACb,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,qBAAqB,EAAE,gBAAgB,CAAC,CAwCvE;AA0ED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAC7C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC,GAAG,SAAS,oBAAoB,EAAE,CAgFlC;AAmDD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAC7C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC1B,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,MAAM,EAAE,EAAE,qBAAqB,EAAE,gBAAgB,CAAC,CAmC5E"}

package/dist/hierarchy.js

@@ -0,0 +1,212 @@
+import { basename, dirname, extname, join, relative, resolve, sep } from "node:path";
+import { Effect } from "effect";
+import { ConfigFileAccess, ConfigFileAccessError } from "./file-access.js";
+function invalidProject(message) {
+    return new ConfigFileAccessError({
+        operation: "stat",
+        message,
+        retrySafe: false
+    });
+}
+export function resolveConfigProject(project) {
+    return Effect.gen(function* () {
+        const files = yield* ConfigFileAccess;
+        const selected = resolve(project);
+        const isFile = yield* files
+            .isFile(selected)
+            .pipe(Effect.catch(() => Effect.succeed(false)));
+        if (isFile) {
+            if (extname(selected).toLocaleLowerCase() !== ".uproject") {
+                return yield* Effect.fail(invalidProject("Project selection is not a .uproject file."));
+            }
+            return {
+                root: dirname(selected),
+                descriptor: selected,
+                label: basename(selected, extname(selected))
+            };
+        }
+        const entries = yield* files.list(selected);
+        const descriptors = entries.filter((entry) => entry.kind === "file" && extname(entry.name).toLocaleLowerCase() === ".uproject");
+        if (descriptors.length !== 1) {
+            return yield* Effect.fail(invalidProject(descriptors.length === 0
+                ? "Project root contains no .uproject descriptor."
+                : "Project root contains more than one .uproject descriptor."));
+        }
+        const descriptor = join(selected, descriptors[0].name);
+        return {
+            root: selected,
+            descriptor,
+            label: basename(descriptor, extname(descriptor))
+        };
+    });
+}
+function logicalPath(root, path) {
+    return relative(root, path).split(sep).join("/");
+}
+function layer(name, scope, root, path) {
+    return { name, path, source: { scope, path: logicalPath(root, path) } };
+}
+function expandedPaths(options) {
+    const root = options.template.scope === "engine"
+        ? join(options.engineRoot, "Engine")
+        : options.projectRoot;
+    const sourcePath = options.template.relativePath.replaceAll("{PLATFORM}", options.platform ?? "");
+    const base = join(root, ...sourcePath.split("/"));
+    if (!options.template.expanded)
+        return [{ name: options.template.name, path: base }];
+    const restricted = ["NotForLicensees", "NoRedist", "LimitedAccess"].map((kind) => ({
+        name: `${options.template.name}.Restricted.${kind}`,
+        path: join(root, "Restricted", kind, ...sourcePath.split("/"))
+    }));
+    if (!options.template.platform || options.platform === undefined) {
+        return [{ name: options.template.name, path: base }, ...restricted];
+    }
+    const afterPlatform = sourcePath.replace(`Config/${options.platform}/`, "");
+    const platformExtension = {
+        name: `${options.template.name}.PlatformExtension`,
+        path: join(root, "Platforms", options.platform, "Config", ...afterPlatform.split("/"))
+    };
+    const restrictedExtensions = ["NotForLicensees", "NoRedist", "LimitedAccess"].map((kind) => ({
+        name: `${options.template.name}.Restricted.${kind}.PlatformExtension`,
+        path: join(root, "Restricted", kind, "Platforms", options.platform, "Config", ...afterPlatform.split("/"))
+    }));
+    return [
+        { name: options.template.name, path: base },
+        ...restricted,
+        platformExtension,
+        ...restrictedExtensions
+    ];
+}
+export function buildConfigHierarchy(options) {
+    const type = options.family;
+    const templates = [
+        {
+            name: "AbsoluteBase",
+            scope: "engine",
+            relativePath: "Config/Base.ini",
+            expanded: false,
+            platform: false
+        },
+        {
+            name: "Base",
+            scope: "engine",
+            relativePath: `Config/Base${type}.ini`,
+            expanded: true,
+            platform: false
+        },
+        {
+            name: "BasePlatform",
+            scope: "engine",
+            relativePath: `Config/{PLATFORM}/Base{PLATFORM}${type}.ini`,
+            expanded: true,
+            platform: true
+        },
+        {
+            name: "ProjectDefault",
+            scope: "project",
+            relativePath: `Config/Default${type}.ini`,
+            expanded: true,
+            platform: false
+        },
+        {
+            name: "ProjectGenerated",
+            scope: "project",
+            relativePath: `Config/Generated${type}.ini`,
+            expanded: true,
+            platform: false
+        },
+        {
+            name: "EnginePlatform",
+            scope: "engine",
+            relativePath: `Config/{PLATFORM}/{PLATFORM}${type}.ini`,
+            expanded: true,
+            platform: true
+        },
+        {
+            name: "ProjectPlatform",
+            scope: "project",
+            relativePath: `Config/{PLATFORM}/{PLATFORM}${type}.ini`,
+            expanded: true,
+            platform: true
+        },
+        {
+            name: "ProjectPlatformGenerated",
+            scope: "project",
+            relativePath: `Config/{PLATFORM}/Generated{PLATFORM}${type}.ini`,
+            expanded: true,
+            platform: true
+        }
+    ];
+    return templates.flatMap((template) => {
+        const platforms = template.platform ? options.platforms : [undefined];
+        return Array.from({ length: template.expanded ? (template.platform ? 8 : 4) : 1 }, (_, index) => platforms.flatMap((platform) => expandedPaths({
+            engineRoot: options.engineRoot,
+            projectRoot: options.projectRoot,
+            template,
+            ...(platform === undefined ? undefined : { platform })
+        }).filter((_, expansion) => expansion === index)))
+            .flat()
+            .map((candidate) => {
+            const root = template.scope === "engine" ? options.engineRoot : options.projectRoot;
+            return layer(candidate.name, template.scope, root, candidate.path);
+        });
+    });
+}
+function iniParent(text) {
+    let section = "";
+    for (const raw of text.replaceAll("\r\n", "\n").split("\n")) {
+        const line = raw.trim();
+        if (line.startsWith("[") && line.endsWith("]")) {
+            section = line.slice(1, -1);
+            continue;
+        }
+        if (section.toLocaleLowerCase() !== "datadrivenplatforminfo")
+            continue;
+        const equals = line.indexOf("=");
+        if (equals === -1 || line.slice(0, equals).trim().toLocaleLowerCase() !== "iniparent")
+            continue;
+        return line.slice(equals + 1).trim();
+    }
+    return undefined;
+}
+function platformMetadataPaths(options) {
+    return [
+        join(options.engineRoot, "Engine", "Config", options.platform, "DataDrivenPlatformInfo.ini"),
+        join(options.engineRoot, "Engine", "Platforms", options.platform, "Config", "DataDrivenPlatformInfo.ini"),
+        join(options.projectRoot, "Config", options.platform, "DataDrivenPlatformInfo.ini"),
+        join(options.projectRoot, "Platforms", options.platform, "Config", "DataDrivenPlatformInfo.ini")
+    ];
+}
+export function resolvePlatformChain(options) {
+    return Effect.gen(function* () {
+        const files = yield* ConfigFileAccess;
+        const visiting = new Set();
+        const chain = [];
+        let current = options.platform;
+        while (current !== undefined && current !== "") {
+            const normalized = current.toLocaleLowerCase();
+            if (visiting.has(normalized)) {
+                return yield* Effect.fail(invalidProject("Platform IniParent chain contains a cycle."));
+            }
+            visiting.add(normalized);
+            let found = false;
+            let parent;
+            for (const path of platformMetadataPaths({ ...options, platform: current })) {
+                if (!(yield* files.exists(path)))
+                    continue;
+                found = true;
+                const value = yield* files.readText(path);
+                const candidate = iniParent(value);
+                if (candidate !== undefined)
+                    parent = candidate;
+            }
+            if (!found) {
+                return yield* Effect.fail(invalidProject("The selected platform has no DataDrivenPlatformInfo.ini evidence."));
+            }
+            chain.unshift(current);
+            current = parent;
+        }
+        return chain;
+    });
+}
+//# sourceMappingURL=hierarchy.js.map

package/dist/hierarchy.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./browser.js";
+export * from "./file-access.js";
+export * from "./hierarchy.js";
+export * from "./service.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export * from "./browser.js";
+export * from "./file-access.js";
+export * from "./hierarchy.js";
+export * from "./service.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC"}

package/dist/merge.d.ts

@@ -0,0 +1,21 @@
+import type { ConfigComparison, ConfigContribution, ConfigDiagnostic, ConfigOperation, ConfigSource, ConfigSourceLocation, ConfigValueState } from "./schema.js";
+export interface ParsedConfigCommand {
+    readonly source: ConfigSource;
+    readonly location: ConfigSourceLocation;
+    readonly operation: ConfigOperation;
+    readonly value?: string;
+}
+export interface FoldConfigResult {
+    readonly effectiveValue: ConfigValueState;
+    readonly contributions: readonly ConfigContribution[];
+}
+export declare function foldConfigCommands(commands: readonly ParsedConfigCommand[]): FoldConfigResult;
+export declare function compareConfigExplanations(options: {
+    readonly left: ConfigComparison["left"];
+    readonly right: ConfigComparison["right"];
+}): ConfigComparison;
+export interface ParsedConfigFile {
+    readonly commands: readonly ParsedConfigCommand[];
+    readonly diagnostics: readonly ConfigDiagnostic[];
+}
+//# sourceMappingURL=merge.d.ts.map

package/dist/merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../src/merge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,gBAAgB,EAChB,kBAAkB,EAElB,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,oBAAoB,EACpB,gBAAgB,EAChB,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACxB;AAwBD,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,cAAc,EAAE,gBAAgB,CAAC;IAC1C,QAAQ,CAAC,aAAa,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACtD;AAkCD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,SAAS,mBAAmB,EAAE,GAAG,gBAAgB,CA8G7F;AAeD,wBAAgB,yBAAyB,CAAC,OAAO,EAAE;IAClD,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC;CAC1C,GAAG,gBAAgB,CAoBnB;AAED,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,QAAQ,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAClD,QAAQ,CAAC,WAAW,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAClD"}

package/dist/merge.js

@@ -0,0 +1,169 @@
+function publicState(state) {
+    if (state.items.length === 0) {
+        return state.emptyInitializedBy === undefined
+            ? { kind: "missing" }
+            : { kind: "empty_array" };
+    }
+    if (!state.arraySemantics && state.items.length === 1) {
+        return { kind: "scalar", value: state.items[0].value };
+    }
+    return { kind: "array", values: state.items.map((item) => item.value) };
+}
+function addContribution(contributions, command, priorValue, effect) {
+    const sequence = contributions.length;
+    contributions.push({
+        sequence,
+        source: command.source,
+        location: command.location,
+        operation: command.operation,
+        ...(command.value === undefined ? undefined : { inputValue: command.value }),
+        priorValue,
+        effect,
+        remainsEffective: false
+    });
+    return sequence;
+}
+export function foldConfigCommands(commands) {
+    let state = { items: [], arraySemantics: false };
+    const contributions = [];
+    for (const command of commands) {
+        const priorValue = publicState(state);
+        const value = command.value ?? "";
+        switch (command.operation) {
+            case "set": {
+                if (state.items.length === 0) {
+                    const sequence = contributions.length;
+                    state = { ...state, items: [{ value, contribution: sequence }] };
+                    addContribution(contributions, command, priorValue, {
+                        kind: "added",
+                        index: 0
+                    });
+                }
+                else {
+                    const replaced = state.items[0];
+                    const sequence = contributions.length;
+                    state = {
+                        ...state,
+                        items: [{ value, contribution: sequence }, ...state.items.slice(1)]
+                    };
+                    addContribution(contributions, command, priorValue, {
+                        kind: "replaced",
+                        index: 0,
+                        previousValue: replaced.value
+                    });
+                }
+                break;
+            }
+            case "add_unique": {
+                const duplicate = state.items.some((item) => item.value === value);
+                if (duplicate) {
+                    addContribution(contributions, command, priorValue, { kind: "duplicate" });
+                }
+                else {
+                    const sequence = contributions.length;
+                    const index = state.items.length;
+                    state = {
+                        ...state,
+                        arraySemantics: true,
+                        items: [...state.items, { value, contribution: sequence }]
+                    };
+                    addContribution(contributions, command, priorValue, { kind: "added", index });
+                }
+                break;
+            }
+            case "append": {
+                const sequence = contributions.length;
+                const index = state.items.length;
+                state = {
+                    ...state,
+                    arraySemantics: true,
+                    items: [...state.items, { value, contribution: sequence }]
+                };
+                addContribution(contributions, command, priorValue, { kind: "added", index });
+                break;
+            }
+            case "remove": {
+                const index = state.items.findIndex((item) => item.value === value);
+                if (index === -1) {
+                    addContribution(contributions, command, priorValue, { kind: "no_match" });
+                }
+                else {
+                    state = {
+                        ...state,
+                        arraySemantics: true,
+                        items: [...state.items.slice(0, index), ...state.items.slice(index + 1)]
+                    };
+                    const sequence = addContribution(contributions, command, priorValue, {
+                        kind: "removed",
+                        index
+                    });
+                    contributions[sequence].remainsEffective = true;
+                }
+                break;
+            }
+            case "clear": {
+                const removedValues = state.items.map((item) => item.value);
+                const clearedEmpty = state.emptyInitializedBy !== undefined;
+                state = { items: [], arraySemantics: true };
+                const sequence = addContribution(contributions, command, priorValue, {
+                    kind: "cleared",
+                    removedValues
+                });
+                contributions[sequence].remainsEffective =
+                    removedValues.length > 0 || clearedEmpty;
+                break;
+            }
+            case "initialize_empty": {
+                const removedValues = state.items.map((item) => item.value);
+                const sequence = contributions.length;
+                state = { items: [], arraySemantics: true, emptyInitializedBy: sequence };
+                addContribution(contributions, command, priorValue, {
+                    kind: "initialized_empty",
+                    removedValues
+                });
+                break;
+            }
+        }
+    }
+    for (const item of state.items) {
+        contributions[item.contribution].remainsEffective = true;
+    }
+    if (state.emptyInitializedBy !== undefined) {
+        contributions[state.emptyInitializedBy].remainsEffective = true;
+    }
+    return {
+        effectiveValue: publicState(state),
+        contributions
+    };
+}
+function comparable(value) {
+    switch (value.kind) {
+        case "missing":
+            return "missing";
+        case "empty_array":
+            return "empty_array";
+        case "scalar":
+            return `scalar:${value.value}`;
+        case "array":
+            return `array:${JSON.stringify(value.values)}`;
+    }
+}
+export function compareConfigExplanations(options) {
+    const valueChanged = comparable(options.left.effectiveValue) !== comparable(options.right.effectiveValue);
+    const coverageChanged = options.left.status !== options.right.status ||
+        options.left.layers.map((layer) => `${layer.layer}:${layer.status}`).join("|") !==
+            options.right.layers.map((layer) => `${layer.layer}:${layer.status}`).join("|");
+    return {
+        schemaVersion: 1,
+        status: options.left.status === "partial" || options.right.status === "partial"
+            ? "partial"
+            : valueChanged || coverageChanged
+                ? "different"
+                : "same",
+        left: options.left,
+        right: options.right,
+        valueChanged,
+        coverageChanged
+    };
+}
+//# sourceMappingURL=merge.js.map

package/dist/merge.js.map

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

package/dist/parser.d.ts

@@ -0,0 +1,15 @@
+import type { ParsedConfigFile } from "./merge.js";
+import type { ConfigKey, ConfigSection, ConfigSource } from "./schema.js";
+export declare function parseConfigFile(options: {
+    readonly text: string;
+    readonly source: ConfigSource;
+    readonly section: ConfigSection;
+    readonly key: ConfigKey;
+}): ParsedConfigFile;
+/** Detects redirect evidence that can rename the selected section or key during UE load. */
+export declare function configRedirectAffects(options: {
+    readonly text: string;
+    readonly section: ConfigSection;
+    readonly key: ConfigKey;
+}): boolean;
+//# sourceMappingURL=parser.d.ts.map