@pixerate/editor 0.25.0 → 0.26.0

package/dist/spreadsheet/index.d.cts

@@ -1,5 +1,5 @@
-import { A as ASTNode, O as FormulaErrorCode, U as FormulaRange, a as CellData, c as CellFormat, p as ConditionalFormatSheet, n as ConditionalFormatOverlay, o as ConditionalFormatRule, j as ConditionalCellFormat, t as ConditionalFormatValue, l as ConditionalFormatIconSet, F as DataValidationRule, q as ConditionalFormatStyle, r as ConditionalFormatTimePeriod, e as CellRange, y as DataValidationErrorStyle, z as DataValidationOperator, H as DataValidationType, a6 as NewConditionalFormatRule, G as DataValidationSheet, d as CellPosition, E as DataValidationResult, _ as GroupAggregate, af as SortDirection, M as FilterRule, S as SpreadsheetController, as as SpreadsheetDefinedName, aK as StructuralChange } from '../controller-BIJiNoVs.cjs';
-export { B as BinaryOpNode, C as CellCoordinate, b as CellDep, f as CellRefNode, g as CellValueReader, h as ColumnBinding, i as ColumnType, k as ConditionalFormatCondition, m as ConditionalFormatOperator, s as ConditionalFormatType, u as CsvExportOptions, v as CsvImportOptions, D as DEFAULT_COLUMN_WIDTH, w as DEFAULT_ROW_HEIGHT, x as DataSourceBinder, I as DependencyGraph, J as EvaluationContext, K as FORMULA_ERRORS, L as FilterOperator, N as FormulaDiagnostic, P as FormulaEvaluationResult, Q as FormulaEvaluator, R as FormulaNameDefinition, T as FormulaParser, V as FormulaReferenceFilter, W as FormulaReferenceInfo, X as FormulaToken, Y as FormulaTokenType, Z as FunctionCallNode, $ as GroupSummary, a0 as InvokeNode, a1 as LiteralNode, a2 as MAX_FORMULA_ARRAY_SIZE, a3 as MissingNode, a4 as NameDep, a5 as NameNode, a7 as NewDataValidationRule, a8 as NewFilterRule, a9 as ParsedSpreadsheetClipboard, aa as PropertyRefNode, ab as RangeNode, ac as RowType, ad as SPREADSHEET_CLIPBOARD_MIME, ae as SheetQualifier, ag as SortKey, ah as SpillRefNode, ai as SpreadsheetCellSpan, aj as SpreadsheetClipboardCell, ak as SpreadsheetClipboardData, al as SpreadsheetClipboardPayload, am as SpreadsheetClipboardSource, an as SpreadsheetColumn, ao as SpreadsheetCommitResult, ap as SpreadsheetControllerOptions, aq as SpreadsheetDataSource, ar as SpreadsheetDataSourceField, at as SpreadsheetDocument, au as SpreadsheetFilterState, av as SpreadsheetGrouping, aw as SpreadsheetNameInfo, ax as SpreadsheetNameScope, ay as SpreadsheetRow, az as SpreadsheetRowGroup, aA as SpreadsheetRowSection, aB as SpreadsheetSheetInfo, aC as SpreadsheetSpill, aD as SpreadsheetTableSettings, aE as SpreadsheetValidationAction, aF as SpreadsheetValidationPrompt, aG as SpreadsheetViewColumn, aH as SpreadsheetViewModel, aI as SpreadsheetViewRow, aJ as SpreadsheetWorkbook, aL as UnaryOpNode, aM as WHOLE_COLUMN_END_ROW, aN as buildSpreadsheetView, aO as colNameToIndex, aP as columnDependencyKey, aQ as compareNumbers, aR as compareValues, aS as computeRowGroups, aT as createSpreadsheetClipboardData, aU as deleteSheetInFormula, aV as describeFormulaError, aW as extractCellDependencies, aX as extractNameDependencies, aY as formatSheetPrefix, aZ as formulaIdentifiers, a_ as getRowSection, a$ as getTableSections, b0 as indexToColName, b1 as isFormulaError, b2 as mapFormulaReferences, b3 as numberToText, b4 as offsetFormulaReferences, b5 as parseCellReference, b6 as parseFormula, b7 as parseHtmlTable, b8 as parseRange, b9 as quoteSheetName, ba as readSpreadsheetClipboard, bb as rebaseClipboardRows, bc as remapFormulaReferences, bd as renameNameInFormula, be as renameSheetInFormula, bf as rowPassesFilters, bg as serializeHtmlTable, bh as sheetNameNeedsQuotes, bi as shiftFormulaReferences, bj as sortCompareValues, bk as tokenizeFormula } from '../controller-BIJiNoVs.cjs';
+import { A as ASTNode, P as FormulaErrorCode, V as FormulaRange, a as CellData, c as CellFormat, p as ConditionalFormatSheet, n as ConditionalFormatOverlay, o as ConditionalFormatRule, j as ConditionalCellFormat, t as ConditionalFormatValue, l as ConditionalFormatIconSet, F as DataValidationRule, q as ConditionalFormatStyle, r as ConditionalFormatTimePeriod, e as CellRange, y as DataValidationErrorStyle, z as DataValidationOperator, H as DataValidationType, a8 as NewConditionalFormatRule, G as DataValidationSheet, d as CellPosition, E as DataValidationResult, $ as GroupAggregate, aj as SortDirection, N as FilterRule, S as SpreadsheetController, aw as SpreadsheetDefinedName, aP as StructuralChange, aM as SpreadsheetViewModel } from '../controller-CxXGOEmy.cjs';
+export { B as BinaryOpNode, C as CellCoordinate, b as CellDep, f as CellRefNode, g as CellValueReader, h as ColumnBinding, i as ColumnType, k as ConditionalFormatCondition, m as ConditionalFormatOperator, s as ConditionalFormatType, u as CsvExportOptions, v as CsvImportOptions, D as DEFAULT_COLUMN_WIDTH, w as DEFAULT_ROW_HEIGHT, x as DataSourceBinder, I as DependencyGraph, J as DependencyIndexStats, K as EvaluationContext, L as FORMULA_ERRORS, M as FilterOperator, O as FormulaDiagnostic, Q as FormulaEvaluationResult, R as FormulaEvaluator, T as FormulaNameDefinition, U as FormulaParser, W as FormulaReferenceFilter, X as FormulaReferenceInfo, Y as FormulaToken, Z as FormulaTokenType, _ as FunctionCallNode, a0 as GroupSummary, a1 as IntervalIndex, a2 as InvokeNode, a3 as LiteralNode, a4 as MAX_FORMULA_ARRAY_SIZE, a5 as MissingNode, a6 as NameDep, a7 as NameNode, a9 as NewDataValidationRule, aa as NewFilterRule, ab as ParsedSpreadsheetClipboard, ac as PropertyRefNode, ad as RangeNode, ae as RangeResolveOptions, af as ReferenceDep, ag as RowType, ah as SPREADSHEET_CLIPBOARD_MIME, ai as SheetQualifier, ak as SortKey, al as SpillRefNode, am as SpreadsheetCellSpan, an as SpreadsheetClipboardCell, ao as SpreadsheetClipboardData, ap as SpreadsheetClipboardPayload, aq as SpreadsheetClipboardSource, ar as SpreadsheetColumn, as as SpreadsheetCommitResult, at as SpreadsheetControllerOptions, au as SpreadsheetDataSource, av as SpreadsheetDataSourceField, ax as SpreadsheetDocument, ay as SpreadsheetFilterState, az as SpreadsheetGrouping, aA as SpreadsheetNameInfo, aB as SpreadsheetNameScope, aC as SpreadsheetRecalculationStats, aD as SpreadsheetRow, aE as SpreadsheetRowGroup, aF as SpreadsheetRowSection, aG as SpreadsheetSheetInfo, aH as SpreadsheetSpill, aI as SpreadsheetTableSettings, aJ as SpreadsheetValidationAction, aK as SpreadsheetValidationPrompt, aL as SpreadsheetViewColumn, aN as SpreadsheetViewRow, aO as SpreadsheetWorkbook, aQ as UnaryOpNode, aR as WHOLE_COLUMN_END_ROW, aS as buildSpreadsheetView, aT as colNameToIndex, aU as columnDependencyKey, aV as compareNumbers, aW as compareValues, aX as computeRowGroups, aY as createSpreadsheetClipboardData, aZ as deleteSheetInFormula, a_ as describeFormulaError, a$ as extractCellDependencies, b0 as extractNameDependencies, b1 as extractReferenceDependencies, b2 as formatSheetPrefix, b3 as formulaIdentifiers, b4 as getRowSection, b5 as getTableSections, b6 as indexToColName, b7 as isFormulaError, b8 as mapFormulaReferences, b9 as numberToText, ba as offsetFormulaReferences, bb as parseCellReference, bc as parseFormula, bd as parseHtmlTable, be as parseRange, bf as quoteSheetName, bg as rangeDependencyKey, bh as readSpreadsheetClipboard, bi as rebaseClipboardRows, bj as remapFormulaReferences, bk as renameNameInFormula, bl as renameSheetInFormula, bm as rowPassesFilters, bn as serializeHtmlTable, bo as sheetNameNeedsQuotes, bp as shiftFormulaReferences, bq as sortCompareValues, br as tokenizeFormula } from '../controller-CxXGOEmy.cjs';
 import { I as ImportAdapterRegistry, b as ImportAdapter, h as ImportInput, a as ImportOutcome } from '../registry-CEgwXED1.cjs';
 
 /**
@@ -1076,4 +1076,107 @@ declare function formatRuleRanges(ranges: CellRange[]): string;
 /** Parses `A1:B5, D2` (commas, semicolons or spaces between ranges; `$` ignored). Null when any part is not a cell or range. */
 declare function parseRuleRanges(text: string): CellRange[] | null;
 
-export { ASTNode, CONDITIONAL_FORMAT_ICON_SETS, CONDITIONAL_FORMAT_PRESETS, CONDITIONAL_FORMAT_STYLE_PRESETS, CONDITIONAL_FORMAT_TIME_PERIODS, CellData, CellFormat, type CellInputFormatKind, CellPosition, CellRange, ConditionalCellFormat, type ConditionalFormatCss, ConditionalFormatEngine, type ConditionalFormatIconGlyph, ConditionalFormatIconSet, ConditionalFormatOverlay, type ConditionalFormatPresetField, type ConditionalFormatPresetInfo, type ConditionalFormatPresetInput, type ConditionalFormatPresetKind, ConditionalFormatRule, ConditionalFormatSheet, ConditionalFormatStyle, ConditionalFormatTimePeriod, ConditionalFormatValue, type CsvParseOptions, type CsvSerializeOptions, DATA_VALIDATION_ERROR_STYLE_OPTIONS, DATA_VALIDATION_OPERATOR_OPTIONS, DATA_VALIDATION_TYPE_OPTIONS, DEFAULT_CONDITIONAL_FORMAT_STYLE, DEFAULT_DATA_VALIDATION_MESSAGE, DEFAULT_DATA_VALIDATION_TITLE, DataValidationErrorStyle, DataValidationOperator, DataValidationResult, DataValidationRule, DataValidationSheet, DataValidationType, EMPTY_CONDITIONAL_FORMAT_OVERLAY, type FillDirection, FilterRule, type FormattedNumberValue, type FormulaActiveCall, type FormulaArgument, type FormulaArgumentSpec, type FormulaArgumentType, type FormulaCaretContext, type FormulaCriteriaPredicate, type FormulaEnvironment, FormulaErrorCode, type FormulaFunctionCategory, type FormulaFunctionContext, type FormulaFunctionDefinition, type FormulaFunctionSuggestion, type FormulaHints, FormulaLambda, type FormulaNameSuggestionSource, FormulaRange, type FormulaSignaturePart, GroupAggregate, type ImportFileIntoSpreadsheetOptions, MAX_DEFINED_NAME_LENGTH, MAX_LAMBDA_DEPTH, MAX_NUMBER_FORMAT_CODE_CHARS, MAX_SHEET_NAME_LENGTH, NUMBER_FORMAT_PRESETS, NewConditionalFormatRule, NumberFormat, type NumberFormatColor, type NumberFormatKind, type NumberFormatPreset, type ParsedCellInput, SPREADSHEET_IMPORT_ADAPTERS, SPREADSHEET_TABLE_ACTIONS, SortDirection, SpreadsheetController, SpreadsheetDefinedName, type SpreadsheetImport, type SpreadsheetImportAdapter, type SpreadsheetMenuItem, type SpreadsheetNameRow, type SpreadsheetPanelId, type SpreadsheetTableActionName, type SpreadsheetTableActions, StructuralChange, adjustRangeForStructuralChange, adjustRangesForStructuralChange, aggregateValues, applyFormulaSuggestion, bindSpreadsheetTableActions, blendConditionalFormatColors, builtinNumberFormat, builtinNumberFormatId, cellFormatForNumberFormat, checkFormulaArgumentCount, clampMenuPosition, clearNumberFormatCache, compareCellValues, computeFillTarget, conditionalFormatContrastColor, conditionalFormatIconCount, conditionalFormatNumber, conditionalFormatStyleString, copySheetName, createConditionalFormatRule, csvImportAdapter, dateValueToSerial, defaultIconThresholds, describeConditionalFormat, describeDataValidation, escapeCsvField, evaluateConditionalFormats, fillSeries, findDataValidation, findInvalidCells, forEachRangeCell, formatCellDisplay, formatCellForDisplay, formatGeneralFit, formatNumberFormatValue, formatRuleRanges, formatTextFunction, formatValueWithCode, getConditionalFormatCss, getConditionalFormatIcon, getDataBarCss, getFillDirection, getFormulaArgumentSpecIndex, getFormulaCaretContext, getFormulaFunction, getFormulaHints, getFormulaSignature, getFormulaSignatureParts, getNameManagerRows, getSheetTabMenuItems, getSpreadsheetMenuItems, getValidationListValues, importFileIntoSpreadsheet, isBlankValue, isFormulaLambda, isGeneralNumberFormat, isLambdaDefinition, isSingleCellRange, listFormulaFunctions, matchesFilterRule, matchesTimePeriod, nextSheetName, normalizeRange, numberFormatColorToCss, numberFormatForCellFormat, parseCellInput, parseCriteria, parseCsv, parseNumberText, parseRuleRanges, parseTsv, rangeContains, rangeContainsRange, rangesContain, rangesIntersect, registerFormulaFunction, registerSpreadsheetImportAdapters, roundFloat, ruleAnchor, ruleFormulaAt, runSpreadsheetMenuItem, searchFormulaFunctions, serialFromYmd, serializeCsv, serializeTsv, sheetDropIndex, shiftRuleFormula, subtractRange, subtractRangeFromRanges, toNumber, tsvImportAdapter, unregisterFormulaFunction, validateCellInput, validateDefinedName, validateSheetName, wildcardToRegExp };
+/**
+ * Virtualised rendering of large sheets: which displayed rows and columns
+ * are inside (or near) the scrolled viewport, the space taken by the ones
+ * left out, and how far to scroll to bring a cell into view. Framework
+ * bindings render the frozen rows/columns, a spacer, the window and another
+ * spacer; small sheets render everything (`shouldVirtualizeSpreadsheet`).
+ */
+
+/** Height of the sticky column-header row, in pixels. */
+declare const SPREADSHEET_COLUMN_HEADER_HEIGHT = 28;
+/** Width of the sticky row-number column, in pixels. */
+declare const SPREADSHEET_ROW_HEADER_WIDTH = 48;
+/** Height of a category (group) header row, in pixels. */
+declare const SPREADSHEET_GROUP_ROW_HEIGHT = 28;
+/** Displayed rows above which `shouldVirtualizeSpreadsheet` turns virtualisation on. */
+declare const SPREADSHEET_VIRTUAL_ROW_THRESHOLD = 200;
+/** Displayed columns above which `shouldVirtualizeSpreadsheet` turns virtualisation on. */
+declare const SPREADSHEET_VIRTUAL_COLUMN_THRESHOLD = 60;
+/** Viewport assumed before the grid has been measured (server rendering, jsdom). */
+declare const SPREADSHEET_DEFAULT_VIEWPORT: {
+    width: number;
+    height: number;
+};
+/** Pixel positions of a view model's rows and columns (see `measureSpreadsheetView`). */
+interface SpreadsheetViewMetrics {
+    /** Top of each entry of `view.rows`, below the column header; the last entry is the total height. */
+    rowTops: Float64Array;
+    /** Left of each entry of `view.columns`, after the row header; the last entry is the total width. */
+    columnLefts: Float64Array;
+    /** Leading frozen entries of `view.rows` (always rendered, sticky). */
+    frozenRows: number;
+    /** Leading frozen entries of `view.columns`. */
+    frozenColumns: number;
+    /** Position in `view.rows` of each displayed document row. */
+    rowPosition: Map<number, number>;
+    /** Position in `view.columns` of each displayed document column. */
+    columnPosition: Map<number, number>;
+}
+/** The scroll container: its scroll offsets and client size, in pixels. */
+interface SpreadsheetViewport {
+    scrollTop: number;
+    scrollLeft: number;
+    width: number;
+    height: number;
+}
+/**
+ * The part of a view model to render: frozen rows `[0, frozenRows)`, then
+ * `topSpace` pixels of rows left out, then rows `[rowStart, rowEnd)`, then
+ * `bottomSpace`; columns likewise (indices into `view.rows` / `view.columns`).
+ */
+interface SpreadsheetViewWindow {
+    virtual: boolean;
+    frozenRows: number;
+    rowStart: number;
+    rowEnd: number;
+    topSpace: number;
+    bottomSpace: number;
+    frozenColumns: number;
+    colStart: number;
+    colEnd: number;
+    leftSpace: number;
+    rightSpace: number;
+}
+interface SpreadsheetViewWindowOptions {
+    /** Extra rows rendered above and below the viewport. Default 8. */
+    overscanRows?: number;
+    /** Extra columns rendered left and right of the viewport. Default 2. */
+    overscanColumns?: number;
+    /** Merged ranges (document indices): a merge crossing the window's edge is rendered whole. */
+    merges?: readonly CellRange[];
+}
+/** Measures the rows (row height, or the group row height) and columns (width) of a view model. */
+declare function measureSpreadsheetView(view: SpreadsheetViewModel): SpreadsheetViewMetrics;
+/**
+ * Whether to virtualise: `true` / `false` force it; `'auto'` (the default)
+ * virtualises views with more than `SPREADSHEET_VIRTUAL_ROW_THRESHOLD` rows
+ * or `SPREADSHEET_VIRTUAL_COLUMN_THRESHOLD` columns, so small sheets render
+ * every cell exactly as before.
+ */
+declare function shouldVirtualizeSpreadsheet(view: SpreadsheetViewModel, mode?: boolean | 'auto'): boolean;
+/** A window holding every row and column (no spacers). */
+declare function fullSpreadsheetViewWindow(metrics: SpreadsheetViewMetrics): SpreadsheetViewWindow;
+/**
+ * The rows and columns to render for a viewport. Frozen rows and columns are
+ * always rendered; the rest are limited to the viewport plus overscan, and
+ * widened so no merge is cut by the window's edge.
+ */
+declare function getSpreadsheetViewWindow(metrics: SpreadsheetViewMetrics, viewport: SpreadsheetViewport, options?: SpreadsheetViewWindowOptions): SpreadsheetViewWindow;
+/**
+ * Scroll offsets that bring the cell at document (row, col) fully into view
+ * (below the frozen rows, right of the frozen columns), or null when it
+ * already is (or isn't displayed). Only the axes that must move are set.
+ */
+declare function getSpreadsheetScrollToCell(metrics: SpreadsheetViewMetrics, viewport: SpreadsheetViewport, cell: {
+    row: number;
+    col: number;
+}): {
+    scrollTop?: number;
+    scrollLeft?: number;
+} | null;
+/** Whether two windows render the same rows and columns. */
+declare function sameSpreadsheetViewWindow(a: SpreadsheetViewWindow, b: SpreadsheetViewWindow): boolean;
+
+export { ASTNode, CONDITIONAL_FORMAT_ICON_SETS, CONDITIONAL_FORMAT_PRESETS, CONDITIONAL_FORMAT_STYLE_PRESETS, CONDITIONAL_FORMAT_TIME_PERIODS, CellData, CellFormat, type CellInputFormatKind, CellPosition, CellRange, ConditionalCellFormat, type ConditionalFormatCss, ConditionalFormatEngine, type ConditionalFormatIconGlyph, ConditionalFormatIconSet, ConditionalFormatOverlay, type ConditionalFormatPresetField, type ConditionalFormatPresetInfo, type ConditionalFormatPresetInput, type ConditionalFormatPresetKind, ConditionalFormatRule, ConditionalFormatSheet, ConditionalFormatStyle, ConditionalFormatTimePeriod, ConditionalFormatValue, type CsvParseOptions, type CsvSerializeOptions, DATA_VALIDATION_ERROR_STYLE_OPTIONS, DATA_VALIDATION_OPERATOR_OPTIONS, DATA_VALIDATION_TYPE_OPTIONS, DEFAULT_CONDITIONAL_FORMAT_STYLE, DEFAULT_DATA_VALIDATION_MESSAGE, DEFAULT_DATA_VALIDATION_TITLE, DataValidationErrorStyle, DataValidationOperator, DataValidationResult, DataValidationRule, DataValidationSheet, DataValidationType, EMPTY_CONDITIONAL_FORMAT_OVERLAY, type FillDirection, FilterRule, type FormattedNumberValue, type FormulaActiveCall, type FormulaArgument, type FormulaArgumentSpec, type FormulaArgumentType, type FormulaCaretContext, type FormulaCriteriaPredicate, type FormulaEnvironment, FormulaErrorCode, type FormulaFunctionCategory, type FormulaFunctionContext, type FormulaFunctionDefinition, type FormulaFunctionSuggestion, type FormulaHints, FormulaLambda, type FormulaNameSuggestionSource, FormulaRange, type FormulaSignaturePart, GroupAggregate, type ImportFileIntoSpreadsheetOptions, MAX_DEFINED_NAME_LENGTH, MAX_LAMBDA_DEPTH, MAX_NUMBER_FORMAT_CODE_CHARS, MAX_SHEET_NAME_LENGTH, NUMBER_FORMAT_PRESETS, NewConditionalFormatRule, NumberFormat, type NumberFormatColor, type NumberFormatKind, type NumberFormatPreset, type ParsedCellInput, SPREADSHEET_COLUMN_HEADER_HEIGHT, SPREADSHEET_DEFAULT_VIEWPORT, SPREADSHEET_GROUP_ROW_HEIGHT, SPREADSHEET_IMPORT_ADAPTERS, SPREADSHEET_ROW_HEADER_WIDTH, SPREADSHEET_TABLE_ACTIONS, SPREADSHEET_VIRTUAL_COLUMN_THRESHOLD, SPREADSHEET_VIRTUAL_ROW_THRESHOLD, SortDirection, SpreadsheetController, SpreadsheetDefinedName, type SpreadsheetImport, type SpreadsheetImportAdapter, type SpreadsheetMenuItem, type SpreadsheetNameRow, type SpreadsheetPanelId, type SpreadsheetTableActionName, type SpreadsheetTableActions, type SpreadsheetViewMetrics, SpreadsheetViewModel, type SpreadsheetViewWindow, type SpreadsheetViewWindowOptions, type SpreadsheetViewport, StructuralChange, adjustRangeForStructuralChange, adjustRangesForStructuralChange, aggregateValues, applyFormulaSuggestion, bindSpreadsheetTableActions, blendConditionalFormatColors, builtinNumberFormat, builtinNumberFormatId, cellFormatForNumberFormat, checkFormulaArgumentCount, clampMenuPosition, clearNumberFormatCache, compareCellValues, computeFillTarget, conditionalFormatContrastColor, conditionalFormatIconCount, conditionalFormatNumber, conditionalFormatStyleString, copySheetName, createConditionalFormatRule, csvImportAdapter, dateValueToSerial, defaultIconThresholds, describeConditionalFormat, describeDataValidation, escapeCsvField, evaluateConditionalFormats, fillSeries, findDataValidation, findInvalidCells, forEachRangeCell, formatCellDisplay, formatCellForDisplay, formatGeneralFit, formatNumberFormatValue, formatRuleRanges, formatTextFunction, formatValueWithCode, fullSpreadsheetViewWindow, getConditionalFormatCss, getConditionalFormatIcon, getDataBarCss, getFillDirection, getFormulaArgumentSpecIndex, getFormulaCaretContext, getFormulaFunction, getFormulaHints, getFormulaSignature, getFormulaSignatureParts, getNameManagerRows, getSheetTabMenuItems, getSpreadsheetMenuItems, getSpreadsheetScrollToCell, getSpreadsheetViewWindow, getValidationListValues, importFileIntoSpreadsheet, isBlankValue, isFormulaLambda, isGeneralNumberFormat, isLambdaDefinition, isSingleCellRange, listFormulaFunctions, matchesFilterRule, matchesTimePeriod, measureSpreadsheetView, nextSheetName, normalizeRange, numberFormatColorToCss, numberFormatForCellFormat, parseCellInput, parseCriteria, parseCsv, parseNumberText, parseRuleRanges, parseTsv, rangeContains, rangeContainsRange, rangesContain, rangesIntersect, registerFormulaFunction, registerSpreadsheetImportAdapters, roundFloat, ruleAnchor, ruleFormulaAt, runSpreadsheetMenuItem, sameSpreadsheetViewWindow, searchFormulaFunctions, serialFromYmd, serializeCsv, serializeTsv, sheetDropIndex, shiftRuleFormula, shouldVirtualizeSpreadsheet, subtractRange, subtractRangeFromRanges, toNumber, tsvImportAdapter, unregisterFormulaFunction, validateCellInput, validateDefinedName, validateSheetName, wildcardToRegExp };

package/dist/spreadsheet/index.d.ts

@@ -1,5 +1,5 @@
-import { A as ASTNode, O as FormulaErrorCode, U as FormulaRange, a as CellData, c as CellFormat, p as ConditionalFormatSheet, n as ConditionalFormatOverlay, o as ConditionalFormatRule, j as ConditionalCellFormat, t as ConditionalFormatValue, l as ConditionalFormatIconSet, F as DataValidationRule, q as ConditionalFormatStyle, r as ConditionalFormatTimePeriod, e as CellRange, y as DataValidationErrorStyle, z as DataValidationOperator, H as DataValidationType, a6 as NewConditionalFormatRule, G as DataValidationSheet, d as CellPosition, E as DataValidationResult, _ as GroupAggregate, af as SortDirection, M as FilterRule, S as SpreadsheetController, as as SpreadsheetDefinedName, aK as StructuralChange } from '../controller-BIJiNoVs.js';
-export { B as BinaryOpNode, C as CellCoordinate, b as CellDep, f as CellRefNode, g as CellValueReader, h as ColumnBinding, i as ColumnType, k as ConditionalFormatCondition, m as ConditionalFormatOperator, s as ConditionalFormatType, u as CsvExportOptions, v as CsvImportOptions, D as DEFAULT_COLUMN_WIDTH, w as DEFAULT_ROW_HEIGHT, x as DataSourceBinder, I as DependencyGraph, J as EvaluationContext, K as FORMULA_ERRORS, L as FilterOperator, N as FormulaDiagnostic, P as FormulaEvaluationResult, Q as FormulaEvaluator, R as FormulaNameDefinition, T as FormulaParser, V as FormulaReferenceFilter, W as FormulaReferenceInfo, X as FormulaToken, Y as FormulaTokenType, Z as FunctionCallNode, $ as GroupSummary, a0 as InvokeNode, a1 as LiteralNode, a2 as MAX_FORMULA_ARRAY_SIZE, a3 as MissingNode, a4 as NameDep, a5 as NameNode, a7 as NewDataValidationRule, a8 as NewFilterRule, a9 as ParsedSpreadsheetClipboard, aa as PropertyRefNode, ab as RangeNode, ac as RowType, ad as SPREADSHEET_CLIPBOARD_MIME, ae as SheetQualifier, ag as SortKey, ah as SpillRefNode, ai as SpreadsheetCellSpan, aj as SpreadsheetClipboardCell, ak as SpreadsheetClipboardData, al as SpreadsheetClipboardPayload, am as SpreadsheetClipboardSource, an as SpreadsheetColumn, ao as SpreadsheetCommitResult, ap as SpreadsheetControllerOptions, aq as SpreadsheetDataSource, ar as SpreadsheetDataSourceField, at as SpreadsheetDocument, au as SpreadsheetFilterState, av as SpreadsheetGrouping, aw as SpreadsheetNameInfo, ax as SpreadsheetNameScope, ay as SpreadsheetRow, az as SpreadsheetRowGroup, aA as SpreadsheetRowSection, aB as SpreadsheetSheetInfo, aC as SpreadsheetSpill, aD as SpreadsheetTableSettings, aE as SpreadsheetValidationAction, aF as SpreadsheetValidationPrompt, aG as SpreadsheetViewColumn, aH as SpreadsheetViewModel, aI as SpreadsheetViewRow, aJ as SpreadsheetWorkbook, aL as UnaryOpNode, aM as WHOLE_COLUMN_END_ROW, aN as buildSpreadsheetView, aO as colNameToIndex, aP as columnDependencyKey, aQ as compareNumbers, aR as compareValues, aS as computeRowGroups, aT as createSpreadsheetClipboardData, aU as deleteSheetInFormula, aV as describeFormulaError, aW as extractCellDependencies, aX as extractNameDependencies, aY as formatSheetPrefix, aZ as formulaIdentifiers, a_ as getRowSection, a$ as getTableSections, b0 as indexToColName, b1 as isFormulaError, b2 as mapFormulaReferences, b3 as numberToText, b4 as offsetFormulaReferences, b5 as parseCellReference, b6 as parseFormula, b7 as parseHtmlTable, b8 as parseRange, b9 as quoteSheetName, ba as readSpreadsheetClipboard, bb as rebaseClipboardRows, bc as remapFormulaReferences, bd as renameNameInFormula, be as renameSheetInFormula, bf as rowPassesFilters, bg as serializeHtmlTable, bh as sheetNameNeedsQuotes, bi as shiftFormulaReferences, bj as sortCompareValues, bk as tokenizeFormula } from '../controller-BIJiNoVs.js';
+import { A as ASTNode, P as FormulaErrorCode, V as FormulaRange, a as CellData, c as CellFormat, p as ConditionalFormatSheet, n as ConditionalFormatOverlay, o as ConditionalFormatRule, j as ConditionalCellFormat, t as ConditionalFormatValue, l as ConditionalFormatIconSet, F as DataValidationRule, q as ConditionalFormatStyle, r as ConditionalFormatTimePeriod, e as CellRange, y as DataValidationErrorStyle, z as DataValidationOperator, H as DataValidationType, a8 as NewConditionalFormatRule, G as DataValidationSheet, d as CellPosition, E as DataValidationResult, $ as GroupAggregate, aj as SortDirection, N as FilterRule, S as SpreadsheetController, aw as SpreadsheetDefinedName, aP as StructuralChange, aM as SpreadsheetViewModel } from '../controller-CxXGOEmy.js';
+export { B as BinaryOpNode, C as CellCoordinate, b as CellDep, f as CellRefNode, g as CellValueReader, h as ColumnBinding, i as ColumnType, k as ConditionalFormatCondition, m as ConditionalFormatOperator, s as ConditionalFormatType, u as CsvExportOptions, v as CsvImportOptions, D as DEFAULT_COLUMN_WIDTH, w as DEFAULT_ROW_HEIGHT, x as DataSourceBinder, I as DependencyGraph, J as DependencyIndexStats, K as EvaluationContext, L as FORMULA_ERRORS, M as FilterOperator, O as FormulaDiagnostic, Q as FormulaEvaluationResult, R as FormulaEvaluator, T as FormulaNameDefinition, U as FormulaParser, W as FormulaReferenceFilter, X as FormulaReferenceInfo, Y as FormulaToken, Z as FormulaTokenType, _ as FunctionCallNode, a0 as GroupSummary, a1 as IntervalIndex, a2 as InvokeNode, a3 as LiteralNode, a4 as MAX_FORMULA_ARRAY_SIZE, a5 as MissingNode, a6 as NameDep, a7 as NameNode, a9 as NewDataValidationRule, aa as NewFilterRule, ab as ParsedSpreadsheetClipboard, ac as PropertyRefNode, ad as RangeNode, ae as RangeResolveOptions, af as ReferenceDep, ag as RowType, ah as SPREADSHEET_CLIPBOARD_MIME, ai as SheetQualifier, ak as SortKey, al as SpillRefNode, am as SpreadsheetCellSpan, an as SpreadsheetClipboardCell, ao as SpreadsheetClipboardData, ap as SpreadsheetClipboardPayload, aq as SpreadsheetClipboardSource, ar as SpreadsheetColumn, as as SpreadsheetCommitResult, at as SpreadsheetControllerOptions, au as SpreadsheetDataSource, av as SpreadsheetDataSourceField, ax as SpreadsheetDocument, ay as SpreadsheetFilterState, az as SpreadsheetGrouping, aA as SpreadsheetNameInfo, aB as SpreadsheetNameScope, aC as SpreadsheetRecalculationStats, aD as SpreadsheetRow, aE as SpreadsheetRowGroup, aF as SpreadsheetRowSection, aG as SpreadsheetSheetInfo, aH as SpreadsheetSpill, aI as SpreadsheetTableSettings, aJ as SpreadsheetValidationAction, aK as SpreadsheetValidationPrompt, aL as SpreadsheetViewColumn, aN as SpreadsheetViewRow, aO as SpreadsheetWorkbook, aQ as UnaryOpNode, aR as WHOLE_COLUMN_END_ROW, aS as buildSpreadsheetView, aT as colNameToIndex, aU as columnDependencyKey, aV as compareNumbers, aW as compareValues, aX as computeRowGroups, aY as createSpreadsheetClipboardData, aZ as deleteSheetInFormula, a_ as describeFormulaError, a$ as extractCellDependencies, b0 as extractNameDependencies, b1 as extractReferenceDependencies, b2 as formatSheetPrefix, b3 as formulaIdentifiers, b4 as getRowSection, b5 as getTableSections, b6 as indexToColName, b7 as isFormulaError, b8 as mapFormulaReferences, b9 as numberToText, ba as offsetFormulaReferences, bb as parseCellReference, bc as parseFormula, bd as parseHtmlTable, be as parseRange, bf as quoteSheetName, bg as rangeDependencyKey, bh as readSpreadsheetClipboard, bi as rebaseClipboardRows, bj as remapFormulaReferences, bk as renameNameInFormula, bl as renameSheetInFormula, bm as rowPassesFilters, bn as serializeHtmlTable, bo as sheetNameNeedsQuotes, bp as shiftFormulaReferences, bq as sortCompareValues, br as tokenizeFormula } from '../controller-CxXGOEmy.js';
 import { I as ImportAdapterRegistry, b as ImportAdapter, h as ImportInput, a as ImportOutcome } from '../registry-CEgwXED1.js';
 
 /**
@@ -1076,4 +1076,107 @@ declare function formatRuleRanges(ranges: CellRange[]): string;
 /** Parses `A1:B5, D2` (commas, semicolons or spaces between ranges; `$` ignored). Null when any part is not a cell or range. */
 declare function parseRuleRanges(text: string): CellRange[] | null;
 
-export { ASTNode, CONDITIONAL_FORMAT_ICON_SETS, CONDITIONAL_FORMAT_PRESETS, CONDITIONAL_FORMAT_STYLE_PRESETS, CONDITIONAL_FORMAT_TIME_PERIODS, CellData, CellFormat, type CellInputFormatKind, CellPosition, CellRange, ConditionalCellFormat, type ConditionalFormatCss, ConditionalFormatEngine, type ConditionalFormatIconGlyph, ConditionalFormatIconSet, ConditionalFormatOverlay, type ConditionalFormatPresetField, type ConditionalFormatPresetInfo, type ConditionalFormatPresetInput, type ConditionalFormatPresetKind, ConditionalFormatRule, ConditionalFormatSheet, ConditionalFormatStyle, ConditionalFormatTimePeriod, ConditionalFormatValue, type CsvParseOptions, type CsvSerializeOptions, DATA_VALIDATION_ERROR_STYLE_OPTIONS, DATA_VALIDATION_OPERATOR_OPTIONS, DATA_VALIDATION_TYPE_OPTIONS, DEFAULT_CONDITIONAL_FORMAT_STYLE, DEFAULT_DATA_VALIDATION_MESSAGE, DEFAULT_DATA_VALIDATION_TITLE, DataValidationErrorStyle, DataValidationOperator, DataValidationResult, DataValidationRule, DataValidationSheet, DataValidationType, EMPTY_CONDITIONAL_FORMAT_OVERLAY, type FillDirection, FilterRule, type FormattedNumberValue, type FormulaActiveCall, type FormulaArgument, type FormulaArgumentSpec, type FormulaArgumentType, type FormulaCaretContext, type FormulaCriteriaPredicate, type FormulaEnvironment, FormulaErrorCode, type FormulaFunctionCategory, type FormulaFunctionContext, type FormulaFunctionDefinition, type FormulaFunctionSuggestion, type FormulaHints, FormulaLambda, type FormulaNameSuggestionSource, FormulaRange, type FormulaSignaturePart, GroupAggregate, type ImportFileIntoSpreadsheetOptions, MAX_DEFINED_NAME_LENGTH, MAX_LAMBDA_DEPTH, MAX_NUMBER_FORMAT_CODE_CHARS, MAX_SHEET_NAME_LENGTH, NUMBER_FORMAT_PRESETS, NewConditionalFormatRule, NumberFormat, type NumberFormatColor, type NumberFormatKind, type NumberFormatPreset, type ParsedCellInput, SPREADSHEET_IMPORT_ADAPTERS, SPREADSHEET_TABLE_ACTIONS, SortDirection, SpreadsheetController, SpreadsheetDefinedName, type SpreadsheetImport, type SpreadsheetImportAdapter, type SpreadsheetMenuItem, type SpreadsheetNameRow, type SpreadsheetPanelId, type SpreadsheetTableActionName, type SpreadsheetTableActions, StructuralChange, adjustRangeForStructuralChange, adjustRangesForStructuralChange, aggregateValues, applyFormulaSuggestion, bindSpreadsheetTableActions, blendConditionalFormatColors, builtinNumberFormat, builtinNumberFormatId, cellFormatForNumberFormat, checkFormulaArgumentCount, clampMenuPosition, clearNumberFormatCache, compareCellValues, computeFillTarget, conditionalFormatContrastColor, conditionalFormatIconCount, conditionalFormatNumber, conditionalFormatStyleString, copySheetName, createConditionalFormatRule, csvImportAdapter, dateValueToSerial, defaultIconThresholds, describeConditionalFormat, describeDataValidation, escapeCsvField, evaluateConditionalFormats, fillSeries, findDataValidation, findInvalidCells, forEachRangeCell, formatCellDisplay, formatCellForDisplay, formatGeneralFit, formatNumberFormatValue, formatRuleRanges, formatTextFunction, formatValueWithCode, getConditionalFormatCss, getConditionalFormatIcon, getDataBarCss, getFillDirection, getFormulaArgumentSpecIndex, getFormulaCaretContext, getFormulaFunction, getFormulaHints, getFormulaSignature, getFormulaSignatureParts, getNameManagerRows, getSheetTabMenuItems, getSpreadsheetMenuItems, getValidationListValues, importFileIntoSpreadsheet, isBlankValue, isFormulaLambda, isGeneralNumberFormat, isLambdaDefinition, isSingleCellRange, listFormulaFunctions, matchesFilterRule, matchesTimePeriod, nextSheetName, normalizeRange, numberFormatColorToCss, numberFormatForCellFormat, parseCellInput, parseCriteria, parseCsv, parseNumberText, parseRuleRanges, parseTsv, rangeContains, rangeContainsRange, rangesContain, rangesIntersect, registerFormulaFunction, registerSpreadsheetImportAdapters, roundFloat, ruleAnchor, ruleFormulaAt, runSpreadsheetMenuItem, searchFormulaFunctions, serialFromYmd, serializeCsv, serializeTsv, sheetDropIndex, shiftRuleFormula, subtractRange, subtractRangeFromRanges, toNumber, tsvImportAdapter, unregisterFormulaFunction, validateCellInput, validateDefinedName, validateSheetName, wildcardToRegExp };
+/**
+ * Virtualised rendering of large sheets: which displayed rows and columns
+ * are inside (or near) the scrolled viewport, the space taken by the ones
+ * left out, and how far to scroll to bring a cell into view. Framework
+ * bindings render the frozen rows/columns, a spacer, the window and another
+ * spacer; small sheets render everything (`shouldVirtualizeSpreadsheet`).
+ */
+
+/** Height of the sticky column-header row, in pixels. */
+declare const SPREADSHEET_COLUMN_HEADER_HEIGHT = 28;
+/** Width of the sticky row-number column, in pixels. */
+declare const SPREADSHEET_ROW_HEADER_WIDTH = 48;
+/** Height of a category (group) header row, in pixels. */
+declare const SPREADSHEET_GROUP_ROW_HEIGHT = 28;
+/** Displayed rows above which `shouldVirtualizeSpreadsheet` turns virtualisation on. */
+declare const SPREADSHEET_VIRTUAL_ROW_THRESHOLD = 200;
+/** Displayed columns above which `shouldVirtualizeSpreadsheet` turns virtualisation on. */
+declare const SPREADSHEET_VIRTUAL_COLUMN_THRESHOLD = 60;
+/** Viewport assumed before the grid has been measured (server rendering, jsdom). */
+declare const SPREADSHEET_DEFAULT_VIEWPORT: {
+    width: number;
+    height: number;
+};
+/** Pixel positions of a view model's rows and columns (see `measureSpreadsheetView`). */
+interface SpreadsheetViewMetrics {
+    /** Top of each entry of `view.rows`, below the column header; the last entry is the total height. */
+    rowTops: Float64Array;
+    /** Left of each entry of `view.columns`, after the row header; the last entry is the total width. */
+    columnLefts: Float64Array;
+    /** Leading frozen entries of `view.rows` (always rendered, sticky). */
+    frozenRows: number;
+    /** Leading frozen entries of `view.columns`. */
+    frozenColumns: number;
+    /** Position in `view.rows` of each displayed document row. */
+    rowPosition: Map<number, number>;
+    /** Position in `view.columns` of each displayed document column. */
+    columnPosition: Map<number, number>;
+}
+/** The scroll container: its scroll offsets and client size, in pixels. */
+interface SpreadsheetViewport {
+    scrollTop: number;
+    scrollLeft: number;
+    width: number;
+    height: number;
+}
+/**
+ * The part of a view model to render: frozen rows `[0, frozenRows)`, then
+ * `topSpace` pixels of rows left out, then rows `[rowStart, rowEnd)`, then
+ * `bottomSpace`; columns likewise (indices into `view.rows` / `view.columns`).
+ */
+interface SpreadsheetViewWindow {
+    virtual: boolean;
+    frozenRows: number;
+    rowStart: number;
+    rowEnd: number;
+    topSpace: number;
+    bottomSpace: number;
+    frozenColumns: number;
+    colStart: number;
+    colEnd: number;
+    leftSpace: number;
+    rightSpace: number;
+}
+interface SpreadsheetViewWindowOptions {
+    /** Extra rows rendered above and below the viewport. Default 8. */
+    overscanRows?: number;
+    /** Extra columns rendered left and right of the viewport. Default 2. */
+    overscanColumns?: number;
+    /** Merged ranges (document indices): a merge crossing the window's edge is rendered whole. */
+    merges?: readonly CellRange[];
+}
+/** Measures the rows (row height, or the group row height) and columns (width) of a view model. */
+declare function measureSpreadsheetView(view: SpreadsheetViewModel): SpreadsheetViewMetrics;
+/**
+ * Whether to virtualise: `true` / `false` force it; `'auto'` (the default)
+ * virtualises views with more than `SPREADSHEET_VIRTUAL_ROW_THRESHOLD` rows
+ * or `SPREADSHEET_VIRTUAL_COLUMN_THRESHOLD` columns, so small sheets render
+ * every cell exactly as before.
+ */
+declare function shouldVirtualizeSpreadsheet(view: SpreadsheetViewModel, mode?: boolean | 'auto'): boolean;
+/** A window holding every row and column (no spacers). */
+declare function fullSpreadsheetViewWindow(metrics: SpreadsheetViewMetrics): SpreadsheetViewWindow;
+/**
+ * The rows and columns to render for a viewport. Frozen rows and columns are
+ * always rendered; the rest are limited to the viewport plus overscan, and
+ * widened so no merge is cut by the window's edge.
+ */
+declare function getSpreadsheetViewWindow(metrics: SpreadsheetViewMetrics, viewport: SpreadsheetViewport, options?: SpreadsheetViewWindowOptions): SpreadsheetViewWindow;
+/**
+ * Scroll offsets that bring the cell at document (row, col) fully into view
+ * (below the frozen rows, right of the frozen columns), or null when it
+ * already is (or isn't displayed). Only the axes that must move are set.
+ */
+declare function getSpreadsheetScrollToCell(metrics: SpreadsheetViewMetrics, viewport: SpreadsheetViewport, cell: {
+    row: number;
+    col: number;
+}): {
+    scrollTop?: number;
+    scrollLeft?: number;
+} | null;
+/** Whether two windows render the same rows and columns. */
+declare function sameSpreadsheetViewWindow(a: SpreadsheetViewWindow, b: SpreadsheetViewWindow): boolean;
+
+export { ASTNode, CONDITIONAL_FORMAT_ICON_SETS, CONDITIONAL_FORMAT_PRESETS, CONDITIONAL_FORMAT_STYLE_PRESETS, CONDITIONAL_FORMAT_TIME_PERIODS, CellData, CellFormat, type CellInputFormatKind, CellPosition, CellRange, ConditionalCellFormat, type ConditionalFormatCss, ConditionalFormatEngine, type ConditionalFormatIconGlyph, ConditionalFormatIconSet, ConditionalFormatOverlay, type ConditionalFormatPresetField, type ConditionalFormatPresetInfo, type ConditionalFormatPresetInput, type ConditionalFormatPresetKind, ConditionalFormatRule, ConditionalFormatSheet, ConditionalFormatStyle, ConditionalFormatTimePeriod, ConditionalFormatValue, type CsvParseOptions, type CsvSerializeOptions, DATA_VALIDATION_ERROR_STYLE_OPTIONS, DATA_VALIDATION_OPERATOR_OPTIONS, DATA_VALIDATION_TYPE_OPTIONS, DEFAULT_CONDITIONAL_FORMAT_STYLE, DEFAULT_DATA_VALIDATION_MESSAGE, DEFAULT_DATA_VALIDATION_TITLE, DataValidationErrorStyle, DataValidationOperator, DataValidationResult, DataValidationRule, DataValidationSheet, DataValidationType, EMPTY_CONDITIONAL_FORMAT_OVERLAY, type FillDirection, FilterRule, type FormattedNumberValue, type FormulaActiveCall, type FormulaArgument, type FormulaArgumentSpec, type FormulaArgumentType, type FormulaCaretContext, type FormulaCriteriaPredicate, type FormulaEnvironment, FormulaErrorCode, type FormulaFunctionCategory, type FormulaFunctionContext, type FormulaFunctionDefinition, type FormulaFunctionSuggestion, type FormulaHints, FormulaLambda, type FormulaNameSuggestionSource, FormulaRange, type FormulaSignaturePart, GroupAggregate, type ImportFileIntoSpreadsheetOptions, MAX_DEFINED_NAME_LENGTH, MAX_LAMBDA_DEPTH, MAX_NUMBER_FORMAT_CODE_CHARS, MAX_SHEET_NAME_LENGTH, NUMBER_FORMAT_PRESETS, NewConditionalFormatRule, NumberFormat, type NumberFormatColor, type NumberFormatKind, type NumberFormatPreset, type ParsedCellInput, SPREADSHEET_COLUMN_HEADER_HEIGHT, SPREADSHEET_DEFAULT_VIEWPORT, SPREADSHEET_GROUP_ROW_HEIGHT, SPREADSHEET_IMPORT_ADAPTERS, SPREADSHEET_ROW_HEADER_WIDTH, SPREADSHEET_TABLE_ACTIONS, SPREADSHEET_VIRTUAL_COLUMN_THRESHOLD, SPREADSHEET_VIRTUAL_ROW_THRESHOLD, SortDirection, SpreadsheetController, SpreadsheetDefinedName, type SpreadsheetImport, type SpreadsheetImportAdapter, type SpreadsheetMenuItem, type SpreadsheetNameRow, type SpreadsheetPanelId, type SpreadsheetTableActionName, type SpreadsheetTableActions, type SpreadsheetViewMetrics, SpreadsheetViewModel, type SpreadsheetViewWindow, type SpreadsheetViewWindowOptions, type SpreadsheetViewport, StructuralChange, adjustRangeForStructuralChange, adjustRangesForStructuralChange, aggregateValues, applyFormulaSuggestion, bindSpreadsheetTableActions, blendConditionalFormatColors, builtinNumberFormat, builtinNumberFormatId, cellFormatForNumberFormat, checkFormulaArgumentCount, clampMenuPosition, clearNumberFormatCache, compareCellValues, computeFillTarget, conditionalFormatContrastColor, conditionalFormatIconCount, conditionalFormatNumber, conditionalFormatStyleString, copySheetName, createConditionalFormatRule, csvImportAdapter, dateValueToSerial, defaultIconThresholds, describeConditionalFormat, describeDataValidation, escapeCsvField, evaluateConditionalFormats, fillSeries, findDataValidation, findInvalidCells, forEachRangeCell, formatCellDisplay, formatCellForDisplay, formatGeneralFit, formatNumberFormatValue, formatRuleRanges, formatTextFunction, formatValueWithCode, fullSpreadsheetViewWindow, getConditionalFormatCss, getConditionalFormatIcon, getDataBarCss, getFillDirection, getFormulaArgumentSpecIndex, getFormulaCaretContext, getFormulaFunction, getFormulaHints, getFormulaSignature, getFormulaSignatureParts, getNameManagerRows, getSheetTabMenuItems, getSpreadsheetMenuItems, getSpreadsheetScrollToCell, getSpreadsheetViewWindow, getValidationListValues, importFileIntoSpreadsheet, isBlankValue, isFormulaLambda, isGeneralNumberFormat, isLambdaDefinition, isSingleCellRange, listFormulaFunctions, matchesFilterRule, matchesTimePeriod, measureSpreadsheetView, nextSheetName, normalizeRange, numberFormatColorToCss, numberFormatForCellFormat, parseCellInput, parseCriteria, parseCsv, parseNumberText, parseRuleRanges, parseTsv, rangeContains, rangeContainsRange, rangesContain, rangesIntersect, registerFormulaFunction, registerSpreadsheetImportAdapters, roundFloat, ruleAnchor, ruleFormulaAt, runSpreadsheetMenuItem, sameSpreadsheetViewWindow, searchFormulaFunctions, serialFromYmd, serializeCsv, serializeTsv, sheetDropIndex, shiftRuleFormula, shouldVirtualizeSpreadsheet, subtractRange, subtractRangeFromRanges, toNumber, tsvImportAdapter, unregisterFormulaFunction, validateCellInput, validateDefinedName, validateSheetName, wildcardToRegExp };

package/dist/spreadsheet/index.js

@@ -15,12 +15,19 @@ import {
   DataSourceBinder,
   DependencyGraph,
   EMPTY_CONDITIONAL_FORMAT_OVERLAY,
+  IntervalIndex,
   MAX_DEFINED_NAME_LENGTH,
   MAX_SHEET_NAME_LENGTH,
   NUMBER_FORMAT_PRESETS,
   SPREADSHEET_CLIPBOARD_MIME,
+  SPREADSHEET_COLUMN_HEADER_HEIGHT,
+  SPREADSHEET_DEFAULT_VIEWPORT,
+  SPREADSHEET_GROUP_ROW_HEIGHT,
   SPREADSHEET_IMPORT_ADAPTERS,
+  SPREADSHEET_ROW_HEADER_WIDTH,
   SPREADSHEET_TABLE_ACTIONS,
+  SPREADSHEET_VIRTUAL_COLUMN_THRESHOLD,
+  SPREADSHEET_VIRTUAL_ROW_THRESHOLD,
   SpreadsheetController,
   adjustRangeForStructuralChange,
   adjustRangesForStructuralChange,
@@ -50,6 +57,7 @@ import {
   evaluateConditionalFormats,
   extractCellDependencies,
   extractNameDependencies,
+  extractReferenceDependencies,
   fillSeries,
   findDataValidation,
   findInvalidCells,
@@ -60,6 +68,7 @@ import {
   formatSheetPrefix,
   formatValueWithCode,
   formulaIdentifiers,
+  fullSpreadsheetViewWindow,
   getConditionalFormatCss,
   getConditionalFormatIcon,
   getDataBarCss,
@@ -70,6 +79,8 @@ import {
   getRowSection,
   getSheetTabMenuItems,
   getSpreadsheetMenuItems,
+  getSpreadsheetScrollToCell,
+  getSpreadsheetViewWindow,
   getTableSections,
   getValidationListValues,
   importFileIntoSpreadsheet,
@@ -80,6 +91,7 @@ import {
   mapFormulaReferences,
   matchesFilterRule,
   matchesTimePeriod,
+  measureSpreadsheetView,
   nextSheetName,
   normalizeRange,
   numberFormatForCellFormat,
@@ -89,6 +101,7 @@ import {
   quoteSheetName,
   rangeContains,
   rangeContainsRange,
+  rangeDependencyKey,
   rangesContain,
   rangesIntersect,
   readSpreadsheetClipboard,
@@ -102,11 +115,13 @@ import {
   ruleAnchor,
   ruleFormulaAt,
   runSpreadsheetMenuItem,
+  sameSpreadsheetViewWindow,
   serializeHtmlTable,
   sheetDropIndex,
   sheetNameNeedsQuotes,
   shiftFormulaReferences,
   shiftRuleFormula,
+  shouldVirtualizeSpreadsheet,
   subtractRange,
   subtractRangeFromRanges,
   toNumber,
@@ -114,7 +129,7 @@ import {
   validateCellInput,
   validateDefinedName,
   validateSheetName
-} from "../chunk-RR7F5GUM.js";
+} from "../chunk-X7HXL2SB.js";
 import {
   escapeCsvField,
   parseCsv,
@@ -167,7 +182,7 @@ import {
   tokenizeFormula,
   unregisterFormulaFunction,
   wildcardToRegExp
-} from "../chunk-FH6F67DN.js";
+} from "../chunk-ZRNHGAQT.js";
 export {
   CONDITIONAL_FORMAT_ICON_SETS,
   CONDITIONAL_FORMAT_PRESETS,
@@ -189,6 +204,7 @@ export {
   FormulaEvaluator,
   FormulaLambda,
   FormulaParser,
+  IntervalIndex,
   MAX_DEFINED_NAME_LENGTH,
   MAX_FORMULA_ARRAY_SIZE,
   MAX_LAMBDA_DEPTH,
@@ -197,8 +213,14 @@ export {
   NUMBER_FORMAT_PRESETS,
   NumberFormat,
   SPREADSHEET_CLIPBOARD_MIME,
+  SPREADSHEET_COLUMN_HEADER_HEIGHT,
+  SPREADSHEET_DEFAULT_VIEWPORT,
+  SPREADSHEET_GROUP_ROW_HEIGHT,
   SPREADSHEET_IMPORT_ADAPTERS,
+  SPREADSHEET_ROW_HEADER_WIDTH,
   SPREADSHEET_TABLE_ACTIONS,
+  SPREADSHEET_VIRTUAL_COLUMN_THRESHOLD,
+  SPREADSHEET_VIRTUAL_ROW_THRESHOLD,
   SpreadsheetController,
   WHOLE_COLUMN_END_ROW,
   adjustRangeForStructuralChange,
@@ -239,6 +261,7 @@ export {
   evaluateConditionalFormats,
   extractCellDependencies,
   extractNameDependencies,
+  extractReferenceDependencies,
   fillSeries,
   findDataValidation,
   findInvalidCells,
@@ -252,6 +275,7 @@ export {
   formatTextFunction,
   formatValueWithCode,
   formulaIdentifiers,
+  fullSpreadsheetViewWindow,
   getConditionalFormatCss,
   getConditionalFormatIcon,
   getDataBarCss,
@@ -266,6 +290,8 @@ export {
   getRowSection,
   getSheetTabMenuItems,
   getSpreadsheetMenuItems,
+  getSpreadsheetScrollToCell,
+  getSpreadsheetViewWindow,
   getTableSections,
   getValidationListValues,
   importFileIntoSpreadsheet,
@@ -280,6 +306,7 @@ export {
   mapFormulaReferences,
   matchesFilterRule,
   matchesTimePeriod,
+  measureSpreadsheetView,
   nextSheetName,
   normalizeRange,
   numberFormatColorToCss,
@@ -299,6 +326,7 @@ export {
   quoteSheetName,
   rangeContains,
   rangeContainsRange,
+  rangeDependencyKey,
   rangesContain,
   rangesIntersect,
   readSpreadsheetClipboard,
@@ -313,6 +341,7 @@ export {
   ruleAnchor,
   ruleFormulaAt,
   runSpreadsheetMenuItem,
+  sameSpreadsheetViewWindow,
   searchFormulaFunctions,
   serialFromYmd,
   serializeCsv,
@@ -322,6 +351,7 @@ export {
   sheetNameNeedsQuotes,
   shiftFormulaReferences,
   shiftRuleFormula,
+  shouldVirtualizeSpreadsheet,
   sortCompareValues,
   subtractRange,
   subtractRangeFromRanges,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pixerate/editor",
-  "version": "0.25.0",
+  "version": "0.26.0",
   "description": "UI-agnostic rich text and media editing core library",
   "author": "Pixerate",
   "license": "MIT",
@@ -83,6 +83,11 @@
       "types": "./dist/tokens/index.d.ts",
       "import": "./dist/tokens/index.js",
       "require": "./dist/tokens/index.cjs"
+    },
+    "./export": {
+      "types": "./dist/export/index.d.ts",
+      "import": "./dist/export/index.js",
+      "require": "./dist/export/index.cjs"
     }
   },
   "files": [
@@ -100,6 +105,10 @@
     "@tiptap/extension-placeholder": "^2.11.5",
     "@tiptap/extension-subscript": "^2.11.5",
     "@tiptap/extension-superscript": "^2.11.5",
+    "@tiptap/extension-table": "^2.11.5",
+    "@tiptap/extension-table-cell": "^2.11.5",
+    "@tiptap/extension-table-header": "^2.11.5",
+    "@tiptap/extension-table-row": "^2.11.5",
     "@tiptap/extension-task-item": "^2.11.5",
     "@tiptap/extension-task-list": "^2.11.5",
     "@tiptap/extension-text-align": "^2.11.5",