@aidc-toolkit/app-extension 1.0.45 → 1.0.46-beta

package/dist/app-helper-proxy.js

@@ -0,0 +1,333 @@
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+import { isNullish, logLevelOf } from "@aidc-toolkit/core";
+import { Multiplicities, Types } from "./descriptor.js";
+import { LibProxy } from "./lib-proxy.js";
+import { i18nextAppExtension } from "./locale/i18n.js";
+import { proxy } from "./proxy.js";
+const spillArrayParameterDescriptor = {
+    name: "spillArray",
+    type: Types.Any,
+    multiplicity: Multiplicities.Array,
+    isRequired: true
+};
+const spillMaximumParameterDescriptor = {
+    name: "spillMaximum",
+    type: Types.Number,
+    multiplicity: Multiplicities.Singleton,
+    isRequired: false
+};
+const spillMaximumWidthParameterDescriptor = {
+    extendsDescriptor: spillMaximumParameterDescriptor,
+    sortOrder: 0,
+    name: "spillMaximumWidth"
+};
+const spillMaximumHeightParameterDescriptor = {
+    extendsDescriptor: spillMaximumParameterDescriptor,
+    sortOrder: 1,
+    name: "spillMaximumHeight"
+};
+/**
+ * Application utilities.
+ *
+ * @template ThrowError
+ * If true, errors are reported through the throw/catch mechanism.
+ *
+ * @template TError
+ * Error type.
+ *
+ * @template TInvocationContext
+ * Application-specific invocation context type.
+ *
+ * @template TStreamingInvocationContext
+ * Application-specific streaming invocation context type.
+ *
+ * @template TBigInt
+ * Type to which big integer is mapped.
+ */
+let AppHelperProxy = (() => {
+    let _classDecorators = [proxy.describeClass(false, {
+            category: "helper"
+        })];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _classSuper = LibProxy;
+    let _instanceExtraInitializers = [];
+    let _version_decorators;
+    let _spill_decorators;
+    let _loggerMessages_decorators;
+    var AppHelperProxy = class extends _classSuper {
+        static { _classThis = this; }
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _version_decorators = [proxy.describeMethod({
+                    type: Types.String,
+                    multiplicity: Multiplicities.Singleton,
+                    parameterDescriptors: []
+                })];
+            _spill_decorators = [proxy.describeMethod({
+                    type: Types.Any,
+                    multiplicity: Multiplicities.Matrix,
+                    isAsync: true,
+                    requiresContext: true,
+                    parameterDescriptors: [spillArrayParameterDescriptor, spillMaximumHeightParameterDescriptor, spillMaximumWidthParameterDescriptor]
+                })];
+            _loggerMessages_decorators = [proxy.describeMethod({
+                    type: Types.String,
+                    multiplicity: Multiplicities.Array,
+                    isHidden: true,
+                    isStream: true,
+                    parameterDescriptors: [{
+                            name: "logLevel",
+                            type: Types.String,
+                            multiplicity: Multiplicities.Singleton,
+                            isRequired: false
+                        }]
+                })];
+            __esDecorate(this, null, _version_decorators, { kind: "method", name: "version", static: false, private: false, access: { has: obj => "version" in obj, get: obj => obj.version }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _spill_decorators, { kind: "method", name: "spill", static: false, private: false, access: { has: obj => "spill" in obj, get: obj => obj.spill }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _loggerMessages_decorators, { kind: "method", name: "loggerMessages", static: false, private: false, access: { has: obj => "loggerMessages" in obj, get: obj => obj.loggerMessages }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+            AppHelperProxy = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+        /**
+         * 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 ?? this.appExtension.maximumWidth - sheetAddress.columnIndex;
+                definedMaximumHeight = maximumHeight ?? this.appExtension.maximumHeight - sheetAddress.rowIndex;
+            }
+            else {
+                definedMaximumWidth = maximumWidth;
+                definedMaximumHeight = maximumHeight;
+            }
+            return {
+                width: definedMaximumWidth,
+                height: definedMaximumHeight
+            };
+        }
+        /**
+         * Spill a one-dimensional matrix to fit a rectangle within a given maximum height and width.
+         *
+         * @param arrayValues
+         * Matrix values. Matrix is length 1 or 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 spill(arrayValues, maximumHeight, maximumWidth, invocationContext) {
+            let result;
+            // Assume matrix is uniformly two-dimensional.
+            const height = arrayValues.length;
+            const width = height !== 0 ? arrayValues[0].length : 0;
+            const isArrayOrError = this.singletonResult(() => {
+                if (height > 1 && width > 1) {
+                    throw new RangeError(i18nextAppExtension.t("Proxy.matrixMustBeArray"));
+                }
+                return true;
+            });
+            if (isArrayOrError === true) {
+                const maximumDimensions = await this.#defaultMaximums({
+                    width: maximumWidth,
+                    height: maximumHeight
+                }, invocationContext);
+                const isHorizontal = height === 1;
+                const length = isHorizontal ? width : height;
+                const maximumParallel = isHorizontal ? maximumDimensions.width : maximumDimensions.height;
+                const maximumPerpendicular = isHorizontal ? maximumDimensions.height : maximumDimensions.width;
+                const maximumArea = maximumParallel * maximumPerpendicular;
+                // Lengths 0 and 1 are valid and require no special processing.
+                if (length > 1 && length <= maximumArea) {
+                    const lengthSquareRoot = Math.sqrt(length);
+                    let spillParallel = undefined;
+                    // Array that has a length of a power of 10 is treated specially.
+                    if (Number.isInteger(Math.log10(length))) {
+                        // Try spill that is a power of 10, favouring the parallel direction.
+                        let spillParallel10 = 10 ** Math.ceil(Math.log10(lengthSquareRoot));
+                        // Favour the perpendicular direction if not enough parallel space.
+                        if (spillParallel10 > maximumParallel) {
+                            spillParallel10 /= 10;
+                        }
+                        // Take result as the spill parallel if it fits.
+                        if (spillParallel10 <= maximumParallel && length / spillParallel10 <= maximumPerpendicular) {
+                            spillParallel = spillParallel10;
+                        }
+                    }
+                    // Make spill as square as possible, favouring the parallel direction.
+                    spillParallel ??= Math.max(Math.min(Math.ceil(lengthSquareRoot), maximumParallel), Math.floor(length / maximumPerpendicular));
+                    const spillPerpendicular = Math.ceil(length / spillParallel);
+                    result = [];
+                    if (isHorizontal) {
+                        let startIndex = 0;
+                        do {
+                            const endIndex = startIndex + spillParallel;
+                            // Each row is a slice of the original single row.
+                            const row = arrayValues[0].slice(startIndex, endIndex);
+                            // Row length will be anywhere from 1 to spillParallel.
+                            if (row.length < spillParallel) {
+                                const rowLength = row.length;
+                                row.length = spillParallel;
+                                // Fill empty cells with empty string.
+                                row.fill("", rowLength, spillParallel);
+                            }
+                            result.push(row);
+                            startIndex = endIndex;
+                        } while (startIndex < length);
+                    }
+                    else {
+                        for (let rowIndex = 0; rowIndex < spillParallel; rowIndex++) {
+                            const row = [];
+                            // Each column is a slice of the original single column.
+                            for (let valueIndex = rowIndex; valueIndex < length; valueIndex += spillParallel) {
+                                row.push(arrayValues[valueIndex][0]);
+                            }
+                            // Row length will always be spillPerpendicular or spillPerpendicular - 1.
+                            if (row.length < spillPerpendicular) {
+                                row[spillPerpendicular - 1] = "";
+                            }
+                            result.push(row);
+                        }
+                    }
+                }
+                else {
+                    // Return matrix unmodified and let application handle spill error if any.
+                    result = arrayValues;
+                }
+            }
+            else {
+                // Return error as only element in matrix.
+                result = [[isArrayOrError]];
+            }
+            return result;
+        }
+        /**
+         * Get the logger messages as a stream.
+         *
+         * @param logLevelString
+         * Log level as string.
+         *
+         * @param streamingInvocationContext
+         * Streaming invocation context.
+         */
+        loggerMessages(logLevelString, streamingInvocationContext) {
+            if (isNullish(streamingInvocationContext)) {
+                // Application error; no localization necessary.
+                throw new Error("Streaming invocation context not provided by application");
+            }
+            const appExtension = this.appExtension;
+            let notificationCallbackAdded = false;
+            let previousLogLevel = undefined;
+            const streamingConsumerCallback = appExtension.setUpStreaming(streamingInvocationContext, () => {
+                if (notificationCallbackAdded) {
+                    appExtension.memoryTransport.removeNotificationCallback("loggerMessages");
+                }
+                if (previousLogLevel !== undefined) {
+                    appExtension.logger.settings.minLevel = previousLogLevel;
+                }
+            });
+            if (appExtension.memoryTransport.addNotificationCallback("loggerMessages", (_message, messages) => {
+                streamingConsumerCallback(this.iterableResult(() => messages));
+            })) {
+                notificationCallbackAdded = true;
+                let logLevel = undefined;
+                if (!isNullish(logLevelString)) {
+                    try {
+                        logLevel = logLevelOf(logLevelString);
+                    }
+                    catch {
+                        // Ignore error.
+                    }
+                }
+                // Set log level if required.
+                if (logLevel !== undefined) {
+                    previousLogLevel = appExtension.logger.settings.minLevel;
+                    appExtension.logger.settings.minLevel = logLevel;
+                }
+            }
+            else {
+                // Diagnostic tool; localization not required.
+                streamingConsumerCallback([["Only one logger messages call allowable per workbook"]]);
+            }
+        }
+        constructor() {
+            super(...arguments);
+            __runInitializers(this, _instanceExtraInitializers);
+        }
+    };
+    return AppHelperProxy = _classThis;
+})();
+export { AppHelperProxy };
+//# sourceMappingURL=app-helper-proxy.js.map

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

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

package/dist/descriptor.d.ts

@@ -0,0 +1,197 @@
+/**
+ * Core descriptor.
+ */
+interface Descriptor {
+    /**
+     * Name.
+     */
+    readonly name: string;
+}
+/**
+ * Types supported by proxy methods.
+ */
+export declare const Types: {
+    /**
+     * String.
+     */
+    readonly String: 0;
+    /**
+     * Number or enumeration.
+     */
+    readonly Number: 1;
+    /**
+     * Boolean.
+     */
+    readonly Boolean: 2;
+    /**
+     * Any.
+     */
+    readonly Any: 3;
+};
+/**
+ * Type key.
+ */
+export type TypeKey = keyof typeof Types;
+/**
+ * Type.
+ */
+export type Type = typeof Types[TypeKey];
+/**
+ * Multiplicities supported by proxy methods.
+ */
+export declare const Multiplicities: {
+    /**
+     * Parameter or return value is a singleton.
+     */
+    readonly Singleton: 0;
+    /**
+     * Parameter or return value is a singleton or an array.
+     */
+    readonly Array: 1;
+    /**
+     * Parameter or return value is a singleton, an array, or a matrix.
+     */
+    readonly Matrix: 2;
+    /**
+     * Parameter value is a singleton or array but is treated as a singleton internally and doesn't drive multiplicity
+     * of the return value. Return value is an array for use as a singleton array parameter.
+     */
+    readonly SingletonArray: 3;
+};
+/**
+ * Multiplicity key.
+ */
+export type MultiplicityKey = keyof typeof Multiplicities;
+/**
+ * Multiplicity.
+ */
+export type Multiplicity = typeof Multiplicities[MultiplicityKey];
+/**
+ * Type descriptor.
+ */
+interface TypeDescriptor extends Descriptor {
+    /**
+     * Type.
+     */
+    readonly type: Type;
+    /**
+     * Multiplicity.
+     */
+    readonly multiplicity: Multiplicity;
+}
+/**
+ * Parameter descriptor.
+ */
+export interface ParameterDescriptor extends TypeDescriptor {
+    /**
+     * True if required.
+     */
+    readonly isRequired: boolean;
+}
+/**
+ * Extends parameter descriptor.
+ */
+export interface ExtendsParameterDescriptor extends Partial<ParameterDescriptor> {
+    /**
+     * Parameter descriptor that this one extends.
+     */
+    readonly extendsDescriptor: ParameterDescriptor | ExtendsParameterDescriptor;
+    /**
+     * Sort order within extended parameter descriptor.
+     */
+    readonly sortOrder?: number;
+}
+/**
+ * Replacement parameter descriptor.
+ */
+export interface ReplacementParameterDescriptor {
+    /**
+     * Name to replace.
+     */
+    readonly name: string;
+    /**
+     * Replacement parameter descriptor.
+     */
+    readonly replacement: ParameterDescriptor;
+}
+/**
+ * Method descriptor.
+ */
+export interface MethodDescriptor extends TypeDescriptor {
+    /**
+     * If true, method is asynchronous.
+     */
+    readonly isAsync?: true;
+    /**
+     * If true, function is hidden from user interface.
+     */
+    readonly isHidden?: true;
+    /**
+     * If true, application-specific invocation context is required.
+     */
+    readonly requiresContext?: true;
+    /**
+     * If true, function is volatile and should be reevaluated regularly.
+     */
+    readonly isVolatile?: true;
+    /**
+     * If true, function opens a stream that updates asynchronously.
+     */
+    readonly isStream?: true;
+    /**
+     * Number of characters to capitalize at the start of the method name for title case; defaults to 1.
+     */
+    readonly titleCaseStart?: number;
+    /**
+     * If true, method infix is ignored.
+     */
+    readonly ignoreInfix?: true;
+    /**
+     * String before which method infix appears. If undefined, infix is appended to the method name. Ignored if
+     * `ignoreInfix` is true.
+     */
+    readonly infixBefore?: string;
+    /**
+     * Parameter descriptors.
+     */
+    readonly parameterDescriptors: readonly ParameterDescriptor[];
+    /**
+     * Function name with optional infix.
+     */
+    readonly functionName: string;
+    /**
+     * Function name in optional namespace with optional infix.
+     */
+    readonly namespaceFunctionName: string;
+}
+/**
+ * Class descriptor.
+ */
+export interface ClassDescriptor extends Descriptor {
+    /**
+     * Class namespace. If not provided, class is at the top level.
+     */
+    readonly namespace?: string | undefined;
+    /**
+     * Category.
+     */
+    readonly category: string;
+    /**
+     * Method infix. If undefined, method name is generated verbatim.
+     */
+    readonly methodInfix?: string | undefined;
+    /**
+     * Replacement parameter descriptors  for class hierarchies where parameter types can narrow
+     */
+    readonly replacementParameterDescriptors?: ReplacementParameterDescriptor[];
+    /**
+     * Class name in optional namespace.
+     */
+    readonly namespaceClassName: string;
+    /**
+     * Method descriptors.
+     */
+    readonly methodDescriptors: readonly MethodDescriptor[];
+}
+export {};
+//# sourceMappingURL=descriptor.d.ts.map

package/dist/descriptor.d.ts.map

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

package/dist/descriptor.js

@@ -0,0 +1,44 @@
+/**
+ * Types supported by proxy methods.
+ */
+export const Types = {
+    /**
+     * String.
+     */
+    String: 0,
+    /**
+     * Number or enumeration.
+     */
+    Number: 1,
+    /**
+     * Boolean.
+     */
+    Boolean: 2,
+    /**
+     * Any.
+     */
+    Any: 3
+};
+/**
+ * Multiplicities supported by proxy methods.
+ */
+export const Multiplicities = {
+    /**
+     * Parameter or return value is a singleton.
+     */
+    Singleton: 0,
+    /**
+     * Parameter or return value is a singleton or an array.
+     */
+    Array: 1,
+    /**
+     * Parameter or return value is a singleton, an array, or a matrix.
+     */
+    Matrix: 2,
+    /**
+     * Parameter value is a singleton or array but is treated as a singleton internally and doesn't drive multiplicity
+     * of the return value. Return value is an array for use as a singleton array parameter.
+     */
+    SingletonArray: 3
+};
+//# sourceMappingURL=descriptor.js.map

package/dist/descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor.js","sourceRoot":"","sources":["../src/descriptor.ts"],"names":[],"mappings":"AAUA;;GAEG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG;IACjB;;OAEG;IACH,MAAM,EAAE,CAAC;IAET;;OAEG;IACH,MAAM,EAAE,CAAC;IAET;;OAEG;IACH,OAAO,EAAE,CAAC;IAEV;;OAEG;IACH,GAAG,EAAE,CAAC;CACA,CAAC;AAYX;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC1B;;OAEG;IACH,SAAS,EAAE,CAAC;IAEZ;;OAEG;IACH,KAAK,EAAE,CAAC;IAER;;OAEG;IACH,MAAM,EAAE,CAAC;IAET;;;OAGG;IACH,cAAc,EAAE,CAAC;CACX,CAAC"}