import * as React from 'react';
import * as ScrollAreaPrimitive from '@radix-ui/react-scroll-area';
/**
 * ScrollArea — 自訂樣式的捲動區(Radix ScrollArea primitive 包裝)
 *
 * 世界級對照:shadcn `ScrollArea` / Ant Design scrollable 容器的 pattern。
 *
 * ── 為什麼需要 ScrollArea ──
 * Native scrollbar 跨 OS 不一致:
 *   macOS: overlay(不吃寬度,預設隱藏,滾動時浮出)
 *   Windows / Linux: always-visible(永遠吃 ~15-17px 寬度)
 *
 * 結果:同一個 DataTable / Sheet / Dialog 內容在 macOS 看起來對齊,在 Windows
 * 右側被吃 17px 跑版(「Left pinned + Row Actions」那張圖的問題)。
 *
 * ScrollArea 用 Radix 包裝自建 overlay 捲軸 → **跨 OS 一致不吃寬度**,
 * 捲動時浮現(hover / scroll 自動顯示)。
 *
 * ── 何時用 ──
 * - DataTable 橫向捲動(水平跑版最明顯場景)
 * - Sheet / Dialog 垂直內容捲動(body 太長)
 * - Sidebar nav 長列表
 * - 任何「內容可能溢出容器」且「跨 OS 視覺必須一致」的場景
 *
 * ── 何時不用 ──
 * - 全頁捲動(瀏覽器 document scroll,保持 native 即可;ScrollArea 是 sub-region)
 * - 單行 truncate(用 text-overflow:ellipsis 就夠)
 * - 極短內容(不會捲動 → 不需 wrapper)
 */
declare const ScrollArea: React.ForwardRefExoticComponent<Omit<ScrollAreaPrimitive.ScrollAreaProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
declare const ScrollBar: React.ForwardRefExoticComponent<Omit<ScrollAreaPrimitive.ScrollAreaScrollbarProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
export declare const scrollAreaMeta: {
    readonly component: "ScrollArea";
    readonly family: null;
    readonly variants: {};
    readonly sizes: {};
    readonly states: readonly ["default"];
    readonly tokens: {
        readonly bg: readonly [];
        readonly fg: readonly [];
        readonly ring: readonly [];
    };
};
export { ScrollArea, ScrollBar };
//# sourceMappingURL=scroll-area.d.ts.map