uidex 0.2.4 → 0.3.0

package/dist/playwright/index.cjs

@@ -1,7 +1,9 @@
 "use strict";
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -15,58 +17,196 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/playwright/index.ts
 var playwright_exports = {};
 __export(playwright_exports, {
   COVERAGE_ATTACHMENT: () => COVERAGE_ATTACHMENT,
-  UIDEX_ATTR: () => UIDEX_ATTR,
-  createUidexLocators: () => createUidexLocators,
+  FLOW_TAG: () => FLOW_TAG,
+  NOT_FLOW_TAG: () => NOT_FLOW_TAG,
+  UIDEX_ATTRS: () => UIDEX_ATTRS,
+  UidexCoverageReporter: () => UidexCoverageReporter,
+  createUidexFixture: () => createUidexFixture,
   expect: () => import_test.expect,
+  resolveFlow: () => resolveFlow,
   test: () => test,
-  uidex: () => uidex,
   uidexSelector: () => uidexSelector
 });
 module.exports = __toCommonJS(playwright_exports);
 
+// src/playwright/selector.ts
+var ATTRS = [
+  "data-uidex",
+  "data-uidex-region",
+  "data-uidex-widget",
+  "data-uidex-primitive"
+];
+var UIDEX_ATTRS = ATTRS;
+function uidexSelector(id) {
+  const escaped = id.replace(/"/g, '\\"');
+  return ATTRS.map((a) => `[${a}="${escaped}"]`).join(", ");
+}
+function kebab(input) {
+  return input.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+}
+var FLOW_TAG = "@uidex:flow";
+var NOT_FLOW_TAG = "@uidex:not-flow";
+var COVERAGE_ATTACHMENT = "uidex-coverage";
+
 // src/playwright/fixture.ts
 var import_test = require("@playwright/test");
+function resolveFlow(testInfo) {
+  const tags = testInfo.tags ?? [];
+  const notFlow = tags.includes(NOT_FLOW_TAG);
+  if (notFlow) return { flow: null, notFlow: true };
+  if (!tags.includes(FLOW_TAG)) return { flow: null, notFlow: false };
+  const describes = describeTitles(testInfo.titlePath ?? [], testInfo.title);
+  const source = describes.length > 0 ? describes[describes.length - 1] : testInfo.title ?? "";
+  return { flow: kebab(source) || null, notFlow: false };
+}
+var FILE_RE = /\.(spec|test)\.(t|j)sx?$|\.(t|j)sx?$|[\\/]/;
+function describeTitles(titlePath, testTitle) {
+  const end = titlePath.length > 0 && titlePath[titlePath.length - 1] === testTitle ? titlePath.length - 1 : titlePath.length;
+  const out = [];
+  for (let i = 0; i < end; i++) {
+    const entry = titlePath[i];
+    if (!entry) continue;
+    if (FILE_RE.test(entry)) continue;
+    if (i === 0) continue;
+    out.push(entry);
+  }
+  return out;
+}
+function createUidexFixture(page, testInfo) {
+  const used = /* @__PURE__ */ new Set();
+  const locator = (id) => {
+    used.add(id);
+    return page.locator(uidexSelector(id));
+  };
+  const buildPayload = () => {
+    const { flow, notFlow } = resolveFlow(testInfo);
+    return {
+      flow,
+      notFlow,
+      ids: [...used].sort(),
+      title: testInfo.title
+    };
+  };
+  return { locator, buildPayload };
+}
 var test = import_test.test.extend({
   uidex: async ({ page }, use, testInfo) => {
-    const used = /* @__PURE__ */ new Set();
-    const locator = (id) => {
-      used.add(id);
-      return page.locator(uidexSelector(id));
-    };
-    await use(locator);
+    const handle = createUidexFixture(page, testInfo);
+    await use(handle.locator);
     await testInfo.attach(COVERAGE_ATTACHMENT, {
-      body: JSON.stringify([...used]),
+      body: JSON.stringify(handle.buildPayload()),
       contentType: "application/json"
     });
   }
 });
 
-// src/playwright/index.ts
-var UIDEX_ATTR = "data-uidex";
-function uidexSelector(id) {
-  return `[${UIDEX_ATTR}="${id}"]`;
-}
-var COVERAGE_ATTACHMENT = "uidex-coverage";
-function uidex(page, id) {
-  return page.locator(uidexSelector(id));
-}
-function createUidexLocators(page) {
-  return (id) => page.locator(uidexSelector(id));
+// src/playwright/reporter.ts
+var fs = __toESM(require("fs"), 1);
+var path = __toESM(require("path"), 1);
+var UidexCoverageReporter = class {
+  outputPath;
+  entityIds;
+  silent;
+  flows = /* @__PURE__ */ new Map();
+  untagged = [];
+  touched = /* @__PURE__ */ new Set();
+  constructor(options = {}) {
+    this.outputPath = options.outputPath ?? "uidex-coverage.json";
+    this.entityIds = options.entityIds ?? [];
+    this.silent = options.silent ?? false;
+  }
+  onTestEnd(_test, result) {
+    for (const attachment of result.attachments) {
+      if (attachment.name !== COVERAGE_ATTACHMENT) continue;
+      if (!attachment.body) continue;
+      const payload = parsePayload(attachment.body.toString());
+      if (!payload) continue;
+      if (payload.notFlow) continue;
+      for (const id of payload.ids) this.touched.add(id);
+      if (payload.flow) {
+        const entry = this.flows.get(payload.flow) ?? {
+          ids: /* @__PURE__ */ new Set(),
+          titles: /* @__PURE__ */ new Set()
+        };
+        for (const id of payload.ids) entry.ids.add(id);
+        entry.titles.add(payload.title);
+        this.flows.set(payload.flow, entry);
+      } else {
+        this.untagged.push({ title: payload.title, ids: payload.ids });
+      }
+    }
+  }
+  async onEnd(_result) {
+    const flows = [...this.flows.entries()].map(([flow, entry]) => ({
+      flow,
+      ids: [...entry.ids].sort(),
+      titles: [...entry.titles].sort()
+    })).sort((a, b) => a.flow.localeCompare(b.flow));
+    const all = [...this.entityIds];
+    const touched = all.filter((id) => this.touched.has(id)).sort();
+    const untouched = all.filter((id) => !this.touched.has(id)).sort();
+    const total = all.length;
+    const percentage = total > 0 ? Math.round(touched.length / total * 100) : 0;
+    const report = {
+      flows,
+      untagged: this.untagged,
+      touched,
+      untouched,
+      total,
+      percentage
+    };
+    fs.mkdirSync(path.dirname(path.resolve(this.outputPath)), {
+      recursive: true
+    });
+    fs.writeFileSync(
+      path.resolve(this.outputPath),
+      JSON.stringify(report, null, 2) + "\n"
+    );
+    if (!this.silent) {
+      const line = total > 0 ? `uidex coverage: ${touched.length}/${total} entities (${percentage}%) across ${flows.length} flow(s)` : `uidex coverage: ${flows.length} flow(s), ${this.touched.size} entity id(s) touched`;
+      console.log(line);
+    }
+  }
+};
+function parsePayload(raw) {
+  try {
+    const parsed = JSON.parse(raw);
+    if (!parsed || !Array.isArray(parsed.ids)) return null;
+    return {
+      flow: typeof parsed.flow === "string" ? parsed.flow : null,
+      notFlow: Boolean(parsed.notFlow),
+      ids: parsed.ids.filter((x) => typeof x === "string"),
+      title: typeof parsed.title === "string" ? parsed.title : ""
+    };
+  } catch {
+    return null;
+  }
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   COVERAGE_ATTACHMENT,
-  UIDEX_ATTR,
-  createUidexLocators,
+  FLOW_TAG,
+  NOT_FLOW_TAG,
+  UIDEX_ATTRS,
+  UidexCoverageReporter,
+  createUidexFixture,
   expect,
+  resolveFlow,
   test,
-  uidex,
   uidexSelector
 });
 //# sourceMappingURL=index.cjs.map

package/dist/playwright/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/playwright/index.ts","../../src/playwright/fixture.ts"],"sourcesContent":["import type { Page, Locator } from '@playwright/test';\n\n/** The data attribute used for uidex component selectors. */\nexport const UIDEX_ATTR = 'data-uidex';\n\n/** Build a CSS selector for a uidex-annotated element. */\nexport function uidexSelector(id: string): string {\n  return `[${UIDEX_ATTR}=\"${id}\"]`;\n}\n\n/** Attachment name used to pass coverage data from fixture to reporter. */\nexport const COVERAGE_ATTACHMENT = 'uidex-coverage';\n\n// Fixture — provides `uidex` as a Playwright test fixture with coverage tracking\nexport { test, expect } from './fixture';\nexport type { UidexLocator, UidexFixtures } from './fixture';\n\n/**\n * Create a Playwright locator for a uidex-annotated element.\n *\n * @example\n * ```ts\n * import { uidex } from 'uidex/playwright';\n *\n * test('submit form', async ({ page }) => {\n *   await uidex(page, 'submit-btn').click();\n * });\n * ```\n */\nexport function uidex(page: Page, id: string): Locator {\n  return page.locator(uidexSelector(id));\n}\n\n/**\n * Create a typed locator factory bound to a Page instance.\n * When used with the generated ComponentId type, provides autocomplete\n * for all annotated component IDs.\n *\n * @example\n * ```ts\n * import { createUidexLocators } from 'uidex/playwright';\n * import type { ComponentId } from './uidex.gen.test';\n *\n * test('checkout flow', async ({ page }) => {\n *   const u = createUidexLocators<ComponentId>(page);\n *   await u('cart-summary').waitFor();  // autocomplete + type checking\n *   await u('checkout-btn').click();\n * });\n * ```\n */\nexport function createUidexLocators<T extends string = string>(\n  page: Page\n): (id: T) => Locator {\n  return (id: T) => page.locator(uidexSelector(id));\n}\n","import { test as base, expect } from '@playwright/test';\nimport type { Locator } from '@playwright/test';\nimport { uidexSelector, COVERAGE_ATTACHMENT } from './index';\n\ntype UidexLocator<T extends string = string> = (id: T) => Locator;\n\ninterface UidexFixtures {\n  /**\n   * Create a Playwright locator for a uidex-annotated element.\n   * Automatically tracks usage for the coverage reporter.\n   *\n   * @example\n   * ```ts\n   * test('add todo', async ({ uidex }) => {\n   *   await uidex('todo-input').fill('Buy milk');\n   *   await uidex('todo-add-button').click();\n   * });\n   * ```\n   */\n  uidex: UidexLocator;\n}\n\nexport const test = base.extend<UidexFixtures>({\n  uidex: async ({ page }, use, testInfo) => {\n    const used = new Set<string>();\n\n    const locator: UidexLocator = (id: string) => {\n      used.add(id);\n      return page.locator(uidexSelector(id));\n    };\n\n    await use(locator);\n\n    // Attach coverage data for the reporter to collect\n    await testInfo.attach(COVERAGE_ATTACHMENT, {\n      body: JSON.stringify([...used]),\n      contentType: 'application/json',\n    });\n  },\n});\n\nexport { expect };\nexport type { UidexLocator, UidexFixtures };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,kBAAqC;AAsB9B,IAAM,OAAO,YAAAA,KAAK,OAAsB;AAAA,EAC7C,OAAO,OAAO,EAAE,KAAK,GAAG,KAAK,aAAa;AACxC,UAAM,OAAO,oBAAI,IAAY;AAE7B,UAAM,UAAwB,CAAC,OAAe;AAC5C,WAAK,IAAI,EAAE;AACX,aAAO,KAAK,QAAQ,cAAc,EAAE,CAAC;AAAA,IACvC;AAEA,UAAM,IAAI,OAAO;AAGjB,UAAM,SAAS,OAAO,qBAAqB;AAAA,MACzC,MAAM,KAAK,UAAU,CAAC,GAAG,IAAI,CAAC;AAAA,MAC9B,aAAa;AAAA,IACf,CAAC;AAAA,EACH;AACF,CAAC;;;ADpCM,IAAM,aAAa;AAGnB,SAAS,cAAc,IAAoB;AAChD,SAAO,IAAI,UAAU,KAAK,EAAE;AAC9B;AAGO,IAAM,sBAAsB;AAkB5B,SAAS,MAAM,MAAY,IAAqB;AACrD,SAAO,KAAK,QAAQ,cAAc,EAAE,CAAC;AACvC;AAmBO,SAAS,oBACd,MACoB;AACpB,SAAO,CAAC,OAAU,KAAK,QAAQ,cAAc,EAAE,CAAC;AAClD;","names":["base"]}
+{"version":3,"sources":["../../src/playwright/index.ts","../../src/playwright/selector.ts","../../src/playwright/fixture.ts","../../src/playwright/reporter.ts"],"sourcesContent":["export {\n  COVERAGE_ATTACHMENT,\n  FLOW_TAG,\n  NOT_FLOW_TAG,\n  UIDEX_ATTRS,\n  uidexSelector,\n  type CoveragePayload,\n} from \"./selector\"\nexport { test, expect, resolveFlow, createUidexFixture } from \"./fixture\"\nexport type { UidexFixtures, UidexLocator, UidexFixtureHandle } from \"./fixture\"\nexport {\n  default as UidexCoverageReporter,\n  type FlowCoverage,\n  type UidexCoverageReport,\n  type UidexReporterOptions,\n} from \"./reporter\"\n","const ATTRS = [\n  \"data-uidex\",\n  \"data-uidex-region\",\n  \"data-uidex-widget\",\n  \"data-uidex-primitive\",\n] as const\n\nexport const UIDEX_ATTRS = ATTRS\n\nexport function uidexSelector(id: string): string {\n  const escaped = id.replace(/\"/g, '\\\\\"')\n  return ATTRS.map((a) => `[${a}=\"${escaped}\"]`).join(\", \")\n}\n\nexport function kebab(input: string): string {\n  return input\n    .trim()\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\")\n}\n\nexport const FLOW_TAG = \"@uidex:flow\"\nexport const NOT_FLOW_TAG = \"@uidex:not-flow\"\nexport const COVERAGE_ATTACHMENT = \"uidex-coverage\"\n\nexport interface CoveragePayload {\n  flow: string | null\n  notFlow: boolean\n  ids: string[]\n  title: string\n}\n","import { test as base, expect } from \"@playwright/test\"\nimport type { Locator, TestInfo } from \"@playwright/test\"\nimport {\n  COVERAGE_ATTACHMENT,\n  FLOW_TAG,\n  NOT_FLOW_TAG,\n  kebab,\n  uidexSelector,\n  type CoveragePayload,\n} from \"./selector\"\n\nexport type UidexLocator<T extends string = string> = (id: T) => Locator\n\nexport interface UidexFixtures {\n  uidex: UidexLocator\n}\n\ninterface FlowResolution {\n  flow: string | null\n  notFlow: boolean\n}\n\ntype TestInfoLike = Pick<TestInfo, \"tags\" | \"titlePath\" | \"title\">\n\nexport function resolveFlow(testInfo: TestInfoLike): FlowResolution {\n  const tags = testInfo.tags ?? []\n  const notFlow = tags.includes(NOT_FLOW_TAG)\n  if (notFlow) return { flow: null, notFlow: true }\n  if (!tags.includes(FLOW_TAG)) return { flow: null, notFlow: false }\n  const describes = describeTitles(testInfo.titlePath ?? [], testInfo.title)\n  const source =\n    describes.length > 0\n      ? describes[describes.length - 1]\n      : (testInfo.title ?? \"\")\n  return { flow: kebab(source) || null, notFlow: false }\n}\n\nconst FILE_RE = /\\.(spec|test)\\.(t|j)sx?$|\\.(t|j)sx?$|[\\\\/]/\n\nfunction describeTitles(titlePath: string[], testTitle: string): string[] {\n  const end =\n    titlePath.length > 0 && titlePath[titlePath.length - 1] === testTitle\n      ? titlePath.length - 1\n      : titlePath.length\n  const out: string[] = []\n  for (let i = 0; i < end; i++) {\n    const entry = titlePath[i]\n    if (!entry) continue\n    if (FILE_RE.test(entry)) continue\n    if (i === 0) continue // project name\n    out.push(entry)\n  }\n  return out\n}\n\ninterface PageLike {\n  locator: (selector: string) => Locator\n}\n\nexport interface UidexFixtureHandle {\n  locator: UidexLocator\n  buildPayload: () => CoveragePayload\n}\n\nexport function createUidexFixture(\n  page: PageLike,\n  testInfo: TestInfoLike\n): UidexFixtureHandle {\n  const used = new Set<string>()\n  const locator: UidexLocator = (id: string) => {\n    used.add(id)\n    return page.locator(uidexSelector(id))\n  }\n  const buildPayload = (): CoveragePayload => {\n    const { flow, notFlow } = resolveFlow(testInfo)\n    return {\n      flow,\n      notFlow,\n      ids: [...used].sort(),\n      title: testInfo.title,\n    }\n  }\n  return { locator, buildPayload }\n}\n\nexport const test = base.extend<UidexFixtures>({\n  uidex: async ({ page }, use, testInfo) => {\n    const handle = createUidexFixture(page, testInfo)\n    // eslint-disable-next-line react-hooks/rules-of-hooks\n    await use(handle.locator)\n    await testInfo.attach(COVERAGE_ATTACHMENT, {\n      body: JSON.stringify(handle.buildPayload()),\n      contentType: \"application/json\",\n    })\n  },\n})\n\nexport { expect }\n","import * as fs from \"node:fs\"\nimport * as path from \"node:path\"\nimport type {\n  FullResult,\n  Reporter,\n  TestCase,\n  TestResult,\n} from \"@playwright/test/reporter\"\nimport { COVERAGE_ATTACHMENT, type CoveragePayload } from \"./selector\"\n\nexport interface UidexReporterOptions {\n  outputPath?: string\n  entityIds?: readonly string[]\n  silent?: boolean\n}\n\nexport interface FlowCoverage {\n  flow: string\n  ids: string[]\n  titles: string[]\n}\n\nexport interface UidexCoverageReport {\n  flows: FlowCoverage[]\n  untagged: { title: string; ids: string[] }[]\n  touched: string[]\n  untouched: string[]\n  total: number\n  percentage: number\n}\n\nexport default class UidexCoverageReporter implements Reporter {\n  private readonly outputPath: string\n  private readonly entityIds: readonly string[]\n  private readonly silent: boolean\n  private readonly flows = new Map<\n    string,\n    { ids: Set<string>; titles: Set<string> }\n  >()\n  private readonly untagged: { title: string; ids: string[] }[] = []\n  private readonly touched = new Set<string>()\n\n  constructor(options: UidexReporterOptions = {}) {\n    this.outputPath = options.outputPath ?? \"uidex-coverage.json\"\n    this.entityIds = options.entityIds ?? []\n    this.silent = options.silent ?? false\n  }\n\n  onTestEnd(_test: TestCase, result: TestResult): void {\n    for (const attachment of result.attachments) {\n      if (attachment.name !== COVERAGE_ATTACHMENT) continue\n      if (!attachment.body) continue\n      const payload = parsePayload(attachment.body.toString())\n      if (!payload) continue\n      if (payload.notFlow) continue\n      for (const id of payload.ids) this.touched.add(id)\n      if (payload.flow) {\n        const entry = this.flows.get(payload.flow) ?? {\n          ids: new Set<string>(),\n          titles: new Set<string>(),\n        }\n        for (const id of payload.ids) entry.ids.add(id)\n        entry.titles.add(payload.title)\n        this.flows.set(payload.flow, entry)\n      } else {\n        this.untagged.push({ title: payload.title, ids: payload.ids })\n      }\n    }\n  }\n\n  async onEnd(_result: FullResult): Promise<void> {\n    const flows: FlowCoverage[] = [...this.flows.entries()]\n      .map(([flow, entry]) => ({\n        flow,\n        ids: [...entry.ids].sort(),\n        titles: [...entry.titles].sort(),\n      }))\n      .sort((a, b) => a.flow.localeCompare(b.flow))\n\n    const all = [...this.entityIds]\n    const touched = all.filter((id) => this.touched.has(id)).sort()\n    const untouched = all.filter((id) => !this.touched.has(id)).sort()\n    const total = all.length\n    const percentage =\n      total > 0 ? Math.round((touched.length / total) * 100) : 0\n\n    const report: UidexCoverageReport = {\n      flows,\n      untagged: this.untagged,\n      touched,\n      untouched,\n      total,\n      percentage,\n    }\n\n    fs.mkdirSync(path.dirname(path.resolve(this.outputPath)), {\n      recursive: true,\n    })\n    fs.writeFileSync(\n      path.resolve(this.outputPath),\n      JSON.stringify(report, null, 2) + \"\\n\"\n    )\n\n    if (!this.silent) {\n      const line =\n        total > 0\n          ? `uidex coverage: ${touched.length}/${total} entities (${percentage}%) across ${flows.length} flow(s)`\n          : `uidex coverage: ${flows.length} flow(s), ${this.touched.size} entity id(s) touched`\n\n      console.log(line)\n    }\n  }\n}\n\nfunction parsePayload(raw: string): CoveragePayload | null {\n  try {\n    const parsed = JSON.parse(raw) as Partial<CoveragePayload>\n    if (!parsed || !Array.isArray(parsed.ids)) return null\n    return {\n      flow: typeof parsed.flow === \"string\" ? parsed.flow : null,\n      notFlow: Boolean(parsed.notFlow),\n      ids: parsed.ids.filter((x): x is string => typeof x === \"string\"),\n      title: typeof parsed.title === \"string\" ? parsed.title : \"\",\n    }\n  } catch {\n    return null\n  }\n}\n"],"mappings":"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","names":["base"]}

package/dist/playwright/index.d.cts

@@ -1,62 +1,39 @@
 import * as _playwright_test from '@playwright/test';
-import { Locator, Page } from '@playwright/test';
+import { Locator, TestInfo } from '@playwright/test';
 export { expect } from '@playwright/test';
+export { FlowCoverage, UidexCoverageReport, default as UidexCoverageReporter, UidexReporterOptions } from './reporter.cjs';
+import '@playwright/test/reporter';
+
+declare const UIDEX_ATTRS: readonly ["data-uidex", "data-uidex-region", "data-uidex-widget", "data-uidex-primitive"];
+declare function uidexSelector(id: string): string;
+declare const FLOW_TAG = "@uidex:flow";
+declare const NOT_FLOW_TAG = "@uidex:not-flow";
+declare const COVERAGE_ATTACHMENT = "uidex-coverage";
+interface CoveragePayload {
+    flow: string | null;
+    notFlow: boolean;
+    ids: string[];
+    title: string;
+}
 
 type UidexLocator<T extends string = string> = (id: T) => Locator;
 interface UidexFixtures {
-    /**
-     * Create a Playwright locator for a uidex-annotated element.
-     * Automatically tracks usage for the coverage reporter.
-     *
-     * @example
-     * ```ts
-     * test('add todo', async ({ uidex }) => {
-     *   await uidex('todo-input').fill('Buy milk');
-     *   await uidex('todo-add-button').click();
-     * });
-     * ```
-     */
     uidex: UidexLocator;
 }
+interface FlowResolution {
+    flow: string | null;
+    notFlow: boolean;
+}
+type TestInfoLike = Pick<TestInfo, "tags" | "titlePath" | "title">;
+declare function resolveFlow(testInfo: TestInfoLike): FlowResolution;
+interface PageLike {
+    locator: (selector: string) => Locator;
+}
+interface UidexFixtureHandle {
+    locator: UidexLocator;
+    buildPayload: () => CoveragePayload;
+}
+declare function createUidexFixture(page: PageLike, testInfo: TestInfoLike): UidexFixtureHandle;
 declare const test: _playwright_test.TestType<_playwright_test.PlaywrightTestArgs & _playwright_test.PlaywrightTestOptions & UidexFixtures, _playwright_test.PlaywrightWorkerArgs & _playwright_test.PlaywrightWorkerOptions>;
 
-/** The data attribute used for uidex component selectors. */
-declare const UIDEX_ATTR = "data-uidex";
-/** Build a CSS selector for a uidex-annotated element. */
-declare function uidexSelector(id: string): string;
-/** Attachment name used to pass coverage data from fixture to reporter. */
-declare const COVERAGE_ATTACHMENT = "uidex-coverage";
-
-/**
- * Create a Playwright locator for a uidex-annotated element.
- *
- * @example
- * ```ts
- * import { uidex } from 'uidex/playwright';
- *
- * test('submit form', async ({ page }) => {
- *   await uidex(page, 'submit-btn').click();
- * });
- * ```
- */
-declare function uidex(page: Page, id: string): Locator;
-/**
- * Create a typed locator factory bound to a Page instance.
- * When used with the generated ComponentId type, provides autocomplete
- * for all annotated component IDs.
- *
- * @example
- * ```ts
- * import { createUidexLocators } from 'uidex/playwright';
- * import type { ComponentId } from './uidex.gen.test';
- *
- * test('checkout flow', async ({ page }) => {
- *   const u = createUidexLocators<ComponentId>(page);
- *   await u('cart-summary').waitFor();  // autocomplete + type checking
- *   await u('checkout-btn').click();
- * });
- * ```
- */
-declare function createUidexLocators<T extends string = string>(page: Page): (id: T) => Locator;
-
-export { COVERAGE_ATTACHMENT, UIDEX_ATTR, type UidexFixtures, type UidexLocator, createUidexLocators, test, uidex, uidexSelector };
+export { COVERAGE_ATTACHMENT, type CoveragePayload, FLOW_TAG, NOT_FLOW_TAG, UIDEX_ATTRS, type UidexFixtureHandle, type UidexFixtures, type UidexLocator, createUidexFixture, resolveFlow, test, uidexSelector };

package/dist/playwright/index.d.ts

@@ -1,62 +1,39 @@
 import * as _playwright_test from '@playwright/test';
-import { Locator, Page } from '@playwright/test';
+import { Locator, TestInfo } from '@playwright/test';
 export { expect } from '@playwright/test';
+export { FlowCoverage, UidexCoverageReport, default as UidexCoverageReporter, UidexReporterOptions } from './reporter.js';
+import '@playwright/test/reporter';
+
+declare const UIDEX_ATTRS: readonly ["data-uidex", "data-uidex-region", "data-uidex-widget", "data-uidex-primitive"];
+declare function uidexSelector(id: string): string;
+declare const FLOW_TAG = "@uidex:flow";
+declare const NOT_FLOW_TAG = "@uidex:not-flow";
+declare const COVERAGE_ATTACHMENT = "uidex-coverage";
+interface CoveragePayload {
+    flow: string | null;
+    notFlow: boolean;
+    ids: string[];
+    title: string;
+}
 
 type UidexLocator<T extends string = string> = (id: T) => Locator;
 interface UidexFixtures {
-    /**
-     * Create a Playwright locator for a uidex-annotated element.
-     * Automatically tracks usage for the coverage reporter.
-     *
-     * @example
-     * ```ts
-     * test('add todo', async ({ uidex }) => {
-     *   await uidex('todo-input').fill('Buy milk');
-     *   await uidex('todo-add-button').click();
-     * });
-     * ```
-     */
     uidex: UidexLocator;
 }
+interface FlowResolution {
+    flow: string | null;
+    notFlow: boolean;
+}
+type TestInfoLike = Pick<TestInfo, "tags" | "titlePath" | "title">;
+declare function resolveFlow(testInfo: TestInfoLike): FlowResolution;
+interface PageLike {
+    locator: (selector: string) => Locator;
+}
+interface UidexFixtureHandle {
+    locator: UidexLocator;
+    buildPayload: () => CoveragePayload;
+}
+declare function createUidexFixture(page: PageLike, testInfo: TestInfoLike): UidexFixtureHandle;
 declare const test: _playwright_test.TestType<_playwright_test.PlaywrightTestArgs & _playwright_test.PlaywrightTestOptions & UidexFixtures, _playwright_test.PlaywrightWorkerArgs & _playwright_test.PlaywrightWorkerOptions>;
 
-/** The data attribute used for uidex component selectors. */
-declare const UIDEX_ATTR = "data-uidex";
-/** Build a CSS selector for a uidex-annotated element. */
-declare function uidexSelector(id: string): string;
-/** Attachment name used to pass coverage data from fixture to reporter. */
-declare const COVERAGE_ATTACHMENT = "uidex-coverage";
-
-/**
- * Create a Playwright locator for a uidex-annotated element.
- *
- * @example
- * ```ts
- * import { uidex } from 'uidex/playwright';
- *
- * test('submit form', async ({ page }) => {
- *   await uidex(page, 'submit-btn').click();
- * });
- * ```
- */
-declare function uidex(page: Page, id: string): Locator;
-/**
- * Create a typed locator factory bound to a Page instance.
- * When used with the generated ComponentId type, provides autocomplete
- * for all annotated component IDs.
- *
- * @example
- * ```ts
- * import { createUidexLocators } from 'uidex/playwright';
- * import type { ComponentId } from './uidex.gen.test';
- *
- * test('checkout flow', async ({ page }) => {
- *   const u = createUidexLocators<ComponentId>(page);
- *   await u('cart-summary').waitFor();  // autocomplete + type checking
- *   await u('checkout-btn').click();
- * });
- * ```
- */
-declare function createUidexLocators<T extends string = string>(page: Page): (id: T) => Locator;
-
-export { COVERAGE_ATTACHMENT, UIDEX_ATTR, type UidexFixtures, type UidexLocator, createUidexLocators, test, uidex, uidexSelector };
+export { COVERAGE_ATTACHMENT, type CoveragePayload, FLOW_TAG, NOT_FLOW_TAG, UIDEX_ATTRS, type UidexFixtureHandle, type UidexFixtures, type UidexLocator, createUidexFixture, resolveFlow, test, uidexSelector };

package/dist/playwright/index.js

@@ -1,39 +1,166 @@
+// src/playwright/selector.ts
+var ATTRS = [
+  "data-uidex",
+  "data-uidex-region",
+  "data-uidex-widget",
+  "data-uidex-primitive"
+];
+var UIDEX_ATTRS = ATTRS;
+function uidexSelector(id) {
+  const escaped = id.replace(/"/g, '\\"');
+  return ATTRS.map((a) => `[${a}="${escaped}"]`).join(", ");
+}
+function kebab(input) {
+  return input.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+}
+var FLOW_TAG = "@uidex:flow";
+var NOT_FLOW_TAG = "@uidex:not-flow";
+var COVERAGE_ATTACHMENT = "uidex-coverage";
+
 // src/playwright/fixture.ts
 import { test as base, expect } from "@playwright/test";
+function resolveFlow(testInfo) {
+  const tags = testInfo.tags ?? [];
+  const notFlow = tags.includes(NOT_FLOW_TAG);
+  if (notFlow) return { flow: null, notFlow: true };
+  if (!tags.includes(FLOW_TAG)) return { flow: null, notFlow: false };
+  const describes = describeTitles(testInfo.titlePath ?? [], testInfo.title);
+  const source = describes.length > 0 ? describes[describes.length - 1] : testInfo.title ?? "";
+  return { flow: kebab(source) || null, notFlow: false };
+}
+var FILE_RE = /\.(spec|test)\.(t|j)sx?$|\.(t|j)sx?$|[\\/]/;
+function describeTitles(titlePath, testTitle) {
+  const end = titlePath.length > 0 && titlePath[titlePath.length - 1] === testTitle ? titlePath.length - 1 : titlePath.length;
+  const out = [];
+  for (let i = 0; i < end; i++) {
+    const entry = titlePath[i];
+    if (!entry) continue;
+    if (FILE_RE.test(entry)) continue;
+    if (i === 0) continue;
+    out.push(entry);
+  }
+  return out;
+}
+function createUidexFixture(page, testInfo) {
+  const used = /* @__PURE__ */ new Set();
+  const locator = (id) => {
+    used.add(id);
+    return page.locator(uidexSelector(id));
+  };
+  const buildPayload = () => {
+    const { flow, notFlow } = resolveFlow(testInfo);
+    return {
+      flow,
+      notFlow,
+      ids: [...used].sort(),
+      title: testInfo.title
+    };
+  };
+  return { locator, buildPayload };
+}
 var test = base.extend({
   uidex: async ({ page }, use, testInfo) => {
-    const used = /* @__PURE__ */ new Set();
-    const locator = (id) => {
-      used.add(id);
-      return page.locator(uidexSelector(id));
-    };
-    await use(locator);
+    const handle = createUidexFixture(page, testInfo);
+    await use(handle.locator);
     await testInfo.attach(COVERAGE_ATTACHMENT, {
-      body: JSON.stringify([...used]),
+      body: JSON.stringify(handle.buildPayload()),
       contentType: "application/json"
     });
   }
 });
 
-// src/playwright/index.ts
-var UIDEX_ATTR = "data-uidex";
-function uidexSelector(id) {
-  return `[${UIDEX_ATTR}="${id}"]`;
-}
-var COVERAGE_ATTACHMENT = "uidex-coverage";
-function uidex(page, id) {
-  return page.locator(uidexSelector(id));
-}
-function createUidexLocators(page) {
-  return (id) => page.locator(uidexSelector(id));
+// src/playwright/reporter.ts
+import * as fs from "fs";
+import * as path from "path";
+var UidexCoverageReporter = class {
+  outputPath;
+  entityIds;
+  silent;
+  flows = /* @__PURE__ */ new Map();
+  untagged = [];
+  touched = /* @__PURE__ */ new Set();
+  constructor(options = {}) {
+    this.outputPath = options.outputPath ?? "uidex-coverage.json";
+    this.entityIds = options.entityIds ?? [];
+    this.silent = options.silent ?? false;
+  }
+  onTestEnd(_test, result) {
+    for (const attachment of result.attachments) {
+      if (attachment.name !== COVERAGE_ATTACHMENT) continue;
+      if (!attachment.body) continue;
+      const payload = parsePayload(attachment.body.toString());
+      if (!payload) continue;
+      if (payload.notFlow) continue;
+      for (const id of payload.ids) this.touched.add(id);
+      if (payload.flow) {
+        const entry = this.flows.get(payload.flow) ?? {
+          ids: /* @__PURE__ */ new Set(),
+          titles: /* @__PURE__ */ new Set()
+        };
+        for (const id of payload.ids) entry.ids.add(id);
+        entry.titles.add(payload.title);
+        this.flows.set(payload.flow, entry);
+      } else {
+        this.untagged.push({ title: payload.title, ids: payload.ids });
+      }
+    }
+  }
+  async onEnd(_result) {
+    const flows = [...this.flows.entries()].map(([flow, entry]) => ({
+      flow,
+      ids: [...entry.ids].sort(),
+      titles: [...entry.titles].sort()
+    })).sort((a, b) => a.flow.localeCompare(b.flow));
+    const all = [...this.entityIds];
+    const touched = all.filter((id) => this.touched.has(id)).sort();
+    const untouched = all.filter((id) => !this.touched.has(id)).sort();
+    const total = all.length;
+    const percentage = total > 0 ? Math.round(touched.length / total * 100) : 0;
+    const report = {
+      flows,
+      untagged: this.untagged,
+      touched,
+      untouched,
+      total,
+      percentage
+    };
+    fs.mkdirSync(path.dirname(path.resolve(this.outputPath)), {
+      recursive: true
+    });
+    fs.writeFileSync(
+      path.resolve(this.outputPath),
+      JSON.stringify(report, null, 2) + "\n"
+    );
+    if (!this.silent) {
+      const line = total > 0 ? `uidex coverage: ${touched.length}/${total} entities (${percentage}%) across ${flows.length} flow(s)` : `uidex coverage: ${flows.length} flow(s), ${this.touched.size} entity id(s) touched`;
+      console.log(line);
+    }
+  }
+};
+function parsePayload(raw) {
+  try {
+    const parsed = JSON.parse(raw);
+    if (!parsed || !Array.isArray(parsed.ids)) return null;
+    return {
+      flow: typeof parsed.flow === "string" ? parsed.flow : null,
+      notFlow: Boolean(parsed.notFlow),
+      ids: parsed.ids.filter((x) => typeof x === "string"),
+      title: typeof parsed.title === "string" ? parsed.title : ""
+    };
+  } catch {
+    return null;
+  }
 }
 export {
   COVERAGE_ATTACHMENT,
-  UIDEX_ATTR,
-  createUidexLocators,
+  FLOW_TAG,
+  NOT_FLOW_TAG,
+  UIDEX_ATTRS,
+  UidexCoverageReporter,
+  createUidexFixture,
   expect,
+  resolveFlow,
   test,
-  uidex,
   uidexSelector
 };
 //# sourceMappingURL=index.js.map