@aidc-toolkit/core 1.0.31-beta → 1.0.33-beta

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

@@ -0,0 +1,34 @@
+import { AppDataStorage } from "./app-data-storage.js";
+/**
+ * Application data storage using the browser local storage.
+ */
+export class BrowserAppDataStorage extends AppDataStorage {
+    /**
+     * Constructor.
+     *
+     * @param path
+     * Storage path prepended to each key along with '/' if defined, empty string if not.
+     */
+    constructor(path) {
+        super(false, path);
+    }
+    /**
+     * @inheritDoc
+     */
+    doRead(key) {
+        return localStorage.getItem(key) ?? undefined;
+    }
+    /**
+     * @inheritDoc
+     */
+    doWrite(key, s) {
+        localStorage.setItem(key, s);
+    }
+    /**
+     * @inheritDoc
+     */
+    doDelete(key) {
+        localStorage.removeItem(key);
+    }
+}
+//# sourceMappingURL=browser-app-data-storage.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"browser-app-data-storage.js","sourceRoot":"","sources":["../src/browser-app-data-storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD;;GAEG;AACH,MAAM,OAAO,qBAAsB,SAAQ,cAAqB;IAC5D;;;;;OAKG;IACH,YAAY,IAAa;QACrB,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACvB,CAAC;IAED;;OAEG;IACgB,MAAM,CAAC,GAAW;QACjC,OAAO,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC;IAClD,CAAC;IAED;;OAEG;IACgB,OAAO,CAAC,GAAW,EAAE,CAAS;QAC7C,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACgB,QAAQ,CAAC,GAAW;QACnC,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;CACJ"}

package/dist/cache.d.ts

@@ -0,0 +1,58 @@
+import type { Promisable } from "./type.js";
+/**
+ * Generic cache. Typically used to manage a local copy of remote data that is not refreshed regularly.
+ *
+ * @template TCache
+ * Type of cached data.
+ *
+ * @template TSource
+ * Type of source data. The type may be different from the cached data type if a transformation is required.
+ */
+export declare abstract class Cache<TCache, TSource = TCache> {
+    /**
+     * Get the date/time at or after which the source should be checked for updates. If the value is undefined, this is
+     * the first usage.
+     */
+    abstract get nextCheckDateTime(): Promisable<Date | undefined>;
+    /**
+     * Get the date/time at which the cache was last updated. This may more accurately reflect the date/time at which
+     * the last source retrieved was updated. If the value is undefined, there is no data in the cache.
+     */
+    abstract get cacheDateTime(): Promisable<Date | undefined>;
+    /**
+     * Get the cache data. This should only ever be called if the cache date/time is defined.
+     */
+    abstract get cacheData(): Promisable<TCache>;
+    /**
+     * Get the date/time at which the source was last updated. This should not be called unless the next check date/time
+     * has passed, as it may trigger an expensive remote retrieval.
+     */
+    abstract get sourceDateTime(): Promisable<Date>;
+    /**
+     * Get the source data. This should not be called unless the next check date/time has passed, as it may trigger an
+     * expensive remote retrieval.
+     */
+    abstract get sourceData(): Promisable<TSource>;
+    /**
+     * Update the cache with only the next check date/time. The cache date/time and cache data must not be modified.
+     * This is typically called when the cache is up to date with the source or source retrieval has failed.
+     *
+     * @param nextCheckDateTime
+     * Next check date/time.
+     */
+    abstract update(nextCheckDateTime: Date): Promisable<void>;
+    /**
+     * Update all cache parameters. This is typically called when the cache is updated from the source.
+     *
+     * @param nextCheckDateTime
+     * Next check date/time.
+     *
+     * @param cacheDateTime
+     * Cache date/time.
+     *
+     * @param cacheData
+     * Cache data.
+     */
+    abstract update(nextCheckDateTime: Date, cacheDateTime: Date, cacheData: TCache): Promisable<void>;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C;;;;;;;;GAQG;AACH,8BAAsB,KAAK,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM;IAChD;;;OAGG;IACH,QAAQ,KAAK,iBAAiB,IAAI,UAAU,CAAC,IAAI,GAAG,SAAS,CAAC,CAAC;IAE/D;;;OAGG;IACH,QAAQ,KAAK,aAAa,IAAI,UAAU,CAAC,IAAI,GAAG,SAAS,CAAC,CAAC;IAE3D;;OAEG;IACH,QAAQ,KAAK,SAAS,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;IAE7C;;;OAGG;IACH,QAAQ,KAAK,cAAc,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IAEhD;;;OAGG;IACH,QAAQ,KAAK,UAAU,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC;IAE/C;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,CAAC,iBAAiB,EAAE,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC;IAE1D;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,MAAM,CAAC,iBAAiB,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC;CACrG"}

package/dist/cache.js

@@ -0,0 +1,12 @@
+/**
+ * Generic cache. Typically used to manage a local copy of remote data that is not refreshed regularly.
+ *
+ * @template TCache
+ * Type of cached data.
+ *
+ * @template TSource
+ * Type of source data. The type may be different from the cached data type if a transformation is required.
+ */
+export class Cache {
+}
+//# sourceMappingURL=cache.js.map

package/dist/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,OAAgB,KAAK;CAoD1B"}

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

@@ -0,0 +1,26 @@
+import { AppDataStorage } from "./app-data-storage.js";
+/**
+ * Application data storage using the file system.
+ */
+export declare class FileAppDataStorage extends AppDataStorage<true> {
+    /**
+     * Constructor.
+     *
+     * @param path
+     * Storage path prepended to each key along with '/' if defined, empty string if not.
+     */
+    constructor(path?: string);
+    /**
+     * @inheritDoc
+     */
+    protected doRead(key: string, asBinary: boolean | undefined): Promise<string | Uint8Array | undefined>;
+    /**
+     * @inheritDoc
+     */
+    protected doWrite(key: string, data: string | Uint8Array): Promise<void>;
+    /**
+     * @inheritDoc
+     */
+    protected doDelete(key: string): Promise<void>;
+}
+//# sourceMappingURL=file-app-data-storage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-app-data-storage.d.ts","sourceRoot":"","sources":["../src/file-app-data-storage.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,cAAc,CAAC,IAAI,CAAC;IACxD;;;;;OAKG;gBACS,IAAI,CAAC,EAAE,MAAM;IAIzB;;OAEG;cACsB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;IAQrH;;OAEG;cACsB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAQvF;;OAEG;cACsB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAKhE"}

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

@@ -0,0 +1,40 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { AppDataStorage } from "./app-data-storage.js";
+/**
+ * Application data storage using the file system.
+ */
+export class FileAppDataStorage extends AppDataStorage {
+    /**
+     * Constructor.
+     *
+     * @param path
+     * Storage path prepended to each key along with '/' if defined, empty string if not.
+     */
+    constructor(path) {
+        super(true, path);
+    }
+    /**
+     * @inheritDoc
+     */
+    async doRead(key, asBinary) {
+        return fs.promises.readFile(key).then(buffer => asBinary === true ? buffer : buffer.toString()).catch(() => undefined);
+    }
+    /**
+     * @inheritDoc
+     */
+    async doWrite(key, data) {
+        return fs.promises.mkdir(path.dirname(key), {
+            recursive: true
+        }).then(async () => fs.promises.writeFile(key, data));
+    }
+    /**
+     * @inheritDoc
+     */
+    async doDelete(key) {
+        return fs.promises.rm(key, {
+            force: true
+        });
+    }
+}
+//# sourceMappingURL=file-app-data-storage.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-app-data-storage.js","sourceRoot":"","sources":["../src/file-app-data-storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,cAAoB;IACxD;;;;;OAKG;IACH,YAAY,IAAa;QACrB,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACtB,CAAC;IAED;;OAEG;IACgB,KAAK,CAAC,MAAM,CAAC,GAAW,EAAE,QAA6B;QACtE,OAAO,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAC3C,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,CACjD,CAAC,KAAK,CAAC,GAAG,EAAE,CACT,SAAS,CACZ,CAAC;IACN,CAAC;IAED;;OAEG;IACgB,KAAK,CAAC,OAAO,CAAC,GAAW,EAAE,IAAyB;QACnE,OAAO,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;YACxC,SAAS,EAAE,IAAI;SAClB,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CACf,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CACnC,CAAC;IACN,CAAC;IAED;;OAEG;IACgB,KAAK,CAAC,QAAQ,CAAC,GAAW;QACzC,OAAO,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE;YACvB,KAAK,EAAE,IAAI;SACd,CAAC,CAAC;IACP,CAAC;CACJ"}

package/dist/hyperlink.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Hyperlink.
+ */
+export interface Hyperlink {
+    /**
+     * Reference, relative or absolute depending on the application.
+     */
+    readonly reference: string;
+    /**
+     * Human-readable text.
+     */
+    readonly text?: string | undefined;
+    /**
+     * Additional details.
+     */
+    readonly details?: string | undefined;
+}
+//# sourceMappingURL=hyperlink.d.ts.map

package/dist/hyperlink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hyperlink.d.ts","sourceRoot":"","sources":["../src/hyperlink.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,SAAS;IACtB;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAEnC;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACzC"}

package/dist/hyperlink.js

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

package/dist/hyperlink.js.map

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

package/dist/index.d.ts

@@ -17,5 +17,11 @@
 export type * from "./type.js";
 export * from "./type-helper.js";
 export * from "./logger.js";
+export * from "./app-data.js";
+export * from "./app-data-storage.js";
+export * from "./local-app-data-storage.js";
+export * from "./remote-app-data-storage.js";
+export * from "./cache.js";
+export type * from "./hyperlink.js";
 export * from "./locale/i18n.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -1,4 +1,9 @@
 export * from "./type-helper.js";
 export * from "./logger.js";
+export * from "./app-data.js";
+export * from "./app-data-storage.js";
+export * from "./local-app-data-storage.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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAiBA,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAiBA,cAAc,kBAAkB,CAAC;AAEjC,cAAc,aAAa,CAAC;AAE5B,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,6BAA6B,CAAC;AAC5C,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

@@ -1,4 +1,5 @@
-import type { i18n, Resource } from "i18next";
+import { type i18n, type Resource } from "i18next";
+import enLocaleResources from "./en/locale-resources.js";
 /**
  * Locale strings type for generic manipulation.
  */
@@ -30,11 +31,21 @@ 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 exists, this parameter represents the one for the module for which
+ * Internationalization object. As multiple objects exist, this parameter represents the one for the module for which
  * internationalization is being initialized.
  *
  * @param environment
@@ -46,11 +57,27 @@ export type I18nEnvironment = typeof I18nEnvironments[I18nEnvironmentKey];
  * @param defaultNS
  * Default namespace.
  *
- * @param resources
- * Resources.
+ * @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
- * Void promise.
+ * Core resource bundle.
  */
-export declare function i18nCoreInit(i18next: i18n, environment: I18nEnvironment, debug: boolean, defaultNS: string, ...resources: Resource[]): Promise<void>;
+export declare function i18nCoreInit(environment: I18nEnvironment, debug?: boolean): Promise<Resource>;
 //# sourceMappingURL=i18n.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../src/locale/i18n.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAA0B,QAAQ,EAAE,MAAM,SAAS,CAAC;AAItE;;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;AAgB1E;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,eAAe,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAiD1J"}
+{"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;AAgB1E,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,CAiErQ;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,YAAY,CAAC,WAAW,EAAE,eAAe,EAAE,KAAK,UAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAEjG"}

package/dist/locale/i18n.js

@@ -1,5 +1,8 @@
+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.
  */
@@ -28,13 +31,27 @@ export const I18nEnvironments = {
  */
 function toLowerCase(s) {
     // Words with no lower case letters are preserved as they are likely mnemonics.
-    return s.split(" ").map(word => /[a-z]/.test(word) ? word.toLowerCase() : word).join(" ");
+    return s.split(" ").map(word => /[a-z]/u.test(word) ? word.toLowerCase() : word).join(" ");
 }
+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 exists, this parameter represents the one for the module for which
+ * Internationalization object. As multiple objects exist, this parameter represents the one for the module for which
  * internationalization is being initialized.
  *
  * @param environment
@@ -46,52 +63,80 @@ function toLowerCase(s) {
  * @param defaultNS
  * Default namespace.
  *
- * @param resources
- * Resources.
+ * @param defaultResourceBundle
+ * Default resource bundle.
+ *
+ * @param i18nDependencyInits
+ * Dependency internationalization initialization functions.
  *
  * @returns
- * Void promise.
+ * Default resource bundle.
  */
-export async function i18nCoreInit(i18next, environment, debug, defaultNS, ...resources) {
+export async function i18nInit(i18next, environment, debug, defaultNS, defaultResourceBundle, ...i18nDependencyInits) {
     // Initialization may be called more than once.
     if (!i18next.isInitialized) {
-        const mergedResource = {};
-        // Merge resources.
-        for (const resource of resources) {
+        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, resourceLanguage] of Object.entries(resource)) {
-                if (!(language in mergedResource)) {
-                    mergedResource[language] = {};
+            for (const [language, languageResourceBundle] of Object.entries(resourceBundle)) {
+                if (!(language in mergedResourceBundle)) {
+                    mergedResourceBundle[language] = {};
                 }
-                const mergedResourceLanguage = mergedResource[language];
+                const mergedLanguageResourceBundle = mergedResourceBundle[language];
                 // Merge namespaces.
-                for (const [namespace, resourceKey] of Object.entries(resourceLanguage)) {
-                    mergedResourceLanguage[namespace] = resourceKey;
+                for (const [namespace, resourceKey] of Object.entries(languageResourceBundle)) {
+                    mergedLanguageResourceBundle[namespace] = resourceKey;
                 }
             }
         }
-        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({
+        mergeResourceBundle(defaultResourceBundle);
+        // Initialize dependencies and merge their resource bundles.
+        await Promise.all(i18nDependencyInits.map(async (i18nDependencyInit) => i18nDependencyInit(environment, debug).then(mergeResourceBundle))).then(() => {
+            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");
+            }
+            return module;
+        }).then(async (module) => i18next.use(module).init({
             debug,
-            resources: mergedResource,
+            resources: mergedResourceBundle,
             fallbackLng: "en",
             defaultNS
-        }).then(() => {
+        })).then(() => {
             // Add toLowerCase function.
             i18next.services.formatter?.add("toLowerCase", value => typeof value === "string" ? toLowerCase(value) : String(value));
         });
     }
+    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

@@ -1 +1 @@
-{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../../src/locale/i18n.ts"],"names":[],"mappings":"AACA,OAAO,8BAA8B,MAAM,kCAAkC,CAAC;AAC9E,OAAO,0BAA0B,MAAM,+BAA+B,CAAC;AASvE;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC5B;;OAEG;IACH,GAAG,EAAE,CAAC;IAEN;;OAEG;IACH,MAAM,EAAE,CAAC;IAET;;OAEG;IACH,OAAO,EAAE,CAAC;CACJ,CAAC;AAYX;;;;;;;;GAQG;AACH,SAAS,WAAW,CAAC,CAAS;IAC1B,+EAA+E;IAC/E,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC9F,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAa,EAAE,WAA4B,EAAE,KAAc,EAAE,SAAiB,EAAE,GAAG,SAAqB;IACvI,+CAA+C;IAC/C,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QACzB,MAAM,cAAc,GAAa,EAAE,CAAC;QAEpC,mBAAmB;QACnB,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YAC/B,mBAAmB;YACnB,KAAK,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAClE,IAAI,CAAC,CAAC,QAAQ,IAAI,cAAc,CAAC,EAAE,CAAC;oBAChC,cAAc,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;gBAClC,CAAC;gBAED,MAAM,sBAAsB,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;gBAExD,oBAAoB;gBACpB,KAAK,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC;oBACtE,sBAAsB,CAAC,SAAS,CAAC,GAAG,WAAW,CAAC;gBACpD,CAAC;YACL,CAAC;QACL,CAAC;QAED,IAAI,MAAyC,CAAC;QAE9C,QAAQ,WAAW,EAAE,CAAC;YAClB,KAAK,gBAAgB,CAAC,GAAG;gBACrB,gGAAgG;gBAChG,qFAAqF;gBACrF,MAAM,GAAG,0BAA+D,CAAC;gBACzE,MAAM;YAEV,KAAK,gBAAgB,CAAC,OAAO;gBACzB,MAAM,GAAG,8BAA8B,CAAC;gBACxC,MAAM;YAEV;gBACI,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;QACzC,CAAC;QAED,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC;YAC3B,KAAK;YACL,SAAS,EAAE,cAAc;YACzB,WAAW,EAAE,IAAI;YACjB,SAAS;SACZ,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;YACT,4BAA4B;YAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAC5H,CAAC,CAAC,CAAC;IACP,CAAC;AACL,CAAC"}
+{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../../src/locale/i18n.ts"],"names":[],"mappings":"AAAA,OAAO,OAON,MAAM,SAAS,CAAC;AACjB,OAAO,8BAA8B,MAAM,kCAAkC,CAAC;AAC9E,OAAO,0BAA0B,MAAM,+BAA+B,CAAC;AACvE,OAAO,iBAAiB,MAAM,0BAA0B,CAAC;AACzD,OAAO,iBAAiB,MAAM,0BAA0B,CAAC;AASzD;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC5B;;OAEG;IACH,GAAG,EAAE,CAAC;IAEN;;OAEG;IACH,MAAM,EAAE,CAAC;IAET;;OAEG;IACH,OAAO,EAAE,CAAC;CACJ,CAAC;AAYX;;;;;;;;GAQG;AACH,SAAS,WAAW,CAAC,CAAS;IAC1B,+EAA+E;IAC/E,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/F,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,YAAY,CAAC;AAOnC;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAa;IACxC,EAAE,EAAE;QACA,UAAU,EAAE,iBAAiB;KAChC;IACD,EAAE,EAAE;QACA,UAAU,EAAE,iBAAiB;KAChC;CACJ,CAAC;AAEF,2FAA2F;AAC3F,MAAM,CAAC,MAAM,WAAW,GAAS,OAAO,CAAC,cAAc,EAAE,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,OAAa,EAAE,WAA4B,EAAE,KAAc,EAAE,SAAiB,EAAE,qBAA+B,EAAE,GAAG,mBAA+F;IAC9O,+CAA+C;IAC/C,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QACzB,MAAM,oBAAoB,GAAa,EAAE,CAAC;QAE1C;;;;;WAKG;QACH,SAAS,mBAAmB,CAAC,cAAwB;YACjD,mBAAmB;YACnB,KAAK,MAAM,CAAC,QAAQ,EAAE,sBAAsB,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;gBAC9E,IAAI,CAAC,CAAC,QAAQ,IAAI,oBAAoB,CAAC,EAAE,CAAC;oBACtC,oBAAoB,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;gBACxC,CAAC;gBAED,MAAM,4BAA4B,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;gBAEpE,oBAAoB;gBACpB,KAAK,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,sBAAsB,CAAC,EAAE,CAAC;oBAC5E,4BAA4B,CAAC,SAAS,CAAC,GAAG,WAAW,CAAC;gBAC1D,CAAC;YACL,CAAC;QACL,CAAC;QAED,mBAAmB,CAAC,qBAAqB,CAAC,CAAC;QAE3C,4DAA4D;QAC5D,MAAM,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,GAAG,CAAC,KAAK,EAAC,kBAAkB,EAAC,EAAE,CACjE,kBAAkB,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,CACpE,CAAC,IAAI,CAAC,GAAG,EAAE;YACR,IAAI,MAAwD,CAAC;YAE7D,QAAQ,WAAW,EAAE,CAAC;gBAClB,KAAK,gBAAgB,CAAC,GAAG;oBACrB,gGAAgG;oBAChG,qFAAqF;oBACrF,MAAM,GAAG,0BAA+D,CAAC;oBACzE,MAAM;gBAEV,KAAK,gBAAgB,CAAC,OAAO;oBACzB,MAAM,GAAG,8BAA8B,CAAC;oBACxC,MAAM;gBAEV;oBACI,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;YACzC,CAAC;YAED,OAAO,MAAM,CAAC;QAClB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,EAAC,MAAM,EAAC,EAAE,CACnB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC;YACrB,KAAK;YACL,SAAS,EAAE,oBAAoB;YAC/B,WAAW,EAAE,IAAI;YACjB,SAAS;SACZ,CAAC,CACL,CAAC,IAAI,CAAC,GAAG,EAAE;YACR,4BAA4B;YAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAC5H,CAAC,CAAC,CAAC;IACP,CAAC;IAED,OAAO,qBAAqB,CAAC;AACjC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,WAA4B,EAAE,KAAK,GAAG,KAAK;IAC1E,OAAO,QAAQ,CAAC,WAAW,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,kBAAkB,CAAC,CAAC;AACjF,CAAC"}