Yunfei He
a6a0b458e5
* 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>
66 lines
4.1 KiB
Markdown
66 lines
4.1 KiB
Markdown
# 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.)_
|