@markii/ansi 0.17.0-next.2 → 0.17.0-next.3

package/dist/ansi.d.ts

@@ -46,8 +46,7 @@ export declare const inverse: (text: string, level: ColorLevel) => string;
  * at a line boundary are closed with a reset before the `\n` and reopened
  * at the start of the next line.
  *
- * This is the SYSTEMATIC fix for a real Ink behavior discovered during
- * batch 10's post-phase-2 review: Ink's `<Text>` does not treat an embedded
+ * This is the systematic fix for an Ink behavior: Ink's `<Text>` does not treat an embedded
  * raw ANSI escape as transparent across an embedded newline the way a
  * terminal receiving the same bytes directly would — it resets SGR state
  * at every line boundary within one `<Text>` value and does not reopen it.

package/dist/ansi.js

@@ -72,8 +72,7 @@ const SGR_TOKEN = /\x1b\[([0-9;]*)m/g;
  * at a line boundary are closed with a reset before the `\n` and reopened
  * at the start of the next line.
  *
- * This is the SYSTEMATIC fix for a real Ink behavior discovered during
- * batch 10's post-phase-2 review: Ink's `<Text>` does not treat an embedded
+ * This is the systematic fix for an Ink behavior: Ink's `<Text>` does not treat an embedded
  * raw ANSI escape as transparent across an embedded newline the way a
  * terminal receiving the same bytes directly would — it resets SGR state
  * at every line boundary within one `<Text>` value and does not reopen it.

package/dist/components/card.d.ts

@@ -18,8 +18,7 @@ export declare function resolveCardBoxWidth(attributes: DirectiveAttributes, lay
  * children are built ONCE, directly at the correct inner width, and never
  * built wide and re-wrapped narrower afterward.
  *
- * That re-wrap-afterward shape was a real, shipped regression (caught
- * post-phase-2 review): re-wrapping an ALREADY-RENDERED child block with a
+ * That re-wrap-afterward shape was a real, shipped regression: re-wrapping an ALREADY-RENDERED child block with a
  * word-based wrapper corrupts anything in it that draws its own fixed-width
  * glyphs (a nested `card`/`callout`'s frame, a nested `row`'s columns) — the
  * word-wrapper has no notion that a run of box-drawing characters is not

package/dist/components/card.js

@@ -31,8 +31,7 @@ export function resolveCardBoxWidth(attributes, layout, outerWidth) {
  * children are built ONCE, directly at the correct inner width, and never
  * built wide and re-wrapped narrower afterward.
  *
- * That re-wrap-afterward shape was a real, shipped regression (caught
- * post-phase-2 review): re-wrapping an ALREADY-RENDERED child block with a
+ * That re-wrap-afterward shape was a real, shipped regression: re-wrapping an ALREADY-RENDERED child block with a
  * word-based wrapper corrupts anything in it that draws its own fixed-width
  * glyphs (a nested `card`/`callout`'s frame, a nested `row`'s columns) — the
  * word-wrapper has no notion that a run of box-drawing characters is not

package/dist/components/row.d.ts

@@ -1,7 +1,7 @@
 import type { AnsiComponent, DirectiveAttributes } from '../registry.js';
 declare const TEXT_ALIGNS: readonly ["left", "center", "right"];
 export type RowTextAlign = (typeof TEXT_ALIGNS)[number];
-/** Below this width, cells stack vertically instead of sitting side by side — a named constant per the batch brief, not a magic number. */
+/** Below this width, cells stack vertically instead of sitting side by side — a named constant, not a magic number. */
 export declare const ROW_COLUMN_THRESHOLD = 60;
 /** The blank columns between two cells of a grid row. Shared by both emitters (the Ink flex `Box` and the flattened string). */
 export declare const ROW_GUTTER = 1;

package/dist/components/row.js

@@ -6,7 +6,7 @@ const TEXT_ALIGNS = ['left', 'center', 'right'];
 function isTextAlign(value) {
     return TEXT_ALIGNS.includes(value);
 }
-/** Below this width, cells stack vertically instead of sitting side by side — a named constant per the batch brief, not a magic number. */
+/** Below this width, cells stack vertically instead of sitting side by side — a named constant, not a magic number. */
 export const ROW_COLUMN_THRESHOLD = 60;
 /** The blank columns between two cells of a grid row. Shared by both emitters (the Ink flex `Box` and the flattened string). */
 export const ROW_GUTTER = 1;

package/dist/ink-string.d.ts

@@ -3,8 +3,7 @@ import type { ReactElement } from 'react';
  * Mounts `element` with Ink at `columns` wide, captures the first (and only)
  * frame as a plain string, and unmounts. `ink` is imported dynamically
  * because `yoga-layout` (Ink's layout engine) resolves its WASM module via a
- * top-level `await` at ES-module-evaluation time (`SPIKE-10-findings.md`'s
- * "Item 3"): the first call to this function pays that one-time cost, and
+ * top-level `await` at ES-module-evaluation time: the first call to this function pays that one-time cost, and
  * every exported entry point that reaches here is therefore `async`. A
  * later call in the same process reuses the already-evaluated module graph,
  * the ordinary ESM module-cache guarantee.

package/dist/ink-string.js

@@ -20,8 +20,7 @@ function makeCollectingStream(columns) {
  * Mounts `element` with Ink at `columns` wide, captures the first (and only)
  * frame as a plain string, and unmounts. `ink` is imported dynamically
  * because `yoga-layout` (Ink's layout engine) resolves its WASM module via a
- * top-level `await` at ES-module-evaluation time (`SPIKE-10-findings.md`'s
- * "Item 3"): the first call to this function pays that one-time cost, and
+ * top-level `await` at ES-module-evaluation time: the first call to this function pays that one-time cost, and
  * every exported entry point that reaches here is therefore `async`. A
  * later call in the same process reuses the already-evaluated module graph,
  * the ordinary ESM module-cache guarantee.

package/dist/interactive.d.ts

@@ -53,7 +53,7 @@ export interface FocusableDescriptor {
 export interface InteractiveRootProps {
     /** Every focusable component the walk assigned a `focusId` to, in `focusId` order (empty for none). */
     focusables: readonly FocusableDescriptor[];
-    /** Called when the reader presses `q`. The engine owns no process state: it never calls `process.exit` itself (AGENTS.md, batch-10 brief). */
+    /** Called when the reader presses `q`. The engine owns no process state: it never calls `process.exit` itself. */
     onExit?: () => void;
     color: ColorLevel;
     theme: AnsiTheme;
@@ -73,7 +73,7 @@ export interface InteractiveRootProps {
 /**
  * The root of an interactive render: owns which `focusId` is focused, moves
  * it on up/down/j/k, calls `onExit` on `q`, and renders the one-line status
- * bar (batch 10.1) naming the focused block and the key legend. Rendered
+ * bar naming the focused block and the key legend. Rendered
  * only when the caller actually wants a live, keyboard-driven view:
  * `buildMarkElement` mounts this when `interactive` is true, but the
  * render-ONCE string path (`ink-string.ts`, `renderRootToString`) never

package/dist/interactive.js

@@ -78,7 +78,7 @@ export function useFocusAnchor(focusId) {
 /**
  * The root of an interactive render: owns which `focusId` is focused, moves
  * it on up/down/j/k, calls `onExit` on `q`, and renders the one-line status
- * bar (batch 10.1) naming the focused block and the key legend. Rendered
+ * bar naming the focused block and the key legend. Rendered
  * only when the caller actually wants a live, keyboard-driven view:
  * `buildMarkElement` mounts this when `interactive` is true, but the
  * render-ONCE string path (`ink-string.ts`, `renderRootToString`) never

package/dist/registry.d.ts

@@ -8,14 +8,11 @@ import type { ResolvedLayoutAttributes } from './layout.js';
 import type { ResolveImageSrc } from './image-resolve.js';
 import type { ResolveHref } from './href-resolve.js';
 /**
- * The registry contract for the terminal engine, batch-10 (the Ink
- * rewrite): a component is a React function component receiving
+ * The registry contract for the terminal engine: a component is a React function component receiving
  * `{ attributes, children, ctx }`, where `children` is ALREADY a built Ink
  * element tree (a `ReactNode`) rather than the lazy string-producing
  * `AnsiChildren` handle the pre-Ink engine used. Building children eagerly
- * is the batch-10 brief's own instruction (`AGENTS.md`'s architecture
- * section is silent on this; the brief is explicit: "Delete... the lazy-
- * children machinery"): Ink/Yoga lays a tree out AFTER it is built, exactly
+ * is how this engine works: Ink/Yoga lays a tree out AFTER it is built, exactly
  * like a browser reflows HTML, so a component no longer needs to ask for a
  * narrower re-render of its own body the way the old string engine did —
  * the one standard component that still needs a per-cell WIDTH NUMBER before
@@ -233,7 +230,7 @@ export declare function resolveDirectiveAlias(registry: AnsiRegistry, name: stri
  * top comment on why those three are the only ones that get a real Ink
  * element tree instead. `children` is still typed `ReactNode` on
  * `AnsiComponentProps` (the honest public contract: "an Ink element tree",
- * per the batch-10 brief, and a string IS a valid `ReactNode`), so a
+ * and a string IS a valid `ReactNode`), so a
  * component that needs its body AS TEXT (to measure it, frame it, indent
  * it, or check whether it is empty) reads it through this helper rather
  * than assuming the type; a non-string `children` degrades to `''` rather

package/dist/registry.js

@@ -117,7 +117,7 @@ export function resolveDirectiveAlias(registry, name, attributes) {
  * top comment on why those three are the only ones that get a real Ink
  * element tree instead. `children` is still typed `ReactNode` on
  * `AnsiComponentProps` (the honest public contract: "an Ink element tree",
- * per the batch-10 brief, and a string IS a valid `ReactNode`), so a
+ * and a string IS a valid `ReactNode`), so a
  * component that needs its body AS TEXT (to measure it, frame it, indent
  * it, or check whether it is empty) reads it through this helper rather
  * than assuming the type; a non-string `children` degrades to `''` rather

package/dist/render.d.ts

@@ -99,8 +99,7 @@ export interface RenderMarkOptions {
  * defaults to `defaultAnsiRegistry`.
  *
  * `async` since the first call in a process pays Ink/Yoga's one-time module-
- * evaluation cost (`ink-string.ts`'s doc comment; `SPIKE-10-findings.md`'s
- * "Item 3"). Never throws: parsing is tolerant, unknown names always render
+ * evaluation cost (`ink-string.ts`'s doc comment). Never throws: parsing is tolerant, unknown names always render
  * a fallback, and any unexpected internal error degrades to the "failed to
  * render document" line.
  *
@@ -125,7 +124,7 @@ export declare function renderMarkNodeToAnsi(node: MarkNode | MarkRoot, registry
  */
 export declare function renderMarkInlineToAnsi(text: string, registry?: AnsiRegistry, store?: AnsiValueStore, vault?: AnsiVaultStore, options?: RenderMarkOptions): Promise<string>;
 /**
- * The live-viewer entry point (phase 3 consumes this): builds the same Ink
+ * The live-viewer entry point: builds the same Ink
  * element tree `renderMarkToAnsi` would render to a string, but returns the
  * element itself so a host (the CLI's `markii view`) can mount it directly
  * with Ink's own `render()` instead of re-rendering a string on every

package/dist/render.js

@@ -26,12 +26,12 @@ import { glyphsFor } from './glyphs.js';
 import { InteractiveTabs } from './components/tabs.js';
 import { InteractiveDetails } from './components/details.js';
 /**
- * The hast walk for the terminal engine (batch 10: the Ink rewrite). Every
+ * The hast walk for the terminal engine (the Ink rewrite). Every
  * DECISION this walk makes is unchanged from the pre-Ink engine (alias
  * resolution, layout resolution, data binding, form mismatch, invalid-enum
  * notice, empty-inline notice, never-throw component containment, script-
  * fence markers, link and image handling) — see AGENTS.md's architecture
- * rules and the batch-10 brief. What changed is the OUTPUT shape: instead of
+ * rules. The OUTPUT is a tree of Ink elements: instead of
  * building one big plain string, the walk builds a tree of Ink elements
  * (`Box`/`Text`) and hands it to `ink-string.ts` (the render-once path) or
  * returns it directly (the new live-viewer export, `buildMarkElement`).
@@ -82,7 +82,7 @@ const ROW_NAME = 'row';
 const TABS_NAME = 'tabs';
 const DETAILS_NAME = 'details';
 /**
- * `card` and `figure` join this list (batch 11's Ink-frames phase): both are
+ * `card` and `figure` join this list: both are
  * containers whose body previously only ever reached STRING mode, so a
  * `tabs`/`details` nested inside one could never become focusable. `card`
  * draws its frame with an Ink `Box` border (`renderCardElement`); `figure`
@@ -877,7 +877,7 @@ function renderDirectiveString(element, width, indent, walk) {
     // own attributes (never from the body), so the walk resolves it here,
     // BEFORE building children, and builds children exactly ONCE at that
     // final width — never at the outer width followed by a re-wrap. A
-    // re-wrap-afterward shipped as a real regression (post-phase-2 review):
+    // re-wrap-afterward shipped as a regression:
     // it corrupts anything self-drawing nested inside (a card's frame, a
     // row's columns), since a word-based re-wrapper has no notion that a run
     // of box-drawing characters is not prose. See `resolveCardInnerWidth`'s
@@ -1012,13 +1012,11 @@ function renderAlignedBodyElement(nodes, width, indent, wctx, align) {
  * Renders one `row` cell at `cellWidth`. `text=left` (the default) keeps
  * the cell a real Ink element tree (`renderBlockElement`), so anything
  * focusable inside it stays focusable. `text=center`/`text=right` instead
- * falls back to a flattened, pre-justified STRING — batch 11's justification
+ * falls back to a flattened, pre-justified STRING — the justification
  * rule: exactly ONE implementation, `text-grid.ts`'s `padText`, never a
- * second Ink-`alignItems`-based mechanism. Before this batch, `row`'s
- * ELEMENT-mode grid silently ignored `text=` altogether (only the STRING-
- * mode fallback, reached when a `row` is nested inside a self-drawing
- * container, honored it); this closes that gap using the SAME helper the
- * STRING mode already uses, rather than inventing a second mechanism.
+ * second Ink-`alignItems`-based mechanism. The ELEMENT-mode grid and the STRING-mode fallback (reached when a `row`
+ * is nested inside a self-drawing container) both honor `text=` through
+ * that one helper.
  */
 function renderRowCellElement(node, cellWidth, indent, wctx, align) {
     if (align === 'left')
@@ -1129,7 +1127,7 @@ function selfLayoutAlignElement(element, boxWidth, layout, width) {
 }
 /**
  * `:::card{title="..." text=left|center|right} ... :::` as a real Ink
- * element (batch 11: card moves off `frameBlock`'s hand-drawn string frame
+ * element (card moves off `frameBlock`'s hand-drawn string frame
  * onto Ink's own `Box` border, so a `tabs`/`details` nested in its body can
  * become a real focusable — this function's `body` is built through
  * `renderBlocksElement`, ELEMENT mode, whenever that is possible).
@@ -1141,9 +1139,7 @@ function selfLayoutAlignElement(element, boxWidth, layout, width) {
  * `frameGlyphs`'s character set makes byte-identical to `frameBlock`'s own
  * untitled output (proven against the committed fixtures).
  *
- * `text=center`/`text=right` (batch 11's justification rule: exactly ONE
- * implementation, `text-grid.ts`'s `padText`, pre-justifying a STRING before
- * Ink ever sees it, never a second Ink-`alignItems`-based mechanism) falls
+ * `text=center`/`text=right` falls
  * back to building the body as one flattened, pre-justified string, exactly
  * like the pre-Ink engine did — an accepted, documented trade: a `tabs`/
  * `details` nested inside a CENTERED or RIGHT-aligned card body is not
@@ -1226,7 +1222,7 @@ function renderCalloutElement(element, attributes, width, indent, wctx, layout)
 }
 /**
  * `:::figure{src="..." alt="..."} caption markdown :::` as a real Ink
- * element (batch 11: `figure` never drew a hand-drawn frame — it is a plain
+ * element (`figure` never drew a hand-drawn frame — it is a plain
  * dim alt/src line followed by its caption body — but its body still only
  * ever reached STRING mode before this change, so a `tabs`/`details` in its
  * caption could never become focusable. `body` here is built through
@@ -1498,7 +1494,7 @@ function diagnosticsFor(options) {
 }
 /** The columns assumed when a caller supplies no `width` option. */
 const DEFAULT_WIDTH = 80;
-/** Builds the root Ink element for `root`, given every resolved render input. Exported for `buildMarkElement` (the live-viewer entry point, phase 3) as well as this module's own three string-producing entry points. */
+/** Builds the root Ink element for `root`, given every resolved render input. Exported for `buildMarkElement` (the live-viewer entry point) as well as this module's own three string-producing entry points. */
 function buildRootElement(root, registry, scope, color, theme, glyphs, interactive, resolveImageSrc, resolveHref, onDiagnostic, unavailable, width, renderCode) {
     const wctx = buildWalkContext(registry, scope, color, theme, glyphs, interactive, resolveImageSrc, resolveHref, onDiagnostic, unavailable, renderCode);
     const body = renderBlocksElement(root.children, width, '', wctx);
@@ -1516,8 +1512,7 @@ async function renderRootToString(root, registry, scope, color, theme, glyphs, i
  * defaults to `defaultAnsiRegistry`.
  *
  * `async` since the first call in a process pays Ink/Yoga's one-time module-
- * evaluation cost (`ink-string.ts`'s doc comment; `SPIKE-10-findings.md`'s
- * "Item 3"). Never throws: parsing is tolerant, unknown names always render
+ * evaluation cost (`ink-string.ts`'s doc comment). Never throws: parsing is tolerant, unknown names always render
  * a fallback, and any unexpected internal error degrades to the "failed to
  * render document" line.
  *
@@ -1584,7 +1579,7 @@ export async function renderMarkInlineToAnsi(text, registry = defaultAnsiRegistr
     return renderMarkToAnsi(text, registry, store, vault, options);
 }
 /**
- * The live-viewer entry point (phase 3 consumes this): builds the same Ink
+ * The live-viewer entry point: builds the same Ink
  * element tree `renderMarkToAnsi` would render to a string, but returns the
  * element itself so a host (the CLI's `markii view`) can mount it directly
  * with Ink's own `render()` instead of re-rendering a string on every

package/dist/text-grid.d.ts

@@ -3,9 +3,8 @@
  * handful of STANDARD COMPONENTS that draw their own fixed-width glyphs
  * (`card`, `callout`, `divider`, `chart`, `table`, and the plain-markdown
  * table grid in `render.tsx`). Everything else in this engine wraps prose
- * through Ink's own layout (`ink-string.ts`'s doc comment and AGENTS.md's
- * batch-10 brief: "Drop wrap/pad/columns/frame/rule: Ink's layout replaces
- * them").
+ * through Ink's own layout (`ink-string.ts`'s doc comment): Ink's layout replaces
+ * wrap, pad, columns, frame and rule.
  *
  * A self-drawing component cannot lean on Ink for this: the string it builds
  * (a box-drawing frame, a sparkline, a table grid) is a fixed block of
@@ -13,9 +12,8 @@
  * `<Text>` renders it verbatim rather than reflowing pre-drawn glyphs. This
  * module is therefore kept as a small, PRIVATE (not exported from
  * `src/index.ts`) implementation detail of those few components, replacing
- * the old public `measure.ts`/`box.ts` modules the batch-10 brief has this
- * engine delete. The width-measurement approximation is unchanged from the
- * old `measure.ts`: Latin/CJK/emoji/combining-mark ranges, not a full
+ * the old public `measure.ts`/`box.ts` modules. The width-measurement
+ * approximation covers Latin/CJK/emoji/combining-mark ranges, not a full
  * Unicode grapheme-segmentation table (see the doc comment below for the one
  * documented limitation).
  */

package/dist/text-grid.js

@@ -3,9 +3,8 @@
  * handful of STANDARD COMPONENTS that draw their own fixed-width glyphs
  * (`card`, `callout`, `divider`, `chart`, `table`, and the plain-markdown
  * table grid in `render.tsx`). Everything else in this engine wraps prose
- * through Ink's own layout (`ink-string.ts`'s doc comment and AGENTS.md's
- * batch-10 brief: "Drop wrap/pad/columns/frame/rule: Ink's layout replaces
- * them").
+ * through Ink's own layout (`ink-string.ts`'s doc comment): Ink's layout replaces
+ * wrap, pad, columns, frame and rule.
  *
  * A self-drawing component cannot lean on Ink for this: the string it builds
  * (a box-drawing frame, a sparkline, a table grid) is a fixed block of
@@ -13,9 +12,8 @@
  * `<Text>` renders it verbatim rather than reflowing pre-drawn glyphs. This
  * module is therefore kept as a small, PRIVATE (not exported from
  * `src/index.ts`) implementation detail of those few components, replacing
- * the old public `measure.ts`/`box.ts` modules the batch-10 brief has this
- * engine delete. The width-measurement approximation is unchanged from the
- * old `measure.ts`: Latin/CJK/emoji/combining-mark ranges, not a full
+ * the old public `measure.ts`/`box.ts` modules. The width-measurement
+ * approximation covers Latin/CJK/emoji/combining-mark ranges, not a full
  * Unicode grapheme-segmentation table (see the doc comment below for the one
  * documented limitation).
  */

package/dist/value-types.d.ts

@@ -1,7 +1,7 @@
 /**
  * `@markii/ansi`'s own structural view of `@markii/runtime`'s value-store
  * contract. This package's dependency list is deliberately minimal (exactly
- * `@markii/core` and `@markii/stdlib`; see AGENTS.md and the batch brief),
+ * `@markii/core` and `@markii/stdlib`; see AGENTS.md),
  * so it never imports `@markii/runtime` at runtime: declaring the shapes it
  * needs here, rather than importing them, keeps a terminal render usable in
  * a context that never pulled in the runtime package at all (a CLI that

package/dist/value-types.js

@@ -1,7 +1,7 @@
 /**
  * `@markii/ansi`'s own structural view of `@markii/runtime`'s value-store
  * contract. This package's dependency list is deliberately minimal (exactly
- * `@markii/core` and `@markii/stdlib`; see AGENTS.md and the batch brief),
+ * `@markii/core` and `@markii/stdlib`; see AGENTS.md),
  * so it never imports `@markii/runtime` at runtime: declaring the shapes it
  * needs here, rather than importing them, keeps a terminal render usable in
  * a context that never pulled in the runtime package at all (a CLI that

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@markii/ansi",
-  "version": "0.17.0-next.2",
+  "version": "0.17.0-next.3",
   "description": "The terminal renderer for Markii (.mk.md): a registry-driven hast-to-terminal engine built on Ink. Renders a note once as a string with optional color, for a pipe or a log, or as a live Ink tree a host can mount.",
   "keywords": [
     "markdown",
@@ -51,15 +51,15 @@
     "regenerate:fixtures": "npm run build:dist && node scripts/regenerate-ansi-fixtures.ts"
   },
   "dependencies": {
-    "@markii/core": "^0.17.0-next.2",
-    "@markii/pack": "^0.17.0-next.2",
-    "@markii/stdlib": "^0.17.0-next.2",
+    "@markii/core": "^0.17.0-next.3",
+    "@markii/pack": "^0.17.0-next.3",
+    "@markii/stdlib": "^0.17.0-next.3",
     "ink": "^7.1.1",
     "react": "^19.2.0"
   },
   "devDependencies": {
     "@types/hast": "^3.0.4",
-    "@markii/runtime": "^0.17.0-next.2",
+    "@markii/runtime": "^0.17.0-next.3",
     "@types/react": "^19.2.0"
   }
 }