react-native-agenda-kit 0.1.0

package/lib/typescript/module/types.d.ts

@@ -0,0 +1,237 @@
+/**
+ * react-native-agenda-kit — the public type surface.
+ *
+ * The kit is a PURE UI LIBRARY: it fetches nothing, knows no app type, and
+ * reads only design tokens. Everything domain-shaped (an appointment, a
+ * booking status, a locale) arrives as a caller-supplied render prop or a
+ * primitive. That boundary is what makes the three surfaces reusable and what
+ * keeps the CONSUMER's screen the only place that knows what a row *means*.
+ *
+ * Names deliberately match `react-native-calendars`' public API
+ * (`CalendarProvider`, `ExpandableCalendar`, `AgendaList`, `TimelineList`,
+ * `UpdateSources`) so a migrating screen's JSX is a copy, not a rewrite.
+ */
+import type { ReactElement, ReactNode } from 'react';
+import type { StyleProp, ViewStyle } from 'react-native';
+/** 'YYYY-MM-DD', local calendar day. The only date string the kit accepts. */
+export type DateString = string;
+/**
+ * Why a date changed. The strings are byte-identical to the library's
+ * `commons.js` UpdateSources so the screen's `handleDateChanged` switch is a
+ * verbatim copy.
+ */
+export declare const UpdateSources: {
+    readonly CALENDAR_INIT: "calendarInit";
+    readonly TODAY_PRESS: "todayPress";
+    readonly LIST_DRAG: "listDrag";
+    readonly DAY_PRESS: "dayPress";
+    readonly PAGE_SCROLL: "pageScroll";
+    readonly WEEK_SCROLL: "weekScroll";
+    readonly PROP_UPDATE: "propUpdate";
+};
+export type UpdateSource = (typeof UpdateSources)[keyof typeof UpdateSources];
+/**
+ * Which surface *produced* a programmatic move. The originating scroller
+ * ignores its own origin, which is the whole echo-proofing story: no latches,
+ * no 500 ms timers, no `changedItems` bookkeeping.
+ */
+export type MoveOrigin = 'agenda' | 'timeline' | 'week' | 'month' | 'external';
+/** One programmatic move. `seq` makes every move distinct even when `idx` repeats. */
+export type CalendarMove = {
+    seq: number;
+    idx: number;
+    origin: MoveOrigin;
+    animated: boolean;
+};
+/**
+ * The one index space. Every surface addresses a day by its integer offset
+ * from `start`: agenda section index, week page `floor(i/7)`, month page,
+ * timeline column. Worklets never touch strings.
+ *
+ * `start` is a Monday (the skeleton pads to whole weeks) and `days` is a
+ * multiple of 7, so `floor(dayIndex / 7)` is always a whole page.
+ */
+export type CalendarRange = {
+    /** 'YYYY-MM-DD' of index 0 — a padded week start. */
+    start: DateString;
+    /** Epoch day of `start` (see `core/civil.ts`): `dayIndexOf` is one subtraction. */
+    startEpochDay: number;
+    /** 'YYYY-MM-DD' of every index, built once: `ymdAt` is one array read. */
+    ymdByIndex: readonly DateString[];
+    /** Total day count (e.g. 126 or 133 for a 4-month window). */
+    days: number;
+    /** Selectable bounds, inclusive, as indices into the same space. */
+    minIndex: number;
+    maxIndex: number;
+    /** 1 = Monday. Matches the library's `firstDay`. */
+    firstDay: number;
+    /** Index of today, or -1 when today is outside the range. */
+    todayIndex: number;
+};
+/**
+ * A day's worth of rows. `title` is the 'YYYY-MM-DD' key — the library's
+ * SectionList convention, kept so `renderSectionHeader` stays a copy.
+ */
+export type AgendaSection<T> = {
+    title: DateString;
+    data: T[];
+};
+export type AgendaListRef = {
+    scrollToDate: (date: DateString, animated?: boolean) => void;
+    scrollToSection: (title: DateString, animated?: boolean) => void;
+    scrollToOffset: (params: {
+        offset: number;
+        animated?: boolean;
+    }) => void;
+};
+export type AgendaListProps<T> = {
+    sections: AgendaSection<T>[];
+    renderItem: (info: {
+        item: T;
+        index: number;
+        section: AgendaSection<T>;
+    }) => ReactElement | null;
+    renderSectionHeader: (title: DateString) => ReactElement | null;
+    /**
+     * Declared row heights in px, keyed by `getItemType`. Never measured: a wrong
+     * number clips inside its slot instead of shifting the list (DEV warns per type).
+     */
+    itemHeightByType: Record<string, number>;
+    /** Height of a section header slot. Default 32. */
+    sectionHeaderHeight?: number;
+    /** Defaults to `item.itemCustomHeightType`, else 'Regular'. */
+    getItemType?: (item: T) => string;
+    /** Defaults to `item.id`. */
+    keyExtractor?: (item: T, index: number) => string;
+    /** Real sticky headers (a fixed overlay), unlike the library's. */
+    stickySectionHeadersEnabled?: boolean;
+    /** Real `RefreshControl`. Arms at the top of the window only (platform). */
+    refreshing?: boolean;
+    onRefresh?: () => void;
+    /**
+     * Skeleton tiles drawn BEHIND the list, moving with it. With a backdrop, rows
+     * entering the window during a fast fling are deferred and the backdrop shows
+     * through their slots — so a fling that outruns the JS thread never shows bare
+     * ground. Without one, every row renders real.
+     */
+    backdrop?: {
+        tileHeight: number;
+        renderTile: () => ReactElement;
+    };
+    /** Painted under every drawn row, so the backdrop shows only where no row is drawn. */
+    rowGroundColor?: string;
+    decelerationRate?: number | 'fast' | 'normal';
+    ref?: React.Ref<AgendaListRef>;
+    /** Gesture hooks: drag begin and settle. Each costs a UI→JS hop per gesture — pass them only when needed. */
+    onDragBegin?: () => void;
+    onSettle?: () => void;
+    titleHeight?: number;
+    sectionStyle?: StyleProp<ViewStyle>;
+    dayFormatter?: (date: string) => string;
+    markToday?: boolean;
+    updateCellsBatchingPeriod?: number;
+    onScrollToIndexFailed?: (info: unknown) => void;
+    infiniteListProps?: Record<string, unknown>;
+};
+export type MarkedDates = Record<DateString, {
+    marked?: boolean;
+    dotColor?: string;
+    selected?: boolean;
+    disabled?: boolean;
+}>;
+export type CalendarPosition = 'closed' | 'open';
+export type ExpandableCalendarRef = {
+    /** Returns the position it moved TO. `true` = open. */
+    toggleCalendarPosition: () => boolean;
+};
+export type ExpandableCalendarProps = ExpandableCalendarCompatProps & {
+    initialPosition?: CalendarPosition;
+    onCalendarToggled?: (isOpen: boolean) => void;
+    style?: StyleProp<ViewStyle>;
+    closeOnDayPress?: boolean;
+    /** Collapse an open calendar when a list under it starts a drag. Default true; ignored under a screen reader. */
+    closeOnListScroll?: boolean;
+    markedDates?: MarkedDates;
+    disablePan?: boolean;
+    openThreshold?: number;
+    closeThreshold?: number;
+    /** Screen-reader label for the drag knob. Caller-supplied: the kit ships no strings. */
+    knobAccessibilityLabel?: string;
+    /** The spoken name of a grid day; called only while a screen reader runs, once per day of the range. */
+    dayAccessibilityLabel?: (date: DateString) => string;
+    /** Twelve short month names, January first, drawn over each 1st in the week strip. None drawn when absent. */
+    monthShortLabels?: readonly string[];
+    /** Rendered inside the body the calendar pushes down — the agenda or the timeline. */
+    children?: ReactNode;
+    ref?: React.Ref<ExpandableCalendarRef>;
+};
+/** Accepted and never read — typed so JSX copied from `react-native-calendars` compiles unchanged. */
+export type ExpandableCalendarCompatProps = {
+    firstDay?: number;
+    /** No header band is rendered; the callers pass `() => null`. */
+    renderHeader?: (date?: DateString) => ReactNode;
+    headerStyle?: StyleProp<ViewStyle>;
+    minDate?: DateString;
+    maxDate?: DateString;
+    pastScrollRange?: number;
+    futureScrollRange?: number;
+    hideArrows?: boolean;
+    allowShadow?: boolean;
+    /** No day-names row is rendered; the callers pass `hideDayNames`. */
+    hideDayNames?: boolean;
+    dayNames?: string[];
+    theme?: unknown;
+    onVisibleMonthsChange?: (months: unknown[]) => void;
+};
+/** `start` / `end` are 'YYYY-MM-DD HH:mm:ss' — the library's wire format. */
+export type TimelineEvent = {
+    id: string;
+    start: string;
+    end?: string;
+    title?: string;
+    summary?: string;
+    color?: string;
+};
+export type PackedTimelineEvent<E extends TimelineEvent = TimelineEvent> = E & {
+    /** Packer output, in px relative to the column. */
+    index: number;
+    top: number;
+    left: number;
+    width: number;
+    height: number;
+};
+/** An inclusive window of *available* time. The kit never takes the inverse. */
+export type AvailableHours = {
+    start: number;
+    end: number;
+}[];
+export type TimelineInnerProps<E extends TimelineEvent = TimelineEvent> = {
+    renderEvent?: (event: PackedTimelineEvent<E>) => ReactElement | null;
+    /** Receives the PACKED event, as the library's does (`Timeline.js` passes `packedEvents[i][j]`). */
+    onEventPress?: (event: PackedTimelineEvent<E>) => void;
+    format24h?: boolean;
+    overlapEventsSpacing?: number;
+    rightEdgeSpacing?: number;
+    /**
+     * AVAILABLE windows, per date. The library takes `unavailableHours`; the
+     * consumer usually computes availability directly, so the kit takes the
+     * un-inverted form. This is the one deliberate rename.
+     */
+    availableHours?: Record<DateString, AvailableHours> | AvailableHours;
+    availableHoursColor?: string;
+    hourHeight?: number;
+};
+export type TimelineListProps<E extends TimelineEvent = TimelineEvent> = {
+    /** Keyed by 'YYYY-MM-DD'. Neighbours must be present or a swipe shows a blank day. */
+    events: Record<DateString, E[]>;
+    timelineProps?: TimelineInnerProps<E>;
+    showNowIndicator?: boolean;
+    scrollToNow?: boolean;
+    scrollToFirst?: boolean;
+    /** 'HH:mm' or `{ hour, minutes }`. Lowest precedence. */
+    initialTime?: {
+        hour: number;
+        minutes: number;
+    } | string;
+};
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/module/types.d.ts.map

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

package/package.json

@@ -0,0 +1,105 @@
+{
+  "name": "react-native-agenda-kit",
+  "version": "0.1.0",
+  "description": "A fast expandable calendar, agenda list and day timeline for React Native \u2014 declared row heights, worklet-driven scroll sync, zero measurement.",
+  "main": "./lib/commonjs/index.js",
+  "module": "./lib/module/index.js",
+  "types": "./lib/typescript/commonjs/index.d.ts",
+  "react-native": "./src/index.ts",
+  "source": "./src/index.ts",
+  "exports": {
+    ".": {
+      "react-native": "./src/index.ts",
+      "import": {
+        "types": "./lib/typescript/module/index.d.ts",
+        "default": "./lib/module/index.js"
+      },
+      "require": {
+        "types": "./lib/typescript/commonjs/index.d.ts",
+        "default": "./lib/commonjs/index.js"
+      }
+    }
+  },
+  "files": [
+    "src",
+    "lib",
+    "!**/__tests__",
+    "!**/*.test.ts",
+    "!**/*.test.tsx"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf lib",
+    "build": "bob build",
+    "prepare": "bob build",
+    "prepublishOnly": "npm run typecheck && npm run clean && npm run build"
+  },
+  "keywords": [
+    "react-native",
+    "calendar",
+    "agenda",
+    "timeline",
+    "expandable-calendar",
+    "day-view",
+    "scheduler",
+    "reanimated",
+    "ios",
+    "android",
+    "expo"
+  ],
+  "license": "MIT",
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "react-native": ">=0.74.0",
+    "react-native-gesture-handler": ">=2.16.0",
+    "react-native-reanimated": ">=4.0.0",
+    "react-native-worklets": ">=0.3.0"
+  },
+  "devDependencies": {
+    "@types/react": "^19.0.0",
+    "react": "19.2.0",
+    "react-native": "0.83.6",
+    "react-native-builder-bob": "^0.39.0",
+    "react-native-gesture-handler": "~2.30.0",
+    "react-native-reanimated": "4.2.1",
+    "react-native-worklets": "0.7.4",
+    "typescript": "~5.9.2"
+  },
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      [
+        "commonjs",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "module",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "typescript",
+        {
+          "esm": true
+        }
+      ]
+    ]
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/shivampandey-07/react-native-agenda-kit.git"
+  },
+  "bugs": {
+    "url": "https://github.com/shivampandey-07/react-native-agenda-kit/issues"
+  },
+  "homepage": "https://github.com/shivampandey-07/react-native-agenda-kit#readme",
+  "author": "Shivam Pandey",
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/agenda/AgendaBackdrop.tsx

@@ -0,0 +1,55 @@
+/**
+ * The "never white" layer: static skeleton tiles BEHIND the list, moved by the
+ * scroll offset modulo one tile.
+ *
+ * Every list renders rows from JavaScript, so a fling faster than the JS thread
+ * can mount rows leaves slots with nothing drawn. This layer exists before the
+ * rows do; drawn rows cover it (their slots paint the list ground). Measured
+ * with the list-library trial: 25–51 % white frames without it, 0 % with it, on
+ * every engine. No shimmer — it sits hidden behind real rows almost always.
+ */
+
+import { memo, useMemo, type ReactElement } from 'react';
+import { Dimensions, StyleSheet, View } from 'react-native';
+import Animated, { useAnimatedStyle, type SharedValue } from 'react-native-reanimated';
+
+type Props = {
+  scrollY: SharedValue<number>;
+  tileHeight: number;
+  renderTile: () => ReactElement;
+};
+
+const AgendaBackdropInner = ({ scrollY, tileHeight, renderTile }: Props) => {
+  const tiles = useMemo(() => {
+    if (tileHeight <= 0) return null;
+    const count = Math.ceil(Dimensions.get('window').height / tileHeight) + 2;
+    const tileStyle = { height: tileHeight };
+    const out: ReactElement[] = [];
+    for (let i = 0; i < count; i += 1) {
+      out.push(
+        <View key={i} style={tileStyle}>
+          {renderTile()}
+        </View>,
+      );
+    }
+    return out;
+  }, [renderTile, tileHeight]);
+
+  const style = useAnimatedStyle(() => {
+    const r = tileHeight > 0 ? scrollY.value % tileHeight : 0;
+    return { transform: [{ translateY: -(r < 0 ? r + tileHeight : r) }] };
+  });
+
+  return (
+    <View pointerEvents="none" style={styles.fill}>
+      <Animated.View style={style}>{tiles}</Animated.View>
+    </View>
+  );
+};
+
+export const AgendaBackdrop = memo(AgendaBackdropInner);
+AgendaBackdrop.displayName = 'AgendaBackdrop';
+
+const styles = StyleSheet.create({
+  fill: { ...StyleSheet.absoluteFillObject, overflow: 'hidden' },
+});