@ykdz/template 0.0.41 → 0.1.0-experimental.0

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/App.vue

@@ -0,0 +1,43 @@
+<script setup lang="ts">
+import { onMounted, onUnmounted, ref } from "vue";
+
+import CounterButton from "./components/CounterButton.vue";
+const themeLabel = ref<"深色" | "浅色">("浅色");
+
+let preferredThemeQuery: MediaQueryList | undefined;
+
+function updateThemeLabel(event: MediaQueryList | MediaQueryListEvent): void {
+  themeLabel.value = event.matches ? "深色" : "浅色";
+}
+
+onMounted(() => {
+  preferredThemeQuery = window.matchMedia("(prefers-color-scheme: dark)");
+  updateThemeLabel(preferredThemeQuery);
+  preferredThemeQuery.addEventListener("change", updateThemeLabel);
+});
+
+onUnmounted(() => {
+  preferredThemeQuery?.removeEventListener("change", updateThemeLabel);
+});
+</script>
+
+<template>
+  <main class="min-h-screen bg-slate-950 text-white">
+    <section
+      class="mx-auto flex min-h-screen max-w-3xl flex-col justify-center px-6 py-16"
+    >
+      <p class="text-sm font-medium tracking-wide text-cyan-300 uppercase">
+        Vue 应用预设
+      </p>
+      <h1 class="mt-4 text-4xl font-semibold">Vue、Vite、Tailwind 和 Pinia</h1>
+      <p class="mt-4 text-lg text-slate-300">
+        这个生成的应用已经接入严格 TypeScript 检查、单元测试和 Playwright
+        端到端测试。
+      </p>
+      <div class="mt-8 flex items-center gap-4">
+        <CounterButton />
+        <span class="text-sm text-slate-400">系统主题：{{ themeLabel }}</span>
+      </div>
+    </section>
+  </main>
+</template>

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

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

@@ -0,0 +1,84 @@
+{
+  "extends": ["//"],
+  "tags": ["app"],
+  "tasks": {
+    "browser:prepare": {
+      "cache": false,
+      "outputs": [],
+      "tags": ["work:preparation"]
+    },
+    "build": {
+      "cache": true,
+      "dependsOn": ["^build"],
+      "outputs": ["dist/**"],
+      "tags": ["quality:light"]
+    },
+    "dev": {
+      "cache": false,
+      "outputs": [],
+      "tags": ["work:development"]
+    },
+    "format:check": {
+      "cache": true,
+      "outputs": [],
+      "tags": ["quality:light"]
+    },
+    "format:write": {
+      "cache": false,
+      "dependsOn": ["lint:fix"],
+      "outputs": [],
+      "tags": ["work:repair"]
+    },
+    "lint": {
+      "cache": true,
+      "outputs": [],
+      "tags": ["quality:light"]
+    },
+    "lint:fix": {
+      "cache": false,
+      "outputs": [],
+      "tags": ["work:repair"]
+    },
+    "preview": {
+      "cache": false,
+      "outputs": [],
+      "tags": ["work:development"]
+    },
+    "test:browser": {
+      "cache": true,
+      "dependsOn": ["browser:prepare"],
+      "outputs": [],
+      "tags": ["quality:heavy"]
+    },
+    "test:e2e": {
+      "cache": false,
+      "dependsOn": ["build", "browser:prepare"],
+      "outputs": [],
+      "tags": ["quality:heavy"]
+    },
+    "typecheck": {
+      "cache": true,
+      "dependsOn": ["^typecheck"],
+      "outputs": [],
+      "tags": ["quality:light"]
+    },
+    "build:template": {
+      "dependsOn": [
+        "@ykdz/template-core#build",
+        "@ykdz/template-workspace#build"
+      ],
+      "outputs": ["template-dist/**"],
+      "tags": ["work:preparation"]
+    },
+    "check:author-planning-roles": {
+      "cache": false,
+      "outputs": [],
+      "tags": ["quality:light"]
+    },
+    "test": {
+      "cache": true,
+      "outputs": [],
+      "tags": ["quality:light"]
+    }
+  }
+}

package/node_modules/@ykdz/reference-vue-app/native/vite.config.ts

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

package/node_modules/@ykdz/reference-vue-app/native/vitest.config.ts

@@ -0,0 +1,37 @@
+import { playwright } from "@vitest/browser-playwright";
+import { defineConfig, mergeConfig } from "vitest/config";
+
+import viteConfig from "./vite.config.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" }],
+            },
+          },
+        },
+      ],
+    },
+  }),
+);