@noego/wood 0.4.9 → 0.5.0

package/dist/automation/index.cjs

@@ -0,0 +1,49 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var automation_exports = {};
+module.exports = __toCommonJS(automation_exports);
+__reExport(automation_exports, require("./errors.cjs"), module.exports);
+__reExport(automation_exports, require("./target_identity.cjs"), module.exports);
+__reExport(automation_exports, require("./locator.cjs"), module.exports);
+__reExport(automation_exports, require("./actions.cjs"), module.exports);
+__reExport(automation_exports, require("./waits.cjs"), module.exports);
+__reExport(automation_exports, require("./scrolling.cjs"), module.exports);
+__reExport(automation_exports, require("./observation.cjs"), module.exports);
+__reExport(automation_exports, require("./receipts.cjs"), module.exports);
+__reExport(automation_exports, require("./connection.cjs"), module.exports);
+__reExport(automation_exports, require("./target_registry.cjs"), module.exports);
+__reExport(automation_exports, require("./waits_executor.cjs"), module.exports);
+__reExport(automation_exports, require("./scrolling_executor.cjs"), module.exports);
+__reExport(automation_exports, require("./actions_executor.cjs"), module.exports);
+__reExport(automation_exports, require("./scenario.cjs"), module.exports);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ...require("./errors.cjs"),
+  ...require("./target_identity.cjs"),
+  ...require("./locator.cjs"),
+  ...require("./actions.cjs"),
+  ...require("./waits.cjs"),
+  ...require("./scrolling.cjs"),
+  ...require("./observation.cjs"),
+  ...require("./receipts.cjs"),
+  ...require("./connection.cjs"),
+  ...require("./target_registry.cjs"),
+  ...require("./waits_executor.cjs"),
+  ...require("./scrolling_executor.cjs"),
+  ...require("./actions_executor.cjs"),
+  ...require("./scenario.cjs")
+});
+//# sourceMappingURL=index.cjs.map

package/dist/automation/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/automation/index.ts"],"sourcesContent":["/**\n * @noego/wood/automation — typed live-surface driving core for Wood apps.\n *\n * Frozen WP-00 contracts (targets, locators, actions, waits, scrolling,\n * observations, receipts, errors) plus the WP-01 extraction of connection\n * and deterministic target selection out of bin/axe.js.\n */\n\nexport * from './errors.cjs';\nexport * from './target_identity.cjs';\nexport * from './locator.cjs';\nexport * from './actions.cjs';\nexport * from './waits.cjs';\nexport * from './scrolling.cjs';\nexport * from './observation.cjs';\nexport * from './receipts.cjs';\nexport * from './connection.cjs';\nexport * from './target_registry.cjs';\nexport * from './waits_executor.cjs';\nexport * from './scrolling_executor.cjs';\nexport * from './actions_executor.cjs';\nexport * from './scenario.cjs';\n"],"mappings":";;;;;;;;;;;;;;;AAAA;AAAA;AAQA,+BAAc,yBARd;AASA,+BAAc,kCATd;AAUA,+BAAc,0BAVd;AAWA,+BAAc,0BAXd;AAYA,+BAAc,wBAZd;AAaA,+BAAc,4BAbd;AAcA,+BAAc,8BAdd;AAeA,+BAAc,2BAfd;AAgBA,+BAAc,6BAhBd;AAiBA,+BAAc,kCAjBd;AAkBA,+BAAc,iCAlBd;AAmBA,+BAAc,qCAnBd;AAoBA,+BAAc,mCApBd;AAqBA,+BAAc,2BArBd;","names":[]}

package/dist/automation/index.d.cts

@@ -0,0 +1,16 @@
+export { WoodAutomationError, WoodAutomationErrorCode, WoodAutomationResult, automationError, automationOk, describeAutomationError } from './errors.cjs';
+export { WoodLiveTarget } from './target_identity.cjs';
+export { WoodLocator, describeLocator, isLowStabilityLocator, parseCliLocator, toPlaywrightLocator } from './locator.cjs';
+export { WoodAutomationAction } from './actions.cjs';
+export { WoodWaitCondition } from './waits.cjs';
+export { WoodScrollCommand, WoodScrollContainer, WoodScrollMetrics } from './scrolling.cjs';
+export { WoodConsoleEntry, WoodObservation } from './observation.cjs';
+export { WoodActionReceipt, WoodActionability } from './receipts.cjs';
+export { WoodAutomationConnection, connectToWoodApp, readDevMetadata } from './connection.cjs';
+export { WOOD_INTERNAL_BRIDGE_KEY, WoodTargetEntry, discoverTargets, selectTarget } from './target_registry.cjs';
+export { awaitCondition, matchesUrl } from './waits_executor.cjs';
+export { executeScroll, hasNoProgress } from './scrolling_executor.cjs';
+export { deriveReceiptChanges, executeAction } from './actions_executor.cjs';
+export { WoodScenario, WoodScenarioEvent, WoodScenarioHooks, WoodScenarioReport, WoodScenarioStepReport, parseScenario, runScenario, runScenarioOnPage } from './scenario.cjs';
+import 'playwright';
+import '../dev/dev_metadata.cjs';

package/dist/automation/index.d.ts

@@ -0,0 +1,16 @@
+export { WoodAutomationError, WoodAutomationErrorCode, WoodAutomationResult, automationError, automationOk, describeAutomationError } from './errors.js';
+export { WoodLiveTarget } from './target_identity.js';
+export { WoodLocator, describeLocator, isLowStabilityLocator, parseCliLocator, toPlaywrightLocator } from './locator.js';
+export { WoodAutomationAction } from './actions.js';
+export { WoodWaitCondition } from './waits.js';
+export { WoodScrollCommand, WoodScrollContainer, WoodScrollMetrics } from './scrolling.js';
+export { WoodConsoleEntry, WoodObservation } from './observation.js';
+export { WoodActionReceipt, WoodActionability } from './receipts.js';
+export { WoodAutomationConnection, connectToWoodApp, readDevMetadata } from './connection.js';
+export { WOOD_INTERNAL_BRIDGE_KEY, WoodTargetEntry, discoverTargets, selectTarget } from './target_registry.js';
+export { awaitCondition, matchesUrl } from './waits_executor.js';
+export { executeScroll, hasNoProgress } from './scrolling_executor.js';
+export { deriveReceiptChanges, executeAction } from './actions_executor.js';
+export { WoodScenario, WoodScenarioEvent, WoodScenarioHooks, WoodScenarioReport, WoodScenarioStepReport, parseScenario, runScenario, runScenarioOnPage } from './scenario.js';
+import 'playwright';
+import '../dev/dev_metadata.js';

package/dist/automation/index.js

@@ -0,0 +1,15 @@
+export * from "./errors.js";
+export * from "./target_identity.js";
+export * from "./locator.js";
+export * from "./actions.js";
+export * from "./waits.js";
+export * from "./scrolling.js";
+export * from "./observation.js";
+export * from "./receipts.js";
+export * from "./connection.js";
+export * from "./target_registry.js";
+export * from "./waits_executor.js";
+export * from "./scrolling_executor.js";
+export * from "./actions_executor.js";
+export * from "./scenario.js";
+//# sourceMappingURL=index.js.map

package/dist/automation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/automation/index.ts"],"sourcesContent":["/**\n * @noego/wood/automation — typed live-surface driving core for Wood apps.\n *\n * Frozen WP-00 contracts (targets, locators, actions, waits, scrolling,\n * observations, receipts, errors) plus the WP-01 extraction of connection\n * and deterministic target selection out of bin/axe.js.\n */\n\nexport * from './errors.js';\nexport * from './target_identity.js';\nexport * from './locator.js';\nexport * from './actions.js';\nexport * from './waits.js';\nexport * from './scrolling.js';\nexport * from './observation.js';\nexport * from './receipts.js';\nexport * from './connection.js';\nexport * from './target_registry.js';\nexport * from './waits_executor.js';\nexport * from './scrolling_executor.js';\nexport * from './actions_executor.js';\nexport * from './scenario.js';\n"],"mappings":"AAQA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;","names":[]}

package/dist/automation/introspection_reader.cjs

@@ -0,0 +1,75 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var introspection_reader_exports = {};
+__export(introspection_reader_exports, {
+  WOOD_AUTOMATION_GLOBAL_KEY: () => WOOD_AUTOMATION_GLOBAL_KEY,
+  formatRoute: () => formatRoute,
+  readAutomationSnapshot: () => readAutomationSnapshot,
+  waitForRendererIdle: () => waitForRendererIdle
+});
+module.exports = __toCommonJS(introspection_reader_exports);
+const WOOD_AUTOMATION_GLOBAL_KEY = "__NOEGO_WOOD_AUTOMATION__";
+async function readAutomationSnapshot(page) {
+  try {
+    const snapshot = await page.evaluate((key) => {
+      const surface = globalThis[key];
+      if (!surface || surface.version !== 1 || typeof surface.snapshot !== "function") {
+        return null;
+      }
+      return surface.snapshot();
+    }, WOOD_AUTOMATION_GLOBAL_KEY);
+    return snapshot ?? null;
+  } catch {
+    return null;
+  }
+}
+async function waitForRendererIdle(page, options) {
+  try {
+    return await page.evaluate(
+      async ({ key, timeoutMs, idleFrames }) => {
+        const surface = globalThis[key];
+        if (!surface || surface.version !== 1 || typeof surface.waitForIdle !== "function") {
+          return false;
+        }
+        return await surface.waitForIdle({ timeoutMs, idleFrames });
+      },
+      { key: WOOD_AUTOMATION_GLOBAL_KEY, timeoutMs: options?.timeoutMs, idleFrames: options?.idleFrames }
+    );
+  } catch {
+    return false;
+  }
+}
+function formatRoute(route) {
+  if (!route) {
+    return void 0;
+  }
+  const params = Object.entries(route.params);
+  const query = Object.entries(route.query);
+  const paramsPart = params.length ? `(${params.map(([k, v]) => `${k}=${v}`).join(",")})` : "";
+  const queryPart = query.length ? `?${query.map(([k, v]) => `${k}=${v}`).join("&")}` : "";
+  return `${route.page}${paramsPart}${queryPart}`;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  WOOD_AUTOMATION_GLOBAL_KEY,
+  formatRoute,
+  readAutomationSnapshot,
+  waitForRendererIdle
+});
+//# sourceMappingURL=introspection_reader.cjs.map

package/dist/automation/introspection_reader.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/automation/introspection_reader.ts"],"sourcesContent":["/**\n * Node-side reader for the renderer introspection surface (AXE-WP-02).\n * Counterpart of src/navigation/automation_introspection.ts.\n */\n\nimport type { Page } from 'playwright';\nimport type { WoodAutomationSnapshot } from '../navigation/automation_introspection.cjs';\n\nexport const WOOD_AUTOMATION_GLOBAL_KEY = '__NOEGO_WOOD_AUTOMATION__';\n\n/** Read the renderer automation snapshot; null when the surface is absent (production build or pre-boot). */\nexport async function readAutomationSnapshot(page: Page): Promise<WoodAutomationSnapshot | null> {\n  try {\n    const snapshot = await page.evaluate((key) => {\n      const surface = (globalThis as Record<string, unknown>)[key] as\n        | { version?: number; snapshot?: () => unknown }\n        | undefined;\n      if (!surface || surface.version !== 1 || typeof surface.snapshot !== 'function') {\n        return null;\n      }\n      return surface.snapshot();\n    }, WOOD_AUTOMATION_GLOBAL_KEY);\n    return (snapshot as WoodAutomationSnapshot | null) ?? null;\n  } catch {\n    return null;\n  }\n}\n\n/** Ask the renderer to wait for app idle; false when unsupported or timed out. */\nexport async function waitForRendererIdle(\n  page: Page,\n  options?: { timeoutMs?: number; idleFrames?: number },\n): Promise<boolean> {\n  try {\n    return await page.evaluate(\n      async ({ key, timeoutMs, idleFrames }) => {\n        const surface = (globalThis as Record<string, unknown>)[key] as\n          | { version?: number; waitForIdle?: (o: { timeoutMs?: number; idleFrames?: number }) => Promise<boolean> }\n          | undefined;\n        if (!surface || surface.version !== 1 || typeof surface.waitForIdle !== 'function') {\n          return false;\n        }\n        return await surface.waitForIdle({ timeoutMs, idleFrames });\n      },\n      { key: WOOD_AUTOMATION_GLOBAL_KEY, timeoutMs: options?.timeoutMs, idleFrames: options?.idleFrames },\n    );\n  } catch {\n    return false;\n  }\n}\n\n/** Render a snapshot route as the canonical route string used in receipts. */\nexport function formatRoute(route: WoodAutomationSnapshot['currentRoute']): string | undefined {\n  if (!route) {\n    return undefined;\n  }\n  const params = Object.entries(route.params);\n  const query = Object.entries(route.query);\n  const paramsPart = params.length ? `(${params.map(([k, v]) => `${k}=${v}`).join(',')})` : '';\n  const queryPart = query.length ? `?${query.map(([k, v]) => `${k}=${v}`).join('&')}` : '';\n  return `${route.page}${paramsPart}${queryPart}`;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAQO,MAAM,6BAA6B;AAG1C,eAAsB,uBAAuB,MAAoD;AAC/F,MAAI;AACF,UAAM,WAAW,MAAM,KAAK,SAAS,CAAC,QAAQ;AAC5C,YAAM,UAAW,WAAuC,GAAG;AAG3D,UAAI,CAAC,WAAW,QAAQ,YAAY,KAAK,OAAO,QAAQ,aAAa,YAAY;AAC/E,eAAO;AAAA,MACT;AACA,aAAO,QAAQ,SAAS;AAAA,IAC1B,GAAG,0BAA0B;AAC7B,WAAQ,YAA8C;AAAA,EACxD,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAGA,eAAsB,oBACpB,MACA,SACkB;AAClB,MAAI;AACF,WAAO,MAAM,KAAK;AAAA,MAChB,OAAO,EAAE,KAAK,WAAW,WAAW,MAAM;AACxC,cAAM,UAAW,WAAuC,GAAG;AAG3D,YAAI,CAAC,WAAW,QAAQ,YAAY,KAAK,OAAO,QAAQ,gBAAgB,YAAY;AAClF,iBAAO;AAAA,QACT;AACA,eAAO,MAAM,QAAQ,YAAY,EAAE,WAAW,WAAW,CAAC;AAAA,MAC5D;AAAA,MACA,EAAE,KAAK,4BAA4B,WAAW,SAAS,WAAW,YAAY,SAAS,WAAW;AAAA,IACpG;AAAA,EACF,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAGO,SAAS,YAAY,OAAmE;AAC7F,MAAI,CAAC,OAAO;AACV,WAAO;AAAA,EACT;AACA,QAAM,SAAS,OAAO,QAAQ,MAAM,MAAM;AAC1C,QAAM,QAAQ,OAAO,QAAQ,MAAM,KAAK;AACxC,QAAM,aAAa,OAAO,SAAS,IAAI,OAAO,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,GAAG,CAAC,MAAM;AAC1F,QAAM,YAAY,MAAM,SAAS,IAAI,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,GAAG,CAAC,KAAK;AACtF,SAAO,GAAG,MAAM,IAAI,GAAG,UAAU,GAAG,SAAS;AAC/C;","names":[]}

package/dist/automation/introspection_reader.d.cts

@@ -0,0 +1,20 @@
+import { Page } from 'playwright';
+import { WoodAutomationSnapshot } from '../navigation/automation_introspection.cjs';
+
+/**
+ * Node-side reader for the renderer introspection surface (AXE-WP-02).
+ * Counterpart of src/navigation/automation_introspection.ts.
+ */
+
+declare const WOOD_AUTOMATION_GLOBAL_KEY = "__NOEGO_WOOD_AUTOMATION__";
+/** Read the renderer automation snapshot; null when the surface is absent (production build or pre-boot). */
+declare function readAutomationSnapshot(page: Page): Promise<WoodAutomationSnapshot | null>;
+/** Ask the renderer to wait for app idle; false when unsupported or timed out. */
+declare function waitForRendererIdle(page: Page, options?: {
+    timeoutMs?: number;
+    idleFrames?: number;
+}): Promise<boolean>;
+/** Render a snapshot route as the canonical route string used in receipts. */
+declare function formatRoute(route: WoodAutomationSnapshot['currentRoute']): string | undefined;
+
+export { WOOD_AUTOMATION_GLOBAL_KEY, formatRoute, readAutomationSnapshot, waitForRendererIdle };

package/dist/automation/introspection_reader.d.ts

@@ -0,0 +1,20 @@
+import { Page } from 'playwright';
+import { WoodAutomationSnapshot } from '../navigation/automation_introspection.js';
+
+/**
+ * Node-side reader for the renderer introspection surface (AXE-WP-02).
+ * Counterpart of src/navigation/automation_introspection.ts.
+ */
+
+declare const WOOD_AUTOMATION_GLOBAL_KEY = "__NOEGO_WOOD_AUTOMATION__";
+/** Read the renderer automation snapshot; null when the surface is absent (production build or pre-boot). */
+declare function readAutomationSnapshot(page: Page): Promise<WoodAutomationSnapshot | null>;
+/** Ask the renderer to wait for app idle; false when unsupported or timed out. */
+declare function waitForRendererIdle(page: Page, options?: {
+    timeoutMs?: number;
+    idleFrames?: number;
+}): Promise<boolean>;
+/** Render a snapshot route as the canonical route string used in receipts. */
+declare function formatRoute(route: WoodAutomationSnapshot['currentRoute']): string | undefined;
+
+export { WOOD_AUTOMATION_GLOBAL_KEY, formatRoute, readAutomationSnapshot, waitForRendererIdle };

package/dist/automation/introspection_reader.js

@@ -0,0 +1,48 @@
+const WOOD_AUTOMATION_GLOBAL_KEY = "__NOEGO_WOOD_AUTOMATION__";
+async function readAutomationSnapshot(page) {
+  try {
+    const snapshot = await page.evaluate((key) => {
+      const surface = globalThis[key];
+      if (!surface || surface.version !== 1 || typeof surface.snapshot !== "function") {
+        return null;
+      }
+      return surface.snapshot();
+    }, WOOD_AUTOMATION_GLOBAL_KEY);
+    return snapshot ?? null;
+  } catch {
+    return null;
+  }
+}
+async function waitForRendererIdle(page, options) {
+  try {
+    return await page.evaluate(
+      async ({ key, timeoutMs, idleFrames }) => {
+        const surface = globalThis[key];
+        if (!surface || surface.version !== 1 || typeof surface.waitForIdle !== "function") {
+          return false;
+        }
+        return await surface.waitForIdle({ timeoutMs, idleFrames });
+      },
+      { key: WOOD_AUTOMATION_GLOBAL_KEY, timeoutMs: options?.timeoutMs, idleFrames: options?.idleFrames }
+    );
+  } catch {
+    return false;
+  }
+}
+function formatRoute(route) {
+  if (!route) {
+    return void 0;
+  }
+  const params = Object.entries(route.params);
+  const query = Object.entries(route.query);
+  const paramsPart = params.length ? `(${params.map(([k, v]) => `${k}=${v}`).join(",")})` : "";
+  const queryPart = query.length ? `?${query.map(([k, v]) => `${k}=${v}`).join("&")}` : "";
+  return `${route.page}${paramsPart}${queryPart}`;
+}
+export {
+  WOOD_AUTOMATION_GLOBAL_KEY,
+  formatRoute,
+  readAutomationSnapshot,
+  waitForRendererIdle
+};
+//# sourceMappingURL=introspection_reader.js.map

package/dist/automation/introspection_reader.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/automation/introspection_reader.ts"],"sourcesContent":["/**\n * Node-side reader for the renderer introspection surface (AXE-WP-02).\n * Counterpart of src/navigation/automation_introspection.ts.\n */\n\nimport type { Page } from 'playwright';\nimport type { WoodAutomationSnapshot } from '../navigation/automation_introspection.js';\n\nexport const WOOD_AUTOMATION_GLOBAL_KEY = '__NOEGO_WOOD_AUTOMATION__';\n\n/** Read the renderer automation snapshot; null when the surface is absent (production build or pre-boot). */\nexport async function readAutomationSnapshot(page: Page): Promise<WoodAutomationSnapshot | null> {\n  try {\n    const snapshot = await page.evaluate((key) => {\n      const surface = (globalThis as Record<string, unknown>)[key] as\n        | { version?: number; snapshot?: () => unknown }\n        | undefined;\n      if (!surface || surface.version !== 1 || typeof surface.snapshot !== 'function') {\n        return null;\n      }\n      return surface.snapshot();\n    }, WOOD_AUTOMATION_GLOBAL_KEY);\n    return (snapshot as WoodAutomationSnapshot | null) ?? null;\n  } catch {\n    return null;\n  }\n}\n\n/** Ask the renderer to wait for app idle; false when unsupported or timed out. */\nexport async function waitForRendererIdle(\n  page: Page,\n  options?: { timeoutMs?: number; idleFrames?: number },\n): Promise<boolean> {\n  try {\n    return await page.evaluate(\n      async ({ key, timeoutMs, idleFrames }) => {\n        const surface = (globalThis as Record<string, unknown>)[key] as\n          | { version?: number; waitForIdle?: (o: { timeoutMs?: number; idleFrames?: number }) => Promise<boolean> }\n          | undefined;\n        if (!surface || surface.version !== 1 || typeof surface.waitForIdle !== 'function') {\n          return false;\n        }\n        return await surface.waitForIdle({ timeoutMs, idleFrames });\n      },\n      { key: WOOD_AUTOMATION_GLOBAL_KEY, timeoutMs: options?.timeoutMs, idleFrames: options?.idleFrames },\n    );\n  } catch {\n    return false;\n  }\n}\n\n/** Render a snapshot route as the canonical route string used in receipts. */\nexport function formatRoute(route: WoodAutomationSnapshot['currentRoute']): string | undefined {\n  if (!route) {\n    return undefined;\n  }\n  const params = Object.entries(route.params);\n  const query = Object.entries(route.query);\n  const paramsPart = params.length ? `(${params.map(([k, v]) => `${k}=${v}`).join(',')})` : '';\n  const queryPart = query.length ? `?${query.map(([k, v]) => `${k}=${v}`).join('&')}` : '';\n  return `${route.page}${paramsPart}${queryPart}`;\n}\n"],"mappings":"AAQO,MAAM,6BAA6B;AAG1C,eAAsB,uBAAuB,MAAoD;AAC/F,MAAI;AACF,UAAM,WAAW,MAAM,KAAK,SAAS,CAAC,QAAQ;AAC5C,YAAM,UAAW,WAAuC,GAAG;AAG3D,UAAI,CAAC,WAAW,QAAQ,YAAY,KAAK,OAAO,QAAQ,aAAa,YAAY;AAC/E,eAAO;AAAA,MACT;AACA,aAAO,QAAQ,SAAS;AAAA,IAC1B,GAAG,0BAA0B;AAC7B,WAAQ,YAA8C;AAAA,EACxD,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAGA,eAAsB,oBACpB,MACA,SACkB;AAClB,MAAI;AACF,WAAO,MAAM,KAAK;AAAA,MAChB,OAAO,EAAE,KAAK,WAAW,WAAW,MAAM;AACxC,cAAM,UAAW,WAAuC,GAAG;AAG3D,YAAI,CAAC,WAAW,QAAQ,YAAY,KAAK,OAAO,QAAQ,gBAAgB,YAAY;AAClF,iBAAO;AAAA,QACT;AACA,eAAO,MAAM,QAAQ,YAAY,EAAE,WAAW,WAAW,CAAC;AAAA,MAC5D;AAAA,MACA,EAAE,KAAK,4BAA4B,WAAW,SAAS,WAAW,YAAY,SAAS,WAAW;AAAA,IACpG;AAAA,EACF,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAGO,SAAS,YAAY,OAAmE;AAC7F,MAAI,CAAC,OAAO;AACV,WAAO;AAAA,EACT;AACA,QAAM,SAAS,OAAO,QAAQ,MAAM,MAAM;AAC1C,QAAM,QAAQ,OAAO,QAAQ,MAAM,KAAK;AACxC,QAAM,aAAa,OAAO,SAAS,IAAI,OAAO,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,GAAG,CAAC,MAAM;AAC1F,QAAM,YAAY,MAAM,SAAS,IAAI,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,GAAG,CAAC,KAAK;AACtF,SAAO,GAAG,MAAM,IAAI,GAAG,UAAU,GAAG,SAAS;AAC/C;","names":[]}

package/dist/automation/locator.cjs

@@ -0,0 +1,102 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var locator_exports = {};
+__export(locator_exports, {
+  describeLocator: () => describeLocator,
+  isLowStabilityLocator: () => isLowStabilityLocator,
+  parseCliLocator: () => parseCliLocator,
+  toPlaywrightLocator: () => toPlaywrightLocator
+});
+module.exports = __toCommonJS(locator_exports);
+var import_errors = require("./errors.cjs");
+function isLowStabilityLocator(locator) {
+  return locator.kind === "css";
+}
+function describeLocator(locator) {
+  switch (locator.kind) {
+    case "test_id":
+      return `test_id=${locator.value}`;
+    case "role":
+      return locator.name ? `role=${locator.role} name=${locator.name}` : `role=${locator.role}`;
+    case "label":
+      return `label=${locator.value}`;
+    case "placeholder":
+      return `placeholder=${locator.value}`;
+    case "text":
+      return `text=${locator.value}`;
+    case "css":
+      return `css=${locator.value}`;
+  }
+}
+function toPlaywrightLocator(page, locator) {
+  switch (locator.kind) {
+    case "test_id":
+      return page.getByTestId(locator.value);
+    case "role":
+      return page.getByRole(locator.role, {
+        ...locator.name !== void 0 ? { name: locator.name, exact: locator.exact } : {}
+      });
+    case "label":
+      return page.getByLabel(locator.value, { exact: locator.exact });
+    case "placeholder":
+      return page.getByPlaceholder(locator.value, { exact: locator.exact });
+    case "text":
+      return page.getByText(locator.value, { exact: locator.exact });
+    case "css":
+      return page.locator(locator.value);
+  }
+}
+function parseCliLocator(raw) {
+  const trimmed = raw.trim();
+  if (trimmed.length === 0) {
+    return (0, import_errors.automationError)("LOCATOR_INVALID", "Empty locator.", {
+      requiredAction: "Provide a CSS selector or a kind=value locator."
+    });
+  }
+  const match = /^(test_id|role|label|placeholder|text|css)=(.*)$/s.exec(trimmed);
+  if (!match) {
+    return (0, import_errors.automationOk)({ kind: "css", value: trimmed });
+  }
+  const [, kind, value] = match;
+  if (value.length === 0) {
+    return (0, import_errors.automationError)("LOCATOR_INVALID", `Locator "${kind}=" has no value.`, {
+      requiredAction: `Provide a value after "${kind}=".`
+    });
+  }
+  if (kind === "role") {
+    const separator = value.indexOf(":");
+    if (separator > 0) {
+      return (0, import_errors.automationOk)({
+        kind: "role",
+        role: value.slice(0, separator),
+        name: value.slice(separator + 1)
+      });
+    }
+    return (0, import_errors.automationOk)({ kind: "role", role: value });
+  }
+  return (0, import_errors.automationOk)({ kind, value });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  describeLocator,
+  isLowStabilityLocator,
+  parseCliLocator,
+  toPlaywrightLocator
+});
+//# sourceMappingURL=locator.cjs.map

package/dist/automation/locator.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/automation/locator.ts"],"sourcesContent":["/**\n * Locator model (frozen contract — Axe.md \"Locator model\").\n *\n * Semantic locators are preferred; CSS remains available as an explicit,\n * low-stability escape hatch and is marked as such in receipts.\n */\n\nimport type { Locator, Page } from 'playwright';\nimport { automationError, automationOk, type WoodAutomationResult } from './errors.cjs';\n\nexport type WoodLocator =\n  | { kind: 'test_id'; value: string }\n  | { kind: 'role'; role: string; name?: string; exact?: boolean }\n  | { kind: 'label'; value: string; exact?: boolean }\n  | { kind: 'placeholder'; value: string; exact?: boolean }\n  | { kind: 'text'; value: string; exact?: boolean }\n  | { kind: 'css'; value: string };\n\n/** Locator kinds considered stable for release qualification. */\nexport function isLowStabilityLocator(locator: WoodLocator): boolean {\n  return locator.kind === 'css';\n}\n\n/** Render a locator for diagnostics and receipts (values are not redacted here). */\nexport function describeLocator(locator: WoodLocator): string {\n  switch (locator.kind) {\n    case 'test_id':\n      return `test_id=${locator.value}`;\n    case 'role':\n      return locator.name ? `role=${locator.role} name=${locator.name}` : `role=${locator.role}`;\n    case 'label':\n      return `label=${locator.value}`;\n    case 'placeholder':\n      return `placeholder=${locator.value}`;\n    case 'text':\n      return `text=${locator.value}`;\n    case 'css':\n      return `css=${locator.value}`;\n  }\n}\n\n/**\n * Resolve a WoodLocator to a Playwright locator on a page.\n * Resolution does not assert uniqueness; actionability checks own that.\n */\nexport function toPlaywrightLocator(page: Page, locator: WoodLocator): Locator {\n  switch (locator.kind) {\n    case 'test_id':\n      return page.getByTestId(locator.value);\n    case 'role':\n      // Playwright's role union is wider than our string; the runtime accepts any ARIA role string.\n      return page.getByRole(locator.role as Parameters<Page['getByRole']>[0], {\n        ...(locator.name !== undefined ? { name: locator.name, exact: locator.exact } : {}),\n      });\n    case 'label':\n      return page.getByLabel(locator.value, { exact: locator.exact });\n    case 'placeholder':\n      return page.getByPlaceholder(locator.value, { exact: locator.exact });\n    case 'text':\n      return page.getByText(locator.value, { exact: locator.exact });\n    case 'css':\n      return page.locator(locator.value);\n  }\n}\n\n/**\n * Normalize a raw CLI target argument into a WoodLocator.\n * Bare strings are CSS (current CLI behavior); `kind=value` prefixes select\n * semantic locators: `test_id=`, `role=`, `label=`, `placeholder=`, `text=`, `css=`.\n */\nexport function parseCliLocator(raw: string): WoodAutomationResult<WoodLocator> {\n  const trimmed = raw.trim();\n  if (trimmed.length === 0) {\n    return automationError('LOCATOR_INVALID', 'Empty locator.', {\n      requiredAction: 'Provide a CSS selector or a kind=value locator.',\n    });\n  }\n\n  const match = /^(test_id|role|label|placeholder|text|css)=(.*)$/s.exec(trimmed);\n  if (!match) {\n    return automationOk({ kind: 'css', value: trimmed });\n  }\n\n  const [, kind, value] = match;\n  if (value.length === 0) {\n    return automationError('LOCATOR_INVALID', `Locator \"${kind}=\" has no value.`, {\n      requiredAction: `Provide a value after \"${kind}=\".`,\n    });\n  }\n\n  if (kind === 'role') {\n    // role=button:Save → role + accessible name; role=button → role only.\n    const separator = value.indexOf(':');\n    if (separator > 0) {\n      return automationOk({\n        kind: 'role',\n        role: value.slice(0, separator),\n        name: value.slice(separator + 1),\n      });\n    }\n    return automationOk({ kind: 'role', role: value });\n  }\n\n  return automationOk({ kind, value } as WoodLocator);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAQA,oBAAyE;AAWlE,SAAS,sBAAsB,SAA+B;AACnE,SAAO,QAAQ,SAAS;AAC1B;AAGO,SAAS,gBAAgB,SAA8B;AAC5D,UAAQ,QAAQ,MAAM;AAAA,IACpB,KAAK;AACH,aAAO,WAAW,QAAQ,KAAK;AAAA,IACjC,KAAK;AACH,aAAO,QAAQ,OAAO,QAAQ,QAAQ,IAAI,SAAS,QAAQ,IAAI,KAAK,QAAQ,QAAQ,IAAI;AAAA,IAC1F,KAAK;AACH,aAAO,SAAS,QAAQ,KAAK;AAAA,IAC/B,KAAK;AACH,aAAO,eAAe,QAAQ,KAAK;AAAA,IACrC,KAAK;AACH,aAAO,QAAQ,QAAQ,KAAK;AAAA,IAC9B,KAAK;AACH,aAAO,OAAO,QAAQ,KAAK;AAAA,EAC/B;AACF;AAMO,SAAS,oBAAoB,MAAY,SAA+B;AAC7E,UAAQ,QAAQ,MAAM;AAAA,IACpB,KAAK;AACH,aAAO,KAAK,YAAY,QAAQ,KAAK;AAAA,IACvC,KAAK;AAEH,aAAO,KAAK,UAAU,QAAQ,MAA0C;AAAA,QACtE,GAAI,QAAQ,SAAS,SAAY,EAAE,MAAM,QAAQ,MAAM,OAAO,QAAQ,MAAM,IAAI,CAAC;AAAA,MACnF,CAAC;AAAA,IACH,KAAK;AACH,aAAO,KAAK,WAAW,QAAQ,OAAO,EAAE,OAAO,QAAQ,MAAM,CAAC;AAAA,IAChE,KAAK;AACH,aAAO,KAAK,iBAAiB,QAAQ,OAAO,EAAE,OAAO,QAAQ,MAAM,CAAC;AAAA,IACtE,KAAK;AACH,aAAO,KAAK,UAAU,QAAQ,OAAO,EAAE,OAAO,QAAQ,MAAM,CAAC;AAAA,IAC/D,KAAK;AACH,aAAO,KAAK,QAAQ,QAAQ,KAAK;AAAA,EACrC;AACF;AAOO,SAAS,gBAAgB,KAAgD;AAC9E,QAAM,UAAU,IAAI,KAAK;AACzB,MAAI,QAAQ,WAAW,GAAG;AACxB,eAAO,+BAAgB,mBAAmB,kBAAkB;AAAA,MAC1D,gBAAgB;AAAA,IAClB,CAAC;AAAA,EACH;AAEA,QAAM,QAAQ,oDAAoD,KAAK,OAAO;AAC9E,MAAI,CAAC,OAAO;AACV,eAAO,4BAAa,EAAE,MAAM,OAAO,OAAO,QAAQ,CAAC;AAAA,EACrD;AAEA,QAAM,CAAC,EAAE,MAAM,KAAK,IAAI;AACxB,MAAI,MAAM,WAAW,GAAG;AACtB,eAAO,+BAAgB,mBAAmB,YAAY,IAAI,oBAAoB;AAAA,MAC5E,gBAAgB,0BAA0B,IAAI;AAAA,IAChD,CAAC;AAAA,EACH;AAEA,MAAI,SAAS,QAAQ;AAEnB,UAAM,YAAY,MAAM,QAAQ,GAAG;AACnC,QAAI,YAAY,GAAG;AACjB,iBAAO,4BAAa;AAAA,QAClB,MAAM;AAAA,QACN,MAAM,MAAM,MAAM,GAAG,SAAS;AAAA,QAC9B,MAAM,MAAM,MAAM,YAAY,CAAC;AAAA,MACjC,CAAC;AAAA,IACH;AACA,eAAO,4BAAa,EAAE,MAAM,QAAQ,MAAM,MAAM,CAAC;AAAA,EACnD;AAEA,aAAO,4BAAa,EAAE,MAAM,MAAM,CAAgB;AACpD;","names":[]}

package/dist/automation/locator.d.cts

@@ -0,0 +1,51 @@
+import { Page, Locator } from 'playwright';
+import { WoodAutomationResult } from './errors.cjs';
+
+/**
+ * Locator model (frozen contract — Axe.md "Locator model").
+ *
+ * Semantic locators are preferred; CSS remains available as an explicit,
+ * low-stability escape hatch and is marked as such in receipts.
+ */
+
+type WoodLocator = {
+    kind: 'test_id';
+    value: string;
+} | {
+    kind: 'role';
+    role: string;
+    name?: string;
+    exact?: boolean;
+} | {
+    kind: 'label';
+    value: string;
+    exact?: boolean;
+} | {
+    kind: 'placeholder';
+    value: string;
+    exact?: boolean;
+} | {
+    kind: 'text';
+    value: string;
+    exact?: boolean;
+} | {
+    kind: 'css';
+    value: string;
+};
+/** Locator kinds considered stable for release qualification. */
+declare function isLowStabilityLocator(locator: WoodLocator): boolean;
+/** Render a locator for diagnostics and receipts (values are not redacted here). */
+declare function describeLocator(locator: WoodLocator): string;
+/**
+ * Resolve a WoodLocator to a Playwright locator on a page.
+ * Resolution does not assert uniqueness; actionability checks own that.
+ */
+declare function toPlaywrightLocator(page: Page, locator: WoodLocator): Locator;
+/**
+ * Normalize a raw CLI target argument into a WoodLocator.
+ * Bare strings are CSS (current CLI behavior); `kind=value` prefixes select
+ * semantic locators: `test_id=`, `role=`, `label=`, `placeholder=`, `text=`, `css=`.
+ */
+declare function parseCliLocator(raw: string): WoodAutomationResult<WoodLocator>;
+
+export { type WoodLocator, describeLocator, isLowStabilityLocator, parseCliLocator, toPlaywrightLocator };

package/dist/automation/locator.d.ts

@@ -0,0 +1,51 @@
+import { Page, Locator } from 'playwright';
+import { WoodAutomationResult } from './errors.js';
+
+/**
+ * Locator model (frozen contract — Axe.md "Locator model").
+ *
+ * Semantic locators are preferred; CSS remains available as an explicit,
+ * low-stability escape hatch and is marked as such in receipts.
+ */
+
+type WoodLocator = {
+    kind: 'test_id';
+    value: string;
+} | {
+    kind: 'role';
+    role: string;
+    name?: string;
+    exact?: boolean;
+} | {
+    kind: 'label';
+    value: string;
+    exact?: boolean;
+} | {
+    kind: 'placeholder';
+    value: string;
+    exact?: boolean;
+} | {
+    kind: 'text';
+    value: string;
+    exact?: boolean;
+} | {
+    kind: 'css';
+    value: string;
+};
+/** Locator kinds considered stable for release qualification. */
+declare function isLowStabilityLocator(locator: WoodLocator): boolean;
+/** Render a locator for diagnostics and receipts (values are not redacted here). */
+declare function describeLocator(locator: WoodLocator): string;
+/**
+ * Resolve a WoodLocator to a Playwright locator on a page.
+ * Resolution does not assert uniqueness; actionability checks own that.
+ */
+declare function toPlaywrightLocator(page: Page, locator: WoodLocator): Locator;
+/**
+ * Normalize a raw CLI target argument into a WoodLocator.
+ * Bare strings are CSS (current CLI behavior); `kind=value` prefixes select
+ * semantic locators: `test_id=`, `role=`, `label=`, `placeholder=`, `text=`, `css=`.
+ */
+declare function parseCliLocator(raw: string): WoodAutomationResult<WoodLocator>;
+
+export { type WoodLocator, describeLocator, isLowStabilityLocator, parseCliLocator, toPlaywrightLocator };

package/dist/automation/locator.js

@@ -0,0 +1,75 @@
+import { automationError, automationOk } from "./errors.js";
+function isLowStabilityLocator(locator) {
+  return locator.kind === "css";
+}
+function describeLocator(locator) {
+  switch (locator.kind) {
+    case "test_id":
+      return `test_id=${locator.value}`;
+    case "role":
+      return locator.name ? `role=${locator.role} name=${locator.name}` : `role=${locator.role}`;
+    case "label":
+      return `label=${locator.value}`;
+    case "placeholder":
+      return `placeholder=${locator.value}`;
+    case "text":
+      return `text=${locator.value}`;
+    case "css":
+      return `css=${locator.value}`;
+  }
+}
+function toPlaywrightLocator(page, locator) {
+  switch (locator.kind) {
+    case "test_id":
+      return page.getByTestId(locator.value);
+    case "role":
+      return page.getByRole(locator.role, {
+        ...locator.name !== void 0 ? { name: locator.name, exact: locator.exact } : {}
+      });
+    case "label":
+      return page.getByLabel(locator.value, { exact: locator.exact });
+    case "placeholder":
+      return page.getByPlaceholder(locator.value, { exact: locator.exact });
+    case "text":
+      return page.getByText(locator.value, { exact: locator.exact });
+    case "css":
+      return page.locator(locator.value);
+  }
+}
+function parseCliLocator(raw) {
+  const trimmed = raw.trim();
+  if (trimmed.length === 0) {
+    return automationError("LOCATOR_INVALID", "Empty locator.", {
+      requiredAction: "Provide a CSS selector or a kind=value locator."
+    });
+  }
+  const match = /^(test_id|role|label|placeholder|text|css)=(.*)$/s.exec(trimmed);
+  if (!match) {
+    return automationOk({ kind: "css", value: trimmed });
+  }
+  const [, kind, value] = match;
+  if (value.length === 0) {
+    return automationError("LOCATOR_INVALID", `Locator "${kind}=" has no value.`, {
+      requiredAction: `Provide a value after "${kind}=".`
+    });
+  }
+  if (kind === "role") {
+    const separator = value.indexOf(":");
+    if (separator > 0) {
+      return automationOk({
+        kind: "role",
+        role: value.slice(0, separator),
+        name: value.slice(separator + 1)
+      });
+    }
+    return automationOk({ kind: "role", role: value });
+  }
+  return automationOk({ kind, value });
+}
+export {
+  describeLocator,
+  isLowStabilityLocator,
+  parseCliLocator,
+  toPlaywrightLocator
+};
+//# sourceMappingURL=locator.js.map

package/dist/automation/locator.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/automation/locator.ts"],"sourcesContent":["/**\n * Locator model (frozen contract — Axe.md \"Locator model\").\n *\n * Semantic locators are preferred; CSS remains available as an explicit,\n * low-stability escape hatch and is marked as such in receipts.\n */\n\nimport type { Locator, Page } from 'playwright';\nimport { automationError, automationOk, type WoodAutomationResult } from './errors.js';\n\nexport type WoodLocator =\n  | { kind: 'test_id'; value: string }\n  | { kind: 'role'; role: string; name?: string; exact?: boolean }\n  | { kind: 'label'; value: string; exact?: boolean }\n  | { kind: 'placeholder'; value: string; exact?: boolean }\n  | { kind: 'text'; value: string; exact?: boolean }\n  | { kind: 'css'; value: string };\n\n/** Locator kinds considered stable for release qualification. */\nexport function isLowStabilityLocator(locator: WoodLocator): boolean {\n  return locator.kind === 'css';\n}\n\n/** Render a locator for diagnostics and receipts (values are not redacted here). */\nexport function describeLocator(locator: WoodLocator): string {\n  switch (locator.kind) {\n    case 'test_id':\n      return `test_id=${locator.value}`;\n    case 'role':\n      return locator.name ? `role=${locator.role} name=${locator.name}` : `role=${locator.role}`;\n    case 'label':\n      return `label=${locator.value}`;\n    case 'placeholder':\n      return `placeholder=${locator.value}`;\n    case 'text':\n      return `text=${locator.value}`;\n    case 'css':\n      return `css=${locator.value}`;\n  }\n}\n\n/**\n * Resolve a WoodLocator to a Playwright locator on a page.\n * Resolution does not assert uniqueness; actionability checks own that.\n */\nexport function toPlaywrightLocator(page: Page, locator: WoodLocator): Locator {\n  switch (locator.kind) {\n    case 'test_id':\n      return page.getByTestId(locator.value);\n    case 'role':\n      // Playwright's role union is wider than our string; the runtime accepts any ARIA role string.\n      return page.getByRole(locator.role as Parameters<Page['getByRole']>[0], {\n        ...(locator.name !== undefined ? { name: locator.name, exact: locator.exact } : {}),\n      });\n    case 'label':\n      return page.getByLabel(locator.value, { exact: locator.exact });\n    case 'placeholder':\n      return page.getByPlaceholder(locator.value, { exact: locator.exact });\n    case 'text':\n      return page.getByText(locator.value, { exact: locator.exact });\n    case 'css':\n      return page.locator(locator.value);\n  }\n}\n\n/**\n * Normalize a raw CLI target argument into a WoodLocator.\n * Bare strings are CSS (current CLI behavior); `kind=value` prefixes select\n * semantic locators: `test_id=`, `role=`, `label=`, `placeholder=`, `text=`, `css=`.\n */\nexport function parseCliLocator(raw: string): WoodAutomationResult<WoodLocator> {\n  const trimmed = raw.trim();\n  if (trimmed.length === 0) {\n    return automationError('LOCATOR_INVALID', 'Empty locator.', {\n      requiredAction: 'Provide a CSS selector or a kind=value locator.',\n    });\n  }\n\n  const match = /^(test_id|role|label|placeholder|text|css)=(.*)$/s.exec(trimmed);\n  if (!match) {\n    return automationOk({ kind: 'css', value: trimmed });\n  }\n\n  const [, kind, value] = match;\n  if (value.length === 0) {\n    return automationError('LOCATOR_INVALID', `Locator \"${kind}=\" has no value.`, {\n      requiredAction: `Provide a value after \"${kind}=\".`,\n    });\n  }\n\n  if (kind === 'role') {\n    // role=button:Save → role + accessible name; role=button → role only.\n    const separator = value.indexOf(':');\n    if (separator > 0) {\n      return automationOk({\n        kind: 'role',\n        role: value.slice(0, separator),\n        name: value.slice(separator + 1),\n      });\n    }\n    return automationOk({ kind: 'role', role: value });\n  }\n\n  return automationOk({ kind, value } as WoodLocator);\n}\n"],"mappings":"AAQA,SAAS,iBAAiB,oBAA+C;AAWlE,SAAS,sBAAsB,SAA+B;AACnE,SAAO,QAAQ,SAAS;AAC1B;AAGO,SAAS,gBAAgB,SAA8B;AAC5D,UAAQ,QAAQ,MAAM;AAAA,IACpB,KAAK;AACH,aAAO,WAAW,QAAQ,KAAK;AAAA,IACjC,KAAK;AACH,aAAO,QAAQ,OAAO,QAAQ,QAAQ,IAAI,SAAS,QAAQ,IAAI,KAAK,QAAQ,QAAQ,IAAI;AAAA,IAC1F,KAAK;AACH,aAAO,SAAS,QAAQ,KAAK;AAAA,IAC/B,KAAK;AACH,aAAO,eAAe,QAAQ,KAAK;AAAA,IACrC,KAAK;AACH,aAAO,QAAQ,QAAQ,KAAK;AAAA,IAC9B,KAAK;AACH,aAAO,OAAO,QAAQ,KAAK;AAAA,EAC/B;AACF;AAMO,SAAS,oBAAoB,MAAY,SAA+B;AAC7E,UAAQ,QAAQ,MAAM;AAAA,IACpB,KAAK;AACH,aAAO,KAAK,YAAY,QAAQ,KAAK;AAAA,IACvC,KAAK;AAEH,aAAO,KAAK,UAAU,QAAQ,MAA0C;AAAA,QACtE,GAAI,QAAQ,SAAS,SAAY,EAAE,MAAM,QAAQ,MAAM,OAAO,QAAQ,MAAM,IAAI,CAAC;AAAA,MACnF,CAAC;AAAA,IACH,KAAK;AACH,aAAO,KAAK,WAAW,QAAQ,OAAO,EAAE,OAAO,QAAQ,MAAM,CAAC;AAAA,IAChE,KAAK;AACH,aAAO,KAAK,iBAAiB,QAAQ,OAAO,EAAE,OAAO,QAAQ,MAAM,CAAC;AAAA,IACtE,KAAK;AACH,aAAO,KAAK,UAAU,QAAQ,OAAO,EAAE,OAAO,QAAQ,MAAM,CAAC;AAAA,IAC/D,KAAK;AACH,aAAO,KAAK,QAAQ,QAAQ,KAAK;AAAA,EACrC;AACF;AAOO,SAAS,gBAAgB,KAAgD;AAC9E,QAAM,UAAU,IAAI,KAAK;AACzB,MAAI,QAAQ,WAAW,GAAG;AACxB,WAAO,gBAAgB,mBAAmB,kBAAkB;AAAA,MAC1D,gBAAgB;AAAA,IAClB,CAAC;AAAA,EACH;AAEA,QAAM,QAAQ,oDAAoD,KAAK,OAAO;AAC9E,MAAI,CAAC,OAAO;AACV,WAAO,aAAa,EAAE,MAAM,OAAO,OAAO,QAAQ,CAAC;AAAA,EACrD;AAEA,QAAM,CAAC,EAAE,MAAM,KAAK,IAAI;AACxB,MAAI,MAAM,WAAW,GAAG;AACtB,WAAO,gBAAgB,mBAAmB,YAAY,IAAI,oBAAoB;AAAA,MAC5E,gBAAgB,0BAA0B,IAAI;AAAA,IAChD,CAAC;AAAA,EACH;AAEA,MAAI,SAAS,QAAQ;AAEnB,UAAM,YAAY,MAAM,QAAQ,GAAG;AACnC,QAAI,YAAY,GAAG;AACjB,aAAO,aAAa;AAAA,QAClB,MAAM;AAAA,QACN,MAAM,MAAM,MAAM,GAAG,SAAS;AAAA,QAC9B,MAAM,MAAM,MAAM,YAAY,CAAC;AAAA,MACjC,CAAC;AAAA,IACH;AACA,WAAO,aAAa,EAAE,MAAM,QAAQ,MAAM,MAAM,CAAC;AAAA,EACnD;AAEA,SAAO,aAAa,EAAE,MAAM,MAAM,CAAgB;AACpD;","names":[]}

package/dist/{loader/__fixtures__/views/test/page.load.cjs → automation/observation.cjs}

@@ -3,10 +3,6 @@ var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
 var __copyProps = (to, from, except, desc) => {
   if (from && typeof from === "object" || typeof from === "function") {
     for (let key of __getOwnPropNames(from))
@@ -16,12 +12,6 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var page_load_exports = {};
-__export(page_load_exports, {
-  default: () => load
-});
-module.exports = __toCommonJS(page_load_exports);
-async function load(request) {
-  return { testData: "hello", url: request.url };
-}
-//# sourceMappingURL=page.load.cjs.map
+var observation_exports = {};
+module.exports = __toCommonJS(observation_exports);
+//# sourceMappingURL=observation.cjs.map

package/dist/automation/observation.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/automation/observation.ts"],"sourcesContent":["/**\n * Bounded observation model (frozen — Axe.md \"Observation and evidence\").\n * Capture lands in AXE-WP-02; the type contract is frozen now so the CLI,\n * harness, and scenario runner converge on one shape.\n */\n\nimport type { WoodLiveTarget } from './target_identity.cjs';\nimport type { WoodScrollMetrics } from './scrolling.cjs';\n\nexport interface WoodConsoleEntry {\n  type: 'console_error' | 'page_error' | 'request_failed';\n  message: string;\n  occurredAt: string;\n}\n\nexport interface WoodObservation {\n  target: WoodLiveTarget;\n  route: {\n    page: string;\n    params: Record<string, string>;\n    query: Record<string, string>;\n  } | null;\n  title: string;\n  url: string;\n  viewport: { width: number; height: number; deviceScaleFactor: number } | null;\n  focusedElement: string | null;\n  documentGeneration: number;\n  scrollRoots: Array<{ name: string; metrics: WoodScrollMetrics }>;\n  recentErrors: WoodConsoleEntry[];\n  traceCursor?: string;\n  screenshotPath?: string;\n  capturedAt: string;\n}\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}