@uapkg/cli 1.1.8 → 1.1.9

package/dist/postinstall/unreal/CSharpWrapperFactory.js

@@ -0,0 +1,60 @@
+import * as CSharpAst from '@amplication/csharp-ast';
+/**
+ * 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 class CSharpWrapperFactory {
+    createWrapper(className, contextType, contextName, body) {
+        const wrapperClass = new CSharpAst.Class({
+            name: className,
+            namespace: '',
+            access: 'private',
+            static_: true,
+            isNestedClass: true,
+        });
+        const applyMethod = new CSharpAst.Method({
+            name: 'Apply',
+            access: 'public',
+            isAsync: false,
+            type: CSharpAst.MethodType.STATIC,
+            parameters: [
+                new CSharpAst.Parameter({
+                    name: contextName,
+                    // csharp-ast adds invalid `using ;` when ClassReference namespace is empty.
+                    // We emit with `object` and patch to ModuleRules/TargetRules below.
+                    type: CSharpAst.Type.object(),
+                }),
+            ],
+            body: new CSharpAst.CodeBlock({ code: body.trim() }),
+        });
+        wrapperClass.addMethod(applyMethod);
+        const writer = new CSharpAst.Writer({});
+        writer.writeNode(wrapperClass);
+        return this.normalize(writer.toString(), contextType, contextName);
+    }
+    normalize(source, contextType, contextName) {
+        const withoutTrailing = source.trim().replace(/[ \t]+\n/g, '\n');
+        return withoutTrailing
+            .replace(/^private static class/m, 'static class')
+            .replace(new RegExp(`public static void Apply\\(object\\s+${contextName}\\)`), `public static void Apply(${contextType} ${contextName})`)
+            .replace(/\)\s*{\n/g, ')\n    {\n')
+            .replace(/;\}/g, ';\n    }');
+    }
+}
+//# sourceMappingURL=CSharpWrapperFactory.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CSharpWrapperFactory.js","sourceRoot":"","sources":["../../../src/postinstall/unreal/CSharpWrapperFactory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,yBAAyB,CAAC;AAIrD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,oBAAoB;IACxB,aAAa,CAAC,SAAiB,EAAE,WAA+B,EAAE,WAAmB,EAAE,IAAY;QACxG,MAAM,YAAY,GAAG,IAAI,SAAS,CAAC,KAAK,CAAC;YACvC,IAAI,EAAE,SAAS;YACf,SAAS,EAAE,EAAE;YACb,MAAM,EAAE,SAAS;YACjB,OAAO,EAAE,IAAI;YACb,aAAa,EAAE,IAAI;SACpB,CAAC,CAAC;QACH,MAAM,WAAW,GAAG,IAAI,SAAS,CAAC,MAAM,CAAC;YACvC,IAAI,EAAE,OAAO;YACb,MAAM,EAAE,QAAQ;YAChB,OAAO,EAAE,KAAK;YACd,IAAI,EAAE,SAAS,CAAC,UAAU,CAAC,MAAM;YACjC,UAAU,EAAE;gBACV,IAAI,SAAS,CAAC,SAAS,CAAC;oBACtB,IAAI,EAAE,WAAW;oBACjB,4EAA4E;oBAC5E,oEAAoE;oBACpE,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE;iBAC9B,CAAC;aACH;YACD,IAAI,EAAE,IAAI,SAAS,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;SACrD,CAAC,CAAC;QACH,YAAY,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QAEpC,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACxC,MAAM,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QAC/B,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;IACrE,CAAC;IAEO,SAAS,CAAC,MAAc,EAAE,WAA+B,EAAE,WAAmB;QACpF,MAAM,eAAe,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QACjE,OAAO,eAAe;aACnB,OAAO,CAAC,wBAAwB,EAAE,cAAc,CAAC;aACjD,OAAO,CACN,IAAI,MAAM,CAAC,wCAAwC,WAAW,KAAK,CAAC,EACpE,4BAA4B,WAAW,IAAI,WAAW,GAAG,CAC1D;aACA,OAAO,CAAC,WAAW,EAAE,YAAY,CAAC;aAClC,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACjC,CAAC;CACF"}

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

@@ -0,0 +1,8 @@
+/** Deterministic 8-char SHA-1 hash of a plugin name; used for uniquely-named helper classes. */
+export declare function getPluginHash(pluginName: string): string;
+/**
+ * Name of the nested helper class uapkg injects into a Build.cs / Target.cs.
+ * Hashed so two plugins can never collide inside the same module or target.
+ */
+export declare function getWrapperClassName(pluginName: string): string;
+//# sourceMappingURL=PluginHash.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PluginHash.d.ts","sourceRoot":"","sources":["../../../src/postinstall/unreal/PluginHash.ts"],"names":[],"mappings":"AAEA,gGAAgG;AAChG,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE9D"}

package/dist/postinstall/unreal/PluginHash.js

@@ -0,0 +1,13 @@
+import { createHash } from 'node:crypto';
+/** Deterministic 8-char SHA-1 hash of a plugin name; used for uniquely-named helper classes. */
+export function getPluginHash(pluginName) {
+    return createHash('sha1').update(pluginName).digest('hex').slice(0, 8).toLowerCase();
+}
+/**
+ * Name of the nested helper class uapkg injects into a Build.cs / Target.cs.
+ * Hashed so two plugins can never collide inside the same module or target.
+ */
+export function getWrapperClassName(pluginName) {
+    return `UAPKG_${getPluginHash(pluginName)}`;
+}
+//# sourceMappingURL=PluginHash.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PluginHash.js","sourceRoot":"","sources":["../../../src/postinstall/unreal/PluginHash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,gGAAgG;AAChG,MAAM,UAAU,aAAa,CAAC,UAAkB;IAC9C,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;AACvF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAAkB;IACpD,OAAO,SAAS,aAAa,CAAC,UAAU,CAAC,EAAE,CAAC;AAC9C,CAAC"}

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

@@ -0,0 +1,15 @@
+/**
+ * Structured parse failure for C# build files. Emitted as the `reason` payload
+ * of `POSTINSTALL_LOAD_FAILED`-adjacent diagnostics by injector callers.
+ *
+ * Unlike the legacy version this class is still a standard `Error` subclass so
+ * it composes cleanly with `try/catch`, but the new postinstall subsystem never
+ * lets it escape — injectors catch and convert to diagnostics.
+ */
+export declare class PrettyParseError extends Error {
+    readonly filePath: string;
+    readonly line: number;
+    readonly column: number;
+    constructor(filePath: string, message: string, source: string, index: number);
+}
+//# sourceMappingURL=PrettyParseError.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PrettyParseError.d.ts","sourceRoot":"","sources":["../../../src/postinstall/unreal/PrettyParseError.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,MAAM,EAAE,MAAM,CAAC;gBAEZ,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;CASpF"}

package/dist/postinstall/unreal/PrettyParseError.js

@@ -0,0 +1,43 @@
+/**
+ * Structured parse failure for C# build files. Emitted as the `reason` payload
+ * of `POSTINSTALL_LOAD_FAILED`-adjacent diagnostics by injector callers.
+ *
+ * Unlike the legacy version this class is still a standard `Error` subclass so
+ * it composes cleanly with `try/catch`, but the new postinstall subsystem never
+ * lets it escape — injectors catch and convert to diagnostics.
+ */
+export class PrettyParseError extends Error {
+    filePath;
+    line;
+    column;
+    constructor(filePath, message, source, index) {
+        const { line, column } = toLineAndColumn(source, index);
+        const snippet = formatSnippet(source, line, column);
+        super(`${filePath}:${line}:${column} ${message}\n${snippet}`);
+        this.name = 'PrettyParseError';
+        this.filePath = filePath;
+        this.line = line;
+        this.column = column;
+    }
+}
+function toLineAndColumn(source, index) {
+    let line = 1;
+    let column = 1;
+    const limit = Math.min(index, source.length);
+    for (let i = 0; i < limit; i += 1) {
+        if (source[i] === '\n') {
+            line += 1;
+            column = 1;
+        }
+        else {
+            column += 1;
+        }
+    }
+    return { line, column };
+}
+function formatSnippet(source, line, column) {
+    const lines = source.split(/\r?\n/);
+    const lineText = lines[line - 1] ?? '';
+    return `${lineText}\n${' '.repeat(Math.max(0, column - 1))}^`;
+}
+//# sourceMappingURL=PrettyParseError.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PrettyParseError.js","sourceRoot":"","sources":["../../../src/postinstall/unreal/PrettyParseError.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACzB,QAAQ,CAAS;IACjB,IAAI,CAAS;IACb,MAAM,CAAS;IAE/B,YAAmB,QAAgB,EAAE,OAAe,EAAE,MAAc,EAAE,KAAa;QACjF,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,eAAe,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACxD,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QACpD,KAAK,CAAC,GAAG,QAAQ,IAAI,IAAI,IAAI,MAAM,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC,CAAC;QAC9D,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED,SAAS,eAAe,CAAC,MAAc,EAAE,KAAa;IACpD,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAC7C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAClC,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACvB,IAAI,IAAI,CAAC,CAAC;YACV,MAAM,GAAG,CAAC,CAAC;QACb,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,CAAC,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAC1B,CAAC;AAED,SAAS,aAAa,CAAC,MAAc,EAAE,IAAY,EAAE,MAAc;IACjE,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACvC,OAAO,GAAG,QAAQ,KAAK,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;AAChE,CAAC"}

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

@@ -0,0 +1,20 @@
+/**
+ * Pure-IO locator for Unreal build-tree anchors:
+ *   * `*.Build.cs` files under `<projectRoot>/Source`
+ *   * `*.Target.cs` files under `<projectRoot>/Source`
+ *   * The single `*.uproject` at the project root.
+ *
+ * This module does no parsing; {@link UnrealSourceCatalog} pairs the returned
+ * paths with a {@link CSharpStructureAnalyzer} to validate them.
+ */
+export declare class ProjectFileLocator {
+    findBuildFiles(projectRoot: string): string[];
+    findTargetFiles(projectRoot: string): string[];
+    /**
+     * Returns the single `.uproject` file at `projectRoot`, or throws if 0 or 2+
+     * exist. Callers in the new subsystem catch and convert to diagnostics.
+     */
+    findProjectFile(projectRoot: string): string;
+    private findBySuffix;
+}
+//# sourceMappingURL=ProjectFileLocator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectFileLocator.d.ts","sourceRoot":"","sources":["../../../src/postinstall/unreal/ProjectFileLocator.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,qBAAa,kBAAkB;IACtB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE;IAI7C,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE;IAIrD;;;OAGG;IACI,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAWnD,OAAO,CAAC,YAAY;CAkBrB"}

package/dist/postinstall/unreal/ProjectFileLocator.js

@@ -0,0 +1,53 @@
+import fs from 'node:fs';
+import * as path from 'node:path';
+/**
+ * Pure-IO locator for Unreal build-tree anchors:
+ *   * `*.Build.cs` files under `<projectRoot>/Source`
+ *   * `*.Target.cs` files under `<projectRoot>/Source`
+ *   * The single `*.uproject` at the project root.
+ *
+ * This module does no parsing; {@link UnrealSourceCatalog} pairs the returned
+ * paths with a {@link CSharpStructureAnalyzer} to validate them.
+ */
+export class ProjectFileLocator {
+    findBuildFiles(projectRoot) {
+        return this.findBySuffix(path.join(projectRoot, 'Source'), '.Build.cs');
+    }
+    findTargetFiles(projectRoot) {
+        return this.findBySuffix(path.join(projectRoot, 'Source'), '.Target.cs');
+    }
+    /**
+     * Returns the single `.uproject` file at `projectRoot`, or throws if 0 or 2+
+     * exist. Callers in the new subsystem catch and convert to diagnostics.
+     */
+    findProjectFile(projectRoot) {
+        const entries = fs
+            .readdirSync(projectRoot, { withFileTypes: true })
+            .filter((entry) => entry.isFile() && entry.name.toLowerCase().endsWith('.uproject'))
+            .map((entry) => path.join(projectRoot, entry.name));
+        if (entries.length !== 1) {
+            throw new Error(`Expected exactly one .uproject in ${projectRoot}, found ${entries.length}`);
+        }
+        return entries[0];
+    }
+    findBySuffix(root, suffix) {
+        if (!fs.existsSync(root))
+            return [];
+        const files = [];
+        const stack = [root];
+        while (stack.length > 0) {
+            const current = stack.pop();
+            for (const entry of fs.readdirSync(current, { withFileTypes: true })) {
+                const fullPath = path.join(current, entry.name);
+                if (entry.isDirectory()) {
+                    stack.push(fullPath);
+                    continue;
+                }
+                if (entry.isFile() && fullPath.endsWith(suffix))
+                    files.push(fullPath);
+            }
+        }
+        return files.sort((a, b) => a.localeCompare(b));
+    }
+}
+//# sourceMappingURL=ProjectFileLocator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectFileLocator.js","sourceRoot":"","sources":["../../../src/postinstall/unreal/ProjectFileLocator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC;;;;;;;;GAQG;AACH,MAAM,OAAO,kBAAkB;IACtB,cAAc,CAAC,WAAmB;QACvC,OAAO,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,EAAE,WAAW,CAAC,CAAC;IAC1E,CAAC;IAEM,eAAe,CAAC,WAAmB;QACxC,OAAO,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,EAAE,YAAY,CAAC,CAAC;IAC3E,CAAC;IAED;;;OAGG;IACI,eAAe,CAAC,WAAmB;QACxC,MAAM,OAAO,GAAG,EAAE;aACf,WAAW,CAAC,WAAW,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;aACjD,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;aACnF,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QACtD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,qCAAqC,WAAW,WAAW,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAC/F,CAAC;QACD,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IAEO,YAAY,CAAC,IAAY,EAAE,MAAc;QAC/C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO,EAAE,CAAC;QAEpC,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,CAAC;QACrB,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,EAAY,CAAC;YACtC,KAAK,MAAM,KAAK,IAAI,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;gBACrE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;gBAChD,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;oBACxB,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;oBACrB,SAAS;gBACX,CAAC;gBACD,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC;oBAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACxE,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IAClD,CAAC;CACF"}

package/dist/postinstall/unreal/TargetCsInjector.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 `setupTargets` content into a single `*.Target.cs` file.
+ *
+ * Mirrors {@link BuildCsInjector} but targets `TargetRules`/`TargetInfo` and a
+ * different marker-zone name-space. Never throws — errors become diagnostics.
+ * Pre-existing owned marker blocks are integrity-checked before mutation and
+ * surfaced as `POSTINSTALL_MARKER_CORRUPT` on failure.
+ */
+export declare class TargetCsInjector {
+    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=TargetCsInjector.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TargetCsInjector.d.ts","sourceRoot":"","sources":["../../../src/postinstall/unreal/TargetCsInjector.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,gBAAgB;IAEzB,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/TargetCsInjector.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 TARGET_CS_ZONES = ['target-includes', 'target-class-body', 'target-constructor'];
+/**
+ * Injects a plugin's `setupTargets` content into a single `*.Target.cs` file.
+ *
+ * Mirrors {@link BuildCsInjector} but targets `TargetRules`/`TargetInfo` and a
+ * different marker-zone name-space. Never throws — errors become diagnostics.
+ * Pre-existing owned marker blocks are integrity-checked before mutation and
+ * surfaced as `POSTINSTALL_MARKER_CORRUPT` on failure.
+ */
+export class TargetCsInjector {
+    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 TARGET_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, 'target-includes');
+            }
+            if (zones.classBody?.trim()) {
+                const parsedForWrapper = this.analyzer.parseTarget(filePath, source);
+                const wrapperClassName = getWrapperClassName(pluginName);
+                const wrapper = this.wrapperFactory.createWrapper(wrapperClassName, 'TargetRules', 'target', zones.classBody);
+                source = this.injector.applyClassWrapper(parsedForWrapper, pluginName, wrapper, 'target-class-body');
+                const parsedForCtor = this.analyzer.parseTarget(filePath, source);
+                source = this.injector.applyConstructorCall(parsedForCtor, pluginName, `${wrapperClassName}.Apply(this)`, 'target-constructor');
+            }
+            fs.writeFileSync(filePath, source, 'utf-8');
+            return ok(undefined);
+        }
+        catch (error) {
+            return fail([createIoErrorDiagnostic(filePath, error instanceof Error ? error.message : String(error))]);
+        }
+    }
+}
+//# sourceMappingURL=TargetCsInjector.js.map

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

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

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

@@ -0,0 +1,12 @@
+import { type Result } from '@uapkg/diagnostics';
+/**
+ * Enables the given plugin names in the host project's `.uproject` file,
+ * preserving all other fields. Adds new entries with `Enabled: true` when the
+ * plugin isn't already listed; toggles `Enabled: true` on existing entries.
+ *
+ * Never throws — returns a `Result<void>`.
+ */
+export declare class UProjectInjector {
+    apply(projectFilePath: string, pluginNames: readonly string[]): Result<void>;
+}
+//# sourceMappingURL=UProjectInjector.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"UProjectInjector.d.ts","sourceRoot":"","sources":["../../../src/postinstall/unreal/UProjectInjector.ts"],"names":[],"mappings":"AACA,OAAO,EAAiE,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAahH;;;;;;GAMG;AACH,qBAAa,gBAAgB;IACpB,KAAK,CAAC,eAAe,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC;CA0CpF"}

package/dist/postinstall/unreal/UProjectInjector.js

@@ -0,0 +1,54 @@
+import fs from 'node:fs';
+import { createIoErrorDiagnostic, createParseErrorDiagnostic, fail, ok } from '@uapkg/diagnostics';
+/**
+ * Enables the given plugin names in the host project's `.uproject` file,
+ * preserving all other fields. Adds new entries with `Enabled: true` when the
+ * plugin isn't already listed; toggles `Enabled: true` on existing entries.
+ *
+ * Never throws — returns a `Result<void>`.
+ */
+export class UProjectInjector {
+    apply(projectFilePath, pluginNames) {
+        if (pluginNames.length === 0)
+            return ok(undefined);
+        let source;
+        try {
+            source = fs.readFileSync(projectFilePath, 'utf-8');
+        }
+        catch (error) {
+            return fail([createIoErrorDiagnostic(projectFilePath, error instanceof Error ? error.message : String(error))]);
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(source);
+        }
+        catch (error) {
+            return fail([
+                createParseErrorDiagnostic(error instanceof Error ? error.message : String(error), projectFilePath),
+            ]);
+        }
+        const plugins = Array.isArray(parsed.Plugins) ? [...parsed.Plugins] : [];
+        const indexByName = new Map();
+        plugins.forEach((entry, index) => {
+            if (typeof entry.Name === 'string' && entry.Name.trim())
+                indexByName.set(entry.Name, index);
+        });
+        for (const pluginName of pluginNames) {
+            const existingIndex = indexByName.get(pluginName);
+            if (existingIndex === undefined) {
+                plugins.push({ Name: pluginName, Enabled: true });
+                continue;
+            }
+            plugins[existingIndex] = { ...plugins[existingIndex], Enabled: true };
+        }
+        parsed.Plugins = plugins;
+        try {
+            fs.writeFileSync(projectFilePath, `${JSON.stringify(parsed, null, 2)}\n`, 'utf-8');
+        }
+        catch (error) {
+            return fail([createIoErrorDiagnostic(projectFilePath, error instanceof Error ? error.message : String(error))]);
+        }
+        return ok(undefined);
+    }
+}
+//# sourceMappingURL=UProjectInjector.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"UProjectInjector.js","sourceRoot":"","sources":["../../../src/postinstall/unreal/UProjectInjector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,uBAAuB,EAAE,0BAA0B,EAAE,IAAI,EAAE,EAAE,EAAe,MAAM,oBAAoB,CAAC;AAahH;;;;;;GAMG;AACH,MAAM,OAAO,gBAAgB;IACpB,KAAK,CAAC,eAAuB,EAAE,WAA8B;QAClE,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC,SAAS,CAAC,CAAC;QAEnD,IAAI,MAAc,CAAC;QACnB,IAAI,CAAC;YACH,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;QACrD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,CAAC,CAAC,uBAAuB,CAAC,eAAe,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAClH,CAAC;QAED,IAAI,MAAwB,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAqB,CAAC;QAClD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,CAAC;gBACV,0BAA0B,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,eAAe,CAAC;aACpG,CAAC,CAAC;QACL,CAAC;QAED,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACzE,MAAM,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC9C,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;YAC/B,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE;gBAAE,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC9F,CAAC,CAAC,CAAC;QAEH,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;YACrC,MAAM,aAAa,GAAG,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YAClD,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;gBAChC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;gBAClD,SAAS;YACX,CAAC;YACD,OAAO,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACxE,CAAC;QAED,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC;QACzB,IAAI,CAAC;YACH,EAAE,CAAC,aAAa,CAAC,eAAe,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACrF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,CAAC,CAAC,uBAAuB,CAAC,eAAe,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAClH,CAAC;QACD,OAAO,EAAE,CAAC,SAAS,CAAC,CAAC;IACvB,CAAC;CACF"}

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

@@ -0,0 +1,9 @@
+/**
+ * Reads the `Modules` array from a `.uproject` JSON file and returns the list
+ * of module names. Used when no explicit `postinstall.modules` is configured
+ * on the project manifest.
+ */
+export declare class UProjectMetadataReader {
+    readModuleNames(uprojectPath: string): string[];
+}
+//# sourceMappingURL=UProjectMetadataReader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"UProjectMetadataReader.d.ts","sourceRoot":"","sources":["../../../src/postinstall/unreal/UProjectMetadataReader.ts"],"names":[],"mappings":"AAUA;;;;GAIG;AACH,qBAAa,sBAAsB;IAC1B,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE;CAWvD"}

package/dist/postinstall/unreal/UProjectMetadataReader.js

@@ -0,0 +1,20 @@
+import fs from 'node:fs';
+/**
+ * Reads the `Modules` array from a `.uproject` JSON file and returns the list
+ * of module names. Used when no explicit `postinstall.modules` is configured
+ * on the project manifest.
+ */
+export class UProjectMetadataReader {
+    readModuleNames(uprojectPath) {
+        const source = fs.readFileSync(uprojectPath, 'utf-8');
+        let parsed;
+        try {
+            parsed = JSON.parse(source);
+        }
+        catch (error) {
+            throw new Error(`Failed to parse ${uprojectPath}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        return (parsed.Modules ?? []).map((entry) => entry.Name?.trim()).filter((value) => Boolean(value));
+    }
+}
+//# sourceMappingURL=UProjectMetadataReader.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"UProjectMetadataReader.js","sourceRoot":"","sources":["../../../src/postinstall/unreal/UProjectMetadataReader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AAUzB;;;;GAIG;AACH,MAAM,OAAO,sBAAsB;IAC1B,eAAe,CAAC,YAAoB;QACzC,MAAM,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACtD,IAAI,MAAwB,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAqB,CAAC;QAClD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,mBAAmB,YAAY,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAChH,CAAC;QAED,OAAO,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IACtH,CAAC;CACF"}

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

@@ -0,0 +1,23 @@
+import { CSharpStructureAnalyzer } from './CSharpStructureAnalyzer.js';
+import { ProjectFileLocator } from './ProjectFileLocator.js';
+export interface SourceCatalog {
+    /** ModuleName → absolute path of its `*.Build.cs`. */
+    readonly moduleFiles: ReadonlyMap<string, string>;
+    /** Absolute paths to every `*.Target.cs` in the project source tree. */
+    readonly targetFiles: readonly string[];
+}
+/**
+ * Scans the project source tree and validates every discovered `Build.cs` /
+ * `Target.cs` with {@link CSharpStructureAnalyzer}. This is a one-shot
+ * pre-flight check: the orchestrator runs it once before any injector mutates
+ * a file, so we fail fast on malformed sources.
+ */
+export declare class UnrealSourceCatalogBuilder {
+    private readonly fileLocator;
+    private readonly analyzer;
+    constructor(fileLocator?: ProjectFileLocator, analyzer?: CSharpStructureAnalyzer);
+    build(projectRoot: string, expectedModules: readonly string[]): SourceCatalog;
+    private resolveModules;
+    private resolveTargets;
+}
+//# sourceMappingURL=UnrealSourceCatalog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"UnrealSourceCatalog.d.ts","sourceRoot":"","sources":["../../../src/postinstall/unreal/UnrealSourceCatalog.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,MAAM,WAAW,aAAa;IAC5B,sDAAsD;IACtD,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClD,wEAAwE;IACxE,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC;AAED;;;;;GAKG;AACH,qBAAa,0BAA0B;IAEnC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBADR,WAAW,GAAE,kBAA6C,EAC1D,QAAQ,GAAE,uBAAuD;IAG7E,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,eAAe,EAAE,SAAS,MAAM,EAAE,GAAG,aAAa;IAMpF,OAAO,CAAC,cAAc;IA0BtB,OAAO,CAAC,cAAc;CAQvB"}

package/dist/postinstall/unreal/UnrealSourceCatalog.js

@@ -0,0 +1,52 @@
+import fs from 'node:fs';
+import { CSharpStructureAnalyzer } from './CSharpStructureAnalyzer.js';
+import { ProjectFileLocator } from './ProjectFileLocator.js';
+/**
+ * Scans the project source tree and validates every discovered `Build.cs` /
+ * `Target.cs` with {@link CSharpStructureAnalyzer}. This is a one-shot
+ * pre-flight check: the orchestrator runs it once before any injector mutates
+ * a file, so we fail fast on malformed sources.
+ */
+export class UnrealSourceCatalogBuilder {
+    fileLocator;
+    analyzer;
+    constructor(fileLocator = new ProjectFileLocator(), analyzer = new CSharpStructureAnalyzer()) {
+        this.fileLocator = fileLocator;
+        this.analyzer = analyzer;
+    }
+    build(projectRoot, expectedModules) {
+        const moduleFiles = this.resolveModules(projectRoot, expectedModules);
+        const targetFiles = this.resolveTargets(projectRoot);
+        return { moduleFiles, targetFiles };
+    }
+    resolveModules(projectRoot, expectedModules) {
+        const files = this.fileLocator.findBuildFiles(projectRoot);
+        const discovered = new Map();
+        for (const filePath of files) {
+            const source = fs.readFileSync(filePath, 'utf-8');
+            const parsed = this.analyzer.parseModule(filePath, source);
+            if (discovered.has(parsed.classInfo.className)) {
+                throw new Error(`Duplicate ModuleRules class '${parsed.classInfo.className}' in ${discovered.get(parsed.classInfo.className)} and ${filePath}`);
+            }
+            discovered.set(parsed.classInfo.className, filePath);
+        }
+        const missing = expectedModules.filter((name) => !discovered.has(name));
+        if (missing.length > 0) {
+            throw new Error(`Missing module Build.cs files for: ${missing.join(', ')}`);
+        }
+        const moduleFiles = new Map();
+        for (const moduleName of expectedModules) {
+            moduleFiles.set(moduleName, discovered.get(moduleName));
+        }
+        return moduleFiles;
+    }
+    resolveTargets(projectRoot) {
+        const files = this.fileLocator.findTargetFiles(projectRoot);
+        for (const filePath of files) {
+            const source = fs.readFileSync(filePath, 'utf-8');
+            this.analyzer.parseTarget(filePath, source);
+        }
+        return files;
+    }
+}
+//# sourceMappingURL=UnrealSourceCatalog.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"UnrealSourceCatalog.js","sourceRoot":"","sources":["../../../src/postinstall/unreal/UnrealSourceCatalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAS7D;;;;;GAKG;AACH,MAAM,OAAO,0BAA0B;IAElB;IACA;IAFnB,YACmB,cAAkC,IAAI,kBAAkB,EAAE,EAC1D,WAAoC,IAAI,uBAAuB,EAAE;QADjE,gBAAW,GAAX,WAAW,CAA+C;QAC1D,aAAQ,GAAR,QAAQ,CAAyD;IACjF,CAAC;IAEG,KAAK,CAAC,WAAmB,EAAE,eAAkC;QAClE,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC;QACtE,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;QACrD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC;IACtC,CAAC;IAEO,cAAc,CAAC,WAAmB,EAAE,eAAkC;QAC5E,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;QAC3D,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC7C,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;YAC7B,MAAM,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAClD,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAC3D,IAAI,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC/C,MAAM,IAAI,KAAK,CACb,gCAAgC,MAAM,CAAC,SAAS,CAAC,SAAS,QAAQ,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,QAAQ,QAAQ,EAAE,CAC/H,CAAC;YACJ,CAAC;YACD,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QACvD,CAAC;QAED,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;QACxE,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,sCAAsC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC9E,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC9C,KAAK,MAAM,UAAU,IAAI,eAAe,EAAE,CAAC;YACzC,WAAW,CAAC,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC,GAAG,CAAC,UAAU,CAAW,CAAC,CAAC;QACpE,CAAC;QACD,OAAO,WAAW,CAAC;IACrB,CAAC;IAEO,cAAc,CAAC,WAAmB;QACxC,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;QAC5D,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;YAC7B,MAAM,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAClD,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/prompts/InkPromptService.d.ts

@@ -0,0 +1,8 @@
+import type { PromptService, SelectOption } from './PromptService.js';
+export declare class InkPromptService implements PromptService {
+    private readonly isInteractive;
+    constructor(isInteractive?: boolean);
+    select(message: string, options: SelectOption[], fallbackValue: string): Promise<string>;
+    text(message: string, initialValue: string): Promise<string>;
+}
+//# sourceMappingURL=InkPromptService.d.ts.map

package/dist/prompts/InkPromptService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InkPromptService.d.ts","sourceRoot":"","sources":["../../src/prompts/InkPromptService.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAStE,qBAAa,gBAAiB,YAAW,aAAa;IACjC,OAAO,CAAC,QAAQ,CAAC,aAAa;gBAAb,aAAa,UAAgE;IAEpG,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAUxF,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAW1E"}

package/dist/prompts/InkPromptService.js

@@ -0,0 +1,56 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, render, Text, useApp, useInput } from 'ink';
+import SelectInput from 'ink-select-input';
+import TextInput from 'ink-text-input';
+import isCI from 'is-ci';
+// biome-ignore lint/correctness/noUnusedImports: Ink requires React
+import React, { useState } from 'react';
+// ---------------------------------------------------------------------------
+// InkPromptService — renders interactive prompts via Ink/React.
+//
+// Auto-detects non-interactive environments (no TTY or CI) and returns the
+// supplied fallback without ever rendering.
+// ---------------------------------------------------------------------------
+export class InkPromptService {
+    isInteractive;
+    constructor(isInteractive = Boolean(process.stdin.isTTY && process.stdout.isTTY) && !isCI) {
+        this.isInteractive = isInteractive;
+    }
+    async select(message, options, fallbackValue) {
+        if (!this.isInteractive) {
+            return fallbackValue;
+        }
+        return await new Promise((resolve) => {
+            const app = render(_jsx(SelectPrompt, { message: message, options: options, onSubmit: (value) => resolve(value) }));
+            Promise.resolve().then(() => app.waitUntilExit());
+        });
+    }
+    async text(message, initialValue) {
+        if (!this.isInteractive) {
+            return initialValue;
+        }
+        return await new Promise((resolve) => {
+            const app = render(_jsx(TextPrompt, { message: message, initialValue: initialValue, onSubmit: (value) => resolve(value) }));
+            Promise.resolve().then(() => app.waitUntilExit());
+        });
+    }
+}
+function SelectPrompt({ message, options, onSubmit, }) {
+    const { exit } = useApp();
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: message }), _jsx(SelectInput, { items: options, onSelect: (item) => {
+                    onSubmit(item.value);
+                    exit();
+                } })] }));
+}
+function TextPrompt({ message, initialValue, onSubmit, }) {
+    const [value, setValue] = useState(initialValue);
+    const { exit } = useApp();
+    useInput((_, key) => {
+        if (key.return) {
+            onSubmit(value.trim() || initialValue);
+            exit();
+        }
+    });
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: message }), _jsx(TextInput, { value: value, onChange: setValue }), _jsx(Text, { color: "gray", children: "Press Enter to confirm." })] }));
+}
+//# sourceMappingURL=InkPromptService.js.map

package/dist/prompts/InkPromptService.js.map

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