asciify-engine 4.11.0 → 4.12.0

package/dist/studio.d.cts

@@ -1,5 +1,5 @@
-import { S as StudioSettings, a as StudioInput, B as BLEND_MODES } from './model-DQNOpbbG.cjs';
-export { C as CHARACTER_SETS, D as DEFAULT_STUDIO_PRINT, b as DEFAULT_STUDIO_SETTINGS, c as DITHER_ALGORITHMS, d as DitherAlgorithm, M as MAX_STUDIO_WARPS, e as STUDIO_CHARACTER_SETS, f as STUDIO_CURVE_CHANNELS, g as STUDIO_PALETTES, h as STUDIO_PRINT_STYLES, i as STUDIO_PRINT_STYLE_IDS, j as STUDIO_STYLES, k as STUDIO_WARPS, l as StudioCurveChannel, m as StudioCurvePoint, n as StudioCurves, o as StudioLight, p as StudioMask, q as StudioPrintSettings, r as StudioPrintStyle, s as StudioStyle, t as StudioWarp, u as StudioWarpEdge, v as StudioWarpType, w as createStudioCurveLookup, x as isStudioPrintStyle, y as normalizeStudioCurve, z as normalizeStudioCurves, A as normalizeStudioPrint, E as normalizeStudioSettings, F as normalizeStudioWarps, G as parseStudioSettings, H as serializeStudioSettings, I as studioCrop, J as studioDimensions, K as studioGrid, L as updateStudioSettings } from './model-DQNOpbbG.cjs';
+import { S as StudioSettings, a as StudioInput, B as BLEND_MODES } from './model-B0jK31nS.cjs';
+export { C as CHARACTER_SETS, D as DEFAULT_STUDIO_PRINT, b as DEFAULT_STUDIO_SETTINGS, c as DITHER_ALGORITHMS, d as DitherAlgorithm, M as MAX_STUDIO_WARPS, e as STUDIO_CHARACTER_SETS, f as STUDIO_CURVE_CHANNELS, g as STUDIO_PALETTES, h as STUDIO_PRINT_STYLES, i as STUDIO_PRINT_STYLE_IDS, j as STUDIO_STYLES, k as STUDIO_WARPS, l as StudioCurveChannel, m as StudioCurvePoint, n as StudioCurves, o as StudioLight, p as StudioMask, q as StudioPrintSettings, r as StudioPrintStyle, s as StudioStyle, t as StudioWarp, u as StudioWarpEdge, v as StudioWarpType, w as createStudioCurveLookup, x as isStudioPrintStyle, y as normalizeStudioCurve, z as normalizeStudioCurves, A as normalizeStudioPrint, E as normalizeStudioSettings, F as normalizeStudioWarps, G as parseStudioSettings, H as serializeStudioSettings, I as studioCrop, J as studioDimensions, K as studioGrid, L as updateStudioSettings } from './model-B0jK31nS.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';
@@ -36,6 +36,19 @@ declare function restyleStudio(current: StudioSettings, random?: () => number):
 
 type StudioSource = HTMLImageElement | HTMLVideoElement | HTMLCanvasElement | ImageBitmap;
 declare function studioSourceSize(s: StudioSource): [number, number];
+/** 1st and 99th luminance percentiles of the opaque sampled cells. */
+declare function studioLevels(pixels: Uint8ClampedArray): [number, number];
+/**
+ * Ink-aware gamma for the stretched tones: lifts the subject's mean tone (cells above the near-black ground)
+ * toward half ink, within gentle bounds, so mid-tones land on glyphs with visible coverage. Bright sources keep
+ * the mild minimum lift; it never darkens.
+ */
+declare function studioToneGamma(pixels: Uint8ClampedArray, low: number, high: number): number;
+/**
+ * Tone (0–255) to glyph index by measured ink: each glyph's coverage is normalised across the ramp and every tone
+ * takes the glyph whose ink is nearest, after the mid-tone lift. Returns null when the coverage cannot be read.
+ */
+declare function inkIndexLookup(coverage: number[], gamma?: number): Uint8Array | null;
 /** Reusable bounded renderer. Call configure only when settings change; render owns no RAF. */
 declare function createStudioRenderer(canvas: HTMLCanvasElement, settings?: unknown, limits?: {
     maxDimension?: number;
@@ -353,4 +366,4 @@ interface StudioProjectExportOptions extends Omit<StudioExportOptions, 'motionTi
 /** Loads independent assets and never seeks, pauses or destroys a live preview. */
 declare function exportStudioProject(input: StudioProjectInput, sources: StudioProjectSources, options: StudioProjectExportOptions): Promise<Blob>;
 
-export { BLEND_MODES, MAX_STUDIO_LAYERS, type MountStudioOptions, type MountStudioProjectOptions, STUDIO_LOOKS, STUDIO_TEXT_FONTS, type StudioExportFormat, type StudioExportOptions, type StudioExportSource, StudioInput, type StudioLayerInput, type StudioLayerPatch, type StudioLayerPlacement, type StudioMedia, type StudioProject, type StudioProjectExportOptions, type StudioProjectFrames, type StudioProjectInput, type StudioProjectLayer, type StudioProjectLimits, type StudioProjectMedia, type StudioProjectSource, type StudioProjectSources, type StudioProjectTextSource, StudioSettings, type StudioSource, createStudioProjectRenderer, createStudioRenderer, createStudioText, exportStudio, exportStudioProject, loadStudioMedia, mountStudio, mountStudioMedia, mountStudioProject, mountStudioProjectMedia, normalizeStudioProject, parseStudioProject, restyleStudio, serializeStudioProject, studioLayerPoint, studioLook, studioProjectBudget, studioSourceSize, updateStudioProjectLayer, visibleStudioLayers };
+export { BLEND_MODES, MAX_STUDIO_LAYERS, type MountStudioOptions, type MountStudioProjectOptions, STUDIO_LOOKS, STUDIO_TEXT_FONTS, type StudioExportFormat, type StudioExportOptions, type StudioExportSource, StudioInput, type StudioLayerInput, type StudioLayerPatch, type StudioLayerPlacement, type StudioMedia, type StudioProject, type StudioProjectExportOptions, type StudioProjectFrames, type StudioProjectInput, type StudioProjectLayer, type StudioProjectLimits, type StudioProjectMedia, type StudioProjectSource, type StudioProjectSources, type StudioProjectTextSource, StudioSettings, type StudioSource, createStudioProjectRenderer, createStudioRenderer, createStudioText, exportStudio, exportStudioProject, inkIndexLookup, loadStudioMedia, mountStudio, mountStudioMedia, mountStudioProject, mountStudioProjectMedia, normalizeStudioProject, parseStudioProject, restyleStudio, serializeStudioProject, studioLayerPoint, studioLevels, studioLook, studioProjectBudget, studioSourceSize, studioToneGamma, updateStudioProjectLayer, visibleStudioLayers };

package/dist/studio.d.ts

@@ -1,5 +1,5 @@
-import { S as StudioSettings, a as StudioInput, B as BLEND_MODES } from './model-BVeBDUa9.js';
-export { C as CHARACTER_SETS, D as DEFAULT_STUDIO_PRINT, b as DEFAULT_STUDIO_SETTINGS, c as DITHER_ALGORITHMS, d as DitherAlgorithm, M as MAX_STUDIO_WARPS, e as STUDIO_CHARACTER_SETS, f as STUDIO_CURVE_CHANNELS, g as STUDIO_PALETTES, h as STUDIO_PRINT_STYLES, i as STUDIO_PRINT_STYLE_IDS, j as STUDIO_STYLES, k as STUDIO_WARPS, l as StudioCurveChannel, m as StudioCurvePoint, n as StudioCurves, o as StudioLight, p as StudioMask, q as StudioPrintSettings, r as StudioPrintStyle, s as StudioStyle, t as StudioWarp, u as StudioWarpEdge, v as StudioWarpType, w as createStudioCurveLookup, x as isStudioPrintStyle, y as normalizeStudioCurve, z as normalizeStudioCurves, A as normalizeStudioPrint, E as normalizeStudioSettings, F as normalizeStudioWarps, G as parseStudioSettings, H as serializeStudioSettings, I as studioCrop, J as studioDimensions, K as studioGrid, L as updateStudioSettings } from './model-BVeBDUa9.js';
+import { S as StudioSettings, a as StudioInput, B as BLEND_MODES } from './model-BARiWJks.js';
+export { C as CHARACTER_SETS, D as DEFAULT_STUDIO_PRINT, b as DEFAULT_STUDIO_SETTINGS, c as DITHER_ALGORITHMS, d as DitherAlgorithm, M as MAX_STUDIO_WARPS, e as STUDIO_CHARACTER_SETS, f as STUDIO_CURVE_CHANNELS, g as STUDIO_PALETTES, h as STUDIO_PRINT_STYLES, i as STUDIO_PRINT_STYLE_IDS, j as STUDIO_STYLES, k as STUDIO_WARPS, l as StudioCurveChannel, m as StudioCurvePoint, n as StudioCurves, o as StudioLight, p as StudioMask, q as StudioPrintSettings, r as StudioPrintStyle, s as StudioStyle, t as StudioWarp, u as StudioWarpEdge, v as StudioWarpType, w as createStudioCurveLookup, x as isStudioPrintStyle, y as normalizeStudioCurve, z as normalizeStudioCurves, A as normalizeStudioPrint, E as normalizeStudioSettings, F as normalizeStudioWarps, G as parseStudioSettings, H as serializeStudioSettings, I as studioCrop, J as studioDimensions, K as studioGrid, L as updateStudioSettings } from './model-BARiWJks.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';
@@ -36,6 +36,19 @@ declare function restyleStudio(current: StudioSettings, random?: () => number):
 
 type StudioSource = HTMLImageElement | HTMLVideoElement | HTMLCanvasElement | ImageBitmap;
 declare function studioSourceSize(s: StudioSource): [number, number];
+/** 1st and 99th luminance percentiles of the opaque sampled cells. */
+declare function studioLevels(pixels: Uint8ClampedArray): [number, number];
+/**
+ * Ink-aware gamma for the stretched tones: lifts the subject's mean tone (cells above the near-black ground)
+ * toward half ink, within gentle bounds, so mid-tones land on glyphs with visible coverage. Bright sources keep
+ * the mild minimum lift; it never darkens.
+ */
+declare function studioToneGamma(pixels: Uint8ClampedArray, low: number, high: number): number;
+/**
+ * Tone (0–255) to glyph index by measured ink: each glyph's coverage is normalised across the ramp and every tone
+ * takes the glyph whose ink is nearest, after the mid-tone lift. Returns null when the coverage cannot be read.
+ */
+declare function inkIndexLookup(coverage: number[], gamma?: number): Uint8Array | null;
 /** Reusable bounded renderer. Call configure only when settings change; render owns no RAF. */
 declare function createStudioRenderer(canvas: HTMLCanvasElement, settings?: unknown, limits?: {
     maxDimension?: number;
@@ -353,4 +366,4 @@ interface StudioProjectExportOptions extends Omit<StudioExportOptions, 'motionTi
 /** Loads independent assets and never seeks, pauses or destroys a live preview. */
 declare function exportStudioProject(input: StudioProjectInput, sources: StudioProjectSources, options: StudioProjectExportOptions): Promise<Blob>;
 
-export { BLEND_MODES, MAX_STUDIO_LAYERS, type MountStudioOptions, type MountStudioProjectOptions, STUDIO_LOOKS, STUDIO_TEXT_FONTS, type StudioExportFormat, type StudioExportOptions, type StudioExportSource, StudioInput, type StudioLayerInput, type StudioLayerPatch, type StudioLayerPlacement, type StudioMedia, type StudioProject, type StudioProjectExportOptions, type StudioProjectFrames, type StudioProjectInput, type StudioProjectLayer, type StudioProjectLimits, type StudioProjectMedia, type StudioProjectSource, type StudioProjectSources, type StudioProjectTextSource, StudioSettings, type StudioSource, createStudioProjectRenderer, createStudioRenderer, createStudioText, exportStudio, exportStudioProject, loadStudioMedia, mountStudio, mountStudioMedia, mountStudioProject, mountStudioProjectMedia, normalizeStudioProject, parseStudioProject, restyleStudio, serializeStudioProject, studioLayerPoint, studioLook, studioProjectBudget, studioSourceSize, updateStudioProjectLayer, visibleStudioLayers };
+export { BLEND_MODES, MAX_STUDIO_LAYERS, type MountStudioOptions, type MountStudioProjectOptions, STUDIO_LOOKS, STUDIO_TEXT_FONTS, type StudioExportFormat, type StudioExportOptions, type StudioExportSource, StudioInput, type StudioLayerInput, type StudioLayerPatch, type StudioLayerPlacement, type StudioMedia, type StudioProject, type StudioProjectExportOptions, type StudioProjectFrames, type StudioProjectInput, type StudioProjectLayer, type StudioProjectLimits, type StudioProjectMedia, type StudioProjectSource, type StudioProjectSources, type StudioProjectTextSource, StudioSettings, type StudioSource, createStudioProjectRenderer, createStudioRenderer, createStudioText, exportStudio, exportStudioProject, inkIndexLookup, loadStudioMedia, mountStudio, mountStudioMedia, mountStudioProject, mountStudioProjectMedia, normalizeStudioProject, parseStudioProject, restyleStudio, serializeStudioProject, studioLayerPoint, studioLevels, studioLook, studioProjectBudget, studioSourceSize, studioToneGamma, updateStudioProjectLayer, visibleStudioLayers };