@bitbaum/chatkit 0.14.1 → 0.14.2

package/README.md

@@ -163,12 +163,21 @@ sideways with a shadow on the edge that has more. The stack figure's tiles
 wrap too: three across becomes two and one, or one under the other, rather
 than cut "Manufacture".
 
-`test/browser.mjs` measures it rather than reading the CSS: every word of every
-answer is laid out in a `Range` at 320, 390 and 1280px and must sit on one line
+`test/browser.mjs` measures it rather than reading the CSS: every word on the
+page is laid out in a `Range` at 320, 390 and 1280px and must sit on one line
 (a word beside a hyphen, slash or dot, and anything over 24 characters, is
 exempt: a URL has to break somewhere). The demo thread carries the table from
 the screenshot, so the check fails on the old stylesheet.
 
+The check is exported so any product can run it against its own pages, from a
+Playwright script (never from app code):
+
+```js
+import { BROKEN_WORDS_SOURCE } from "@bitbaum/chatkit/audit";
+const broken = await page.evaluate(`(${BROKEN_WORDS_SOURCE})(document.body)`);
+if (broken.length) throw new Error(`words cut across lines: ${broken}`);
+```
+
 ### The feedback loop (0.14)
 
 Two halves, one shape, so a bad answer is found by the product, not by the

package/dist/audit.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Layout audits for a real browser — the part no unit test can see.
+ *
+ * Import this from a Playwright script, never from app code. `findBrokenWords`
+ * runs INSIDE the page: it is self-contained on purpose (no imports, no
+ * closures), so its source can be handed to `page.evaluate`:
+ *
+ *   import { BROKEN_WORDS_SOURCE } from "@bitbaum/chatkit/audit";
+ *   const broken = await page.evaluate(`(${BROKEN_WORDS_SOURCE})(document.body)`);
+ *   if (broken.length) throw new Error(`words cut across lines: ${broken}`);
+ *
+ * Why it exists: Substrata's answer table at 390px read "Te / rm" and
+ * "Di / re / ct / or / y" (2026-10-22). Reading the CSS finds none of it; only
+ * laying the words out does.
+ */
+/**
+ * Every word under `root` that is drawn across two lines. A word may wrap onto
+ * the next line; it may never be cut in two. Measured, not inferred: each word
+ * is laid out in a `Range` and must sit on one line.
+ *
+ * Exempt, because a break there is legal: a word beside a hyphen, slash, dot,
+ * at-sign, colon or underscore, and anything over `maxWord` characters (a URL
+ * or an identifier has to break somewhere). Hidden text has no boxes and is
+ * skipped.
+ */
+export declare function findBrokenWords(root?: ParentNode, options?: {
+    maxWord?: number;
+}): string[];
+/** `findBrokenWords` as source text, for `page.evaluate`. */
+export declare const BROKEN_WORDS_SOURCE: string;
+//# sourceMappingURL=audit.d.ts.map

package/dist/audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../src/audit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,IAAI,GAAE,UAAqB,EAC3B,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GACjC,MAAM,EAAE,CA0BV;AAED,6DAA6D;AAC7D,eAAO,MAAM,mBAAmB,EAAE,MAAmC,CAAC"}

package/dist/audit.js

@@ -0,0 +1,54 @@
+/**
+ * Layout audits for a real browser — the part no unit test can see.
+ *
+ * Import this from a Playwright script, never from app code. `findBrokenWords`
+ * runs INSIDE the page: it is self-contained on purpose (no imports, no
+ * closures), so its source can be handed to `page.evaluate`:
+ *
+ *   import { BROKEN_WORDS_SOURCE } from "@bitbaum/chatkit/audit";
+ *   const broken = await page.evaluate(`(${BROKEN_WORDS_SOURCE})(document.body)`);
+ *   if (broken.length) throw new Error(`words cut across lines: ${broken}`);
+ *
+ * Why it exists: Substrata's answer table at 390px read "Te / rm" and
+ * "Di / re / ct / or / y" (2026-10-22). Reading the CSS finds none of it; only
+ * laying the words out does.
+ */
+/**
+ * Every word under `root` that is drawn across two lines. A word may wrap onto
+ * the next line; it may never be cut in two. Measured, not inferred: each word
+ * is laid out in a `Range` and must sit on one line.
+ *
+ * Exempt, because a break there is legal: a word beside a hyphen, slash, dot,
+ * at-sign, colon or underscore, and anything over `maxWord` characters (a URL
+ * or an identifier has to break somewhere). Hidden text has no boxes and is
+ * skipped.
+ */
+export function findBrokenWords(root = document, options = {}) {
+    const maxWord = options.maxWord ?? 24;
+    const found = [];
+    const near = /[-‐‑–—/_.@:]/;
+    const walker = document.createTreeWalker(root instanceof Document ? root.body : root, NodeFilter.SHOW_TEXT);
+    for (let n = walker.nextNode(); n; n = walker.nextNode()) {
+        const text = n.nodeValue ?? "";
+        const re = /[\p{L}\p{N}']+/gu;
+        for (let m = re.exec(text); m; m = re.exec(text)) {
+            const word = m[0];
+            if (word.length > maxWord)
+                continue;
+            if (near.test(text[m.index - 1] ?? "") || near.test(text[m.index + word.length] ?? ""))
+                continue;
+            const range = document.createRange();
+            range.setStart(n, m.index);
+            range.setEnd(n, m.index + word.length);
+            const tops = Array.from(range.getClientRects())
+                .filter((r) => r.width > 0)
+                .map((r) => Math.round(r.top));
+            if (tops.length > 1 && Math.max(...tops) - Math.min(...tops) > 6)
+                found.push(word);
+        }
+    }
+    return found;
+}
+/** `findBrokenWords` as source text, for `page.evaluate`. */
+export const BROKEN_WORDS_SOURCE = findBrokenWords.toString();
+//# sourceMappingURL=audit.js.map

package/dist/audit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.js","sourceRoot":"","sources":["../src/audit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAmB,QAAQ,EAC3B,UAAgC,EAAE;IAElC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;IACtC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,IAAI,GAAG,cAAc,CAAC;IAC5B,MAAM,MAAM,GAAG,QAAQ,CAAC,gBAAgB,CACtC,IAAI,YAAY,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAE,IAAa,EACrD,UAAU,CAAC,SAAS,CACrB,CAAC;IACF,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;QACzD,MAAM,IAAI,GAAG,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC;QAC/B,MAAM,EAAE,GAAG,kBAAkB,CAAC;QAC9B,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACjD,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAClB,IAAI,IAAI,CAAC,MAAM,GAAG,OAAO;gBAAE,SAAS;YACpC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;gBACpF,SAAS;YACX,MAAM,KAAK,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;YACrC,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;YAC3B,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;YACvC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC;iBAC5C,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;iBAC1B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACjC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC;gBAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrF,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,6DAA6D;AAC7D,MAAM,CAAC,MAAM,mBAAmB,GAAW,eAAe,CAAC,QAAQ,EAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bitbaum/chatkit",
-  "version": "0.14.1",
+  "version": "0.14.2",
   "description": "One chat for every product: a composer with a microphone that always works, a thread that does not fight the reader, messages with copy and retry, and LLM markdown \u2014 the fleet's chat standard as a package.",
   "license": "MIT",
   "author": "Cato",
@@ -51,6 +51,10 @@
       "types": "./dist/react/index.d.ts",
       "default": "./dist/react/index.js"
     },
+    "./audit": {
+      "types": "./dist/audit.d.ts",
+      "default": "./dist/audit.js"
+    },
     "./attach": {
       "types": "./dist/react/attach.d.ts",
       "default": "./dist/react/attach.js"