@aidc-toolkit/core 0.9.3 → 0.9.5

package/.github/workflows/build-publish.yml

@@ -0,0 +1,21 @@
+name: Build and publish
+
+on:
+  release:
+    types:
+      - published
+
+jobs:
+  build-and-publish:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Build and publish core
+        uses: aidc-toolkit/dev/.github/actions/build-publish@main
+        with:
+          project: core
+          node_version: ${{ vars.NODE_VERSION }}
+          node_auth_token: ${{ secrets.NODE_AUTH_TOKEN }}
+          no_test: true
+          terminal_pre_build: ${{ vars.TERMINAL_PRE_BUILD }}
+          terminal_post_build: ${{ vars.TERMINAL_POST_BUILD }}

package/dist/index.cjs

@@ -0,0 +1,128 @@
+"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 src_exports = {};
+__export(src_exports, {
+  I18NEnvironment: () => I18NEnvironment,
+  i18nAddResourceBundle: () => i18nAddResourceBundle,
+  i18nAssertValidResources: () => i18nAssertValidResources,
+  i18nInit: () => i18nInit,
+  i18next: () => i18n_default
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/locale/i18n.ts
+var import_i18next = __toESM(require("i18next"), 1);
+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 i18n_default = import_i18next.default;
+var pendingResourceBundles = [];
+var I18NEnvironment = /* @__PURE__ */ ((I18NEnvironment2) => {
+  I18NEnvironment2[I18NEnvironment2["CLI"] = 0] = "CLI";
+  I18NEnvironment2[I18NEnvironment2["Server"] = 1] = "Server";
+  I18NEnvironment2[I18NEnvironment2["Browser"] = 2] = "Browser";
+  return I18NEnvironment2;
+})(I18NEnvironment || {});
+async function i18nInit(environment, debug = false) {
+  let initialized;
+  if (pendingResourceBundles !== void 0) {
+    initialized = true;
+    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");
+    }
+    const initResourceBundles = pendingResourceBundles;
+    pendingResourceBundles = void 0;
+    await import_i18next.default.use(module2).init({
+      fallbackLng: "en",
+      debug,
+      resources: {}
+    }).then(() => {
+      import_i18next.default.services.formatter?.add("toLowerCase", (value) => value.toLowerCase());
+      for (const initResourceBundle of initResourceBundles) {
+        i18nAddResourceBundle(initResourceBundle.lng, initResourceBundle.ns, initResourceBundle.resources);
+      }
+    });
+  } else {
+    initialized = false;
+  }
+  return initialized;
+}
+function i18nAddResourceBundle(lng, ns, resources) {
+  if (pendingResourceBundles !== void 0) {
+    pendingResourceBundles.push({
+      lng,
+      ns,
+      resources
+    });
+  } else {
+    import_i18next.default.addResourceBundle(lng, ns, resources);
+  }
+}
+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`);
+    }
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  I18NEnvironment,
+  i18nAddResourceBundle,
+  i18nAssertValidResources,
+  i18nInit,
+  i18next
+});

package/dist/index.d.cts

@@ -0,0 +1,64 @@
+import i18next from 'i18next';
+export { default as i18next } 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
+}
+/**
+ * Initialize internationalization.
+ *
+ * @param environment
+ * Environment in which the application is running.
+ *
+ * @param debug
+ * Debug setting.
+ *
+ * @returns
+ * True if initialization was completed, false if skipped (already initialized).
+ */
+declare function i18nInit(environment: I18NEnvironment, debug?: boolean): Promise<boolean>;
+/**
+ * Add a resource bundle.
+ *
+ * @param lng
+ * Language.
+ *
+ * @param ns
+ * Namespace.
+ *
+ * @param resources
+ * Resources.
+ */
+declare function i18nAddResourceBundle(lng: string, ns: string, resources: object): void;
+/**
+ * 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;
+
+export { I18NEnvironment, i18nAddResourceBundle, i18nAssertValidResources, i18nInit };

package/dist/index.d.ts

@@ -0,0 +1,64 @@
+import i18next from 'i18next';
+export { default as i18next } 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
+}
+/**
+ * Initialize internationalization.
+ *
+ * @param environment
+ * Environment in which the application is running.
+ *
+ * @param debug
+ * Debug setting.
+ *
+ * @returns
+ * True if initialization was completed, false if skipped (already initialized).
+ */
+declare function i18nInit(environment: I18NEnvironment, debug?: boolean): Promise<boolean>;
+/**
+ * Add a resource bundle.
+ *
+ * @param lng
+ * Language.
+ *
+ * @param ns
+ * Namespace.
+ *
+ * @param resources
+ * Resources.
+ */
+declare function i18nAddResourceBundle(lng: string, ns: string, resources: object): void;
+/**
+ * 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;
+
+export { I18NEnvironment, i18nAddResourceBundle, i18nAssertValidResources, i18nInit };

package/dist/index.js

@@ -0,0 +1,87 @@
+// src/locale/i18n.ts
+import i18next from "i18next";
+import I18nextBrowserLanguageDetector from "i18next-browser-languagedetector";
+import I18nextCLILanguageDetector from "i18next-cli-language-detector";
+var i18n_default = i18next;
+var pendingResourceBundles = [];
+var I18NEnvironment = /* @__PURE__ */ ((I18NEnvironment2) => {
+  I18NEnvironment2[I18NEnvironment2["CLI"] = 0] = "CLI";
+  I18NEnvironment2[I18NEnvironment2["Server"] = 1] = "Server";
+  I18NEnvironment2[I18NEnvironment2["Browser"] = 2] = "Browser";
+  return I18NEnvironment2;
+})(I18NEnvironment || {});
+async function i18nInit(environment, debug = false) {
+  let initialized;
+  if (pendingResourceBundles !== void 0) {
+    initialized = true;
+    let module;
+    switch (environment) {
+      case 0 /* CLI */:
+        module = I18nextCLILanguageDetector;
+        break;
+      case 2 /* Browser */:
+        module = I18nextBrowserLanguageDetector;
+        break;
+      default:
+        throw new Error("Not supported");
+    }
+    const initResourceBundles = pendingResourceBundles;
+    pendingResourceBundles = void 0;
+    await i18next.use(module).init({
+      fallbackLng: "en",
+      debug,
+      resources: {}
+    }).then(() => {
+      i18next.services.formatter?.add("toLowerCase", (value) => value.toLowerCase());
+      for (const initResourceBundle of initResourceBundles) {
+        i18nAddResourceBundle(initResourceBundle.lng, initResourceBundle.ns, initResourceBundle.resources);
+      }
+    });
+  } else {
+    initialized = false;
+  }
+  return initialized;
+}
+function i18nAddResourceBundle(lng, ns, resources) {
+  if (pendingResourceBundles !== void 0) {
+    pendingResourceBundles.push({
+      lng,
+      ns,
+      resources
+    });
+  } else {
+    i18next.addResourceBundle(lng, ns, resources);
+  }
+}
+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`);
+    }
+  }
+}
+export {
+  I18NEnvironment,
+  i18nAddResourceBundle,
+  i18nAssertValidResources,
+  i18nInit,
+  i18n_default as i18next
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aidc-toolkit/core",
-  "version": "0.9.3",
+  "version": "0.9.5",
   "description": "Core functionality for AIDC Toolkit",
   "type": "module",
   "main": "dist/index.js",
@@ -24,14 +24,15 @@
     "build-doc": "npm run build && tsc src/index.ts --outDir dist --target esnext --moduleResolution nodenext --module nodenext --emitDeclarationOnly --declaration --declarationMap"
   },
   "devDependencies": {
-    "@aidc-toolkit/dev": "^0.9.3",
-    "eslint": "^9.14.0",
+    "@aidc-toolkit/dev": "^0.9.5",
+    "eslint": "^9.15.0",
     "ts-node": "^10.9.2",
     "tsup": "^8.3.5",
     "typescript": "^5.6.3"
   },
   "dependencies": {
-    "i18next": "^23.16.5",
+    "@rollup/rollup-linux-x64-gnu": "^4.27.3",
+    "i18next": "^23.16.8",
     "i18next-browser-languagedetector": "^8.0.0",
     "i18next-cli-language-detector": "^1.1.8"
   }

package/.github/workflows/npm-publish.yml

@@ -1,32 +0,0 @@
-# This workflow will run tests using node and then publish a package to GitHub Packages when a release is created
-# For more information see: https://docs.github.com/en/actions/publishing-packages/publishing-nodejs-packages
-
-name: Node.js Package
-
-on:
-  release:
-    types: [created]
-
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 22
-      - run: npm ci
-
-  publish-npm:
-    needs: build
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 22
-          registry-url: https://registry.npmjs.org/
-      - run: npm ci
-      - run: npm publish --access public
-        env:
-          NODE_AUTH_TOKEN: ${{secrets.npm_token}}

package/.idea/runConfigurations/build_dev.xml

@@ -1,12 +0,0 @@
-<component name="ProjectRunConfigurationManager">
-  <configuration default="false" name="build-dev" type="js.build_tools.npm" nameIsGenerated="true">
-    <package-json value="$PROJECT_DIR$/package.json" />
-    <command value="run" />
-    <scripts>
-      <script value="build-dev" />
-    </scripts>
-    <node-interpreter value="project" />
-    <envs />
-    <method v="2" />
-  </configuration>
-</component>