@particle-academy/react-fancy 5.12.0 → 5.14.0

package/dist/AudioViewer.types-VWhRx6XG.d.cts

@@ -0,0 +1,22 @@
+import { CSSProperties } from 'react';
+
+interface AudioViewerProps {
+    /** Audio source — an `http(s):`, `data:`, or `blob:` URL. */
+    src: string;
+    /** Optional label shown above the player (e.g. the file name). */
+    title?: string;
+    /** Show native playback controls (default `true`). */
+    controls?: boolean;
+    /** Autoplay on mount. */
+    autoPlay?: boolean;
+    /** Loop playback (default `false`). */
+    loop?: boolean;
+    /** Fired when the audio fails to load. */
+    onError?: () => void;
+    /** Additional CSS classes for the card. */
+    className?: string;
+    /** Inline styles for the card. */
+    style?: CSSProperties;
+}
+
+export type { AudioViewerProps as A };

package/dist/AudioViewer.types-VWhRx6XG.d.ts

@@ -0,0 +1,22 @@
+import { CSSProperties } from 'react';
+
+interface AudioViewerProps {
+    /** Audio source — an `http(s):`, `data:`, or `blob:` URL. */
+    src: string;
+    /** Optional label shown above the player (e.g. the file name). */
+    title?: string;
+    /** Show native playback controls (default `true`). */
+    controls?: boolean;
+    /** Autoplay on mount. */
+    autoPlay?: boolean;
+    /** Loop playback (default `false`). */
+    loop?: boolean;
+    /** Fired when the audio fails to load. */
+    onError?: () => void;
+    /** Additional CSS classes for the card. */
+    className?: string;
+    /** Inline styles for the card. */
+    style?: CSSProperties;
+}
+
+export type { AudioViewerProps as A };

package/dist/Card-BZ5F6-wd.d.cts

@@ -0,0 +1,50 @@
+import * as react from 'react';
+import { HTMLAttributes, ReactNode } from 'react';
+
+interface CardProps extends HTMLAttributes<HTMLDivElement> {
+    variant?: "outlined" | "elevated" | "flat";
+    padding?: "none" | "sm" | "md" | "lg";
+    /**
+     * Card is a link or a grid tile: adds the hover lift + border/shadow
+     * response, and clips children to the rounded corners so a `Card.Media`
+     * sits flush.
+     */
+    interactive?: boolean;
+}
+interface CardMediaProps extends HTMLAttributes<HTMLDivElement> {
+    /** Image URL. Omit for a pure colour/gradient tile. */
+    src?: string;
+    alt?: string;
+    /** CSS `aspect-ratio`. Default `"16/9"`. Ignored when `height` is set. */
+    ratio?: string;
+    /** Fixed height instead of an aspect ratio. */
+    height?: number | string;
+    /**
+     * Shown UNDER the image — while it loads, and permanently if it never
+     * arrives. Any CSS background value, so a gradient works.
+     */
+    background?: string;
+    /** `object-position` for the image. Default `"center"`. */
+    objectPosition?: string;
+    loading?: "lazy" | "eager";
+    /** Slots pinned to the media's corners — a number chip, a status pill. */
+    topLeft?: ReactNode;
+    topRight?: ReactNode;
+    bottomLeft?: ReactNode;
+    bottomRight?: ReactNode;
+}
+interface CardHeaderProps extends HTMLAttributes<HTMLDivElement> {
+}
+interface CardBodyProps extends HTMLAttributes<HTMLDivElement> {
+}
+interface CardFooterProps extends HTMLAttributes<HTMLDivElement> {
+}
+
+declare const Card: react.ForwardRefExoticComponent<CardProps & react.RefAttributes<HTMLDivElement>> & {
+    Media: react.ForwardRefExoticComponent<CardMediaProps & react.RefAttributes<HTMLDivElement>>;
+    Header: react.ForwardRefExoticComponent<CardHeaderProps & react.RefAttributes<HTMLDivElement>>;
+    Body: react.ForwardRefExoticComponent<CardBodyProps & react.RefAttributes<HTMLDivElement>>;
+    Footer: react.ForwardRefExoticComponent<CardFooterProps & react.RefAttributes<HTMLDivElement>>;
+};
+
+export { type CardHeaderProps as C, type CardBodyProps as a, type CardFooterProps as b, type CardMediaProps as c, Card as d, type CardProps as e };

package/dist/Card-BZ5F6-wd.d.ts

@@ -0,0 +1,50 @@
+import * as react from 'react';
+import { HTMLAttributes, ReactNode } from 'react';
+
+interface CardProps extends HTMLAttributes<HTMLDivElement> {
+    variant?: "outlined" | "elevated" | "flat";
+    padding?: "none" | "sm" | "md" | "lg";
+    /**
+     * Card is a link or a grid tile: adds the hover lift + border/shadow
+     * response, and clips children to the rounded corners so a `Card.Media`
+     * sits flush.
+     */
+    interactive?: boolean;
+}
+interface CardMediaProps extends HTMLAttributes<HTMLDivElement> {
+    /** Image URL. Omit for a pure colour/gradient tile. */
+    src?: string;
+    alt?: string;
+    /** CSS `aspect-ratio`. Default `"16/9"`. Ignored when `height` is set. */
+    ratio?: string;
+    /** Fixed height instead of an aspect ratio. */
+    height?: number | string;
+    /**
+     * Shown UNDER the image — while it loads, and permanently if it never
+     * arrives. Any CSS background value, so a gradient works.
+     */
+    background?: string;
+    /** `object-position` for the image. Default `"center"`. */
+    objectPosition?: string;
+    loading?: "lazy" | "eager";
+    /** Slots pinned to the media's corners — a number chip, a status pill. */
+    topLeft?: ReactNode;
+    topRight?: ReactNode;
+    bottomLeft?: ReactNode;
+    bottomRight?: ReactNode;
+}
+interface CardHeaderProps extends HTMLAttributes<HTMLDivElement> {
+}
+interface CardBodyProps extends HTMLAttributes<HTMLDivElement> {
+}
+interface CardFooterProps extends HTMLAttributes<HTMLDivElement> {
+}
+
+declare const Card: react.ForwardRefExoticComponent<CardProps & react.RefAttributes<HTMLDivElement>> & {
+    Media: react.ForwardRefExoticComponent<CardMediaProps & react.RefAttributes<HTMLDivElement>>;
+    Header: react.ForwardRefExoticComponent<CardHeaderProps & react.RefAttributes<HTMLDivElement>>;
+    Body: react.ForwardRefExoticComponent<CardBodyProps & react.RefAttributes<HTMLDivElement>>;
+    Footer: react.ForwardRefExoticComponent<CardFooterProps & react.RefAttributes<HTMLDivElement>>;
+};
+
+export { type CardHeaderProps as C, type CardBodyProps as a, type CardFooterProps as b, type CardMediaProps as c, Card as d, type CardProps as e };

package/dist/Carousel.context-Ba3gKZHQ.d.cts

@@ -0,0 +1,61 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+
+type CarouselVariant = "directional" | "wizard";
+interface CarouselContextValue {
+    activeIndex: number;
+    totalSlides: number;
+    next: () => void;
+    prev: () => void;
+    goTo: (index: number) => void;
+    registerSlides: (count: number) => void;
+    variant: CarouselVariant;
+    loop: boolean;
+    slideNames: string[];
+    registerSlideNames: (names: string[]) => void;
+    onFinish?: () => void;
+    headless: boolean;
+}
+interface CarouselProps {
+    children: ReactNode;
+    defaultIndex?: number;
+    activeIndex?: number;
+    onIndexChange?: (index: number) => void;
+    className?: string;
+    autoPlay?: boolean;
+    interval?: number;
+    loop?: boolean;
+    variant?: CarouselVariant;
+    headless?: boolean;
+    onFinish?: () => void;
+}
+interface CarouselSlideProps {
+    children: ReactNode;
+    className?: string;
+    name?: string;
+}
+interface CarouselControlsProps {
+    className?: string;
+    prevLabel?: ReactNode;
+    nextLabel?: ReactNode;
+    finishLabel?: ReactNode;
+}
+interface CarouselStepsProps {
+    className?: string;
+}
+interface CarouselPanelsProps {
+    children: ReactNode;
+    className?: string;
+    transition?: "none" | "fade";
+}
+
+declare const Carousel: react.ForwardRefExoticComponent<CarouselProps & react.RefAttributes<HTMLDivElement>> & {
+    Panels: react.ForwardRefExoticComponent<CarouselPanelsProps & react.RefAttributes<HTMLDivElement>>;
+    Slide: react.ForwardRefExoticComponent<CarouselSlideProps & react.RefAttributes<HTMLDivElement>>;
+    Controls: react.ForwardRefExoticComponent<CarouselControlsProps & react.RefAttributes<HTMLDivElement>>;
+    Steps: react.ForwardRefExoticComponent<CarouselStepsProps & react.RefAttributes<HTMLDivElement>>;
+};
+
+declare function useCarousel(): CarouselContextValue;
+
+export { type CarouselPanelsProps as C, type CarouselSlideProps as a, type CarouselControlsProps as b, type CarouselStepsProps as c, Carousel as d, type CarouselContextValue as e, type CarouselProps as f, type CarouselVariant as g, useCarousel as u };

package/dist/Carousel.context-Ba3gKZHQ.d.ts

@@ -0,0 +1,61 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+
+type CarouselVariant = "directional" | "wizard";
+interface CarouselContextValue {
+    activeIndex: number;
+    totalSlides: number;
+    next: () => void;
+    prev: () => void;
+    goTo: (index: number) => void;
+    registerSlides: (count: number) => void;
+    variant: CarouselVariant;
+    loop: boolean;
+    slideNames: string[];
+    registerSlideNames: (names: string[]) => void;
+    onFinish?: () => void;
+    headless: boolean;
+}
+interface CarouselProps {
+    children: ReactNode;
+    defaultIndex?: number;
+    activeIndex?: number;
+    onIndexChange?: (index: number) => void;
+    className?: string;
+    autoPlay?: boolean;
+    interval?: number;
+    loop?: boolean;
+    variant?: CarouselVariant;
+    headless?: boolean;
+    onFinish?: () => void;
+}
+interface CarouselSlideProps {
+    children: ReactNode;
+    className?: string;
+    name?: string;
+}
+interface CarouselControlsProps {
+    className?: string;
+    prevLabel?: ReactNode;
+    nextLabel?: ReactNode;
+    finishLabel?: ReactNode;
+}
+interface CarouselStepsProps {
+    className?: string;
+}
+interface CarouselPanelsProps {
+    children: ReactNode;
+    className?: string;
+    transition?: "none" | "fade";
+}
+
+declare const Carousel: react.ForwardRefExoticComponent<CarouselProps & react.RefAttributes<HTMLDivElement>> & {
+    Panels: react.ForwardRefExoticComponent<CarouselPanelsProps & react.RefAttributes<HTMLDivElement>>;
+    Slide: react.ForwardRefExoticComponent<CarouselSlideProps & react.RefAttributes<HTMLDivElement>>;
+    Controls: react.ForwardRefExoticComponent<CarouselControlsProps & react.RefAttributes<HTMLDivElement>>;
+    Steps: react.ForwardRefExoticComponent<CarouselStepsProps & react.RefAttributes<HTMLDivElement>>;
+};
+
+declare function useCarousel(): CarouselContextValue;
+
+export { type CarouselPanelsProps as C, type CarouselSlideProps as a, type CarouselControlsProps as b, type CarouselStepsProps as c, Carousel as d, type CarouselContextValue as e, type CarouselProps as f, type CarouselVariant as g, useCarousel as u };

package/dist/FieldMode.context-Bv_wuS8V.d.ts

@@ -0,0 +1,74 @@
+import * as react from 'react';
+import { FormHTMLAttributes, ReactNode } from 'react';
+import { F as FieldMode } from './inputs.types-DERzxpe1.js';
+import { S as Size } from './types-8Sv0rCjw.js';
+
+interface FormProviderProps {
+    /** `"edit"` (default) or `"view"` — applied to every input below that doesn't override it. */
+    mode?: FieldMode;
+    children?: ReactNode;
+}
+interface FormProps extends FormHTMLAttributes<HTMLFormElement> {
+    /** `"edit"` (default) or `"view"` — applied to every input inside. */
+    mode?: FieldMode;
+}
+/**
+ * Provide a form-wide {@link FieldMode} to every Fancy input below — flip a
+ * whole form from editable to read-only display in one place. Pure context, no
+ * DOM (use it to wrap a filter bar or any tree that isn't a `<form>`).
+ */
+declare function FormProvider({ mode, children }: FormProviderProps): react.JSX.Element;
+/**
+ * A real `<form>` that also broadcasts a form-wide {@link FieldMode} to the
+ * inputs inside it (sugar over {@link FormProvider}). Per-input `mode` props
+ * still override this.
+ */
+declare function Form({ mode, children, ...formProps }: FormProps): react.JSX.Element;
+
+interface DisplayValueProps {
+    /** The formatted value to show. Empty / null / undefined renders `empty`. */
+    children?: ReactNode;
+    size?: Size;
+    /** Static adornment rendered before the value (mirrors an input's `leading`/`prefix`). */
+    leading?: ReactNode;
+    /** Static adornment rendered after the value (mirrors an input's `trailing`/`suffix`). */
+    trailing?: ReactNode;
+    /** Shown when the value is empty. Default `—`. */
+    empty?: ReactNode;
+    /** When true the value is clickable to enter edit mode (inline click-to-edit). */
+    interactive?: boolean;
+    /** Called when an interactive value is activated (click / Enter / Space). */
+    onActivate?: () => void;
+    className?: string;
+}
+/**
+ * The read-only counterpart to an `<input>`. Renders a non-interactive value
+ * with the same size rhythm as the editable control (reusing
+ * {@link inputSizeClasses}) but without the border / background / focus ring.
+ *
+ * When `interactive` (inline click-to-edit), the value becomes a focusable,
+ * hoverable target that calls `onActivate` on click / Enter / Space to swap in
+ * the real control. Dropped into the SAME `Field` wrapper the editable control
+ * uses, so label / description / error chrome stays byte-identical between the
+ * display and the editor.
+ *
+ * Carries `data-react-fancy-display` / `data-mode="view"` stable handles for
+ * agents and tests (Human+ contract).
+ */
+declare function DisplayValue({ children, size, leading, trailing, empty, interactive, onActivate, className, }: DisplayValueProps): react.JSX.Element;
+
+interface FieldModeContextValue {
+    mode: FieldMode;
+}
+declare const FieldModeContext: react.Context<FieldModeContextValue | null>;
+/**
+ * Resolve the effective mode for an input. Precedence: an explicit prop wins,
+ * then the nearest `<Form>` / `<FormProvider>` context, then `"edit"`.
+ *
+ * Deliberately tolerant (returns `"edit"` outside any provider) — unlike a slot
+ * guard — so every input works standalone with zero context and existing call
+ * sites behave identically.
+ */
+declare function useFieldMode(explicit?: FieldMode): FieldMode;
+
+export { DisplayValue as D, FieldModeContext as F, type DisplayValueProps as a, type FieldModeContextValue as b, Form as c, type FormProps as d, FormProvider as e, type FormProviderProps as f, useFieldMode as u };

package/dist/FieldMode.context-C28RH8GR.d.cts

@@ -0,0 +1,74 @@
+import * as react from 'react';
+import { FormHTMLAttributes, ReactNode } from 'react';
+import { F as FieldMode } from './inputs.types-CkWdvN-t.cjs';
+import { S as Size } from './types-8Sv0rCjw.cjs';
+
+interface FormProviderProps {
+    /** `"edit"` (default) or `"view"` — applied to every input below that doesn't override it. */
+    mode?: FieldMode;
+    children?: ReactNode;
+}
+interface FormProps extends FormHTMLAttributes<HTMLFormElement> {
+    /** `"edit"` (default) or `"view"` — applied to every input inside. */
+    mode?: FieldMode;
+}
+/**
+ * Provide a form-wide {@link FieldMode} to every Fancy input below — flip a
+ * whole form from editable to read-only display in one place. Pure context, no
+ * DOM (use it to wrap a filter bar or any tree that isn't a `<form>`).
+ */
+declare function FormProvider({ mode, children }: FormProviderProps): react.JSX.Element;
+/**
+ * A real `<form>` that also broadcasts a form-wide {@link FieldMode} to the
+ * inputs inside it (sugar over {@link FormProvider}). Per-input `mode` props
+ * still override this.
+ */
+declare function Form({ mode, children, ...formProps }: FormProps): react.JSX.Element;
+
+interface DisplayValueProps {
+    /** The formatted value to show. Empty / null / undefined renders `empty`. */
+    children?: ReactNode;
+    size?: Size;
+    /** Static adornment rendered before the value (mirrors an input's `leading`/`prefix`). */
+    leading?: ReactNode;
+    /** Static adornment rendered after the value (mirrors an input's `trailing`/`suffix`). */
+    trailing?: ReactNode;
+    /** Shown when the value is empty. Default `—`. */
+    empty?: ReactNode;
+    /** When true the value is clickable to enter edit mode (inline click-to-edit). */
+    interactive?: boolean;
+    /** Called when an interactive value is activated (click / Enter / Space). */
+    onActivate?: () => void;
+    className?: string;
+}
+/**
+ * The read-only counterpart to an `<input>`. Renders a non-interactive value
+ * with the same size rhythm as the editable control (reusing
+ * {@link inputSizeClasses}) but without the border / background / focus ring.
+ *
+ * When `interactive` (inline click-to-edit), the value becomes a focusable,
+ * hoverable target that calls `onActivate` on click / Enter / Space to swap in
+ * the real control. Dropped into the SAME `Field` wrapper the editable control
+ * uses, so label / description / error chrome stays byte-identical between the
+ * display and the editor.
+ *
+ * Carries `data-react-fancy-display` / `data-mode="view"` stable handles for
+ * agents and tests (Human+ contract).
+ */
+declare function DisplayValue({ children, size, leading, trailing, empty, interactive, onActivate, className, }: DisplayValueProps): react.JSX.Element;
+
+interface FieldModeContextValue {
+    mode: FieldMode;
+}
+declare const FieldModeContext: react.Context<FieldModeContextValue | null>;
+/**
+ * Resolve the effective mode for an input. Precedence: an explicit prop wins,
+ * then the nearest `<Form>` / `<FormProvider>` context, then `"edit"`.
+ *
+ * Deliberately tolerant (returns `"edit"` outside any provider) — unlike a slot
+ * guard — so every input works standalone with zero context and existing call
+ * sites behave identically.
+ */
+declare function useFieldMode(explicit?: FieldMode): FieldMode;
+
+export { DisplayValue as D, FieldModeContext as F, type DisplayValueProps as a, type FieldModeContextValue as b, Form as c, type FormProps as d, FormProvider as e, type FormProviderProps as f, useFieldMode as u };

package/dist/ImageViewer.types-BaqlDeuo.d.cts

@@ -0,0 +1,55 @@
+import { CSSProperties } from 'react';
+
+/** Pan offset (in container pixels) + zoom factor for an `<ImageViewer>`. */
+interface ImageViewerViewport {
+    panX: number;
+    panY: number;
+    zoom: number;
+}
+interface ImageViewerProps {
+    /** Image source — an `http(s):`, `data:`, or `blob:` URL. */
+    src: string;
+    /** Alt text for the image (also used as the download filename hint). */
+    alt?: string;
+    /**
+     * How the image sits in its container at zoom 1. `"contain"` (default) fits
+     * the whole image, `"cover"` fills and crops, `"none"` shows it at natural
+     * size (pan to see the rest).
+     */
+    fit?: "contain" | "cover" | "none";
+    /** Allow Ctrl/⌘+wheel zoom and the zoom controls (default `true`). */
+    zoomable?: boolean;
+    /** Allow click-drag panning (default `true`). */
+    pannable?: boolean;
+    /** Show the floating zoom controls. Defaults to the value of `zoomable`. */
+    controls?: boolean;
+    /** Minimum zoom factor (default `0.25`). */
+    minZoom?: number;
+    /** Maximum zoom factor (default `8`). */
+    maxZoom?: number;
+    /**
+     * Paint a checkerboard behind the image so transparency reads clearly
+     * (default `true`). Set `false` for a flat themed surface.
+     */
+    checkerboard?: boolean;
+    /**
+     * Controlled viewport (pan + zoom). Pair with `onViewportChange`. Omit for
+     * uncontrolled internal state. Exposed so an agent can pan/zoom to point at
+     * something via a bridge.
+     */
+    viewport?: ImageViewerViewport;
+    /** Initial viewport when uncontrolled. */
+    defaultViewport?: ImageViewerViewport;
+    /** Called whenever the viewport (pan/zoom) changes. */
+    onViewportChange?: (viewport: ImageViewerViewport) => void;
+    /** Fired when the image finishes loading. */
+    onLoad?: () => void;
+    /** Fired when the image fails to load. */
+    onError?: () => void;
+    /** Additional CSS classes for the viewport container. */
+    className?: string;
+    /** Inline styles for the viewport container (e.g. a fixed height). */
+    style?: CSSProperties;
+}
+
+export type { ImageViewerProps as I, ImageViewerViewport as a };

package/dist/ImageViewer.types-BaqlDeuo.d.ts

@@ -0,0 +1,55 @@
+import { CSSProperties } from 'react';
+
+/** Pan offset (in container pixels) + zoom factor for an `<ImageViewer>`. */
+interface ImageViewerViewport {
+    panX: number;
+    panY: number;
+    zoom: number;
+}
+interface ImageViewerProps {
+    /** Image source — an `http(s):`, `data:`, or `blob:` URL. */
+    src: string;
+    /** Alt text for the image (also used as the download filename hint). */
+    alt?: string;
+    /**
+     * How the image sits in its container at zoom 1. `"contain"` (default) fits
+     * the whole image, `"cover"` fills and crops, `"none"` shows it at natural
+     * size (pan to see the rest).
+     */
+    fit?: "contain" | "cover" | "none";
+    /** Allow Ctrl/⌘+wheel zoom and the zoom controls (default `true`). */
+    zoomable?: boolean;
+    /** Allow click-drag panning (default `true`). */
+    pannable?: boolean;
+    /** Show the floating zoom controls. Defaults to the value of `zoomable`. */
+    controls?: boolean;
+    /** Minimum zoom factor (default `0.25`). */
+    minZoom?: number;
+    /** Maximum zoom factor (default `8`). */
+    maxZoom?: number;
+    /**
+     * Paint a checkerboard behind the image so transparency reads clearly
+     * (default `true`). Set `false` for a flat themed surface.
+     */
+    checkerboard?: boolean;
+    /**
+     * Controlled viewport (pan + zoom). Pair with `onViewportChange`. Omit for
+     * uncontrolled internal state. Exposed so an agent can pan/zoom to point at
+     * something via a bridge.
+     */
+    viewport?: ImageViewerViewport;
+    /** Initial viewport when uncontrolled. */
+    defaultViewport?: ImageViewerViewport;
+    /** Called whenever the viewport (pan/zoom) changes. */
+    onViewportChange?: (viewport: ImageViewerViewport) => void;
+    /** Fired when the image finishes loading. */
+    onLoad?: () => void;
+    /** Fired when the image fails to load. */
+    onError?: () => void;
+    /** Additional CSS classes for the viewport container. */
+    className?: string;
+    /** Inline styles for the viewport container (e.g. a fixed height). */
+    style?: CSSProperties;
+}
+
+export type { ImageViewerProps as I, ImageViewerViewport as a };

package/dist/PdfViewer.types-_u6vboSl.d.cts

@@ -0,0 +1,14 @@
+import { CSSProperties } from 'react';
+
+interface PdfViewerProps {
+    /** PDF source — an `http(s):`, `data:`, or `blob:` URL. */
+    src: string;
+    /** Accessible title for the embedded document (default `"PDF document"`). */
+    title?: string;
+    /** Additional CSS classes for the container. */
+    className?: string;
+    /** Inline styles for the container (e.g. a fixed height). */
+    style?: CSSProperties;
+}
+
+export type { PdfViewerProps as P };

package/dist/PdfViewer.types-_u6vboSl.d.ts

@@ -0,0 +1,14 @@
+import { CSSProperties } from 'react';
+
+interface PdfViewerProps {
+    /** PDF source — an `http(s):`, `data:`, or `blob:` URL. */
+    src: string;
+    /** Accessible title for the embedded document (default `"PDF document"`). */
+    title?: string;
+    /** Additional CSS classes for the container. */
+    className?: string;
+    /** Inline styles for the container (e.g. a fixed height). */
+    style?: CSSProperties;
+}
+
+export type { PdfViewerProps as P };

package/dist/Timeline-7zHhIk3P.d.cts

@@ -0,0 +1,73 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { C as Color } from './types-8Sv0rCjw.cjs';
+
+type TimelineVariant = "stacked" | "alternating" | "horizontal";
+/** @deprecated Use TimelineVariant instead */
+type TimelineOrientation = "vertical" | "horizontal";
+interface TimelineEvent {
+    /** Free-form date string */
+    date?: string;
+    /** Event heading */
+    title: string;
+    /** Body text (rendered as children) */
+    description?: string;
+    /** Emoji character for the dot */
+    emoji?: string;
+    /** Custom icon ReactNode for the dot */
+    icon?: ReactNode;
+    /** Accent color for the dot */
+    color?: Color;
+}
+interface TimelineProps {
+    children?: ReactNode;
+    /** Layout variant. Default: "stacked" */
+    variant?: TimelineVariant;
+    /** @deprecated Use variant instead. Maps "vertical" → "stacked", "horizontal" → "horizontal" */
+    orientation?: TimelineOrientation;
+    /** Data-driven events (alternative to children) */
+    events?: TimelineEvent[];
+    /** Optional heading above the timeline */
+    heading?: ReactNode;
+    /** Optional description below the heading */
+    description?: ReactNode;
+    /** Enable scroll-reveal animation. Default: true */
+    animated?: boolean;
+    className?: string;
+}
+interface TimelineItemProps {
+    children?: ReactNode;
+    /** Custom icon ReactNode for the dot */
+    icon?: ReactNode;
+    /** Emoji character for the dot */
+    emoji?: string;
+    /** Date label displayed above the title */
+    date?: string;
+    /** Dot accent color */
+    color?: Color;
+    /** Whether this item is the active/current step */
+    active?: boolean;
+    className?: string;
+}
+interface TimelineBlockProps {
+    /** Block heading */
+    heading?: ReactNode;
+    /** Block description / body content */
+    children: ReactNode;
+    /** Optional icon displayed in the timeline dot */
+    icon?: ReactNode;
+    /** Emoji character for the dot */
+    emoji?: string;
+    /** Dot/icon color */
+    color?: Color;
+    /** Whether this block is the active/current step */
+    active?: boolean;
+    className?: string;
+}
+
+declare const Timeline: react.ForwardRefExoticComponent<TimelineProps & react.RefAttributes<HTMLDivElement>> & {
+    Item: react.ForwardRefExoticComponent<TimelineItemProps & react.RefAttributes<HTMLDivElement>>;
+    Block: react.ForwardRefExoticComponent<TimelineBlockProps & react.RefAttributes<HTMLDivElement>>;
+};
+
+export { type TimelineItemProps as T, type TimelineBlockProps as a, Timeline as b, type TimelineEvent as c, type TimelineOrientation as d, type TimelineProps as e, type TimelineVariant as f };