@ykdz/template 0.0.42 → 0.1.0-experimental.0

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"
+    }
+  ]
+}

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

@@ -0,0 +1,33 @@
+{
+  "extends": "@ykdz/reference-tooling-config/base.json",
+  "compilerOptions": {
+    "composite": true,
+    "customConditions": [],
+    "erasableSyntaxOnly": false,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "lib": ["ESNext", "DOM", "DOM.Iterable"],
+    "rewriteRelativeImportExtensions": false,
+    "target": "es2024",
+    "types": ["node"],
+    "skipLibCheck": true,
+    "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.node.tsbuildinfo",
+    "resolveJsonModule": true,
+    "allowImportingTsExtensions": true,
+    "noEmit": true
+  },
+  "include": [
+    "*.config.ts",
+    "env.d.ts",
+    "assets/**/*.svg",
+    "components/**/*.vue",
+    "pages/**/*.ts",
+    "pages/**/*.vue",
+    "server/**/*.ts",
+    "+server.ts",
+    "types/**/*.d.ts",
+    "test/**/*.ts",
+    "tooling/**/*.ts",
+    "template/**/*.ts"
+  ]
+}

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

@@ -0,0 +1,92 @@
+{
+  "extends": ["//"],
+  "tags": ["app"],
+  "tasks": {
+    "build": {
+      "dependsOn": ["^build"],
+      "outputs": ["dist/**"],
+      "tags": ["quality:light"]
+    },
+    "dev": {
+      "dependsOn": ["@ykdz/reference-vike-db#build"],
+      "cache": false,
+      "persistent": true,
+      "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"]
+    },
+    "preview": {
+      "cache": false,
+      "tags": ["work:development"]
+    },
+    "start": {
+      "cache": false,
+      "tags": ["work:development"]
+    },
+    "browser:prepare": {
+      "cache": false,
+      "tags": ["work:preparation"]
+    },
+    "test": {
+      "outputs": [],
+      "tags": ["quality:light"]
+    },
+    "test:browser": {
+      "dependsOn": ["browser:prepare"],
+      "tags": ["quality:heavy"]
+    },
+    "test:e2e": {
+      "dependsOn": [
+        "//#database:prepare:e2e",
+        "@ykdz/reference-vike-db#build",
+        "build",
+        "browser:prepare"
+      ],
+      "cache": false,
+      "tags": ["quality:heavy"]
+    },
+    "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-web/native/types/global.d.ts

@@ -0,0 +1,9 @@
+import type { Database } from "@ykdz/reference-vike-db";
+
+declare global {
+  namespace Telefunc {
+    interface Context {
+      db: Database;
+    }
+  }
+}

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

@@ -0,0 +1,16 @@
+import databaseManifest from "@ykdz/reference-vike-db/package.json" with { type: "json" };
+import telefunc from "telefunc/vite";
+import vike from "vike/plugin";
+import { defineConfig, type PluginOption } from "vite";
+
+import vueConfig from "./tooling/vite.ts";
+
+// telefunc/vite 暂未为插件工厂提供精确类型。
+// oxlint-disable-next-line typescript/no-unsafe-type-assertion
+const telefuncPlugin = telefunc() as PluginOption;
+
+export default defineConfig({
+  plugins: [vike(), telefuncPlugin, ...(vueConfig.plugins ?? [])],
+  resolve: { conditions: ["source"] },
+  ssr: { external: [databaseManifest.name] },
+});

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

@@ -0,0 +1,37 @@
+import { playwright } from "@vitest/browser-playwright";
+import { defineConfig, mergeConfig } from "vitest/config";
+
+import viteConfig from "./tooling/vite.ts";
+
+export default defineConfig(() =>
+  mergeConfig(viteConfig, {
+    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/reference-vike-web/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@ykdz/reference-vike-web",
+  "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",
+    "typescript-7": "npm:typescript@7.0.2"
+  }
+}

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

@@ -0,0 +1,70 @@
+{
+  "name": "@ykdz/reference-vue-app",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "imports": {
+    "#/*": {
+      "types": "./src/*.ts",
+      "default": "./src/*.ts"
+    }
+  },
+  "exports": {
+    ".": {
+      "types": "./src/main.ts",
+      "default": "./src/main.ts"
+    },
+    "./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\"",
+    "format:check": "oxfmt --list-different .",
+    "format:write": "oxfmt --write .",
+    "lint": "oxlint --quiet --format=unix .",
+    "lint:fix": "oxlint --format=unix . --fix",
+    "typecheck": "vue-tsc --build --noEmit --pretty false",
+    "build:template": "rm -rf template-dist && tsc -p tsconfig.template.json --pretty false",
+    "browser:prepare": "playwright install chromium",
+    "test:browser": "vitest run --project=browser --reporter=agent --silent=passed-only --fsModuleCachePath=node_modules/.vitest-cache/browser",
+    "build": "vite build",
+    "dev": "vite",
+    "preview": "vite preview",
+    "test:e2e": "playwright test",
+    "test": "vitest run --project=node --reporter=agent --silent=passed-only --fsModuleCachePath=node_modules/.vitest-cache/node"
+  },
+  "dependencies": {
+    "@vue/devtools-api": "catalog:",
+    "@ykdz/template-core": "workspace:*",
+    "pinia": "catalog:",
+    "vue": "catalog:"
+  },
+  "devDependencies": {
+    "@playwright/test": "catalog:",
+    "@tailwindcss/vite": "catalog:",
+    "@types/node": "catalog:",
+    "@types/web-bluetooth": "catalog:",
+    "@vitejs/plugin-vue": "catalog:",
+    "@vitest/browser-playwright": "catalog:",
+    "@vue/tsconfig": "catalog:",
+    "@ykdz/reference-tooling-config": "workspace:*",
+    "@ykdz/template-workspace": "workspace:*",
+    "oxfmt": "catalog:",
+    "oxlint": "catalog:",
+    "oxlint-tsgolint": "catalog:",
+    "playwright": "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-vue-app/native/src/components/CounterButton.vue

@@ -0,0 +1,18 @@
+<script setup lang="ts">
+import { storeToRefs } from "pinia";
+
+import { useCounterStore } from "../stores/counter.ts";
+
+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/reference-vue-app/native/src/style.css

@@ -0,0 +1,2 @@
+@import "tailwindcss";
+@source "./";

package/node_modules/@ykdz/reference-vue-app/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-vue-app/native/template-dist/definition.js

@@ -0,0 +1,53 @@
+import { playwrightBrowserAssetsEnvironmentNeed } from "@ykdz/template-workspace/default-environment";
+import { defineReferencePackage } from "@ykdz/template-workspace/reference-package";
+export const referencePackage = defineReferencePackage({
+    packageName: "@ykdz/reference-vue-app",
+    resolve: (specifier) => import.meta.resolve(specifier),
+    resourceRoot: new URL("../", import.meta.url),
+    alias: "vue-app",
+    instance: "independent",
+    defaultLeafName: "web",
+    defaultPath: "apps/web",
+    role: "runtime-service",
+    resources: ["."],
+    template: {
+        dependencies: [
+            { name: "@ykdz/template-core", purpose: "template-execution" },
+            {
+                name: "@ykdz/template-workspace",
+                purpose: "template-execution",
+            },
+            { name: "typescript-7", purpose: "template-execution" },
+        ],
+        scripts: ["build:template", "check:author-planning-roles"],
+        resources: ["template", "tsconfig.template.json", ".npmignore"],
+    },
+    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: "vitest-browser",
+                owner: { kind: "package-boundary", path: definition.path },
+            },
+            {
+                kind: "playwright",
+                owner: { kind: "package-boundary", path: definition.path },
+            },
+        ],
+    }),
+});

package/node_modules/@ykdz/reference-vue-app/native/test/app.browser.test.ts

@@ -0,0 +1,13 @@
+import { createPinia } from "pinia";
+import { expect, it } from "vitest";
+import { render } from "vitest-browser-vue";
+
+import App from "../src/App.vue";
+
+it("显示应用并更新本地计数器", async () => {
+  const screen = await render(App, { 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/reference-vue-app/native/test/counter.node.test.ts

@@ -0,0 +1,15 @@
+import { createPinia, setActivePinia } from "pinia";
+import { describe, expect, it } from "vitest";
+
+import { useCounterStore } from "../src/stores/counter.ts";
+
+describe("计数状态", () => {
+  it("增加计数", () => {
+    setActivePinia(createPinia());
+    const counter = useCounterStore();
+
+    counter.increment();
+
+    expect(counter.count).toBe(1);
+  });
+});

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

@@ -0,0 +1,15 @@
+import { expect, test } from "@playwright/test";
+
+test("renders and updates the counter", async ({ page }) => {
+  await page.goto("/");
+
+  await expect(
+    page.getByRole("heading", { name: "Vue、Vite、Tailwind 和 Pinia" }),
+  ).toBeVisible();
+  const counterButton = page.getByRole("button", { name: "计数：0" });
+
+  await expect(counterButton).toBeVisible();
+  await expect(counterButton).toHaveCSS("padding-left", "16px");
+  await counterButton.click({ force: true });
+  await expect(page.getByRole("button", { name: "计数：1" })).toBeVisible();
+});

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

@@ -0,0 +1,18 @@
+{
+  "extends": [
+    "@vue/tsconfig/tsconfig.dom.json",
+    "@ykdz/reference-tooling-config/base.json"
+  ],
+  "compilerOptions": {
+    "composite": true,
+    "customConditions": ["source"],
+    "exactOptionalPropertyTypes": false,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "rewriteRelativeImportExtensions": false,
+    "target": "es2024",
+    "types": ["web-bluetooth"],
+    "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.app.tsbuildinfo"
+  },
+  "include": ["env.d.ts", "src/**/*.ts", "src/**/*.vue"]
+}

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

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

package/node_modules/@ykdz/reference-vue-app/native/tsconfig.node.json

@@ -0,0 +1,25 @@
+{
+  "extends": "@ykdz/reference-tooling-config/base.json",
+  "compilerOptions": {
+    "composite": true,
+    "customConditions": ["source"],
+    "erasableSyntaxOnly": false,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "lib": ["ESNext", "DOM", "DOM.Iterable"],
+    "rewriteRelativeImportExtensions": false,
+    "target": "es2024",
+    "types": ["node"],
+    "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.node.tsbuildinfo",
+    "allowImportingTsExtensions": true,
+    "noEmit": true
+  },
+  "include": [
+    "*.config.ts",
+    "env.d.ts",
+    "src/**/*.ts",
+    "src/**/*.vue",
+    "test/**/*.ts",
+    "template/**/*.ts"
+  ]
+}