@extend-ai/react-xlsx 0.9.2 → 0.10.0

package/dist/index.d.cts

@@ -539,6 +539,17 @@ interface XlsxFileTooLargeRenderProps {
     /** Configured maximum file size in bytes. */
     maxFileSizeBytes: number;
 }
+interface XlsxScrollerRenderProps {
+    /** Workbook grid content that should be rendered inside the scrollable viewport. */
+    children: React.ReactNode;
+    /** Props that must be applied to the actual scrollable viewport element. */
+    viewportProps: React.HTMLAttributes<HTMLDivElement> & {
+        key: React.Key;
+        ref: React.Ref<HTMLDivElement>;
+        style: React.CSSProperties;
+        tabIndex: number;
+    };
+}
 interface UseXlsxViewerControllerOptions {
     /**
      * Allows row and column resizing even while editing is disabled by `readOnly`.
@@ -976,6 +987,23 @@ interface XlsxViewerProps extends UseXlsxViewerControllerOptions {
     renderImage?: (props: XlsxImageRenderProps) => React.ReactNode;
     /** Replaces the selected-image outline and resize handles. */
     renderImageSelection?: (props: XlsxImageSelectionRenderProps) => React.ReactNode;
+    /**
+     * Replaces the scroll viewport shell. Spread `viewportProps` onto the actual scrollable viewport element.
+     *
+     * @example
+     * ```tsx
+     * <XlsxViewer
+     *   renderScroller={({ children, viewportProps }) => (
+     *     <ScrollAreaPrimitive.Root className="h-full min-h-0 w-full min-w-0 flex-1">
+     *       <ScrollAreaPrimitive.Viewport {...viewportProps}>{children}</ScrollAreaPrimitive.Viewport>
+     *       <ScrollBar />
+     *       <ScrollAreaPrimitive.Corner />
+     *     </ScrollAreaPrimitive.Root>
+     *   )}
+     * />
+     * ```
+     */
+    renderScroller?: (props: XlsxScrollerRenderProps) => React.ReactNode;
     /**
      * Toggles the default rounded outer shell.
      *
@@ -1048,4 +1076,4 @@ declare function useXlsxViewerThumbnails(options?: UseXlsxViewerThumbnailsOption
 declare function XlsxViewer(props: XlsxViewerProps): react_jsx_runtime.JSX.Element;
 declare function DefaultXlsxToolbar(): react_jsx_runtime.JSX.Element;
 
-export { DefaultXlsxToolbar, type UseXlsxViewerControllerOptions, type UseXlsxViewerThumbnailsOptions, type XlsxCellAddress, type XlsxCellRange, type XlsxChart, type XlsxChartAxis, type XlsxChartDataLabels, type XlsxChartLoadingRenderProps, type XlsxChartReference, type XlsxChartSeries, type XlsxChartsheet, XlsxFileSizeLimitExceededError, type XlsxFileTooLargeRenderProps, type XlsxImage, type XlsxImageAnchor, type XlsxImageRect, type XlsxImageRenderProps, type XlsxImageResizeHandlePosition, type XlsxImageSelectionRenderProps, type XlsxShape, type XlsxShapeFill, type XlsxShapeParagraph, type XlsxShapeStroke, type XlsxShapeTextBox, type XlsxShapeTextRun, type XlsxSheetData, type XlsxSheetThumbnail, type XlsxSheetThumbnailResolution, type XlsxSheetVisibility, type XlsxTable, type XlsxTableColumn, type XlsxTableHeaderMenuRenderProps, type XlsxTableSortDirection, type XlsxTableSortState, type XlsxThemePalette, XlsxViewer, type XlsxViewerCharts, type XlsxViewerController, type XlsxViewerEditing, type XlsxViewerImages, type XlsxViewerProps, XlsxViewerProvider, type XlsxViewerProviderProps, type XlsxViewerSelection, type XlsxViewerTables, type XlsxViewerThumbnails, type XlsxViewerZoom, type XlsxWorkbookTab, useXlsxViewer, useXlsxViewerCharts, useXlsxViewerController, useXlsxViewerEditing, useXlsxViewerImages, useXlsxViewerSelection, useXlsxViewerTables, useXlsxViewerThumbnails, useXlsxViewerZoom };
+export { DefaultXlsxToolbar, type UseXlsxViewerControllerOptions, type UseXlsxViewerThumbnailsOptions, type XlsxCellAddress, type XlsxCellRange, type XlsxChart, type XlsxChartAxis, type XlsxChartDataLabels, type XlsxChartLoadingRenderProps, type XlsxChartReference, type XlsxChartSeries, type XlsxChartsheet, XlsxFileSizeLimitExceededError, type XlsxFileTooLargeRenderProps, type XlsxImage, type XlsxImageAnchor, type XlsxImageRect, type XlsxImageRenderProps, type XlsxImageResizeHandlePosition, type XlsxImageSelectionRenderProps, type XlsxScrollerRenderProps, type XlsxShape, type XlsxShapeFill, type XlsxShapeParagraph, type XlsxShapeStroke, type XlsxShapeTextBox, type XlsxShapeTextRun, type XlsxSheetData, type XlsxSheetThumbnail, type XlsxSheetThumbnailResolution, type XlsxSheetVisibility, type XlsxTable, type XlsxTableColumn, type XlsxTableHeaderMenuRenderProps, type XlsxTableSortDirection, type XlsxTableSortState, type XlsxThemePalette, XlsxViewer, type XlsxViewerCharts, type XlsxViewerController, type XlsxViewerEditing, type XlsxViewerImages, type XlsxViewerProps, XlsxViewerProvider, type XlsxViewerProviderProps, type XlsxViewerSelection, type XlsxViewerTables, type XlsxViewerThumbnails, type XlsxViewerZoom, type XlsxWorkbookTab, useXlsxViewer, useXlsxViewerCharts, useXlsxViewerController, useXlsxViewerEditing, useXlsxViewerImages, useXlsxViewerSelection, useXlsxViewerTables, useXlsxViewerThumbnails, useXlsxViewerZoom };

package/dist/index.d.ts

@@ -539,6 +539,17 @@ interface XlsxFileTooLargeRenderProps {
     /** Configured maximum file size in bytes. */
     maxFileSizeBytes: number;
 }
+interface XlsxScrollerRenderProps {
+    /** Workbook grid content that should be rendered inside the scrollable viewport. */
+    children: React.ReactNode;
+    /** Props that must be applied to the actual scrollable viewport element. */
+    viewportProps: React.HTMLAttributes<HTMLDivElement> & {
+        key: React.Key;
+        ref: React.Ref<HTMLDivElement>;
+        style: React.CSSProperties;
+        tabIndex: number;
+    };
+}
 interface UseXlsxViewerControllerOptions {
     /**
      * Allows row and column resizing even while editing is disabled by `readOnly`.
@@ -976,6 +987,23 @@ interface XlsxViewerProps extends UseXlsxViewerControllerOptions {
     renderImage?: (props: XlsxImageRenderProps) => React.ReactNode;
     /** Replaces the selected-image outline and resize handles. */
     renderImageSelection?: (props: XlsxImageSelectionRenderProps) => React.ReactNode;
+    /**
+     * Replaces the scroll viewport shell. Spread `viewportProps` onto the actual scrollable viewport element.
+     *
+     * @example
+     * ```tsx
+     * <XlsxViewer
+     *   renderScroller={({ children, viewportProps }) => (
+     *     <ScrollAreaPrimitive.Root className="h-full min-h-0 w-full min-w-0 flex-1">
+     *       <ScrollAreaPrimitive.Viewport {...viewportProps}>{children}</ScrollAreaPrimitive.Viewport>
+     *       <ScrollBar />
+     *       <ScrollAreaPrimitive.Corner />
+     *     </ScrollAreaPrimitive.Root>
+     *   )}
+     * />
+     * ```
+     */
+    renderScroller?: (props: XlsxScrollerRenderProps) => React.ReactNode;
     /**
      * Toggles the default rounded outer shell.
      *
@@ -1048,4 +1076,4 @@ declare function useXlsxViewerThumbnails(options?: UseXlsxViewerThumbnailsOption
 declare function XlsxViewer(props: XlsxViewerProps): react_jsx_runtime.JSX.Element;
 declare function DefaultXlsxToolbar(): react_jsx_runtime.JSX.Element;
 
-export { DefaultXlsxToolbar, type UseXlsxViewerControllerOptions, type UseXlsxViewerThumbnailsOptions, type XlsxCellAddress, type XlsxCellRange, type XlsxChart, type XlsxChartAxis, type XlsxChartDataLabels, type XlsxChartLoadingRenderProps, type XlsxChartReference, type XlsxChartSeries, type XlsxChartsheet, XlsxFileSizeLimitExceededError, type XlsxFileTooLargeRenderProps, type XlsxImage, type XlsxImageAnchor, type XlsxImageRect, type XlsxImageRenderProps, type XlsxImageResizeHandlePosition, type XlsxImageSelectionRenderProps, type XlsxShape, type XlsxShapeFill, type XlsxShapeParagraph, type XlsxShapeStroke, type XlsxShapeTextBox, type XlsxShapeTextRun, type XlsxSheetData, type XlsxSheetThumbnail, type XlsxSheetThumbnailResolution, type XlsxSheetVisibility, type XlsxTable, type XlsxTableColumn, type XlsxTableHeaderMenuRenderProps, type XlsxTableSortDirection, type XlsxTableSortState, type XlsxThemePalette, XlsxViewer, type XlsxViewerCharts, type XlsxViewerController, type XlsxViewerEditing, type XlsxViewerImages, type XlsxViewerProps, XlsxViewerProvider, type XlsxViewerProviderProps, type XlsxViewerSelection, type XlsxViewerTables, type XlsxViewerThumbnails, type XlsxViewerZoom, type XlsxWorkbookTab, useXlsxViewer, useXlsxViewerCharts, useXlsxViewerController, useXlsxViewerEditing, useXlsxViewerImages, useXlsxViewerSelection, useXlsxViewerTables, useXlsxViewerThumbnails, useXlsxViewerZoom };
+export { DefaultXlsxToolbar, type UseXlsxViewerControllerOptions, type UseXlsxViewerThumbnailsOptions, type XlsxCellAddress, type XlsxCellRange, type XlsxChart, type XlsxChartAxis, type XlsxChartDataLabels, type XlsxChartLoadingRenderProps, type XlsxChartReference, type XlsxChartSeries, type XlsxChartsheet, XlsxFileSizeLimitExceededError, type XlsxFileTooLargeRenderProps, type XlsxImage, type XlsxImageAnchor, type XlsxImageRect, type XlsxImageRenderProps, type XlsxImageResizeHandlePosition, type XlsxImageSelectionRenderProps, type XlsxScrollerRenderProps, type XlsxShape, type XlsxShapeFill, type XlsxShapeParagraph, type XlsxShapeStroke, type XlsxShapeTextBox, type XlsxShapeTextRun, type XlsxSheetData, type XlsxSheetThumbnail, type XlsxSheetThumbnailResolution, type XlsxSheetVisibility, type XlsxTable, type XlsxTableColumn, type XlsxTableHeaderMenuRenderProps, type XlsxTableSortDirection, type XlsxTableSortState, type XlsxThemePalette, XlsxViewer, type XlsxViewerCharts, type XlsxViewerController, type XlsxViewerEditing, type XlsxViewerImages, type XlsxViewerProps, XlsxViewerProvider, type XlsxViewerProviderProps, type XlsxViewerSelection, type XlsxViewerTables, type XlsxViewerThumbnails, type XlsxViewerZoom, type XlsxWorkbookTab, useXlsxViewer, useXlsxViewerCharts, useXlsxViewerController, useXlsxViewerEditing, useXlsxViewerImages, useXlsxViewerSelection, useXlsxViewerTables, useXlsxViewerThumbnails, useXlsxViewerZoom };