@hyperfixi/behaviors 4.4.0 → 4.6.0

package/CHANGELOG.md

@@ -7,6 +7,196 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [4.6.0] - 2026-10-15
+
+### Added
+
+- **`@lokascript/semantic`: `ask` and `answer`** in every language's own word (es `preguntar` /
+  `responder`, ja `尋ねる` / `答える`, de `frage` / `antworte`): upstream's two dialog commands
+  (`ask "Name?"` prompts; `answer "Save?" with "Yes" or "No"` confirms, the choices after the language's
+  `with`). Both were refused in every language. Listed for native review in
+  `packages/semantic/NATIVE_REVIEW_NEEDED.md`.
+- **`@lokascript/semantic`: `scroll … by` with a direction** in every language's own words
+  (`scroll #box down by 200px`: es `desplazamiento #box abajo por 200px`, ja `#boxを 下 200px スクロール`,
+  ru `прокрутить #box вниз 200px`). Upstream's relative scroll was refused in every language: no
+  direction had a word, and scroll's schema modeled `scroll to <el>` alone. Listed for native review in
+  `packages/semantic/NATIVE_REVIEW_NEEDED.md`.
+
+### Changed
+
+- **`@lokascript/framework`: a domain DSL's parse refuses input it did not read.**
+  `createMultilingualDSL`'s `parse` (and so `compile`, `validate`, `translate`) tries every pattern and
+  takes the best match that reads the WHOLE input: highest priority, then confidence. When the only
+  matches leave input unread, it throws `UnreadInputError` (exported; `code: 'unread-input'`, with the
+  longest match's `reading` and the `unread` text). It used to return the first match however much it
+  read, so a trailing word was dropped without a word: the domain gate (lokascript-domains) found
+  1,744 of 1,744 renders accepted with an unknown word after them, and `ask what is 2+2` asked the
+  model "what". Against the gate (domains 4.0.0, measured unpublished with `gate:upstream`): 1,527
+  cases better, 62 worse, every one `pass → refused` (a value such as `click`'s that the generator
+  ignored, now refused as unread rather than dropped); no case became silent, and no accepted parse
+  changed its reading. A multi-word llm question is quoted: `ask "what is 2+2"`.
+- **`@lokascript/framework`: a domain DSL's `translate` refuses a rendering that does not read
+  back.** It reads its output in the target language and requires the source command: the same
+  action and role values, or the same compiled code. Otherwise it throws `TranslationReadBackError`
+  (exported; the text under `partial`, what it reads as under `reading`), unless `{ lossy: 'allow' }`,
+  as semantic's `translate`. `DomainRegistry`'s tools (the MCP `parse_` / `compile_` / `validate_` /
+  `translate_<domain>` tools) report refusals as `ok: false` with an `UNREAD_INPUT` or
+  `TRANSLATION_DOES_NOT_READ_BACK` diagnostic instead of a generic tool error, and `translate_<domain>`
+  reads its own rendering back the same way. Translating every domain gate command from English: 46
+  renders that used to be returned are now refused (45 do not parse in the target language).
+- **`@lokascript/semantic`: the parser is split into modules.** `semantic-parser.ts` went from 9,680
+  lines to 751, across 22 modules under `parser/`, and each question about an end word (does it close a
+  block, does it stop a clause) has one reader. Each step was checked against 27,194 parses; the steps
+  that change a reading are listed under Fixed. `SemanticParseError` keeps its import path.
+
+### Fixed
+
+- **`@lokascript/semantic`: a handler's count** (`on click 1 …`, the first click only; `on click 2 …`)
+  is read in every language. The renders already wrote it (es `al clic 1 ocultar`), but every reader
+  outside English dropped it, so the translation was refused in all 23 languages. Bengali, Italian and
+  Thai also read every clause between a handler's event and its body (`on click elsewhere`,
+  `on mutation of attributes`, `on foo queue first`), which their head pattern skipped. In the command-shape
+  gate, 375 lanes that were refused now pass.
+- **`@lokascript/semantic`: a query of a pseudo-class alone** (`<:checked/>`, `<:not(.done)/>`) reads
+  as a query in every language, English too. Every tokenizer read `<` and then a local variable
+  `:checked`, so a translation was refused. In the command-shape gate, 161 lanes that were refused now
+  pass.
+- **`@lokascript/semantic`: value spellings from upstream's own tests** read in every language,
+  English too: an escaped class name (`.group-\[:nth-of-type\(3\)_\&\]:block`), a query of several
+  selectors (`<#d1, #d2/>`), a unit after parentheses (`(startWidth)px`), `[@data-foo]` and an
+  attribute after a pronoun (`set it @disabled to true`, written `its @disabled`), a dotted property
+  before `of` (`set parentNode.innerHTML of #d1 to "foo"`), and `set {bar: 2, baz: 3} on obj`. Each was
+  refused. `get` no longer has a destination slot, which no reader used and which took Italian's `in`:
+  `get #p1 in me` read back as `get #p1 on me` in Italian, and `get result as JSONString` was refused
+  in Quechua. In the command-shape gate, 202 lanes are better, 3 of them silent before.
+- **`@lokascript/semantic`: upstream's collection expressions** read in English and translate:
+  `set :items to <span/> in #box where it matches .a`,
+  `put matches mapped to its textContent into #out`, `repeat for x in :items where x.val > 10 …`. They were refused in every language, English
+  too, or kept as an English clause after the command. A translation writes the language's own `where`,
+  as it already did in a condition (es `donde`, de `wo`), and keeps `mapped to` in English until native
+  review. Also read now: an element-scoped variable (`:items`) inside a longer value, the article in
+  `in the closest <table/>` and `checked of the :boxes`, and zh/tl's `no` before a sigil variable. Quechua and
+  Vietnamese read their own `where` back (it read as `target`, or split at its `_`), which also clears a
+  silent pair in each. In the command-shape gate, 154 lanes are better, 2 of them silent before.
+- **`@lokascript/semantic`: a query's scope inside a phrase** reads in English and translates:
+  `put the length of <:checked/> in #box into me` (the value ended at the query and `in` was taken as
+  put's marker), `bind $n to the length of <:checked/> in the next <tbody/> …` (a positional scope),
+  `put <span/> in #box where it matches .a into me` (English came back silently as `… into #box …`), and
+  `put the length of <p/> into #out` and `put 'x' into the next <div/>'s textContent`, which the lossy
+  check refused because it read the `'s` after `<p/>` as a quote. In the command-shape gate, 63 lanes are
+  better, 1 of them silent before.
+- **`@lokascript/semantic`: no translation reads back as other English without saying so.** The
+  command-shape gate's last five silent pairs read back as their source: pl's `closest .bar to .foo`
+  (pl's own `to` is "it"), `closest @foo` in pl and sw, a Quechua chain of `'s` (`$data's inner's val`,
+  read as a string), and Indonesian's `saya punya @data-x`. English `set closest @foo to "doh"` and
+  `put closest @foo into me`, refused in all 24 languages, read now too.
+- **`@lokascript/semantic`: commands that semantic already models, refused in some languages,** read
+  and translate. In the command-shape gate, 168 lanes that were refused now pass; with the rows above,
+  the refused lanes of shapes semantic models went from 911 to 86, and the gate reads 26,531 pass,
+  709 refused and 0 silent. The commands:
+  - `fetch $u as JSON`, with a `$` or `:` variable as the URL (23 languages);
+  - `toggle my *display`, `*opacity` and `*visibility` (ar, de, fr, he, ja, tr);
+  - a `js(…) … end` block after `then` behind a handler head (bn, es, it, ko, pl, ru, th, tl, uk);
+  - a snake_case name (`call global_function()`), which 11 tokenizers split at its `_`;
+  - a custom event after a handler head's `or` (`on click or foo`: bn, it, ja, ko, th, tr, zh). English
+    no longer drops the second event of `on foo or bar`;
+  - `put … at end of` in Vietnamese, and in bn, hi, ja, qu and tr after a bare name
+    (`put response at end of #results`);
+  - a `set` target with no marker after it, in it, pl, ru and uk (`set .divs.innerHTML to "foo"`,
+    `#d1.parentNode`, `bar["count"]`), and `on keydown[key=="Enter"]` in ar, de, fr and he;
+  - `fetch … as Object` and `as Number` behind a bn, hi or ko handler head;
+  - a top-level `for item in items …`, which bn, hi, ko and sw read as a handler on `item`;
+  - a loop's bottom test (`repeat … until x is 3 end`) in de, fr and ko;
+  - a Korean second handler on a parameterized event (`on exception(error)`), and Polish
+    `then throw` after `do` (Polish for `into`);
+  - bn, th and vi's own word for `checked`.
+- **`@lokascript/semantic`: `at end of` inside a behavior or a def** reads in every language:
+  `behavior B on click put "x" at end of me end` was refused, English to English too, because the
+  `end` of `at end of` closed the block. A variable spelled like an end word in such a body reads too
+  (es `fin`).
+- **`@lokascript/semantic`: two copied type lists that had lost `property-path`.** Chinese reads
+  `put the textContent of last <.picked/> in #list`, which it refused, and ja, ko and zh write the count
+  of `repeat the textContent of #a times` in their own words (`#aのtextContent`), not English.
+- **`@lokascript/semantic`: Quechua's `repeat until event … from …`** writes Quechua
+  (`kama ruway pointerup ta kutipay #box manta …`), not a leftover of the retired i18n transformer with
+  English `until event` and `repeat` in it.
+- **Test runs no longer fill the temp directory**: `scripts/vitest-run.sh` gives each run its own
+  `TMPDIR` and removes it. Vitest 5.0.2 leaves a copy of every transformed module in `$TMPDIR` per run.
+
+### Removed
+
+- **`@hyperfixi/mcp-server`: the jsx domain's four tools** (`parse_jsx`, `compile_jsx`, `validate_jsx`,
+  `translate_jsx`), and `jsx` as a `domain` for `lse_validate_and_feedback`, `generate_training_data`
+  and the `lse_generate` prompt. The server now depends on `@lokascript/domains` ^4.0.0, which retired
+  jsx with six other preview domains (`docs-internal/DOMAINS_RETHINK.md`, D1). 8 domains remain (sql,
+  bdd, behaviorspec, llm, flow, voice, todo, learn): 32 domain tools, 102 tools defined, 97 listed by
+  default.
+
+## [4.5.0] - 2026-10-11
+
+Pronouns, suffixes and handler heads read as their language. In 4.4.0 every translation wrote `me` and
+`it` in the nominative beside a marker (es `a yo`, de `zu ich`, tr `ben e`, ar `إلى أنا`), wrote every
+case particle as a word of its own (ko `#out 에`, ja `"x" を`), and wrote a Japanese, Bengali or Turkish
+handler head with two markers (`クリック を で`, `ক্লিক তে`, `tıklama i üzerinde`). Each of these is now
+the language's own form, and every reader still takes the old one. The forms are listed for native
+review in `packages/semantic/NATIVE_REVIEW_NEEDED.md`; none has been reviewed yet.
+
+### Added
+
+- **`@lokascript/testing-framework`: the English-leak gate counts pronoun case and marker spacing.**
+  `case:it` and an unmarked object pronoun (`case:me-object`, `case:it-object`) beside `case:me`; and
+  `spacing:<marker>`, a particle ko, ja, bn or tr attaches to its noun written as a word of its own.
+  Both shrink-only, both halves (corpus and command shapes), with per-language exit targets in
+  `LEAK_TARGETS`.
+- **`@lokascript/semantic`: `toggle … between`** in every language's own words (ja `の間で`, hi `के बीच`,
+  he `בין`), with the style form's element written in the language.
+- **`docs-internal/multilingual/FUSED_FORMS.md`**: the design for pronouns fused with their markers and
+  suffixes attached to words, with the owner's four questions and their answers.
+
+### Changed
+
+- **`@lokascript/semantic` writes a pronoun in the case its marker takes.** Free forms: es `en mí`,
+  pt `a mim`, it `a me`, tl `sa akin`, pl `do mnie`, ru `ко мне` / `во мне`, uk `до мене`, de `zu mir`
+  / `in mich` (direction) / `auf mir` (location), hi `मुझ में`; `it` after a marker (ru `к этому`, pl
+  `do tego`, de `dazu` / `darin` / `darauf`, fr `à lui`, hi `इस में`); `me` as a verb's object (de
+  `zeige mich`, ru `покажи меня`). Fused forms: tr `bana` / `beni` / `benden`, `ona` / `onu`; ar `إليّ` / `فيه`;
+  he `אליי` / `ממני`; bn `আমাকে` / `আমাতে`; hi `मुझे`; tl `dito`; pt `nele`. Object clitics on the verb:
+  es `mostrarme`, it `metterlo`, pt `colocá-lo`, ar `ضعه`; fr writes the object pronoun before the
+  infinitive (`le mettre`, `l'afficher`, `me cacher`). Every reader takes the nominative and the English
+  forms as before.
+- **`@lokascript/semantic` writes a case particle onto its word** in ko (`"x"을 #out에 넣다`, `나를`,
+  each particle in the form the syllable takes), ja (`#outに`, `.aを`) and bn (`#outএ`, `.xকে`), and tr
+  fuses a suffix with its own reference words (`sonucu`, `hedefe`, `belgeye`) while code keeps its
+  suffix apart (`#out e`) until a reviewer picks a code word's harmony. tr also reads a suffix on code
+  after an apostrophe (`#out'a`, `.active'i`).
+- **`@lokascript/semantic`: a custom event in a wait takes the language's `event` word** (`esperar evento foo`,
+  ja `イベント foo 待つ`), as `repeat until event X` already does; a known DOM event keeps `esperar transitionend`.
+  `wait for <custom event>` was refused in every language. A possessive whose property is a reference word
+  (`its.detail`) now reads back as that property, not the language's word for it.
+- **`@lokascript/semantic`: ms and pl read their lexicon's `undefined` word** (`tidak_ditakrifkan`, `niezdefiniowane`),
+  which read back as a variable name.
+- **`@lokascript/testing-framework`: the hand-written-input gate** (`hand-written-input.test.ts`): twenty tasks a
+  native speaker writes from English, run as written on the engine against upstream; committed with no inputs.
+- **`@lokascript/semantic` writes a handler head as one word**: ja `クリックで` (was `クリック を で`),
+  bn `ক্লিকে` (the locative in the form the word takes: `জমাতে` after a vowel; was `ক্লিক তে`),
+  tr `tıklamada` (the locative in the form harmony gives: `göndermede`, `değişiklikte`; code keeps it apart, `keyup da`; was `tıklama i üzerinde`). The readers keep taking the two-marker heads.
+- **`@lokascript/semantic` writes a query's scope before the query** in bn, hi, tr, ja and ko (tr
+  `bendeki <p/>`, hi `मुझ में स्थित <p/>`, ja `自分 の中の <p/>`), where it wrote English's order.
+- **`@lokascript/semantic`: es and pt write the `focus` and `blur` commands as verbs** (`enfocarme`,
+  `focar-me`); the nouns were the events' and still read.
+- **`@lokascript/semantic`: ja's head pattern outranks its fused handler patterns**, so a ja handler's
+  body always takes the clause walk: a `js … end` block after `then` and `fetch … as T` round-trip
+  where the fused path dropped them. The 2026-08 transformer's verb-first `繰り返し イベント X を まで`
+  body no longer reads in ja (the render since 2026-08-28 does).
+
+- **`@lokascript/htmx-adapter`: the tr vocab gains `hx-da` as an alias of `hx-on`;** `hx-üzerinde` stays the name
+  (the profile's `on` word moved to the locative; a suffix is the wrong register for an attribute name).
+
+### Fixed
+
+- **`publish.yml`: a repair run skips a version npm is still processing** (`E409 previously staged`)
+  instead of failing the whole run.
+
 ## [4.4.0] - 2026-10-10
 
 Translations now read as their language. In 4.3.0, 19% of the corpus's translations and 24% of the
@@ -23,8 +213,8 @@ language has a word for. The words are the owner's vocabulary sheet
   counts, per render, the English grammar words (the tokens the engine's own parser matched in the
   source), English event names the language's lexicon has a word for, and a nominative `me` beside a
   marker in the 13 languages where that case is wrong. Two shrink-only baselines (the corpus, in
-  `test:canonical`, and the command-shape cases, in their shards); `tools/regen-english-leaks-baseline.ts
-  --report` prints each language against M2's targets. An English alternative a profile keeps for
+  `test:canonical`, and the command-shape cases, in their shards);
+  `tools/regen-english-leaks-baseline.ts --report` prints each language against M2's targets. An English alternative a profile keeps for
   code-switched input, beside a primary that is the language's own, counts as English.
 - **`@lokascript/semantic`: `transition … from … to`** reads and writes in every language (a `source`
   role), and the bare command reads in English. The schema's `destination` role is gone: upstream has
@@ -41,8 +231,8 @@ language has a word for. The words are the owner's vocabulary sheet
   back in English as upstream's first person), `does not match`, `fetch … do not throw`, `on first`,
   `go back`, `from elsewhere`, a loop's `index`, `start view transition`, a query's `in`, a conversion's
   `as` (the type name stays English), `the X of Y` inside an expression (es `valor de #price`, ja
-  `#priceの値`), `catch` and `finally`, `element x`, and `def` (as the noun "function", es `función
-  greet(name)`). bn, th and vi have their own `document` and `window`; he has its own words for all of
+  `#priceの値`), `catch` and `finally`, `element x`, and `def` (as the noun "function", es
+  `función greet(name)`). bn, th and vi have their own `document` and `window`; he has its own words for all of
   these and for `matches`, `exists`, `or`, `not`, `first`, `next`, `previous`, `closest`, `empty`, `is`,
   `document` and `window`; and the 15 languages that wrote English `forever` have their own (es
   `repetir siempre`, de `endlos`, ja `ずっと`). Every reader still takes the English words. Where a word
@@ -1546,7 +1736,9 @@ _Synchronized version release. See git history for details._
 - npm access token stored in GitHub Secrets
 - 2FA recommended for npm organization
 
-[Unreleased]: https://github.com/codetalcott/hyperfixi/compare/v4.4.0...HEAD
+[Unreleased]: https://github.com/codetalcott/hyperfixi/compare/v4.6.0...HEAD
+[4.6.0]: https://github.com/codetalcott/hyperfixi/compare/v4.5.0...v4.6.0
+[4.5.0]: https://github.com/codetalcott/hyperfixi/compare/v4.4.0...v4.5.0
 [4.4.0]: https://github.com/codetalcott/hyperfixi/compare/v4.3.0...v4.4.0
 [4.3.0]: https://github.com/codetalcott/hyperfixi/compare/v4.2.0...v4.3.0
 [4.2.0]: https://github.com/codetalcott/hyperfixi/compare/v4.1.0...v4.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperfixi/behaviors",
-  "version": "4.4.0",
+  "version": "4.6.0",
   "description": "Reusable hyperscript behaviors for @hyperfixi/engine (hyperfixi-hs.js) and upstream _hyperscript",
   "type": "module",
   "main": "./dist/index.js",
@@ -114,10 +114,10 @@
     "test:check": "VITEST_QUIET=1 bash ../../scripts/vitest-run.sh --reporter=dot"
   },
   "peerDependencies": {
-    "@hyperfixi/engine": "^4.4.0"
+    "@hyperfixi/engine": "^4.6.0"
   },
   "devDependencies": {
-    "@hyperfixi/engine": "^4.4.0",
+    "@hyperfixi/engine": "^4.6.0",
     "tsup": "^8.0.0",
     "typescript": "^5.0.0",
     "vitest": "^5.0.2"