@graview/react 0.1.28 → 0.1.30

package/dist/menu-sections.js

@@ -0,0 +1,35 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, useMemo } from "react";
+import { useGraviewIfAny } from "./context.js";
+const MenuSectionsContext = createContext([]);
+/**
+ * A FACE'S OWN SECTIONS (the routed face's "Open", "Change …"), added to
+ * every context menu drawn inside it, after those of any around it. A
+ * host's are the provider's `menuSections`, and are drawn after these.
+ */
+export function MenuSections({ sections, children }) {
+    const outer = useContext(MenuSectionsContext);
+    const all = useMemo(() => [...outer, ...sections.filter((source) => !outer.includes(source))], [outer, sections]);
+    return _jsx(MenuSectionsContext.Provider, { value: all, children: children });
+}
+/** The sections every source here gives for a target, the ones before the acts first. */
+export function useMenuSections(target) {
+    const faces = useContext(MenuSectionsContext);
+    const host = useGraviewIfAny()?.menuSections;
+    // The same source given twice — a face's and a host's — is drawn once.
+    const sources = host ? [...faces, ...host.filter((source) => !faces.includes(source))] : faces;
+    if (target === null || sources.length === 0)
+        return { start: [], end: [] };
+    const sections = sources.flatMap((source) => {
+        try {
+            const section = source(target);
+            return section && ((section.items?.length ?? 0) > 0 || section.render) ? [section] : [];
+        }
+        catch {
+            // A host's section that throws is left out, never the menu.
+            return [];
+        }
+    });
+    return { start: sections.filter((section) => section.at === "start"), end: sections.filter((section) => section.at !== "start") };
+}
+//# sourceMappingURL=menu-sections.js.map

package/dist/menu-sections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu-sections.js","sourceRoot":"","sources":["../src/menu-sections.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAkB,MAAM,OAAO,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAyD/C,MAAM,mBAAmB,GAAG,aAAa,CAA+B,EAAE,CAAC,CAAC;AAE5E;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAqF;IACpI,MAAM,KAAK,GAAG,UAAU,CAAC,mBAAmB,CAAC,CAAC;IAC9C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,KAAK,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;IAClH,OAAO,KAAC,mBAAmB,CAAC,QAAQ,IAAC,KAAK,EAAE,GAAG,YAAG,QAAQ,GAAgC,CAAC;AAC7F,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,eAAe,CAAC,MAAyB;IACvD,MAAM,KAAK,GAAG,UAAU,CAAC,mBAAmB,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,eAAe,EAAE,EAAE,YAAY,CAAC;IAC7C,uEAAuE;IACvE,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAC/F,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC;IAC3E,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;QAC1C,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;YAC/B,OAAO,OAAO,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1F,CAAC;QAAC,MAAM,CAAC;YACP,4DAA4D;YAC5D,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,OAAO,CAAC,EAAE,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,OAAO,CAAC,EAAE,CAAC;AACpI,CAAC"}

package/dist/past.d.ts

@@ -0,0 +1,58 @@
+import type { AnySchema, Principal, Store } from "@graview/core";
+import type { HistoryHost } from "@graview/core/history";
+/**
+ * THE APP AS IT WAS, SHOWN (Roadmap f-playback): which moment a face is
+ * drawing instead of now, and the store of it (`pastOf`) every surface
+ * under it reads — the scene, the pages, the problems, the lenses — so the
+ * past is drawn by the one renderer the present is.
+ */
+export interface PastShown<S extends AnySchema = AnySchema> {
+    /** The ops before this seq are in it, none after. */
+    readonly seq: number;
+    /** When the last op in it was made. */
+    readonly at: string | undefined;
+    /** The whole store as it stood: read, never changed, offering no act. */
+    readonly store: Store<S>;
+}
+/**
+ * PLAYBACK, AS A FACE HOLDS IT: the moment shown (or `null`, now), the way
+ * to show another, and the live store — what the timeline reads its ticks
+ * from and a "Restore to here" changes. Held by the outermost provider of
+ * a face (`GraviewProvider`, or the routed face's `PagesApp`), so a face
+ * drawn inside another shares the one moment.
+ */
+export interface Playback<S extends AnySchema = AnySchema> {
+    /** The moment drawn instead of now; `null` while now is drawn. */
+    readonly past: PastShown<S> | null;
+    /** Whether the timeline is open: at a moment, or at now with the way back still in reach. */
+    readonly open: boolean;
+    /**
+     * Show the app as it stood at `seq` — the timeline opens on it; a seq at
+     * or past the log's end is now, with the timeline still open. `null`
+     * closes the timeline and comes back to now.
+     */
+    show(seq: number | null): void;
+    /** The store as it is now, whole: read through the seat's sight (`seenBy`). */
+    readonly live: Store<S>;
+    /** What the host keeps outside the log: declaration changes, a script view's code at a moment. */
+    readonly host: HistoryHost | undefined;
+    /** Whether `store` is this playback's — now's or the moment's, whole or as one seat sees it. */
+    owns(store: Store<AnySchema>, principal: Principal): boolean;
+}
+export declare const PlaybackContext: import("react").Context<Playback<AnySchema> | null>;
+/** The playback the face under this is drawn with, if any. */
+export declare function usePlayback<S extends AnySchema = AnySchema>(): Playback<S> | null;
+/**
+ * THE STORE AS IT IS NOW, as this seat sees it, whatever moment the face
+ * draws — what Activity lists and a timeline counts its ticks from — drawn
+ * again as it changes. The provider's own store where there is no playback.
+ */
+export declare function useLiveStore<S extends AnySchema>(shown: Store<S>, principal: Principal): Store<S>;
+/**
+ * A FACE'S OWN PLAYBACK over `live`, or the one it is drawn inside when
+ * that one holds this store. Nothing past is folded — or fetched — until
+ * somebody asks to see it; a moment the log no longer reaches (cut back
+ * under it) is now.
+ */
+export declare function useOwnPlayback<S extends AnySchema>(live: Store<S>, principal: Principal, host: HistoryHost | undefined): Playback<S>;
+//# sourceMappingURL=past.d.ts.map

package/dist/past.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"past.d.ts","sourceRoot":"","sources":["../src/past.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAIzD;;;;;GAKG;AACH,MAAM,WAAW,SAAS,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS;IACxD,qDAAqD;IACrD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,yEAAyE;IACzE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS;IACvD,kEAAkE;IAClE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IACnC,6FAA6F;IAC7F,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB;;;;OAIG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IAC/B,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IACxB,kGAAkG;IAClG,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,SAAS,CAAC;IACvC,gGAAgG;IAChG,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC;CAC9D;AAED,eAAO,MAAM,eAAe,qDAAuC,CAAC;AAEpE,8DAA8D;AAC9D,wBAAgB,WAAW,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAEjF;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAcjG;AAQD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,SAAS,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,CAqCpI"}

package/dist/past.js

@@ -0,0 +1,70 @@
+import { retryingImport } from "@graview/core/retry";
+import { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState, useSyncExternalStore } from "react";
+export const PlaybackContext = createContext(null);
+/** The playback the face under this is drawn with, if any. */
+export function usePlayback() {
+    return useContext(PlaybackContext);
+}
+/**
+ * THE STORE AS IT IS NOW, as this seat sees it, whatever moment the face
+ * draws — what Activity lists and a timeline counts its ticks from — drawn
+ * again as it changes. The provider's own store where there is no playback.
+ */
+export function useLiveStore(shown, principal) {
+    const playback = usePlayback();
+    const live = useMemo(() => (playback ? playback.live.seenBy(principal) : shown), [playback, shown, principal]);
+    const version = useRef(0);
+    const subscribe = useCallback((listener) => live.subscribe(() => {
+        version.current += 1;
+        listener();
+    }), [live]);
+    useSyncExternalStore(subscribe, () => version.current, () => 0);
+    return live;
+}
+/** `@graview/core/past`, fetched when somebody first asks to see the past: the fold is none of a page's weight until then. */
+const history = /* @__PURE__ */ retryingImport(() => import("@graview/core/past"));
+/** The module once it is here, so a face drawn after it arrived shows the past at once. */
+let arrived;
+/**
+ * A FACE'S OWN PLAYBACK over `live`, or the one it is drawn inside when
+ * that one holds this store. Nothing past is folded — or fetched — until
+ * somebody asks to see it; a moment the log no longer reaches (cut back
+ * under it) is now.
+ */
+export function useOwnPlayback(live, principal, host) {
+    const outer = useContext(PlaybackContext);
+    const inherited = outer !== null && outer.owns(live, principal);
+    const [seq, setSeq] = useState(null);
+    const [folds, setFolds] = useState(arrived);
+    // The past is fetched the first time it is asked for; until it is here, now is drawn.
+    useEffect(() => {
+        if (folds || inherited || seq === null)
+            return;
+        let live = true;
+        void history().then((module) => {
+            arrived = module;
+            if (live)
+                setFolds(module);
+        }, () => { });
+        return () => {
+            live = false;
+        };
+    }, [folds, inherited, seq]);
+    const past = useMemo(() => {
+        if (inherited || seq === null || seq >= live.log.length || !folds)
+            return null;
+        try {
+            const store = folds.pastAt(live, seq, host);
+            return { seq, at: store.past?.at, store };
+        }
+        catch {
+            return null;
+        }
+    }, [inherited, live, seq, host, folds]);
+    const show = useCallback((next) => setSeq(next === null ? null : next >= live.log.length ? Number.POSITIVE_INFINITY : next), [live]);
+    const owns = useCallback((store, seat) => [live, past?.store].some((one) => one !== undefined && (one === store || one.seenBy(seat) === store)), [live, past]);
+    const open = seq !== null;
+    const own = useMemo(() => ({ past, open, show, live, host, owns }), [past, open, show, live, host, owns]);
+    return inherited ? outer : own;
+}
+//# sourceMappingURL=past.js.map

package/dist/past.js.map

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

package/dist/plots.d.ts

@@ -1,7 +1,8 @@
 import { type Brand } from "@graview/core";
 import { type Building } from "@graview/core/scene";
-import { type InterpolatedLayout } from "@graview/layout";
+import type { InterpolatedLayout } from "@graview/layout";
 import { type ReactElement } from "react";
+import "./provider.js";
 export interface Point {
     readonly x: number;
     readonly y: number;
@@ -10,6 +11,8 @@ export interface City {
     readonly cell: number;
     readonly originX: number;
     readonly originY: number;
+    /** A cell's height over its width: 0.5 at an angle, 1 from straight above. */
+    readonly tilt?: number;
 }
 export interface PlotLike {
     readonly col: number;
@@ -27,10 +30,16 @@ export interface PlotsProps {
     readonly brand?: Brand | undefined;
     /** Which district ids are hand-placed: their curb is dashed, as the pinned mark. */
     readonly pinned?: ReadonlySet<string>;
+    /** The camera has come down past the whole map: the blocks say their names. */
+    readonly close?: boolean;
+    /** The day overdue is judged against (ISO date). */
+    readonly today?: string;
     /** The scene's own flag for a click that a drag is about to produce: a pan that ends on a tile is not a press. */
     readonly swallowed?: {
         readonly current: boolean;
     };
+    /** The records chosen from altitude (`mapChoice`): each stands as a building of its own, ahead of the rest of its row. */
+    readonly chosen?: readonly string[];
     onFocus?(id: string): void;
 }
 /**
@@ -44,10 +53,27 @@ export interface PlotsProps {
  * group, so a pan or a tween changes one attribute. Each plot is its own
  * memoized tile whose village is kept for as long as that plot and its
  * members are the same, so dragging one district redraws that district and
- * the roads, not every building in the city on every frame.
+ * its tile, not every building in the city on every frame.
  */
-export declare function Plots({ frame, width, height, pan, brand, pinned, swallowed, onFocus }: PlotsProps): ReactElement | null;
-export { heightOf, villageCap, villageOf } from "@graview/core/scene";
+export declare function Plots({ frame, width, height, pan, pinned, close, today, swallowed, chosen, onFocus }: PlotsProps): ReactElement | null;
+/**
+ * WHICH BLOCKS SAY THEIR NAMES, so that no two names on a plot lie over each
+ * other. A district's blocks stand a step apart on the diagonal, and every
+ * name was written over its own block whatever stood beside it: coming down
+ * on the locations, "The workshop", "The kitchen" and "The yard" were one
+ * smudge across the block somebody had chosen. The district nameplates' own
+ * rule, a name only where it has room: the chosen block says its name first
+ * and whole, then each block wide enough to be named, back to front, as long
+ * as its name has room beside the names already written. The rest say
+ * theirs once the camera comes down far enough to part them.
+ */
+export declare function namesWithRoom(buildings: readonly {
+    readonly id: string;
+    readonly name: string;
+    readonly width: number;
+    readonly top: Point;
+}[], chosen: ReadonlySet<string>): ReadonlyMap<string, string>;
+export { districtBlocks, heightOf, villageCap, villageOf } from "@graview/core/scene";
 export type { Building } from "@graview/core/scene";
 /** The three faces of one building on the canvas, from its foot cell. */
 export declare function buildingFaces(building: Building, city: City, pan: Point): {
@@ -61,24 +87,4 @@ export declare function toLattice(point: Point, city: City, pan: Point): {
     readonly col: number;
     readonly row: number;
 };
-/**
- * THE STREETS. Plots stand at multiples of BLOCK and never fill their
- * block, so between every block there is a gutter — a row and a column
- * of cells nothing stands on. A road runs along them: out of its plot to
- * the gutter beside its block, along that gutter, up the gutter beside
- * the other block, and in. Every leg is a lattice line (one coordinate
- * held), no leg crosses a third plot, and the whole city reads as
- * villages on a street grid rather than lines drawn over it.
- */
-export declare function streetPoints(from: PlotLike, to: PlotLike): {
-    readonly col: number;
-    readonly row: number;
-}[];
-/**
- * A ROAD FROM CURB TO CURB: the street between two plots, with the run
- * inside either plot cut away, so the road starts at one curb and ends at
- * the other rather than diving under the buildings. Sampled and bisected,
- * the same way a connector is clipped against a box.
- */
-export declare function roadBetween(from: PlotLike, to: PlotLike, city: City, pan: Point): Point[];
 //# sourceMappingURL=plots.d.ts.map

package/dist/plots.d.ts.map

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