@sheetxl/sdk 0.7.21 → 0.7.23-beta.2

package/types/src/io/IWorkbookIO.d.ts.map

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

package/types/src/io/WorkbookIO.d.ts

@@ -0,0 +1,91 @@
+import { IListener } from '../listener';
+import { ITransaction } from '../transaction';
+import { IWorkbook } from '../workbook';
+import { IWorkbookIO } from './IWorkbookIO';
+/**
+ * Default implementation of the {@link IWorkbookIO} interface.
+ *
+ * @hidden
+ */
+export declare class DefaultWorkbookIO implements IWorkbookIO {
+    private _registry;
+    private _setInstalled;
+    private _backingStore;
+    private _defaultStore;
+    private _emitter;
+    constructor();
+    /** @inheritdoc IWorkbookIO.getBackingStore */
+    getBackingStore(): IWorkbookIO.IBackingStore;
+    /** @inheritdoc IWorkbookIO.setBackingStore */
+    setBackingStore(store: IWorkbookIO.IBackingStore | null): void;
+    /** @inheritdoc IWorkbookIO.canWrite */
+    canWrite(): boolean;
+    /** @inheritdoc IWorkbookIO.canRead */
+    canRead(): boolean;
+    /** @inheritdoc IWorkbookIO.install */
+    install(plugin: IWorkbookIO.Plugin): Promise<void>;
+    /** @inheritdoc IWorkbookIO.addListeners */
+    addListeners(listeners: IWorkbookIO.Listeners, options?: IListener.Options): IListener.Remove;
+    /** @inheritdoc IWorkbookIO.addCommitListener */
+    addCommitListener(listener: ITransaction.ICommitSource.IListeners): IListener.Remove;
+    /** @inheritdoc IWorkbookIO.getReadFormats */
+    getReadFormats(options?: IWorkbookIO.GetFormatsOptions): Promise<IWorkbookIO.FormatType[]>;
+    /** @inheritdoc IWorkbookIO.getWriteFormats */
+    getWriteFormats(options?: IWorkbookIO.GetFormatsOptions): Promise<IWorkbookIO.FormatType[]>;
+    /** @inheritdoc IWorkbookIO.getOrigin */
+    getOrigin(pathOrUrl: string): IWorkbookIO.Origin;
+    /** @inheritdoc IWorkbookIO.read */
+    read<T extends IWorkbookIO.ReadOptions = IWorkbookIO.ReadOptions>(sourceOrOptions?: string | IWorkbookIO.Origin | T): Promise<IWorkbook | null>;
+    /**
+     * Decodes acquired bytes into a workbook: resolves the read format, records provenance, runs
+     * the handler, and reports progress. Used by a {@link IWorkbookIO.IBackingStore} via
+     * {@link IWorkbookIO.ReadRequest.decode}.
+     *
+     * @internal
+     */
+    protected _decodeBuffer<T extends IWorkbookIO.ReadOptions = IWorkbookIO.ReadOptions>(bytes: ArrayBufferLike, info?: IWorkbookIO.ReadInfo, optionsArg?: T, presetOrigin?: IWorkbookIO.Origin | null): Promise<IWorkbook | null>;
+    /**
+     * Unwraps an encryption envelope, resolving a password from `options.password` and — when that is
+     * absent or rejected — `options.onPassword`.
+     *
+     * @returns The plaintext bytes, the input unchanged when nothing is encrypted, or `null` when the
+     *   caller cancelled the prompt.
+     *
+     * @remarks
+     * This is the whole of the read side of encryption, and it lives here rather than in a format
+     * handler on purpose: an envelope carries opaque bytes, so one implementation serves every format
+     * (see `IWorkbookIO.EncryptionType`). Format handlers never see a password.
+     *
+     * @internal
+     */
+    protected _decrypt<T extends IWorkbookIO.ReadOptions = IWorkbookIO.ReadOptions>(bytes: ArrayBufferLike, origin: IWorkbookIO.Origin, options?: T): Promise<{
+        bytes: ArrayBufferLike;
+        password: string | null;
+    } | null>;
+    /** @inheritdoc IWorkbookIO.writeArrayBuffer */
+    writeArrayBuffer<T extends IWorkbookIO.WriteOptions = IWorkbookIO.WriteOptions>(workbook: IWorkbook, options?: T): Promise<ArrayBufferLike>;
+    /** @inheritdoc IWorkbookIO.write */
+    write<T extends IWorkbookIO.WriteOptions = IWorkbookIO.WriteOptions>(workbook: IWorkbook, target?: string | IWorkbookIO.Origin | T, optionsArg?: T): Promise<IWorkbookIO.Origin | null>;
+    /** @inheritdoc IWorkbookIO.writeAs */
+    writeAs<T extends IWorkbookIO.WriteAsOptions = IWorkbookIO.WriteAsOptions>(workbook: IWorkbook, target: string | IWorkbookIO.Origin, options?: T): Promise<IWorkbookIO.Origin | null>;
+    /**
+     * Strips a known file extension from a file name, returning the base name.
+     *
+     * @internal
+     */
+    protected _stripExtension(fileName: string): string;
+    /**
+     * Returns the last path/URL segment of a name without its extension, or `null` if not provided.
+     * Handles both file paths and URLs (e.g. `'https://host/a/report.xlsx'` -> `'report'`).
+     *
+     * @internal
+     */
+    protected _baseName(pathOrUrl: string | null | undefined): string | null;
+    protected _writeArrayBuffer<T extends IWorkbookIO.WriteOptions = IWorkbookIO.WriteOptions>(workbook: IWorkbook, writeType: IWorkbookIO.WriteFormatType, options?: T): Promise<ArrayBufferLike>;
+    protected _readArrayBuffer<T extends IWorkbookIO.ReadOptions = IWorkbookIO.ReadOptions>(arrayBuffer: ArrayBufferLike, format: IWorkbookIO.ReadFormatType, options?: T): Promise<IWorkbook>;
+}
+/**
+ * A singleton instance of the default {@link IWorkbookIO} implementation.
+ */
+export declare const WorkbookIO: IWorkbookIO;
+//# sourceMappingURL=WorkbookIO.d.ts.map

package/types/src/io/WorkbookIO.d.ts.map

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

package/types/src/io/WorkbookOrigin.d.ts

@@ -0,0 +1,114 @@
+import { IListener } from '../listener';
+import { IWorkbookIO } from './IWorkbookIO';
+/**
+ * Options for constructing a {@link WorkbookOrigin}.
+ */
+export interface WorkbookOriginOptions {
+    /**
+     * Explicit display name (without extension). If omitted, the name is derived from the path.
+     */
+    name?: string | null;
+    /**
+     * The resolved format key (e.g. `'xlsx'`) — the handle's resource type. If omitted, it is
+     * derived from the path extension.
+     */
+    format?: string | null;
+    /**
+     * The last-known size of the source in bytes (stat-style), if known.
+     */
+    size?: number | null;
+    /**
+     * Whether the source can be written back to (a silent re-save).
+     *
+     * @defaultValue `true` for a local path, `false` for an unbound (`null`) path or a remote
+     * (`http(s):`/`data:`/`blob:`) one.
+     */
+    canWrite?: boolean;
+    /**
+     * The encryption envelope the source is wrapped in, or `null` for plaintext.
+     */
+    encryption?: string | null;
+}
+/**
+ * Default, observable {@link IWorkbookIO.Origin} implementation vended by the IO layer — the
+ * concrete "light virtual file handle" (see `IO-DESIGN.md`).
+ *
+ * @remarks
+ * Mutable and observable: the IO/store layer holds the instance and calls {@link update} when the
+ * source moves (a save that resolved a destination) or is renamed, firing `onChange` so holders —
+ * including the workbook itself, whose `getName()`/`onNameChange` derive from this — propagate it.
+ * Source logic (paths, URLs, formats) lives here, in the IO layer, not in the workbook model.
+ *
+ * An **unbound** origin (`path: null`) belongs to an in-memory workbook with no destination yet; a
+ * destination-resolving save fills it in place via {@link update}.
+ */
+export declare class WorkbookOrigin implements IWorkbookIO.Origin {
+    private _path;
+    private _name;
+    private _format;
+    private _size;
+    private _canWrite;
+    private _encryption;
+    /**
+     * The session password for this source. Deliberately not in {@link toString}, not serialized, and
+     * not reachable through the {@link IWorkbookIO.Origin} interface — see {@link getPassword}.
+     */
+    private _password;
+    private readonly _emitter;
+    constructor(path?: string | null, options?: WorkbookOriginOptions);
+    /** An unbound path can't be written back; neither can a remote one (without a store that can). */
+    private static _defaultCanWrite;
+    /** Drops any query/fragment so a URL path resolves to a clean file segment. */
+    private _cleanPath;
+    /** {@inheritDoc IWorkbookIO.Origin.getName} */
+    getName(): string | null;
+    /** {@inheritDoc IWorkbookIO.Origin.getPath} */
+    getPath(): string | null;
+    /** {@inheritDoc IWorkbookIO.Origin.getFormat} */
+    getFormat(): string | null;
+    /** {@inheritDoc IWorkbookIO.Origin.getExtension} */
+    getExtension(): string | null;
+    /** {@inheritDoc IWorkbookIO.Origin.getEncryption} */
+    getEncryption(): string | null;
+    /** {@inheritDoc IWorkbookIO.Origin.isEncrypted} */
+    isEncrypted(): boolean;
+    /** {@inheritDoc IWorkbookIO.Origin.setPassword} */
+    setPassword(password: string | null): void;
+    /**
+     * The session password, or `null`.
+     *
+     * @remarks
+     * The **privileged read channel**, deliberately on the class and not on the
+     * {@link IWorkbookIO.Origin} interface — the same arrangement as {@link update}. Only the IO layer
+     * uses it, to encrypt on write; consumers can set a password but never read one back.
+     */
+    getPassword(): string | null;
+    /** {@inheritDoc IWorkbookIO.Origin.getSize} */
+    getSize(): number | null;
+    /** {@inheritDoc IWorkbookIO.Origin.canWrite} */
+    canWrite(): boolean;
+    /** {@inheritDoc IWorkbookIO.Origin.setName} */
+    setName(name: string | null): void;
+    /**
+     * Update one or more fields in place. Fires `onChange` if anything actually changed.
+     *
+     * @remarks
+     * This is the **privileged mutation channel** (see `IO-DESIGN.md`): permitted callers are the
+     * backing store (rename/move, destination resolution), the IO layer (filling an unbound origin on
+     * a first destination-resolving save), and the document layer (Save As / rename). Never format
+     * handlers, never the model, never chrome.
+     */
+    update(next: {
+        path?: string | null;
+        name?: string | null;
+        format?: string | null;
+        size?: number | null;
+        canWrite?: boolean;
+        encryption?: string | null;
+    }): this;
+    /** {@inheritDoc IListener.ISource.addListeners} */
+    addListeners(listeners: IWorkbookIO.Origin.IListeners, options?: IListener.Options): IListener.Remove;
+    get [Symbol.toStringTag](): string;
+    toString(): string;
+}
+//# sourceMappingURL=WorkbookOrigin.d.ts.map

package/types/src/io/WorkbookOrigin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkbookOrigin.d.ts","sourceRoot":"","sources":["../../../../src/io/WorkbookOrigin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAI7C,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,cAAe,YAAW,WAAW,CAAC,MAAM;IACvD,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,SAAS,CAAU;IAC3B,OAAO,CAAC,WAAW,CAAgB;IACnC;;;OAGG;IACH,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqE;gBAElF,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,OAAO,GAAE,qBAA0B;IAUrE,kGAAkG;IAClG,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAK/B,+EAA+E;IAC/E,OAAO,CAAC,UAAU;IAIlB,+CAA+C;IAC/C,OAAO,IAAI,MAAM,GAAG,IAAI;IAQxB,+CAA+C;IAC/C,OAAO,IAAI,MAAM,GAAG,IAAI;IAIxB,iDAAiD;IACjD,SAAS,IAAI,MAAM,GAAG,IAAI;IAS1B,oDAAoD;IACpD,YAAY,IAAI,MAAM,GAAG,IAAI;IAO7B,qDAAqD;IACrD,aAAa,IAAI,MAAM,GAAG,IAAI;IAI9B,mDAAmD;IACnD,WAAW,IAAI,OAAO;IAItB,mDAAmD;IACnD,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAS1C;;;;;;;OAOG;IACH,WAAW,IAAI,MAAM,GAAG,IAAI;IAI5B,+CAA+C;IAC/C,OAAO,IAAI,MAAM,GAAG,IAAI;IAIxB,gDAAgD;IAChD,QAAQ,IAAI,OAAO;IAInB,+CAA+C;IAC/C,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAIlC;;;;;;;;OAQG;IACH,MAAM,CAAC,IAAI,EAAE;QACX,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACzF,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAC/C,GAAG,IAAI;IAaR,mDAAmD;IACnD,YAAY,CAAC,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,EAAE,SAAS,CAAC,OAAO,GAAG,SAAS,CAAC,MAAM;IAIrG,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAEjC;IAED,QAAQ,IAAI,MAAM;CAUnB"}

package/types/src/io/WorkbookRegistry.d.ts

@@ -0,0 +1,49 @@
+import { IWorkbookIO } from './IWorkbookIO';
+export declare class WorkbookRegistry implements IWorkbookIO.Registry {
+    private _readFormats;
+    private _writeFormats;
+    private _encryptions;
+    /** @inheritdoc IWorkbookIO.registerReadFormat */
+    registerReadFormat(formatType: IWorkbookIO.ReadFormatType): Promise<void>;
+    /** @inheritdoc IWorkbookIO.registerWriteFormat */
+    registerWriteFormat(formatType: IWorkbookIO.WriteFormatType): Promise<void>;
+    /** @inheritdoc IWorkbookIO.Registry.registerEncryption */
+    registerEncryption(encryption: IWorkbookIO.EncryptionType): Promise<void>;
+    /**
+     * The registered envelope to *write* with: the one matching `key`, or the first registered when
+     * no key is given.
+     *
+     * @remarks
+     * A key is supplied when re-saving a file that is already encrypted, so it is rewritten in the
+     * scheme it arrived in rather than silently migrated.
+     */
+    getEncryption(key?: string | null): Promise<IWorkbookIO.EncryptionType | null>;
+    /** {@inheritDoc WorkbookRegistry.getEncryption} — synchronous; the list is already in hand. */
+    peekEncryption(key?: string | null): IWorkbookIO.EncryptionType | null;
+    /**
+     * The registered encryption envelope wrapping these bytes, or `null` if they are plaintext (or no
+     * envelope recognizes them).
+     *
+     * @remarks
+     * Detection is by content, never by extension: an encrypted `.xlsx` and an encrypted `.sxl` are
+     * the same container, and neither announces itself in its name.
+     */
+    detectEncryption(bytes: ArrayBufferLike): Promise<IWorkbookIO.EncryptionType | null>;
+    getReadFormats(options?: IWorkbookIO.GetFormatsOptions): Promise<IWorkbookIO.ReadFormatType[]>;
+    getWriteFormats(options?: IWorkbookIO.GetFormatsOptions): Promise<IWorkbookIO.WriteFormatType[]>;
+    protected _registerFormatType<T extends IWorkbookIO.FormatType>(format: T, formats: readonly T[]): Promise<readonly T[]>;
+    protected _registerFormatTypeSync<T extends IWorkbookIO.FormatType>(format: T, formats: readonly T[]): readonly T[];
+    /**
+     * Returns a filtered array of formats using AND logic for all provided options.
+     *
+     * @remarks
+     * - All filters are applied with AND logic (format must match ALL conditions)
+     * - If ext is not provided, defaultExt is used as fallback
+     * - Extension matching is case-insensitive and handles formats with/without leading dot
+     * - Tag filtering requires ALL specified tags to be present
+     *
+     * @internal
+     */
+    protected _filterFormats<T extends IWorkbookIO.FormatType>(options: IWorkbookIO.GetFormatsOptions, formats: readonly T[], defaultExt?: string): T[];
+}
+//# sourceMappingURL=WorkbookRegistry.d.ts.map

package/types/src/io/WorkbookRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkbookRegistry.d.ts","sourceRoot":"","sources":["../../../../src/io/WorkbookRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,qBAAa,gBAAiB,YAAW,WAAW,CAAC,QAAQ;IAE3D,OAAO,CAAC,YAAY,CAA6C;IACjE,OAAO,CAAC,aAAa,CAA8C;IACnE,OAAO,CAAC,YAAY,CAA6C;IAEjE,iDAAiD;IAC3C,kBAAkB,CAAC,UAAU,EAAE,WAAW,CAAC,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/E,kDAAkD;IAC5C,mBAAmB,CAAC,UAAU,EAAE,WAAW,CAAC,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjF,0DAA0D;IACpD,kBAAkB,CAAC,UAAU,EAAE,WAAW,CAAC,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB/E;;;;;;;OAOG;IACG,aAAa,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC,cAAc,GAAG,IAAI,CAAC;IAIpF,+FAA+F;IAC/F,cAAc,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,WAAW,CAAC,cAAc,GAAG,IAAI;IAMtE;;;;;;;OAOG;IACG,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC,cAAc,GAAG,IAAI,CAAC;IAQpF,cAAc,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,cAAc,EAAE,CAAC;IAM9F,eAAe,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,eAAe,EAAE,CAAC;cAMtF,mBAAmB,CAAC,CAAC,SAAS,WAAW,CAAC,UAAU,EAClE,MAAM,EAAE,CAAC,EACT,OAAO,EAAE,SAAS,CAAC,EAAE,GACpB,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;IAIxB,SAAS,CAAC,uBAAuB,CAAC,CAAC,SAAS,WAAW,CAAC,UAAU,EAChE,MAAM,EAAE,CAAC,EACT,OAAO,EAAE,SAAS,CAAC,EAAE,GACpB,SAAS,CAAC,EAAE;IAwBf;;;;;;;;;;OAUG;IACH,SAAS,CAAC,cAAc,CAAC,CAAC,SAAS,WAAW,CAAC,UAAU,EACvD,OAAO,EAAE,WAAW,CAAC,iBAAiB,EACtC,OAAO,EAAE,SAAS,CAAC,EAAE,EACrB,UAAU,CAAC,EAAE,MAAM,GAClB,CAAC,EAAE;CAmDP"}

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

@@ -0,0 +1,5 @@
+export * from './IWorkbookIO';
+export * from './WorkbookIO';
+export * from './WorkbookOrigin';
+export * from './ArrayBackingStore';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/io/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC"}

package/types/src/lib/file/file.browser.d.ts

@@ -0,0 +1,41 @@
+import { IWorkbook } from '../../workbook';
+import { IWorkbookIO } from '../../io/IWorkbookIO';
+import { AbstractBackingStore } from '../../io/AbstractBackingStore';
+/**
+ * The browser {@link IWorkbookIO.IBackingStore}. Reads via a file the caller supplies (or an
+ * open picker when none is given) and writes via the File System Access API
+ * (`showSaveFilePicker`), falling back to a download when the API is unavailable.
+ *
+ * @remarks
+ * The writable file-system handle behind an {@link IWorkbookIO.Origin} is held in a private
+ * per-instance cache **keyed by the origin**, so a save to a bound origin can re-write silently.
+ * This is an invisible optimization — a handle cannot be recreated from a string path, so holding
+ * the object is the only way to re-save in place. Nothing about it is surfaced through any public
+ * type; the origin's `canWrite()` reflects whether a handle is held.
+ */
+export declare class BrowserBackingStore extends AbstractBackingStore {
+    private _getWriteFormats;
+    private _getReadFormats?;
+    protected _defaultStringSourceType: "fetch";
+    /** Writable FSA handles keyed by the Origin they back. */
+    private _handleCache;
+    private _pendingOpenHandle;
+    constructor(_getWriteFormats: () => Promise<IWorkbookIO.FormatType[]>, _getReadFormats?: (() => Promise<IWorkbookIO.FormatType[]>) | undefined);
+    /** @inheritdoc IWorkbookIO.IBackingStore.read */
+    read(request: IWorkbookIO.ReadRequest): Promise<IWorkbook | null>;
+    /** @inheritdoc */
+    protected resolveSource(): Promise<any>;
+    /** @inheritdoc */
+    protected onWorkbookRead(workbook: IWorkbook): Promise<void>;
+    /** @inheritdoc */
+    protected filePathToFile(filePath: string): Promise<File>;
+    /** @inheritdoc IWorkbookIO.IBackingStore.write */
+    write(request: IWorkbookIO.WriteRequest): Promise<IWorkbookIO.Origin | null>;
+}
+export { BrowserBackingStore as DefaultBackingStore };
+/**
+ * Browser implementation throws an error since browsers cannot access local filesystem.
+ * Users should use file input elements instead.
+ */
+export declare function filePathToFile(filePath: string): Promise<File>;
+//# sourceMappingURL=file.browser.d.ts.map

package/types/src/lib/file/file.browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.browser.d.ts","sourceRoot":"","sources":["../../../../../src/lib/file/file.browser.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAErE;;;;;;;;;;;GAWG;AACH,qBAAa,mBAAoB,SAAQ,oBAAoB;IAWzD,OAAO,CAAC,gBAAgB;IACxB,OAAO,CAAC,eAAe,CAAC;IAV1B,UAAmB,wBAAwB,EAAG,OAAO,CAAU;IAE/D,0DAA0D;IAC1D,OAAO,CAAC,YAAY,CAA8B;IAGlD,OAAO,CAAC,kBAAkB,CAAa;gBAG7B,gBAAgB,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,UAAU,EAAE,CAAC,EACzD,eAAe,CAAC,GAAE,MAAM,OAAO,CAAC,WAAW,CAAC,UAAU,EAAE,CAAC,aAAA;IAKnE,iDAAiD;IAC3C,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,WAAW,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAWvE,kBAAkB;cACF,aAAa,IAAI,OAAO,CAAC,GAAG,CAAC;IAyB7C,kBAAkB;cACF,cAAc,CAAC,QAAQ,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAelE,kBAAkB;cACF,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/D,kDAAkD;IAC5C,KAAK,CAAC,OAAO,EAAE,WAAW,CAAC,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,GAAG,IAAI,CAAC;CAgHnF;AAED,OAAO,EAAE,mBAAmB,IAAI,mBAAmB,EAAE,CAAC;AAEtD;;;GAGG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEpE"}

package/types/src/lib/file/file.node.d.ts

@@ -0,0 +1,25 @@
+import { IWorkbookIO } from '../../io/IWorkbookIO';
+import { AbstractBackingStore } from '../../io/AbstractBackingStore';
+/**
+ * The node {@link IWorkbookIO.IBackingStore}. Reads from local paths via `fs`, and writes to the
+ * destination {@link IWorkbookIO.Origin} handle. Node has no interactive picker, so a
+ * destination-resolving write (an unbound or read-only handle) falls back to the suggested name in
+ * the current directory when the handle at least carries a name, and throws otherwise.
+ */
+export declare class FSBackingStore extends AbstractBackingStore {
+    constructor(_getWriteFormats?: () => Promise<IWorkbookIO.FormatType[]>, _getReadFormats?: () => Promise<IWorkbookIO.FormatType[]>);
+    /** @inheritdoc */
+    protected filePathToFile(filePath: string): Promise<File>;
+    /** @inheritdoc */
+    protected _canWriteLocalPath(): boolean;
+    /** @inheritdoc IWorkbookIO.IBackingStore.write */
+    write(request: IWorkbookIO.WriteRequest): Promise<IWorkbookIO.Origin | null>;
+}
+export { FSBackingStore as DefaultBackingStore };
+/**
+ * Reads a file from the local filesystem and returns a File object.
+ * Node.js implementation using fs.
+ * Returns a File object with the full resolved path as the name.
+ */
+export declare function filePathToFile(filePath: string): Promise<File>;
+//# sourceMappingURL=file.node.d.ts.map

package/types/src/lib/file/file.node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.node.d.ts","sourceRoot":"","sources":["../../../../../src/lib/file/file.node.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAErE;;;;;GAKG;AACH,qBAAa,cAAe,SAAQ,oBAAoB;gBAGpD,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,UAAU,EAAE,CAAC,EAC1D,eAAe,CAAC,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,UAAU,EAAE,CAAC;IAK3D,kBAAkB;IAClB,SAAS,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzD,kBAAkB;cACC,kBAAkB,IAAI,OAAO;IAIhD,kDAAkD;IAC5C,KAAK,CAAC,OAAO,EAAE,WAAW,CAAC,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,GAAG,IAAI,CAAC;CAiDnF;AAED,OAAO,EAAE,cAAc,IAAI,mBAAmB,EAAE,CAAC;AAEjD;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAWpE"}

package/types/src/lib/utils/_Utils.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Two-tier node fingerprint.
+ * - `stable`: hash of fields unlikely to change (arch, osType, platform, memoryGB).
+ *   Used for hard enforcement.
+ * - `full`: hash that also includes hostname.
+ *   Passes silently if stable matches but full diverges (hostname rename, container re-creation).
+ */
+export interface NodeFingerprint {
+    stable: string;
+    full: string;
+}
+export interface HostDetails {
+    cpus?: number;
+    memoryGB?: number;
+    domain?: string | null;
+    fingerprint?: NodeFingerprint;
+}
+export declare function getBuildVersion(): string;
+export declare function getBuildDate(): string;
+//# sourceMappingURL=_Utils.d.ts.map

package/types/src/lib/utils/_Utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_Utils.d.ts","sourceRoot":"","sources":["../../../../../src/lib/utils/_Utils.ts"],"names":[],"mappings":"AACA;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,WAAW,CAAC,EAAE,eAAe,CAAC;CAC/B;AAED,wBAAgB,eAAe,IAAI,MAAM,CAOxC;AAED,wBAAgB,YAAY,IAAI,MAAM,CAOrC"}

package/types/src/lib/utils/banner.d.ts

@@ -0,0 +1,6 @@
+export declare const BANNER_IMAGE = "\n\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2557  \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557  \u2588\u2588\u2557\u2588\u2588\u2557\n\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u2550\u2588\u2588\u2554\u2550\u2550\u255D \u255A\u2588\u2588\u2557\u2588\u2588\u2554\u255D\u2588\u2588\u2551\n\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2588\u2588\u2588\u2557     \u2588\u2588\u2551     \u255A\u2588\u2588\u2588\u2554\u255D \u2588\u2588\u2551\n\u255A\u2550\u2550\u2550\u2550\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u255D  \u2588\u2588\u2554\u2550\u2550\u255D     \u2588\u2588\u2551     \u2588\u2588\u2554\u2588\u2588\u2557 \u2588\u2588\u2551\n\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557   \u2588\u2588\u2551    \u2588\u2588\u2554\u255D \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\n\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u255D\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D   \u255A\u2550\u255D    \u255A\u2550\u255D  \u255A\u2550\u255D\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D";
+export declare const BANNER_TEXT: string;
+export declare const sheetXLBlue = "#1976d2";
+export declare const sheetXLRed = "#E12929";
+export declare const sheetXLYellow = "#FFA726";
+//# sourceMappingURL=banner.d.ts.map

package/types/src/lib/utils/banner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"banner.d.ts","sourceRoot":"","sources":["../../../../../src/lib/utils/banner.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,YAAY,8qDAMkC,CAAC;AAE5D,eAAO,MAAM,WAAW,QACuB,CAAC;AAEhD,eAAO,MAAM,WAAW,YAAY,CAAC;AACrC,eAAO,MAAM,UAAU,YAAY,CAAC;AACpC,eAAO,MAAM,aAAa,YAAY,CAAC"}

package/types/src/lib/utils/utils.browser.d.ts

@@ -0,0 +1,28 @@
+import { HostDetails } from './_Utils';
+import { LicenseDetails } from '../../license';
+export declare function getHostDetails(): Promise<HostDetails>;
+export declare function isDevEnv(): Promise<boolean>;
+/**
+ * The runtime location - the current page url in the browser.
+ */
+export declare function getLocation(): string;
+/**
+ * The OS platform, used by the `INFO("system")` formula.
+ */
+export declare function getOS(): string;
+export declare function findLicenseKey(): Promise<{
+    key: string;
+    from: string;
+} | null>;
+export declare function setKey(key: string, force?: boolean): Promise<void>;
+export declare function getKey(): Promise<string>;
+export declare function printBanner(isUser: boolean): Promise<void>;
+/**
+ * The browser always gets the full banner — there is no piped output to protect, and
+ * the console collapses repeats. (See the node variant for the throttled CLI behavior.)
+ */
+export declare function claimFullLicensePrint(): Promise<boolean>;
+/** The one-line form of the unlicensed notice; in the browser only the activation pointer. */
+export declare function printLicenseNotice(): Promise<void>;
+export declare function printDetails(details: LicenseDetails, isUser?: boolean, expanded?: boolean, ignoreExceptions?: boolean): Promise<void>;
+//# sourceMappingURL=utils.browser.d.ts.map

package/types/src/lib/utils/utils.browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.browser.d.ts","sourceRoot":"","sources":["../../../../../src/lib/utils/utils.browser.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,wBAAsB,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC,CAM3D;AAED,wBAAsB,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,CAIjD;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED;;GAEG;AACH,wBAAgB,KAAK,IAAI,MAAM,CAE9B;AAKD,wBAAsB,cAAc,IAAI,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAqBpF;AAGD,wBAAsB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,GAAE,OAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAE7E;AAGD,wBAAsB,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,CAE9C;AAED,wBAAsB,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAKhE;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,OAAO,CAAC,CAE9D;AAED,8FAA8F;AAC9F,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAExD;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,cAAc,EACvB,MAAM,GAAE,OAAa,EACrB,QAAQ,GAAE,OAAa,EACvB,gBAAgB,GAAE,OAAa,GAC9B,OAAO,CAAC,IAAI,CAAC,CAgDf"}

package/types/src/lib/utils/utils.node.d.ts

@@ -0,0 +1,42 @@
+import { HostDetails } from './_Utils';
+import { LicenseDetails } from '../../license';
+export declare function getHostDetails(): Promise<HostDetails>;
+export declare function isDevEnv(): Promise<boolean>;
+/**
+ * The runtime location - the current working directory in node.
+ */
+export declare function getLocation(): string;
+/**
+ * The OS platform, used by the `INFO("system")` formula. `process.platform` is available
+ * synchronously without importing `os`.
+ */
+export declare function getOS(): string;
+export declare function findLicenseKey(): Promise<{
+    key: string;
+    from: string;
+} | null>;
+export declare function setKey(key: string, force?: boolean): Promise<void>;
+export declare function getKey(): Promise<string | undefined>;
+export declare function printBanner(isUser: boolean): Promise<void>;
+/**
+ * Whether an automatic license print may use the full banner (art + details), as opposed to
+ * the one-line notice. Claims the slot when granting it.
+ *
+ * @remarks
+ * The full form is for a human, and not on every run: stderr must be an interactive terminal
+ * (`isTTY` is `undefined` when piped/redirected/captured) and the art must not have run within
+ * the throttle window, persisted alongside the license key store. Fails open — no store means
+ * the full banner prints.
+ */
+export declare function claimFullLicensePrint(): Promise<boolean>;
+/**
+ * The one-line form of the unlicensed notice.
+ *
+ * @remarks
+ * One line on stderr: visible in logs and terminals without ever touching the payload stream,
+ * and cheap where the ASCII banner would be noise (a pipe, CI, an agent's context window).
+ * Dim when a human is watching stderr, plain ANSI-free text when not.
+ */
+export declare function printLicenseNotice(): Promise<void>;
+export declare function printDetails(details: LicenseDetails, isUser?: boolean, expanded?: boolean, ignoreExceptions?: boolean): Promise<void>;
+//# sourceMappingURL=utils.node.d.ts.map

package/types/src/lib/utils/utils.node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.node.d.ts","sourceRoot":"","sources":["../../../../../src/lib/utils/utils.node.ts"],"names":[],"mappings":"AASA,OAAO,EAAmB,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AAC7D,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,wBAAsB,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC,CAiC3D;AAED,wBAAsB,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,CAIjD;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED;;;GAGG;AACH,wBAAgB,KAAK,IAAI,MAAM,CAQ9B;AAED,wBAAsB,cAAc,IAAI,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAWpF;AAED,wBAAsB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,GAAE,OAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB7E;AAED,wBAAsB,MAAM,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAW1D;AAED,wBAAsB,WAAW,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAYhE;AAMD;;;;;;;;;GASG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,OAAO,CAAC,CAgB9D;AAED;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAQxD;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,cAAc,EACvB,MAAM,GAAE,OAAa,EACrB,QAAQ,GAAE,OAAa,EACvB,gBAAgB,GAAE,OAAa,GAC9B,OAAO,CAAC,IAAI,CAAC,CAuDf"}

package/types/src/license/LicenseDetails.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @hidden
+ */
+export interface LicenseDetails {
+    getLicensee(): string | null;
+    getExpiration(): Date | null;
+    getDomains(): string[];
+    getCpuCount(): number;
+    getMemory(): number;
+    isEval(): boolean;
+    isValidFor: (feature: string) => boolean;
+    getDeveloperCount(): number;
+    getType(): string;
+    getExceptions(): string[];
+    hasExceptions(): boolean;
+    isValid(): boolean;
+    getFeatures(): Readonly<Record<string, string>>;
+    getKeyFrom(): string;
+    getBuildVersion(): string;
+    getBuildDate(): string;
+}
+//# sourceMappingURL=LicenseDetails.d.ts.map

package/types/src/license/LicenseDetails.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LicenseDetails.d.ts","sourceRoot":"","sources":["../../../../src/license/LicenseDetails.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,WAAW,IAAI,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,IAAI,IAAI,GAAG,IAAI,CAAC;IAE7B,UAAU,IAAI,MAAM,EAAE,CAAC;IACvB,WAAW,IAAI,MAAM,CAAC;IACtB,SAAS,IAAI,MAAM,CAAC;IAEpB,MAAM,IAAI,OAAO,CAAC;IAClB,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;IACzC,iBAAiB,IAAI,MAAM,CAAC;IAC5B,OAAO,IAAI,MAAM,CAAC;IAClB,aAAa,IAAI,MAAM,EAAE,CAAC;IAC1B,aAAa,IAAI,OAAO,CAAC;IACzB,OAAO,IAAI,OAAO,CAAC;IACnB,WAAW,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAChD,UAAU,IAAI,MAAM,CAAC;IAErB,eAAe,IAAI,MAAM,CAAC;IAC1B,YAAY,IAAI,MAAM,CAAC;CAExB"}

package/types/src/license/LicenseManager.d.ts

@@ -0,0 +1,63 @@
+import { LicenseDetails } from './LicenseDetails';
+declare class LM {
+    constructor();
+    /**
+     * Set the license key provided by SheetXL.
+     * @remarks
+     * The license key can also be provided via a file named `sheetxl.lic` in the root of the web server.
+     *
+     * @param licenseKey The license key as a string.
+     * @param force If set to `true` will replace an existing key.
+     *
+     * @see
+     * {@link https://www.sheetxl.com/docs/guides/getting-started/license-key | License Keys}
+     */
+    setLicenseKey(licenseKey: string, force?: boolean): Promise<LicenseDetails>;
+    private _validate;
+    private _printDetails;
+    private _doPrint;
+    private _print;
+    /**
+     * Return the current license details.
+     */
+    getDetails(): Promise<LicenseDetails>;
+    /**
+     * Print just the banner
+     */
+    print(expanded?: boolean): Promise<void>;
+    wasPrinted(): boolean;
+    /**
+     * Disable printing of the banner for a period of time.
+     *
+     * @param The reason for suppressing the license
+     *
+     * @remarks
+     * Call this to disable the license key watermark for a period of time.
+     * This is useful for testing purposes.
+     */
+    suppressPrint(reason: string): void;
+    /**
+     * Print just the banner.
+     */
+    printBanner(): Promise<void>;
+    /**
+     * Print the current license details.
+     */
+    printDetails(expanded?: boolean, ignoreExceptions?: boolean): Promise<LicenseDetails>;
+    /**
+     * Generate a unique identifier for node.
+     *
+     * @remarks
+     * This will return `null` in the browser.
+     */
+    getFingerprint(): Promise<string>;
+}
+/**
+ * LicenseManager is used to manage license keys at runtime.
+ *
+ * License keys can be generated by visiting {@link https://www.sheetxl.com/docs/guides/getting-started/license-key | License Keys}.
+ */
+declare const LicenseManager: LM;
+export default LicenseManager;
+export { LicenseManager };
+//# sourceMappingURL=LicenseManager.d.ts.map

package/types/src/license/LicenseManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LicenseManager.d.ts","sourceRoot":"","sources":["../../../../src/license/LicenseManager.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAyOvD,cAAM,EAAE;;IAQN;;;;;;;;;;OAUG;IACG,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,GAAE,OAAa,GAAG,OAAO,CAAC,cAAc,CAAC;YAsCxE,SAAS;YAoET,aAAa;YAab,QAAQ;YAaR,MAAM;IAwBpB;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC,cAAc,CAAC;IAIrC;;OAEG;IACG,KAAK,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAK9C,UAAU,IAAI,OAAO;IAIrB;;;;;;;;OAQG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM;IAK5B;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAKlC;;OAEG;IACG,YAAY,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,gBAAgB,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC;IAM3F;;;;;OAKG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;CAIxC;AAED;;;;GAIG;AACH,QAAA,MAAM,cAAc,IAAW,CAAC;AAGhC,eAAe,cAAc,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,CAAC"}

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

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

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

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