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

package/dist/index.js

@@ -1,3 +1,115 @@
+// 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
@@ -14,5 +126,4 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-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":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,cAAc,kBAAkB,CAAC"}
+{"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":[]}

package/package.json

@@ -1,14 +1,11 @@
 {
   "name": "@aidc-toolkit/core",
-  "version": "1.0.23-beta",
+  "version": "1.0.24-beta",
   "description": "Core functionality for AIDC Toolkit",
   "type": "module",
   "main": "dist/index.js",
   "homepage": "https://aidc-toolkit.com/",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/aidc-toolkit/core.git"
-  },
+  "repository": "aidc-toolkit/core",
   "bugs": {
     "url": "https://github.com/aidc-toolkit/core/issues"
   },
@@ -20,17 +17,17 @@
   },
   "scripts": {
     "lint": "eslint",
-    "build:core": "rimraf dist && tsc --project",
-    "build:dev": "npm run build:core -- node_modules/@aidc-toolkit/dev/tsconfig-build-dev.json",
-    "build:release": "npm run build:core -- node_modules/@aidc-toolkit/dev/tsconfig-build.json",
+    "build:dev": "tsup --define.mode=dev",
+    "build:release": "tsup",
     "build:doc": "npm run build:dev"
   },
   "devDependencies": {
     "@aidc-toolkit/dev": "beta"
   },
   "dependencies": {
-    "i18next": "^25.6.3",
+    "i18next": "^25.7.0",
     "i18next-browser-languagedetector": "^8.2.0",
-    "i18next-cli-language-detector": "^1.1.8"
+    "i18next-cli-language-detector": "^1.1.8",
+    "tslog": "^4.10.2"
   }
 }

package/src/index.ts

@@ -14,4 +14,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-export * from "./locale/i18n.js";
+export type * from "./type";
+export * from "./type-helper";
+export * from "./logger";
+export * from "./locale/i18n";

package/src/locale/i18n.ts

@@ -34,97 +34,6 @@ export const I18nEnvironments = {
  */
 export type I18nEnvironment = typeof I18nEnvironments[keyof typeof I18nEnvironments];
 
-/**
- * Parse parameter names in a resource string.
- *
- * @param s
- * Resource string.
- *
- * @returns
- * Array of parameter names.
- */
-function parseParameterNames(s: string): string[] {
-    const parameterRegExp = /\{\{.+?}}/g;
-
-    const parameterNames: string[] = [];
-
-    let match: RegExpExecArray | null;
-
-    while ((match = parameterRegExp.exec(s)) !== null) {
-        parameterNames.push(match[1]);
-    }
-
-    return parameterNames;
-}
-
-/**
- * Assert that language resources are a type match for English (default) resources.
- *
- * @param enResources
- * English resources.
- *
- * @param lng
- * Language.
- *
- * @param lngResources
- * Language resources.
- *
- * @param parent
- * Parent key name (set recursively).
- */
-export function i18nAssertValidResources(enResources: object, lng: string, lngResources: object, parent?: string): void {
-    const enResourcesMap = new Map<string, object>(Object.entries(enResources));
-    const lngResourcesMap = new Map<string, object>(Object.entries(lngResources));
-
-    const isLocale = lng.includes("-");
-
-    for (const [enKey, enValue] of enResourcesMap) {
-        const enFullKey = `${parent === undefined ? "" : `${parent}.`}${enKey}`;
-
-        const lngValue = lngResourcesMap.get(enKey);
-
-        if (lngValue !== undefined) {
-            const enValueType = typeof enValue;
-            const lngValueType = typeof lngValue;
-
-            if (lngValueType !== enValueType) {
-                throw new Error(`Mismatched value type ${lngValueType} for key ${enFullKey} in ${lng} resources (expected ${enValueType})`);
-            }
-
-            if (enValueType === "string") {
-                // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Value is known to be string.
-                const enParameterNames = parseParameterNames(enValue as unknown as string);
-
-                // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Value is known to be string.
-                const lngParameterNames = parseParameterNames(lngValue as unknown as string);
-
-                for (const enParameterName of enParameterNames) {
-                    if (!lngParameterNames.includes(enParameterName)) {
-                        throw new Error(`Missing parameter ${enParameterName} for key ${enFullKey} in ${lng} resources`);
-                    }
-                }
-
-                for (const lngParameterName of lngParameterNames) {
-                    if (!enParameterNames.includes(lngParameterName)) {
-                        throw new Error(`Extraneous parameter ${lngParameterName} for key ${enFullKey} in ${lng} resources`);
-                    }
-                }
-            } else if (enValueType === "object") {
-                i18nAssertValidResources(enValue, lng, lngValue, `${parent === undefined ? "" : `${parent}.`}${enKey}`);
-            }
-        // Locale falls back to raw language so ignore if missing.
-        } else if (!isLocale) {
-            throw new Error(`Missing key ${enFullKey} in ${lng} resources`);
-        }
-    }
-
-    for (const [lngKey] of lngResourcesMap) {
-        if (!enResourcesMap.has(lngKey)) {
-            throw new Error(`Extraneous key ${parent === undefined ? "" : `${parent}.`}${lngKey} in ${lng} resources`);
-        }
-    }
-}
-
 /**
  * Convert a string to lower case, skipping words that are all upper case.
  *

package/src/logger.ts

@@ -0,0 +1,47 @@
+import { Logger } from "tslog";
+
+/**
+ * Log levels.
+ */
+export const LogLevels = {
+    Silly: 0,
+    Trace: 1,
+    Debug: 2,
+    Info: 3,
+    Warn: 4,
+    Error: 5,
+    Fatal: 6
+} as const;
+
+/**
+ * Log level.
+ */
+export 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.
+ */
+export function getLogger(logLevel?: string | number): Logger<unknown> {
+    let minLevel: number;
+
+    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 as keyof typeof LogLevels];
+        } else {
+            throw new Error(`Unknown log level ${logLevel}`);
+        }
+    } else {
+        minLevel = logLevel ?? LogLevels.Info;
+    }
+
+    return new Logger({
+        minLevel
+    });
+}

package/src/type-helper.ts

@@ -0,0 +1,87 @@
+/**
+ * Create an object with omitted or picked entries.
+ *
+ * @param omitting
+ * True if omitting.
+ *
+ * @param o
+ * Object.
+ *
+ * @param keys
+ * Keys to omit or pick.
+ *
+ * @returns
+ * Edited object.
+ */
+function 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> {
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Key and value types are known.
+    return Object.fromEntries(Object.entries(o).filter(([key]) => keys.includes(key as K) !== omitting)) as ReturnType<typeof omitOrPick<Omitting, T, K>>;
+}
+
+/**
+ * Create an object with omitted entries.
+ *
+ * @param o
+ * Object.
+ *
+ * @param keys
+ * Keys to omit.
+ *
+ * @returns
+ * Edited object.
+ */
+export function omit<T extends object, K extends keyof T>(o: T, ...keys: K[]): Omit<T, K> {
+    return omitOrPick(true, o, ...keys);
+}
+
+/**
+ * Create an object with picked entries.
+ *
+ * @param o
+ * Object.
+ *
+ * @param keys
+ * Keys to pick.
+ *
+ * @returns
+ * Edited object.
+ */
+export function pick<T extends object, K extends keyof T>(o: T, ...keys: K[]): Pick<T, K> {
+    return omitOrPick(false, o, ...keys);
+}
+
+/**
+ * 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.
+ */
+export 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>> {
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Type is determined by condition.
+    return (key in o ?
+        {
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Force cast.
+            [key]: o[key] as TAsType
+        } :
+        {}
+    ) as ReturnType<typeof propertyAs<TAsType, T, K>>;
+}
+
+/**
+ * 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 function isNullish<T>(argument: T | null | undefined): argument is null | undefined {
+    return argument === null || argument === undefined;
+}

package/src/type.ts

@@ -0,0 +1,44 @@
+/**
+ * Typed function, applicable to any function, stricter than {@link Function}.
+ */
+export 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.
+ */
+export 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.
+ */
+export 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`.
+ */
+export 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.
+ */
+export type NonNullishable<T> = T extends object ? {
+    [P in keyof T]-?: NonNullishable<T[P]>
+} : NonNullable<T>;
+
+/**
+ * Make some keys within a type optional.
+ */
+export 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.
+ */
+export type PropertyKeys<T, TProperty> = {
+    [K in keyof T]: K extends string ? T[K] extends TProperty ? K : never : never;
+}[keyof T];

package/tsup.config.ts

@@ -0,0 +1,3 @@
+import { tsupConfigAIDCToolkit } from "@aidc-toolkit/dev";
+
+export default tsupConfigAIDCToolkit;

package/typedoc.json

@@ -3,7 +3,5 @@
   "extends": [
     "@aidc-toolkit/dev/typedoc.json"
   ],
-  "name": "Core",
-  "tsconfig": "node_modules/@aidc-toolkit/dev/tsconfig-build-dev.json",
-  "gitRevision": "main"
+  "name": "Core"
 }

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,cAAc,kBAAkB,CAAC"}

package/dist/locale/i18n.d.ts

@@ -1,68 +0,0 @@
-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.
- */
-export type I18nEnvironment = typeof I18nEnvironments[keyof typeof I18nEnvironments];
-/**
- * Assert that language resources are a type match for English (default) resources.
- *
- * @param enResources
- * English resources.
- *
- * @param lng
- * Language.
- *
- * @param lngResources
- * Language resources.
- *
- * @param parent
- * Parent key name (set recursively).
- */
-export declare function i18nAssertValidResources(enResources: object, lng: string, lngResources: object, parent?: string): void;
-/**
- * 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

@@ -1 +0,0 @@
-{"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,eAAe,GAAG,OAAO,gBAAgB,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC;AAyBrF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAmDtH;AAgBD;;;;;;;;;;;;;;;;;;;;;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"}