@sheetxl/react 0.8.0-beta.7 → 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE.md +8 -7
- package/browser/esm/2YDUWXaXpl9cdsk7.mjs +8 -0
- package/browser/esm/64NfoZ1s7Oe3vdpX.mjs +60 -0
- package/browser/esm/BJDz5J4gFUEYi1Wz.mjs +36 -0
- package/browser/esm/B_CI6xMNropeWGgr.mjs +134 -0
- package/browser/esm/BgA4Cz8iMysciFOb.mjs +45 -0
- package/browser/esm/BkG6VuJDmu_hfIo6.mjs +31 -0
- package/browser/esm/BmO7yh4NjxeJylOD.mjs +14092 -0
- package/browser/esm/BwFFSeqtE3TIuvtc.mjs +341 -0
- package/browser/esm/CENTtj0PnF_tvpST.mjs +79 -0
- package/browser/esm/CVY0-_x6IgpdUVNp.mjs +264 -0
- package/browser/esm/CdyivRoMgPXvRiiE.mjs +197 -0
- package/browser/esm/CiylJlRA7mt8yjPD.mjs +128 -0
- package/browser/esm/D9CTIGFUbVGJkeVE.mjs +401 -0
- package/browser/esm/D9NgFucLwPgAQNgf.mjs +19 -0
- package/browser/esm/DdFOaG09eksHtKwT.mjs +145 -0
- package/browser/esm/DdHdNjRkzo1iShOo.mjs +78 -0
- package/browser/esm/DfIvpHB7HDdmIYNm.mjs +9560 -0
- package/browser/esm/DfNDtzixfTPjmoW_.mjs +32 -0
- package/browser/esm/Dtb9bOBjtPdUAr8x.mjs +20 -0
- package/browser/esm/Dz5pGpL4XWXVdntj.mjs +323 -0
- package/browser/esm/SJAlYSFKC-5yNZ-C.mjs +2706 -0
- package/browser/esm/chart.mjs +41 -0
- package/browser/esm/control.mjs +217 -0
- package/browser/esm/group.mjs +123 -0
- package/browser/esm/index.mjs +22289 -13986
- package/browser/esm/jHqSboF5oFvzSM7a.mjs +63 -0
- package/browser/esm/note.mjs +112 -0
- package/browser/esm/oljQE8EpIzoxUjUz.mjs +323 -0
- package/browser/esm/picture.mjs +7 -0
- package/browser/esm/shape.mjs +7 -0
- package/browser/esm/slicer.mjs +282 -0
- package/browser/esm/w8MsScJSe7QxP6jL.mjs +67 -0
- package/browser/esm/yRqWQRSVyiR1kYh8.mjs +42 -0
- package/licenses/dependencies.txt +284 -565
- package/node/esm/1XOgrNXKQF__O9SV.mjs +8 -0
- package/node/esm/Aw6aaKE_YOA1Vi_V.mjs +146 -0
- package/node/esm/B6Oqu2Gw1pwWPf_N.mjs +328 -0
- package/node/esm/BizlElAhqg_Bc624.mjs +198 -0
- package/node/esm/C06Y1xPsbxgn3YX7.mjs +128 -0
- package/node/esm/C2dHN_gvhBxlFFnJ.mjs +45 -0
- package/node/esm/C4_5UcCdys1hzt5E.mjs +68 -0
- package/node/esm/CIidiDtqyubz13ys.mjs +80 -0
- package/node/esm/CTFb8PjwC1q6yilw.mjs +80 -0
- package/node/esm/C_GJPG-BTFhta8GD.mjs +265 -0
- package/node/esm/CdTeYrDgGp-s-KNG.mjs +134 -0
- package/node/esm/CeMKhq6cSxfWzN5H.mjs +2706 -0
- package/node/esm/DJIBAu8bEDmlVjtD.mjs +20 -0
- package/node/esm/DUQ1PY9P63cTe_Es.mjs +37 -0
- package/node/esm/Db8NRp_kZ-FfkZaO.mjs +32 -0
- package/node/esm/Dl2kdvb4G_ddqeDN.mjs +19 -0
- package/node/esm/DlDr-o5nAZgPbn6R.mjs +1697 -0
- package/node/esm/DvRLP1lEBfwHBrEC.mjs +63 -0
- package/node/esm/JVlPlE1ys7DM3yCP.mjs +35 -0
- package/node/esm/NSddS40Vqf1xKdDd.mjs +406 -0
- package/node/esm/QqwCS9GFuDnQausz.mjs +66 -0
- package/node/esm/chart.mjs +41 -0
- package/node/esm/control.mjs +217 -0
- package/node/esm/group.mjs +123 -0
- package/node/esm/index.mjs +18027 -9614
- package/node/esm/note.mjs +113 -0
- package/node/esm/picture.mjs +326 -0
- package/node/esm/shape.mjs +342 -0
- package/node/esm/slicer.mjs +284 -0
- package/package.json +56 -15
- package/resources/contents.json +36 -0
- package/resources/locales/contents.json +84 -0
- package/resources/locales/de/chart.cmd.json +82 -0
- package/resources/locales/de/movable.cmd.json +68 -0
- package/resources/locales/de/picture.cmd.json +188 -0
- package/resources/locales/de/pivot.cmd.json +79 -0
- package/resources/locales/de/shape.cmd.json +17 -0
- package/resources/locales/de/sheet.cmd.json +270 -16
- package/resources/locales/de/slicer.cmd.json +17 -0
- package/resources/locales/de/sparkline.cmd.json +301 -0
- package/resources/locales/de/table.cmd.json +13 -2
- package/resources/locales/de/ui.msg.json +358 -2
- package/resources/locales/de/workbook.cmd.json +8 -1
- package/resources/locales/en/chart.cmd.json +82 -0
- package/resources/locales/en/movable.cmd.json +68 -0
- package/resources/locales/en/picture.cmd.json +188 -0
- package/resources/locales/en/pivot.cmd.json +79 -0
- package/resources/locales/en/shape.cmd.json +17 -0
- package/resources/locales/en/sheet.cmd.json +283 -17
- package/resources/locales/en/slicer.cmd.json +17 -0
- package/resources/locales/en/sparkline.cmd.json +301 -0
- package/resources/locales/en/table.cmd.json +13 -2
- package/resources/locales/en/ui.msg.json +360 -2
- package/resources/locales/en/workbook.cmd.json +8 -1
- package/types/chart.d.ts +2 -0
- package/types/control.d.ts +2 -0
- package/types/group.d.ts +2 -0
- package/types/note.d.ts +2 -0
- package/types/picture.d.ts +2 -0
- package/types/shape.d.ts +2 -0
- package/types/slicer.d.ts +2 -0
- package/types/src/annotation/RangeAnnotationLayer.d.ts +110 -0
- package/types/src/annotation/RangeAnnotationTag.d.ts +23 -0
- package/types/src/annotation/RangeAnnotations.d.ts +180 -0
- package/types/src/annotation/index.d.ts +4 -0
- package/types/src/autoFill/FillMenu.d.ts +2 -2
- package/types/src/autoFill/FillSeries.d.ts +2 -2
- package/types/src/border/StaticBorderRenderer.d.ts +18 -1
- package/types/src/border/useBorders.d.ts +95 -3
- package/types/src/cell/CellCheckboxRenderer.d.ts +20 -0
- package/types/src/cell/CellContent.d.ts +68 -0
- package/types/src/cell/CellControlContext.d.ts +37 -0
- package/types/src/cell/{FormulaCellRenderer.d.ts → CellFormulaRenderer.d.ts} +10 -7
- package/types/src/cell/CellImageRenderer.d.ts +11 -0
- package/types/src/cell/CellRenderers.d.ts +190 -0
- package/types/src/cell/{SheetCellRenderer.d.ts → CellTextRenderer.d.ts} +11 -8
- package/types/src/cell/ColumnButton.d.ts +3 -3
- package/types/src/cell/CornerTriangle.d.ts +2 -1
- package/types/src/cell/OutlineButton.d.ts +123 -0
- package/types/src/cell/PivotButton.d.ts +55 -0
- package/types/src/cell/SheetHeaderRenderer.d.ts +1 -1
- package/types/src/cell/StaticCellRenderer.d.ts +3 -3
- package/types/src/cell/_DropdownFace.d.ts +29 -0
- package/types/src/cell/index.d.ts +10 -2
- package/types/src/cell/useFormulaViewAnchor.d.ts +3 -3
- package/types/src/cell/useInsertableCellControls.d.ts +25 -0
- package/types/src/chart/ChartCommands.d.ts +15 -0
- package/types/src/chart/ChartEditor.d.ts +12 -2
- package/types/src/chart/ChartElement.d.ts +122 -0
- package/types/src/chart/ChartKind.d.ts +7 -0
- package/types/src/chart/PresetChartTypeDescriptors.d.ts +3 -1
- package/types/src/chart/index.d.ts +2 -1
- package/types/src/chart/paint/_fills.d.ts +24 -0
- package/types/src/chart/paint/_graphics.d.ts +38 -0
- package/types/src/chart/paint/_mode.d.ts +6 -0
- package/types/src/chart/paint/echarts.d.ts +33 -0
- package/types/src/chart/paint/index.d.ts +12 -0
- package/types/src/chart/paint/kinds/ChartPaintKind.d.ts +140 -0
- package/types/src/chart/paint/kinds/_Area.d.ts +3 -0
- package/types/src/chart/paint/kinds/_Bar.d.ts +3 -0
- package/types/src/chart/paint/kinds/_BoxWhisker.d.ts +3 -0
- package/types/src/chart/paint/kinds/_Bubble.d.ts +3 -0
- package/types/src/chart/paint/kinds/_Funnel.d.ts +3 -0
- package/types/src/chart/paint/kinds/_Histogram.d.ts +3 -0
- package/types/src/chart/paint/kinds/_Line.d.ts +10 -0
- package/types/src/chart/paint/kinds/_OfPie.d.ts +3 -0
- package/types/src/chart/paint/kinds/_Pie.d.ts +21 -0
- package/types/src/chart/paint/kinds/_Placeholder.d.ts +7 -0
- package/types/src/chart/paint/kinds/_Radar.d.ts +3 -0
- package/types/src/chart/paint/kinds/_Scatter.d.ts +3 -0
- package/types/src/chart/paint/kinds/_Sunburst.d.ts +3 -0
- package/types/src/chart/paint/kinds/_Surface.d.ts +3 -0
- package/types/src/chart/paint/kinds/_Treemap.d.ts +3 -0
- package/types/src/chart/paint/kinds/_Waterfall.d.ts +3 -0
- package/types/src/chart/paint/kinds/_builtIns.d.ts +3 -0
- package/types/src/chart/paint/toEChartsOption.d.ts +42 -0
- package/types/src/checklist/ValueChecklist.d.ts +59 -18
- package/types/src/clipboard/ClipboardCommands.d.ts +3 -3
- package/types/src/clipboard/SheetClipboardLayer.d.ts +2 -2
- package/types/src/commands/ContextualToolbar.d.ts +19 -0
- package/types/src/commands/createTransactionalMiddleware.d.ts +4 -1
- package/types/src/commands/index.d.ts +1 -0
- package/types/src/comment/CommentCardRequest.d.ts +9 -9
- package/types/src/comment/index.d.ts +0 -1
- package/types/src/comment/useSheetComments.d.ts +2 -2
- package/types/src/conditionalFormat/ConditionalFormatPresets.d.ts +6 -6
- package/types/src/context/WorksheetContext.d.ts +18 -0
- package/types/src/context/index.d.ts +1 -1
- package/types/src/control/FormControlRenderers.d.ts +22 -0
- package/types/src/editableLabel/EditableLabel.d.ts +3 -1
- package/types/src/editor/EditorCommands.d.ts +3 -3
- package/types/src/editor/SheetCellEditorLayer.d.ts +2 -7
- package/types/src/editor/SheetCellEditorStartLayer.d.ts +22 -5
- package/types/src/editor/SheetCellInput.d.ts +14 -0
- package/types/src/editor/SheetEditable.d.ts +6 -6
- package/types/src/editor/SheetReferenceHeaderLayer.d.ts +1 -1
- package/types/src/editor/SheetReferenceLayer.d.ts +4 -4
- package/types/src/editor/VirtualKeyboardLayer.d.ts +50 -0
- package/types/src/editor/formulaAnchor.d.ts +12 -0
- package/types/src/editor/formulaPresentation.d.ts +4 -3
- package/types/src/editor/index.d.ts +2 -0
- package/types/src/editor/pickedReference.d.ts +3 -3
- package/types/src/editor/useEditRejectedNotice.d.ts +3 -3
- package/types/src/editor/useFormulaHints.d.ts +3 -3
- package/types/src/editor/useFormulaInput.d.ts +6 -3
- package/types/src/editor/validationAlert.d.ts +24 -0
- package/types/src/form/FormulaInput.d.ts +5 -2
- package/types/src/form/useEditCommit.d.ts +23 -3
- package/types/src/form/useInputField.d.ts +2 -3
- package/types/src/frame/CommandContext.d.ts +101 -3
- package/types/src/group/GroupEditor.d.ts +25 -0
- package/types/src/index.d.ts +10 -1
- package/types/src/layer/BorderLayer.d.ts +5 -2
- package/types/src/layer/CellErrorLayer.d.ts +18 -7
- package/types/src/layer/CellFillLayer.d.ts +2 -2
- package/types/src/layer/CellIndicatorLayer.d.ts +31 -0
- package/types/src/layer/CellInsertLayer.d.ts +71 -0
- package/types/src/layer/CircularIndicatorLayer.d.ts +3 -3
- package/types/src/layer/CommentCardLayer.d.ts +7 -9
- package/types/src/layer/CommentsLayer.d.ts +2 -2
- package/types/src/layer/ConditionalBarLayer.d.ts +2 -2
- package/types/src/layer/ConditionalIcons.d.ts +4 -4
- package/types/src/layer/ConditionalIconsLayer.d.ts +2 -2
- package/types/src/layer/ContextMenuLayer.d.ts +2 -2
- package/types/src/layer/FreezeDragLines.d.ts +17 -0
- package/types/src/layer/GridFreezeLayer.d.ts +11 -0
- package/types/src/layer/HeaderFreezeLayer.d.ts +12 -0
- package/types/src/layer/HeaderResizerLayer.d.ts +2 -1
- package/types/src/layer/HeaderSelectionLayer.d.ts +4 -4
- package/types/src/layer/HyperlinkLayer.d.ts +116 -0
- package/types/src/layer/MovableKindScope.d.ts +17 -0
- package/types/src/layer/PivotLayer.d.ts +47 -0
- package/types/src/layer/PivotToolbar.d.ts +29 -0
- package/types/src/layer/ProtectionLayer.d.ts +4 -5
- package/types/src/layer/RangeToolbar.d.ts +75 -0
- package/types/src/layer/ResizeIndicator.d.ts +11 -10
- package/types/src/layer/ResizeTooltip.d.ts +13 -0
- package/types/src/layer/SheetBackgroundLayer.d.ts +3 -3
- package/types/src/layer/SheetCellLayer.d.ts +15 -8
- package/types/src/layer/SheetColumnButtonLayer.d.ts +2 -2
- package/types/src/layer/SheetGridLineLayer.d.ts +25 -15
- package/types/src/layer/SheetHeaderCellLayer.d.ts +10 -1
- package/types/src/layer/SheetLayers.d.ts +171 -0
- package/types/src/layer/SheetMovableLayer.d.ts +4 -3
- package/types/src/layer/SheetOutlineLayer.d.ts +40 -0
- package/types/src/layer/SheetPivotCommandLayer.d.ts +13 -0
- package/types/src/layer/SheetSparklineCommandLayer.d.ts +14 -0
- package/types/src/layer/SheetTableCommandLayer.d.ts +2 -2
- package/types/src/layer/SparklineLayer.d.ts +32 -0
- package/types/src/layer/SpillLayer.d.ts +2 -2
- package/types/src/layer/TableLayer.d.ts +6 -5
- package/types/src/layer/TableToolbar.d.ts +23 -0
- package/types/src/layer/ValidationDropdownLayer.d.ts +2 -2
- package/types/src/layer/ValidationIndicatorLayer.d.ts +2 -2
- package/types/src/layer/ValidationPromptLayer.d.ts +47 -16
- package/types/src/layer/_sheetBorders.d.ts +6 -0
- package/types/src/layer/_tableColor.d.ts +6 -0
- package/types/src/layer/_visibleCellFeatures.d.ts +11 -0
- package/types/src/layer/cellTip.d.ts +13 -0
- package/types/src/layer/freezeDragState.d.ts +21 -0
- package/types/src/layer/index.d.ts +15 -0
- package/types/src/layer/resizeIndicatorState.d.ts +3 -1
- package/types/src/layer/useFreezeDrag.d.ts +22 -0
- package/types/src/layer/useNormalBorderLines.d.ts +15 -0
- package/types/src/layer/useSheetFeatureRegions.d.ts +2 -2
- package/types/src/layer/useSheetVisibleCells.d.ts +5 -6
- package/types/src/layer/useSheetVisibleDecorations.d.ts +2 -2
- package/types/src/layer/useTableHeaderCells.d.ts +2 -2
- package/types/src/layer/useValidationPicker.d.ts +3 -3
- package/types/src/layer/useVisibleTables.d.ts +2 -2
- package/types/src/layer/validationMark.d.ts +3 -3
- package/types/src/listener/index.d.ts +5 -0
- package/types/src/listener/useCell.d.ts +29 -0
- package/types/src/listener/useCellRange.d.ts +23 -0
- package/types/src/listener/useCellValue.d.ts +26 -0
- package/types/src/listener/useModelListener.d.ts +4 -4
- package/types/src/listener/useRangeListener.d.ts +13 -7
- package/types/src/listener/useRangeSnapshot.d.ts +35 -0
- package/types/src/listener/useTable.d.ts +26 -0
- package/types/src/movable/ConnectionSites.d.ts +18 -0
- package/types/src/movable/DefaultMovable.d.ts +8 -0
- package/types/src/movable/IMovableArea.d.ts +38 -0
- package/types/src/movable/MovableAdornment.d.ts +26 -0
- package/types/src/movable/MovableCommandGroups.d.ts +22 -0
- package/types/src/movable/MovableCommands.d.ts +8 -3
- package/types/src/movable/MovableControl.d.ts +80 -0
- package/types/src/movable/MovableFrame.d.ts +18 -16
- package/types/src/movable/MovableLayer.d.ts +30 -5
- package/types/src/movable/MovableRenderers.d.ts +210 -0
- package/types/src/movable/PlaceholderFrames.d.ts +11 -0
- package/types/src/movable/RotateHandle.d.ts +37 -0
- package/types/src/movable/connect.d.ts +16 -0
- package/types/src/movable/framePlacement.d.ts +72 -0
- package/types/src/movable/geometry.d.ts +61 -0
- package/types/src/movable/index.d.ts +9 -0
- package/types/src/movable/pressTarget.d.ts +20 -0
- package/types/src/movable/useFramePreview.d.ts +17 -0
- package/types/src/picker/cellPickerOpen.d.ts +3 -3
- package/types/src/picker/useCellPicker.d.ts +7 -5
- package/types/src/picture/PictureCommands.d.ts +20 -0
- package/types/src/picture/PictureKind.d.ts +7 -0
- package/types/src/picture/_pictureHyperlink.d.ts +13 -0
- package/types/src/picture/index.d.ts +0 -1
- package/types/src/picture/pictureCrop.d.ts +32 -0
- package/types/src/pivot/PivotAreas.d.ts +16 -0
- package/types/src/pivot/PivotChip.d.ts +33 -0
- package/types/src/pivot/PivotChipMenu.d.ts +74 -0
- package/types/src/pivot/PivotCommands.d.ts +24 -0
- package/types/src/pivot/PivotFieldList.d.ts +14 -0
- package/types/src/pivot/PivotFields.d.ts +47 -0
- package/types/src/pivot/PivotFieldsModel.d.ts +143 -0
- package/types/src/pivot/PivotTablePane.d.ts +47 -0
- package/types/src/pivot/_PivotFieldsContext.d.ts +41 -0
- package/types/src/pivot/_pivotNew.d.ts +12 -0
- package/types/src/pivot/_pivotRegion.d.ts +14 -0
- package/types/src/pivot/index.d.ts +9 -0
- package/types/src/pivot/usePivotFields.d.ts +17 -0
- package/types/src/presence/PresenceCommands.d.ts +35 -0
- package/types/src/presence/PresenceHost.d.ts +58 -0
- package/types/src/presence/PresenceMessages.d.ts +42 -0
- package/types/src/presence/PresenceStore.d.ts +165 -0
- package/types/src/presence/PresenceTypes.d.ts +78 -0
- package/types/src/presence/index.d.ts +7 -0
- package/types/src/presence/usePresence.d.ts +20 -0
- package/types/src/richText/RichTextEditor.d.ts +2 -2
- package/types/src/selection/SelectionCommands.d.ts +2 -2
- package/types/src/selection/SheetSelectionLayer.d.ts +6 -12
- package/types/src/shape/ConnectorControl.d.ts +46 -0
- package/types/src/shape/ShapeCommands.d.ts +11 -0
- package/types/src/shape/ShapeControl.d.ts +8 -0
- package/types/src/shape/ShapeEditor.d.ts +15 -2
- package/types/src/shape/ShapeGallery.d.ts +31 -0
- package/types/src/shape/ShapeHandles.d.ts +28 -0
- package/types/src/shape/ShapeKind.d.ts +7 -0
- package/types/src/shape/ShapeSVG.d.ts +22 -0
- package/types/src/shape/ShapeText.d.ts +17 -0
- package/types/src/shape/icons/ShapeIcons.d.ts +16 -0
- package/types/src/shape/icons/_ShapeIconPack.d.ts +4 -0
- package/types/src/shape/index.d.ts +3 -1
- package/types/src/shape/shapeFrame.d.ts +50 -0
- package/types/src/shape/shapeStyle.d.ts +82 -0
- package/types/src/sheet/ISheetHeaderElement.d.ts +3 -3
- package/types/src/sheet/IWorksheetElement.d.ts +289 -0
- package/types/src/sheet/OpaqueSheetElement.d.ts +21 -0
- package/types/src/sheet/SheetCommandProvider.d.ts +14 -6
- package/types/src/sheet/SheetCommands.d.ts +18 -3
- package/types/src/sheet/SheetKindIcon.d.ts +14 -0
- package/types/src/sheet/SheetOutlineElement.d.ts +70 -0
- package/types/src/sheet/SheetPanels.d.ts +11 -0
- package/types/src/sheet/SheetScrollbar.d.ts +4 -13
- package/types/src/sheet/TopLeftCorner.d.ts +2 -2
- package/types/src/sheet/WorksheetElement.d.ts +12 -0
- package/types/src/sheet/_freezeAt.d.ts +10 -0
- package/types/src/sheet/_hyperlinkEdit.d.ts +7 -0
- package/types/src/sheet/_useHeaderMetrics.d.ts +11 -0
- package/types/src/sheet/circularReferences.d.ts +4 -4
- package/types/src/sheet/index.d.ts +5 -2
- package/types/src/sheet/useCycleHighlight.d.ts +2 -2
- package/types/src/slicer/SlicerCommands.d.ts +10 -0
- package/types/src/slicer/SlicerEditor.d.ts +8 -2
- package/types/src/slicer/SlicerKind.d.ts +7 -0
- package/types/src/slicer/SlicerStylePreview.d.ts +18 -0
- package/types/src/slicer/index.d.ts +2 -1
- package/types/src/slicer/slicerStyles.d.ts +32 -0
- package/types/src/sparkline/PictureCache.d.ts +37 -0
- package/types/src/sparkline/SparklineCommands.d.ts +23 -0
- package/types/src/sparkline/SparklinePictures.d.ts +7 -0
- package/types/src/sparkline/paint/_drawing.d.ts +24 -0
- package/types/src/sparkline/paint/echarts.d.ts +8 -0
- package/types/src/sparkline/paint/index.d.ts +8 -0
- package/types/src/tabStrip/SheetTab.d.ts +1 -1
- package/types/src/tabStrip/Sortable.d.ts +5 -5
- package/types/src/tabStrip/TabStrip.d.ts +13 -6
- package/types/src/tabStrip/TabStripItem.d.ts +15 -13
- package/types/src/table/TableCommands.d.ts +2 -2
- package/types/src/taskPane/CellControlPane.d.ts +15 -0
- package/types/src/taskPane/MovablePane.d.ts +15 -0
- package/types/src/taskPane/TaskPaneArea.d.ts +7 -0
- package/types/src/taskPane/TaskPaneFrame.d.ts +4 -4
- package/types/src/taskPane/TaskPaneKeys.d.ts +38 -0
- package/types/src/taskPane/TaskPaneRegistry.d.ts +32 -12
- package/types/src/taskPane/_paneReasons.d.ts +7 -0
- package/types/src/taskPane/index.d.ts +3 -0
- package/types/src/taskPane/useTaskPane.d.ts +6 -3
- package/types/src/theme/ExplicitTokens.d.ts +18 -0
- package/types/src/theme/GridColorSchemeContext.d.ts +8 -0
- package/types/src/theme/ThemeRootStyles.d.ts +31 -0
- package/types/src/theme/ThemeState.d.ts +2 -2
- package/types/src/theme/buildDocThemeCSS.d.ts +4 -1
- package/types/src/theme/buildOOXMLThemeCSS.d.ts +2 -2
- package/types/src/theme/buildTokensCSS.d.ts +15 -0
- package/types/src/theme/index.d.ts +2 -4
- package/types/src/theme/useAppColorScheme.d.ts +4 -1
- package/types/src/theme/useGridColorScheme.d.ts +9 -4
- package/types/src/theme/useSystemColors.d.ts +1 -15
- package/types/src/workbook/DefaultMovableRenderers.d.ts +20 -0
- package/types/src/workbook/DefaultRenderers.d.ts +5 -4
- package/types/src/workbook/IWorkbookElement.d.ts +176 -30
- package/types/src/workbook/WorkbookCommands.d.ts +6 -1
- package/types/src/workbook/WorkbookStrip.d.ts +14 -5
- package/browser/cjs/Bo9Kx3L_XQkGPBJ5.cjs +0 -1
- package/browser/cjs/Pl04-kDEQSO8_qFU.cjs +0 -156
- package/browser/cjs/index.cjs +0 -42
- package/browser/esm/CwXbsCWTrl3QB1t6.mjs +0 -6286
- package/node/esm/CZc8rKcLzArmqJz2.mjs +0 -9
- package/types/src/chart/templates/area-stacked-percent-template.json.d.ts +0 -10
- package/types/src/chart/templates/area-stacked-template.json.d.ts +0 -10
- package/types/src/chart/templates/area-template.json.d.ts +0 -9
- package/types/src/chart/templates/bar-stacked-percent-template.json.d.ts +0 -10
- package/types/src/chart/templates/bar-stacked-template.json.d.ts +0 -10
- package/types/src/chart/templates/bar-template.json.d.ts +0 -9
- package/types/src/chart/templates/column-stacked-percent-template.json.d.ts +0 -10
- package/types/src/chart/templates/column-stacked-template.json.d.ts +0 -10
- package/types/src/chart/templates/column-template.json.d.ts +0 -9
- package/types/src/chart/templates/line-markers-template.json.d.ts +0 -10
- package/types/src/chart/templates/line-stacked-markers-template.json.d.ts +0 -11
- package/types/src/chart/templates/line-stacked-percent-markers-template.json.d.ts +0 -11
- package/types/src/chart/templates/line-stacked-percent-template.json.d.ts +0 -10
- package/types/src/chart/templates/line-stacked-template.json.d.ts +0 -10
- package/types/src/chart/templates/line-template.json.d.ts +0 -9
- package/types/src/chart/templates/pie-doughnut-template.json.d.ts +0 -10
- package/types/src/chart/templates/pie-template.json.d.ts +0 -9
- package/types/src/chart/templates/scatter-lines-markers-smooth-template.json.d.ts +0 -10
- package/types/src/chart/templates/scatter-lines-markers-template.json.d.ts +0 -10
- package/types/src/chart/templates/scatter-lines-smooth-template.json.d.ts +0 -10
- package/types/src/chart/templates/scatter-lines-template.json.d.ts +0 -10
- package/types/src/chart/templates/scatter-markers-template.json.d.ts +0 -10
- package/types/src/context/SheetContext.d.ts +0 -18
- package/types/src/movable/MoveableBundle.d.ts +0 -4
- package/types/src/sheet/ISheetElement.d.ts +0 -258
- package/types/src/sheet/SheetElement.d.ts +0 -15
|
@@ -1,7 +1,8 @@
|
|
|
1
1
|
import { default as React } from 'react';
|
|
2
2
|
import { CellCoords, RangeCoords } from '@sheetxl/utils';
|
|
3
|
-
import {
|
|
4
|
-
import { LayerProps } from '@sheetxl/grid-react';
|
|
3
|
+
import { IDataValidation, IWorksheet } from '@sheetxl/sdk';
|
|
4
|
+
import { IEditable, LayerProps } from '@sheetxl/grid-react';
|
|
5
|
+
import { ValidationAlert } from '../editor/validationAlert';
|
|
5
6
|
/** The prompt a cell shows: the rule's title and message, and the range it hangs under. */
|
|
6
7
|
export interface ValidationPrompt {
|
|
7
8
|
/** The cell, or the merge it anchors. */
|
|
@@ -15,32 +16,62 @@ export interface ValidationPrompt {
|
|
|
15
16
|
}
|
|
16
17
|
/**
|
|
17
18
|
* The input prompt for the cell at `coords`: from the first covering rule, by priority, that shows
|
|
18
|
-
* a prompt and has a title or a message to show. `null` when none does
|
|
19
|
+
* a prompt and has a title or a message to show. `null` when none does, or when the sheet disables
|
|
20
|
+
* prompts.
|
|
19
21
|
*/
|
|
20
|
-
export declare const findValidationPrompt: (sheet:
|
|
22
|
+
export declare const findValidationPrompt: (sheet: IWorksheet, coords: CellCoords) => ValidationPrompt | null;
|
|
21
23
|
export interface ValidationPromptLayerProps extends Omit<LayerProps, 'children'> {
|
|
22
|
-
/** Class for the floated
|
|
24
|
+
/** Class for the floated container. */
|
|
23
25
|
className?: string;
|
|
24
|
-
/** Style for the floated
|
|
26
|
+
/** Style for the floated container. */
|
|
25
27
|
style?: React.CSSProperties;
|
|
26
|
-
/** The sheet whose selection is followed. */
|
|
27
|
-
sheet:
|
|
28
|
-
/**
|
|
28
|
+
/** The sheet whose selection is followed, and whose entries are checked. */
|
|
29
|
+
sheet: IWorksheet;
|
|
30
|
+
/**
|
|
31
|
+
* The editable entries are typed through. It tells an alert on an open edit, which stays while
|
|
32
|
+
* the edit does, from one left behind, which the next key or press clears.
|
|
33
|
+
*/
|
|
34
|
+
editable?: IEditable<any, string, any> | null;
|
|
35
|
+
/** Gap (px) between the cell and the float, below it and past its right edge. @defaultValue 6 */
|
|
29
36
|
offset?: number;
|
|
30
37
|
/**
|
|
31
38
|
* Render the prompt yourself. Spread `floatProps` on the returned element. Omit for the default
|
|
32
|
-
* box: the title in bold over the message.
|
|
39
|
+
* box: the title in bold over the message; `null` for none.
|
|
40
|
+
*/
|
|
41
|
+
renderPrompt?: ((props: ValidationPromptRenderProps) => React.ReactNode) | null;
|
|
42
|
+
/**
|
|
43
|
+
* Render the alert yourself. Spread `floatProps` on the returned element. Omit for the default
|
|
44
|
+
* card: the rule's alert title and message, and what to do next; `null` for none.
|
|
33
45
|
*/
|
|
34
|
-
|
|
46
|
+
renderAlert?: ((props: ValidationAlertRenderProps) => React.ReactNode) | null;
|
|
47
|
+
}
|
|
48
|
+
/** What {@link ValidationPromptLayerProps.renderPrompt} is handed. */
|
|
49
|
+
export interface ValidationPromptRenderProps {
|
|
50
|
+
prompt: ValidationPrompt;
|
|
51
|
+
/** Spread on the returned element: its placement and pointer handling. */
|
|
52
|
+
floatProps: React.HTMLAttributes<HTMLElement>;
|
|
53
|
+
}
|
|
54
|
+
/** What {@link ValidationPromptLayerProps.renderAlert} is handed. */
|
|
55
|
+
export interface ValidationAlertRenderProps {
|
|
56
|
+
alert: ValidationAlert;
|
|
57
|
+
/** Spread on the returned element: its placement and pointer handling. */
|
|
58
|
+
floatProps: React.HTMLAttributes<HTMLElement>;
|
|
35
59
|
}
|
|
36
60
|
/**
|
|
37
|
-
* The **input prompt** of a data validation
|
|
38
|
-
*
|
|
61
|
+
* The **input prompt** of a data validation, and the **alert** an entry raised in its place — one
|
|
62
|
+
* {@link RangeFloatLayer} at the cell-tip placement the error tips use: under the active cell (or
|
|
63
|
+
* its merge), starting just past its right edge.
|
|
39
64
|
*
|
|
40
65
|
* @remarks
|
|
41
|
-
*
|
|
42
|
-
* ({@link findValidationPrompt}). It stays while the cell is being
|
|
43
|
-
* aside while the list picker is open, since the
|
|
66
|
+
* At rest the float follows the selection and shows the title and message of the first covering
|
|
67
|
+
* rule that has a prompt to show ({@link findValidationPrompt}). It stays while the cell is being
|
|
68
|
+
* edited, as Excel's does, and steps aside while the list picker is open, since the picker drops
|
|
69
|
+
* under the same edge.
|
|
70
|
+
*
|
|
71
|
+
* An alert the entry check raised (`ValidationAlert`) takes the float over: Excel's alert dialog in
|
|
72
|
+
* tip form. A Stop keeps the edit open and the tip with it; a Warning's tip asks for Enter again; an
|
|
73
|
+
* Information entry is written and its tip stays until the next key or press. The prompt returns
|
|
74
|
+
* when the alert clears.
|
|
44
75
|
*/
|
|
45
76
|
export declare const ValidationPromptLayer: React.MemoExoticComponent<(props: ValidationPromptLayerProps) => React.JSX.Element>;
|
|
46
77
|
//# sourceMappingURL=ValidationPromptLayer.d.ts.map
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
import { IBorders, ICell, IRange } from '@sheetxl/sdk';
|
|
2
|
+
/** The borders a visible cell draws. */
|
|
3
|
+
export declare const getSheetBorderAt: (value: ICell, _index: number) => IBorders;
|
|
4
|
+
/** A merged cell's extrusion is its merge (merged cells never overflow); `null` when not merged. */
|
|
5
|
+
export declare const getSheetMergeAt: (value: ICell, _index: number) => IRange.Coords | null;
|
|
6
|
+
//# sourceMappingURL=_sheetBorders.d.ts.map
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
import { IWorksheet, ITable, IPivotTable, ITableStyle } from '@sheetxl/sdk';
|
|
2
|
+
/** A table style's theme color (header fill / whole-table top border) as CSS; `null` when it has none. */
|
|
3
|
+
export declare const tableStyleColor: (style: ITableStyle | null, sheet: IWorksheet) => string | null;
|
|
4
|
+
/** A table's or pivot table's theme color (header fill / whole-table top border) as CSS; grey when its style has none. */
|
|
5
|
+
export declare const tableLabelColor: (table: Pick<ITable, "getStyle"> | Pick<IPivotTable, "getStyle">, sheet: IWorksheet) => string;
|
|
6
|
+
//# sourceMappingURL=_tableColor.d.ts.map
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
import { ICellRange } from '@sheetxl/sdk';
|
|
2
|
+
/**
|
|
3
|
+
* Every feature a blank cell can be painted through, for the visible-cell scans.
|
|
4
|
+
*
|
|
5
|
+
* @remarks
|
|
6
|
+
* Naming them is what visits blanks at all. The list is the whole cell state, not what the layer
|
|
7
|
+
* draws: per-cell style resolution composes table and named styles through the full intersection,
|
|
8
|
+
* so a partial list breaks effective styles.
|
|
9
|
+
*/
|
|
10
|
+
export declare const VisibleCellFeatures: readonly ICellRange.Feature[];
|
|
11
|
+
//# sourceMappingURL=_visibleCellFeatures.d.ts.map
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import { RangeCoords } from '@sheetxl/utils';
|
|
2
|
+
import { GridPlacement, IGridPane } from '@sheetxl/grid-react';
|
|
3
|
+
/**
|
|
4
|
+
* Where a cell's tips hang: the input prompt, and the hover tip on an error, a warning or a failed
|
|
5
|
+
* validation alike. Below the cell, starting just past its right edge (under a dropdown button), so
|
|
6
|
+
* the cell and the one below it stay in view. Flip and shift apply as to any grid float.
|
|
7
|
+
*/
|
|
8
|
+
export declare const CELL_TIP_PLACEMENT: GridPlacement;
|
|
9
|
+
/** Gap (px) between a cell and its tip, below it and past its right edge alike. */
|
|
10
|
+
export declare const CELL_TIP_GAP = 6;
|
|
11
|
+
/** The align offset that starts a tip `gap` past the right edge of `range`. */
|
|
12
|
+
export declare const cellTipAlignOffset: (pane: IGridPane, range: RangeCoords, gap?: number) => number;
|
|
13
|
+
//# sourceMappingURL=cellTip.d.ts.map
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
import { IRange } from '@sheetxl/sdk';
|
|
2
|
+
import { FreezeDragPosition } from '@sheetxl/grid-react';
|
|
3
|
+
/**
|
|
4
|
+
* The transient state of an in-progress freeze drag, published by the producer
|
|
5
|
+
* (the freeze grips, through {@link useFreezeDrag}) and read by {@link FreezeDragLines} in both the
|
|
6
|
+
* header and the main grid.
|
|
7
|
+
*
|
|
8
|
+
* It rides `useSurfaceState` under {@link freezeDragKey}. `null` means no freeze drag is active for that
|
|
9
|
+
* axis.
|
|
10
|
+
*/
|
|
11
|
+
export type FreezeDragState = FreezeDragPosition;
|
|
12
|
+
/**
|
|
13
|
+
* The `useSurfaceState` key for the freeze drag, namespaced by axis.
|
|
14
|
+
*/
|
|
15
|
+
export declare const freezeDragKey: (axis: IRange.Axis) => string;
|
|
16
|
+
/**
|
|
17
|
+
* The `useSurfaceState` key for whether an axis's freeze grip is active (hovered or dragging) — the sheet
|
|
18
|
+
* highlights its freeze line while it is. A boolean; `false` when never written.
|
|
19
|
+
*/
|
|
20
|
+
export declare const freezeActiveKey: (axis: IRange.Axis) => string;
|
|
21
|
+
//# sourceMappingURL=freezeDragState.d.ts.map
|
|
@@ -4,29 +4,44 @@ export * from './useSheetFeatureRegions';
|
|
|
4
4
|
export * from './useSheetVisibleDecorations';
|
|
5
5
|
export * from './CellFillLayer';
|
|
6
6
|
export * from './CellErrorLayer';
|
|
7
|
+
export * from './HyperlinkLayer';
|
|
7
8
|
export * from './BorderLayer';
|
|
8
9
|
export * from './SheetCellLayer';
|
|
9
10
|
export * from './SheetColumnButtonLayer';
|
|
11
|
+
export * from './PivotLayer';
|
|
12
|
+
export * from './PivotToolbar';
|
|
10
13
|
export * from './SheetGridLineLayer';
|
|
11
14
|
export * from './SheetBackgroundLayer';
|
|
12
15
|
export * from './SheetHeaderCellLayer';
|
|
16
|
+
export * from './SheetOutlineLayer';
|
|
13
17
|
export * from './SheetMovableLayer';
|
|
14
18
|
export * from './TableLayer';
|
|
19
|
+
export * from './TableToolbar';
|
|
15
20
|
export * from './SheetTableCommandLayer';
|
|
21
|
+
export * from './SheetSparklineCommandLayer';
|
|
22
|
+
export * from './SheetPivotCommandLayer';
|
|
16
23
|
export * from './SpillLayer';
|
|
17
24
|
export * from './ConditionalIcons';
|
|
18
25
|
export * from './ConditionalBarLayer';
|
|
19
26
|
export * from './ConditionalIconsLayer';
|
|
27
|
+
export * from './SparklineLayer';
|
|
20
28
|
export * from './ValidationIndicatorLayer';
|
|
21
29
|
export * from './ValidationDropdownLayer';
|
|
22
30
|
export * from './ValidationPromptLayer';
|
|
23
31
|
export * from './useValidationPicker';
|
|
24
32
|
export * from './CircularIndicatorLayer';
|
|
33
|
+
export * from './CellIndicatorLayer';
|
|
25
34
|
export * from './CommentsLayer';
|
|
26
35
|
export * from './CommentCardLayer';
|
|
36
|
+
export * from './SheetLayers';
|
|
37
|
+
export * from './CellInsertLayer';
|
|
27
38
|
export * from './ProtectionLayer';
|
|
28
39
|
export * from './HeaderSelectionLayer';
|
|
29
40
|
export * from './HeaderResizerLayer';
|
|
30
41
|
export * from './ResizeIndicator';
|
|
42
|
+
export * from './HeaderFreezeLayer';
|
|
43
|
+
export * from './GridFreezeLayer';
|
|
44
|
+
export * from './FreezeDragLines';
|
|
45
|
+
export * from './freezeDragState';
|
|
31
46
|
export * from './ContextMenuLayer';
|
|
32
47
|
//# sourceMappingURL=index.d.ts.map
|
|
@@ -12,7 +12,9 @@ export interface ResizeIndicatorState {
|
|
|
12
12
|
/** The index of the header (column or row) being resized. */
|
|
13
13
|
index: number;
|
|
14
14
|
/**
|
|
15
|
-
* Live size
|
|
15
|
+
* Live size of the header during the gesture, in on-screen (zoomed) pixels — `prevSize` at start, the
|
|
16
|
+
* dragged size while moving. The model has not announced the new size yet, so the overlay draws the
|
|
17
|
+
* header's far edge from this rather than from the grid's metrics.
|
|
16
18
|
* `0` ⇒ the header is (being) hidden (draw a single collapsed line, tooltip reads "Hidden").
|
|
17
19
|
* `null` ⇒ draw the guide-lines only, with no size tooltip (e.g. a press-and-hold before any drag).
|
|
18
20
|
*/
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import { IWorksheet, IRange } from '@sheetxl/sdk';
|
|
2
|
+
import { FreezeDragPosition } from '@sheetxl/grid-react';
|
|
3
|
+
export interface FreezeDrag {
|
|
4
|
+
disabled: boolean;
|
|
5
|
+
/** Whether a grip on this axis (header or body) is hovered or dragging. */
|
|
6
|
+
isActive: boolean;
|
|
7
|
+
onFreezeDragStart: (position: FreezeDragPosition) => void;
|
|
8
|
+
onFreezeDrag: (position: FreezeDragPosition) => void;
|
|
9
|
+
onFreezeDragEnd: (position: FreezeDragPosition) => void;
|
|
10
|
+
onFreezeDragCancel: () => void;
|
|
11
|
+
onActiveChange: (active: boolean) => void;
|
|
12
|
+
}
|
|
13
|
+
/**
|
|
14
|
+
* Wires a freeze grip on one axis to the sheet: publishes the drag for {@link FreezeDragLines}, commits the
|
|
15
|
+
* drop through `freezePanesAt`, and works out whether a drag is allowed right now.
|
|
16
|
+
*
|
|
17
|
+
* @remarks
|
|
18
|
+
* The drag is allowed only when the scrolling area starts exactly at the freeze — otherwise the frozen
|
|
19
|
+
* and scrolling areas are not contiguous and a drop could not land where it was let go.
|
|
20
|
+
*/
|
|
21
|
+
export declare const useFreezeDrag: (sheet: IWorksheet, axis: IRange.Axis) => FreezeDrag;
|
|
22
|
+
//# sourceMappingURL=useFreezeDrag.d.ts.map
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import { IWorksheet } from '@sheetxl/sdk';
|
|
2
|
+
import { BorderNormalLine } from '../border';
|
|
3
|
+
/**
|
|
4
|
+
* The Normal style's border as one line per axis — a border on every cell, blank ones included.
|
|
5
|
+
*
|
|
6
|
+
* @remarks
|
|
7
|
+
* A boundary is the trailing edge of one cell and the leading edge of the next; the Normal style's
|
|
8
|
+
* two edges meet there and the one Excel draws wins. `null` on an axis with no Normal border.
|
|
9
|
+
* Identity is stable while the resolved style is. The caller re-renders on `onStyleChange`.
|
|
10
|
+
*/
|
|
11
|
+
export declare const useNormalBorderLines: (sheet: IWorksheet) => {
|
|
12
|
+
rows: BorderNormalLine | null;
|
|
13
|
+
columns: BorderNormalLine | null;
|
|
14
|
+
};
|
|
15
|
+
//# sourceMappingURL=useNormalBorderLines.d.ts.map
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { ICellRange, ICellRegion, IRange,
|
|
1
|
+
import { ICellRange, ICellRegion, IRange, IWorksheet } from '@sheetxl/sdk';
|
|
2
2
|
import { IGridPane } from '@sheetxl/grid-react';
|
|
3
3
|
export interface SheetFeatureRegions {
|
|
4
4
|
/** The viewport's regions for the feature — engine-merged blocks, ready to place. */
|
|
@@ -17,5 +17,5 @@ export interface SheetFeatureRegions {
|
|
|
17
17
|
* {@link useSheetVisibleCells}'s shape — per-pane, cached by range key, token-invalidated — so
|
|
18
18
|
* layers can swap sources without changing their contract.
|
|
19
19
|
*/
|
|
20
|
-
export declare const useSheetFeatureRegions: (sheet:
|
|
20
|
+
export declare const useSheetFeatureRegions: (sheet: IWorksheet, feature: ICellRange.Feature) => SheetFeatureRegions;
|
|
21
21
|
//# sourceMappingURL=useSheetFeatureRegions.d.ts.map
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { IWorksheet, ICell, IRange } from '@sheetxl/sdk';
|
|
2
2
|
import { IGridPane } from '@sheetxl/grid-react';
|
|
3
3
|
export type SheetVisibleCell = {
|
|
4
4
|
cell: ICell.Coords;
|
|
@@ -8,12 +8,12 @@ export type SheetVisibleCell = {
|
|
|
8
8
|
/**
|
|
9
9
|
* What the scan should treat as "worth rendering". Each layer passes ONLY the flags its own output
|
|
10
10
|
* depends on — a flag change busts this hook's scan cache + token, so an unused flag would rebuild
|
|
11
|
-
* the caller for nothing (e.g.
|
|
11
|
+
* the caller for nothing (e.g. a layer that ignores zeros must not rebuild on a show-zeros toggle).
|
|
12
12
|
*/
|
|
13
13
|
export interface SheetVisibleCellsOptions {
|
|
14
14
|
/**
|
|
15
15
|
* Formula view: formula-only cells render (even valueless), and text-overflow extrusions are
|
|
16
|
-
* disabled (formulas never overflow-paint). Affects cells
|
|
16
|
+
* disabled (formulas never overflow-paint). Affects the cells and their extrusions.
|
|
17
17
|
* @defaultValue false
|
|
18
18
|
*/
|
|
19
19
|
showFormulas?: boolean;
|
|
@@ -53,8 +53,7 @@ export interface SheetVisibleCells {
|
|
|
53
53
|
* source flags change (e.g. `useModelSync(sheetView, ['onZoomScaleChange'])` — the view's setters all
|
|
54
54
|
* funnel through `_notifyAll`, which fires that event). Each caller (one per layer per pane) gets its
|
|
55
55
|
* OWN cache + subscription — the layers are deliberately decoupled, so a value edit re-renders only the
|
|
56
|
-
* layer(s) that asked, never the grid above them. Used by {@link SheetCellLayer}
|
|
57
|
-
* {@link SheetGridLineLayer}.
|
|
56
|
+
* layer(s) that asked, never the grid above them. Used by {@link SheetCellLayer}.
|
|
58
57
|
*/
|
|
59
|
-
export declare const useSheetVisibleCells: (sheet:
|
|
58
|
+
export declare const useSheetVisibleCells: (sheet: IWorksheet, options?: SheetVisibleCellsOptions) => SheetVisibleCells;
|
|
60
59
|
//# sourceMappingURL=useSheetVisibleCells.d.ts.map
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { IWorksheet, ICell, IRange, IConditionalFormat } from '@sheetxl/sdk';
|
|
2
2
|
import { IGridPane } from '@sheetxl/grid-react';
|
|
3
3
|
/** One visible cell a conditional-format rule DRAWS in. */
|
|
4
4
|
export interface SheetDecoratedCell {
|
|
@@ -38,5 +38,5 @@ export interface SheetVisibleDecorations {
|
|
|
38
38
|
* (`onConditionalFormatsChange`), or a value moves within a rule's range — which can restripe every
|
|
39
39
|
* cell the rule covers, not just the edited one, because the domain is range-wide.
|
|
40
40
|
*/
|
|
41
|
-
export declare const useSheetVisibleDecorations: (sheet:
|
|
41
|
+
export declare const useSheetVisibleDecorations: (sheet: IWorksheet, kind: SheetDecorationKind) => SheetVisibleDecorations;
|
|
42
42
|
//# sourceMappingURL=useSheetVisibleDecorations.d.ts.map
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { IWorksheet } from '@sheetxl/sdk';
|
|
2
2
|
import { SheetVisibleCells } from './useSheetVisibleCells';
|
|
3
3
|
/**
|
|
4
4
|
* The "which cells host a column (filter/sort) button" source for a single pane, plus
|
|
@@ -18,5 +18,5 @@ import { SheetVisibleCells } from './useSheetVisibleCells';
|
|
|
18
18
|
* table add/remove/auto-table/layout/undo (sheet events) and hidden-button / show-headers / column
|
|
19
19
|
* add-remove / resize (which fire `onAnyChange` on the TABLE, so we subscribe to each table too).
|
|
20
20
|
*/
|
|
21
|
-
export declare const useTableHeaderCells: (sheet:
|
|
21
|
+
export declare const useTableHeaderCells: (sheet: IWorksheet) => SheetVisibleCells;
|
|
22
22
|
//# sourceMappingURL=useTableHeaderCells.d.ts.map
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { CellCoords } from '@sheetxl/utils';
|
|
2
|
-
import {
|
|
2
|
+
import { IWorksheet, IDataValidation } from '@sheetxl/sdk';
|
|
3
3
|
import { GridAnchor, IEditable } from '@sheetxl/grid-react';
|
|
4
4
|
import { CellPicker } from '../picker';
|
|
5
5
|
/**
|
|
@@ -8,7 +8,7 @@ import { CellPicker } from '../picker';
|
|
|
8
8
|
*/
|
|
9
9
|
export interface ValidationPickerOptions {
|
|
10
10
|
/** The sheet the chosen value is written to. */
|
|
11
|
-
sheet:
|
|
11
|
+
sheet: IWorksheet;
|
|
12
12
|
/**
|
|
13
13
|
* The editable the pick is entered through — the same path as typing the item's text, so the value
|
|
14
14
|
* coerces and formats as a typed one does. `null` offers nothing.
|
|
@@ -48,7 +48,7 @@ export declare const resolveListPickerItems: (rules: readonly IDataValidation[],
|
|
|
48
48
|
*
|
|
49
49
|
* @remarks
|
|
50
50
|
* No search field: a validation list is a short set of choices, and narrowing it belongs to the cell
|
|
51
|
-
* editor's typing
|
|
51
|
+
* editor's typing.
|
|
52
52
|
*/
|
|
53
53
|
export declare const useValidationPicker: (options: ValidationPickerOptions) => CellPicker;
|
|
54
54
|
//# sourceMappingURL=useValidationPicker.d.ts.map
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { IWorksheet, ITable } from '@sheetxl/sdk';
|
|
2
2
|
export interface VisibleTables {
|
|
3
3
|
/** The tables intersecting this pane's visible range (empty array — stable identity — when none). */
|
|
4
4
|
visibleTables: readonly ITable[];
|
|
@@ -23,5 +23,5 @@ export interface VisibleTables {
|
|
|
23
23
|
* PLUS each visible table's `onAnyChange` — table mutations (hidden-button toggle, show-headers, column
|
|
24
24
|
* add/remove, resize) fire on the TABLE, not the sheet.
|
|
25
25
|
*/
|
|
26
|
-
export declare const useVisibleTables: (sheet:
|
|
26
|
+
export declare const useVisibleTables: (sheet: IWorksheet) => VisibleTables;
|
|
27
27
|
//# sourceMappingURL=useVisibleTables.d.ts.map
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { CellCoords, RangeCoords } from '@sheetxl/utils';
|
|
2
|
-
import { IDataValidation,
|
|
2
|
+
import { IDataValidation, IWorksheet } from '@sheetxl/sdk';
|
|
3
3
|
import { VisibleCell } from '@sheetxl/grid-react';
|
|
4
4
|
/**
|
|
5
5
|
* How a cell's value fails its data validations: `'failed'` when every failing rule raises no
|
|
@@ -38,7 +38,7 @@ export declare const resolveValidationMark: (rules: readonly IDataValidation[],
|
|
|
38
38
|
* Only cells holding a value are visited, unless a rule has Ignore blank off: an empty cell can fail
|
|
39
39
|
* that one, so the window's empty cells are visited too — bounded by the window, as painting is.
|
|
40
40
|
*/
|
|
41
|
-
export declare const findVisibleValidationMarks: (sheet:
|
|
41
|
+
export declare const findVisibleValidationMarks: (sheet: IWorksheet, coords: RangeCoords) => VisibleCell[];
|
|
42
42
|
/**
|
|
43
43
|
* What the hover tip over a cell's invalid-value mark says.
|
|
44
44
|
*/
|
|
@@ -55,7 +55,7 @@ export interface ValidationTip {
|
|
|
55
55
|
* (Show Invalid off), the value passes, or the cell is the active one and its input prompt is
|
|
56
56
|
* already saying what it wants.
|
|
57
57
|
*/
|
|
58
|
-
export declare const findValidationTip: (sheet:
|
|
58
|
+
export declare const findValidationTip: (sheet: IWorksheet, coords: CellCoords) => ValidationTip | null;
|
|
59
59
|
/** The color a mark is drawn in, per state: the theme's severity colors, neutral for no alert. */
|
|
60
60
|
export declare const VALIDATION_MARK_COLORS: Record<ValidationMarkState, string>;
|
|
61
61
|
/** The glyph for each state (the Base icon pack), the same the rule editor shows for a style. */
|
|
@@ -1,3 +1,8 @@
|
|
|
1
1
|
export * from './useModelListener';
|
|
2
2
|
export * from './useRangeListener';
|
|
3
|
+
export * from './useCellRange';
|
|
4
|
+
export * from './useCellValue';
|
|
5
|
+
export * from './useCell';
|
|
6
|
+
export type { CellRangeTarget, CellRangeHookOptions } from './useRangeSnapshot';
|
|
7
|
+
export * from './useTable';
|
|
3
8
|
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
import { ICell, ICellRange } from '@sheetxl/sdk';
|
|
2
|
+
import { CellRangeTarget, CellRangeHookOptions } from './useRangeSnapshot';
|
|
3
|
+
/**
|
|
4
|
+
* Binds a single cell: returns a snapshot of it and an updater, and re-renders with a new snapshot when
|
|
5
|
+
* the cell changes.
|
|
6
|
+
*
|
|
7
|
+
* @param target The workbook or sheet to read from, or `null` while there is none.
|
|
8
|
+
* @param address The cell's address. A larger range binds its top-left cell.
|
|
9
|
+
* @param options Listener options, and an optional `onChange` that receives each change event.
|
|
10
|
+
* @returns The cell, or `null` while `target` is `null`, and an updater that does nothing until there
|
|
11
|
+
* is a target.
|
|
12
|
+
*
|
|
13
|
+
* @remarks
|
|
14
|
+
* The cell is a snapshot: it does not change after it is returned, so it is safe to compare or memoize
|
|
15
|
+
* on. Its formatted text, type, formula, and errors are all available alongside the value.
|
|
16
|
+
*
|
|
17
|
+
* The updater takes anything {@link ICellRange.updateCells} does: a value, a cell, or
|
|
18
|
+
* {@link ICell.Modifiers} such as `{ value, style }`. Text is parsed by default, so `'=SUM(A1:A3)'`
|
|
19
|
+
* becomes a formula; pass `{ textParser: false }` to store it as text. For a plain value, see
|
|
20
|
+
* {@link useCellValue}.
|
|
21
|
+
*
|
|
22
|
+
* @example
|
|
23
|
+
* ```tsx
|
|
24
|
+
* const [total] = useCell(sheet, 'D23');
|
|
25
|
+
* return <output>{total?.getText()}</output>;
|
|
26
|
+
* ```
|
|
27
|
+
*/
|
|
28
|
+
export declare const useCell: (target: CellRangeTarget | null | undefined, address: ICellRange.Address, options?: CellRangeHookOptions) => [ICell | null, (update: ICell.Update, options?: ICellRange.UpdateCellsOptions) => void];
|
|
29
|
+
//# sourceMappingURL=useCell.d.ts.map
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
import { ICellRange } from '@sheetxl/sdk';
|
|
2
|
+
import { CellRangeTarget, CellRangeHookOptions } from './useRangeSnapshot';
|
|
3
|
+
/**
|
|
4
|
+
* Returns the range at `address` and re-renders whenever anything in it changes: values (including
|
|
5
|
+
* recalculated formula results), styles, or its address.
|
|
6
|
+
*
|
|
7
|
+
* @param target The workbook or sheet to read from, or `null` while there is none.
|
|
8
|
+
* @param address The range's address. An object address is compared by identity, so keep it stable.
|
|
9
|
+
* @param options Listener options, and an optional `onChange` that receives each change event.
|
|
10
|
+
* @returns The range, or `null` while `target` is `null`.
|
|
11
|
+
*
|
|
12
|
+
* @remarks
|
|
13
|
+
* The returned range is the same object across renders; read from it during render. For a single
|
|
14
|
+
* value use {@link useCellValue}, and for a single cell's full state use {@link useCell}.
|
|
15
|
+
*
|
|
16
|
+
* @example
|
|
17
|
+
* ```tsx
|
|
18
|
+
* const items = useCellRange(sheet, 'A7:C18');
|
|
19
|
+
* const rows = items?.getValues() ?? [];
|
|
20
|
+
* ```
|
|
21
|
+
*/
|
|
22
|
+
export declare const useCellRange: (target: CellRangeTarget | null | undefined, address: ICellRange.Address, options?: CellRangeHookOptions) => ICellRange | null;
|
|
23
|
+
//# sourceMappingURL=useCellRange.d.ts.map
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
import { ICellRange, Scalar } from '@sheetxl/sdk';
|
|
2
|
+
import { CellRangeTarget, CellRangeHookOptions } from './useRangeSnapshot';
|
|
3
|
+
/**
|
|
4
|
+
* Binds a cell's value like `useState`: returns the value and a setter, and re-renders when the value
|
|
5
|
+
* changes, whether from the setter, the grid, or a recalculation.
|
|
6
|
+
*
|
|
7
|
+
* @template T The expected value type. This is not checked or converted: an empty cell is `null`, and a
|
|
8
|
+
* cell can hold any type.
|
|
9
|
+
* @param target The workbook or sheet to read from, or `null` while there is none.
|
|
10
|
+
* @param address The cell's address. A larger range binds its top-left cell.
|
|
11
|
+
* @param options Listener options, and an optional `onChange` that receives each change event.
|
|
12
|
+
* @returns The value, or `null` while `target` is `null`, and a setter that does nothing until there
|
|
13
|
+
* is a target.
|
|
14
|
+
*
|
|
15
|
+
* @remarks
|
|
16
|
+
* The setter writes the value as-is: text is never parsed, so `'=1+1'` is stored as text rather than as
|
|
17
|
+
* a formula. To write formulas or styles, use {@link useCell}.
|
|
18
|
+
*
|
|
19
|
+
* @example
|
|
20
|
+
* ```tsx
|
|
21
|
+
* const [customer, setCustomer] = useCellValue<string>(sheet, 'A4');
|
|
22
|
+
* return <input value={customer ?? ''} onChange={(e) => setCustomer(e.target.value)} />;
|
|
23
|
+
* ```
|
|
24
|
+
*/
|
|
25
|
+
export declare const useCellValue: <T extends Scalar = Scalar>(target: CellRangeTarget | null | undefined, address: ICellRange.Address, options?: CellRangeHookOptions) => [T | null, (value: T | null) => void];
|
|
26
|
+
//# sourceMappingURL=useCellValue.d.ts.map
|
|
@@ -25,8 +25,8 @@ export interface ModelListenerOptions extends Omit<IListener.Options, 'once'> {
|
|
|
25
25
|
/**
|
|
26
26
|
* React hook for subscribing to model-level events (workbooks, sheets, etc.).
|
|
27
27
|
*
|
|
28
|
-
* @template SOURCE - The model type (e.g., IWorkbook,
|
|
29
|
-
* @template EVENTS - The listener interface type (e.g.,
|
|
28
|
+
* @template SOURCE - The model type (e.g., IWorkbook, IWorksheet)
|
|
29
|
+
* @template EVENTS - The listener interface type (e.g., IWorksheet.IListeners)
|
|
30
30
|
*
|
|
31
31
|
* @param source - The model instance to listen to, or `null` to listen to nothing
|
|
32
32
|
* @param listeners - Object containing listener callbacks for various events
|
|
@@ -45,8 +45,8 @@ export interface ModelListenerOptions extends Omit<IListener.Options, 'once'> {
|
|
|
45
45
|
*
|
|
46
46
|
* @example
|
|
47
47
|
* ```tsx
|
|
48
|
-
* function SheetComponent({ sheet }: { sheet:
|
|
49
|
-
* useModelListener<
|
|
48
|
+
* function SheetComponent({ sheet }: { sheet: IWorksheet }) {
|
|
49
|
+
* useModelListener<IWorksheet, IWorksheet.IListeners>(sheet, {
|
|
50
50
|
* onSave(source, json) {
|
|
51
51
|
* console.log('Sheet saved:', json);
|
|
52
52
|
* },
|
|
@@ -1,15 +1,21 @@
|
|
|
1
1
|
import { ICellRange } from '@sheetxl/sdk';
|
|
2
|
-
export
|
|
3
|
-
fireOnAddressChange: boolean;
|
|
4
|
-
}
|
|
2
|
+
export type useRangeListenerOptions = ICellRange.ListenerOptions;
|
|
5
3
|
export interface RangeContainer {
|
|
6
4
|
getRange(address: ICellRange.Address, options?: ICellRange.GetRangeOptions): ICellRange;
|
|
7
5
|
}
|
|
8
6
|
/**
|
|
9
|
-
*
|
|
7
|
+
* Listen to a range of `model` for as long as the component is mounted.
|
|
8
|
+
*
|
|
9
|
+
* @param model What the range is read from: a workbook or a sheet.
|
|
10
|
+
* @param address The range to listen to. Nothing is listened to while it is `null`.
|
|
11
|
+
* @param listener Called with each {@link ICellRange.Event}. The latest render's listener is the
|
|
12
|
+
* one called, so it may close over state without re-subscribing.
|
|
13
|
+
* @param options Which events to hear and how the range follows inserts and deletes
|
|
14
|
+
* ({@link ICellRange.ListenerOptions}). Read once per subscription.
|
|
10
15
|
*
|
|
11
|
-
* @
|
|
12
|
-
*
|
|
16
|
+
* @remarks
|
|
17
|
+
* The subscription is renewed when `model` or `address` changes. Nothing is delivered for that
|
|
18
|
+
* renewal: the listener only hears what the range itself reports.
|
|
13
19
|
*/
|
|
14
|
-
export declare const useRangeListener: (model: RangeContainer, address: ICellRange.Address, listener: ICellRange.Listener, options?: useRangeListenerOptions) => void;
|
|
20
|
+
export declare const useRangeListener: (model: RangeContainer | null | undefined, address: ICellRange.Address | null | undefined, listener: ICellRange.Listener, options?: useRangeListenerOptions) => void;
|
|
15
21
|
//# sourceMappingURL=useRangeListener.d.ts.map
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
import { ICellRange, IWorkbook, IWorksheet } from '@sheetxl/sdk';
|
|
2
|
+
/**
|
|
3
|
+
* A workbook or a sheet: anything a range can be read from. A workbook address may be sheet-qualified
|
|
4
|
+
* (`'Invoice!A4'`); an unqualified one reads from the selected sheet.
|
|
5
|
+
*/
|
|
6
|
+
export type CellRangeTarget = IWorkbook | IWorksheet;
|
|
7
|
+
/**
|
|
8
|
+
* Options shared by the cell-binding hooks.
|
|
9
|
+
*/
|
|
10
|
+
export interface CellRangeHookOptions extends Omit<ICellRange.ListenerOptions, 'transactional'> {
|
|
11
|
+
/**
|
|
12
|
+
* Called with every change event the hook receives, before it re-renders.
|
|
13
|
+
*
|
|
14
|
+
* @remarks
|
|
15
|
+
* Uses the hook's own subscription. To receive events without re-rendering, use
|
|
16
|
+
* {@link useRangeListener} instead.
|
|
17
|
+
*/
|
|
18
|
+
onChange?: ICellRange.Listener;
|
|
19
|
+
}
|
|
20
|
+
/**
|
|
21
|
+
* Resolves `address` against `target` and returns the range with a value read from it. Both are
|
|
22
|
+
* re-read only after the range reports a change, so they are stable between changes, as
|
|
23
|
+
* `useSyncExternalStore` requires.
|
|
24
|
+
*
|
|
25
|
+
* @param topLeft Narrow the range to its top-left cell.
|
|
26
|
+
*
|
|
27
|
+
* @remarks
|
|
28
|
+
* The range follows its cells: when rows or columns are inserted or deleted around it (or undone),
|
|
29
|
+
* the returned range is the one at the new address, so a write goes where the cells went.
|
|
30
|
+
*/
|
|
31
|
+
export declare const useRangeSnapshot: <T>(target: CellRangeTarget | null | undefined, address: ICellRange.Address, topLeft: boolean, read: (range: ICellRange) => T, options?: CellRangeHookOptions) => {
|
|
32
|
+
range: ICellRange | null;
|
|
33
|
+
snapshot: T | null;
|
|
34
|
+
};
|
|
35
|
+
//# sourceMappingURL=useRangeSnapshot.d.ts.map
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
import { ITable } from '@sheetxl/sdk';
|
|
2
|
+
import { CellRangeTarget, CellRangeHookOptions } from './useRangeSnapshot';
|
|
3
|
+
/**
|
|
4
|
+
* Returns the table named `name` and re-renders when it changes: rows added or removed, its cells
|
|
5
|
+
* edited, or its settings changed.
|
|
6
|
+
*
|
|
7
|
+
* @param target The workbook or sheet to find the table in, or `null` while there is none. A workbook
|
|
8
|
+
* looks in each of its sheets.
|
|
9
|
+
* @param name The table's name.
|
|
10
|
+
* @param options Listener options for its cells, and an optional `onChange` that receives each change
|
|
11
|
+
* event in them.
|
|
12
|
+
* @returns The table, or `null` while `target` is `null` or has no table of that name.
|
|
13
|
+
*
|
|
14
|
+
* @remarks
|
|
15
|
+
* The returned table is the same object across renders; read from it during render, and change it
|
|
16
|
+
* through its own methods, such as {@link ITable.addRow} and {@link ITable.deleteRowsAt}.
|
|
17
|
+
*
|
|
18
|
+
* @example
|
|
19
|
+
* ```tsx
|
|
20
|
+
* const items = useTable(workbook, 'Items');
|
|
21
|
+
* const rows = items?.getDataRange().getValues() ?? [];
|
|
22
|
+
* return <button onClick={() => items?.addRow()}>Add</button>;
|
|
23
|
+
* ```
|
|
24
|
+
*/
|
|
25
|
+
export declare const useTable: (target: CellRangeTarget | null | undefined, name: string, options?: CellRangeHookOptions) => ITable | null;
|
|
26
|
+
//# sourceMappingURL=useTable.d.ts.map
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import { default as React } from 'react';
|
|
2
|
+
import { IMovableCollection } from '@sheetxl/sdk';
|
|
3
|
+
export interface ConnectionSitesProps {
|
|
4
|
+
/** The sheet's movables, every one of which may offer sites. */
|
|
5
|
+
movables: IMovableCollection;
|
|
6
|
+
/** The layer's extent, in pane px. */
|
|
7
|
+
width: number;
|
|
8
|
+
height: number;
|
|
9
|
+
}
|
|
10
|
+
/**
|
|
11
|
+
* The connection sites a dragged connector end may glue to, drawn over every movable on the
|
|
12
|
+
* sheet while an end is held (`movable-connect` surface state); the site the end would take is
|
|
13
|
+
* filled. Which movables offer sites, and where, is the model's (`IMovable.getConnectionSites`):
|
|
14
|
+
* a picture or a chart its four edges, a shape its geometry's, a group none. Drawn by the layer,
|
|
15
|
+
* not by each content's editor, so a content kind needs nothing of its own to be glued to.
|
|
16
|
+
*/
|
|
17
|
+
export declare const ConnectionSites: React.FC<ConnectionSitesProps>;
|
|
18
|
+
//# sourceMappingURL=ConnectionSites.d.ts.map
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
import { default as React } from 'react';
|
|
2
|
+
import { MovableElementProps } from './IMovableArea';
|
|
3
|
+
/**
|
|
4
|
+
* Renders a movable with the renderer for its kind of content, or a placeholder for a kind with
|
|
5
|
+
* none. The default `renderMovable` of a sheet element.
|
|
6
|
+
*/
|
|
7
|
+
export declare const defaultRenderMovable: (props: MovableElementProps) => React.ReactElement;
|
|
8
|
+
//# sourceMappingURL=DefaultMovable.d.ts.map
|