@miaskiewicz/turbo-dom 0.7.0 → 0.8.0

package/Cargo.lock

@@ -2791,7 +2791,7 @@ dependencies = [
 
 [[package]]
 name = "turbo-dom"
-version = "0.7.0"
+version = "0.8.0"
 dependencies = [
  "cssparser",
  "html5ever",
@@ -2807,7 +2807,7 @@ dependencies = [
 
 [[package]]
 name = "turbo-dom-browser-env"
-version = "0.7.0"
+version = "0.8.0"
 dependencies = [
  "cssparser",
  "lightningcss",
@@ -2825,7 +2825,7 @@ dependencies = [
 
 [[package]]
 name = "turbo-dom-layout"
-version = "0.7.0"
+version = "0.8.0"
 dependencies = [
  "core-foundation",
  "core-text",
@@ -2849,7 +2849,7 @@ dependencies = [
 
 [[package]]
 name = "turbo-dom-parser"
-version = "0.7.0"
+version = "0.8.0"
 dependencies = [
  "html5ever",
  "markup5ever_rcdom",
@@ -2865,7 +2865,7 @@ dependencies = [
 
 [[package]]
 name = "turbo-dom-raster"
-version = "0.7.0"
+version = "0.8.0"
 dependencies = [
  "base64",
  "core-foundation",
@@ -2888,8 +2888,8 @@ dependencies = [
 
 [[package]]
 name = "turbo-dom-v8"
-version = "150.4.0"
-source = "git+https://github.com/miaskiewicz/turbo-dom?rev=e9b36c8733ef1cf1073f7053a8c5931381c978c5#e9b36c8733ef1cf1073f7053a8c5931381c978c5"
+version = "150.4.1"
+source = "git+https://github.com/miaskiewicz/turbo-dom?rev=a673f79e22006b85315670493800418932f2df31#a673f79e22006b85315670493800418932f2df31"
 dependencies = [
  "bindgen",
  "bitflags 2.12.1",

package/Cargo.toml

@@ -43,7 +43,7 @@ manual_midpoint = "allow"
 
 [package]
 name = "turbo-dom-parser"
-version = "0.7.0"
+version = "0.8.0"
 edition = "2021"
 description = "html5ever-backed native parser for turbo-dom (Layer 1)"
 # Ships to npm only (napi/wasm addon); never published to crates.io.
@@ -114,8 +114,10 @@ opt-level = 3
 inherits = "release"
 debug = true
 
-# Pre-publish only: resolve the generated turbo-dom-v8 fork from its candidate branch
-# (crates/turbo-dom-v8/scripts/push-candidate.sh). Remove once turbo-dom-v8 150.4.0 is
-# on crates.io (see PUBLISHING.md).
+# Pre-publish only: resolve the unpublished turbo-dom-v8 150.4.1 (pins.json) from its
+# candidate branch (crates/turbo-dom-v8/scripts/push-candidate.sh prints the rev). crates.io
+# has 150.4.0; publish.yml publishes 150.4.1 first and then drops this table and re-locks
+# from crates.io (`scripts/publish-crates.py drop-v8-patch`, PUBLISHING.md). Re-point it
+# after every reviewed fork change; check-versions.py asserts the locked version.
 [patch.crates-io]
-turbo-dom-v8 = { git = "https://github.com/miaskiewicz/turbo-dom", rev = "e9b36c8733ef1cf1073f7053a8c5931381c978c5" }
+turbo-dom-v8 = { git = "https://github.com/miaskiewicz/turbo-dom", rev = "a673f79e22006b85315670493800418932f2df31" }

package/README.md

@@ -1,11 +1,13 @@
 # turbo-dom
 
-Release **0.7.0**. turbo-dom is the shared browser-engine base of three projects:
+Release **0.8.0**. turbo-dom is the shared browser-engine base of three projects:
 
 - **[turbo-test](https://github.com/miaskiewicz/turbo-test)**, a vitest-compatible test runner. It runs tests in V8 over this repository's DOM.
 - **[turbo-html2pdf](https://github.com/miaskiewicz/turbo-html2pdf)**, which renders HTML to PDF and uses this repository's layout engine.
 - **[turbo-surf](https://github.com/miaskiewicz/turbo-surf)**, a headless browser that uses the DOM, the V8 binding, the layout engine and the screenshot painter.
 
+> Agents: start at [docs/AGENTS.md](docs/AGENTS.md) for the one-command workflows in `scripts/agent/`.
+
 turbo-dom is also a standalone npm package: a fast, spec-correct DOM environment for
 **vitest** and **jest**, usable in place of jsdom or happy-dom.
 
@@ -24,7 +26,7 @@ and the publish order.
 | [`turbo-dom-layout`](crates/turbo-dom-layout) | crates.io | 0.7.0 | HTML/CSS layout (block / inline / flex / grid / table), fonts, images, CSSOM-View geometry | turbo-html2pdf, turbo-surf |
 | [`turbo-dom-raster`](crates/turbo-dom-raster) | crates.io | 0.7.0 | synthetic screenshots (PNG / SVG), canvas op-log replay, WebGL readback | turbo-surf |
 | [`turbo-dom-browser-env`](crates/turbo-dom-browser-env) | crates.io | 0.7.0 | the `rtdom` <-> V8 browser environment (window, document, CSSOM, forms, events) | turbo-test, turbo-surf |
-| [`turbo-dom-v8`](crates/turbo-dom-v8) | crates.io | 150.4.0 | turbo-dom's rusty_v8 fork, generated from the upstream crate plus reviewed patches | turbo-dom-browser-env, turbo-surf |
+| [`turbo-dom-v8`](crates/turbo-dom-v8) | crates.io | 150.4.1 | turbo-dom's rusty_v8 fork, generated from the upstream crate plus reviewed patches | turbo-dom-browser-env, turbo-surf |
 
 The root `turbo-dom-parser` crate is `publish = false`. It ships inside the npm package.
 
@@ -105,10 +107,10 @@ parseBuffer, parseFragment })` or set it as `globalThis.__TURBO_DOM_PARSER__`. T
 
 ```toml
 [dependencies]
-turbo-dom = "0.7"
-turbo-dom-layout = "0.7"                 # bundled fonts on by default
-turbo-dom-raster = "0.7"
-turbo-dom-browser-env = "0.7"            # needs a V8 archive, see its README
+turbo-dom = "0.8"
+turbo-dom-layout = "0.8"                 # bundled fonts on by default
+turbo-dom-raster = "0.8"
+turbo-dom-browser-env = "0.8"            # needs a V8 archive, see its README
 ```
 
 ```rust
@@ -134,6 +136,7 @@ Each crate's README covers its API: [turbo-dom](crates/turbo-dom/README.md),
 |---|---|---|---|
 | `turbo-dom-layout` | `bundled-fonts` | on | embeds OFL faces (Inter/Roboto, Liberation Serif/PT Serif, Fira Code/IBM Plex Mono) so a document lays out with no caller fonts |
 | | `hyphenation` | on | `hyphens: auto` for English (`en` / `en-*`, not en-GB) with the embedded en-US TeX patterns (~90 KB); off, `auto` acts as `manual` |
+| | `hyphenation-languages` | on | `hyphens: auto` in every other language Chrome 156 on macOS hyphenates (en-GB, ca, cs, da, de, el, es, fi, fr, hr, hu, it, nb / no, nl, pl, pt, ro, ru, sk, sv, uk) with the TeX patterns (~3 MB, all of the `hyphenation` crate's); implies `hyphenation` |
 | | `svg` | off | routes `image/svg+xml` through the SVG rasterizer in the image pipeline (implies `svg-rasterize`) |
 | | `svg-rasterize` | off | the shared resvg rasterizer only (`svg::rasterize`) |
 | | `serde` | off | `Serialize` for the CSSOM-View metrics records |
@@ -170,8 +173,10 @@ upstream rusty_v8's features (for example `simdutf`).
 - **Open gaps (tracked as issues):**
   - glyph stems in raster screenshots lack Chrome's stem darkening, so glyph edges are
     up to ~0.5px thinner per side (#266).
-  - Known difference, not tracked: `hyphens: auto` covers English only, and Chrome on
-    macOS hyphenates with the system dictionary, whose points differ for some words.
+  - Known difference, not tracked: `hyphens: auto` breaks at the TeX patterns' points
+    (what Chrome uses on Linux, Windows and Android); Chrome on macOS hyphenates with the
+    system dictionary, whose points differ for a few words (en `international`, pl
+    `szczególnie`; `tests/fixtures/hyphens/words-chrome156.json` lists them).
 - **The npm runtime has no layout.** Geometry is synthetic: `getBoundingClientRect()`,
   `offsetWidth/Height`, `clientWidth/Height` and `scrollWidth/Height` return a non-zero
   size that is stable for a given DOM state (blocks fill the parent's width, the root

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miaskiewicz/turbo-dom",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Faster, more spec-correct DOM for test runners \u2014 native html5ever (Rust/WASM) parser + lazy copy-on-write DOM. A drop-in-style alternative to jsdom/happy-dom for vitest & jest.",
   "license": "MIT",
   "main": "index.js",

package/pkg/package.json

@@ -1,7 +1,7 @@
 {
   "name": "turbo-dom-parser",
   "description": "html5ever-backed native parser for turbo-dom (Layer 1)",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "files": [
     "turbo_dom_parser_bg.wasm",
     "turbo_dom_parser.js",
@@ -9,4 +9,4 @@
   ],
   "main": "turbo_dom_parser.js",
   "types": "turbo_dom_parser.d.ts"
-}
+}

package/pkg-web/package.json

@@ -2,7 +2,7 @@
   "name": "turbo-dom-parser",
   "type": "module",
   "description": "html5ever-backed native parser for turbo-dom (Layer 1)",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "files": [
     "turbo_dom_parser_bg.wasm",
     "turbo_dom_parser.js",
@@ -13,4 +13,4 @@
   "sideEffects": [
     "./snippets/*"
   ]
-}
+}

package/src/runtime/cascade.mjs

@@ -45,25 +45,31 @@ const BORDER_STYLES = new Set(['none', 'hidden', 'dotted', 'dashed', 'solid', 'd
 // declarations of the same longhand override naturally (cascade order preserved).
 function setProp(map, name, val) {
   map.set(name, val);
-  if (name === 'margin' || name === 'padding') {
-    const t = val.trim().split(/\s+/);
-    const top = t[0], right = t[1] ?? top, bottom = t[2] ?? top, left = t[3] ?? right;
-    map.set(name + '-top', top); map.set(name + '-right', right);
-    map.set(name + '-bottom', bottom); map.set(name + '-left', left);
-  } else if (name === 'border') {
-    let width, style, color;
-    for (const p of val.trim().split(/\s+/)) {
-      if (BORDER_STYLES.has(p)) style = p;
-      else if (/^(thin|medium|thick)$/.test(p) || /^[\d.]+(px|em|rem|%|pt|vh|vw)?$/.test(p)) width = p;
-      else color = p;
-    }
-    if (width !== undefined) { map.set('border-width', width); for (const s of ['top', 'right', 'bottom', 'left']) map.set(`border-${s}-width`, width); }
-    if (style !== undefined) map.set('border-style', style);
-    if (color !== undefined) map.set('border-color', color);
-  } else if (name === 'background' && !/\s/.test(val.trim())) {
+  if (name === 'margin' || name === 'padding') setBoxSides(map, name, val);
+  else if (name === 'border') setBorder(map, val);
+  else if (name === 'background' && !/\s/.test(val.trim())) {
     map.set('background-color', val.trim());
   }
 }
+// `margin` / `padding`: the 1–4 value side expansion.
+function setBoxSides(map, name, val) {
+  const t = val.trim().split(/\s+/);
+  const top = t[0], right = t[1] ?? top, bottom = t[2] ?? top, left = t[3] ?? right;
+  map.set(name + '-top', top); map.set(name + '-right', right);
+  map.set(name + '-bottom', bottom); map.set(name + '-left', left);
+}
+// `border`: width / style / color by the shape of each value.
+function setBorder(map, val) {
+  let width, style, color;
+  for (const p of val.trim().split(/\s+/)) {
+    if (BORDER_STYLES.has(p)) style = p;
+    else if (/^(thin|medium|thick)$/.test(p) || /^[\d.]+(px|em|rem|%|pt|vh|vw)?$/.test(p)) width = p;
+    else color = p;
+  }
+  if (width !== undefined) { map.set('border-width', width); for (const s of ['top', 'right', 'bottom', 'left']) map.set(`border-${s}-width`, width); }
+  if (style !== undefined) map.set('border-style', style);
+  if (color !== undefined) map.set('border-color', color);
+}
 
 function parseDecls(text, into) {
   const map = into || new Map();
@@ -95,21 +101,30 @@ function parseStylesheet(css, startOrder, rules) {
     if (css[j] === ';') { order++; i = j + 1; continue; }
     if (css[j] === '}') { i = j + 1; continue; }
     const sel = css.slice(i, j).trim();
-    let depth = 1, k = j + 1;
-    while (k < n && depth > 0) { const ch = css[k]; if (ch === '{') depth++; else if (ch === '}') depth--; k++; }
-    if (sel && sel[0] !== '@') {
-      const decls = parseDecls(css.slice(j + 1, k - 1));
-      // the prelude is a selector LIST split at top-level commas only (`:is(a, b)` stays
-      // whole); an invalid list drops the whole rule, as in a browser; each item carries its
-      // Selectors 4 specificity (mirrors rtdom::cascade::parse_stylesheet)
-      if (decls.size) for (const t of ruleSelectors(sel)) {
-        rules.push({ selector: t, decls, spec: specificity(t), order: order++ });
-      }
-    } else { order++; }
+    const k = blockEnd(css, j + 1);
+    if (sel && sel[0] !== '@') order = pushRules(sel, parseDecls(css.slice(j + 1, k - 1)), order, rules);
+    else order++;
     i = k;
   }
   return order;
 }
+// The index just past the `}` closing the block whose body starts at `k` (the input's
+// end when unclosed).
+function blockEnd(css, k) {
+  let depth = 1;
+  while (k < css.length && depth > 0) { const ch = css[k]; if (ch === '{') depth++; else if (ch === '}') depth--; k++; }
+  return k;
+}
+// The rules of a style rule with prelude `sel`; returns the next source order.
+function pushRules(sel, decls, order, rules) {
+  // the prelude is a selector LIST split at top-level commas only (`:is(a, b)` stays
+  // whole); an invalid list drops the whole rule, as in a browser; each item carries its
+  // Selectors 4 specificity (mirrors rtdom::cascade::parse_stylesheet)
+  if (decls.size) for (const t of ruleSelectors(sel)) {
+    rules.push({ selector: t, decls, spec: specificity(t), order: order++ });
+  }
+  return order;
+}
 
 function buildIndex(scope) {
   // scope is always a Document or ShadowRoot — both expose getElementsByTagName.
@@ -225,6 +240,29 @@ function makeProxy(map, v) {
   });
 }
 
+// Encapsulation: an element inside a shadow tree resolves against that shadow root's own
+// <style> rules, not the document's (and vice-versa). Gated on __hasShadow so the
+// no-shadow path keeps resolving against doc.
+function styleScope(doc, el) {
+  if (!doc.__hasShadow) return doc;
+  const root = el.getRootNode && el.getRootNode();
+  return root && root.__isShadowRoot ? root : doc;
+}
+// The shadow overlays (only once the document has a shadow root).
+function collectShadowMatched(el, v, matched) {
+  // shadow host: overlay :host rules from its OWN shadow root's stylesheet
+  if (el.__shadow) collectMatched(el, getIndex(el.__shadow, v), 'host', matched);
+  // slotted light node: overlay ::slotted rules from the slot's shadow root
+  const slot = el.assignedSlot;
+  if (slot) { const sr = slot.getRootNode(); if (sr.__isShadowRoot) collectMatched(el, getIndex(sr, v), 'slotted', matched, slot); }
+}
+// The unset INHERITED properties of `map` from the parent's computed style `ps`.
+function inheritFrom(map, ps) {
+  for (const prop of INHERITED) {
+    if (!map.has(prop)) { const pv = ps.getPropertyValue(prop); if (pv) map.set(prop, pv); }
+  }
+}
+
 // getComputedStyle(el): resolves cascade, memoized per element on the current
 // Document.__version (any style/DOM mutation bumps it → cache auto-invalidates).
 export function makeGetComputedStyle() {
@@ -238,24 +276,9 @@ export function makeGetComputedStyle() {
     const map = new Map();
     if (!doc) { const p = makeProxy(map, v); el.__computedStyle = p; return p; }
 
-    // Encapsulation: an element inside a shadow tree resolves against that
-    // shadow root's own <style> rules, not the document's (and vice-versa).
-    // Gated on __hasShadow so the no-shadow path keeps resolving against doc.
-    let scope = doc, inShadow = false;
-    if (doc.__hasShadow) {
-      const root = el.getRootNode && el.getRootNode();
-      if (root && root.__isShadowRoot) { scope = root; inShadow = true; }
-    }
-
     const matched = [];
-    collectMatched(el, getIndex(scope, v), 'normal', matched);
-    if (doc.__hasShadow) {
-      // shadow host: overlay :host rules from its OWN shadow root's stylesheet
-      if (el.__shadow) collectMatched(el, getIndex(el.__shadow, v), 'host', matched);
-      // slotted light node: overlay ::slotted rules from the slot's shadow root
-      const slot = el.assignedSlot;
-      if (slot) { const sr = slot.getRootNode(); if (sr.__isShadowRoot) collectMatched(el, getIndex(sr, v), 'slotted', matched, slot); }
-    }
+    collectMatched(el, getIndex(styleScope(doc, el), v), 'normal', matched);
+    if (doc.__hasShadow) collectShadowMatched(el, v, matched);
     applyMatched(matched, map);
 
     // inline style wins over stylesheet rules
@@ -268,17 +291,10 @@ export function makeGetComputedStyle() {
     // shadow content. Honest partial: only the curated INHERITED set inherits, only
     // from values a REAL rule/inline actually set (pv truthy) — never an initial
     // value. Recursion is memoized per element/version and terminates at the root
-    // (flattenedParent → null). Test-time only; hot paths never call gcs.
-    // `inShadow` is unused now that light-DOM inherits too, but the flattened-parent
-    // hop still crosses the host boundary correctly for shadow content.
-    void inShadow;
+    // (flattenedParent → null). Test-time only; hot paths never call gcs. The
+    // flattened-parent hop crosses the host boundary for shadow content.
     const parent = flattenedParent(el);
-    if (parent) {
-      const ps = gcs(parent);
-      for (const prop of INHERITED) {
-        if (!map.has(prop)) { const pv = ps.getPropertyValue(prop); if (pv) map.set(prop, pv); }
-      }
-    }
+    if (parent) inheritFrom(map, gcs(parent));
 
     const proxy = makeProxy(map, v);
     el.__computedStyle = proxy;