@sheetxl/sdk 0.6.4 → 0.6.5

package/node/esm/{DH19S1M27hG0ushG.mjs → qu-NfeeDZTjvhO6W.mjs}

@@ -1,5 +1,5 @@
 /**
- * @license @sheetxl/sdk - SDK - A high-performance, embeddable spreadsheet engine. - v0.6.4
+ * @license @sheetxl/sdk - SDK - A high-performance, embeddable spreadsheet engine. - v0.6.5
  *
  * (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.6.4",
+  "version": "0.6.5",
   "license": "SEE LICENSE IN <LICENSE>",
   "type": "module",
   "exports": {
@@ -31,9 +31,9 @@
     "automation"
   ],
   "dependencies": {
-    "@sheetxl/primitives": "^0.6.4",
-    "@sheetxl/scripting": "^0.6.4",
-    "@sheetxl/utils": "^0.6.4",
+    "@sheetxl/primitives": "^0.6.5",
+    "@sheetxl/scripting": "^0.6.5",
+    "@sheetxl/utils": "^0.6.5",
     "bahttext": "^2.3.0",
     "bessel": "^1.0.2",
     "chalk": "^5.5.0",

package/types/index.d.ts

@@ -17483,7 +17483,7 @@ export declare interface LicenseDetails {
 /**
  * LicenseManager is used to manage license keys at runtime.
  *
- * License keys can be generated by visiting {@link https://www.sheetxl.com/docs/getting-started/license-key | License Keys}.
+ * License keys can be generated by visiting {@link https://www.sheetxl.com/docs/guides/getting-started/license-key | License Keys}.
  */
 export declare const LicenseManager: LM;
 
@@ -17523,7 +17523,7 @@ declare class LM {
      * @param force If set to `true` will replace an existing key.
      *
      * @see
-     * {@link https://www.sheetxl.com/docs/getting-started/license-key | License Keys}
+     * {@link https://www.sheetxl.com/docs/guides/getting-started/license-key | License Keys}
      */
     setLicenseKey(licenseKey: string, force?: boolean): Promise<LicenseDetails>;
     private _validate;
@@ -18122,8 +18122,8 @@ declare namespace RangeState {
      */
     type SearchTypes = Partial<Record<RangeState.Type, boolean>>;
     interface IteratorOptions extends OverlappingRange.IteratorOptions {
-        bounds?: IRange.Coords;
         includeRangeTypes: boolean | SearchTypes;
+        bounds?: IRange.Coords;
         excludeHidden?: boolean | IRange.Orientation;
         includeMergeOverflow?: boolean;
     }
@@ -18422,6 +18422,7 @@ export declare class Sheet implements ISheet {
     /* Excluded from this release type: _collectRanges */
     /* Excluded from this release type: _cellIterator */
     /* Excluded from this release type: _rangeStateIterator */
+    /* Excluded from this release type: _overflowAndStops */
     /* Excluded from this release type: _cellStateIterator */
     /* Excluded from this release type: _indexMerges */
     /* Excluded from this release type: _updateStyles */
@@ -20498,6 +20499,18 @@ declare namespace _Utils {
  */
 declare const validateRuns: (runs: RunCoords[]) => boolean;
 
+declare interface ViewEdgeEntry {
+    rowIndex: number;
+    colIndex: number;
+    continuous: IProperties.ICellRanged<IStyle.Properties> | null;
+    leftIndex: number;
+    rightIndex: number;
+    overflow: ICell.HorizontalOverflow | null;
+    intersection: RangeState.Intersection;
+    scalar: Scalar | null;
+    style: IStyle;
+}
+
 declare type WellKnownIterator<T, TReturn = any, TNext = undefined> = Iterator<T, TReturn, TNext>;
 
 declare type WellKnownIteratorResult<T, TReturn = any> = IteratorResult<T, TReturn>;

package/types/scripting.d.ts

@@ -16878,8 +16878,8 @@ declare module "sheet/_SheetTypes" {
          */
         type SearchTypes = Partial<Record<RangeState.Type, boolean>>;
         interface IteratorOptions extends OverlappingRange.IteratorOptions {
-            bounds?: IRange.Coords;
             includeRangeTypes: boolean | SearchTypes;
+            bounds?: IRange.Coords;
             excludeHidden?: boolean | IRange.Orientation;
             includeMergeOverflow?: boolean;
         }
@@ -17003,19 +17003,24 @@ declare module "sheet/_SheetTypes" {
         };
         type Type = typeof Type[keyof typeof Type];
     }
-    export const RangeTypesAll: RangeState.SearchTypes;
-    export const RangeTypesCellState: RangeState.SearchTypes;
+    export const AllRangeTypes: RangeState.SearchTypes;
+    export const CellStateRangeTypes: RangeState.SearchTypes;
     /**
      * We don't want to copy TextOverflows.
      * TODO - create a more generalize Type (Eager vs on demand.)
      * @internal
      */
-    export const RangeTypesCopy: RangeState.SearchTypes;
+    export const CopyRangeTypes: RangeState.SearchTypes;
     /**
      * Used by merge redirect lookup.
      * @internal
      */
-    export const RangeTypesNoMerge: RangeState.SearchTypes;
+    export const NoMergeRangeTypes: RangeState.SearchTypes;
+    /**
+     * Used by overlaps lookup
+     * @internal
+     */
+    export const OverflowsRangeTypes: RangeState.SearchTypes;
 }
 declare module "sheet/spatial/MergeEntry" {
     import { Scalar, IRange } from '@sheetxl/primitives';
@@ -17919,8 +17924,13 @@ declare module "sheet/SheetCell" {
     export const resolveCellModifiers: (update: ICell.Update, options: SheetCellOptions, optionsFromString?: ICell.ModifiersFromStringOptions, resolvedStringCache?: Map<string, ICell.Modifiers>, // assumes the same fromStringOptions is used
     isParsingCustom?: boolean) => ResolvedCellModifiers;
     export const csOverflowable: (type: ScalarType, style: IStyle, prev?: boolean, next?: boolean) => boolean;
+    /**
+     * Updates the overflow calc and returns a range if overflowed
+     * @internal
+     */
+    export const calcTextOverflow: (rowIndex: number, colIndex: number, type: ScalarType, style: IStyle, value: Scalar, prev: IRange.CellCoords, next: IRange.CellCoords, continuousCoords: IRange.Coords, cellOptions: SheetCellOptions) => ICell.HorizontalOverflow | null;
     /** Guaranteed to never return null */
-    export const csStyle: (specific: boolean, range: IRange.Coords, rs: RangeState.Intersection, options: SheetCellOptions) => IStyle;
+    export const csStyle: (specific: boolean, range: IRange.Coords, intersection: RangeState.Intersection, options: SheetCellOptions) => IStyle;
     export const csBestFit: (type: ScalarType, style: IStyle, value: Scalar, options: SheetCellOptions, colWidth: number, isMinContent: boolean, isRowOnly: boolean, // if true we only measure the height
     customHash?: string, cache?: Cache<string, Readonly<Partial<Dimensions>>>) => Readonly<Partial<Dimensions>>;
     export interface SheetCellOptions {
@@ -17938,7 +17948,7 @@ declare module "sheet/SheetCell" {
         opener(url: string, options: ICellRange.SelectOptions, target?: string, features?: string): Promise<boolean>;
     }
     export class SheetCell implements ICell {
-        protected _rs: RangeState.Intersection;
+        protected _ri: RangeState.Intersection;
         protected _p: IRange.CellCoords;
         protected _n: IRange.CellCoords;
         protected _to: ICell.HorizontalOverflow;
@@ -17948,7 +17958,7 @@ declare module "sheet/SheetCell" {
         protected _v: Scalar;
         protected _styleSpecific: IStyle;
         protected _styleConditional: IStyle;
-        constructor(options: SheetCellOptions, coords: IRange.CellCoords, type?: ScalarType, value?: Scalar, rs?: RangeState.Intersection, p?: IRange.CellCoords, // prev
+        constructor(options: SheetCellOptions, coords: IRange.CellCoords, type?: ScalarType, value?: Scalar, intersection?: RangeState.Intersection, p?: IRange.CellCoords, // prev
         n?: IRange.CellCoords);
         /** {@inheritDoc ICell.getRange} */
         getRange(): ICellRange;
@@ -19618,7 +19628,7 @@ declare module "license/LicenseManager" {
          * @param force If set to `true` will replace an existing key.
          *
          * @see
-         * {@link https://www.sheetxl.com/docs/getting-started/license-key | License Keys}
+         * {@link https://www.sheetxl.com/docs/guides/getting-started/license-key | License Keys}
          */
         setLicenseKey(licenseKey: string, force?: boolean): Promise<LicenseDetails>;
         private _validate;
@@ -19661,7 +19671,7 @@ declare module "license/LicenseManager" {
     /**
      * LicenseManager is used to manage license keys at runtime.
      *
-     * License keys can be generated by visiting {@link https://www.sheetxl.com/docs/getting-started/license-key | License Keys}.
+     * License keys can be generated by visiting {@link https://www.sheetxl.com/docs/guides/getting-started/license-key | License Keys}.
      */
     const LicenseManager: LM;
     export default LicenseManager;
@@ -32398,6 +32408,17 @@ declare module "sheet/Sheet" {
             reverse?: boolean;
         };
     }
+    interface ViewEdgeEntry {
+        rowIndex: number;
+        colIndex: number;
+        continuous: IProperties.ICellRanged<IStyle.Properties> | null;
+        leftIndex: number;
+        rightIndex: number;
+        overflow: ICell.HorizontalOverflow | null;
+        intersection: RangeState.Intersection;
+        scalar: Scalar | null;
+        style: IStyle;
+    }
     interface State {
         cellValuesGrid: ISparseGrid<Scalar>;
         contentfulSpatial: ISpatialMap<ContentfulEntry>;
@@ -32612,6 +32633,17 @@ declare module "sheet/Sheet" {
          * @internal
          */
         protected _rangeStateIterator(options: RangeState.IteratorOptions): RangeState.Iterator;
+        /**
+         * iterator for overlaps and stops.
+         *
+         * @param view
+         *
+         * @internal
+         */
+        protected _overflowAndStops(bounds: IRange.Coords, maxDistance?: number): {
+            overflows: ViewEdgeEntry[];
+            stops: ViewEdgeEntry[];
+        };
         /**
          * Creates a an iterator that combines the values and ranges into a single iterator.
          * @internal