@ykdz/template 0.0.41 → 0.1.0-experimental.0

package/node_modules/@ykdz/reference-vike-migrations/native/turbo.json

@@ -0,0 +1,76 @@
+{
+  "extends": ["//"],
+  "tags": ["library"],
+  "tasks": {
+    "build": {
+      "dependsOn": ["^build"],
+      "outputs": [],
+      "tags": ["quality:light"]
+    },
+    "db:generate": {
+      "cache": false,
+      "tags": ["work:development"]
+    },
+    "db:migrate": {
+      "cache": false,
+      "tags": ["work:lifecycle"]
+    },
+    "db:prepare:deploy": {
+      "cache": false,
+      "tags": ["work:lifecycle"]
+    },
+    "db:push": {
+      "cache": false,
+      "tags": ["work:preparation"]
+    },
+    "db:studio": {
+      "cache": false,
+      "tags": ["work:development"]
+    },
+    "format:check": {
+      "outputs": [],
+      "tags": ["quality:light"]
+    },
+    "format:write": {
+      "dependsOn": ["lint:fix"],
+      "cache": false,
+      "tags": ["work:repair"]
+    },
+    "lint": {
+      "outputs": [],
+      "tags": ["quality:light"]
+    },
+    "lint:fix": {
+      "cache": false,
+      "tags": ["work:repair"]
+    },
+    "typecheck": {
+      "dependsOn": ["@ykdz/reference-vike-db#build"],
+      "outputs": [],
+      "tags": ["quality:light"]
+    },
+    "build:template": {
+      "dependsOn": [
+        "@ykdz/reference-vike-db#build",
+        "@ykdz/template-core#build",
+        "@ykdz/template-workspace#build"
+      ],
+      "outputs": ["template-dist/**"],
+      "tags": ["quality:light"]
+    },
+    "typecheck:template": {
+      "dependsOn": [
+        "@ykdz/reference-vike-db#build",
+        "@ykdz/template-core#build",
+        "@ykdz/template-workspace#build"
+      ],
+      "outputs": [],
+      "tags": ["quality:light"]
+    },
+    "check:author-planning-roles": {
+      "cache": false,
+      "outputs": [],
+      "tags": ["quality:light"]
+    }
+  }
+}

package/node_modules/@ykdz/reference-vike-migrations/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@ykdz/reference-vike-migrations",
+  "version": "0.0.0",
+  "type": "module",
+  "files": [
+    "native"
+  ],
+  "exports": {
+    "./reference": "./native/package.json",
+    "./template": {
+      "types": "./native/template-dist/definition.d.ts",
+      "default": "./native/template-dist/definition.js"
+    }
+  },
+  "dependencies": {
+    "@ykdz/template-core": "0.0.0",
+    "@ykdz/template-workspace": "0.0.0"
+  }
+}

package/node_modules/@ykdz/reference-vike-web/native/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/reference-vike-web/native/package.json

@@ -0,0 +1,84 @@
+{
+  "name": "@ykdz/reference-vike-web",
+  "private": true,
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "imports": {
+    "#/assets/*": {
+      "types": "./assets/*",
+      "default": "./assets/*"
+    },
+    "#/components/*": {
+      "types": "./components/*",
+      "default": "./components/*"
+    },
+    "#/server/*": {
+      "types": "./server/*.ts",
+      "default": "./server/*.ts"
+    }
+  },
+  "exports": {
+    "./reference": "./package.json",
+    "./template": {
+      "source": "./template/definition.ts",
+      "types": "./template-dist/definition.d.ts",
+      "default": "./template-dist/definition.js"
+    }
+  },
+  "scripts": {
+    "check:author-planning-roles": "pnpm --workspace-root run author-planning-roles:workspace -- --owner-directory \"$PWD\"",
+    "browser:prepare": "playwright install chromium",
+    "build": "vike build",
+    "dev": "DATABASE_PROFILE=dev NODE_OPTIONS=--conditions=source vike dev",
+    "format:check": "oxfmt --list-different .",
+    "format:write": "oxfmt --write .",
+    "lint": "oxlint --quiet --format=unix --type-aware .",
+    "lint:fix": "oxlint --type-aware --format=unix . --fix",
+    "preview": "DATABASE_PROFILE=dev vike preview",
+    "start": "node ./dist/server/index.mjs",
+    "test": "vitest run --project=node --reporter=agent --silent=passed-only --passWithNoTests --fsModuleCachePath=node_modules/.vitest-cache/node",
+    "test:browser": "vitest run --project=browser --reporter=agent --silent=passed-only --fsModuleCachePath=node_modules/.vitest-cache/browser",
+    "test:e2e": "DATABASE_PROFILE=e2e playwright test",
+    "typecheck": "vue-tsc --build --noEmit --pretty false",
+    "build:template": "rm -rf template-dist && tsc -p tsconfig.template.json --pretty false",
+    "typecheck:template": "tsc -p tsconfig.template.json --noEmit --pretty false"
+  },
+  "dependencies": {
+    "@vikejs/hono": "catalog:",
+    "@ykdz/reference-vike-db": "workspace:*",
+    "hono": "catalog:",
+    "srvx": "catalog:",
+    "telefunc": "catalog:",
+    "vike": "catalog:",
+    "vike-vue": "catalog:",
+    "vue": "catalog:"
+  },
+  "devDependencies": {
+    "@playwright/test": "catalog:",
+    "@tailwindcss/vite": "catalog:",
+    "@types/node": "catalog:",
+    "@vitejs/plugin-vue": "catalog:",
+    "@vitest/browser-playwright": "catalog:",
+    "@vue/tsconfig": "catalog:",
+    "@ykdz/reference-tooling-config": "workspace:*",
+    "@ykdz/template-core": "workspace:*",
+    "@ykdz/template-workspace": "workspace:*",
+    "oxfmt": "catalog:",
+    "oxlint": "catalog:",
+    "oxlint-tsgolint": "catalog:",
+    "playwright": "catalog:",
+    "tailwindcss": "catalog:",
+    "turbo": "catalog:",
+    "typescript": "catalog:",
+    "typescript-7": "catalog:",
+    "vite": "catalog:",
+    "vitest": "catalog:",
+    "vitest-browser-vue": "catalog:",
+    "vue-tsc": "catalog:"
+  },
+  "engines": {
+    "node": "24"
+  }
+}

package/node_modules/@ykdz/reference-vike-web/native/pages/index/+Page.telefunc.ts

@@ -0,0 +1,12 @@
+import { createTodo, listTodos } from "@ykdz/reference-vike-db/queries/todos";
+import { getContext } from "telefunc";
+
+export async function onLoadTodos() {
+  const { db } = getContext();
+  return listTodos(db);
+}
+
+export async function onAddTodo(title: string) {
+  const { db } = getContext();
+  return createTodo(db, { title });
+}

package/node_modules/@ykdz/reference-vike-web/native/pages/index/+Page.vue

@@ -0,0 +1,89 @@
+<script setup lang="ts">
+import { onMounted, ref } from "vue";
+
+import { onAddTodo, onLoadTodos } from "./+Page.telefunc";
+
+const title = ref("");
+const todos = ref<Awaited<ReturnType<typeof onLoadTodos>>>([]);
+const error = ref<string | undefined>();
+
+async function refreshTodos() {
+  error.value = undefined;
+
+  try {
+    todos.value = await onLoadTodos();
+  } catch (unknownError) {
+    error.value =
+      unknownError instanceof Error
+        ? `待办加载失败：${unknownError.message}`
+        : "无法加载待办事项";
+  }
+}
+
+async function submitTodo() {
+  const nextTitle = title.value.trim();
+  if (nextTitle.length === 0) {
+    return;
+  }
+
+  await onAddTodo(nextTitle);
+  title.value = "";
+  await refreshTodos();
+}
+
+onMounted(() => {
+  void refreshTodos();
+});
+</script>
+
+<template>
+  <section class="grid gap-8">
+    <div class="grid gap-4">
+      <p class="text-sm font-semibold tracking-wide text-rose-600 uppercase">
+        Vike + Hono
+      </p>
+      <h1 class="text-4xl font-bold tracking-tight">全栈 Vike 应用</h1>
+      <p class="max-w-2xl text-lg text-slate-700">
+        使用 Hono 路由、Telefunc 动作和 Drizzle 数据访问构建服务端渲染 Vue
+        应用。
+      </p>
+    </div>
+
+    <form class="flex max-w-xl gap-2" @submit.prevent="submitTodo">
+      <input
+        v-model="title"
+        class="min-w-0 flex-1 rounded border border-slate-300 px-3 py-2"
+        name="title"
+        placeholder="添加一条数据库待办"
+      />
+      <button class="rounded bg-slate-950 px-4 py-2 text-white" type="submit">
+        添加
+      </button>
+    </form>
+
+    <button
+      class="w-fit text-sm font-medium text-rose-700"
+      type="button"
+      @click="refreshTodos"
+    >
+      刷新待办事项
+    </button>
+
+    <p
+      v-if="error"
+      class="max-w-xl rounded border border-amber-300 bg-amber-50 p-3 text-sm"
+    >
+      {{ error }}
+    </p>
+
+    <ul v-if="todos.length > 0" class="grid max-w-xl gap-2">
+      <li
+        v-for="todo in todos"
+        :key="todo.id"
+        class="rounded border border-slate-200 bg-white px-3 py-2"
+      >
+        {{ todo.title }}
+      </li>
+    </ul>
+  </section>
+</template>

package/node_modules/@ykdz/reference-vike-web/native/playwright.config.ts

@@ -0,0 +1,156 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { createServer } from "node:net";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+import { defineConfig, devices } from "@playwright/test";
+
+const externalBaseUrlName = "PLAYWRIGHT_EXTERNAL_BASE_URL";
+const externalReadinessTimeoutMs = 30_000;
+const webRoot = path.dirname(fileURLToPath(import.meta.url));
+const stateFile = path.join(webRoot, "node_modules/.tmp/playwright-port");
+
+function externalBaseUrl(): string | undefined {
+  if (!Object.hasOwn(process.env, externalBaseUrlName)) {
+    return undefined;
+  }
+
+  const value = process.env[externalBaseUrlName]?.trim();
+  if (!value) {
+    throw new Error(`${externalBaseUrlName} must be a non-empty HTTP(S) URL`);
+  }
+
+  let url: URL;
+  try {
+    url = new URL(value);
+  } catch {
+    throw new Error(`${externalBaseUrlName} must be a valid HTTP(S) URL`);
+  }
+
+  if (url.protocol !== "http:" && url.protocol !== "https:") {
+    throw new Error(`${externalBaseUrlName} must use HTTP or HTTPS`);
+  }
+
+  return url.toString();
+}
+
+async function availablePort(): Promise<string> {
+  return await new Promise((resolve, reject) => {
+    const server = createServer();
+
+    server.once("error", reject);
+    server.listen(0, "127.0.0.1", () => {
+      const address = server.address();
+
+      if (typeof address !== "object" || address === null) {
+        server.close(() => {
+          reject(new Error("Could not allocate a Playwright web port"));
+        });
+        return;
+      }
+
+      const port = String(address.port);
+      server.close((error) => {
+        if (error) {
+          reject(error);
+          return;
+        }
+
+        resolve(port);
+      });
+    });
+  });
+}
+
+async function awaitExternalService(baseUrl: string): Promise<void> {
+  const deadline = Date.now() + externalReadinessTimeoutMs;
+
+  while (Date.now() < deadline) {
+    try {
+      const response = await fetch(baseUrl, {
+        signal: AbortSignal.timeout(2_000),
+      });
+      if (response.ok) {
+        return;
+      }
+    } catch {
+      // The externally managed service may still be starting.
+    }
+
+    await new Promise((resolve) => setTimeout(resolve, 250));
+  }
+
+  throw new Error(
+    `External Playwright service at ${baseUrl} was not ready within ${externalReadinessTimeoutMs}ms`,
+  );
+}
+
+async function sharedPort(envName: string): Promise<string> {
+  const envPort = process.env[envName];
+  if (envPort !== undefined) {
+    return envPort;
+  }
+  try {
+    return await readFile(stateFile, "utf8");
+  } catch {
+    const port = await availablePort();
+    await mkdir(path.dirname(stateFile), { recursive: true });
+    await writeFile(stateFile, port, "utf8");
+    return port;
+  }
+}
+
+const externalServiceUrl = externalBaseUrl();
+const usesExternalService = externalServiceUrl !== undefined;
+let previewUrl: string;
+
+if (externalServiceUrl === undefined) {
+  const port = await sharedPort("PLAYWRIGHT_WEB_PORT");
+  previewUrl = `http://127.0.0.1:${port}`;
+  process.env.PORT = port;
+} else {
+  previewUrl = externalServiceUrl;
+  await awaitExternalService(externalServiceUrl);
+}
+
+export default defineConfig({
+  testDir: "./test/e2e",
+  timeout: 60_000,
+  outputDir: usesExternalService
+    ? "test-results/deployment"
+    : "test-results/e2e",
+  use: {
+    baseURL: previewUrl,
+    trace: "retain-on-failure",
+  },
+  reporter: [
+    ["list"],
+    [
+      "html",
+      {
+        outputFolder: usesExternalService
+          ? "playwright-report/deployment"
+          : "playwright-report/e2e",
+      },
+    ],
+  ],
+  ...(usesExternalService
+    ? {}
+    : { globalTeardown: "./test/playwright-teardown.ts" }),
+  ...(externalServiceUrl === undefined
+    ? {
+        webServer: {
+          command: "node dist/server/index.mjs",
+          reuseExistingServer: !process.env.CI,
+          timeout: 60_000,
+          url: previewUrl,
+        },
+      }
+    : {}),
+  projects: [
+    {
+      name: "chromium",
+      use: { ...devices["Desktop Chrome"] },
+    },
+  ],
+});

package/node_modules/@ykdz/reference-vike-web/native/server/app.ts

@@ -0,0 +1,36 @@
+import vike from "@vikejs/hono";
+import { Hono } from "hono";
+import { Telefunc } from "telefunc/node";
+
+import { api } from "#/server/api";
+import { assertDatabaseReady, createDatabase } from "#/server/database";
+
+const telefunc = new Telefunc();
+
+export function createApp() {
+  try {
+    assertDatabaseReady(createDatabase());
+  } catch (error) {
+    console.error(error);
+    process.exit(1);
+  }
+
+  const app = new Hono();
+
+  app.route("/api", api);
+
+  app.all("/_telefunc", async (c) => {
+    const response = await telefunc.serve({
+      request: c.req.raw,
+      context: {
+        db: createDatabase(),
+      },
+    });
+
+    return response ?? c.notFound();
+  });
+
+  vike(app);
+
+  return app;
+}

package/node_modules/@ykdz/reference-vike-web/native/server/database.ts

@@ -0,0 +1,2 @@
+export { createDatabase } from "@ykdz/reference-vike-db";
+export { assertDatabaseReady } from "@ykdz/reference-vike-db/readiness";

package/node_modules/@ykdz/reference-vike-web/native/template-dist/definition.d.ts

@@ -0,0 +1 @@
+export declare const referencePackage: import("@ykdz/template-workspace/reference-package").ReferencePackage<import("@ykdz/template-core/workspace-strategy").PackageCreationInput, undefined>;

package/node_modules/@ykdz/reference-vike-web/native/template-dist/definition.js

@@ -0,0 +1,59 @@
+import { playwrightBrowserAssetsEnvironmentNeed } from "@ykdz/template-workspace/default-environment";
+import { defineReferencePackage } from "@ykdz/template-workspace/reference-package";
+export const referencePackage = defineReferencePackage({
+    packageName: "@ykdz/reference-vike-web",
+    // 私有原生清单未声明 npm 版本，给制品显式提供未发布坐标。
+    artifactVersion: "0.0.0",
+    resolve: (specifier) => import.meta.resolve(specifier),
+    resourceRoot: new URL("../", import.meta.url),
+    alias: "vike-web",
+    instance: "independent",
+    defaultLeafName: "web",
+    defaultPath: "apps/web",
+    role: "runtime-service",
+    resources: ["."],
+    template: {
+        resources: ["template", "tsconfig.template.json"],
+        dependencies: [
+            { name: "@ykdz/template-core", purpose: "template-execution" },
+            {
+                name: "@ykdz/template-workspace",
+                purpose: "template-execution",
+            },
+            { name: "typescript-7", purpose: "template-execution" },
+        ],
+        scripts: [
+            "build:template",
+            "typecheck:template",
+            "check:author-planning-roles",
+        ],
+    },
+    foundation: ({ definition }) => ({
+        toolchains: {},
+        editorCapabilities: ["oxc-format-lint", "vue", "tailwind", "vitest"],
+        dependencyMaintenance: {
+            ecosystems: ["npm", "github-actions", "docker"],
+            interval: "weekly",
+        },
+        workspacePackageGlobs: [`${definition.path.split("/")[0]}/*`],
+    }),
+    environmentNeeds: ({ definition }) => [
+        playwrightBrowserAssetsEnvironmentNeed({
+            browser: "chromium",
+            owner: { kind: "package-boundary", path: definition.path },
+        }),
+    ],
+    project: (contribution, { definition }) => ({
+        ...contribution,
+        ciDiagnosticArtifacts: [
+            {
+                kind: "playwright",
+                owner: { kind: "package-boundary", path: definition.path },
+            },
+            {
+                kind: "vitest-browser",
+                owner: { kind: "package-boundary", path: definition.path },
+            },
+        ],
+    }),
+});

package/node_modules/@ykdz/reference-vike-web/native/test/e2e/app.spec.ts

@@ -0,0 +1,16 @@
+import { expect, test } from "@playwright/test";
+
+test("renders the Vike home page", async ({ page }) => {
+  const todoTitle = `编写生成项目端到端测试 ${Date.now()}`;
+
+  // Vike can retain background browser requests after its interactive page is
+  // ready; the visible UI assertions below are the actual readiness contract.
+  await page.goto("/", { waitUntil: "domcontentloaded" });
+  await expect(
+    page.getByRole("heading", { name: "全栈 Vike 应用" }),
+  ).toBeVisible();
+
+  await page.getByPlaceholder("添加一条数据库待办").fill(todoTitle);
+  await page.getByRole("button", { name: "添加" }).click();
+  await expect(page.getByText(todoTitle)).toBeVisible();
+});

package/node_modules/@ykdz/reference-vike-web/native/test/todos.browser.test.ts

@@ -0,0 +1,37 @@
+import { expect, it, vi } from "vitest";
+import { render } from "vitest-browser-vue";
+
+import { onAddTodo, onLoadTodos } from "../pages/index/+Page.telefunc.ts";
+import Page from "../pages/index/+Page.vue";
+
+vi.mock("../pages/index/+Page.telefunc.ts", () => ({
+  onLoadTodos: vi.fn(),
+  onAddTodo: vi.fn(),
+}));
+
+it("加载待办并在新增后刷新列表", async () => {
+  vi.mocked(onLoadTodos)
+    .mockResolvedValueOnce([])
+    .mockResolvedValue([
+      { id: 1, title: "完成待办", completed: false, createdAt: "2026-10-22" },
+    ]);
+  const screen = await render(Page);
+  await screen.getByPlaceholder("添加一条数据库待办").fill("完成待办");
+  await screen.getByRole("button", { name: "添加", exact: true }).click();
+  await expect.element(screen.getByText("完成待办")).toBeVisible();
+  expect(onAddTodo).toHaveBeenCalledWith("完成待办");
+});
+
+it("加载失败后允许重试", async () => {
+  vi.mocked(onLoadTodos)
+    .mockRejectedValueOnce(new Error("数据库暂不可用"))
+    .mockResolvedValue([]);
+  const screen = await render(Page);
+  await expect
+    .element(screen.getByText("待办加载失败：数据库暂不可用"))
+    .toBeVisible();
+  await screen.getByRole("button", { name: "刷新待办事项" }).click();
+  await expect
+    .element(screen.getByText("待办加载失败：数据库暂不可用"))
+    .not.toBeInTheDocument();
+});

package/node_modules/@ykdz/reference-vike-web/native/tooling/vite.ts

@@ -0,0 +1,5 @@
+import tailwindcss from "@tailwindcss/vite";
+import vue from "@vitejs/plugin-vue";
+import { defineConfig } from "vite";
+
+export default defineConfig({ plugins: [vue(), tailwindcss()] });

package/node_modules/@ykdz/reference-vike-web/native/tsconfig.app.json

@@ -0,0 +1,27 @@
+{
+  "extends": [
+    "@vue/tsconfig/tsconfig.dom.json",
+    "@ykdz/reference-tooling-config/base.json"
+  ],
+  "compilerOptions": {
+    "composite": true,
+    "customConditions": [],
+    "exactOptionalPropertyTypes": false,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "rewriteRelativeImportExtensions": false,
+    "target": "es2024",
+    "types": ["node"],
+    "skipLibCheck": true,
+    "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.app.tsbuildinfo"
+  },
+  "include": [
+    "+server.ts",
+    "assets/**/*.svg",
+    "components/**/*.vue",
+    "pages/**/*.ts",
+    "pages/**/*.vue",
+    "server/**/*.ts",
+    "types/**/*.d.ts"
+  ]
+}

package/node_modules/@ykdz/reference-vike-web/native/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "files": [],
+  "references": [
+    {
+      "path": "./tsconfig.app.json"
+    },
+    {
+      "path": "./tsconfig.node.json"
+    }
+  ]
+}