ansimax 1.3.7 → 1.4.0

package/CHANGELOG.md

@@ -3,6 +3,118 @@
 All notable changes to **ansimax** are documented in this file.
 This project follows [Semantic Versioning](https://semver.org/).
 
+## [1.4.0] — Phase 4 closure: Markdown rendering
+
+**Minor release** introducing the long-planned `markdown` module — the
+final piece of Phase 4 (after `panels` v1.3.0 and `json` v1.3.0).
+
+Renders standard Markdown to ANSI-styled terminal output using the
+existing ansimax primitives (`color`, `gradient`, `ascii.box`,
+`components.table`, `hyperlink`). **Zero new runtime dependencies.**
+
+### Added — `markdown` module
+
+```js
+import { markdown } from 'ansimax';
+
+console.log(markdown.render(`
+# Welcome
+
+This is **bold** and *italic* with \`code\` and [a link](https://example.com).
+
+- Item 1
+- Item 2
+
+\`\`\`js
+const x = 42;
+\`\`\`
+
+> Quoted wisdom
+
+---
+
+| Name | Value |
+|---|---|
+| foo | 1 |
+| bar | 2 |
+`));
+```
+
+### Supported markdown
+
+| Markdown | Rendered using |
+|---|---|
+| `#` to `######` headings | `gradient` (h1) + `color.hex` (h2–h6) |
+| **Bold** (`**` or `__`) | `color.bold` |
+| *Italic* (`*` or `_`) | `color.italic` |
+| ~~Strikethrough~~ (`~~`) | `color.strikethrough` |
+| `Inline code` (``` ` ```) | dim + tinted background |
+| ```` ```code blocks``` ```` | `ascii.box` with language label as title |
+| `- item` / `* item` / `1.` lists | indented bullets |
+| `> blockquote` | `│` prefix + dim |
+| `--- / *** / ___` HRs | `ascii.divider` |
+| `[label](url)` | `hyperlink` (OSC 8) |
+| `\| a \| b \|` tables | `components.table` |
+
+### API
+
+```ts
+// Main entry — high-level render
+markdown.render(source: string, opts?: MarkdownOptions): string
+
+// Lower-level helpers (advanced use)
+markdown.parseBlocks(source: string): Block[]
+markdown.parseInline(text: string, opts?): string
+```
+
+### Options
+
+```ts
+interface MarkdownOptions {
+  width?: number;                     // default: terminal width or 80
+  theme?: 'dark' | 'light';           // default 'dark'
+  headingGradient?: string[];         // override h1 gradient colors
+  boxCodeBlocks?: boolean;            // default true; false = indented dim
+  inlineCodeBackground?: boolean;     // default true
+}
+```
+
+### Design notes
+
+- **Pure functions** — `parseBlocks` and `parseInline` are deterministic
+- **No regex backtracking** — all patterns are anchored, single-pass
+- **Code blocks protect contents** — `**bold**` inside `` ` `` stays literal
+- **Inline parser precedence**: code > links > strikethrough > bold > italic
+- **Graceful degradation** — malformed markdown renders as plain text
+  rather than throwing
+
+### Tests
+
+- `+18` tests for `parseBlocks` (headings, lists, code, tables, blockquotes, HRs, edge cases)
+- `+13` tests for `parseInline` (bold/italic/code/links/strikethrough, precedence, protection)
+- `+19` tests for `render` (full pipeline, integration, options, theming)
+- `+2` tests for namespace + `+2` for barrel re-exports
+
+Total: **+54 tests** in a new `markdown.test.ts` file.
+
+### Roadmap note
+
+Phase 4 of the project is now closed. Future v1.4.x patches will refine
+the markdown module:
+- v1.4.1+ — CommonMark spec strict mode (escapes, reference links, setext headings)
+- v1.4.2+ — Optional syntax highlighting for code blocks (basic JS/TS/JSON/Bash)
+- v1.4.3+ — Nested lists (currently flat)
+- v1.4.4+ — Custom themes / theme registry
+
+### Notes
+
+- **No breaking changes** — new module, all existing APIs unchanged
+- **Drop-in replacement** for `1.3.7`
+- Zero runtime dependencies maintained
+- All markdown features implemented in ~450 lines of source
+
+---
+
 ## [1.3.7] — Internal consolidation + new clamp helpers
 
 Maintenance release focused on code cleanup. Zero behavior changes —

package/README.es.md

@@ -7,7 +7,7 @@
 _Colores • Gradientes • Animaciones • ASCII Art • Pixel Art • Árboles • Componentes • Temas_
 
 [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg?style=flat-square)](LICENSE)
-[![npm](https://img.shields.io/badge/npm-v1.3.7-cb3837.svg?style=flat-square)](https://www.npmjs.com/package/ansimax)
+[![npm](https://img.shields.io/badge/npm-v1.4.0-cb3837.svg?style=flat-square)](https://www.npmjs.com/package/ansimax)
 [![TypeScript](https://img.shields.io/badge/TypeScript-strict-3178c6.svg?style=flat-square)](tsconfig.json)
 [![Coverage](https://img.shields.io/badge/coverage-98%25-brightgreen.svg?style=flat-square)](#testing)
 [![Tests](https://img.shields.io/badge/tests-2000%2B%20passing-brightgreen.svg?style=flat-square)](#testing)
@@ -478,7 +478,7 @@ console.log(components.table([
   ['loaders',    color.green('● listo'),  '100%'],
 ], { borderStyle: 'rounded' }));
 
-console.log(components.badge('VERSION', 'v1.3.7'));
+console.log(components.badge('VERSION', 'v1.4.0'));
 console.log(components.badge('BUILD',   'passing'));
 ```
 
@@ -1065,6 +1065,38 @@ ansimax/
 
 ## 📝 Changelog
 
+### v1.4.0 — Cierre de Fase 4: Renderizado Markdown 🎉
+
+**Release minor** completando la Fase 4 con el nuevo módulo `markdown`:
+
+- 📝 **`markdown.render(source, opts?)`** — pipeline completo markdown → terminal
+- 🧩 **`markdown.parseBlocks` + `markdown.parseInline`** — helpers de bajo nivel
+- 🎨 **Temas**: `'dark'` (default) y `'light'`
+- 📐 Renderiza headings (h1–h6), bold/italic/strikethrough/code, listas, tablas, blockquotes, HRs, links
+- 🔗 Links usan hyperlinks OSC 8 (clickables en terminales modernos)
+- 📦 Bloques de código renderizados en `ascii.box` con label de lenguaje
+- 🚀 **Cero dependencias nuevas** — reusa `color`, `gradient`, `ascii`, `components`, `hyperlink`
+- 🧪 **+54 tests** para parser + renderer
+
+```js
+import { markdown } from 'ansimax';
+
+console.log(markdown.render(`
+# Bienvenido
+
+Esto es **bold** con \`code\` y [un link](https://example.com).
+
+- Feature uno
+- Feature dos
+
+\`\`\`js
+const x = 42;
+\`\`\`
+`));
+```
+
+La Fase 4 está completa. v1.4.x refinará markdown (CommonMark estricto, syntax highlighting, listas anidadas).
+
 ### v1.3.7 — Consolidación interna + helpers clamp
 
 Release de mantenimiento enfocado en limpieza de código. Cero cambios de comportamiento:

package/README.md

@@ -7,7 +7,7 @@
 _Colors • Gradients • Animations • ASCII Art • Pixel Art • Trees • Components • Themes_
 
 [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg?style=flat-square)](LICENSE)
-[![npm](https://img.shields.io/badge/npm-v1.3.7-cb3837.svg?style=flat-square)](https://www.npmjs.com/package/ansimax)
+[![npm](https://img.shields.io/badge/npm-v1.4.0-cb3837.svg?style=flat-square)](https://www.npmjs.com/package/ansimax)
 [![TypeScript](https://img.shields.io/badge/TypeScript-strict-3178c6.svg?style=flat-square)](tsconfig.json)
 [![Coverage](https://img.shields.io/badge/coverage-98%25-brightgreen.svg?style=flat-square)](#testing)
 [![Tests](https://img.shields.io/badge/tests-2000%2B%20passing-brightgreen.svg?style=flat-square)](#testing)
@@ -478,7 +478,7 @@ console.log(components.table([
   ['loaders',    color.green('● ready'),  '100%'],
 ], { borderStyle: 'rounded' }));
 
-console.log(components.badge('VERSION', 'v1.3.7'));
+console.log(components.badge('VERSION', 'v1.4.0'));
 console.log(components.badge('BUILD',   'passing'));
 ```
 
@@ -1065,6 +1065,38 @@ ansimax/
 
 ## 📝 Changelog
 
+### v1.4.0 — Phase 4 closure: Markdown rendering 🎉
+
+**Minor release** completing Phase 4 with the new `markdown` module:
+
+- 📝 **`markdown.render(source, opts?)`** — full markdown → terminal pipeline
+- 🧩 **`markdown.parseBlocks` + `markdown.parseInline`** — low-level helpers
+- 🎨 **Themes**: `'dark'` (default) and `'light'`
+- 📐 Renders headings (h1–h6), bold/italic/strikethrough/code, lists, tables, blockquotes, HRs, links
+- 🔗 Links use OSC 8 hyperlinks (clickable in modern terminals)
+- 📦 Code blocks rendered in `ascii.box` with language label
+- 🚀 **Zero new dependencies** — reuses existing `color`, `gradient`, `ascii`, `components`, `hyperlink`
+- 🧪 **+54 tests** for parser + renderer
+
+```js
+import { markdown } from 'ansimax';
+
+console.log(markdown.render(`
+# Welcome
+
+This is **bold** with \`code\` and [a link](https://example.com).
+
+- Feature one
+- Feature two
+
+\`\`\`js
+const x = 42;
+\`\`\`
+`));
+```
+
+Phase 4 is now complete. v1.4.x will refine markdown (CommonMark strict, syntax highlighting, nested lists).
+
 ### v1.3.7 — Internal consolidation + clamp helpers
 
 Maintenance release focused on code cleanup. Zero behavior changes:

package/dist/index.d.mts

@@ -2887,6 +2887,126 @@ declare const json: {
     pretty: (value: unknown, opts?: PrettyOptions) => string;
 };
 
+/** Visual theme for rendered output. */
+type MarkdownTheme = 'dark' | 'light';
+interface MarkdownOptions {
+    /**
+     * Maximum width in columns. Long lines wrap. Default: terminal width
+     * or 80 if unavailable.
+     */
+    width?: number;
+    /**
+     * Color theme. `'dark'` (default) uses bright colors for dark backgrounds.
+     * `'light'` uses dimmer/contrast colors for light backgrounds.
+     */
+    theme?: MarkdownTheme;
+    /**
+     * Override the gradient used for top-level (`# H1`) headings. Receives
+     * a list of hex colors. Default uses the dracula palette.
+     */
+    headingGradient?: string[];
+    /**
+     * Render code blocks inside an ASCII box. Default `true`. If `false`,
+     * code blocks render as indented dim text.
+     */
+    boxCodeBlocks?: boolean;
+    /**
+     * Inline code background tint. Default `true`. If `false`, inline code
+     * shows only as dim text (cleaner in some terminals).
+     */
+    inlineCodeBackground?: boolean;
+}
+/** Block-level token after parsing the markdown into structural pieces. */
+type Block = {
+    type: 'heading';
+    level: number;
+    text: string;
+} | {
+    type: 'paragraph';
+    text: string;
+} | {
+    type: 'codeblock';
+    lang: string;
+    code: string;
+} | {
+    type: 'list';
+    ordered: boolean;
+    items: string[];
+} | {
+    type: 'blockquote';
+    text: string;
+} | {
+    type: 'table';
+    headers: string[];
+    rows: string[][];
+} | {
+    type: 'hr';
+} | {
+    type: 'blank';
+};
+/**
+ * Parse markdown source into a flat sequence of block tokens.
+ * Tokens contain raw inline text — inline parsing happens at render time.
+ *
+ * @since 1.4.0
+ */
+declare const parseBlocks: (source: string) => Block[];
+/**
+ * Apply inline markdown markup (bold/italic/code/links/etc.) to a string.
+ *
+ * @since 1.4.0
+ */
+declare const parseInline: (text: string, opts?: {
+    theme: MarkdownTheme;
+    inlineCodeBackground: boolean;
+}) => string;
+/**
+ * Render a markdown source string to a terminal-ready string with ANSI
+ * styling. Handles headings, paragraphs, code blocks, lists, blockquotes,
+ * tables, inline emphasis, links, and horizontal rules.
+ *
+ * @example
+ * ```ts
+ * import { markdown } from 'ansimax';
+ *
+ * const out = markdown.render(`
+ * # Welcome
+ *
+ * This is **bold** with \`inline code\` and [a link](https://example.com).
+ *
+ * - First item
+ * - Second item
+ *
+ * \`\`\`js
+ * const x = 42;
+ * \`\`\`
+ * `);
+ *
+ * console.log(out);
+ * ```
+ *
+ * @since 1.4.0
+ */
+declare const render: (source: string, opts?: MarkdownOptions) => string;
+/**
+ * Markdown → terminal renderer. Use `markdown.render(source, opts?)` to
+ * convert a markdown string to an ANSI-styled string ready for
+ * `console.log` or `process.stdout.write`.
+ *
+ * Lower-level helpers `parseBlocks` and `parseInline` are also exposed
+ * for advanced use cases (custom block handlers, partial rendering).
+ *
+ * @since 1.4.0
+ */
+declare const markdown: {
+    render: (source: string, opts?: MarkdownOptions) => string;
+    parseBlocks: (source: string) => Block[];
+    parseInline: (text: string, opts?: {
+        theme: MarkdownTheme;
+        inlineCodeBackground: boolean;
+    }) => string;
+};
+
 type EasingFunction = (t: number) => number;
 /**
  * Union of all built-in easing names in the comprehensive Robert Penner
@@ -3088,6 +3208,50 @@ declare const ansimax: {
         clearAnsiCache: () => void;
     };
     configure: (opts?: AnsimaxConfig, meta?: ConfigureOptions) => void;
+    panels: {
+        vsplit: (blocks: string[], opts?: VsplitOptions) => string;
+        hsplit: (blocks: string[], opts?: HsplitOptions) => string;
+        center: (block: string, opts: CenterOptions) => string;
+        frame: (block: string, opts?: FrameOptions) => string;
+        grid: (blocks: string[], opts: GridOptions) => string;
+    };
+    json: {
+        pretty: (value: unknown, opts?: PrettyOptions) => string;
+    };
+    markdown: {
+        render: (source: string, opts?: MarkdownOptions) => string;
+        parseBlocks: (source: string) => ({
+            type: "heading";
+            level: number;
+            text: string;
+        } | {
+            type: "paragraph";
+            text: string;
+        } | {
+            type: "codeblock";
+            lang: string;
+            code: string;
+        } | {
+            type: "list";
+            ordered: boolean;
+            items: string[];
+        } | {
+            type: "blockquote";
+            text: string;
+        } | {
+            type: "table";
+            headers: string[];
+            rows: string[][];
+        } | {
+            type: "hr";
+        } | {
+            type: "blank";
+        })[];
+        parseInline: (text: string, opts?: {
+            theme: MarkdownTheme;
+            inlineCodeBackground: boolean;
+        }) => string;
+    };
 };
 
-export { ASCII_RAMPS, type Alignment, type AnimateGradientController, type AnimateGradientOptions, type AnimationHooks, type AnimationSpeed, type AnsiCode, type AnsimaxConfig, type AsciiRamp, BEL, BG, type BadgeOptions, type BallOptions, type BannerOptions, type BoxOptions, type BoxStyle, type BreatheOptions, DEFAULTS as CONFIG_DEFAULTS, CSI, type Canvas, type CanvasRenderOptions, type CenterOptions, type ColorChain, type ColorFn, type ColorLevel, type ColorMode, type ColorSpace, type ColorSupport, type ColumnsOptions, type ConfigChangeListener, type ConfigKey, type ConfigKeyListener, type ConfigureOptions, type CountdownOptions, type CustomOptions, DEFAULT_TERM_COLS, DEFAULT_TERM_ROWS, type DebounceOptions, type DiffType, type Dimensions, type DividerOptions, type DotsOptions, ESC, type EasingFn, type EasingFunction, type EasingLibraryName, type EasingName, type EraseMode, FG, FRAME_MS, type FadeOptions, type FigletFont, type FigletOptions, type FontMap, type FontName, type FrameCallback, type FrameHandle, type FrameOptions, type FromImageOptions, type GlitchOptions, type Glyph, type GradientOptions, type GradientRectOptions, type GridOptions, type HSL, type HsplitOptions, type PrettyOptions as JsonPrettyOptions, type LineDiff, type LiveController, type LiveOptions, type LoadingBarOptions, type LogoOptions, MENU_CANCELLED, type MemoizeOptions, type MenuInput, type MenuOptions, type MenuOutput, type MenuResult, type MultiLoader, type MultiLoaderItem, OSC, type Oklab, type OnResizeOptions, type OutputBuffer, type ParallelOptions, type ParallelStep, type Pixel, type PixelGrid, type PlayController, type PlayOptions, type PresetName, type ProgressAnimateOptions, type ProgressBarOptions, type ProgressOptions, type PulseOptions, type RGB, type RGBA, type RegisterFontOptions, type RenderOptions$1 as RenderOptions, type ResizeListener, type ReusableGradient, type RevealOptions, SPINNERS, SPRITES, ST, STYLE, type SectionOptions, type SleepOptions, type SlideOptions, type SpinOptions, type SpinnerType, type StatusOptions, type StatusType, type StopFn, type StreamOptions, type TableBorderStyle, type TableOptions, type Task, type TaskResult, type TasksOptions, type Theme, type BannerOpts as ThemeBannerOpts, type ThemeChangeListener, type ThemeInstance, type ThemeStyleName, type TimelineEvent, type TimelineOptions, type TreeData, type TreeDimensions, type TreeNode, type RenderOptions as TreeRenderOptions, type TreeStyle, type TypeDeleteOptions, type TypewriterOptions, type VsplitOptions, type WalkVisitor, type WaveOptions, type WriteAsyncOptions, animate, animateGradient, ascii, bell, bg256, bgRgb, box, canAnimate, cancelTerminalFrame, center$1 as center, center as centerBlock, chain, charWidth, clamp, clampByte, clampInt, clampPercent, clearAnsiCache, clearColorCache, clearLine, clearRenderCache, clearThemeColorCache, color, colorLevel, presets as colorPresets, components, compose, configure, countNodes, createCanvas, createGradient, createOutputBuffer, createTheme, cursor, debounce, ansimax as default, diffLines, easings, escapeForRegex, escapeRegex, fg256, fgRgb, figletText, filterTree, findInTree, flipHorizontal, flipVertical, frame, frames, fromImage, getConfig, getConfigValue, getRenderCacheSize, getSpeedMultiplier, getTerminalHeight, getTerminalWidth, gradient, gradientColor, gradientRect, gradientStops, graphemes, grid, hasFont, hexToRgb, hideCursor, hslToRgb, hsplit, hyperlink, images, isFiniteNumber, isHexColor, isNoColor, json, pretty as jsonPretty, lerp, lerpColor, link, listFonts, listPresets, loader, mapTree, measureBlock, measureTree, memoize, mixColors, nextTick, oklabToRgb, onConfigChange, onConfigKeyChange, onResize, once, padBoth, padEnd, padStart, panels, parseFiglet, pauseListeners, presetNames, presets, quantizeColor, rainbow, registerFont, registerPreset, renderPixelArt, renderTree, renderTreeStream, repeatVisible, requestTerminalFrame, reset, resetColorSupportCache, resetConfig, resetCursorRefCount, resetFramesCursorCount, resetLoaderCursorCount, resetNoColor, resolveEasingByName, resumeListeners, reverseGradient, rgbTo256, rgbToHex, rgbToHsl, rgbToOklab, rotate90, safeInt, safeJson, screen, setConfigValue, setNoColor, setTitle, sgr, showCursor, sleep, sleepFrame, sliceAnsi, stripAnsi$2 as stripAnsi, stripAnsi$1 as stripAnsiCodes, stripAnsi as stripAnsiColors, subscribeConfig, supportsColor, supportsColorLevel, termSize, themes, throttle, tree, trees, truncateAnsi, visibleLen, vsplit, walkTree, withConfig, wordWrap, wrapAnsi, write, writeAsync, writeErr, writeln, writelnErr };
+export { ASCII_RAMPS, type Alignment, type AnimateGradientController, type AnimateGradientOptions, type AnimationHooks, type AnimationSpeed, type AnsiCode, type AnsimaxConfig, type AsciiRamp, BEL, BG, type BadgeOptions, type BallOptions, type BannerOptions, type BoxOptions, type BoxStyle, type BreatheOptions, DEFAULTS as CONFIG_DEFAULTS, CSI, type Canvas, type CanvasRenderOptions, type CenterOptions, type ColorChain, type ColorFn, type ColorLevel, type ColorMode, type ColorSpace, type ColorSupport, type ColumnsOptions, type ConfigChangeListener, type ConfigKey, type ConfigKeyListener, type ConfigureOptions, type CountdownOptions, type CustomOptions, DEFAULT_TERM_COLS, DEFAULT_TERM_ROWS, type DebounceOptions, type DiffType, type Dimensions, type DividerOptions, type DotsOptions, ESC, type EasingFn, type EasingFunction, type EasingLibraryName, type EasingName, type EraseMode, FG, FRAME_MS, type FadeOptions, type FigletFont, type FigletOptions, type FontMap, type FontName, type FrameCallback, type FrameHandle, type FrameOptions, type FromImageOptions, type GlitchOptions, type Glyph, type GradientOptions, type GradientRectOptions, type GridOptions, type HSL, type HsplitOptions, type PrettyOptions as JsonPrettyOptions, type LineDiff, type LiveController, type LiveOptions, type LoadingBarOptions, type LogoOptions, MENU_CANCELLED, type MarkdownOptions, type MarkdownTheme, type MemoizeOptions, type MenuInput, type MenuOptions, type MenuOutput, type MenuResult, type MultiLoader, type MultiLoaderItem, OSC, type Oklab, type OnResizeOptions, type OutputBuffer, type ParallelOptions, type ParallelStep, type Pixel, type PixelGrid, type PlayController, type PlayOptions, type PresetName, type ProgressAnimateOptions, type ProgressBarOptions, type ProgressOptions, type PulseOptions, type RGB, type RGBA, type RegisterFontOptions, type RenderOptions$1 as RenderOptions, type ResizeListener, type ReusableGradient, type RevealOptions, SPINNERS, SPRITES, ST, STYLE, type SectionOptions, type SleepOptions, type SlideOptions, type SpinOptions, type SpinnerType, type StatusOptions, type StatusType, type StopFn, type StreamOptions, type TableBorderStyle, type TableOptions, type Task, type TaskResult, type TasksOptions, type Theme, type BannerOpts as ThemeBannerOpts, type ThemeChangeListener, type ThemeInstance, type ThemeStyleName, type TimelineEvent, type TimelineOptions, type TreeData, type TreeDimensions, type TreeNode, type RenderOptions as TreeRenderOptions, type TreeStyle, type TypeDeleteOptions, type TypewriterOptions, type VsplitOptions, type WalkVisitor, type WaveOptions, type WriteAsyncOptions, animate, animateGradient, ascii, bell, bg256, bgRgb, box, canAnimate, cancelTerminalFrame, center$1 as center, center as centerBlock, chain, charWidth, clamp, clampByte, clampInt, clampPercent, clearAnsiCache, clearColorCache, clearLine, clearRenderCache, clearThemeColorCache, color, colorLevel, presets as colorPresets, components, compose, configure, countNodes, createCanvas, createGradient, createOutputBuffer, createTheme, cursor, debounce, ansimax as default, diffLines, easings, escapeForRegex, escapeRegex, fg256, fgRgb, figletText, filterTree, findInTree, flipHorizontal, flipVertical, frame, frames, fromImage, getConfig, getConfigValue, getRenderCacheSize, getSpeedMultiplier, getTerminalHeight, getTerminalWidth, gradient, gradientColor, gradientRect, gradientStops, graphemes, grid, hasFont, hexToRgb, hideCursor, hslToRgb, hsplit, hyperlink, images, isFiniteNumber, isHexColor, isNoColor, json, pretty as jsonPretty, lerp, lerpColor, link, listFonts, listPresets, loader, mapTree, markdown, measureBlock, measureTree, memoize, mixColors, nextTick, oklabToRgb, onConfigChange, onConfigKeyChange, onResize, once, padBoth, padEnd, padStart, panels, parseFiglet, parseBlocks as parseMarkdownBlocks, parseInline as parseMarkdownInline, pauseListeners, presetNames, presets, quantizeColor, rainbow, registerFont, registerPreset, render as renderMarkdown, renderPixelArt, renderTree, renderTreeStream, repeatVisible, requestTerminalFrame, reset, resetColorSupportCache, resetConfig, resetCursorRefCount, resetFramesCursorCount, resetLoaderCursorCount, resetNoColor, resolveEasingByName, resumeListeners, reverseGradient, rgbTo256, rgbToHex, rgbToHsl, rgbToOklab, rotate90, safeInt, safeJson, screen, setConfigValue, setNoColor, setTitle, sgr, showCursor, sleep, sleepFrame, sliceAnsi, stripAnsi$2 as stripAnsi, stripAnsi$1 as stripAnsiCodes, stripAnsi as stripAnsiColors, subscribeConfig, supportsColor, supportsColorLevel, termSize, themes, throttle, tree, trees, truncateAnsi, visibleLen, vsplit, walkTree, withConfig, wordWrap, wrapAnsi, write, writeAsync, writeErr, writeln, writelnErr };

package/dist/index.d.ts

@@ -2887,6 +2887,126 @@ declare const json: {
     pretty: (value: unknown, opts?: PrettyOptions) => string;
 };
 
+/** Visual theme for rendered output. */
+type MarkdownTheme = 'dark' | 'light';
+interface MarkdownOptions {
+    /**
+     * Maximum width in columns. Long lines wrap. Default: terminal width
+     * or 80 if unavailable.
+     */
+    width?: number;
+    /**
+     * Color theme. `'dark'` (default) uses bright colors for dark backgrounds.
+     * `'light'` uses dimmer/contrast colors for light backgrounds.
+     */
+    theme?: MarkdownTheme;
+    /**
+     * Override the gradient used for top-level (`# H1`) headings. Receives
+     * a list of hex colors. Default uses the dracula palette.
+     */
+    headingGradient?: string[];
+    /**
+     * Render code blocks inside an ASCII box. Default `true`. If `false`,
+     * code blocks render as indented dim text.
+     */
+    boxCodeBlocks?: boolean;
+    /**
+     * Inline code background tint. Default `true`. If `false`, inline code
+     * shows only as dim text (cleaner in some terminals).
+     */
+    inlineCodeBackground?: boolean;
+}
+/** Block-level token after parsing the markdown into structural pieces. */
+type Block = {
+    type: 'heading';
+    level: number;
+    text: string;
+} | {
+    type: 'paragraph';
+    text: string;
+} | {
+    type: 'codeblock';
+    lang: string;
+    code: string;
+} | {
+    type: 'list';
+    ordered: boolean;
+    items: string[];
+} | {
+    type: 'blockquote';
+    text: string;
+} | {
+    type: 'table';
+    headers: string[];
+    rows: string[][];
+} | {
+    type: 'hr';
+} | {
+    type: 'blank';
+};
+/**
+ * Parse markdown source into a flat sequence of block tokens.
+ * Tokens contain raw inline text — inline parsing happens at render time.
+ *
+ * @since 1.4.0
+ */
+declare const parseBlocks: (source: string) => Block[];
+/**
+ * Apply inline markdown markup (bold/italic/code/links/etc.) to a string.
+ *
+ * @since 1.4.0
+ */
+declare const parseInline: (text: string, opts?: {
+    theme: MarkdownTheme;
+    inlineCodeBackground: boolean;
+}) => string;
+/**
+ * Render a markdown source string to a terminal-ready string with ANSI
+ * styling. Handles headings, paragraphs, code blocks, lists, blockquotes,
+ * tables, inline emphasis, links, and horizontal rules.
+ *
+ * @example
+ * ```ts
+ * import { markdown } from 'ansimax';
+ *
+ * const out = markdown.render(`
+ * # Welcome
+ *
+ * This is **bold** with \`inline code\` and [a link](https://example.com).
+ *
+ * - First item
+ * - Second item
+ *
+ * \`\`\`js
+ * const x = 42;
+ * \`\`\`
+ * `);
+ *
+ * console.log(out);
+ * ```
+ *
+ * @since 1.4.0
+ */
+declare const render: (source: string, opts?: MarkdownOptions) => string;
+/**
+ * Markdown → terminal renderer. Use `markdown.render(source, opts?)` to
+ * convert a markdown string to an ANSI-styled string ready for
+ * `console.log` or `process.stdout.write`.
+ *
+ * Lower-level helpers `parseBlocks` and `parseInline` are also exposed
+ * for advanced use cases (custom block handlers, partial rendering).
+ *
+ * @since 1.4.0
+ */
+declare const markdown: {
+    render: (source: string, opts?: MarkdownOptions) => string;
+    parseBlocks: (source: string) => Block[];
+    parseInline: (text: string, opts?: {
+        theme: MarkdownTheme;
+        inlineCodeBackground: boolean;
+    }) => string;
+};
+
 type EasingFunction = (t: number) => number;
 /**
  * Union of all built-in easing names in the comprehensive Robert Penner
@@ -3088,6 +3208,50 @@ declare const ansimax: {
         clearAnsiCache: () => void;
     };
     configure: (opts?: AnsimaxConfig, meta?: ConfigureOptions) => void;
+    panels: {
+        vsplit: (blocks: string[], opts?: VsplitOptions) => string;
+        hsplit: (blocks: string[], opts?: HsplitOptions) => string;
+        center: (block: string, opts: CenterOptions) => string;
+        frame: (block: string, opts?: FrameOptions) => string;
+        grid: (blocks: string[], opts: GridOptions) => string;
+    };
+    json: {
+        pretty: (value: unknown, opts?: PrettyOptions) => string;
+    };
+    markdown: {
+        render: (source: string, opts?: MarkdownOptions) => string;
+        parseBlocks: (source: string) => ({
+            type: "heading";
+            level: number;
+            text: string;
+        } | {
+            type: "paragraph";
+            text: string;
+        } | {
+            type: "codeblock";
+            lang: string;
+            code: string;
+        } | {
+            type: "list";
+            ordered: boolean;
+            items: string[];
+        } | {
+            type: "blockquote";
+            text: string;
+        } | {
+            type: "table";
+            headers: string[];
+            rows: string[][];
+        } | {
+            type: "hr";
+        } | {
+            type: "blank";
+        })[];
+        parseInline: (text: string, opts?: {
+            theme: MarkdownTheme;
+            inlineCodeBackground: boolean;
+        }) => string;
+    };
 };
 
-export { ASCII_RAMPS, type Alignment, type AnimateGradientController, type AnimateGradientOptions, type AnimationHooks, type AnimationSpeed, type AnsiCode, type AnsimaxConfig, type AsciiRamp, BEL, BG, type BadgeOptions, type BallOptions, type BannerOptions, type BoxOptions, type BoxStyle, type BreatheOptions, DEFAULTS as CONFIG_DEFAULTS, CSI, type Canvas, type CanvasRenderOptions, type CenterOptions, type ColorChain, type ColorFn, type ColorLevel, type ColorMode, type ColorSpace, type ColorSupport, type ColumnsOptions, type ConfigChangeListener, type ConfigKey, type ConfigKeyListener, type ConfigureOptions, type CountdownOptions, type CustomOptions, DEFAULT_TERM_COLS, DEFAULT_TERM_ROWS, type DebounceOptions, type DiffType, type Dimensions, type DividerOptions, type DotsOptions, ESC, type EasingFn, type EasingFunction, type EasingLibraryName, type EasingName, type EraseMode, FG, FRAME_MS, type FadeOptions, type FigletFont, type FigletOptions, type FontMap, type FontName, type FrameCallback, type FrameHandle, type FrameOptions, type FromImageOptions, type GlitchOptions, type Glyph, type GradientOptions, type GradientRectOptions, type GridOptions, type HSL, type HsplitOptions, type PrettyOptions as JsonPrettyOptions, type LineDiff, type LiveController, type LiveOptions, type LoadingBarOptions, type LogoOptions, MENU_CANCELLED, type MemoizeOptions, type MenuInput, type MenuOptions, type MenuOutput, type MenuResult, type MultiLoader, type MultiLoaderItem, OSC, type Oklab, type OnResizeOptions, type OutputBuffer, type ParallelOptions, type ParallelStep, type Pixel, type PixelGrid, type PlayController, type PlayOptions, type PresetName, type ProgressAnimateOptions, type ProgressBarOptions, type ProgressOptions, type PulseOptions, type RGB, type RGBA, type RegisterFontOptions, type RenderOptions$1 as RenderOptions, type ResizeListener, type ReusableGradient, type RevealOptions, SPINNERS, SPRITES, ST, STYLE, type SectionOptions, type SleepOptions, type SlideOptions, type SpinOptions, type SpinnerType, type StatusOptions, type StatusType, type StopFn, type StreamOptions, type TableBorderStyle, type TableOptions, type Task, type TaskResult, type TasksOptions, type Theme, type BannerOpts as ThemeBannerOpts, type ThemeChangeListener, type ThemeInstance, type ThemeStyleName, type TimelineEvent, type TimelineOptions, type TreeData, type TreeDimensions, type TreeNode, type RenderOptions as TreeRenderOptions, type TreeStyle, type TypeDeleteOptions, type TypewriterOptions, type VsplitOptions, type WalkVisitor, type WaveOptions, type WriteAsyncOptions, animate, animateGradient, ascii, bell, bg256, bgRgb, box, canAnimate, cancelTerminalFrame, center$1 as center, center as centerBlock, chain, charWidth, clamp, clampByte, clampInt, clampPercent, clearAnsiCache, clearColorCache, clearLine, clearRenderCache, clearThemeColorCache, color, colorLevel, presets as colorPresets, components, compose, configure, countNodes, createCanvas, createGradient, createOutputBuffer, createTheme, cursor, debounce, ansimax as default, diffLines, easings, escapeForRegex, escapeRegex, fg256, fgRgb, figletText, filterTree, findInTree, flipHorizontal, flipVertical, frame, frames, fromImage, getConfig, getConfigValue, getRenderCacheSize, getSpeedMultiplier, getTerminalHeight, getTerminalWidth, gradient, gradientColor, gradientRect, gradientStops, graphemes, grid, hasFont, hexToRgb, hideCursor, hslToRgb, hsplit, hyperlink, images, isFiniteNumber, isHexColor, isNoColor, json, pretty as jsonPretty, lerp, lerpColor, link, listFonts, listPresets, loader, mapTree, measureBlock, measureTree, memoize, mixColors, nextTick, oklabToRgb, onConfigChange, onConfigKeyChange, onResize, once, padBoth, padEnd, padStart, panels, parseFiglet, pauseListeners, presetNames, presets, quantizeColor, rainbow, registerFont, registerPreset, renderPixelArt, renderTree, renderTreeStream, repeatVisible, requestTerminalFrame, reset, resetColorSupportCache, resetConfig, resetCursorRefCount, resetFramesCursorCount, resetLoaderCursorCount, resetNoColor, resolveEasingByName, resumeListeners, reverseGradient, rgbTo256, rgbToHex, rgbToHsl, rgbToOklab, rotate90, safeInt, safeJson, screen, setConfigValue, setNoColor, setTitle, sgr, showCursor, sleep, sleepFrame, sliceAnsi, stripAnsi$2 as stripAnsi, stripAnsi$1 as stripAnsiCodes, stripAnsi as stripAnsiColors, subscribeConfig, supportsColor, supportsColorLevel, termSize, themes, throttle, tree, trees, truncateAnsi, visibleLen, vsplit, walkTree, withConfig, wordWrap, wrapAnsi, write, writeAsync, writeErr, writeln, writelnErr };
+export { ASCII_RAMPS, type Alignment, type AnimateGradientController, type AnimateGradientOptions, type AnimationHooks, type AnimationSpeed, type AnsiCode, type AnsimaxConfig, type AsciiRamp, BEL, BG, type BadgeOptions, type BallOptions, type BannerOptions, type BoxOptions, type BoxStyle, type BreatheOptions, DEFAULTS as CONFIG_DEFAULTS, CSI, type Canvas, type CanvasRenderOptions, type CenterOptions, type ColorChain, type ColorFn, type ColorLevel, type ColorMode, type ColorSpace, type ColorSupport, type ColumnsOptions, type ConfigChangeListener, type ConfigKey, type ConfigKeyListener, type ConfigureOptions, type CountdownOptions, type CustomOptions, DEFAULT_TERM_COLS, DEFAULT_TERM_ROWS, type DebounceOptions, type DiffType, type Dimensions, type DividerOptions, type DotsOptions, ESC, type EasingFn, type EasingFunction, type EasingLibraryName, type EasingName, type EraseMode, FG, FRAME_MS, type FadeOptions, type FigletFont, type FigletOptions, type FontMap, type FontName, type FrameCallback, type FrameHandle, type FrameOptions, type FromImageOptions, type GlitchOptions, type Glyph, type GradientOptions, type GradientRectOptions, type GridOptions, type HSL, type HsplitOptions, type PrettyOptions as JsonPrettyOptions, type LineDiff, type LiveController, type LiveOptions, type LoadingBarOptions, type LogoOptions, MENU_CANCELLED, type MarkdownOptions, type MarkdownTheme, type MemoizeOptions, type MenuInput, type MenuOptions, type MenuOutput, type MenuResult, type MultiLoader, type MultiLoaderItem, OSC, type Oklab, type OnResizeOptions, type OutputBuffer, type ParallelOptions, type ParallelStep, type Pixel, type PixelGrid, type PlayController, type PlayOptions, type PresetName, type ProgressAnimateOptions, type ProgressBarOptions, type ProgressOptions, type PulseOptions, type RGB, type RGBA, type RegisterFontOptions, type RenderOptions$1 as RenderOptions, type ResizeListener, type ReusableGradient, type RevealOptions, SPINNERS, SPRITES, ST, STYLE, type SectionOptions, type SleepOptions, type SlideOptions, type SpinOptions, type SpinnerType, type StatusOptions, type StatusType, type StopFn, type StreamOptions, type TableBorderStyle, type TableOptions, type Task, type TaskResult, type TasksOptions, type Theme, type BannerOpts as ThemeBannerOpts, type ThemeChangeListener, type ThemeInstance, type ThemeStyleName, type TimelineEvent, type TimelineOptions, type TreeData, type TreeDimensions, type TreeNode, type RenderOptions as TreeRenderOptions, type TreeStyle, type TypeDeleteOptions, type TypewriterOptions, type VsplitOptions, type WalkVisitor, type WaveOptions, type WriteAsyncOptions, animate, animateGradient, ascii, bell, bg256, bgRgb, box, canAnimate, cancelTerminalFrame, center$1 as center, center as centerBlock, chain, charWidth, clamp, clampByte, clampInt, clampPercent, clearAnsiCache, clearColorCache, clearLine, clearRenderCache, clearThemeColorCache, color, colorLevel, presets as colorPresets, components, compose, configure, countNodes, createCanvas, createGradient, createOutputBuffer, createTheme, cursor, debounce, ansimax as default, diffLines, easings, escapeForRegex, escapeRegex, fg256, fgRgb, figletText, filterTree, findInTree, flipHorizontal, flipVertical, frame, frames, fromImage, getConfig, getConfigValue, getRenderCacheSize, getSpeedMultiplier, getTerminalHeight, getTerminalWidth, gradient, gradientColor, gradientRect, gradientStops, graphemes, grid, hasFont, hexToRgb, hideCursor, hslToRgb, hsplit, hyperlink, images, isFiniteNumber, isHexColor, isNoColor, json, pretty as jsonPretty, lerp, lerpColor, link, listFonts, listPresets, loader, mapTree, markdown, measureBlock, measureTree, memoize, mixColors, nextTick, oklabToRgb, onConfigChange, onConfigKeyChange, onResize, once, padBoth, padEnd, padStart, panels, parseFiglet, parseBlocks as parseMarkdownBlocks, parseInline as parseMarkdownInline, pauseListeners, presetNames, presets, quantizeColor, rainbow, registerFont, registerPreset, render as renderMarkdown, renderPixelArt, renderTree, renderTreeStream, repeatVisible, requestTerminalFrame, reset, resetColorSupportCache, resetConfig, resetCursorRefCount, resetFramesCursorCount, resetLoaderCursorCount, resetNoColor, resolveEasingByName, resumeListeners, reverseGradient, rgbTo256, rgbToHex, rgbToHsl, rgbToOklab, rotate90, safeInt, safeJson, screen, setConfigValue, setNoColor, setTitle, sgr, showCursor, sleep, sleepFrame, sliceAnsi, stripAnsi$2 as stripAnsi, stripAnsi$1 as stripAnsiCodes, stripAnsi as stripAnsiColors, subscribeConfig, supportsColor, supportsColorLevel, termSize, themes, throttle, tree, trees, truncateAnsi, visibleLen, vsplit, walkTree, withConfig, wordWrap, wrapAnsi, write, writeAsync, writeErr, writeln, writelnErr };