@hyperfixi/types-browser 7.4.0 → 7.5.1

package/CHANGELOG.md

@@ -7,6 +7,117 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [7.5.1] - 2026-10-23
+
+The last two silent misreads of hand-written non-English hyperscript that the 7.3.0 live test
+found: one is now refused, the other reads right.
+
+### Fixed
+
+- **ko: an event word followed by its object particle is the verb's object, not a handler.** At
+  top level, hand-written `로드 를 대기` (wait for load) read as `on load wait 를`: a handler on
+  `load` waiting on a variable named `를`, and translate() did not refuse it. Top level is now
+  refused, as ja `ロード を 待つ` and tr `yükleme i bekle` already were; inside a handler,
+  `클릭 할 때 로드 를 대기` still reads `wait for load`. ko's own render of
+  `trigger click on #btn …` (`#btn에 클릭을 트리거 …`) had been refused for the same reason and now
+  translates.
+- **es `eso`, `esto` and a detached `lo` read as `it`, as do pt `isto` and fr `cela`/`ceci`.**
+  `poner eso en #o` read `put eso into #o`, a variable nobody set, with no error. Most profiles
+  already write `it` as a demonstrative (pt `isso`, fr `ça`, ru `это`, he `זה`, ja `それ`). What
+  `it` renders to is unchanged. A variable spelled like one of these words now reads as `it` in
+  that language, as one named `isso` already did in pt; MCP `translate_code` reports it
+  (`NAME_COLLISION`) with a rename.
+
+## [7.5.0] - 2026-10-22
+
+What a live test of 7.3.0 found users hitting. The Vite plugin loads in a CommonJS project and
+ships types. MCP `diff_behaviors` compares whole handlers, and `npx` installs the engine.
+Hand-written non-English hyperscript that ran wrong in silence now reads right or says so. A
+minor: `@lokascript/htmx-adapter`'s `hx-on` change restores what its README always documented
+(bodies are JavaScript by default), and a page that relied on the engine switching them adds
+`<meta name="htmx-i18n-hx-on" content="hyperscript">`.
+
+### Changed
+
+- **`@lokascript/htmx-adapter`: `hx-on` bodies stay JavaScript unless the page opts in to
+  hyperscript bodies.** The adapter used to switch every `hx-on` body on the page to hyperscript
+  whenever a hyperscript engine (`window._hyperscript`) was loaded, and the documented stack (the
+  engine, htmx 4 and this adapter) always has one. So a plain-JavaScript
+  `hx-on:click="document.getElementById('o').textContent = 'ran'"` failed with a hyperscript parse
+  error, although the README says bodies are JavaScript by default. The opt-in is now explicit:
+  `<meta name="htmx-i18n-hx-on" content="hyperscript">`, or `setBodyExecutor()` as before. A page
+  that wrote hyperscript `hx-on` bodies and relied on the engine alone adds the `<meta>` tag. With
+  the tag and no engine on the page, the adapter warns and the bodies stay JavaScript.
+
+### Fixed
+
+- **`@hyperfixi/vite-plugin` loads in a CommonJS project.** `npm init -y` writes
+  `"type": "commonjs"`, and there the plugin's `require` build failed with
+  `ERR_PACKAGE_PATH_NOT_EXPORTED`: it requires `@hyperfixi/engine`, whose `exports` had only an
+  `import` condition. The engine's `exports` now name its ES module as the `default` too, which
+  Node 20.19+ and 22.12+ (what Vite 8 needs) can `require`.
+- **`@hyperfixi/vite-plugin` ships types for the app side** (`@hyperfixi/vite-plugin/client`):
+  the virtual module and `window.hyperfixi` / `window._hyperscript`. A TypeScript 6 project
+  rejected `import 'hyperfixi'` (`TS2882`). The README has a TypeScript section, with JSX's
+  `data-script` and an augmentation for `_`.
+- **The Vite plugin's scanner reads a `<script type="text/hyperscript">` block that contains
+  `<`** (`if n < 10`, a `<div/>` query). It skipped the whole block, so its commands were not
+  bundled and the page failed to parse. It also reads the `script` and `data-script` attributes,
+  which the engine runs as it runs `_`, and a production build scans Vite's `root` rather than the
+  working directory (`vite build app` from a parent directory bundled the siblings' modules).
+- **MCP `diff_behaviors` no longer calls any two multi-command or `if` handlers identical.** It
+  compared the operations it could extract, and it extracted single commands only: a `then` chain
+  (a `compound` node), an `if`, a loop and every command it had no extractor for gave nothing, so
+  `remove .b then wait 2s` and `remove .c then wait 5s` were "No semantic change", and so were an
+  English handler and an unrelated Spanish one. It now compares every command of a chain, both
+  branches of an `if`, a loop's body, and any other command with all its written roles (a
+  `fetch`'s `with` options included), and `this` is no longer read as `me`. Faithful translations
+  still compare identical (checked on chains, branches, loops and `wait for` in ja, es and ar).
+- **`npx @hyperfixi/mcp-server` installs the engine.** `@hyperfixi/engine`, `@hyperfixi/core` and
+  `@hyperfixi/server-bridge` were optional peers, which `npx` leaves out, so the documented
+  install checked nothing on the engine: every error only the engine catches came back `ok`, and
+  only stderr said so. They are dependencies now, and a validation whose engine check could not
+  run says so in the result (`ENGINE_CHECK_SKIPPED`, `info`; `get_diagnostics`:
+  `engine-check-skipped`). release-smoke installs the server alone and checks for the three.
+- **Validation warns on `this`** (`THIS_IS_NOT_ME`): hyperscript has no `this`, so
+  `toggle .a on this` or `put this.value.length into #n` reads a variable nobody set and does
+  nothing. These validated clean (6 of 10 clean-validating snippets that did nothing, in the 7.3.0
+  live test). The inert-shape warnings also reach commands after a `then` and inside an `if`'s
+  branches; they read only a block's `body` before.
+- **The IR `validate_and_compile` returns has the commands of a chain, a branch or a loop**: a
+  `then` chain is `compound` with each command in `body`, an `if` has `body` and `else`. A chain
+  came back as `compound` with no commands, so it could not be checked against an intent.
+- **AGENTS.md** said `this`, `and` or a comma between commands, and `put … in` work; all four fail
+  on both engines. Its worked example showed output the server no longer gives, and it quoted a
+  fidelity figure ("~76%") from before the renderer reached 100% on the corpus. Rewritten from the
+  server's real output.
+- **Multilingual: a native time unit after the event is a duration.** ko `클릭할 때 1초 대기`,
+  tr `tıklamada 1 saniye bekle` and ja `クリックで 1 秒 待つ` came back `on click 1 wait s`: the
+  number became a click count (the handler ran on the first click only) and the wait waited for
+  nothing, with no error. A number and the language's word for a unit after it, glued or spaced,
+  are one duration now (`wait 1s`, `wait 150ms`).
+- **Multilingual: a bare URL with a number in it translates.** `fetch /api/items/42` and
+  `fetch /api/slow?ms=300` were refused in every language, both ways ("would lose 42"): the check
+  counted the URL's numbers alone, and the translation writes the URL quoted. A bare URL is one
+  value now, the same as quoted.
+- **Multilingual: es and pt `esperar a <event>` waits for the event.** es `esperar a continue`
+  came back `wait continue`, a timed wait on a variable, which waits for nothing. `esperar a`
+  (es, pt) and `esperar por` (pt) read as `wait for`, as `esperar evento` already did.
+- **Multilingual: a hover word is `mouseenter`.** Eighteen languages' hover word (es `sobrevolar`,
+  fr `survol`, ko `호버`, …) read as `on hover`, which is not a DOM event, so the handler never ran.
+  They read as `on mouseenter` now; what `on mouseenter` is written as does not change.
+- **Multilingual: a dropped word with content of its own is refused, not dropped.** es
+  `al hacer clic fuera quitar .open de mí` came back `on click remove .open from me` (the dropdown
+  closed on every click): a particle the language maps to a word with meaning (`fuera`, `out`) was
+  skipped like a role marker. Such a translation is refused now (`LossyTranslationError`).
+- **`@lokascript/hyperscript-adapter` warns when a handler listens for a word nothing fires.**
+  A word the language does not know as an event (es `al pulsar …`, de `beim Tippen …`) runs as a
+  custom event of that name, and the handler never ran, silently. The adapter now warns once per
+  language and word. A name written as code (`miEvento`, `draggable:start`) stays quiet. No event
+  words were added: loka-js and our dictionaries ship the noun (`clic`), not the verbs. MCP
+  `validate_and_compile` reports the same, as an `UNKNOWN_EVENT_WORD` warning on non-English
+  input (`get_code_fixes` has its fix).
+
 ## [7.4.0] - 2026-10-21
 
 Content htmx or fixi swaps in runs its hyperscript, as it does on upstream `_hyperscript`: the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperfixi/types-browser",
-  "version": "7.4.0",
+  "version": "7.5.1",
   "description": "TypeScript definitions for the hyperfixi browser globals: window.hyperfixi / window._hyperscript (the engine), LokaScriptSemantic, LokaScriptI18n",
   "type": "module",
   "types": "dist/index.d.ts",
@@ -30,7 +30,7 @@
   "author": "LokaScript Contributors",
   "license": "MIT",
   "devDependencies": {
-    "@hyperfixi/engine": "^7.4.0",
+    "@hyperfixi/engine": "^7.5.1",
     "typescript": "^5.8.3"
   },
   "publishConfig": {