@octaviaflow/core 3.0.17-beta.0 → 3.0.18-beta.1

package/dist/components/Banner/Banner.d.ts

@@ -1,14 +1,61 @@
-import type { ReactNode } from "react";
-export interface BannerProps {
-    variant?: "info" | "success" | "warning" | "error" | "promo";
-    icon?: ReactNode;
+import { type ComponentPropsWithoutRef, type ReactNode } from "react";
+export type BannerVariant = "info" | "success" | "warning" | "error" | "promo" | "neutral";
+export type BannerSize = "sm" | "md" | "lg";
+/** Direction the banner slides in / out from. Default = `down` (enters
+ * slightly above its final position, settles down + fades in). */
+export type BannerAnimateFrom = "top" | "bottom" | "left" | "right" | "none";
+export type BannerAppearance = "filled" | "outlined" | "subtle";
+export interface BannerProps extends Omit<ComponentPropsWithoutRef<"div">, "color" | "title"> {
+    /** Visual / semantic variant. `error` defaults to `role="alert"`; the rest
+     * default to `role="status"` (polite live region). */
+    variant?: BannerVariant;
+    /** Size variant. */
+    size?: BannerSize;
+    /** Appearance treatment. `filled` (default) uses the variant's bg/border;
+     * `outlined` keeps the border but drops the fill; `subtle` mutes both. */
+    appearance?: BannerAppearance;
+    /** Leading icon. If omitted, Banner renders a sensible default per
+     * variant (info/success/warning/error/promo). Pass `null` explicitly to
+     * suppress the default. */
+    icon?: ReactNode | null;
     title?: ReactNode;
     description?: ReactNode;
+    /** Trailing action slot (typically a Button). */
     action?: ReactNode;
+    /** Renders a dismiss `×` button on the trailing edge. */
     dismissible?: boolean;
+    /** Fires when the dismiss button is clicked. */
     onDismiss?: () => void;
+    /** Accessible label for the dismiss button. Defaults to "Dismiss". */
+    dismissLabel?: string;
+    /** Override the inferred role. Pass explicitly for non-default
+     * announcements ("alert", "alertdialog", "region", etc.). */
+    role?: ComponentPropsWithoutRef<"div">["role"];
+    /** Auto-focus the banner when it first mounts. Useful for error banners
+     * that should grab focus on appearance so AT users notice them. */
+    autoFocus?: boolean;
+    /** Controls whether the banner is mounted. Pair with `useBanner()` for
+     * declarative show/hide state, or wire to your own state. When omitted,
+     * the banner is always mounted (the regular, animation-free shape). */
+    open?: boolean;
+    /** Direction the enter/exit animation slides from. Defaults to `top`.
+     * `none` disables the slide entirely (still fades). */
+    animateFrom?: BannerAnimateFrom;
+    /** Disable all enter/exit motion. Use when the banner is part of a
+     * larger animation managed externally. */
+    disableAnimation?: boolean;
+    /** Render Banner's styling onto a custom child element (Radix-style Slot).
+     *
+     * Example — a clickable banner-as-link:
+     *   <Banner asChild variant="promo">
+     *     <a href="/changelog">New release! See what's new →</a>
+     *   </Banner>
+     *
+     * When `asChild` is true, Banner does NOT render its internal icon /
+     * title / description / action / dismiss slots. The consumer's element
+     * fully owns the content. */
+    asChild?: boolean;
     children?: ReactNode;
-    className?: string;
 }
-export declare function Banner({ variant, icon, title, description, action, dismissible, onDismiss, children, className, }: BannerProps): import("react/jsx-runtime").JSX.Element;
+export declare const Banner: import("react").ForwardRefExoticComponent<BannerProps & import("react").RefAttributes<HTMLDivElement>>;
 //# sourceMappingURL=Banner.d.ts.map

package/dist/components/Banner/Banner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Banner.d.ts","sourceRoot":"","sources":["../../../src/components/Banner/Banner.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;IAC7D,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,MAAM,CAAC,EACrB,OAAgB,EAChB,IAAI,EACJ,KAAK,EACL,WAAW,EACX,MAAM,EACN,WAAmB,EACnB,SAAS,EACT,QAAQ,EACR,SAAS,GACV,EAAE,WAAW,2CAiCb"}
+{"version":3,"file":"Banner.d.ts","sourceRoot":"","sources":["../../../src/components/Banner/Banner.tsx"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,wBAAwB,EAI7B,KAAK,SAAS,EAIf,MAAM,OAAO,CAAC;AAQf,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;AAC3F,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE5C;kEACkE;AAClE,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAC7E,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEhE,MAAM,WAAW,WACf,SAAQ,IAAI,CAAC,wBAAwB,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IAChE;0DACsD;IACtD,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,oBAAoB;IACpB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB;8EAC0E;IAC1E,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAE9B;;+BAE2B;IAC3B,IAAI,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IACxB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,WAAW,CAAC,EAAE,SAAS,CAAC;IAExB,iDAAiD;IACjD,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,yDAAyD;IACzD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,sEAAsE;IACtE,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;iEAC6D;IAC7D,IAAI,CAAC,EAAE,wBAAwB,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC;IAE/C;uEACmE;IACnE,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;2EAEuE;IACvE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;2DACuD;IACvD,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC;8CAC0C;IAC1C,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;;;;;;;iCAS6B;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AA+FD,eAAO,MAAM,MAAM,wGAkKjB,CAAC"}

package/dist/components/Banner/index.d.ts

@@ -1,2 +1,2 @@
-export { Banner, type BannerProps } from "./Banner";
+export { Banner, type BannerAnimateFrom, type BannerAppearance, type BannerProps, type BannerSize, type BannerVariant, } from "./Banner";
 //# sourceMappingURL=index.d.ts.map

package/dist/components/Banner/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/Banner/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/Banner/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,aAAa,GACnB,MAAM,UAAU,CAAC"}

package/dist/components/BarChart/BarChart.d.ts

@@ -1,17 +1,74 @@
-import type { ReactNode } from "react";
+import { type ComponentPropsWithoutRef, type ReactNode } from "react";
+export type BarChartOrientation = "vertical" | "horizontal";
+export type BarChartMode = "single" | "grouped" | "stacked";
+export type BarChartAxis = "y" | "x" | "both" | "none";
 export interface BarDatum {
     label: ReactNode;
     value: number;
     highlighted?: boolean;
+    /** Optional per-bar color override (single-series mode only). */
+    color?: string;
+}
+export interface BarSeries {
+    /** Series id used for keying. */
+    id: string;
+    /** Series legend label. */
+    name: ReactNode;
+    /** Series color. */
+    color: string;
+    /** One value per x-axis tick. Length should match the chart's `data`. */
+    values: number[];
 }
-export interface BarChartProps {
-    data: BarDatum[];
+export interface BarChartProps extends Omit<ComponentPropsWithoutRef<"div">, "title" | "onChange"> {
+    /**
+     * Single-series data. The simplest API — each datum is a (label, value)
+     * pair rendered as one bar.
+     */
+    data?: BarDatum[];
+    /**
+     * Multi-series data. Pass an array of series; each series produces one
+     * bar per x-axis category. Pair with `categories` to label the x-axis,
+     * and pick `mode="grouped"` or `mode="stacked"` to control layout.
+     */
+    series?: BarSeries[];
+    /** Category labels for multi-series mode. Length should match each series' `values`. */
+    categories?: ReactNode[];
+    /** Layout for multi-series. Default `"grouped"`. Ignored when only `data` is provided. */
+    mode?: BarChartMode;
+    /** Bar orientation. Default `"vertical"`. */
+    orientation?: BarChartOrientation;
+    /** Chart drawing area in px. Default 160. */
     height?: number;
+    /** Default bar color for single-series mode. */
     color?: string;
+    /** Highlight color for `highlighted` datums in single-series mode. */
     highlightColor?: string;
     title?: ReactNode;
+    /** Big number rendered on the right side of the header. */
     total?: ReactNode;
-    className?: string;
+    /**
+     * Fixed value-axis cap. When omitted, auto-derived from data (stacked
+     * mode sums the stack; grouped/single uses the max value).
+     */
+    yMax?: number;
+    /** Which axes to render. Default `"y"`. */
+    showAxis?: BarChartAxis;
+    /** Number of value-axis ticks. Default 5 (including 0). */
+    yTicks?: number;
+    /** Format raw value → display string (used on axis labels + tooltip). */
+    formatValue?: (value: number) => string;
+    /** Render the floating hover tooltip with the bar's label + value. Default true. */
+    showTooltip?: boolean;
+    /** Show the legend (multi-series mode only). Default true. */
+    showLegend?: boolean;
+    /** Suppress the mount stagger-grow animation. */
+    disableAnimation?: boolean;
+    /** Accessible label. Auto-generated from `title` + data summary when omitted. */
+    "aria-label"?: string;
+    /** Fires when the user hovers/focuses or leaves a bar. */
+    onBarHover?: (bar: BarDatum | null, index: number | null) => void;
+    /** Fires when the user clicks or activates (Enter/Space) a bar. */
+    onBarClick?: (bar: BarDatum, index: number) => void;
 }
-export declare function BarChart({ data, height, color, highlightColor, title, total, className, }: BarChartProps): import("react/jsx-runtime").JSX.Element;
+export declare const BarChart: import("react").ForwardRefExoticComponent<BarChartProps & import("react").RefAttributes<HTMLDivElement>>;
 //# sourceMappingURL=BarChart.d.ts.map

package/dist/components/BarChart/BarChart.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BarChart.d.ts","sourceRoot":"","sources":["../../../src/components/BarChart/BarChart.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,QAAQ,CAAC,EACvB,IAAI,EACJ,MAAY,EACZ,KAAiB,EACjB,cAAc,EACd,KAAK,EACL,KAAK,EACL,SAAS,GACV,EAAE,aAAa,2CA4Cf"}
+{"version":3,"file":"BarChart.d.ts","sourceRoot":"","sources":["../../../src/components/BarChart/BarChart.tsx"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,wBAAwB,EAG7B,KAAK,SAAS,EAKf,MAAM,OAAO,CAAC;AAOf,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,YAAY,CAAC;AAC5D,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;AAC5D,MAAM,MAAM,YAAY,GAAG,GAAG,GAAG,GAAG,GAAG,MAAM,GAAG,MAAM,CAAC;AAEvD,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,iCAAiC;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,2BAA2B;IAC3B,IAAI,EAAE,SAAS,CAAC;IAChB,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,aACf,SAAQ,IAAI,CAAC,wBAAwB,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IACnE;;;OAGG;IACH,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC;IAClB;;;;OAIG;IACH,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,wFAAwF;IACxF,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;IACzB,0FAA0F;IAC1F,IAAI,CAAC,EAAE,YAAY,CAAC;IAEpB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAElC,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,SAAS,CAAC;IAElB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAExC,oFAAoF;IACpF,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,8DAA8D;IAC9D,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB,iDAAiD;IACjD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B,iFAAiF;IACjF,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAClE,mEAAmE;IACnE,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACrD;AAuBD,eAAO,MAAM,QAAQ,0GAwdpB,CAAC"}

package/dist/components/BarChart/index.d.ts

@@ -1,2 +1,2 @@
-export { BarChart, type BarChartProps, type BarDatum } from "./BarChart";
+export { BarChart, type BarChartAxis, type BarChartMode, type BarChartOrientation, type BarChartProps, type BarDatum, type BarSeries, } from "./BarChart";
 //# sourceMappingURL=index.d.ts.map

package/dist/components/BarChart/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/BarChart/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/BarChart/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,QAAQ,EACb,KAAK,SAAS,GACf,MAAM,YAAY,CAAC"}

package/dist/components/BlogCard/BlogCard.d.ts

@@ -1,13 +1,48 @@
-import type { ReactNode } from "react";
-export interface BlogCardProps {
+import { type ComponentPropsWithoutRef, type ReactNode } from "react";
+import { type AvatarProps } from "../Avatar";
+import { type CardRadius } from "../Card";
+export type BlogCardOrientation = "vertical" | "horizontal";
+export type BlogCardCoverAspect = "16/9" | "4/3" | "1/1" | "3/4" | "21/9";
+export interface BlogCardAuthor {
+    name: ReactNode;
+    /** Optional avatar — passed through to the polished `Avatar` primitive. */
+    avatar?: Pick<AvatarProps, "src" | "initials" | "alt">;
+    /** Optional role / handle / etc. */
+    byline?: ReactNode;
+}
+export interface BlogCardProps extends Omit<ComponentPropsWithoutRef<"div">, "title" | "onChange" | "onDrag" | "onDragStart" | "onDragEnd" | "onAnimationStart"> {
+    /** Cover artwork — usually an `<img>` element, but accepts any node. */
     cover?: ReactNode;
+    /**
+     * Cover aspect ratio. Lets a grid of cards stay visually consistent
+     * regardless of source image dimensions. Default `"16/9"`.
+     */
+    coverAspect?: BlogCardCoverAspect;
+    /** Single category chip (legacy — prefer `tags`). */
     category?: ReactNode;
+    /** Multiple category chips. Rendered before the title. */
+    tags?: ReactNode[];
+    /** Date / publish info — inline meta. */
     meta?: ReactNode;
+    /** Structured reading-time slot. Renders alongside `meta`. */
+    readingTime?: ReactNode;
+    /** Required title — drives `aria-labelledby` on the card. */
     title: ReactNode;
+    /** Heading level for the title. Default `"h3"`. */
+    titleAs?: "h1" | "h2" | "h3" | "h4" | "h5" | "h6";
     description?: ReactNode;
+    /** Structured author block — avatar + name + optional byline. */
+    author?: BlogCardAuthor;
+    /** Right-aligned footer content (call-to-action / "Read more" link). */
+    footer?: ReactNode;
+    /** Card corner radius. */
+    radius?: CardRadius;
+    /** Cover on top (default) or cover on left. */
+    orientation?: BlogCardOrientation;
+    /** When set, the card renders as an `<a>` element. */
     href?: string;
+    /** Click handler. Pairing with `href` is fine; both fire. */
     onClick?: () => void;
-    className?: string;
 }
-export declare function BlogCard({ cover, category, meta, title, description, href, onClick, className, }: BlogCardProps): import("react/jsx-runtime").JSX.Element;
+export declare const BlogCard: import("react").ForwardRefExoticComponent<BlogCardProps & import("react").RefAttributes<HTMLDivElement>>;
 //# sourceMappingURL=BlogCard.d.ts.map

package/dist/components/BlogCard/BlogCard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BlogCard.d.ts","sourceRoot":"","sources":["../../../src/components/BlogCard/BlogCard.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,SAAS,CAAC;IACjB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,QAAQ,CAAC,EACvB,KAAK,EACL,QAAQ,EACR,IAAI,EACJ,KAAK,EACL,WAAW,EACX,IAAI,EACJ,OAAO,EACP,SAAS,GACV,EAAE,aAAa,2CAoBf"}
+{"version":3,"file":"BlogCard.d.ts","sourceRoot":"","sources":["../../../src/components/BlogCard/BlogCard.tsx"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,wBAAwB,EAE7B,KAAK,SAAS,EAEf,MAAM,OAAO,CAAC;AAEf,OAAO,EAAU,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAQ,KAAK,UAAU,EAAE,MAAM,SAAS,CAAC;AAahD,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,YAAY,CAAC;AAC5D,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;AAE1E,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,SAAS,CAAC;IAChB,2EAA2E;IAC3E,MAAM,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,KAAK,GAAG,UAAU,GAAG,KAAK,CAAC,CAAC;IACvD,oCAAoC;IACpC,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAED,MAAM,WAAW,aACf,SAAQ,IAAI,CACV,wBAAwB,CAAC,KAAK,CAAC,EAC7B,OAAO,GACP,UAAU,GACV,QAAQ,GACR,aAAa,GACb,WAAW,GACX,kBAAkB,CACrB;IACD,wEAAwE;IACxE,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;;;OAGG;IACH,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,qDAAqD;IACrD,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,0DAA0D;IAC1D,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC;IACnB,yCAAyC;IACzC,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,6DAA6D;IAC7D,KAAK,EAAE,SAAS,CAAC;IACjB,mDAAmD;IACnD,OAAO,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAClD,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,iEAAiE;IACjE,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,wEAAwE;IACxE,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,0BAA0B;IAC1B,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAMD,eAAO,MAAM,QAAQ,0GAgLpB,CAAC"}

package/dist/components/Button/Button.d.ts

@@ -1,11 +1,20 @@
-import { type ButtonHTMLAttributes, type ReactNode } from "react";
+import { type ButtonHTMLAttributes, type CSSProperties, type ReactNode } from "react";
 export interface ButtonProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, "onDrag" | "onDragStart" | "onDragEnd" | "onAnimationStart"> {
     variant?: "primary" | "secondary" | "ghost" | "danger" | "icon";
     size?: "sm" | "md" | "lg";
     loading?: boolean;
+    /** Override the rendered label while loading. Useful for action verbs that
+     * change form mid-request — e.g. `"Sign in"` → `"Signing in…"`. */
+    loadingText?: ReactNode;
+    /** Accessible label for the spinner (announced by AT during loading).
+     * Defaults to `"Loading"`. Customize for localization or context. */
+    loadingLabel?: string;
     leftIcon?: ReactNode;
     rightIcon?: ReactNode;
     fullWidth?: boolean;
+    /** Toggle-button state. When defined, the button advertises
+     * `aria-pressed` and adds `--pressed` styling. */
+    pressed?: boolean;
     children?: ReactNode;
     /**
      * Override the cursor shown on hover. When omitted, the cursor auto-resolves:
@@ -17,9 +26,18 @@ export interface ButtonProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement
      * Pass an explicit value (e.g. `"text"`, `"grab"`) to override the
      * auto-resolve for the specific story / use case.
      */
-    cursor?: ButtonHTMLAttributes<HTMLButtonElement>["style"] extends infer S ? S extends {
-        cursor?: infer C;
-    } ? C : string : string;
+    cursor?: CSSProperties["cursor"];
+    /** Render Button's styling onto a custom child element (Radix-style Slot).
+     *
+     *   <Button asChild variant="primary">
+     *     <NextLink href="/checkout">Continue</NextLink>
+     *   </Button>
+     *
+     * When `asChild` is true, Button does NOT render its internal icon /
+     * label / spinner slots — the consumer's element fully owns content. Use
+     * the regular form (without `asChild`) when you want the built-in
+     * slots / loading spinner / size-scaled icons. */
+    asChild?: boolean;
 }
-export declare function Button({ variant, size, loading, disabled, leftIcon, rightIcon, fullWidth, className, children, type, cursor, style, ...props }: ButtonProps): import("react/jsx-runtime").JSX.Element;
+export declare const Button: import("react").ForwardRefExoticComponent<ButtonProps & import("react").RefAttributes<HTMLButtonElement>>;
 //# sourceMappingURL=Button.d.ts.map

package/dist/components/Button/Button.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Button.d.ts","sourceRoot":"","sources":["../../../src/components/Button/Button.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,oBAAoB,EAAE,KAAK,SAAS,EAAU,MAAM,OAAO,CAAC;AAK1E,MAAM,WAAW,WACf,SAAQ,IAAI,CACV,oBAAoB,CAAC,iBAAiB,CAAC,EACvC,QAAQ,GAAG,aAAa,GAAG,WAAW,GAAG,kBAAkB,CAC5D;IACD,OAAO,CAAC,EAAE,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;IAChE,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,oBAAoB,CAAC,iBAAiB,CAAC,CAAC,OAAO,CAAC,SAAS,MAAM,CAAC,GACrE,CAAC,SAAS;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAA;KAAE,GAC5B,CAAC,GACD,MAAM,GACR,MAAM,CAAC;CACZ;AAED,wBAAgB,MAAM,CAAC,EACrB,OAAmB,EACnB,IAAW,EACX,OAAe,EACf,QAAgB,EAChB,QAAQ,EACR,SAAS,EACT,SAAiB,EACjB,SAAS,EACT,QAAQ,EACR,IAAI,EACJ,MAAM,EACN,KAAK,EACL,GAAG,KAAK,EACT,EAAE,WAAW,2CA6Hb"}
+{"version":3,"file":"Button.d.ts","sourceRoot":"","sources":["../../../src/components/Button/Button.tsx"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAGlB,KAAK,SAAS,EAIf,MAAM,OAAO,CAAC;AAMf,MAAM,WAAW,WACf,SAAQ,IAAI,CACV,oBAAoB,CAAC,iBAAiB,CAAC,EACvC,QAAQ,GAAG,aAAa,GAAG,WAAW,GAAG,kBAAkB,CAC5D;IACD,OAAO,CAAC,EAAE,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;IAChE,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;uEACmE;IACnE,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB;yEACqE;IACrE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;sDACkD;IAClD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IACjC;;;;;;;;;sDASkD;IAClD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,eAAO,MAAM,MAAM,2GAgMjB,CAAC"}

package/dist/components/Calendar/Calendar.d.ts

@@ -1,17 +1,66 @@
+import { type ComponentPropsWithoutRef } from "react";
 export type DateRange = {
     start: Date | null;
     end: Date | null;
 };
-export interface CalendarProps {
+/** Week-day index (0=Sun, 1=Mon, …, 6=Sat). */
+export type WeekStart = 0 | 1 | 2 | 3 | 4 | 5 | 6;
+export interface CalendarProps extends Omit<ComponentPropsWithoutRef<"div">, "onChange" | "defaultValue"> {
+    /** "single" picks one date; "range" picks a start + end date. */
     mode?: "single" | "range";
+    /** Selected value. For `mode="single"` pass a `Date | null`; for
+     * `mode="range"` pass `{ start, end }`. */
     value?: Date | DateRange | null;
     onChange?: (value: Date | DateRange | null) => void;
+    /** Uncontrolled initial visible month. */
+    defaultMonth?: Date;
+    /** Controlled visible month (1st of month). */
     month?: Date;
     onMonthChange?: (month: Date) => void;
+    /** Hard min / max bounds — dates outside this range are disabled. */
     minDate?: Date;
     maxDate?: Date;
-    weekStartsOn?: 0 | 1;
-    className?: string;
+    /** Predicate for arbitrary per-date disabling (weekends, holidays, …).
+     * Runs in addition to min/max bounds. */
+    isDateDisabled?: (date: Date) => boolean;
+    /** Day of week the grid starts on. 0=Sun (US default), 1=Mon (ISO), etc. */
+    weekStartsOn?: WeekStart;
+    /** Number of months rendered side-by-side. 1 (default) or 2. */
+    numberOfMonths?: 1 | 2;
+    /** Locale tag for Intl formatting (month name + weekday header).
+     * Defaults to the user agent's locale. */
+    locale?: string;
+    /** Show a footer with `Today` / `Clear` actions. */
+    showFooter?: boolean;
+    todayLabel?: string;
+    clearLabel?: string;
+    /**
+     * Header layout:
+     *   - `"label"`     (default) — month + year as a static caption
+     *   - `"dropdowns"` — month + year become `<select>`s so users can
+     *                     jump directly to any month/year without
+     *                     paginating month-by-month.
+     *
+     * The prev / next month arrows render in both modes; the dropdowns
+     * are the fast-jump path on top.
+     */
+    captionLayout?: "label" | "dropdowns";
+    /**
+     * Year-dropdown lower bound. When omitted, defaults to either
+     * `minDate.getFullYear()` (when set) or `today - 50`.
+     */
+    fromYear?: number;
+    /**
+     * Year-dropdown upper bound. When omitted, defaults to either
+     * `maxDate.getFullYear()` (when set) or `today + 50`.
+     */
+    toYear?: number;
+    /** When true, the grid focuses its initial date on mount. Use in popovers
+     * so keyboard users land inside the calendar immediately. */
+    autoFocus?: boolean;
+    /** Accessible label for the calendar grid. */
+    "aria-label"?: string;
 }
-export declare function Calendar({ mode, value, onChange, month, onMonthChange, minDate, maxDate, weekStartsOn, className, }: CalendarProps): import("react/jsx-runtime").JSX.Element;
+export declare const Calendar: import("react").ForwardRefExoticComponent<CalendarProps & import("react").RefAttributes<HTMLDivElement>>;
+export default Calendar;
 //# sourceMappingURL=Calendar.d.ts.map

package/dist/components/Calendar/Calendar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Calendar.d.ts","sourceRoot":"","sources":["../../../src/components/Calendar/Calendar.tsx"],"names":[],"mappings":"AAIA,MAAM,MAAM,SAAS,GAAG;IAAE,KAAK,EAAE,IAAI,GAAG,IAAI,CAAC;IAAC,GAAG,EAAE,IAAI,GAAG,IAAI,CAAA;CAAE,CAAC;AAEjE,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IAC1B,KAAK,CAAC,EAAE,IAAI,GAAG,SAAS,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,GAAG,SAAS,GAAG,IAAI,KAAK,IAAI,CAAC;IACpD,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,KAAK,IAAI,CAAC;IACtC,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA4BD,wBAAgB,QAAQ,CAAC,EACvB,IAAe,EACf,KAAY,EACZ,QAAQ,EACR,KAAK,EACL,aAAa,EACb,OAAO,EACP,OAAO,EACP,YAAgB,EAChB,SAAS,GACV,EAAE,aAAa,2CA8If"}
+{"version":3,"file":"Calendar.d.ts","sourceRoot":"","sources":["../../../src/components/Calendar/Calendar.tsx"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,wBAAwB,EAU9B,MAAM,OAAO,CAAC;AAQf,MAAM,MAAM,SAAS,GAAG;IAAE,KAAK,EAAE,IAAI,GAAG,IAAI,CAAC;IAAC,GAAG,EAAE,IAAI,GAAG,IAAI,CAAA;CAAE,CAAC;AAEjE,+CAA+C;AAC/C,MAAM,MAAM,SAAS,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAElD,MAAM,WAAW,aACf,SAAQ,IAAI,CAAC,wBAAwB,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,cAAc,CAAC;IAC1E,iEAAiE;IACjE,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IAC1B;+CAC2C;IAC3C,KAAK,CAAC,EAAE,IAAI,GAAG,SAAS,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,GAAG,SAAS,GAAG,IAAI,KAAK,IAAI,CAAC;IAEpD,0CAA0C;IAC1C,YAAY,CAAC,EAAE,IAAI,CAAC;IACpB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,KAAK,IAAI,CAAC;IAEtC,qEAAqE;IACrE,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,OAAO,CAAC,EAAE,IAAI,CAAC;IACf;6CACyC;IACzC,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC;IAEzC,4EAA4E;IAC5E,YAAY,CAAC,EAAE,SAAS,CAAC;IAEzB,gEAAgE;IAChE,cAAc,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAEvB;8CAC0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,oDAAoD;IACpD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;;;;;;OASG;IACH,aAAa,CAAC,EAAE,OAAO,GAAG,WAAW,CAAC;IAEtC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;iEAC6D;IAC7D,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,8CAA8C;IAC9C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAiCD,eAAO,MAAM,QAAQ,0GAscnB,CAAC;AAIH,eAAe,QAAQ,CAAC"}

package/dist/components/CalendarHeatmap/CalendarHeatmap.d.ts

@@ -0,0 +1,47 @@
+import { type ComponentPropsWithoutRef, type ReactNode } from "react";
+export interface CalendarDay {
+    /** ISO date `YYYY-MM-DD` (or a `Date`). */
+    date: string | Date;
+    value: number;
+    label?: ReactNode;
+    color?: string;
+}
+export interface CalendarHeatmapProps extends Omit<ComponentPropsWithoutRef<"div">, "title" | "onChange"> {
+    data: CalendarDay[];
+    /** Inclusive start date for the grid. Default: data min OR (today - 1y). */
+    startDate?: string | Date;
+    /** Inclusive end date for the grid. Default: data max OR today. */
+    endDate?: string | Date;
+    /** N color stops low → high. Default = accent ramp. */
+    colorScale?: string[];
+    /** Lower bound of value domain. Default: data min OR 0. */
+    domainMin?: number;
+    /** Upper bound of value domain. Default: data max OR 1. */
+    domainMax?: number;
+    /** Color for days with no entry. */
+    emptyColor?: string;
+    /** Cell pixel size. Default 12. */
+    cellSize?: number;
+    /** Gap between cells. Default 2. */
+    cellGap?: number;
+    /** Cell corner radius (CSS length). Default `var(--ods-radius-1)`. */
+    cellRadius?: string;
+    /** Week start day. 0 = Sunday, 1 = Monday. Default 0. */
+    weekStartsOn?: 0 | 1;
+    title?: ReactNode;
+    total?: ReactNode;
+    /** Show the month labels along the top. Default true. */
+    showMonthLabels?: boolean;
+    /** Show the weekday labels along the left. Default true. */
+    showWeekdayLabels?: boolean;
+    /** Show the legend (less / more) below the grid. Default true. */
+    showLegend?: boolean;
+    formatValue?: (value: number) => string;
+    formatDate?: (date: Date) => string;
+    disableAnimation?: boolean;
+    "aria-label"?: string;
+    onDayHover?: (day: CalendarDay | null, date: Date | null) => void;
+    onDayClick?: (day: CalendarDay, date: Date) => void;
+}
+export declare const CalendarHeatmap: import("react").ForwardRefExoticComponent<CalendarHeatmapProps & import("react").RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=CalendarHeatmap.d.ts.map

package/dist/components/CalendarHeatmap/CalendarHeatmap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CalendarHeatmap.d.ts","sourceRoot":"","sources":["../../../src/components/CalendarHeatmap/CalendarHeatmap.tsx"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,wBAAwB,EAG7B,KAAK,SAAS,EAKf,MAAM,OAAO,CAAC;AAWf,MAAM,WAAW,WAAW;IAC1B,2CAA2C;IAC3C,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBACf,SAAQ,IAAI,CAAC,wBAAwB,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IACnE,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,yDAAyD;IACzD,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAErB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,yDAAyD;IACzD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,4DAA4D;IAC5D,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,kEAAkE;IAClE,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACxC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC;IAEpC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,KAAK,IAAI,CAAC;IAClE,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;CACrD;AAoED,eAAO,MAAM,eAAe,iHAiV1B,CAAC"}

package/dist/components/CalendarHeatmap/index.d.ts

@@ -0,0 +1,2 @@
+export { CalendarHeatmap, type CalendarDay, type CalendarHeatmapProps, } from "./CalendarHeatmap";
+//# sourceMappingURL=index.d.ts.map

package/dist/components/CalendarHeatmap/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/CalendarHeatmap/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,KAAK,WAAW,EAChB,KAAK,oBAAoB,GAC1B,MAAM,mBAAmB,CAAC"}

package/dist/components/Callout/Callout.d.ts

@@ -1,10 +1,36 @@
-import type { ReactNode } from "react";
-export interface CalloutProps {
-    variant?: "tip" | "info" | "warning" | "danger" | "success";
+import { type ComponentPropsWithoutRef, type ReactNode } from "react";
+export type CalloutVariant = "tip" | "info" | "warning" | "danger" | "success" | "neutral";
+export type CalloutSize = "sm" | "md" | "lg";
+export interface CalloutProps extends Omit<ComponentPropsWithoutRef<"div">, "color" | "title"> {
+    variant?: CalloutVariant;
+    size?: CalloutSize;
+    /** Heading shown above the body content. */
     title?: ReactNode;
-    icon?: ReactNode;
-    children: ReactNode;
-    className?: string;
+    /** Override the default per-variant icon. Pass `null` to suppress entirely. */
+    icon?: ReactNode | null;
+    /** Render a dismiss `×` button on the trailing edge. */
+    dismissible?: boolean;
+    /** Fires when the dismiss button is clicked. */
+    onDismiss?: () => void;
+    /** Accessible label for the dismiss button. Defaults to "Dismiss". */
+    dismissLabel?: string;
+    /** Override the inferred ARIA role. `danger` → `role="alert"`; the rest
+     * stay an unlabelled inline block (callouts are usually documentation,
+     * not live regions). Override explicitly when needed. */
+    role?: ComponentPropsWithoutRef<"div">["role"];
+    /** Render Callout's styling onto a custom child element (Radix-style
+     * Slot). Internal slots (icon, title, dismiss) are NOT rendered — the
+     * consumer's element fully owns content. Useful for "callout-as-link"
+     * or wrapping a router-link as a tip card. */
+    asChild?: boolean;
+    /** Controls whether the callout is mounted. Pair with `useCallout()` for
+     * declarative dismiss + persistence, or wire to your own state. When
+     * omitted, the callout is always mounted (the regular static shape). */
+    open?: boolean;
+    /** Disable the enter/exit animation. Use when the callout is part of a
+     * larger animation managed externally. */
+    disableAnimation?: boolean;
+    children?: ReactNode;
 }
-export declare function Callout({ variant, title, icon, children, className }: CalloutProps): import("react/jsx-runtime").JSX.Element;
+export declare const Callout: import("react").ForwardRefExoticComponent<CalloutProps & import("react").RefAttributes<HTMLDivElement>>;
 //# sourceMappingURL=Callout.d.ts.map

package/dist/components/Callout/Callout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Callout.d.ts","sourceRoot":"","sources":["../../../src/components/Callout/Callout.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC5D,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,QAAQ,EAAE,SAAS,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,OAAO,CAAC,EAAE,OAAe,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,YAAY,2CAc1F"}
+{"version":3,"file":"Callout.d.ts","sourceRoot":"","sources":["../../../src/components/Callout/Callout.tsx"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,wBAAwB,EAI7B,KAAK,SAAS,EAEf,MAAM,OAAO,CAAC;AAQf,MAAM,MAAM,cAAc,GACtB,KAAK,GACL,MAAM,GACN,SAAS,GACT,QAAQ,GACR,SAAS,GACT,SAAS,CAAC;AAEd,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE7C,MAAM,WAAW,YACf,SAAQ,IAAI,CAAC,wBAAwB,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IAChE,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,+EAA+E;IAC/E,IAAI,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAExB,wDAAwD;IACxD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,sEAAsE;IACtE,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;6DAEyD;IACzD,IAAI,CAAC,EAAE,wBAAwB,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC;IAE/C;;;kDAG8C;IAC9C,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;4EAEwE;IACxE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;8CAC0C;IAC1C,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AA+FD,eAAO,MAAM,OAAO,yGA4HlB,CAAC"}

package/dist/components/Callout/index.d.ts

@@ -1,2 +1,2 @@
-export { Callout, type CalloutProps } from "./Callout";
+export { Callout, type CalloutProps, type CalloutSize, type CalloutVariant, } from "./Callout";
 //# sourceMappingURL=index.d.ts.map

package/dist/components/Callout/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/Callout/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/Callout/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,cAAc,GACpB,MAAM,WAAW,CAAC"}

package/dist/components/Card/Card.d.ts

@@ -1,11 +1,52 @@
-import type { HTMLAttributes, ReactNode } from "react";
-export interface CardProps extends Omit<HTMLAttributes<HTMLDivElement>, "onDrag" | "onDragStart" | "onDragEnd" | "onAnimationStart"> {
-    variant?: "default" | "glass" | "elevated" | "selected" | "outlined";
-    padding?: "none" | "sm" | "md" | "lg" | "xl";
-    radius?: "sm" | "md" | "lg" | "xl" | "2xl";
+import { type ComponentPropsWithoutRef, type ReactNode } from "react";
+export type CardVariant = "default" | "elevated" | "outlined" | "subtle" | "selected";
+export type CardPadding = "none" | "sm" | "md" | "lg" | "xl";
+export type CardRadius = "none" | "sm" | "md" | "lg";
+export interface CardProps extends Omit<ComponentPropsWithoutRef<"div">, "onDrag" | "onDragStart" | "onDragEnd" | "onAnimationStart"> {
+    variant?: CardVariant;
+    padding?: CardPadding;
+    radius?: CardRadius;
+    /** Apply hover affordance (lift + tint) without making the card clickable.
+     * For purely-visual surfaces that respond to mouse-over. */
     hoverable?: boolean;
-    children: ReactNode;
-    className?: string;
+    /** Disable a clickable card. Adds `aria-disabled` and suppresses interaction. */
+    disabled?: boolean;
+    /** Loading skeleton — replaces the card chrome with a shimmer block of
+     * the same height. */
+    loading?: boolean;
+    /** Render Card's styling onto a custom child element (Radix-style Slot).
+     *
+     *   <Card asChild variant="elevated">
+     *     <NextLink href="/blog/post-1">{...}</NextLink>
+     *   </Card>
+     *
+     * When set, Card does NOT wrap the child in motion.div — the consumer's
+     * element fully owns content. Use without asChild for the built-in
+     * hover / tap motion + keyboard activation. */
+    asChild?: boolean;
+    children?: ReactNode;
 }
-export declare function Card({ variant, padding, radius, hoverable, onClick, children, className, ...props }: CardProps): import("react/jsx-runtime").JSX.Element;
+export declare const Card: React.ForwardRefExoticComponent<CardProps & React.RefAttributes<HTMLDivElement>> & {
+    Header: typeof CardHeader;
+    Body: typeof CardBody;
+    Footer: typeof CardFooter;
+    Title: typeof CardTitle;
+    Description: typeof CardDescription;
+};
+export interface CardSectionProps extends ComponentPropsWithoutRef<"div"> {
+    children?: ReactNode;
+}
+export declare const CardHeader: import("react").ForwardRefExoticComponent<CardSectionProps & import("react").RefAttributes<HTMLDivElement>>;
+export declare const CardBody: import("react").ForwardRefExoticComponent<CardSectionProps & import("react").RefAttributes<HTMLDivElement>>;
+export declare const CardFooter: import("react").ForwardRefExoticComponent<CardSectionProps & import("react").RefAttributes<HTMLDivElement>>;
+export interface CardTitleProps extends ComponentPropsWithoutRef<"h3"> {
+    /** Override the heading level. Defaults to `<h3>`. */
+    as?: "h1" | "h2" | "h3" | "h4" | "h5" | "h6";
+    children?: ReactNode;
+}
+export declare const CardTitle: import("react").ForwardRefExoticComponent<CardTitleProps & import("react").RefAttributes<HTMLHeadingElement>>;
+export interface CardDescriptionProps extends ComponentPropsWithoutRef<"p"> {
+    children?: ReactNode;
+}
+export declare const CardDescription: import("react").ForwardRefExoticComponent<CardDescriptionProps & import("react").RefAttributes<HTMLParagraphElement>>;
 //# sourceMappingURL=Card.d.ts.map

package/dist/components/Card/Card.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Card.d.ts","sourceRoot":"","sources":["../../../src/components/Card/Card.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvD,MAAM,WAAW,SACf,SAAQ,IAAI,CACV,cAAc,CAAC,cAAc,CAAC,EAC9B,QAAQ,GAAG,aAAa,GAAG,WAAW,GAAG,kBAAkB,CAC5D;IACD,OAAO,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,CAAC;IACrE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC7C,MAAM,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;IAC3C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,SAAS,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,IAAI,CAAC,EACnB,OAAmB,EACnB,OAAc,EACd,MAAa,EACb,SAAiB,EACjB,OAAO,EACP,QAAQ,EACR,SAAS,EACT,GAAG,KAAK,EACT,EAAE,SAAS,2CA2BX"}
+{"version":3,"file":"Card.d.ts","sourceRoot":"","sources":["../../../src/components/Card/Card.tsx"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,wBAAwB,EAK7B,KAAK,SAAS,EAEf,MAAM,OAAO,CAAC;AAQf,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,GAAG,UAAU,CAAC;AACtF,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAC7D,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAErD,MAAM,WAAW,SACf,SAAQ,IAAI,CACV,wBAAwB,CAAC,KAAK,CAAC,EAC/B,QAAQ,GAAG,aAAa,GAAG,WAAW,GAAG,kBAAkB,CAC5D;IACD,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB;gEAC4D;IAC5D,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;0BACsB;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;;;;mDAQ+C;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAMD,eAAO,MAAM,IAAI,EAgGX,KAAK,CAAC,yBAAyB,CACnC,SAAS,GAAG,KAAK,CAAC,aAAa,CAAC,cAAc,CAAC,CAChD,GAAG;IACF,MAAM,EAAE,OAAO,UAAU,CAAC;IAC1B,IAAI,EAAE,OAAO,QAAQ,CAAC;IACtB,MAAM,EAAE,OAAO,UAAU,CAAC;IAC1B,KAAK,EAAE,OAAO,SAAS,CAAC;IACxB,WAAW,EAAE,OAAO,eAAe,CAAC;CACrC,CAAC;AAUF,MAAM,WAAW,gBAAiB,SAAQ,wBAAwB,CAAC,KAAK,CAAC;IACvE,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,eAAO,MAAM,UAAU,6GAQtB,CAAC;AAGF,eAAO,MAAM,QAAQ,6GAQpB,CAAC;AAGF,eAAO,MAAM,UAAU,6GAQtB,CAAC;AAGF,MAAM,WAAW,cAAe,SAAQ,wBAAwB,CAAC,IAAI,CAAC;IACpE,sDAAsD;IACtD,EAAE,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC7C,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,eAAO,MAAM,SAAS,+GAYrB,CAAC;AAGF,MAAM,WAAW,oBAAqB,SAAQ,wBAAwB,CAAC,GAAG,CAAC;IACzE,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,eAAO,MAAM,eAAe,uHAS1B,CAAC"}

package/dist/components/Card/index.d.ts

@@ -1,2 +1,2 @@
-export { Card, type CardProps } from "./Card";
+export { Card, CardBody, CardDescription, type CardDescriptionProps, CardFooter, CardHeader, type CardPadding, type CardProps, type CardRadius, type CardSectionProps, CardTitle, type CardTitleProps, type CardVariant, } from "./Card";
 //# sourceMappingURL=index.d.ts.map

package/dist/components/Card/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/Card/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,KAAK,SAAS,EAAE,MAAM,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/Card/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,IAAI,EACJ,QAAQ,EACR,eAAe,EACf,KAAK,oBAAoB,EACzB,UAAU,EACV,UAAU,EACV,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,SAAS,EACT,KAAK,cAAc,EACnB,KAAK,WAAW,GACjB,MAAM,QAAQ,CAAC"}