@wzrhine/react 0.0.0-stage → 0.1.0

package/dist/index.js

@@ -0,0 +1,61 @@
+// Side-effect free: styles are opt-in via `@wzrhine/tokens/styles.css` and `@wzrhine/react/styles.css`.
+export { Button } from './components/Button.js';
+export { Surface } from './components/Surface.js';
+export { StatusBadge } from './components/StatusBadge.js';
+export { IconButton } from './components/IconButton.js';
+export { Text } from './components/Text.js';
+export { Field } from './components/Field.js';
+export { Input } from './components/Input.js';
+export { Textarea } from './components/Textarea.js';
+export { Checkbox, CheckboxGroup } from './components/Checkbox.js';
+export { Radio, RadioGroup } from './components/Radio.js';
+export { Switch } from './components/Switch.js';
+export { Form } from './components/Form.js';
+export { Fieldset } from './components/Fieldset.js';
+export { Separator } from './components/Separator.js';
+export { VisuallyHidden } from './components/VisuallyHidden.js';
+export { Tabs, TabList, Tab, TabPanel } from './components/Tabs.js';
+export { Tooltip } from './components/Tooltip.js';
+export { Dialog, DialogClose } from './components/Dialog.js';
+export { Select } from './components/Select.js';
+export { Popover, PopoverClose } from './components/Popover.js';
+export { Menu, MenuCheckboxItem, MenuGroup, MenuItem, MenuRadioGroup, MenuRadioItem, MenuSeparator, } from './components/Menu.js';
+export { ToastProvider, ToastViewport, useToast } from './components/Toast.js';
+export { MetadataList } from './components/MetadataList.js';
+export { Pagination } from './components/Pagination.js';
+export { getPaginationItems, paginate } from './components/pagination-utils.js';
+export { Breadcrumb } from './components/Breadcrumb.js';
+export { Progress, Meter } from './components/Progress.js';
+export { getMeterState } from './components/meter-utils.js';
+export { Stat } from './components/Stat.js';
+export { AlertDialog } from './components/AlertDialog.js';
+export { Drawer, DrawerClose } from './components/Drawer.js';
+export { Alert, Callout } from './components/Alert.js';
+export { EmptyState } from './components/EmptyState.js';
+export { Skeleton } from './components/Skeleton.js';
+export { Spinner } from './components/Spinner.js';
+export { Collapsible } from './components/Collapsible.js';
+export { Accordion, AccordionItem } from './components/Accordion.js';
+export { Slider } from './components/Slider.js';
+export { NumberField } from './components/NumberField.js';
+export { ContextMenu } from './components/ContextMenu.js';
+export { Combobox } from './components/Combobox.js';
+export { CommandPalette, matchHotkey } from './components/CommandPalette.js';
+export { SplitButton } from './components/SplitButton.js';
+export { ScrollArea } from './components/ScrollArea.js';
+export { FileDropZone, matchesAccept, validateFiles } from './components/FileDropZone.js';
+export { DataTable } from './components/DataTable.js';
+export { ArchiveCard } from './components/ArchiveCard.js';
+export { StatusIndicator } from './components/StatusIndicator.js';
+export { Timeline } from './components/Timeline.js';
+export { RecordHeader } from './components/RecordHeader.js';
+export { RhineProvider, usePortalContainer } from './provider/RhineProvider.js';
+export { RhineMessagesProvider, enUS, useRhineLocale, useRhineMessages, zhCN } from './provider/messages.js';
+export { duration, ease, fadePresence, pressScale, transition } from './motion/presets.js';
+export { useRhineMotion } from './motion/useRhineMotion.js';
+export { MotionSpeed, resolveMotion, useMotionSpeed } from './motion/resolve.js';
+export { MotionPresence, RhineMotionGroup, RhineMotionItem } from './motion/presence.js';
+export { useInViewport, usePageVisible } from './motion/visibility.js';
+export { useLatestGuard, useMotionLifecycle } from './motion/lifecycle.js';
+export { ArchiveIdentity } from './components/ArchiveCard.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/motion/lifecycle.d.ts

@@ -0,0 +1,44 @@
+import * as React from 'react';
+export type MotionLifecycleState = 'idle' | 'running' | 'paused' | 'stopped';
+export type MotionPauseReason = 'manual' | 'hidden' | 'offscreen' | 'reduced';
+export interface MotionLifecycleOptions {
+    /** Controlled request. When set, it overrides `start()` / `stop()`. */
+    active?: boolean;
+    /** Start on mount (uncontrolled only). */
+    autoStart?: boolean;
+    /** Pause while this element is outside the viewport. */
+    viewportRef?: React.RefObject<Element | null>;
+    /** Extra reduced-motion signal (e.g. an effect clock forcing reduce). OS / provider preference always applies. */
+    reduced?: boolean;
+}
+export interface MotionLifecycle {
+    state: MotionLifecycleState;
+    /** True only in `running`; drive the loop from this. */
+    running: boolean;
+    /** Why a requested loop is not running; `null` when running, idle or stopped. */
+    pauseReason: MotionPauseReason | null;
+    start: () => void;
+    pause: () => void;
+    resume: () => void;
+    stop: () => void;
+}
+export declare function useMotionLifecycle({ active, autoStart, viewportRef, reduced: forceReduced }?: MotionLifecycleOptions): MotionLifecycle;
+export interface LatestGuard {
+    /** Begin a new async run; the returned check is true until a newer run begins, `cancel()` or unmount. */
+    begin: () => () => boolean;
+    /** Invalidate every pending run (e.g. when the dialog that started it closes). */
+    cancel: () => void;
+}
+/**
+ * Stale async result guard (MOTION.md lifecycle rule 2): a late response must not reopen a dialog
+ * or overwrite newer state.
+ *
+ * ```ts
+ * const guard = useLatestGuard();
+ * const isCurrent = guard.begin();
+ * const data = await load();
+ * if (!isCurrent()) return;
+ * ```
+ */
+export declare function useLatestGuard(): LatestGuard;
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/motion/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/motion/lifecycle.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAU/B,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;AAC7E,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,CAAC;AAE9E,MAAM,WAAW,sBAAsB;IACrC,uEAAuE;IACvE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,wDAAwD;IACxD,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAC9C,kHAAkH;IAClH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,oBAAoB,CAAC;IAC5B,wDAAwD;IACxD,OAAO,EAAE,OAAO,CAAC;IACjB,iFAAiF;IACjF,WAAW,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACtC,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB;AAID,wBAAgB,kBAAkB,CAAC,EAAE,MAAM,EAAE,SAAiB,EAAE,WAAW,EAAE,OAAO,EAAE,YAAoB,EAAE,GAAE,sBAA2B,GAAG,eAAe,CAkC1J;AAED,MAAM,WAAW,WAAW;IAC1B,yGAAyG;IACzG,KAAK,EAAE,MAAM,MAAM,OAAO,CAAC;IAC3B,kFAAkF;IAClF,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAsB5C"}

package/dist/motion/lifecycle.js

@@ -0,0 +1,73 @@
+'use client';
+import * as React from 'react';
+import { useReducedMotionConfig } from 'motion/react';
+import { useInViewport, usePageVisible } from './visibility.js';
+const noRef = { current: null };
+export function useMotionLifecycle({ active, autoStart = false, viewportRef, reduced: forceReduced = false } = {}) {
+    const [requested, setRequested] = React.useState(autoStart);
+    const [everStarted, setEverStarted] = React.useState(autoStart);
+    const [manualPause, setManualPause] = React.useState(false);
+    const visible = usePageVisible();
+    const inView = useInViewport(viewportRef ?? noRef);
+    const reduced = useReducedMotionConfig() === true || forceReduced;
+    const isRequested = active ?? requested;
+    const started = active === undefined ? everStarted : everStarted || active;
+    if (active && !everStarted)
+        setEverStarted(true);
+    let pauseReason = null;
+    if (isRequested) {
+        if (reduced)
+            pauseReason = 'reduced';
+        else if (manualPause)
+            pauseReason = 'manual';
+        else if (!visible)
+            pauseReason = 'hidden';
+        else if (viewportRef && !inView)
+            pauseReason = 'offscreen';
+    }
+    const state = !isRequested ? (started ? 'stopped' : 'idle') : pauseReason ? 'paused' : 'running';
+    const start = React.useCallback(() => {
+        setRequested(true);
+        setEverStarted(true);
+        setManualPause(false);
+    }, []);
+    const stop = React.useCallback(() => {
+        setRequested(false);
+        setManualPause(false);
+    }, []);
+    const pause = React.useCallback(() => setManualPause(true), []);
+    const resume = React.useCallback(() => setManualPause(false), []);
+    return { state, running: state === 'running', pauseReason, start, pause, resume, stop };
+}
+/**
+ * Stale async result guard (MOTION.md lifecycle rule 2): a late response must not reopen a dialog
+ * or overwrite newer state.
+ *
+ * ```ts
+ * const guard = useLatestGuard();
+ * const isCurrent = guard.begin();
+ * const data = await load();
+ * if (!isCurrent()) return;
+ * ```
+ */
+export function useLatestGuard() {
+    const generation = React.useRef(0);
+    React.useEffect(() => {
+        // Re-arm after StrictMode's simulated unmount; invalidate on the real one.
+        generation.current += 1;
+        return () => {
+            generation.current += 1;
+        };
+    }, []);
+    return React.useMemo(() => ({
+        begin: () => {
+            generation.current += 1;
+            const mine = generation.current;
+            return () => generation.current === mine;
+        },
+        cancel: () => {
+            generation.current += 1;
+        },
+    }), []);
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/motion/lifecycle.js.map

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

package/dist/motion/presence.d.ts

@@ -0,0 +1,69 @@
+import * as React from 'react';
+import type { Variants } from 'motion/react';
+type MotionConflictingProps = 'onDrag' | 'onDragStart' | 'onDragEnd' | 'onAnimationStart' | 'onAnimationEnd' | 'onAnimationIteration';
+type ElementProps = Omit<React.HTMLAttributes<HTMLElement>, MotionConflictingProps | 'children'>;
+declare const tags: {
+    readonly div: import("motion/react").ForwardRefComponent<HTMLDivElement, import("motion/react").HTMLMotionProps<"div">>;
+    readonly section: import("motion/react").ForwardRefComponent<HTMLElement, import("motion/react").HTMLMotionProps<"section">>;
+    readonly span: import("motion/react").ForwardRefComponent<HTMLSpanElement, import("motion/react").HTMLMotionProps<"span">>;
+    readonly ul: import("motion/react").ForwardRefComponent<HTMLUListElement, import("motion/react").HTMLMotionProps<"ul">>;
+    readonly ol: import("motion/react").ForwardRefComponent<HTMLOListElement, import("motion/react").HTMLMotionProps<"ol">>;
+    readonly li: import("motion/react").ForwardRefComponent<HTMLLIElement, import("motion/react").HTMLMotionProps<"li">>;
+};
+/**
+ * - `fade`: opacity only, `fast` — tooltips, inline status swaps.
+ * - `panel`: opacity + 8px rise, `panel` — detail layers, dialogs, sheets.
+ * - `rise`: opacity + 4px rise, `base` — list items, inline feedback.
+ */
+export type MotionPresencePreset = 'fade' | 'panel' | 'rise';
+/** Variants for one preset. Reduced motion drops the offset and keeps a short opacity fade. */
+export declare function presenceVariants(preset: MotionPresencePreset, reduced: boolean, speed?: number): Variants;
+export type MotionPresenceProps = ElementProps & {
+    /** Mount (true) or animate out and unmount (false). */
+    show: boolean;
+    preset?: MotionPresencePreset;
+    /** Animate on first render too. Off by default: content present at load just appears. */
+    initial?: boolean;
+    /** Element rendered for the animated wrapper. */
+    as?: keyof typeof tags;
+    /** Fires after the exit animation, once the content has unmounted. */
+    onExitComplete?: () => void;
+    children?: React.ReactNode;
+};
+/**
+ * Enter / exit wrapper over `AnimatePresence`. Toggling `show` mid-flight reverses from the
+ * current visual state (no queued animations). Hidden content is unmounted, so it never lingers
+ * in the accessibility tree.
+ */
+export declare function MotionPresence({ show, preset, initial, as, onExitComplete, children, ...rest }: MotionPresenceProps): React.JSX.Element;
+/** Per-item stagger step and total cap (MOTION.md: 20–30ms per item, capped). */
+export declare const staggerStepMs = 24;
+export declare const staggerMaxMs: number;
+/** Delay (seconds) for the item at `index`. Zero under reduced motion. */
+export declare function staggerDelay(index: number, reduced: boolean, speed?: number): number;
+export type RhineMotionGroupProps = ElementProps & {
+    /** Mount (true) with staggered items, or fade the whole group out and unmount (false). */
+    show?: boolean;
+    /** Item preset. */
+    preset?: 'fade' | 'rise';
+    /** Animate on first render too. Off by default. */
+    initial?: boolean;
+    as?: 'div' | 'section' | 'ul' | 'ol';
+    onExitComplete?: () => void;
+    /** `RhineMotionItem` children; their order sets the stagger. */
+    children?: React.ReactNode;
+};
+/**
+ * Staggered entrance for a short group (≤ ~8 items). Item n waits n × 24ms, capped at the
+ * `fast` token (120ms) so long lists never trickle in; reduced motion removes the stagger and
+ * the offset. Exit is one group fade, never a reverse cascade.
+ */
+export declare function RhineMotionGroup({ show, preset, initial, as, onExitComplete, children, ...rest }: RhineMotionGroupProps): React.JSX.Element;
+export type RhineMotionItemProps = ElementProps & {
+    as?: 'div' | 'li' | 'span';
+    children?: React.ReactNode;
+};
+/** One staggered item; must be a direct child of `RhineMotionGroup`. */
+export declare function RhineMotionItem({ as, children, ...rest }: RhineMotionItemProps): React.JSX.Element;
+export {};
+//# sourceMappingURL=presence.d.ts.map

package/dist/motion/presence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presence.d.ts","sourceRoot":"","sources":["../../src/motion/presence.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAc,QAAQ,EAAE,MAAM,cAAc,CAAC;AAYzD,KAAK,sBAAsB,GACvB,QAAQ,GACR,aAAa,GACb,WAAW,GACX,kBAAkB,GAClB,gBAAgB,GAChB,sBAAsB,CAAC;AAE3B,KAAK,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,sBAAsB,GAAG,UAAU,CAAC,CAAC;AAEjG,QAAA,MAAM,IAAI;;;;;;;CAOA,CAAC;AAEX;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAQ7D,+FAA+F;AAC/F,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,oBAAoB,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,SAAI,GAAG,QAAQ,CAUpG;AAED,MAAM,MAAM,mBAAmB,GAAG,YAAY,GAAG;IAC/C,uDAAuD;IACvD,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,yFAAyF;IACzF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iDAAiD;IACjD,EAAE,CAAC,EAAE,MAAM,OAAO,IAAI,CAAC;IACvB,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAC7B,IAAI,EACJ,MAAe,EACf,OAAe,EACf,EAAU,EACV,cAAc,EACd,QAAQ,EACR,GAAG,IAAI,EACR,EAAE,mBAAmB,qBAqBrB;AAED,iFAAiF;AACjF,eAAO,MAAM,aAAa,KAAK,CAAC;AAChC,eAAO,MAAM,YAAY,QAAuB,CAAC;AAEjD,0EAA0E;AAC1E,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,SAAI,GAAG,MAAM,CAG/E;AAKD,MAAM,MAAM,qBAAqB,GAAG,YAAY,GAAG;IACjD,0FAA0F;IAC1F,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,mBAAmB;IACnB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,mDAAmD;IACnD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,EAAE,CAAC,EAAE,KAAK,GAAG,SAAS,GAAG,IAAI,GAAG,IAAI,CAAC;IACrC,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B,gEAAgE;IAChE,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,IAAW,EACX,MAAe,EACf,OAAe,EACf,EAAU,EACV,cAAc,EACd,QAAQ,EACR,GAAG,IAAI,EACR,EAAE,qBAAqB,qBAyBvB;AAED,MAAM,MAAM,oBAAoB,GAAG,YAAY,GAAG;IAChD,EAAE,CAAC,EAAE,KAAK,GAAG,IAAI,GAAG,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B,CAAC;AAEF,wEAAwE;AACxE,wBAAgB,eAAe,CAAC,EAAE,EAAU,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,EAAE,oBAAoB,qBAwBtF"}

package/dist/motion/presence.js

@@ -0,0 +1,103 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createElement as _createElement } from "react";
+import * as React from 'react';
+import { AnimatePresence, motion } from 'motion/react';
+import { duration } from './presets.js';
+import { resolveMotion } from './resolve.js';
+import { useRhineMotion } from './useRhineMotion.js';
+const tags = {
+    div: motion.div,
+    section: motion.section,
+    span: motion.span,
+    ul: motion.ul,
+    ol: motion.ol,
+    li: motion.li,
+};
+const presenceSpec = {
+    fade: { name: 'fast', offset: 0 },
+    panel: { name: 'panel', offset: 8 },
+    rise: { name: 'base', offset: 4 },
+};
+/** Variants for one preset. Reduced motion drops the offset and keeps a short opacity fade. */
+export function presenceVariants(preset, reduced, speed = 1) {
+    const { name, offset } = presenceSpec[preset];
+    const y = reduced ? 0 : offset;
+    const opacity = resolveMotion('opacity', name, reduced, speed);
+    const move = resolveMotion('transform', name, reduced, speed);
+    const both = { opacity, y: move };
+    return {
+        hidden: { opacity: 0, y, transition: both },
+        visible: { opacity: 1, y: 0, transition: both },
+    };
+}
+/**
+ * Enter / exit wrapper over `AnimatePresence`. Toggling `show` mid-flight reverses from the
+ * current visual state (no queued animations). Hidden content is unmounted, so it never lingers
+ * in the accessibility tree.
+ */
+export function MotionPresence({ show, preset = 'fade', initial = false, as = 'div', onExitComplete, children, ...rest }) {
+    const { reduced, speed } = useRhineMotion();
+    const variants = presenceVariants(preset, reduced, speed);
+    const Comp = tags[as];
+    return (_jsx(AnimatePresence, { initial: initial, onExitComplete: onExitComplete, children: show && (_createElement(Comp, { ...rest, key: "rl-presence", "data-rl-presence": preset, variants: variants, initial: "hidden", animate: "visible", exit: "hidden" }, children)) }));
+}
+/** Per-item stagger step and total cap (MOTION.md: 20–30ms per item, capped). */
+export const staggerStepMs = 24;
+export const staggerMaxMs = duration.fast * 1000;
+/** Delay (seconds) for the item at `index`. Zero under reduced motion. */
+export function staggerDelay(index, reduced, speed = 1) {
+    if (reduced || index <= 0)
+        return 0;
+    return Math.min(index * staggerStepMs, staggerMaxMs) / 1000 / speed;
+}
+const GroupContext = React.createContext(null);
+const ItemIndexContext = React.createContext(0);
+/**
+ * Staggered entrance for a short group (≤ ~8 items). Item n waits n × 24ms, capped at the
+ * `fast` token (120ms) so long lists never trickle in; reduced motion removes the stagger and
+ * the offset. Exit is one group fade, never a reverse cascade.
+ */
+export function RhineMotionGroup({ show = true, preset = 'rise', initial = false, as = 'div', onExitComplete, children, ...rest }) {
+    const { reduced, speed } = useRhineMotion();
+    const Comp = tags[as];
+    const fadeOut = resolveMotion('opacity', 'fast', reduced, speed);
+    const container = {
+        hidden: { opacity: 1 },
+        visible: { opacity: 1 },
+        exit: { opacity: 0, transition: fadeOut },
+    };
+    const value = React.useMemo(() => ({ preset }), [preset]);
+    let index = 0;
+    const items = React.Children.map(children, (child) => {
+        if (!React.isValidElement(child))
+            return child;
+        const i = index++;
+        return _jsx(ItemIndexContext.Provider, { value: i, children: child });
+    });
+    return (_jsx(AnimatePresence, { initial: initial, onExitComplete: onExitComplete, children: show && (_createElement(Comp, { ...rest, key: "rl-group", "data-rl-motion-group": "", variants: container, initial: "hidden", animate: "visible", exit: "exit" },
+            _jsx(GroupContext.Provider, { value: value, children: items }))) }));
+}
+/** One staggered item; must be a direct child of `RhineMotionGroup`. */
+export function RhineMotionItem({ as = 'div', children, ...rest }) {
+    const group = React.useContext(GroupContext);
+    const index = React.useContext(ItemIndexContext);
+    const { reduced, speed } = useRhineMotion();
+    const Comp = tags[as];
+    const base = presenceVariants(group?.preset ?? 'rise', reduced, speed);
+    const delay = staggerDelay(index, reduced, speed);
+    const visible = base.visible;
+    const variants = {
+        hidden: base.hidden,
+        visible: {
+            ...visible,
+            transition: {
+                opacity: { ...visible.transition.opacity, delay },
+                y: { ...visible.transition.y, delay },
+            },
+        },
+        exit: {},
+    };
+    return (_jsx(Comp, { ...rest, "data-rl-motion-item": index, variants: variants, children: children }));
+}
+//# sourceMappingURL=presence.js.map

package/dist/motion/presence.js.map

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

package/dist/motion/presets.d.ts

@@ -0,0 +1,63 @@
+import type { MotionDurationName } from '@wzrhine/tokens';
+/** Duration tokens in seconds, derived from the shared token manifest. */
+export declare const duration: Record<MotionDurationName, number>;
+export declare const ease: {
+    readonly out: [number, number, number, number];
+    readonly inOut: [number, number, number, number];
+    readonly linear: "linear";
+};
+/** Named transitions. Components import these instead of writing their own numbers. */
+export declare const transition: {
+    readonly press: {
+        readonly duration: number;
+        readonly ease: [number, number, number, number];
+    };
+    readonly release: {
+        readonly duration: number;
+        readonly ease: [number, number, number, number];
+    };
+    readonly fast: {
+        readonly duration: number;
+        readonly ease: [number, number, number, number];
+    };
+    readonly base: {
+        readonly duration: number;
+        readonly ease: [number, number, number, number];
+    };
+    readonly panel: {
+        readonly duration: number;
+        readonly ease: [number, number, number, number];
+    };
+    readonly scene: {
+        readonly duration: number;
+        readonly ease: [number, number, number, number];
+    };
+    /** User-triggered showcase scenes only (MOTION.md); never on a base component. */
+    readonly showcase: {
+        readonly duration: number;
+        readonly ease: [number, number, number, number];
+    };
+    readonly loop: {
+        readonly duration: number;
+        readonly ease: "linear";
+        readonly repeat: number;
+    };
+    readonly instant: {
+        readonly duration: 0;
+    };
+};
+/** Press feedback: ≤1.5% scale, no layout shift, no hit-area change. */
+export declare const pressScale = 0.985;
+/** Short presence fade used by inline feedback (spinner, status swap). */
+export declare const fadePresence: {
+    readonly initial: {
+        readonly opacity: 0;
+    };
+    readonly animate: {
+        readonly opacity: 1;
+    };
+    readonly exit: {
+        readonly opacity: 0;
+    };
+};
+//# sourceMappingURL=presets.d.ts.map

package/dist/motion/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../src/motion/presets.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,0EAA0E;AAC1E,eAAO,MAAM,QAAQ,EAEhB,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC;AAExC,eAAO,MAAM,IAAI;kBACgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;oBAC5B,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;;CAE3D,CAAC;AAEX,uFAAuF;AACvF,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;IAOrB,kFAAkF;;;;;;;;;;;;;CAIrC,CAAC;AAEhD,wEAAwE;AACxE,eAAO,MAAM,UAAU,QAAQ,CAAC;AAEhC,0EAA0E;AAC1E,eAAO,MAAM,YAAY;;;;;;;;;;CAIf,CAAC"}

package/dist/motion/presets.js

@@ -0,0 +1,30 @@
+import { motionDurations, motionEasings, motionLoopMs } from '@wzrhine/tokens';
+/** Duration tokens in seconds, derived from the shared token manifest. */
+export const duration = Object.fromEntries(Object.entries(motionDurations).map(([name, ms]) => [name, ms / 1000]));
+export const ease = {
+    out: [...motionEasings.out],
+    inOut: [...motionEasings.inOut],
+    linear: 'linear',
+};
+/** Named transitions. Components import these instead of writing their own numbers. */
+export const transition = {
+    press: { duration: duration.press, ease: ease.out },
+    release: { duration: duration.fast, ease: ease.out },
+    fast: { duration: duration.fast, ease: ease.out },
+    base: { duration: duration.base, ease: ease.out },
+    panel: { duration: duration.panel, ease: ease.out },
+    scene: { duration: duration.scene, ease: ease.inOut },
+    /** User-triggered showcase scenes only (MOTION.md); never on a base component. */
+    showcase: { duration: duration.showcase, ease: ease.inOut },
+    loop: { duration: motionLoopMs / 1000, ease: 'linear', repeat: Infinity },
+    instant: { duration: 0 },
+};
+/** Press feedback: ≤1.5% scale, no layout shift, no hit-area change. */
+export const pressScale = 0.985;
+/** Short presence fade used by inline feedback (spinner, status swap). */
+export const fadePresence = {
+    initial: { opacity: 0 },
+    animate: { opacity: 1 },
+    exit: { opacity: 0 },
+};
+//# sourceMappingURL=presets.js.map

package/dist/motion/presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.js","sourceRoot":"","sources":["../../src/motion/presets.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAG/E,0EAA0E;AAC1E,MAAM,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CACxC,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC,CACjC,CAAC;AAExC,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,GAAG,EAAE,CAAC,GAAG,aAAa,CAAC,GAAG,CAAqC;IAC/D,KAAK,EAAE,CAAC,GAAG,aAAa,CAAC,KAAK,CAAqC;IACnE,MAAM,EAAE,QAAQ;CACR,CAAC;AAEX,uFAAuF;AACvF,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,KAAK,EAAE,EAAE,QAAQ,EAAE,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE;IACnD,OAAO,EAAE,EAAE,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE;IACpD,IAAI,EAAE,EAAE,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE;IACjD,IAAI,EAAE,EAAE,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE;IACjD,KAAK,EAAE,EAAE,QAAQ,EAAE,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE;IACnD,KAAK,EAAE,EAAE,QAAQ,EAAE,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE;IACrD,kFAAkF;IAClF,QAAQ,EAAE,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE;IAC3D,IAAI,EAAE,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE;IACzE,OAAO,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE;CACqB,CAAC;AAEhD,wEAAwE;AACxE,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,CAAC;AAEhC,0EAA0E;AAC1E,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE;IACvB,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE;IACvB,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE;CACZ,CAAC"}

package/dist/motion/resolve.d.ts

@@ -0,0 +1,31 @@
+import * as React from 'react';
+import type { Transition } from 'motion/react';
+import { transition } from './presets.js';
+/** Named preset keys (`instant` … `showcase`, plus `press`/`release`/`loop`). */
+export type RhineTransitionName = keyof typeof transition;
+/**
+ * What a transition animates. Reduced motion degrades by kind (ADR-0007):
+ * - `color` / `opacity`: keep a short fade, never longer than `fast`;
+ * - `transform` / `layout`: jump straight to the target;
+ * - `loop`: stop (instant, no repeat).
+ */
+export type MotionPropertyKind = 'color' | 'opacity' | 'transform' | 'layout' | 'loop';
+/**
+ * Resolve a named preset for one kind of property. Pure: pass `reduced` from `useRhineMotion()`
+ * (or use its `resolve`, which does this for you). `speed` < 1 slows the result down (showcase review only);
+ * it never lengthens the reduced fallback, which stays within the `fast` token.
+ */
+export declare function resolveMotion(kind: MotionPropertyKind, name: RhineTransitionName, reduced: boolean, speed?: number): Transition;
+export interface MotionSpeedProps {
+    /** 0.25 = four times slower. Values ≤ 0 are ignored. */
+    speed: number;
+    children: React.ReactNode;
+}
+/**
+ * Slows every `useRhineMotion()` transition in this subtree. Review and showcase only
+ * (e.g. the motion player's Slow ×0.25 lane); never ship it in a product view.
+ */
+export declare function MotionSpeed({ speed, children }: MotionSpeedProps): React.JSX.Element;
+/** Current review speed (1 outside a `MotionSpeed`). */
+export declare function useMotionSpeed(): number;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/motion/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/motion/resolve.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAkB,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1D,iFAAiF;AACjF,MAAM,MAAM,mBAAmB,GAAG,MAAM,OAAO,UAAU,CAAC;AAE1D;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAC;AASvF;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,SAAI,GAAG,UAAU,CAU1H;AAID,MAAM,WAAW,gBAAgB;IAC/B,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,gBAAgB,qBAEhE;AAED,wDAAwD;AACxD,wBAAgB,cAAc,IAAI,MAAM,CAEvC"}

package/dist/motion/resolve.js

@@ -0,0 +1,40 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import * as React from 'react';
+import { duration, ease, transition } from './presets.js';
+function scaleTransition(t, speed) {
+    if (speed === 1 || !t.duration)
+        return t;
+    return { ...t, duration: t.duration / speed };
+}
+/**
+ * Resolve a named preset for one kind of property. Pure: pass `reduced` from `useRhineMotion()`
+ * (or use its `resolve`, which does this for you). `speed` < 1 slows the result down (showcase review only);
+ * it never lengthens the reduced fallback, which stays within the `fast` token.
+ */
+export function resolveMotion(kind, name, reduced, speed = 1) {
+    const preset = transition[name];
+    if (!reduced)
+        return scaleTransition(preset, speed);
+    if (kind === 'color' || kind === 'opacity') {
+        const ms = Math.min(preset.duration ?? 0, duration.fast);
+        if (ms === 0 || 'repeat' in preset)
+            return transition.instant;
+        // Review speed never stretches the reduced fallback: reduce wins over Slow ×0.25.
+        return { duration: ms, ease: ease.out };
+    }
+    return transition.instant;
+}
+const MotionSpeedContext = React.createContext(1);
+/**
+ * Slows every `useRhineMotion()` transition in this subtree. Review and showcase only
+ * (e.g. the motion player's Slow ×0.25 lane); never ship it in a product view.
+ */
+export function MotionSpeed({ speed, children }) {
+    return _jsx(MotionSpeedContext.Provider, { value: speed > 0 ? speed : 1, children: children });
+}
+/** Current review speed (1 outside a `MotionSpeed`). */
+export function useMotionSpeed() {
+    return React.useContext(MotionSpeedContext);
+}
+//# sourceMappingURL=resolve.js.map

package/dist/motion/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../src/motion/resolve.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAe1D,SAAS,eAAe,CAAC,CAAkB,EAAE,KAAa;IACxD,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ;QAAE,OAAO,CAAC,CAAC;IACzC,OAAO,EAAE,GAAG,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,GAAG,KAAK,EAAE,CAAC;AAChD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,IAAwB,EAAE,IAAyB,EAAE,OAAgB,EAAE,KAAK,GAAG,CAAC;IAC5G,MAAM,MAAM,GAAoB,UAAU,CAAC,IAAI,CAAC,CAAC;IACjD,IAAI,CAAC,OAAO;QAAE,OAAO,eAAe,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACpD,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QAC3C,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,CAAC,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;QACzD,IAAI,EAAE,KAAK,CAAC,IAAI,QAAQ,IAAI,MAAM;YAAE,OAAO,UAAU,CAAC,OAAO,CAAC;QAC9D,kFAAkF;QAClF,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC;IAC1C,CAAC;IACD,OAAO,UAAU,CAAC,OAAO,CAAC;AAC5B,CAAC;AAED,MAAM,kBAAkB,GAAG,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;AAQlD;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAoB;IAC/D,OAAO,KAAC,kBAAkB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,YAAG,QAAQ,GAA+B,CAAC;AAC7G,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,cAAc;IAC5B,OAAO,KAAK,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC;AAC9C,CAAC"}

package/dist/motion/useRhineMotion.d.ts

@@ -0,0 +1,19 @@
+import type { Transition } from 'motion/react';
+import type { MotionPropertyKind, RhineTransitionName } from './resolve.js';
+export type { RhineTransitionName } from './resolve.js';
+export interface RhineMotion {
+    /** True when the OS preference or the nearest `<MotionConfig reducedMotion>` asks for reduced motion. */
+    reduced: boolean;
+    /** Review speed from the nearest `MotionSpeed` (1 by default). */
+    speed: number;
+    /** Returns the named preset, or an instant transition when motion is reduced. */
+    get: (name: RhineTransitionName) => Transition;
+    /** Returns the named preset degraded for one property kind (ADR-0007): colour / opacity keep a short fade. */
+    resolve: (kind: MotionPropertyKind, name: RhineTransitionName) => Transition;
+}
+/**
+ * Single entry point for component motion. Honours `<MotionConfig reducedMotion="user" | "always" | "never">`
+ * so apps (and the showcase) can force either mode.
+ */
+export declare function useRhineMotion(): RhineMotion;
+//# sourceMappingURL=useRhineMotion.d.ts.map

package/dist/motion/useRhineMotion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRhineMotion.d.ts","sourceRoot":"","sources":["../../src/motion/useRhineMotion.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAE5E,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAExD,MAAM,WAAW,WAAW;IAC1B,yGAAyG;IACzG,OAAO,EAAE,OAAO,CAAC;IACjB,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;IACd,iFAAiF;IACjF,GAAG,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,UAAU,CAAC;IAC/C,8GAA8G;IAC9G,OAAO,EAAE,CAAC,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,mBAAmB,KAAK,UAAU,CAAC;CAC9E;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAS5C"}

package/dist/motion/useRhineMotion.js

@@ -0,0 +1,19 @@
+'use client';
+import { useReducedMotionConfig } from 'motion/react';
+import { transition } from './presets.js';
+import { resolveMotion, useMotionSpeed } from './resolve.js';
+/**
+ * Single entry point for component motion. Honours `<MotionConfig reducedMotion="user" | "always" | "never">`
+ * so apps (and the showcase) can force either mode.
+ */
+export function useRhineMotion() {
+    const reduced = useReducedMotionConfig() === true;
+    const speed = useMotionSpeed();
+    return {
+        reduced,
+        speed,
+        get: (name) => (reduced ? transition.instant : resolveMotion('transform', name, false, speed)),
+        resolve: (kind, name) => resolveMotion(kind, name, reduced, speed),
+    };
+}
+//# sourceMappingURL=useRhineMotion.js.map

package/dist/motion/useRhineMotion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRhineMotion.js","sourceRoot":"","sources":["../../src/motion/useRhineMotion.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAEtD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAgB7D;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,OAAO,GAAG,sBAAsB,EAAE,KAAK,IAAI,CAAC;IAClD,MAAM,KAAK,GAAG,cAAc,EAAE,CAAC;IAC/B,OAAO;QACL,OAAO;QACP,KAAK;QACL,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QAC9F,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC;KACnE,CAAC;AACJ,CAAC"}

package/dist/motion/visibility.d.ts

@@ -0,0 +1,6 @@
+import * as React from 'react';
+/** True while the document is visible. Loops must pause when it turns false (MOTION.md lifecycle rule 4). */
+export declare function usePageVisible(): boolean;
+/** True while the element intersects the viewport. Treated as visible where IntersectionObserver is unavailable. */
+export declare function useInViewport<T extends Element>(ref: React.RefObject<T | null>): boolean;
+//# sourceMappingURL=visibility.d.ts.map