@sheetxl/sdk 0.7.21 → 0.7.23-beta.2

package/types/src/condition/ICondition.d.ts.map

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

package/types/src/condition/_ConditionUtils.d.ts

@@ -0,0 +1,190 @@
+import { IRange, InteropScalarType, IRuntime, Scalar } from '@sheetxl/primitives';
+import { RunCoords, MaybePromise } from '@sheetxl/utils';
+import { ISparseGrid } from '../collections';
+import { ICalculation } from '../calculation';
+import { ICondition } from './ICondition';
+export declare class ConditionOperator<P = any> implements ICondition.IOperator<P> {
+    protected _delegate: ICondition.IOperator;
+    protected _types: readonly (InteropScalarType | null)[] | null;
+    constructor(delegate: ICondition.IOperator);
+    /** {@inheritDoc ICondition.getName} */
+    getName(): string;
+    /** {@inheritDoc ICondition.createPredicate} */
+    createPredicate(param: P, ctx: ICondition.IContext): MaybePromise<ICondition.Predicate | null>;
+    /** {@inheritDoc ICondition.getAcceptsTypes} */
+    getAcceptsTypes(): readonly (InteropScalarType | null)[] | null;
+    /** {@inheritDoc ICondition.acceptsList} */
+    acceptsList(): boolean;
+    /** {@inheritDoc ICondition.getParamType} */
+    getParamType(lhsSelector?: ICondition.ISelector): string | null;
+    /** {@inheritDoc ICondition.isCombinator} */
+    isCombinator(): boolean;
+    /** {@inheritDoc ICondition.getTitle} */
+    getTitle(): string | undefined;
+    /** {@inheritDoc ICondition.getDescription} */
+    getDescription(): string | null;
+    /** {@inheritDoc ICondition.createDefaultParam} */
+    createDefaultParam(lhsSelector?: ICondition.ISelector): P | null | undefined;
+    /** {@inheritDoc ICondition.doBatch} */
+    doBatch(keys: Set<any>, param: P, ctx: ICondition.IContext): MaybePromise<IRange<boolean> | null> | undefined;
+    /** {@inheritDoc ICondition.toString} */
+    toString(param: P, lhsSelector?: ICondition.ISelector): string | undefined;
+    get [Symbol.toStringTag](): string;
+}
+/**
+ * Encodes error scalars in a condition param for JSON, using the cell-value spelling
+ * (`{ t: 'e', v: code }` — `Sheet.toJSON`'s convention): an error operand (`cellIs` equal `#N/A`)
+ * must survive the sxl-JSON round trip the same way an error cell value does. Everything else
+ * passes through unchanged (and identity is preserved when nothing encodes).
+ *
+ * Reaches the shapes an error can actually sit in: the Scalar param itself, a between option's
+ * `from`/`to`, and (through `not`'s raw input) a nested condition's param. Combinator children
+ * that are resolved conditions serialize through their own `toJSON`.
+ */
+export declare function encodeParamJSON(param: any): any;
+/**
+ * The inverse of {@link encodeParamJSON}, applied where a param is INSTALLED ({@link resolveInput}):
+ * the marker (and a between option's marked bounds) revive to error instances. Combinator children
+ * are left encoded — they decode when their own input resolves.
+ */
+export declare function decodeParamJSON(param: any): any;
+export declare function resolveInput(condition: ICondition.Input | null): ICondition | null;
+/**
+ * A condition whose selector or operator is not in the registry.
+ *
+ * @remarks
+ * Persistence must never depend on the engine understanding a rule. Rather than take the whole rule
+ * down with it, an unresolvable condition is kept **verbatim** and evaluates to nothing — it
+ * round-trips exactly and starts working the moment the missing name is registered, which is what
+ * makes `Condition.Operators.register` usable after a workbook has already loaded.
+ *
+ * Resolution is retried on each access until it succeeds, then cached.
+ */
+export declare class UnresolvedCondition<P = any> implements ICondition<P> {
+    protected _json: ICondition.JSON<P>;
+    protected _reason: string;
+    protected _resolved: ICondition<P> | null;
+    constructor(json: ICondition.JSON<P>, reason: string);
+    /**
+     * Retries resolution against the current registry.
+     *
+     * @returns The resolved condition, or `null` while a name it needs is still unregistered.
+     */
+    resolve(): ICondition<P> | null;
+    /**
+     * Why the condition could not be resolved.
+     */
+    getUnresolvedReason(): string;
+    /** {@inheritDoc ICondition.getSelector} */
+    getSelector(): ICondition.ISelector | null;
+    /** {@inheritDoc ICondition.getOperator} */
+    getOperator(): ICondition.IOperator | null;
+    /** {@inheritDoc ICondition.getParam} */
+    getParam(): P;
+    /** {@inheritDoc ICondition.isIncludeBlanks} */
+    isIncludeBlanks(): boolean;
+    /** {@inheritDoc ICondition.toString} */
+    toString(): string;
+    /** {@inheritDoc ICondition.toJSON} */
+    toJSON(): ICondition.JSON<P>;
+    /** {@inheritDoc ICondition.isICondition} */
+    get isICondition(): true;
+}
+/**
+ * Resolves a persisted condition. Unlike {@link resolveInput} this never throws.
+ *
+ * @remarks
+ * The load-time counterpart to {@link resolveInput}. A selector or operator the registry does not
+ * know yields an {@link UnresolvedCondition} — inert to evaluate, lossless to serialize — instead
+ * of an exception that costs the caller the entire rule.
+ */
+export declare function fromJSON<P = any>(json: ICondition.JSON<P> | null | undefined): ICondition<P> | null;
+/**
+ * Iterates through all values executing a single condition (`conditions[0]`) and calling the
+ * appropriate callbacks. Used by Data Validation and Conditional Formatting.
+ *
+ * @remarks
+ * For N conditions ANDed per row (`ICellRange.filter` / `ITable.filter`), see
+ * {@link evalRangeConditions}.
+ */
+export declare function evalConditions(options: DoRunConditionsOptions): Promise<void>;
+export interface DoRunRangeConditionsOptions extends ICondition.RangeOptions {
+    runtime: IRuntime;
+    /**
+     * {@inheritDoc DoRunConditionsOptions.calculation}
+     */
+    calculation?: ICalculation | null;
+    /**
+     * Backs {@link ICondition.IContext.watchFormula} — registers a watch for `expression` if the
+     * caller owns one, and returns its delivered values (or `null` until they arrive). Supplied by a
+     * long-lived owner; absent for a one-shot evaluation, which leaves the operator to evaluate for
+     * itself.
+     */
+    watchFormula?: ((expression: string) => MaybePromise<IRange | null>) | null;
+    values: ISparseGrid<Scalar>;
+    coords: Readonly<IRange.Coords>;
+    getHiddenRuns?: (axis: IRange.Axis) => readonly RunCoords[];
+    /**
+     * Called once per contiguous run of rows/columns (per {@link ICondition.RangeOptions.axis})
+     * that remain visible once every condition has been applied, in ascending order.
+     */
+    onVisibleRun?: (run: Readonly<RunCoords>) => void;
+    /**
+     * Called once per contiguous run of rows/columns that end up hidden once every condition has
+     * been applied, in ascending order.
+     */
+    onHiddenRun?: (run: Readonly<RunCoords>) => void;
+}
+/**
+ * Evaluates `conditions[]` in array order against the row (or column) axis, ANDing each condition
+ * into a running visibility mask — Excel's own AutoFilter model (DESIGN-FILTER.md §2): a dynamic
+ * condition (Average, Top N) only ever sees the rows/columns still visible under the mask
+ * accumulated by the conditions *before* it. Each condition carries its column (or row) via
+ * `IndexedProperties.index`, defaulting to its position in `conditions[]` when omitted — mirrors
+ * `ISort.Options.index ?? level`.
+ *
+ * @remarks
+ * Backs `ICellRange.filter` / `ITable.filter` (`_SheetFilterUtils.doFilter`). Data Validation and
+ * Conditional Formatting keep using the single-condition {@link evalConditions}.
+ */
+export declare function evalRangeConditions(options: DoRunRangeConditionsOptions): Promise<void>;
+export interface DoRunConditionsOptions extends ICondition.RangeOptions {
+    runtime: IRuntime;
+    /**
+     * The calculation engine backing {@link ICondition.IContext.createFormula} /
+     * {@link ICondition.IContext.resolveFormula}.
+     *
+     * @remarks
+     * Optional — a caller with no live workbook (e.g. a headless condition eval) simply gets a
+     * context where those two methods return `null` / the value unchanged, same as before either
+     * was implemented. See `ConditionContext.createFormula`.
+     */
+    calculation?: ICalculation | null;
+    /**
+     * Backs {@link ICondition.IContext.watchFormula} — registers a watch for `expression` if the
+     * caller owns one, and returns its delivered values (or `null` until they arrive). Supplied by a
+     * long-lived owner; absent for a one-shot evaluation, which leaves the operator to evaluate for
+     * itself.
+     */
+    watchFormula?: ((expression: string) => MaybePromise<IRange | null>) | null;
+    values: ISparseGrid<Scalar>;
+    coords: Readonly<IRange.Coords>;
+    getHiddenRuns?: (axis: IRange.Axis) => readonly RunCoords[];
+    /**
+     * Called on `true` condition.
+     */
+    onTrue?: (coords: IRange.CellCoords, value: Scalar) => void;
+    /**
+     * Called on `false` condition.
+     */
+    onFalse?: (coords: IRange.CellCoords, value: Scalar) => void;
+    /**
+     * Call on blank.
+     *
+     * @remarks
+     * Only called once.
+     * Only called if there is at least one blank.
+     */
+    onBlank?: (isTrue: boolean) => void;
+}
+//# sourceMappingURL=_ConditionUtils.d.ts.map

package/types/src/condition/_ConditionUtils.d.ts.map

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

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

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

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

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

package/types/src/conditionalFormat/ConditionalEntry.d.ts

@@ -0,0 +1,20 @@
+import { Scalar, IRange } from '@sheetxl/primitives';
+import { IProperties } from '../type';
+import { IStyle } from '../style';
+import { ISpatialMap } from '../collections/ISpatialMap';
+import { IConditionalFormat } from './IConditionalFormat';
+export declare class ConditionalEntry implements IProperties.ICellRanged<IStyle.Properties>, ISpatialMap.IUpdatableValue {
+    protected _c: IRange.Coords;
+    protected _m: IConditionalFormat;
+    constructor(coords: IRange.Coords, model: IConditionalFormat);
+    getModel(): IConditionalFormat;
+    /** {@inheritDoc IProperties.ICellRanged.getCoords} */
+    getCoords(): IRange.Coords;
+    /** {@inheritDoc IProperties.ICellRanged.getPropertiesAt} */
+    getPropertiesAt(rowIndex: number, colIndex: number, value: Scalar): Readonly<IStyle.Properties>;
+    /** {@inheritDoc IConditionalFormat.getDecorationAt} */
+    getDecorationAt(rowIndex: number, colIndex: number, value: Scalar): IConditionalFormat.Decoration | null;
+    /** {@inheritDoc ISpatialMap.IUpdatableValue.getSplit} */
+    getSplit(coords: readonly [IRange.Coords, IRange.Coords]): [this, this] | undefined;
+}
+//# sourceMappingURL=ConditionalEntry.d.ts.map

package/types/src/conditionalFormat/ConditionalEntry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConditionalEntry.d.ts","sourceRoot":"","sources":["../../../../src/conditionalFormat/ConditionalEntry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE/D,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,UAAU,CAAC;AAEvC,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE9D,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAO/D,qBAAa,gBAAiB,YAAW,WAAW,CAAC,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,WAAW,CAAC,eAAe;IAC9G,SAAS,CAAC,EAAE,EAAE,MAAM,CAAC,MAAM,CAAC;IAC5B,SAAS,CAAC,EAAE,EAAE,kBAAkB,CAAC;gBAG/B,MAAM,EAAE,MAAM,CAAC,MAAM,EACrB,KAAK,EAAE,kBAAkB;IAM3B,QAAQ,IAAI,kBAAkB;IAI9B,sDAAsD;IAEtD,SAAS,IAAI,MAAM,CAAC,MAAM;IAI1B,4DAA4D;IAC5D,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC;IAI/F,uDAAuD;IACvD,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,kBAAkB,CAAC,UAAU,GAAG,IAAI;IAIxG,yDAAyD;IACzD,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,SAAS;CAWpF"}

package/types/src/conditionalFormat/ConditionalFormat.d.ts

@@ -0,0 +1,190 @@
+import { Scalar, IRange } from '@sheetxl/primitives';
+import { ReferenceableClipboard } from '@sheetxl/utils';
+import { ITransaction } from '../transaction';
+import { IListener } from '../listener';
+import { ICellRange, ICellRanges } from '../cellRange';
+import { IStyle, IStyleCollection } from '../style';
+import { ISheet } from '../sheet';
+import { ISparseGrid, ISpatialMap } from '../collections';
+import { AnchoredConditional } from '../condition/AnchoredConditional';
+import { IConditionalFormat } from './IConditionalFormat';
+/**
+ * Implementation of {@link IConditionalFormat}.
+ */
+export declare class ConditionalFormat extends AnchoredConditional<State, CommitView, IConditionalFormat.Events> implements IConditionalFormat {
+    protected _styles: IStyleCollection;
+    protected _stylesRemoveListener: IListener.Remove | null;
+    protected _colorScale: PreparedColorScale | null;
+    protected _dataBar: PreparedDataBar | null;
+    protected _iconSet: PreparedIconSet | null;
+    protected _matches: ISparseGrid<boolean> | null;
+    /**
+     * What each `formula` stop currently resolves to, keyed by its expression — kept fresh by the
+     * watches {@link _syncStopWatches} registers, and read (never computed) while preparing a scale.
+     *
+     * @remarks
+     * A stop's formula usually points OUTSIDE the rule's own ranges (`=$Z$1`), which the rule's range
+     * listener cannot see. Resolving it during the prepare therefore answered once and then aged
+     * silently; a watch is what makes it keep answering.
+     */
+    protected _stopValues: Map<string, number | null>;
+    /** Removes for those watches, and the (anchor, expressions) pair they were registered for. */
+    protected _stopWatchRemoves: IListener.Remove[] | null;
+    protected _stopWatchKey: string | null;
+    /**
+     * Which round of prepares is current. Bumped once per {@link _processValueUpdates}; a prepare
+     * assigns its cache only if it is still the newest when it finishes.
+     *
+     * @remarks
+     * The four prepares are started fire-and-forget, so two rounds overlap whenever a change arrives
+     * while one is still resolving — and they do NOT finish in order. The realistic case is await
+     * DEPTH, not contention: the first round waits on a cold `calculation.ready()` inside a formula
+     * stop while the second finds it warm, finishes, and paints; the first then lands on top with its
+     * older read and stays there until something else changes. Watch callbacks re-enter here, so
+     * there are now two independent sources of rounds rather than one.
+     */
+    protected _prepareGeneration: number;
+    /** @internal */
+    protected _initialize(options: ConditionalFormat.ConstructorOptions): void;
+    /** @internal */
+    protected _getType(): string;
+    /** @internal */
+    protected _getActionDescription(action: 'delete' | 'initialize' | 'updateListener'): string | null;
+    /** @internal */
+    protected _getDefaultState(options: ConditionalFormat.ConstructorOptions): Readonly<State>;
+    /** @internal */
+    protected _processValueUpdates(_range?: ICellRange | null): void;
+    /**
+     * Resolves every stop to the number it stands for, in the order they were authored.
+     *
+     * @remarks
+     * A stop is a *description* of a threshold (`min`, `percentile 40`, a formula), not the threshold
+     * itself — resolving one needs the whole range's spread, which is why this is async and why the
+     * result is cached rather than recomputed per cell. A stop that cannot resolve (a formula that
+     * does not return a number, `min` over a range holding no numbers) yields `null` in its slot;
+     * callers decide whether that is fatal to their scale.
+     *
+     * Shared by all three scales, so `percentile` means one thing across them.
+     */
+    protected _resolveStopValues(ranges: ICellRanges, stops: IConditionalFormat.Stop[]): Promise<(number | null)[]>;
+    /**
+     * The cell a stop's formula is anchored at — the top-left of the rule's FIRST range, the same
+     * origin an `expression` rule's relative references shift from (and the origin the writer
+     * anchors a generated formula to).
+     */
+    protected _formulaAnchor(ranges: ICellRanges): Partial<IRange.CellCoords> | null;
+    /**
+     * Registers (or leaves alone) one watch per distinct `formula` stop.
+     *
+     * @remarks
+     * ONE value per expression for the whole rule, not one per cell: a stop is the gradient's domain,
+     * not a per-cell test, so each watch covers just the anchor cell. Relative references in a stop
+     * therefore mean what they mean AT the anchor — which is why the editor picks references for a
+     * stop as absolute.
+     *
+     * Idempotent, because `_processValueUpdates` calls it on every edit: watches are rebuilt only when
+     * the anchor moves or the set of expressions changes, never merely because a value did. A rule
+     * with no engine behind it (a standalone format, calculation `Off` and never woken) registers
+     * nothing and its formula stops resolve `null`, dropping out of the scale the way an unresolvable
+     * `min` does.
+     */
+    protected _syncStopWatches(ranges: ICellRanges, stops: IConditionalFormat.Stop[] | null): void;
+    /** @internal */
+    protected _removeStopWatches(): void;
+    /** @internal */
+    protected _processClose(): void;
+    _prepareColorScale(ranges: ICellRanges, colorScale: IConditionalFormat.ColorScaleStop[]): Promise<PreparedColorScale | null>;
+    /**
+     * Resolves a data bar's track once, so that a per-cell read is arithmetic.
+     *
+     * @remarks
+     * The two stops are the ends of the TRACK, not of the bar. Where zero falls between them is the
+     * axis, and that is what lets a negative bar grow leftward from it. `axisPosition` overrides
+     * that: `middle` pins the axis halfway however the data is spread, `none` drops the axis so
+     * every bar grows from the same edge.
+     */
+    protected _prepareDataBar(ranges: ICellRanges, dataBar: IConditionalFormat.DataBar): Promise<PreparedDataBar | null>;
+    /**
+     * Resolves an icon set's bands once, so that a per-cell read is a scan of at most five numbers.
+     *
+     * @remarks
+     * The first stop is the range's floor rather than a threshold — every value is at least in band
+     * 0 — so band selection tests stops `1..n`. `reverse` flips the answer, and a per-stop override
+     * re-points a band at a *different* set's icon, which is why the answer names the set it indexes.
+     */
+    protected _prepareIconSet(ranges: ICellRanges, iconSet: IConditionalFormat.IconSet): Promise<PreparedIconSet | null>;
+    /** {@inheritDoc IConditionalFormat.setStopIfTrue} */
+    setStopIfTrue(stopIfTrue: boolean, options?: ITransaction.OperationOptions): this;
+    /** {@inheritDoc IConditionalFormat.setStopIfTrue} */
+    isStopIfTrue(): boolean;
+    /** {@inheritDoc IConditionalFormat.getScale} */
+    getScale(): IConditionalFormat.Scale | null;
+    /** {@inheritDoc IConditionalFormat.getStyle} */
+    getStyle(): IStyle.Properties | null;
+    /**
+     * {@inheritDoc AnchoredConditional._rebaseAnchorFormulas}
+     *
+     * Scale rules keep their formulas in `formula`-type stops rather than the condition, so
+     * those rebase here.
+     * @internal
+     */
+    _rebaseAnchorFormulas(from: IRange.CellCoords, to: IRange.CellCoords): boolean;
+    /** {@inheritDoc IConditionalFormat.getSnapshot} */
+    getSnapshot(options?: ReferenceableClipboard.CopyOptions): IConditionalFormat.ISnapshot;
+    /** @internal */
+    protected _createSpatial(coords: IRange.Coords): ISpatialMap.IUpdatableValue;
+    /** {@inheritDoc IConditionalFormat.update} */
+    update(properties: IConditionalFormat.Modifiers, options?: ITransaction.OperationOptions): this;
+    /** {@inheritDoc IConditionalFormat.toJSON} */
+    toJSON(): IConditionalFormat.JSON | null;
+    /** @internal */
+    protected _fromJSON(json: IConditionalFormat.JSON): void;
+    /** {@inheritDoc IProperties.ICellRanged.getPropertiesAt} */
+    getPropertiesAt(rowIndex: number, colIndex: number, value: Scalar): Readonly<IStyle.Properties>;
+    /** {@inheritDoc IConditionalFormat.getDecorationAt} */
+    getDecorationAt(_rowIndex: number, _colIndex: number, value: Scalar): IConditionalFormat.Decoration | null;
+    /** {@inheritDoc IConditionalFormat.isIConditionalFormat} */
+    get isIConditionalFormat(): true;
+}
+export declare namespace ConditionalFormat {
+    interface ConstructorOptions extends AnchoredConditional.ConstructorOptions<IConditionalFormat.JSON> {
+        sheet?: ISheet;
+    }
+}
+interface State extends AnchoredConditional.State {
+    /**
+     * The differential style applied where the condition holds.
+     *
+     * @remarks
+     * Mutually exclusive with {@link State.scale} — a rule either tests cells and formats them, or
+     * renders across the range itself.
+     */
+    style: IStyle.Properties | null;
+    scale: IConditionalFormat.Scale | null;
+    stopIfTrue: boolean;
+    pivot: boolean;
+    /** Opaque third-party payload. Carried, never interpreted. */
+    ext: Record<string, unknown> | null;
+}
+interface CommitView extends AnchoredConditional.CommitView {
+}
+type RGB = readonly [number, number, number];
+interface ResolvedStop {
+    v: number;
+    rgb: RGB;
+    exclusive: boolean;
+}
+interface PreparedColorScale {
+    stops: ResolvedStop[];
+    colorFor(value: number): string;
+}
+interface PreparedDataBar {
+    /** Places a value on the resolved track. Total, because the track's ends are already known. */
+    barFor(value: number): IConditionalFormat.DataBarDecoration;
+}
+interface PreparedIconSet {
+    /** Picks the value's band. `null` where the band is an explicit "no icon" override. */
+    iconFor(value: number): IConditionalFormat.IconSetDecoration | null;
+}
+export {};
+//# sourceMappingURL=ConditionalFormat.d.ts.map

package/types/src/conditionalFormat/ConditionalFormat.d.ts.map

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

package/types/src/conditionalFormat/ConditionalFormatCollection.d.ts

@@ -0,0 +1,20 @@
+import { ICellRanges } from '../cellRange';
+import { IConditionalFormatCollection } from './IConditionalFormatCollection';
+import { IConditionalFormat } from './IConditionalFormat';
+export declare class ConditionalFormatCollection implements IConditionalFormatCollection {
+    private _add;
+    private _get;
+    private _createItem;
+    constructor(add: (address: ICellRanges.Address | IConditionalFormat, options?: IConditionalFormatCollection.AddOptions) => IConditionalFormat, get: (address: ICellRanges.Address | null | undefined, ignoreHidden?: boolean, fullyContained?: boolean) => IConditionalFormat[], createItem: (template?: IConditionalFormat | null) => IConditionalFormat);
+    /** {@inheritDoc IConditionalFormatCollection.add} */
+    add(address: ICellRanges.Address | IConditionalFormat, options?: IConditionalFormatCollection.AddOptions): IConditionalFormat;
+    /** {@inheritDoc ICollection.[Symbol.iterator]} */
+    [Symbol.iterator](): IterableIterator<IConditionalFormat>;
+    /** {@inheritDoc IConditionalFormatCollection.getItems} */
+    getItems(options?: IConditionalFormatCollection.GetItemsOptions): IConditionalFormat[];
+    /** {@inheritDoc IConditionalFormatCollection.createItem} */
+    createItem(template?: IConditionalFormat | null): IConditionalFormat;
+    /** {@inheritDoc IConditionalFormatCollection.getCount} */
+    getCount(): number;
+}
+//# sourceMappingURL=ConditionalFormatCollection.d.ts.map

package/types/src/conditionalFormat/ConditionalFormatCollection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConditionalFormatCollection.d.ts","sourceRoot":"","sources":["../../../../src/conditionalFormat/ConditionalFormatCollection.ts"],"names":[],"mappings":"AAEA,OAAO,EAAmB,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAMjE,OAAO,EAAE,KAAK,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAEnF,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAK/D,qBAAa,2BAA4B,YAAW,4BAA4B;IAC9E,OAAO,CAAC,IAAI,CAA+H;IAC3I,OAAO,CAAC,IAAI,CAA8H;IAC1I,OAAO,CAAC,WAAW,CAA+D;gBAGhF,GAAG,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,OAAO,GAAG,kBAAkB,EAAE,OAAO,CAAC,EAAE,4BAA4B,CAAC,UAAU,KAAK,kBAAkB,EACjI,GAAG,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,OAAO,GAAG,IAAI,GAAG,SAAS,EAAE,YAAY,CAAC,EAAE,OAAO,EAAE,cAAc,CAAC,EAAE,OAAO,KAAK,kBAAkB,EAAE,EAChI,UAAU,EAAE,CAAC,QAAQ,CAAC,EAAE,kBAAkB,GAAG,IAAI,KAAK,kBAAkB;IAO1E,qDAAqD;IACrD,GAAG,CAAC,OAAO,EAAE,WAAW,CAAC,OAAO,GAAG,kBAAkB,EAAE,OAAO,CAAC,EAAE,4BAA4B,CAAC,UAAU,GAAG,kBAAkB;IAO7H,kDAAkD;IACjD,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,gBAAgB,CAAC,kBAAkB,CAAC;IAI1D,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,CAAC,EAAE,4BAA4B,CAAC,eAAe,GAAG,kBAAkB,EAAE;IAoBtF,4DAA4D;IAC5D,UAAU,CAAC,QAAQ,CAAC,EAAE,kBAAkB,GAAG,IAAI,GAAG,kBAAkB;IAIpE,0DAA0D;IAC1D,QAAQ,IAAI,MAAM;CAGnB"}