asciify-engine 4.0.0 → 4.1.0

package/dist/types-CYKIEtDC.d.cts

@@ -1,586 +0,0 @@
-type ColorMode = 'grayscale' | 'fullcolor' | 'matrix' | 'accent';
-type RenderMode = 'ascii' | 'dots';
-type AnimationStyle = 'none' | 'caustics' | 'current' | 'reform';
-type ArtStyle = 'classic' | 'particles' | 'letters' | 'claudeCode' | 'art' | 'terminal' | 'box' | 'lines' | 'braille' | 'katakana' | 'circles' | 'shadows' | 'geometric' | 'pipes' | 'waves' | 'shards' | 'smoke' | 'ascii' | 'interface' | 'prompt' | 'data' | 'humanist' | 'mesh';
-type HoverEffect = 'spotlight' | 'magnify' | 'repel' | 'glow' | 'colorShift' | 'attract' | 'shatter' | 'trail' | 'glitchText';
-type HoverShape = 'circle' | 'box';
-type HoverPreset = 'none' | 'subtle' | 'flashlight' | 'magnifier' | 'forceField' | 'neon' | 'fire' | 'ice' | 'gravity' | 'shatter' | 'ghost' | 'glitchReveal';
-type SourceCropUnit = 'percent' | 'pixel';
-type SourceCropAnchor = 'center' | 'top' | 'bottom' | 'left' | 'right' | 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
-interface SourceCrop {
-    /** Legacy crop origin on the source media. Percent values use 0–1. Default: centered when cropped */
-    x?: number;
-    /** Legacy crop origin on the source media. Percent values use 0–1. Default: centered when cropped */
-    y?: number;
-    /** Legacy crop width on the source media. Percent values use 0–1. Default: mirrors `height` to preserve proportions */
-    width?: number;
-    /** Legacy crop height on the source media. Percent values use 0–1. Default: mirrors `width` to preserve proportions */
-    height?: number;
-    /** CSS-like crop inset from the top edge. Percent values use 0–1. */
-    top?: number;
-    /** CSS-like crop inset from the right edge. Percent values use 0–1. */
-    right?: number;
-    /** CSS-like crop inset from the bottom edge. Percent values use 0–1. */
-    bottom?: number;
-    /** CSS-like crop inset from the left edge. Percent values use 0–1. */
-    left?: number;
-    /**
-     * Keep the source aspect ratio when deriving a crop from a single `width` or
-     * `height`. CSS-like side insets (`top`, `right`, `bottom`, `left`) already
-     * define an exact source view box, and `asciifyVideo` sizes from that crop
-     * aspect so the output does not stretch. Default: `true`.
-     */
-    preserveAspect?: boolean;
-    /** Bias auto-centered crops toward an edge or corner. Default: `'center'` */
-    anchor?: SourceCropAnchor;
-    /** Interpret values as normalized percentages or source pixels. Default: `'percent'` */
-    unit?: SourceCropUnit;
-}
-/**
- * Named colour palette presets — pass as `colorMode` for themed rendering.
- * Applied as a post-process colour remap over the standard grayscale output.
- */
-type PaletteTheme = 'dracula' | 'monokai' | 'nord' | 'catppuccin' | 'solarized' | 'gruvbox';
-declare const PALETTE_THEMES: Record<PaletteTheme, {
-    name: string;
-    accent: string;
-    bg: string;
-    fg: string;
-}>;
-type SourceType = 'image' | 'video' | 'gif' | null;
-interface AsciiOptions {
-    /** Character cell width in pixels. Smaller = more detail, more cells. Default: `7` */
-    fontSize: number;
-    /** Extra horizontal spacing between characters (pixels). Default: `1` */
-    charSpacing: number;
-    /**
-     * Brightness adjustment applied before luminance mapping.
-     * Range −1 (black) → 0 (unchanged) → 1 (white). Default: `0`
-     */
-    brightness: number;
-    /**
-     * Contrast boost applied before luminance mapping.
-     * `0` = unchanged, positive values increase contrast, negative decrease it.
-     * Default: `0`
-     */
-    contrast: number;
-    /**
-     * Character density ramp — ordered from lightest to darkest.
-     * Use `CHARSETS` for pre-built ramps or supply your own string.
-     * Default: `' .:-=+*#%@'`
-     */
-    charset: string;
-    /**
-     * Colour output mode.
-     * - `'grayscale'` — white-on-black monochrome
-     * - `'fullcolor'` — samples pixel colours from the source
-     * - `'matrix'` — green phosphor terminal look
-     * - `'accent'` — single accent colour with intensity-driven brightness
-     * Default: `'grayscale'`
-     */
-    colorMode: ColorMode;
-    /**
-     * The accent colour used when `colorMode` is `'accent'` or `'matrix'`.
-     * Any CSS colour string. Default: `'#d4ff00'`
-     */
-    /**
-     * Hex color string used when `colorMode` is `'accent'`.
-     * Set to `'auto'` to let the engine pick contrasting ink automatically:
-     * dark ink (`#0d0d0d`) in light mode, light ink (`#faf9f7`) in dark mode.
-     */
-    accentColor: string;
-    /**
-     * Invert luminance mapping (light pixels → dense chars). Default: `false`
-     *
-     * Set to `'auto'` to let the engine detect the OS color scheme:
-     * - Light mode → inverts (bright pixel = dark char = visible on white background)
-     * - Dark mode  → normal  (bright pixel = bright char = visible on dark background)
-     */
-    invert: boolean | 'auto';
-    /**
-     * Render mode.
-     * - `'ascii'` — characters drawn as text
-     * - `'dots'` — each cell rendered as a filled circle (particle look)
-     * Default: `'ascii'`
-     */
-    renderMode: RenderMode;
-    /**
-     * Per-character animation driven over time.
-     * Applies wave, glitch, rain-drop, spiral, and other effects to the rendered text.
-     * Default: `'none'`
-     */
-    animationStyle: AnimationStyle;
-    /** Speed multiplier for `animationStyle` effects. Default: `1` */
-    animationSpeed: number;
-    /**
-     * Size of each dot relative to the cell when `renderMode === 'dots'`.
-     * `1` fills the whole cell, `0.5` draws half-size circles. Default: `0.8`
-     */
-    dotSizeRatio: number;
-    /**
-     * Ordered Bayer (4×4) dither strength applied to the luminance map.
-     * `0` = no dithering, `1` = full dithering. Default: `0`
-     */
-    ditherStrength: number;
-    /**
-     * Assumed aspect ratio (width ÷ height) of a single output character.
-     * Controls how many rows vs columns are generated — must match your rendering
-     * environment to preserve the source image's proportions.
-     * - `0.55` — browser monospace at `line-height: 1.09` (default)
-     * - `0.52` — browser monospace at `line-height: 1.15`
-     * - `0.5`  — most terminal emulators
-     * Default: `0.55`
-     */
-    charAspect: number;
-    /**
-     * Auto-stretch the luminance range before charset mapping.
-     * When `true`, the darkest pixel in the frame maps to the first charset character
-     * and the brightest to the last, maximising perceived detail and contrast.
-     * Particularly useful for images with low inherent contrast or muted tones.
-     * Default: `false`
-     */
-    normalize: boolean;
-    /**
-     * Overall intensity of the hover / cursor interaction effect.
-     * `0` disables the effect. Default: `0`
-     */
-    hoverStrength: number;
-    /**
-     * Radius of the hover interaction zone as a fraction of the canvas size.
-     * `0.1` = 10% of canvas width. Default: `0.2`
-     */
-    hoverRadius: number;
-    /**
-     * Which cursor interaction style to apply when `hoverStrength > 0`.
-     * See `HoverPreset` or `HOVER_PRESETS` for ready-made configurations.
-     * Default: `'spotlight'`
-     */
-    hoverEffect: HoverEffect;
-    /**
-     * Tint colour used by hover effects such as spotlight, glow, and colorShift.
-     * Any CSS colour string. Default: `'#ffffff'`
-     */
-    hoverColor: string;
-    /**
-     * Shape of the hover interaction zone.
-     * - `'circle'` — radial falloff (default)
-     * - `'box'` — rectangular zone, text fills a block around the cursor
-     * Default: `'circle'`
-     */
-    hoverShape: HoverShape;
-    /**
-     * Text string revealed by the `'glitchText'` hover effect.
-     * Characters around the cursor scramble and resolve into this text.
-     * Supports `\n` for multi-line reveals.
-     *
-     * Pass an **array** of strings to cycle through different words based on
-     * the cursor's grid region — the engine picks one via a spatial hash so
-     * each area of the canvas shows a different word.
-     *
-     * Default: `'ASCIIFY'`
-     *
-     * @example
-     * // Single word:
-     * options: { hoverEffect: 'glitchText', hoverText: 'HELLO' }
-     *
-     * // Word pool — different text at different cursor positions:
-     * options: { hoverEffect: 'glitchText', hoverText: ['DEPLOY', 'SCALE', 'SHIP', 'BUILD'] }
-     */
-    hoverText: string | string[];
-    /**
-     * Art style preset applied at render time.
-     * Shorthand for a specific combination of `charset`, `renderMode`, and `colorMode`.
-     * See `ART_STYLE_PRESETS` for the full list. Default: `'classic'`
-     */
-    artStyle: ArtStyle;
-    /**
-     * Custom repeating text used when `artStyle` is `'letters'` or when you set
-     * a custom charset. Leave empty to use the selected `charset`. Default: `''`
-     */
-    customText: string;
-    /**
-     * Chroma-key colour to remove from the source (green screen / blue screen).
-     * Pixels whose RGB distance from this colour is within `chromaKeyTolerance`
-     * are keyed out: their character becomes a space and alpha is set to 0,
-     * letting the canvas background show through.
-     *
-     * - `true` — **smart green screen**: heuristic detection (`g > r*1.4 && g > b*1.4`)
-     *   catches every shade of green screen (lime, broadcast, chroma green) with no
-     *   config. Works on virtually all studio/streaming footage.
-     * - `'blue-screen'` — **smart blue screen**: same heuristic for blue.
-     * - `{ r, g, b }` or CSS colour string — custom key colour + `chromaKeyTolerance`
-     * - `null` / `false` — disabled (default)
-     *
-     * @example
-     * // Standard green screen — zero config:
-     * options: { chromaKey: true }
-     *
-     * // Blue screen — zero config:
-     * options: { chromaKey: 'blue-screen' }
-     *
-     * // Custom CSS colour:
-     * options: { chromaKey: '#00b140', chromaKeyTolerance: 70 }
-     */
-    chromaKey: {
-        r: number;
-        g: number;
-        b: number;
-    } | string | boolean | null;
-    /**
-     * Euclidean RGB tolerance radius for chroma-key detection.
-     * `0` = exact match only, `441` ≈ key out everything.
-     * Higher values remove more pixels. Default: `60`
-     */
-    chromaKeyTolerance: number;
-    /**
-     * Extra normalized padding kept around the detected chroma-key foreground when
-     * `asciifyVideo` auto-trims keyed video content inside `sourceCrop`.
-     * `0` hugs the visible foreground. `0.01` keeps 1% safety padding.
-     * Default: `0.002`
-     */
-    chromaKeyTrimPadding: number;
-    /**
-     * Minimum source-pixel luminance for chroma-key foreground auto-trim.
-     * Raise this when faint edge noise is counted as content and prevents a
-     * keyed subject from filling a preserved-ratio layout. Range `0–255`.
-     * Default: `0`
-     */
-    chromaKeyTrimLuminanceThreshold: number;
-    /**
-     * How keyed video foreground trimming is applied when `chromaKey` and
-     * `sourceCrop` are enabled.
-     *
-     * - `'range'` samples the video/scroll range once and keeps a stable union
-     *   crop. Best default for consistent framing.
-     * - `'frame'` remeasures each rendered frame and expands the crop to the
-     *   render aspect. Best for scroll-scrubbed hero footage where foreground
-     *   position changes and pure contain leaves empty edges.
-     * - `'off'` disables automatic keyed foreground trimming.
-     *
-     * Default: `'range'`
-     */
-    chromaKeyTrimMode: 'range' | 'frame' | 'off';
-    /**
-     * Optional source crop applied before ASCII sampling.
-     *
-     * Use this when the media has empty edges or a subject that should be framed
-     * tighter without changing the destination canvas size.
-     *
-     * @example
-     * // Remove 15% from the top and 15% from the bottom, preserving proportions:
-     * options: { sourceCrop: { top: 0.15, bottom: 0.15 } }
-     *
-     * @example
-     * // Keep 70% of the source, preserve proportions, and center it:
-     * options: { sourceCrop: { height: 0.7 } }
-     *
-     * @example
-     * // Use an exact source window when manual framing should override proportions:
-     * options: { sourceCrop: { x: 0.05, y: 0.08, width: 0.9, height: 0.9, preserveAspect: false } }
-     */
-    sourceCrop?: SourceCrop | null;
-    /**
-     * Array of charset strings to cycle through over time.
-     * The engine picks `charsetFrames[Math.floor(time * charsetFps) % length]` on each
-     * render tick, re-mapping characters from stored cell luminance.
-     * Pairs beautifully with `animationStyle` and `asciiBackground`.
-     *
-     * Use `CHARSET_SEQUENCES` for curated combinations or build your own:
-     * @example
-     * options: { charsetFrames: CHARSET_SEQUENCES.cosmic }
-     * options: { charsetFrames: [CHARSETS.standard, CHARSETS.blocks, CHARSETS.circles] }
-     */
-    charsetFrames?: string[];
-    /** Cycle rate for `charsetFrames` in frames-per-second. Default: `2` */
-    charsetFps?: number;
-}
-interface AsciiCell {
-    char: string;
-    r: number;
-    g: number;
-    b: number;
-    a: number;
-    /** Stored dithered luminance (0–255). Present when the frame was generated by the engine. Used for dynamic charset re-selection at render time via `charsetFrames`. */
-    lum?: number;
-}
-type AsciiFrame = AsciiCell[][];
-interface AsciiResult {
-    frames: AsciiFrame[];
-    cols: number;
-    rows: number;
-    fps: number;
-}
-declare const CHARSETS: {
-    readonly standard: " .:-=+*#%@";
-    readonly blocks: " ░▒▓█";
-    readonly minimal: " .:+";
-    readonly dense: " .'`^\",:;Il!i><~+_-?][}{1)(|/tfjrxnuvczXYUJCLQ0OZmwqpdbkhao*#MW&8%B@$";
-    readonly binary: "01";
-    readonly dots: " ⠁⠃⠇⡇⣇⣧⣷⣿";
-    readonly letters: "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz";
-    readonly claudeCode: " ╔╗╚╝║═╠╣╦╩╬░▒▓█│─┌┐└┘├┤┬┴┼";
-    readonly box: " ▪◾◼■█";
-    readonly lines: " ˗‐–—―━";
-    readonly braille: " ⠁⠂⠃⠄⠅⠆⠇⠈⠉⠊⠋⠌⠍⠎⠏⠐⠑⠒⠓⠔⠕⠖⠗⠘⠙⠚⠛⠜⠝⠞⠟⠠⠡⠢⠣⠤⠥⠦⠧⠨⠩⠪⠫⠬⠭⠮⠯⠰⠱⠲⠳⠴⠵⠶⠷⠸⠹⠺⠻⠼⠽⠾⠿⡀⡁⡂⡃⡄⡅⡆⡇⣀⣁⣂⣃⣄⣅⣆⣇⣈⣉⣊⣋⣌⣍⣎⣏⣐⣑⣒⣓⣔⣕⣖⣗⣘⣙⣚⣛⣜⣝⣞⣟⣠⣡⣢⣣⣤⣥⣦⣧⣨⣩⣪⣫⣬⣭⣮⣯⣰⣱⣲⣳⣴⣵⣶⣷⣸⣹⣺⣻⣼⣽⣾⣿";
-    readonly katakana: " ｦｧｨｩｪｫｬｭｮｯｱｲｳｴｵｶｷｸｹｺｻｼｽｾｿﾀﾁﾂﾃﾄﾅﾆﾇﾈﾉﾊﾋﾌﾍﾎﾏﾐﾑﾒﾓﾔﾕﾖﾗﾘﾙﾚﾛﾜﾝ";
-    readonly circles: " .·:∘○◦°•∙";
-    readonly shadows: " ·∘◦○◎⊙●◉";
-    readonly geometric: " ·△▷◇◈◆▣■█";
-    readonly pipes: " ╶─┐└├┤┬┴┼╬▒▓█";
-    readonly waves: " ˜∼≈〰≋∿∾∭∫";
-    readonly shards: " ╱╲╳◤◥◣◢△▲◆◼█";
-    readonly smoke: " ·˙⁚⁖∶∷⋮⋰⋱∴∵";
-    /** All printable ASCII characters ordered from airy punctuation to dense symbols. */
-    readonly ascii: " .'`^\",:;~-_+<>i!lI?/\\|()[]{}1tfjrxnuvczXYUJCLQ0OZmwqpdbkhao*#MW&8%B@$";
-    /** Clean product UI glyphs inspired by command palettes, panes, controls, and focus rings. */
-    readonly interface: " ·•-–—+=:;<>[]{}()⌘⌥⇧⌃↵↗↘◇◆◈□■";
-    /** Prompt, shell, and assistant transcript glyphs for modern AI/dev surfaces. */
-    readonly prompt: " .:;>_`/\\|{}[]()=+*#@$";
-    /** Analytical/data-viz glyphs: sparse dots into nodes, diamonds, and dense blocks. */
-    readonly data: " ·∙•◦○●◇◆◈▱▰▣█";
-    /** Warm editorial/math symbols for quieter Claude-like and research-oriented pages. */
-    readonly humanist: " ·˙,:;∴∵∷∶⁚⋮⋯∼≈≋∞";
-    /** Dense network/mesh characters for agent maps, model graphs, and infrastructure visuals. */
-    readonly mesh: " ·╶╴╷╵─│┌┐└┘├┤┬┴┼╬░▒▓█";
-};
-/**
- * Curated charset sequences for use with `charsetFrames`.
- * Each sequence morphs between 2–3 complementary charsets over time,
- * creating a living texture effect.
- *
- * @example
- * asciiBackground('#hero', { charsetFrames: CHARSET_SEQUENCES.cosmic })
- */
-declare const CHARSET_SEQUENCES: {
-    /** Sparse marks → circles → orbs — soft tonal texture */
-    readonly cosmic: string[];
-    /** Katakana → braille dots → binary — hacker rain */
-    readonly rain: string[];
-    /** Box pipes → Claude glyphs → classic — terminal morph */
-    readonly terminal: string[];
-    /** Shards → blocks → squares — shattering crystal */
-    readonly crystal: string[];
-    /** Wave glyphs → smoke dots → circles — fluid / organic */
-    readonly fluid: string[];
-    /** Dense classic → art → blocks — maximum detail pulse */
-    readonly pulse: string[];
-    /** Braille → shadows → smoke — ethereal / dream-like */
-    readonly dream: string[];
-    /** Geometric shapes → shards → blocks — angular texture */
-    readonly angular: string[];
-    /** Interface controls → prompts → data nodes — clean assistant/product motion */
-    readonly assistant: string[];
-    /** Mesh → data → ASCII — alive network signal with readable texture */
-    readonly signal: string[];
-    /** Humanist symbols → waves → smoke — soft research/editorial motion */
-    readonly editorial: string[];
-};
-type CharsetSequenceKey = keyof typeof CHARSET_SEQUENCES;
-type CharsetKey = keyof typeof CHARSETS;
-/**
- * Art Style presets — each one sets render mode, charset, color mode, etc.
- */
-declare const ART_STYLE_PRESETS: Record<ArtStyle, Partial<AsciiOptions>>;
-/**
- * Higher-level living presets for output that should feel active immediately.
- * They intentionally compose existing primitives so renderers and integrations
- * can consume them as a normal `Partial<AsciiOptions>`.
- */
-declare const LIVING_STYLE_PRESETS: {
-    readonly agentField: {
-        readonly charsetFrames: string[];
-        readonly charsetFps: 1.6;
-        readonly animationStyle: "caustics";
-        readonly animationSpeed: 0.75;
-        readonly ditherStrength: 0.12;
-        readonly hoverEffect: "glow";
-        readonly hoverStrength: 0.42;
-        readonly hoverRadius: 0.18;
-        readonly hoverColor: "#f4f1ea";
-        readonly normalize: true;
-        readonly fontSize?: number | undefined;
-        readonly charSpacing?: number | undefined;
-        readonly brightness?: number | undefined;
-        readonly contrast?: number | undefined;
-        readonly charset?: string | undefined;
-        readonly colorMode?: ColorMode | undefined;
-        readonly accentColor?: string | undefined;
-        readonly invert?: boolean | "auto" | undefined;
-        readonly renderMode?: RenderMode | undefined;
-        readonly dotSizeRatio?: number | undefined;
-        readonly charAspect?: number | undefined;
-        readonly hoverShape?: HoverShape | undefined;
-        readonly hoverText?: string | string[] | undefined;
-        readonly artStyle?: ArtStyle | undefined;
-        readonly customText?: string | undefined;
-        readonly chromaKey?: string | boolean | {
-            r: number;
-            g: number;
-            b: number;
-        } | null | undefined;
-        readonly chromaKeyTolerance?: number | undefined;
-        readonly chromaKeyTrimPadding?: number | undefined;
-        readonly chromaKeyTrimLuminanceThreshold?: number | undefined;
-        readonly chromaKeyTrimMode?: "range" | "frame" | "off" | undefined;
-        readonly sourceCrop?: SourceCrop | null;
-    };
-    readonly liquidSignal: {
-        readonly charsetFrames: string[];
-        readonly charsetFps: 2.4;
-        readonly animationStyle: "current";
-        readonly animationSpeed: 0.65;
-        readonly ditherStrength: 0.45;
-        readonly hoverEffect: "repel";
-        readonly hoverStrength: 0.55;
-        readonly hoverRadius: 0.22;
-        readonly hoverColor: "#8fd3ff";
-        readonly normalize: true;
-        readonly fontSize?: number | undefined;
-        readonly charSpacing?: number | undefined;
-        readonly brightness?: number | undefined;
-        readonly contrast?: number | undefined;
-        readonly charset?: string | undefined;
-        readonly colorMode?: ColorMode | undefined;
-        readonly accentColor?: string | undefined;
-        readonly invert?: boolean | "auto" | undefined;
-        readonly renderMode?: RenderMode | undefined;
-        readonly dotSizeRatio?: number | undefined;
-        readonly charAspect?: number | undefined;
-        readonly hoverShape?: HoverShape | undefined;
-        readonly hoverText?: string | string[] | undefined;
-        readonly artStyle?: ArtStyle | undefined;
-        readonly customText?: string | undefined;
-        readonly chromaKey?: string | boolean | {
-            r: number;
-            g: number;
-            b: number;
-        } | null | undefined;
-        readonly chromaKeyTolerance?: number | undefined;
-        readonly chromaKeyTrimPadding?: number | undefined;
-        readonly chromaKeyTrimLuminanceThreshold?: number | undefined;
-        readonly chromaKeyTrimMode?: "range" | "frame" | "off" | undefined;
-        readonly sourceCrop?: SourceCrop | null;
-    };
-    readonly cursorGravity: {
-        readonly charsetFrames: string[];
-        readonly charsetFps: 1.2;
-        readonly animationStyle: "current";
-        readonly animationSpeed: 0.9;
-        readonly ditherStrength: 0.2;
-        readonly hoverEffect: "attract";
-        readonly hoverStrength: 0.82;
-        readonly hoverRadius: 0.24;
-        readonly hoverColor: "#ffffff";
-        readonly normalize: true;
-        readonly fontSize?: number | undefined;
-        readonly charSpacing?: number | undefined;
-        readonly brightness?: number | undefined;
-        readonly contrast?: number | undefined;
-        readonly charset?: string | undefined;
-        readonly colorMode?: ColorMode | undefined;
-        readonly accentColor?: string | undefined;
-        readonly invert?: boolean | "auto" | undefined;
-        readonly renderMode?: RenderMode | undefined;
-        readonly dotSizeRatio?: number | undefined;
-        readonly charAspect?: number | undefined;
-        readonly hoverShape?: HoverShape | undefined;
-        readonly hoverText?: string | string[] | undefined;
-        readonly artStyle?: ArtStyle | undefined;
-        readonly customText?: string | undefined;
-        readonly chromaKey?: string | boolean | {
-            r: number;
-            g: number;
-            b: number;
-        } | null | undefined;
-        readonly chromaKeyTolerance?: number | undefined;
-        readonly chromaKeyTrimPadding?: number | undefined;
-        readonly chromaKeyTrimLuminanceThreshold?: number | undefined;
-        readonly chromaKeyTrimMode?: "range" | "frame" | "off" | undefined;
-        readonly sourceCrop?: SourceCrop | null;
-    };
-    readonly editorialPulse: {
-        readonly charsetFrames: string[];
-        readonly charsetFps: 0.9;
-        readonly animationStyle: "caustics";
-        readonly animationSpeed: 0.55;
-        readonly ditherStrength: 0.18;
-        readonly hoverEffect: "spotlight";
-        readonly hoverStrength: 0.35;
-        readonly hoverRadius: 0.2;
-        readonly hoverColor: "#fff8ea";
-        readonly normalize: true;
-        readonly fontSize?: number | undefined;
-        readonly charSpacing?: number | undefined;
-        readonly brightness?: number | undefined;
-        readonly contrast?: number | undefined;
-        readonly charset?: string | undefined;
-        readonly colorMode?: ColorMode | undefined;
-        readonly accentColor?: string | undefined;
-        readonly invert?: boolean | "auto" | undefined;
-        readonly renderMode?: RenderMode | undefined;
-        readonly dotSizeRatio?: number | undefined;
-        readonly charAspect?: number | undefined;
-        readonly hoverShape?: HoverShape | undefined;
-        readonly hoverText?: string | string[] | undefined;
-        readonly artStyle?: ArtStyle | undefined;
-        readonly customText?: string | undefined;
-        readonly chromaKey?: string | boolean | {
-            r: number;
-            g: number;
-            b: number;
-        } | null | undefined;
-        readonly chromaKeyTolerance?: number | undefined;
-        readonly chromaKeyTrimPadding?: number | undefined;
-        readonly chromaKeyTrimLuminanceThreshold?: number | undefined;
-        readonly chromaKeyTrimMode?: "range" | "frame" | "off" | undefined;
-        readonly sourceCrop?: SourceCrop | null;
-    };
-    readonly terminalFlow: {
-        readonly charsetFrames: string[];
-        readonly charsetFps: 3;
-        readonly animationStyle: "reform";
-        readonly animationSpeed: 1.1;
-        readonly ditherStrength: 0.22;
-        readonly hoverEffect: "glitchText";
-        readonly hoverStrength: 0.65;
-        readonly hoverRadius: 0.16;
-        readonly hoverColor: "#d4ff00";
-        readonly hoverText: ["BUILD", "SHIP", "RUN", "ASK", "MODEL"];
-        readonly normalize: true;
-        readonly fontSize?: number | undefined;
-        readonly charSpacing?: number | undefined;
-        readonly brightness?: number | undefined;
-        readonly contrast?: number | undefined;
-        readonly charset?: string | undefined;
-        readonly colorMode?: ColorMode | undefined;
-        readonly accentColor?: string | undefined;
-        readonly invert?: boolean | "auto" | undefined;
-        readonly renderMode?: RenderMode | undefined;
-        readonly dotSizeRatio?: number | undefined;
-        readonly charAspect?: number | undefined;
-        readonly hoverShape?: HoverShape | undefined;
-        readonly artStyle?: ArtStyle | undefined;
-        readonly customText?: string | undefined;
-        readonly chromaKey?: string | boolean | {
-            r: number;
-            g: number;
-            b: number;
-        } | null | undefined;
-        readonly chromaKeyTolerance?: number | undefined;
-        readonly chromaKeyTrimPadding?: number | undefined;
-        readonly chromaKeyTrimLuminanceThreshold?: number | undefined;
-        readonly chromaKeyTrimMode?: "range" | "frame" | "off" | undefined;
-        readonly sourceCrop?: SourceCrop | null;
-    };
-};
-type LivingStylePresetKey = keyof typeof LIVING_STYLE_PRESETS;
-declare const DEFAULT_OPTIONS: AsciiOptions;
-/**
- * Hover presets — one-click configurations for the hover system.
- */
-declare const HOVER_PRESETS: Record<HoverPreset, {
-    label: string;
-    options: Partial<AsciiOptions>;
-}>;
-
-export { type AsciiFrame as A, CHARSETS as C, DEFAULT_OPTIONS as D, type HoverEffect as H, LIVING_STYLE_PRESETS as L, PALETTE_THEMES as P, type RenderMode as R, type SourceType as S, type AsciiOptions as a, type ArtStyle as b, ART_STYLE_PRESETS as c, type AnimationStyle as d, type AsciiCell as e, type AsciiResult as f, CHARSET_SEQUENCES as g, type CharsetKey as h, type CharsetSequenceKey as i, type ColorMode as j, HOVER_PRESETS as k, type HoverPreset as l, type HoverShape as m, type LivingStylePresetKey as n, type PaletteTheme as o };