themelia-react-ui 0.0.0-stage → 1.0.1

package/dist/components/base/cards/card-actions.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Card action recipes — package-owned chrome for body/footer card actions.
+ *
+ * Use these instead of hand-rolled footer button rows in resource cards.
+ */
+import { type ComponentProps, type ReactElement, type ReactNode } from 'react';
+import type { LucideIcon } from 'lucide-react';
+import { Button } from '../buttons';
+import { type ActionMenuAction, type ActionMenuLinkRenderProps } from '../action-menu';
+export interface CardPrimaryActionProps extends Omit<ComponentProps<typeof Button>, 'variant' | 'fullWidth' | 'children'> {
+    children: ReactNode;
+    icon?: LucideIcon;
+    /** Renders the action as an anchor to this destination. */
+    href?: string;
+    /** Omits the action without changing the others' order. */
+    hidden?: boolean;
+    /** Stretches the action to the row's width. */
+    fullWidth?: boolean;
+}
+export declare const CardPrimaryAction: import("react").ForwardRefExoticComponent<Omit<CardPrimaryActionProps, "ref"> & import("react").RefAttributes<HTMLButtonElement>>;
+export interface CardActionStripProps {
+    /** Actions to render, in order. */
+    actions: readonly ActionMenuAction[];
+    /** Draws a rule above the action row. */
+    separator?: boolean;
+    /** Horizontal alignment of the action row. */
+    align?: 'start' | 'end' | 'between' | 'stretch';
+    /** Tightens the row for dense cards. */
+    compact?: boolean;
+    /** Stretches only the primary action. */
+    fullWidthPrimary?: boolean;
+    className?: string;
+    /** Merged onto every button in the row. */
+    buttonClassName?: string;
+    /** Renders actions carrying an `href` through the consumer's router. */
+    renderLink?: (props: ActionMenuLinkRenderProps) => ReactElement;
+}
+export declare function CardActionStrip({ actions, separator, align, compact, fullWidthPrimary, className, buttonClassName, renderLink, }: CardActionStripProps): import("react").JSX.Element | null;
+export declare namespace CardActionStrip {
+    var displayName: string;
+}

package/dist/components/base/cards/card.recipes.d.ts

@@ -0,0 +1,28 @@
+/** Private Tailwind recipes; public props and DOM hooks remain owned by the component. */
+export declare const cardRecipes: {
+    readonly root: "flex flex-col w-full rounded-radius box-border overflow-hidden py-surface gap-space-xl transition-[background-color,border-color,box-shadow] duration-150";
+    readonly shell: "@container/card flex flex-col w-full rounded-radius box-border overflow-hidden py-surface gap-space-xl transition-[background-color,border-color,box-shadow] duration-150";
+    readonly surfaceCard: "bg-card border border-border shadow-sm text-card-foreground";
+    readonly surfaceDefault: "bg-card border border-border shadow-sm text-card-foreground";
+    readonly surfaceFlat: "bg-transparent border-0 shadow-none text-foreground";
+    readonly surfaceFramed: "bg-card border border-border shadow-sm ring-4 ring-border/30 text-card-foreground";
+    readonly surfaceRaised: "bg-card border border-border shadow-md text-card-foreground";
+    readonly surfaceSunken: "bg-muted border border-border text-foreground";
+    readonly header: "flex flex-col gap-normal px-surface box-border";
+    readonly headerRow: "flex-col @sm/card:flex-row items-start justify-between gap-space-lg pb-0";
+    readonly headerRowSingle: "@sm/card:items-center";
+    readonly headerLeading: "min-w-0 w-full @sm/card:w-auto flex-1";
+    readonly headerTrailing: "flex max-w-full flex-wrap shrink-0 items-center gap-space-md";
+    readonly headerDivider: "border-b border-border [&.border-b]:!pb-surface";
+    readonly title: "min-w-0 leading-tight text-card-foreground";
+    readonly titleSm: "text-sm";
+    readonly titleMd: "text-base";
+    readonly titleLg: "text-lg";
+    readonly description: "text-sm text-muted-foreground leading-normal";
+    readonly content: "px-surface box-border min-w-0";
+    readonly footer: "flex items-center px-surface box-border";
+    readonly footerDivider: "border-t border-border [&.border-t]:!pt-surface";
+    readonly alert: "px-surface";
+    readonly alertWithHeader: "-mt-space-xs";
+    readonly expandToggle: "flex justify-center pb-surface -mt-space-md";
+};

package/dist/components/base/cards/index.d.ts

@@ -0,0 +1,5 @@
+export { Card, SmartCard, SmartCardSkeleton, defaultSmartCardStrings, type SmartCardAction, type SmartCardProps, type SmartCardSkeletonProps, type SmartCardStrings, type SmartCardSurface, CardShell, CardHeader, CardTitle, CardDescription, CardContent, CardFooter, hasRenderableContent, } from './smart-card';
+export { CardActionStrip, CardPrimaryAction, type CardActionStripProps, type CardPrimaryActionProps, } from './card-actions';
+export type { SmartCardProps as CardProps, SmartCardAction as CardAction, SmartCardSurface as CardSurface, SmartCardSkeletonProps as CardSkeletonProps } from './smart-card.types';
+export { SmartCardSkeleton as CardSkeleton } from './smart-card';
+export { defaultSmartCardStrings as defaultCardStrings, type SmartCardStrings as CardStrings } from './smart-card.strings';

package/dist/components/base/cards/partials/card-primitives.d.ts

@@ -0,0 +1,21 @@
+import type { TextGap } from '../../structure';
+/**
+ * Internal layout primitives — re-exported from `smart-card.tsx` for
+ * advanced composition (deeply customised layouts that still want the
+ * design-system surface tokens). Each primitive is intentionally thin:
+ * a single responsibility, a single set of default classes, no business
+ * logic. The BEM hooks (`card--component`, `card--header`, etc.) are
+ * applied here so the public DOM contract lives in one place.
+ */
+import { type ComponentPropsWithRef, type ComponentPropsWithoutRef } from 'react';
+import type { CardTitleSize } from '../smart-card.types';
+export declare function CardShell({ className, ...props }: ComponentPropsWithRef<'div'>): import("react").JSX.Element;
+export declare function CardHeader({ className, textGap, ...props }: ComponentPropsWithoutRef<'div'> & {
+    textGap?: TextGap;
+}): import("react").JSX.Element;
+export declare function CardTitle({ className, children, size: sizeProp, ...props }: ComponentPropsWithoutRef<'div'> & {
+    size?: CardTitleSize;
+}): import("react").JSX.Element | null;
+export declare function CardDescription({ className, children, ...props }: ComponentPropsWithoutRef<'div'>): import("react").JSX.Element | null;
+export declare function CardContent({ className, ...props }: ComponentPropsWithoutRef<'div'>): import("react").JSX.Element;
+export declare function CardFooter({ className, ...props }: ComponentPropsWithoutRef<'div'>): import("react").JSX.Element;

package/dist/components/base/cards/partials/has-renderable-content.d.ts

@@ -0,0 +1,8 @@
+import { type ReactNode } from 'react';
+/**
+ * Predicate used by SmartCard subregions to decide whether each slot
+ * warrants rendering its wrapper. Numbers (incl. `0`) and JSX always
+ * render; falsy / empty-string content is treated as absent. Fragments
+ * recurse into their children.
+ */
+export declare function hasRenderableContent(content?: ReactNode): boolean;

package/dist/components/base/cards/partials/smart-card-actions-menu.d.ts

@@ -0,0 +1,8 @@
+import type { SmartCardAction } from '../smart-card.types';
+interface ActionsMenuProps {
+    /** Controls offered on the surface. */
+    actions: readonly SmartCardAction[];
+    actionsLabel: string;
+}
+export declare function ActionsMenu({ actions, actionsLabel }: ActionsMenuProps): import("react").JSX.Element;
+export {};

package/dist/components/base/cards/partials/smart-card-alert.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Inline alert banner rendered between the header and the card body.
+ * Pulls itself up under the header (`alertOffsetWithHeader`) when one
+ * exists so the visual gap between header bottom and alert top stays
+ * tight; otherwise pushes itself down (`alertOffsetStandalone`) so it
+ * doesn't kiss the card top edge.
+ */
+import type { ReactNode } from 'react';
+import type { CardAlertTone } from '../smart-card.types';
+interface AlertSlotProps {
+    /** Banner content. A plain string is wrapped for you. */
+    alert: ReactNode | string;
+    /** Tone of the banner. */
+    alertTone: CardAlertTone;
+    /** Whether a header sits above, deciding the banner's top spacing. */
+    hasHeader: boolean;
+    className?: string;
+}
+export declare function SmartCardAlert({ alert, alertTone, hasHeader, className, }: AlertSlotProps): import("react").JSX.Element;
+export {};

package/dist/components/base/cards/partials/smart-card-header-row.d.ts

@@ -0,0 +1,33 @@
+import type { ReactNode } from 'react';
+import { type TextGap } from '../../structure';
+import type { CardTitleSize, SmartCardAction } from '../smart-card.types';
+interface HeaderProps {
+    /** Leading glyph on the title line. */
+    icon?: ReactNode;
+    /** Card title. */
+    title?: ReactNode;
+    /** Content immediately after the title. */
+    titleSuffix?: ReactNode;
+    /** Supporting sentence under the title. */
+    description?: ReactNode;
+    textGap?: TextGap;
+    /** Explanatory copy behind an info affordance on the title line. */
+    tooltip?: ReactNode;
+    /** Accessible name for the tooltip trigger. */
+    tooltipLabel: string;
+    /** Full-width row above the title. */
+    headerStart?: ReactNode;
+    /** Content at the end of the header. */
+    headerEnd?: ReactNode;
+    /** Single control before the overflow menu. */
+    headerAction?: ReactNode;
+    /** Overflow menu at the far end of the header. */
+    actions?: readonly SmartCardAction[];
+    /** Accessible name for the overflow trigger. */
+    actionsLabel: string;
+    /** Card title typography. */
+    titleSize: CardTitleSize;
+    className?: string;
+}
+export declare function SmartCardHeaderRow({ icon, title, titleSuffix, description, textGap, tooltip, tooltipLabel, headerStart, headerEnd, headerAction, actions, actionsLabel, titleSize, className, }: HeaderProps): import("react").JSX.Element;
+export {};

package/dist/components/base/cards/partials/smart-card-skeleton.d.ts

@@ -0,0 +1,16 @@
+/**
+ * SmartCardSkeleton — placeholder shell rendered while a SmartCard's
+ * data is loading. Picks up the canonical card surface so the loading
+ * state visually matches the eventual `SmartCard` it'll replace.
+ */
+import type { ReactNode } from 'react';
+export interface SmartCardSkeletonProps {
+    /** Surface title. */
+    title?: ReactNode;
+    lines?: number;
+    className?: string;
+}
+export declare function SmartCardSkeleton({ title, lines, className }: SmartCardSkeletonProps): import("react").JSX.Element;
+export declare namespace SmartCardSkeleton {
+    var displayName: string;
+}

package/dist/components/base/cards/smart-card.d.ts

@@ -0,0 +1,9 @@
+import type { SmartCardProps } from './smart-card.types';
+export declare const Card: import("react").ForwardRefExoticComponent<SmartCardProps & import("react").RefAttributes<HTMLDivElement>>;
+/** @deprecated Use Card. */
+export declare const SmartCard: import("react").ForwardRefExoticComponent<SmartCardProps & import("react").RefAttributes<HTMLDivElement>>;
+export { defaultSmartCardStrings, type SmartCardStrings, } from './smart-card.strings';
+export type { CardAlertTone, SmartCardAction, SmartCardProps, SmartCardSkeletonProps, SmartCardSurface, } from './smart-card.types';
+export { CardContent, CardDescription, CardFooter, CardHeader, CardShell, CardTitle, } from './partials/card-primitives';
+export { hasRenderableContent } from './partials/has-renderable-content';
+export { SmartCardSkeleton } from './partials/smart-card-skeleton';

package/dist/components/base/cards/smart-card.strings.d.ts

@@ -0,0 +1,18 @@
+/**
+ * SmartCard strings — i18n surface for the chrome the consumer doesn't
+ * pass directly. Most copy (title, description, action labels, alert
+ * body) flows in via props; the strings here cover the implicit
+ * affordances (header actions, tooltip, and expand toggle).
+ */
+export interface SmartCardStrings {
+    actionsLabel: string;
+    tooltipLabel: string;
+    expandLabel: string;
+    collapseLabel: string;
+}
+export declare const defaultSmartCardStrings: {
+    actionsLabel: string;
+    tooltipLabel: string;
+    expandLabel: string;
+    collapseLabel: string;
+};

package/dist/components/base/cards/smart-card.tokens.d.ts

@@ -0,0 +1,44 @@
+import type { SmartCardSurface } from './smart-card.types';
+/**
+ * BEM-style hooks applied to every SmartCard subregion. Library
+ * consumers can target them in CSS / tests / analytics without
+ * relying on shadcn's data-slot attributes (which are framework
+ * internals). Keep these names consistent — they are part of the
+ * public DOM contract.
+ */
+export declare const CARD_BEM: {
+    readonly root: "card--component";
+    readonly header: "card--header";
+    readonly title: "card--title";
+    readonly description: "card--description";
+    readonly content: "card--content";
+    readonly footer: "card--footer";
+    readonly alert: "card--alert";
+    readonly collapseFade: "card--collapse-fade";
+    readonly expandToggle: "card--expand-toggle";
+    readonly expandToggleButton: "card--expand-toggle-button";
+};
+interface PaddingTokens {
+    shell: string;
+    headerX: string;
+    /** Tokenized divider inset that overrides the shadcn primitive's fixed 24px rule. */
+    headerDividerY: string;
+    contentX: string;
+    contentY: string;
+    footerX: string;
+    /** Tokenized divider inset that overrides the shadcn primitive's fixed 24px rule. */
+    footerDividerY: string;
+    alertX: string;
+    /** Bottom clearance for the half-inset expandable control. */
+    expandableBottom: string;
+    /** Vertical offset applied when alert sits BELOW the header (pulls it up). */
+    alertOffsetWithHeader: string;
+    /** Vertical spacing applied when alert is the first content (no header). */
+    alertOffsetStandalone: string;
+}
+export declare const CARD_INSET: PaddingTokens;
+/**
+ * Surface-specific shell classes.
+ */
+export declare const SURFACE_CLASSES: Record<SmartCardSurface, string>;
+export {};

package/dist/components/base/cards/smart-card.types.d.ts

@@ -0,0 +1,146 @@
+import type { ComponentPropsWithoutRef, ReactNode } from 'react';
+import type { CardSurface } from '../../../lib/component-vocabulary';
+import type { CardTitleSize } from '../../../lib/ui-provider';
+import type { StringsProp } from '../../../lib/strings';
+import type { AlertTone } from '../feedback';
+import type { ActionMenuAction } from '../action-menu';
+import type { StructureGap, TextGap } from '../structure';
+import type { SmartCardStrings } from './smart-card.strings';
+export type { CardTitleSize } from '../../../lib/ui-provider';
+export type CardAlertTone = AlertTone;
+export interface SmartCardAction extends ActionMenuAction {
+}
+/**
+ * Outer surface chrome.
+ *
+ * - `card`: canonical bordered + soft-shadow card surface.
+ * - `flat`: no border, no shadow, transparent background — use when
+ *   nesting inside another surface that already has chrome.
+ * - `framed` (default): grouped-surface treatment with one card border plus a soft
+ *   tokenized outer ring. Use it when the card needs to stand apart without
+ *   nesting an extra frame wrapper.
+ */
+export type SmartCardSurface = CardSurface;
+/**
+ * Slot map, top to bottom. Keep title-adjacent identity and state in
+ * `titleSuffix`; reserve the rarer full-width `headerStart` row for context
+ * that must precede the title.
+ *
+ * ```text
+ * ┌ header ─────────────────────────────────────────────────────┐
+ * │ headerStart                                                 │
+ * │ icon  title  titleSuffix  (tooltip)   headerEnd headerAction │
+ * │ description                                        ⋯ actions │
+ * └──────────────────────────────────────── (headerDivider) ────┘
+ *   alert
+ *   contentTop
+ *   children
+ *   contentBottom
+ * ┌──────────────────────────────────────── (footerDivider) ────┐
+ * │ footerText │ footerSlot                                     │
+ * └─────────────────────────────────────────────────────────────┘
+ * ```
+ */
+export interface SmartCardProps extends Omit<ComponentPropsWithoutRef<'div'>, 'children' | 'title'> {
+    /** Leading glyph on the title line, muted and shrink-proof. */
+    icon?: ReactNode;
+    /** Card title. Rendered through `CardTitle` at `titleSize`. */
+    title?: ReactNode;
+    /** Badges, status, counts, or version copy immediately after the title. */
+    titleSuffix?: ReactNode;
+    /** Supporting sentence under the title. */
+    description?: ReactNode;
+    /** Title/supporting-copy rhythm. Defaults to normal; independent of insets and control density. */
+    textGap?: TextGap;
+    /** Explanatory copy behind an info affordance on the title line. */
+    tooltip?: ReactNode;
+    /** Accessible name for the tooltip trigger. Defaults to the `tooltipLabel` string. */
+    tooltipAriaLabel?: string;
+    /** Muted text in the footer band. Renders alongside `footerSlot`. */
+    footerText?: ReactNode;
+    /** Banner between the header and the content. A plain string is wrapped for you. */
+    alert?: ReactNode | string;
+    /** Tone of the `alert` banner. Default: `'neutral'`. */
+    alertTone?: CardAlertTone;
+    /**
+     * Outer surface chrome. Defaults to `UIProvider.card.defaultSurface`
+     * (`'framed'` unless configured).
+     */
+    surface?: SmartCardSurface;
+    /** Surface insets. `none` composes unframed content inside an existing surface. */
+    padding?: 'none' | 'sm' | 'md' | 'lg';
+    /** `frame` places header/actions above an inset body surface. */
+    headerPlacement?: 'inside' | 'frame';
+    /** Semantic gap between header, body and footer regions. Defaults to `xl`; insets remain owned by padding. */
+    gap?: StructureGap;
+    /** Semantic gap between direct body children. */
+    contentGap?: StructureGap;
+    /** Card title typography scale. Defaults to `UIProvider.density.defaultScale`. */
+    titleSize?: CardTitleSize;
+    /** Overflow actions at the far end of the header, collapsed into a single menu trigger. */
+    actions?: readonly SmartCardAction[];
+    /** Accessible name for the overflow trigger. Defaults to the `actionsLabel` string. */
+    actionsLabel?: string;
+    /**
+     * Single control at the end of the header, before the overflow menu — a
+     * toggle or link. Use `actions` instead for a list of commands.
+     */
+    headerAction?: ReactNode;
+    /**
+     * Rare full-width row above the title for breadcrumb, eyebrow, or workflow
+     * context. Put badges, status, counts, and versions in `titleSuffix`.
+     */
+    headerStart?: ReactNode;
+    /** Secondary metadata or a secondary control before `headerAction` and `actions`. */
+    headerEnd?: ReactNode;
+    /** Content between the alert and `children`, inside the content inset. */
+    contentTop?: ReactNode;
+    /** Content after `children`, inside the content inset. */
+    contentBottom?: ReactNode;
+    /**
+     * Optional full-width footer band rendered under the content, ideal
+     * for a single primary action ("Open", "Connect"). Pairs with
+     * `footerDivider` to add a `border-t` rule above it.
+     */
+    footerSlot?: ReactNode;
+    /**
+     * Render a `border-b` rule between header and content. Defaults to
+     * `UIProvider.card.defaultHeaderDivider` (`false` unless configured).
+     * With no body/alert, header and footer share one footer-owned divider.
+     */
+    headerDivider?: boolean;
+    /** Render a `border-t` rule above the footer; adjacent header/footer regions share one rule. */
+    footerDivider?: boolean;
+    /**
+     * Make the card body collapsible. Pass `true` for default behavior
+     * (12rem / 192px collapsed max-height with a soft fade overlay) or
+     * an object to tune the collapsed height.
+     */
+    expandable?: boolean | {
+        collapsedMaxHeight?: number | string;
+    };
+    /** Initial expanded state (uncontrolled). Defaults to `false`. */
+    defaultExpanded?: boolean;
+    /** Controlled expanded state. */
+    expanded?: boolean;
+    /** Change callback for controlled mode. */
+    onExpandedChange?: (expanded: boolean) => void;
+    /** The card body. */
+    children?: ReactNode;
+    /** Merged onto the header region. */
+    headerClassName?: string;
+    /** Merged onto the content region. */
+    contentClassName?: string;
+    /** Merged onto the footer region. */
+    footerClassName?: string;
+    /** Overrides the card's own copy (overflow-menu and tooltip labels, expand/collapse). */
+    strings?: StringsProp<SmartCardStrings>;
+}
+export interface SmartCardSkeletonProps {
+    /** Placeholder title. Omit for a bar in the title's place. */
+    title?: ReactNode;
+    /** Placeholder body lines to draw. */
+    lines?: number;
+    /** Merged onto the skeleton root. */
+    className?: string;
+}

package/dist/components/base/carousel/carousel.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Carousel — Embla-backed base carousel primitive.
+ *
+ * Package-owned wrapper around `embla-carousel-react` with library Button
+ * controls, keyboard navigation, overridable accessible labels, and stable
+ * BEM hooks. The optional Embla peer is isolated to `base/carousel`.
+ */
+import { type ComponentPropsWithoutRef, type ReactNode } from 'react';
+import useEmblaCarousel, { type UseEmblaCarouselType } from 'embla-carousel-react';
+import { type ButtonProps } from '../buttons';
+import { type StringsProp } from '../../../lib/strings';
+import { type CarouselStrings } from './carousel.strings';
+export type CarouselApi = UseEmblaCarouselType[1];
+export type CarouselOptions = Parameters<typeof useEmblaCarousel>[0];
+export type CarouselPlugin = Parameters<typeof useEmblaCarousel>[1];
+export type CarouselOrientation = 'horizontal' | 'vertical';
+export type CarouselControlPlacement = 'outside' | 'inside' | 'overlay' | 'inline';
+export type CarouselNavigationAlign = 'start' | 'center' | 'end' | 'between';
+export type CarouselPaginationStyle = 'dot' | 'pill';
+export interface CarouselProps extends ComponentPropsWithoutRef<'div'> {
+    /** Options forwarded to the underlying Embla carousel. */
+    opts?: CarouselOptions;
+    /** Embla plugins — autoplay, autoscroll, and similar. */
+    plugins?: CarouselPlugin;
+    /** Scroll axis. Default: `horizontal`. */
+    orientation?: CarouselOrientation;
+    /**
+     * Where the previous/next controls sit relative to the viewport. Default:
+     * `outside`.
+     *
+     * `outside` positions the controls 2.75rem beyond the viewport edge, so the
+     * caller must reserve a matching intrinsic control gutter or they render
+     * outside the visible box — `px-11` horizontally, `py-11` vertically:
+     *
+     * ```tsx
+     * <Carousel className="w-full max-w-2xl px-11">
+     * ```
+     *
+     * Use `inside` to overlay the controls on the viewport and skip the gutter
+     * entirely.
+     */
+    controlPlacement?: CarouselControlPlacement;
+    /** Receives the carousel API so the consumer can drive it from outside. */
+    setApi?: (api: CarouselApi) => void;
+    /** Overrides the previous/next accessible names. */
+    strings?: StringsProp<CarouselStrings>;
+}
+interface CarouselContextValue {
+    carouselRef: ReturnType<typeof useEmblaCarousel>[0];
+    api: CarouselApi;
+    /** Options forwarded to the underlying Embla carousel. */
+    opts?: CarouselOptions;
+    /** Scroll axis. Default: `horizontal`. */
+    orientation: CarouselOrientation;
+    /** Where the previous/next controls sit relative to the viewport. Default: `outside`. */
+    controlPlacement: CarouselControlPlacement;
+    scrollPrev: () => void;
+    scrollNext: () => void;
+    scrollTo: (index: number) => void;
+    canScrollPrev: boolean;
+    canScrollNext: boolean;
+    selectedIndex: number;
+    scrollSnaps: number[];
+    /** Overrides the previous/next accessible names. */
+    strings: CarouselStrings;
+}
+declare function useCarousel(): CarouselContextValue;
+declare const Carousel: import("react").ForwardRefExoticComponent<CarouselProps & import("react").RefAttributes<HTMLDivElement>>;
+declare const CarouselContent: import("react").ForwardRefExoticComponent<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
+declare const CarouselItem: import("react").ForwardRefExoticComponent<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
+export interface CarouselControlProps extends Omit<ButtonProps, 'children' | 'href'> {
+    children?: ReactNode;
+    /** Where the controls sit relative to the viewport. */
+    placement?: CarouselControlPlacement;
+}
+declare const CarouselPrevious: import("react").ForwardRefExoticComponent<Omit<CarouselControlProps, "ref"> & import("react").RefAttributes<HTMLButtonElement>>;
+declare const CarouselNext: import("react").ForwardRefExoticComponent<Omit<CarouselControlProps, "ref"> & import("react").RefAttributes<HTMLButtonElement>>;
+export interface CarouselNavigationProps extends ComponentPropsWithoutRef<'div'> {
+    /** Alignment of the dot cluster. */
+    align?: CarouselNavigationAlign;
+    /** Renders the pagination dots. */
+    showDots?: boolean;
+    /** Props forwarded to the previous control. */
+    previousProps?: CarouselControlProps;
+    /** Props forwarded to the next control. */
+    nextProps?: CarouselControlProps;
+    /** Props forwarded to the dot cluster. */
+    dotsProps?: CarouselDotsProps;
+}
+declare const CarouselNavigation: import("react").ForwardRefExoticComponent<CarouselNavigationProps & import("react").RefAttributes<HTMLDivElement>>;
+export interface CarouselDotsProps extends ComponentPropsWithoutRef<'div'> {
+    /** Merged onto each dot. */
+    dotClassName?: string;
+    /** Visual treatment of the pagination dots. */
+    paginationStyle?: CarouselPaginationStyle;
+}
+declare const CarouselDots: import("react").ForwardRefExoticComponent<CarouselDotsProps & import("react").RefAttributes<HTMLDivElement>>;
+export interface CarouselDotProps extends Omit<ButtonProps, 'children' | 'href'> {
+    index: number;
+    children?: ReactNode;
+    /** Visual treatment of the pagination dots. */
+    paginationStyle?: CarouselPaginationStyle;
+}
+declare const CarouselDot: import("react").ForwardRefExoticComponent<Omit<CarouselDotProps, "ref"> & import("react").RefAttributes<HTMLButtonElement>>;
+export { Carousel, CarouselContent, CarouselItem, CarouselPrevious, CarouselNext, CarouselNavigation, CarouselDots, CarouselDot, useCarousel, };

package/dist/components/base/carousel/carousel.strings.d.ts

@@ -0,0 +1,6 @@
+export interface CarouselStrings {
+    previousSlide: string;
+    nextSlide: string;
+    goToSlide: string;
+}
+export declare const defaultCarouselStrings: CarouselStrings;

package/dist/components/base/carousel/index.d.ts

@@ -0,0 +1,2 @@
+export { Carousel, CarouselContent, CarouselItem, CarouselPrevious, CarouselNext, CarouselNavigation, CarouselDots, CarouselDot, useCarousel, type CarouselApi, type CarouselControlPlacement, type CarouselControlProps, type CarouselDotProps, type CarouselDotsProps, type CarouselNavigationAlign, type CarouselNavigationProps, type CarouselOptions, type CarouselOrientation, type CarouselPaginationStyle, type CarouselPlugin, type CarouselProps, } from './carousel';
+export { defaultCarouselStrings, type CarouselStrings, } from './carousel.strings';

package/dist/components/base/cascader/cascader.d.ts

@@ -0,0 +1,2 @@
+import type { CascaderProps } from './cascader.types';
+export declare function Cascader<T = unknown>({ items, value, defaultValue, onValueChange, multiple, mode, selectable, open: controlledOpen, defaultOpen, onOpenChange, disabled, invalid, searchable, clearable, density, size: sizeProp, name, id, className, strings: customStrings, loadChildren, renderValue, ...aria }: CascaderProps<T>): import("react").JSX.Element;

package/dist/components/base/cascader/cascader.types.d.ts

@@ -0,0 +1,57 @@
+import type { ReactNode } from 'react';
+import type { TreeNode } from '../tree';
+import type { RowDensity } from '../../../lib/row-recipes';
+import type { FormControlSize } from '../../../lib/ui-provider';
+export type CascaderNode<T = unknown> = TreeNode<T>;
+export type CascaderMode = 'drill' | 'columns' | 'tree';
+export interface CascaderStrings {
+    placeholder: string;
+    search: string;
+    empty: string;
+    loading: string;
+    error: string;
+    retry: string;
+    back: string;
+    root: string;
+    clear: string;
+    selectCurrent: string;
+    pathSeparator: string;
+}
+export interface CascaderChangeDetails<T = unknown> {
+    node: CascaderNode<T> | null;
+    path: CascaderNode<T>[];
+    reason: 'select' | 'deselect' | 'clear';
+}
+/** Framework-neutral nested picker. Values identify nodes, independently of labels. */
+export interface CascaderProps<T = unknown> {
+    items: readonly CascaderNode<T>[];
+    value?: string | readonly string[] | null;
+    defaultValue?: string | readonly string[] | null;
+    onValueChange?: (value: string | string[] | null, details: CascaderChangeDetails<T>) => void;
+    multiple?: boolean;
+    mode?: CascaderMode;
+    selectable?: 'leaf' | 'any' | ((node: CascaderNode<T>) => boolean);
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    disabled?: boolean;
+    invalid?: boolean;
+    searchable?: boolean;
+    clearable?: boolean;
+    density?: RowDensity;
+    /** Form control scale: explicit prop, then UIProvider density.defaultScale, then md. */
+    size?: FormControlSize;
+    name?: string;
+    id?: string;
+    'aria-label'?: string;
+    'aria-labelledby'?: string;
+    'aria-describedby'?: string;
+    className?: string;
+    strings?: Partial<CascaderStrings>;
+    /** Loads initial branch children. Backing out of drill/columns, closing, unmounting or replacing items aborts pending work. */
+    loadChildren?: (node: CascaderNode<T>, context: {
+        signal: AbortSignal;
+    }) => Promise<readonly CascaderNode<T>[]>;
+    /** Optional trigger presentation; receives resolved paths without changing selection semantics. */
+    renderValue?: (paths: CascaderNode<T>[][]) => ReactNode;
+}

package/dist/components/base/cascader/index.d.ts

@@ -0,0 +1,2 @@
+export { Cascader } from './cascader';
+export type { CascaderProps, CascaderNode, CascaderMode, CascaderStrings, CascaderChangeDetails } from './cascader.types';