@elench/testkit 0.1.66 → 0.1.67

package/lib/shared/build-config.mjs

@@ -0,0 +1,144 @@
+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 === "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, 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)),
+    };
+  }
+  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],
+        },
+      ],
+    };
+  }
+
+  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([build.tsconfig, "package.json"]);
+  const normalizedEntry = String(build.entry).split(path.sep).join("/");
+  const topLevelDir = normalizedEntry.includes("/") ? normalizedEntry.slice(0, normalizedEntry.indexOf("/")) : normalizedEntry;
+  if (topLevelDir) {
+    inputs.add(topLevelDir);
+  }
+  return [...inputs];
+}

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

@@ -0,0 +1,81 @@
+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: "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: [],
+        },
+      ],
+    });
+  });
+});

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

@@ -1,6 +1,6 @@
 {
   "name": "@elench/next-analysis",
-  "version": "0.1.66",
+  "version": "0.1.67",
   "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.67",
   "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.67"
   },
   "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.67",
   "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.67",
   "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.67",
   "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.67",
+    "@elench/ts-analysis": "0.1.67",
+    "@elench/testkit-bridge": "0.1.67",
+    "@elench/testkit-protocol": "0.1.67",
     "@babel/code-frame": "^7.29.0",
     "@oclif/core": "^4.10.6",
     "esbuild": "^0.25.11",