imba-localization 0.4.9 → 0.4.11

package/README.md

@@ -10,6 +10,7 @@ A lightweight Imba module for loading and handling JSON-based localization files
 - 🔄 **Smart fallback system** - Falls back to a default language when needed
 - 🧠 **Intuitive access** - Proxy-based access to translation strings
 - 📡 **Event handling** - Support for `onready`, `onchange`, and `onerror` events
+- 🧾 **Type declarations** - Includes package-level TypeScript declarations for editor and language-server imports
 - 🚀 **Simple integration** - Easy to use in any Imba-based web application
 - 🧩 **`<language-selector>`** - Plug and play tag component for switching languages
 
@@ -310,4 +311,4 @@ tag App
       css w:20px h:20px stroke:red
 		  <{svg-arrow-down}>
 			
-```
+```

package/index.d.ts

@@ -0,0 +1,38 @@
+export type LocalizationLanguage = Record<string, any>;
+export type LocalizationLanguages = Record<string, LocalizationLanguage>;
+
+export interface LocalizationErrorState {
+  cache: Record<string, boolean>;
+  throw(code: string, details?: any): void;
+}
+
+export class Localization {
+  constructor(url: string, fallback?: string);
+
+  onready?: () => void;
+  onerror?: (error: string, details?: any) => void;
+  onchange?: (language: string) => void;
+
+  languages: LocalizationLanguages;
+  preferred: string;
+  default: string;
+  ready: boolean;
+  err: LocalizationErrorState;
+
+  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;
+}
+
+export const flags: Record<string, string>;
+
+declare global {
+  interface HTMLElementTagNameMap {
+    "language-selector": HTMLElement;
+  }
+}

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.9",
+  "version": "0.4.11",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/HeapVoid/imba-localization.git"
@@ -8,11 +8,25 @@
   "main": "localization.imba",
   "module": "localization.imba",
   "browser": "localization.imba",
+  "types": "index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./localization.imba",
+      "default": "./localization.imba"
+    },
+    "./localization.imba": {
+      "types": "./index.d.ts",
+      "import": "./localization.imba",
+      "default": "./localization.imba"
+    }
+  },
   "description": "A class to make using language localizations in Imba easier.",
   "keywords": ["imba", "theme", "localization"],
   "license": "MIT",
   "type": "module",
   "files": [
-    "localization.imba"
+    "localization.imba",
+    "index.d.ts"
   ]
-}
+}