state-scenarios 0.2.0 → 0.3.0

package/dist/adapters/redux.js

@@ -1,9 +1,9 @@
 import {
   deepMerge
-} from "../chunk-KDH572NI.js";
+} from "../chunk-KYU7RUWI.js";
 import {
   parseJson
-} from "../chunk-6L55WKFS.js";
+} from "../chunk-DCURPYW5.js";
 
 // src/adapters/redux.ts
 var SCENARIO_HYDRATE = "@@scenarios/hydrate";

package/dist/adapters/tanstack-query.js

@@ -1,7 +1,7 @@
 import {
   JsonSchema,
   parseJson
-} from "../chunk-6L55WKFS.js";
+} from "../chunk-DCURPYW5.js";
 
 // src/adapters/tanstack-query.ts
 import { z } from "zod";

package/dist/adapters/xstate.js

@@ -1,9 +1,9 @@
 import {
   deepMerge
-} from "../chunk-KDH572NI.js";
+} from "../chunk-KYU7RUWI.js";
 import {
   JsonSchema
-} from "../chunk-6L55WKFS.js";
+} from "../chunk-DCURPYW5.js";
 
 // src/adapters/xstate.ts
 import { z } from "zod";

package/dist/adapters/zustand.js

@@ -1,6 +1,6 @@
 import {
   parseJson
-} from "../chunk-6L55WKFS.js";
+} from "../chunk-DCURPYW5.js";
 
 // src/adapters/zustand.ts
 var zustandAdapter = (store, { key = "zustand", schema }) => ({

package/dist/capture.d.ts

@@ -0,0 +1,26 @@
+import type { ScenarioSession } from './runtime.js';
+import { type Scenario, type ScenarioInput } from './schema.js';
+export interface CaptureOptions {
+    name: string;
+    description?: string;
+    /** Playwright selector that marks this UI state ready. */
+    ready?: string;
+    /**
+     * Catalog scenario to `extends`. Diff uses its resolved (flattened) form.
+     * Omit for a full self-contained snapshot.
+     */
+    base?: Scenario;
+    /** Relative `$schema` path stamped on the catalog file only, e.g. `../scenario.schema.json`. */
+    schemaPath?: string;
+}
+export interface CapturedScenario {
+    /** Flattened snapshot for inline share links. */
+    flat: Scenario;
+    /** File to commit: diffs against `base` when set, otherwise the flat snapshot as input. */
+    forCatalog: ScenarioInput;
+}
+/**
+ * Snapshot what the app shows now: current route and URL params, the active network
+ * fixtures (plus recorded responses), and every connected adapter's live state.
+ */
+export declare function captureScenario(session: ScenarioSession, options: CaptureOptions): CapturedScenario;

package/dist/catalog.d.ts

@@ -19,3 +19,9 @@ export declare function createCatalog(raw: ScenarioInput[], { rules }?: {
 }): Catalog;
 /** Objects merge recursively, `null` deletes a key, anything else replaces. */
 export declare function deepMerge(base: Json | undefined, over: Json): Json;
+/**
+ * Inverse of `extends` merge: overrides that turn a resolved `base` into `captured`.
+ * Pass the flattened base (from `catalog.resolve`). Copy-link keeps `captured` as-is;
+ * Download JSON uses this so the file can `extends` the base instead of repeating it.
+ */
+export declare function diffScenario(captured: Scenario, base?: Scenario): ScenarioInput;

package/dist/{chunk-KRCYO64S.js → chunk-3M6SD4TA.js}

@@ -1,6 +1,8 @@
 // src/link.ts
 var PARAM = "scenario";
 var STRICT_PARAM = "scenario-strict";
+var RECORD_PARAM = "scenario-record";
+var SAVE_ENDPOINT = "/__state-scenarios/save";
 var DATA_KEY = "scenario-data";
 function scenarioHref(resolved, { base = location.href, inline = false, strict = false } = {}) {
   const url = new URL(base);
@@ -24,8 +26,10 @@ var readInline = (hash) => new URLSearchParams(hash.slice(1)).get(DATA_KEY);
 export {
   PARAM,
   STRICT_PARAM,
+  RECORD_PARAM,
+  SAVE_ENDPOINT,
   DATA_KEY,
   scenarioHref,
   readInline
 };
-//# sourceMappingURL=chunk-KRCYO64S.js.map
+//# sourceMappingURL=chunk-3M6SD4TA.js.map

package/dist/chunk-3M6SD4TA.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/link.ts"],"sourcesContent":["import type { Scenario } from './schema.js';\n\ndeclare global {\n  /** Requests the active scenario didn't cover, for tests and agents (see `unhandledRequests`). */\n  var stateScenariosUnhandled: string[] | undefined;\n}\n\nexport const PARAM = 'scenario';\n\n/** Fail unmatched requests instead of letting them reach the network. */\nexport const STRICT_PARAM = 'scenario-strict';\n\n/** Record real responses so they can be saved as a scenario. */\nexport const RECORD_PARAM = 'scenario-record';\n\n/** Dev-server route the `state-scenarios/vite` plugin serves for the panel's \"Save to project\". */\nexport const SAVE_ENDPOINT = '/__state-scenarios/save';\n\n/** Inline scenario JSON, kept in the URL hash so it never reaches a server. */\nexport const DATA_KEY = 'scenario-data';\n\n/**\n * A shareable URL that opens the app in a resolved scenario.\n * `inline` embeds the flattened scenario, so the link works without the catalog.\n */\nexport function scenarioHref(\n  resolved: Scenario,\n  { base = location.href, inline = false, strict = false } = {},\n): string {\n  const url = new URL(base);\n  url.search = '';\n  url.hash = '';\n\n  if (resolved.path) url.pathname = resolved.path;\n\n  for (const [k, v] of Object.entries(resolved.url ?? {})) {\n    if (v !== null) url.searchParams.set(k, v);\n  }\n\n  if (inline) {\n    const { $schema: _schema, extends: _extends, ...snapshot } = resolved;\n    url.hash = new URLSearchParams({ [DATA_KEY]: JSON.stringify(snapshot) }).toString();\n  } else {\n    url.searchParams.set(PARAM, resolved.name);\n  }\n\n  if (strict) url.searchParams.set(STRICT_PARAM, '');\n\n  return url.toString();\n}\n\n/** Inline scenario JSON from a URL hash, if present. */\nexport const readInline = (hash: string) => new URLSearchParams(hash.slice(1)).get(DATA_KEY);\n"],"mappings":";AAOO,IAAM,QAAQ;AAGd,IAAM,eAAe;AAGrB,IAAM,eAAe;AAGrB,IAAM,gBAAgB;AAGtB,IAAM,WAAW;AAMjB,SAAS,aACd,UACA,EAAE,OAAO,SAAS,MAAM,SAAS,OAAO,SAAS,MAAM,IAAI,CAAC,GACpD;AACR,QAAM,MAAM,IAAI,IAAI,IAAI;AACxB,MAAI,SAAS;AACb,MAAI,OAAO;AAEX,MAAI,SAAS,KAAM,KAAI,WAAW,SAAS;AAE3C,aAAW,CAAC,GAAG,CAAC,KAAK,OAAO,QAAQ,SAAS,OAAO,CAAC,CAAC,GAAG;AACvD,QAAI,MAAM,KAAM,KAAI,aAAa,IAAI,GAAG,CAAC;AAAA,EAC3C;AAEA,MAAI,QAAQ;AACV,UAAM,EAAE,SAAS,SAAS,SAAS,UAAU,GAAG,SAAS,IAAI;AAC7D,QAAI,OAAO,IAAI,gBAAgB,EAAE,CAAC,QAAQ,GAAG,KAAK,UAAU,QAAQ,EAAE,CAAC,EAAE,SAAS;AAAA,EACpF,OAAO;AACL,QAAI,aAAa,IAAI,OAAO,SAAS,IAAI;AAAA,EAC3C;AAEA,MAAI,OAAQ,KAAI,aAAa,IAAI,cAAc,EAAE;AAEjD,SAAO,IAAI,SAAS;AACtB;AAGO,IAAM,aAAa,CAAC,SAAiB,IAAI,gBAAgB,KAAK,MAAM,CAAC,CAAC,EAAE,IAAI,QAAQ;","names":[]}

package/dist/{chunk-6L55WKFS.js → chunk-DCURPYW5.js}

@@ -2,6 +2,7 @@
 import { z } from "zod";
 var JsonSchema = z.json();
 var parseJson = (text) => JsonSchema.parse(JSON.parse(text));
+var MethodSchema = z.enum(["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]);
 var ResponseSchema = z.object({
   status: z.number().int().default(200),
   /** Sent as JSON. */
@@ -15,7 +16,7 @@ var ResponseSchema = z.object({
   message: 'Provide "body" (JSON) or "text", not both'
 });
 var NetworkEntrySchema = z.object({
-  method: z.enum(["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]).default("GET"),
+  method: MethodSchema.default("GET"),
   /** MSW path syntax: "/api/users/:id", absolute URLs and wildcards work. */
   path: z.string().min(1),
   /** Only match requests whose query string contains these values. */
@@ -82,8 +83,9 @@ ${z.prettifyError(result.error)}`);
 export {
   JsonSchema,
   parseJson,
+  MethodSchema,
   ScenarioSchema,
   scenarioJsonSchema,
   parseScenario
 };
-//# sourceMappingURL=chunk-6L55WKFS.js.map
+//# sourceMappingURL=chunk-DCURPYW5.js.map

package/dist/chunk-DCURPYW5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schema.ts"],"sourcesContent":["import { z } from 'zod';\n\n/** Scenarios live in JSON files and URLs, so everything they carry is JSON. */\nexport const JsonSchema = z.json();\n\nexport type Json = z.output<typeof JsonSchema>;\n\nexport type JsonObject = { [key: string]: Json; };\n\n/** Anything an app can hand over to be stored as JSON. */\nexport type Serializable = object | string | number | boolean | null;\n\n/**\n * Decode JSON text. Pair with `JSON.stringify` to copy app state into the format scenarios\n * are stored in: functions and undefined drop out, and the result is checked to be JSON.\n */\nexport const parseJson = (text: string): Json => JsonSchema.parse(JSON.parse(text));\n\nexport const MethodSchema = z.enum(['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'HEAD', 'OPTIONS']);\n\nconst ResponseSchema = z\n  .object({\n    status: z.number().int().default(200),\n    /** Sent as JSON. */\n    body: JsonSchema.optional(),\n    /** Sent as text, e.g. an HTML error page. */\n    text: z.string().optional(),\n    headers: z.record(z.string(), z.string()).optional(),\n    /** Milliseconds, or \"infinite\" to hold the request open (loading states). */\n    delay: z.union([z.number().nonnegative(), z.literal('infinite')]).optional(),\n  })\n  .refine((r) => r.body === undefined || r.text === undefined, {\n    message: 'Provide \"body\" (JSON) or \"text\", not both',\n  });\n\nconst NetworkEntrySchema = z\n  .object({\n    method: MethodSchema.default('GET'),\n    /** MSW path syntax: \"/api/users/:id\", absolute URLs and wildcards work. */\n    path: z.string().min(1),\n    /** Only match requests whose query string contains these values. */\n    query: z.record(z.string(), z.string()).optional(),\n    response: ResponseSchema.optional(),\n    /** Successive responses for successive calls; the last one repeats. */\n    sequence: z.array(ResponseSchema).min(1).optional(),\n    /** Drop the inherited entry with the same method, path and query. */\n    remove: z.literal(true).optional(),\n  })\n  .refine((e) => [e.response, e.sequence, e.remove].filter(Boolean).length === 1, {\n    message: 'Provide exactly one of \"response\", \"sequence\" or \"remove\"',\n  });\n\nexport const ScenarioSchema = z.object({\n  $schema: z.string().optional(),\n  // Kebab-case; a combined scenario is named by its parts, e.g. \"signed-in,server-error\".\n  name: z.string().regex(/^[a-z0-9][a-z0-9-]*(,[a-z0-9][a-z0-9-]*)*$/, 'Use kebab-case, e.g. \"empty-search\"'),\n  /** Not inherited. */\n  description: z.string().optional(),\n  /** Not inherited. */\n  tags: z.array(z.string()).optional(),\n  /** Scenario name(s) to build on. Later parents override earlier ones. */\n  extends: z.union([z.string(), z.array(z.string())]).optional(),\n  /** App route the scenario opens at, e.g. \"/orders/42\". Used by links, the panel, `shoot` and `openInlineScenario`. */\n  path: z.string().startsWith('/').optional(),\n  /** Query params the app should start with. null removes an inherited param. */\n  url: z.record(z.string(), z.string().nullable()).optional(),\n  /**\n   * A child entry replaces the inherited entry with the same method, path and query.\n   * Otherwise earlier entries win, and a scenario's own entries come before its parents'.\n   */\n  network: z.array(NetworkEntrySchema).optional(),\n  /** Per-adapter state, keyed by adapter key. Objects deep-merge; null removes a key. */\n  state: z.record(z.string(), JsonSchema).optional(),\n  /**\n   * Playwright selector that is visible once the UI shows this state,\n   * e.g. \"text=Loading countries…\". Not inherited: each state looks different.\n   */\n  ready: z.string().optional(),\n});\n\nexport type Scenario = z.output<typeof ScenarioSchema>;\n\nexport type ScenarioInput = z.input<typeof ScenarioSchema>;\n\nexport type NetworkEntry = z.output<typeof NetworkEntrySchema>;\n\nexport type ScenarioResponse = z.output<typeof ResponseSchema>;\n\n/**\n * JSON Schema for editors, validators and AI generators.\n * Pass adapter state schemas so `state` is described too.\n */\nexport function scenarioJsonSchema({ state = {} }: { state?: Record<string, z.ZodType>; } = {}) {\n  return z.toJSONSchema(\n    ScenarioSchema.extend({ state: z.object(state).partial().catchall(JsonSchema).optional() }),\n    {\n      io: 'input',\n      // Refinements aren't representable in JSON Schema; spell the exclusivity rules out.\n      override: ({ zodSchema, jsonSchema }) => {\n        if (zodSchema === NetworkEntrySchema) {\n          jsonSchema.oneOf = ['response', 'sequence', 'remove'].map((key) => ({ required: [key] }));\n        }\n\n        if (zodSchema === ResponseSchema) {\n          jsonSchema.not = { required: ['body', 'text'] };\n        }\n      },\n    },\n  );\n}\n\n/** Validate scenario input (from a file, URL or editor) into a Scenario, with readable errors. */\nexport function parseScenario(data: ScenarioInput, source = 'scenario'): Scenario {\n  const result = ScenarioSchema.safeParse(data);\n\n  if (result.success) return result.data;\n  throw new Error(`Invalid scenario \"${data.name || source}\":\\n${z.prettifyError(result.error)}`);\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-FTWYRB6F.js

@@ -0,0 +1,277 @@
+import {
+  PARAM,
+  RECORD_PARAM,
+  STRICT_PARAM
+} from "./chunk-3M6SD4TA.js";
+import {
+  diffScenario
+} from "./chunk-KYU7RUWI.js";
+import {
+  parseScenario
+} from "./chunk-DCURPYW5.js";
+
+// src/capture.ts
+var SCENARIO_PARAMS = /* @__PURE__ */ new Set([PARAM, STRICT_PARAM, RECORD_PARAM]);
+function captureScenario(session, options) {
+  const url = {};
+  new URLSearchParams(location.search).forEach((v, k) => {
+    if (!SCENARIO_PARAMS.has(k)) url[k] = v;
+  });
+  const state = Object.fromEntries(
+    session.keys().flatMap((key) => {
+      const value = session.read(key);
+      return value === void 0 ? [] : [[key, value]];
+    })
+  );
+  const network = [...session.resolved?.network ?? [], ...session.recorded()];
+  const draft = parseScenario({
+    name: options.name,
+    description: options.description || void 0,
+    path: location.pathname,
+    url,
+    network: network.length ? network : void 0,
+    state,
+    ready: options.ready || void 0
+  });
+  const flat = session.catalog.resolve(draft);
+  const flatBase = options.base ? session.catalog.resolve(options.base) : void 0;
+  const forCatalog = diffScenario(flat, flatBase);
+  if (options.schemaPath) forCatalog.$schema = options.schemaPath;
+  return { flat, forCatalog };
+}
+
+// src/ready.ts
+var SKIP = /* @__PURE__ */ new Set(["SCRIPT", "STYLE", "NOSCRIPT", "META", "LINK", "HEAD", "HTML"]);
+var MAX_TEXT = 60;
+var CHROME = "header, nav, aside, footer, [role=banner], [role=navigation], [role=complementary], [role=contentinfo]";
+var NAME_FROM_CONTENT = /* @__PURE__ */ new Set([
+  "button",
+  "cell",
+  "checkbox",
+  "columnheader",
+  "gridcell",
+  "heading",
+  "link",
+  "menuitem",
+  "menuitemcheckbox",
+  "menuitemradio",
+  "option",
+  "radio",
+  "row",
+  "rowheader",
+  "switch",
+  "tab",
+  "tooltip",
+  "treeitem"
+]);
+var IMPLICIT_ROLES = /* @__PURE__ */ new Set([
+  "button",
+  "link",
+  "heading",
+  "img",
+  "textbox",
+  "searchbox",
+  "checkbox",
+  "radio",
+  "combobox"
+]);
+function selectorForElement(el) {
+  if (!(el instanceof Element) || SKIP.has(el.tagName) || el.closest("scenario-panel")) {
+    return void 0;
+  }
+  for (const attr of ["data-testid", "data-test-id"]) {
+    const testId = el.getAttribute(attr);
+    if (testId) return `[${attr}=${JSON.stringify(testId)}]`;
+  }
+  const role = roleOf(el);
+  const name = role && accessibleName(el, role);
+  if (role && name && name.length <= MAX_TEXT) {
+    return `role=${role}[name=${JSON.stringify(name)}]`;
+  }
+  const text = ownText(el);
+  if (text && text.length <= MAX_TEXT) {
+    const selector = `text=${JSON.stringify(text)}`;
+    const check = checkReadySelector(selector, el.ownerDocument);
+    if (check.status === "match" && check.count === 1) return selector;
+  }
+  if (role) return `role=${role}`;
+  return void 0;
+}
+function closestReadySelector(el) {
+  for (let node = el; node && node !== node.ownerDocument.body; node = node.parentElement) {
+    const selector = selectorForElement(node);
+    if (selector) return { element: node, selector };
+  }
+  return void 0;
+}
+function suggestReadySelectors(root, { limit = 3 } = {}) {
+  const target = root ?? globalThis.document?.body;
+  if (!target) return [];
+  const ranked = [];
+  const seen = /* @__PURE__ */ new Set();
+  const walk = (node) => {
+    if (SKIP.has(node.tagName) || node.localName === "scenario-panel" || !isVisible(node)) return;
+    const selector = selectorForElement(node);
+    const tooShort = selector?.startsWith("text=") && selector.length < 'text=""'.length + 3;
+    if (selector && !tooShort && !seen.has(selector)) {
+      seen.add(selector);
+      ranked.push({ score: scoreSelector(selector, node), selector });
+    }
+    for (const child of node.children) walk(child);
+  };
+  if (target instanceof Element) walk(target);
+  else for (const child of target.children) walk(child);
+  return ranked.toSorted((a, b) => b.score - a.score).slice(0, limit).map((r) => r.selector);
+}
+function checkReadySelector(selector, doc = document) {
+  const s = selector.trim();
+  if (!s || s.includes(">>")) return { status: "unchecked" };
+  const found = s.startsWith("text=") ? matchText(s.slice(5), doc) : s.startsWith("role=") ? matchRole(s.slice(5), doc) : s.startsWith("css=") || !/^[a-z-]+=/i.test(s) ? matchCss(s.replace(/^css=/, ""), doc) : void 0;
+  if (!found) return { status: "unchecked" };
+  if ("error" in found) return { status: "invalid", error: found.error };
+  const [first] = found;
+  return first ? { status: "match", count: found.length, first, visible: isShown(first) } : { status: "none" };
+}
+function matchText(body, doc) {
+  const quoted = unquote(body);
+  if (quoted !== void 0) {
+    return appElements(doc).filter(
+      (el) => [...el.childNodes].some(
+        (n) => n.nodeType === Node.TEXT_NODE && collapse(n.textContent ?? "") === quoted
+      )
+    );
+  }
+  if (body.startsWith("/")) return void 0;
+  const needle = collapse(body).toLowerCase();
+  if (!needle) return void 0;
+  const has = (el) => collapse(el.textContent ?? "").toLowerCase().includes(needle);
+  return appElements(doc).filter((el) => has(el) && ![...el.children].some(has));
+}
+function matchRole(body, doc) {
+  const m = /^([a-z]+)(?:\[name=(".*")\])?$/.exec(body);
+  if (!m) return void 0;
+  const [, role, rawName] = m;
+  const name = rawName === void 0 ? void 0 : unquote(rawName);
+  if (rawName !== void 0 && name === void 0) return void 0;
+  const found = appElements(doc).filter(
+    (el) => roleOf(el) === role && isShown(el) && !el.closest("[aria-hidden=true]") && (name === void 0 || accessibleName(el, role) === name)
+  );
+  if (!found.length && !IMPLICIT_ROLES.has(role)) return void 0;
+  return found;
+}
+function matchCss(css, doc) {
+  try {
+    return [...doc.querySelectorAll(css)].filter((el) => !el.closest("scenario-panel"));
+  } catch {
+    return { error: "Not a valid CSS selector" };
+  }
+}
+function unquote(s) {
+  if (!s.startsWith('"') || !s.endsWith('"') || s.length < 2) return void 0;
+  try {
+    return JSON.parse(s);
+  } catch {
+    return void 0;
+  }
+}
+function appElements(doc) {
+  const out = [];
+  const walk = (el) => {
+    if (SKIP.has(el.tagName) || el.localName === "scenario-panel") return;
+    out.push(el);
+    for (const child of el.children) walk(child);
+  };
+  if (doc.body) walk(doc.body);
+  return out;
+}
+function scoreSelector(selector, el) {
+  let score = 0;
+  if (selector.startsWith("[data-test")) score += 100;
+  else if (selector.startsWith("role=") && selector.includes("[name=")) score += 80;
+  else if (selector.startsWith("text=")) score += 60;
+  else if (selector.startsWith("role=")) score += 40;
+  if (el.children.length === 0) score += 10;
+  if (el.tagName === "H1" || el.tagName === "H2" || el.tagName === "H3") score += 15;
+  const role = el.getAttribute("role");
+  if (role === "alert" || role === "status") score += 20;
+  if (el.closest(CHROME)) score -= 50;
+  if (el.tagName === "INPUT" || el.tagName === "TEXTAREA" || el.tagName === "SELECT") score -= 50;
+  return score;
+}
+function roleOf(el) {
+  return el.getAttribute("role")?.trim().split(/\s+/)[0] || implicitRole(el);
+}
+function implicitRole(el) {
+  const tag = el.tagName;
+  if (tag === "BUTTON") return "button";
+  if (tag === "A" && el.hasAttribute("href")) return "link";
+  if (tag === "H1" || tag === "H2" || tag === "H3" || tag === "H4" || tag === "H5" || tag === "H6") {
+    return "heading";
+  }
+  if (tag === "IMG") return "img";
+  if (tag === "INPUT") {
+    const type = (el.getAttribute("type") ?? "text").toLowerCase();
+    if (type === "submit" || type === "button") return "button";
+    if (type === "checkbox") return "checkbox";
+    if (type === "radio") return "radio";
+    if (type === "search") return "searchbox";
+    return "textbox";
+  }
+  if (tag === "TEXTAREA") return "textbox";
+  if (tag === "SELECT") return "combobox";
+  return void 0;
+}
+function accessibleName(el, role) {
+  const labelledBy = el.getAttribute("aria-labelledby");
+  if (labelledBy) {
+    const text = collapse(
+      labelledBy.split(/\s+/).map((id) => el.ownerDocument.getElementById(id)?.textContent ?? "").join(" ")
+    );
+    if (text) return text;
+  }
+  const label = collapse(el.getAttribute("aria-label") ?? "");
+  if (label) return label;
+  if (el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement || el instanceof HTMLSelectElement) {
+    const fromLabel = collapse([...el.labels ?? []].map((l) => l.textContent ?? "").join(" "));
+    if (fromLabel) return fromLabel;
+    if (!(el instanceof HTMLSelectElement) && el.placeholder) return collapse(el.placeholder);
+  }
+  if (el instanceof HTMLImageElement && el.alt) return collapse(el.alt);
+  if (NAME_FROM_CONTENT.has(role)) return collapse(el.textContent ?? "") || void 0;
+  return collapse(el.getAttribute("title") ?? "") || void 0;
+}
+function ownText(el) {
+  for (const n of el.childNodes) {
+    const text = n.nodeType === Node.TEXT_NODE ? collapse(n.textContent ?? "") : "";
+    if (text) return text;
+  }
+  return el.children.length === 1 ? ownText(el.children[0]) : "";
+}
+function collapse(s) {
+  return s.replace(/\s+/g, " ").trim();
+}
+function isVisible(el) {
+  if (!(el instanceof HTMLElement)) return true;
+  const style = el.ownerDocument.defaultView?.getComputedStyle(el);
+  if (style && (style.display === "none" || style.visibility === "hidden")) return false;
+  if (el.hidden || el.getAttribute("aria-hidden") === "true") return false;
+  return true;
+}
+function isShown(el) {
+  for (let node = el; node; node = node.parentElement) {
+    if (!(node instanceof HTMLElement)) continue;
+    if (node.hidden) return false;
+    const style = node.ownerDocument.defaultView?.getComputedStyle(node);
+    if (style && (style.display === "none" || style.visibility === "hidden")) return false;
+  }
+  return true;
+}
+
+export {
+  captureScenario,
+  selectorForElement,
+  closestReadySelector,
+  suggestReadySelectors,
+  checkReadySelector
+};
+//# sourceMappingURL=chunk-FTWYRB6F.js.map

package/dist/chunk-FTWYRB6F.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/capture.ts","../src/ready.ts"],"sourcesContent":["import { diffScenario } from './catalog.js';\nimport { PARAM, RECORD_PARAM, STRICT_PARAM } from './link.js';\nimport type { ScenarioSession } from './runtime.js';\nimport { parseScenario, type Scenario, type ScenarioInput } from './schema.js';\n\nconst SCENARIO_PARAMS = new Set([PARAM, STRICT_PARAM, RECORD_PARAM]);\n\nexport interface CaptureOptions {\n  name: string;\n  description?: string;\n  /** Playwright selector that marks this UI state ready. */\n  ready?: string;\n  /**\n   * Catalog scenario to `extends`. Diff uses its resolved (flattened) form.\n   * Omit for a full self-contained snapshot.\n   */\n  base?: Scenario;\n  /** Relative `$schema` path stamped on the catalog file only, e.g. `../scenario.schema.json`. */\n  schemaPath?: string;\n}\n\nexport interface CapturedScenario {\n  /** Flattened snapshot for inline share links. */\n  flat: Scenario;\n  /** File to commit: diffs against `base` when set, otherwise the flat snapshot as input. */\n  forCatalog: ScenarioInput;\n}\n\n/**\n * Snapshot what the app shows now: current route and URL params, the active network\n * fixtures (plus recorded responses), and every connected adapter's live state.\n */\nexport function captureScenario(session: ScenarioSession, options: CaptureOptions): CapturedScenario {\n  const url: Record<string, string> = {};\n  new URLSearchParams(location.search).forEach((v, k) => {\n    if (!SCENARIO_PARAMS.has(k)) url[k] = v;\n  });\n\n  const state = Object.fromEntries(\n    session.keys().flatMap((key) => {\n      const value = session.read(key);\n\n      return value === undefined ? [] : [[key, value] as const];\n    }),\n  );\n\n  // Recorded responses go after the scenario's own: they answered requests it didn't mock.\n  const network = [...(session.resolved?.network ?? []), ...session.recorded()];\n\n  const draft = parseScenario({\n    name: options.name,\n    description: options.description || undefined,\n    path: location.pathname,\n    url,\n    network: network.length ? network : undefined,\n    state,\n    ready: options.ready || undefined,\n  });\n\n  const flat = session.catalog.resolve(draft);\n  const flatBase = options.base ? session.catalog.resolve(options.base) : undefined;\n  const forCatalog = diffScenario(flat, flatBase);\n\n  if (options.schemaPath) forCatalog.$schema = options.schemaPath;\n\n  return { flat, forCatalog };\n}\n","const SKIP = new Set(['SCRIPT', 'STYLE', 'NOSCRIPT', 'META', 'LINK', 'HEAD', 'HTML']);\n\nconst MAX_TEXT = 60;\n\nconst CHROME =\n  'header, nav, aside, footer, [role=banner], [role=navigation], [role=complementary], [role=contentinfo]';\n\n// Roles whose accessible name comes from their text. Others (alert, status, region…) are\n// named only by aria-label/labelledby, so Playwright's [name=…] never matches their text.\nconst NAME_FROM_CONTENT = new Set([\n  'button',\n  'cell',\n  'checkbox',\n  'columnheader',\n  'gridcell',\n  'heading',\n  'link',\n  'menuitem',\n  'menuitemcheckbox',\n  'menuitemradio',\n  'option',\n  'radio',\n  'row',\n  'rowheader',\n  'switch',\n  'tab',\n  'tooltip',\n  'treeitem',\n]);\n\n// Implicit roles implicitRole knows; for any other role only an explicit role=\"…\" is checkable.\nconst IMPLICIT_ROLES = new Set([\n  'button',\n  'link',\n  'heading',\n  'img',\n  'textbox',\n  'searchbox',\n  'checkbox',\n  'radio',\n  'combobox',\n]);\n\n/** Playwright selector for an element the user marked as the scenario's ready signal. */\nexport function selectorForElement(el: Element): string | undefined {\n  if (!(el instanceof Element) || SKIP.has(el.tagName) || el.closest('scenario-panel')) {\n    return undefined;\n  }\n\n  for (const attr of ['data-testid', 'data-test-id']) {\n    const testId = el.getAttribute(attr);\n\n    if (testId) return `[${attr}=${JSON.stringify(testId)}]`;\n  }\n\n  const role = roleOf(el);\n  const name = role && accessibleName(el, role);\n\n  if (role && name && name.length <= MAX_TEXT) {\n    return `role=${role}[name=${JSON.stringify(name)}]`;\n  }\n\n  const text = ownText(el);\n\n  if (text && text.length <= MAX_TEXT) {\n    const selector = `text=${JSON.stringify(text)}`;\n    const check = checkReadySelector(selector, el.ownerDocument);\n\n    if (check.status === 'match' && check.count === 1) return selector;\n  }\n\n  if (role) return `role=${role}`;\n\n  return undefined;\n}\n\n/**\n * The nearest element at or above `el` that has a ready selector, so clicking an icon or a\n * wrapper still marks something.\n */\nexport function closestReadySelector(el: Element): { element: Element; selector: string; } | undefined {\n  for (let node: Element | null = el; node && node !== node.ownerDocument.body; node = node.parentElement) {\n    const selector = selectorForElement(node);\n\n    if (selector) return { element: node, selector };\n  }\n\n  return undefined;\n}\n\n/**\n * Ranked Playwright selectors for visible, distinctive UI, offered when the user\n * hasn't marked ready. Prefers test ids, then named roles, then unique short text.\n */\nexport function suggestReadySelectors(\n  root?: ParentNode | null,\n  { limit = 3 }: { limit?: number; } = {},\n): string[] {\n  const target = root ?? globalThis.document?.body;\n\n  if (!target) return [];\n\n  const ranked: { score: number; selector: string; }[] = [];\n  const seen = new Set<string>();\n\n  const walk = (node: Element) => {\n    if (SKIP.has(node.tagName) || node.localName === 'scenario-panel' || !isVisible(node)) return;\n\n    const selector = selectorForElement(node);\n    // A count or a single character (\"0\" in \"0 countries\") is too generic to suggest.\n    const tooShort = selector?.startsWith('text=') && selector.length < 'text=\"\"'.length + 3;\n\n    if (selector && !tooShort && !seen.has(selector)) {\n      seen.add(selector);\n      ranked.push({ score: scoreSelector(selector, node), selector });\n    }\n\n    for (const child of node.children) walk(child);\n  };\n\n  if (target instanceof Element) walk(target);\n  else for (const child of target.children) walk(child);\n\n  return ranked.toSorted((a, b) => b.score - a.score).slice(0, limit).map((r) => r.selector);\n}\n\nexport type ReadyCheck =\n  /** `first` is what `openScenario` waits on; `visible` says whether it's showing now. */\n  | { status: 'match'; count: number; first: Element; visible: boolean; }\n  | { status: 'none'; }\n  /** A selector form this page can't evaluate (xpath, chains, regex…); Playwright still can. */\n  | { status: 'unchecked'; }\n  | { status: 'invalid'; error: string; };\n\n/**\n * Evaluate a ready selector against the live page the way Playwright would, for the forms\n * the panel generates and plain CSS. Anything else comes back `unchecked`, never a guess.\n */\nexport function checkReadySelector(selector: string, doc: Document = document): ReadyCheck {\n  const s = selector.trim();\n\n  if (!s || s.includes('>>')) return { status: 'unchecked' };\n\n  const found = s.startsWith('text=')\n    ? matchText(s.slice(5), doc)\n    : s.startsWith('role=')\n    ? matchRole(s.slice(5), doc)\n    : s.startsWith('css=') || !/^[a-z-]+=/i.test(s)\n    ? matchCss(s.replace(/^css=/, ''), doc)\n    : undefined;\n\n  if (!found) return { status: 'unchecked' };\n\n  if ('error' in found) return { status: 'invalid', error: found.error };\n\n  const [first] = found;\n\n  return first\n    ? { status: 'match', count: found.length, first, visible: isShown(first) }\n    : { status: 'none' };\n}\n\ntype Found = Element[] | { error: string; } | undefined;\n\nfunction matchText(body: string, doc: Document): Found {\n  const quoted = unquote(body);\n\n  // Quoted: an element with a text node equal to it, case-sensitive.\n  if (quoted !== undefined) {\n    return appElements(doc).filter((el) =>\n      [...el.childNodes].some((n) =>\n        n.nodeType === Node.TEXT_NODE && collapse(n.textContent ?? '') === quoted\n      )\n    );\n  }\n\n  if (body.startsWith('/')) return undefined;\n\n  // Unquoted: the smallest elements whose text contains it, ignoring case.\n  const needle = collapse(body).toLowerCase();\n\n  if (!needle) return undefined;\n\n  const has = (el: Element) => collapse(el.textContent ?? '').toLowerCase().includes(needle);\n\n  return appElements(doc).filter((el) => has(el) && ![...el.children].some(has));\n}\n\nfunction matchRole(body: string, doc: Document): Found {\n  const m = /^([a-z]+)(?:\\[name=(\".*\")\\])?$/.exec(body);\n\n  if (!m) return undefined;\n\n  const [, role, rawName] = m;\n  const name = rawName === undefined ? undefined : unquote(rawName);\n\n  if (rawName !== undefined && name === undefined) return undefined;\n\n  // Like Playwright's role engine, hidden elements don't count.\n  const found = appElements(doc).filter((el) =>\n    roleOf(el) === role && isShown(el) && !el.closest('[aria-hidden=true]')\n    && (name === undefined || accessibleName(el, role) === name)\n  );\n\n  // We only know some implicit roles (<main> is \"main\", <p> is \"paragraph\"…), so a miss\n  // on any other role isn't proof of absence.\n  if (!found.length && !IMPLICIT_ROLES.has(role)) return undefined;\n\n  return found;\n}\n\nfunction matchCss(css: string, doc: Document): Found {\n  try {\n    return [...doc.querySelectorAll(css)].filter((el) => !el.closest('scenario-panel'));\n  } catch {\n    return { error: 'Not a valid CSS selector' };\n  }\n}\n\n/** A JSON-style \"quoted\" string, or undefined when `s` isn't one. */\nfunction unquote(s: string): string | undefined {\n  if (!s.startsWith('\"') || !s.endsWith('\"') || s.length < 2) return undefined;\n\n  try {\n    return JSON.parse(s);\n  } catch {\n    return undefined;\n  }\n}\n\nfunction appElements(doc: Document): Element[] {\n  const out: Element[] = [];\n\n  const walk = (el: Element) => {\n    if (SKIP.has(el.tagName) || el.localName === 'scenario-panel') return;\n    out.push(el);\n\n    for (const child of el.children) walk(child);\n  };\n\n  if (doc.body) walk(doc.body);\n\n  return out;\n}\n\nfunction scoreSelector(selector: string, el: Element): number {\n  let score = 0;\n\n  if (selector.startsWith('[data-test')) score += 100;\n  else if (selector.startsWith('role=') && selector.includes('[name=')) score += 80;\n  else if (selector.startsWith('text=')) score += 60;\n  else if (selector.startsWith('role=')) score += 40;\n\n  // Prefer leaf-ish content over giant containers.\n  if (el.children.length === 0) score += 10;\n\n  if (el.tagName === 'H1' || el.tagName === 'H2' || el.tagName === 'H3') score += 15;\n\n  const role = el.getAttribute('role');\n\n  if (role === 'alert' || role === 'status') score += 20;\n\n  // Headers, navs, sidebars and inputs render in every state, so they make weak ready signals.\n  if (el.closest(CHROME)) score -= 50;\n\n  if (el.tagName === 'INPUT' || el.tagName === 'TEXTAREA' || el.tagName === 'SELECT') score -= 50;\n\n  return score;\n}\n\nfunction roleOf(el: Element): string | undefined {\n  return el.getAttribute('role')?.trim().split(/\\s+/)[0] || implicitRole(el);\n}\n\nfunction implicitRole(el: Element): string | undefined {\n  const tag = el.tagName;\n\n  if (tag === 'BUTTON') return 'button';\n\n  if (tag === 'A' && el.hasAttribute('href')) return 'link';\n\n  if (tag === 'H1' || tag === 'H2' || tag === 'H3' || tag === 'H4' || tag === 'H5' || tag === 'H6') {\n    return 'heading';\n  }\n\n  if (tag === 'IMG') return 'img';\n\n  if (tag === 'INPUT') {\n    const type = (el.getAttribute('type') ?? 'text').toLowerCase();\n\n    if (type === 'submit' || type === 'button') return 'button';\n\n    if (type === 'checkbox') return 'checkbox';\n\n    if (type === 'radio') return 'radio';\n\n    if (type === 'search') return 'searchbox';\n\n    return 'textbox';\n  }\n\n  if (tag === 'TEXTAREA') return 'textbox';\n\n  if (tag === 'SELECT') return 'combobox';\n\n  return undefined;\n}\n\n/** The accessible name Playwright's `[name=…]` compares against, for the common cases. */\nfunction accessibleName(el: Element, role: string): string | undefined {\n  const labelledBy = el.getAttribute('aria-labelledby');\n\n  if (labelledBy) {\n    const text = collapse(\n      labelledBy.split(/\\s+/).map((id) => el.ownerDocument.getElementById(id)?.textContent ?? '').join(' '),\n    );\n\n    if (text) return text;\n  }\n\n  const label = collapse(el.getAttribute('aria-label') ?? '');\n\n  if (label) return label;\n\n  if (\n    el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement || el instanceof HTMLSelectElement\n  ) {\n    const fromLabel = collapse([...(el.labels ?? [])].map((l) => l.textContent ?? '').join(' '));\n\n    if (fromLabel) return fromLabel;\n\n    if (!(el instanceof HTMLSelectElement) && el.placeholder) return collapse(el.placeholder);\n  }\n\n  if (el instanceof HTMLImageElement && el.alt) return collapse(el.alt);\n\n  if (NAME_FROM_CONTENT.has(role)) return collapse(el.textContent ?? '') || undefined;\n\n  return collapse(el.getAttribute('title') ?? '') || undefined;\n}\n\n/** The element's first own text node, which is what a quoted `text=` selector matches. */\nfunction ownText(el: Element): string {\n  for (const n of el.childNodes) {\n    const text = n.nodeType === Node.TEXT_NODE ? collapse(n.textContent ?? '') : '';\n\n    if (text) return text;\n  }\n\n  // No own text: a lone descendant text still identifies this element's content.\n  return el.children.length === 1 ? ownText(el.children[0]) : '';\n}\n\nfunction collapse(s: string): string {\n  return s.replace(/\\s+/g, ' ').trim();\n}\n\nfunction isVisible(el: Element): boolean {\n  if (!(el instanceof HTMLElement)) return true;\n  const style = el.ownerDocument.defaultView?.getComputedStyle(el);\n\n  if (style && (style.display === 'none' || style.visibility === 'hidden')) return false;\n\n  if (el.hidden || el.getAttribute('aria-hidden') === 'true') return false;\n\n  return true;\n}\n\n/** Rendered including ancestors: what Playwright's waitFor needs. */\nfunction isShown(el: Element): boolean {\n  for (let node: Element | null = el; node; node = node.parentElement) {\n    if (!(node instanceof HTMLElement)) continue;\n\n    if (node.hidden) return false;\n    const style = node.ownerDocument.defaultView?.getComputedStyle(node);\n\n    if (style && (style.display === 'none' || style.visibility === 'hidden')) return false;\n  }\n\n  return true;\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-HEVJQ47T.js

@@ -0,0 +1,148 @@
+import {
+  SAVE_ENDPOINT
+} from "./chunk-3M6SD4TA.js";
+import {
+  JsonSchema,
+  ScenarioSchema
+} from "./chunk-DCURPYW5.js";
+
+// src/save.ts
+import { existsSync, mkdirSync, writeFileSync } from "fs";
+import { createServer } from "http";
+import { join, relative } from "path";
+import { z } from "zod";
+var MAX_BODY = 20 * 1024 * 1024;
+var SaveRequestSchema = z.object({ scenario: JsonSchema, overwrite: z.boolean().optional() });
+async function handleSaveRequest(request, { dir, root, origins }) {
+  const display = (file2) => relative(root, file2).replaceAll("\\", "/");
+  const reply = (status, body2) => Response.json(body2, { status });
+  if (!allowedOrigin(request.headers, origins)) {
+    return reply(403, { error: "Save refused: only the app on localhost may write files" });
+  }
+  if (request.method === "GET") return reply(200, { dir: display(dir) });
+  if (request.method !== "POST") return reply(405, { error: "Use GET or POST" });
+  if (!request.headers.get("content-type")?.startsWith("application/json")) {
+    return reply(415, { error: "Send application/json" });
+  }
+  let body;
+  try {
+    body = SaveRequestSchema.parse(JSON.parse(await readCapped(request)));
+  } catch (err) {
+    return reply(400, { error: err instanceof z.ZodError ? z.prettifyError(err) : String(err) });
+  }
+  const parsed = ScenarioSchema.safeParse(body.scenario);
+  if (!parsed.success) return reply(400, { error: z.prettifyError(parsed.error) });
+  const { name } = parsed.data;
+  if (name.includes(",")) return reply(400, { error: "A saved scenario name can't contain a comma" });
+  const file = join(dir, `${name}.json`);
+  if (existsSync(file) && !body.overwrite) {
+    return reply(409, { error: `${display(file)} already exists`, path: display(file) });
+  }
+  mkdirSync(dir, { recursive: true });
+  writeFileSync(file, `${JSON.stringify(body.scenario, null, 2)}
+`);
+  return reply(200, { path: display(file), file });
+}
+function createSaveHandler(target) {
+  return async (req, res) => {
+    const origin = req.headers.origin;
+    if (origin && target.origins?.includes(origin)) {
+      res.setHeader("access-control-allow-origin", origin);
+      res.setHeader("vary", "origin");
+    }
+    if (req.method === "OPTIONS") {
+      res.setHeader("access-control-allow-methods", "GET, POST");
+      res.setHeader("access-control-allow-headers", "content-type");
+      res.statusCode = 204;
+      res.end();
+      return;
+    }
+    let response;
+    try {
+      response = isLoopbackAddress(req.socket.remoteAddress) ? await handleSaveRequest(toRequest(req), target) : Response.json({ error: "Save refused: only this machine may write files" }, { status: 403 });
+    } catch (err) {
+      response = Response.json({ error: String(err) }, { status: 500 });
+    }
+    res.statusCode = response.status;
+    response.headers.forEach((value, key) => res.setHeader(key, value));
+    res.end(await response.text());
+  };
+}
+function startSaveServer(target) {
+  const handle = createSaveHandler(target);
+  const server = createServer((req, res) => void handle(req, res));
+  return new Promise((done, fail) => {
+    server.once("error", fail);
+    server.listen(0, "127.0.0.1", () => {
+      const { port } = z.object({ port: z.number() }).parse(server.address());
+      server.unref();
+      done(`http://127.0.0.1:${port}${SAVE_ENDPOINT}`);
+    });
+  });
+}
+function isLoopbackAddress(address) {
+  if (!address) return false;
+  const ip = address.replace(/^::ffff:/, "");
+  return ip === "::1" || /^127(\.\d{1,3}){3}$/.test(ip);
+}
+function allowedOrigin(headers, origins) {
+  const host = headers.get("host") ?? "";
+  if (!isLoopbackHost(host)) return false;
+  const origin = headers.get("origin");
+  if (!origin) return true;
+  if (origins) return origins.includes(origin);
+  try {
+    return new URL(origin).host === host;
+  } catch {
+    return false;
+  }
+}
+function isLoopbackHost(host) {
+  let hostname;
+  try {
+    hostname = new URL(`http://${host}`).hostname;
+  } catch {
+    return false;
+  }
+  return hostname === "localhost" || hostname.endsWith(".localhost") || hostname === "[::1]" || /^127(\.\d{1,3}){3}$/.test(hostname);
+}
+function toRequest(req) {
+  const headers = new Headers();
+  for (let i = 0; i < req.rawHeaders.length; i += 2) headers.append(req.rawHeaders[i], req.rawHeaders[i + 1]);
+  const method = req.method ?? "GET";
+  const body = method === "GET" || method === "HEAD" ? void 0 : new ReadableStream({
+    start(controller) {
+      req.on("data", (chunk) => controller.enqueue(new Uint8Array(chunk)));
+      req.on("end", () => controller.close());
+      req.on("error", (err) => controller.error(err));
+    },
+    cancel() {
+      req.destroy();
+    }
+  });
+  const init = { method, headers, body, duplex: "half" };
+  return new Request(new URL(req.url ?? "/", `http://${headers.get("host") ?? "localhost"}`), init);
+}
+async function readCapped(request) {
+  const reader = request.body?.getReader();
+  if (!reader) return "";
+  const chunks = [];
+  let size = 0;
+  for (; ; ) {
+    const { done, value } = await reader.read();
+    if (done) break;
+    size += value.length;
+    if (size > MAX_BODY) {
+      await reader.cancel();
+      throw new Error("Scenario too large");
+    }
+    chunks.push(value);
+  }
+  return Buffer.concat(chunks).toString("utf8");
+}
+
+export {
+  createSaveHandler,
+  startSaveServer
+};
+//# sourceMappingURL=chunk-HEVJQ47T.js.map