@aidc-toolkit/app-extension 1.0.23-beta → 1.0.24-beta

package/dist/app-extension.d.ts

@@ -1,169 +0,0 @@
-import type { ErrorExtends, ResultError, SheetAddress, SheetRange, TypedAsyncFunction, TypedFunction, TypedSyncFunction } from "./types.js";
-/**
- * Application extension.
- *
- * @template TBigInt
- * Type to which big integer is mapped.
- *
- * @template ThrowError
- * If true, errors are reported through the throw/catch mechanism.
- *
- * @template TError
- * Error type.
- */
-export declare abstract class AppExtension<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> {
-    /**
-     * Application version.
-     */
-    private readonly _version;
-    /**
-     * Maximum sequence count supported by application.
-     */
-    private readonly _maximumSequenceCount;
-    /**
-     * If true, errors are reported through the throw/catch mechanism.
-     */
-    private readonly _throwError;
-    /**
-     * Maximum width supported by application.
-     */
-    private _maximumWidth?;
-    /**
-     * Maximum height supported by application.
-     */
-    private _maximumHeight?;
-    /**
-     * Constructor.
-     *
-     * @param version
-     * Application version.
-     *
-     * @param maximumSequenceCount
-     * Maximum sequence count supported by application.
-     *
-     * @param throwError
-     * If true, errors are reported through the throw/catch mechanism.
-     */
-    protected constructor(version: string, maximumSequenceCount: number, throwError: ThrowError);
-    /**
-     * Get the version.
-     *
-     * @returns
-     * Version.
-     */
-    get version(): string;
-    /**
-     * Determine if errors are reported through the throw/catch mechanism.
-     */
-    get throwError(): ThrowError;
-    /**
-     * Get the maximum width supported by the application.
-     *
-     * @returns
-     * Maximum width supported by the application.
-     */
-    maximumWidth(): Promise<number>;
-    /**
-     * Get the maximum width supported by the application.
-     *
-     * @returns
-     * Maximum width supported by the application.
-     */
-    protected abstract getMaximumWidth(): Promise<number>;
-    /**
-     * Get the maximum height supported by the application.
-     *
-     * @returns
-     * Maximum height supported by the application.
-     */
-    maximumHeight(): Promise<number>;
-    /**
-     * Get the maximum height supported by the application.
-     *
-     * @returns
-     * Maximum height supported by the application.
-     */
-    protected abstract getMaximumHeight(): Promise<number>;
-    /**
-     * Get the sheet address from an invocation context.
-     *
-     * @param invocationContext
-     * Invocation context.
-     *
-     * @returns
-     * Sheet address.
-     */
-    abstract getSheetAddress(invocationContext: TInvocationContext): Promise<SheetAddress>;
-    /**
-     * Get a parameter range from an invocation context.
-     *
-     * @param invocationContext
-     * Invocation context.
-     *
-     * @param parameterNumber
-     * Parameter number.
-     *
-     * @returns
-     * Sheet range or null if parameter is not a range.
-     */
-    abstract getParameterSheetRange(invocationContext: TInvocationContext, parameterNumber: number): Promise<SheetRange | null>;
-    /**
-     * Validate a sequence count against the maximum supported by application.
-     *
-     * @param sequenceCount
-     * Sequence count.
-     */
-    validateSequenceCount(sequenceCount: number): void;
-    /**
-     * Map big integer to another type if necessary.
-     *
-     * @param value
-     * Big integer value to map.
-     *
-     * @returns
-     * Mapped big integer value.
-     */
-    abstract mapBigInt(value: bigint): ResultError<TBigInt, ThrowError, TError>;
-    /**
-     * Map a range error (thrown by the library) to an application-specific error. If errors are reported through the
-     * throw/catch mechanism, the implementation may return the range error unmodified if that is supported.
-     *
-     * @param rangeError
-     */
-    abstract mapRangeError(rangeError: RangeError): TError;
-    /**
-     * Handle an error with a message; called when an exception occurs outside the control of the AIDC Toolkit library.
-     * Implementation must not return, most likely by throwing the message wrapped in an error type.
-     *
-     * @param message
-     * Message to include in the error.
-     */
-    abstract handleError(message: string): never;
-    /**
-     * Bind a synchronous method and wrap it in a try/catch for comprehensive error handling.
-     *
-     * @param thisArg
-     * The value to be passed as the `this` parameter to the method.
-     *
-     * @param method
-     * Method to call.
-     *
-     * @returns
-     * Function wrapped around the method.
-     */
-    bindSync<TMethod extends TypedSyncFunction<TMethod>>(thisArg: ThisParameterType<TMethod>, method: TMethod): TypedFunction<TMethod>;
-    /**
-     * Bind an asynchronous method and wrap it in a try/catch for comprehensive error handling.
-     *
-     * @param thisArg
-     * The value to be passed as the `this` parameter to the method.
-     *
-     * @param method
-     * Method to call.
-     *
-     * @returns
-     * Function wrapped around the method.
-     */
-    bindAsync<TMethod extends TypedAsyncFunction<TMethod>>(thisArg: ThisParameterType<TMethod>, method: TMethod): TypedAsyncFunction<TMethod>;
-}
-//# sourceMappingURL=app-extension.d.ts.map

package/dist/app-extension.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"app-extension.d.ts","sourceRoot":"","sources":["../src/app-extension.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACR,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,UAAU,EACV,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACpB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;GAWG;AACH,8BAAsB,YAAY,CAAC,UAAU,SAAS,OAAO,EAAE,MAAM,SAAS,YAAY,CAAC,UAAU,CAAC,EAAE,kBAAkB,EAAE,OAAO;IAC/H;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAElC;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAS;IAE/C;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;IAEzC;;OAEG;IACH,OAAO,CAAC,aAAa,CAAC,CAAS;IAE/B;;OAEG;IACH,OAAO,CAAC,cAAc,CAAC,CAAS;IAEhC;;;;;;;;;;;OAWG;IACH,SAAS,aAAa,OAAO,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU;IAM3F;;;;;OAKG;IACH,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,UAAU,CAE3B;IAED;;;;;OAKG;IACG,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAMrC;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,CAAC,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC;IAErD;;;;;OAKG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAMtC;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,CAAC,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;IAEtD;;;;;;;;OAQG;IACH,QAAQ,CAAC,eAAe,CAAC,iBAAiB,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC;IAEtF;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,sBAAsB,CAAC,iBAAiB,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAE3H;;;;;OAKG;IACH,qBAAqB,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI;IAWlD;;;;;;;;OAQG;IACH,QAAQ,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC;IAE3E;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM;IAEtD;;;;;;OAMG;IACH,QAAQ,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK;IAE5C;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,OAAO,SAAS,iBAAiB,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,iBAAiB,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC;IAelI;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,OAAO,SAAS,kBAAkB,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,iBAAiB,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,GAAG,kBAAkB,CAAC,OAAO,CAAC;CAU5I"}

package/dist/app-extension.js

@@ -1,148 +0,0 @@
-import { i18nextAppExtension } from "./locale/i18n.js";
-/**
- * Application extension.
- *
- * @template TBigInt
- * Type to which big integer is mapped.
- *
- * @template ThrowError
- * If true, errors are reported through the throw/catch mechanism.
- *
- * @template TError
- * Error type.
- */
-export class AppExtension {
-    /**
-     * Application version.
-     */
-    _version;
-    /**
-     * Maximum sequence count supported by application.
-     */
-    _maximumSequenceCount;
-    /**
-     * If true, errors are reported through the throw/catch mechanism.
-     */
-    _throwError;
-    /**
-     * Maximum width supported by application.
-     */
-    _maximumWidth;
-    /**
-     * Maximum height supported by application.
-     */
-    _maximumHeight;
-    /**
-     * Constructor.
-     *
-     * @param version
-     * Application version.
-     *
-     * @param maximumSequenceCount
-     * Maximum sequence count supported by application.
-     *
-     * @param throwError
-     * If true, errors are reported through the throw/catch mechanism.
-     */
-    constructor(version, maximumSequenceCount, throwError) {
-        this._version = version;
-        this._maximumSequenceCount = maximumSequenceCount;
-        this._throwError = throwError;
-    }
-    /**
-     * Get the version.
-     *
-     * @returns
-     * Version.
-     */
-    get version() {
-        return this._version;
-    }
-    /**
-     * Determine if errors are reported through the throw/catch mechanism.
-     */
-    get throwError() {
-        return this._throwError;
-    }
-    /**
-     * Get the maximum width supported by the application.
-     *
-     * @returns
-     * Maximum width supported by the application.
-     */
-    async maximumWidth() {
-        this._maximumWidth ??= await this.getMaximumWidth();
-        return this._maximumWidth;
-    }
-    /**
-     * Get the maximum height supported by the application.
-     *
-     * @returns
-     * Maximum height supported by the application.
-     */
-    async maximumHeight() {
-        this._maximumHeight ??= await this.getMaximumHeight();
-        return this._maximumHeight;
-    }
-    /**
-     * Validate a sequence count against the maximum supported by application.
-     *
-     * @param sequenceCount
-     * Sequence count.
-     */
-    validateSequenceCount(sequenceCount) {
-        const absoluteSequenceCount = Math.abs(sequenceCount);
-        if (absoluteSequenceCount > this._maximumSequenceCount) {
-            throw new RangeError(i18nextAppExtension.t("AppExtension.sequenceCountMustBeLessThanOrEqualTo", {
-                sequenceCount: absoluteSequenceCount,
-                maximumSequenceCount: this._maximumSequenceCount
-            }));
-        }
-    }
-    /**
-     * Bind a synchronous method and wrap it in a try/catch for comprehensive error handling.
-     *
-     * @param thisArg
-     * The value to be passed as the `this` parameter to the method.
-     *
-     * @param method
-     * Method to call.
-     *
-     * @returns
-     * Function wrapped around the method.
-     */
-    bindSync(thisArg, method) {
-        const boundMethod = method.bind(thisArg);
-        return (...args) => {
-            try {
-                return boundMethod(...args);
-            }
-            catch (e) {
-                // eslint-disable-next-line no-console -- Necessary for diagnostics.
-                console.error(e);
-                this.handleError(e instanceof Error ? e.message : String(e));
-            }
-        };
-    }
-    /**
-     * Bind an asynchronous method and wrap it in a try/catch for comprehensive error handling.
-     *
-     * @param thisArg
-     * The value to be passed as the `this` parameter to the method.
-     *
-     * @param method
-     * Method to call.
-     *
-     * @returns
-     * Function wrapped around the method.
-     */
-    bindAsync(thisArg, method) {
-        const boundMethod = method.bind(thisArg);
-        return async (...args) => await boundMethod(...args).catch((e) => {
-            // eslint-disable-next-line no-console -- Necessary for diagnostics.
-            console.error(e);
-            this.handleError(e instanceof Error ? e.message : String(e));
-        });
-    }
-}
-//# sourceMappingURL=app-extension.js.map

package/dist/app-extension.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"app-extension.js","sourceRoot":"","sources":["../src/app-extension.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAWvD;;;;;;;;;;;GAWG;AACH,MAAM,OAAgB,YAAY;IAC9B;;OAEG;IACc,QAAQ,CAAS;IAElC;;OAEG;IACc,qBAAqB,CAAS;IAE/C;;OAEG;IACc,WAAW,CAAa;IAEzC;;OAEG;IACK,aAAa,CAAU;IAE/B;;OAEG;IACK,cAAc,CAAU;IAEhC;;;;;;;;;;;OAWG;IACH,YAAsB,OAAe,EAAE,oBAA4B,EAAE,UAAsB;QACvF,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,IAAI,CAAC,qBAAqB,GAAG,oBAAoB,CAAC;QAClD,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;IAClC,CAAC;IAED;;;;;OAKG;IACH,IAAI,OAAO;QACP,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,IAAI,UAAU;QACV,OAAO,IAAI,CAAC,WAAW,CAAC;IAC5B,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,YAAY;QACd,IAAI,CAAC,aAAa,KAAK,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;QAEpD,OAAO,IAAI,CAAC,aAAa,CAAC;IAC9B,CAAC;IAUD;;;;;OAKG;IACH,KAAK,CAAC,aAAa;QACf,IAAI,CAAC,cAAc,KAAK,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAEtD,OAAO,IAAI,CAAC,cAAc,CAAC;IAC/B,CAAC;IAmCD;;;;;OAKG;IACH,qBAAqB,CAAC,aAAqB;QACvC,MAAM,qBAAqB,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAEtD,IAAI,qBAAqB,GAAG,IAAI,CAAC,qBAAqB,EAAE,CAAC;YACrD,MAAM,IAAI,UAAU,CAAC,mBAAmB,CAAC,CAAC,CAAC,mDAAmD,EAAE;gBAC5F,aAAa,EAAE,qBAAqB;gBACpC,oBAAoB,EAAE,IAAI,CAAC,qBAAqB;aACnD,CAAC,CAAC,CAAC;QACR,CAAC;IACL,CAAC;IA8BD;;;;;;;;;;;OAWG;IACH,QAAQ,CAA6C,OAAmC,EAAE,MAAe;QACrG,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEzC,OAAO,CAAC,GAAG,IAAyB,EAAuB,EAAE;YACzD,IAAI,CAAC;gBACD,OAAO,WAAW,CAAC,GAAG,IAAI,CAAC,CAAC;YAChC,CAAC;YAAC,OAAO,CAAU,EAAE,CAAC;gBAClB,oEAAoE;gBACpE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBAEjB,IAAI,CAAC,WAAW,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YACjE,CAAC;QACL,CAAC,CAAC;IACN,CAAC;IAED;;;;;;;;;;;OAWG;IACH,SAAS,CAA8C,OAAmC,EAAE,MAAe;QACvG,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAEzC,OAAO,KAAK,EAAE,GAAG,IAAyB,EAAE,EAAE,CAAC,MAAM,WAAW,CAAC,GAAG,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAU,EAAE,EAAE;YAC3F,oEAAoE;YACpE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAEjB,IAAI,CAAC,WAAW,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QACjE,CAAC,CAAC,CAAC;IACP,CAAC;CACJ"}

package/dist/app-utility-proxy.d.ts

@@ -1,66 +0,0 @@
-import { LibProxy } from "./lib-proxy.js";
-import { type ErrorExtends, type Matrix, type Nullishable } from "./types.js";
-/**
- * Application utilities.
- */
-export declare class AppUtilityProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends LibProxy<ThrowError, TError, TInvocationContext, TBigInt> {
-    /**
-     * Get the version.
-     *
-     * @returns
-     * Version.
-     */
-    version(): string;
-    /**
-     * Provide default values for maximum width and height if required.
-     *
-     * @param maximumDimensions
-     * Maximum dimensions provided to function.
-     *
-     * @param invocationContext
-     * Invocation context.
-     *
-     * @returns
-     * Array of maximum width and maximum height.
-     */
-    private defaultMaximums;
-    /**
-     * Spill a horizontal matrix vertically to fit within a maximum width and height.
-     *
-     * @param hMatrixValues
-     * Horizontal matrix values. Matrix has length 1 and contains a single array with the values.
-     *
-     * @param maximumWidth
-     * Maximum width.
-     *
-     * @param maximumHeight
-     * Maximum height.
-     *
-     * @param invocationContext
-     * Invocation context.
-     *
-     * @returns
-     * Matrix spilled within maximum width and maximum height.
-     */
-    vSpill(hMatrixValues: Matrix<unknown>, maximumWidth: Nullishable<number>, maximumHeight: Nullishable<number>, invocationContext: Nullishable<TInvocationContext>): Promise<Matrix<unknown>>;
-    /**
-     * Spill a vertical matrix horizontally to fit within a maximum width and height.
-     *
-     * @param vMatrixValues
-     * Vertical matrix values. Matrix contains arrays of length 1 with the values.
-     *
-     * @param maximumHeight
-     * Maximum height.
-     *
-     * @param maximumWidth
-     * Maximum width.
-     *
-     * @param invocationContext
-     * Invocation context.
-     *
-     * @returns
-     * Matrix spilled within maximum height and maximum width.
-     */
-    hSpill(vMatrixValues: Matrix<unknown>, maximumHeight: Nullishable<number>, maximumWidth: Nullishable<number>, invocationContext: Nullishable<TInvocationContext>): Promise<Matrix<unknown>>;
-}
-//# sourceMappingURL=app-utility-proxy.d.ts.map

package/dist/app-utility-proxy.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"app-utility-proxy.d.ts","sourceRoot":"","sources":["../src/app-utility-proxy.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EAAE,KAAK,YAAY,EAAa,KAAK,MAAM,EAAuB,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AA2C9G;;GAEG;AACH,qBACa,eAAe,CAAC,UAAU,SAAS,OAAO,EAAE,MAAM,SAAS,YAAY,CAAC,UAAU,CAAC,EAAE,kBAAkB,EAAE,OAAO,CAAE,SAAQ,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,kBAAkB,EAAE,OAAO,CAAC;IAC5L;;;;;OAKG;IAKH,OAAO,IAAI,MAAM;IAIjB;;;;;;;;;;;OAWG;YACW,eAAe;IA6B7B;;;;;;;;;;;;;;;;;OAiBG;IAMG,MAAM,CACqB,aAAa,EAAE,MAAM,CAAC,OAAO,CAAC,EACL,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,EAChC,aAAa,EAAE,WAAW,CAAC,MAAM,CAAC,EACzF,iBAAiB,EAAE,WAAW,CAAC,kBAAkB,CAAC,GACnD,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAmD3B;;;;;;;;;;;;;;;;;OAiBG;IAMG,MAAM,CACqB,aAAa,EAAE,MAAM,CAAC,OAAO,CAAC,EACJ,aAAa,EAAE,WAAW,CAAC,MAAM,CAAC,EACnC,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,EACvF,iBAAiB,EAAE,WAAW,CAAC,kBAAkB,CAAC,GACnD,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;CAoD9B"}

package/dist/app-utility-proxy.js

@@ -1,233 +0,0 @@
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
-var __param = (this && this.__param) || function (paramIndex, decorator) {
-    return function (target, key) { decorator(target, key, paramIndex); }
-};
-import { ProxyClass, ProxyMethod, ProxyParameter, Types } from "./descriptor.js";
-import { LibProxy } from "./lib-proxy.js";
-import { i18nextAppExtension } from "./locale/i18n.js";
-import { isNullish } from "./types.js";
-const spillMatrix = {
-    name: "spillMatrix",
-    type: Types.Any,
-    isMatrix: true,
-    isRequired: true
-};
-const spillMaximumParameterDescriptor = {
-    name: "spillMaximum",
-    type: Types.Number,
-    isMatrix: false,
-    isRequired: false
-};
-const spillMaximumWidthParameterDescriptor = {
-    extendsDescriptor: spillMaximumParameterDescriptor,
-    sortOrder: 0,
-    name: "spillMaximumWidth"
-};
-const spillMaximumHeightParameterDescriptor = {
-    extendsDescriptor: spillMaximumParameterDescriptor,
-    sortOrder: 1,
-    name: "spillMaximumHeight"
-};
-/**
- * Application utilities.
- */
-let AppUtilityProxy = class AppUtilityProxy extends LibProxy {
-    /**
-     * Get the version.
-     *
-     * @returns
-     * Version.
-     */
-    version() {
-        return this.appExtension.version;
-    }
-    /**
-     * Provide default values for maximum width and height if required.
-     *
-     * @param maximumDimensions
-     * Maximum dimensions provided to function.
-     *
-     * @param invocationContext
-     * Invocation context.
-     *
-     * @returns
-     * Array of maximum width and maximum height.
-     */
-    async defaultMaximums(maximumDimensions, invocationContext) {
-        if (isNullish(invocationContext)) {
-            // Application error; no localization necessary.
-            throw new Error("Invocation context not provided by application");
-        }
-        const maximumWidth = maximumDimensions.width;
-        const maximumHeight = maximumDimensions.height;
-        let definedMaximumWidth;
-        let definedMaximumHeight;
-        // Skip any extra work if both values are provided.
-        if (isNullish(maximumWidth) || isNullish(maximumHeight)) {
-            const sheetAddress = await this.appExtension.getSheetAddress(invocationContext);
-            definedMaximumWidth = maximumWidth ?? await this.appExtension.maximumWidth() - sheetAddress.columnIndex;
-            definedMaximumHeight = maximumHeight ?? await this.appExtension.maximumHeight() - sheetAddress.rowIndex;
-        }
-        else {
-            definedMaximumWidth = maximumWidth;
-            definedMaximumHeight = maximumHeight;
-        }
-        return {
-            width: definedMaximumWidth,
-            height: definedMaximumHeight
-        };
-    }
-    /**
-     * Spill a horizontal matrix vertically to fit within a maximum width and height.
-     *
-     * @param hMatrixValues
-     * Horizontal matrix values. Matrix has length 1 and contains a single array with the values.
-     *
-     * @param maximumWidth
-     * Maximum width.
-     *
-     * @param maximumHeight
-     * Maximum height.
-     *
-     * @param invocationContext
-     * Invocation context.
-     *
-     * @returns
-     * Matrix spilled within maximum width and maximum height.
-     */
-    async vSpill(hMatrixValues, maximumWidth, maximumHeight, invocationContext) {
-        let result;
-        if (hMatrixValues.length !== 1) {
-            throw new RangeError(i18nextAppExtension.t("Proxy.vSpillMustBeHorizontalArray"));
-        }
-        const maximumDimensions = await this.defaultMaximums({
-            width: maximumWidth,
-            height: maximumHeight
-        }, invocationContext);
-        const hArrayValues = hMatrixValues[0];
-        const hLength = hArrayValues.length;
-        const maximumArea = maximumDimensions.width * maximumDimensions.height;
-        // Lengths 0 and 1 are valid and require no special processing.
-        if (hLength > 1 && hLength <= maximumArea) {
-            // Make spill as square as possible.
-            let spillWidth = Math.min(Math.ceil(Math.sqrt(maximumArea)), maximumDimensions.width);
-            // Array that has a length of a power of 10 is treated specially.
-            if (Number.isInteger(Math.log10(hLength))) {
-                // Try spill width that is a power of 10.
-                const spillWidth10 = Math.pow(10, Math.floor(Math.log10(spillWidth)));
-                // Keep default if not enough space for power of 10 matrix.
-                if (hLength / spillWidth10 <= maximumDimensions.height) {
-                    spillWidth = spillWidth10;
-                }
-            }
-            result = [];
-            let hStartIndex = 0;
-            do {
-                const hEndIndex = hStartIndex + spillWidth;
-                result.push(hArrayValues.slice(hStartIndex, hEndIndex));
-                hStartIndex = hEndIndex;
-            } while (hStartIndex < hLength);
-        }
-        else {
-            // Return matrix unmodified and let application handle spill error if any.
-            result = hMatrixValues;
-        }
-        return result;
-    }
-    /**
-     * Spill a vertical matrix horizontally to fit within a maximum width and height.
-     *
-     * @param vMatrixValues
-     * Vertical matrix values. Matrix contains arrays of length 1 with the values.
-     *
-     * @param maximumHeight
-     * Maximum height.
-     *
-     * @param maximumWidth
-     * Maximum width.
-     *
-     * @param invocationContext
-     * Invocation context.
-     *
-     * @returns
-     * Matrix spilled within maximum height and maximum width.
-     */
-    async hSpill(vMatrixValues, maximumHeight, maximumWidth, invocationContext) {
-        let result;
-        for (const hArrayValues of vMatrixValues) {
-            // This test should be necessary only once but account for zero-size matrix and misuse of method.
-            if (hArrayValues.length !== 1) {
-                throw new RangeError(i18nextAppExtension.t("Proxy.hSpillMustBeVerticalArray"));
-            }
-        }
-        const maximumDimensions = await this.defaultMaximums({
-            width: maximumWidth,
-            height: maximumHeight
-        }, invocationContext);
-        const vLength = vMatrixValues.length;
-        const maximumArea = maximumDimensions.width * maximumDimensions.height;
-        // Lengths 0 and 1 are valid and require no special processing.
-        if (vLength > 1 && vLength <= maximumArea) {
-            // Make spill as square as possible.
-            let spillHeight = Math.min(Math.ceil(Math.sqrt(maximumArea)), maximumDimensions.height);
-            // Array that has a length of a power of 10 is treated specially.
-            if (Number.isInteger(Math.log10(vLength))) {
-                // Try spill height that is a power of 10.
-                const spillHeight10 = Math.pow(10, Math.floor(Math.log10(spillHeight)));
-                // Keep default if not enough space for power of 10 matrix.
-                if (vLength / spillHeight10 <= maximumDimensions.width) {
-                    spillHeight = spillHeight10;
-                }
-            }
-            result = [];
-            for (let rowIndex = 0; rowIndex < spillHeight; rowIndex++) {
-                const row = new Array();
-                for (let cellIndex = rowIndex; cellIndex < vLength; cellIndex++) {
-                    row.push(vMatrixValues[cellIndex][0]);
-                }
-                result.push(row);
-            }
-        }
-        else {
-            // Return matrix unmodified and let application handle spill error if any.
-            result = vMatrixValues;
-        }
-        return result;
-    }
-};
-__decorate([
-    ProxyMethod({
-        type: Types.String,
-        isMatrix: false
-    })
-], AppUtilityProxy.prototype, "version", null);
-__decorate([
-    ProxyMethod({
-        requiresContext: true,
-        type: Types.Any,
-        isMatrix: true
-    }),
-    __param(0, ProxyParameter(spillMatrix)),
-    __param(1, ProxyParameter(spillMaximumWidthParameterDescriptor)),
-    __param(2, ProxyParameter(spillMaximumHeightParameterDescriptor))
-], AppUtilityProxy.prototype, "vSpill", null);
-__decorate([
-    ProxyMethod({
-        requiresContext: true,
-        type: Types.Any,
-        isMatrix: true
-    }),
-    __param(0, ProxyParameter(spillMatrix)),
-    __param(1, ProxyParameter(spillMaximumHeightParameterDescriptor)),
-    __param(2, ProxyParameter(spillMaximumWidthParameterDescriptor))
-], AppUtilityProxy.prototype, "hSpill", null);
-AppUtilityProxy = __decorate([
-    ProxyClass()
-], AppUtilityProxy);
-export { AppUtilityProxy };
-//# sourceMappingURL=app-utility-proxy.js.map

package/dist/app-utility-proxy.js.map

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