@aidc-toolkit/core 1.0.24-beta → 1.0.26-beta

package/dist/index.d.ts

@@ -1,170 +1,21 @@
-import { Logger } from 'tslog';
-import { i18n, Resource } from 'i18next';
-
-/**
- * Typed function, applicable to any function, stricter than {@link Function}.
- */
-type TypedFunction<TMethod extends (...args: Parameters<TMethod>) => ReturnType<TMethod>> = (...args: Parameters<TMethod>) => ReturnType<TMethod>;
-/**
- * Typed synchronous function, applicable to any function that doesn't return a Promise.
- */
-type TypedSyncFunction<TMethod extends TypedFunction<TMethod>> = [ReturnType<TMethod>] extends [PromiseLike<unknown>] ? never : TypedFunction<TMethod>;
-/**
- * Determine the fundamental promised type. This is stricter than `Awaited\<Type\>` in that it requires a Promise.
- */
-type PromisedType<T> = [T] extends [PromiseLike<infer TPromised>] ? TPromised : never;
-/**
- * Typed asynchronous function, applicable to any function that returns a Promise.
- */
-type TypedAsyncFunction<TMethod extends (...args: Parameters<TMethod>) => PromiseLike<PromisedType<ReturnType<TMethod>>>> = (...args: Parameters<TMethod>) => Promise<PromisedType<ReturnType<TMethod>>>;
-/**
- * Nullishable type. Extends a type by allowing `null` and `undefined`.
- */
-type Nullishable<T> = T | null | undefined;
-/**
- * Non-nullishable type. If T is an object type, it is spread and attributes within it are made non-nullishable.
- * Equivalent to a deep `Required\<T\>` for an object and `NonNullable\<T\>` for any other type.
- */
-type NonNullishable<T> = T extends object ? {
-    [P in keyof T]-?: NonNullishable<T[P]>;
-} : NonNullable<T>;
-/**
- * Make some keys within a type optional.
- */
-type Optional<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
-/**
- * Type to restrict property keys to those that are strings and that support a specified type.
- */
-type PropertyKeys<T, TProperty> = {
-    [K in keyof T]: K extends string ? T[K] extends TProperty ? K : never : never;
-}[keyof T];
-
-/**
- * Create an object with omitted entries.
- *
- * @param o
- * Object.
- *
- * @param keys
- * Keys to omit.
- *
- * @returns
- * Edited object.
- */
-declare function omit<T extends object, K extends keyof T>(o: T, ...keys: K[]): Omit<T, K>;
-/**
- * Create an object with picked entries.
- *
- * @param o
- * Object.
- *
- * @param keys
- * Keys to pick.
- *
- * @returns
- * Edited object.
- */
-declare function pick<T extends object, K extends keyof T>(o: T, ...keys: K[]): Pick<T, K>;
-/**
- * Cast a property as a more narrow type.
- *
- * @param o
- * Object.
- *
- * @param key
- * Key of property to cast.
- *
- * @returns
- * Single-key object with property cast as desired type.
- */
-declare function propertyAs<TAsType extends T[K], T extends object, K extends keyof T>(o: T, key: K): Readonly<Omit<T, K> extends T ? Partial<Record<K, TAsType>> : Record<K, TAsType>>;
-/**
- * Determine if argument is nullish. Application extension may pass `null` or `undefined` to missing parameters.
- *
- * @param argument
- * Argument.
- *
- * @returns
- * True if argument is undefined or null.
- */
-declare function isNullish<T>(argument: T | null | undefined): argument is null | undefined;
-
-/**
- * Log levels.
- */
-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.
- */
-type LogLevel = typeof LogLevels[keyof typeof LogLevels];
-/**
- * Get a simple logger with an optional log level.
- *
- * @param logLevel
- * Log level as enumeration value or string if any.
- *
- * @returns
- * Logger.
- */
-declare function getLogger(logLevel?: string | number): Logger<unknown>;
-
-/**
- * Locale strings type for generic manipulation.
- */
-interface LocaleResources {
-    [key: string]: LocaleResources | string;
-}
-/**
- * Internationalization operating environments.
- */
-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.
- */
-type I18nEnvironment = typeof I18nEnvironments[keyof typeof I18nEnvironments];
-/**
- * Initialize internationalization.
- *
- * @param i18next
- * Internationalization object. As multiple objects exists, 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 resources
- * Resources.
- *
- * @returns
- * Void promise.
- */
-declare function i18nCoreInit(i18next: i18n, environment: I18nEnvironment, debug: boolean, defaultNS: string, ...resources: Resource[]): Promise<void>;
-
-export { type I18nEnvironment, I18nEnvironments, type LocaleResources, type LogLevel, LogLevels, type NonNullishable, type Nullishable, type Optional, type PropertyKeys, type TypedAsyncFunction, type TypedFunction, type TypedSyncFunction, getLogger, i18nCoreInit, isNullish, omit, pick, propertyAs };
+/*!
+ * Copyright © 2024-2025 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.
+ */
+export type * from "./type.js";
+export * from "./type-helper.js";
+export * from "./logger.js";
+export * from "./locale/i18n.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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"}

package/dist/index.js

@@ -1,129 +1,4 @@
-// src/type-helper.ts
-function omitOrPick(omitting, o, ...keys) {
-  return Object.fromEntries(Object.entries(o).filter(([key]) => keys.includes(key) !== omitting));
-}
-function omit(o, ...keys) {
-  return omitOrPick(true, o, ...keys);
-}
-function pick(o, ...keys) {
-  return omitOrPick(false, o, ...keys);
-}
-function propertyAs(o, key) {
-  return key in o ? {
-    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Force cast.
-    [key]: o[key]
-  } : {};
-}
-function isNullish(argument) {
-  return argument === null || argument === void 0;
-}
-
-// src/logger.ts
-import { Logger } from "tslog";
-var LogLevels = {
-  Silly: 0,
-  Trace: 1,
-  Debug: 2,
-  Info: 3,
-  Warn: 4,
-  Error: 5,
-  Fatal: 6
-};
-function getLogger(logLevel) {
-  let minLevel;
-  if (typeof logLevel === "string") {
-    if (logLevel in LogLevels) {
-      minLevel = LogLevels[logLevel];
-    } else {
-      throw new Error(`Unknown log level ${logLevel}`);
-    }
-  } else {
-    minLevel = logLevel ?? LogLevels.Info;
-  }
-  return new Logger({
-    minLevel
-  });
-}
-
-// src/locale/i18n.ts
-import I18nextBrowserLanguageDetector from "i18next-browser-languagedetector";
-import I18nextCLILanguageDetector from "i18next-cli-language-detector";
-var I18nEnvironments = {
-  /**
-   * Command-line interface (e.g., unit tests).
-   */
-  CLI: 0,
-  /**
-   * Web server.
-   */
-  Server: 1,
-  /**
-   * Web browser.
-   */
-  Browser: 2
-};
-function toLowerCase(s) {
-  return s.split(" ").map((word) => /[a-z]/.test(word) ? word.toLowerCase() : word).join(" ");
-}
-async function i18nCoreInit(i18next, environment, debug, defaultNS, ...resources) {
-  if (!i18next.isInitialized) {
-    const mergedResource = {};
-    for (const resource of resources) {
-      for (const [language, resourceLanguage] of Object.entries(resource)) {
-        if (!(language in mergedResource)) {
-          mergedResource[language] = {};
-        }
-        const mergedResourceLanguage = mergedResource[language];
-        for (const [namespace, resourceKey] of Object.entries(resourceLanguage)) {
-          mergedResourceLanguage[namespace] = resourceKey;
-        }
-      }
-    }
-    let module;
-    switch (environment) {
-      case I18nEnvironments.CLI:
-        module = I18nextCLILanguageDetector;
-        break;
-      case I18nEnvironments.Browser:
-        module = I18nextBrowserLanguageDetector;
-        break;
-      default:
-        throw new Error("Not supported");
-    }
-    await i18next.use(module).init({
-      debug,
-      resources: mergedResource,
-      fallbackLng: "en",
-      defaultNS
-    }).then(() => {
-      i18next.services.formatter?.add("toLowerCase", (value) => typeof value === "string" ? toLowerCase(value) : String(value));
-    });
-  }
-}
-export {
-  I18nEnvironments,
-  LogLevels,
-  getLogger,
-  i18nCoreInit,
-  isNullish,
-  omit,
-  pick,
-  propertyAs
-};
-/*!
- * Copyright © 2024-2025 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.
- */
+export * from "./type-helper.js";
+export * from "./logger.js";
+export * from "./locale/i18n.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/type-helper.ts","../src/logger.ts","../src/locale/i18n.ts"],"sourcesContent":["/**\n * Create an object with omitted or picked entries.\n *\n * @param omitting\n * True if omitting.\n *\n * @param o\n * Object.\n *\n * @param keys\n * Keys to omit or pick.\n *\n * @returns\n * Edited object.\n */\nfunction omitOrPick<Omitting extends boolean, T extends object, K extends keyof T>(omitting: Omitting, o: T, ...keys: K[]): Omitting extends true ? Omit<T, K> : Pick<T, K> {\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Key and value types are known.\n    return Object.fromEntries(Object.entries(o).filter(([key]) => keys.includes(key as K) !== omitting)) as ReturnType<typeof omitOrPick<Omitting, T, K>>;\n}\n\n/**\n * Create an object with omitted entries.\n *\n * @param o\n * Object.\n *\n * @param keys\n * Keys to omit.\n *\n * @returns\n * Edited object.\n */\nexport function omit<T extends object, K extends keyof T>(o: T, ...keys: K[]): Omit<T, K> {\n    return omitOrPick(true, o, ...keys);\n}\n\n/**\n * Create an object with picked entries.\n *\n * @param o\n * Object.\n *\n * @param keys\n * Keys to pick.\n *\n * @returns\n * Edited object.\n */\nexport function pick<T extends object, K extends keyof T>(o: T, ...keys: K[]): Pick<T, K> {\n    return omitOrPick(false, o, ...keys);\n}\n\n/**\n * Cast a property as a more narrow type.\n *\n * @param o\n * Object.\n *\n * @param key\n * Key of property to cast.\n *\n * @returns\n * Single-key object with property cast as desired type.\n */\nexport function propertyAs<TAsType extends T[K], T extends object, K extends keyof T>(o: T, key: K): Readonly<Omit<T, K> extends T ? Partial<Record<K, TAsType>> : Record<K, TAsType>> {\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Type is determined by condition.\n    return (key in o ?\n        {\n            // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Force cast.\n            [key]: o[key] as TAsType\n        } :\n        {}\n    ) as ReturnType<typeof propertyAs<TAsType, T, K>>;\n}\n\n/**\n * Determine if argument is nullish. Application extension may pass `null` or `undefined` to missing parameters.\n *\n * @param argument\n * Argument.\n *\n * @returns\n * True if argument is undefined or null.\n */\nexport function isNullish<T>(argument: T | null | undefined): argument is null | undefined {\n    return argument === null || argument === undefined;\n}\n","import { Logger } from \"tslog\";\n\n/**\n * Log levels.\n */\nexport const LogLevels = {\n    Silly: 0,\n    Trace: 1,\n    Debug: 2,\n    Info: 3,\n    Warn: 4,\n    Error: 5,\n    Fatal: 6\n} as const;\n\n/**\n * Log level.\n */\nexport type LogLevel = typeof LogLevels[keyof typeof LogLevels];\n\n/**\n * Get a simple logger with an optional log level.\n *\n * @param logLevel\n * Log level as enumeration value or string if any.\n *\n * @returns\n * Logger.\n */\nexport function getLogger(logLevel?: string | number): Logger<unknown> {\n    let minLevel: number;\n\n    if (typeof logLevel === \"string\") {\n        if (logLevel in LogLevels) {\n            // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- String exists as a key.\n            minLevel = LogLevels[logLevel as keyof typeof LogLevels];\n        } else {\n            throw new Error(`Unknown log level ${logLevel}`);\n        }\n    } else {\n        minLevel = logLevel ?? LogLevels.Info;\n    }\n\n    return new Logger({\n        minLevel\n    });\n}\n","import type { i18n, LanguageDetectorModule, Resource } from \"i18next\";\nimport I18nextBrowserLanguageDetector from \"i18next-browser-languagedetector\";\nimport I18nextCLILanguageDetector from \"i18next-cli-language-detector\";\n\n/**\n * Locale strings type for generic manipulation.\n */\nexport interface LocaleResources {\n    [key: string]: LocaleResources | string;\n}\n\n/**\n * Internationalization operating environments.\n */\nexport const I18nEnvironments = {\n    /**\n     * Command-line interface (e.g., unit tests).\n     */\n    CLI: 0,\n\n    /**\n     * Web server.\n     */\n    Server: 1,\n\n    /**\n     * Web browser.\n     */\n    Browser: 2\n} as const;\n\n/**\n * Internationalization operating environment.\n */\nexport type I18nEnvironment = typeof I18nEnvironments[keyof typeof I18nEnvironments];\n\n/**\n * Convert a string to lower case, skipping words that are all upper case.\n *\n * @param s\n * String.\n *\n * @returns\n * Lower case string.\n */\nfunction toLowerCase(s: string): string {\n    // Words with no lower case letters are preserved as they are likely mnemonics.\n    return s.split(\" \").map(word => /[a-z]/.test(word) ? word.toLowerCase() : word).join(\" \");\n}\n\n/**\n * Initialize internationalization.\n *\n * @param i18next\n * Internationalization object. As multiple objects exists, this parameter represents the one for the module for which\n * internationalization is being initialized.\n *\n * @param environment\n * Environment in which the application is running.\n *\n * @param debug\n * Debug setting.\n *\n * @param defaultNS\n * Default namespace.\n *\n * @param resources\n * Resources.\n *\n * @returns\n * Void promise.\n */\nexport async function i18nCoreInit(i18next: i18n, environment: I18nEnvironment, debug: boolean, defaultNS: string, ...resources: Resource[]): Promise<void> {\n    // Initialization may be called more than once.\n    if (!i18next.isInitialized) {\n        const mergedResource: Resource = {};\n\n        // Merge resources.\n        for (const resource of resources) {\n            // Merge languages.\n            for (const [language, resourceLanguage] of Object.entries(resource)) {\n                if (!(language in mergedResource)) {\n                    mergedResource[language] = {};\n                }\n\n                const mergedResourceLanguage = mergedResource[language];\n\n                // Merge namespaces.\n                for (const [namespace, resourceKey] of Object.entries(resourceLanguage)) {\n                    mergedResourceLanguage[namespace] = resourceKey;\n                }\n            }\n        }\n\n        let module: Parameters<typeof i18next.use>[0];\n\n        switch (environment) {\n            case I18nEnvironments.CLI:\n                // TODO Refactor when https://github.com/neet/i18next-cli-language-detector/issues/281 resolved.\n                // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Per above.\n                module = I18nextCLILanguageDetector as unknown as LanguageDetectorModule;\n                break;\n\n            case I18nEnvironments.Browser:\n                module = I18nextBrowserLanguageDetector;\n                break;\n\n            default:\n                throw new Error(\"Not supported\");\n        }\n\n        await i18next.use(module).init({\n            debug,\n            resources: mergedResource,\n            fallbackLng: \"en\",\n            defaultNS\n        }).then(() => {\n            // Add toLowerCase function.\n            i18next.services.formatter?.add(\"toLowerCase\", value => typeof value === \"string\" ? toLowerCase(value) : String(value));\n        });\n    }\n}\n"],"mappings":";AAeA,SAAS,WAA0E,UAAoB,MAAS,MAA4D;AAExK,SAAO,OAAO,YAAY,OAAO,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM,KAAK,SAAS,GAAQ,MAAM,QAAQ,CAAC;AACvG;AAcO,SAAS,KAA0C,MAAS,MAAuB;AACtF,SAAO,WAAW,MAAM,GAAG,GAAG,IAAI;AACtC;AAcO,SAAS,KAA0C,MAAS,MAAuB;AACtF,SAAO,WAAW,OAAO,GAAG,GAAG,IAAI;AACvC;AAcO,SAAS,WAAsE,GAAM,KAA2F;AAEnL,SAAQ,OAAO,IACX;AAAA;AAAA,IAEI,CAAC,GAAG,GAAG,EAAE,GAAG;AAAA,EAChB,IACA,CAAC;AAET;AAWO,SAAS,UAAa,UAA8D;AACvF,SAAO,aAAa,QAAQ,aAAa;AAC7C;;;ACtFA,SAAS,cAAc;AAKhB,IAAM,YAAY;AAAA,EACrB,OAAO;AAAA,EACP,OAAO;AAAA,EACP,OAAO;AAAA,EACP,MAAM;AAAA,EACN,MAAM;AAAA,EACN,OAAO;AAAA,EACP,OAAO;AACX;AAgBO,SAAS,UAAU,UAA6C;AACnE,MAAI;AAEJ,MAAI,OAAO,aAAa,UAAU;AAC9B,QAAI,YAAY,WAAW;AAEvB,iBAAW,UAAU,QAAkC;AAAA,IAC3D,OAAO;AACH,YAAM,IAAI,MAAM,qBAAqB,QAAQ,EAAE;AAAA,IACnD;AAAA,EACJ,OAAO;AACH,eAAW,YAAY,UAAU;AAAA,EACrC;AAEA,SAAO,IAAI,OAAO;AAAA,IACd;AAAA,EACJ,CAAC;AACL;;;AC7CA,OAAO,oCAAoC;AAC3C,OAAO,gCAAgC;AAYhC,IAAM,mBAAmB;AAAA;AAAA;AAAA;AAAA,EAI5B,KAAK;AAAA;AAAA;AAAA;AAAA,EAKL,QAAQ;AAAA;AAAA;AAAA;AAAA,EAKR,SAAS;AACb;AAgBA,SAAS,YAAY,GAAmB;AAEpC,SAAO,EAAE,MAAM,GAAG,EAAE,IAAI,UAAQ,QAAQ,KAAK,IAAI,IAAI,KAAK,YAAY,IAAI,IAAI,EAAE,KAAK,GAAG;AAC5F;AAwBA,eAAsB,aAAa,SAAe,aAA8B,OAAgB,cAAsB,WAAsC;AAExJ,MAAI,CAAC,QAAQ,eAAe;AACxB,UAAM,iBAA2B,CAAC;AAGlC,eAAW,YAAY,WAAW;AAE9B,iBAAW,CAAC,UAAU,gBAAgB,KAAK,OAAO,QAAQ,QAAQ,GAAG;AACjE,YAAI,EAAE,YAAY,iBAAiB;AAC/B,yBAAe,QAAQ,IAAI,CAAC;AAAA,QAChC;AAEA,cAAM,yBAAyB,eAAe,QAAQ;AAGtD,mBAAW,CAAC,WAAW,WAAW,KAAK,OAAO,QAAQ,gBAAgB,GAAG;AACrE,iCAAuB,SAAS,IAAI;AAAA,QACxC;AAAA,MACJ;AAAA,IACJ;AAEA,QAAI;AAEJ,YAAQ,aAAa;AAAA,MACjB,KAAK,iBAAiB;AAGlB,iBAAS;AACT;AAAA,MAEJ,KAAK,iBAAiB;AAClB,iBAAS;AACT;AAAA,MAEJ;AACI,cAAM,IAAI,MAAM,eAAe;AAAA,IACvC;AAEA,UAAM,QAAQ,IAAI,MAAM,EAAE,KAAK;AAAA,MAC3B;AAAA,MACA,WAAW;AAAA,MACX,aAAa;AAAA,MACb;AAAA,IACJ,CAAC,EAAE,KAAK,MAAM;AAEV,cAAQ,SAAS,WAAW,IAAI,eAAe,WAAS,OAAO,UAAU,WAAW,YAAY,KAAK,IAAI,OAAO,KAAK,CAAC;AAAA,IAC1H,CAAC;AAAA,EACL;AACJ;","names":[]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAiBA,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC"}

package/dist/locale/i18n.d.ts

@@ -0,0 +1,56 @@
+import type { i18n, Resource } from "i18next";
+/**
+ * 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];
+/**
+ * Initialize internationalization.
+ *
+ * @param i18next
+ * Internationalization object. As multiple objects exists, 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 resources
+ * Resources.
+ *
+ * @returns
+ * Void promise.
+ */
+export declare function i18nCoreInit(i18next: i18n, environment: I18nEnvironment, debug: boolean, defaultNS: string, ...resources: Resource[]): Promise<void>;
+//# 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,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"}

package/dist/locale/i18n.js

@@ -0,0 +1,97 @@
+import I18nextBrowserLanguageDetector from "i18next-browser-languagedetector";
+import I18nextCLILanguageDetector from "i18next-cli-language-detector";
+/**
+ * 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 s
+ * String.
+ *
+ * @returns
+ * Lower case string.
+ */
+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(" ");
+}
+/**
+ * Initialize internationalization.
+ *
+ * @param i18next
+ * Internationalization object. As multiple objects exists, 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 resources
+ * Resources.
+ *
+ * @returns
+ * Void promise.
+ */
+export async function i18nCoreInit(i18next, environment, debug, defaultNS, ...resources) {
+    // Initialization may be called more than once.
+    if (!i18next.isInitialized) {
+        const mergedResource = {};
+        // Merge resources.
+        for (const resource of resources) {
+            // Merge languages.
+            for (const [language, resourceLanguage] of Object.entries(resource)) {
+                if (!(language in mergedResource)) {
+                    mergedResource[language] = {};
+                }
+                const mergedResourceLanguage = mergedResource[language];
+                // Merge namespaces.
+                for (const [namespace, resourceKey] of Object.entries(resourceLanguage)) {
+                    mergedResourceLanguage[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({
+            debug,
+            resources: mergedResource,
+            fallbackLng: "en",
+            defaultNS
+        }).then(() => {
+            // Add toLowerCase function.
+            i18next.services.formatter?.add("toLowerCase", value => typeof value === "string" ? toLowerCase(value) : String(value));
+        });
+    }
+}
+//# 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":"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"}

package/dist/logger.d.ts

@@ -0,0 +1,32 @@
+import { 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 a simple logger with an optional log level.
+ *
+ * @param logLevel
+ * Log level as enumeration value or string.
+ *
+ * @returns
+ * Logger.
+ */
+export declare function getLogger(logLevel?: string | number): Logger<unknown>;
+//# 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,MAAM,EAAE,MAAM,OAAO,CAAC;AAE/B;;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,SAAS,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,CAiBrE"}

package/dist/logger.js

@@ -0,0 +1,41 @@
+import { Logger } from "tslog";
+/**
+ * Log levels.
+ */
+export const LogLevels = {
+    Silly: 0,
+    Trace: 1,
+    Debug: 2,
+    Info: 3,
+    Warn: 4,
+    Error: 5,
+    Fatal: 6
+};
+/**
+ * Get a simple logger with an optional log level.
+ *
+ * @param logLevel
+ * Log level as enumeration value or string.
+ *
+ * @returns
+ * Logger.
+ */
+export function getLogger(logLevel) {
+    let minLevel;
+    if (typeof logLevel === "string") {
+        if (logLevel in LogLevels) {
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- String exists as a key.
+            minLevel = LogLevels[logLevel];
+        }
+        else {
+            throw new Error(`Unknown log level ${logLevel}`);
+        }
+    }
+    else {
+        minLevel = logLevel ?? LogLevels.Info;
+    }
+    return new Logger({
+        minLevel
+    });
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAE/B;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACrB,KAAK,EAAE,CAAC;IACR,KAAK,EAAE,CAAC;IACR,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;IACR,KAAK,EAAE,CAAC;CACF,CAAC;AAYX;;;;;;;;GAQG;AACH,MAAM,UAAU,SAAS,CAAC,QAA0B;IAChD,IAAI,QAAgB,CAAC;IAErB,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC/B,IAAI,QAAQ,IAAI,SAAS,EAAE,CAAC;YACxB,kGAAkG;YAClG,QAAQ,GAAG,SAAS,CAAC,QAAuB,CAAC,CAAC;QAClD,CAAC;aAAM,CAAC;YACJ,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,EAAE,CAAC,CAAC;QACrD,CAAC;IACL,CAAC;SAAM,CAAC;QACJ,QAAQ,GAAG,QAAQ,IAAI,SAAS,CAAC,IAAI,CAAC;IAC1C,CAAC;IAED,OAAO,IAAI,MAAM,CAAC;QACd,QAAQ;KACX,CAAC,CAAC;AACP,CAAC"}

package/dist/type-helper.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Create an object with omitted entries.
+ *
+ * @template T
+ * Object type.
+ *
+ * @template K
+ * Object key type.
+ *
+ * @param o
+ * Object.
+ *
+ * @param keys
+ * Keys to omit.
+ *
+ * @returns
+ * Edited object.
+ */
+export declare function omit<T extends object, K extends keyof T>(o: T, ...keys: K[]): Omit<T, K>;
+/**
+ * Create an object with picked entries.
+ *
+ * @template T
+ * Object type.
+ *
+ * @template K
+ * Object key type.
+ *
+ * @param o
+ * Object.
+ *
+ * @param keys
+ * Keys to pick.
+ *
+ * @returns
+ * Edited object.
+ */
+export declare function pick<T extends object, K extends keyof T>(o: T, ...keys: K[]): Pick<T, K>;
+/**
+ * Cast a property as a more narrow type.
+ *
+ * @template T
+ * Object type.
+ *
+ * @template K
+ * Object key type.
+ *
+ * @template TAsType
+ * Desired type.
+ *
+ * @param o
+ * Object.
+ *
+ * @param key
+ * Key of property to cast.
+ *
+ * @returns
+ * Single-key object with property cast as desired type.
+ */
+export declare function propertyAs<T extends object, K extends keyof T, TAsType extends T[K]>(o: T, key: K): Readonly<Omit<T, K> extends T ? Partial<Record<K, TAsType>> : Record<K, TAsType>>;
+/**
+ * Determine if argument is nullish. Application extension may pass `null` or `undefined` to missing parameters.
+ *
+ * @param argument
+ * Argument.
+ *
+ * @returns
+ * True if argument is undefined or null.
+ */
+export declare function isNullish(argument: unknown): argument is null | undefined;
+//# sourceMappingURL=type-helper.d.ts.map

package/dist/type-helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-helper.d.ts","sourceRoot":"","sources":["../src/type-helper.ts"],"names":[],"mappings":"AA6BA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAExF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAExF;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CASrL;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,IAAI,GAAG,SAAS,CAEzE"}