@aidc-toolkit/app-extension 1.0.52 → 1.0.53-beta

package/dist/app-helper-proxy.js

@@ -0,0 +1,354 @@
+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"
+};
+const logLevelParameterDescriptor = {
+    name: "logLevel",
+    type: Types.String,
+    multiplicity: Multiplicities.Singleton,
+    isRequired: false
+};
+/**
+ * Application helper.
+ */
+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;
+    let _loggerStream_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,
+                    isVolatile: true,
+                    parameterDescriptors: [logLevelParameterDescriptor]
+                })];
+            _loggerStream_decorators = [proxy.describeMethod({
+                    type: Types.String,
+                    multiplicity: Multiplicities.Array,
+                    isHidden: true,
+                    isStream: true,
+                    parameterDescriptors: [logLevelParameterDescriptor]
+                })];
+            __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(this, null, _loggerStream_decorators, { kind: "method", name: "loggerStream", static: false, private: false, access: { has: obj => "loggerStream" in obj, get: obj => obj.loggerStream }, 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. This is a snapshot, with the option to change the log level for the next call.
+         *
+         * @param logLevelString
+         * Log level as string.
+         *
+         * @returns
+         * Logger messages.
+         */
+        loggerMessages(logLevelString) {
+            const appExtension = this.appExtension;
+            let logLevel = undefined;
+            if (!isNullish(logLevelString)) {
+                try {
+                    logLevel = logLevelOf(logLevelString);
+                }
+                catch {
+                    // Ignore error.
+                }
+            }
+            // Set log level if required.
+            if (logLevel !== undefined) {
+                appExtension.logger.settings.minLevel = logLevel;
+            }
+            return appExtension.memoryTransport.messages.map(message => [message]);
+        }
+        /**
+         * Get the logger messages as a stream.
+         *
+         * @param logLevelString
+         * Log level as string.
+         *
+         * @param streamingContext
+         * Streaming context.
+         */
+        loggerStream(logLevelString, streamingContext) {
+            if (isNullish(streamingContext)) {
+                // Application error; no localization necessary.
+                throw new Error("Streaming context not provided by application");
+            }
+            const appExtension = this.appExtension;
+            let notificationCallbackAdded = false;
+            let previousLogLevel = undefined;
+            const streamingConsumerCallback = appExtension.installStreaming(streamingContext, () => {
+                if (notificationCallbackAdded) {
+                    appExtension.memoryTransport.removeNotificationCallback(AppHelperProxy.name);
+                }
+                if (previousLogLevel !== undefined) {
+                    appExtension.logger.settings.minLevel = previousLogLevel;
+                }
+            });
+            if (appExtension.memoryTransport.addNotificationCallback(AppHelperProxy.name, (_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 stream 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-Df-lif4q.d.cts → descriptor.d.ts}

@@ -10,7 +10,7 @@ interface Descriptor {
 /**
  * Types supported by proxy methods.
  */
-declare const Types: {
+export declare const Types: {
     /**
      * String.
      */
@@ -31,15 +31,15 @@ declare const Types: {
 /**
  * Type key.
  */
-type TypeKey = keyof typeof Types;
+export type TypeKey = keyof typeof Types;
 /**
  * Type.
  */
-type Type = typeof Types[TypeKey];
+export type Type = typeof Types[TypeKey];
 /**
  * Multiplicities supported by proxy methods.
  */
-declare const Multiplicities: {
+export declare const Multiplicities: {
     /**
      * Parameter or return value is a singleton.
      */
@@ -61,11 +61,11 @@ declare const Multiplicities: {
 /**
  * Multiplicity key.
  */
-type MultiplicityKey = keyof typeof Multiplicities;
+export type MultiplicityKey = keyof typeof Multiplicities;
 /**
  * Multiplicity.
  */
-type Multiplicity = typeof Multiplicities[MultiplicityKey];
+export type Multiplicity = typeof Multiplicities[MultiplicityKey];
 /**
  * Type descriptor.
  */
@@ -82,7 +82,7 @@ interface TypeDescriptor extends Descriptor {
 /**
  * Parameter descriptor.
  */
-interface ParameterDescriptor extends TypeDescriptor {
+export interface ParameterDescriptor extends TypeDescriptor {
     /**
      * True if required.
      */
@@ -91,7 +91,7 @@ interface ParameterDescriptor extends TypeDescriptor {
 /**
  * Extends parameter descriptor.
  */
-interface ExtendsParameterDescriptor extends Partial<ParameterDescriptor> {
+export interface ExtendsParameterDescriptor extends Partial<ParameterDescriptor> {
     /**
      * Parameter descriptor that this one extends.
      */
@@ -104,7 +104,7 @@ interface ExtendsParameterDescriptor extends Partial<ParameterDescriptor> {
 /**
  * Replacement parameter descriptor.
  */
-interface ReplacementParameterDescriptor {
+export interface ReplacementParameterDescriptor {
     /**
      * Name to replace.
      */
@@ -117,7 +117,7 @@ interface ReplacementParameterDescriptor {
 /**
  * Method descriptor.
  */
-interface MethodDescriptor extends TypeDescriptor {
+export interface MethodDescriptor extends TypeDescriptor {
     /**
      * If true, method is asynchronous.
      */
@@ -159,7 +159,7 @@ interface MethodDescriptor extends TypeDescriptor {
 /**
  * Class descriptor.
  */
-interface ClassDescriptor extends Descriptor {
+export interface ClassDescriptor extends Descriptor {
     /**
      * Class namespace. If not provided, class is at the top level.
      */
@@ -181,5 +181,5 @@ interface ClassDescriptor extends Descriptor {
      */
     readonly methodDescriptors: readonly MethodDescriptor[];
 }
-
-export { type ClassDescriptor as C, type ExtendsParameterDescriptor as E, type MethodDescriptor as M, type ParameterDescriptor as P, type ReplacementParameterDescriptor as R, type Type as T, Multiplicities as a, type Multiplicity as b, type MultiplicityKey as c, type TypeKey as d, Types as e };
+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":"AAAA;;GAEG;AACH,UAAU,UAAU;IAChB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,eAAO,MAAM,KAAK;IACd;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;CAEG,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,MAAM,OAAO,KAAK,CAAC;AAEzC;;GAEG;AACH,MAAM,MAAM,IAAI,GAAG,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC;AAEzC;;GAEG;AACH,eAAO,MAAM,cAAc;IACvB;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;;OAGG;;CAEG,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,cAAc,CAAC;AAE1D;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,cAAc,CAAC,eAAe,CAAC,CAAC;AAElE;;GAEG;AACH,UAAU,cAAe,SAAQ,UAAU;IACvC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;CACvC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,cAAc;IACvD;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,0BAA2B,SAAQ,OAAO,CAAC,mBAAmB,CAAC;IAC5E;;OAEG;IACH,QAAQ,CAAC,iBAAiB,EAAE,mBAAmB,GAAG,0BAA0B,CAAC;IAE7E;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC3C;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,mBAAmB,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,cAAc;IACpD;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC;IAExB;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC;IAEzB;;OAEG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,IAAI,CAAC;IAEhC;;OAEG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC;IAEzB;;OAEG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC;IAE5B;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,oBAAoB,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAE9D;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,UAAU;IAC/C;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAExC;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAE1C;;OAEG;IACH,QAAQ,CAAC,+BAA+B,CAAC,EAAE,8BAA8B,EAAE,CAAC;IAE5E;;OAEG;IACH,QAAQ,CAAC,iBAAiB,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAC3D"}

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"}

package/dist/generator/functions-generator.d.ts

@@ -0,0 +1,103 @@
+import { type ClassDescriptor, type MethodDescriptor, type ParameterDescriptor } from "../descriptor.js";
+import { type FunctionLocalization, Generator, type Localization } from "./generator.js";
+/**
+ * Class type alias.
+ */
+export interface ClassTypeAlias {
+    /**
+     * Name.
+     */
+    readonly name: string;
+    /**
+     * Getter function.
+     */
+    readonly getter: string;
+    /**
+     * Declaration associating name with implementation type and creating getter function.
+     */
+    readonly declaration: string[];
+}
+/**
+ * Function implementation.
+ */
+export interface FunctionImplementation {
+    /**
+     * Function name.
+     */
+    readonly functionName: string;
+    /**
+     * Parameter localizations with JavaScript type and parameter descriptor.
+     */
+    readonly parameterLocalizations: ReadonlyArray<Localization & {
+        /**
+         * JavaScript type.
+         */
+        javaScriptType: string;
+        /**
+         * Parameter descriptor.
+         */
+        parameterDescriptor?: ParameterDescriptor;
+    }>;
+    /**
+     * Declaration.
+     */
+    readonly declaration: string[];
+}
+/**
+ * Generator with helpers for writing TypeScript functions file.
+ */
+export declare abstract class FunctionsGenerator extends Generator {
+    #private;
+    protected static readonly BASE_IMPORTS: string[];
+    /**
+     * Constructor.
+     *
+     * @param version
+     * Package version.
+     *
+     * @param inline
+     * If true, functions are declared inline rather than using `function`.
+     *
+     * @param supportsContext
+     * If true, application extension supports context.
+     */
+    constructor(version: string, inline: boolean, supportsContext: boolean);
+    /**
+     * Get the class type alias.
+     */
+    get classTypeAlias(): ClassTypeAlias;
+    /**
+     * Get the import statement for a namespace.
+     *
+     * @param namespace
+     * Namespace.
+     *
+     * @returns
+     * Import statement.
+     */
+    protected getNamespaceImport(namespace: string): string;
+    /**
+     * @inheritDoc
+     */
+    protected createClassProxy(classDescriptor: ClassDescriptor): void;
+    /**
+     * Get a function implementation.
+     *
+     * @param methodDescriptor
+     * Method descriptor.
+     *
+     * @param functionNamePrefix
+     * Function name prefix.
+     *
+     * @param functionLocalization
+     * Function localization. May be undefined for hidden functions, in which case generated
+     *
+     * @param parameterCallback
+     * Callback to modify parameter in implementation function call.
+     *
+     * @returns
+     * Function implementation.
+     */
+    protected getFunctionImplementation(methodDescriptor: MethodDescriptor, functionNamePrefix: string, functionLocalization: FunctionLocalization | undefined, parameterCallback?: (name: string, parameterDescriptor: ParameterDescriptor) => string): FunctionImplementation;
+}
+//# sourceMappingURL=functions-generator.d.ts.map

package/dist/generator/functions-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"functions-generator.d.ts","sourceRoot":"","sources":["../../src/generator/functions-generator.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EAG3B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,KAAK,oBAAoB,EAAE,SAAS,EAAE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEzF;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACnC;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,sBAAsB,EAAE,aAAa,CAAC,YAAY,GAAG;QAC1D;;WAEG;QACH,cAAc,EAAE,MAAM,CAAC;QAEvB;;WAEG;QACH,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;KAC7C,CAAC,CAAC;IAEH;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC;CAClC;AAED;;GAEG;AACH,8BAAsB,kBAAmB,SAAQ,SAAS;;IAgBtD,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,WAGpC;IAiBF;;;;;;;;;;;OAWG;gBACS,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,OAAO;IAOtE;;OAEG;IACH,IAAI,cAAc,IAAI,cAAc,CAEnC;IAED;;;;;;;;OAQG;IACH,SAAS,CAAC,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAIvD;;OAEG;cACgB,gBAAgB,CAAC,eAAe,EAAE,eAAe,GAAG,IAAI;IA6B3E;;;;;;;;;;;;;;;;;OAiBG;IACH,SAAS,CAAC,yBAAyB,CAAC,gBAAgB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,EAAE,oBAAoB,EAAE,oBAAoB,GAAG,SAAS,EAAE,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,mBAAmB,EAAE,mBAAmB,KAAK,MAAM,GAAG,sBAAsB;CAyE9Q"}