@ykdz/template 0.0.33 → 0.0.36

package/node_modules/@ykdz/template-core/dist/toolchain-resolution.js

@@ -2,7 +2,7 @@ export const nodeReleaseIndexUrl = "https://nodejs.org/dist/index.json";
 export const pnpmRegistryUrl = "https://registry.npmjs.org/pnpm";
 const bundledFallbackToolchain = {
     nodeLtsMajor: nodeLtsMajor("24"),
-    packageManagerPin: packageManagerPin("11.11.0"),
+    packageManagerPin: packageManagerPin("11.21.0"),
 };
 export async function resolveToolchainVersions(options = {}) {
     const source = options.source ?? "online";
@@ -66,14 +66,20 @@ function fallbackResult(diagnostics) {
         diagnostics,
     };
 }
+export function isValidNodeLtsMajor(value) {
+    return /^\d+$/.test(value);
+}
+export function isValidPackageManagerPin(value) {
+    return /^pnpm@\d+\.\d+\.\d+(?:[-+][0-9A-Za-z.-]+)?$/.test(value);
+}
 function nodeLtsMajor(value) {
-    if (!/^\d+$/.test(value)) {
+    if (!isValidNodeLtsMajor(value)) {
         throw new Error(`Invalid Node LTS major: ${value}`);
     }
     return { kind: "NodeLtsMajor", value };
 }
 function packageManagerPin(version) {
-    if (!/^\d+\.\d+\.\d+(?:[-+][0-9A-Za-z.-]+)?$/.test(version)) {
+    if (!isValidPackageManagerPin(`pnpm@${version}`)) {
         throw new Error(`Invalid pnpm version: ${version}`);
     }
     return { kind: "PackageManagerPin", value: `pnpm@${version}` };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ykdz/template",
-  "version": "0.0.33",
+  "version": "0.0.36",
   "private": false,
   "description": "Project template generator for YKDZ starter projects.",
   "keywords": [
@@ -67,9 +67,9 @@
     "@types/node": "^24.13.3",
     "@ykdz/template-builtin-presets-source": "link:../builtin-presets",
     "@ykdz/template-core-source": "link:../core",
-    "execa": "^10.0.0",
+    "execa": "^10.0.1",
     "oxfmt": "^0.58.0",
-    "oxlint": "^1.73.0",
+    "oxlint": "^1.77.0",
     "oxlint-tsgolint": "^7.0.2001",
     "typescript-7": "npm:typescript@^7.0.2",
     "vitest": "^4.1.10"

package/node_modules/@ykdz/template-builtin-presets/templates/vike-app/db-migrations/scripts/prepare-database.ts

@@ -1,45 +0,0 @@
-import { execFileSync } from "node:child_process";
-import { mkdirSync, rmSync } from "node:fs";
-import path from "node:path";
-
-const mode = process.argv[2];
-
-if (mode !== "dev" && mode !== "test") {
-  throw new Error("Usage: node scripts/prepare-database.ts <dev|test>");
-}
-
-const packageDirectory = process.cwd();
-const databaseFile = process.env.DATABASE_FILE
-  ? path.resolve(
-      process.env.INIT_CWD ?? packageDirectory,
-      process.env.DATABASE_FILE,
-    )
-  : path.resolve(packageDirectory, "../../apps/web/data/app.sqlite");
-const environment = { ...process.env, DATABASE_FILE: databaseFile };
-
-mkdirSync(path.dirname(databaseFile), { recursive: true });
-if (mode === "test") {
-  rmSync(databaseFile, { force: true });
-}
-
-execFileSync("pnpm", ["run", "db:push"], {
-  cwd: packageDirectory,
-  env: environment,
-  stdio: "inherit",
-});
-const databasePackageName = process.env.DATABASE_PACKAGE_NAME;
-if (!databasePackageName) {
-  throw new Error(
-    "DATABASE_PACKAGE_NAME must name the database Package Boundary",
-  );
-}
-
-execFileSync(
-  "pnpm",
-  ["--filter", databasePackageName, "run", "db:seed:example"],
-  {
-    cwd: packageDirectory,
-    env: environment,
-    stdio: "inherit",
-  },
-);

package/node_modules/@ykdz/template-builtin-presets/templates/vike-app/web/scripts/run-playwright.ts

@@ -1,151 +0,0 @@
-import { spawn } from "node:child_process";
-import { mkdir, rm } from "node:fs/promises";
-import { createServer } from "node:net";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-
-const databaseFile = fileURLToPath(
-  new URL("../node_modules/.tmp/e2e.sqlite", import.meta.url),
-);
-const externalBaseUrlName = "PLAYWRIGHT_EXTERNAL_BASE_URL";
-const externalReadinessTimeoutMs = 30_000;
-
-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 localPlaywrightEnv(): Promise<NodeJS.ProcessEnv> {
-  return {
-    ...process.env,
-    DATABASE_FILE: process.env.DATABASE_FILE ?? databaseFile,
-    PLAYWRIGHT_WEB_PORT:
-      process.env.PLAYWRIGHT_WEB_PORT ?? (await availablePort()),
-  };
-}
-
-const externalServiceUrl = externalBaseUrl();
-const env = externalServiceUrl
-  ? { ...process.env }
-  : await localPlaywrightEnv();
-const localDatabaseFile = externalServiceUrl ? undefined : env.DATABASE_FILE;
-delete env.NO_COLOR;
-
-if (externalServiceUrl) {
-  await awaitExternalService(externalServiceUrl);
-} else {
-  await mkdir(path.dirname(localDatabaseFile!), { recursive: true });
-  await rm(localDatabaseFile!, { force: true });
-}
-
-const command = process.platform === "win32" ? "playwright.cmd" : "playwright";
-const child = spawn(command, ["test", ...process.argv.slice(2)], {
-  env,
-  stdio: "inherit",
-});
-
-const forwardedSignals = ["SIGINT", "SIGTERM"] as const;
-const forwardSignal = (signal: NodeJS.Signals): void => {
-  child.kill(signal);
-};
-for (const signal of forwardedSignals) {
-  process.once(signal, forwardSignal);
-}
-
-try {
-  const result = await new Promise<{
-    code: number | null;
-    signal: NodeJS.Signals | null;
-  }>((resolve, reject) => {
-    child.once("error", reject);
-    child.once("exit", (code, signal) => resolve({ code, signal }));
-  });
-
-  if (result.signal) {
-    console.error(`Playwright exited with signal ${result.signal}`);
-    process.exitCode = 1;
-  } else {
-    process.exitCode = result.code ?? 1;
-  }
-} catch (error) {
-  console.error(error);
-  process.exitCode = 1;
-} finally {
-  for (const signal of forwardedSignals) {
-    process.removeListener(signal, forwardSignal);
-  }
-
-  if (localDatabaseFile) {
-    await rm(localDatabaseFile, { force: true });
-  }
-}

package/node_modules/@ykdz/template-builtin-presets/templates/vue-app/scripts/run-playwright.ts

@@ -1,62 +0,0 @@
-import { spawn } from "node:child_process";
-import { createServer } from "node:net";
-
-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 playwrightEnv(): Promise<NodeJS.ProcessEnv> {
-  return {
-    ...process.env,
-    PLAYWRIGHT_WEB_PORT:
-      process.env.PLAYWRIGHT_WEB_PORT ?? (await availablePort()),
-  };
-}
-
-const env = await playwrightEnv();
-delete env.NO_COLOR;
-
-const command = process.platform === "win32" ? "playwright.cmd" : "playwright";
-const child = spawn(command, ["test", ...process.argv.slice(2)], {
-  env,
-  stdio: "inherit",
-});
-
-child.once("error", (error: Error) => {
-  console.error(error);
-  process.exitCode = 1;
-});
-
-child.once("exit", (code: number | null, signal: NodeJS.Signals | null) => {
-  if (signal) {
-    console.error(`Playwright exited with signal ${signal}`);
-    process.exitCode = 1;
-    return;
-  }
-
-  process.exitCode = code ?? 1;
-});

package/node_modules/@ykdz/template-builtin-presets/templates/vue-hono-app/web/scripts/run-playwright.ts

@@ -1,103 +0,0 @@
-import { spawn } from "node:child_process";
-import { createServer } from "node:net";
-
-async function listenOnAvailablePort(): Promise<{
-  readonly port: string;
-  readonly server: ReturnType<typeof createServer>;
-}> {
-  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 server port"));
-        });
-        return;
-      }
-
-      resolve({ port: String(address.port), server });
-    });
-  });
-}
-
-async function availablePorts(count: number): Promise<string[]> {
-  const leases: Array<{
-    readonly port: string;
-    readonly server: ReturnType<typeof createServer>;
-  }> = [];
-
-  try {
-    for (let index = 0; index < count; index += 1) {
-      leases.push(await listenOnAvailablePort());
-    }
-
-    return leases.map((lease) => lease.port);
-  } finally {
-    await Promise.all(
-      leases.map(
-        (lease) =>
-          new Promise<void>((resolve, reject) => {
-            lease.server.close((error) => {
-              if (error) {
-                reject(error);
-                return;
-              }
-
-              resolve();
-            });
-          }),
-      ),
-    );
-  }
-}
-
-async function playwrightEnv(): Promise<NodeJS.ProcessEnv> {
-  const missingPortNames = [
-    process.env.PLAYWRIGHT_API_PORT === undefined
-      ? "PLAYWRIGHT_API_PORT"
-      : undefined,
-    process.env.PLAYWRIGHT_WEB_PORT === undefined
-      ? "PLAYWRIGHT_WEB_PORT"
-      : undefined,
-  ].filter((name) => name !== undefined);
-  const ports = await availablePorts(missingPortNames.length);
-  const allocatedPorts = Object.fromEntries(
-    missingPortNames.map((name, index) => [name, ports[index]]),
-  );
-
-  return {
-    ...process.env,
-    PLAYWRIGHT_API_PORT:
-      process.env.PLAYWRIGHT_API_PORT ?? allocatedPorts.PLAYWRIGHT_API_PORT,
-    PLAYWRIGHT_WEB_PORT:
-      process.env.PLAYWRIGHT_WEB_PORT ?? allocatedPorts.PLAYWRIGHT_WEB_PORT,
-  };
-}
-
-const env = await playwrightEnv();
-delete env.NO_COLOR;
-
-const command = process.platform === "win32" ? "playwright.cmd" : "playwright";
-const child = spawn(command, ["test", ...process.argv.slice(2)], {
-  env,
-  stdio: "inherit",
-});
-
-child.once("error", (error: Error) => {
-  console.error(error);
-  process.exitCode = 1;
-});
-
-child.once("exit", (code: number | null, signal: NodeJS.Signals | null) => {
-  if (signal) {
-    console.error(`Playwright exited with signal ${signal}`);
-    process.exitCode = 1;
-    return;
-  }
-
-  process.exitCode = code ?? 1;
-});

package/node_modules/@ykdz/template-core/dist/project-blueprint-v2.d.ts

@@ -1,33 +0,0 @@
-/**
- * The durable, preset-agnostic topology used by local template follow-up
- * operations. Preset provenance deliberately belongs in Generation Record.
- */
-export type PackageRole = "cli-tool" | "runtime-service" | "shared-library" | "native-package";
-export type PackageDefinition = {
-    readonly name: string;
-    readonly path: string;
-    readonly role: PackageRole;
-};
-export type PackageLinkIntent = {
-    readonly consumerPackagePath: string;
-    readonly providerPackagePath: string;
-};
-export type ProjectBlueprintV2 = {
-    readonly schemaVersion: 2;
-    readonly packages: readonly PackageDefinition[];
-    readonly packageLinkIntents?: readonly PackageLinkIntent[];
-};
-export type BlueprintV2ValidationIssue = {
-    readonly path: string;
-    readonly message: string;
-};
-export type BlueprintV2ValidationResult = {
-    readonly ok: true;
-    readonly value: ProjectBlueprintV2;
-} | {
-    readonly ok: false;
-    readonly issues: readonly BlueprintV2ValidationIssue[];
-};
-/** Validates persisted metadata before it is used to plan or render changes. */
-export declare function validateProjectBlueprintV2(value: unknown): BlueprintV2ValidationResult;
-export declare function assertProjectBlueprintV2(value: unknown): ProjectBlueprintV2;

package/node_modules/@ykdz/template-core/dist/project-blueprint-v2.js

@@ -1,182 +0,0 @@
-const packageName = /^@[a-z0-9][a-z0-9-]*\/[a-z0-9][a-z0-9-]*$/;
-const packagePath = /^[a-z0-9][a-z0-9-]*\/[a-z0-9][a-z0-9-]*$/;
-const reservedWorkspaceCollections = new Set([
-    ".git",
-    ".github",
-    ".devcontainer",
-    ".template",
-    "node_modules",
-    "dist",
-    "target",
-]);
-const roles = new Set([
-    "cli-tool",
-    "runtime-service",
-    "shared-library",
-    "native-package",
-]);
-function isRecord(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function reportUnknownKeys(value, allowed, path, issues) {
-    for (const key of Object.keys(value)) {
-        if (!allowed.includes(key)) {
-            issues.push({
-                path: `${path}.${key}`,
-                message: "Unknown Blueprint v2 field",
-            });
-        }
-    }
-}
-/** Validates persisted metadata before it is used to plan or render changes. */
-export function validateProjectBlueprintV2(value) {
-    const issues = [];
-    if (!isRecord(value)) {
-        return {
-            ok: false,
-            issues: [
-                { path: ".", message: "Local Template Metadata must be an object" },
-            ],
-        };
-    }
-    reportUnknownKeys(value, ["schemaVersion", "packages", "packageLinkIntents"], ".", issues);
-    if (value.schemaVersion !== 2) {
-        issues.push({
-            path: ".schemaVersion",
-            message: `Unsupported Local Template Metadata schema version ${String(value.schemaVersion)}; expected 2`,
-        });
-    }
-    if (!Array.isArray(value.packages)) {
-        issues.push({
-            path: ".packages",
-            message: "Package Definitions must be an array",
-        });
-    }
-    const definitions = [];
-    if (Array.isArray(value.packages)) {
-        for (const [index, item] of value.packages.entries()) {
-            const itemPath = `.packages[${index}]`;
-            if (!isRecord(item)) {
-                issues.push({
-                    path: itemPath,
-                    message: "Package Definition must be an object",
-                });
-                continue;
-            }
-            reportUnknownKeys(item, ["name", "path", "role"], itemPath, issues);
-            const workspaceCollection = typeof item.path === "string" ? item.path.split("/", 1)[0] : undefined;
-            const usesReservedWorkspaceCollection = workspaceCollection !== undefined &&
-                reservedWorkspaceCollections.has(workspaceCollection);
-            if (typeof item.name !== "string" || !packageName.test(item.name)) {
-                issues.push({
-                    path: `${itemPath}.name`,
-                    message: "Package name must be a scoped lowercase package name",
-                });
-            }
-            if (usesReservedWorkspaceCollection) {
-                issues.push({
-                    path: `${itemPath}.path`,
-                    message: `Package Path ${item.path} uses reserved workspace collection ${workspaceCollection}`,
-                });
-            }
-            else if (typeof item.path !== "string" ||
-                !packagePath.test(item.path)) {
-                issues.push({
-                    path: `${itemPath}.path`,
-                    message: "Package Path must be exactly two safe path segments",
-                });
-            }
-            if (typeof item.role !== "string" ||
-                !roles.has(item.role)) {
-                issues.push({
-                    path: `${itemPath}.role`,
-                    message: "Package Role must be cli-tool, runtime-service, shared-library, or native-package",
-                });
-            }
-            if (typeof item.name === "string" &&
-                typeof item.path === "string" &&
-                typeof item.role === "string" &&
-                packageName.test(item.name) &&
-                packagePath.test(item.path) &&
-                !usesReservedWorkspaceCollection &&
-                roles.has(item.role)) {
-                definitions.push(item);
-            }
-        }
-    }
-    for (const [property, label] of [
-        ["name", "Package name"],
-        ["path", "Package Path"],
-    ]) {
-        const seen = new Set();
-        for (const definition of definitions) {
-            const member = definition[property];
-            if (seen.has(member))
-                issues.push({
-                    path: ".packages",
-                    message: `${label} must be unique: ${member}`,
-                });
-            seen.add(member);
-        }
-    }
-    if (value.packageLinkIntents !== undefined &&
-        !Array.isArray(value.packageLinkIntents)) {
-        issues.push({
-            path: ".packageLinkIntents",
-            message: "Package Link Intents must be an array",
-        });
-    }
-    const paths = new Set(definitions.map((definition) => definition.path));
-    const links = new Set();
-    if (Array.isArray(value.packageLinkIntents)) {
-        for (const [index, item] of value.packageLinkIntents.entries()) {
-            const itemPath = `.packageLinkIntents[${index}]`;
-            if (!isRecord(item)) {
-                issues.push({
-                    path: itemPath,
-                    message: "Package Link Intent must be an object",
-                });
-                continue;
-            }
-            reportUnknownKeys(item, ["consumerPackagePath", "providerPackagePath"], itemPath, issues);
-            const consumer = item.consumerPackagePath;
-            const provider = item.providerPackagePath;
-            if (typeof consumer !== "string" || !paths.has(consumer))
-                issues.push({
-                    path: `${itemPath}.consumerPackagePath`,
-                    message: "Package Link Intent references an unknown consumer package",
-                });
-            if (typeof provider !== "string" || !paths.has(provider))
-                issues.push({
-                    path: `${itemPath}.providerPackagePath`,
-                    message: "Package Link Intent references an unknown provider package",
-                });
-            if (consumer === provider && typeof consumer === "string")
-                issues.push({
-                    path: itemPath,
-                    message: "Package Link Intent cannot link a package to itself",
-                });
-            if (typeof consumer === "string" && typeof provider === "string") {
-                const key = `${consumer}\u0000${provider}`;
-                if (links.has(key))
-                    issues.push({
-                        path: itemPath,
-                        message: "Package Link Intent must be unique",
-                    });
-                links.add(key);
-            }
-        }
-    }
-    return issues.length === 0
-        ? { ok: true, value: value }
-        : { ok: false, issues };
-}
-export function assertProjectBlueprintV2(value) {
-    const result = validateProjectBlueprintV2(value);
-    if (!result.ok) {
-        throw new Error(result.issues
-            .map((issue) => `${issue.path}: ${issue.message}`)
-            .join("\n"));
-    }
-    return result.value;
-}