@sheetxl/react 0.8.0-beta.2 → 0.8.0-beta.21
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/6lfBozPNyWlFBEDn.mjs +19 -0
- package/browser/esm/B7TCFLHs7nnOgLMi.mjs +79 -0
- package/browser/esm/BQur1iFrng9Y4kh4.mjs +2706 -0
- package/browser/esm/BjnWnPjhT1QFkbUC.mjs +60 -0
- package/browser/esm/BwMC6jAg2neI4LTH.mjs +32 -0
- package/browser/esm/BzCq_Z7J2qQlY4Dp.mjs +134 -0
- package/browser/esm/BzFKdDmdCdg3cXdh.mjs +262 -0
- package/browser/esm/C2HjD-DbaqXq93R7.mjs +45 -0
- package/browser/esm/C46qV9hBGqlz6_Kt.mjs +323 -0
- package/browser/esm/C9dHNoiKtX9PLY1g.mjs +20 -0
- package/browser/esm/CA6w64diOtRCgr4n.mjs +67 -0
- package/browser/esm/CCL3pFmdsuwahoCR.mjs +42 -0
- package/browser/esm/CHgyrBEiFmspcFXV.mjs +8 -0
- package/browser/esm/CPwcEeQtvkrESNEy.mjs +303 -0
- package/browser/esm/CdE8JeJkTtdh5qqp.mjs +78 -0
- package/browser/esm/CkYId3pjG9v3XZM2.mjs +36 -0
- package/browser/esm/Co65nK3fyBcyVzrS.mjs +401 -0
- package/browser/esm/DG1f60gvSkz8Y3qb.mjs +197 -0
- package/browser/esm/DL2WZkJdK1lZfpJo.mjs +341 -0
- package/browser/esm/Dl0ye0MfTml4mjhA.mjs +9560 -0
- package/browser/esm/_T8e_9xhVAagwkPD.mjs +31 -0
- package/browser/esm/chart.mjs +41 -0
- package/browser/esm/control.mjs +217 -0
- package/browser/esm/fHDciYUZvXpLzoID.mjs +128 -0
- package/browser/esm/group.mjs +123 -0
- package/browser/esm/index.mjs +22374 -13204
- package/browser/esm/k1IvXgw5-153QQUo.mjs +14092 -0
- package/browser/esm/mOYnwl3MMod-yX7a.mjs +63 -0
- 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 +277 -0
- package/browser/esm/zTaXN_1rvsoWg94m.mjs +145 -0
- package/licenses/dependencies.txt +284 -565
- package/node/esm/8PerdW56-NyRf0pg.mjs +134 -0
- package/node/esm/B2a1mRx9B8XMRd8H.mjs +2706 -0
- package/node/esm/B4qJFO-8Vml8JbaC.mjs +146 -0
- package/node/esm/BBBfGP0lLhBFoR9F.mjs +198 -0
- package/node/esm/BQpm93aEyzN5TiU6.mjs +8 -0
- package/node/esm/BadjRr_jKKGvmEW-.mjs +80 -0
- package/node/esm/Bzuh8HcJcFD2dYTY.mjs +128 -0
- package/node/esm/CD1OBtF4vEthYy6e.mjs +35 -0
- package/node/esm/CGEbcsNJ40cYQEWX.mjs +1697 -0
- package/node/esm/CNYzecnb2TInTI8p.mjs +80 -0
- package/node/esm/COg8aOu0d67g_Pg5.mjs +37 -0
- package/node/esm/CdKkuM4Yy04LbhRL.mjs +19 -0
- package/node/esm/Df-nWyFJwXaVd79x.mjs +263 -0
- package/node/esm/DtrPF3bSD4CZC5VG.mjs +45 -0
- package/node/esm/EXPN4LM0alUK5Zw7.mjs +20 -0
- package/node/esm/JrDkDzP0l4TgHusH.mjs +32 -0
- package/node/esm/Mq8a4csdTfwY5CnZ.mjs +63 -0
- package/node/esm/cgqViNUwnlIX8-UW.mjs +328 -0
- package/node/esm/chart.mjs +41 -0
- package/node/esm/control.mjs +217 -0
- package/node/esm/fM9xnrz0LJWdndYE.mjs +68 -0
- package/node/esm/group.mjs +123 -0
- package/node/esm/index.mjs +18717 -9431
- package/node/esm/note.mjs +113 -0
- package/node/esm/picture.mjs +305 -0
- package/node/esm/shape.mjs +342 -0
- package/node/esm/slicer.mjs +279 -0
- package/node/esm/tRhXTPxocmY7ZY3z.mjs +66 -0
- package/node/esm/uzlKB6H0b-ol8pDK.mjs +406 -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 +314 -27
- 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 +367 -3
- 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 +328 -29
- 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 +369 -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 +6 -0
- 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 +6 -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 +60 -19
- 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 +94 -0
- package/types/src/comment/CommentUtils.d.ts +43 -0
- package/types/src/comment/NoteEditor.d.ts +20 -0
- package/types/src/comment/index.d.ts +5 -0
- package/types/src/comment/useCommentThread.d.ts +37 -0
- package/types/src/comment/useSheetComments.d.ts +28 -0
- 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/FunctionPreviewPanel.d.ts +1 -1
- package/types/src/editor/SheetCellEditorLayer.d.ts +2 -10
- package/types/src/editor/SheetCellEditorStartLayer.d.ts +61 -0
- 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/index.d.ts +3 -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 +15 -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 +12 -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 +43 -0
- package/types/src/layer/CommentsLayer.d.ts +35 -0
- 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 +17 -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 +8 -8
- 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 +56 -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/MovableEdit.d.ts +22 -0
- package/types/src/movable/MovableFrame.d.ts +18 -14
- 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/TextBox.d.ts +34 -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 +11 -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 +41 -0
- package/types/src/richText/index.d.ts +2 -0
- 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/{ISheetElement.d.ts → IWorksheetElement.d.ts} +111 -81
- 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 +20 -5
- 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/ThemeState.d.ts +15 -2
- package/types/src/theme/buildDocThemeCSS.d.ts +4 -1
- package/types/src/theme/buildOOXMLThemeCSS.d.ts +2 -2
- package/types/src/theme/useGridColorScheme.d.ts +3 -3
- package/types/src/theme/useSystemColors.d.ts +2 -2
- 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 +108 -23
- package/types/src/workbook/WorkbookCommands.d.ts +8 -3
- 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 -41
- package/browser/esm/Dsn3z1hmkv-bWGVr.mjs +0 -6286
- package/node/esm/CyU4sKDpHyc6kF7j.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/SheetElement.d.ts +0 -15
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
import { default as React } from 'react';
|
|
2
|
+
import { IWorksheet } from '@sheetxl/sdk';
|
|
3
|
+
import { VirtualKeyboardHandler } from '@sheetxl/utils-react';
|
|
4
|
+
import { StartEditOptions } from '@sheetxl/grid-react';
|
|
5
|
+
import { SheetEditable } from './SheetEditable';
|
|
6
|
+
import { EditRejectedNotice } from './useEditRejectedNotice';
|
|
7
|
+
/**
|
|
8
|
+
* Start a ready-mode edit typed into the grid.
|
|
9
|
+
*
|
|
10
|
+
* @param keyboard The virtual keyboard the typing came through (a key typed into the
|
|
11
|
+
* {@link VirtualKeyboardLayer}'s input); omit for typing on the grid itself. In keyboard mode the
|
|
12
|
+
* edit opens in the keyboard's registered editor (a phone's formula bar) rather than the cell, by
|
|
13
|
+
* parking that editor on the new session before anything renders it.
|
|
14
|
+
* @returns Whether the edit started.
|
|
15
|
+
* @internal
|
|
16
|
+
*/
|
|
17
|
+
export declare const startTypedEdit: (editable: SheetEditable, coords: Parameters<SheetEditable["startEdit"]>[0], options: StartEditOptions<string>, keyboard?: VirtualKeyboardHandler) => boolean;
|
|
18
|
+
/**
|
|
19
|
+
* Props for {@link SheetCellEditorStartLayer}.
|
|
20
|
+
*/
|
|
21
|
+
export interface SheetCellEditorStartLayerProps {
|
|
22
|
+
/** The sheet — stamps the double-clicked cell's scope (sheet name) onto the coords it starts on. */
|
|
23
|
+
sheet: IWorksheet;
|
|
24
|
+
/** The editable (UI model) — the same instance the {@link SheetCellEditorLayer} renders. */
|
|
25
|
+
editable: SheetEditable;
|
|
26
|
+
/**
|
|
27
|
+
* Notified when a start-edit attempt is rejected (`startEdit` returned `false` — a non-editable
|
|
28
|
+
* cell). The host that mounts one layer per pane (`WorksheetElement`) passes a SHARED callback
|
|
29
|
+
* ({@link useEditRejectedNotice}) so all panes form one notice scope; it receives the rejected cell.
|
|
30
|
+
* @defaultValue this layer's own {@link useEditRejectedNotice}
|
|
31
|
+
*/
|
|
32
|
+
onEditRejected?: EditRejectedNotice;
|
|
33
|
+
}
|
|
34
|
+
/**
|
|
35
|
+
* The sheet's **ready-mode** edit starters — the `@sheetxl/react` counterpart of grid-react's
|
|
36
|
+
* `EditorStartLayer`: a typed character / `F2` / `Backspace` opens an edit on the anchor, a
|
|
37
|
+
* double-click opens one on the cell under the pointer, and a rejected start raises the Excel-style
|
|
38
|
+
* heads-up (protected sheet, array part, unlock-range prompt).
|
|
39
|
+
*
|
|
40
|
+
* @remarks
|
|
41
|
+
* A content-less layer, separate from the {@link SheetCellEditorLayer} that paints the box. The box
|
|
42
|
+
* sits at the **top** of the stack to paint over everything, but a Layer's handlers are its slot's
|
|
43
|
+
* tap — grid-wide ears that fire on every layer's turn, top first — so start handlers on the top
|
|
44
|
+
* layer intercepted keys and double-clicks aimed at a chart or note before that widget's own handlers
|
|
45
|
+
* ran. Starting an edit is the grid *floor's* behavior: `WorksheetElement` mounts this as the first grid
|
|
46
|
+
* child, where it only hears what no widget above consumed.
|
|
47
|
+
*
|
|
48
|
+
* Keys are positionless, so the floor slot alone is not enough: a focused widget that does not consume
|
|
49
|
+
* a printable key (it must let keys through so its own commands can resolve) would still reach this
|
|
50
|
+
* tap. The key start therefore acts only when the key is aimed at the grid surface itself — the
|
|
51
|
+
* surface, or the pane's focus target standing in for it (the {@link VirtualKeyboardLayer}'s input),
|
|
52
|
+
* is the focused element. A double-click has a position; a widget that owns it consumes it.
|
|
53
|
+
*
|
|
54
|
+
* Text that reaches the focus target without a keydown that started an edit (a virtual keyboard can
|
|
55
|
+
* deliver it that way) starts one too, seeded with the text.
|
|
56
|
+
*/
|
|
57
|
+
export declare function SheetCellEditorStartLayer(props: SheetCellEditorStartLayerProps): React.ReactElement;
|
|
58
|
+
export declare namespace SheetCellEditorStartLayer {
|
|
59
|
+
var displayName: string;
|
|
60
|
+
}
|
|
61
|
+
//# sourceMappingURL=SheetCellEditorStartLayer.d.ts.map
|
|
@@ -104,6 +104,20 @@ export type SheetCellInputProps = EditorInputProps<() => ICell, string> & {
|
|
|
104
104
|
* a sliver of the next; supplying it makes the two exact.
|
|
105
105
|
*/
|
|
106
106
|
lineHeight?: number;
|
|
107
|
+
/**
|
|
108
|
+
* The virtual keyboard a touch host asks for (`'decimal'` for a number pad). Applied to the
|
|
109
|
+
* textarea; a change takes effect on the next focus on some platforms.
|
|
110
|
+
*/
|
|
111
|
+
inputMode?: React.TextareaHTMLAttributes<HTMLTextAreaElement>['inputMode'];
|
|
112
|
+
/** The action label of the virtual keyboard's Enter key. */
|
|
113
|
+
enterKeyHint?: React.TextareaHTMLAttributes<HTMLTextAreaElement>['enterKeyHint'];
|
|
114
|
+
/**
|
|
115
|
+
* Which side of the caret the function hint opens on. A host at the bottom of the screen (the
|
|
116
|
+
* phone's formula bar) asks for `'above'`, where the room is.
|
|
117
|
+
*
|
|
118
|
+
* @defaultValue 'below'
|
|
119
|
+
*/
|
|
120
|
+
hintPlacement?: 'below' | 'above';
|
|
107
121
|
};
|
|
108
122
|
export declare const createSheetCellInput: (options: SheetCellInputOptions) => React.FC<SheetCellInputProps>;
|
|
109
123
|
//# sourceMappingURL=SheetCellInput.d.ts.map
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { IWorksheet, IWorkbook, ICell } from '@sheetxl/sdk';
|
|
2
2
|
import { CreateEdit, IEditable, EditCommitArgs } from '@sheetxl/grid-react';
|
|
3
3
|
import { ReferenceModeHandler } from './useReferenceMode';
|
|
4
4
|
/** The editable shape for a spreadsheet: `clean` is a live cell getter, `dirty` is the working text. */
|
|
@@ -9,9 +9,9 @@ export type SheetEditable = IEditable<() => ICell, string, EditCommitArgs>;
|
|
|
9
9
|
* uses it to cover the cell while editing. The cell-aware input itself paints only the cell's *own*
|
|
10
10
|
* fill; this fallback is the container's job.
|
|
11
11
|
*/
|
|
12
|
-
export declare const resolveCellBackground: (cell: ICell, sheet:
|
|
12
|
+
export declare const resolveCellBackground: (cell: ICell, sheet: IWorksheet, darkMode?: boolean, bodyFill?: string) => string;
|
|
13
13
|
/**
|
|
14
|
-
* An `
|
|
14
|
+
* An `IWorksheet`-backed {@link CreateEdit} for the new {@link DefaultEditable} / {@link EditorLayer}.
|
|
15
15
|
*
|
|
16
16
|
* @remarks
|
|
17
17
|
* - **clean** is `() => ICell` — a *live* cell getter (not a captured value), so a cell-aware input
|
|
@@ -21,7 +21,7 @@ export declare const resolveCellBackground: (cell: ICell, sheet: ISheet, darkMod
|
|
|
21
21
|
* write leaves the selection as it is (a block typed into stays selected for Enter to move within),
|
|
22
22
|
* and an undo or a redo of it lands on the cell.
|
|
23
23
|
* - **`null`** ⇒ the cell is not editable (protected / read-only), via {@link ICell.isEditAllowed}.
|
|
24
|
-
* - **scope-aware**: `coords.scope` (a sheet name) picks the sheet to edit, via `workbook.
|
|
24
|
+
* - **scope-aware**: `coords.scope` (a sheet name) picks the sheet to edit, via `workbook.getWorksheet`,
|
|
25
25
|
* falling back to `sheet`. This is what makes a commit write back to the session's *origin* sheet even
|
|
26
26
|
* if a different sheet is currently displayed — `coords` here is the session's own (fixed) coords, not
|
|
27
27
|
* whatever the anchor currently reports.
|
|
@@ -33,7 +33,7 @@ export declare const resolveCellBackground: (cell: ICell, sheet: ISheet, darkMod
|
|
|
33
33
|
* out of `commit`, which rejects it; the editable fans the error out to
|
|
34
34
|
* `IEditable.subscribeCommitError`, where the host shows it.
|
|
35
35
|
*/
|
|
36
|
-
export declare const createSheetCreateEdit: (sheet:
|
|
36
|
+
export declare const createSheetCreateEdit: (sheet: IWorksheet, workbook?: IWorkbook | null) => CreateEdit<() => ICell, string, EditCommitArgs>;
|
|
37
37
|
/**
|
|
38
38
|
* Build the production {@link SheetEditable} for a sheet — the {@link DefaultEditable} wired with a
|
|
39
39
|
* workbook-aware active-cell anchor ({@link createEditableAnchor}) and SDK edit strategy
|
|
@@ -55,5 +55,5 @@ export interface CreateEditableOptions {
|
|
|
55
55
|
*/
|
|
56
56
|
referenceMode?: ReferenceModeHandler;
|
|
57
57
|
}
|
|
58
|
-
export declare const createEditable: (sheet:
|
|
58
|
+
export declare const createEditable: (sheet: IWorksheet, options?: CreateEditableOptions) => SheetEditable;
|
|
59
59
|
//# sourceMappingURL=SheetEditable.d.ts.map
|
|
@@ -34,7 +34,7 @@ export interface SheetReferenceHeaderLayerProps extends LayerProps {
|
|
|
34
34
|
* primary header selection fully in charge. The producer's gates — `scope` and `allowMulti` — are read
|
|
35
35
|
* here exactly as {@link SheetReferenceLayer} reads them for the body: the two surfaces drive one
|
|
36
36
|
* selection, so a gate honored by only one of them is no gate at all. It is a pointer surface
|
|
37
|
-
* only ({@link HeaderSelectionLayer} with `
|
|
37
|
+
* only ({@link HeaderSelectionLayer} with `hideAccent`) — the reference rectangles are drawn on
|
|
38
38
|
* the body grid by {@link SheetReferenceLayer}; `preserveFocus` keeps the formula editor focused across a
|
|
39
39
|
* header drag; `replaceActive` re-scopes/inserts the active reference instead of the primary's whole-
|
|
40
40
|
* selection replace.
|
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
import { default as React } from 'react';
|
|
2
|
-
import {
|
|
2
|
+
import { IWorksheet, IWorksheetView } from '@sheetxl/sdk';
|
|
3
3
|
import { LayerProps } from '@sheetxl/grid-react';
|
|
4
4
|
import { SheetSelection } from '../selection';
|
|
5
5
|
/**
|
|
6
6
|
* Draws the current **reference selection** over the grid (Excel-style colored rectangles), highlighting
|
|
7
|
-
* the active reference. A pane layer (mounted per pane by `
|
|
7
|
+
* the active reference. A pane layer (mounted per pane by `WorksheetElement`), it reads the app-wide
|
|
8
8
|
* reference-mode bus ({@link useReferenceMode}) — not any edit session — so it renders whenever a
|
|
9
9
|
* reference selection is present, regardless of what produced it: a formula edit (via `SheetCellInput`)
|
|
10
10
|
* or, later, a selected chart showing its source data with no active input at all.
|
|
@@ -23,14 +23,14 @@ import { SheetSelection } from '../selection';
|
|
|
23
23
|
*/
|
|
24
24
|
export interface SheetReferenceLayerProps extends LayerProps {
|
|
25
25
|
/** The sheet this pane renders — ranges belonging to a different sheet are filtered out of this pane. */
|
|
26
|
-
sheet:
|
|
26
|
+
sheet: IWorksheet;
|
|
27
27
|
/**
|
|
28
28
|
* The sheet view — enables the **formula-view** fallback: while `isShowFormulas()` and no
|
|
29
29
|
* reference-mode state is on the bus, the selection anchor's formula (when it IS a formula)
|
|
30
30
|
* has its references outlined read-only (same palette as the anchor's colored formula text —
|
|
31
31
|
* see {@link useFormulaViewAnchor}). Omit for a host with no formula view.
|
|
32
32
|
*/
|
|
33
|
-
sheetView?:
|
|
33
|
+
sheetView?: IWorksheetView;
|
|
34
34
|
}
|
|
35
35
|
/**
|
|
36
36
|
* Wrap a selection so a range **committed through this pane** is stamped with this pane's sheet.
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
import { default as React } from 'react';
|
|
2
|
+
import { SheetEditable } from './SheetEditable';
|
|
3
|
+
/**
|
|
4
|
+
* Props for {@link VirtualKeyboardLayer}.
|
|
5
|
+
*/
|
|
6
|
+
export interface VirtualKeyboardLayerProps {
|
|
7
|
+
/**
|
|
8
|
+
* The sheet's editable: an edit in progress is what a rising keyboard is for, and its anchor is the
|
|
9
|
+
* active cell kept in view above the keyboard.
|
|
10
|
+
*/
|
|
11
|
+
editable: SheetEditable;
|
|
12
|
+
}
|
|
13
|
+
/**
|
|
14
|
+
* Keyboard mode for the sheet (see `useVirtualKeyboard`): while a virtual keyboard is up for typing
|
|
15
|
+
* into the sheet, focusing the sheet lands on an invisible input that holds the keyboard, so it stays
|
|
16
|
+
* up as the active cell moves.
|
|
17
|
+
*
|
|
18
|
+
* @remarks
|
|
19
|
+
* A virtual keyboard belongs to the focused text field, and the grid surface is not one. Each pane's
|
|
20
|
+
* layer hosts an input and registers it as the pane's focus target while in keyboard mode, asking for
|
|
21
|
+
* the keyboard's input mode. Keys typed there reach the {@link SheetCellEditorStartLayer} as keys
|
|
22
|
+
* aimed at the surface do; this layer starts no edits of its own.
|
|
23
|
+
*
|
|
24
|
+
* Per pane:
|
|
25
|
+
* - **A tap on the grid leaves keyboard mode**: the user has gone back to touching cells. With the
|
|
26
|
+
* store's `keepOnTap` it stays, as Excel keeps its keyboard: the tap does not move focus off the input.
|
|
27
|
+
* - **A focus that reaches the surface itself** in keyboard mode is passed on to the input.
|
|
28
|
+
* - **Leaving keyboard mode** with the input focused hands focus to the surface, lowering the keyboard.
|
|
29
|
+
*
|
|
30
|
+
* The primary pane's layer (the center pane, when there is one) also does the sheet's part, once:
|
|
31
|
+
* - **On and off with the keyboard.** A keyboard rising while the sheet is being edited (in the cell or
|
|
32
|
+
* a formula bar) enters keyboard mode; the keyboard going down (the system's back gesture, its own
|
|
33
|
+
* hide key) leaves it.
|
|
34
|
+
* - **Show.** Entering keyboard mode with focus outside any text field (a "show keyboard" button)
|
|
35
|
+
* focuses the pane, raising the keyboard.
|
|
36
|
+
* - **Done.** Taking a way out of the edit from chrome (the status bar's ✓ / ✕, see `exitEditMode`)
|
|
37
|
+
* leaves keyboard mode before the edit ends, so the focus returning to the grid lowers it.
|
|
38
|
+
* - **The active cell stays in view.** When the keyboard takes room from the grid, or a
|
|
39
|
+
* `KeyboardAccessory` (the formula bar riding the keyboard) settles over the active cell, the cell is
|
|
40
|
+
* scrolled back into view (unless the store's `disableScrollIntoView`).
|
|
41
|
+
*
|
|
42
|
+
* Mount it directly above the start layer, so a key typed into the input reaches the start layer's
|
|
43
|
+
* floor. It renders nothing where the keyboard store is not enabled (`isEnabled()`: a device with no
|
|
44
|
+
* virtual keyboard).
|
|
45
|
+
*/
|
|
46
|
+
export declare function VirtualKeyboardLayer(props: VirtualKeyboardLayerProps): React.ReactElement | null;
|
|
47
|
+
export declare namespace VirtualKeyboardLayer {
|
|
48
|
+
var displayName: string;
|
|
49
|
+
}
|
|
50
|
+
//# sourceMappingURL=VirtualKeyboardLayer.d.ts.map
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import { IWorkbook, IWorksheet } from '@sheetxl/sdk';
|
|
2
|
+
/**
|
|
3
|
+
* The worksheet an editor parses formula text against: the selected worksheet, or, while a sheet of
|
|
4
|
+
* another kind is the active tab, the first worksheet. `null` for a workbook with no worksheet.
|
|
5
|
+
*
|
|
6
|
+
* @remarks
|
|
7
|
+
* Only the parse is anchored here. A field that has a home passes it as the coords (`scope`), and a
|
|
8
|
+
* reference that names its sheet names it; what is left is text with no sheet of its own, which a
|
|
9
|
+
* chart sheet cannot be home to.
|
|
10
|
+
*/
|
|
11
|
+
export declare const formulaAnchorSheet: (workbook: IWorkbook | null | undefined) => IWorksheet | null;
|
|
12
|
+
//# sourceMappingURL=formulaAnchor.d.ts.map
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
export * from './SheetEditable';
|
|
2
|
+
export * from './validationAlert';
|
|
2
3
|
export * from './formulaText';
|
|
3
4
|
export * from './formulaEval';
|
|
4
5
|
export * from './useReferenceMode';
|
|
@@ -14,6 +15,8 @@ export * from './NamedHintPanel';
|
|
|
14
15
|
export * from './EditorCommands';
|
|
15
16
|
export * from './useEditRejectedNotice';
|
|
16
17
|
export * from './SheetCellEditorLayer';
|
|
18
|
+
export * from './SheetCellEditorStartLayer';
|
|
19
|
+
export * from './VirtualKeyboardLayer';
|
|
17
20
|
export * from './SheetReferenceLayer';
|
|
18
21
|
export * from './SheetReferenceHeaderLayer';
|
|
19
22
|
//# sourceMappingURL=index.d.ts.map
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { RangeCoords } from '@sheetxl/utils';
|
|
2
|
-
import { ICalculation, ICell, IRange,
|
|
2
|
+
import { ICalculation, ICell, IRange, IWorksheet } from '@sheetxl/sdk';
|
|
3
3
|
/**
|
|
4
4
|
* The text a range picked on the grid writes into a formula edited at `cell` — shared by the cell
|
|
5
5
|
* editor's two picker write-backs (re-scope and insert) so a pick writes the same text however it
|
|
@@ -42,7 +42,7 @@ export declare const namedReference: (cell: ICell, to: RangeCoords) => string |
|
|
|
42
42
|
*
|
|
43
43
|
* @param sheet Any sheet of the workbook — resolves `range.scope` (its own sheet when unscoped).
|
|
44
44
|
*/
|
|
45
|
-
export declare const isSpillExtent: (sheet:
|
|
45
|
+
export declare const isSpillExtent: (sheet: IWorksheet, range: RangeCoords) => boolean;
|
|
46
46
|
/**
|
|
47
47
|
* The spill reference (`D2#`) a picked range exactly is, or `null`.
|
|
48
48
|
*
|
|
@@ -72,5 +72,5 @@ export declare const spillReference: (cell: ICell, to: RangeCoords, flags?: IRan
|
|
|
72
72
|
* @param tokens The formula's tokens; the `#` anchor token carries its reference's `referenceIndex`.
|
|
73
73
|
* @param ranges Index-aligned with `referenceIndex`. Returned as-is when nothing widens.
|
|
74
74
|
*/
|
|
75
|
-
export declare const expandSpillAnchors: (sheet:
|
|
75
|
+
export declare const expandSpillAnchors: (sheet: IWorksheet, tokens: readonly ICalculation.FormulaToken[], ranges: (RangeCoords | null)[]) => (RangeCoords | null)[];
|
|
76
76
|
//# sourceMappingURL=pickedReference.d.ts.map
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { CellCoords } from '@sheetxl/utils';
|
|
2
|
-
import {
|
|
2
|
+
import { IWorksheet } from '@sheetxl/sdk';
|
|
3
3
|
/**
|
|
4
4
|
* The callback a host invokes on each rejected edit attempt.
|
|
5
5
|
*
|
|
@@ -24,9 +24,9 @@ export type EditRejectedNotice = (coords?: CellCoords | null, retry?: () => void
|
|
|
24
24
|
*
|
|
25
25
|
* Any other non-editable reason stays silent.
|
|
26
26
|
*
|
|
27
|
-
* One instance should serve one visit scope — `
|
|
27
|
+
* One instance should serve one visit scope — `WorksheetElement` creates it and threads the callback to
|
|
28
28
|
* every consumer it hosts (its imperative `startEdit` and each pane's editor layer), so four frozen
|
|
29
29
|
* panes never warn four times.
|
|
30
30
|
*/
|
|
31
|
-
export declare const useEditRejectedNotice: (sheet:
|
|
31
|
+
export declare const useEditRejectedNotice: (sheet: IWorksheet) => EditRejectedNotice;
|
|
32
32
|
//# sourceMappingURL=useEditRejectedNotice.d.ts.map
|
|
@@ -17,7 +17,7 @@ import { FormulaArgument } from './functionArgs';
|
|
|
17
17
|
* localized name is what gets inserted, and that is correct: the editing compiler binds it back to
|
|
18
18
|
* canonical and storage stays canonical. Capped at {@link MAX_FUNCTION_RESULTS} *before* the merge.
|
|
19
19
|
* - **Names and tables** — one collection (a table is an `INamed` whose `getType()` is `'table'`).
|
|
20
|
-
* Pass the SHEET's (`
|
|
20
|
+
* Pass the SHEET's (`IWorksheet.getNames()`), which already holds exactly what a formula written there
|
|
21
21
|
* can refer to, shadowing resolved — the workbook's would offer other sheets' private names.
|
|
22
22
|
* Deliberately NOT localized: a defined name is the user's own text, spelled the same in every
|
|
23
23
|
* language. A name whose body is `LAMBDA(…)` is offered as `'lambda'`, completed like a function.
|
|
@@ -138,7 +138,7 @@ export interface UseFormulaHintsOptions {
|
|
|
138
138
|
* then holds functions only, exactly as before.
|
|
139
139
|
*
|
|
140
140
|
* @remarks
|
|
141
|
-
* Must be the SHEET's collection (`
|
|
141
|
+
* Must be the SHEET's collection (`IWorksheet.getNames()`), not the workbook's: that one holds exactly
|
|
142
142
|
* what a formula on that sheet can refer to, so no scoping is needed here. The workbook's would
|
|
143
143
|
* offer another sheet's private names, which complete to expressions that do not resolve.
|
|
144
144
|
*/
|
|
@@ -195,7 +195,7 @@ export interface FormulaHintsApi {
|
|
|
195
195
|
*/
|
|
196
196
|
getAnchorOffset(): number;
|
|
197
197
|
/**
|
|
198
|
-
* STABLE-identity panel renderer for `useFloatStack.
|
|
198
|
+
* STABLE-identity panel renderer for `useFloatStack.renderPopupPanel` — the autocomplete list when
|
|
199
199
|
* it has matches, else the signature preview. Returns `null` when there is nothing to show.
|
|
200
200
|
*/
|
|
201
201
|
renderPanel(): React.ReactNode;
|
|
@@ -31,7 +31,8 @@ export type FormulaInputGrammar = 'formula' | 'reference';
|
|
|
31
31
|
* - `'literal'` — the `=` DECIDES: text with a leading `=` is a formula (parsed, colored, validated),
|
|
32
32
|
* text without one is a literal that is never parsed and never an error — Excel's own cellIs/DV
|
|
33
33
|
* operand box. A committed string value displays verbatim; the `=` is the one discriminator, so
|
|
34
|
-
* the field adds none and strips none.
|
|
34
|
+
* the field adds none and strips none. Pointing follows it too: the field arms for grid picks
|
|
35
|
+
* only while its text starts with `=`, so Escape back to a literal (or to nothing) disarms.
|
|
35
36
|
*/
|
|
36
37
|
export type FormulaInputEquals = 'optional' | 'required' | 'bare' | 'literal';
|
|
37
38
|
export declare const splitReferenceSegments: (text: string) => {
|
|
@@ -94,7 +95,8 @@ export interface UseFormulaInputOptions {
|
|
|
94
95
|
* still runs — error state, picker sync), `'done'` makes Enter the FIELD's commit point rather than
|
|
95
96
|
* a key the host form sees (the shared policy — see `useEditCommit`) — plus one grammar-specific
|
|
96
97
|
* effect here: a `'done'` reference field drops to caret-edit while the user TYPES (a pick re-arms),
|
|
97
|
-
* where a `'live'` one points for its whole engagement (the RefEdit contract).
|
|
98
|
+
* where a `'live'` one points for its whole engagement (the RefEdit contract). A field's ✓/✗
|
|
99
|
+
* adornments follow it too: `'done'` only.
|
|
98
100
|
*/
|
|
99
101
|
changeOn?: 'live' | 'done';
|
|
100
102
|
/**
|
|
@@ -123,6 +125,15 @@ export interface UseFormulaInputOptions {
|
|
|
123
125
|
* for anything that genuinely spans sheets, e.g. chart series.
|
|
124
126
|
*/
|
|
125
127
|
allowCrossSheet?: boolean;
|
|
128
|
+
/**
|
|
129
|
+
* Whether the field must hold a value. Default `false`: empty text is the CLEARED value (`null`),
|
|
130
|
+
* emitted and committed like any other.
|
|
131
|
+
*
|
|
132
|
+
* `true` makes empty text an ERROR instead, so it can never be committed — for a host whose
|
|
133
|
+
* model has no empty state (the ranges an item is anchored to). A field that MOUNTS empty shows
|
|
134
|
+
* no error until it is edited.
|
|
135
|
+
*/
|
|
136
|
+
required?: boolean;
|
|
126
137
|
/** Disabled: never engages the bus; the text is read-only at the host's discretion. */
|
|
127
138
|
disabled?: boolean;
|
|
128
139
|
/** Resolution context. Defaults to the enclosing `WorkbookContext`. */
|
|
@@ -253,7 +264,8 @@ export interface FormulaInputApi {
|
|
|
253
264
|
* - `'formula'` — armed by CARET CONTEXT (the cell editor's model): an operand expected at the
|
|
254
265
|
* caret, or the caret on a reference token. Elsewhere (a function name, a number) the caret does
|
|
255
266
|
* text work — and the bus drops to `'show'`, so the references stay displayed (rectangles still
|
|
256
|
-
* drag-to-re-scope) while fresh grid gestures don't splice into the middle of a token.
|
|
267
|
+
* drag-to-re-scope) while fresh grid gestures don't splice into the middle of a token. A
|
|
268
|
+
* `'literal'` field is armed only while its text starts with `=`: empty or bare, nothing points.
|
|
257
269
|
*/
|
|
258
270
|
pointArmed: boolean;
|
|
259
271
|
/** Arm/disarm picking without focus (the adornment toggle). */
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
import { CellCoords } from '@sheetxl/utils';
|
|
2
|
+
import { IWorksheet, IDataValidation } from '@sheetxl/sdk';
|
|
3
|
+
/**
|
|
4
|
+
* The alert a typed entry raised: the rule it failed, and the cell it was typed into.
|
|
5
|
+
*/
|
|
6
|
+
export interface ValidationAlert {
|
|
7
|
+
/** The sheet the entry was typed on. */
|
|
8
|
+
sheet: IWorksheet;
|
|
9
|
+
/** The cell the entry was typed into, as the edit session names it: with its sheet scope. */
|
|
10
|
+
coords: CellCoords;
|
|
11
|
+
/** The text that was typed. A Warning accepts the same text entered again. */
|
|
12
|
+
dirty: string;
|
|
13
|
+
/** The rule that refused it. */
|
|
14
|
+
dataValidation: IDataValidation;
|
|
15
|
+
/** The rule's alert style. */
|
|
16
|
+
style: IDataValidation.AlertStyle;
|
|
17
|
+
}
|
|
18
|
+
/** Raise `alert`, or (`null`) clear the one showing. */
|
|
19
|
+
export declare const setValidationAlert: (alert: ValidationAlert | null) => void;
|
|
20
|
+
/** The alert showing, on any sheet. */
|
|
21
|
+
export declare const getValidationAlert: () => ValidationAlert | null;
|
|
22
|
+
/** The alert showing on `sheet` (reactive). */
|
|
23
|
+
export declare const useValidationAlert: (sheet: IWorksheet) => ValidationAlert | null;
|
|
24
|
+
//# sourceMappingURL=validationAlert.d.ts.map
|
|
@@ -26,13 +26,16 @@ export interface FormulaInputProps extends Omit<React.InputHTMLAttributes<HTMLIn
|
|
|
26
26
|
onChangeText?: (text: string) => void;
|
|
27
27
|
/** The commit channel. See `UseFormulaInputOptions.onDone`. */
|
|
28
28
|
onDone?: (value: ICalculation.IFormula | null, args: ReferenceDoneArgs) => void;
|
|
29
|
-
/**
|
|
29
|
+
/**
|
|
30
|
+
* `'done'` suppresses the live notifications — the host hears only `onDone` — and shows the ✓/✗
|
|
31
|
+
* while the text differs from the committed value. Default `'live'`. See `UseFormulaInputOptions.changeOn`.
|
|
32
|
+
*/
|
|
30
33
|
changeOn?: 'live' | 'done';
|
|
31
34
|
/** Resolution/picking context. Defaults to the enclosing `WorkbookContext`. */
|
|
32
35
|
workbook?: IWorkbook | null;
|
|
33
36
|
/** The headless field API, for host-driven commit points (a dialog's OK → `apiRef.current?.commit()`). */
|
|
34
37
|
apiRef?: React.Ref<FormulaInputApi>;
|
|
35
|
-
/** Hide the adornment cluster (✓/✗ while
|
|
38
|
+
/** Hide the adornment cluster (✓/✗ while editing in `'done'` mode; the select-current action). */
|
|
36
39
|
hideAdornment?: boolean;
|
|
37
40
|
/** Hide the error line under the field (hosts that surface `api.error` themselves). */
|
|
38
41
|
hideError?: boolean;
|
|
@@ -51,7 +51,10 @@ export interface UseEditCommitOptions<V> {
|
|
|
51
51
|
/**
|
|
52
52
|
* `'done'` suppresses the live {@link onChange} notifications entirely (parsing still runs, so the
|
|
53
53
|
* error state and the commit-channel value stay current) and makes Enter the field's OWN commit
|
|
54
|
-
* point rather than a key the host form gets to see.
|
|
54
|
+
* point rather than a key the host form gets to see. A field's ✓/✗ adornments follow it: shown only
|
|
55
|
+
* in `'done'`, while the text differs from the committed value. Default `'live'`.
|
|
56
|
+
*
|
|
57
|
+
* It does not change when {@link onDone} fires — that is the same in both.
|
|
55
58
|
*/
|
|
56
59
|
changeOn?: 'live' | 'done';
|
|
57
60
|
/** The live PREVIEW channel — every valid text state. */
|
|
@@ -114,8 +117,17 @@ export interface EditCommitApi<V> {
|
|
|
114
117
|
revertToCommitted(): void;
|
|
115
118
|
/** Restore the session-start text (a cancel) and re-parse it. */
|
|
116
119
|
revertToBaseline(): void;
|
|
117
|
-
/**
|
|
118
|
-
|
|
120
|
+
/**
|
|
121
|
+
* Adopt `next` as the committed text (an outside value change): clean, unerrored, revert target.
|
|
122
|
+
*
|
|
123
|
+
* While the user is EDITING (a session open and touched) the text is theirs: `next` becomes the
|
|
124
|
+
* committed text but the display keeps what they typed, and the next accept shows `next` — see the
|
|
125
|
+
* module doc.
|
|
126
|
+
*
|
|
127
|
+
* @returns `false` when the display was left alone for that reason — its error state is still the
|
|
128
|
+
* typed text's, so the host must not overwrite it with `next`'s.
|
|
129
|
+
*/
|
|
130
|
+
resetCommitted(next: string, value?: V | null): boolean;
|
|
119
131
|
/** A session is starting: the CURRENT text becomes the cancel baseline. */
|
|
120
132
|
beginSession(): void;
|
|
121
133
|
/**
|
|
@@ -147,6 +159,9 @@ export interface EditCommitApi<V> {
|
|
|
147
159
|
*
|
|
148
160
|
* The rules it owns, once, for every field:
|
|
149
161
|
*
|
|
162
|
+
* - **Two channels, one mode.** `onChange` is the value while it is edited; `onDone` is the edit
|
|
163
|
+
* ending. `changeOn` governs only the first (and who owns Enter): an edit ENDS the same way in
|
|
164
|
+
* both modes — Enter, Tab, a blur to another input, the ✓/✗, `commit()`/`cancel()`, Escape.
|
|
150
165
|
* - **Two baselines.** `committedText` is the last ACCEPTED value; `baselineText` is the text when the
|
|
151
166
|
* current session started. They differ because the live-change model applies every intermediate
|
|
152
167
|
* change — "the value before" can then only mean before-the-session, not before-the-last-change.
|
|
@@ -161,6 +176,11 @@ export interface EditCommitApi<V> {
|
|
|
161
176
|
* CANCELS instead of committing, so focus never advances carrying an error.
|
|
162
177
|
* - **Invalid never commits** on any accept path; **blur commits only when dirty**; and a done key
|
|
163
178
|
* plus the blur it causes are ONE gesture, delivered once (the one-shot guard).
|
|
179
|
+
* - **The text is the user's while they edit.** A live host echoes each change back as its value, and
|
|
180
|
+
* the echo is often the value NORMALIZED (`09` → `9`, `9/2` → `9/2/2026`). Rewriting the display
|
|
181
|
+
* with it would retype the field under the caret, so an outside value that lands mid-edit only
|
|
182
|
+
* becomes the committed text; the accept that ends the edit shows it. An untouched field follows
|
|
183
|
+
* outside changes at once.
|
|
164
184
|
* - **The input owns its text keys.** Delete / caret motion / the native chords are consumed
|
|
165
185
|
* ({@link EditCommitApi.handleTextKeys}) so they never reach the app's command dispatch.
|
|
166
186
|
*
|
|
@@ -56,9 +56,8 @@ export interface InputFieldApi {
|
|
|
56
56
|
/** `true` when the text differs from the committed value's text. */
|
|
57
57
|
dirty: boolean;
|
|
58
58
|
/**
|
|
59
|
-
* `true` while an edit SESSION is open — for a plain field
|
|
60
|
-
* focus
|
|
61
|
-
* the session even though focus stays, exactly like the formula field's engagement.
|
|
59
|
+
* `true` while an edit SESSION is open — for a plain field, while it is focused. A done key ends the
|
|
60
|
+
* session and, focus staying, a fresh one starts — exactly like the formula field's engagement.
|
|
62
61
|
*/
|
|
63
62
|
engaged: boolean;
|
|
64
63
|
/** Restore the committed value's text (the field-level Escape). */
|
|
@@ -1,4 +1,5 @@
|
|
|
1
|
-
import { IRange, ICell, ICellRanges, ICellRange, IColor, ITable, INamedCollection, IStyleCollection,
|
|
1
|
+
import { IRange, ICell, ICellRanges, ICellRange, IColor, ITable, INamedCollection, IStyleCollection, ICellStyle, IBorders, ITheme, IThemeCollection, IFunction, IFunctionCollection, IWorkbook, ISlicer, IChart, IPivotTable, ISparklineGroup } from '@sheetxl/sdk';
|
|
2
|
+
import { PivotFieldsModel } from '../pivot/PivotFieldsModel';
|
|
2
3
|
/**
|
|
3
4
|
* For providing Adjustable Color Commands additional rendering capabilities.
|
|
4
5
|
*
|
|
@@ -25,7 +26,7 @@ export interface Border {
|
|
|
25
26
|
onBorderSelect: (border: Partial<IBorders.Properties>) => void;
|
|
26
27
|
}
|
|
27
28
|
export interface NamedStyle {
|
|
28
|
-
readonly named: () =>
|
|
29
|
+
readonly named: () => ICellStyle.INamed;
|
|
29
30
|
readonly styles: () => IStyleCollection;
|
|
30
31
|
createCell: (update: ICell.Update) => ICell;
|
|
31
32
|
}
|
|
@@ -46,6 +47,45 @@ export interface Table {
|
|
|
46
47
|
*/
|
|
47
48
|
resolveRanges: (address: ICellRanges.Address) => ICellRanges;
|
|
48
49
|
}
|
|
50
|
+
/** What the pivot table style gallery draws its previews with: the active pivot table and the workbook's styles. */
|
|
51
|
+
export interface Pivot {
|
|
52
|
+
/** `null` when the selection is in no pivot table. */
|
|
53
|
+
readonly pivot: () => IPivotTable | null;
|
|
54
|
+
readonly styles: () => IStyleCollection;
|
|
55
|
+
}
|
|
56
|
+
/** The pivot value settings window's value: one value of a pivot table, and what to change. */
|
|
57
|
+
export interface PivotValueSettings {
|
|
58
|
+
/** The value. The window starts from its settings, and reads its table's fields and their items. */
|
|
59
|
+
readonly value: IPivotTable.IDataField;
|
|
60
|
+
/** What the window hands back: the settings changed, the rest left out. */
|
|
61
|
+
readonly changes?: PivotFieldsModel.ValueSettings;
|
|
62
|
+
}
|
|
63
|
+
/** What a slicer-style gallery draws its previews with. */
|
|
64
|
+
export interface Slicer {
|
|
65
|
+
readonly slicer: () => ISlicer;
|
|
66
|
+
readonly styles: () => IStyleCollection;
|
|
67
|
+
}
|
|
68
|
+
/** What a chart's galleries (its type, its elements) read: the active chart. */
|
|
69
|
+
export interface Chart {
|
|
70
|
+
readonly chart: () => IChart;
|
|
71
|
+
}
|
|
72
|
+
/**
|
|
73
|
+
* What Insert Slicer offers: the fields a slicer can filter by, and the one the active cell is in,
|
|
74
|
+
* which a press filters by.
|
|
75
|
+
*/
|
|
76
|
+
export interface InsertSlicer {
|
|
77
|
+
/** A table's column names, or a pivot table's field names, in order. */
|
|
78
|
+
readonly fields: () => readonly string[];
|
|
79
|
+
/** The field the active cell is in; `null` when it is in none, as on a pivot table's values. */
|
|
80
|
+
readonly anchor: () => string | null;
|
|
81
|
+
}
|
|
82
|
+
/** What Insert Slicer adds. Each omitted: the field the active cell is in, in the default slicer style. */
|
|
83
|
+
export interface InsertSlicerOptions {
|
|
84
|
+
/** One of {@link InsertSlicer.fields}. */
|
|
85
|
+
field?: string;
|
|
86
|
+
/** A slicer style's name. */
|
|
87
|
+
style?: string;
|
|
88
|
+
}
|
|
49
89
|
export interface Theme {
|
|
50
90
|
readonly theme: ITheme;
|
|
51
91
|
readonly themes: IThemeCollection;
|
|
@@ -59,7 +99,7 @@ export interface NamedReference {
|
|
|
59
99
|
}
|
|
60
100
|
/**
|
|
61
101
|
* Used for the workbook-statistics dialog — the dialog profiles the live workbook itself
|
|
62
|
-
* (`IWorkbook.getStats` / `
|
|
102
|
+
* (`IWorkbook.getStats` / `IWorksheet.getStats`), so the context is just the model getter.
|
|
63
103
|
*/
|
|
64
104
|
export interface WorkbookStatistics {
|
|
65
105
|
getWorkbook: () => IWorkbook;
|
|
@@ -74,12 +114,70 @@ export interface ResizeHeaderContext {
|
|
|
74
114
|
toUnits?(value: number): number;
|
|
75
115
|
toPixels?(value: number): number;
|
|
76
116
|
}
|
|
117
|
+
/**
|
|
118
|
+
* The one group a Show / Hide Detail command acts on, named by its summary header; without it the
|
|
119
|
+
* command acts on the selection.
|
|
120
|
+
*/
|
|
121
|
+
export interface OutlineTarget {
|
|
122
|
+
axis: IRange.Axis;
|
|
123
|
+
/** The summary row or column, zero-based. */
|
|
124
|
+
index: number;
|
|
125
|
+
}
|
|
126
|
+
/** A gutter button's press: expand (`show`) or collapse the group whose summary this is. */
|
|
127
|
+
export interface OutlineToggle extends OutlineTarget {
|
|
128
|
+
show: boolean;
|
|
129
|
+
}
|
|
130
|
+
/** The level a level button shows: `level` on `axis`. */
|
|
131
|
+
export interface OutlineLevel {
|
|
132
|
+
axis: IRange.Axis;
|
|
133
|
+
level: number;
|
|
134
|
+
}
|
|
135
|
+
/** The outline settings window's value. */
|
|
136
|
+
export interface OutlineSettings {
|
|
137
|
+
/** Summary rows below their details (else above). */
|
|
138
|
+
summaryBelow: boolean;
|
|
139
|
+
/** Summary columns to the right of their details (else to the left). */
|
|
140
|
+
summaryRight: boolean;
|
|
141
|
+
/** Apply the automatic outline styles. */
|
|
142
|
+
automaticStyles: boolean;
|
|
143
|
+
}
|
|
77
144
|
export interface NewTable {
|
|
78
145
|
ranges: ICellRanges;
|
|
79
146
|
hasHeader?: boolean;
|
|
80
147
|
/** The table's name. When omitted the next free default name is used. */
|
|
81
148
|
name?: string;
|
|
82
149
|
}
|
|
150
|
+
/** What the Create Sparklines dialog makes, as `ICellRange.setSparkline` takes it. */
|
|
151
|
+
export interface NewSparklines {
|
|
152
|
+
/** The cells the sparklines draw: one area, on any sheet. */
|
|
153
|
+
data: ICellRanges | null;
|
|
154
|
+
/** The cells they draw in: one cell, or one row or one column of cells. */
|
|
155
|
+
location: ICellRanges | null;
|
|
156
|
+
type: ISparklineGroup.Type;
|
|
157
|
+
}
|
|
158
|
+
/** What the Edit Sparklines dialog changes, as `ISparklineGroup.setRanges` takes it. */
|
|
159
|
+
export interface EditSparklines {
|
|
160
|
+
/** The cells the sparklines draw: one or more areas, as `ISparklineGroup.getData` spells them. */
|
|
161
|
+
data: ICellRanges | string | null;
|
|
162
|
+
/** The cells they draw in: one or more areas, each a cell, a row or a column of cells. */
|
|
163
|
+
location: ICellRanges | null;
|
|
164
|
+
}
|
|
165
|
+
/** What the New PivotTable dialog makes, as `IPivotTableCollection.add` takes it. */
|
|
166
|
+
export interface NewPivotTable {
|
|
167
|
+
/** The cells to summarize: one range, or a table's or defined name's name. */
|
|
168
|
+
source: ICellRanges | string | null;
|
|
169
|
+
/** The table's top-left cell. */
|
|
170
|
+
location: ICellRanges | null;
|
|
171
|
+
/** The table's name. When omitted the next free default name is used. */
|
|
172
|
+
name?: string;
|
|
173
|
+
}
|
|
174
|
+
/** What the New PivotTable dialog asks of the workbook while it is open. */
|
|
175
|
+
export interface PivotTableTarget {
|
|
176
|
+
/** Throws for a name a new table cannot take on the sheet `location` is on. */
|
|
177
|
+
validateName(name: string, location: ICellRanges | null): void;
|
|
178
|
+
/** Why a new table cannot go at `location`, as a message key; `null` when it can. */
|
|
179
|
+
checkLocation(location: ICellRanges): string | null;
|
|
180
|
+
}
|
|
83
181
|
export interface SelectedRange {
|
|
84
182
|
range: ICellRange;
|
|
85
183
|
cell?: ICell.Address;
|