@ykdz/template 0.0.35 → 0.0.37

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

@@ -1,38 +1,31 @@
-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 PackageContribution } from "#template-core/package-contribution";
-import type { BuiltInPresetDefinition, GenerationContext } from "#template-core/preset-definition";
-import { type ProjectBlueprintV2 } from "#template-core/project-blueprint-v2";
-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";
-export type { PackageDefinition, PackageLinkIntent, PackageRole, ProjectBlueprintV2, } from "#template-core/project-blueprint-v2";
-export type { PackageContribution } from "#template-core/package-contribution";
+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 "@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;
 };
-type GeneratedPackagePlanningRecord = {
-    readonly path: string;
-    readonly definitionName: string;
-    readonly planningContribution: "foundationPlan" | "planInitialization" | "planPackageAddition";
-};
-type GenerationRecord = {
-    readonly schemaVersion: 1;
-    readonly preset: string;
-    readonly templateVersion: "0.0.0";
-    readonly toolchain: BuiltInGenerationContext["toolchain"];
-    readonly packages: readonly GeneratedPackagePlanningRecord[];
-};
+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;
     readonly planningContribution: "planInitialization" | "planPackageAddition";
-    readonly blueprint: ProjectBlueprintV2;
+    readonly blueprint: ProjectBlueprint;
     readonly generationRecord: GenerationRecord;
+    /** Resolved Preset contributions consumed by Blueprint and projections. */
+    readonly packageContributions: readonly PlannedPackageContribution[];
     readonly operations: readonly RenderOperation[];
     readonly reconciliation: readonly ProjectProjectionReconciliation[];
     readonly developmentContainer: {
@@ -42,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. */
@@ -50,6 +45,22 @@ export type GeneratedRepositoryPlan = {
     readonly dependencyMaintenancePolicy: DependencyMaintenancePolicy;
     readonly nextStepInstructions: readonly NextStepInstruction[];
 };
+declare const localTemplateMetadataStateKey: unique symbol;
+export type LocalTemplateMetadata = {
+    readonly blueprint: ProjectBlueprint;
+    readonly context: BuiltInGenerationContext;
+    /** 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[];
+    };
+};
 export type GeneratedRepositoryPackageAdditionPlan = GeneratedRepositoryPlan & {
     readonly projectProjections: {
         readonly before: MaterializeProjectProjectionOptions;
@@ -57,11 +68,44 @@ export type GeneratedRepositoryPackageAdditionPlan = GeneratedRepositoryPlan & {
         readonly preconditions: readonly ProjectProjectionPathPrecondition[];
     };
 };
-/** One independently checkable initial Package Contribution and its real plan. */
-export type BuiltInPresetTemplateSourceCheckContext = {
+/** 用户可修正的 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 contribution: PackageContribution;
-    readonly plan: GeneratedRepositoryPlan;
+    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";
 };
 /**
  * The Foundation persists the non-rendering half of every Package
@@ -71,7 +115,7 @@ export type BuiltInPresetTemplateSourceCheckContext = {
  */
 /** Resolve an owned source handle for diagnostics and source checks. */
 export declare function resolveBuiltInTemplateSource(source: TemplateSourceHandle, relativePath: string): string;
-export declare function validateProjectBlueprintV2(value: unknown): import("@ykdz/template-core/project-blueprint-v2").BlueprintV2ValidationResult;
+export declare function validateProjectBlueprint(value: unknown): import("@ykdz/template-core/project-blueprint").BlueprintValidationResult;
 declare class PresetRegistry {
     #private;
     constructor(definitions: readonly BuiltInPresetDefinition[]);
@@ -79,31 +123,101 @@ declare class PresetRegistry {
     require(name: string): BuiltInPresetDefinition;
 }
 export declare const builtInPresetRegistry: PresetRegistry;
-/** Registry-derived Template Source roots checked independently of render plans. */
-export declare function builtInPresetTemplateSourceContexts(): readonly {
-    readonly name: string;
-    readonly root: string;
-}[];
-/**
- * Derives direct Template Source checks from every registered Definition's
- * actual initial contributions, without maintaining a second Preset catalog.
- */
-export declare function builtInPresetTemplateSourceCheckContexts(): readonly BuiltInPresetTemplateSourceCheckContext[];
 export declare function createGenerationContext(options: {
     readonly targetDir: string;
-    readonly scope?: string;
+    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;
+    readonly path?: string;
+    readonly scope?: string;
+};
+export type ResolvedInitialization = {
+    readonly preset: string;
+    readonly topology: "configurable-primary-package" | "fixed";
+    readonly packages: readonly {
+        readonly name: string;
+        readonly path: string;
+    }[];
+    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: {
+    /** 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 overrides?: InitializationIdentityOverrides;
+}): InitializationPreparation;
 export declare function planGeneratedRepositoryPackageAddition(options: {
     readonly definition: BuiltInPresetDefinition;
-    readonly context: BuiltInGenerationContext;
-    readonly blueprint: ProjectBlueprintV2;
+    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;