@lokascript/i18n 3.2.0 → 4.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lokascript/i18n",
-  "version": "3.2.0",
+  "version": "4.0.0",
   "description": "Keyword dictionaries, keyword providers and grammar profiles for hyperscript",
   "type": "module",
   "main": "dist/index.cjs",
@@ -64,8 +64,7 @@
   },
   "homepage": "https://github.com/codetalcott/hyperfixi/tree/main/packages/i18n#readme",
   "dependencies": {
-    "@hyperfixi/core": "^3.2.0",
-    "@lokascript/semantic": "^3.2.0",
+    "@lokascript/semantic": "^4.0.0",
     "esbuild": "^0.25.12",
     "happy-dom": "^20.14.5",
     "vite": "^8.3.1"
@@ -79,7 +78,8 @@
     "rollup": "^4.63.5",
     "tsup": "^8.0.0",
     "typescript": "^5.0.0",
-    "vitest": "^5.0.2"
+    "vitest": "^5.0.2",
+    "zod": "^4.6.5"
   },
   "files": [
     "dist",

package/src/browser.ts

@@ -6,22 +6,19 @@
  * - LocaleManager for runtime locale switching
  * - Factory functions for custom providers
  *
- * Usage with UMD bundle:
+ * Usage with the browser bundle (`lokascript-i18n.min.js`, global `LokaScriptI18n`):
  * ```html
- * <script src="hyperfixi-core.min.js"></script>
- * <script src="hyperfixi-i18n.min.js"></script>
+ * <script src="lokascript-i18n.min.js"></script>
  * <script>
- *   // Configure HyperFixi with Spanish keywords
- *   HyperFixi.configure({ keywords: HyperFixiI18n.esKeywords });
+ *   LokaScriptI18n.esKeywords.resolve('alternar'); // 'toggle'
  * </script>
  * ```
  *
  * Usage with ES modules:
  * ```typescript
  * import { esKeywords } from '@lokascript/i18n';
- * import { Parser } from '@hyperfixi/core';
  *
- * const parser = new Parser(tokens, { keywords: esKeywords });
+ * esKeywords.resolve('alternar'); // 'toggle'
  * ```
  */
 

package/src/compatibility/browser-tests/grammar-demo.spec.ts

@@ -7,7 +7,7 @@
 import { test, expect } from '@playwright/test';
 
 // NOTE (2026-08-28): no `playwright.config` in this package points at this
-// directory — core's config has `testDir: './src/compatibility/browser-tests'`,
+// directory — core's config has `testDir: './browser-tests'`,
 // which is core's own tree — so CI does not run this file. It is kept correct
 // rather than deleted, but do not read a green CI as evidence it passes.
 

package/src/grammar/index.ts

@@ -70,7 +70,8 @@ export {
 // them (#998).
 //
 // The rest of this directory STAYS and is not part of that retirement: `profiles/`
-// is imported by i18n's own `runtime.ts` and re-exported to the classic-i18n
-// bundle; `types.ts` backs `constants.ts` and the role helpers above;
-// `direct-mappings.ts` is part of the browser API (`types-browser/i18n-api.ts`
-// declares it). This was never "delete the grammar directory".
+// is imported by i18n's own `runtime.ts` (and was re-exported to core's
+// classic-i18n bundle until it retired in Phase C3); `types.ts` backs
+// `constants.ts` and the role helpers above; `direct-mappings.ts` is part of the
+// browser API (`types-browser/i18n-api.ts` declares it). This was never "delete
+// the grammar directory".

package/src/grammar/profiles.test.ts

@@ -7,8 +7,9 @@
  * (see grammar/index.ts); these are not.
  *
  * They cover the half of `grammar/` that STAYS and has its own consumers:
- * `profiles/` (i18n's `runtime.ts`, and the classic-i18n browser bundle's
- * `getProfile` / `getSupportedGrammarLocales` / `profiles` surface), the role
+ * `profiles/` (i18n's `runtime.ts`; core's classic-i18n browser bundle exposed
+ * them as `getProfile` / `getSupportedGrammarLocales` / `profiles` until Phase
+ * C3 retired it), the role
  * helpers in `types.ts` (`reorderRoles` / `insertMarkers` / `joinTokens`, which
  * `constants.ts` imports from), and the has/have dictionary entries.
  */

package/src/parser/ar.ts

@@ -26,10 +26,9 @@ import type { KeywordProvider } from './types';
  * @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'); // 'على'
  * ```
  */
 export const arKeywords: KeywordProvider = createKeywordProvider(ar, 'ar', {

package/src/parser/de.ts

@@ -22,10 +22,9 @@ import type { KeywordProvider } from './types';
  * @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'
  * ```
  */
 export const deKeywords: KeywordProvider = createKeywordProvider(de, 'de', {

package/src/parser/es.ts

@@ -17,10 +17,9 @@ import type { KeywordProvider } from './types';
  * @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'
  * ```
  */
 export const esKeywords: KeywordProvider = createKeywordProvider(es, 'es', {

package/src/parser/fr.ts

@@ -17,10 +17,9 @@ import type { KeywordProvider } from './types';
  * @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'
  * ```
  */
 export const frKeywords: KeywordProvider = createKeywordProvider(fr, 'fr', {

package/src/parser/he.ts

@@ -15,10 +15,9 @@ import type { KeywordProvider } from './types';
  * @example
  * ```typescript
  * import { heKeywords } from '@lokascript/i18n/parser/he';
- * import { Parser } from '@hyperfixi/core';
  *
- * const parser = new Parser({ keywords: heKeywords });
- * parser.parse('ב לחיצה מתג .active');
+ * heKeywords.resolve('מתג'); // 'toggle'
+ * heKeywords.toLocale('on'); // 'ב'
  * ```
  */
 export const heKeywords: KeywordProvider = createKeywordProvider(he, 'he', {

package/src/parser/id.ts

@@ -20,10 +20,9 @@ import type { KeywordProvider } from './types';
  * @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'
  * ```
  */
 export const idKeywords: KeywordProvider = createKeywordProvider(id, 'id', {

package/src/parser/index.ts

@@ -3,20 +3,18 @@
 /**
  * Parser integration for multilingual hyperscript.
  *
- * This module provides KeywordProvider implementations that enable
- * the hyperscript parser to understand non-English keywords.
+ * This module provides KeywordProvider implementations: each resolves a
+ * locale's hyperscript keywords to canonical English and back.
  *
  * @example
  * ```typescript
  * // Spanish
  * import { esKeywords } from '@lokascript/i18n/parser';
- * const parser = new Parser({ keywords: esKeywords });
- * parser.parse('en clic alternar .active');
+ * esKeywords.resolve('alternar'); // 'toggle'
  *
  * // Japanese
  * import { jaKeywords } from '@lokascript/i18n/parser';
- * const parser = new Parser({ keywords: jaKeywords });
- * parser.parse('クリック で 切り替え .active');
+ * jaKeywords.resolve('切り替え'); // 'toggle'
  *
  * // Custom locale
  * import { createKeywordProvider } from '@lokascript/i18n/parser';

package/src/parser/ja.ts

@@ -22,10 +22,9 @@ import type { KeywordProvider } from './types';
  * @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'); // 'で'
  * ```
  */
 export const jaKeywords: KeywordProvider = createKeywordProvider(ja, 'ja', {

package/src/parser/ko.ts

@@ -23,10 +23,9 @@ import type { KeywordProvider } from './types';
  * @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'); // '에'
  * ```
  */
 export const koKeywords: KeywordProvider = createKeywordProvider(ko, 'ko', {

package/src/parser/locale-manager.ts

@@ -26,9 +26,6 @@ import { createEnglishProvider } from './create-provider';
  * // 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() });
  * ```
  */
 export class LocaleManager {
@@ -169,10 +166,9 @@ export 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'
  * ```
  */
 export function detectBrowserLocale(): KeywordProvider {

package/src/parser/pt.ts

@@ -23,10 +23,9 @@ import type { KeywordProvider } from './types';
  * @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'
  * ```
  */
 export const ptKeywords: KeywordProvider = createKeywordProvider(pt, 'pt', {

package/src/parser/qu.ts

@@ -23,10 +23,9 @@ import type { KeywordProvider } from './types';
  * @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'
  * ```
  */
 export const quKeywords: KeywordProvider = createKeywordProvider(qu, 'qu', {

package/src/parser/sw.ts

@@ -23,10 +23,9 @@ import type { KeywordProvider } from './types';
  * @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'
  * ```
  */
 export const swKeywords: KeywordProvider = createKeywordProvider(sw, 'sw', {

package/src/parser/tr.ts

@@ -24,10 +24,9 @@ import type { KeywordProvider } from './types';
  * @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'
  * ```
  */
 export const trKeywords: KeywordProvider = createKeywordProvider(tr, 'tr', {

package/src/parser/types.ts

@@ -3,15 +3,16 @@
 /**
  * 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'
  * ```
  */
 export interface KeywordProvider {

package/src/parser/zh.ts

@@ -24,10 +24,8 @@ import type { KeywordProvider } from './types';
  * @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'
  * ```
  */
 export const zhKeywords: KeywordProvider = createKeywordProvider(zh, 'zh', {