@ykdz/template 0.0.41 → 0.1.0-experimental.0

package/node_modules/@ykdz/preset-vike-app/native/template-dist/deployment.js

@@ -0,0 +1,277 @@
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { createTemplateSourceHandle } from "@ykdz/template-core/renderer";
+import { dockerEngineEnvironmentNeed, shellCheckEnvironmentNeed, } from "@ykdz/template-workspace/default-environment";
+import { parseDocument } from "yaml";
+const deploymentDirectory = fileURLToPath(new URL("../resources/deployment/", import.meta.url));
+const buildxStepPath = path.join(deploymentDirectory, "setup-buildx-step.yml");
+const checkerPath = fileURLToPath(new URL("../scripts/check-standalone-deployment.ts", import.meta.url));
+const checkerSource = readFileSync(checkerPath, "utf8");
+function packageResource(resourcePath, filePath, mode = 0o644) {
+    return {
+        path: resourcePath,
+        source: createTemplateSourceHandle(filePath),
+        mode,
+    };
+}
+export const vikeDeploymentResources = [
+    packageResource("resources/deployment/Dockerfile", path.join(deploymentDirectory, "Dockerfile")),
+    packageResource("resources/deployment/container.dockerignore", path.join(deploymentDirectory, "container.dockerignore")),
+    packageResource("resources/deployment/scripts/container-entrypoint.sh", path.join(deploymentDirectory, "scripts/container-entrypoint.sh"), 0o755),
+    packageResource("scripts/check-standalone-deployment.ts", checkerPath),
+    packageResource("resources/deployment/setup-buildx-step.yml", buildxStepPath),
+];
+const rootFiles = {
+    dockerfile: vikeDeploymentResources[0],
+    dockerIgnore: vikeDeploymentResources[1],
+    containerEntrypoint: vikeDeploymentResources[2],
+};
+function readBuildxStep() {
+    const document = parseDocument(readFileSync(buildxStepPath, "utf8"));
+    if (document.errors.length > 0 || document.warnings.length > 0) {
+        throw new Error(`Vike 部署步骤 YAML 无效：${[...document.errors, ...document.warnings].map((error) => error.message).join("；")}`);
+    }
+    const value = document.toJS();
+    const id = typeof value === "object" && value !== null && !Array.isArray(value)
+        ? value.id
+        : undefined;
+    if (id === undefined ||
+        typeof id !== "string" ||
+        document.get("uses", true) === undefined) {
+        throw new Error("Vike Docker Buildx 步骤资源必须是带 uses 的 YAML 对象。");
+    }
+    return {
+        ...value,
+        id,
+        uses: document.get("uses", true),
+    };
+}
+// 装配时准备所属包的不可变原生资源；更新投影只复用事实，不再读盘。
+const buildxStep = readBuildxStep();
+function copyResource(resource, to) {
+    return {
+        kind: "copyFile",
+        from: ".",
+        to,
+        source: resource.source,
+        overwrite: true,
+    };
+}
+function packageScript(profile, definition, script) {
+    return `DATABASE_PROFILE=${profile} pnpm --filter ${definition.name} run ${script}`;
+}
+function preparationScripts(options) {
+    const { application, database, migrations } = options;
+    return {
+        "database:prepare:dev": [
+            packageScript("dev", migrations, "db:push"),
+            packageScript("dev", database, "db:seed:example"),
+        ].join(" && "),
+        "database:prepare:test": [
+            packageScript("test", database, "db:reset"),
+            packageScript("test", migrations, "db:push"),
+            packageScript("test", database, "db:seed:example"),
+        ].join(" && "),
+        "database:prepare:e2e": [
+            packageScript("e2e", database, "db:reset"),
+            packageScript("e2e", migrations, "db:push"),
+            packageScript("e2e", database, "db:seed:example"),
+        ].join(" && "),
+        dev: `pnpm run database:prepare:dev && turbo watch dev --filter=${application.name}`,
+    };
+}
+function requiredTaskScripts(options) {
+    return [
+        {
+            definition: options.database,
+            names: ["build", "db:reset", "db:seed:example", "test"],
+        },
+        { definition: options.migrations, names: ["db:push", "typecheck"] },
+        {
+            definition: options.application,
+            names: ["build", "browser:prepare", "dev", "typecheck", "test:e2e"],
+        },
+    ];
+}
+function packageManifest(targetRoot, definition, contribution) {
+    const packageManifestPath = path.join(targetRoot, definition.path, "package.json");
+    let value;
+    try {
+        value = JSON.parse(readFileSync(packageManifestPath, "utf8"));
+    }
+    catch (cause) {
+        throw new Error(`Vike 预设无法读取 ${definition.path}/package.json：${cause instanceof Error ? cause.message : String(cause)}`, { cause });
+    }
+    if (typeof value !== "object" ||
+        value === null ||
+        Array.isArray(value) ||
+        value.name !== definition.name) {
+        throw new Error(`Vike 预设的实际包身份与实例不匹配：${definition.name} (${definition.path})`);
+    }
+    const expected = contribution.manifest;
+    if (expected.name !== definition.name) {
+        throw new Error(`Vike 预设来源包身份不匹配：${definition.name}`);
+    }
+    return value;
+}
+function scriptValue(manifest, name) {
+    const scripts = manifest.scripts;
+    return typeof scripts === "object" &&
+        scripts !== null &&
+        !Array.isArray(scripts)
+        ? scripts[name]
+        : undefined;
+}
+function assertPackageDeclarations(options) {
+    const sourceByPath = new Map(options.contributions.map((contribution) => [
+        contribution.definition.path,
+        contribution,
+    ]));
+    for (const { definition, names } of options.packages) {
+        const contribution = sourceByPath.get(definition.path);
+        if (contribution === undefined ||
+            contribution.definition.name !== definition.name ||
+            contribution.manifest.name !== definition.name) {
+            throw new Error(`Vike 预设缺少实际包来源：${definition.name} (${definition.path})`);
+        }
+        for (const name of names) {
+            if (typeof scriptValue(contribution.manifest, name) !== "string") {
+                throw new Error(`Vike 数据准备要求 ${definition.name} 的来源声明 scripts.${name}`);
+            }
+        }
+    }
+    return sourceByPath;
+}
+/** 更新效果阶段保留数据库协作对当前包身份与任务命令的既有保证。 */
+export function validateVikePackageTruth(options) {
+    assertVikePackageRoles(options);
+    const packages = requiredTaskScripts(options);
+    const sourceByPath = assertPackageDeclarations({
+        contributions: options.contributions,
+        packages,
+    });
+    for (const { definition, names } of packages) {
+        const contribution = sourceByPath.get(definition.path);
+        const manifest = packageManifest(options.targetRoot, definition, contribution);
+        for (const name of names) {
+            if (scriptValue(manifest, name) !== scriptValue(contribution.manifest, name)) {
+                throw new Error(`Vike 数据准备要求 ${definition.name} 的 scripts.${name} 与来源包保持一致`);
+            }
+        }
+    }
+}
+function assertVikePackageRoles(options) {
+    if (options.application.role !== "runtime-service") {
+        throw new Error("Vike 应用部署要求应用包具有 runtime-service 角色");
+    }
+    if (options.database.role !== "shared-library" ||
+        options.migrations.role !== "shared-library") {
+        throw new Error("Vike 应用部署要求数据库和迁移包具有 shared-library 角色");
+    }
+    if (new Set([
+        options.application.name,
+        options.database.name,
+        options.migrations.name,
+    ]).size !== 3 ||
+        new Set([
+            options.application.path,
+            options.database.path,
+            options.migrations.path,
+        ]).size !== 3) {
+        throw new Error("Vike 应用部署要求应用、数据库和迁移包是不同实例");
+    }
+}
+function deploymentTask(application, database, migrations) {
+    return {
+        cache: false,
+        dependsOn: [
+            `${application.name}#build`,
+            `${application.name}#browser:prepare`,
+            `${database.name}#build`,
+            `${migrations.name}#build`,
+        ],
+        tags: ["quality:heavy"],
+    };
+}
+export function projectVikeDeploymentContribution(options) {
+    const { application, database, migrations } = options;
+    assertVikePackageRoles({ application, database, migrations });
+    assertPackageDeclarations({
+        contributions: options.contributions,
+        packages: requiredTaskScripts({ application, database, migrations }),
+    });
+    const checkEnvironmentNeeds = [
+        shellCheckEnvironmentNeed({
+            kind: "workspace-orchestration",
+            path: ".",
+        }),
+    ];
+    const deploymentEnvironmentNeeds = [
+        dockerEngineEnvironmentNeed(),
+    ];
+    const dependencyMaintenance = {
+        ecosystems: ["docker"],
+        extraDirectories: { docker: ["/"] },
+        interval: "weekly",
+    };
+    return {
+        kind: "shared-root-files",
+        source: "@ykdz/preset-vike-app/template",
+        manifest: {
+            scripts: {
+                ...preparationScripts({ application, database, migrations }),
+                deployment: "node --conditions=source scripts/check-standalone-deployment.ts",
+            },
+        },
+        turboTasks: {
+            "//#database:prepare:dev": {
+                cache: false,
+                tags: ["work:preparation"],
+            },
+            "//#database:prepare:e2e": {
+                cache: false,
+                tags: ["work:preparation"],
+            },
+            "//#database:prepare:test": {
+                cache: false,
+                tags: ["work:preparation"],
+            },
+            "//#deployment": deploymentTask(application, database, migrations),
+        },
+        ciJob: { name: "Full Check", timeoutMinutes: 45 },
+        ciSteps: [
+            {
+                before: "run-heavy-check",
+                steps: [buildxStep],
+            },
+        ],
+        environmentNeeds: {
+            check: checkEnvironmentNeeds,
+            deployment: deploymentEnvironmentNeeds,
+        },
+        dependencyMaintenance,
+        resources: [
+            { operation: copyResource(rootFiles.dockerfile, "Dockerfile") },
+            {
+                operation: copyResource(rootFiles.dockerIgnore, ".dockerignore"),
+            },
+            {
+                operation: {
+                    kind: "writeText",
+                    to: "scripts/check-standalone-deployment.ts",
+                    text: checkerSource
+                        .replaceAll(JSON.stringify("@ykdz/reference-vike-web"), JSON.stringify(application.name))
+                        .replaceAll(JSON.stringify("references/vike-web"), JSON.stringify(application.path))
+                        .replaceAll(JSON.stringify("@ykdz/reference-vike-db"), JSON.stringify(database.name))
+                        .replaceAll(JSON.stringify("@ykdz/reference-vike-migrations"), JSON.stringify(migrations.name)),
+                    overwrite: true,
+                },
+            },
+            {
+                operation: copyResource(rootFiles.containerEntrypoint, "scripts/container-entrypoint.sh"),
+                executable: true,
+            },
+        ],
+    };
+}

package/node_modules/@ykdz/preset-vike-app/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@ykdz/preset-vike-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/reference-vike-db": "0.0.0",
+    "@ykdz/reference-vike-migrations": "0.0.0",
+    "@ykdz/reference-vike-web": "0.0.0",
+    "@ykdz/template-core": "0.0.0",
+    "@ykdz/template-workspace": "0.0.0",
+    "@ykdz/template-workspace-authoring": "0.0.0",
+    "yaml": "2.9.1"
+  }
+}

package/node_modules/@ykdz/preset-vue-app/native/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@ykdz/preset-vue-app",
+  "version": "0.0.0",
+  "private": true,
+  "files": [
+    "template-dist"
+  ],
+  "type": "module",
+  "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\"",
+    "build": "pnpm run build:template",
+    "build:template": "rm -rf template-dist && tsc -p tsconfig.template.json --pretty false",
+    "format:check": "oxfmt --list-different .",
+    "format:write": "oxfmt --write .",
+    "lint": "oxlint --quiet --format=unix --ignore-pattern template-dist .",
+    "lint:fix": "oxlint --format=unix --ignore-pattern template-dist . --fix",
+    "test": "node --conditions=source --experimental-strip-types --test --test-concurrency=2 --test-timeout=60000 'test/**/*.light.test.ts'",
+    "typecheck": "tsc -p tsconfig.json --noEmit --pretty false"
+  },
+  "dependencies": {
+    "@ykdz/reference-vue-app": "workspace:*",
+    "@ykdz/template-core": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/node": "catalog:",
+    "@ykdz/reference-tooling-config": "workspace:*",
+    "@ykdz/reference-ts-lib": "workspace:*",
+    "@ykdz/template-generator": "workspace:*",
+    "@ykdz/template-workspace": "workspace:*",
+    "@ykdz/template-workspace-authoring": "workspace:*",
+    "oxfmt": "catalog:",
+    "oxlint": "catalog:",
+    "oxlint-tsgolint": "catalog:",
+    "typescript-7": "catalog:"
+  }
+}

package/node_modules/@ykdz/preset-vue-app/native/template-dist/definition.d.ts

@@ -0,0 +1,23 @@
+export declare const preset: {
+    readonly kind: "preset";
+    readonly metadata: {
+        readonly alias: string;
+        readonly title: string;
+        readonly description: string;
+    };
+    readonly operations: readonly import("@ykdz/template-core/preset-definition").PresetOperation[];
+    readonly nodes: Readonly<Record<string, import("@ykdz/template-core/preset-definition").PresetNode<import("@ykdz/template-workspace/reference-package").ReferencePackage<import("@ykdz/template-core/workspace-strategy").PackageCreationInput<unknown>, undefined>, never, never>>>;
+} & {
+    readonly owner?: import("@ykdz/template-core/preset-definition").PresetOwnerDeclaration;
+    readonly validateUpdate?: never;
+    readonly project?: never;
+} & {
+    readonly nodes: {
+        readonly web: {
+            reference: import("@ykdz/template-workspace/reference-package").ReferencePackage<import("@ykdz/template-core/workspace-strategy").PackageCreationInput<unknown>, undefined>;
+        };
+    };
+} & {
+    readonly prepareArtifact: () => import("@ykdz/template-workspace-authoring/content-artifact").PreparedNativeContentArtifact;
+};
+//# sourceMappingURL=definition.d.ts.map

package/node_modules/@ykdz/preset-vue-app/native/template-dist/definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../template/definition.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;YAUN,SAAS;;;;;CASrB,CAAC"}

package/node_modules/@ykdz/preset-vue-app/native/template-dist/definition.js

@@ -0,0 +1,21 @@
+import { referencePackage } from "@ykdz/reference-vue-app/template";
+import { definePreset, presetOwnerFromManifest, } from "@ykdz/template-core/preset-definition";
+import { defineNativeContentArtifact } from "@ykdz/template-workspace-authoring/content-artifact";
+import presetPackage from "../package.json" with { type: "json" };
+export const preset = defineNativeContentArtifact(definePreset({
+    metadata: {
+        alias: "vue-app",
+        title: "Vue 应用",
+        description: "使用 Vite、Tailwind、Pinia 和测试工具的 Vue 应用工作区。",
+    },
+    operations: ["init", "add"],
+    owner: presetOwnerFromManifest(presetPackage, "./template"),
+    nodes: {
+        web: { reference: referencePackage },
+    },
+}), {
+    manifest: presetPackage,
+    resourceRoot: new URL("../", import.meta.url),
+    exportPath: "./template",
+    executionDependencies: ["@ykdz/template-workspace-authoring"],
+});

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

@@ -0,0 +1,20 @@
+{
+  "name": "@ykdz/preset-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/reference-vue-app": "0.0.0",
+    "@ykdz/template-core": "0.0.0",
+    "@ykdz/template-workspace-authoring": "0.0.0"
+  }
+}

package/node_modules/@ykdz/preset-vue-hono-app/native/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@ykdz/preset-vue-hono-app",
+  "version": "0.0.0",
+  "private": true,
+  "files": [
+    "template-dist",
+    "resources"
+  ],
+  "type": "module",
+  "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\"",
+    "build": "pnpm run build:template",
+    "build:template": "rm -rf template-dist && tsc -p tsconfig.template.json --pretty false",
+    "format:check": "oxfmt --list-different .",
+    "format:write": "oxfmt --write .",
+    "lint": "oxlint --quiet --format=unix --ignore-pattern template-dist .",
+    "lint:fix": "oxlint --format=unix --ignore-pattern template-dist . --fix",
+    "test": "node --conditions=source --experimental-strip-types --test --test-concurrency=2 --test-timeout=60000 'test/**/*.light.test.ts'",
+    "test:e2e": "playwright test --config resources/joint-e2e/playwright.config.ts",
+    "typecheck": "tsc -p tsconfig.json --noEmit --pretty false"
+  },
+  "dependencies": {
+    "@ykdz/reference-hono-api": "workspace:*",
+    "@ykdz/reference-vue-hono-web": "workspace:*",
+    "@ykdz/template-core": "workspace:*",
+    "@ykdz/template-workspace-authoring": "workspace:*"
+  },
+  "devDependencies": {
+    "@playwright/test": "catalog:",
+    "@types/node": "catalog:",
+    "@ykdz/reference-tooling-config": "workspace:*",
+    "@ykdz/reference-ts-cli": "workspace:*",
+    "@ykdz/reference-ts-lib": "workspace:*",
+    "@ykdz/template-generator": "workspace:*",
+    "@ykdz/template-workspace": "workspace:*",
+    "oxfmt": "catalog:",
+    "oxlint": "catalog:",
+    "oxlint-tsgolint": "catalog:",
+    "typescript": "catalog:",
+    "typescript-7": "catalog:"
+  }
+}

package/node_modules/@ykdz/preset-vue-hono-app/native/resources/joint-e2e/playwright.config.ts

@@ -0,0 +1,35 @@
+import { defineConfig, devices } from "@playwright/test";
+
+const apiPackageName = "@ykdz/reference-hono-api";
+const webPackageName = "@ykdz/reference-vue-hono-web";
+
+const apiPort = process.env.PLAYWRIGHT_API_PORT ?? "0";
+const webPort = process.env.PLAYWRIGHT_WEB_PORT ?? "0";
+
+export default defineConfig({
+  testDir: "./test/e2e",
+  reporter: [["list"], ["html"]],
+  use: {
+    trace: "retain-on-failure",
+    ...devices["Desktop Chrome"],
+  },
+  webServer: [
+    {
+      command: `pnpm --filter ${apiPackageName} --fail-if-no-match run start`,
+      env: { PORT: apiPort },
+      wait: {
+        stdout:
+          /Hono API listening on (?<VITE_API_BASE_URL>http:\/\/localhost:\d+)/,
+      },
+      reuseExistingServer: false,
+    },
+    {
+      command: `pnpm --filter ${webPackageName} --fail-if-no-match run preview --host 127.0.0.1 --strictPort`,
+      env: { PLAYWRIGHT_WEB_PORT: webPort },
+      wait: {
+        stdout: /Local:\s+(?<PLAYWRIGHT_WEB_URL>http:\/\/127\.0\.0\.1:\d+)/,
+      },
+      reuseExistingServer: false,
+    },
+  ],
+});

package/node_modules/@ykdz/preset-vue-hono-app/native/resources/joint-e2e/test/e2e/app.spec.ts

@@ -0,0 +1,10 @@
+import { expect, test } from "./fixtures.ts";
+
+test("renders the web app and calls the API", async ({ page, webUrl }) => {
+  await page.goto(webUrl);
+
+  await expect(
+    page.getByRole("heading", { name: "Vue 和 Hono 工作区" }),
+  ).toBeVisible();
+  await expect(page.getByText("API 状态：正常")).toBeVisible();
+});

package/node_modules/@ykdz/preset-vue-hono-app/native/template-dist/definition.d.ts

@@ -0,0 +1,33 @@
+import { type PresetProjectOptions } from "@ykdz/template-core/preset-definition";
+import type { GenerationContext } from "@ykdz/template-workspace/generation-context";
+import type { PackageContribution } from "@ykdz/template-workspace/package-contribution";
+import type { PackageLinkRequirement } from "@ykdz/template-workspace/project-requirements";
+import type { SharedRootContribution } from "@ykdz/template-workspace/shared-root-files";
+export declare const preset: {
+    readonly kind: "preset";
+    readonly metadata: {
+        readonly alias: string;
+        readonly title: string;
+        readonly description: string;
+    };
+    readonly operations: readonly import("@ykdz/template-core/preset-definition").PresetOperation[];
+    readonly nodes: Readonly<Record<string, import("@ykdz/template-core/preset-definition").PresetNode<import("@ykdz/template-workspace/reference-package").ReferencePackage<import("@ykdz/template-core/workspace-strategy").PackageCreationInput<unknown>, undefined>, never, never>>>;
+} & {
+    readonly owner?: import("@ykdz/template-core/preset-definition").PresetOwnerDeclaration;
+    readonly validateUpdate?: (options: PresetProjectOptions<GenerationContext, PackageContribution> & {
+        readonly targetRoot: string;
+    }) => void | Promise<void>;
+    readonly project?: (options: PresetProjectOptions<GenerationContext, PackageContribution>) => readonly (PackageLinkRequirement | SharedRootContribution)[];
+} & {
+    readonly nodes: {
+        readonly web: {
+            reference: import("@ykdz/template-workspace/reference-package").ReferencePackage<import("@ykdz/template-core/workspace-strategy").PackageCreationInput<unknown>, undefined>;
+        };
+        readonly api: {
+            reference: import("@ykdz/template-workspace/reference-package").ReferencePackage<import("@ykdz/template-core/workspace-strategy").PackageCreationInput<unknown>, undefined>;
+        };
+    };
+} & {
+    readonly prepareArtifact: () => import("@ykdz/template-workspace-authoring/content-artifact").PreparedNativeContentArtifact;
+};
+//# sourceMappingURL=definition.d.ts.map

package/node_modules/@ykdz/preset-vue-hono-app/native/template-dist/definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../template/definition.ts"],"names":[],"mappings":"AAKA,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,uCAAuC,CAAC;AAI/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAC;AACrF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+CAA+C,CAAC;AACzF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+CAA+C,CAAC;AAC5F,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAC;AAsIzF,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;YASN,SAAS;;;YACT,SAAS;;;;;CAkBrB,CAAC"}