@dreamtree-org/twreact-ui 2.1.2 → 2.2.1

package/dist/motion/tokens.d.ts

@@ -0,0 +1,6 @@
+export const SCROLL_STICKY_TOP: 80;
+export const SCENE_LENGTH: 300;
+export const SCENE_LENGTH_MOBILE: 150;
+/** Below Tailwind's `md` breakpoint. */
+export const MOBILE_QUERY: "(max-width: 767px)";
+//# sourceMappingURL=tokens.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../src/motion/tokens.js"],"names":[],"mappings":"AAGA,gCAAiC,EAAE,CAAC;AACpC,2BAA4B,GAAG,CAAC;AAChC,kCAAmC,GAAG,CAAC;AAEvC,wCAAwC;AACxC,2BAA4B,oBAAoB,CAAC"}

package/dist/rich-text/index.js

@@ -1,11 +1,12 @@
 'use strict';
 
-var cn = require('../_shared/cn-DPPQUJu1.js');
+var cn = require('../_shared/cn-TMJ-_w1a.js');
 var jsxRuntime = require('react/jsx-runtime');
 var React = require('react');
 var react = require('@tiptap/react');
 var StarterKit = require('@tiptap/starter-kit');
 var lucideReact = require('lucide-react');
+var useLatestRef = require('../_shared/useLatestRef-CdtlnPUz.js');
 require('clsx');
 require('tailwind-merge');
 
@@ -14,22 +15,6 @@ function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 var React__default = /*#__PURE__*/_interopDefault(React);
 var StarterKit__default = /*#__PURE__*/_interopDefault(StarterKit);
 
-// useLayoutEffect warns during SSR; fall back to useEffect on the server.
-var useIsomorphicLayoutEffect = typeof window !== "undefined" ? React.useLayoutEffect : React.useEffect;
-/**
- * Internal (not exported from the package): a ref that always holds the latest
- * `value`. Lets an effect call the newest consumer callback (e.g. `onChange`)
- * without listing it as a dependency, so a parent passing an inline function
- * does not re-run the effect on every render.
- */
-function useLatestRef(value) {
-  var ref = React.useRef(value);
-  useIsomorphicLayoutEffect(function () {
-    ref.current = value;
-  });
-  return ref;
-}
-
 // Internal (not exported). Grows an icon-only control to the 44×44 px minimum
 // touch target (WCAG 2.5.5, Apple HIG) on coarse pointers only, so desktop
 // layouts keep their compact size. Pair with inline-flex centering.
@@ -498,7 +483,7 @@ var RichTextEditor = /*#__PURE__*/React.forwardRef(function (_ref, ref) {
   var helperId = "".concat(editorId, "-helper");
   var editable = !disabled && !readOnly;
   var rootRef = React.useRef(null);
-  var callbacks = useLatestRef({
+  var callbacks = useLatestRef.useLatestRef({
     onChange: onChange,
     onFocus: onFocus,
     onBlur: onBlur,

package/dist/tokens/tokens.json

@@ -551,5 +551,26 @@
       ],
       "$description": "Small overshoot for sheets settling and toggles."
     }
+  },
+  "scroll": {
+    "$description": "Scroll-storytelling defaults read by the /motion components (ScrollStage, StackedCards, DeviceMorphHero).",
+    "stickyTop": {
+      "$type": "dimension",
+      "$value": {
+        "value": 80,
+        "unit": "px"
+      },
+      "$description": "Offset from the top of the viewport where stacked cards stick (clears a floating nav)."
+    },
+    "sceneLength": {
+      "$type": "number",
+      "$value": 300,
+      "$description": "Default pinned scene length on desktop, in vh (viewport heights)."
+    },
+    "sceneLengthMobile": {
+      "$type": "number",
+      "$value": 150,
+      "$description": "Default pinned scene length below the md breakpoint, in vh."
+    }
   }
 }

package/dist/types/motion.d.ts

@@ -0,0 +1,290 @@
+import type { ElementType, HTMLAttributes, ReactNode } from 'react';
+import type { BaseComponentProps } from './index';
+/** A live 0–1 value that does not re-render React (MotionValue-like). */
+export interface ScrollProgress {
+    /** The current value (1 on the server, under reduced motion and before the first frame). */
+    get(): number;
+    /** Called with every new value; returns the unsubscribe function. */
+    subscribe(listener: (value: number) => void): () => void;
+}
+export interface UseScrollProgressOptions {
+    /**
+     * `"view"` (default): 0 when the element's top meets the viewport bottom, 1 when its bottom leaves the top.
+     * `"pin"`: 0 when its top meets the viewport top, 1 when its bottom meets the viewport bottom (the span a sticky child is pinned).
+     */
+    mode?: 'view' | 'pin';
+    /** Start of the range to re-map to 0–1 (0–1, default 0). */
+    start?: number;
+    /** End of the range to re-map to 0–1 (0–1, default 1). */
+    end?: number;
+    /** CSS custom property written on the element (default `"--dt-p"`); `""` writes none. */
+    cssVar?: string;
+    /** `false` stops tracking and removes the CSS variable (e.g. under reduced motion). Default `true`. */
+    enabled?: boolean;
+    /** Called with each new value (on the frame loop, not in render). */
+    onChange?: (progress: number) => void;
+}
+export interface ScrollStageProps extends BaseComponentProps, Omit<HTMLAttributes<HTMLElement>, 'className' | 'children' | 'onProgress'> {
+    /** Scroll distance of the scene in vh (viewport heights) on desktop. Default 300 (token `scroll.sceneLength`). */
+    length?: number;
+    /** Scene length below `md`. Default 150 (token `scroll.sceneLengthMobile`). */
+    mobileLength?: number;
+    /** Pin the content (`sticky top-0 h-screen`) while the scene scrolls. `false` renders it in normal flow. Default `true`. */
+    pin?: boolean;
+    /** Content, or a function that receives the live `ScrollProgress`. Inside, CSS can read `var(--dt-p, 1)`. */
+    children?: ReactNode | ((progress: ScrollProgress) => ReactNode);
+    /** Called with the scene progress (0–1) on the frame loop. */
+    onProgress?: (progress: number) => void;
+    /** Classes for the pinned inner box. */
+    contentClassName?: string;
+    /** Root element. Default `"section"`. */
+    as?: ElementType;
+}
+export type RevealEffect = 'fade-up' | 'fade' | 'scale' | 'clip' | 'split-words';
+export interface RevealProps extends BaseComponentProps, Omit<HTMLAttributes<HTMLElement>, 'className'> {
+    /** Entrance effect. `split-words` needs a string child. Default `"fade-up"`. */
+    effect?: RevealEffect;
+    /** Delay before the entrance, in ms. */
+    delay?: number;
+    /** Delay between words for `split-words`, in ms. Default 40. */
+    stagger?: number;
+    /** Reveal once (default) or every time the element re-enters the viewport. */
+    once?: boolean;
+    /** Root element. Default `"div"`. */
+    as?: ElementType;
+    children?: ReactNode;
+}
+export interface RevealGroupProps extends BaseComponentProps, Omit<HTMLAttributes<HTMLElement>, 'className'> {
+    effect?: RevealEffect;
+    /** Delay before the first child, in ms. */
+    delay?: number;
+    /** Delay added per child, in ms. Default 80. */
+    stagger?: number;
+    once?: boolean;
+    /** Group element. Default `"div"`. */
+    as?: ElementType;
+    /** Element wrapping each child. Default `"div"`. */
+    itemAs?: ElementType;
+    children?: ReactNode;
+}
+export interface MarqueeLogo {
+    src: string;
+    alt: string;
+    href?: string;
+}
+export type MarqueeItem = string | MarqueeLogo | ReactNode;
+export interface LogoMarqueeProps extends BaseComponentProps, Omit<HTMLAttributes<HTMLDivElement>, 'className'> {
+    /** Logos (`{ src, alt, href? }`), names (strings) or any node. */
+    items: MarqueeItem[];
+    /** Scroll speed in px per second. Default 40. */
+    speed?: number;
+    /** Direction of the first row. Default `"left"`. */
+    direction?: 'left' | 'right';
+    /** Pause while the pointer is over the strip. Default `true`. (It always pauses while focus is inside.) */
+    pauseOnHover?: boolean;
+    /** Fade the strip's left and right edges. Default `true`. */
+    fadeEdges?: boolean;
+    /** 1, or 2 rows running in opposite directions. Default 1. */
+    rows?: 1 | 2;
+    /** Accessible name of the region. Default `"Clients"`. */
+    label?: string;
+}
+export interface CountUpProps extends BaseComponentProps, Omit<HTMLAttributes<HTMLSpanElement>, 'className' | 'prefix'> {
+    /** The final number (rendered as-is on the server and under reduced motion). */
+    value: number;
+    /** Number the animation starts from. Default 0. */
+    from?: number;
+    /** Text before the number, e.g. `"₹"`. */
+    prefix?: ReactNode;
+    /** Text after the number, e.g. `"+"`, `"%"`, `" Cr"`. */
+    suffix?: ReactNode;
+    /** Animation length in ms. Default 1600. */
+    duration?: number;
+    /** Fraction digits. Default: as many as `value` has. */
+    decimals?: number;
+    /** `Intl.NumberFormat` locale. Default `"en-IN"` (1,00,000 grouping). */
+    locale?: string;
+    /** Custom formatter; overrides `locale` / `decimals`. */
+    format?: (value: number) => string;
+}
+export interface StatItem {
+    value: number;
+    label: ReactNode;
+    prefix?: ReactNode;
+    suffix?: ReactNode;
+    decimals?: number;
+    format?: (value: number) => string;
+}
+export interface StatStripProps extends BaseComponentProps, Omit<HTMLAttributes<HTMLDListElement>, 'className'> {
+    items: StatItem[];
+    /** `"cards"` (bordered tiles) or `"band"` (one row with dividers). Default `"cards"`. */
+    variant?: 'cards' | 'band';
+    /** Passed to every CountUp. */
+    duration?: number;
+    locale?: string;
+}
+export interface StackedCardMedia {
+    src: string;
+    alt: string;
+}
+export interface StackedCardItem {
+    /** Stable key (falls back to the index). */
+    id?: string | number;
+    kicker?: ReactNode;
+    title: ReactNode;
+    body?: ReactNode;
+    bullets?: ReactNode[];
+    metric?: {
+        value: ReactNode;
+        label: ReactNode;
+    };
+    cta?: ReactNode;
+    media?: StackedCardMedia | ReactNode;
+}
+export interface StackedCardsProps extends BaseComponentProps, Omit<HTMLAttributes<HTMLOListElement>, 'className'> {
+    items: StackedCardItem[];
+    /** px from the viewport top where cards stick. Default 80 (token `scroll.stickyTop`). */
+    stickyTop?: number;
+    /** Alternating tilt in degrees (card 1 −tilt, card 2 +tilt…). 0 disables. Off below `md` and under reduced motion. Default 1. */
+    tilt?: number;
+    /** Scale of a card fully covered by the next one. 1 disables. Default 0.94. */
+    scaleBack?: number;
+    /** How much a covered card darkens (0–1). 0 disables. Default 0.15. */
+    dimBack?: number;
+    /** Media on the right of every card, or alternating sides. Default `"alternate"`. */
+    mediaSide?: 'alternate' | 'right';
+    /** Replace the default card body. */
+    renderItem?: (item: StackedCardItem, index: number) => ReactNode;
+}
+export type DeviceKind = 'phone' | 'tablet' | 'laptop' | 'browser';
+export interface DeviceFrameProps extends BaseComponentProps, Omit<HTMLAttributes<HTMLDivElement>, 'className'> {
+    /** Default `"phone"`. */
+    device?: DeviceKind;
+    /** Screen content. */
+    children?: ReactNode;
+    /** Address shown in the `browser` frame's bar. */
+    url?: string;
+    /** Classes for the screen box. */
+    screenClassName?: string;
+}
+export interface DeviceMorphMedia {
+    /** Video URL (muted, looping, inline). */
+    video?: string;
+    /** Image URL (used when there is no video). */
+    image?: string;
+    /** Poster for the video. */
+    poster?: string;
+    /** Text alternative. Empty string marks the media decorative. */
+    alt?: string;
+}
+export interface DeviceMorphHeroProps extends BaseComponentProps, Omit<HTMLAttributes<HTMLElement>, 'className' | 'content'> {
+    media: DeviceMorphMedia;
+    /** Default `"phone"`. */
+    device?: DeviceKind;
+    /** Scene length in vh on desktop (capped at 400). Default 300. */
+    length?: number;
+    /** Scene length in vh below `md`. Default 150. */
+    mobileLength?: number;
+    /** Side the device slides to. Default `"right"`. */
+    side?: 'right' | 'left';
+    /** Copy that fades in beside the device: logo, headline, CTAs, stats. */
+    content?: ReactNode;
+    /** Label of the skip-ahead button, or `false` to hide it. Default `"Scroll to explore"`. */
+    scrollHint?: ReactNode | false;
+}
+export interface BentoItem {
+    id?: string | number;
+    media: {
+        src: string;
+        alt: string;
+    } | ReactNode;
+    title: ReactNode;
+    tag?: ReactNode;
+    client?: ReactNode;
+    /** Makes the tile a link. */
+    href?: string;
+}
+export interface BentoExpandGridProps extends BaseComponentProps, Omit<HTMLAttributes<HTMLUListElement>, 'className'> {
+    items: BentoItem[];
+    /** Columns from `md` up (2–4). Default 3. */
+    cols?: 2 | 3 | 4;
+    /** Track size of the active tile's row and column, in fr. Default 2. */
+    expand?: number;
+    /** What expands a tile: hover (and focus), focus only, or click/tap. Default `"hover"`. */
+    trigger?: 'hover' | 'focus' | 'click';
+    /** Accessible name of the list. */
+    label?: string;
+}
+/** The subset of a Lenis instance the provider uses. */
+export interface LenisLike {
+    raf(time: number): void;
+    destroy(): void;
+    scrollTo(target: number | string | HTMLElement, options?: Record<string, unknown>): void;
+}
+export interface SmoothScrollProviderProps {
+    /** The Lenis class: `import Lenis from 'lenis'` and pass it. Without it, native scroll is used. */
+    lenis?: new (options?: Record<string, unknown>) => LenisLike;
+    /** Options for `new Lenis(options)`. */
+    options?: Record<string, unknown>;
+    /** Default `true`. Always off when the user prefers reduced motion. */
+    enabled?: boolean;
+    children?: ReactNode;
+}
+export interface SmoothScrollContextValue {
+    /** The live Lenis instance, or `null` when native scroll is in use. */
+    lenis: LenisLike | null;
+    /** Scroll to a y offset, selector or element (Lenis when active, else `window.scrollTo` / `scrollIntoView`). */
+    scrollTo(target: number | string | HTMLElement, options?: {
+        offset?: number;
+        immediate?: boolean;
+    }): void;
+}
+export interface TestimonialItem {
+    id?: string | number;
+    quote: ReactNode;
+    name: ReactNode;
+    role?: ReactNode;
+    /** `{ src, alt }` or a node. */
+    logo?: {
+        src: string;
+        alt: string;
+    } | ReactNode;
+}
+export interface TestimonialSpotlightProps extends BaseComponentProps, Omit<HTMLAttributes<HTMLElement>, 'className'> {
+    items: TestimonialItem[];
+    /** Auto-advance interval in ms; 0 disables. Pauses on hover, focus, off screen and under reduced motion. Default 6000. */
+    autoplay?: number;
+    /** Show the 3×3 logo tile grid. Default `true`. */
+    grid?: boolean;
+    /** Accessible name. Default `"Testimonials"`. */
+    label?: string;
+}
+export interface CollageImage {
+    src: string;
+    alt: string;
+}
+export interface CollageChip {
+    value: ReactNode;
+    label: ReactNode;
+}
+export interface PhotoCollageProps extends BaseComponentProps, Omit<HTMLAttributes<HTMLDivElement>, 'className'> {
+    /** 1–4 photos, placed in overlapping offsets. */
+    images: CollageImage[];
+    /** Floating stat chips (up to 2). */
+    chips?: CollageChip[];
+    /** Parallax strength (0–1). 0 disables; off under reduced motion. Default 0.15. */
+    parallax?: number;
+    /** A node pinned to the top-right corner, e.g. a RotatingBadge. */
+    badge?: ReactNode;
+}
+export interface RotatingBadgeProps extends BaseComponentProps, Omit<HTMLAttributes<HTMLDivElement>, 'className'> {
+    /** Text set around the circle (repeat it with separators: `"DREAMTREE • SINCE 2012 • "`). */
+    text: string;
+    /** Seconds per turn. Default 14. Stops under reduced motion. */
+    speed?: number;
+    /** Diameter in px. Default 120. */
+    size?: number;
+    /** Node in the middle (decorative). */
+    icon?: ReactNode;
+}
+//# sourceMappingURL=motion.d.ts.map

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

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

package/doc/README.md

@@ -138,7 +138,7 @@ function App() {
 
 ### Optional entry points (need an optional peer dependency)
 
-These are **not** exported from the root package. Import them from their subpath, after installing the peer. Apps that never import them install and bundle nothing extra.
+These are **not** exported from the root package. Import them from their subpath, after installing the peer (if any). Apps that never import them install and bundle nothing extra. The `/motion` components need no peer; see [Motion.md](Motion.md).
 
 | Component | Import from | Peer to install | Description | Doc |
 |-----------|-------------|-----------------|-------------|-----|
@@ -149,6 +149,22 @@ These are **not** exported from the root package. Import them from their subpath
 | [Sparkline](Sparkline.md) | `@dreamtree-org/twreact-ui/charts` | `recharts` | Word-sized trend line for cards and cells | [Sparkline.md](Sparkline.md) |
 | [ScatterChart](ScatterChart.md) | `@dreamtree-org/twreact-ui/charts` | `recharts` | Two numeric axes, one point per entity, optional series | [ScatterChart.md](ScatterChart.md) |
 | [RichTextEditor](RichTextEditor.md) | `@dreamtree-org/twreact-ui/rich-text` | `@tiptap/react @tiptap/pm @tiptap/starter-kit` | Tiptap WYSIWYG field with accessible toolbar | [RichTextEditor.md](RichTextEditor.md) |
+| [ScrollStage](ScrollStage.md) | `@dreamtree-org/twreact-ui/motion` | — | Pinned scroll scene; progress in `--dt-p` | [ScrollStage.md](ScrollStage.md) |
+| [Reveal](Reveal.md) | `@dreamtree-org/twreact-ui/motion` | — | Entrance (fade, scale, clip, split words) on scroll-in | [Reveal.md](Reveal.md) |
+| [RevealGroup](RevealGroup.md) | `@dreamtree-org/twreact-ui/motion` | — | Reveals children one after another | [RevealGroup.md](RevealGroup.md) |
+| [LogoMarquee](LogoMarquee.md) | `@dreamtree-org/twreact-ui/motion` | — | Endless logo strip, clone hidden from screen readers | [LogoMarquee.md](LogoMarquee.md) |
+| [CountUp](CountUp.md) | `@dreamtree-org/twreact-ui/motion` | — | Number that counts up on view; final value on the server | [CountUp.md](CountUp.md) |
+| [StatStrip](StatStrip.md) | `@dreamtree-org/twreact-ui/motion` | — | Row of CountUp stats as cards or a band | [StatStrip.md](StatStrip.md) |
+| [StackedCards](StackedCards.md) | `@dreamtree-org/twreact-ui/motion` | — | Sticky cards that stack, shrink and dim on scroll | [StackedCards.md](StackedCards.md) |
+| [DeviceFrame](DeviceFrame.md) | `@dreamtree-org/twreact-ui/motion` | — | CSS phone / tablet / laptop / browser mock-up | [DeviceFrame.md](DeviceFrame.md) |
+| [DeviceMorphHero](DeviceMorphHero.md) | `@dreamtree-org/twreact-ui/motion` | — | Hero: full-bleed media shrinks into a device, copy fades in | [DeviceMorphHero.md](DeviceMorphHero.md) |
+| [BentoExpandGrid](BentoExpandGrid.md) | `@dreamtree-org/twreact-ui/motion` | — | Photo grid whose hovered or focused tile grows | [BentoExpandGrid.md](BentoExpandGrid.md) |
+| [SmoothScrollProvider](SmoothScrollProvider.md) | `@dreamtree-org/twreact-ui/motion` | `lenis` (optional) | Opt-in Lenis smooth scroll; native without it | [SmoothScrollProvider.md](SmoothScrollProvider.md) |
+| [TestimonialSpotlight](TestimonialSpotlight.md) | `@dreamtree-org/twreact-ui/motion` | — | Quotes with a logo tile grid, tabs and pausable autoplay | [TestimonialSpotlight.md](TestimonialSpotlight.md) |
+| [PhotoCollage](PhotoCollage.md) | `@dreamtree-org/twreact-ui/motion` | — | Overlapping photos with stat chips and parallax | [PhotoCollage.md](PhotoCollage.md) |
+| [RotatingBadge](RotatingBadge.md) | `@dreamtree-org/twreact-ui/motion` | — | Circular text badge that slowly turns | [RotatingBadge.md](RotatingBadge.md) |
+| [useScrollProgress](useScrollProgress.md) | `@dreamtree-org/twreact-ui/motion` | — | Hook: 0–1 scroll progress of an element, no re-renders | [useScrollProgress.md](useScrollProgress.md) |
+| [useSmoothScroll](useSmoothScroll.md) | `@dreamtree-org/twreact-ui/motion` | — | Hook: `{ lenis, scrollTo }` from SmoothScrollProvider | [useSmoothScroll.md](useSmoothScroll.md) |
 
 ---