@qxuken/kui 0.1.0-alpha.41 → 0.1.0-alpha.42

package/CHANGELOG.md

@@ -21,6 +21,194 @@ listed under both (backlog F61, from the alpha.12 field reports: the list
 is what the release knows it broke, and a fix it did not think of as one
 was the first bare bump to break an app in five releases).
 
+## 0.1.0-alpha.42 (2026-10-07)
+
+**What breaks.**
+
+- A press after a dead key it does not combine with carries what the
+  platform typed in its `text`: German's `^ space` is a Space whose
+  `text` is `^`, and `^ z` a `z` whose `text` is `^z`, where they said `" "`
+  and `z` — in a key sink's payload and in what an editor inserts (under
+  Fixed, RG127). A keymap that binds Space by its `text` rather than its
+  `code` sees the accent there.
+- Node: a whole number past 2^53 in a message comes back a `number`,
+  where it came back a `BigInt` (RG138).
+- C: `kui_take_menu_action` with a NULL or too-small `out` leaves the
+  action queued, where it dropped it; `kui_take_warnings` keeps what does
+  not fit `cap` for the next call, where it dropped it; `kui_draw_data`'s
+  `fragments` and `textures` are NULL on a frame that draws none, where
+  they were a non-NULL pointer to nothing (RG133, RG134, RG131).
+- A text style whose size or line height is under a pixel — 0, negative,
+  NaN — shapes at a pixel, where Node and Lua aborted or hung and Rust
+  panicked (RG136); a cell grid's rows are a pixel apart at an infinite
+  one, where they went to the layout's limit (RG144).
+- Rust: `schema::Door`, `schema::CustomProp` and `schema::ElementDef` gain
+  `odin` (under Added, the Odin binding), so a struct literal of one needs
+  the field.
+
+C stays at ABI 25 (kui.h gains no function and no field; four doors now
+keep what it always promised) and the Node wire at v21 (no frame version).
+
+### Added
+
+- **An Odin binding, experimental** (`packages/odin`). `kui/c` mirrors
+  kui.h declaration by declaration, pinned to the C compiler's layout by
+  848 generated `#assert`s. `kui` is the typed layer, generated from
+  kui.h and the prop schema:
+  - `Spec` and `Text_Style`, one field per schema row;
+  - an enum or bit set per family of constants;
+  - a door per C function: out-params as results, arrays as slices,
+    messages as plain Odin values with `#[derive(Message)]`'s `kind`
+    rule.
+
+  The elements are written by hand: containers close at the end of their
+  `if` through `@(deferred_in)`. A C function the hand-written files do
+  not call gets a generated door, so the binding covers kui.h whole: 219
+  generated, 51 by hand, 2 skipped with their reason.
+  `examples/odin/tools/surface.odin` is `surface.c` through it, and calls
+  every door, and `examples/odin/tools/conformance.odin` rebuilds the
+  scene corpus through `Spec` and the doors, matching the reference report
+  byte for byte, as the Rust, Lua, C and Node adapters do.
+  `polyline` and `polygon` take points (`[][2]f32`), the count kui.h
+  means; a dash or a pivot is a fixed array in a `Maybe` (`[5]f32`,
+  `[2]f32`), so a short one cannot be written; and pixels are checked
+  against the size beside them.
+
+  It covers extensions both ways. An Odin host loads a plugin with
+  `ctx_add_extension` and `slot`. An Odin plugin is a shared library whose
+  seven `kui_ext_*` exports are one line each over `extension.odin`.
+  Built with `KUI_PLUGIN` on macOS and Linux, it links no kui and loads
+  into any host (on Windows it imports `kui_ffi.dll`, as a C plugin does):
+  `nu scripts/odin.nu slots` drives the Odin panel in the C and Rust
+  hosts and the C panel in the Odin host.
+
+  Run it with `nu scripts/odin.nu gen | test | slots | run counter`. It is
+  not published. CI's `check` installs a pinned Odin release (`ODIN_VERSION`)
+  and runs `gen --check`, `check`, `test` and `slots`, so a header or schema
+  change that was not regenerated goes red there. All four also run green
+  by hand on Windows x64 and Linux x64. On Windows the binding links
+  `kui_ffi.dll.lib`, odin.nu puts `kui_ffi.dll` beside the programs, and
+  `gen --check` reads a CRLF checkout as current.
+- `scripts/pack-ffi.nu`: libkui_ffi for every platform kui ships, dynamic
+  and static, with `kui.h`, rustc's `native-static-libs` as `link.txt`, a
+  tarball each and `SHA256SUMS`. It is for a C or Odin host that links a
+  library instead of building the workspace. The machine's own platform
+  is built natively. Linux x64 and arm64 (glibc 2.28) and Windows x64 are
+  built in a pinned Docker image, with cargo-zigbuild at the release
+  workflow's pins and with cargo-xwin. Windows also asks for
+  `--accept-msvc-license`, for the CRT and SDK xwin downloads. macOS is
+  built on a Mac only. A Windows pack carries windows-targets' import
+  libraries (`windows.0.53.0.lib`, `windows.0.52.0.lib`), which its
+  `link.txt` names and no SDK has, so a static link finds them. Every
+  leg has been run, and a C host linked against each x64 pack alone,
+  dynamically and statically, and run; the arm64 pack was read, with no
+  arm64 machine to run it on. `kui.h` ships with LF line ends from any
+  checkout.
+- `examples/rust/tools/schema-dump.rs`: the prop schema (props,
+  composites, elements, events, the verb table, the name lists) as JSON,
+  for a binding generated outside Rust.
+- The verb table (`schema::DOORS`) and `docs/props.md` have an Odin
+  column beside C's, each spelling held by the Odin generator both ways;
+  Node's `protocol()` carries it (`Door.odin`).
+
+### Fixed
+
+- **A dead key types its accent before a key it does not combine with**
+  (backlog RG127, from the Windows and Linux round after alpha.41). With
+  German, `^ space` typed a space where it types `^`, `´ space` a space
+  where it types `´`, and `^ z` a `z` where it types `^z` — on Windows
+  always, and under X11 with `imeOff` on; on US-International, where `'`
+  and `"` are dead, a quote could not be typed at all. winit composed it
+  right: the runner read a press's text off the logical key, which is
+  the key the accent fell back to, and Space's insert was a space
+  whatever the press carried. A press's text is now what the platform
+  composed, the layout's character where it composed nothing, and Space
+  inserts its own. `^ e` was right and is unchanged; with the input
+  method on, X11 composes through XIM as before.
+- The docs of F103 (alpha.41) said an animating Windows window behind
+  other windows skips its frames. It does not: DWM composes a covered
+  window, and it draws at the display's rate, 241 frames a second here,
+  as an uncovered one does; minimized, it asks for none (RG45). F103's
+  wait holds there only for an acquire that times out. `retry.rs` says so
+  now (backlog RG128).
+- **Text is read aloud on Windows and Linux** (backlog RG129, from the
+  regression and smoke round after RG127). Every static text — a line of
+  text, a list row's content, a drawn title — reached UI Automation with
+  an empty Name and AT-SPI with an empty name: AccessKit names a label by
+  its value, and kui set only its label. macOS read it all along.
+- **A disclosure or a select opens from Narrator** (RG130). UI
+  Automation gives a node with `expanded` its ExpandCollapse pattern in
+  place of Invoke, and its Expand and Collapse reached nothing. They are
+  the node's click.
+- **A text size or line height of 0 no longer ends the process** (RG136).
+  `lineHeight: 0`, `size: 0`, or a size under 0.4 (whose line height
+  rounds to 0) aborted a Node or Lua process — cosmic-text asserts a line
+  height is not 0 — and a negative one spun its layout; on an `edit`, a
+  `cells` and in `measureText` too. Every buffer is shaped at a pixel at
+  least. C's door had always read them as unset.
+- C: what kui.h says a door hands out lives as long as it says (RG131–
+  RG134). A second `kui_draw_data` in a frame freed the arrays the first
+  handed out; `kui_access_runs` freed the strings `kui_access_tree`
+  handed out; reading a menu row or asking for a copy freed a taken menu
+  action's text; and `kui_take_warnings` dropped what did not fit `cap`,
+  where kui.h says the rest wait.
+- A custom editor whose `caret` or `selection_anchor` falls inside a
+  character has an access tree (RG135): the run was sliced there and
+  panicked, which under C emptied the tree every frame; the position is
+  the character's start.
+- Node: `measureText` inside a `<devtoolsTab>` function child no longer
+  breaks the frame being encoded (RG137); a message, a `<select>` option
+  or a `menuBar` row holding a string cut through an emoji draws its lone
+  surrogate as U+FFFD rather than failing the frame, and `dir: null` is
+  absent like every other null prop (RG138, RG140).
+
+### Native verification
+
+The by-hand round alpha.6 introduced (backlog R4), on 2026-10-07, over
+the rounds after the alpha.41 tag — the Odin binding and `pack-ffi.nu`,
+RG127 and RG128 from the Windows and Linux round after alpha.41, and the
+regression and smoke round after RG127 (RG129–RG138) — with alpha.42's
+pre-tag pass over them on the Mac: the mechanical round, then four
+read-only reviews of the diff since alpha.41 (the Odin binding; the C
+doors and `pack-ffi.nu`; the runner's keys, the access bridge, the text
+floor and Node; the docs), each claim probed. They filed RG140–RG144,
+built before the tag (a `<select>` option or menu bar row cut through an
+emoji failing the Node frame, `kui_draw_data` while a frame built losing
+the finished frame's fragment draws, the Odin drains freeing the strings
+they returned, Odin's popups, unchecked slices and acronym kinds, a cell
+grid's infinite line height), and RG145, open.
+
+**macOS**, the pre-tag pass. fmt and clippy are clean; `cargo test
+--workspace --features kui-core/conformance`: **1856 tests over 139
+suites**. The C round passes, and so do the **57 scenes**, the Odin
+binding's `gen --check`, `check`, `test` and `slots`, Node's tests under
+`KUI_CONFORMANCE_REQUIRED=1` (**215 of 215**), `npm run gen` with no
+diff, the headless round and the book. The windowed round with Node's:
+**124 windows**. The AX audit: **106/106**. RG127's dead keys, which the
+Windows and Linux round could not reach on a Mac: twelve sequences typed
+into the `edit` example through `CGEventPostToPid` and read back through
+AX, each as AppKit composes it (`⌥e e` is `é`, `⌥e space` `´`, `⌥e z`
+`´z`). The bench guard against the alpha.41 tag: **green**, the guarded
+rows −1.2 to −0.3%, RG126's warm cell grid −0.4%.
+
+**Windows 11 x64 (MSVC) and Linux x64 (WSL Ubuntu 24.04), rustc
+1.99.0**, on the tree with the pre-tag fixes and `pack-ffi.nu`'s. fmt
+and `cargo clippy --workspace --all-targets --features
+kui-core/conformance -- -D warnings` are clean on both. `cargo test
+--workspace --features kui-core/conformance`: **1857 tests over 140
+suites** on Windows (5 ignored), **1853 over 139** on Linux (4
+ignored), **0 failed**. `cargo audit --deny warnings` is clean over
+`Cargo.lock`'s 444 crates. `pack-ffi.nu` ran every leg but macOS's: native
+on both, and linux-x64, linux-arm64 and win32-x64 (cargo-xwin) in its
+container. A C host linked against each x64 pack alone, dynamically and
+statically, ran; the arm64 pack was read, not run. It found three things,
+fixed before the tag (RG145): a CRLF `kui.h` from a CRLF checkout, the
+closing table lost off a terminal, and a `docker` that could not be
+spawned stopping the script. Earlier the same day, before the pre-tag
+fixes, the Odin binding's four steps passed on both, and the regression
+and smoke round after RG127 ran the windowed smoke and walked the
+accessibility tree through UI Automation and AT-SPI.
+
 ## 0.1.0-alpha.41 (2026-10-07)
 
 **What breaks.**

package/encoder.js

@@ -402,7 +402,8 @@ export function createEncoder(P) {
     const np = fi++;
     let n = 0;
     // dir and size first: the decoder constructs spec/style from them.
-    if (p.dir !== undefined && p.dir !== 'column') {
+    // `!= null`: a null dir is absent, as every other null prop is.
+    if (p.dir != null && p.dir !== 'column') {
       // `table` is a column whose rows' cells line up (ADR 0033).
       const dir = p.dir === 'row' ? 1 : p.dir === 'table' ? 2 : undefined;
       if (dir === undefined) throw new Error(`bad dir ${JSON.stringify(p.dir)} (row | column | table)`);

package/index.d.ts

@@ -1890,6 +1890,8 @@ export type DoorCell = { is: string } | { as: string } | { no: string };
 export interface Door {
   rust: string;
   c: DoorCell;
+  /** The Odin binding's (packages/odin), pinned by its generator. */
+  odin: DoorCell;
   node: DoorCell;
   lua: DoorCell;
   doc: string;

package/index.js

@@ -52,8 +52,12 @@ export function withEffects(model, ...effects) {
 
 // A frame crosses the boundary one way: JS encodes the tree into one
 // Float64Array + string table and the addon lowers it zero-copy. One encoder
-// serves every context — its buffers are consumed synchronously.
+// serves every context — its buffers are consumed synchronously. Measuring
+// has one of its own: a `<devtoolsTab>`'s function child is called in the
+// middle of an encode, and a `measureText` there reset the frame's buffers
+// under it ("binary frame must start with the root op").
 const encoder = createEncoder(native.protocol());
+const measurer = createEncoder(native.protocol());
 
 // A prop name the schema does not know has no wire id, so it never crosses:
 // the encoder is the only side that can see it, and it reports what it
@@ -206,7 +210,7 @@ KuiWindow.prototype.setView = function setView(tree, window) {
 // it draws. A style name the schema does not know is reported like a
 // view's would be.
 function measureText(content, style, maxWidth) {
-  const { stream, strings, unknown, unknownTokens } = encoder.encodeText(content, style, this[TOKENS]);
+  const { stream, strings, unknown, unknownTokens } = measurer.encodeText(content, style, this[TOKENS]);
   const m = this.measureTextBinary(stream, strings, maxWidth);
   reportUnknown(this, unknown, unknownTokens);
   return m;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qxuken/kui",
-  "version": "0.1.0-alpha.41",
+  "version": "0.1.0-alpha.42",
   "description": "kui for Node: JSX views lowered into the kui IR, Elm-style messages as data",
   "license": "MIT",
   "repository": {