@ykdz/template 0.0.36 → 0.0.38

package/dist/application.d.ts

@@ -1,4 +1,5 @@
-import { type ProjectProjectionAction, type ProjectProjectionConflict } from "#template-core/project-projection";
+import { type GeneratedRepositoryPlan, type InitializationInputIssue, type PackageAdditionInputIssue, type NextStepInstruction, type ProjectBlueprint, type PublicationSetupHandoff, type ResolvedInitialization } from "@ykdz/template-builtin-presets";
+import { type ProjectProjectionAction, type ProjectProjectionConflict } from "@ykdz/template-core/project-projection";
 export type ConfirmationRequest = {
     readonly message: string;
     readonly prompt: string;
@@ -34,19 +35,112 @@ export type AddPackageCommandOptions = {
     readonly dryRun: boolean;
     readonly json: boolean;
 };
-export type ApplicationCommandResult = {
-    readonly exitCode: number;
-    readonly stdout?: string;
-    readonly stderr?: string;
+export type InitCommandResult = {
+    readonly schemaVersion: 1;
+    readonly command: "init";
+    readonly status: "success";
+    readonly dryRun: boolean;
+    readonly targetDir: string;
+    readonly resolved: ResolvedInitialization;
+    readonly blueprint: ProjectBlueprint;
+    readonly generationRecord: GeneratedRepositoryPlan["generationRecord"];
+    readonly toolchain: ReturnType<typeof toolchainReport>;
+    readonly nextSteps: readonly NextStepInstruction[];
+    readonly publicationSetup: PublicationSetupHandoff;
+    readonly followUpDocument: {
+        readonly enabled: boolean;
+        readonly path?: string;
+    };
+} | {
+    readonly schemaVersion: 1;
+    readonly command: "init";
+    readonly status: "cancelled";
+    readonly code: "CANCELLED";
+    readonly targetDir: string;
+} | {
+    readonly schemaVersion: 1;
+    readonly command: "init";
+    readonly status: "usage-error";
+    readonly code: "USAGE_INIT_INVALID";
+    readonly targetDir: string;
+    readonly issues: readonly (InitializationInputIssue | {
+        readonly code: "NON_INTERACTIVE_CONFIRMATION_REQUIRED";
+    })[];
+} | {
+    readonly schemaVersion: 1;
+    readonly command: "init";
+    readonly status: "operation-failure";
+    readonly code: "OPERATION_INIT_FAILED";
+    readonly phase: "preset" | "planning" | "preflight" | "materialization" | "render";
+    readonly targetDir: string;
+    readonly error: {
+        readonly message: string;
+        readonly suggestion: string;
+    };
+};
+type PresetCatalogEntry = {
+    readonly name: string;
+    readonly title: string;
+    readonly description: string;
+};
+export type PresetCatalogCommandResult = {
+    readonly schemaVersion: 1;
+    readonly command: "presets";
+    readonly status: "success";
+    readonly presets: readonly PresetCatalogEntry[];
+};
+export type BlueprintValidationCommandResult = {
+    readonly schemaVersion: 1;
+    readonly command: "blueprint validate";
+    readonly status: "success";
+    readonly path: string;
+} | {
+    readonly schemaVersion: 1;
+    readonly command: "blueprint validate";
+    readonly status: "invalid";
+    readonly code: "BLUEPRINT_INVALID";
+    readonly path: string;
+    readonly issues: readonly {
+        readonly path: string;
+        readonly message: string;
+    }[];
+} | {
+    readonly schemaVersion: 1;
+    readonly command: "blueprint validate";
+    readonly status: "operation-failure";
+    readonly code: "OPERATION_BLUEPRINT_READ_FAILED" | "OPERATION_BLUEPRINT_PARSE_FAILED";
+    readonly path: string;
+    readonly reason: "not-found" | "permission-denied" | "not-a-file" | "unreadable" | "invalid-json";
+    readonly error: {
+        readonly message: string;
+        readonly suggestion: string;
+    };
 };
-type PackageAdditionCliConflict = Omit<ProjectProjectionConflict, "before" | "current" | "after"> & {
+type PackageAdditionCoreConflict = Omit<ProjectProjectionConflict, "before" | "current" | "after"> & {
     readonly context: {
         readonly before: string;
         readonly current: string;
         readonly after: string;
     };
 };
-type PackageAdditionCliResult = {
+type PackageAdditionBusinessConflict = {
+    readonly kind: "identity" | "missing-link";
+    readonly existing: {
+        readonly name: string;
+        readonly path: string;
+        readonly role: string;
+    };
+    readonly requested: {
+        readonly name: string;
+        readonly path: string;
+        readonly role: string;
+    };
+    readonly missingLink?: {
+        readonly consumerPackagePath: string;
+        readonly providerPackagePath: string;
+    };
+};
+export type PackageAdditionCommandResult = {
     readonly schemaVersion: 1;
     readonly command: "add package";
     readonly status: "success";
@@ -58,11 +152,33 @@ type PackageAdditionCliResult = {
     readonly status: "conflict";
     readonly dryRun: boolean;
     readonly actions: readonly [];
-    readonly conflicts: readonly PackageAdditionCliConflict[];
+    readonly conflicts: readonly (PackageAdditionCoreConflict | PackageAdditionBusinessConflict)[];
+} | {
+    readonly schemaVersion: 1;
+    readonly command: "add package";
+    readonly status: "usage-error";
+    readonly code: "USAGE_ADD_PACKAGE_INVALID";
+    readonly issues: readonly PackageAdditionInputIssue[];
+} | {
+    readonly schemaVersion: 1;
+    readonly command: "add package";
+    readonly status: "operation-failure";
+    readonly code: "OPERATION_ADD_PACKAGE_FAILED";
+    readonly phase: "metadata" | "default" | "planning" | "reconciliation";
+    readonly error: {
+        readonly message: string;
+        readonly suggestion: string;
+    };
+};
+export declare function listPresetCatalog(): PresetCatalogCommandResult;
+/**
+ * 初始化结果如实报告随 CLI 发版的不可变工具链快照：没有在线解析来源，也没有回退诊断。
+ */
+declare function toolchainReport(): {
+    nodeVersion: "24.21.0";
+    packageManagerPin: "pnpm@12.9.1";
 };
-export declare function formatPresetCatalog(): string;
-export declare function renderPackageAdditionResult(result: PackageAdditionCliResult, options: AddPackageCommandOptions, preset: string): string;
-export declare function validateBlueprintFile(filePath: string, runtime: ApplicationRuntime): Promise<string>;
-export declare function runInit(options: InitCommandOptions, runtime: ApplicationRuntime): Promise<string>;
-export declare function runAddPackage(options: AddPackageCommandOptions, runtime: ApplicationRuntime): Promise<ApplicationCommandResult>;
+export declare function validateBlueprintFile(filePath: string, runtime: ApplicationRuntime): Promise<BlueprintValidationCommandResult>;
+export declare function runInit(options: InitCommandOptions, runtime: ApplicationRuntime): Promise<InitCommandResult>;
+export declare function runAddPackage(options: AddPackageCommandOptions, runtime: ApplicationRuntime): Promise<PackageAdditionCommandResult>;
 export {};