@sheetxl/sdk 0.4.22 → 0.5.0

package/types/scripting.d.ts

@@ -1464,16 +1464,16 @@ declare module "type/ICollection" {
     /**
      * Interface used for all ICollections.
      */
-    export interface ICollection {
+    export interface ICollection<T, O = ICollection.GetItemsOptions> {
         /**
-         * Return the items at the index.
-         * @param index
+         * Returns the items in the collection.
          */
+        getItems(options?: ICollection.GetItemsOptions): T[];
         /**
          * Returns the total items available.
          *
          * @remarks
-         * Useful as a quick escape for search.
+         * Useful as a quick escape for getItems.
          */
         getCount(): number;
     }
@@ -1485,6 +1485,14 @@ declare module "type/ICollection" {
      * {@link ICollection}
      */
     export namespace ICollection {
+        /**
+         * Options for getting items from the collection.
+         *
+         * @remarks
+         * This placeholder is extended by implementations of ICollection
+         */
+        interface GetItemsOptions {
+        }
         /**
          * Collection that can be persisted.
          */
@@ -1538,13 +1546,13 @@ declare module "type/ICollection" {
             /**
              * Called when collections have changes.
              */
-            onCollectionChange?(source: ICollection): void;
+            onCollectionChange?(source: ICollection<any>): void;
             /**
              * Called when the collection has been updated due to a undo/redo and a rerender is required.
              */
-            onInvalidated?(source: ICollection): void;
+            onInvalidated?(source: ICollection<any>): void;
         }
-        interface IListeners extends IListener.Callbacks<ICollection, ICollection.Events> {
+        interface IListeners extends IListener.Callbacks<ICollection<any>, ICollection.Events> {
         }
     }
 }
@@ -2187,7 +2195,7 @@ declare module "resource/IResourceCollection" {
     /**
      * Collections of {@link IResource}.
      */
-    export interface IResourceCollection extends ICollection {
+    export interface IResourceCollection extends ICollection<IResource> {
         /**
          * Add a resource to a collection with an initial reference.
          * @param resource
@@ -2195,6 +2203,11 @@ declare module "resource/IResourceCollection" {
          * Resources are not removed from the the collection. They are autoGCed when there are no references.
          */
         add(resource: string | IResource | IResourceCollection.AddOptions): IResource;
+        /**
+         * Returns a list of all resources in the collection.
+         * @param options
+         */
+        getItems(options?: ICollection.GetItemsOptions): IResource[];
         /**
          * Used for saving resource. Returns a visitor that will allow for a toJSON that
          * will only save the resource that were accessed within the persist scope.
@@ -2234,6 +2247,8 @@ declare module "resource/IResourceCollection" {
              */
             name?: string;
         }
+        interface GetItemsOptions extends ICollection.GetItemsOptions {
+        }
         interface IPersistScope<J extends IResource.JSON> {
             /**
              * For a resource this will return a number that can be used to reference the resource in the persisted json.
@@ -2307,6 +2322,8 @@ declare module "resource/ResourceCollection" {
         constructor();
         /** {@inheritDoc IResourceCollection.add} */
         add(res: string | IResource | IResourceCollection.AddOptions): IResource;
+        /** {@inheritDoc IResourceCollection.getItems} */
+        getItems(options?: IResourceCollection.GetItemsOptions): IResource[];
         /** {@inheritDoc IResourceCollection.getCount} */
         getCount(): number;
         /** {@inheritDoc IResourceCollection.beginPersist} */
@@ -7670,7 +7687,7 @@ declare module "theme/IThemeCollection" {
     /**
      * A collection of themes.
      */
-    export interface IThemeCollection extends ICollection {
+    export interface IThemeCollection extends ICollection<ITheme> {
         /**
          * Add or update a theme.
          *
@@ -7692,15 +7709,15 @@ declare module "theme/IThemeCollection" {
          */
         getByName(name: string): ITheme | null;
         /**
-         * Returns all themes that match the search criteria.
+         * Returns all themes that match the filter criteria.
          *
-         * @param options {@link IThemeCollection.SearchOptions}
+         * @param options {@link IThemeCollection.GetItemsOptions}
          *
          * @remarks
-         * * If no search criteria is provided, all items will be returned.
+         * * If no filter criteria is provided, all items will be returned.
          * * Generates a new array so this can be mutated without affecting the internal state.
          */
-        search(options?: IThemeCollection.SearchOptions): ITheme[];
+        getItems(options?: IThemeCollection.GetItemsOptions): ITheme[];
         /**
          * Remove a custom theme.
          *
@@ -7731,22 +7748,22 @@ declare module "theme/IThemeCollection" {
      */
     export namespace IThemeCollection {
         type JSON = ITheme.JSON[];
-        interface SearchOptions {
+        interface GetItemsOptions extends ICollection.GetItemsOptions {
             /**
-             * @defaultValue `IThemeCollection.BuiltInSearchType.All`
+             * @defaultValue `IThemeCollection.BuiltInFilterType.All`
              */
-            type?: BuiltInSearchType;
+            type?: BuiltInFilterType;
             /**
-             * Allows for the search to return a specific theme even if not in the list.
+             * Allows for the filter to return a specific theme even if not in the list.
              */
             selected?: ITheme;
         }
-        const BuiltInSearchType: {
+        const BuiltInFilterType: {
             readonly BuiltIn: "builtIn";
             readonly All: "all";
             readonly Custom: "custom";
         };
-        type BuiltInSearchType = typeof BuiltInSearchType[keyof typeof BuiltInSearchType];
+        type BuiltInFilterType = typeof BuiltInFilterType[keyof typeof BuiltInFilterType];
     }
 }
 declare module "theme/_BuiltInColorSchemes" {
@@ -7809,7 +7826,8 @@ declare module "theme/ThemeCollection" {
         setDefaultTheme(theme: ITheme): ITheme;
         /** {@inheritDoc IThemeCollection.getByName} */
         getByName(name: string): ITheme | null;
-        search(options?: IThemeCollection.SearchOptions): ITheme[];
+        /** {@inheritDoc IThemeCollection.getByName} */
+        getItems(options?: IThemeCollection.GetItemsOptions): ITheme[];
         /** {@inheritDoc IThemeCollection.getCount} */
         getCount(): number;
         /** {@inheritDoc IThemeCollection.setCustomTheme} */
@@ -8420,7 +8438,7 @@ declare module "named/INamedCollection" {
     /**
      * A collection of `INamed` items.
      */
-    export interface INamedCollection extends ICollection {
+    export interface INamedCollection extends ICollection<INamed> {
         /**
          * Add a named reference.
          *
@@ -8443,10 +8461,10 @@ declare module "named/INamedCollection" {
          */
         add(named: INamed): INamed;
         /**
-         * Search the named items.
+         * Return the named items.
          * These are sorted by type then by name.
          */
-        search(options?: INamedCollection.SearchOptions): INamed[];
+        getItems(options?: INamedCollection.GetItemsOptions): INamed[];
         /**
          * Lookup a named range with a given name.
          *
@@ -8458,7 +8476,7 @@ declare module "named/INamedCollection" {
          * Lookup a named range by WorkbookRangeCoords. This will only
          * return a match if all the ranges are exact matches.
          *
-         * @deprecated Use search({ address }) instead.
+         * @deprecated Use getItems({ address }) instead.
          */
         lookupByRanges(ranges: ICellRanges.Address): INamed[] | null;
         /**
@@ -8538,7 +8556,7 @@ declare module "named/INamedCollection" {
         }
         interface IListeners extends IListener.Callbacks<INamedCollection, INamedCollection.Events> {
         }
-        interface SearchOptions {
+        interface GetItemsOptions extends ICollection.GetItemsOptions {
             /**
              * A string indicating the type.
              */
@@ -8600,7 +8618,7 @@ declare module "table/ITableCollection" {
     /**
      * Holds a collection of {@link ITable}s.
      */
-    export interface ITableCollection extends ICollection {
+    export interface ITableCollection extends ICollection<ITable> {
         /**
          * Add an `ITable` to the container.
          *
@@ -8609,18 +8627,18 @@ declare module "table/ITableCollection" {
          */
         add(address: ICellRange.Address, options?: ITableCollection.AddOptions): ITable;
         /**
-         * Returns items that match the search criteria.
+         * Returns items that match the filter criteria.
          *
-         * If no search criteria is provided, all items will be returned.
+         * If no filter criteria is provided, all items will be returned.
          *
-         * @param options {@link ITableCollection.SearchOptions}
+         * @param options {@link ITableCollection.GetItemsOptions}
          */
-        search(options?: ITableCollection.SearchOptions): ITable[];
+        getItems(options?: ITableCollection.GetItemsOptions): ITable[];
         /**
-         * Convenience method for searching by name. This is
-         * functionally equivalent to search({ name });
+         * Convenience method for filter by name. This is
+         * functionally equivalent to getItems({ name });
          *
-         * @param name The name to search for This is case insensitive.
+         * @param name The name to filter for This is case insensitive.
          */
         getByName(name: string): ITable | null;
     }
@@ -8664,9 +8682,9 @@ declare module "table/ITableCollection" {
              */
             isLoad?: boolean;
         }
-        interface SearchOptions {
+        interface GetItemsOptions {
             /**
-             * If provided, the search will be limited to items that intersect the range.
+             * If provided, the filter will be limited to items that intersect the range.
             */
             address?: ICellRange.Address;
             /**
@@ -8676,13 +8694,13 @@ declare module "table/ITableCollection" {
              */
             excludeHidden?: boolean;
             /**
-             * Only return items that are completely contained with the search bounds.
+             * Only return items that are completely contained with the filter bounds.
              *
              * @defaultValue false
              */
             fullyContained?: boolean;
             /**
-             * Search with the given name. This is case insensitive.
+             * Filter with the given name. This is case insensitive.
              */
             name?: string;
         }
@@ -9403,7 +9421,7 @@ declare module "string/IStringCollection" {
     /**
      * Contains a collection of interned strings.
      */
-    export interface IStringCollection extends ICollection, ICollection.IPersistable {
+    export interface IStringCollection extends ICollection<string>, ICollection.IPersistable {
         /**
          * Add a string to the collection.
          *
@@ -9440,6 +9458,9 @@ declare module "string/IStringCollection" {
      * {@link IStringCollection}
      */
     export namespace IStringCollection {
+        interface GetItemsOptions extends ICollection.GetItemsOptions {
+            id?: number;
+        }
         /**
          * Alias for persist type of `string`.
          */
@@ -9461,6 +9482,8 @@ declare module "string/StringCollection" {
         addMultiple(shared: string[], conflateDuplicates?: boolean): void;
         /** {@inheritDoc IStringCollection.add} */
         add(shared: string): number;
+        /** {@inheritDoc IStringCollection.getItems} */
+        getItems(options?: IStringCollection.GetItemsOptions): string[];
         /** {@inheritDoc IStringCollection.getById} */
         getById(id: number): string;
         /** {@inheritDoc ICollection.getCount} */
@@ -9480,7 +9503,7 @@ declare module "script/IFunctionCollection" {
     /**
      * Collections of {@link IFunction}.
      */
-    export interface IFunctionCollection extends ICollection {
+    export interface IFunctionCollection extends ICollection<IFunction> {
         /**
          * Add a custom function to a collection.
          *
@@ -9488,16 +9511,16 @@ declare module "script/IFunctionCollection" {
          */
         add(options: IFunction | IFunctionCollection.AddOptions): IFunction;
         /**
-         * Returns functions that match the search criteria.
+         * Returns functions that match the filter criteria.
          *
-         * If no search criteria is provided, all items will be returned.
+         * If no filter criteria is provided, all items will be returned.
          *
-         * @param options {@link IFunctionCollection.SearchOptions}
+         * @param options {@link IFunctionCollection.GetItemsOptions}
          */
-        search(options?: IFunctionCollection.SearchOptions): IFunction[];
+        getItems(options?: IFunctionCollection.GetItemsOptions): IFunction[];
         /**
-         * Convenience method for searching by name.
-         * This is functionally equivalent to search({ name });
+         * Convenience method for filter by name.
+         * This is functionally equivalent to getItems({ name });
          *
          * @param name The name to search for This is case insensitive.
          */
@@ -9514,7 +9537,7 @@ declare module "script/IFunctionCollection" {
         /**
          * Options for searching a function in the collection.
          */
-        interface SearchOptions {
+        interface GetItemsOptions {
             /**
              * Search with the given name. This is case insensitive.
              */
@@ -9645,7 +9668,7 @@ declare module "script/IModuleCollection" {
     /**
      * Represents a collection of functions. This is analogous to a file.
      */
-    export interface IModuleCollection extends ICollection {
+    export interface IModuleCollection extends ICollection<IModule> {
         /**
          * Adds the module to the collection.
          *
@@ -9655,16 +9678,16 @@ declare module "script/IModuleCollection" {
          */
         add(uid: string, module: IModule, options?: IModuleCollection.AddOptions): void;
         /**
-         * Returns functions that match the search criteria.
+         * Returns functions that match the filter criteria.
          *
-         * If no search criteria is provided, all items will be returned.
+         * If no filter criteria is provided, all items will be returned.
          *
-         * @param options {@link IModuleCollection.SearchOptions}
+         * @param options {@link IModuleCollection.GetItemsOptions}
          */
-        search(options?: IModuleCollection.SearchOptions): IModule[];
+        getItems(options?: IModuleCollection.GetItemsOptions): IModule[];
         /**
-         * Convenience method for searching by name.
-         * This is functionally equivalent to search({ name });
+         * Convenience method for filtering by name.
+         * This is functionally equivalent to getItems({ name });
          *
          * @param name The name to search for This is case insensitive.
          */
@@ -9693,9 +9716,9 @@ declare module "script/IModuleCollection" {
             ignoreErrors?: boolean;
         }
         /**
-       * Options for searching a function in the collection.
+       * Options for filtering a function in the collection.
        */
-        interface SearchOptions {
+        interface GetItemsOptions extends ICollection.GetItemsOptions {
             /**
              * Search with the given name. This is case insensitive.
              */
@@ -14929,7 +14952,7 @@ declare module "conditional/IConditionalFormatCollection" {
     /**
      * Holds a collection of {@link IConditionalFormat}s.
      */
-    export interface IConditionalFormatCollection extends ICollection {
+    export interface IConditionalFormatCollection extends ICollection<IConditionalFormat> {
         /**
          * Add an `IConditional` to the container.
          *
@@ -14938,21 +14961,13 @@ declare module "conditional/IConditionalFormatCollection" {
          */
         add(address: ICellRanges.Address, options: IConditionalFormatCollection.AddOptions): IConditionalFormat;
         /**
-         * Returns items that match the search criteria.
+         * Returns items that match the filter criteria.
          *
-         * If no search criteria is provided, all items will be returned.
+         * If no filter criteria is provided, all items will be returned.
          *
-         * @param options {@link IConditionalFormatCollection.SearchOptions}
+         * @param options {@link IConditionalFormatCollection.GetItemsOptions}
          */
-        search(options?: IConditionalFormatCollection.SearchOptions): IConditionalFormat[];
-        /**
-         * Convenience method for searching by name. This is
-         * functionally equivalent to search({ name });
-         *
-         * @param name The name to search for This is case insensitive.
-         */
-        /** {@inheritDoc ICollection.getCount} */
-        getCount(): number;
+        getItems(options?: IConditionalFormatCollection.GetItemsOptions): IConditionalFormat[];
     }
     /**
      * {@inheritDoc IConditionalFormatCollection}
@@ -14970,7 +14985,7 @@ declare module "conditional/IConditionalFormatCollection" {
         /**
          * Options for searching for {@link IConditionalFormat}s.
          */
-        interface SearchOptions {
+        interface GetItemsOptions extends ICollection.GetItemsOptions {
             /**
              * If provided, the search will be limited to items that intersect the range.
             */
@@ -16860,6 +16875,7 @@ declare module "sheet/_SheetTypes" {
             bounds?: IRange.Coords;
             includeRangeTypes: boolean | SearchTypes;
             excludeHidden?: boolean | IRange.Orientation;
+            includeMergeOverflow?: boolean;
         }
         interface Entry {
             /**
@@ -16997,25 +17013,19 @@ declare module "sheet/_SheetTypes" {
 }
 declare module "sheet/spatial/MergeEntry" {
     import { Scalar, IRange } from '@sheetxl/primitives';
-    import { RangeState } from "sheet/_SheetTypes";
     /**
      * MergeEntry
      */
     export class MergeEntry {
         private _c;
         private _tvTl;
-        private _rsTl;
-        constructor(coords: IRange.Coords, tvTl?: (coords: IRange.Coords) => Scalar | null, rsTl?: (coords: IRange.Coords) => RangeState.Intersection | null);
+        constructor(coords: IRange.Coords, tvTl?: (coords: IRange.Coords) => Scalar | null);
         /**
          * The cell value at the top left.
          * We track this because we want a quick way to access
          * the coords state during overflow scenarios.
          */
         tvTl(): Scalar | null;
-        /**
-         * The range state at the top left.
-         */
-        rsTl(): RangeState.Intersection | null;
         getCoords(): IRange.Coords;
     }
 }
@@ -23804,7 +23814,6 @@ declare module "script/_FunctionMessages" {
 }
 declare module "script/FunctionCollection" {
     import type { IFunction, IFormulaContext } from '@sheetxl/primitives';
-    import type { ICollection } from "type/index";
     import { type ITransaction } from "transaction/index";
     import type { IListener } from "listener/index";
     import { ListenerEmitter } from "listener/ListenerEmitter";
@@ -23812,7 +23821,7 @@ declare module "script/FunctionCollection" {
     /**
      * Implementation for `IFunctionCollection`.
      */
-    export class FunctionCollection implements IFunctionCollection, ICollection {
+    export class FunctionCollection implements IFunctionCollection {
         protected _emitter: ListenerEmitter<this, IFunctionCollection.IListeners>;
         private _options;
         private _readonly;
@@ -23820,8 +23829,8 @@ declare module "script/FunctionCollection" {
         private _transactionsRemoveListener;
         private _closed;
         constructor(options: ConstructorOptions);
-        /** {@inheritDoc IFunctionCollection.search} */
-        search(options?: IFunctionCollection.SearchOptions): IFunction[];
+        /** {@inheritDoc IFunctionCollection.getItems} */
+        getItems(options?: IFunctionCollection.GetItemsOptions): IFunction[];
         /** {@inheritDoc IFunctionCollection.getByName} */
         getByName(name: string): IFunction | null;
         /** {@inheritDoc ICollection.getCount} */
@@ -28567,7 +28576,7 @@ declare module "movable/IMovableCollection" {
     /**
      * Holds a collection of IMovables.
      */
-    export interface IMovableCollection extends ICollection, IListener.ISource<IMovableCollection> {
+    export interface IMovableCollection extends ICollection<IMovable>, IListener.ISource<IMovableCollection> {
         /**
          * Add a resource to the movable collection.
          *
@@ -28576,15 +28585,15 @@ declare module "movable/IMovableCollection" {
          */
         add(options?: IMovableCollection.AddOptions): Promise<IMovable>;
         /**
-         * Returns movables that match the search criteria.
+         * Returns movables that match the filter criteria.
          *
-         * @param options {@link IMovableCollection.SearchOptions}
+         * @param options {@link IMovableCollection.GetItemsOptions}
          * @returns An Array of {@link IMovable}.
          *
          * @remarks
-         * If no search criteria is provided, all items will be returned.
+         * If no filter criteria is provided, all items will be returned.
          */
-        search(options?: IMovableCollection.SearchOptions): IMovable[];
+        getItems(options?: IMovableCollection.GetItemsOptions): IMovable[];
         /**
          * Update all of the selected movable in a single transaction
          */
@@ -28615,9 +28624,9 @@ declare module "movable/IMovableCollection" {
      */
     export namespace IMovableCollection {
         /**
-         * Options for searching a collection of movables.
+         * Options for filtering a collection of movables.
          */
-        interface SearchOptions {
+        interface GetItemsOptions extends ICollection.GetItemsOptions {
             /**
              * If provided, the search will be limited to items that intersect the range.
              * @remarks
@@ -29574,27 +29583,27 @@ declare module "sheet/ISheetCollection" {
     /**
      * Holds a collection of {@link ISheet}s.
      */
-    export interface ISheetCollection extends ICollection {
+    export interface ISheetCollection extends ICollection<ISheet> {
         /**
          * Add an `ISheet` to the collection.
          */
         add(options?: ISheetCollection.AddOptions): ISheet;
         /**
-         * Returns sheets that match the search criteria.
+         * Returns sheets that match the filter criteria.
          *
-         * If no search criteria is provided, all sheets will be returned.
+         * If no filter criteria is provided, all sheets will be returned.
          *
-         * @param options {@link ISheetCollection.SearchOptions}
+         * @param options {@link ISheetCollection.GetItemsOptions}
          */
-        search(options?: ISheetCollection.SearchOptions): ISheet[];
+        getItems(options?: ISheetCollection.GetItemsOptions): ISheet[];
         /**
          * Returns the sheet at the given index.
          * @param index
          * @returns
          */
         /**
-         * Convenience method for searching by name. This is
-         * functionally equivalent to search({ name });
+         * Convenience method for filtering by name. This is
+         * functionally equivalent to getItems({ name });
          *
          * @param name The name to search for This is case insensitive.
          */
@@ -29624,7 +29633,7 @@ declare module "sheet/ISheetCollection" {
              */
             index?: number;
         }
-        interface SearchOptions {
+        interface GetItemsOptions extends ICollection.GetItemsOptions {
             /**
              * Indicate if items that are in hidden headers or marked as hidden should be returned.
              * @defaultValue false
@@ -29860,16 +29869,16 @@ declare module "movable/MovableCollection" {
     import { IMovableCollection } from "movable/IMovableCollection";
     export class MovableCollection implements IMovableCollection {
         private _add;
-        private _search;
+        private _getItems;
         private _getCount;
         private _updateSelected;
         private _addListeners;
         private _addImage;
-        constructor(add: (options?: IMovableCollection.AddOptions) => Promise<IMovable>, search: (options?: IMovableCollection.SearchOptions) => IMovable[], getCount: () => number, updateSelected: (update: (movable: IMovable) => void, action?: string) => void, addListeners: (listeners: ICollection.IListeners, options?: IListener.Options) => IListener.Remove, addImage: (image: string | IResource | IResourceCollection.AddOptions, options?: IMovableCollection.AddOptions) => Promise<IMovable>);
+        constructor(add: (options?: IMovableCollection.AddOptions) => Promise<IMovable>, getItems: (options?: IMovableCollection.GetItemsOptions) => IMovable[], getCount: () => number, updateSelected: (update: (movable: IMovable) => void, action?: string) => void, addListeners: (listeners: ICollection.IListeners, options?: IListener.Options) => IListener.Remove, addImage: (image: string | IResource | IResourceCollection.AddOptions, options?: IMovableCollection.AddOptions) => Promise<IMovable>);
         /** {@inheritDoc IMovableCollection.add} */
         add(options?: IMovableCollection.AddOptions): Promise<IMovable>;
-        /** {@inheritDoc IMovableCollection.search} */
-        search(options?: IMovableCollection.SearchOptions): IMovable[];
+        /** {@inheritDoc IMovableCollection.getItems} */
+        getItems(options?: IMovableCollection.GetItemsOptions): IMovable[];
         /** {@inheritDoc IMovableCollection.getCount} */
         getCount(): number;
         /** {@inheritDoc IMovableCollection.updateSelected} */
@@ -29929,7 +29938,6 @@ declare module "named/_NamedMessages" {
     export const ERROR_NAME_DOES_NOT_EXIST: (name: string) => string;
 }
 declare module "named/NamedCollection" {
-    import { ICollection } from "type/index";
     import { ITransaction } from "transaction/index";
     import { IListener } from "listener/index";
     import { ICellRanges } from "cellRange/index";
@@ -29940,7 +29948,7 @@ declare module "named/NamedCollection" {
     /**
      * Implementation for `INamedCollection`.
      */
-    export class NamedCollection implements INamedCollection, ICollection {
+    export class NamedCollection implements INamedCollection {
         protected _emitter: ListenerEmitter<this, INamedCollection.IListeners>;
         private _options;
         private _transactions;
@@ -29952,8 +29960,8 @@ declare module "named/NamedCollection" {
         private _lastLookupType;
         private _allowExtrudes;
         constructor(options: INamedCollection.ConstructorOptions);
-        /** {@inheritDoc INamedCollection.search} */
-        search(options?: INamedCollection.SearchOptions): INamed[];
+        /** {@inheritDoc INamedCollection.getItems} */
+        getItems(options?: INamedCollection.GetItemsOptions): INamed[];
         /** {@inheritDoc INamedCollection.lookupByRanges} */
         lookupByRanges(address: ICellRanges.Address): INamed[] | null;
         /** {@inheritDoc INamedCollection.getByName} */
@@ -30863,9 +30871,13 @@ declare module "table/TableCollection" {
         private _get;
         private _getByName;
         constructor(add: (address: ICellRange.Address, options: ITableCollection.AddOptions) => ITable, get: (address: ICellRanges.Address, excludeHidden: boolean, fullyContained: boolean) => ITable[], getByName: (name: string) => ITable);
+        /** {@inheritDoc ITableCollection.add} */
         add(address: ICellRange.Address, options?: ITableCollection.AddOptions): ITable;
-        search(options?: ITableCollection.SearchOptions): ITable[];
+        /** {@inheritDoc ITableCollection.getItems} */
+        getItems(options?: ITableCollection.GetItemsOptions): ITable[];
+        /** {@inheritDoc ITableCollection.getByName} */
         getByName(name: string): ITable;
+        /** {@inheritDoc ITableCollection.getCount} */
         getCount(): number;
     }
 }
@@ -31125,8 +31137,11 @@ declare module "conditional/ConditionalFormatCollection" {
         private _add;
         private _get;
         constructor(add: (address: ICellRange.Address, options: IConditionalFormatCollection.AddOptions) => IConditionalFormat, get: (address: ICellRanges.Address, excludeHidden: boolean, fullyContained: boolean) => IConditionalFormat[]);
+        /** {@inheritDoc IConditionalFormatCollection.add} */
         add(address: ICellRange.Address, options?: IConditionalFormatCollection.AddOptions): IConditionalFormat;
-        search(options?: IConditionalFormatCollection.SearchOptions): IConditionalFormat[];
+        /** {@inheritDoc IConditionalFormatCollection.getItems} */
+        getItems(options?: IConditionalFormatCollection.GetItemsOptions): IConditionalFormat[];
+        /** {@inheritDoc IConditionalFormatCollection.getCount} */
         getCount(): number;
     }
 }
@@ -32402,6 +32417,10 @@ declare module "sheet/Sheet" {
         listeners?: Map<number, BeforeAfterRange>;
         /** If `true` then don't do protection check. (For example load or range listeners) */
         skipProtectionCheck?: boolean;
+        /**
+         * We update values (cache, potentially styling, as a result of calculations)
+         */
+        calculationSideEffect?: boolean;
     }
     /**
      * Base implementation of {@link ISheet}.
@@ -32750,7 +32769,7 @@ declare module "sheet/Sheet" {
         /** {@inheritDoc ISheet.getStrings} */
         getStrings(): IStringCollection;
         /** @internal */
-        protected _searchMovables(options?: IMovableCollection.SearchOptions): IMovable[];
+        protected _searchMovables(options?: IMovableCollection.GetItemsOptions): IMovable[];
         /** @internal */
         protected _updateSelectedMovables(update: (movable: IMovable) => void, action?: string): void;
         /** @internal */
@@ -33568,7 +33587,6 @@ declare module "workbook/IWorkbook" {
     }
 }
 declare module "script/ModuleCollection" {
-    import type { ICollection } from "type/index";
     import { type ITransaction } from "transaction/index";
     import type { IListener } from "listener/index";
     import { ListenerEmitter } from "listener/ListenerEmitter";
@@ -33577,7 +33595,7 @@ declare module "script/ModuleCollection" {
     /**
      * Implementation for `IModuleCollection`.
      */
-    export class ModuleCollection implements IModuleCollection, ICollection {
+    export class ModuleCollection implements IModuleCollection {
         protected _emitter: ListenerEmitter<this, IModuleCollection.IListeners>;
         private _options;
         private _transactions;
@@ -33586,8 +33604,8 @@ declare module "script/ModuleCollection" {
         constructor(options: ModuleCollection.ConstructorOptions);
         /** {@inheritDoc IModuleCollection.add} */
         add(uid: string, module: IModule, options?: IModuleCollection.AddOptions): void;
-        /** {@inheritDoc IModuleCollection.search} */
-        search(options?: IModuleCollection.SearchOptions): IModule[];
+        /** {@inheritDoc IModuleCollection.getItems} */
+        getItems(options?: IModuleCollection.GetItemsOptions): IModule[];
         /** {@inheritDoc IModuleCollection.getByName} */
         getByName(name: string): IModule | null;
         /** {@inheritDoc ICollection.getCount} */
@@ -33757,9 +33775,13 @@ declare module "sheet/SheetCollection" {
         private _add;
         private _get;
         constructor(add: (options: ISheetCollection.AddOptions) => ISheet, get: (name?: string, visibility?: ISheet.Visibility) => ISheet[]);
+        /** {@inheritDoc ISheetCollection.add} */
         add(options?: ISheetCollection.AddOptions): ISheet;
-        search(options?: ISheetCollection.SearchOptions): ISheet[];
+        /** {@inheritDoc ISheetCollection.getItems} */
+        getItems(options?: ISheetCollection.GetItemsOptions): ISheet[];
+        /** {@inheritDoc ISheetCollection.getByName} */
         getByName(name: string): ISheet;
+        /** {@inheritDoc ISheetCollection.getCount} */
         getCount(): number;
     }
 }