@graview/layout 0.1.0

package/dist/city.d.ts

@@ -0,0 +1,161 @@
+import { type AnySchema, type CityMap, type Plot } from "@graview/core";
+import type { CityFrame, Layout } from "./types.js";
+/**
+ * THE CITY AT ALTITUDE: districts on the lattice, one uniform scale.
+ *
+ * The map is the declaration's (`cityMap`): a kind's plot never moves
+ * because of what happened today or how wide the window is. What this
+ * file decides is only how the lattice meets the canvas — ONE scale and
+ * ONE translate, so the city keeps its shape at every width, rather than
+ * the per-axis stretch a ring needed to fill a wide canvas — and how big
+ * each district card is drawn: nearer rows larger, as the ring drew the
+ * near side of the ellipse larger, with the reader's unit honoured and
+ * given back only as far as the cards need to keep off each other.
+ */
+export interface CityCard {
+    readonly id: string;
+    readonly kind: string;
+    /** Members standing today, for the plot's side. */
+    readonly count: number;
+    /** Extra height this card asks for, opened in place. */
+    readonly opened: number;
+    /**
+     * The least of that the listing gives up to: a few rows it keeps however
+     * crowded the city is. Shrunk to nothing, an opened district of four kinds
+     * listed one and counted three — opening it answered nothing.
+     */
+    readonly openedMin?: number;
+    /**
+     * Extra height for a drive-in's marquee — the showings drawn as buttons
+     * under the nameplate. Not given back like the listing: a marquee
+     * clipped is a button nobody can press.
+     */
+    readonly marquee?: number;
+}
+export interface PlacedCard {
+    readonly id: string;
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+    readonly depth: number;
+    readonly plot: Plot;
+}
+/** Two drawn boxes sharing ground, with a little air required between them. */
+export declare function collides(a: {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}, b: {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}, air?: number): boolean;
+export declare function placeCity(cards: readonly CityCard[], schema: AnySchema, base: {
+    readonly width: number;
+    readonly height: number;
+}, canvas: {
+    readonly width: number;
+    readonly height: number;
+}, inset?: {
+    readonly left?: number;
+    readonly right?: number;
+}, options?: {
+    readonly order?: readonly string[];
+    readonly plots?: Readonly<Record<string, {
+        col: number;
+        row: number;
+    }>>;
+    readonly scale?: number;
+    /** The height a card is never drawn under, whatever the canvas — the layout's own floor. */
+    readonly minHeight?: number;
+    /** A factor on the fitted cell: the camera brought closer, the city allowed past the window. */
+    readonly zoom?: number;
+    /** The pan baked into the cards, recorded on the frame so the ground can tween with them. */
+    readonly pan?: {
+        readonly x: number;
+        readonly y: number;
+    };
+    /**
+     * Ground already taken — the picture standing in the middle from
+     * altitude. No district is laid under it: the city slides aside, and
+     * grows, until every district has ground of its own.
+     */
+    readonly avoid?: readonly {
+        readonly x: number;
+        readonly y: number;
+        readonly width: number;
+        readonly height: number;
+    }[];
+}): {
+    readonly placed: readonly PlacedCard[];
+    readonly frame: CityFrame;
+    readonly map: CityMap;
+};
+/**
+ * HOW FAR THE CAMERA MAY GO. A little way over a picture that fits — losing
+ * the scene off the edge of its own window is not panning, it is dropping
+ * it — and as far as the city reaches when the city is bigger than the
+ * window: every district is reachable, none is lost. Symmetric about the
+ * centre so the same limit serves both directions, and read by the scene
+ * and by the tests alike, so "reachable" means one thing.
+ */
+export declare function cameraLimit(result: {
+    readonly width: number;
+    readonly height: number;
+    readonly city?: CityFrame;
+}): {
+    readonly x: number;
+    readonly y: number;
+};
+/** A district the window does not reach, the edge it lies past, and the pan that brings it in. */
+export interface PastTheEdge {
+    /** The district's card: `kind:<kind>`. */
+    readonly id: string;
+    readonly kind: string;
+    readonly side: "left" | "right" | "top" | "bottom";
+    /** Where along that edge it lies, clamped to the canvas: y for left and right, x for top and bottom. */
+    readonly along: number;
+    /** The move that brings it a quarter of the way in from that edge. */
+    readonly by: {
+        readonly x: number;
+        readonly y: number;
+    };
+}
+/**
+ * THE EDGE SAYS WHAT IS PAST IT. A city wider than the window is reached
+ * by panning, and a district has a corner of its own that no phone is
+ * allowed to move — so on a 390-pixel phone the conference's Topics and
+ * Staff stood wholly off the canvas, with nothing on it saying they were
+ * there or which way to go. Every district whose middle is past the edge
+ * is named here with the side it lies past, so the scene can put a sign on
+ * that edge, and with the pan that brings it into the window.
+ */
+export declare function districtsPastTheEdge(result: Pick<Layout, "nodes" | "width" | "height" | "city">): readonly PastTheEdge[];
+/**
+ * THE PAN THAT KEEPS THE POINT UNDER THE POINTER STILL when the city is
+ * zoomed. The city is placed about the canvas's centre, so scaling its cell
+ * by `ratio` moves every point away from (or toward) the centre; the pan
+ * moves the opposite way by the pointer's share of that, and what was under
+ * the finger stays under it. Whole offset in, pan out: the camera's own
+ * flight is part of where the city is, and only the pan is the person's.
+ */
+export declare function panForZoom(pan: {
+    readonly x: number;
+    readonly y: number;
+}, camera: {
+    readonly x: number;
+    readonly y: number;
+}, pointer: {
+    readonly x: number;
+    readonly y: number;
+}, centre: {
+    readonly x: number;
+    readonly y: number;
+}, ratio: number): {
+    readonly x: number;
+    readonly y: number;
+};
+//# sourceMappingURL=city.d.ts.map

package/dist/city.d.ts.map

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

package/dist/city.js

@@ -0,0 +1,319 @@
+import { cityExtent, cityMap, toIso } from "@graview/core";
+/** Two drawn boxes sharing ground, with a little air required between them. */
+export function collides(a, b, air = 6) {
+    return (a.x < b.x + b.width + air &&
+        b.x < a.x + a.width + air &&
+        a.y < b.y + b.height + air &&
+        b.y < a.y + a.height + air);
+}
+/** The centre of a plot's diamond, in lattice pixels at `cell`. */
+const centreOf = (plot, cell) => toIso(plot.col + plot.side / 2, plot.row + plot.side / 2, cell);
+export function placeCity(cards, schema, base, canvas, inset = {}, options = {}) {
+    const counts = {};
+    for (const card of cards)
+        counts[card.kind] = card.count;
+    const map = cityMap(schema, {
+        ...(options.order ? { order: options.order } : {}),
+        counts,
+        ...(options.plots ? { plots: options.plots } : {}),
+    });
+    const left = inset.left ?? 0;
+    const span = canvas.width - left - (inset.right ?? 0);
+    const cx = left + span / 2;
+    const cy = canvas.height * 0.53;
+    /*
+     * ONE SCALE. The map's bounding diamond, at one pixel per cell, is
+     * fitted into the room the canvas has once a card's own size is taken
+     * off each edge — a card is centred on its plot and must not leave the
+     * canvas. The cell is then the same on both axes, which is the whole
+     * point: a city that was squashed to fit a wide window and stretched to
+     * fit a tall one had no shape of its own.
+     */
+    const extent = cityExtent(map);
+    const corners = [
+        toIso(extent.minCol, extent.minRow, 1),
+        toIso(extent.maxCol, extent.minRow, 1),
+        toIso(extent.minCol, extent.maxRow, 1),
+        toIso(extent.maxCol, extent.maxRow, 1),
+    ];
+    const minX = Math.min(...corners.map((c) => c.x));
+    const maxX = Math.max(...corners.map((c) => c.x));
+    const minY = Math.min(...corners.map((c) => c.y));
+    const maxY = Math.max(...corners.map((c) => c.y));
+    const spread = { x: Math.max(1, maxX - minX), y: Math.max(0.5, maxY - minY) };
+    const roomX = Math.max(40, span - base.width * 1.1);
+    const roomY = Math.max(24, canvas.height * 0.62 - base.height * 1.1);
+    const fitted = Math.max(18, Math.min(160, roomX / spread.x, roomY / spread.y));
+    const scale = options.scale ?? 1;
+    const minHeight = options.minHeight ?? 0;
+    const avoid = options.avoid ?? [];
+    /** Where the whole city is slid to stand beside the rails rather than under them (see below). */
+    let nudge = 0;
+    const at = (cell, asked, openedShare = 1, shift = { x: 0, y: 0 }) => {
+        const originX = cx - ((minX + maxX) / 2) * cell + shift.x + nudge;
+        const originY = cy - ((minY + maxY) / 2) * cell + shift.y;
+        const size = { width: base.width * asked, height: base.height * asked };
+        const rows = cards.map((card) => centreOf(map.get(card.kind), cell).y);
+        const lowest = Math.max(...rows);
+        const highest = Math.min(...rows);
+        return cards.map((card) => {
+            const plot = map.get(card.kind);
+            const centre = centreOf(plot, cell);
+            /*
+             * NEARNESS FROM THE ROW. Lower on the ground is nearer the viewer,
+             * exactly as the bottom of the ring was: 1 there, 0 at the top, and
+             * the depth number everything else reads (`1 − near·0.65`) is
+             * unchanged so the plane styles and the altitude opacity are too.
+             */
+            const near = lowest === highest ? 0.5 : (centre.y - highest) / (lowest - highest);
+            const grow = 0.85 + near * 0.45;
+            const width = size.width * grow;
+            const base = Math.max(minHeight, size.height * grow);
+            const height = base + (card.marquee ?? 0) + (card.opened > 0 ? Math.max(card.openedMin ?? 0, card.opened * openedShare) : 0);
+            /*
+             * NOT HELD INSIDE THE CANVAS. The ring pushed its near card back in
+             * from the edge; a city has a shape, and a district pushed off its
+             * corner to fit a phone is a district on the wrong corner. A city
+             * wider than the window is reached by panning, which the camera
+             * bounds to the map's extent for exactly this reason.
+             */
+            /*
+             * The NAMEPLATE is centred on the plot; what hangs under it — a
+             * marquee, an opened listing — grows DOWNWARD, so the top of the card
+             * stays where the plot's far half is, and a screen standing at the
+             * far edge is never covered by its own district's growth.
+             */
+            return {
+                id: card.id,
+                x: originX + centre.x - width / 2,
+                y: originY + centre.y - base / 2,
+                width,
+                height,
+                depth: 1 - near * 0.65,
+                plot,
+            };
+        });
+    };
+    const crowded = (placed) => placed.some((one, index) => placed.some((other, index2) => index2 !== index && collides(one, other))) ||
+        placed.some((one) => avoid.some((box) => collides(one, box)));
+    /*
+     * The reader's unit is given back first, down to the size a card has
+     * always been; and when the cards still stand in each other at that
+     * size, the CITY grows — the cell widens until every district has its
+     * own ground — rather than the cards shrinking below what their names
+     * need. A district's legibility is not the window's to take.
+     */
+    /*
+     * THE CITY SLIDES ASIDE for the picture in the middle, when there is one.
+     * A district on the map's own centre stands exactly where the live view
+     * stands, and no amount of growing moves it — scaling about the centre
+     * keeps the centre where it is. So the map is tried in place first, and
+     * then shifted: by the width of what it must clear, right, left, down,
+     * up, and the diagonals — the first shift with every district on ground
+     * of its own is the one kept. No picture in the middle means no shift.
+     */
+    const shifts = (cell) => {
+        if (avoid.length === 0)
+            return [{ x: 0, y: 0 }];
+        const dx = Math.max(...avoid.map((box) => box.width)) / 2 + cell;
+        const dy = Math.max(...avoid.map((box) => box.height)) / 2 + cell / 2;
+        const out = [{ x: 0, y: 0 }];
+        for (const share of [0.5, 0.75, 1, 1.25]) {
+            const sx = dx * share;
+            const sy = dy * share;
+            out.push({ x: sx, y: 0 }, { x: -sx, y: 0 }, { x: 0, y: sy }, { x: 0, y: -sy }, { x: sx, y: sy }, { x: -sx, y: sy }, { x: sx, y: -sy }, { x: -sx, y: -sy });
+        }
+        return out;
+    };
+    /** How much of the city is off the canvas: the shift that shows the most is the one kept. */
+    const right = canvas.width - (inset.right ?? 0);
+    const outside = (placed) => placed.reduce((sum, card) => {
+        const visibleW = Math.max(0, Math.min(card.x + card.width, canvas.width) - Math.max(card.x, 0));
+        const visibleH = Math.max(0, Math.min(card.y + card.height, canvas.height) - Math.max(card.y, 0));
+        return sum + card.width * card.height - visibleW * visibleH;
+    }, 0);
+    const settle = (cell, asked, openedShare) => {
+        let best;
+        let fallback;
+        for (const shift of shifts(cell)) {
+            const placed = at(cell, asked, openedShare, shift);
+            if (crowded(placed)) {
+                fallback ??= { placed, shift };
+                continue;
+            }
+            const off = outside(placed);
+            if (!best || off < best.off - 0.5)
+                best = { placed, shift, off };
+        }
+        return best ?? fallback;
+    };
+    let cell = fitted;
+    let asked = scale;
+    let openedShare = 1;
+    let settled = settle(cell, asked, openedShare);
+    while (crowded(settled.placed) && asked > 1.001) {
+        asked = Math.max(1, asked - 0.05);
+        settled = settle(cell, asked, openedShare);
+    }
+    /*
+     * An opened district's listing is the luxury and the city is the picture:
+     * in a short canvas the listing gives up its room before the city has to
+     * grow past the window, exactly as the ring's listing gave up its room
+     * before the ring gave up being a ring.
+     */
+    while (crowded(settled.placed) && openedShare > 0.3) {
+        openedShare = Math.max(0.3, openedShare - 0.1);
+        settled = settle(cell, asked, openedShare);
+    }
+    /*
+     * A SMALLER CITY BEFORE A CITY OFF THE EDGE. With a picture standing in
+     * the middle, the map fitted to the room may not stand beside it and
+     * stay on the canvas; a tighter lattice usually can, and the districts
+     * keep their size — only the streets between them shorten. So the cell
+     * is tried smaller, down to where the districts would touch, and the
+     * largest cell whose every district is on the canvas is the one kept.
+     * Only when no cell will do does the city grow past the window.
+     */
+    if (crowded(settled.placed) || outside(settled.placed) > 0) {
+        let best = crowded(settled.placed) ? undefined : { cell, settled, off: outside(settled.placed) };
+        for (let share = 0.9; share >= 0.3; share -= 0.1) {
+            const tighter = fitted * share;
+            const trial = settle(tighter, asked, openedShare);
+            if (crowded(trial.placed))
+                continue;
+            const off = outside(trial.placed);
+            if (!best || off < best.off - 0.5)
+                best = { cell: tighter, settled: trial, off };
+            if (off === 0)
+                break;
+        }
+        if (best) {
+            cell = best.cell;
+            settled = best.settled;
+        }
+    }
+    for (let grown = 0; crowded(settled.placed) && grown < 80; grown++) {
+        cell *= 1.06;
+        settled = settle(cell, asked, openedShare);
+    }
+    /*
+     * BESIDE THE RAILS, NOT UNDER THEM. The map is centred on its lattice's
+     * bounding diamond, and the districts are not: a card is centred on its
+     * plot and the plots do not fill the diamond, so a city grown just wide
+     * enough for its names stood twenty-five pixels left of the room it
+     * fitted — and the leftmost district under the inspector. When the
+     * districts fit between the rails, the city slides the least distance
+     * that puts every one of them there; when they do not, the camera pans
+     * to them, as before.
+     */
+    // With a picture standing in the middle the city has already stepped aside for it, and that placement stands.
+    if (avoid.length === 0) {
+        const lowX = Math.min(...settled.placed.map((card) => card.x));
+        const highX = Math.max(...settled.placed.map((card) => card.x + card.width));
+        const slide = highX - lowX > right - left ? 0 : lowX < left ? left - lowX : highX > right ? right - highX : 0;
+        if (slide !== 0) {
+            nudge = slide;
+            const slid = at(cell, asked, openedShare, settled.shift);
+            if (crowded(slid))
+                nudge = 0;
+            else
+                settled = { placed: slid, shift: settled.shift };
+        }
+    }
+    /*
+     * FLYING CLOSER. The fit above is the whole map in the window; a zoom is
+     * the camera brought in afterwards, so the map keeps its shape and only
+     * the cell grows — the city may run past the window, and the camera
+     * pans to reach it.
+     */
+    if (options.zoom && options.zoom !== 1) {
+        cell *= options.zoom;
+        nudge *= options.zoom;
+        settled = settle(cell, asked, openedShare);
+    }
+    const placed = settled.placed;
+    const originX = cx - ((minX + maxX) / 2) * cell + settled.shift.x + nudge;
+    const originY = cy - ((minY + maxY) / 2) * cell + settled.shift.y;
+    const frame = {
+        cell,
+        originX,
+        originY,
+        pan: options.pan ?? { x: 0, y: 0 },
+        extent: {
+            x: originX + minX * cell,
+            y: originY + minY * cell,
+            width: spread.x * cell,
+            height: spread.y * cell,
+        },
+        openedShare,
+    };
+    return { placed, frame, map };
+}
+/**
+ * HOW FAR THE CAMERA MAY GO. A little way over a picture that fits — losing
+ * the scene off the edge of its own window is not panning, it is dropping
+ * it — and as far as the city reaches when the city is bigger than the
+ * window: every district is reachable, none is lost. Symmetric about the
+ * centre so the same limit serves both directions, and read by the scene
+ * and by the tests alike, so "reachable" means one thing.
+ */
+export function cameraLimit(result) {
+    const slack = { x: result.width * 0.45, y: result.height * 0.45 };
+    if (!result.city)
+        return slack;
+    const { extent } = result.city;
+    const margin = 24;
+    return {
+        x: Math.max(slack.x, extent.x + extent.width - result.width + margin, -extent.x + margin),
+        y: Math.max(slack.y, extent.y + extent.height - result.height + margin, -extent.y + margin),
+    };
+}
+/** How far in from an edge a district brought into the window stands, at the least: room for its nameplate's height. */
+const EDGE_CLEAR = 48;
+/**
+ * THE EDGE SAYS WHAT IS PAST IT. A city wider than the window is reached
+ * by panning, and a district has a corner of its own that no phone is
+ * allowed to move — so on a 390-pixel phone the conference's Topics and
+ * Staff stood wholly off the canvas, with nothing on it saying they were
+ * there or which way to go. Every district whose middle is past the edge
+ * is named here with the side it lies past, so the scene can put a sign on
+ * that edge, and with the pan that brings it into the window.
+ */
+export function districtsPastTheEdge(result) {
+    if (!result.city)
+        return [];
+    const { width, height } = result;
+    const out = [];
+    for (const node of result.nodes) {
+        if (!node.id.startsWith("kind:") || Math.round(node.plane) !== 2)
+            continue;
+        const cx = node.x + node.width / 2;
+        const cy = node.y + node.height / 2;
+        const side = cx < 0 ? "left" : cx > width ? "right" : cy < 0 ? "top" : cy > height ? "bottom" : null;
+        if (!side)
+            continue;
+        const across = side === "left" || side === "right";
+        const along = across ? Math.max(0, Math.min(height, cy)) : Math.max(0, Math.min(width, cx));
+        // A quarter of the way in from the edge it was past; along that edge, only as far as keeps it off the other two.
+        const inward = (at, span) => (at < span / 4 ? span / 4 - at : at > (span * 3) / 4 ? (span * 3) / 4 - at : 0);
+        const clear = (at, span) => (at < EDGE_CLEAR ? EDGE_CLEAR - at : at > span - EDGE_CLEAR ? span - EDGE_CLEAR - at : 0);
+        const by = across ? { x: inward(cx, width), y: clear(cy, height) } : { x: clear(cx, width), y: inward(cy, height) };
+        out.push({ id: node.id, kind: node.id.slice("kind:".length), side, along, by });
+    }
+    return out;
+}
+/**
+ * THE PAN THAT KEEPS THE POINT UNDER THE POINTER STILL when the city is
+ * zoomed. The city is placed about the canvas's centre, so scaling its cell
+ * by `ratio` moves every point away from (or toward) the centre; the pan
+ * moves the opposite way by the pointer's share of that, and what was under
+ * the finger stays under it. Whole offset in, pan out: the camera's own
+ * flight is part of where the city is, and only the pan is the person's.
+ */
+export function panForZoom(pan, camera, pointer, centre, ratio) {
+    return {
+        x: pan.x + (pointer.x - pan.x - camera.x - centre.x) * (1 - ratio),
+        y: pan.y + (pointer.y - pan.y - camera.y - centre.y) * (1 - ratio),
+    };
+}
+//# sourceMappingURL=city.js.map

package/dist/city.js.map

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

package/dist/ids.d.ts

@@ -0,0 +1,79 @@
+import { type ViewState } from "./view-state.js";
+export declare const AGGREGATE_PREFIX = "aggregate:";
+/**
+ * The kinds plane's cards have ids of their own.
+ *
+ * They cannot share `aggregate:<kind>` with a focusable group, because an app
+ * whose primary view IS one kind — the coaching example's formation is
+ * `aggregate:position` — would then place the same id twice: once as the
+ * focus and once as its own card in the strip. The strip is a MAP of kinds,
+ * not a set of groups you focus, so it gets its own namespace.
+ */
+export declare const KIND_PREFIX = "kind:";
+export declare function kindCardId(kind: string): string;
+export declare function kindOfCard(id: string): string | null;
+/**
+ * The card that stands for the districts the row could not hold.
+ *
+ * Its own id rather than a kind's, because it is not a kind: it is the row
+ * saying what it had to leave out, and naming them.
+ */
+export declare const BEYOND_CARD = "kinds:beyond";
+/** The kinds an id stands for, whichever namespace it is in. */
+export declare function kindsOf(id: string): string[];
+/**
+ * The id of a group standing in for one or more kinds.
+ *
+ * Several kinds because a group is a view of a SET of kinds, not a synonym
+ * for one: the household example's week is its blocks and its runs together, and no node
+ * kind called "week" exists or should. Kinds are sorted so the same group is
+ * always the same id, which keeps it stable in a URL.
+ */
+export declare function aggregateId(...kinds: readonly string[]): string;
+export declare function isAggregateId(id: string): boolean;
+/** The kinds a group id names, or an empty list if it is not a group id. */
+export declare function kindsOfAggregate(id: string): string[];
+/**
+ * Going deeper into a card, as view state.
+ *
+ * A record ZOOMS: the same scene with the record grown to most of it, and
+ * the same gesture on the zoomed record zooms back out. A KIND CARD stands
+ * for a group, so deeper means the group: on the ground it zooms into the
+ * group as a place (`aggregate:<kind>`), and from altitude it opens the
+ * district in place — the exploded view — and the same gesture closes it.
+ *
+ * UNLESS THE KIND HAS A PICTURE OF ITS OWN. A district explodes into a ring
+ * of chips because a bag of names is the best a generic card can do with its
+ * members. A kind with a lens registered over it has something better, and
+ * the card already says so with its ◆ — so "deeper" there means that
+ * picture, and the district stays shut. Exploding it replaced a designed
+ * view with the fallback it exists to improve on.
+ *
+ * The card's own id (`kind:<kind>`) is never made the focus. A focus
+ * resolves to a node or to a group's kinds, and a kind card is neither: a
+ * focus on one laid out an empty scene with the card's name in the URL,
+ * which is what double-clicking a group looked like before this existed.
+ */
+export declare function withJackIn(state: ViewState, id: string, options?: {
+    readonly ownPicture?: boolean;
+    /**
+     * Words to carry into a district: the search that lit it. Descending
+     * into a lit district opens it already narrowed — the arrangement's own
+     * `in.q` — so the row shows why, and clearing the row clears only that.
+     */
+    readonly carry?: string;
+}): ViewState;
+/**
+ * Ranks by a STABLE key — the node id — and never by a mutable count.
+ *
+ * This is the single rule that protects spatial memory. Ordering people by
+ * "how many runs they have" would reshuffle the whole plane the moment
+ * anything is reassigned, and the picture you remember would stop being the
+ * picture you get.
+ */
+export declare function byStableKey(a: {
+    id: string;
+}, b: {
+    id: string;
+}): number;
+//# sourceMappingURL=ids.d.ts.map

package/dist/ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../src/ids.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiE,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAShH,eAAO,MAAM,gBAAgB,eAAe,CAAC;AAE7C;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,UAAU,CAAC;AAEnC,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEpD;AAED;;;;;GAKG;AACH,eAAO,MAAM,WAAW,iBAAiB,CAAC;AAE1C,gEAAgE;AAChE,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAG5C;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,GAAG,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAE/D;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED,4EAA4E;AAC5E,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAIrD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,SAAS,EAChB,EAAE,EAAE,MAAM,EACV,OAAO,GAAE;IACP,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACpB,GACL,SAAS,CAuBX;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,EAAE;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAExE"}