@hyperscript-tools/i18n 2.11.1 → 3.0.0

package/CHANGELOG.md

@@ -7,6 +7,126 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [3.0.0] - 2026-09-03
+
+Full notes: [GitHub Releases](https://github.com/codetalcott/hyperfixi/releases/tag/v3.0.0).
+
+One major, two themes. `@lokascript/i18n`'s grammar transformer is gone,
+because `@lokascript/semantic` overtook it on every row of the translation
+corpus (#973–#1001). And the engine-migration plan
+(`docs-internal/ENGINE_MIGRATION_PLAN.md`) is complete: its last arc deleted
+the exported dead code it had been carrying and collapsed the browser bundle
+lineup to two names (#1099–#1105).
+
+### ⚠ BREAKING
+
+- **`@lokascript/i18n` no longer translates** (#1001). `translate()`, `toLocale()`,
+  `toEnglish()`, `GrammarTransformer` and `createTransformer` are deleted; the
+  package is per-language vocabulary and grammar profiles. Migrate to
+  `import { translate } from '@lokascript/semantic'` (same signature; it throws
+  on unparseable input where the transformer returned nonsense). The classic-i18n
+  browser bundle, `@hyperscript-tools/i18n` and `@lokascript/types-browser` drop
+  the same members (#998, #999); the patterns corpus writer is semantic-only (#1000).
+- **The prebuilt browser bundles are two names** (#1105): `hyperfixi-hx.js`
+  (small: hybrid parser, blocks, expressions, htmx v1/v2 attributes) and
+  `hyperfixi.js` (everything); `hyperfixi-hx-v4.js` and
+  `hyperfixi-multilingual.js` stay as separate products. `hyperfixi-lite.js`,
+  `-lite-plus.js`, `-minimal.js`, `-standard.js` and their `./browser/*`
+  exports are gone — use `hyperfixi-hx.js`, `hyperfixi.js`, or the Vite
+  plugin, which picks the tier itself. `./browser/hybrid-complete` remains as
+  the plugin's internal fallback.
+- **Exported dead code deleted from `@hyperfixi/core`** — none had a
+  production caller: the six `@deprecated` `features/` families and the
+  modular bundle's `features` namespace (#1099); `Lexer`/`Tokens` (#1100 —
+  use `tokenize`); the `unified-types` `Validator`, the `types.d.ts` shim and
+  `registry/multilingual` (#1101); the `async` command (#1102 — it was
+  unreachable from parsed hyperscript; the manifest is 58 commands);
+  `ContextProviderRegistry`, the context-provider `Proxy`, the registry's
+  `context` slot and the plugin `contextProviders` field (#1104 — set
+  request-scoped values as `context.locals`).
+
+### Fixed
+
+- **A small bundle fails loudly on a command it lacks and names `hyperfixi.js`**
+  (#1103). The hybrid parser had been dropping an unrecognised word silently;
+  making it loud also exposed and fixed three silent mis-parses in the hybrid
+  bundles: unquoted `fetch /api/data` fetched `/`, `send custom:event` sent
+  `custom` to `me`, and `repeat forever` ran zero iterations.
+- **English→foreign rendering is gated** (#931–#972, #953): 3105/3105 corpus
+  renders parse on the canonical engine; the bare (handler-less) surface has its
+  own gate. `as JSON` stays part of the value (#991); a flattened loop header
+  closes (#992).
+- Plugins report their real versions (#926); `analyze_content` is unshadowed in
+  the MCP server (#927); four dependency advisories resolved; the `domain-flow`
+  → `server-bridge` route contract is pinned (#1000s).
+
+### Changed
+
+- `hyperfixi.js` and `hyperfixi-hx-v4.js` carry the 24-language render
+  vocabulary (~19 KB gzip each) so `translate` works in the browser (#931).
+- Deprecated `@lokascript/domain-*` references repoint to `@lokascript/domains`.
+
+## [2.11.1] - 2026-08-25
+
+Patch release. Fixes the release workflow itself: the build now runs **after**
+the version sync, so a published tarball carries its own version rather than
+the previous one, and `version.ts` is committed (#925). Also lands the
+agent-loop A/B benchmark with an isolated generator (#924).
+
+## [2.11.0] - 2026-08-24
+
+Full notes: [GitHub Releases](https://github.com/codetalcott/hyperfixi/releases/tag/v2.11.0).
+
+### Changed
+
+- **The domain-DSL family moved out** (#909). Twelve packages left this
+  monorepo: the ten publishable `@lokascript/domain-*` packages (bdd,
+  behaviorspec, config, flow, jsx, learn, llm, sql, todo, voice) plus the
+  private `domain-toolkit` and `mcp-multilingual-intent`. They now ship as
+  **`@lokascript/domains`**, one subpath export per domain, from the
+  [lokascript-domains](https://github.com/codetalcott/lokascript-domains)
+  repository.
+
+  All ten published names are **deprecated on npm**, each naming its
+  replacement subpath (`@lokascript/domain-sql` → "import from
+  `@lokascript/domains/sql`"). Existing installs keep working — deprecation is
+  a warning, not a removal — they simply stop receiving updates. The
+  pre-deletion tree is preserved at the `moved/domain-family` tag.
+
+  _Migration:_ replace nine dependencies with one, and change
+  `from '@lokascript/domain-x'` to `from '@lokascript/domains/x'`. The root
+  entry absorbed `domain-config` and exports `createDomainRegistry`,
+  `registerAllDomains` and `DOMAIN_PRIORITY`.
+
+### Added
+
+- **"Show in My Language"** — LSP request plus VSCode command (#921).
+- **Verified-translation badge** in the compilation service (#920).
+- **`scoreFidelity` / `@lokascript/semantic/fidelity`** (#919).
+- **Inert-shape warnings** (#918) and surfaced unconsumed-input warnings (#916)
+  in the compilation service.
+- **The agent-loop benchmark** and the silent-failure finding it produced
+  (#915), and the MCP server's agent-era roadmap (#914).
+- **Element-collection write-back** for hypermedia tables, with gallery
+  examples and four system fixes (#904).
+- **The comprehensive Playwright tier now runs in CI** (#908) alongside
+  `quick`. It had never run: 122 specs, hiding four real bugs — a detached
+  `startViewTransition`, untracked reads of unset globals, concurrent effects
+  clobbering dependency capture, and `put` stringifying DocumentFragments
+  (#905).
+
+### Fixed
+
+- **The `hyperscript-adapter` review arc** (#895–#902): whole-string
+  translation first, taking canonical validity from 2849/3105 to **3105/3105**
+  (#899); a host-parser validity gate so an invalid render falls back to the
+  author's text (#900); the dead split-statement fallback deleted after
+  measuring 0 outputs (#901); and the slim divergence set burned 6 → 1 via
+  schema marker data, repairing 39 body-dropping corpus rows (#902).
+- **`qu take.recipient`** — the R1 tail's last `take` row (#910).
+- **The release workflows** no longer reference the moved-out domain family
+  (#922).
+
 ## [2.10.0] - 2026-08-01
 
 Full notes: [GitHub Releases](https://github.com/codetalcott/hyperfixi/releases/tag/v2.10.0).

package/dist/{chunk-SYQOFAWY.js → chunk-U4NYQZF6.js}

@@ -3,8 +3,20 @@ import {
   warnInvalidOnce
 } from "./chunk-7ZOFDQYR.js";
 
+// src/translate.ts
+import { translate as semanticTranslate } from "@lokascript/semantic";
+function translate(input, sourceLocale, targetLocale) {
+  if (sourceLocale === targetLocale) return input;
+  return semanticTranslate(input, sourceLocale, targetLocale);
+}
+function toLocale(input, targetLocale) {
+  return translate(input, "en", targetLocale);
+}
+function toEnglish(input, sourceLocale) {
+  return translate(input, sourceLocale, "en");
+}
+
 // src/html.ts
-import { translate } from "@lokascript/i18n";
 var ATTR_PATTERNS = [
   /(_\s*=\s*")([^"]+)(")/g,
   /(_\s*=\s*')([^']+)(')/g,
@@ -82,6 +94,9 @@ function translateHtmlToManyLangs(html, langs, options = {}) {
 }
 
 export {
+  translate,
+  toLocale,
+  toEnglish,
   extractHyperscriptAttributes,
   checkHtmlInput,
   translateHtml,

package/dist/cli.js

@@ -2,7 +2,7 @@
 import {
   checkHtmlInput,
   translateHtml
-} from "./chunk-SYQOFAWY.js";
+} from "./chunk-U4NYQZF6.js";
 import {
   formatParseCheckReport,
   loadValidator

package/dist/eleventy.d.ts

@@ -1,6 +1,5 @@
-import { LangCode } from './index.js';
-export { TranslateHtmlOptions, translateHtml, translateHtmlToManyLangs } from './index.js';
-import '@lokascript/i18n';
+import { L as LangCode } from './html-7nAYhd7r.js';
+export { T as TranslateHtmlOptions, t as translateHtml, a as translateHtmlToManyLangs } from './html-7nAYhd7r.js';
 import './validate.js';
 
 /**

package/dist/eleventy.js

@@ -1,7 +1,8 @@
 import {
+  translate,
   translateHtml,
   translateHtmlToManyLangs
-} from "./chunk-SYQOFAWY.js";
+} from "./chunk-U4NYQZF6.js";
 import {
   formatParseCheckReport,
   loadValidator,
@@ -9,7 +10,6 @@ import {
 } from "./chunk-7ZOFDQYR.js";
 
 // src/eleventy.ts
-import { translate } from "@lokascript/i18n";
 async function hyperscriptI18nPlugin(eleventyConfig, options = {}) {
   const defaultFrom = options.defaultFrom ?? "en";
   const lenient = options.lenient ?? true;

package/dist/html-7nAYhd7r.d.ts

@@ -0,0 +1,55 @@
+import { CanonicalValidate, ParseCheckReport } from './validate.js';
+
+/**
+ * HTML attribute scanner + translator.
+ *
+ * Walks an HTML string, finds `_="..."` (and single-quoted / backtick variants)
+ * attributes, translates each from a source locale to a target locale, and
+ * returns the rewritten HTML. The grammar transformer doesn't know about HTML;
+ * this module is the glue.
+ *
+ * Optionally parse-checks the ENGLISH side against the real `hyperscript.org`
+ * engine (see ./validate): the input when `from === 'en'` and the output when
+ * `to === 'en'`. The check only runs when a `validate` function is supplied, so
+ * existing callers see no behaviour change.
+ */
+
+type LangCode = string;
+/** What to do with an invalid-English report. */
+type OnInvalid = 'warn' | 'error' | ((report: ParseCheckReport) => void);
+interface TranslateHtmlOptions {
+    /** Source locale of the input HTML's `_=` attributes. Defaults to 'en'. */
+    from?: LangCode;
+    /**
+     * If true, swallow per-attribute translation errors and leave the original
+     * text in place. Defaults to true so a single bad sample doesn't fail the
+     * whole page build.
+     */
+    lenient?: boolean;
+    /**
+     * Canonical validator (from `loadValidator()`). When absent, no parse-check
+     * runs and behaviour is unchanged.
+     */
+    validate?: CanonicalValidate;
+    /** What to do with an invalid-English report. Default 'warn' (deduped console.warn). */
+    onInvalid?: OnInvalid;
+    /**
+     * Set false when the caller already validated the English input (as
+     * `translateHtmlToManyLangs` and the CLI do). Default true.
+     */
+    checkInput?: boolean;
+}
+/**
+ * Every `_=` attribute body in `html` (double/single/backtick quoted), deduped,
+ * in document order.
+ */
+declare function extractHyperscriptAttributes(html: string): string[];
+/**
+ * Validate every English `_=` attribute body of `html`; returns a report for
+ * each invalid one (stage 'input').
+ */
+declare function checkHtmlInput(html: string, validate: CanonicalValidate, to?: LangCode): ParseCheckReport[];
+declare function translateHtml(html: string, to: LangCode, options?: TranslateHtmlOptions): string;
+declare function translateHtmlToManyLangs(html: string, langs: ReadonlyArray<LangCode>, options?: TranslateHtmlOptions): Map<LangCode, string>;
+
+export { type LangCode as L, type OnInvalid as O, type TranslateHtmlOptions as T, translateHtmlToManyLangs as a, checkHtmlInput as c, extractHyperscriptAttributes as e, translateHtml as t };

package/dist/index.d.ts

@@ -1,57 +1,21 @@
-export { GrammarTransformer, toEnglish, toLocale, translate } from '@lokascript/i18n';
-import { CanonicalValidate, ParseCheckReport } from './validate.js';
-export { formatParseCheckReport, loadValidator, validateHyperscript } from './validate.js';
+export { L as LangCode, O as OnInvalid, T as TranslateHtmlOptions, c as checkHtmlInput, e as extractHyperscriptAttributes, t as translateHtml, a as translateHtmlToManyLangs } from './html-7nAYhd7r.js';
+export { CanonicalValidate, ParseCheckReport, formatParseCheckReport, loadValidator, validateHyperscript } from './validate.js';
 
 /**
- * HTML attribute scanner + translator.
+ * Translate hyperscript between any two languages.
  *
- * Walks an HTML string, finds `_="..."` (and single-quoted / backtick variants)
- * attributes, translates each from a source locale to a target locale, and
- * returns the rewritten HTML. The grammar transformer doesn't know about HTML;
- * this module is the glue.
+ * Identity when source and target match — kept from the i18n signature, and not
+ * merely an optimization: a parse/render round trip normalizes incidental syntax
+ * (`'Got it!'` comes back as `"Got it!"`), which a same-language call should not
+ * do to a caller's source.
  *
- * Optionally parse-checks the ENGLISH side against the real `hyperscript.org`
- * engine (see ./validate): the input when `from === 'en'` and the output when
- * `to === 'en'`. The check only runs when a `validate` function is supplied, so
- * existing callers see no behaviour change.
+ * @throws when the input cannot be parsed in `sourceLocale`, or `targetLocale`
+ * has no registered renderer.
  */
+declare function translate(input: string, sourceLocale: string, targetLocale: string): string;
+/** English → `targetLocale`. */
+declare function toLocale(input: string, targetLocale: string): string;
+/** `sourceLocale` → English. */
+declare function toEnglish(input: string, sourceLocale: string): string;
 
-type LangCode = string;
-/** What to do with an invalid-English report. */
-type OnInvalid = 'warn' | 'error' | ((report: ParseCheckReport) => void);
-interface TranslateHtmlOptions {
-    /** Source locale of the input HTML's `_=` attributes. Defaults to 'en'. */
-    from?: LangCode;
-    /**
-     * If true, swallow per-attribute translation errors and leave the original
-     * text in place. Defaults to true so a single bad sample doesn't fail the
-     * whole page build.
-     */
-    lenient?: boolean;
-    /**
-     * Canonical validator (from `loadValidator()`). When absent, no parse-check
-     * runs and behaviour is unchanged.
-     */
-    validate?: CanonicalValidate;
-    /** What to do with an invalid-English report. Default 'warn' (deduped console.warn). */
-    onInvalid?: OnInvalid;
-    /**
-     * Set false when the caller already validated the English input (as
-     * `translateHtmlToManyLangs` and the CLI do). Default true.
-     */
-    checkInput?: boolean;
-}
-/**
- * Every `_=` attribute body in `html` (double/single/backtick quoted), deduped,
- * in document order.
- */
-declare function extractHyperscriptAttributes(html: string): string[];
-/**
- * Validate every English `_=` attribute body of `html`; returns a report for
- * each invalid one (stage 'input').
- */
-declare function checkHtmlInput(html: string, validate: CanonicalValidate, to?: LangCode): ParseCheckReport[];
-declare function translateHtml(html: string, to: LangCode, options?: TranslateHtmlOptions): string;
-declare function translateHtmlToManyLangs(html: string, langs: ReadonlyArray<LangCode>, options?: TranslateHtmlOptions): Map<LangCode, string>;
-
-export { CanonicalValidate, type LangCode, type OnInvalid, ParseCheckReport, type TranslateHtmlOptions, checkHtmlInput, extractHyperscriptAttributes, translateHtml, translateHtmlToManyLangs };
+export { toEnglish, toLocale, translate };

package/dist/index.js

@@ -1,19 +1,18 @@
 import {
   checkHtmlInput,
   extractHyperscriptAttributes,
+  toEnglish,
+  toLocale,
+  translate,
   translateHtml,
   translateHtmlToManyLangs
-} from "./chunk-SYQOFAWY.js";
+} from "./chunk-U4NYQZF6.js";
 import {
   formatParseCheckReport,
   loadValidator,
   validateHyperscript
 } from "./chunk-7ZOFDQYR.js";
-
-// src/index.ts
-import { translate, toLocale, toEnglish, GrammarTransformer } from "@lokascript/i18n";
 export {
-  GrammarTransformer,
   checkHtmlInput,
   extractHyperscriptAttributes,
   formatParseCheckReport,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperscript-tools/i18n",
-  "version": "2.11.1",
+  "version": "3.0.0",
   "description": "Build-time translation for hyperscript code samples — generate per-language HTML from a canonical English source",
   "type": "module",
   "main": "dist/index.js",
@@ -29,7 +29,7 @@
     "build": "tsup src/index.ts src/cli.ts src/eleventy.ts src/validate.ts --format esm --dts --clean",
     "dev": "tsup src/index.ts src/cli.ts src/eleventy.ts src/validate.ts --format esm --dts --watch",
     "typecheck": "tsc --noEmit",
-    "pretest": "../../scripts/ensure-fresh.sh ../i18n . && npm run build --silent",
+    "pretest": "../../scripts/ensure-fresh.sh ../semantic . && npm run build --silent",
     "test": "node --test test/*.test.mjs",
     "test:check": "bash -c 'set -o pipefail; node --test --test-reporter=spec test/*.test.mjs 2>&1 | tail -10'"
   },
@@ -48,7 +48,7 @@
   "author": "HyperFixi Contributors",
   "license": "MIT",
   "dependencies": {
-    "@lokascript/i18n": "^2.11.1",
+    "@lokascript/semantic": "^3.0.0",
     "hyperscript.org": "^0.9.93"
   },
   "devDependencies": {