@aidc-toolkit/app-extension 1.0.25-beta → 1.0.27-beta

package/src/lib-proxy.ts

@@ -1,25 +1,28 @@
 import { mapIterable } from "@aidc-toolkit/utility";
-import type { AppExtension } from "./app-extension";
-import { i18nextAppExtension } from "./locale/i18n";
-import type { ErrorExtends, Matrix, MatrixResultError, ResultError } from "./type";
+import type { AppExtension } from "./app-extension.js";
+import { i18nextAppExtension } from "./locale/i18n.js";
+import type { ErrorExtends, Matrix, MatrixResultError, ResultError } from "./type.js";
 
 /**
  * Library proxy.
  *
- * @template TBigInt
- * Type to which big integer is mapped.
- *
  * @template ThrowError
  * If true, errors are reported through the throw/catch mechanism.
  *
  * @template TError
  * Error type.
+ *
+ * @template TInvocationContext
+ * Application-specific invocation context type.
+ *
+ * @template TBigInt
+ * Type to which big integer is mapped.
  */
 export abstract class LibProxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> {
     /**
      * Application extension.
      */
-    private readonly _appExtension: AppExtension<ThrowError, TError, TInvocationContext, TBigInt>;
+    readonly #appExtension: AppExtension<ThrowError, TError, TInvocationContext, TBigInt>;
 
     /**
      * Constructor.
@@ -28,14 +31,14 @@ export abstract class LibProxy<ThrowError extends boolean, TError extends ErrorE
      * Application extension.
      */
     constructor(appExtension: AppExtension<ThrowError, TError, TInvocationContext, TBigInt>) {
-        this._appExtension = appExtension;
+        this.#appExtension = appExtension;
     }
 
     /**
      * Get the application extension.
      */
     protected get appExtension(): AppExtension<ThrowError, TError, TInvocationContext, TBigInt> {
-        return this._appExtension;
+        return this.#appExtension;
     }
 
     /**
@@ -48,7 +51,7 @@ export abstract class LibProxy<ThrowError extends boolean, TError extends ErrorE
      * Mapped big integer value.
      */
     mapBigInt(value: bigint): ResultError<TBigInt, ThrowError, TError> {
-        return this._appExtension.mapBigInt(value);
+        return this.#appExtension.mapBigInt(value);
     }
 
     /**
@@ -60,13 +63,13 @@ export abstract class LibProxy<ThrowError extends boolean, TError extends ErrorE
      * @returns
      * Error if errors are not thrown.
      */
-    private handleError<TResult>(e: unknown): ResultError<TResult, ThrowError, TError> {
+    #handleError<TResult>(e: unknown): ResultError<TResult, ThrowError, TError> {
         let result: ResultError<TResult, ThrowError, TError>;
 
         if (e instanceof RangeError) {
-            const error = this._appExtension.mapRangeError(e);
+            const error = this.#appExtension.mapRangeError(e);
 
-            if (this._appExtension.throwError) {
+            if (this.#appExtension.throwError) {
                 // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Type is determined by application mapping.
                 throw error as Error;
             }
@@ -94,13 +97,13 @@ export abstract class LibProxy<ThrowError extends boolean, TError extends ErrorE
      * @returns
      * Callback result or error if errors are not thrown.
      */
-    private doCallback<TValue, TResult>(value: TValue, callback: (value: TValue) => TResult): ResultError<TResult, ThrowError, TError> {
+    #doCallback<TValue, TResult>(value: TValue, callback: (value: TValue) => TResult): ResultError<TResult, ThrowError, TError> {
         let result: ResultError<TResult, ThrowError, TError>;
 
         try {
             result = callback(value);
         } catch (e: unknown) {
-            result = this.handleError(e);
+            result = this.#handleError(e);
         }
 
         return result;
@@ -119,7 +122,7 @@ export abstract class LibProxy<ThrowError extends boolean, TError extends ErrorE
      * Matrix of callback results and errors if errors are not thrown.
      */
     protected mapMatrix<TValue, TResult>(matrixValues: Matrix<TValue>, callback: (value: TValue) => TResult): MatrixResultError<TResult, ThrowError, TError> {
-        return matrixValues.map(rowValues => rowValues.map(value => this.doCallback(value, callback)));
+        return matrixValues.map(rowValues => rowValues.map(value => this.#doCallback(value, callback)));
     }
 
     /**
@@ -134,8 +137,8 @@ export abstract class LibProxy<ThrowError extends boolean, TError extends ErrorE
      * @returns
      * Callback result or error as array if errors are not thrown.
      */
-    private doArrayCallback<TValue, TResult>(value: TValue, callback: (value: TValue) => TResult[]): Array<ResultError<TResult, ThrowError, TError>> {
-        const result = this.doCallback(value, callback);
+    #doArrayCallback<TValue, TResult>(value: TValue, callback: (value: TValue) => TResult[]): Array<ResultError<TResult, ThrowError, TError>> {
+        const result = this.#doCallback(value, callback);
 
         // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Type determination is handled.
         return result instanceof Array ? result : [result as ResultError<TResult, ThrowError, TError>];
@@ -163,7 +166,7 @@ export abstract class LibProxy<ThrowError extends boolean, TError extends ErrorE
             matrixResultError = [];
 
             matrixValues[0].forEach((value, columnIndex) => {
-                const arrayResultError = this.doArrayCallback(value, callback);
+                const arrayResultError = this.#doArrayCallback(value, callback);
 
                 arrayResultError.forEach((resultError, rowIndex) => {
                     if (matrixResultError.length <= rowIndex) {
@@ -182,9 +185,9 @@ export abstract class LibProxy<ThrowError extends boolean, TError extends ErrorE
                     // Special case; unlikely to occur.
                     arrayResultError = [];
                 } else if (rowValue.length === 1) {
-                    arrayResultError = this.doArrayCallback(rowValue[0], callback);
+                    arrayResultError = this.#doArrayCallback(rowValue[0], callback);
                 } else {
-                    arrayResultError = [this.handleError(new RangeError(i18nextAppExtension.t("Proxy.matrixMustBeArray")))];
+                    arrayResultError = [this.#handleError(new RangeError(i18nextAppExtension.t("Proxy.matrixMustBeArray")))];
                 }
 
                 return arrayResultError;

package/src/locale/i18n.ts

@@ -2,8 +2,8 @@ import { i18nCoreInit, type I18nEnvironment } from "@aidc-toolkit/core";
 import { gs1Resources, i18nGS1Init } from "@aidc-toolkit/gs1";
 import { i18nUtilityInit, utilityResources } from "@aidc-toolkit/utility";
 import i18next, { type i18n, type Resource } from "i18next";
-import enLocaleResources from "./en/locale-resources";
-import frLocaleResources from "./fr/locale-resources";
+import enLocaleResources from "./en/locale-resources.js";
+import frLocaleResources from "./fr/locale-resources.js";
 
 export const appExtensionNS = "aidct_app_extension";
 
@@ -24,7 +24,7 @@ export const appExtensionResources: Resource = {
     }
 };
 
-// Explicit type is necessary to work around bug in type discovery with linked packages.
+// Explicit type is necessary because type can't be inferred without additional references.
 export const i18nextAppExtension: i18n = i18next.createInstance();
 
 /**

package/src/locale/i18next.d.ts

@@ -1,6 +1,6 @@
 import type { GS1LocaleResources } from "@aidc-toolkit/gs1";
 import type { UtilityLocaleResources } from "@aidc-toolkit/utility";
-import type { AppExtensionLocaleResources } from "./i18n";
+import type { AppExtensionLocaleResources } from "./i18n.js";
 
 /**
  * Internationalization module.

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

@@ -1,4 +1,4 @@
-import { type ParameterDescriptor, Types } from "../descriptor";
+import { type ParameterDescriptor, Types } from "../descriptor.js";
 
 const exclusionParameterDescriptor: ParameterDescriptor = {
     name: "exclusion",

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

@@ -10,7 +10,7 @@ import {
     NUMERIC_CREATOR,
     Sequence
 } from "@aidc-toolkit/utility";
-import type { AppExtension } from "../app-extension";
+import type { AppExtension } from "../app-extension.js";
 import {
     expandParameterDescriptor,
     type ParameterDescriptor,
@@ -18,22 +18,22 @@ import {
     ProxyMethod,
     ProxyParameter,
     Types
-} from "../descriptor";
-import { LibProxy } from "../lib-proxy";
-import type { ErrorExtends, Matrix, MatrixResultError, ResultError } from "../type";
+} from "../descriptor.js";
+import { LibProxy } from "../lib-proxy.js";
+import type { ErrorExtends, Matrix, MatrixResultError, ResultError } from "../type.js";
 import {
     exclusionAnyParameterDescriptor,
     exclusionFirstZeroParameterDescriptor,
     exclusionNoneParameterDescriptor
-} from "./character-set-descriptor";
-import { sParameterDescriptor, validateSParameterDescriptor } from "./string-descriptor";
-import { StringProxy } from "./string-proxy";
+} from "./character-set-descriptor.js";
+import { sParameterDescriptor, validateSParameterDescriptor } from "./string-descriptor.js";
+import { StringProxy } from "./string-proxy.js";
 import {
     countParameterDescriptor,
     startValueParameterDescriptor,
     tweakParameterDescriptor,
     valueParameterDescriptor
-} from "./transformer-descriptor";
+} from "./transformer-descriptor.js";
 
 const lengthParameterDescriptor: ParameterDescriptor = {
     name: "length",
@@ -48,12 +48,12 @@ const valueForSParameterDescriptor: ParameterDescriptor = {
 };
 
 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) {
         super(appExtension);
 
-        this._characterSetValidator = characterSetValidator;
+        this.#characterSetValidator = characterSetValidator;
     }
 
     @ProxyMethod({
@@ -64,7 +64,7 @@ export abstract class CharacterSetValidatorProxy<ThrowError extends boolean, TEr
         @ProxyParameter(validateSParameterDescriptor) matrixSs: Matrix<string>,
         @ProxyParameter(exclusionNoneParameterDescriptor) exclusion: Nullishable<Exclusion>
     ): MatrixResultError<string, ThrowError, TError> {
-        return this.validateString(this._characterSetValidator, matrixSs, {
+        return this.validateString(this.#characterSetValidator, matrixSs, {
             exclusion: exclusion ?? undefined
         } satisfies CharacterSetValidation);
     }
@@ -82,12 +82,12 @@ export abstract class CharacterSetValidatorProxy<ThrowError extends boolean, TEr
 }
 
 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) {
         super(appExtension, characterSetCreator);
 
-        this._characterSetCreator = characterSetCreator;
+        this.#characterSetCreator = characterSetCreator;
     }
 
     @ProxyMethod({
@@ -103,7 +103,7 @@ export abstract class CharacterSetCreatorProxy<ThrowError extends boolean, TErro
         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({
@@ -123,7 +123,7 @@ export abstract class CharacterSetCreatorProxy<ThrowError extends boolean, TErro
         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({
@@ -138,7 +138,7 @@ export abstract class CharacterSetCreatorProxy<ThrowError extends boolean, TErro
         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)));
     }
 }
 

package/src/utility/index.ts

@@ -1,3 +1,3 @@
-export * from "./transformer-proxy";
-export * from "./reg-exp-proxy";
-export * from "./character-set-proxy";
+export * from "./transformer-proxy.js";
+export * from "./reg-exp-proxy.js";
+export * from "./character-set-proxy.js";

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

@@ -1,9 +1,9 @@
 import type { Nullishable } from "@aidc-toolkit/core";
 import { RegExpValidator } from "@aidc-toolkit/utility";
-import { type ParameterDescriptor, ProxyClass, ProxyMethod, ProxyParameter, Types } from "../descriptor";
-import type { ErrorExtends, Matrix, MatrixResultError } from "../type";
-import { validateSParameterDescriptor } from "./string-descriptor";
-import { StringProxy } from "./string-proxy";
+import { type ParameterDescriptor, ProxyClass, ProxyMethod, ProxyParameter, Types } from "../descriptor.js";
+import type { ErrorExtends, Matrix, MatrixResultError } from "../type.js";
+import { validateSParameterDescriptor } from "./string-descriptor.js";
+import { StringProxy } from "./string-proxy.js";
 
 const regExpParameterDescriptor: ParameterDescriptor = {
     name: "regExp",

package/src/utility/string-descriptor.ts

@@ -1,4 +1,4 @@
-import { type ParameterDescriptor, Types } from "../descriptor";
+import { type ParameterDescriptor, Types } from "../descriptor.js";
 
 export const sParameterDescriptor: ParameterDescriptor = {
     name: "s",

package/src/utility/string-proxy.ts

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

package/src/utility/transformer-descriptor.ts

@@ -1,4 +1,4 @@
-import { type ParameterDescriptor, Types } from "../descriptor";
+import { type ParameterDescriptor, Types } from "../descriptor.js";
 
 export const valueParameterDescriptor: ParameterDescriptor = {
     name: "value",

package/src/utility/transformer-proxy.ts

@@ -1,14 +1,14 @@
 import type { Nullishable } from "@aidc-toolkit/core";
 import { mapIterable, Sequence, Transformer } from "@aidc-toolkit/utility";
-import { type ParameterDescriptor, ProxyClass, ProxyMethod, ProxyParameter, Types } from "../descriptor";
-import { LibProxy } from "../lib-proxy";
-import type { ErrorExtends, Matrix, MatrixResultError, ResultError } from "../type";
+import { type ParameterDescriptor, ProxyClass, ProxyMethod, ProxyParameter, Types } from "../descriptor.js";
+import { LibProxy } from "../lib-proxy.js";
+import type { ErrorExtends, Matrix, MatrixResultError, ResultError } from "../type.js";
 import {
     countParameterDescriptor,
     startValueParameterDescriptor,
     tweakParameterDescriptor,
     valueParameterDescriptor
-} from "./transformer-descriptor";
+} from "./transformer-descriptor.js";
 
 const domainParameterDescriptor: ParameterDescriptor = {
     name: "domain",

package/tsconfig-config.json

@@ -0,0 +1,4 @@
+{
+  "extends": "@aidc-toolkit/dev/tsconfig-template.json",
+  "files": ["./eslint.config.ts", "./tsup.config.ts"]
+}

package/tsconfig-src.json

@@ -0,0 +1,11 @@
+{
+  "extends": "@aidc-toolkit/dev/tsconfig-template.json",
+  "include": ["./src/**/*"],
+  "compilerOptions": {
+    // Emit.
+    "outDir": "dist",
+
+    // Language and environment.
+    "experimentalDecorators": true
+  }
+}

package/tsconfig.json

@@ -1,6 +1,11 @@
 {
-  "extends": "@aidc-toolkit/dev/tsconfig.json",
-  "compilerOptions": {
-    "experimentalDecorators": true
-  }
+  "include": [],
+  "references": [
+    {
+      "path": "./tsconfig-src.json"
+    },
+    {
+      "path": "./tsconfig-config.json"
+    }
+  ]
 }

package/tsup.config.ts

@@ -1,3 +1,4 @@
-import { tsupConfigAIDCToolkit } from "@aidc-toolkit/dev";
+import { tsupConfig } from "@aidc-toolkit/dev";
+import { defineConfig } from "tsup";
 
-export default tsupConfigAIDCToolkit;
+export default defineConfig(tsupConfig);