@graview/layout 0.1.0

package/dist/label-fit.js

@@ -0,0 +1,162 @@
+/**
+ * A NAME THAT FITS THE THING IT NAMES.
+ *
+ * Every drawn surface in this framework eventually has to write a word
+ * inside a shape — a district, a region on a plan, a band on a calendar —
+ * and every one of them starts by centring the text at one size and hoping.
+ * That works for as long as the names are short, which is for as long as a
+ * person is typing them.
+ *
+ * A product asked a model to survey a garden and got seven areas back
+ * called things like "Pea-gravel corner with river-rock border, log seats
+ * and a fire bowl". The map drew each at one size across the middle of its
+ * shape: three ran off the canvas, two were struck through by a
+ * neighbour's outline, and nothing failed — every test passed, the
+ * accessibility tree was perfect, and the picture said "rick patio with
+ * gravel joints". Agent-authored labels are not an edge case; they are the
+ * normal case for anything with an intelligence provider in it.
+ *
+ * So this is the arithmetic, apart from any drawing, where it can be
+ * tested: how much room a shape actually has, and what of a name will fit
+ * in it. Nothing here knows what a zone is.
+ */
+/**
+ * How wide a shape is AT A HEIGHT — not its bounding box.
+ *
+ * The shapes that overflow worst are the long thin ones, whose box is
+ * generous exactly where the shape is not. So this is a scanline: cross the
+ * polygon with a horizontal line and take the widest run that is genuinely
+ * inside it. For an L, a crescent or an hourglass waist that is much less
+ * than the box, which is the point.
+ */
+export function spanAt(outline, y) {
+    const crossings = [];
+    for (let i = 0; i < outline.length; i += 1) {
+        const a = outline[i];
+        const b = outline[(i + 1) % outline.length];
+        if (a.y === b.y)
+            continue;
+        const low = Math.min(a.y, b.y);
+        const high = Math.max(a.y, b.y);
+        if (y < low || y >= high)
+            continue;
+        crossings.push(a.x + ((y - a.y) / (b.y - a.y)) * (b.x - a.x));
+    }
+    crossings.sort((p, q) => p - q);
+    let best = { x0: 0, x1: 0 };
+    /* Pairs, not neighbours: odd gaps are inside the shape, even ones are not. */
+    for (let i = 0; i + 1 < crossings.length; i += 2) {
+        const run = { x0: crossings[i], x1: crossings[i + 1] };
+        if (run.x1 - run.x0 > best.x1 - best.x0)
+            best = run;
+    }
+    return best;
+}
+/** The corner-to-corner extent, for the vertical room a label has. */
+export function boxOf(outline) {
+    let top = Infinity;
+    let bottom = -Infinity;
+    for (const point of outline) {
+        if (point.y < top)
+            top = point.y;
+        if (point.y > bottom)
+            bottom = point.y;
+    }
+    return { top, bottom };
+}
+/** How much a shape covers, by the shoelace. For ordering, not for display. */
+export function areaOf(outline) {
+    let twice = 0;
+    for (let i = 0; i < outline.length; i += 1) {
+        const a = outline[i];
+        const b = outline[(i + 1) % outline.length];
+        twice += a.x * b.y - b.x * a.y;
+    }
+    return Math.abs(twice) / 2;
+}
+/**
+ * The area-weighted centroid, which is NOT the mean of the corners.
+ *
+ * An L-shaped region with six corners has four of them bunched at one end,
+ * and averaging drags the label off the shape entirely — onto the
+ * neighbour, where it reads as that neighbour's name. The fallback keeps a
+ * degenerate shape from producing a NaN that silently removes the label.
+ */
+export function centroidOf(outline) {
+    let twiceArea = 0;
+    let x = 0;
+    let y = 0;
+    for (let i = 0; i < outline.length; i += 1) {
+        const a = outline[i];
+        const b = outline[(i + 1) % outline.length];
+        const cross = a.x * b.y - b.x * a.y;
+        twiceArea += cross;
+        x += (a.x + b.x) * cross;
+        y += (a.y + b.y) * cross;
+    }
+    if (Math.abs(twiceArea) < 1e-9) {
+        const mean = outline.reduce((acc, p) => ({ x: acc.x + p.x, y: acc.y + p.y }), { x: 0, y: 0 });
+        return { x: mean.x / outline.length, y: mean.y / outline.length };
+    }
+    return { x: x / (3 * twiceArea), y: y / (3 * twiceArea) };
+}
+const ADVANCE = 0.58;
+export const estimateWidth = (text, fontSize) => text.length * fontSize * ADVANCE;
+/**
+ * A name that fits, or no name at all.
+ *
+ * In order: the whole thing on one line; the whole thing broken at the space
+ * nearest the middle, which is what a person lettering a plan does; the same
+ * shrunk, down to the floor; and then cut, with an ellipsis, so the shape is
+ * at least identified.
+ *
+ * A shape too small for four characters gets NOTHING. A two-letter stub over
+ * a flower bed is worse than a clean shape, because it reads as somebody
+ * else's label clipped — and `whole: false` is how the caller knows to say
+ * the name somewhere a person can still read it.
+ */
+export function fitLabel(text, options) {
+    const { room, height, size: base, floor, measure = estimateWidth, lines: most = 2 } = options;
+    const fits = (lines, size) => lines.every((line) => measure(line, size) <= room) && lines.length * size * 1.15 <= height;
+    if (fits([text], base))
+        return { lines: [text], fontSize: base, whole: true };
+    const words = text.split(/\s+/);
+    if (most > 1 && words.length > 1) {
+        /* The break nearest the middle by CHARACTER, not by word count: "The
+           long south-facing bed" breaks after "long", not after "south-facing". */
+        let at = 1;
+        let bestGap = Infinity;
+        let run = 0;
+        for (let i = 0; i < words.length - 1; i += 1) {
+            run += words[i].length + 1;
+            const gap = Math.abs(run - text.length / 2);
+            if (gap < bestGap) {
+                bestGap = gap;
+                at = i + 1;
+            }
+        }
+        const two = [words.slice(0, at).join(" "), words.slice(at).join(" ")];
+        if (fits(two, base))
+            return { lines: two, fontSize: base, whole: true };
+        for (let size = base; size >= floor; size -= base * 0.06) {
+            if (fits(two, size))
+                return { lines: two, fontSize: size, whole: true };
+        }
+    }
+    for (let size = base; size >= floor; size -= base * 0.06) {
+        if (fits([text], size))
+            return { lines: [text], fontSize: size, whole: true };
+    }
+    /* Cut, at the floor, on a word boundary where there is one. */
+    const perCharacter = measure(text, floor) / Math.max(1, text.length);
+    const fitsAt = Math.floor(room / perCharacter) - 1;
+    if (fitsAt < 4 || floor * 1.15 > height)
+        return null;
+    const cut = text.slice(0, fitsAt);
+    const space = cut.lastIndexOf(" ");
+    const kept = space > 3 ? cut.slice(0, space) : cut;
+    return { lines: [`${kept}…`], fontSize: floor, whole: false };
+}
+/** Whether two boxes touch. The whole of collision avoidance, in one line. */
+export const overlaps = (a, b) => a.x0 < b.x1 && b.x0 < a.x1 && a.y0 < b.y1 && b.y0 < a.y1;
+//# sourceMappingURL=label-fit.js.map

package/dist/label-fit.js.map

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

package/dist/layout.d.ts

@@ -0,0 +1,99 @@
+import { type AnySchema, type GraphReader, type NodeOfSchema } from "@graview/core";
+import { type Layout, type LayoutOptions, type Plane } from "./types.js";
+import type { ViewState } from "./view-state.js";
+/**
+ * A billboard cut to its picture is never shorter than this, in the lens's
+ * own pixels. An empty lens — a header over no rows yet — measured to a
+ * strip one line tall, which read as a label, not a screen; at this height
+ * the room under the header is visibly an empty screen.
+ */
+/**
+ * HOW FAR A BILLBOARD MAY BE MOVED FROM ITS OWN PLOT, in city cells.
+ *
+ * Cells rather than pixels so the same pin holds at every zoom: a board
+ * nudged two cells north is two cells north whether the city is flown close
+ * or seen whole. Two is about a village's width — enough to shift a board
+ * off whatever it was covering, not enough for it to read as a picture of
+ * somewhere else.
+ */
+export declare const SCREEN_LEASH_CELLS = 2;
+export declare const THUMB_ONE: {
+    width: number;
+    height: number;
+};
+export declare const THUMB_TWO: {
+    width: number;
+    height: number;
+};
+export declare function marqueeHeightFor(titles: readonly string[], cardWidth: number): number;
+/**
+ * Where everything sits, as a pure function of (focus, relation, graph),
+ * overlaid with user pins.
+ *
+ * Same graph and same view always produce the same picture — that is what
+ * lets spatial memory survive, and what lets any two states be interpolated
+ * into an animated transition.
+ */
+/**
+ * AN OPENED DISTRICT'S ROSTER, in arithmetic both sides share.
+ *
+ * The layout reserved 96 pixels under an opened district's nameplate and
+ * the view listed sixteen members in 250 — so a dealership's Vehicles,
+ * opened at the bottom of the city, ran its list off the scene and over the
+ * district beside it. The layout now reserves the rows it will be asked to
+ * hold, the view lists the rows it was given (`openedRows`), and the rest
+ * are counted.
+ */
+export declare const ROSTER_ROW = 27;
+/** The most rows a roster is given: past it the district is gone into. */
+export declare const ROSTER_MOST = 8;
+export declare const rosterRows: (count: number) => number;
+export declare const rosterHeight: (rows: number) => number;
+export declare function layout<S extends AnySchema>(graph: GraphReader<NodeOfSchema<S>>, schema: S, state: ViewState, options?: LayoutOptions): Layout;
+/** Which plane a node ended up on, or null if it is not in the layout. */
+export declare function planeOf(result: Layout, id: string): Plane | null;
+/**
+ * THE PAN, APPLIED AFTER THE FACT — the same answer, without the arithmetic.
+ *
+ * The pan is baked into every card's coordinates at layout time, and that is
+ * right: it is what lets two layouts be interpolated into motion, and it is
+ * why connectors, the frame planner and both renderers get panning without
+ * any of them learning about it.
+ *
+ * But it is applied at the END of a function that has already decided
+ * everything else — communities, plots, band packing, the drive-in's own
+ * sizing loop — and a drag changes nothing but the pan. Running all of that
+ * again per pointer move cost rota's city 169 dropped frames and ten
+ * seconds of blocked main thread in a two-second drag.
+ *
+ * So the pan comes out: lay the world out once at rest, and translate it.
+ * The result is the same object `layout` would have returned — held to that
+ * by `the-pan-is-a-translation` — and the caller can hold the expensive half
+ * still while a hand is moving.
+ *
+ * The city's own origin and extent are unpanned by definition (the ground
+ * rides `city.pan`), so only the cards, the lines between them and the
+ * recorded pan move.
+ */
+/**
+ * A CARD UNDER THE HAND, moved without laying the world out again.
+ *
+ * A pin only overrides where one card is; everything else about the stop —
+ * the band's grouping, the bundles, the districts — is what it was. Laying
+ * it all out again on every pointer move put a full `layout()` and a full
+ * bundle of every edge in every frame of a drag (docs/scale.md). This moves
+ * the held card to the pin (unpanned, as a pin is stored) and re-aims the
+ * lines that touch it. `null` when it cannot say the same thing a full
+ * layout would — a drive-in's screen, whose pin places it differently —
+ * and the caller lays it out with the pin instead. On release the pin goes
+ * into the view and the full layout runs once.
+ */
+export declare function holdLayout(placed: Layout, id: string, at: {
+    x: number;
+    y: number;
+}): Layout | null;
+export declare function panLayout(placed: Layout, pan: {
+    x: number;
+    y: number;
+}): Layout;
+//# sourceMappingURL=layout.d.ts.map

package/dist/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../src/layout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AACtG,OAAO,EAGL,KAAK,MAAM,EAEX,KAAK,aAAa,EAClB,KAAK,KAAK,EACX,MAAM,YAAY,CAAC;AAIpB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAsCjD;;;;;GAKG;AACH;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAyBpC,eAAO,MAAM,SAAS;;;CAA6B,CAAC;AACpD,eAAO,MAAM,SAAS;;;CAA4B,CAAC;AAGnD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAMrF;AA6CD;;;;;;;GAOG;AACH;;;;;;;;;GASG;AACH,eAAO,MAAM,UAAU,KAAK,CAAC;AAC7B,0EAA0E;AAC1E,eAAO,MAAM,WAAW,IAAI,CAAC;AAK7B,eAAO,MAAM,UAAU,GAAI,OAAO,MAAM,KAAG,MAAmD,CAAC;AAC/F,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,KAAG,MAA2C,CAAC;AAExF,wBAAgB,MAAM,CAAC,CAAC,SAAS,SAAS,EACxC,KAAK,EAAE,WAAW,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EACnC,MAAM,EAAE,CAAC,EACT,KAAK,EAAE,SAAS,EAChB,OAAO,GAAE,aAAkB,GAC1B,MAAM,CA+uCR;AAED,0EAA0E;AAC1E,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAEhE;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,GAAG,IAAI,CAiBlG;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAc/E"}