Lazy-load by date range

"use client";

import { useCallback, useRef, useState } from "react";
import { Kloq, type CalEvent } from "kloq";
import { Bar, Dot } from "../parts";
import { EventServer } from "./data";

interface Request {
  id: number;
  start: Date;
  end: Date;
  /** null while in flight */
  count: number | null;
}

const plural = (n: number, word: string) => `${n} ${word}${n === 1 ? "" : "s"}`;
const day = (d: Date) => d.toLocaleDateString("en-US", { month: "short", day: "numeric" });
// `end` is exclusive — midnight after the last day — so the label shows the day before it
const span = (r: Request) => `${day(r.start)} – ${day(new Date(r.end.getTime() - 1))}`;

const mergeById = (loaded: CalEvent[], page: CalEvent[]) => {
  const byId = new Map(loaded.map((e) => [e.id, e]));
  for (const e of page) byId.set(e.id, e);
  return [...byId.values()];
};

export default function RangeFetchingExample() {
  const [server] = useState(() => new EventServer(new Date()));
  const [events, setEvents] = useState<CalEvent[]>([]);
  const [requests, setRequests] = useState<Request[]>([]);

  const last = useRef("");
  const seq = useRef(0);
  const onRangeChange = useCallback(
    (start: Date, end: Date) => {
      const key = `${start.getTime()}:${end.getTime()}`;
      if (key === last.current) return; // React StrictMode replays the mount call in development
      last.current = key;
      const id = ++seq.current;
      setRequests((rs) => [{ id, start, end, count: null }, ...rs]);
      void server.fetchRange(start, end).then((page) => {
        setEvents((loaded) => mergeById(loaded, page));
        setRequests((rs) => rs.map((r) => (r.id === id ? { ...r, count: page.length } : r)));
      });
    },
    [server],
  );

  const onEventsChange = (next: CalEvent[]) => {
    server.sync(events, next);
    setEvents(next);
  };

  const inFlight = requests.some((r) => r.count === null);
  const latest = requests.find((r) => r.count !== null);

  return (
    <div className="@container flex flex-col">
      <div className="h-104">
        <Kloq
          events={events}
          onEventsChange={onEventsChange}
          onRangeChange={onRangeChange}
          rangePadding={7}
          storage={false}
          designMode={false}
        >
          <Kloq.Toolbar />
        </Kloq>
      </div>

      <Bar edge="top" className="min-h-28 flex-col items-start gap-y-1 tabular-nums">
        <p role="status" className="flex items-center gap-2 text-foreground">
          <Dot live={inFlight} />
          {latest
            ? `fetched ${span(latest)} · ${events.length} of ${server.size} events loaded · ${plural(requests.length, "request")}`
            : "fetching…"}
        </p>
        {requests.slice(0, 3).map((r) => (
          <p key={r.id} className="flex gap-3">
            <span>#{r.id}</span>
            <span>{span(r)}</span>
            <span>{r.count === null ? "…" : plural(r.count, "event")}</span>
          </p>
        ))}
      </Bar>
    </div>
  );
}

import {
  formatInstant,
  instantPlus,
  parseInstant,
  toDateOnlyString,
  type CalEvent,
  type EventColor,
} from "kloq";

const TITLES = [
  "Standup", "Design review", "1:1", "Deep work", "Customer call", "Planning",
  "Retro", "Interview", "Lunch", "Pairing", "Demo", "Roadmap",
];
const COLORS: EventColor[] = ["blue", "violet", "emerald", "amber", "rose"];

/** mulberry32 — a seeded generator, so every visitor gets the same 300 events. */
function prng(seed: number) {
  return () => {
    seed = (seed + 0x6d2b79f5) | 0;
    let t = Math.imul(seed ^ (seed >>> 15), 1 | seed);
    t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;
    return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
  };
}

/** ~300 events over the 16 weeks around `now`, weekends mostly empty. */
export function generateEvents(now: Date, count = 300): CalEvent[] {
  const rand = prng(20260830);
  const first = new Date(now);
  first.setHours(0, 0, 0, 0);
  first.setDate(first.getDate() - 8 * 7);

  const events: CalEvent[] = [];
  while (events.length < count) {
    const day = new Date(first);
    day.setDate(first.getDate() + Math.floor(rand() * 16 * 7));
    if (day.getDay() % 6 === 0 && rand() < 0.8) continue;

    const id = `ev-${events.length}`;
    const title = TITLES[Math.floor(rand() * TITLES.length)];
    const color = COLORS[events.length % COLORS.length];
    if (rand() < 0.06) {
      const next = new Date(day);
      next.setDate(day.getDate() + 1);
      events.push({ id, title, color, allDay: true, start: toDateOnlyString(day), end: toDateOnlyString(next) });
      continue;
    }
    day.setHours(8 + Math.floor(rand() * 10), rand() < 0.5 ? 0 : 30);
    const start = formatInstant(day);
    events.push({ id, title, color, start, end: instantPlus(start, 30 * (1 + Math.floor(rand() * 4))) });
  }
  return events;
}

const sleep = (ms: number) => new Promise<void>((resolve) => setTimeout(resolve, ms));

/** Holds every event; the calendar only ever sees the pages it asked for. */
export class EventServer {
  private db: Map<string, CalEvent>;

  constructor(now: Date) {
    this.db = new Map(generateEvents(now).map((e) => [e.id, e]));
  }

  get size() {
    return this.db.size;
  }

  /** Events touching `[start, end)`, one simulated round-trip later. */
  async fetchRange(start: Date, end: Date): Promise<CalEvent[]> {
    await sleep(350);
    const lo = start.getTime();
    const hi = end.getTime();
    return [...this.db.values()].filter(
      (e) => parseInstant(e.start) < hi && parseInstant(e.end) > lo,
    );
  }

  /** Write-through from `onEventsChange`: `after` is only the loaded pages, so a deletion is an id that went missing. */
  sync(before: CalEvent[], after: CalEvent[]) {
    const kept = new Set(after.map((e) => e.id));
    for (const e of before) if (!kept.has(e.id)) this.db.delete(e.id);
    for (const e of after) this.db.set(e.id, e);
  }
}

"use client";

import type { ComponentProps } from "react";
import { ChevronLeft, ChevronRight } from "lucide-react";
import { formatViewTitle, useIsClient, useKloq } from "kloq";
import { Button } from "@/components/ui/button";
import { cn } from "@/lib/utils";

/** The strip an example hangs its controls and readouts on; same box as `Kloq.Toolbar`. */
export function Bar({
  edge = "bottom",
  className,
  ...props
}: ComponentProps<"div"> & { edge?: "top" | "bottom" }) {
  return (
    <div
      {...props}
      className={cn(
        "flex min-h-11 shrink-0 flex-wrap items-center gap-x-4 gap-y-2 px-4 py-2.5 font-mono text-xs text-muted-foreground",
        edge === "bottom" ? "border-b" : "border-t",
        className,
      )}
    />
  );
}

export function Dot({ live, className, ...props }: ComponentProps<"span"> & { live?: boolean }) {
  return (
    <span
      aria-hidden
      {...props}
      className={cn(
        "size-1.5 shrink-0 rounded-full",
        live ? "bg-brand motion-safe:animate-pulse" : "bg-border",
        className,
      )}
    />
  );
}

/** Previous / next / today for a calendar whose view is fixed. Must render inside `<Kloq>`. */
export function Nav({ locale }: { locale?: string }) {
  const k = useKloq();
  const isClient = useIsClient();
  return (
    <div className="flex min-w-0 items-center gap-1">
      <Button variant="ghost" size="icon-xs" aria-label="Previous" onClick={() => k.step(-1)}>
        <ChevronLeft />
      </Button>
      <Button variant="ghost" size="icon-xs" aria-label="Next" onClick={() => k.step(1)}>
        <ChevronRight />
      </Button>
      <Button variant="ghost" size="xs" className={cn(k.atToday && "text-muted-foreground")} onClick={k.goToday}>
        Today
      </Button>
      <span className="ms-1 truncate text-sm font-medium text-foreground tabular-nums sm:text-xs">
        {isClient ? formatViewTitle(k.view, locale, { short: k.narrow }) : null}
      </span>
    </div>
  );
}