Future Proofing

eo-translatorjs v3.1.3

🐛 Bug Fixes

• translateDOM operator precedence — the container argument was silently ignored; the method always fell back to document regardless of what was passed. Fixed with ?? null-coalescing.
• translate() used wrong variable for language lookup — when options.lang was supplied the hasOwnProperty guard still checked this.language, causing incorrect fallback behaviour.
• Error messages printed "string" instead of the actual key — language error messages interpolated typeof lang (always "string") rather than the key value itself.
• add() nested traversal was fragile — the embedded tempDict[frag] = {} assignment inside a || expression could silently fail and the final key was set inside the loop instead of after it. Rewritten as a clean for loop.
• extractValue used truthiness — falsy-but-valid translation values (0, false, "") were treated as missing. Changed to an explicit == null guard.
• translateElement accessed .value without null-checking — reading .attributes["eo-translator"].value without first verifying the attribute existed could throw. All optional attribute reads are now null-guarded; passing null is a safe no-op.

🔒 Security & Safety

• assignParams RegExp injection — parameter key names are now escaped with key.replace(/[$()*+.?[]^{|}]/g, "\\$&") before being used in a RegExp constructor, preventing injection from keys that contain regex special characters.

♻️ Refactoring

• Replaced all obj.hasOwnProperty(key) calls with Object.prototype.hasOwnProperty.call(obj, key) to eliminate no-prototype-builtins violations.
• translateDOM now correctly uses DOMContainer ?? (typeof document === "object" ? document : null).
• Error type distinction: validation errors on wrong types now throw TypeError; missing key errors throw Error.
• Removed dead dict || {} fallback in constructor (the preceding guard already ensures dict is truthy).
• Fixed typos: "recieved" → "received", "transition" → "translation" in comments and error messages.

🧪 Tests

• Test count: 22 → 44 (+22).
• Error-path tests migrated from try/catch + boolean flag to expect(() => …).toThrow() with message and type assertions.
• New coverage: languages getter, isValidLanguage(), dictionary/language setters (valid & invalid), translate() with lang override, fallback option, language not found, multiple params, deeply nested keys, translateElement HTML rendering (eo-translator-html="true/false"), translateElement(null) no-op, translateDOM() on container, translateDOM() with language override.

🔧 Tooling & Infrastructure

• Migrated from npm → pnpm (pnpm-lock.yaml, pnpm-workspace.yaml).
• Added ESLint via @eoussama/dx (eslint.config.js): pnpm lint / pnpm run lint:fix.
• All 19 audit vulnerabilities resolved — pnpm audit reports 0 vulnerabilities (combination of direct dependency upgrades and pnpm-workspace.yaml overrides).
• Removed package-lock.json.

📝 Documentation

• README fully rewritten: installation (npm/pnpm/yarn + CDN), Node.js/CommonJS usage, full API reference with parameter tables and runnable examples for every method (translate, translateElement, translateDOM, add, remove, isValidLanguage, languages getter, dictionary and language properties).

🏷️ Rename

• Project renamed from translatorjs to eo-translatorjs throughout: package name, source file (src/eo-translatorjs.js), test file (tests/eo-translatorjs.test.js), type declarations (types/eo-translatorjs.d.ts), dist output, error message prefixes ([EOTranslatorJS]), and all URLs/docs.

Full Changelog: v3.1.1...3.1.3