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

package/package.json

@@ -1,11 +1,14 @@
 {
   "name": "@aidc-toolkit/app-extension",
-  "version": "1.0.25-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": "1.0.25-beta",
-    "@types/node": "^24.10.1"
+    "@aidc-toolkit/dev": "1.0.26-beta"
   },
   "dependencies": {
-    "@aidc-toolkit/core": "1.0.25-beta",
-    "@aidc-toolkit/gs1": "1.0.25-beta",
-    "@aidc-toolkit/utility": "1.0.25-beta",
+    "@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.

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, AI64_VALIDATOR, AI82_CREATOR } from "@aidc-toolkit/gs1";
-import type { AppExtension } from "../app-extension";
-import { expandParameterDescriptor, ProxyClass } from "../descriptor";
-import type { ErrorExtends } from "../type";
-import { CharacterSetCreatorProxy, CharacterSetValidatorProxy } from "../utility";
+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";
+} from "../utility/character-set-descriptor.js";
 
 @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";
-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",

package/src/gs1/identifier-proxy.ts

@@ -32,7 +32,7 @@ import {
     type SerializableNumericIdentifierType
 } from "@aidc-toolkit/gs1";
 import { Sequence } from "@aidc-toolkit/utility";
-import type { AppExtension } from "../app-extension";
+import type { AppExtension } from "../app-extension.js";
 import {
     expandParameterDescriptor,
     type ParameterDescriptor,
@@ -40,17 +40,17 @@ import {
     ProxyMethod,
     ProxyParameter,
     Types
-} 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";
+} from "../descriptor.js";
+import { LibProxy } from "../lib-proxy.js";
+import { i18nextAppExtension } from "../locale/i18n.js";
+import type { ErrorExtends, Matrix, MatrixResultError } from "../type.js";
+import { exclusionAllNumericParameterDescriptor } from "../utility/character-set-descriptor.js";
+import { StringProxy } from "../utility/string-proxy.js";
 import {
     countParameterDescriptor,
     startValueParameterDescriptor,
     valueParameterDescriptor
-} from "../utility/transformer-descriptor";
+} from "../utility/transformer-descriptor.js";
 
 const identifierParameterDescriptor: ParameterDescriptor = {
     name: "identifier",

package/src/gs1/index.ts

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

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";
-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";
+export * from "./locale/i18n.js";
+export type * from "./type.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";

package/src/lib-proxy.ts

@@ -1,7 +1,7 @@
 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.

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",

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);