@open-press/cli 1.0.0 → 1.1.0

package/template/core/src/openpress/reader/readerPageRoute.ts

@@ -1,21 +0,0 @@
-const PAGE_HASH_PATTERN = /^#page-(\d+)$/;
-
-export function pageHashFromIndex(pageIndex: number) {
-  return `#page-${String(Math.max(1, pageIndex + 1)).padStart(2, "0")}`;
-}
-
-export function pageIndexFromHash(hash: string, pageCount: number) {
-  const match = hash.match(PAGE_HASH_PATTERN);
-  if (!match) return null;
-
-  const pageNumber = Number.parseInt(match[1], 10);
-  if (!Number.isFinite(pageNumber) || pageNumber < 1 || pageNumber > pageCount) return null;
-  return pageNumber - 1;
-}
-
-export function replacePageRoute(pageIndex: number) {
-  if (typeof window === "undefined") return;
-  const hash = pageHashFromIndex(pageIndex);
-  if (window.location.hash === hash) return;
-  window.history.replaceState(null, "", hash);
-}

package/template/core/src/openpress/reader/readerScroll.ts

@@ -1,92 +0,0 @@
-// Single place that touches scrollIntoView and IntersectionObserver. Keeping
-// these together makes it obvious which DOM APIs the reader depends on and
-// keeps the React runtime free of imperative scroll bookkeeping.
-
-const DEBOUNCE_MS = 100;
-
-const OBSERVER_THRESHOLDS = [0, 0.25, 0.5, 0.75, 1];
-
-export function scrollToPage(
-  refs: Array<HTMLElement | null>,
-  pageIndex: number,
-  behavior: ScrollBehavior = "smooth",
-  root?: HTMLElement | null,
-) {
-  const target = refs[pageIndex];
-  if (!target) return false;
-
-  if (root && root.contains(target) && typeof root.scrollTo === "function") {
-    const rootRect = root.getBoundingClientRect();
-    const targetRect = target.getBoundingClientRect();
-    const scrollMarginTop = readScrollMarginTop(target);
-    root.scrollTo({
-      top: Math.max(0, root.scrollTop + targetRect.top - rootRect.top - scrollMarginTop),
-      behavior,
-    });
-    return true;
-  }
-
-  target.scrollIntoView({ behavior, block: "start" });
-  return true;
-}
-
-function readScrollMarginTop(target: HTMLElement) {
-  if (typeof window === "undefined") return 0;
-  const value = Number.parseFloat(window.getComputedStyle(target).scrollMarginTop);
-  return Number.isFinite(value) ? value : 0;
-}
-
-export interface PageVisibilityObserver {
-  observe: (element: Element) => void;
-  disconnect: () => void;
-}
-
-export function createPageVisibilityObserver(
-  root: Element,
-  onVisiblePageChange: (pageIndex: number) => void,
-): PageVisibilityObserver | null {
-  if (typeof IntersectionObserver === "undefined") return null;
-
-  const ratios = new Map<Element, number>();
-  let debounceTimer: ReturnType<typeof setTimeout> | null = null;
-
-  const flush = () => {
-    debounceTimer = null;
-    let bestEl: Element | null = null;
-    let bestRatio = -1;
-    for (const [el, ratio] of ratios) {
-      if (ratio > bestRatio) {
-        bestRatio = ratio;
-        bestEl = el;
-      }
-    }
-    if (!bestEl || bestRatio <= 0) return;
-    const raw = bestEl.getAttribute("data-openpress-page-index");
-    if (raw === null) return;
-    const parsed = Number.parseInt(raw, 10);
-    if (Number.isFinite(parsed)) onVisiblePageChange(parsed);
-  };
-
-  const observer = new IntersectionObserver(
-    (entries) => {
-      for (const entry of entries) {
-        ratios.set(entry.target, entry.isIntersecting ? entry.intersectionRatio : 0);
-      }
-      if (debounceTimer !== null) clearTimeout(debounceTimer);
-      debounceTimer = setTimeout(flush, DEBOUNCE_MS);
-    },
-    { root, threshold: OBSERVER_THRESHOLDS },
-  );
-
-  return {
-    observe: (element) => observer.observe(element),
-    disconnect: () => {
-      observer.disconnect();
-      if (debounceTimer !== null) {
-        clearTimeout(debounceTimer);
-        debounceTimer = null;
-      }
-      ratios.clear();
-    },
-  };
-}

package/template/core/src/openpress/reader/readerStateModel.ts

@@ -1,15 +0,0 @@
-export function clampReaderPageIndex(value: number, pageCount: number) {
-  const normalizedPageCount = normalizeReaderPageCount(pageCount);
-  if (normalizedPageCount <= 0) return 0;
-  if (!Number.isFinite(value)) return 0;
-  return Math.min(Math.max(Math.trunc(value), 0), normalizedPageCount - 1);
-}
-
-export function formatReaderPageNumber(value: number) {
-  return String(Math.max(Math.trunc(value), 1)).padStart(2, "0");
-}
-
-export function normalizeReaderPageCount(value: number) {
-  if (!Number.isFinite(value)) return 0;
-  return Math.max(Math.trunc(value), 0);
-}

package/template/core/src/openpress/reader/readerTypes.ts

@@ -1,4 +0,0 @@
-import type { IndexedHtmlPage } from "../document-model";
-import type { HtmlPageBlock } from "../document-model";
-
-export type DisplayPage = IndexedHtmlPage & Pick<HtmlPageBlock, "source" | "frameKey">;

package/template/core/src/openpress/reader/usePageViewportScale.ts

@@ -1,119 +0,0 @@
-import { useLayoutEffect, useMemo, useState, type RefObject } from "react";
-import { scheduleBrowserFrame } from "../shared";
-import {
-  formatPageViewportScaleLabel,
-  formatPageViewportScaleValue,
-  resolvePageViewportScale,
-  type PageLayoutMode,
-  type PageViewportScaleMode,
-} from "./pageViewportScaleModel";
-
-export function usePageViewportScale({
-  stageRef,
-  pageContainerRef,
-  pageCount,
-  layoutMode = "single",
-}: {
-  stageRef: RefObject<HTMLElement | null>;
-  pageContainerRef: RefObject<HTMLElement | null>;
-  pageCount: number;
-  layoutMode?: PageLayoutMode;
-}) {
-  const [scaleMode, setScaleMode] = useState<PageViewportScaleMode>("fit-width");
-  const [scale, setScale] = useState(1);
-
-  useLayoutEffect(() => {
-    if (typeof window === "undefined") return undefined;
-
-    let cancelFrame: (() => void) | null = null;
-
-    const syncScale = () => {
-      cancelFrame?.();
-      cancelFrame = scheduleBrowserFrame(() => {
-        cancelFrame = null;
-        const container = pageContainerRef.current;
-        if (!container) return;
-
-        const pageSurface = container.querySelector<HTMLElement>(".openpress-html-page__html");
-        if (!pageSurface) {
-          container.style.setProperty("--openpress-page-viewport-scale", "1");
-          container.dataset.openpressPageScaleMode = scaleMode;
-          container.dataset.openpressPageScale = "1";
-          setScale(1);
-          return;
-        }
-
-        const stage = stageRef.current ?? container.parentElement;
-        const containerStyle = window.getComputedStyle(container);
-        const paddingLeft = parseCssPixelValue(containerStyle.paddingLeft);
-        const paddingRight = parseCssPixelValue(containerStyle.paddingRight);
-        const paddingTop = parseCssPixelValue(containerStyle.paddingTop);
-        const paddingBottom = parseCssPixelValue(containerStyle.paddingBottom);
-        const columnGap = parseCssPixelValue(containerStyle.columnGap || containerStyle.gap);
-        const availableWidth = Math.max(
-          1,
-          (stage?.clientWidth || container.clientWidth || window.innerWidth) - paddingLeft - paddingRight,
-        );
-        const availableHeight = Math.max(
-          1,
-          (stage?.clientHeight || container.clientHeight || window.innerHeight) - paddingTop - paddingBottom,
-        );
-        const pageWidth = pageSurface.offsetWidth;
-        const pageHeight = pageSurface.offsetHeight;
-        const canonicalWidth = layoutMode === "spread" ? (pageWidth * 2) + columnGap : pageWidth;
-        const canonicalHeight = pageHeight;
-        const fitWidthScale = canonicalWidth > 0 ? availableWidth / canonicalWidth : 1;
-        const fitPageScale = canonicalWidth > 0 && canonicalHeight > 0
-          ? Math.min(availableWidth / canonicalWidth, availableHeight / canonicalHeight)
-          : 1;
-        const nextScale = resolvePageViewportScale({ mode: scaleMode, fitWidthScale, fitPageScale });
-        const nextScaleValue = formatPageViewportScaleValue(nextScale);
-
-        container.style.setProperty("--openpress-page-viewport-scale", nextScaleValue);
-        container.dataset.openpressPageScaleMode = scaleMode;
-        container.dataset.openpressPageScale = nextScaleValue;
-        setScale((current) => (current === nextScale ? current : nextScale));
-      });
-    };
-
-    syncScale();
-
-    const ResizeObserverCtor = window.ResizeObserver;
-    const observer = ResizeObserverCtor ? new ResizeObserverCtor(syncScale) : null;
-    const stage = stageRef.current;
-    const container = pageContainerRef.current;
-    if (stage) observer?.observe(stage);
-    if (container) observer?.observe(container);
-
-    window.addEventListener("resize", syncScale);
-    window.visualViewport?.addEventListener("resize", syncScale);
-    return () => {
-      cancelFrame?.();
-      observer?.disconnect();
-      window.removeEventListener("resize", syncScale);
-      window.visualViewport?.removeEventListener("resize", syncScale);
-    };
-  }, [layoutMode, pageContainerRef, pageCount, scaleMode, stageRef]);
-
-  const scaleLabel = useMemo(
-    () => {
-      const labelScale = scaleMode.startsWith("scale-")
-        ? resolvePageViewportScale({ mode: scaleMode, fitWidthScale: scale, fitPageScale: scale })
-        : scale;
-      return formatPageViewportScaleLabel(scaleMode, labelScale);
-    },
-    [scale, scaleMode],
-  );
-
-  return {
-    scale,
-    scaleMode,
-    scaleLabel,
-    setScaleMode,
-  };
-}
-
-function parseCssPixelValue(value: string) {
-  const parsed = Number.parseFloat(value);
-  return Number.isFinite(parsed) ? parsed : 0;
-}

package/template/core/src/openpress/reader/usePanelState.ts

@@ -1,56 +0,0 @@
-import { useCallback, useEffect, useState } from "react";
-
-export interface UsePanelStateOptions {
-  leftPanelBreakpoint?: number;
-  rightPanelBreakpoint?: number;
-  onAfterResize?: () => void;
-}
-
-export interface PanelState {
-  leftPanelOpen: boolean;
-  rightPanelOpen: boolean;
-  toggleLeftPanel: () => void;
-  toggleRightPanel: () => void;
-}
-
-export function usePanelState({
-  leftPanelBreakpoint,
-  rightPanelBreakpoint = 1000,
-  onAfterResize,
-}: UsePanelStateOptions = {}): PanelState {
-  const shouldOpenLeftPanel = useCallback(
-    () =>
-      leftPanelBreakpoint === undefined || typeof window === "undefined" || window.innerWidth >= leftPanelBreakpoint,
-    [leftPanelBreakpoint],
-  );
-  const shouldOpenRightPanel = useCallback(
-    () => typeof window === "undefined" || window.innerWidth >= rightPanelBreakpoint,
-    [rightPanelBreakpoint],
-  );
-
-  const [rightPanelOpen, setRightPanelOpen] = useState(false);
-  const [leftPanelOpen, setLeftPanelOpen] = useState(false);
-
-  useEffect(() => {
-    if (typeof window === "undefined") return undefined;
-
-    const handleResize = () => {
-      setLeftPanelOpen((open) => (open && !shouldOpenLeftPanel() ? false : open));
-      setRightPanelOpen((open) => (open && !shouldOpenRightPanel() ? false : open));
-      onAfterResize?.();
-    };
-
-    handleResize();
-    window.addEventListener("resize", handleResize);
-    window.visualViewport?.addEventListener("resize", handleResize);
-    return () => {
-      window.removeEventListener("resize", handleResize);
-      window.visualViewport?.removeEventListener("resize", handleResize);
-    };
-  }, [shouldOpenLeftPanel, shouldOpenRightPanel, onAfterResize]);
-
-  const toggleLeftPanel = useCallback(() => setLeftPanelOpen((open) => !open), []);
-  const toggleRightPanel = useCallback(() => setRightPanelOpen((open) => !open), []);
-
-  return { leftPanelOpen, rightPanelOpen, toggleLeftPanel, toggleRightPanel };
-}

package/template/core/src/openpress/reader/useReaderHashSync.ts

@@ -1,61 +0,0 @@
-import { useEffect, type MutableRefObject } from "react";
-import { pageIndexFromHash, replacePageRoute } from "./readerPageRoute";
-import { scrollToPage } from "./readerScroll";
-
-export interface UseReaderHashSyncOptions {
-  stageRef: MutableRefObject<HTMLElement | null>;
-  pageRefs: MutableRefObject<Array<HTMLElement | null>>;
-  currentPageIndex: number;
-  currentPageIndexRef: MutableRefObject<number>;
-  normalizedPageCount: number;
-  setCurrentPageIndex: (index: number) => void;
-  armPendingScrollTarget: (target: number) => void;
-}
-
-export function useReaderHashSync({
-  stageRef,
-  pageRefs,
-  currentPageIndex,
-  currentPageIndexRef,
-  normalizedPageCount,
-  setCurrentPageIndex,
-  armPendingScrollTarget,
-}: UseReaderHashSyncOptions) {
-  // Mirror currentPageIndex into the URL hash so deep links + history work.
-  useEffect(() => {
-    if (typeof window === "undefined") return;
-    replacePageRoute(currentPageIndex);
-  }, [currentPageIndex]);
-
-  // Listen for hash/back/forward navigation and drive scroll to match.
-  useEffect(() => {
-    if (typeof window === "undefined") return undefined;
-
-    const syncFromHash = (behavior: ScrollBehavior) => {
-      const refs = pageRefs.current;
-      const hashPage = pageIndexFromHash(window.location.hash, normalizedPageCount);
-      if (hashPage === null) return;
-      // replacePageRoute writes the hash to mirror state; skip if it already
-      // matches so we don't fight ourselves.
-      if (hashPage === currentPageIndexRef.current) return;
-      armPendingScrollTarget(hashPage);
-      setCurrentPageIndex(hashPage);
-      scrollToPage(refs, hashPage, behavior, stageRef.current);
-    };
-
-    const onHashChange = () => syncFromHash("smooth");
-    window.addEventListener("hashchange", onHashChange);
-    window.addEventListener("popstate", onHashChange);
-    return () => {
-      window.removeEventListener("hashchange", onHashChange);
-      window.removeEventListener("popstate", onHashChange);
-    };
-  }, [
-    armPendingScrollTarget,
-    currentPageIndexRef,
-    normalizedPageCount,
-    pageRefs,
-    setCurrentPageIndex,
-    stageRef,
-  ]);
-}

package/template/core/src/openpress/reader/useReaderKeyboardNav.ts

@@ -1,48 +0,0 @@
-import { useEffect } from "react";
-
-export interface UseReaderKeyboardNavOptions {
-  nextPage: () => void;
-  prevPage: () => void;
-  setPage: (pageIndex: number) => void;
-  normalizedPageCount: number;
-}
-
-export function useReaderKeyboardNav({
-  nextPage,
-  prevPage,
-  setPage,
-  normalizedPageCount,
-}: UseReaderKeyboardNavOptions) {
-  useEffect(() => {
-    const handleKeyDown = (event: KeyboardEvent) => {
-      if (isEditableTarget(event.target)) return;
-      if (hasActiveTextSelection()) return;
-      if (event.key === "ArrowRight" || event.key === "PageDown") {
-        event.preventDefault();
-        nextPage();
-      } else if (event.key === "ArrowLeft" || event.key === "PageUp") {
-        event.preventDefault();
-        prevPage();
-      } else if (event.key === "Home") {
-        event.preventDefault();
-        setPage(0);
-      } else if (event.key === "End") {
-        event.preventDefault();
-        setPage(Math.max(0, normalizedPageCount - 1));
-      }
-    };
-    window.addEventListener("keydown", handleKeyDown);
-    return () => window.removeEventListener("keydown", handleKeyDown);
-  }, [nextPage, prevPage, setPage, normalizedPageCount]);
-}
-
-function isEditableTarget(target: EventTarget | null) {
-  if (!(target instanceof HTMLElement)) return false;
-  return Boolean(target.closest("input, textarea, select, button, [contenteditable]"));
-}
-
-function hasActiveTextSelection() {
-  const selection = window.getSelection?.();
-  if (!selection || selection.isCollapsed) return false;
-  return Boolean(selection.toString().trim());
-}

package/template/core/src/openpress/reader/useReaderRuntime.ts

@@ -1,146 +0,0 @@
-import { useCallback, useEffect, useMemo, useRef, useState, type RefCallback } from "react";
-import { pageIndexFromHash } from "./readerPageRoute";
-import { createReaderPageRegistry } from "./readerPageRegistry";
-import { clampReaderPageIndex, formatReaderPageNumber, normalizeReaderPageCount } from "./readerStateModel";
-import { createPageVisibilityObserver, scrollToPage } from "./readerScroll";
-import { usePanelState } from "./usePanelState";
-import { useReaderScrollAnchor } from "./useReaderScrollAnchor";
-import { useReaderHashSync } from "./useReaderHashSync";
-import { useReaderKeyboardNav } from "./useReaderKeyboardNav";
-
-export interface SetPageOptions {
-  behavior?: ScrollBehavior;
-}
-
-interface UseReaderRuntimeOptions {
-  pageCount: number;
-  leftPanelBreakpoint?: number;
-  rightPanelBreakpoint?: number;
-}
-
-export function useReaderRuntime({
-  pageCount,
-  leftPanelBreakpoint,
-  rightPanelBreakpoint = 1000,
-}: UseReaderRuntimeOptions) {
-  const normalizedPageCount = normalizeReaderPageCount(pageCount);
-  const stageRef = useRef<HTMLElement | null>(null);
-  const [pageRegistrationVersion, setPageRegistrationVersion] = useState(0);
-  const pageRegistry = useRef<ReturnType<typeof createReaderPageRegistry<HTMLElement>> | null>(null);
-  if (!pageRegistry.current) {
-    pageRegistry.current = createReaderPageRegistry<HTMLElement>(setPageRegistrationVersion);
-  }
-  const pageRefs = useMemo(() => ({
-    get current() {
-      return pageRegistry.current?.refs ?? [];
-    },
-  }), []) as { current: Array<HTMLElement | null> };
-
-  const [currentPageIndex, setCurrentPageIndex] = useState(() => {
-    if (typeof window === "undefined") return 0;
-    const fromHash = pageIndexFromHash(window.location.hash, normalizedPageCount);
-    return fromHash ?? 0;
-  });
-
-  const currentPageIndexRef = useRef(currentPageIndex);
-  currentPageIndexRef.current = currentPageIndex;
-
-  const { pendingScrollTargetRef, armPendingScrollTarget, clearPendingScrollTarget, reAnchorAfterPaint } =
-    useReaderScrollAnchor({ stageRef, pageRefs, currentPageIndexRef });
-
-  const { leftPanelOpen, rightPanelOpen, toggleLeftPanel, toggleRightPanel } = usePanelState({
-    leftPanelBreakpoint,
-    rightPanelBreakpoint,
-    // scroll-snap-type: y mandatory re-aligns to the closest snap point on
-    // viewport change, which can land one page off from where the reader was.
-    onAfterResize: reAnchorAfterPaint,
-  });
-
-  // Trim the registry + clamp current page when the page count shrinks.
-  useEffect(() => {
-    pageRegistry.current?.trim(normalizedPageCount);
-    setCurrentPageIndex((idx) => clampReaderPageIndex(idx, normalizedPageCount));
-  }, [normalizedPageCount]);
-
-  // Drive currentPageIndex from visible pages. Suppress intermediates while a
-  // programmatic scroll is in flight.
-  useEffect(() => {
-    const stage = stageRef.current;
-    if (!stage) return undefined;
-    const observer = createPageVisibilityObserver(stage, (pageIndex) => {
-      if (pendingScrollTargetRef.current !== null) {
-        if (pageIndex !== pendingScrollTargetRef.current) return;
-        clearPendingScrollTarget();
-      }
-      setCurrentPageIndex((prev) => (prev === pageIndex ? prev : pageIndex));
-    });
-    if (!observer) return undefined;
-    pageRegistry.current?.refs.forEach((el) => el && observer.observe(el));
-    return () => observer.disconnect();
-  }, [clearPendingScrollTarget, normalizedPageCount, pageRegistrationVersion, pendingScrollTargetRef]);
-
-  // When refs change (initial mount, pagination kicks in), re-anchor the stage
-  // to the page we already believe we're on so scroll-snap mandatory doesn't
-  // pull us to whichever page is closest.
-  useEffect(() => {
-    const refs = pageRegistry.current?.refs ?? [];
-    const idx = currentPageIndexRef.current;
-    if (idx === 0) return;
-    if (!refs[idx]) return;
-    armPendingScrollTarget(idx);
-    scrollToPage(refs, idx, "instant", stageRef.current);
-  }, [armPendingScrollTarget, pageRegistrationVersion]);
-
-  const setPage = useCallback(
-    (pageIndex: number, options: SetPageOptions = {}) => {
-      const refs = pageRegistry.current?.refs ?? [];
-      const target = clampReaderPageIndex(pageIndex, normalizedPageCount);
-      armPendingScrollTarget(target);
-      setCurrentPageIndex(target);
-      scrollToPage(refs, target, options.behavior ?? "smooth", stageRef.current);
-    },
-    [armPendingScrollTarget, normalizedPageCount],
-  );
-
-  const nextPage = useCallback(() => {
-    setPage(currentPageIndexRef.current + 1);
-  }, [setPage]);
-
-  const prevPage = useCallback(() => {
-    setPage(currentPageIndexRef.current - 1);
-  }, [setPage]);
-
-  useReaderHashSync({
-    stageRef,
-    pageRefs,
-    currentPageIndex,
-    currentPageIndexRef,
-    normalizedPageCount,
-    setCurrentPageIndex,
-    armPendingScrollTarget,
-  });
-
-  useReaderKeyboardNav({ nextPage, prevPage, setPage, normalizedPageCount });
-
-  const registerPage = useCallback<(pageIndex: number) => RefCallback<HTMLElement>>(
-    (pageIndex) => pageRegistry.current?.registerPage(pageIndex) ?? (() => undefined),
-    [],
-  );
-
-  const progressPercent =
-    normalizedPageCount <= 1 ? 100 : ((currentPageIndex + 1) / normalizedPageCount) * 100;
-
-  return {
-    stageRef,
-    currentPageIndex,
-    currentPageLabel: formatReaderPageNumber(currentPageIndex + 1),
-    totalPageLabel: formatReaderPageNumber(normalizedPageCount),
-    progressPercent,
-    leftPanelOpen,
-    rightPanelOpen,
-    registerPage,
-    setPage,
-    toggleLeftPanel,
-    toggleRightPanel,
-  };
-}

package/template/core/src/openpress/reader/useReaderScrollAnchor.ts

@@ -1,64 +0,0 @@
-import { useCallback, useEffect, useRef, type MutableRefObject } from "react";
-import { scrollToPage } from "./readerScroll";
-
-// Generous upper bound on a smooth scrollIntoView. If the target ref is gone or
-// the browser never settles on it, clear the guard so the IO observer regains
-// authority over currentPageIndex.
-const PROGRAMMATIC_SCROLL_FALLBACK_MS = 2500;
-
-export interface UseReaderScrollAnchorOptions {
-  stageRef: MutableRefObject<HTMLElement | null>;
-  pageRefs: MutableRefObject<Array<HTMLElement | null>>;
-  currentPageIndexRef: MutableRefObject<number>;
-}
-
-export interface ReaderScrollAnchor {
-  pendingScrollTargetRef: MutableRefObject<number | null>;
-  armPendingScrollTarget: (target: number) => void;
-  clearPendingScrollTarget: () => void;
-  reAnchorAfterPaint: () => void;
-}
-
-export function useReaderScrollAnchor({
-  stageRef,
-  pageRefs,
-  currentPageIndexRef,
-}: UseReaderScrollAnchorOptions): ReaderScrollAnchor {
-  // While a programmatic scroll is in flight, the IntersectionObserver should
-  // only accept the destination page (not the intermediates we sweep past).
-  const pendingScrollTargetRef = useRef<number | null>(null);
-  const pendingScrollClearTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);
-
-  const armPendingScrollTarget = useCallback((target: number) => {
-    pendingScrollTargetRef.current = target;
-    if (pendingScrollClearTimerRef.current !== null) clearTimeout(pendingScrollClearTimerRef.current);
-    pendingScrollClearTimerRef.current = setTimeout(() => {
-      pendingScrollTargetRef.current = null;
-      pendingScrollClearTimerRef.current = null;
-    }, PROGRAMMATIC_SCROLL_FALLBACK_MS);
-  }, []);
-
-  const clearPendingScrollTarget = useCallback(() => {
-    pendingScrollTargetRef.current = null;
-    if (pendingScrollClearTimerRef.current !== null) {
-      clearTimeout(pendingScrollClearTimerRef.current);
-      pendingScrollClearTimerRef.current = null;
-    }
-  }, []);
-
-  useEffect(() => () => clearPendingScrollTarget(), [clearPendingScrollTarget]);
-
-  // Re-anchor the stage to the page we already believe we're on. scroll-snap
-  // mandatory would otherwise snap to whichever page is closest after a layout
-  // change. Pin to the active programmatic target if there is one.
-  const reAnchorAfterPaint = useCallback(() => {
-    if (typeof window === "undefined") return;
-    window.requestAnimationFrame(() => {
-      const refs = pageRefs.current;
-      const target = pendingScrollTargetRef.current ?? currentPageIndexRef.current;
-      scrollToPage(refs, target, "instant", stageRef.current);
-    });
-  }, [currentPageIndexRef, pageRefs, stageRef]);
-
-  return { pendingScrollTargetRef, armPendingScrollTarget, clearPendingScrollTarget, reAnchorAfterPaint };
-}