@orz/ui 0.0.0-stage → 0.1.0

package/dist/hooks/scroll-insets.d.ts

@@ -0,0 +1,89 @@
+import { type RefObject } from "react";
+/** Page coordinates of the thing to be revealed. */
+export type ScrollBlock = {
+    top: number;
+    height: number;
+};
+/** Viewport coordinates of the strip no overlay covers. */
+export type UsableViewport = {
+    top: number;
+    height: number;
+};
+/**
+ * `"auto"` centres a block that fits and tops-aligns one that does not;
+ * `"start"` demands the top edge even when the block would fit, which is what
+ * a file diff wants — its path header under the toolbar (T-190 §5).
+ */
+export type RevealMode = "auto" | "start";
+/** Which `scrollIntoView` alignment reveals as much of `block` as it can. */
+export declare function blockFor(block: ScrollBlock, usable: UsableViewport, mode?: RevealMode): ScrollLogicalPosition;
+/**
+ * Where the page comes to rest once `scrollIntoView` has placed `block`.
+ * ↑↓ and the counter read this instead of performing the scroll, so the number
+ * on screen cannot disagree with where the arrow lands (T-61).
+ */
+export declare function restingScrollY(block: ScrollBlock, usable: UsableViewport, mode?: RevealMode): number;
+/**
+ * Read back off `<html>` rather than passed down: the calls that land a target
+ * sit deep inside components that know nothing about the page's overlays, and
+ * `scroll-padding` is already the value the engine itself obeys.
+ */
+export declare function usableViewport(): UsableViewport;
+/**
+ * Open every closed `<details>` between `el` and the document root.
+ *
+ * A target inside a shut fold has no box at all, so `scrollIntoView` on it
+ * does nothing and reports nothing.
+ */
+export declare function openEnclosingFolds(el: Element): void;
+/**
+ * Bring `el` into the strip no overlay covers, and flash it. The one landing
+ * out of which every anchor, ↑↓ step and per-file jump is served.
+ */
+export declare function revealBlock(el: HTMLElement, { mode, behavior, flash: highlight, }?: {
+    mode?: RevealMode;
+    behavior?: ScrollBehavior;
+    flash?: boolean;
+}): void;
+/**
+ * Whether an untouched reader is being held on a particular element, as
+ * opposed to the end of the document or nothing at all. Following a new item
+ * at the end should not take the reader off a target they were sent to.
+ */
+export declare function isHoldingTarget(): boolean;
+/**
+ * Hold `el` where `revealBlock` put it, re-revealing it without the flash
+ * every time `container` resizes; see `hold`.
+ */
+export declare function holdRevealed(el: HTMLElement, container: Element, mode?: RevealMode, behavior?: ScrollBehavior): () => void;
+/** Go to the end of the document and stay there; see `hold`. */
+export declare function landAtBottom(): () => void;
+/**
+ * Keep the release of the last hold this component started, and call it on
+ * unmount: a page left without input would otherwise go on being held.
+ */
+export declare function useOwnHold(): (release: () => void) => void;
+export type ScrollInsetSources = {
+    /** Overlays pinned to the viewport's top edge, a fixed app header included. */
+    top?: ReadonlyArray<RefObject<HTMLElement | null>>;
+    bottom?: ReadonlyArray<RefObject<HTMLElement | null>>;
+};
+/**
+ * Declare this page's overlays, so every `scrollIntoView` on it lands clear of
+ * them.
+ *
+ * `useLayoutEffect`, not `useEffect`: an anchor that scrolls from a passive
+ * effect in a child runs before any passive effect here, and a one-shot guard
+ * there never offers a second chance. Layout effects run ahead of the whole
+ * passive pass, so the insets are always in place first.
+ *
+ * The elements are measured directly rather than through `useElementHeight`,
+ * whose state holds a fallback for one commit — 56 against a real 93 on a
+ * narrow screen, exactly across the frame a hard refresh lands in.
+ *
+ * No overlay is added implicitly: a fixed header is one more ref in `top`.
+ * What an on-screen keyboard covers is counted on its own, from the visual
+ * viewport. The landing flash is `.anchor-flash` from `@orz/ui/styles.css`.
+ */
+export declare function useScrollInsets({ top, bottom, }: ScrollInsetSources): void;
+//# sourceMappingURL=scroll-insets.d.ts.map

package/dist/hooks/scroll-insets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll-insets.d.ts","sourceRoot":"","sources":["../../src/hooks/scroll-insets.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,SAAS,EAKf,MAAM,OAAO,CAAC;AAMf,oDAAoD;AACpD,MAAM,MAAM,WAAW,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1D,2DAA2D;AAC3D,MAAM,MAAM,cAAc,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7D;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC;AAK1C,6EAA6E;AAC7E,wBAAgB,QAAQ,CACtB,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,cAAc,EACtB,IAAI,GAAE,UAAmB,GACxB,qBAAqB,CAMvB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,cAAc,EACtB,IAAI,GAAE,UAAmB,GACxB,MAAM,CAGR;AAQD;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,cAAc,CAK/C;AAeD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,CAOpD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,EAAE,EAAE,WAAW,EACf,EACE,IAAa,EACb,QAAQ,EACR,KAAK,EAAE,SAAgB,GACxB,GAAE;IACD,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;CACZ,GACL,IAAI,CAUN;AAQD;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAyCD;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,EAAE,EAAE,WAAW,EACf,SAAS,EAAE,OAAO,EAClB,IAAI,GAAE,UAAmB,EACzB,QAAQ,CAAC,EAAE,cAAc,GACxB,MAAM,IAAI,CAMZ;AAcD,gEAAgE;AAChE,wBAAgB,YAAY,IAAI,MAAM,IAAI,CAGzC;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,CAAC,OAAO,EAAE,MAAM,IAAI,KAAK,IAAI,CAO1D;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,+EAA+E;IAC/E,GAAG,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC,CAAC;IACnD,MAAM,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC,CAAC;CACvD,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,EAC9B,GAAQ,EACR,MAAW,GACZ,EAAE,kBAAkB,GAAG,IAAI,CAoF3B"}

package/dist/hooks/scroll-insets.js

@@ -0,0 +1,265 @@
+import { useCallback, useEffect, useLayoutEffect, useRef, } from "react";
+import { VIEWPORT_CHROME_EVENT, visualViewportInsets, } from "./viewport-chrome.js";
+/** Gap between an overlay's edge and whatever lands against it. */
+const BREATHING_ROOM = 8;
+/** Which `scrollIntoView` alignment reveals as much of `block` as it can. */
+export function blockFor(block, usable, mode = "auto") {
+    if (mode === "start")
+        return "start";
+    // Overlays can leave nothing over — a long draft in the composer takes the
+    // strip past zero — and centring in a negative strip aims above its own top.
+    if (usable.height <= 0)
+        return "start";
+    return block.height <= usable.height ? "center" : "start";
+}
+/**
+ * Where the page comes to rest once `scrollIntoView` has placed `block`.
+ * ↑↓ and the counter read this instead of performing the scroll, so the number
+ * on screen cannot disagree with where the arrow lands (T-61).
+ */
+export function restingScrollY(block, usable, mode = "auto") {
+    if (blockFor(block, usable, mode) === "start")
+        return block.top - usable.top;
+    return block.top + block.height / 2 - (usable.top + usable.height / 2);
+}
+/** `auto` and anything unparseable both mean "no overlay on that edge". */
+function pixelsOf(value) {
+    const parsed = Number.parseFloat(value);
+    return Number.isFinite(parsed) ? parsed : 0;
+}
+/**
+ * Read back off `<html>` rather than passed down: the calls that land a target
+ * sit deep inside components that know nothing about the page's overlays, and
+ * `scroll-padding` is already the value the engine itself obeys.
+ */
+export function usableViewport() {
+    const style = getComputedStyle(document.documentElement);
+    const top = pixelsOf(style.scrollPaddingTop);
+    const bottom = pixelsOf(style.scrollPaddingBottom);
+    return { top, height: window.innerHeight - top - bottom };
+}
+/** One-shot highlight; restartable when the same target is revealed again. */
+function flash(el) {
+    el.classList.remove("anchor-flash");
+    // Reflow so removing+adding the class restarts the animation.
+    void el.offsetWidth;
+    el.classList.add("anchor-flash");
+    el.addEventListener("animationend", () => el.classList.remove("anchor-flash"), { once: true });
+}
+/**
+ * Open every closed `<details>` between `el` and the document root.
+ *
+ * A target inside a shut fold has no box at all, so `scrollIntoView` on it
+ * does nothing and reports nothing.
+ */
+export function openEnclosingFolds(el) {
+    for (let from = el.parentElement; from !== null;) {
+        const fold = from.closest("details:not([open])");
+        if (fold === null)
+            return;
+        fold.setAttribute("open", "");
+        from = fold.parentElement;
+    }
+}
+/**
+ * Bring `el` into the strip no overlay covers, and flash it. The one landing
+ * out of which every anchor, ↑↓ step and per-file jump is served.
+ */
+export function revealBlock(el, { mode = "auto", behavior, flash: highlight = true, } = {}) {
+    openEnclosingFolds(el);
+    const rect = el.getBoundingClientRect();
+    const block = blockFor({ top: rect.top + window.scrollY, height: rect.height }, usableViewport(), mode);
+    el.scrollIntoView({ block, behavior });
+    if (highlight)
+        flash(el);
+}
+/**
+ * The page's one hold. Two at once would each put the viewport back on its
+ * own target at every resize, so a newer landing retires the older one.
+ */
+let held = null;
+/**
+ * Whether an untouched reader is being held on a particular element, as
+ * opposed to the end of the document or nothing at all. Following a new item
+ * at the end should not take the reader off a target they were sent to.
+ */
+export function isHoldingTarget() {
+    return held !== null && !held.onEnd;
+}
+/**
+ * Run `place` again every time `container` resizes, until the reader's first
+ * input. Returns the release, for when the landing stops mattering first.
+ *
+ * A landing is made against the page as it stands, and the page keeps
+ * arriving after it: images, diffs, attachment lists, each pushing the target
+ * away from where it was put. After the first input, re-placing would fight
+ * the reader. There is no settle timeout: late content lands with unbounded
+ * gaps, and a timer that fires inside one re-opens the race.
+ *
+ * Dragging the scrollbar counts as input: Chromium and Firefox both deliver
+ * its `pointerdown` to `<html>`.
+ */
+function hold(container, place, onEnd = false) {
+    held?.release();
+    if (typeof ResizeObserver === "undefined")
+        return () => { }; // happy-dom
+    const controller = new AbortController();
+    const observer = new ResizeObserver(() => place(release));
+    const release = () => {
+        observer.disconnect();
+        controller.abort();
+        if (held?.release === release)
+            held = null;
+    };
+    observer.observe(container);
+    for (const type of ["wheel", "touchstart", "pointerdown", "keydown"]) {
+        window.addEventListener(type, release, {
+            capture: true,
+            passive: true,
+            signal: controller.signal,
+        });
+    }
+    held = { release, onEnd };
+    return release;
+}
+/**
+ * Hold `el` where `revealBlock` put it, re-revealing it without the flash
+ * every time `container` resizes; see `hold`.
+ */
+export function holdRevealed(el, container, mode = "auto", behavior) {
+    return hold(container, (release) => {
+        // Gone with a route change nobody touched the page for.
+        if (!el.isConnected)
+            release();
+        else
+            revealBlock(el, { mode, behavior, flash: false });
+    });
+}
+/**
+ * Bottom of the document, which sits below a sticky composer's in-flow spot.
+ *
+ * The largest offset there is, not `scrollHeight`: iOS Safari takes the
+ * overshoot literally for a frame, parking the visual viewport a whole screen
+ * past the end — one blank white frame on every landing.
+ */
+function scrollToEnd() {
+    const root = document.documentElement;
+    window.scrollTo(0, Math.max(0, root.scrollHeight - root.clientHeight));
+}
+/** Go to the end of the document and stay there; see `hold`. */
+export function landAtBottom() {
+    scrollToEnd();
+    return hold(document.body, scrollToEnd, true);
+}
+/**
+ * Keep the release of the last hold this component started, and call it on
+ * unmount: a page left without input would otherwise go on being held.
+ */
+export function useOwnHold() {
+    const own = useRef(() => { });
+    useEffect(() => () => own.current(), []);
+    return useCallback((release) => {
+        own.current();
+        own.current = release;
+    }, []);
+}
+/**
+ * Declare this page's overlays, so every `scrollIntoView` on it lands clear of
+ * them.
+ *
+ * `useLayoutEffect`, not `useEffect`: an anchor that scrolls from a passive
+ * effect in a child runs before any passive effect here, and a one-shot guard
+ * there never offers a second chance. Layout effects run ahead of the whole
+ * passive pass, so the insets are always in place first.
+ *
+ * The elements are measured directly rather than through `useElementHeight`,
+ * whose state holds a fallback for one commit — 56 against a real 93 on a
+ * narrow screen, exactly across the frame a hard refresh lands in.
+ *
+ * No overlay is added implicitly: a fixed header is one more ref in `top`.
+ * What an on-screen keyboard covers is counted on its own, from the visual
+ * viewport. The landing flash is `.anchor-flash` from `@orz/ui/styles.css`.
+ */
+export function useScrollInsets({ top = [], bottom = [], }) {
+    const sources = useRef({ top, bottom });
+    const remeasure = useRef(() => { });
+    useLayoutEffect(() => {
+        const root = document.documentElement;
+        const observed = new Set();
+        let observer = null;
+        const watch = (el) => {
+            if (observed.has(el))
+                return;
+            observed.add(el);
+            observer?.observe(el);
+        };
+        const measure = () => {
+            // A caret inside a sticky overlay always sits within that overlay's own
+            // inset, and Chrome's caret reveal honours scroll-padding: it scrolled
+            // the page on every typed character, the overlay riding along, so the
+            // caret was never "revealed". Nothing inside an overlay can be hidden
+            // behind it, so the one holding focus stops counting.
+            const focused = document.activeElement;
+            const extent = (el) => focused !== null && el.contains(focused)
+                ? 0
+                : el.getBoundingClientRect().height;
+            let overlays = 0;
+            let bottomInset = 0;
+            for (const el of sources.current.top.map((r) => r.current)) {
+                if (el === null)
+                    continue;
+                overlays += extent(el);
+                watch(el);
+            }
+            for (const el of sources.current.bottom.map((r) => r.current)) {
+                if (el === null)
+                    continue;
+                bottomInset += extent(el);
+                watch(el);
+            }
+            // A keyboard covers the layout viewport's bottom and can pan its top
+            // out of view; sticky edges follow it, and so must the padding, or a
+            // reveal would centre its target behind the keyboard. A header
+            // useAutoHideHeader has slid partly away covers that much less.
+            const edges = visualViewportInsets();
+            const slid = pixelsOf(root.style.getPropertyValue("--header-hide"));
+            const topInset = BREATHING_ROOM + edges.top + Math.max(0, overlays - slid);
+            bottomInset += edges.bottom;
+            root.style.scrollPaddingTop = `${topInset}px`;
+            root.style.scrollPaddingBottom = `${bottomInset}px`;
+        };
+        observer =
+            typeof ResizeObserver === "undefined"
+                ? null
+                : new ResizeObserver(measure);
+        remeasure.current = measure;
+        measure();
+        window.addEventListener("resize", measure);
+        window.addEventListener(VIEWPORT_CHROME_EVENT, measure);
+        // A keyboard opening resizes only the visual viewport, never the window.
+        const vv = window.visualViewport;
+        vv?.addEventListener("resize", measure);
+        vv?.addEventListener("scroll", measure);
+        document.addEventListener("focusin", measure);
+        document.addEventListener("focusout", measure);
+        return () => {
+            window.removeEventListener("resize", measure);
+            window.removeEventListener(VIEWPORT_CHROME_EVENT, measure);
+            vv?.removeEventListener("resize", measure);
+            vv?.removeEventListener("scroll", measure);
+            document.removeEventListener("focusin", measure);
+            document.removeEventListener("focusout", measure);
+            observer?.disconnect();
+            root.style.removeProperty("scroll-padding-top");
+            root.style.removeProperty("scroll-padding-bottom");
+        };
+    }, []);
+    // An overlay that mounts later — a composer opening, one arriving with the
+    // data it belongs to — had a null ref when the effect above ran, and nothing
+    // observes an element that does not exist yet.
+    useLayoutEffect(() => {
+        sources.current = { top, bottom };
+        remeasure.current();
+    });
+}
+//# sourceMappingURL=scroll-insets.js.map

package/dist/hooks/scroll-insets.js.map

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

package/dist/hooks/use-element-height.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The live height of one element, for anything that has to sit directly
+ * beneath it — a header that gains a second row on narrow screens has a
+ * height no CSS offset can name. `fallback` stands in until the first
+ * measurement, and for good when `target` finds nothing.
+ *
+ * `target` is asked once, after mount (`() => ref.current`, or a
+ * `querySelector`), so it may be a fresh closure every render.
+ */
+export declare function useElementHeight(target: () => Element | null, fallback: number): number;
+//# sourceMappingURL=use-element-height.d.ts.map

package/dist/hooks/use-element-height.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-element-height.d.ts","sourceRoot":"","sources":["../../src/hooks/use-element-height.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,OAAO,GAAG,IAAI,EAC5B,QAAQ,EAAE,MAAM,GACf,MAAM,CAuBR"}

package/dist/hooks/use-element-height.js

@@ -0,0 +1,33 @@
+import { useEffect, useRef, useState } from "react";
+/**
+ * The live height of one element, for anything that has to sit directly
+ * beneath it — a header that gains a second row on narrow screens has a
+ * height no CSS offset can name. `fallback` stands in until the first
+ * measurement, and for good when `target` finds nothing.
+ *
+ * `target` is asked once, after mount (`() => ref.current`, or a
+ * `querySelector`), so it may be a fresh closure every render.
+ */
+export function useElementHeight(target, fallback) {
+    const [height, setHeight] = useState(fallback);
+    const find = useRef(target);
+    find.current = target;
+    useEffect(() => {
+        const element = find.current();
+        if (element === null)
+            return;
+        const measure = () => setHeight(element.getBoundingClientRect().height);
+        measure();
+        window.addEventListener("resize", measure);
+        const observer = typeof ResizeObserver === "undefined"
+            ? null
+            : new ResizeObserver(measure);
+        observer?.observe(element);
+        return () => {
+            window.removeEventListener("resize", measure);
+            observer?.disconnect();
+        };
+    }, []);
+    return height;
+}
+//# sourceMappingURL=use-element-height.js.map

package/dist/hooks/use-element-height.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-element-height.js","sourceRoot":"","sources":["../../src/hooks/use-element-height.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEpD;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAA4B,EAC5B,QAAgB;IAEhB,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IAEtB,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAC/B,IAAI,OAAO,KAAK,IAAI;YAAE,OAAO;QAC7B,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,qBAAqB,EAAE,CAAC,MAAM,CAAC,CAAC;QACxE,OAAO,EAAE,CAAC;QACV,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC3C,MAAM,QAAQ,GACZ,OAAO,cAAc,KAAK,WAAW;YACnC,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,IAAI,cAAc,CAAC,OAAO,CAAC,CAAC;QAClC,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QAC3B,OAAO,GAAG,EAAE;YACV,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAC9C,QAAQ,EAAE,UAAU,EAAE,CAAC;QACzB,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/hooks/use-media-query.d.ts

@@ -0,0 +1,22 @@
+/** Tailwind's `md` and `sm`. The one place these breakpoints are written outside CSS. */
+export declare const MD_UP = "(min-width: 768px)";
+export declare const SM_UP = "(min-width: 640px)";
+/**
+ * A mouse-like primary pointer. Asked this way round, and about `pointer`
+ * rather than `any-pointer`, for two reasons:
+ *
+ * - the fallback below answers `true` to everything, so the query has to be
+ *   the one whose `true` is the desktop branch;
+ * - `any-pointer: coarse` flips a touchscreen laptop, whose primary pointer
+ *   is a mouse, onto the touch branch for good.
+ */
+export declare const POINTER_FINE = "(pointer: fine)";
+/**
+ * Whether `query` matches, re-rendering when the answer changes.
+ *
+ * The snapshot is read during render rather than from an effect, so the
+ * first frame already branches the right way. An effect would paint one
+ * branch and correct it a frame later, which reads as a flash.
+ */
+export declare function useMediaQuery(query: string): boolean;
+//# sourceMappingURL=use-media-query.d.ts.map

package/dist/hooks/use-media-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-media-query.d.ts","sourceRoot":"","sources":["../../src/hooks/use-media-query.ts"],"names":[],"mappings":"AAEA,yFAAyF;AACzF,eAAO,MAAM,KAAK,uBAAuB,CAAC;AAC1C,eAAO,MAAM,KAAK,uBAAuB,CAAC;AAE1C;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,oBAAoB,CAAC;AAQ9C;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAWpD"}

package/dist/hooks/use-media-query.js

@@ -0,0 +1,38 @@
+import { useCallback, useSyncExternalStore } from "react";
+/** Tailwind's `md` and `sm`. The one place these breakpoints are written outside CSS. */
+export const MD_UP = "(min-width: 768px)";
+export const SM_UP = "(min-width: 640px)";
+/**
+ * A mouse-like primary pointer. Asked this way round, and about `pointer`
+ * rather than `any-pointer`, for two reasons:
+ *
+ * - the fallback below answers `true` to everything, so the query has to be
+ *   the one whose `true` is the desktop branch;
+ * - `any-pointer: coarse` flips a touchscreen laptop, whose primary pointer
+ *   is a mouse, onto the touch branch for good.
+ */
+export const POINTER_FINE = "(pointer: fine)";
+/** Engines without `matchMedia` get the wide branch, the desktop one. */
+function evaluate(query) {
+    if (typeof window.matchMedia !== "function")
+        return true;
+    return window.matchMedia(query).matches;
+}
+/**
+ * Whether `query` matches, re-rendering when the answer changes.
+ *
+ * The snapshot is read during render rather than from an effect, so the
+ * first frame already branches the right way. An effect would paint one
+ * branch and correct it a frame later, which reads as a flash.
+ */
+export function useMediaQuery(query) {
+    const subscribe = useCallback((onStoreChange) => {
+        if (typeof window.matchMedia !== "function")
+            return () => { };
+        const list = window.matchMedia(query);
+        list.addEventListener("change", onStoreChange);
+        return () => list.removeEventListener("change", onStoreChange);
+    }, [query]);
+    return useSyncExternalStore(subscribe, () => evaluate(query));
+}
+//# sourceMappingURL=use-media-query.js.map

package/dist/hooks/use-media-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-media-query.js","sourceRoot":"","sources":["../../src/hooks/use-media-query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAE1D,yFAAyF;AACzF,MAAM,CAAC,MAAM,KAAK,GAAG,oBAAoB,CAAC;AAC1C,MAAM,CAAC,MAAM,KAAK,GAAG,oBAAoB,CAAC;AAE1C;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,iBAAiB,CAAC;AAE9C,yEAAyE;AACzE,SAAS,QAAQ,CAAC,KAAa;IAC7B,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,UAAU;QAAE,OAAO,IAAI,CAAC;IACzD,OAAO,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC;AAC1C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,MAAM,SAAS,GAAG,WAAW,CAC3B,CAAC,aAAyB,EAAE,EAAE;QAC5B,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,UAAU;YAAE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;QAC7D,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;QAC/C,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,mBAAmB,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;IACjE,CAAC,EACD,CAAC,KAAK,CAAC,CACR,CAAC;IACF,OAAO,oBAAoB,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;AAChE,CAAC"}

package/dist/hooks/use-overlay-scrollbars.d.ts

@@ -0,0 +1,31 @@
+import { type PartialOptions } from "overlayscrollbars";
+/**
+ * Overlay scrollbars for a scroll container that stays exactly as it is: the
+ * element `viewport` is on keeps its own classes, its own children and its own
+ * native scrolling, and the bars are drawn in `slot`, a positioned parent
+ * wrapped directly around it. Needs the `overlayscrollbars` peer, and the
+ * consumer imports `overlayscrollbars/overlayscrollbars.css` itself.
+ *
+ * Both refs are needed. Letting the library build its own viewport moves the
+ * children into an inserted div, where the container's `flex gap` no longer
+ * reaches them; leaving out the slot leaves the bars inside the scroll
+ * container, where they scroll away with the content. A slot further out than
+ * the immediate parent draws the bar over whatever else it spans.
+ *
+ * `ready` withholds the instance until the caller's content is in the DOM.
+ * `autoHideSuspend` shows the bar once on arrival — but it only arms when the
+ * element already overflows at the moment the instance is created, and a
+ * container whose content is still in flight does not. Initializing on mount
+ * costs that one reveal outright. Until then the element scrolls natively.
+ *
+ * `options` go over the defaults above. A container that must never scroll
+ * sideways passes `{ overflow: { x: "hidden" } }`: Tailwind's
+ * `overflow-y-auto` leaves x computing to `auto`. Pass a stable object — a new
+ * identity is applied with `instance.options()`, which costs an update, though
+ * never a re-initialization.
+ */
+export declare function useOverlayScrollbars(ready: boolean, options?: PartialOptions): {
+    slot: import("react").RefObject<HTMLDivElement | null>;
+    viewport: import("react").RefObject<HTMLDivElement | null>;
+};
+//# sourceMappingURL=use-overlay-scrollbars.d.ts.map

package/dist/hooks/use-overlay-scrollbars.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-overlay-scrollbars.d.ts","sourceRoot":"","sources":["../../src/hooks/use-overlay-scrollbars.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAqB3E;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,cAAc;;;EAuC5E"}

package/dist/hooks/use-overlay-scrollbars.js

@@ -0,0 +1,80 @@
+import { OverlayScrollbars } from "overlayscrollbars";
+import { useEffect, useRef } from "react";
+const DEFAULTS = {
+    theme: "os-theme-orz",
+    autoHide: "leave",
+    autoHideSuspend: true,
+    // `false`, the library's default, makes a track click do nothing at all —
+    // less than the native behaviour it replaces. Paging instead of jumping
+    // would cost a `ClickScrollPlugin` registration.
+    clickScroll: "instant",
+};
+/** One level deep, so a caller's `scrollbars` adds to the defaults rather than replacing them. */
+function merged(options) {
+    return {
+        ...options,
+        scrollbars: { ...DEFAULTS, ...options?.scrollbars },
+    };
+}
+/**
+ * Overlay scrollbars for a scroll container that stays exactly as it is: the
+ * element `viewport` is on keeps its own classes, its own children and its own
+ * native scrolling, and the bars are drawn in `slot`, a positioned parent
+ * wrapped directly around it. Needs the `overlayscrollbars` peer, and the
+ * consumer imports `overlayscrollbars/overlayscrollbars.css` itself.
+ *
+ * Both refs are needed. Letting the library build its own viewport moves the
+ * children into an inserted div, where the container's `flex gap` no longer
+ * reaches them; leaving out the slot leaves the bars inside the scroll
+ * container, where they scroll away with the content. A slot further out than
+ * the immediate parent draws the bar over whatever else it spans.
+ *
+ * `ready` withholds the instance until the caller's content is in the DOM.
+ * `autoHideSuspend` shows the bar once on arrival — but it only arms when the
+ * element already overflows at the moment the instance is created, and a
+ * container whose content is still in flight does not. Initializing on mount
+ * costs that one reveal outright. Until then the element scrolls natively.
+ *
+ * `options` go over the defaults above. A container that must never scroll
+ * sideways passes `{ overflow: { x: "hidden" } }`: Tailwind's
+ * `overflow-y-auto` leaves x computing to `auto`. Pass a stable object — a new
+ * identity is applied with `instance.options()`, which costs an update, though
+ * never a re-initialization.
+ */
+export function useOverlayScrollbars(ready, options) {
+    const slot = useRef(null);
+    const viewport = useRef(null);
+    const instance = useRef(null);
+    const latest = useRef(options);
+    latest.current = options;
+    // What the live instance was last given, so the mount does not apply the
+    // options it was just created with a second time.
+    const applied = useRef(undefined);
+    useEffect(() => {
+        const slotElement = slot.current;
+        const viewportElement = viewport.current;
+        if (!ready || slotElement === null || viewportElement === null)
+            return;
+        const created = OverlayScrollbars({
+            target: viewportElement,
+            elements: { viewport: viewportElement },
+            scrollbars: { slot: slotElement },
+        }, merged(latest.current));
+        instance.current = created;
+        applied.current = latest.current;
+        return () => {
+            instance.current = null;
+            created.destroy();
+        };
+    }, [ready]);
+    useEffect(() => {
+        if (instance.current === null || applied.current === options)
+            return;
+        applied.current = options;
+        // Pure, so a key the caller stopped passing falls back to its default
+        // instead of keeping the value it was last given.
+        instance.current.options(merged(options), true);
+    }, [options]);
+    return { slot, viewport };
+}
+//# sourceMappingURL=use-overlay-scrollbars.js.map

package/dist/hooks/use-overlay-scrollbars.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-overlay-scrollbars.js","sourceRoot":"","sources":["../../src/hooks/use-overlay-scrollbars.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAuB,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAE1C,MAAM,QAAQ,GAAG;IACf,KAAK,EAAE,cAAc;IACrB,QAAQ,EAAE,OAAO;IACjB,eAAe,EAAE,IAAI;IACrB,0EAA0E;IAC1E,wEAAwE;IACxE,iDAAiD;IACjD,WAAW,EAAE,SAAS;CACyB,CAAC;AAElD,kGAAkG;AAClG,SAAS,MAAM,CAAC,OAAmC;IACjD,OAAO;QACL,GAAG,OAAO;QACV,UAAU,EAAE,EAAE,GAAG,QAAQ,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE;KACpD,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAc,EAAE,OAAwB;IAC3E,MAAM,IAAI,GAAG,MAAM,CAAiB,IAAI,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,MAAM,CAAiB,IAAI,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,MAAM,CAA2B,IAAI,CAAC,CAAC;IACxD,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAC/B,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,yEAAyE;IACzE,kDAAkD;IAClD,MAAM,OAAO,GAAG,MAAM,CAA6B,SAAS,CAAC,CAAC;IAE9D,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC;QACjC,MAAM,eAAe,GAAG,QAAQ,CAAC,OAAO,CAAC;QACzC,IAAI,CAAC,KAAK,IAAI,WAAW,KAAK,IAAI,IAAI,eAAe,KAAK,IAAI;YAAE,OAAO;QACvE,MAAM,OAAO,GAAG,iBAAiB,CAC/B;YACE,MAAM,EAAE,eAAe;YACvB,QAAQ,EAAE,EAAE,QAAQ,EAAE,eAAe,EAAE;YACvC,UAAU,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE;SAClC,EACD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CACvB,CAAC;QACF,QAAQ,CAAC,OAAO,GAAG,OAAO,CAAC;QAC3B,OAAO,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QACjC,OAAO,GAAG,EAAE;YACV,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC;YACxB,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAEZ,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,QAAQ,CAAC,OAAO,KAAK,IAAI,IAAI,OAAO,CAAC,OAAO,KAAK,OAAO;YAAE,OAAO;QACrE,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC;QAC1B,sEAAsE;QACtE,kDAAkD;QAClD,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC;IAClD,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAEd,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAC5B,CAAC"}

package/dist/hooks/use-paged-append.d.ts

@@ -0,0 +1,7 @@
+export declare function usePagedAppend<P>(resetKey: string): {
+    pages: P[];
+    pending: boolean;
+    error: Error | null;
+    append: (load: () => Promise<P>) => void;
+};
+//# sourceMappingURL=use-paged-append.d.ts.map

package/dist/hooks/use-paged-append.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-paged-append.d.ts","sourceRoot":"","sources":["../../src/hooks/use-paged-append.ts"],"names":[],"mappings":"AAcA,wBAAgB,cAAc,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG;IACnD,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;CAC1C,CA0DA"}