create-relkit 0.6.0 → 0.7.1

package/dist/generate-process.js

@@ -1,14 +1,27 @@
-import { access } from "node:fs/promises";
+import { observeExecution } from "@relkit/contracts/operation";
+import { Effect } from "effect";
+import { GeneratorFileSystem } from "./generator-filesystem.js";
+import { GeneratorProcess, generatorProcessLayer } from "./generator-process.js";
+import { domainError, domainTry, publicFailure } from "./generator-errors.js";
+import { runGeneratorPromise } from "./generator-runtime.js";
 import { join } from "node:path";
 import { CreateValidationError } from "./validate.js";
 import { GenerateProjectError, } from "./generate-types.js";
+/**
+ * Maps a boundary failure to the public generation error contract.
+ * @param error - Original public or internal failure.
+ * @param fallback - Code used when the original failure has no public code.
+ * @param cleanup - Optional staging path and cleanup outcome.
+ * @returns The preserved or translated failure with optional staging disposition.
+ */
 export function generationError(error, fallback, cleanup) {
+    error = publicFailure(error);
     let failure;
     if (error instanceof GenerateProjectError)
         failure = error;
     else if (error instanceof CreateValidationError)
         failure = new GenerateProjectError(error.code, error.message);
-    else if (error instanceof Error && typeof error.code === "string")
+    else if (error instanceof Error && "code" in error && typeof error.code === "string")
         failure = new GenerateProjectError(error.code, error.message, undefined, errorExitCode(error));
     else
         failure = new GenerateProjectError(fallback, error instanceof Error ? error.message : String(error));
@@ -17,10 +30,21 @@ export function generationError(error, fallback, cleanup) {
     const state = cleanup.removed ? "cleaned" : "retained";
     return new GenerateProjectError(failure.code, `${failure.message} Temporary directory ${state}: ${cleanup.temporaryPath}.`, cleanup.temporaryPath, failure.exitCode);
 }
+/**
+ * Reads a supported exit code from an existing public failure.
+ * @param error - Existing error whose exitCode field may be present.
+ * @returns A supported explicit exit code, or undefined when absent or unsupported.
+ */
 function errorExitCode(error) {
     const value = "exitCode" in error ? error.exitCode : undefined;
     return value === 1 || value === 2 || value === 130 || value === 143 ? value : undefined;
 }
+/**
+ * Runs deterministic failure injection for generation regression tests.
+ * @param context - Caller-owned settings and cancellation.
+ * @param point - Fixed deterministic generation failure-injection point.
+ * @returns Completion when the hook succeeds; injected failures retain the generation error contract.
+ */
 export function injectGenerateFailure(context, point) {
     try {
         context.failAt?.(point);
@@ -31,50 +55,90 @@ export function injectGenerateFailure(context, point) {
         throw new GenerateProjectError(`RELKIT_CREATE_${point.toUpperCase()}_FAILED`, error instanceof Error ? error.message : `Injected ${point} failure.`);
     }
 }
-export async function runProjectStep(context, command, cwd, step, point) {
-    throwIfAborted(context.signal);
-    injectGenerateFailure(context, point);
-    const result = await (context.commandRunner ?? runProjectCommand)(command, cwd, context.signal);
-    throwIfAborted(context.signal);
+/**
+ * Executes one generation step through scoped process authority.
+ * @param context - Existing progress, failure injection and executable settings.
+ * @param command - Literal command vector.
+ * @param cwd - Staged project directory.
+ * @param step - Fixed operation label used by the public failure code.
+ * @param point - Fixed deterministic generation failure-injection point.
+ * @returns Completion only after process output and exit have settled.
+ */
+export const runProjectStepEffect = Effect.fn("ProjectGeneration.step")(function* (context, command, cwd, step, point) {
+    yield* domainTry(() => {
+        throwIfAborted(context.signal);
+        injectGenerateFailure(context, point);
+    });
+    const result = yield* (yield* GeneratorProcess).run(command, cwd);
+    yield* domainTry(() => throwIfAborted(context.signal));
     if (result.exitCode !== 0) {
         const output = result.stderr?.trim() || result.stdout?.trim();
-        throw new GenerateProjectError(`RELKIT_CREATE_${step.toUpperCase()}_FAILED`, `${step} failed with exit code ${result.exitCode}.${output ? `\n${output}` : ""}`);
+        return yield* Effect.fail(domainError(new GenerateProjectError(`RELKIT_CREATE_${step.toUpperCase()}_FAILED`, `${step} failed with exit code ${result.exitCode}.${output ? `\n${output}` : ""}`)));
     }
+}, (effect) => observeExecution("generator", "generation.step", effect));
+/**
+ * Preserves generation step's public Promise adapter.
+ * @param context - Caller-owned settings and cancellation.
+ * @param command - Literal executable and argument vector.
+ * @param cwd - Working directory for the operation.
+ * @param step - Fixed generated-project verification step.
+ * @param point - Fixed deterministic generation failure-injection point.
+ * @returns Completion after the existing contract has been applied.
+ */
+export function runProjectStep(context, command, cwd, step, point) {
+    const program = runProjectStepEffect(context, command, cwd, step, point);
+    return runGeneratorPromise(context.commandRunner === undefined
+        ? program
+        : program.pipe(Effect.provide(generatorProcessLayer(context.commandRunner))), context.signal);
 }
+/**
+ * Throws the caller's existing cancellation reason before any new work is started.
+ * @param signal - Optional caller cancellation signal.
+ * @returns Completion after the existing contract has been applied.
+ */
 export function throwIfAborted(signal) {
     if (signal?.aborted)
         throw (signal.reason ?? new GenerateProjectError("RELKIT_INTERRUPTED", "Generation was interrupted."));
 }
-export async function resolveRelkitExecutable(context, root) {
+/**
+ * Resolves the supported CLI using filesystem and process authority without importing it.
+ * @param context - Caller-owned settings and cancellation.
+ * @param root - Absolute project or owned resource root.
+ * @returns The explicit, local or globally available relkit executable for project checks.
+ */
+export const resolveRelkitExecutableEffect = Effect.fn("ProjectGeneration.resolveCli")(function* (context, root) {
     if (context.relkitExecutable !== undefined)
         return context.relkitExecutable;
     if (context.commandRunner !== undefined)
         return "relkit";
-    for (const candidate of [join(root, "node_modules/.bin/relkit"), Bun.which("relkit")]) {
-        if (candidate === null || candidate === undefined)
+    const fs = yield* GeneratorFileSystem;
+    const global = yield* (yield* GeneratorProcess).which("relkit");
+    for (const candidate of [join(root, "node_modules/.bin/relkit"), global]) {
+        if (candidate === null)
             continue;
-        try {
-            await access(candidate);
+        const available = yield* fs.access(candidate).pipe(Effect.as(true), Effect.catch(() => Effect.succeed(false)));
+        if (available)
             return candidate;
-        }
-        catch { }
     }
-    throw new GenerateProjectError("RELKIT_CREATE_CLI_UNAVAILABLE", "The relkit CLI is not available for project checks.");
+    return yield* Effect.fail(domainError(new GenerateProjectError("RELKIT_CREATE_CLI_UNAVAILABLE", "The relkit CLI is not available for project checks.")));
+}, (effect) => observeExecution("generator", "generation.resolveCli", effect));
+/**
+ * Preserves the CLI executable Promise API.
+ * @param context - Caller-owned settings and cancellation.
+ * @param root - Absolute project or owned resource root.
+ * @returns The resolved CLI executable path after validating the supplied or available binary.
+ */
+export function resolveRelkitExecutable(context, root) {
+    return runGeneratorPromise(resolveRelkitExecutableEffect(context, root));
 }
-export async function runProjectCommand(command, cwd, signal) {
-    const child = Bun.spawn([...command], { cwd, stdout: "pipe", stderr: "pipe" });
-    const abort = () => child.kill();
-    signal?.addEventListener("abort", abort, { once: true });
-    try {
-        const [stdout, stderr, exitCode] = await Promise.all([
-            new Response(child.stdout).text(),
-            new Response(child.stderr).text(),
-            child.exited,
-        ]);
-        return { exitCode, stdout, stderr };
-    }
-    finally {
-        signal?.removeEventListener("abort", abort);
-    }
+/**
+ * Runs a native child at the compatibility edge, with interruption owned by its resource scope.
+ * @param command - Executable and literal arguments.
+ * @param cwd - Working directory.
+ * @param signal - Optional caller cancellation.
+ * @returns Output and exit status after the child has been awaited.
+ */
+export function runProjectCommand(command, cwd, signal) {
+    return runGeneratorPromise(GeneratorProcess.use((process) => process.run(command, cwd)), signal);
 }
 //# sourceMappingURL=generate-process.js.map

package/dist/generate-process.js.map

@@ -1 +1 @@
-{"version":3,"file":"generate-process.js","sourceRoot":"","sources":["../src/generate-process.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EACL,oBAAoB,GAIrB,MAAM,qBAAqB,CAAC;AAG7B,MAAM,UAAU,eAAe,CAC7B,KAAc,EACd,QAAgB,EAChB,OAA4B;IAE5B,IAAI,OAA6B,CAAC;IAClC,IAAI,KAAK,YAAY,oBAAoB;QAAE,OAAO,GAAG,KAAK,CAAC;SACtD,IAAI,KAAK,YAAY,qBAAqB;QAC7C,OAAO,GAAG,IAAI,oBAAoB,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;SAC3D,IAAI,KAAK,YAAY,KAAK,IAAI,OAAQ,KAA4B,CAAC,IAAI,KAAK,QAAQ;QACvF,OAAO,GAAG,IAAI,oBAAoB,CAC/B,KAA8C,CAAC,IAAI,EACpD,KAAK,CAAC,OAAO,EACb,SAAS,EACT,aAAa,CAAC,KAAK,CAAC,CACrB,CAAC;;QAEF,OAAO,GAAG,IAAI,oBAAoB,CAChC,QAAQ,EACR,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACvD,CAAC;IAEJ,IAAI,OAAO,EAAE,aAAa,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC;IACzD,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;IACvD,OAAO,IAAI,oBAAoB,CAC7B,OAAO,CAAC,IAAI,EACZ,GAAG,OAAO,CAAC,OAAO,wBAAwB,KAAK,KAAK,OAAO,CAAC,aAAa,GAAG,EAC5E,OAAO,CAAC,aAAa,EACrB,OAAO,CAAC,QAAQ,CACjB,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,KAAY;IACjC,MAAM,KAAK,GAAG,UAAU,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/D,OAAO,KAAK,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1F,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,OAA+B,EAC/B,KAA2B;IAE3B,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,oBAAoB;YAAE,MAAM,KAAK,CAAC;QACvD,MAAM,IAAI,oBAAoB,CAC5B,iBAAiB,KAAK,CAAC,WAAW,EAAE,SAAS,EAC7C,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,KAAK,WAAW,CACtE,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAA+B,EAC/B,OAA0B,EAC1B,GAAW,EACX,IAAY,EACZ,KAA2B;IAE3B,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/B,qBAAqB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,aAAa,IAAI,iBAAiB,CAAC,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAChG,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/B,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;QAC9D,MAAM,IAAI,oBAAoB,CAC5B,iBAAiB,IAAI,CAAC,WAAW,EAAE,SAAS,EAC5C,GAAG,IAAI,0BAA0B,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAClF,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAA+B;IAC5D,IAAI,MAAM,EAAE,OAAO;QACjB,MAAM,CACJ,MAAM,CAAC,MAAM,IAAI,IAAI,oBAAoB,CAAC,oBAAoB,EAAE,6BAA6B,CAAC,CAC/F,CAAC;AACN,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,OAA+B,EAC/B,IAAY;IAEZ,IAAI,OAAO,CAAC,gBAAgB,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC,gBAAgB,CAAC;IAC5E,IAAI,OAAO,CAAC,aAAa,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IACzD,KAAK,MAAM,SAAS,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,0BAA0B,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QACtF,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,KAAK,SAAS;YAAE,SAAS;QAC5D,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;YACxB,OAAO,SAAS,CAAC;QACnB,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IACZ,CAAC;IACD,MAAM,IAAI,oBAAoB,CAC5B,+BAA+B,EAC/B,qDAAqD,CACtD,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAA0B,EAC1B,GAAW,EACX,MAAoB;IAEpB,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,OAAO,CAAC,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/E,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IACjC,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,IAAI,CAAC;QACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACnD,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE;YACjC,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE;YACjC,KAAK,CAAC,MAAM;SACb,CAAC,CAAC;QACH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IACtC,CAAC;YAAS,CAAC;QACT,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC9C,CAAC;AACH,CAAC"}
+{"version":3,"file":"generate-process.js","sourceRoot":"","sources":["../src/generate-process.ts"],"names":[],"mappings":"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"}

package/dist/generate-stage-cleanup.d.ts

@@ -0,0 +1,17 @@
+import { Effect, Exit } from "effect";
+import type { StageCleanupResult } from "./generate-files-utilities.types.js";
+/**
+ * Records an owned stage's disposition alongside the unchanged authoritative failure.
+ * @param exit - Authoritative scoped exit whose primary cause must be preserved.
+ * @param cleanup - Recorded staging path and cleanup disposition.
+ * @param ownerOverride - Optional public owner used to retain interruption cleanup evidence.
+ * @returns Completion after the existing contract has been applied.
+ */
+export declare function recordStageCleanup(exit: Exit.Exit<unknown, unknown>, cleanup: StageCleanupResult, ownerOverride?: unknown): Effect.Effect<void>;
+/**
+ * Retrieves staging cleanup details used by the existing public generation error formatter.
+ * @param value - Public failure or cancellation owner.
+ * @returns Recorded staging cleanup outcome, or undefined when no outcome was retained.
+ */
+export declare function stageCleanupFor(value: unknown): StageCleanupResult | undefined;
+//# sourceMappingURL=generate-stage-cleanup.d.ts.map

package/dist/generate-stage-cleanup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-stage-cleanup.d.ts","sourceRoot":"","sources":["../src/generate-stage-cleanup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAG7C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAI9E;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,EACjC,OAAO,EAAE,kBAAkB,EAC3B,aAAa,CAAC,EAAE,OAAO,GACtB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CASrB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,GAAG,SAAS,CAG9E"}

package/dist/generate-stage-cleanup.js

@@ -0,0 +1,30 @@
+import { Cause, Effect, Exit } from "effect";
+import { publicFailure } from "./generator-errors.js";
+import { generatorCleanupFailures, recordCleanupFailure } from "./generator-cleanup.js";
+const stages = new WeakMap();
+/**
+ * Records an owned stage's disposition alongside the unchanged authoritative failure.
+ * @param exit - Authoritative scoped exit whose primary cause must be preserved.
+ * @param cleanup - Recorded staging path and cleanup disposition.
+ * @param ownerOverride - Optional public owner used to retain interruption cleanup evidence.
+ * @returns Completion after the existing contract has been applied.
+ */
+export function recordStageCleanup(exit, cleanup, ownerOverride) {
+    return Effect.gen(function* () {
+        const owner = publicFailure(ownerOverride ?? (Exit.isFailure(exit) ? Cause.squash(exit.cause) : exit.value));
+        if (typeof owner === "object" && owner !== null)
+            stages.set(owner, cleanup);
+        for (const failure of generatorCleanupFailures(cleanup))
+            yield* recordCleanupFailure(exit, "stage", failure.cause, ownerOverride);
+    });
+}
+/**
+ * Retrieves staging cleanup details used by the existing public generation error formatter.
+ * @param value - Public failure or cancellation owner.
+ * @returns Recorded staging cleanup outcome, or undefined when no outcome was retained.
+ */
+export function stageCleanupFor(value) {
+    const owner = publicFailure(value);
+    return typeof owner === "object" && owner !== null ? stages.get(owner) : undefined;
+}
+//# sourceMappingURL=generate-stage-cleanup.js.map

package/dist/generate-stage-cleanup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-stage-cleanup.js","sourceRoot":"","sources":["../src/generate-stage-cleanup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAGxF,MAAM,MAAM,GAAG,IAAI,OAAO,EAA8B,CAAC;AAEzD;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAiC,EACjC,OAA2B,EAC3B,aAAuB;IAEvB,OAAO,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QACzB,MAAM,KAAK,GAAG,aAAa,CACzB,aAAa,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAChF,CAAC;QACF,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;YAAE,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC5E,KAAK,MAAM,OAAO,IAAI,wBAAwB,CAAC,OAAO,CAAC;YACrD,KAAK,CAAC,CAAC,oBAAoB,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IACnC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACrF,CAAC"}

package/dist/generate-types.d.ts

@@ -2,13 +2,25 @@ import type { AddResult, ScaffoldWarning } from "./add-types.js";
 import type { CreateOptions } from "./options.js";
 import type { PromptDriver } from "./prompt-driver.js";
 import type { GenerateNextSteps } from "./generate-output.js";
+/**
+ * Native process exit status and captured standard output/error.
+ */
 export interface GenerateCommandResult {
     readonly exitCode: number;
     readonly stdout?: string;
     readonly stderr?: string;
 }
+/**
+ * Existing Promise process adapter receiving literal arguments, cwd and optional cancellation.
+ */
 export type GenerateCommandRunner = (command: readonly string[], cwd: string, signal?: AbortSignal) => Promise<GenerateCommandResult>;
+/**
+ * Named generation stages available for deterministic failure injection.
+ */
 export type GenerateFailurePoint = "copy" | "substitute" | "install" | "git" | "doctor" | "check" | "rename";
+/**
+ * Caller-owned templates, process/prompt adapters, cancellation and progress settings.
+ */
 export interface GenerateProjectContext {
     readonly cwd?: string;
     readonly templateRoot?: string;
@@ -17,11 +29,24 @@ export interface GenerateProjectContext {
     readonly gitExecutable?: string;
     readonly relkitExecutable?: string;
     readonly signal?: AbortSignal;
+    /**
+     * Reports the current step through the caller's progress sink.
+     * @param message - User-facing progress text for the current step.
+     * @returns Completion after the sink receives one progress message.
+     */
     readonly onProgress?: (message: string) => void;
+    /**
+     * Injects a failure at a named stage for deterministic generation tests.
+     * @param point - Fixed deterministic generation failure-injection point.
+     * @returns Completion after the hook runs; a thrown failure aborts that stage.
+     */
     readonly failAt?: (point: GenerateFailurePoint) => void;
     readonly interactive?: boolean;
     readonly promptDriver?: PromptDriver;
 }
+/**
+ * Published project's options, destination, files, warnings and local next steps.
+ */
 export interface GenerateProjectResult {
     readonly ok: true;
     readonly command: "create";
@@ -37,10 +62,21 @@ export interface GenerateProjectResult {
     readonly warnings: readonly ScaffoldWarning[];
     readonly nextSteps: GenerateNextSteps;
 }
+/**
+ * Public generation failure carrying its diagnostic code, exit status and optional staging path.
+ */
 export declare class GenerateProjectError extends Error {
     readonly code: string;
     readonly exitCode: 1 | 2 | 130 | 143;
     readonly temporaryPath: string | undefined;
+    /**
+     * Creates a public generation failure retaining its temporary-path details.
+     * @param code - Stable generation or validation diagnostic code.
+     * @param message - User-facing diagnostic or prompt text.
+     * @param temporaryPath - Staging directory retained in diagnostic output, when present.
+     * @param exitCode - Supported process exit code, defaulting from the public code.
+     * @returns The canonical public error instance.
+     */
     constructor(code: string, message: string, temporaryPath?: string, exitCode?: 1 | 2 | 130 | 143);
 }
 //# sourceMappingURL=generate-types.d.ts.map

package/dist/generate-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate-types.d.ts","sourceRoot":"","sources":["../src/generate-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,qBAAqB,GAAG,CAClC,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,WAAW,KACjB,OAAO,CAAC,qBAAqB,CAAC,CAAC;AAEpC,MAAM,MAAM,oBAAoB,GAC9B,MAAM,GAAG,YAAY,GAAG,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE5E,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,CAAC,EAAE,qBAAqB,CAAC;IAC/C,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,CAAC;IACxD,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;CACtC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IAC7C,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IACzC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,SAAS,SAAS,EAAE,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAC;IAC9C,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;CACvC;AAED,qBAAa,oBAAqB,SAAQ,KAAK;IAK3C,QAAQ,CAAC,IAAI,EAAE,MAAM;IAJvB,QAAQ,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC;IACrC,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;gBAGhC,IAAI,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,EACf,aAAa,CAAC,EAAE,MAAM,EACtB,QAAQ,GAAE,CAAC,GAAG,CAAC,GAAG,GAAG,GAAG,GAA2B;CAOtD"}
+{"version":3,"file":"generate-types.d.ts","sourceRoot":"","sources":["../src/generate-types.ts"],"names":[],"mappings":"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"}

package/dist/generate-types.js

@@ -1,7 +1,18 @@
+/**
+ * Public generation failure carrying its diagnostic code, exit status and optional staging path.
+ */
 export class GenerateProjectError extends Error {
     code;
     exitCode;
     temporaryPath;
+    /**
+     * Creates a public generation failure retaining its temporary-path details.
+     * @param code - Stable generation or validation diagnostic code.
+     * @param message - User-facing diagnostic or prompt text.
+     * @param temporaryPath - Staging directory retained in diagnostic output, when present.
+     * @param exitCode - Supported process exit code, defaulting from the public code.
+     * @returns The canonical public error instance.
+     */
     constructor(code, message, temporaryPath, exitCode = defaultExitCode(code)) {
         super(message);
         this.code = code;
@@ -10,6 +21,11 @@ export class GenerateProjectError extends Error {
         this.name = "GenerateProjectError";
     }
 }
+/**
+ * Maps usage and cancellation codes to their stable exit statuses.
+ * @param code - Public diagnostic code.
+ * @returns 2 for usage, 130 for cancellation/interruption, otherwise 1.
+ */
 function defaultExitCode(code) {
     if (code.endsWith("_USAGE"))
         return 2;

package/dist/generate-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"generate-types.js","sourceRoot":"","sources":["../src/generate-types.ts"],"names":[],"mappings":"AAkDA,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAKlC;IAJF,QAAQ,CAAoB;IAC5B,aAAa,CAAqB;IAE3C,YACW,IAAY,EACrB,OAAe,EACf,aAAsB,EACtB,WAA8B,eAAe,CAAC,IAAI,CAAC;QAEnD,KAAK,CAAC,OAAO,CAAC,CAAC;QALN,SAAI,GAAJ,IAAI,CAAQ;QAMrB,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED,SAAS,eAAe,CAAC,IAAY;IACnC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,CAAC,CAAC;IACtC,IAAI,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,IAAI,KAAK,oBAAoB;QAAE,OAAO,GAAG,CAAC;IAC7E,OAAO,CAAC,CAAC;AACX,CAAC"}
+{"version":3,"file":"generate-types.js","sourceRoot":"","sources":["../src/generate-types.ts"],"names":[],"mappings":"AA2EA;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAalC;IAZF,QAAQ,CAAoB;IAC5B,aAAa,CAAqB;IAE3C;;;;;;;OAOG;IACH,YACW,IAAY,EACrB,OAAe,EACf,aAAsB,EACtB,WAA8B,eAAe,CAAC,IAAI,CAAC;QAEnD,KAAK,CAAC,OAAO,CAAC,CAAC;QALN,SAAI,GAAJ,IAAI,CAAQ;QAMrB,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED;;;;GAIG;AACH,SAAS,eAAe,CAAC,IAAY;IACnC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,CAAC,CAAC;IACtC,IAAI,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,IAAI,KAAK,oBAAoB;QAAE,OAAO,GAAG,CAAC;IAC7E,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/generate-workflow.d.ts

@@ -0,0 +1,31 @@
+import { Effect } from "effect";
+import type { CreateOptions } from "./options.js";
+import { type GenerateProjectContext } from "./generate-types.js";
+import { GeneratorFileSystem } from "./generator-filesystem.js";
+import { GeneratorProcess } from "./generator-process.js";
+import { GeneratorPrompt } from "./generator-prompt.js";
+/**
+ * Validates, prepares, verifies and publishes while a Scope owns the disposable stage.
+ * @param options - Explicit options retaining existing defaults.
+ * @param context - Caller-owned settings and cancellation.
+ * @returns The published project's immutable result after native child settlement and staging cleanup.
+ */
+export declare const generateEffect: (options: CreateOptions, context: GenerateProjectContext) => Effect.Effect<Readonly<{
+    ok: true;
+    command: "create";
+    name: string;
+    template: "agent" | "minimal" | "api" | "fullstack";
+    cloud: "aws" | "none";
+    deploy: "none" | "pulumi";
+    destination: string;
+    files: readonly string[];
+    installed: boolean;
+    gitInitialized: boolean;
+    additions: readonly never[];
+    warnings: readonly {
+        code: string;
+        message: string;
+    }[];
+    nextSteps: import("./generate-output.types.js").GenerateNextSteps;
+}>, import("./generator-errors.js").GeneratorIoError | import("./generator-errors.js").GeneratorProcessError | import("./generator-errors.js").GeneratorPromptError | import("./generator-errors.js").GeneratorDomainError, GeneratorFileSystem | GeneratorProcess | import("./generator-paths.js").GeneratorPaths | GeneratorPrompt>;
+//# sourceMappingURL=generate-workflow.d.ts.map

package/dist/generate-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-workflow.d.ts","sourceRoot":"","sources":["../src/generate-workflow.ts"],"names":[],"mappings":"AACA,OAAO,EAAS,MAAM,EAAa,MAAM,QAAQ,CAAC;AAElD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAmBlD,OAAO,EAAwB,KAAK,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AACxF,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAMxD;;;;;GAKG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;qUA0J1B,CAAC"}

package/dist/generate-workflow.js

@@ -0,0 +1,117 @@
+import { basename, dirname, join } from "node:path";
+import { Cause, Effect, Exit, Ref } from "effect";
+import { observeExecution } from "@relkit/contracts/operation";
+import { validateCreateOptionsEffect } from "./validate.js";
+import { injectGenerateFailure, resolveRelkitExecutableEffect, runProjectStepEffect, throwIfAborted, } from "./generate-process.js";
+import { copyTemplateEffect, cleanupStagedProjectEffect, customizeProjectEffect, listProjectFilesEffect, requireFilesEffect, requireTemplateEffect, } from "./generate-files.js";
+import { createGenerateNextSteps } from "./generate-output.js";
+import { prepareProjectDependencyPatchEffect } from "./dependency-patches.js";
+import { resolveTemplateRootEffect } from "./template-root.js";
+import { GenerateProjectError } from "./generate-types.js";
+import { GeneratorFileSystem } from "./generator-filesystem.js";
+import { GeneratorProcess } from "./generator-process.js";
+import { GeneratorPrompt } from "./generator-prompt.js";
+import { domainError, domainTry } from "./generator-errors.js";
+import { recordCleanupFailure } from "./generator-cleanup.js";
+import { recordStageCleanup } from "./generate-stage-cleanup.js";
+/**
+ * Validates, prepares, verifies and publishes while a Scope owns the disposable stage.
+ * @param options - Explicit options retaining existing defaults.
+ * @param context - Caller-owned settings and cancellation.
+ * @returns The published project's immutable result after native child settlement and staging cleanup.
+ */
+export const generateEffect = Effect.fn("ProjectGeneration.execute")((options, context) => Effect.scoped(Effect.gen(function* () {
+    const validated = yield* validateCreateOptionsEffect(options, context.cwd === undefined ? {} : { cwd: context.cwd });
+    if (context.interactive === true &&
+        !(yield* (yield* GeneratorPrompt).confirm({
+            message: "Create this project?",
+            initialValue: true,
+        })))
+        return yield* Effect.fail(domainError(new GenerateProjectError("RELKIT_CREATE_CANCELLED", "Scaffolding was cancelled.")));
+    context.onProgress?.(`Creating a new RELKIT app in ${validated.destination}.`);
+    const fs = yield* GeneratorFileSystem;
+    const templateRoot = yield* resolveTemplateRootEffect(context);
+    const template = join(templateRoot, options.jobs === undefined ? options.template : "tasks");
+    yield* requireTemplateEffect(template);
+    const owned = yield* Effect.acquireRelease(Effect.gen(function* () {
+        yield* fs.mkdir(dirname(validated.destination), { recursive: true, mode: 0o755 });
+        const stage = yield* fs.temporaryDirectory(join(dirname(validated.destination), `.${basename(validated.destination)}-relkit-`));
+        return { stage, published: yield* Ref.make(false) };
+    }), (owned, exit) => Effect.gen(function* () {
+        if (yield* Ref.get(owned.published))
+            return;
+        const cleanup = yield* cleanupStagedProjectEffect(owned.stage, validated.destination).pipe(Effect.catchCause((cause) => Effect.gen(function* () {
+            const retained = { temporaryPath: owned.stage, removed: false };
+            yield* recordCleanupFailure(Exit.succeed(retained), "stage", Cause.squash(cause));
+            return retained;
+        })));
+        yield* recordStageCleanup(exit, cleanup, context.signal?.aborted ? context.signal : undefined);
+    }));
+    yield* domainTry(() => injectGenerateFailure(context, "copy"));
+    yield* copyTemplateEffect(template, owned.stage);
+    yield* domainTry(() => injectGenerateFailure(context, "substitute"));
+    yield* customizeProjectEffect(owned.stage, options);
+    yield* requireFilesEffect(owned.stage, [
+        "package.json",
+        "relkit.config.ts",
+        "src/platform/env.ts",
+        ".env.example",
+        ".gitignore",
+    ]);
+    yield* prepareProjectDependencyPatchEffect(owned.stage);
+    if (options.install) {
+        context.onProgress?.("Installing dependencies...");
+        yield* runProjectStepEffect(context, [context.bunExecutable ?? globalThis.process.execPath, "install"], owned.stage, "install", "install");
+    }
+    const git = context.gitExecutable ??
+        (context.commandRunner ? "git" : yield* (yield* GeneratorProcess).which("git"));
+    const gitInitialized = options.git && git !== null;
+    if (gitInitialized) {
+        context.onProgress?.("Initializing Git repository...");
+        yield* runProjectStepEffect(context, [git, "init"], owned.stage, "git", "git");
+    }
+    if (options.install) {
+        const relkit = yield* resolveRelkitExecutableEffect(context, owned.stage);
+        context.onProgress?.("Checking generated project...");
+        yield* runProjectStepEffect(context, [
+            relkit,
+            "doctor",
+            "--project-root",
+            owned.stage,
+            "--no-ports",
+            ...(options.cloud === "none" || options.deploy === "none" ? ["--no-pulumi"] : []),
+        ], owned.stage, "doctor", "doctor");
+        yield* runProjectStepEffect(context, [relkit, "check", "--project-root", owned.stage], owned.stage, "check", "check");
+    }
+    yield* domainTry(() => {
+        throwIfAborted(context.signal);
+        injectGenerateFailure(context, "rename");
+    });
+    // Native rename and publication bookkeeping settle as one atomic ownership handoff.
+    yield* Effect.uninterruptible(fs
+        .rename(owned.stage, validated.destination)
+        .pipe(Effect.tap(() => Ref.set(owned.published, true))));
+    return Object.freeze({
+        ok: true,
+        command: "create",
+        name: options.name,
+        template: options.template,
+        cloud: options.cloud,
+        deploy: options.deploy,
+        destination: validated.destination,
+        files: Object.freeze(yield* listProjectFilesEffect(validated.destination)),
+        installed: options.install,
+        gitInitialized,
+        additions: Object.freeze([]),
+        warnings: Object.freeze(!options.install
+            ? [
+                {
+                    code: "validation-skipped",
+                    message: "Install dependencies, then run bun run check.",
+                },
+            ]
+            : []),
+        nextSteps: createGenerateNextSteps(options, validated.destination, context.cwd),
+    });
+})), (effect) => observeExecution("generator", "generation.execute", effect));
+//# sourceMappingURL=generate-workflow.js.map

package/dist/generate-workflow.js.map

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

package/dist/generate.d.ts

@@ -1,5 +1,33 @@
+import { Context, Effect, Layer } from "effect";
 import type { CreateOptions } from "./options.js";
 import { type GenerateProjectContext, type GenerateProjectResult } from "./generate-types.js";
-/** Copies, validates, checks, and atomically publishes one generated project. */
+import { GeneratorFileSystem } from "./generator-filesystem.js";
+import { GeneratorProcess } from "./generator-process.js";
+import { GeneratorPaths } from "./generator-paths.js";
+import { GeneratorPrompt } from "./generator-prompt.js";
+import type { ProjectGenerationService } from "./generate.service.types.js";
+declare const ProjectGeneration_base: Context.ServiceClass<ProjectGeneration, "create-relkit/ProjectGeneration", ProjectGenerationService>;
+/** Owns one complete creation workflow, including consent and atomic publication. */
+export declare class ProjectGeneration extends ProjectGeneration_base {
+}
+/**
+ * Generation captures explicit filesystem, path, process and prompt authority at acquisition.
+ * @returns A ProjectGeneration Layer requiring filesystem, paths, process and prompt services.
+ */
+export declare const projectGenerationLive: Layer.Layer<ProjectGeneration, never, GeneratorFileSystem | GeneratorProcess | GeneratorPaths | GeneratorPrompt>;
+/**
+ * Generates a project through explicitly acquired creation authority.
+ * @param options - Normalized creation flags.
+ * @param context - Existing template, progress and executable settings.
+ * @returns A lazy scoped workflow that settles owned resources before its result.
+ */
+export declare const generateProjectEffect: (options: CreateOptions, context?: GenerateProjectContext | undefined) => Effect.Effect<GenerateProjectResult, import("./generator-errors.js").GeneratorIoError | import("./generator-errors.js").GeneratorProcessError | import("./generator-errors.js").GeneratorPromptError | import("./generator-errors.js").GeneratorDomainError, ProjectGeneration>;
+/**
+ * Preserves the public Promise API, flags, errors and generated result shape.
+ * @param options - Normalized creation flags.
+ * @param context - Existing runner, prompt and cancellation settings.
+ * @returns The generated result after atomic publication and scoped cleanup.
+ */
 export declare function generateProject(options: CreateOptions, context?: GenerateProjectContext): Promise<GenerateProjectResult>;
+export {};
 //# sourceMappingURL=generate.d.ts.map

package/dist/generate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAoBlD,OAAO,EAAE,KAAK,sBAAsB,EAAE,KAAK,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAI9F,iFAAiF;AACjF,wBAAsB,eAAe,CACnC,OAAO,EAAE,aAAa,EACtB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,qBAAqB,CAAC,CAyHhC"}
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAIhD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAIlD,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC3B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEhE,OAAO,EAAE,gBAAgB,EAAyB,MAAM,wBAAwB,CAAC;AAEjF,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EAAE,eAAe,EAAwB,MAAM,uBAAuB,CAAC;AAU9E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;;AAE5E,qFAAqF;AACrF,qBAAa,iBAAkB,SAAQ,sBAGD;CAAG;AAEzC;;;GAGG;AACH,eAAO,MAAM,qBAAqB,kHAuBjC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,2VAKjC,CAAC;AAEF;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,aAAa,EACtB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,qBAAqB,CAAC,CAuBhC"}