@uapkg/cli 1.1.8 → 1.1.9

package/dist/postinstall/runner/PostinstallOrchestrator.js

@@ -0,0 +1,172 @@
+import { createIoErrorDiagnostic, createUnknownErrorDiagnostic, DiagnosticBag } from '@uapkg/diagnostics';
+import { PostinstallLoader } from '../loader/PostinstallLoader.js';
+import { PostinstallPolicyGate } from '../policy/PostinstallPolicyGate.js';
+import { BuildCsInjector } from '../unreal/BuildCsInjector.js';
+import { ProjectFileLocator } from '../unreal/ProjectFileLocator.js';
+import { TargetCsInjector } from '../unreal/TargetCsInjector.js';
+import { UnrealSourceCatalogBuilder } from '../unreal/UnrealSourceCatalog.js';
+import { UProjectInjector } from '../unreal/UProjectInjector.js';
+import { UProjectMetadataReader } from '../unreal/UProjectMetadataReader.js';
+/**
+ * Top-level postinstall flow:
+ *
+ *   1. Fast path: if the host is a plugin manifest, nothing runs.
+ *   2. For each candidate plugin:
+ *        a. PolicyGate decides allow/deny. Deny → info diagnostic, skip.
+ *        b. Loader locates + transpiles + imports + validates the script.
+ *        c. Accumulate `(plugin, definition)` pairs into a plan.
+ *   3. Build a single {@link UnrealSourceCatalog} covering every module
+ *      any script wants to touch.
+ *   4. Apply injectors idempotently per zone.
+ *
+ * Always returns a {@link Result}; never throws. The caller inspects
+ * `diagnostics` to render errors/warnings/info lines.
+ */
+export class PostinstallOrchestrator {
+    loader;
+    policy;
+    catalogBuilder;
+    buildInjector;
+    targetInjector;
+    projectInjector;
+    projectFileLocator;
+    uprojectReader;
+    constructor(loader = new PostinstallLoader(), policy = new PostinstallPolicyGate(), catalogBuilder = new UnrealSourceCatalogBuilder(), buildInjector = new BuildCsInjector(), targetInjector = new TargetCsInjector(), projectInjector = new UProjectInjector(), projectFileLocator = new ProjectFileLocator(), uprojectReader = new UProjectMetadataReader()) {
+        this.loader = loader;
+        this.policy = policy;
+        this.catalogBuilder = catalogBuilder;
+        this.buildInjector = buildInjector;
+        this.targetInjector = targetInjector;
+        this.projectInjector = projectInjector;
+        this.projectFileLocator = projectFileLocator;
+        this.uprojectReader = uprojectReader;
+    }
+    async run(input) {
+        const bag = new DiagnosticBag();
+        const executed = [];
+        const skipped = [];
+        if (input.manifestType !== 'project' || input.candidates.length === 0) {
+            return bag.toResult({ executed, skipped });
+        }
+        const plan = await this.buildPlan(input.candidates, bag, skipped);
+        if (plan.length === 0) {
+            return bag.toResult({ executed, skipped });
+        }
+        const catalogResult = this.buildCatalog(input.projectRoot, plan, input.moduleNameOverride);
+        if (!catalogResult.ok) {
+            bag.mergeArray(catalogResult.diagnostics);
+            return bag.toFailure();
+        }
+        const { catalog, moduleNames } = catalogResult.value;
+        for (const entry of plan) {
+            const applied = this.applyScript(input.projectRoot, entry, catalog, moduleNames, bag);
+            if (applied)
+                executed.push(entry.loaded.packageName);
+        }
+        return bag.toResult({ executed, skipped });
+    }
+    // ---- private helpers --------------------------------------------------
+    async buildPlan(candidates, bag, skipped) {
+        const plan = [];
+        for (const candidate of candidates) {
+            const decision = this.policy.evaluate(candidate.packageName, candidate.registry);
+            if (!decision.allowed) {
+                if (decision.denialDiagnostic)
+                    bag.add(decision.denialDiagnostic);
+                skipped.push({ packageName: candidate.packageName, reason: 'policy-denied' });
+                continue;
+            }
+            const loaded = await this.loader.load(candidate.packageName, candidate.pluginRoot);
+            bag.mergeArray(loaded.diagnostics);
+            if (!loaded.ok)
+                continue; // Errors already in bag.
+            if (loaded.value === null) {
+                skipped.push({ packageName: candidate.packageName, reason: 'no-script' });
+                continue;
+            }
+            plan.push({ candidate, loaded: loaded.value });
+        }
+        return plan;
+    }
+    buildCatalog(projectRoot, plan, moduleNameOverride) {
+        const hasModuleSetup = plan.some((entry) => Boolean(entry.loaded.definition.setupModules));
+        let moduleNames = [];
+        if (hasModuleSetup) {
+            if (moduleNameOverride !== undefined) {
+                // Explicit override from project manifest wins; empty = no modules.
+                moduleNames = moduleNameOverride;
+            }
+            else {
+                try {
+                    const uprojectPath = this.projectFileLocator.findProjectFile(projectRoot);
+                    moduleNames = this.uprojectReader.readModuleNames(uprojectPath);
+                }
+                catch (error) {
+                    return {
+                        ok: false,
+                        diagnostics: [createIoErrorDiagnostic(projectRoot, error instanceof Error ? error.message : String(error))],
+                    };
+                }
+            }
+        }
+        try {
+            const catalog = this.catalogBuilder.build(projectRoot, moduleNames);
+            return { ok: true, value: { catalog, moduleNames }, diagnostics: [] };
+        }
+        catch (error) {
+            return {
+                ok: false,
+                diagnostics: [createUnknownErrorDiagnostic(error instanceof Error ? error.message : String(error))],
+            };
+        }
+    }
+    applyScript(projectRoot, entry, catalog, moduleNames, bag) {
+        const { loaded } = entry;
+        const def = loaded.definition;
+        let anyFailed = false;
+        if (def.setupModules) {
+            for (const moduleName of moduleNames) {
+                const moduleFile = catalog.moduleFiles.get(moduleName);
+                if (!moduleFile) {
+                    bag.add(createUnknownErrorDiagnostic(`Missing module mapping for ${moduleName} (plugin ${loaded.packageName})`));
+                    anyFailed = true;
+                    continue;
+                }
+                const result = this.buildInjector.apply(moduleFile, loaded.packageName, def.setupModules);
+                this.absorb(result, bag, () => {
+                    anyFailed = true;
+                });
+            }
+        }
+        if (def.setupTargets) {
+            for (const targetFile of catalog.targetFiles) {
+                const result = this.targetInjector.apply(targetFile, loaded.packageName, def.setupTargets);
+                this.absorb(result, bag, () => {
+                    anyFailed = true;
+                });
+            }
+        }
+        const projectPlugins = def.setupProject?.plugins ?? [];
+        if (projectPlugins.length > 0) {
+            try {
+                const uprojectPath = this.projectFileLocator.findProjectFile(projectRoot);
+                const result = this.projectInjector.apply(uprojectPath, projectPlugins);
+                this.absorb(result, bag, () => {
+                    anyFailed = true;
+                });
+            }
+            catch (error) {
+                bag.add(createIoErrorDiagnostic(projectRoot, error instanceof Error ? error.message : String(error)));
+                anyFailed = true;
+            }
+        }
+        return !anyFailed;
+    }
+    absorb(result, bag, onFail) {
+        for (const d of result.diagnostics)
+            bag.add(d);
+        if (!result.ok)
+            onFail();
+    }
+}
+//# sourceMappingURL=PostinstallOrchestrator.js.map

package/dist/postinstall/runner/PostinstallOrchestrator.js.map

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

package/dist/postinstall/unreal/BuildCsInjector.d.ts

@@ -0,0 +1,23 @@
+import { type Result } from '@uapkg/diagnostics';
+import type { ZoneDefinition } from '../api/PostinstallDsl.js';
+import { MarkerBlockEditor } from '../markers/MarkerBlockEditor.js';
+import { CSharpInjectionEngine } from './CSharpInjectionEngine.js';
+import { CSharpStructureAnalyzer } from './CSharpStructureAnalyzer.js';
+import { CSharpWrapperFactory } from './CSharpWrapperFactory.js';
+/**
+ * Injects a plugin's `setupModules` content into a single `*.Build.cs` file.
+ *
+ * The operation is idempotent: re-running overwrites the owned marker blocks.
+ * All failures are returned as `Result.fail` — this class never throws. Before
+ * mutation, pre-existing owned marker blocks are checked for corruption
+ * (orphaned / nested markers) and surfaced as `POSTINSTALL_MARKER_CORRUPT`.
+ */
+export declare class BuildCsInjector {
+    private readonly analyzer;
+    private readonly wrapperFactory;
+    private readonly injector;
+    private readonly markerEditor;
+    constructor(analyzer?: CSharpStructureAnalyzer, wrapperFactory?: CSharpWrapperFactory, injector?: CSharpInjectionEngine, markerEditor?: MarkerBlockEditor);
+    apply(filePath: string, pluginName: string, zones: ZoneDefinition): Result<void>;
+}
+//# sourceMappingURL=BuildCsInjector.d.ts.map

package/dist/postinstall/unreal/BuildCsInjector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BuildCsInjector.d.ts","sourceRoot":"","sources":["../../../src/postinstall/unreal/BuildCsInjector.ts"],"names":[],"mappings":"AACA,OAAO,EAAqC,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACpF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAKjE;;;;;;;GAOG;AACH,qBAAa,eAAe;IAExB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAHZ,QAAQ,GAAE,uBAAuD,EACjE,cAAc,GAAE,oBAAiD,EACjE,QAAQ,GAAE,qBAAmD,EAC7D,YAAY,GAAE,iBAA2C;IAGrE,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC;CAgCxF"}

package/dist/postinstall/unreal/BuildCsInjector.js

@@ -0,0 +1,55 @@
+import fs from 'node:fs';
+import { createIoErrorDiagnostic, fail, ok } from '@uapkg/diagnostics';
+import { MarkerBlockEditor } from '../markers/MarkerBlockEditor.js';
+import { CSharpInjectionEngine } from './CSharpInjectionEngine.js';
+import { CSharpStructureAnalyzer } from './CSharpStructureAnalyzer.js';
+import { CSharpWrapperFactory } from './CSharpWrapperFactory.js';
+import { getWrapperClassName } from './PluginHash.js';
+const BUILD_CS_ZONES = ['module-includes', 'module-class-body', 'module-constructor'];
+/**
+ * Injects a plugin's `setupModules` content into a single `*.Build.cs` file.
+ *
+ * The operation is idempotent: re-running overwrites the owned marker blocks.
+ * All failures are returned as `Result.fail` — this class never throws. Before
+ * mutation, pre-existing owned marker blocks are checked for corruption
+ * (orphaned / nested markers) and surfaced as `POSTINSTALL_MARKER_CORRUPT`.
+ */
+export class BuildCsInjector {
+    analyzer;
+    wrapperFactory;
+    injector;
+    markerEditor;
+    constructor(analyzer = new CSharpStructureAnalyzer(), wrapperFactory = new CSharpWrapperFactory(), injector = new CSharpInjectionEngine(), markerEditor = new MarkerBlockEditor()) {
+        this.analyzer = analyzer;
+        this.wrapperFactory = wrapperFactory;
+        this.injector = injector;
+        this.markerEditor = markerEditor;
+    }
+    apply(filePath, pluginName, zones) {
+        try {
+            let source = fs.readFileSync(filePath, 'utf-8');
+            for (const zone of BUILD_CS_ZONES) {
+                const check = this.markerEditor.validate(source, pluginName, zone, filePath);
+                if (!check.ok)
+                    return fail(check.diagnostics);
+            }
+            if (zones.includes?.trim()) {
+                source = this.injector.applyIncludes(source, pluginName, zones.includes, 'module-includes');
+            }
+            if (zones.classBody?.trim()) {
+                const parsedForWrapper = this.analyzer.parseModule(filePath, source);
+                const wrapperClassName = getWrapperClassName(pluginName);
+                const wrapper = this.wrapperFactory.createWrapper(wrapperClassName, 'ModuleRules', 'rules', zones.classBody);
+                source = this.injector.applyClassWrapper(parsedForWrapper, pluginName, wrapper, 'module-class-body');
+                const parsedForCtor = this.analyzer.parseModule(filePath, source);
+                source = this.injector.applyConstructorCall(parsedForCtor, pluginName, `${wrapperClassName}.Apply(this)`, 'module-constructor');
+            }
+            fs.writeFileSync(filePath, source, 'utf-8');
+            return ok(undefined);
+        }
+        catch (error) {
+            return fail([createIoErrorDiagnostic(filePath, error instanceof Error ? error.message : String(error))]);
+        }
+    }
+}
+//# sourceMappingURL=BuildCsInjector.js.map

package/dist/postinstall/unreal/BuildCsInjector.js.map

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

package/dist/postinstall/unreal/CSharpInjectionEngine.d.ts

@@ -0,0 +1,22 @@
+import { MarkerBlockService } from '../markers/MarkerBlockService.js';
+import type { ParsedCSharpFile } from './CSharpStructures.js';
+/**
+ * Applies marker-delimited edits to a parsed C# file at three well-known anchors:
+ *
+ *   1. `applyIncludes`   — `using ...;` block just after the last top-level `using`.
+ *   2. `applyClassWrapper` — nested helper class inside the rules class body.
+ *   3. `applyConstructorCall` — a single statement at the top of the constructor.
+ *
+ * Every edit is wrapped in an owned `UAPKG-BEGIN/END` marker block so re-running
+ * uapkg is idempotent. Existing owned blocks are stripped before re-insert.
+ */
+export declare class CSharpInjectionEngine {
+    private readonly markerBlock;
+    constructor(markerBlock?: MarkerBlockService);
+    applyIncludes(source: string, pluginName: string, includesContent: string, zone: string): string;
+    applyClassWrapper(parsed: ParsedCSharpFile, pluginName: string, wrapperContent: string, zone: string): string;
+    applyConstructorCall(parsed: ParsedCSharpFile, pluginName: string, callExpression: string, zone: string): string;
+    private detectClassMemberIndent;
+    private detectConstructorIndent;
+}
+//# sourceMappingURL=CSharpInjectionEngine.d.ts.map

package/dist/postinstall/unreal/CSharpInjectionEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CSharpInjectionEngine.d.ts","sourceRoot":"","sources":["../../../src/postinstall/unreal/CSharpInjectionEngine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D;;;;;;;;;GASG;AACH,qBAAa,qBAAqB;IACb,OAAO,CAAC,QAAQ,CAAC,WAAW;gBAAX,WAAW,GAAE,kBAA6C;IAEvF,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;IAahG,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;IAW7G,oBAAoB,CACzB,MAAM,EAAE,gBAAgB,EACxB,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,MAAM,GACX,MAAM;IAcT,OAAO,CAAC,uBAAuB;IAO/B,OAAO,CAAC,uBAAuB;CAMhC"}

package/dist/postinstall/unreal/CSharpInjectionEngine.js

@@ -0,0 +1,61 @@
+import { MarkerBlockService } from '../markers/MarkerBlockService.js';
+/**
+ * Applies marker-delimited edits to a parsed C# file at three well-known anchors:
+ *
+ *   1. `applyIncludes`   — `using ...;` block just after the last top-level `using`.
+ *   2. `applyClassWrapper` — nested helper class inside the rules class body.
+ *   3. `applyConstructorCall` — a single statement at the top of the constructor.
+ *
+ * Every edit is wrapped in an owned `UAPKG-BEGIN/END` marker block so re-running
+ * uapkg is idempotent. Existing owned blocks are stripped before re-insert.
+ */
+export class CSharpInjectionEngine {
+    markerBlock;
+    constructor(markerBlock = new MarkerBlockService()) {
+        this.markerBlock = markerBlock;
+    }
+    applyIncludes(source, pluginName, includesContent, zone) {
+        const withoutOwnedBlock = this.markerBlock.stripOwnedBlock(source, pluginName, zone);
+        const includeBlock = this.markerBlock.createBlock(pluginName, zone, includesContent);
+        const usingMatches = [...withoutOwnedBlock.matchAll(/^[ \t]*using\s+[^;]+;\s*$/gm)];
+        if (usingMatches.length === 0) {
+            return `${includeBlock}\n${withoutOwnedBlock}`.trimStart();
+        }
+        const lastUsing = usingMatches[usingMatches.length - 1];
+        const lastUsingIndex = (lastUsing.index ?? 0) + lastUsing[0].length;
+        return `${withoutOwnedBlock.slice(0, lastUsingIndex)}\n${includeBlock}\n${withoutOwnedBlock.slice(lastUsingIndex).trimStart()}`;
+    }
+    applyClassWrapper(parsed, pluginName, wrapperContent, zone) {
+        const classStart = parsed.classInfo.classOpenBraceIndex + 1;
+        const classEnd = parsed.classInfo.classCloseBraceIndex;
+        const classBody = parsed.source.slice(classStart, classEnd);
+        const stripped = this.markerBlock.stripOwnedBlock(classBody, pluginName, zone).trimStart();
+        const indent = this.detectClassMemberIndent(parsed.source, parsed.classInfo.classOpenBraceIndex);
+        const block = this.markerBlock.createBlock(pluginName, zone, wrapperContent, indent);
+        const nextBody = `\n${block}\n\n${stripped}`.replace(/\n{3,}/g, '\n\n');
+        return `${parsed.source.slice(0, classStart)}${nextBody}${parsed.source.slice(classEnd)}`;
+    }
+    applyConstructorCall(parsed, pluginName, callExpression, zone) {
+        const bodyStart = parsed.constructorInfo.bodyOpenBraceIndex + 1;
+        const bodyEnd = parsed.constructorInfo.bodyCloseBraceIndex;
+        const body = parsed.source.slice(bodyStart, bodyEnd);
+        const withoutOwnedBlock = this.markerBlock.stripOwnedBlock(body, pluginName, zone).trimStart();
+        const indent = this.detectConstructorIndent(parsed.source, parsed.constructorInfo.bodyOpenBraceIndex);
+        const block = this.markerBlock.createBlock(pluginName, zone, `${callExpression};`, indent);
+        const nextBody = `\n${block}\n${withoutOwnedBlock.length > 0 ? `\n${withoutOwnedBlock}` : ''}`.replace(/\n{3,}/g, '\n\n');
+        return `${parsed.source.slice(0, bodyStart)}${nextBody}${parsed.source.slice(bodyEnd)}`;
+    }
+    detectClassMemberIndent(source, classOpenBraceIndex) {
+        const lineStart = source.lastIndexOf('\n', classOpenBraceIndex);
+        const classLine = source.slice(lineStart + 1, classOpenBraceIndex);
+        const classIndent = classLine.match(/^\s*/)?.[0] ?? '';
+        return `${classIndent}    `;
+    }
+    detectConstructorIndent(source, constructorOpenBraceIndex) {
+        const lineStart = source.lastIndexOf('\n', constructorOpenBraceIndex);
+        const constructorLine = source.slice(lineStart + 1, constructorOpenBraceIndex);
+        const constructorIndent = constructorLine.match(/^\s*/)?.[0] ?? '';
+        return `${constructorIndent}    `;
+    }
+}
+//# sourceMappingURL=CSharpInjectionEngine.js.map

package/dist/postinstall/unreal/CSharpInjectionEngine.js.map

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

package/dist/postinstall/unreal/CSharpStructureAnalyzer.d.ts

@@ -0,0 +1,22 @@
+import type { ParsedCSharpFile } from './CSharpStructures.js';
+/**
+ * Lightweight C# structural parser tailored to Unreal build files.
+ *
+ * We do NOT invoke the Roslyn / csharp-ast graph for analysis because the
+ * pipeline only needs three anchors:
+ *   1. The single class inheriting `ModuleRules` / `TargetRules`.
+ *   2. Its constructor matching `(ModuleRules|TargetRules)(Type Target) : base(Target)`.
+ *   3. The body braces of (1) and (2) so injectors can splice content.
+ *
+ * Lighter-than-AST parsing keeps this file < 200 LOC and avoids pulling a
+ * heavyweight runtime into `uapkg install`.
+ */
+export declare class CSharpStructureAnalyzer {
+    parseModule(filePath: string, source: string): ParsedCSharpFile;
+    parseTarget(filePath: string, source: string): ParsedCSharpFile;
+    private parseFile;
+    private findClassesByBase;
+    private findConstructor;
+    private findMatchingBrace;
+}
+//# sourceMappingURL=CSharpStructureAnalyzer.d.ts.map

package/dist/postinstall/unreal/CSharpStructureAnalyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CSharpStructureAnalyzer.d.ts","sourceRoot":"","sources":["../../../src/postinstall/unreal/CSharpStructureAnalyzer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkD,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAK9G;;;;;;;;;;;GAWG;AACH,qBAAa,uBAAuB;IAC3B,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,gBAAgB;IAI/D,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,gBAAgB;IAQtE,OAAO,CAAC,SAAS;IAqBjB,OAAO,CAAC,iBAAiB;IAoBzB,OAAO,CAAC,eAAe;IAgCvB,OAAO,CAAC,iBAAiB;CAqD1B"}

package/dist/postinstall/unreal/CSharpStructureAnalyzer.js

@@ -0,0 +1,130 @@
+import { PrettyParseError } from './PrettyParseError.js';
+const CLASS_REGEX = /\bclass\s+([A-Za-z_][A-Za-z0-9_]*)\s*:\s*([^{\r\n]+)/g;
+/**
+ * Lightweight C# structural parser tailored to Unreal build files.
+ *
+ * We do NOT invoke the Roslyn / csharp-ast graph for analysis because the
+ * pipeline only needs three anchors:
+ *   1. The single class inheriting `ModuleRules` / `TargetRules`.
+ *   2. Its constructor matching `(ModuleRules|TargetRules)(Type Target) : base(Target)`.
+ *   3. The body braces of (1) and (2) so injectors can splice content.
+ *
+ * Lighter-than-AST parsing keeps this file < 200 LOC and avoids pulling a
+ * heavyweight runtime into `uapkg install`.
+ */
+export class CSharpStructureAnalyzer {
+    parseModule(filePath, source) {
+        return this.parseFile('module', filePath, source, 'ModuleRules', 'ReadOnlyTargetRules');
+    }
+    parseTarget(filePath, source) {
+        const parsed = this.parseFile('target', filePath, source, 'TargetRules', 'TargetInfo');
+        if (!/\bType\s*=\s*TargetType\.[A-Za-z_][A-Za-z0-9_]*\s*;/.test(source)) {
+            throw new PrettyParseError(filePath, 'TargetRules file missing `Type = TargetType.X;` assignment', source, 0);
+        }
+        return parsed;
+    }
+    parseFile(kind, filePath, source, expectedBaseClass, expectedConstructorArgType) {
+        const matchingClasses = this.findClassesByBase(source, expectedBaseClass);
+        if (matchingClasses.length !== 1) {
+            throw new PrettyParseError(filePath, `Expected exactly one class extending ${expectedBaseClass}, found ${matchingClasses.length}`, source, matchingClasses[0]?.classKeywordIndex ?? 0);
+        }
+        const classInfo = matchingClasses[0];
+        const constructorInfo = this.findConstructor(filePath, source, classInfo, expectedConstructorArgType);
+        return { kind, classInfo, constructorInfo, source };
+    }
+    findClassesByBase(source, expectedBaseClass) {
+        const classes = [];
+        for (const match of source.matchAll(CLASS_REGEX)) {
+            const className = match[1];
+            const inheritance = match[2] ?? '';
+            const inheritsExpected = inheritance
+                .split(',')
+                .map((item) => item.trim())
+                .some((item) => item === expectedBaseClass);
+            if (!inheritsExpected || !className)
+                continue;
+            const classKeywordIndex = match.index ?? 0;
+            const classOpenBraceIndex = source.indexOf('{', classKeywordIndex);
+            if (classOpenBraceIndex < 0)
+                continue;
+            const classCloseBraceIndex = this.findMatchingBrace(source, classOpenBraceIndex);
+            classes.push({ className, classKeywordIndex, classOpenBraceIndex, classCloseBraceIndex });
+        }
+        return classes;
+    }
+    findConstructor(filePath, source, classInfo, expectedConstructorArgType) {
+        const classBody = source.slice(classInfo.classOpenBraceIndex + 1, classInfo.classCloseBraceIndex);
+        const signatureRegex = new RegExp(`\\bpublic\\s+${classInfo.className}\\s*\\(\\s*${expectedConstructorArgType}\\s+Target\\s*\\)\\s*:\\s*base\\s*\\(\\s*Target\\s*\\)`, 'g');
+        const matches = [...classBody.matchAll(signatureRegex)];
+        if (matches.length !== 1) {
+            throw new PrettyParseError(filePath, `Expected exactly one constructor signature for ${classInfo.className}(${expectedConstructorArgType} Target) : base(Target), found ${matches.length}`, source, classInfo.classKeywordIndex);
+        }
+        const signatureRelativeIndex = matches[0].index ?? 0;
+        const signatureIndex = classInfo.classOpenBraceIndex + 1 + signatureRelativeIndex;
+        const bodyOpenBraceIndex = source.indexOf('{', signatureIndex);
+        if (bodyOpenBraceIndex < 0) {
+            throw new PrettyParseError(filePath, 'Constructor body opening brace not found', source, signatureIndex);
+        }
+        const bodyCloseBraceIndex = this.findMatchingBrace(source, bodyOpenBraceIndex);
+        return { signatureIndex, bodyOpenBraceIndex, bodyCloseBraceIndex };
+    }
+    findMatchingBrace(source, openIndex) {
+        let depth = 0;
+        let inSingleLineComment = false;
+        let inMultiLineComment = false;
+        let inSingleQuote = false;
+        let inDoubleQuote = false;
+        for (let i = openIndex; i < source.length; i += 1) {
+            const current = source[i];
+            const next = source[i + 1];
+            const prev = source[i - 1];
+            if (inSingleLineComment) {
+                if (current === '\n')
+                    inSingleLineComment = false;
+                continue;
+            }
+            if (inMultiLineComment) {
+                if (prev === '*' && current === '/')
+                    inMultiLineComment = false;
+                continue;
+            }
+            if (inSingleQuote) {
+                if (current === "'" && prev !== '\\')
+                    inSingleQuote = false;
+                continue;
+            }
+            if (inDoubleQuote) {
+                if (current === '"' && prev !== '\\')
+                    inDoubleQuote = false;
+                continue;
+            }
+            if (current === '/' && next === '/') {
+                inSingleLineComment = true;
+                i += 1;
+                continue;
+            }
+            if (current === '/' && next === '*') {
+                inMultiLineComment = true;
+                i += 1;
+                continue;
+            }
+            if (current === "'") {
+                inSingleQuote = true;
+                continue;
+            }
+            if (current === '"') {
+                inDoubleQuote = true;
+                continue;
+            }
+            if (current === '{')
+                depth += 1;
+            else if (current === '}') {
+                depth -= 1;
+                if (depth === 0)
+                    return i;
+            }
+        }
+        throw new Error('Unbalanced braces in C# file');
+    }
+}
+//# sourceMappingURL=CSharpStructureAnalyzer.js.map

package/dist/postinstall/unreal/CSharpStructureAnalyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CSharpStructureAnalyzer.js","sourceRoot":"","sources":["../../../src/postinstall/unreal/CSharpStructureAnalyzer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,MAAM,WAAW,GAAG,uDAAuD,CAAC;AAE5E;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,uBAAuB;IAC3B,WAAW,CAAC,QAAgB,EAAE,MAAc;QACjD,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,qBAAqB,CAAC,CAAC;IAC1F,CAAC;IAEM,WAAW,CAAC,QAAgB,EAAE,MAAc;QACjD,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,YAAY,CAAC,CAAC;QACvF,IAAI,CAAC,qDAAqD,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACxE,MAAM,IAAI,gBAAgB,CAAC,QAAQ,EAAE,4DAA4D,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;QAChH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,SAAS,CACf,IAAoB,EACpB,QAAgB,EAChB,MAAc,EACd,iBAAyB,EACzB,0BAAkC;QAElC,MAAM,eAAe,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;QAC1E,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,gBAAgB,CACxB,QAAQ,EACR,wCAAwC,iBAAiB,WAAW,eAAe,CAAC,MAAM,EAAE,EAC5F,MAAM,EACN,eAAe,CAAC,CAAC,CAAC,EAAE,iBAAiB,IAAI,CAAC,CAC3C,CAAC;QACJ,CAAC;QACD,MAAM,SAAS,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;QACrC,MAAM,eAAe,GAAG,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,0BAA0B,CAAC,CAAC;QACtG,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,EAAE,CAAC;IACtD,CAAC;IAEO,iBAAiB,CAAC,MAAc,EAAE,iBAAyB;QACjE,MAAM,OAAO,GAAkB,EAAE,CAAC;QAClC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YACjD,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YAC3B,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACnC,MAAM,gBAAgB,GAAG,WAAW;iBACjC,KAAK,CAAC,GAAG,CAAC;iBACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;iBAC1B,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,iBAAiB,CAAC,CAAC;YAC9C,IAAI,CAAC,gBAAgB,IAAI,CAAC,SAAS;gBAAE,SAAS;YAE9C,MAAM,iBAAiB,GAAG,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC;YAC3C,MAAM,mBAAmB,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC;YACnE,IAAI,mBAAmB,GAAG,CAAC;gBAAE,SAAS;YACtC,MAAM,oBAAoB,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;YACjF,OAAO,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,CAAC,CAAC;QAC5F,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,eAAe,CACrB,QAAgB,EAChB,MAAc,EACd,SAAsB,EACtB,0BAAkC;QAElC,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,mBAAmB,GAAG,CAAC,EAAE,SAAS,CAAC,oBAAoB,CAAC,CAAC;QAClG,MAAM,cAAc,GAAG,IAAI,MAAM,CAC/B,gBAAgB,SAAS,CAAC,SAAS,cAAc,0BAA0B,wDAAwD,EACnI,GAAG,CACJ,CAAC;QAEF,MAAM,OAAO,GAAG,CAAC,GAAG,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC;QACxD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,gBAAgB,CACxB,QAAQ,EACR,kDAAkD,SAAS,CAAC,SAAS,IAAI,0BAA0B,kCAAkC,OAAO,CAAC,MAAM,EAAE,EACrJ,MAAM,EACN,SAAS,CAAC,iBAAiB,CAC5B,CAAC;QACJ,CAAC;QAED,MAAM,sBAAsB,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;QACrD,MAAM,cAAc,GAAG,SAAS,CAAC,mBAAmB,GAAG,CAAC,GAAG,sBAAsB,CAAC;QAClF,MAAM,kBAAkB,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;QAC/D,IAAI,kBAAkB,GAAG,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,gBAAgB,CAAC,QAAQ,EAAE,0CAA0C,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC;QAC3G,CAAC;QACD,MAAM,mBAAmB,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;QAC/E,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,CAAC;IACrE,CAAC;IAEO,iBAAiB,CAAC,MAAc,EAAE,SAAiB;QACzD,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,mBAAmB,GAAG,KAAK,CAAC;QAChC,IAAI,kBAAkB,GAAG,KAAK,CAAC;QAC/B,IAAI,aAAa,GAAG,KAAK,CAAC;QAC1B,IAAI,aAAa,GAAG,KAAK,CAAC;QAC1B,KAAK,IAAI,CAAC,GAAG,SAAS,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YAClD,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;YAC1B,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC3B,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAE3B,IAAI,mBAAmB,EAAE,CAAC;gBACxB,IAAI,OAAO,KAAK,IAAI;oBAAE,mBAAmB,GAAG,KAAK,CAAC;gBAClD,SAAS;YACX,CAAC;YACD,IAAI,kBAAkB,EAAE,CAAC;gBACvB,IAAI,IAAI,KAAK,GAAG,IAAI,OAAO,KAAK,GAAG;oBAAE,kBAAkB,GAAG,KAAK,CAAC;gBAChE,SAAS;YACX,CAAC;YACD,IAAI,aAAa,EAAE,CAAC;gBAClB,IAAI,OAAO,KAAK,GAAG,IAAI,IAAI,KAAK,IAAI;oBAAE,aAAa,GAAG,KAAK,CAAC;gBAC5D,SAAS;YACX,CAAC;YACD,IAAI,aAAa,EAAE,CAAC;gBAClB,IAAI,OAAO,KAAK,GAAG,IAAI,IAAI,KAAK,IAAI;oBAAE,aAAa,GAAG,KAAK,CAAC;gBAC5D,SAAS;YACX,CAAC;YACD,IAAI,OAAO,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;gBACpC,mBAAmB,GAAG,IAAI,CAAC;gBAC3B,CAAC,IAAI,CAAC,CAAC;gBACP,SAAS;YACX,CAAC;YACD,IAAI,OAAO,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;gBACpC,kBAAkB,GAAG,IAAI,CAAC;gBAC1B,CAAC,IAAI,CAAC,CAAC;gBACP,SAAS;YACX,CAAC;YACD,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;gBACpB,aAAa,GAAG,IAAI,CAAC;gBACrB,SAAS;YACX,CAAC;YACD,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;gBACpB,aAAa,GAAG,IAAI,CAAC;gBACrB,SAAS;YACX,CAAC;YACD,IAAI,OAAO,KAAK,GAAG;gBAAE,KAAK,IAAI,CAAC,CAAC;iBAC3B,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;gBACzB,KAAK,IAAI,CAAC,CAAC;gBACX,IAAI,KAAK,KAAK,CAAC;oBAAE,OAAO,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAClD,CAAC;CACF"}

package/dist/postinstall/unreal/CSharpStructures.d.ts

@@ -0,0 +1,19 @@
+export type CSharpFileKind = 'module' | 'target';
+export interface ParsedClass {
+    readonly className: string;
+    readonly classKeywordIndex: number;
+    readonly classOpenBraceIndex: number;
+    readonly classCloseBraceIndex: number;
+}
+export interface ParsedConstructor {
+    readonly signatureIndex: number;
+    readonly bodyOpenBraceIndex: number;
+    readonly bodyCloseBraceIndex: number;
+}
+export interface ParsedCSharpFile {
+    readonly kind: CSharpFileKind;
+    readonly classInfo: ParsedClass;
+    readonly constructorInfo: ParsedConstructor;
+    readonly source: string;
+}
+//# sourceMappingURL=CSharpStructures.d.ts.map

package/dist/postinstall/unreal/CSharpStructures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CSharpStructures.d.ts","sourceRoot":"","sources":["../../../src/postinstall/unreal/CSharpStructures.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEjD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;CACvC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;CACtC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,iBAAiB,CAAC;IAC5C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB"}

package/dist/postinstall/unreal/CSharpStructures.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=CSharpStructures.js.map

package/dist/postinstall/unreal/CSharpStructures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CSharpStructures.js","sourceRoot":"","sources":["../../../src/postinstall/unreal/CSharpStructures.ts"],"names":[],"mappings":""}

package/dist/postinstall/unreal/CSharpWrapperFactory.d.ts

@@ -0,0 +1,26 @@
+export type WrapperContextType = 'ModuleRules' | 'TargetRules';
+/**
+ * Produces the hashed helper class that wraps user-supplied `classBody` content.
+ *
+ * The helper has the shape:
+ *
+ * ```csharp
+ * static class UAPKG_<hash>
+ * {
+ *     public static void Apply(ModuleRules|TargetRules rules|target)
+ *     {
+ *         <user body>
+ *     }
+ * }
+ * ```
+ *
+ * We use `@amplication/csharp-ast` to generate a syntactically valid class and
+ * then patch the output:
+ *   * strip an invalid `using ;` line the library emits for empty namespaces;
+ *   * retype the `object` parameter back to the requested ModuleRules/TargetRules.
+ */
+export declare class CSharpWrapperFactory {
+    createWrapper(className: string, contextType: WrapperContextType, contextName: string, body: string): string;
+    private normalize;
+}
+//# sourceMappingURL=CSharpWrapperFactory.d.ts.map

package/dist/postinstall/unreal/CSharpWrapperFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CSharpWrapperFactory.d.ts","sourceRoot":"","sources":["../../../src/postinstall/unreal/CSharpWrapperFactory.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,kBAAkB,GAAG,aAAa,GAAG,aAAa,CAAC;AAE/D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,oBAAoB;IACxB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;IA8BnH,OAAO,CAAC,SAAS;CAWlB"}