@lokascript/hyperscript-adapter 2.9.4 → 2.11.0

package/dist/index.cjs

@@ -23,6 +23,7 @@ __export(index_exports, {
   hyperscriptI18n: () => hyperscriptI18n,
   preprocess: () => preprocess,
   preprocessToEnglish: () => preprocessToEnglish,
+  resetTranslationWarnings: () => resetTranslationWarnings,
   resolveLanguage: () => resolveLanguage
 });
 module.exports = __toCommonJS(index_exports);
@@ -33,6 +34,8 @@ function resolveLanguage(elt) {
   if (dataLang) return normalizeLangCode(dataLang);
   const hsLang = elt.getAttribute("data-hyperscript-lang") ?? elt.closest?.("[data-hyperscript-lang]")?.getAttribute("data-hyperscript-lang");
   if (hsLang) return normalizeLangCode(hsLang);
+  const closestLang = elt.closest?.("[lang]")?.getAttribute("lang");
+  if (closestLang) return normalizeLangCode(closestLang);
   const htmlLang = typeof document !== "undefined" ? document.documentElement?.lang : null;
   if (htmlLang && htmlLang !== "en") return normalizeLangCode(htmlLang);
   return null;
@@ -43,40 +46,17 @@ function normalizeLangCode(lang) {
 
 // src/preprocessor.ts
 var import_semantic = require("@lokascript/semantic");
+
+// src/preprocessor-core.ts
 var DEFAULT_THRESHOLD = 0.5;
 var DEFAULT_CONFIG = {
   confidenceThreshold: DEFAULT_THRESHOLD,
-  strategy: "semantic",
-  fallbackToOriginal: true
+  strategy: "semantic"
 };
 function resolveThreshold(threshold, lang) {
   if (typeof threshold === "number") return threshold;
   return threshold[lang] ?? threshold["*"] ?? DEFAULT_THRESHOLD;
 }
-function preprocessToEnglish(src, lang, config = {}) {
-  if (lang === "en") return src;
-  const cfg = { ...DEFAULT_CONFIG, ...config };
-  const fullResult = tryTranslateWithStrategies(src, lang, cfg);
-  if (fullResult !== null) return fullResult;
-  const stripped = stripEventPrefix(src);
-  if (stripped) {
-    const translated = tryTranslateWithStrategies(stripped.commands, lang, cfg);
-    if (translated !== null) return stripped.prefix + translated;
-  }
-  return cfg.fallbackToOriginal ? src : src;
-}
-function tryTranslateWithStrategies(src, lang, cfg) {
-  if (cfg.strategy === "semantic" || cfg.strategy === "auto") {
-    const threshold = resolveThreshold(cfg.confidenceThreshold, lang);
-    const result = trySemanticTranslation(src, lang, threshold);
-    if (result !== null) return result;
-  }
-  if ((cfg.strategy === "auto" || cfg.strategy === "i18n") && cfg.i18nToEnglish) {
-    const result = tryI18nTranslation(src, lang, cfg.i18nToEnglish);
-    if (result !== null) return result;
-  }
-  return null;
-}
 var EVENT_PREFIX_RE = /^(on\s+(?:every\s+)?[\w-]+(?:\[.*?\])?(?:\.[\w-]+(?:\([^)]*\))?)*(?:\s+from\s+\S+)?(?:\s+queue\s+\w+)?\s+)/;
 function stripEventPrefix(src) {
   const match = src.match(EVENT_PREFIX_RE);
@@ -86,71 +66,66 @@ function stripEventPrefix(src) {
   if (!commands) return null;
   return { prefix, commands };
 }
-function trySemanticTranslation(src, lang, threshold) {
-  try {
-    const statements = splitStatements(src, lang);
-    if (statements.length > 1) {
-      return translateCompound(statements, lang, threshold);
+function createPreprocessToEnglish(hooks) {
+  function trySemanticTranslation(src, lang, threshold) {
+    try {
+      if (!hooks.isLanguageRegistered(lang)) return null;
+      return hooks.translateSingle(src, lang, threshold);
+    } catch {
+      return null;
     }
-    if (!(0, import_semantic.isLanguageRegistered)(lang)) return null;
-    const result = (0, import_semantic.parseSemantic)(src, lang);
-    if (result.confidence < threshold || !result.node) {
-      if (result.confidence >= threshold) {
-        return (0, import_semantic.translate)(src, lang, "en");
-      }
+  }
+  function tryI18nTranslation(src, lang, toEnglish) {
+    try {
+      const result = toEnglish(src, lang);
+      return result !== src ? result : null;
+    } catch {
       return null;
     }
-    return (0, import_semantic.render)(result.node, "en");
-  } catch {
-    return null;
   }
-}
-function tryI18nTranslation(src, lang, toEnglish) {
-  try {
-    const result = toEnglish(src, lang);
-    return result !== src ? result : null;
-  } catch {
+  function tryTranslateWithStrategies(src, lang, cfg) {
+    if (cfg.strategy === "semantic" || cfg.strategy === "auto") {
+      const threshold = resolveThreshold(cfg.confidenceThreshold, lang);
+      const result = trySemanticTranslation(src, lang, threshold);
+      if (result !== null) return result;
+    }
+    if ((cfg.strategy === "auto" || cfg.strategy === "i18n") && cfg.i18nToEnglish) {
+      const result = tryI18nTranslation(src, lang, cfg.i18nToEnglish);
+      if (result !== null) return result;
+    }
     return null;
   }
+  return function preprocessToEnglish2(src, lang, config = {}) {
+    if (lang === "en") return src;
+    const cfg = { ...DEFAULT_CONFIG, ...config };
+    const fullResult = tryTranslateWithStrategies(src, lang, cfg);
+    if (fullResult !== null) return fullResult;
+    const stripped = stripEventPrefix(src);
+    if (stripped) {
+      const translated = tryTranslateWithStrategies(stripped.commands, lang, cfg);
+      if (translated !== null) return stripped.prefix + translated;
+    }
+    return src;
+  };
 }
-function getThenKeywords(lang) {
-  const keywords = ["then"];
-  const profile = (0, import_semantic.tryGetProfile)(lang);
-  if (profile?.keywords?.then) {
-    const kw = profile.keywords.then;
-    if (kw.primary && kw.primary !== "then") keywords.push(kw.primary);
-    if (kw.alternatives) {
-      for (const alt of kw.alternatives) {
-        if (!keywords.includes(alt)) keywords.push(alt);
+
+// src/preprocessor.ts
+var preprocessToEnglish = createPreprocessToEnglish({
+  isLanguageRegistered: import_semantic.isLanguageRegistered,
+  translateSingle(src, lang, threshold) {
+    const result = (0, import_semantic.parseSemantic)(src, lang);
+    if (result.confidence < threshold || !result.node) {
+      if (result.confidence >= threshold) {
+        return (0, import_semantic.translate)(src, lang, "en");
       }
+      return null;
     }
+    return (0, import_semantic.render)(result.node, "en");
   }
-  return keywords;
-}
-function splitStatements(src, lang) {
-  const thenWords = getThenKeywords(lang);
-  const escaped = thenWords.map((w) => w.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"));
-  const pattern = new RegExp(`\\s+(?:${escaped.join("|")})\\s+`, "i");
-  const lines = src.split("\n").map((l) => l.trim()).filter((l) => l.length > 0);
-  const result = [];
-  for (const line of lines) {
-    const parts = line.split(pattern);
-    result.push(...parts);
-  }
-  return result;
-}
-function translateCompound(statements, lang, threshold) {
-  const translated = [];
-  for (const stmt of statements) {
-    const result = trySemanticTranslation(stmt.trim(), lang, threshold);
-    if (result === null) return null;
-    translated.push(result);
-  }
-  return translated.join(" then ");
-}
+});
 
 // src/attribute-translator.ts
-var TRANSLATED_MARKER = "data-hyperscript-i18n-translated";
+var processed = /* @__PURE__ */ new WeakSet();
 function scriptAttributeNames(hs) {
   const raw = hs.config?.attributes ?? "_, script, data-script";
   return raw.split(",").map((s) => s.trim()).filter(Boolean);
@@ -171,12 +146,12 @@ function installAttributeTranslator(hs, translate2) {
   const attrNames = scriptAttributeNames(hs);
   const selector = [...attrNames.map((a) => `[${a}]`), 'script[type="text/hyperscript"]'].join(", ");
   const translateOne = (elt) => {
-    if (elt.hasAttribute(TRANSLATED_MARKER)) return;
+    if (processed.has(elt)) return;
     if (elt instanceof HTMLScriptElement && elt.type === "text/hyperscript") {
       const src2 = elt.textContent ?? "";
       if (!src2) return;
       const english2 = translate2(src2, elt);
-      elt.setAttribute(TRANSLATED_MARKER, "");
+      processed.add(elt);
       if (english2 != null && english2 !== src2) elt.textContent = english2;
       return;
     }
@@ -185,7 +160,7 @@ function installAttributeTranslator(hs, translate2) {
     const src = elt.getAttribute(attr);
     if (!src) return;
     const english = translate2(src, elt);
-    elt.setAttribute(TRANSLATED_MARKER, "");
+    processed.add(elt);
     if (english != null && english !== src) elt.setAttribute(attr, english);
   };
   hs.addBeforeProcessHook((root) => {
@@ -195,21 +170,66 @@ function installAttributeTranslator(hs, translate2) {
   });
 }
 
+// src/host-validate.ts
+function acceptedByHost(hs, src) {
+  if (typeof hs.parse !== "function") return true;
+  try {
+    const result = hs.parse(src);
+    return !result?.errors || result.errors.length === 0;
+  } catch {
+    return false;
+  }
+}
+var warnedRejectedLang = /* @__PURE__ */ new Set();
+function resetHostValidationWarnings() {
+  warnedRejectedLang.clear();
+}
+function warnRejectedOnce(lang, src, english) {
+  if (warnedRejectedLang.has(lang)) return;
+  warnedRejectedLang.add(lang);
+  console.warn(
+    `[hyperscript-i18n] Translation for lang="${lang}" rendered hyperscript the host parser rejects \u2014 falling back to the original text. Source: "${src.length > 60 ? src.slice(0, 60) + "\u2026" : src}" \u2192 "${english.length > 60 ? english.slice(0, 60) + "\u2026" : english}". Further elements in this language stay quiet \u2014 enable { debug: true } for per-element detail.`
+  );
+}
+
 // src/plugin.ts
+var warnedUnchangedLang = /* @__PURE__ */ new Set();
+function resetTranslationWarnings() {
+  warnedUnchangedLang.clear();
+  resetHostValidationWarnings();
+}
+function warnUnchangedOnce(lang, src) {
+  if (warnedUnchangedLang.has(lang)) return;
+  warnedUnchangedLang.add(lang);
+  console.warn(
+    `[hyperscript-i18n] Translation unchanged for lang="${lang}": "${src.length > 60 ? src.slice(0, 60) + "\u2026" : src}". This is fine if the source is already canonical English; otherwise the input may not match any known pattern, or the language may not be registered. Original text is passed to _hyperscript as-is. Further elements in this language stay quiet \u2014 enable { debug: true } for per-element detail.`
+  );
+}
 function hyperscriptI18n(options = {}) {
   return function plugin(hs) {
-    installAttributeTranslator(hs, (src, elt) => {
+    const host = hs;
+    installAttributeTranslator(host, (src, elt) => {
       const lang = resolveLanguageWithOptions(elt, options);
       if (!lang || lang === "en") return src;
       const english = preprocessToEnglish(src, lang, options);
       if (english !== src) {
+        if (options.validateWithHost !== false && !acceptedByHost(host, english)) {
+          if (options.debug) {
+            console.log(
+              `[hyperscript-i18n] ${lang}: host rejected "${english}" \u2014 keeping "${src}"`
+            );
+          } else {
+            warnRejectedOnce(lang, src, english);
+          }
+          return src;
+        }
         if (options.debug) {
           console.log(`[hyperscript-i18n] ${lang}: "${src}" \u2192 "${english}"`);
         }
+      } else if (options.debug) {
+        console.log(`[hyperscript-i18n] ${lang}: unchanged "${src}"`);
       } else {
-        console.warn(
-          `[hyperscript-i18n] Translation unchanged for lang="${lang}": "${src.length > 60 ? src.slice(0, 60) + "\u2026" : src}". The input may not match any known pattern, or the language may not be registered. Original text will be passed to _hyperscript as-is.`
-        );
+        warnUnchangedOnce(lang, src);
       }
       return english;
     });
@@ -233,6 +253,7 @@ function preprocess(src, lang, config = {}) {
   hyperscriptI18n,
   preprocess,
   preprocessToEnglish,
+  resetTranslationWarnings,
   resolveLanguage
 });
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/language-resolver.ts","../src/preprocessor.ts","../src/attribute-translator.ts","../src/plugin.ts"],"sourcesContent":["/**\n * @lokascript/hyperscript-adapter\n *\n * Multilingual adapter plugin for the original _hyperscript.\n * Enables writing hyperscript in any of 24 supported languages.\n *\n * @example\n * import { hyperscriptI18n } from '@lokascript/hyperscript-adapter';\n * _hyperscript.use(hyperscriptI18n());\n *\n * @example\n * // With options\n * _hyperscript.use(hyperscriptI18n({\n *   defaultLanguage: 'ja',\n *   debug: true,\n * }));\n *\n * @example\n * // Standalone preprocessing (for _hyperscript.evaluate() calls)\n * import { preprocess } from '@lokascript/hyperscript-adapter';\n * const english = preprocess('トグル .active', 'ja');\n * _hyperscript(english);\n */\n\nexport { hyperscriptI18n, preprocess, type PluginOptions } from './plugin';\nexport { preprocessToEnglish, type PreprocessorConfig } from './preprocessor';\nexport { resolveLanguage } from './language-resolver';\n","/**\n * Language Resolver\n *\n * Determines the language of hyperscript code on a given element\n * using a cascading resolution strategy.\n */\n\n/**\n * Resolve the language for a hyperscript attribute on an element.\n *\n * Resolution order:\n * 1. `data-lang` attribute on the element itself\n * 2. `data-hyperscript-lang` attribute on the element or closest ancestor\n * 3. `lang` attribute on `<html>` element\n * 4. null (assume English, no preprocessing needed)\n */\nexport function resolveLanguage(elt: Element): string | null {\n  // 1. Explicit per-element\n  const dataLang = elt.getAttribute('data-lang');\n  if (dataLang) return normalizeLangCode(dataLang);\n\n  // 2. Inherited from ancestor\n  const hsLang =\n    elt.getAttribute('data-hyperscript-lang') ??\n    elt.closest?.('[data-hyperscript-lang]')?.getAttribute('data-hyperscript-lang');\n  if (hsLang) return normalizeLangCode(hsLang);\n\n  // 3. Document-level lang\n  const htmlLang = typeof document !== 'undefined' ? document.documentElement?.lang : null;\n  if (htmlLang && htmlLang !== 'en') return normalizeLangCode(htmlLang);\n\n  return null;\n}\n\n/**\n * Normalize a BCP-47 language tag to an ISO 639-1 code.\n * e.g., \"ja-JP\" → \"ja\", \"zh-Hans\" → \"zh\", \"pt-BR\" → \"pt\"\n */\nfunction normalizeLangCode(lang: string): string {\n  return lang.split('-')[0].toLowerCase();\n}\n","/**\n * Preprocessor\n *\n * Translates non-English hyperscript to English using the semantic parser\n * (with optional i18n fallback), so the original _hyperscript can parse it.\n */\n\nimport {\n  translate,\n  render,\n  parseSemantic,\n  isLanguageRegistered,\n  tryGetProfile,\n} from '@lokascript/semantic';\n\nexport interface PreprocessorConfig {\n  /**\n   * Minimum confidence threshold for semantic parsing (0-1). Default: 0.5.\n   * Can be a single number (applies to all languages) or a per-language map.\n   * Per-language thresholds are useful because SOV languages (ja, ko, tr) produce\n   * inherently lower confidence scores than SVO languages (es, fr, de).\n   *\n   * @example\n   * // Single threshold\n   * { confidenceThreshold: 0.5 }\n   *\n   * @example\n   * // Per-language thresholds\n   * { confidenceThreshold: { es: 0.7, ja: 0.1, ko: 0.05, '*': 0.5 } }\n   */\n  confidenceThreshold: number | Record<string, number>;\n  /** Strategy: 'semantic' (default), 'i18n', or 'auto' (semantic then i18n) */\n  strategy: 'semantic' | 'i18n' | 'auto';\n  /** Whether to return original text on failure. Default: true */\n  fallbackToOriginal: boolean;\n  /** Optional i18n toEnglish function (loaded dynamically if available) */\n  i18nToEnglish?: (input: string, locale: string) => string;\n}\n\nconst DEFAULT_THRESHOLD = 0.5;\n\nconst DEFAULT_CONFIG: PreprocessorConfig = {\n  confidenceThreshold: DEFAULT_THRESHOLD,\n  strategy: 'semantic',\n  fallbackToOriginal: true,\n};\n\n/**\n * Resolve the confidence threshold for a specific language.\n * Supports both a single number and a per-language map with '*' as default.\n */\nfunction resolveThreshold(threshold: number | Record<string, number>, lang: string): number {\n  if (typeof threshold === 'number') return threshold;\n  return threshold[lang] ?? threshold['*'] ?? DEFAULT_THRESHOLD;\n}\n\n/**\n * Preprocess non-English hyperscript into English.\n *\n * Uses the semantic parser to parse the input in the source language,\n * then renders back to English. Falls through to i18n if configured.\n *\n * Handles _hyperscript feature prefixes (e.g. \"on click\", \"on every keyup\")\n * by stripping them, translating only the command portion, then reassembling.\n */\nexport function preprocessToEnglish(\n  src: string,\n  lang: string,\n  config: Partial<PreprocessorConfig> = {}\n): string {\n  // English→English is identity; skip semantic parsing which may mangle the input\n  if (lang === 'en') return src;\n\n  const cfg = { ...DEFAULT_CONFIG, ...config };\n\n  // Try translating the full string first\n  const fullResult = tryTranslateWithStrategies(src, lang, cfg);\n  if (fullResult !== null) return fullResult;\n\n  // If full translation failed, try stripping event/feature prefix.\n  // _hyperscript attributes often contain \"on <event> <commands>\" — the semantic\n  // parser only understands command syntax, not event declarations.\n  const stripped = stripEventPrefix(src);\n  if (stripped) {\n    const translated = tryTranslateWithStrategies(stripped.commands, lang, cfg);\n    if (translated !== null) return stripped.prefix + translated;\n  }\n\n  // Fallback: return original\n  return cfg.fallbackToOriginal ? src : src;\n}\n\n/**\n * Try all configured translation strategies on the input.\n * Returns null if none succeed.\n */\nfunction tryTranslateWithStrategies(\n  src: string,\n  lang: string,\n  cfg: PreprocessorConfig\n): string | null {\n  // Strategy: semantic-only\n  if (cfg.strategy === 'semantic' || cfg.strategy === 'auto') {\n    const threshold = resolveThreshold(cfg.confidenceThreshold, lang);\n    const result = trySemanticTranslation(src, lang, threshold);\n    if (result !== null) return result;\n  }\n\n  // Strategy: i18n fallback (auto mode or i18n-only)\n  if ((cfg.strategy === 'auto' || cfg.strategy === 'i18n') && cfg.i18nToEnglish) {\n    const result = tryI18nTranslation(src, lang, cfg.i18nToEnglish);\n    if (result !== null) return result;\n  }\n\n  return null;\n}\n\n/**\n * Match _hyperscript event handler prefix: \"on [every] <event>[filter][.modifiers] \"\n *\n * Examples:\n *   \"on click toggle .active\"            → prefix: \"on click \", commands: \"toggle .active\"\n *   \"on every click toggle .active\"      → prefix: \"on every click \", commands: \"toggle .active\"\n *   \"on click.debounce(300) toggle .x\"   → prefix: \"on click.debounce(300) \", commands: \"toggle .x\"\n *   \"on keyup[key=='Enter'] set x to 1\"  → prefix: \"on keyup[key=='Enter'] \", commands: \"set x to 1\"\n *   \"on click from body toggle .active\"  → prefix: \"on click from body \", commands: \"toggle .active\"\n */\nconst EVENT_PREFIX_RE =\n  /^(on\\s+(?:every\\s+)?[\\w-]+(?:\\[.*?\\])?(?:\\.[\\w-]+(?:\\([^)]*\\))?)*(?:\\s+from\\s+\\S+)?(?:\\s+queue\\s+\\w+)?\\s+)/;\n\nfunction stripEventPrefix(src: string): { prefix: string; commands: string } | null {\n  const match = src.match(EVENT_PREFIX_RE);\n  if (!match) return null;\n  const prefix = match[1];\n  const commands = src.slice(prefix.length);\n  if (!commands) return null;\n  return { prefix, commands };\n}\n\n/**\n * Try semantic translation: parse in source language, render to English.\n * Returns null if confidence is below threshold.\n */\nfunction trySemanticTranslation(src: string, lang: string, threshold: number): string | null {\n  try {\n    // Handle compound statements (split on \"then\" boundaries and newlines)\n    const statements = splitStatements(src, lang);\n    if (statements.length > 1) {\n      return translateCompound(statements, lang, threshold);\n    }\n\n    // Check if the semantic parser can handle this\n    if (!isLanguageRegistered(lang)) return null;\n\n    const result = parseSemantic(src, lang);\n    if (result.confidence < threshold || !result.node) {\n      // If we got SOME confidence but no node, fall back to translate()\n      if (result.confidence >= threshold) {\n        return translate(src, lang, 'en');\n      }\n      return null;\n    }\n\n    // Render the semantic node to English\n    return render(result.node, 'en');\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Try i18n grammar transformation to English.\n * Returns null if the result is identical to input (no translation happened).\n */\nfunction tryI18nTranslation(\n  src: string,\n  lang: string,\n  toEnglish: (input: string, locale: string) => string\n): string | null {\n  try {\n    const result = toEnglish(src, lang);\n    return result !== src ? result : null;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Get all \"then\" keyword forms for a language (primary + alternatives).\n * Falls back to English \"then\" if profile is unavailable.\n */\nfunction getThenKeywords(lang: string): string[] {\n  const keywords = ['then']; // Always include English\n  const profile = tryGetProfile(lang);\n  if (profile?.keywords?.then) {\n    const kw = profile.keywords.then;\n    if (kw.primary && kw.primary !== 'then') keywords.push(kw.primary);\n    if (kw.alternatives) {\n      for (const alt of kw.alternatives) {\n        if (!keywords.includes(alt)) keywords.push(alt);\n      }\n    }\n  }\n  return keywords;\n}\n\n/**\n * Split a hyperscript source string into individual statements.\n * Splits on language-specific \"then\" keywords and newlines.\n */\nfunction splitStatements(src: string, lang: string): string[] {\n  const thenWords = getThenKeywords(lang);\n  // Escape regex special chars and build pattern\n  const escaped = thenWords.map(w => w.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&'));\n  const pattern = new RegExp(`\\\\s+(?:${escaped.join('|')})\\\\s+`, 'i');\n\n  // Split on newlines first\n  const lines = src\n    .split('\\n')\n    .map(l => l.trim())\n    .filter(l => l.length > 0);\n  const result: string[] = [];\n  for (const line of lines) {\n    const parts = line.split(pattern);\n    result.push(...parts);\n  }\n  return result;\n}\n\n/**\n * Translate compound statements individually and rejoin with \" then \".\n */\nfunction translateCompound(statements: string[], lang: string, threshold: number): string | null {\n  const translated: string[] = [];\n  for (const stmt of statements) {\n    const result = trySemanticTranslation(stmt.trim(), lang, threshold);\n    if (result === null) return null; // If any part fails, fail the whole compound\n    translated.push(result);\n  }\n  return translated.join(' then ');\n}\n","/**\n * Attribute translator\n *\n * _hyperscript.org's Runtime#getScript is a private class field (`#getScript`),\n * not a property reachable through `internals.runtime` — every plugin variant\n * in this package used to monkey-patch `internals.runtime.getScript`, which\n * silently no-ops against current _hyperscript.org builds (the assignment\n * creates a stray own-property that the runtime's internal `#getScript()`\n * calls never read, so translation never happens and errors are swallowed by\n * `runtime.getScript.bind` throwing before any hyperscript even parses).\n *\n * `addBeforeProcessHook` is the supported, public extension point instead: it\n * fires on the subtree root passed to `processNode()` before the runtime reads\n * whichever configured attribute (`_`, `script`, `data-script` by default) or\n * `<script type=\"text/hyperscript\">` body holds the source. Rewriting that\n * attribute/body in place — before the runtime's own scan reaches it — gets\n * the same \"translate before parse\" effect through a mechanism the runtime\n * actually calls.\n */\n\nexport interface HyperscriptHost {\n  addBeforeProcessHook?: (fn: (elt: Element) => void) => void;\n  config?: { attributes?: string };\n}\n\n/** Marks an element as already translated so a later `processNode()` call over\n *  the same subtree (e.g. a sibling swap re-scanning a shared ancestor) doesn't\n *  re-translate already-English text as if it were still the original language. */\nconst TRANSLATED_MARKER = 'data-hyperscript-i18n-translated';\n\nfunction scriptAttributeNames(hs: HyperscriptHost): string[] {\n  const raw = hs.config?.attributes ?? '_, script, data-script';\n  return raw\n    .split(',')\n    .map(s => s.trim())\n    .filter(Boolean);\n}\n\nfunction findScriptAttribute(elt: Element, attrNames: string[]): string | null {\n  for (const name of attrNames) {\n    if (elt.hasAttribute(name)) return name;\n  }\n  return null;\n}\n\n/**\n * Install a translator that rewrites non-English script attributes to English\n * in place, before `_hyperscript.org` parses them.\n *\n * @param translate Given the raw source and its element, return the English\n *   translation, or `null`/the same string to leave the element untouched\n *   (English input, unresolved language, translation failure, etc).\n */\nexport function installAttributeTranslator(\n  hs: HyperscriptHost,\n  translate: (src: string, elt: Element) => string | null\n): void {\n  if (typeof hs.addBeforeProcessHook !== 'function') {\n    console.warn(\n      '[hyperscript-i18n] _hyperscript.addBeforeProcessHook is unavailable — ' +\n        'this build of _hyperscript.org is not supported. Load a current version ' +\n        'from https://unpkg.com/hyperscript.org.'\n    );\n    return;\n  }\n\n  const attrNames = scriptAttributeNames(hs);\n  const selector = [...attrNames.map(a => `[${a}]`), 'script[type=\"text/hyperscript\"]'].join(', ');\n\n  const translateOne = (elt: Element): void => {\n    if (elt.hasAttribute(TRANSLATED_MARKER)) return;\n\n    if (elt instanceof HTMLScriptElement && elt.type === 'text/hyperscript') {\n      const src = elt.textContent ?? '';\n      if (!src) return;\n      const english = translate(src, elt);\n      elt.setAttribute(TRANSLATED_MARKER, '');\n      if (english != null && english !== src) elt.textContent = english;\n      return;\n    }\n\n    const attr = findScriptAttribute(elt, attrNames);\n    if (!attr) return;\n    const src = elt.getAttribute(attr);\n    if (!src) return;\n    const english = translate(src, elt);\n    elt.setAttribute(TRANSLATED_MARKER, '');\n    if (english != null && english !== src) elt.setAttribute(attr, english);\n  };\n\n  hs.addBeforeProcessHook((root: Element) => {\n    if (!root || typeof root.querySelectorAll !== 'function') return;\n    if (typeof root.matches === 'function' && root.matches(selector)) translateOne(root);\n    root.querySelectorAll(selector).forEach(translateOne);\n  });\n}\n","/**\n * _hyperscript Plugin\n *\n * Registers with _hyperscript.use() to rewrite non-English hyperscript\n * attributes into English before _hyperscript.org parses them.\n */\n\nimport { resolveLanguage } from './language-resolver';\nimport { preprocessToEnglish, type PreprocessorConfig } from './preprocessor';\nimport { installAttributeTranslator, type HyperscriptHost } from './attribute-translator';\n\nexport interface PluginOptions extends Partial<PreprocessorConfig> {\n  /** Default language for all elements (overridable per-element). */\n  defaultLanguage?: string;\n  /** Custom attribute name for per-element language. Default: \"data-lang\" */\n  languageAttribute?: string;\n  /** Enable debug logging to console. Default: false */\n  debug?: boolean;\n}\n\n/**\n * Create a _hyperscript plugin that enables multilingual hyperscript.\n *\n * @example\n * // Basic usage\n * _hyperscript.use(hyperscriptI18n());\n *\n * @example\n * // With options\n * _hyperscript.use(hyperscriptI18n({\n *   defaultLanguage: 'ja',\n *   confidenceThreshold: 0.6,\n *   debug: true,\n * }));\n */\nexport function hyperscriptI18n(options: PluginOptions = {}) {\n  return function plugin(hs: unknown): void {\n    installAttributeTranslator(hs as HyperscriptHost, (src, elt) => {\n      // Resolve language\n      const lang = resolveLanguageWithOptions(elt, options);\n\n      // If English or no language detected, pass through\n      if (!lang || lang === 'en') return src;\n\n      // Preprocess to English\n      const english = preprocessToEnglish(src, lang, options);\n\n      if (english !== src) {\n        if (options.debug) {\n          console.log(`[hyperscript-i18n] ${lang}: \"${src}\" → \"${english}\"`);\n        }\n      } else {\n        // Translation produced no change — likely a failure\n        console.warn(\n          `[hyperscript-i18n] Translation unchanged for lang=\"${lang}\": \"${src.length > 60 ? src.slice(0, 60) + '…' : src}\". ` +\n            'The input may not match any known pattern, or the language may not be registered. ' +\n            'Original text will be passed to _hyperscript as-is.'\n        );\n      }\n\n      return english;\n    });\n  };\n}\n\n/**\n * Resolve language with plugin options factored in.\n */\nfunction resolveLanguageWithOptions(elt: Element, options: PluginOptions): string | null {\n  // Check custom attribute name\n  if (options.languageAttribute) {\n    const custom = elt.getAttribute(options.languageAttribute);\n    if (custom) return custom.split('-')[0].toLowerCase();\n  }\n\n  // Standard resolution\n  const resolved = resolveLanguage(elt);\n  if (resolved) return resolved;\n\n  // Fall back to default language\n  return options.defaultLanguage ?? null;\n}\n\n/**\n * Standalone preprocessing function for programmatic use.\n * Call this when using _hyperscript.evaluate() or _hyperscript(\"code\") directly.\n *\n * @example\n * const english = preprocess(\"トグル .active\", \"ja\");\n * _hyperscript(english);\n */\nexport function preprocess(\n  src: string,\n  lang: string,\n  config: Partial<PreprocessorConfig> = {}\n): string {\n  if (lang === 'en') return src;\n  return preprocessToEnglish(src, lang, config);\n}\n"],"mappings":"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","names":["translate","src","english"]}
+{"version":3,"sources":["../src/index.ts","../src/language-resolver.ts","../src/preprocessor.ts","../src/preprocessor-core.ts","../src/attribute-translator.ts","../src/host-validate.ts","../src/plugin.ts"],"sourcesContent":["/**\n * @lokascript/hyperscript-adapter\n *\n * Multilingual adapter plugin for the original _hyperscript.\n * Enables writing hyperscript in any of 24 supported languages.\n *\n * @example\n * import { hyperscriptI18n } from '@lokascript/hyperscript-adapter';\n * _hyperscript.use(hyperscriptI18n());\n *\n * @example\n * // With options\n * _hyperscript.use(hyperscriptI18n({\n *   defaultLanguage: 'ja',\n *   debug: true,\n * }));\n *\n * @example\n * // Standalone preprocessing (for _hyperscript.evaluate() calls)\n * import { preprocess } from '@lokascript/hyperscript-adapter';\n * const english = preprocess('トグル .active', 'ja');\n * _hyperscript(english);\n */\n\nexport {\n  hyperscriptI18n,\n  preprocess,\n  resetTranslationWarnings,\n  type PluginOptions,\n} from './plugin';\nexport { preprocessToEnglish, type PreprocessorConfig } from './preprocessor';\nexport { resolveLanguage } from './language-resolver';\n","/**\n * Language Resolver\n *\n * Determines the language of hyperscript code on a given element\n * using a cascading resolution strategy.\n */\n\n/**\n * Resolve the language for a hyperscript attribute on an element.\n *\n * Resolution order:\n * 1. `data-lang` attribute on the element itself\n * 2. `data-hyperscript-lang` attribute on the element or closest ancestor\n * 3. `lang` attribute on the element or closest ancestor (the HTML-standard\n *    cascade — a `<section lang=\"es\">` localizes everything inside it, and a\n *    nested `lang=\"en\"` opts back out). This is how the paired htmx-adapter\n *    (`langOf()`) and loka-js resolve language, so `hx-*` and `_` attributes\n *    on the same element agree.\n * 4. `lang` on `<html>` via `document.documentElement` — only reachable when\n *    the element is DETACHED (step 3's ancestor walk covers `<html>` for\n *    attached elements): a hook processing a not-yet-inserted fragment still\n *    picks up the page default.\n * 5. null (assume English, no preprocessing needed)\n */\nexport function resolveLanguage(elt: Element): string | null {\n  // 1. Explicit per-element\n  const dataLang = elt.getAttribute('data-lang');\n  if (dataLang) return normalizeLangCode(dataLang);\n\n  // 2. Inherited from ancestor\n  const hsLang =\n    elt.getAttribute('data-hyperscript-lang') ??\n    elt.closest?.('[data-hyperscript-lang]')?.getAttribute('data-hyperscript-lang');\n  if (hsLang) return normalizeLangCode(hsLang);\n\n  // 3. Standard lang cascade (nearest ancestor wins)\n  const closestLang = elt.closest?.('[lang]')?.getAttribute('lang');\n  if (closestLang) return normalizeLangCode(closestLang);\n\n  // 4. Document-level lang (detached elements only — see doc comment)\n  const htmlLang = typeof document !== 'undefined' ? document.documentElement?.lang : null;\n  if (htmlLang && htmlLang !== 'en') return normalizeLangCode(htmlLang);\n\n  return null;\n}\n\n/**\n * Normalize a BCP-47 language tag to an ISO 639-1 code.\n * e.g., \"ja-JP\" → \"ja\", \"zh-Hans\" → \"zh\", \"pt-BR\" → \"pt\"\n */\nfunction normalizeLangCode(lang: string): string {\n  return lang.split('-')[0].toLowerCase();\n}\n","/**\n * Preprocessor (full path)\n *\n * Translates non-English hyperscript to English using the semantic parser\n * (with optional i18n fallback), so the original _hyperscript can parse it.\n *\n * The strategy/split/strip skeleton lives in preprocessor-core.ts, shared\n * with the slim path — only HOW one statement is parsed and rendered\n * differs here: semantic's parseSemantic + render('en'), plus a\n * translate() rescue when the parse is confident but yields no node.\n */\n\nimport { translate, render, parseSemantic, isLanguageRegistered } from '@lokascript/semantic';\n\nimport { createPreprocessToEnglish, type PreprocessorConfig } from './preprocessor-core';\n\nexport type { PreprocessorConfig };\n\n/**\n * Preprocess non-English hyperscript into English.\n *\n * Uses the semantic parser to parse the input in the source language,\n * then renders back to English. Falls through to i18n if configured.\n */\nexport const preprocessToEnglish = createPreprocessToEnglish({\n  isLanguageRegistered,\n  translateSingle(src, lang, threshold) {\n    const result = parseSemantic(src, lang);\n    if (result.confidence < threshold || !result.node) {\n      // If we got SOME confidence but no node, fall back to translate()\n      if (result.confidence >= threshold) {\n        return translate(src, lang, 'en');\n      }\n      return null;\n    }\n\n    // Render the semantic node to English\n    return render(result.node, 'en');\n  },\n});\n","/**\n * Preprocessor core — the shared skeleton of the full and slim\n * preprocessors.\n *\n * Everything that is NOT genuinely different between the two paths lives\n * here exactly once: config defaults/threshold resolution, strategy\n * ordering (semantic → optional i18n), event-prefix stripping, and the\n * return-original fallback. The two real differences stay with each path,\n * injected as hooks:\n *\n *   - HOW one statement is parsed and rendered to English\n *     (`translateSingle`): the full path uses semantic's parseSemantic +\n *     render + a translate() rescue for confident-but-nodeless parses;\n *     the slim path uses parseWithConfidence + the custom\n *     hyperscript-renderer (no English language data).\n *   - WHERE the registry lookup comes from (`isLanguageRegistered`):\n *     `@lokascript/semantic` vs `…/core` — under tsup's split dist these\n *     are separate registry instances, so each path must bring its own.\n *\n * Behavior is pinned by the parity ratchet\n * (test/preprocessor-parity.*.test.ts + the committed fixture): both paths\n * are byte-identical to their pre-extraction outputs over the corpus.\n *\n * HISTORY: the skeleton used to carry a compound-splitting fallback\n * (`splitStatements` on localized `then` keywords + newlines,\n * `translateCompound` rejoining pieces with a hardcoded ` then `), run when\n * the whole-string parse declined. Deleted 2026-08-07 after measurement:\n * over all 3703 patterns.db corpus translations plus the parity corpus, on\n * BOTH paths, the split arm produced ZERO final outputs (full: 115\n * invocations, all returned null; slim: 32, all null) — post-whole-string-\n * first (#899), an input whose pieces each parse would have parsed whole,\n * so the arm's success condition is self-defeating. It was also defective\n * twice over: the regex split was string-literal-blind (`say 'now then\n * later'` split inside the literal) and the ` then ` rejoin is invalid\n * immediately after block headers. Deleting it erased both defect classes\n * wholesale; the parity fixture regenerated byte-identical.\n */\n\nexport interface PreprocessorConfig {\n  /**\n   * Minimum confidence threshold for semantic parsing (0-1). Default: 0.5.\n   * Can be a single number (applies to all languages) or a per-language map.\n   * Per-language thresholds are useful because SOV languages (ja, ko, tr) produce\n   * inherently lower confidence scores than SVO languages (es, fr, de).\n   *\n   * @example\n   * // Single threshold\n   * { confidenceThreshold: 0.5 }\n   *\n   * @example\n   * // Per-language thresholds\n   * { confidenceThreshold: { es: 0.7, ja: 0.1, ko: 0.05, '*': 0.5 } }\n   */\n  confidenceThreshold: number | Record<string, number>;\n  /** Strategy: 'semantic' (default), 'i18n', or 'auto' (semantic then i18n) */\n  strategy: 'semantic' | 'i18n' | 'auto';\n  /**\n   * @deprecated Never implemented — `preprocessToEnglish` always returns a\n   * string, and on translation failure that string is the original source\n   * (there is nothing else it could return). The option has had no effect in\n   * any released version and is ignored; it will be removed in a future major.\n   */\n  fallbackToOriginal?: boolean;\n  /** Optional i18n toEnglish function (loaded dynamically if available) */\n  i18nToEnglish?: (input: string, locale: string) => string;\n}\n\n/** The per-path seam — see module doc. */\nexport interface PreprocessorHooks {\n  isLanguageRegistered(lang: string): boolean;\n  /**\n   * Parse ONE statement in `lang` and render it to English. Return null\n   * when it cannot be translated (below-threshold confidence, no node, …);\n   * the skeleton then tries the remaining strategies / falls back.\n   */\n  translateSingle(src: string, lang: string, threshold: number): string | null;\n}\n\nconst DEFAULT_THRESHOLD = 0.5;\n\nconst DEFAULT_CONFIG: PreprocessorConfig = {\n  confidenceThreshold: DEFAULT_THRESHOLD,\n  strategy: 'semantic',\n};\n\n/**\n * Resolve the confidence threshold for a specific language.\n * Supports both a single number and a per-language map with '*' as default.\n */\nfunction resolveThreshold(threshold: number | Record<string, number>, lang: string): number {\n  if (typeof threshold === 'number') return threshold;\n  return threshold[lang] ?? threshold['*'] ?? DEFAULT_THRESHOLD;\n}\n\n/**\n * Match _hyperscript event handler prefix: \"on [every] <event>[filter][.modifiers] \"\n *\n * Examples:\n *   \"on click toggle .active\"            → prefix: \"on click \", commands: \"toggle .active\"\n *   \"on every click toggle .active\"      → prefix: \"on every click \", commands: \"toggle .active\"\n *   \"on click.debounce(300) toggle .x\"   → prefix: \"on click.debounce(300) \", commands: \"toggle .x\"\n *   \"on keyup[key=='Enter'] set x to 1\"  → prefix: \"on keyup[key=='Enter'] \", commands: \"set x to 1\"\n *   \"on click from body toggle .active\"  → prefix: \"on click from body \", commands: \"toggle .active\"\n */\nconst EVENT_PREFIX_RE =\n  /^(on\\s+(?:every\\s+)?[\\w-]+(?:\\[.*?\\])?(?:\\.[\\w-]+(?:\\([^)]*\\))?)*(?:\\s+from\\s+\\S+)?(?:\\s+queue\\s+\\w+)?\\s+)/;\n\nfunction stripEventPrefix(src: string): { prefix: string; commands: string } | null {\n  const match = src.match(EVENT_PREFIX_RE);\n  if (!match) return null;\n  const prefix = match[1];\n  const commands = src.slice(prefix.length);\n  if (!commands) return null;\n  return { prefix, commands };\n}\n\n/**\n * Build a `preprocessToEnglish` function from the per-path hooks.\n *\n * Handles _hyperscript feature prefixes (e.g. \"on click\", \"on every keyup\")\n * by stripping them, translating only the command portion, then reassembling.\n */\nexport function createPreprocessToEnglish(\n  hooks: PreprocessorHooks\n): (src: string, lang: string, config?: Partial<PreprocessorConfig>) => string {\n  /**\n   * Try semantic translation: parse the WHOLE string in the source\n   * language, render it to English. Returns null if confidence is below\n   * threshold. The semantic parser handles `then`-sequences, newlines,\n   * loop/tell bodies and behavior blocks natively (top-level\n   * command-sequence support landed with the multiset-recall arc), so\n   * there is deliberately no pre-splitting here — see the module doc's\n   * HISTORY note for the measured deletion of the old split fallback.\n   */\n  function trySemanticTranslation(src: string, lang: string, threshold: number): string | null {\n    try {\n      // Check if the semantic parser can handle this\n      if (!hooks.isLanguageRegistered(lang)) return null;\n\n      return hooks.translateSingle(src, lang, threshold);\n    } catch {\n      return null;\n    }\n  }\n\n  /**\n   * Try i18n grammar transformation to English.\n   * Returns null if the result is identical to input (no translation happened).\n   */\n  function tryI18nTranslation(\n    src: string,\n    lang: string,\n    toEnglish: (input: string, locale: string) => string\n  ): string | null {\n    try {\n      const result = toEnglish(src, lang);\n      return result !== src ? result : null;\n    } catch {\n      return null;\n    }\n  }\n\n  /**\n   * Try all configured translation strategies on the input.\n   * Returns null if none succeed.\n   */\n  function tryTranslateWithStrategies(\n    src: string,\n    lang: string,\n    cfg: PreprocessorConfig\n  ): string | null {\n    // Strategy: semantic-only\n    if (cfg.strategy === 'semantic' || cfg.strategy === 'auto') {\n      const threshold = resolveThreshold(cfg.confidenceThreshold, lang);\n      const result = trySemanticTranslation(src, lang, threshold);\n      if (result !== null) return result;\n    }\n\n    // Strategy: i18n fallback (auto mode or i18n-only)\n    if ((cfg.strategy === 'auto' || cfg.strategy === 'i18n') && cfg.i18nToEnglish) {\n      const result = tryI18nTranslation(src, lang, cfg.i18nToEnglish);\n      if (result !== null) return result;\n    }\n\n    return null;\n  }\n\n  return function preprocessToEnglish(\n    src: string,\n    lang: string,\n    config: Partial<PreprocessorConfig> = {}\n  ): string {\n    // English→English is identity; skip semantic parsing which may mangle\n    // the input. (Historically full-path only — the slim path gained it in\n    // the shared-skeleton extraction, deliberately: it is a mangle guard.)\n    if (lang === 'en') return src;\n\n    const cfg = { ...DEFAULT_CONFIG, ...config };\n\n    // Try translating the full string first\n    const fullResult = tryTranslateWithStrategies(src, lang, cfg);\n    if (fullResult !== null) return fullResult;\n\n    // If full translation failed, try stripping event/feature prefix.\n    // _hyperscript attributes often contain \"on <event> <commands>\" — the semantic\n    // parser only understands command syntax, not event declarations.\n    const stripped = stripEventPrefix(src);\n    if (stripped) {\n      const translated = tryTranslateWithStrategies(stripped.commands, lang, cfg);\n      if (translated !== null) return stripped.prefix + translated;\n    }\n\n    // Fallback: return original (unconditional — see fallbackToOriginal's\n    // deprecation note; the string contract leaves nothing else to return)\n    return src;\n  };\n}\n","/**\n * Attribute translator\n *\n * _hyperscript.org's Runtime#getScript is a private class field (`#getScript`),\n * not a property reachable through `internals.runtime` — every plugin variant\n * in this package used to monkey-patch `internals.runtime.getScript`, which\n * silently no-ops against current _hyperscript.org builds (the assignment\n * creates a stray own-property that the runtime's internal `#getScript()`\n * calls never read, so translation never happens and errors are swallowed by\n * `runtime.getScript.bind` throwing before any hyperscript even parses).\n *\n * `addBeforeProcessHook` is the supported, public extension point instead: it\n * fires on the subtree root passed to `processNode()` before the runtime reads\n * whichever configured attribute (`_`, `script`, `data-script` by default) or\n * `<script type=\"text/hyperscript\">` body holds the source. Rewriting that\n * attribute/body in place — before the runtime's own scan reaches it — gets\n * the same \"translate before parse\" effect through a mechanism the runtime\n * actually calls.\n */\n\nexport interface HyperscriptHost {\n  addBeforeProcessHook?: (fn: (elt: Element) => void) => void;\n  config?: { attributes?: string };\n}\n\n/** Elements already processed, so a later `processNode()` call over the same\n *  subtree (e.g. a sibling swap re-scanning a shared ancestor) doesn't\n *  re-translate already-English text as if it were still the original language.\n *  A WeakSet instead of a marker attribute: the same idempotency with zero DOM\n *  mutation (devtools/serialization show exactly what the author wrote).\n *  Serialize→reparse (e.g. an innerHTML round-trip) produces NEW elements that\n *  are re-processed — safe, because re-translating already-English text is\n *  confidence-gated into a no-op. */\nconst processed = new WeakSet<Element>();\n\nfunction scriptAttributeNames(hs: HyperscriptHost): string[] {\n  const raw = hs.config?.attributes ?? '_, script, data-script';\n  return raw\n    .split(',')\n    .map(s => s.trim())\n    .filter(Boolean);\n}\n\nfunction findScriptAttribute(elt: Element, attrNames: string[]): string | null {\n  for (const name of attrNames) {\n    if (elt.hasAttribute(name)) return name;\n  }\n  return null;\n}\n\n/**\n * Install a translator that rewrites non-English script attributes to English\n * in place, before `_hyperscript.org` parses them.\n *\n * @param translate Given the raw source and its element, return the English\n *   translation, or `null`/the same string to leave the element untouched\n *   (English input, unresolved language, translation failure, etc).\n */\nexport function installAttributeTranslator(\n  hs: HyperscriptHost,\n  translate: (src: string, elt: Element) => string | null\n): void {\n  if (typeof hs.addBeforeProcessHook !== 'function') {\n    console.warn(\n      '[hyperscript-i18n] _hyperscript.addBeforeProcessHook is unavailable — ' +\n        'this build of _hyperscript.org is not supported. Load a current version ' +\n        'from https://unpkg.com/hyperscript.org.'\n    );\n    return;\n  }\n\n  const attrNames = scriptAttributeNames(hs);\n  const selector = [...attrNames.map(a => `[${a}]`), 'script[type=\"text/hyperscript\"]'].join(', ');\n\n  const translateOne = (elt: Element): void => {\n    if (processed.has(elt)) return;\n\n    if (elt instanceof HTMLScriptElement && elt.type === 'text/hyperscript') {\n      const src = elt.textContent ?? '';\n      if (!src) return;\n      const english = translate(src, elt);\n      processed.add(elt);\n      if (english != null && english !== src) elt.textContent = english;\n      return;\n    }\n\n    const attr = findScriptAttribute(elt, attrNames);\n    if (!attr) return;\n    const src = elt.getAttribute(attr);\n    if (!src) return;\n    const english = translate(src, elt);\n    processed.add(elt);\n    if (english != null && english !== src) elt.setAttribute(attr, english);\n  };\n\n  hs.addBeforeProcessHook((root: Element) => {\n    if (!root || typeof root.querySelectorAll !== 'function') return;\n    if (typeof root.matches === 'function' && root.matches(selector)) translateOne(root);\n    root.querySelectorAll(selector).forEach(translateOne);\n  });\n}\n","/**\n * Host-parser validity gate (review item F8).\n *\n * After the preprocessor rewrites an attribute to English, the plugin asks\n * the HOST _hyperscript runtime — the same parser that will consume the\n * rewrite moments later — whether the result actually parses. On rejection\n * the plugin falls back to the author's original text, so any parse error\n * the author then sees names code they wrote, not invisible generated\n * English. This is the runtime analog of the offline R4 canonical-validity\n * gate, and the F5 arc measured its failure class shipping in practice:\n * until the whole-string-first reorder (#899), 256 corpus rows rendered\n * English the engine rejects, with no warning anywhere.\n *\n * The engine has two failure channels — `parse().errors` collects grammar\n * errors, and the tokenizer THROWS on an unknown character — folded here\n * the same way test/whole-string-first.test.ts folds them.\n *\n * Zero-dependency module: shared by the full, slim, and lite plugin\n * variants, which must not share heavier import chains (the slim/lite\n * bundles exclude the full semantic package by construction).\n */\n\nexport interface HyperscriptParseHost {\n  parse?: (src: string) => { errors?: unknown[] } | null | undefined;\n}\n\n/**\n * True when the host's parser accepts `src`. Also true when the host\n * exposes no `parse()` — with nothing to validate against, the gate\n * degrades to a no-op rather than suppressing translation on unusual\n * builds (same graceful posture as the `addBeforeProcessHook` check).\n */\nexport function acceptedByHost(hs: HyperscriptParseHost, src: string): boolean {\n  if (typeof hs.parse !== 'function') return true;\n  try {\n    const result = hs.parse(src);\n    return !result?.errors || result.errors.length === 0;\n  } catch {\n    return false;\n  }\n}\n\n/** Languages already warned about a rejected translation this page load —\n *  same warn-once-per-lang convention as the unchanged-translation warning\n *  (and htmx-adapter's warnMissingLangOnce). */\nconst warnedRejectedLang = new Set<string>();\n\n/** Reset the warn-once state. Mainly for tests. */\nexport function resetHostValidationWarnings(): void {\n  warnedRejectedLang.clear();\n}\n\nexport function warnRejectedOnce(lang: string, src: string, english: string): void {\n  if (warnedRejectedLang.has(lang)) return;\n  warnedRejectedLang.add(lang);\n  console.warn(\n    `[hyperscript-i18n] Translation for lang=\"${lang}\" rendered hyperscript the host parser ` +\n      `rejects — falling back to the original text. ` +\n      `Source: \"${src.length > 60 ? src.slice(0, 60) + '…' : src}\" → ` +\n      `\"${english.length > 60 ? english.slice(0, 60) + '…' : english}\". ` +\n      'Further elements in this language stay quiet — enable { debug: true } for per-element detail.'\n  );\n}\n","/**\n * _hyperscript Plugin\n *\n * Registers with _hyperscript.use() to rewrite non-English hyperscript\n * attributes into English before _hyperscript.org parses them.\n */\n\nimport { resolveLanguage } from './language-resolver';\nimport { preprocessToEnglish, type PreprocessorConfig } from './preprocessor';\nimport { installAttributeTranslator, type HyperscriptHost } from './attribute-translator';\nimport {\n  acceptedByHost,\n  warnRejectedOnce,\n  resetHostValidationWarnings,\n  type HyperscriptParseHost,\n} from './host-validate';\n\nexport interface PluginOptions extends Partial<PreprocessorConfig> {\n  /** Default language for all elements (overridable per-element). */\n  defaultLanguage?: string;\n  /** Custom attribute name for per-element language. Default: \"data-lang\" */\n  languageAttribute?: string;\n  /** Enable debug logging to console. Default: false */\n  debug?: boolean;\n  /**\n   * Validate rendered English on the HOST parser before committing the\n   * rewrite; on rejection, fall back to the original text (so parse errors\n   * name the author's code, not generated English). Default: true.\n   * No-op on host builds that expose no `parse()`.\n   */\n  validateWithHost?: boolean;\n}\n\n/** Languages already warned about an unchanged translation this page load.\n *  Unchanged output is common and often legitimate (canonical-English\n *  hyperscript under a non-en lang scope), so warning per element per\n *  processNode was pure noise — mirror htmx-adapter's warn-once-per-lang\n *  convention and leave per-element detail to `debug: true`. */\nconst warnedUnchangedLang = new Set<string>();\n\n/** Reset the warn-once state (unchanged + host-rejected). Mainly for tests. */\nexport function resetTranslationWarnings(): void {\n  warnedUnchangedLang.clear();\n  resetHostValidationWarnings();\n}\n\nfunction warnUnchangedOnce(lang: string, src: string): void {\n  if (warnedUnchangedLang.has(lang)) return;\n  warnedUnchangedLang.add(lang);\n  console.warn(\n    `[hyperscript-i18n] Translation unchanged for lang=\"${lang}\": \"${src.length > 60 ? src.slice(0, 60) + '…' : src}\". ` +\n      'This is fine if the source is already canonical English; otherwise the input may not match ' +\n      'any known pattern, or the language may not be registered. Original text is passed to ' +\n      '_hyperscript as-is. Further elements in this language stay quiet — enable { debug: true } ' +\n      'for per-element detail.'\n  );\n}\n\n/**\n * Create a _hyperscript plugin that enables multilingual hyperscript.\n *\n * @example\n * // Basic usage\n * _hyperscript.use(hyperscriptI18n());\n *\n * @example\n * // With options\n * _hyperscript.use(hyperscriptI18n({\n *   defaultLanguage: 'ja',\n *   confidenceThreshold: 0.6,\n *   debug: true,\n * }));\n */\nexport function hyperscriptI18n(options: PluginOptions = {}) {\n  return function plugin(hs: unknown): void {\n    const host = hs as HyperscriptHost & HyperscriptParseHost;\n    installAttributeTranslator(host, (src, elt) => {\n      // Resolve language\n      const lang = resolveLanguageWithOptions(elt, options);\n\n      // If English or no language detected, pass through\n      if (!lang || lang === 'en') return src;\n\n      // Preprocess to English\n      const english = preprocessToEnglish(src, lang, options);\n\n      if (english !== src) {\n        // Validity gate: the host parser is the consumer of this rewrite —\n        // if it rejects the English, committing it would only trade a\n        // translation gap for a parse error naming code the author never\n        // wrote. Fall back to the original text instead.\n        if (options.validateWithHost !== false && !acceptedByHost(host, english)) {\n          if (options.debug) {\n            console.log(\n              `[hyperscript-i18n] ${lang}: host rejected \"${english}\" — keeping \"${src}\"`\n            );\n          } else {\n            warnRejectedOnce(lang, src, english);\n          }\n          return src;\n        }\n        if (options.debug) {\n          console.log(`[hyperscript-i18n] ${lang}: \"${src}\" → \"${english}\"`);\n        }\n      } else if (options.debug) {\n        console.log(`[hyperscript-i18n] ${lang}: unchanged \"${src}\"`);\n      } else {\n        warnUnchangedOnce(lang, src);\n      }\n\n      return english;\n    });\n  };\n}\n\n/**\n * Resolve language with plugin options factored in.\n */\nfunction resolveLanguageWithOptions(elt: Element, options: PluginOptions): string | null {\n  // Check custom attribute name\n  if (options.languageAttribute) {\n    const custom = elt.getAttribute(options.languageAttribute);\n    if (custom) return custom.split('-')[0].toLowerCase();\n  }\n\n  // Standard resolution\n  const resolved = resolveLanguage(elt);\n  if (resolved) return resolved;\n\n  // Fall back to default language\n  return options.defaultLanguage ?? null;\n}\n\n/**\n * Standalone preprocessing function for programmatic use.\n * Call this when using _hyperscript.evaluate() or _hyperscript(\"code\") directly.\n *\n * @example\n * const english = preprocess(\"トグル .active\", \"ja\");\n * _hyperscript(english);\n */\nexport function preprocess(\n  src: string,\n  lang: string,\n  config: Partial<PreprocessorConfig> = {}\n): string {\n  if (lang === 'en') return src;\n  return preprocessToEnglish(src, lang, config);\n}\n"],"mappings":"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","names":["preprocessToEnglish","translate","src","english"]}

package/dist/index.d.cts

@@ -1,8 +1,39 @@
 /**
- * Preprocessor
+ * Preprocessor core — the shared skeleton of the full and slim
+ * preprocessors.
  *
- * Translates non-English hyperscript to English using the semantic parser
- * (with optional i18n fallback), so the original _hyperscript can parse it.
+ * Everything that is NOT genuinely different between the two paths lives
+ * here exactly once: config defaults/threshold resolution, strategy
+ * ordering (semantic → optional i18n), event-prefix stripping, and the
+ * return-original fallback. The two real differences stay with each path,
+ * injected as hooks:
+ *
+ *   - HOW one statement is parsed and rendered to English
+ *     (`translateSingle`): the full path uses semantic's parseSemantic +
+ *     render + a translate() rescue for confident-but-nodeless parses;
+ *     the slim path uses parseWithConfidence + the custom
+ *     hyperscript-renderer (no English language data).
+ *   - WHERE the registry lookup comes from (`isLanguageRegistered`):
+ *     `@lokascript/semantic` vs `…/core` — under tsup's split dist these
+ *     are separate registry instances, so each path must bring its own.
+ *
+ * Behavior is pinned by the parity ratchet
+ * (test/preprocessor-parity.*.test.ts + the committed fixture): both paths
+ * are byte-identical to their pre-extraction outputs over the corpus.
+ *
+ * HISTORY: the skeleton used to carry a compound-splitting fallback
+ * (`splitStatements` on localized `then` keywords + newlines,
+ * `translateCompound` rejoining pieces with a hardcoded ` then `), run when
+ * the whole-string parse declined. Deleted 2026-08-07 after measurement:
+ * over all 3703 patterns.db corpus translations plus the parity corpus, on
+ * BOTH paths, the split arm produced ZERO final outputs (full: 115
+ * invocations, all returned null; slim: 32, all null) — post-whole-string-
+ * first (#899), an input whose pieces each parse would have parsed whole,
+ * so the arm's success condition is self-defeating. It was also defective
+ * twice over: the regex split was string-literal-blind (`say 'now then
+ * later'` split inside the literal) and the ` then ` rejoin is invalid
+ * immediately after block headers. Deleting it erased both defect classes
+ * wholesale; the parity fixture regenerated byte-identical.
  */
 interface PreprocessorConfig {
     /**
@@ -22,21 +53,36 @@ interface PreprocessorConfig {
     confidenceThreshold: number | Record<string, number>;
     /** Strategy: 'semantic' (default), 'i18n', or 'auto' (semantic then i18n) */
     strategy: 'semantic' | 'i18n' | 'auto';
-    /** Whether to return original text on failure. Default: true */
-    fallbackToOriginal: boolean;
+    /**
+     * @deprecated Never implemented — `preprocessToEnglish` always returns a
+     * string, and on translation failure that string is the original source
+     * (there is nothing else it could return). The option has had no effect in
+     * any released version and is ignored; it will be removed in a future major.
+     */
+    fallbackToOriginal?: boolean;
     /** Optional i18n toEnglish function (loaded dynamically if available) */
     i18nToEnglish?: (input: string, locale: string) => string;
 }
+
+/**
+ * Preprocessor (full path)
+ *
+ * Translates non-English hyperscript to English using the semantic parser
+ * (with optional i18n fallback), so the original _hyperscript can parse it.
+ *
+ * The strategy/split/strip skeleton lives in preprocessor-core.ts, shared
+ * with the slim path — only HOW one statement is parsed and rendered
+ * differs here: semantic's parseSemantic + render('en'), plus a
+ * translate() rescue when the parse is confident but yields no node.
+ */
+
 /**
  * Preprocess non-English hyperscript into English.
  *
  * Uses the semantic parser to parse the input in the source language,
  * then renders back to English. Falls through to i18n if configured.
- *
- * Handles _hyperscript feature prefixes (e.g. "on click", "on every keyup")
- * by stripping them, translating only the command portion, then reassembling.
  */
-declare function preprocessToEnglish(src: string, lang: string, config?: Partial<PreprocessorConfig>): string;
+declare const preprocessToEnglish: (src: string, lang: string, config?: Partial<PreprocessorConfig>) => string;
 
 /**
  * _hyperscript Plugin
@@ -52,7 +98,16 @@ interface PluginOptions extends Partial<PreprocessorConfig> {
     languageAttribute?: string;
     /** Enable debug logging to console. Default: false */
     debug?: boolean;
+    /**
+     * Validate rendered English on the HOST parser before committing the
+     * rewrite; on rejection, fall back to the original text (so parse errors
+     * name the author's code, not generated English). Default: true.
+     * No-op on host builds that expose no `parse()`.
+     */
+    validateWithHost?: boolean;
 }
+/** Reset the warn-once state (unchanged + host-rejected). Mainly for tests. */
+declare function resetTranslationWarnings(): void;
 /**
  * Create a _hyperscript plugin that enables multilingual hyperscript.
  *
@@ -91,9 +146,17 @@ declare function preprocess(src: string, lang: string, config?: Partial<Preproce
  * Resolution order:
  * 1. `data-lang` attribute on the element itself
  * 2. `data-hyperscript-lang` attribute on the element or closest ancestor
- * 3. `lang` attribute on `<html>` element
- * 4. null (assume English, no preprocessing needed)
+ * 3. `lang` attribute on the element or closest ancestor (the HTML-standard
+ *    cascade — a `<section lang="es">` localizes everything inside it, and a
+ *    nested `lang="en"` opts back out). This is how the paired htmx-adapter
+ *    (`langOf()`) and loka-js resolve language, so `hx-*` and `_` attributes
+ *    on the same element agree.
+ * 4. `lang` on `<html>` via `document.documentElement` — only reachable when
+ *    the element is DETACHED (step 3's ancestor walk covers `<html>` for
+ *    attached elements): a hook processing a not-yet-inserted fragment still
+ *    picks up the page default.
+ * 5. null (assume English, no preprocessing needed)
  */
 declare function resolveLanguage(elt: Element): string | null;
 
-export { type PluginOptions, type PreprocessorConfig, hyperscriptI18n, preprocess, preprocessToEnglish, resolveLanguage };
+export { type PluginOptions, type PreprocessorConfig, hyperscriptI18n, preprocess, preprocessToEnglish, resetTranslationWarnings, resolveLanguage };