@ykdz/template 0.0.40 → 0.0.42

package/node_modules/@ykdz/template-builtin-presets/templates/foundation/typescript-config/turbo.json

@@ -1,4 +1,33 @@
 {
   "extends": ["//"],
-  "tags": ["library"]
+  "tags": ["library"],
+  "tasks": {
+    "build": {
+      "dependsOn": ["^build"],
+      "inputs": [],
+      "outputs": []
+    },
+    "format:check": {
+      "inputs": [],
+      "outputs": [],
+      "tags": ["quality:light"]
+    },
+    "format:write": {
+      "dependsOn": ["lint:fix"],
+      "inputs": [],
+      "outputs": [],
+      "cache": false,
+      "tags": ["work:repair"]
+    },
+    "lint:fix": {
+      "inputs": [],
+      "outputs": [],
+      "cache": false
+    },
+    "typecheck": {
+      "dependsOn": ["^typecheck"],
+      "inputs": [],
+      "outputs": []
+    }
+  }
 }

package/node_modules/@ykdz/template-builtin-presets/templates/rust-bin/devcontainer/rust.Dockerfile

@@ -3,13 +3,9 @@ ENV RUSTUP_HOME=/usr/local/rustup
 ENV CARGO_HOME=/usr/local/cargo
 
 RUN apt-get update && apt-get install -y --no-install-recommends \
-    ca-certificates \
-    curl \
     gcc \
-    git \
     libc6-dev \
-    && rm -rf /var/lib/apt/lists/* \
-    && git config --system init.defaultBranch main
+    && rm -rf /var/lib/apt/lists/*
 RUN curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | \
     sh -s -- -y --profile minimal --default-toolchain none \
     && "${CARGO_HOME}/bin/rustup" toolchain install ${RUST_TOOLCHAIN} --profile minimal --component rustfmt --component clippy \

package/node_modules/@ykdz/template-builtin-presets/templates/rust-bin/tsconfig.scripts.json

@@ -0,0 +1,12 @@
+{
+  "extends": "{{TYPESCRIPT_CONFIG_PACKAGE}}/base.json",
+  "compilerOptions": {
+    "customConditions": ["source"],
+    "module": "nodenext",
+    "moduleResolution": "nodenext",
+    "noEmit": true,
+    "target": "es2024",
+    "types": ["node"]
+  },
+  "include": ["scripts/**/*.ts"]
+}

package/node_modules/@ykdz/template-builtin-presets/templates/rust-bin/turbo.json

@@ -4,19 +4,34 @@
   "tasks": {
     "format:check": {
       "dependsOn": ["//#toolchain:prepare"],
-      "outputs": []
+      "inputs": [],
+      "outputs": [],
+      "tags": ["quality:light"]
     },
     "format:write": {
       "dependsOn": ["//#toolchain:prepare"],
-      "cache": false
+      "inputs": [],
+      "outputs": [],
+      "cache": false,
+      "tags": ["work:repair"]
     },
     "lint": {
       "dependsOn": ["//#toolchain:prepare"],
-      "outputs": []
+      "inputs": [],
+      "outputs": [],
+      "tags": ["quality:light"]
     },
     "test": {
       "dependsOn": ["//#toolchain:prepare"],
-      "outputs": []
+      "inputs": [],
+      "outputs": [],
+      "tags": ["quality:light"]
+    },
+    "typecheck": {
+      "dependsOn": ["^typecheck"],
+      "inputs": [],
+      "outputs": [],
+      "tags": ["quality:light"]
     }
   }
 }

package/node_modules/@ykdz/template-builtin-presets/templates/shared/devcontainer/github-cli.Dockerfile

@@ -1,6 +1,4 @@
-RUN apt-get update \
-    && apt-get install -y --no-install-recommends curl \
-    && install -m 0755 -d /etc/apt/keyrings \
+RUN install -m 0755 -d /etc/apt/keyrings \
     && curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg -o /etc/apt/keyrings/githubcli-archive-keyring.gpg \
     && chmod go+r /etc/apt/keyrings/githubcli-archive-keyring.gpg \
     && echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" > /etc/apt/sources.list.d/github-cli.list \

package/node_modules/@ykdz/template-builtin-presets/templates/shared/vue/TESTING.md

@@ -0,0 +1,7 @@
+# 测试约定
+
+前端包的 `pnpm test` 使用 Vitest 的 `node` 项目运行逻辑测试；`pnpm test:browser` 使用 `browser` 项目在 Chromium 中运行组件测试。Vitest Browser Mode 通过 Playwright provider 启动真实浏览器，测试文件按运行环境命名：`*.node.test.ts` 和 `*.browser.test.ts`。
+
+可复用的业务逻辑、状态管理和纯函数放在 Node 测试中。组件测试通过 `vitest-browser-vue` 渲染真实 Vue 组件，优先按角色和可访问名称查找控件，再执行点击、输入等用户操作并检查可见结果。默认 `render` 会在下个测试开始前清理组件；按组件真实需要配置插件，若使用 Pinia，每个测试都应创建独立实例，避免测试之间共享状态。
+
+`pnpm test` 与 `pnpm test:browser` 选择互斥项目。Playwright Test 的 `pnpm test:e2e` 用于覆盖跨页面、服务或持久化流程中的关键用户旅程；组件内部的交互由 Browser Mode 验证，避免在端到端测试中重复这些细节。

package/node_modules/@ykdz/template-builtin-presets/templates/shared/vue/src/components/CounterButton.vue

@@ -0,0 +1,18 @@
+<script setup lang="ts">
+import { storeToRefs } from "pinia";
+
+import { useCounterStore } from "#/stores/counter";
+
+const counter = useCounterStore();
+const { count } = storeToRefs(counter);
+</script>
+
+<template>
+  <button
+    class="rounded bg-cyan-300 px-4 py-2 font-semibold text-slate-950 hover:bg-cyan-200"
+    type="button"
+    @click="counter.increment()"
+  >
+    计数：{{ count }}
+  </button>
+</template>

package/node_modules/@ykdz/template-builtin-presets/templates/shared/vue/test/counter.browser.test.ts

@@ -0,0 +1,16 @@
+import { createPinia } from "pinia";
+import { expect, it } from "vitest";
+import { render } from "vitest-browser-vue";
+
+import CounterButton from "../src/components/CounterButton.vue";
+
+it("increments the Pinia counter when clicked", async () => {
+  const screen = await render(CounterButton, {
+    global: { plugins: [createPinia()] },
+  });
+  const button = screen.getByRole("button", { name: /计数/ });
+
+  await expect.element(button).toHaveTextContent("计数：0");
+  await button.click();
+  await expect.element(button).toHaveTextContent("计数：1");
+});

package/node_modules/@ykdz/template-builtin-presets/templates/shared/vue/test/{app.test.ts → counter.node.test.ts}

@@ -1,4 +1,5 @@
 import { createPinia, setActivePinia } from "pinia";
+import { describe, expect, it } from "vitest";
 
 import { useCounterStore } from "#/stores/counter";
 

package/node_modules/@ykdz/template-builtin-presets/templates/shared/vue/tsconfig.test.json

@@ -4,7 +4,7 @@
     "customConditions": ["source"],
     "lib": ["ESNext", "DOM", "DOM.Iterable"],
     "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.test.tsbuildinfo",
-    "types": ["node", "vitest/globals", "web-bluetooth"]
+    "types": ["node", "web-bluetooth"]
   },
   "include": ["env.d.ts", "src/**/*.ts", "src/**/*.vue", "test/**/*.ts"]
 }

package/node_modules/@ykdz/template-builtin-presets/templates/shared/vue/vitest.config.ts

@@ -0,0 +1,50 @@
+import { playwright } from "@vitest/browser-playwright";
+import type { ConfigEnv, UserConfig, UserConfigExport } from "vite";
+import { defineConfig, mergeConfig } from "vitest/config";
+
+import viteConfig from "./vite.config.ts";
+
+function resolveViteConfig(
+  config: UserConfigExport,
+  configEnv: ConfigEnv,
+): UserConfig | Promise<UserConfig> {
+  return typeof config === "function" ? config(configEnv) : config;
+}
+
+export default defineConfig(async (configEnv) => {
+  const baseConfig = await resolveViteConfig(viteConfig, configEnv);
+
+  return mergeConfig(
+    baseConfig,
+    defineConfig({
+      test: {
+        attachmentsDir: ".vitest/attachments",
+        exclude: ["test/e2e/**", "node_modules/**", "dist/**"],
+        projects: [
+          {
+            extends: true,
+            test: {
+              name: "node",
+              include: ["test/**/*.node.test.ts"],
+              environment: "node",
+            },
+          },
+          {
+            extends: true,
+            test: {
+              name: "browser",
+              include: ["test/**/*.browser.test.ts"],
+              browser: {
+                enabled: true,
+                provider: playwright(),
+                headless: true,
+                screenshotFailures: true,
+                instances: [{ browser: "chromium" }],
+              },
+            },
+          },
+        ],
+      },
+    }),
+  );
+});

package/node_modules/@ykdz/template-builtin-presets/templates/ts-cli/publication/check-artifact.ts

@@ -14,6 +14,8 @@ function oneLine(value: string): string {
 const rawArguments = process.argv.slice(2);
 const arguments_ =
   rawArguments[0] === "--" ? rawArguments.slice(1) : rawArguments;
+const requiredSetting = process.env.PUBLICATION_ARTIFACT_REQUIRED;
+const required = requiredSetting === "true";
 const outputDirectoryFromEnvironment =
   process.env.PUBLICATION_ARTIFACT_OUTPUT_DIRECTORY;
 const explicitOutputDirectory =
@@ -30,9 +32,10 @@ const environmentOutputDirectory =
       ? null
       : outputDirectoryFromEnvironment;
 const validArguments =
-  (arguments_.length === 0 && environmentOutputDirectory !== null) ||
-  (explicitOutputDirectory !== undefined &&
-    environmentOutputDirectory === undefined);
+  (requiredSetting === undefined || required) &&
+  ((arguments_.length === 0 && environmentOutputDirectory !== null) ||
+    (explicitOutputDirectory !== undefined &&
+      environmentOutputDirectory === undefined));
 if (!validArguments) {
   console.error("ERROR publication-artifact-usage");
   console.error(`Observed: ${JSON.stringify(arguments_)}`);
@@ -57,7 +60,16 @@ if (!validArguments) {
       outputDirectory,
     });
     if (result.kind === "blocked") {
-      console.log("npm publication artifact: blocked");
+      if (result.readiness.mode === "safe-unconfigured") {
+        console.log("发布制品验收未执行：候选尚未满足公开发布条件。");
+        if (required) {
+          console.error("ERROR publication-artifact-required");
+          process.exitCode = 1;
+        }
+      } else {
+        console.log("npm publication artifact: blocked");
+        process.exitCode = 1;
+      }
       console.log(`Mode: ${result.readiness.mode}`);
       for (const item of result.readiness.blockers) {
         console.log(`BLOCKER ${item.code}`);
@@ -66,7 +78,6 @@ if (!validArguments) {
         console.log(`Expected: ${oneLine(item.expected)}`);
         console.log(`Next action: ${oneLine(item.nextAction)}`);
       }
-      if (result.readiness.mode === "public-intent") process.exitCode = 1;
     } else if (result.kind === "failed") {
       console.error(`ERROR ${result.failure.code}`);
       console.error(`Observed: ${oneLine(result.failure.observed)}`);

package/node_modules/@ykdz/template-builtin-presets/templates/ts-cli/publication/release.yml

@@ -45,10 +45,13 @@ jobs:
         run: |
           mkdir -p "$RUNNER_TEMP/npm-publication-artifact"
           test -z "$(find "$RUNNER_TEMP/npm-publication-artifact" -mindepth 1 -print -quit)"
-      - name: Run Root Check once
-        run: pnpm run check
+      - name: Run Full Check once
+        run: node --conditions=source scripts/task-gates.ts check:full
+      - name: Verify publication artifact
+        run: pnpm run publication:artifact
         env:
           PUBLICATION_ARTIFACT_OUTPUT_DIRECTORY: ${{ runner.temp }}/npm-publication-artifact
+          PUBLICATION_ARTIFACT_REQUIRED: "true"
       - name: Upload verified npm artifact
         uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
         with:

package/node_modules/@ykdz/template-builtin-presets/templates/ts-cli/publication/turbo.json

@@ -1,6 +1,9 @@
 {
   "tasks": {
-    "//#publication:artifact": { "cache": false },
-    "//#publication:readiness": { "cache": false }
+    "//#publication:artifact": {
+      "cache": false,
+      "tags": ["quality:conditional"]
+    },
+    "//#publication:readiness": { "cache": false, "tags": ["work:release"] }
   }
 }

package/node_modules/@ykdz/template-builtin-presets/templates/ts-cli/publication-setup/bridge.ts

@@ -714,7 +714,7 @@ async function configure() {
     stop(
       "public-fact-invalid",
       "invalid command name",
-      "a portable unreserved CLI command name",
+      "符合命名格式的 CLI 命令名",
       "Correct --bin and retry.",
       2,
     );

package/node_modules/@ykdz/template-builtin-presets/templates/ts-cli/src/cli-command-identity.ts

@@ -3,46 +3,6 @@ export type CliCommandIdentity = {
   readonly version: string;
 };
 
-const reservedSystemToolNames = new Set([
-  "aux",
-  "bash",
-  "bun",
-  "cmd",
-  "com1",
-  "com2",
-  "com3",
-  "com4",
-  "com5",
-  "com6",
-  "com7",
-  "com8",
-  "com9",
-  "con",
-  "corepack",
-  "deno",
-  "git",
-  "lpt1",
-  "lpt2",
-  "lpt3",
-  "lpt4",
-  "lpt5",
-  "lpt6",
-  "lpt7",
-  "lpt8",
-  "lpt9",
-  "node",
-  "nul",
-  "npm",
-  "npx",
-  "pnpm",
-  "powershell",
-  "prn",
-  "pwsh",
-  "sh",
-  "yarn",
-  "zsh",
-]);
-
 export function validateCliCommandName(
   commandName: string,
   occupiedCommandNames: readonly string[] = [],
@@ -72,11 +32,6 @@ export function validateCliCommandName(
       `CLI command name must use lowercase ASCII letters, digits, and single hyphens; received ${JSON.stringify(commandName)}`,
     );
   }
-  if (reservedSystemToolNames.has(commandName)) {
-    throw new Error(
-      `CLI command name is a reserved system tool; received ${JSON.stringify(commandName)}`,
-    );
-  }
   if (occupiedCommandNames.includes(commandName)) {
     throw new Error(
       `CLI command name is already used by another workspace package; received ${JSON.stringify(commandName)}`,

package/node_modules/@ykdz/template-builtin-presets/templates/ts-cli/test/e2e/run-journeys.test.ts

@@ -0,0 +1,11 @@
+import assert from "node:assert/strict";
+import { test } from "node:test";
+
+import { runJourneys } from "./run-journeys.ts";
+
+for (const mode of ["source", "distribution"] as const) {
+  void test(`runs all ${mode} CLI journeys`, { timeout: 180_000 }, async () => {
+    const passed = await runJourneys({ mode });
+    assert.notStrictEqual(passed.length, 0);
+  });
+}

package/node_modules/@ykdz/template-builtin-presets/templates/ts-cli/test/integration/command.test.ts

@@ -1,6 +1,6 @@
+import assert from "node:assert/strict";
 import { createRequire } from "node:module";
-
-import { describe, expect, it } from "vitest";
+import { describe, it } from "node:test";
 
 import { cliCommandIdentity } from "../../src/cli-command-identity.ts";
 import { runCli, type CliRuntime } from "../../src/main.ts";
@@ -23,62 +23,63 @@ function testRuntime(args: readonly string[]) {
   return { runtime, stdout: () => stdout, stderr: () => stderr };
 }
 
-describe("CLI 契约", () => {
-  it("查询成功默认返回结构化数据，也支持中文文本", async () => {
+void describe("CLI 契约", () => {
+  void it("查询成功默认返回结构化数据，也支持中文文本", async () => {
     const output = testRuntime(["lookup", "ada"]);
-    expect(await runCli(output.runtime)).toBe(0);
-    expect(JSON.parse(output.stdout())).toEqual({
+    assert.equal(await runCli(output.runtime), 0);
+    assert.deepStrictEqual(JSON.parse(output.stdout()), {
       schemaVersion: "1",
       command: "lookup",
       kind: "data",
       variant: "found",
       data: { name: "ada", title: "Ada Lovelace" },
     });
-    expect(output.stderr()).toBe("");
+    assert.equal(output.stderr(), "");
     const human = testRuntime(["lookup", "ada", "--output-format", "text"]);
-    expect(await runCli(human.runtime)).toBe(0);
-    expect(human.stdout()).toContain("找到记录");
-    expect(human.stdout()).toContain("Ada Lovelace");
+    assert.equal(await runCli(human.runtime), 0);
+    assert.ok(human.stdout().includes("找到记录"));
+    assert.ok(human.stdout().includes("Ada Lovelace"));
   });
 
-  it("未找到记录是已声明失败，非法名称是用法错误", async () => {
+  void it("未找到记录是已声明失败，非法名称是用法错误", async () => {
     const missing = testRuntime(["lookup", "missing"]);
-    expect(await runCli(missing.runtime)).toBe(1);
-    expect(missing.stdout()).toBe("");
-    expect(JSON.parse(missing.stderr())).toMatchObject({
+    assert.equal(await runCli(missing.runtime), 1);
+    assert.equal(missing.stdout(), "");
+    assert.partialDeepStrictEqual(JSON.parse(missing.stderr()), {
       kind: "failure",
       variant: "notFound",
       data: { name: "missing" },
     });
     for (const args of [["lookup"], ["lookup", "   "]]) {
       const invalid = testRuntime([...args, "--output-format", "text"]);
-      expect(await runCli(invalid.runtime)).toBe(2);
-      expect(invalid.stdout()).toBe("");
-      expect(JSON.parse(invalid.stderr())).toMatchObject({
+      assert.equal(await runCli(invalid.runtime), 2);
+      assert.equal(invalid.stdout(), "");
+      assert.partialDeepStrictEqual(JSON.parse(invalid.stderr()), {
         kind: "usageFailure",
       });
     }
   });
 
-  it("帮助和版本使用 manifest 身份，schema 导出完整契约", async () => {
+  void it("帮助和版本使用 manifest 身份，schema 导出完整契约", async () => {
     const version = testRuntime(["--version"]);
-    expect(await runCli(version.runtime)).toBe(0);
-    expect(version.stdout()).toBe(
+    assert.equal(await runCli(version.runtime), 0);
+    assert.equal(
+      version.stdout(),
       `${identity.commandName} ${identity.version}\n`,
     );
     const help = testRuntime(["--help"]);
-    expect(await runCli(help.runtime)).toBe(0);
-    expect(help.stdout()).toContain(identity.commandName);
-    expect(help.stdout()).toContain("lookup");
-    expect(help.stdout()).toContain("schema");
+    assert.equal(await runCli(help.runtime), 0);
+    assert.ok(help.stdout().includes(identity.commandName));
+    assert.ok(help.stdout().includes("lookup"));
+    assert.ok(help.stdout().includes("schema"));
     const schema = testRuntime(["schema"]);
-    expect(await runCli(schema.runtime)).toBe(0);
+    assert.equal(await runCli(schema.runtime), 0);
     const humanSchema = testRuntime(["schema", "--output-format", "text"]);
-    expect(await runCli(humanSchema.runtime)).toBe(0);
-    expect(humanSchema.stdout()).toContain("CLI 契约");
-    expect(humanSchema.stdout()).toContain('"commands"');
+    assert.equal(await runCli(humanSchema.runtime), 0);
+    assert.ok(humanSchema.stdout().includes("CLI 契约"));
+    assert.ok(humanSchema.stdout().includes('"commands"'));
     const manifest = JSON.parse(schema.stdout()).data.manifest;
-    expect(manifest).toMatchObject({
+    assert.partialDeepStrictEqual(manifest, {
       commands: {
         lookup: {
           input: {
@@ -102,41 +103,44 @@ describe("CLI 契约", () => {
     });
   });
 
-  it("等待输出完成，仅 stdout EPIPE 安静成功", async () => {
+  void it("等待输出完成，仅 stdout EPIPE 安静成功", async () => {
     const output = testRuntime(["lookup", "ada"]);
-    expect(
+    assert.equal(
       await runCli({
         ...output.runtime,
         write: async () => {
           throw Object.assign(new Error("pipe"), { code: "EPIPE" });
         },
       }),
-    ).toBe(0);
-    expect(
+      0,
+    );
+    assert.equal(
       await runCli({
         ...output.runtime,
         write: async () => {
           throw new Error("disk");
         },
       }),
-    ).toBe(70);
+      70,
+    );
     const failure = testRuntime(["lookup", "missing"]);
-    expect(
+    assert.equal(
       await runCli({
         ...failure.runtime,
         write: async () => {
           throw Object.assign(new Error("pipe"), { code: "EPIPE" });
         },
       }),
-    ).toBe(70);
+      70,
+    );
     const argv = ["node", identity.commandName];
     Object.defineProperty(argv, "slice", {
       value() {
         throw new Error("内部细节");
       },
     });
-    expect(await runCli({ ...output.runtime, argv })).toBe(70);
-    expect(output.stderr()).toContain("命令执行失败");
-    expect(output.stderr()).not.toContain("内部细节");
+    assert.equal(await runCli({ ...output.runtime, argv }), 70);
+    assert.ok(output.stderr().includes("命令执行失败"));
+    assert.ok(!output.stderr().includes("内部细节"));
   });
 });