tiny-essentials 1.28.18 → 1.29.0

package/dist/v1/libs/text/TinyI18/Node.mjs

@@ -0,0 +1,43 @@
+import { readFile, writeFile } from 'fs/promises';
+import { existsSync } from 'fs';
+import { join } from 'path';
+import TinyI18 from './index.mjs';
+/**
+ * @typedef {import('./index.mjs').TinyI18Options} TinyI18Options
+ */
+/**
+ * TinyI18 — Professional and flexible i18n manager with dual mode (local/file),
+ * regex-based keys, and function-based entries for advanced rendering (incl. HTML).
+ *
+ * - Mode "local": in-memory resources (Node + Browser).
+ * - Mode "file": JSON files on disk via fs/path (Node only).
+ * - Keeps only default + selected locale in memory.
+ * - Selected locale overrides default; fallback resolves to default.
+ * - Supports string entries, regex pattern entries, and function-backed entries.
+ * - Safe: no dynamic code eval from files; functions in file mode are referenced by name ("$fn").
+ */
+class TinyI18Node extends TinyI18 {
+    /**
+     * Creates a new TinyI18 instance for managing localized strings and patterns.
+     *
+     * Supports two modes:
+     * - "local": loads translations directly from provided objects.
+     * - "file": loads translations from JSON files on demand.
+     *
+     * Ensures the default locale is always initialized. In "file" mode, `basePath` is required.
+     *
+     * @param {TinyI18Options} options - Configuration options for the instance.
+     */
+    constructor(options) {
+        super(options);
+    }
+}
+/** @type {typeof import('path').join} */
+TinyI18Node._join = (...args) => join(...args);
+/** @type {typeof import('fs').existsSync} */
+TinyI18Node._existsSync = (...args) => existsSync(...args);
+/** @type {(path: string, options: BufferEncoding) => Promise<string>} */
+TinyI18Node._readFile = (...args) => readFile(...args);
+/** @type {typeof import('fs/promises').writeFile} */
+TinyI18Node._writeFile = (...args) => writeFile(...args);
+export default TinyI18Node;

package/dist/v1/libs/text/TinyI18/browser-utils.cjs

@@ -0,0 +1,17 @@
+'use strict';
+
+/**
+ * Reads a file from the network using the Fetch API.
+ *
+ * @param {string} path - The URL of the file to read.
+ * @returns {Promise<string>} A promise that resolves with the file contents as text.
+ */
+const readFile = async (path) => {
+  const response = await fetch(path);
+  if (!response.ok) {
+    throw new Error(`TinyI18: failed to load "${path}": ${response.status} ${response.statusText}`);
+  }
+  return response.text();
+};
+
+exports.readFile = readFile;

package/dist/v1/libs/text/TinyI18/browser-utils.d.mts

@@ -0,0 +1,8 @@
+/**
+ * Reads a file from the network using the Fetch API.
+ *
+ * @param {string} path - The URL of the file to read.
+ * @returns {Promise<string>} A promise that resolves with the file contents as text.
+ */
+export declare const readFile: (path: string) => Promise<string>;
+//# sourceMappingURL=browser-utils.d.mts.map

package/dist/v1/libs/text/TinyI18/browser-utils.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-utils.d.mts","sourceRoot":"","sources":["../../../../../src/v1/libs/text/TinyI18/browser-utils.mjs"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,SAHV,MAAM,KACJ,OAAO,CAAC,MAAM,CAQ1B,CAAC"}

package/dist/v1/libs/text/TinyI18/browser-utils.mjs

@@ -0,0 +1,13 @@
+/**
+ * Reads a file from the network using the Fetch API.
+ *
+ * @param {string} path - The URL of the file to read.
+ * @returns {Promise<string>} A promise that resolves with the file contents as text.
+ */
+export const readFile = async (path) => {
+    const response = await fetch(path);
+    if (!response.ok) {
+        throw new Error(`TinyI18: failed to load "${path}": ${response.status} ${response.statusText}`);
+    }
+    return response.text();
+};