ansimax 1.3.6 → 1.4.0

package/dist/index.d.ts

@@ -168,6 +168,42 @@ declare const lerp: (a: number, b: number, t: number) => number;
  * @since 1.3.5
  */
 declare const clampByte: (v: number) => number;
+/**
+ * Clamp + coerce a number to the 0–100 percentage range. Returns `0` for
+ * non-finite input. Consolidates duplicate `clampPercent` definitions
+ * previously living in `components/index.ts` and `loaders/index.ts`.
+ *
+ * @example
+ * ```ts
+ * clampPercent(50)     // → 50
+ * clampPercent(150)    // → 100
+ * clampPercent(-5)     // → 0
+ * clampPercent(NaN)    // → 0
+ * clampPercent('abc')  // → 0
+ * ```
+ *
+ * @since 1.3.7
+ */
+declare const clampPercent: (p: unknown) => number;
+/**
+ * Coerce any value to an integer clamped between `[min, max]`. Returns
+ * `fallback` (which is also clamped) when input is non-finite.
+ *
+ * More flexible than `safeInt` for the common pattern
+ * `Math.max(min, Math.min(max, Math.floor(n)))` that appears 30+ times
+ * across the codebase.
+ *
+ * @example
+ * ```ts
+ * clampInt(50, 0, 100)             // → 50
+ * clampInt(150, 0, 100)            // → 100
+ * clampInt(NaN, 0, 100, 25)        // → 25 (fallback)
+ * clampInt('abc', 0, 100, 25)      // → 25 (fallback)
+ * ```
+ *
+ * @since 1.3.7
+ */
+declare const clampInt: (value: unknown, min: number, max: number, fallback?: number) => number;
 /** Returns true when a string is a valid 3- or 6-digit hex color. */
 declare const isHexColor: (hex: string) => boolean;
 /**
@@ -2851,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
@@ -3052,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, 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 };