imba-localization 0.4.10 → 0.4.12

package/README.md

@@ -136,6 +136,13 @@ new Localization(url, default = 'en')
 - `languages`: Object containing all loaded language data
 - `preferred`: Detected browser language (first 2 characters of `navigator.language`)
 
+### Methods
+
+- `lookup(path, fallback = '')`: Reads a nested value by dot path or path array
+- `text(path, fallback = '', data = null)`: Reads a localized string and replaces `{key}` placeholders from `data`
+- `table(path)`: Reads a nested object table, returning `{}` when missing
+- `render(value, data = null)`: Replaces `{key}` placeholders in any string-like value
+
 ### Events
 
 - `onready`: Called when localization data is successfully loaded

package/index.d.ts

@@ -21,6 +21,11 @@ export class Localization {
 
   active: string;
 
+  render(value: unknown, data?: Record<string, unknown> | null): string;
+  lookup(path: string | string[], fallback?: unknown): unknown;
+  text(path: string | string[], fallback?: string, data?: Record<string, unknown> | null): string;
+  table(path: string | string[]): Record<string, any>;
+
   [key: string]: any;
 }
 

package/localization.imba

@@ -101,6 +101,32 @@ export class Localization
 				target.err.throw('localization-no-key', p)
 				return ''
 		}
+
+	def render value, data = null
+		let text = String(value or '')
+		return text unless data and typeof data == 'object'
+		text.replace /\{([^}]+)\}/g, do(_match, key)
+			const value = data[key]
+			if value == undefined or value == null then '' else String(value)
+
+	def lookup path, fallback = ''
+		const keys = if Array.isArray(path) then path else String(path or '').split('.').filter(do(part) part)
+		let value = languages..[active] or languages..[default] or {}
+		for key in keys
+			if value and typeof value == 'object' and value[key] != undefined
+				value = value[key]
+			else
+				return fallback
+		value
+
+	def text path, fallback = '', data = null
+		const value = lookup(path, fallback)
+		return render(value, data) if typeof value == 'string' or typeof value == 'number'
+		render(fallback, data)
+
+	def table path
+		const value = lookup(path, {})
+		if value and typeof value == 'object' then value else {}
 				
 	def _finalize data, error
 		if error or !data

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "imba-localization",
-  "version": "0.4.10",
+  "version": "0.4.12",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/HeapVoid/imba-localization.git"