@lokascript/i18n 3.2.0 → 4.0.0

package/dist/{index-DuIef8O7.d.ts → index-BvvoluMH.d.ts}

@@ -3,15 +3,16 @@ import { D as Dictionary } from './types-BYtpqGq3.js';
 /**
  * KeywordProvider interface for locale-aware parsing.
  *
- * This interface allows the parser to resolve non-English keywords
- * to their canonical English equivalents, enabling multilingual
- * hyperscript syntax.
+ * A provider resolves a locale's keywords to their canonical English
+ * equivalents and back (`@hyperfixi/core` 3.x's parser reads one through its
+ * `keywords` parse option).
  *
  * @example
  * ```typescript
  * import { esKeywords } from '@lokascript/i18n/parser/es';
- * const parser = new Parser({ keywords: esKeywords });
- * parser.parse('en clic alternar .active'); // Works!
+ *
+ * esKeywords.resolve('alternar'); // 'toggle'
+ * esKeywords.toLocale('toggle'); // 'alternar'
  * ```
  */
 interface KeywordProvider {
@@ -369,10 +370,9 @@ declare const es: Dictionary;
  * @example
  * ```typescript
  * import { esKeywords } from '@lokascript/i18n/parser/es';
- * import { Parser } from '@hyperfixi/core';
  *
- * const parser = new Parser({ keywords: esKeywords });
- * parser.parse('en clic alternar .active');
+ * esKeywords.resolve('alternar'); // 'toggle'
+ * esKeywords.toLocale('on'); // 'en'
  * ```
  */
 declare const esKeywords: KeywordProvider;
@@ -397,10 +397,9 @@ declare const ja: Dictionary;
  * @example
  * ```typescript
  * import { jaKeywords } from '@lokascript/i18n/parser/ja';
- * import { Parser } from '@hyperfixi/core';
  *
- * const parser = new Parser({ keywords: jaKeywords });
- * parser.parse('クリック で 切り替え .active');
+ * jaKeywords.resolve('切り替え'); // 'toggle'
+ * jaKeywords.toLocale('on'); // 'で'
  * ```
  */
 declare const jaKeywords: KeywordProvider;
@@ -420,10 +419,9 @@ declare const fr: Dictionary;
  * @example
  * ```typescript
  * import { frKeywords } from '@lokascript/i18n/parser/fr';
- * import { Parser } from '@hyperfixi/core';
  *
- * const parser = new Parser({ keywords: frKeywords });
- * parser.parse('sur clic basculer .active');
+ * frKeywords.resolve('basculer'); // 'toggle'
+ * frKeywords.toLocale('on'); // 'sur'
  * ```
  */
 declare const frKeywords: KeywordProvider;
@@ -448,10 +446,9 @@ declare const de: Dictionary;
  * @example
  * ```typescript
  * import { deKeywords } from '@lokascript/i18n/parser/de';
- * import { Parser } from '@hyperfixi/core';
  *
- * const parser = new Parser({ keywords: deKeywords });
- * parser.parse('bei klick umschalten .active');
+ * deKeywords.resolve('umschalten'); // 'toggle'
+ * deKeywords.toLocale('on'); // 'bei'
  * ```
  */
 declare const deKeywords: KeywordProvider;
@@ -480,10 +477,9 @@ declare const ar: Dictionary;
  * @example
  * ```typescript
  * import { arKeywords } from '@lokascript/i18n/parser/ar';
- * import { Parser } from '@hyperfixi/core';
  *
- * const parser = new Parser({ keywords: arKeywords });
- * parser.parse('على نقر بدل .active');
+ * arKeywords.resolve('بدل'); // 'toggle'
+ * arKeywords.toLocale('on'); // 'على'
  * ```
  */
 declare const arKeywords: KeywordProvider;
@@ -509,10 +505,9 @@ declare const ko: Dictionary;
  * @example
  * ```typescript
  * import { koKeywords } from '@lokascript/i18n/parser/ko';
- * import { Parser } from '@hyperfixi/core';
  *
- * const parser = new Parser({ keywords: koKeywords });
- * parser.parse('에 클릭 토글 .active');
+ * koKeywords.resolve('토글'); // 'toggle'
+ * koKeywords.toLocale('on'); // '에'
  * ```
  */
 declare const koKeywords: KeywordProvider;
@@ -539,10 +534,8 @@ declare const zh: Dictionary;
  * @example
  * ```typescript
  * import { zhKeywords } from '@lokascript/i18n/parser/zh';
- * import { Parser } from '@hyperfixi/core';
  *
- * const parser = new Parser({ keywords: zhKeywords });
- * parser.parse('当 点击 切换 .active');
+ * zhKeywords.resolve('切换'); // 'toggle'
  * ```
  */
 declare const zhKeywords: KeywordProvider;
@@ -569,10 +562,9 @@ declare const tr: Dictionary;
  * @example
  * ```typescript
  * import { trKeywords } from '@lokascript/i18n/parser/tr';
- * import { Parser } from '@hyperfixi/core';
  *
- * const parser = new Parser({ keywords: trKeywords });
- * parser.parse('üzerinde tıklama değiştir .active');
+ * trKeywords.resolve('değiştir'); // 'toggle'
+ * trKeywords.toLocale('on'); // 'üzerinde'
  * ```
  */
 declare const trKeywords: KeywordProvider;
@@ -595,10 +587,9 @@ declare const id: Dictionary;
  * @example
  * ```typescript
  * import { idKeywords } from '@lokascript/i18n/parser/id';
- * import { Parser } from '@hyperfixi/core';
  *
- * const parser = new Parser({ keywords: idKeywords });
- * parser.parse('pada klik ganti .active');
+ * idKeywords.resolve('alihkan'); // 'toggle'
+ * idKeywords.toLocale('on'); // 'pada'
  * ```
  */
 declare const idKeywords: KeywordProvider;
@@ -624,10 +615,9 @@ declare const qu: Dictionary;
  * @example
  * ```typescript
  * import { quKeywords } from '@lokascript/i18n/parser/qu';
- * import { Parser } from '@hyperfixi/core';
  *
- * const parser = new Parser({ keywords: quKeywords });
- * parser.parse('ñitiy-pi yapay #count-ta');
+ * quKeywords.resolve('tikray'); // 'toggle'
+ * quKeywords.toLocale('on'); // 'kaqpi'
  * ```
  */
 declare const quKeywords: KeywordProvider;
@@ -653,10 +643,9 @@ declare const sw: Dictionary;
  * @example
  * ```typescript
  * import { swKeywords } from '@lokascript/i18n/parser/sw';
- * import { Parser } from '@hyperfixi/core';
  *
- * const parser = new Parser({ keywords: swKeywords });
- * parser.parse('kwenye bonyeza badilisha .active');
+ * swKeywords.resolve('badilisha'); // 'toggle'
+ * swKeywords.toLocale('on'); // 'kwenye'
  * ```
  */
 declare const swKeywords: KeywordProvider;
@@ -682,10 +671,9 @@ declare const pt: Dictionary;
  * @example
  * ```typescript
  * import { ptKeywords } from '@lokascript/i18n/parser/pt';
- * import { Parser } from '@hyperfixi/core';
  *
- * const parser = new Parser({ keywords: ptKeywords });
- * parser.parse('em clique alternar .active');
+ * ptKeywords.resolve('alternar'); // 'toggle'
+ * ptKeywords.toLocale('on'); // 'em'
  * ```
  */
 declare const ptKeywords: KeywordProvider;
@@ -753,9 +741,6 @@ declare const tlKeywords: KeywordProvider;
  * // Get keyword provider for parsing
  * const provider = LocaleManager.get(); // Returns esKeywords
  * const frProvider = LocaleManager.get('fr'); // Returns frKeywords
- *
- * // Use with parser
- * const parser = new Parser({ keywords: LocaleManager.get() });
  * ```
  */
 declare class LocaleManager {
@@ -842,10 +827,9 @@ declare class LocaleManager {
  * @example
  * ```typescript
  * import { detectBrowserLocale } from '@lokascript/i18n/parser';
- * import { Parser } from '@hyperfixi/core';
  *
- * // Auto-detect and use browser locale
- * const parser = new Parser({ keywords: detectBrowserLocale() });
+ * // The provider for the browser's language (navigator.languages), or English
+ * detectBrowserLocale().locale; // e.g. 'es'
  * ```
  */
 declare function detectBrowserLocale(): KeywordProvider;

package/dist/{index-BykxjYST.d.cts → index-C4L2RKNl.d.cts}

@@ -3,15 +3,16 @@ import { D as Dictionary } from './types-BYtpqGq3.cjs';
 /**
  * KeywordProvider interface for locale-aware parsing.
  *
- * This interface allows the parser to resolve non-English keywords
- * to their canonical English equivalents, enabling multilingual
- * hyperscript syntax.
+ * A provider resolves a locale's keywords to their canonical English
+ * equivalents and back (`@hyperfixi/core` 3.x's parser reads one through its
+ * `keywords` parse option).
  *
  * @example
  * ```typescript
  * import { esKeywords } from '@lokascript/i18n/parser/es';
- * const parser = new Parser({ keywords: esKeywords });
- * parser.parse('en clic alternar .active'); // Works!
+ *
+ * esKeywords.resolve('alternar'); // 'toggle'
+ * esKeywords.toLocale('toggle'); // 'alternar'
  * ```
  */
 interface KeywordProvider {
@@ -369,10 +370,9 @@ declare const es: Dictionary;
  * @example
  * ```typescript
  * import { esKeywords } from '@lokascript/i18n/parser/es';
- * import { Parser } from '@hyperfixi/core';
  *
- * const parser = new Parser({ keywords: esKeywords });
- * parser.parse('en clic alternar .active');
+ * esKeywords.resolve('alternar'); // 'toggle'
+ * esKeywords.toLocale('on'); // 'en'
  * ```
  */
 declare const esKeywords: KeywordProvider;
@@ -397,10 +397,9 @@ declare const ja: Dictionary;
  * @example
  * ```typescript
  * import { jaKeywords } from '@lokascript/i18n/parser/ja';
- * import { Parser } from '@hyperfixi/core';
  *
- * const parser = new Parser({ keywords: jaKeywords });
- * parser.parse('クリック で 切り替え .active');
+ * jaKeywords.resolve('切り替え'); // 'toggle'
+ * jaKeywords.toLocale('on'); // 'で'
  * ```
  */
 declare const jaKeywords: KeywordProvider;
@@ -420,10 +419,9 @@ declare const fr: Dictionary;
  * @example
  * ```typescript
  * import { frKeywords } from '@lokascript/i18n/parser/fr';
- * import { Parser } from '@hyperfixi/core';
  *
- * const parser = new Parser({ keywords: frKeywords });
- * parser.parse('sur clic basculer .active');
+ * frKeywords.resolve('basculer'); // 'toggle'
+ * frKeywords.toLocale('on'); // 'sur'
  * ```
  */
 declare const frKeywords: KeywordProvider;
@@ -448,10 +446,9 @@ declare const de: Dictionary;
  * @example
  * ```typescript
  * import { deKeywords } from '@lokascript/i18n/parser/de';
- * import { Parser } from '@hyperfixi/core';
  *
- * const parser = new Parser({ keywords: deKeywords });
- * parser.parse('bei klick umschalten .active');
+ * deKeywords.resolve('umschalten'); // 'toggle'
+ * deKeywords.toLocale('on'); // 'bei'
  * ```
  */
 declare const deKeywords: KeywordProvider;
@@ -480,10 +477,9 @@ declare const ar: Dictionary;
  * @example
  * ```typescript
  * import { arKeywords } from '@lokascript/i18n/parser/ar';
- * import { Parser } from '@hyperfixi/core';
  *
- * const parser = new Parser({ keywords: arKeywords });
- * parser.parse('على نقر بدل .active');
+ * arKeywords.resolve('بدل'); // 'toggle'
+ * arKeywords.toLocale('on'); // 'على'
  * ```
  */
 declare const arKeywords: KeywordProvider;
@@ -509,10 +505,9 @@ declare const ko: Dictionary;
  * @example
  * ```typescript
  * import { koKeywords } from '@lokascript/i18n/parser/ko';
- * import { Parser } from '@hyperfixi/core';
  *
- * const parser = new Parser({ keywords: koKeywords });
- * parser.parse('에 클릭 토글 .active');
+ * koKeywords.resolve('토글'); // 'toggle'
+ * koKeywords.toLocale('on'); // '에'
  * ```
  */
 declare const koKeywords: KeywordProvider;
@@ -539,10 +534,8 @@ declare const zh: Dictionary;
  * @example
  * ```typescript
  * import { zhKeywords } from '@lokascript/i18n/parser/zh';
- * import { Parser } from '@hyperfixi/core';
  *
- * const parser = new Parser({ keywords: zhKeywords });
- * parser.parse('当 点击 切换 .active');
+ * zhKeywords.resolve('切换'); // 'toggle'
  * ```
  */
 declare const zhKeywords: KeywordProvider;
@@ -569,10 +562,9 @@ declare const tr: Dictionary;
  * @example
  * ```typescript
  * import { trKeywords } from '@lokascript/i18n/parser/tr';
- * import { Parser } from '@hyperfixi/core';
  *
- * const parser = new Parser({ keywords: trKeywords });
- * parser.parse('üzerinde tıklama değiştir .active');
+ * trKeywords.resolve('değiştir'); // 'toggle'
+ * trKeywords.toLocale('on'); // 'üzerinde'
  * ```
  */
 declare const trKeywords: KeywordProvider;
@@ -595,10 +587,9 @@ declare const id: Dictionary;
  * @example
  * ```typescript
  * import { idKeywords } from '@lokascript/i18n/parser/id';
- * import { Parser } from '@hyperfixi/core';
  *
- * const parser = new Parser({ keywords: idKeywords });
- * parser.parse('pada klik ganti .active');
+ * idKeywords.resolve('alihkan'); // 'toggle'
+ * idKeywords.toLocale('on'); // 'pada'
  * ```
  */
 declare const idKeywords: KeywordProvider;
@@ -624,10 +615,9 @@ declare const qu: Dictionary;
  * @example
  * ```typescript
  * import { quKeywords } from '@lokascript/i18n/parser/qu';
- * import { Parser } from '@hyperfixi/core';
  *
- * const parser = new Parser({ keywords: quKeywords });
- * parser.parse('ñitiy-pi yapay #count-ta');
+ * quKeywords.resolve('tikray'); // 'toggle'
+ * quKeywords.toLocale('on'); // 'kaqpi'
  * ```
  */
 declare const quKeywords: KeywordProvider;
@@ -653,10 +643,9 @@ declare const sw: Dictionary;
  * @example
  * ```typescript
  * import { swKeywords } from '@lokascript/i18n/parser/sw';
- * import { Parser } from '@hyperfixi/core';
  *
- * const parser = new Parser({ keywords: swKeywords });
- * parser.parse('kwenye bonyeza badilisha .active');
+ * swKeywords.resolve('badilisha'); // 'toggle'
+ * swKeywords.toLocale('on'); // 'kwenye'
  * ```
  */
 declare const swKeywords: KeywordProvider;
@@ -682,10 +671,9 @@ declare const pt: Dictionary;
  * @example
  * ```typescript
  * import { ptKeywords } from '@lokascript/i18n/parser/pt';
- * import { Parser } from '@hyperfixi/core';
  *
- * const parser = new Parser({ keywords: ptKeywords });
- * parser.parse('em clique alternar .active');
+ * ptKeywords.resolve('alternar'); // 'toggle'
+ * ptKeywords.toLocale('on'); // 'em'
  * ```
  */
 declare const ptKeywords: KeywordProvider;
@@ -753,9 +741,6 @@ declare const tlKeywords: KeywordProvider;
  * // Get keyword provider for parsing
  * const provider = LocaleManager.get(); // Returns esKeywords
  * const frProvider = LocaleManager.get('fr'); // Returns frKeywords
- *
- * // Use with parser
- * const parser = new Parser({ keywords: LocaleManager.get() });
  * ```
  */
 declare class LocaleManager {
@@ -842,10 +827,9 @@ declare class LocaleManager {
  * @example
  * ```typescript
  * import { detectBrowserLocale } from '@lokascript/i18n/parser';
- * import { Parser } from '@hyperfixi/core';
  *
- * // Auto-detect and use browser locale
- * const parser = new Parser({ keywords: detectBrowserLocale() });
+ * // The provider for the browser's language (navigator.languages), or English
+ * detectBrowserLocale().locale; // e.g. 'es'
  * ```
  */
 declare function detectBrowserLocale(): KeywordProvider;