@svgrid/enterprise 3.0.2 → 3.1.0

package/dist/sheet/refs.js

@@ -50,7 +50,9 @@ function render(node) {
         case 'num': return String(node.v);
         case 'str': return `"${node.v.replace(/"/g, '""')}"`;
         case 'bool': return node.v ? 'TRUE' : 'FALSE';
+        case 'err': return node.v;
         case 'ref': return node.ref.col < 0 || (node.ref.row ?? 0) < 0 ? '#REF!' : formatA1(node.ref);
+        case 'spill': return node.ref.col < 0 || (node.ref.row ?? 0) < 0 ? '#REF!' : `${formatA1(node.ref)}#`;
         case 'range': {
             if (isBroken(node.from) || isBroken(node.to))
                 return '#REF!';
@@ -66,6 +68,16 @@ function render(node) {
             const to = formatA1({ ...node.to, sheet: null });
             return `${from}:${to}`;
         }
+        case 'ref3d': {
+            if (isBroken(node.from) || isBroken(node.to))
+                return '#REF!';
+            const q = (s) => (/^[A-Za-z_][A-Za-z0-9_.]*$/.test(s) ? s : `'${s.replace(/'/g, "''")}'`);
+            const cell = formatA1({ ...node.from, sheet: null });
+            const to = node.from.row === node.to.row && node.from.col === node.to.col
+                ? ''
+                : `:${formatA1({ ...node.to, sheet: null })}`;
+            return `${q(node.sheetFrom)}:${q(node.sheetTo)}!${cell}${to}`;
+        }
         case 'name': return node.name;
         case 'table': {
             // Re-serialised, never translated: the whole point of a structured
@@ -90,16 +102,20 @@ function render(node) {
             // from precedence. Emitting the operands bare turns =(A1+B1)*2 into
             // =A2+B2*2, which is a silent wrong answer on every fill and paste.
             //
-            // Which SIDE needs one at equal precedence depends on associativity.
-            // Left-associative: the right operand does, because a-(b-c) is not
-            // a-b-c. Right-associative `^` is the mirror: the LEFT operand does,
-            // because (a^b)^c is not a^b^c.
-            const rightAssociative = node.op === '^';
-            const leftMin = rightAssociative ? prec + 1 : prec;
-            const rightMin = rightAssociative ? prec : prec + 1;
+            // Which SIDE needs one at equal precedence depends on associativity,
+            // and every operator here binds left, `^` included: the RIGHT operand
+            // is the one that needs the bracket, because a-(b-c) is not a-b-c and
+            // a^(b^c) is not a^b^c.
+            const leftMin = prec;
+            const rightMin = prec + 1;
             return `${wrap(node.left, leftMin)}${node.op}${wrap(node.right, rightMin)}`;
         }
-        case 'fn': return `${node.name}(${node.args.map(render).join(',')})`;
+        // `(` is the call node an immediate or curried lambda builds:
+        // LAMBDA(x, x*2)(21) is the callee, then its arguments.
+        case 'fn': return node.name === '('
+            ? `${render(node.args[0])}(${node.args.slice(1).map(render).join(',')})`
+            : `${node.name}(${node.args.map(render).join(',')})`;
+        case 'empty': return '';
     }
 }
 /**
@@ -125,13 +141,125 @@ export function translateFormula(text, dRow, dCol) {
     const moved = mapNode(ast, (n) => {
         if (n.k === 'ref')
             return { ...n, ref: translateRef(n.ref, dRow, dCol) };
+        if (n.k === 'spill')
+            return { ...n, ref: translateRef(n.ref, dRow, dCol) };
         if (n.k === 'range') {
             return { ...n, from: translateRef(n.from, dRow, dCol), to: translateRef(n.to, dRow, dCol) };
         }
+        if (n.k === 'ref3d') {
+            return { ...n, from: translateRef(n.from, dRow, dCol), to: translateRef(n.to, dRow, dCol) };
+        }
         return n;
     });
     return formatFormula(moved);
 }
+/**
+ * A formula for a cell that a transposed paste moves from `source` to
+ * `dest`, its relative references turned with it.
+ *
+ * Excel rotates a relative offset on a transpose: a reference `dr` rows
+ * and `dc` columns away becomes `dc` rows and `dr` columns away. A cell
+ * inside the block moved the same way, so a formula that read the price
+ * beside it still reads that price, now above it, which is what makes a
+ * transposed totals column still total. A reference outside the block is
+ * turned too, as Excel turns it. Absolute parts stay where they point.
+ * A column-only reference has no row to turn and is left as it is.
+ */
+export function transposeFormula(text, source, dest) {
+    if (typeof text !== 'string' || !text.startsWith('='))
+        return text;
+    let ast;
+    try {
+        ast = parseFormula(text);
+    }
+    catch {
+        return text;
+    }
+    const turn = (ref) => {
+        if (ref.row === null)
+            return ref;
+        return {
+            ...ref,
+            row: ref.rowAbs ? ref.row : dest.row + (ref.col - source.col),
+            col: ref.colAbs ? ref.col : dest.col + (ref.row - source.row),
+        };
+    };
+    const moved = mapNode(ast, (n) => {
+        if (n.k === 'ref')
+            return { ...n, ref: turn(n.ref) };
+        if (n.k === 'spill')
+            return { ...n, ref: turn(n.ref) };
+        if (n.k === 'range') {
+            // A turned range may come out with its corners swapped; a range is
+            // spelled top-left to bottom-right, so put them back in order.
+            const a = turn(n.from);
+            const b = turn(n.to);
+            const from = { ...a, row: a.row === null || b.row === null ? a.row : Math.min(a.row, b.row), col: Math.min(a.col, b.col), rowAbs: a.rowAbs, colAbs: a.colAbs };
+            const to = { ...b, row: a.row === null || b.row === null ? b.row : Math.max(a.row, b.row), col: Math.max(a.col, b.col), rowAbs: b.rowAbs, colAbs: b.colAbs };
+            return { ...n, from, to };
+        }
+        return n;
+    });
+    return formatFormula(moved);
+}
+const inside = (move, row, col) => row !== null && row >= move.top && row <= move.bottom && col >= move.left && col <= move.right;
+/**
+ * Point every reference to a moved cell at where the cell now is.
+ *
+ * This is what a cut and paste owes the rest of the workbook, and Excel does
+ * it: moving A1 to D1 rewrites `=A1*2` as `=D1*2` rather than leaving it
+ * reading an emptied cell. A `$` makes no difference - the cell moved, so
+ * every way of naming it moves - and a RANGE only follows when the whole of
+ * it moved, which is why `=SUM(A1:A2)` stays as it is when only A1 goes.
+ *
+ * `self` is the sheet the formula lives on, so an unqualified reference is
+ * read against the right geometry; a reference that lands on another sheet
+ * takes that sheet's name, as Excel writes it.
+ */
+export function repointReferences(text, move, self) {
+    if (typeof text !== 'string' || !text.startsWith('='))
+        return text;
+    if (move.dRow === 0 && move.dCol === 0 && move.sheet === move.toSheet)
+        return text;
+    let ast;
+    try {
+        ast = parseFormula(text);
+    }
+    catch {
+        return text;
+    }
+    const names = (sheet) => (sheet ?? self ?? '').toLowerCase() === move.sheet.toLowerCase();
+    const landed = (ref) => ({
+        ...ref,
+        row: ref.row === null ? null : ref.row + move.dRow,
+        col: ref.col + move.dCol,
+        // Unqualified only when the formula already lives on the sheet it landed on.
+        sheet: move.toSheet.toLowerCase() === (self ?? '').toLowerCase() ? null : move.toSheet,
+    });
+    const moved = mapNode(ast, (n) => {
+        if (n.k === 'ref') {
+            if (!names(n.ref.sheet) || !inside(move, n.ref.row, n.ref.col))
+                return n;
+            return { ...n, ref: landed(n.ref) };
+        }
+        if (n.k === 'spill') {
+            if (!names(n.ref.sheet) || !inside(move, n.ref.row, n.ref.col))
+                return n;
+            return { ...n, ref: landed(n.ref) };
+        }
+        if (n.k === 'range') {
+            const sheet = n.from.sheet ?? n.to.sheet;
+            if (!names(sheet))
+                return n;
+            if (!inside(move, n.from.row, n.from.col) || !inside(move, n.to.row, n.to.col))
+                return n;
+            return { ...n, from: landed(n.from), to: landed(n.to) };
+        }
+        return n;
+    });
+    const next = formatFormula(moved);
+    return next === text ? text : next;
+}
 export const REFERENCE_COLOURS = ['#1e6fd9', '#d62828', '#8e44ad', '#0f9d58', '#e67e22', '#0097a7'];
 export function referenceSpans(text, colours = REFERENCE_COLOURS) {
     const out = [];
@@ -186,11 +314,22 @@ export function renameSheetReferences(text, from, to) {
         changed = true;
         return { ...ref, sheet: to };
     };
+    const swapName = (name) => {
+        if (name.toLowerCase() !== wanted)
+            return name;
+        changed = true;
+        return to;
+    };
     const moved = mapNode(ast, (n) => {
         if (n.k === 'ref')
             return { ...n, ref: swap(n.ref) };
+        if (n.k === 'spill')
+            return { ...n, ref: swap(n.ref) };
         if (n.k === 'range')
             return { ...n, from: swap(n.from), to: swap(n.to) };
+        // A 3D reference names its sheets by string, either end of the tab range.
+        if (n.k === 'ref3d')
+            return { ...n, sheetFrom: swapName(n.sheetFrom), sheetTo: swapName(n.sheetTo) };
         return n;
     });
     return changed ? formatFormula(moved) : text;
@@ -243,6 +382,14 @@ export function fixupReferences(text, edit, scope) {
             const next = fixRef(n.ref, edit);
             return next === null ? { k: 'ref', ref: broken } : { ...n, ref: next };
         }
+        if (n.k === 'spill') {
+            // The anchor moving carries the spill with it; the anchor being
+            // deleted takes the whole array reference to #REF!.
+            if (!touched(n.ref.sheet))
+                return n;
+            const next = fixRef(n.ref, edit);
+            return next === null ? { k: 'ref', ref: broken } : { ...n, ref: next };
+        }
         if (n.k === 'range') {
             if (!touched(n.from.sheet ?? n.to.sheet))
                 return n;

package/dist/sheet/ribbon-icons.d.ts

@@ -25,7 +25,7 @@ export type IconPath = {
     /** Dashed stroke, for the "no border" sides. */
     dash?: string;
 };
-export type RibbonIconName = 'undo' | 'redo' | 'paste' | 'cut' | 'copy' | 'paste-special' | 'font-grow' | 'font-shrink' | 'borders' | 'border-none' | 'border-bottom' | 'border-top' | 'border-left' | 'border-right' | 'border-all' | 'border-outside' | 'border-thick-bottom' | 'fill-colour' | 'font-colour' | 'align-left' | 'align-center' | 'align-right' | 'wrap' | 'dec-more' | 'dec-less' | 'insert-cells' | 'delete-cells' | 'freeze' | 'unfreeze' | 'autosum' | 'fill-down' | 'fill-right' | 'clear' | 'find' | 'filter' | 'sort-asc' | 'sort-desc' | 'chart' | 'table' | 'function' | 'new-sheet' | 'name-manager' | 'show-formulas' | 'calculate' | 'goal-seek' | 'text-to-columns' | 'remove-duplicates' | 'chevron-down' | 'format-cells' | 'format-painter' | 'protect' | 'unprotect' | 'lock' | 'comment' | 'comment-delete' | 'comment-prev' | 'comment-next' | 'comments-all' | 'validation' | 'cf' | 'cf-greater' | 'cf-less' | 'cf-between' | 'cf-equal' | 'cf-text' | 'cf-duplicates' | 'cf-top' | 'cf-bottom' | 'cf-above' | 'cf-below' | 'cf-bar' | 'cf-scale' | 'cf-icons' | 'merge' | 'unmerge' | 'gridlines' | 'formula-bar' | 'headings' | 'font' | 'number' | 'clear-formats' | 'column-width' | 'row-height' | 'hide' | 'unhide';
+export type RibbonIconName = 'undo' | 'redo' | 'paste' | 'cut' | 'copy' | 'paste-special' | 'font-grow' | 'font-shrink' | 'borders' | 'border-none' | 'border-bottom' | 'border-top' | 'border-left' | 'border-right' | 'border-all' | 'border-outside' | 'border-thick-bottom' | 'fill-colour' | 'font-colour' | 'align-left' | 'align-center' | 'align-right' | 'wrap' | 'valign-top' | 'valign-center' | 'valign-bottom' | 'dec-more' | 'dec-less' | 'insert-cells' | 'delete-cells' | 'freeze' | 'unfreeze' | 'autosum' | 'fill-down' | 'fill-right' | 'clear' | 'find' | 'filter' | 'sort-asc' | 'sort-desc' | 'sort' | 'chart' | 'table' | 'function' | 'new-sheet' | 'file-new' | 'file-open' | 'file-save' | 'file-csv' | 'cf-formula' | 'trace-precedents' | 'trace-dependents' | 'remove-arrows' | 'name-manager' | 'show-formulas' | 'calculate' | 'goal-seek' | 'evaluate-formula' | 'error-checking' | 'text-to-columns' | 'remove-duplicates' | 'chevron-down' | 'format-cells' | 'format-painter' | 'protect' | 'unprotect' | 'lock' | 'edit-ranges' | 'print' | 'page-setup' | 'margins' | 'orientation' | 'paper' | 'print-area' | 'print-titles' | 'picture' | 'chart-setup' | 'sparkline-line' | 'sparkline-column' | 'sparkline-winloss' | 'pivot' | 'link' | 'unlink' | 'comment' | 'comment-delete' | 'comment-prev' | 'comment-next' | 'comments-all' | 'validation' | 'cf' | 'cf-greater' | 'cf-less' | 'cf-between' | 'cf-equal' | 'cf-text' | 'cf-duplicates' | 'cf-top' | 'cf-bottom' | 'cf-above' | 'cf-below' | 'cf-bar' | 'cf-scale' | 'cf-icons' | 'merge' | 'unmerge' | 'gridlines' | 'formula-bar' | 'headings' | 'font' | 'number' | 'clear-formats' | 'column-width' | 'row-height' | 'hide' | 'unhide' | 'group-rows' | 'group-cols' | 'ungroup-rows' | 'ungroup-cols' | 'show-detail' | 'hide-detail' | 'checkbox' | 'cell-button';
 export declare const RIBBON_ICONS: Record<RibbonIconName, ReadonlyArray<IconPath>>;
 /** The names, for tests and for anyone building their own toolbar. */
 export declare const RIBBON_ICON_NAMES: RibbonIconName[];

package/dist/sheet/ribbon-icons.js

@@ -91,6 +91,10 @@ export const RIBBON_ICONS = {
     'align-left': [{ d: 'M2.5 3.5h11M2.5 6.5h7M2.5 9.5h11M2.5 12.5h7' }],
     'align-center': [{ d: 'M2.5 3.5h11M4.5 6.5h7M2.5 9.5h11M4.5 12.5h7' }],
     'align-right': [{ d: 'M2.5 3.5h11M6.5 6.5h7M2.5 9.5h11M6.5 12.5h7' }],
+    // A rule at the anchored edge, with the text lines pushed against it.
+    'valign-top': [{ d: 'M2.5 3.5h11M5 6.5h6M5 8.5h6' }],
+    'valign-center': [{ d: 'M5 5.5h6M5 8h6M5 10.5h6' }],
+    'valign-bottom': [{ d: 'M5 7.5h6M5 9.5h6M2.5 12.5h11' }],
     wrap: [
         { d: 'M2.5 4h11M2.5 8h8a2.25 2.25 0 0 1 0 4.5H8.5M2.5 12h3' },
         { d: 'M10 10.5l-2 2 2 2' },
@@ -205,6 +209,11 @@ export const RIBBON_ICONS = {
         { d: 'M3 13.5l2-4 2 4M3.6 12.3h2.8', width: 1.2 },
         { d: 'M12 2.5v11M9.5 11l2.5 2.5 2.5-2.5' },
     ],
+    // Excel's Sort: an arrow each way beside three bars of falling length.
+    sort: [
+        { d: 'M4 2.5v11M1.5 5L4 2.5 6.5 5', width: 1.3 },
+        { d: 'M9 3.5h5.5M9 8h4M9 12.5h2.5', width: 1.3 },
+    ],
     chart: [
         { d: 'M2.5 2.5v11h11' },
         { d: 'M4.5 13.5V8h2.5v5.5M8 13.5V4.5h2.5v9M11.5 13.5V10h2v3.5' },
@@ -224,6 +233,129 @@ export const RIBBON_ICONS = {
         ...SHEET,
         { d: 'M8.2 6.5v5M5.7 9h5', width: 1.7 },
     ],
+    // Formula auditing: a dot and an arrow between two cells, and the arrow
+    // struck out.
+    'trace-precedents': [
+        { d: 'M2.5 3.5h4v4h-4zM9.5 8.5h4v4h-4z' },
+        { d: 'M4.5 7.5v3h4.5M7.5 9l1.5 1.5L7.5 12', width: 1.3 },
+    ],
+    'trace-dependents': [
+        { d: 'M2.5 3.5h4v4h-4zM9.5 8.5h4v4h-4z' },
+        { d: 'M6.5 5.5h5v2.5M10 6.5l1.5 1.5L13 6.5', width: 1.3 },
+    ],
+    'remove-arrows': [
+        { d: 'M2.5 8h9M9.5 6l2 2-2 2', width: 1.3 },
+        { d: 'M11 3l3 3M14 3l-3 3', width: 1.3 },
+    ],
+    // Evaluate Formula: an fx with a step under it. Error Checking: a cell
+    // with a warning triangle on it.
+    'evaluate-formula': [
+        { d: 'M4 8V4.5a1.5 1.5 0 0 1 3 0M2.5 6h3M8.5 3.5l4 4.5M12.5 3.5l-4 4.5', width: 1.3 },
+        { d: 'M2.5 13.5h3v-2.5h3v-2.5h3', width: 1.3 },
+    ],
+    'error-checking': [
+        { d: 'M2.5 2.5h7v5h-7z' },
+        { d: 'M7 14.5l4-7 4 7z', width: 1.2 },
+        { d: 'M11 10v2M11 13.2h.01', width: 1.3 },
+    ],
+    // A formula rule: an fx over a shaded cell.
+    'cf-formula': [
+        { d: 'M2 10.5h12v3.5H2z', fill: true },
+        { d: 'M5 8V4.5a1.5 1.5 0 0 1 3 0M3.5 6h3M9.5 3.5l3 4.5M12.5 3.5l-3 4.5', width: 1.3 },
+    ],
+    // The File tab: a blank page, an opening folder, a floppy, a page of
+    // commas.
+    'file-new': [
+        ...SHEET,
+    ],
+    'file-open': [
+        { d: 'M1.5 4.5v9h11l2-6H4l-2 6' },
+        { d: 'M1.5 4.5v-2h4l1.5 1.5h5.5v2.5' },
+    ],
+    'file-save': [
+        { d: 'M2.5 2.5h9l2 2v9h-11z' },
+        { d: 'M5 2.5v3.5h5V2.5M4.5 13.5V9h7v4.5' },
+    ],
+    'file-csv': [
+        ...SHEET,
+        { d: 'M6 8.5h1M9 8.5h1M6 11h1M9 11h1', width: 1.7 },
+    ],
+    // A framed picture with a hill and a sun in it, the way every icon set draws one.
+    picture: [
+        { d: 'M2.5 3.5h11v9h-11z' },
+        { d: 'M2.5 10.5l3.5-3.5 2.5 2.5 2-2 3 3' },
+        { d: 'M10.5 6a.9.9 0 1 0 .01 0z', fill: true },
+    ],
+    // The chart's bars with a cog beside them: its settings.
+    'chart-setup': [
+        { d: 'M2.5 13.5h7M3.5 13.5v-4M6 13.5v-7' },
+        { d: 'M11.5 5.5a2 2 0 1 0 .01 0z' },
+        { d: 'M11.5 2.5v1.2M11.5 7.3v1.2M14.5 5.5h-1.2M9.7 5.5H8.5', width: 1.2 },
+    ],
+    // A chain of two links, and the same broken in the middle.
+    link: [
+        { d: 'M6.5 9.5l3-3' },
+        { d: 'M8.5 4.5l1-1a2.5 2.5 0 0 1 3.5 3.5l-1 1' },
+        { d: 'M7.5 11.5l-1 1a2.5 2.5 0 0 1-3.5-3.5l1-1' },
+    ],
+    unlink: [
+        { d: 'M9 4l.5-.5a2.5 2.5 0 0 1 3.5 3.5l-1 1' },
+        { d: 'M7 12l-.5.5a2.5 2.5 0 0 1-3.5-3.5l1-1' },
+        { d: 'M2.5 2.5l11 11', width: 1.2 },
+    ],
+    // A PivotTable: a grid whose first row and column are the axes it is
+    // summarised by, the body blocked in.
+    pivot: [
+        { d: 'M2.5 2.5h11v11h-11z' },
+        { d: 'M2.5 6h11M6 2.5v11' },
+        { d: 'M7.5 7.5h2v2h-2zM10.5 7.5h2v2h-2zM7.5 10.5h2v2h-2zM10.5 10.5h2v2h-2z', fill: true },
+    ],
+    // The three sparklines, each drawn as what it draws: a line over a cell,
+    // a run of small columns, and the win/loss pair above and below the axis.
+    'sparkline-line': [
+        { d: 'M2.5 11.5l3-4 3 2 5-6' },
+        { d: 'M2.5 13.5h11', width: 1.2 },
+    ],
+    'sparkline-column': [
+        { d: 'M3 13.5v-4M6 13.5v-7M9 13.5v-3M12 13.5v-8' },
+    ],
+    'sparkline-winloss': [
+        { d: 'M2.5 8h11', width: 1.2 },
+        { d: 'M3.5 8V5M6.5 8v3M9.5 8V5M12.5 8v3' },
+    ],
+    // A printer: the tray, the page going in, the page coming out.
+    print: [
+        { d: 'M4.5 6V2.5h7V6' },
+        { d: 'M2.5 6h11v5h-2.5v3h-6v-3H2.5z' },
+        { d: 'M5 11h6' },
+    ],
+    // Page Layout: a page with its margins marked, and the same page in
+    // each of the other guises.
+    'page-setup': [
+        { d: 'M3.5 1.5h9v13h-9z' },
+        { d: 'M5.5 3.5h5v9h-5z', width: 1 },
+    ],
+    margins: [
+        { d: 'M3.5 1.5h9v13h-9z' },
+        { d: 'M5.5 1.5v13M10.5 1.5v13M3.5 3.5h9M3.5 12.5h9', width: 1 },
+    ],
+    orientation: [
+        { d: 'M2 4.5h7v9H2z' },
+        { d: 'M9 2.5h5v5H9z' },
+    ],
+    paper: [
+        { d: 'M3.5 1.5h9v13h-9z' },
+        { d: 'M5.5 5h5M5.5 8h5M5.5 11h3', width: 1.3 },
+    ],
+    'print-area': [
+        { d: 'M2.5 2.5h11v11h-11z' },
+        { d: 'M5 5h6v6H5z', fill: true },
+    ],
+    'print-titles': [
+        { d: 'M2.5 2.5h11v11h-11z' },
+        { d: 'M2.5 5.5h11', width: 2 },
+        { d: 'M2.5 8.5h11M2.5 11.5h11', width: 1 },
+    ],
     'name-manager': [
         { d: 'M2.5 3.5A1 1 0 0 1 3.5 2.5h4.6l5.4 5.4-4.9 4.9L3.5 8.4a1 1 0 0 1-1-1z' },
         { d: 'M5.6 5.6h.01', width: 2.2 },
@@ -233,6 +365,53 @@ export const RIBBON_ICONS = {
         { d: 'M6.3 10.5V7a1.2 1.2 0 0 1 1.2-1.2M5.2 8h2.4', width: 1.4 },
         { d: 'M8.6 8l2.4 2.5M11 8l-2.4 2.5', width: 1.2 },
     ],
+    /* Outlining. The bracket down the left is the outline bar Excel draws
+       beside the row numbers; the box at its end is the collapse button,
+       carrying a minus where the group is open and a plus where it is shut.
+       The column pair is the same glyph turned a quarter turn. */
+    'group-rows': [
+        { d: 'M4.5 3.5h7M4.5 6h7M4.5 8.5h7' },
+        { d: 'M2.5 3v6.5' },
+        { d: 'M2.5 12.5h3' },
+        { d: 'M1 11h3v3h-3z' },
+        { d: 'M1.8 12.5h1.4' },
+    ],
+    'group-cols': [
+        { d: 'M3.5 4.5v7M6 4.5v7M8.5 4.5v7' },
+        { d: 'M3 2.5h6.5' },
+        { d: 'M12.5 2.5v3' },
+        { d: 'M11 1h3v3h-3z' },
+        { d: 'M12.5 1.8v1.4' },
+    ],
+    'ungroup-rows': [
+        { d: 'M4.5 3.5h7M4.5 6h7M4.5 8.5h7' },
+        { d: 'M1 11h3v3h-3z', dash: DASHED },
+        { d: 'M2.5 3v6.5', dash: DASHED },
+    ],
+    'ungroup-cols': [
+        { d: 'M3.5 4.5v7M6 4.5v7M8.5 4.5v7' },
+        { d: 'M11 1h3v3h-3z', dash: DASHED },
+        { d: 'M12.5 2.5v3', dash: DASHED },
+    ],
+    /* Show Detail is a plus in a box, Hide Detail a minus: the two faces of
+       the same collapse button, which is what the commands do to it. */
+    'show-detail': [
+        { d: 'M2.5 2.5h11v11h-11z' },
+        { d: 'M5.5 8h5M8 5.5v5' },
+    ],
+    'hide-detail': [
+        { d: 'M2.5 2.5h11v11h-11z' },
+        { d: 'M5.5 8h5' },
+    ],
+    /* A ticked box, and a button with a rounded face. */
+    checkbox: [
+        { d: 'M2.5 2.5h11v11h-11z' },
+        { d: 'M5 8l2.2 2.4L11.5 5.5' },
+    ],
+    'cell-button': [
+        { d: 'M2 4.5h12a1.5 1.5 0 0 1 1.5 1.5v4a1.5 1.5 0 0 1-1.5 1.5H2A1.5 1.5 0 0 1 .5 10V6A1.5 1.5 0 0 1 2 4.5z' },
+        { d: 'M4.5 8h7' },
+    ],
     calculate: [
         { d: 'M4 1.5h8a1 1 0 0 1 1 1v11a1 1 0 0 1-1 1H4a1 1 0 0 1-1-1v-11a1 1 0 0 1 1-1z' },
         { d: 'M5 3.5h6v2.5H5z' },
@@ -281,6 +460,13 @@ export const RIBBON_ICONS = {
         { d: 'M9 10h5v4H9z' },
         { d: 'M10 10V8.8a1.5 1.5 0 0 1 3 0' },
     ],
+    // A sheet with a block picked out and a pencil over it: the ranges that take an edit.
+    'edit-ranges': [
+        { d: 'M2.5 2.5h11v11h-11z' },
+        { d: 'M2.5 6h11M6 2.5v11' },
+        { d: 'M7.5 7.5h4.5v4.5H7.5z', fill: true },
+        { d: 'M10.5 13.5l3-3 1 1-3 3h-1z' },
+    ],
     // A speech bubble, and the same bubble with a mark inside or beside it.
     comment: [
         { d: BUBBLE },

package/dist/sheet/ribbon.d.ts

@@ -122,7 +122,7 @@ export type RibbonItem = {
     split?: boolean;
 };
 /** Actions the ribbon delegates to the host rather than running itself. */
-export type RibbonActionId = 'paste-special' | 'format-cells' | 'find-replace' | 'insert-function' | 'name-manager' | 'text-to-columns' | 'remove-duplicates' | 'goal-seek' | 'insert-chart' | 'insert-table' | 'recalculate' | 'toggle-formulas' | 'sort-asc' | 'sort-desc' | 'toggle-filter' | 'freeze-panes' | 'unfreeze-panes' | 'hide-rows' | 'hide-columns' | 'unhide-rows' | 'unhide-columns' | 'row-height' | 'column-width' | 'autofit-rows' | 'autofit-columns' | 'paste-values' | 'paste-formulas' | 'paste-formats' | 'paste-transpose' | 'format-painter' | 'protect-sheet' | 'unprotect-sheet' | 'toggle-lock' | 'new-comment' | 'edit-comment' | 'delete-comment' | 'prev-comment' | 'next-comment' | 'toggle-comments' | 'data-validation' | 'open-list' | 'freeze-top-row' | 'freeze-first-column' | 'toggle-gridlines' | 'toggle-formula-bar' | 'toggle-headings' | 'toggle-ribbon' | 'cf-greater' | 'cf-less' | 'cf-between' | 'cf-equal' | 'cf-text' | 'cf-duplicates' | 'cf-top10' | 'cf-bottom10' | 'cf-above-average' | 'cf-below-average' | 'cf-data-bar' | 'cf-color-scale-3' | 'cf-color-scale-2' | 'cf-icon-set' | 'cf-clear-selection' | 'cf-clear-sheet' | 'cf-manage' | 'merge-center' | 'merge-across' | 'merge-cells' | 'unmerge-cells';
+export type RibbonActionId = 'file-new' | 'file-open' | 'file-save-xlsx' | 'file-export-csv' | 'file-save-ods' | 'file-save-xls' | 'file-print' | 'page-portrait' | 'page-landscape' | 'paper-a4' | 'paper-a3' | 'paper-a5' | 'paper-letter' | 'paper-legal' | 'paper-tabloid' | 'margins-normal' | 'margins-narrow' | 'margins-wide' | 'print-area-set' | 'print-area-clear' | 'print-titles' | 'page-setup' | 'print-gridlines' | 'print-headings' | 'paste-special' | 'cut' | 'undo' | 'redo' | 'format-cells' | 'find-replace' | 'insert-function' | 'name-manager' | 'text-to-columns' | 'remove-duplicates' | 'goal-seek' | 'insert-chart' | 'insert-picture' | 'chart-setup' | 'delete-object' | 'delete-sheet' | 'sparkline-line' | 'sparkline-column' | 'sparkline-winloss' | 'sparkline-setup' | 'clear-sparklines' | 'insert-pivot' | 'refresh-pivot' | 'insert-link' | 'remove-table' | 'table-style' | 'pivot-details' | 'remove-link' | 'insert-table' | 'recalculate' | 'insert-checkbox' | 'insert-cell-button' | 'clear-cell-type' | 'group-rows' | 'group-cols' | 'auto-outline' | 'ungroup-rows' | 'ungroup-cols' | 'clear-outline' | 'show-detail' | 'hide-detail' | 'calc-options' | 'evaluate-formula' | 'error-checking' | 'toggle-formulas' | 'trace-precedents' | 'trace-dependents' | 'remove-arrows' | 'sort-asc' | 'sort-desc' | 'sort-custom' | 'toggle-filter' | 'freeze-panes' | 'unfreeze-panes' | 'hide-rows' | 'hide-columns' | 'unhide-rows' | 'unhide-columns' | 'row-height' | 'column-width' | 'autofit-rows' | 'autofit-columns' | 'paste-values' | 'paste-formulas' | 'paste-formats' | 'paste-transpose' | 'format-painter' | 'protect-sheet' | 'unprotect-sheet' | 'allow-edit-ranges' | 'toggle-lock' | 'new-comment' | 'edit-comment' | 'delete-comment' | 'prev-comment' | 'next-comment' | 'toggle-comments' | 'data-validation' | 'circle-invalid' | 'clear-circles' | 'open-list' | 'freeze-top-row' | 'freeze-first-column' | 'toggle-gridlines' | 'toggle-formula-bar' | 'toggle-headings' | 'toggle-ribbon' | 'cf-greater' | 'cf-less' | 'cf-between' | 'cf-equal' | 'cf-text' | 'cf-duplicates' | 'cf-top10' | 'cf-bottom10' | 'cf-above-average' | 'cf-below-average' | 'cf-data-bar' | 'cf-color-scale-3' | 'cf-color-scale-2' | 'cf-icon-set' | 'cf-formula' | 'cf-clear-selection' | 'cf-clear-sheet' | 'cf-manage' | 'merge-center' | 'merge-across' | 'merge-cells' | 'unmerge-cells';
 export type RibbonGroup = {
     id: string;
     /** Printed under the group, which is what makes a ribbon a ribbon. */