@aidc-toolkit/app-extension 1.0.26-beta → 1.0.28-beta

package/src/utility/character-set-proxy.ts

@@ -12,14 +12,12 @@ import {
 } from "@aidc-toolkit/utility";
 import type { AppExtension } from "../app-extension.js";
 import {
-    expandParameterDescriptor,
+    type ExtendsParameterDescriptor,
     type ParameterDescriptor,
-    ProxyClass,
-    ProxyMethod,
-    ProxyParameter,
     Types
 } from "../descriptor.js";
 import { LibProxy } from "../lib-proxy.js";
+import { expandParameterDescriptor, proxy } from "../proxy.js";
 import type { ErrorExtends, Matrix, MatrixResultError, ResultError } from "../type.js";
 import {
     exclusionAnyParameterDescriptor,
@@ -42,107 +40,93 @@ const lengthParameterDescriptor: ParameterDescriptor = {
     isRequired: true
 };
 
-const valueForSParameterDescriptor: ParameterDescriptor = {
+const valueForSParameterDescriptor: ExtendsParameterDescriptor = {
     extendsDescriptor: sParameterDescriptor,
     name: "valueForS"
 };
 
+@proxy.describeClass(true)
 export abstract class CharacterSetValidatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends StringProxy<ThrowError, TError, TInvocationContext, TBigInt> {
-    private readonly _characterSetValidator: CharacterSetValidator;
+    readonly #characterSetValidator: CharacterSetValidator;
 
-    protected constructor(appExtension: AppExtension<ThrowError, TError, TInvocationContext, TBigInt>, characterSetValidator: CharacterSetValidator) {
+    constructor(appExtension: AppExtension<ThrowError, TError, TInvocationContext, TBigInt>, characterSetValidator: CharacterSetValidator) {
         super(appExtension);
 
-        this._characterSetValidator = characterSetValidator;
+        this.#characterSetValidator = characterSetValidator;
     }
 
-    @ProxyMethod({
+    @proxy.describeMethod({
         type: Types.String,
-        isMatrix: true
+        isMatrix: true,
+        parameterDescriptors: [validateSParameterDescriptor, exclusionNoneParameterDescriptor]
     })
-    validate(
-        @ProxyParameter(validateSParameterDescriptor) matrixSs: Matrix<string>,
-        @ProxyParameter(exclusionNoneParameterDescriptor) exclusion: Nullishable<Exclusion>
-    ): MatrixResultError<string, ThrowError, TError> {
-        return this.validateString(this._characterSetValidator, matrixSs, {
+    validate(matrixSs: Matrix<string>, exclusion: Nullishable<Exclusion>): MatrixResultError<string, ThrowError, TError> {
+        return this.validateString(this.#characterSetValidator, matrixSs, {
             exclusion: exclusion ?? undefined
         } satisfies CharacterSetValidation);
     }
 
-    @ProxyMethod({
+    @proxy.describeMethod({
         type: Types.Boolean,
-        isMatrix: true
+        isMatrix: true,
+        parameterDescriptors: [validateSParameterDescriptor, exclusionNoneParameterDescriptor]
     })
-    isValid(
-        @ProxyParameter(validateSParameterDescriptor) matrixSs: Matrix<string>,
-        @ProxyParameter(exclusionNoneParameterDescriptor) exclusion: Nullishable<Exclusion>
-    ): MatrixResultError<boolean, ThrowError, TError> {
+    isValid(matrixSs: Matrix<string>, exclusion: Nullishable<Exclusion>): MatrixResultError<boolean, ThrowError, TError> {
         return this.isValidString(this.validate(matrixSs, exclusion));
     }
 }
 
+@proxy.describeClass(true)
 export abstract class CharacterSetCreatorProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends CharacterSetValidatorProxy<ThrowError, TError, TInvocationContext, TBigInt> {
-    private readonly _characterSetCreator: CharacterSetCreator;
+    readonly #characterSetCreator: CharacterSetCreator;
 
-    protected constructor(appExtension: AppExtension<ThrowError, TError, TInvocationContext, TBigInt>, characterSetCreator: CharacterSetCreator) {
+    constructor(appExtension: AppExtension<ThrowError, TError, TInvocationContext, TBigInt>, characterSetCreator: CharacterSetCreator) {
         super(appExtension, characterSetCreator);
 
-        this._characterSetCreator = characterSetCreator;
+        this.#characterSetCreator = characterSetCreator;
     }
 
-    @ProxyMethod({
+    @proxy.describeMethod({
         type: Types.String,
-        isMatrix: true
+        isMatrix: true,
+        parameterDescriptors: [lengthParameterDescriptor, valueParameterDescriptor, exclusionNoneParameterDescriptor, tweakParameterDescriptor]
     })
-    create(
-        @ProxyParameter(lengthParameterDescriptor) length: number,
-        @ProxyParameter(valueParameterDescriptor) matrixValues: Matrix<number | bigint>,
-        @ProxyParameter(exclusionNoneParameterDescriptor) exclusion: Nullishable<Exclusion>,
-        @ProxyParameter(tweakParameterDescriptor) tweak: Nullishable<number | bigint>
-    ): MatrixResultError<string, ThrowError, TError> {
+    create(length: number, matrixValues: Matrix<number | bigint>, exclusion: Nullishable<Exclusion>, tweak: Nullishable<number | bigint>): MatrixResultError<string, ThrowError, TError> {
         const exclusionOrUndefined = exclusion ?? undefined;
         const tweakOrUndefined = tweak ?? undefined;
 
-        return this.mapMatrix(matrixValues, value => this._characterSetCreator.create(length, value, exclusionOrUndefined, tweakOrUndefined));
+        return this.mapMatrix(matrixValues, value => this.#characterSetCreator.create(length, value, exclusionOrUndefined, tweakOrUndefined));
     }
 
-    @ProxyMethod({
+    @proxy.describeMethod({
         infixBefore: "Sequence",
         type: Types.String,
-        isMatrix: true
+        isMatrix: true,
+        parameterDescriptors: [lengthParameterDescriptor, startValueParameterDescriptor, countParameterDescriptor, exclusionNoneParameterDescriptor, tweakParameterDescriptor]
     })
-    createSequence(
-        @ProxyParameter(lengthParameterDescriptor) length: number,
-        @ProxyParameter(startValueParameterDescriptor) startValue: number,
-        @ProxyParameter(countParameterDescriptor) count: number,
-        @ProxyParameter(exclusionNoneParameterDescriptor) exclusion: Nullishable<Exclusion>,
-        @ProxyParameter(tweakParameterDescriptor) tweak: Nullishable<number | bigint>
-    ): Matrix<string> {
+    createSequence(length: number, startValue: number, count: number, exclusion: Nullishable<Exclusion>, tweak: Nullishable<number | bigint>): Matrix<string> {
         this.appExtension.validateSequenceCount(count);
 
         const exclusionOrUndefined = exclusion ?? undefined;
         const tweakOrUndefined = tweak ?? undefined;
 
-        return LibProxy.matrixResult(this._characterSetCreator.create(length, new Sequence(startValue, count), exclusionOrUndefined, tweakOrUndefined));
+        return LibProxy.matrixResult(this.#characterSetCreator.create(length, new Sequence(startValue, count), exclusionOrUndefined, tweakOrUndefined));
     }
 
-    @ProxyMethod({
+    @proxy.describeMethod({
         type: Types.Number,
-        isMatrix: true
+        isMatrix: true,
+        parameterDescriptors: [valueForSParameterDescriptor, exclusionNoneParameterDescriptor, tweakParameterDescriptor]
     })
-    valueFor(
-        @ProxyParameter(valueForSParameterDescriptor) matrixSs: Matrix<string>,
-        @ProxyParameter(exclusionNoneParameterDescriptor) exclusion: Nullishable<Exclusion>,
-        @ProxyParameter(tweakParameterDescriptor) tweak: Nullishable<number | bigint>
-    ): MatrixResultError<ResultError<TBigInt, ThrowError, TError>, ThrowError, TError> {
+    valueFor(matrixSs: Matrix<string>, exclusion: Nullishable<Exclusion>, tweak: Nullishable<number | bigint>): MatrixResultError<ResultError<TBigInt, ThrowError, TError>, ThrowError, TError> {
         const exclusionOrUndefined = exclusion ?? undefined;
         const tweakOrUndefined = tweak ?? undefined;
 
-        return this.mapMatrix(matrixSs, s => this.mapBigInt(this._characterSetCreator.valueFor(s, exclusionOrUndefined, tweakOrUndefined)));
+        return this.mapMatrix(matrixSs, s => this.mapBigInt(this.#characterSetCreator.valueFor(s, exclusionOrUndefined, tweakOrUndefined)));
     }
 }
 
-@ProxyClass({
+@proxy.describeClass(false, {
     methodInfix: "Numeric",
     replaceParameterDescriptors: [
         {
@@ -157,7 +141,7 @@ export class NumericProxy<ThrowError extends boolean, TError extends ErrorExtend
     }
 }
 
-@ProxyClass({
+@proxy.describeClass(false, {
     methodInfix: "Hexadecimal",
     replaceParameterDescriptors: [
         {
@@ -172,7 +156,7 @@ export class HexadecimalProxy<ThrowError extends boolean, TError extends ErrorEx
     }
 }
 
-@ProxyClass({
+@proxy.describeClass(false, {
     methodInfix: "Alphabetic"
 })
 export class AlphabeticProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends CharacterSetCreatorProxy<ThrowError, TError, TInvocationContext, TBigInt> {
@@ -181,7 +165,7 @@ export class AlphabeticProxy<ThrowError extends boolean, TError extends ErrorExt
     }
 }
 
-@ProxyClass({
+@proxy.describeClass(false, {
     methodInfix: "Alphanumeric",
     replaceParameterDescriptors: [
         {

package/src/utility/reg-exp-proxy.ts

@@ -1,6 +1,7 @@
 import type { Nullishable } from "@aidc-toolkit/core";
 import { RegExpValidator } from "@aidc-toolkit/utility";
-import { type ParameterDescriptor, ProxyClass, ProxyMethod, ProxyParameter, Types } from "../descriptor.js";
+import { type ParameterDescriptor, Types } from "../descriptor.js";
+import { proxy } from "../proxy.js";
 import type { ErrorExtends, Matrix, MatrixResultError } from "../type.js";
 import { validateSParameterDescriptor } from "./string-descriptor.js";
 import { StringProxy } from "./string-proxy.js";
@@ -19,19 +20,16 @@ const errorMessageParameterDescriptor: ParameterDescriptor = {
     isRequired: false
 };
 
-@ProxyClass({
+@proxy.describeClass(false, {
     methodInfix: "RegExp"
 })
 export class RegExpProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends StringProxy<ThrowError, TError, TInvocationContext, TBigInt> {
-    @ProxyMethod({
+    @proxy.describeMethod({
         type: Types.String,
-        isMatrix: true
+        isMatrix: true,
+        parameterDescriptors: [regExpParameterDescriptor, validateSParameterDescriptor, errorMessageParameterDescriptor]
     })
-    validate(
-        @ProxyParameter(regExpParameterDescriptor) regExp: string,
-        @ProxyParameter(validateSParameterDescriptor) matrixSs: Matrix<string>,
-        @ProxyParameter(errorMessageParameterDescriptor) errorMessage: Nullishable<string>
-    ): MatrixResultError<string, ThrowError, TError> {
+    validate(regExp: string, matrixSs: Matrix<string>, errorMessage: Nullishable<string>): MatrixResultError<string, ThrowError, TError> {
         return this.validateString(new class extends RegExpValidator {
             protected override createErrorMessage(s: string): string {
                 return errorMessage ?? super.createErrorMessage(s);
@@ -39,14 +37,12 @@ export class RegExpProxy<ThrowError extends boolean, TError extends ErrorExtends
         }(new RegExp(regExp)), matrixSs);
     }
 
-    @ProxyMethod({
+    @proxy.describeMethod({
         type: Types.Boolean,
-        isMatrix: true
+        isMatrix: true,
+        parameterDescriptors: [regExpParameterDescriptor, validateSParameterDescriptor]
     })
-    isValid(
-        @ProxyParameter(regExpParameterDescriptor) regExp: string,
-        @ProxyParameter(validateSParameterDescriptor) matrixSs: Matrix<string>
-    ): MatrixResultError<boolean, ThrowError, TError> {
+    isValid(regExp: string, matrixSs: Matrix<string>): MatrixResultError<boolean, ThrowError, TError> {
         return this.isValidString(this.validate(regExp, matrixSs, undefined));
     }
 }

package/src/utility/string-descriptor.ts

@@ -1,4 +1,4 @@
-import { type ParameterDescriptor, Types } from "../descriptor.js";
+import { type ExtendsParameterDescriptor, type ParameterDescriptor, Types } from "../descriptor.js";
 
 export const sParameterDescriptor: ParameterDescriptor = {
     name: "s",
@@ -7,7 +7,7 @@ export const sParameterDescriptor: ParameterDescriptor = {
     isRequired: true
 };
 
-export const validateSParameterDescriptor: ParameterDescriptor = {
+export const validateSParameterDescriptor: ExtendsParameterDescriptor = {
     extendsDescriptor: sParameterDescriptor,
     name: "validateS"
 };

package/src/utility/transformer-descriptor.ts

@@ -1,4 +1,4 @@
-import { type ParameterDescriptor, Types } from "../descriptor.js";
+import { type ExtendsParameterDescriptor, type ParameterDescriptor, Types } from "../descriptor.js";
 
 export const valueParameterDescriptor: ParameterDescriptor = {
     name: "value",
@@ -7,13 +7,13 @@ export const valueParameterDescriptor: ParameterDescriptor = {
     isRequired: true
 };
 
-export const startValueParameterDescriptor: ParameterDescriptor = {
+export const startValueParameterDescriptor: ExtendsParameterDescriptor = {
     extendsDescriptor: valueParameterDescriptor,
     name: "startValue",
     isMatrix: false
 };
 
-export const countParameterDescriptor: ParameterDescriptor = {
+export const countParameterDescriptor: ExtendsParameterDescriptor = {
     extendsDescriptor: valueParameterDescriptor,
     name: "count",
     isMatrix: false

package/src/utility/transformer-proxy.ts

@@ -1,7 +1,8 @@
 import type { Nullishable } from "@aidc-toolkit/core";
 import { mapIterable, Sequence, Transformer } from "@aidc-toolkit/utility";
-import { type ParameterDescriptor, ProxyClass, ProxyMethod, ProxyParameter, Types } from "../descriptor.js";
+import { type ExtendsParameterDescriptor, type ParameterDescriptor, Types } from "../descriptor.js";
 import { LibProxy } from "../lib-proxy.js";
+import { proxy } from "../proxy.js";
 import type { ErrorExtends, Matrix, MatrixResultError, ResultError } from "../type.js";
 import {
     countParameterDescriptor,
@@ -17,55 +18,44 @@ const domainParameterDescriptor: ParameterDescriptor = {
     isRequired: true
 };
 
-// eslint-disable-next-line no-useless-assignment -- ESLint bug.
-const transformedValueParameterDescriptor: ParameterDescriptor = {
+const transformedValueParameterDescriptor: ExtendsParameterDescriptor = {
     extendsDescriptor: valueParameterDescriptor,
     name: "transformedValue"
 };
 
-@ProxyClass({
+@proxy.describeClass(false, {
     methodInfix: "Transform"
 })
 export class TransformerProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends LibProxy<ThrowError, TError, TInvocationContext, TBigInt> {
-    @ProxyMethod({
+    @proxy.describeMethod({
         type: Types.Number,
-        isMatrix: true
+        isMatrix: true,
+        parameterDescriptors: [domainParameterDescriptor, valueParameterDescriptor, tweakParameterDescriptor]
     })
-    forward(
-        @ProxyParameter(domainParameterDescriptor) domain: number | bigint,
-        @ProxyParameter(valueParameterDescriptor) matrixValues: Matrix<number | bigint>,
-        @ProxyParameter(tweakParameterDescriptor) tweak: Nullishable<number | bigint>
-    ): MatrixResultError<ResultError<TBigInt, ThrowError, TError>, ThrowError, TError> {
+    forward(domain: number | bigint, matrixValues: Matrix<number | bigint>, tweak: Nullishable<number | bigint>): MatrixResultError<ResultError<TBigInt, ThrowError, TError>, ThrowError, TError> {
         const transformer = Transformer.get(domain, tweak ?? undefined);
 
         return this.mapMatrix(matrixValues, value => this.mapBigInt(transformer.forward(value)));
     }
 
-    @ProxyMethod({
+    @proxy.describeMethod({
         infixBefore: "Sequence",
         type: Types.Number,
-        isMatrix: true
+        isMatrix: true,
+        parameterDescriptors: [domainParameterDescriptor, startValueParameterDescriptor, countParameterDescriptor, tweakParameterDescriptor]
     })
-    forwardSequence(
-        @ProxyParameter(domainParameterDescriptor) domain: number | bigint,
-        @ProxyParameter(startValueParameterDescriptor) startValue: number,
-        @ProxyParameter(countParameterDescriptor) count: number,
-        @ProxyParameter(tweakParameterDescriptor) tweak: Nullishable<number | bigint>
-    ): Matrix<ResultError<TBigInt, ThrowError, TError>> {
+    forwardSequence(domain: number | bigint, startValue: number, count: number, tweak: Nullishable<number | bigint>): Matrix<ResultError<TBigInt, ThrowError, TError>> {
         this.appExtension.validateSequenceCount(count);
 
         return LibProxy.matrixResult(mapIterable(Transformer.get(domain, tweak ?? undefined).forward(new Sequence(startValue, count)), value => this.mapBigInt(value)));
     }
 
-    @ProxyMethod({
+    @proxy.describeMethod({
         type: Types.Number,
-        isMatrix: true
+        isMatrix: true,
+        parameterDescriptors: [domainParameterDescriptor, transformedValueParameterDescriptor, tweakParameterDescriptor]
     })
-    reverse(
-        @ProxyParameter(domainParameterDescriptor) domain: number | bigint,
-        @ProxyParameter(transformedValueParameterDescriptor) matrixTransformedValues: Matrix<number | bigint>,
-        @ProxyParameter(tweakParameterDescriptor) tweak: Nullishable<number | bigint>
-    ): MatrixResultError<ResultError<TBigInt, ThrowError, TError>, ThrowError, TError> {
+    reverse(domain: number | bigint, matrixTransformedValues: Matrix<number | bigint>, tweak: Nullishable<number | bigint>): MatrixResultError<ResultError<TBigInt, ThrowError, TError>, ThrowError, TError> {
         const transformer = Transformer.get(domain, tweak ?? undefined);
 
         return this.mapMatrix(matrixTransformedValues, transformedValue => this.mapBigInt(transformer.reverse(transformedValue)));

package/tsconfig-src.json

@@ -3,9 +3,6 @@
   "include": ["./src/**/*"],
   "compilerOptions": {
     // Emit.
-    "outDir": "dist",
-
-    // Language and environment.
-    "experimentalDecorators": true
+    "outDir": "dist"
   }
 }

package/src/generator/descriptor.ts

@@ -1,122 +0,0 @@
-import type { BaseParameterDescriptor, ClassDescriptor, MethodDescriptor } from "../descriptor.js";
-
-/**
- * Localization.
- */
-export interface Localization {
-    /**
-     * Name.
-     */
-    name: string;
-
-    /**
-     * Description.
-     */
-    description: string;
-}
-
-/**
- * Function localization.
- */
-export interface FunctionLocalization extends Localization {
-    /**
-     * Documentation URL.
-     */
-    documentationURL: string;
-}
-
-/**
- * Parameter localization.
- */
-export interface ParameterLocalization extends Localization {
-}
-
-/**
- * Localization descriptor.
- */
-export interface LocalizationDescriptor<T extends Localization> {
-    /**
-     * Localizations map by locale.
-     */
-    readonly localizationsMap: ReadonlyMap<string, T>;
-}
-
-/**
- * Proxy namespace descriptor.
- */
-export interface ProxyNamespaceDescriptor {
-    /**
-     * Namespace if any.
-     */
-    readonly namespace: string | undefined;
-}
-
-/**
- * Proxy class descriptor.
- */
-export interface ProxyClassDescriptor extends ProxyNamespaceDescriptor {
-    /**
-     * Class name.
-     */
-    readonly className: string;
-
-    /**
-     * Namespace-qualified class name.
-     */
-    readonly namespaceClassName: string;
-
-    /**
-     * Class descriptor.
-     */
-    readonly classDescriptor: ClassDescriptor;
-}
-
-/**
- * Proxy object descriptor.
- */
-export interface ProxyObjectDescriptor extends ProxyClassDescriptor {
-    /**
-     * Object name.
-     */
-    readonly objectName: string;
-}
-
-/**
- * Proxy parameter descriptor.
- */
-export interface ProxyParameterDescriptor extends ProxyNamespaceDescriptor, LocalizationDescriptor<ParameterLocalization> {
-    /**
-     * Function name.
-     */
-    readonly parameterName: string;
-
-    /**
-     * Parameter descriptor.
-     */
-    readonly parameterDescriptor: BaseParameterDescriptor;
-}
-
-/**
- * Proxy function descriptor.
- */
-export interface ProxyFunctionDescriptor extends ProxyObjectDescriptor, LocalizationDescriptor<FunctionLocalization> {
-    /**
-     * Function name.
-     */
-    readonly functionName: string;
-
-    /**
-     * Namespace-qualified function name.
-     */
-    readonly namespaceFunctionName: string;
-
-    /**
-     * Proxy parameter descriptors
-     */
-    readonly proxyParameterDescriptors: ProxyParameterDescriptor[];
-
-    /**
-     * Method descriptor.
-     */
-    readonly methodDescriptor: MethodDescriptor;
-}