cursedbelt 5.55.1 → 5.56.0

package/dist/react/hooks/longPressContextMenu.js

@@ -0,0 +1,136 @@
+/**
+ * A touch HOLD answers like a right-click: it dispatches a real `contextmenu` at the finger.
+ *
+ * Owner, 2026-10-04: *"on mobile I cannot hold control and click like I can on mac to make the
+ * menus popup, we need to make holding down on those spots pop up the menu on iphone and mobile
+ * viewers."* iOS Safari never fires `contextmenu` for a long-press, so every menu wired to it —
+ * the file tree's rows and blank space, the rail heading's view menu (show hidden folders) —
+ * was unreachable on an iPhone.
+ *
+ * 🔴 It DISPATCHES the event rather than calling a handler, so every listener already on the
+ * surface — a native one through a ref, React's `onContextMenu` on a descendant row — answers
+ * a hold exactly as it answers a right-click, and a new menu needs no touch code of its own.
+ *
+ * The rules, each one a failure it prevents:
+ *  · touch and pen only — a mouse already has a right-click;
+ *  · a finger that travels past {@link LONG_PRESS_SLOP_PX} is a scroll or a drag, not a hold;
+ *  · a browser that fires its OWN `contextmenu` for a hold (Android Chrome) keeps it — the
+ *    timer is dropped, so one hold never opens two menus; one that arrives AFTER ours fired is
+ *    swallowed for the same reason;
+ *  · the `click` the lift produces is swallowed at the window, before `useOutsidePress`'s
+ *    document listener can read it as a press outside the menu that just opened and shut it;
+ *  · `-webkit-touch-callout: none` while bound, so iOS does not put its own callout on top;
+ *  · a press inside `ignore` (a selector) is not a hold — the file tree's grip, where a finger
+ *    that stays down is about to drag.
+ */
+/*
+ * 🔴 No runtime import, React's included: a rail heading loads this module LAZILY (forge task
+ * 2791), and a chunk with dependencies drags a preload map into the chunk that imports it. The
+ * hook lives in `useLongPressContextMenu.ts`.
+ */
+/** How long a finger must stay down — iOS's own long-press duration. */
+export const LONG_PRESS_MS = 500;
+/** How far a finger may drift and still be holding still. */
+export const LONG_PRESS_SLOP_PX = 8;
+/** How long after a fired hold its lift's `click` and a late native menu are swallowed. */
+const AFTERMATH_MS = 800;
+/** Bind a hold-for-menu to `element`; returns the cleanup. */
+export function bindLongPressContextMenu(element, { delayMs = LONG_PRESS_MS, ignore } = {}) {
+    let timer;
+    let pointerId = -1;
+    let startX = 0;
+    let startY = 0;
+    let target = null;
+    /** Until when a native `contextmenu` and a `click` are the aftermath of OUR menu. */
+    let firedUntil = 0;
+    let dispatching = false;
+    const cancel = () => {
+        if (timer !== undefined)
+            clearTimeout(timer);
+        timer = undefined;
+    };
+    const swallowClick = (event) => {
+        window.removeEventListener('click', swallowClick, true);
+        if (Date.now() > firedUntil)
+            return;
+        event.preventDefault();
+        event.stopImmediatePropagation();
+    };
+    const fire = () => {
+        timer = undefined;
+        if (!(target instanceof Element) || !target.isConnected)
+            return;
+        firedUntil = Date.now() + AFTERMATH_MS;
+        window.addEventListener('click', swallowClick, true);
+        setTimeout(() => window.removeEventListener('click', swallowClick, true), AFTERMATH_MS);
+        dispatching = true;
+        try {
+            target.dispatchEvent(new MouseEvent('contextmenu', {
+                bubbles: true,
+                cancelable: true,
+                composed: true,
+                clientX: startX,
+                clientY: startY,
+                button: 2,
+            }));
+        }
+        finally {
+            dispatching = false;
+        }
+    };
+    const onDown = (event) => {
+        cancel();
+        if (event.pointerType === 'mouse' || !event.isPrimary)
+            return;
+        if (ignore && event.target instanceof Element && event.target.closest(ignore))
+            return;
+        pointerId = event.pointerId;
+        startX = event.clientX;
+        startY = event.clientY;
+        target = event.target;
+        timer = setTimeout(fire, delayMs);
+    };
+    const onMove = (event) => {
+        if (timer === undefined || event.pointerId !== pointerId)
+            return;
+        if (Math.hypot(event.clientX - startX, event.clientY - startY) > LONG_PRESS_SLOP_PX)
+            cancel();
+    };
+    const onEnd = (event) => {
+        if (event.pointerId === pointerId)
+            cancel();
+    };
+    const onNativeMenu = (event) => {
+        if (dispatching)
+            return;
+        if (timer !== undefined) {
+            cancel(); // the browser answered the hold itself — that is the one menu
+            return;
+        }
+        if (Date.now() <= firedUntil) {
+            event.preventDefault();
+            event.stopImmediatePropagation();
+        }
+    };
+    const previousCallout = element.style.getPropertyValue('-webkit-touch-callout');
+    element.style.setProperty('-webkit-touch-callout', 'none');
+    element.addEventListener('pointerdown', onDown);
+    element.addEventListener('pointermove', onMove);
+    element.addEventListener('pointerup', onEnd);
+    element.addEventListener('pointercancel', onEnd);
+    element.addEventListener('contextmenu', onNativeMenu, true);
+    return () => {
+        cancel();
+        window.removeEventListener('click', swallowClick, true);
+        element.removeEventListener('pointerdown', onDown);
+        element.removeEventListener('pointermove', onMove);
+        element.removeEventListener('pointerup', onEnd);
+        element.removeEventListener('pointercancel', onEnd);
+        element.removeEventListener('contextmenu', onNativeMenu, true);
+        if (previousCallout)
+            element.style.setProperty('-webkit-touch-callout', previousCallout);
+        else
+            element.style.removeProperty('-webkit-touch-callout');
+    };
+}
+//# sourceMappingURL=longPressContextMenu.js.map

package/dist/react/hooks/longPressContextMenu.js.map

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

package/dist/react/hooks/useLongPressContextMenu.d.ts

@@ -0,0 +1,4 @@
+import { type RefObject } from 'react';
+/** {@link bindLongPressContextMenu} on a ref's element while `enabled`. */
+export declare function useLongPressContextMenu(ref: RefObject<HTMLElement | null>, enabled?: boolean, ignore?: string): void;
+//# sourceMappingURL=useLongPressContextMenu.d.ts.map

package/dist/react/hooks/useLongPressContextMenu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLongPressContextMenu.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/useLongPressContextMenu.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAa,MAAM,OAAO,CAAC;AAGlD,2EAA2E;AAC3E,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,EAClC,OAAO,UAAO,EACd,MAAM,CAAC,EAAE,MAAM,GACd,IAAI,CAMN"}

package/dist/react/hooks/useLongPressContextMenu.js

@@ -0,0 +1,12 @@
+import { useEffect } from 'react';
+import { bindLongPressContextMenu } from './longPressContextMenu.js';
+/** {@link bindLongPressContextMenu} on a ref's element while `enabled`. */
+export function useLongPressContextMenu(ref, enabled = true, ignore) {
+    useEffect(() => {
+        const element = ref.current;
+        if (!element || !enabled)
+            return;
+        return bindLongPressContextMenu(element, ignore ? { ignore } : {});
+    }, [ref, enabled, ignore]);
+}
+//# sourceMappingURL=useLongPressContextMenu.js.map

package/dist/react/hooks/useLongPressContextMenu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLongPressContextMenu.js","sourceRoot":"","sources":["../../../src/react/hooks/useLongPressContextMenu.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,SAAS,EAAE,MAAM,OAAO,CAAC;AAClD,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAErE,2EAA2E;AAC3E,MAAM,UAAU,uBAAuB,CACrC,GAAkC,EAClC,OAAO,GAAG,IAAI,EACd,MAAe;IAEf,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO;YAAE,OAAO;QACjC,OAAO,wBAAwB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACrE,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;AAC7B,CAAC"}

package/dist/react/hooks/useScrollMemory.d.ts

@@ -27,6 +27,11 @@ import { type RefObject } from 'react';
  *   until {@link ScrollMemoryOptions.deadlineMs}. Keep the list's pages across the trip
  *   (`usePagedList` does, through the query cache) and it lands in the first frame.
  * - **The viewer always wins**: a touch, wheel, key or pointer press while it waits cancels it.
+ * - **Landed means landed.** For {@link HOLD_MS} after the restore reaches its target, a scroll
+ *   the viewer did not make is put back. 🔴 music's phone list came back from Lyrics on 12,343px
+ *   and sat at 12,496px 800ms later, about one gate run in 17 under load (forge task 2784) — a
+ *   late write by something on the page (a virtualizer settling, the browser's scroll anchoring)
+ *   that no instrumented run could catch in the act. Whatever writes it, the viewer's place wins.
  * - **A replaced URL is the same place**: when the location changes but the history entry does
  *   not (a filter written with `replaceState`), the scroll is left alone.
  *

package/dist/react/hooks/useScrollMemory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useScrollMemory.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/useScrollMemory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAA2B,MAAM,OAAO,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,IAAI,CA0BzF;AAoED,oGAAoG;AACpG,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,CAAC;AAEzG,MAAM,WAAW,mBAAmB;IAClC,mEAAmE;IACnE,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AA6CD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAIzD"}
+{"version":3,"file":"useScrollMemory.d.ts","sourceRoot":"","sources":["../../../src/react/hooks/useScrollMemory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAA2B,MAAM,OAAO,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,IAAI,CA0BzF;AAwED,oGAAoG;AACpG,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,CAAC;AAEzG,MAAM,WAAW,mBAAmB;IAClC,mEAAmE;IACnE,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAmDD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAIzD"}

package/dist/react/hooks/useScrollMemory.js

@@ -27,6 +27,11 @@ import { useLayoutEffect, useRef } from 'react';
  *   until {@link ScrollMemoryOptions.deadlineMs}. Keep the list's pages across the trip
  *   (`usePagedList` does, through the query cache) and it lands in the first frame.
  * - **The viewer always wins**: a touch, wheel, key or pointer press while it waits cancels it.
+ * - **Landed means landed.** For {@link HOLD_MS} after the restore reaches its target, a scroll
+ *   the viewer did not make is put back. 🔴 music's phone list came back from Lyrics on 12,343px
+ *   and sat at 12,496px 800ms later, about one gate run in 17 under load (forge task 2784) — a
+ *   late write by something on the page (a virtualizer settling, the browser's scroll anchoring)
+ *   that no instrumented run could catch in the act. Whatever writes it, the viewer's place wins.
  * - **A replaced URL is the same place**: when the location changes but the history entry does
  *   not (a filter written with `replaceState`), the scroll is left alone.
  *
@@ -76,13 +81,17 @@ function begin(scroller, location, last, deadlineMs) {
     // the partial offset on screen — leaving mid-restore (or StrictMode's rehearsal unmount) must
     // not overwrite a deep position with a shallow one.
     let offset = scroller.get();
-    let cancelRestore = null;
+    /** True until the restore has landed or given up — while it is, `offset` stays the target. */
+    let restoring = false;
+    /** Stops the restore, or the hold after it, reporting nothing. */
+    let stopRestore = null;
     if (!replacedInPlace) {
         const target = recalled(id);
         if (target > 0) {
             offset = target;
-            cancelRestore = restore(scroller, target, deadlineMs, (outcome) => {
-                cancelRestore = null;
+            restoring = true;
+            stopRestore = restore(scroller, target, deadlineMs, (outcome) => {
+                restoring = false;
                 if (outcome !== 'reached')
                     offset = scroller.get();
             });
@@ -93,7 +102,7 @@ function begin(scroller, location, last, deadlineMs) {
         }
     }
     const onScroll = () => {
-        if (!cancelRestore)
+        if (!restoring)
             offset = scroller.get();
     };
     const onHide = () => file(id, offset);
@@ -103,9 +112,9 @@ function begin(scroller, location, last, deadlineMs) {
         location,
         target: scroller.events,
         end() {
-            const pending = cancelRestore;
-            cancelRestore = null;
-            pending?.();
+            restoring = false;
+            stopRestore?.();
+            stopRestore = null;
             scroller.events.removeEventListener('scroll', onScroll);
             window.removeEventListener('pagehide', onHide);
             file(id, offset);
@@ -113,6 +122,12 @@ function begin(scroller, location, last, deadlineMs) {
     };
 }
 const RESTORE_DEADLINE_MS = 3_000;
+/**
+ * How long a landed restore holds its target against a scroll the viewer did not make. Long
+ * enough for a list to finish settling (the late move in forge task 2784 came inside 800ms, under
+ * load); short enough that an app's own jump a moment later is not undone.
+ */
+const HOLD_MS = 1_500;
 const ENTRY_KEY = 'cbScrollEntry';
 const STORE_KEY = 'cursedbelt:scroll-memory';
 /** Entries kept in `sessionStorage` — a tab's history, not a cache; the oldest go first. */
@@ -195,39 +210,51 @@ function file(id, y) {
         // Private mode, quota, blocked storage: memory still covers Back within this page load.
     }
 }
-/** Scroll to `target` once there is room for it; returns a cancel that reports nothing. */
+/**
+ * Scroll to `target` once there is room for it, then HOLD it for {@link HOLD_MS}; returns a
+ * cancel that reports nothing. `settled` is called once, when it lands or gives up.
+ */
 function restore(scroller, target, deadlineMs, settled) {
     const deadline = performance.now() + deadlineMs;
     let frame = 0;
-    let done = false;
-    const stop = () => {
-        if (done)
-            return false;
-        done = true;
+    let holdTimer;
+    let phase = 'waiting';
+    const finish = () => {
+        phase = 'done';
         cancelAnimationFrame(frame);
+        clearTimeout(holdTimer);
         for (const type of INPUT_EVENTS)
             window.removeEventListener(type, onInput);
-        return true;
+        scroller.events.removeEventListener('scroll', onStray);
     };
     const onInput = () => {
-        if (stop())
+        const was = phase;
+        finish();
+        if (was === 'waiting')
             settled('input');
     };
+    // Landed, and something that is not the viewer moved it: put it back.
+    const onStray = () => {
+        if (phase === 'holding' && Math.abs(scroller.get() - target) > 1)
+            scroller.set(target);
+    };
     const attempt = () => {
-        if (done)
+        if (phase !== 'waiting')
             return;
         const room = scroller.room();
         if (room >= target) {
             scroller.set(target);
-            if (stop())
-                settled('reached');
+            phase = 'holding';
+            scroller.events.addEventListener('scroll', onStray, { passive: true });
+            holdTimer = setTimeout(finish, HOLD_MS);
+            settled('reached');
             return;
         }
         // Short of it: go as far as the page allows — that is what asks an infinite list for more.
         scroller.set(Math.max(0, room));
         if (performance.now() >= deadline) {
-            if (stop())
-                settled('deadline');
+            finish();
+            settled('deadline');
         }
         else
             frame = requestAnimationFrame(attempt);
@@ -235,8 +262,6 @@ function restore(scroller, target, deadlineMs, settled) {
     for (const type of INPUT_EVENTS)
         window.addEventListener(type, onInput, { passive: true });
     attempt();
-    return () => {
-        stop();
-    };
+    return finish;
 }
 //# sourceMappingURL=useScrollMemory.js.map

package/dist/react/hooks/useScrollMemory.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "cursedbelt",
-	"version": "5.55.1",
+	"version": "5.56.0",
 	"license": "ISC",
 	"type": "module",
 	"description": "The React design system of the cursedbelt split — components, styles, theme. cursedbelt-core below it; server tier in cursedbelt-server.",

package/src/react/file-tree/FileTree.spec.tsx

@@ -38,6 +38,9 @@ const TREE: FileTreeNode[] = [
 /** `SPRING_OPEN_MS` in `FileTree.tsx` — Finder's and Explorer's own figure. */
 const SPRING = 600;
 
+/** Past `LONG_PRESS_MS` (500) — a literal, so the spec stands without the binder. */
+const HOLD = 550;
+
 const tree = (props: Partial<React.ComponentProps<typeof FileTree>> = {}) =>
   render(
     <FileTree nodes={TREE} selectedId={null} onSelect={() => undefined} {...props} />,
@@ -1149,6 +1152,22 @@ describe('the keyboard, beyond walking', () => {
     expect(opened).toEqual(['simpsons', 'simpsons/screencaps']);
   });
 
+  test('🔴 a finger HELD on a row opens its menu — iOS has no right-click', async () => {
+    // Owner, 2026-10-04: *"on mobile I cannot hold control and click like I can on mac to make
+    // the menus popup, we need to make holding down on those spots pop up the menu on iphone"*.
+    const opened: Array<{ id: string; x: number }> = [];
+    tree({ onRowMenu: (node, at) => opened.push({ id: node.id, x: at.x }) });
+    fireEvent.pointerDown(screen.getByText('Dinos'), {
+      pointerType: 'touch',
+      pointerId: 9,
+      isPrimary: true,
+      clientX: 21,
+      clientY: 4,
+    });
+    await new Promise((resolve) => setTimeout(resolve, HOLD));
+    expect(opened).toEqual([{ id: 'dinos', x: 21 }]);
+  });
+
   test('🔴 the keyboard comes back from a rename instead of landing on <body>', () => {
     // Committing unmounts the focused `<input>`, and a browser hands focus to `<body>` —
     // which is not in the tree, so every key this component defines is gone until something

package/src/react/file-tree/FileTree.tsx

@@ -197,6 +197,7 @@ import {
 import { useInView } from '../media/previewGate.js';
 import { lazyPart } from '../components/DataTable/lazyPart.js';
 import { applyFolderView, tagFilterActive } from './folderView.js';
+import { useLongPressContextMenu } from '../hooks/useLongPressContextMenu.js';
 import {
   type FileTreeMenuItem,
   FolderViewStrip,
@@ -1811,6 +1812,13 @@ export function FileTree({
 
   /** Fetch the panels once the page is idle, if this tree has any menu to open. */
   const hasMenus = wantsBlankMenu || Boolean(rowMenu);
+
+  /*
+   * A finger held on a row or on the blank space opens the same menu a right-click does —
+   * iOS has no right-click and never fires `contextmenu` for a hold (owner, 2026-10-04). The
+   * grip is excluded: a finger held there is about to drag. See `longPressContextMenu.ts`.
+   */
+  useLongPressContextMenu(scrollRef, hasMenus || Boolean(onRowMenu), '[data-cbft-grip]');
   useEffect(() => {
     if (!hasMenus) return;
     const load = () => void TreePanel.preload().catch(() => {});

package/src/react/file-tree/fileTree.css

@@ -629,6 +629,20 @@
 	white-space: nowrap;
 }
 
+/*
+ * A finger held on a row opens its menu (`longPressContextMenu.ts`), so on a touch screen the
+ * hold must not ALSO start selecting the name under it. A coarse pointer only: a mouse may
+ * still drag-select a name to copy it.
+ */
+@media (pointer: coarse) {
+	.cbft-row,
+	.cbft-name,
+	.cbft-suffix {
+		-webkit-user-select: none;
+		user-select: none;
+	}
+}
+
 /*
  * A derived extension, a step quieter than the name — see `FileTreeNode.suffix`. Quieter
  * because the name is what you scan FOR and the suffix is what you scan BY; at full

package/src/react/filter-rail/FilterRail.tsx

@@ -639,7 +639,7 @@ function SectionHeading({
 }): ReactNode {
   const ref = useHeaderContextMenu(onContextMenu);
   return (
-    <div ref={ref} className='flex items-center justify-between gap-1 px-2 pt-1 pb-1'>
+    <div ref={ref} className='flex select-none items-center justify-between gap-1 px-2 pt-1 pb-1'>
       <span className='truncate text-xs font-semibold uppercase tracking-wide text-muted-foreground'>
         {label}
       </span>

package/src/react/filter-rail/RailSection.tsx

@@ -116,7 +116,7 @@ export function RailSection({
   if (!collapsible)
     return (
       <section aria-labelledby={headingId} className={className} data-cb-rail-section='static'>
-        <div ref={headerRef} className={cn('flex items-center justify-between gap-1 px-2 pt-1 pb-1', headerClassName)}>
+        <div ref={headerRef} className={cn('flex select-none items-center justify-between gap-1 px-2 pt-1 pb-1', headerClassName)}>
           <h2 className={cn('m-0', heading)} id={headingId}>
             {label}
           </h2>
@@ -131,7 +131,7 @@ export function RailSection({
   // a sidebar would pay for its presence machinery in its first chunk.
   return (
     <section aria-labelledby={headingId} className={className} data-cb-rail-section={open ? 'open' : 'closed'}>
-      <div ref={headerRef} className={cn('flex items-center gap-1 pt-1 pb-1', headerClassName)}>
+      <div ref={headerRef} className={cn('flex select-none items-center gap-1 pt-1 pb-1', headerClassName)}>
         <h2 className='m-0 flex min-w-0 flex-1'>
           <button
             // guardrails-ignore no-raw-action-button: the section's heading IS its toggle — a

package/src/react/filter-rail/headerContextMenu.spec.tsx

@@ -9,6 +9,9 @@ import { RailSection } from './RailSection.js';
  * bar of the file tree"*). Without the prop, the browser's menu stays.
  */
 
+/** Past `LONG_PRESS_MS` (500) — a literal, so the spec stands without the binder. */
+const HOLD = 550;
+
 afterEach(cleanup);
 
 const heading = (text: string) => screen.getByText(text).closest('div') as HTMLElement;
@@ -60,3 +63,52 @@ describe('a section heading\'s right-click', () => {
     expect(fireEvent.contextMenu(heading('Files'))).toBe(true);
   });
 });
+
+describe('a section heading held by a finger', () => {
+  test('🔴 a touch held on the heading opens its menu — iOS never fires contextmenu for a hold', async () => {
+    // Owner, 2026-10-04: *"on mobile I cannot hold control and click like I can on mac to make
+    // the menus popup"*. Collections' "Files" heading is where hidden folders are shown again.
+    const seen: number[] = [];
+    render(
+      <FilterRail
+        label='Library'
+        selected={null}
+        onSelect={() => undefined}
+        sections={[
+          {
+            id: 'files',
+            label: 'Files',
+            onHeaderContextMenu: (event) => {
+              event.preventDefault();
+              seen.push(event.clientX);
+            },
+          },
+        ]}
+      />,
+    );
+    // The binder is a lazy chunk (forge task 2791) — let it land, as it does long before a hold.
+    await import('../hooks/longPressContextMenu.js');
+    await new Promise((resolve) => setTimeout(resolve, 0));
+    fireEvent.pointerDown(screen.getByText('Files'), {
+      pointerType: 'touch',
+      pointerId: 3,
+      isPrimary: true,
+      clientX: 17,
+    });
+    await new Promise((resolve) => setTimeout(resolve, HOLD));
+    expect(seen).toEqual([17]);
+  });
+});
+
+describe('the hold binder stays off the entry', () => {
+  test('🔴 headerContextMenu imports longPressContextMenu lazily, never statically', async () => {
+    // Every rail loads this hook in its app's entry; a static import put the binder on roms's
+    // entry (+0.59 kB gzip) for a menu roms never passes (forge task 2791).
+    const source = await Bun.file(new URL('./headerContextMenu.ts', import.meta.url)).text();
+    expect(source).not.toMatch(/^import[^;]*longPressContextMenu/m);
+    expect(source).toContain("import('../hooks/longPressContextMenu.js')");
+    // …and the binder imports nothing at runtime, or its chunk's preload map lands in the entry.
+    const binder = await Bun.file(new URL('../hooks/longPressContextMenu.ts', import.meta.url)).text();
+    expect(binder).not.toMatch(/^import (?!type )/m);
+  });
+});

package/src/react/filter-rail/headerContextMenu.ts

@@ -11,6 +11,15 @@
  * heading is a label, not a control, and giving it a role to hang a handler on would announce
  * it to a screen reader as something to press. The menu it opens is also reachable from the
  * tree itself (its blank space, and Shift+F10 on a row), so nothing is pointer-only.
+ *
+ * A finger HELD on the heading opens it too — iOS has no right-click (owner, 2026-10-04: *"on
+ * mobile I cannot hold control and click … make holding down on those spots pop up the menu"*).
+ * See `longPressContextMenu.ts`.
+ *
+ * 🔴 The binder is IMPORTED LAZILY, only once a heading has a menu: every app with a rail loads
+ * this hook in its entry, and most (roms's library) never pass a handler — a static import put
+ * 0.59 kB gzip on roms's entry for a menu it does not have (forge task 2791). A hold takes
+ * 500ms, so the chunk is in long before a finger could need it.
  */
 import { useEffect, useRef } from 'react';
 
@@ -31,7 +40,16 @@ export function useHeaderContextMenu(handler: HeaderContextMenuHandler | undefin
     if (!el || !wanted) return;
     const listener = (event: MouseEvent) => latest.current?.(event);
     el.addEventListener('contextmenu', listener);
-    return () => el.removeEventListener('contextmenu', listener);
+    let unbindHold: (() => void) | undefined;
+    let gone = false;
+    void import('../hooks/longPressContextMenu.js').then(({ bindLongPressContextMenu }) => {
+      if (!gone) unbindHold = bindLongPressContextMenu(el);
+    });
+    return () => {
+      gone = true;
+      el.removeEventListener('contextmenu', listener);
+      unbindHold?.();
+    };
   }, [wanted]);
   return ref;
 }