@molecule/api-ai-tools 1.10.2 → 1.10.3

package/README.md

@@ -3,7 +3,7 @@ AUTO-GENERATED — DO NOT EDIT THIS FILE.
 Generated by `mlcl sync-docs` from the package's src/index.ts JSDoc + mlcl/registry.json.
 Edits here are overwritten on the next commit (molecule's pre-commit hook regenerates).
 To change this document, edit the module-level JSDoc in src/index.ts.
-Generated: 2026-10-19T01:32:03.421Z
+Generated: 2026-10-19T03:15:38.119Z
 -->
 
 # @molecule/api-ai-tools
@@ -626,6 +626,43 @@ interface TraceReadContradiction {
 }
 ```
 
+#### `TraceHiddenBox`
+
+A visibility failure whose locator RESOLVED: Playwright calls an element with a zero-size box
+"hidden" even when it is painted, so the useful fact is why the box is empty. The trace's own
+failure snapshot carries the element's children — read here, never guessed.
+
+```typescript
+interface TraceHiddenBox {
+  /** The locator the assertion printed (`locator('a.navbar-brand')`), or the element it names. */
+  locator: string
+  /** The element's tag, lowercased (`a`). */
+  tag: string
+  /** The element's own inline style, when the snapshot carries one. */
+  style?: string
+  /**
+   * The `<img>` the element wraps when that image is its only element child and the element has
+   * no text of its own: the size the box would collapse to.
+   */
+  image?: {
+    /** The image's `src`, bounded. */
+    src?: string
+    /** Its `width` attribute. */
+    width?: string
+    /** Its `height` attribute. */
+    height?: string
+    /** Its inline `style`. */
+    style?: string
+    /** Its `class`. */
+    className?: string
+    /** Its `alt` text. */
+    alt?: string
+  }
+  /** True when the element has no text and no element children at all. */
+  empty?: true
+}
+```
+
 #### `TraceArtifact`
 
 What one trace says: the test it belongs to, the requests it made, and its console lines.
@@ -715,6 +752,13 @@ interface TraceArtifact {
    * and on traces read before this field existed.
    */
   readContradiction?: TraceReadContradiction
+  /**
+   * A visibility failure whose locator RESOLVED into an empty box — Playwright's "hidden" — with
+   * the element's children read from the failure snapshot ({@link TraceHiddenBox}). The note uses
+   * it to name why the box is empty (an `<img>` with no CSS size, a textless element) instead of
+   * leaving the run to probe computed styles (xr-molecule-flash-m197).
+   */
+  hiddenBox?: TraceHiddenBox
 }
 ```
 
@@ -1818,7 +1862,9 @@ the runner invocation each caller read as a run is one.
 
 A command that also runs tests is false however it is spelled: `npx playwright install &&
 npx playwright test` installs and runs, so a caller that sees `playwright test` in it is
-reading a real run.
+reading a real run. So is a command carrying a segment this reader cannot place (a script it
+does not know, which may start a suite): only the runners and the {@link NO_TEST_PROGRAMS}
+table can be accounted for, and "only prints" is a claim about the WHOLE command.
 
 ```typescript
 function commandRunsNoTests(command: string): boolean
@@ -2409,6 +2455,26 @@ function isCredentialExchangePath(path: string, authEndpoints?: readonly string[
 
 **Returns:** True when the path names a credential exchange.
 
+#### `hiddenBoxNote(items)`
+
+The sentence a "hidden" visibility failure earns when the trace proved WHY the box is empty.
+
+Playwright calls an element with a zero-size box hidden even when it is painted, so the answer
+is in the element's children. `a.navbar-brand` on xr-molecule-flash-m197 was 0×4 px because its
+only child was `<img src="/conduit-logo.svg" height="26">`: an SVG with a `viewBox` and no
+width/height has no intrinsic size, and the `height` attribute loses to Tailwind's preflight
+(`img { max-width: 100%; height: auto }`), which the scaffold's own `index.css` imports. The
+note said only "the cause is in the page", and the run spent over four minutes rasterising an
+SVG to PNG. Only what the snapshot shows is claimed ({@link TraceHiddenBox}).
+
+```typescript
+function hiddenBoxNote(items: readonly TraceArtifact[]): string | null
+```
+
+- `items` — The traces {@link parseTraceArtifacts} read.
+
+**Returns:** The sentence, or null when no failure carries a hidden-box reading.
+
 #### `failureTraceNote(items, target, earlierFailures, apiPrefixes, report)`
 
 The note a failed suite run's result carries: what each failing test's page actually sent, and

package/dist/no-test-run.d.ts

@@ -49,7 +49,9 @@
  *
  * A command that also runs tests is false however it is spelled: `npx playwright install &&
  * npx playwright test` installs and runs, so a caller that sees `playwright test` in it is
- * reading a real run.
+ * reading a real run. So is a command carrying a segment this reader cannot place (a script it
+ * does not know, which may start a suite): only the runners and the {@link NO_TEST_PROGRAMS}
+ * table can be accounted for, and "only prints" is a claim about the WHOLE command.
  *
  * @param command - The shell command as the executor sent it.
  * @returns True when the command invokes a runner only to print.

package/dist/no-test-run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"no-test-run.d.ts","sourceRoot":"","sources":["../src/no-test-run.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AA0EH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAU3D"}
+{"version":3,"file":"no-test-run.d.ts","sourceRoot":"","sources":["../src/no-test-run.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAiLH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAiB3D"}

package/dist/no-test-run.js

@@ -75,6 +75,108 @@ const NO_RUN_FLAGS = {
     ],
     hurl: [/(?:^|\s)--help(?=\s|$)/, /(?:^|\s)-h(?=\s|$)/, /(?:^|\s)--version(?=\s|$)/],
 };
+/**
+ * The programs that start no test — the shell's own bookkeeping (`cd`, `export`, `echo`), and the
+ * readers, printers and file commands an executor uses to look at what is already there (`cat`,
+ * `ls`, `cp`, `tail`, …).
+ *
+ * A segment whose program is neither a runner nor one of these is a program this reader cannot
+ * account for: the suite's own script (`./run-api-tests-hurl.sh`), a wrapper the executor wrote,
+ * anything that may itself start a suite. {@link commandRunsNoTests} answers false for a command
+ * carrying one — "every invocation only prints" is not a claim an unknown step can support.
+ * X1 xr-molecule-flash-m197 (+05:18) sent
+ * `hurl --version | head -2 && HOST=http://localhost:4000 ./run-api-tests-hurl.sh 2>&1 | tail -60`,
+ * the suite passed 13/13, and the supplied script was the one segment nobody could place: the
+ * whole command read as a version probe, so every "has the suite run?" reader said no for the
+ * rest of the run and the early deploy was held to the end of the list.
+ */
+const NO_TEST_PROGRAMS = new Set([
+    '[',
+    '[[',
+    ':',
+    'awk',
+    'base64',
+    'basename',
+    'case',
+    'cat',
+    'cd',
+    'chmod',
+    'chown',
+    'column',
+    'comm',
+    'cp',
+    'cut',
+    'date',
+    'df',
+    'diff',
+    'dirname',
+    'do',
+    'done',
+    'du',
+    'echo',
+    'egrep',
+    'else',
+    'env',
+    'esac',
+    'export',
+    'expr',
+    'false',
+    'fgrep',
+    'fi',
+    'file',
+    'fold',
+    'for',
+    'grep',
+    'head',
+    'hostname',
+    'id',
+    'if',
+    'jq',
+    'kill',
+    'less',
+    'ln',
+    'ls',
+    'md5sum',
+    'mkdir',
+    'mktemp',
+    'more',
+    'mv',
+    'nl',
+    'od',
+    'paste',
+    'printf',
+    'pwd',
+    'readlink',
+    'realpath',
+    'rev',
+    'rm',
+    'rmdir',
+    'seq',
+    'set',
+    'sha256sum',
+    'sleep',
+    'sort',
+    'stat',
+    'tac',
+    'tail',
+    'tee',
+    'test',
+    'then',
+    'touch',
+    'tr',
+    'true',
+    'type',
+    'uname',
+    'uniq',
+    'unset',
+    'until',
+    'wait',
+    'wc',
+    'which',
+    'while',
+    'whoami',
+    'xxd',
+]);
 /**
  * A heredoc body is data a command writes, not what it runs: a `playwright test --list` inside
  * the config a command writes is not a run of this command either way. The pattern consumes the
@@ -113,7 +215,9 @@ function informational(runner, after) {
  *
  * A command that also runs tests is false however it is spelled: `npx playwright install &&
  * npx playwright test` installs and runs, so a caller that sees `playwright test` in it is
- * reading a real run.
+ * reading a real run. So is a command carrying a segment this reader cannot place (a script it
+ * does not know, which may start a suite): only the runners and the {@link NO_TEST_PROGRAMS}
+ * table can be accounted for, and "only prints" is a claim about the WHOLE command.
  *
  * @param command - The shell command as the executor sent it.
  * @returns True when the command invokes a runner only to print.
@@ -123,9 +227,16 @@ export function commandRunsNoTests(command) {
         return false;
     let invocations = 0;
     for (const segment of commandSegments(command.replace(HEREDOC, ' '))) {
-        const runner = RUNNERS[segment.program];
-        if (!runner)
+        // An own key only: `constructor` is a program name (`constructor --version`) and a
+        // prototype key is not a runner.
+        const runner = Object.hasOwn(RUNNERS, segment.program) ? RUNNERS[segment.program] : undefined;
+        if (runner === undefined) {
+            // A program this reader cannot place may start a suite of its own; only a known
+            // non-test program lets the command keep reading as "prints only".
+            if (!NO_TEST_PROGRAMS.has(segment.program))
+                return false;
             continue;
+        }
         invocations += 1;
         if (!informational(runner, segment.args.join(' ')))
             return false;

package/dist/trace-artifacts.d.ts

@@ -223,6 +223,39 @@ export interface TraceReadContradiction {
     /** The later GET of the same resource (`GET /api/profiles/x`). */
     read: TraceRequest;
 }
+/**
+ * A visibility failure whose locator RESOLVED: Playwright calls an element with a zero-size box
+ * "hidden" even when it is painted, so the useful fact is why the box is empty. The trace's own
+ * failure snapshot carries the element's children — read here, never guessed.
+ */
+export interface TraceHiddenBox {
+    /** The locator the assertion printed (`locator('a.navbar-brand')`), or the element it names. */
+    locator: string;
+    /** The element's tag, lowercased (`a`). */
+    tag: string;
+    /** The element's own inline style, when the snapshot carries one. */
+    style?: string;
+    /**
+     * The `<img>` the element wraps when that image is its only element child and the element has
+     * no text of its own: the size the box would collapse to.
+     */
+    image?: {
+        /** The image's `src`, bounded. */
+        src?: string;
+        /** Its `width` attribute. */
+        width?: string;
+        /** Its `height` attribute. */
+        height?: string;
+        /** Its inline `style`. */
+        style?: string;
+        /** Its `class`. */
+        className?: string;
+        /** Its `alt` text. */
+        alt?: string;
+    };
+    /** True when the element has no text and no element children at all. */
+    empty?: true;
+}
 /** What one trace says: the test it belongs to, the requests it made, and its console lines. */
 export interface TraceArtifact {
     /** The failure's spec file, relative to the run's directory, when the trace names one. */
@@ -308,6 +341,13 @@ export interface TraceArtifact {
      * and on traces read before this field existed.
      */
     readContradiction?: TraceReadContradiction;
+    /**
+     * A visibility failure whose locator RESOLVED into an empty box — Playwright's "hidden" — with
+     * the element's children read from the failure snapshot ({@link TraceHiddenBox}). The note uses
+     * it to name why the box is empty (an `<img>` with no CSS size, a textless element) instead of
+     * leaving the run to probe computed styles (xr-molecule-flash-m197).
+     */
+    hiddenBox?: TraceHiddenBox;
 }
 /** How many traces one read reports, newest first. */
 export declare const MAX_TRACE_ARTIFACTS = 12;
@@ -486,6 +526,21 @@ export interface TraceRunReport {
  * @returns True when the path names a credential exchange.
  */
 export declare function isCredentialExchangePath(path: string, authEndpoints?: readonly string[]): boolean;
+/**
+ * The sentence a "hidden" visibility failure earns when the trace proved WHY the box is empty.
+ *
+ * Playwright calls an element with a zero-size box hidden even when it is painted, so the answer
+ * is in the element's children. `a.navbar-brand` on xr-molecule-flash-m197 was 0×4 px because its
+ * only child was `<img src="/conduit-logo.svg" height="26">`: an SVG with a `viewBox` and no
+ * width/height has no intrinsic size, and the `height` attribute loses to Tailwind's preflight
+ * (`img { max-width: 100%; height: auto }`), which the scaffold's own `index.css` imports. The
+ * note said only "the cause is in the page", and the run spent over four minutes rasterising an
+ * SVG to PNG. Only what the snapshot shows is claimed ({@link TraceHiddenBox}).
+ *
+ * @param items - The traces {@link parseTraceArtifacts} read.
+ * @returns The sentence, or null when no failure carries a hidden-box reading.
+ */
+export declare function hiddenBoxNote(items: readonly TraceArtifact[]): string | null;
 /**
  * The note a failed suite run's result carries: what each failing test's page actually sent, and
  * what came back.

package/dist/trace-artifacts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trace-artifacts.d.ts","sourceRoot":"","sources":["../src/trace-artifacts.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"trace-artifacts.d.ts","sourceRoot":"","sources":["../src/trace-artifacts.ts"],"names":[],"mappings":"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"}

package/dist/trace-artifacts.js

@@ -236,6 +236,109 @@ function waitedTextOf(message) {
   return quoted(/Expected(?: string)?:\\s*(["'])((?:(?!\\1).)*)\\1/)
 }
 
+// The attributes of one serialized element's opening tag (\`class="a b" id="c"\`). The trace's
+// snapshots carry them as an object already; the ASSERTION's error prints the tag as text.
+function attrsOf(source) {
+  const out = {}
+  const pattern = /([A-Za-z_:][-A-Za-z0-9_:.]*)\\s*=\\s*("([^"]*)"|'([^']*)')/g
+  let match
+  while ((match = pattern.exec(String(source || ''))) !== null)
+    out[match[1].toLowerCase()] = match[3] !== undefined ? match[3] : match[4]
+  return out
+}
+
+// Whether a serialized subtree carries text of its own. A text node is a string; an element is
+// \`[tag, attrs, …children]\`. A reference to an earlier snapshot is not followed here: the caller
+// only makes a claim when every child is readable in place.
+function subtreeText(node) {
+  if (typeof node === 'string') return node.trim() !== ''
+  if (!Array.isArray(node) || Array.isArray(node[0]) || typeof node[0] !== 'string') return false
+  for (let i = 2; i < node.length; i++) if (subtreeText(node[i])) return true
+  return false
+}
+
+// The serialized element children of a node, in document order (references skipped).
+function elementChildren(node) {
+  const out = []
+  if (!Array.isArray(node)) return out
+  for (let i = 2; i < node.length; i++) {
+    const child = node[i]
+    if (typeof child === 'string' || !Array.isArray(child)) continue
+    if (Array.isArray(child[0]) || typeof child[0] !== 'string') continue
+    out.push(child)
+  }
+  return out
+}
+
+// The first element in a serialized DOM tree with this tag and (when given) id or first class.
+// Playwright's snapshot serializes elements as \`[tag, attrs, …children]\`.
+function findElement(node, tag, id, cls) {
+  if (typeof node === 'string' || !Array.isArray(node)) return null
+  if (Array.isArray(node[0]) || typeof node[0] !== 'string') return null
+  if (node[0].toLowerCase() === tag) {
+    const attrs = node[1] && typeof node[1] === 'object' ? node[1] : {}
+    const idMatch = id === '' || String(attrs.id || '') === id
+    const classes = String(attrs.class || attrs.className || '').split(/\\s+/)
+    const classMatch = id !== '' || cls === '' || classes.indexOf(cls) !== -1
+    if (idMatch && classMatch) return node
+  }
+  for (let i = 2; i < node.length; i++) {
+    const deeper = findElement(node[i], tag, id, cls)
+    if (deeper !== null) return deeper
+  }
+  return null
+}
+
+// A locator that RESOLVED whose box Playwright calls hidden. Playwright reports "hidden" for an
+// element with a zero-size box even when it is painted, so the interesting question is why the
+// box is empty — and the trace's own frame snapshot carries the element's children, the only
+// evidence the run would otherwise have to probe for (xr-molecule-flash-m197: \`a.navbar-brand\`
+// was 0x4 px because its only child was an <img> with no CSS size, and the note said only that
+// "the cause is in the page"; the run spent 4.5 minutes rasterising an SVG to PNG).
+// Only what the snapshot proves is reported: an inline display:none/visibility:hidden, a lone
+// <img> child, or a textless element with no children. Anything else says nothing.
+function hiddenBoxOf(message, frames) {
+  if (!message) return null
+  const text = String(message).replace(/\\u001b\\[[0-9;]*m/g, '')
+  if (text.indexOf('strict mode violation') !== -1) return null
+  if (!/Received:\\s*hidden/.test(text) && text.indexOf('element is not visible') === -1) return null
+  const resolved = /locator resolved to <([A-Za-z][\\w:-]*)((?:[^>"']|"[^"]*"|'[^']*')*)>/.exec(text)
+  if (resolved === null) return null
+  const tag = resolved[1].toLowerCase()
+  const attrs = attrsOf(resolved[2])
+  const id = attrs.id || ''
+  const cls = String(attrs.class || attrs.className || '').split(/\\s+/).filter(Boolean)[0] || ''
+  const named = /Locator:\\s*([^\\n]+)/.exec(text)
+  const reading = {
+    locator: named !== null ? named[1].trim() : cls ? tag + '.' + cls : tag,
+    tag: tag,
+  }
+  const snapshot = frames.length > 0 ? frames[frames.length - 1].snapshot : null
+  const node = snapshot === null || snapshot === undefined ? null : findElement(snapshot, tag, id, cls)
+  if (node === null) return null
+  const own = node[1] && typeof node[1] === 'object' ? node[1] : {}
+  if (typeof own.style === 'string' && own.style) reading.style = own.style.slice(0, 160)
+  if (!subtreeText(node)) {
+    const children = elementChildren(node)
+    if (children.length === 1 && children[0][0].toLowerCase() === 'img') {
+      const image = children[0][1] && typeof children[0][1] === 'object' ? children[0][1] : {}
+      reading.image = {}
+      for (const key of ['src', 'width', 'height', 'style', 'alt']) {
+        if (typeof image[key] === 'string' && image[key])
+          reading.image[key] = image[key].slice(0, 120)
+      }
+      if (typeof image.class === 'string' && image.class) reading.image.className = image.class.slice(0, 120)
+    } else if (children.length === 0) {
+      reading.empty = true
+    }
+  }
+  const hiddenStyle = /(?:^|;)\\s*display\\s*:\\s*none|(?:^|;)\\s*visibility\\s*:\\s*hidden/.test(
+    typeof own.style === 'string' ? own.style : '',
+  )
+  if (!reading.image && !reading.empty && !hiddenStyle) return null
+  return reading
+}
+
 // A request/response body exactly as Playwright stored it: inline on the value, or in a resource
 // entry the value names. Bounded, and binary is dropped — a JSON body is what this is for, and a
 // multipart upload would print bytes.
@@ -892,6 +995,10 @@ for (const one of found.slice(0, MAX_TRACES)) {
       }
     }
   }
+  // A visibility failure whose element RESOLVED but has an empty box: the snapshot's own DOM says
+  // what the element is made of, so the note names the cause instead of sending the run at the
+  // selector (m197 — an <img> with no CSS size collapsed inside its link).
+  const hiddenBox = hiddenBoxOf(failedError, frames)
   function wire(r) {
     return {
       method: r.method,
@@ -1112,7 +1219,13 @@ for (const one of found.slice(0, MAX_TRACES)) {
   const specific = consoleErrors.filter(function (text) { return !/^Failed to load resource/.test(text) })
   const keptConsole = specific.concat(consoleSignals, consoleWarnings)
   if (specific.length === 0) keptConsole.push.apply(keptConsole, consoleErrors)
-  if (chosen.length === 0 && keptConsole.length === 0 && actions.length === 0) continue
+  if (
+    chosen.length === 0 &&
+    keptConsole.length === 0 &&
+    actions.length === 0 &&
+    hiddenBox === null
+  )
+    continue
   process.stdout.write('TRACE ' + JSON.stringify({
     dir: path.relative(ROOT, path.dirname(one.file)),
     spec: spec,
@@ -1125,6 +1238,7 @@ for (const one of found.slice(0, MAX_TRACES)) {
     requests: chosen.slice(0, MAX_REQUESTS),
     ...(missingText === null ? {} : { missingText: missingText }),
     ...(readContradiction === null ? {} : { readContradiction: readContradiction }),
+    ...(hiddenBox === null ? {} : { hiddenBox: hiddenBox }),
     console: keptConsole.slice(0, MAX_CONSOLE).map(function (text) { return text.slice(0, 300) }),
     actions: actions.slice(-MAX_ACTIONS),
     ...(unattributed ? { unattributed: true } : {}),
@@ -1207,6 +1321,45 @@ function parseReadContradiction(value) {
         return null;
     return { field: raw.field, writeValue: raw.writeValue, readValue: raw.readValue, write, read };
 }
+/**
+ * One `hiddenBox` out of a `TRACE` line's json, or null when the value is not one.
+ *
+ * The locator and tag are required; the image/empty/style detail is optional evidence, kept only
+ * in the shape the script wrote it.
+ *
+ * @param value - The line's `hiddenBox`.
+ * @returns The element the failed locator resolved to, or null.
+ */
+function parseHiddenBox(value) {
+    if (typeof value !== 'object' || value === null)
+        return null;
+    const raw = value;
+    if (typeof raw.locator !== 'string' || raw.locator === '')
+        return null;
+    if (typeof raw.tag !== 'string' || raw.tag === '')
+        return null;
+    // An `image` that parses to no attributes is still the fact that the element wraps an <img>:
+    // its presence is the evidence, so an empty object stays.
+    const image = typeof raw.image === 'object' && raw.image !== null
+        ? (() => {
+            const at = raw.image;
+            const out = {};
+            for (const key of ['src', 'width', 'height', 'style', 'className', 'alt']) {
+                const field = at[key];
+                if (typeof field === 'string' && field !== '')
+                    out[key] = field;
+            }
+            return out;
+        })()
+        : null;
+    return {
+        locator: raw.locator,
+        tag: raw.tag,
+        ...(typeof raw.style === 'string' && raw.style ? { style: raw.style } : {}),
+        ...(image === null ? {} : { image }),
+        ...(raw.empty === true ? { empty: true } : {}),
+    };
+}
 /**
  * One `lastAction` out of a `TRACE` line's json, or null when the value is not one.
  *
@@ -1254,6 +1407,7 @@ export function parseTraceArtifacts(stdout) {
             const lastAction = parseLastAction(raw.lastAction);
             const missingText = parseMissingText(raw.missingText);
             const readContradiction = parseReadContradiction(raw.readContradiction);
+            const hiddenBox = parseHiddenBox(raw.hiddenBox);
             const otherContexts = Array.isArray(raw.otherContexts)
                 ? raw.otherContexts
                     .filter((c) => typeof c === 'object' && c !== null)
@@ -1291,6 +1445,7 @@ export function parseTraceArtifacts(stdout) {
                 ...(raw.unattributed === true ? { unattributed: true } : {}),
                 ...(missingText === null ? {} : { missingText }),
                 ...(readContradiction === null ? {} : { readContradiction }),
+                ...(hiddenBox === null ? {} : { hiddenBox }),
             });
         }
         catch (_error) {
@@ -2452,6 +2607,71 @@ function consoleLine(text) {
     return (`${url} answered the app's index.html, not a font — the file is missing from ` +
         `\`app/public/\` (or the asset import); copy/import it`);
 }
+/** An `<img>` as the failure snapshot recorded it, for the note's sentence. */
+function imageMarkup(image) {
+    const attrs = [
+        image.src === undefined ? '' : `src="${image.src}"`,
+        image.alt === undefined ? '' : `alt="${image.alt}"`,
+        image.width === undefined ? '' : `width="${image.width}"`,
+        image.height === undefined ? '' : `height="${image.height}"`,
+        image.className === undefined ? '' : `class="${image.className}"`,
+        image.style === undefined ? '' : `style="${image.style}"`,
+    ].filter(Boolean);
+    return `<img${attrs.length > 0 ? ` ${attrs.join(' ')}` : ''}>`;
+}
+/** Whether an image's CSS (its class or inline style) declares a width or height. */
+const IMAGE_SIZE_RULE = /(?:^|;)\s*(?:width|height|max-width|max-height)\s*:/;
+const HIDING_RULE = /(?:^|;)\s*(?:display\s*:\s*none|visibility\s*:\s*hidden)/;
+/**
+ * The sentence a "hidden" visibility failure earns when the trace proved WHY the box is empty.
+ *
+ * Playwright calls an element with a zero-size box hidden even when it is painted, so the answer
+ * is in the element's children. `a.navbar-brand` on xr-molecule-flash-m197 was 0×4 px because its
+ * only child was `<img src="/conduit-logo.svg" height="26">`: an SVG with a `viewBox` and no
+ * width/height has no intrinsic size, and the `height` attribute loses to Tailwind's preflight
+ * (`img { max-width: 100%; height: auto }`), which the scaffold's own `index.css` imports. The
+ * note said only "the cause is in the page", and the run spent over four minutes rasterising an
+ * SVG to PNG. Only what the snapshot shows is claimed ({@link TraceHiddenBox}).
+ *
+ * @param items - The traces {@link parseTraceArtifacts} read.
+ * @returns The sentence, or null when no failure carries a hidden-box reading.
+ */
+export function hiddenBoxNote(items) {
+    const box = items.find((item) => item.hiddenBox !== undefined)?.hiddenBox;
+    if (box === undefined)
+        return null;
+    const element = `\`${box.locator}\``;
+    if (box.image !== undefined) {
+        const image = box.image;
+        const shown = imageMarkup(image);
+        const sized = image.className !== undefined ||
+            (image.style !== undefined && IMAGE_SIZE_RULE.test(image.style));
+        if (sized) {
+            const rule = image.className === undefined ? 'its inline size' : `\`${image.className}\``;
+            return (`${element} resolved but Playwright calls it hidden: its box has no size, and its only ` +
+                `content is ${shown}. That image declares a size (${rule}), so the rule is not applying ` +
+                `on this page — check that the stylesheet defining it is actually loaded (a supplied ` +
+                `theme has to be linked in index.html, not only imported) and that the class name is ` +
+                `spelled the way the theme defines it.`);
+        }
+        return (`${element} resolved but Playwright calls it hidden: the element's box is empty, and its ` +
+            `only content is ${shown} — an image with no CSS size. An <img> takes its size from CSS or ` +
+            `from the file; an SVG that declares only a viewBox has no intrinsic size, and a ` +
+            `width/height ATTRIBUTE loses to any stylesheet rule (Tailwind's preflight, which the ` +
+            `scaffold's index.css imports, sets img { max-width: 100%; height: auto }). Give the image a ` +
+            `CSS width/height — a class the supplied theme already defines for it, or ` +
+            `style={{ height: … }} — rather than changing the SVG or rasterising it to PNG.`);
+    }
+    if (box.style !== undefined && HIDING_RULE.test(box.style)) {
+        return (`${element} resolved but Playwright calls it hidden: its own inline style sets ` +
+            `\`${box.style}\`. Remove that declaration (or the rule that sets it) so the element has a box.`);
+    }
+    if (box.empty === true) {
+        return (`${element} resolved but Playwright calls it hidden: the element has no text and no ` +
+            `children, so its box has zero size. Give it content or an explicit width/height.`);
+    }
+    return null;
+}
 /**
  * The note a failed suite run's result carries: what each failing test's page actually sent, and
  * what came back.
@@ -2590,6 +2810,10 @@ export function failureTraceNote(items, target, earlierFailures = [], apiPrefixe
     const wrapped = traced.some((item) => item.requests.some((request) => request.sent !== undefined && wrappedInData(request.sent)));
     // The "one of these requests failing" answer is only honest when a listed request really failed.
     const anyFailed = traced.some((item) => item.requests.some(failedRequest));
+    // A visibility failure the trace's own snapshot explains: said instead of the generic
+    // "the cause is in the page" sentence, which m197 read as "go look at the page" and then spent
+    // four minutes rasterising an SVG ({@link hiddenBoxNote}).
+    const hiddenBox = hiddenBoxNote(traced);
     // m145's shape: the app's HTTP client lost its base URL, so every API call reached the page
     // origin without the prefix the app mounts its routes under. The prefix is READ — the caller's
     // client config plus what the traces show — never assumed to be `/api`.
@@ -2954,13 +3178,17 @@ export function failureTraceNote(items, target, earlierFailures = [], apiPrefixe
                             'action sent no request at all, so there is no response to read. The page changed ' +
                             'route and fetched nothing, which is why it still shows the previous route’s data: ' +
                             'fix how the page reads the route, not the selector.'
-                        : 'No listed request failed — none got a 4xx/5xx or a network error — so the cause is in the ' +
-                            "page, not the API. Start with what the test's last action sent (the first line of each " +
-                            'row) and what the page did next: a request that answered (2xx included) while the page ' +
-                            'still did not show the state the assertion waited on is the fact to read — its status ' +
-                            'and response body, not the selector. If the request is not the one the test meant — an ' +
-                            'unfollow sent where the test clicked follow — the state the action read was stale ' +
-                            'before it.') +
+                        : hiddenBox !== null
+                            ? // The trace's own snapshot explains why the element Playwright resolved has no box:
+                                // a fact about the element, so it replaces the "look at the page" advice (m197).
+                                hiddenBox
+                            : 'No listed request failed — none got a 4xx/5xx or a network error — so the cause is in the ' +
+                                "page, not the API. Start with what the test's last action sent (the first line of each " +
+                                'row) and what the page did next: a request that answered (2xx included) while the page ' +
+                                'still did not show the state the assertion waited on is the fact to read — its status ' +
+                                'and response body, not the selector. If the request is not the one the test meant — an ' +
+                                'unfollow sent where the test clicked follow — the state the action read was stale ' +
+                                'before it.') +
         prefixAdvice +
         (wrapped
             ? ' The API received a body wrapped in `data`: app-http’s `post(url, data, config)` / ' +

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@molecule/api-ai-tools",
-  "version": "1.10.2",
+  "version": "1.10.3",
   "description": "Shared AI agent tools with backend abstraction for sandbox and local execution",
   "type": "module",
   "main": "dist/index.js",