@graview/render 0.0.0-stage → 0.1.0

package/dist/platform/html-in-canvas.js

@@ -0,0 +1,172 @@
+/// <reference types="@webgpu/types" />
+//
+// The WebGPU globals are part of this file's PUBLIC declarations, so the
+// reference has to live HERE rather than on the package entry: TypeScript
+// drops a type reference from a `.d.ts` that does not itself name one of its
+// types, so a reference on `index.ts` was emitted nowhere and an installed
+// consumer got "cannot find name GPUDevice" from a file they cannot change.
+// Found by typechecking a scratch project against the packed tarballs.
+//
+// It also has to be the ONLY route in: listing `@webgpu/types` under
+// `compilerOptions.types` makes the globals ambient for this build, at which
+// point TypeScript considers the reference satisfied and drops it from the
+// emit. The build sees no difference; a stranger does.
+/**
+ * THE platform seam. Every call into the HTML-in-Canvas API passes through
+ * this module and nowhere else.
+ *
+ * The API is mid-origin-trial and its naming is still settling — the WICG
+ * README calls the capture entry point `drawElementImageToTexture` in one
+ * place and `copyElementImageToTexture` in another — so the whole surface is
+ * resolved once, at runtime, behind names of our own. When the spec settles,
+ * exactly one file changes.
+ *
+ * Verified against Chrome Canary 154.0.8032.0 with
+ * `--enable-blink-features=CanvasDrawElement`. What that build actually
+ * exposes, and the exact call shapes, are recorded in
+ * `docs/platform-findings.md`; the shapes below are what it accepts, not what
+ * the README suggests.
+ */
+import { IDENTITY, isAffine, perspectiveProbeMatrix, planeTransform, toDOMMatrix, } from "./matrix.js";
+export { IDENTITY, isAffine, perspectiveProbeMatrix, planeTransform, toDOMMatrix };
+const CAPTURE_METHOD_NAMES = [
+    "drawElementImageToTexture",
+    "copyElementImageToTexture",
+];
+function scope() {
+    return typeof globalThis === "undefined" ? undefined : globalThis;
+}
+/**
+ * Resolves what this browser can actually do. Called once; everything else in
+ * the renderer branches on the result rather than sniffing again.
+ */
+export function detectCapabilities(queue, canvas) {
+    const notes = [];
+    const g = scope();
+    const webgpu = Boolean(g?.navigator && "gpu" in g.navigator);
+    if (!webgpu)
+        notes.push("navigator.gpu is absent — WebGPU is unavailable.");
+    const queueProto = queue ??
+        (g?.GPUQueue
+            ?.prototype ??
+            undefined);
+    let captureMethod = null;
+    if (queueProto) {
+        for (const name of CAPTURE_METHOD_NAMES) {
+            if (typeof queueProto[name] === "function") {
+                captureMethod = name;
+                break;
+            }
+        }
+    }
+    if (!captureMethod) {
+        notes.push("No element-capture method on GPUQueue. Run Chromium 147+ with " +
+            "--enable-blink-features=CanvasDrawElement.");
+    }
+    const canvasProto = canvas ??
+        (g
+            ?.HTMLCanvasElement?.prototype ??
+            undefined);
+    const geometrySync = typeof canvasProto?.updateElementGeometry === "function";
+    if (!geometrySync) {
+        notes.push("canvas.updateElementGeometry is absent — geometry cannot be reported.");
+    }
+    const paintEvents = typeof canvasProto?.requestPaint === "function";
+    if (!paintEvents) {
+        notes.push("canvas.requestPaint is absent — there is no capture-safe moment to hook.");
+    }
+    let layoutSubtree = false;
+    if (typeof document !== "undefined") {
+        const probe = document.createElement("canvas");
+        layoutSubtree = "layoutSubtree" in probe;
+    }
+    return {
+        available: captureMethod !== null,
+        captureMethod,
+        geometrySync,
+        hitTestFollowsGeometry: "unknown",
+        layoutSubtree,
+        paintEvents,
+        webgpu,
+        usable: webgpu && captureMethod !== null,
+        notes,
+    };
+}
+export class PlatformUnavailableError extends Error {
+    capabilities;
+    constructor(capabilities) {
+        super(`HTML-in-Canvas is unavailable:\n  ${capabilities.notes.join("\n  ")}`);
+        this.capabilities = capabilities;
+        this.name = "PlatformUnavailableError";
+    }
+}
+/**
+ * Captures a DOM element (or a previously taken paint record) into an
+ * existing GPU texture.
+ *
+ * Two preconditions the errors do not make obvious:
+ * - the element must be a descendant of a `<canvas layoutsubtree>`, and
+ * - that canvas must have a CONFIGURED WebGPU context of its own, or the call
+ *   fails with "containing canvas does not have a rendering context".
+ *
+ * The texture is written in place, so the caller keeps ownership and no copy
+ * happens on our side.
+ */
+export function captureElement(queue, source, texture) {
+    const q = queue;
+    for (const name of CAPTURE_METHOD_NAMES) {
+        const method = q[name];
+        if (typeof method === "function") {
+            method.call(q, { source }, { destination: { texture } });
+            return;
+        }
+    }
+    throw new PlatformUnavailableError(detectCapabilities(queue));
+}
+/**
+ * Takes a cached paint record for an element. Only valid inside a `paint`
+ * event — outside one the browser has no paint record and throws
+ * `InvalidStateError`.
+ */
+export function captureElementImage(canvas, element) {
+    const target = canvas;
+    if (typeof target.captureElementImage !== "function") {
+        throw new PlatformUnavailableError(detectCapabilities(undefined, canvas));
+    }
+    return target.captureElementImage(element);
+}
+/**
+ * Tells the browser where an element was actually drawn.
+ *
+ * The intent of the spec is that hit-testing, focus order, screen readers and
+ * find-in-page then resolve against the drawn pixels. In Chromium 154 the
+ * call is accepted and has no observable effect on hit-testing — see
+ * `docs/platform-findings.md`. Call it anyway (it costs nothing and will
+ * start working), and route pointers through `PointerRouter` meanwhile.
+ */
+export function updateElementGeometry(canvas, source, update) {
+    const target = canvas;
+    if (typeof target.updateElementGeometry !== "function") {
+        throw new PlatformUnavailableError(detectCapabilities(undefined, canvas));
+    }
+    target.updateElementGeometry(source, update);
+}
+/** Drops a reported geometry, returning the element to its layout position. */
+export function clearElementGeometry(canvas, source) {
+    canvas.clearElementGeometry?.(source);
+}
+/** Asks for a `paint` event — the moment at which capture is legal. */
+export function requestPaint(canvas) {
+    canvas.requestPaint?.();
+}
+/** Marks a canvas as owning its descendants' layout. */
+export function setLayoutSubtree(canvas, on = true) {
+    const target = canvas;
+    if ("layoutSubtree" in target)
+        target.layoutSubtree = on;
+    else if (on)
+        target.setAttribute("layoutsubtree", "");
+    else
+        target.removeAttribute("layoutsubtree");
+}
+//# sourceMappingURL=html-in-canvas.js.map

package/dist/platform/html-in-canvas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-in-canvas.js","sourceRoot":"","sources":["../../src/platform/html-in-canvas.ts"],"names":[],"mappings":"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"}

package/dist/platform/matrix.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Affine 4x4 matrices, and the plane transform built from one.
+ *
+ * Split out of the platform seam because it is PURE: no DOM, no WebGPU, no
+ * ambient globals. That matters for more than tidiness — the platform module's
+ * declarations name `GPUQueue`, which is an ambient global from
+ * `@webgpu/types`, so anything re-exported from there drags that requirement
+ * onto every consumer. The geometry every app uses should not.
+ *
+ * Affine is not a style choice here. The capture pipeline composites textures
+ * with a per-plane transform, and a perspective divide would mean resampling
+ * each captured view every frame; `isAffine` is the guard that keeps that
+ * true, and it is checked in tests on both renderer paths.
+ */
+export type Matrix4 = readonly [
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number
+];
+/** An opaque cached paint record for one element, from `captureElementImage`. */
+/**
+ * Whether a matrix is affine — no perspective row.
+ *
+ * The plane model is designed so that everything it emits passes this test:
+ * depth is per-plane uniform scale, blur and shadow, never per-element
+ * foreshortening. That keeps the model correct whichever way the platform
+ * settles the perspective question.
+ */
+export declare function isAffine(matrix: Matrix4): boolean;
+/** Column-major 4x4 identity. */
+export declare const IDENTITY: Matrix4;
+/**
+ * The affine transform a plane contributes: uniform scale about the canvas
+ * origin plus a translation. Deliberately nothing else.
+ */
+export declare function planeTransform(scale: number, translateX: number, translateY: number): Matrix4;
+/** A perspective matrix, used only to ask the browser whether it takes one. */
+export declare function perspectiveProbeMatrix(depth?: number): Matrix4;
+export declare function toDOMMatrix(matrix: Matrix4 | DOMMatrix): DOMMatrix;
+//# sourceMappingURL=matrix.d.ts.map

package/dist/platform/matrix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matrix.d.ts","sourceRoot":"","sources":["../../src/platform/matrix.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,MAAM,OAAO,GAAG,SAAS;IAC7B,MAAM;IAAE,MAAM;IAAE,MAAM;IAAE,MAAM;IAC9B,MAAM;IAAE,MAAM;IAAE,MAAM;IAAE,MAAM;IAC9B,MAAM;IAAE,MAAM;IAAE,MAAM;IAAE,MAAM;IAC9B,MAAM;IAAE,MAAM;IAAE,MAAM;IAAE,MAAM;CAC/B,CAAC;AAEF,iFAAiF;AAEjF;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAEjD;AAED,iCAAiC;AACjC,eAAO,MAAM,QAAQ,EAAE,OAKtB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAOT;AAED,+EAA+E;AAC/E,wBAAgB,sBAAsB,CAAC,KAAK,SAAM,GAAG,OAAO,CAO3D;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAKlE"}

package/dist/platform/matrix.js

@@ -0,0 +1,61 @@
+/**
+ * Affine 4x4 matrices, and the plane transform built from one.
+ *
+ * Split out of the platform seam because it is PURE: no DOM, no WebGPU, no
+ * ambient globals. That matters for more than tidiness — the platform module's
+ * declarations name `GPUQueue`, which is an ambient global from
+ * `@webgpu/types`, so anything re-exported from there drags that requirement
+ * onto every consumer. The geometry every app uses should not.
+ *
+ * Affine is not a style choice here. The capture pipeline composites textures
+ * with a per-plane transform, and a perspective divide would mean resampling
+ * each captured view every frame; `isAffine` is the guard that keeps that
+ * true, and it is checked in tests on both renderer paths.
+ */
+/** An opaque cached paint record for one element, from `captureElementImage`. */
+/**
+ * Whether a matrix is affine — no perspective row.
+ *
+ * The plane model is designed so that everything it emits passes this test:
+ * depth is per-plane uniform scale, blur and shadow, never per-element
+ * foreshortening. That keeps the model correct whichever way the platform
+ * settles the perspective question.
+ */
+export function isAffine(matrix) {
+    return matrix[3] === 0 && matrix[7] === 0 && matrix[11] === 0 && matrix[15] === 1;
+}
+/** Column-major 4x4 identity. */
+export const IDENTITY = [
+    1, 0, 0, 0,
+    0, 1, 0, 0,
+    0, 0, 1, 0,
+    0, 0, 0, 1,
+];
+/**
+ * The affine transform a plane contributes: uniform scale about the canvas
+ * origin plus a translation. Deliberately nothing else.
+ */
+export function planeTransform(scale, translateX, translateY) {
+    return [
+        scale, 0, 0, 0,
+        0, scale, 0, 0,
+        0, 0, 1, 0,
+        translateX, translateY, 0, 1,
+    ];
+}
+/** A perspective matrix, used only to ask the browser whether it takes one. */
+export function perspectiveProbeMatrix(depth = 800) {
+    return [
+        1, 0, 0, 0,
+        0, 1, 0, 0,
+        0, 0, 1, -1 / depth,
+        0, 0, 0, 1,
+    ];
+}
+export function toDOMMatrix(matrix) {
+    if (typeof DOMMatrix === "undefined") {
+        throw new Error("DOMMatrix is unavailable outside a browser");
+    }
+    return matrix instanceof DOMMatrix ? matrix : new DOMMatrix([...matrix]);
+}
+//# sourceMappingURL=matrix.js.map

package/dist/platform/matrix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"matrix.js","sourceRoot":"","sources":["../../src/platform/matrix.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AASH,iFAAiF;AAEjF;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAe;IACtC,OAAO,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;AACpF,CAAC;AAED,iCAAiC;AACjC,MAAM,CAAC,MAAM,QAAQ,GAAY;IAC/B,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;IACV,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;IACV,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;IACV,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;CACX,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC5B,KAAa,EACb,UAAkB,EAClB,UAAkB;IAElB,OAAO;QACL,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;QACd,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;QACd,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;QACV,UAAU,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;KAC7B,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,sBAAsB,CAAC,KAAK,GAAG,GAAG;IAChD,OAAO;QACL,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;QACV,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;QACV,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK;QACnB,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;KACX,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAA2B;IACrD,IAAI,OAAO,SAAS,KAAK,WAAW,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,MAAM,YAAY,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;AAC3E,CAAC"}

package/dist/scene/compositor.d.ts

@@ -0,0 +1,112 @@
+import { type Placement } from "../interaction/pointer-router.js";
+import { type PlatformCapabilities } from "../platform/html-in-canvas.js";
+import type { ConnectorStyle } from "./connectors.js";
+import { type FramePlan, type PlannedConnector, type PlannedView, type ViewDraw } from "./frame-plan.js";
+/** A view in the scene: its DOM subtree, plus everything the plan needs. */
+export interface SceneView extends PlannedView {
+    /**
+     * The element captured for this view. It MUST be an immediate child of the
+     * scene canvas — the platform rejects anything deeper. Its own descendants
+     * are captured with it.
+     */
+    readonly element: HTMLElement;
+}
+/**
+ * The minimum of a WebGPU device this module uses, said structurally: a
+ * device from `navigator.gpu`, from `vgpu`, `vgpu/node` or `vgpu/mock` all
+ * fit, and this package depends on none of them.
+ */
+export interface VgpuLike {
+    readonly device: {
+        readonly gpu: GPUDevice;
+    };
+    dispose?(): void;
+}
+export interface SurfaceLike {
+    readonly context: GPUCanvasContext;
+}
+export interface CompositorDeps {
+    readonly gpu: VgpuLike;
+    readonly surface: SurfaceLike;
+}
+export interface CompositorOptions {
+    /** The ground colour receded planes drift toward. Defaults to a warm off-white. */
+    readonly ground?: readonly [number, number, number];
+    /** Stand the pointer router down once a browser redirects hit-testing itself. */
+    readonly platformHandlesHitTesting?: boolean;
+    readonly connectorOverrides?: Readonly<Record<string, Partial<ConnectorStyle>>>;
+}
+/**
+ * Captures views into GPU textures and composites them as quads at plane
+ * depth, then reports each drawn position back to the browser.
+ *
+ * The frame is decided by `planFrame` — which fidelity captures, what order
+ * things draw in, where each view lands — and this class only submits it.
+ * Keeping the decisions out of here is what lets them be tested in CI with
+ * no GPU and no DOM.
+ */
+export declare class Compositor {
+    readonly canvas: HTMLCanvasElement;
+    private readonly deps;
+    private readonly options;
+    private readonly views;
+    private readonly resources;
+    private readonly capturedAt;
+    private readonly router;
+    private pipeline;
+    private sampler;
+    private frame;
+    private detachRouter;
+    private connectors;
+    private lastPlan;
+    private lastPlacements;
+    readonly capabilities: PlatformCapabilities;
+    constructor(canvas: HTMLCanvasElement, deps: CompositorDeps, options?: CompositorOptions);
+    attach(): () => void;
+    detach(): void;
+    /**
+     * Brings the scene in line with a new set of views, keeping the GPU
+     * resources of everything that survived.
+     *
+     * Removing and re-adding every view on each edit destroys and reallocates
+     * every texture, which is both wasteful and — at this scene's size — enough
+     * to bring the GPU process down. Reconciling touches only what changed.
+     */
+    reconcile(views: readonly SceneView[]): void;
+    /** Whether this view's cached texture still reflects what it looks like. */
+    private capturedAtIsFresh;
+    add(view: SceneView): void;
+    remove(id: string): void;
+    /** Replaces the connector set, e.g. after a layout change. */
+    setConnectors(connectors: readonly PlannedConnector[]): void;
+    /** Marks a view's texture stale, so the next frame recaptures it. */
+    invalidate(id: string): void;
+    all(): SceneView[];
+    /** Last frame's plan. Measurement harnesses and tests only. */
+    plan(): FramePlan | null;
+    /** Where each view was drawn last frame, with the element it came from. */
+    placements(): readonly Placement[];
+    /** Raw device handle. Measurement harnesses only. */
+    deviceForProbe(): GPUDevice;
+    /** Asks the browser for a `paint` event — the only moment capture is legal. */
+    scheduleFrame(): void;
+    /**
+     * One frame: capture what is stale, draw every view back to front, and tell
+     * the browser where each one landed.
+     *
+     * Call this from a `paint` listener. Outside one the browser has no paint
+     * record and capture throws.
+     */
+    render(): FramePlan;
+    private groundColor;
+    private ensurePipeline;
+    private ensureResources;
+    private ensureBindGroup;
+    dispose(): void;
+}
+/**
+ * The uniform layout the compositing shader reads, packed as data so a test
+ * can assert on it with no GPU present.
+ */
+export declare function packUniform(draw: ViewDraw, canvasWidth: number, canvasHeight: number, ground: readonly [number, number, number]): Float32Array<ArrayBuffer>;
+//# sourceMappingURL=compositor.d.ts.map

package/dist/scene/compositor.d.ts.map

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