@aidc-toolkit/core 0.9.13-beta → 0.9.15-beta

package/dist/index.cjs

@@ -1,4 +1,119 @@
-"use strict";var b=Object.create;var d=Object.defineProperty;var j=Object.getOwnPropertyDescriptor;var R=Object.getOwnPropertyNames;var h=Object.getPrototypeOf,k=Object.prototype.hasOwnProperty;var x=(o,e)=>{for(var t in e)d(o,t,{get:e[t],enumerable:!0})},l=(o,e,t,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let n of R(e))!k.call(o,n)&&n!==t&&d(o,n,{get:()=>e[n],enumerable:!(r=j(e,n))||r.enumerable});return o};var p=(o,e,t)=>(t=o!=null?b(h(o)):{},l(e||!o||!o.__esModule?d(t,"default",{value:o,enumerable:!0}):t,o)),C=o=>l(d({},"__esModule",{value:!0}),o);var V={};x(V,{I18NEnvironment:()=>y,i18nAssertValidResources:()=>m,i18nCoreInit:()=>I});module.exports=C(V);var w=p(require("i18next-browser-languagedetector"),1),$=p(require("i18next-cli-language-detector"),1),y=(r=>(r[r.CLI=0]="CLI",r[r.Server=1]="Server",r[r.Browser=2]="Browser",r))(y||{});function m(o,e,t,r){let n=new Map(Object.entries(o)),i=new Map(Object.entries(t)),u=e.includes("-");for(let[s,c]of n){let a=i.get(s);if(a!==void 0){let f=typeof c,g=typeof a;if(g!==f)throw new Error(`Invalid value type ${g} for key ${r===void 0?"":`${r}.`}${s} in ${e} resources`);f==="object"&&m(c,e,a,`${r===void 0?"":`${r}.`}${s}`)}else if(!u)throw new Error(`Missing key ${r===void 0?"":`${r}.`}${s} from ${e} resources`)}for(let[s]of i)if(!n.has(s))throw new Error(`Extraneous key ${r===void 0?"":`${r}.`}${s} in ${e} resources`)}function M(o){return o.split(" ").map(e=>/[a-z]/.test(e)?e.toLowerCase():e).join(" ")}async function I(o,e,t,r,...n){if(!o.isInitialized){let i={};for(let s of n)for(let[c,a]of Object.entries(s)){c in i||(i[c]={});let f=i[c];for(let[g,L]of Object.entries(a))f[g]=L}let u;switch(e){case 0:u=$.default;break;case 2:u=w.default;break;default:throw new Error("Not supported")}await o.use(u).init({debug:t,resources:i,fallbackLng:"en",defaultNS:r}).then(()=>{o.services.formatter?.add("toLowerCase",s=>typeof s=="string"?M(s):String(s))})}}0&&(module.exports={I18NEnvironment,i18nAssertValidResources,i18nCoreInit});
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  I18NEnvironment: () => I18NEnvironment,
+  i18nAssertValidResources: () => i18nAssertValidResources,
+  i18nCoreInit: () => i18nCoreInit
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/locale/i18n.ts
+var import_i18next_browser_languagedetector = __toESM(require("i18next-browser-languagedetector"), 1);
+var import_i18next_cli_language_detector = __toESM(require("i18next-cli-language-detector"), 1);
+var I18NEnvironment = /* @__PURE__ */ ((I18NEnvironment2) => {
+  I18NEnvironment2[I18NEnvironment2["CLI"] = 0] = "CLI";
+  I18NEnvironment2[I18NEnvironment2["Server"] = 1] = "Server";
+  I18NEnvironment2[I18NEnvironment2["Browser"] = 2] = "Browser";
+  return I18NEnvironment2;
+})(I18NEnvironment || {});
+function i18nAssertValidResources(enResources, lng, lngResources, parent) {
+  const enResourcesMap = new Map(Object.entries(enResources));
+  const lngResourcesMap = new Map(Object.entries(lngResources));
+  const isLocale = lng.includes("-");
+  for (const [enKey, enValue] of enResourcesMap) {
+    const lngValue = lngResourcesMap.get(enKey);
+    if (lngValue !== void 0) {
+      const enValueType = typeof enValue;
+      const lngValueType = typeof lngValue;
+      if (lngValueType !== enValueType) {
+        throw new Error(`Invalid value type ${lngValueType} for key ${parent === void 0 ? "" : `${parent}.`}${enKey} in ${lng} resources`);
+      }
+      if (enValueType === "object") {
+        i18nAssertValidResources(enValue, lng, lngValue, `${parent === void 0 ? "" : `${parent}.`}${enKey}`);
+      }
+    } else if (!isLocale) {
+      throw new Error(`Missing key ${parent === void 0 ? "" : `${parent}.`}${enKey} from ${lng} resources`);
+    }
+  }
+  for (const [lngKey] of lngResourcesMap) {
+    if (!enResourcesMap.has(lngKey)) {
+      throw new Error(`Extraneous key ${parent === void 0 ? "" : `${parent}.`}${lngKey} in ${lng} resources`);
+    }
+  }
+}
+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 module2;
+    switch (environment) {
+      case 0 /* CLI */:
+        module2 = import_i18next_cli_language_detector.default;
+        break;
+      case 2 /* Browser */:
+        module2 = import_i18next_browser_languagedetector.default;
+        break;
+      default:
+        throw new Error("Not supported");
+    }
+    await i18next.use(module2).init({
+      debug,
+      resources: mergedResource,
+      fallbackLng: "en",
+      defaultNS
+    }).then(() => {
+      i18next.services.formatter?.add("toLowerCase", (value) => typeof value === "string" ? toLowerCase(value) : String(value));
+    });
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  I18NEnvironment,
+  i18nAssertValidResources,
+  i18nCoreInit
+});
 /*!
  * Copyright © 2024-2025 Dolphin Data Development Ltd. and AIDC Toolkit
  * contributors

package/dist/index.d.cts

@@ -1,5 +1,11 @@
 import { i18n, Resource } from 'i18next';
 
+/**
+ * Locale strings type for generic manipulation.
+ */
+interface LocaleStrings {
+    [key: string]: LocaleStrings | string;
+}
 /**
  * Internationalization operating environment.
  */
@@ -57,4 +63,4 @@ declare function i18nAssertValidResources(enResources: object, lng: string, lngR
  */
 declare function i18nCoreInit(i18next: i18n, environment: I18NEnvironment, debug: boolean, defaultNS: string, ...resources: Resource[]): Promise<void>;
 
-export { I18NEnvironment, i18nAssertValidResources, i18nCoreInit };
+export { I18NEnvironment, type LocaleStrings, i18nAssertValidResources, i18nCoreInit };

package/dist/index.d.ts

@@ -1,60 +1,18 @@
-import { i18n, Resource } from 'i18next';
-
-/**
- * Internationalization operating environment.
- */
-declare enum I18NEnvironment {
-    /**
-     * Command-line interface (e.g., unit tests).
-     */
-    CLI = 0,
-    /**
-     * Web server.
-     */
-    Server = 1,
-    /**
-     * Web browser.
-     */
-    Browser = 2
-}
-/**
- * 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).
- */
-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.
+/*!
+ * Copyright © 2024-2025 Dolphin Data Development Ltd. and AIDC Toolkit
+ * contributors
  *
- * @param defaultNS
- * Default namespace.
+ * 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
  *
- * @param resources
- * Resources.
+ *     https://www.apache.org/licenses/LICENSE-2.0
  *
- * @returns
- * Void promise.
+ * 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.
  */
-declare function i18nCoreInit(i18next: i18n, environment: I18NEnvironment, debug: boolean, defaultNS: string, ...resources: Resource[]): Promise<void>;
-
-export { I18NEnvironment, i18nAssertValidResources, i18nCoreInit };
+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,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -1,4 +1,80 @@
-import l from"i18next-browser-languagedetector";import p from"i18next-cli-language-detector";var w=(e=>(e[e.CLI=0]="CLI",e[e.Server=1]="Server",e[e.Browser=2]="Browser",e))(w||{});function $(s,r,g,e){let u=new Map(Object.entries(s)),t=new Map(Object.entries(g)),i=r.includes("-");for(let[o,n]of u){let c=t.get(o);if(c!==void 0){let a=typeof n,f=typeof c;if(f!==a)throw new Error(`Invalid value type ${f} for key ${e===void 0?"":`${e}.`}${o} in ${r} resources`);a==="object"&&$(n,r,c,`${e===void 0?"":`${e}.`}${o}`)}else if(!i)throw new Error(`Missing key ${e===void 0?"":`${e}.`}${o} from ${r} resources`)}for(let[o]of t)if(!u.has(o))throw new Error(`Extraneous key ${e===void 0?"":`${e}.`}${o} in ${r} resources`)}function y(s){return s.split(" ").map(r=>/[a-z]/.test(r)?r.toLowerCase():r).join(" ")}async function b(s,r,g,e,...u){if(!s.isInitialized){let t={};for(let o of u)for(let[n,c]of Object.entries(o)){n in t||(t[n]={});let a=t[n];for(let[f,d]of Object.entries(c))a[f]=d}let i;switch(r){case 0:i=p;break;case 2:i=l;break;default:throw new Error("Not supported")}await s.use(i).init({debug:g,resources:t,fallbackLng:"en",defaultNS:e}).then(()=>{s.services.formatter?.add("toLowerCase",o=>typeof o=="string"?y(o):String(o))})}}export{w as I18NEnvironment,$ as i18nAssertValidResources,b as i18nCoreInit};
+// src/locale/i18n.ts
+import I18nextBrowserLanguageDetector from "i18next-browser-languagedetector";
+import I18nextCLILanguageDetector from "i18next-cli-language-detector";
+var I18NEnvironment = /* @__PURE__ */ ((I18NEnvironment2) => {
+  I18NEnvironment2[I18NEnvironment2["CLI"] = 0] = "CLI";
+  I18NEnvironment2[I18NEnvironment2["Server"] = 1] = "Server";
+  I18NEnvironment2[I18NEnvironment2["Browser"] = 2] = "Browser";
+  return I18NEnvironment2;
+})(I18NEnvironment || {});
+function i18nAssertValidResources(enResources, lng, lngResources, parent) {
+  const enResourcesMap = new Map(Object.entries(enResources));
+  const lngResourcesMap = new Map(Object.entries(lngResources));
+  const isLocale = lng.includes("-");
+  for (const [enKey, enValue] of enResourcesMap) {
+    const lngValue = lngResourcesMap.get(enKey);
+    if (lngValue !== void 0) {
+      const enValueType = typeof enValue;
+      const lngValueType = typeof lngValue;
+      if (lngValueType !== enValueType) {
+        throw new Error(`Invalid value type ${lngValueType} for key ${parent === void 0 ? "" : `${parent}.`}${enKey} in ${lng} resources`);
+      }
+      if (enValueType === "object") {
+        i18nAssertValidResources(enValue, lng, lngValue, `${parent === void 0 ? "" : `${parent}.`}${enKey}`);
+      }
+    } else if (!isLocale) {
+      throw new Error(`Missing key ${parent === void 0 ? "" : `${parent}.`}${enKey} from ${lng} resources`);
+    }
+  }
+  for (const [lngKey] of lngResourcesMap) {
+    if (!enResourcesMap.has(lngKey)) {
+      throw new Error(`Extraneous key ${parent === void 0 ? "" : `${parent}.`}${lngKey} in ${lng} resources`);
+    }
+  }
+}
+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 0 /* CLI */:
+        module = I18nextCLILanguageDetector;
+        break;
+      case 2 /* 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 {
+  I18NEnvironment,
+  i18nAssertValidResources,
+  i18nCoreInit
+};
 /*!
  * Copyright © 2024-2025 Dolphin Data Development Ltd. and AIDC Toolkit
  * contributors

package/dist/locale/i18n.d.ts

@@ -0,0 +1,64 @@
+import type { i18n, Resource } from "i18next";
+/**
+ * Locale strings type for generic manipulation.
+ */
+export interface LocaleStrings {
+    [key: string]: LocaleStrings | string;
+}
+/**
+ * Internationalization operating environment.
+ */
+export declare enum I18NEnvironment {
+    /**
+     * Command-line interface (e.g., unit tests).
+     */
+    CLI = 0,
+    /**
+     * Web server.
+     */
+    Server = 1,
+    /**
+     * Web browser.
+     */
+    Browser = 2
+}
+/**
+ * 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

@@ -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,aAAa;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,MAAM,CAAC;CACzC;AAED;;GAEG;AACH,oBAAY,eAAe;IACvB;;OAEG;IACH,GAAG,IAAA;IAEH;;OAEG;IACH,MAAM,IAAA;IAEN;;OAEG;IACH,OAAO,IAAA;CACV;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CA+BtH;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"}

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@aidc-toolkit/core",
-  "version": "0.9.13-beta",
+  "version": "0.9.15-beta",
   "description": "Core functionality for AIDC Toolkit",
   "type": "module",
   "main": "dist/index.js",
-  "homepage": "https://github.com/aidc-toolkit",
+  "homepage": "https://aidc-toolkit.com/",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/aidc-toolkit/core.git"
@@ -19,18 +19,20 @@
     "url": "https://www.linkedin.com/in/kdean"
   },
   "scripts": {
-    "lint": "eslint .",
-    "build:core": "tsup src/index.ts --format cjs,esm --dts --clean",
-    "build:dev": "npm run build:core && tsc src/index.ts --outDir dist --target esnext --moduleResolution nodenext --module nodenext --emitDeclarationOnly --declaration --declarationMap",
+    "update-aidc-toolkit": "npm update @aidc-toolkit/dev",
+    "lint": "eslint",
+    "build:core": "tsup --config node_modules/@aidc-toolkit/dev/tsup.config.ts",
+    "build:dev": "npm run build:core && tsc --project node_modules/@aidc-toolkit/dev/tsconfig-declaration.json",
     "build:release": "npm run build:core -- --minify",
+    "build:doc": "npm run build:dev",
     "publish-dev": "publish-dev"
   },
   "devDependencies": {
-    "@aidc-toolkit/dev": "^0.9.13-beta"
+    "@aidc-toolkit/dev": "^0.9.15-beta"
   },
   "dependencies": {
     "i18next": "^24.2.2",
-    "i18next-browser-languagedetector": "^8.0.3",
+    "i18next-browser-languagedetector": "^8.0.4",
     "i18next-cli-language-detector": "^1.1.8"
   }
 }

package/src/locale/i18n.ts

@@ -2,6 +2,13 @@ import type { i18n, LanguageDetectorModule, Resource } from "i18next";
 import I18nextBrowserLanguageDetector from "i18next-browser-languagedetector";
 import I18nextCLILanguageDetector from "i18next-cli-language-detector";
 
+/**
+ * Locale strings type for generic manipulation.
+ */
+export interface LocaleStrings {
+    [key: string]: LocaleStrings | string;
+}
+
 /**
  * Internationalization operating environment.
  */