test(runtime): pin absolute-child position to the padding box; fix wording

Addresses PR review: the containing block for an absolutely-positioned child
is the **padding box** (inside the borders), not the "border-box". Verified by
running yoga (an abs child at top:0/left:0 insets by the border only, never by
padding — confirmed across border/padding combos) and the real Ink/vue-tui
renderers (X lands at the inner-border edge, byte-identical in both).

- Tighten the regression test: exact-frame assertions instead of `toContain`,
  including a border+padding case that distinguishes the padding box from the
  content box — the assertion that would have caught the original wording slip
  (presence-only assertions could not).
- Correct "containing block (border-box)" -> "padding box (inside the borders)"
  in paint.ts, layout-guards.ts, and ink-divergences.md. (The unrelated
  "border-box-like" *sizing* notes are correct and left as-is.)

No runtime behavior change; the code already used yoga's computed position.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
Yunfei He
2026-06-09 11:32:19 +08:00
parent 54017cef0d
commit 1bd91dbbb9
4 changed files with 42 additions and 15 deletions
@@ -5,13 +5,18 @@ import { Box, Text } from "@vue-tui/runtime";
// A Box whose inner content area collapses to zero must still paint its
// position:"absolute" children — an absolutely-positioned child is placed
// against the containing block (border-box), not the (nonexistent) content
// against its containing block, the **padding box** (the area inside the
// borders; padding itself does NOT inset it), not the (nonexistent) content
// rect, so the zero-content guard must not suppress it. Ink v7.0.4 paints
// these (verified by running real Ink: a w=2 h=2 single-border box with an
// absolute child renders "┌┐#\n└X"); vue-tui previously suppressed ALL
// children, including absolute ones, rendering "┌┐#\n└┘".
// these (verified by running real Ink); vue-tui previously suppressed ALL
// children. Flow children stay suppressed (the blessed degenerate-box
// divergence).
//
// Assertions use exact frames (not `toContain`) so they pin WHERE the child
// lands — the padding-box edge — distinguishing it from the border box and
// the content box.
test("absolute child paints when border eats the whole content area (w=2 h=2)", async () => {
test("absolute child paints at the padding-box edge when content area is zero (w=2 h=2)", async () => {
const { lastFrame } = await render(
defineComponent(() => () => (
<Box>
@@ -25,7 +30,27 @@ test("absolute child paints when border eats the whole content area (w=2 h=2)",
)),
{ columns: 100 },
);
expect(lastFrame()).toContain("X");
// X lands at the inner-border (padding-box) corner — it replaces the `┘`.
expect(lastFrame()).toBe("┌┐#\n└X");
});
test("absolute child positions against the padding box, not the content box", async () => {
// Discriminator: with border=1 AND padding=1, the padding-box edge is at
// row 1 / col 1 (inside the border, before padding). A content-box containing
// block would instead put X at row 2 / col 2. Verified byte-identical in real
// Ink v7.0.4. This is the assertion that would have caught a "border-box" vs
// "padding-box" mistake.
const { lastFrame } = await render(
defineComponent(() => () => (
<Box width={7} height={5} borderStyle="single" padding={1}>
<Box position="absolute" top={0} left={0}>
<Text>X</Text>
</Box>
</Box>
)),
{ columns: 100 },
);
expect(lastFrame()).toBe("┌─────┐\n│X │\n│ │\n│ │\n└─────┘");
});
test("flow (non-absolute) child stays suppressed when the content area is zero", async () => {
@@ -42,5 +67,5 @@ test("flow (non-absolute) child stays suppressed when the content area is zero",
)),
{ columns: 100 },
);
expect(lastFrame()).not.toContain("Y");
expect(lastFrame()).toBe("┌┐#\n└┘");
});