@extend-ai/react-xlsx 0.14.0 → 0.14.1

package/dist/index.d.cts

@@ -539,6 +539,8 @@ interface XlsxFormControl {
     id: string;
     increment?: number;
     inputRange?: string;
+    /** Current formatted labels resolved from a dropdown or list box input range. */
+    items?: string[];
     kind: XlsxFormControlKind;
     label?: string;
     lines?: number;
@@ -570,6 +572,38 @@ interface XlsxFormControlChangeEvent {
     previousControl: XlsxFormControl;
     type: "change";
 }
+interface XlsxFormControlRenderProps {
+    /** Activates a button control. No-ops in read-only mode. */
+    activate: () => void;
+    /** Current checked state for checkbox and radio controls. */
+    checked: boolean;
+    /** Full parsed control metadata. Switch on `control.kind` to render a kind-specific component. */
+    control: XlsxFormControl;
+    /** True when this control cannot be changed through the viewer. */
+    disabled: boolean;
+    /** Current formatted dropdown or list box items resolved from the control input range. */
+    items: string[];
+    /** Display label after placeholder Excel names have been removed. */
+    label: string;
+    /** True when a checkbox is in Excel's indeterminate state. */
+    mixed: boolean;
+    /** True when the viewer is rendering without workbook mutation support. */
+    readOnly: boolean;
+    /** Calculated worksheet-relative control rectangle in CSS pixels. */
+    rect: XlsxImageRect;
+    /** Persists a dropdown or list box selection. No-ops for other control kinds or in read-only mode. */
+    setSelected: (selected: number | number[] | undefined) => boolean;
+    /** Persists a checkbox or radio state. No-ops for other control kinds or in read-only mode. */
+    setState: (state: XlsxFormControlState) => boolean;
+    /** Persists a scrollbar or spinner value. No-ops for other control kinds or in read-only mode. */
+    setValue: (value: number) => boolean;
+    /** Stops an event from leaking into worksheet selection. */
+    stopPropagation: (event: React.SyntheticEvent) => void;
+    /** Apply this style to the custom control root to preserve worksheet positioning and sizing. */
+    style: React.CSSProperties;
+    /** Current worksheet zoom multiplier, where `1` is 100%. */
+    zoomFactor: number;
+}
 interface XlsxChartReference {
     formula?: string;
     refType?: string;
@@ -1456,6 +1490,12 @@ interface XlsxViewerProps extends UseXlsxViewerControllerOptions {
     onFormControlChange?: (event: XlsxFormControlChangeEvent) => void;
     /** Replaces the chart loading placeholder. */
     renderChartLoading?: (props: XlsxChartLoadingRenderProps) => React.ReactNode;
+    /**
+     * Replaces built-in worksheet form-control rendering.
+     * Apply `style` to the custom root and use `stopPropagation` on pointer/click handlers.
+     * The supplied setters preserve Duke mutation, linked-cell, undo/redo, and change-event behavior.
+     */
+    renderFormControl?: (props: XlsxFormControlRenderProps) => React.ReactNode;
     /**
      * Replaces worksheet images while preserving their calculated rect and style.
      *
@@ -1560,4 +1600,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 XlsxCellAlignmentInput, type XlsxCellBorderEdgeInput, type XlsxCellBorderStyleInput, type XlsxCellFillStyleInput, type XlsxCellFontStyleInput, type XlsxCellGradientStopInput, type XlsxCellNumberFormatInput, type XlsxCellProtectionInput, type XlsxCellRange, type XlsxCellStyleColorInput, type XlsxCellStyleContext, type XlsxCellStyleInput, type XlsxChart, type XlsxChartAxis, type XlsxChartDataLabels, type XlsxChartElementSelection, type XlsxChartLoadingRenderProps, type XlsxChartReference, type XlsxChartSeries, type XlsxChartsheet, XlsxFileSizeLimitExceededError, type XlsxFileTooLargeRenderProps, type XlsxFormControl, type XlsxFormControlActionEvent, type XlsxFormControlAnchor, type XlsxFormControlChangeEvent, type XlsxFormControlInput, type XlsxFormControlKind, type XlsxFormControlKindInput, type XlsxFormControlPatch, type XlsxFormControlSelectionMode, type XlsxFormControlState, type XlsxFormulaTarget, 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 XlsxWasmSource, type XlsxWorkbookTab, initWasm, setWasmSource, useXlsxViewer, useXlsxViewerCharts, useXlsxViewerController, useXlsxViewerEditing, useXlsxViewerImages, useXlsxViewerSelection, useXlsxViewerTables, useXlsxViewerThumbnails, useXlsxViewerZoom };
+export { DefaultXlsxToolbar, type UseXlsxViewerControllerOptions, type UseXlsxViewerThumbnailsOptions, type XlsxCellAddress, type XlsxCellAlignmentInput, type XlsxCellBorderEdgeInput, type XlsxCellBorderStyleInput, type XlsxCellFillStyleInput, type XlsxCellFontStyleInput, type XlsxCellGradientStopInput, type XlsxCellNumberFormatInput, type XlsxCellProtectionInput, type XlsxCellRange, type XlsxCellStyleColorInput, type XlsxCellStyleContext, type XlsxCellStyleInput, type XlsxChart, type XlsxChartAxis, type XlsxChartDataLabels, type XlsxChartElementSelection, type XlsxChartLoadingRenderProps, type XlsxChartReference, type XlsxChartSeries, type XlsxChartsheet, XlsxFileSizeLimitExceededError, type XlsxFileTooLargeRenderProps, type XlsxFormControl, type XlsxFormControlActionEvent, type XlsxFormControlAnchor, type XlsxFormControlChangeEvent, type XlsxFormControlInput, type XlsxFormControlKind, type XlsxFormControlKindInput, type XlsxFormControlPatch, type XlsxFormControlRenderProps, type XlsxFormControlSelectionMode, type XlsxFormControlState, type XlsxFormulaTarget, 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 XlsxWasmSource, type XlsxWorkbookTab, initWasm, setWasmSource, useXlsxViewer, useXlsxViewerCharts, useXlsxViewerController, useXlsxViewerEditing, useXlsxViewerImages, useXlsxViewerSelection, useXlsxViewerTables, useXlsxViewerThumbnails, useXlsxViewerZoom };

package/dist/index.d.ts

@@ -539,6 +539,8 @@ interface XlsxFormControl {
     id: string;
     increment?: number;
     inputRange?: string;
+    /** Current formatted labels resolved from a dropdown or list box input range. */
+    items?: string[];
     kind: XlsxFormControlKind;
     label?: string;
     lines?: number;
@@ -570,6 +572,38 @@ interface XlsxFormControlChangeEvent {
     previousControl: XlsxFormControl;
     type: "change";
 }
+interface XlsxFormControlRenderProps {
+    /** Activates a button control. No-ops in read-only mode. */
+    activate: () => void;
+    /** Current checked state for checkbox and radio controls. */
+    checked: boolean;
+    /** Full parsed control metadata. Switch on `control.kind` to render a kind-specific component. */
+    control: XlsxFormControl;
+    /** True when this control cannot be changed through the viewer. */
+    disabled: boolean;
+    /** Current formatted dropdown or list box items resolved from the control input range. */
+    items: string[];
+    /** Display label after placeholder Excel names have been removed. */
+    label: string;
+    /** True when a checkbox is in Excel's indeterminate state. */
+    mixed: boolean;
+    /** True when the viewer is rendering without workbook mutation support. */
+    readOnly: boolean;
+    /** Calculated worksheet-relative control rectangle in CSS pixels. */
+    rect: XlsxImageRect;
+    /** Persists a dropdown or list box selection. No-ops for other control kinds or in read-only mode. */
+    setSelected: (selected: number | number[] | undefined) => boolean;
+    /** Persists a checkbox or radio state. No-ops for other control kinds or in read-only mode. */
+    setState: (state: XlsxFormControlState) => boolean;
+    /** Persists a scrollbar or spinner value. No-ops for other control kinds or in read-only mode. */
+    setValue: (value: number) => boolean;
+    /** Stops an event from leaking into worksheet selection. */
+    stopPropagation: (event: React.SyntheticEvent) => void;
+    /** Apply this style to the custom control root to preserve worksheet positioning and sizing. */
+    style: React.CSSProperties;
+    /** Current worksheet zoom multiplier, where `1` is 100%. */
+    zoomFactor: number;
+}
 interface XlsxChartReference {
     formula?: string;
     refType?: string;
@@ -1456,6 +1490,12 @@ interface XlsxViewerProps extends UseXlsxViewerControllerOptions {
     onFormControlChange?: (event: XlsxFormControlChangeEvent) => void;
     /** Replaces the chart loading placeholder. */
     renderChartLoading?: (props: XlsxChartLoadingRenderProps) => React.ReactNode;
+    /**
+     * Replaces built-in worksheet form-control rendering.
+     * Apply `style` to the custom root and use `stopPropagation` on pointer/click handlers.
+     * The supplied setters preserve Duke mutation, linked-cell, undo/redo, and change-event behavior.
+     */
+    renderFormControl?: (props: XlsxFormControlRenderProps) => React.ReactNode;
     /**
      * Replaces worksheet images while preserving their calculated rect and style.
      *
@@ -1560,4 +1600,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 XlsxCellAlignmentInput, type XlsxCellBorderEdgeInput, type XlsxCellBorderStyleInput, type XlsxCellFillStyleInput, type XlsxCellFontStyleInput, type XlsxCellGradientStopInput, type XlsxCellNumberFormatInput, type XlsxCellProtectionInput, type XlsxCellRange, type XlsxCellStyleColorInput, type XlsxCellStyleContext, type XlsxCellStyleInput, type XlsxChart, type XlsxChartAxis, type XlsxChartDataLabels, type XlsxChartElementSelection, type XlsxChartLoadingRenderProps, type XlsxChartReference, type XlsxChartSeries, type XlsxChartsheet, XlsxFileSizeLimitExceededError, type XlsxFileTooLargeRenderProps, type XlsxFormControl, type XlsxFormControlActionEvent, type XlsxFormControlAnchor, type XlsxFormControlChangeEvent, type XlsxFormControlInput, type XlsxFormControlKind, type XlsxFormControlKindInput, type XlsxFormControlPatch, type XlsxFormControlSelectionMode, type XlsxFormControlState, type XlsxFormulaTarget, 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 XlsxWasmSource, type XlsxWorkbookTab, initWasm, setWasmSource, useXlsxViewer, useXlsxViewerCharts, useXlsxViewerController, useXlsxViewerEditing, useXlsxViewerImages, useXlsxViewerSelection, useXlsxViewerTables, useXlsxViewerThumbnails, useXlsxViewerZoom };
+export { DefaultXlsxToolbar, type UseXlsxViewerControllerOptions, type UseXlsxViewerThumbnailsOptions, type XlsxCellAddress, type XlsxCellAlignmentInput, type XlsxCellBorderEdgeInput, type XlsxCellBorderStyleInput, type XlsxCellFillStyleInput, type XlsxCellFontStyleInput, type XlsxCellGradientStopInput, type XlsxCellNumberFormatInput, type XlsxCellProtectionInput, type XlsxCellRange, type XlsxCellStyleColorInput, type XlsxCellStyleContext, type XlsxCellStyleInput, type XlsxChart, type XlsxChartAxis, type XlsxChartDataLabels, type XlsxChartElementSelection, type XlsxChartLoadingRenderProps, type XlsxChartReference, type XlsxChartSeries, type XlsxChartsheet, XlsxFileSizeLimitExceededError, type XlsxFileTooLargeRenderProps, type XlsxFormControl, type XlsxFormControlActionEvent, type XlsxFormControlAnchor, type XlsxFormControlChangeEvent, type XlsxFormControlInput, type XlsxFormControlKind, type XlsxFormControlKindInput, type XlsxFormControlPatch, type XlsxFormControlRenderProps, type XlsxFormControlSelectionMode, type XlsxFormControlState, type XlsxFormulaTarget, 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 XlsxWasmSource, type XlsxWorkbookTab, initWasm, setWasmSource, useXlsxViewer, useXlsxViewerCharts, useXlsxViewerController, useXlsxViewerEditing, useXlsxViewerImages, useXlsxViewerSelection, useXlsxViewerTables, useXlsxViewerThumbnails, useXlsxViewerZoom };