asciify-engine 3.0.0 → 4.1.0

package/dist/studio.d.cts

@@ -1,5 +1,5 @@
-import { A as AmbientMotion } from './ambient-motion-CqF5-eZ2.cjs';
-export { M as STUDIO_MOTIONS } from './ambient-motion-CqF5-eZ2.cjs';
+import { S as StudioSettings, a as StudioInput } from './model-aIWlIoDT.cjs';
+export { B as BLEND_MODES, C as CHARACTER_SETS, D as DEFAULT_STUDIO_SETTINGS, b as DITHER_ALGORITHMS, c as DitherAlgorithm, d as STUDIO_CHARACTER_SETS, e as STUDIO_PALETTES, f as STUDIO_STYLES, g as StudioLight, h as StudioMask, i as StudioStyle, n as normalizeStudioSettings, p as parseStudioSettings, s as serializeStudioSettings, j as studioCrop, k as studioDimensions, l as studioGrid, u as updateStudioSettings } from './model-aIWlIoDT.cjs';
 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';
@@ -21,135 +21,7 @@ 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: AmbientMotion;
-        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;
-/** Effective grid and usable cell-size range at a bounded render resolution.
- * pixelRatio preserves preview density when exporting at a larger resolution.
- */
-declare function studioGrid(width: number, height: number, settings: Pick<StudioSettings, 'style' | 'cellSize' | 'dither'>, maxCells?: number, pixelRatio?: number): {
-    cell: number;
-    rowHeight: number;
-    columns: number;
-    rows: number;
-    minimum: number;
-    limited: boolean;
-};
+export { M as STUDIO_MOTIONS } from './ambient-motion-CqF5-eZ2.cjs';
 
 declare const STUDIO_LOOKS: {
     id: string;
@@ -171,6 +43,9 @@ declare function createStudioRenderer(canvas: HTMLCanvasElement, settings?: unkn
 }): {
     canvas: HTMLCanvasElement;
     render: (source: StudioSource, time?: number, requestedWidth?: number, requestedHeight?: number, motionTime?: number) => void;
+    /** Change raster scale without adding logical cells or remounting media. */
+    setPixelRatio(ratio: number): void;
+    readonly pixelRatio: number;
     setBudget(cells: number): void;
     readonly maxCells: number;
     configure(input: unknown): void;
@@ -238,12 +113,14 @@ declare function mountStudio(canvas: HTMLCanvasElement, source: File | string, o
     canvas: HTMLCanvasElement;
     media: StudioMedia;
     update(next: StudioInput): void;
-    resize(w: number, h: number): void;
+    resize(w: number, h: number, pixelRatio?: number): void;
     pause(value?: boolean): void;
     seek(seconds: number): Promise<void>;
     redraw(): void;
     readonly time: number;
     readonly paused: boolean;
+    setBudget(cells: number): void;
+    readonly pixelRatio: number;
     readonly maxCells: number;
     readonly capabilities: {
         gpuFinish: boolean;
@@ -255,12 +132,14 @@ declare function mountStudioMedia(canvas: HTMLCanvasElement, media: StudioMedia,
     canvas: HTMLCanvasElement;
     media: StudioMedia;
     update(next: StudioInput): void;
-    resize(w: number, h: number): void;
+    resize(w: number, h: number, pixelRatio?: number): void;
     pause(value?: boolean): void;
     seek(seconds: number): Promise<void>;
     redraw(): void;
     readonly time: number;
     readonly paused: boolean;
+    setBudget(cells: number): void;
+    readonly pixelRatio: number;
     readonly maxCells: number;
     readonly capabilities: {
         gpuFinish: boolean;
@@ -298,40 +177,4 @@ declare function createStudioText(text: string, font?: keyof typeof loaders, ink
     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, studioGrid, studioLook, studioSourceSize, updateStudioSettings };
+export { type MountStudioOptions, STUDIO_LOOKS, STUDIO_TEXT_FONTS, type StudioExportFormat, type StudioExportOptions, type StudioExportSource, StudioInput, type StudioMedia, StudioSettings, type StudioSource, createStudioRenderer, createStudioText, exportStudio, loadStudioMedia, mountStudio, mountStudioMedia, restyleStudio, studioLook, studioSourceSize };

package/dist/studio.d.ts

@@ -1,5 +1,5 @@
-import { A as AmbientMotion } from './ambient-motion-CqF5-eZ2.js';
-export { M as STUDIO_MOTIONS } from './ambient-motion-CqF5-eZ2.js';
+import { S as StudioSettings, a as StudioInput } from './model-BJXd0Jl-.js';
+export { B as BLEND_MODES, C as CHARACTER_SETS, D as DEFAULT_STUDIO_SETTINGS, b as DITHER_ALGORITHMS, c as DitherAlgorithm, d as STUDIO_CHARACTER_SETS, e as STUDIO_PALETTES, f as STUDIO_STYLES, g as StudioLight, h as StudioMask, i as StudioStyle, n as normalizeStudioSettings, p as parseStudioSettings, s as serializeStudioSettings, j as studioCrop, k as studioDimensions, l as studioGrid, u as updateStudioSettings } from './model-BJXd0Jl-.js';
 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';
@@ -21,135 +21,7 @@ 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: AmbientMotion;
-        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;
-/** Effective grid and usable cell-size range at a bounded render resolution.
- * pixelRatio preserves preview density when exporting at a larger resolution.
- */
-declare function studioGrid(width: number, height: number, settings: Pick<StudioSettings, 'style' | 'cellSize' | 'dither'>, maxCells?: number, pixelRatio?: number): {
-    cell: number;
-    rowHeight: number;
-    columns: number;
-    rows: number;
-    minimum: number;
-    limited: boolean;
-};
+export { M as STUDIO_MOTIONS } from './ambient-motion-CqF5-eZ2.js';
 
 declare const STUDIO_LOOKS: {
     id: string;
@@ -171,6 +43,9 @@ declare function createStudioRenderer(canvas: HTMLCanvasElement, settings?: unkn
 }): {
     canvas: HTMLCanvasElement;
     render: (source: StudioSource, time?: number, requestedWidth?: number, requestedHeight?: number, motionTime?: number) => void;
+    /** Change raster scale without adding logical cells or remounting media. */
+    setPixelRatio(ratio: number): void;
+    readonly pixelRatio: number;
     setBudget(cells: number): void;
     readonly maxCells: number;
     configure(input: unknown): void;
@@ -238,12 +113,14 @@ declare function mountStudio(canvas: HTMLCanvasElement, source: File | string, o
     canvas: HTMLCanvasElement;
     media: StudioMedia;
     update(next: StudioInput): void;
-    resize(w: number, h: number): void;
+    resize(w: number, h: number, pixelRatio?: number): void;
     pause(value?: boolean): void;
     seek(seconds: number): Promise<void>;
     redraw(): void;
     readonly time: number;
     readonly paused: boolean;
+    setBudget(cells: number): void;
+    readonly pixelRatio: number;
     readonly maxCells: number;
     readonly capabilities: {
         gpuFinish: boolean;
@@ -255,12 +132,14 @@ declare function mountStudioMedia(canvas: HTMLCanvasElement, media: StudioMedia,
     canvas: HTMLCanvasElement;
     media: StudioMedia;
     update(next: StudioInput): void;
-    resize(w: number, h: number): void;
+    resize(w: number, h: number, pixelRatio?: number): void;
     pause(value?: boolean): void;
     seek(seconds: number): Promise<void>;
     redraw(): void;
     readonly time: number;
     readonly paused: boolean;
+    setBudget(cells: number): void;
+    readonly pixelRatio: number;
     readonly maxCells: number;
     readonly capabilities: {
         gpuFinish: boolean;
@@ -298,40 +177,4 @@ declare function createStudioText(text: string, font?: keyof typeof loaders, ink
     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, studioGrid, studioLook, studioSourceSize, updateStudioSettings };
+export { type MountStudioOptions, STUDIO_LOOKS, STUDIO_TEXT_FONTS, type StudioExportFormat, type StudioExportOptions, type StudioExportSource, StudioInput, type StudioMedia, StudioSettings, type StudioSource, createStudioRenderer, createStudioText, exportStudio, loadStudioMedia, mountStudio, mountStudioMedia, restyleStudio, studioLook, studioSourceSize };