create-relkit 0.6.0 → 0.7.0

package/dist/add-types.d.ts

@@ -1,18 +1,44 @@
+/**
+ * Supported artifact kinds accepted by relkit add.
+ */
 export declare const ADD_KINDS: readonly ["service", "function", "error", "event", "event-function", "task", "job", "cache", "bucket", "tool", "prompt", "agent", "constants", "route", "middleware", "transform", "database", "auth"];
+/**
+ * Supported relkit add artifact discriminant.
+ */
 export type AddKind = (typeof ADD_KINDS)[number];
+/**
+ * Artifact kinds that can be included in a generic service scaffold.
+ */
 export type ServiceInclude = Exclude<AddKind, "service" | "database" | "auth" | "middleware" | "transform">;
+/**
+ * Supported HTTP method used by generated route mappings.
+ */
 export type RouteMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
+/**
+ * Supported database dialect for Drizzle and authentication scaffolds.
+ */
 export type DatabaseDialect = "sqlite" | "postgresql" | "mysql";
+/**
+ * Project, installation and optional service selection shared by all add requests.
+ */
 export interface AddRequestBase {
     readonly projectRoot: string;
     readonly service?: string;
     readonly createService?: string;
     readonly install: boolean;
 }
+/**
+ * Shared named-artifact fields combined with kind-specific options.
+ * @typeParam Kind - Discriminant identifying the artifact kind.
+ * @typeParam Options - Additional fields required by that artifact kind.
+ */
 type NamedRequest<Kind extends AddKind, Options = object> = AddRequestBase & Readonly<{
     kind: Kind;
     name: string;
 }> & Readonly<Options>;
+/**
+ * Validated discriminated union of supported artifact scaffold requests.
+ */
 export type AddRequest = NamedRequest<"service", {
     full: boolean;
     include: readonly ServiceInclude[];
@@ -69,16 +95,25 @@ export type AddRequest = NamedRequest<"service", {
     readonly databaseDialect: DatabaseDialect;
     readonly basePath: string;
 });
+/**
+ * Stable warning category and user-facing message retained in plans and results.
+ */
 export interface ScaffoldWarning {
     readonly code: string;
     readonly message: string;
 }
+/**
+ * One ordered project-relative create/update operation with complete content and optional mode.
+ */
 export interface ScaffoldFileOperation {
     readonly path: string;
     readonly action: "create" | "update";
     readonly content: string;
     readonly mode?: number;
 }
+/**
+ * Complete conflict-checked request, ordered writes, concrete dependencies and follow-up details.
+ */
 export interface ScaffoldPlan {
     readonly request: AddRequest;
     readonly projectRoot: string;
@@ -97,6 +132,9 @@ export interface ScaffoldPlan {
     readonly warnings: readonly ScaffoldWarning[];
     readonly nextSteps: readonly string[];
 }
+/**
+ * Public result of the requested post-mutation project check.
+ */
 export type ScaffoldVerification = {
     readonly status: "passed";
     readonly command: string;
@@ -105,6 +143,9 @@ export type ScaffoldVerification = {
     readonly reason: string;
     readonly command: string;
 };
+/**
+ * Completed add transaction's files, packages, warnings, verification and next steps.
+ */
 export interface AddResult {
     readonly ok: true;
     readonly command: "add";
@@ -117,6 +158,9 @@ export interface AddResult {
     readonly verification: ScaffoldVerification;
     readonly nextSteps: readonly string[];
 }
+/**
+ * Stable public diagnostic codes for scaffold failure categories.
+ */
 export declare const ADD_FAILURE_CODES: Readonly<{
     readonly usage: "RELKIT_ADD_USAGE";
     readonly invalidProject: "RELKIT_ADD_INVALID_PROJECT";
@@ -126,10 +170,22 @@ export declare const ADD_FAILURE_CODES: Readonly<{
     readonly validation: "RELKIT_ADD_VALIDATION_FAILED";
     readonly cancellation: "RELKIT_ADD_CANCELLED";
 }>;
+/**
+ * Stable public diagnostic category of AddScaffoldError.
+ */
 export type AddFailureCode = (typeof ADD_FAILURE_CODES)[keyof typeof ADD_FAILURE_CODES];
+/**
+ * Public scaffold failure retaining its stable code, name and category-specific exit status.
+ */
 export declare class AddScaffoldError extends Error {
     readonly code: AddFailureCode;
     readonly exitCode: 1 | 2 | 130;
+    /**
+     * Creates a canonical add failure with its category-specific exit code.
+     * @param code - Stable add failure category.
+     * @param message - User-facing failure diagnostic.
+     * @returns The canonical public error instance.
+     */
     constructor(code: AddFailureCode, message: string);
 }
 export {};

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

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

package/dist/add-types.js

@@ -1,3 +1,6 @@
+/**
+ * Supported artifact kinds accepted by relkit add.
+ */
 export const ADD_KINDS = [
     "service",
     "function",
@@ -18,6 +21,9 @@ export const ADD_KINDS = [
     "database",
     "auth",
 ];
+/**
+ * Stable public diagnostic codes for scaffold failure categories.
+ */
 export const ADD_FAILURE_CODES = Object.freeze({
     usage: "RELKIT_ADD_USAGE",
     invalidProject: "RELKIT_ADD_INVALID_PROJECT",
@@ -27,9 +33,18 @@ export const ADD_FAILURE_CODES = Object.freeze({
     validation: "RELKIT_ADD_VALIDATION_FAILED",
     cancellation: "RELKIT_ADD_CANCELLED",
 });
+/**
+ * Public scaffold failure retaining its stable code, name and category-specific exit status.
+ */
 export class AddScaffoldError extends Error {
     code;
     exitCode;
+    /**
+     * Creates a canonical add failure with its category-specific exit code.
+     * @param code - Stable add failure category.
+     * @param message - User-facing failure diagnostic.
+     * @returns The canonical public error instance.
+     */
     constructor(code, message) {
         super(message);
         this.code = code;

package/dist/add-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"add-types.js","sourceRoot":"","sources":["../src/add-types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,SAAS;IACT,UAAU;IACV,OAAO;IACP,OAAO;IACP,gBAAgB;IAChB,MAAM;IACN,KAAK;IACL,OAAO;IACP,QAAQ;IACR,MAAM;IACN,QAAQ;IACR,OAAO;IACP,WAAW;IACX,OAAO;IACP,YAAY;IACZ,WAAW;IACX,UAAU;IACV,MAAM;CACE,CAAC;AAsIX,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC7C,KAAK,EAAE,kBAAkB;IACzB,cAAc,EAAE,4BAA4B;IAC5C,SAAS,EAAE,sBAAsB;IACjC,sBAAsB,EAAE,qCAAqC;IAC7D,YAAY,EAAE,gCAAgC;IAC9C,UAAU,EAAE,8BAA8B;IAC1C,YAAY,EAAE,sBAAsB;CAC5B,CAAC,CAAC;AAIZ,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAI9B;IAHF,QAAQ,CAAc;IAE/B,YACW,IAAoB,EAC7B,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;QAHN,SAAI,GAAJ,IAAI,CAAgB;QAI7B,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,QAAQ;YACX,IAAI,KAAK,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,iBAAiB,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7F,CAAC;CACF"}
+{"version":3,"file":"add-types.js","sourceRoot":"","sources":["../src/add-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,SAAS;IACT,UAAU;IACV,OAAO;IACP,OAAO;IACP,gBAAgB;IAChB,MAAM;IACN,KAAK;IACL,OAAO;IACP,QAAQ;IACR,MAAM;IACN,QAAQ;IACR,OAAO;IACP,WAAW;IACX,OAAO;IACP,YAAY;IACZ,WAAW;IACX,UAAU;IACV,MAAM;CACE,CAAC;AA4KX;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC7C,KAAK,EAAE,kBAAkB;IACzB,cAAc,EAAE,4BAA4B;IAC5C,SAAS,EAAE,sBAAsB;IACjC,sBAAsB,EAAE,qCAAqC;IAC7D,YAAY,EAAE,gCAAgC;IAC9C,UAAU,EAAE,8BAA8B;IAC1C,YAAY,EAAE,sBAAsB;CAC5B,CAAC,CAAC;AAOZ;;GAEG;AACH,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAU9B;IATF,QAAQ,CAAc;IAE/B;;;;;OAKG;IACH,YACW,IAAoB,EAC7B,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;QAHN,SAAI,GAAJ,IAAI,CAAgB;QAI7B,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,QAAQ;YACX,IAAI,KAAK,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,iBAAiB,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7F,CAAC;CACF"}

package/dist/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":""}

package/dist/bin.js

@@ -0,0 +1,83 @@
+#!/usr/bin/env bun
+import { spinner } from "@clack/prompts";
+import { Effect, Logger, References } from "effect";
+import { generateProjectEffect, projectGenerationLive } from "./generate.js";
+import { formatGenerateResult } from "./generate-output.js";
+import { resolveCreateOptionsDetailsEffect } from "./create-resolver.js";
+import { createClackPromptDriver } from "./prompt-driver.js";
+import { generatorPromptLayer } from "./generator-prompt.js";
+import { runGeneratorPromise } from "./generator-runtime.js";
+import { generationError } from "./generate-process.js";
+import { GenerateProjectError } from "./generate-types.js";
+import { stageCleanupFor } from "./generate-stage-cleanup.js";
+import { transferCleanupFailures } from "./generator-cleanup.js";
+/**
+ * Runs the executable presentation boundary with invocation-owned signal listeners.
+ * @param args - Literal command arguments, excluding the Bun and script paths.
+ * @returns Completion after generation scopes and presentation cleanup have settled.
+ * @remarks The library barrel has no executable side effects. Generation owns final consent.
+ */
+async function main(args) {
+    const json = args.includes("--json");
+    const interactive = !json && !process.env.CI && process.stdin.isTTY === true;
+    const prompt = createClackPromptDriver("RELKIT_CREATE_CANCELLED");
+    const progress = interactive ? spinner() : undefined;
+    const controller = new AbortController();
+    let progressStarted = false;
+    const onProgress = (message) => {
+        if (progress === undefined || message.startsWith("Creating a new RELKIT app"))
+            return;
+        if (!progressStarted) {
+            progress.start(message);
+            progressStarted = true;
+        }
+        else
+            progress.message(message);
+    };
+    const logging = Logger.layer([
+        Logger.make(({ logLevel }) => {
+            if (logLevel === "Warn")
+                process.stderr.write("Generator resource cleanup failed; inspect cleanup diagnostics.\n");
+        }),
+    ]);
+    const program = Effect.scoped(Effect.gen(function* () {
+        yield* Effect.acquireRelease(Effect.sync(() => {
+            const interrupt = () => controller.abort(new GenerateProjectError("RELKIT_INTERRUPTED", "Generation was interrupted.", undefined, 130));
+            const terminate = () => controller.abort(new GenerateProjectError("RELKIT_INTERRUPTED", "Generation was terminated.", undefined, 143));
+            process.on("SIGINT", interrupt);
+            process.on("SIGTERM", terminate);
+            return { interrupt, terminate };
+        }), ({ interrupt, terminate }) => Effect.sync(() => {
+            process.off("SIGINT", interrupt);
+            process.off("SIGTERM", terminate);
+        }));
+        if (interactive)
+            prompt.intro("Create a RELKIT app");
+        const resolved = yield* resolveCreateOptionsDetailsEffect(args, { json, interactive });
+        return yield* generateProjectEffect(resolved.options, {
+            interactive,
+            signal: controller.signal,
+            onProgress,
+        });
+    })).pipe(Effect.provide(projectGenerationLive), Effect.provide(generatorPromptLayer(prompt)), Effect.provide(logging), Effect.provideService(References.MinimumLogLevel, "Warn"));
+    try {
+        const result = await runGeneratorPromise(program, controller.signal);
+        if (progressStarted)
+            progress?.stop("Project created.");
+        process.stdout.write(`${json ? JSON.stringify(result) : formatGenerateResult(result)}\n`);
+    }
+    catch (error) {
+        if (progressStarted)
+            progress?.error("Project creation failed.");
+        const owner = controller.signal.aborted ? controller.signal : error;
+        const failure = transferCleanupFailures(owner, generationError(controller.signal.aborted ? controller.signal.reason : error, "RELKIT_CREATE_FAILED", stageCleanupFor(owner)));
+        const output = json
+            ? JSON.stringify({ ok: false, error: { code: failure.code, message: failure.message } })
+            : `${failure.code}: ${failure.message}`;
+        (json ? process.stdout : process.stderr).write(`${output}\n`);
+        process.exitCode = failure.exitCode;
+    }
+}
+if (import.meta.main)
+    await main(process.argv.slice(2));
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

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

package/dist/bucket-profiles.d.ts

@@ -1,4 +1,18 @@
-import type { ProjectDiscovery } from "./project-discovery-types.js";
-/** Bucket profiles identify physical buckets and cannot have two descriptor owners. */
-export declare function bucketProfileOwners(discovery: Pick<ProjectDiscovery, "projectRoot" | "artifacts" | "profiles">, read?: (path: string) => Promise<string>): Promise<ReadonlyMap<string, string>>;
+import { Effect } from "effect";
+import { GeneratorFileSystem } from "./generator-filesystem.js";
+import type { BucketDiscovery, BucketSourceReader } from "./bucket-profiles.types.js";
+/**
+ * Resolves physical bucket ownership using planned source before native project source.
+ * @param discovery - Current request's declaration facts.
+ * @param read - Optional typed planned-source reader.
+ * @returns Profile-to-descriptor ownership; ambiguous source fails before writes.
+ */
+export declare const bucketProfileOwnersEffect: (discovery: BucketDiscovery, read?: BucketSourceReader | undefined) => Effect.Effect<Map<string, string>, import("./generator-errors.js").GeneratorIoError | import("./generator-errors.js").GeneratorDomainError, GeneratorFileSystem>;
+/**
+ * Preserves the bucket-ownership Promise API and injected reader contract.
+ * @param discovery - Project facts.
+ * @param read - Optional existing Promise source reader.
+ * @returns Bucket-profile ownership before provider planning.
+ */
+export declare function bucketProfileOwners(discovery: BucketDiscovery, read?: (path: string) => Promise<string>): Promise<ReadonlyMap<string, string>>;
 //# sourceMappingURL=bucket-profiles.d.ts.map

package/dist/bucket-profiles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bucket-profiles.d.ts","sourceRoot":"","sources":["../src/bucket-profiles.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAGrE,uFAAuF;AACvF,wBAAsB,mBAAmB,CACvC,SAAS,EAAE,IAAI,CAAC,gBAAgB,EAAE,aAAa,GAAG,WAAW,GAAG,UAAU,CAAC,EAC3E,IAAI,IAAI,MAAM,MAAM,oBAAwD,GAC3E,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAsBtC"}
+{"version":3,"file":"bucket-profiles.d.ts","sourceRoot":"","sources":["../src/bucket-profiles.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAIhE,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEtF;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,yOA8BrC,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,eAAe,EAC1B,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GACvC,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAStC"}

package/dist/bucket-profiles.js

@@ -1,18 +1,40 @@
-import { readFile } from "node:fs/promises";
+import { observeExecution } from "@relkit/contracts/operation";
 import { join } from "node:path";
+import { Effect } from "effect";
 import { ADD_FAILURE_CODES, AddScaffoldError } from "./add-types.js";
+import { GeneratorFileSystem } from "./generator-filesystem.js";
+import { domainError, domainTry } from "./generator-errors.js";
+import { runGeneratorPromise } from "./generator-runtime.js";
 import { readFactoryStringProperty } from "./source-edit.js";
-/** Bucket profiles identify physical buckets and cannot have two descriptor owners. */
-export async function bucketProfileOwners(discovery, read = (path) => readFile(join(discovery.projectRoot, path), "utf8")) {
+/**
+ * Resolves physical bucket ownership using planned source before native project source.
+ * @param discovery - Current request's declaration facts.
+ * @param read - Optional typed planned-source reader.
+ * @returns Profile-to-descriptor ownership; ambiguous source fails before writes.
+ */
+export const bucketProfileOwnersEffect = Effect.fn("BucketProfiles.owners")(function* (discovery, read) {
     const fallback = discovery.profiles.find((item) => item.capability === "bucket" && item.isDefault)?.name ??
         "default";
+    const reader = read ?? (yield* GeneratorFileSystem).readText;
     const owners = new Map();
     for (const artifact of discovery.artifacts.filter((item) => item.kind === "bucket" && item.exported)) {
-        const profile = readFactoryStringProperty(await read(artifact.path), artifact.path, "defineBucket", "profile");
+        const source = yield* reader(read === undefined ? join(discovery.projectRoot, artifact.path) : artifact.path);
+        const profile = yield* domainTry(() => readFactoryStringProperty(source, artifact.path, "defineBucket", "profile"));
         if (profile === undefined && artifact.options.includes("profile"))
-            throw new AddScaffoldError(ADD_FAILURE_CODES.unsupportedSourceShape, `Cannot resolve bucket profile in ${artifact.path}.`);
+            return yield* Effect.fail(domainError(new AddScaffoldError(ADD_FAILURE_CODES.unsupportedSourceShape, `Cannot resolve bucket profile in ${artifact.path}.`)));
         owners.set(profile ?? fallback, artifact.id ?? artifact.path);
     }
     return owners;
+}, (effect) => observeExecution("generator", "planning.bucketProfileOwners", effect));
+/**
+ * Preserves the bucket-ownership Promise API and injected reader contract.
+ * @param discovery - Project facts.
+ * @param read - Optional existing Promise source reader.
+ * @returns Bucket-profile ownership before provider planning.
+ */
+export function bucketProfileOwners(discovery, read) {
+    return runGeneratorPromise(bucketProfileOwnersEffect(discovery, read === undefined
+        ? undefined
+        : (path) => Effect.tryPromise({ try: () => read(path), catch: domainError })));
 }
 //# sourceMappingURL=bucket-profiles.js.map

package/dist/bucket-profiles.js.map

@@ -1 +1 @@
-{"version":3,"file":"bucket-profiles.js","sourceRoot":"","sources":["../src/bucket-profiles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAErE,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAE7D,uFAAuF;AACvF,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,SAA2E,EAC3E,OAAO,CAAC,IAAY,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAE5E,MAAM,QAAQ,GACZ,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,KAAK,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI;QACvF,SAAS,CAAC;IACZ,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,KAAK,MAAM,QAAQ,IAAI,SAAS,CAAC,SAAS,CAAC,MAAM,CAC/C,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAClD,EAAE,CAAC;QACF,MAAM,OAAO,GAAG,yBAAyB,CACvC,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EACzB,QAAQ,CAAC,IAAI,EACb,cAAc,EACd,SAAS,CACV,CAAC;QACF,IAAI,OAAO,KAAK,SAAS,IAAI,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;YAC/D,MAAM,IAAI,gBAAgB,CACxB,iBAAiB,CAAC,sBAAsB,EACxC,oCAAoC,QAAQ,CAAC,IAAI,GAAG,CACrD,CAAC;QACJ,MAAM,CAAC,GAAG,CAAC,OAAO,IAAI,QAAQ,EAAE,QAAQ,CAAC,EAAE,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"bucket-profiles.js","sourceRoot":"","sources":["../src/bucket-profiles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAG7D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAC,EAAE,CAAC,uBAAuB,CAAC,CACzE,QAAQ,CAAC,EAAE,SAA0B,EAAE,IAAyB;IAC9D,MAAM,QAAQ,GACZ,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,KAAK,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI;QACvF,SAAS,CAAC;IACZ,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,mBAAmB,CAAC,CAAC,QAAQ,CAAC;IAC7D,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,KAAK,MAAM,QAAQ,IAAI,SAAS,CAAC,SAAS,CAAC,MAAM,CAC/C,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAClD,EAAE,CAAC;QACF,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,MAAM,CAC1B,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAChF,CAAC;QACF,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,SAAS,CAAC,GAAG,EAAE,CACpC,yBAAyB,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE,cAAc,EAAE,SAAS,CAAC,CAC5E,CAAC;QACF,IAAI,OAAO,KAAK,SAAS,IAAI,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;YAC/D,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CACvB,WAAW,CACT,IAAI,gBAAgB,CAClB,iBAAiB,CAAC,sBAAsB,EACxC,oCAAoC,QAAQ,CAAC,IAAI,GAAG,CACrD,CACF,CACF,CAAC;QACJ,MAAM,CAAC,GAAG,CAAC,OAAO,IAAI,QAAQ,EAAE,QAAQ,CAAC,EAAE,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,EACD,CAAC,MAAM,EAAE,EAAE,CAAC,gBAAgB,CAAC,WAAW,EAAE,8BAA8B,EAAE,MAAM,CAAC,CAClF,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CACjC,SAA0B,EAC1B,IAAwC;IAExC,OAAO,mBAAmB,CACxB,yBAAyB,CACvB,SAAS,EACT,IAAI,KAAK,SAAS;QAChB,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAC/E,CACF,CAAC;AACJ,CAAC"}

package/dist/bucket-profiles.types.d.ts

@@ -0,0 +1,9 @@
+import type { Effect } from "effect";
+import type { ProjectDiscovery } from "./project-discovery-types.js";
+import type { GeneratorDomainError, GeneratorIoError } from "./generator-errors.js";
+import type { GeneratorFileSystem } from "./generator-filesystem.js";
+/** Facts needed to establish physical bucket ownership. */
+export type BucketDiscovery = Pick<ProjectDiscovery, "projectRoot" | "artifacts" | "profiles">;
+/** Source authority supplied by the request planner or native filesystem adapter. */
+export type BucketSourceReader = (path: string) => Effect.Effect<string, GeneratorDomainError | GeneratorIoError, GeneratorFileSystem>;
+//# sourceMappingURL=bucket-profiles.types.d.ts.map

package/dist/bucket-profiles.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bucket-profiles.types.d.ts","sourceRoot":"","sources":["../src/bucket-profiles.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACpF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAErE,2DAA2D;AAC3D,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,gBAAgB,EAAE,aAAa,GAAG,WAAW,GAAG,UAAU,CAAC,CAAC;AAE/F,qFAAqF;AACrF,MAAM,MAAM,kBAAkB,GAAG,CAC/B,IAAI,EAAE,MAAM,KACT,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,oBAAoB,GAAG,gBAAgB,EAAE,mBAAmB,CAAC,CAAC"}

package/dist/bucket-profiles.types.js

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

package/dist/bucket-profiles.types.js.map

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

package/dist/build-catalog.d.ts

@@ -0,0 +1,14 @@
+import type { DependencyPatchDescriptor } from "./dependency-patches.types.js";
+/**
+ * Reads a concrete dependency version materialized into this package at build time.
+ * @param name - External package name declared in the central build catalog.
+ * @returns Its release-supported version without requiring the repository root at runtime.
+ */
+export declare function buildCatalogDependency(name: string): string;
+/**
+ * Validates the patch descriptor against its centrally materialized dependency version.
+ * @param name - Patched external package name.
+ * @returns The immutable version, Bun patch key, asset path, and content hash.
+ */
+export declare function buildCatalogPatch(name: string): DependencyPatchDescriptor;
+//# sourceMappingURL=build-catalog.d.ts.map

package/dist/build-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-catalog.d.ts","sourceRoot":"","sources":["../src/build-catalog.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAE/E;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAS3D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,yBAAyB,CAmBzE"}

package/dist/build-catalog.js

@@ -0,0 +1,70 @@
+import manifest from "../package.json";
+import { ADD_FAILURE_CODES, AddScaffoldError } from "./add-types.js";
+/**
+ * Reads a concrete dependency version materialized into this package at build time.
+ * @param name - External package name declared in the central build catalog.
+ * @returns Its release-supported version without requiring the repository root at runtime.
+ */
+export function buildCatalogDependency(name) {
+    const version = record(buildCatalog().dependencies)[name];
+    if (typeof version !== "string" ||
+        !/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/u.test(version)) {
+        invalid(`The generator build catalog has no concrete version for ${name}.`);
+    }
+    return version;
+}
+/**
+ * Validates the patch descriptor against its centrally materialized dependency version.
+ * @param name - Patched external package name.
+ * @returns The immutable version, Bun patch key, asset path, and content hash.
+ */
+export function buildCatalogPatch(name) {
+    const patch = record(record(buildCatalog().patches)[name]);
+    const version = buildCatalogDependency(name);
+    if (patch.version !== version ||
+        patch.key !== `${name}@${version}` ||
+        typeof patch.asset !== "string" ||
+        !/^patches\/[a-z0-9-]+\.patch$/u.test(patch.asset) ||
+        typeof patch.hash !== "string" ||
+        !/^[a-f0-9]{64}$/u.test(patch.hash)) {
+        invalid(`The generator build catalog has an invalid patch descriptor for ${name}.`);
+    }
+    return Object.freeze({
+        version,
+        key: `${name}@${version}`,
+        asset: patch.asset,
+        hash: patch.hash,
+    });
+}
+/**
+ * Reads portable build metadata while preserving unrelated package metadata.
+ * @returns The validated object boundary; individual consumers validate their required fields.
+ */
+function buildCatalog() {
+    return record(record(record(manifest).relkit).buildCatalog);
+}
+/**
+ * Reads an object-valued metadata field with an empty fallback.
+ * @param value - Unknown metadata field.
+ * @returns The object, or an empty record when the field is not object-valued.
+ */
+function record(value) {
+    return isRecord(value) ? value : {};
+}
+/**
+ * Narrows an unknown value to a non-null object excluding arrays.
+ * @param value - Unknown value at the object boundary.
+ * @returns Whether the value is a non-null, non-array object.
+ */
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/**
+ * Rejects missing or inconsistent portable build metadata.
+ * @param message - User-facing diagnostic or prompt text.
+ * @returns No value; throws the canonical invalid-project AddScaffoldError.
+ */
+function invalid(message) {
+    throw new AddScaffoldError(ADD_FAILURE_CODES.invalidProject, message);
+}
+//# sourceMappingURL=build-catalog.js.map

package/dist/build-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-catalog.js","sourceRoot":"","sources":["../src/build-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGrE;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,MAAM,OAAO,GAAG,MAAM,CAAC,YAAY,EAAE,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC;IAC1D,IACE,OAAO,OAAO,KAAK,QAAQ;QAC3B,CAAC,2DAA2D,CAAC,IAAI,CAAC,OAAO,CAAC,EAC1E,CAAC;QACD,OAAO,CAAC,2DAA2D,IAAI,GAAG,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3D,MAAM,OAAO,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;IAC7C,IACE,KAAK,CAAC,OAAO,KAAK,OAAO;QACzB,KAAK,CAAC,GAAG,KAAK,GAAG,IAAI,IAAI,OAAO,EAAE;QAClC,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ;QAC/B,CAAC,+BAA+B,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;QAClD,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;QAC9B,CAAC,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EACnC,CAAC;QACD,OAAO,CAAC,mEAAmE,IAAI,GAAG,CAAC,CAAC;IACtF,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,OAAO;QACP,GAAG,EAAE,GAAG,IAAI,IAAI,OAAO,EAAE;QACzB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,IAAI,EAAE,KAAK,CAAC,IAAI;KACjB,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,SAAS,YAAY;IACnB,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;AAC9D,CAAC;AAED;;;;GAIG;AACH,SAAS,MAAM,CAAC,KAAc;IAC5B,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AACtC,CAAC;AAED;;;;GAIG;AACH,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED;;;;GAIG;AACH,SAAS,OAAO,CAAC,OAAe;IAC9B,MAAM,IAAI,gBAAgB,CAAC,iBAAiB,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;AACxE,CAAC"}

package/dist/catalog-resolution.d.ts

@@ -0,0 +1,12 @@
+import type { CatalogManifest } from "./catalog-resolution.types.js";
+export type { CatalogManifest } from "./catalog-resolution.types.js";
+/**
+ * Resolves one dependency against its owning default or named Bun catalog.
+ * @param manifest - Workspace root manifest that declares the catalogs.
+ * @param name - Dependency name whose catalog entry is required.
+ * @param spec - Concrete version or catalog reference to resolve.
+ * @returns The concrete declaration, preserving supported peer ranges.
+ * @throws When the reference, catalog, or catalog entry is missing or recursive.
+ */
+export declare function resolveCatalogVersion(manifest: CatalogManifest, name: string, spec: unknown): string;
+//# sourceMappingURL=catalog-resolution.d.ts.map

package/dist/catalog-resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-resolution.d.ts","sourceRoot":"","sources":["../src/catalog-resolution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,YAAY,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAerE;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,eAAe,EACzB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,GACZ,MAAM,CA0BR"}

package/dist/catalog-resolution.js

@@ -0,0 +1,43 @@
+/**
+ * Narrows a required catalog object.
+ * @param value - Parsed package manifest field.
+ * @param label - Human-readable ownership description.
+ * @returns The catalog record.
+ * @throws When the field is absent, scalar, or an array.
+ */
+function record(value, label) {
+    if (value === null || typeof value !== "object" || Array.isArray(value))
+        throw new Error(`${label} must be an object.`);
+    return value;
+}
+/**
+ * Resolves one dependency against its owning default or named Bun catalog.
+ * @param manifest - Workspace root manifest that declares the catalogs.
+ * @param name - Dependency name whose catalog entry is required.
+ * @param spec - Concrete version or catalog reference to resolve.
+ * @returns The concrete declaration, preserving supported peer ranges.
+ * @throws When the reference, catalog, or catalog entry is missing or recursive.
+ */
+export function resolveCatalogVersion(manifest, name, spec) {
+    if (typeof spec !== "string" || spec.trim() === "")
+        throw new Error(`Invalid dependency version: ${name}@${String(spec)}`);
+    if (!spec.startsWith("catalog:"))
+        return spec;
+    const catalogName = spec.slice("catalog:".length).trim();
+    const workspaces = manifest.workspaces !== null &&
+        typeof manifest.workspaces === "object" &&
+        !Array.isArray(manifest.workspaces)
+        ? manifest.workspaces
+        : {};
+    const catalog = record(catalogName === ""
+        ? (manifest.catalog ?? workspaces.catalog)
+        : record(manifest.catalogs ?? workspaces.catalogs, "Named catalogs")[catalogName], catalogName === "" ? "Default catalog" : `Catalog ${catalogName}`);
+    const version = catalog[name];
+    if (typeof version !== "string" ||
+        version.trim() === "" ||
+        /^[A-Za-z][A-Za-z\d+.-]*:/.test(version) ||
+        /^(?:\.\.?\/|\/)/.test(version))
+        throw new Error(`Missing or invalid catalog entry: ${spec} -> ${name}`);
+    return version;
+}
+//# sourceMappingURL=catalog-resolution.js.map

package/dist/catalog-resolution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-resolution.js","sourceRoot":"","sources":["../src/catalog-resolution.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,SAAS,MAAM,CAAC,KAAc,EAAE,KAAa;IAC3C,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACrE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,qBAAqB,CAAC,CAAC;IACjD,OAAO,KAAwB,CAAC;AAClC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAAyB,EACzB,IAAY,EACZ,IAAa;IAEb,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;QAChD,MAAM,IAAI,KAAK,CAAC,+BAA+B,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACzE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9C,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IACzD,MAAM,UAAU,GACd,QAAQ,CAAC,UAAU,KAAK,IAAI;QAC5B,OAAO,QAAQ,CAAC,UAAU,KAAK,QAAQ;QACvC,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;QACjC,CAAC,CAAE,QAAQ,CAAC,UAA8B;QAC1C,CAAC,CAAC,EAAE,CAAC;IACT,MAAM,OAAO,GAAG,MAAM,CACpB,WAAW,KAAK,EAAE;QAChB,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,IAAI,UAAU,CAAC,OAAO,CAAC;QAC1C,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,IAAI,UAAU,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC,WAAW,CAAC,EACnF,WAAW,KAAK,EAAE,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,WAAW,WAAW,EAAE,CAClE,CAAC;IACF,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,IACE,OAAO,OAAO,KAAK,QAAQ;QAC3B,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE;QACrB,0BAA0B,CAAC,IAAI,CAAC,OAAO,CAAC;QACxC,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC;QAE/B,MAAM,IAAI,KAAK,CAAC,qCAAqC,IAAI,OAAO,IAAI,EAAE,CAAC,CAAC;IAC1E,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/catalog-resolution.types.d.ts

@@ -0,0 +1,3 @@
+/** JSON package metadata accepted by the shared strict catalog resolver. */
+export type CatalogManifest = Record<string, unknown>;
+//# sourceMappingURL=catalog-resolution.types.d.ts.map

package/dist/catalog-resolution.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-resolution.types.d.ts","sourceRoot":"","sources":["../src/catalog-resolution.types.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC"}

package/dist/catalog-resolution.types.js

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

package/dist/catalog-resolution.types.js.map

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

package/dist/create-preview.d.ts

@@ -1,12 +1,35 @@
+import { Effect } from "effect";
+import { GeneratorFileSystem } from "./generator-filesystem.js";
 import type { GenerateProjectContext } from "./generate-types.js";
 import type { CreateOptions } from "./options.js";
-export interface CreateScaffoldPlan {
-    readonly destination: string;
-    readonly files: readonly string[];
-    readonly dependencies: Readonly<Record<string, string>>;
-    readonly profiles: readonly string[];
-    readonly warnings: readonly string[];
-}
+import type { CreateScaffoldPlan } from "./create-preview.types.js";
+export type { CreateScaffoldPlan } from "./create-preview.types.js";
+/**
+ * Previews explicit creation flags without mutating project or staging paths.
+ * @param options - Normalized creation flags.
+ * @param context - Existing template and current-directory settings.
+ * @returns A lazy immutable file/dependency/profile preview.
+ */
+export declare const planCreateEffect: (options: CreateOptions, context?: Pick<GenerateProjectContext, "cwd" | "templateRoot"> | undefined) => Effect.Effect<Readonly<{
+    destination: string;
+    files: readonly string[];
+    dependencies: Readonly<{
+        [k: string]: string;
+    }>;
+    profiles: readonly string[];
+    warnings: readonly never[];
+}>, import("./generator-errors.js").GeneratorIoError | import("./generator-errors.js").GeneratorDomainError, GeneratorFileSystem | import("./generator-paths").GeneratorPaths>;
+/**
+ * Preserves the existing preview Promise API.
+ * @param options - Normalized flags.
+ * @param context - Existing template settings.
+ * @returns Read-only creation details.
+ */
 export declare function planCreate(options: CreateOptions, context?: Pick<GenerateProjectContext, "cwd" | "templateRoot">): Promise<CreateScaffoldPlan>;
+/**
+ * Formats an immutable preview as the existing human-readable terminal output.
+ * @param plan - Complete immutable operation plan.
+ * @returns Terminal text listing the destination, files, dependencies, profiles and warnings.
+ */
 export declare function formatCreatePlan(plan: CreateScaffoldPlan): string;
 //# sourceMappingURL=create-preview.d.ts.map