@mhosaic/feedback-cli 0.20.0 → 0.22.0

package/dist/chunk-IHJPCMYF.js

@@ -0,0 +1,126 @@
+#!/usr/bin/env node
+
+// src/qa/config.ts
+import { existsSync, readFileSync } from "fs";
+import { isAbsolute, join, resolve } from "path";
+var CONFIG_NAME = "qa-meter.config.json";
+function abs(dir, p) {
+  return isAbsolute(p) ? p : resolve(join(dir, p));
+}
+function reqString(raw, field) {
+  const v = raw[field];
+  if (v === void 0 || v === null) throw new Error(`${field} is required in ${CONFIG_NAME}`);
+  if (typeof v !== "string") throw new Error(`${field} must be a string in ${CONFIG_NAME}`);
+  return v;
+}
+function optString(raw, field, fallback) {
+  const v = raw[field];
+  if (v === void 0 || v === null) return fallback;
+  if (typeof v !== "string") throw new Error(`${field} must be a string in ${CONFIG_NAME}`);
+  return v;
+}
+function optPath(raw, field, dir) {
+  const v = raw[field];
+  if (v === void 0 || v === null) return null;
+  if (typeof v !== "string") throw new Error(`${field} must be a string in ${CONFIG_NAME}`);
+  return abs(dir, v);
+}
+function optAlias(raw, field, dir) {
+  const v = raw[field];
+  if (v === void 0 || v === null) return null;
+  if (typeof v !== "object" || Array.isArray(v)) {
+    throw new Error(`${field} must be an object map in ${CONFIG_NAME}`);
+  }
+  const out = {};
+  for (const [key, val] of Object.entries(v)) {
+    if (typeof val !== "string") {
+      throw new Error(`${field}.${key} must be a string in ${CONFIG_NAME}`);
+    }
+    out[key] = abs(dir, val);
+  }
+  return out;
+}
+function optRouterStyle(raw) {
+  const v = raw.routerStyle;
+  if (v === void 0 || v === null) return null;
+  if (v !== "jsx" && v !== "data") {
+    throw new Error(`sitemap.routerStyle must be "jsx" or "data" in ${CONFIG_NAME}`);
+  }
+  return v;
+}
+function loadQaConfig(cwd) {
+  const file = join(cwd, CONFIG_NAME);
+  if (!existsSync(file)) {
+    throw new Error(`Missing ${CONFIG_NAME} in ${cwd}. Create one \u2014 see the qa-meter design spec \xA77.1.`);
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(readFileSync(file, "utf8"));
+  } catch (err) {
+    throw new Error(`Failed to parse ${CONFIG_NAME}: ${err instanceof Error ? err.message : String(err)}`);
+  }
+  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+    throw new Error(`${CONFIG_NAME} must contain a JSON object`);
+  }
+  const raw = parsed;
+  for (const field of [
+    "e2eDir",
+    "suitesDir",
+    "outFile",
+    "testsGlob",
+    "fixturesFile",
+    "pageObjectsDir",
+    "annotationPrefix",
+    "environment",
+    "resultsFile",
+    "devValidationsFile"
+  ]) {
+    const v = raw[field];
+    if (v !== void 0 && v !== null && typeof v !== "string") {
+      throw new Error(`${field} must be a string in ${CONFIG_NAME}`);
+    }
+  }
+  let sitemap = null;
+  if (raw.sitemap !== void 0 && raw.sitemap !== null) {
+    if (typeof raw.sitemap !== "object" || Array.isArray(raw.sitemap)) {
+      throw new Error(`sitemap must be an object in ${CONFIG_NAME}`);
+    }
+    const s = raw.sitemap;
+    const routerDir = optPath(s, "routerDir", cwd);
+    const titlesFrom = optPath(s, "titlesFrom", cwd);
+    const alias = optAlias(s, "alias", cwd);
+    const entry = optPath(s, "entry", cwd);
+    const routerStyle = optRouterStyle(s);
+    sitemap = {
+      file: abs(cwd, reqString(s, "file")),
+      ...s.framework !== void 0 && s.framework !== null ? { framework: optString(s, "framework", "") } : {},
+      ...routerDir !== null ? { routerDir } : {},
+      ...titlesFrom !== null ? { titlesFrom } : {},
+      ...alias !== null ? { alias } : {},
+      ...entry !== null ? { entry } : {},
+      ...routerStyle !== null ? { routerStyle } : {}
+    };
+  }
+  return {
+    e2eDir: abs(cwd, reqString(raw, "e2eDir")),
+    suitesDir: abs(cwd, reqString(raw, "suitesDir")),
+    outFile: abs(cwd, reqString(raw, "outFile")),
+    // testsGlob, fixturesFile, pageObjectsDir are kept relative to e2eDir (not absolutized).
+    testsGlob: optString(raw, "testsGlob", "tests/**/*.spec.ts"),
+    fixturesFile: optString(raw, "fixturesFile", "helpers/fixtures.ts"),
+    pageObjectsDir: optString(raw, "pageObjectsDir", "pages"),
+    annotationPrefix: optString(raw, "annotationPrefix", "@mhosaic"),
+    environment: optString(raw, "environment", "staging"),
+    appVersion: raw.appVersion === void 0 || raw.appVersion === null ? null : typeof raw.appVersion === "string" ? raw.appVersion : (() => {
+      throw new Error(`appVersion must be a string or null in ${CONFIG_NAME}`);
+    })(),
+    resultsFile: optPath(raw, "resultsFile", cwd),
+    devValidationsFile: optPath(raw, "devValidationsFile", cwd),
+    sitemap
+  };
+}
+
+export {
+  loadQaConfig
+};
+//# sourceMappingURL=chunk-IHJPCMYF.js.map

package/dist/chunk-IHJPCMYF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/qa/config.ts"],"sourcesContent":["import { existsSync, readFileSync } from 'node:fs'\nimport { isAbsolute, join, resolve } from 'node:path'\n\n/**\n * Optional sitemap block of the qa-meter config. When absent the meter runs in\n * degraded flat mode (no route rollups). Path fields are absolutized against\n * the config file's directory; `framework` is an adapter name (no path).\n */\nexport interface QaSitemapConfig {\n  /** Where the sitemap.json lives (output of `qa sitemap`, or hand-provided). Absolute. */\n  file: string\n  /** Adapter name for `qa sitemap` (e.g. 'vue-router'); omitted if hand-provided. */\n  framework?: string\n  /** Directory holding the router declarations. Absolute. */\n  routerDir?: string\n  /** Optional locale JSON for human titles. Absolute. */\n  titlesFrom?: string\n  /**\n   * Optional import-alias map for the adapter (e.g. `{ '@': 'src' }`). KEYS are\n   * kept verbatim; VALUES are absolutized against the config dir (like other\n   * path fields) so `@/router/x` resolves to a real file. Default: none.\n   */\n  alias?: Record<string, string>\n  /**\n   * react-router adapter only: the file holding the route tree (e.g.\n   * `frontend/src/App.tsx` or `frontend/src/router.tsx`). Absolute.\n   */\n  entry?: string\n  /** react-router adapter only: force a reader instead of auto-detecting. */\n  routerStyle?: 'jsx' | 'data'\n}\n\n/**\n * Resolved qa-meter config. All filesystem paths are ABSOLUTE (resolved against\n * the directory containing qa-meter.config.json) except `testsGlob` and\n * `fixturesFile`/`pageObjectsDir`, which stay relative to `e2eDir` — they are\n * consumed downstream by joining onto `e2eDir`, so they are kept as-given.\n */\nexport interface QaConfig {\n  /** Playwright e2e root. Absolute. */\n  e2eDir: string\n  /** Suites root ('authored' + 'generated/'). Absolute. */\n  suitesDir: string\n  /** Where the assembled artifact is written. Absolute. */\n  outFile: string\n  /** Glob for spec files, relative to e2eDir (kept as a glob string). */\n  testsGlob: string\n  /** Fixtures file, relative to e2eDir (kept as-given). */\n  fixturesFile: string\n  /** Page-objects dir, relative to e2eDir (kept as-given). */\n  pageObjectsDir: string\n  /** Annotation prefix honored in spec headers. */\n  annotationPrefix: string\n  /** Environment stamped into the artifact. */\n  environment: string\n  /** App version string, or null (resolved from --version flag downstream). */\n  appVersion: string | null\n  /** Optional Playwright results file. Absolute, or null. */\n  resultsFile: string | null\n  /** Optional dev-validations file. Absolute, or null. */\n  devValidationsFile: string | null\n  /** Optional sitemap block, or null when absent. */\n  sitemap: QaSitemapConfig | null\n}\n\nconst CONFIG_NAME = 'qa-meter.config.json'\n\n/** Absolutize `p` against `dir` (already-absolute paths pass through). */\nfunction abs(dir: string, p: string): string {\n  return isAbsolute(p) ? p : resolve(join(dir, p))\n}\n\n/** Read a required string field; throw a field-named error if missing/wrong-type. */\nfunction reqString(raw: Record<string, unknown>, field: string): string {\n  const v = raw[field]\n  if (v === undefined || v === null) throw new Error(`${field} is required in ${CONFIG_NAME}`)\n  if (typeof v !== 'string') throw new Error(`${field} must be a string in ${CONFIG_NAME}`)\n  return v\n}\n\n/** Read an optional string field with a default; throw a field-named error on wrong type. */\nfunction optString(raw: Record<string, unknown>, field: string, fallback: string): string {\n  const v = raw[field]\n  if (v === undefined || v === null) return fallback\n  if (typeof v !== 'string') throw new Error(`${field} must be a string in ${CONFIG_NAME}`)\n  return v\n}\n\n/** Read an optional path field; absolutize if present, else null. Throws on wrong type. */\nfunction optPath(raw: Record<string, unknown>, field: string, dir: string): string | null {\n  const v = raw[field]\n  if (v === undefined || v === null) return null\n  if (typeof v !== 'string') throw new Error(`${field} must be a string in ${CONFIG_NAME}`)\n  return abs(dir, v)\n}\n\n/**\n * Read an optional alias map field. KEYS pass through verbatim; VALUES are\n * absolutized against `dir` (like other path fields) so `@` → `<dir>/src`\n * becomes an absolute base for the adapter. Returns null if absent. Throws a\n * field-named error on wrong shape.\n */\nfunction optAlias(\n  raw: Record<string, unknown>,\n  field: string,\n  dir: string,\n): Record<string, string> | null {\n  const v = raw[field]\n  if (v === undefined || v === null) return null\n  if (typeof v !== 'object' || Array.isArray(v)) {\n    throw new Error(`${field} must be an object map in ${CONFIG_NAME}`)\n  }\n  const out: Record<string, string> = {}\n  for (const [key, val] of Object.entries(v as Record<string, unknown>)) {\n    if (typeof val !== 'string') {\n      throw new Error(`${field}.${key} must be a string in ${CONFIG_NAME}`)\n    }\n    out[key] = abs(dir, val)\n  }\n  return out\n}\n\n/** Read an optional `routerStyle` ('jsx' | 'data'); null if absent. Throws on bad value. */\nfunction optRouterStyle(raw: Record<string, unknown>): 'jsx' | 'data' | null {\n  const v = raw.routerStyle\n  if (v === undefined || v === null) return null\n  if (v !== 'jsx' && v !== 'data') {\n    throw new Error(`sitemap.routerStyle must be \"jsx\" or \"data\" in ${CONFIG_NAME}`)\n  }\n  return v\n}\n\n/**\n * Load and validate `qa-meter.config.json` from `cwd`. All paths are resolved\n * against `cwd` (the directory containing the config file). Validation is\n * hand-rolled (no schema lib) to match the CLI's zero-dependency posture.\n */\nexport function loadQaConfig(cwd: string): QaConfig {\n  const file = join(cwd, CONFIG_NAME)\n  if (!existsSync(file)) {\n    throw new Error(`Missing ${CONFIG_NAME} in ${cwd}. Create one — see the qa-meter design spec §7.1.`)\n  }\n\n  let parsed: unknown\n  try {\n    parsed = JSON.parse(readFileSync(file, 'utf8'))\n  } catch (err) {\n    throw new Error(`Failed to parse ${CONFIG_NAME}: ${err instanceof Error ? err.message : String(err)}`)\n  }\n  if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {\n    throw new Error(`${CONFIG_NAME} must contain a JSON object`)\n  }\n  const raw = parsed as Record<string, unknown>\n\n  // Type-check every present-but-wrong-type string field up front, so a bad\n  // field surfaces a field-named error regardless of whether some *other*\n  // required field happens to be missing.\n  for (const field of [\n    'e2eDir',\n    'suitesDir',\n    'outFile',\n    'testsGlob',\n    'fixturesFile',\n    'pageObjectsDir',\n    'annotationPrefix',\n    'environment',\n    'resultsFile',\n    'devValidationsFile',\n  ]) {\n    const v = raw[field]\n    if (v !== undefined && v !== null && typeof v !== 'string') {\n      throw new Error(`${field} must be a string in ${CONFIG_NAME}`)\n    }\n  }\n\n  let sitemap: QaSitemapConfig | null = null\n  if (raw.sitemap !== undefined && raw.sitemap !== null) {\n    if (typeof raw.sitemap !== 'object' || Array.isArray(raw.sitemap)) {\n      throw new Error(`sitemap must be an object in ${CONFIG_NAME}`)\n    }\n    const s = raw.sitemap as Record<string, unknown>\n    const routerDir = optPath(s, 'routerDir', cwd)\n    const titlesFrom = optPath(s, 'titlesFrom', cwd)\n    const alias = optAlias(s, 'alias', cwd)\n    const entry = optPath(s, 'entry', cwd)\n    const routerStyle = optRouterStyle(s)\n    sitemap = {\n      file: abs(cwd, reqString(s, 'file')),\n      ...(s.framework !== undefined && s.framework !== null\n        ? { framework: optString(s, 'framework', '') }\n        : {}),\n      ...(routerDir !== null ? { routerDir } : {}),\n      ...(titlesFrom !== null ? { titlesFrom } : {}),\n      ...(alias !== null ? { alias } : {}),\n      ...(entry !== null ? { entry } : {}),\n      ...(routerStyle !== null ? { routerStyle } : {}),\n    }\n  }\n\n  return {\n    e2eDir: abs(cwd, reqString(raw, 'e2eDir')),\n    suitesDir: abs(cwd, reqString(raw, 'suitesDir')),\n    outFile: abs(cwd, reqString(raw, 'outFile')),\n    // testsGlob, fixturesFile, pageObjectsDir are kept relative to e2eDir (not absolutized).\n    testsGlob: optString(raw, 'testsGlob', 'tests/**/*.spec.ts'),\n    fixturesFile: optString(raw, 'fixturesFile', 'helpers/fixtures.ts'),\n    pageObjectsDir: optString(raw, 'pageObjectsDir', 'pages'),\n    annotationPrefix: optString(raw, 'annotationPrefix', '@mhosaic'),\n    environment: optString(raw, 'environment', 'staging'),\n    appVersion:\n      raw.appVersion === undefined || raw.appVersion === null\n        ? null\n        : typeof raw.appVersion === 'string'\n          ? raw.appVersion\n          : (() => {\n              throw new Error(`appVersion must be a string or null in ${CONFIG_NAME}`)\n            })(),\n    resultsFile: optPath(raw, 'resultsFile', cwd),\n    devValidationsFile: optPath(raw, 'devValidationsFile', cwd),\n    sitemap,\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-SSLQOK2Z.js

@@ -0,0 +1,456 @@
+#!/usr/bin/env node
+import {
+  normalizePattern
+} from "./chunk-AZQSQJNQ.js";
+import {
+  loadQaConfig
+} from "./chunk-IHJPCMYF.js";
+
+// src/qa/generate.ts
+import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "fs";
+import { dirname, join, relative, resolve } from "path";
+import { fileURLToPath } from "url";
+import ts from "typescript";
+import { stringify } from "yaml";
+var HEADER_COMMENT = "# GENERATED by qa-meter \u2014 do not hand-edit. Regenerate with: mhosaic-feedback qa generate";
+function cliVersion() {
+  const here = dirname(fileURLToPath(import.meta.url));
+  for (let dir = here, i = 0; i < 5; i++, dir = dirname(dir)) {
+    const candidate = join(dir, "package.json");
+    if (existsSync(candidate)) {
+      try {
+        const pkg = JSON.parse(readFileSync(candidate, "utf8"));
+        if (pkg.name === "@mhosaic/feedback-cli" && typeof pkg.version === "string") return pkg.version;
+      } catch {
+      }
+    }
+  }
+  return "0.0.0";
+}
+function slug(input) {
+  return input.normalize("NFD").replace(/[̀-ͯ]/g, "").toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+}
+function patternKey(pattern) {
+  const key = pattern.replace(/[:*]/g, "").split("/").filter(Boolean).map((seg) => slug(seg)).filter(Boolean).join("-");
+  return key.length > 0 ? key : "root";
+}
+function parseFile(file) {
+  const text = readFileSync(file, "utf8");
+  return ts.createSourceFile(
+    file,
+    text,
+    ts.ScriptTarget.Latest,
+    /*setParentNodes*/
+    true,
+    ts.ScriptKind.TS
+  );
+}
+function resolveImport(fromFile, spec) {
+  if (!spec.startsWith(".")) return null;
+  const base = resolve(dirname(fromFile), spec);
+  for (const candidate of [`${base}.ts`, join(base, "index.ts")]) {
+    if (existsSync(candidate)) return candidate;
+  }
+  return null;
+}
+function importMap(sf) {
+  const map = /* @__PURE__ */ new Map();
+  for (const stmt of sf.statements) {
+    if (!ts.isImportDeclaration(stmt) || !ts.isStringLiteral(stmt.moduleSpecifier)) continue;
+    const target = resolveImport(sf.fileName, stmt.moduleSpecifier.text);
+    if (!target) continue;
+    const bindings = stmt.importClause?.namedBindings;
+    if (bindings && ts.isNamedImports(bindings)) {
+      for (const el of bindings.elements) map.set(el.name.text, target);
+    }
+    if (stmt.importClause?.name) map.set(stmt.importClause.name.text, target);
+  }
+  return map;
+}
+function fixtureClasses(sf) {
+  const out = /* @__PURE__ */ new Map();
+  const isExtendCall = (node) => ts.isCallExpression(node) && ts.isPropertyAccessExpression(node.expression) && node.expression.name.text === "extend";
+  let objLit;
+  const findExtend = (node) => {
+    if (objLit) return;
+    if (isExtendCall(node)) {
+      const arg = node.arguments[0];
+      if (arg && ts.isObjectLiteralExpression(arg)) objLit = arg;
+    }
+    ts.forEachChild(node, findExtend);
+  };
+  findExtend(sf);
+  if (!objLit) return out;
+  for (const prop of objLit.properties) {
+    let name;
+    let body;
+    if (ts.isMethodDeclaration(prop) && (ts.isIdentifier(prop.name) || ts.isStringLiteral(prop.name))) {
+      name = prop.name.text;
+      body = prop.body;
+    } else if (ts.isPropertyAssignment(prop) && (ts.isIdentifier(prop.name) || ts.isStringLiteral(prop.name)) && (ts.isArrowFunction(prop.initializer) || ts.isFunctionExpression(prop.initializer))) {
+      name = prop.name.text;
+      body = prop.initializer.body;
+    }
+    if (!name || !body) continue;
+    let className;
+    const findUse = (node) => {
+      if (className) return;
+      if (ts.isCallExpression(node) && ts.isIdentifier(node.expression) && node.expression.text === "use" && node.arguments[0] && ts.isNewExpression(node.arguments[0]) && ts.isIdentifier(node.arguments[0].expression)) {
+        className = node.arguments[0].expression.text;
+      }
+      ts.forEachChild(node, findUse);
+    };
+    findUse(body);
+    if (className) out.set(name, className);
+  }
+  return out;
+}
+function gotoPattern(sf, className) {
+  let cls;
+  for (const stmt of sf.statements) {
+    if (ts.isClassDeclaration(stmt) && stmt.name?.text === className) cls = stmt;
+  }
+  if (!cls) return null;
+  let method;
+  for (const member of cls.members) {
+    if (ts.isMethodDeclaration(member) && ts.isIdentifier(member.name) && member.name.text === "goto") {
+      method = member;
+    }
+  }
+  if (!method?.body) return null;
+  const params = method.parameters.map((p) => ts.isIdentifier(p.name) ? p.name.text : void 0).filter((n) => !!n);
+  let arg;
+  const findGoto = (node) => {
+    if (arg) return;
+    if (ts.isCallExpression(node) && ts.isPropertyAccessExpression(node.expression) && node.expression.name.text === "goto" && node.arguments.length > 0) {
+      arg = node.arguments[0];
+    }
+    ts.forEachChild(node, findGoto);
+  };
+  findGoto(method.body);
+  if (!arg) return null;
+  if (ts.isStringLiteralLike(arg)) return normalizePattern(arg.text);
+  if (ts.isTemplateExpression(arg)) {
+    let raw = arg.head.text;
+    arg.templateSpans.forEach((span, i) => {
+      let name;
+      if (ts.isIdentifier(span.expression)) {
+        name = span.expression.text;
+      } else {
+        name = params[i] ?? "param";
+      }
+      raw += `:${name}${span.literal.text}`;
+    });
+    return normalizePattern(raw);
+  }
+  return null;
+}
+function parseHeader(text, prefix) {
+  const out = {};
+  const lines = text.split(/\r?\n/);
+  const comments = [];
+  for (const line of lines) {
+    const trimmed = line.trim();
+    if (trimmed === "") continue;
+    if (trimmed.startsWith("//")) {
+      comments.push(trimmed.replace(/^\/\/\s?/, ""));
+      continue;
+    }
+    if (trimmed.startsWith("/*") || trimmed.startsWith("*")) {
+      comments.push(trimmed.replace(/^\/\*+\s?/, "").replace(/^\*+\s?/, "").replace(/\*+\/\s*$/, ""));
+      continue;
+    }
+    break;
+  }
+  const escaped = prefix.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const read = (pfx) => {
+    for (const c of comments) {
+      const pagesMatch = c.match(new RegExp(`${pfx}:pages\\s+(.+)$`));
+      if (pagesMatch?.[1] && out.pages === void 0) {
+        out.pages = pagesMatch[1].split(",").map((p) => p.trim()).filter(Boolean);
+      }
+      const scenarioMatch = c.match(new RegExp(`${pfx}:scenario\\s+(\\S+)`));
+      if (scenarioMatch?.[1] && out.scenario === void 0) out.scenario = scenarioMatch[1];
+    }
+  };
+  read(escaped);
+  read("@testgen");
+  return out;
+}
+function destructuredKeys(fn) {
+  const param = fn.parameters[0];
+  if (!param || !ts.isObjectBindingPattern(param.name)) return [];
+  const keys = [];
+  for (const el of param.name.elements) {
+    const keyNode = el.propertyName ?? el.name;
+    if (ts.isIdentifier(keyNode)) keys.push(keyNode.text);
+    else if (ts.isStringLiteral(keyNode)) keys.push(keyNode.text);
+  }
+  return keys;
+}
+function literalGotos(body) {
+  const out = [];
+  const visit = (node) => {
+    if (ts.isCallExpression(node) && ts.isPropertyAccessExpression(node.expression) && node.expression.name.text === "goto" && node.arguments[0] && ts.isStringLiteralLike(node.arguments[0])) {
+      out.push(normalizePattern(node.arguments[0].text));
+    }
+    ts.forEachChild(node, visit);
+  };
+  visit(body);
+  return out;
+}
+function isTestCall(node) {
+  const callee = node.expression;
+  if (ts.isIdentifier(callee)) return callee.text === "test";
+  if (ts.isPropertyAccessExpression(callee) && ts.isIdentifier(callee.expression) && callee.expression.text === "test") {
+    return callee.name.text === "only" || callee.name.text === "skip" || callee.name.text === "fixme";
+  }
+  return false;
+}
+function specCases(sf) {
+  const cases = [];
+  const dynamicTitles = [];
+  const visit = (node) => {
+    if (ts.isCallExpression(node) && isTestCall(node)) {
+      const titleArg = node.arguments[0];
+      const fnArg = node.arguments[1];
+      if (titleArg && ts.isStringLiteralLike(titleArg)) {
+        if (fnArg && (ts.isArrowFunction(fnArg) || ts.isFunctionExpression(fnArg))) {
+          const fixtures = destructuredKeys(fnArg);
+          const gotos = fnArg.body ? literalGotos(fnArg.body) : [];
+          cases.push({ title: titleArg.text, fixtures, gotos });
+        } else {
+          cases.push({ title: titleArg.text, fixtures: [], gotos: [] });
+        }
+      } else if (titleArg) {
+        dynamicTitles.push(approxTitle(titleArg));
+      }
+    }
+    ts.forEachChild(node, visit);
+  };
+  visit(sf);
+  dynamicTitles.sort((a, b) => a.localeCompare(b));
+  return { cases, dynamicTitles };
+}
+function approxTitle(node) {
+  const text = node.getText().replace(/\s+/g, " ").trim();
+  const kind = ts.isTemplateExpression(node) ? "template literal" : ts.isIdentifier(node) ? "identifier" : "non-static";
+  return `${text.slice(0, 80)} (${kind} title)`;
+}
+function specFiles(e2eDir, testsGlob) {
+  const starIdx = testsGlob.indexOf("**");
+  const baseRel = starIdx >= 0 ? testsGlob.slice(0, starIdx).replace(/\/+$/, "") : dirname(testsGlob);
+  const suffixMatch = testsGlob.match(/\*([^*/]+)$/);
+  const suffix = suffixMatch?.[1] ?? ".spec.ts";
+  const baseAbs = join(e2eDir, baseRel);
+  const out = [];
+  const walk = (dir) => {
+    let entries;
+    try {
+      entries = readdirSync(dir, { withFileTypes: true, encoding: "utf8" });
+    } catch {
+      return;
+    }
+    for (const entry of entries.sort((a, b) => a.name.localeCompare(b.name))) {
+      const full = join(dir, entry.name);
+      if (entry.isDirectory()) walk(full);
+      else if (entry.name.endsWith(suffix)) out.push(full);
+    }
+  };
+  walk(baseAbs);
+  return out.sort((a, b) => a.localeCompare(b));
+}
+function generateSuites(cfg) {
+  const version = cliVersion();
+  const e2eDir = cfg.e2eDir;
+  const testsBase = (() => {
+    const starIdx = cfg.testsGlob.indexOf("**");
+    return starIdx >= 0 ? cfg.testsGlob.slice(0, starIdx).replace(/\/+$/, "") : dirname(cfg.testsGlob);
+  })();
+  const fixtureToFile = /* @__PURE__ */ new Map();
+  const fixturesAbs = join(e2eDir, cfg.fixturesFile);
+  if (existsSync(fixturesAbs)) {
+    const sf = parseFile(fixturesAbs);
+    const imports = importMap(sf);
+    for (const [fixtureName, className] of fixtureClasses(sf)) {
+      const target = imports.get(className);
+      if (target) fixtureToFile.set(fixtureName, target);
+    }
+  }
+  const fixtureClassMap = existsSync(fixturesAbs) ? fixtureClasses(parseFile(fixturesAbs)) : /* @__PURE__ */ new Map();
+  const patternByFile = /* @__PURE__ */ new Map();
+  const fixtureToPattern = /* @__PURE__ */ new Map();
+  for (const [fixtureName, file] of fixtureToFile) {
+    const className = fixtureClassMap.get(fixtureName);
+    if (!className || !existsSync(file)) continue;
+    let sf = patternByFile.get(file);
+    if (!sf) {
+      sf = parseFile(file);
+      patternByFile.set(file, sf);
+    }
+    const pattern = gotoPattern(sf, className);
+    if (pattern) fixtureToPattern.set(fixtureName, pattern);
+  }
+  const unmappable = [];
+  const dynamicTitles = [];
+  const zeroCaseSpecs = [];
+  const sections = /* @__PURE__ */ new Map();
+  const files = specFiles(e2eDir, cfg.testsGlob);
+  for (const file of files) {
+    const specRel = relative(e2eDir, file).split("\\").join("/");
+    const specBasename = basenameNoSpec(specRel);
+    const section = sectionFor(specRel, testsBase);
+    const text = readFileSync(file, "utf8");
+    const header = parseHeader(text, cfg.annotationPrefix);
+    const sf = parseFile(file);
+    const scan = specCases(sf);
+    const cases = scan.cases;
+    for (const approx of scan.dynamicTitles) dynamicTitles.push(`${specRel} :: ${approx}`);
+    if (cases.length === 0) zeroCaseSpecs.push(specRel);
+    if (!sections.has(section)) sections.set(section, { cases: [], pages: /* @__PURE__ */ new Map() });
+    const sec = sections.get(section);
+    cases.forEach((spec, index) => {
+      let primary;
+      let traversed = [];
+      let pagesSource = "inferred";
+      if (header.pages && header.pages.length > 0) {
+        const normalized = header.pages.map((p) => normalizePattern(p));
+        primary = normalized[0];
+        traversed = normalized.slice(1);
+        pagesSource = "annotation";
+      } else {
+        const inferred = [];
+        for (const fx of spec.fixtures) {
+          const pat = fixtureToPattern.get(fx);
+          if (pat) inferred.push(pat);
+        }
+        for (const g of spec.gotos) inferred.push(g);
+        if (inferred.length > 0) {
+          primary = inferred[0];
+          traversed = inferred.slice(1);
+        }
+      }
+      const externalKey = header.scenario ?? `${specRel}::${slug(spec.title)}`;
+      let appliesTo = [];
+      if (primary) {
+        const key = registerPage(sec.pages, primary, specRel, spec.title);
+        appliesTo = [key];
+      } else {
+        unmappable.push(`${specRel} :: ${spec.title}`);
+      }
+      const testCase = {
+        id: `${specBasename}-${index}`,
+        title: spec.title,
+        suite: specBasename,
+        status: "covered",
+        automation: { type: "playwright", spec: specRel, test_title: spec.title },
+        applies_to: appliesTo,
+        ...traversed.length > 0 ? { traverses: traversed.map((pattern) => ({ pattern })) } : {},
+        external_key: externalKey,
+        pages_source: pagesSource
+      };
+      sec.cases.push(testCase);
+    });
+  }
+  const suites = /* @__PURE__ */ new Map();
+  for (const section of [...sections.keys()].sort((a, b) => a.localeCompare(b))) {
+    const sec = sections.get(section);
+    if (sec.cases.length === 0) continue;
+    const pages = {};
+    for (const key of [...sec.pages.keys()].sort((a, b) => a.localeCompare(b))) {
+      pages[key] = sec.pages.get(key);
+    }
+    const test_cases = [...sec.cases].sort((a, b) => {
+      const specA = a.automation?.spec ?? "";
+      const specB = b.automation?.spec ?? "";
+      if (specA !== specB) return specA.localeCompare(specB);
+      return a.id.localeCompare(b.id);
+    });
+    suites.set(section, {
+      meta: {
+        section,
+        format: 1,
+        origin: "generated",
+        generated_by: `qa-meter@${version}`
+      },
+      pages,
+      test_cases
+    });
+  }
+  return {
+    suites,
+    unmappable,
+    dynamicTitles: dynamicTitles.sort((a, b) => a.localeCompare(b)),
+    zeroCaseSpecs: zeroCaseSpecs.sort((a, b) => a.localeCompare(b))
+  };
+}
+function registerPage(registry, pattern, spec, testTitle) {
+  const key = patternKey(pattern);
+  if (!registry.has(key)) {
+    registry.set(key, { pattern, spec, test_title: testTitle });
+  }
+  return key;
+}
+function basenameNoSpec(specRel) {
+  const base = specRel.split("/").pop() ?? specRel;
+  return base.replace(/\.spec\.ts$/, "").replace(/\.ts$/, "");
+}
+function sectionFor(specRel, testsBase) {
+  let rel = specRel;
+  const prefix = `${testsBase}/`;
+  if (rel.startsWith(prefix)) rel = rel.slice(prefix.length);
+  const parts = rel.split("/");
+  if (parts.length > 1 && parts[0]) return parts[0];
+  return testsBase.split("/").filter(Boolean).pop() ?? "tests";
+}
+function serializeSuite(doc) {
+  const yaml = stringify(doc, { lineWidth: 0 });
+  return `${HEADER_COMMENT}
+${yaml}`;
+}
+async function runGenerate(_args) {
+  const cfg = loadQaConfig(process.cwd());
+  const { suites, unmappable, dynamicTitles, zeroCaseSpecs } = generateSuites(cfg);
+  const outDir = join(cfg.suitesDir, "generated");
+  mkdirSync(outDir, { recursive: true });
+  const sections = [...suites.keys()].sort((a, b) => a.localeCompare(b));
+  for (const section of sections) {
+    const doc = suites.get(section);
+    const file = join(outDir, `${section}-test-suite.yaml`);
+    writeFileSync(file, serializeSuite(doc), "utf8");
+  }
+  const totalCases = sections.reduce((n, s) => n + suites.get(s).test_cases.length, 0);
+  process.stderr.write(
+    `qa generate: ${sections.length} suite(s), ${totalCases} case(s) \u2192 ${relative(process.cwd(), outDir) || outDir}
+`
+  );
+  if (unmappable.length > 0) {
+    process.stderr.write(`qa generate: ${unmappable.length} unmappable test(s):
+`);
+    for (const entry of unmappable) process.stderr.write(`  warning: unmappable \u2014 ${entry}
+`);
+  }
+  if (zeroCaseSpecs.length > 0) {
+    process.stderr.write(
+      `qa generate: ${zeroCaseSpecs.length} spec(s) produced no extractable cases (factory/loop/dynamic-title) \u2014 add @mhosaic:pages/@mhosaic:scenario or a string title:
+`
+    );
+    for (const spec of zeroCaseSpecs) process.stderr.write(`  warning: zero-case spec \u2014 ${spec}
+`);
+  }
+  if (dynamicTitles.length > 0) {
+    process.stderr.write(
+      `qa generate: ${dynamicTitles.length} test(s) skipped for a non-static title (give them a string literal title or a @mhosaic:scenario id):
+`
+    );
+    for (const entry of dynamicTitles) process.stderr.write(`  warning: dynamic-title \u2014 ${entry}
+`);
+  }
+}
+
+export {
+  generateSuites,
+  serializeSuite,
+  runGenerate
+};
+//# sourceMappingURL=chunk-SSLQOK2Z.js.map