@northslopetech/altitude-ui 2.3.0 → 2.4.0

package/dist/index.d.mts

@@ -225,6 +225,112 @@ interface BadgeProps extends React$1.HTMLAttributes<HTMLSpanElement>, VariantPro
  */
 declare const Badge: React$1.ForwardRefExoticComponent<BadgeProps & React$1.RefAttributes<HTMLSpanElement>>;
 
+/**
+ * @fileoverview Shared TypeScript types for PDF viewer components.
+ */
+/**
+ * PDF file input type - can be a URL string or File object.
+ */
+type PdfFile = string | File;
+/**
+ * Props for PDF viewer components.
+ */
+interface PdfViewerProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onError"> {
+    /**
+     * The PDF file to display. Can be a URL string or a File object.
+     */
+    file?: PdfFile;
+    /**
+     * Document title to display in the header.
+     */
+    title?: string;
+    /**
+     * Optional custom page width in pixels. If not provided, pages will auto-fit to container width.
+     */
+    pageWidth?: number;
+    /**
+     * Callback when download button is clicked.
+     */
+    onDownload?: () => void;
+    /**
+     * Callback when print button is clicked.
+     */
+    onPrint?: () => void;
+    /**
+     * Callback when the PDF document loads successfully.
+     */
+    onLoadSuccess?: (numPages: number) => void;
+    /**
+     * Callback when there's an error loading or rendering the PDF.
+     */
+    onError?: (error: Error) => void;
+    /**
+     * Enable text layer for text selection. Defaults to false for performance.
+     */
+    enableTextLayer?: boolean;
+}
+
+/**
+ * @fileoverview PDF.js worker configuration.
+ */
+/**
+ * Initialize PDF.js worker with a custom URL.
+ *
+ * The worker file is bundled with @northslopetech/altitude-ui at:
+ * @northslopetech/altitude-ui/pdf.worker.min.mjs
+ *
+ * **IMPORTANT**: You must call this function once at application startup before
+ * using the PdfViewer component.
+ *
+ * @param workerUrl - The URL where the PDF.js worker can be accessed
+ *
+ * @example
+ * ```tsx
+ * // For Vite/Webpack - import directly from the package (recommended):
+ * import workerUrl from '@northslopetech/altitude-ui/pdf.worker.min.mjs?url';
+ * import { initializePdfWorker } from '@northslopetech/altitude-ui';
+ *
+ * // Call once at app startup (e.g., in main.tsx, _app.tsx, or layout.tsx)
+ * initializePdfWorker(workerUrl);
+ *
+ * // Or if you've copied the worker to your public folder:
+ * initializePdfWorker('/pdf.worker.min.mjs');
+ * ```
+ */
+declare function initializePdfWorker(workerUrl: string): void;
+
+/**
+ * @fileoverview PDF viewer component for Altitude UI.
+ */
+
+/**
+ * PDF document viewer component with multi-page support.
+ *
+ * @example
+ * ```tsx
+ * // Simple usage
+ * <PdfViewer file="/document.pdf" />
+ *
+ * // With title and callbacks
+ * <PdfViewer
+ *   file={pdfFile}
+ *   title="Invoice_2024.pdf"
+ *   onDownload={() => console.log('Download clicked')}
+ *   onPrint={() => console.log('Print clicked')}
+ *   onLoadSuccess={(pages) => console.log(`Loaded ${pages} pages`)}
+ *   onError={(error) => console.error(error)}
+ * />
+ *
+ * // With custom width and text layer
+ * <PdfViewer
+ *   file="/document.pdf"
+ *   pageWidth={800}
+ *   enableTextLayer
+ * />
+ * ```
+ */
+declare const PdfViewer: React$1.ForwardRefExoticComponent<PdfViewerProps & React$1.RefAttributes<HTMLDivElement>>;
+
 /**
  * Tabs trigger variant styles.
  */
@@ -377,6 +483,14 @@ 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>;
+/**
+ * Print icon component.
+ */
+declare const Print: React$1.FC<IconProps>;
+/**
+ * Download icon component.
+ */
+declare const Download: React$1.FC<IconProps>;
 
 /**
  * @fileoverview Chart utilities for Altitude UI chart components.
@@ -887,4 +1001,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, 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, Phone, PieChart, type PieChartData, type PieChartProps, type PieLabelProps, Plus, QuestionCircle, Select, SelectContent, type SelectContentProps, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, type SelectTriggerProps, SelectValue, Separator, Share, Star, Statement, Table, TableIcon, type TableProps, Tabs, TabsContent, type TabsContentProps, TabsList, type TabsListProps, type TabsProps, TabsTrigger, type TabsTriggerProps, Textarea, type TextareaProps, type TickProps, TooltipContainer, type TooltipContainerProps, TooltipItem, type TooltipItemProps, 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, selectTriggerVariants, tabsVariants, typographyVariants, uploadVariants };
+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, 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, Star, Statement, Table, TableIcon, type TableProps, Tabs, TabsContent, type TabsContentProps, TabsList, type TabsListProps, type TabsProps, TabsTrigger, type TabsTriggerProps, Textarea, type TextareaProps, type TickProps, TooltipContainer, type TooltipContainerProps, TooltipItem, type TooltipItemProps, 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 };

package/dist/index.d.ts

@@ -225,6 +225,112 @@ interface BadgeProps extends React$1.HTMLAttributes<HTMLSpanElement>, VariantPro
  */
 declare const Badge: React$1.ForwardRefExoticComponent<BadgeProps & React$1.RefAttributes<HTMLSpanElement>>;
 
+/**
+ * @fileoverview Shared TypeScript types for PDF viewer components.
+ */
+/**
+ * PDF file input type - can be a URL string or File object.
+ */
+type PdfFile = string | File;
+/**
+ * Props for PDF viewer components.
+ */
+interface PdfViewerProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onError"> {
+    /**
+     * The PDF file to display. Can be a URL string or a File object.
+     */
+    file?: PdfFile;
+    /**
+     * Document title to display in the header.
+     */
+    title?: string;
+    /**
+     * Optional custom page width in pixels. If not provided, pages will auto-fit to container width.
+     */
+    pageWidth?: number;
+    /**
+     * Callback when download button is clicked.
+     */
+    onDownload?: () => void;
+    /**
+     * Callback when print button is clicked.
+     */
+    onPrint?: () => void;
+    /**
+     * Callback when the PDF document loads successfully.
+     */
+    onLoadSuccess?: (numPages: number) => void;
+    /**
+     * Callback when there's an error loading or rendering the PDF.
+     */
+    onError?: (error: Error) => void;
+    /**
+     * Enable text layer for text selection. Defaults to false for performance.
+     */
+    enableTextLayer?: boolean;
+}
+
+/**
+ * @fileoverview PDF.js worker configuration.
+ */
+/**
+ * Initialize PDF.js worker with a custom URL.
+ *
+ * The worker file is bundled with @northslopetech/altitude-ui at:
+ * @northslopetech/altitude-ui/pdf.worker.min.mjs
+ *
+ * **IMPORTANT**: You must call this function once at application startup before
+ * using the PdfViewer component.
+ *
+ * @param workerUrl - The URL where the PDF.js worker can be accessed
+ *
+ * @example
+ * ```tsx
+ * // For Vite/Webpack - import directly from the package (recommended):
+ * import workerUrl from '@northslopetech/altitude-ui/pdf.worker.min.mjs?url';
+ * import { initializePdfWorker } from '@northslopetech/altitude-ui';
+ *
+ * // Call once at app startup (e.g., in main.tsx, _app.tsx, or layout.tsx)
+ * initializePdfWorker(workerUrl);
+ *
+ * // Or if you've copied the worker to your public folder:
+ * initializePdfWorker('/pdf.worker.min.mjs');
+ * ```
+ */
+declare function initializePdfWorker(workerUrl: string): void;
+
+/**
+ * @fileoverview PDF viewer component for Altitude UI.
+ */
+
+/**
+ * PDF document viewer component with multi-page support.
+ *
+ * @example
+ * ```tsx
+ * // Simple usage
+ * <PdfViewer file="/document.pdf" />
+ *
+ * // With title and callbacks
+ * <PdfViewer
+ *   file={pdfFile}
+ *   title="Invoice_2024.pdf"
+ *   onDownload={() => console.log('Download clicked')}
+ *   onPrint={() => console.log('Print clicked')}
+ *   onLoadSuccess={(pages) => console.log(`Loaded ${pages} pages`)}
+ *   onError={(error) => console.error(error)}
+ * />
+ *
+ * // With custom width and text layer
+ * <PdfViewer
+ *   file="/document.pdf"
+ *   pageWidth={800}
+ *   enableTextLayer
+ * />
+ * ```
+ */
+declare const PdfViewer: React$1.ForwardRefExoticComponent<PdfViewerProps & React$1.RefAttributes<HTMLDivElement>>;
+
 /**
  * Tabs trigger variant styles.
  */
@@ -377,6 +483,14 @@ 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>;
+/**
+ * Print icon component.
+ */
+declare const Print: React$1.FC<IconProps>;
+/**
+ * Download icon component.
+ */
+declare const Download: React$1.FC<IconProps>;
 
 /**
  * @fileoverview Chart utilities for Altitude UI chart components.
@@ -887,4 +1001,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, 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, Phone, PieChart, type PieChartData, type PieChartProps, type PieLabelProps, Plus, QuestionCircle, Select, SelectContent, type SelectContentProps, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, type SelectTriggerProps, SelectValue, Separator, Share, Star, Statement, Table, TableIcon, type TableProps, Tabs, TabsContent, type TabsContentProps, TabsList, type TabsListProps, type TabsProps, TabsTrigger, type TabsTriggerProps, Textarea, type TextareaProps, type TickProps, TooltipContainer, type TooltipContainerProps, TooltipItem, type TooltipItemProps, 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, selectTriggerVariants, tabsVariants, typographyVariants, uploadVariants };
+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, 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, Star, Statement, Table, TableIcon, type TableProps, Tabs, TabsContent, type TabsContentProps, TabsList, type TabsListProps, type TabsProps, TabsTrigger, type TabsTriggerProps, Textarea, type TextareaProps, type TickProps, TooltipContainer, type TooltipContainerProps, TooltipItem, type TooltipItemProps, 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 };