@aidc-toolkit/app-extension 1.0.46 → 1.0.47-beta

package/dist/generator/generator.js

@@ -0,0 +1,190 @@
+import { ALPHA_URL, getLogger, I18nEnvironments, websiteURL } from "@aidc-toolkit/core";
+import { AppHelperProxy } from "../app-helper-proxy.js";
+import * as GS1 from "../gs1/index.js";
+import { appExtensionResourceBundle, i18nAppExtensionInit, i18nextAppExtension } from "../locale/i18n.js";
+import { proxy } from "../proxy.js";
+import * as Utility from "../utility/index.js";
+/**
+ * Dummy method to force proxies to register their decorators.
+ *
+ * @param _proxies
+ * Proxies.
+ */
+function registerProxies(..._proxies) {
+}
+registerProxies(AppHelperProxy, Utility, GS1);
+/**
+ * Abstract generator.
+ */
+export class Generator {
+    /**
+     * Documentation path, optionally preceded by locale.
+     */
+    static #DOCUMENTATION_PATH = "app-extension/";
+    /**
+     * Logger.
+     */
+    #logger = getLogger();
+    /**
+     * Package version.
+     */
+    #version;
+    /**
+     * Locales.
+     */
+    #locales;
+    /**
+     * Default locale.
+     */
+    #defaultLocale;
+    /**
+     * Constructor.
+     *
+     * @param version
+     * Package version.
+     *
+     * @param includeLocalizations
+     * Include localizations if true.
+     */
+    constructor(version, includeLocalizations = true) {
+        this.#version = version;
+        this.#locales = includeLocalizations ? Object.keys(appExtensionResourceBundle) : [];
+        this.#defaultLocale = this.#locales[0] ?? "";
+    }
+    /**
+     * Get the logger.
+     */
+    get logger() {
+        return this.#logger;
+    }
+    /**
+     * Get the package version.
+     */
+    get version() {
+        return this.#version;
+    }
+    /**
+     * Get the locales.
+     */
+    get locales() {
+        return this.#locales;
+    }
+    /**
+     * Get the default locale.
+     */
+    get defaultLocale() {
+        return this.#defaultLocale;
+    }
+    /**
+     * Generate a localization.
+     *
+     * @template TLocalization
+     * Localization type.
+     *
+     * @param locale
+     * Locale.
+     *
+     * @param key
+     * Key.
+     *
+     * @param localizationCallback
+     * Callback to finalize localization.
+     *
+     * @returns
+     * Localization.
+     */
+    static #generateLocalization(locale, key, localizationCallback) {
+        const lngReturnObjectsOption = {
+            lng: locale,
+            returnObjects: true
+        };
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Localized key exists and return type is Localization.
+        return localizationCallback(locale, i18nextAppExtension.t(key, lngReturnObjectsOption));
+    }
+    /**
+     * Generate by processing individual imports.
+     */
+    async generate() {
+        let success = false;
+        await i18nAppExtensionInit(I18nEnvironments.CLI);
+        const documentationBaseURL = websiteURL(this.version, true, await ALPHA_URL);
+        await this.initialize();
+        const namespaceHierarchy = new Map();
+        // Organize class descriptors by namespace and category.
+        for (const classDescriptor of proxy.classDescriptors) {
+            const namespace = classDescriptor.namespace;
+            const category = classDescriptor.category;
+            let categoryHierarchy = namespaceHierarchy.get(namespace);
+            if (categoryHierarchy === undefined) {
+                categoryHierarchy = new Map();
+                namespaceHierarchy.set(namespace, categoryHierarchy);
+            }
+            let classDescriptors = categoryHierarchy.get(category);
+            if (classDescriptors === undefined) {
+                classDescriptors = [];
+                categoryHierarchy.set(category, classDescriptors);
+            }
+            classDescriptors.push(classDescriptor);
+        }
+        try {
+            for (const [namespace, categoryHierarchy] of namespaceHierarchy) {
+                const namespacePrefix = namespace === undefined ? "" : `${namespace}.`;
+                const namespacePath = namespace === undefined ? "" : `${namespace}/`;
+                this.createNamespace(namespace);
+                for (const [category, classDescriptors] of categoryHierarchy) {
+                    const namespaceCategory = `${namespacePrefix}${category}`;
+                    const categoriesKey = `Categories.${category}`;
+                    const namespaceCategoriesKey = `Categories.${namespaceCategory}`;
+                    const categoryLocalizationsMap = new Map(this.locales.map((locale) => {
+                        const lngOption = {
+                            lng: locale
+                        };
+                        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Localized key exists.
+                        return [locale, i18nextAppExtension.t((i18nextAppExtension.exists(namespaceCategoriesKey, lngOption) ? namespaceCategoriesKey : categoriesKey), lngOption)];
+                    }));
+                    this.createCategory(namespace, category, categoryLocalizationsMap);
+                    const namespaceClassNamesSet = new Set();
+                    for (const classDescriptor of classDescriptors) {
+                        const namespaceClassName = classDescriptor.namespaceClassName;
+                        if (namespaceClassNamesSet.has(namespaceClassName)) {
+                            throw new Error(`Duplicate class ${namespaceClassName}`);
+                        }
+                        namespaceClassNamesSet.add(namespaceClassName);
+                        // 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 objectNameGroups = /^(?<namespaceFirstWord>[A-Z]+[0-9]*|[A-Z][^A-Z.]*)(?<namespaceRemaining>[A-Z][^.]*|)\.?(?<className>[A-Z].*|)$/u.exec(namespaceClassName)?.groups;
+                        if (objectNameGroups === undefined) {
+                            throw new Error(`${namespaceClassName} is not a valid namespace-qualified class name`);
+                        }
+                        this.createProxyObject(`${objectNameGroups["namespaceFirstWord"].toLowerCase()}${objectNameGroups["namespaceRemaining"]}${objectNameGroups["className"]}`, classDescriptor);
+                        for (const methodDescriptor of classDescriptor.methodDescriptors) {
+                            const functionLocalizationsMap = new Map(this.locales.map(locale => [locale, Generator.#generateLocalization(locale, `Functions.${methodDescriptor.namespaceFunctionName}`, (locale, localization) => ({
+                                    ...localization,
+                                    namespaceFunctionName: `${namespacePrefix}${localization.name}`,
+                                    documentationURL: `${documentationBaseURL}/${locale === this.defaultLocale ? "" : `${locale}/`}${Generator.#DOCUMENTATION_PATH}${namespacePath}${localization.name}.html`,
+                                    parametersMap: new Map(methodDescriptor.parameterDescriptors.map(parameterDescriptor => 
+                                    // eslint-disable-next-line max-nested-callbacks -- Callback is empty.
+                                    [parameterDescriptor.name, Generator.#generateLocalization(locale, `Parameters.${parameterDescriptor.name}`, (_locale, localization) => localization)]))
+                                }))]));
+                            this.createProxyFunction(classDescriptor, methodDescriptor, functionLocalizationsMap);
+                        }
+                    }
+                }
+            }
+            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

@@ -1,126 +1,18 @@
-import { Promisable } from '@aidc-toolkit/core';
-import { Logger } from 'tslog';
-import { C as ClassDescriptor, e as MethodDescriptor } from '../descriptor-FJHoLlYK.js';
-
-/**
- * Localization.
+/*!
+ * Copyright © 2024-2026 Dolphin Data Development Ltd. and AIDC Toolkit
+ * contributors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
-interface Localization {
-    /**
-     * Name.
-     */
-    readonly name: string;
-    /**
-     * Description.
-     */
-    readonly description: string;
-}
-/**
- * Function localization.
- */
-interface FunctionLocalization extends Localization {
-    /**
-     * Namespace function name.
-     */
-    readonly namespaceFunctionName: string;
-    /**
-     * Documentation URL.
-     */
-    readonly documentationURL: string;
-    /**
-     * Parameters map.
-     */
-    readonly parametersMap: ReadonlyMap<string, Localization>;
-}
-/**
- * Abstract generator.
- */
-declare abstract class Generator {
-    #private;
-    /**
-     * Constructor.
-     *
-     * @param version
-     * Package version.
-     *
-     * @param includeLocalizations
-     * Include localizations if true.
-     */
-    constructor(version: string, includeLocalizations?: boolean);
-    /**
-     * Get the logger.
-     */
-    get logger(): Logger<object>;
-    /**
-     * Get the package version.
-     */
-    get version(): string;
-    /**
-     * Get the locales.
-     */
-    protected get locales(): readonly string[];
-    /**
-     * Get the default locale.
-     */
-    protected get defaultLocale(): string;
-    /**
-     * Initialize the generation of the output.
-     */
-    protected abstract initialize(): Promisable<void>;
-    /**
-     * Create a namespace.
-     *
-     * @param namespace
-     * Namespace.
-     */
-    protected abstract createNamespace(namespace: string | undefined): void;
-    /**
-     * Create a category.
-     *
-     * @param namespace
-     * Namespace.
-     *
-     * @param category
-     * Category.
-     *
-     * @param categoryLocalizationsMap
-     * Category localizations map.
-     */
-    protected abstract createCategory(namespace: string | undefined, category: string, categoryLocalizationsMap: ReadonlyMap<string, string>): void;
-    /**
-     * Create a proxy object for a class.
-     *
-     * @param objectName
-     * Object name, derived from namespace and class name.
-     *
-     * @param classDescriptor
-     * Class descriptor.
-     */
-    protected abstract createProxyObject(objectName: string, classDescriptor: ClassDescriptor): void;
-    /**
-     * Create a proxy function for a class and method.
-     *
-     * @param classDescriptor
-     * Class descriptor.
-     *
-     * @param methodDescriptor
-     * Method descriptor.
-     *
-     * @param functionLocalizationsMap
-     * Function localizations map.
-     */
-    protected abstract createProxyFunction(classDescriptor: ClassDescriptor, methodDescriptor: MethodDescriptor, functionLocalizationsMap: ReadonlyMap<string, FunctionLocalization>): void;
-    /**
-     * Finalize the generation of the output.
-     *
-     * @param success
-     * True if successful.
-     */
-    protected abstract finalize(success: boolean): Promisable<void>;
-    /**
-     * Generate by processing individual imports.
-     */
-    generate(): Promise<void>;
-}
-
-export { type FunctionLocalization, Generator, type Localization };
+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;;;;;;;;;;;;;;;GAeG;AAEH,cAAc,gBAAgB,CAAC"}

package/dist/generator/index.js

@@ -1,4 +1,3 @@
-import{b as $,c as d,d as b,h as z,i as D,r as M,s as P}from"../chunk-FAD3UX6B.js";import{ALPHA_URL as O,getLogger as j,I18nEnvironments as E,websiteURL as U}from"@aidc-toolkit/core";function H(...p){}H(D,M,P);var w=class p{static#o="app-extension/";#n=j();#t;#e;#a;constructor(s,r=!0){this.#t=s,this.#e=r?Object.keys($):[],this.#a=this.#e[0]??""}get logger(){return this.#n}get version(){return this.#t}get locales(){return this.#e}get defaultLocale(){return this.#a}static#s(s,r,i){let e={lng:s,returnObjects:!0};return i(s,d.t(r,e))}async generate(){let s=!1;await b(E.CLI);let r=U(this.version,!0,await O);await this.initialize();let i=new Map;for(let e of z.classDescriptors){let l=e.namespace,c=e.category,o=i.get(l);o===void 0&&(o=new Map,i.set(l,o));let t=o.get(c);t===void 0&&(t=[],o.set(c,t)),t.push(e)}try{for(let[e,l]of i){let c=e===void 0?"":`${e}.`,o=e===void 0?"":`${e}/`;this.createNamespace(e);for(let[t,C]of l){let N=`${c}${t}`,v=`Categories.${t}`,f=`Categories.${N}`,R=new Map(this.locales.map(n=>{let a={lng:n};return[n,d.t(d.exists(f,a)?f:v,a)]}));this.createCategory(e,t,R);let h=new Set;for(let n of C){let a=n.namespaceClassName;if(h.has(a))throw new Error(`Duplicate class ${a}`);h.add(a);let m=/^(?<namespaceFirstWord>[A-Z]+[0-9]*|[A-Z][^A-Z.]*)(?<namespaceRemaining>[A-Z][^.]*|)\.?(?<className>[A-Z].*|)$/u.exec(a)?.groups;if(m===void 0)throw new Error(`${a} is not a valid namespace-qualified class name`);this.createProxyObject(`${m.namespaceFirstWord.toLowerCase()}${m.namespaceRemaining}${m.className}`,n);for(let g of n.methodDescriptors){let A=new Map(this.locales.map(L=>[L,p.#s(L,`Functions.${g.namespaceFunctionName}`,(u,y)=>({...y,namespaceFunctionName:`${c}${y.name}`,documentationURL:`${r}/${u===this.defaultLocale?"":`${u}/`}${p.#o}${o}${y.name}.html`,parametersMap:new Map(g.parameterDescriptors.map(x=>[x.name,p.#s(u,`Parameters.${x.name}`,(T,F)=>F)]))}))]));this.createProxyFunction(n,g,A)}}}}s=!0}finally{await this.finalize(s)}}};export{w as Generator};
 /*!
  * Copyright © 2024-2026 Dolphin Data Development Ltd. and AIDC Toolkit
  * contributors
@@ -15,3 +14,5 @@ import{b as $,c as d,d as b,h as z,i as D,r as M,s as P}from"../chunk-FAD3UX6B.j
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+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":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,cAAc,gBAAgB,CAAC"}

package/dist/generator/locale-resources-generator.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=locale-resources-generator.d.ts.map

package/dist/generator/locale-resources-generator.d.ts.map

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

package/dist/generator/locale-resources-generator.js

@@ -0,0 +1,312 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import packageConfiguration from "../../package.json" with { type: "json" };
+import { Generator } from "./generator.js";
+/**
+ * Locale resources generator.
+ */
+class LocaleResourcesGenerator extends Generator {
+    /**
+     * Locale resources import path.
+     */
+    static #IMPORT_PATH = "../app-extension/src/locale";
+    /**
+     * Parameters sequencer.
+     */
+    #parametersSequencer = {};
+    /**
+     * Parameters locale resources.
+     */
+    #parametersLocaleResources = {};
+    /**
+     * Functions locale resources.
+     */
+    #functionsLocaleResources = {};
+    /**
+     * Locale resources.
+     */
+    #LocaleResources = {
+        Parameters: this.#parametersLocaleResources,
+        Functions: this.#functionsLocaleResources
+    };
+    /**
+     * Constructor.
+     */
+    constructor() {
+        super(packageConfiguration.version, false);
+    }
+    /**
+     * @inheritDoc
+     */
+    initialize() {
+    }
+    /**
+     * @inheritDoc
+     */
+    createNamespace() {
+    }
+    /**
+     * @inheritDoc
+     */
+    createCategory() {
+    }
+    /**
+     * @inheritDoc
+     */
+    createProxyObject() {
+    }
+    /**
+     * 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.
+     */
+    #saveParameterSequence(parameterDescriptor, isUsed) {
+        let 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,
+                    parameterName,
+                    baseParameterName: parameterName,
+                    isUsed
+                };
+                this.#parametersSequencer[parameterName] = parametersSequencerEntry;
+            }
+            else {
+                parametersSequencerEntry = this.#parametersSequencer[parameterName];
+            }
+        }
+        else {
+            const baseParametersSequencerEntry = this.#saveParameterSequence(parameterDescriptor.extendsDescriptor, false);
+            let parameterName;
+            let baseParameterName;
+            if (parameterDescriptor.name !== undefined) {
+                parameterName = parameterDescriptor.name;
+                baseParameterName = baseParametersSequencerEntry.parameterName;
+            }
+            else {
+                parameterName = baseParametersSequencerEntry.parameterName;
+                baseParameterName = baseParametersSequencerEntry.baseParameterName;
+            }
+            if (parameterName !== baseParameterName) {
+                // Make sure that base parameters sequencer entry refers to a record type.
+                baseParametersSequencerEntry.parametersSequencerOrNull ??= {};
+                if (!(parameterName in baseParametersSequencerEntry.parametersSequencerOrNull)) {
+                    parametersSequencerEntry = {
+                        parametersSequencerOrNull: null,
+                        parameterDescriptor,
+                        parameterName,
+                        baseParameterName,
+                        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
+     */
+    createProxyFunction(classDescriptor, methodDescriptor) {
+        // Hidden functions aren't localized.
+        if (methodDescriptor.isHidden !== true) {
+            // Add any parameters that are not already known.
+            for (const parameterDescriptor of methodDescriptor.parameterDescriptors) {
+                this.#saveParameterSequence(parameterDescriptor, true);
+            }
+            let functionsLocaleResources = this.#functionsLocaleResources;
+            const namespace = classDescriptor.namespace;
+            if (namespace !== undefined) {
+                if (!(namespace in functionsLocaleResources)) {
+                    const namespaceFunctionsLocaleResources = {};
+                    // Add namespace and navigate to it.
+                    functionsLocaleResources[namespace] = namespaceFunctionsLocaleResources;
+                    functionsLocaleResources = namespaceFunctionsLocaleResources;
+                }
+                else {
+                    // Navigate to namespace.
+                    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Entry is never a string.
+                    functionsLocaleResources = functionsLocaleResources[namespace];
+                }
+            }
+            const functionName = methodDescriptor.functionName;
+            if (functionName in functionsLocaleResources) {
+                throw new Error(`Duplicate function ${functionName}`);
+            }
+            // Add function.
+            functionsLocaleResources[functionName] = {
+                name: functionName,
+                description: "*** LOCALIZATION REQUIRED ***"
+            };
+        }
+    }
+    /**
+     * Merge source locale resources into existing destination locale resources.
+     *
+     * @param logChanges
+     * If true, changes are logged. Limits output when processing multiple sources.
+     *
+     * @param parentKey
+     * Parent key for logging purposes.
+     *
+     * @param sourceLocaleResources
+     * Source locale resources.
+     *
+     * @param destinationLocaleResources
+     * Destination locale resources.
+     *
+     * @param addMissing
+     * Add missing if true; applies to locale resources that are not regional.
+     *
+     * @returns
+     * Merged locale resources.
+     */
+    #merge(logChanges, parentKey, sourceLocaleResources, destinationLocaleResources, addMissing) {
+        // Some entries at the top are not part of the generator output.
+        const deleteMissing = parentKey.length !== 0;
+        const newDestinationLocaleResources = {};
+        // Copy over or delete any destination keys that are not in source.
+        for (const [key, destinationValue] of Object.entries(destinationLocaleResources)) {
+            if (!(key in sourceLocaleResources)) {
+                if (!deleteMissing) {
+                    newDestinationLocaleResources[key] = destinationValue;
+                }
+                else if (logChanges) {
+                    this.logger.info(`Deleting ${parentKey}${key}...`);
+                }
+            }
+        }
+        for (const [key, sourceValue] of Object.entries(sourceLocaleResources)) {
+            if (!(key in destinationLocaleResources)) {
+                if (addMissing) {
+                    if (logChanges) {
+                        this.logger.info(`Adding ${parentKey}${key}...`);
+                    }
+                    newDestinationLocaleResources[key] = sourceValue;
+                }
+            }
+            else {
+                const destinationValue = destinationLocaleResources[key];
+                if (typeof sourceValue === "object" && typeof destinationValue === "object") {
+                    newDestinationLocaleResources[key] = this.#merge(logChanges, `${parentKey}${key}.`, sourceValue, destinationValue, addMissing);
+                }
+                else if (typeof sourceValue === "string" && typeof destinationValue === "string") {
+                    newDestinationLocaleResources[key] = destinationValue;
+                }
+                else {
+                    throw new Error(`Mismatched types at ${parentKey}${key}`);
+                }
+            }
+        }
+        return newDestinationLocaleResources;
+    }
+    /**
+     * Build parameters locale resources by going through parameters sequencer.
+     *
+     * @param parametersSequencer
+     * Parameters sequencer.
+     */
+    #buildParametersLocaleResources(parametersSequencer) {
+        const entries = Object.entries(parametersSequencer);
+        // Sort the entries as defined by the descriptors.
+        entries.sort((entry1, entry2) => {
+            let result;
+            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.#parametersLocaleResources[parameterName] = {
+                    name: parameterName,
+                    description: "*** LOCALIZATION REQUIRED ***"
+                };
+            }
+            if (parametersSequencerEntry.parametersSequencerOrNull !== null) {
+                this.#buildParametersLocaleResources(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.
+     */
+    static #buildOutput(prefix, value, indentLevel) {
+        return `${"    ".repeat(indentLevel)}${prefix} ${typeof value === "object" ?
+            `{\n${Object.entries(value).map(entry => LocaleResourcesGenerator.#buildOutput(`${entry[0]}:`, entry[1], indentLevel + 1)).join(",\n")}\n${"    ".repeat(indentLevel)}}` :
+            // JSON.stringify() will apply quotes as appropriate.
+            JSON.stringify(value)}`;
+    }
+    /**
+     * @inheritDoc
+     */
+    async finalize(success) {
+        if (success) {
+            this.#buildParametersLocaleResources(this.#parametersSequencer);
+            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");
+                return 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.default, !entry.name.includes("-"));
+                    fs.writeFileSync(localeResourcesSource, `${LocaleResourcesGenerator.#buildOutput("export default", localeResources, 0)};\n`);
+                });
+            }));
+        }
+    }
+}
+const generator = new LocaleResourcesGenerator();
+generator.generate().catch((e) => {
+    generator.logger.error(e);
+    process.exit(1);
+});
+//# sourceMappingURL=locale-resources-generator.js.map