@aidc-toolkit/core 1.0.44 → 1.0.45-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 z,b as G,c as h,d as J}from"./chunk-FIUBVWNN.js";function x(e,t,...r){return Object.fromEntries(Object.entries(t).filter(([o])=>r.includes(o)!==e))}function O(e,...t){return x(!0,e,...t)}function K(e,...t){return x(!1,e,...t)}function X(e,t){return O(e,...Object.keys(t))}function Y(e,t){return K(e,...Object.keys(t))}function q(e,t){return t in e?{[t]:e[t]}:{}}function Q(e){return e==null}import{Logger as M}from"tslog";import E from"i18next";import S from"i18next-browser-languagedetector";import C from"i18next-cli-language-detector";var y={Logger:{unknownLogLevel:'Unknown log level "{{logLevel}}"'},RemoteAppDataStorage:{httpError:"HTTP error {{status, number}} retrieving file"}};var L={Logger:{unknownLogLevel:"Niveau de journalisation inconnu \xAB\xA0{{logLevel}}\xA0\xBB"},RemoteAppDataStorage:{httpError:"Erreur HTTP {{status, number}} lors de la r\xE9cup\xE9ration du fichier"}};var ae={CLI:C,Browser:S};function V(e){return typeof e=="string"?e.split(" ").map(t=>/[a-z]/u.test(t)?t.toLowerCase():t).join(" "):String(e)}var _="aidct_core",F={en:{aidct_core:y},fr:{aidct_core:L}},u=E.createInstance();async function H(e,t,r,o,s,...i){let n;if(!e.isInitialized){let p=function(l){for(let[c,I]of Object.entries(l)){c in a||(a[c]={});let b=a[c];for(let[f,j]of Object.entries(I)){if(f in b)throw new Error(`Duplicate namespace ${f} in merged resource bundle for language ${c}`);b[f]=j}}};var m=p;let a={};p(s);for(let l of i){let c=l(t,r).then(p);n=n===void 0?c:n.then(async()=>c)}let T=e.use(t).init({debug:r,defaultNS:o,resources:a,nonExplicitSupportedLngs:!0,fallbackLng:Object.keys(a)[0],detection:{caches:[]}}).then(()=>{e.services.formatter?.add("toLowerCase",V)});n=n===void 0?T:n.then(async()=>T)}return n!==void 0?n.then(()=>s):s}async function ce(e,t=!1){return H(u,e,t,_,F)}var d={Silly:0,Trace:1,Debug:2,Info:3,Warn:4,Error:5,Fatal:6};function U(e){let t;if(typeof e=="string")if(e in d)t=d[e];else throw new RangeError(u.t("Logger.unknownLogLevel",{logLevel:e}));else if(e!==void 0)if(Object.values(d).includes(e))t=e;else throw new RangeError(u.t("Logger.unknownLogLevel",{logLevel:e}));else t=d.Info;return t}function le(e,t,r){let o=U(e);return new M({hideLogPositionForProduction:o>=d.Info,...t??{},minLevel:o},r)}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(r=>g(r)):e instanceof Error?t=g({name:e.name,message:e.message,stack:e.stack?.split(`
-`)}):t=Object.fromEntries(Object.entries(e).map(([r,o])=>[r,g(o)]));break;case"symbol":t=e.toString();break;case"function":t=`Function(${e.name})`;break}return t}var P=class{#e=new Map;#t=[];#r=0;#o=0;constructor(t,r,o){this.resize(r,o),t.attachTransport(s=>{this.#t.length>=this.#r&&this.#t.splice(0,this.#r-this.#o);let i=JSON.stringify(s);this.#t.push(i);for(let n of this.#e.values())n(i,this.#t)})}get messages(){return this.#t}get maximumLength(){return this.#r}get truncateLength(){return this.#o}addNotificationCallback(t,r){let o=!this.#e.has(t);return o&&(this.#e.set(t,r),r(void 0,this.#t)),o}removeNotificationCallback(t){this.#e.delete(t)}resize(t,r){this.#r=t,this.#o=r!==void 0?Math.min(r,Math.floor(t*.8)):Math.floor(t/2)}};function w(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-M6RA7QOG.js").then(e=>e.FileAppDataStorage):import("./browser-app-data-storage-G62WSQ5Z.js").then(e=>e.BrowserAppDataStorage);var $="http://localhost:5173",v="config",B="resources.local",he=R.then(async e=>new e(v).read(B)).then(e=>e?.alphaURL??$),W="https://aidc-toolkit.com";function xe(e,t,r,o){let s=w(e),i=s.preReleaseIdentifier,n;if(i==="alpha")n=r;else{let m=i!==void 0?`/${i}`:"",a=i!==void 0||t?`/v${s.majorVersion}.${s.minorVersion}`:"",p=o!==void 0&&o!==""?`/${o}`:"";n=`${W}${m}${a}${p}`}return n}var Le=200,k=404;async function D(e){return fetch(e).then(t=>({ok:t.ok,status:t.status,arrayBuffer:async()=>t.arrayBuffer(),text:async()=>t.text()}))}var A=class extends h{#e;constructor(t,r=D){super(!0,t),this.#e=r}async doRead(t,r){let o=await this.#e(t),s;if(o.ok)s=r===!0?new Uint8Array(await o.arrayBuffer()):await o.text();else if(o.status===404)s=void 0;else throw new RangeError(u.t("RemoteAppDataStorage.httpError",{status:o.status}));return s}};var N=class{};export{he as ALPHA_URL,J as AppDataStorage,N as Cache,k as HTTP_NOT_FOUND,Le as HTTP_OK,ae as I18nLanguageDetectors,R as LocalAppDataStorage,d as LogLevels,P as MemoryTransport,h as ReadOnlyAppDataStorage,A as RemoteAppDataStorage,W as WEBSITE_BASE_URL,_ as coreNS,F as coreResourceBundle,z as decodeAppData,D as defaultHTTPFetch,G as encodeAppData,X as exclude,le as getLogger,ce as i18nCoreInit,H as i18nInit,u as i18nextCore,Y as include,Q as isNullish,U as logLevelOf,g as loggableValue,O as omit,w as parseVersion,K as pick,q as propertyAs,xe as websiteURL};
 /*!
  * Copyright © 2024-2026 Dolphin Data Development Ltd. and AIDC Toolkit
  * contributors
@@ -16,3 +14,15 @@ import{a as z,b as G,c as h,d as J}from"./chunk-FIUBVWNN.js";function x(e,t,...r
  * 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,mDAAmD;KACvE;IACD,oBAAoB,EAAE;QAClB,SAAS,EAAE,mEAAmE;KACjF;CACJ,CAAC"}

package/dist/locale/i18n.d.ts

@@ -0,0 +1,95 @@
+import { type DefaultNamespace, type i18n, type LanguageDetectorModule, type Namespace, type Newable, type NewableModule, type ParseKeys, type Resource, type TOptions } from "i18next";
+import enLocaleResources from "./en/locale-resources.js";
+/**
+ * Locale strings type for generic manipulation.
+ */
+export interface LocaleResources {
+    [key: string]: LocaleResources | string | undefined;
+}
+/**
+ * Internationalization language detectors.
+ */
+export declare const I18nLanguageDetectors: {
+    /**
+     * Command-line interface (e.g., unit tests).
+     */
+    readonly CLI: LanguageDetectorModule;
+    /**
+     * Web browser.
+     */
+    readonly Browser: Newable<LanguageDetectorModule>;
+};
+/**
+ * Internationalization language detector.
+ */
+export type I18nLanguageDetector = LanguageDetectorModule | Newable<LanguageDetectorModule> | NewableModule<LanguageDetectorModule>;
+/**
+ * Determine if a key exists.
+ *
+ * @param i18next
+ * Internationalization object.
+ *
+ * @param key
+ * Key to check.
+ *
+ * @param options
+ * Options.
+ *
+ * @returns
+ * True if key exists in the specified namespace with the given options.
+ */
+export declare function isI18nParseKey<TNamespace extends Namespace = DefaultNamespace, TNamespaceOptions extends TOptions = TNamespace extends DefaultNamespace ? {
+    ns?: DefaultNamespace;
+} : {
+    ns: TNamespace;
+}>(i18next: i18n, key: string, options?: TNamespaceOptions): key is ParseKeys<TNamespace, TNamespaceOptions>;
+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 languageDetector
+ * Language detector.
+ *
+ * @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, languageDetector: I18nLanguageDetector, debug: boolean, defaultNS: string, defaultResourceBundle: Resource, ...i18nDependencyInits: Array<(languageDetector: I18nLanguageDetector, debug: boolean) => Promise<Resource>>): Promise<Resource>;
+/**
+ * Initialize internationalization.
+ *
+ * @param languageDetector
+ * Language detector.
+ *
+ * @param debug
+ * Debug setting.
+ *
+ * @returns
+ * Core resource bundle.
+ */
+export declare function i18nCoreInit(languageDetector: I18nLanguageDetector, 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,gBAAgB,EACrB,KAAK,IAAI,EACT,KAAK,sBAAsB,EAC3B,KAAK,SAAS,EACd,KAAK,OAAO,EACZ,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,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,GAAG,SAAS,CAAC;CACvD;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB;IAC9B;;OAEG;kBAG2C,sBAAsB;IAEpE;;OAEG;sBACwC,OAAO,CAAC,sBAAsB,CAAC;CACpE,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAC5B,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC,GAAG,aAAa,CAAC,sBAAsB,CAAC,CAAC;AAkBrG;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAC1B,UAAU,SAAS,SAAS,GAAG,gBAAgB,EAC/C,iBAAiB,SAAS,QAAQ,GAAG,UAAU,SAAS,gBAAgB,GACpE;IACI,EAAE,CAAC,EAAE,gBAAgB,CAAC;CACzB,GACD;IACI,EAAE,EAAE,UAAU,CAAC;CAClB,EACP,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,GAAG,IAAI,SAAS,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAE1G;AAED,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,gBAAgB,EAAE,oBAAoB,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,qBAAqB,EAAE,QAAQ,EAAE,GAAG,mBAAmB,EAAE,KAAK,CAAC,CAAC,gBAAgB,EAAE,oBAAoB,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAgEzR;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,YAAY,CAAC,gBAAgB,EAAE,oBAAoB,EAAE,KAAK,UAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAE3G"}

package/dist/locale/i18n.js

@@ -0,0 +1,162 @@
+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 language detectors.
+ */
+export const I18nLanguageDetectors = {
+    /**
+     * Command-line interface (e.g., unit tests).
+     */
+    // 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.
+    CLI: I18nextCLILanguageDetector,
+    /**
+     * Web browser.
+     */
+    Browser: I18nextBrowserLanguageDetector
+};
+/**
+ * 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);
+}
+/**
+ * Determine if a key exists.
+ *
+ * @param i18next
+ * Internationalization object.
+ *
+ * @param key
+ * Key to check.
+ *
+ * @param options
+ * Options.
+ *
+ * @returns
+ * True if key exists in the specified namespace with the given options.
+ */
+export function isI18nParseKey(i18next, key, options) {
+    return i18next.exists(key, options);
+}
+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 languageDetector
+ * Language detector.
+ *
+ * @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, languageDetector, debug, defaultNS, defaultResourceBundle, ...i18nDependencyInits) {
+    let initAll = undefined;
+    // 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);
+        // Build chain to initialize dependencies and merge their resource bundles.
+        for (const i18nDependencyInit of i18nDependencyInits) {
+            const initDependency = i18nDependencyInit(languageDetector, debug).then(mergeResourceBundle);
+            initAll = initAll === undefined ? initDependency : initAll.then(async () => initDependency);
+        }
+        const initThis = i18next.use(languageDetector).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);
+        });
+        initAll = initAll === undefined ? initThis : initAll.then(async () => initThis);
+    }
+    return initAll !== undefined ? initAll.then(() => defaultResourceBundle) : defaultResourceBundle;
+}
+/**
+ * Initialize internationalization.
+ *
+ * @param languageDetector
+ * Language detector.
+ *
+ * @param debug
+ * Debug setting.
+ *
+ * @returns
+ * Core resource bundle.
+ */
+export async function i18nCoreInit(languageDetector, debug = false) {
+    return i18nInit(i18nextCore, languageDetector, 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"}