@charlite/react-temporal 0.0.0-stage → 1.1.1

package/dist/index.esm.js

@@ -0,0 +1,477 @@
+import { Temporal as Temporal$1 } from 'temporal-polyfill';
+import { useRef, useEffect, useState, useCallback, useMemo } from 'react';
+
+/**
+ * True when the host exposes a native `globalThis.Temporal` implementation.
+ */
+function hasNativeTemporal() {
+    return typeof globalThis !== 'undefined' && globalThis.Temporal !== undefined;
+}
+/**
+ * Returns the Temporal namespace, preferring native host support
+ * (Chrome 144+, Firefox 139+, Edge 144+, Node.js 26+) and falling back to
+ * `temporal-polyfill` (smaller, spec-current) when native is missing.
+ *
+ * You may still install `@js-temporal/polyfill` in your app for typing or tooling;
+ * this package does not load it automatically.
+ */
+function getTemporal() {
+    if (hasNativeTemporal()) {
+        return globalThis.Temporal;
+    }
+    return Temporal$1;
+}
+/** Cached Temporal namespace for hot paths inside hooks. */
+const Temporal = getTemporal();
+
+/** Keeps a ref to the latest value (for callbacks inside intervals/timeouts). */
+function useLatest(value) {
+    const ref = useRef(value);
+    useEffect(() => {
+        ref.current = value;
+    }, [value]);
+    return ref;
+}
+
+/**
+ * Shared interval driver for live clock hooks.
+ */
+function useTemporalTicker({ intervalMs, getSnapshot, pauseWhenHidden = false, enabled = true, }) {
+    const getSnapshotRef = useLatest(getSnapshot);
+    const [value, setValue] = useState(() => getSnapshotRef.current());
+    useEffect(() => {
+        if (!enabled) {
+            return;
+        }
+        const tick = () => setValue(getSnapshotRef.current());
+        if (pauseWhenHidden && typeof document !== 'undefined') {
+            const onVisibility = () => {
+                if (!document.hidden) {
+                    tick();
+                }
+            };
+            document.addEventListener('visibilitychange', onVisibility);
+            const id = setInterval(() => {
+                if (!document.hidden) {
+                    tick();
+                }
+            }, intervalMs);
+            return () => {
+                clearInterval(id);
+                document.removeEventListener('visibilitychange', onVisibility);
+            };
+        }
+        const id = setInterval(tick, intervalMs);
+        return () => clearInterval(id);
+    }, [enabled, intervalMs, pauseWhenHidden, getSnapshotRef]);
+    return value;
+}
+
+/**
+ * Returns the current time as a Temporal.Instant (or ZonedDateTime when timeZone is set),
+ * updating at the configured interval.
+ */
+function useTemporalNow(options) {
+    const { intervalMs = 1000, timeZone, pauseWhenHidden = false } = options ?? {};
+    const getNow = useCallback(() => timeZone ? Temporal.Now.zonedDateTimeISO(timeZone) : Temporal.Now.instant(), [timeZone]);
+    return useTemporalTicker({
+        intervalMs,
+        pauseWhenHidden,
+        getSnapshot: getNow,
+    });
+}
+
+/**
+ * Returns the current Temporal.Instant, updating at a configurable interval.
+ */
+function useTemporalClock(options) {
+    const { intervalMs = 1000, pauseWhenHidden = false } = options ?? {};
+    const getNow = useCallback(() => Temporal.Now.instant(), []);
+    return useTemporalTicker({
+        intervalMs,
+        pauseWhenHidden,
+        getSnapshot: getNow,
+    });
+}
+
+/**
+ * Returns the current Temporal.ZonedDateTime for the given IANA time zone,
+ * updating at a configurable interval.
+ */
+function useTemporalZonedNow(timeZone, options) {
+    const { intervalMs = 1000, pauseWhenHidden = false } = options ?? {};
+    const getNow = useCallback(() => Temporal.Now.zonedDateTimeISO(timeZone), [timeZone]);
+    return useTemporalTicker({
+        intervalMs,
+        pauseWhenHidden,
+        getSnapshot: getNow,
+    });
+}
+
+/** Stable string key for `Temporal.DurationLike` values in hook dependency arrays. */
+function durationKey(duration) {
+    return Temporal.Duration.from(duration).toString();
+}
+/** Milliseconds for a duration-like value (for timers). */
+function durationToMilliseconds(duration) {
+    return Temporal.Duration.from(duration).total({ unit: 'milliseconds' });
+}
+
+/**
+ * Runs a callback at a given Temporal.Duration interval.
+ * Duration values are normalized for stable effect dependencies.
+ */
+function useTemporalInterval(callback, duration) {
+    const savedCallback = useLatest(callback);
+    const key = durationKey(duration);
+    useEffect(() => {
+        const ms = durationToMilliseconds(duration);
+        const id = setInterval(() => savedCallback.current(), ms);
+        return () => clearInterval(id);
+    }, [key, savedCallback]);
+}
+
+/**
+ * Returns a Temporal.Duration between two instants.
+ */
+function useTemporalDuration(start, end) {
+    return useMemo(() => start.until(end), [start, end]);
+}
+
+/**
+ * Validates and returns the calendar ID for a given calendar name.
+ */
+function useTemporalCalendar(id) {
+    return useMemo(() => Temporal.PlainDate.from({ year: 2000, month: 1, day: 1, calendar: id }).calendarId, [id]);
+}
+
+/**
+ * Validates and returns the time zone ID for a given IANA time zone name.
+ */
+function useTemporalTimeZone(id) {
+    return useMemo(() => Temporal.ZonedDateTime.from({
+        year: 2000,
+        month: 1,
+        day: 1,
+        timeZone: id,
+    }).timeZoneId, [id]);
+}
+
+/**
+ * Formats a Temporal object using Intl via Temporal's toLocaleString.
+ */
+function useTemporalFormat(temporalObj, locales, options) {
+    return useMemo(() => temporalObj.toLocaleString(locales, options), [temporalObj, locales, options]);
+}
+
+/**
+ * Returns an array of Temporal.PlainDate between start and end (inclusive).
+ */
+function useTemporalRange(start, end) {
+    return useMemo(() => {
+        const dates = [];
+        let current = start;
+        while (Temporal.PlainDate.compare(current, end) <= 0) {
+            dates.push(current);
+            current = current.add({ days: 1 });
+        }
+        return dates;
+    }, [start, end]);
+}
+
+const RELATIVE_UNITS = [
+    { unit: 'year', seconds: 31_536_000 },
+    { unit: 'month', seconds: 2_592_000 },
+    { unit: 'week', seconds: 604_800 },
+    { unit: 'day', seconds: 86_400 },
+    { unit: 'hour', seconds: 3_600 },
+    { unit: 'minute', seconds: 60 },
+    { unit: 'second', seconds: 1 },
+];
+/**
+ * Formats the span from `from` to `to` with Intl.RelativeTimeFormat.
+ * Chooses the coarsest unit that still represents the span without awkward rounding
+ * (e.g. 90 minutes instead of 2 hours).
+ */
+function formatRelativeTime(totalSeconds, locales, options) {
+    const rtf = new Intl.RelativeTimeFormat(locales, { numeric: 'auto', ...options });
+    const abs = Math.abs(totalSeconds);
+    for (const entry of RELATIVE_UNITS) {
+        if (abs < entry.seconds) {
+            continue;
+        }
+        const value = totalSeconds / entry.seconds;
+        const rounded = Math.round(value);
+        if (entry.unit === 'hour' &&
+            Math.abs(rounded) >= 1 &&
+            Math.abs(value - rounded) > 0.01 &&
+            abs >= 60) {
+            return rtf.format(Math.round(totalSeconds / 60), 'minute');
+        }
+        return rtf.format(rounded, entry.unit);
+    }
+    return rtf.format(0, 'second');
+}
+
+/**
+ * Returns a locale-aware relative time string between two instants
+ * (e.g. "in 3 hours", "2 days ago") using Intl.RelativeTimeFormat.
+ */
+function useTemporalRelative(from, to, locales, options) {
+    return useMemo(() => {
+        const totalSeconds = from.until(to).total('seconds');
+        return formatRelativeTime(totalSeconds, locales, options);
+    }, [from, to, locales, options]);
+}
+
+/**
+ * Returns the remaining seconds until a target Temporal.Instant.
+ */
+function useTemporalCountdown(target, options) {
+    const { intervalMs = 1000, onComplete } = options ?? {};
+    const completedRef = useRef(false);
+    const onCompleteRef = useLatest(onComplete ?? (() => { }));
+    const getRemaining = useCallback(() => Math.max(0, Math.floor(Temporal.Now.instant().until(target).total('seconds'))), [target]);
+    const remaining = useTemporalTicker({
+        intervalMs,
+        getSnapshot: getRemaining,
+    });
+    useEffect(() => {
+        completedRef.current = false;
+    }, [target]);
+    useEffect(() => {
+        if (remaining === 0 && !completedRef.current) {
+            completedRef.current = true;
+            onCompleteRef.current();
+        }
+    }, [remaining, onCompleteRef]);
+    return remaining;
+}
+
+/**
+ * Countdown with structured status (seconds + completion flag).
+ */
+function useTemporalCountdownStatus(target, options) {
+    const seconds = useTemporalCountdown(target, options);
+    return useMemo(() => ({
+        seconds,
+        isComplete: seconds === 0,
+    }), [seconds]);
+}
+
+/**
+ * Schedules a callback to run at a specific Temporal.Instant.
+ */
+function useTemporalSchedule(callback, instant, options) {
+    const { runIfPast = true } = options ?? {};
+    const savedCallback = useLatest(callback);
+    useEffect(() => {
+        const now = Temporal.Now.instant();
+        const ms = instant.epochMilliseconds - now.epochMilliseconds;
+        if (ms <= 0) {
+            if (runIfPast) {
+                savedCallback.current();
+            }
+            return;
+        }
+        const id = setTimeout(() => savedCallback.current(), ms);
+        return () => clearTimeout(id);
+    }, [instant, runIfPast, savedCallback]);
+}
+
+function parseTemporal(kind, input) {
+    switch (kind) {
+        case 'instant':
+            return Temporal.Instant.from(input);
+        case 'plainDate':
+            return Temporal.PlainDate.from(input);
+        case 'plainTime':
+            return Temporal.PlainTime.from(input);
+        case 'plainDateTime':
+            return Temporal.PlainDateTime.from(input);
+        case 'zonedDateTime':
+            return Temporal.ZonedDateTime.from(input);
+        default: {
+            const _exhaustive = kind;
+            return _exhaustive;
+        }
+    }
+}
+
+/**
+ * Parses an ISO string into the requested Temporal type (memoized on `input`).
+ */
+function useTemporalFrom(kind, input) {
+    return useMemo(() => parseTemporal(kind, input), [kind, input]);
+}
+
+/** Parses an ISO string to Temporal.Instant. */
+function useTemporalParse(isoString) {
+    return useTemporalFrom('instant', isoString);
+}
+
+/**
+ * Like `useTemporalFrom`, but returns `{ value, error }` instead of throwing.
+ */
+function useTemporalSafeParse(kind, input) {
+    return useMemo(() => {
+        try {
+            return { value: parseTemporal(kind, input), error: null };
+        }
+        catch (error) {
+            return {
+                value: null,
+                error: error instanceof Error ? error : new Error(String(error)),
+            };
+        }
+    }, [kind, input]);
+}
+
+/**
+ * Returns the difference between two instants as a Temporal.Duration.
+ */
+function useTemporalDiff(a, b) {
+    return useMemo(() => a.until(b), [a, b]);
+}
+
+/**
+ * Returns all dates in the ISO week (Monday–Sunday) containing the given PlainDate.
+ */
+function useTemporalWeek(date) {
+    return useMemo(() => {
+        const weekDay = date.dayOfWeek;
+        const start = date.subtract({ days: weekDay - 1 });
+        return Array.from({ length: 7 }, (_, i) => start.add({ days: i }));
+    }, [date]);
+}
+
+/**
+ * Returns all dates in the month of a given Temporal.PlainDate.
+ */
+function useTemporalMonth(date) {
+    return useMemo(() => {
+        const days = Temporal.PlainDate.from({
+            year: date.year,
+            month: date.month,
+            day: 1,
+        }).daysInMonth;
+        return Array.from({ length: days }, (_, i) => Temporal.PlainDate.from({ year: date.year, month: date.month, day: i + 1 }));
+    }, [date]);
+}
+
+/**
+ * Returns the first day of each month in the year of a given Temporal.PlainDate.
+ */
+function useTemporalYear(date) {
+    return useMemo(() => Array.from({ length: 12 }, (_, i) => Temporal.PlainDate.from({ year: date.year, month: i + 1, day: 1 })), [date]);
+}
+
+/**
+ * Returns elapsed whole seconds since a past `Temporal.Instant` (0 if the instant is in the future).
+ */
+function useTemporalElapsed(since, options) {
+    const { intervalMs = 1000, pauseWhenHidden = false } = options ?? {};
+    const getElapsed = useCallback(() => {
+        const seconds = since.until(Temporal.Now.instant()).total('seconds');
+        return Math.max(0, Math.floor(seconds));
+    }, [since]);
+    return useTemporalTicker({
+        intervalMs,
+        pauseWhenHidden,
+        getSnapshot: getElapsed,
+    });
+}
+
+/**
+ * Live stopwatch from a fixed start instant, updating on an interval.
+ */
+function useTemporalStopwatch(start, options) {
+    const { intervalMs = 100, pauseWhenHidden = false } = options ?? {};
+    const getElapsed = useCallback(() => start.until(Temporal.Now.instant()), [start]);
+    const elapsed = useTemporalTicker({
+        intervalMs,
+        pauseWhenHidden,
+        getSnapshot: getElapsed,
+    });
+    const seconds = useMemo(() => Math.max(0, Math.floor(elapsed.total('seconds'))), [elapsed]);
+    return { elapsed, seconds };
+}
+
+/**
+ * Returns today's calendar date in the given IANA time zone, updating across midnight.
+ */
+function useTemporalLocalDate(timeZone, options) {
+    const { intervalMs = 60_000, pauseWhenHidden = false } = options ?? {};
+    const getDate = useCallback(() => Temporal.Now.zonedDateTimeISO(timeZone).toPlainDate(), [timeZone]);
+    return useTemporalTicker({
+        intervalMs,
+        pauseWhenHidden,
+        getSnapshot: getDate,
+    });
+}
+
+function isInstant$1(value) {
+    return typeof value === 'object' && value !== null && 'epochMilliseconds' in value && !('year' in value);
+}
+function isPlainDate$1(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        'year' in value &&
+        'month' in value &&
+        'day' in value &&
+        !('epochMilliseconds' in value));
+}
+function compareValues(a, b) {
+    if (isInstant$1(a) && isInstant$1(b)) {
+        return Temporal.Instant.compare(a, b);
+    }
+    if (isPlainDate$1(a) && isPlainDate$1(b)) {
+        return Temporal.PlainDate.compare(a, b);
+    }
+    throw new TypeError('useTemporalCompare requires two Instants or two PlainDates');
+}
+/**
+ * Memoized Temporal compare result: negative if `a` is before `b`, positive if after, 0 if equal.
+ */
+function useTemporalCompare(a, b) {
+    return useMemo(() => compareValues(a, b), [a, b]);
+}
+
+function isInstant(value) {
+    return typeof value === 'object' && value !== null && 'epochMilliseconds' in value && !('year' in value);
+}
+function isPlainDate(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        'year' in value &&
+        'month' in value &&
+        'day' in value &&
+        !('epochMilliseconds' in value));
+}
+/**
+ * True when `value` is inclusively between `start` and `end`.
+ */
+function useTemporalWithin(value, start, end) {
+    return useMemo(() => {
+        if (isInstant(value) && isInstant(start) && isInstant(end)) {
+            return (Temporal.Instant.compare(value, start) >= 0 &&
+                Temporal.Instant.compare(value, end) <= 0);
+        }
+        if (isPlainDate(value) && isPlainDate(start) && isPlainDate(end)) {
+            return (Temporal.PlainDate.compare(value, start) >= 0 &&
+                Temporal.PlainDate.compare(value, end) <= 0);
+        }
+        throw new TypeError('useTemporalWithin requires matching Instant or PlainDate operands');
+    }, [value, start, end]);
+}
+
+/**
+ * Memoized `temporal.add(duration)` for PlainDate or Instant values.
+ */
+function useTemporalAdd(value, duration) {
+    const key = durationKey(duration);
+    return useMemo(() => value.add(duration), [value, key]);
+}
+
+export { Temporal, getTemporal, hasNativeTemporal, useTemporalAdd, useTemporalCalendar, useTemporalClock, useTemporalCompare, useTemporalCountdown, useTemporalCountdownStatus, useTemporalDiff, useTemporalDuration, useTemporalElapsed, useTemporalFormat, useTemporalFrom, useTemporalInterval, useTemporalLocalDate, useTemporalMonth, useTemporalNow, useTemporalParse, useTemporalRange, useTemporalRelative, useTemporalSafeParse, useTemporalSchedule, useTemporalStopwatch, useTemporalTimeZone, useTemporalWeek, useTemporalWithin, useTemporalYear, useTemporalZonedNow };
+//# sourceMappingURL=index.esm.js.map

package/dist/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.esm.js","sources":["../src/temporal.ts","../src/internal/useLatest.ts","../src/internal/useTemporalTicker.ts","../src/hooks/useTemporalNow.ts","../src/hooks/useTemporalClock.ts","../src/hooks/useTemporalZonedNow.ts","../src/internal/durationKey.ts","../src/hooks/useTemporalInterval.ts","../src/hooks/useTemporalDuration.ts","../src/hooks/useTemporalCalendar.ts","../src/hooks/useTemporalTimeZone.ts","../src/hooks/useTemporalFormat.ts","../src/hooks/useTemporalRange.ts","../src/utils/formatRelative.ts","../src/hooks/useTemporalRelative.ts","../src/hooks/useTemporalCountdown.ts","../src/hooks/useTemporalCountdownStatus.ts","../src/hooks/useTemporalSchedule.ts","../src/utils/parseTemporal.ts","../src/hooks/useTemporalFrom.ts","../src/hooks/useTemporalParse.ts","../src/hooks/useTemporalSafeParse.ts","../src/hooks/useTemporalDiff.ts","../src/hooks/useTemporalWeek.ts","../src/hooks/useTemporalMonth.ts","../src/hooks/useTemporalYear.ts","../src/hooks/useTemporalElapsed.ts","../src/hooks/useTemporalStopwatch.ts","../src/hooks/useTemporalLocalDate.ts","../src/hooks/useTemporalCompare.ts","../src/hooks/useTemporalWithin.ts","../src/hooks/useTemporalAdd.ts"],"sourcesContent":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null],"names":["TemporalPolyfill","isInstant","isPlainDate"],"mappings":"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"}

package/dist/internal/durationKey.d.ts

@@ -0,0 +1,5 @@
+import type { TemporalDurationLike } from '../types';
+/** Stable string key for `Temporal.DurationLike` values in hook dependency arrays. */
+export declare function durationKey(duration: TemporalDurationLike): string;
+/** Milliseconds for a duration-like value (for timers). */
+export declare function durationToMilliseconds(duration: TemporalDurationLike): number;

package/dist/internal/useLatest.d.ts

@@ -0,0 +1,2 @@
+/** Keeps a ref to the latest value (for callbacks inside intervals/timeouts). */
+export declare function useLatest<T>(value: T): import("react").RefObject<T>;

package/dist/internal/useTemporalTicker.d.ts

@@ -0,0 +1,11 @@
+export interface UseTemporalTickerOptions<T> {
+    intervalMs: number;
+    getSnapshot: () => T;
+    /** When true, pauses updates while `document.hidden` (browser only). */
+    pauseWhenHidden?: boolean;
+    enabled?: boolean;
+}
+/**
+ * Shared interval driver for live clock hooks.
+ */
+export declare function useTemporalTicker<T>({ intervalMs, getSnapshot, pauseWhenHidden, enabled, }: UseTemporalTickerOptions<T>): T;

package/dist/temporal.d.ts

@@ -0,0 +1,20 @@
+import { Temporal as TemporalPolyfill } from 'temporal-polyfill';
+export type TemporalNamespace = typeof TemporalPolyfill;
+declare global {
+    var Temporal: TemporalNamespace | undefined;
+}
+/**
+ * True when the host exposes a native `globalThis.Temporal` implementation.
+ */
+export declare function hasNativeTemporal(): boolean;
+/**
+ * Returns the Temporal namespace, preferring native host support
+ * (Chrome 144+, Firefox 139+, Edge 144+, Node.js 26+) and falling back to
+ * `temporal-polyfill` (smaller, spec-current) when native is missing.
+ *
+ * You may still install `@js-temporal/polyfill` in your app for typing or tooling;
+ * this package does not load it automatically.
+ */
+export declare function getTemporal(): TemporalNamespace;
+/** Cached Temporal namespace for hot paths inside hooks. */
+export declare const Temporal: TemporalNamespace;

package/dist/types.d.ts

@@ -0,0 +1,35 @@
+import type { Temporal } from 'temporal-polyfill';
+/** Temporal namespace types (for annotations). Value access via `import { Temporal } from '@charlite/react-temporal'`. */
+export type TemporalTypes = typeof Temporal;
+export type TemporalInstant = Temporal.Instant;
+export type TemporalPlainDate = Temporal.PlainDate;
+export type TemporalPlainTime = Temporal.PlainTime;
+export type TemporalPlainDateTime = Temporal.PlainDateTime;
+export type TemporalZonedDateTime = Temporal.ZonedDateTime;
+export type TemporalDuration = Temporal.Duration;
+export type TemporalDurationLike = Temporal.DurationLike;
+export interface UseTemporalNowOptions {
+    /** Tick interval in milliseconds. Defaults to 1000. */
+    intervalMs?: number;
+    /** IANA time zone for zoned output. When set, returns ZonedDateTime instead of Instant. */
+    timeZone?: string;
+    /** Pause ticking while the document is hidden (browser). */
+    pauseWhenHidden?: boolean;
+}
+export interface UseTemporalClockOptions {
+    /** Tick interval in milliseconds. Defaults to 1000. */
+    intervalMs?: number;
+    pauseWhenHidden?: boolean;
+}
+export interface UseTemporalCountdownOptions {
+    /** Update interval in milliseconds. Defaults to 1000. */
+    intervalMs?: number;
+    /** Called once when the target instant is reached or passed. */
+    onComplete?: () => void;
+}
+export type TemporalParseKind = 'instant' | 'plainDate' | 'plainTime' | 'plainDateTime' | 'zonedDateTime';
+export type TemporalParsedValue<K extends TemporalParseKind> = K extends 'instant' ? TemporalInstant : K extends 'plainDate' ? TemporalPlainDate : K extends 'plainTime' ? TemporalPlainTime : K extends 'plainDateTime' ? TemporalPlainDateTime : TemporalZonedDateTime;
+export interface TemporalSafeParseResult<T> {
+    value: T | null;
+    error: Error | null;
+}

package/dist/utils/formatRelative.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Formats the span from `from` to `to` with Intl.RelativeTimeFormat.
+ * Chooses the coarsest unit that still represents the span without awkward rounding
+ * (e.g. 90 minutes instead of 2 hours).
+ */
+export declare function formatRelativeTime(totalSeconds: number, locales?: string | string[], options?: Intl.RelativeTimeFormatOptions): string;

package/dist/utils/parseTemporal.d.ts

@@ -0,0 +1,2 @@
+import type { TemporalParseKind, TemporalParsedValue } from '../types';
+export declare function parseTemporal<K extends TemporalParseKind>(kind: K, input: string): TemporalParsedValue<K>;

package/docs/README.md

@@ -0,0 +1,53 @@
+# react-temporal Documentation
+
+React hooks for date and time built on the JavaScript [Temporal API](https://tc39.es/proposal-temporal/).
+
+## Table of contents
+
+| Document | Description |
+| --- | --- |
+| [Getting started](./getting-started.md) | Install, configure, and write your first component |
+| [Installation](./installation.md) | Package managers, peer dependencies, and polyfill options |
+| [Polyfill guide](./polyfill.md) | Native vs polyfill runtime, SSR, and browser support |
+| [API reference](./api-reference.md) | Every hook, utility, and type export |
+| [TypeScript](./typescript.md) | Type imports, generics, and IDE support |
+| [Migration guide](./migration.md) | Upgrading across major versions |
+| [Examples](../examples/README.md) | Copy-paste React components for each hook |
+| [Agent knowledge (OKF)](../knowledge/index.md) | OKF v0.2 bundle for AI agents |
+
+## Quick reference
+
+```tsx
+import {
+  useTemporalNow,
+  useTemporalZonedNow,
+  useTemporalRelative,
+  Temporal,
+} from '@charlite/react-temporal';
+
+function Dashboard() {
+  const now = useTemporalNow();
+  const tokyo = useTemporalZonedNow('Asia/Tokyo');
+  const deadline = Temporal.Instant.from('2026-12-31T23:59:59Z');
+  const relative = useTemporalRelative(Temporal.Now.instant(), deadline, 'en');
+
+  return (
+    <div>
+      <p>UTC: {now.toString()}</p>
+      <p>Tokyo: {tokyo.toLocaleString()}</p>
+      <p>Deadline: {relative}</p>
+    </div>
+  );
+}
+```
+
+## Requirements
+
+- **Node.js** 26+ (development and CI)
+- **React** 17, 18, or 19
+- **Temporal** — native in modern browsers and Node.js 26+, or a polyfill elsewhere (see [Polyfill guide](./polyfill.md))
+
+## Support
+
+- [GitHub Issues](https://github.com/charlite/react-temporal/issues)
+- [Changelog](../CHANGELOG.md)