@hyperfixi/testing-framework 7.5.0 → 7.6.0

package/CHANGELOG.md

@@ -7,6 +7,130 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [7.6.0] - 2026-11-10
+
+The engine takes extensions: upstream's `tailwind` and `socket` load from a script tag or
+`register(...)`, and the Vite plugin bundles them. Spanish and Portuguese handlers agree with their
+event (`a la entrada`, `à mudança`), and German writes an event as the noun it is (`wenn Klick`).
+A minor: new features, and renders that change in es, pt and de; everything written before still
+reads.
+
+### Added
+
+- **`@hyperfixi/vite-plugin`: `extensions: ['socket', 'tailwind']`.** The generated bundle
+  imports each `@hyperfixi/engine/ext/<name>` and registers it after the modules, and the dev
+  `everything` fallback does too. Extensions are opt-in, so the scan never adds one. A project
+  that lists an extension gets an engine bundle even when the scan found nothing else (a page
+  whose only hyperscript is a `socket`).
+  - **Which module comes with `toggle` is now read from the grammar.** The plugin used to have
+    the rule "`toggleElement` comes with `toggle`" written in; it now reads which modules add
+    a reading to a command (`Grammar.fallbacks`).
+  - **`verify:reference` checks the engine's extensions as its own.** It registers each
+    `dist/ext/<name>.esm.js`, documents their keywords like the engine's, and parses their
+    examples: `socket`'s hover example is now checked, where it was skipped as "upstream's".
+
+- **`@hyperfixi/engine`: extensions that a script tag can load.** After `hyperfixi-hs.js`, a page
+  can load `ext/<name>.js`, which registers its module with the page's engine. Or, from ESM,
+  `register(...everything, tailwind)` with `@hyperfixi/engine/ext/tailwind`.
+  - **The first extension is upstream's `tailwind`** (the `twDisplay`, `twVisibility` and
+    `twOpacity` hide/show strategies), and upstream's 12 tests for it are now in the engine's
+    gate: 1,434 of 1,498.
+  - **The public object gains `register` and `extensions`, and the script-tag bundle's also gains
+    `kit`.** `register` adds modules. `extensions` lists the extension files the page has
+    loaded. `kit` holds what a module may call: the same names the library entry exports for
+    module authors. Only `hyperfixi-hs.js` carries the kit, so a bundle built from ESM (the Vite
+    plugin's) keeps only the parts of the engine it uses; it registers extensions from ESM, and an
+    extension file loaded beside it says so.
+  - **`register` skips a module it has already added.** When it does add one, it reads again
+    the elements whose scripts failed to parse, so an `async` or late-loaded extension still
+    applies.
+  - **Upstream's own `ext/tailwind.js` also runs on the engine unchanged**, through `use`.
+- **`@hyperfixi/engine/ext/socket`: upstream's `socket` feature.** `socket Chat ws://… [with
+timeout n] [on message [as JSON] …] end` defines `Chat`, a WebSocket with `raw`,
+  `dispatchEvent` (`send ping to Chat` sends the event as JSON) and an `rpc` proxy
+  (`Chat.rpc.f(…)` returns a promise for the reply).
+  - **Upstream's 16 socket tests pass:** the suite is 1,450 of 1,498, with 48 known failures.
+  - **Two differences from upstream:** the socket opens when the feature is installed, not
+    when it is parsed, so a parse alone opens nothing; and with `as JSON` a message that is
+    JSON `0`, `false` or `null` is that value, where upstream rejects it.
+  - **The kit grows to what a feature needs:** `dotOrColonPath`, `urlOrExpression`,
+    `evalStatic`, `commandList`, `makeContext`, `runList` and `assignToNamespace`. Each is
+    exported from `@hyperfixi/engine` and carried on `hyperfixi-hs.js`'s `_hyperscript.kit`.
+
+### Changed
+
+- **`@lokascript/semantic`: a Spanish or Portuguese handler's head agrees with its event, and
+  German writes an event as a noun.** Renders only; everything written before still reads.
+  - **es, pt:** `al` and `ao` hold the masculine article, and were written before every event
+    (`al entrada agregar .a`, `ao mudança de #search …`). A feminine event takes `a la` and `à`:
+    `a la entrada agregar .a`, `à mudança de #search disparar envio em #form`. The first event of
+    an `or` decides; an infinitive (`al redimensionar`) and a custom name (`al my:event`) keep the
+    masculine. Each profile lists its feminine event words (`eventHandler.feminineEventMarker`).
+    es reads `a la` as the head only before one of them, so `poner x a la` is still a put into a
+    variable named `la`. pt's `à` joins its letters and prepositions.
+  - **de:** an event's word takes its capital wherever a command names one: `wenn Klick`,
+    `wenn Änderung von #search auslösen Absenden auf #form`, `warten Änderung`. An event with no
+    German word stays code (`wenn keyup`). The event table lists each one-word name both ways, so
+    `wenn klick` and `wenn doppelklick` read as before.
+
+- **`@hyperfixi/engine`: a module can add a reading to a command without changing what the
+  command reads (`Grammar.fallbacks`).** A fallback registered for a keyword is tried, from just
+  after the keyword, only when the command's own rule fails to parse, and it counts only if it
+  reads at least as far as that rule got. `toggle <element>` (the `toggleElement` module) is now
+  one. Every `toggle` that upstream reads now goes through upstream's rule exactly (registering
+  `toggleElement` used to send every `toggle <target>` through a different expression rule).
+  An unfinished upstream `toggle` now reports upstream's error: `toggle #d as` used to say
+  `Expected 'modal'`, and now says `Expected dotOrColonPath`, as upstream does. The
+  `Grammar.toggleElement` slot is gone; a module that set it registers a fallback instead.
+  `Parser` gains `mark()` and `reset()`.
+
+### Fixed
+
+- **`@lokascript/semantic`: a translated `socket` comes back as the socket upstream reads.**
+  A socket's `on message [as JSON] …` is its own clause, closed by the socket's one `end` (or
+  by the end of the script). Semantic read it as an event handler, eventsource's shape, so:
+  - a clause closed by `end` came back with a second `end`, in every language. The engine
+    rejects that, so a translated socket failed to parse on the page;
+  - a clause with no `end` (upstream's tests write them that way) lost its body, and a
+    clause's `as JSON` was read as leftover input. `translate` refused both;
+  - a dotted name came back split: `socket MyApp.chat …` became `socket MyApp .chat …`, a
+    different socket.
+
+  `as JSON` is now written with the language's own word for `as`, as a conversion is (es
+  `como JSON`, ja `として JSON`). Text semantic wrote before, with two `end`s, still reads as
+  the one socket it was.
+
+  Where a language puts its handler word after the event (ja `messageで`, tr `message da`), a
+  socket or eventsource whose body starts with a word that looks like an event (ja
+  `messageで messageを 記録`, "on message log message") now reads. The handler word used to
+  be taken as the start of the body.
+  - **Measured by the command-shape gate, which now reads extension syntax.** Its engine
+    registers every extension the engine builds. Its harvest reads upstream's `ext/` tests,
+    and the scripts a test writes as `textContent` (how upstream's socket tests write theirs).
+    That adds 33 cases (1,168 in all), and each passes in all 24 lanes. Before this fix, 4 of
+    the 16 socket cases were refused in every language and 1 was silent in every language.
+
+## [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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperfixi/testing-framework",
-  "version": "7.5.0",
+  "version": "7.6.0",
   "description": "Cross-platform behavior testing suite for LokaScript applications",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -57,25 +57,25 @@
     "jsdom": "^30.1.3"
   },
   "devDependencies": {
-    "@hyperfixi/engine": "^7.5.0",
-    "@hyperfixi/patterns-reference": "^7.5.0",
-    "@lokascript/compilation-service": "^7.5.0",
-    "@lokascript/hyperscript-adapter": "^7.5.0",
-    "@lokascript/i18n": "^7.5.0",
-    "@lokascript/semantic": "^7.5.0",
+    "@hyperfixi/engine": "^7.6.0",
+    "@hyperfixi/patterns-reference": "^7.6.0",
+    "@lokascript/compilation-service": "^7.6.0",
+    "@lokascript/hyperscript-adapter": "^7.6.0",
+    "@lokascript/i18n": "^7.6.0",
+    "@lokascript/semantic": "^7.6.0",
     "@types/diff": "^5.0.0",
-    "@types/node": "^26.6.5",
+    "@types/node": "^26.6.6",
     "@vitest/coverage-v8": "^5.0.5",
     "esbuild": "^0.28.2",
-    "happy-dom": "^21.0.3",
-    "hyperscript.org": "0.9.93",
+    "happy-dom": "^21.0.4",
+    "hyperscript.org": "0.9.94",
     "playwright": "^1.40.0",
-    "puppeteer": "^25.14.0",
+    "puppeteer": "^25.16.0",
     "tsup": "^9.0.0",
     "tsx": "^4.23.15",
     "typescript": "^5.0.0",
     "url-parse": "^1.5.10",
-    "vite": "^8.3.4",
+    "vite": "^8.3.5",
     "vitest": "^5.0.5"
   },
   "peerDependencies": {

package/src/multilingual/command-shapes.cases.json

@@ -4094,6 +4094,108 @@
       "origin": "upstream:expressions/relativePositionalExpression.js",
       "family": "expressions/relativePositionalExpression"
     },
+    {
+      "id": "091229c5d5",
+      "source": "init set :userId to 42",
+      "origin": "upstream:ext/hs-include.js",
+      "family": "ext/hs-include"
+    },
+    {
+      "id": "20864ca9a9",
+      "source": "init set :a to 1 then set :b to 2",
+      "origin": "upstream:ext/hs-include.js",
+      "family": "ext/hs-include"
+    },
+    {
+      "id": "681a650ebc",
+      "source": "init set :x to 10 then set :y to 20",
+      "origin": "upstream:ext/hs-include.js",
+      "family": "ext/hs-include"
+    },
+    {
+      "id": "f0587c6604",
+      "source": "init set :shared to 99",
+      "origin": "upstream:ext/hs-include.js",
+      "family": "ext/hs-include"
+    },
+    {
+      "id": "1984d270b6",
+      "source": "init set :data to 'hello'",
+      "origin": "upstream:ext/hs-include.js",
+      "family": "ext/hs-include"
+    },
+    {
+      "id": "fca5d91170",
+      "source": "init set :obj to {name: 'Alice', age: 30}",
+      "origin": "upstream:ext/hs-include.js",
+      "family": "ext/hs-include"
+    },
+    {
+      "id": "c097c27bb7",
+      "source": "init set :ctx to 'parent-val'",
+      "origin": "upstream:ext/hs-include.js",
+      "family": "ext/hs-include"
+    },
+    {
+      "id": "f0a9124287",
+      "source": "init set :secret to 42",
+      "origin": "upstream:ext/hs-include.js",
+      "family": "ext/hs-include"
+    },
+    {
+      "id": "fc81c34197",
+      "source": "init set :parent to 1",
+      "origin": "upstream:ext/hs-include.js",
+      "family": "ext/hs-include"
+    },
+    {
+      "id": "db6494f862",
+      "source": "init set :child to 2",
+      "origin": "upstream:ext/hs-include.js",
+      "family": "ext/hs-include"
+    },
+    {
+      "id": "0f42ea807f",
+      "source": "on click hide with twDisplay",
+      "origin": "upstream:ext/tailwind.js",
+      "family": "ext/tailwind"
+    },
+    {
+      "id": "d4dd4fbc1d",
+      "source": "on click hide with twVisibility",
+      "origin": "upstream:ext/tailwind.js",
+      "family": "ext/tailwind"
+    },
+    {
+      "id": "0152108937",
+      "source": "on click hide with twOpacity",
+      "origin": "upstream:ext/tailwind.js",
+      "family": "ext/tailwind"
+    },
+    {
+      "id": "ff1010c461",
+      "source": "on click show",
+      "origin": "upstream:ext/tailwind.js",
+      "family": "ext/tailwind"
+    },
+    {
+      "id": "f7364805ea",
+      "source": "on click show with twDisplay",
+      "origin": "upstream:ext/tailwind.js",
+      "family": "ext/tailwind"
+    },
+    {
+      "id": "f11631adde",
+      "source": "on click show with twVisibility",
+      "origin": "upstream:ext/tailwind.js",
+      "family": "ext/tailwind"
+    },
+    {
+      "id": "1148eae2fa",
+      "source": "on click show with twOpacity",
+      "origin": "upstream:ext/tailwind.js",
+      "family": "ext/tailwind"
+    },
     {
       "id": "64506b6e66",
       "source": "behavior TheBehaviorWeAreDefiningForHyperscriptTestingPurposes init log 'foo' end end",
@@ -5378,6 +5480,96 @@
       "origin": "upstream:features/set.js",
       "family": "set"
     },
+    {
+      "id": "65ad8f100f",
+      "source": "socket MySocket ws://localhost:1234/ws end",
+      "origin": "upstream:features/socket.js",
+      "family": "socket"
+    },
+    {
+      "id": "e825557954",
+      "source": "socket RelSocket /my-ws end",
+      "origin": "upstream:features/socket.js",
+      "family": "socket"
+    },
+    {
+      "id": "986e3eaa40",
+      "source": "socket TimedSocket ws://localhost/ws with timeout 1500 end",
+      "origin": "upstream:features/socket.js",
+      "family": "socket"
+    },
+    {
+      "id": "1a9bebbdab",
+      "source": "socket TextSocket ws://localhost/ws\n  on message\n    set window.socketFired to true",
+      "origin": "upstream:features/socket.js",
+      "family": "socket"
+    },
+    {
+      "id": "9034d0021e",
+      "source": "socket JsonSocket ws://localhost/ws\n  on message as JSON\n    set window.socketFiredJson to true",
+      "origin": "upstream:features/socket.js",
+      "family": "socket"
+    },
+    {
+      "id": "06052308f5",
+      "source": "socket RpcSocket ws://localhost/ws end",
+      "origin": "upstream:features/socket.js",
+      "family": "socket"
+    },
+    {
+      "id": "36a011f738",
+      "source": "socket ErrSocket ws://localhost/ws end",
+      "origin": "upstream:features/socket.js",
+      "family": "socket"
+    },
+    {
+      "id": "d891336fd9",
+      "source": "socket NoTOSocket ws://localhost/ws with timeout 20 end",
+      "origin": "upstream:features/socket.js",
+      "family": "socket"
+    },
+    {
+      "id": "6df4022d85",
+      "source": "socket CustomTOSocket ws://localhost/ws with timeout 60000 end",
+      "origin": "upstream:features/socket.js",
+      "family": "socket"
+    },
+    {
+      "id": "bc88ad8664",
+      "source": "socket DefTOSocket ws://localhost/ws with timeout 50 end",
+      "origin": "upstream:features/socket.js",
+      "family": "socket"
+    },
+    {
+      "id": "658e4c1024",
+      "source": "socket BlacklistSocket ws://localhost/ws end",
+      "origin": "upstream:features/socket.js",
+      "family": "socket"
+    },
+    {
+      "id": "e390bb9a76",
+      "source": "socket DispatchSocket ws://localhost/ws end",
+      "origin": "upstream:features/socket.js",
+      "family": "socket"
+    },
+    {
+      "id": "b013d4626b",
+      "source": "socket ReconnectSocket ws://localhost/ws end",
+      "origin": "upstream:features/socket.js",
+      "family": "socket"
+    },
+    {
+      "id": "6bed0e799a",
+      "source": "socket StrictJsonSocket ws://localhost/ws\n  on message as JSON\n    set window.strictFired to true",
+      "origin": "upstream:features/socket.js",
+      "family": "socket"
+    },
+    {
+      "id": "50c36977a8",
+      "source": "socket MyApp.chat ws://localhost/ws end",
+      "origin": "upstream:features/socket.js",
+      "family": "socket"
+    },
     {
       "id": "e094621ad0",
       "source": "when $global changes put it into me",
@@ -6800,6 +6992,12 @@
       "origin": "hover:live",
       "family": "live"
     },
+    {
+      "id": "dc07d12b70",
+      "source": "socket Chat ws://localhost:8080/chat\n  on message as json\n    log message\nend",
+      "origin": "hover:socket",
+      "family": "socket"
+    },
     {
       "id": "90d44b4675",
       "source": "bind $name and #input's value",

package/src/multilingual/command-shapes.cases.test.ts

@@ -37,15 +37,18 @@ describe('command-shape cases', () => {
   });
 
   // A re-harvest that changes the count is a change to the gate's input:
-  // update this pin in the same PR, and say what moved.
-  it('are the 1135 the harvest found', () => {
-    expect(cases.length).toBe(1135);
+  // update this pin in the same PR, and say what moved. (1135 → 1168, 2026-10-25: the
+  // engine reads with its extensions, and the harvest reads `ext/` and `textContent`
+  // scripts: upstream's 15 socket scripts and socket's hover example, 7 tailwind, 10
+  // hs-include `init` scripts.)
+  it('are the 1168 the harvest found', () => {
+    expect(cases.length).toBe(1168);
     const byOrigin = cases.reduce<Record<string, number>>((m, c) => {
       const kind = c.origin.split(':')[0] ?? '';
       m[kind] = (m[kind] ?? 0) + 1;
       return m;
     }, {});
-    expect(byOrigin).toEqual({ upstream: 947, reference: 122, 'reference-pattern': 8, hover: 58 });
+    expect(byOrigin).toEqual({ upstream: 979, reference: 122, 'reference-pattern': 8, hover: 59 });
   });
 
   it('are not edited by hand: each id is the hash of its source', () => {

package/src/multilingual/command-shapes.ts

@@ -42,9 +42,9 @@
  * Regenerate with tools/regen-command-shapes-baseline.ts.
  */
 
-import { readFileSync } from 'node:fs';
+import { readdirSync, readFileSync } from 'node:fs';
 import path from 'node:path';
-import { fileURLToPath } from 'node:url';
+import { fileURLToPath, pathToFileURL } from 'node:url';
 import { FOREIGN_LANGUAGES } from './value-matrix';
 
 const here = path.dirname(fileURLToPath(import.meta.url));
@@ -52,6 +52,7 @@ const here = path.dirname(fileURLToPath(import.meta.url));
 export const CASES_PATH = path.join(here, 'command-shapes.cases.json');
 export const BASELINE_PATH = path.resolve(here, '../../baselines/command-shapes.json');
 const RUNNER_PATH = path.resolve(here, '../../../engine/upstream-suite/run.mjs');
+const EXT_DIR = path.resolve(here, '../../../engine/dist/ext');
 
 // ---------------------------------------------------------------------------
 // Cases
@@ -157,10 +158,29 @@ export type Reader = 'program' | 'statements';
 export const readerOf = (shape: Pick<CommandShapeCase, 'origin'>): Reader =>
   shape.origin.startsWith('upstream:') ? 'program' : 'statements';
 
-/** The engine's two readers. Statements exclude a lone expression: it is not a script. */
+/**
+ * The engine's two readers. Statements exclude a lone expression: it is not a script.
+ *
+ * They read with every module AND every extension the engine builds (`dist/ext/<name>.esm.js`,
+ * each exporting a module named `<name>`): a page that loads `ext/socket.js` is translated
+ * like any other, so its syntax is a case like any other. Read with `everything` alone, the
+ * harvest dropped every socket script as one the engine does not parse.
+ */
 export async function loadEngineReaders(): Promise<Record<Reader, EngineParser>> {
   const engine = await import('@hyperfixi/engine');
-  engine.register(...engine.everything);
+  const extensions = await Promise.all(
+    readdirSync(EXT_DIR)
+      .filter(f => f.endsWith('.esm.js'))
+      .sort()
+      .map(async f => {
+        const name = f.slice(0, -'.esm.js'.length);
+        const mod = (await import(pathToFileURL(path.join(EXT_DIR, f)).href))[name];
+        if (typeof mod !== 'function') throw new Error(`${f} exports no module named ${name}`);
+        return mod as (typeof engine.everything)[number];
+      })
+  );
+  if (extensions.length === 0) throw new Error(`no extensions in ${EXT_DIR}: build the engine`);
+  engine.register(...engine.everything, ...extensions);
   return {
     program: { parse: engine.parseProgram },
     statements: {