@aidc-toolkit/app-extension 0.9.19-beta → 0.9.20-beta

package/README.md

@@ -14,4 +14,4 @@ Unless required by applicable law or agreed to in writing, software distributed
 >
 > **This software is in beta**, with production release is scheduled for 2025Q4. To follow the status of this and other projects, go to the AIDC Toolkit [projects](https://github.com/orgs/aidc-toolkit/projects) page.
 
-The AIDC Toolkit `app-extension` package is the bridge between the AIDC Toolkit and applications such s Microsoft Excel and Google Sheets. It provides little functionality of its own.
+The AIDC Toolkit `app-extension` package is the bridge between the AIDC Toolkit and applications such as Microsoft Excel and Google Sheets. It does so by flattening the object model, replacing stateful object construction and method calls with stateless functions.

package/dist/generator/descriptor.d.ts

@@ -0,0 +1,107 @@
+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;
+}
+//# sourceMappingURL=descriptor.d.ts.map

package/dist/generator/descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor.d.ts","sourceRoot":"","sources":["../../src/generator/descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEnG;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,YAAY;IACtD;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,YAAY;CAC1D;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB,CAAC,CAAC,SAAS,YAAY;IAC1D;;OAEG;IACH,QAAQ,CAAC,gBAAgB,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;CACrD;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACrC;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,wBAAwB;IAClE;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IAEpC;;OAEG;IACH,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,oBAAoB;IAC/D;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,wBAAwB,EAAE,sBAAsB,CAAC,qBAAqB,CAAC;IACrH;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,QAAQ,CAAC,mBAAmB,EAAE,uBAAuB,CAAC;CACzD;AAED;;GAEG;AACH,MAAM,WAAW,uBAAwB,SAAQ,qBAAqB,EAAE,sBAAsB,CAAC,oBAAoB,CAAC;IAChH;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IAEvC;;OAEG;IACH,QAAQ,CAAC,yBAAyB,EAAE,wBAAwB,EAAE,CAAC;IAE/D;;OAEG;IACH,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;CAC/C"}

package/dist/generator/descriptor.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=descriptor.js.map

package/dist/generator/descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor.js","sourceRoot":"","sources":["../../src/generator/descriptor.ts"],"names":[],"mappings":""}

package/dist/generator/generator.d.ts

@@ -0,0 +1,120 @@
+import type { FunctionLocalization, ParameterLocalization, ProxyFunctionDescriptor, ProxyObjectDescriptor } from "./descriptor.js";
+/**
+ * Abstract generator.
+ */
+export declare abstract class Generator {
+    /**
+     * Documentation base URL.
+     */
+    private static readonly DOCUMENTATION_BASE_URL;
+    /**
+     * Documentation path, optionally preceded by locale.
+     */
+    private static readonly DOCUMENTATION_PATH;
+    /**
+     * Locales.
+     */
+    private readonly _locales;
+    /**
+     * Default locale.
+     */
+    private readonly _defaultLocale;
+    /**
+     * Map of function localizations maps by namespace function name.
+     */
+    private readonly _functionLocalizationsMapsMap;
+    /**
+     * Map of parameter localizations maps by namespace function parameter name.
+     */
+    private readonly _parameterLocalizationsMapsMap;
+    /**
+     *
+     */
+    /**
+     * Constructor.
+     *
+     * @param includeLocalizations
+     * Include localizations if true.
+     */
+    constructor(includeLocalizations?: boolean);
+    /**
+     * Get the locales.
+     */
+    protected get locales(): readonly string[];
+    /**
+     * Get the default locale.
+     */
+    protected get defaultLocale(): string;
+    /**
+     * Get function localization.
+     *
+     * @param namespaceFunctionName
+     * Namespace function name.
+     *
+     * @param locale
+     * Locale.
+     *
+     * @returns
+     * Function localization.
+     */
+    protected getFunctionLocalization(namespaceFunctionName: string, locale: string): FunctionLocalization;
+    /**
+     * Get parameter localization.
+     *
+     * @param namespaceFunctionName
+     * Namespace function name.
+     *
+     * @param parameterName
+     * Parameter name.
+     *
+     * @param locale
+     * Locale.
+     *
+     * @returns
+     * Function localization.
+     */
+    protected getParameterLocalization(namespaceFunctionName: string, parameterName: string, locale: string): ParameterLocalization;
+    /**
+     * Initialize the generation of the output.
+     */
+    protected abstract initialize(): void;
+    /**
+     * Create a proxy object.
+     *
+     * @param proxyObjectDescriptor
+     * Proxy object descriptor.
+     */
+    protected abstract createProxyObject(proxyObjectDescriptor: ProxyObjectDescriptor): void;
+    /**
+     * Create a proxy function.
+     *
+     * @param proxyFunctionDescriptor
+     * Proxy function descriptor.
+     */
+    protected abstract createProxyFunction(proxyFunctionDescriptor: ProxyFunctionDescriptor): void;
+    /**
+     * Finalize the generation of the output.
+     *
+     * @param success
+     * True if successful.
+     */
+    protected abstract finalize(success: boolean): void | Promise<void>;
+    /**
+     * Generate localizations map.
+     *
+     * @param localizedKeyPrefix
+     * Localized key prefix.
+     *
+     * @param localizationCallback
+     * Callback to finalize localization.
+     *
+     * @returns
+     * Localization map.
+     */
+    private generateLocalizationsMap;
+    /**
+     * Generate by processing individual imports.
+     */
+    generate(): Promise<void>;
+}
+//# sourceMappingURL=generator.d.ts.map

package/dist/generator/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/generator/generator.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACR,oBAAoB,EAEpB,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,EACxB,MAAM,iBAAiB,CAAC;AAEzB;;GAEG;AACH,8BAAsB,SAAS;IAC3B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,sBAAsB,CAA+B;IAE7E;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAoB;IAE9D;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoB;IAE7C;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IAExC;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,6BAA6B,CAAgE;IAE9G;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,8BAA8B,CAAiE;IAEhH;;OAEG;IAEH;;;;;OAKG;gBACS,oBAAoB,UAAO;IAKvC;;OAEG;IACH,SAAS,KAAK,OAAO,IAAI,SAAS,MAAM,EAAE,CAEzC;IAED;;OAEG;IACH,SAAS,KAAK,aAAa,IAAI,MAAM,CAEpC;IAED;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,uBAAuB,CAAC,qBAAqB,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,oBAAoB;IAUtG;;;;;;;;;;;;;;OAcG;IACH,SAAS,CAAC,wBAAwB,CAAC,qBAAqB,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,qBAAqB;IAU/H;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,UAAU,IAAI,IAAI;IAErC;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,qBAAqB,GAAG,IAAI;IAExF;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,CAAC,mBAAmB,CAAC,uBAAuB,EAAE,uBAAuB,GAAG,IAAI;IAE9F;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAEnE;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,wBAAwB;IAehC;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAyGlC"}

package/dist/generator/generator.js

@@ -0,0 +1,213 @@
+import { I18nEnvironment } from "@aidc-toolkit/core";
+import { expandParameterDescriptor, getClassDescriptors } from "../descriptor.js";
+import { appExtensionResources, i18nAppExtensionInit, i18nextAppExtension } from "../locale/i18n.js";
+/**
+ * Abstract generator.
+ */
+export class Generator {
+    /**
+     * Documentation base URL.
+     */
+    static DOCUMENTATION_BASE_URL = "https://aidc-toolkit.com/";
+    /**
+     * Documentation path, optionally preceded by locale.
+     */
+    static DOCUMENTATION_PATH = "app-extension/";
+    /**
+     * Locales.
+     */
+    _locales;
+    /**
+     * Default locale.
+     */
+    _defaultLocale;
+    /**
+     * Map of function localizations maps by namespace function name.
+     */
+    _functionLocalizationsMapsMap = new Map();
+    /**
+     * Map of parameter localizations maps by namespace function parameter name.
+     */
+    _parameterLocalizationsMapsMap = new Map();
+    /**
+     *
+     */
+    /**
+     * Constructor.
+     *
+     * @param includeLocalizations
+     * Include localizations if true.
+     */
+    constructor(includeLocalizations = true) {
+        this._locales = includeLocalizations ? Object.keys(appExtensionResources) : [];
+        this._defaultLocale = this._locales[0] ?? "";
+    }
+    /**
+     * Get the locales.
+     */
+    get locales() {
+        return this._locales;
+    }
+    /**
+     * Get the default locale.
+     */
+    get defaultLocale() {
+        return this._defaultLocale;
+    }
+    /**
+     * Get function localization.
+     *
+     * @param namespaceFunctionName
+     * Namespace function name.
+     *
+     * @param locale
+     * Locale.
+     *
+     * @returns
+     * Function localization.
+     */
+    getFunctionLocalization(namespaceFunctionName, locale) {
+        const functionLocalization = this._functionLocalizationsMapsMap.get(namespaceFunctionName)?.get(locale);
+        if (functionLocalization === undefined) {
+            throw new Error(`Localization for function "${namespaceFunctionName}", locale "${locale}" not found`);
+        }
+        return functionLocalization;
+    }
+    /**
+     * Get parameter localization.
+     *
+     * @param namespaceFunctionName
+     * Namespace function name.
+     *
+     * @param parameterName
+     * Parameter name.
+     *
+     * @param locale
+     * Locale.
+     *
+     * @returns
+     * Function localization.
+     */
+    getParameterLocalization(namespaceFunctionName, parameterName, locale) {
+        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`);
+        }
+        return parameterLocalization;
+    }
+    /**
+     * Generate localizations map.
+     *
+     * @param localizedKeyPrefix
+     * Localized key prefix.
+     *
+     * @param localizationCallback
+     * Callback to finalize localization.
+     *
+     * @returns
+     * Localization map.
+     */
+    generateLocalizationsMap(localizedKeyPrefix, localizationCallback) {
+        return new Map(this._locales.map((locale) => {
+            const lngOption = {
+                lng: locale
+            };
+            return [locale, localizationCallback(locale, {
+                    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Localized key exists.
+                    name: i18nextAppExtension.t(`${localizedKeyPrefix}name`, lngOption),
+                    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Localized key exists.
+                    description: i18nextAppExtension.t(`${localizedKeyPrefix}description`, lngOption)
+                })];
+        }));
+    }
+    /**
+     * Generate by processing individual imports.
+     */
+    async generate() {
+        let success = false;
+        await i18nAppExtensionInit(I18nEnvironment.CLI);
+        this.initialize();
+        try {
+            for (const classDescriptor of getClassDescriptors().values()) {
+                const namespace = classDescriptor.namespace;
+                const namespacePrefix = namespace === undefined ? "" : `${namespace}.`;
+                const className = classDescriptor.name;
+                const methodInfix = classDescriptor.methodInfix;
+                // Namespace-qualified class name is used to construct object name.
+                const namespaceClassName = `${namespacePrefix}${className}`;
+                // First capture group is:
+                // - one or more uppercase letters followed by zero or more numbers; or
+                // - single uppercase letter followed by zero or more characters except uppercase letters or period.
+                // Second capture group is:
+                // - single uppercase letter followed by zero or more characters except period; or
+                // - zero characters (empty string).
+                // Third capture group, separated by optional period, is:
+                // - single uppercase letter followed by zero or more characters (remainder of string); or
+                // - zero characters (empty string).
+                const classNameMatch = /^([A-Z]+[0-9]*|[A-Z][^A-Z.]*)([A-Z][^.]*|)\.?([A-Z].*|)$/.exec(namespaceClassName);
+                if (classNameMatch === null) {
+                    throw new Error(`${namespaceClassName} is not a valid namespace-qualified class name`);
+                }
+                const proxyObjectDescriptor = {
+                    namespace,
+                    className,
+                    namespaceClassName,
+                    classDescriptor,
+                    objectName: `${classNameMatch[1].toLowerCase()}${classNameMatch[2]}${classNameMatch[3]}`
+                };
+                this.createProxyObject(proxyObjectDescriptor);
+                for (const methodDescriptor of classDescriptor.methodDescriptors) {
+                    const methodName = methodDescriptor.name;
+                    const infixBefore = methodDescriptor.infixBefore;
+                    let functionName;
+                    if (methodInfix === undefined || methodDescriptor.ignoreInfix === true) {
+                        // No other classes in the hierarchy or no infix required.
+                        functionName = methodName;
+                    }
+                    else if (infixBefore === undefined) {
+                        // Other classes in the hierarchy and infix is postfix.
+                        functionName = `${methodName}${methodInfix}`;
+                    }
+                    else {
+                        const insertIndex = methodName.indexOf(infixBefore);
+                        if (insertIndex === -1) {
+                            throw new Error(`Cannot find "${infixBefore}" in method name ${methodName}`);
+                        }
+                        // Other classes in the hierarchy and infix is in the middle of the string.
+                        functionName = `${methodName.substring(0, insertIndex)}${methodInfix}${methodName.substring(insertIndex)}`;
+                    }
+                    const namespaceFunctionName = `${namespacePrefix}${functionName}`;
+                    const functionLocalizationsMap = this.generateLocalizationsMap(`Functions.${namespaceFunctionName}.`, (locale, localization) => ({
+                        ...localization,
+                        documentationURL: `${Generator.DOCUMENTATION_BASE_URL}${locale === this.defaultLocale ? "" : `${locale}/`}${Generator.DOCUMENTATION_PATH}${namespace === undefined ? "" : `${namespace}/`}${localization.name}.html`
+                    }));
+                    this._functionLocalizationsMapsMap.set(namespaceFunctionName, functionLocalizationsMap);
+                    this.createProxyFunction({
+                        ...proxyObjectDescriptor,
+                        functionName,
+                        namespaceFunctionName,
+                        localizationsMap: functionLocalizationsMap,
+                        proxyParameterDescriptors: methodDescriptor.parameterDescriptors.map((parameterDescriptor) => {
+                            const expandedParameterDescriptor = expandParameterDescriptor(parameterDescriptor);
+                            const parameterName = expandedParameterDescriptor.name;
+                            const parameterLocalizationsMap = this.generateLocalizationsMap(`Parameters.${parameterName}.`, (_locale, localization) => localization);
+                            this._parameterLocalizationsMapsMap.set(`${namespaceFunctionName}.${parameterName}`, parameterLocalizationsMap);
+                            return {
+                                namespace,
+                                parameterName,
+                                localizationsMap: parameterLocalizationsMap,
+                                parameterDescriptor: expandedParameterDescriptor
+                            };
+                        }),
+                        methodDescriptor
+                    });
+                }
+            }
+            success = true;
+        }
+        finally {
+            await this.finalize(success);
+        }
+    }
+}
+//# sourceMappingURL=generator.js.map

package/dist/generator/generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../src/generator/generator.ts"],"names":[],"mappings":"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"}

package/dist/generator/index.d.ts

@@ -0,0 +1,3 @@
+export type * from "./descriptor.js";
+export * from "./generator.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/generator/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/generator/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,iBAAiB,CAAC;AACrC,cAAc,gBAAgB,CAAC"}

package/dist/generator/index.js

@@ -0,0 +1,2 @@
+export * from "./generator.js";
+//# sourceMappingURL=index.js.map

package/dist/generator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/generator/index.ts"],"names":[],"mappings":"AACA,cAAc,gBAAgB,CAAC"}

package/dist/index.d.ts

@@ -22,4 +22,5 @@ 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";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,cAAc,sBAAsB,CAAC"}

package/dist/index.js

@@ -22,4 +22,5 @@ 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";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,cAAc,sBAAsB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aidc-toolkit/app-extension",
-  "version": "0.9.19-beta",
+  "version": "0.9.20-beta",
   "description": "Application extension framework for AIDC Toolkit",
   "type": "module",
   "main": "dist/index.js",

package/src/generator/descriptor.ts

@@ -0,0 +1,122 @@
+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;
+}

package/src/generator/generator.ts

@@ -0,0 +1,287 @@
+import { I18nEnvironment } from "@aidc-toolkit/core";
+import type { ParseKeys } from "i18next";
+import { expandParameterDescriptor, getClassDescriptors } from "../descriptor.js";
+import { appExtensionResources, i18nAppExtensionInit, i18nextAppExtension } from "../locale/i18n.js";
+import type {
+    FunctionLocalization,
+    Localization,
+    ParameterLocalization,
+    ProxyFunctionDescriptor,
+    ProxyObjectDescriptor
+} from "./descriptor.js";
+
+/**
+ * Abstract generator.
+ */
+export abstract class Generator {
+    /**
+     * Documentation base URL.
+     */
+    private static readonly DOCUMENTATION_BASE_URL = "https://aidc-toolkit.com/";
+
+    /**
+     * Documentation path, optionally preceded by locale.
+     */
+    private static readonly DOCUMENTATION_PATH = "app-extension/";
+
+    /**
+     * Locales.
+     */
+    private readonly _locales: readonly string[];
+
+    /**
+     * Default locale.
+     */
+    private readonly _defaultLocale: string;
+
+    /**
+     * Map of function localizations maps by namespace function name.
+     */
+    private readonly _functionLocalizationsMapsMap = new Map<string, ReadonlyMap<string, FunctionLocalization>>();
+
+    /**
+     * Map of parameter localizations maps by namespace function parameter name.
+     */
+    private readonly _parameterLocalizationsMapsMap = new Map<string, ReadonlyMap<string, ParameterLocalization>>();
+
+    /**
+     *
+     */
+
+    /**
+     * Constructor.
+     *
+     * @param includeLocalizations
+     * Include localizations if true.
+     */
+    constructor(includeLocalizations = true) {
+        this._locales = includeLocalizations ? Object.keys(appExtensionResources) : [];
+        this._defaultLocale = this._locales[0] ?? "";
+    }
+
+    /**
+     * Get the locales.
+     */
+    protected get locales(): readonly string[] {
+        return this._locales;
+    }
+
+    /**
+     * Get the default locale.
+     */
+    protected get defaultLocale(): string {
+        return this._defaultLocale;
+    }
+
+    /**
+     * Get function localization.
+     *
+     * @param namespaceFunctionName
+     * Namespace function name.
+     *
+     * @param locale
+     * Locale.
+     *
+     * @returns
+     * Function localization.
+     */
+    protected getFunctionLocalization(namespaceFunctionName: string, locale: string): FunctionLocalization {
+        const functionLocalization = this._functionLocalizationsMapsMap.get(namespaceFunctionName)?.get(locale);
+
+        if (functionLocalization === undefined) {
+            throw new Error(`Localization for function "${namespaceFunctionName}", locale "${locale}" not found`);
+        }
+
+        return functionLocalization;
+    }
+
+    /**
+     * Get parameter localization.
+     *
+     * @param namespaceFunctionName
+     * Namespace function name.
+     *
+     * @param parameterName
+     * Parameter name.
+     *
+     * @param locale
+     * Locale.
+     *
+     * @returns
+     * Function localization.
+     */
+    protected getParameterLocalization(namespaceFunctionName: string, parameterName: string, locale: string): ParameterLocalization {
+        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`);
+        }
+
+        return parameterLocalization;
+    }
+
+    /**
+     * Initialize the generation of the output.
+     */
+    protected abstract initialize(): void;
+
+    /**
+     * Create a proxy object.
+     *
+     * @param proxyObjectDescriptor
+     * Proxy object descriptor.
+     */
+    protected abstract createProxyObject(proxyObjectDescriptor: ProxyObjectDescriptor): void;
+
+    /**
+     * Create a proxy function.
+     *
+     * @param proxyFunctionDescriptor
+     * Proxy function descriptor.
+     */
+    protected abstract createProxyFunction(proxyFunctionDescriptor: ProxyFunctionDescriptor): void;
+
+    /**
+     * Finalize the generation of the output.
+     *
+     * @param success
+     * True if successful.
+     */
+    protected abstract finalize(success: boolean): void | Promise<void>;
+
+    /**
+     * Generate localizations map.
+     *
+     * @param localizedKeyPrefix
+     * Localized key prefix.
+     *
+     * @param localizationCallback
+     * Callback to finalize localization.
+     *
+     * @returns
+     * Localization map.
+     */
+    private generateLocalizationsMap<T extends Localization>(localizedKeyPrefix: string, localizationCallback: (locale: string, localization: Localization) => T): ReadonlyMap<string, T> {
+        return new Map(this._locales.map((locale) => {
+            const lngOption = {
+                lng: locale
+            };
+
+            return [locale, localizationCallback(locale, {
+                // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Localized key exists.
+                name: i18nextAppExtension.t(`${localizedKeyPrefix}name` as ParseKeys, lngOption),
+                // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Localized key exists.
+                description: i18nextAppExtension.t(`${localizedKeyPrefix}description` as ParseKeys, lngOption)
+            })];
+        }));
+    }
+
+    /**
+     * Generate by processing individual imports.
+     */
+    async generate(): Promise<void> {
+        let success = false;
+
+        await i18nAppExtensionInit(I18nEnvironment.CLI);
+
+        this.initialize();
+
+        try {
+            for (const classDescriptor of getClassDescriptors().values()) {
+                const namespace = classDescriptor.namespace;
+                const namespacePrefix = namespace === undefined ? "" : `${namespace}.`;
+                const className = classDescriptor.name;
+                const methodInfix = classDescriptor.methodInfix;
+
+                // Namespace-qualified class name is used to construct object name.
+                const namespaceClassName = `${namespacePrefix}${className}`;
+
+                // First capture group is:
+                // - one or more uppercase letters followed by zero or more numbers; or
+                // - single uppercase letter followed by zero or more characters except uppercase letters or period.
+                // Second capture group is:
+                // - single uppercase letter followed by zero or more characters except period; or
+                // - zero characters (empty string).
+                // Third capture group, separated by optional period, is:
+                // - single uppercase letter followed by zero or more characters (remainder of string); or
+                // - zero characters (empty string).
+                const classNameMatch = /^([A-Z]+[0-9]*|[A-Z][^A-Z.]*)([A-Z][^.]*|)\.?([A-Z].*|)$/.exec(namespaceClassName);
+
+                if (classNameMatch === null) {
+                    throw new Error(`${namespaceClassName} is not a valid namespace-qualified class name`);
+                }
+
+                const proxyObjectDescriptor: ProxyObjectDescriptor = {
+                    namespace,
+                    className,
+                    namespaceClassName,
+                    classDescriptor,
+                    objectName: `${classNameMatch[1].toLowerCase()}${classNameMatch[2]}${classNameMatch[3]}`
+                };
+
+                this.createProxyObject(proxyObjectDescriptor);
+
+                for (const methodDescriptor of classDescriptor.methodDescriptors) {
+                    const methodName = methodDescriptor.name;
+                    const infixBefore = methodDescriptor.infixBefore;
+
+                    let functionName: string;
+
+                    if (methodInfix === undefined || methodDescriptor.ignoreInfix === true) {
+                        // No other classes in the hierarchy or no infix required.
+                        functionName = methodName;
+                    } else if (infixBefore === undefined) {
+                        // Other classes in the hierarchy and infix is postfix.
+                        functionName = `${methodName}${methodInfix}`;
+                    } else {
+                        const insertIndex = methodName.indexOf(infixBefore);
+
+                        if (insertIndex === -1) {
+                            throw new Error(`Cannot find "${infixBefore}" in method name ${methodName}`);
+                        }
+
+                        // Other classes in the hierarchy and infix is in the middle of the string.
+                        functionName = `${methodName.substring(0, insertIndex)}${methodInfix}${methodName.substring(insertIndex)}`;
+                    }
+
+                    const namespaceFunctionName = `${namespacePrefix}${functionName}`;
+
+                    const functionLocalizationsMap = this.generateLocalizationsMap<FunctionLocalization>(`Functions.${namespaceFunctionName}.`, (locale, localization) => ({
+                        ...localization,
+                        documentationURL: `${Generator.DOCUMENTATION_BASE_URL}${locale === this.defaultLocale ? "" : `${locale}/`}${Generator.DOCUMENTATION_PATH}${namespace === undefined ? "" : `${namespace}/`}${localization.name}.html`
+                    }));
+
+                    this._functionLocalizationsMapsMap.set(namespaceFunctionName, functionLocalizationsMap);
+
+                    this.createProxyFunction({
+                        ...proxyObjectDescriptor,
+                        functionName,
+                        namespaceFunctionName,
+                        localizationsMap: functionLocalizationsMap,
+                        proxyParameterDescriptors: methodDescriptor.parameterDescriptors.map((parameterDescriptor) => {
+                            const expandedParameterDescriptor = expandParameterDescriptor(parameterDescriptor);
+
+                            const parameterName = expandedParameterDescriptor.name;
+
+                            const parameterLocalizationsMap = this.generateLocalizationsMap(`Parameters.${parameterName}.`, (_locale, localization) => localization);
+
+                            this._parameterLocalizationsMapsMap.set(`${namespaceFunctionName}.${parameterName}`, parameterLocalizationsMap);
+
+                            return {
+                                namespace,
+                                parameterName,
+                                localizationsMap: parameterLocalizationsMap,
+                                parameterDescriptor: expandedParameterDescriptor
+                            };
+                        }),
+                        methodDescriptor
+                    });
+                }
+            }
+
+            success = true;
+        } finally {
+            await this.finalize(success);
+        }
+    }
+}

package/src/generator/index.ts

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

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

@@ -0,0 +1,358 @@
+import type { LocaleStrings } 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";
+
+/**
+ * Parameters sequencer entry.
+ */
+interface ParametersSequencerEntry {
+    /**
+     * Parameters sequence or null if automatic.
+     */
+    parametersSequencerOrNull: ParametersSequencer | null;
+
+    /**
+     * Parameter descriptor.
+     */
+    parameterDescriptor: ParameterDescriptor;
+
+    /**
+     * True if parameter is actually used and not just a base.
+     */
+    isUsed: boolean;
+}
+
+/**
+ * Parameters sequencer for keeping similar (extended) parameters together.
+ */
+type ParametersSequencer = Record<string, ParametersSequencerEntry>;
+
+/**
+ * Format of locale strings module.
+ */
+interface LocaleStringsModule {
+    /**
+     * Locale strings.
+     */
+    localeStrings: LocaleStrings;
+}
+
+/**
+ * Locale strings generator.
+ */
+class LocaleStringsGenerator extends Generator {
+    /**
+     * Locale strings import path.
+     */
+    private static readonly IMPORT_PATH = "../app-extension/src/locale";
+
+    /**
+     * Parameters sequencer.
+     */
+    private readonly _parametersSequencer: ParametersSequencer = {};
+
+    /**
+     * Parameters locale strings.
+     */
+    private readonly _parametersLocaleStrings: LocaleStrings = {};
+
+    /**
+     * Functions locale strings.
+     */
+    private readonly _functionsLocaleStrings: LocaleStrings = {};
+
+    /**
+     * Locale strings.
+     */
+    private readonly _localeStrings: LocaleStrings = {
+        Parameters: this._parametersLocaleStrings,
+        Functions: this._functionsLocaleStrings
+    };
+
+    /**
+     * Constructor.
+     */
+    constructor() {
+        super(false);
+    }
+
+    /**
+     * @inheritDoc
+     */
+    protected initialize(): void {
+    }
+
+    /**
+     * @inheritDoc
+     */
+    protected createProxyObject(): void {
+    }
+
+    /**
+     * Save a parameter descriptor in the appropriate spot in the sequence.
+     *
+     * @param parameterDescriptor
+     * Parameter descriptor.
+     *
+     * @param isUsed
+     * True if parameter descriptor is actually used and not just a base.
+     *
+     * @returns
+     * Parameters sequencer entry.
+     */
+    private saveParameterSequence(parameterDescriptor: ParameterDescriptor, isUsed: boolean): ParametersSequencerEntry {
+        let parametersSequencerEntry: ParametersSequencerEntry;
+
+        if (!("extendsDescriptor" in parameterDescriptor)) {
+            const parameterName = parameterDescriptor.name;
+
+            // Create entry if it doesn't exist, otherwise pick up where last call left off.
+            if (!(parameterName in this._parametersSequencer)) {
+                parametersSequencerEntry = {
+                    parametersSequencerOrNull: null,
+                    parameterDescriptor,
+                    isUsed
+                };
+
+                this._parametersSequencer[parameterName] = parametersSequencerEntry;
+            } else {
+                parametersSequencerEntry = this._parametersSequencer[parameterName];
+            }
+        } else {
+            const baseParametersSequencerEntry = this.saveParameterSequence(parameterDescriptor.extendsDescriptor, false);
+
+            const expandedParameterDescriptor = expandParameterDescriptor(parameterDescriptor);
+            const parameterName = expandedParameterDescriptor.name;
+
+            if (parameterName !== expandParameterDescriptor(parameterDescriptor.extendsDescriptor).name) {
+                // Make sure that base parameters sequencer entry refers to a record type.
+                baseParametersSequencerEntry.parametersSequencerOrNull ??= {};
+
+                if (!(parameterName in baseParametersSequencerEntry.parametersSequencerOrNull)) {
+                    parametersSequencerEntry = {
+                        parametersSequencerOrNull: null,
+                        parameterDescriptor,
+                        isUsed
+                    };
+
+                    baseParametersSequencerEntry.parametersSequencerOrNull[parameterName] = parametersSequencerEntry;
+                } else {
+                    parametersSequencerEntry = baseParametersSequencerEntry.parametersSequencerOrNull[parameterName];
+                }
+            } else {
+                // If name is the same, which means that parameter descriptor modified type information only.
+                parametersSequencerEntry = baseParametersSequencerEntry;
+            }
+        }
+
+        return parametersSequencerEntry;
+    }
+
+    /**
+     * @inheritDoc
+     */
+    protected createProxyFunction(proxyFunctionDescriptor: ProxyFunctionDescriptor): void {
+        const {
+            namespace,
+            functionName,
+            methodDescriptor
+        } = proxyFunctionDescriptor;
+
+        // Add any parameters that are not already known.
+        for (const parameterDescriptor of methodDescriptor.parameterDescriptors) {
+            this.saveParameterSequence(parameterDescriptor, true);
+        }
+
+        let functionsLocaleStrings = this._functionsLocaleStrings;
+
+        if (namespace !== undefined) {
+            if (!(namespace in functionsLocaleStrings)) {
+                const namespaceFunctionsLocaleStrings: LocaleStrings = {};
+
+                // Add namespace and navigate to it.
+                functionsLocaleStrings[namespace] = namespaceFunctionsLocaleStrings;
+                functionsLocaleStrings = namespaceFunctionsLocaleStrings;
+            } else {
+                // Navigate to namespace.
+                // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Entry is never a string.
+                functionsLocaleStrings = functionsLocaleStrings[namespace] as LocaleStrings;
+            }
+        }
+
+        if (functionName in functionsLocaleStrings) {
+            throw new Error(`Duplicate function "${functionName}"`);
+        }
+
+        // Add function.
+        functionsLocaleStrings[functionName] = {
+            name: functionName,
+            description: "*** LOCALIZATION REQUIRED ***"
+        };
+    }
+
+    /**
+     * Merge source locale strings into existing destination locale strings.
+     *
+     * @param logChanges
+     * If true, changes are logged. Limits output when processing multiple sources.
+     *
+     * @param parentKey
+     * Parent key for logging purposes.
+     *
+     * @param sourceLocaleStrings
+     * Source locale strings.
+     *
+     * @param destinationLocaleStrings
+     * Destination locale strings.
+     *
+     * @param addMissing
+     * Add missing if true; applies to locale strings that are not regional.
+     *
+     * @returns
+     * Merged locale strings.
+     */
+    private static merge(logChanges: boolean, parentKey: string, sourceLocaleStrings: LocaleStrings, destinationLocaleStrings: LocaleStrings, addMissing: boolean): LocaleStrings {
+        // Some entries at the top are not part of the generator output.
+        const deleteMissing = parentKey.length !== 0;
+
+        const newDestinationLocaleStrings: LocaleStrings = {};
+
+        // Copy over or delete any destination keys that are not in source.
+        for (const [key, destinationValue] of Object.entries(destinationLocaleStrings)) {
+            if (!(key in sourceLocaleStrings)) {
+                if (!deleteMissing) {
+                    newDestinationLocaleStrings[key] = destinationValue;
+                } else if (logChanges) {
+                    logger.info(`Deleting ${parentKey}${key}...`);
+                }
+            }
+        }
+
+        for (const [key, sourceValue] of Object.entries(sourceLocaleStrings)) {
+            if (!(key in destinationLocaleStrings)) {
+                if (addMissing) {
+                    if (logChanges) {
+                        logger.info(`Adding ${parentKey}${key}...`);
+                    }
+
+                    newDestinationLocaleStrings[key] = sourceValue;
+                }
+            } else {
+                const destinationValue = destinationLocaleStrings[key];
+
+                if (typeof sourceValue === "object" && typeof destinationValue === "object") {
+                    newDestinationLocaleStrings[key] = LocaleStringsGenerator.merge(logChanges, `${parentKey}${key}.`, sourceValue, destinationValue, addMissing);
+                } else if (typeof sourceValue === "string" && typeof destinationValue === "string") {
+                    newDestinationLocaleStrings[key] = destinationValue;
+                } else {
+                    throw new Error(`Mismatched types at ${parentKey}${key}`);
+                }
+            }
+        }
+
+        return newDestinationLocaleStrings;
+    }
+
+    /**
+     * Build parameters locale strings by going through parameters sequencer.
+     *
+     * @param parametersSequencer
+     * Parameters sequencer.
+     */
+    private buildParametersLocaleStrings(parametersSequencer: ParametersSequencer): void {
+        const entries = Object.entries(parametersSequencer);
+
+        // Sort the entries as defined by the descriptors.
+        entries.sort((entry1, entry2) => {
+            let result: number;
+
+            const parameterDescriptor1 = entry1[1].parameterDescriptor;
+            const parameterDescriptor2 = entry2[1].parameterDescriptor;
+
+            if ("sortOrder" in parameterDescriptor1) {
+                if ("sortOrder" in parameterDescriptor2) {
+                    result = parameterDescriptor1.sortOrder - parameterDescriptor2.sortOrder;
+                } else {
+                    // Parameter descriptors with undefined sort order to go the end.
+                    result = -parameterDescriptor1.sortOrder;
+                }
+            } else {
+                // eslint-disable-next-line no-lonely-if -- Matches structure in "then" clause.
+                if ("sortOrder" in parameterDescriptor2) {
+                    // Parameter descriptors with undefined sort order to go the end.
+                    result = parameterDescriptor2.sortOrder;
+                } else {
+                    result = 0;
+                }
+            }
+
+            return result;
+        });
+
+        for (const [parameterName, parametersSequencerEntry] of entries) {
+            if (parametersSequencerEntry.isUsed) {
+                this._parametersLocaleStrings[parameterName] = {
+                    name: parameterName,
+                    description: ""
+                };
+            }
+
+            if (parametersSequencerEntry.parametersSequencerOrNull !== null) {
+                this.buildParametersLocaleStrings(parametersSequencerEntry.parametersSequencerOrNull);
+            }
+        }
+    }
+
+    /**
+     * Build output to be written back to source file.
+     *
+     * @param prefix
+     * Line prefix.
+     *
+     * @param value
+     * Line value.
+     *
+     * @param indentLevel
+     * Indent level.
+     *
+     * @returns
+     * Output string.
+     */
+    private static buildOutput(prefix: string, value: LocaleStrings | string, indentLevel: number): string {
+        return `${"    ".repeat(indentLevel)}${prefix} ${typeof value === "object" ?
+            `{\n${
+                Object.entries(value).map(entry => LocaleStringsGenerator.buildOutput(`${entry[0]}:`, entry[1], indentLevel + 1)).join(",\n")
+            }\n${"    ".repeat(indentLevel)}}` :
+            // JSON.stringify() will apply quotes as appropriate.
+            JSON.stringify(value)
+        }`;
+    }
+
+    /**
+     * @inheritDoc
+     */
+    protected async finalize(success: boolean): Promise<void> {
+        if (success) {
+            this.buildParametersLocaleStrings(this._parametersSequencer);
+
+            await Promise.all(fs.readdirSync(LocaleStringsGenerator.IMPORT_PATH, {
+                withFileTypes: true
+            }).filter(entry => entry.isDirectory()).map(async (entry) => {
+                const localeStringsSource = path.resolve(LocaleStringsGenerator.IMPORT_PATH, entry.name, "locale-strings.ts");
+
+                await import(localeStringsSource).then((module) => {
+                    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Module format is known.
+                    const localeStrings = LocaleStringsGenerator.merge(entry.name === "en", "", this._localeStrings, (module as LocaleStringsModule).localeStrings, !entry.name.includes("-"));
+
+                    fs.writeFileSync(localeStringsSource, `${LocaleStringsGenerator.buildOutput("export const localeStrings =", localeStrings, 0)};\n`);
+                });
+            }));
+        }
+    }
+}
+
+await new LocaleStringsGenerator().generate();

package/src/generator/logger.ts

@@ -0,0 +1,34 @@
+import { Logger } from "tslog";
+
+/**
+ * Log level.
+ */
+enum LogLevel {
+    Silly, Trace, Debug, Info, Warn, Error, Fatal
+}
+
+/**
+ * Logger with a default minimum level of Info.
+ */
+export const logger = new Logger({
+    minLevel: LogLevel.Info
+});
+
+/**
+ * Set the log level.
+ *
+ * @param logLevel
+ * Log level as enumeration value or string.
+ */
+export function setLogLevel(logLevel: LogLevel | string): void {
+    if (typeof logLevel === "string") {
+        if (logLevel in LogLevel) {
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- String exists as a key.
+            logger.settings.minLevel = LogLevel[logLevel as keyof typeof LogLevel];
+        } else {
+            logger.error(`Unknown log level ${logLevel}`);
+        }
+    } else {
+        logger.settings.minLevel = logLevel;
+    }
+}

package/src/index.ts

@@ -22,3 +22,4 @@ 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";