@rowsncolumns/spreadsheet-state 29.2.0 → 29.3.2

package/dist/cjs/components/editors/cell-format-editor.d.ts

@@ -1,8 +1,8 @@
 import type { CellInterface, SelectionArea } from "@rowsncolumns/common-types";
-import type { SelectionAttributes, SpreadsheetTheme } from "@rowsncolumns/spreadsheet";
-import type { CellFormat } from "@rowsncolumns/spreadsheet";
+import type { CellFormat, SelectionAttributes, SpreadsheetTheme } from "@rowsncolumns/spreadsheet";
 import React from "react";
 import type { useSpreadsheetState } from "../../hooks/use-spreadsheet-state";
+export type CellFormatTab = "number" | "alignment" | "font" | "border" | "fill" | "protection";
 type CellFormatEditorProps = {
     sheetId: number;
     activeCell: CellInterface;
@@ -16,9 +16,37 @@ type CellFormatEditorProps = {
     onChangeFormatting: ReturnType<typeof useSpreadsheetState>["onChangeFormatting"];
     getEffectiveValue: ReturnType<typeof useSpreadsheetState>["getEffectiveValue"];
     onMergeCells: ReturnType<typeof useSpreadsheetState>["onMergeCells"];
+    /** Alignment → Merge cells unchecked on a merged cell. */
+    onUnMergeCells?: ReturnType<typeof useSpreadsheetState>["onUnMergeCells"];
+    /** Whether the active cell is part of a merge (Merge cells opens checked). */
+    isMerged?: boolean;
+    /** The active cell's `CellData.protection` (Protection tab; absent = Locked, not Hidden). */
+    cellProtection?: {
+        locked?: boolean | null;
+        hidden?: boolean | null;
+    } | null;
+    /** Protection tab: write `locked` / `hidden` onto the selection. */
+    onChangeCellProtection?(sheetId: number, activeCell: CellInterface, selections: SelectionArea<SelectionAttributes>[], protection: {
+        locked?: boolean;
+        hidden?: boolean;
+    }): void;
+    /** The tab the dialog opens on (Excel reopens on the last one used). */
+    defaultTab?: CellFormatTab;
     onCancel?(): void;
 };
-export declare const CellFormatEditor: ({ locale, cellFormat, sheetId, activeCell, selections, currencySymbol, theme, isDarkMode, onMergeCells, onChangeFormatting, onChangeBorder, onCancel, getEffectiveValue, }: CellFormatEditorProps) => React.JSX.Element;
+/**
+ * The properties the dialog changed, and only those — Excel's Format Cells
+ * applies what you edited to every selected cell and leaves the rest of each
+ * cell's format alone. A removed value is sent as `undefined` (the engines'
+ * clear for that property).
+ */
+export declare const diffCellFormat: (initial: CellFormat, draft: CellFormat) => CellFormat;
+/**
+ * Excel's Format Cells dialog (Ctrl+1 / ⌘1): Number, Alignment, Font,
+ * Border, Fill and Protection. Every tab edits a draft; OK applies the
+ * edits to the selection, Cancel drops them.
+ */
+export declare const CellFormatEditor: ({ locale, cellFormat, sheetId, activeCell, selections, currencySymbol, theme, isDarkMode, onMergeCells, onUnMergeCells, isMerged, cellProtection, onChangeCellProtection, onChangeFormatting, onChangeBorder, onCancel, getEffectiveValue, defaultTab, }: CellFormatEditorProps) => React.JSX.Element;
 export declare const CellFormatEditorDialog: ({ children, }: {
     children: React.ReactNode;
 }) => React.JSX.Element;

package/dist/cjs/components/editors/cell-format-editor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cell-format-editor.d.ts","sourceRoot":"","sources":["../../../../components/editors/cell-format-editor.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAO/E,OAAO,KAAK,EAOV,mBAAmB,EACnB,gBAAgB,EAEjB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AA0C5D,OAAO,KAAyC,MAAM,OAAO,CAAC;AAa9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAE7E,KAAK,qBAAqB,GAAG;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,aAAa,CAAC;IAC1B,UAAU,EAAE,aAAa,CAAC,mBAAmB,CAAC,EAAE,CAAC;IACjD,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,gBAAgB,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,cAAc,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,gBAAgB,CAAC,CAAC;IACzE,kBAAkB,EAAE,UAAU,CAC5B,OAAO,mBAAmB,CAC3B,CAAC,oBAAoB,CAAC,CAAC;IACxB,iBAAiB,EAAE,UAAU,CAC3B,OAAO,mBAAmB,CAC3B,CAAC,mBAAmB,CAAC,CAAC;IACvB,YAAY,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,cAAc,CAAC,CAAC;IACrE,QAAQ,CAAC,IAAI,IAAI,CAAC;CACnB,CAAC;AAyWF,eAAO,MAAM,gBAAgB,GAAI,4KAc9B,qBAAqB,sBAwlBvB,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,eAEpC;IACD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B,sBAwBA,CAAC"}
+{"version":3,"file":"cell-format-editor.d.ts","sourceRoot":"","sources":["../../../../components/editors/cell-format-editor.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE/E,OAAO,KAAK,EAEV,UAAU,EAEV,mBAAmB,EACnB,gBAAgB,EAEjB,MAAM,2BAA2B,CAAC;AAcnC,OAAO,KAA4B,MAAM,OAAO,CAAC;AAMjD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAiB7E,MAAM,MAAM,aAAa,GACrB,QAAQ,GACR,WAAW,GACX,MAAM,GACN,QAAQ,GACR,MAAM,GACN,YAAY,CAAC;AAEjB,KAAK,qBAAqB,GAAG;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,aAAa,CAAC;IAC1B,UAAU,EAAE,aAAa,CAAC,mBAAmB,CAAC,EAAE,CAAC;IACjD,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,gBAAgB,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,cAAc,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,gBAAgB,CAAC,CAAC;IACzE,kBAAkB,EAAE,UAAU,CAC5B,OAAO,mBAAmB,CAC3B,CAAC,oBAAoB,CAAC,CAAC;IACxB,iBAAiB,EAAE,UAAU,CAC3B,OAAO,mBAAmB,CAC3B,CAAC,mBAAmB,CAAC,CAAC;IACvB,YAAY,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,cAAc,CAAC,CAAC;IACrE,0DAA0D;IAC1D,cAAc,CAAC,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,gBAAgB,CAAC,CAAC;IAC1E,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,6FAA6F;IAC7F,cAAc,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IAC7E,oEAAoE;IACpE,sBAAsB,CAAC,CACrB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,aAAa,EACzB,UAAU,EAAE,aAAa,CAAC,mBAAmB,CAAC,EAAE,EAChD,UAAU,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GACjD,IAAI,CAAC;IACR,wEAAwE;IACxE,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B,QAAQ,CAAC,IAAI,IAAI,CAAC;CACnB,CAAC;AAKF;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GACzB,SAAS,UAAU,EACnB,OAAO,UAAU,KAChB,UAoBF,CAAC;AAsBF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,0PAmB9B,qBAAqB,sBAqLvB,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,eAEpC;IACD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B,sBAwBA,CAAC"}