xbintsc 0.5.37 → 0.5.41

package/dist/tests/extensions/gui.test.js

@@ -81,18 +81,44 @@ describe("gui .html asset loader", () => {
         expect(htmlOf(moduleSource)).toContain(`<script data-xt-id="${id}"></script>`);
         expect(parseDiagnostics(moduleSource)).toBe(0);
     });
-    it("hoists imports from an external script, rewriting them from the HTML dir", () => {
+    it("defers a relative import and rewrites it from the HTML dir", () => {
         const directory = writeFiles({
             "scripts/app.ts": 'import { size } from "../lib/util";\nconsole.log(size);',
             "lib/util.ts": "export const size = 1;",
         });
         const htmlPath = join(directory, "page.html");
         const { moduleSource } = loadHtmlAsset(htmlPath, `<script src="./scripts/app.ts"></script>`);
-        expect(moduleSource).toContain('import { size } from "./lib/util"');
+        /* The loader marks the module, and the generated script loads it at run
+         * time instead of hoisting an eager import. */
+        expect(moduleSource).toContain('import { __xt_deferred_module as __xt_deferred_0_0 } from "./lib/util"');
+        expect(moduleSource).toContain("const { size } = __xt_deferred_0_0();");
         expect(moduleSource).toContain("console.log(size);");
         expect(moduleSource).not.toContain("../lib/util");
         expect(parseDiagnostics(moduleSource)).toBe(0);
     });
+    it("keeps a CRLF external script intact when hoisting its imports", () => {
+        /* The parser indexes newline-normalized text, so masking the raw file would
+         * blank the wrong spans and leave fragments like "js';" in the body. */
+        const directory = writeFiles({
+            "app.ts": "import { size } from './util';\r\n\r\nconst label = 'ready';\r\nconsole.log(size, label);\r\n",
+            "util.ts": "export const size = 1;",
+        });
+        const htmlPath = join(directory, "page.html");
+        const { moduleSource, sourceRanges } = loadHtmlAsset(htmlPath, `<html>\r\n<body>\r\n<script src="./app.ts"></script>\r\n</body>\r\n</html>`);
+        expect(moduleSource).toContain("console.log(size, label);");
+        expect(moduleSource).toContain("const label = 'ready';");
+        expect(moduleSource.match(/js';/g)).toBeNull();
+        const html = htmlOf(moduleSource);
+        expect(html).not.toContain("\r");
+        expect(html).toContain("<body>");
+        expect(sourceRanges).toHaveLength(1);
+        const range = sourceRanges[0];
+        const body = moduleSource.slice(range.start, range.end);
+        expect(body).toContain("const label = 'ready';");
+        expect(body).toContain("console.log(size, label);");
+        expect(body).not.toContain("import {");
+        expect(parseDiagnostics(moduleSource)).toBe(0);
+    });
     it("strips export modifiers from an external script", () => {
         const directory = writeFiles({
             "app.ts": "export const a = 1;\nexport function f() { return a; }",
@@ -107,7 +133,9 @@ describe("gui .html asset loader", () => {
         const directory = writeFiles({ "page.html": "" });
         expect(() => loadHtmlAsset(join(directory, "page.html"), `<script src="./missing.ts"></script>`)).toThrow(/not found/);
     });
-    it("rejects colliding imported bindings across external scripts", () => {
+    it("keeps deferred bindings local to each external script", () => {
+        /* Two scripts may import the same name: each prelude destructures into its
+         * own script function, so there is no module-scope collision. */
         const directory = writeFiles({
             "a.ts": 'import { x } from "./x";\nconsole.log(x);',
             "b.ts": 'import { x } from "./y";\nconsole.log(x);',
@@ -115,7 +143,10 @@ describe("gui .html asset loader", () => {
             "y.ts": "export const x = 2;",
         });
         const htmlPath = join(directory, "page.html");
-        expect(() => loadHtmlAsset(htmlPath, `<script src="./a.ts"></script><script src="./b.ts"></script>`)).toThrow(/already imported/);
+        const { moduleSource } = loadHtmlAsset(htmlPath, `<script src="./a.ts"></script><script src="./b.ts"></script>`);
+        expect(moduleSource).toContain("__xt_deferred_0_0");
+        expect(moduleSource).toContain("__xt_deferred_1_0");
+        expect(parseDiagnostics(moduleSource)).toBe(0);
     });
     it("emits only the HTML string when there are no scripts", () => {
         const { moduleSource } = loadHtmlAsset("page.html", "<h1>hi</h1>");
@@ -129,7 +160,7 @@ describe("gui .html asset loader", () => {
         expect(moduleSource.indexOf(hashString(first))).toBeLessThan(moduleSource.indexOf(hashString(second)));
         expect(parseDiagnostics(moduleSource)).toBe(0);
     });
-    it("hoists namespace, side-effect and re-export statements", () => {
+    it("defers namespace, side-effect and re-export statements", () => {
         const directory = writeFiles({
             "app.ts": [
                 'import * as util from "./util";',
@@ -146,11 +177,15 @@ describe("gui .html asset loader", () => {
         });
         const htmlPath = join(directory, "page.html");
         const { moduleSource } = loadHtmlAsset(htmlPath, `<script src="./app.ts"></script>`);
-        expect(moduleSource).toContain('import * as util from "./util"');
-        expect(moduleSource).toContain('import {} from "./side-effect"');
-        expect(moduleSource).toContain('import defaultExport, { named } from "./mixed"');
-        expect(moduleSource).toContain('export { x } from "./x"');
-        expect(moduleSource).toContain('export * from "./y"');
+        expect(moduleSource).toContain('from "./util"');
+        expect(moduleSource).toContain('from "./side-effect"');
+        expect(moduleSource).toContain('from "./mixed"');
+        expect(moduleSource).toContain("const util = __xt_deferred_0_0();");
+        expect(moduleSource).toContain("__xt_deferred_0_1();");
+        expect(moduleSource).toContain("const defaultExport = __xt_deferred_0_2().default;");
+        expect(moduleSource).toContain("const { named } = __xt_deferred_0_2();");
+        expect(moduleSource).toContain("__xt_deferred_0_3();");
+        expect(moduleSource).toContain("__xt_deferred_0_4();");
         /* The local `export { a }` and `export default` are blanked out. */
         expect(moduleSource).not.toContain("export default 42");
         expect(moduleSource).not.toContain("export default function");

package/dist/tests/extensions/gui.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"gui.test.js","sourceRoot":"","sources":["../../../tests/extensions/gui.test.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"gui.test.js","sourceRoot":"","sources":["../../../tests/extensions/gui.test.ts"],"names":[],"mappings":"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"}

package/doc/gui/api.md

@@ -94,8 +94,9 @@ requestAnimationFrame(frame);
 | `Event`, `CustomEvent`, `ProgressEvent`, `MouseEvent`, `KeyboardEvent`, `PointerEvent`, `WheelEvent`, `FocusEvent`, `InputEvent`, `SubmitEvent` | event constructors; the `init` argument is kept as given (`detail`, `composed`, mouse/keyboard fields, …) |
 | `AbortController`, `AbortSignal` | a real controller/signal pair for `{ signal }` listener removal, with `abort()`, `aborted`, `reason`, `onabort` and `throwIfAborted()` |
 | `HTMLCanvasElement`, `HTMLImageElement`, `WebGLRenderingContext`, `WebGL2RenderingContext`, `WebGLBuffer`/`WebGLTexture`/`WebGLShader`/`WebGLProgram`/`WebGLFramebuffer`/`WebGLRenderbuffer`/`WebGLUniformLocation`/`WebGLActiveInfo`/`WebGLVertexArrayObject`/`WebGLSampler`/`WebGLQuery`/`WebGLSync`/`WebGLTransformFeedback` | real constructor values. `canvas.getContext("webgl")` and `getContext("webgl2")` return GPU contexts (see [WebGL](./webgl.md)). |
-| `ImageBitmap`, `createImageBitmap(source)` | immutable bitmaps backed by decoded pixels (`<img>`, `<canvas>`, `<video>` frames and `ImageData` shapes); the promise resolves immediately and `texImage2D` accepts the result |
-| `ImageData`, `OffscreenCanvas`, `XRWebGL*`, `Request`, `Headers`, `Response`, `ReadableStream`, `DOMParser` | `typeof` probes answer `"undefined"` (no XR/fetch/streaming backend), which lets a page take its "unsupported" branch instead of calling a no-op stub. Three.js pages use its real renderer on this backend (see [Known issues](./known-issues.md)). |
+| `ImageBitmap`, `createImageBitmap(source)` | immutable bitmaps backed by decoded pixels (`<img>`, `<canvas>`, `<video>` frames, `OffscreenCanvas` and `ImageData` shapes); the promise resolves immediately and `texImage2D` accepts the result |
+| `OffscreenCanvas` | a real 2D offscreen bitmap with `getContext("2d")`, `width`/`height`, `transferToImageBitmap()` and `convertToBlob()`; `canvas.transferControlToOffscreen()` hands an element's bitmap over (see [Canvas](./canvas.md)). There is no offscreen WebGL context. |
+| `ImageData`, `XRWebGL*`, `Request`, `Headers`, `Response`, `ReadableStream`, `DOMParser` | `typeof` probes answer `"undefined"` (no XR/fetch/streaming backend), which lets a page take its "unsupported" branch instead of calling a no-op stub. Three.js pages use its real renderer on this backend (see [Known issues](./known-issues.md)). |
 | `requestAnimationFrame` / `cancelAnimationFrame` | queued on the window's frame list; see [Runtime integration](./runtime.md) |
 | `alert` / `confirm` / `prompt`, `matchMedia`, `getComputedStyle`, `escape` | host implementations. `matchMedia` returns a **live** list (cached per query): `matches` is re-evaluated on resize and `change` listeners fire when it flips. `confirm`/`prompt` use a native dialog only with `XT_GUI_DIALOGS=1`; otherwise they report the message on stderr and return the documented default (Annex B `escape` encodes per UTF-16 code unit, matching `decodeURIComponent(escape(bytes))`) |
 
@@ -211,6 +212,31 @@ steady state every one of them is constant — a climbing `detachedNodes` or
 `handles` means the program removes nodes faster than it releases them (see
 [Node lifetime](./dom.md#node-lifetime)).
 
+The same object reports what the last completed frame did and how much work the
+program has done in total, which is how rendering cost is measured (see
+[Performance](./rendering.md#performance-m20)):
+
+| Field | Meaning |
+| --- | --- |
+| `frameMs`, `restyleMs`, `layoutMs`, `paintMs`, `uploadMs`, `drawMs` | phase timings of the last frame (milliseconds) |
+| `frames`, `presents`, `exposes`, `deferred`, `skippedFrames`, `starvedFrames`, `transitionFrames` | frame loop activity: `presents` counts swapchain frames, `exposes` the presents the window system asked for with an expose/shown/restore event, `deferred` the presents a starved frame postponed, `skippedFrames` the frames nothing needed and `starvedFrames` the frames that asked to present and got no drawable target |
+| `restyles`, `restyleNodes`, `rulesEvaluated`, `mediaEvaluated`, `layouts`, `layoutBoxes` | cascade and layout work |
+| `textShapeCalls`, `textShapeHits`, `textCacheBytes`, `textCacheEntries` | shaping cache misses/hits and its occupancy |
+| `paints`, `paintOps`, `drawRuns`, `drawCalls`, `uploadSubmits`, `vertices`, `syncNodes` | display-list, draw-call and upload work |
+| `canvasDraws`, `canvasUploads`, `canvasUploadBytes` | Canvas 2D draw calls, texture uploads and the bytes copied (a partial redraw uploads only its dirty rectangle) |
+| `webglDraws`, `webglPasses`, `webglPipelineMisses`, `webglBufferUploadBytes` | WebGL draw calls, render passes opened, pipelines created and buffer bytes copied |
+
+Every field except the `*Ms` timings is cumulative, so subtract two snapshots to
+get one frame. `restyleMs` covers the cascade **and** the layout pass it
+triggers (which is also reported on its own as `layoutMs`).
+`presents - exposes - deferred` counts the presents only the page asked for: an
+expose/shown/restore event means the window has no contents and must be redrawn,
+at a time the window server chooses, and a deferred present replays work an
+earlier frame built when no swapchain image was available (`starvedFrames` counts
+those frames — a climbing value means the window is not being updated at all).
+`XT_GUI_PERF=1` prints the same numbers on stderr (one line per frame;
+`XT_GUI_PERF=<N>` averages over N frames).
+
 They are used by `tests/e2e/gui-*.test.ts` to assert parsing, selector matching,
 specificity, inheritance, `!important` and layout geometry. They will stay useful
 afterwards for debugging.

package/doc/gui/canvas.md

@@ -36,6 +36,16 @@ a shared prototype. The handle is cached on the element, so every call returns
 the **same** object and the drawing state (transform, styles, path) is per
 canvas, not per call. `ctx.canvas` is the owning element handle.
 
+`OffscreenCanvas` has the same 2D surface without a DOM element:
+`new OffscreenCanvas(width, height)` allocates a bitmap owned by the window,
+`getContext("2d")` returns a context whose `canvas` is the offscreen object, and
+`canvas.transferControlToOffscreen()` hands a live element's bitmap to one
+(`element.getContext(…)` then answers `null`). `drawImage`, `createPattern`,
+`createImageBitmap` and `texImage2D` accept an `OffscreenCanvas` as a source.
+`transferToImageBitmap()` returns an `ImageBitmap` and `convertToBlob()`
+resolves to the same PNG blob shape as `toBlob` (there is no worker or
+`OffscreenCanvas` WebGL context in this runtime).
+
 `getContext("2d", attributes)` honours `alpha` on the first call: with
 `{ alpha: false }` the bitmap starts (and clears) opaque black. The other
 attributes are reported by `getContextAttributes()` at their specification
@@ -51,7 +61,36 @@ horizontal coverage** pass, and fills paths with the **non-zero winding rule**
 (so `arc`-shaped holes work when wound the other way) unless
 `fill("evenodd")` selects the even-odd rule. An axis-aligned rectangle
 (`b == 0 && c == 0` in the transform) takes a direct coverage fast path.
-Blending is non-premultiplied source-over, scaled by `globalAlpha`.
+Blending uses non-premultiplied source-over by default. `globalCompositeOperation`
+selects the full canvas set: the Porter-Duff operators (`source-over`,
+`source-in`, `source-out`, `source-atop`, `destination-over`,
+`destination-in`, `destination-out`, `destination-atop`, `lighter`, `copy`,
+`xor`) and the separable/non-separable blend modes (`multiply`, `screen`,
+`overlay`, `darken`, `lighten`, `color-dodge`, `color-burn`, `hard-light`,
+`soft-light`, `difference`, `exclusion`, `hue`, `saturation`, `color`,
+`luminosity`). Coverage from anti-aliasing and the clip region interpolates
+between the untouched destination and the composited result, so a partially
+covered pixel is correct for every operator.
+
+`clip()` intersects the current clip region with the current path (or a
+`Path2D` and an optional `"nonzero"`/`"evenodd"` rule). The region is stored as
+a device-space coverage mask, so it follows the transform in effect when
+`clip()` was called; `save`/`restore` restore it and resizing the bitmap clears
+it. Every fill, stroke, text run, image draw and `clearRect` honours the mask.
+
+Shadows (`shadowColor`, `shadowBlur`, `shadowOffsetX`, `shadowOffsetY`) are
+painted from the operation's own alpha: the draw is first rendered into a
+scratch layer, its alpha is offset and box-blurred (three separable passes),
+tinted with `shadowColor`, composited, and the unfiltered layer is drawn over
+it. The offset and blur are in canvas (device) units and are not affected by
+the transform, as the API specifies. `clearRect` and `putImageData` never cast
+a shadow.
+
+`isPointInPath(x, y[, fillRule])`, `isPointInPath(path, x, y[, fillRule])`,
+`isPointInStroke(x, y)` and `isPointInStroke(path, x, y)` hit-test the current
+path (or the supplied `Path2D`) under the current transform; stroke hit testing
+uses the device-space distance to each flattened segment and the current line
+width.
 
 A fill or stroke paints with a solid colour **or a `CanvasGradient`**. Gradient
 coordinates are user-space coordinates, so the rasteriser maps each device pixel
@@ -67,6 +106,33 @@ decode table). It is released when the node is dropped (`loadHTML`, window
 close/quit, or a mutation that discards the subtree), which also releases the
 matching GPU texture.
 
+## Performance
+
+A canvas is redrawn by the script, not by the engine, so its cost is per drawing
+call. With many elements the hot paths are deliberately branch-light:
+
+- a solid, opaque `fillRect` is a byte store into the bitmap (fractional edges
+  still take the anti-aliased path), and `clearRect` over the whole bitmap is a
+  single `memset`;
+- path coverage is rasterised with a per-row **active-edge list**, and only the
+  **covered span of each row** is materialised — a thin diagonal stroke costs
+  its own pixels, not its bounding box;
+- one `stroke()` batches all of its segment quads, joins and caps into a single
+  non-zero fill instead of one coverage pass per piece (each piece's winding is
+  normalised first, so overlapping pieces cover rather than cancel);
+- `fillText` shares the shaped-run cache with layout (`text_cache.cpp`) and uses
+  a bounded two-generation glyph bitmap cache (`text_glyph_cache.cpp`);
+- `drawImage` at integer offsets with no scaling copies one texel per pixel
+  instead of running the bilinear sampler.
+
+The bitmap reaches the screen through a **dirty rectangle**: every draw unions
+its device-space bounds, and the renderer copies only that region into the
+canvas texture. All of a frame's canvas and video uploads share the frame's one
+upload command buffer, so K animated canvases cost one submit rather than K.
+`getImageData` always reads the CPU bitmap, so it is unaffected.
+`tests/e2e/gui-draw-perf.test.ts` measures the multi-element paths and pins the
+counter behaviour (one upload per frame, only the dirty bytes).
+
 ## Supported API
 
 State and transforms: `save` / `restore` (which restore the transform, line
@@ -79,34 +145,43 @@ canvas order: `translate(x, y); rotate(a)` rotates around the translated origin.
 
 Styles and settings: `fillStyle` / `strokeStyle` (CSS colors understood by the
 cascade's color parser, or a `CanvasGradient`), `lineWidth`, `globalAlpha`,
+`globalCompositeOperation`, `shadowColor` / `shadowBlur` / `shadowOffsetX` /
+`shadowOffsetY`, `imageSmoothingEnabled` / `imageSmoothingQuality`,
 `lineCap` (`butt`/`round`/`square`), `lineJoin` (`miter`/`round`/`bevel`),
 `miterLimit`, `lineDashOffset`, `font` (a CSS font shorthand resolving to
 family, size and bold/italic — default `10px sans-serif`), `textAlign`
 (`start`/`left`, `center`, `right`/`end`) and `textBaseline` (`alphabetic`,
 `top`, `middle`, `bottom`, `hanging`, `ideographic`). Reading a property returns
 the value last assigned; assigning an unparseable color keeps the previous one.
+`imageSmoothingEnabled` defaults to `true` (bilinear sampling);
+`imageSmoothingQuality` reports `low`, `medium` or `high` and selects the same
+bilinear filter in this backend.
 
 Gradients: `createLinearGradient(x0, y0, x1, y1)` and
 `createRadialGradient(x0, y0, r0, x1, y1, r1)` return a `CanvasGradient` with
 `addColorStop(offset, color)`. Stops stay live, so a stop added after
 `fillStyle = gradient` affects later fills, and the `fillStyle`/`strokeStyle`
-getter returns the same gradient handle. Radial gradients interpolate by
-distance from the **outer** circle's centre (`x1, y1`), so `x0`/`y0` are
-currently ignored: use concentric circles (`x0 == x1`, `y0 == y1`).
+getter returns the same gradient handle. A radial gradient is the general
+two-circle cone: the colour at a point is resolved from the interpolated circle
+(`centre = c0 + t·(c1 − c0)`, `radius = r0 + t·(r1 − r0)`), so an offset inner
+circle and different radii behave like a browser's. A point inside the inner
+circle samples stop 0.
 
 Paths: `beginPath`, `closePath`, `moveTo`, `lineTo`, `rect`, `roundRect`,
 `arc`, `ellipse`, `quadraticCurveTo`, `bezierCurveTo`, then
 `fill(fillRule?)` / `fill(path, fillRule?)` (multi-loop; `"nonzero"` or
-`"evenodd"`) or `stroke(path?)`. Bezier and quadratic segments are flattened
-into line segments; arcs and ellipses are flattened too. `roundRect` accepts a
-single radius number or the CSS radius list (`[all]`, `[tl, br]`,
+`"evenodd"`), `stroke(path?)`, `clip(path?, fillRule?)` and the
+`isPointInPath`/`isPointInStroke` hit tests. Bezier and quadratic segments are
+flattened into line segments; arcs and ellipses are flattened too. `roundRect`
+accepts a single radius number or the CSS radius list (`[all]`, `[tl, br]`,
 `[tl, tr, br]`, `[tl, tr, br, bl]`, numbers or `{ x, y }` pairs; corners are
 drawn circular).
 
 `Path2D` is implemented with the same path commands (`moveTo`, `lineTo`,
 `closePath`, `rect`, `roundRect`, `arc`, `ellipse`, `quadraticCurveTo`,
-`bezierCurveTo`, `addPath`) and can be passed to `fill`/`stroke`, so a path can
-be built once and replayed under different transforms.
+`bezierCurveTo`, `addPath`) and can be passed to `fill`/`stroke`/`clip` and the
+`isPointIn*` hit tests, so a path can be built once and replayed under different
+transforms.
 
 Rectangles: `clearRect`, `fillRect`, `strokeRect`.
 
@@ -129,35 +204,43 @@ Images: `drawImage(source, …)` in the 3-argument (`dx, dy`), 5-argument
 (`dx, dy, dw, dh`) and 9-argument (`dx, dy, dw, dh, sx, sy, sw, sh`; this
 engine's 9-argument form is destination-first) forms. A full affine transform
 (rotation/skew/scale) is honoured: the destination rectangle becomes a
-parallelogram and every device pixel is inverse-mapped to the source rectangle
-(nearest-neighbour). `source` may be an `<img>` element (decoded through the image module) or another
-`<canvas>` element (its current bitmap). Sampling is nearest-neighbour, so a
-large upscale of a small source is blocky — fine for icons and pixel art, not a
-photo pipeline.
+parallelogram and every device pixel is inverse-mapped to the source rectangle.
+`source` may be an `<img>` element (decoded through the image module), another
+`<canvas>`, an `OffscreenCanvas`, or an `ImageBitmap`. Sampling is bilinear when
+`imageSmoothingEnabled` is `true` (the default) and nearest-neighbour when it is
+`false`.
 
 Test hook: `getImageData(x, y, w, h)` copies a region to
 `{ width, height, data }` where `data` is a row-major RGBA8 byte array.
 Out-of-bounds pixels are transparent.
 
-Patterns: `createPattern(source, repetition?)` accepts an `<img>` or another
-`<canvas>` and tiles it in user space (`repeat`, `repeat-x`, `repeat-y`,
-`no-repeat`), so the tiles follow the current transform. Assign the result to
-`fillStyle`/`strokeStyle`; assigning a colour replaces it.
+Patterns: `createPattern(source, repetition?)` accepts an `<img>`,
+`<canvas>`, `OffscreenCanvas` or `ImageBitmap` and tiles it in user space
+(`repeat`, `repeat-x`, `repeat-y`, `no-repeat`), so the tiles follow the
+current transform. Assign the result to `fillStyle`/`strokeStyle`; assigning a
+colour replaces it.
 
 Image data and export: `createImageData(width, height)` allocates a blank
 `{ width, height, data }`, and `putImageData(imageData, dx, dy[, dirtyX, dirtyY,
 dirtyWidth, dirtyHeight])` copies bytes straight into the bitmap (no transform,
-blending or `globalAlpha`). `canvas.toDataURL(type?)` exports a PNG data URL and
-`canvas.toBlob(callback, type?)` delivers a Blob-shaped `{ type, size }` from a
-microtask (the bytes are on `__xt_gui_blob_data`; there is no
-`URL.createObjectURL`).
+blending, clip or `globalAlpha`). `canvas.toDataURL(type?)` exports a PNG data
+URL and `canvas.toBlob(callback, type?)` delivers a Blob-shaped `{ type, size }`
+from a microtask (the bytes are on `__xt_gui_blob_data`; there is no
+`URL.createObjectURL`). `OffscreenCanvas.convertToBlob()` resolves to the same
+shape and `transferToImageBitmap()` snapshots the bitmap.
+
+CSS backgrounds: `background-image: url(...)` accepts a file path or a `data:`
+URL, so a canvas can be used as a CSS background by exporting it first
+(`element.style.backgroundImage = "url(" + canvas.toDataURL() + ")"`). An image
+layer is stretched to the element's border box; `background-size`,
+`background-position` and tiling are not modelled.
 
 ## Not implemented
 
-Shadows, `clip()`, `globalCompositeOperation`, `isPointInPath`, `drawImage` with
-an image smoothing toggle, `<canvas>` as a CSS `background-image`, and offscreen
-canvases (`OffscreenCanvas`, `transferControlToOffscreen`).
-Radial gradients ignore the inner circle's offset.
-
+Smoothing quality has one filter (bilinear) on this backend. Offscreen canvases
+support the 2D context only (a WebGL context needs a DOM element for its
+texture table). Text under a rotated or skewed transform places glyphs on the
+transformed baseline but does not rotate the glyph bitmaps, and `strokeText`
+fills with the stroke style rather than outlining.
 See also [Media](./media.md) for the image/video/audio decode stack that
 `drawImage` and the texture upload share.

package/doc/gui/known-issues.md

@@ -11,16 +11,17 @@
   glslang — consumed directly by the Vulkan backend, or cross-compiled to MSL by
   the bundled SPIRV-Cross for Metal — and the drawing buffer is an offscreen
   colour texture that the page composites without a readback. WebGL 2 adds VAOs,
-  instancing, integer attributes, sampler objects, `texStorage2D` and buffer
-  copies. Uniform blocks, transform feedback, cube maps, 3D textures,
-  float/depth textures, compressed textures, multiple render targets,
-  `blitFramebuffer`, MSAA and stencil operations are not implemented; `clear`
-  ignores the scissor rectangle. On an SDL_GPU backend that accepts neither
-  SPIR-V nor MSL (Direct3D 12, which would need DXIL) both context kinds are
-  `null`. The `.js` asset loader now patches only three.js's shader unroller;
-  `WebGLRenderer` runs on the real backend and there is no Canvas2D fallback.
-  Shadow maps (depth textures), cube textures/environment maps and HDR render
-  targets remain unsupported.
+  instancing, integer attributes, sampler objects, `texStorage2D`, buffer copies,
+  uniform blocks, cube/3D/array textures, float/depth/compressed textures,
+  multiple render targets and scissored clears. `blitFramebuffer` copies colour
+  and depth; transform feedback, MSAA and stencil blits are not implemented
+  (SDL_GPU has no transform-feedback stage, its Metal multisample resolve is
+  unreliable, and a stencil attachment is not sampleable). On an SDL_GPU backend
+  that accepts neither SPIR-V nor MSL (Direct3D 12, which would need DXIL) both
+  context kinds are `null`. The `.js` asset loader now patches only three.js's
+  shader unroller; `WebGLRenderer` runs on the real backend and there is no
+  Canvas2D fallback. Shadow maps (comparative `sampler2DShadow` targeting depth
+  textures), cube textures/environment maps and HDR render targets are supported.
 
 
 
@@ -80,6 +81,27 @@
   not CSS properties here). Vector art that needs those has to be rasterised
   beforehand, drawn from boxes, or restricted to the supported syntax. See
   [Media](./media.md#images-m6a).
+- **Rendering is still whole-document per change.** A DOM mutation recomputes
+  the cascade and lays out the complete document again (there is no incremental
+  subtree invalidation), and a change that only affects paint (a hover colour,
+  for example) reflows too. Documents with generated content
+  (`::before`/`::after`) are not special-cased. The measured cost of each stage
+  is exposed by `win.stats()`/`XT_GUI_PERF`, which is what a follow-up would be
+  keyed off; see [Performance](./rendering.md#performance-m20).
+- **Draw calls follow painter order.** Runs only merge when they are
+  consecutive in painter order and share pipeline, clip and texture, so a list
+  whose rows alternate a background and text costs one shape run and one text
+  run per row (`drawCalls` in `win.stats()`). Reordering for fewer draw calls
+  needs an overlap-aware batcher (text may be covered by a later background) and
+  is not implemented. Measured: the 200-row perf page issues 400 draw calls and
+  spends about 0.4 ms in the draw phase, so this is a follow-up for
+  draw-call-dominated pages rather than the current bottleneck.
+- **The text shaping cache is bounded.** Two generations of up to 2 MiB of
+  glyphs / 8,192 entries hold `(face, text) -> glyphs`. A document with more
+  distinct words than that re-shapes some of them after a cache rotation;
+  `textCacheBytes`/`textShapeHits` in `win.stats()` show whether it is the
+  bottleneck. Inline `style="…"` attributes are re-parsed on each restyle of
+  the element that carries them.
 
 ## Open questions
 

package/doc/gui/rendering.md

@@ -160,3 +160,80 @@ cascades but paints nothing.
 - Layout uses these real metrics for text widths, line breaking and
   `line-height: normal`; `measureText`/`fontMetrics` expose them to tests.
 
+## Performance (M20)
+
+The engine is a retained-mode pipeline: a DOM mutation restyles the document,
+lays it out, rebuilds the display list and uploads vertex arrays; a frame that
+changes nothing does no CPU or GPU work. A document with thousands of elements
+is kept interactive by budgeting each stage, and every stage is measured. Set
+`XT_GUI_PERF=1` to print one line per frame (or `XT_GUI_PERF=<N>` for an
+aggregated line every N frames); `win.stats()` returns the same counters, which
+is what `tests/e2e/gui-perf.test.ts` asserts on.
+
+- **Cascade.** An `@media` prelude is evaluated **once per rule** per restyle
+  (it used to be parsed once per rule *and* node, which was the largest cost on
+  a large document). A sheet without `::before`/`::after` rules skips generated
+  content entirely, the declaration candidate list is reused across the
+  depth-first walk instead of allocated per element, and `:hover`/`:focus` only
+  restyle when the sheet actually has such a rule.
+- **Text.** Layout and paint share a bounded shaping cache (`text_cache.cpp`):
+  `(face, text) -> glyphs + advance`. It uses two generations of up to 2 MiB of
+  glyphs / 8,192 entries; when a generation is full the *spare* one is dropped
+  and becomes current, so the hot path has no LRU bookkeeping. A word is shaped
+  once and reused by every later layout pass and repaint that draws it. Primary
+  face lookups are cached by (family class, size) as well.
+- **Frame loop.** The media/canvas tables are reconciled with the DOM only when
+  the document changed (or on the first frame) instead of walking the tree every
+  frame. A frame presents only when something happened — a mutation, a scroll,
+  an animation frame, a transition, a new video/canvas frame, an expose/resize
+  event — so a static page performs no swapchain acquire and no draw at all.
+  An expose is the one present the window system asks for rather than the page,
+  and `exposes` counts those frames, so `presents - exposes - deferred` stays
+  the document's own work even when a window server maps the window late.
+  A frame that cannot get a swapchain image (SDL's non-blocking acquire skips a
+  frame while the GPU still holds the image, and a minimized window has none)
+  keeps its invalidation pending instead of dropping it, so the paint is
+  presented on the next frame; those presents are counted as `deferred`.
+  `XT_GUI_ALWAYS_PRESENT=1` restores the old always-present behaviour when
+  debugging a missed invalidation.
+- **Paint and upload.** The display list and the vertex staging arrays are kept
+  on the window and cleared per repaint, so their capacity survives. All of a
+  dirty frame's vertex/atlas uploads share one command buffer (one submit),
+  the geometry's staging transfer buffer is reused (cycled while the previous
+  copy may still be in flight), and paint skips the z-index sort and temporary
+  vector when no child stacks.
+- **Draw.** Consecutive ops with the same pipeline, clip and texture still merge
+  into one run, and the renderer now only re-binds a pipeline/vertex
+  buffer/scissor when it actually changes. `drawCalls`/`drawMs` in `win.stats()`
+  report the run count and its cost; they are the metric for the remaining
+  follow-up (an overlap-aware batching pass) — painter order requires
+  alternating background and text runs to stay separate until that lands.
+- **Immediate-mode surfaces.** `<canvas>` 2D and WebGL draws are script-driven,
+  so their cost is per call rather than per document change; the counters above
+  cover the retained pipeline only. `tests/e2e/gui-draw-perf.test.ts` measures
+  them: on the reference Windows x64/Vulkan machine a 1280×720 frame with 5,000
+  solid `fillRect`s, 200 eight-point strokes, 300 `fillText` runs and 200 1:1
+  `drawImage`s fell from 231ms to 158ms (fill 4.3ms, stroke 151ms, text 1.4ms,
+  image 1.6ms), and 2,000 WebGL `drawElements` calls with a per-draw matrix went
+  from 38.6ms to 27.5ms while the render passes opened per frame dropped from
+  2,001 to 1 and a 64 KiB `bufferSubData` into a 4 MiB buffer stopped
+  re-uploading the whole buffer. A 100×100 canvas redraw now uploads 40 KB
+  rather than the whole 1.2 MB bitmap. The suite asserts the counters (one
+  upload per frame, no steady-state pipeline creation, only the dirty bytes), so
+  the wall-clock numbers stay informational and a software GPU in CI is not
+  penalised.
+
+Known limits: a mutation still restyles and relayouts the **whole** document
+(there is no incremental subtree invalidation), and a paint-only change (for
+example a hover colour) currently reflows too; `win.stats()` is what a follow-up
+would be keyed off. Inline `style="…"` attributes are re-parsed on every restyle
+of the element that carries them.
+
+As a reference point, `tests/e2e/gui-perf.test.ts` builds a 200-row list (about
+1,000 elements, 400 draw runs) and prints the numbers it measured, e.g.
+`textFrame=5.2ms restyle=3.6ms layout=1.7ms paint=1.0ms upload=0.8ms draw=0.4ms`
+for a one-field `textContent` change on a Windows x64/Vulkan machine. The
+absolute values are host-specific; the test asserts the *counters* (one restyle,
+one layout, cache hits instead of shapes, no work on an idle frame), which are
+what a regression would change.
+

package/doc/gui/runtime.md

@@ -18,11 +18,26 @@ expose an explicit `run()`; **M2 uses the explicit `run()`** so the window is a
 plain native call the TypeScript program controls. Each tick it:
 
 1. pumps SDL window/input events for every window,
-2. builds/uploads the display list when it changed and renders every open
+2. reconciles the decoder/canvas tables with the DOM **only when the document
+   changed** (or on the first frame),
+3. builds/uploads the display list when it changed and renders every open
    window (clear pass + shape geometry + text geometry),
-3. calls `xt_loop_poll(0)` and `xt_drain_microtasks()` so sockets/timers and
+4. calls `xt_loop_poll(0)` and `xt_drain_microtasks()` so sockets/timers and
    `await` continuations keep making progress,
-4. repeats until all windows close or `quit()` is called.
+5. repeats until all windows close or `quit()` is called.
+
+A frame **presents only when something happened**: a DOM mutation, a scroll, a
+queued animation frame, a running transition, a new video/canvas frame, an
+expose/resize event, or the first frame. A static document therefore performs no
+swapchain acquire and no draw while the loop keeps servicing events, timers and
+promises; `XT_GUI_ALWAYS_PRESENT=1` restores the old always-present behaviour
+when debugging a missed invalidation. An expose/shown/restore event is the one
+present the *window system* asks for rather than the document, so it is counted
+as `exposes` in `win.stats()`; a present a starved frame had to postpone (no
+swapchain image was available) is counted as `deferred`, and
+`presents - exposes - deferred` is the work the page caused. `XT_GUI_PERF=1`
+prints what each frame did (see
+[Performance](./rendering.md#performance-m20)).
 
 The `xt_loop_set_main` hook remains available for hosts that want to own the
 loop themselves.