asciify-engine 1.3.0 → 2.0.0

package/dist/studio.d.cts

@@ -0,0 +1,322 @@
+import * as figlet_fonts_Wavy from 'figlet/fonts/Wavy';
+import * as figlet_fonts_Univers from 'figlet/fonts/Univers';
+import * as figlet_fonts_3_D from 'figlet/fonts/3-D';
+import * as figlet_fonts_Thin from 'figlet/fonts/Thin';
+import * as figlet_fonts_Straight from 'figlet/fonts/Straight';
+import * as figlet_fonts_Stop from 'figlet/fonts/Stop';
+import * as figlet_fonts_Star_Wars from 'figlet/fonts/Star Wars';
+import * as figlet_fonts_Speed from 'figlet/fonts/Speed';
+import * as figlet_fonts_Shadow from 'figlet/fonts/Shadow';
+import * as figlet_fonts_Script from 'figlet/fonts/Script';
+import * as figlet_fonts_Mini from 'figlet/fonts/Mini';
+import * as figlet_fonts_Lean from 'figlet/fonts/Lean';
+import * as figlet_fonts_Doom from 'figlet/fonts/Doom';
+import * as figlet_fonts_Digital from 'figlet/fonts/Digital';
+import * as figlet_fonts_Bubble from 'figlet/fonts/Bubble';
+import * as figlet_fonts_Block from 'figlet/fonts/Block';
+import * as figlet_fonts_Banner from 'figlet/fonts/Banner';
+import * as figlet_fonts_Big from 'figlet/fonts/Big';
+import * as figlet_fonts_Small from 'figlet/fonts/Small';
+import * as figlet_fonts_Slant from 'figlet/fonts/Slant';
+import * as figlet_fonts_Standard from 'figlet/fonts/Standard';
+
+/** Serializable, media-independent editing state. No DOM work at import time. */
+declare const STUDIO_STYLES: readonly ["ascii", "blocks", "braille", "dots", "lines", "cross", "diagonal", "diamond", "mixed", "pixel", "mosaic", "lego", "voxel", "disco", "dither"];
+type StudioStyle = (typeof STUDIO_STYLES)[number];
+declare const DITHER_ALGORITHMS: readonly ["none", "bayer2", "bayer4", "bayer8", "bayer16", "floyd-steinberg", "atkinson", "stucki", "sierra", "sierra-lite", "burkes", "jarvis", "halftone", "lines", "noise"];
+type DitherAlgorithm = (typeof DITHER_ALGORITHMS)[number];
+declare const BLEND_MODES: readonly ["source-over", "multiply", "screen", "overlay", "soft-light", "hard-light", "color-dodge", "color-burn", "hue", "saturation", "color", "luminosity"];
+declare const STUDIO_PALETTES: Record<string, readonly string[]>;
+interface StudioMask {
+    kind: "rectangle" | "ellipse" | "brush";
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    points?: [number, number][];
+    size?: number;
+}
+interface StudioLight {
+    x: number;
+    y: number;
+    radius: number;
+    intensity: number;
+    color: string;
+}
+interface StudioSettings {
+    version: 1;
+    aspectRatio: "original" | "16:9" | "9:16" | "1:1" | "4:3" | "3:4" | "21:9";
+    style: StudioStyle;
+    cellSize: number;
+    charset: string;
+    colorMode: "accent" | "source" | "gray";
+    ink: string;
+    crop: {
+        x: number;
+        y: number;
+        zoom: number;
+        rotation: number;
+    };
+    backdrop: {
+        mode: "solid" | "transparent" | "source" | "blurred" | "gradient";
+        color: string;
+        color2: string;
+        blur: number;
+        opacity: number;
+    };
+    color: {
+        brightness: number;
+        contrast: number;
+        saturation: number;
+        grayscale: number;
+        tint: string;
+        amount: number;
+        blend: (typeof BLEND_MODES)[number];
+    };
+    dither: {
+        algorithm: DitherAlgorithm;
+        palette: string;
+        colors: string[];
+        amount: number;
+        scale: number;
+        threshold: number;
+        motion: "none" | "drift" | "shimmer";
+        speed: number;
+    };
+    mask: {
+        enabled: boolean;
+        invert: boolean;
+        shapes: StudioMask[];
+    };
+    lights: StudioLight[];
+    effects: {
+        bloom: number;
+        characterBloom: number;
+        grain: number;
+        dust: number;
+        scanlines: number;
+        crt: number;
+        prism: number;
+        vignette: number;
+        glitch: number;
+        pixelate: number;
+        blur: number;
+        blurType: "gaussian" | "directional" | "radial" | "progressive";
+        angle: number;
+        focus: number;
+        halftone: number;
+    };
+    motion: {
+        type: "none" | "breathe" | "wave" | "reveal" | "glitch" | "rainbow" | "hologram" | "fire" | "chrome" | "ripple" | "vapor";
+        speed: number;
+    };
+    hover: {
+        effect: "none" | "trail" | "water" | "contour" | "dissolve" | "silk" | "vortex";
+        strength: number;
+        radius: number;
+        edgeSafe: boolean;
+    };
+}
+declare const DEFAULT_STUDIO_SETTINGS: StudioSettings;
+/** Whitelist external settings; reject future versions instead of misinterpreting them. */
+declare function normalizeStudioSettings(input?: unknown): StudioSettings;
+declare function serializeStudioSettings(settings: StudioSettings): string;
+declare function parseStudioSettings(json: string): StudioSettings;
+declare function studioCrop(sw: number, sh: number, w: number, h: number, c: StudioSettings["crop"]): {
+    width: number;
+    height: number;
+    x: number;
+    y: number;
+    scale: number;
+    rotated: boolean;
+};
+/** Dimensions for the saved canvas ratio, including source rotation. */
+declare function studioDimensions(width: number, height: number, settings: StudioSettings): [number, number];
+/** Partial configuration for mounting and incremental updates. Arrays replace previous arrays. */
+type StudioInput = {
+    [K in keyof StudioSettings]?: StudioSettings[K] extends readonly unknown[] ? StudioSettings[K] : StudioSettings[K] extends object ? Partial<StudioSettings[K]> : StudioSettings[K];
+};
+declare function updateStudioSettings(current: StudioSettings, patch: StudioInput): StudioSettings;
+
+declare const STUDIO_LOOKS: {
+    id: string;
+    name: string;
+    description: string;
+    settings: StudioSettings;
+}[];
+/** Return independent state; applying or editing a look never mutates its preset. */
+declare function studioLook(id: string): StudioSettings;
+declare function restyleStudio(current: StudioSettings, random?: () => number): StudioSettings;
+
+type StudioSource = HTMLImageElement | HTMLVideoElement | HTMLCanvasElement | ImageBitmap;
+declare function studioSourceSize(s: StudioSource): [number, number];
+/** Reusable bounded renderer. Call configure only when settings change; render owns no RAF. */
+declare function createStudioRenderer(canvas: HTMLCanvasElement, settings?: unknown, limits?: {
+    maxDimension?: number;
+    maxCells?: number;
+    pixelRatio?: number;
+}): {
+    canvas: HTMLCanvasElement;
+    render: (source: StudioSource, time?: number, requestedWidth?: number, requestedHeight?: number) => void;
+    setBudget(cells: number): void;
+    readonly maxCells: number;
+    configure(input: unknown): void;
+    pointer: (x: number, y: number, time: number) => void;
+    leave(): void;
+    readonly active: boolean;
+    readonly settings: StudioSettings;
+    readonly capabilities: {
+        gpuFinish: boolean;
+    };
+    invalidate(): void;
+    destroy(): void;
+};
+
+interface StudioMedia {
+    source: StudioSource;
+    width: number;
+    height: number;
+    duration: number;
+    animated: boolean;
+    seek(time: number, signal?: AbortSignal): Promise<void>;
+    frame(time: number): StudioSource;
+    destroy(): void;
+}
+/** Local File or permitted CORS URL. Caller owns destroy; URLs created here are revoked. */
+declare function loadStudioMedia(input: File | string, signal?: AbortSignal): Promise<StudioMedia>;
+
+type StudioExportFormat = "png" | "jpeg" | "mp4" | "webm" | "gif";
+interface StudioExportOptions {
+    format: StudioExportFormat;
+    width: number;
+    height: number;
+    duration?: number;
+    fps?: number;
+    quality?: number;
+    signal?: AbortSignal;
+    onProgress?: (progress: number) => void;
+    maxCells?: number;
+    /** Preview canvas width, for identical cell density when upscaling. */
+    referenceWidth?: number;
+}
+interface StudioExportSource {
+    frame(time: number, signal?: AbortSignal): StudioSource | Promise<StudioSource>;
+}
+/** A separate renderer preserves preview state. The source callback must also be independent for video exports. */
+declare function exportStudio(source: StudioExportSource, settings: StudioSettings, options: StudioExportOptions): Promise<Blob>;
+
+interface MountStudioOptions {
+    settings?: StudioInput;
+    width?: number;
+    height?: number;
+    fps?: number;
+    maxDimension?: number;
+    maxCells?: number;
+    adaptive?: boolean;
+    onQualityChange?: (maxCells: number) => void;
+    signal?: AbortSignal;
+    onError?: (error: Error) => void;
+    onFrame?: (time: number, costMs: number) => void;
+}
+/** Mount one source, update serializable settings, and destroy on unmount. */
+declare function mountStudio(canvas: HTMLCanvasElement, source: File | string, options?: MountStudioOptions): Promise<{
+    canvas: HTMLCanvasElement;
+    media: StudioMedia;
+    update(next: StudioInput): void;
+    resize(w: number, h: number): void;
+    pause(value?: boolean): void;
+    seek(seconds: number): Promise<void>;
+    redraw(): void;
+    readonly time: number;
+    readonly paused: boolean;
+    readonly maxCells: number;
+    readonly capabilities: {
+        gpuFinish: boolean;
+    };
+    destroy: () => void;
+}>;
+/** Takes ownership of media. Use a second media instance for export. */
+declare function mountStudioMedia(canvas: HTMLCanvasElement, media: StudioMedia, options?: MountStudioOptions): {
+    canvas: HTMLCanvasElement;
+    media: StudioMedia;
+    update(next: StudioInput): void;
+    resize(w: number, h: number): void;
+    pause(value?: boolean): void;
+    seek(seconds: number): Promise<void>;
+    redraw(): void;
+    readonly time: number;
+    readonly paused: boolean;
+    readonly maxCells: number;
+    readonly capabilities: {
+        gpuFinish: boolean;
+    };
+    destroy: () => void;
+};
+
+/** Fonts are loaded individually only when selected; none enter the core renderer. */
+declare const loaders: {
+    Standard: () => Promise<typeof figlet_fonts_Standard>;
+    Slant: () => Promise<typeof figlet_fonts_Slant>;
+    Small: () => Promise<typeof figlet_fonts_Small>;
+    Big: () => Promise<typeof figlet_fonts_Big>;
+    Banner: () => Promise<typeof figlet_fonts_Banner>;
+    Block: () => Promise<typeof figlet_fonts_Block>;
+    Bubble: () => Promise<typeof figlet_fonts_Bubble>;
+    Digital: () => Promise<typeof figlet_fonts_Digital>;
+    Doom: () => Promise<typeof figlet_fonts_Doom>;
+    Lean: () => Promise<typeof figlet_fonts_Lean>;
+    Mini: () => Promise<typeof figlet_fonts_Mini>;
+    Script: () => Promise<typeof figlet_fonts_Script>;
+    Shadow: () => Promise<typeof figlet_fonts_Shadow>;
+    Speed: () => Promise<typeof figlet_fonts_Speed>;
+    Starwars: () => Promise<typeof figlet_fonts_Star_Wars>;
+    Stop: () => Promise<typeof figlet_fonts_Stop>;
+    Straight: () => Promise<typeof figlet_fonts_Straight>;
+    Thin: () => Promise<typeof figlet_fonts_Thin>;
+    ThreeD: () => Promise<typeof figlet_fonts_3_D>;
+    Univers: () => Promise<typeof figlet_fonts_Univers>;
+    Wavy: () => Promise<typeof figlet_fonts_Wavy>;
+};
+declare const STUDIO_TEXT_FONTS: (keyof typeof loaders)[];
+declare function createStudioText(text: string, font?: keyof typeof loaders, ink?: string): Promise<{
+    canvas: HTMLCanvasElement;
+    ascii: string;
+}>;
+
+/** Curated ASCII ramps. Use custom text to supply a different alphabet. */
+declare const STUDIO_CHARACTER_SETS: {
+    readonly standard: {
+        readonly label: "Classic ASCII";
+        readonly chars: " .:-=+*#%@";
+    };
+    readonly asciify: {
+        readonly label: "Asciify";
+        readonly chars: " .:-=+ASCIIFY#@";
+    };
+    readonly minimal: {
+        readonly label: "Minimal";
+        readonly chars: " .:+";
+    };
+    readonly detailed: {
+        readonly label: "Detailed";
+        readonly chars: " .,:;i1tfLCG08@";
+    };
+    readonly letters: {
+        readonly label: "Letters";
+        readonly chars: " .ilLCFTYASMW";
+    };
+    readonly technical: {
+        readonly label: "Technical";
+        readonly chars: " .:;>_/[{}]=+*#@$";
+    };
+    readonly blocks: {
+        readonly label: "Tonal blocks";
+        readonly chars: " ░▒▓█";
+    };
+    readonly braille: {
+        readonly label: "Braille";
+        readonly chars: " ⠁⠃⠇⡇⣇⣧⣷⣿";
+    };
+};
+
+export { BLEND_MODES, DEFAULT_STUDIO_SETTINGS, DITHER_ALGORITHMS, type DitherAlgorithm, type MountStudioOptions, STUDIO_CHARACTER_SETS, STUDIO_LOOKS, STUDIO_PALETTES, STUDIO_STYLES, STUDIO_TEXT_FONTS, type StudioExportFormat, type StudioExportOptions, type StudioExportSource, type StudioInput, type StudioLight, type StudioMask, type StudioMedia, type StudioSettings, type StudioSource, type StudioStyle, createStudioRenderer, createStudioText, exportStudio, loadStudioMedia, mountStudio, mountStudioMedia, normalizeStudioSettings, parseStudioSettings, restyleStudio, serializeStudioSettings, studioCrop, studioDimensions, studioLook, studioSourceSize, updateStudioSettings };

package/dist/studio.d.ts

@@ -0,0 +1,322 @@
+import * as figlet_fonts_Wavy from 'figlet/fonts/Wavy';
+import * as figlet_fonts_Univers from 'figlet/fonts/Univers';
+import * as figlet_fonts_3_D from 'figlet/fonts/3-D';
+import * as figlet_fonts_Thin from 'figlet/fonts/Thin';
+import * as figlet_fonts_Straight from 'figlet/fonts/Straight';
+import * as figlet_fonts_Stop from 'figlet/fonts/Stop';
+import * as figlet_fonts_Star_Wars from 'figlet/fonts/Star Wars';
+import * as figlet_fonts_Speed from 'figlet/fonts/Speed';
+import * as figlet_fonts_Shadow from 'figlet/fonts/Shadow';
+import * as figlet_fonts_Script from 'figlet/fonts/Script';
+import * as figlet_fonts_Mini from 'figlet/fonts/Mini';
+import * as figlet_fonts_Lean from 'figlet/fonts/Lean';
+import * as figlet_fonts_Doom from 'figlet/fonts/Doom';
+import * as figlet_fonts_Digital from 'figlet/fonts/Digital';
+import * as figlet_fonts_Bubble from 'figlet/fonts/Bubble';
+import * as figlet_fonts_Block from 'figlet/fonts/Block';
+import * as figlet_fonts_Banner from 'figlet/fonts/Banner';
+import * as figlet_fonts_Big from 'figlet/fonts/Big';
+import * as figlet_fonts_Small from 'figlet/fonts/Small';
+import * as figlet_fonts_Slant from 'figlet/fonts/Slant';
+import * as figlet_fonts_Standard from 'figlet/fonts/Standard';
+
+/** Serializable, media-independent editing state. No DOM work at import time. */
+declare const STUDIO_STYLES: readonly ["ascii", "blocks", "braille", "dots", "lines", "cross", "diagonal", "diamond", "mixed", "pixel", "mosaic", "lego", "voxel", "disco", "dither"];
+type StudioStyle = (typeof STUDIO_STYLES)[number];
+declare const DITHER_ALGORITHMS: readonly ["none", "bayer2", "bayer4", "bayer8", "bayer16", "floyd-steinberg", "atkinson", "stucki", "sierra", "sierra-lite", "burkes", "jarvis", "halftone", "lines", "noise"];
+type DitherAlgorithm = (typeof DITHER_ALGORITHMS)[number];
+declare const BLEND_MODES: readonly ["source-over", "multiply", "screen", "overlay", "soft-light", "hard-light", "color-dodge", "color-burn", "hue", "saturation", "color", "luminosity"];
+declare const STUDIO_PALETTES: Record<string, readonly string[]>;
+interface StudioMask {
+    kind: "rectangle" | "ellipse" | "brush";
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    points?: [number, number][];
+    size?: number;
+}
+interface StudioLight {
+    x: number;
+    y: number;
+    radius: number;
+    intensity: number;
+    color: string;
+}
+interface StudioSettings {
+    version: 1;
+    aspectRatio: "original" | "16:9" | "9:16" | "1:1" | "4:3" | "3:4" | "21:9";
+    style: StudioStyle;
+    cellSize: number;
+    charset: string;
+    colorMode: "accent" | "source" | "gray";
+    ink: string;
+    crop: {
+        x: number;
+        y: number;
+        zoom: number;
+        rotation: number;
+    };
+    backdrop: {
+        mode: "solid" | "transparent" | "source" | "blurred" | "gradient";
+        color: string;
+        color2: string;
+        blur: number;
+        opacity: number;
+    };
+    color: {
+        brightness: number;
+        contrast: number;
+        saturation: number;
+        grayscale: number;
+        tint: string;
+        amount: number;
+        blend: (typeof BLEND_MODES)[number];
+    };
+    dither: {
+        algorithm: DitherAlgorithm;
+        palette: string;
+        colors: string[];
+        amount: number;
+        scale: number;
+        threshold: number;
+        motion: "none" | "drift" | "shimmer";
+        speed: number;
+    };
+    mask: {
+        enabled: boolean;
+        invert: boolean;
+        shapes: StudioMask[];
+    };
+    lights: StudioLight[];
+    effects: {
+        bloom: number;
+        characterBloom: number;
+        grain: number;
+        dust: number;
+        scanlines: number;
+        crt: number;
+        prism: number;
+        vignette: number;
+        glitch: number;
+        pixelate: number;
+        blur: number;
+        blurType: "gaussian" | "directional" | "radial" | "progressive";
+        angle: number;
+        focus: number;
+        halftone: number;
+    };
+    motion: {
+        type: "none" | "breathe" | "wave" | "reveal" | "glitch" | "rainbow" | "hologram" | "fire" | "chrome" | "ripple" | "vapor";
+        speed: number;
+    };
+    hover: {
+        effect: "none" | "trail" | "water" | "contour" | "dissolve" | "silk" | "vortex";
+        strength: number;
+        radius: number;
+        edgeSafe: boolean;
+    };
+}
+declare const DEFAULT_STUDIO_SETTINGS: StudioSettings;
+/** Whitelist external settings; reject future versions instead of misinterpreting them. */
+declare function normalizeStudioSettings(input?: unknown): StudioSettings;
+declare function serializeStudioSettings(settings: StudioSettings): string;
+declare function parseStudioSettings(json: string): StudioSettings;
+declare function studioCrop(sw: number, sh: number, w: number, h: number, c: StudioSettings["crop"]): {
+    width: number;
+    height: number;
+    x: number;
+    y: number;
+    scale: number;
+    rotated: boolean;
+};
+/** Dimensions for the saved canvas ratio, including source rotation. */
+declare function studioDimensions(width: number, height: number, settings: StudioSettings): [number, number];
+/** Partial configuration for mounting and incremental updates. Arrays replace previous arrays. */
+type StudioInput = {
+    [K in keyof StudioSettings]?: StudioSettings[K] extends readonly unknown[] ? StudioSettings[K] : StudioSettings[K] extends object ? Partial<StudioSettings[K]> : StudioSettings[K];
+};
+declare function updateStudioSettings(current: StudioSettings, patch: StudioInput): StudioSettings;
+
+declare const STUDIO_LOOKS: {
+    id: string;
+    name: string;
+    description: string;
+    settings: StudioSettings;
+}[];
+/** Return independent state; applying or editing a look never mutates its preset. */
+declare function studioLook(id: string): StudioSettings;
+declare function restyleStudio(current: StudioSettings, random?: () => number): StudioSettings;
+
+type StudioSource = HTMLImageElement | HTMLVideoElement | HTMLCanvasElement | ImageBitmap;
+declare function studioSourceSize(s: StudioSource): [number, number];
+/** Reusable bounded renderer. Call configure only when settings change; render owns no RAF. */
+declare function createStudioRenderer(canvas: HTMLCanvasElement, settings?: unknown, limits?: {
+    maxDimension?: number;
+    maxCells?: number;
+    pixelRatio?: number;
+}): {
+    canvas: HTMLCanvasElement;
+    render: (source: StudioSource, time?: number, requestedWidth?: number, requestedHeight?: number) => void;
+    setBudget(cells: number): void;
+    readonly maxCells: number;
+    configure(input: unknown): void;
+    pointer: (x: number, y: number, time: number) => void;
+    leave(): void;
+    readonly active: boolean;
+    readonly settings: StudioSettings;
+    readonly capabilities: {
+        gpuFinish: boolean;
+    };
+    invalidate(): void;
+    destroy(): void;
+};
+
+interface StudioMedia {
+    source: StudioSource;
+    width: number;
+    height: number;
+    duration: number;
+    animated: boolean;
+    seek(time: number, signal?: AbortSignal): Promise<void>;
+    frame(time: number): StudioSource;
+    destroy(): void;
+}
+/** Local File or permitted CORS URL. Caller owns destroy; URLs created here are revoked. */
+declare function loadStudioMedia(input: File | string, signal?: AbortSignal): Promise<StudioMedia>;
+
+type StudioExportFormat = "png" | "jpeg" | "mp4" | "webm" | "gif";
+interface StudioExportOptions {
+    format: StudioExportFormat;
+    width: number;
+    height: number;
+    duration?: number;
+    fps?: number;
+    quality?: number;
+    signal?: AbortSignal;
+    onProgress?: (progress: number) => void;
+    maxCells?: number;
+    /** Preview canvas width, for identical cell density when upscaling. */
+    referenceWidth?: number;
+}
+interface StudioExportSource {
+    frame(time: number, signal?: AbortSignal): StudioSource | Promise<StudioSource>;
+}
+/** A separate renderer preserves preview state. The source callback must also be independent for video exports. */
+declare function exportStudio(source: StudioExportSource, settings: StudioSettings, options: StudioExportOptions): Promise<Blob>;
+
+interface MountStudioOptions {
+    settings?: StudioInput;
+    width?: number;
+    height?: number;
+    fps?: number;
+    maxDimension?: number;
+    maxCells?: number;
+    adaptive?: boolean;
+    onQualityChange?: (maxCells: number) => void;
+    signal?: AbortSignal;
+    onError?: (error: Error) => void;
+    onFrame?: (time: number, costMs: number) => void;
+}
+/** Mount one source, update serializable settings, and destroy on unmount. */
+declare function mountStudio(canvas: HTMLCanvasElement, source: File | string, options?: MountStudioOptions): Promise<{
+    canvas: HTMLCanvasElement;
+    media: StudioMedia;
+    update(next: StudioInput): void;
+    resize(w: number, h: number): void;
+    pause(value?: boolean): void;
+    seek(seconds: number): Promise<void>;
+    redraw(): void;
+    readonly time: number;
+    readonly paused: boolean;
+    readonly maxCells: number;
+    readonly capabilities: {
+        gpuFinish: boolean;
+    };
+    destroy: () => void;
+}>;
+/** Takes ownership of media. Use a second media instance for export. */
+declare function mountStudioMedia(canvas: HTMLCanvasElement, media: StudioMedia, options?: MountStudioOptions): {
+    canvas: HTMLCanvasElement;
+    media: StudioMedia;
+    update(next: StudioInput): void;
+    resize(w: number, h: number): void;
+    pause(value?: boolean): void;
+    seek(seconds: number): Promise<void>;
+    redraw(): void;
+    readonly time: number;
+    readonly paused: boolean;
+    readonly maxCells: number;
+    readonly capabilities: {
+        gpuFinish: boolean;
+    };
+    destroy: () => void;
+};
+
+/** Fonts are loaded individually only when selected; none enter the core renderer. */
+declare const loaders: {
+    Standard: () => Promise<typeof figlet_fonts_Standard>;
+    Slant: () => Promise<typeof figlet_fonts_Slant>;
+    Small: () => Promise<typeof figlet_fonts_Small>;
+    Big: () => Promise<typeof figlet_fonts_Big>;
+    Banner: () => Promise<typeof figlet_fonts_Banner>;
+    Block: () => Promise<typeof figlet_fonts_Block>;
+    Bubble: () => Promise<typeof figlet_fonts_Bubble>;
+    Digital: () => Promise<typeof figlet_fonts_Digital>;
+    Doom: () => Promise<typeof figlet_fonts_Doom>;
+    Lean: () => Promise<typeof figlet_fonts_Lean>;
+    Mini: () => Promise<typeof figlet_fonts_Mini>;
+    Script: () => Promise<typeof figlet_fonts_Script>;
+    Shadow: () => Promise<typeof figlet_fonts_Shadow>;
+    Speed: () => Promise<typeof figlet_fonts_Speed>;
+    Starwars: () => Promise<typeof figlet_fonts_Star_Wars>;
+    Stop: () => Promise<typeof figlet_fonts_Stop>;
+    Straight: () => Promise<typeof figlet_fonts_Straight>;
+    Thin: () => Promise<typeof figlet_fonts_Thin>;
+    ThreeD: () => Promise<typeof figlet_fonts_3_D>;
+    Univers: () => Promise<typeof figlet_fonts_Univers>;
+    Wavy: () => Promise<typeof figlet_fonts_Wavy>;
+};
+declare const STUDIO_TEXT_FONTS: (keyof typeof loaders)[];
+declare function createStudioText(text: string, font?: keyof typeof loaders, ink?: string): Promise<{
+    canvas: HTMLCanvasElement;
+    ascii: string;
+}>;
+
+/** Curated ASCII ramps. Use custom text to supply a different alphabet. */
+declare const STUDIO_CHARACTER_SETS: {
+    readonly standard: {
+        readonly label: "Classic ASCII";
+        readonly chars: " .:-=+*#%@";
+    };
+    readonly asciify: {
+        readonly label: "Asciify";
+        readonly chars: " .:-=+ASCIIFY#@";
+    };
+    readonly minimal: {
+        readonly label: "Minimal";
+        readonly chars: " .:+";
+    };
+    readonly detailed: {
+        readonly label: "Detailed";
+        readonly chars: " .,:;i1tfLCG08@";
+    };
+    readonly letters: {
+        readonly label: "Letters";
+        readonly chars: " .ilLCFTYASMW";
+    };
+    readonly technical: {
+        readonly label: "Technical";
+        readonly chars: " .:;>_/[{}]=+*#@$";
+    };
+    readonly blocks: {
+        readonly label: "Tonal blocks";
+        readonly chars: " ░▒▓█";
+    };
+    readonly braille: {
+        readonly label: "Braille";
+        readonly chars: " ⠁⠃⠇⡇⣇⣧⣷⣿";
+    };
+};
+
+export { BLEND_MODES, DEFAULT_STUDIO_SETTINGS, DITHER_ALGORITHMS, type DitherAlgorithm, type MountStudioOptions, STUDIO_CHARACTER_SETS, STUDIO_LOOKS, STUDIO_PALETTES, STUDIO_STYLES, STUDIO_TEXT_FONTS, type StudioExportFormat, type StudioExportOptions, type StudioExportSource, type StudioInput, type StudioLight, type StudioMask, type StudioMedia, type StudioSettings, type StudioSource, type StudioStyle, createStudioRenderer, createStudioText, exportStudio, loadStudioMedia, mountStudio, mountStudioMedia, normalizeStudioSettings, parseStudioSettings, restyleStudio, serializeStudioSettings, studioCrop, studioDimensions, studioLook, studioSourceSize, updateStudioSettings };