@ykdz/template 0.0.35 → 0.0.37

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

@@ -1,12 +1,35 @@
 import { fileURLToPath } from "node:url";
+import { definePackageContributionReplayAdapter, } from "@ykdz/template-core/preset-definition";
 import { typescriptConfigSourceOperation } from "../shared/typescript.js";
 import { templateSources } from "../template-sources.js";
+// 公开候选 engines.node 的唯一派生点：精确三段 nodeVersion 派生 `^<精确值>`，绝不从
+// nodeLtsMajor 猜 patch。新建候选缺失或非精确一律清楚失败；既有候选 replay 允许旧根只声明
+// 大版本，此时投影与磁盘原文相同的 `>=major`，由既有三方合并律保留，不引入磁盘 engines 接管。
+function publicationCandidateNodeEngine(toolchain, creationOrigin) {
+    const nodeVersion = toolchain.nodeVersion;
+    if (nodeVersion === undefined) {
+        if (creationOrigin === "existing-candidate-replay") {
+            return `>=${toolchain.nodeLtsMajor}`;
+        }
+        throw new Error("新建公开 ts-cli 发布候选要求 Generation Context 提供精确三段 toolchain.nodeVersion，实际缺失；不能从 nodeLtsMajor 猜 patch 派生公开 caret 范围。");
+    }
+    if (!/^\d+\.\d+\.\d+$/u.test(nodeVersion)) {
+        throw new Error(`公开 ts-cli 发布候选要求 toolchain.nodeVersion 为精确三段 Node 版本（例如 "24.16.0"），实际收到 ${JSON.stringify(nodeVersion)}。`);
+    }
+    if (nodeVersion.slice(0, nodeVersion.indexOf(".")) !== toolchain.nodeLtsMajor) {
+        throw new Error(`公开 ts-cli 发布候选的 toolchain.nodeVersion ${nodeVersion} 与 nodeLtsMajor ${toolchain.nodeLtsMajor} 大版本不一致。`);
+    }
+    return `^${nodeVersion}`;
+}
+function packagePathForLeaf(packageLeafName) {
+    return `packages/${packageLeafName}`;
+}
 function packageScripts() {
     return {
-        "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 --ignore-pattern node_modules .",
-        "lint:fix": "oxlint --format=unix --config ../../oxlint.config.ts . --fix",
+        "format:check": "oxfmt --list-different .",
+        "format:write": "oxfmt --write .",
+        lint: "oxlint --quiet --format=unix --ignore-pattern node_modules .",
+        "lint:fix": "oxlint --format=unix . --fix",
         build: "tsc -p tsconfig.build.json --pretty false",
         postbuild: "node -e \"if (process.platform !== 'win32') require('node:fs').chmodSync('dist/cli.js', 0o755)\"",
         typecheck: "tsc -p tsconfig.json --noEmit --pretty false",
@@ -16,27 +39,12 @@ function packageScripts() {
     };
 }
 function cliContribution(options) {
-    const definition = {
-        name: `@${options.context.scope}/${options.packageLeafName}`,
+    const definition = options.packageDefinition ?? {
+        name: `@${options.context.defaultPackageScope}/${options.packageLeafName}`,
         path: options.packagePath,
         role: "cli-tool",
     };
-    const exposure = {
-        exports: {
-            ".": {
-                source: "./src/main.ts",
-                types: "./dist/main.d.ts",
-                default: "./dist/main.js",
-            },
-        },
-        imports: {
-            "#main": {
-                source: "./src/main.ts",
-                types: "./src/main.ts",
-                default: "./dist/main.js",
-            },
-        },
-    };
+    const exposure = { exports: {}, imports: {} };
     const operations = [
         {
             kind: "writeJson",
@@ -71,16 +79,14 @@ function cliContribution(options) {
         {
             kind: "copyFile",
             source: templateSources.tsCli,
-            from: "src/main.ts",
-            to: `${definition.path}/src/main.ts`,
+            from: "src/cli-command-identity.ts",
+            to: `${definition.path}/src/cli-command-identity.ts`,
         },
         {
-            kind: "replaceAnchors",
-            path: `${definition.path}/src/main.ts`,
-            language: "typescript",
-            replacements: {
-                "cli-command-name": `const commandName = ${JSON.stringify(options.packageLeafName)};`,
-            },
+            kind: "copyFile",
+            source: templateSources.tsCli,
+            from: "src/main.ts",
+            to: `${definition.path}/src/main.ts`,
         },
         {
             kind: "copyFile",
@@ -91,16 +97,14 @@ function cliContribution(options) {
         {
             kind: "copyFile",
             source: templateSources.tsCli,
-            from: "test/integration/command.test.ts",
-            to: `${definition.path}/test/integration/command.test.ts`,
+            from: "test/unit/cli-command-identity.test.ts",
+            to: `${definition.path}/test/unit/cli-command-identity.test.ts`,
         },
         {
-            kind: "replaceAnchors",
-            path: `${definition.path}/test/integration/command.test.ts`,
-            language: "typescript",
-            replacements: {
-                "cli-test-command-name": `commandName = ${JSON.stringify(options.packageLeafName)};`,
-            },
+            kind: "copyFile",
+            source: templateSources.tsCli,
+            from: "test/integration/command.test.ts",
+            to: `${definition.path}/test/integration/command.test.ts`,
         },
         {
             kind: "copyFile",
@@ -126,12 +130,10 @@ function cliContribution(options) {
         exposure,
         manifest: {
             name: definition.name,
-            version: "0.0.0",
-            publishConfig: { access: "public" },
+            private: true,
             files: ["dist"],
             type: "module",
             bin: { [options.packageLeafName]: "./dist/cli.js" },
-            ...exposure,
             scripts: packageScripts(),
             dependencies: { commander: "catalog:" },
             devDependencies: {
@@ -140,15 +142,24 @@ function cliContribution(options) {
                 oxlint: "catalog:",
                 "oxlint-tsgolint": "catalog:",
                 "typescript-7": "catalog:",
+                vite: "catalog:",
                 vitest: "catalog:",
             },
-            engines: { node: `>=${options.context.toolchain.nodeLtsMajor}` },
+            engines: {
+                node: options.publicationCandidate
+                    ? publicationCandidateNodeEngine(options.context.toolchain, options.creationOrigin)
+                    : `>=${options.context.toolchain.nodeLtsMajor}`,
+            },
         },
         operations,
         environmentNeeds: [],
         foundation: {
+            ...(options.publicationCandidate
+                ? { npmPublication: { kind: "public-cli-candidate" } }
+                : {}),
             toolchains: {},
             editorCapabilities: ["oxc-format-lint"],
+            typescriptConfigurationPackage: { dependency: "required" },
             dependencyMaintenance: {
                 ecosystems: ["npm", "github-actions", "docker"],
                 interval: "weekly",
@@ -156,37 +167,73 @@ function cliContribution(options) {
         },
     };
 }
+const cliPublicationCandidateReplayAdapter = definePackageContributionReplayAdapter({
+    identity: "cli-publication-candidate",
+    replay: ({ context, packageDefinition, packageLeafName, planningContribution, }) => {
+        if (planningContribution !== "planInitialization") {
+            throw new Error("cli-publication-candidate replay identity requires planInitialization provenance");
+        }
+        return cliContribution({
+            context,
+            packageLeafName,
+            packagePath: packageDefinition.path,
+            packageDefinition,
+            publicationCandidate: true,
+            creationOrigin: "existing-candidate-replay",
+        });
+    },
+});
+const cliPackageAdditionReplayAdapter = definePackageContributionReplayAdapter({
+    identity: "cli-package-addition",
+    replay: ({ context, packageDefinition, packageLeafName, planningContribution, }) => {
+        if (planningContribution !== "planPackageAddition") {
+            throw new Error("cli-package-addition replay identity requires planPackageAddition provenance");
+        }
+        return cliContribution({
+            context,
+            packageLeafName,
+            packagePath: packageDefinition.path,
+            packageDefinition,
+            publicationCandidate: false,
+        });
+    },
+});
 export const tsCliDefinition = {
     metadata: {
         name: "ts-cli",
-        title: "TypeScript CLI",
-        description: "Publishable TypeScript command-line package.",
+        title: "TypeScript 命令行工具",
+        description: "TypeScript 命令行包。",
     },
     source: templateSources.tsCli,
     plannerSourceFile: fileURLToPath(import.meta.url),
-    blueprint(context) {
-        return {
-            schemaVersion: 2,
-            packages: [
-                cliContribution({
-                    context,
-                    packageLeafName: context.projectName,
-                    packagePath: `packages/${context.projectName}`,
-                }).definition,
-            ],
-        };
-    },
-    planInitialization(context) {
-        return cliContribution({
-            context,
-            packageLeafName: context.projectName,
-            packagePath: `packages/${context.projectName}`,
-        });
+    packageContributionReplayAdapters: [
+        cliPublicationCandidateReplayAdapter,
+        cliPackageAdditionReplayAdapter,
+    ],
+    initialPrimaryPackage: {
+        defaultLeafName: "cli",
+        role: "cli-tool",
+        defaultPackagePath: ({ packageLeafName }) => packagePathForLeaf(packageLeafName),
+        planInitialContribution({ context, resolvedPackageIdentity }) {
+            return cliPublicationCandidateReplayAdapter.identify(cliContribution({
+                context,
+                packageLeafName: resolvedPackageIdentity.leafName,
+                packagePath: resolvedPackageIdentity.definition.path,
+                packageDefinition: resolvedPackageIdentity.definition,
+                publicationCandidate: true,
+                creationOrigin: "new-publication-candidate",
+            }));
+        },
     },
     defaultPackagePath({ packageLeafName }) {
-        return `packages/${packageLeafName}`;
+        return packagePathForLeaf(packageLeafName);
     },
     planPackageAddition({ context, packageLeafName, packagePath }) {
-        return cliContribution({ context, packageLeafName, packagePath });
+        return cliPackageAdditionReplayAdapter.identify(cliContribution({
+            context,
+            packageLeafName,
+            packagePath,
+            publicationCandidate: false,
+        }));
     },
 };

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

@@ -1,2 +1,31 @@
-import type { BuiltInPresetDefinition } from "#template-core/preset-definition";
-export declare const tsLibDefinition: BuiltInPresetDefinition;
+import { type GenerationContext } from "@ykdz/template-core/preset-definition";
+export declare const tsLibDefinition: {
+    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: "shared-library";
+        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/ts-lib/definition.js

@@ -1,19 +1,23 @@
 import { fileURLToPath } from "node:url";
+import { definePackageContributionReplayAdapter, } from "@ykdz/template-core/preset-definition";
 import { typescriptConfigSourceOperation } from "../shared/typescript.js";
 import { templateSources } from "../template-sources.js";
+function packagePathForLeaf(packageLeafName) {
+    return `packages/${packageLeafName}`;
+}
 function packageScripts() {
     return {
-        "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 --ignore-pattern node_modules .",
-        "lint:fix": "oxlint --format=unix --config ../../oxlint.config.ts . --fix",
+        "format:check": "oxfmt --list-different .",
+        "format:write": "oxfmt --write .",
+        lint: "oxlint --quiet --format=unix --ignore-pattern node_modules .",
+        "lint:fix": "oxlint --format=unix . --fix",
         build: "tsc -p tsconfig.build.json --pretty false",
         typecheck: "tsc -p tsconfig.json --noEmit --pretty false",
     };
 }
 function libraryContribution(options) {
-    const definition = {
-        name: `@${options.context.scope}/${options.packageLeafName}`,
+    const definition = options.packageDefinition ?? {
+        name: `@${options.context.defaultPackageScope}/${options.packageLeafName}`,
         path: options.packagePath,
         role: "shared-library",
     };
@@ -71,7 +75,6 @@ function libraryContribution(options) {
         exposure,
         manifest: {
             name: definition.name,
-            version: "0.0.0",
             private: true,
             type: "module",
             ...exposure,
@@ -91,6 +94,7 @@ function libraryContribution(options) {
         foundation: {
             toolchains: {},
             editorCapabilities: ["oxc-format-lint"],
+            typescriptConfigurationPackage: { dependency: "required" },
             dependencyMaintenance: {
                 ecosystems: ["npm", "github-actions", "docker"],
                 interval: "weekly",
@@ -98,37 +102,41 @@ function libraryContribution(options) {
         },
     };
 }
+const libraryReplayAdapter = definePackageContributionReplayAdapter({
+    identity: "library",
+    replay: ({ context, packageDefinition, packageLeafName }) => libraryContribution({
+        context,
+        packageLeafName,
+        packagePath: packageDefinition.path,
+        packageDefinition,
+    }),
+});
 export const tsLibDefinition = {
     metadata: {
         name: "ts-lib",
-        title: "TypeScript library",
-        description: "Strict TypeScript package with pnpm catalog tooling.",
+        title: "TypeScript 库",
+        description: "采用 pnpm catalog 工具配置的严格 TypeScript 包。",
     },
     source: templateSources.tsLib,
     plannerSourceFile: fileURLToPath(import.meta.url),
-    blueprint(context) {
-        return {
-            schemaVersion: 2,
-            packages: [
-                libraryContribution({
-                    context,
-                    packageLeafName: context.projectName,
-                    packagePath: `packages/${context.projectName}`,
-                }).definition,
-            ],
-        };
-    },
-    planInitialization(context) {
-        return libraryContribution({
-            context,
-            packageLeafName: context.projectName,
-            packagePath: `packages/${context.projectName}`,
-        });
+    packageContributionReplayAdapters: [libraryReplayAdapter],
+    initialPrimaryPackage: {
+        defaultLeafName: "lib",
+        role: "shared-library",
+        defaultPackagePath: ({ packageLeafName }) => packagePathForLeaf(packageLeafName),
+        planInitialContribution({ context, resolvedPackageIdentity }) {
+            return libraryReplayAdapter.identify(libraryContribution({
+                context,
+                packageLeafName: resolvedPackageIdentity.leafName,
+                packagePath: resolvedPackageIdentity.definition.path,
+                packageDefinition: resolvedPackageIdentity.definition,
+            }));
+        },
     },
     defaultPackagePath({ packageLeafName }) {
-        return `packages/${packageLeafName}`;
+        return packagePathForLeaf(packageLeafName);
     },
     planPackageAddition({ context, packageLeafName, packagePath }) {
-        return libraryContribution({ context, packageLeafName, packagePath });
+        return libraryReplayAdapter.identify(libraryContribution({ context, packageLeafName, packagePath }));
     },
 };

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

@@ -1,2 +1,48 @@
-import type { BuiltInPresetDefinition } from "#template-core/preset-definition";
-export declare const vikeAppDefinition: BuiltInPresetDefinition;
+import { type GenerationContext } from "@ykdz/template-core/preset-definition";
+import type { PackageDefinition } from "@ykdz/template-core/project-blueprint";
+type VikePackageDefinitions = {
+    readonly web: PackageDefinition;
+    readonly db: PackageDefinition;
+    readonly migrations: PackageDefinition;
+};
+export declare function createVikeAppDefinition(resolvePackageDefinitions?: (context: GenerationContext) => VikePackageDefinitions): {
+    metadata: {
+        name: string;
+        title: string;
+        description: string;
+    };
+    source: import("@ykdz/template-core/renderer").TemplateSourceHandle;
+    plannerSourceFile: string;
+    packageContributionReplayAdapters: import("@ykdz/template-core/preset-definition").PackageContributionReplayAdapter[];
+    blueprint(context: GenerationContext): {
+        schemaVersion: 3;
+        packages: PackageDefinition[];
+        packageLinkIntents: {
+            consumerPackagePath: string;
+            providerPackagePath: string;
+        }[];
+    };
+    planInitialization(context: GenerationContext): import("@ykdz/template-core/preset-definition").PlannedPackageContribution;
+    planInitializationContributions(context: GenerationContext): import("@ykdz/template-core/preset-definition").PlannedPackageContribution[];
+};
+export declare const vikeAppDefinition: {
+    metadata: {
+        name: string;
+        title: string;
+        description: string;
+    };
+    source: import("@ykdz/template-core/renderer").TemplateSourceHandle;
+    plannerSourceFile: string;
+    packageContributionReplayAdapters: import("@ykdz/template-core/preset-definition").PackageContributionReplayAdapter[];
+    blueprint(context: GenerationContext): {
+        schemaVersion: 3;
+        packages: PackageDefinition[];
+        packageLinkIntents: {
+            consumerPackagePath: string;
+            providerPackagePath: string;
+        }[];
+    };
+    planInitialization(context: GenerationContext): import("@ykdz/template-core/preset-definition").PlannedPackageContribution;
+    planInitializationContributions(context: GenerationContext): import("@ykdz/template-core/preset-definition").PlannedPackageContribution[];
+};
+export {};