@sheetxl/sdk 0.7.21 → 0.7.23-beta.2

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

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

package/types/src/protectedRange/IProtectedRange.d.ts

@@ -0,0 +1,239 @@
+import { IAnchored } from '../anchored';
+import { ICellRanges } from '../cellRange';
+import { IListener } from '../listener';
+import { IProtection } from '../protection';
+import { ITransaction } from '../transaction';
+/**
+ * A named range (or set of ranges) that stays editable while the sheet as a whole is protected.
+ *
+ * @remarks
+ * Excel surfaces these as *Review → Allow Edit Ranges*, and OOXML persists them as
+ * `<protectedRange>` inside `<protectedRanges>`. Despite the name, a protected range **relaxes**
+ * protection rather than adding it: it is only consulted while {@link ISheetProtection.isLocked}
+ * is true, and it grants an exemption for the cells it covers — optionally behind a password.
+ *
+ * * Like {@link IConditionalFormat} and {@link IDataValidation}, one entry may be anchored to
+ *   several discontiguous ranges (`sqref="A1:B4 D1:D9"`), and any single range can become several
+ *   when a row/column delete splits it.
+ * * {@link getName} is required and unique within the sheet.
+ */
+export interface IProtectedRange extends IAnchored {
+    /**
+     * The unique name for this entry.
+     *
+     * @remarks
+     * Required by OOXML and unique within the sheet, but unrelated to the ranges it covers — it is a
+     * label, not a defined name, and never resolves as a reference.
+     */
+    getName(): string;
+    /**
+     * @see {@link IProtectedRange.getName}
+     *
+     * @param name The new name. Must be non-empty and unique within the sheet.
+     */
+    setName(name: string, options?: ITransaction.OperationOptions): this;
+    /**
+     * Returns the index of this entry within its container.
+     *
+     * @remarks
+     * Unlike {@link IConditionalFormat.getIndex} this carries no evaluation semantics — protected
+     * ranges are an unordered set in OOXML. The index exists so the UI can present a stable list.
+     */
+    getIndex(): number;
+    /**
+     * @see {@link IProtectedRange.getIndex}
+     */
+    setIndex(index: number): this;
+    /**
+     * Re-anchors this protected range to `address`, REPLACING every range it currently covers.
+     *
+     * @param address The range or ranges to cover — anything `ISheet.getRanges` accepts
+     *   (`'A1:C20'`, `'A1:A5, C1:C5'`, coords). Resolved against this protected range's own sheet.
+     * @param options Transaction options; `description` names the entry in undo history.
+     *
+     * @remarks
+     * A REPLACE, not an add: the ranges named become the whole anchor. An address that names
+     * nothing throws rather than leaving the protected range unanchored — clearing is
+     * {@link IAnchored.delete}.
+     *
+     * Undoable, and refused on a protected sheet. A protected range spans several ranges as readily as
+     * one; the OOXML `sqref` carries the whole list.
+     */
+    setRanges(address: ICellRanges.Address, options?: ITransaction.OperationOptions): this;
+    /**
+     * The relative security descriptor, or `null` if there is none.
+     *
+     * @remarks
+     * Names the user accounts that may edit this range without supplying a password, e.g.
+     * `"O:WDG:WDD:(A;;CC;;;AN)"`. SheetXL does not evaluate this — it is preserved for round-trip
+     * until the user identity system lands.
+     *
+     * @see {@link IProtection.IdentityProvider}
+     */
+    getSecurityDescriptor(): string | null;
+    /**
+     * @see {@link IProtectedRange.getSecurityDescriptor}
+     */
+    setSecurityDescriptor(descriptor: string | null, options?: ITransaction.OperationOptions): this;
+    /**
+     * Returns `true` if a password must be supplied to edit this range.
+     */
+    hasPassword(): boolean;
+    /**
+     * Sets (or clears) the password required to edit this range.
+     *
+     * @param password The plain-text password, or `null` to remove it.
+     * @param options {@link IProtectedRange.SetPasswordOptions}
+     *
+     * @remarks
+     * The password is hashed before it reaches the model state — the plain text is never stored and
+     * never serialized. Asynchronous because hashing is (`PasswordHasher` runs a spin count).
+     */
+    setPassword(password: string | null, options?: IProtectedRange.SetPasswordOptions): Promise<this>;
+    /**
+     * Verifies a plain-text password against the stored hash.
+     *
+     * @param password The password to check.
+     * @returns `true` when it matches, or when no password is set. `false` otherwise.
+     *
+     * @remarks
+     * Never throws for a wrong password — unlike {@link IProtection.checkPassword}, which is a
+     * gate. This is a predicate.
+     */
+    checkPassword(password?: string): Promise<boolean>;
+    /**
+     * The stored password hash, or `null` if there is none.
+     *
+     * @remarks
+     * For persistence. The plain text is not recoverable from this.
+     */
+    getEncryptedPassword(): Readonly<Partial<IProtection.EncryptedPassword>> | null;
+    /**
+     * Whether edits to this range are currently permitted on a protected sheet.
+     *
+     * @remarks
+     * * `true` whenever there is no password — that is the whole point of an entry without one, and
+     *   it needs no ceremony.
+     * * With a password, `true` only after {@link unlock} succeeded.
+     *
+     * **Session state, not document state.** It is never serialized, never recorded on the undo
+     * stack, and resets when the workbook is reopened — the same shape as
+     * {@link IProtection.isPaused}. This is what lets the write path consult it synchronously; a
+     * password check is async and cannot be awaited per cell.
+     */
+    isUnlocked(): boolean;
+    /**
+     * Grants edit access to this range for the rest of the session.
+     *
+     * @param password The password, when one is set.
+     * @returns `true` when access was granted, `false` when the password did not match.
+     *
+     * @remarks
+     * Does not throw on a wrong password — callers are UI prompts that want to re-ask.
+     * @see {@link isUnlocked}
+     */
+    unlock(password?: string): Promise<boolean>;
+    /**
+     * Revokes a previous {@link unlock}.
+     *
+     * @remarks
+     * A no-op when there is no password, since such a range is always unlocked.
+     */
+    relock(): this;
+    /**
+     * Set multiple properties at the same time.
+     *
+     * @remarks
+     * `password` here is the **already encrypted** form — use {@link setPassword} to set one from
+     * plain text.
+     */
+    update(properties: Partial<IProtectedRange.Properties> | IProtectedRange, options?: ITransaction.OperationOptions): this;
+    /**
+     * Add Listeners.
+     *
+     * @see
+     * {@link IListener.ISource.addListeners}
+     */
+    addListeners(listeners: IProtectedRange.IListeners, options?: IListener.Options): IListener.Remove;
+    /**
+     * @returns The current state as a JSON object, or `null` if there is no state.
+     */
+    toJSON(): IProtectedRange.JSON | null;
+    /**
+     * For runtime type checking.
+     */
+    readonly isIProtectedRange: true;
+}
+/**
+ * Capabilities for working with ranges that stay editable on a protected sheet.
+ *
+ * @see
+ * ### **Interface**
+ *
+ * {@link IProtectedRange}
+ *
+ * **Additional Interfaces**
+ * * {@link IProtectedRangeCollection}
+ */
+export declare namespace IProtectedRange {
+    /**
+     * Options for {@link IProtectedRange.setPassword}.
+     */
+    interface SetPasswordOptions extends ITransaction.OperationOptions {
+        /**
+         * The hash algorithm.
+         *
+         * @defaultValue `SHA-512`
+         */
+        algorithm?: string;
+        /**
+         * The number of hash iterations.
+         *
+         * @defaultValue `100000`
+         */
+        spinCount?: number;
+    }
+    /**
+     * A set of values that can be set on an {@link IProtectedRange}.
+     */
+    interface Properties {
+        /**
+         * {@inheritDoc IProtectedRange.getName}
+         */
+        name?: string;
+        /**
+         * {@inheritDoc IProtectedRange.getSecurityDescriptor}
+         */
+        securityDescriptor?: string;
+        /**
+         * The encrypted password. An absent value means the range needs no password.
+         *
+         * @remarks
+         * Never the plain text — see {@link IProtectedRange.setPassword}.
+         */
+        password?: Partial<IProtection.EncryptedPassword>;
+    }
+    /**
+     * A JSON representation useful for persistence.
+     */
+    interface JSON extends Properties {
+    }
+    /**
+     * IListener for {@link IProtectedRange} events.
+     */
+    interface Events extends IAnchored.Events<IProtectedRange> {
+        /**
+         * Called when the name, descriptor or password changes.
+         */
+        onConfigChange?(source: IProtectedRange): void;
+        /**
+         * Called when session edit access changes.
+         *
+         * @see {@link IProtectedRange.isUnlocked}
+         */
+        onUnlockChange?(source: IProtectedRange): void;
+    }
+    interface IListeners extends IListener.Callbacks<IProtectedRange, IProtectedRange.Events> {
+    }
+}
+//# sourceMappingURL=IProtectedRange.d.ts.map

package/types/src/protectedRange/IProtectedRange.d.ts.map

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

package/types/src/protectedRange/IProtectedRangeCollection.d.ts

@@ -0,0 +1,73 @@
+import { ICellRange, ICellRanges } from '../cellRange';
+import { ICollection } from '../type';
+import { ITransaction } from '../transaction';
+import { IProtectedRange } from './IProtectedRange';
+/**
+ * Holds a collection of {@link IProtectedRange}s.
+ */
+export interface IProtectedRangeCollection extends ICollection<IProtectedRange> {
+    /**
+     * Add an `IProtectedRange` to the container.
+     *
+     * @param address The address of the item. May name several discontiguous ranges.
+     * @param options {@link IProtectedRangeCollection.AddOptions}
+     *
+     * @remarks
+     * If no name is supplied one is generated (`Range1`, `Range2`, …), matching Excel.
+     */
+    add(address: ICellRanges.Address | IProtectedRange, options?: IProtectedRangeCollection.AddOptions): IProtectedRange;
+    /**
+     * Returns items that match the filter criteria.
+     *
+     * If no filter criteria is provided, all items will be returned.
+     *
+     * @param options {@link IProtectedRangeCollection.GetItemsOptions}
+     */
+    getItems(options?: IProtectedRangeCollection.GetItemsOptions): IProtectedRange[];
+    /**
+     * Create a temporary item that can be interacted with but is not added to the collection.
+     *
+     * @param template A template to use for the temporary item.
+     */
+    createItem(template?: IProtectedRange): IProtectedRange;
+}
+/**
+ * {@inheritDoc IProtectedRangeCollection}
+ * @see
+ * ### **Interface**
+ *
+ * {@link IProtectedRangeCollection}
+ */
+export declare namespace IProtectedRangeCollection {
+    /**
+     * Options for adding an {@link IProtectedRange}.
+     */
+    interface AddOptions extends IProtectedRange.Properties, ITransaction.OperationOptions {
+    }
+    /**
+     * Options for searching for {@link IProtectedRange}s.
+     */
+    interface GetItemsOptions extends ICollection.GetItemsOptions {
+        /**
+         * If provided, the search will be limited to items that intersect the range.
+         */
+        address?: ICellRange.Address;
+        /**
+         * Indicate if items that are in hidden headers or marked as hidden should be returned.
+         *
+         * @defaultValue false
+         */
+        ignoreHidden?: boolean;
+        /**
+         * Only return items that are completely contained with the search bounds.
+         *
+         * @defaultValue false
+         */
+        fullyContained?: boolean;
+        /**
+         * Search with the given name. This is case insensitive.
+         */
+        name?: string;
+    }
+}
+//# sourceMappingURL=IProtectedRangeCollection.d.ts.map

package/types/src/protectedRange/IProtectedRangeCollection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IProtectedRangeCollection.d.ts","sourceRoot":"","sources":["../../../../src/protectedRange/IProtectedRangeCollection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,yBAA0B,SAAQ,WAAW,CAAC,eAAe,CAAC;IAC7E;;;;;;;;OAQG;IACH,GAAG,CAAC,OAAO,EAAE,WAAW,CAAC,OAAO,GAAG,eAAe,EAAE,OAAO,CAAC,EAAE,yBAAyB,CAAC,UAAU,GAAG,eAAe,CAAC;IACrH;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,yBAAyB,CAAC,eAAe,GAAG,eAAe,EAAE,CAAC;IACjF;;;;OAIG;IACH,UAAU,CAAC,QAAQ,CAAC,EAAE,eAAe,GAAG,eAAe,CAAC;CACzD;AAED;;;;;;GAMG;AACH,yBAAiB,yBAAyB,CAAC;IAEzC;;OAEG;IACH,UAAiB,UAAW,SAAQ,eAAe,CAAC,UAAU,EAAE,YAAY,CAAC,gBAAgB;KAAG;IAEhG;;OAEG;IACH,UAAiB,eAAgB,SAAQ,WAAW,CAAC,eAAe;QAClE;;WAEG;QACH,OAAO,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC;QAC7B;;;;WAIG;QACH,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB;;;;WAIG;QACH,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB;;WAEG;QACH,IAAI,CAAC,EAAE,MAAM,CAAC;KACf;CACF"}

package/types/src/protectedRange/ProtectedRange.d.ts

@@ -0,0 +1,101 @@
+import { IRange } from '@sheetxl/primitives';
+import { IListener } from '../listener';
+import { ITransaction } from '../transaction';
+import { ICellRanges } from '../cellRange';
+import { Anchored } from '../anchored/Anchored';
+import { AbstractAnchored } from '../anchored/AbstractAnchored';
+import { IProtection } from '../protection';
+import { IProtectedRange } from './IProtectedRange';
+/**
+ * Implementation of {@link IProtectedRange}.
+ *
+ * @remarks
+ * Extends {@link AbstractAnchored} directly rather than `AnchoredConditional`: a protected range
+ * has no condition and does not depend on cell values, so it never subscribes to range events.
+ */
+export declare class ProtectedRange extends AbstractAnchored<State, CommitView, IProtectedRange.Events> implements IProtectedRange {
+    /**
+     * Session edit access — set by {@link unlock}, cleared by {@link relock}.
+     *
+     * @remarks
+     * A plain field, deliberately NOT in `State`: this is session state, so it must not serialize,
+     * must not land on the undo stack, and must not be restored by an undo of an unrelated edit.
+     * Model identity is stable across `AnchoredMap` clones (a shift re-points entries, it does not
+     * rebuild models), so the field survives every path that would rewrite `State`.
+     *
+     * Only meaningful when a password is set — see {@link isUnlocked}.
+     */
+    private _sessionUnlocked;
+    /** @internal */
+    protected _initialize(options: ProtectedRange.ConstructorOptions): void;
+    /** @internal */
+    protected _getActionDescription(action: 'delete' | 'initialize' | 'updateListener'): string | null;
+    /**
+     * Whether the anchor is absolute. See {@link AbstractAnchored._isAnchorAbsolute}.
+     *
+     * @remarks
+     * Always — like data validations and conditional formats, a protected range pins to where it was
+     * authored and Excel presents its `sqref` as absolute.
+     */
+    protected _isAnchorAbsolute(): boolean;
+    /** @internal */
+    protected _processContainerShift(options: Anchored.ShiftOptions): IRange.Coords | null | void;
+    /** {@inheritDoc IProtectedRange.getName} */
+    getName(): string;
+    /** {@inheritDoc IProtectedRange.setName} */
+    setName(name: string, options?: ITransaction.OperationOptions): this;
+    /** {@inheritDoc IProtectedRange.getIndex} */
+    getIndex(): number;
+    /** {@inheritDoc IProtectedRange.setIndex} */
+    setIndex(index: number): this;
+    /** {@inheritDoc IProtectedRange.setRanges} */
+    setRanges(address: ICellRanges.Address, options?: ITransaction.OperationOptions): this;
+    /** {@inheritDoc IProtectedRange.getSecurityDescriptor} */
+    getSecurityDescriptor(): string | null;
+    /** {@inheritDoc IProtectedRange.setSecurityDescriptor} */
+    setSecurityDescriptor(descriptor: string | null, options?: ITransaction.OperationOptions): this;
+    /** {@inheritDoc IProtectedRange.hasPassword} */
+    hasPassword(): boolean;
+    /** {@inheritDoc IProtectedRange.getEncryptedPassword} */
+    getEncryptedPassword(): Readonly<Partial<IProtection.EncryptedPassword>> | null;
+    /** {@inheritDoc IProtectedRange.setPassword} */
+    setPassword(password: string | null, options?: IProtectedRange.SetPasswordOptions): Promise<this>;
+    /** {@inheritDoc IProtectedRange.isUnlocked} */
+    isUnlocked(): boolean;
+    /** {@inheritDoc IProtectedRange.unlock} */
+    unlock(password?: string): Promise<boolean>;
+    /** {@inheritDoc IProtectedRange.relock} */
+    relock(): this;
+    /** {@inheritDoc IProtectedRange.checkPassword} */
+    checkPassword(password?: string): Promise<boolean>;
+    /** {@inheritDoc IProtectedRange.update} */
+    update(update: Partial<IProtectedRange.Properties> | IProtectedRange, options?: ITransaction.OperationOptions): this;
+    /** {@inheritDoc IListener.ISource.addListeners} */
+    addListeners(listeners: IProtectedRange.IListeners, options?: IListener.Options): IListener.Remove;
+    /** {@inheritDoc IProtectedRange.toJSON} */
+    toJSON(): IProtectedRange.JSON | null;
+    /** @internal */
+    protected _fromJSON(json?: IProtectedRange.JSON, options?: ITransaction.OperationOptions): void;
+    get [Symbol.toStringTag](): string;
+    toString(): string;
+    /** {@inheritDoc IProtectedRange.isIProtectedRange} */
+    get isIProtectedRange(): true;
+}
+/**
+ * Interfaces for creating a {@link ProtectedRange}.
+ */
+export declare namespace ProtectedRange {
+    interface ConstructorOptions extends Anchored.ConstructorOptions<IProtectedRange.JSON> {
+    }
+}
+/** @internal */
+interface State extends AbstractAnchored.State {
+    name: string;
+    securityDescriptor: string | null;
+    password: Partial<IProtection.EncryptedPassword> | null;
+}
+/** @internal */
+interface CommitView extends AbstractAnchored.CommitView {
+}
+export {};
+//# sourceMappingURL=ProtectedRange.d.ts.map

package/types/src/protectedRange/ProtectedRange.d.ts.map

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

package/types/src/protectedRange/ProtectedRangeCollection.d.ts

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

package/types/src/protectedRange/ProtectedRangeCollection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProtectedRangeCollection.d.ts","sourceRoot":"","sources":["../../../../src/protectedRange/ProtectedRangeCollection.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAAE,KAAK,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAC7E,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGzD,qBAAa,wBAAyB,YAAW,yBAAyB;IACxE,OAAO,CAAC,IAAI,CAAsH;IAClI,OAAO,CAAC,IAAI,CAA2H;IACvI,OAAO,CAAC,UAAU,CAA2C;IAC7D,OAAO,CAAC,WAAW,CAAyD;gBAG1E,GAAG,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,OAAO,GAAG,eAAe,EAAE,OAAO,CAAC,EAAE,yBAAyB,CAAC,UAAU,KAAK,eAAe,EACxH,GAAG,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,OAAO,GAAG,IAAI,GAAG,SAAS,EAAE,YAAY,CAAC,EAAE,OAAO,EAAE,cAAc,CAAC,EAAE,OAAO,KAAK,eAAe,EAAE,EAC7H,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,eAAe,GAAG,IAAI,EACnD,UAAU,EAAE,CAAC,QAAQ,CAAC,EAAE,eAAe,GAAG,IAAI,KAAK,eAAe;IAQpE,kDAAkD;IAClD,GAAG,CAAC,OAAO,EAAE,WAAW,CAAC,OAAO,GAAG,eAAe,EAAE,OAAO,CAAC,EAAE,yBAAyB,CAAC,UAAU,GAAG,eAAe;IAOpH,kDAAkD;IACjD,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,gBAAgB,CAAC,eAAe,CAAC;IAIvD,uDAAuD;IACvD,QAAQ,CAAC,OAAO,CAAC,EAAE,yBAAyB,CAAC,eAAe,GAAG,eAAe,EAAE;IAYhF,yDAAyD;IACzD,UAAU,CAAC,QAAQ,CAAC,EAAE,eAAe,GAAG,IAAI,GAAG,eAAe;IAI9D,uDAAuD;IACvD,QAAQ,IAAI,MAAM;CAGnB"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/protectedRange/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,6BAA6B,CAAC"}

package/types/src/protection/DefaultProtection.d.ts

@@ -0,0 +1,43 @@
+import { IListener } from '../listener';
+import { IProtection } from './IProtection';
+import { ListenerEmitter } from '../listener/ListenerEmitter';
+export declare class DefaultProtection<T, P extends IProtection.Properties, J extends IProtection.JSON> implements IProtection<T, P, J> {
+    protected _emitter: ListenerEmitter<this, IProtection.IListeners>;
+    protected _isPaused: boolean;
+    protected _password: Partial<IProtection.EncryptedPassword> | null;
+    protected _identities: IProtection.IdentityProvider[] | null;
+    protected _properties: Partial<P> | null;
+    protected _isReadOnly: boolean;
+    constructor(json?: J, isReadOnly?: boolean);
+    /** {@inheritDoc IProtection.lock} */
+    lock(properties?: Partial<P>, password?: string, algorithm?: string, spinCount?: number): Promise<IProtection<T, P, J>>;
+    /** {@inheritDoc IProtection.unlock} */
+    unlock(password?: string): Promise<IProtection<T, P, J>>;
+    /** {@inheritDoc IProtection.checkPassword} */
+    checkPassword(password?: string): Promise<boolean>;
+    /** {@inheritDoc IProtection.hasPassword} */
+    hasPassword(): boolean;
+    /** {@inheritDoc IProtection.pause} */
+    pause(password?: string): Promise<IProtection<T, P, J>>;
+    /** {@inheritDoc IProtection.resume} */
+    resume(): IProtection<T, P, J>;
+    /** {@inheritDoc IProtection.isPaused} */
+    isPaused(): boolean;
+    /** {@inheritDoc IProtection.isLocked} */
+    isLocked(): boolean;
+    /** {@inheritDoc IProtection.isReadOnly} */
+    isReadOnly(): boolean;
+    protected _validatePassword(password?: string): Promise<boolean>;
+    getProperties(): Partial<P> | null;
+    protected _isPropertyAllowed(property: keyof P): boolean;
+    protected _updateProperties(properties: IProtection.Properties | null): void;
+    protected _clearProperties(): void;
+    /** {@inheritDoc IListener.ISource.addListeners} */
+    addListeners(listeners: IProtection.IListeners, options?: IListener.Options): IListener.Remove;
+    fromJSON(json?: J): void;
+    protected _fromJSON(_json: J | null): void;
+    protected _toJSON(json: Partial<J>): Partial<J>;
+    /** {@inheritDoc IWorkbookProtection.toJSON} */
+    toJSON(): J | null;
+}
+//# sourceMappingURL=DefaultProtection.d.ts.map

package/types/src/protection/DefaultProtection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultProtection.d.ts","sourceRoot":"","sources":["../../../../src/protection/DefaultProtection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAGjD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D,qBAAa,iBAAiB,CAAC,CAAC,EAAE,CAAC,SAAS,WAAW,CAAC,UAAU,EAAE,CAAC,SAAS,WAAW,CAAC,IAAI,CAAE,YAAW,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAC7H,SAAS,CAAC,QAAQ,EAAE,eAAe,CAAC,IAAI,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC;IAElE,SAAS,CAAC,SAAS,EAAE,OAAO,CAAS;IAErC,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC,WAAW,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAQ;IAE1E,SAAS,CAAC,WAAW,EAAE,WAAW,CAAC,gBAAgB,EAAE,GAAG,IAAI,CAAQ;IAEpE,SAAS,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAQ;IAEhD,SAAS,CAAC,WAAW,EAAE,OAAO,CAAC;gBAEnB,IAAI,CAAC,EAAE,CAAC,EAAE,UAAU,GAAE,OAAe;IAMjD,qCAAqC;IAC/B,IAAI,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IA4C7H,uCAAuC;IACjC,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAc9D,8CAA8C;IAC9C,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIlD,4CAA4C;IAC5C,WAAW,IAAI,OAAO;IAItB,sCAAsC;IAChC,KAAK,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAW7D,uCAAuC;IACvC,MAAM,IAAI,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAK9B,yCAAyC;IACzC,QAAQ,IAAI,OAAO;IAInB,yCAAyC;IACzC,QAAQ,IAAI,OAAO;IAInB,2CAA2C;IAC3C,UAAU,IAAI,OAAO;cAIL,iBAAiB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAyBtE,aAAa,IAAI,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI;IAIlC,SAAS,CAAC,kBAAkB,CAAC,QAAQ,EAAE,MAAM,CAAC,GAAG,OAAO;IAQxD,SAAS,CAAC,iBAAiB,CAAC,UAAU,EAAE,WAAW,CAAC,UAAU,GAAG,IAAI,GAAG,IAAI;IAQ5E,SAAS,CAAC,gBAAgB,IAAI,IAAI;IAIlC,mDAAmD;IACnD,YAAY,CAAC,SAAS,EAAE,WAAW,CAAC,UAAU,EAAE,OAAO,CAAC,EAAE,SAAS,CAAC,OAAO,GAAG,SAAS,CAAC,MAAM;IAM9F,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI;IAkBxB,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI;IAG1C,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAI/C,+CAA+C;IAC/C,MAAM,IAAI,CAAC,GAAG,IAAI;CAcnB"}