@ykdz/template 0.0.36 → 0.0.37

package/node_modules/@ykdz/template-builtin-presets/dist/src/foundation.d.ts

@@ -1,20 +1,23 @@
-import type { CiDiagnosticArtifactDeclaration } from "#template-core/ci-diagnostic-artifact";
-import { type DevelopmentContainerToolLayerBuildArgument, type DevelopmentContainerToolLayerMount, type DevelopmentContainerToolLayerProbe, type PlannedDevelopmentContainerToolLayer } from "#template-core/development-container-tool-layer";
-import type { CheckEnvironmentNeed, DeploymentEnvironmentNeed } from "#template-core/module-graph";
-import type { BuiltInPresetDefinition, GenerationContext, PlannedPackageContribution, ResolvedPrimaryPackageIdentity } from "#template-core/preset-definition";
-import { type ProjectBlueprint } from "#template-core/project-blueprint";
-import type { DependencyMaintenancePolicy } from "#template-core/project-github";
-import type { MaterializeProjectProjectionOptions, ProjectProjectionPathPrecondition, ProjectProjectionReconciliation } from "#template-core/project-projection";
-import type { RenderOperation } from "#template-core/renderer";
-import { type TemplateSourceHandle } from "#template-core/renderer";
+import type { CiDiagnosticArtifactDeclaration } from "@ykdz/template-core/ci-diagnostic-artifact";
+import { type DevelopmentContainerToolLayerBuildArgument, type DevelopmentContainerToolLayerMount, type DevelopmentContainerToolLayerProbe, type PlannedDevelopmentContainerToolLayer } from "@ykdz/template-core/development-container-tool-layer";
+import type { CheckEnvironmentNeed, DeploymentEnvironmentNeed } from "@ykdz/template-core/module-graph";
+import { type FoundationContribution } from "@ykdz/template-core/package-contribution";
+import type { BuiltInPresetDefinition, GenerationContext, PlannedPackageContribution, ResolvedPrimaryPackageIdentity } from "@ykdz/template-core/preset-definition";
+import { type PackageDefinition, type ProjectBlueprint } from "@ykdz/template-core/project-blueprint";
+import type { DependencyMaintenancePolicy } from "@ykdz/template-core/project-github";
+import type { MaterializeProjectProjectionOptions, ProjectProjectionPathPrecondition, ProjectProjectionReconciliation } from "@ykdz/template-core/project-projection";
+import type { RenderOperation } from "@ykdz/template-core/renderer";
+import { type TemplateSourceHandle } from "@ykdz/template-core/renderer";
 import { type GenerationRecord } from "./generation-record.ts";
-export type { PackageDefinition, PackageDefinitionId, PackageLinkIntent, PackageRole, PersistedPackageDefinition, ProjectBlueprint, } from "#template-core/project-blueprint";
-export type { PackageContribution } from "#template-core/package-contribution";
+export type { PackageDefinition, PackageDefinitionId, PackageLinkIntent, PackageRole, PersistedPackageDefinition, ProjectBlueprint, } from "@ykdz/template-core/project-blueprint";
+export type { PackageContribution } from "@ykdz/template-core/package-contribution";
 export type BuiltInGenerationContext = GenerationContext;
-export type { BuiltInPresetDefinition } from "#template-core/preset-definition";
+export type { BuiltInPresetDefinition } from "@ykdz/template-core/preset-definition";
 export type NextStepInstruction = {
     readonly display: string;
 };
+export type GeneratedDeploymentCheck = Omit<NonNullable<FoundationContribution["deploymentCheck"]>, "sources">;
+export type GeneratedVueHonoJointE2e = Omit<NonNullable<FoundationContribution["vueHonoJointE2e"]>, "sources">;
 export type GeneratedRepositoryPlan = {
     readonly definitionName: string;
     readonly plannerSourceFile: string;
@@ -32,6 +35,8 @@ export type GeneratedRepositoryPlan = {
         readonly probes: readonly DevelopmentContainerToolLayerProbe[];
     };
     readonly environmentNeeds: readonly CheckEnvironmentNeed[];
+    readonly deploymentCheck: GeneratedDeploymentCheck | undefined;
+    readonly vueHonoJointE2e: GeneratedVueHonoJointE2e | undefined;
     readonly deploymentEnvironmentNeeds: readonly DeploymentEnvironmentNeed[];
     readonly ciDiagnosticArtifacts: readonly CiDiagnosticArtifactDeclaration[];
     /** Structured manifests used to derive the generated Dependency Catalog. */
@@ -47,6 +52,11 @@ export type LocalTemplateMetadata = {
     /** Opaque Foundation-owned facts; callers pass the whole metadata value. */
     readonly [localTemplateMetadataStateKey]: {
         readonly generationRecord: GenerationRecord;
+        /**
+         * 目标仓库根 package.json 现行的 engines.node 声明原文；加包时按它回写私有根，
+         * 使生成后目标仓库自身的版本声明不被 CLI 发版快照覆盖。
+         */
+        readonly rootNodeDeclaration: string;
         readonly foundationContribution: PlannedPackageContribution;
         readonly packageContributions: readonly PlannedPackageContribution[];
     };
@@ -58,6 +68,42 @@ export type GeneratedRepositoryPackageAdditionPlan = GeneratedRepositoryPlan & {
         readonly preconditions: readonly ProjectProjectionPathPrecondition[];
     };
 };
+/** 用户可修正的 Package Addition 输入事实，顺序由 Foundation 固定。 */
+export type PackageAdditionInputIssue = {
+    readonly code: "PRESET_UNKNOWN" | "PRESET_NOT_ADDABLE" | "INVALID_PACKAGE_NAME" | "INVALID_PACKAGE_PATH" | "RESERVED_PACKAGE_PATH" | "INVALID_LINK_FROM" | "RESERVED_LINK_FROM" | "UNKNOWN_LINK_FROM" | "UNSUPPORTED_LINK";
+};
+export type PackageAdditionPreparation = {
+    readonly status: "input-invalid";
+    readonly issues: readonly PackageAdditionInputIssue[];
+} | {
+    readonly status: "conflict";
+    readonly conflict: PackageAdditionBusinessConflict;
+} | {
+    readonly status: "operation-failure";
+    readonly phase: "metadata" | "default" | "planning";
+    /** 仅目标根 Node/pnpm 声明错误携带的字段级诊断；其他操作失败保持通用提示。 */
+    readonly diagnostic?: {
+        readonly message: string;
+        readonly suggestion: string;
+    };
+} | {
+    readonly status: "ready";
+    readonly definition: BuiltInPresetDefinition;
+    readonly plan: GeneratedRepositoryPackageAdditionPlan;
+};
+export declare class PackageAdditionBusinessConflict extends Error {
+    readonly kind: "identity" | "missing-link";
+    readonly existing: PackageDefinition;
+    readonly requested: PackageDefinition;
+    readonly missingLink?: {
+        readonly consumerPackagePath: string;
+        readonly providerPackagePath: string;
+    };
+    constructor(kind: "identity" | "missing-link", existing: PackageDefinition, requested: PackageDefinition, missingLink?: {
+        readonly consumerPackagePath: string;
+        readonly providerPackagePath: string;
+    });
+}
 export type PublicationSetupHandoff = null | {
     readonly command: "./scripts/npm-publication-setup/setup.sh";
 };
@@ -82,6 +128,19 @@ export declare function createGenerationContext(options: {
     readonly defaultPackageScope?: string;
     readonly toolchain: BuiltInGenerationContext["toolchain"];
 }): BuiltInGenerationContext;
+export type RustToolchainChannelReading = {
+    readonly channel: string;
+    readonly status: "explained";
+} | {
+    readonly reason: string;
+    readonly status: "unreadable";
+};
+/**
+ * Root Rust 来源的最小接缝：从 rust-toolchain.toml 正文结构化读出 `[toolchain].channel`。
+ * 复用加包路径同一 smol-toml 真源，供模板仓投影值门核对 M5；不引入第二套版本或文件名表。
+ * 正文非法 TOML 或缺少非空 channel 时返回不可解释，由调用方按缺失/漂移分类，不静默跳过。
+ */
+export declare function readRustToolchainChannelFromToml(contents: string): RustToolchainChannelReading;
 export declare function loadLocalTemplateMetadata(repositoryRoot: string): LocalTemplateMetadata;
 export type InitializationIdentityOverrides = {
     readonly name?: string;
@@ -97,27 +156,68 @@ export type ResolvedInitialization = {
     }[];
     readonly scope: string;
 };
+/** A user-correctable initialization fact, ordered by the owning Foundation. */
+export type InitializationInputIssue = {
+    readonly code: "PRESET_UNKNOWN" | "FIXED_TOPOLOGY_OVERRIDE" | "INVALID_PACKAGE_NAME" | "INVALID_PACKAGE_PATH" | "RESERVED_PACKAGE_PATH" | "INVALID_PACKAGE_SCOPE" | "INVALID_REPOSITORY_SCOPE" | "CONFLICTING_PACKAGE_IDENTITY";
+};
+export type InitializationPreparation = {
+    readonly status: "input-invalid";
+    readonly issues: readonly InitializationInputIssue[];
+} | {
+    readonly status: "operation-failure";
+    readonly phase: "preset" | "planning" | "preflight";
+} | {
+    readonly status: "ready";
+    readonly context: BuiltInGenerationContext;
+    readonly resolvedPackageIdentity?: ResolvedPrimaryPackageIdentity;
+    readonly resolved: ResolvedInitialization;
+    readonly plan: GeneratedRepositoryPlan;
+    readonly publicationSetup: PublicationSetupHandoff;
+};
+export type InitializationInputValidation = {
+    readonly status: "input-invalid";
+    readonly issues: readonly InitializationInputIssue[];
+} | {
+    readonly status: "valid";
+};
+type InitializationInputOptions = {
+    readonly definition?: BuiltInPresetDefinition;
+    readonly preset?: string;
+    readonly targetDir: string;
+    readonly overrides?: InitializationIdentityOverrides;
+};
+export declare function validateGeneratedRepositoryInitializationInput(options: InitializationInputOptions): InitializationInputValidation;
+/**
+ * 直接规划接缝：调用方自带 Generation Context，私有根沿用其 Node 声明；上下文带精确事实时
+ * 私有根得到精确版本。生产初始化由 prepareGeneratedRepositoryInitialization 投影 CLI 发版快照。
+ */
 export declare function planGeneratedRepositoryInitialization(options: {
     readonly definition: BuiltInPresetDefinition;
     readonly context: BuiltInGenerationContext;
 }): GeneratedRepositoryPlan;
 export declare function prepareGeneratedRepositoryInitialization(options: {
-    readonly definition: BuiltInPresetDefinition;
+    /** Direct Definitions are retained for Preset-local behavior tests. */
+    readonly definition?: BuiltInPresetDefinition;
+    /** CLI callers select a Preset through the owning Built-in Presets Module. */
+    readonly preset?: string;
     readonly targetDir: string;
-    readonly toolchain: BuiltInGenerationContext["toolchain"];
     readonly overrides?: InitializationIdentityOverrides;
-}): {
-    readonly context: BuiltInGenerationContext;
-    readonly resolvedPackageIdentity?: ResolvedPrimaryPackageIdentity;
-    readonly resolved: ResolvedInitialization;
-    readonly plan: GeneratedRepositoryPlan;
-    readonly publicationSetup: PublicationSetupHandoff;
-};
+}): InitializationPreparation;
 export declare function planGeneratedRepositoryPackageAddition(options: {
     readonly definition: BuiltInPresetDefinition;
     readonly localTemplateMetadata: LocalTemplateMetadata;
     readonly packageLeafName: string;
     readonly packagePath?: string;
-    /** Existing consumers that explicitly import the newly added provider. */
     readonly linkFrom?: readonly string[];
 }): GeneratedRepositoryPackageAdditionPlan;
+/**
+ * Command-owned preparation: user input is checked before local metadata or any
+ * Preset default/planner work; all remaining failures are deliberately bounded.
+ */
+export declare function prepareGeneratedRepositoryPackageAddition(options: {
+    readonly repositoryRoot: string;
+    readonly preset: string;
+    readonly packageLeafName: string;
+    readonly packagePath?: string;
+    readonly linkFrom?: readonly string[];
+}): PackageAdditionPreparation;