@ykdz/template 0.0.42 → 0.1.0-experimental.1

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

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

@@ -0,0 +1,20 @@
+{
+  "name": "@ykdz/reference-vue-app",
+  "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-hono-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-vue-hono-web/native/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@ykdz/reference-vue-hono-web",
+  "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"
+  },
+  "dependencies": {
+    "@ykdz/reference-hono-api": "workspace:*",
+    "@ykdz/template-core": "workspace:*",
+    "vue": "catalog:"
+  },
+  "devDependencies": {
+    "@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-hono-web/native/src/App.vue

@@ -0,0 +1,49 @@
+<script setup lang="ts">
+import { onMounted, onUnmounted, ref } from "vue";
+
+import { getHealth } from "#/api";
+
+const themeLabel = ref<"深色" | "浅色">("浅色");
+const apiStatus = 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);
+});
+
+onMounted(async () => {
+  const body = await getHealth();
+  apiStatus.value = body.status === "ok" ? "正常" : body.status;
+});
+</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 + Hono 应用预设
+      </p>
+      <h1 class="mt-4 text-4xl font-semibold">Vue 和 Hono 工作区</h1>
+      <p class="mt-4 text-lg text-slate-300">
+        页面启动后会检查服务状态，并在下方展示结果。
+      </p>
+      <div class="mt-8 flex flex-wrap items-center gap-4">
+        <span class="text-sm text-slate-400">系统主题：{{ themeLabel }}</span>
+        <span class="text-sm text-slate-400">API 状态：{{ apiStatus }}</span>
+      </div>
+    </section>
+  </main>
+</template>

package/node_modules/@ykdz/reference-vue-hono-web/native/src/main.ts

@@ -0,0 +1,7 @@
+import { createApp } from "vue";
+
+import App from "./App.vue";
+
+import "./style.css";
+
+createApp(App).mount("#app");

package/node_modules/@ykdz/reference-vue-hono-web/native/src/style.css

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

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

@@ -0,0 +1,49 @@
+import { playwrightBrowserAssetsEnvironmentNeed } from "@ykdz/template-workspace/default-environment";
+import { defineReferencePackage } from "@ykdz/template-workspace/reference-package";
+export const referencePackage = defineReferencePackage({
+    packageName: "@ykdz/reference-vue-hono-web",
+    resolve: (specifier) => import.meta.resolve(specifier),
+    resourceRoot: new URL("../", import.meta.url),
+    alias: "vue-hono-web",
+    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 },
+            },
+        ],
+    }),
+});

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

@@ -0,0 +1,13 @@
+import { expect, it, vi } from "vitest";
+import { render } from "vitest-browser-vue";
+
+import App from "../src/App.vue";
+
+it("显示 API 健康状态", async () => {
+  vi.spyOn(globalThis, "fetch").mockResolvedValue(
+    Response.json({ status: "ok" }),
+  );
+  const screen = await render(App);
+  await expect.element(screen.getByText("API 状态：正常")).toBeVisible();
+  vi.restoreAllMocks();
+});

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

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

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

@@ -0,0 +1,74 @@
+{
+  "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"]
+    },
+    "typecheck": {
+      "cache": true,
+      "dependsOn": ["@ykdz/reference-hono-api#build", "^typecheck"],
+      "outputs": [],
+      "tags": ["quality:light"]
+    },
+    "build:template": {
+      "dependsOn": [
+        "@ykdz/reference-hono-api#build",
+        "@ykdz/template-core#build",
+        "@ykdz/template-workspace#build"
+      ],
+      "outputs": ["template-dist/**"],
+      "tags": ["work:preparation"]
+    },
+    "check:author-planning-roles": {
+      "cache": false,
+      "outputs": [],
+      "tags": ["quality:light"]
+    }
+  }
+}

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

@@ -0,0 +1,28 @@
+import tailwindcss from "@tailwindcss/vite";
+import vue from "@vitejs/plugin-vue";
+import { defineConfig, loadEnv } from "vite";
+
+export default defineConfig(({ mode }) => {
+  const env = loadEnv(mode, process.cwd(), "");
+  const apiBaseUrl =
+    process.env.VITE_API_BASE_URL ??
+    env.VITE_API_BASE_URL ??
+    "http://localhost:3000";
+  const previewPort = process.env.PLAYWRIGHT_WEB_PORT;
+
+  return {
+    plugins: [vue(), tailwindcss()],
+    server: {
+      host: true,
+      proxy: {
+        "/api": apiBaseUrl,
+      },
+    },
+    preview: {
+      ...(previewPort === undefined ? {} : { port: Number(previewPort) }),
+      proxy: {
+        "/api": apiBaseUrl,
+      },
+    },
+  };
+});

package/node_modules/@ykdz/reference-vue-hono-web/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((configEnv) =>
+  mergeConfig(viteConfig(configEnv), {
+    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-vue-hono-web/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@ykdz/reference-vue-hono-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/template-content/dist/index.d.ts

@@ -0,0 +1,14 @@
+import { deriveTemplateMembers } from "./template-members.js";
+import type { LoadedContentMember } from "@ykdz/template-core/content-identity";
+export { deriveTemplateMembers };
+export type { ContentKind } from "@ykdz/template-core/content-identity";
+export declare const templateContent: readonly LoadedContentMember[];
+export type TemplateContentMember = (typeof templateContent)[number];
+export type TemplatePreset = TemplateContentMember & {
+    readonly kind: "preset";
+};
+export type TemplateReferencePackage = TemplateContentMember & {
+    readonly kind: "reference";
+};
+export declare const templatePresets: readonly never[];
+export declare const templateReferencePackages: readonly never[];

package/node_modules/@ykdz/template-content/dist/index.js

@@ -0,0 +1,9 @@
+import { deriveTemplateMembers } from "./template-members.js";
+import { templateContent as provider0 } from "@ykdz/template-content-provider-51cfac9642dc43a4";
+export { deriveTemplateMembers };
+export const templateContent = [
+    ...provider0,
+];
+const templateMembers = deriveTemplateMembers(templateContent);
+export const templatePresets = templateMembers.presets;
+export const templateReferencePackages = templateMembers.referencePackages;

package/node_modules/@ykdz/template-content/dist/template-members.d.ts

@@ -0,0 +1,9 @@
+/** 从唯一内容序列派生预设成员和打包所需参考包成员。 */
+export declare function deriveTemplateMembers<Content extends readonly unknown[]>(content: Content): {
+    readonly presets: readonly Extract<Content[number], {
+        readonly kind: "preset";
+    }>[];
+    readonly referencePackages: readonly Extract<Content[number], {
+        readonly kind: "reference";
+    }>[];
+};

package/node_modules/@ykdz/template-content/dist/template-members.js

@@ -0,0 +1,16 @@
+/** 从唯一内容序列派生预设成员和打包所需参考包成员。 */
+export function deriveTemplateMembers(content) {
+    const presets = [];
+    const referencePackages = [];
+    for (const member of content) {
+        if (typeof member !== "object" || member === null)
+            continue;
+        if ("kind" in member && member.kind === "preset") {
+            presets.push(member);
+        }
+        if ("kind" in member && member.kind === "reference") {
+            referencePackages.push(member);
+        }
+    }
+    return { presets, referencePackages };
+}

package/node_modules/@ykdz/template-content/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "@ykdz/template-content",
+  "version": "0.0.0",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@ykdz/template-content-provider-51cfac9642dc43a4": "1.0.0",
+    "@ykdz/template-core": "0.0.0"
+  }
+}