react-native-agenda-kit 0.1.0

package/lib/module/agenda/StickyHeaderOverlay.js

@@ -0,0 +1,120 @@
+"use strict";
+
+/**
+ * The stuck section header: fixed copies drawn over the list.
+ *
+ * A header INSIDE the ScrollView that sticks by translating itself lags the
+ * content by one frame, because the translate comes from a scroll event (M1c:
+ * 10–25 dp of drift mid-momentum). A copy outside the ScrollView does not scroll,
+ * so it cannot drift; only the ~32 px push-up at a section boundary is event-driven.
+ *
+ * Copies of the current section and two neighbours each side stay mounted; the UI
+ * thread picks the one that shows, so a crossing is covered the frame it happens
+ * and React only re-centres the five, at reading speed. While fast every copy hides
+ * and the in-list headers scroll past natively — nobody reads a date at that speed,
+ * and following it would cost a commit per crossing.
+ *
+ * Touches: hidden copies are translated off the host (they take none); the shown
+ * copy is `box-none`, so its buttons work and a drag anywhere else reaches the list.
+ */
+
+import { memo, useMemo, useState } from 'react';
+import { StyleSheet } from 'react-native';
+import Animated, { useAnimatedReaction, useAnimatedStyle } from 'react-native-reanimated';
+import { runOnJS } from 'react-native-worklets';
+import { jsx as _jsx } from "react/jsx-runtime";
+const NEIGHBOURS = 2;
+// Scalar-only constants, returned by reference. Never a `transform` in a shared
+// constant: Reanimated's `updateProps` processes transforms in place, and worklets
+// freeze captured objects in DEV. `top` changes only at a section crossing.
+const COPY_SHOWN = {
+  opacity: 1,
+  top: 0
+};
+const COPY_HIDDEN = {
+  opacity: 0,
+  top: -4096
+};
+const OverlayCopy = /*#__PURE__*/memo(({
+  sectionIndex,
+  title,
+  height,
+  sticky,
+  renderSectionHeader
+}) => {
+  const shown = useAnimatedStyle(() => sticky.fast.value === 0 && sticky.currentSection.value === sectionIndex ? COPY_SHOWN : COPY_HIDDEN);
+  const style = useMemo(() => [styles.copy, {
+    height
+  }, shown], [height, shown]);
+  return /*#__PURE__*/_jsx(Animated.View, {
+    collapsable: false,
+    pointerEvents: "box-none",
+    style: style,
+    children: renderSectionHeader(title)
+  });
+});
+OverlayCopy.displayName = 'StickyHeaderOverlayCopy';
+const StickyHeaderOverlayInner = ({
+  initialSection,
+  sectionCount,
+  titleAt,
+  height,
+  sticky,
+  renderSectionHeader
+}) => {
+  const [centre, setCentre] = useState(initialSection);
+  useAnimatedReaction(() => sticky.fast.value === 1 ? -1 : sticky.currentSection.value, (s, prev) => {
+    if (s >= 0 && s !== prev) runOnJS(setCentre)(s);
+  });
+
+  // The push-up: the next section's header shoves the stuck one out of the top.
+  const pushUp = useAnimatedStyle(() => {
+    const next = sticky.tablesSV.value.sectionOffset[sticky.currentSection.value + 1];
+    const t = next === undefined ? 0 : next - sticky.scrollY.value - height;
+    return {
+      transform: [{
+        translateY: t < 0 ? t : 0
+      }]
+    };
+  });
+  const hostStyle = useMemo(() => [styles.host, {
+    height
+  }, pushUp], [height, pushUp]);
+  const copies = [];
+  const last = Math.min(sectionCount - 1, centre + NEIGHBOURS);
+  for (let s = Math.max(0, centre - NEIGHBOURS); s <= last; s += 1) {
+    const title = titleAt(s);
+    if (title === undefined) continue;
+    copies.push(/*#__PURE__*/_jsx(OverlayCopy, {
+      sectionIndex: s,
+      title: title,
+      height: height,
+      sticky: sticky,
+      renderSectionHeader: renderSectionHeader
+    }, title));
+  }
+  return /*#__PURE__*/_jsx(Animated.View, {
+    pointerEvents: "box-none",
+    style: hostStyle,
+    children: copies
+  });
+};
+export const StickyHeaderOverlay = /*#__PURE__*/memo(StickyHeaderOverlayInner);
+StickyHeaderOverlay.displayName = 'StickyHeaderOverlay';
+const styles = StyleSheet.create({
+  host: {
+    position: 'absolute',
+    top: 0,
+    left: 0,
+    right: 0,
+    overflow: 'hidden'
+  },
+  copy: {
+    position: 'absolute',
+    top: 0,
+    left: 0,
+    right: 0,
+    overflow: 'hidden'
+  }
+});
+//# sourceMappingURL=StickyHeaderOverlay.js.map

package/lib/module/agenda/StickyHeaderOverlay.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["memo","useMemo","useState","StyleSheet","Animated","useAnimatedReaction","useAnimatedStyle","runOnJS","jsx","_jsx","NEIGHBOURS","COPY_SHOWN","opacity","top","COPY_HIDDEN","OverlayCopy","sectionIndex","title","height","sticky","renderSectionHeader","shown","fast","value","currentSection","style","styles","copy","View","collapsable","pointerEvents","children","displayName","StickyHeaderOverlayInner","initialSection","sectionCount","titleAt","centre","setCentre","s","prev","pushUp","next","tablesSV","sectionOffset","t","undefined","scrollY","transform","translateY","hostStyle","host","copies","last","Math","min","max","push","StickyHeaderOverlay","create","position","left","right","overflow"],"sourceRoot":"../../../src","sources":["agenda/StickyHeaderOverlay.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/agenda/buildAgendaLayout.js

@@ -0,0 +1,95 @@
+"use strict";
+
+/**
+ * Sections → a flat row list with declared heights and prefix-sum offsets.
+ *
+ * PURE: the one place the agenda's geometry is decided (rule 3 — layout is
+ * declared, never measured). `offsets` has n+1 entries, so a row's height is
+ * `offsets[i+1] − offsets[i]` and the last entry is the content height.
+ *
+ * Offsets land on whole DEVICE pixels: the running sum stays exact, each row's top
+ * and bottom are that sum rounded, and its height is their difference. A slot's
+ * bottom is then exactly the next slot's top. Fractional offsets let Android round
+ * each edge on its own and open 1 px seams that showed the backdrop behind the list
+ * as grey hairlines (2026-09-11). No row moves by half a pixel or more.
+ */
+
+import { PixelRatio } from 'react-native';
+import { monthOrdinalOfYmd } from "../core/civil.js";
+export const buildAgendaLayout = ({
+  sections,
+  sectionHeaderHeight,
+  heightForType,
+  getItemType,
+  keyExtractor,
+  headerIntern
+}) => {
+  const rows = [];
+  const heights = [];
+  const offsets = [];
+  const sectionStart = new Array(sections.length);
+  const sectionOffset = new Array(sections.length + 1);
+  const monthOfSection = new Array(sections.length);
+  const sectionByTitle = new Map();
+  const ratio = PixelRatio.get();
+  const snap = v => Math.round(v * ratio) / ratio;
+  /** The unrounded running sum; `y` is its snapped value, the next row's top. */
+  let exact = 0;
+  let y = 0;
+  for (let s = 0; s < sections.length; s += 1) {
+    const {
+      title,
+      data
+    } = sections[s];
+    let header = headerIntern.get(title);
+    // The index is part of the identity: a window shifted by a day must not reuse
+    // a header that points at another section's bounds.
+    if (!header || header.section !== s) {
+      header = {
+        kind: 'header',
+        section: s,
+        title,
+        key: `h:${title}`
+      };
+      headerIntern.set(title, header);
+    }
+    sectionStart[s] = rows.length;
+    sectionOffset[s] = y;
+    monthOfSection[s] = monthOrdinalOfYmd(title);
+    sectionByTitle.set(title, s);
+    rows.push(header);
+    offsets.push(y);
+    exact += sectionHeaderHeight;
+    let bottom = snap(exact);
+    heights.push(bottom - y);
+    y = bottom;
+    for (let i = 0; i < data.length; i += 1) {
+      const item = data[i];
+      rows.push({
+        kind: 'item',
+        section: s,
+        indexInSection: i,
+        item,
+        key: keyExtractor(item, i)
+      });
+      offsets.push(y);
+      exact += heightForType(getItemType(item));
+      bottom = snap(exact);
+      heights.push(bottom - y);
+      y = bottom;
+    }
+  }
+  sectionOffset[sections.length] = y;
+  offsets.push(y);
+  return {
+    rows,
+    heights,
+    offsets,
+    sectionStart,
+    sectionOffset,
+    monthOfSection,
+    sectionByTitle,
+    totalHeight: y
+  };
+};
+//# sourceMappingURL=buildAgendaLayout.js.map

package/lib/module/agenda/buildAgendaLayout.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["PixelRatio","monthOrdinalOfYmd","buildAgendaLayout","sections","sectionHeaderHeight","heightForType","getItemType","keyExtractor","headerIntern","rows","heights","offsets","sectionStart","Array","length","sectionOffset","monthOfSection","sectionByTitle","Map","ratio","get","snap","v","Math","round","exact","y","s","title","data","header","section","kind","key","set","push","bottom","i","item","indexInSection","totalHeight"],"sourceRoot":"../../../src","sources":["agenda/buildAgendaLayout.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,UAAU,QAAQ,cAAc;AACzC,SAASC,iBAAiB,QAAQ,kBAAe;AAoCjD,OAAO,MAAMC,iBAAiB,GAAGA,CAAI;EACnCC,QAAQ;EACRC,mBAAmB;EACnBC,aAAa;EACbC,WAAW;EACXC,YAAY;EACZC;AAC0B,CAAC,KAAsB;EACjD,MAAMC,IAAuB,GAAG,EAAE;EAClC,MAAMC,OAAiB,GAAG,EAAE;EAC5B,MAAMC,OAAiB,GAAG,EAAE;EAC5B,MAAMC,YAAY,GAAG,IAAIC,KAAK,CAASV,QAAQ,CAACW,MAAM,CAAC;EACvD,MAAMC,aAAa,GAAG,IAAIF,KAAK,CAASV,QAAQ,CAACW,MAAM,GAAG,CAAC,CAAC;EAC5D,MAAME,cAAc,GAAG,IAAIH,KAAK,CAASV,QAAQ,CAACW,MAAM,CAAC;EACzD,MAAMG,cAAc,GAAG,IAAIC,GAAG,CAAqB,CAAC;EAEpD,MAAMC,KAAK,GAAGnB,UAAU,CAACoB,GAAG,CAAC,CAAC;EAC9B,MAAMC,IAAI,GAAIC,CAAS,IAAKC,IAAI,CAACC,KAAK,CAACF,CAAC,GAAGH,KAAK,CAAC,GAAGA,KAAK;EACzD;EACA,IAAIM,KAAK,GAAG,CAAC;EACb,IAAIC,CAAC,GAAG,CAAC;EACT,KAAK,IAAIC,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAGxB,QAAQ,CAACW,MAAM,EAAEa,CAAC,IAAI,CAAC,EAAE;IAC3C,MAAM;MAAEC,KAAK;MAAEC;IAAK,CAAC,GAAG1B,QAAQ,CAACwB,CAAC,CAAC;IAEnC,IAAIG,MAAM,GAAGtB,YAAY,CAACY,GAAG,CAACQ,KAAK,CAAC;IACpC;IACA;IACA,IAAI,CAACE,MAAM,IAAIA,MAAM,CAACC,OAAO,KAAKJ,CAAC,EAAE;MACnCG,MAAM,GAAG;QAAEE,IAAI,EAAE,QAAQ;QAAED,OAAO,EAAEJ,CAAC;QAAEC,KAAK;QAAEK,GAAG,EAAE,KAAKL,KAAK;MAAG,CAAC;MACjEpB,YAAY,CAAC0B,GAAG,CAACN,KAAK,EAAEE,MAAM,CAAC;IACjC;IAEAlB,YAAY,CAACe,CAAC,CAAC,GAAGlB,IAAI,CAACK,MAAM;IAC7BC,aAAa,CAACY,CAAC,CAAC,GAAGD,CAAC;IACpBV,cAAc,CAACW,CAAC,CAAC,GAAG1B,iBAAiB,CAAC2B,KAAK,CAAC;IAC5CX,cAAc,CAACiB,GAAG,CAACN,KAAK,EAAED,CAAC,CAAC;IAE5BlB,IAAI,CAAC0B,IAAI,CAACL,MAAM,CAAC;IACjBnB,OAAO,CAACwB,IAAI,CAACT,CAAC,CAAC;IACfD,KAAK,IAAIrB,mBAAmB;IAC5B,IAAIgC,MAAM,GAAGf,IAAI,CAACI,KAAK,CAAC;IACxBf,OAAO,CAACyB,IAAI,CAACC,MAAM,GAAGV,CAAC,CAAC;IACxBA,CAAC,GAAGU,MAAM;IAEV,KAAK,IAAIC,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAGR,IAAI,CAACf,MAAM,EAAEuB,CAAC,IAAI,CAAC,EAAE;MACvC,MAAMC,IAAI,GAAGT,IAAI,CAACQ,CAAC,CAAC;MACpB5B,IAAI,CAAC0B,IAAI,CAAC;QAAEH,IAAI,EAAE,MAAM;QAAED,OAAO,EAAEJ,CAAC;QAAEY,cAAc,EAAEF,CAAC;QAAEC,IAAI;QAAEL,GAAG,EAAE1B,YAAY,CAAC+B,IAAI,EAAED,CAAC;MAAE,CAAC,CAAC;MAC5F1B,OAAO,CAACwB,IAAI,CAACT,CAAC,CAAC;MACfD,KAAK,IAAIpB,aAAa,CAACC,WAAW,CAACgC,IAAI,CAAC,CAAC;MACzCF,MAAM,GAAGf,IAAI,CAACI,KAAK,CAAC;MACpBf,OAAO,CAACyB,IAAI,CAACC,MAAM,GAAGV,CAAC,CAAC;MACxBA,CAAC,GAAGU,MAAM;IACZ;EACF;EACArB,aAAa,CAACZ,QAAQ,CAACW,MAAM,CAAC,GAAGY,CAAC;EAClCf,OAAO,CAACwB,IAAI,CAACT,CAAC,CAAC;EAEf,OAAO;IAAEjB,IAAI;IAAEC,OAAO;IAAEC,OAAO;IAAEC,YAAY;IAAEG,aAAa;IAAEC,cAAc;IAAEC,cAAc;IAAEuB,WAAW,EAAEd;EAAE,CAAC;AAChH,CAAC","ignoreList":[]}

package/lib/module/agenda/constants.js

@@ -0,0 +1,25 @@
+"use strict";
+
+/** Upper bound on mounted rows: a ceiling for the fastest fling. */
+export const MAX_WINDOW_ROWS = 128;
+
+/** Rows per window bucket, powers of two (bucketing is a mask). 32 while fast: ~25 → ~3 commits per fling (M1a). */
+export const BUCKET_REST = 8;
+export const BUCKET_FAST = 32;
+
+/**
+ * The rest window, in viewport heights ahead of and behind the viewport (was 1.5 / 1).
+ * Every mounted row costs frame time on screen or not, so rest stays tight and flings
+ * widen by velocity. Measured with `removeClippedSubviews` in release on the SM-F415F
+ * (2026-09-11): the pair took fling p95 57 → 48 ms; the small window alone gained nothing.
+ */
+export const REST_REACH_H = 0.5;
+export const REST_TRAIL_H = 0.25;
+
+/** px/ms. Above FAST_ENTER entering rows are deferred to the backdrop; below FAST_EXIT they upgrade. */
+export const FAST_ENTER = 4;
+export const FAST_EXIT = 1.5;
+
+/** Deferred rows made real per frame, after the visible ones. */
+export const UPGRADE_BATCH = 8;
+//# sourceMappingURL=constants.js.map

package/lib/module/agenda/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["MAX_WINDOW_ROWS","BUCKET_REST","BUCKET_FAST","REST_REACH_H","REST_TRAIL_H","FAST_ENTER","FAST_EXIT","UPGRADE_BATCH"],"sourceRoot":"../../../src","sources":["agenda/constants.ts"],"mappings":";;AAAA;AACA,OAAO,MAAMA,eAAe,GAAG,GAAG;;AAElC;AACA,OAAO,MAAMC,WAAW,GAAG,CAAC;AAC5B,OAAO,MAAMC,WAAW,GAAG,EAAE;;AAE7B;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,YAAY,GAAG,GAAG;AAC/B,OAAO,MAAMC,YAAY,GAAG,IAAI;;AAEhC;AACA,OAAO,MAAMC,UAAU,GAAG,CAAC;AAC3B,OAAO,MAAMC,SAAS,GAAG,GAAG;;AAE5B;AACA,OAAO,MAAMC,aAAa,GAAG,CAAC","ignoreList":[]}

package/lib/module/agenda/heights.js

@@ -0,0 +1,42 @@
+"use strict";
+
+/**
+ * DEV height-drift check — the honesty test on "layout is declared, not measured".
+ *
+ * Every slot clips (`overflow: 'hidden'`), so a row taller than its table entry
+ * loses its bottom pixels silently. While a listener is installed
+ * (`onHeightDrift`, e.g. a temporary DEV overlay), each row type measures once and reports the delta.
+ * With no listener nothing measures: no wrapper view, no `onLayout`, in any build.
+ */
+
+const declaredByType = new Map();
+let listener = null;
+
+/** Install (or with `null`, remove) the one drift listener. Installing re-samples. */
+export const onHeightDrift = fn => {
+  if (!__DEV__) return;
+  listener = fn;
+  declaredByType.clear();
+};
+
+/** True while this row type still needs a sample at its current declaration. */
+export const needsMeasure = (type, declared) => {
+  if (!__DEV__ || listener === null) return false;
+  const seen = declaredByType.get(type);
+  return seen === undefined || Math.abs(seen - declared) >= 0.01;
+};
+export const reportHeight = (type, declared, measured) => {
+  if (!__DEV__ || listener === null || !needsMeasure(type, declared)) return;
+  declaredByType.set(type, declared);
+  const delta = measured - declared;
+  if (Math.abs(delta) > 1) {
+    console.warn(`[agenda-kit] height drift ${type}: declared ${declared.toFixed(2)} measured ${measured.toFixed(2)}`);
+  }
+  listener({
+    type,
+    declared,
+    measured,
+    delta
+  });
+};
+//# sourceMappingURL=heights.js.map

package/lib/module/agenda/heights.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["declaredByType","Map","listener","onHeightDrift","fn","__DEV__","clear","needsMeasure","type","declared","seen","get","undefined","Math","abs","reportHeight","measured","set","delta","console","warn","toFixed"],"sourceRoot":"../../../src","sources":["agenda/heights.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AASA,MAAMA,cAAc,GAAG,IAAIC,GAAG,CAAiB,CAAC;AAChD,IAAIC,QAA+C,GAAG,IAAI;;AAE1D;AACA,OAAO,MAAMC,aAAa,GAAIC,EAAyC,IAAW;EAChF,IAAI,CAACC,OAAO,EAAE;EACdH,QAAQ,GAAGE,EAAE;EACbJ,cAAc,CAACM,KAAK,CAAC,CAAC;AACxB,CAAC;;AAED;AACA,OAAO,MAAMC,YAAY,GAAGA,CAACC,IAAY,EAAEC,QAAgB,KAAc;EACvE,IAAI,CAACJ,OAAO,IAAIH,QAAQ,KAAK,IAAI,EAAE,OAAO,KAAK;EAC/C,MAAMQ,IAAI,GAAGV,cAAc,CAACW,GAAG,CAACH,IAAI,CAAC;EACrC,OAAOE,IAAI,KAAKE,SAAS,IAAIC,IAAI,CAACC,GAAG,CAACJ,IAAI,GAAGD,QAAQ,CAAC,IAAI,IAAI;AAChE,CAAC;AAED,OAAO,MAAMM,YAAY,GAAGA,CAACP,IAAY,EAAEC,QAAgB,EAAEO,QAAgB,KAAW;EACtF,IAAI,CAACX,OAAO,IAAIH,QAAQ,KAAK,IAAI,IAAI,CAACK,YAAY,CAACC,IAAI,EAAEC,QAAQ,CAAC,EAAE;EACpET,cAAc,CAACiB,GAAG,CAACT,IAAI,EAAEC,QAAQ,CAAC;EAClC,MAAMS,KAAK,GAAGF,QAAQ,GAAGP,QAAQ;EACjC,IAAII,IAAI,CAACC,GAAG,CAACI,KAAK,CAAC,GAAG,CAAC,EAAE;IACvBC,OAAO,CAACC,IAAI,CACV,6BAA6BZ,IAAI,cAAcC,QAAQ,CAACY,OAAO,CAAC,CAAC,CAAC,aAAaL,QAAQ,CAACK,OAAO,CAAC,CAAC,CAAC,EACpG,CAAC;EACH;EACAnB,QAAQ,CAAC;IAAEM,IAAI;IAAEC,QAAQ;IAAEO,QAAQ;IAAEE;EAAM,CAAC,CAAC;AAC/C,CAAC","ignoreList":[]}

package/lib/module/agenda/useAgendaScrollSync.js

@@ -0,0 +1,200 @@
+"use strict";
+
+/**
+ * The agenda's scroll handler — everything per frame runs here, on the UI thread.
+ *
+ *   1. Derive the date: `dayIndex` is the day whose header holds most of the
+ *      header slot, written whenever no animated programmatic scroll is travelling.
+ *   2. Move the window: pixel overscan that grows with velocity, bucketed so a
+ *      bucket edge is crossed a few times per fling, not every frame.
+ *   3. Tell React rarely: per month crossing while moving, at settle, and once
+ *      if the day under the header changes after settle.
+ */
+
+import { useCallback } from 'react';
+import { useAnimatedScrollHandler, useSharedValue } from 'react-native-reanimated';
+import { runOnJS } from 'react-native-worklets';
+import { bsearchLE, clampNum } from "../core/worklets.js";
+import { BUCKET_FAST, BUCKET_REST, FAST_ENTER, FAST_EXIT, MAX_WINDOW_ROWS, REST_REACH_H, REST_TRAIL_H } from "./constants.js";
+
+/** The layout's lookup tables, mirrored to the UI thread in one write per rebuild. */
+
+export const useAgendaScrollSync = ({
+  tablesSV,
+  viewportSV,
+  headerHeight,
+  dayIndex,
+  listDragSeq,
+  onWindowChange,
+  onCommitDate,
+  onFastChange,
+  onDragBegin,
+  onSettle
+}) => {
+  const scrollY = useSharedValue(0);
+  /** A decaying peak: Android reports velocity 0 on about every other event mid-fling. */
+  const velocity = useSharedValue(0);
+  /** Section whose header is at or above the top edge — the stuck header. */
+  const currentSection = useSharedValue(0);
+  /** 1 from drag or momentum begin to settle. The only thing that widens the overscan. */
+  const moving = useSharedValue(0);
+  /** 1 while too fast to read; rows entering the window are deferred. Hysteresis on enter/exit. */
+  const fast = useSharedValue(0);
+  /**
+   * Target of an ANIMATED programmatic scroll, or −1. While set the list writes no
+   * date — an animated scroll passes through every day on the way. Instant jumps
+   * never set it: their single event lands on the target, and a dropped event can
+   * therefore never leave the date frozen.
+   */
+  const programmaticY = useSharedValue(-1);
+  const windowFirst = useSharedValue(0);
+  const windowLast = useSharedValue(0);
+  const lastY = useSharedValue(0);
+  /** The section last handed to `onCommitDate`. */
+  const lastCommitted = useSharedValue(-1);
+  const applyOffset = useCallback((y, v) => {
+    'worklet';
+
+    const {
+      offsets,
+      sectionOffset,
+      monthOfSection
+    } = tablesSV.value;
+    const rowCount = offsets.length - 1;
+    const sectionCount = sectionOffset.length - 1;
+    const H = viewportSV.value;
+    if (rowCount <= 0 || sectionCount <= 0 || H === 0) return;
+
+    // `y + 1`: a header sitting exactly on the edge is the current one.
+    const s = clampNum(bsearchLE(sectionOffset, y + 1), 0, sectionCount - 1);
+    if (currentSection.value !== s) currentSection.value = s;
+    // A header slot is shorter than any section, so the day holding most of
+    // it is `s` or `s + 1` — no second search.
+    const d = s + 1 < sectionCount && sectionOffset[s + 1] <= y + headerHeight / 2 ? s + 1 : s;
+    const owned = programmaticY.value < 0;
+    if (owned && dayIndex.value !== d) dayIndex.value = d;
+    const isMoving = moving.value === 1;
+    if (isMoving && v > FAST_ENTER && fast.value === 0) {
+      fast.value = 1;
+      runOnJS(onFastChange)(true);
+    } else if ((!isMoving || v < FAST_EXIT) && fast.value === 1) {
+      fast.value = 0;
+      runOnJS(onFastChange)(false);
+    }
+    const isFast = fast.value === 1;
+
+    // Overscan in pixels. Moving: 0.75 H plus 200 ms of travel, capped at 3 H of
+    // real rows or 6 H while entering rows are deferred (5 H of real rows was
+    // measured on the device and made the blank worse). At rest: the tight
+    // `REST_REACH_H` / `REST_TRAIL_H` — every mounted row costs frame time.
+    const reach = isMoving ? clampNum(0.75 * H + v * 200, H, (isFast ? 6 : 3) * H) : REST_REACH_H * H;
+    const trail = isMoving ? 0.2 * H : REST_TRAIL_H * H;
+    const goingDown = y >= lastY.value;
+    lastY.value = y;
+    const bucket = isFast ? BUCKET_FAST : BUCKET_REST;
+    let first = bsearchLE(offsets, y - (goingDown ? trail : reach)) & -bucket;
+    let last = Math.min(rowCount - 1, bsearchLE(offsets, y + H + (goingDown ? reach : trail)) | bucket - 1);
+
+    // While fast the window only grows in the travel direction: a velocity
+    // jitter across a 32-row bucket edge would otherwise tear down and rebuild
+    // 32 rows mid-fling. Released the moment `fast` drops, so the upgrade to
+    // real rows happens on the tight window (the 483 ms stall, M1a).
+    if (isFast) {
+      if (goingDown) {
+        if (first > windowFirst.value) first = windowFirst.value;
+        if (last < windowLast.value) last = windowLast.value;
+      } else {
+        if (first > windowFirst.value) first = windowFirst.value;
+        if (last < windowLast.value) last = windowLast.value;
+      }
+    }
+    // The cap trims the trailing edge — those rows are leaving.
+    if (last - first + 1 > MAX_WINDOW_ROWS) {
+      if (goingDown) first = last - MAX_WINDOW_ROWS + 1;else last = first + MAX_WINDOW_ROWS - 1;
+    }
+    if (first !== windowFirst.value || last !== windowLast.value) {
+      windowFirst.value = first;
+      windowLast.value = last;
+      runOnJS(onWindowChange)(first, last);
+    }
+    if (!owned) return;
+    const committed = lastCommitted.value;
+    if (isMoving) {
+      if (committed < 0 || monthOfSection[d] !== monthOfSection[committed]) {
+        lastCommitted.value = d;
+        runOnJS(onCommitDate)(d);
+      }
+    } else if (d !== committed && v < 0.5) {
+      // "Nearly still": a hard fling's first events can arrive before
+      // `onBeginDrag`, and each would otherwise commit a throwaway day.
+      lastCommitted.value = d;
+      runOnJS(onCommitDate)(d);
+    }
+  }, [currentSection, dayIndex, fast, headerHeight, lastCommitted, lastY, moving, onCommitDate, onFastChange, onWindowChange, programmaticY, tablesSV, viewportSV, windowFirst, windowLast]);
+
+  /** The one settle path: a no-throw release or a momentum end. */
+  const endMove = useCallback(y => {
+    'worklet';
+
+    moving.value = 0;
+    velocity.value = 0;
+    // The settle event's offset is the only one guaranteed final: Android drops
+    // a scroll event inside `scrollEventThrottle` of the previous one (M6).
+    scrollY.value = y;
+    const target = programmaticY.value;
+    if (target >= 0) {
+      const {
+        offsets
+      } = tablesSV.value;
+      const maxY = (offsets[offsets.length - 1] ?? 0) - viewportSV.value;
+      if (Math.abs(y - target) < 2 || y >= maxY - 1) programmaticY.value = -1;
+    }
+    applyOffset(y, 0);
+    if (onSettle) runOnJS(onSettle)();
+  }, [applyOffset, moving, onSettle, programmaticY, scrollY, tablesSV, velocity, viewportSV]);
+  const scrollHandler = useAnimatedScrollHandler({
+    onBeginDrag: () => {
+      moving.value = 1;
+      // A finger overrides any move still travelling.
+      programmaticY.value = -1;
+      listDragSeq.value = listDragSeq.value + 1;
+      if (onDragBegin) runOnJS(onDragBegin)();
+    },
+    onMomentumBegin: () => {
+      moving.value = 1;
+    },
+    onScroll: e => {
+      const y = e.contentOffset.y;
+      // A hard fling's first event can jump hundreds of pixels while reporting
+      // velocity 0; hand a jump over 24 px on as motion, not as "at rest".
+      const jump = Math.abs(y - scrollY.value);
+      scrollY.value = y;
+      if (programmaticY.value >= 0 && Math.abs(y - programmaticY.value) < 1.5) {
+        programmaticY.value = -1;
+      }
+      const raw = e.velocity ? Math.abs(e.velocity.y) : 0;
+      const held = velocity.value * 0.85;
+      velocity.value = raw > held ? raw : held;
+      applyOffset(y, jump > 24 && velocity.value < 1 ? 1 : velocity.value);
+    },
+    onEndDrag: e => {
+      // A release with no throw gets no momentum end, so it settles here.
+      if (Math.abs(e.velocity ? e.velocity.y : 0) < 0.05) endMove(e.contentOffset.y);
+    },
+    onMomentumEnd: e => {
+      endMove(e.contentOffset.y);
+    }
+  }, [applyOffset, endMove, listDragSeq, moving, onDragBegin, programmaticY, scrollY, velocity]);
+  return {
+    scrollY,
+    currentSection,
+    moving,
+    fast,
+    programmaticY,
+    windowFirst,
+    windowLast,
+    scrollHandler,
+    applyOffset
+  };
+};
+//# sourceMappingURL=useAgendaScrollSync.js.map

package/lib/module/agenda/useAgendaScrollSync.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useCallback","useAnimatedScrollHandler","useSharedValue","runOnJS","bsearchLE","clampNum","BUCKET_FAST","BUCKET_REST","FAST_ENTER","FAST_EXIT","MAX_WINDOW_ROWS","REST_REACH_H","REST_TRAIL_H","useAgendaScrollSync","tablesSV","viewportSV","headerHeight","dayIndex","listDragSeq","onWindowChange","onCommitDate","onFastChange","onDragBegin","onSettle","scrollY","velocity","currentSection","moving","fast","programmaticY","windowFirst","windowLast","lastY","lastCommitted","applyOffset","y","v","offsets","sectionOffset","monthOfSection","value","rowCount","length","sectionCount","H","s","d","owned","isMoving","isFast","reach","trail","goingDown","bucket","first","last","Math","min","committed","endMove","target","maxY","abs","scrollHandler","onBeginDrag","onMomentumBegin","onScroll","e","contentOffset","jump","raw","held","onEndDrag","onMomentumEnd"],"sourceRoot":"../../../src","sources":["agenda/useAgendaScrollSync.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/core/ArrowGlyph.js

@@ -0,0 +1,60 @@
+"use strict";
+
+/**
+ * An up arrow drawn from two Views: a stem, and a square with only its top and
+ * left borders painted, rotated 45° into a chevron.
+ *
+ * The kit ships no icon font and takes no SVG peer dependency for one 14 px
+ * glyph — a consumer should not have to install an icon package to get a Today
+ * button. Rotation of the whole arrow is the caller's job (`TodayButton` flips
+ * it 180° on the UI thread).
+ */
+
+import { View } from 'react-native';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+const STROKE = 1.6;
+export const ArrowGlyph = ({
+  size,
+  color
+}) => {
+  // Rotating a square 45° about its centre puts its top-left corner directly
+  // above that centre, at (√2 / 2) · side away — so the apex lands on
+  // `apexY` when the square's centre sits that far below it.
+  const side = size * 0.34;
+  const apexY = size * 0.12;
+  const headCentreY = apexY + Math.SQRT2 / 2 * side;
+  return /*#__PURE__*/_jsxs(View, {
+    style: {
+      width: size,
+      height: size
+    },
+    children: [/*#__PURE__*/_jsx(View, {
+      style: {
+        position: 'absolute',
+        left: '50%',
+        marginLeft: -STROKE / 2,
+        top: apexY,
+        width: STROKE,
+        height: size - apexY * 2,
+        backgroundColor: color,
+        borderRadius: STROKE
+      }
+    }), /*#__PURE__*/_jsx(View, {
+      style: {
+        position: 'absolute',
+        left: '50%',
+        marginLeft: -side / 2,
+        top: headCentreY - side / 2,
+        width: side,
+        height: side,
+        borderTopWidth: STROKE,
+        borderLeftWidth: STROKE,
+        borderColor: color,
+        transform: [{
+          rotate: '45deg'
+        }]
+      }
+    })]
+  });
+};
+//# sourceMappingURL=ArrowGlyph.js.map

package/lib/module/core/ArrowGlyph.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["View","jsx","_jsx","jsxs","_jsxs","STROKE","ArrowGlyph","size","color","side","apexY","headCentreY","Math","SQRT2","style","width","height","children","position","left","marginLeft","top","backgroundColor","borderRadius","borderTopWidth","borderLeftWidth","borderColor","transform","rotate"],"sourceRoot":"../../../src","sources":["core/ArrowGlyph.tsx"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,IAAI,QAAQ,cAAc;AAAC,SAAAC,GAAA,IAAAC,IAAA,EAAAC,IAAA,IAAAC,KAAA;AAEpC,MAAMC,MAAM,GAAG,GAAG;AAElB,OAAO,MAAMC,UAAU,GAAGA,CAAC;EAAEC,IAAI;EAAEC;AAAuC,CAAC,KAAK;EAC9E;EACA;EACA;EACA,MAAMC,IAAI,GAAGF,IAAI,GAAG,IAAI;EACxB,MAAMG,KAAK,GAAGH,IAAI,GAAG,IAAI;EACzB,MAAMI,WAAW,GAAGD,KAAK,GAAIE,IAAI,CAACC,KAAK,GAAG,CAAC,GAAIJ,IAAI;EAEnD,oBACEL,KAAA,CAACJ,IAAI;IAACc,KAAK,EAAE;MAAEC,KAAK,EAAER,IAAI;MAAES,MAAM,EAAET;IAAK,CAAE;IAAAU,QAAA,gBACzCf,IAAA,CAACF,IAAI;MACHc,KAAK,EAAE;QACLI,QAAQ,EAAE,UAAU;QACpBC,IAAI,EAAE,KAAK;QACXC,UAAU,EAAE,CAACf,MAAM,GAAG,CAAC;QACvBgB,GAAG,EAAEX,KAAK;QACVK,KAAK,EAAEV,MAAM;QACbW,MAAM,EAAET,IAAI,GAAGG,KAAK,GAAG,CAAC;QACxBY,eAAe,EAAEd,KAAK;QACtBe,YAAY,EAAElB;MAChB;IAAE,CACH,CAAC,eACFH,IAAA,CAACF,IAAI;MACHc,KAAK,EAAE;QACLI,QAAQ,EAAE,UAAU;QACpBC,IAAI,EAAE,KAAK;QACXC,UAAU,EAAE,CAACX,IAAI,GAAG,CAAC;QACrBY,GAAG,EAAEV,WAAW,GAAGF,IAAI,GAAG,CAAC;QAC3BM,KAAK,EAAEN,IAAI;QACXO,MAAM,EAAEP,IAAI;QACZe,cAAc,EAAEnB,MAAM;QACtBoB,eAAe,EAAEpB,MAAM;QACvBqB,WAAW,EAAElB,KAAK;QAClBmB,SAAS,EAAE,CAAC;UAAEC,MAAM,EAAE;QAAQ,CAAC;MACjC;IAAE,CACH,CAAC;EAAA,CACE,CAAC;AAEX,CAAC","ignoreList":[]}

package/lib/module/core/CalendarContext.js

@@ -0,0 +1,26 @@
+"use strict";
+
+/**
+ * Two contexts, split by how often they change.
+ *
+ * `CalendarContext` is identity-stable for the life of the provider: every
+ * scroller reads it, and none of them may re-render because a date was committed.
+ * `CalendarDateContext` is the committed date alone — only surfaces that DRAW the
+ * committed date (the month grid's selection) subscribe to it. Surfaces that
+ * track the date at frame rate read `store.dayIndex` and subscribe to neither.
+ */
+
+import { createContext, useContext } from 'react';
+export const CalendarContext = /*#__PURE__*/createContext(null);
+export const CalendarDateContext = /*#__PURE__*/createContext('');
+export const useCalendarContext = () => {
+  const ctx = useContext(CalendarContext);
+  if (!ctx) {
+    throw new Error('[agenda-kit] useCalendarContext outside <CalendarProvider>. AgendaList, ' + 'ExpandableCalendar and TimelineList share one index space and must be inside it.');
+  }
+  return ctx;
+};
+
+/** The committed date. Subscribing re-renders on every commit — use sparingly. */
+export const useCalendarDate = () => useContext(CalendarDateContext);
+//# sourceMappingURL=CalendarContext.js.map

package/lib/module/core/CalendarContext.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createContext","useContext","CalendarContext","CalendarDateContext","useCalendarContext","ctx","Error","useCalendarDate"],"sourceRoot":"../../../src","sources":["core/CalendarContext.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,aAAa,EAAEC,UAAU,QAAQ,OAAO;AAqBjD,OAAO,MAAMC,eAAe,gBAAGF,aAAa,CAA8B,IAAI,CAAC;AAC/E,OAAO,MAAMG,mBAAmB,gBAAGH,aAAa,CAAa,EAAE,CAAC;AAEhE,OAAO,MAAMI,kBAAkB,GAAGA,CAAA,KAA4B;EAC5D,MAAMC,GAAG,GAAGJ,UAAU,CAACC,eAAe,CAAC;EACvC,IAAI,CAACG,GAAG,EAAE;IACR,MAAM,IAAIC,KAAK,CACb,0EAA0E,GACxE,kFACJ,CAAC;EACH;EACA,OAAOD,GAAG;AACZ,CAAC;;AAED;AACA,OAAO,MAAME,eAAe,GAAGA,CAAA,KAAkBN,UAAU,CAACE,mBAAmB,CAAC","ignoreList":[]}