@sheetxl/react 0.8.0-beta.1 → 0.8.0-beta.11
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/browser/esm/1-LEUre9ZLG0OYYB.mjs +197 -0
- package/browser/esm/94dxo1A-z8lgiiGw.mjs +128 -0
- package/browser/esm/B26QVfjer2oY2ewK.mjs +32 -0
- package/browser/esm/B93LSmhnvkxNXTq-.mjs +42 -0
- package/browser/esm/BQYS2Yf-EAV_tBLr.mjs +20 -0
- package/{node/esm/DAE_NG8D9uT50zUH.mjs → browser/esm/BegvsXeRs7e-9t8k.mjs} +3 -4
- package/browser/esm/Bl2BFCQ00fotauKB.mjs +36 -0
- package/browser/esm/Bos4Rkp8UTF7QXUB.mjs +31 -0
- package/browser/esm/C1pc9F4Rt2C5FKUo.mjs +45 -0
- package/browser/esm/CPnnESfZz2jjJd82.mjs +134 -0
- package/browser/esm/CRi6DQ3UXmPEv-w_.mjs +729 -0
- package/browser/esm/ClAtIfYbsUPA073B.mjs +2706 -0
- package/browser/esm/CzRIbc-Lk__VMLKM.mjs +60 -0
- package/browser/esm/D2u6THGErqw64KQI.mjs +63 -0
- package/browser/esm/DMdsMPT0fWBbTkNn.mjs +67 -0
- package/browser/esm/DS66lAIM-9M-YoZQ.mjs +315 -0
- package/browser/esm/DgL7Dy-Lqcr1TvW6.mjs +23528 -0
- package/browser/esm/Dnh1kpz3v1JKtRD_.mjs +79 -0
- package/browser/esm/cQ6xdPFkEcuDlNTN.mjs +75 -0
- package/browser/esm/chart.mjs +40 -0
- package/browser/esm/control.mjs +216 -0
- package/browser/esm/group.mjs +123 -0
- package/browser/esm/index.mjs +15460 -8762
- package/browser/esm/note.mjs +112 -0
- package/browser/esm/picture.mjs +86 -0
- package/browser/esm/shape.mjs +7 -0
- package/browser/esm/slicer.mjs +276 -0
- package/browser/esm/ugfE7YeZALQURDKF.mjs +241 -0
- package/licenses/dependencies.txt +319 -600
- package/node/esm/6zApGj9DozhFy-bx.mjs +35 -0
- package/node/esm/BMVK5plvmBOAIlxP.mjs +80 -0
- package/node/esm/BaRfst1euuhquupX.mjs +66 -0
- package/node/esm/Be9c1GwQkPo8Piuh.mjs +134 -0
- package/node/esm/BiaDWnN3tT7neoRL.mjs +68 -0
- package/node/esm/BlxXufqBBg1PtsXd.mjs +8 -0
- package/node/esm/C_SNx7TlFEcwbYjx.mjs +2706 -0
- package/node/esm/DJPgbB1X22YmhbaR.mjs +242 -0
- package/node/esm/DTMTIrYIK1eZswsM.mjs +37 -0
- package/node/esm/D_pCpfdQowV_4Aje.mjs +198 -0
- package/node/esm/DgGEHydEjD7nfsDB.mjs +76 -0
- package/node/esm/Dj5FM7_-YWhCtCCt.mjs +45 -0
- package/node/esm/DxQZmb-j4NLUO9Af.mjs +63 -0
- package/node/esm/JiQGhLkoL8CJpVvA.mjs +20 -0
- package/node/esm/b-XRVRI1fYQQMkTC.mjs +1664 -0
- package/node/esm/chart.mjs +40 -0
- package/node/esm/control.mjs +216 -0
- package/node/esm/gpD-9LDW92phhoma.mjs +32 -0
- package/node/esm/group.mjs +123 -0
- package/node/esm/index.mjs +15830 -8966
- package/node/esm/note.mjs +113 -0
- package/node/esm/picture.mjs +86 -0
- package/node/esm/shape.mjs +735 -0
- package/node/esm/sigD1UFqvPlWUw_9.mjs +128 -0
- package/node/esm/slicer.mjs +278 -0
- package/node/esm/umljAT66yb3_rURh.mjs +320 -0
- package/package.json +55 -14
- package/resources/contents.json +24 -0
- package/resources/locales/contents.json +56 -0
- package/resources/locales/de/chart.cmd.json +82 -0
- package/resources/locales/de/movable.cmd.json +154 -0
- package/resources/locales/de/picture.cmd.json +31 -0
- package/resources/locales/de/selection.cmd.json +8 -0
- package/resources/locales/de/shape.cmd.json +17 -0
- package/resources/locales/de/sheet.cmd.json +339 -21
- package/resources/locales/de/slicer.cmd.json +17 -0
- package/resources/locales/de/table.cmd.json +9 -1
- package/resources/locales/de/ui.msg.json +321 -3
- package/resources/locales/de/workbook.cmd.json +15 -6
- package/resources/locales/en/chart.cmd.json +82 -0
- package/resources/locales/en/movable.cmd.json +154 -0
- package/resources/locales/en/picture.cmd.json +31 -0
- package/resources/locales/en/selection.cmd.json +8 -0
- package/resources/locales/en/shape.cmd.json +17 -0
- package/resources/locales/en/sheet.cmd.json +353 -22
- package/resources/locales/en/slicer.cmd.json +17 -0
- package/resources/locales/en/table.cmd.json +9 -1
- package/resources/locales/en/ui.msg.json +321 -3
- package/resources/locales/en/workbook.cmd.json +16 -7
- 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/RangeAnnotations.d.ts +119 -0
- package/types/src/annotation/index.d.ts +2 -0
- package/types/src/autoFill/AutoFillPresets.d.ts +14 -0
- package/types/src/autoFill/FillMenu.d.ts +36 -0
- package/types/src/autoFill/FillSeries.d.ts +38 -0
- package/types/src/autoFill/index.d.ts +4 -0
- package/types/src/border/StaticBorderRenderer.d.ts +19 -2
- package/types/src/border/useBorders.d.ts +81 -8
- package/types/src/cell/CornerTriangle.d.ts +6 -0
- package/types/src/cell/FormulaCellRenderer.d.ts +6 -3
- package/types/src/cell/OutlineButton.d.ts +123 -0
- package/types/src/cell/SheetCellRenderer.d.ts +2 -2
- package/types/src/cell/SheetHeaderRenderer.d.ts +5 -0
- package/types/src/cell/StaticCellRenderer.d.ts +57 -0
- package/types/src/cell/index.d.ts +2 -0
- package/types/src/cell/useFormulaViewAnchor.d.ts +3 -3
- package/types/src/chart/ChartCommands.d.ts +15 -0
- package/types/src/chart/ChartEditor.d.ts +10 -2
- package/types/src/chart/ChartElement.d.ts +111 -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 +46 -0
- package/types/src/chart/paint/echarts.d.ts +30 -0
- package/types/src/chart/paint/index.d.ts +12 -0
- package/types/src/chart/paint/kinds/ChartPaintKind.d.ts +132 -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 +12 -0
- package/types/src/chart/paint/toEChartsOption.d.ts +31 -0
- package/types/src/checklist/ValueChecklist.d.ts +112 -0
- package/types/src/checklist/index.d.ts +2 -0
- 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/{sheet → conditionalFormat}/ConditionalFormatPresets.d.ts +6 -6
- package/types/src/conditionalFormat/index.d.ts +1 -0
- 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/editor/EditorCommands.d.ts +3 -3
- package/types/src/editor/FunctionPreviewPanel.d.ts +15 -1
- package/types/src/editor/NamedItemLabel.d.ts +29 -0
- package/types/src/editor/NamedItemsPanel.d.ts +13 -2
- package/types/src/editor/SheetCellEditorLayer.d.ts +5 -9
- package/types/src/editor/SheetCellEditorStartLayer.d.ts +61 -0
- package/types/src/editor/SheetCellInput.d.ts +26 -2
- package/types/src/editor/SheetEditable.d.ts +14 -8
- package/types/src/editor/SheetReferenceLayer.d.ts +4 -4
- package/types/src/editor/VirtualKeyboardLayer.d.ts +49 -0
- package/types/src/editor/formulaAnchor.d.ts +12 -0
- package/types/src/editor/formulaCaret.d.ts +39 -10
- package/types/src/editor/formulaEval.d.ts +9 -5
- package/types/src/editor/formulaLint.d.ts +36 -0
- package/types/src/editor/formulaPresentation.d.ts +7 -0
- package/types/src/editor/formulaText.d.ts +17 -5
- package/types/src/editor/functionArgs.d.ts +20 -0
- package/types/src/editor/index.d.ts +5 -1
- package/types/src/editor/pickedReference.d.ts +76 -0
- package/types/src/editor/useEditRejectedNotice.d.ts +32 -0
- package/types/src/editor/useFormulaHints.d.ts +95 -5
- package/types/src/editor/useFormulaInput.d.ts +30 -4
- package/types/src/editor/useReferenceMode.d.ts +12 -0
- package/types/src/editor/validationAlert.d.ts +24 -0
- package/types/src/externalLink/ExternalLinksPaneArgs.d.ts +23 -0
- package/types/src/externalLink/index.d.ts +2 -0
- package/types/src/form/FormulaInput.d.ts +18 -2
- package/types/src/form/FormulaInputParts.d.ts +10 -1
- 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 +189 -7
- package/types/src/group/GroupEditor.d.ts +25 -0
- package/types/src/index.d.ts +14 -2
- package/types/src/io/WorkbookIO.d.ts +2 -0
- package/types/src/layer/BorderLayer.d.ts +2 -2
- package/types/src/layer/CellErrorLayer.d.ts +26 -9
- package/types/src/layer/CellFillLayer.d.ts +2 -2
- package/types/src/layer/CellInsertLayer.d.ts +71 -0
- package/types/src/layer/CircularIndicatorLayer.d.ts +2 -2
- 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/HyperlinkLayer.d.ts +109 -0
- package/types/src/layer/MovableKindScope.d.ts +17 -0
- package/types/src/layer/ProtectionLayer.d.ts +52 -0
- package/types/src/layer/RangeAnnotationLayer.d.ts +71 -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 +4 -4
- package/types/src/layer/SheetColumnButtonLayer.d.ts +2 -2
- package/types/src/layer/SheetGridLineLayer.d.ts +11 -13
- package/types/src/layer/SheetHeaderCellLayer.d.ts +10 -1
- package/types/src/layer/SheetLayers.d.ts +115 -0
- package/types/src/layer/SheetMovableLayer.d.ts +2 -2
- package/types/src/layer/SheetOutlineLayer.d.ts +40 -0
- package/types/src/layer/SheetTableCommandLayer.d.ts +2 -2
- 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 +42 -0
- package/types/src/layer/ValidationDropdownLayer.d.ts +17 -7
- package/types/src/layer/ValidationIndicatorLayer.d.ts +11 -5
- package/types/src/layer/ValidationPromptLayer.d.ts +65 -0
- package/types/src/layer/_tableColor.d.ts +4 -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 -1
- 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 +2 -2
- 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 +37 -37
- package/types/src/layer/useVisibleTables.d.ts +2 -2
- package/types/src/layer/validationMark.d.ts +63 -0
- 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/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 +40 -0
- package/types/src/movable/MovableCommands.d.ts +8 -3
- package/types/src/movable/MovableControl.d.ts +78 -0
- package/types/src/movable/MovableEdit.d.ts +22 -0
- package/types/src/movable/MovableFrame.d.ts +16 -13
- package/types/src/movable/MovableLayer.d.ts +25 -7
- 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/picker/PickerPanel.d.ts +52 -0
- package/types/src/picker/cellPickerOpen.d.ts +6 -0
- package/types/src/picker/index.d.ts +4 -0
- package/types/src/picker/useCellPicker.d.ts +95 -0
- package/types/src/picture/PictureCommands.d.ts +12 -0
- package/types/src/picture/PictureKind.d.ts +7 -0
- package/types/src/picture/index.d.ts +0 -1
- package/types/src/protection/ProtectionPaneArgs.d.ts +31 -0
- package/types/src/protection/index.d.ts +3 -0
- package/types/src/protection/unlockProtectedRanges.d.ts +23 -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 +16 -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 +1 -1
- package/types/src/sheet/{ISheetElement.d.ts → IWorksheetElement.d.ts} +107 -77
- package/types/src/sheet/OpaqueSheetElement.d.ts +21 -0
- package/types/src/sheet/SheetCommandProvider.d.ts +11 -6
- package/types/src/sheet/SheetCommands.d.ts +22 -7
- 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/_useHeaderMetrics.d.ts +11 -0
- package/types/src/sheet/circularReferences.d.ts +12 -4
- package/types/src/sheet/index.d.ts +6 -3
- package/types/src/sheet/useCycleHighlight.d.ts +21 -0
- 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/tabStrip/SheetTab.d.ts +1 -1
- package/types/src/tabStrip/TabStrip.d.ts +7 -0
- package/types/src/table/TableCommands.d.ts +2 -2
- package/types/src/taskPane/ITaskPane.d.ts +12 -1
- package/types/src/taskPane/MovablePane.d.ts +17 -0
- package/types/src/taskPane/TaskPaneArea.d.ts +7 -0
- package/types/src/taskPane/index.d.ts +1 -0
- package/types/src/theme/ThemeState.d.ts +14 -1
- package/types/src/theme/buildOOXMLThemeCSS.d.ts +2 -2
- package/types/src/theme/useGridColorScheme.d.ts +2 -2
- 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 +3 -2
- package/types/src/workbook/IWorkbookElement.d.ts +51 -5
- package/types/src/workbook/WorkbookCommands.d.ts +2 -4
- package/types/src/workbook/WorkbookStrip.d.ts +9 -0
- package/types/src/workbook/_followOrigin.d.ts +9 -0
- package/types/src/workbook/useWorkbookFormat.d.ts +3 -3
- package/browser/cjs/Bo9Kx3L_XQkGPBJ5.cjs +0 -1
- package/browser/cjs/Pl04-kDEQSO8_qFU.cjs +0 -156
- package/browser/cjs/index.cjs +0 -35
- package/browser/esm/SJMJzBwlXTJ9QIO5.mjs +0 -6286
- 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/editor/useProtectedEditNotice.d.ts +0 -14
- package/types/src/layer/validationList.d.ts +0 -84
- package/types/src/list/SheetValueList.d.ts +0 -93
- package/types/src/list/index.d.ts +0 -2
- package/types/src/movable/MoveableBundle.d.ts +0 -4
- package/types/src/sheet/SheetElement.d.ts +0 -15
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
import { CellCoords } from '@sheetxl/utils';
|
|
2
|
+
import { IWorksheet } from '@sheetxl/sdk';
|
|
3
|
+
/**
|
|
4
|
+
* The callback a host invokes on each rejected edit attempt.
|
|
5
|
+
*
|
|
6
|
+
* @param coords The cell it tried to edit.
|
|
7
|
+
* @param retry Re-attempts the same edit. Invoked when the notice was able to clear the reason —
|
|
8
|
+
* the user unlocked a password-gated range — so the edit they asked for opens after all.
|
|
9
|
+
*/
|
|
10
|
+
export type EditRejectedNotice = (coords?: CellCoords | null, retry?: () => void) => void;
|
|
11
|
+
/**
|
|
12
|
+
* The heads-up for a rejected edit attempt (`IEditable.startEdit` returning `false`). Returns the
|
|
13
|
+
* callback a host invokes on each rejection, with the cell it tried to edit. Three reasons are told
|
|
14
|
+
* apart:
|
|
15
|
+
*
|
|
16
|
+
* - **A password-gated unlocked range** — Excel's "Unlock Range": the password is asked for right
|
|
17
|
+
* there, and on a match the edit is re-attempted (`retry`), so typing into the cell is the way to
|
|
18
|
+
* unlock it. Shown every time, since each refusal is a concrete action to answer.
|
|
19
|
+
* - **Protected sheet** — Excel-style, shown once per **visit** to `sheet` (Excel re-warns each time
|
|
20
|
+
* you come (back) to a tab, so the once-flag resets on a `sheet` identity change and naturally on
|
|
21
|
+
* remount).
|
|
22
|
+
* - **Part of an array-entered block** — "You can't change part of an array", shown every time: the
|
|
23
|
+
* edit opens only when the whole block is selected.
|
|
24
|
+
*
|
|
25
|
+
* Any other non-editable reason stays silent.
|
|
26
|
+
*
|
|
27
|
+
* One instance should serve one visit scope — `WorksheetElement` creates it and threads the callback to
|
|
28
|
+
* every consumer it hosts (its imperative `startEdit` and each pane's editor layer), so four frozen
|
|
29
|
+
* panes never warn four times.
|
|
30
|
+
*/
|
|
31
|
+
export declare const useEditRejectedNotice: (sheet: IWorksheet) => EditRejectedNotice;
|
|
32
|
+
//# sourceMappingURL=useEditRejectedNotice.d.ts.map
|
|
@@ -1,6 +1,8 @@
|
|
|
1
1
|
import { default as React } from 'react';
|
|
2
|
-
import { ICalculation, INamedCollection } from '@sheetxl/sdk';
|
|
2
|
+
import { ICalculation, ICell, IFunction, INamedCollection } from '@sheetxl/sdk';
|
|
3
3
|
import { NamedItem } from './NamedItemsPanel';
|
|
4
|
+
import { FunctionCaretContext } from './formulaCaret';
|
|
5
|
+
import { FormulaArgument } from './functionArgs';
|
|
4
6
|
/**
|
|
5
7
|
* The autocomplete rows for a typed `prefix` — the whole list, from all three sources, in the order
|
|
6
8
|
* they are shown.
|
|
@@ -15,10 +17,13 @@ import { NamedItem } from './NamedItemsPanel';
|
|
|
15
17
|
* localized name is what gets inserted, and that is correct: the editing compiler binds it back to
|
|
16
18
|
* canonical and storage stays canonical. Capped at {@link MAX_FUNCTION_RESULTS} *before* the merge.
|
|
17
19
|
* - **Names and tables** — one collection (a table is an `INamed` whose `getType()` is `'table'`).
|
|
18
|
-
* Pass the SHEET's (`
|
|
20
|
+
* Pass the SHEET's (`IWorksheet.getNames()`), which already holds exactly what a formula written there
|
|
19
21
|
* can refer to, shadowing resolved — the workbook's would offer other sheets' private names.
|
|
20
22
|
* Deliberately NOT localized: a defined name is the user's own text, spelled the same in every
|
|
21
|
-
* language.
|
|
23
|
+
* language. A name whose body is `LAMBDA(…)` is offered as `'lambda'`, completed like a function.
|
|
24
|
+
* - **`LET` / `LAMBDA` names** — `bound`, the names in scope at the caret (the caret token's
|
|
25
|
+
* `FormulaTokenContext.bound`). One
|
|
26
|
+
* shadows a defined name or table spelled the same, as it does when the formula binds.
|
|
22
27
|
*
|
|
23
28
|
* A name colliding with a FUNCTION name is pathological but possible; the function wins, because that
|
|
24
29
|
* is what the compiler binds a bare identifier to — completing to the name would insert text that
|
|
@@ -26,7 +31,74 @@ import { NamedItem } from './NamedItemsPanel';
|
|
|
26
31
|
*
|
|
27
32
|
* Pure and total: either source failing costs only its own rows, never the list.
|
|
28
33
|
*/
|
|
29
|
-
export declare const buildMatches: (calc: ICalculation, prefix: string, names: INamedCollection | null) => NamedItem[];
|
|
34
|
+
export declare const buildMatches: (calc: ICalculation, prefix: string, names: INamedCollection | null, bound?: readonly ICalculation.BoundName[]) => NamedItem[];
|
|
35
|
+
/** A `LET` name's lambda — {@link ICalculation.BoundName.params} with its parameters. */
|
|
36
|
+
type BoundLambda = ICalculation.BoundName & Required<Pick<ICalculation.BoundName, 'params'>>;
|
|
37
|
+
/**
|
|
38
|
+
* Whose signature a call at the caret shows, resolved as the binder resolves the call: a built-in
|
|
39
|
+
* function wins outright, then a `LET` / `LAMBDA` name in scope, then a named lambda.
|
|
40
|
+
*
|
|
41
|
+
* @returns `null` when nothing describes the call — an unknown name, or a name in scope that is not
|
|
42
|
+
* bound to a literal `LAMBDA` (the call applies that name, whose parameters are unknown).
|
|
43
|
+
*/
|
|
44
|
+
export declare const resolveCallTarget: (calc: ICalculation, ctx: FunctionCaretContext) => {
|
|
45
|
+
fn: IFunction;
|
|
46
|
+
} | {
|
|
47
|
+
bound: BoundLambda;
|
|
48
|
+
} | null;
|
|
49
|
+
/**
|
|
50
|
+
* An `'enum'` row, carrying which member it is, so its label can follow the function's descriptor
|
|
51
|
+
* once that arrives.
|
|
52
|
+
*/
|
|
53
|
+
export type EnumMatch = NamedItem & {
|
|
54
|
+
enumOf: {
|
|
55
|
+
fn: string;
|
|
56
|
+
id: string;
|
|
57
|
+
member: string;
|
|
58
|
+
};
|
|
59
|
+
};
|
|
60
|
+
/**
|
|
61
|
+
* The rows for an EMPTY argument whose parameter is limited to an enum (`SUBTOTAL(` → `AVERAGE 1`,
|
|
62
|
+
* `COUNT 2`, …), in declaration order, or `[]` when the caret is anywhere else.
|
|
63
|
+
*
|
|
64
|
+
* The rows themselves are {@link buildParamEnumMatches}'s. Only an empty argument offers the list: once
|
|
65
|
+
* anything is typed there — a reference, an expression, a literal — the argument is the user's, which
|
|
66
|
+
* is always legal in the slot.
|
|
67
|
+
*/
|
|
68
|
+
export declare const buildEnumMatches: (calc: ICalculation, tokens: readonly ICalculation.FormulaToken[], caret: number, base: number, locale: string | null) => EnumMatch[];
|
|
69
|
+
/**
|
|
70
|
+
* One row per value `param` of `fn` offers, in declaration order — `[]` for a parameter with no
|
|
71
|
+
* enum. A `@deprecated` member is in the set but not offered.
|
|
72
|
+
*
|
|
73
|
+
* A row reads as its member's name, then the literal accepting it inserts (`detail` and `insert`) —
|
|
74
|
+
* in the workbook `locale`'s decimal, and a string quoted. An unnamed union's members are named by
|
|
75
|
+
* their values, so theirs is the literal alone. The localized label and the member's description
|
|
76
|
+
* come from the function's descriptor (`getEnums()`), which the hook applies when it arrives.
|
|
77
|
+
*/
|
|
78
|
+
export declare const buildParamEnumMatches: (fn: IFunction, param: IFunction.IParameterType, locale: string | null) => EnumMatch[];
|
|
79
|
+
/** Where a table's parts are being typed — see {@link buildTableMatches}. */
|
|
80
|
+
export interface TablePartSite {
|
|
81
|
+
/** The cell the formula is written in, when there is one. */
|
|
82
|
+
home?: ICell | null;
|
|
83
|
+
/** The part is an item of a bracketed list (`Sales[[#Headers],[Co`), where `@` is not written. */
|
|
84
|
+
nested?: boolean;
|
|
85
|
+
}
|
|
86
|
+
/**
|
|
87
|
+
* The autocomplete rows inside a table's brackets (`Sales[Co`), in Excel's order: this row first, then
|
|
88
|
+
* the table's columns in table order, then the section specifiers `#All`, `#Data`, `#Headers`,
|
|
89
|
+
* `#Totals`. Each row's `detail` is the region it designates.
|
|
90
|
+
*
|
|
91
|
+
* - `part` is the unfinished part's token value: its `table` is found by name in `names` (the sheet's
|
|
92
|
+
* collection, as for {@link buildMatches}), and its `partial` says whether columns, specifiers or both
|
|
93
|
+
* may finish it. An unqualified reference (`table` `''`) or an unknown table offers nothing.
|
|
94
|
+
* - This row is `@ - This Row` and inserts `@`, as Excel offers it; in a bracketed list, where `@`
|
|
95
|
+
* cannot stand, it is `#This Row`.
|
|
96
|
+
* - A formula inside the table (`site.home`) is offered no section but this row.
|
|
97
|
+
* - Specifiers are spelled in the active language and match on that spelling or the canonical English
|
|
98
|
+
* one.
|
|
99
|
+
* - Matching is a case-insensitive prefix match on what was typed.
|
|
100
|
+
*/
|
|
101
|
+
export declare const buildTableMatches: (prefix: string, names: INamedCollection | null, part: ICalculation.TablePartRef, site?: TablePartSite) => NamedItem[];
|
|
30
102
|
/**
|
|
31
103
|
* Start offset (after the leading prefix — `base`) of the INNERMOST function call that is still OPEN at
|
|
32
104
|
* `caret` — the offset of that call's *name token* — or `null` when the caret isn't inside an open call.
|
|
@@ -66,11 +138,17 @@ export interface UseFormulaHintsOptions {
|
|
|
66
138
|
* then holds functions only, exactly as before.
|
|
67
139
|
*
|
|
68
140
|
* @remarks
|
|
69
|
-
* Must be the SHEET's collection (`
|
|
141
|
+
* Must be the SHEET's collection (`IWorksheet.getNames()`), not the workbook's: that one holds exactly
|
|
70
142
|
* what a formula on that sheet can refer to, so no scoping is needed here. The workbook's would
|
|
71
143
|
* offer another sheet's private names, which complete to expressions that do not resolve.
|
|
72
144
|
*/
|
|
73
145
|
getNames?(): INamedCollection | null;
|
|
146
|
+
/**
|
|
147
|
+
* The cell the formula is written in. Inside a table's brackets it decides which rows are offered
|
|
148
|
+
* (a formula inside the table is offered no section but this row) and how their regions are shown.
|
|
149
|
+
* Omit for a host with no cell.
|
|
150
|
+
*/
|
|
151
|
+
getCell?(): ICell | null;
|
|
74
152
|
/** Workbook locale (drives the argument-separator shown in the signature). `null` → `'en'`. */
|
|
75
153
|
getLocale(): string | null;
|
|
76
154
|
/**
|
|
@@ -83,6 +161,17 @@ export interface UseFormulaHintsOptions {
|
|
|
83
161
|
* signature preview. Pass the live value (it participates in the panel identity).
|
|
84
162
|
*/
|
|
85
163
|
hoveredTokenIndex?: number | null;
|
|
164
|
+
/**
|
|
165
|
+
* The argument the WHOLE text is, for a field that edits one argument of a call rather than a
|
|
166
|
+
* formula containing it — the Function Arguments form. While such a field is empty, it offers the
|
|
167
|
+
* values its parameter is limited to, the same rows an empty argument offers in the cell editor.
|
|
168
|
+
*
|
|
169
|
+
* @remarks
|
|
170
|
+
* Offered with nothing highlighted: a form is walked with Tab, and Tab past an optional field must
|
|
171
|
+
* leave it empty rather than fill in the first value. An arrow key picks a row, and only then do
|
|
172
|
+
* Enter and Tab accept it.
|
|
173
|
+
*/
|
|
174
|
+
getArgument?(): FormulaArgument | null;
|
|
86
175
|
}
|
|
87
176
|
/** What {@link useFormulaHints} hands the hosting chrome. */
|
|
88
177
|
export interface FormulaHintsApi {
|
|
@@ -123,4 +212,5 @@ export interface FormulaHintsApi {
|
|
|
123
212
|
* box), the open/close policy, and when {@link FormulaHintsApi.update} runs.
|
|
124
213
|
*/
|
|
125
214
|
export declare const useFormulaHints: (options: UseFormulaHintsOptions) => FormulaHintsApi;
|
|
215
|
+
export {};
|
|
126
216
|
//# sourceMappingURL=useFormulaHints.d.ts.map
|
|
@@ -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
|
/**
|
|
@@ -102,7 +104,8 @@ export interface UseFormulaInputOptions {
|
|
|
102
104
|
* Default `false` (single range; a pick replaces). Named to match the picker tier's `allowMulti`
|
|
103
105
|
* (`useSelectionPointer` / `RangesPickerLayer`) — it rides the bus state to gate the grid gesture.
|
|
104
106
|
*
|
|
105
|
-
* `'
|
|
107
|
+
* A `'formula'` field defaults to `true` and gates only the pick: `false` makes Ctrl+click replace
|
|
108
|
+
* rather than add a reference, while a typed expression may still hold any number of them.
|
|
106
109
|
*/
|
|
107
110
|
allowMulti?: boolean;
|
|
108
111
|
/**
|
|
@@ -122,6 +125,15 @@ export interface UseFormulaInputOptions {
|
|
|
122
125
|
* for anything that genuinely spans sheets, e.g. chart series.
|
|
123
126
|
*/
|
|
124
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;
|
|
125
137
|
/** Disabled: never engages the bus; the text is read-only at the host's discretion. */
|
|
126
138
|
disabled?: boolean;
|
|
127
139
|
/** Resolution context. Defaults to the enclosing `WorkbookContext`. */
|
|
@@ -161,6 +173,19 @@ export interface UseFormulaInputOptions {
|
|
|
161
173
|
* whoever reads it — and the table-resize shape (Excel's `$A$3:$D$9`).
|
|
162
174
|
*/
|
|
163
175
|
pickAs?: 'absolute' | 'relative';
|
|
176
|
+
/**
|
|
177
|
+
* Whether a pick that is exactly a dynamic array's spill writes the anchor plus `#` (`D2#`) instead
|
|
178
|
+
* of its address. Default `false`.
|
|
179
|
+
*
|
|
180
|
+
* @remarks
|
|
181
|
+
* `D2#` follows the spill as it grows or shrinks; `D2:E4` stays the extent it was picked at. The
|
|
182
|
+
* formula bar and in-grid editor always write `#`; Excel's range fields (conditional formatting,
|
|
183
|
+
* defined names, dialogs) do not, which is the default here. A name defined over the same extent
|
|
184
|
+
* does not win here the way it does in the cell editor — fields never write names for a pick. A
|
|
185
|
+
* single cell, an array-entered block and a blocked spill always write an address. The `$` style
|
|
186
|
+
* follows {@link pickAs} and re-scoping as for an address, on the anchor (`$D$2#`).
|
|
187
|
+
*/
|
|
188
|
+
pickSpills?: boolean;
|
|
164
189
|
/**
|
|
165
190
|
* The COMMIT channel: fires with the final parsed value at each commit point — a done key
|
|
166
191
|
* (Enter/Tab/Escape, from the field or the GRID), the explicit {@link FormulaInputApi.commit}
|
|
@@ -239,7 +264,8 @@ export interface FormulaInputApi {
|
|
|
239
264
|
* - `'formula'` — armed by CARET CONTEXT (the cell editor's model): an operand expected at the
|
|
240
265
|
* caret, or the caret on a reference token. Elsewhere (a function name, a number) the caret does
|
|
241
266
|
* text work — and the bus drops to `'show'`, so the references stay displayed (rectangles still
|
|
242
|
-
* 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.
|
|
243
269
|
*/
|
|
244
270
|
pointArmed: boolean;
|
|
245
271
|
/** Arm/disarm picking without focus (the adornment toggle). */
|
|
@@ -82,6 +82,18 @@ export interface ReferenceModeState {
|
|
|
82
82
|
* all on this sheet, and the existing per-pane scope filter already drops everything else.)
|
|
83
83
|
*/
|
|
84
84
|
scope?: string;
|
|
85
|
+
/**
|
|
86
|
+
* Show the ranges and nothing else — no move, no resize grips, no grid-draw.
|
|
87
|
+
*
|
|
88
|
+
* @remarks
|
|
89
|
+
* Declared by the PRODUCER, like {@link allowMulti} and {@link scope}, because it is a property of
|
|
90
|
+
* what is being shown: these ranges are an ANNOTATION rather than a pick. A hovered cell's
|
|
91
|
+
* reference cycle is the case it exists for — there is no text behind it for a drag to write back
|
|
92
|
+
* to, so an outline the user can grab would be an edit gesture with nowhere to go. `'show'` on its
|
|
93
|
+
* own still allows the drag (that is how a chart's series is re-homed); this is the narrower
|
|
94
|
+
* disposition. Absent ⇒ interactive, the existing default.
|
|
95
|
+
*/
|
|
96
|
+
readOnly?: boolean;
|
|
85
97
|
/**
|
|
86
98
|
* `true` while a reference rectangle is actively being dragged/resized/drawn on the grid. Published by the
|
|
87
99
|
* reference layer (from the picker's drag lifecycle) so a consumer — e.g. the formula editor — can react to
|
|
@@ -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
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The activation argument the **Workbook Links** pane understands.
|
|
3
|
+
*
|
|
4
|
+
* @remarks
|
|
5
|
+
* Lives with the feature rather than with the task-pane primitives: `taskPane` is the generic host
|
|
6
|
+
* and knows nothing about what any particular pane shows — the same arrangement
|
|
7
|
+
* `ProtectionPaneArgs` uses.
|
|
8
|
+
*
|
|
9
|
+
* Absent ⇒ the pane keeps whichever tab it is on (`links` on a fresh open). It is scoped to ONE
|
|
10
|
+
* activation, like every `args` payload — see `TaskPaneProps.args`.
|
|
11
|
+
*/
|
|
12
|
+
export interface ExternalLinksPaneArgs {
|
|
13
|
+
/** Which tab to show. */
|
|
14
|
+
tab?: ExternalLinksPaneArgs.Tab;
|
|
15
|
+
}
|
|
16
|
+
export declare namespace ExternalLinksPaneArgs {
|
|
17
|
+
/**
|
|
18
|
+
* `links` is the list of linked books; `settings` is the workbook's `updateLinks` policy, which
|
|
19
|
+
* is about every link at once rather than about any one of them.
|
|
20
|
+
*/
|
|
21
|
+
type Tab = 'links' | 'settings';
|
|
22
|
+
}
|
|
23
|
+
//# sourceMappingURL=ExternalLinksPaneArgs.d.ts.map
|
|
@@ -2,6 +2,7 @@ import { default as React } from 'react';
|
|
|
2
2
|
import { ICalculation, ICellRanges, IRange, IWorkbook } from '@sheetxl/sdk';
|
|
3
3
|
import { FormulaInputApi, FormulaInputGrammar, FormulaInputEquals } from '../editor/useFormulaInput';
|
|
4
4
|
import { ReferenceDoneArgs } from '../editor/useReferenceMode';
|
|
5
|
+
import { FormulaArgument } from '../editor/functionArgs';
|
|
5
6
|
/**
|
|
6
7
|
* Props for the plain-DOM {@link FormulaInput} — the UI-kit-free field whose value is an
|
|
7
8
|
* `ICalculation.IFormula`.
|
|
@@ -25,13 +26,16 @@ export interface FormulaInputProps extends Omit<React.InputHTMLAttributes<HTMLIn
|
|
|
25
26
|
onChangeText?: (text: string) => void;
|
|
26
27
|
/** The commit channel. See `UseFormulaInputOptions.onDone`. */
|
|
27
28
|
onDone?: (value: ICalculation.IFormula | null, args: ReferenceDoneArgs) => void;
|
|
28
|
-
/**
|
|
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
|
+
*/
|
|
29
33
|
changeOn?: 'live' | 'done';
|
|
30
34
|
/** Resolution/picking context. Defaults to the enclosing `WorkbookContext`. */
|
|
31
35
|
workbook?: IWorkbook | null;
|
|
32
36
|
/** The headless field API, for host-driven commit points (a dialog's OK → `apiRef.current?.commit()`). */
|
|
33
37
|
apiRef?: React.Ref<FormulaInputApi>;
|
|
34
|
-
/** Hide the adornment cluster (✓/✗ while
|
|
38
|
+
/** Hide the adornment cluster (✓/✗ while editing in `'done'` mode; the select-current action). */
|
|
35
39
|
hideAdornment?: boolean;
|
|
36
40
|
/** Hide the error line under the field (hosts that surface `api.error` themselves). */
|
|
37
41
|
hideError?: boolean;
|
|
@@ -54,6 +58,12 @@ export interface FormulaInputProps extends Omit<React.InputHTMLAttributes<HTMLIn
|
|
|
54
58
|
* table-resize shape. See `UseFormulaInputOptions.pickAs`.
|
|
55
59
|
*/
|
|
56
60
|
pickAs?: 'absolute' | 'relative';
|
|
61
|
+
/**
|
|
62
|
+
* Whether a pick that is exactly a dynamic array's spill writes `D2#` instead of its address.
|
|
63
|
+
* Default `false`, as Excel's range fields; the cell editor always does. See
|
|
64
|
+
* `UseFormulaInputOptions.pickSpills`.
|
|
65
|
+
*/
|
|
66
|
+
pickSpills?: boolean;
|
|
57
67
|
/**
|
|
58
68
|
* Allow a comma-separated multi-range reference (typed, or Ctrl+click-picked). Default `false`.
|
|
59
69
|
* `'reference'` grammar only — a `'formula'` field always allows every reference its expression holds.
|
|
@@ -66,6 +76,12 @@ export interface FormulaInputProps extends Omit<React.InputHTMLAttributes<HTMLIn
|
|
|
66
76
|
* `UseFormulaInputOptions.allowCrossSheet`; independent of {@link allowMulti}.
|
|
67
77
|
*/
|
|
68
78
|
allowCrossSheet?: boolean;
|
|
79
|
+
/**
|
|
80
|
+
* The call argument this field's whole text is — the Function Arguments form's rows. An empty field
|
|
81
|
+
* then offers, in its hint popup, the values the parameter is limited to. See
|
|
82
|
+
* `UseFormulaHintsOptions.getArgument`.
|
|
83
|
+
*/
|
|
84
|
+
argument?: FormulaArgument | null;
|
|
69
85
|
}
|
|
70
86
|
/**
|
|
71
87
|
* The **formula field** — the plain-DOM (UI-kit-free) input whose value is an
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { default as React } from 'react';
|
|
2
2
|
import { IRange, IWorkbook } from '@sheetxl/sdk';
|
|
3
|
+
import { FormulaArgument } from '../editor/functionArgs';
|
|
3
4
|
import { FormulaInputApi, FormulaInputGrammar } from '../editor/useFormulaInput';
|
|
4
5
|
export interface UseFormulaInputPartsOptions {
|
|
5
6
|
/** The headless field API driving this chrome (`useFormulaInput`). */
|
|
@@ -15,6 +16,11 @@ export interface UseFormulaInputPartsOptions {
|
|
|
15
16
|
workbook?: IWorkbook | null;
|
|
16
17
|
/** The formula's HOME anchor (`'formula'` grammar) — bare references evaluate against it. */
|
|
17
18
|
home?: Partial<IRange.CellCoords>;
|
|
19
|
+
/**
|
|
20
|
+
* The call argument the field's whole text is — see `UseFormulaHintsOptions.getArgument`. An
|
|
21
|
+
* empty field then offers the values its parameter is limited to.
|
|
22
|
+
*/
|
|
23
|
+
argument?: FormulaArgument | null;
|
|
18
24
|
}
|
|
19
25
|
/**
|
|
20
26
|
* What {@link useFormulaInputParts} hands a field chrome. Wire the three refs (the positioned
|
|
@@ -43,6 +49,8 @@ export interface FormulaInputParts {
|
|
|
43
49
|
onSelect: (e: React.SyntheticEvent) => void;
|
|
44
50
|
/** Clicking back into the field re-summons a dismissed hint popup (Excel-style). */
|
|
45
51
|
onPointerDown: (e: React.PointerEvent) => void;
|
|
52
|
+
/** A press on the field means "select", never "move the text" — see `useTextSelectionDrag`. */
|
|
53
|
+
onDragStart: (e: React.DragEvent) => void;
|
|
46
54
|
};
|
|
47
55
|
/**
|
|
48
56
|
* The shared parts' keyboard: the hint popup's (autocomplete list nav; Escape dismisses an open
|
|
@@ -56,7 +64,8 @@ export interface FormulaInputParts {
|
|
|
56
64
|
* `'formula'` grammar, while engaged: an operand is expected at the caret (the "input expected"
|
|
57
65
|
* marker is showing — trailing `=A1+|`, or a cleared argument `=SUM(|,A1:C3)`). The user is 99%
|
|
58
66
|
* mid-typing — chromes should NOT present `api.error` as "invalid" while this holds (the commit
|
|
59
|
-
* gate still blocks an incomplete accept).
|
|
67
|
+
* gate still blocks an incomplete accept). Only while the input has focus: text left that way is
|
|
68
|
+
* an error, even though a blur while pointing keeps the field engaged.
|
|
60
69
|
*/
|
|
61
70
|
inputExpected: boolean;
|
|
62
71
|
/** The measured coloring overlay (`null` while inactive/unmeasured). Render inside the container. */
|
|
@@ -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). */
|