@sheetxl/react 0.8.0-beta.9 → 1.0.2
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/5B9ljQwRo4GZv5e3.mjs +264 -0
- package/browser/esm/B7K16Rzv-QXeNhTf.mjs +197 -0
- package/browser/esm/BD3e6d1xxwWiZvhM.mjs +78 -0
- package/browser/esm/{Dk6274Lic6AOmEAq.mjs → BIlvSwHzLhtyrkCm.mjs} +84 -2
- package/browser/esm/BTkVpKUjjBXs7S4h.mjs +128 -0
- package/browser/esm/B_X-eExTurXNj2s6.mjs +134 -0
- package/browser/esm/BaXKIZ-EbNXalsn9.mjs +32 -0
- package/browser/esm/ByiwVTu3Ax65JzsV.mjs +36 -0
- package/browser/esm/CBwGe_8NQ_Zwkd9c.mjs +67 -0
- package/browser/esm/CLM5O7S-zDkLuyx4.mjs +323 -0
- package/browser/esm/CN3fS0Je4N_gmPLR.mjs +145 -0
- package/browser/esm/Cb3fQ74AG3ha3Lbb.mjs +31 -0
- package/browser/esm/CyK8M1od0A1rs3IZ.mjs +14092 -0
- package/browser/esm/D-wXCKrEuZsj9YPV.mjs +60 -0
- package/browser/esm/D3h177x5aS9wsvay.mjs +8 -0
- package/browser/esm/DIle1Uzx1TRzW_kQ.mjs +42 -0
- package/browser/esm/DLCK6iNnpw8XUOy8.mjs +79 -0
- package/browser/esm/DS_YUf92NUAjr5M9.mjs +9560 -0
- package/browser/esm/DYLAfjgirgwGJkJo.mjs +20 -0
- package/browser/esm/D_KHWbW4C9PQ7G8l.mjs +401 -0
- package/browser/esm/DclFKNTfrIjTUqZW.mjs +341 -0
- package/browser/esm/DeZNNHG8-BP0qop0.mjs +323 -0
- package/browser/esm/WUqAXqTxytEPWXNZ.mjs +63 -0
- package/browser/esm/Xab6qjmPHkjnBlcs.mjs +45 -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 +21677 -15289
- package/browser/esm/note.mjs +112 -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/xismu7oIPMRpfRZN.mjs +19 -0
- package/licenses/dependencies.txt +327 -53
- package/node/esm/3O4W5uO7Ei1RSamd.mjs +328 -0
- package/node/esm/BEmcxv9Cg5uinTCr.mjs +80 -0
- package/node/esm/BWuHuJ2nm8MKaUpL.mjs +1697 -0
- package/node/esm/Bb39ZMFsvPRb6_sU.mjs +20 -0
- package/node/esm/Btwf2pH6R5DrzLlO.mjs +32 -0
- package/node/esm/C3_B2QUtmUAAoAbQ.mjs +37 -0
- package/node/esm/CIHXrDGerZpH_kWI.mjs +19 -0
- package/node/esm/CbEtd-l94dqcicGz.mjs +66 -0
- package/node/esm/D06Yw2XsMkKhhpbZ.mjs +406 -0
- package/node/esm/D6pwBrfHwDwzCkt6.mjs +128 -0
- package/node/esm/DKBxWraRN4fQGsFy.mjs +63 -0
- package/node/esm/DPp00qgyktTqWeEp.mjs +68 -0
- package/node/esm/Ddz6TmyZPfCk-PXM.mjs +134 -0
- package/node/esm/Djwke9rsxOR1tTNb.mjs +8 -0
- package/node/esm/DmdPWNpf3d05AFgU.mjs +80 -0
- package/node/esm/DsUEK1CBM3dZfY2X.mjs +198 -0
- package/node/esm/{B-5p0wwNM6Y5jlI2.mjs → DsgT7qY3nHxDGSws.mjs} +84 -2
- package/node/esm/L7XZPzd6aXI7OzdI.mjs +146 -0
- package/node/esm/X9lgoicxH_z9hlaw.mjs +45 -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 +16970 -10477
- package/node/esm/note.mjs +113 -0
- package/node/esm/oliuGGZGkPQdm6vE.mjs +35 -0
- package/node/esm/picture.mjs +326 -0
- package/node/esm/s7q4H_VlspTpP2kg.mjs +265 -0
- package/node/esm/shape.mjs +342 -0
- package/node/esm/slicer.mjs +284 -0
- package/package.json +56 -14
- 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 +169 -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 +353 -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 +170 -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 +195 -3
- 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 +4 -4
- 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 +9 -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 +44 -15
- 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 +8 -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 +74 -3
- package/types/src/group/GroupEditor.d.ts +25 -0
- package/types/src/index.d.ts +10 -2
- 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 +1 -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 +3 -3
- 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 +14 -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 +28 -0
- package/types/src/movable/MovableAdornment.d.ts +9 -3
- 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 +49 -1
- package/types/src/movable/MovableFrame.d.ts +5 -1
- package/types/src/movable/MovableLayer.d.ts +30 -5
- package/types/src/movable/MovableRenderers.d.ts +166 -11
- package/types/src/movable/PlaceholderFrames.d.ts +11 -0
- package/types/src/movable/RotateHandle.d.ts +12 -4
- package/types/src/movable/connect.d.ts +16 -0
- package/types/src/movable/framePlacement.d.ts +44 -1
- package/types/src/movable/geometry.d.ts +13 -3
- package/types/src/movable/index.d.ts +8 -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 +2 -3
- package/types/src/shape/ShapeGallery.d.ts +21 -6
- package/types/src/shape/ShapeKind.d.ts +7 -0
- package/types/src/shape/ShapeSVG.d.ts +6 -8
- package/types/src/shape/index.d.ts +0 -1
- package/types/src/shape/shapeFrame.d.ts +46 -2
- package/types/src/shape/shapeStyle.d.ts +59 -8
- package/types/src/sheet/ISheetHeaderElement.d.ts +3 -3
- package/types/src/sheet/{ISheetElement.d.ts → IWorksheetElement.d.ts} +110 -86
- 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 +6 -6
- 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 +19 -1
- 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/index.cjs +0 -43
- package/browser/cjs/xuAfpHmA2W4MFa_0.cjs +0 -1
- 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/control/index.d.ts +0 -2
- package/types/src/sheet/SheetElement.d.ts +0 -15
|
@@ -0,0 +1,180 @@
|
|
|
1
|
+
import { IWorkbook } from '@sheetxl/sdk';
|
|
2
|
+
/**
|
|
3
|
+
* What an annotation is for. The vocabulary of the MCP `highlight` tool, unchanged; any other string
|
|
4
|
+
* is accepted and styled by the host.
|
|
5
|
+
*
|
|
6
|
+
* - `working` — the agent's cursor: transient, replaced by its next call, never walked.
|
|
7
|
+
* - `finding` / `question` — things the agent wants the user to look at; they accumulate as walks and
|
|
8
|
+
* stay until dismissed.
|
|
9
|
+
*/
|
|
10
|
+
export type RangeAnnotationIntent = 'working' | 'finding' | 'question' | (string & {});
|
|
11
|
+
/** One range to annotate, with the label for that stop. */
|
|
12
|
+
export interface RangeAnnotationInput {
|
|
13
|
+
/** A sheet-qualified address (`'Sheet 1'!B2:D6`), resolved against the live workbook. */
|
|
14
|
+
range: string;
|
|
15
|
+
label?: string;
|
|
16
|
+
}
|
|
17
|
+
/**
|
|
18
|
+
* One annotated range.
|
|
19
|
+
*
|
|
20
|
+
* @remarks
|
|
21
|
+
* Transient view state: never serialized, never on the undo stack. `range` is kept current as rows
|
|
22
|
+
* and columns move under it; `status` turns `stale` once its cells (or its sheet) are gone, and back
|
|
23
|
+
* to `open` if an undo brings them back. Every change replaces the object, so views compare by
|
|
24
|
+
* identity.
|
|
25
|
+
*/
|
|
26
|
+
export interface RangeAnnotation {
|
|
27
|
+
/** `${walk}:${index}` — stable for the life of the walk. */
|
|
28
|
+
id: string;
|
|
29
|
+
intent: RangeAnnotationIntent;
|
|
30
|
+
/** Who added it (an agent session); the host's tag, carried through. */
|
|
31
|
+
source?: string;
|
|
32
|
+
/** The sheet the range is on. An annotation is on exactly one sheet. */
|
|
33
|
+
sheet: string;
|
|
34
|
+
/** Sheet-qualified address, current. */
|
|
35
|
+
range: string;
|
|
36
|
+
label?: string;
|
|
37
|
+
/** The call that produced it; ordering across walks. */
|
|
38
|
+
walk: number;
|
|
39
|
+
/** Position within the walk — the agent's review order. */
|
|
40
|
+
index: number;
|
|
41
|
+
createdAt: number;
|
|
42
|
+
/**
|
|
43
|
+
* `stale` means the range can no longer be placed (its cells or its sheet were deleted). A stale
|
|
44
|
+
* annotation is listed, so the user still sees what was said, but is not drawn and is skipped by
|
|
45
|
+
* the navigator. A dismissed annotation is removed, not marked.
|
|
46
|
+
*/
|
|
47
|
+
status: 'open' | 'stale';
|
|
48
|
+
}
|
|
49
|
+
/** Options for {@link addRangeAnnotations}. */
|
|
50
|
+
export interface AddRangeAnnotationsOptions {
|
|
51
|
+
/** Who is adding (an agent session). Carried onto each annotation as `source`. */
|
|
52
|
+
source?: string;
|
|
53
|
+
/**
|
|
54
|
+
* Drop the existing annotations of this intent from the same {@link source} first (a cursor that is
|
|
55
|
+
* replaced by the next call). Annotations from other sources stay; a write with no source replaces
|
|
56
|
+
* only others with no source. @defaultValue `true` for `working`, else `false`
|
|
57
|
+
*/
|
|
58
|
+
replace?: boolean;
|
|
59
|
+
}
|
|
60
|
+
/** What the workbook's annotations look like right now — one frozen object per change. */
|
|
61
|
+
export interface RangeAnnotationState {
|
|
62
|
+
/** Every annotation, every intent and status, in review order: newest walk first, the agent's order within a walk. */
|
|
63
|
+
annotations: readonly RangeAnnotation[];
|
|
64
|
+
/** The ones the navigator walks: open, and not `working`. */
|
|
65
|
+
navigable: readonly RangeAnnotation[];
|
|
66
|
+
/** The navigator's current annotation, or `null`. */
|
|
67
|
+
current: RangeAnnotation | null;
|
|
68
|
+
/** 1-based position of {@link current} in {@link navigable}; `0` for none. */
|
|
69
|
+
position: number;
|
|
70
|
+
/**
|
|
71
|
+
* The annotation under the pointer — on the grid or in a list that shows the same annotations — or
|
|
72
|
+
* `null`. Both views read it, so pointing at one side lights the other. Transient; never a
|
|
73
|
+
* `stale` annotation.
|
|
74
|
+
*/
|
|
75
|
+
hovered: RangeAnnotation | null;
|
|
76
|
+
/** Bumps on every change. */
|
|
77
|
+
version: number;
|
|
78
|
+
}
|
|
79
|
+
/**
|
|
80
|
+
* What changed, handed to {@link addRangeAnnotationListener} listeners. One event per change.
|
|
81
|
+
*
|
|
82
|
+
* @remarks
|
|
83
|
+
* A writer that has to hear how the user dealt with its annotations reads `dismissed` and `cleared`
|
|
84
|
+
* rather than wrapping every way of dismissing: the tag, a list, a command and a clear all arrive the
|
|
85
|
+
* same way. Each event carries the annotations as they were when it happened.
|
|
86
|
+
*/
|
|
87
|
+
export type RangeAnnotationEvent =
|
|
88
|
+
/** One call's walk. `replaced` is what its `replace` dropped first (empty when it dropped nothing). */
|
|
89
|
+
{
|
|
90
|
+
type: 'added';
|
|
91
|
+
annotations: readonly RangeAnnotation[];
|
|
92
|
+
replaced: readonly RangeAnnotation[];
|
|
93
|
+
}
|
|
94
|
+
/** One annotation, through {@link dismissRangeAnnotation}. */
|
|
95
|
+
| {
|
|
96
|
+
type: 'dismissed';
|
|
97
|
+
annotation: RangeAnnotation;
|
|
98
|
+
}
|
|
99
|
+
/** Those removed by one {@link clearRangeAnnotations}. */
|
|
100
|
+
| {
|
|
101
|
+
type: 'cleared';
|
|
102
|
+
annotations: readonly RangeAnnotation[];
|
|
103
|
+
}
|
|
104
|
+
/** The navigator moved: the new current annotation, or `null` when the cursor was cleared. */
|
|
105
|
+
| {
|
|
106
|
+
type: 'current';
|
|
107
|
+
annotation: RangeAnnotation | null;
|
|
108
|
+
}
|
|
109
|
+
/** The annotation under the pointer, or `null`. */
|
|
110
|
+
| {
|
|
111
|
+
type: 'hovered';
|
|
112
|
+
annotation: RangeAnnotation | null;
|
|
113
|
+
}
|
|
114
|
+
/** An annotation's cells moved, or it went stale or came back. */
|
|
115
|
+
| {
|
|
116
|
+
type: 'moved';
|
|
117
|
+
annotation: RangeAnnotation;
|
|
118
|
+
};
|
|
119
|
+
/** Whether the navigator walks this intent. */
|
|
120
|
+
export declare const isWalkedIntent: (intent: RangeAnnotationIntent) => boolean;
|
|
121
|
+
/**
|
|
122
|
+
* Annotate ranges: one call = one **walk**, in the caller's order. The annotations follow their cells
|
|
123
|
+
* through edits and stay until dismissed (a `working` cursor is replaced by the next `working` call
|
|
124
|
+
* from the same source).
|
|
125
|
+
*
|
|
126
|
+
* @returns The annotations created, in order (empty for a clear).
|
|
127
|
+
*/
|
|
128
|
+
export declare const addRangeAnnotations: (workbook: IWorkbook, intent: RangeAnnotationIntent, ranges: readonly RangeAnnotationInput[], options?: AddRangeAnnotationsOptions) => RangeAnnotation[];
|
|
129
|
+
/** The workbook's annotations right now. The same object until something changes. */
|
|
130
|
+
export declare const getRangeAnnotationState: (workbook: IWorkbook) => RangeAnnotationState;
|
|
131
|
+
/** One annotation by id, or `null`. */
|
|
132
|
+
export declare const getRangeAnnotation: (workbook: IWorkbook, id: string) => RangeAnnotation | null;
|
|
133
|
+
/** Remove one annotation. The navigator moves on if it was current. Returns whether it was there. */
|
|
134
|
+
export declare const dismissRangeAnnotation: (workbook: IWorkbook, id: string) => boolean;
|
|
135
|
+
/**
|
|
136
|
+
* Remove annotations — all of them, or those matching `intent` and / or `source`. Returns how many
|
|
137
|
+
* went.
|
|
138
|
+
*/
|
|
139
|
+
export declare const clearRangeAnnotations: (workbook: IWorkbook, filter?: {
|
|
140
|
+
intent?: RangeAnnotationIntent | readonly RangeAnnotationIntent[];
|
|
141
|
+
source?: string;
|
|
142
|
+
}) => number;
|
|
143
|
+
/**
|
|
144
|
+
* Bring an annotation's range into view without touching the selection: activate its sheet when the
|
|
145
|
+
* range is on another one, then scroll (a no-op when it is already on screen). Best effort — a stale
|
|
146
|
+
* annotation, or a sheet that will not select, is not an error.
|
|
147
|
+
*/
|
|
148
|
+
export declare const revealRangeAnnotation: (workbook: IWorkbook, id: string) => Promise<void>;
|
|
149
|
+
/**
|
|
150
|
+
* Make an annotation the navigator's current one and reveal it. A stale, `working` or unknown id does
|
|
151
|
+
* nothing. `null` clears the cursor; {@link nextRangeAnnotation} and {@link prevRangeAnnotation} then walk on
|
|
152
|
+
* from the annotation that was current.
|
|
153
|
+
*/
|
|
154
|
+
export declare const goToRangeAnnotation: (workbook: IWorkbook, id: string | null) => void;
|
|
155
|
+
/**
|
|
156
|
+
* Mark an annotation as the one under the pointer, or `null` for none. Views that show the same
|
|
157
|
+
* annotations (the grid's tags, a host's list) read {@link RangeAnnotationState.hovered} so that
|
|
158
|
+
* pointing at one lights the other. A pointer leaving should pass the id it entered with through
|
|
159
|
+
* {@link unhoverRangeAnnotation}, so a leave that arrives after the next enter does not clear it.
|
|
160
|
+
*/
|
|
161
|
+
export declare const hoverRangeAnnotation: (workbook: IWorkbook, id: string | null) => void;
|
|
162
|
+
/** Clear the hover, but only while `id` is still the hovered one. */
|
|
163
|
+
export declare const unhoverRangeAnnotation: (workbook: IWorkbook, id: string) => void;
|
|
164
|
+
/**
|
|
165
|
+
* Move to the next walked annotation (wrapping) and reveal it.
|
|
166
|
+
*
|
|
167
|
+
* @param fromId Step from this annotation instead of the current one — a chip's own arrows walk
|
|
168
|
+
* from that chip, wherever the user scrolled to.
|
|
169
|
+
*/
|
|
170
|
+
export declare const nextRangeAnnotation: (workbook: IWorkbook, fromId?: string) => void;
|
|
171
|
+
/** Move to the previous walked annotation (wrapping) and reveal it. See {@link nextRangeAnnotation}. */
|
|
172
|
+
export declare const prevRangeAnnotation: (workbook: IWorkbook, fromId?: string) => void;
|
|
173
|
+
/**
|
|
174
|
+
* Listen for the workbook's annotations changing: once per change, told what changed. The returned
|
|
175
|
+
* function stops listening.
|
|
176
|
+
*/
|
|
177
|
+
export declare const addRangeAnnotationListener: (workbook: IWorkbook, listener: (event: RangeAnnotationEvent) => void) => (() => void);
|
|
178
|
+
/** {@link getRangeAnnotationState}, kept current. `null` workbook ⇒ the empty state. */
|
|
179
|
+
export declare const useRangeAnnotations: (workbook: IWorkbook | null) => RangeAnnotationState;
|
|
180
|
+
//# sourceMappingURL=RangeAnnotations.d.ts.map
|
|
@@ -1,11 +1,11 @@
|
|
|
1
|
-
import { IRange,
|
|
1
|
+
import { IRange, IWorksheet } from '@sheetxl/sdk';
|
|
2
2
|
import { IReactNotifier } from '@sheetxl/utils-react';
|
|
3
3
|
import { CommandContext } from '../frame';
|
|
4
4
|
/**
|
|
5
5
|
* The drag {@link createFillMenu} builds a menu for.
|
|
6
6
|
*/
|
|
7
7
|
export interface CreateFillMenuOptions {
|
|
8
|
-
sheet:
|
|
8
|
+
sheet: IWorksheet;
|
|
9
9
|
/** The cells the fill reads — the selection the handle was dragged from. */
|
|
10
10
|
template: IRange.Coords;
|
|
11
11
|
/** The cells the fill covers, the template included — where the handle was released. */
|
|
@@ -1,11 +1,11 @@
|
|
|
1
|
-
import { IRange, IAutoFill, ICellRange,
|
|
1
|
+
import { IRange, IAutoFill, ICellRange, IWorksheet } from '@sheetxl/sdk';
|
|
2
2
|
import { IReactNotifier } from '@sheetxl/utils-react';
|
|
3
3
|
import { CommandContext } from '../frame';
|
|
4
4
|
/**
|
|
5
5
|
* What the Series dialog is opened on — see {@link openFillSeries}.
|
|
6
6
|
*/
|
|
7
7
|
export interface OpenFillSeriesOptions {
|
|
8
|
-
sheet:
|
|
8
|
+
sheet: IWorksheet;
|
|
9
9
|
/** Shows the dialog; nothing opens without one. */
|
|
10
10
|
notifier?: IReactNotifier;
|
|
11
11
|
/** The range the dialog reports as the selection. */
|
|
@@ -1,10 +1,15 @@
|
|
|
1
1
|
import { default as React } from 'react';
|
|
2
|
-
import { IBorders } from '@sheetxl/sdk';
|
|
2
|
+
import { IRange, IBorders } from '@sheetxl/sdk';
|
|
3
|
+
import { UseBordersMode, BorderNormalLine } from './useBorders';
|
|
3
4
|
export interface StaticBorderRendererProps extends React.HTMLAttributes<HTMLDivElement> {
|
|
4
5
|
/**
|
|
5
6
|
* Returns a border for the given value and index.
|
|
6
7
|
*/
|
|
7
8
|
getBorderAt?: (value: any, index: number) => IBorders;
|
|
9
|
+
/**
|
|
10
|
+
* {@inheritDoc UseBorderOptions.getMergeAt}
|
|
11
|
+
*/
|
|
12
|
+
getMergeAt?: (value: any, index: number) => IRange.Coords | null;
|
|
8
13
|
rowCount?: number;
|
|
9
14
|
columnCount?: number;
|
|
10
15
|
/**
|
|
@@ -22,6 +27,18 @@ export interface StaticBorderRendererProps extends React.HTMLAttributes<HTMLDivE
|
|
|
22
27
|
*/
|
|
23
28
|
height?: number;
|
|
24
29
|
forceThinBorder?: boolean;
|
|
30
|
+
/**
|
|
31
|
+
* {@inheritDoc UseBorderOptions.mode}
|
|
32
|
+
*/
|
|
33
|
+
mode?: UseBordersMode;
|
|
34
|
+
/**
|
|
35
|
+
* {@inheritDoc UseBorderOptions.normalRows}
|
|
36
|
+
*/
|
|
37
|
+
normalRows?: BorderNormalLine | null;
|
|
38
|
+
/**
|
|
39
|
+
* {@inheritDoc UseBorderOptions.normalColumns}
|
|
40
|
+
*/
|
|
41
|
+
normalColumns?: BorderNormalLine | null;
|
|
25
42
|
}
|
|
26
43
|
/**
|
|
27
44
|
* Render a grid border using a border property as an input. Useful
|
|
@@ -1,14 +1,19 @@
|
|
|
1
1
|
import { default as React } from 'react';
|
|
2
2
|
import { IBorders, IRange, ICell } from '@sheetxl/sdk';
|
|
3
|
+
import { ReactUtils } from '@sheetxl/utils-react';
|
|
3
4
|
import { IGridPane, IGridMetrics } from '@sheetxl/grid-react';
|
|
4
5
|
export interface BorderRenderProps {
|
|
5
6
|
stroke: IBorders.IStroke;
|
|
6
7
|
range: IRange.Coords;
|
|
8
|
+
/**
|
|
9
|
+
* `[x, y, x2, y2]`. For a diagonal these are its two corners.
|
|
10
|
+
*/
|
|
7
11
|
points: number[];
|
|
8
12
|
key: string;
|
|
9
13
|
/**
|
|
10
14
|
* Which cell edge this stroke belongs to. Trailing edges (right/bottom) are
|
|
11
15
|
* shifted to sit after the divider; leading edges (left/top) sit before it.
|
|
16
|
+
* {@link IBorders.Edge.DiagonalUp} and {@link IBorders.Edge.DiagonalDown} run corner to corner.
|
|
12
17
|
*/
|
|
13
18
|
edge?: IBorders.Edge;
|
|
14
19
|
/**
|
|
@@ -41,6 +46,47 @@ export interface BorderRenderProps {
|
|
|
41
46
|
*/
|
|
42
47
|
endExtend?: number;
|
|
43
48
|
}
|
|
49
|
+
/**
|
|
50
|
+
* Which lines a {@link useBorders} layer draws.
|
|
51
|
+
*
|
|
52
|
+
* - `direct`: the borders cells carry, plus {@link UseBorderOptions.normalRows} /
|
|
53
|
+
* {@link UseBorderOptions.normalColumns} as the Normal style's border — a border on every cell,
|
|
54
|
+
* blank ones included, so it draws above the fills like any other border.
|
|
55
|
+
* - `normal`: only the normal lines, below the cell fills so a fill hides them — the gridlines.
|
|
56
|
+
*
|
|
57
|
+
* Either way a normal line is drawn only where no cell border owns the edge.
|
|
58
|
+
*/
|
|
59
|
+
export type UseBordersMode = 'direct' | 'normal';
|
|
60
|
+
/**
|
|
61
|
+
* One axis' line for a {@link UseBordersMode | normal} layer.
|
|
62
|
+
*/
|
|
63
|
+
export interface BorderNormalLine {
|
|
64
|
+
/** CSS color. */
|
|
65
|
+
color: string;
|
|
66
|
+
/**
|
|
67
|
+
* Width in device pixels.
|
|
68
|
+
*
|
|
69
|
+
* @defaultValue 1
|
|
70
|
+
*/
|
|
71
|
+
width?: number;
|
|
72
|
+
/** Dash pattern in CSS px; solid when omitted. */
|
|
73
|
+
dashArray?: readonly number[] | null;
|
|
74
|
+
/** Two parallel lines, open where they cross. */
|
|
75
|
+
isDouble?: boolean;
|
|
76
|
+
/**
|
|
77
|
+
* The side of the boundary an even width grows toward.
|
|
78
|
+
*
|
|
79
|
+
* @defaultValue 'leading'
|
|
80
|
+
*/
|
|
81
|
+
edge?: ReactUtils.EdgeKind;
|
|
82
|
+
}
|
|
83
|
+
/**
|
|
84
|
+
* The {@link BorderNormalLine} that draws `stroke`, or `null` for none.
|
|
85
|
+
*
|
|
86
|
+
* @param stroke The stroke.
|
|
87
|
+
* @param edge The edge the stroke comes from; decides which way an even width grows.
|
|
88
|
+
*/
|
|
89
|
+
export declare const toBorderNormalLine: (stroke: IBorders.IStroke | null | undefined, edge: IBorders.Edge) => BorderNormalLine | null;
|
|
44
90
|
export interface UseBorderOptions {
|
|
45
91
|
/**
|
|
46
92
|
* Returns a list of visible cells.
|
|
@@ -61,6 +107,14 @@ export interface UseBorderOptions {
|
|
|
61
107
|
* @returns The IBorders at the location.
|
|
62
108
|
*/
|
|
63
109
|
getBorderAt?: (value: any, index: number) => IBorders;
|
|
110
|
+
/**
|
|
111
|
+
* The merged range a cell belongs to, or `null` when it is not merged. A merged cell's diagonals
|
|
112
|
+
* run corner to corner across the whole merge. When omitted every cell is its own box.
|
|
113
|
+
*
|
|
114
|
+
* @param value The value returned from `getVisibleCells`.
|
|
115
|
+
* @param index The index of that value.
|
|
116
|
+
*/
|
|
117
|
+
getMergeAt?: (value: any, index: number) => IRange.Coords | null;
|
|
64
118
|
/**
|
|
65
119
|
* Allow users to customize border rendering.
|
|
66
120
|
* Note - This is wrapped in a single SVG so must be an SVG Element type (like a path).
|
|
@@ -72,16 +126,54 @@ export interface UseBorderOptions {
|
|
|
72
126
|
* Use for previews.
|
|
73
127
|
*/
|
|
74
128
|
forceThinBorder?: boolean;
|
|
129
|
+
/**
|
|
130
|
+
* @defaultValue 'direct'
|
|
131
|
+
*/
|
|
132
|
+
mode?: UseBordersMode;
|
|
133
|
+
/**
|
|
134
|
+
* The horizontal line drawn where no cell border owns the boundary (see {@link UseBordersMode}).
|
|
135
|
+
* `null` draws none.
|
|
136
|
+
*/
|
|
137
|
+
normalRows?: BorderNormalLine | null;
|
|
138
|
+
/**
|
|
139
|
+
* The vertical line drawn where no cell border owns the boundary (see {@link UseBordersMode}).
|
|
140
|
+
* `null` draws none.
|
|
141
|
+
*/
|
|
142
|
+
normalColumns?: BorderNormalLine | null;
|
|
143
|
+
/**
|
|
144
|
+
* Shared by layers that draw the same cells, so the cells are read into borders once for all of
|
|
145
|
+
* them. Layers share a read when `getVisibleCells` returns the same array and `getBorderAt`,
|
|
146
|
+
* `getMergeAt`, and `defaultColor` are the same.
|
|
147
|
+
*/
|
|
148
|
+
cache?: BordersCache;
|
|
75
149
|
}
|
|
150
|
+
declare const _BordersCacheBrand: unique symbol;
|
|
151
|
+
/**
|
|
152
|
+
* Lets several {@link useBorders} layers share the work of reading their cells into borders. Create
|
|
153
|
+
* one with {@link createBordersCache} and pass it to each layer as {@link UseBorderOptions.cache}.
|
|
154
|
+
*/
|
|
155
|
+
export interface BordersCache {
|
|
156
|
+
readonly [_BordersCacheBrand]: true;
|
|
157
|
+
}
|
|
158
|
+
/**
|
|
159
|
+
* A new {@link BordersCache}.
|
|
160
|
+
*/
|
|
161
|
+
export declare const createBordersCache: () => BordersCache;
|
|
76
162
|
export interface UseBorderResults {
|
|
77
163
|
/**
|
|
78
|
-
*
|
|
164
|
+
* Draws a pane's borders, or `null` when it has none.
|
|
79
165
|
*/
|
|
80
|
-
renderLayer?: (
|
|
166
|
+
renderLayer?: (pane: IGridPane) => React.ReactNode;
|
|
81
167
|
}
|
|
82
168
|
/**
|
|
83
169
|
* useBorders
|
|
84
170
|
* Renders borders by combining individual cells border attributes.
|
|
171
|
+
*
|
|
172
|
+
* @remarks
|
|
173
|
+
* A double is drawn as one solid band with its center cut out by a mask. Each cut runs to the
|
|
174
|
+
* center of the double it meets, so two doubles open into each other where they cross, tee or
|
|
175
|
+
* turn a corner. Strokes that are not double are outside the mask and never cut.
|
|
85
176
|
*/
|
|
86
|
-
export declare const useBorders: ({ getBorderAt, rendererBorder, getVisibleCells: propGetVisibleCells, forceThinBorder, defaultColor, }: UseBorderOptions) => UseBorderResults;
|
|
177
|
+
export declare const useBorders: ({ getBorderAt, getMergeAt, rendererBorder, getVisibleCells: propGetVisibleCells, forceThinBorder, defaultColor, mode, normalRows, normalColumns, cache }: UseBorderOptions) => UseBorderResults;
|
|
178
|
+
export {};
|
|
87
179
|
//# sourceMappingURL=useBorders.d.ts.map
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import { default as React } from 'react';
|
|
2
|
+
import { CellContentEntry, CellContentRendererProps } from './CellRenderers';
|
|
3
|
+
/**
|
|
4
|
+
* The checkbox cell control: `TRUE` draws checked, `FALSE` and blank draw unchecked, and a press on
|
|
5
|
+
* the box writes the other.
|
|
6
|
+
*
|
|
7
|
+
* @remarks
|
|
8
|
+
* The box takes the cell's font color and scales with its font size, and sits centered on the line
|
|
9
|
+
* the cell's text would paint in. Under General alignment it is centered, as Excel centers a
|
|
10
|
+
* boolean; an explicit left or right alignment moves it to that edge.
|
|
11
|
+
* A formula cell draws the box but takes no press: it is drawn disabled, and a press on it selects
|
|
12
|
+
* the cell as a press on any cell does.
|
|
13
|
+
*/
|
|
14
|
+
export declare const CellCheckboxRenderer: (props: CellContentRendererProps) => React.ReactElement;
|
|
15
|
+
/**
|
|
16
|
+
* What the checkbox control contributes to the UI: the box, the press that writes the other value,
|
|
17
|
+
* and Space, which toggles every checkbox the selection touches.
|
|
18
|
+
*/
|
|
19
|
+
export declare const CheckboxCellContent: CellContentEntry;
|
|
20
|
+
//# sourceMappingURL=CellCheckboxRenderer.d.ts.map
|
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
import { default as React } from 'react';
|
|
2
|
+
import { CellContentRendererProps } from './CellRenderers';
|
|
3
|
+
/**
|
|
4
|
+
* The value type whose General alignment {@link CellContent} follows: text sits left, a number
|
|
5
|
+
* right, a boolean centered.
|
|
6
|
+
*/
|
|
7
|
+
export type CellContentAlignAs = 'text' | 'number' | 'boolean';
|
|
8
|
+
/**
|
|
9
|
+
* Props for {@link CellContent}: the renderer's own props, spread whole, plus what the host should
|
|
10
|
+
* do with them.
|
|
11
|
+
*/
|
|
12
|
+
export interface CellContentProps extends CellContentRendererProps {
|
|
13
|
+
/**
|
|
14
|
+
* Where General alignment places the children: where it would place a value of this type. An
|
|
15
|
+
* explicit horizontal alignment on the cell places them instead.
|
|
16
|
+
*
|
|
17
|
+
* @defaultValue 'boolean'
|
|
18
|
+
*/
|
|
19
|
+
alignAs?: CellContentAlignAs;
|
|
20
|
+
/**
|
|
21
|
+
* Makes the whole cell the hit region: the root carries
|
|
22
|
+
* {@link CellContentRendererProps.interactiveProps}. Leave it off and spread the props on the
|
|
23
|
+
* element inside that should take the pointer instead (a checkbox's box, a rating's stars).
|
|
24
|
+
*/
|
|
25
|
+
interactive?: boolean;
|
|
26
|
+
/**
|
|
27
|
+
* Centers the children on the line the cell's text would paint in, rather than placing them
|
|
28
|
+
* against the content box: the cell's vertical alignment, font and row height move them as they
|
|
29
|
+
* move text. For content sized to the font that sits beside text (a checkbox, a slider). Content
|
|
30
|
+
* taller than the room about the line is centered on it and may be shrunk by `max-height`.
|
|
31
|
+
*/
|
|
32
|
+
centerOnTextLine?: boolean;
|
|
33
|
+
/**
|
|
34
|
+
* Places the children inside the cell's text insets, the padding text gets. Turn it off for
|
|
35
|
+
* content that runs to the cell's edges, such as a picture or a button.
|
|
36
|
+
*
|
|
37
|
+
* @defaultValue true
|
|
38
|
+
*/
|
|
39
|
+
inset?: boolean;
|
|
40
|
+
/** The cell's content. */
|
|
41
|
+
children?: React.ReactNode;
|
|
42
|
+
}
|
|
43
|
+
/**
|
|
44
|
+
* The host a content renderer draws into: the cell's root, placed by the layer, with the renderer's
|
|
45
|
+
* props stripped of what is not for the DOM, its children placed in the cell's content box by the
|
|
46
|
+
* cell's alignment, in the cell's font color and size.
|
|
47
|
+
*
|
|
48
|
+
* @remarks
|
|
49
|
+
* Spread the renderer's props onto it whole and put what the cell shows inside:
|
|
50
|
+
*
|
|
51
|
+
* ```tsx
|
|
52
|
+
* const StarsRenderer: CellContentRenderer = (props) => (
|
|
53
|
+
* <CellContent {...props} alignAs="text">
|
|
54
|
+
* <div {...props.interactiveProps}>★★★☆☆</div>
|
|
55
|
+
* </CellContent>
|
|
56
|
+
* );
|
|
57
|
+
* ```
|
|
58
|
+
*
|
|
59
|
+
* It is a component, so a renderer that uses it is one fiber per cell inside a cached tile; the
|
|
60
|
+
* layer calls the renderer itself as a plain function. A renderer that replaces the text and
|
|
61
|
+
* positions nothing of its own needs nothing else; one that decorates the text wraps
|
|
62
|
+
* {@link CellContentRendererProps.Default} instead, which is its own root.
|
|
63
|
+
*/
|
|
64
|
+
export declare const CellContent: {
|
|
65
|
+
(props: CellContentProps): React.ReactElement;
|
|
66
|
+
displayName: string;
|
|
67
|
+
};
|
|
68
|
+
//# sourceMappingURL=CellContent.d.ts.map
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
import { ICell, ICellRange, IWorksheet, Scalar } from '@sheetxl/sdk';
|
|
2
|
+
import { IReactNotifier } from '@sheetxl/utils-react';
|
|
3
|
+
import { EditRejectedNotice } from '../editor/useEditRejectedNotice';
|
|
4
|
+
/**
|
|
5
|
+
* What a cell content entry writes through: guarded writes into the sheet, and the notifier for
|
|
6
|
+
* anything else it has to say. One per layer; every entry of the layer shares it.
|
|
7
|
+
*/
|
|
8
|
+
export interface CellControlContext {
|
|
9
|
+
sheet: IWorksheet;
|
|
10
|
+
notifier: IReactNotifier;
|
|
11
|
+
/**
|
|
12
|
+
* Writes `value` into `cell`.
|
|
13
|
+
*
|
|
14
|
+
* @returns `false` when the cell refuses the write: it holds a formula, or it is locked on a
|
|
15
|
+
* protected sheet (the user is told why).
|
|
16
|
+
*/
|
|
17
|
+
setCellValue(cell: ICell, value: Scalar): boolean;
|
|
18
|
+
/**
|
|
19
|
+
* Writes `value` into every cell of `range` that holds no formula, in one operation.
|
|
20
|
+
*
|
|
21
|
+
* @returns `false` when nothing was written: every cell holds a formula, or the sheet refused
|
|
22
|
+
* (a locked cell on a protected sheet; the user is told why).
|
|
23
|
+
*/
|
|
24
|
+
setRangeValue(range: ICellRange, value: Scalar): boolean;
|
|
25
|
+
}
|
|
26
|
+
/** What {@link createCellControlContext} binds. */
|
|
27
|
+
export interface CellControlContextOptions {
|
|
28
|
+
sheet: IWorksheet;
|
|
29
|
+
notifier: IReactNotifier;
|
|
30
|
+
/** The Excel-style heads-up for a write the sheet's protection refuses. */
|
|
31
|
+
notifyEditRejected: EditRejectedNotice;
|
|
32
|
+
}
|
|
33
|
+
/**
|
|
34
|
+
* Creates the {@link CellControlContext} of a layer.
|
|
35
|
+
*/
|
|
36
|
+
export declare function createCellControlContext(options: CellControlContextOptions): CellControlContext;
|
|
37
|
+
//# sourceMappingURL=CellControlContext.d.ts.map
|
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
import { default as React } from 'react';
|
|
2
|
-
import { ICalculation, ICell } from '@sheetxl/sdk';
|
|
2
|
+
import { ICalculation, ICell, Size } from '@sheetxl/sdk';
|
|
3
3
|
/**
|
|
4
|
-
* Props for {@link
|
|
4
|
+
* Props for {@link CellFormulaRenderer}.
|
|
5
5
|
*/
|
|
6
|
-
export interface
|
|
6
|
+
export interface CellFormulaRendererProps extends React.HTMLAttributes<HTMLDivElement> {
|
|
7
7
|
/** The formula cell being rendered (styling source: font, alignment, insets). */
|
|
8
8
|
cell: ICell;
|
|
9
9
|
/**
|
|
@@ -13,6 +13,8 @@ export interface FormulaCellRendererProps extends React.HTMLAttributes<HTMLDivEl
|
|
|
13
13
|
* range picker outlines with, so text and rectangle always match.
|
|
14
14
|
*/
|
|
15
15
|
tokens: readonly ICalculation.FormulaToken[];
|
|
16
|
+
/** The cell's unzoomed size — what the text is placed against (`ICell.getTextPlacement`). */
|
|
17
|
+
size: Size;
|
|
16
18
|
/** The pane's zoom (the hosting box's bounds are zoomed; fonts must match). */
|
|
17
19
|
zoom: number;
|
|
18
20
|
}
|
|
@@ -20,15 +22,16 @@ export interface FormulaCellRendererProps extends React.HTMLAttributes<HTMLDivEl
|
|
|
20
22
|
* The **formula-view** cell renderer: the anchor cell's formula as tokenized, syntax-colored text.
|
|
21
23
|
*
|
|
22
24
|
* @remarks
|
|
23
|
-
* The live counterpart of `
|
|
25
|
+
* The live counterpart of `CellTextRenderer`'s (plain) `showFormulas` path: the tiled layer keeps
|
|
24
26
|
* every formula cell as an immutable plain-text snapshot, and `SheetCellLayer` suppresses the
|
|
25
27
|
* ANCHOR cell (the live `data-rc` CSS channel) and overlays this renderer in its place — so
|
|
26
28
|
* selection moves never invalidate a tile. Colors are emitted as theme tokens (`light-dark()`
|
|
27
29
|
* aware), so a mode flip re-resolves in pure CSS here too.
|
|
28
30
|
*
|
|
29
31
|
* Layout mirrors the plain formula path's rules: forced left alignment, no rotation, no overflow
|
|
30
|
-
* past the cell box (clipped by the hosting box), vertical
|
|
32
|
+
* past the cell box (clipped by the hosting box), the vertical position from the SDK placement, and
|
|
33
|
+
* the letter-spacing that paints the text at its measured width.
|
|
31
34
|
* (2nd pass: hover highlight/eval tooltips like the editor's overlay.)
|
|
32
35
|
*/
|
|
33
|
-
export declare const
|
|
34
|
-
//# sourceMappingURL=
|
|
36
|
+
export declare const CellFormulaRenderer: React.FC<CellFormulaRendererProps>;
|
|
37
|
+
//# sourceMappingURL=CellFormulaRenderer.d.ts.map
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
import { default as React } from 'react';
|
|
2
|
+
import { CellContentEntry, CellContentRendererProps } from './CellRenderers';
|
|
3
|
+
/**
|
|
4
|
+
* Draws an image value: the picture in the cell, edge to edge, placed by the cell's alignment
|
|
5
|
+
* (left under General, as text is) and sized by the value's sizing. Nothing draws until the bytes are in;
|
|
6
|
+
* a source with no picture draws `#VALUE!`.
|
|
7
|
+
*/
|
|
8
|
+
export declare const CellImageRenderer: (props: CellContentRendererProps) => React.ReactElement;
|
|
9
|
+
/** What an image value contributes to the UI: its picture. */
|
|
10
|
+
export declare const CellImageContent: CellContentEntry;
|
|
11
|
+
//# sourceMappingURL=CellImageRenderer.d.ts.map
|