tiny-essentials 1.28.18 → 1.29.0

package/dist/v1/libs/sw/utils.d.mts

@@ -0,0 +1,173 @@
+/**
+ * @typedef {Object} TinyPushAction
+ * @property {string} action - Identifier echoed back on `notificationclick`.
+ * @property {string} title - Human readable label.
+ * @property {string} [icon] - Absolute URL of the action icon.
+ * @property {string} [url] - URL opened when the action is clicked.
+ * @property {boolean} [dismiss] - When `true`, the action only closes the notification.
+ */
+export type TinyPushAction = {
+    /**
+     * - Identifier echoed back on `notificationclick`.
+     */
+    action: string;
+    /**
+     * - Human readable label.
+     */
+    title: string;
+    /**
+     * - Absolute URL of the action icon.
+     */
+    icon?: string;
+    /**
+     * - URL opened when the action is clicked.
+     */
+    url?: string;
+    /**
+     * - When `true`, the action only closes the notification.
+     */
+    dismiss?: boolean;
+};
+export type TinyPushNotification = {
+    /**
+     * - Notification title.
+     */
+    title: string;
+    /**
+     * - Notification body.
+     */
+    body?: string;
+    /**
+     * - Absolute URL of the icon.
+     */
+    icon?: string;
+    /**
+     * - Absolute URL of the badge.
+     */
+    badge?: string;
+    /**
+     * - Absolute URL of the hero image.
+     */
+    image?: string;
+    /**
+     * - Collapse key. Notifications with the same tag replace each other.
+     */
+    tag?: string;
+    /**
+     * - BCP 47 language tag.
+     */
+    lang?: string;
+    /**
+     * - Text direction: `ltr` or `rtl`.
+     */
+    dir?: string;
+    /**
+     * - URL opened when the notification body is clicked.
+     */
+    url?: string;
+    /**
+     * - Whether to vibrate on replacement.
+     */
+    renotify?: boolean;
+    /**
+     * - Whether the notification stays until dismissed.
+     */
+    requireInteraction?: boolean;
+    /**
+     * - Whether to suppress vibration and sound.
+     */
+    silent?: boolean;
+    /**
+     * - Creation time in milliseconds since the epoch.
+     */
+    timestamp?: number;
+    /**
+     * - Vibration pattern in milliseconds.
+     */
+    vibrate?: number[];
+    /**
+     * - Action buttons.
+     */
+    actions?: TinyPushAction[];
+    /**
+     * - Opaque data echoed back on click.
+     */
+    data?: Record<string, unknown>;
+};
+export type TinyPushMessage = {
+    /**
+     * - Contract version.
+     */
+    v: number;
+    /**
+     * - Routing key, see {@link PUSH_TYPE}.
+     */
+    type: string;
+    /**
+     * - Idempotency identifier.
+     */
+    id?: string;
+    /**
+     * - Time to live in seconds.
+     */
+    ttl?: number;
+    /**
+     * - Collapse key at the transport level.
+     */
+    topic?: string;
+    /**
+     * - Absolute expiration time in milliseconds since the epoch.
+     */
+    expiresAt?: number;
+    /**
+     * - Notification descriptor.
+     */
+    notification?: TinyPushNotification;
+    /**
+     * - Arbitrary payload for custom handlers.
+     */
+    data?: Record<string, unknown>;
+};
+/**
+ * @typedef {Object} TinyPushNotification
+ * @property {string} title - Notification title.
+ * @property {string} [body] - Notification body.
+ * @property {string} [icon] - Absolute URL of the icon.
+ * @property {string} [badge] - Absolute URL of the badge.
+ * @property {string} [image] - Absolute URL of the hero image.
+ * @property {string} [tag] - Collapse key. Notifications with the same tag replace each other.
+ * @property {string} [lang] - BCP 47 language tag.
+ * @property {string} [dir] - Text direction: `ltr` or `rtl`.
+ * @property {string} [url] - URL opened when the notification body is clicked.
+ * @property {boolean} [renotify] - Whether to vibrate on replacement.
+ * @property {boolean} [requireInteraction] - Whether the notification stays until dismissed.
+ * @property {boolean} [silent] - Whether to suppress vibration and sound.
+ * @property {number} [timestamp] - Creation time in milliseconds since the epoch.
+ * @property {number[]} [vibrate] - Vibration pattern in milliseconds.
+ * @property {TinyPushAction[]} [actions] - Action buttons.
+ * @property {Record<string, unknown>} [data] - Opaque data echoed back on click.
+ */
+/**
+ * @typedef {Object} TinyPushMessage
+ * @property {number} v - Contract version.
+ * @property {string} type - Routing key, see {@link PUSH_TYPE}.
+ * @property {string} [id] - Idempotency identifier.
+ * @property {number} [ttl] - Time to live in seconds.
+ * @property {string} [topic] - Collapse key at the transport level.
+ * @property {number} [expiresAt] - Absolute expiration time in milliseconds since the epoch.
+ * @property {TinyPushNotification} [notification] - Notification descriptor.
+ * @property {Record<string, unknown>} [data] - Arbitrary payload for custom handlers.
+ */
+/**
+ * Discriminator used by the router to pick a handler.
+ * @readonly
+ * @enum {string}
+ */
+export declare const PUSH_TYPE: Readonly<{
+    NOTIFICATION: "notification";
+    DATA: "data";
+    SYNC: "sync";
+    COMMAND: "command";
+    UNKNOWN: "unknown";
+}>;
+//# sourceMappingURL=utils.d.mts.map

package/dist/v1/libs/sw/utils.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.mts","sourceRoot":"","sources":["../../../../src/v1/libs/sw/utils.mjs"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AANA,YAAkB,cAAc,GAChC;;;;IAAmB,MAAM,EAAd,MAAM,CACjB;;;;IAAmB,KAAK,EAAb,MAAM,CACjB;;;;IAAoB,IAAI,AAAxB,CACA,EADW,MAAM,CACjB;;;;IAAoB,GAAG,AAAvB,CACA,EADW,MAAM,CACjB;;;;IAAqB,OAAO,AAA5B,CACF,EADa,OAAO,CACpB;CAAA,CAAA;AAGE,YAAkB,oBAAoB,GACtC;;;;IAAmB,KAAK,EAAb,MAAM,CACjB;;;;IAAoB,IAAI,AAAxB,CACA,EADW,MAAM,CACjB;;;;IAAoB,IAAI,AAAxB,CACA,EADW,MAAM,CACjB;;;;IAAoB,KAAK,AAAzB,CACA,EADW,MAAM,CACjB;;;;IAAoB,KAAK,AAAzB,CACA,EADW,MAAM,CACjB;;;;IAAoB,GAAG,AAAvB,CACA,EADW,MAAM,CACjB;;;;IAAoB,IAAI,AAAxB,CACA,EADW,MAAM,CACjB;;;;IAAoB,GAAG,AAAvB,CACA,EADW,MAAM,CACjB;;;;IAAoB,GAAG,AAAvB,CACA,EADW,MAAM,CACjB;;;;IAAqB,QAAQ,AAA7B,CACA,EADW,OAAO,CAClB;;;;IAAqB,kBAAkB,AAAvC,CACA,EADW,OAAO,CAClB;;;;IAAqB,MAAM,AAA3B,CACA,EADW,OAAO,CAClB;;;;IAAoB,SAAS,AAA7B,CACA,EADW,MAAM,CACjB;;;;IAAsB,OAAO,AAA7B,CACA,EADW,MAAM,EAAE,CACnB;;;;IAA8B,OAAO,AAArC,CACA,EADW,cAAc,EAAE,CAC3B;;;;IAAqC,IAAI,AAAzC,CACF,EADa,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CACpC;CAAA,CAAA;AAGE,YAAkB,eAAe,GACjC;;;;IAAmB,CAAC,EAAT,MAAM,CACjB;;;;IAAmB,IAAI,EAAZ,MAAM,CACjB;;;;IAAoB,EAAE,AAAtB,CACA,EADW,MAAM,CACjB;;;;IAAoB,GAAG,AAAvB,CACA,EADW,MAAM,CACjB;;;;IAAoB,KAAK,AAAzB,CACA,EADW,MAAM,CACjB;;;;IAAoB,SAAS,AAA7B,CACA,EADW,MAAM,CACjB;;;;IAAkC,YAAY,AAA9C,CACA,EADW,oBAAoB,CAC/B;;;;IAAqC,IAAI,AAAzC,CACF,EADa,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CACpC;CAAA,CAAA;AA9BD;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;;;;;;GAUG;AAEH;;;;GAIG;AACH,eAAO,MAAM,SAAS;;;;;;EAMpB,CAAC"}

package/dist/v1/libs/sw/utils.mjs

@@ -0,0 +1,50 @@
+/**
+ * @typedef {Object} TinyPushAction
+ * @property {string} action - Identifier echoed back on `notificationclick`.
+ * @property {string} title - Human readable label.
+ * @property {string} [icon] - Absolute URL of the action icon.
+ * @property {string} [url] - URL opened when the action is clicked.
+ * @property {boolean} [dismiss] - When `true`, the action only closes the notification.
+ */
+/**
+ * @typedef {Object} TinyPushNotification
+ * @property {string} title - Notification title.
+ * @property {string} [body] - Notification body.
+ * @property {string} [icon] - Absolute URL of the icon.
+ * @property {string} [badge] - Absolute URL of the badge.
+ * @property {string} [image] - Absolute URL of the hero image.
+ * @property {string} [tag] - Collapse key. Notifications with the same tag replace each other.
+ * @property {string} [lang] - BCP 47 language tag.
+ * @property {string} [dir] - Text direction: `ltr` or `rtl`.
+ * @property {string} [url] - URL opened when the notification body is clicked.
+ * @property {boolean} [renotify] - Whether to vibrate on replacement.
+ * @property {boolean} [requireInteraction] - Whether the notification stays until dismissed.
+ * @property {boolean} [silent] - Whether to suppress vibration and sound.
+ * @property {number} [timestamp] - Creation time in milliseconds since the epoch.
+ * @property {number[]} [vibrate] - Vibration pattern in milliseconds.
+ * @property {TinyPushAction[]} [actions] - Action buttons.
+ * @property {Record<string, unknown>} [data] - Opaque data echoed back on click.
+ */
+/**
+ * @typedef {Object} TinyPushMessage
+ * @property {number} v - Contract version.
+ * @property {string} type - Routing key, see {@link PUSH_TYPE}.
+ * @property {string} [id] - Idempotency identifier.
+ * @property {number} [ttl] - Time to live in seconds.
+ * @property {string} [topic] - Collapse key at the transport level.
+ * @property {number} [expiresAt] - Absolute expiration time in milliseconds since the epoch.
+ * @property {TinyPushNotification} [notification] - Notification descriptor.
+ * @property {Record<string, unknown>} [data] - Arbitrary payload for custom handlers.
+ */
+/**
+ * Discriminator used by the router to pick a handler.
+ * @readonly
+ * @enum {string}
+ */
+export const PUSH_TYPE = Object.freeze({
+    NOTIFICATION: 'notification',
+    DATA: 'data',
+    SYNC: 'sync',
+    COMMAND: 'command',
+    UNKNOWN: 'unknown',
+});

package/dist/v1/libs/text/TinyI18/Browser-NON-DOM.cjs

@@ -0,0 +1,57 @@
+'use strict';
+
+var path = require('../../fs/path.cjs');
+var browserUtils = require('./browser-utils.cjs');
+var index = require('./index.cjs');
+
+/**
+ * @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.
+ * - 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 TinyI18Browser extends index {
+  /**
+   * 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);
+  }
+}
+
+/**
+ * Not supported in the browser non-dom: `mergeLocaleFiles` is a build-time API.
+ *
+ * @type {(path: string, data: string, encoding?: string) => never}
+ * @throws {Error} Always. Use the Node.js entry point instead.
+ */
+TinyI18Browser._writeFile = () => {
+  throw new Error(
+    'TinyI18: "mergeLocaleFiles" is not available in the browser; run it in Node.js at build time',
+  );
+};
+
+/** @type {(...paths: string[]) => string} */
+TinyI18Browser._join = path.join;
+/** @type {false} */
+TinyI18Browser._existsSync = false;
+/** @type {(path: string, options?: string) => Promise<string>} */
+TinyI18Browser._readFile = browserUtils.readFile;
+
+module.exports = TinyI18Browser;

package/dist/v1/libs/text/TinyI18/Browser-NON-DOM.d.mts

@@ -0,0 +1,39 @@
+import { join } from '../../fs/path.mjs';
+import { readFile } from './browser-utils.mjs';
+import TinyI18 from './index.mjs';
+export type TinyI18Options = import('./index.mjs').TinyI18Options;
+/**
+ * @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.
+ * - 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").
+ */
+declare class TinyI18Browser 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: TinyI18Options);
+}
+declare namespace TinyI18Browser {
+    var _writeFile: (path: string, data: string, encoding?: string) => never;
+    export { join as _join };
+    export var _existsSync: false;
+    export { readFile as _readFile };
+}
+export default TinyI18Browser;
+//# sourceMappingURL=Browser-NON-DOM.d.mts.map

package/dist/v1/libs/text/TinyI18/Browser-NON-DOM.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Browser-NON-DOM.d.mts","sourceRoot":"","sources":["../../../../../src/v1/libs/text/TinyI18/Browser-NON-DOM.mjs"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,OAAO,MAAM,aAAa,CAAC;AAG/B,YAAgD,cAAc,GAApD,OAAO,aAAa,EAAE,cAAc,CAAgB;AADjE;;GAEG;AAEH;;;;;;;;;GASG;AACH,cAAM,cAAe,SAAQ,OAAO;IAClC;;;;;;;;;;OAUG;IACH,YAAY,OAAO,EAFR,cAEQ,EAElB;CACF;kBAfK,cAAc;oBAoBV,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,KAAK;aAU3C,IAAI;4BAChB,KAAK;aAGW,QAAQ;;eAEpB,cAAc"}

package/dist/v1/libs/text/TinyI18/Browser-NON-DOM.mjs

@@ -0,0 +1,48 @@
+import { join } from '../../fs/path.mjs';
+import { readFile } from './browser-utils.mjs';
+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.
+ * - 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 TinyI18Browser 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);
+    }
+}
+/**
+ * Not supported in the browser non-dom: `mergeLocaleFiles` is a build-time API.
+ *
+ * @type {(path: string, data: string, encoding?: string) => never}
+ * @throws {Error} Always. Use the Node.js entry point instead.
+ */
+TinyI18Browser._writeFile = () => {
+    throw new Error('TinyI18: "mergeLocaleFiles" is not available in the browser; run it in Node.js at build time');
+};
+/** @type {(...paths: string[]) => string} */
+TinyI18Browser._join = join;
+/** @type {false} */
+TinyI18Browser._existsSync = false;
+/** @type {(path: string, options?: string) => Promise<string>} */
+TinyI18Browser._readFile = readFile;
+export default TinyI18Browser;

package/dist/v1/libs/text/TinyI18/Browser.cjs

@@ -0,0 +1,64 @@
+'use strict';
+
+var path = require('../../fs/path.cjs');
+var browserUtils = require('./browser-utils.cjs');
+var index = require('./index.cjs');
+
+/**
+ * @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.
+ * - 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 TinyI18Browser extends index {
+  /**
+   * 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);
+  }
+}
+
+/**
+ * Triggers a file download in the browser.
+ *
+ * @param {string} path - The file name (or path) used for the downloaded file.
+ * @param {string} data - The file contents.
+ * @returns {Promise<void>} A promise that resolves once the download has been triggered.
+ */
+const writeFile = async (path, data) => {
+  const blob = new Blob([data], { type: 'application/json' });
+  const url = URL.createObjectURL(blob);
+  const anchor = document.createElement('a');
+  anchor.href = url;
+  anchor.download = path.split('/').pop() || 'download.json';
+  anchor.click();
+  setTimeout(() => URL.revokeObjectURL(url), 0);
+};
+
+/** @type {(...paths: string[]) => string} */
+TinyI18Browser._join = path.join;
+/** @type {false} */
+TinyI18Browser._existsSync = false;
+/** @type {(path: string, options?: string) => Promise<string>} */
+TinyI18Browser._readFile = browserUtils.readFile;
+/** @type {(path: string, data: string, options?: string) => Promise<void>} */
+TinyI18Browser._writeFile = writeFile;
+
+module.exports = TinyI18Browser;

package/dist/v1/libs/text/TinyI18/Browser.d.mts

@@ -0,0 +1,47 @@
+import { join } from '../../fs/path.mjs';
+import { readFile } from './browser-utils.mjs';
+import TinyI18 from './index.mjs';
+export type TinyI18Options = import('./index.mjs').TinyI18Options;
+/**
+ * @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.
+ * - 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").
+ */
+declare class TinyI18Browser 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: TinyI18Options);
+}
+declare namespace TinyI18Browser {
+    export { join as _join };
+    export var _existsSync: false;
+    export { readFile as _readFile };
+    export { writeFile as _writeFile };
+}
+/**
+ * Triggers a file download in the browser.
+ *
+ * @param {string} path - The file name (or path) used for the downloaded file.
+ * @param {string} data - The file contents.
+ * @returns {Promise<void>} A promise that resolves once the download has been triggered.
+ */
+declare const writeFile: (path: string, data: string) => Promise<void>;
+export default TinyI18Browser;
+//# sourceMappingURL=Browser.d.mts.map

package/dist/v1/libs/text/TinyI18/Browser.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Browser.d.mts","sourceRoot":"","sources":["../../../../../src/v1/libs/text/TinyI18/Browser.mjs"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,OAAO,MAAM,aAAa,CAAC;AAG/B,YAAgD,cAAc,GAApD,OAAO,aAAa,EAAE,cAAc,CAAgB;AADjE;;GAEG;AAEH;;;;;;;;;GASG;AACH,cAAM,cAAe,SAAQ,OAAO;IAClC;;;;;;;;;;OAUG;IACH,YAAY,OAAO,EAFR,cAEQ,EAElB;CACF;kBAfK,cAAc;aAmCG,IAAI;4BAChB,KAAK;aAGW,QAAQ;aAEP,SAAS;;AAxBrC;;;;;;GAMG;AACH,QAAA,MAAM,SAAS,SAJJ,MAAM,QACN,MAAM,KACJ,OAAO,CAAC,IAAI,CAUxB,CAAC;eAWa,cAAc"}

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

@@ -0,0 +1,57 @@
+import { join } from '../../fs/path.mjs';
+import { readFile } from './browser-utils.mjs';
+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.
+ * - 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 TinyI18Browser 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);
+    }
+}
+/**
+ * Triggers a file download in the browser.
+ *
+ * @param {string} path - The file name (or path) used for the downloaded file.
+ * @param {string} data - The file contents.
+ * @returns {Promise<void>} A promise that resolves once the download has been triggered.
+ */
+const writeFile = async (path, data) => {
+    const blob = new Blob([data], { type: 'application/json' });
+    const url = URL.createObjectURL(blob);
+    const anchor = document.createElement('a');
+    anchor.href = url;
+    anchor.download = path.split('/').pop() || 'download.json';
+    anchor.click();
+    setTimeout(() => URL.revokeObjectURL(url), 0);
+};
+/** @type {(...paths: string[]) => string} */
+TinyI18Browser._join = join;
+/** @type {false} */
+TinyI18Browser._existsSync = false;
+/** @type {(path: string, options?: string) => Promise<string>} */
+TinyI18Browser._readFile = readFile;
+/** @type {(path: string, data: string, options?: string) => Promise<void>} */
+TinyI18Browser._writeFile = writeFile;
+export default TinyI18Browser;

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

@@ -0,0 +1,49 @@
+'use strict';
+
+var promises = require('fs/promises');
+var fs = require('fs');
+var path = require('path');
+var index = require('./index.cjs');
+
+/**
+ * @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 index {
+  /**
+   * 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) => path.join(...args);
+/** @type {typeof import('fs').existsSync} */
+TinyI18Node._existsSync = (...args) => fs.existsSync(...args);
+/** @type {(path: string, options: BufferEncoding) => Promise<string>} */
+TinyI18Node._readFile = (...args) => promises.readFile(...args);
+/** @type {typeof import('fs/promises').writeFile} */
+TinyI18Node._writeFile = (...args) => promises.writeFile(...args);
+
+module.exports = TinyI18Node;

package/dist/v1/libs/text/TinyI18/Node.d.mts

@@ -0,0 +1,38 @@
+import TinyI18 from './index.mjs';
+export type TinyI18Options = import('./index.mjs').TinyI18Options;
+/**
+ * @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").
+ */
+declare 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: TinyI18Options);
+}
+declare namespace TinyI18Node {
+    var _join: typeof import('path').join;
+    var _existsSync: typeof import('fs').existsSync;
+    var _readFile: (path: string, options: BufferEncoding) => Promise<string>;
+    var _writeFile: typeof import('fs/promises').writeFile;
+}
+export default TinyI18Node;
+//# sourceMappingURL=Node.d.mts.map

package/dist/v1/libs/text/TinyI18/Node.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Node.d.mts","sourceRoot":"","sources":["../../../../../src/v1/libs/text/TinyI18/Node.mjs"],"names":[],"mappings":"AAGA,OAAO,OAAO,MAAM,aAAa,CAAC;AAG/B,YAAgD,cAAc,GAApD,OAAO,aAAa,EAAE,cAAc,CAAgB;AADjE;;GAEG;AAEH;;;;;;;;;;GAUG;AACH,cAAM,WAAY,SAAQ,OAAO;IAC/B;;;;;;;;;;OAUG;IACH,YAAY,OAAO,EAFR,cAEQ,EAElB;CACF;kBAfK,WAAW;eAiBN,cAAc,MAAM,EAAE,IAAI;qBAE1B,cAAc,IAAI,EAAE,UAAU;mBAE9B,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,MAAM,CAAC;oBAE1D,cAAc,aAAa,EAAE,SAAS;;eAGlC,WAAW"}