forgebook 0.0.0-stage → 0.1.0

package/dist/src/shell/useRecentPages.js

@@ -0,0 +1,62 @@
+/**
+ * The pages opened last, for the home: kept in this browser, the newest first, a page once.
+ *
+ * @remarks
+ * Only this browser's convenience: never in the address nor shared. A page the tree no longer has (a story renamed)
+ * stays stored but the home leaves it out.
+ *
+ * @module
+ */
+import { useEffect } from "react";
+import { useStored } from "./useStored.js";
+/** The storage key. */
+const RECENT_KEY = "recent-pages";
+/** The most pages kept. */
+const MOST_RECENT = 8;
+/** Whether a stored value is a recent page. */
+const isRecentPage = (value) => typeof value === "object" &&
+    value !== null &&
+    "kind" in value &&
+    (value.kind === "story" || value.kind === "component") &&
+    "id" in value &&
+    typeof value.id === "string";
+/** The stored pages, or none when the text holds none (another format, a damaged value). */
+const storedPages = (stored) => {
+    if (stored === null)
+        return [];
+    try {
+        const value = JSON.parse(stored);
+        return Array.isArray(value) ? value.filter(isRecentPage) : [];
+    }
+    catch {
+        return [];
+    }
+};
+/**
+ * The list with a page opened now: first, once, the oldest dropped past the limit.
+ *
+ * @param pages - the list.
+ * @param page - the page opened.
+ */
+export const withRecentPage = (pages, page) => [page, ...pages.filter((known) => known.kind !== page.kind || known.id !== page.id)].slice(0, MOST_RECENT);
+/**
+ * The pages opened last, recording the shown one.
+ *
+ * @param shown - the page shown now; none on the home or a missing page.
+ */
+export const useRecentPages = (shown) => {
+    const [pages, setPages] = useStored(RECENT_KEY, storedPages, JSON.stringify);
+    const kind = shown?.kind;
+    const id = shown?.id;
+    useEffect(() => {
+        if (kind === undefined || id === undefined)
+            return;
+        // already the newest: nothing to store, and no new list to render again with
+        const [newest] = pages;
+        if (newest?.kind === kind && newest.id === id)
+            return;
+        setPages(withRecentPage(pages, { kind, id }));
+    }, [kind, id, pages, setPages]);
+    return pages;
+};
+//# sourceMappingURL=useRecentPages.js.map

package/dist/src/shell/useRecentPages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRecentPages.js","sourceRoot":"","sources":["../../../src/shell/useRecentPages.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAU3C,uBAAuB;AACvB,MAAM,UAAU,GAAG,cAAc,CAAC;AAElC,2BAA2B;AAC3B,MAAM,WAAW,GAAG,CAAC,CAAC;AAEtB,+CAA+C;AAC/C,MAAM,YAAY,GAAG,CAAC,KAAc,EAAuB,EAAE,CAC3D,OAAO,KAAK,KAAK,QAAQ;IACzB,KAAK,KAAK,IAAI;IACd,MAAM,IAAI,KAAK;IACf,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,CAAC;IACtD,IAAI,IAAI,KAAK;IACb,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,CAAC;AAE/B,4FAA4F;AAC5F,MAAM,WAAW,GAAG,CAAC,MAAqB,EAAyB,EAAE;IACnE,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IAC/B,IAAI,CAAC;QACH,MAAM,KAAK,GAAY,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC1C,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAChE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAA4B,EAAE,IAAgB,EAAyB,EAAE,CACtG,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;AAE7G;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAA6B,EAAyB,EAAE;IACrF,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,SAAS,CAAC,UAAU,EAAE,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAC7E,MAAM,IAAI,GAAG,KAAK,EAAE,IAAI,CAAC;IACzB,MAAM,EAAE,GAAG,KAAK,EAAE,EAAE,CAAC;IACrB,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,IAAI,KAAK,SAAS,IAAI,EAAE,KAAK,SAAS;YAAE,OAAO;QACnD,6EAA6E;QAC7E,MAAM,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC;QACvB,IAAI,MAAM,EAAE,IAAI,KAAK,IAAI,IAAI,MAAM,CAAC,EAAE,KAAK,EAAE;YAAE,OAAO;QACtD,QAAQ,CAAC,cAAc,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IAChD,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;IAChC,OAAO,KAAK,CAAC;AACf,CAAC,CAAC"}

package/dist/src/shell/useScrollMemory.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Where a page's scrolling part stands when another page comes in: a page opened anew starts at its top, a page the
+ * history brings back (back, forward) takes the position it was left at, as a browser does for its own pages.
+ *
+ * @remarks
+ * The component page and the stage each keep one scrolling element from one page to the next (React reuses the node:
+ * same component, same place), so without this its offset survives into a page it means nothing for. The shell
+ * keeps the positions, by page, across both kinds of page. A position given back is set again whenever the content's
+ * size changes while the page loads (its documentation, its frames), until the person scrolls themselves: what
+ * arrives may leave it out of reach or move it; meanwhile the scrolling the browser does on its own (clamping,
+ * anchoring) is not taken for the page's position.
+ *
+ * @module
+ */
+import { type RefObject } from "react";
+/**
+ * A visit of a page: made anew whenever a page is opened or the history moves, never when only the view changes
+ * (its args, its theme), so the person stays where they are then; the same page opened again is a new visit.
+ */
+export type PageVisit = {
+    /** The page shown, whatever the view. */
+    readonly pageKey: string;
+    /** Whether the history brought the page back (back or forward), rather than a link or a picker opening it. */
+    readonly isReturn: boolean;
+};
+/** What a page needs to know of its scroll position: its visit, and every page's last position. */
+export type PageScroll = {
+    /** The visit shown. */
+    readonly visit: PageVisit;
+    /** Each page's last position, by key: kept by the shell, so it outlives the page that wrote it. */
+    readonly positions: Map<string, number>;
+};
+/**
+ * Puts a page's scrolling element where the page should start, and keeps its position for when it comes back.
+ *
+ * @param ref - the scrolling element.
+ * @param scroll - the visit and the shell's positions.
+ */
+export declare const useScrollMemory: (ref: RefObject<HTMLElement | null>, { visit, positions }: PageScroll) => void;
+//# sourceMappingURL=useScrollMemory.d.ts.map

package/dist/src/shell/useScrollMemory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useScrollMemory.d.ts","sourceRoot":"","sources":["../../../src/shell/useScrollMemory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,KAAK,SAAS,EAAsC,MAAM,OAAO,CAAC;AAE3E;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,yCAAyC;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,8GAA8G;IAC9G,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,mGAAmG;AACnG,MAAM,MAAM,UAAU,GAAG;IACvB,uBAAuB;IACvB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,mGAAmG;IACnG,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC,CAAC;AAKF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAC1B,KAAK,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,EAClC,sBAAsB,UAAU,KAC/B,IAuCF,CAAC"}

package/dist/src/shell/useScrollMemory.js

@@ -0,0 +1,69 @@
+/**
+ * Where a page's scrolling part stands when another page comes in: a page opened anew starts at its top, a page the
+ * history brings back (back, forward) takes the position it was left at, as a browser does for its own pages.
+ *
+ * @remarks
+ * The component page and the stage each keep one scrolling element from one page to the next (React reuses the node:
+ * same component, same place), so without this its offset survives into a page it means nothing for. The shell
+ * keeps the positions, by page, across both kinds of page. A position given back is set again whenever the content's
+ * size changes while the page loads (its documentation, its frames), until the person scrolls themselves: what
+ * arrives may leave it out of reach or move it; meanwhile the scrolling the browser does on its own (clamping,
+ * anchoring) is not taken for the page's position.
+ *
+ * @module
+ */
+import { useEffect, useLayoutEffect, useRef } from "react";
+/** The input that means the person scrolls themselves: a position given back stops being chased. */
+const OWN_SCROLL_EVENTS = ["wheel", "touchstart", "keydown", "pointerdown"];
+/**
+ * Puts a page's scrolling element where the page should start, and keeps its position for when it comes back.
+ *
+ * @param ref - the scrolling element.
+ * @param scroll - the visit and the shell's positions.
+ */
+export const useScrollMemory = (ref, { visit, positions }) => {
+    // read by the scroll listener, which lives as long as the element: the page shown now, and whether its position
+    // is still being reached (until then the offset is the browser's clamping, not the page's position)
+    const shownKey = useRef(visit.pageKey);
+    const isReaching = useRef(false);
+    useLayoutEffect(() => {
+        const element = ref.current;
+        shownKey.current = visit.pageKey;
+        isReaching.current = false;
+        if (element === null)
+            return;
+        const top = visit.isReturn ? (positions.get(visit.pageKey) ?? 0) : 0;
+        element.scrollTop = top;
+        if (top === 0)
+            return;
+        // the page still loads: what arrives may leave the position out of reach or, above it, move it (the browser's
+        // scroll anchoring), so it is put back whenever the content's size changes, until the person scrolls
+        isReaching.current = true;
+        const stop = () => {
+            isReaching.current = false;
+            resizes.disconnect();
+            for (const name of OWN_SCROLL_EVENTS)
+                element.removeEventListener(name, stop);
+        };
+        const resizes = new ResizeObserver(() => {
+            element.scrollTop = top;
+        });
+        for (const child of element.children)
+            resizes.observe(child);
+        for (const name of OWN_SCROLL_EVENTS)
+            element.addEventListener(name, stop, { passive: true });
+        return stop;
+    }, [ref, visit, positions]);
+    useEffect(() => {
+        const element = ref.current;
+        if (element === null)
+            return;
+        const onScroll = () => {
+            if (!isReaching.current)
+                positions.set(shownKey.current, element.scrollTop);
+        };
+        element.addEventListener("scroll", onScroll, { passive: true });
+        return () => element.removeEventListener("scroll", onScroll);
+    }, [ref, positions]);
+};
+//# sourceMappingURL=useScrollMemory.js.map

package/dist/src/shell/useScrollMemory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useScrollMemory.js","sourceRoot":"","sources":["../../../src/shell/useScrollMemory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAkB,SAAS,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAqB3E,oGAAoG;AACpG,MAAM,iBAAiB,GAAG,CAAC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,aAAa,CAAU,CAAC;AAErF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,GAAkC,EAClC,EAAE,KAAK,EAAE,SAAS,EAAc,EAC1B,EAAE;IACR,gHAAgH;IAChH,oGAAoG;IACpG,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACvC,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAEjC,eAAe,CAAC,GAAG,EAAE;QACnB,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;QAC5B,QAAQ,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QACjC,UAAU,CAAC,OAAO,GAAG,KAAK,CAAC;QAC3B,IAAI,OAAO,KAAK,IAAI;YAAE,OAAO;QAC7B,MAAM,GAAG,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACrE,OAAO,CAAC,SAAS,GAAG,GAAG,CAAC;QACxB,IAAI,GAAG,KAAK,CAAC;YAAE,OAAO;QACtB,8GAA8G;QAC9G,qGAAqG;QACrG,UAAU,CAAC,OAAO,GAAG,IAAI,CAAC;QAC1B,MAAM,IAAI,GAAG,GAAS,EAAE;YACtB,UAAU,CAAC,OAAO,GAAG,KAAK,CAAC;YAC3B,OAAO,CAAC,UAAU,EAAE,CAAC;YACrB,KAAK,MAAM,IAAI,IAAI,iBAAiB;gBAAE,OAAO,CAAC,mBAAmB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAChF,CAAC,CAAC;QACF,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC,GAAS,EAAE;YAC5C,OAAO,CAAC,SAAS,GAAG,GAAG,CAAC;QAC1B,CAAC,CAAC,CAAC;QACH,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,QAAQ;YAAE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC7D,KAAK,MAAM,IAAI,IAAI,iBAAiB;YAAE,OAAO,CAAC,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9F,OAAO,IAAI,CAAC;IACd,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC;IAE5B,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;QAC5B,IAAI,OAAO,KAAK,IAAI;YAAE,OAAO;QAC7B,MAAM,QAAQ,GAAG,GAAS,EAAE;YAC1B,IAAI,CAAC,UAAU,CAAC,OAAO;gBAAE,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QAC9E,CAAC,CAAC;QACF,OAAO,CAAC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAChE,OAAO,GAAS,EAAE,CAAC,OAAO,CAAC,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACrE,CAAC,EAAE,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC;AACvB,CAAC,CAAC"}

package/dist/src/shell/useSidebarLayout.d.ts

@@ -0,0 +1,14 @@
+/** The sidebar's layout and its setters. */
+export type SidebarLayout = {
+    /** Its width, in CSS px. */
+    readonly width: number;
+    /** Sets its width. */
+    readonly setWidth: (width: number) => void;
+    /** Whether it is shown. */
+    readonly isOpen: boolean;
+    /** Shows or hides it. */
+    readonly setIsOpen: (isOpen: boolean) => void;
+};
+/** The sidebar's layout. */
+export declare const useSidebarLayout: () => SidebarLayout;
+//# sourceMappingURL=useSidebarLayout.d.ts.map

package/dist/src/shell/useSidebarLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSidebarLayout.d.ts","sourceRoot":"","sources":["../../../src/shell/useSidebarLayout.ts"],"names":[],"mappings":"AAQA,4CAA4C;AAC5C,MAAM,MAAM,aAAa,GAAG;IAC1B,4BAA4B;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,sBAAsB;IACtB,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,2BAA2B;IAC3B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,yBAAyB;IACzB,QAAQ,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;CAC/C,CAAC;AAQF,4BAA4B;AAC5B,eAAO,MAAM,gBAAgB,QAAO,aAQnC,CAAC"}

package/dist/src/shell/useSidebarLayout.js

@@ -0,0 +1,19 @@
+/**
+ * The sidebar's width and whether it is shown: this browser's convenience, kept for the next visit, not the address's.
+ *
+ * @module
+ */
+import { boundedSidebarWidth, SIDEBAR_WIDTH } from "./SidebarHandle.js";
+import { useStored } from "./useStored.js";
+/** The width a stored text holds, or the default. */
+const storedWidth = (stored) => {
+    const width = Number(stored);
+    return stored === null || !Number.isFinite(width) ? SIDEBAR_WIDTH.initial : boundedSidebarWidth(width);
+};
+/** The sidebar's layout. */
+export const useSidebarLayout = () => {
+    const [width, setWidth] = useStored("sidebar-width", storedWidth, String);
+    const [isOpen, setIsOpen] = useStored("sidebar", (stored) => stored !== "hidden", (shown) => (shown ? "shown" : "hidden"));
+    return { width, setWidth, isOpen, setIsOpen };
+};
+//# sourceMappingURL=useSidebarLayout.js.map

package/dist/src/shell/useSidebarLayout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSidebarLayout.js","sourceRoot":"","sources":["../../../src/shell/useSidebarLayout.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,oBAAqB,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAc3C,qDAAqD;AACrD,MAAM,WAAW,GAAG,CAAC,MAAqB,EAAU,EAAE;IACpD,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAC7B,OAAO,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC;AACzG,CAAC,CAAC;AAEF,4BAA4B;AAC5B,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAkB,EAAE;IAClD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,SAAS,CAAC,eAAe,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;IAC1E,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,SAAS,CACnC,SAAS,EACT,CAAC,MAAqB,EAAW,EAAE,CAAC,MAAM,KAAK,QAAQ,EACvD,CAAC,KAAc,EAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CACzD,CAAC;IACF,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AAChD,CAAC,CAAC"}

package/dist/src/shell/useStored.d.ts

@@ -0,0 +1,11 @@
+/**
+ * A value kept in this browser.
+ *
+ * @param name - the value's name (`dock-height`), stored under the catalogue's id (`acme-ui:dock-height`), so two
+ *   catalogues on one origin keep their own.
+ * @param read - the value a stored text holds, or the default when it holds none.
+ * @param write - the text a value is stored as.
+ * @returns the value and its setter.
+ */
+export declare const useStored: <TValue>(name: string, read: (stored: string | null) => TValue, write: (value: TValue) => string) => [TValue, (value: TValue) => void];
+//# sourceMappingURL=useStored.d.ts.map

package/dist/src/shell/useStored.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStored.d.ts","sourceRoot":"","sources":["../../../src/shell/useStored.ts"],"names":[],"mappings":"AAoDA;;;;;;;;GAQG;AACH,eAAO,MAAM,SAAS,GAAI,MAAM,EAC9B,MAAM,MAAM,EACZ,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,KAAK,MAAM,EACvC,OAAO,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,KAC/B,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAMlC,CAAC"}

package/dist/src/shell/useStored.js

@@ -0,0 +1,68 @@
+/**
+ * A value this browser keeps for the next visit (the panel's height, the sidebar's width): a convenience of the
+ * person, not part of the page an address shares.
+ *
+ * @remarks
+ * Storage may be missing or refused (a private window, blocked site data): the value then lives only as long as the
+ * page, and nothing fails.
+ *
+ * @module
+ */
+import { useEffect, useState } from "react";
+import { useCatalogue } from "./catalogueContext.js";
+/** The stored text under a key, or none when there is none or storage is refused. */
+const readStored = (key) => {
+    try {
+        return window.localStorage.getItem(key);
+    }
+    catch {
+        return null;
+    }
+};
+/** Keeps a text under a key, when storage allows it. */
+const writeStored = (key, value) => {
+    try {
+        window.localStorage.setItem(key, value);
+    }
+    catch {
+        // a refused storage only loses the convenience
+    }
+};
+/**
+ * A value stored under the name every catalogue shared (`forgebook:<name>`), moved under the catalogue's key: read
+ * once, written under the new key, removed from the old one.
+ *
+ * @param name - the value's name.
+ * @param key - the catalogue's key for it.
+ * @returns the value moved; none when there was none.
+ */
+const movedStored = (name, key) => {
+    const old = readStored(`forgebook:${name}`);
+    if (old === null)
+        return null;
+    writeStored(key, old);
+    try {
+        window.localStorage.removeItem(`forgebook:${name}`);
+    }
+    catch {
+        // a browser that refuses the storage keeps nothing anyway
+    }
+    return old;
+};
+/**
+ * A value kept in this browser.
+ *
+ * @param name - the value's name (`dock-height`), stored under the catalogue's id (`acme-ui:dock-height`), so two
+ *   catalogues on one origin keep their own.
+ * @param read - the value a stored text holds, or the default when it holds none.
+ * @param write - the text a value is stored as.
+ * @returns the value and its setter.
+ */
+export const useStored = (name, read, write) => {
+    const key = `${useCatalogue().id}:${name}`;
+    const [value, setValue] = useState(() => read(readStored(key) ?? movedStored(name, key)));
+    const text = write(value);
+    useEffect(() => writeStored(key, text), [key, text]);
+    return [value, setValue];
+};
+//# sourceMappingURL=useStored.js.map

package/dist/src/shell/useStored.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStored.js","sourceRoot":"","sources":["../../../src/shell/useStored.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE5C,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,qFAAqF;AACrF,MAAM,UAAU,GAAG,CAAC,GAAW,EAAiB,EAAE;IAChD,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AAEF,wDAAwD;AACxD,MAAM,WAAW,GAAG,CAAC,GAAW,EAAE,KAAa,EAAQ,EAAE;IACvD,IAAI,CAAC;QACH,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,+CAA+C;IACjD,CAAC;AACH,CAAC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,WAAW,GAAG,CAAC,IAAY,EAAE,GAAW,EAAiB,EAAE;IAC/D,MAAM,GAAG,GAAG,UAAU,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC;IAC5C,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC9B,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACtB,IAAI,CAAC;QACH,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACP,0DAA0D;IAC5D,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CACvB,IAAY,EACZ,IAAuC,EACvC,KAAgC,EACG,EAAE;IACrC,MAAM,GAAG,GAAG,GAAG,YAAY,EAAE,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;IAC3C,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,WAAW,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IAC1F,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;IAC1B,SAAS,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;IACrD,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;AAC3B,CAAC,CAAC"}

package/dist/src/shell/useStoryCode.d.ts

@@ -0,0 +1,14 @@
+/**
+ * A story file's code for the Code card: each story's `render` as written, loaded from the source's `code`.
+ *
+ * @module
+ */
+import type { StoryFileCode } from "@forgebook/story-format/source";
+import { type Loaded } from "./useLoaded.ts";
+/**
+ * The code of a story file.
+ *
+ * @param load - the source's loader for the file; `undefined` when it has none.
+ */
+export declare const useStoryCode: (load: (() => Promise<unknown>) | undefined) => Loaded<StoryFileCode>;
+//# sourceMappingURL=useStoryCode.d.ts.map

package/dist/src/shell/useStoryCode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStoryCode.d.ts","sourceRoot":"","sources":["../../../src/shell/useStoryCode.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAEpE,OAAO,EAAE,KAAK,MAAM,EAAa,MAAM,gBAAgB,CAAC;AA2BxD;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,MAAM,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,SAAS,KAAG,MAAM,CAAC,aAAa,CAClE,CAAC"}

package/dist/src/shell/useStoryCode.js

@@ -0,0 +1,29 @@
+import { useLoaded } from "./useLoaded.js";
+/** Whether a value is one story's code: its text and its HTML. */
+const isStoryCode = (value) => typeof value === "object" &&
+    value !== null &&
+    "text" in value &&
+    typeof value.text === "string" &&
+    "html" in value &&
+    typeof value.html === "string";
+/** Whether the plugin's answer is a file's code: each story's text and HTML, by export name. */
+const isStoryFileCode = (value) => typeof value === "object" &&
+    value !== null &&
+    !("error" in value) &&
+    Object.values(value).every(isStoryCode);
+/** What the plugin answered, as a state. */
+const codeState = (value) => {
+    if (isStoryFileCode(value))
+        return { status: "ready", value };
+    if (typeof value === "object" && value !== null && "error" in value && typeof value.error === "string") {
+        return { status: "error", message: value.error };
+    }
+    return { status: "error", message: "The story file's code has an unexpected shape" };
+};
+/**
+ * The code of a story file.
+ *
+ * @param load - the source's loader for the file; `undefined` when it has none.
+ */
+export const useStoryCode = (load) => useLoaded(load, codeState);
+//# sourceMappingURL=useStoryCode.js.map

package/dist/src/shell/useStoryCode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStoryCode.js","sourceRoot":"","sources":["../../../src/shell/useStoryCode.ts"],"names":[],"mappings":"AAOA,OAAO,EAAe,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAExD,kEAAkE;AAClE,MAAM,WAAW,GAAG,CAAC,KAAc,EAAW,EAAE,CAC9C,OAAO,KAAK,KAAK,QAAQ;IACzB,KAAK,KAAK,IAAI;IACd,MAAM,IAAI,KAAK;IACf,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;IAC9B,MAAM,IAAI,KAAK;IACf,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC;AAEjC,gGAAgG;AAChG,MAAM,eAAe,GAAG,CAAC,KAAc,EAA0B,EAAE,CACjE,OAAO,KAAK,KAAK,QAAQ;IACzB,KAAK,KAAK,IAAI;IACd,CAAC,CAAC,OAAO,IAAI,KAAK,CAAC;IACnB,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;AAE1C,4CAA4C;AAC5C,MAAM,SAAS,GAAG,CAAC,KAAc,EAAyB,EAAE;IAC1D,IAAI,eAAe,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC9D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvG,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;IACnD,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,+CAA+C,EAAE,CAAC;AACvF,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAA0C,EAAyB,EAAE,CAChG,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC"}

package/dist/src/shell/useStoryHeights.d.ts

@@ -0,0 +1,9 @@
+import { type StoryHeights } from "../storyHeights.ts";
+/**
+ * The stories' measured heights.
+ *
+ * @param url - the heights' file, relative to the page; none when the catalogue has none.
+ * @returns the heights, or none while they load or when there are none.
+ */
+export declare const useStoryHeights: (url: string | undefined) => StoryHeights | undefined;
+//# sourceMappingURL=useStoryHeights.d.ts.map

package/dist/src/shell/useStoryHeights.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStoryHeights.d.ts","sourceRoot":"","sources":["../../../src/shell/useStoryHeights.ts"],"names":[],"mappings":"AAYA,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAOvE;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAAI,KAAK,MAAM,GAAG,SAAS,KAAG,YAAY,GAAG,SAaxE,CAAC"}

package/dist/src/shell/useStoryHeights.js

@@ -0,0 +1,31 @@
+/**
+ * The stories' measured heights, read once from the file the catalogue's configuration names (`heights`), for the
+ * loading boxes.
+ *
+ * @remarks
+ * The file is generated (`forgebook-heights`) and may be missing, stale or, on a development server, answered with
+ * the page itself: any answer that is not the heights' document is none, and the shell waits as it did without one.
+ *
+ * @module
+ */
+import { useMemo } from "react";
+import { isStoryHeights } from "../storyHeights.js";
+import { useLoaded } from "./useLoaded.js";
+/** The file's answer as a state: the heights, or none for anything else. */
+const heightsState = (value) => isStoryHeights(value) ? { status: "ready", value } : { status: "none" };
+/**
+ * The stories' measured heights.
+ *
+ * @param url - the heights' file, relative to the page; none when the catalogue has none.
+ * @returns the heights, or none while they load or when there are none.
+ */
+export const useStoryHeights = (url) => {
+    const load = useMemo(() => url === undefined
+        ? undefined
+        : () => fetch(url)
+            .then((response) => (response.ok ? response.json() : undefined))
+            .catch(() => undefined), [url]);
+    const heights = useLoaded(load, heightsState);
+    return heights.status === "ready" ? heights.value : undefined;
+};
+//# sourceMappingURL=useStoryHeights.js.map

package/dist/src/shell/useStoryHeights.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStoryHeights.js","sourceRoot":"","sources":["../../../src/shell/useStoryHeights.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEhC,OAAO,EAAE,cAAc,EAAqB,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAe,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAExD,4EAA4E;AAC5E,MAAM,YAAY,GAAG,CAAC,KAAc,EAAwB,EAAE,CAC5D,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAE1E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,GAAuB,EAA4B,EAAE;IACnF,MAAM,IAAI,GAAG,OAAO,CAClB,GAAG,EAAE,CACH,GAAG,KAAK,SAAS;QACf,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,GAAqB,EAAE,CACrB,KAAK,CAAC,GAAG,CAAC;aACP,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;aAC/D,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,EACjC,CAAC,GAAG,CAAC,CACN,CAAC;IACF,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAC9C,OAAO,OAAO,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAChE,CAAC,CAAC"}

package/dist/src/shell/useStoryIdsElement.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Keeps the page's list of story ids current.
+ *
+ * @param storyIds - every story's id, in the sidebar's order.
+ */
+export declare const useStoryIdsElement: (storyIds: readonly string[]) => void;
+//# sourceMappingURL=useStoryIdsElement.d.ts.map

package/dist/src/shell/useStoryIdsElement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStoryIdsElement.d.ts","sourceRoot":"","sources":["../../../src/shell/useStoryIdsElement.ts"],"names":[],"mappings":"AAaA;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,UAAU,SAAS,MAAM,EAAE,KAAG,IAWhE,CAAC"}

package/dist/src/shell/useStoryIdsElement.js

@@ -0,0 +1,29 @@
+/**
+ * The catalogue's story ids, written into the page for its command-line tools: `forgebook-heights` opens the
+ * catalogue and reads them, so a tool needs no source of its own to know which stories there are.
+ *
+ * @remarks
+ * A `<script type="application/json">` in the head, which the browser never runs: data on the page, not a global.
+ *
+ * @module
+ */
+import { useEffect } from "react";
+import { STORY_IDS_ELEMENT } from "../storyIdsElement.js";
+/**
+ * Keeps the page's list of story ids current.
+ *
+ * @param storyIds - every story's id, in the sidebar's order.
+ */
+export const useStoryIdsElement = (storyIds) => {
+    useEffect(() => {
+        let element = document.getElementById(STORY_IDS_ELEMENT);
+        if (element === null) {
+            element = document.createElement("script");
+            element.id = STORY_IDS_ELEMENT;
+            element.setAttribute("type", "application/json");
+            document.head.append(element);
+        }
+        element.textContent = JSON.stringify(storyIds);
+    }, [storyIds]);
+};
+//# sourceMappingURL=useStoryIdsElement.js.map

package/dist/src/shell/useStoryIdsElement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStoryIdsElement.js","sourceRoot":"","sources":["../../../src/shell/useStoryIdsElement.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElC,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1D;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,QAA2B,EAAQ,EAAE;IACtE,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,OAAO,GAAG,QAAQ,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC;QACzD,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,OAAO,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;YAC3C,OAAO,CAAC,EAAE,GAAG,iBAAiB,CAAC;YAC/B,OAAO,CAAC,YAAY,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;YACjD,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAChC,CAAC;QACD,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACjD,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;AACjB,CAAC,CAAC"}

package/dist/src/shell/useStoryKeys.d.ts

@@ -0,0 +1,11 @@
+import { type StoryTree } from "../storyTree.ts";
+/**
+ * Listens to the keys that walk the stories.
+ *
+ * @param tree - the tree.
+ * @param shownStoryId - the shown story's id; none on a component's page.
+ * @param firstOfPage - on a component's page, its first story's id.
+ * @param openStory - opens a story by its id.
+ */
+export declare const useStoryKeys: (tree: StoryTree, shownStoryId: string | undefined, firstOfPage: string | undefined, openStory: (id: string) => void) => void;
+//# sourceMappingURL=useStoryKeys.d.ts.map

package/dist/src/shell/useStoryKeys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStoryKeys.d.ts","sourceRoot":"","sources":["../../../src/shell/useStoryKeys.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,SAAS,EAAmB,MAAM,iBAAiB,CAAC;AAIlE;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,GACvB,MAAM,SAAS,EACf,cAAc,MAAM,GAAG,SAAS,EAChC,aAAa,MAAM,GAAG,SAAS,EAC/B,WAAW,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,KAC9B,IAyBF,CAAC"}

package/dist/src/shell/useStoryKeys.js

@@ -0,0 +1,40 @@
+/**
+ * The keys that walk a catalogue's stories: `[` and `]` open the previous and the next story in the sidebar's order;
+ * on a component's page `]` opens its first story (`keyboard.ts`).
+ *
+ * @module
+ */
+import { useEffect, useMemo, useRef } from "react";
+import { sidebarStoryIds } from "../storyTree.js";
+import { useCatalogue } from "./catalogueContext.js";
+import { steppedStory, storyStep } from "./keyboard.js";
+/**
+ * Listens to the keys that walk the stories.
+ *
+ * @param tree - the tree.
+ * @param shownStoryId - the shown story's id; none on a component's page.
+ * @param firstOfPage - on a component's page, its first story's id.
+ * @param openStory - opens a story by its id.
+ */
+export const useStoryKeys = (tree, shownStoryId, firstOfPage, openStory) => {
+    const { storyGroups } = useCatalogue();
+    const storyIds = useMemo(() => sidebarStoryIds(tree, storyGroups.map((group) => group.id)), [tree, storyGroups]);
+    // the latest opener, without listening again on every render
+    const openRef = useRef(openStory);
+    openRef.current = openStory;
+    useEffect(() => {
+        const walk = (event) => {
+            const step = storyStep(event);
+            if (step === undefined)
+                return;
+            const id = steppedStory(storyIds, shownStoryId, step, step === 1 ? firstOfPage : undefined);
+            if (id === undefined)
+                return;
+            event.preventDefault();
+            openRef.current(id);
+        };
+        document.addEventListener("keydown", walk);
+        return () => document.removeEventListener("keydown", walk);
+    }, [storyIds, shownStoryId, firstOfPage]);
+};
+//# sourceMappingURL=useStoryKeys.js.map

package/dist/src/shell/useStoryKeys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStoryKeys.js","sourceRoot":"","sources":["../../../src/shell/useStoryKeys.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAEnD,OAAO,EAAkB,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAExD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,IAAe,EACf,YAAgC,EAChC,WAA+B,EAC/B,SAA+B,EACzB,EAAE;IACR,MAAM,EAAE,WAAW,EAAE,GAAG,YAAY,EAAE,CAAC;IACvC,MAAM,QAAQ,GAAG,OAAO,CACtB,GAAG,EAAE,CACH,eAAe,CACb,IAAI,EACJ,WAAW,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CACrC,EACH,CAAC,IAAI,EAAE,WAAW,CAAC,CACpB,CAAC;IACF,6DAA6D;IAC7D,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;IAClC,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;IAC5B,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,IAAI,GAAG,CAAC,KAAoB,EAAQ,EAAE;YAC1C,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;YAC9B,IAAI,IAAI,KAAK,SAAS;gBAAE,OAAO;YAC/B,MAAM,EAAE,GAAG,YAAY,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YAC5F,IAAI,EAAE,KAAK,SAAS;gBAAE,OAAO;YAC7B,KAAK,CAAC,cAAc,EAAE,CAAC;YACvB,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACtB,CAAC,CAAC;QACF,QAAQ,CAAC,gBAAgB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAC3C,OAAO,GAAS,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IACnE,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,WAAW,CAAC,CAAC,CAAC;AAC5C,CAAC,CAAC"}

package/dist/src/shell/useSystemDark.d.ts

@@ -0,0 +1,3 @@
+/** Whether the system prefers dark; light where there is no window (a test rendering on the server). */
+export declare const useSystemDark: () => boolean;
+//# sourceMappingURL=useSystemDark.d.ts.map

package/dist/src/shell/useSystemDark.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSystemDark.d.ts","sourceRoot":"","sources":["../../../src/shell/useSystemDark.ts"],"names":[],"mappings":"AAoBA,wGAAwG;AACxG,eAAO,MAAM,aAAa,QAAO,OAAkE,CAAC"}

package/dist/src/shell/useSystemDark.js

@@ -0,0 +1,19 @@
+/**
+ * Whether the system prefers a dark appearance, kept current: the `system` theme follows it.
+ *
+ * @module
+ */
+import { useSyncExternalStore } from "react";
+/** The media query of a dark appearance. */
+const DARK = "(prefers-color-scheme: dark)";
+/** Listens to the system's appearance. */
+const subscribe = (onChange) => {
+    const query = window.matchMedia(DARK);
+    query.addEventListener("change", onChange);
+    return () => query.removeEventListener("change", onChange);
+};
+/** Whether the system prefers dark now. */
+const isDarkNow = () => window.matchMedia(DARK).matches;
+/** Whether the system prefers dark; light where there is no window (a test rendering on the server). */
+export const useSystemDark = () => useSyncExternalStore(subscribe, isDarkNow, () => false);
+//# sourceMappingURL=useSystemDark.js.map

package/dist/src/shell/useSystemDark.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSystemDark.js","sourceRoot":"","sources":["../../../src/shell/useSystemDark.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAE7C,4CAA4C;AAC5C,MAAM,IAAI,GAAG,8BAA8B,CAAC;AAE5C,0CAA0C;AAC1C,MAAM,SAAS,GAAG,CAAC,QAAoB,EAAgB,EAAE;IACvD,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACtC,KAAK,CAAC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC3C,OAAO,GAAS,EAAE,CAAC,KAAK,CAAC,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AACnE,CAAC,CAAC;AAEF,2CAA2C;AAC3C,MAAM,SAAS,GAAG,GAAY,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC;AAEjE,wGAAwG;AACxG,MAAM,CAAC,MAAM,aAAa,GAAG,GAAY,EAAE,CAAC,oBAAoB,CAAC,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC"}

package/dist/src/sourceFiles.d.ts

@@ -0,0 +1,18 @@
+/**
+ * A source's story files as one group: its `?forgebook-files` groups merged, so the tree, the frame and the panel look
+ * a file up by its key wherever its pattern was declared.
+ *
+ * @remarks
+ * The keys are paths relative to the module that declared the source, unique across its groups. The merge is kept per
+ * source object, so a page that asks on every render merges once. Pure apart from that cache.
+ *
+ * @module
+ */
+import type { StoryFiles, StorySource } from "@forgebook/story-format/source";
+/**
+ * A source's story files, every group merged.
+ *
+ * @param source - the source.
+ */
+export declare const sourceFiles: (source: StorySource) => StoryFiles;
+//# sourceMappingURL=sourceFiles.d.ts.map

package/dist/src/sourceFiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sourceFiles.d.ts","sourceRoot":"","sources":["../../src/sourceFiles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAK9E;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,QAAQ,WAAW,KAAG,UAYjD,CAAC"}

package/dist/src/sourceFiles.js

@@ -0,0 +1,22 @@
+/** The merged files of each source seen, by the source object itself. */
+const MERGED = new WeakMap();
+/**
+ * A source's story files, every group merged.
+ *
+ * @param source - the source.
+ */
+export const sourceFiles = (source) => {
+    const known = MERGED.get(source);
+    if (known !== undefined)
+        return known;
+    const merged = {
+        index: Object.assign({}, ...source.files.map((group) => group.index)),
+        stories: Object.assign({}, ...source.files.map((group) => group.stories)),
+        docs: Object.assign({}, ...source.files.map((group) => group.docs)),
+        code: Object.assign({}, ...source.files.map((group) => group.code)),
+        pages: Object.assign({}, ...source.files.map((group) => group.pages))
+    };
+    MERGED.set(source, merged);
+    return merged;
+};
+//# sourceMappingURL=sourceFiles.js.map

package/dist/src/sourceFiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sourceFiles.js","sourceRoot":"","sources":["../../src/sourceFiles.ts"],"names":[],"mappings":"AAYA,yEAAyE;AACzE,MAAM,MAAM,GAAG,IAAI,OAAO,EAA2B,CAAC;AAEtD;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,MAAmB,EAAc,EAAE;IAC7D,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACjC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACtC,MAAM,MAAM,GAAe;QACzB,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACrE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACzE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACnE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACnE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;KACtE,CAAC;IACF,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}