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

package/dist/generator/generator.js

@@ -0,0 +1,198 @@
+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 -- Assume localized key exists.
+        const parseKey = key;
+        if (!i18nextAppExtension.exists(parseKey, lngReturnObjectsOption)) {
+            throw new Error(`Missing localization for ${key} in ${locale}`);
+        }
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Localized key exists and return type is Localization & Partial<TLocalization>.
+        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 = `${namespacePrefix}${classDescriptor.name}`;
+                        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(methodDescriptor.isHidden !== true ?
+                                this.locales.map(locale => [locale, Generator.#generateLocalization(locale, `Functions.${namespacePrefix}${methodDescriptor.functionName}`, (locale, localization) => ({
+                                        ...localization,
+                                        titleCaseName: localization.titleCaseName ?? `${localization.name.substring(0, 1).toUpperCase()}${localization.name.substring(1)}`,
+                                        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)]))
+                                    }))]) :
+                                // Hidden methods are not localized.
+                                []);
+                            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":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,gBAAgB,EAAmB,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGzG,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,OAAO,KAAK,GAAG,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,0BAA0B,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC1G,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,OAAO,MAAM,qBAAqB,CAAC;AAE/C;;;;;GAKG;AACH,SAAS,eAAe,CAAC,GAAG,QAAmB;AAC/C,CAAC;AAED,eAAe,CAAC,cAAc,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;AAqC9C;;GAEG;AACH,MAAM,OAAgB,SAAS;IAC3B;;OAEG;IACH,MAAM,CAAU,mBAAmB,GAAG,gBAAgB,CAAC;IAEvD;;OAEG;IACM,OAAO,GAAG,SAAS,EAAE,CAAC;IAE/B;;OAEG;IACM,QAAQ,CAAS;IAE1B;;OAEG;IACM,QAAQ,CAAoB;IAErC;;OAEG;IACM,cAAc,CAAS;IAEhC;;;;;;;;OAQG;IACH,YAAY,OAAe,EAAE,oBAAoB,GAAG,IAAI;QACpD,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QAExB,IAAI,CAAC,QAAQ,GAAG,oBAAoB,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACpF,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACjD,CAAC;IAED;;OAEG;IACH,IAAI,MAAM;QACN,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,IAAI,OAAO;QACP,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,IAAc,OAAO;QACjB,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,IAAc,aAAa;QACvB,OAAO,IAAI,CAAC,cAAc,CAAC;IAC/B,CAAC;IA8DD;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,qBAAqB,CAAqC,MAAc,EAAE,GAAW,EAAE,oBAA4G;QACtM,MAAM,sBAAsB,GAAG;YAC3B,GAAG,EAAE,MAAM;YACX,aAAa,EAAE,IAAI;SACb,CAAC;QAEX,uGAAuG;QACvG,MAAM,QAAQ,GAAG,GAAiE,CAAC;QAEnF,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,QAAQ,EAAE,sBAAsB,CAAC,EAAE,CAAC;YAChE,MAAM,IAAI,KAAK,CAAC,4BAA4B,GAAG,OAAO,MAAM,EAAE,CAAC,CAAC;QACpE,CAAC;QAED,yJAAyJ;QACzJ,OAAO,oBAAoB,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAiE,EAAE,sBAAsB,CAA0C,CAAC,CAAC;IACnM,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ;QACV,IAAI,OAAO,GAAG,KAAK,CAAC;QAEpB,MAAM,oBAAoB,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;QAEjD,MAAM,oBAAoB,GAAG,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC,CAAC;QAE7E,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QAExB,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAsD,CAAC;QAEzF,wDAAwD;QACxD,KAAK,MAAM,eAAe,IAAI,KAAK,CAAC,gBAAgB,EAAE,CAAC;YACnD,MAAM,SAAS,GAAG,eAAe,CAAC,SAAS,CAAC;YAC5C,MAAM,QAAQ,GAAG,eAAe,CAAC,QAAQ,CAAC;YAE1C,IAAI,iBAAiB,GAAG,kBAAkB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAE1D,IAAI,iBAAiB,KAAK,SAAS,EAAE,CAAC;gBAClC,iBAAiB,GAAG,IAAI,GAAG,EAAE,CAAC;gBAC9B,kBAAkB,CAAC,GAAG,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC;YACzD,CAAC;YAED,IAAI,gBAAgB,GAAG,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAEvD,IAAI,gBAAgB,KAAK,SAAS,EAAE,CAAC;gBACjC,gBAAgB,GAAG,EAAE,CAAC;gBACtB,iBAAiB,CAAC,GAAG,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;YACtD,CAAC;YAED,gBAAgB,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC3C,CAAC;QAED,IAAI,CAAC;YACD,KAAK,MAAM,CAAC,SAAS,EAAE,iBAAiB,CAAC,IAAI,kBAAkB,EAAE,CAAC;gBAC9D,MAAM,eAAe,GAAG,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,SAAS,GAAG,CAAC;gBACvE,MAAM,aAAa,GAAG,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,SAAS,GAAG,CAAC;gBAErE,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;gBAEhC,KAAK,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC,IAAI,iBAAiB,EAAE,CAAC;oBAC3D,MAAM,iBAAiB,GAAG,GAAG,eAAe,GAAG,QAAQ,EAAE,CAAC;oBAE1D,MAAM,aAAa,GAAG,cAAc,QAAQ,EAAE,CAAC;oBAC/C,MAAM,sBAAsB,GAAG,cAAc,iBAAiB,EAAE,CAAC;oBAEjE,MAAM,wBAAwB,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;wBACjE,MAAM,SAAS,GAAG;4BACd,GAAG,EAAE,MAAM;yBACL,CAAC;wBAEX,gGAAgG;wBAChG,OAAO,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,MAAM,CAAC,sBAAsB,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,aAAa,CAAc,EAAE,SAAS,CAAC,CAAC,CAAC;oBAC7K,CAAC,CAAC,CAAC,CAAC;oBAEJ,IAAI,CAAC,cAAc,CAAC,SAAS,EAAE,QAAQ,EAAE,wBAAwB,CAAC,CAAC;oBAEnE,MAAM,sBAAsB,GAAG,IAAI,GAAG,EAAU,CAAC;oBAEjD,KAAK,MAAM,eAAe,IAAI,gBAAgB,EAAE,CAAC;wBAC7C,MAAM,kBAAkB,GAAG,GAAG,eAAe,GAAG,eAAe,CAAC,IAAI,EAAE,CAAC;wBAEvE,IAAI,sBAAsB,CAAC,GAAG,CAAC,kBAAkB,CAAC,EAAE,CAAC;4BACjD,MAAM,IAAI,KAAK,CAAC,mBAAmB,kBAAkB,EAAE,CAAC,CAAC;wBAC7D,CAAC;wBAED,sBAAsB,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;wBAE/C,0BAA0B;wBAC1B,uEAAuE;wBACvE,oGAAoG;wBACpG,EAAE;wBACF,2BAA2B;wBAC3B,kFAAkF;wBAClF,oCAAoC;wBACpC,EAAE;wBACF,yDAAyD;wBACzD,0FAA0F;wBAC1F,oCAAoC;wBACpC,MAAM,gBAAgB,GAAG,iHAAiH,CAAC,IAAI,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;wBAE5K,IAAI,gBAAgB,KAAK,SAAS,EAAE,CAAC;4BACjC,MAAM,IAAI,KAAK,CAAC,GAAG,kBAAkB,gDAAgD,CAAC,CAAC;wBAC3F,CAAC;wBAED,IAAI,CAAC,iBAAiB,CAAC,GAAG,gBAAgB,CAAC,oBAAoB,CAAC,CAAC,WAAW,EAAE,GAAG,gBAAgB,CAAC,oBAAoB,CAAC,GAAG,gBAAgB,CAAC,WAAW,CAAC,EAAE,EAAE,eAAe,CAAC,CAAC;wBAE5K,KAAK,MAAM,gBAAgB,IAAI,eAAe,CAAC,iBAAiB,EAAE,CAAC;4BAC/D,MAAM,wBAAwB,GAAG,IAAI,GAAG,CAAC,gBAAgB,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC;gCACzE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CACtB,CAAC,MAAM,EAAE,SAAS,CAAC,qBAAqB,CAAuB,MAAM,EAAE,aAAa,eAAe,GAAG,gBAAgB,CAAC,YAAY,EAAE,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,CAAC,CAAC;wCAC9J,GAAG,YAAY;wCACf,aAAa,EAAE,YAAY,CAAC,aAAa,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE;wCAClI,gBAAgB,EAAE,GAAG,oBAAoB,IAAI,MAAM,KAAK,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,GAAG,SAAS,CAAC,mBAAmB,GAAG,aAAa,GAAG,YAAY,CAAC,IAAI,OAAO;wCACzK,aAAa,EAAE,IAAI,GAAG,CAAC,gBAAgB,CAAC,oBAAoB,CAAC,GAAG,CAAC,mBAAmB,CAAC,EAAE;wCACnF,sEAAsE;wCACtE,CAAC,mBAAmB,CAAC,IAAI,EAAE,SAAS,CAAC,qBAAqB,CAAC,MAAM,EAAE,cAAc,mBAAmB,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,CACzJ,CAAC;qCACL,CAAC,CAAC,CAAC,CACP,CAAC,CAAC;gCACH,oCAAoC;gCACpC,EAAE,CACL,CAAC;4BAEF,IAAI,CAAC,mBAAmB,CAAC,eAAe,EAAE,gBAAgB,EAAE,wBAAwB,CAAC,CAAC;wBAC1F,CAAC;oBACL,CAAC;gBACL,CAAC;YACL,CAAC;YAED,OAAO,GAAG,IAAI,CAAC;QACnB,CAAC;gBAAS,CAAC;YACP,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACjC,CAAC;IACL,CAAC"}

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":""}