@uapkg/cli 1.1.8 → 1.1.9

package/dist/commands/WhyCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WhyCommand.js","sourceRoot":"","sources":["../../src/commands/WhyCommand.ts"],"names":[],"mappings":"AASA;;;;;;;GAOG;AACH,MAAM,OAAO,UAAU;IAEF;IACA;IAFnB,YACmB,IAAqB,EACrB,OAA0B;QAD1B,SAAI,GAAJ,IAAI,CAAiB;QACrB,YAAO,GAAP,OAAO,CAAmB;IAC1C,CAAC;IAEG,KAAK,CAAC,OAAO;QAClB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAqB,CAAC;QAClD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAElE,IAAI,IAAI,CAAC,OAAO,CAAC,YAAY,KAAK,MAAM,EAAE,CAAC;YACzC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;gBAClB,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO;gBAClC,OAAO,EAAE,KAAK;gBACd,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;gBAC1C,WAAW,EAAE,MAAM,CAAC,WAAW;aAChC,CAAC,CAAC;YACH,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAChG,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QACpD,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,OAAO,CAAC,CAAC;QAEzB,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC;QAC5C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACvC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,uBAAuB,MAAM,4BAA4B,CAAC,CAAC;YAChF,OAAO,CAAC,CAAC;QACX,CAAC;QACD,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,uBAAuB,CAAC,CAAC;QACzD,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,MAAM,QAAQ,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACzE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC;QAC1C,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;CACF"}

package/dist/commands/add/DependencyAddResolver.d.ts

@@ -0,0 +1,18 @@
+import type { PackageSpec } from '@uapkg/common-schema';
+import { type Result } from '@uapkg/diagnostics';
+import type { Dependency } from '@uapkg/package-manifest-schema';
+import type { CompositionRoot } from '../../app/CompositionRoot.js';
+export interface ResolvedAddDependency {
+    readonly dependency: Dependency;
+    readonly resolvedVersion: string;
+}
+/**
+ * Resolves an `add` request against the selected registry before mutating the
+ * manifest, ensuring package and version existence.
+ */
+export declare class DependencyAddResolver {
+    private readonly root;
+    constructor(root: CompositionRoot);
+    resolve(spec: PackageSpec, registryNameInput?: string): Promise<Result<ResolvedAddDependency>>;
+}
+//# sourceMappingURL=DependencyAddResolver.d.ts.map

package/dist/commands/add/DependencyAddResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DependencyAddResolver.d.ts","sourceRoot":"","sources":["../../../src/commands/add/DependencyAddResolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAgB,MAAM,sBAAsB,CAAC;AAEtE,OAAO,EAA8C,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC7F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED;;;GAGG;AACH,qBAAa,qBAAqB;IACb,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,eAAe;IAE5C,OAAO,CAAC,IAAI,EAAE,WAAW,EAAE,iBAAiB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;CAgC5G"}

package/dist/commands/add/DependencyAddResolver.js

@@ -0,0 +1,36 @@
+import { RegistryNameSchema, VersionRangeSchema } from '@uapkg/common-schema';
+import { createRegistryNotFoundDiagnostic, fail, ok } from '@uapkg/diagnostics';
+/**
+ * Resolves an `add` request against the selected registry before mutating the
+ * manifest, ensuring package and version existence.
+ */
+export class DependencyAddResolver {
+    root;
+    constructor(root) {
+        this.root = root;
+    }
+    async resolve(spec, registryNameInput) {
+        const registryCandidate = registryNameInput ?? this.root.config.get('registry') ?? 'default';
+        const registryNameResult = RegistryNameSchema.safeParse(registryCandidate);
+        if (!registryNameResult.success) {
+            return fail([createRegistryNotFoundDiagnostic(registryCandidate)]);
+        }
+        const registryName = registryNameResult.data;
+        const registryResult = this.root.registryCore.getOrCreateRegistry(registryName);
+        if (!registryResult.ok)
+            return registryResult;
+        const requestedRange = spec.range ?? '*';
+        const resolution = await registryResult.value.resolvePackage(spec.name, requestedRange, registryName);
+        if (!resolution.ok)
+            return resolution;
+        const dependencyRange = spec.range ?? VersionRangeSchema.parse(`^${resolution.value.version}`);
+        return ok({
+            dependency: {
+                version: dependencyRange,
+                registry: registryName,
+            },
+            resolvedVersion: resolution.value.version,
+        }, resolution.diagnostics);
+    }
+}
+//# sourceMappingURL=DependencyAddResolver.js.map

package/dist/commands/add/DependencyAddResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DependencyAddResolver.js","sourceRoot":"","sources":["../../../src/commands/add/DependencyAddResolver.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EAAE,gCAAgC,EAAE,IAAI,EAAE,EAAE,EAAe,MAAM,oBAAoB,CAAC;AAS7F;;;GAGG;AACH,MAAM,OAAO,qBAAqB;IACI;IAApC,YAAoC,IAAqB;QAArB,SAAI,GAAJ,IAAI,CAAiB;IAAG,CAAC;IAEtD,KAAK,CAAC,OAAO,CAAC,IAAiB,EAAE,iBAA0B;QAChE,MAAM,iBAAiB,GAAG,iBAAiB,IAAK,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAmB,IAAI,SAAS,CAAC;QAChH,MAAM,kBAAkB,GAAG,kBAAkB,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;QAC3E,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC,CAAC,gCAAgC,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;QACrE,CAAC;QACD,MAAM,YAAY,GAAG,kBAAkB,CAAC,IAAI,CAAC;QAE7C,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,mBAAmB,CAAC,YAAY,CAAC,CAAC;QAChF,IAAI,CAAC,cAAc,CAAC,EAAE;YAAE,OAAO,cAA+B,CAAC;QAE/D,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,IAAK,GAA+B,CAAC;QACtE,MAAM,UAAU,GAAG,MAAM,cAAc,CAAC,KAAK,CAAC,cAAc,CAC1D,IAAI,CAAC,IAAyB,EAC9B,cAAc,EACd,YAAY,CACb,CAAC;QACF,IAAI,CAAC,UAAU,CAAC,EAAE;YAAE,OAAO,UAA2B,CAAC;QAEvD,MAAM,eAAe,GAAG,IAAI,CAAC,KAAK,IAAI,kBAAkB,CAAC,KAAK,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAE/F,OAAO,EAAE,CACP;YACE,UAAU,EAAE;gBACV,OAAO,EAAE,eAAe;gBACxB,QAAQ,EAAE,YAAY;aACvB;YACD,eAAe,EAAE,UAAU,CAAC,KAAK,CAAC,OAAO;SAC1C,EACD,UAAU,CAAC,WAAW,CACvB,CAAC;IACJ,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+export { CompositionRoot, type CompositionRootOptions } from './app/CompositionRoot.js';
+export { UAPKGApplication } from './app/UAPKGApplication.js';
+export { parseUAPKGCommandLine } from './cli/parseCommandLine.js';
+export { runUAPKGCLI } from './cli/runUAPKGCLI.js';
+export type { UAPKGCommandLine } from './cli/UAPKGCommandLine.js';
+export { createUAPKGCommandLineFactory, UAPKGCommandLineFactory } from './cli/UAPKGCommandLine.js';
+export { AddCommand, type AddCommandOptions } from './commands/AddCommand.js';
+export { ConfigCommand } from './commands/ConfigCommand.js';
+export { InitCommand, type InitCommandOptions } from './commands/InitCommand.js';
+export { InstallCommand, type InstallCommandOptions } from './commands/InstallCommand.js';
+export { ListCommand, type ListCommandOptions } from './commands/ListCommand.js';
+export { OutdatedCommand, type OutdatedCommandOptions } from './commands/OutdatedCommand.js';
+export { PackCommand } from './commands/PackCommand.js';
+export { ProjectGetNameCommand, type ProjectGetNameCommandOptions, } from './commands/ProjectGetNameCommand.js';
+export { RegistryCommand, type RegistryCommandOptions } from './commands/RegistryCommand.js';
+export { RemoveCommand, type RemoveCommandOptions } from './commands/RemoveCommand.js';
+export { UpdateCommand, type UpdateCommandOptions } from './commands/UpdateCommand.js';
+export { WhyCommand, type WhyCommandOptions } from './commands/WhyCommand.js';
+export * from './postinstall/index.js';
+export { InkPromptService } from './prompts/InkPromptService.js';
+export { type ProjectContextDetection, ProjectContextDetector, } from './prompts/ProjectContextDetector.js';
+export type { PromptService, SelectOption } from './prompts/PromptService.js';
+export { DiagnosticReporter } from './reporting/DiagnosticReporter.js';
+export { InstallProgressReporter } from './reporting/InstallProgressReporter.js';
+export { type JsonEnvelope, JsonReporter } from './reporting/JsonReporter.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":"AAUA,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AACxF,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAG7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,YAAY,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,6BAA6B,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAGnG,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE9E,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAC1F,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAC7F,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EACL,qBAAqB,EACrB,KAAK,4BAA4B,GAClC,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAC7F,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACvF,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE9E,cAAc,wBAAwB,CAAC;AAEvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EACL,KAAK,uBAAuB,EAC5B,sBAAsB,GACvB,MAAM,qCAAqC,CAAC;AAC7C,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,EAAE,KAAK,YAAY,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/index.js

@@ -0,0 +1,39 @@
+// ---------------------------------------------------------------------------
+// @uapkg/uapkg — public API
+//
+// Phase 8 + Phase 10 final surface. Legacy exports (`UAPKGManifest`,
+// `FileManifestRepository`, `DependencyGraphBuilder`, `TOMLLockfileRepository`,
+// `DependencyInstaller`, `SafetyPolicy`, etc.) were removed in Phase 10; use
+// `@uapkg/package-manifest` + `@uapkg/package-manifest-schema` instead.
+// ---------------------------------------------------------------------------
+// Application dispatcher + composition root
+export { CompositionRoot } from './app/CompositionRoot.js';
+export { UAPKGApplication } from './app/UAPKGApplication.js';
+// CLI
+export { parseUAPKGCommandLine } from './cli/parseCommandLine.js';
+export { runUAPKGCLI } from './cli/runUAPKGCLI.js';
+export { createUAPKGCommandLineFactory, UAPKGCommandLineFactory } from './cli/UAPKGCommandLine.js';
+// Commands — new surface
+export { AddCommand } from './commands/AddCommand.js';
+// Commands — retained, ported onto CompositionRoot in Phase 10
+export { ConfigCommand } from './commands/ConfigCommand.js';
+export { InitCommand } from './commands/InitCommand.js';
+export { InstallCommand } from './commands/InstallCommand.js';
+export { ListCommand } from './commands/ListCommand.js';
+export { OutdatedCommand } from './commands/OutdatedCommand.js';
+export { PackCommand } from './commands/PackCommand.js';
+export { ProjectGetNameCommand, } from './commands/ProjectGetNameCommand.js';
+export { RegistryCommand } from './commands/RegistryCommand.js';
+export { RemoveCommand } from './commands/RemoveCommand.js';
+export { UpdateCommand } from './commands/UpdateCommand.js';
+export { WhyCommand } from './commands/WhyCommand.js';
+// Postinstall — new subsystem (Phase 7)
+export * from './postinstall/index.js';
+// Prompt abstractions (used by init)
+export { InkPromptService } from './prompts/InkPromptService.js';
+export { ProjectContextDetector, } from './prompts/ProjectContextDetector.js';
+// Reporting
+export { DiagnosticReporter } from './reporting/DiagnosticReporter.js';
+export { InstallProgressReporter } from './reporting/InstallProgressReporter.js';
+export { JsonReporter } from './reporting/JsonReporter.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,8EAA8E;AAC9E,4BAA4B;AAC5B,EAAE;AACF,qEAAqE;AACrE,gFAAgF;AAChF,6EAA6E;AAC7E,wEAAwE;AACxE,8EAA8E;AAE9E,4CAA4C;AAC5C,OAAO,EAAE,eAAe,EAA+B,MAAM,0BAA0B,CAAC;AACxF,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAE7D,MAAM;AACN,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,OAAO,EAAE,6BAA6B,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEnG,yBAAyB;AACzB,OAAO,EAAE,UAAU,EAA0B,MAAM,0BAA0B,CAAC;AAC9E,+DAA+D;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,WAAW,EAA2B,MAAM,2BAA2B,CAAC;AACjF,OAAO,EAAE,cAAc,EAA8B,MAAM,8BAA8B,CAAC;AAC1F,OAAO,EAAE,WAAW,EAA2B,MAAM,2BAA2B,CAAC;AACjF,OAAO,EAAE,eAAe,EAA+B,MAAM,+BAA+B,CAAC;AAC7F,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EACL,qBAAqB,GAEtB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,eAAe,EAA+B,MAAM,+BAA+B,CAAC;AAC7F,OAAO,EAAE,aAAa,EAA6B,MAAM,6BAA6B,CAAC;AACvF,OAAO,EAAE,aAAa,EAA6B,MAAM,6BAA6B,CAAC;AACvF,OAAO,EAAE,UAAU,EAA0B,MAAM,0BAA0B,CAAC;AAC9E,wCAAwC;AACxC,cAAc,wBAAwB,CAAC;AACvC,qCAAqC;AACrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAEL,sBAAsB,GACvB,MAAM,qCAAqC,CAAC;AAE7C,YAAY;AACZ,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,EAAqB,YAAY,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/postinstall/api/PostinstallDsl.d.ts

@@ -0,0 +1,44 @@
+import { z } from 'zod';
+/**
+ * Zone-level content injected into a single Unreal build file (Build.cs or Target.cs).
+ *
+ * - `includes`: raw C# `using ...;` lines appended to the file's using block.
+ * - `classBody`: raw C# members placed inside the target class; uapkg wraps them
+ *   in a hashed helper class and inserts a single `Apply(this)` call into the
+ *   constructor. The content must compile as a member list.
+ */
+export declare const ZoneSchema: z.ZodObject<{
+    includes: z.ZodOptional<z.ZodString>;
+    classBody: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+/**
+ * Project-level setup: plugins to enable in the host project's `.uproject`.
+ */
+export declare const ProjectSetupSchema: z.ZodObject<{
+    plugins: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+/**
+ * The authoritative shape of `export default definePostinstall({...})`.
+ *
+ * Scopes:
+ * - `setupModules`: applied to each *project postinstall module* Build.cs file.
+ * - `setupTargets`: applied to every *.Target.cs in the host project.
+ * - `setupProject`: edits the host project's `.uproject`.
+ */
+export declare const PostinstallDefinitionSchema: z.ZodObject<{
+    setupModules: z.ZodOptional<z.ZodObject<{
+        includes: z.ZodOptional<z.ZodString>;
+        classBody: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    setupTargets: z.ZodOptional<z.ZodObject<{
+        includes: z.ZodOptional<z.ZodString>;
+        classBody: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    setupProject: z.ZodOptional<z.ZodObject<{
+        plugins: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type ZoneDefinition = z.infer<typeof ZoneSchema>;
+export type ProjectSetupDefinition = z.infer<typeof ProjectSetupSchema>;
+export type PostinstallDefinition = z.infer<typeof PostinstallDefinitionSchema>;
+//# sourceMappingURL=PostinstallDsl.d.ts.map

package/dist/postinstall/api/PostinstallDsl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostinstallDsl.d.ts","sourceRoot":"","sources":["../../../src/postinstall/api/PostinstallDsl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU;;;kBAKZ,CAAC;AAEZ;;GAEG;AACH,eAAO,MAAM,kBAAkB;;kBAIpB,CAAC;AAEZ;;;;;;;GAOG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;kBAM7B,CAAC;AAEZ,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AACxD,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AACxE,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC"}

package/dist/postinstall/api/PostinstallDsl.js

@@ -0,0 +1,39 @@
+import { z } from 'zod';
+/**
+ * Zone-level content injected into a single Unreal build file (Build.cs or Target.cs).
+ *
+ * - `includes`: raw C# `using ...;` lines appended to the file's using block.
+ * - `classBody`: raw C# members placed inside the target class; uapkg wraps them
+ *   in a hashed helper class and inserts a single `Apply(this)` call into the
+ *   constructor. The content must compile as a member list.
+ */
+export const ZoneSchema = z
+    .object({
+    includes: z.string().min(1).optional(),
+    classBody: z.string().min(1).optional(),
+})
+    .strict();
+/**
+ * Project-level setup: plugins to enable in the host project's `.uproject`.
+ */
+export const ProjectSetupSchema = z
+    .object({
+    plugins: z.array(z.string().min(1)).optional(),
+})
+    .strict();
+/**
+ * The authoritative shape of `export default definePostinstall({...})`.
+ *
+ * Scopes:
+ * - `setupModules`: applied to each *project postinstall module* Build.cs file.
+ * - `setupTargets`: applied to every *.Target.cs in the host project.
+ * - `setupProject`: edits the host project's `.uproject`.
+ */
+export const PostinstallDefinitionSchema = z
+    .object({
+    setupModules: ZoneSchema.optional(),
+    setupTargets: ZoneSchema.optional(),
+    setupProject: ProjectSetupSchema.optional(),
+})
+    .strict();
+//# sourceMappingURL=PostinstallDsl.js.map

package/dist/postinstall/api/PostinstallDsl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostinstallDsl.js","sourceRoot":"","sources":["../../../src/postinstall/api/PostinstallDsl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC;KACxB,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACtC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACxC,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC;KAChC,MAAM,CAAC;IACN,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC/C,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC;KACzC,MAAM,CAAC;IACN,YAAY,EAAE,UAAU,CAAC,QAAQ,EAAE;IACnC,YAAY,EAAE,UAAU,CAAC,QAAQ,EAAE;IACnC,YAAY,EAAE,kBAAkB,CAAC,QAAQ,EAAE;CAC5C,CAAC;KACD,MAAM,EAAE,CAAC"}

package/dist/postinstall/api/definePostinstall.d.ts

@@ -0,0 +1,18 @@
+import type { PostinstallDefinition } from './PostinstallDsl.js';
+/**
+ * Identity helper used in user-authored `.uapkg/postinstall.ts` files:
+ *
+ * ```ts
+ * import { definePostinstall } from 'uapkg/postinstall';
+ * export default definePostinstall({
+ *   setupModules: { classBody: '...' },
+ * });
+ * ```
+ *
+ * At runtime this is the identity function; at edit time it gives authors
+ * full TypeScript autocomplete/validation against {@link PostinstallDefinition}.
+ * The loader validates the shape regardless of whether the author used this
+ * helper, so it is purely ergonomic.
+ */
+export declare function definePostinstall(definition: PostinstallDefinition): PostinstallDefinition;
+//# sourceMappingURL=definePostinstall.d.ts.map

package/dist/postinstall/api/definePostinstall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definePostinstall.d.ts","sourceRoot":"","sources":["../../../src/postinstall/api/definePostinstall.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEjE;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,qBAAqB,GAAG,qBAAqB,CAE1F"}

package/dist/postinstall/api/definePostinstall.js

@@ -0,0 +1,19 @@
+/**
+ * Identity helper used in user-authored `.uapkg/postinstall.ts` files:
+ *
+ * ```ts
+ * import { definePostinstall } from 'uapkg/postinstall';
+ * export default definePostinstall({
+ *   setupModules: { classBody: '...' },
+ * });
+ * ```
+ *
+ * At runtime this is the identity function; at edit time it gives authors
+ * full TypeScript autocomplete/validation against {@link PostinstallDefinition}.
+ * The loader validates the shape regardless of whether the author used this
+ * helper, so it is purely ergonomic.
+ */
+export function definePostinstall(definition) {
+    return definition;
+}
+//# sourceMappingURL=definePostinstall.js.map

package/dist/postinstall/api/definePostinstall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definePostinstall.js","sourceRoot":"","sources":["../../../src/postinstall/api/definePostinstall.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAAiC;IACjE,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/postinstall/index.d.ts

@@ -0,0 +1,26 @@
+export { definePostinstall } from './api/definePostinstall.js';
+export type { PostinstallDefinition, ProjectSetupDefinition, ZoneDefinition } from './api/PostinstallDsl.js';
+export { PostinstallDefinitionSchema, ProjectSetupSchema, ZoneSchema, } from './api/PostinstallDsl.js';
+export { EntryResolver, type PostinstallEntryKind, type ResolvedEntry } from './loader/EntryResolver.js';
+export { EsbuildTranspiler } from './loader/EsbuildTranspiler.js';
+export { ExportValidator } from './loader/ExportValidator.js';
+export { ModuleImporter, type ModuleSource } from './loader/ModuleImporter.js';
+export { type LoadedPostinstall, PostinstallLoader } from './loader/PostinstallLoader.js';
+export { MarkerBlockEditor } from './markers/MarkerBlockEditor.js';
+export { MarkerBlockService } from './markers/MarkerBlockService.js';
+export { type MarkerIntegrityFail, type MarkerIntegrityOk, type MarkerIntegrityResult, MarkerIntegrityValidator, } from './markers/MarkerIntegrityValidator.js';
+export { type PolicyConfigReader, type PolicyDecision, PostinstallPolicyGate, } from './policy/PostinstallPolicyGate.js';
+export { type PostinstallCandidate, PostinstallOrchestrator, type PostinstallOrchestratorInput, type PostinstallReport, } from './runner/PostinstallOrchestrator.js';
+export { BuildCsInjector } from './unreal/BuildCsInjector.js';
+export { CSharpInjectionEngine } from './unreal/CSharpInjectionEngine.js';
+export { CSharpStructureAnalyzer } from './unreal/CSharpStructureAnalyzer.js';
+export type { CSharpFileKind, ParsedClass, ParsedConstructor, ParsedCSharpFile, } from './unreal/CSharpStructures.js';
+export { CSharpWrapperFactory, type WrapperContextType } from './unreal/CSharpWrapperFactory.js';
+export { getPluginHash, getWrapperClassName } from './unreal/PluginHash.js';
+export { PrettyParseError } from './unreal/PrettyParseError.js';
+export { ProjectFileLocator } from './unreal/ProjectFileLocator.js';
+export { TargetCsInjector } from './unreal/TargetCsInjector.js';
+export { type SourceCatalog, UnrealSourceCatalogBuilder } from './unreal/UnrealSourceCatalog.js';
+export { UProjectInjector } from './unreal/UProjectInjector.js';
+export { UProjectMetadataReader } from './unreal/UProjectMetadataReader.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/postinstall/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/postinstall/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAE/D,YAAY,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC7G,OAAO,EACL,2BAA2B,EAC3B,kBAAkB,EAClB,UAAU,GACX,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,KAAK,aAAa,EAAE,MAAM,2BAA2B,CAAC;AACzG,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,EAAE,KAAK,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAE1F,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,wBAAwB,GACzB,MAAM,uCAAuC,CAAC;AAE/C,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,qBAAqB,GACtB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EACL,KAAK,oBAAoB,EACzB,uBAAuB,EACvB,KAAK,4BAA4B,EACjC,KAAK,iBAAiB,GACvB,MAAM,qCAAqC,CAAC;AAE7C,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,YAAY,EACV,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,oBAAoB,EAAE,KAAK,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACjG,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,KAAK,aAAa,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AACjG,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC"}

package/dist/postinstall/index.js

@@ -0,0 +1,37 @@
+// ---------------------------------------------------------------------------
+// New postinstall subsystem — public surface.
+//
+// The legacy flat files in this directory (PostinstallRunner, BuildCsInjector,
+// etc.) remain in place until Phase 10 prunes them, so `packages/uapkg/src/
+// index.ts` keeps compiling. New consumers (Phase 8 CLI) should import from
+// this barrel only.
+// ---------------------------------------------------------------------------
+export { definePostinstall } from './api/definePostinstall.js';
+export { PostinstallDefinitionSchema, ProjectSetupSchema, ZoneSchema, } from './api/PostinstallDsl.js';
+// Loader
+export { EntryResolver } from './loader/EntryResolver.js';
+export { EsbuildTranspiler } from './loader/EsbuildTranspiler.js';
+export { ExportValidator } from './loader/ExportValidator.js';
+export { ModuleImporter } from './loader/ModuleImporter.js';
+export { PostinstallLoader } from './loader/PostinstallLoader.js';
+// Markers
+export { MarkerBlockEditor } from './markers/MarkerBlockEditor.js';
+export { MarkerBlockService } from './markers/MarkerBlockService.js';
+export { MarkerIntegrityValidator, } from './markers/MarkerIntegrityValidator.js';
+// Policy
+export { PostinstallPolicyGate, } from './policy/PostinstallPolicyGate.js';
+// Runner
+export { PostinstallOrchestrator, } from './runner/PostinstallOrchestrator.js';
+// Unreal
+export { BuildCsInjector } from './unreal/BuildCsInjector.js';
+export { CSharpInjectionEngine } from './unreal/CSharpInjectionEngine.js';
+export { CSharpStructureAnalyzer } from './unreal/CSharpStructureAnalyzer.js';
+export { CSharpWrapperFactory } from './unreal/CSharpWrapperFactory.js';
+export { getPluginHash, getWrapperClassName } from './unreal/PluginHash.js';
+export { PrettyParseError } from './unreal/PrettyParseError.js';
+export { ProjectFileLocator } from './unreal/ProjectFileLocator.js';
+export { TargetCsInjector } from './unreal/TargetCsInjector.js';
+export { UnrealSourceCatalogBuilder } from './unreal/UnrealSourceCatalog.js';
+export { UProjectInjector } from './unreal/UProjectInjector.js';
+export { UProjectMetadataReader } from './unreal/UProjectMetadataReader.js';
+//# sourceMappingURL=index.js.map

package/dist/postinstall/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/postinstall/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,8CAA8C;AAC9C,EAAE;AACF,+EAA+E;AAC/E,4EAA4E;AAC5E,4EAA4E;AAC5E,oBAAoB;AACpB,8EAA8E;AAE9E,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAG/D,OAAO,EACL,2BAA2B,EAC3B,kBAAkB,EAClB,UAAU,GACX,MAAM,yBAAyB,CAAC;AAEjC,SAAS;AACT,OAAO,EAAE,aAAa,EAAiD,MAAM,2BAA2B,CAAC;AACzG,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAqB,MAAM,4BAA4B,CAAC;AAC/E,OAAO,EAA0B,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAC1F,UAAU;AACV,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAIL,wBAAwB,GACzB,MAAM,uCAAuC,CAAC;AAC/C,SAAS;AACT,OAAO,EAGL,qBAAqB,GACtB,MAAM,mCAAmC,CAAC;AAC3C,SAAS;AACT,OAAO,EAEL,uBAAuB,GAGxB,MAAM,qCAAqC,CAAC;AAC7C,SAAS;AACT,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAO9E,OAAO,EAAE,oBAAoB,EAA2B,MAAM,kCAAkC,CAAC;AACjG,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAsB,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AACjG,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC"}

package/dist/postinstall/loader/EntryResolver.d.ts

@@ -0,0 +1,20 @@
+import { type Result } from '@uapkg/diagnostics';
+/** Candidate extensions in resolution order (spec-mandated). */
+declare const CANDIDATE_EXTENSIONS: readonly ["ts", "js", "mjs"];
+export type PostinstallEntryKind = (typeof CANDIDATE_EXTENSIONS)[number];
+export interface ResolvedEntry {
+    readonly path: string;
+    readonly kind: PostinstallEntryKind;
+}
+/**
+ * Locates `.uapkg/postinstall.<ext>` inside a plugin root, enforcing the
+ * order `ts → js → mjs`. If the plugin has two or more candidate files an
+ * error diagnostic `POSTINSTALL_DUPLICATE_ENTRY` is returned so the user can
+ * clean up ambiguity. `ok(null)` means "no postinstall defined" — a valid,
+ * silent state.
+ */
+export declare class EntryResolver {
+    resolve(packageName: string, pluginRoot: string): Result<ResolvedEntry | null>;
+}
+export {};
+//# sourceMappingURL=EntryResolver.d.ts.map

package/dist/postinstall/loader/EntryResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntryResolver.d.ts","sourceRoot":"","sources":["../../../src/postinstall/loader/EntryResolver.ts"],"names":[],"mappings":"AAEA,OAAO,EAAuD,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEtG,gEAAgE;AAChE,QAAA,MAAM,oBAAoB,8BAA+B,CAAC;AAC1D,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;CACrC;AAED;;;;;;GAMG;AACH,qBAAa,aAAa;IACjB,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,aAAa,GAAG,IAAI,CAAC;CAuBtF"}

package/dist/postinstall/loader/EntryResolver.js

@@ -0,0 +1,35 @@
+import fs from 'node:fs';
+import * as path from 'node:path';
+import { createPostinstallDuplicateEntryDiagnostic, fail, ok } from '@uapkg/diagnostics';
+/** Candidate extensions in resolution order (spec-mandated). */
+const CANDIDATE_EXTENSIONS = ['ts', 'js', 'mjs'];
+/**
+ * Locates `.uapkg/postinstall.<ext>` inside a plugin root, enforcing the
+ * order `ts → js → mjs`. If the plugin has two or more candidate files an
+ * error diagnostic `POSTINSTALL_DUPLICATE_ENTRY` is returned so the user can
+ * clean up ambiguity. `ok(null)` means "no postinstall defined" — a valid,
+ * silent state.
+ */
+export class EntryResolver {
+    resolve(packageName, pluginRoot) {
+        const dir = path.join(pluginRoot, '.uapkg');
+        if (!fs.existsSync(dir))
+            return ok(null);
+        const found = [];
+        for (const kind of CANDIDATE_EXTENSIONS) {
+            const candidate = path.join(dir, `postinstall.${kind}`);
+            if (fs.existsSync(candidate) && fs.statSync(candidate).isFile()) {
+                found.push({ path: candidate, kind });
+            }
+        }
+        if (found.length === 0)
+            return ok(null);
+        if (found.length > 1) {
+            return fail([
+                createPostinstallDuplicateEntryDiagnostic(packageName, found.map((entry) => entry.path)),
+            ]);
+        }
+        return ok(found[0]);
+    }
+}
+//# sourceMappingURL=EntryResolver.js.map

package/dist/postinstall/loader/EntryResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntryResolver.js","sourceRoot":"","sources":["../../../src/postinstall/loader/EntryResolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,yCAAyC,EAAE,IAAI,EAAE,EAAE,EAAe,MAAM,oBAAoB,CAAC;AAEtG,gEAAgE;AAChE,MAAM,oBAAoB,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAU,CAAC;AAQ1D;;;;;;GAMG;AACH,MAAM,OAAO,aAAa;IACjB,OAAO,CAAC,WAAmB,EAAE,UAAkB;QACpD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAC5C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC;QAEzC,MAAM,KAAK,GAAoB,EAAE,CAAC;QAClC,KAAK,MAAM,IAAI,IAAI,oBAAoB,EAAE,CAAC;YACxC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,IAAI,EAAE,CAAC,CAAC;YACxD,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;gBAChE,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACxC,CAAC;QACH,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,OAAO,IAAI,CAAC;gBACV,yCAAyC,CACvC,WAAW,EACX,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CACjC;aACF,CAAC,CAAC;QACL,CAAC;QACD,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACtB,CAAC;CACF"}

package/dist/postinstall/loader/EsbuildTranspiler.d.ts

@@ -0,0 +1,18 @@
+import { type Result } from '@uapkg/diagnostics';
+/**
+ * Transpiles a single `.ts` postinstall entry into an in-memory ESM bundle.
+ *
+ * Constraints:
+ *   * `bundle: false` — we only lower TypeScript to JS; users are expected to
+ *     import shared modules via `node_modules` which the loader's dynamic
+ *     import handles natively.
+ *   * No type-checking. The user's IDE / CI catches type errors; `uapkg` only
+ *     needs a runnable module.
+ *   * `platform: node`, `format: esm`, `target: node20`.
+ *
+ * On failure returns a `POSTINSTALL_ESBUILD_ERROR` diagnostic.
+ */
+export declare class EsbuildTranspiler {
+    transpile(packageName: string, entryFile: string): Promise<Result<string>>;
+}
+//# sourceMappingURL=EsbuildTranspiler.d.ts.map

package/dist/postinstall/loader/EsbuildTranspiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EsbuildTranspiler.d.ts","sourceRoot":"","sources":["../../../src/postinstall/loader/EsbuildTranspiler.ts"],"names":[],"mappings":"AACA,OAAO,EAAqD,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAGpG;;;;;;;;;;;;GAYG;AACH,qBAAa,iBAAiB;IACf,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;CA+CxF"}

package/dist/postinstall/loader/EsbuildTranspiler.js

@@ -0,0 +1,58 @@
+import fs from 'node:fs';
+import { createPostinstallEsbuildErrorDiagnostic, fail, ok } from '@uapkg/diagnostics';
+import { build } from 'esbuild';
+/**
+ * Transpiles a single `.ts` postinstall entry into an in-memory ESM bundle.
+ *
+ * Constraints:
+ *   * `bundle: false` — we only lower TypeScript to JS; users are expected to
+ *     import shared modules via `node_modules` which the loader's dynamic
+ *     import handles natively.
+ *   * No type-checking. The user's IDE / CI catches type errors; `uapkg` only
+ *     needs a runnable module.
+ *   * `platform: node`, `format: esm`, `target: node20`.
+ *
+ * On failure returns a `POSTINSTALL_ESBUILD_ERROR` diagnostic.
+ */
+export class EsbuildTranspiler {
+    async transpile(packageName, entryFile) {
+        let source;
+        try {
+            source = fs.readFileSync(entryFile, 'utf-8');
+        }
+        catch (error) {
+            return fail([
+                createPostinstallEsbuildErrorDiagnostic(packageName, entryFile, error instanceof Error ? error.message : String(error)),
+            ]);
+        }
+        const options = {
+            stdin: {
+                contents: source,
+                loader: 'ts',
+                sourcefile: entryFile,
+                resolveDir: entryFile.replace(/[\\/][^\\/]+$/, ''),
+            },
+            bundle: false,
+            write: false,
+            format: 'esm',
+            platform: 'node',
+            target: 'node20',
+            sourcemap: false,
+            logLevel: 'silent',
+        };
+        try {
+            const result = await build(options);
+            const file = result.outputFiles?.[0];
+            if (!file) {
+                return fail([createPostinstallEsbuildErrorDiagnostic(packageName, entryFile, 'esbuild produced no output')]);
+            }
+            return ok(file.text);
+        }
+        catch (error) {
+            return fail([
+                createPostinstallEsbuildErrorDiagnostic(packageName, entryFile, error instanceof Error ? error.message : String(error)),
+            ]);
+        }
+    }
+}
+//# sourceMappingURL=EsbuildTranspiler.js.map

package/dist/postinstall/loader/EsbuildTranspiler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EsbuildTranspiler.js","sourceRoot":"","sources":["../../../src/postinstall/loader/EsbuildTranspiler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,uCAAuC,EAAE,IAAI,EAAE,EAAE,EAAe,MAAM,oBAAoB,CAAC;AACpG,OAAO,EAAqB,KAAK,EAAE,MAAM,SAAS,CAAC;AAEnD;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,iBAAiB;IACrB,KAAK,CAAC,SAAS,CAAC,WAAmB,EAAE,SAAiB;QAC3D,IAAI,MAAc,CAAC;QACnB,IAAI,CAAC;YACH,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC/C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,CAAC;gBACV,uCAAuC,CACrC,WAAW,EACX,SAAS,EACT,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACvD;aACF,CAAC,CAAC;QACL,CAAC;QAED,MAAM,OAAO,GAAiB;YAC5B,KAAK,EAAE;gBACL,QAAQ,EAAE,MAAM;gBAChB,MAAM,EAAE,IAAI;gBACZ,UAAU,EAAE,SAAS;gBACrB,UAAU,EAAE,SAAS,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC;aACnD;YACD,MAAM,EAAE,KAAK;YACb,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE,KAAK;YACb,QAAQ,EAAE,MAAM;YAChB,MAAM,EAAE,QAAQ;YAChB,SAAS,EAAE,KAAK;YAChB,QAAQ,EAAE,QAAQ;SACnB,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;YACpC,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC;YACrC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,OAAO,IAAI,CAAC,CAAC,uCAAuC,CAAC,WAAW,EAAE,SAAS,EAAE,4BAA4B,CAAC,CAAC,CAAC,CAAC;YAC/G,CAAC;YACD,OAAO,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,CAAC;gBACV,uCAAuC,CACrC,WAAW,EACX,SAAS,EACT,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACvD;aACF,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF"}

package/dist/postinstall/loader/ExportValidator.d.ts

@@ -0,0 +1,15 @@
+import { type Result } from '@uapkg/diagnostics';
+import { type PostinstallDefinition } from '../api/PostinstallDsl.js';
+/**
+ * Normalizes an imported module to its default export (or the module object
+ * itself for CommonJS-style returns) and validates against
+ * {@link PostinstallDefinitionSchema}.
+ *
+ * Emits `POSTINSTALL_INVALID_EXPORT` with flattened Zod issue messages when
+ * the shape is wrong.
+ */
+export declare class ExportValidator {
+    validate(packageName: string, entryFile: string, moduleValue: unknown): Result<PostinstallDefinition>;
+    private unwrap;
+}
+//# sourceMappingURL=ExportValidator.d.ts.map

package/dist/postinstall/loader/ExportValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExportValidator.d.ts","sourceRoot":"","sources":["../../../src/postinstall/loader/ExportValidator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsD,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACrG,OAAO,EAAE,KAAK,qBAAqB,EAA+B,MAAM,0BAA0B,CAAC;AAEnG;;;;;;;GAOG;AACH,qBAAa,eAAe;IACnB,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,GAAG,MAAM,CAAC,qBAAqB,CAAC;IAa5G,OAAO,CAAC,MAAM;CAQf"}

package/dist/postinstall/loader/ExportValidator.js

@@ -0,0 +1,34 @@
+import { createPostinstallInvalidExportDiagnostic, fail, ok } from '@uapkg/diagnostics';
+import { PostinstallDefinitionSchema } from '../api/PostinstallDsl.js';
+/**
+ * Normalizes an imported module to its default export (or the module object
+ * itself for CommonJS-style returns) and validates against
+ * {@link PostinstallDefinitionSchema}.
+ *
+ * Emits `POSTINSTALL_INVALID_EXPORT` with flattened Zod issue messages when
+ * the shape is wrong.
+ */
+export class ExportValidator {
+    validate(packageName, entryFile, moduleValue) {
+        const unwrapped = this.unwrap(moduleValue);
+        const parsed = PostinstallDefinitionSchema.safeParse(unwrapped);
+        if (!parsed.success) {
+            const issues = parsed.error.issues.map((issue) => {
+                const where = issue.path.length > 0 ? ` at ${issue.path.join('.')}` : '';
+                return `${issue.message}${where}`;
+            });
+            return fail([createPostinstallInvalidExportDiagnostic(packageName, entryFile, issues)]);
+        }
+        return ok(parsed.data);
+    }
+    unwrap(moduleValue) {
+        if (moduleValue && typeof moduleValue === 'object') {
+            const record = moduleValue;
+            if ('default' in record)
+                return record.default;
+            return record;
+        }
+        return moduleValue;
+    }
+}
+//# sourceMappingURL=ExportValidator.js.map

package/dist/postinstall/loader/ExportValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExportValidator.js","sourceRoot":"","sources":["../../../src/postinstall/loader/ExportValidator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wCAAwC,EAAE,IAAI,EAAE,EAAE,EAAe,MAAM,oBAAoB,CAAC;AACrG,OAAO,EAA8B,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAEnG;;;;;;;GAOG;AACH,MAAM,OAAO,eAAe;IACnB,QAAQ,CAAC,WAAmB,EAAE,SAAiB,EAAE,WAAoB;QAC1E,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAC3C,MAAM,MAAM,GAAG,2BAA2B,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QAChE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;gBAC/C,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzE,OAAO,GAAG,KAAK,CAAC,OAAO,GAAG,KAAK,EAAE,CAAC;YACpC,CAAC,CAAC,CAAC;YACH,OAAO,IAAI,CAAC,CAAC,wCAAwC,CAAC,WAAW,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;QAC1F,CAAC;QACD,OAAO,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAEO,MAAM,CAAC,WAAoB;QACjC,IAAI,WAAW,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;YACnD,MAAM,MAAM,GAAG,WAAsC,CAAC;YACtD,IAAI,SAAS,IAAI,MAAM;gBAAE,OAAO,MAAM,CAAC,OAAO,CAAC;YAC/C,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,OAAO,WAAW,CAAC;IACrB,CAAC;CACF"}

package/dist/postinstall/loader/ModuleImporter.d.ts

@@ -0,0 +1,29 @@
+import { type Result } from '@uapkg/diagnostics';
+export type ModuleSource = {
+    readonly kind: 'file';
+    readonly path: string;
+}
+/** ESM source already transpiled by {@link EsbuildTranspiler}. */
+ | {
+    readonly kind: 'transpiled';
+    readonly code: string;
+    readonly originalPath: string;
+};
+/**
+ * Imports a postinstall module.
+ *
+ * For `.js`/`.mjs` files we use the file URL directly so relative imports and
+ * `node_modules` resolution work.
+ *
+ * For transpiled `.ts` code we write to a sibling temp file next to the
+ * original entry — data: URLs cannot resolve relative specifiers — and delete
+ * it on best-effort basis after import. The file lives in the OS tmp dir
+ * keyed by a timestamp+pid, avoiding collisions across concurrent installs.
+ */
+export declare class ModuleImporter {
+    import(packageName: string, source: ModuleSource): Promise<Result<unknown>>;
+    private importFileUrl;
+    private createTempFile;
+    private safeUnlink;
+}
+//# sourceMappingURL=ModuleImporter.d.ts.map

package/dist/postinstall/loader/ModuleImporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModuleImporter.d.ts","sourceRoot":"","sources":["../../../src/postinstall/loader/ModuleImporter.ts"],"names":[],"mappings":"AAIA,OAAO,EAAmD,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAElG,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AAClD,kEAAkE;GAChE;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1F;;;;;;;;;;GAUG;AACH,qBAAa,cAAc;IACZ,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAY1E,aAAa;IAkB3B,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,UAAU;CAOnB"}