@graview/react 0.1.0

package/dist/pointer.js

@@ -0,0 +1,39 @@
+export function createPointerStore() {
+    let point = null;
+    const listeners = new Set();
+    const watchers = new Set();
+    const tell = (active) => {
+        for (const watcher of watchers)
+            watcher(active);
+    };
+    return {
+        subscribe(listener) {
+            listeners.add(listener);
+            if (listeners.size === 1)
+                tell(true);
+            return () => {
+                listeners.delete(listener);
+                if (listeners.size === 0) {
+                    point = null;
+                    tell(false);
+                }
+            };
+        },
+        snapshot: () => point,
+        set(next) {
+            if (point === next || (point && next && point.x === next.x && point.y === next.y))
+                return;
+            point = next;
+            for (const listener of listeners)
+                listener();
+        },
+        get listeners() {
+            return listeners.size;
+        },
+        onActive(watcher) {
+            watchers.add(watcher);
+            return () => void watchers.delete(watcher);
+        },
+    };
+}
+//# sourceMappingURL=pointer.js.map

package/dist/pointer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pointer.js","sourceRoot":"","sources":["../src/pointer.ts"],"names":[],"mappings":"AA2BA,MAAM,UAAU,kBAAkB;IAChC,IAAI,KAAK,GAAsB,IAAI,CAAC;IACpC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAc,CAAC;IACxC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA6B,CAAC;IACtD,MAAM,IAAI,GAAG,CAAC,MAAe,EAAE,EAAE;QAC/B,KAAK,MAAM,OAAO,IAAI,QAAQ;YAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAClD,CAAC,CAAC;IACF,OAAO;QACL,SAAS,CAAC,QAAQ;YAChB,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACxB,IAAI,SAAS,CAAC,IAAI,KAAK,CAAC;gBAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YACrC,OAAO,GAAG,EAAE;gBACV,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBAC3B,IAAI,SAAS,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;oBACzB,KAAK,GAAG,IAAI,CAAC;oBACb,IAAI,CAAC,KAAK,CAAC,CAAC;gBACd,CAAC;YACH,CAAC,CAAC;QACJ,CAAC;QACD,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK;QACrB,GAAG,CAAC,IAAI;YACN,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,IAAI,KAAK,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;gBAAE,OAAO;YAC1F,KAAK,GAAG,IAAI,CAAC;YACb,KAAK,MAAM,QAAQ,IAAI,SAAS;gBAAE,QAAQ,EAAE,CAAC;QAC/C,CAAC;QACD,IAAI,SAAS;YACX,OAAO,SAAS,CAAC,IAAI,CAAC;QACxB,CAAC;QACD,QAAQ,CAAC,OAAO;YACd,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACtB,OAAO,GAAG,EAAE,CAAC,KAAK,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC7C,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/presence.d.ts

@@ -0,0 +1,110 @@
+import { type AnySchema, type Presence, type PresenceChannel, type Principal, type SettingDeclaration, type Store } from "@graview/core";
+import { type ViewState } from "@graview/layout";
+import type { DrawnBox } from "./context.js";
+import { type RobotState } from "./robot.js";
+/**
+ * ONE ID PER TAB, kept for the tab's life. It fills `Author.session` on
+ * this tab's ops AND the presence key, so the log's `participantOf(op)`
+ * and the figure standing on the map are the same person by construction.
+ * (Before this, every seat's session was "ui", and two tabs of one seat
+ * were one participant.)
+ */
+export declare function tabSession(): string;
+/**
+ * PRIVACY IS A READER SETTING, in the profile pane with the others and kept
+ * in the browser, never the graph. Where you are is shared by default for
+ * a named seat and never for an anonymous one; what you point at is
+ * private until you say otherwise.
+ */
+export declare const SHARE_WHERE: SettingDeclaration;
+export declare const SHARE_OVER: SettingDeclaration;
+export declare const PRESENCE_SETTINGS: readonly SettingDeclaration[];
+/** How often a tab says where it is, unprompted: the served poll's own pace. */
+export declare const HEARTBEAT_MS = 800;
+export type Placed = {
+    readonly kind: "person";
+    readonly presence: Presence;
+    readonly point: {
+        x: number;
+        y: number;
+    };
+    /** What they stand at: a plot, or the audience row of a screen. */
+    readonly at: string;
+    readonly index: number;
+    readonly of: number;
+    readonly audience: boolean;
+} | {
+    readonly kind: "edge";
+    readonly presence: Presence;
+    readonly point: {
+        x: number;
+        y: number;
+    };
+} | {
+    readonly kind: "count";
+    readonly at: string;
+    readonly point: {
+        x: number;
+        y: number;
+    };
+    readonly n: number;
+} | {
+    readonly kind: "robot";
+    readonly presence: Presence;
+    readonly point: {
+        x: number;
+        y: number;
+    };
+    readonly mode: string;
+} | {
+    readonly kind: "over";
+    readonly presence: Presence;
+    readonly box: DrawnBox;
+};
+/** How many stand in a row before the rest are a number. */
+export declare const AUDIENCE_ROW = 3;
+/** Where a stop puts somebody: the audience row of the showing they are watching, else the plot their focus names. */
+export declare function anchorOf(stop: string): {
+    readonly at: string;
+    readonly audience: boolean;
+} | null;
+/**
+ * THE OTHERS, PLACED. Pure — a test can ask what a viewer would draw from
+ * a list of presences and a `whereIs`. People at one anchor stand in a
+ * row; past `AUDIENCE_ROW` the rest are "+n". Anonymous viewers are a count
+ * at their plot, never a figure. Somebody whose stop is nowhere on this
+ * map is an indicator at the edge, named. A robot stands where its owner's
+ * presence says, captioned as theirs; a shared hover is an outline.
+ */
+export declare function placeOthers(who: readonly Presence[], whereIs: (id: string) => DrawnBox | null, width: number): Placed[];
+export interface PresenceInputs<S extends AnySchema> {
+    readonly channel: PresenceChannel | undefined;
+    readonly store: Store<S>;
+    readonly view: ViewState;
+    readonly principal: Principal;
+    readonly session: string;
+    readonly robots: ReadonlyMap<string, RobotState>;
+    readonly seatWho: string | null;
+    readonly settingValues: Readonly<Record<string, string>>;
+    setView(next: ViewState | ((current: ViewState) => ViewState)): void;
+}
+export interface PresenceState {
+    /** The others, by participant. Empty without a channel. */
+    readonly who: ReadonlyMap<string, Presence>;
+    /** How this tab is seen, or null when it broadcasts nothing. */
+    readonly sharing: {
+        readonly participant: string;
+        readonly name: string;
+    } | null;
+    /** Whose stop this tab is adopting, if anybody's. */
+    readonly following: Presence | null;
+    follow(participant: string | null): void;
+}
+/**
+ * Owned by the provider beside the activity and the robots. Publishes on
+ * view change, robot change and heartbeat; folds what the channel says
+ * into `who`; adopts a followed person's stop until you move yourself or
+ * press Escape. Nothing ever writes presence to the store.
+ */
+export declare function usePresenceState<S extends AnySchema>(inputs: PresenceInputs<S>): PresenceState;
+//# sourceMappingURL=presence.d.ts.map

package/dist/presence.d.ts.map

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

package/dist/presence.js

@@ -0,0 +1,280 @@
+import { hueFor } from "@graview/core";
+import { fromUrl, kindsOfAggregate, sameView, toUrl } from "@graview/layout";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { pickedFrom } from "./picking.js";
+import { participantOf as keyOf } from "./robot.js";
+/*
+ * WHO IS WHERE — the others, on your own map.
+ *
+ * Presence is a payload and never a pixel: a participant, the stop they are
+ * on (`toUrl(view)`, the complete answer), what they are hovering if they
+ * chose to share it, where their robot stands, and when they last said so.
+ * Each viewer places the others with its own `whereIs`, so two windows of
+ * different sizes agree about who is at the tasks plot while agreeing about
+ * nothing else. Nothing here writes to the store: a person standing
+ * somewhere is a fact about that person at that screen, like their text
+ * size — the recorded precedent is `settings.ts`.
+ */
+const SESSION_KEY = "graview:session";
+/**
+ * ONE ID PER TAB, kept for the tab's life. It fills `Author.session` on
+ * this tab's ops AND the presence key, so the log's `participantOf(op)`
+ * and the figure standing on the map are the same person by construction.
+ * (Before this, every seat's session was "ui", and two tabs of one seat
+ * were one participant.)
+ */
+export function tabSession() {
+    const fresh = () => typeof crypto !== "undefined" && "randomUUID" in crypto ? crypto.randomUUID().slice(0, 8) : Math.random().toString(36).slice(2, 10);
+    try {
+        const held = sessionStorage.getItem(SESSION_KEY);
+        if (held)
+            return held;
+        const made = fresh();
+        sessionStorage.setItem(SESSION_KEY, made);
+        return made;
+    }
+    catch {
+        // A private window or a test: this visit still has a session, it is just not remembered.
+        return fresh();
+    }
+}
+/**
+ * PRIVACY IS A READER SETTING, in the profile pane with the others and kept
+ * in the browser, never the graph. Where you are is shared by default for
+ * a named seat and never for an anonymous one; what you point at is
+ * private until you say otherwise.
+ */
+export const SHARE_WHERE = {
+    name: "share-where",
+    title: "Where you are",
+    description: "Whether the others here see which stop you are on.",
+    honoured: "root-attribute",
+    options: [
+        { value: "shared", label: "Shown" },
+        { value: "private", label: "Hidden" },
+    ],
+    initial: "shared",
+};
+export const SHARE_OVER = {
+    name: "share-over",
+    title: "What you point at",
+    description: "Whether the others see the thing under your pointer, outlined in your colour.",
+    honoured: "root-attribute",
+    // Four labels, all different: two pairs reading "Seen / Private" put the
+    // same word twice on the pane, which the audit counts as the repeat it is.
+    options: [
+        { value: "private", label: "Kept to yourself" },
+        { value: "shared", label: "Outlined for others" },
+    ],
+    initial: "private",
+};
+export const PRESENCE_SETTINGS = [SHARE_WHERE, SHARE_OVER];
+/** How often a tab says where it is, unprompted: the served poll's own pace. */
+export const HEARTBEAT_MS = 800;
+/** How many stand in a row before the rest are a number. */
+export const AUDIENCE_ROW = 3;
+/** Where a stop puts somebody: the audience row of the showing they are watching, else the plot their focus names. */
+export function anchorOf(stop) {
+    const view = fromUrl(stop);
+    const focus = view.focusId;
+    if (!focus)
+        return null;
+    const showing = view.within?.["view"];
+    if (showing) {
+        const [kind] = kindsOfAggregate(focus);
+        if (kind)
+            return { at: `screen:${kind}`, audience: true };
+    }
+    return { at: focus, audience: false };
+}
+/**
+ * THE OTHERS, PLACED. Pure — a test can ask what a viewer would draw from
+ * a list of presences and a `whereIs`. People at one anchor stand in a
+ * row; past `AUDIENCE_ROW` the rest are "+n". Anonymous viewers are a count
+ * at their plot, never a figure. Somebody whose stop is nowhere on this
+ * map is an indicator at the edge, named. A robot stands where its owner's
+ * presence says, captioned as theirs; a shared hover is an outline.
+ */
+export function placeOthers(who, whereIs, width) {
+    const placed = [];
+    const rows = new Map();
+    const counts = new Map();
+    let edges = 0;
+    for (const presence of who) {
+        const anchor = anchorOf(presence.stop);
+        const box = anchor ? whereIs(anchor.at) : null;
+        if (!anchor || !box) {
+            if (presence.name) {
+                placed.push({ kind: "edge", presence, point: { x: width - 8, y: 40 + edges++ * 28 } });
+            }
+            continue;
+        }
+        if (!presence.name) {
+            const held = counts.get(anchor.at);
+            counts.set(anchor.at, { n: (held?.n ?? 0) + 1, box });
+            continue;
+        }
+        const row = rows.get(anchor.at) ?? [];
+        row.push(presence);
+        rows.set(anchor.at, row);
+        if (row.length > AUDIENCE_ROW)
+            continue;
+        const anchorBox = box;
+        const index = row.length - 1;
+        // A row in front of the screen; a huddle at a plot's foot, a little left of its robot.
+        const point = anchor.audience
+            ? { x: anchorBox.x + anchorBox.width * 0.5 + (index - 1) * 26, y: anchorBox.y + Math.min(anchorBox.height, 24) }
+            : { x: anchorBox.x + anchorBox.width * 0.5 - 26 - index * 22, y: anchorBox.y + anchorBox.height - 4 };
+        placed.push({ kind: "person", presence, point, at: anchor.at, index, of: row.length, audience: anchor.audience });
+    }
+    for (const [at, row] of rows) {
+        if (row.length <= AUDIENCE_ROW)
+            continue;
+        const box = whereIs(at);
+        if (!box)
+            continue;
+        placed.push({ kind: "count", at, point: { x: box.x + box.width * 0.5 + 2 * 26 + 18, y: box.y + box.height - 4 }, n: row.length - AUDIENCE_ROW });
+    }
+    for (const [at, { n, box }] of counts) {
+        placed.push({ kind: "count", at, point: { x: box.x + box.width * 0.5 + 40, y: box.y + box.height - 4 }, n });
+    }
+    for (const presence of who) {
+        if (!presence.name)
+            continue;
+        if (presence.robot?.at && presence.robot.mode !== "docked") {
+            const box = whereIs(presence.robot.at);
+            if (box)
+                placed.push({ kind: "robot", presence, point: { x: box.x + box.width / 2 + 22, y: box.y + box.height - 4 }, mode: presence.robot.mode });
+        }
+        if (presence.over) {
+            const box = whereIs(presence.over);
+            if (box)
+                placed.push({ kind: "over", presence, box });
+        }
+    }
+    return placed;
+}
+/**
+ * Owned by the provider beside the activity and the robots. Publishes on
+ * view change, robot change and heartbeat; folds what the channel says
+ * into `who`; adopts a followed person's stop until you move yourself or
+ * press Escape. Nothing ever writes presence to the store.
+ */
+export function usePresenceState(inputs) {
+    const { channel, store, view, principal, session, robots, seatWho, settingValues, setView } = inputs;
+    const [who, setWho] = useState(() => new Map());
+    const [over, setOver] = useState(null);
+    const [followingId, setFollowingId] = useState(null);
+    const named = typeof principal.id === "string" && principal.id.length > 0;
+    const shareWhere = named && (settingValues[SHARE_WHERE.name] ?? SHARE_WHERE.initial) === "shared";
+    const shareOver = shareWhere && (settingValues[SHARE_OVER.name] ?? SHARE_OVER.initial) === "shared";
+    const participant = keyOf({ kind: principal.kind, ...(principal.id ? { id: principal.id } : {}), session });
+    const name = named ? String(store.graph.getNode(principal.id)?.label ?? principal.id) : "";
+    /* What this tab says about itself — recomputed when anything in it moves. */
+    const robot = seatWho ? robots.get(`agent:${seatWho}:${session}`) : undefined;
+    const mine = useMemo(() => {
+        if (!channel || !shareWhere)
+            return null;
+        return {
+            participant,
+            name,
+            hue: hueFor(principal.id ?? "nobody"),
+            stop: toUrl(view),
+            ...(shareOver ? { over } : {}),
+            ...(robot ? { robot: { at: robot.at, mode: robot.mode } } : {}),
+            at: new Date().toISOString(),
+        };
+    }, [channel, shareWhere, shareOver, participant, name, principal.id, view, over, robot?.at, robot?.mode]);
+    /* Say it: on change, and on the heartbeat while it stands. */
+    useEffect(() => {
+        if (!channel)
+            return;
+        if (!mine)
+            return;
+        channel.here(mine);
+        const beat = setInterval(() => channel.here({ ...mine, at: new Date().toISOString() }), HEARTBEAT_MS);
+        return () => clearInterval(beat);
+    }, [channel, mine]);
+    /* Hear it. */
+    useEffect(() => {
+        if (!channel)
+            return;
+        const stop = channel.onWho((others) => setWho(new Map(others.map((presence) => [presence.participant, presence]))));
+        return stop;
+    }, [channel]);
+    /* Leave when the page goes, not only when React unmounts. */
+    useEffect(() => {
+        if (!channel || typeof window === "undefined")
+            return;
+        const gone = () => channel.leave();
+        window.addEventListener("pagehide", gone);
+        return () => window.removeEventListener("pagehide", gone);
+    }, [channel]);
+    /* What you point at, only while you share it: read the way a click reads it. */
+    useEffect(() => {
+        if (!shareOver || typeof document === "undefined")
+            return;
+        let last = null;
+        const moved = (event) => {
+            const picked = pickedFrom(event.target);
+            if (picked === last)
+                return;
+            last = picked;
+            setOver(picked);
+        };
+        document.addEventListener("pointermove", moved, { passive: true });
+        return () => document.removeEventListener("pointermove", moved);
+    }, [shareOver]);
+    /* FOLLOW A PERSON: adopt their stop as it changes, until you move yourself or press Escape. */
+    const adopted = useRef(null);
+    const following = followingId ? (who.get(followingId) ?? null) : null;
+    const follow = useCallback((next) => {
+        adopted.current = null;
+        setFollowingId(next);
+    }, []);
+    useEffect(() => {
+        if (!followingId)
+            return;
+        if (!following) {
+            // They left. Nothing to follow.
+            setFollowingId(null);
+            return;
+        }
+        if (following.stop === adopted.current?.stop)
+            return;
+        adopted.current = { stop: following.stop, at: Date.now() };
+        setView(fromUrl(following.stop));
+    }, [followingId, following, setView]);
+    useEffect(() => {
+        const held = adopted.current;
+        if (!followingId || held === null)
+            return;
+        /*
+         * A stop of your own is you leaving: the mirror of navigating away from
+         * a robot. Compared as views, not strings, and not in the moment of
+         * landing — the provider resolves an adopted stop against what this
+         * seat may see, and that resolution is arrival, not departure.
+         */
+        if (Date.now() - held.at < 400)
+            return;
+        if (!sameView(view, fromUrl(held.stop)))
+            setFollowingId(null);
+    }, [view, followingId]);
+    useEffect(() => {
+        if (!followingId || typeof document === "undefined")
+            return;
+        const onKey = (event) => {
+            if (event.key === "Escape")
+                setFollowingId(null);
+        };
+        document.addEventListener("keydown", onKey);
+        return () => document.removeEventListener("keydown", onKey);
+    }, [followingId]);
+    return useMemo(() => ({
+        who,
+        sharing: mine ? { participant, name } : null,
+        following,
+        follow,
+    }), [who, mine, participant, name, following, follow]);
+}
+//# sourceMappingURL=presence.js.map

package/dist/presence.js.map

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

package/dist/rails.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The rail the layout keeps clear on each side of the picture, by width.
+ * A full-size scene reserves 264 and 128; a narrow one, where the panes
+ * are sheets rather than rails, keeps only the corner the altitude control
+ * stands in.
+ */
+export declare function railInset(width: number): {
+    left: number;
+    right: number;
+};
+//# sourceMappingURL=rails.d.ts.map

package/dist/rails.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rails.d.ts","sourceRoot":"","sources":["../src/rails.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAMxE"}

package/dist/rails.js

@@ -0,0 +1,15 @@
+/**
+ * The rail the layout keeps clear on each side of the picture, by width.
+ * A full-size scene reserves 264 and 128; a narrow one, where the panes
+ * are sheets rather than rails, keeps only the corner the altitude control
+ * stands in.
+ */
+export function railInset(width) {
+    if (width < 640)
+        return { left: 8, right: 56 };
+    return {
+        left: Math.round(Math.min(264, width * 0.22)),
+        right: Math.round(Math.min(128, width * 0.107)),
+    };
+}
+//# sourceMappingURL=rails.js.map

package/dist/rails.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rails.js","sourceRoot":"","sources":["../src/rails.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,IAAI,KAAK,GAAG,GAAG;QAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IAC/C,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,CAAC,CAAC;QAC7C,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,GAAG,KAAK,CAAC,CAAC;KAChD,CAAC;AACJ,CAAC"}

package/dist/resolved-view.d.ts

@@ -0,0 +1,78 @@
+import type { AnySchema, Fidelity } from "@graview/core";
+import { type ReactNode } from "react";
+import { type ViewMode } from "./context.js";
+import type { SceneNode } from "./scene-root.js";
+export interface ResolvedViewProps {
+    readonly node: SceneNode;
+    readonly mode: ViewMode;
+    readonly selected: boolean;
+    /** Overrides the fidelity the plane would ask for. Jack-in uses this. */
+    readonly fidelity?: Fidelity;
+}
+/**
+ * THE DISTRICTS THE ROW COULD NOT HOLD, NAMED — BEHIND ONE PRESS.
+ *
+ * A district is read rather than glanced at, so the row never squeezes a
+ * name below a word: past what it can hold at a legible width it keeps the
+ * ones that fit and hands the rest to this. Not a district — it has no
+ * members, no figure and no count of its own — a card that says how many
+ * are missing and takes you to any of them.
+ *
+ * It used to list every name inside its own box, which is a district
+ * card's height: room for the count and nothing else, the names scrolled
+ * away under a fade, and "+6" over one clipped word read as a broken
+ * placeholder rather than the only way to five districts. So the card IS
+ * the control now — "+6 more" is a button — and pressing it opens a panel
+ * above the row that names every district with what it holds, each name
+ * a press to that district. The district you are already in, which lands
+ * here when the row has room for nothing else, is marked as here rather
+ * than offered as somewhere to go.
+ */
+export declare function BeyondCard({ kinds }: {
+    kinds: readonly string[];
+}): import("react").JSX.Element;
+/**
+ * THE PICTURE DOES NOT REDRAW ITSELF BECAUSE THE WORLD MOVED.
+ *
+ * `panLayout` hands every node a new object per frame — it has moved, after
+ * all — and React took that at face value and re-rendered every lens in the
+ * scene on every pointer move of a drag. A profile of one drag across rota's
+ * city put a fifth of the main thread inside the calendar, the coverage
+ * matrix and the timeline redrawing themselves, none of which had anything
+ * new to say: a lens is drawn in its host's own coordinates and does not
+ * know where the host is.
+ *
+ * So a view redraws when its picture changes, not when its position does.
+ */
+export declare const SettledView: typeof ResolvedView;
+/**
+ * Picks the view for a cell of the matrix — cardinality by whether this is an
+ * aggregate, fidelity by plane depth — and renders it.
+ *
+ * A kind with no registered view falls back to the primitive the app
+ * supplied, which is why a new node kind renders sensibly before anyone
+ * writes a view for it.
+ */
+export declare function ResolvedView<S extends AnySchema>({ node, mode, selected, fidelity, }: ResolvedViewProps): import("react").JSX.Element;
+/**
+ * One view, redrawn when its signature changes and not otherwise. The
+ * element is built inside a memo, so a parent re-render with the same
+ * signature hands React the same element and it skips the subtree.
+ */
+export declare const Drawn: import("react").NamedExoticComponent<{
+    readonly signature: string;
+    readonly graph: unknown;
+    readonly draw: () => ReactNode;
+}>;
+/**
+ * A RELATION THE BAND COULD NOT HOLD, drawn as what it is (docs/scale.md):
+ * a group in the graph's own words with a true count and the first names
+ * in it — the most relevant — or the "+N more" door to the kind's picture.
+ * Not the kind's own lens squeezed into a card: a coverage matrix at 180
+ * pixels says nothing and costs thousands of elements. Opened by the host's
+ * own press (a double-click, or Enter), like every card.
+ */
+export declare const BandCard: import("react").NamedExoticComponent<{
+    readonly node: SceneNode;
+}>;
+//# sourceMappingURL=resolved-view.d.ts.map

package/dist/resolved-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolved-view.d.ts","sourceRoot":"","sources":["../src/resolved-view.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAgB,MAAM,eAAe,CAAC;AAGvE,OAAO,EAA8C,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAGnF,OAAO,EAAoD,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AAG/F,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,UAAU,CAAC,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,+BA4IjE;AAyCD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,WAAW,EAKnB,OAAO,YAAY,CAAC;AAEzB;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,SAAS,EAAE,EAChD,IAAI,EACJ,IAAI,EACJ,QAAQ,EACR,QAAQ,GACT,EAAE,iBAAiB,+BAoInB;AAED;;;;GAIG;AACH,eAAO,MAAM,KAAK;wBAC+B,MAAM;oBAAkB,OAAO;mBAAiB,MAAM,SAAS;EAI/G,CAAC;AA0BF;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ;mBAAqD,SAAS;EAgDjF,CAAC"}