@northslopetech/altitude-ui 2.6.4 → 2.8.0

package/dist/index.d.mts

@@ -1,6 +1,7 @@
 import * as class_variance_authority_types from 'class-variance-authority/types';
 import * as React$1 from 'react';
 import { ReactNode } from 'react';
+import { Button as Button$1 } from '@base-ui/react/button';
 import { VariantProps } from 'class-variance-authority';
 import * as SelectPrimitive from '@radix-ui/react-select';
 import * as react_jsx_runtime from 'react/jsx-runtime';
@@ -11,27 +12,22 @@ import * as CheckboxPrimitive from '@radix-ui/react-checkbox';
 import * as DropdownMenuPrimitive from '@radix-ui/react-dropdown-menu';
 import { Table as Table$1 } from '@tanstack/react-table';
 
-/**
- * Button variant styles.
- */
 declare const buttonVariants: (props?: ({
     variant?: "default" | "outline" | "destructive" | "destructive-subtle" | "ghost" | "link" | null | undefined;
     size?: "default" | "sm" | "lg" | "icon" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
-interface ButtonProps extends React$1.ButtonHTMLAttributes<HTMLButtonElement>, VariantProps<typeof buttonVariants> {
-    asChild?: boolean;
+interface ButtonProps extends Button$1.Props, VariantProps<typeof buttonVariants> {
     icon?: React$1.ReactNode;
     iconPosition?: "left" | "right";
 }
 /**
  * Button component with multiple variants and sizes.
- * @param {boolean} [props.asChild] - Render as child element (using Radix Slot)
  * @param {React.ReactNode} [props.icon] - Icon element to display
  * @param {"left" | "right"} [props.iconPosition] - Position of icon relative to text
  * @param {string} [props.variant] - Visual style variant
  * @param {string} [props.size] - Button size
  */
-declare const Button: React$1.ForwardRefExoticComponent<ButtonProps & React$1.RefAttributes<HTMLButtonElement>>;
+declare const Button: React$1.ForwardRefExoticComponent<Omit<ButtonProps, "ref"> & React$1.RefAttributes<HTMLButtonElement>>;
 
 /**
  * Typography variant styles using design system tokens.
@@ -346,10 +342,38 @@ declare const Badge: React$1.ForwardRefExoticComponent<BadgeProps & React$1.RefA
  * PDF file input type - can be a URL string or File object.
  */
 type PdfFile = string | File;
+/**
+ * Dimensions of a single PDF page at scale 1.0.
+ */
+type PdfPageDimensions = {
+    /** Page number (1-indexed) */
+    pageNumber: number;
+    /** Width in PDF units at scale 1.0 */
+    width: number;
+    /** Height in PDF units at scale 1.0 */
+    height: number;
+};
+/**
+ * Map of page numbers to their dimensions.
+ * Key is 1-indexed page number.
+ */
+type PdfPageDimensionsMap = Map<number, PdfPageDimensions>;
+/**
+ * Scroll behavior when navigating to a page.
+ * - 'smooth': Animate scrolling to the target page
+ * - 'instant': Jump immediately to the target page
+ */
+type ScrollBehavior = "smooth" | "instant";
+/**
+ * View mode for PDF display.
+ * - 'continuous': All pages rendered in a scrollable container with virtualization
+ * - 'single': One page at a time with navigation controls
+ */
+type PdfViewMode = "continuous" | "single";
 /**
  * Props for PDF viewer components.
  */
-interface PdfViewerProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onError"> {
+type PdfViewerProps = Omit<React.HTMLAttributes<HTMLDivElement>, "onError"> & {
     /**
      * The PDF file to display. Can be a URL string or a File object.
      */
@@ -382,7 +406,52 @@ interface PdfViewerProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onE
      * Enable text layer for text selection. Defaults to false for performance.
      */
     enableTextLayer?: boolean;
-}
+    /**
+     * Whether to show the built-in controls bar (navigation buttons, page indicator).
+     */
+    showControls?: boolean;
+    /**
+     * Number of pages to render above and below the viewport for virtualization.
+     * Higher values reduce blank pages during fast scrolling but use more memory.
+     */
+    viewportBuffer?: number;
+    /**
+     * Current page number (1-indexed). Use for controlled mode.
+     * When set, the component expects the parent to manage page state via onPageChange.
+     */
+    page?: number;
+    /**
+     * Callback fired when the current page changes.
+     * Fires when a new page scrolls into the primary viewport or on navigation.
+     */
+    onPageChange?: (page: number) => void;
+    /**
+     * Scroll behavior when navigating to a page via controls or programmatic navigation.
+     */
+    scrollBehavior?: ScrollBehavior;
+    /**
+     * View mode for displaying the PDF.
+     * - 'continuous': Scrollable view with all pages (virtualized)
+     * - 'single': One page at a time with navigation
+     */
+    viewMode?: PdfViewMode;
+    /**
+     * Callback fired when page dimensions have been fetched.
+     * Useful for bounding box implementations that need accurate page coordinates.
+     *
+     * @example
+     * ```tsx
+     * <PdfViewer
+     *   file={pdfFile}
+     *   onDimensionsReady={(dimensions) => {
+     *     const page1 = dimensions.get(1);
+     *     console.log(`Page 1: ${page1.width}x${page1.height}`);
+     *   }}
+     * />
+     * ```
+     */
+    onDimensionsReady?: (dimensions: PdfPageDimensionsMap) => void;
+};
 
 /**
  * @fileoverview PDF.js worker configuration.
@@ -413,18 +482,26 @@ interface PdfViewerProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onE
  */
 declare function initializePdfWorker(workerUrl: string): void;
 
-/**
- * @fileoverview PDF viewer component for Altitude UI.
- */
-
 /**
  * PDF document viewer component with multi-page support.
  *
+ * Supports both controlled and uncontrolled modes for page state:
+ * - Uncontrolled (default): Component manages page state internally
+ * - Controlled: Parent manages page state via `page` and `onPageChange` props
+ *
  * @example
  * ```tsx
- * // Simple usage
+ * // Simple usage (uncontrolled)
  * <PdfViewer file="/document.pdf" />
  *
+ * // Controlled mode
+ * const [page, setPage] = useState(1);
+ * <PdfViewer
+ *   file="/document.pdf"
+ *   page={page}
+ *   onPageChange={setPage}
+ * />
+ *
  * // With title and callbacks
  * <PdfViewer
  *   file={pdfFile}
@@ -443,7 +520,23 @@ declare function initializePdfWorker(workerUrl: string): void;
  * />
  * ```
  */
-declare const PdfViewer: React$1.ForwardRefExoticComponent<PdfViewerProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const PdfViewer: React$1.ForwardRefExoticComponent<Omit<React$1.HTMLAttributes<HTMLDivElement>, "onError"> & {
+    file?: PdfFile;
+    title?: string;
+    pageWidth?: number;
+    onDownload?: () => void;
+    onPrint?: () => void;
+    onLoadSuccess?: (numPages: number) => void;
+    onError?: (error: Error) => void;
+    enableTextLayer?: boolean;
+    showControls?: boolean;
+    viewportBuffer?: number;
+    page?: number;
+    onPageChange?: (page: number) => void;
+    scrollBehavior?: ScrollBehavior;
+    viewMode?: PdfViewMode;
+    onDimensionsReady?: (dimensions: PdfPageDimensionsMap) => void;
+} & React$1.RefAttributes<HTMLDivElement>>;
 
 /**
  * Tabs trigger variant styles.
@@ -524,91 +617,82 @@ interface IconProps extends React$1.SVGProps<SVGSVGElement> {
     variant?: IconVariant;
 }
 /**
- * X (close) icon component.
- */
-declare const X: React$1.FC<IconProps>;
-/**
- * Lock icon component.
- */
-declare const Lock: React$1.FC<IconProps>;
-/**
- * Check icon component (circle with checkmark).
- */
-declare const Check: React$1.FC<IconProps>;
-/**
- * ChevronDown icon component (downward pointing chevron).
+ * LockIcon component.
  */
-declare const ChevronDown: React$1.FC<IconProps>;
+declare const LockIcon: React$1.FC<IconProps>;
 /**
- * ChevronUp icon component (upward pointing chevron).
+ * CheckIcon component (circle with checkmark).
  */
-declare const ChevronUp: React$1.FC<IconProps>;
-declare const Calendar: React$1.FC<IconProps>;
-declare const ChevronLeft: React$1.FC<IconProps>;
-declare const ChevronRight: React$1.FC<IconProps>;
 declare const CheckIcon: React$1.FC<IconProps>;
-declare const ArrowDown: React$1.FC<IconProps>;
-declare const ArrowUp: React$1.FC<IconProps>;
-declare const ArrowLeft: React$1.FC<IconProps>;
-declare const ArrowRight: React$1.FC<IconProps>;
-declare const Bell: React$1.FC<IconProps>;
-declare const Bookmark: React$1.FC<IconProps>;
-declare const CaretDown: React$1.FC<IconProps>;
-declare const CaretLeft: React$1.FC<IconProps>;
-declare const CaretRight: React$1.FC<IconProps>;
-declare const CaretUp: React$1.FC<IconProps>;
-declare const Chat: React$1.FC<IconProps>;
-declare const CheckmarkCircle: React$1.FC<IconProps>;
-declare const CheckmarkSquare: React$1.FC<IconProps>;
-declare const Close: React$1.FC<IconProps>;
-declare const CloseSmall: React$1.FC<IconProps>;
-declare const Cog: React$1.FC<IconProps>;
-declare const Credentials: React$1.FC<IconProps>;
-declare const Doc: React$1.FC<IconProps>;
-declare const Dollar: React$1.FC<IconProps>;
-declare const Edit: React$1.FC<IconProps>;
-declare const Envelope: React$1.FC<IconProps>;
-declare const Exclamation: React$1.FC<IconProps>;
-declare const EyeClosed: React$1.FC<IconProps>;
-declare const EyeOpen: React$1.FC<IconProps>;
-declare const Filter: React$1.FC<IconProps>;
-declare const FilterDescending: React$1.FC<IconProps>;
-declare const GraphBar: React$1.FC<IconProps>;
-declare const GraphDonut: React$1.FC<IconProps>;
-declare const GraphLine: React$1.FC<IconProps>;
-declare const GraphPie: React$1.FC<IconProps>;
-declare const HamburgerMenu: React$1.FC<IconProps>;
-declare const Home: React$1.FC<IconProps>;
-declare const Information: React$1.FC<IconProps>;
-declare const Location: React$1.FC<IconProps>;
-declare const MagnifyingGlass: React$1.FC<IconProps>;
-declare const Minus: React$1.FC<IconProps>;
-declare const Plus: React$1.FC<IconProps>;
-declare const MoreMenu: React$1.FC<IconProps>;
-declare const Phone: React$1.FC<IconProps>;
-declare const QuestionCircle: React$1.FC<IconProps>;
-declare const Share: React$1.FC<IconProps>;
-declare const Star: React$1.FC<IconProps>;
-declare const Statement: React$1.FC<IconProps>;
+declare const CalendarIcon: React$1.FC<IconProps>;
+/**
+ * CheckmarkIcon (just the checkmark) component.
+ */
+declare const CheckmarkIcon: React$1.FC<IconProps>;
+/**
+ * ArrowDownIcon component.
+ */
+declare const ArrowDownIcon: React$1.FC<IconProps>;
+declare const ArrowUpIcon: React$1.FC<IconProps>;
+declare const ArrowLeftIcon: React$1.FC<IconProps>;
+declare const ArrowRightIcon: React$1.FC<IconProps>;
+declare const BellIcon: React$1.FC<IconProps>;
+declare const BookmarkIcon: React$1.FC<IconProps>;
+declare const CaretDownIcon: React$1.FC<IconProps>;
+declare const CaretLeftIcon: React$1.FC<IconProps>;
+declare const CaretRightIcon: React$1.FC<IconProps>;
+declare const CaretUpIcon: React$1.FC<IconProps>;
+declare const ChatIcon: React$1.FC<IconProps>;
+declare const CheckmarkSquareIcon: React$1.FC<IconProps>;
+declare const CloseIcon: React$1.FC<IconProps>;
+declare const CloseSmallIcon: React$1.FC<IconProps>;
+declare const CogIcon: React$1.FC<IconProps>;
+declare const CredentialsIcon: React$1.FC<IconProps>;
+declare const DocumentIcon: React$1.FC<IconProps>;
+declare const DollarIcon: React$1.FC<IconProps>;
+declare const EditIcon: React$1.FC<IconProps>;
+declare const EnvelopeIcon: React$1.FC<IconProps>;
+declare const ExclamationIcon: React$1.FC<IconProps>;
+declare const EyeClosedIcon: React$1.FC<IconProps>;
+declare const EyeOpenIcon: React$1.FC<IconProps>;
+declare const FilterIcon: React$1.FC<IconProps>;
+declare const FilterDescendingIcon: React$1.FC<IconProps>;
+declare const GraphBarIcon: React$1.FC<IconProps>;
+declare const GraphDonutIcon: React$1.FC<IconProps>;
+declare const GraphLineIcon: React$1.FC<IconProps>;
+declare const GraphPieIcon: React$1.FC<IconProps>;
+declare const HamburgerMenuIcon: React$1.FC<IconProps>;
+declare const HomeIcon: React$1.FC<IconProps>;
+declare const InformationIcon: React$1.FC<IconProps>;
+declare const LocationIcon: React$1.FC<IconProps>;
+declare const MagnifyingGlassIcon: React$1.FC<IconProps>;
+declare const MinusIcon: React$1.FC<IconProps>;
+declare const PlusIcon: React$1.FC<IconProps>;
+declare const MoreMenuIcon: React$1.FC<IconProps>;
+declare const PhoneIcon: React$1.FC<IconProps>;
+declare const QuestionCircleIcon: React$1.FC<IconProps>;
+declare const ShareIcon: React$1.FC<IconProps>;
+declare const StarIcon: React$1.FC<IconProps>;
+declare const StatementIcon: React$1.FC<IconProps>;
 declare const TableIcon: React$1.FC<IconProps>;
-declare const Trash: React$1.FC<IconProps>;
-declare const User: React$1.FC<IconProps>;
-declare const UserMulti: React$1.FC<IconProps>;
-declare const Warning: React$1.FC<IconProps>;
-declare const Wrench: React$1.FC<IconProps>;
-declare const Logout: React$1.FC<IconProps>;
+declare const TrashIcon: React$1.FC<IconProps>;
+declare const UserIcon: React$1.FC<IconProps>;
+declare const UserMultiIcon: React$1.FC<IconProps>;
+declare const WarningIcon: React$1.FC<IconProps>;
+declare const WrenchIcon: React$1.FC<IconProps>;
+declare const LogoutIcon: React$1.FC<IconProps>;
 /**
  * Print icon component.
  */
-declare const Print: React$1.FC<IconProps>;
+declare const PrintIcon: React$1.FC<IconProps>;
 /**
  * Download icon component.
  */
-declare const Download: React$1.FC<IconProps>;
+declare const DownloadIcon: React$1.FC<IconProps>;
 /**
  * Panel icon component.
  */
-declare const Panel: React$1.FC<IconProps>;
+declare const PanelIcon: React$1.FC<IconProps>;
 
 /**
  * @fileoverview Chart utilities for Altitude UI chart components.
@@ -1119,4 +1203,4 @@ interface TableProps<T> {
  */
 declare function Table<T>({ table, className, showPagination, paginationClassName, }: TableProps<T>): react_jsx_runtime.JSX.Element;
 
-export { ArrowDown, ArrowLeft, ArrowRight, ArrowUp, Badge, type BadgeProps, BarChart, type BarChartData, type BarChartProps, Bell, Bookmark, Button, type ButtonProps, CHART_COLORS, CHART_CONSTANTS, COLOR_SCHEMES, Calendar, CaretDown, CaretLeft, CaretRight, CaretUp, type ChartColorScheme, ChartLegend, type ChartLegendProps, Chat, Check, CheckIcon, Checkbox, type CheckboxProps, CheckmarkCircle, CheckmarkSquare, ChevronDown, ChevronLeft, ChevronRight, ChevronUp, Close, CloseSmall, Cog, Credentials, DatePicker, type DatePickerProps, Doc, Dollar, Download, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, type DropdownMenuTriggerProps, Edit, Envelope, Exclamation, EyeClosed, EyeOpen, Field, FieldContent, FieldDescription, FieldError, FieldGroup, FieldLabel, FieldLegend, FieldSeparator, FieldSet, FieldTitle, Filter, FilterDescending, GenericTooltip, type GenericTooltipProps, GraphBar, GraphDonut, GraphLine, GraphPie, HamburgerMenu, Home, type IconProps, type IconVariant, Information, Input, type InputProps, Label, type LabelProps, type LegendItem, LineChart, type LineChartData, type LineChartProps, type LineSeries, Location, Lock, Logout, MagnifyingGlass, Minus, MoreMenu, Panel, type PdfFile, PdfViewer, type PdfViewerProps, Phone, PieChart, type PieChartData, type PieChartProps, type PieLabelProps, Plus, Print, QuestionCircle, Select, SelectContent, type SelectContentProps, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, type SelectTriggerProps, SelectValue, Separator, Share, Sidebar, SidebarContent, type SidebarContentProps, SidebarFooter, type SidebarFooterProps, SidebarGroup, SidebarGroupContent, type SidebarGroupContentProps, type SidebarGroupProps, SidebarHeader, type SidebarHeaderProps, SidebarInset, type SidebarInsetProps, SidebarMenu, SidebarMenuButton, type SidebarMenuButtonProps, SidebarMenuItem, type SidebarMenuItemProps, type SidebarMenuProps, type SidebarProps, SidebarProvider, type SidebarProviderProps, Star, Statement, Table, TableIcon, type TableProps, Tabs, TabsContent, type TabsContentProps, TabsList, type TabsListProps, type TabsProps, TabsTrigger, type TabsTriggerProps, Textarea, type TextareaProps, type TickProps, Tooltip, TooltipContainer, type TooltipContainerProps, TooltipContent, type TooltipContentProps, TooltipItem, type TooltipItemProps, type TooltipProps, TooltipProvider, type TooltipProviderProps, TooltipTrigger, type TooltipTriggerProps, Trash, Typography, type TypographyProps, Upload, type UploadProps, User, UserMulti, Warning, Wrench, X, badgeVariants, buttonVariants, calculateYAxisWidth, checkboxVariants, createCustomXAxisLabel, createCustomYAxisLabel, createCustomYAxisRightLabel, createLegendItems, customXAxisTick, customXAxisTickRotated, customYAxisTick, formatLargeNumber, formatPercentage, getHeatmapColor, getPerformanceColor, getSeriesColor, initializePdfWorker, selectTriggerVariants, tabsVariants, typographyVariants, uploadVariants, useSidebar };
+export { ArrowDownIcon, ArrowLeftIcon, ArrowRightIcon, ArrowUpIcon, Badge, type BadgeProps, BarChart, type BarChartData, type BarChartProps, BellIcon, BookmarkIcon, Button, type ButtonProps, CHART_COLORS, CHART_CONSTANTS, COLOR_SCHEMES, CalendarIcon, CaretDownIcon, CaretLeftIcon, CaretRightIcon, CaretUpIcon, type ChartColorScheme, ChartLegend, type ChartLegendProps, ChatIcon, CheckIcon, Checkbox, type CheckboxProps, CheckmarkIcon, CheckmarkSquareIcon, CloseIcon, CloseSmallIcon, CogIcon, CredentialsIcon, DatePicker, type DatePickerProps, DocumentIcon, DollarIcon, DownloadIcon, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, type DropdownMenuTriggerProps, EditIcon, EnvelopeIcon, ExclamationIcon, EyeClosedIcon, EyeOpenIcon, Field, FieldContent, FieldDescription, FieldError, FieldGroup, FieldLabel, FieldLegend, FieldSeparator, FieldSet, FieldTitle, FilterDescendingIcon, FilterIcon, GenericTooltip, type GenericTooltipProps, GraphBarIcon, GraphDonutIcon, GraphLineIcon, GraphPieIcon, HamburgerMenuIcon, HomeIcon, type IconProps, type IconVariant, InformationIcon, Input, type InputProps, Label, type LabelProps, type LegendItem, LineChart, type LineChartData, type LineChartProps, type LineSeries, LocationIcon, LockIcon, LogoutIcon, MagnifyingGlassIcon, MinusIcon, MoreMenuIcon, PanelIcon, type PdfFile, PdfViewer, type PdfViewerProps, PhoneIcon, PieChart, type PieChartData, type PieChartProps, type PieLabelProps, PlusIcon, PrintIcon, QuestionCircleIcon, Select, SelectContent, type SelectContentProps, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, type SelectTriggerProps, SelectValue, Separator, ShareIcon, Sidebar, SidebarContent, type SidebarContentProps, SidebarFooter, type SidebarFooterProps, SidebarGroup, SidebarGroupContent, type SidebarGroupContentProps, type SidebarGroupProps, SidebarHeader, type SidebarHeaderProps, SidebarInset, type SidebarInsetProps, SidebarMenu, SidebarMenuButton, type SidebarMenuButtonProps, SidebarMenuItem, type SidebarMenuItemProps, type SidebarMenuProps, type SidebarProps, SidebarProvider, type SidebarProviderProps, StarIcon, StatementIcon, Table, TableIcon, type TableProps, Tabs, TabsContent, type TabsContentProps, TabsList, type TabsListProps, type TabsProps, TabsTrigger, type TabsTriggerProps, Textarea, type TextareaProps, type TickProps, Tooltip, TooltipContainer, type TooltipContainerProps, TooltipContent, type TooltipContentProps, TooltipItem, type TooltipItemProps, type TooltipProps, TooltipProvider, type TooltipProviderProps, TooltipTrigger, type TooltipTriggerProps, TrashIcon, Typography, type TypographyProps, Upload, type UploadProps, UserIcon, UserMultiIcon, WarningIcon, WrenchIcon, badgeVariants, buttonVariants, calculateYAxisWidth, checkboxVariants, createCustomXAxisLabel, createCustomYAxisLabel, createCustomYAxisRightLabel, createLegendItems, customXAxisTick, customXAxisTickRotated, customYAxisTick, formatLargeNumber, formatPercentage, getHeatmapColor, getPerformanceColor, getSeriesColor, initializePdfWorker, selectTriggerVariants, tabsVariants, typographyVariants, uploadVariants, useSidebar };