@markii/ansi 0.16.0 → 0.17.0-next.0

package/dist/text-grid.d.ts

@@ -19,6 +19,7 @@
  * Unicode grapheme-segmentation table (see the doc comment below for the one
  * documented limitation).
  */
+import type { FrameEdges, GlyphSet } from './glyphs.js';
 /** Removes every SGR and OSC 8 escape sequence this engine can itself produce, so `measureWidth` counts only what a terminal actually draws. */
 export declare function stripEscapes(text: string): string;
 /**
@@ -37,18 +38,53 @@ export interface FrameOptions {
     style: 'solid' | 'dashed';
     title?: string;
     width: number;
+    /** The render's glyph set (`./glyphs.ts`), so a frame follows the box style. */
+    glyphs: GlyphSet;
 }
+/**
+ * The edge glyphs for a frame of `style`. Exposed so a caller that draws
+ * its OWN edges (`render.tsx`'s Ink-`Box`-bordered `card`) can match
+ * `frameBlock`'s glyphs exactly without duplicating them.
+ */
+export declare function frameGlyphs(style: 'solid' | 'dashed', glyphs: GlyphSet): FrameEdges;
+/**
+ * Just the top edge of a self-drawing frame, with an optional title woven
+ * in. Factored out of `frameBlock` for `render.tsx`'s `card`: an Ink `Box`
+ * border draws a plain edge perfectly well on its own (left, right, and an
+ * untitled top/bottom), but has no primitive for weaving text into a
+ * border line, so a titled card still builds this one line by hand and
+ * disables Ink's own top border for it.
+ */
+export declare function frameTopLine(options: FrameOptions): string;
 /** Draws a box around `block`, one glyph set for `'solid'`, another for `'dashed'`, with an optional title woven into the top edge. */
 export declare function frameBlock(block: string, options: FrameOptions): string;
-/** A full-width horizontal rule, `char` (default `─`) repeated to `width` columns. */
-export declare function ruleLine(width: number, char?: string): string;
-/** Prefixes every line of `block` (split on `\n`) with `prefix`, e.g. a blockquote's `│ `. */
+/** The `left`/`right`/`top`/`bottom`/`topLeft`/`topRight`/`bottomLeft`/`bottomRight` glyph set Ink's `Box` `borderStyle` prop takes, matching `frameBlock`'s own character set exactly for `style`. Corners are always the shared set, exactly like `frameBlock`'s (a dashed frame still has solid corners). */
+export declare function inkBorderStyle(style: 'solid' | 'dashed', glyphs: GlyphSet): {
+    topLeft: string;
+    top: string;
+    topRight: string;
+    right: string;
+    bottomRight: string;
+    bottom: string;
+    bottomLeft: string;
+    left: string;
+};
+/** The three-value per-line alignment every self-drawing component's `text=` attribute and every generic `align=` layout preset ultimately reduces to — the ONE spelling both `padText` (a pre-built string) and a caller pre-justifying a line before handing it to Ink share. */
+export declare const TEXT_ALIGNS: readonly ["left", "center", "right"];
+export type TextAlign = (typeof TEXT_ALIGNS)[number];
+export declare function isTextAlign(value: string): value is TextAlign;
+/** `text` cut to at most `width` terminal columns, with no ellipsis (so no glyph outside the engine's own table). Plain text only: an escape sequence would be measured and cut like prose. */
+export declare function cutToWidth(text: string, width: number): string;
+/** A full-width horizontal rule, `char` repeated to `width` columns. */
+export declare function ruleLine(width: number, char: string): string;
+/** Prefixes every line of `block` (split on `\n`) with `prefix`, e.g. a blockquote's bar. */
 export declare function indentBlock(block: string, prefix: string): string;
 /**
  * Places `blocks` side by side, each padded (left-aligned) to its entry in
- * `widths`, joined by `gutter` spaces, top-aligned. Used only by the plain
- * GFM markdown table (`render.tsx`'s `renderGfmTable`) and
- * `table-grid.ts`'s own row-drawing; `row`'s OWN columns are placed by a
- * real Ink flex `Box` instead (`components/row.tsx`), not by this helper.
+ * `widths`, joined by `gutter` spaces, top-aligned. The string emitter of
+ * `row` (`render.tsx`'s `renderRowString`, reached when a `row` sits inside
+ * a body drawn as a string) places its cells with this. The Ink element
+ * emitter (`renderRowElement`) uses a flex `Box` with the same cell widths
+ * and gutter, both read from `components/row.ts`'s `resolveRowLayout`.
  */
 export declare function columnsBlock(blocks: readonly string[], widths: readonly number[], gutter: number): string;

package/dist/text-grid.js

@@ -197,32 +197,82 @@ export function padText(text, width, align) {
     }
     return text + ' '.repeat(total);
 }
-/** Draws a box around `block`, one glyph set for `'solid'`, another for `'dashed'`, with an optional title woven into the top edge. */
-export function frameBlock(block, options) {
-    const { style: kind, title, width } = options;
-    const horizontal = kind === 'dashed' ? '╌' : '─';
-    const vertical = kind === 'dashed' ? '┆' : '│';
+/**
+ * The edge glyphs for a frame of `style`. Exposed so a caller that draws
+ * its OWN edges (`render.tsx`'s Ink-`Box`-bordered `card`) can match
+ * `frameBlock`'s glyphs exactly without duplicating them.
+ */
+export function frameGlyphs(style, glyphs) {
+    return style === 'dashed' ? glyphs.dashed : glyphs.solid;
+}
+/**
+ * Just the top edge of a self-drawing frame, with an optional title woven
+ * in. Factored out of `frameBlock` for `render.tsx`'s `card`: an Ink `Box`
+ * border draws a plain edge perfectly well on its own (left, right, and an
+ * untitled top/bottom), but has no primitive for weaving text into a
+ * border line, so a titled card still builds this one line by hand and
+ * disables Ink's own top border for it.
+ */
+export function frameTopLine(options) {
+    const { style: kind, title, width, glyphs } = options;
+    const { horizontal } = frameGlyphs(kind, glyphs);
     const innerWidth = Math.max(1, width - 2);
-    let top;
     if (title) {
         const label = ` ${title} `;
         const remaining = Math.max(0, innerWidth - measureWidth(label) - 1);
-        top = `┌${horizontal}${label}${horizontal.repeat(remaining)}┐`;
-    }
-    else {
-        top = `┌${horizontal.repeat(innerWidth)}┐`;
+        return `${glyphs.topLeft}${horizontal}${label}${horizontal.repeat(remaining)}${glyphs.topRight}`;
     }
-    const bottom = `└${horizontal.repeat(innerWidth)}┘`;
+    return `${glyphs.topLeft}${horizontal.repeat(innerWidth)}${glyphs.topRight}`;
+}
+/** Draws a box around `block`, one glyph set for `'solid'`, another for `'dashed'`, with an optional title woven into the top edge. */
+export function frameBlock(block, options) {
+    const { style: kind, width, glyphs } = options;
+    const { horizontal, vertical } = frameGlyphs(kind, glyphs);
+    const innerWidth = Math.max(1, width - 2);
+    const top = frameTopLine(options);
+    const bottom = `${glyphs.bottomLeft}${horizontal.repeat(innerWidth)}${glyphs.bottomRight}`;
     const lines = block
         .split('\n')
         .map((line) => `${vertical}${padText(line, innerWidth, 'left')}${vertical}`);
     return [top, ...lines, bottom].join('\n');
 }
-/** A full-width horizontal rule, `char` (default `─`) repeated to `width` columns. */
-export function ruleLine(width, char = '─') {
+/** The `left`/`right`/`top`/`bottom`/`topLeft`/`topRight`/`bottomLeft`/`bottomRight` glyph set Ink's `Box` `borderStyle` prop takes, matching `frameBlock`'s own character set exactly for `style`. Corners are always the shared set, exactly like `frameBlock`'s (a dashed frame still has solid corners). */
+export function inkBorderStyle(style, glyphs) {
+    const { horizontal, vertical } = frameGlyphs(style, glyphs);
+    return {
+        topLeft: glyphs.topLeft,
+        top: horizontal,
+        topRight: glyphs.topRight,
+        right: vertical,
+        bottomRight: glyphs.bottomRight,
+        bottom: horizontal,
+        bottomLeft: glyphs.bottomLeft,
+        left: vertical,
+    };
+}
+/** The three-value per-line alignment every self-drawing component's `text=` attribute and every generic `align=` layout preset ultimately reduces to — the ONE spelling both `padText` (a pre-built string) and a caller pre-justifying a line before handing it to Ink share. */
+export const TEXT_ALIGNS = ['left', 'center', 'right'];
+export function isTextAlign(value) {
+    return TEXT_ALIGNS.includes(value);
+}
+/** `text` cut to at most `width` terminal columns, with no ellipsis (so no glyph outside the engine's own table). Plain text only: an escape sequence would be measured and cut like prose. */
+export function cutToWidth(text, width) {
+    let out = '';
+    let used = 0;
+    for (const char of text) {
+        const next = measureWidth(char);
+        if (used + next > width)
+            break;
+        out += char;
+        used += next;
+    }
+    return out;
+}
+/** A full-width horizontal rule, `char` repeated to `width` columns. */
+export function ruleLine(width, char) {
     return char.repeat(Math.max(0, width));
 }
-/** Prefixes every line of `block` (split on `\n`) with `prefix`, e.g. a blockquote's `│ `. */
+/** Prefixes every line of `block` (split on `\n`) with `prefix`, e.g. a blockquote's bar. */
 export function indentBlock(block, prefix) {
     return block
         .split('\n')
@@ -231,10 +281,11 @@ export function indentBlock(block, prefix) {
 }
 /**
  * Places `blocks` side by side, each padded (left-aligned) to its entry in
- * `widths`, joined by `gutter` spaces, top-aligned. Used only by the plain
- * GFM markdown table (`render.tsx`'s `renderGfmTable`) and
- * `table-grid.ts`'s own row-drawing; `row`'s OWN columns are placed by a
- * real Ink flex `Box` instead (`components/row.tsx`), not by this helper.
+ * `widths`, joined by `gutter` spaces, top-aligned. The string emitter of
+ * `row` (`render.tsx`'s `renderRowString`, reached when a `row` sits inside
+ * a body drawn as a string) places its cells with this. The Ink element
+ * emitter (`renderRowElement`) uses a flex `Box` with the same cell widths
+ * and gutter, both read from `components/row.ts`'s `resolveRowLayout`.
  */
 export function columnsBlock(blocks, widths, gutter) {
     const gap = ' '.repeat(Math.max(0, gutter));

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@markii/ansi",
-  "version": "0.16.0",
-  "description": "A framework-free terminal renderer for Markii (.mk.md): a registry-driven hast-to-ANSI-text engine. Zero React; for a terminal, a pipe, or any host that wants a plain string with optional color.",
+  "version": "0.17.0-next.0",
+  "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",
     "markii",
@@ -51,14 +51,15 @@
     "regenerate:fixtures": "npm run build:dist && node scripts/regenerate-ansi-fixtures.ts"
   },
   "dependencies": {
-    "@markii/core": "^0.16.0",
-    "@markii/stdlib": "^0.16.0",
+    "@markii/core": "^0.17.0-next.0",
+    "@markii/pack": "^0.17.0-next.0",
+    "@markii/stdlib": "^0.17.0-next.0",
     "ink": "^7.1.1",
     "react": "^19.2.0"
   },
   "devDependencies": {
     "@types/hast": "^3.0.4",
-    "@markii/runtime": "^0.16.0",
+    "@markii/runtime": "^0.17.0-next.0",
     "@types/react": "^19.2.0"
   }
 }