@graview/render 0.0.0-stage → 0.1.0

package/dist/scene/compositor.js

@@ -0,0 +1,340 @@
+/// <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.
+import { PointerRouter } from "../interaction/pointer-router.js";
+import { captureElement, detectCapabilities, requestPaint, setLayoutSubtree, toDOMMatrix, updateElementGeometry, } from "../platform/html-in-canvas.js";
+import { COMPOSITOR_WGSL } from "./compositor.wgsl.js";
+import { planFrame, } from "./frame-plan.js";
+const UNIFORM_BYTES = 64; // 4 x vec4f
+/**
+ * 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 class Compositor {
+    canvas;
+    deps;
+    options;
+    views = new Map();
+    resources = new Map();
+    capturedAt = {};
+    router;
+    pipeline = null;
+    sampler = null;
+    frame = 0;
+    detachRouter = null;
+    connectors = [];
+    lastPlan = null;
+    lastPlacements = [];
+    capabilities;
+    constructor(canvas, deps, options = {}) {
+        this.canvas = canvas;
+        this.deps = deps;
+        this.options = options;
+        setLayoutSubtree(canvas, true);
+        this.capabilities = detectCapabilities(deps.gpu.device.gpu.queue, canvas);
+        this.router = new PointerRouter(canvas, {
+            ...(options.platformHandlesHitTesting === undefined
+                ? {}
+                : { platformHandlesHitTesting: options.platformHandlesHitTesting }),
+        });
+    }
+    attach() {
+        this.detachRouter = this.router.attach();
+        return () => this.detach();
+    }
+    detach() {
+        this.detachRouter?.();
+        this.detachRouter = null;
+    }
+    /**
+     * 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) {
+        const next = new Map(views.map((view) => [view.id, view]));
+        for (const id of [...this.views.keys()]) {
+            if (!next.has(id))
+                this.remove(id);
+        }
+        for (const view of views) {
+            const existing = this.views.get(view.id);
+            if (!existing) {
+                this.add(view);
+                continue;
+            }
+            // What actually changes the PIXELS: a different element, a different
+            // box, or a different opacity. Moving a view does not — and marking a
+            // move dirty put every plane-1 view back into the per-frame capture
+            // budget for the whole of every transition.
+            const resized = existing.width !== view.width || existing.height !== view.height;
+            const replaced = existing.element !== view.element;
+            const faded = (existing.opacity ?? 1) !== (view.opacity ?? 1);
+            const dirty = existing.dirty || resized || replaced || faded;
+            this.views.set(view.id, { ...view, dirty });
+            if (replaced || (dirty && !this.capturedAtIsFresh(view.id))) {
+                // Force a first-class recapture rather than relying on the fidelity
+                // rule, which for `glyph` never recaptures at all.
+                delete this.capturedAt[view.id];
+            }
+        }
+    }
+    /** Whether this view's cached texture still reflects what it looks like. */
+    capturedAtIsFresh(id) {
+        return this.capturedAt[id] !== undefined && this.views.get(id)?.dirty !== true;
+    }
+    add(view) {
+        if (view.element.parentElement !== this.canvas) {
+            // The platform's own message for this arrives from deep inside a
+            // capture call, a frame later, naming neither the view nor the fix.
+            throw new Error(`View "${view.id}" must be an immediate child of the scene canvas — ` +
+                "the capture API rejects deeper descendants. Nest inside a view, " +
+                "never between views.");
+        }
+        this.views.set(view.id, { ...view, dirty: true });
+    }
+    remove(id) {
+        const resource = this.resources.get(id);
+        resource?.texture.destroy();
+        resource?.uniform.destroy();
+        this.resources.delete(id);
+        this.views.delete(id);
+        delete this.capturedAt[id];
+    }
+    /** Replaces the connector set, e.g. after a layout change. */
+    setConnectors(connectors) {
+        this.connectors = connectors;
+    }
+    /** Marks a view's texture stale, so the next frame recaptures it. */
+    invalidate(id) {
+        const view = this.views.get(id);
+        if (view)
+            this.views.set(id, { ...view, dirty: true });
+    }
+    all() {
+        return [...this.views.values()];
+    }
+    /** Last frame's plan. Measurement harnesses and tests only. */
+    plan() {
+        return this.lastPlan;
+    }
+    /** Where each view was drawn last frame, with the element it came from. */
+    placements() {
+        return this.lastPlacements;
+    }
+    /** Raw device handle. Measurement harnesses only. */
+    deviceForProbe() {
+        return this.deps.gpu.device.gpu;
+    }
+    /** Asks the browser for a `paint` event — the only moment capture is legal. */
+    scheduleFrame() {
+        requestPaint(this.canvas);
+    }
+    /**
+     * 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() {
+        const device = this.deps.gpu.device.gpu;
+        const queue = device.queue;
+        this.frame += 1;
+        // Read the canvas's CURRENT backing size every frame.
+        //
+        // This used to be a tuple captured when the compositor was built. Once
+        // the scene became responsive the canvas resized underneath it, the
+        // shader kept mapping canvas pixels to NDC with the old dimensions, and
+        // every quad landed somewhere it should not — barely at the origin,
+        // badly further down. The canvas is the surface; there is no second
+        // source of truth to go stale.
+        const canvasWidth = this.canvas.width;
+        const canvasHeight = this.canvas.height;
+        const plan = planFrame([...this.views.values()], this.connectors, {
+            canvasWidth,
+            canvasHeight,
+            capturedAt: this.capturedAt,
+            ...(this.options.connectorOverrides
+                ? { connectorOverrides: this.options.connectorOverrides }
+                : {}),
+        });
+        this.lastPlan = plan;
+        for (const capture of plan.captures) {
+            const view = this.views.get(capture.viewId);
+            if (!view)
+                continue;
+            const resource = this.ensureResources(device, view);
+            captureElement(queue, view.element, resource.texture);
+            this.capturedAt[view.id] = this.frame;
+            this.views.set(view.id, { ...view, dirty: false });
+        }
+        const encoder = device.createCommandEncoder({ label: "graview-compositor" });
+        const pass = encoder.beginRenderPass({
+            colorAttachments: [
+                {
+                    view: this.deps.surface.context.getCurrentTexture().createView(),
+                    clearValue: this.groundColor(),
+                    loadOp: "clear",
+                    storeOp: "store",
+                },
+            ],
+        });
+        pass.setPipeline(this.ensurePipeline(device));
+        const placements = [];
+        for (const draw of plan.draws) {
+            const view = this.views.get(draw.viewId);
+            const resource = this.resources.get(draw.viewId);
+            if (!view || !resource)
+                continue;
+            queue.writeBuffer(resource.uniform, 0, packUniform(draw, canvasWidth, canvasHeight, this.options.ground ?? [0.957, 0.949, 0.933]));
+            pass.setBindGroup(0, this.ensureBindGroup(device, resource));
+            pass.draw(6);
+            placements.push({
+                element: view.element,
+                transform: draw.transform,
+                width: view.width,
+                height: view.height,
+                depth: view.plane,
+            });
+        }
+        pass.end();
+        queue.submit([encoder.finish()]);
+        // Report the drawn positions even on builds that ignore them: the call is
+        // free, and it is what makes the scene correct the day it lands.
+        if (this.capabilities.geometrySync) {
+            for (const report of plan.geometry) {
+                const view = this.views.get(report.viewId);
+                if (!view)
+                    continue;
+                updateElementGeometry(this.canvas, view.element, {
+                    canvasTransform: toDOMMatrix(report.transform),
+                });
+            }
+        }
+        this.lastPlacements = placements;
+        this.router.setPlacements(placements);
+        return plan;
+    }
+    groundColor() {
+        const [r, g, b] = this.options.ground ?? [0.957, 0.949, 0.933];
+        return { r, g, b, a: 1 };
+    }
+    ensurePipeline(device) {
+        if (this.pipeline)
+            return this.pipeline;
+        const module = device.createShaderModule({
+            code: COMPOSITOR_WGSL,
+            label: "graview-compositor",
+        });
+        this.pipeline = device.createRenderPipeline({
+            layout: "auto",
+            vertex: { module, entryPoint: "vs_main" },
+            fragment: {
+                module,
+                entryPoint: "fs_main",
+                targets: [
+                    {
+                        format: navigator.gpu.getPreferredCanvasFormat(),
+                        blend: {
+                            color: { srcFactor: "src-alpha", dstFactor: "one-minus-src-alpha" },
+                            alpha: { srcFactor: "one", dstFactor: "one-minus-src-alpha" },
+                        },
+                    },
+                ],
+            },
+            primitive: { topology: "triangle-list" },
+        });
+        return this.pipeline;
+    }
+    ensureResources(device, view) {
+        // CEIL, not round. The browser rasterises an element of height 399.4 into
+        // 400 rows, and a 399-row texture makes the copy fail validation — which
+        // it does silently, leaving the view with whatever was in the texture
+        // before, or nothing at all. Allocate at least what can arrive.
+        const width = Math.max(1, Math.ceil(view.width));
+        const height = Math.max(1, Math.ceil(view.height));
+        const existing = this.resources.get(view.id);
+        if (existing && existing.width === width && existing.height === height) {
+            return existing;
+        }
+        existing?.texture.destroy();
+        const texture = device.createTexture({
+            size: [width, height],
+            format: "rgba8unorm",
+            usage: GPUTextureUsage.COPY_DST |
+                GPUTextureUsage.TEXTURE_BINDING |
+                GPUTextureUsage.RENDER_ATTACHMENT,
+            label: `graview-view-${view.id}`,
+        });
+        const resource = {
+            texture,
+            width,
+            height,
+            bindGroup: null,
+            uniform: existing?.uniform ??
+                device.createBuffer({
+                    size: UNIFORM_BYTES,
+                    usage: GPUBufferUsage.UNIFORM | GPUBufferUsage.COPY_DST,
+                    label: `graview-plane-${view.id}`,
+                }),
+        };
+        this.resources.set(view.id, resource);
+        return resource;
+    }
+    ensureBindGroup(device, resource) {
+        if (resource.bindGroup)
+            return resource.bindGroup;
+        this.sampler ??= device.createSampler({
+            magFilter: "linear",
+            minFilter: "linear",
+            addressModeU: "clamp-to-edge",
+            addressModeV: "clamp-to-edge",
+        });
+        resource.bindGroup = device.createBindGroup({
+            layout: this.ensurePipeline(device).getBindGroupLayout(0),
+            entries: [
+                { binding: 0, resource: { buffer: resource.uniform } },
+                { binding: 1, resource: resource.texture.createView() },
+                { binding: 2, resource: this.sampler },
+            ],
+        });
+        return resource.bindGroup;
+    }
+    dispose() {
+        this.detach();
+        for (const id of [...this.resources.keys()])
+            this.remove(id);
+    }
+}
+/**
+ * The uniform layout the compositing shader reads, packed as data so a test
+ * can assert on it with no GPU present.
+ */
+export function packUniform(draw, canvasWidth, canvasHeight, ground) {
+    return new Float32Array([
+        draw.transform[12], draw.transform[13], draw.width, draw.height,
+        draw.style.blur, draw.style.falloff, draw.style.shadow, draw.opacity,
+        canvasWidth, canvasHeight, 0, 0,
+        ground[0], ground[1], ground[2], 1,
+    ]);
+}
+//# sourceMappingURL=compositor.js.map

package/dist/scene/compositor.js.map

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

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

@@ -0,0 +1,15 @@
+/**
+ * The plane compositing shader.
+ *
+ * One textured quad per drawn view. The vertex stage places it from a plane
+ * transform expressed in canvas pixels; the fragment stage applies the
+ * atmospheric-depth treatment: a separable-ish box blur, contrast falloff
+ * toward the ground colour, and a soft drop shadow that separates one plane
+ * from the one behind it.
+ *
+ * Blur and falloff live here rather than in CSS because per-plane blur is
+ * near-free on the GPU and expensive in the compositor — that difference is
+ * the whole justification for the GPU pipeline.
+ */
+export declare const COMPOSITOR_WGSL = "\nstruct Plane {\n  // x, y, width, height in canvas pixels, after the plane transform.\n  rect: vec4f,\n  // blur radius in texels, contrast falloff 0..1, shadow strength, and the\n  // view's own opacity \u2014 which is how a node entering or leaving the scene\n  // fades rather than popping.\n  style: vec4f,\n  // canvas size in pixels, and the ground colour's rgb packed as xyz.\n  canvas: vec4f,\n  ground: vec4f,\n}\n\n@group(0) @binding(0) var<uniform> plane: Plane;\n@group(0) @binding(1) var view_texture: texture_2d<f32>;\n@group(0) @binding(2) var view_sampler: sampler;\n\nstruct VertexOut {\n  @builtin(position) position: vec4f,\n  @location(0) uv: vec2f,\n}\n\n@vertex\nfn vs_main(@builtin(vertex_index) index: u32) -> VertexOut {\n  // Two triangles, no vertex buffer: the quad is entirely a function of the\n  // plane rect, so nothing has to be uploaded per frame except the uniform.\n  var corners = array<vec2f, 6>(\n    vec2f(0.0, 0.0), vec2f(1.0, 0.0), vec2f(0.0, 1.0),\n    vec2f(0.0, 1.0), vec2f(1.0, 0.0), vec2f(1.0, 1.0),\n  );\n  let corner = corners[index];\n  let pixel = plane.rect.xy + corner * plane.rect.zw;\n  // Canvas pixels to clip space, y down.\n  let ndc = vec2f(\n    pixel.x / plane.canvas.x * 2.0 - 1.0,\n    1.0 - pixel.y / plane.canvas.y * 2.0,\n  );\n  var out: VertexOut;\n  out.position = vec4f(ndc, 0.0, 1.0);\n  out.uv = corner;\n  return out;\n}\n\nfn blurred(uv: vec2f, radius: f32) -> vec4f {\n  if (radius <= 0.0) {\n    return textureSample(view_texture, view_sampler, uv);\n  }\n  let size = vec2f(textureDimensions(view_texture, 0));\n  let step = radius / size;\n  var sum = vec4f(0.0);\n  var weight = 0.0;\n  // A 9-tap kernel: enough to read as depth-of-field at plane scale, cheap\n  // enough to run on every capture every frame.\n  for (var y = -1; y <= 1; y = y + 1) {\n    for (var x = -1; x <= 1; x = x + 1) {\n      let offset = vec2f(f32(x), f32(y)) * step;\n      let w = select(1.0, 2.0, x == 0 && y == 0);\n      sum = sum + textureSample(view_texture, view_sampler, uv + offset) * w;\n      weight = weight + w;\n    }\n  }\n  return sum / weight;\n}\n\n@fragment\nfn fs_main(in: VertexOut) -> @location(0) vec4f {\n  let radius = plane.style.x;\n  let falloff = plane.style.y;\n  let shadow = plane.style.z;\n  let opacity = plane.style.w;\n\n  var color = blurred(in.uv, radius);\n\n  // Recede toward the GROUND colour, not toward grey. On a dark ground that\n  // reads as dimming and on a light one as haze \u2014 which is what distance\n  // actually does to a surface, rather than a fixed \"faded\" look that only\n  // works in one scheme.\n  color = vec4f(mix(color.rgb, plane.ground.rgb, falloff), color.a);\n\n  // Contact shadow around the quad's own border, drawn into its alpha so no\n  // second pass is needed. It is what separates one plane from the one\n  // behind it when both are dark.\n  let edge = min(min(in.uv.x, in.uv.y), min(1.0 - in.uv.x, 1.0 - in.uv.y));\n  let lift = 1.0 - smoothstep(0.0, 0.055, edge);\n  color = vec4f(color.rgb * (1.0 - lift * shadow), color.a);\n\n  // Premultiplied: the target blends with one-minus-src-alpha, so scaling\n  // colour and alpha together is what keeps a half-faded view from darkening\n  // instead of dissolving.\n  return vec4f(color.rgb * opacity, color.a * opacity);\n}\n";
+//# sourceMappingURL=compositor.wgsl.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compositor.wgsl.d.ts","sourceRoot":"","sources":["../../src/scene/compositor.wgsl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,eAAe,2vGA2F3B,CAAC"}

package/dist/scene/compositor.wgsl.js

@@ -0,0 +1,106 @@
+/**
+ * The plane compositing shader.
+ *
+ * One textured quad per drawn view. The vertex stage places it from a plane
+ * transform expressed in canvas pixels; the fragment stage applies the
+ * atmospheric-depth treatment: a separable-ish box blur, contrast falloff
+ * toward the ground colour, and a soft drop shadow that separates one plane
+ * from the one behind it.
+ *
+ * Blur and falloff live here rather than in CSS because per-plane blur is
+ * near-free on the GPU and expensive in the compositor — that difference is
+ * the whole justification for the GPU pipeline.
+ */
+export const COMPOSITOR_WGSL = /* wgsl */ `
+struct Plane {
+  // x, y, width, height in canvas pixels, after the plane transform.
+  rect: vec4f,
+  // blur radius in texels, contrast falloff 0..1, shadow strength, and the
+  // view's own opacity — which is how a node entering or leaving the scene
+  // fades rather than popping.
+  style: vec4f,
+  // canvas size in pixels, and the ground colour's rgb packed as xyz.
+  canvas: vec4f,
+  ground: vec4f,
+}
+
+@group(0) @binding(0) var<uniform> plane: Plane;
+@group(0) @binding(1) var view_texture: texture_2d<f32>;
+@group(0) @binding(2) var view_sampler: sampler;
+
+struct VertexOut {
+  @builtin(position) position: vec4f,
+  @location(0) uv: vec2f,
+}
+
+@vertex
+fn vs_main(@builtin(vertex_index) index: u32) -> VertexOut {
+  // Two triangles, no vertex buffer: the quad is entirely a function of the
+  // plane rect, so nothing has to be uploaded per frame except the uniform.
+  var corners = array<vec2f, 6>(
+    vec2f(0.0, 0.0), vec2f(1.0, 0.0), vec2f(0.0, 1.0),
+    vec2f(0.0, 1.0), vec2f(1.0, 0.0), vec2f(1.0, 1.0),
+  );
+  let corner = corners[index];
+  let pixel = plane.rect.xy + corner * plane.rect.zw;
+  // Canvas pixels to clip space, y down.
+  let ndc = vec2f(
+    pixel.x / plane.canvas.x * 2.0 - 1.0,
+    1.0 - pixel.y / plane.canvas.y * 2.0,
+  );
+  var out: VertexOut;
+  out.position = vec4f(ndc, 0.0, 1.0);
+  out.uv = corner;
+  return out;
+}
+
+fn blurred(uv: vec2f, radius: f32) -> vec4f {
+  if (radius <= 0.0) {
+    return textureSample(view_texture, view_sampler, uv);
+  }
+  let size = vec2f(textureDimensions(view_texture, 0));
+  let step = radius / size;
+  var sum = vec4f(0.0);
+  var weight = 0.0;
+  // A 9-tap kernel: enough to read as depth-of-field at plane scale, cheap
+  // enough to run on every capture every frame.
+  for (var y = -1; y <= 1; y = y + 1) {
+    for (var x = -1; x <= 1; x = x + 1) {
+      let offset = vec2f(f32(x), f32(y)) * step;
+      let w = select(1.0, 2.0, x == 0 && y == 0);
+      sum = sum + textureSample(view_texture, view_sampler, uv + offset) * w;
+      weight = weight + w;
+    }
+  }
+  return sum / weight;
+}
+
+@fragment
+fn fs_main(in: VertexOut) -> @location(0) vec4f {
+  let radius = plane.style.x;
+  let falloff = plane.style.y;
+  let shadow = plane.style.z;
+  let opacity = plane.style.w;
+
+  var color = blurred(in.uv, radius);
+
+  // Recede toward the GROUND colour, not toward grey. On a dark ground that
+  // reads as dimming and on a light one as haze — which is what distance
+  // actually does to a surface, rather than a fixed "faded" look that only
+  // works in one scheme.
+  color = vec4f(mix(color.rgb, plane.ground.rgb, falloff), color.a);
+
+  // Contact shadow around the quad's own border, drawn into its alpha so no
+  // second pass is needed. It is what separates one plane from the one
+  // behind it when both are dark.
+  let edge = min(min(in.uv.x, in.uv.y), min(1.0 - in.uv.x, 1.0 - in.uv.y));
+  let lift = 1.0 - smoothstep(0.0, 0.055, edge);
+  color = vec4f(color.rgb * (1.0 - lift * shadow), color.a);
+
+  // Premultiplied: the target blends with one-minus-src-alpha, so scaling
+  // colour and alpha together is what keeps a half-faded view from darkening
+  // instead of dissolving.
+  return vec4f(color.rgb * opacity, color.a * opacity);
+}
+`;
+//# sourceMappingURL=compositor.wgsl.js.map

package/dist/scene/compositor.wgsl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compositor.wgsl.js","sourceRoot":"","sources":["../../src/scene/compositor.wgsl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,UAAU,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2FzC,CAAC"}

package/dist/scene/connectors.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Connector styling. Edge kind determines stroke treatment, because the line
+ * between two nodes carries meaning: `protects` must never look like
+ * `assigned-to`, or the picture is lying about the graph.
+ */
+export type StrokePattern = "solid" | "dashed" | "dotted" | "double" | "tapered";
+export type EndCap = "none" | "arrow" | "dot" | "bar";
+export interface ConnectorStyle {
+    readonly pattern: StrokePattern;
+    readonly width: number;
+    readonly cap: EndCap;
+    /** Degrees around the colour wheel; the renderer maps it into its own palette. */
+    readonly hue: number;
+    readonly opacity: number;
+    /** An explicit CSS colour from the brand's kit; absent, the hue paints it. */
+    readonly colour?: string;
+}
+/**
+ * A distinct treatment for an edge kind, derived rather than authored.
+ *
+ * A new edge kind gets a stroke nobody had to choose — which is the same
+ * promise the rest of the framework makes: declare the kind, and the visual
+ * language follows. Apps override anything they care about.
+ */
+/**
+ * The hue thread lives in core, beside the brand that overrides it; this is
+ * the same function every surface reads, re-exported so nothing that reached
+ * it here has to move.
+ */
+export { hueFor } from "@graview/core";
+export declare function connectorStyle(kind: string, overrides?: Readonly<Record<string, Partial<ConnectorStyle>>>): ConnectorStyle;
+/**
+ * Checks that a set of edge kinds are actually distinguishable from one
+ * another. Two relationships that render identically are a bug in the visual
+ * language, not a cosmetic issue — so this is worth asserting in a test
+ * rather than noticing in a screenshot.
+ */
+export declare function distinguishable(kinds: readonly string[], overrides?: Readonly<Record<string, Partial<ConnectorStyle>>>): {
+    ok: boolean;
+    collisions: readonly [string, string][];
+};
+/**
+ * The dash array for a stroke pattern, in one place.
+ *
+ * Exported because the scene is not the only thing that draws a connector: a
+ * legend has to draw the SAME line, and a legend whose swatch is an
+ * approximation is a legend you cannot trust. Copying this map was the exact
+ * failure the legend's own docstring promised against.
+ */
+export declare const CONNECTOR_DASH: Readonly<Record<StrokePattern, string | undefined>>;
+/** The colour a connector of this kind is stroked in, on either surface. */
+export declare function connectorStroke(style: ConnectorStyle): string;
+/**
+ * How thick, given where it is drawn.
+ *
+ * Inside the scene a connector is an aside and stays thin; above the stack the
+ * lines are the content and earn their weight.
+ */
+export declare function connectorWidth(style: ConnectorStyle, overview: boolean): number;
+//# sourceMappingURL=connectors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"connectors.d.ts","sourceRoot":"","sources":["../../src/scene/connectors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AACjF,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,KAAK,CAAC;AAEtD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,kFAAkF;IAClF,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAoBD;;;;;;GAMG;AACH;;;;GAIG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,SAAS,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC,CAAM,GAChE,cAAc,CAUhB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,GAC5D;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAA;CAAE,CAa1D;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC,CAM9E,CAAC;AAEF,4EAA4E;AAC5E,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAE7D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,CAE/E"}

package/dist/scene/connectors.js

@@ -0,0 +1,95 @@
+/**
+ * Connector styling. Edge kind determines stroke treatment, because the line
+ * between two nodes carries meaning: `protects` must never look like
+ * `assigned-to`, or the picture is lying about the graph.
+ */
+/**
+ * The treatments a derived style may take. Deliberately distinguishable by
+ * shape as well as by hue: colour alone is not a way to tell two relationships
+ * apart.
+ */
+const PATTERNS = ["solid", "dashed", "dotted", "double", "tapered"];
+const CAPS = ["arrow", "none", "dot", "bar"];
+/** Stable string hash — the same edge kind always gets the same treatment. */
+function hash(value) {
+    let h = 2166136261;
+    for (let i = 0; i < value.length; i++) {
+        h ^= value.charCodeAt(i);
+        h = Math.imul(h, 16777619);
+    }
+    return h >>> 0;
+}
+/**
+ * A distinct treatment for an edge kind, derived rather than authored.
+ *
+ * A new edge kind gets a stroke nobody had to choose — which is the same
+ * promise the rest of the framework makes: declare the kind, and the visual
+ * language follows. Apps override anything they care about.
+ */
+/**
+ * The hue thread lives in core, beside the brand that overrides it; this is
+ * the same function every surface reads, re-exported so nothing that reached
+ * it here has to move.
+ */
+export { hueFor } from "@graview/core";
+export function connectorStyle(kind, overrides = {}) {
+    const h = hash(kind);
+    const derived = {
+        pattern: PATTERNS[h % PATTERNS.length],
+        width: 1.5 + ((h >>> 3) % 3) * 0.75,
+        cap: CAPS[(h >>> 7) % CAPS.length],
+        hue: (h >>> 11) % 360,
+        opacity: 0.85,
+    };
+    return { ...derived, ...overrides[kind] };
+}
+/**
+ * Checks that a set of edge kinds are actually distinguishable from one
+ * another. Two relationships that render identically are a bug in the visual
+ * language, not a cosmetic issue — so this is worth asserting in a test
+ * rather than noticing in a screenshot.
+ */
+export function distinguishable(kinds, overrides) {
+    const styles = kinds.map((kind) => [kind, connectorStyle(kind, overrides)]);
+    const collisions = [];
+    for (let i = 0; i < styles.length; i++) {
+        for (let j = i + 1; j < styles.length; j++) {
+            const [aKind, a] = styles[i];
+            const [bKind, b] = styles[j];
+            const sameShape = a.pattern === b.pattern && a.cap === b.cap && a.width === b.width;
+            const sameHue = Math.abs(a.hue - b.hue) < 0.04;
+            if (sameShape && sameHue)
+                collisions.push([aKind, bKind]);
+        }
+    }
+    return { ok: collisions.length === 0, collisions };
+}
+/**
+ * The dash array for a stroke pattern, in one place.
+ *
+ * Exported because the scene is not the only thing that draws a connector: a
+ * legend has to draw the SAME line, and a legend whose swatch is an
+ * approximation is a legend you cannot trust. Copying this map was the exact
+ * failure the legend's own docstring promised against.
+ */
+export const CONNECTOR_DASH = {
+    solid: undefined,
+    dashed: "7 5",
+    dotted: "1 5",
+    double: "12 3",
+    tapered: "10 3 3 3",
+};
+/** The colour a connector of this kind is stroked in, on either surface. */
+export function connectorStroke(style) {
+    return style.colour ?? `hsl(${Math.round(style.hue)} 55% 62%)`;
+}
+/**
+ * How thick, given where it is drawn.
+ *
+ * Inside the scene a connector is an aside and stays thin; above the stack the
+ * lines are the content and earn their weight.
+ */
+export function connectorWidth(style, overview) {
+    return overview ? Math.max(1.6, style.width) : Math.min(1.4, style.width);
+}
+//# sourceMappingURL=connectors.js.map

package/dist/scene/connectors.js.map

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