@aidc-toolkit/app-extension 1.0.23-beta → 1.0.24-beta

package/src/descriptor.ts

@@ -1,11 +1,15 @@
-import type { AppExtension } from "./app-extension.js";
-import { LibProxy } from "./lib-proxy.js";
-import type { ErrorExtends, TypedFunction } from "./types.js";
+import type { TypedFunction } from "@aidc-toolkit/core";
+import type { AppExtension } from "./app-extension";
+import { LibProxy } from "./lib-proxy";
+import type { ErrorExtends } from "./type";
 
 /**
  * Core descriptor.
  */
 interface Descriptor {
+    /**
+     * Name.
+     */
     readonly name: string;
 }
 
@@ -167,12 +171,12 @@ type ProxyClassType<ThrowError extends boolean, TError extends ErrorExtends<Thro
 let pendingParameterDescriptors: ParameterDescriptor[] = [];
 
 /**
- * Class method descriptors, keyed on declaration class name and method name.
+ * Class method descriptors map, keyed on declaration class name and method name.
  */
 const classMethodsDescriptorsMap = new Map<string, MethodDescriptor[]>();
 
 /**
- * Class descriptors, keyed on declaration class name.
+ * Class descriptors map, keyed on declaration class name.
  */
 const classDescriptorsMap = new Map<string, ClassDescriptor>();
 
@@ -309,11 +313,11 @@ export function ProxyClass<ThrowError extends boolean, TError extends ErrorExten
 }
 
 /**
- * Get class descriptors.
+ * Get class descriptors map.
  *
  * @returns
- * Class descriptors.
+ * Class descriptors map.
  */
-export function getClassDescriptors(): ReadonlyMap<string, ClassDescriptor> {
+export function getClassDescriptorsMap(): ReadonlyMap<string, ClassDescriptor> {
     return classDescriptorsMap;
 }

package/src/generator/descriptor.ts

@@ -1,4 +1,4 @@
-import type { BaseParameterDescriptor, ClassDescriptor, MethodDescriptor } from "../descriptor.js";
+import type { BaseParameterDescriptor, ClassDescriptor, MethodDescriptor } from "../descriptor";
 
 /**
  * Localization.

package/src/generator/generator.ts

@@ -1,14 +1,14 @@
 import { I18nEnvironments } from "@aidc-toolkit/core";
 import type { ParseKeys } from "i18next";
-import { expandParameterDescriptor, getClassDescriptors } from "../descriptor.js";
-import { appExtensionResources, i18nAppExtensionInit, i18nextAppExtension } from "../locale/i18n.js";
+import { expandParameterDescriptor, getClassDescriptorsMap } from "../descriptor";
+import { appExtensionResources, i18nAppExtensionInit, i18nextAppExtension } from "../locale/i18n";
 import type {
     FunctionLocalization,
     Localization,
     ParameterLocalization,
     ProxyFunctionDescriptor,
     ProxyObjectDescriptor
-} from "./descriptor.js";
+} from "./descriptor";
 
 /**
  * Abstract generator.
@@ -187,7 +187,7 @@ export abstract class Generator {
         this.initialize();
 
         try {
-            for (const classDescriptor of getClassDescriptors().values()) {
+            for (const classDescriptor of getClassDescriptorsMap().values()) {
                 const namespace = classDescriptor.namespace;
                 const namespacePrefix = namespace === undefined ? "" : `${namespace}.`;
                 const className = classDescriptor.name;

package/src/generator/index.ts

@@ -1,2 +1,2 @@
-export type * from "./descriptor.js";
-export * from "./generator.js";
+export type * from "./descriptor";
+export * from "./generator";

package/src/generator/locale-resources-generator.ts

@@ -1,10 +1,9 @@
-import type { LocaleResources } from "@aidc-toolkit/core";
+import { getLogger, type LocaleResources } from "@aidc-toolkit/core";
 import * as fs from "node:fs";
 import * as path from "node:path";
-import { expandParameterDescriptor, type ParameterDescriptor } from "../descriptor.js";
-import type { ProxyFunctionDescriptor } from "./descriptor.js";
-import { Generator } from "./generator.js";
-import { logger } from "./logger.js";
+import { expandParameterDescriptor, type ParameterDescriptor } from "../descriptor";
+import type { ProxyFunctionDescriptor } from "./descriptor";
+import { Generator } from "./generator";
 
 /**
  * Parameters sequencer entry.
@@ -50,6 +49,11 @@ class LocaleResourcesGenerator extends Generator {
      */
     private static readonly IMPORT_PATH = "../app-extension/src/locale";
 
+    /**
+     * Logger.
+     */
+    private readonly _logger = getLogger();
+
     /**
      * Parameters sequencer.
      */
@@ -215,7 +219,7 @@ class LocaleResourcesGenerator extends Generator {
      * @returns
      * Merged locale resources.
      */
-    private static merge(logChanges: boolean, parentKey: string, sourceLocaleResources: LocaleResources, destinationLocaleResources: LocaleResources, addMissing: boolean): LocaleResources {
+    private merge(logChanges: boolean, parentKey: string, sourceLocaleResources: LocaleResources, destinationLocaleResources: LocaleResources, addMissing: boolean): LocaleResources {
         // Some entries at the top are not part of the generator output.
         const deleteMissing = parentKey.length !== 0;
 
@@ -227,7 +231,7 @@ class LocaleResourcesGenerator extends Generator {
                 if (!deleteMissing) {
                     newDestinationLocaleResources[key] = destinationValue;
                 } else if (logChanges) {
-                    logger.info(`Deleting ${parentKey}${key}...`);
+                    this._logger.info(`Deleting ${parentKey}${key}...`);
                 }
             }
         }
@@ -236,7 +240,7 @@ class LocaleResourcesGenerator extends Generator {
             if (!(key in destinationLocaleResources)) {
                 if (addMissing) {
                     if (logChanges) {
-                        logger.info(`Adding ${parentKey}${key}...`);
+                        this._logger.info(`Adding ${parentKey}${key}...`);
                     }
 
                     newDestinationLocaleResources[key] = sourceValue;
@@ -245,7 +249,7 @@ class LocaleResourcesGenerator extends Generator {
                 const destinationValue = destinationLocaleResources[key];
 
                 if (typeof sourceValue === "object" && typeof destinationValue === "object") {
-                    newDestinationLocaleResources[key] = LocaleResourcesGenerator.merge(logChanges, `${parentKey}${key}.`, sourceValue, destinationValue, addMissing);
+                    newDestinationLocaleResources[key] = this.merge(logChanges, `${parentKey}${key}.`, sourceValue, destinationValue, addMissing);
                 } else if (typeof sourceValue === "string" && typeof destinationValue === "string") {
                     newDestinationLocaleResources[key] = destinationValue;
                 } else {
@@ -346,7 +350,7 @@ class LocaleResourcesGenerator extends Generator {
 
                 await import(LocaleResourcesSource).then((module) => {
                     // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Module format is known.
-                    const LocaleResources = LocaleResourcesGenerator.merge(entry.name === "en", "", this._LocaleResources, (module as LocaleResourcesModule).LocaleResources, !entry.name.includes("-"));
+                    const LocaleResources = this.merge(entry.name === "en", "", this._LocaleResources, (module as LocaleResourcesModule).LocaleResources, !entry.name.includes("-"));
 
                     fs.writeFileSync(LocaleResourcesSource, `${LocaleResourcesGenerator.buildOutput("export default", LocaleResources, 0)};\n`);
                 });

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

@@ -1,12 +1,12 @@
 import { AI39_CREATOR, AI82_CREATOR } from "@aidc-toolkit/gs1";
-import type { AppExtension } from "../app-extension.js";
-import { expandParameterDescriptor, ProxyClass } from "../descriptor.js";
-import type { ErrorExtends } from "../types.js";
+import type { AppExtension } from "../app-extension";
+import { expandParameterDescriptor, ProxyClass } from "../descriptor";
+import type { ErrorExtends } from "../type";
 import {
     exclusionAllNumericParameterDescriptor,
     exclusionNoneParameterDescriptor
-} from "../utility/character-set-descriptor.js";
-import { CharacterSetProxy } from "../utility/character-set-proxy.js";
+} from "../utility/character-set-descriptor";
+import { CharacterSetProxy } from "../utility";
 
 @ProxyClass({
     namespace: "GS1",

package/src/gs1/check-proxy.ts

@@ -6,9 +6,9 @@ import {
     isValidPriceOrWeightCheckDigit,
     priceOrWeightCheckDigit
 } from "@aidc-toolkit/gs1";
-import { type ParameterDescriptor, ProxyClass, ProxyMethod, ProxyParameter, Types } from "../descriptor.js";
-import { LibProxy } from "../lib-proxy.js";
-import type { ErrorExtends, Matrix, MatrixResultError, ResultError } from "../types.js";
+import { type ParameterDescriptor, ProxyClass, ProxyMethod, ProxyParameter, Types } from "../descriptor";
+import { LibProxy } from "../lib-proxy";
+import type { ErrorExtends, Matrix, MatrixResultError, ResultError } from "../type";
 
 const checkSParameterDescriptor: ParameterDescriptor = {
     name: "checkS",

package/src/gs1/identifier-proxy.ts

@@ -1,3 +1,4 @@
+import { isNullish, type Nullishable } from "@aidc-toolkit/core";
 import {
     CPID_VALIDATOR,
     GCN_VALIDATOR,
@@ -34,7 +35,7 @@ import {
     SSCC_VALIDATOR
 } from "@aidc-toolkit/gs1";
 import { Sequence } from "@aidc-toolkit/utility";
-import type { AppExtension } from "../app-extension.js";
+import type { AppExtension } from "../app-extension";
 import {
     expandParameterDescriptor,
     type ParameterDescriptor,
@@ -42,17 +43,17 @@ import {
     ProxyMethod,
     ProxyParameter,
     Types
-} from "../descriptor.js";
-import { LibProxy } from "../lib-proxy.js";
-import { i18nextAppExtension } from "../locale/i18n.js";
-import { type ErrorExtends, isNullish, type Matrix, type MatrixResultError, type Nullishable } from "../types.js";
-import { exclusionAllNumericParameterDescriptor } from "../utility/character-set-descriptor.js";
-import { StringProxy } from "../utility/string-proxy.js";
+} from "../descriptor";
+import { LibProxy } from "../lib-proxy";
+import { i18nextAppExtension } from "../locale/i18n";
+import type { ErrorExtends, Matrix, MatrixResultError } from "../type";
+import { exclusionAllNumericParameterDescriptor } from "../utility/character-set-descriptor";
+import { StringProxy } from "../utility/string-proxy";
 import {
     countParameterDescriptor,
     startValueParameterDescriptor,
     valueParameterDescriptor
-} from "../utility/transformer-descriptor.js";
+} from "../utility/transformer-descriptor";
 
 const identifierParameterDescriptor: ParameterDescriptor = {
     name: "identifier",

package/src/gs1/index.ts

@@ -1,3 +1,3 @@
-export * from "./character-set-proxy.js";
-export * from "./check-proxy.js";
-export * from "./identifier-proxy.js";
+export * from "./character-set-proxy";
+export * from "./check-proxy";
+export * from "./identifier-proxy";

package/src/index.ts

@@ -14,12 +14,12 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-export * from "./locale/i18n.js";
-export * from "./types.js";
-export * from "./app-extension.js";
-export * from "./lib-proxy.js";
-export * from "./descriptor.js";
-export * from "./app-utility-proxy.js";
-export * from "./utility/index.js";
-export * as GS1 from "./gs1/index.js";
-export * from "./generator/index.js";
+export * from "./locale/i18n";
+export type * from "./type";
+export * from "./app-extension";
+export * from "./lib-proxy";
+export * from "./descriptor";
+export * from "./app-utility-proxy";
+export * from "./utility/index";
+export * as GS1 from "./gs1/index";
+export * from "./generator/index";

package/src/lib-proxy.ts

@@ -1,7 +1,7 @@
 import { mapIterable } from "@aidc-toolkit/utility";
-import type { AppExtension } from "./app-extension.js";
-import { i18nextAppExtension } from "./locale/i18n.js";
-import type { ErrorExtends, Matrix, MatrixResultError, ResultError } from "./types.js";
+import type { AppExtension } from "./app-extension";
+import { i18nextAppExtension } from "./locale/i18n";
+import type { ErrorExtends, Matrix, MatrixResultError, ResultError } from "./type";
 
 /**
  * Library proxy.

package/src/locale/i18n.ts

@@ -1,9 +1,9 @@
-import { i18nAssertValidResources, i18nCoreInit, type I18nEnvironment } from "@aidc-toolkit/core";
+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.js";
-import frLocaleResources from "./fr/locale-resources.js";
+import enLocaleResources from "./en/locale-resources";
+import frLocaleResources from "./fr/locale-resources";
 
 export const appExtensionNS = "aidct_app_extension";
 
@@ -12,8 +12,6 @@ export const appExtensionNS = "aidct_app_extension";
  */
 export type AppExtensionLocaleResources = typeof enLocaleResources;
 
-i18nAssertValidResources(enLocaleResources, "fr", frLocaleResources);
-
 /**
  * App extension resources.
  */

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.js";
+import type { AppExtensionLocaleResources } from "./i18n";
 
 /**
  * Internationalization module.

package/{dist/types.d.ts → src/type.ts}

@@ -6,6 +6,7 @@
  * If true, errors are reported through the throw/catch mechanism.
  */
 export type ErrorExtends<ThrowError extends boolean> = ThrowError extends true ? Error : object;
+
 /**
  * Sheet.
  */
@@ -15,6 +16,7 @@ export interface Sheet {
      */
     readonly name: string;
 }
+
 /**
  * Single cell address.
  */
@@ -23,16 +25,19 @@ export interface Address {
      * Zero-indexed row.
      */
     readonly rowIndex: number;
+
     /**
      * Zero-indexed column.
      */
     readonly columnIndex: number;
 }
+
 /**
  * Sheet address.
  */
 export interface SheetAddress extends Sheet, Address {
 }
+
 /**
  * Range of cells.
  */
@@ -41,16 +46,19 @@ export interface Range {
      * Start address, inclusive.
      */
     readonly startAddress: Address;
+
     /**
      * End address, exclusive.
      */
     readonly endAddress: Address;
 }
+
 /**
  * Sheet range.
  */
 export interface SheetRange extends Sheet, Range {
 }
+
 /**
  * Matrix type; shorthand for defining a two-dimensional matrix (array of array) of a type.
  *
@@ -58,6 +66,7 @@ export interface SheetRange extends Sheet, Range {
  * Type.
  */
 export type Matrix<T> = T[][];
+
 /**
  * Function result, possibly including an error result. If the application framework reports errors through the return
  * value, the result is the union of the result type and the error type; otherwise, it's just the result type.
@@ -72,6 +81,7 @@ export type Matrix<T> = T[][];
  * Error type.
  */
 export type ResultError<TResult, ThrowError extends boolean, TError extends ErrorExtends<ThrowError>> = ThrowError extends false ? TResult | TError : TResult;
+
 /**
  * Function result as matrix, possibly including an error result in each element. If the application framework reports
  * errors through the return value, the individual element result is the union of the result type and the error type;
@@ -87,41 +97,3 @@ export type ResultError<TResult, ThrowError extends boolean, TError extends Erro
  * Error type.
  */
 export type MatrixResultError<TResult, ThrowError extends boolean, TError extends ErrorExtends<ThrowError>> = Matrix<ResultError<TResult, ThrowError, TError>>;
-/**
- * Typed function, applicable to any function, stricter than {@link Function}.
- */
-export type TypedFunction<TMethod extends (...args: Parameters<TMethod>) => ReturnType<TMethod>> = (...args: Parameters<TMethod>) => ReturnType<TMethod>;
-/**
- * Typed synchronous function, applicable to any function that doesn't return a Promise.
- */
-export type TypedSyncFunction<TMethod extends TypedFunction<TMethod>> = [ReturnType<TMethod>] extends [PromiseLike<unknown>] ? never : TypedFunction<TMethod>;
-/**
- * Determine the fundamental promised type. This is stricter than `Awaited\<Type\>` in that it requires a Promise.
- */
-type PromisedType<T> = [T] extends [PromiseLike<infer TPromised>] ? TPromised : never;
-/**
- * Typed asynchronous function, applicable to any function that returns a Promise.
- */
-export type TypedAsyncFunction<TMethod extends (...args: Parameters<TMethod>) => PromiseLike<PromisedType<ReturnType<TMethod>>>> = (...args: Parameters<TMethod>) => Promise<PromisedType<ReturnType<TMethod>>>;
-/**
- * Nullishable type. Application extension may pass `null` or `undefined` to missing parameters.
- */
-export type Nullishable<T> = T | null | undefined;
-/**
- * Non-nullishable type. If T is an object type, it is spread and attributes within it are made non-nullishable.
- */
-export type NonNullishable<T> = T extends object ? {
-    [P in keyof T]-?: NonNullishable<T[P]>;
-} : NonNullable<T>;
-/**
- * Determine if argument is nullish. Application extension may pass `null` or `undefined` to missing parameters.
- *
- * @param argument
- * Argument.
- *
- * @returns
- * True if argument is undefined or null.
- */
-export declare function isNullish<T>(argument: T | null | undefined): argument is null | undefined;
-export {};
-//# sourceMappingURL=types.d.ts.map

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

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

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

@@ -1,3 +1,4 @@
+import type { Nullishable } from "@aidc-toolkit/core";
 import {
     ALPHABETIC_CREATOR,
     ALPHANUMERIC_CREATOR,
@@ -8,7 +9,7 @@ import {
     NUMERIC_CREATOR,
     Sequence
 } from "@aidc-toolkit/utility";
-import type { AppExtension } from "../app-extension.js";
+import type { AppExtension } from "../app-extension";
 import {
     expandParameterDescriptor,
     type ParameterDescriptor,
@@ -16,22 +17,22 @@ import {
     ProxyMethod,
     ProxyParameter,
     Types
-} from "../descriptor.js";
-import { LibProxy } from "../lib-proxy.js";
-import type { ErrorExtends, Matrix, MatrixResultError, Nullishable, ResultError } from "../types.js";
+} from "../descriptor";
+import { LibProxy } from "../lib-proxy";
+import type { ErrorExtends, Matrix, MatrixResultError, ResultError } from "../type";
 import {
     exclusionAnyParameterDescriptor,
     exclusionFirstZeroParameterDescriptor,
     exclusionNoneParameterDescriptor
-} from "./character-set-descriptor.js";
-import { sParameterDescriptor, validateSParameterDescriptor } from "./string-descriptor.js";
-import { StringProxy } from "./string-proxy.js";
+} from "./character-set-descriptor";
+import { sParameterDescriptor, validateSParameterDescriptor } from "./string-descriptor";
+import { StringProxy } from "./string-proxy";
 import {
     countParameterDescriptor,
     startValueParameterDescriptor,
     tweakParameterDescriptor,
     valueParameterDescriptor
-} from "./transformer-descriptor.js";
+} from "./transformer-descriptor";
 
 const lengthParameterDescriptor: ParameterDescriptor = {
     name: "length",

package/src/utility/index.ts

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

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

@@ -1,8 +1,9 @@
+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 { ErrorExtends, Matrix, MatrixResultError, Nullishable } from "../types.js";
-import { validateSParameterDescriptor } from "./string-descriptor.js";
-import { StringProxy } from "./string-proxy.js";
+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";
 
 const regExpParameterDescriptor: ParameterDescriptor = {
     name: "regExp",

package/src/utility/string-descriptor.ts

@@ -1,4 +1,4 @@
-import { type ParameterDescriptor, Types } from "../descriptor.js";
+import { type ParameterDescriptor, Types } from "../descriptor";
 
 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.js";
-import type { ErrorExtends, Matrix, MatrixResultError } from "../types.js";
+import { LibProxy } from "../lib-proxy";
+import type { ErrorExtends, Matrix, MatrixResultError } from "../type";
 
 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.js";
+import { type ParameterDescriptor, Types } from "../descriptor";
 
 export const valueParameterDescriptor: ParameterDescriptor = {
     name: "value",

package/src/utility/transformer-proxy.ts

@@ -1,13 +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.js";
-import { LibProxy } from "../lib-proxy.js";
-import type { ErrorExtends, Matrix, MatrixResultError, Nullishable, ResultError } from "../types.js";
+import { type ParameterDescriptor, ProxyClass, ProxyMethod, ProxyParameter, Types } from "../descriptor";
+import { LibProxy } from "../lib-proxy";
+import type { ErrorExtends, Matrix, MatrixResultError, ResultError } from "../type";
 import {
     countParameterDescriptor,
     startValueParameterDescriptor,
     tweakParameterDescriptor,
     valueParameterDescriptor
-} from "./transformer-descriptor.js";
+} from "./transformer-descriptor";
 
 const domainParameterDescriptor: ParameterDescriptor = {
     name: "domain",

package/tsup.config.ts

@@ -0,0 +1,3 @@
+import { tsupConfigAIDCToolkit } from "@aidc-toolkit/dev";
+
+export default tsupConfigAIDCToolkit;