@sheetxl/sdk 0.7.21 → 0.7.23-beta.2

package/types/src/calculation/grid/ICalcGrid.d.ts

@@ -0,0 +1,500 @@
+import { Scalar, IRange, FormulaError } from '@sheetxl/primitives';
+import { ReferenceableClipboard } from '@sheetxl/utils';
+import { ITypes } from '../../type';
+import { IListener } from '../../listener';
+import { IHistory } from '../../history';
+import { ISpatialQuery, ISpatialMap, ISparseGrid, Tuple } from '../../collections';
+import { IFormulaBlock } from '../formula';
+import { ContentfulSpatialValue, SpillEntry } from '../spatial';
+import { ReferenceCoords, NamedReference } from '../Types';
+import { ICalculation } from '../ICalculation';
+/**
+ * The CalcGrid holds input and outputs of in a 2D space to a scope (usually a sheet).
+ *
+ * @remarks
+ * If inputValues are externally managed then formulas update must also be provided.
+ */
+export interface ICalcGrid {
+    /**
+     * Set a group of cells and formula ranges.
+     *
+     * @param values A set of input values as BoundedTuples
+     * @param ranges A set of formula strings as ranged entries.
+     */
+    setInputs(values: Tuple.BoundedTuples<Scalar> | null, formulas: readonly ISpatialMap.Entry<string>[] | null): IRange.Coords[];
+    /**
+     * Remove all values within a range.
+     *
+     * @param coords The coordinates to remove.
+     */
+    remove(coords: IRange.Coords): IRange.Coords[];
+    /**
+     * Execute a calculate on a single grid.
+     *
+     * @param full If true, performs a full calculation; otherwise, performs a partial calculation.
+     * @returns A promise that will be resolved when the calculation is completed.
+     *
+     * @remarks
+     * For async functions this will return before they are completed.
+     * This simply calls Calculation.calculate.
+     */
+    calculate(full?: boolean): Promise<ICalculation.Status>;
+    /**
+     * Mark a range invalid. This will call the area to be recalculated on the next calculate call.
+     *
+     * @param coords An array of coordinates.
+     *
+     * @remarks
+     * This allows for incremental dirty updates.
+     */
+    markDirtyRegions(coords: IRange.Coords[]): void;
+    /**
+     * Returns true if there are any dirty regions that need to be calculated.
+     */
+    getDirtyRegions(): ISpatialQuery;
+    /**
+     * Returns the formula block at the given coordinates.
+     *
+     * @param row The row of the cell to evaluate.
+     * @param column The column of the cell to evaluate.
+     */
+    getFormulaBlockAt(row: number, column: number): IFormulaBlock | null;
+    /**
+     * Returns a queryable spatial index of all formulas in the graph.
+     *
+     * @remark
+     * Used by sheet
+     */
+    getFormulas(): ISpatialQuery<IFormulaBlock>;
+    /**
+     * Returns the current values on the grid.
+     */
+    getValues(): ISparseGrid<Scalar>;
+    /**
+     * Shifts all values in the graph in a given direction.
+     *
+     * @param options The options for the shift.
+     */
+    shift(options: ICalcGrid.ShiftOptions): this;
+    /**
+     * Returns a snapshot of the graph that can be used for copying.
+     */
+    getSnapshot(options?: ICalcGrid.GetSnapshotOptions): ICalcGrid.ISnapshot;
+    /**
+     * Autofill the values from a single cell to the entire range.
+     *
+     * @remarks
+     * This is similar to getSnapshot but doesn't return a promise.
+     */
+    autoFill(template: IRange.Coords | string, destination: IRange.Coords | string): this;
+    /**
+     * Returns the dependents for a specific range.
+     *
+     * @param coords The coordinates of the range.
+     *
+     * @remarks
+     * A range a formula resolved at run time — `INDIRECT`, `OFFSET` — is reported like any other,
+     * with the caveat under {@link getDirectPrecedentsAt}.
+     */
+    getDirectDependentsAt(coords: IRange.Coords): IRange.Coords[];
+    /**
+     * Returns the precedents for a specific range.
+     *
+     * @param coords The coordinates of the range.
+     *
+     * @remarks
+     * A range a formula resolved at run time — `INDIRECT`, `OFFSET` — is reported like any other,
+     * but it is not the same KIND of fact and should not be cached as one. A written reference is a
+     * property of the formula's text: true before anything calculates, and unchanged until the text
+     * changes. A resolved one is a record of the last calculation, so it moves when the formula's own
+     * inputs move (`INDIRECT(B1&"!A1")` names a different sheet once `B1` does), and it is absent
+     * entirely for a block that has not been calculated yet.
+     *
+     * Its bounds are also the union of everything the block read, which for a scattered read is wider
+     * than the cells actually touched. Deliberately: over-reporting costs a caller a check that comes
+     * back clean, where under-reporting hands it an incomplete answer that looks complete.
+     */
+    getDirectPrecedentsAt(coords: IRange.Coords): IRange.Coords[];
+    /**
+     * Returns all ranges recursively, including those that depend on it indirectly
+     * through the full calculation chain.
+     *
+     * @remarks
+     * This performs a recursive search downstream to find the total impact of a value change.
+     */
+    getDependentsAt(coords: IRange.Coords): IRange.Coords[];
+    /**
+     * Returns all precedents recursively, including those referenced indirectly
+     * through the full calculation chain.
+     *
+     * @remarks
+     * This performs a recursive search upstream to find all root data sources.
+     */
+    getPrecedentsAt(coords: IRange.Coords): IRange.Coords[];
+    /**
+     * Returns the absolute direct precedents for a formula.
+     *
+     * @param row The row of the cell to evaluate.
+     * @param column The column of the cell to evaluate.
+     * @throws Error if there is not a formula at the coordinates.
+     */
+    getReferencesAt(row: number, column: number): ReferenceCoords[];
+    /**
+     * Sets the reference to an absolute range at a specific cell coordinate.
+     *
+     * @param row The row of the cell to evaluate.
+     * @param column The column of the cell to evaluate.
+     * @param index The index of the evaluation to use from the tokens.
+     * @param precedent The value to set — a {@link IRange.FixableCellCoords} (single cell) collapses an
+     *   existing range to a lone cell; a {@link IRange.FixableCoords} preserves the existing shape. See
+     *   {@link IFormulaBlock.setReferenceAt}.
+     * @throws Error if the cell is not a formula.
+     */
+    setReferenceAt(row: number, column: number, index: number, precedent: IRange.FixableCoords | IRange.FixableCellCoords | NamedReference | FormulaError.Ref): this;
+    /**
+     * Return true if the cell at row column is volatile.
+     *
+     * @param row The row of the cell to evaluate.
+     * @param column The column of the cell to evaluate.
+     *
+     * @remarks
+     *
+     * This is not used internally but is provided to allow api to query.
+     */
+    isVolatileAt(row: number, column: number): boolean;
+    /**
+     * Returns a copy on write clone.
+     *
+     * @param cloneKey A performance optimization that will avoid cloning if the same key is used.
+     *
+     * @remarks
+     * If the same clone key is used then the same instance will be returned.
+     */
+    clone(cloneKey?: any): this;
+    /**
+     * Add Listeners to graph.
+     */
+    addListeners(listeners: ICalcGrid.IListeners, options?: IListener.Options): IListener.Remove;
+    /**
+     * Returns the entire coords for the IGrid
+     */
+    getEntireCoords(): IRange.Coords;
+    /**
+     * Returns the bounding range for the content.
+     *
+     * @remarks
+     * This includes values and formulas.
+     *
+     * @returns `null` if the grid has no content.
+     */
+    getBoundingRange(): IRange.Coords | null;
+    /**
+     * Loads the json into the graph.
+     *
+     * @param json The JSON to load.
+     * @param options {@link ICalcGrid.FromJSONOptions}
+     *
+     * @remarks
+     * This will clear all values and formulas including any pending changes or invalidation.
+     *
+     * @returns `undefined` when the calculation is not ready (the load is deferred until start).
+     */
+    fromJSON(json: ICalcGrid.JSON, options?: ICalcGrid.FromJSONOptions): ICalcGrid.Results | undefined;
+    /**
+     * Returns a JSON representation of the calcGrid.
+     *
+     * @param options The options for the JSON representation.
+     *
+     * @returns `null` if the grid has nothing to persist.
+     */
+    toJSON(options?: ICalcGrid.ToJSONOptions): Promise<ICalcGrid.JSON | null>;
+    /**
+     * Immutable instance id. Used for equality checks.
+     */
+    getId(): string;
+    /**
+     * Returns a record for new incremental updates.
+     *
+     * @remarks
+     * This will create a new record for tracking incremental updates.
+     */
+    beginUpdates(): ICalcGrid.IncrementalUpdates;
+    /**
+     * Remove the grid from the calculation.
+     */
+    delete(): void;
+}
+/**
+ * {@inheritDoc ICalcGrid}
+ *
+ * @see
+ * ### **Interface**
+ *
+ * {@link ICalcGrid}
+ */
+export declare namespace ICalcGrid {
+    interface Results {
+        /**
+         * The id of the calculation that was completed.
+         *
+         * @remarks
+         * * Every calculation will have a unique id so this can be used to track the completion of a calculation.
+         * * If calculations was called but no calculation was performed and event will be fired with the
+         *   previous calcCompleteId.
+         */
+        cycleId: number;
+        /**
+         * When a full calculation is performed removes are not return and the client must clear all caches `true`.
+         *
+         * @defaultValue `false`
+         */
+        isFull?: boolean;
+        /**
+         * The bounds of the result updates including tuples, spills inserts and spills removes.
+         *
+         * @remarks
+         * This will be `null` if no calculation results were updated or if isFull.
+         */
+        bounds?: IRange.Coords | null;
+        /**
+         * The results of the calculation will either be as `Map` or as a `Tuple.BoundedTuples`.
+         *
+         * @see
+         * {@link CalculateOptions.asTuples}
+         */
+        valueInserts?: Tuple.BoundedTuples<Scalar>;
+        /**
+         * Values that have been cleared.
+         */
+        valueRemoves?: IRange.Coords[];
+        /**
+         * Contains any spills that were inserted. The value is the
+         * {@link ITypes.FormulaArrayKind | kind} of the block that produced it.
+         */
+        spillInserts?: ISpatialMap.Entry<ITypes.FormulaArrayKind>[];
+        /**
+         * Contains any spills that were removed.
+         */
+        spillRemoves?: ISpatialMap.Entry[];
+        /**
+         * Formatting updates due to functions.
+         *
+         * @remarks
+         * Formats are not cleared.
+         */
+        formatInserts?: ISpatialMap.Entry<string>[];
+        /**
+         * Contains any errors that were inserted.
+         */
+        errorInserts?: ISpatialMap.Entry<string>[];
+        /**
+         * Contains any error that were removed.
+         */
+        errorRemoves?: ISpatialMap.Entry[];
+        /**
+         * Indicates that a pending status has been added or removed.
+         * A `true` value indicates that the pending status has been added.
+         * A `false` value indicates that the pending status has been removed.
+         *
+         * @remarks
+         * These are guaranteed to not overlap.
+         */
+        pendingUpdates?: ISpatialMap.Entry<boolean>[];
+    }
+    /**
+     * Returns from `ICalcGrid.beginUpdates()`.
+     *
+     * @returns
+     * Contains values that are being calculated but have not yet been committed.
+     */
+    interface IncrementalUpdates {
+        readonly gridId: string;
+        values: ISparseGrid<Scalar>;
+        spillSpatial: ISpatialMap<SpillEntry>;
+        errorSpatial: ISpatialMap<string>;
+        pendingSpatial: ISpatialMap<boolean>;
+        contentfulSpatial: ISpatialMap<ContentfulSpatialValue>;
+        notifyValues: ISpatialMap;
+        notifySpillsInsert: ISpatialMap.Entry<SpillEntry>[];
+        notifySpillsRemove: IRange.Coords[];
+        notifyFormats: ISpatialMap;
+        notifyPending: ISpatialMap<boolean>;
+        pendingConflating: ISpatialMap.IConflatingEntries<boolean> | null;
+        errorRemovesConflating: ISpatialMap.IConflatingEntries<null> | null;
+        errorInsertsConflating: ISpatialMap.IConflatingEntries<string> | null;
+        formatsConflating: ISpatialMap.IConflatingEntries | null;
+        /**
+         * Called when the incremental updates are completed
+         *
+         * @param options
+         *
+         * @remarks
+         * If there are multiple incremental updates for a single calculation then only the last one
+         * will have done called.
+         */
+        done(cycleId: number, options: ICalculation.CalculateOptions): void;
+    }
+    interface GetSnapshotOptions extends ReferenceableClipboard.CopyOptions {
+        /**
+         * The range to capture the snapshot from. If omitted the entire range will be used.
+         */
+        range?: IRange.Coords | string;
+    }
+    /**
+     * Provides destination details for the Snapshot when using `IHistory.ISnapshot.copyTo`.
+     */
+    interface SnapshotDestination {
+        /**
+         * The destination calc graph to copy to.
+         */
+        calcGrid: ICalcGrid;
+        /**
+         * The range to copy the snapshot to.
+         */
+        range: IRange.Coords | string;
+    }
+    interface ISnapshot extends IHistory.ISnapshot<ICalcGrid.SnapshotDestination, ICalcGrid, IRange.Coords> {
+        /**
+         * Called when the table is copied to a new collection.
+         */
+        copyTo(destination: ICalcGrid.SnapshotDestination, options?: ICalcGrid.CopyOptions): Promise<IRange.Coords>;
+    }
+    /**
+     * Options for {@link ISnapshot.copyTo}.
+     */
+    interface CopyOptions extends ReferenceableClipboard.CopyOptions {
+        /**
+         * When pasting from a smaller range to a larger range copy will repeat or 'wallpaper' the
+         * source values.
+         *
+         * @remarks
+         * Note - If the destination range is only a single cell then fitDestination will always be applied.
+         */
+        fitDestination?: boolean;
+        /**
+         * Have the data transposed for the original axis.
+         * @defaultValue false
+         */
+        transpose?: boolean;
+    }
+    interface Error {
+        /**
+         * The error message.
+         */
+        message?: string;
+        /**
+         * Some error types will give an indicate of the range location.
+         */
+        coords?: string[];
+    }
+    /**
+     * Options for shifting the calc graph.
+     */
+    interface ShiftOptions {
+        /**
+         * The range to shift.
+         */
+        range: IRange.Coords;
+        /**
+         * The direction to shift.
+         */
+        direction: IRange.Direction;
+        /**
+         * If `true` the this will return a clone instance of the graph if there are any modifications.
+         *
+         * @defaultValue false
+         *
+         * @remarks
+         * This allows for a 0-1 clone on write.
+         */
+        cloneIfUpdate?: boolean;
+    }
+    /**
+     * Events for {@link ICalcGrid}.
+     */
+    interface Events {
+        /**
+         * Called when the calculation has been updated and a calculation has not been started.
+         */
+        onInvalidate?(source: ICalcGrid): void;
+        /**
+         * Called when a calculation is started.
+         */
+        onStart?(source: ICalcGrid): void;
+        /**
+         * Called when a calculation is completed.
+         */
+        onComplete?(source: ICalcGrid, results: ICalcGrid.Results): void;
+        /**
+         * Called when the calculation engine is unable to calc.
+         *
+         * @remarks
+         * This is not when a specific function fails, but when the calculation engine is unable to complete the calculation.
+         */
+        onError?(source: ICalcGrid): void;
+        /**
+         * Called when the CalcGrid is closed.
+         */
+        onClose?(source: ICalcGrid): void;
+    }
+    interface IListeners extends IListener.Callbacks<ICalcGrid, ICalcGrid.Events> {
+    }
+    interface JSON {
+        /**
+         * The input and calced data.
+         *
+         * @remarks
+         * This is usually empty as the data is managed by the client of the graph.
+         */
+        data?: Tuple.GridTuple<Scalar>;
+        /**
+         * The formulas.
+         */
+        formulas?: IRange.JSONReferenceTuple<string>[];
+        /**
+         * The extent occupied by an array formula, and which of the three
+         * {@link ITypes.FormulaArrayKind | kinds} of array formula it is.
+         *
+         * @remarks
+         * See {@link ISheet.JSON.formulaArray} for what does and does not earn an entry.
+         */
+        formulaArray?: IRange.JSONReferenceTuple<ITypes.FormulaArrayKind>[];
+        /**
+         * Indicates the range contains volatile functions.
+         *
+         * @remarks
+         * For built-in functions volatile will be auto added.
+         */
+        volatile?: IRange.Address[];
+    }
+    /**
+     * Options for {@link ICalcGrid.fromJSON}.
+     */
+    interface FromJSONOptions {
+        /**
+         * A structural transform applied to each formula's parsed tree (pre-link) as it loads —
+         * the READ half of the dialect hook. A format reader (io-xlsx) supplies its legacy unwrap
+         * here; native loads pass nothing.
+         *
+         * @see {@link ICalculation.FormulaTransform}
+         */
+        formulaTransform?: ICalculation.FormulaTransform;
+    }
+    interface ToJSONOptions {
+        /**
+         * If `true` the values will not be included in the JSON.
+         *
+         * @defaultValue `false`
+         */
+        includeData?: boolean;
+        /**
+         * A structural transform applied to each formula as it serializes (once per formula
+         * block, on the compiled AST) — how the xlsx writer applies its legacy spellings
+         * (see io-xlsx `LegacyFormula.ts`).
+         *
+         * @see {@link ICalculation.FormulaTransform}
+         */
+        formulaTransform?: ICalculation.FormulaTransform;
+    }
+}
+//# sourceMappingURL=ICalcGrid.d.ts.map

package/types/src/calculation/grid/ICalcGrid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ICalcGrid.d.ts","sourceRoot":"","sources":["../../../../../src/calculation/grid/ICalcGrid.ts"],"names":[],"mappings":"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"}

package/types/src/calculation/grid/index.d.ts

@@ -0,0 +1,3 @@
+export * from './ICalcGrid';
+export * from './CalcGrid';
+//# sourceMappingURL=index.d.ts.map

package/types/src/calculation/grid/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/calculation/grid/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/types/src/calculation/index.d.ts

@@ -0,0 +1,5 @@
+export * from './ICalculation';
+export * from './INamedFormulasCollection';
+export * from './builtInNames';
+export * from './FormulaLiterals';
+//# sourceMappingURL=index.d.ts.map

package/types/src/calculation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/calculation/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC"}

package/types/src/calculation/spatial/ContentfulSpatialValue.d.ts

@@ -0,0 +1,25 @@
+import { IRange, Scalar } from '@sheetxl/primitives';
+import { Tuple, ISpatialMap } from '../../collections';
+/**
+ * Used for identifying contiguously filled ranges.
+ */
+export declare class ContentfulSpatialValue {
+    private _c;
+    private _a;
+    constructor(coords: IRange.Coords, axis: IRange.Axis);
+    getCoords(): IRange.Coords;
+    getAxis(): IRange.Axis;
+    /** {@inheritDoc ISpatialMap.IUpdatableValue.getShifted} */
+    getShifted(options: ISpatialMap.ShiftDetails<this>): ISpatialMap.Entry<this> | null;
+    /** {@inheritDoc ISpatialMap.IUpdatableValue.getMerged} */
+    getMerged(_other: this, coords: IRange.Coords, _axis: IRange.Axis): this;
+    /** {@inheritDoc ISpatialMap.IUpdatableValue.getSplit} */
+    getSplit(coords: [IRange.Coords, IRange.Coords], _axis: IRange.Axis): [this, this] | undefined;
+    getState(): IRange.Coords;
+}
+/**
+ * Wraps each value in a ContentfulSpatialValue
+ */
+export declare function tuplesToContentfulEntries2(gridTuples: Tuple.GridTuple<Scalar>, scope: string, isColumn: boolean): ISpatialMap.Entry<ContentfulSpatialValue>[];
+export declare function rangeToContentfulEntries(entries: readonly ISpatialMap.Entry[], isColumn: boolean): ISpatialMap.Entry<ContentfulSpatialValue>[];
+//# sourceMappingURL=ContentfulSpatialValue.d.ts.map

package/types/src/calculation/spatial/ContentfulSpatialValue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContentfulSpatialValue.d.ts","sourceRoot":"","sources":["../../../../../src/calculation/spatial/ContentfulSpatialValue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAI1D,OAAO,EAAE,KAAK,KAAK,EAAE,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEjE;;GAEG;AAEH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,EAAE,CAAgB;IAC1B,OAAO,CAAC,EAAE,CAAc;gBAGtB,MAAM,EAAE,MAAM,CAAC,MAAM,EACrB,IAAI,EAAE,MAAM,CAAC,IAAI;IAMnB,SAAS,IAAI,MAAM,CAAC,MAAM;IAI1B,OAAO,IAAI,MAAM,CAAC,IAAI;IAItB,2DAA2D;IAC3D,UAAU,CAAC,OAAO,EAAE,WAAW,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI;IAQnF,0DAA0D;IAC1D,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,GAAG,IAAI;IAUxE,yDAAyD;IACzD,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,SAAS;IAc9F,QAAQ,IAAI,MAAM,CAAC,MAAM;CAQ1B;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,EACnC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,OAAO,GAChB,WAAW,CAAC,KAAK,CAAC,sBAAsB,CAAC,EAAE,CAgC7C;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,SAAS,WAAW,CAAC,KAAK,EAAE,EACrC,QAAQ,EAAE,OAAO,GAChB,WAAW,CAAC,KAAK,CAAC,sBAAsB,CAAC,EAAE,CAe7C"}