@graview/react 0.1.10 → 0.1.14

package/dist/editable-fields.d.ts

@@ -0,0 +1,16 @@
+import type { AnySchema } from "@graview/core";
+import { type EditableField } from "@graview/tools/edit";
+/**
+ * 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=editable-fields.d.ts.map

package/dist/editable-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editable-fields.d.ts","sourceRoot":"","sources":["../src/editable-fields.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAkB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAIzE;;;;;;;;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"}

package/dist/editable-fields.js

@@ -0,0 +1,23 @@
+import { editableFields } from "@graview/tools/edit";
+import { useCallback, useMemo } from "react";
+import { useGraph, useGraview } from "./context.js";
+/**
+ * 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 function useEditableFields(id) {
+    const { store, principal } = useGraview();
+    const nodes = useGraph();
+    const fields = useMemo(() => (id === null ? [] : editableFields(store, id)), [store, id, nodes]);
+    const commit = useCallback((field, value, rest = {}) => {
+        const call = field.call(value);
+        store.apply({ name: call.name, args: { ...call.args, ...rest } }, { author: principal });
+    }, [store, principal]);
+    return { fields, commit };
+}
+//# sourceMappingURL=editable-fields.js.map

package/dist/editable-fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"editable-fields.js","sourceRoot":"","sources":["../src/editable-fields.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAsB,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAEpD;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAC/B,EAAiB;IAKjB,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,UAAU,EAAK,CAAC;IAC7C,MAAM,KAAK,GAAG,QAAQ,EAAK,CAAC;IAC5B,MAAM,MAAM,GAAG,OAAO,CACpB,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EACpD,CAAC,KAAK,EAAE,EAAE,EAAE,KAAK,CAAC,CACnB,CAAC;IACF,MAAM,MAAM,GAAG,WAAW,CACxB,CAAC,KAAoB,EAAE,KAAc,EAAE,OAAgC,EAAE,EAAE,EAAE;QAC3E,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC/B,KAAK,CAAC,KAAK,CACT,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,EAAE,EAAE,EACpD,EAAE,MAAM,EAAE,SAAS,EAAE,CACtB,CAAC;IACJ,CAAC,EACD,CAAC,KAAK,EAAE,SAAS,CAAC,CACnB,CAAC;IACF,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAC5B,CAAC"}

package/dist/emphasis.d.ts

@@ -0,0 +1,25 @@
+/** 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";
+//# sourceMappingURL=emphasis.d.ts.map

package/dist/emphasis.d.ts.map

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

package/dist/emphasis.js

@@ -0,0 +1,84 @@
+import { useMemo } from "react";
+import { useFound, useGraph, useGraview } from "./context.js";
+import { useViolations } from "./hooks.js";
+/*
+ * WHAT A VIEW LIGHTS AND DIMS: the flagged, the reached and the implicated.
+ * A file of its own, apart from the hooks the frame reads before anything is
+ * drawn, so a page that has drawn no view yet carries none of it.
+ */
+/** Ids implicated in some current violation, for marking them in place. */
+export function useFlagged() {
+    const violations = useViolations();
+    return useMemo(() => [...new Set(violations.flatMap((violation) => violation.nodeIds))], [violations]);
+}
+/**
+ * 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 function useImplicated() {
+    const reachedBySelection = useReached();
+    const found = useFound();
+    /*
+     * AND WHAT THE WORDS FIND. A search lights its hits in whatever picture
+     * is open, through the same set every view already dims by — so a lens
+     * learns nothing new to take part. Words that find nothing dim it all:
+     * the one id nothing is called keeps the set non-empty.
+     */
+    return useMemo(() => {
+        if (!found)
+            return reachedBySelection;
+        // Every match, not the strip's capped index: a real hit is never drawn dimmed.
+        const hits = found.matched;
+        if (hits.length === 0 && reachedBySelection.length === 0)
+            return [NOTHING_FOUND];
+        return [...new Set([...reachedBySelection, ...hits])];
+    }, [found, reachedBySelection]);
+}
+/**
+ * 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 function useReached() {
+    const { store, selection } = useGraview();
+    const nodes = useGraph();
+    return useMemo(() => {
+        if (selection.length === 0)
+            return [];
+        const chosen = new Set(selection);
+        const reached = new Set(chosen);
+        for (const edge of store.graph.allEdges()) {
+            if (chosen.has(edge.from))
+                reached.add(edge.to);
+            if (chosen.has(edge.to))
+                reached.add(edge.from);
+        }
+        /*
+         * What a selected thing JUDGES, as well as what it touches.
+         *
+         * A rule has no edges, so selecting one reached nothing and the screen
+         * did not change — it read as broken. What a rule is about is derivable
+         * from its violations, which name the nodes they implicate, so selecting
+         * one now lights those wherever they are drawn.
+         */
+        for (const violation of store.violations()) {
+            if (violation.subjectId !== undefined && chosen.has(violation.subjectId)) {
+                for (const id of violation.nodeIds)
+                    reached.add(id);
+            }
+        }
+        return [...reached];
+    }, [store, selection, nodes]);
+}
+/** Stands in the implicated set when a search found nothing, so every view dims. */
+export const NOTHING_FOUND = "search:nothing";
+//# sourceMappingURL=emphasis.js.map

package/dist/emphasis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emphasis.js","sourceRoot":"","sources":["../src/emphasis.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;GAIG;AAEH,2EAA2E;AAC3E,MAAM,UAAU,UAAU;IACxB,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;IACnC,OAAO,OAAO,CACZ,GAAG,EAAE,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EACxE,CAAC,UAAU,CAAC,CACb,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,kBAAkB,GAAG,UAAU,EAAE,CAAC;IACxC,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;IACzB;;;;;OAKG;IACH,OAAO,OAAO,CAAC,GAAG,EAAE;QAClB,IAAI,CAAC,KAAK;YAAE,OAAO,kBAAkB,CAAC;QACtC,+EAA+E;QAC/E,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC;QAC3B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,kBAAkB,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,aAAa,CAAC,CAAC;QACjF,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,kBAAkB,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACxD,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,CAAC,CAAC,CAAC;AAClC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,UAAU,EAAE,CAAC;IAC1C,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;IACzB,OAAO,OAAO,CAAC,GAAG,EAAE;QAClB,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;QAClC,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;QAChC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC;YAC1C,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;gBAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAChD,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClD,CAAC;QACD;;;;;;;WAOG;QACH,KAAK,MAAM,SAAS,IAAI,KAAK,CAAC,UAAU,EAAE,EAAE,CAAC;YAC3C,IAAI,SAAS,CAAC,SAAS,KAAK,SAAS,IAAI,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC;gBACzE,KAAK,MAAM,EAAE,IAAI,SAAS,CAAC,OAAO;oBAAE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACtD,CAAC;QACH,CAAC;QACD,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC;IACtB,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;AAChC,CAAC;AAED,oFAAoF;AACpF,MAAM,CAAC,MAAM,aAAa,GAAG,gBAAgB,CAAC"}

package/dist/error-report.d.ts

@@ -0,0 +1,15 @@
+/**
+ * WHERE A CAUGHT ERROR IS TOLD, beside the console (FR-24). A host that
+ * embeds an app observes its failures without reading what was on screen:
+ * a boundary tells this the error and the framework module it was caught
+ * in, and the host decides what of the error to keep.
+ *
+ * A file of its own: the frame provides the report before anything draws,
+ * and the boundary that tells it is drawn only with a view.
+ */
+export type ErrorReport = (error: unknown, where: {
+    readonly module: string;
+}) => void;
+/** The report every boundary under it tells. Null outside any: the console alone. */
+export declare const ErrorReportContext: import("react").Context<ErrorReport | null>;
+//# sourceMappingURL=error-report.d.ts.map

package/dist/error-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-report.d.ts","sourceRoot":"","sources":["../src/error-report.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,KAAK,IAAI,CAAC;AAEvF,qFAAqF;AACrF,eAAO,MAAM,kBAAkB,6CAA0C,CAAC"}

package/dist/error-report.js

@@ -0,0 +1,4 @@
+import { createContext } from "react";
+/** The report every boundary under it tells. Null outside any: the console alone. */
+export const ErrorReportContext = createContext(null);
+//# sourceMappingURL=error-report.js.map

package/dist/error-report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-report.js","sourceRoot":"","sources":["../src/error-report.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAatC,qFAAqF;AACrF,MAAM,CAAC,MAAM,kBAAkB,GAAG,aAAa,CAAqB,IAAI,CAAC,CAAC"}

package/dist/hooks.d.ts

@@ -1,6 +1,5 @@
 import type { AnySchema } from "@graview/core";
 import { type ViewState } from "@graview/layout/view";
-import { type EditableField } from "@graview/tools/frame";
 /** The current selection, and the ways an interface changes it. */
 export declare function useSelection(): {
     selection: readonly string[];
@@ -19,30 +18,6 @@ export declare function useSelection(): {
  * 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";
 /** Navigation: every stop is a view, and every view is a URL. */
 export declare function useNavigation(): {
     view: ViewState;
@@ -52,20 +27,6 @@ export declare function useNavigation(): {
     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.
  *
@@ -79,22 +40,13 @@ export declare function useUrlSync(): void;
  * 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;
+/** Where you are in your own history: the pushes `useUrlSync` makes and the pops the browser reports. */
+export declare const trail: {
+    at: number;
+    depth: number;
+    listeners: Set<() => void>;
+    tell(): void;
+};
 /**
  * Whether there is anywhere to go, and the way to go there.
  *
@@ -123,17 +75,4 @@ export declare function useJackIn(): {
     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

@@ -1 +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,EAQL,KAAK,SAAS,EAIf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAkB,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAI1E,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,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"}
+{"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,EAAwE,KAAK,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAI5H,mEAAmE;AACnE,wBAAgB,YAAY;;eAKX,SAAS,MAAM,EAAE;;iBAEf,MAAM;qBAIF,MAAM;EAI5B;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,SAAS,yCAKhD;AA4BD,iEAAiE;AACjE,wBAAgB,aAAa;;;gBAMX,MAAM,GAAG,IAAI;qBACR,MAAM,GAAG,IAAI;0BACR,MAAM;eAEjB,SAAS;EAIzB;AAGD;;;;;;;;;;;;GAYG;AAEH,yGAAyG;AACzG,eAAO,MAAM,KAAK;;;yBAGS,IAAI;;CAI9B,CAAC;AAcF;;;;;;;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"}

package/dist/hooks.js

@@ -1,7 +1,6 @@
-import { aggregateId, fromUrl, toggleExpanded, toUrl, withFocus, withRelation, withZoom, sameView, EMPTY_VIEW, withJackIn, } from "@graview/layout/view";
-import { editableFields } from "@graview/tools/frame";
-import { useCallback, useEffect, useMemo, useRef, useSyncExternalStore } from "react";
-import { useFound, useGraph, useGraview } from "./context.js";
+import { toggleExpanded, toUrl, withFocus, withRelation, withZoom, withJackIn } from "@graview/layout/view";
+import { useCallback, useMemo, useSyncExternalStore } from "react";
+import { useGraph, useGraview } from "./context.js";
 /** The current selection, and the ways an interface changes it. */
 export function useSelection() {
     const { selection, setSelection } = useGraview();
@@ -43,81 +42,6 @@ function violationsOf(store) {
     entry.violations ??= store.violations();
     return entry.violations;
 }
-/** Ids implicated in some current violation, for marking them in place. */
-export function useFlagged() {
-    const violations = useViolations();
-    return useMemo(() => [...new Set(violations.flatMap((violation) => violation.nodeIds))], [violations]);
-}
-/**
- * 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 function useImplicated() {
-    const reachedBySelection = useReached();
-    const found = useFound();
-    /*
-     * AND WHAT THE WORDS FIND. A search lights its hits in whatever picture
-     * is open, through the same set every view already dims by — so a lens
-     * learns nothing new to take part. Words that find nothing dim it all:
-     * the one id nothing is called keeps the set non-empty.
-     */
-    return useMemo(() => {
-        if (!found)
-            return reachedBySelection;
-        // Every match, not the strip's capped index: a real hit is never drawn dimmed.
-        const hits = found.matched;
-        if (hits.length === 0 && reachedBySelection.length === 0)
-            return [NOTHING_FOUND];
-        return [...new Set([...reachedBySelection, ...hits])];
-    }, [found, reachedBySelection]);
-}
-/**
- * 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 function useReached() {
-    const { store, selection } = useGraview();
-    const nodes = useGraph();
-    return useMemo(() => {
-        if (selection.length === 0)
-            return [];
-        const chosen = new Set(selection);
-        const reached = new Set(chosen);
-        for (const edge of store.graph.allEdges()) {
-            if (chosen.has(edge.from))
-                reached.add(edge.to);
-            if (chosen.has(edge.to))
-                reached.add(edge.from);
-        }
-        /*
-         * What a selected thing JUDGES, as well as what it touches.
-         *
-         * A rule has no edges, so selecting one reached nothing and the screen
-         * did not change — it read as broken. What a rule is about is derivable
-         * from its violations, which name the nodes they implicate, so selecting
-         * one now lights those wherever they are drawn.
-         */
-        for (const violation of store.violations()) {
-            if (violation.subjectId !== undefined && chosen.has(violation.subjectId)) {
-                for (const id of violation.nodeIds)
-                    reached.add(id);
-            }
-        }
-        return [...reached];
-    }, [store, selection, nodes]);
-}
-/** Stands in the implicated set when a search found nothing, so every view dims. */
-export const NOTHING_FOUND = "search:nothing";
 /** Navigation: every stop is a view, and every view is a URL. */
 export function useNavigation() {
     const { view, setView } = useGraview();
@@ -130,124 +54,6 @@ export function useNavigation() {
         go: (next) => setView(next),
     }), [view, setView]);
 }
-/**
- * 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 function UrlSync() {
-    useUrlSync();
-    return null;
-}
-export function useUrlSync() {
-    const { view, setView, views } = useGraview();
-    /*
-     * A STOP THAT NAMES A PLACE AND NOT ITS GROUP STILL GOES THERE.
-     *
-     * `#view=grounds-map` is the link a page can actually write: the page knows
-     * the picture it is talking about, not how the layout spells the aggregate
-     * id of the kind behind it. The registry does know — a named place carries
-     * its kind — so the place is looked up here and the group it is a picture
-     * of becomes the focus. Without this the short form lands on the default
-     * view, which is the pasted-link problem one level up.
-     */
-    const settled = useCallback((state) => {
-        const asked = state.within?.["view"];
-        if (asked === undefined || state.focusId)
-            return state;
-        const place = views.places().find((candidate) => candidate.as === asked);
-        return place ? { ...state, focusId: aggregateId(place.kind) } : state;
-    }, [views]);
-    /*
-     * Adopt the fragment on FIRST load, not only on navigation.
-     *
-     * "Every stop is a URL" was only half true: the view was written to the
-     * fragment and the back button honoured it, but opening a shared link
-     * landed on the default view and silently overwrote the address bar. A
-     * pasted link that does not go where it says is worse than no link.
-     */
-    useEffect(() => {
-        if (typeof window === "undefined")
-            return;
-        const initial = settled(fromUrl(window.location.hash));
-        // Adopt ANY address that says something — overview, zoom, a selection —
-        // not only the focus-shaped ones. A pasted link that does not go where
-        // it says is worse than no link.
-        if (!sameView(initial, EMPTY_VIEW)) {
-            setView(initial);
-        }
-        // Once, on mount: later changes are this hook's own writes.
-    }, []);
-    useEffect(() => {
-        if (typeof window === "undefined")
-            return;
-        const onPop = () => setView(settled(fromUrl(window.location.hash)));
-        window.addEventListener("popstate", onPop);
-        window.addEventListener("hashchange", onPop);
-        return () => {
-            window.removeEventListener("popstate", onPop);
-            window.removeEventListener("hashchange", onPop);
-        };
-    }, [setView, settled]);
-    const landed = useRef(false);
-    const written = useRef(null);
-    useEffect(() => {
-        if (typeof window === "undefined")
-            return;
-        const next = toUrl(view);
-        // Only write when the view actually changed, or the back stack fills with
-        // duplicates and the back button stops meaning anything. The baseline
-        // still moves: after a popstate re-syncs the view, a stale baseline made
-        // the next drag read as travel and push a phantom stop.
-        if (window.location.hash === next) {
-            written.current = view;
-            return;
-        }
-        /*
-         * ARRIVING is not a navigation.
-         *
-         * The first write is the app adopting its own default view, and pushing it
-         * put a stop in the history that nobody went to — so the back control was
-         * offered the moment the page loaded, and pressing it went to the blank
-         * URL the app had just left. Replacing is what a page does when it tidies
-         * its own address.
-         */
-        if (!landed.current) {
-            landed.current = true;
-            written.current = view;
-            window.history.replaceState({ graview: trail.at }, "", next);
-            return;
-        }
-        /*
-         * MOVING THE FURNITURE IS NOT TRAVELLING.
-         *
-         * A drag writes the view state on every pointer move, because that is what
-         * makes the connectors follow the card. Pushed, one drag would be sixty
-         * history entries and Back would mean "one pixel ago". A change that
-         * touches only the camera or where things were dragged is an adjustment of
-         * the stop you are on, so it replaces: the address stays shareable and
-         * Back still means the place you were before you started fiddling.
-         */
-        if (adjustment(written.current, view)) {
-            window.history.replaceState({ graview: trail.at }, "", next);
-            written.current = view;
-            return;
-        }
-        written.current = view;
-        window.history.pushState({ graview: ++trail.at }, "", next);
-        // A new stop discards anything that was ahead of it, exactly as the
-        // browser does.
-        trail.depth = trail.at;
-        trail.tell();
-    }, [view]);
-}
 /**
  * Where you are in your own history.
  *
@@ -261,71 +67,8 @@ export function useUrlSync() {
  * 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 function adjustment(before, after) {
-    if (!before)
-        return false;
-    return (before.focusId === after.focusId &&
-        before.relation === after.relation &&
-        (before.overview ?? false) === (after.overview ?? false) &&
-        (before.zoom ?? false) === (after.zoom ?? false) &&
-        (before.past ?? false) === (after.past ?? false) &&
-        before.expanded.join(",") === after.expanded.join(",") &&
-        /*
-         * SHOWING A MODULE IS TRAVELLING. "Show the installation" raises whole
-         * districts into the scene — who is here, who has been invited — and
-         * its own comment always said it was a stop Back knew the way out of.
-         * It was not: `shown` was missing from this comparison, so the address
-         * gained `show=installation` and the entry was REPLACED, the arrows
-         * stayed grey, and one Back from the installation left the app.
-         */
-        (before.shown ?? []).join(",") === (after.shown ?? []).join(",") &&
-        /*
-         * A VIEW MOVING ALONG ITS OWN DIMENSION IS TRAVELLING.
-         *
-         * Turning the calendar to October is going somewhere: a URL to send
-         * somebody, a place to come back to, a Back that means "the month I was
-         * looking at". Left out of this comparison it read as an adjustment of
-         * the stop — the address updated, no entry was pushed, and one Back
-         * from October landed past the calendar entirely, at the place before
-         * anyone opened it. That is the exact failure `within` exists to fix.
-         */
-        sameWithin(before.within, after.within));
-}
-function sameWithin(before, after) {
-    const say = (held) => Object.entries(held ?? {})
-        .sort(([a], [b]) => a.localeCompare(b))
-        .map(([key, value]) => `${key}=${value}`)
-        .join("&");
-    return say(withoutWords(before)) === say(withoutWords(after));
-}
-/*
- * TYPING IS NOT TRAVELLING. The words a row narrows by (`in.q`) change on
- * every keystroke, and each one pushed a history entry — five letters, five
- * Backs to leave a list. The scene's own `q` was never compared; the row's
- * words are the same act and read the same way.
- */
-function withoutWords(held) {
-    if (!held || !("q" in held))
-        return held;
-    const { q: _words, ...rest } = held;
-    return rest;
-}
-const trail = {
+/** Where you are in your own history: the pushes `useUrlSync` makes and the pops the browser reports. */
+export const trail = {
     at: 0,
     depth: 0,
     listeners: new Set(),
@@ -390,23 +133,4 @@ export function useJackIn() {
     const jackedIn = view.zoom ? view.focusId : null;
     return useMemo(() => ({ jackedIn, enter, exit, isJackedIn: view.zoom === true }), [jackedIn, enter, exit, view.zoom]);
 }
-/**
- * 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 function useEditableFields(id) {
-    const { store, principal } = useGraview();
-    const nodes = useGraph();
-    const fields = useMemo(() => (id === null ? [] : editableFields(store, id)), [store, id, nodes]);
-    const commit = useCallback((field, value, rest = {}) => {
-        const call = field.call(value);
-        store.apply({ name: call.name, args: { ...call.args, ...rest } }, { author: principal });
-    }, [store, principal]);
-    return { fields, commit };
-}
 //# sourceMappingURL=hooks.js.map