@contentstorage/i18next-plugin 1.0.1

package/dist/utils.d.ts

@@ -0,0 +1,88 @@
+import type { ContentStorageWindow, MemoryMap } from './types';
+/**
+ * Checks if the code is running in a browser environment
+ */
+export declare function isBrowser(): boolean;
+/**
+ * Gets the ContentStorage window object with type safety
+ */
+export declare function getContentStorageWindow(): ContentStorageWindow | null;
+/**
+ * Detects if the application is running in ContentStorage live editor mode
+ *
+ * @param liveEditorParam - Query parameter name to check
+ * @param forceLiveMode - Force live mode regardless of environment
+ * @returns true if in live editor mode
+ */
+export declare function detectLiveEditorMode(liveEditorParam?: string, forceLiveMode?: boolean): boolean;
+/**
+ * Initializes the global memory map if it doesn't exist
+ */
+export declare function initializeMemoryMap(): MemoryMap | null;
+/**
+ * Gets the global memory map
+ */
+export declare function getMemoryMap(): MemoryMap | null;
+/**
+ * Normalizes i18next key format to consistent dot notation
+ * Converts namespace:key format to namespace.key
+ *
+ * @param key - The translation key
+ * @param namespace - Optional namespace
+ * @returns Normalized key in dot notation
+ */
+export declare function normalizeKey(key: string, namespace?: string): string;
+/**
+ * Extracts the base translation key without interpolation context
+ * Handles plural forms, contexts, and other i18next features
+ *
+ * Examples:
+ * - 'welcome' -> 'welcome'
+ * - 'items_plural' -> 'items'
+ * - 'friend_male' -> 'friend'
+ *
+ * @param key - The translation key
+ * @returns Base key without suffixes
+ */
+export declare function extractBaseKey(key: string): string;
+/**
+ * Removes interpolation variables from a translated string
+ *
+ * Examples:
+ * - 'Hello {{name}}!' -> 'Hello !'
+ * - 'You have {{count}} items' -> 'You have  items'
+ *
+ * @param value - The translated string
+ * @returns String with interpolations removed
+ */
+export declare function removeInterpolation(value: string): string;
+/**
+ * Tracks a translation in the memory map
+ *
+ * @param translationValue - The actual translated text
+ * @param translationKey - The content ID (i18next key)
+ * @param namespace - Optional namespace
+ * @param language - Optional language code
+ * @param debug - Enable debug logging
+ */
+export declare function trackTranslation(translationValue: string, translationKey: string, namespace?: string, language?: string, debug?: boolean): void;
+/**
+ * Cleans up old entries from memory map when size exceeds limit
+ * Removes oldest entries first (based on trackedAt timestamp)
+ *
+ * @param maxSize - Maximum number of entries to keep
+ */
+export declare function cleanupMemoryMap(maxSize: number): void;
+/**
+ * Deeply traverses a translation object and extracts all string values with their keys
+ *
+ * @param obj - Translation object to traverse
+ * @param prefix - Current key prefix (for nested objects)
+ * @returns Array of [key, value] pairs
+ */
+export declare function flattenTranslations(obj: any, prefix?: string): Array<[string, string]>;
+/**
+ * Debug helper to log memory map contents
+ */
+export declare function debugMemoryMap(): void;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,SAAS,EAAkB,MAAM,SAAS,CAAC;AAE/E;;GAEG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,oBAAoB,GAAG,IAAI,CAGrE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,eAAe,GAAE,MAAqC,EACtD,aAAa,GAAE,OAAe,GAC7B,OAAO,CAqBT;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,SAAS,GAAG,IAAI,CAStD;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,SAAS,GAAG,IAAI,CAG/C;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAcpE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAkBlD;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGzD;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,gBAAgB,EAAE,MAAM,EACxB,cAAc,EAAE,MAAM,EACtB,SAAS,CAAC,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,MAAM,EACjB,KAAK,GAAE,OAAe,GACrB,IAAI,CAgCN;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAqBtD;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,GAAG,EACR,MAAM,GAAE,MAAW,GAClB,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAkBzB;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAsBrC"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@contentstorage/i18next-plugin",
+  "version": "1.0.1",
+  "description": "i18next plugin for Contentstorage live editor translation tracking",
+  "main": "dist/index.js",
+  "module": "dist/index.esm.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "rollup -c",
+    "dev": "rollup -c -w",
+    "test": "jest",
+    "type-check": "tsc --noEmit",
+    "prepublishOnly": "npm run build",
+    "release": "npx release-it"
+  },
+  "keywords": [
+    "i18next",
+    "contentstorage",
+    "translation",
+    "live-editor",
+    "i18n",
+    "internationalization"
+  ],
+  "author": "ContentStorage",
+  "license": "MIT",
+  "peerDependencies": {
+    "i18next": ">=21.0.0"
+  },
+  "devDependencies": {
+    "@release-it/conventional-changelog": "^10.0.1",
+    "@rollup/plugin-commonjs": "^25.0.7",
+    "@rollup/plugin-node-resolve": "^15.2.3",
+    "@rollup/plugin-typescript": "^11.1.6",
+    "@types/jest": "^29.5.11",
+    "@types/node": "^20.10.6",
+    "i18next": "^23.7.13",
+    "jest": "^29.7.0",
+    "jest-environment-jsdom": "^29.7.0",
+    "release-it": "^19.0.5",
+    "rollup": "^4.9.4",
+    "ts-jest": "^29.1.1",
+    "tslib": "^2.6.2",
+    "typescript": "^5.3.3"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/contentstorage/i18next-plugin.git"
+  }
+}