@octaviaflow/core 3.0.18-beta.0 → 3.0.18

package/dist/components/Accordion/Accordion.d.ts

@@ -0,0 +1,45 @@
+import { type ComponentPropsWithoutRef, type ReactNode } from "react";
+export type AccordionMode = "single" | "multiple";
+export type AccordionVariant = "default" | "bordered" | "separated";
+export interface AccordionItem {
+    /** Stable identifier. */
+    id: string;
+    /** Header label. */
+    label: ReactNode;
+    /** Optional secondary line below the label. */
+    description?: ReactNode;
+    /** Optional leading icon. */
+    icon?: ReactNode;
+    /** Optional trailing slot in the header (badge, count, action). */
+    trailing?: ReactNode;
+    /** Panel content. */
+    content: ReactNode;
+    /** Disable interaction for this item. */
+    disabled?: boolean;
+}
+export interface AccordionProps extends Omit<ComponentPropsWithoutRef<"div">, "onChange" | "defaultValue" | "children" | "onDrag" | "onDragStart" | "onDragEnd" | "onAnimationStart"> {
+    /** Items to render. */
+    items: AccordionItem[];
+    /** Single vs multiple expansion. Default `"single"`. */
+    mode?: AccordionMode;
+    /** Controlled expanded item ids. */
+    value?: string[];
+    /** Uncontrolled initial expanded ids. */
+    defaultValue?: string[];
+    /** Fires when the expanded set changes. */
+    onValueChange?: (value: string[]) => void;
+    /**
+     * Allow the last open item to be closed (single mode). Default
+     * `true`. When `false`, one item is always open — useful for tabbed-
+     * like surfaces.
+     */
+    collapsible?: boolean;
+    /** Visual variant. Default `"default"`. */
+    variant?: AccordionVariant;
+    /** Visual size. Default `"md"`. */
+    size?: "sm" | "md" | "lg";
+    /** Disable the entire accordion. */
+    disabled?: boolean;
+}
+export declare const Accordion: import("react").ForwardRefExoticComponent<AccordionProps & import("react").RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=Accordion.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Accordion.d.ts","sourceRoot":"","sources":["../../../src/components/Accordion/Accordion.tsx"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,wBAAwB,EAG7B,KAAK,SAAS,EAIf,MAAM,OAAO,CAAC;AAoBf,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,UAAU,CAAC;AAClD,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;AAEpE,MAAM,WAAW,aAAa;IAC5B,yBAAyB;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,oBAAoB;IACpB,KAAK,EAAE,SAAS,CAAC;IACjB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,6BAA6B;IAC7B,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,qBAAqB;IACrB,OAAO,EAAE,SAAS,CAAC;IACnB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,cACf,SAAQ,IAAI,CACV,wBAAwB,CAAC,KAAK,CAAC,EAC7B,UAAU,GACV,cAAc,GACd,UAAU,GACV,QAAQ,GACR,aAAa,GACb,WAAW,GACX,kBAAkB,CACrB;IACD,uBAAuB;IACvB,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,wDAAwD;IACxD,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,yCAAyC;IACzC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,2CAA2C;IAC3C,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAC1C;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,mCAAmC;IACnC,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1B,oCAAoC;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAMD,eAAO,MAAM,SAAS,2GA0MrB,CAAC"}

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

@@ -0,0 +1,2 @@
+export { Accordion, type AccordionItem, type AccordionMode, type AccordionProps, type AccordionVariant, } from "./Accordion";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/Accordion/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,gBAAgB,GACtB,MAAM,aAAa,CAAC"}

package/dist/components/AgentCard/AgentCard.d.ts

@@ -1,25 +1,71 @@
-import type { ReactNode } from "react";
-export type AgentStatus = "idle" | "running" | "failed" | "paused" | "draft";
+import { type ReactNode } from "react";
+/**
+ * The catalog variant of AgentCard — identity + capability summary for
+ * the agent catalog browse experience. Other variants ship as sibling
+ * components (AgentStatusCard, AgentProviderCard, etc.) to keep the API
+ * narrow and the typing precise per-shape.
+ */
+/** Agent runtime states. Added `success` in v1.1. Re-mapped `paused` to
+ * a neutral surface (was status-pending which read as warning-in-progress). */
+export type AgentStatus = "idle" | "running" | "success" | "failed" | "paused" | "draft";
+/** DAG node taxonomy — drives the avatar surface color so the catalog
+ * grid color-codes agents by their role at a glance. */
+export type AgentType = "trigger" | "action" | "transform" | "condition" | "io";
+/** Three sizes for different surfaces — sm for compact lists, md for catalog
+ * grids (default), lg for hero / featured placements. */
+export type AgentCardSize = "sm" | "md" | "lg";
+/** Density modifier — comfortable matches the default; dense tightens
+ * vertical rhythm for high-information surfaces (admin tables, etc.). */
+export type AgentCardDensity = "comfortable" | "dense";
 export interface AgentCardProps {
+    /** Agent display name. */
     name: ReactNode;
-    /** Optional role / one-line description. */
+    /** Optional role / one-line description (e.g. "Routing", "Schema drift detector"). */
     role?: ReactNode;
-    /** Avatar / glyph for the agent. Defaults to initial of `name`. */
+    /** Avatar / glyph for the agent. Defaults to the first character of `name`. */
     avatar?: ReactNode;
     /** Model identifier (e.g. "claude-opus-4-7", "gpt-4o"). */
     model?: string;
-    /** Status pill on the right. */
+    /** Runtime status. Drives the right-aligned status pill. */
     status?: AgentStatus;
+    /** Agent type — colors the avatar surface per the DAG node taxonomy. */
+    agentType?: AgentType;
     /** Tool count badge. */
     toolCount?: number;
-    /** Hover affordance. */
+    /** Tags rendered as a chip cluster below the meta row. */
+    tags?: readonly string[];
+    /** Maximum number of tag chips to render before collapsing the rest
+     * into a `+N` overflow chip. Defaults are size-aware (sm: 2, md: 3,
+     * lg: 4). Pass `Infinity` or `0` to render every tag without overflow. */
+    maxTags?: number;
+    /** When the agent was last used. Accepts a Date or ISO string. Displayed as relative time. */
+    lastUsedAt?: Date | string;
+    /** Size variant. */
+    size?: AgentCardSize;
+    /** Density modifier. */
+    density?: AgentCardDensity;
+    /** Hover affordance. Use when the card is clickable. */
     interactive?: boolean;
+    /** Renders a checkbox in the top-left for multi-select grids. */
+    selectable?: boolean;
+    /** Controlled selection state. Pair with `onSelectChange`. */
+    selected?: boolean;
+    /** Fires when the checkbox is toggled. */
+    onSelectChange?: (selected: boolean) => void;
+    /** Loading skeleton state — replaces content with shimmer blocks. */
+    loading?: boolean;
+    /** Error state — shows the message in place of content. */
+    error?: string;
+    /** Optional retry handler shown alongside the error message. */
+    onRetry?: () => void;
     /** Actions slot (right side under status). */
     actions?: ReactNode;
     /** Stats slot at the bottom (e.g. runs / success rate). */
     stats?: ReactNode;
+    /** Click handler. When set, the card becomes role="button" with Enter/Space keyboard activation. */
     onClick?: () => void;
     className?: string;
+    id?: string;
 }
-export declare function AgentCard({ name, role, avatar, model, status, toolCount, interactive, actions, stats, onClick, className, }: AgentCardProps): import("react/jsx-runtime").JSX.Element;
+export declare const AgentCard: import("react").ForwardRefExoticComponent<AgentCardProps & import("react").RefAttributes<HTMLDivElement>>;
 //# sourceMappingURL=AgentCard.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"AgentCard.d.ts","sourceRoot":"","sources":["../../../src/components/AgentCard/AgentCard.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE7E,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,SAAS,CAAC;IAChB,4CAA4C;IAC5C,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,mEAAmE;IACnE,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,wBAAwB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wBAAwB;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAUD,wBAAgB,SAAS,CAAC,EACxB,IAAI,EACJ,IAAI,EACJ,MAAM,EACN,KAAK,EACL,MAAe,EACf,SAAS,EACT,WAAW,EACX,OAAO,EACP,KAAK,EACL,OAAO,EACP,SAAS,GACV,EAAE,cAAc,2CAwDhB"}
+{"version":3,"file":"AgentCard.d.ts","sourceRoot":"","sources":["../../../src/components/AgentCard/AgentCard.tsx"],"names":[],"mappings":"AACA,OAAO,EAAmD,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAKxF;;;;;GAKG;AAEH;+EAC+E;AAC/E,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEzF;wDACwD;AACxD,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,GAAG,WAAW,GAAG,IAAI,CAAC;AAEhF;yDACyD;AACzD,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE/C;yEACyE;AACzE,MAAM,MAAM,gBAAgB,GAAG,aAAa,GAAG,OAAO,CAAC;AAEvD,MAAM,WAAW,cAAc;IAC7B,0BAA0B;IAC1B,IAAI,EAAE,SAAS,CAAC;IAChB,sFAAsF;IACtF,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,+EAA+E;IAC/E,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,wEAAwE;IACxE,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,wBAAwB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB;;8EAE0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8FAA8F;IAC9F,UAAU,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IAE3B,oBAAoB;IACpB,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,wBAAwB;IACxB,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAE3B,wDAAwD;IACxD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,iEAAiE;IACjE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,0CAA0C;IAC1C,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;IAE7C,qEAAqE;IACrE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IAErB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,SAAS,CAAC;IAElB,oGAAoG;IACpG,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IAErB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAmCD,eAAO,MAAM,SAAS,2GAqSpB,CAAC"}

package/dist/components/AlertCard/AlertCard.d.ts

@@ -0,0 +1,76 @@
+import { type ComponentPropsWithoutRef, type MouseEvent, type ReactNode } from "react";
+import { type CardRadius } from "../Card";
+export type AlertSeverity = "P0" | "P1" | "P2" | "P3" | "info";
+export type AlertState = "open" | "acknowledged" | "resolved" | "muted";
+export interface AlertCardResource {
+    /** Display label (e.g. "orders_sync"). */
+    label: ReactNode;
+    /** Optional category prefix (e.g. "Pipeline"). Rendered muted before the label. */
+    kind?: ReactNode;
+}
+export interface AlertCardAction {
+    /** Display label — also used as aria-label when only a glyph is shown. */
+    label: string;
+    /** Optional icon node. */
+    icon?: ReactNode;
+    /**
+     * Visual emphasis.
+     * - primary  → Ack action (filled accent)
+     * - success  → Resolve action (filled success tone)
+     * - danger   → Escalate action (filled red)
+     * - neutral  → tertiary, default
+     */
+    tone?: "primary" | "success" | "danger" | "neutral";
+    onClick?: (e: MouseEvent<HTMLButtonElement>) => void;
+    disabled?: boolean;
+}
+export interface AlertCardProps extends Omit<ComponentPropsWithoutRef<"div">, "title" | "onChange" | "onClick" | "onDrag" | "onDragStart" | "onDragEnd" | "onAnimationStart"> {
+    /** Severity / priority level. Drives the stripe + badge color. */
+    severity: AlertSeverity;
+    /** Override the severity badge label (defaults to the severity code). */
+    severityLabel?: ReactNode;
+    /** Alert title. */
+    title: ReactNode;
+    /** Heading level for the title. Default `"h3"`. */
+    titleAs?: "h1" | "h2" | "h3" | "h4" | "h5" | "h6";
+    /** Optional descriptive body text. */
+    description?: ReactNode;
+    /** Affected resources — rendered as a kind/label list. */
+    resources?: AlertCardResource[];
+    /** When the alert fired (timestamp or relative time). */
+    firedAt?: ReactNode;
+    /** Assignee / owner handle (e.g. "@oncall-eu"). */
+    assignee?: ReactNode;
+    /** Lifecycle state — drives an optional state pill in the header. */
+    state?: AlertState;
+    /** Override the state pill label (defaults to the humanized state). */
+    stateLabel?: ReactNode;
+    /** Optional tag chips (env, team, runbook id). */
+    tags?: ReactNode[];
+    /** Action buttons rendered at the bottom of the card. */
+    actions?: AlertCardAction[];
+    /** Right-aligned trailing slot in the header (icon button, link). */
+    trailing?: ReactNode;
+    /** Visual size. Default `"md"`. */
+    size?: "sm" | "md" | "lg";
+    /** Render the card as a real `<a>` when href is provided. */
+    href?: string;
+    /** Whole-card click handler. */
+    onClick?: (e: MouseEvent<HTMLDivElement>) => void;
+    /** Disable interaction. */
+    disabled?: boolean;
+    /** Card corner radius (passes through). */
+    radius?: CardRadius;
+    /**
+     * ARIA live-region politeness. Default is `"off"` — the card is a
+     * passive surface that consumers can audit at their own pace.
+     *
+     * Set to `"assertive"` ONLY for genuinely live, in-the-moment alerts
+     * (e.g. a banner that just fired) so screen readers interrupt; set to
+     * `"polite"` for queued announcements. Avoid changing live alerts
+     * mid-flight — re-rendering inside an active live region re-announces.
+     */
+    live?: "off" | "polite" | "assertive";
+}
+export declare const AlertCard: import("react").ForwardRefExoticComponent<AlertCardProps & import("react").RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=AlertCard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AlertCard.d.ts","sourceRoot":"","sources":["../../../src/components/AlertCard/AlertCard.tsx"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,wBAAwB,EAE7B,KAAK,UAAU,EACf,KAAK,SAAS,EAEf,MAAM,OAAO,CAAC;AAEf,OAAO,EAAQ,KAAK,UAAU,EAAE,MAAM,SAAS,CAAC;AAqBhD,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;AAE/D,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,cAAc,GAAG,UAAU,GAAG,OAAO,CAAC;AAExE,MAAM,WAAW,iBAAiB;IAChC,0CAA0C;IAC1C,KAAK,EAAE,SAAS,CAAC;IACjB,mFAAmF;IACnF,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;IACpD,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;IACrD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,cACf,SAAQ,IAAI,CACV,wBAAwB,CAAC,KAAK,CAAC,EAC7B,OAAO,GACP,UAAU,GACV,SAAS,GACT,QAAQ,GACR,aAAa,GACb,WAAW,GACX,kBAAkB,CACrB;IACD,kEAAkE;IAClE,QAAQ,EAAE,aAAa,CAAC;IACxB,yEAAyE;IACzE,aAAa,CAAC,EAAE,SAAS,CAAC;IAC1B,mBAAmB;IACnB,KAAK,EAAE,SAAS,CAAC;IACjB,mDAAmD;IACnD,OAAO,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAClD,sCAAsC;IACtC,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAChC,yDAAyD;IACzD,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,qEAAqE;IACrE,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,uEAAuE;IACvE,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,kDAAkD;IAClD,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC;IACnB,yDAAyD;IACzD,OAAO,CAAC,EAAE,eAAe,EAAE,CAAC;IAC5B,qEAAqE;IACrE,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,mCAAmC;IACnC,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1B,6DAA6D;IAC7D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,CAAC,cAAc,CAAC,KAAK,IAAI,CAAC;IAClD,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB;;;;;;;;OAQG;IACH,IAAI,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,WAAW,CAAC;CACvC;AAyBD,eAAO,MAAM,SAAS,2GAoQrB,CAAC"}

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

@@ -0,0 +1,2 @@
+export { AlertCard, type AlertCardAction, type AlertCardProps, type AlertCardResource, type AlertSeverity, type AlertState, } from "./AlertCard";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/AlertCard/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,UAAU,GAChB,MAAM,aAAa,CAAC"}

package/dist/components/AuthCard/AuthCard.d.ts

@@ -1,5 +1,7 @@
-import { type ReactNode } from "react";
-export interface AuthCardProps {
+import { type ComponentPropsWithoutRef, type ReactNode } from "react";
+type HeadingLevel = "h1" | "h2" | "h3" | "h4";
+type DivPropsBase = Omit<ComponentPropsWithoutRef<"div">, "title" | "children" | "onChange">;
+export interface AuthCardProps extends DivPropsBase {
     logo?: ReactNode;
     title?: ReactNode;
     description?: ReactNode;
@@ -7,82 +9,67 @@ export interface AuthCardProps {
     scope?: ReactNode;
     /**
      * Fully custom header that REPLACES the auto-built logo + title +
-     * description block. Use when the default head structure isn't enough
-     * (split-screen layouts, custom hero treatments, etc.). When provided,
-     * `logo`, `title`, `description`, and `scope` are ignored.
+     * description block. When provided, `logo`/`title`/`description`/`scope`
+     * are ignored.
      */
     header?: ReactNode;
-    /**
-     * Extra content rendered immediately after the description, before the
-     * body. Common uses: step indicator ("Step 2 of 3"), breadcrumb,
-     * informational chip.
-     */
+    /** Extra content immediately after the description, before the body. */
     headerExtra?: ReactNode;
-    /**
-     * When set, an error Banner is rendered above the body — same Banner
-     * the consumer would otherwise hand-roll. Pass `false` / `null` /
-     * `undefined` to hide. Accepts the same ReactNode shape Banner expects
-     * for its body.
-     */
+    /** Inline error banner above the body. Pass falsy to hide. */
     error?: ReactNode;
-    /** Same as `error` but renders a success Banner. */
+    /** Inline success banner above the body. */
     success?: ReactNode;
     /**
-     * Header alignment. Default `"center"` matches the OctaviaFlow auth
-     * convention (centered logo + title). Use `"left"` for split-screen or
-     * marketing-heavy layouts where the auth card sits next to other content.
+     * Heading level for the auto-built title. Default `"h1"` because a
+     * standalone auth page typically has the card as its primary landmark.
+     * Use `"h2"` when the card is nested in a larger page (e.g. modal).
      */
+    headingLevel?: HeadingLevel;
+    /** Header alignment. Default `"center"`. */
     align?: "center" | "left";
-    /**
-     * Card width override. Default 400px (matches the historical default).
-     * Pass a number (px) or any CSS length string (e.g. "440px", "32rem").
-     */
+    /** Card width — number → px, string → any CSS length. Default 400. */
     width?: number | string;
+    /** Disable the mount fade-up animation (e.g. for SSR snapshots). */
+    disableAnimation?: boolean;
     children: ReactNode;
     divider?: ReactNode;
     footer?: ReactNode;
-    className?: string;
 }
-export declare function AuthCard({ logo, title, description, scope, header, headerExtra, error, success, align, width, children, divider, footer, className, }: AuthCardProps): import("react/jsx-runtime").JSX.Element;
-export interface AuthDividerProps {
+export declare const AuthCard: import("react").ForwardRefExoticComponent<AuthCardProps & import("react").RefAttributes<HTMLDivElement>>;
+export interface AuthDividerProps extends Omit<ComponentPropsWithoutRef<"div">, "children"> {
     children?: ReactNode;
-    className?: string;
 }
-export declare function AuthDivider({ children, className }: AuthDividerProps): import("react/jsx-runtime").JSX.Element;
-export interface AuthSectionProps {
+export declare const AuthDivider: import("react").ForwardRefExoticComponent<AuthDividerProps & import("react").RefAttributes<HTMLDivElement>>;
+export interface AuthSectionProps extends Omit<ComponentPropsWithoutRef<"div">, "children" | "title"> {
     label?: ReactNode;
     description?: ReactNode;
     children: ReactNode;
-    className?: string;
 }
-export declare function AuthSection({ label, description, children, className }: AuthSectionProps): import("react/jsx-runtime").JSX.Element;
+export declare const AuthSection: import("react").ForwardRefExoticComponent<AuthSectionProps & import("react").RefAttributes<HTMLDivElement>>;
 export interface AuthTab {
     id: string;
     label: ReactNode;
     icon?: ReactNode;
-    description?: ReactNode;
     content: ReactNode;
 }
-export interface AuthTabsProps {
+export interface AuthTabsProps extends Omit<ComponentPropsWithoutRef<"div">, "onChange" | "children"> {
     tabs: AuthTab[];
     defaultTab?: string;
     value?: string;
     onChange?: (id: string) => void;
-    className?: string;
 }
-export declare function AuthTabs({ tabs, defaultTab, value, onChange, className }: AuthTabsProps): import("react/jsx-runtime").JSX.Element;
-export interface AuthFieldRowProps {
+export declare const AuthTabs: import("react").ForwardRefExoticComponent<AuthTabsProps & import("react").RefAttributes<HTMLDivElement>>;
+export interface AuthFieldRowProps extends Omit<ComponentPropsWithoutRef<"div">, "children"> {
     children: ReactNode;
     /** Grid template columns. Default: "1fr 1fr". */
     columns?: string;
-    className?: string;
 }
-export declare function AuthFieldRow({ children, columns, className }: AuthFieldRowProps): import("react/jsx-runtime").JSX.Element;
+export declare const AuthFieldRow: import("react").ForwardRefExoticComponent<AuthFieldRowProps & import("react").RefAttributes<HTMLDivElement>>;
 export type AuthBadgeTone = "neutral" | "org" | "personal" | "developer";
-export interface AuthBadgeProps {
+export interface AuthBadgeProps extends Omit<ComponentPropsWithoutRef<"span">, "children"> {
     tone?: AuthBadgeTone;
     children: ReactNode;
-    className?: string;
 }
-export declare function AuthBadge({ tone, children, className }: AuthBadgeProps): import("react/jsx-runtime").JSX.Element;
+export declare const AuthBadge: import("react").ForwardRefExoticComponent<AuthBadgeProps & import("react").RefAttributes<HTMLSpanElement>>;
+export {};
 //# sourceMappingURL=AuthCard.d.ts.map

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

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

package/dist/components/Avatar/Avatar.d.ts

@@ -1,20 +1,57 @@
-import type { ReactNode } from "react";
-export interface AvatarProps {
+import { type ComponentPropsWithoutRef, type ReactNode } from "react";
+export type AvatarSize = "xs" | "sm" | "md" | "lg" | "xl";
+export type AvatarShape = "circle" | "square";
+/** Presence indicator. `online` pulses gently; reduced-motion is respected. */
+export type AvatarStatus = "online" | "offline" | "busy" | "away";
+export interface AvatarProps extends Omit<ComponentPropsWithoutRef<"div">, "color" | "children" | "onClick" | "onKeyDown"> {
+    /** Image URL. If loading fails, falls back to `initials` (then `icon`, then `?`). */
     src?: string;
+    /** Accessible name for the avatar. Used as the `<img>` alt AND as the
+     * wrapping element's accessible name. If you only pass `initials`,
+     * this is recommended so AT announces "Jane Doe avatar" not "J D". */
     alt?: string;
+    /** Initials to render when there is no image. Auto-uppercased and
+     * truncated to 2 characters so passing a full name stays sane. */
     initials?: string;
-    /** Seed for deterministic color. Falls back to initials/alt. */
+    /** Optional icon slot — rendered when neither `src` nor `initials` is
+     * available (or used directly when you want a system/bot avatar). */
+    icon?: ReactNode;
+    /** Override the default `?` fallback content. */
+    fallback?: ReactNode;
+    /** Stable seed for the persistent palette. Falls back to `initials` /
+     * `alt` so the same person consistently gets the same color even if
+     * their name changes case or you only have a partial identity. */
     seed?: string;
-    size?: "xs" | "sm" | "md" | "lg" | "xl";
-    status?: "online" | "offline" | "busy" | "away";
-    className?: string;
+    /** Pixel/font size variant. */
+    size?: AvatarSize;
+    /** Shape — `circle` (people, default) or `square` (teams, bots, brands). */
+    shape?: AvatarShape;
+    /** Presence indicator dot. */
+    status?: AvatarStatus;
+    /** Human-readable status label folded into the accessible name. Defaults
+     * to the capitalized `status` value. */
+    statusLabel?: string;
+    /** When set, the avatar becomes a button (Enter/Space activated). */
+    onClick?: () => void;
+    /** Native image attributes — set `loading="eager"` for above-the-fold avatars
+     * if you've measured CLS regressions. Defaults to `lazy`. */
+    imgLoading?: "eager" | "lazy";
+    /** Native referrerPolicy for cross-origin avatar hosts (Gravatar, etc.). */
+    referrerPolicy?: ComponentPropsWithoutRef<"img">["referrerPolicy"];
 }
-export declare function Avatar({ src, alt, initials, seed, size, status, className, }: AvatarProps): import("react/jsx-runtime").JSX.Element;
-export interface AvatarStackProps {
+export declare const Avatar: import("react").ForwardRefExoticComponent<AvatarProps & import("react").RefAttributes<HTMLDivElement>>;
+export interface AvatarStackProps extends Omit<ComponentPropsWithoutRef<"div">, "children"> {
+    /** Avatars to display (in left-to-right stacking order). */
     children: ReactNode;
-    className?: string;
-    /** Max avatars to show; rest collapse into "+N". */
+    /** Max avatars to show before collapsing the surplus into `+N`. */
     max?: number;
+    /** Size applied to the overflow chip. Defaults to `md`. */
+    size?: AvatarSize;
+    /** Replace the default `+N` overflow chip. Receives the hidden count. */
+    renderOverflow?: (count: number) => ReactNode;
+    /** Stacking direction. `ltr` (default) overlaps each successive avatar to
+     * the right of the previous one; `rtl` mirrors. */
+    direction?: "ltr" | "rtl";
 }
-export declare function AvatarStack({ children, className, max }: AvatarStackProps): import("react/jsx-runtime").JSX.Element;
+export declare const AvatarStack: import("react").ForwardRefExoticComponent<AvatarStackProps & import("react").RefAttributes<HTMLDivElement>>;
 //# sourceMappingURL=Avatar.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Avatar.d.ts","sourceRoot":"","sources":["../../../src/components/Avatar/Avatar.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IACxC,MAAM,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAwDD,wBAAgB,MAAM,CAAC,EACrB,GAAG,EACH,GAAQ,EACR,QAAQ,EACR,IAAI,EACJ,IAAW,EACX,MAAM,EACN,SAAS,GACV,EAAE,WAAW,2CA8Bb;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,SAAS,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,WAAW,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE,gBAAgB,2CAoBzE"}
+{"version":3,"file":"Avatar.d.ts","sourceRoot":"","sources":["../../../src/components/Avatar/Avatar.tsx"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,wBAAwB,EAG7B,KAAK,SAAS,EAIf,MAAM,OAAO,CAAC;AAOf,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAC1D,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAC9C,+EAA+E;AAC/E,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;AAElE,MAAM,WAAW,WACf,SAAQ,IAAI,CAAC,wBAAwB,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,WAAW,CAAC;IAC7F,qFAAqF;IACrF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;0EAEsE;IACtE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;sEACkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;yEACqE;IACrE,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB;;sEAEkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,4EAA4E;IAC5E,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,8BAA8B;IAC9B,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB;4CACwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB;iEAC6D;IAC7D,UAAU,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC9B,4EAA4E;IAC5E,cAAc,CAAC,EAAE,wBAAwB,CAAC,KAAK,CAAC,CAAC,gBAAgB,CAAC,CAAC;CACpE;AA+CD,eAAO,MAAM,MAAM,wGAiHjB,CAAC;AAQH,MAAM,WAAW,gBACf,SAAQ,IAAI,CAAC,wBAAwB,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IACzD,4DAA4D;IAC5D,QAAQ,EAAE,SAAS,CAAC;IACpB,mEAAmE;IACnE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,yEAAyE;IACzE,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,SAAS,CAAC;IAC9C;uDACmD;IACnD,SAAS,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;CAC3B;AAED,eAAO,MAAM,WAAW,6GAoDvB,CAAC"}

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

@@ -1,2 +1,2 @@
-export { Avatar, type AvatarProps, AvatarStack, type AvatarStackProps } from "./Avatar";
+export { Avatar, type AvatarProps, type AvatarShape, type AvatarSize, AvatarStack, type AvatarStackProps, type AvatarStatus, } from "./Avatar";
 //# sourceMappingURL=index.d.ts.map

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

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

package/dist/components/Badge/Badge.d.ts

@@ -1,13 +1,51 @@
-import type { ReactNode } from "react";
-export interface BadgeProps {
-    variant?: "success" | "warning" | "error" | "info" | "neutral";
-    size?: "sm" | "md";
+import { type ComponentPropsWithoutRef, type MouseEvent, type ReactNode } from "react";
+export type BadgeVariant = "success" | "warning" | "error" | "info" | "neutral" | "accent";
+export type BadgeSize = "sm" | "md" | "lg";
+export interface BadgeProps extends Omit<ComponentPropsWithoutRef<"span">, "color" | "onClick"> {
+    variant?: BadgeVariant;
+    size?: BadgeSize;
+    /** Render a colored dot before the text. Mutually exclusive with `icon`. */
     dot?: boolean;
+    /** Custom icon node rendered before the text. If both `icon` and `dot`
+     * are passed, `icon` wins. */
+    icon?: ReactNode;
+    /** Render a `×` button to remove the badge. */
+    closable?: boolean;
+    /** @deprecated Use `closable`. Kept as an alias for back-compat. */
     closeable?: boolean;
-    onClose?: () => void;
+    /** Fires when the user clicks (or activates via keyboard) the close
+     * button. Receives the MouseEvent so callers can `stopPropagation` /
+     * `preventDefault` as needed. */
+    onClose?: (event: MouseEvent<HTMLButtonElement>) => void;
+    /** Accessible label for the close button. Defaults to "Remove". Override
+     * for localization or contextual reads ("Remove tag 'cdc'"). */
+    closeLabel?: string;
+    /** Thin outline + transparent background instead of the filled chip. */
     outlined?: boolean;
-    children: ReactNode;
-    className?: string;
+    /** Truncate long text with an ellipsis and surface the full content as a
+     * `title` tooltip. `true` uses the design default (200 px); a number sets
+     * an explicit max-width in px. */
+    truncate?: boolean | number;
+    /** Numeric badge convenience. Renders the value (or "99+" if > 99).
+     * Ignored when `children` is also set. */
+    count?: number;
+    /** Click handler for the entire badge. Sets `role="button"` and wires
+     * Enter / Space keyboard activation. */
+    onClick?: (event: MouseEvent<HTMLSpanElement>) => void;
+    /** Render Badge's styling onto a custom child element (Radix-style Slot).
+     * Useful for letting Badge own the chrome while a router link / tooltip
+     * trigger / etc. owns the actual element semantics.
+     *
+     * Example:
+     *   <Badge asChild variant="accent">
+     *     <NextLink href="/pricing">Beta</NextLink>
+     *   </Badge>
+     *
+     * When `asChild` is true, Badge does NOT render its internal `dot`,
+     * `icon`, or close-button slots — the consumer fully owns the content.
+     * For chips with built-in slots, use the regular form without asChild. */
+    asChild?: boolean;
+    children?: ReactNode;
 }
-export declare function Badge({ variant, size, dot, closeable, onClose, outlined, children, className, }: BadgeProps): import("react/jsx-runtime").JSX.Element;
+export declare const Badge: import("react").ForwardRefExoticComponent<BadgeProps & import("react").RefAttributes<HTMLSpanElement>>;
 //# sourceMappingURL=Badge.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Badge.d.ts","sourceRoot":"","sources":["../../../src/components/Badge/Badge.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;IAC/D,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACnB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,SAAS,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,KAAK,CAAC,EACpB,OAAmB,EACnB,IAAW,EACX,GAAW,EACX,SAAiB,EACjB,OAAO,EACP,QAAgB,EAChB,QAAQ,EACR,SAAS,GACV,EAAE,UAAU,2CAiCZ"}
+{"version":3,"file":"Badge.d.ts","sourceRoot":"","sources":["../../../src/components/Badge/Badge.tsx"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,wBAAwB,EAI7B,KAAK,UAAU,EACf,KAAK,SAAS,EAEf,MAAM,OAAO,CAAC;AAQf,MAAM,MAAM,YAAY,GACpB,SAAS,GACT,SAAS,GACT,OAAO,GACP,MAAM,GACN,SAAS,GACT,QAAQ,CAAC;AAEb,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE3C,MAAM,WAAW,UACf,SAAQ,IAAI,CAAC,wBAAwB,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACnE,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,IAAI,CAAC,EAAE,SAAS,CAAC;IAEjB,4EAA4E;IAC5E,GAAG,CAAC,EAAE,OAAO,CAAC;IACd;kCAC8B;IAC9B,IAAI,CAAC,EAAE,SAAS,CAAC;IAEjB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oEAAoE;IACpE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;qCAEiC;IACjC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;IACzD;oEACgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;sCAEkC;IAClC,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAE5B;8CAC0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;4CACwC;IACxC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,eAAe,CAAC,KAAK,IAAI,CAAC;IAEvD;;;;;;;;;;;8EAW0E;IAC1E,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAwCD,eAAO,MAAM,KAAK,wGA6HhB,CAAC"}

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

@@ -1,2 +1,2 @@
-export { Badge, type BadgeProps } from "./Badge";
+export { Badge, type BadgeProps, type BadgeSize, type BadgeVariant, } from "./Badge";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/Badge/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,UAAU,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/Badge/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EACL,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,YAAY,GAClB,MAAM,SAAS,CAAC"}

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