@sheetxl/sdk 0.7.22 → 0.7.24

package/node/esm/{D5GT8lL2mkHYYpEm.mjs → llZohIB6k9AHOBpc.mjs}

@@ -1,5 +1,5 @@
 /**
- * @license @sheetxl/sdk - SDK - A high-performance, embeddable spreadsheet engine. - v0.7.22
+ * @license @sheetxl/sdk - SDK - A high-performance, embeddable spreadsheet engine. - v0.7.24
  *
  * (C) 2025-present SheetXL Inc. & Michael T. Ford
  * License: The license can be found at https://www.sheetxl.com/license.

package/node/esm/{BeNiW7K89qdTHcyZ.mjs → sZ-OlGRn3tftSRQo.mjs}

@@ -1,5 +1,5 @@
 /**
- * @license @sheetxl/sdk - SDK - A high-performance, embeddable spreadsheet engine. - v0.7.22
+ * @license @sheetxl/sdk - SDK - A high-performance, embeddable spreadsheet engine. - v0.7.24
  *
  * (C) 2025-present SheetXL Inc. & Michael T. Ford
  * License: The license can be found at https://www.sheetxl.com/license.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sheetxl/sdk",
   "description": "SDK - A high-performance, embeddable spreadsheet engine.",
-  "version": "0.7.22",
+  "version": "0.7.24",
   "license": "SEE LICENSE IN <LICENSE>",
   "type": "module",
   "exports": {
@@ -43,9 +43,9 @@
     "automation"
   ],
   "dependencies": {
-    "@sheetxl/primitives": "^0.7.22",
-    "@sheetxl/scripting": "^0.7.22",
-    "@sheetxl/utils": "^0.7.22",
+    "@sheetxl/primitives": "^0.7.24",
+    "@sheetxl/scripting": "^0.7.24",
+    "@sheetxl/utils": "^0.7.24",
     "bahttext": "^2.3.0",
     "bessel": "^1.0.2",
     "chalk": "^5.6.2",

package/types/index.d.ts

@@ -1354,15 +1354,24 @@ declare const getFileNameExtension: (path: string) => string;
 
 declare function getFontList(): readonly FontHandle[];
 
-declare interface GetRangeEntriesOptions<T = any, E = any> {
+declare interface GetTypedRangeOptions<T = any, E = any> {
+    /**
+     * If 'true' will not return ranges that are hidden.
+     * If partially hidden the 'fullContained' is applied.
+     */
     ignoreHidden?: boolean | IRange.Orientation;
+    /**
+     * Only return ranges that are completely contained with the search range.
+     *
+     * @defaultValue false
+     */
     fullyContained?: boolean;
-    onEntry?: (value: E, entry: ISpatialMap.Entry<T>) => T | void;
-    noCache?: boolean;
     sort?: {
         orientation?: IRange.Orientation;
         reverse?: boolean;
     };
+    onEntry?: (value: E, entry: ISpatialMap.Entry<T>) => T | void;
+    noCache?: boolean;
 }
 
 declare interface HiddenRun extends ITypes.RunCoordValue<boolean> {

package/types/scripting.d.ts

@@ -19078,6 +19078,9 @@ declare module "selection/RangeSelection" {
     import { ListenerEmitter } from "listener/ListenerEmitter";
     import { HiddenHeadersAt, CellFinder } from "selection/_RangeSelectionUtils";
     import { IRangeSelection } from "selection/IRangeSelection";
+    /**
+     * TODO - Not in USE. meant to replace the mess that is useSelection
+     */
     export class RangeSelection {
         protected _coords: IRangeSelection.Coords;
         protected _sheet: ISheet;
@@ -21342,23 +21345,27 @@ declare module "sheet/_SheetTypes" {
             table?: ITable;
             /**
              * Conditional styles.
+             *
+             * @remarks
+             * Overlaps are allowed
              */
             conditionals?: ConditionalEntry[];
             /**
              * The style for a collection of cells.
+             *
+             * @remarks
+             * This is the style set by the user.
              */
             directStyle?: IProperties.ICellRanged<IStyle.Properties>;
-            /**
-             * This is also a collection of styles but we track these separately so that we can save
-             * these styles back to Excel.
-             */
-            styledHeaderRange?: IProperties.ICellRanged<IStyle.Properties>;
             /**
              * The hyperlink.
              */
             hyperlink?: IHyperlink.Properties;
             /**
-             * The unlock.
+             * Directives for unlocking a range. (Only applies if the sheet is protected).
+             *
+             * @remarks
+             * Overlaps are allowed
              */
             unlock?: UnlockEntry[];
             /**
@@ -21379,14 +21386,20 @@ declare module "sheet/_SheetTypes" {
             continuous?: IProperties.ICellRanged<IStyle.Properties>;
             /**
              * The comments.
+             *
+             * @remarks
+             * A block of comments for the range.
              */
             comments?: IComment.JSON;
             /**
-             * The formula.
+             * A block of R1C1 formulas.
              */
             formula?: FormulaEntry;
             /**
-             * Valid spills.
+             * Spills.
+             *
+             * @remarks
+             * There can be multiple spills on a cell but only one will be valid.
              */
             spills?: SpillEntry[];
             /**
@@ -21397,13 +21410,22 @@ declare module "sheet/_SheetTypes" {
              * Errors during calculation.
              */
             calcError?: string;
+            /**
+             * Non overlapping data validation entries.
+             */
+            dataValidation?: any;
+            /**
+             * Overlapping named ranges.
+             */
+            namedRange?: any[];
         }
         /**
-       * Range types are stored with a sheet range.
-       * @internal
-       */
+         * Range types are stored with a sheet range.
+         * @internal
+         */
         const Type: {
             readonly Style: "style";
+            readonly Continuous: "continuous";
             readonly Table: "table";
             readonly Merge: "merge";
             readonly Hyperlink: "hyperlink";
@@ -21411,11 +21433,14 @@ declare module "sheet/_SheetTypes" {
             readonly Unlock: "unlock";
             readonly Contentful: "contentful";
             readonly Conditional: "conditional";
+            /**
+             * Has a formula
+             */
             readonly Formula: "formula";
             readonly Spill: "spill";
-            readonly Continuous: "continuous";
             readonly Pending: "pending";
             readonly CalcError: "calcError";
+            readonly Validation: "dataValidation";
         };
         type Type = typeof Type[keyof typeof Type];
     }
@@ -22149,15 +22174,24 @@ declare module "sheet/Sheet" {
         removeListener: IListener.Remove;
         options: ICellRange.ListenerOptions;
     }
-    interface GetRangeEntriesOptions<T = any, E = any> {
+    interface GetTypedRangeOptions<T = any, E = any> {
+        /**
+         * If 'true' will not return ranges that are hidden.
+         * If partially hidden the 'fullContained' is applied.
+         */
         ignoreHidden?: boolean | IRange.Orientation;
+        /**
+         * Only return ranges that are completely contained with the search range.
+         *
+         * @defaultValue false
+        */
         fullyContained?: boolean;
-        onEntry?: (value: E, entry: ISpatialMap.Entry<T>) => T | void;
-        noCache?: boolean;
         sort?: {
             orientation?: IRange.Orientation;
             reverse?: boolean;
         };
+        onEntry?: (value: E, entry: ISpatialMap.Entry<T>) => T | void;
+        noCache?: boolean;
     }
     interface ViewEdgeEntry {
         rowIndex: number;
@@ -22636,7 +22670,7 @@ declare module "sheet/Sheet" {
          * Tries to cache and can exclude hidden.
          * @internal
          */
-        protected _getRangedEntries<T, E = T>(key: string, ranges: readonly IRange.Coords[], options?: GetRangeEntriesOptions<T, E>): T[];
+        protected _getRangedEntries<T, E = T>(key: keyof State, ranges: readonly IRange.Coords[], options?: GetTypedRangeOptions<T, E>): T[];
         /** @internal */
         protected _processAnchorShift<T extends IAnchorEntry>(options: ISpatialMap.ShiftDetails<T>): ISpatialMap.Entry<T>;
         /** @internal */