@svgrid/enterprise 3.0.1 → 3.0.2

package/dist/index.d.ts

@@ -2,7 +2,7 @@ export { setLicenseKey, clearLicenseKey, getLicenseKey, isLicenseKeySet, hasVali
 export { parseLicenseExpiry } from './license-core.js';
 export { exportGrid, copyExportToClipboard, type ExportFormat, type ExportOptions, type ExportColumn, type ExportCellStyle, type ExportStyles, type ExportHeaderFooterLine, type ExportSheet, type ExportRowSource, type ExportProgress, type ExportResult, type ClipboardFormat, type ClipboardExportOptions, } from './export.js';
 export { default as SvExportMenu } from './SvExportMenu.svelte';
-export { buildPdfDocDefinition, type PdfExportOptions, type PdfPageSize } from './export-pdf.js';
+export { buildPdfDocDefinition, resolvePdfCharts, resolvePdfVfs, registerPdfFonts, type PdfExportOptions, type PdfPageSize, type PdfChart, type PdfKpi, type PdfChartImage, type PdfVirtualFileSystem, type PdfMakeLike } from './export-pdf.js';
 export { printGrid, type PrintOptions } from './print.js';
 export { importData, readImportMatrix, mapImportMatrix, mapImportMatrixAsync, autoMapColumns, inferImportColumnTypes, type ImportFormat, type ImportFieldType, type ImportOptions, type ImportResult, type ImportProgress, type ImportColumnMap, type ImportColumnTypes, type ImportGridColumn, type ImportRowError, type ImportValidator, } from './import.js';
 export { default as SvImportDialog } from './SvImportDialog.svelte';
@@ -13,6 +13,69 @@ export { enableSelectionBar, SvGridSelectionBar } from './selection-bar.js';
 export { applyBulkEdit, bulkEditableFields, bulkEditInitialValues, coerceBulkValue, type BulkEditField, type BulkEditResult } from './bulk-edit.js';
 export { default as SvGridBulkEditDrawer } from './SvGridBulkEditDrawer.svelte';
 export { enablePivot } from './pivot-enable.js';
+export { enableSheet } from './sheet-enable.js';
+export { createTableRegistry, isValidTableName, resolveTableRange, columnIndexOf, rowCountOf, type TableRegion, type TableRegistry, type TableRange, type TableSpecifier, } from './sheet/tables.js';
+export { goalSeek, goalSeekCell, type GoalSeekOptions, type GoalSeekResult, type GoalSeekSheet, type CellAddress as GoalSeekCellAddress, } from './sheet/goal-seek.js';
+export { default as SvSheetTabs } from './SvSheetTabs.svelte';
+export { createWorkbook, isValidSheetName, type Workbook, type SheetData, type WorkbookOptions, } from './sheet/workbook.js';
+export { setWorkbook, getWorkbook } from './sheet/shortcuts.js';
+export { createSheetDocument, type SheetDocument, type SheetDocumentInit, type SheetState, type SheetStateEntry, type PerSheetState, type SheetChangeReason, } from './sheet/document.js';
+export { shiftRect, shiftRects, subtractRect, rectContains, rectsIntersect, remapNotes, lineShift, type NotesMap } from './sheet/rects.js';
+export { isLocked, rectsHaveLocked, rectsMixLocked, PROTECTED_MESSAGE } from './sheet/protection.js';
+export { commentAt, withComment, listComments, nextComment } from './sheet/comments.js';
+export { ruleAt, rulesIn, checkEntry, listChoices, shiftValidation, removeValidation, describeRule, dateValue, validationId, DEFAULT_ALERT_MESSAGE, OPERATOR_LABELS, type ValidationRule, type ValidationAllow, type ValidationOperator, type ValidationContext, type ValidationVerdict, type ValidationSpec, } from './sheet/validation.js';
+export { ruleStats, evaluateCf, shiftCf, removeCf, cfIn, describeCf, scaleColor, iconIndex, hasStyle, cfId, CF_PRESET_STYLES, COLOR_SCALES, DATA_BAR_COLOR, type CfRule, type CfRuleBody, type CfStyledRule, type CfBody, type CfPreset, type CfStyle, type CfStats, type CfResult, type CfContext, type CfOperator, type CfTextMatch, type CfIconSet, type CfScaleColors, type CfKind, } from './sheet/conditional-formats.js';
+export { mergePlan, unmergePlan, mergeDropsValues, mergesIn, mergeAt as sheetMergeAt, isCoveredCell, selectionMerged, toGridMerges, sortBlockedByMerges, reorderMerges, normalRect, type MergeKind, type MergePlan, } from './sheet/merges.js';
+export { distinctValues, hiddenRowsFor, passesFilter, isFiltering, withColumnFilter, valuesFilter, shiftAutoFilter, describeFilter, type AutoFilterState, type ColumnFilter, type FilterCondition, type FilterValue, } from './sheet/auto-filter.js';
+export { splitText, textToColumns, guessDelimiter, findDuplicates, removeDuplicates, type SplitOptions, type DuplicateOptions, type DuplicateReport, } from './sheet/transforms.js';
+export { insertRows, deleteRows, insertColumns, deleteColumns, axisForSelection, setStructureTarget, getStructureTarget, rewriteFormulas, type StructureTarget, } from './sheet/structure.js';
+export { findAll, findNext, replaceOne, replaceAll, replaceInText, cellMatches, setFindTarget, getFindTarget, type FindOptions, type FindHit, type FindTarget, } from './sheet/find-replace.js';
+export { splitFrozenRows, frozenColumnIds, applyFreeze, freezeAtActiveCell, freezeTopRow, freezeFirstColumn, unfreeze, type FreezeState, type FreezeSplit, } from './sheet/freeze.js';
+export { buildClipboardPayload, parseClipboard, parseClipboardText, parseClipboardHtml, readClipboardOrigin, anchorForeignFormulas, resolvePasteCell, planPaste, msoNumberFormat, numFmtFromMso, isR1C1, r1c1ToA1, type PasteSpecialOptions, type PasteWhat, type PasteOperation, type ClipboardCell, type ClipboardGrid, type PasteResolution, } from './sheet/paste-special.js';
+export { setFindReplaceHandler, setPasteSpecialHandler, setRibbonActionHandler, nudgeFontSize, type RibbonKeyAction } from './sheet/shortcuts.js';
+export { default as SvFormulaBar } from './SvFormulaBar.svelte';
+export { default as SvSheet } from './SvSheet.svelte';
+export { default as SvSheetRibbon } from './SvSheetRibbon.svelte';
+export { default as SvSheetFindReplace } from './SvSheetFindReplace.svelte';
+export { default as SvSheetPasteSpecial } from './SvSheetPasteSpecial.svelte';
+export { default as SvSheetFormatCells } from './SvSheetFormatCells.svelte';
+export { default as SvSheetInsertFunction } from './SvSheetInsertFunction.svelte';
+export { default as SvSheetSizeDialog } from './SvSheetSizeDialog.svelte';
+export { default as SvSheetComment } from './SvSheetComment.svelte';
+export { default as SvSheetDataValidation } from './SvSheetDataValidation.svelte';
+export { default as SvSheetValidationAlert } from './SvSheetValidationAlert.svelte';
+export { default as SvSheetListPicker } from './SvSheetListPicker.svelte';
+export { default as SvSheetConditionalFormat } from './SvSheetConditionalFormat.svelte';
+export { default as SvSheetManageRules } from './SvSheetManageRules.svelte';
+export { default as SvSheetFilterMenu } from './SvSheetFilterMenu.svelte';
+export { default as SvSheetNameManager } from './SvSheetNameManager.svelte';
+export { default as SvSheetGoalSeek } from './SvSheetGoalSeek.svelte';
+export { default as SvSheetTextToColumns } from './SvSheetTextToColumns.svelte';
+export { default as SvSheetRemoveDuplicates } from './SvSheetRemoveDuplicates.svelte';
+export { functionCatalog, FUNCTION_GROUPS, type FunctionInfo, type FunctionGroup } from './sheet/function-catalog.js';
+export { parseEntry, completeEntry, type ParsedEntry } from './sheet/entry.js';
+export { cycleReference, type TextEdit } from './sheet/edit-keys.js';
+export { RIBBON_TABS, ribbonItems, withDecimals, applyBorders, type RibbonTab, type RibbonGroup, type RibbonItem, type RibbonOption, type RibbonItemKind, type RibbonActionId, type BorderPreset, } from './sheet/ribbon.js';
+export { RIBBON_ICONS, RIBBON_ICON_NAMES, type RibbonIconName, type IconPath } from './sheet/ribbon-icons.js';
+export { THEME_COLOURS, STANDARD_COLOURS, ALL_COLOURS, tint, type PaletteColour } from './sheet/palette.js';
+export { default as SvRibbonIcon } from './SvRibbonIcon.svelte';
+export { move, selectRegion, selectLine, applyFormat, toggleFormat, preset, autoSum, structural, switchSheet, gridOf, } from './sheet/shortcuts.js';
+export { compileNumberFormat, formatWithPattern, FORMAT_PRESETS, type CompiledFormat, type FormatPresetName, } from './sheet/number-format.js';
+export { createFormatStore, entryToStyle, borderShadows, type SheetFormatStore, type CellFormatEntry, type CellAddressLookup, } from './sheet/format-store.js';
+export { createNames, isValidName, type SheetNames, type DefinedName, } from './sheet/names.js';
+export { suggestFunctions, applySuggestion, signatureAt, partialAt, SIGNATURES, type FunctionSuggestion, } from './sheet/autocomplete.js';
+export { setFormatTarget, getFormatTarget, setFormatDialogHandler, type SheetFormatTarget, } from './sheet/shortcuts.js';
+export { parseFormula, parse as parseFormulaTokens } from './sheet/parse.js';
+export { tokenize as tokenizeFormula, type Token as FormulaToken } from './sheet/tokenize.js';
+export { evaluate as evaluateFormula, formatValue as formatCellValue, type EvalContext as SheetEvalContext, } from './sheet/evaluate.js';
+export { FUNCTIONS as SHEET_FUNCTIONS, withCustomFunctions, type SheetFunction, type FnArgs as SheetFnArgs, } from './sheet/functions.js';
+export { translateFormula, fixupReferences, renameSheetReferences, formatFormula, referenceSpans, REFERENCE_COLOURS, type StructuralEdit, type EditScope, type ReferenceSpan, } from './sheet/refs.js';
+export { createDependencyGraph as createSheetDependencyGraph, precedentsOf, cellKey, parseCellKey, type DependencyGraph as SheetDependencyGraph, type CellKey, } from './sheet/deps.js';
+export { parseA1, formatA1, colToLetters, lettersToCol, type CellRef, } from './sheet/address.js';
+export { isError as isFormulaError, type CellValue as SheetCellValue, type SheetError, type Node as FormulaNode, } from './sheet/ast.js';
+export { SHEET_BINDINGS, handleSheetKey, type SheetBinding, type SheetCommand, } from './sheet/shortcuts.js';
+export { edgeOfRegion, currentRegion, isBlankValue, type Direction as SheetDirection, } from './sheet/navigate.js';
+export { fillDown, fillRight, fillSelection, stampDate, stampNow, copyFromAbove, copyValueFromAbove, guessSumRange, looksNumeric, setFillTranslator, type FillTranslator, } from './sheet/commands.js';
 export { enableAdvancedFilter } from './advanced-filter-enable.js';
 export { default as SvAdvancedFilter } from './SvAdvancedFilter.svelte';
 export { exprColumnsFromGrid, type ExprColumnsOptions, } from './advanced-filter/expr-columns-from-grid.js';

package/dist/index.js

@@ -5,7 +5,7 @@ isLicenseExpired, getLicenseExpiry, } from './license.js';
 export { parseLicenseExpiry } from './license-core.js';
 export { exportGrid, copyExportToClipboard, } from './export.js';
 export { default as SvExportMenu } from './SvExportMenu.svelte';
-export { buildPdfDocDefinition } from './export-pdf.js';
+export { buildPdfDocDefinition, resolvePdfCharts, resolvePdfVfs, registerPdfFonts } from './export-pdf.js';
 export { printGrid } from './print.js';
 export { importData, readImportMatrix, mapImportMatrix, mapImportMatrixAsync, autoMapColumns, inferImportColumnTypes, } from './import.js';
 export { default as SvImportDialog } from './SvImportDialog.svelte';
@@ -28,6 +28,73 @@ export { default as SvGridBulkEditDrawer } from './SvGridBulkEditDrawer.svelte';
 // In-grid pivot mode (Pro). `enablePivot()` registers the pivot engine so
 // `<SvGrid pivot={...}>` renders a pivot table in place of the flat table.
 export { enablePivot } from './pivot-enable.js';
+export { enableSheet } from './sheet-enable.js';
+export { createTableRegistry, isValidTableName, resolveTableRange, columnIndexOf, rowCountOf, } from './sheet/tables.js';
+export { goalSeek, goalSeekCell, } from './sheet/goal-seek.js';
+export { default as SvSheetTabs } from './SvSheetTabs.svelte';
+export { createWorkbook, isValidSheetName, } from './sheet/workbook.js';
+export { setWorkbook, getWorkbook } from './sheet/shortcuts.js';
+export { createSheetDocument, } from './sheet/document.js';
+export { shiftRect, shiftRects, subtractRect, rectContains, rectsIntersect, remapNotes, lineShift } from './sheet/rects.js';
+export { isLocked, rectsHaveLocked, rectsMixLocked, PROTECTED_MESSAGE } from './sheet/protection.js';
+export { commentAt, withComment, listComments, nextComment } from './sheet/comments.js';
+export { ruleAt, rulesIn, checkEntry, listChoices, shiftValidation, removeValidation, describeRule, dateValue, validationId, DEFAULT_ALERT_MESSAGE, OPERATOR_LABELS, } from './sheet/validation.js';
+export { ruleStats, evaluateCf, shiftCf, removeCf, cfIn, describeCf, scaleColor, iconIndex, hasStyle, cfId, CF_PRESET_STYLES, COLOR_SCALES, DATA_BAR_COLOR, } from './sheet/conditional-formats.js';
+export { mergePlan, unmergePlan, mergeDropsValues, mergesIn, mergeAt as sheetMergeAt, isCoveredCell, selectionMerged, toGridMerges, sortBlockedByMerges, reorderMerges, normalRect, } from './sheet/merges.js';
+export { distinctValues, hiddenRowsFor, passesFilter, isFiltering, withColumnFilter, valuesFilter, shiftAutoFilter, describeFilter, } from './sheet/auto-filter.js';
+export { splitText, textToColumns, guessDelimiter, findDuplicates, removeDuplicates, } from './sheet/transforms.js';
+export { insertRows, deleteRows, insertColumns, deleteColumns, axisForSelection, setStructureTarget, getStructureTarget, rewriteFormulas, } from './sheet/structure.js';
+export { findAll, findNext, replaceOne, replaceAll, replaceInText, cellMatches, setFindTarget, getFindTarget, } from './sheet/find-replace.js';
+export { splitFrozenRows, frozenColumnIds, applyFreeze, freezeAtActiveCell, freezeTopRow, freezeFirstColumn, unfreeze, } from './sheet/freeze.js';
+export { buildClipboardPayload, parseClipboard, parseClipboardText, parseClipboardHtml, readClipboardOrigin, anchorForeignFormulas, resolvePasteCell, planPaste, msoNumberFormat, numFmtFromMso, isR1C1, r1c1ToA1, } from './sheet/paste-special.js';
+export { setFindReplaceHandler, setPasteSpecialHandler, setRibbonActionHandler, nudgeFontSize } from './sheet/shortcuts.js';
+export { default as SvFormulaBar } from './SvFormulaBar.svelte';
+export { default as SvSheet } from './SvSheet.svelte';
+export { default as SvSheetRibbon } from './SvSheetRibbon.svelte';
+export { default as SvSheetFindReplace } from './SvSheetFindReplace.svelte';
+export { default as SvSheetPasteSpecial } from './SvSheetPasteSpecial.svelte';
+export { default as SvSheetFormatCells } from './SvSheetFormatCells.svelte';
+export { default as SvSheetInsertFunction } from './SvSheetInsertFunction.svelte';
+export { default as SvSheetSizeDialog } from './SvSheetSizeDialog.svelte';
+export { default as SvSheetComment } from './SvSheetComment.svelte';
+export { default as SvSheetDataValidation } from './SvSheetDataValidation.svelte';
+export { default as SvSheetValidationAlert } from './SvSheetValidationAlert.svelte';
+export { default as SvSheetListPicker } from './SvSheetListPicker.svelte';
+export { default as SvSheetConditionalFormat } from './SvSheetConditionalFormat.svelte';
+export { default as SvSheetManageRules } from './SvSheetManageRules.svelte';
+export { default as SvSheetFilterMenu } from './SvSheetFilterMenu.svelte';
+export { default as SvSheetNameManager } from './SvSheetNameManager.svelte';
+export { default as SvSheetGoalSeek } from './SvSheetGoalSeek.svelte';
+export { default as SvSheetTextToColumns } from './SvSheetTextToColumns.svelte';
+export { default as SvSheetRemoveDuplicates } from './SvSheetRemoveDuplicates.svelte';
+export { functionCatalog, FUNCTION_GROUPS } from './sheet/function-catalog.js';
+export { parseEntry, completeEntry } from './sheet/entry.js';
+export { cycleReference } from './sheet/edit-keys.js';
+export { RIBBON_TABS, ribbonItems, withDecimals, applyBorders, } from './sheet/ribbon.js';
+export { RIBBON_ICONS, RIBBON_ICON_NAMES } from './sheet/ribbon-icons.js';
+export { THEME_COLOURS, STANDARD_COLOURS, ALL_COLOURS, tint } from './sheet/palette.js';
+export { default as SvRibbonIcon } from './SvRibbonIcon.svelte';
+export { move, selectRegion, selectLine, applyFormat, toggleFormat, preset, autoSum, structural, switchSheet, gridOf, } from './sheet/shortcuts.js';
+export { compileNumberFormat, formatWithPattern, FORMAT_PRESETS, } from './sheet/number-format.js';
+export { createFormatStore, entryToStyle, borderShadows, } from './sheet/format-store.js';
+export { createNames, isValidName, } from './sheet/names.js';
+export { suggestFunctions, applySuggestion, signatureAt, partialAt, SIGNATURES, } from './sheet/autocomplete.js';
+export { setFormatTarget, getFormatTarget, setFormatDialogHandler, } from './sheet/shortcuts.js';
+// The formula engine. Names are Sheet-prefixed HERE because the barrel already
+// exports a `DependencyGraph` (scheduler) and an `EvalContext` (the expression
+// language), and two different things under one name in one namespace is worse
+// than a prefix. The `@svgrid/enterprise/sheet` subpath exports them unprefixed.
+export { parseFormula, parse as parseFormulaTokens } from './sheet/parse.js';
+export { tokenize as tokenizeFormula } from './sheet/tokenize.js';
+export { evaluate as evaluateFormula, formatValue as formatCellValue, } from './sheet/evaluate.js';
+export { FUNCTIONS as SHEET_FUNCTIONS, withCustomFunctions, } from './sheet/functions.js';
+export { translateFormula, fixupReferences, renameSheetReferences, formatFormula, referenceSpans, REFERENCE_COLOURS, } from './sheet/refs.js';
+export { createDependencyGraph as createSheetDependencyGraph, precedentsOf, cellKey, parseCellKey, } from './sheet/deps.js';
+export { parseA1, formatA1, colToLetters, lettersToCol, } from './sheet/address.js';
+export { isError as isFormulaError, } from './sheet/ast.js';
+export { SHEET_BINDINGS, handleSheetKey, } from './sheet/shortcuts.js';
+export { edgeOfRegion, currentRegion, isBlankValue, } from './sheet/navigate.js';
+export { fillDown, fillRight, fillSelection, stampDate, stampNow, copyFromAbove, copyValueFromAbove, guessSumRange, looksNumeric, setFillTranslator, } from './sheet/commands.js';
 export { enableAdvancedFilter } from './advanced-filter-enable.js';
 export { default as SvAdvancedFilter } from './SvAdvancedFilter.svelte';
 export { exprColumnsFromGrid, } from './advanced-filter/expr-columns-from-grid.js';

package/dist/install.js

@@ -12,6 +12,7 @@ import { enableBoardView } from './board.js';
 import { enableSelectionBar } from './selection-bar.js';
 import { enableAdvancedFilter } from './advanced-filter-enable.js';
 import { enablePivot } from './pivot-enable.js';
+import { enableSheet } from './sheet-enable.js';
 /**
  * Augment a SvGridApi instance with Pro methods (`exportData`, `print`,
  * `ai.*`). Mutates and returns the same object so existing references
@@ -49,6 +50,10 @@ export function installEnterprise(api) {
     registerExportProvider(exportGrid);
     enablePivot();
     enableAdvancedFilter();
+    // Register the Excel keymap (Ctrl+Arrow, Ctrl+D, Ctrl+A and the rest). The
+    // grid interprets a key itself only when nothing claims it, so a free grid
+    // is unaffected.
+    enableSheet();
     pro.pivot = {
         build: (config) => createPivotModel(pro.getData(), config),
         buildFrom: (data, config) => 

package/dist/node/studio.js

@@ -8949,11 +8949,34 @@ var GENERATED_UI_SURFACE = {
 				"description": "Prepend a header row (the column labels) to copied cell ranges, so pasting into Excel / Sheets includes the headers. Applies per copied range.",
 				"group": "common"
 			},
+			{
+				"key": "processCellForFill",
+				"label": "Process Cell For Fill",
+				"type": "json",
+				"description": "Decide what the fill handle writes into one cell, ahead of the grid's own pattern rules (series, weekdays, \"Item 1\"). Receives the source cell's value and how far the target sits from it; return the value to write, or `undefined` to let the pattern decide. A spreadsheet uses it to move a formula's references by the distance filled, which the pattern rules would otherwise mangle (\"=A1+B1\" reads as \"Item 1\").",
+				"code": true,
+				"group": "advanced"
+			},
 			{
 				"key": "processCellForClipboard",
 				"label": "Process Cell For Clipboard",
 				"type": "json",
-				"description": "Transform each cell value on its way to the clipboard - e.g. strip currency symbols, expand codes to labels, or redact. Receives the display value plus the row/column context; return the string (or value) to copy.",
+				"code": true,
+				"group": "advanced"
+			},
+			{
+				"key": "clipboardHtml",
+				"label": "Clipboard Html",
+				"type": "json",
+				"description": "An HTML rendering of what Ctrl+C copies, written to the clipboard as `text/html` beside the TSV. Excel and Google Sheets read the HTML first, so a table with inline styles pastes into them with its formats, and the same markup can carry what the text cannot (a formula in a `data-` attribute) for a round trip back into a grid that reads it. Called after every cell has been through `processCellForClipboard`, with the rectangles copied and the text about to be written. Return nothing to write text alone. Runs synchronously inside the key press, which is what the clipboard needs.",
+				"code": true,
+				"group": "advanced"
+			},
+			{
+				"key": "processCellFromClipboard",
+				"label": "Process Cell From Clipboard",
+				"type": "json",
+				"description": "Transform each cell on its way IN from the clipboard, before the grid coerces it for the column's editor. Symmetric with `processCellForClipboard`: the pair is what lets a round trip survive. Receives the raw clipboard text for the cell plus where it is landing. Return the value to write, or `undefined` to leave the cell untouched. This is also the seam a feature pack uses to take over a paste entirely: `@svgrid/enterprise`'s paste-special reads the clipboard's `text/html` for formats and formulas and writes through here.",
 				"code": true,
 				"group": "advanced"
 			},
@@ -8964,6 +8987,13 @@ var GENERATED_UI_SURFACE = {
 				"description": "Inline cell editing: F2 or double-click opens an editor in the active cell, Enter commits, Esc cancels. Off by default. A column still needs an `editorType` to pick its editor (text, number, date, checkbox, list, ...); without one it gets a plain text editor. `editable` is the shortcut alias and wins over this.",
 				"group": "common"
 			},
+			{
+				"key": "editOnSecondClick",
+				"label": "Edit On Second Click",
+				"type": "boolean",
+				"description": "A click on the cell that is already active opens its editor, the way a second click on a selected file name starts renaming it. On by default. A spreadsheet turns it off: Excel edits on double-click or F2 only, and a user clicking the cell they are on to get back to it after a dialog would otherwise find the next shortcut typed into an editor.",
+				"group": "common"
+			},
 			{
 				"key": "fullRowEditing",
 				"label": "Full Row Editing",
@@ -9169,6 +9199,20 @@ var GENERATED_UI_SURFACE = {
 				"description": "Rows to pin to the TOP of the grid - rendered above the regular rows and sticky-positioned so they stay visible while the user scrolls. Typical use: a \"totals\" or \"headline\" row that should always be in view. Rows are read-only (no inline editing, no row-selection checkbox). They share the column schema with the main grid; field/format/cell/cellClass all apply.",
 				"group": "common"
 			},
+			{
+				"key": "frozenRows",
+				"label": "Frozen Rows",
+				"type": "number",
+				"description": "Freeze the first N rows: they stay under the header while the body scrolls, and unlike `pinnedTopRows` they are the grid's own rows, still editable, selectable and numbered as rows 1..N. Excel's Freeze Panes, for the row half; the column half is `columnPinning`. Under `virtualization` the frozen rows are always rendered and the window skips them.",
+				"group": "common"
+			},
+			{
+				"key": "mergedCells",
+				"label": "Merged Cells",
+				"type": "json",
+				"description": "Merged cells: rectangles drawn as one cell, a spreadsheet's Merge & Center. Each entry is the top-left cell (display indices) and how many rows and columns it covers. The origin's td takes the span and shows the origin's value; the covered cells are not drawn, a selection grows to whole merges, the active cell inside a merge is its origin, and the arrow keys step over a merge as one cell. A merge that crosses the frozen boundary or the rendered window is drawn in parts, one per band. The grid does not write into covered cells on its own; a consumer that merges cells keeps them empty or marks them read-only through the column's `editable`.",
+				"group": "common"
+			},
 			{
 				"key": "pinnedBottomRows",
 				"label": "Pinned Bottom Rows",
@@ -9245,6 +9289,24 @@ var GENERATED_UI_SURFACE = {
 				"prop": "onPaginationChange",
 				"description": "Fires when the user changes page or page size while `externalPagination` is on. Fetch that page and update `data` / `rowCount` / `pageIndex`."
 			},
+			{
+				"key": "columnResize",
+				"label": "Column Resize",
+				"prop": "onColumnResize",
+				"description": "The user dragged a column's edge (or double-clicked it to autosize). Programmatic `api.setColumnWidth` does not fire it."
+			},
+			{
+				"key": "rowResize",
+				"label": "Row Resize",
+				"prop": "onRowResize",
+				"description": "The user dragged a row's edge, or double-clicked it: `height` is then `null`, the row back at its declared height. Programmatic `api.setRowHeight` does not fire it."
+			},
+			{
+				"key": "pasteClipboard",
+				"label": "Paste Clipboard",
+				"prop": "onPasteClipboard",
+				"description": "Take over a paste. Receives the clipboard's `text/plain` and, when the source put one there, its `text/html` (Excel's carries formats and formulas; a grid's own `clipboardHtml` carries whatever it chose to). Return `true` to say the paste was applied; anything else lets the grid paste the text as it always has. Runs inside one history group, so every `setCellValue` and `recordUndo` the handler makes is one Ctrl+Z. With this set, Ctrl+V lets the browser's own `paste` event through (that is where the unsanitised HTML is), and the async Clipboard API is the fallback for a browser that does not deliver it. `source` says which path the payload came by."
+			},
 			{
 				"key": "apiReady",
 				"label": "Api Ready",
@@ -15851,7 +15913,7 @@ function hasFieldConditions(schema) {
 *
 * `version.test.ts` asserts this matches `package.json`, so the two cannot drift.
 */
-var SVGRID_VERSION = "3.0.0";
+var SVGRID_VERSION = "3.0.2";
 //#endregion
 //#region src/studio/emit-project.ts
 var has = (blocks, kind) => blocks.some((b) => b.config.kind === kind);

package/dist/pivot-chart.d.ts

@@ -13,16 +13,40 @@
  *     measure). The grand-total column is excluded unless `includeTotals`.
  *   - values     = each leaf row's aggregated cell for that series column.
  */
-import type { ChartSpec, ChartType, TableFeatures } from '@svgrid/grid';
+import { type CellFormatConfig, type ChartSpec, type ChartType, type TableFeatures } from '@svgrid/grid';
 import type { PivotResult } from './pivot.js';
+/** Options for {@link pivotToChartSpec}: the chart type and stacking, whether totals chart, a category cap, the measure's format and the value-axis name. */
 export type PivotChartOptions = {
     /** Chart type. Default `'bar'`. */
     type?: ChartType;
     /** Stack the series. Default false. */
     stacked?: boolean;
+    /** Stack to 100%. Implies `stacked`. Default false. */
+    stacked100?: boolean;
     /** Include the grand-total column / row as a series / category. Default false. */
     includeTotals?: boolean;
     /** Cap the number of categories (row leaves) charted. */
     maxCategories?: number;
+    /**
+     * The measure's cell format, carried to the chart as `valueFormat` (with
+     * `currency` and `locale`), so a cell the table shows as "$469,662" charts
+     * as "$470k" on the axis and "$469,662" in the tooltip rather than "470k".
+     * The designer passes the first value chip's format; with several
+     * measures in different formats, pass none and the chart formats plainly.
+     */
+    format?: CellFormatConfig;
+    /**
+     * Name the value axis. Default: the measure's label when the layout has
+     * one measure, nothing otherwise.
+     */
+    yAxisTitle?: string | null;
 };
+/**
+ * A computed pivot as a `ChartSpec` for the free chart: row leaves become
+ * categories (nested rows a grouped axis), column leaves the series, totals
+ * left out unless asked for, the measure's format carried over and an empty
+ * cell read as a gap. The designer's Chart view is this function, and the
+ * grid's own Chart panel runs the same mapping (`pivotResultToChartSpec` in
+ * `@svgrid/grid`) in pivot mode.
+ */
 export declare function pivotToChartSpec<TFeatures extends TableFeatures>(result: PivotResult<TFeatures>, opts?: PivotChartOptions): ChartSpec;

package/dist/pivot-chart.js

@@ -1,71 +1,27 @@
+/**
+ * Pivot -> chart bridge.
+ *
+ * Turns a computed {@link PivotResult} (the row/column/value matrix the pivot
+ * engine produces) into a core {@link ChartSpec} the free `SvGridChart` can
+ * render - so one pivot layout drives both a table and a chart (the Excel
+ * PivotTable <-> PivotChart pairing).
+ *
+ * Mapping:
+ *   - categories = the row-axis LEAF rows (deepest grouping; subtotals and the
+ *     grand-total row are skipped). With no row dims, the single total row.
+ *   - series     = the column-axis leaf value columns (one per col-path x
+ *     measure). The grand-total column is excluded unless `includeTotals`.
+ *   - values     = each leaf row's aggregated cell for that series column.
+ */
+import { pivotResultToChartSpec } from '@svgrid/grid';
+/**
+ * A computed pivot as a `ChartSpec` for the free chart: row leaves become
+ * categories (nested rows a grouped axis), column leaves the series, totals
+ * left out unless asked for, the measure's format carried over and an empty
+ * cell read as a gap. The designer's Chart view is this function, and the
+ * grid's own Chart panel runs the same mapping (`pivotResultToChartSpec` in
+ * `@svgrid/grid`) in pivot mode.
+ */
 export function pivotToChartSpec(result, opts = {}) {
-    const type = opts.type ?? 'bar';
-    // Category rows: the row-axis leaves. Fall back to the grand-total (single
-    // "All") row when no row dims are configured, then to every row.
-    let catRows = result.rows.filter((r) => r.__pivotKind === 'leaf');
-    if (!catRows.length)
-        catRows = result.rows.filter((r) => r.__pivotKind === 'grandTotal');
-    if (!catRows.length)
-        catRows = result.rows.slice();
-    if (opts.maxCategories && catRows.length > opts.maxCategories) {
-        catRows = catRows.slice(0, opts.maxCategories);
-    }
-    // Categories are the leaf's OWN label; when rows are nested, emit a parent
-    // tier (categoryGroups) so the axis reads "Americas | Canada · USA ..." as a
-    // grouped axis rather than colliding on a bare repeated leaf label.
-    const byId = new Map(result.rows.map((r) => [r.__pivotId, r]));
-    const ownLabel = (r) => String(r.__pivotLabel ?? '').trim() || '(blank)';
-    const categories = catRows.map(ownLabel);
-    const parentOf = (r) => r.__pivotParentId ? byId.get(r.__pivotParentId) : undefined;
-    const nested = catRows.length > 0 && catRows.every((r) => parentOf(r) !== undefined);
-    let categoryGroups;
-    if (nested) {
-        categoryGroups = [];
-        let prevId;
-        for (const r of catRows) {
-            const pid = r.__pivotParentId;
-            const last = categoryGroups[categoryGroups.length - 1];
-            if (last && pid === prevId)
-                last.span += 1;
-            else {
-                categoryGroups.push({ label: ownLabel(parentOf(r)), span: 1 });
-                prevId = pid;
-            }
-        }
-    }
-    const leaves = [];
-    const walk = (cols, path) => {
-        for (const c of cols ?? []) {
-            if (!c || c.id === '__pivotRowHeader')
-                continue;
-            // Skip the grand-total column group (and its leaves) unless asked for.
-            if (!opts.includeTotals && typeof c.id === 'string' && c.id.startsWith('pv_group__grand'))
-                continue;
-            if (Array.isArray(c.columns))
-                walk(c.columns, [...path, String(c.header ?? '')]);
-            else if (typeof c.id === 'string')
-                leaves.push({ id: c.id, path, header: String(c.header ?? '') });
-        }
-    };
-    walk(result.columns, []);
-    const filtered = opts.includeTotals ? leaves : leaves.filter((l) => !l.id.includes('__total'));
-    const uniqueHeaders = new Set(filtered.map((l) => l.header));
-    const series = filtered.map((l) => ({
-        label: l.path.length === 0
-            ? l.header
-            : uniqueHeaders.size > 1
-                ? [...l.path, l.header].join(' · ')
-                : l.path.join(' · '),
-        values: catRows.map((r) => {
-            const v = r[l.id];
-            return typeof v === 'number' ? v : Number(v) || 0;
-        }),
-    }));
-    return {
-        type,
-        categories,
-        series,
-        ...(categoryGroups && categoryGroups.length > 1 ? { categoryGroups } : {}),
-        ...(opts.stacked ? { stacked: true } : {}),
-    };
+    return pivotResultToChartSpec(result, opts);
 }

package/dist/sheet/address.d.ts

@@ -0,0 +1,43 @@
+/**
+ * A1 addressing, with absolute and relative parts kept apart.
+ *
+ * Every demo copy of this engine does `part.replace(/\$/g, '')` and then treats
+ * what is left as relative, so `$A$1` parses and evaluates as `A1`. Nothing
+ * notices while nothing translates a formula. The moment fill-down, copy/paste
+ * or insert-row exists, `=$A$1*B2` copied down starts reading the wrong cell
+ * and quietly returns a plausible wrong number, which is the worst failure mode
+ * a spreadsheet has.
+ *
+ * So `$` is structure here, not noise: `parseA1` reports which halves were
+ * pinned, and `refs.ts` is the only module allowed to move the unpinned ones.
+ *
+ * Rows and columns are 0-based internally (`A1` is `{ row: 0, col: 0 }`) and
+ * 1-based on the wire, which is the same convention the grid's selection model
+ * uses so nothing has to convert at the boundary.
+ */
+/** A parsed cell reference. `row: null` means a whole-column ref (`A:A`). */
+export type CellRef = {
+    col: number;
+    colAbs: boolean;
+    /** null for a column-only reference. */
+    row: number | null;
+    rowAbs: boolean;
+    /** null means "the sheet the formula lives on". */
+    sheet: string | null;
+};
+/** 0-based column index to letters: 0 -> A, 25 -> Z, 26 -> AA. */
+export declare function colToLetters(col: number): string;
+/** Letters to a 0-based column index. Returns -1 for anything unparseable. */
+export declare function lettersToCol(letters: string): number;
+/**
+ * Parse one reference part: `A1`, `$A$1`, `A$1`, `$A1`, or a bare column `A`.
+ * Returns null when the text is not a reference at all, which is how the
+ * tokenizer tells a reference from a bare name.
+ */
+export declare function parseA1(text: string, sheet?: string | null): CellRef | null;
+/** Render a reference back to A1, `$` included, sheet prefix and all. */
+export declare function formatA1(ref: CellRef): string;
+/** A sheet name needs quoting unless it is a bare word. */
+export declare function quoteSheet(name: string): string;
+/** True when the reference points outside a sheet of this size. */
+export declare function isOutOfBounds(ref: CellRef, rowCount: number, colCount: number): boolean;

package/dist/sheet/address.js

@@ -0,0 +1,81 @@
+/**
+ * A1 addressing, with absolute and relative parts kept apart.
+ *
+ * Every demo copy of this engine does `part.replace(/\$/g, '')` and then treats
+ * what is left as relative, so `$A$1` parses and evaluates as `A1`. Nothing
+ * notices while nothing translates a formula. The moment fill-down, copy/paste
+ * or insert-row exists, `=$A$1*B2` copied down starts reading the wrong cell
+ * and quietly returns a plausible wrong number, which is the worst failure mode
+ * a spreadsheet has.
+ *
+ * So `$` is structure here, not noise: `parseA1` reports which halves were
+ * pinned, and `refs.ts` is the only module allowed to move the unpinned ones.
+ *
+ * Rows and columns are 0-based internally (`A1` is `{ row: 0, col: 0 }`) and
+ * 1-based on the wire, which is the same convention the grid's selection model
+ * uses so nothing has to convert at the boundary.
+ */
+/** 0-based column index to letters: 0 -> A, 25 -> Z, 26 -> AA. */
+export function colToLetters(col) {
+    if (!Number.isInteger(col) || col < 0)
+        return '';
+    let n = col;
+    let out = '';
+    while (n >= 0) {
+        out = String.fromCharCode(65 + (n % 26)) + out;
+        n = Math.floor(n / 26) - 1;
+    }
+    return out;
+}
+/** Letters to a 0-based column index. Returns -1 for anything unparseable. */
+export function lettersToCol(letters) {
+    if (!letters || !/^[A-Za-z]+$/.test(letters))
+        return -1;
+    let col = 0;
+    for (const ch of letters.toUpperCase())
+        col = col * 26 + (ch.charCodeAt(0) - 64);
+    return col - 1;
+}
+const REF_RE = /^(\$?)([A-Za-z]+)(?:(\$?)(\d+))?$/;
+/**
+ * Parse one reference part: `A1`, `$A$1`, `A$1`, `$A1`, or a bare column `A`.
+ * Returns null when the text is not a reference at all, which is how the
+ * tokenizer tells a reference from a bare name.
+ */
+export function parseA1(text, sheet = null) {
+    const m = REF_RE.exec(text);
+    if (!m)
+        return null;
+    const col = lettersToCol(m[2]);
+    if (col < 0)
+        return null;
+    const rowText = m[4];
+    if (rowText === undefined) {
+        return { col, colAbs: m[1] === '$', row: null, rowAbs: false, sheet };
+    }
+    const row = Number(rowText) - 1;
+    // Row 0 does not exist in A1 notation; `A0` is a name, not a reference.
+    if (!Number.isInteger(row) || row < 0)
+        return null;
+    return { col, colAbs: m[1] === '$', row, rowAbs: m[3] === '$', sheet };
+}
+/** Render a reference back to A1, `$` included, sheet prefix and all. */
+export function formatA1(ref) {
+    const col = `${ref.colAbs ? '$' : ''}${colToLetters(ref.col)}`;
+    const cell = ref.row === null ? col : `${col}${ref.rowAbs ? '$' : ''}${ref.row + 1}`;
+    if (ref.sheet === null)
+        return cell;
+    return `${quoteSheet(ref.sheet)}!${cell}`;
+}
+/** A sheet name needs quoting unless it is a bare word. */
+export function quoteSheet(name) {
+    return /^[A-Za-z_][A-Za-z0-9_.]*$/.test(name) ? name : `'${name.replace(/'/g, "''")}'`;
+}
+/** True when the reference points outside a sheet of this size. */
+export function isOutOfBounds(ref, rowCount, colCount) {
+    if (ref.col < 0 || ref.col >= colCount)
+        return true;
+    if (ref.row === null)
+        return false;
+    return ref.row < 0 || ref.row >= rowCount;
+}