@aidc-toolkit/app-extension 1.0.32-beta → 1.0.34-beta

package/dist/utility/string-descriptor.js

@@ -0,0 +1,12 @@
+import { Multiplicities, Types } from "../descriptor.js";
+export const sParameterDescriptor = {
+    name: "s",
+    type: Types.String,
+    multiplicity: Multiplicities.Matrix,
+    isRequired: true
+};
+export const validateSParameterDescriptor = {
+    extendsDescriptor: sParameterDescriptor,
+    name: "validateS"
+};
+//# sourceMappingURL=string-descriptor.js.map

package/dist/utility/string-descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-descriptor.js","sourceRoot":"","sources":["../../src/utility/string-descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmC,cAAc,EAA4B,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEpH,MAAM,CAAC,MAAM,oBAAoB,GAAwB;IACrD,IAAI,EAAE,GAAG;IACT,IAAI,EAAE,KAAK,CAAC,MAAM;IAClB,YAAY,EAAE,cAAc,CAAC,MAAM;IACnC,UAAU,EAAE,IAAI;CACnB,CAAC;AAEF,MAAM,CAAC,MAAM,4BAA4B,GAA+B;IACpE,iBAAiB,EAAE,oBAAoB;IACvC,IAAI,EAAE,WAAW;CACpB,CAAC"}

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

@@ -0,0 +1,7 @@
+import type { StringValidation, StringValidator } from "@aidc-toolkit/utility";
+import { LibProxy } from "../lib-proxy.js";
+import type { ErrorExtends, Matrix } from "../type.js";
+export declare abstract class StringProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TStreamingInvocationContext, TBigInt> extends LibProxy<ThrowError, TError, TInvocationContext, TStreamingInvocationContext, TBigInt> {
+    protected validateString<TStringValidation extends StringValidation>(validator: StringValidator<TStringValidation>, matrixSs: Matrix<string>, validation?: TStringValidation): Matrix<string>;
+}
+//# sourceMappingURL=string-proxy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"string-proxy.d.ts","sourceRoot":"","sources":["../../src/utility/string-proxy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC/E,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEvD,8BAGsB,WAAW,CAAC,UAAU,SAAS,OAAO,EAAE,MAAM,SAAS,YAAY,CAAC,UAAU,CAAC,EAAE,kBAAkB,EAAE,2BAA2B,EAAE,OAAO,CAAE,SAAQ,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,kBAAkB,EAAE,2BAA2B,EAAE,OAAO,CAAC;IAC3P,SAAS,CAAC,cAAc,CAAC,iBAAiB,SAAS,gBAAgB,EAAE,SAAS,EAAE,eAAe,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC;CAKhM"}

package/dist/utility/string-proxy.js

@@ -0,0 +1,63 @@
+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;
+};
+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;
+};
+import { LibProxy } from "../lib-proxy.js";
+import { proxy } from "../proxy.js";
+let StringProxy = (() => {
+    let _classDecorators = [proxy.describeClass(true, {
+            category: "string"
+        })];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _classSuper = LibProxy;
+    var StringProxy = class extends _classSuper {
+        static { _classThis = this; }
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+            StringProxy = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+        validateString(validator, matrixSs, validation) {
+            return this.matrixErrorResult(matrixSs, (s) => {
+                validator.validate(s, validation);
+            });
+        }
+    };
+    return StringProxy = _classThis;
+})();
+export { StringProxy };
+//# sourceMappingURL=string-proxy.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"string-proxy.js","sourceRoot":"","sources":["../../src/utility/string-proxy.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;IAMd,WAAW;4BAHhC,KAAK,CAAC,aAAa,CAAC,IAAI,EAAE;YACvB,QAAQ,EAAE,QAAQ;SACrB,CAAC;;;;sBACuK,QAAQ;2BAAhB,SAAQ,WAAsF;;;;YAA/P,6KAMC;;;YANqB,uDAAW;;QACnB,cAAc,CAA6C,SAA6C,EAAE,QAAwB,EAAE,UAA8B;YACxK,OAAO,IAAI,CAAC,iBAAiB,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE;gBAC1C,SAAS,CAAC,QAAQ,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;YACtC,CAAC,CAAC,CAAC;QACP,CAAC;;;;SALiB,WAAW"}

package/dist/utility/transformer-descriptor.d.ts

@@ -0,0 +1,6 @@
+import { type ExtendsParameterDescriptor, type ParameterDescriptor } from "../descriptor.js";
+export declare const valueParameterDescriptor: ParameterDescriptor;
+export declare const startValueParameterDescriptor: ExtendsParameterDescriptor;
+export declare const countParameterDescriptor: ExtendsParameterDescriptor;
+export declare const tweakParameterDescriptor: ParameterDescriptor;
+//# sourceMappingURL=transformer-descriptor.d.ts.map

package/dist/utility/transformer-descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transformer-descriptor.d.ts","sourceRoot":"","sources":["../../src/utility/transformer-descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,0BAA0B,EAAkB,KAAK,mBAAmB,EAAS,MAAM,kBAAkB,CAAC;AAEpH,eAAO,MAAM,wBAAwB,EAAE,mBAKtC,CAAC;AAEF,eAAO,MAAM,6BAA6B,EAAE,0BAI3C,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,0BAItC,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,mBAKtC,CAAC"}

package/dist/utility/transformer-descriptor.js

@@ -0,0 +1,24 @@
+import { Multiplicities, Types } from "../descriptor.js";
+export const valueParameterDescriptor = {
+    name: "value",
+    type: Types.Number,
+    multiplicity: Multiplicities.Matrix,
+    isRequired: true
+};
+export const startValueParameterDescriptor = {
+    extendsDescriptor: valueParameterDescriptor,
+    name: "startValue",
+    multiplicity: Multiplicities.Singleton
+};
+export const countParameterDescriptor = {
+    extendsDescriptor: valueParameterDescriptor,
+    name: "count",
+    multiplicity: Multiplicities.Singleton
+};
+export const tweakParameterDescriptor = {
+    name: "tweak",
+    type: Types.Number,
+    multiplicity: Multiplicities.Singleton,
+    isRequired: false
+};
+//# sourceMappingURL=transformer-descriptor.js.map

package/dist/utility/transformer-descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transformer-descriptor.js","sourceRoot":"","sources":["../../src/utility/transformer-descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmC,cAAc,EAA4B,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEpH,MAAM,CAAC,MAAM,wBAAwB,GAAwB;IACzD,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,KAAK,CAAC,MAAM;IAClB,YAAY,EAAE,cAAc,CAAC,MAAM;IACnC,UAAU,EAAE,IAAI;CACnB,CAAC;AAEF,MAAM,CAAC,MAAM,6BAA6B,GAA+B;IACrE,iBAAiB,EAAE,wBAAwB;IAC3C,IAAI,EAAE,YAAY;IAClB,YAAY,EAAE,cAAc,CAAC,SAAS;CACzC,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAA+B;IAChE,iBAAiB,EAAE,wBAAwB;IAC3C,IAAI,EAAE,OAAO;IACb,YAAY,EAAE,cAAc,CAAC,SAAS;CACzC,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAwB;IACzD,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,KAAK,CAAC,MAAM;IAClB,YAAY,EAAE,cAAc,CAAC,SAAS;IACtC,UAAU,EAAE,KAAK;CACpB,CAAC"}

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

@@ -0,0 +1,9 @@
+import type { Nullishable } from "@aidc-toolkit/core";
+import { LibProxy } from "../lib-proxy.js";
+import type { ErrorExtends, Matrix, MatrixResult } from "../type.js";
+export declare class TransformerProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TStreamingInvocationContext, TBigInt> extends LibProxy<ThrowError, TError, TInvocationContext, TStreamingInvocationContext, TBigInt> {
+    forward(domain: number | bigint, matrixValues: Matrix<number | bigint>, tweak: Nullishable<number | bigint>): MatrixResult<TBigInt, ThrowError, TError>;
+    forwardSequence(domain: number | bigint, startValue: number, count: number, tweak: Nullishable<number | bigint>): MatrixResult<TBigInt, ThrowError, TError>;
+    reverse(domain: number | bigint, matrixTransformedValues: Matrix<number | bigint>, tweak: Nullishable<number | bigint>): MatrixResult<TBigInt, ThrowError, TError>;
+}
+//# sourceMappingURL=transformer-proxy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transformer-proxy.d.ts","sourceRoot":"","sources":["../../src/utility/transformer-proxy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAoBrE,qBAIa,gBAAgB,CAAC,UAAU,SAAS,OAAO,EAAE,MAAM,SAAS,YAAY,CAAC,UAAU,CAAC,EAAE,kBAAkB,EAAE,2BAA2B,EAAE,OAAO,CAAE,SAAQ,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,kBAAkB,EAAE,2BAA2B,EAAE,OAAO,CAAC;IAMvP,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,YAAY,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC;IAcvJ,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,YAAY,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC;IAa3J,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,uBAAuB,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,YAAY,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC;CAOrK"}

package/dist/utility/transformer-proxy.js

@@ -0,0 +1,111 @@
+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 { mapIterable, Sequence, Transformer } from "@aidc-toolkit/utility";
+import { Multiplicities, Types } from "../descriptor.js";
+import { LibProxy } from "../lib-proxy.js";
+import { proxy } from "../proxy.js";
+import { countParameterDescriptor, startValueParameterDescriptor, tweakParameterDescriptor, valueParameterDescriptor } from "./transformer-descriptor.js";
+const domainParameterDescriptor = {
+    name: "domain",
+    type: Types.Number,
+    multiplicity: Multiplicities.Singleton,
+    isRequired: true
+};
+const transformedValueParameterDescriptor = {
+    extendsDescriptor: valueParameterDescriptor,
+    name: "transformedValue"
+};
+let TransformerProxy = (() => {
+    let _classDecorators = [proxy.describeClass(false, {
+            category: "transformation",
+            methodInfix: "Transform"
+        })];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _classSuper = LibProxy;
+    let _instanceExtraInitializers = [];
+    let _forward_decorators;
+    let _forwardSequence_decorators;
+    let _reverse_decorators;
+    var TransformerProxy = class extends _classSuper {
+        static { _classThis = this; }
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _forward_decorators = [proxy.describeMethod({
+                    type: Types.Number,
+                    multiplicity: Multiplicities.Matrix,
+                    parameterDescriptors: [domainParameterDescriptor, valueParameterDescriptor, tweakParameterDescriptor]
+                })];
+            _forwardSequence_decorators = [proxy.describeMethod({
+                    infixBefore: "Sequence",
+                    type: Types.Number,
+                    multiplicity: Multiplicities.Array,
+                    parameterDescriptors: [domainParameterDescriptor, startValueParameterDescriptor, countParameterDescriptor, tweakParameterDescriptor]
+                })];
+            _reverse_decorators = [proxy.describeMethod({
+                    type: Types.Number,
+                    multiplicity: Multiplicities.Matrix,
+                    parameterDescriptors: [domainParameterDescriptor, transformedValueParameterDescriptor, tweakParameterDescriptor]
+                })];
+            __esDecorate(this, null, _forward_decorators, { kind: "method", name: "forward", static: false, private: false, access: { has: obj => "forward" in obj, get: obj => obj.forward }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _forwardSequence_decorators, { kind: "method", name: "forwardSequence", static: false, private: false, access: { has: obj => "forwardSequence" in obj, get: obj => obj.forwardSequence }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _reverse_decorators, { kind: "method", name: "reverse", static: false, private: false, access: { has: obj => "reverse" in obj, get: obj => obj.reverse }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+            TransformerProxy = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+        forward(domain, matrixValues, tweak) {
+            return this.setUpMatrixResult(() => Transformer.get(domain, tweak ?? undefined), matrixValues, (transformer, value) => this.mapBigInt(transformer.forward(value)));
+        }
+        forwardSequence(domain, startValue, count, tweak) {
+            return this.iterableResult(() => {
+                this.appExtension.validateSequenceCount(count);
+                return mapIterable(Transformer.get(domain, tweak ?? undefined).forward(new Sequence(startValue, count)), value => this.mapBigInt(value));
+            });
+        }
+        reverse(domain, matrixTransformedValues, tweak) {
+            return this.setUpMatrixResult(() => Transformer.get(domain, tweak ?? undefined), matrixTransformedValues, (transformer, transformedValue) => this.mapBigInt(transformer.reverse(transformedValue)));
+        }
+        constructor() {
+            super(...arguments);
+            __runInitializers(this, _instanceExtraInitializers);
+        }
+    };
+    return TransformerProxy = _classThis;
+})();
+export { TransformerProxy };
+//# sourceMappingURL=transformer-proxy.js.map

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

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

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@aidc-toolkit/app-extension",
-  "version": "1.0.32-beta",
+  "version": "1.0.34-beta",
   "description": "Application extension framework for AIDC Toolkit",
   "type": "module",
   "main": "dist/index.js",
-  "homepage": "https://aidc-toolkit.com/",
+  "homepage": "https://aidc-toolkit.com",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/aidc-toolkit/app-extension.git"
@@ -19,20 +19,21 @@
     "url": "https://www.linkedin.com/in/kdean"
   },
   "scripts": {
-    "generate-locale-resources": "tsx src/generator/locale-resources-generator.ts",
     "lint": "eslint",
-    "tsc:core": "tsc --project tsconfig-src.json",
-    "build:dev": "npm run tsc:core -- --noEmit && tsup --define.mode=dev",
-    "build:release": "npm run tsc:core -- --noEmit && tsup",
-    "build:doc": "npm run build:dev"
+    "tsc-src": "tsc --project tsconfig-src.json",
+    "build:non-prod": "rimraf dist tsconfig-src.tsbuildinfo && npm run tsc-src -- --declarationMap --sourceMap",
+    "build:alpha": "npm run build:non-prod && tsc --project tsconfig-config.json --noEmit",
+    "build:beta": "npm run build:non-prod",
+    "build:prod": "npm run tsc-src -- --noEmit && tsup",
+    "build:doc": "npm run build:non-prod",
+    "generate-locale-resources": "tsx src/generator/locale-resources-generator.ts"
   },
   "devDependencies": {
-    "@aidc-toolkit/dev": "1.0.32-beta"
+    "@aidc-toolkit/dev": "1.0.34-beta"
   },
   "dependencies": {
-    "@aidc-toolkit/core": "1.0.32-beta",
-    "@aidc-toolkit/gs1": "1.0.32-beta",
-    "@aidc-toolkit/utility": "1.0.32-beta",
-    "base64-js": "^1.5.1"
+    "@aidc-toolkit/core": "1.0.34-beta",
+    "@aidc-toolkit/gs1": "1.0.34-beta",
+    "@aidc-toolkit/utility": "1.0.34-beta"
   }
 }

package/src/app-extension.ts

@@ -1,6 +1,12 @@
-import { getLogger, type Hyperlink, LogLevels, MemoryTransport, type Promisable } from "@aidc-toolkit/core";
+import {
+    type AppDataStorage,
+    getLogger,
+    type Hyperlink,
+    LogLevels,
+    MemoryTransport,
+    type Promisable
+} from "@aidc-toolkit/core";
 import type { Logger } from "tslog";
-import type { AppData } from "./app-data.js";
 import { i18nextAppExtension } from "./locale/i18n.js";
 import type { StreamingCancelledCallback, StreamingConsumerCallback } from "./streaming.js";
 import type { ErrorExtends, MatrixResult, SheetAddress, SheetRange, SingletonResult } from "./type.js";
@@ -25,14 +31,14 @@ import type { ErrorExtends, MatrixResult, SheetAddress, SheetRange, SingletonRes
  */
 export abstract class AppExtension<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TStreamingInvocationContext, TBigInt> {
     /**
-     * Application name prefix for properties and application data.
+     * Application name.
      */
-    static readonly APPLICATION_NAME_PREFIX = "AIDCToolkit.";
+    static readonly APPLICATION_NAME = "AIDCToolkit";
 
     /**
      * Version property name.
      */
-    static readonly VERSION_NAME = `${AppExtension.APPLICATION_NAME_PREFIX}version`;
+    static readonly VERSION_NAME = `${AppExtension.APPLICATION_NAME}.version`;
 
     /**
      * Maximum logger messages length.
@@ -90,8 +96,7 @@ export abstract class AppExtension<ThrowError extends boolean, TError extends Er
         const isProduction = !version.includes("-");
 
         this.#logger = getLogger(isProduction ? LogLevels.Info : LogLevels.Debug, {
-            type: isProduction ? "hidden" : "pretty",
-            hideLogPositionForProduction: isProduction
+            type: isProduction ? "hidden" : "pretty"
         });
 
         this.#memoryTransport = new MemoryTransport(this.#logger, AppExtension.#MAXIMUM_LOGGER_MESSAGES_LENGTH, AppExtension.#TRUNCATE_LOGGER_MESSAGES_LENGTH);
@@ -101,10 +106,10 @@ export abstract class AppExtension<ThrowError extends boolean, TError extends Er
      * Initialize the application extension.
      */
     async initialize(): Promise<void> {
-        const fileVersion = await this.getFileProperty(AppExtension.VERSION_NAME);
+        const fileVersion = await this.getDocumentProperty(AppExtension.VERSION_NAME);
 
         if (fileVersion !== this.#version) {
-            await this.setFileProperty(AppExtension.VERSION_NAME, this.#version);
+            await this.setDocumentProperty(AppExtension.VERSION_NAME, this.#version);
         }
     }
 
@@ -189,7 +194,7 @@ export abstract class AppExtension<ThrowError extends boolean, TError extends Er
     abstract setUpStreaming<TResult>(streamingInvocationContext: TStreamingInvocationContext, streamingCancelledCallback: StreamingCancelledCallback): StreamingConsumerCallback<TResult, ThrowError, TError>;
 
     /**
-     * Get a property stored within the active file.
+     * Get a property stored within the active document.
      *
      * @param name
      * Property name.
@@ -197,62 +202,36 @@ export abstract class AppExtension<ThrowError extends boolean, TError extends Er
      * @returns
      * Property value or undefined if no value is stored under the given name.
      */
-    abstract getFileProperty(name: string): Promisable<string | undefined>;
+    abstract getDocumentProperty(name: string): Promisable<string | undefined>;
 
     /**
-     * Set a property to be stored within the active file.
+     * Set a property to be stored within the active document.
      *
      * @param name
      * Property name.
      *
      * @param value
-     * Property value or null to remove.
+     * Property value.
      */
-    abstract setFileProperty(name: string, value: string | null): Promisable<void>;
+    abstract setDocumentProperty(name: string, value: string): Promisable<void>;
 
     /**
-     * Get application data stored within the active file.
+     * Delete a property from the active document.
      *
      * @param name
-     * Name under which data is stored.
-     *
-     * @returns
-     * Application data or undefined if no data is stored under the given name.
-     */
-    abstract getFileData(name: string): Promisable<AppData | undefined>;
-
-    /**
-     * Set application data to be stored within the active file.
-     *
-     * @param name
-     * Name under which to store data.
-     *
-     * @param appData
-     * Application data or null to remove.
+     * Property name.
      */
-    abstract setFileData(name: string, appData: AppData | null): Promisable<void>;
+    abstract deleteDocumentProperty(name: string): Promisable<void>;
 
     /**
-     * Get application data stored and shared across multiple files.
-     *
-     * @param name
-     * Name under which data is stored.
-     *
-     * @returns
-     * Application ata or undefined if no data is stored under the given name.
+     * Get application data storage for the current document.
      */
-    abstract getSharedData(name: string): Promisable<AppData | undefined>;
+    abstract get documentAppDataStorage(): AppDataStorage<boolean>;
 
     /**
-     * Set application data to be stored and shared across multiple files.
-     *
-     * @param name
-     * Name under which to store data.
-     *
-     * @param appData
-     * Application data or null to remove.
+     * Get application data storage shared across multiple documents.
      */
-    abstract setSharedData(name: string, appData: AppData | null): Promisable<void>;
+    abstract get sharedAppDataStorage(): AppDataStorage<boolean>;
 
     /**
      * Validate a sequence count against the maximum supported by application.

package/src/{app-utility-proxy.ts → app-helper-proxy.ts}

@@ -1,21 +1,21 @@
 import { isNullish, type LogLevel, logLevelOf, type NonNullishable, type Nullishable } from "@aidc-toolkit/core";
-import { type ExtendsParameterDescriptor, type ParameterDescriptor, Types } from "./descriptor.js";
+import { type ExtendsParameterDescriptor, Multiplicities, type ParameterDescriptor, Types } from "./descriptor.js";
 import { LibProxy } from "./lib-proxy.js";
 import { i18nextAppExtension } from "./locale/i18n.js";
 import { proxy } from "./proxy.js";
 import type { ErrorExtends, Matrix, MatrixResult } from "./type.js";
 
-const spillMatrixParameterDescriptor: ParameterDescriptor = {
-    name: "spillMatrix",
+const spillArrayParameterDescriptor: ParameterDescriptor = {
+    name: "spillArray",
     type: Types.Any,
-    isMatrix: true,
+    multiplicity: Multiplicities.Array,
     isRequired: true
 };
 
 const spillMaximumParameterDescriptor: ParameterDescriptor = {
     name: "spillMaximum",
     type: Types.Number,
-    isMatrix: false,
+    multiplicity: Multiplicities.Singleton,
     isRequired: false
 };
 
@@ -64,8 +64,10 @@ interface MaximumDimensions {
  * @template TBigInt
  * Type to which big integer is mapped.
  */
-@proxy.describeClass(false)
-export class AppUtilityProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TStreamingInvocationContext, TBigInt> extends LibProxy<ThrowError, TError, TInvocationContext, TStreamingInvocationContext, TBigInt> {
+@proxy.describeClass(false, {
+    category: "helper"
+})
+export class AppHelperProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TStreamingInvocationContext, TBigInt> extends LibProxy<ThrowError, TError, TInvocationContext, TStreamingInvocationContext, TBigInt> {
     /**
      * Get the version.
      *
@@ -74,7 +76,7 @@ export class AppUtilityProxy<ThrowError extends boolean, TError extends ErrorExt
      */
     @proxy.describeMethod({
         type: Types.String,
-        isMatrix: false,
+        multiplicity: Multiplicities.Singleton,
         parameterDescriptors: []
     })
     version(): string {
@@ -125,7 +127,7 @@ export class AppUtilityProxy<ThrowError extends boolean, TError extends ErrorExt
     /**
      * Spill a one-dimensional matrix to fit a rectangle within a given maximum height and width.
      *
-     * @param matrixValues
+     * @param arrayValues
      * Matrix values. Matrix is length 1 or contains arrays of length 1 with the values.
      *
      * @param maximumHeight
@@ -143,15 +145,15 @@ export class AppUtilityProxy<ThrowError extends boolean, TError extends ErrorExt
     @proxy.describeMethod({
         requiresContext: true,
         type: Types.Any,
-        isMatrix: true,
-        parameterDescriptors: [spillMatrixParameterDescriptor, spillMaximumHeightParameterDescriptor, spillMaximumWidthParameterDescriptor]
+        multiplicity: Multiplicities.Matrix,
+        parameterDescriptors: [spillArrayParameterDescriptor, spillMaximumHeightParameterDescriptor, spillMaximumWidthParameterDescriptor]
     })
-    async spill(matrixValues: Matrix<unknown>, maximumHeight: Nullishable<number>, maximumWidth: Nullishable<number>, invocationContext: Nullishable<TInvocationContext>): Promise<MatrixResult<unknown, ThrowError, TError>> {
+    async spill(arrayValues: Matrix<unknown>, maximumHeight: Nullishable<number>, maximumWidth: Nullishable<number>, invocationContext: Nullishable<TInvocationContext>): Promise<MatrixResult<unknown, ThrowError, TError>> {
         let result: MatrixResult<unknown, ThrowError, TError>;
 
         // Assume matrix is uniformly two-dimensional.
-        const height = matrixValues.length;
-        const width = height !== 0 ? matrixValues[0].length : 0;
+        const height = arrayValues.length;
+        const width = height !== 0 ? arrayValues[0].length : 0;
 
         const isArrayOrError = this.singletonResult(() => {
             if (height > 1 && width > 1) {
@@ -209,7 +211,7 @@ export class AppUtilityProxy<ThrowError extends boolean, TError extends ErrorExt
                         const endIndex = startIndex + spillParallel;
 
                         // Each row is a slice of the original single row.
-                        const row = matrixValues[0].slice(startIndex, endIndex);
+                        const row = arrayValues[0].slice(startIndex, endIndex);
 
                         // Row length will be anywhere from 1 to spillParallel.
                         if (row.length < spillParallel) {
@@ -231,7 +233,7 @@ export class AppUtilityProxy<ThrowError extends boolean, TError extends ErrorExt
 
                         // Each column is a slice of the original single column.
                         for (let valueIndex = rowIndex; valueIndex < length; valueIndex += spillParallel) {
-                            row.push(matrixValues[valueIndex][0]);
+                            row.push(arrayValues[valueIndex][0]);
                         }
 
                         // Row length will always be spillPerpendicular or spillPerpendicular - 1.
@@ -244,7 +246,7 @@ export class AppUtilityProxy<ThrowError extends boolean, TError extends ErrorExt
                 }
             } else {
                 // Return matrix unmodified and let application handle spill error if any.
-                result = matrixValues;
+                result = arrayValues;
             }
         } else {
             // Return error as only element in matrix.
@@ -267,11 +269,11 @@ export class AppUtilityProxy<ThrowError extends boolean, TError extends ErrorExt
         type: Types.String,
         isHidden: true,
         isStream: true,
-        isMatrix: true,
+        multiplicity: Multiplicities.Array,
         parameterDescriptors: [{
             name: "logLevel",
             type: Types.String,
-            isMatrix: false,
+            multiplicity: Multiplicities.Singleton,
             isRequired: false
         }]
     })

package/src/descriptor.ts

@@ -43,6 +43,42 @@ export type TypeKey = keyof typeof Types;
  */
 export type Type = typeof Types[TypeKey];
 
+/**
+ * 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
+} as const;
+
+/**
+ * Multiplicity key.
+ */
+export type MultiplicityKey = keyof typeof Multiplicities;
+
+/**
+ * Multiplicity.
+ */
+export type Multiplicity = typeof Multiplicities[MultiplicityKey];
+
 /**
  * Type descriptor.
  */
@@ -53,9 +89,9 @@ interface TypeDescriptor extends Descriptor {
     readonly type: Type;
 
     /**
-     * True if type is a matrix (method accepts or returns, or parameter is, a two-dimensional array).
+     * Multiplicity.
      */
-    readonly isMatrix: boolean;
+    readonly multiplicity: Multiplicity;
 }
 
 /**
@@ -158,6 +194,11 @@ export interface ClassDescriptor extends Descriptor {
      */
     readonly namespace?: string | undefined;
 
+    /**
+     * Category.
+     */
+    readonly category: string;
+
     /**
      * Method infix. If undefined, method name is generated verbatim.
      */