Files

T

Yunfei He a6a0b458e5 chore(parity): record sweep-3 — 7 new gaps (G25-G31, all LOW severity) (#53 )

* chore(parity): record sweep-3 — 7 new gaps (G25-G31, all LOW severity)

Third re-audit of main (all 22 prior fixes merged) vs Ink 40b3a75. Trend:
sweep-1 found 14 (incl med), sweep-2 found 8 (incl 1 HIGH), sweep-3 found 7 —
ALL low severity. The high/medium-impact divergences are fixed; what remains
is a diminishing long tail of niche edge cases:
- G25 truncate-wrap multi-line edge; G26 kitty key-release input (reverses the
  sweep-1 refutation); G27 raw-mode release input-detach timing; G28 useStdin
  public-surface narrowing; G29 cursor-position-during-render; G30 SR nested
  Transform-in-Transform inner fn (refines G23); G31 useAnimation interval
  reactivity.
G07 + G24 candidates still pending the maintainer's decision.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* docs(parity): promote G07 + G24 candidates to allowlist (maintainer: keep)

G07 (kitty Ctrl+C exits): gated on internal_exitOnCtrlC (default true) — the
exitOnCtrlC option is intentionally honored under kitty protocol too, not just
\x03. G24 (multiple <Static>): vue-tui is strictly more capable. Both kept.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
EOF

---------

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>

2026-05-30 10:14:46 +08:00

4.1 KiB

Raw Blame History

Ink Parity — Reference Pin & Intentional-Divergence Allowlist

The audit in ink-parity-loop diffs vue-tui against the Ink source pinned below. Anything listed under "Intentional divergences" is deliberate and is NOT a gap — the audit skips it. Confirmed gaps and sweep history live in parity-ledger.

Target Ink reference

field	value
package	`ink` (vadimdemedes/ink)
version	v7.0.4
tag	`v7.0.4`
pinned commit SHA	`40b3a7578811fd616341ca4e31cc7748aeeff12f`
clone	`git clone --depth 1 --branch v7.0.4 https://github.com/vadimdemedes/ink.git /tmp/ink-40b3a75`
verify	`git -C /tmp/ink-40b3a75 rev-parse HEAD` must equal the pinned commit SHA above

Note: git ls-remote …/ink refs/tags/v7.0.4 returns c4f638cf…, the annotated tag object SHA — not the commit. The commit the tag points to is 40b3a75… (what we pin and what rev-parse HEAD resolves to after checkout). Pin the commit, not the tag object.

Re-pin deliberately when bumping the target Ink version: update the row above, note the bump in the ledger sweep history, and re-run a full audit against the new SHA.

Intentional divergences (allowlist — skip these)

These are differences the audit must treat as by design. Format: area — what Ink does — what vue-tui does — why.

Entry API — Ink exposes render(); vue-tui exposes createApp(). Renamed to match Vue's createApp mental model. Deliberate.
Text measurement exports — Ink does not export its measure-text module; vue-tui exports measureText / measureTextNatural from the public index. Deliberate public surface.
App composable — Ink's useApp() returns the full AppContext (exit + waitUntilRenderFlush + stdout/stdin/…); vue-tui exposes useExit() returning only the exit fn. Intentional minimal surface. (waitUntilRenderFlush is not exposed as a composable.)
Accessibility props — vue-tui adds AriaRole / AriaState props with no Ink equivalent. Additive, deliberate.
Named type/prop re-exports — Ink re-exports BoxProps, TextProps, StaticProps, TransformProps, NewlineProps, WindowSize, CursorPosition, DOMElement, RenderOptions, Instance, App/Stdin/Stdout/StderrProps. vue-tui intentionally does not re-export these names (uses TuiApp / MountOptions and its own type surface instead).
React concurrent mode — Suspense / useTransition have no Vue equivalent. N/A, not a gap.
Ctrl+C exits under kitty protocol too (G07) — vue-tui's useInput exits on input==='c' && key.ctrl gated on internal_exitOnCtrlC (which defaults to true, render.ts:443). So the exitOnCtrlC option is honored under BOTH legacy (\x03) and kitty (\x1b[99;5u) protocols. Ink wires exitOnCtrlC only to the \x03 path, so kitty Ctrl+C doesn't exit in Ink. Maintainer decision (2026-05-30): KEEP — Ctrl+C reliably exiting under all protocols is the intended exitOnCtrlC behavior; opt out via exitOnCtrlC: false.
Multiple <Static> regions supported (G24) — vue-tui's findStatics(root) renders EVERY <Static> in the tree; Ink keeps a single staticNode. vue-tui is strictly more capable here. Maintainer decision (2026-05-30): KEEP.

Candidate intentional divergences (needs human review)

(The loop appends here when it finds a difference it suspects is intentional but that is not yet on the allowlist. A human promotes entries up into the allowlist — the loop never does.)

(none currently — G07 and G24 were reviewed and promoted to the allowlist above on 2026-05-30.)

4.1 KiB Raw Blame History

Ink Parity — Reference Pin & Intentional-Divergence Allowlist

Target Ink reference

Intentional divergences (allowlist — skip these)

Candidate intentional divergences (needs human review)

4.1 KiB

Raw Blame History