@viewkitjs/views 0.0.0-stage → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +615 -0
- package/LICENSE.md +7 -0
- package/README.md +99 -2
- package/dist/atoms/CommandMenu.d.ts +2 -0
- package/dist/atoms/CommandMenu.js +20 -0
- package/dist/atoms/List.d.ts +2 -0
- package/dist/atoms/List.js +6 -0
- package/dist/atoms/LoadMore.d.ts +2 -0
- package/dist/atoms/LoadMore.js +25 -0
- package/dist/atoms/Loading.d.ts +2 -0
- package/dist/atoms/Loading.js +7 -0
- package/dist/atoms/PlatformMark.d.ts +2 -0
- package/dist/atoms/PlatformMark.js +4 -0
- package/dist/atoms/RelationLink.d.ts +2 -0
- package/dist/atoms/RelationLink.js +6 -0
- package/dist/atoms/Row.d.ts +3 -0
- package/dist/atoms/Row.js +30 -0
- package/dist/atoms/RowMenu.d.ts +2 -0
- package/dist/atoms/RowMenu.js +112 -0
- package/dist/atoms/StatusBadge.d.ts +2 -0
- package/dist/atoms/StatusBadge.js +7 -0
- package/dist/atoms/StatusMarker.d.ts +2 -0
- package/dist/atoms/StatusMarker.js +19 -0
- package/dist/atoms/Tag.d.ts +2 -0
- package/dist/atoms/Tag.js +13 -0
- package/dist/atoms/TickBox.d.ts +2 -0
- package/dist/atoms/TickBox.js +8 -0
- package/dist/atoms/defaults.d.ts +2 -0
- package/dist/atoms/defaults.js +27 -0
- package/dist/atoms/tones.d.ts +5 -0
- package/dist/atoms/tones.js +28 -0
- package/dist/atoms/types.d.ts +178 -0
- package/dist/atoms/types.js +3 -0
- package/dist/cells/cell-format.d.ts +138 -0
- package/dist/cells/cell-format.js +16 -0
- package/dist/cells/cell-title.d.ts +17 -0
- package/dist/cells/cell-title.js +8 -0
- package/dist/cells/cell-values.d.ts +28 -0
- package/dist/cells/cell-values.js +87 -0
- package/dist/cells/index.d.ts +4 -0
- package/dist/cells/index.js +4 -0
- package/dist/cells/legacy-field.d.ts +52 -0
- package/dist/cells/legacy-field.js +164 -0
- package/dist/cells/relation-wrap.d.ts +3 -0
- package/dist/cells/relation-wrap.js +24 -0
- package/dist/cells/use-cell-format.d.ts +5 -0
- package/dist/cells/use-cell-format.js +10 -0
- package/dist/contract.d.ts +461 -0
- package/dist/contract.js +682 -0
- package/dist/display/actor.d.ts +4 -0
- package/dist/display/actor.js +26 -0
- package/dist/display/boolean.d.ts +18 -0
- package/dist/display/boolean.js +43 -0
- package/dist/display/breakdown.d.ts +15 -0
- package/dist/display/breakdown.js +32 -0
- package/dist/display/currency.d.ts +9 -0
- package/dist/display/currency.js +29 -0
- package/dist/display/date.d.ts +12 -0
- package/dist/display/date.js +26 -0
- package/dist/display/display-cores.d.ts +31 -0
- package/dist/display/display-cores.js +57 -0
- package/dist/display/entity-chip.d.ts +26 -0
- package/dist/display/entity-chip.js +9 -0
- package/dist/display/format.d.ts +66 -0
- package/dist/display/format.js +190 -0
- package/dist/display/index.d.ts +8 -0
- package/dist/display/index.js +7 -0
- package/dist/display/link.d.ts +29 -0
- package/dist/display/link.js +50 -0
- package/dist/display/location.d.ts +8 -0
- package/dist/display/location.js +22 -0
- package/dist/display/multi-value.d.ts +18 -0
- package/dist/display/multi-value.js +28 -0
- package/dist/display/name.d.ts +6 -0
- package/dist/display/name.js +14 -0
- package/dist/display/number.d.ts +11 -0
- package/dist/display/number.js +27 -0
- package/dist/display/options.d.ts +153 -0
- package/dist/display/options.js +1 -0
- package/dist/display/percent.d.ts +4 -0
- package/dist/display/percent.js +40 -0
- package/dist/display/phone.d.ts +11 -0
- package/dist/display/phone.js +45 -0
- package/dist/display/range.d.ts +6 -0
- package/dist/display/range.js +29 -0
- package/dist/display/relation.d.ts +4 -0
- package/dist/display/relation.js +29 -0
- package/dist/display/rich-text.d.ts +10 -0
- package/dist/display/rich-text.js +34 -0
- package/dist/display/select.d.ts +6 -0
- package/dist/display/select.js +38 -0
- package/dist/display/text-class.d.ts +23 -0
- package/dist/display/text-class.js +5 -0
- package/dist/display/text.d.ts +19 -0
- package/dist/display/text.js +8 -0
- package/dist/display/use-display-options.d.ts +2 -0
- package/dist/display/use-display-options.js +14 -0
- package/dist/display/user.d.ts +11 -0
- package/dist/display/user.js +10 -0
- package/dist/display/value-list.d.ts +10 -0
- package/dist/display/value-list.js +12 -0
- package/dist/display/viewer.d.ts +4 -0
- package/dist/display/viewer.js +11 -0
- package/dist/display/web-href.d.ts +8 -0
- package/dist/display/web-href.js +12 -0
- package/dist/editors/ChipsEditor.d.ts +59 -0
- package/dist/editors/ChipsEditor.js +73 -0
- package/dist/editors/DateEditor.d.ts +25 -0
- package/dist/editors/DateEditor.js +122 -0
- package/dist/editors/LocationEditor.d.ts +22 -0
- package/dist/editors/LocationEditor.js +228 -0
- package/dist/editors/NameEditor.d.ts +22 -0
- package/dist/editors/NameEditor.js +92 -0
- package/dist/editors/NumberEditor.d.ts +67 -0
- package/dist/editors/NumberEditor.js +86 -0
- package/dist/editors/RangeEditor.d.ts +22 -0
- package/dist/editors/RangeEditor.js +70 -0
- package/dist/editors/RelationEditor.d.ts +65 -0
- package/dist/editors/RelationEditor.js +64 -0
- package/dist/editors/SelectEditor.d.ts +72 -0
- package/dist/editors/SelectEditor.js +59 -0
- package/dist/editors/ValueListEditor.d.ts +38 -0
- package/dist/editors/ValueListEditor.js +217 -0
- package/dist/editors/edit-cores.d.ts +83 -0
- package/dist/editors/edit-cores.js +38 -0
- package/dist/editors/edit-session.d.ts +74 -0
- package/dist/editors/edit-session.js +35 -0
- package/dist/editors/open-values.d.ts +28 -0
- package/dist/editors/open-values.js +26 -0
- package/dist/editors/relation-source.d.ts +66 -0
- package/dist/editors/relation-source.js +102 -0
- package/dist/fields/binding.d.ts +87 -0
- package/dist/fields/binding.js +117 -0
- package/dist/fields/currency.d.ts +82 -0
- package/dist/fields/currency.js +41 -0
- package/dist/fields/denomination.d.ts +42 -0
- package/dist/fields/denomination.js +11 -0
- package/dist/fields/edit-core-types.d.ts +40 -0
- package/dist/fields/edit-core-types.js +29 -0
- package/dist/fields/format-knobs.d.ts +34 -0
- package/dist/fields/format-knobs.js +36 -0
- package/dist/fields/menus.d.ts +28 -0
- package/dist/fields/menus.js +1 -0
- package/dist/fields/money.d.ts +60 -0
- package/dist/fields/money.js +78 -0
- package/dist/fields/number-edit.d.ts +11 -0
- package/dist/fields/number-edit.js +17 -0
- package/dist/fields/prepare-write.d.ts +55 -0
- package/dist/fields/prepare-write.js +67 -0
- package/dist/fields/relation-source-types.d.ts +54 -0
- package/dist/fields/relation-source-types.js +1 -0
- package/dist/figures.d.ts +52 -0
- package/dist/figures.js +63 -0
- package/dist/filters/date-filter.d.ts +2 -0
- package/dist/filters/date-filter.js +1 -0
- package/dist/filters/filter-model.d.ts +176 -0
- package/dist/filters/filter-model.js +41 -0
- package/dist/filters/number-filter.d.ts +2 -0
- package/dist/filters/number-filter.js +1 -0
- package/dist/filters/range-filter.d.ts +2 -0
- package/dist/filters/range-filter.js +1 -0
- package/dist/filters/registry.d.ts +103 -0
- package/dist/filters/registry.js +8 -0
- package/dist/filters/relation-filter.d.ts +16 -0
- package/dist/filters/relation-filter.js +53 -0
- package/dist/filters/text-filter.d.ts +2 -0
- package/dist/filters/text-filter.js +1 -0
- package/dist/grid/chrome/GridAddColumn.d.ts +11 -0
- package/dist/grid/chrome/GridAddColumn.js +29 -0
- package/dist/grid/chrome/GridAggregateMenu.d.ts +31 -0
- package/dist/grid/chrome/GridAggregateMenu.js +27 -0
- package/dist/grid/chrome/GridCellEditors.d.ts +64 -0
- package/dist/grid/chrome/GridCellEditors.js +55 -0
- package/dist/grid/chrome/GridCellOutline.d.ts +70 -0
- package/dist/grid/chrome/GridCellOutline.js +21 -0
- package/dist/grid/chrome/GridChipsEditor.d.ts +28 -0
- package/dist/grid/chrome/GridChipsEditor.js +40 -0
- package/dist/grid/chrome/GridColumnColorSection.d.ts +11 -0
- package/dist/grid/chrome/GridColumnColorSection.js +40 -0
- package/dist/grid/chrome/GridColumnDateSection.d.ts +23 -0
- package/dist/grid/chrome/GridColumnDateSection.js +23 -0
- package/dist/grid/chrome/GridColumnDurationSection.d.ts +19 -0
- package/dist/grid/chrome/GridColumnDurationSection.js +24 -0
- package/dist/grid/chrome/GridColumnMenu.d.ts +101 -0
- package/dist/grid/chrome/GridColumnMenu.js +99 -0
- package/dist/grid/chrome/GridColumnNumberSection.d.ts +25 -0
- package/dist/grid/chrome/GridColumnNumberSection.js +27 -0
- package/dist/grid/chrome/GridColumnPercentSection.d.ts +15 -0
- package/dist/grid/chrome/GridColumnPercentSection.js +16 -0
- package/dist/grid/chrome/GridColumnSortSection.d.ts +18 -0
- package/dist/grid/chrome/GridColumnSortSection.js +16 -0
- package/dist/grid/chrome/GridDateEditor.d.ts +22 -0
- package/dist/grid/chrome/GridDateEditor.js +31 -0
- package/dist/grid/chrome/GridFlyout.d.ts +44 -0
- package/dist/grid/chrome/GridFlyout.js +80 -0
- package/dist/grid/chrome/GridFooter.d.ts +23 -0
- package/dist/grid/chrome/GridFooter.js +81 -0
- package/dist/grid/chrome/GridGroupMenu.d.ts +37 -0
- package/dist/grid/chrome/GridGroupMenu.js +57 -0
- package/dist/grid/chrome/GridHeader.d.ts +61 -0
- package/dist/grid/chrome/GridHeader.js +37 -0
- package/dist/grid/chrome/GridLongTextEditor.d.ts +36 -0
- package/dist/grid/chrome/GridLongTextEditor.js +127 -0
- package/dist/grid/chrome/GridMenuRow.d.ts +15 -0
- package/dist/grid/chrome/GridMenuRow.js +15 -0
- package/dist/grid/chrome/GridNameEditor.d.ts +19 -0
- package/dist/grid/chrome/GridNameEditor.js +36 -0
- package/dist/grid/chrome/GridNumberEditor.d.ts +35 -0
- package/dist/grid/chrome/GridNumberEditor.js +25 -0
- package/dist/grid/chrome/GridRangeEditor.d.ts +20 -0
- package/dist/grid/chrome/GridRangeEditor.js +25 -0
- package/dist/grid/chrome/GridRelationEditor.d.ts +21 -0
- package/dist/grid/chrome/GridRelationEditor.js +30 -0
- package/dist/grid/chrome/GridResizeHandle.d.ts +19 -0
- package/dist/grid/chrome/GridResizeHandle.js +19 -0
- package/dist/grid/chrome/GridRow.d.ts +25 -0
- package/dist/grid/chrome/GridRow.js +136 -0
- package/dist/grid/chrome/GridRowActions.d.ts +32 -0
- package/dist/grid/chrome/GridRowActions.js +25 -0
- package/dist/grid/chrome/GridRowCells.d.ts +4 -0
- package/dist/grid/chrome/GridRowCells.js +133 -0
- package/dist/grid/chrome/GridRowGlyph.d.ts +12 -0
- package/dist/grid/chrome/GridRowGlyph.js +13 -0
- package/dist/grid/chrome/GridSelectEditor.d.ts +18 -0
- package/dist/grid/chrome/GridSelectEditor.js +49 -0
- package/dist/grid/chrome/GridStructure.d.ts +48 -0
- package/dist/grid/chrome/GridStructure.js +45 -0
- package/dist/grid/chrome/GridTable.d.ts +4 -0
- package/dist/grid/chrome/GridTable.js +125 -0
- package/dist/grid/chrome/GridTableSurface.d.ts +15 -0
- package/dist/grid/chrome/GridTableSurface.js +6 -0
- package/dist/grid/chrome/GridTextEditor.d.ts +11 -0
- package/dist/grid/chrome/GridTextEditor.js +40 -0
- package/dist/grid/chrome/GridValueListEditor.d.ts +18 -0
- package/dist/grid/chrome/GridValueListEditor.js +36 -0
- package/dist/grid/chrome/StuckMarker.d.ts +16 -0
- package/dist/grid/chrome/StuckMarker.js +34 -0
- package/dist/grid/chrome/cell-clipboard.d.ts +9 -0
- package/dist/grid/chrome/cell-clipboard.js +28 -0
- package/dist/grid/chrome/cells.d.ts +21 -0
- package/dist/grid/chrome/cells.js +20 -0
- package/dist/grid/chrome/checks.d.ts +35 -0
- package/dist/grid/chrome/checks.js +22 -0
- package/dist/grid/chrome/column-glyph.d.ts +14 -0
- package/dist/grid/chrome/column-glyph.js +44 -0
- package/dist/grid/chrome/editors.d.ts +9 -0
- package/dist/grid/chrome/editors.js +10 -0
- package/dist/grid/chrome/grid-cell-classes.d.ts +59 -0
- package/dist/grid/chrome/grid-cell-classes.js +30 -0
- package/dist/grid/chrome/grid-menu-search.d.ts +7 -0
- package/dist/grid/chrome/grid-menu-search.js +7 -0
- package/dist/grid/chrome/grid-row-props.d.ts +131 -0
- package/dist/grid/chrome/grid-row-props.js +1 -0
- package/dist/grid/chrome/grid-styles.d.ts +37 -0
- package/dist/grid/chrome/grid-styles.js +8 -0
- package/dist/grid/chrome/grid-table-props.d.ts +173 -0
- package/dist/grid/chrome/grid-table-props.js +1 -0
- package/dist/grid/chrome/useGridBatchApi.d.ts +34 -0
- package/dist/grid/chrome/useGridBatchApi.js +35 -0
- package/dist/grid/chrome/useGridColumnLayout.d.ts +30 -0
- package/dist/grid/chrome/useGridColumnLayout.js +206 -0
- package/dist/grid/chrome/useGridHeaderDrag.d.ts +20 -0
- package/dist/grid/chrome/useGridHeaderDrag.js +37 -0
- package/dist/grid/chrome/useGridKeyboard.d.ts +47 -0
- package/dist/grid/chrome/useGridKeyboard.js +274 -0
- package/dist/grid/chrome/useGridPendingReconciliation.d.ts +12 -0
- package/dist/grid/chrome/useGridPendingReconciliation.js +32 -0
- package/dist/grid/chrome/useGridRailReveal.d.ts +57 -0
- package/dist/grid/chrome/useGridRailReveal.js +67 -0
- package/dist/grid/chrome/useGridRangeActions.d.ts +49 -0
- package/dist/grid/chrome/useGridRangeActions.js +188 -0
- package/dist/grid/chrome/useGridRangeGestures.d.ts +32 -0
- package/dist/grid/chrome/useGridRangeGestures.js +190 -0
- package/dist/grid/chrome/useGridRowContextMenu.d.ts +35 -0
- package/dist/grid/chrome/useGridRowContextMenu.js +127 -0
- package/dist/grid/chrome/useGridScaleStyles.d.ts +1 -0
- package/dist/grid/chrome/useGridScaleStyles.js +29 -0
- package/dist/grid/chrome/useGridScrollSync.d.ts +38 -0
- package/dist/grid/chrome/useGridScrollSync.js +176 -0
- package/dist/grid/chrome/useGridTableInteractionModel.d.ts +55 -0
- package/dist/grid/chrome/useGridTableInteractionModel.js +197 -0
- package/dist/grid/chrome/useGridTableSelection.d.ts +29 -0
- package/dist/grid/chrome/useGridTableSelection.js +55 -0
- package/dist/grid/chrome/useHeaderDragReorder.d.ts +21 -0
- package/dist/grid/chrome/useHeaderDragReorder.js +216 -0
- package/dist/grid/core/clipboard-model.d.ts +81 -0
- package/dist/grid/core/clipboard-model.js +291 -0
- package/dist/grid/core/column-values.d.ts +27 -0
- package/dist/grid/core/column-values.js +76 -0
- package/dist/grid/core/commit-model.d.ts +34 -0
- package/dist/grid/core/commit-model.js +3 -0
- package/dist/grid/core/coordinates.d.ts +48 -0
- package/dist/grid/core/coordinates.js +27 -0
- package/dist/grid/core/edit-values.d.ts +9 -0
- package/dist/grid/core/edit-values.js +1 -0
- package/dist/grid/core/editing-controller.d.ts +59 -0
- package/dist/grid/core/editing-controller.js +240 -0
- package/dist/grid/core/editing-model.d.ts +78 -0
- package/dist/grid/core/editing-model.js +136 -0
- package/dist/grid/core/grid-scale.d.ts +14 -0
- package/dist/grid/core/grid-scale.js +8 -0
- package/dist/grid/core/nav.d.ts +94 -0
- package/dist/grid/core/nav.js +92 -0
- package/dist/grid/core/pending-reconciliation.d.ts +50 -0
- package/dist/grid/core/pending-reconciliation.js +49 -0
- package/dist/grid/core/range-model.d.ts +25 -0
- package/dist/grid/core/range-model.js +59 -0
- package/dist/grid/core/spreadsheet-operations.d.ts +85 -0
- package/dist/grid/core/spreadsheet-operations.js +253 -0
- package/dist/grid/core/useGridEditing.d.ts +43 -0
- package/dist/grid/core/useGridEditing.js +90 -0
- package/dist/grid/core/useGridRange.d.ts +20 -0
- package/dist/grid/core/useGridRange.js +24 -0
- package/dist/grid/core/value-equality.d.ts +32 -0
- package/dist/grid/core/value-equality.js +34 -0
- package/dist/grid/index.d.ts +18 -0
- package/dist/grid/index.js +5 -0
- package/dist/grid/useGridTablePrefs.d.ts +50 -0
- package/dist/grid/useGridTablePrefs.js +101 -0
- package/dist/grouping/sort-groups.d.ts +18 -0
- package/dist/grouping/sort-groups.js +33 -0
- package/dist/grouping/types.d.ts +10 -0
- package/dist/grouping/types.js +1 -0
- package/dist/index.d.ts +28 -0
- package/dist/index.js +28 -0
- package/dist/internal/chip.d.ts +4 -0
- package/dist/internal/chip.js +3 -0
- package/dist/internal/cx.d.ts +3 -0
- package/dist/internal/cx.js +3 -0
- package/dist/internal/viewport.d.ts +5 -0
- package/dist/internal/viewport.js +29 -0
- package/dist/model/aggregates.d.ts +59 -0
- package/dist/model/aggregates.js +186 -0
- package/dist/model/card-density.d.ts +8 -0
- package/dist/model/card-density.js +10 -0
- package/dist/model/card-layout.d.ts +85 -0
- package/dist/model/card-layout.js +90 -0
- package/dist/model/column-capabilities.d.ts +162 -0
- package/dist/model/column-capabilities.js +233 -0
- package/dist/model/column-filters.d.ts +106 -0
- package/dist/model/column-filters.js +321 -0
- package/dist/model/column-format.d.ts +103 -0
- package/dist/model/column-format.js +1 -0
- package/dist/model/column-from.d.ts +28 -0
- package/dist/model/column-from.js +160 -0
- package/dist/model/column-inspect.d.ts +18 -0
- package/dist/model/column-inspect.js +6 -0
- package/dist/model/column-knobs.d.ts +20 -0
- package/dist/model/column-knobs.js +16 -0
- package/dist/model/column-money.d.ts +13 -0
- package/dist/model/column-money.js +27 -0
- package/dist/model/column-order.d.ts +36 -0
- package/dist/model/column-order.js +68 -0
- package/dist/model/column-schema.d.ts +335 -0
- package/dist/model/column-schema.js +1 -0
- package/dist/model/column-sort.d.ts +17 -0
- package/dist/model/column-sort.js +11 -0
- package/dist/model/column-state.d.ts +77 -0
- package/dist/model/column-state.js +95 -0
- package/dist/model/column-types.d.ts +109 -0
- package/dist/model/column-types.js +50 -0
- package/dist/model/column-warnings.d.ts +44 -0
- package/dist/model/column-warnings.js +24 -0
- package/dist/model/density.d.ts +3 -0
- package/dist/model/density.js +13 -0
- package/dist/model/field-type-of.d.ts +21 -0
- package/dist/model/field-type-of.js +11 -0
- package/dist/model/filter-capabilities.d.ts +1 -0
- package/dist/model/filter-capabilities.js +1 -0
- package/dist/model/index.d.ts +38 -0
- package/dist/model/index.js +20 -0
- package/dist/model/part-rows.d.ts +28 -0
- package/dist/model/part-rows.js +40 -0
- package/dist/model/preferences.d.ts +155 -0
- package/dist/model/preferences.js +84 -0
- package/dist/model/prefs-buckets.d.ts +173 -0
- package/dist/model/prefs-buckets.js +71 -0
- package/dist/model/relation-filters.d.ts +45 -0
- package/dist/model/relation-filters.js +78 -0
- package/dist/model/render-count.d.ts +2 -0
- package/dist/model/render-count.js +24 -0
- package/dist/model/row-icon.d.ts +23 -0
- package/dist/model/row-icon.js +5 -0
- package/dist/model/view-rules.d.ts +73 -0
- package/dist/model/view-rules.js +216 -0
- package/dist/provider/ViewsProvider.d.ts +26 -0
- package/dist/provider/ViewsProvider.js +16 -0
- package/dist/provider/components.d.ts +230 -0
- package/dist/provider/components.js +3 -0
- package/dist/provider/context.d.ts +20 -0
- package/dist/provider/context.js +10 -0
- package/dist/provider/icons.d.ts +6 -0
- package/dist/provider/icons.js +1 -0
- package/dist/provider/menu-groups.d.ts +8 -0
- package/dist/provider/menu-groups.js +38 -0
- package/dist/provider/ports.d.ts +57 -0
- package/dist/provider/ports.js +9 -0
- package/dist/react.d.ts +9 -0
- package/dist/react.js +4 -0
- package/dist/selection/SelectCheckbox.d.ts +17 -0
- package/dist/selection/SelectCheckbox.js +11 -0
- package/dist/selection/index.d.ts +7 -0
- package/dist/selection/index.js +6 -0
- package/dist/selection/model.d.ts +55 -0
- package/dist/selection/model.js +86 -0
- package/dist/selection/row-click.d.ts +35 -0
- package/dist/selection/row-click.js +20 -0
- package/dist/selection/types.d.ts +17 -0
- package/dist/selection/types.js +1 -0
- package/dist/selection/useCheckDragSelect.d.ts +61 -0
- package/dist/selection/useCheckDragSelect.js +165 -0
- package/dist/selection/useListSelection.d.ts +39 -0
- package/dist/selection/useListSelection.js +48 -0
- package/dist/selection/useListSelectionShortcuts.d.ts +6 -0
- package/dist/selection/useListSelectionShortcuts.js +14 -0
- package/dist/selection/useRestIntent.d.ts +18 -0
- package/dist/selection/useRestIntent.js +35 -0
- package/docs/contract.md +525 -0
- package/docs/getting-started.md +250 -0
- package/docs/guides/atoms.md +245 -0
- package/docs/guides/cells.md +302 -0
- package/docs/guides/columns.md +412 -0
- package/docs/guides/display.md +203 -0
- package/docs/guides/editors.md +404 -0
- package/docs/guides/ports.md +246 -0
- package/docs/guides/selection.md +270 -0
- package/docs/guides/the-grid.md +677 -0
- package/docs/guides/the-provider.md +446 -0
- package/docs/index.md +50 -0
- package/docs/install.md +67 -0
- package/docs/reference/cells.md +28 -0
- package/docs/reference/display.md +42 -0
- package/docs/reference/editors-chips.md +6 -0
- package/docs/reference/editors-date.md +6 -0
- package/docs/reference/editors-location.md +10 -0
- package/docs/reference/editors-name.md +6 -0
- package/docs/reference/editors-number.md +11 -0
- package/docs/reference/editors-open-values.md +9 -0
- package/docs/reference/editors-range.md +6 -0
- package/docs/reference/editors-relation.md +9 -0
- package/docs/reference/editors-select.md +8 -0
- package/docs/reference/editors-session.md +9 -0
- package/docs/reference/editors-value-list.md +6 -0
- package/docs/reference/editors.md +5 -0
- package/docs/reference/grid.md +39 -0
- package/docs/reference/react.md +86 -0
- package/docs/reference/selection.md +33 -0
- package/docs/reference/views.md +601 -0
- package/docs/reshaping.md +19 -0
- package/package.json +118 -3
- package/skills/views/SKILL.md +102 -0
|
@@ -0,0 +1,188 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
import { useCallback, useEffect, useMemo, useRef } from "react";
|
|
3
|
+
import { useViews } from "../../provider/context.js";
|
|
4
|
+
import { gridRectContains, gridRectIsMulti } from "../core/coordinates.js";
|
|
5
|
+
import { computeRowRangeSpans } from "../core/range-model.js";
|
|
6
|
+
import { resolveActiveRangeRect } from "../core/range-model.js";
|
|
7
|
+
import { deriveGridSelectValues } from "../core/column-values.js";
|
|
8
|
+
import { buildGridCopyMatrix, extendGridFillPreview, gridRectHasClearable, planGridClear, planGridFill, planGridPaste, } from "../core/spreadsheet-operations.js";
|
|
9
|
+
import { copyCells, getGridClipboard, parseTsvText } from "./cell-clipboard.js";
|
|
10
|
+
export function useGridRangeActions({ ranges, focusedCell, editingCell, editingEnabled, fillTargetRow, visibleRowIds, visibleColumns, spreadsheetModel, commitBatch, focusCell, rangeSetRect, rangeExtendTo, }) {
|
|
11
|
+
const { ports, messages } = useViews();
|
|
12
|
+
const visibleColIds = useMemo(() => visibleColumns.map((col) => col.id), [visibleColumns]);
|
|
13
|
+
const spanRanges = useMemo(() => extendGridFillPreview(ranges, fillTargetRow, visibleRowIds, visibleColIds), [fillTargetRow, ranges, visibleColIds, visibleRowIds]);
|
|
14
|
+
const rowSpansMap = useMemo(() => computeRowRangeSpans(spanRanges, visibleRowIds, visibleColIds), [spanRanges, visibleColIds, visibleRowIds]);
|
|
15
|
+
const selectValuesByColumn = useMemo(() => deriveGridSelectValues(visibleColumns, spreadsheetModel.rows), [spreadsheetModel.rows, visibleColumns]);
|
|
16
|
+
const sayRefusals = useCallback((verb, plan) => {
|
|
17
|
+
if (plan.targetCount === 1 && plan.refusals.length === 1) {
|
|
18
|
+
ports.toast.error(plan.refusals[0].reason);
|
|
19
|
+
return;
|
|
20
|
+
}
|
|
21
|
+
for (const { reason, count } of plan.refusals) {
|
|
22
|
+
ports.toast.error(messages({ key: verb === "paste" ? "views.grid.paste-skipped" : "views.grid.fill-skipped", values: { count, reason } }));
|
|
23
|
+
}
|
|
24
|
+
}, [messages, ports]);
|
|
25
|
+
const finishFill = useCallback((targetRowId) => {
|
|
26
|
+
if (!editingEnabled)
|
|
27
|
+
return;
|
|
28
|
+
const plan = planGridFill(spreadsheetModel, ranges, focusedCell, targetRowId);
|
|
29
|
+
if (plan.edits.length > 0)
|
|
30
|
+
commitBatch(plan.edits);
|
|
31
|
+
if (plan.selectionHead)
|
|
32
|
+
rangeExtendTo(plan.selectionHead);
|
|
33
|
+
sayRefusals("fill", plan);
|
|
34
|
+
}, [commitBatch, editingEnabled, focusedCell, rangeExtendTo, ranges, sayRefusals, spreadsheetModel]);
|
|
35
|
+
const rangeVerbs = useMemo(() => {
|
|
36
|
+
const rectOfActiveRange = () => resolveActiveRangeRect(ranges, focusedCell, visibleRowIds, visibleColIds);
|
|
37
|
+
const activeRangeIsMulti = () => {
|
|
38
|
+
const rect = rectOfActiveRange();
|
|
39
|
+
return !!rect && gridRectIsMulti(rect);
|
|
40
|
+
};
|
|
41
|
+
const cellInActiveRange = (rowId, columnId) => {
|
|
42
|
+
if (!activeRangeIsMulti())
|
|
43
|
+
return false;
|
|
44
|
+
const rect = rectOfActiveRange();
|
|
45
|
+
return gridRectContains(rect, visibleRowIds.indexOf(rowId), visibleColIds.indexOf(columnId));
|
|
46
|
+
};
|
|
47
|
+
const copyRange = () => {
|
|
48
|
+
const rect = rectOfActiveRange();
|
|
49
|
+
if (!rect)
|
|
50
|
+
return;
|
|
51
|
+
const matrix = buildGridCopyMatrix(spreadsheetModel, rect);
|
|
52
|
+
if (matrix.length > 0)
|
|
53
|
+
void copyCells(ports.clipboard.writeText, matrix);
|
|
54
|
+
};
|
|
55
|
+
const activeRangeHasClearable = () => {
|
|
56
|
+
if (!editingEnabled)
|
|
57
|
+
return false;
|
|
58
|
+
const rect = rectOfActiveRange();
|
|
59
|
+
return !!rect && gridRectHasClearable(visibleColumns, rect);
|
|
60
|
+
};
|
|
61
|
+
const clearRange = () => {
|
|
62
|
+
if (!editingEnabled)
|
|
63
|
+
return;
|
|
64
|
+
const rect = rectOfActiveRange();
|
|
65
|
+
if (!rect)
|
|
66
|
+
return;
|
|
67
|
+
if (!activeRangeHasClearable()) {
|
|
68
|
+
ports.toast.error(messages({ key: "views.grid.clear-none" }));
|
|
69
|
+
return;
|
|
70
|
+
}
|
|
71
|
+
const edits = planGridClear(spreadsheetModel, rect);
|
|
72
|
+
if (edits.length > 0)
|
|
73
|
+
commitBatch(edits);
|
|
74
|
+
};
|
|
75
|
+
const cutRange = () => {
|
|
76
|
+
copyRange();
|
|
77
|
+
if (activeRangeHasClearable())
|
|
78
|
+
clearRange();
|
|
79
|
+
};
|
|
80
|
+
const pasteMatrix = (matrix, anchor) => {
|
|
81
|
+
if (!editingEnabled)
|
|
82
|
+
return;
|
|
83
|
+
const plan = planGridPaste(spreadsheetModel, matrix, anchor, rectOfActiveRange(), selectValuesByColumn);
|
|
84
|
+
if (plan.edits.length > 0) {
|
|
85
|
+
commitBatch(plan.edits);
|
|
86
|
+
if (plan.selection) {
|
|
87
|
+
focusCell(plan.selection.anchor.rowId, plan.selection.anchor.columnId);
|
|
88
|
+
rangeSetRect(plan.selection.anchor, plan.selection.head);
|
|
89
|
+
}
|
|
90
|
+
}
|
|
91
|
+
sayRefusals("paste", plan);
|
|
92
|
+
};
|
|
93
|
+
const pasteAtCell = (rowId, columnId) => {
|
|
94
|
+
const clipboard = getGridClipboard();
|
|
95
|
+
if (!clipboard)
|
|
96
|
+
return;
|
|
97
|
+
const rowIdx = visibleRowIds.indexOf(rowId);
|
|
98
|
+
const colIdx = visibleColIds.indexOf(columnId);
|
|
99
|
+
if (rowIdx < 0 || colIdx < 0)
|
|
100
|
+
return;
|
|
101
|
+
pasteMatrix(clipboard.matrix ?? [[clipboard]], { rowIdx, colIdx });
|
|
102
|
+
};
|
|
103
|
+
const pasteAtRangeOrigin = () => {
|
|
104
|
+
const rect = rectOfActiveRange();
|
|
105
|
+
if (rect)
|
|
106
|
+
pasteAtCell(visibleRowIds[rect.r1], visibleColIds[rect.c1]);
|
|
107
|
+
};
|
|
108
|
+
return {
|
|
109
|
+
copyRange,
|
|
110
|
+
cutRange,
|
|
111
|
+
clearRange,
|
|
112
|
+
pasteMatrix,
|
|
113
|
+
pasteAtCell,
|
|
114
|
+
pasteAtRangeOrigin,
|
|
115
|
+
activeRangeIsMulti,
|
|
116
|
+
activeRangeHasClearable,
|
|
117
|
+
cellInActiveRange,
|
|
118
|
+
};
|
|
119
|
+
}, [
|
|
120
|
+
commitBatch,
|
|
121
|
+
editingEnabled,
|
|
122
|
+
focusCell,
|
|
123
|
+
focusedCell,
|
|
124
|
+
messages,
|
|
125
|
+
ports,
|
|
126
|
+
rangeSetRect,
|
|
127
|
+
ranges,
|
|
128
|
+
sayRefusals,
|
|
129
|
+
selectValuesByColumn,
|
|
130
|
+
spreadsheetModel,
|
|
131
|
+
visibleColIds,
|
|
132
|
+
visibleColumns,
|
|
133
|
+
visibleRowIds,
|
|
134
|
+
]);
|
|
135
|
+
const rangeVerbsRef = useRef(null);
|
|
136
|
+
useEffect(() => {
|
|
137
|
+
rangeVerbsRef.current = rangeVerbs;
|
|
138
|
+
}, [rangeVerbs]);
|
|
139
|
+
const onRangeCopy = useCallback(() => rangeVerbsRef.current?.copyRange(), []);
|
|
140
|
+
const onRangeCut = useCallback(() => rangeVerbsRef.current?.cutRange(), []);
|
|
141
|
+
const onRangeClear = useCallback(() => rangeVerbsRef.current?.clearRange(), []);
|
|
142
|
+
const onRangePaste = useCallback(() => rangeVerbsRef.current?.pasteAtRangeOrigin(), []);
|
|
143
|
+
const onPasteAtCell = useCallback((rowId, columnId) => rangeVerbsRef.current?.pasteAtCell(rowId, columnId), []);
|
|
144
|
+
const inActiveRange = useCallback((rowId, columnId) => rangeVerbsRef.current?.cellInActiveRange(rowId, columnId) ?? false, []);
|
|
145
|
+
const rangeCanClear = useCallback(() => rangeVerbsRef.current?.activeRangeHasClearable() ?? false, []);
|
|
146
|
+
useEffect(() => {
|
|
147
|
+
if (!focusedCell || editingCell || !editingEnabled)
|
|
148
|
+
return;
|
|
149
|
+
const onPaste = (event) => {
|
|
150
|
+
const target = event.target;
|
|
151
|
+
if (target?.closest?.('input, textarea, select, [contenteditable="true"], [role="menu"]')) {
|
|
152
|
+
return;
|
|
153
|
+
}
|
|
154
|
+
const text = event.clipboardData?.getData("text/plain") ?? "";
|
|
155
|
+
const clipboard = getGridClipboard();
|
|
156
|
+
const internal = clipboard && (clipboard.text === text || text === "") ? clipboard : null;
|
|
157
|
+
if (!internal && text === "")
|
|
158
|
+
return;
|
|
159
|
+
event.preventDefault();
|
|
160
|
+
const matrix = internal
|
|
161
|
+
? (internal.matrix ?? [[internal]])
|
|
162
|
+
: parseTsvText(text);
|
|
163
|
+
if (matrix.length === 0)
|
|
164
|
+
return;
|
|
165
|
+
const rowIdx = visibleRowIds.indexOf(focusedCell.rowId);
|
|
166
|
+
const colIdx = visibleColIds.indexOf(focusedCell.columnId);
|
|
167
|
+
if (rowIdx < 0 || colIdx < 0)
|
|
168
|
+
return;
|
|
169
|
+
rangeVerbsRef.current?.pasteMatrix(matrix, { rowIdx, colIdx });
|
|
170
|
+
};
|
|
171
|
+
window.addEventListener("paste", onPaste);
|
|
172
|
+
return () => window.removeEventListener("paste", onPaste);
|
|
173
|
+
}, [editingCell, editingEnabled, focusedCell, visibleColIds, visibleRowIds]);
|
|
174
|
+
return {
|
|
175
|
+
visibleColIds,
|
|
176
|
+
rowSpansMap,
|
|
177
|
+
selectValuesByColumn,
|
|
178
|
+
finishFill,
|
|
179
|
+
onRangeCopy,
|
|
180
|
+
onRangeCut,
|
|
181
|
+
onRangeClear,
|
|
182
|
+
onRangePaste,
|
|
183
|
+
onPasteAtCell,
|
|
184
|
+
inActiveRange,
|
|
185
|
+
rangeCanClear,
|
|
186
|
+
rangeVerbsRef,
|
|
187
|
+
};
|
|
188
|
+
}
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
import { type RefObject } from "react";
|
|
2
|
+
import type { GridCellPos } from "../core/coordinates.js";
|
|
3
|
+
/**
|
|
4
|
+
* Whether a pointer event on a scrolling element landed on one of its
|
|
5
|
+
* scrollbars rather than its content. A scrollbar is drawn inside the border
|
|
6
|
+
* box but outside the client box, so a pointer past `clientWidth` /
|
|
7
|
+
* `clientHeight` (measured from the padding edge) is on the bar.
|
|
8
|
+
*/
|
|
9
|
+
export declare function onScrollbar(el: HTMLElement, event: {
|
|
10
|
+
clientX: number;
|
|
11
|
+
clientY: number;
|
|
12
|
+
}): boolean;
|
|
13
|
+
export declare function useGridRangeGestures({ rootRef, focusedCell, editingCell, editingEnabled, selecting, focusCell, clearFocus, rangeBeginDrag, rangeExtendTo, rangeAddCell, finishFillRef, }: {
|
|
14
|
+
rootRef: RefObject<HTMLDivElement | null>;
|
|
15
|
+
focusedCell: GridCellPos | null;
|
|
16
|
+
editingCell: GridCellPos | null;
|
|
17
|
+
editingEnabled: boolean;
|
|
18
|
+
selecting: boolean;
|
|
19
|
+
focusCell: (rowId: string, columnId: string) => void;
|
|
20
|
+
clearFocus: () => void;
|
|
21
|
+
rangeBeginDrag: (pos: GridCellPos, additive: boolean) => void;
|
|
22
|
+
rangeExtendTo: (pos: GridCellPos, fallbackAnchor?: GridCellPos) => void;
|
|
23
|
+
rangeAddCell: (pos: GridCellPos) => void;
|
|
24
|
+
finishFillRef: RefObject<(targetRowId: string) => void>;
|
|
25
|
+
}): {
|
|
26
|
+
fillTargetRow: string | null;
|
|
27
|
+
onExtendCell: (rowId: string, columnId: string) => void;
|
|
28
|
+
onAddCell: (rowId: string, columnId: string) => void;
|
|
29
|
+
handleRootPointerDown: (event: React.PointerEvent) => void;
|
|
30
|
+
handleRootPointerDownCapture: (event: React.PointerEvent) => void;
|
|
31
|
+
handleRootClickCapture: (event: React.MouseEvent) => void;
|
|
32
|
+
};
|
|
@@ -0,0 +1,190 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
import { useCallback, useEffect, useRef, useState } from "react";
|
|
3
|
+
import { ROW_INTERACTIVE_SELECTOR } from "../../selection/row-click.js";
|
|
4
|
+
const MOUSE_DRAG_SELECT = false;
|
|
5
|
+
function setBodySelectionDisabled(disabled) {
|
|
6
|
+
document.body.style.userSelect = disabled ? "none" : "";
|
|
7
|
+
}
|
|
8
|
+
export function onScrollbar(el, event) {
|
|
9
|
+
if (!el.clientWidth || !el.clientHeight)
|
|
10
|
+
return false;
|
|
11
|
+
const rect = el.getBoundingClientRect();
|
|
12
|
+
const x = event.clientX - rect.left - el.clientLeft;
|
|
13
|
+
const y = event.clientY - rect.top - el.clientTop;
|
|
14
|
+
return x >= el.clientWidth || y >= el.clientHeight;
|
|
15
|
+
}
|
|
16
|
+
export function useGridRangeGestures({ rootRef, focusedCell, editingCell, editingEnabled, selecting, focusCell, clearFocus, rangeBeginDrag, rangeExtendTo, rangeAddCell, finishFillRef, }) {
|
|
17
|
+
const focusedRef = useRef(focusedCell);
|
|
18
|
+
useEffect(() => {
|
|
19
|
+
focusedRef.current = focusedCell;
|
|
20
|
+
}, [focusedCell]);
|
|
21
|
+
const onExtendCell = useCallback((rowId, columnId) => {
|
|
22
|
+
const pos = { rowId, columnId };
|
|
23
|
+
rangeExtendTo(pos, focusedRef.current ?? pos);
|
|
24
|
+
if (!focusedRef.current)
|
|
25
|
+
focusCell(rowId, columnId);
|
|
26
|
+
}, [focusCell, rangeExtendTo]);
|
|
27
|
+
const onAddCell = useCallback((rowId, columnId) => {
|
|
28
|
+
rangeAddCell({ rowId, columnId });
|
|
29
|
+
focusCell(rowId, columnId);
|
|
30
|
+
}, [focusCell, rangeAddCell]);
|
|
31
|
+
const cellDragRef = useRef(null);
|
|
32
|
+
const didCellDragRef = useRef(false);
|
|
33
|
+
const fillDragRef = useRef(false);
|
|
34
|
+
const [fillTargetRow, setFillTargetRow] = useState(null);
|
|
35
|
+
const fillTargetRef = useRef(null);
|
|
36
|
+
const handleRootPointerDown = (event) => {
|
|
37
|
+
if (event.button !== 0 || event.pointerType !== "mouse")
|
|
38
|
+
return;
|
|
39
|
+
if (selecting || editingCell)
|
|
40
|
+
return;
|
|
41
|
+
const target = event.target;
|
|
42
|
+
if (editingEnabled && target.closest("[data-fill-dot]")) {
|
|
43
|
+
event.preventDefault();
|
|
44
|
+
fillDragRef.current = true;
|
|
45
|
+
setBodySelectionDisabled(true);
|
|
46
|
+
return;
|
|
47
|
+
}
|
|
48
|
+
if (!MOUSE_DRAG_SELECT)
|
|
49
|
+
return;
|
|
50
|
+
if (target.closest(ROW_INTERACTIVE_SELECTOR) || target.closest("[data-action-menu]"))
|
|
51
|
+
return;
|
|
52
|
+
const cell = target.closest("[data-col-id]");
|
|
53
|
+
const row = target.closest("[data-row-id]");
|
|
54
|
+
if (!cell || !row)
|
|
55
|
+
return;
|
|
56
|
+
cellDragRef.current = {
|
|
57
|
+
startX: event.clientX,
|
|
58
|
+
startY: event.clientY,
|
|
59
|
+
rowId: row.getAttribute("data-row-id"),
|
|
60
|
+
columnId: cell.getAttribute("data-col-id"),
|
|
61
|
+
additive: event.metaKey || event.ctrlKey,
|
|
62
|
+
extend: event.shiftKey,
|
|
63
|
+
active: false,
|
|
64
|
+
};
|
|
65
|
+
};
|
|
66
|
+
const handleRootClickCapture = (event) => {
|
|
67
|
+
if (!didCellDragRef.current)
|
|
68
|
+
return;
|
|
69
|
+
didCellDragRef.current = false;
|
|
70
|
+
event.preventDefault();
|
|
71
|
+
event.stopPropagation();
|
|
72
|
+
};
|
|
73
|
+
useEffect(() => {
|
|
74
|
+
const onMove = (event) => {
|
|
75
|
+
if (fillDragRef.current) {
|
|
76
|
+
const element = document.elementFromPoint(event.clientX, event.clientY);
|
|
77
|
+
const row = element?.closest?.("[data-row-id]");
|
|
78
|
+
if (row && rootRef.current?.contains(row)) {
|
|
79
|
+
const rowId = row.getAttribute("data-row-id");
|
|
80
|
+
if (rowId !== fillTargetRef.current) {
|
|
81
|
+
fillTargetRef.current = rowId;
|
|
82
|
+
setFillTargetRow(rowId);
|
|
83
|
+
}
|
|
84
|
+
}
|
|
85
|
+
return;
|
|
86
|
+
}
|
|
87
|
+
const drag = cellDragRef.current;
|
|
88
|
+
if (!drag)
|
|
89
|
+
return;
|
|
90
|
+
if (!drag.active) {
|
|
91
|
+
if (Math.abs(event.clientX - drag.startX) < 4 &&
|
|
92
|
+
Math.abs(event.clientY - drag.startY) < 4) {
|
|
93
|
+
return;
|
|
94
|
+
}
|
|
95
|
+
drag.active = true;
|
|
96
|
+
setBodySelectionDisabled(true);
|
|
97
|
+
const start = { rowId: drag.rowId, columnId: drag.columnId };
|
|
98
|
+
if (drag.extend) {
|
|
99
|
+
rangeExtendTo(start, focusedRef.current ?? start);
|
|
100
|
+
if (!focusedRef.current)
|
|
101
|
+
focusCell(start.rowId, start.columnId);
|
|
102
|
+
}
|
|
103
|
+
else {
|
|
104
|
+
rangeBeginDrag(start, drag.additive);
|
|
105
|
+
focusCell(start.rowId, start.columnId);
|
|
106
|
+
}
|
|
107
|
+
}
|
|
108
|
+
const element = document.elementFromPoint(event.clientX, event.clientY);
|
|
109
|
+
const cell = element?.closest?.("[data-col-id]");
|
|
110
|
+
const row = element?.closest?.("[data-row-id]");
|
|
111
|
+
if (cell && row && rootRef.current?.contains(row)) {
|
|
112
|
+
rangeExtendTo({
|
|
113
|
+
rowId: row.getAttribute("data-row-id"),
|
|
114
|
+
columnId: cell.getAttribute("data-col-id"),
|
|
115
|
+
});
|
|
116
|
+
}
|
|
117
|
+
};
|
|
118
|
+
const onUp = () => {
|
|
119
|
+
if (fillDragRef.current) {
|
|
120
|
+
fillDragRef.current = false;
|
|
121
|
+
setBodySelectionDisabled(false);
|
|
122
|
+
const target = fillTargetRef.current;
|
|
123
|
+
fillTargetRef.current = null;
|
|
124
|
+
setFillTargetRow(null);
|
|
125
|
+
if (target) {
|
|
126
|
+
didCellDragRef.current = true;
|
|
127
|
+
finishFillRef.current(target);
|
|
128
|
+
}
|
|
129
|
+
return;
|
|
130
|
+
}
|
|
131
|
+
const drag = cellDragRef.current;
|
|
132
|
+
cellDragRef.current = null;
|
|
133
|
+
if (drag?.active) {
|
|
134
|
+
didCellDragRef.current = true;
|
|
135
|
+
setBodySelectionDisabled(false);
|
|
136
|
+
}
|
|
137
|
+
};
|
|
138
|
+
window.addEventListener("pointermove", onMove);
|
|
139
|
+
window.addEventListener("pointerup", onUp);
|
|
140
|
+
return () => {
|
|
141
|
+
window.removeEventListener("pointermove", onMove);
|
|
142
|
+
window.removeEventListener("pointerup", onUp);
|
|
143
|
+
};
|
|
144
|
+
}, [finishFillRef, focusCell, rangeBeginDrag, rangeExtendTo, rootRef]);
|
|
145
|
+
const editingRef = useRef(editingCell);
|
|
146
|
+
useEffect(() => {
|
|
147
|
+
editingRef.current = editingCell;
|
|
148
|
+
}, [editingCell]);
|
|
149
|
+
const treePressRef = useRef(null);
|
|
150
|
+
const handleRootPointerDownCapture = (event) => {
|
|
151
|
+
treePressRef.current = event.nativeEvent;
|
|
152
|
+
};
|
|
153
|
+
useEffect(() => {
|
|
154
|
+
if (!focusedCell)
|
|
155
|
+
return;
|
|
156
|
+
const onPointerDown = (event) => {
|
|
157
|
+
const inTree = treePressRef.current === event;
|
|
158
|
+
treePressRef.current = null;
|
|
159
|
+
const target = event.target;
|
|
160
|
+
if (!target)
|
|
161
|
+
return;
|
|
162
|
+
if (inTree && !rootRef.current?.contains(target))
|
|
163
|
+
return;
|
|
164
|
+
if (rootRef.current?.contains(target)) {
|
|
165
|
+
if (target.closest?.("[data-col-id]"))
|
|
166
|
+
return;
|
|
167
|
+
if (target.dataset?.gridScroller != null && onScrollbar(target, event))
|
|
168
|
+
return;
|
|
169
|
+
}
|
|
170
|
+
if (editingRef.current) {
|
|
171
|
+
window.setTimeout(() => {
|
|
172
|
+
if (!editingRef.current)
|
|
173
|
+
clearFocus();
|
|
174
|
+
}, 0);
|
|
175
|
+
return;
|
|
176
|
+
}
|
|
177
|
+
clearFocus();
|
|
178
|
+
};
|
|
179
|
+
window.addEventListener("pointerdown", onPointerDown);
|
|
180
|
+
return () => window.removeEventListener("pointerdown", onPointerDown);
|
|
181
|
+
}, [clearFocus, focusedCell, rootRef]);
|
|
182
|
+
return {
|
|
183
|
+
fillTargetRow,
|
|
184
|
+
onExtendCell,
|
|
185
|
+
onAddCell,
|
|
186
|
+
handleRootPointerDown,
|
|
187
|
+
handleRootPointerDownCapture,
|
|
188
|
+
handleRootClickCapture,
|
|
189
|
+
};
|
|
190
|
+
}
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
import type { ViewsRowMenuItem } from "../../atoms/types.js";
|
|
2
|
+
import type { ListColumn } from "../../model/column-schema.js";
|
|
3
|
+
import type { GridRowRangeSpan } from "../core/useGridRange.js";
|
|
4
|
+
export declare function useGridRowContextMenu<Row>({ row, id, rowKey, columns, selecting, selectable, selected, toggle, editingEnabled, pendingByCol, selectValues, rowRange, contextMenu, inActiveRange, rangeCanClear, onRangeCopy, onRangeCut, onRangePaste, onRangeClear, onPasteAtCell, onCommitCell, onFocusCell, }: {
|
|
5
|
+
row: Row;
|
|
6
|
+
/** The DATA id — what a commit and the selection toggle address. */
|
|
7
|
+
id: string;
|
|
8
|
+
/** This RENDERED row's identity — what a position (range, focus, paste
|
|
9
|
+
* target) is in terms of. See `GridCellPos`. */
|
|
10
|
+
rowKey: string;
|
|
11
|
+
columns: ListColumn<Row>[];
|
|
12
|
+
selecting: boolean;
|
|
13
|
+
selectable: boolean;
|
|
14
|
+
selected: boolean;
|
|
15
|
+
toggle: (id: string, next?: boolean) => void;
|
|
16
|
+
editingEnabled: boolean;
|
|
17
|
+
pendingByCol?: Record<string, unknown>;
|
|
18
|
+
selectValues?: Record<string, string[]>;
|
|
19
|
+
rowRange?: GridRowRangeSpan[];
|
|
20
|
+
contextMenu?: (row: Row) => ViewsRowMenuItem[];
|
|
21
|
+
inActiveRange: (rowId: string, columnId: string) => boolean;
|
|
22
|
+
rangeCanClear: () => boolean;
|
|
23
|
+
onRangeCopy: () => void;
|
|
24
|
+
onRangeCut: () => void;
|
|
25
|
+
onRangePaste: () => void;
|
|
26
|
+
onRangeClear: () => void;
|
|
27
|
+
onPasteAtCell: (rowId: string, columnId: string) => void;
|
|
28
|
+
onCommitCell: (row: Row, rowId: string, columnId: string, previous: unknown, next: unknown, options?: {
|
|
29
|
+
overlay?: boolean;
|
|
30
|
+
}) => void;
|
|
31
|
+
onFocusCell: (rowId: string, columnId: string) => void;
|
|
32
|
+
}): {
|
|
33
|
+
contextItems: ViewsRowMenuItem[];
|
|
34
|
+
handleContextMenu: (event: React.MouseEvent<HTMLElement>) => void;
|
|
35
|
+
};
|
|
@@ -0,0 +1,127 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
import { jsx as _jsx } from "react/jsx-runtime";
|
|
3
|
+
import { useState } from "react";
|
|
4
|
+
import { useViews } from "../../provider/context.js";
|
|
5
|
+
import { gridColumnHasEditor } from "../../model/column-capabilities.js";
|
|
6
|
+
import { cellClearPrev, cellEditBaseline, cellPrevPayload, coercePaste, copyCell, getGridClipboard, rowHoldsCurrency, } from "./cell-clipboard.js";
|
|
7
|
+
export function useGridRowContextMenu({ row, id, rowKey, columns, selecting, selectable, selected, toggle, editingEnabled, pendingByCol, selectValues, rowRange, contextMenu, inActiveRange, rangeCanClear, onRangeCopy, onRangeCut, onRangePaste, onRangeClear, onPasteAtCell, onCommitCell, onFocusCell, }) {
|
|
8
|
+
const { conventions, ports, messages, icons } = useViews();
|
|
9
|
+
const copyLabel = messages({ key: "views.menus.copy" });
|
|
10
|
+
const cutLabel = messages({ key: "views.menus.cut" });
|
|
11
|
+
const pasteLabel = messages({ key: "views.menus.paste" });
|
|
12
|
+
const clearLabel = messages({ key: "views.menus.clear" });
|
|
13
|
+
const [menuColumnId, setMenuColumnId] = useState(null);
|
|
14
|
+
const menuColumn = menuColumnId
|
|
15
|
+
? columns.find((column) => column.id === menuColumnId)
|
|
16
|
+
: undefined;
|
|
17
|
+
const editBaseline = (column) => cellEditBaseline(column, row, pendingByCol);
|
|
18
|
+
const canEdit = (column) => editingEnabled && gridColumnHasEditor(column);
|
|
19
|
+
const cellItems = [];
|
|
20
|
+
if (menuColumn && !selecting && inActiveRange(rowKey, menuColumn.id)) {
|
|
21
|
+
const clipboard = getGridClipboard();
|
|
22
|
+
cellItems.push({
|
|
23
|
+
label: copyLabel,
|
|
24
|
+
icon: _jsx(icons.copy, { className: "h-4 w-4" }),
|
|
25
|
+
shortcut: "⌘C",
|
|
26
|
+
onClick: onRangeCopy,
|
|
27
|
+
});
|
|
28
|
+
if (editingEnabled) {
|
|
29
|
+
const canClear = rangeCanClear();
|
|
30
|
+
cellItems.push({
|
|
31
|
+
label: cutLabel,
|
|
32
|
+
icon: _jsx(icons.cut, { className: "h-4 w-4" }),
|
|
33
|
+
shortcut: "⌘X",
|
|
34
|
+
disabled: !canClear,
|
|
35
|
+
onClick: onRangeCut,
|
|
36
|
+
}, {
|
|
37
|
+
label: pasteLabel,
|
|
38
|
+
icon: _jsx(icons.paste, { className: "h-4 w-4" }),
|
|
39
|
+
shortcut: "⌘V",
|
|
40
|
+
disabled: !clipboard,
|
|
41
|
+
onClick: onRangePaste,
|
|
42
|
+
}, {
|
|
43
|
+
label: clearLabel,
|
|
44
|
+
icon: _jsx(icons.clear, { className: "h-4 w-4" }),
|
|
45
|
+
disabled: !canClear,
|
|
46
|
+
onClick: onRangeClear,
|
|
47
|
+
});
|
|
48
|
+
}
|
|
49
|
+
cellItems.push({ separator: true });
|
|
50
|
+
}
|
|
51
|
+
else if (menuColumn && !selecting) {
|
|
52
|
+
const unit = menuColumn.editUnit?.value(row);
|
|
53
|
+
const canWrite = canEdit(menuColumn);
|
|
54
|
+
const canClear = canWrite && !!menuColumn.clearable;
|
|
55
|
+
const clipboard = getGridClipboard();
|
|
56
|
+
const paste = canWrite && clipboard && !clipboard.matrix
|
|
57
|
+
? coercePaste(menuColumn, clipboard, {
|
|
58
|
+
conventions,
|
|
59
|
+
messages,
|
|
60
|
+
currentUnit: unit,
|
|
61
|
+
holdsCurrency: rowHoldsCurrency(menuColumn, row),
|
|
62
|
+
values: selectValues?.[menuColumn.id],
|
|
63
|
+
})
|
|
64
|
+
: null;
|
|
65
|
+
cellItems.push({
|
|
66
|
+
label: copyLabel,
|
|
67
|
+
icon: _jsx(icons.copy, { className: "h-4 w-4" }),
|
|
68
|
+
shortcut: "⌘C",
|
|
69
|
+
onClick: () => void copyCell(ports.clipboard.writeText, menuColumn, editBaseline(menuColumn), unit),
|
|
70
|
+
});
|
|
71
|
+
if (editingEnabled) {
|
|
72
|
+
cellItems.push({
|
|
73
|
+
label: cutLabel,
|
|
74
|
+
icon: _jsx(icons.cut, { className: "h-4 w-4" }),
|
|
75
|
+
shortcut: "⌘X",
|
|
76
|
+
disabled: !canClear,
|
|
77
|
+
onClick: () => {
|
|
78
|
+
void copyCell(ports.clipboard.writeText, menuColumn, editBaseline(menuColumn), unit);
|
|
79
|
+
onCommitCell(row, id, menuColumn.id, cellClearPrev(menuColumn, row, pendingByCol), "");
|
|
80
|
+
},
|
|
81
|
+
}, {
|
|
82
|
+
label: pasteLabel,
|
|
83
|
+
icon: _jsx(icons.paste, { className: "h-4 w-4" }),
|
|
84
|
+
shortcut: "⌘V",
|
|
85
|
+
disabled: clipboard?.matrix ? false : !paste?.ok,
|
|
86
|
+
onClick: () => {
|
|
87
|
+
if (clipboard?.matrix) {
|
|
88
|
+
onPasteAtCell(rowKey, menuColumn.id);
|
|
89
|
+
}
|
|
90
|
+
else if (paste?.ok) {
|
|
91
|
+
onCommitCell(row, id, menuColumn.id, cellPrevPayload(menuColumn, editBaseline(menuColumn), unit), paste.next, { overlay: paste.overlay });
|
|
92
|
+
}
|
|
93
|
+
},
|
|
94
|
+
}, {
|
|
95
|
+
label: clearLabel,
|
|
96
|
+
icon: _jsx(icons.clear, { className: "h-4 w-4" }),
|
|
97
|
+
disabled: !canClear,
|
|
98
|
+
onClick: () => onCommitCell(row, id, menuColumn.id, cellClearPrev(menuColumn, row, pendingByCol), ""),
|
|
99
|
+
});
|
|
100
|
+
}
|
|
101
|
+
cellItems.push({ separator: true });
|
|
102
|
+
}
|
|
103
|
+
const selectItems = selectable
|
|
104
|
+
? [
|
|
105
|
+
{
|
|
106
|
+
label: messages({ key: "views.menus.row-select", values: { selected: selected ? "true" : "false" } }),
|
|
107
|
+
icon: _jsx(icons.selectRow, { className: "h-4 w-4" }),
|
|
108
|
+
onClick: () => toggle(id),
|
|
109
|
+
},
|
|
110
|
+
{ separator: true },
|
|
111
|
+
]
|
|
112
|
+
: [];
|
|
113
|
+
const contextItems = [...cellItems, ...selectItems, ...(contextMenu?.(row) ?? [])];
|
|
114
|
+
const handleContextMenu = (event) => {
|
|
115
|
+
const target = event.target;
|
|
116
|
+
const columnId = target.closest("[data-col-id]")?.getAttribute("data-col-id");
|
|
117
|
+
const column = columnId ? columns.find((item) => item.id === columnId) : undefined;
|
|
118
|
+
setMenuColumnId(column?.id ?? null);
|
|
119
|
+
if (column && !selecting) {
|
|
120
|
+
const index = columns.findIndex((item) => item.id === column.id);
|
|
121
|
+
const inRange = rowRange?.some((span) => index >= span.startCol && index <= span.endCol);
|
|
122
|
+
if (!inRange)
|
|
123
|
+
onFocusCell(rowKey, column.id);
|
|
124
|
+
}
|
|
125
|
+
};
|
|
126
|
+
return { contextItems, handleContextMenu };
|
|
127
|
+
}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export declare function useGridScaleStyles(scale: number, grouped: boolean, isMobile: boolean, addColumn?: boolean): import("react").CSSProperties;
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
import { useMemo } from "react";
|
|
3
|
+
export function useGridScaleStyles(scale, grouped, isMobile, addColumn = false) {
|
|
4
|
+
return useMemo(() => ({
|
|
5
|
+
"--vk-scale": String(scale),
|
|
6
|
+
"--vk-indent": isMobile ? "0px" : "24px",
|
|
7
|
+
"--vk-row-h": "calc(37px * var(--vk-scale))",
|
|
8
|
+
"--vk-line-h": "calc(22px * var(--vk-scale))",
|
|
9
|
+
"--vk-cell-py": "calc((var(--vk-row-h) - var(--vk-line-h) - 1px) / 2)",
|
|
10
|
+
"--vk-tail-py": "max(0px, calc((var(--vk-row-h) - 2rem - 1px) / 2))",
|
|
11
|
+
"--vk-head-h": "calc(32px * var(--vk-scale))",
|
|
12
|
+
"--vk-head-text": "calc(12px * var(--vk-scale))",
|
|
13
|
+
"--vk-head-glyph": "calc(12px * var(--vk-scale))",
|
|
14
|
+
"--vk-footer-h": "calc(36px * var(--vk-scale))",
|
|
15
|
+
"--vk-label-h": "calc(36px * var(--vk-scale))",
|
|
16
|
+
"--vk-text": "calc(14px * var(--vk-scale))",
|
|
17
|
+
"--vk-text-xs": "calc(12px * var(--vk-scale))",
|
|
18
|
+
"--vk-text-10": "calc(10px * var(--vk-scale))",
|
|
19
|
+
"--vk-px": "calc(12px * var(--vk-scale))",
|
|
20
|
+
"--vk-rail-gap": "3px",
|
|
21
|
+
"--vk-rail-w": "min(32px, calc(var(--vk-gutter,0px) + var(--vk-indent,0px)))",
|
|
22
|
+
"--vk-tail-w": addColumn ? "calc(140px + var(--vk-px))" : "calc(36px + var(--vk-px))",
|
|
23
|
+
"--vk-tail-pl": addColumn
|
|
24
|
+
? "max(0px, calc(var(--vk-px) + var(--vk-head-glyph) / 2 - 18px))"
|
|
25
|
+
: "var(--vk-px)",
|
|
26
|
+
"--vk-glyph": "calc(14px * var(--vk-scale))",
|
|
27
|
+
"--vk-scroll-mt": `calc(${grouped ? "var(--vk-label-h) + 6px" : "0px"} + ${isMobile ? "0px" : "var(--vk-head-h)"} + 4px)`,
|
|
28
|
+
}), [addColumn, grouped, isMobile, scale]);
|
|
29
|
+
}
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
import { type RefObject, type UIEvent } from "react";
|
|
2
|
+
/** What a group's rows scroller spreads on itself: its registration, its scroll handler, its
|
|
3
|
+
* overflow classes. Named, so its readers never spell it as an indexed type. */
|
|
4
|
+
export type GridScrollSurface = {
|
|
5
|
+
/** A ref callback: what it returns is React's ref cleanup, which a wrapper must hand back. */
|
|
6
|
+
register: (element: HTMLElement | null) => (() => void) | undefined;
|
|
7
|
+
onScroll: (event: UIEvent<HTMLElement>) => void;
|
|
8
|
+
className: string;
|
|
9
|
+
};
|
|
10
|
+
/**
|
|
11
|
+
* Horizontal lock-step scrolling for per-group scrollers and sticky headers.
|
|
12
|
+
*
|
|
13
|
+
* The page-sticky headers live OUTSIDE the scrollers (so they can pin
|
|
14
|
+
* vertically) but are themselves `overflow-x-hidden` scroll containers, driven
|
|
15
|
+
* programmatically.
|
|
16
|
+
*
|
|
17
|
+
* They must NOT be slid by `transform: translate3d(-x)`. Two bugs came from
|
|
18
|
+
* that: a transform has no end-stop, so the header over-travelled past its own
|
|
19
|
+
* content at the end of a scroll; and frozen header columns had to
|
|
20
|
+
* counter-transform in JS, which drifted a frame behind the compositor-driven
|
|
21
|
+
* body. As real scrollers, `scrollLeft` clamps itself and frozen header cells
|
|
22
|
+
* use plain `position: sticky` — pinned by the compositor, never lagging.
|
|
23
|
+
*
|
|
24
|
+
* Idempotent writes (`!== x` guards) make echoed scroll events terminate.
|
|
25
|
+
*/
|
|
26
|
+
export declare function useGridScrollSync(rootRef: RefObject<HTMLDivElement | null>): {
|
|
27
|
+
scrollXRef: RefObject<number>;
|
|
28
|
+
getScroller: () => HTMLElement | undefined;
|
|
29
|
+
surface: GridScrollSurface;
|
|
30
|
+
registerHeader: (element: HTMLElement | null) => (() => void) | undefined;
|
|
31
|
+
headerWheelRef: (element: HTMLElement | null) => (() => void) | undefined;
|
|
32
|
+
headerPanHandlers: {
|
|
33
|
+
onPointerDown: (event: React.PointerEvent) => void;
|
|
34
|
+
onPointerMove: (event: React.PointerEvent) => void;
|
|
35
|
+
onPointerUp: () => void;
|
|
36
|
+
onPointerCancel: () => void;
|
|
37
|
+
};
|
|
38
|
+
};
|