@ykdz/template 0.0.42 → 0.1.0-experimental.0

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

@@ -1,255 +0,0 @@
-import { spawn } from "node:child_process";
-import { mkdtemp, readdir, rm } from "node:fs/promises";
-import { tmpdir } from "node:os";
-import path from "node:path";
-import { fileURLToPath, pathToFileURL } from "node:url";
-
-import type {
-  CliJourney,
-  CliJourneyCommand,
-  CliJourneyMode,
-  CliJourneyResult,
-} from "./journey.ts";
-
-const e2eRoot = path.dirname(fileURLToPath(import.meta.url));
-const packageRoot = path.resolve(e2eRoot, "..", "..");
-
-function assertNever(value: never): never {
-  throw new Error(`unsupported journey mode: ${String(value)}`);
-}
-
-type JourneyRunTarget = {
-  readonly mode: CliJourneyMode;
-  readonly packedBin?: string;
-};
-
-const journeyRunnerUsage = [
-  "Usage:",
-  "  run-journeys.ts <source|distribution> [source|distribution ...]",
-  "  run-journeys.ts packed <bin-path>",
-].join("\n");
-
-function invalidArguments(message: string): never {
-  throw new Error(`${message}\n${journeyRunnerUsage}`);
-}
-
-function parseJourneyRunTargets(
-  args: readonly string[],
-): readonly JourneyRunTarget[] {
-  const first = args[0];
-  if (first === undefined) {
-    invalidArguments("missing journey mode");
-  }
-
-  if (first === "packed") {
-    if (args.length === 1) {
-      invalidArguments("packed journey mode requires exactly one bin path");
-    }
-    if (args.length !== 2) {
-      invalidArguments(
-        "packed journey mode accepts exactly one bin path and cannot be combined with other modes",
-      );
-    }
-    const packedBin = args[1]!;
-    if (
-      packedBin === "source" ||
-      packedBin === "distribution" ||
-      packedBin === "packed"
-    ) {
-      invalidArguments(
-        `packed bin path cannot be journey mode ${JSON.stringify(packedBin)}`,
-      );
-    }
-    return [{ mode: "packed", packedBin }];
-  }
-
-  const seen = new Set<CliJourneyMode>();
-  const targets: JourneyRunTarget[] = [];
-  for (const argument of args) {
-    switch (argument) {
-      case "source":
-      case "distribution":
-        if (seen.has(argument)) {
-          invalidArguments(
-            `duplicate journey mode ${JSON.stringify(argument)}; each mode may be specified once`,
-          );
-        }
-        seen.add(argument);
-        targets.push({ mode: argument });
-        break;
-      case "packed":
-        invalidArguments(
-          "packed journey mode cannot be combined with source or distribution",
-        );
-      default:
-        invalidArguments(
-          `unknown journey mode ${JSON.stringify(argument)}; expected source, distribution, or packed`,
-        );
-    }
-  }
-  return targets;
-}
-
-async function discoverJourneys(): Promise<readonly CliJourney[]> {
-  const journeyRoot = path.join(e2eRoot, "journeys");
-  const entries = await readdir(journeyRoot, { withFileTypes: true });
-  const journeyFiles = entries
-    .filter(
-      (entry) =>
-        entry.isFile() &&
-        (entry.name.endsWith(".journey.ts") ||
-          entry.name.endsWith(".journey.js")),
-    )
-    .map((entry) => entry.name)
-    .toSorted();
-  return await Promise.all(
-    journeyFiles.map(async (fileName) => {
-      const loaded = (await import(
-        pathToFileURL(path.join(journeyRoot, fileName)).href
-      )) as { default: CliJourney };
-      return loaded.default;
-    }),
-  );
-}
-
-function invocation(
-  mode: CliJourneyMode,
-  packedBin: string | undefined,
-): { readonly executable: string; readonly prefix: readonly string[] } {
-  switch (mode) {
-    case "source":
-      return {
-        executable: process.execPath,
-        prefix: [
-          "--conditions=source",
-          path.join(packageRoot, "src", "cli.ts"),
-        ],
-      };
-    case "distribution":
-      return {
-        executable: process.execPath,
-        prefix: [path.join(packageRoot, "dist", "cli.js")],
-      };
-    case "packed":
-      if (packedBin === undefined) {
-        throw new Error(
-          "packed journey mode requires a package-manager bin path",
-        );
-      }
-      return { executable: packedBin, prefix: [] };
-    default:
-      return assertNever(mode);
-  }
-}
-
-async function runCommand(options: {
-  readonly mode: CliJourneyMode;
-  readonly packedBin: string | undefined;
-  readonly command: CliJourneyCommand;
-  readonly cwd: string;
-}): Promise<CliJourneyResult> {
-  const target = invocation(options.mode, options.packedBin);
-  return await new Promise((resolve, reject) => {
-    const child = spawn(
-      target.executable,
-      [...target.prefix, ...options.command.args],
-      {
-        cwd: options.cwd,
-        env: { ...process.env, ...options.command.env },
-        stdio: ["ignore", "pipe", "pipe"],
-      },
-    );
-    let stdout = "";
-    let stderr = "";
-    child.stdout.setEncoding("utf8");
-    child.stderr.setEncoding("utf8");
-    child.stdout.on("data", (chunk: string) => {
-      stdout += chunk;
-    });
-    child.stderr.on("data", (chunk: string) => {
-      stderr += chunk;
-    });
-    child.once("error", reject);
-    child.once("close", (exitCode) => {
-      resolve({
-        commandName: options.command.name,
-        exitCode: exitCode ?? 1,
-        stdout,
-        stderr,
-      });
-    });
-  });
-}
-
-export async function runJourneys(options: {
-  readonly mode: CliJourneyMode;
-  readonly packedBin?: string;
-}): Promise<readonly string[]> {
-  const passed: string[] = [];
-  for (const journey of await discoverJourneys()) {
-    if (!journey.modes.includes(options.mode)) continue;
-    const workDir = await mkdtemp(
-      path.join(tmpdir(), `cli-${journey.name}-${options.mode}-`),
-    );
-    const context = { mode: options.mode, packageRoot, workDir };
-    try {
-      await journey.setup(context);
-      const results: CliJourneyResult[] = [];
-      for (const command of journey.commands(context)) {
-        results.push(
-          await runCommand({
-            mode: options.mode,
-            packedBin: options.packedBin,
-            command,
-            cwd: workDir,
-          }),
-        );
-      }
-      await journey.assertions({ context, results });
-      passed.push(`${options.mode}:${journey.name}:passed`);
-    } finally {
-      await rm(workDir, { recursive: true, force: true });
-    }
-  }
-  return passed;
-}
-
-async function runJourneyTargets(
-  targets: readonly JourneyRunTarget[],
-): Promise<readonly string[]> {
-  const passed: string[] = [];
-  for (const target of targets) {
-    switch (target.mode) {
-      case "source":
-      case "distribution":
-        passed.push(...(await runJourneys({ mode: target.mode })));
-        break;
-      case "packed":
-        passed.push(
-          ...(await runJourneys({
-            mode: target.mode,
-            ...(target.packedBin === undefined
-              ? {}
-              : { packedBin: target.packedBin }),
-          })),
-        );
-        break;
-      default:
-        assertNever(target.mode);
-    }
-  }
-  return passed;
-}
-
-if (import.meta.url === pathToFileURL(process.argv[1] ?? "").href) {
-  try {
-    const passed = await runJourneyTargets(
-      parseJourneyRunTargets(process.argv.slice(2)),
-    );
-    process.stdout.write(`${passed.join("\n")}\n`);
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    process.stderr.write(`error: ${message}\n`);
-    process.exitCode = 1;
-  }
-}

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

@@ -1,146 +0,0 @@
-import assert from "node:assert/strict";
-import { createRequire } from "node:module";
-import { describe, it } from "node:test";
-
-import { cliCommandIdentity } from "../../src/cli-command-identity.ts";
-import { runCli, type CliRuntime } from "../../src/main.ts";
-
-const identity = cliCommandIdentity(
-  createRequire(import.meta.url)("../../package.json"),
-);
-
-function testRuntime(args: readonly string[]) {
-  let stdout = "";
-  let stderr = "";
-  const runtime: CliRuntime = {
-    argv: ["node", identity.commandName, ...args],
-    identity,
-    write: ({ destination, chunk }) => {
-      if (destination === "stdout") stdout += chunk;
-      else stderr += chunk;
-    },
-  };
-  return { runtime, stdout: () => stdout, stderr: () => stderr };
-}
-
-void describe("CLI 契约", () => {
-  void it("查询成功默认返回结构化数据，也支持中文文本", async () => {
-    const output = testRuntime(["lookup", "ada"]);
-    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" },
-    });
-    assert.equal(output.stderr(), "");
-    const human = testRuntime(["lookup", "ada", "--output-format", "text"]);
-    assert.equal(await runCli(human.runtime), 0);
-    assert.ok(human.stdout().includes("找到记录"));
-    assert.ok(human.stdout().includes("Ada Lovelace"));
-  });
-
-  void it("未找到记录是已声明失败，非法名称是用法错误", async () => {
-    const missing = testRuntime(["lookup", "missing"]);
-    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"]);
-      assert.equal(await runCli(invalid.runtime), 2);
-      assert.equal(invalid.stdout(), "");
-      assert.partialDeepStrictEqual(JSON.parse(invalid.stderr()), {
-        kind: "usageFailure",
-      });
-    }
-  });
-
-  void it("帮助和版本使用 manifest 身份，schema 导出完整契约", async () => {
-    const version = testRuntime(["--version"]);
-    assert.equal(await runCli(version.runtime), 0);
-    assert.equal(
-      version.stdout(),
-      `${identity.commandName} ${identity.version}\n`,
-    );
-    const help = testRuntime(["--help"]);
-    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"]);
-    assert.equal(await runCli(schema.runtime), 0);
-    const humanSchema = testRuntime(["schema", "--output-format", "text"]);
-    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;
-    assert.partialDeepStrictEqual(manifest, {
-      commands: {
-        lookup: {
-          input: {
-            inputSchema: {
-              properties: { name: { pattern: "^[a-z]+$" } },
-              required: ["name"],
-            },
-          },
-          success: { variants: { found: { exitCode: 0 } } },
-          failures: { notFound: { exitCode: 1 } },
-        },
-        schema: { success: { variants: { exported: { exitCode: 0 } } } },
-      },
-      controls: {
-        output: {
-          defaultFormat: "structured",
-          formats: ["structured", "text"],
-        },
-      },
-      usageFailure: { exitCode: 2 },
-    });
-  });
-
-  void it("等待输出完成，仅 stdout EPIPE 安静成功", async () => {
-    const output = testRuntime(["lookup", "ada"]);
-    assert.equal(
-      await runCli({
-        ...output.runtime,
-        write: async () => {
-          throw Object.assign(new Error("pipe"), { code: "EPIPE" });
-        },
-      }),
-      0,
-    );
-    assert.equal(
-      await runCli({
-        ...output.runtime,
-        write: async () => {
-          throw new Error("disk");
-        },
-      }),
-      70,
-    );
-    const failure = testRuntime(["lookup", "missing"]);
-    assert.equal(
-      await runCli({
-        ...failure.runtime,
-        write: async () => {
-          throw Object.assign(new Error("pipe"), { code: "EPIPE" });
-        },
-      }),
-      70,
-    );
-    const argv = ["node", identity.commandName];
-    Object.defineProperty(argv, "slice", {
-      value() {
-        throw new Error("内部细节");
-      },
-    });
-    assert.equal(await runCli({ ...output.runtime, argv }), 70);
-    assert.ok(output.stderr().includes("命令执行失败"));
-    assert.ok(!output.stderr().includes("内部细节"));
-  });
-});

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

@@ -1,76 +0,0 @@
-import assert from "node:assert/strict";
-import { describe, it } from "node:test";
-
-import {
-  cliCommandIdentity,
-  validateCliCommandName,
-} from "../../src/cli-command-identity.ts";
-
-void describe("CLI command identity", () => {
-  for (const { name, command, message } of [
-    { name: "path separator", command: "tools/release", message: "path" },
-    { name: "backslash path", command: "tools\\release", message: "path" },
-    { name: "whitespace", command: "release tool", message: "whitespace" },
-    { name: "control character", command: "release\u0000", message: "control" },
-    { name: "leading hyphen", command: "-release", message: "leading hyphen" },
-    { name: "uppercase ASCII", command: "Release", message: "lowercase ASCII" },
-    { name: "non-ASCII", command: "发布", message: "lowercase ASCII" },
-  ]) {
-    void it(`拒绝格式不合法的命令名：${name}`, () => {
-      assert.throws(
-        () => validateCliCommandName(command),
-        (error: unknown) => {
-          assert.ok(error instanceof Error);
-          assert.ok(error.message.includes(message));
-          return true;
-        },
-      );
-    });
-  }
-
-  void it("接受符合格式的命令名，并拒绝工作区中已使用的名称", () => {
-    assert.equal(validateCliCommandName("release-tool", []), "release-tool");
-    assert.throws(
-      () => validateCliCommandName("release-tool", ["release-tool"]),
-      /already used by another workspace package/,
-    );
-  });
-
-  void it("derives command and unpublished version only from manifest facts", () => {
-    assert.deepStrictEqual(
-      cliCommandIdentity({ bin: { release: "./dist/cli.js" } }),
-      { commandName: "release", version: "unpublished" },
-    );
-    assert.deepStrictEqual(
-      cliCommandIdentity({
-        bin: { ship: "./dist/cli.js" },
-        version: "2.3.4",
-      }),
-      { commandName: "ship", version: "2.3.4" },
-    );
-  });
-
-  void it("rejects malformed manifest identity facts", () => {
-    assert.throws(() => cliCommandIdentity(null), /must be an object/);
-    assert.throws(() => cliCommandIdentity({ bin: {} }), /exactly one bin/);
-    assert.throws(
-      () =>
-        cliCommandIdentity({
-          bin: { release: "./dist/cli.js", ship: "./dist/cli.js" },
-        }),
-      /exactly one bin/,
-    );
-    assert.throws(
-      () => cliCommandIdentity({ bin: { release: "./src/cli.ts" } }),
-      /must execute ".\/dist\/cli\.js"/,
-    );
-    assert.throws(
-      () =>
-        cliCommandIdentity({
-          bin: { release: "./dist/cli.js" },
-          version: 1,
-        }),
-      /version must be a non-empty string/,
-    );
-  });
-});

package/node_modules/@ykdz/template-builtin-presets/templates/ts-cli/tsconfig.build.json

@@ -1,12 +0,0 @@
-{
-  "extends": "./tsconfig.json",
-  "compilerOptions": {
-    "customConditions": [],
-    "declaration": false,
-    "declarationMap": false,
-    "outDir": "dist",
-    "rootDir": "src",
-    "types": ["node"]
-  },
-  "include": ["src/**/*.ts"]
-}

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

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

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

@@ -1,64 +0,0 @@
-{
-  "extends": ["//"],
-  "tags": ["app"],
-  "tasks": {
-    "build": {
-      "dependsOn": ["^build"],
-      "inputs": [],
-      "outputs": ["dist/**"],
-      "tags": ["quality:light"]
-    },
-    "format:check": {
-      "inputs": [],
-      "outputs": [],
-      "tags": ["quality:light"]
-    },
-    "format:write": {
-      "dependsOn": ["lint:fix"],
-      "inputs": [],
-      "outputs": [],
-      "cache": false,
-      "tags": ["work:repair"]
-    },
-    "lint": {
-      "inputs": [],
-      "outputs": [],
-      "tags": ["quality:light"]
-    },
-    "lint:fix": {
-      "inputs": [],
-      "outputs": [],
-      "cache": false,
-      "tags": ["work:repair"]
-    },
-    "postbuild": {
-      "inputs": [],
-      "outputs": [],
-      "tags": ["work:lifecycle"]
-    },
-    "prepack": {
-      "inputs": [],
-      "outputs": [],
-      "tags": ["work:release"]
-    },
-    "test": {
-      "dependsOn": [],
-      "inputs": [],
-      "outputs": [],
-      "tags": ["quality:light"]
-    },
-    "test:e2e": {
-      "dependsOn": ["build"],
-      "inputs": [],
-      "outputs": [],
-      "cache": false,
-      "tags": ["quality:heavy"]
-    },
-    "typecheck": {
-      "dependsOn": ["^typecheck"],
-      "inputs": [],
-      "outputs": [],
-      "tags": ["quality:light"]
-    }
-  }
-}

package/node_modules/@ykdz/template-builtin-presets/templates/ts-lib/.github/dependabot.yml

@@ -1,33 +0,0 @@
-version: 2
-
-updates:
-  - package-ecosystem: npm
-    directory: /
-    schedule:
-      interval: weekly
-    groups:
-      drizzle:
-        patterns:
-          - "drizzle-*"
-          - "drizzle-orm"
-    ignore:
-      - dependency-name: "@types/node"
-        update-types:
-          - version-update:semver-major
-      - dependency-name: "pnpm"
-        update-types:
-          - version-update:semver-major
-          - version-update:semver-minor
-          - version-update:semver-patch
-  - package-ecosystem: github-actions
-    directory: /
-    schedule:
-      interval: weekly
-  - package-ecosystem: docker
-    directory: /.devcontainer
-    schedule:
-      interval: weekly
-    ignore:
-      - dependency-name: mcr.microsoft.com/devcontainers/typescript-node
-        update-types:
-          - version-update:semver-major

package/node_modules/@ykdz/template-builtin-presets/templates/ts-lib/tsconfig.build.json

@@ -1,9 +0,0 @@
-{
-  "extends": "./tsconfig.json",
-  "compilerOptions": {
-    "customConditions": [],
-    "outDir": "dist",
-    "rootDir": "src"
-  },
-  "include": ["src/**/*.ts"]
-}

package/node_modules/@ykdz/template-builtin-presets/templates/ts-lib/tsconfig.json

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

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

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

package/node_modules/@ykdz/template-builtin-presets/templates/vike-app/db/scripts/reset.ts

@@ -1,3 +0,0 @@
-import { resetDatabaseStorageTarget } from "#db/storage";
-
-resetDatabaseStorageTarget();

package/node_modules/@ykdz/template-builtin-presets/templates/vike-app/db/tsconfig.build.json

@@ -1,12 +0,0 @@
-{
-  "extends": "./tsconfig.json",
-  "compilerOptions": {
-    "customConditions": ["source"],
-    "declaration": true,
-    "declarationMap": false,
-    "outDir": "./dist",
-    "rootDir": "./src",
-    "tsBuildInfoFile": "./dist/tsconfig.build.tsbuildinfo"
-  },
-  "include": ["src/**/*.ts"]
-}