@rowsncolumns/spreadsheet 10.6.4 → 10.7.0

package/dist/cjs/hooks/use-editor-submit.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.useEditorSubmit = exports.planEntryFill = exports.entryValueForCell = void 0;
+exports.useEditorSubmit = exports.entryTurnsOnWrap = exports.planArrayFormulaRange = exports.planEntryFill = exports.entryValueForCell = void 0;
 var tslib_1 = require("tslib");
 var utils_1 = require("@rowsncolumns/utils");
 var react_1 = require("react");
@@ -93,8 +93,54 @@ var planEntryFill = function (value, activeCell, selections) {
     return writes;
 };
 exports.planEntryFill = planEntryFill;
+var rangeContains = function (range, cell) {
+    return cell.rowIndex >= range.startRowIndex &&
+        cell.rowIndex <= range.endRowIndex &&
+        cell.columnIndex >= range.startColumnIndex &&
+        cell.columnIndex <= range.endColumnIndex;
+};
+/**
+ * The range a Ctrl+Shift+Enter commit at `activeCell` enters its array over (Excel): the selection
+ * holding the active cell; with nothing but the active cell selected, the CSE array it already
+ * belongs to (`existing` — editing any cell of an array and pressing Ctrl+Shift+Enter re-enters
+ * the whole array), else the active cell alone.
+ */
+var planArrayFormulaRange = function (activeCell, selections, existing) {
+    var _a;
+    var selected = (_a = selections.find(function (s) { return rangeContains(s.range, activeCell); })) === null || _a === void 0 ? void 0 : _a.range;
+    if (selected &&
+        (selected.startRowIndex !== selected.endRowIndex ||
+            selected.startColumnIndex !== selected.endColumnIndex)) {
+        return selected;
+    }
+    if (existing && rangeContains(existing, activeCell)) {
+        return existing;
+    }
+    return {
+        startRowIndex: activeCell.rowIndex,
+        endRowIndex: activeCell.rowIndex,
+        startColumnIndex: activeCell.columnIndex,
+        endColumnIndex: activeCell.columnIndex,
+    };
+};
+exports.planArrayFormulaRange = planArrayFormulaRange;
+/**
+ * Whether committing `value` turns Wrap Text on (Excel: an entry typed with a line break, Alt+Enter /
+ * ⌥Return, shows every line — "Start a new line of text inside a cell", support.microsoft.com). A
+ * formula's text breaks are its own, an unchanged entry is not a new one, and a cell that wraps
+ * already keeps its format.
+ */
+var entryTurnsOnWrap = function (_a) {
+    var value = _a.value, previousValue = _a.previousValue, format = _a.format;
+    return typeof value === "string" &&
+        !value.startsWith("=") &&
+        value.includes("\n") &&
+        value !== previousValue &&
+        (format === null || format === void 0 ? void 0 : format.wrapStrategy) !== "wrap";
+};
+exports.entryTurnsOnWrap = entryTurnsOnWrap;
 var useEditorSubmit = function (_a) {
-    var sheetId = _a.sheetId, onChangeActiveSheet = _a.onChangeActiveSheet, setActiveCell = _a.setActiveCell, onChange = _a.onChange, onComplete = _a.onComplete, getCommitValidation = _a.getCommitValidation, showValidationAlert = _a.showValidationAlert, selections = _a.selections, onChangeBatch = _a.onChangeBatch, batchHistory = _a.batchHistory, formulaLocale = _a.formulaLocale;
+    var sheetId = _a.sheetId, onChangeActiveSheet = _a.onChangeActiveSheet, setActiveCell = _a.setActiveCell, onChange = _a.onChange, onComplete = _a.onComplete, getCommitValidation = _a.getCommitValidation, showValidationAlert = _a.showValidationAlert, selections = _a.selections, onChangeBatch = _a.onChangeBatch, batchHistory = _a.batchHistory, formulaLocale = _a.formulaLocale, onChangeArrayFormula = _a.onChangeArrayFormula, getArrayFormula = _a.getArrayFormula, getEffectiveFormat = _a.getEffectiveFormat, onChangeFormatting = _a.onChangeFormatting, autoCorrect = _a.autoCorrect;
     var _b = tslib_1.__read((0, formula_mode_atom_1.useFormulaMode)(), 2), formulaMode = _b[0], setFormulaMode = _b[1];
     var _c = tslib_1.__read((0, editing_cell_atom_1.useEditingCell)(), 2), _ = _c[0], setEditingCellCoordinate = _c[1];
     var setActiveEditor = (0, atoms_1.useSetActiveEditor)();
@@ -117,6 +163,17 @@ var useEditorSubmit = function (_a) {
                     if (typeof previousValue === "string") {
                         previousValue = (0, utils_1.canonicalizeCellInput)(previousValue, formulaLocale);
                     }
+                    /* AutoCorrect a new text entry; an entry whose runs index into it keeps its length */
+                    if (autoCorrect &&
+                        !formulaMode &&
+                        typeof value === "string" &&
+                        value !== previousValue) {
+                        value = (0, utils_1.applyAutoCorrect)({
+                            text: value,
+                            options: autoCorrect,
+                            lengthPreserving: Boolean(textFormatRuns === null || textFormatRuns === void 0 ? void 0 : textFormatRuns.length),
+                        });
+                    }
                     resetEditorState = function () {
                         setEditingCellCoordinate(undefined);
                         setActiveEditor(undefined);
@@ -124,24 +181,41 @@ var useEditorSubmit = function (_a) {
                         onComplete === null || onComplete === void 0 ? void 0 : onComplete();
                     };
                     commit = function () {
-                        var _a;
+                        var _a, _b, _c;
                         var writeActiveCell = function () {
                             return onChange === null || onChange === void 0 ? void 0 : onChange(editingSheetId, activeCell, value, textFormatRuns, previousValue, isDirty);
                         };
+                        // Ctrl+Shift+Enter on a formula: ONE legacy array over the selection (or the array being
+                        // re-entered) — the engine writes and fits every cell of it, so nothing else is written.
+                        var arrayFormula = (options === null || options === void 0 ? void 0 : options.arrayFormula) && onChangeArrayFormula && isFormulaEntry(value);
                         // Ctrl+Enter: the same entry into every other selected cell (formulas shift per cell).
                         // Explicit per-cell values — never a read-back of the cell just written — so the spread
                         // is correct even when the engine applies `onChange` asynchronously (legacy setState),
-                        // and so the writes can share one history batch (the rnc batcher defers them all).
-                        var fillWrites = (options === null || options === void 0 ? void 0 : options.fillSelection) && onChangeBatch
+                        // and so the writes can share one history batch (the rnc batcher defers them all). A
+                        // Ctrl+Shift+Enter the host cannot enter as an array (a constant, or no array support)
+                        // commits the same way.
+                        var fillWrites = !arrayFormula &&
+                            ((options === null || options === void 0 ? void 0 : options.fillSelection) || (options === null || options === void 0 ? void 0 : options.arrayFormula)) &&
+                            onChangeBatch
                             ? (0, exports.planEntryFill)(value, activeCell, (_a = selectionsRef.current) !== null && _a !== void 0 ? _a : [])
                             : [];
-                        if (fillWrites.length === 0) {
+                        var wrapLineBreak = onChangeFormatting &&
+                            (0, exports.entryTurnsOnWrap)({
+                                value: value,
+                                previousValue: previousValue,
+                                format: getEffectiveFormat === null || getEffectiveFormat === void 0 ? void 0 : getEffectiveFormat(editingSheetId, activeCell.rowIndex, activeCell.columnIndex),
+                            });
+                        if (arrayFormula) {
+                            onChangeArrayFormula === null || onChangeArrayFormula === void 0 ? void 0 : onChangeArrayFormula(editingSheetId, (0, exports.planArrayFormulaRange)(activeCell, (_b = selectionsRef.current) !== null && _b !== void 0 ? _b : [], (_c = getArrayFormula === null || getArrayFormula === void 0 ? void 0 : getArrayFormula(editingSheetId, activeCell.rowIndex, activeCell.columnIndex)) === null || _c === void 0 ? void 0 : _c.range), value);
+                        }
+                        else if (fillWrites.length === 0 && !wrapLineBreak) {
                             writeActiveCell();
                         }
                         else {
-                            // One gesture, one undo entry: the active cell and every rectangle together.
+                            // One gesture, one undo entry: the active cell, every rectangle and the wrap together.
                             var writeAll = function () {
                                 var e_3, _a;
+                                var _b;
                                 writeActiveCell();
                                 try {
                                     for (var fillWrites_1 = tslib_1.__values(fillWrites), fillWrites_1_1 = fillWrites_1.next(); !fillWrites_1_1.done; fillWrites_1_1 = fillWrites_1.next()) {
@@ -156,6 +230,11 @@ var useEditorSubmit = function (_a) {
                                     }
                                     finally { if (e_3) throw e_3.error; }
                                 }
+                                if (wrapLineBreak) {
+                                    // Excel turns Wrap Text on for an entry with a line break, so every line shows and
+                                    // an auto-height row grows to them (the engines refit it on the format change).
+                                    onChangeFormatting === null || onChangeFormatting === void 0 ? void 0 : onChangeFormatting(editingSheetId, activeCell, fillWrites.length ? (_b = selectionsRef.current) !== null && _b !== void 0 ? _b : [] : [], "wrapStrategy", "wrap");
+                                }
                             };
                             if (batchHistory) {
                                 batchHistory(writeAll);
@@ -239,6 +318,11 @@ var useEditorSubmit = function (_a) {
         onChangeBatch,
         batchHistory,
         formulaLocale,
+        onChangeArrayFormula,
+        getArrayFormula,
+        getEffectiveFormat,
+        onChangeFormatting,
+        autoCorrect,
     ]);
 };
 exports.useEditorSubmit = useEditorSubmit;

package/dist/cjs/hooks/use-keyboard-handler.d.ts

@@ -71,11 +71,15 @@ type FormattingKeyboardProps = {
      * opened; the key is left alone otherwise.
      */
     onShowCellList?(sheetId: number, cell: CellInterface): boolean;
+    /**
+     * Alt+Shift+F10: open the active cell's error-checking menu (Excel). Returns whether one opened.
+     */
+    onShowErrorCheckMenu?(sheetId: number, cell: CellInterface): boolean;
     /** Ctrl+' / Ctrl+Shift+" write the cell above into the active cell */
     onChangeBatch?: CanvasGridProps["onChangeBatch"];
     getUserEnteredValue?(sheetId: number, rowIndex: number, columnIndex: number): string | undefined | null;
     getEffectiveValue?(sheetId: number, rowIndex: number, columnIndex: number): Maybe<ExtendedValue>;
 };
-export declare const useKeyboardHandler: ({ sheetId, locale, selectedRows, selectedColumns, selectedRowHeadersIds, selectedColumnHeadersIds, showFormulas, keymap, defaultFontSizePoint, onShowFormulas, onChangeFormatting, onRepeatFormatting, onClearFormatting, onSelectNextSheet, onSelectPreviousSheet, onCreateNewSheet, onFillRange, disableFillRightShortcut, onInsertTime, onInsertDate, onInsertDateTime, onInsertNote, onInsertAutoSum, onRedo, onUndo, onRequestSearch, onRequestReplace, onRequestFormatCells, onRequestInsertComment, onRequestInsertLink, onCreateTable, onRequestCreateTable, onCreateBasicFilter, clearCopiedSelections, getCellFormat, onShowContextMenu, onHideColumn, onShowColumn, onGroupColumns, onUngroupColumns, onHideRow, onShowRow, onGroupRows, onUngroupRows, onDeleteRow, onInsertRow, onAddQuickEdit, onCalculateNow, onRequestGoTo, onRequestPasteSpecial, onRequestEditCell, onShowCellList, onChangeBatch, getUserEnteredValue, getEffectiveValue, canEditCell, isSheetFocused, activeCell, selections, }: FormattingKeyboardProps) => (e: React.KeyboardEvent<HTMLDivElement>) => void;
+export declare const useKeyboardHandler: ({ sheetId, locale, selectedRows, selectedColumns, selectedRowHeadersIds, selectedColumnHeadersIds, showFormulas, keymap, defaultFontSizePoint, onShowFormulas, onChangeFormatting, onRepeatFormatting, onClearFormatting, onSelectNextSheet, onSelectPreviousSheet, onCreateNewSheet, onFillRange, disableFillRightShortcut, onInsertTime, onInsertDate, onInsertDateTime, onInsertNote, onInsertAutoSum, onRedo, onUndo, onRequestSearch, onRequestReplace, onRequestFormatCells, onRequestInsertComment, onRequestInsertLink, onCreateTable, onRequestCreateTable, onCreateBasicFilter, clearCopiedSelections, getCellFormat, onShowContextMenu, onHideColumn, onShowColumn, onGroupColumns, onUngroupColumns, onHideRow, onShowRow, onGroupRows, onUngroupRows, onDeleteRow, onInsertRow, onAddQuickEdit, onCalculateNow, onRequestGoTo, onRequestPasteSpecial, onRequestEditCell, onShowCellList, onShowErrorCheckMenu, onChangeBatch, getUserEnteredValue, getEffectiveValue, canEditCell, isSheetFocused, activeCell, selections, }: FormattingKeyboardProps) => (e: React.KeyboardEvent<HTMLDivElement>) => void;
 export {};
 //# sourceMappingURL=use-keyboard-handler.d.ts.map

package/dist/cjs/hooks/use-keyboard-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-keyboard-handler.d.ts","sourceRoot":"","sources":["../../../hooks/use-keyboard-handler.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"use-keyboard-handler.d.ts","sourceRoot":"","sources":["../../../hooks/use-keyboard-handler.tsx"],"names":[],"mappings":"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"}

package/dist/cjs/hooks/use-keyboard-handler.js

@@ -61,7 +61,7 @@ var useKeyboardHandler = function (_a) {
     // Quick edit
     onAddQuickEdit = _a.onAddQuickEdit, 
     // Excel keymap
-    onCalculateNow = _a.onCalculateNow, onRequestGoTo = _a.onRequestGoTo, onRequestPasteSpecial = _a.onRequestPasteSpecial, onRequestEditCell = _a.onRequestEditCell, onShowCellList = _a.onShowCellList, onChangeBatch = _a.onChangeBatch, getUserEnteredValue = _a.getUserEnteredValue, getEffectiveValue = _a.getEffectiveValue, canEditCell = _a.canEditCell, isSheetFocused = _a.isSheetFocused, activeCell = _a.activeCell, selections = _a.selections;
+    onCalculateNow = _a.onCalculateNow, onRequestGoTo = _a.onRequestGoTo, onRequestPasteSpecial = _a.onRequestPasteSpecial, onRequestEditCell = _a.onRequestEditCell, onShowCellList = _a.onShowCellList, onShowErrorCheckMenu = _a.onShowErrorCheckMenu, onChangeBatch = _a.onChangeBatch, getUserEnteredValue = _a.getUserEnteredValue, getEffectiveValue = _a.getEffectiveValue, canEditCell = _a.canEditCell, isSheetFocused = _a.isSheetFocused, activeCell = _a.activeCell, selections = _a.selections;
     return (0, use_callback_ref_1.useCallbackRef)((0, react_1.useCallback)(function (e) {
         var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o;
         var isCtrl = e.ctrlKey; // Ctrl
@@ -234,6 +234,14 @@ var useKeyboardHandler = function (_a) {
         }
         if (isAlt) {
             switch (key) {
+                // Alt+Shift+F10 — "displays the menu or message for an Error Checking button" (Excel).
+                case "F10":
+                    if (!isShift || isMeta || isCtrl)
+                        break;
+                    if (onShowErrorCheckMenu === null || onShowErrorCheckMenu === void 0 ? void 0 : onShowErrorCheckMenu(sheetId, activeCell)) {
+                        e.preventDefault();
+                    }
+                    return;
                 // Option/Alt + ArrowUp — previous sheet (Sheets). Nothing in
                 // Excel, so the Excel keymap leaves the key alone.
                 case "ArrowUp":
@@ -686,6 +694,7 @@ var useKeyboardHandler = function (_a) {
         onRequestPasteSpecial,
         onRequestEditCell,
         onShowCellList,
+        onShowErrorCheckMenu,
         onChangeBatch,
         getUserEnteredValue,
         getEffectiveValue,

package/dist/cjs/hooks/use-selection-drag-copy.d.ts

@@ -0,0 +1,55 @@
+import type { CellInterface, GridRange, SelectionArea } from "@rowsncolumns/grid";
+import type { CanvasGridProps, SelectionAttributes } from "../components/canvas-grid/typings";
+import type { SelectionDragMenuRequest } from "./use-selection";
+type Selection = SelectionArea<SelectionAttributes>;
+/** What a selection-border copy writes (Excel's right-drag Copy Here entries). */
+export type SelectionCopyKind = "all" | "values" | "formats";
+/**
+ * Excel's right-drag drop menu entries (support.microsoft.com "Move or copy cells and cell
+ * contents"). "Create Hyperlink Here" is not offered: the grid has no hyperlink write it can
+ * issue for a range (`onRequestInsertLink` only opens the link dialog for the active cell).
+ */
+export type SelectionDropAction = "move" | "copy" | "copy-values" | "copy-formats" | "link" | "shift-down-copy" | "shift-right-copy" | "shift-down-move" | "shift-right-move";
+export type SelectionDropMenuState = SelectionDragMenuRequest<SelectionAttributes>;
+/** Shift direction of an Insert Cut Cells move (`planInsertCutCells`' rule): right only when the drop stays on the source's rows. */
+export declare const insertShiftForDrop: (from: GridRange, to: GridRange) => "down" | "right";
+/**
+ * Excel "Link Here": each destination cell reads its source cell. A single cell links
+ * absolutely (`=$A$1`), a range relatively (`=A1`), as Paste Link writes them.
+ */
+export declare const linkFormulasFor: (from: GridRange) => string[][];
+export type UseSelectionDragCopyProps = {
+    sheetId: number;
+    readonly?: boolean;
+    onCopy: CanvasGridProps["onCopy"];
+    onPaste: CanvasGridProps["onPaste"];
+    onChangeBatch: CanvasGridProps["onChangeBatch"];
+    onMoveSelection: CanvasGridProps["onMoveSelection"];
+    onInsertCutCells: CanvasGridProps["onInsertCutCells"];
+    onInsertCopiedCells: CanvasGridProps["onInsertCopiedCells"];
+    /** Excel's "There's already data here" prompt; resolves `false` to cancel. */
+    confirmOverwrite?: (message: string) => boolean | Promise<boolean>;
+    getValue: (sheetId: number, rowIndex: number, columnIndex: number) => string | undefined | null;
+    /** Publish the grid selection (the destination after a drop-menu action). */
+    onChangeSelections?: (selections: Selection[]) => void;
+    onChangeActiveCell?: (sheetId: number, cell: CellInterface) => void;
+    focusSheet?: () => void;
+};
+/**
+ * Copy gestures of the selection border (Excel): Ctrl/⌥+drag copies, Ctrl+Shift/⌥⇧+drag
+ * inserts a copy, and a right-button drag opens the drop menu. A copy runs through the
+ * host's own `onCopy` → `onPaste` into a private clipboard — the system clipboard and the
+ * copied-range marquee are untouched — so the host's paste gates (protection, locked
+ * ranges, readonly) refuse a drop exactly as they refuse a paste.
+ */
+export declare const useSelectionDragCopy: ({ sheetId, readonly, onCopy, onPaste, onChangeBatch, onMoveSelection, onInsertCutCells, onInsertCopiedCells, confirmOverwrite, getValue, onChangeSelections, onChangeActiveCell, focusSheet, }: UseSelectionDragCopyProps) => {
+    copySelection: (from: Selection, to: Selection, kind?: SelectionCopyKind) => boolean;
+    insertCopiedCells: (from: Selection, to: Selection, shift?: "down" | "right") => boolean;
+    dropMenu: SelectionDropMenuState | null;
+    dropActions: SelectionDropAction[];
+    openDropMenu: (request: SelectionDropMenuState) => void;
+    closeDropMenu: () => void;
+    runDropAction: (action: SelectionDropAction) => Promise<void>;
+};
+export {};
+//# sourceMappingURL=use-selection-drag-copy.d.ts.map

package/dist/cjs/hooks/use-selection-drag-copy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-selection-drag-copy.d.ts","sourceRoot":"","sources":["../../../hooks/use-selection-drag-copy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,SAAS,EACT,aAAa,EACd,MAAM,oBAAoB,CAAC;AAU5B,OAAO,KAAK,EACV,eAAe,EACf,mBAAmB,EACpB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAEhE,KAAK,SAAS,GAAG,aAAa,CAAC,mBAAmB,CAAC,CAAC;AAEpD,kFAAkF;AAClF,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE7D;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAC3B,MAAM,GACN,MAAM,GACN,aAAa,GACb,cAAc,GACd,MAAM,GACN,iBAAiB,GACjB,kBAAkB,GAClB,iBAAiB,GACjB,kBAAkB,CAAC;AAEvB,MAAM,MAAM,sBAAsB,GAAG,wBAAwB,CAAC,mBAAmB,CAAC,CAAC;AAEnF,qIAAqI;AACrI,eAAO,MAAM,kBAAkB,GAC7B,MAAM,SAAS,EACf,IAAI,SAAS,KACZ,MAAM,GAAG,OACgD,CAAC;AAwD7D;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,MAAM,SAAS,KAAG,MAAM,EAAE,EAazD,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAC;IAClC,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC;IACpC,aAAa,EAAE,eAAe,CAAC,eAAe,CAAC,CAAC;IAChD,eAAe,EAAE,eAAe,CAAC,iBAAiB,CAAC,CAAC;IACpD,gBAAgB,EAAE,eAAe,CAAC,kBAAkB,CAAC,CAAC;IACtD,mBAAmB,EAAE,eAAe,CAAC,qBAAqB,CAAC,CAAC;IAC5D,8EAA8E;IAC9E,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnE,QAAQ,EAAE,CACR,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,KAChB,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IAC/B,6EAA6E;IAC7E,kBAAkB,CAAC,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,KAAK,IAAI,CAAC;IACvD,kBAAkB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,KAAK,IAAI,CAAC;IACpE,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;CACzB,CAAC;AAOF;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAAI,gMAclC,yBAAyB;0BAoBjB,SAAS,MAAM,SAAS,SAAQ,iBAAiB;8BAsBjD,SAAS,MAAM,SAAS,UAAU,MAAM,GAAG,OAAO;;;4BAkD/C,sBAAsB;;4BAcjB,mBAAmB;CAmFrC,CAAC"}

package/dist/cjs/hooks/use-selection-drag-copy.js

@@ -0,0 +1,274 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useSelectionDragCopy = exports.linkFormulasFor = exports.insertShiftForDrop = void 0;
+var tslib_1 = require("tslib");
+var grid_1 = require("@rowsncolumns/grid");
+var utils_1 = require("@rowsncolumns/utils");
+var react_1 = require("react");
+var move_overwrite_1 = require("../api/move-overwrite");
+/** Shift direction of an Insert Cut Cells move (`planInsertCutCells`' rule): right only when the drop stays on the source's rows. */
+var insertShiftForDrop = function (from, to) {
+    return to.startRowIndex === from.startRowIndex ? "right" : "down";
+};
+exports.insertShiftForDrop = insertShiftForDrop;
+/** A key/value clipboard for a synthetic copy: a real `DataTransfer` where the DOM has one. */
+var createClipboardData = function () {
+    if (typeof DataTransfer === "function") {
+        try {
+            return new DataTransfer();
+        }
+        catch (_a) {
+            /* fall through */
+        }
+    }
+    var store = new Map();
+    return {
+        setData: function (type, value) { return void store.set(type, String(value)); },
+        getData: function (type) { var _a; return (_a = store.get(type)) !== null && _a !== void 0 ? _a : ""; },
+        clearData: function () { return store.clear(); },
+        get types() {
+            return tslib_1.__spreadArray([], tslib_1.__read(store.keys()), false);
+        },
+        get items() {
+            return tslib_1.__spreadArray([], tslib_1.__read(store.keys()), false).map(function (type) { return ({ kind: "string", type: type }); });
+        },
+        files: [],
+    };
+};
+var createClipboardEvent = function (type, clipboardData) {
+    if (typeof ClipboardEvent === "function") {
+        try {
+            var event_1 = new ClipboardEvent(type, {
+                clipboardData: clipboardData,
+                bubbles: false,
+                cancelable: true,
+            });
+            if (event_1.clipboardData === clipboardData)
+                return event_1;
+        }
+        catch (_a) {
+            /* fall through */
+        }
+    }
+    var defaultPrevented = false;
+    return {
+        type: type,
+        clipboardData: clipboardData,
+        preventDefault: function () {
+            defaultPrevented = true;
+        },
+        get defaultPrevented() {
+            return defaultPrevented;
+        },
+        stopPropagation: function () { },
+    };
+};
+/**
+ * Excel "Link Here": each destination cell reads its source cell. A single cell links
+ * absolutely (`=$A$1`), a range relatively (`=A1`), as Paste Link writes them.
+ */
+var linkFormulasFor = function (from) {
+    var single = from.startRowIndex === from.endRowIndex &&
+        from.startColumnIndex === from.endColumnIndex;
+    var rows = [];
+    for (var r = from.startRowIndex; r <= from.endRowIndex; r++) {
+        var row = [];
+        for (var c = from.startColumnIndex; c <= from.endColumnIndex; c++) {
+            row.push("=".concat((0, utils_1.cellToAddress)({ rowIndex: r, columnIndex: c }, single, single)));
+        }
+        rows.push(row);
+    }
+    return rows;
+};
+exports.linkFormulasFor = linkFormulasFor;
+var defaultConfirm = function (message) {
+    return typeof window === "undefined" || typeof window.confirm !== "function"
+        ? true
+        : window.confirm(message);
+};
+/**
+ * Copy gestures of the selection border (Excel): Ctrl/⌥+drag copies, Ctrl+Shift/⌥⇧+drag
+ * inserts a copy, and a right-button drag opens the drop menu. A copy runs through the
+ * host's own `onCopy` → `onPaste` into a private clipboard — the system clipboard and the
+ * copied-range marquee are untouched — so the host's paste gates (protection, locked
+ * ranges, readonly) refuse a drop exactly as they refuse a paste.
+ */
+var useSelectionDragCopy = function (_a) {
+    var sheetId = _a.sheetId, _b = _a.readonly, readonly = _b === void 0 ? false : _b, onCopy = _a.onCopy, onPaste = _a.onPaste, onChangeBatch = _a.onChangeBatch, onMoveSelection = _a.onMoveSelection, onInsertCutCells = _a.onInsertCutCells, onInsertCopiedCells = _a.onInsertCopiedCells, _c = _a.confirmOverwrite, confirmOverwrite = _c === void 0 ? defaultConfirm : _c, getValue = _a.getValue, onChangeSelections = _a.onChangeSelections, onChangeActiveCell = _a.onChangeActiveCell, focusSheet = _a.focusSheet;
+    var _d = tslib_1.__read((0, react_1.useState)(null), 2), dropMenu = _d[0], setDropMenu = _d[1];
+    /** Serialize `from` through the host's copy; `null` when the host refused or wrote nothing. */
+    var copyToPrivateClipboard = (0, react_1.useCallback)(function (from) {
+        if (!onCopy)
+            return null;
+        var clipboardData = createClipboardData();
+        var copyEvent = createClipboardEvent("copy", clipboardData);
+        if (onCopy(copyEvent, sheetId, [from], false) === false)
+            return null;
+        // A host that defers its copy (e.g. to load cells first) leaves the clipboard empty —
+        // write nothing rather than an empty block.
+        return clipboardData.types.length ? clipboardData : null;
+    }, [onCopy, sheetId]);
+    var copySelection = (0, react_1.useCallback)(function (from, to, kind) {
+        if (kind === void 0) { kind = "all"; }
+        if (readonly || !onPaste)
+            return false;
+        var clipboardData = copyToPrivateClipboard(from);
+        if (!clipboardData)
+            return false;
+        if (kind !== "all") {
+            var options = {
+                paste: kind === "values" ? "values" : "formats",
+            };
+            clipboardData.setData("pasteSpecialOptions", JSON.stringify(options));
+        }
+        var pasteEvent = createClipboardEvent("paste", clipboardData);
+        var target = {
+            rowIndex: to.range.startRowIndex,
+            columnIndex: to.range.startColumnIndex,
+        };
+        void onPaste(pasteEvent, sheetId, sheetId, [from], target, [to], [to], false);
+        return true;
+    }, [readonly, onPaste, copyToPrivateClipboard, sheetId]);
+    var insertCopiedCells = (0, react_1.useCallback)(function (from, to, shift) {
+        if (readonly || !onInsertCopiedCells)
+            return false;
+        var clipboardData = copyToPrivateClipboard(from);
+        if (!clipboardData)
+            return false;
+        void onInsertCopiedCells(createClipboardEvent("paste", clipboardData), sheetId, from, to, shift !== null && shift !== void 0 ? shift : (0, exports.insertShiftForDrop)(from.range, to.range));
+        return true;
+    }, [readonly, onInsertCopiedCells, copyToPrivateClipboard, sheetId]);
+    var linkSelection = (0, react_1.useCallback)(function (from, to) {
+        if (readonly || !onChangeBatch)
+            return false;
+        onChangeBatch(sheetId, to.range, (0, exports.linkFormulasFor)(from.range));
+        return true;
+    }, [readonly, onChangeBatch, sheetId]);
+    /** Drop-menu entries the host can run for this drop (Excel lists them in this order). */
+    var getDropActions = (0, react_1.useCallback)(function (menu) {
+        var actions = [];
+        if (onMoveSelection)
+            actions.push("move");
+        if (onPaste && onCopy)
+            actions.push("copy", "copy-values", "copy-formats");
+        if (onChangeBatch)
+            actions.push("link");
+        if (onInsertCopiedCells && onCopy) {
+            actions.push("shift-down-copy", "shift-right-copy");
+        }
+        if (onInsertCutCells) {
+            // The engine's insert-move opens the band along the drop's own axis, so only the
+            // entry matching it can run.
+            actions.push((0, exports.insertShiftForDrop)(menu.from.range, menu.to.range) === "down"
+                ? "shift-down-move"
+                : "shift-right-move");
+        }
+        return actions;
+    }, [onMoveSelection, onPaste, onCopy, onChangeBatch, onInsertCopiedCells, onInsertCutCells]);
+    var openDropMenu = (0, react_1.useCallback)(function (request) {
+        if (readonly)
+            return;
+        setDropMenu(request);
+    }, [readonly]);
+    /** Cancel / Esc / click-away: nothing changes, the selection stays on the source. */
+    var closeDropMenu = (0, react_1.useCallback)(function () {
+        setDropMenu(null);
+        focusSheet === null || focusSheet === void 0 ? void 0 : focusSheet();
+    }, [focusSheet]);
+    var runDropAction = (0, react_1.useCallback)(function (action) { return tslib_1.__awaiter(void 0, void 0, void 0, function () {
+        var menu, from, to, hasValue, replaces, _a, done;
+        return tslib_1.__generator(this, function (_b) {
+            switch (_b.label) {
+                case 0:
+                    menu = dropMenu;
+                    setDropMenu(null);
+                    if (!menu || readonly)
+                        return [2 /*return*/];
+                    from = menu.from, to = menu.to;
+                    hasValue = function (rowIndex, columnIndex) {
+                        return !(0, grid_1.isNull)(getValue(sheetId, rowIndex, columnIndex));
+                    };
+                    replaces = action === "move"
+                        ? (0, move_overwrite_1.needsOverwritePrompt)(from.range, to.range, hasValue)
+                        : action === "copy" || action === "copy-values" || action === "link"
+                            ? (0, move_overwrite_1.needsCopyOverwritePrompt)(to.range, hasValue)
+                            : false;
+                    _a = replaces;
+                    if (!_a) return [3 /*break*/, 2];
+                    return [4 /*yield*/, confirmOverwrite(move_overwrite_1.MOVE_OVERWRITE_PROMPT)];
+                case 1:
+                    _a = !(_b.sent());
+                    _b.label = 2;
+                case 2:
+                    if (_a) {
+                        focusSheet === null || focusSheet === void 0 ? void 0 : focusSheet();
+                        return [2 /*return*/];
+                    }
+                    done = false;
+                    switch (action) {
+                        case "move":
+                            onMoveSelection === null || onMoveSelection === void 0 ? void 0 : onMoveSelection(sheetId, from, to);
+                            done = !!onMoveSelection;
+                            break;
+                        case "copy":
+                            done = copySelection(from, to, "all");
+                            break;
+                        case "copy-values":
+                            done = copySelection(from, to, "values");
+                            break;
+                        case "copy-formats":
+                            done = copySelection(from, to, "formats");
+                            break;
+                        case "link":
+                            done = linkSelection(from, to);
+                            break;
+                        case "shift-down-copy":
+                            done = insertCopiedCells(from, to, "down");
+                            break;
+                        case "shift-right-copy":
+                            done = insertCopiedCells(from, to, "right");
+                            break;
+                        case "shift-down-move":
+                        case "shift-right-move":
+                            onInsertCutCells === null || onInsertCutCells === void 0 ? void 0 : onInsertCutCells(sheetId, from, to);
+                            done = !!onInsertCutCells;
+                            break;
+                    }
+                    if (done) {
+                        // Excel selects the destination block after the drop.
+                        onChangeActiveCell === null || onChangeActiveCell === void 0 ? void 0 : onChangeActiveCell(sheetId, {
+                            rowIndex: to.range.startRowIndex,
+                            columnIndex: to.range.startColumnIndex,
+                        });
+                        onChangeSelections === null || onChangeSelections === void 0 ? void 0 : onChangeSelections([to]);
+                    }
+                    focusSheet === null || focusSheet === void 0 ? void 0 : focusSheet();
+                    return [2 /*return*/];
+            }
+        });
+    }); }, [
+        dropMenu,
+        readonly,
+        getValue,
+        sheetId,
+        confirmOverwrite,
+        onMoveSelection,
+        copySelection,
+        linkSelection,
+        insertCopiedCells,
+        onInsertCutCells,
+        onChangeActiveCell,
+        onChangeSelections,
+        focusSheet,
+    ]);
+    return {
+        copySelection: copySelection,
+        insertCopiedCells: insertCopiedCells,
+        dropMenu: dropMenu,
+        dropActions: dropMenu ? getDropActions(dropMenu) : [],
+        openDropMenu: openDropMenu,
+        closeDropMenu: closeDropMenu,
+        runDropAction: runDropAction,
+    };
+};
+exports.useSelectionDragCopy = useSelectionDragCopy;

package/dist/cjs/hooks/use-selection-renderer.d.ts

@@ -66,7 +66,14 @@ export type UseSelectionRendererProps = {
     calculatedColumnFill?: CalculatedColumnFill | null;
     canStopAutoCalculatedColumns?: boolean;
     onChooseCalculatedColumnOption?(option: CalculatedColumnOption): void;
+    /** The active cell's error-checking flag, when it carries the green ◤ (smart tag beside it). */
+    errorCheck?: SelectionNewProps["errorCheck"];
+    errorCheckMenuOpen?: boolean;
+    onErrorCheckMenuOpenChange?: SelectionNewProps["onErrorCheckMenuOpenChange"];
+    onChooseErrorCheckOption?: SelectionNewProps["onChooseErrorCheckOption"];
     onSplitTextToColumns: CanvasGridProps["onSplitTextToColumns"];
+    /** Paste Options gallery choice (re-applies the last paste). */
+    onChoosePasteOption?: SelectionNewProps["onChoosePasteOption"];
     hoveredCell?: CellInterface | null;
     onRemoveQuickEdit(range: SheetRange): void;
     onAddQuickEdit(range: SheetRange): void;
@@ -77,5 +84,5 @@ export type UseSelectionRendererProps = {
      */
     isFillShrink?: boolean;
 };
-export declare const useSelectionRenderer: ({ sheetId, selectionCount, selectionBackgroundColor, selectionBorderColor, selectionStrokeWidth, showActiveCellBorderInSelection, onSelectionMouseDown, onChangeActiveCell, onChangeSelections, onRequestEditTable, onRequestEditPivotTable, onMouseDownResizeHandle, onMouseDownChartSourceResizeHandle, onMouseDownMoveSelection, isDraggingMoveSelection, onFlashEnd, getSheetName, resizeHandleSize, showSelectionResizeHandles, resizeHandleBorderColor, SelectionTitleComponent, isResizingTable, fillHandleSize, showFillHandle, enableMagicFill, MagicFillComponent, MagicFillContent, readonly, showPasteMenu, fillOptions, onChooseFillType, onOpenFillSeriesDialog, onCloseFillOptions, insertOptions, onChooseInsertOption, tableAutoExpansion, canStopAutoExpandingTables, onChooseTableAutoExpansionOption, calculatedColumnFill, canStopAutoCalculatedColumns, onChooseCalculatedColumnOption, hoveredCell, onSplitTextToColumns, onRemoveQuickEdit, onAddQuickEdit, QuickEdit, PasteMenu, SuggestionAction, cachedHoveredSelectionIds, isFillShrink, }: UseSelectionRendererProps) => (props: SelectionProps<SelectionAttributes>) => React.JSX.Element | null;
+export declare const useSelectionRenderer: ({ sheetId, selectionCount, selectionBackgroundColor, selectionBorderColor, selectionStrokeWidth, showActiveCellBorderInSelection, onSelectionMouseDown, onChangeActiveCell, onChangeSelections, onRequestEditTable, onRequestEditPivotTable, onMouseDownResizeHandle, onMouseDownChartSourceResizeHandle, onMouseDownMoveSelection, isDraggingMoveSelection, onFlashEnd, getSheetName, resizeHandleSize, showSelectionResizeHandles, resizeHandleBorderColor, SelectionTitleComponent, isResizingTable, fillHandleSize, showFillHandle, enableMagicFill, MagicFillComponent, MagicFillContent, readonly, showPasteMenu, fillOptions, onChooseFillType, onOpenFillSeriesDialog, onCloseFillOptions, insertOptions, onChooseInsertOption, tableAutoExpansion, canStopAutoExpandingTables, onChooseTableAutoExpansionOption, calculatedColumnFill, canStopAutoCalculatedColumns, onChooseCalculatedColumnOption, errorCheck, errorCheckMenuOpen, onErrorCheckMenuOpenChange, onChooseErrorCheckOption, hoveredCell, onSplitTextToColumns, onChoosePasteOption, onRemoveQuickEdit, onAddQuickEdit, QuickEdit, PasteMenu, SuggestionAction, cachedHoveredSelectionIds, isFillShrink, }: UseSelectionRendererProps) => (props: SelectionProps<SelectionAttributes>) => React.JSX.Element | null;
 //# sourceMappingURL=use-selection-renderer.d.ts.map

package/dist/cjs/hooks/use-selection-renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-selection-renderer.d.ts","sourceRoot":"","sources":["../../../hooks/use-selection-renderer.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"use-selection-renderer.d.ts","sourceRoot":"","sources":["../../../hooks/use-selection-renderer.tsx"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAKlB,KAAK,aAAa,EAClB,KAAK,cAAc,EACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAA8B,MAAM,OAAO,CAAC;AAGnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAShE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAErE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAE5B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,EAC9B,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EACV,eAAe,EACf,mBAAmB,EACpB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAEvE,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAM5C,MAAM,MAAM,yBAAyB,GAAG;IACtC,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,wBAAwB,EAAE,MAAM,CAAC;IACjC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oFAAoF;IACpF,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,oGAAoG;IACpG,+BAA+B,CAAC,EAAE,OAAO,CAAC;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACnD,kBAAkB,EAAE,eAAe,CAAC,oBAAoB,CAAC,CAAC;IAC1D,kBAAkB,EAAE,eAAe,CAAC,oBAAoB,CAAC,CAAC;IAC1D,oBAAoB,CAAC,CACnB,CAAC,EAAE,KAAK,CAAC,UAAU,CAAC,cAAc,EAAE,UAAU,CAAC,EAC/C,IAAI,EAAE,aAAa,GAAG,SAAS,EAC/B,SAAS,EAAE,aAAa,GAAG,SAAS,EACpC,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,GAChC,IAAI,CAAC;IACR,uBAAuB,EAAE,KAAK,CAAC,WAAW,CAAC;IAC3C,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,eAAe,EAAE,OAAO,CAAC;IACzB,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,eAAe,CAAC,oBAAoB,CAAC,CAAC;IAC1D,uBAAuB,EAAE,eAAe,CAAC,yBAAyB,CAAC,CAAC;IACpE,uBAAuB,EAAE,iBAAiB,CAAC,yBAAyB,CAAC,CAAC;IACtE,oEAAoE;IACpE,kCAAkC,CAAC,EAAE,iBAAiB,CAAC,yBAAyB,CAAC,CAAC;IAClF,wBAAwB,EAAE,iBAAiB,CAAC,uBAAuB,CAAC,CAAC;IACrE,sEAAsE;IACtE,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,UAAU,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC;IACtD,eAAe,CAAC,EAAE,eAAe,CAAC,iBAAiB,CAAC,CAAC;IACrD,kBAAkB,CAAC,EAAE,eAAe,CAAC,oBAAoB,CAAC,CAAC;IAC3D,gBAAgB,CAAC,EAAE,eAAe,CAAC,kBAAkB,CAAC,CAAC;IACvD,SAAS,CAAC,EAAE,eAAe,CAAC,WAAW,CAAC,CAAC;IACzC,SAAS,CAAC,EAAE,eAAe,CAAC,WAAW,CAAC,CAAC;IACzC,gBAAgB,CAAC,EAAE,eAAe,CAAC,kBAAkB,CAAC,CAAC;IACvD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,gGAAgG;IAChG,WAAW,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACxC,gBAAgB,CAAC,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IAChD,sBAAsB,CAAC,IAAI,IAAI,CAAC;IAChC,kBAAkB,CAAC,IAAI,IAAI,CAAC;IAC5B;;;OAGG;IACH,aAAa,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC5C,oBAAoB,CAAC,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACxD,uGAAuG;IACvG,kBAAkB,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAC/C,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,gCAAgC,CAAC,CAAC,MAAM,EAAE,wBAAwB,GAAG,IAAI,CAAC;IAC1E,sGAAsG;IACtG,oBAAoB,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACnD,4BAA4B,CAAC,EAAE,OAAO,CAAC;IACvC,8BAA8B,CAAC,CAAC,MAAM,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACtE,gGAAgG;IAChG,UAAU,CAAC,EAAE,iBAAiB,CAAC,YAAY,CAAC,CAAC;IAC7C,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,0BAA0B,CAAC,EAAE,iBAAiB,CAAC,4BAA4B,CAAC,CAAC;IAC7E,wBAAwB,CAAC,EAAE,iBAAiB,CAAC,0BAA0B,CAAC,CAAC;IACzE,oBAAoB,EAAE,eAAe,CAAC,sBAAsB,CAAC,CAAC;IAC9D,gEAAgE;IAChE,mBAAmB,CAAC,EAAE,iBAAiB,CAAC,qBAAqB,CAAC,CAAC;IAC/D,WAAW,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IACnC,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IAC3C,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IACxC,yBAAyB,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAChD;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAyBF,eAAO,MAAM,oBAAoB,GAAI,mnCAwDlC,yBAAyB,aAOhB,cAAc,CAAC,mBAAmB,CAAC,6BA8S9C,CAAC"}