@elench/testkit 0.1.66 → 0.1.68

package/lib/setup/next-runtime-tsconfig.test.mjs

@@ -0,0 +1,57 @@
+import fs from "fs";
+import os from "os";
+import path from "path";
+import { afterEach, describe, expect, it } from "vitest";
+import { writeNextRuntimeTsconfig } from "./next-runtime-tsconfig.mjs";
+
+const cleanups = [];
+
+afterEach(() => {
+  while (cleanups.length > 0) {
+    cleanups.pop()();
+  }
+});
+
+describe("next runtime tsconfig helper", () => {
+  it("writes a runtime-specific tsconfig for next builds", async () => {
+    const tempRoot = fs.mkdtempSync(path.join(os.tmpdir(), "testkit-next-tsconfig-"));
+    cleanups.push(() => fs.rmSync(tempRoot, { recursive: true, force: true }));
+
+    const serviceDir = path.join(tempRoot, "frontend");
+    const prepareDir = path.join(tempRoot, ".testkit", "prepared");
+    fs.mkdirSync(path.join(serviceDir, "src"), { recursive: true });
+    fs.writeFileSync(path.join(serviceDir, "tsconfig.json"), "{}\n");
+    fs.writeFileSync(path.join(serviceDir, "next-env.d.ts"), "// next\n");
+
+    await writeNextRuntimeTsconfig({
+      cwd: serviceDir,
+      prepareDir,
+      productDir: tempRoot,
+    });
+
+    const generated = JSON.parse(fs.readFileSync(path.join(prepareDir, "tsconfig.json"), "utf8"));
+    expect(generated).toEqual({
+      extends: "../../frontend/tsconfig.json",
+      compilerOptions: {
+        paths: {
+          "@/*": ["../../frontend/src/*"],
+        },
+      },
+      include: [
+        "../../frontend/next-env.d.ts",
+        "../../frontend/src/**/*.ts",
+        "../../frontend/src/**/*.tsx",
+        "../../frontend/src/**/*.mts",
+        "dist/types/**/*.ts",
+        "dist/dev/types/**/*.ts",
+      ],
+      exclude: [
+        "node_modules",
+        "../../frontend/src/**/__testkit__/**",
+        "../../frontend/tests/**",
+        ".next/cache",
+        ".next/dev",
+      ],
+    });
+  });
+});

package/lib/shared/build-config.mjs

@@ -0,0 +1,208 @@
+import path from "path";
+import { normalizeConfiguredInputs, normalizeConfiguredSteps, normalizeOptionalString } from "./configured-steps.mjs";
+
+export function normalizeBuildConfig(value, label) {
+  if (value == null) return null;
+  if (!value || typeof value !== "object") {
+    throw new Error(`${label} must be an object`);
+  }
+
+  const kind = normalizeOptionalString(value.kind);
+  if (kind === "tsc") {
+    return {
+      kind,
+      cwd: normalizeOptionalString(value.cwd),
+      entry: normalizeOptionalString(value.entry) || "src/index.ts",
+      tsconfig: normalizeOptionalString(value.tsconfig) || "tsconfig.json",
+      outDir: normalizeOptionalString(value.outDir) || "dist",
+      inputs: normalizeConfiguredInputs(value.inputs, `${label}.inputs`),
+    };
+  }
+
+  if (kind === "script") {
+    const script = normalizeOptionalString(value.script);
+    if (!script) throw new Error(`${label}.script must be a non-empty string`);
+    return {
+      kind,
+      cwd: normalizeOptionalString(value.cwd),
+      script,
+      inputs: normalizeConfiguredInputs(value.inputs, `${label}.inputs`),
+    };
+  }
+
+  if (kind === "next") {
+    return {
+      kind,
+      cwd: normalizeOptionalString(value.cwd),
+      distDir: normalizeOptionalString(value.distDir) || "dist",
+      tsconfig: normalizeOptionalString(value.tsconfig) || "tsconfig.json",
+      inputs: normalizeConfiguredInputs(value.inputs, `${label}.inputs`),
+    };
+  }
+
+  if (kind === "steps") {
+    return {
+      kind,
+      inputs: normalizeConfiguredInputs(value.inputs, `${label}.inputs`),
+      steps: normalizeConfiguredSteps(value.steps, `${label}.steps`),
+    };
+  }
+
+  throw new Error(`${label}.kind must be one of: tsc, script, next, steps`);
+}
+
+export function finalizeBuildConfig(build, transform) {
+  if (!build) return null;
+  if (build.kind === "tsc") {
+    return {
+      ...build,
+      cwd: build.cwd ? transform(build.cwd) : build.cwd,
+      entry: transform(build.entry),
+      tsconfig: transform(build.tsconfig),
+      outDir: transform(build.outDir),
+      inputs: build.inputs.map((input) => transform(input)),
+    };
+  }
+  if (build.kind === "script") {
+    return {
+      ...build,
+      cwd: build.cwd ? transform(build.cwd) : build.cwd,
+      script: transform(build.script),
+      inputs: build.inputs.map((input) => transform(input)),
+    };
+  }
+  if (build.kind === "next") {
+    return {
+      ...build,
+      cwd: build.cwd ? transform(build.cwd) : build.cwd,
+      distDir: transform(build.distDir),
+      tsconfig: transform(build.tsconfig),
+      inputs: build.inputs.map((input) => transform(input)),
+    };
+  }
+  return {
+    ...build,
+    inputs: build.inputs.map((input) => transform(input)),
+    steps: build.steps.map((step) => ({
+      ...step,
+      ...(typeof step.cmd === "string" ? { cmd: transform(step.cmd) } : {}),
+      ...(typeof step.cwd === "string" ? { cwd: transform(step.cwd) } : {}),
+      ...(typeof step.path === "string" ? { path: transform(step.path) } : {}),
+      ...(typeof step.specifier === "string" ? { specifier: transform(step.specifier) } : {}),
+      inputs: (step.inputs || []).map((input) => transform(input)),
+    })),
+  };
+}
+
+export function buildConfigToPrepare(build) {
+  if (!build) {
+    return {
+      inputs: [],
+      steps: [],
+    };
+  }
+
+  if (build.kind === "steps") {
+    return {
+      inputs: [...build.inputs],
+      steps: [...build.steps],
+    };
+  }
+
+  if (build.kind === "script") {
+    return {
+      inputs: [...build.inputs],
+      steps: [
+        {
+          kind: "command",
+          cmd: build.script,
+          cwd: build.cwd || undefined,
+          inputs: [...build.inputs],
+        },
+      ],
+    };
+  }
+
+  if (build.kind === "next") {
+    const inputs = build.inputs.length > 0 ? [...build.inputs] : defaultNextInputs(build);
+    return {
+      inputs,
+      steps: [
+        {
+          kind: "module",
+          specifier: "@elench/testkit/setup/next-runtime-tsconfig#writeNextRuntimeTsconfig",
+          cwd: build.cwd || undefined,
+          inputs,
+        },
+        {
+          kind: "command",
+          cmd: "./node_modules/.bin/next build",
+          cwd: build.cwd || undefined,
+          inputs,
+        },
+      ],
+    };
+  }
+
+  const inputs = build.inputs.length > 0 ? [...build.inputs] : defaultTscInputs(build);
+  const cmd = `./node_modules/.bin/tsc -p ${build.tsconfig} --outDir "{prepareDir}/${build.outDir}"`;
+  return {
+    inputs,
+    steps: [
+      {
+        kind: "command",
+        cmd,
+        cwd: build.cwd || undefined,
+        inputs,
+      },
+    ],
+  };
+}
+
+export function compiledEntryFromBuild(build) {
+  if (!build || build.kind !== "tsc") return null;
+  return path.posix.join(build.outDir, sourceEntryToOutputPath(build.entry));
+}
+
+function sourceEntryToOutputPath(entry) {
+  const normalized = String(entry).split(path.sep).join("/");
+  const withoutExtension = normalized.replace(/\.[cm]?[jt]sx?$/i, ".js");
+  if (withoutExtension.startsWith("src/")) {
+    return withoutExtension.slice(4);
+  }
+  return withoutExtension;
+}
+
+function defaultTscInputs(build) {
+  const inputs = new Set([
+    prefixConfiguredPath(build.cwd, build.tsconfig),
+    prefixConfiguredPath(build.cwd, "package.json"),
+  ]);
+  const normalizedEntry = prefixConfiguredPath(build.cwd, String(build.entry).split(path.sep).join("/"));
+  const topLevelDir = normalizedEntry.includes("/") ? normalizedEntry.slice(0, normalizedEntry.indexOf("/")) : normalizedEntry;
+  if (topLevelDir) {
+    inputs.add(topLevelDir);
+  }
+  return [...inputs];
+}
+
+function defaultNextInputs(build) {
+  const inputs = new Set([
+    prefixConfiguredPath(build.cwd, build.tsconfig),
+    prefixConfiguredPath(build.cwd, "package.json"),
+    prefixConfiguredPath(build.cwd, "src"),
+    prefixConfiguredPath(build.cwd, "app"),
+    prefixConfiguredPath(build.cwd, "public"),
+    prefixConfiguredPath(build.cwd, "next.config.js"),
+    prefixConfiguredPath(build.cwd, "next.config.mjs"),
+    prefixConfiguredPath(build.cwd, "next.config.ts"),
+  ]);
+  return [...inputs];
+}
+
+function prefixConfiguredPath(cwd, value) {
+  const normalizedCwd = String(cwd || "").split(path.sep).join("/").replace(/^\.\/+/, "").replace(/\/+$/g, "");
+  const normalizedValue = String(value).split(path.sep).join("/").replace(/^\.\/+/, "");
+  if (!normalizedCwd || normalizedCwd === ".") return normalizedValue;
+  return `${normalizedCwd}/${normalizedValue}`.replace(/\/+/g, "/");
+}

package/lib/shared/build-config.test.mjs

@@ -0,0 +1,150 @@
+import { describe, expect, it } from "vitest";
+import {
+  buildConfigToPrepare,
+  compiledEntryFromBuild,
+  normalizeBuildConfig,
+} from "./build-config.mjs";
+
+describe("shared build config helpers", () => {
+  it("normalizes tsc build config and derives prepare steps", () => {
+    const build = normalizeBuildConfig(
+      {
+        kind: "tsc",
+        entry: "src/server.ts",
+        outDir: "dist",
+      },
+      "runtime.build"
+    );
+
+    expect(build).toEqual({
+      kind: "tsc",
+      cwd: null,
+      entry: "src/server.ts",
+      tsconfig: "tsconfig.json",
+      outDir: "dist",
+      inputs: [],
+    });
+    expect(compiledEntryFromBuild(build)).toBe("dist/server.js");
+    expect(buildConfigToPrepare(build)).toEqual({
+      inputs: ["tsconfig.json", "package.json", "src"],
+      steps: [
+        {
+          kind: "command",
+          cmd: './node_modules/.bin/tsc -p tsconfig.json --outDir "{prepareDir}/dist"',
+          cwd: undefined,
+          inputs: ["tsconfig.json", "package.json", "src"],
+        },
+      ],
+    });
+  });
+
+  it("normalizes script and steps builds", () => {
+    expect(
+      normalizeBuildConfig(
+        {
+          kind: "script",
+          script: "npm run build",
+          cwd: "frontend",
+          inputs: ["frontend/package.json"],
+        },
+        "runtime.build"
+      )
+    ).toEqual({
+      kind: "script",
+      script: "npm run build",
+      cwd: "frontend",
+      inputs: ["frontend/package.json"],
+    });
+
+    expect(
+      normalizeBuildConfig(
+        {
+          kind: "next",
+          cwd: "frontend",
+        },
+        "runtime.build"
+      )
+    ).toEqual({
+      kind: "next",
+      cwd: "frontend",
+      distDir: "dist",
+      tsconfig: "tsconfig.json",
+      inputs: [],
+    });
+
+    expect(
+      normalizeBuildConfig(
+        {
+          kind: "steps",
+          inputs: ["scripts/prepare.mjs"],
+          steps: [{ kind: "command", cmd: "node scripts/prepare.mjs" }],
+        },
+        "runtime.build"
+      )
+    ).toEqual({
+      kind: "steps",
+      inputs: ["scripts/prepare.mjs"],
+      steps: [
+        {
+          kind: "command",
+          cmd: "node scripts/prepare.mjs",
+          cwd: null,
+          inputs: [],
+        },
+      ],
+    });
+
+    expect(
+      buildConfigToPrepare({
+        kind: "next",
+        cwd: "frontend",
+        distDir: "dist",
+        tsconfig: "tsconfig.json",
+        inputs: [],
+      })
+    ).toEqual({
+      inputs: [
+        "frontend/tsconfig.json",
+        "frontend/package.json",
+        "frontend/src",
+        "frontend/app",
+        "frontend/public",
+        "frontend/next.config.js",
+        "frontend/next.config.mjs",
+        "frontend/next.config.ts",
+      ],
+      steps: [
+        {
+          kind: "module",
+          specifier: "@elench/testkit/setup/next-runtime-tsconfig#writeNextRuntimeTsconfig",
+          cwd: "frontend",
+          inputs: [
+            "frontend/tsconfig.json",
+            "frontend/package.json",
+            "frontend/src",
+            "frontend/app",
+            "frontend/public",
+            "frontend/next.config.js",
+            "frontend/next.config.mjs",
+            "frontend/next.config.ts",
+          ],
+        },
+        {
+          kind: "command",
+          cmd: "./node_modules/.bin/next build",
+          cwd: "frontend",
+          inputs: [
+            "frontend/tsconfig.json",
+            "frontend/package.json",
+            "frontend/src",
+            "frontend/app",
+            "frontend/public",
+            "frontend/next.config.js",
+            "frontend/next.config.mjs",
+            "frontend/next.config.ts",
+          ],
+        },
+      ],
+    });
+  });
+});

package/node_modules/@elench/next-analysis/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elench/next-analysis",
-  "version": "0.1.66",
+  "version": "0.1.68",
   "description": "SWC-backed Next.js source analysis primitives for Erench tools",
   "type": "module",
   "exports": {

package/node_modules/@elench/testkit-bridge/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elench/testkit-bridge",
-  "version": "0.1.66",
+  "version": "0.1.68",
   "description": "Browser bridge helpers for testkit",
   "type": "module",
   "main": "./dist/index.js",
@@ -22,7 +22,7 @@
     "typecheck": "tsc -p tsconfig.json --noEmit"
   },
   "dependencies": {
-    "@elench/testkit-protocol": "0.1.66"
+    "@elench/testkit-protocol": "0.1.68"
   },
   "private": false
 }

package/node_modules/@elench/testkit-protocol/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elench/testkit-protocol",
-  "version": "0.1.66",
+  "version": "0.1.68",
   "description": "Shared browser protocol for testkit bridge and extension consumers",
   "type": "module",
   "main": "./dist/index.js",

package/node_modules/@elench/ts-analysis/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elench/ts-analysis",
-  "version": "0.1.66",
+  "version": "0.1.68",
   "description": "TypeScript compiler-backed source analysis primitives for Erench tools",
   "type": "module",
   "exports": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elench/testkit",
-  "version": "0.1.66",
+  "version": "0.1.68",
   "description": "CLI for discovering and running local HTTP, DAL, and Playwright test suites",
   "type": "module",
   "workspaces": [
@@ -64,10 +64,10 @@
     "vitest": "^3.2.4"
   },
   "dependencies": {
-    "@elench/next-analysis": "0.1.66",
-    "@elench/ts-analysis": "0.1.66",
-    "@elench/testkit-bridge": "0.1.66",
-    "@elench/testkit-protocol": "0.1.66",
+    "@elench/next-analysis": "0.1.68",
+    "@elench/ts-analysis": "0.1.68",
+    "@elench/testkit-bridge": "0.1.68",
+    "@elench/testkit-protocol": "0.1.68",
     "@babel/code-frame": "^7.29.0",
     "@oclif/core": "^4.10.6",
     "esbuild": "^0.25.11",