@graview/react 0.1.0

package/dist/drawn.js

@@ -0,0 +1,58 @@
+import { estimateWidth } from "@graview/layout";
+import { useEffect, useMemo, useRef, useState } from "react";
+export function useDrawnSize(ref, { units, target = 0, legibleAt = 260 }) {
+    const [width, setWidth] = useState(units);
+    useEffect(() => {
+        const element = ref.current;
+        if (element === null || typeof ResizeObserver === "undefined")
+            return;
+        const watch = new ResizeObserver(([entry]) => {
+            const seen = entry?.contentRect.width ?? 0;
+            if (seen > 0)
+                setWidth(seen);
+        });
+        watch.observe(element);
+        return () => watch.disconnect();
+    }, [ref]);
+    const scale = width / units;
+    return { scale, width, touchable: scale * target >= 24, legible: width >= legibleAt };
+}
+/**
+ * A TEXT MEASURER THAT MEASURES, where there is something to measure with.
+ *
+ * `fitLabel` takes a `Measure` because the honest answer depends on where
+ * you are. In a browser it is a 2D canvas context: synchronous, no layout,
+ * the same engine that will draw the SVG. The alternative is
+ * `getComputedTextLength`, which means rendering wrong once and correcting
+ * in an effect every time anything moves.
+ *
+ * The face matters. Pass the CSS variable the text is actually drawn in —
+ * a display serif and a body sans measure very differently, and guessing an
+ * average advance for both is what let three names overflow a plan.
+ */
+export function useTextMeasure(faceVariable = "--graview-font-body", fallback = "sans-serif") {
+    const ruler = useRef(undefined);
+    const face = useMemo(() => {
+        if (typeof getComputedStyle !== "function" || typeof document === "undefined")
+            return fallback;
+        const said = getComputedStyle(document.documentElement).getPropertyValue(faceVariable).trim();
+        return said.length > 0 ? said : fallback;
+    }, [faceVariable, fallback]);
+    return useMemo(() => {
+        if (ruler.current === undefined) {
+            ruler.current =
+                typeof document === "undefined" ? null : (document.createElement("canvas").getContext("2d") ?? null);
+        }
+        const context = ruler.current;
+        if (context === null)
+            return estimateWidth;
+        return (text, fontSize) => {
+            context.font = `${fontSize}px ${face}`;
+            const measured = context.measureText(text).width;
+            /* jsdom's stub answers 0 for everything, and so does a context that
+               has lost its backing store. Either way the estimate is the answer. */
+            return measured > 0 ? measured : estimateWidth(text, fontSize);
+        };
+    }, [face]);
+}
+//# sourceMappingURL=drawn.js.map

package/dist/drawn.js.map

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

package/dist/edge-signs.d.ts

@@ -0,0 +1,13 @@
+import type { AnySchema } from "@graview/core";
+import { type Layout } from "@graview/layout";
+import type { ReactElement } from "react";
+export declare function EdgeSigns({ result, schema, onGo, }: {
+    readonly result: Pick<Layout, "nodes" | "width" | "height" | "city">;
+    readonly schema: AnySchema;
+    /** Pan the ground by this much. */
+    readonly onGo: (by: {
+        readonly x: number;
+        readonly y: number;
+    }) => void;
+}): ReactElement | null;
+//# sourceMappingURL=edge-signs.d.ts.map

package/dist/edge-signs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edge-signs.d.ts","sourceRoot":"","sources":["../src/edge-signs.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAwB,KAAK,MAAM,EAAoB,MAAM,iBAAiB,CAAC;AACtF,OAAO,KAAK,EAAiB,YAAY,EAAE,MAAM,OAAO,CAAC;AAqBzD,wBAAgB,SAAS,CAAC,EACxB,MAAM,EACN,MAAM,EACN,IAAI,GACL,EAAE;IACD,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC,CAAC;IACrE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,mCAAmC;IACnC,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;QAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CACzE,GAAG,YAAY,GAAG,IAAI,CAgDtB"}

package/dist/edge-signs.js

@@ -0,0 +1,76 @@
+import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
+import { districtsPastTheEdge } from "@graview/layout";
+/**
+ * THE SIGNS AT THE EDGE OF THE GROUND. A city wider than the window keeps
+ * its shape and is reached by panning; what it did not do was say so. On a
+ * phone the conference's Topics and Staff stood wholly past the left edge,
+ * and nothing on the screen said they were there or which way to go — a
+ * pointer could not press them, because there was nothing to press.
+ *
+ * Each district past an edge gets a sign on that edge, at the height (or
+ * across the width) it lies, in its own name and pointing at it. Pressing
+ * the sign pans the ground to bring the district in; the district itself
+ * is then pressed like any other. A sign is a way to somewhere, not a
+ * second way to do what the district does.
+ */
+const ARROW = { left: "←", right: "→", top: "↑", bottom: "↓" };
+/** How far apart two signs on one edge stand, at the least: one sign's height and a gap. */
+const SPACING = 36;
+/** Room kept clear at the canvas's ends: the zoom in one corner, the way in at the other. */
+const MARGIN = 56;
+export function EdgeSigns({ result, schema, onGo, }) {
+    const past = districtsPastTheEdge(result);
+    if (past.length === 0)
+        return null;
+    const signs = [];
+    for (const side of ["left", "right", "top", "bottom"]) {
+        const span = side === "left" || side === "right" ? result.height : result.width;
+        let last = -Infinity;
+        const onSide = past.filter((one) => one.side === side).sort((a, b) => a.along - b.along);
+        for (const one of onSide) {
+            const at = Math.max(MARGIN, Math.min(span - MARGIN, Math.max(one.along, last + SPACING)));
+            last = at;
+            const plural = schema.tryDefinition(one.kind)?.plural ?? one.kind;
+            const place = side === "left"
+                ? { left: 6, top: at, transform: "translateY(-50%)" }
+                : side === "right"
+                    ? { right: 6, top: at, transform: "translateY(-50%)" }
+                    : side === "top"
+                        ? { top: 6, left: at, transform: "translateX(-50%)" }
+                        : { bottom: 6, left: at, transform: "translateX(-50%)" };
+            signs.push(_jsx("button", { type: "button", className: "graview-edge-sign", "data-graview-past-edge": one.id, "aria-label": `${plural}, past the ${side} edge — bring it into view`, title: `${plural} is past the ${side} edge`, 
+                /*
+                 * Not a tab stop: the keys reach the district itself, and focus
+                 * brings it into the window. Seven more stops in front of every
+                 * district was the price a keyboard paid for the pointer's sign.
+                 */
+                tabIndex: -1, 
+                // A press on a sign is not the start of a pan.
+                onPointerDown: (event) => event.stopPropagation(), onClick: (event) => {
+                    event.stopPropagation();
+                    onGo(one.by);
+                }, style: { ...SIGN, ...place }, children: side === "right" || side === "bottom" ? `${plural} ${ARROW[side]}` : `${ARROW[side]} ${plural}` }, one.id));
+        }
+    }
+    return _jsx(_Fragment, { children: signs });
+}
+const SIGN = {
+    position: "absolute",
+    zIndex: 3,
+    minHeight: 28,
+    maxWidth: "40%",
+    padding: "3px 10px",
+    font: "inherit",
+    fontSize: "0.75rem",
+    letterSpacing: "0.04em",
+    whiteSpace: "nowrap",
+    overflow: "hidden",
+    textOverflow: "ellipsis",
+    color: "var(--graview-ink)",
+    background: "var(--graview-panel)",
+    border: "1px solid var(--graview-edge)",
+    borderRadius: 999,
+    boxShadow: "0 2px 8px rgb(0 0 0 / 0.12)",
+    cursor: "pointer",
+};
+//# sourceMappingURL=edge-signs.js.map

package/dist/edge-signs.js.map

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

package/dist/hooks.d.ts

@@ -0,0 +1,160 @@
+import type { AnySchema } from "@graview/core";
+import { type ViewState } from "@graview/layout";
+import { type Affordance, type AffordanceSet, type DeriveOptions, type EditableField } from "@graview/tools";
+/** The current selection, and the ways an interface changes it. */
+export declare function useSelection(): {
+    selection: readonly string[];
+    set: (ids: readonly string[]) => void;
+    clear: () => void;
+    toggle: (id: string) => void;
+    isSelected: (id: string) => boolean;
+};
+/**
+ * Everything currently broken, recomputed whenever the graph changes.
+ *
+ * The invariant engine has always known this and the interface only ever
+ * showed it to someone who happened to select an implicated node. An
+ * agreement nobody can see the state of is not an agreement anyone is
+ * keeping — "is anything wrong?" is the first question a person asks of a
+ * week, and it should never require hunting for it.
+ */
+export declare function useViolations<S extends AnySchema>(): import("@graview/core").Violation[];
+/** Ids implicated in some current violation, for marking them in place. */
+export declare function useFlagged(): readonly string[];
+/**
+ * Everything the selection reaches: the selected nodes, plus everything one
+ * edge away from them.
+ *
+ * Selecting a person and having the week sit there unchanged is the same
+ * failure as clicking an event and getting an empty plane — the graph knows
+ * which five events that person is in, and the calendar is right there
+ * drawing all eighteen of them. A view that receives this can say so in its
+ * own idiom: a calendar lights up the spans, a roster rings the chips.
+ *
+ * Empty when nothing is selected, which every view must read as "no
+ * emphasis" rather than "nothing is related".
+ */
+export declare function useImplicated(): readonly string[];
+/**
+ * What the SELECTION alone reaches — `useImplicated` without the search.
+ * For the one reading that must not confuse the two: a district's "tied"
+ * count is about what you picked, not what you typed.
+ */
+export declare function useReached(): readonly string[];
+/** Stands in the implicated set when a search found nothing, so every view dims. */
+export declare const NOTHING_FOUND = "search:nothing";
+/**
+ * What can be done with the current selection, recomputed whenever the
+ * selection or the graph changes.
+ *
+ * Derivation is cheap enough to run on every selection change — measured
+ * under a millisecond on the household example's whole graph — so there is no cache to go
+ * stale and no "refresh actions" button.
+ */
+export declare function useAffordances<S extends AnySchema>(options?: DeriveOptions<S> & {
+    /**
+     * Derive for THESE ids rather than the selection. The companion's rail
+     * is about a subject that may be nothing anybody clicked — the place
+     * you are looking at — and the acts under its name have to be its own.
+     */
+    readonly about?: readonly string[];
+}): AffordanceSet;
+/** Runs an affordance, or shows what it would do first. */
+export declare function useApplyAffordance<S extends AnySchema>(): {
+    preview: (affordance: Affordance, args?: Record<string, unknown>) => import("@graview/core").Preview<S>;
+    apply: (affordance: Affordance, args?: Record<string, unknown>) => import("@graview/core").ApplyResult<S>;
+};
+/** Navigation: every stop is a view, and every view is a URL. */
+export declare function useNavigation(): {
+    view: ViewState;
+    url: string;
+    focus: (id: string | null) => void;
+    show: (relation: string | null) => void;
+    toggle: (aggregateId: string) => void;
+    go: (next: ViewState) => void;
+};
+/**
+ * Keeps the view in the URL fragment and honours the back button.
+ *
+ * The back button returning to the exact prior view is not a nicety here: it
+ * is the thing that makes a spatial interface navigable at all, because it
+ * means no arrangement is ever unreachable once you have left it.
+ */
+/**
+ * `useUrlSync` as a component, for shells that make syncing conditional —
+ * a hook inside `if (syncUrl)` is a Rules-of-Hooks trap the moment the
+ * flag ever changes; a conditionally RENDERED component is not.
+ */
+export declare function UrlSync(): null;
+export declare function useUrlSync(): void;
+/**
+ * Where you are in your own history.
+ *
+ * The History API says nothing about whether there is anywhere to go forward
+ * to, and an interface cannot offer a control it does not know the state of —
+ * a forward arrow that is always enabled and usually does nothing is worse
+ * than none. So the position is tracked here, from the pushes this hook makes
+ * and the pops the browser reports.
+ *
+ * Module-level because there is one history per document, and because a hook
+ * that re-created it per component would count each navigation once per
+ * mounted consumer.
+ */
+/**
+ * Whether one view differs from another only in what the user MOVED.
+ *
+ * Where you are is the focus, the relation, what is expanded and whether you
+ * have risen above the stack. Where you dragged things to is not a different
+ * place; it is the same place, rearranged.
+ */
+/**
+ * WHETHER A CHANGE IS A STOP OR JUST A NUDGE OF THE ONE YOU ARE ON.
+ *
+ * Exported so it can be read and held to: what belongs in here is the
+ * difference between the back button meaning something and meaning "one
+ * pixel ago", and the two things that went wrong went wrong silently — the
+ * address changed, no entry was pushed, and the arrows stayed grey.
+ */
+export declare function adjustment(before: ViewState | null, after: ViewState): boolean;
+/**
+ * Whether there is anywhere to go, and the way to go there.
+ *
+ * Every stop in a Graview app is a URL — that was the point of view state
+ * being serialisable — so back and forward are the BROWSER's, and this only
+ * makes them visible. An interface whose navigation is the browser's should
+ * not require the person using it to know that.
+ */
+export declare function useBacktrack(): {
+    readonly canGoBack: boolean;
+    readonly canGoForward: boolean;
+    back: () => void;
+    forward: () => void;
+};
+/**
+ * "Jack in": lift one view out of the scene into a conventional full page.
+ *
+ * A FAMILIARITY affordance, not an interactivity escape hatch. Because
+ * pointer routing keeps the in-scene view fully interactive, jacking in is a
+ * comfort for a novel interface rather than a requirement to get work done —
+ * and every view has to render correctly both ways.
+ */
+export declare function useJackIn(): {
+    jackedIn: string | null;
+    enter: (id: string) => void;
+    exit: () => void;
+    isJackedIn: boolean;
+};
+/**
+ * The fields of a node that can be changed where they are shown, and the way
+ * to change one.
+ *
+ * `commit` runs the mutation the framework found, with the author set to a
+ * person — so an in-place edit lands in the op log, can be undone, and is
+ * judged by the invariants exactly like an edit made from the actions strip.
+ * There is no second write path.
+ */
+export declare function useEditableFields<S extends AnySchema>(id: string | null): {
+    readonly fields: readonly EditableField[];
+    commit: (field: EditableField, value: unknown, rest?: Record<string, unknown>) => void;
+};
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAUL,KAAK,SAAS,EAIf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAKL,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,aAAa,EACnB,MAAM,gBAAgB,CAAC;AAIxB,mEAAmE;AACnE,wBAAgB,YAAY;;eAKX,SAAS,MAAM,EAAE;;iBAEf,MAAM;qBAIF,MAAM;EAI5B;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,SAAS,yCAKhD;AA4BD,2EAA2E;AAC3E,wBAAgB,UAAU,IAAI,SAAS,MAAM,EAAE,CAM9C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,IAAI,SAAS,MAAM,EAAE,CAgBjD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,SAAS,MAAM,EAAE,CA0B9C;AAED,oFAAoF;AACpF,eAAO,MAAM,aAAa,mBAAmB,CAAC;AAE9C;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,SAAS,EAChD,OAAO,GAAE,aAAa,CAAC,CAAC,CAAC,GAAG;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/B,GACL,aAAa,CAwBf;AAED,2DAA2D;AAC3D,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,SAAS;0BAI1B,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;wBAE5C,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;EASnE;AAED,iEAAiE;AACjE,wBAAgB,aAAa;;;gBAMX,MAAM,GAAG,IAAI;qBACR,MAAM,GAAG,IAAI;0BACR,MAAM;eAEjB,SAAS;EAIzB;AAED;;;;;;GAMG;AACH;;;;GAIG;AACH,wBAAgB,OAAO,IAAI,IAAI,CAG9B;AAED,wBAAgB,UAAU,IAAI,IAAI,CAwGjC;AAED;;;;;;;;;;;;GAYG;AACH;;;;;;GAMG;AACH;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CA8B9E;AA+CD;;;;;;;GAOG;AACH,wBAAgB,YAAY,IAAI;IAC9B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAwBA;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS;;gBASQ,MAAM;;;EAOtC;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,SAAS,EACnD,EAAE,EAAE,MAAM,GAAG,IAAI,GAChB;IACD,QAAQ,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;IAC1C,MAAM,EAAE,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CACxF,CAkBA"}