@aidc-toolkit/core 1.0.41 → 1.0.43-beta

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,mBAAmB,WAAW,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AAEjC,cAAc,aAAa,CAAC;AAE5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AAEjC,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iBAAiB,CAAC;AAChC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,YAAY,CAAC;AAE3B,mBAAmB,gBAAgB,CAAC;AAEpC,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -1,5 +1,3 @@
-import{a as W,b as H,c as T,d as z}from"./chunk-FIUBVWNN.js";function x(e,t,...o){return Object.fromEntries(Object.entries(t).filter(([r])=>o.includes(r)!==e))}function K(e,...t){return x(!0,e,...t)}function P(e,...t){return x(!1,e,...t)}function G(e,t){return K(e,...Object.keys(t))}function J(e,t){return P(e,...Object.keys(t))}function X(e,t){return t in e?{[t]:e[t]}:{}}function Y(e){return e==null}import{Logger as _}from"tslog";import j from"i18next";import N from"i18next-browser-languagedetector";import S from"i18next-cli-language-detector";var h={Logger:{unknownLogLevel:'Unknown log level "{{logLevel}}"'},RemoteAppDataStorage:{httpError:"HTTP error {{status, number}} retrieving file"}};var y={Logger:{unknownLogLevel:"Niveau de journalisation inconnu \xAB{{logLevel}}\xBB"},RemoteAppDataStorage:{httpError:"Erreur HTTP {{status, number}} lors de la r\xE9cup\xE9ration du fichier"}};var L={CLI:0,Server:1,Browser:2};function O(e){return typeof e=="string"?e.split(" ").map(t=>/[a-z]/u.test(t)?t.toLowerCase():t).join(" "):String(e)}var C="aidct_core",V={en:{aidct_core:h},fr:{aidct_core:y}},c=j.createInstance();async function v(e,t,o,r,n,...s){if(!e.isInitialized){let u=function(f){for(let[l,A]of Object.entries(f)){l in i||(i[l]={});let b=i[l];for(let[m,D]of Object.entries(A)){if(m in b)throw new Error(`Duplicate namespace ${m} in merged resource bundle for language ${l}`);b[m]=D}}};var a=u;let i={};u(n);for(let f of s)await f(t,o).then(u);let p;switch(t){case L.CLI:p=S;break;case L.Browser:p=N;break;default:throw new Error("Not supported")}await e.use(p).init({debug:o,defaultNS:r,resources:i,nonExplicitSupportedLngs:!0,fallbackLng:Object.keys(i)[0],detection:{caches:[]}}).then(()=>{e.services.formatter?.add("toLowerCase",O)})}return n}async function se(e,t=!1){return v(c,e,t,C,V)}var d={Silly:0,Trace:1,Debug:2,Info:3,Warn:4,Error:5,Fatal:6};function M(e){let t;if(typeof e=="string")if(e in d)t=d[e];else throw new RangeError(c.t("Logger.unknownLogLevel",{logLevel:e}));else if(e!==void 0)if(Object.values(d).includes(e))t=e;else throw new RangeError(c.t("Logger.unknownLogLevel",{logLevel:e}));else t=d.Info;return t}function ue(e,t,o){let r=M(e);return new _({hideLogPositionForProduction:r>=d.Info,...t??{},minLevel:r},o)}function g(e){let t;switch(typeof e){case"string":case"number":case"boolean":case"undefined":t=e;break;case"bigint":t=e>=Number.MIN_SAFE_INTEGER&&e<=Number.MAX_SAFE_INTEGER?Number(e):e.toString(10);break;case"object":e===null?t=e:Array.isArray(e)?t=(e.length<=10?e:[...e.slice(0,4),"...",...e.slice(-4)]).map(o=>g(o)):e instanceof Error?t=g({name:e.name,message:e.message,stack:e.stack?.split(`
-`)}):t=Object.fromEntries(Object.entries(e).map(([o,r])=>[o,g(r)]));break;case"symbol":t=e.toString();break;case"function":t=`Function(${e.name})`;break}return t}var w=class{#t=new Map;#e=[];#r=0;#o=0;constructor(t,o,r){this.resize(o,r),t.attachTransport(n=>{this.#e.length>=this.#r&&this.#e.splice(0,this.#r-this.#o);let s=JSON.stringify(n);this.#e.push(s);for(let a of this.#t.values())a(s,this.#e)})}get messages(){return this.#e}get maximumLength(){return this.#r}get truncateLength(){return this.#o}addNotificationCallback(t,o){let r=!this.#t.has(t);return r&&(this.#t.set(t,o),o(void 0,this.#e)),r}removeNotificationCallback(t){this.#t.delete(t)}resize(t,o){this.#r=t,this.#o=o!==void 0?Math.min(o,Math.floor(t*.8)):Math.floor(t/2)}};function k(e){let t=/^(?<majorVersion>\d+)\.(?<minorVersion>\d+)\.(?<patchVersion>\d+)(?:-(?<preReleaseIdentifier>alpha|beta)(?:\.(?<dateTime>\d{12}))?)?$/u.exec(e)?.groups;if(t===void 0)throw new Error(`Invalid package version ${e}`);return{majorVersion:Number(t.majorVersion),minorVersion:Number(t.minorVersion),patchVersion:Number(t.patchVersion),preReleaseIdentifier:t.preReleaseIdentifier,dateTime:t.dateTime}}var R=globalThis.localStorage===void 0?import("./file-app-data-storage-Y5AB6YOB.js").then(e=>e.FileAppDataStorage):import("./browser-app-data-storage-G62WSQ5Z.js").then(e=>e.BrowserAppDataStorage);var $="http://localhost:5173",U="config",B="resources.local",ge=R.then(async e=>new e(U).read(B)).then(e=>e?.alphaURL??$),F="https://aidc-toolkit.com";function be(e,t,o,r){let n=k(e),s=n.preReleaseIdentifier,a;if(s==="alpha")a=o;else{let i=s!==void 0?`/${s}`:"",u=s!==void 0||t?`/v${n.majorVersion}.${n.minorVersion}`:"",p=r!==void 0&&r!==""?`/${r}`:"";a=`${F}${i}${u}${p}`}return a}var I=class extends T{constructor(t){super(!0,t)}async doRead(t,o){return fetch(t).then(async r=>{let n;if(r.ok)n=o===!0?new Uint8Array(await r.arrayBuffer()):await r.text();else if(r.status===404)n=void 0;else throw new RangeError(c.t("RemoteAppDataStorage.httpError",{status:r.status}));return n})}};var E=class{};export{ge as ALPHA_URL,z as AppDataStorage,E as Cache,L as I18nEnvironments,R as LocalAppDataStorage,d as LogLevels,w as MemoryTransport,T as ReadOnlyAppDataStorage,I as RemoteAppDataStorage,F as WEBSITE_BASE_URL,C as coreNS,V as coreResourceBundle,W as decodeAppData,H as encodeAppData,G as exclude,ue as getLogger,se as i18nCoreInit,v as i18nInit,c as i18nextCore,J as include,Y as isNullish,M as logLevelOf,g as loggableValue,K as omit,k as parseVersion,P as pick,X as propertyAs,be as websiteURL};
 /*!
  * Copyright © 2024-2026 Dolphin Data Development Ltd. and AIDC Toolkit
  * contributors
@@ -16,3 +14,15 @@ import{a as W,b as H,c as T,d as z}from"./chunk-FIUBVWNN.js";function x(e,t,...o
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+export * from "./type-helper.js";
+export * from "./logger.js";
+export * from "./parse-version.js";
+export * from "./website-url.js";
+export * from "./app-data.js";
+export * from "./app-data-storage.js";
+export * from "./local-app-data-storage.js";
+export * from "./http-fetch.js";
+export * from "./remote-app-data-storage.js";
+export * from "./cache.js";
+export * from "./locale/i18n.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,cAAc,kBAAkB,CAAC;AAEjC,cAAc,aAAa,CAAC;AAE5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AAEjC,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iBAAiB,CAAC;AAChC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,YAAY,CAAC;AAI3B,cAAc,kBAAkB,CAAC"}

package/dist/local-app-data-storage.d.ts

@@ -0,0 +1,8 @@
+import type { AppDataStorage } from "./app-data-storage.js";
+/**
+ * Local application data storage class for the current environment. This is a variable representing a `Promise` as the
+ * implementing class is loaded dynamically to prevent the inclusion of unnecessary node dependencies in a browser
+ * environment.
+ */
+export declare const LocalAppDataStorage: Promise<new (path?: string) => AppDataStorage<boolean>>;
+//# sourceMappingURL=local-app-data-storage.d.ts.map

package/dist/local-app-data-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-app-data-storage.d.ts","sourceRoot":"","sources":["../src/local-app-data-storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC,EAAE,MAAM,KAAK,cAAc,CAAC,OAAO,CAAC,CAII,CAAC"}

package/dist/local-app-data-storage.js

@@ -0,0 +1,11 @@
+/**
+ * Local application data storage class for the current environment. This is a variable representing a `Promise` as the
+ * implementing class is loaded dynamically to prevent the inclusion of unnecessary node dependencies in a browser
+ * environment.
+ */
+export const LocalAppDataStorage = 
+// eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- localStorage is undefined when running under Node.js.
+globalThis.localStorage === undefined ?
+    import("./file-app-data-storage.js").then(module => module.FileAppDataStorage) :
+    import("./browser-app-data-storage.js").then(module => module.BrowserAppDataStorage);
+//# sourceMappingURL=local-app-data-storage.js.map

package/dist/local-app-data-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-app-data-storage.js","sourceRoot":"","sources":["../src/local-app-data-storage.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB;AAC5B,gIAAgI;AAChI,UAAU,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC;IACnC,MAAM,CAAC,4BAA4B,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC;IAChF,MAAM,CAAC,+BAA+B,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC"}

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

@@ -0,0 +1,10 @@
+declare const _default: {
+    Logger: {
+        unknownLogLevel: string;
+    };
+    RemoteAppDataStorage: {
+        httpError: string;
+    };
+};
+export default _default;
+//# sourceMappingURL=locale-resources.d.ts.map

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

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

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

@@ -0,0 +1,9 @@
+export default {
+    Logger: {
+        unknownLogLevel: "Unknown log level \"{{logLevel}}\""
+    },
+    RemoteAppDataStorage: {
+        httpError: "HTTP error {{status, number}} retrieving file"
+    }
+};
+//# sourceMappingURL=locale-resources.js.map

package/dist/locale/en/locale-resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale-resources.js","sourceRoot":"","sources":["../../../src/locale/en/locale-resources.ts"],"names":[],"mappings":"AAAA,eAAe;IACX,MAAM,EAAE;QACJ,eAAe,EAAE,oCAAoC;KACxD;IACD,oBAAoB,EAAE;QAClB,SAAS,EAAE,+CAA+C;KAC7D;CACJ,CAAC"}

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

@@ -0,0 +1,10 @@
+declare const _default: {
+    Logger: {
+        unknownLogLevel: string;
+    };
+    RemoteAppDataStorage: {
+        httpError: string;
+    };
+};
+export default _default;
+//# sourceMappingURL=locale-resources.d.ts.map

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

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

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

@@ -0,0 +1,9 @@
+export default {
+    Logger: {
+        unknownLogLevel: "Niveau de journalisation inconnu «{{logLevel}}»"
+    },
+    RemoteAppDataStorage: {
+        httpError: "Erreur HTTP {{status, number}} lors de la récupération du fichier"
+    }
+};
+//# sourceMappingURL=locale-resources.js.map

package/dist/locale/fr/locale-resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale-resources.js","sourceRoot":"","sources":["../../../src/locale/fr/locale-resources.ts"],"names":[],"mappings":"AAAA,eAAe;IACX,MAAM,EAAE;QACJ,eAAe,EAAE,iDAAiD;KACrE;IACD,oBAAoB,EAAE;QAClB,SAAS,EAAE,mEAAmE;KACjF;CACJ,CAAC"}

package/dist/locale/i18n.d.ts

@@ -0,0 +1,83 @@
+import { type i18n, type Resource } from "i18next";
+import enLocaleResources from "./en/locale-resources.js";
+/**
+ * Locale strings type for generic manipulation.
+ */
+export interface LocaleResources {
+    [key: string]: LocaleResources | string;
+}
+/**
+ * Internationalization operating environments.
+ */
+export declare const I18nEnvironments: {
+    /**
+     * Command-line interface (e.g., unit tests).
+     */
+    readonly CLI: 0;
+    /**
+     * Web server.
+     */
+    readonly Server: 1;
+    /**
+     * Web browser.
+     */
+    readonly Browser: 2;
+};
+/**
+ * Internationalization operating environment key.
+ */
+export type I18nEnvironmentKey = keyof typeof I18nEnvironments;
+/**
+ * Internationalization operating environment.
+ */
+export type I18nEnvironment = typeof I18nEnvironments[I18nEnvironmentKey];
+export declare const coreNS = "aidct_core";
+/**
+ * Locale resources type is extracted from the English locale resources object.
+ */
+export type CoreLocaleResources = typeof enLocaleResources;
+/**
+ * Core resource bundle.
+ */
+export declare const coreResourceBundle: Resource;
+export declare const i18nextCore: i18n;
+/**
+ * Initialize internationalization.
+ *
+ * @param i18next
+ * Internationalization object. As multiple objects exist, this parameter represents the one for the module for which
+ * internationalization is being initialized.
+ *
+ * @param environment
+ * Environment in which the application is running.
+ *
+ * @param debug
+ * Debug setting.
+ *
+ * @param defaultNS
+ * Default namespace.
+ *
+ * @param defaultResourceBundle
+ * Default resource bundle.
+ *
+ * @param i18nDependencyInits
+ * Dependency internationalization initialization functions.
+ *
+ * @returns
+ * Default resource bundle.
+ */
+export declare function i18nInit(i18next: i18n, environment: I18nEnvironment, debug: boolean, defaultNS: string, defaultResourceBundle: Resource, ...i18nDependencyInits: Array<(environment: I18nEnvironment, debug: boolean) => Promise<Resource>>): Promise<Resource>;
+/**
+ * Initialize internationalization.
+ *
+ * @param environment
+ * Environment in which the application is running.
+ *
+ * @param debug
+ * Debug setting.
+ *
+ * @returns
+ * Core resource bundle.
+ */
+export declare function i18nCoreInit(environment: I18nEnvironment, debug?: boolean): Promise<Resource>;
+//# sourceMappingURL=i18n.d.ts.map

package/dist/locale/i18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../src/locale/i18n.ts"],"names":[],"mappings":"AAAA,OAAgB,EACZ,KAAK,IAAI,EAKT,KAAK,QAAQ,EAChB,MAAM,SAAS,CAAC;AAGjB,OAAO,iBAAiB,MAAM,0BAA0B,CAAC;AAGzD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,GAAG,MAAM,CAAC;CAC3C;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB;IACzB;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;CAEG,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,OAAO,gBAAgB,CAAC;AAE/D;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,gBAAgB,CAAC,kBAAkB,CAAC,CAAC;AAkB1E,eAAO,MAAM,MAAM,eAAe,CAAC;AAEnC;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,OAAO,iBAAiB,CAAC;AAE3D;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,QAOhC,CAAC;AAGF,eAAO,MAAM,WAAW,EAAE,IAA+B,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,eAAe,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,qBAAqB,EAAE,QAAQ,EAAE,GAAG,mBAAmB,EAAE,KAAK,CAAC,CAAC,WAAW,EAAE,eAAe,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CA4ErQ;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,YAAY,CAAC,WAAW,EAAE,eAAe,EAAE,KAAK,UAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAEjG"}

package/dist/locale/i18n.js

@@ -0,0 +1,157 @@
+import i18next from "i18next";
+import I18nextBrowserLanguageDetector from "i18next-browser-languagedetector";
+import I18nextCLILanguageDetector from "i18next-cli-language-detector";
+import enLocaleResources from "./en/locale-resources.js";
+import frLocaleResources from "./fr/locale-resources.js";
+/**
+ * Internationalization operating environments.
+ */
+export const I18nEnvironments = {
+    /**
+     * Command-line interface (e.g., unit tests).
+     */
+    CLI: 0,
+    /**
+     * Web server.
+     */
+    Server: 1,
+    /**
+     * Web browser.
+     */
+    Browser: 2
+};
+/**
+ * Convert a string to lower case, skipping words that are all upper case.
+ *
+ * @param value
+ * Value.
+ *
+ * @returns
+ * Lower case string if value is a string. If not, value is returned as a string but not converted to lower case.
+ */
+function toLowerCase(value) {
+    return typeof value === "string" ?
+        // Words with no lower case letters are preserved as they are likely mnemonics.
+        value.split(" ").map(word => /[a-z]/u.test(word) ? word.toLowerCase() : word).join(" ") :
+        String(value);
+}
+export const coreNS = "aidct_core";
+/**
+ * Core resource bundle.
+ */
+export const coreResourceBundle = {
+    en: {
+        aidct_core: enLocaleResources
+    },
+    fr: {
+        aidct_core: frLocaleResources
+    }
+};
+// Explicit type is necessary because type can't be inferred without additional references.
+export const i18nextCore = i18next.createInstance();
+/**
+ * Initialize internationalization.
+ *
+ * @param i18next
+ * Internationalization object. As multiple objects exist, this parameter represents the one for the module for which
+ * internationalization is being initialized.
+ *
+ * @param environment
+ * Environment in which the application is running.
+ *
+ * @param debug
+ * Debug setting.
+ *
+ * @param defaultNS
+ * Default namespace.
+ *
+ * @param defaultResourceBundle
+ * Default resource bundle.
+ *
+ * @param i18nDependencyInits
+ * Dependency internationalization initialization functions.
+ *
+ * @returns
+ * Default resource bundle.
+ */
+export async function i18nInit(i18next, environment, debug, defaultNS, defaultResourceBundle, ...i18nDependencyInits) {
+    // Initialization may be called more than once.
+    if (!i18next.isInitialized) {
+        const mergedResourceBundle = {};
+        /**
+         * Merge a package resource bundle into the merged resource bundle.
+         *
+         * @param resourceBundle
+         * Package resource bundle.
+         */
+        function mergeResourceBundle(resourceBundle) {
+            // Merge languages.
+            for (const [language, languageResourceBundle] of Object.entries(resourceBundle)) {
+                if (!(language in mergedResourceBundle)) {
+                    mergedResourceBundle[language] = {};
+                }
+                const mergedLanguageResourceBundle = mergedResourceBundle[language];
+                // Merge namespaces.
+                for (const [namespace, resourceKey] of Object.entries(languageResourceBundle)) {
+                    if (namespace in mergedLanguageResourceBundle) {
+                        // Error prior to internationalization initialization; no localization possible.
+                        throw new Error(`Duplicate namespace ${namespace} in merged resource bundle for language ${language}`);
+                    }
+                    mergedLanguageResourceBundle[namespace] = resourceKey;
+                }
+            }
+        }
+        mergeResourceBundle(defaultResourceBundle);
+        // Initialize dependencies and merge their resource bundles.
+        for (const i18nDependencyInit of i18nDependencyInits) {
+            // eslint-disable-next-line no-await-in-loop -- Dependencies must initialized first.
+            await i18nDependencyInit(environment, debug).then(mergeResourceBundle);
+        }
+        let module;
+        switch (environment) {
+            case I18nEnvironments.CLI:
+                // TODO Refactor when https://github.com/neet/i18next-cli-language-detector/issues/281 resolved.
+                // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Per above.
+                module = I18nextCLILanguageDetector;
+                break;
+            case I18nEnvironments.Browser:
+                module = I18nextBrowserLanguageDetector;
+                break;
+            default:
+                throw new Error("Not supported");
+        }
+        await i18next.use(module).init({
+            debug,
+            defaultNS,
+            resources: mergedResourceBundle,
+            // Allow fallback by removing variant code then country code until match is found.
+            nonExplicitSupportedLngs: true,
+            // Fallback to first language defined.
+            fallbackLng: Object.keys(mergedResourceBundle)[0],
+            detection: {
+                // Disabling cache allows read but requires explicit saving of i18nextLng attribute (e.g., via UI).
+                caches: []
+            }
+        }).then(() => {
+            // Add toLowerCase formatter.
+            i18next.services.formatter?.add("toLowerCase", toLowerCase);
+        });
+    }
+    return defaultResourceBundle;
+}
+/**
+ * Initialize internationalization.
+ *
+ * @param environment
+ * Environment in which the application is running.
+ *
+ * @param debug
+ * Debug setting.
+ *
+ * @returns
+ * Core resource bundle.
+ */
+export async function i18nCoreInit(environment, debug = false) {
+    return i18nInit(i18nextCore, environment, debug, coreNS, coreResourceBundle);
+}
+//# sourceMappingURL=i18n.js.map

package/dist/locale/i18n.js.map

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

package/dist/logger.d.ts

@@ -0,0 +1,136 @@
+import { type ISettingsParam, Logger } from "tslog";
+/**
+ * Log levels.
+ */
+export declare const LogLevels: {
+    readonly Silly: 0;
+    readonly Trace: 1;
+    readonly Debug: 2;
+    readonly Info: 3;
+    readonly Warn: 4;
+    readonly Error: 5;
+    readonly Fatal: 6;
+};
+/**
+ * Log level key.
+ */
+export type LogLevelKey = keyof typeof LogLevels;
+/**
+ * Log level.
+ */
+export type LogLevel = typeof LogLevels[LogLevelKey];
+/**
+ * Get the log level enumeration value corresponding to a string or number.
+ *
+ * @param untypedLogLevel
+ * Untyped log level.
+ *
+ * @returns
+ * Typed log level or default `LogLevels.Info` if untyped log level not provided..
+ */
+export declare function logLevelOf(untypedLogLevel?: string | number): LogLevel;
+/**
+ * Get a logger with an optional log level. The underlying implementation is
+ * [`tslog`](https://tslog.js.org/).
+ *
+ * @param logLevel
+ * Log level as enumeration value or string. Mapped to `minLevel` and sets `hideLogPositionForProduction` to true in
+ * settings if at {@linkcode LogLevels.Info} or higher. Default is {@linkcode LogLevels.Info}.
+ *
+ * @param settings
+ * Detailed settings. See [`tslog`](https://tslog.js.org/#/?id=settings) documentation for details. The `minLevel` is
+ * ignored in favour of `logLevel` but `hideLogPositionForProduction` will override the default logic.
+ *
+ * @param logObj
+ * Default log object. See [`tslog`](https://tslog.js.org/#/?id=defining-and-accessing-logobj) documentation for
+ * details.
+ *
+ * @returns
+ * Logger.
+ *
+ * @template T
+ * Log object type.
+ */
+export declare function getLogger<T extends object = object>(logLevel?: string | number, settings?: ISettingsParam<T>, logObj?: T): Logger<T>;
+/**
+ * Get a loggable representation of a value. Values are returned unmodified, except as follows:
+ *
+ * - Big integers are converted to whole numbers where possible, otherwise as their decimal string representations.
+ * - Arrays are limited to a maximum of ten elements. Any array longer than ten elements is replaced with the first four
+ * elements, a string of three dots, and the last four elements. This may still create large results for
+ * multidimensional arrays.
+ * - Errors are converted to objects with `name`, `message`, and `stack` properties.
+ * - Symbols are converted to their string representations.
+ * - Functions are converted to strings of the form `Function(name)`.
+ *
+ * @param value
+ * Value.
+ *
+ * @returns
+ * Loggable value.
+ */
+export declare function loggableValue(value: unknown): unknown;
+/**
+ * Logger transport that stores messages in memory.
+ */
+export declare class MemoryTransport<T extends object> {
+    #private;
+    /**
+     * Constructor.
+     *
+     * @param logger
+     * Logger.
+     *
+     * @param maximumLength
+     * Maximum length of messages array.
+     *
+     * @param truncateLength
+     * Length to which messages array is truncated when maximum is reached. Default is 50% of `maximumLength`, maximum
+     * is 80% of `maximumLength`.
+     */
+    constructor(logger: Logger<T>, maximumLength: number, truncateLength?: number);
+    /**
+     * Get the messages.
+     */
+    get messages(): string[];
+    /**
+     * Get the maximum length of messages array.
+     */
+    get maximumLength(): number;
+    /**
+     * Get the length to which messages array is truncated when maximum is reached.
+     */
+    get truncateLength(): number;
+    /**
+     * Add a notification callback. If one already exists under the current name, do nothing.
+     *
+     * @param name
+     * Callback name.
+     *
+     * @param notificationCallback
+     * Callback.
+     *
+     * @returns
+     * True if successfully added.
+     */
+    addNotificationCallback(name: string, notificationCallback: (message: string | undefined, messages: readonly string[]) => void): boolean;
+    /**
+     * Remove a notification callback.
+     *
+     * @param name
+     * Callback name.
+     */
+    removeNotificationCallback(name: string): void;
+    /**
+     * Resize the messages array.
+     *
+     * @param maximumLength
+     * Maximum length of messages array.
+     *
+     * @param truncateLength
+     * Length to which messages array is truncated when maximum is reached. Default is 50% of `maximumLength`, maximum
+     * is 80% of `maximumLength`.
+     */
+    resize(maximumLength: number, truncateLength?: number): void;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAGpD;;GAEG;AACH,eAAO,MAAM,SAAS;;;;;;;;CAQZ,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,SAAS,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,SAAS,CAAC,WAAW,CAAC,CAAC;AAErD;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,CA2BtE;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAUpI;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CA4CrD;AAED;;GAEG;AACH,qBAAa,eAAe,CAAC,CAAC,SAAS,MAAM;;IAqBzC;;;;;;;;;;;;OAYG;gBACS,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM;IAoB7E;;OAEG;IACH,IAAI,QAAQ,IAAI,MAAM,EAAE,CAEvB;IAED;;OAEG;IACH,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED;;OAEG;IACH,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED;;;;;;;;;;;OAWG;IACH,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,KAAK,IAAI,GAAG,OAAO;IAaxI;;;;;OAKG;IACH,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI9C;;;;;;;;;OASG;IACH,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI;CAI/D"}