@raydenui/ui 0.9.7 → 0.10.1

package/dist/blocks.d.ts

@@ -0,0 +1,1820 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from 'react';
+import { ReactNode, HTMLAttributes, MouseEvent } from 'react';
+import { I as IllustrationName, S as SortDirection } from './Table-DCNSxua1.js';
+import { I as IconName } from './icons-8yD7I5jO.js';
+
+type CommerceHeadingLevel = "h1" | "h2" | "h3" | "h4" | "h5" | "h6";
+interface CommerceImage {
+    src: string;
+    alt: string;
+}
+interface CommerceProduct {
+    id: string;
+    name: string;
+    description?: string;
+    category?: string;
+    /** Non-negative integer in the currency's minor unit (pence for GBP, yen for JPY). */
+    price: number;
+    image?: CommerceImage;
+    href?: string;
+    badge?: string;
+    /** Omit for unlimited availability. Zero means sold out. */
+    stock?: number;
+}
+interface CommerceCartItem extends CommerceProduct {
+    /** A unique cart-line id, including variant when applicable. */
+    id: string;
+    quantity: number;
+    variant?: string;
+}
+interface CommerceBaseProps {
+    title?: string;
+    description?: string;
+    headingLevel?: CommerceHeadingLevel;
+    className?: string;
+    /** ISO 4217 currency shared by every price in this block. @default "GBP" */
+    currency?: string;
+    /** Explicit default keeps server and client formatting consistent. @default "en-GB" */
+    locale?: string;
+}
+interface CommerceTotalsProps {
+    /** All amounts use the same minor currency unit as item prices. */
+    shipping?: number;
+    tax?: number;
+    discount?: number;
+}
+
+interface CheckoutReviewBlockProps extends CommerceBaseProps, CommerceTotalsProps {
+    items: CommerceCartItem[];
+    /** Display only. Collect and validate the address in the host application. */
+    deliveryAddress: string[];
+    deliveryMethod: string;
+    /** Display only, e.g. "Visa ending in 4242". Never pass full payment credentials. */
+    paymentSummary: string;
+    onEditDelivery?: () => void;
+    onEditPayment?: () => void;
+    onEditCart?: () => void;
+    onConfirm?: () => void;
+    confirmLabel?: string;
+    pending?: boolean;
+    errorMessage?: string;
+    /** Render only after the host application confirms a successful order. */
+    confirmation?: {
+        title: string;
+        description?: string;
+        reference?: string;
+    };
+    terms?: ReactNode;
+    totalsNote?: string;
+}
+declare function CheckoutReviewBlock({ title, description, items, deliveryAddress, deliveryMethod, paymentSummary, onEditDelivery, onEditPayment, onEditCart, onConfirm, confirmLabel, pending, errorMessage, confirmation, terms, totalsNote, shipping, tax, discount, currency, locale, ...frame }: CheckoutReviewBlockProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Heading element used for the block title. Embedding context varies, so the
+ * level is a contract rather than a hard-coded `h3`.
+ */
+type CreateAccountHeadingLevel = "h1" | "h2" | "h3" | "h4" | "h5" | "h6";
+/**
+ * Lifecycle reported by the consuming application.
+ *
+ * - `idle` — the form is ready for input.
+ * - `loading` — the app is still fetching the context the form needs
+ *   (invitation, provider configuration). Fields are not shown yet.
+ * - `submitting` — the app is creating the account. Every control that could
+ *   start a second registration attempt is disabled.
+ * - `error` — the app reports a failed attempt. Input is preserved.
+ * - `success` — the app has **confirmed** the account exists. The block never
+ *   sets this itself.
+ */
+type CreateAccountStatus = "idle" | "loading" | "submitting" | "error" | "success";
+interface CreateAccountValues {
+    firstName: string;
+    lastName: string;
+    email: string;
+    password: string;
+    /** True only when the required consent control is checked. */
+    consent: boolean;
+}
+type CreateAccountFieldName = "firstName" | "lastName" | "email" | "password" | "confirmPassword" | "consent";
+type CreateAccountFieldErrors = Partial<Record<CreateAccountFieldName, string>>;
+interface CreateAccountPasswordRule {
+    id: string;
+    /** Shown verbatim in the guidance list. Translate it in the consuming app. */
+    label: string;
+    test: (password: string) => boolean;
+}
+interface CreateAccountLink {
+    label: string;
+    href: string;
+}
+interface CreateAccountBlockProps {
+    /** Block title. */
+    title?: string;
+    /** Supporting sentence under the title. */
+    description?: string;
+    /** Heading element for {@link title}. @default "h2" */
+    headingLevel?: CreateAccountHeadingLevel;
+    /**
+     * Called only when every field passes local validation and no submission is
+     * already in flight. Required: the block never renders a submit control with
+     * no configured action.
+     */
+    onSubmit: (values: CreateAccountValues) => void;
+    /** Lifecycle owned by the consuming app. @default "idle" */
+    status?: CreateAccountStatus;
+    /** Message shown when `status` is `"error"`. */
+    errorMessage?: string;
+    /** Message shown when `status` is `"success"`. */
+    successMessage?: string;
+    /**
+     * Server-reported errors, merged over local validation. They are shown
+     * immediately, without waiting for the field to be touched.
+     */
+    fieldErrors?: CreateAccountFieldErrors;
+    /** Initial field contents. The block owns the draft after first render. */
+    defaultValues?: Partial<Omit<CreateAccountValues, "consent">>;
+    /** Password guidance. Every rule must pass before submission. */
+    passwordRules?: CreateAccountPasswordRule[];
+    /** Ask the person to type the password twice. @default true */
+    requireConfirmPassword?: boolean;
+    /**
+     * Consent sentence. Links inside it stay independently operable; the whole
+     * sentence is the checkbox's accessible name.
+     */
+    consentLabel?: ReactNode;
+    /** Error shown when consent is missing. */
+    consentErrorMessage?: string;
+    /** Destination for people who already have an account. Rendered as a link. */
+    signIn?: CreateAccountLink;
+    /** Submit label. @default "Create account" */
+    submitLabel?: string;
+    /** Label announced while submitting. @default "Creating account…" */
+    submittingLabel?: string;
+    /**
+     * Registration is unavailable (closed, expired invitation, or the viewer
+     * lacks permission). Every control is disabled and the reason is shown.
+     */
+    disabled?: boolean;
+    /** Explanation shown when {@link disabled} is true. */
+    disabledMessage?: string;
+    /** Field labels, so the block can be translated without forking it. */
+    labels?: Partial<Record<"firstName" | "lastName" | "email" | "password" | "confirmPassword", string>>;
+    className?: string;
+}
+declare const defaultCreateAccountPasswordRules: CreateAccountPasswordRule[];
+declare function CreateAccountBlock({ title, description, headingLevel, onSubmit, status, errorMessage, successMessage, fieldErrors, defaultValues, passwordRules, requireConfirmPassword, consentLabel, consentErrorMessage, signIn, submitLabel, submittingLabel, disabled, disabledMessage, labels, className, }: CreateAccountBlockProps): react_jsx_runtime.JSX.Element;
+
+type EmptyStateBlockVariant = "inline" | "card";
+interface EmptyStateBlockAction {
+    label: string;
+    icon?: ReactNode | IconName;
+    onClick?: () => void;
+}
+interface EmptyStateBlockProps {
+    /** Which illustration to show */
+    illustration: IllustrationName;
+    /** Colored or grey/monochrome illustration */
+    illustrationColored?: boolean;
+    /**
+     * Custom color palette for the illustration. This is a customisation surface,
+     * not a theme role: values are literal colors and do not follow light/dark
+     * mode. Supply mode-appropriate colors yourself, or omit to inherit the
+     * flavor's illustration palette.
+     */
+    illustrationPalette?: string[];
+    /** Illustration size in pixels */
+    illustrationSize?: number;
+    /** Bold title text */
+    title: string;
+    /** Description text (supports \n for line breaks) */
+    description: string;
+    /** Optional primary action button */
+    action?: EmptyStateBlockAction;
+    /** Visual variant: inline (no wrapper) or card (`--color-surface` panel) */
+    variant?: EmptyStateBlockVariant;
+    /** Additional class names */
+    className?: string;
+}
+declare function EmptyStateBlock({ illustration, illustrationColored, illustrationPalette, illustrationSize, title, description, action, variant, className, }: EmptyStateBlockProps): react_jsx_runtime.JSX.Element;
+
+type FeatureOverviewHeadingLevel = "h1" | "h2" | "h3" | "h4" | "h5" | "h6";
+interface FeatureOverviewCtaBase {
+    label: string;
+    icon?: IconName;
+}
+interface FeatureOverviewLinkCta extends FeatureOverviewCtaBase {
+    href: string;
+    external?: boolean;
+    onClick?: (event: MouseEvent<HTMLAnchorElement>) => void;
+}
+interface FeatureOverviewActionCta extends FeatureOverviewCtaBase {
+    onClick: () => void;
+    href?: never;
+    external?: never;
+}
+type FeatureOverviewCta = FeatureOverviewLinkCta | FeatureOverviewActionCta;
+interface FeatureOverviewItem {
+    id: string;
+    title: ReactNode;
+    description?: ReactNode;
+    /** Icon rendered in the item's accent tile. */
+    icon?: IconName;
+    /** Short qualifier, e.g. "Beta" or "Enterprise". */
+    badge?: string;
+    /**
+     * Detail the visitor can follow. Rendered as a native link for a destination
+     * and a button for an in-page action. Omitted when not supplied — the block
+     * never renders a "Learn more" control that does nothing.
+     */
+    cta?: FeatureOverviewCta;
+}
+type FeatureOverviewState = "default" | "loading" | "empty" | "error";
+type FeatureOverviewColumns = 2 | 3 | 4;
+type FeatureOverviewVariant = "card" | "plain";
+interface FeatureOverviewEmptyState {
+    title: ReactNode;
+    description?: ReactNode;
+    /** Optional recovery step. Omitted when not supplied. */
+    cta?: FeatureOverviewCta;
+}
+interface FeatureOverviewBlockProps extends Omit<HTMLAttributes<HTMLElement>, "title"> {
+    /** Small label above the section title. Not a heading. */
+    eyebrow?: ReactNode;
+    /** Section title. */
+    title: ReactNode;
+    /** Supporting explanation under the title. */
+    description?: ReactNode;
+    /**
+     * Heading element for the section title. Item titles use the next level down.
+     * @default "h2"
+     */
+    headingLevel?: FeatureOverviewHeadingLevel;
+    /** Capabilities to scan. */
+    features: FeatureOverviewItem[];
+    /** Widest column count. Narrow viewports always reduce to one. @default 3 */
+    columns?: FeatureOverviewColumns;
+    /** `card` draws a bordered surface per item; `plain` is borderless. @default "card" */
+    variant?: FeatureOverviewVariant;
+    /** Section-level follow-on step rendered under the grid. */
+    footerCta?: FeatureOverviewCta;
+    /** @default "default" — derived from `features` only when left undefined. */
+    state?: FeatureOverviewState;
+    /** Number of placeholder items rendered while loading. @default 3 */
+    loadingItemCount?: number;
+    loadingLabel?: string;
+    /** Distinguishes "nothing configured" from "nothing matched" — caller's wording. */
+    emptyState?: FeatureOverviewEmptyState;
+    errorTitle?: string;
+    errorDescription?: ReactNode;
+    onRetry?: () => void;
+    retryLabel?: string;
+    className?: string;
+}
+/**
+ * Feature Overview — lets a visitor scan differentiated capabilities and follow
+ * the details that matter to them.
+ *
+ * States: `default`, `loading`, `empty`, `error`. There is no success state:
+ * the block submits nothing. When `state` is left undefined it resolves to
+ * `empty` for an empty `features` array and `default` otherwise, so an empty
+ * source is never silently rendered as a blank grid.
+ */
+declare const FeatureOverviewBlock: react.ForwardRefExoticComponent<FeatureOverviewBlockProps & react.RefAttributes<HTMLElement>>;
+
+type HeaderBlockVariant = 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11;
+interface HeaderBlockLink {
+    label: string;
+    href?: string;
+    onClick?: () => void;
+    /** Mark the current destination visually and with aria-current="page". */
+    active?: boolean;
+    hasDropdown?: boolean;
+    /** Show a notification dot next to the label */
+    dot?: boolean;
+}
+interface HeaderBlockAction {
+    label: string;
+    /** Render a normal link for navigation; omit for a callback-driven button. */
+    href?: string;
+    /** "primary" = solid primary button, "secondary" = secondary styled, "text" = text-only link */
+    variant?: "primary" | "secondary" | "text";
+    onClick?: () => void;
+}
+interface HeaderBlockAnnouncement {
+    text: string;
+    linkLabel?: string;
+    onLinkClick?: () => void;
+}
+/**
+ * Workspace switcher for variants 10 and 11.
+ *
+ * Controlled and uncontrolled are both supported, and which one applies is decided
+ * by whether `activeIndex` is a number:
+ *
+ * - **Uncontrolled** (`activeIndex` omitted or `undefined`): the header owns the
+ *   selection. `defaultActiveIndex` seeds it on first render only; changing it
+ *   afterwards does nothing, as with any React `default*` prop. Clicking a tab moves
+ *   the selection and then calls `onChange`.
+ * - **Controlled** (`activeIndex` is a number): the consumer owns the selection.
+ *   Clicking a tab does **not** move it; it only calls `onChange`, and the header
+ *   re-renders when the consumer passes a new `activeIndex`. A controlled switcher
+ *   with no `onChange` is therefore inert — supply `onChange` whenever you supply
+ *   `activeIndex`.
+ *
+ * `onChange` fires only when the index actually changes: clicking the already
+ * selected tab is not a change and raises nothing.
+ *
+ * Both indices are clamped into `0 … tabs.length - 1`, so an out-of-range value
+ * selects the nearest tab rather than leaving the group with nothing selected. With
+ * an empty `tabs` array the switcher renders nothing.
+ *
+ * Going from a number to `undefined` on `activeIndex` hands ownership back to the
+ * header, which resumes from its own last internal value; do not switch modes
+ * mid-life.
+ */
+interface HeaderBlockSwitcher {
+    /** Visible tab labels, in order. Must be unique. */
+    tabs: string[];
+    /** Controlled selection. Supply `onChange` with it and update it from there. */
+    activeIndex?: number;
+    /** Initial selection for uncontrolled use. Read once, on mount. Default `0`. */
+    defaultActiveIndex?: number;
+    /** Raised with the index the user asked for, in both modes. */
+    onChange?: (index: number) => void;
+    /** Accessible name for the switcher group. Default `"Workspace"`. */
+    label?: string;
+}
+interface HeaderBlockProps {
+    /** Visual variant (1-11) */
+    variant?: HeaderBlockVariant;
+    /** Logo element */
+    logo?: ReactNode;
+    /** Navigation links (center or left side for centered-logo variants) */
+    links?: HeaderBlockLink[];
+    /** Right-side navigation links (for centered-logo variants 7, 8 and variant 9) */
+    rightLinks?: HeaderBlockLink[];
+    /** Action buttons (far right) */
+    actions?: HeaderBlockAction[];
+    /** Announcement banner (variant 1) */
+    announcement?: HeaderBlockAnnouncement;
+    /** Search input placeholder (variant 9) */
+    searchPlaceholder?: string;
+    /** Search handler */
+    onSearch?: (query: string) => void;
+    /** Switcher tabs (variants 10-11) */
+    switcher?: HeaderBlockSwitcher;
+    /** Policy / secondary links for variant 11 top row */
+    secondaryLinks?: HeaderBlockLink[];
+    /** Accessible name for the primary navigation landmark */
+    navLabel?: string;
+    /** Accessible name for the secondary navigation landmark */
+    secondaryNavLabel?: string;
+    /** Additional class names */
+    className?: string;
+}
+declare function HeaderBlock({ variant, logo, links, rightLinks, actions, announcement, searchPlaceholder, onSearch, switcher, secondaryLinks, navLabel, secondaryNavLabel, className, }: HeaderBlockProps): react_jsx_runtime.JSX.Element;
+
+type KpiOverviewHeadingLevel = "h1" | "h2" | "h3" | "h4" | "h5" | "h6";
+type KpiChangeDirection = "up" | "down" | "flat";
+/**
+ * Whether the movement is good, bad, or neither *for this metric*. Direction
+ * and sentiment are separate: churn falling is a `down` direction with a
+ * `positive` sentiment.
+ */
+type KpiChangeSentiment = "positive" | "negative" | "neutral";
+interface KpiChange {
+    /** Pre-formatted, e.g. "+12.4%" or "−310". */
+    label: string;
+    direction: KpiChangeDirection;
+    /** @default "neutral" */
+    sentiment?: KpiChangeSentiment;
+}
+interface KpiTrend {
+    /** One label per point, used for the chart's text equivalent. */
+    labels: string[];
+    values: number[];
+}
+interface KpiMetric {
+    id: string;
+    /** What is being counted. */
+    label: string;
+    /** Pre-formatted by the consuming app, which owns locale and currency. */
+    value: string;
+    /** The same measure over the comparison period, pre-formatted. */
+    comparisonValue?: string;
+    change?: KpiChange;
+    /** One sentence of plain-language context. */
+    description?: string;
+    /** Optional sparkline. Rendered with a visually hidden data table. */
+    trend?: KpiTrend;
+    /**
+     * Set when this metric could not be computed. The tile then states why
+     * instead of showing a misleading zero.
+     */
+    unavailableReason?: string;
+    icon?: IconName;
+}
+interface KpiPeriod {
+    /** The period the values cover, e.g. "1–21 September 2026". */
+    label: string;
+    /** What they are compared with, e.g. "August 2026". */
+    comparisonLabel: string;
+}
+interface KpiPeriodOption {
+    id: string;
+    label: string;
+}
+type KpiOverviewStatus = "idle" | "loading" | "error";
+interface KpiOverviewBlockProps {
+    title?: string;
+    description?: string;
+    /** Heading element for {@link title}. @default "h2" */
+    headingLevel?: KpiOverviewHeadingLevel;
+    /** Required: metrics are meaningless without a stated period. */
+    period: KpiPeriod;
+    metrics: KpiMetric[];
+    /**
+     * Period choices. The selector renders only when options, a selected id and
+     * a change handler are all supplied.
+     */
+    periodOptions?: KpiPeriodOption[];
+    selectedPeriodId?: string;
+    onPeriodChange?: (id: string) => void;
+    /** Label for the period selector. @default "Reporting period" */
+    periodSelectLabel?: string;
+    /** @default "idle" */
+    status?: KpiOverviewStatus;
+    errorMessage?: string;
+    /** Retry control renders only when a handler is supplied. */
+    onRetry?: () => void;
+    /** When supplied, each tile becomes an activating control. */
+    onSelectMetric?: (id: string) => void;
+    /** Shown when `metrics` is empty. */
+    emptyTitle?: string;
+    emptyDescription?: string;
+    /** Extra content under the grid, e.g. a link to the full report. */
+    footer?: ReactNode;
+    /** Number of loading placeholders. @default 4 */
+    loadingPlaceholderCount?: number;
+    className?: string;
+}
+declare function KpiOverviewBlock({ title, description, headingLevel, period, metrics, periodOptions, selectedPeriodId, onPeriodChange, periodSelectLabel, status, errorMessage, onRetry, onSelectMetric, emptyTitle, emptyDescription, footer, loadingPlaceholderCount, className, }: KpiOverviewBlockProps): react_jsx_runtime.JSX.Element;
+
+type LoginBlockVariant = "standard" | "card" | "work-email";
+interface LoginBlockSocialProvider {
+    name: string;
+    icon: ReactNode;
+    onClick?: () => void;
+}
+interface LoginBlockProps {
+    /** Visual variant */
+    variant?: LoginBlockVariant;
+    /** Form heading */
+    title?: string;
+    /** Subtitle / description */
+    subtitle?: string;
+    /** Submit button label */
+    submitLabel?: string;
+    /**
+     * Password recovery handler. Rendered in every variant that supplies it,
+     * independently of `showRememberMe`.
+     */
+    onForgotPassword?: () => void;
+    /** Form submit handler. `rememberMe` reflects the visible checkbox. */
+    onSubmit?: (data: {
+        email: string;
+        password: string;
+        rememberMe: boolean;
+    }) => void;
+    /**
+     * Authentication is in flight.
+     *
+     * While true the block disables every control that could change the
+     * credentials being verified, change remembered-session intent, or start a
+     * competing authentication route: email, password, remember-me, password
+     * recovery, each social provider, submit, and sign-up. Repeat submits are
+     * also ignored, so pressing Enter cannot queue a second request.
+     *
+     * The password visibility toggle stays enabled: it only changes how the
+     * already-entered value is displayed.
+     */
+    pending?: boolean;
+    /** Submit label while `pending` is true. */
+    pendingLabel?: string;
+    /** Error message shown above the submit button, e.g. a rejected sign-in. */
+    error?: string;
+    /** Social login providers */
+    socialProviders?: LoginBlockSocialProvider[];
+    /** Sign-up link handler */
+    onSignUp?: () => void;
+    /** Sign-up prompt text */
+    signUpPrompt?: string;
+    /** Sign-up link text */
+    signUpLabel?: string;
+    /** Show remember me checkbox */
+    showRememberMe?: boolean;
+    /** Label for the remember-me checkbox. Avoid promising a duration the app cannot honour. */
+    rememberMeLabel?: string;
+    /** Additional class names */
+    className?: string;
+}
+declare function LoginBlock({ variant, title, subtitle, submitLabel, onForgotPassword, onSubmit, socialProviders, onSignUp, signUpPrompt, signUpLabel, showRememberMe, rememberMeLabel, pending, pendingLabel, error, className, }: LoginBlockProps): react_jsx_runtime.JSX.Element;
+
+interface NotificationItem {
+    id: string;
+    avatar: ReactNode;
+    text: ReactNode;
+    date: string;
+    time: string;
+    unread?: boolean;
+    link?: {
+        label: string;
+        href?: string;
+        onClick?: () => void;
+    };
+    badge?: string;
+    content?: {
+        type: "file";
+        title: string;
+        size?: string;
+        fileType?: string;
+        date?: string;
+    } | {
+        type: "comment";
+        avatar: ReactNode;
+        author: string;
+        timestamp: string;
+        comment: string;
+        reactions?: number;
+        replies?: number;
+    } | {
+        type: "cta";
+        primaryAction: {
+            label: string;
+            onClick?: () => void;
+        };
+        secondaryAction?: {
+            label: string;
+            onClick?: () => void;
+        };
+    };
+}
+interface NotificationsBlockProps {
+    /** Block title */
+    title?: string;
+    /** Heading level for the block title, so the block fits a page's outline */
+    headingLevel?: 2 | 3 | 4 | 5 | 6;
+    /** Unread notification count */
+    unreadCount?: number;
+    /** Notification items */
+    items: NotificationItem[];
+    /** Additional class names */
+    className?: string;
+}
+declare function NotificationsBlock({ title, headingLevel, unreadCount, items, className, }: NotificationsBlockProps): react_jsx_runtime.JSX.Element;
+
+type PricingPlansHeadingLevel = "h1" | "h2" | "h3" | "h4" | "h5" | "h6";
+interface PricingCtaBase {
+    label: string;
+    icon?: IconName;
+}
+interface PricingLinkCta extends PricingCtaBase {
+    href: string;
+    external?: boolean;
+    onClick?: (event: MouseEvent<HTMLAnchorElement>) => void;
+}
+interface PricingActionCta extends PricingCtaBase {
+    onClick: () => void;
+    href?: never;
+    external?: never;
+}
+type PricingCta = PricingLinkCta | PricingActionCta;
+interface PricingBillingPeriod {
+    id: string;
+    /** Visible label, e.g. "Monthly". Supplied in the caller's language. */
+    label: string;
+    /** Optional qualifier shown beside the label, e.g. "Save 20%". */
+    badge?: string;
+}
+interface PricingPrice {
+    /** Amount in the currency's major unit. Formatted with `locale`. */
+    amount?: number;
+    /** ISO 4217 code, e.g. "USD". Required alongside `amount`. */
+    currency?: string;
+    /** Rendered after the amount, e.g. "per editor / month". */
+    unit?: ReactNode;
+    /** Replaces the amount entirely, e.g. "Custom pricing". Takes precedence. */
+    custom?: ReactNode;
+    /** Reference amount shown struck through, e.g. the undiscounted price. */
+    originalAmount?: number;
+    /** Small print under the price, e.g. "billed annually". */
+    note?: ReactNode;
+}
+interface PricingFeature {
+    id: string;
+    label: ReactNode;
+    /**
+     * Whether the plan includes this feature. Excluded features keep a visible
+     * text status as well as an icon, so meaning never rests on colour alone.
+     * @default true
+     */
+    included?: boolean;
+    /** Short qualifier, e.g. "add-on". */
+    note?: string;
+}
+interface PricingLimit {
+    id: string;
+    /** e.g. "Included events". */
+    label: ReactNode;
+    /** e.g. "250,000 / month". Pre-formatted by the caller. */
+    value: ReactNode;
+}
+type PricingPlanAvailability = "available" | "current" | "unavailable";
+interface PricingPlan {
+    id: string;
+    name: ReactNode;
+    description?: ReactNode;
+    /** Qualifier such as "Most popular". Carries the meaning of `highlighted`. */
+    badge?: string;
+    /** Adds visual emphasis. Always pair with `badge` so it is not colour-only. */
+    highlighted?: boolean;
+    /** Price per billing period, keyed by `PricingBillingPeriod.id`. */
+    prices: Record<string, PricingPrice>;
+    /** Included usage and limits. */
+    limits?: PricingLimit[];
+    features?: PricingFeature[];
+    /**
+     * The plan's next step. Required for an `available` plan; omit it for a
+     * `current` plan. Without it no control is rendered at all.
+     */
+    cta?: PricingCta;
+    /** @default "available" */
+    availability?: PricingPlanAvailability;
+    /** Why the plan cannot be chosen. Announced through aria-describedby. */
+    unavailableReason?: string;
+    /** Replaces the default "Current plan" marker text. */
+    currentLabel?: string;
+}
+type PricingPlansState = "default" | "loading" | "empty" | "error";
+interface PricingPlansNotice {
+    tone: "success" | "info" | "warning" | "error";
+    title: ReactNode;
+    description?: ReactNode;
+}
+interface PricingPlansBlockProps extends Omit<HTMLAttributes<HTMLElement>, "title"> {
+    eyebrow?: ReactNode;
+    title: ReactNode;
+    description?: ReactNode;
+    /** @default "h2" — plan names use the next level down. */
+    headingLevel?: PricingPlansHeadingLevel;
+    /** Billing periods. Omit or supply one to hide the switcher. */
+    periods?: PricingBillingPeriod[];
+    /** Controlled selected period id. Pair with `onPeriodChange`. */
+    period?: string;
+    /** Uncontrolled initial period id. Defaults to the first period. */
+    defaultPeriod?: string;
+    onPeriodChange?: (periodId: string) => void;
+    /** Accessible name for the period switcher. @default "Billing period" */
+    periodLegend?: string;
+    plans: PricingPlan[];
+    /** BCP 47 tag used for currency formatting. @default "en-US" */
+    locale?: string;
+    /** Merged into the Intl.NumberFormat options used for every price. */
+    priceFormatOptions?: Intl.NumberFormatOptions;
+    /** Full override of price rendering. */
+    formatPrice?: (price: PricingPrice, context: {
+        locale: string;
+        periodId: string;
+    }) => ReactNode;
+    /** Heading above each plan's limits list. @default "Included usage" */
+    limitsLabel?: string;
+    /** Collapse a plan's feature list beyond this count behind a disclosure. */
+    featuresVisibleLimit?: number;
+    /** Shown when a plan is unavailable and supplies no reason of its own. */
+    defaultUnavailableReason?: string;
+    /**
+     * A consumer-confirmed outcome, e.g. "Your plan change is confirmed". The
+     * block never manufactures one: selecting a plan only calls the callback.
+     */
+    notice?: PricingPlansNotice;
+    /** Small print under the grid, e.g. tax treatment. */
+    footnote?: ReactNode;
+    /** @default "default" — resolves to `empty` for an empty `plans` array. */
+    state?: PricingPlansState;
+    loadingPlanCount?: number;
+    loadingLabel?: string;
+    emptyTitle?: ReactNode;
+    emptyDescription?: ReactNode;
+    errorTitle?: string;
+    errorDescription?: ReactNode;
+    onRetry?: () => void;
+    retryLabel?: string;
+    className?: string;
+}
+/**
+ * Pricing Plans — compare plans, switch billing period, and understand included
+ * usage and limits.
+ *
+ * States: `default`, `loading`, `empty`, `error`, plus per-plan `available`,
+ * `current`, and `unavailable`. Choosing a plan calls `cta.onClick` or follows
+ * `cta.href`; the block performs no purchase and never claims one succeeded.
+ * Pass `notice` to show an outcome the consuming application has confirmed.
+ */
+declare const PricingPlansBlock: react.ForwardRefExoticComponent<PricingPlansBlockProps & react.RefAttributes<HTMLElement>>;
+
+interface ProductCollectionBlockProps extends CommerceBaseProps {
+    products: CommerceProduct[];
+    /** Grid is image-led; list is a compact horizontal catalogue. */
+    layout?: "grid" | "list";
+    onSelectProduct?: (product: CommerceProduct) => void;
+    /** Omit to hide quick-add. Products requiring options should open detail first. */
+    onAddToCart?: (product: CommerceProduct) => void;
+    pendingProductIds?: string[];
+    status?: "ready" | "loading" | "error";
+    errorMessage?: string;
+    onRetry?: () => void;
+    emptyMessage?: string;
+}
+declare function ProductCollectionBlock({ title, description, products, layout, onSelectProduct, onAddToCart, pendingProductIds, status, errorMessage, onRetry, emptyMessage, currency, locale, ...frame }: ProductCollectionBlockProps): react_jsx_runtime.JSX.Element;
+
+interface ProductDetailOption {
+    id: string;
+    label: string;
+    /** Additional stock limit for this option. */ stock?: number;
+}
+interface ProductDetailSelection {
+    product: CommerceProduct;
+    option?: ProductDetailOption;
+    quantity: number;
+}
+interface ProductDetailBlockProps extends CommerceBaseProps {
+    product: CommerceProduct;
+    /** Ordered gallery; falls back to the product image. */
+    images?: CommerceImage[];
+    /** Stacked is useful for a quick-view panel or a narrow product page. */
+    layout?: "split" | "stacked";
+    options?: ProductDetailOption[];
+    optionLabel?: string;
+    details?: {
+        label: string;
+        value: string;
+    }[];
+    onAddToCart?: (selection: ProductDetailSelection) => void;
+    pending?: boolean;
+    errorMessage?: string;
+    /** Supplied after the host app confirms the cart update. */
+    successMessage?: string;
+    deliveryNote?: string;
+}
+/** Reset the selection when switching products. */
+declare function ProductDetailBlock(props: ProductDetailBlockProps): react_jsx_runtime.JSX.Element;
+
+type ProductHeroHeadingLevel = "h1" | "h2" | "h3" | "h4" | "h5" | "h6";
+interface ProductHeroCtaBase {
+    label: string;
+    /** Optional leading icon. */
+    icon?: IconName;
+}
+interface ProductHeroLinkCta extends ProductHeroCtaBase {
+    /** Destination. Renders a native anchor. */
+    href: string;
+    /** Opens in a new tab and adds rel="noreferrer". */
+    external?: boolean;
+    /** Optional analytics hook. Navigation still belongs to the anchor. */
+    onClick?: (event: MouseEvent<HTMLAnchorElement>) => void;
+}
+interface ProductHeroActionCta extends ProductHeroCtaBase {
+    /** In-page action. Renders a native button. */
+    onClick: () => void;
+    href?: never;
+    external?: never;
+}
+type ProductHeroCta = ProductHeroLinkCta | ProductHeroActionCta;
+interface ProductHeroHighlight {
+    id: string;
+    /** Short label, e.g. "Uptime" or "Teams onboarded". */
+    label: string;
+    /** Optional emphasised value, e.g. "99.98%". Pre-formatted by the caller. */
+    value?: ReactNode;
+    icon?: IconName;
+}
+type ProductHeroMediaRatio = "auto" | "video" | "wide" | "square";
+interface ProductHeroMedia {
+    src: string;
+    /** Required. Describes the example being shown, not the product. */
+    alt: string;
+    /**
+     * `auto` keeps the image's own proportions so a product screenshot is never
+     * cropped. The fixed ratios crop to fill, for art-directed imagery.
+     * @default "auto"
+     */
+    aspectRatio?: ProductHeroMediaRatio;
+    width?: number;
+    height?: number;
+    /** Caption rendered under the media. */
+    caption?: ReactNode;
+}
+type ProductHeroState = "default" | "loading" | "error";
+type ProductHeroAlign = "start" | "center";
+interface ProductHeroBlockProps extends Omit<HTMLAttributes<HTMLElement>, "title"> {
+    /** Small label above the headline. Not a heading. */
+    eyebrow?: ReactNode;
+    /** Optional badge rendered beside the eyebrow, e.g. a release tag. */
+    eyebrowBadge?: string;
+    /** The product statement. Required in the default state. */
+    headline: ReactNode;
+    /** Supporting explanation. */
+    description?: ReactNode;
+    /**
+     * Heading element for the headline. Choose h1 for a page hero and h2 when the
+     * page already has an h1. @default "h1"
+     */
+    headingLevel?: ProductHeroHeadingLevel;
+    /** Primary next step. A destination or an action; never both. */
+    primaryCta?: ProductHeroCta;
+    /** Optional alternative step. */
+    secondaryCta?: ProductHeroCta;
+    /** Small print under the actions, e.g. "No credit card required". */
+    note?: ReactNode;
+    /** Scannable proof points rendered as a list. */
+    highlights?: ProductHeroHighlight[];
+    /** A relevant example image. */
+    media?: ProductHeroMedia;
+    /**
+     * Arbitrary example content (a live demo, a video embed). Takes precedence
+     * over `media`.
+     */
+    mediaSlot?: ReactNode;
+    /**
+     * Replaces the media when the image fails or `media.src` is empty. A neutral
+     * labelled placeholder is used when this is omitted.
+     */
+    mediaFallback?: ReactNode;
+    /** Text-only alignment when there is no media. @default "start" */
+    align?: ProductHeroAlign;
+    /** @default "default" */
+    state?: ProductHeroState;
+    /** Announced while `state="loading"`. */
+    loadingLabel?: string;
+    /** Shown while `state="error"`. */
+    errorTitle?: string;
+    errorDescription?: ReactNode;
+    /** Retry control. Omitted entirely when no handler is supplied. */
+    onRetry?: () => void;
+    retryLabel?: string;
+    className?: string;
+}
+/**
+ * Product Hero — explains the product, shows a relevant example, and leads to a
+ * primary next step.
+ *
+ * States: `default`, `loading`, `error`. An "empty" state is not meaningful (a
+ * hero without a headline is not a hero); missing media degrades to a labelled
+ * placeholder instead. No success state is manufactured — the block performs no
+ * submission.
+ */
+declare const ProductHeroBlock: react.ForwardRefExoticComponent<ProductHeroBlockProps & react.RefAttributes<HTMLElement>>;
+
+type ProfileSettingsHeadingLevel = "h1" | "h2" | "h3" | "h4" | "h5" | "h6";
+/**
+ * Lifecycle reported by the consuming application.
+ *
+ * - `idle` — editable, nothing in flight.
+ * - `loading` — the profile is still being read. Fields are not shown yet.
+ * - `saving` — a save is in flight. Every field and both footer actions are
+ *   disabled so a second save cannot start.
+ * - `error` — the save failed. The draft is preserved so nothing is retyped.
+ * - `success` — the app has **confirmed** the save. The block never sets this.
+ */
+type ProfileSettingsStatus = "idle" | "loading" | "saving" | "error" | "success";
+interface ProfileSettingsValues {
+    firstName: string;
+    lastName: string;
+    email: string;
+    jobTitle: string;
+    timeZone: string;
+    bio: string;
+}
+type ProfileSettingsFieldName = keyof ProfileSettingsValues;
+type ProfileSettingsFieldErrors = Partial<Record<ProfileSettingsFieldName, string>>;
+interface ProfileSettingsAvatar {
+    src?: string;
+    /** Fallback when `src` is missing or fails to load. */
+    initials?: string;
+    /** Describes the person, not the act of having a photo. */
+    alt?: string;
+}
+interface ProfileSettingsTimeZoneOption {
+    value: string;
+    label: string;
+}
+interface ProfileSettingsBlockProps {
+    title?: string;
+    description?: string;
+    /** Heading element for {@link title}. @default "h2" */
+    headingLevel?: ProfileSettingsHeadingLevel;
+    /**
+     * The **saved** profile. Unsaved-change tracking compares the working draft
+     * against this value, so the block resets its draft whenever the app reports
+     * new saved values.
+     */
+    value: ProfileSettingsValues;
+    /** Required: the Save control is never rendered without an action. */
+    onSave: (values: ProfileSettingsValues) => void;
+    /** Called after the draft is reset to {@link value}. */
+    onCancel?: () => void;
+    /** Fires whenever the unsaved-change state flips. */
+    onDirtyChange?: (dirty: boolean) => void;
+    /** Lifecycle owned by the consuming app. @default "idle" */
+    status?: ProfileSettingsStatus;
+    errorMessage?: string;
+    successMessage?: string;
+    /** Server-reported errors, shown immediately. */
+    fieldErrors?: ProfileSettingsFieldErrors;
+    /**
+     * Permission-aware editing. When false every field is read-only, the footer
+     * actions are omitted, and {@link readOnlyMessage} explains why.
+     * @default true
+     */
+    canEdit?: boolean;
+    readOnlyMessage?: string;
+    /**
+     * Individual fields the viewer may read but not change, e.g. an email
+     * address owned by a directory. Each one gets a visible explanation.
+     */
+    readOnlyFields?: ProfileSettingsFieldName[];
+    /** Explanations keyed by field, shown under a field in {@link readOnlyFields}. */
+    readOnlyFieldMessages?: Partial<Record<ProfileSettingsFieldName, string>>;
+    avatar?: ProfileSettingsAvatar;
+    /**
+     * Receives the chosen image. The consuming app owns the upload and must
+     * report the result back through {@link avatar} and {@link avatarStatus}.
+     * When omitted, no upload control is rendered.
+     */
+    onAvatarChange?: (file: File) => void;
+    /** When omitted, no remove control is rendered. */
+    onAvatarRemove?: () => void;
+    /** Truthful upload state, owned by the app. @default "idle" */
+    avatarStatus?: "idle" | "uploading" | "error";
+    avatarErrorMessage?: string;
+    /** Replaces the built-in avatar control, e.g. with a `FileUpload`. */
+    avatarSlot?: ReactNode;
+    /** Accepted image types for the built-in control. @default "image/png,image/jpeg,image/webp" */
+    avatarAccept?: string;
+    timeZones?: ProfileSettingsTimeZoneOption[];
+    /** Maximum bio length. A live counter is shown. @default 280 */
+    bioMaxLength?: number;
+    labels?: Partial<Record<ProfileSettingsFieldName, string>>;
+    saveLabel?: string;
+    cancelLabel?: string;
+    className?: string;
+}
+declare const defaultProfileTimeZones: ProfileSettingsTimeZoneOption[];
+declare function ProfileSettingsBlock({ title, description, headingLevel, value, onSave, onCancel, onDirtyChange, status, errorMessage, successMessage, fieldErrors, canEdit, readOnlyMessage, readOnlyFields, readOnlyFieldMessages, avatar, onAvatarChange, onAvatarRemove, avatarStatus, avatarErrorMessage, avatarSlot, avatarAccept, timeZones, bioMaxLength, labels, saveLabel, cancelLabel, className, }: ProfileSettingsBlockProps): react_jsx_runtime.JSX.Element;
+
+interface QuickSendBeneficiary {
+    id: string;
+    name: string;
+    handle: string;
+    avatar?: ReactNode;
+    initials?: string;
+}
+interface QuickSendBlockProps {
+    /** Block title */
+    title?: string;
+    /** "See all" link label */
+    seeAllLabel?: string;
+    /** "See all" click handler */
+    onSeeAll?: () => void;
+    /** Beneficiary list */
+    beneficiaries: QuickSendBeneficiary[];
+    /** Beneficiary click handler */
+    onSelect?: (id: string) => void;
+    /** Additional class names */
+    className?: string;
+}
+declare function QuickSendBlock({ title, seeAllLabel, onSeeAll, beneficiaries, onSelect, className, }: QuickSendBlockProps): react_jsx_runtime.JSX.Element;
+
+type TransactionDirection = "incoming" | "outgoing";
+interface Transaction {
+    id: string;
+    /** "to" or "from" label */
+    direction: TransactionDirection;
+    /** Recipient or sender name */
+    name: string;
+    /** Transaction category */
+    category: string;
+    /** Amount string (e.g., "$11,000.00") */
+    amount: string;
+}
+interface RecentTransactionsBlockProps {
+    /** Block title */
+    title?: string;
+    /** "See all" link label */
+    seeAllLabel?: string;
+    /** "See all" click handler */
+    onSeeAll?: () => void;
+    /** Transaction list */
+    transactions: Transaction[];
+    /** Transaction click handler */
+    onTransactionClick?: (id: string) => void;
+    /** Additional class names */
+    className?: string;
+}
+declare function RecentTransactionsBlock({ title, seeAllLabel, onSeeAll, transactions, onTransactionClick, className, }: RecentTransactionsBlockProps): react_jsx_runtime.JSX.Element;
+
+interface SearchableTableColumn {
+    /** Unique column key — used to look up row values */
+    key: string;
+    /** Column header label */
+    label: string;
+    /** Enable sorting on this column */
+    sortable?: boolean;
+    /** Fixed column width (CSS string, e.g. "300px") */
+    width?: string;
+    /** Custom cell renderer; receives the cell value and full row */
+    render?: (value: unknown, row: Record<string, unknown>) => ReactNode;
+}
+type SearchableTableRow = Record<string, unknown> & {
+    id: string;
+};
+interface SearchableTableBlockProps {
+    /** When set, renders a title + icon toolbar. When absent, renders a search input toolbar. */
+    title?: string;
+    /** Column definitions */
+    columns: SearchableTableColumn[];
+    /** Row data — each must have an `id` field */
+    rows: SearchableTableRow[];
+    /** Search input placeholder */
+    searchPlaceholder?: string;
+    /**
+     * Called when the search value changes. Supplying this puts search under your
+     * control: the block stops filtering `rows` itself and renders exactly what you
+     * pass. Omit it and the block filters `rows` locally.
+     */
+    onSearch?: (query: string) => void;
+    /**
+     * Called when a sortable header is activated. Supplying this puts ordering under
+     * your control: the block only renders the indicator and expects you to reorder
+     * `rows`. Omit it and the block sorts `rows` locally.
+     */
+    onSort?: (key: string, direction: SortDirection) => void;
+    /** Title-variant toolbar: search action. The button renders only when supplied. */
+    onSearchClick?: () => void;
+    /** Title-variant toolbar: sort action. The button renders only when supplied. */
+    onSortClick?: () => void;
+    /**
+     * Hide the filter button. It appears whenever `onFilter` is supplied; setting this
+     * `true` without a handler does not bring it back, because the block does not render a
+     * control that has nowhere to go.
+     */
+    showFilter?: boolean;
+    /** Filter click handler. Required for the filter button to appear. */
+    onFilter?: () => void;
+    /**
+     * Hide the date selector. It appears whenever `onDateSelect` is supplied; setting this
+     * `true` without a handler does not bring it back.
+     */
+    showDateSelector?: boolean;
+    /** Date selector click handler. Required for the date selector to appear. */
+    onDateSelect?: () => void;
+    /** Enable row selection checkboxes */
+    selectable?: boolean;
+    /**
+     * Controlled selection. Supply it to own selection yourself — the only way to keep a
+     * selection across pages, or across a filter you apply outside the block, since the
+     * block otherwise drops ids that leave `rows`. See `useTableSelection`.
+     */
+    selectedIds?: string[];
+    /** Fired on user interaction with the full resulting selection. */
+    onSelectionChange?: (ids: string[]) => void;
+    /** Row kebab menu action handler */
+    onRowAction?: (rowId: string) => void;
+    /** Current page (1-indexed) */
+    page?: number;
+    /** Total pages */
+    totalPages?: number;
+    /** Page change handler */
+    onPageChange?: (page: number) => void;
+    /** Additional class names */
+    className?: string;
+}
+declare function SearchableTableBlock({ title, columns, rows, searchPlaceholder, onSearch, onSort, onSearchClick, onSortClick, showFilter, onFilter, showDateSelector, onDateSelect, selectable, selectedIds, onSelectionChange, onRowAction, page, totalPages, onPageChange, className, }: SearchableTableBlockProps): react_jsx_runtime.JSX.Element;
+
+interface ShoppingCartBlockProps extends CommerceBaseProps, CommerceTotalsProps {
+    items: CommerceCartItem[];
+    /** Stacked keeps the summary below the items, including in a drawer. */
+    layout?: "split" | "stacked";
+    onQuantityChange?: (id: string, quantity: number) => void;
+    onRemoveItem?: (id: string) => void;
+    onCheckout?: () => void;
+    onContinueShopping?: () => void;
+    pending?: boolean;
+    errorMessage?: string;
+    /** Clarifies whether shipping and tax are estimates or final. */
+    totalsNote?: string;
+}
+declare function ShoppingCartBlock({ title, description, items, layout, onQuantityChange, onRemoveItem, onCheckout, onContinueShopping, pending, errorMessage, totalsNote, shipping, tax, discount, currency, locale, ...frame }: ShoppingCartBlockProps): react_jsx_runtime.JSX.Element;
+
+type SiteFooterHeadingLevel = "h2" | "h3" | "h4" | "h5" | "h6";
+interface SiteFooterLink {
+    id: string;
+    label: string;
+    /** Destination. Footer entries are destinations, so they are always links. */
+    href: string;
+    /** Opens in a new tab and adds rel="noreferrer" plus a visually hidden note. */
+    external?: boolean;
+    /** Short qualifier, e.g. "New". */
+    badge?: string;
+    /** Optional analytics hook. Navigation still belongs to the anchor. */
+    onClick?: (event: MouseEvent<HTMLAnchorElement>) => void;
+}
+interface SiteFooterLinkGroup {
+    id: string;
+    /** Group heading, e.g. "Product". */
+    title: string;
+    links: SiteFooterLink[];
+}
+interface SiteFooterSocialLink {
+    id: string;
+    /** Accessible name, e.g. "Citrionus on LinkedIn". */
+    label: string;
+    href: string;
+    /** Library icon. Ignored when `artwork` is supplied. */
+    icon?: IconName;
+    /**
+     * Authentic platform artwork. Brand marks are deliberately exempt from theme
+     * roles, so they are supplied by the consumer rather than recoloured here.
+     */
+    artwork?: ReactNode;
+    /** @default true */
+    external?: boolean;
+}
+interface SiteFooterLocaleOption {
+    value: string;
+    label: string;
+}
+interface SiteFooterLocaleControl {
+    id: string;
+    /** Visible label, e.g. "Language". */
+    label: string;
+    /** Current value. The consuming application owns persistence. */
+    value: string;
+    options: SiteFooterLocaleOption[];
+    /** Required: a control with no configured handler is never rendered. */
+    onChange: (value: string) => void;
+    /** Small print under the control. */
+    hint?: string;
+}
+interface SiteFooterBrand {
+    /** Logo element. Supplied by the consumer so brand artwork stays authentic. */
+    logo?: ReactNode;
+    /** Wordmark text. Rendered when `logo` is absent. */
+    name?: ReactNode;
+    description?: ReactNode;
+    /** Makes the logo/wordmark a link to the site root. */
+    href?: string;
+}
+interface SiteFooterBlockProps extends Omit<HTMLAttributes<HTMLElement>, "title"> {
+    /**
+     * Accessible name for the `contentinfo` landmark. Distinguishes this footer
+     * from any other on the page. @default "Site footer"
+     */
+    label?: string;
+    brand?: SiteFooterBrand;
+    /** Grouped destinations. Each group becomes a named navigation landmark. */
+    groups?: SiteFooterLinkGroup[];
+    /** @default "h2" — used for every group heading. */
+    groupHeadingLevel?: SiteFooterHeadingLevel;
+    social?: SiteFooterSocialLink[];
+    /** Accessible name for the social link list. @default "Social media" */
+    socialLabel?: string;
+    /** Copyright or company registration text. */
+    copyright?: ReactNode;
+    /** Privacy, terms, and similar destinations. */
+    legalLinks?: SiteFooterLink[];
+    /** Accessible name for the legal link list. @default "Legal" */
+    legalLabel?: string;
+    /** Language, region, or currency switchers. */
+    localeControls?: SiteFooterLocaleControl[];
+    /** Extra content above the bottom bar, e.g. a compliance statement. */
+    children?: ReactNode;
+    className?: string;
+}
+/**
+ * Site Footer — browse grouped site links, legal information, social
+ * destinations, and locale controls.
+ *
+ * Only a default state is meaningful: the footer presents destinations the
+ * consuming application already knows. There is nothing to load, submit, or
+ * confirm, so no loading, error, or success state is offered. Every section is
+ * optional; omitting one removes it rather than rendering an empty shell. A
+ * locale control requires an `onChange` handler, so the footer can never render
+ * a switcher that does nothing.
+ */
+declare const SiteFooterBlock: react.ForwardRefExoticComponent<SiteFooterBlockProps & react.RefAttributes<HTMLElement>>;
+
+interface TableBlockRow {
+    id: string;
+    name: string;
+    email: string;
+    initials: string;
+    amount: string;
+    paymentType: string;
+    date: string;
+    time: string;
+    status: string;
+    statusColor?: "success" | "warning" | "error" | "orange" | "blue" | "neutral";
+}
+interface TableBlockProps {
+    /** Table rows */
+    rows: TableBlockRow[];
+    /**
+     * Controlled selection. Supply it to own selection yourself — the only way to keep a
+     * selection across pages, since the block otherwise drops ids that leave `rows`.
+     * See the reconciliation contract on `useTableSelection`.
+     */
+    selectedIds?: string[];
+    /** Fired on user interaction with the full resulting selection. */
+    onSelectionChange?: (ids: string[]) => void;
+    /**
+     * Row action handler (kebab menu). The actions column renders only when supplied —
+     * the block does not show a control that has nowhere to go.
+     */
+    onRowAction?: (rowId: string) => void;
+    /** Current page (1-indexed). Pagination needs `page`, `totalPages` and `onPageChange` together. */
+    page?: number;
+    /** Total pages. Pagination needs `page`, `totalPages` and `onPageChange` together. */
+    totalPages?: number;
+    /** Page change handler. Pagination needs `page`, `totalPages` and `onPageChange` together. */
+    onPageChange?: (page: number) => void;
+    /** Additional class names */
+    className?: string;
+}
+declare function TableBlock({ rows, selectedIds, onSelectionChange, onRowAction, page, totalPages, onPageChange, className, }: TableBlockProps): react_jsx_runtime.JSX.Element;
+
+type TaskListHeadingLevel = "h1" | "h2" | "h3" | "h4" | "h5" | "h6";
+interface TaskListAssignee {
+    id: string;
+    name: string;
+    avatarSrc?: string;
+    initials?: string;
+}
+interface TaskListTask {
+    id: string;
+    title: string;
+    completed: boolean;
+    /** Assignee id. Resolved against {@link TaskListBlockProps.assignees}. */
+    assigneeId?: string;
+    /** Calendar date as `YYYY-MM-DD`. Parsed in local time, never UTC-shifted. */
+    dueDate?: string;
+    /** One line of supporting context shown under the title. */
+    note?: string;
+}
+type TaskListStatusFilter = "all" | "active" | "completed";
+type TaskListStatus = "idle" | "loading" | "error";
+type TaskListAddStatus = "idle" | "submitting" | "error";
+interface TaskListAddInput {
+    title: string;
+    assigneeId?: string;
+    dueDate?: string;
+}
+/** Everything needed to phrase a due date in the consumer's own words. */
+interface TaskListDueContext {
+    /** Whole days from today. Negative means overdue. */
+    daysFromToday: number;
+    date: Date;
+    completed: boolean;
+}
+interface TaskListBlockProps {
+    title?: string;
+    description?: string;
+    /** Heading element for {@link title}. @default "h2" */
+    headingLevel?: TaskListHeadingLevel;
+    /** The complete task set for the current page. */
+    tasks: TaskListTask[];
+    /** Required: a completion control is never rendered without an action. */
+    onToggleComplete: (id: string, completed: boolean) => void;
+    /** When omitted, the add form is not rendered. */
+    onAddTask?: (input: TaskListAddInput) => void;
+    /** When omitted, no delete control is rendered. */
+    onDeleteTask?: (id: string) => void;
+    /** When omitted, the assignee is shown but cannot be changed. */
+    onAssignTask?: (id: string, assigneeId: string) => void;
+    /** People tasks can be assigned to. Also drives the assignee filter. */
+    assignees?: TaskListAssignee[];
+    /** Controlled selection. Selection controls render only with a handler. */
+    selectedIds?: string[];
+    onSelectionChange?: (ids: string[]) => void;
+    /** Bulk controls render only when their handler is supplied. */
+    onBulkComplete?: (ids: string[]) => void;
+    onBulkDelete?: (ids: string[]) => void;
+    /** @default "idle" */
+    status?: TaskListStatus;
+    errorMessage?: string;
+    onRetry?: () => void;
+    /** @default "idle" */
+    addStatus?: TaskListAddStatus;
+    addErrorMessage?: string;
+    /**
+     * Permission-aware editing. When false, completion controls are disabled and
+     * the add, delete, assign and bulk controls are not rendered.
+     * @default true
+     */
+    canEdit?: boolean;
+    readOnlyMessage?: string;
+    /** Reference date for due-date context. Pass it to make output deterministic. */
+    today?: Date;
+    /** BCP-47 tag used to format absolute dates. @default "en-GB" */
+    locale?: string;
+    /** Replaces the built-in due-date phrasing. */
+    formatDueDate?: (isoDate: string, context: TaskListDueContext) => string;
+    /** Shown when there are no tasks at all. */
+    emptyTitle?: string;
+    emptyDescription?: string;
+    /** Shown when tasks exist but none match the current filters. */
+    noMatchesTitle?: string;
+    noMatchesDescription?: string;
+    /** Extra content below the list. */
+    footer?: ReactNode;
+    className?: string;
+}
+declare function TaskListBlock({ title, description, headingLevel, tasks, onToggleComplete, onAddTask, onDeleteTask, onAssignTask, assignees, selectedIds, onSelectionChange, onBulkComplete, onBulkDelete, status, errorMessage, onRetry, addStatus, addErrorMessage, canEdit, readOnlyMessage, today, locale, formatDueDate, emptyTitle, emptyDescription, noMatchesTitle, noMatchesDescription, footer, className, }: TaskListBlockProps): react_jsx_runtime.JSX.Element;
+
+type AppShellHeadingLevel = "h1" | "h2" | "h3" | "h4" | "h5" | "h6";
+/**
+ * How wide the shell's own container must be before the sidebar is shown
+ * beside the workspace instead of inside the collapsed navigation panel.
+ *
+ * The values are container widths, not viewport widths: a shell dropped into
+ * a 400px column collapses there even on a 1440px screen. Tailwind needs the
+ * whole `@min-[…]` class to exist as a literal string, so the tiers are a
+ * fixed set rather than a free number.
+ */
+type AppShellExpandTier = "sm" | "md" | "lg";
+interface AppShellNavItemBase {
+    id: string;
+    label: string;
+    icon?: IconName;
+    /** Short supporting line under the label. Omitted in the compact sidebar. */
+    description?: string;
+    /** Short visible count or tag, e.g. "12". */
+    badge?: string;
+    /** Spoken replacement for {@link badge}, e.g. "12 unread messages". */
+    badgeDescription?: string;
+    /** Marks the destination the workspace is currently showing. */
+    current?: boolean;
+}
+/**
+ * A destination is an anchor, an action is a button, and an item the viewer may
+ * not open is a disabled button with a visible reason. There is no fourth arm,
+ * so a navigation item with nothing to do cannot be expressed.
+ */
+type AppShellNavItem = (AppShellNavItemBase & {
+    href: string;
+    external?: boolean;
+    onClick?: () => void;
+}) | (AppShellNavItemBase & {
+    onClick: () => void;
+    href?: undefined;
+}) | (AppShellNavItemBase & {
+    /** Why this destination is unavailable to the current viewer. */
+    unavailableReason: string;
+    href?: undefined;
+    onClick?: undefined;
+});
+interface AppShellNavSection {
+    id: string;
+    /** Rendered as a heading at {@link ApplicationShellBlockProps.sectionHeadingLevel}. */
+    label?: string;
+    items: AppShellNavItem[];
+}
+interface AppShellActionBase {
+    id: string;
+    label: string;
+    /** With an icon the control is icon-only and named by {@link label}. */
+    icon?: IconName;
+    badge?: string;
+    badgeDescription?: string;
+}
+type AppShellAction = (AppShellActionBase & {
+    href: string;
+    external?: boolean;
+    onClick?: () => void;
+}) | (AppShellActionBase & {
+    onClick: () => void;
+    href?: undefined;
+});
+type AppShellNavStatus = "idle" | "loading" | "error";
+/** Who owns the vertical scrollbar. See {@link ApplicationShellBlockProps.mainScroll}. */
+type AppShellMainScroll = "page" | "region";
+interface ApplicationShellBlockProps {
+    /** Wordmark or logo. Rendered in the sidebar when expanded, in the top bar when collapsed. */
+    brand?: ReactNode;
+    /** Destination behind the brand. Without it the brand is not a control. */
+    brandHref?: string;
+    onBrandClick?: () => void;
+    navSections?: AppShellNavSection[];
+    /** Accessible name for the primary navigation landmark. @default "Main" */
+    navLabel?: string;
+    /** Heading element for section labels. @default "h2" */
+    sectionHeadingLevel?: AppShellHeadingLevel;
+    /** @default "idle" */
+    navStatus?: AppShellNavStatus;
+    navErrorMessage?: string;
+    /** The retry control is omitted entirely when no handler is supplied. */
+    onRetryNav?: () => void;
+    navLoadingMessage?: string;
+    /**
+     * Shown when `navSections` carries no items and the status is idle. It has
+     * no default: without it a shell with no destinations renders no navigation
+     * rail at all, rather than an empty one. Supply it to state why the rail is
+     * empty instead of leaving the reader to guess.
+     */
+    navEmptyMessage?: string;
+    /**
+     * Search field. A single instance lives in the top bar at every width; on a
+     * narrow shell it wraps onto its own row rather than disappearing.
+     */
+    search?: ReactNode;
+    /**
+     * Workspace switcher. A single instance, in the top bar at every width, so it
+     * is never dropped from the collapsed arrangement.
+     */
+    switcher?: ReactNode;
+    /** Trailing top-bar controls, e.g. notifications or help. */
+    actions?: AppShellAction[];
+    /** Accessible name for the trailing control group. @default "Account and tools" */
+    actionsLabel?: string;
+    /**
+     * Content under the navigation. Rendered in both the sidebar and the
+     * collapsed panel, so keep it stateless or controlled by the consumer.
+     */
+    sidebarFooter?: ReactNode;
+    /** Label for the collapsed navigation toggle when closed. @default "Open navigation" */
+    openMenuLabel?: string;
+    /** Label for the collapsed navigation toggle when open. @default "Close navigation" */
+    closeMenuLabel?: string;
+    /** @default "Skip to main content" */
+    skipLinkLabel?: string;
+    /** Accessible name for the landmark holding the skip link. @default "Skip links" */
+    skipNavLabel?: string;
+    /**
+     * Which container width the sidebar appears at. Read from the shell's own
+     * width, never the viewport. @default "md"
+     */
+    expandAt?: AppShellExpandTier;
+    /**
+     * `"page"` (default) lets the document scroll, so the shell has exactly one
+     * scroll region and an overlay above it cannot fight a second one. `"region"`
+     * gives the workspace its own scrollbar and needs a bounded height on the
+     * shell — pass it through `className`, e.g. `h-[100dvh]`.
+     * @default "page"
+     */
+    mainScroll?: AppShellMainScroll;
+    /** Keeps the top bar in view while the workspace scrolls. @default true */
+    stickyTopBar?: boolean;
+    /** Accessible name for the workspace landmark. @default "Workspace" */
+    mainLabel?: string;
+    /** Workspace content. */
+    children?: ReactNode;
+    /** Lands on the container root, outside the top bar and workspace padding. */
+    className?: string;
+}
+declare function ApplicationShellBlock({ brand, brandHref, onBrandClick, navSections, navLabel, sectionHeadingLevel, navStatus, navErrorMessage, onRetryNav, navLoadingMessage, navEmptyMessage, search, switcher, actions, actionsLabel, sidebarFooter, openMenuLabel, closeMenuLabel, skipLinkLabel, skipNavLabel, expandAt, mainScroll, stickyTopBar, mainLabel, children, className, }: ApplicationShellBlockProps): react_jsx_runtime.JSX.Element;
+
+type PageHeaderHeadingLevel = "h1" | "h2" | "h3" | "h4" | "h5" | "h6";
+/**
+ * There is no `info` tone: the library's info ramp has only `info-400`/`info-500`
+ * and no ground or text role that inverts for dark mode, so an info badge could
+ * not be made readable in both modes without inventing a token.
+ */
+type PageHeaderStatusTone = "neutral" | "success" | "warning" | "danger";
+interface PageHeaderStatus {
+    /** Carries the meaning in words; the tone only tints it. */
+    label: string;
+    /** @default "neutral" */
+    tone?: PageHeaderStatusTone;
+    /** One sentence explaining the status, shown beside it. */
+    description?: string;
+}
+interface PageHeaderCrumbBase {
+    id: string;
+    label: string;
+    icon?: IconName;
+}
+/**
+ * A crumb is a destination or an action. The last crumb is the current page and
+ * is rendered as plain text with `aria-current="page"`, so it needs neither.
+ */
+type PageHeaderBreadcrumb = (PageHeaderCrumbBase & {
+    href: string;
+    onClick?: () => void;
+}) | (PageHeaderCrumbBase & {
+    onClick: () => void;
+    href?: undefined;
+}) | (PageHeaderCrumbBase & {
+    href?: undefined;
+    onClick?: undefined;
+});
+type PageHeaderActionPriority = "primary" | "secondary" | "overflow";
+interface PageHeaderActionBase {
+    id: string;
+    label: string;
+    icon?: IconName;
+    /** @default "secondary" */
+    priority?: PageHeaderActionPriority;
+    /** Longer spoken name where the visible label is terse. */
+    description?: string;
+}
+type PageHeaderAction = (PageHeaderActionBase & {
+    href: string;
+    external?: boolean;
+    onClick?: () => void;
+}) | (PageHeaderActionBase & {
+    onClick: () => void;
+    href?: undefined;
+}) | (PageHeaderActionBase & {
+    /** Why the viewer cannot use this action. Rendered next to a disabled control. */
+    unavailableReason: string;
+    href?: undefined;
+    onClick?: undefined;
+});
+interface PageHeaderMetaItem {
+    id: string;
+    label: string;
+    value: ReactNode;
+    icon?: IconName;
+}
+interface PageHeaderBackAction {
+    label: string;
+    href?: string;
+    onClick?: () => void;
+}
+type PageHeaderState = "default" | "loading" | "error";
+interface PageHeaderBlockProps {
+    /** Required: a page header without a title is not a page header. */
+    title: ReactNode;
+    /**
+     * Heading element for {@link title}. A page header usually owns the page's
+     * only `h1`; drop it to `h2` when the shell already provides one.
+     * @default "h1"
+     */
+    headingLevel?: PageHeaderHeadingLevel;
+    /** Small label above the title. Not a heading. */
+    eyebrow?: ReactNode;
+    description?: ReactNode;
+    breadcrumbs?: PageHeaderBreadcrumb[];
+    /** Accessible name for the breadcrumb landmark. @default "Breadcrumb" */
+    breadcrumbLabel?: string;
+    /**
+     * Trail length before the middle collapses behind a disclosure. The first and
+     * the last two crumbs always stay visible. @default 4
+     */
+    maxVisibleBreadcrumbs?: number;
+    /** Spoken label for the expand toggle. Receives the number of hidden levels. */
+    breadcrumbExpandLabel?: (hiddenCount: number) => string;
+    /** Spoken label for the same toggle once the trail is expanded. */
+    breadcrumbCollapseLabel?: (hiddenCount: number) => string;
+    status?: PageHeaderStatus;
+    meta?: PageHeaderMetaItem[];
+    /** Accessible name for the meta list. @default "Page details" */
+    metaLabel?: string;
+    /** Reveal metadata on demand below 640px of container width. @default true */
+    collapseMetaOnSmallScreens?: boolean;
+    /** Surface includes padding and a background; plain fits an existing page gutter. */
+    variant?: "surface" | "plain";
+    backAction?: PageHeaderBackAction;
+    actions?: PageHeaderAction[];
+    /** Accessible name for the action group. @default "Page actions" */
+    actionsLabel?: string;
+    /**
+     * How many actions stay inline before the remaining secondary ones move into
+     * the overflow disclosure. Primary actions are never moved. @default 3
+     */
+    maxInlineActions?: number;
+    /** @default "More actions" */
+    overflowLabel?: string;
+    /** @default "default" */
+    state?: PageHeaderState;
+    errorTitle?: string;
+    errorDescription?: string;
+    /** The retry control is omitted entirely when no handler is supplied. */
+    onRetry?: () => void;
+    loadingMessage?: string;
+    /** Content under the header row, e.g. a tab bar or a filter row. */
+    children?: ReactNode;
+    /** Lands on the container root, outside the padded surface. */
+    className?: string;
+}
+declare function PageHeaderBlock({ title, headingLevel, eyebrow, description, breadcrumbs, breadcrumbLabel, maxVisibleBreadcrumbs, breadcrumbExpandLabel, breadcrumbCollapseLabel, status, meta, metaLabel, collapseMetaOnSmallScreens, variant, backAction, actions, actionsLabel, maxInlineActions, overflowLabel, state, errorTitle, errorDescription, onRetry, loadingMessage, children, className, }: PageHeaderBlockProps): react_jsx_runtime.JSX.Element;
+
+type WorkspaceSwitcherStatus = "idle" | "loading" | "error";
+interface WorkspaceBase {
+    id: string;
+    name: string;
+    /** Plan, role, or member count — one short supporting line. */
+    detail?: string;
+    /** Square logo. Falls back to {@link initials}, then to the first character. */
+    logoSrc?: string;
+    initials?: string;
+    icon?: IconName;
+}
+/**
+ * Switching workspace is normally an application action, so `onSelect` is the
+ * default path. A workspace that is genuinely a separate address may supply an
+ * `href`; it is then rendered as a real anchor, which keeps middle-click and
+ * open-in-new-tab working.
+ */
+type WorkspaceSwitcherItem = (WorkspaceBase & {
+    href?: string;
+    unavailableReason?: undefined;
+}) | (WorkspaceBase & {
+    /** Why the viewer cannot open this workspace. Shown next to the entry. */
+    unavailableReason: string;
+    href?: undefined;
+});
+interface WorkspaceSwitcherFooterAction {
+    id: string;
+    label: string;
+    icon?: IconName;
+    href?: string;
+    onClick?: () => void;
+    external?: boolean;
+}
+interface WorkspaceSwitcherBlockProps {
+    /** The workspace the application is currently showing. */
+    current?: WorkspaceSwitcherItem;
+    /** Everything the viewer may switch to, including {@link current}. */
+    workspaces?: WorkspaceSwitcherItem[];
+    /**
+     * Required whenever a workspace without an `href` can be chosen: a switcher
+     * that cannot switch is an inert control.
+     */
+    onSelect?: (id: string) => void;
+    /** Explanation for entries with neither a destination nor a selection handler. */
+    unavailableMessage?: string;
+    /** @default "idle" */
+    status?: WorkspaceSwitcherStatus;
+    errorMessage?: string;
+    /** The retry control is omitted entirely when no handler is supplied. */
+    onRetry?: () => void;
+    loadingMessage?: string;
+    /** Accessible name for the trigger. @default "Switch workspace" */
+    triggerLabel?: string;
+    /** Small label above the current name on the trigger, e.g. "Workspace". */
+    triggerHint?: string;
+    /** Shown on the trigger when no workspace is selected. @default "Choose a workspace" */
+    placeholder?: string;
+    /** Accessible name for the popover. @default "Workspaces" */
+    panelLabel?: string;
+    /** @default "Filter workspaces" */
+    filterLabel?: string;
+    filterPlaceholder?: string;
+    /**
+     * Below this many workspaces the filter field is not rendered, because a
+     * filter over three entries is noise. @default 6
+     */
+    filterThreshold?: number;
+    /** Shown when the viewer belongs to no workspace at all. */
+    emptyTitle?: string;
+    emptyDescription?: string;
+    /** Shown when the filter matches nothing — a different situation from empty. */
+    noMatchesTitle?: string;
+    noMatchesDescription?: string;
+    /** "Create workspace" / "Join workspace". Rendered only when supplied. */
+    footerActions?: WorkspaceSwitcherFooterAction[];
+    /** Announced result count. Receives the number of matching workspaces. */
+    resultCountLabel?: (count: number) => string;
+    /** Uncontrolled default. @default false */
+    defaultOpen?: boolean;
+    /** Controlled open state. Pair with {@link onOpenChange}. */
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    /** Lands on the container root, outside the popover surface. */
+    className?: string;
+}
+declare function WorkspaceSwitcherBlock({ current, workspaces, onSelect, unavailableMessage, status, errorMessage, onRetry, loadingMessage, triggerLabel, triggerHint, placeholder, panelLabel, filterLabel, filterPlaceholder, filterThreshold, emptyTitle, emptyDescription, noMatchesTitle, noMatchesDescription, footerActions, resultCountLabel, defaultOpen, open: controlledOpen, onOpenChange, className, }: WorkspaceSwitcherBlockProps): react_jsx_runtime.JSX.Element;
+
+type CommandPaletteStatus = "idle" | "loading" | "error";
+interface CommandPaletteItemBase {
+    id: string;
+    label: string;
+    /** One supporting line, e.g. the path a destination leads to. */
+    description?: string;
+    icon?: IconName;
+    /** Extra words the local filter should match, e.g. synonyms or an old name. */
+    keywords?: string[];
+    /** Rendered on the right, e.g. "⌘ N". Presentational only. */
+    shortcut?: string;
+    /** Groups items under a heading. Resolved against {@link CommandPaletteBlockProps.groups}. */
+    groupId?: string;
+}
+/**
+ * A destination is an anchor and keeps its `href` at every width, an action is
+ * an activatable option, and an entry the viewer may not use is disabled with a
+ * visible reason. There is no arm with nothing to do.
+ */
+type CommandPaletteItem = (CommandPaletteItemBase & {
+    href: string;
+    external?: boolean;
+    onSelect?: () => void;
+}) | (CommandPaletteItemBase & {
+    onSelect: () => void;
+    href?: undefined;
+}) | (CommandPaletteItemBase & {
+    /** Why this entry is unavailable to the current viewer. */
+    unavailableReason: string;
+    href?: undefined;
+    onSelect?: undefined;
+});
+interface CommandPaletteGroup {
+    id: string;
+    label: string;
+}
+interface CommandPaletteShortcut {
+    /** Single character, compared case-insensitively. */
+    key: string;
+    /** `"mod"` is Command on Apple platforms and Control elsewhere. @default "mod" */
+    modifier?: "mod" | "none";
+    /** Visible hint on the trigger, e.g. "⌘K". */
+    hint?: string;
+}
+type CommandPaletteFilterMode = "local" | "external";
+interface CommandPaletteBlockProps {
+    /** Everything the palette can offer for the current query. */
+    items?: CommandPaletteItem[];
+    groups?: CommandPaletteGroup[];
+    /** Shown while the query is empty, e.g. recent destinations. */
+    suggestions?: CommandPaletteItem[];
+    /** Heading above {@link suggestions}. @default "Suggestions" */
+    suggestionsLabel?: string;
+    /**
+     * With no suggestions and an empty query the palette prompts for a query
+     * rather than listing everything. Set this to list {@link items} instead.
+     * @default false
+     */
+    showAllWhenEmpty?: boolean;
+    /**
+     * `"local"` filters {@link items} in the browser. `"external"` renders
+     * {@link items} untouched, for an application that searches remotely.
+     * @default "local"
+     */
+    filterMode?: CommandPaletteFilterMode;
+    onQueryChange?: (query: string) => void;
+    /** Fires for every activation, including a destination followed by its href. */
+    onSelect?: (item: CommandPaletteItem) => void;
+    /** @default "idle" */
+    status?: CommandPaletteStatus;
+    errorTitle?: string;
+    errorDescription?: string;
+    /** The retry control is omitted entirely when no handler is supplied. */
+    onRetry?: () => void;
+    loadingMessage?: string;
+    /** Accessible name for the dialog. @default "Command palette" */
+    dialogLabel?: string;
+    /** @default "Search destinations and actions" */
+    searchLabel?: string;
+    searchPlaceholder?: string;
+    /** Hint under the field, associated with it. */
+    searchHint?: string;
+    /** Shown before anything has been typed and nothing else can be offered. */
+    promptTitle?: string;
+    promptDescription?: string;
+    /** Shown when the query matches nothing. Distinct from the prompt. */
+    noResultsTitle?: (query: string) => string;
+    noResultsDescription?: string;
+    /** Shown when the palette has no entries configured at all. */
+    emptySourceTitle?: string;
+    emptySourceDescription?: string;
+    /** Announced and displayed result count. */
+    resultCountLabel?: (count: number) => string;
+    /** Renders the block's own opening control. @default true */
+    showTrigger?: boolean;
+    /** @default "Search" */
+    triggerLabel?: string;
+    /** Extra classes for the built-in trigger. */
+    triggerClassName?: string;
+    /** Keyboard opener. `null` registers no document listener. @default null */
+    shortcut?: CommandPaletteShortcut | null;
+    /** Uncontrolled default. @default false */
+    defaultOpen?: boolean;
+    /** Controlled open state. Pair with {@link onOpenChange}. */
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    /** @default "Close" */
+    closeLabel?: string;
+    /**
+     * Freezes the page behind the overlay so the shell's workspace and the
+     * palette do not both scroll. @default true
+     */
+    lockScroll?: boolean;
+    /** Extra content along the bottom of the dialog, e.g. keyboard legends. */
+    footer?: ReactNode;
+    /** Lands on the container root that holds the trigger. */
+    className?: string;
+}
+declare function CommandPaletteBlock({ items, groups, suggestions, suggestionsLabel, showAllWhenEmpty, filterMode, onQueryChange, onSelect, status, errorTitle, errorDescription, onRetry, loadingMessage, dialogLabel, searchLabel, searchPlaceholder, searchHint, promptTitle, promptDescription, noResultsTitle, noResultsDescription, emptySourceTitle, emptySourceDescription, resultCountLabel, showTrigger, triggerLabel, triggerClassName, shortcut, defaultOpen, open: controlledOpen, onOpenChange, closeLabel, lockScroll, footer, className, }: CommandPaletteBlockProps): react_jsx_runtime.JSX.Element;
+
+export { type AppShellAction, type AppShellExpandTier, type AppShellHeadingLevel, type AppShellMainScroll, type AppShellNavItem, type AppShellNavSection, type AppShellNavStatus, ApplicationShellBlock, type ApplicationShellBlockProps, CheckoutReviewBlock, type CheckoutReviewBlockProps, CommandPaletteBlock, type CommandPaletteBlockProps, type CommandPaletteFilterMode, type CommandPaletteGroup, type CommandPaletteItem, type CommandPaletteShortcut, type CommandPaletteStatus, type CommerceBaseProps, type CommerceCartItem, type CommerceHeadingLevel, type CommerceImage, type CommerceProduct, type CommerceTotalsProps, CreateAccountBlock, type CreateAccountBlockProps, type CreateAccountFieldErrors, type CreateAccountFieldName, type CreateAccountHeadingLevel, type CreateAccountLink, type CreateAccountPasswordRule, type CreateAccountStatus, type CreateAccountValues, EmptyStateBlock, type EmptyStateBlockAction, type EmptyStateBlockProps, type EmptyStateBlockVariant, type FeatureOverviewActionCta, FeatureOverviewBlock, type FeatureOverviewBlockProps, type FeatureOverviewColumns, type FeatureOverviewCta, type FeatureOverviewEmptyState, type FeatureOverviewHeadingLevel, type FeatureOverviewItem, type FeatureOverviewLinkCta, type FeatureOverviewState, type FeatureOverviewVariant, HeaderBlock, type HeaderBlockAction, type HeaderBlockAnnouncement, type HeaderBlockLink, type HeaderBlockProps, type HeaderBlockSwitcher, type HeaderBlockVariant, type KpiChange, type KpiChangeDirection, type KpiChangeSentiment, type KpiMetric, KpiOverviewBlock, type KpiOverviewBlockProps, type KpiOverviewHeadingLevel, type KpiOverviewStatus, type KpiPeriod, type KpiPeriodOption, type KpiTrend, LoginBlock, type LoginBlockProps, type LoginBlockSocialProvider, type LoginBlockVariant, type NotificationItem, NotificationsBlock, type NotificationsBlockProps, type PageHeaderAction, type PageHeaderActionPriority, type PageHeaderBackAction, PageHeaderBlock, type PageHeaderBlockProps, type PageHeaderBreadcrumb, type PageHeaderHeadingLevel, type PageHeaderMetaItem, type PageHeaderState, type PageHeaderStatus, type PageHeaderStatusTone, type PricingActionCta, type PricingBillingPeriod, type PricingCta, type PricingFeature, type PricingLimit, type PricingLinkCta, type PricingPlan, type PricingPlanAvailability, PricingPlansBlock, type PricingPlansBlockProps, type PricingPlansHeadingLevel, type PricingPlansNotice, type PricingPlansState, type PricingPrice, ProductCollectionBlock, type ProductCollectionBlockProps, ProductDetailBlock, type ProductDetailBlockProps, type ProductDetailOption, type ProductDetailSelection, type ProductHeroActionCta, type ProductHeroAlign, ProductHeroBlock, type ProductHeroBlockProps, type ProductHeroCta, type ProductHeroHeadingLevel, type ProductHeroHighlight, type ProductHeroLinkCta, type ProductHeroMedia, type ProductHeroMediaRatio, type ProductHeroState, type ProfileSettingsAvatar, ProfileSettingsBlock, type ProfileSettingsBlockProps, type ProfileSettingsFieldErrors, type ProfileSettingsFieldName, type ProfileSettingsHeadingLevel, type ProfileSettingsStatus, type ProfileSettingsTimeZoneOption, type ProfileSettingsValues, type QuickSendBeneficiary, QuickSendBlock, type QuickSendBlockProps, RecentTransactionsBlock, type RecentTransactionsBlockProps, SearchableTableBlock, type SearchableTableBlockProps, type SearchableTableColumn, type SearchableTableRow, ShoppingCartBlock, type ShoppingCartBlockProps, SiteFooterBlock, type SiteFooterBlockProps, type SiteFooterBrand, type SiteFooterHeadingLevel, type SiteFooterLink, type SiteFooterLinkGroup, type SiteFooterLocaleControl, type SiteFooterLocaleOption, type SiteFooterSocialLink, TableBlock, type TableBlockProps, type TableBlockRow, type TaskListAddInput, type TaskListAddStatus, type TaskListAssignee, TaskListBlock, type TaskListBlockProps, type TaskListDueContext, type TaskListHeadingLevel, type TaskListStatus, type TaskListStatusFilter, type TaskListTask, type Transaction, type TransactionDirection, WorkspaceSwitcherBlock, type WorkspaceSwitcherBlockProps, type WorkspaceSwitcherFooterAction, type WorkspaceSwitcherItem, type WorkspaceSwitcherStatus, defaultCreateAccountPasswordRules, defaultProfileTimeZones };