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

package/package.json

@@ -1,11 +1,14 @@
 {
   "name": "@aidc-toolkit/app-extension",
-  "version": "1.0.24-beta",
+  "version": "1.0.26-beta",
   "description": "Application extension framework for AIDC Toolkit",
   "type": "module",
   "main": "dist/index.js",
   "homepage": "https://aidc-toolkit.com/",
-  "repository": "aidc-toolkit/app-extension",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/aidc-toolkit/app-extension.git"
+  },
   "bugs": {
     "url": "https://github.com/aidc-toolkit/app-extension/issues"
   },
@@ -16,19 +19,21 @@
     "url": "https://www.linkedin.com/in/kdean"
   },
   "scripts": {
+    "locale-resources-generator": "tsx src/generator/locale-resources-generator.ts",
     "lint": "eslint",
+    "tsc:core": "tsc --project tsconfig-src.json",
+    "build:devx": "rimraf dist && npm run tsc:core -- --declarationMap --sourceMap",
     "build:dev": "tsup --define.mode=dev",
-    "build:release": "tsup",
+    "build:release": "npm run tsc:core -- --noEmit && tsup",
     "build:doc": "npm run build:dev"
   },
   "devDependencies": {
-    "@aidc-toolkit/dev": "beta",
-    "@types/node": "^24.10.1"
+    "@aidc-toolkit/dev": "1.0.26-beta"
   },
   "dependencies": {
-    "@aidc-toolkit/core": "beta",
-    "@aidc-toolkit/gs1": "beta",
-    "@aidc-toolkit/utility": "beta",
-    "i18next": "^25.7.0"
+    "@aidc-toolkit/core": "1.0.26-beta",
+    "@aidc-toolkit/gs1": "1.0.26-beta",
+    "@aidc-toolkit/utility": "1.0.26-beta",
+    "i18next": "^25.7.1"
   }
 }

package/src/app-extension.ts

@@ -1,6 +1,6 @@
 import type { TypedAsyncFunction, TypedFunction, TypedSyncFunction } from "@aidc-toolkit/core";
-import { i18nextAppExtension } from "./locale/i18n";
-import type { ErrorExtends, ResultError, SheetAddress, SheetRange } from "./type";
+import { i18nextAppExtension } from "./locale/i18n.js";
+import type { ErrorExtends, ResultError, SheetAddress, SheetRange } from "./type.js";
 
 /**
  * Application extension.

package/src/app-utility-proxy.ts

@@ -1,8 +1,8 @@
 import { isNullish, type NonNullishable, type Nullishable } from "@aidc-toolkit/core";
-import { type ParameterDescriptor, ProxyClass, ProxyMethod, ProxyParameter, Types } from "./descriptor";
-import { LibProxy } from "./lib-proxy";
-import { i18nextAppExtension } from "./locale/i18n";
-import type { ErrorExtends, Matrix } from "./type";
+import { type ParameterDescriptor, ProxyClass, ProxyMethod, ProxyParameter, Types } from "./descriptor.js";
+import { LibProxy } from "./lib-proxy.js";
+import { i18nextAppExtension } from "./locale/i18n.js";
+import type { ErrorExtends, Matrix } from "./type.js";
 
 const spillMatrix: ParameterDescriptor = {
     name: "spillMatrix",

package/src/descriptor.ts

@@ -1,7 +1,7 @@
 import type { TypedFunction } from "@aidc-toolkit/core";
-import type { AppExtension } from "./app-extension";
-import { LibProxy } from "./lib-proxy";
-import type { ErrorExtends } from "./type";
+import type { AppExtension } from "./app-extension.js";
+import { LibProxy } from "./lib-proxy.js";
+import type { ErrorExtends } from "./type.js";
 
 /**
  * Core descriptor.
@@ -38,10 +38,15 @@ export const Types = {
     Any: 3
 } as const;
 
+/**
+ * Type key.
+ */
+export type TypeKey = keyof typeof Types;
+
 /**
  * Type.
  */
-export type Type = typeof Types[keyof typeof Types];
+export type Type = typeof Types[TypeKey];
 
 /**
  * Type descriptor.

package/src/generator/descriptor.ts

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

package/src/generator/generator.ts

@@ -1,14 +1,28 @@
 import { I18nEnvironments } from "@aidc-toolkit/core";
 import type { ParseKeys } from "i18next";
-import { expandParameterDescriptor, getClassDescriptorsMap } from "../descriptor";
-import { appExtensionResources, i18nAppExtensionInit, i18nextAppExtension } from "../locale/i18n";
+import { AppUtilityProxy } from "../app-utility-proxy.js";
+import { expandParameterDescriptor, getClassDescriptorsMap } from "../descriptor.js";
+import * as GS1 from "../gs1/index.js";
+import { appExtensionResources, i18nAppExtensionInit, i18nextAppExtension } from "../locale/i18n.js";
+import * as Utility from "../utility/index.js";
 import type {
     FunctionLocalization,
     Localization,
     ParameterLocalization,
     ProxyFunctionDescriptor,
     ProxyObjectDescriptor
-} from "./descriptor";
+} from "./descriptor.js";
+
+/**
+ * Dummy method to force proxies to register their decorators.
+ *
+ * @param _proxies
+ * Proxies.
+ */
+function registerProxies(..._proxies: unknown[]): void {
+}
+
+registerProxies(AppUtilityProxy, Utility, GS1);
 
 /**
  * Abstract generator.
@@ -89,7 +103,7 @@ export abstract class Generator {
         const functionLocalization = this._functionLocalizationsMapsMap.get(namespaceFunctionName)?.get(locale);
 
         if (functionLocalization === undefined) {
-            throw new Error(`Localization for function "${namespaceFunctionName}", locale "${locale}" not found`);
+            throw new Error(`${locale} localization for function ${namespaceFunctionName} not found`);
         }
 
         return functionLocalization;
@@ -114,7 +128,7 @@ export abstract class Generator {
         const parameterLocalization = this._parameterLocalizationsMapsMap.get(`${namespaceFunctionName}.${parameterName}`)?.get(locale);
 
         if (parameterLocalization === undefined) {
-            throw new Error(`Localization for function "${namespaceFunctionName}", parameter "${parameterName}", locale "${locale}" not found`);
+            throw new Error(`${locale} localization for function ${namespaceFunctionName} parameter ${parameterName} not found`);
         }
 
         return parameterLocalization;
@@ -184,6 +198,10 @@ export abstract class Generator {
 
         await i18nAppExtensionInit(I18nEnvironments.CLI);
 
+        // const LocaleResourcesSource = path.resolve(LocaleResourcesGenerator.IMPORT_PATH, entry.name, "locale-resources.ts");
+        //
+        // await import(LocaleResourcesSource).then((module) => {
+
         this.initialize();
 
         try {
@@ -237,7 +255,7 @@ export abstract class Generator {
                         const insertIndex = methodName.indexOf(infixBefore);
 
                         if (insertIndex === -1) {
-                            throw new Error(`Cannot find "${infixBefore}" in method name ${methodName}`);
+                            throw new Error(`Cannot find "${infixBefore}" in method ${methodName}`);
                         }
 
                         // Other classes in the hierarchy and infix is in the middle of the string.

package/src/generator/index.ts

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

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

@@ -1,9 +1,9 @@
 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";
-import type { ProxyFunctionDescriptor } from "./descriptor";
-import { Generator } from "./generator";
+import { expandParameterDescriptor, type ParameterDescriptor } from "../descriptor.js";
+import type { ProxyFunctionDescriptor } from "./descriptor.js";
+import { Generator } from "./generator.js";
 
 /**
  * Parameters sequencer entry.
@@ -37,7 +37,7 @@ interface LocaleResourcesModule {
     /**
      * Locale resources.
      */
-    LocaleResources: LocaleResources;
+    default: LocaleResources;
 }
 
 /**
@@ -188,7 +188,7 @@ class LocaleResourcesGenerator extends Generator {
         }
 
         if (functionName in functionsLocaleResources) {
-            throw new Error(`Duplicate function "${functionName}"`);
+            throw new Error(`Duplicate function ${functionName}`);
         }
 
         // Add function.
@@ -346,13 +346,13 @@ class LocaleResourcesGenerator extends Generator {
             await Promise.all(fs.readdirSync(LocaleResourcesGenerator.IMPORT_PATH, {
                 withFileTypes: true
             }).filter(entry => entry.isDirectory()).map(async (entry) => {
-                const LocaleResourcesSource = path.resolve(LocaleResourcesGenerator.IMPORT_PATH, entry.name, "locale-resources.ts");
+                const localeResourcesSource = path.resolve(LocaleResourcesGenerator.IMPORT_PATH, entry.name, "locale-resources.ts");
 
-                await import(LocaleResourcesSource).then((module) => {
+                await import(localeResourcesSource).then((module) => {
                     // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Module format is known.
-                    const LocaleResources = this.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).default, !entry.name.includes("-"));
 
-                    fs.writeFileSync(LocaleResourcesSource, `${LocaleResourcesGenerator.buildOutput("export default", LocaleResources, 0)};\n`);
+                    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";
-import { expandParameterDescriptor, ProxyClass } from "../descriptor";
-import type { ErrorExtends } from "../type";
+import { AI39_CREATOR, AI64_VALIDATOR, AI82_CREATOR } from "@aidc-toolkit/gs1";
+import type { AppExtension } from "../app-extension.js";
+import { expandParameterDescriptor, ProxyClass } from "../descriptor.js";
+import type { ErrorExtends } from "../type.js";
+import { CharacterSetCreatorProxy, CharacterSetValidatorProxy } from "../utility/index.js";
 import {
     exclusionAllNumericParameterDescriptor,
     exclusionNoneParameterDescriptor
-} from "../utility/character-set-descriptor";
-import { CharacterSetProxy } from "../utility";
+} from "../utility/character-set-descriptor.js";
 
 @ProxyClass({
     namespace: "GS1",
@@ -18,7 +18,7 @@ import { CharacterSetProxy } from "../utility";
         }
     ]
 })
-export class AI82Proxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends CharacterSetProxy<ThrowError, TError, TInvocationContext, TBigInt> {
+export class AI82Proxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends CharacterSetCreatorProxy<ThrowError, TError, TInvocationContext, TBigInt> {
     constructor(appExtension: AppExtension<ThrowError, TError, TInvocationContext, TBigInt>) {
         super(appExtension, AI82_CREATOR);
     }
@@ -34,8 +34,18 @@ export class AI82Proxy<ThrowError extends boolean, TError extends ErrorExtends<T
         }
     ]
 })
-export class AI39Proxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends CharacterSetProxy<ThrowError, TError, TInvocationContext, TBigInt> {
+export class AI39Proxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends CharacterSetCreatorProxy<ThrowError, TError, TInvocationContext, TBigInt> {
     constructor(appExtension: AppExtension<ThrowError, TError, TInvocationContext, TBigInt>) {
         super(appExtension, AI39_CREATOR);
     }
 }
+
+@ProxyClass({
+    namespace: "GS1",
+    methodInfix: "AI64"
+})
+export class AI64Proxy<ThrowError extends boolean, TError extends ErrorExtends<ThrowError>, TInvocationContext, TBigInt> extends CharacterSetValidatorProxy<ThrowError, TError, TInvocationContext, TBigInt> {
+    constructor(appExtension: AppExtension<ThrowError, TError, TInvocationContext, TBigInt>) {
+        super(appExtension, AI64_VALIDATOR);
+    }
+}

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";
-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";
 
 const checkSParameterDescriptor: ParameterDescriptor = {
     name: "checkS",