@ykdz/template 0.0.35 → 0.0.37

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

@@ -0,0 +1,39 @@
+import type { PackageDefinitionId } from "@ykdz/template-core/project-blueprint";
+export type GeneratedPackagePlanningRecord = {
+    readonly packageDefinitionId: PackageDefinitionId;
+    readonly path: string;
+    readonly definitionName: string;
+    readonly planningContribution: "foundationPlan" | "planInitialization" | "planPackageAddition";
+    readonly contributionIdentity: string;
+};
+/**
+ * Generation Record v2 的工具链形状：只保存初始化时的历史 Node 大版本与 pnpm pin。
+ * 它刻意与 GenerationContext.toolchain 解耦，精确 Node 事实不得进入持久记录。
+ */
+export type GenerationRecordToolchain = {
+    readonly nodeLtsMajor: string;
+    readonly packageManagerPin: string;
+};
+export type GenerationRecord = {
+    readonly schemaVersion: 2;
+    readonly repositoryName: string;
+    readonly defaultPackageScope: string;
+    readonly preset: string;
+    readonly templateVersion: "0.0.0";
+    readonly toolchain: GenerationRecordToolchain;
+    readonly packages: readonly GeneratedPackagePlanningRecord[];
+};
+/** Canonical durable Generation Record contract for a default npm scope. */
+export declare function isValidDefaultPackageScope(value: string): boolean;
+/** Strictly decodes the durable Record shape before semantic checks run. */
+export declare function decodeGenerationRecordStructure(value: unknown): GenerationRecord;
+/** Validates semantic invariants that are independent of a Project Blueprint. */
+export declare function parseGenerationRecord(value: unknown): GenerationRecord;
+/** Review callers need the same complete validation without interpreting Error text. */
+export declare function validateGenerationRecord(value: unknown): {
+    readonly ok: true;
+    readonly value: GenerationRecord;
+} | {
+    readonly ok: false;
+    readonly issues: readonly string[];
+};

package/node_modules/@ykdz/template-builtin-presets/dist/src/generation-record.js

@@ -0,0 +1,178 @@
+import * as v from "valibot";
+/** Canonical durable Generation Record contract for a default npm scope. */
+export function isValidDefaultPackageScope(value) {
+    return /^[a-z0-9][a-z0-9._-]*$/.test(value);
+}
+// 以下两条规则只校验历史 Generation Record 中已冻结的初始化事实，不是现行版本真源。
+function isNumericNodeLtsMajor(value) {
+    return /^\d+$/.test(value);
+}
+function isExactPackageManagerPin(value) {
+    return /^pnpm@\d+\.\d+\.\d+(?:[-+][0-9A-Za-z.-]+)?$/.test(value);
+}
+function strictObjectMessage(issue, objectMessage) {
+    if (issue.path?.at(-1)?.origin !== "key")
+        return objectMessage;
+    const unknownKey = typeof issue.input === "string" ? issue.input : "<unknown>";
+    return `contains unknown Generation Record field; contains unknown field: ${unknownKey}`;
+}
+const packagePlanningRecordSchema = v.strictObject({
+    packageDefinitionId: v.string("packageDefinitionId must use the package-<sha256> format"),
+    path: v.string("path must be a non-empty string"),
+    definitionName: v.string("definitionName must be a non-empty string"),
+    planningContribution: v.picklist(["foundationPlan", "planInitialization", "planPackageAddition"], "planningContribution is unsupported"),
+    contributionIdentity: v.string("contributionIdentity must be a non-empty string"),
+}, (issue) => strictObjectMessage(issue, "package planning fact must be an object"));
+const generationRecordSchema = v.strictObject({
+    schemaVersion: v.literal(2, (issue) => `Unsupported Generation Record schema version ${String(issue.input)}; expected 2`),
+    repositoryName: v.string("repositoryName must be a non-empty string"),
+    defaultPackageScope: v.string("defaultPackageScope must be a valid npm scope"),
+    preset: v.string("preset must be a non-empty string"),
+    templateVersion: v.literal("0.0.0", "templateVersion must be 0.0.0"),
+    toolchain: v.strictObject({
+        nodeLtsMajor: v.string("toolchain.nodeLtsMajor must be a numeric Node major"),
+        packageManagerPin: v.string("toolchain.packageManagerPin must be an exact pnpm version pin"),
+    }, (issue) => strictObjectMessage(issue, "toolchain must be an object")),
+    packages: v.array(packagePlanningRecordSchema, "packages must be an array"),
+}, (issue) => strictObjectMessage(issue, "supported Generation Record must be an object"));
+function issuePath(issue) {
+    let result = "";
+    for (const item of issue.path ?? []) {
+        if (typeof item.key === "number") {
+            result += `[${item.key}]`;
+        }
+        else if (typeof item.key === "string") {
+            result += `${result.length === 0 ? "" : "."}${item.key}`;
+        }
+    }
+    return result;
+}
+const missingFieldMessages = new Map([
+    [
+        "schemaVersion",
+        "Unsupported Generation Record schema version undefined; expected 2",
+    ],
+    ["repositoryName", "repositoryName must be a non-empty string"],
+    ["defaultPackageScope", "defaultPackageScope must be a valid npm scope"],
+    ["preset", "preset must be a non-empty string"],
+    ["templateVersion", "templateVersion must be 0.0.0"],
+    ["toolchain", "toolchain must be an object"],
+    ["packages", "packages must be an array"],
+]);
+class GenerationRecordInputError extends Error {
+}
+function missingFieldMessage(path, fallback) {
+    const exact = missingFieldMessages.get(path);
+    if (exact !== undefined)
+        return exact;
+    if (path.endsWith(".nodeLtsMajor")) {
+        return `${path} must be a numeric Node major`;
+    }
+    if (path.endsWith(".packageManagerPin")) {
+        return `${path} must be an exact pnpm version pin`;
+    }
+    if (path.endsWith(".packageDefinitionId")) {
+        return `${path} must use the package-<sha256> format`;
+    }
+    if (path.endsWith(".path") ||
+        path.endsWith(".definitionName") ||
+        path.endsWith(".contributionIdentity")) {
+        return `${path} must be a non-empty string`;
+    }
+    if (path.endsWith(".planningContribution")) {
+        return `${path} is unsupported`;
+    }
+    return fallback;
+}
+function structuralError(issues) {
+    return new GenerationRecordInputError(`Generation Record ${issues
+        .map((issue) => {
+        const path = issuePath(issue);
+        const last = issue.path?.at(-1);
+        if (issue.type === "strict_object" &&
+            last?.origin === "key" &&
+            issue.input !== undefined &&
+            !path.includes(".") &&
+            !path.includes("[")) {
+            const unknownKey = typeof issue.input === "string" ? issue.input : "<unknown>";
+            return `contains unknown field: ${unknownKey}; ${path}: contains unknown Generation Record field`;
+        }
+        let message = issue.message;
+        if (issue.type === "strict_object" &&
+            last?.origin === "key" &&
+            issue.input === undefined) {
+            message = missingFieldMessage(path, message);
+        }
+        const normalizedPath = path.length === 0 ? "." : path;
+        return message.startsWith(normalizedPath)
+            ? message
+            : `${normalizedPath}: ${message}`;
+    })
+        .join("; ")}`);
+}
+/** Strictly decodes the durable Record shape before semantic checks run. */
+export function decodeGenerationRecordStructure(value) {
+    const parsed = v.safeParse(generationRecordSchema, value);
+    if (!parsed.success)
+        throw structuralError(parsed.issues);
+    return parsed.output;
+}
+/** Validates semantic invariants that are independent of a Project Blueprint. */
+export function parseGenerationRecord(value) {
+    const record = decodeGenerationRecordStructure(value);
+    const issues = [];
+    if (record.repositoryName.length === 0 ||
+        record.repositoryName !== record.repositoryName.trim()) {
+        issues.push("repositoryName must be a non-empty string");
+    }
+    if (!isValidDefaultPackageScope(record.defaultPackageScope)) {
+        issues.push("defaultPackageScope must be a valid npm scope");
+    }
+    if (record.preset.length === 0 || record.preset !== record.preset.trim()) {
+        issues.push("preset must be a non-empty string");
+    }
+    if (!isNumericNodeLtsMajor(record.toolchain.nodeLtsMajor)) {
+        issues.push("toolchain.nodeLtsMajor must be a numeric Node major");
+    }
+    if (!isExactPackageManagerPin(record.toolchain.packageManagerPin)) {
+        issues.push("toolchain.packageManagerPin must be an exact pnpm version pin");
+    }
+    for (const [index, item] of record.packages.entries()) {
+        if (!/^package-[a-f0-9]{64}$/.test(item.packageDefinitionId)) {
+            issues.push(`packages[${index}].packageDefinitionId must use the package-<sha256> format`);
+        }
+        if (item.path.length === 0) {
+            issues.push(`packages[${index}].path must be a non-empty string`);
+        }
+        if (item.definitionName.length === 0) {
+            issues.push(`packages[${index}].definitionName must be a non-empty string`);
+        }
+        if (item.contributionIdentity.length === 0) {
+            issues.push(`packages[${index}].contributionIdentity must be a non-empty string`);
+        }
+    }
+    const packageDefinitionIds = record.packages.map((item) => item.packageDefinitionId);
+    if (new Set(packageDefinitionIds).size !== packageDefinitionIds.length) {
+        issues.push("packages packageDefinitionId must be unique");
+    }
+    if (issues.length > 0) {
+        throw new GenerationRecordInputError(`Generation Record ${issues.join("; ")}`);
+    }
+    return record;
+}
+/** Review callers need the same complete validation without interpreting Error text. */
+export function validateGenerationRecord(value) {
+    try {
+        return { ok: true, value: parseGenerationRecord(value) };
+    }
+    catch (error) {
+        if (!(error instanceof GenerationRecordInputError))
+            throw error;
+        return {
+            ok: false,
+            issues: [
+                error instanceof Error ? error.message : "Generation Record 无法验证",
+            ],
+        };
+    }
+}

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

@@ -1,3 +1,3 @@
-export { builtInPresetRegistry, builtInPresetTemplateSourceCheckContexts, builtInPresetTemplateSourceContexts, createGenerationContext, planGeneratedRepositoryInitialization, planGeneratedRepositoryPackageAddition, resolveBuiltInTemplateSource, validateProjectBlueprintV2, } from "./foundation.ts";
+export { builtInPresetRegistry, createGenerationContext, loadLocalTemplateMetadata, prepareGeneratedRepositoryPackageAddition, validateGeneratedRepositoryInitializationInput, prepareGeneratedRepositoryInitialization, planGeneratedRepositoryInitialization, planGeneratedRepositoryPackageAddition, readRustToolchainChannelFromToml, resolveBuiltInTemplateSource, validateProjectBlueprint, } from "./foundation.ts";
 export { templateSources } from "./template-sources.ts";
-export type { BuiltInPresetDefinition, BuiltInPresetTemplateSourceCheckContext, GeneratedRepositoryPlan, PackageContribution, ProjectBlueprintV2, BuiltInGenerationContext, } from "./foundation.ts";
+export type { BuiltInPresetDefinition, GeneratedRepositoryPlan, PackageContribution, ProjectBlueprint, BuiltInGenerationContext, LocalTemplateMetadata, InitializationIdentityOverrides, InitializationInputIssue, InitializationInputValidation, InitializationPreparation, PackageAdditionBusinessConflict, PackageAdditionInputIssue, PackageAdditionPreparation, NextStepInstruction, PublicationSetupHandoff, ResolvedInitialization, RustToolchainChannelReading, } from "./foundation.ts";

package/node_modules/@ykdz/template-builtin-presets/dist/src/index.js

@@ -1,2 +1,2 @@
-export { builtInPresetRegistry, builtInPresetTemplateSourceCheckContexts, builtInPresetTemplateSourceContexts, createGenerationContext, planGeneratedRepositoryInitialization, planGeneratedRepositoryPackageAddition, resolveBuiltInTemplateSource, validateProjectBlueprintV2, } from "./foundation.js";
+export { builtInPresetRegistry, createGenerationContext, loadLocalTemplateMetadata, prepareGeneratedRepositoryPackageAddition, validateGeneratedRepositoryInitializationInput, prepareGeneratedRepositoryInitialization, planGeneratedRepositoryInitialization, planGeneratedRepositoryPackageAddition, readRustToolchainChannelFromToml, resolveBuiltInTemplateSource, validateProjectBlueprint, } from "./foundation.js";
 export { templateSources } from "./template-sources.js";

package/node_modules/@ykdz/template-builtin-presets/dist/src/rust-bin/definition.d.ts

@@ -1,2 +1,31 @@
-import type { BuiltInPresetDefinition } from "#template-core/preset-definition";
-export declare const rustBinDefinition: BuiltInPresetDefinition;
+import { type GenerationContext } from "@ykdz/template-core/preset-definition";
+export declare const rustBinDefinition: {
+    metadata: {
+        name: string;
+        title: string;
+        description: string;
+    };
+    source: import("@ykdz/template-core/renderer").TemplateSourceHandle;
+    plannerSourceFile: string;
+    packageContributionReplayAdapters: import("@ykdz/template-core/preset-definition").PackageContributionReplayAdapter[];
+    initialPrimaryPackage: {
+        defaultLeafName: string;
+        role: "native-package";
+        defaultPackagePath: ({ packageLeafName }: {
+            readonly packageLeafName: string;
+        }) => string;
+        planInitialContribution({ context, resolvedPackageIdentity }: {
+            readonly context: GenerationContext;
+            readonly resolvedPackageIdentity: import("@ykdz/template-core/preset-definition").ResolvedPrimaryPackageIdentity;
+        }): import("@ykdz/template-core/preset-definition").PlannedPackageContribution;
+    };
+    defaultPackagePath({ packageLeafName }: {
+        readonly context: GenerationContext;
+        readonly packageLeafName: string;
+    }): string;
+    planPackageAddition({ context, packageLeafName, packagePath }: {
+        readonly context: GenerationContext;
+        readonly packageLeafName: string;
+        readonly packagePath: string;
+    }): import("@ykdz/template-core/preset-definition").PlannedPackageContribution;
+};

package/node_modules/@ykdz/template-builtin-presets/dist/src/rust-bin/definition.js

@@ -1,14 +1,9 @@
 import { fileURLToPath } from "node:url";
-import { rustToolchainEnvironmentNeed } from "#template-core/module-graph";
+import { rustToolchainEnvironmentNeed } from "@ykdz/template-core/module-graph";
+import { definePackageContributionReplayAdapter, } from "@ykdz/template-core/preset-definition";
 import { templateSources } from "../template-sources.js";
-function cargoPackageName(projectName) {
-    const slug = projectName
-        .normalize("NFKD")
-        .replace(/[\u0300-\u036f]/g, "")
-        .toLowerCase()
-        .replace(/[^a-z0-9]+/g, "-")
-        .replace(/^-+|-+$/g, "");
-    return slug || "rust-bin";
+function packagePathForLeaf(packageLeafName) {
+    return `packages/${packageLeafName}`;
 }
 function packageScripts() {
     return {
@@ -19,11 +14,14 @@ function packageScripts() {
     };
 }
 function rustContribution(options) {
-    const definition = {
-        name: `@${options.context.scope}/${options.packageLeafName}`,
+    const definition = options.packageDefinition ?? {
+        name: `@${options.context.defaultPackageScope}/${options.packageLeafName}`,
         path: options.packagePath,
         role: "native-package",
     };
+    // 根声明与容器初值共用同一个上下文 channel：初始化携带 CLI 发版快照的精确版本，加包携带目标根
+    // rust-toolchain.toml 的现行 channel；缺省只服务还没有根声明的首次建源路径。
+    const rustChannel = options.context.toolchain.rustVersion ?? "stable";
     const operations = [
         { kind: "writeJson", to: `${definition.path}/package.json`, value: {} },
         {
@@ -64,7 +62,6 @@ function rustContribution(options) {
         exposure: { exports: {}, imports: {} },
         manifest: {
             name: definition.name,
-            version: "0.0.0",
             private: true,
             scripts: packageScripts(),
             engines: { node: options.context.toolchain.nodeLtsMajor },
@@ -78,7 +75,14 @@ function rustContribution(options) {
         ],
         foundation: {
             toolchains: {
-                rust: { toolchain: "stable", components: ["rustfmt", "clippy"] },
+                rust: {
+                    toolchain: rustChannel,
+                    components: ["rustfmt", "clippy"],
+                    configurationSource: {
+                        source: templateSources.rustBin,
+                        from: "rust-toolchain.toml",
+                    },
+                },
             },
             editorCapabilities: ["rust-tooling"],
             dependencyMaintenance: {
@@ -100,7 +104,7 @@ function rustContribution(options) {
                         from: "devcontainer/rust.Dockerfile",
                     },
                     requires: ["node-pnpm"],
-                    buildArguments: [{ name: "RUST_TOOLCHAIN", value: "stable" }],
+                    buildArguments: [{ name: "RUST_TOOLCHAIN", value: rustChannel }],
                     mounts: [
                         {
                             identity: "cargo-registry",
@@ -121,51 +125,44 @@ function rustContribution(options) {
                     ],
                 },
             ],
-            templateFiles: [
-                {
-                    identity: "rust-toolchain",
-                    source: templateSources.rustBin,
-                    from: "rust-toolchain.toml",
-                    to: "rust-toolchain.toml",
-                    replacements: { RUST_TOOLCHAIN: "stable" },
-                },
-            ],
         },
     };
 }
+const binaryReplayAdapter = definePackageContributionReplayAdapter({
+    identity: "binary",
+    replay: ({ context, packageDefinition, packageLeafName }) => rustContribution({
+        context,
+        packageLeafName,
+        packagePath: packageDefinition.path,
+        packageDefinition,
+    }),
+});
 export const rustBinDefinition = {
     metadata: {
         name: "rust-bin",
-        title: "Rust binary",
-        description: "Rust native binary workspace with rustfmt, clippy, and cargo tests.",
+        title: "Rust 二进制程序",
+        description: "包含 rustfmt、clippy 和 cargo 测试的 Rust 原生二进制工作区。",
     },
     source: templateSources.rustBin,
     plannerSourceFile: fileURLToPath(import.meta.url),
-    blueprint(context) {
-        const packageLeafName = cargoPackageName(context.projectName);
-        return {
-            schemaVersion: 2,
-            packages: [
-                rustContribution({
-                    context,
-                    packageLeafName,
-                    packagePath: `packages/${packageLeafName}`,
-                }).definition,
-            ],
-        };
-    },
-    planInitialization(context) {
-        const packageLeafName = cargoPackageName(context.projectName);
-        return rustContribution({
-            context,
-            packageLeafName,
-            packagePath: `packages/${packageLeafName}`,
-        });
+    packageContributionReplayAdapters: [binaryReplayAdapter],
+    initialPrimaryPackage: {
+        defaultLeafName: "app",
+        role: "native-package",
+        defaultPackagePath: ({ packageLeafName }) => packagePathForLeaf(packageLeafName),
+        planInitialContribution({ context, resolvedPackageIdentity }) {
+            return binaryReplayAdapter.identify(rustContribution({
+                context,
+                packageLeafName: resolvedPackageIdentity.leafName,
+                packagePath: resolvedPackageIdentity.definition.path,
+                packageDefinition: resolvedPackageIdentity.definition,
+            }));
+        },
     },
     defaultPackagePath({ packageLeafName }) {
-        return `packages/${packageLeafName}`;
+        return packagePathForLeaf(packageLeafName);
     },
     planPackageAddition({ context, packageLeafName, packagePath }) {
-        return rustContribution({ context, packageLeafName, packagePath });
+        return binaryReplayAdapter.identify(rustContribution({ context, packageLeafName, packagePath }));
     },
 };

package/node_modules/@ykdz/template-builtin-presets/dist/src/shared/development-container.d.ts

@@ -1,3 +1,3 @@
-import type { DevelopmentContainerToolLayer } from "#template-core/development-container-tool-layer";
+import type { DevelopmentContainerToolLayer } from "@ykdz/template-core/development-container-tool-layer";
 export declare function githubCliDevelopmentContainerToolLayer(): DevelopmentContainerToolLayer;
 export declare function browserTestDevelopmentContainerToolLayer(): DevelopmentContainerToolLayer;

package/node_modules/@ykdz/template-builtin-presets/dist/src/shared/development-container.js

@@ -1,4 +1,4 @@
-import { loadTemplateDependencyCatalog } from "#template-core/dependency-catalog";
+import { loadTemplateDependencyCatalog } from "@ykdz/template-core/dependency-catalog";
 import { templateSources } from "../template-sources.js";
 export function githubCliDevelopmentContainerToolLayer() {
     return {

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

@@ -1,13 +1,16 @@
-import type { PackageContribution } from "#template-core/package-contribution";
-import type { GenerationContext } from "#template-core/preset-definition";
-import type { PackageDefinition } from "#template-core/project-blueprint-v2";
-import type { RenderOperation, TemplateSourceHandle } from "#template-core/renderer";
-export declare function typescriptConfigPackageName(context: GenerationContext): string;
-export declare function typescriptConfigPackageDefinition(context: GenerationContext): PackageDefinition;
+import type { PackageContribution } from "@ykdz/template-core/package-contribution";
+import { type GenerationContext } from "@ykdz/template-core/preset-definition";
+import type { PackageDefinition } from "@ykdz/template-core/project-blueprint";
+import type { RenderOperation, TemplateSourceHandle } from "@ykdz/template-core/renderer";
+type TypescriptConfigFoundationContext = Pick<GenerationContext, "foundationPackages">;
+export declare function typescriptConfigPackageName(context: TypescriptConfigFoundationContext): string;
+export declare function typescriptConfigPackageDefinition(context: TypescriptConfigFoundationContext): PackageDefinition;
 export declare function typescriptConfigSourceOperation(options: {
     readonly context: GenerationContext;
     readonly source: TemplateSourceHandle;
     readonly from: string;
     readonly to: string;
 }): RenderOperation;
-export declare function typescriptConfigContribution(context: GenerationContext): PackageContribution;
+export declare function typescriptConfigContribution(context: GenerationContext, definition?: PackageDefinition): PackageContribution;
+export declare const typescriptConfigReplayAdapter: import("@ykdz/template-core/preset-definition").PackageContributionReplayAdapter;
+export {};

package/node_modules/@ykdz/template-builtin-presets/dist/src/shared/typescript.js

@@ -1,6 +1,8 @@
+import { definePackageContributionReplayAdapter, } from "@ykdz/template-core/preset-definition";
 import { templateSources } from "../template-sources.js";
+const typescriptConfigPackageReplacement = "TYPESCRIPT_CONFIG_PACKAGE";
 export function typescriptConfigPackageName(context) {
-    return `@${context.scope}/typescript-config`;
+    return context.foundationPackages.typescriptConfiguration.name;
 }
 export function typescriptConfigPackageDefinition(context) {
     return {
@@ -16,23 +18,21 @@ export function typescriptConfigSourceOperation(options) {
         from: options.from,
         to: options.to,
         replacements: {
-            TYPESCRIPT_CONFIG_PACKAGE: typescriptConfigPackageName(options.context),
+            [typescriptConfigPackageReplacement]: typescriptConfigPackageName(options.context),
         },
     };
 }
-export function typescriptConfigContribution(context) {
-    const definition = typescriptConfigPackageDefinition(context);
+export function typescriptConfigContribution(context, definition = typescriptConfigPackageDefinition(context)) {
     return {
         definition,
         exposure: { exports: {}, imports: {} },
         manifest: {
             name: definition.name,
-            version: "0.0.0",
             private: true,
             files: ["base.json"],
             scripts: {
-                "format:check": "oxfmt --list-different --config ../../oxfmt.config.ts .",
-                "format:write": "oxfmt --write --config ../../oxfmt.config.ts .",
+                "format:check": "oxfmt --list-different .",
+                "format:write": "oxfmt --write .",
             },
             devDependencies: { oxfmt: "catalog:" },
             engines: { node: context.toolchain.nodeLtsMajor },
@@ -68,3 +68,7 @@ export function typescriptConfigContribution(context) {
         },
     };
 }
+export const typescriptConfigReplayAdapter = definePackageContributionReplayAdapter({
+    identity: "typescript-config",
+    replay: ({ context, packageDefinition }) => typescriptConfigContribution(context, packageDefinition),
+});

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

@@ -1,7 +1,7 @@
-import type { PackageContribution } from "#template-core/package-contribution";
-import type { GenerationContext } from "#template-core/preset-definition";
-import type { PackageDefinition } from "#template-core/project-blueprint-v2";
-import type { RenderOperation } from "#template-core/renderer";
+import type { PackageContribution } from "@ykdz/template-core/package-contribution";
+import type { GenerationContext } from "@ykdz/template-core/preset-definition";
+import type { PackageDefinition } from "@ykdz/template-core/project-blueprint";
+import type { RenderOperation } from "@ykdz/template-core/renderer";
 /** Vue's tooling peers need these repository policy overrides, never Core defaults. */
 export declare const vuePnpmDependencyOverrides: {
     readonly "pinia>typescript": "-";
@@ -31,4 +31,6 @@ export declare function vueApplicationManifest(options: {
     readonly context: GenerationContext;
     readonly definition: PackageDefinition;
     readonly scripts: Record<string, string>;
+    /** Vue-Hono's root owns its joint browser runner. */
+    readonly includePlaywright?: boolean;
 }): PackageContribution["manifest"];

package/node_modules/@ykdz/template-builtin-presets/dist/src/shared/vue.js

@@ -1,4 +1,4 @@
-import { playwrightBrowserAssetsEnvironmentNeed } from "#template-core/module-graph";
+import { playwrightBrowserAssetsEnvironmentNeed } from "@ykdz/template-core/module-graph";
 import { templateSources } from "../template-sources.js";
 import { browserTestDevelopmentContainerToolLayer } from "./development-container.js";
 import { typescriptConfigSourceOperation } from "./typescript.js";
@@ -26,10 +26,10 @@ export function vueApplicationScripts() {
     return {
         build: "vite build",
         dev: "vite",
-        "format:check": "oxfmt --list-different --config ../../oxfmt.config.ts .",
-        "format:write": "oxfmt --write --config ../../oxfmt.config.ts .",
-        lint: "oxlint --quiet --format=unix --config ../../oxlint.config.ts .",
-        "lint:fix": "oxlint --format=unix --config ../../oxlint.config.ts . --fix",
+        "format:check": "oxfmt --list-different .",
+        "format:write": "oxfmt --write .",
+        lint: "oxlint --quiet --format=unix .",
+        "lint:fix": "oxlint --format=unix . --fix",
         preview: "vite preview",
         test: "vitest run --reporter=agent --silent=passed-only",
         "test:e2e": "playwright test",
@@ -76,7 +76,6 @@ export function vueApplicationDevelopmentContainerToolLayers() {
 export function vueApplicationManifest(options) {
     return {
         name: options.definition.name,
-        version: "0.0.0",
         private: true,
         type: "module",
         ...vueApplicationExposure,
@@ -87,7 +86,9 @@ export function vueApplicationManifest(options) {
             vue: "catalog:",
         },
         devDependencies: {
-            "@playwright/test": "catalog:",
+            ...(options.includePlaywright === false
+                ? {}
+                : { "@playwright/test": "catalog:" }),
             "@tailwindcss/vite": "catalog:",
             "@types/node": "catalog:",
             "@types/web-bluetooth": "catalog:",

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

@@ -1,4 +1,4 @@
-import { type TemplateSourceHandle } from "#template-core/renderer";
+import { type TemplateSourceHandle } from "@ykdz/template-core/renderer";
 /** The sole owner of Built-in Presets Template Source references. */
 export declare const templateSources: {
     readonly foundation: TemplateSourceHandle;

package/node_modules/@ykdz/template-builtin-presets/dist/src/template-sources.js

@@ -1,6 +1,6 @@
 import path from "node:path";
 import { fileURLToPath } from "node:url";
-import { createTemplateSourceHandle, } from "#template-core/renderer";
+import { createTemplateSourceHandle, } from "@ykdz/template-core/renderer";
 function templateRoot(...segments) {
     const sourceDirectory = path.dirname(fileURLToPath(import.meta.url));
     const packageRootSegments = path.basename(path.dirname(sourceDirectory)) === "dist"

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

@@ -1,2 +1,31 @@
-import type { BuiltInPresetDefinition } from "#template-core/preset-definition";
-export declare const tsCliDefinition: BuiltInPresetDefinition;
+import { type GenerationContext } from "@ykdz/template-core/preset-definition";
+export declare const tsCliDefinition: {
+    metadata: {
+        name: string;
+        title: string;
+        description: string;
+    };
+    source: import("@ykdz/template-core/renderer").TemplateSourceHandle;
+    plannerSourceFile: string;
+    packageContributionReplayAdapters: import("@ykdz/template-core/preset-definition").PackageContributionReplayAdapter[];
+    initialPrimaryPackage: {
+        defaultLeafName: string;
+        role: "cli-tool";
+        defaultPackagePath: ({ packageLeafName }: {
+            readonly packageLeafName: string;
+        }) => string;
+        planInitialContribution({ context, resolvedPackageIdentity }: {
+            readonly context: GenerationContext;
+            readonly resolvedPackageIdentity: import("@ykdz/template-core/preset-definition").ResolvedPrimaryPackageIdentity;
+        }): import("@ykdz/template-core/preset-definition").PlannedPackageContribution;
+    };
+    defaultPackagePath({ packageLeafName }: {
+        readonly context: GenerationContext;
+        readonly packageLeafName: string;
+    }): string;
+    planPackageAddition({ context, packageLeafName, packagePath }: {
+        readonly context: GenerationContext;
+        readonly packageLeafName: string;
+        readonly packagePath: string;
+    }): import("@ykdz/template-core/preset-definition").PlannedPackageContribution;
+};