themelia-ui 1.0.0

package/dist/components/admin/patterns/commerce/order.d.ts

@@ -0,0 +1,90 @@
+import { ComponentProps, ReactNode } from 'react';
+import { LucideIcon } from 'lucide-react';
+import { ContentBlock } from '../../../base/display/index.js';
+import { OrderStatusStrings, RefundStrings, ShipmentStrings } from './commerce.strings.js';
+import { OrderStatus, RefundStage, ShipmentStatus } from './commerce.types.js';
+export interface OrderEvent {
+    id: string;
+    label: string;
+    /** Already formatted. */
+    timestamp?: string;
+    complete: boolean;
+}
+export interface OrderStatusCardProps extends Omit<ComponentProps<typeof ContentBlock>, "children"> {
+    orderNumber: string;
+    status: OrderStatus;
+    /** Oldest first, so "latest complete" and "next" are found by position. */
+    events: OrderEvent[];
+    /** Already formatted. */
+    eta?: string;
+    /**
+     * Opens the full event list on first render.
+     *
+     * Closed by default, because the panel above it already answers what just happened,
+     * what is next and when it lands — which is what a reader opening an order wants. The
+     * list underneath is the audit trail: five rows repeating two facts they have just read
+     * and adding three they did not ask for.
+     */
+    defaultHistoryOpen?: boolean;
+    strings?: Partial<OrderStatusStrings>;
+}
+export declare function OrderStatusCard({ orderNumber, status, events, eta, defaultHistoryOpen, strings, className, ...props }: OrderStatusCardProps): import("react").JSX.Element;
+export interface OrderTimelineEvent {
+    id: string;
+    title: string;
+    description?: string;
+    /** Already formatted. */
+    timestamp: string;
+    status: "completed" | "current" | "pending";
+}
+export interface OrderTimelineProps extends Omit<ComponentProps<typeof ContentBlock>, "children"> {
+    events: OrderTimelineEvent[];
+}
+export declare function OrderTimeline({ events, className, ...props }: OrderTimelineProps): import("react").JSX.Element;
+export interface PaymentEvent {
+    id: string;
+    label: string;
+    /** Already formatted. */
+    date: string;
+    /** Already formatted, including its currency. */
+    amount?: string;
+    icon?: LucideIcon;
+    settled: boolean;
+}
+export interface PaymentTimelineProps extends Omit<ComponentProps<"div">, "children"> {
+    events: PaymentEvent[];
+}
+export declare function PaymentTimeline({ events, className, ...props }: PaymentTimelineProps): import("react").JSX.Element;
+export interface TrackingStep {
+    id?: string;
+    label: string;
+    done: boolean;
+    /** Already formatted. When the stage happened — a parcel's rail is a log, not a plan. */
+    timestamp?: string;
+}
+export interface ShipmentDetail {
+    label: string;
+    value: ReactNode;
+}
+export interface ShipmentTrackingProps extends Omit<ComponentProps<typeof ContentBlock>, "children"> {
+    trackingNumber: string;
+    carrier?: string;
+    status: ShipmentStatus;
+    steps: TrackingStep[];
+    /** Anything else worth stating — weight, service, signature. */
+    details?: ShipmentDetail[];
+    strings?: Partial<ShipmentStrings>;
+}
+export declare function ShipmentTracking({ trackingNumber, carrier, status, steps, details, strings, className, ...props }: ShipmentTrackingProps): import("react").JSX.Element;
+export interface RefundStatusProps extends Omit<ComponentProps<typeof ContentBlock>, "children"> {
+    stage: RefundStage;
+    /** Already formatted, including its currency. */
+    amount: string;
+    reason?: ReactNode;
+    /** Where the money is going back to. */
+    method?: ReactNode;
+    /** Already formatted. */
+    eta?: string;
+    strings?: Partial<RefundStrings>;
+}
+export declare function RefundStatus({ stage, amount, reason, method, eta, strings, className, ...props }: RefundStatusProps): import("react").JSX.Element;

package/dist/components/admin/patterns/commerce/seo-listing.d.cts

@@ -0,0 +1,16 @@
+import { ComponentProps } from 'react';
+import { ContentBlock } from '../../../base/display/index.cjs';
+import { SeoStrings } from './commerce.strings.cjs';
+import { SeoScore, SeoScoreInput } from './seo-score.cjs';
+export interface SeoListingProps extends Omit<ComponentProps<typeof ContentBlock>, "children" | "title"> {
+    /** What the result will read as. */
+    listing: SeoScoreInput;
+    /**
+     * A score computed elsewhere — by an editor scoring on every keystroke, say. Without
+     * it this scores the listing itself.
+     */
+    score?: SeoScore;
+    onEdit?: () => void;
+    strings?: Partial<SeoStrings>;
+}
+export declare function SeoListing({ listing, score, onEdit, strings, className, ...props }: SeoListingProps): import("react").JSX.Element;

package/dist/components/admin/patterns/commerce/seo-listing.d.ts

@@ -0,0 +1,16 @@
+import { ComponentProps } from 'react';
+import { ContentBlock } from '../../../base/display/index.js';
+import { SeoStrings } from './commerce.strings.js';
+import { SeoScore, SeoScoreInput } from './seo-score.js';
+export interface SeoListingProps extends Omit<ComponentProps<typeof ContentBlock>, "children" | "title"> {
+    /** What the result will read as. */
+    listing: SeoScoreInput;
+    /**
+     * A score computed elsewhere — by an editor scoring on every keystroke, say. Without
+     * it this scores the listing itself.
+     */
+    score?: SeoScore;
+    onEdit?: () => void;
+    strings?: Partial<SeoStrings>;
+}
+export declare function SeoListing({ listing, score, onEdit, strings, className, ...props }: SeoListingProps): import("react").JSX.Element;

package/dist/components/admin/patterns/commerce/seo-score.d.cts

@@ -0,0 +1,73 @@
+/**
+ * How a listing's search presentation is scored.
+ *
+ * Pure functions with no React in them, exported so a consumer can score a draft while the
+ * user is still typing rather than only when the card renders it.
+ *
+ * The weights say what matters: title and description carry 30 points each because they
+ * are what a search result actually shows, the permalink 15, the slug and origin 10, and a
+ * target keyword 5 — and the keyword check only exists when a keyword was supplied, so an
+ * absent one does not drag the total down.
+ */
+export type SeoCheckId = "title" | "description" | "permalink" | "slug" | "url" | "keyword";
+/** `review` is "present but outside the range", not "broken". */
+export type SeoCheckStatus = "good" | "review" | "missing";
+export interface SeoLimits {
+    titleMin: number;
+    titleMax: number;
+    descriptionMin: number;
+    descriptionMax: number;
+    permalinkMax: number;
+}
+/** Google truncates around these; they are conventions, not rules, so they are overridable. */
+export declare const DEFAULT_SEO_LIMITS: SeoLimits;
+export interface SeoScoreInput {
+    title?: string;
+    description?: string;
+    /** The full URL, or just its path. */
+    permalink?: string;
+    /** The origin the permalink sits on — scored for HTTPS. */
+    baseUrl?: string;
+    /** What the copy is meant to rank for. Omit it and the check is not run. */
+    keyword?: string;
+    limits?: Partial<SeoLimits>;
+}
+export interface SeoCheck {
+    id: SeoCheckId;
+    status: SeoCheckStatus;
+    score: number;
+    maxScore: number;
+    /**
+     * The UNROUNDED fraction of this check that was earned, for anything showing a
+     * percentage.
+     *
+     * `score` is whole points, because a point total made of halves is not a point total —
+     * and rounding it was erasing the very penalty it had just applied. A 61-character title
+     * against a 60 cap scores 0.983, which is 29.5 of 30 points, which rounds to 30: the card
+     * then drew "61 / 60" beside "100%", saying in one row both that the title is over the
+     * limit and that nothing is wrong with it.
+     *
+     * OPTIONAL, and that is not a detail. `calculateSeoScore` always sets it, so the kit's
+     * own path is exact — but a consumer assembling a SeoCheck by hand is building a value
+     * of this type, and a required field added to a type people CONSTRUCT is a breaking
+     * change however additive it looks from inside. Absent, a reader falls back to the
+     * rounded score, which is what it had before.
+     */
+    ratio?: number;
+    /** The measured length, so a card can show "62 / 60". */
+    actual: number;
+    min?: number;
+    max?: number;
+}
+export interface SeoScore {
+    /** 0–100. */
+    score: number;
+    status: SeoCheckStatus;
+    checks: SeoCheck[];
+    limits: SeoLimits;
+}
+/** The path alone — no origin, no query, no fragment. */
+export declare function seoPermalinkPath(permalink?: string): string;
+/** The last segment of the path — the part a human reads. */
+export declare function seoPermalinkSlug(permalink?: string): string;
+export declare function calculateSeoScore(input: SeoScoreInput): SeoScore;

package/dist/components/admin/patterns/commerce/seo-score.d.ts

@@ -0,0 +1,73 @@
+/**
+ * How a listing's search presentation is scored.
+ *
+ * Pure functions with no React in them, exported so a consumer can score a draft while the
+ * user is still typing rather than only when the card renders it.
+ *
+ * The weights say what matters: title and description carry 30 points each because they
+ * are what a search result actually shows, the permalink 15, the slug and origin 10, and a
+ * target keyword 5 — and the keyword check only exists when a keyword was supplied, so an
+ * absent one does not drag the total down.
+ */
+export type SeoCheckId = "title" | "description" | "permalink" | "slug" | "url" | "keyword";
+/** `review` is "present but outside the range", not "broken". */
+export type SeoCheckStatus = "good" | "review" | "missing";
+export interface SeoLimits {
+    titleMin: number;
+    titleMax: number;
+    descriptionMin: number;
+    descriptionMax: number;
+    permalinkMax: number;
+}
+/** Google truncates around these; they are conventions, not rules, so they are overridable. */
+export declare const DEFAULT_SEO_LIMITS: SeoLimits;
+export interface SeoScoreInput {
+    title?: string;
+    description?: string;
+    /** The full URL, or just its path. */
+    permalink?: string;
+    /** The origin the permalink sits on — scored for HTTPS. */
+    baseUrl?: string;
+    /** What the copy is meant to rank for. Omit it and the check is not run. */
+    keyword?: string;
+    limits?: Partial<SeoLimits>;
+}
+export interface SeoCheck {
+    id: SeoCheckId;
+    status: SeoCheckStatus;
+    score: number;
+    maxScore: number;
+    /**
+     * The UNROUNDED fraction of this check that was earned, for anything showing a
+     * percentage.
+     *
+     * `score` is whole points, because a point total made of halves is not a point total —
+     * and rounding it was erasing the very penalty it had just applied. A 61-character title
+     * against a 60 cap scores 0.983, which is 29.5 of 30 points, which rounds to 30: the card
+     * then drew "61 / 60" beside "100%", saying in one row both that the title is over the
+     * limit and that nothing is wrong with it.
+     *
+     * OPTIONAL, and that is not a detail. `calculateSeoScore` always sets it, so the kit's
+     * own path is exact — but a consumer assembling a SeoCheck by hand is building a value
+     * of this type, and a required field added to a type people CONSTRUCT is a breaking
+     * change however additive it looks from inside. Absent, a reader falls back to the
+     * rounded score, which is what it had before.
+     */
+    ratio?: number;
+    /** The measured length, so a card can show "62 / 60". */
+    actual: number;
+    min?: number;
+    max?: number;
+}
+export interface SeoScore {
+    /** 0–100. */
+    score: number;
+    status: SeoCheckStatus;
+    checks: SeoCheck[];
+    limits: SeoLimits;
+}
+/** The path alone — no origin, no query, no fragment. */
+export declare function seoPermalinkPath(permalink?: string): string;
+/** The last segment of the path — the part a human reads. */
+export declare function seoPermalinkSlug(permalink?: string): string;
+export declare function calculateSeoScore(input: SeoScoreInput): SeoScore;

package/dist/components/admin/patterns/commerce/summary-panel.d.cts

@@ -0,0 +1,22 @@
+import { ComponentProps, ReactNode } from 'react';
+export interface AmountRowProps extends Omit<ComponentProps<"div">, "children"> {
+    label: ReactNode;
+    /** Already formatted, including its currency. */
+    amount: string;
+    /** Marks the row the eye should land on — a total, an amount due. */
+    total?: boolean;
+    /**
+     * Money coming off the total. Rewrites the sign rather than trusting the caller's, and
+     * tints the figure, because a discount that reads like a charge is worse than no
+     * discount line at all.
+     */
+    deduction?: boolean;
+    /** A rate, a qualifier — sits quietly beside the label. */
+    note?: ReactNode;
+}
+export declare function AmountRow({ label, amount, total, deduction, note, className, ...props }: AmountRowProps): import("react").JSX.Element;
+export interface SummaryPanelProps extends ComponentProps<"div"> {
+    /** A quieter ground than the card it sits in, so the rows read as a sub-total block. */
+    children: ReactNode;
+}
+export declare function SummaryPanel({ children, className, ...props }: SummaryPanelProps): import("react").JSX.Element;

package/dist/components/admin/patterns/commerce/summary-panel.d.ts

@@ -0,0 +1,22 @@
+import { ComponentProps, ReactNode } from 'react';
+export interface AmountRowProps extends Omit<ComponentProps<"div">, "children"> {
+    label: ReactNode;
+    /** Already formatted, including its currency. */
+    amount: string;
+    /** Marks the row the eye should land on — a total, an amount due. */
+    total?: boolean;
+    /**
+     * Money coming off the total. Rewrites the sign rather than trusting the caller's, and
+     * tints the figure, because a discount that reads like a charge is worse than no
+     * discount line at all.
+     */
+    deduction?: boolean;
+    /** A rate, a qualifier — sits quietly beside the label. */
+    note?: ReactNode;
+}
+export declare function AmountRow({ label, amount, total, deduction, note, className, ...props }: AmountRowProps): import("react").JSX.Element;
+export interface SummaryPanelProps extends ComponentProps<"div"> {
+    /** A quieter ground than the card it sits in, so the rows read as a sub-total block. */
+    children: ReactNode;
+}
+export declare function SummaryPanel({ children, className, ...props }: SummaryPanelProps): import("react").JSX.Element;

package/dist/components/admin/patterns/commerce/vendor-profile.d.cts

@@ -0,0 +1,38 @@
+import { ComponentProps, ReactNode } from 'react';
+import { ContentBlock } from '../../../base/display/index.cjs';
+import { VendorStrings } from './commerce.strings.cjs';
+/** A performance tile. `change` is a comparison, and its tone is stated, not inferred. */
+export interface VendorStat {
+    id?: string;
+    label: ReactNode;
+    value: ReactNode;
+    change?: ReactNode;
+    changeTone?: "secondary" | "success" | "warning" | "destructive";
+}
+/** An operating fact — lead time, fill rate, disputes. */
+export interface VendorMetric {
+    id?: string;
+    label: ReactNode;
+    value: ReactNode;
+}
+export type VendorView = "overview" | "stats";
+export interface VendorProfileProps extends Omit<ComponentProps<typeof ContentBlock>, "children" | "title" | "role"> {
+    name: string;
+    /** Derived from `name` when omitted. */
+    initials?: string;
+    avatarUrl?: string;
+    /** Category, market, location — whatever places them. */
+    role?: ReactNode;
+    verified?: boolean;
+    /** Already formatted, including its currency. */
+    earnings?: string;
+    metrics?: VendorMetric[];
+    stats?: VendorStat[];
+    /** Controlled. */
+    view?: VendorView;
+    onViewChange?: (view: VendorView) => void;
+    onMessage?: () => void;
+    onHire?: () => void;
+    strings?: Partial<VendorStrings>;
+}
+export declare function VendorProfile({ name, initials, avatarUrl, role, verified, earnings, metrics, stats, view, onViewChange, onMessage, onHire, strings, className, ...props }: VendorProfileProps): import("react").JSX.Element;

package/dist/components/admin/patterns/commerce/vendor-profile.d.ts

@@ -0,0 +1,38 @@
+import { ComponentProps, ReactNode } from 'react';
+import { ContentBlock } from '../../../base/display/index.js';
+import { VendorStrings } from './commerce.strings.js';
+/** A performance tile. `change` is a comparison, and its tone is stated, not inferred. */
+export interface VendorStat {
+    id?: string;
+    label: ReactNode;
+    value: ReactNode;
+    change?: ReactNode;
+    changeTone?: "secondary" | "success" | "warning" | "destructive";
+}
+/** An operating fact — lead time, fill rate, disputes. */
+export interface VendorMetric {
+    id?: string;
+    label: ReactNode;
+    value: ReactNode;
+}
+export type VendorView = "overview" | "stats";
+export interface VendorProfileProps extends Omit<ComponentProps<typeof ContentBlock>, "children" | "title" | "role"> {
+    name: string;
+    /** Derived from `name` when omitted. */
+    initials?: string;
+    avatarUrl?: string;
+    /** Category, market, location — whatever places them. */
+    role?: ReactNode;
+    verified?: boolean;
+    /** Already formatted, including its currency. */
+    earnings?: string;
+    metrics?: VendorMetric[];
+    stats?: VendorStat[];
+    /** Controlled. */
+    view?: VendorView;
+    onViewChange?: (view: VendorView) => void;
+    onMessage?: () => void;
+    onHire?: () => void;
+    strings?: Partial<VendorStrings>;
+}
+export declare function VendorProfile({ name, initials, avatarUrl, role, verified, earnings, metrics, stats, view, onViewChange, onMessage, onHire, strings, className, ...props }: VendorProfileProps): import("react").JSX.Element;

package/dist/components/admin/patterns/index.d.cts

@@ -0,0 +1,2 @@
+export * from './access/index.cjs';
+export * from './commerce/index.cjs';

package/dist/components/admin/patterns/index.d.ts

@@ -0,0 +1,2 @@
+export * from './access/index.js';
+export * from './commerce/index.js';

package/dist/components/base/accordion/accordion.d.cts

@@ -0,0 +1,21 @@
+import { Accordion as AccordionPrimitive } from '@base-ui/react/accordion';
+import { AccordionItemData, AccordionMedia, AccordionSurface } from './accordion.types.cjs';
+export interface AccordionProps extends AccordionPrimitive.Root.Props<string> {
+    /** Outer chrome. Resolves through the provider when omitted. */
+    surface?: AccordionSurface;
+    /**
+     * Bounded sections. Renders the canonical icon/title/badge/description row, so the
+     * common accordion is one prop rather than four nested elements per section. Ignored
+     * when `children` are supplied.
+     */
+    items?: AccordionItemData[];
+    /** How leading media is framed. Only meaningful alongside `items`. */
+    media?: AccordionMedia;
+}
+export type AccordionItemProps = AccordionPrimitive.Item.Props;
+export type AccordionTriggerProps = AccordionPrimitive.Trigger.Props;
+export type AccordionContentProps = AccordionPrimitive.Panel.Props;
+export declare function Accordion({ className, surface, items, media, children, ...props }: AccordionProps): import("react").JSX.Element;
+export declare function AccordionItem({ className, ...props }: AccordionItemProps): import("react").JSX.Element;
+export declare function AccordionTrigger({ className, children, ...props }: AccordionTriggerProps): import("react").JSX.Element;
+export declare function AccordionContent({ className, children, ...props }: AccordionContentProps): import("react").JSX.Element;

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

@@ -0,0 +1,21 @@
+import { Accordion as AccordionPrimitive } from '@base-ui/react/accordion';
+import { AccordionItemData, AccordionMedia, AccordionSurface } from './accordion.types.js';
+export interface AccordionProps extends AccordionPrimitive.Root.Props<string> {
+    /** Outer chrome. Resolves through the provider when omitted. */
+    surface?: AccordionSurface;
+    /**
+     * Bounded sections. Renders the canonical icon/title/badge/description row, so the
+     * common accordion is one prop rather than four nested elements per section. Ignored
+     * when `children` are supplied.
+     */
+    items?: AccordionItemData[];
+    /** How leading media is framed. Only meaningful alongside `items`. */
+    media?: AccordionMedia;
+}
+export type AccordionItemProps = AccordionPrimitive.Item.Props;
+export type AccordionTriggerProps = AccordionPrimitive.Trigger.Props;
+export type AccordionContentProps = AccordionPrimitive.Panel.Props;
+export declare function Accordion({ className, surface, items, media, children, ...props }: AccordionProps): import("react").JSX.Element;
+export declare function AccordionItem({ className, ...props }: AccordionItemProps): import("react").JSX.Element;
+export declare function AccordionTrigger({ className, children, ...props }: AccordionTriggerProps): import("react").JSX.Element;
+export declare function AccordionContent({ className, children, ...props }: AccordionContentProps): import("react").JSX.Element;

package/dist/components/base/accordion/accordion.types.d.cts

@@ -0,0 +1,39 @@
+import { ReactNode } from 'react';
+/**
+ * Outer chrome for the group.
+ *
+ * `bordered` — one cohesive shell with quiet row dividers. The settings-page default.
+ * `card`     — each section is its own panel. For genuinely independent sections.
+ * `flat`     — no chrome; the consumer supplies it.
+ */
+export type AccordionSurface = "bordered" | "card" | "flat";
+/**
+ * How leading media is framed. When no row supplies media the column is removed rather
+ * than left as an empty gutter; a mixed group keeps a placeholder so titles stay aligned.
+ */
+export type AccordionMedia = "inline" | "medallion" | "none";
+/**
+ * One section, for the bounded `items` API. For richer rows — multi-line metadata,
+ * custom layouts — drop to the compound parts and compose freely.
+ */
+export interface AccordionItemData {
+    /** Stable identifier. Used as the item's `value`. */
+    value: string;
+    title: ReactNode;
+    /** Supporting line below the title, inside the trigger. */
+    description?: ReactNode;
+    /** Leading media. Framed per the root's `media` prop. */
+    icon?: ReactNode;
+    /** Trailing node after the title — usually a `<Badge>`. */
+    badge?: ReactNode;
+    content: ReactNode;
+    disabled?: boolean;
+}
+declare module '../../../lib/ui-provider' {
+    interface ComponentDefaults {
+        accordion: {
+            surface: AccordionSurface;
+            media: AccordionMedia;
+        };
+    }
+}

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

@@ -0,0 +1,39 @@
+import { ReactNode } from 'react';
+/**
+ * Outer chrome for the group.
+ *
+ * `bordered` — one cohesive shell with quiet row dividers. The settings-page default.
+ * `card`     — each section is its own panel. For genuinely independent sections.
+ * `flat`     — no chrome; the consumer supplies it.
+ */
+export type AccordionSurface = "bordered" | "card" | "flat";
+/**
+ * How leading media is framed. When no row supplies media the column is removed rather
+ * than left as an empty gutter; a mixed group keeps a placeholder so titles stay aligned.
+ */
+export type AccordionMedia = "inline" | "medallion" | "none";
+/**
+ * One section, for the bounded `items` API. For richer rows — multi-line metadata,
+ * custom layouts — drop to the compound parts and compose freely.
+ */
+export interface AccordionItemData {
+    /** Stable identifier. Used as the item's `value`. */
+    value: string;
+    title: ReactNode;
+    /** Supporting line below the title, inside the trigger. */
+    description?: ReactNode;
+    /** Leading media. Framed per the root's `media` prop. */
+    icon?: ReactNode;
+    /** Trailing node after the title — usually a `<Badge>`. */
+    badge?: ReactNode;
+    content: ReactNode;
+    disabled?: boolean;
+}
+declare module '../../../lib/ui-provider' {
+    interface ComponentDefaults {
+        accordion: {
+            surface: AccordionSurface;
+            media: AccordionMedia;
+        };
+    }
+}

package/dist/components/base/accordion/index.d.cts

@@ -0,0 +1,3 @@
+export { Accordion, AccordionContent, AccordionItem, AccordionTrigger } from './accordion.cjs';
+export type { AccordionContentProps, AccordionItemProps, AccordionProps, AccordionTriggerProps } from './accordion.cjs';
+export type { AccordionItemData, AccordionMedia, AccordionSurface } from './accordion.types.cjs';

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

@@ -0,0 +1,3 @@
+export { Accordion, AccordionContent, AccordionItem, AccordionTrigger } from './accordion.js';
+export type { AccordionContentProps, AccordionItemProps, AccordionProps, AccordionTriggerProps } from './accordion.js';
+export type { AccordionItemData, AccordionMedia, AccordionSurface } from './accordion.types.js';

package/dist/components/base/action-menu/action-menu.d.cts

@@ -0,0 +1,68 @@
+import { ComponentProps } from 'react';
+import { Button } from '../buttons/index.cjs';
+import { DropdownMenuTrigger } from '../dropdown-menu/index.cjs';
+import { ActionMenuStrings } from './action-menu.strings.cjs';
+import { ActionDefinition, ActionIcon, ActionLinkRenderer, ActionMenuLabelVisibility } from './action-menu.types.cjs';
+export interface ActionMenuProps {
+    /** Commands to offer. Destructive entries move last unless `preserveOrder` is set. */
+    actions: readonly ActionDefinition[];
+    /** Trigger text. Omit for an icon-only trigger — `strings.trigger` names it then. */
+    label?: string;
+    /** Trigger glyph. Defaults to the vertical ellipsis. */
+    icon?: ActionIcon;
+    /** Overrides this menu's own copy. */
+    strings?: Partial<ActionMenuStrings>;
+    buttonProps?: Omit<ComponentProps<typeof Button>, "children">;
+    align?: "start" | "center" | "end";
+    side?: "top" | "right" | "bottom" | "left";
+    contentClassName?: string;
+    /**
+     * Fixed surface width, any CSS length, or `"trigger"` to match the trigger. Left
+     * unset the menu sizes to its widest row.
+     */
+    width?: string | number | "trigger";
+    minWidth?: string | number;
+    /**
+     * Ceiling for the content-sized default. Defaults to a reading measure rather than
+     * the viewport, so one long label cannot drag every row out with it.
+     */
+    maxWidth?: string | number;
+    closeOnSelect?: boolean;
+    labelVisibility?: ActionMenuLabelVisibility;
+    /** Keeps the incoming order instead of moving destructive entries last. */
+    preserveOrder?: boolean;
+    /** Routes `href` actions through the app's router, keeping this framework-agnostic. */
+    renderLink?: ActionLinkRenderer;
+    /**
+     * Replaces the trigger entirely, so a menu can hang off something that is not a
+     * button — an account block, a sidebar row, a tab matching its siblings. For a plain
+     * button that just needs different words, `label` and `icon` are the smaller tools.
+     */
+    renderTrigger?: ComponentProps<typeof DropdownMenuTrigger>["render"];
+}
+export interface ActionButtonsProps {
+    /** The same definitions, side by side rather than collapsed into a menu. */
+    actions: readonly ActionDefinition[];
+    /**
+     * How many render as buttons before the remainder collapses into an overflow menu.
+     *
+     * The menu is built from the SAME array, which is the point: a toolbar that hard-codes
+     * its own overflow is how the menu ends up offering something the buttons already do.
+     * Left unset, every definition is a button.
+     */
+    max?: number;
+    /** Overrides this toolbar's own copy — the overflow trigger's name. */
+    strings?: Partial<ActionMenuStrings>;
+    className?: string;
+    renderLink?: ActionLinkRenderer;
+}
+/**
+ * Overflow commands for a page, a card, a table, or a row.
+ *
+ * There is deliberately one of these rather than a menu per surface: grouping, the
+ * destructive ordering, the checkbox rows, and the link handling are the parts everyone
+ * gets subtly different when they assemble a menu by hand.
+ */
+export declare function ActionMenu({ actions, label, icon, strings, buttonProps, align, side, contentClassName, width, minWidth, maxWidth, closeOnSelect, labelVisibility, preserveOrder, renderLink, renderTrigger, }: ActionMenuProps): import("react").JSX.Element | null;
+/** The same definitions rendered as visible buttons — a toolbar rather than an overflow. */
+export declare function ActionButtons({ actions, max, strings, className, renderLink, }: ActionButtonsProps): import("react").JSX.Element | null;