asciify-engine 4.5.0 → 4.7.0

package/README.md

@@ -566,3 +566,31 @@ All motion choices repeat every `12 / speed` seconds. Still exports preserve the
 Studio adds `dither.algorithm: 'blue-noise'`: a stable precomputed dispersed pattern with no runtime generation or asset download. `noise` remains white noise. Choose the algorithm from `DITHER_ALGORITHMS`; drift and shimmer remain independently controlled.
 
 Recover usable shadow/highlight separation before conversion with `color.gamma`, `shadows`, `highlights`, `blackPoint` and `whitePoint`. All 18 styles share these controls and retain neutral defaults. They are a bounded monotone tonal curve, not arbitrary per-channel curve editing. See [exact ranges, sampling budgets and a live-project example](skills/asciify-engine/references/studio-workspace.md#tonal-detail-and-blue-noise-45).
+
+### Channel curves and source noise reduction (4.6)
+
+Studio adds editable RGB, red, green and blue curves, with up to 16 control points each, plus optional edge-preserving source noise reduction. They apply before every render style and travel with saved settings and exports. Defaults preserve existing output. Curves use small cached lookups; still images reuse filtered pixels while hover/motion run. Dense video filtering is an explicit CPU tradeoff.
+
+```ts
+player.update({color:{
+  denoise:.25,
+  curves:{rgb:[[0,0],[.25,.2],[.75,.8],[1,1]]},
+}});
+const settings = player.settings; // detached snapshot for save/export
+```
+
+See [settings, normalization, processing order and performance guidance](skills/asciify-engine/references/studio-workspace.md#channel-curves-and-source-noise-46). Curves are local source controls, not another art-style alias or AI restoration.
+
+### Ordered source shaping (4.7)
+
+Combine up to eight source transformations before ASCII, dither or any Studio style: Twirl, Pinch, Spherize, Ripple, Zigzag, Shear, Smudge, Polar and Fragment. Edit strength, position and radius, plus direction/frequency where applicable. Reorder or disable stages without losing their settings; choose extended or transparent edges. Generate controls from `STUDIO_WARPS` and `MAX_STUDIO_WARPS`.
+
+```ts
+player.update({
+  warps: [{type:'sphere',amount:.3,radius:.7}, {type:'shear',amount:.15,angle:25}],
+  warpEdge:'clamp',
+  motion:{type:'parallax',amount:.5},
+});
+```
+
+The stack is static shaping; motion and pointer hover remain independent. Coordinate maps are cached across video frames, and stills reuse shaped pixels during interaction. Empty stacks are free of additional pixel work. Defaults and root/core/hover behavior remain unchanged. Dither motion also gains alpha-correct interpolation at transparent edges. See [parameters, order, persistence/export and measured CPU tradeoffs](skills/asciify-engine/references/source-shaping.md).

package/dist/core.d.cts

@@ -1,6 +1,6 @@
 import { a as AsciiOptions, A as AsciiFrame, b as ArtStyle, H as HoverEffect } from './types-D38BMBRB.cjs';
 export { c as AnimationStyle, d as AsciiCell, e as AsciiResult, C as ColorMode, D as DEFAULT_OPTIONS, f as HOVER_PRESETS, g as HoverPreset, h as HoverShape, P as PALETTE_THEMES, i as PaletteTheme, R as RenderMode, S as SourceType } from './types-D38BMBRB.cjs';
-export { C as CHARACTER_SETS, f as STUDIO_STYLES, i as StudioStyle } from './model-BLvrvOKA.cjs';
+export { C as CHARACTER_SETS, g as STUDIO_STYLES, n as StudioStyle } from './model-fP9NdG-w.cjs';
 import './hover-catalog-BeIkNwhH.cjs';
 
 /**

package/dist/core.d.ts

@@ -1,6 +1,6 @@
 import { a as AsciiOptions, A as AsciiFrame, b as ArtStyle, H as HoverEffect } from './types-C05AfrjT.js';
 export { c as AnimationStyle, d as AsciiCell, e as AsciiResult, C as ColorMode, D as DEFAULT_OPTIONS, f as HOVER_PRESETS, g as HoverPreset, h as HoverShape, P as PALETTE_THEMES, i as PaletteTheme, R as RenderMode, S as SourceType } from './types-C05AfrjT.js';
-export { C as CHARACTER_SETS, f as STUDIO_STYLES, i as StudioStyle } from './model-DVm46H2S.js';
+export { C as CHARACTER_SETS, g as STUDIO_STYLES, n as StudioStyle } from './model-CMKdRB30.js';
 import './hover-catalog-BeIkNwhH.js';
 
 /**

package/dist/index.d.cts

@@ -1,4 +1,4 @@
 export { c as AnimationStyle, b as ArtStyle, d as AsciiCell, A as AsciiFrame, a as AsciiOptions, e as AsciiResult, C as ColorMode, D as DEFAULT_OPTIONS, f as HOVER_PRESETS, H as HoverEffect, g as HoverPreset, h as HoverShape, P as PALETTE_THEMES, i as PaletteTheme, R as RenderMode, S as SourceType } from './types-D38BMBRB.cjs';
 export { AsciiTextFrame, AsciifyLiveVideoOptions, AsciifySimpleOptions, AsciifyVideoOptions, BigTextOptions, CanvasBleed, CanvasObjectFit, CanvasRenderSizeInput, SnapshotOptions, TextBackgroundOptions, VideoScrollScrubOptions, WebcamOptions, asciiText, asciiTextAnsi, asciify, asciifyGif, asciifyLiveVideo, asciifyText, asciifyVideo, asciifyWebcam, buildTextFrame, captureSnapshot, clearAsciifyCaches, computeCanvasRenderSize, createVideoScrollScrub, gifToAsciiFrames, gifToAsciiTextFrames, imageToAsciiFrame, imageToAsciiTextFrame, renderFrameToCanvas, renderTextBackground, renderTextFrameToCanvas, renderTextToCanvas, snapshotAndDownload, videoToAsciiFrames, videoToAsciiTextFrames } from './core.cjs';
-export { C as CHARACTER_SETS, f as STUDIO_STYLES, i as StudioStyle } from './model-BLvrvOKA.cjs';
+export { C as CHARACTER_SETS, g as STUDIO_STYLES, n as StudioStyle } from './model-fP9NdG-w.cjs';
 import './hover-catalog-BeIkNwhH.cjs';

package/dist/index.d.ts

@@ -1,4 +1,4 @@
 export { c as AnimationStyle, b as ArtStyle, d as AsciiCell, A as AsciiFrame, a as AsciiOptions, e as AsciiResult, C as ColorMode, D as DEFAULT_OPTIONS, f as HOVER_PRESETS, H as HoverEffect, g as HoverPreset, h as HoverShape, P as PALETTE_THEMES, i as PaletteTheme, R as RenderMode, S as SourceType } from './types-C05AfrjT.js';
 export { AsciiTextFrame, AsciifyLiveVideoOptions, AsciifySimpleOptions, AsciifyVideoOptions, BigTextOptions, CanvasBleed, CanvasObjectFit, CanvasRenderSizeInput, SnapshotOptions, TextBackgroundOptions, VideoScrollScrubOptions, WebcamOptions, asciiText, asciiTextAnsi, asciify, asciifyGif, asciifyLiveVideo, asciifyText, asciifyVideo, asciifyWebcam, buildTextFrame, captureSnapshot, clearAsciifyCaches, computeCanvasRenderSize, createVideoScrollScrub, gifToAsciiFrames, gifToAsciiTextFrames, imageToAsciiFrame, imageToAsciiTextFrame, renderFrameToCanvas, renderTextBackground, renderTextFrameToCanvas, renderTextToCanvas, snapshotAndDownload, videoToAsciiFrames, videoToAsciiTextFrames } from './core.js';
-export { C as CHARACTER_SETS, f as STUDIO_STYLES, i as StudioStyle } from './model-DVm46H2S.js';
+export { C as CHARACTER_SETS, g as STUDIO_STYLES, n as StudioStyle } from './model-CMKdRB30.js';
 import './hover-catalog-BeIkNwhH.js';

package/dist/{model-DVm46H2S.d.ts → model-CMKdRB30.d.ts}

@@ -70,6 +70,93 @@ declare const STUDIO_CHARACTER_SETS: {
     };
 };
 
+/** Input/output coordinates use 0–1. Curves have at most 16 points, including endpoints. */
+type StudioCurvePoint = [number, number];
+declare const STUDIO_CURVE_CHANNELS: readonly ["rgb", "red", "green", "blue"];
+type StudioCurveChannel = typeof STUDIO_CURVE_CHANNELS[number];
+type StudioCurves = Record<StudioCurveChannel, StudioCurvePoint[]>;
+/** Accept saved settings safely. Repeated inputs keep the last valid point. */
+declare function normalizeStudioCurve(input: unknown): StudioCurvePoint[];
+declare function normalizeStudioCurves(input: unknown): StudioCurves;
+/** Shape-preserving cubic interpolation: no overshoot between control points.
+ * The same 256 samples drive the editor graph and the pre-conversion transform.
+ * Build on settings changes, never inside the per-pixel loop.
+ */
+declare function createStudioCurveLookup(input: unknown): Uint8Array;
+
+/** Source transformations, applied in list order before style conversion. */
+declare const STUDIO_WARPS: readonly [{
+    readonly value: "twirl";
+    readonly label: "Twirl";
+    readonly description: "Rotate the center into a smooth spiral; the outer boundary stays fixed.";
+    readonly direction: false;
+    readonly frequency: false;
+}, {
+    readonly value: "pinch";
+    readonly label: "Pinch";
+    readonly description: "Contract the center, or expand it with negative strength.";
+    readonly direction: false;
+    readonly frequency: false;
+}, {
+    readonly value: "sphere";
+    readonly label: "Spherize";
+    readonly description: "Magnify a rounded lens through the source; negative strength recedes.";
+    readonly direction: false;
+    readonly frequency: false;
+}, {
+    readonly value: "ripple";
+    readonly label: "Ripple";
+    readonly description: "Bend the image through concentric, soft-edged waves.";
+    readonly direction: false;
+    readonly frequency: true;
+}, {
+    readonly value: "zigzag";
+    readonly label: "Zigzag";
+    readonly description: "Alternate the twist in sharp, concentric bands.";
+    readonly direction: false;
+    readonly frequency: true;
+}, {
+    readonly value: "shear";
+    readonly label: "Shear";
+    readonly description: "Slant a region along an adjustable direction.";
+    readonly direction: true;
+    readonly frequency: false;
+}, {
+    readonly value: "smudge";
+    readonly label: "Smudge";
+    readonly description: "Draw a soft region of the source along one direction.";
+    readonly direction: true;
+    readonly frequency: false;
+}, {
+    readonly value: "polar";
+    readonly label: "Polar";
+    readonly description: "Unwrap a region into polar coordinates; negative strength wraps it.";
+    readonly direction: true;
+    readonly frequency: false;
+}, {
+    readonly value: "fragment";
+    readonly label: "Fragment";
+    readonly description: "Offset small source tiles into a stable fractured texture.";
+    readonly direction: true;
+    readonly frequency: true;
+}];
+type StudioWarpType = typeof STUDIO_WARPS[number]['value'];
+interface StudioWarp {
+    type: StudioWarpType;
+    enabled?: boolean;
+    amount?: number;
+    x?: number;
+    y?: number;
+    /** Radius as a fraction of the canvas's shorter side. */
+    radius?: number;
+    angle?: number;
+    frequency?: number;
+}
+type StudioWarpEdge = 'clamp' | 'transparent';
+declare const MAX_STUDIO_WARPS = 8;
+/** Unknown types are omitted, never silently converted into a different warp. */
+declare function normalizeStudioWarps(input: unknown): Required<StudioWarp>[];
+
 /** 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", "hex", "led", "cmyk"];
 type StudioStyle = (typeof STUDIO_STYLES)[number];
@@ -107,6 +194,8 @@ interface StudioSettings {
         zoom: number;
         rotation: number;
     };
+    warps?: StudioWarp[];
+    warpEdge?: StudioWarpEdge;
     backdrop: {
         mode: "solid" | "transparent" | "source" | "blurred" | "gradient";
         color: string;
@@ -127,6 +216,8 @@ interface StudioSettings {
         gamma?: number;
         shadows?: number;
         highlights?: number;
+        curves?: Partial<StudioCurves>;
+        denoise?: number;
     };
     dither: {
         algorithm: DitherAlgorithm;
@@ -209,4 +300,4 @@ declare function studioGrid(width: number, height: number, settings: Pick<Studio
     limited: boolean;
 };
 
-export { BLEND_MODES as B, CHARACTER_SETS as C, DEFAULT_STUDIO_SETTINGS as D, type StudioSettings as S, type StudioInput as a, DITHER_ALGORITHMS as b, type DitherAlgorithm as c, STUDIO_CHARACTER_SETS as d, STUDIO_PALETTES as e, STUDIO_STYLES as f, type StudioLight as g, type StudioMask as h, type StudioStyle as i, studioCrop as j, studioDimensions as k, studioGrid as l, normalizeStudioSettings as n, parseStudioSettings as p, serializeStudioSettings as s, updateStudioSettings as u };
+export { studioGrid as A, BLEND_MODES as B, CHARACTER_SETS as C, DEFAULT_STUDIO_SETTINGS as D, updateStudioSettings as E, MAX_STUDIO_WARPS as M, type StudioSettings as S, type StudioInput as a, DITHER_ALGORITHMS as b, type DitherAlgorithm as c, STUDIO_CHARACTER_SETS as d, STUDIO_CURVE_CHANNELS as e, STUDIO_PALETTES as f, STUDIO_STYLES as g, STUDIO_WARPS as h, type StudioCurveChannel as i, type StudioCurvePoint as j, type StudioCurves as k, type StudioLight as l, type StudioMask as m, type StudioStyle as n, type StudioWarp as o, type StudioWarpEdge as p, type StudioWarpType as q, createStudioCurveLookup as r, normalizeStudioCurve as s, normalizeStudioCurves as t, normalizeStudioSettings as u, normalizeStudioWarps as v, parseStudioSettings as w, serializeStudioSettings as x, studioCrop as y, studioDimensions as z };

package/dist/{model-BLvrvOKA.d.cts → model-fP9NdG-w.d.cts}

@@ -70,6 +70,93 @@ declare const STUDIO_CHARACTER_SETS: {
     };
 };
 
+/** Input/output coordinates use 0–1. Curves have at most 16 points, including endpoints. */
+type StudioCurvePoint = [number, number];
+declare const STUDIO_CURVE_CHANNELS: readonly ["rgb", "red", "green", "blue"];
+type StudioCurveChannel = typeof STUDIO_CURVE_CHANNELS[number];
+type StudioCurves = Record<StudioCurveChannel, StudioCurvePoint[]>;
+/** Accept saved settings safely. Repeated inputs keep the last valid point. */
+declare function normalizeStudioCurve(input: unknown): StudioCurvePoint[];
+declare function normalizeStudioCurves(input: unknown): StudioCurves;
+/** Shape-preserving cubic interpolation: no overshoot between control points.
+ * The same 256 samples drive the editor graph and the pre-conversion transform.
+ * Build on settings changes, never inside the per-pixel loop.
+ */
+declare function createStudioCurveLookup(input: unknown): Uint8Array;
+
+/** Source transformations, applied in list order before style conversion. */
+declare const STUDIO_WARPS: readonly [{
+    readonly value: "twirl";
+    readonly label: "Twirl";
+    readonly description: "Rotate the center into a smooth spiral; the outer boundary stays fixed.";
+    readonly direction: false;
+    readonly frequency: false;
+}, {
+    readonly value: "pinch";
+    readonly label: "Pinch";
+    readonly description: "Contract the center, or expand it with negative strength.";
+    readonly direction: false;
+    readonly frequency: false;
+}, {
+    readonly value: "sphere";
+    readonly label: "Spherize";
+    readonly description: "Magnify a rounded lens through the source; negative strength recedes.";
+    readonly direction: false;
+    readonly frequency: false;
+}, {
+    readonly value: "ripple";
+    readonly label: "Ripple";
+    readonly description: "Bend the image through concentric, soft-edged waves.";
+    readonly direction: false;
+    readonly frequency: true;
+}, {
+    readonly value: "zigzag";
+    readonly label: "Zigzag";
+    readonly description: "Alternate the twist in sharp, concentric bands.";
+    readonly direction: false;
+    readonly frequency: true;
+}, {
+    readonly value: "shear";
+    readonly label: "Shear";
+    readonly description: "Slant a region along an adjustable direction.";
+    readonly direction: true;
+    readonly frequency: false;
+}, {
+    readonly value: "smudge";
+    readonly label: "Smudge";
+    readonly description: "Draw a soft region of the source along one direction.";
+    readonly direction: true;
+    readonly frequency: false;
+}, {
+    readonly value: "polar";
+    readonly label: "Polar";
+    readonly description: "Unwrap a region into polar coordinates; negative strength wraps it.";
+    readonly direction: true;
+    readonly frequency: false;
+}, {
+    readonly value: "fragment";
+    readonly label: "Fragment";
+    readonly description: "Offset small source tiles into a stable fractured texture.";
+    readonly direction: true;
+    readonly frequency: true;
+}];
+type StudioWarpType = typeof STUDIO_WARPS[number]['value'];
+interface StudioWarp {
+    type: StudioWarpType;
+    enabled?: boolean;
+    amount?: number;
+    x?: number;
+    y?: number;
+    /** Radius as a fraction of the canvas's shorter side. */
+    radius?: number;
+    angle?: number;
+    frequency?: number;
+}
+type StudioWarpEdge = 'clamp' | 'transparent';
+declare const MAX_STUDIO_WARPS = 8;
+/** Unknown types are omitted, never silently converted into a different warp. */
+declare function normalizeStudioWarps(input: unknown): Required<StudioWarp>[];
+
 /** 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", "hex", "led", "cmyk"];
 type StudioStyle = (typeof STUDIO_STYLES)[number];
@@ -107,6 +194,8 @@ interface StudioSettings {
         zoom: number;
         rotation: number;
     };
+    warps?: StudioWarp[];
+    warpEdge?: StudioWarpEdge;
     backdrop: {
         mode: "solid" | "transparent" | "source" | "blurred" | "gradient";
         color: string;
@@ -127,6 +216,8 @@ interface StudioSettings {
         gamma?: number;
         shadows?: number;
         highlights?: number;
+        curves?: Partial<StudioCurves>;
+        denoise?: number;
     };
     dither: {
         algorithm: DitherAlgorithm;
@@ -209,4 +300,4 @@ declare function studioGrid(width: number, height: number, settings: Pick<Studio
     limited: boolean;
 };
 
-export { BLEND_MODES as B, CHARACTER_SETS as C, DEFAULT_STUDIO_SETTINGS as D, type StudioSettings as S, type StudioInput as a, DITHER_ALGORITHMS as b, type DitherAlgorithm as c, STUDIO_CHARACTER_SETS as d, STUDIO_PALETTES as e, STUDIO_STYLES as f, type StudioLight as g, type StudioMask as h, type StudioStyle as i, studioCrop as j, studioDimensions as k, studioGrid as l, normalizeStudioSettings as n, parseStudioSettings as p, serializeStudioSettings as s, updateStudioSettings as u };
+export { studioGrid as A, BLEND_MODES as B, CHARACTER_SETS as C, DEFAULT_STUDIO_SETTINGS as D, updateStudioSettings as E, MAX_STUDIO_WARPS as M, type StudioSettings as S, type StudioInput as a, DITHER_ALGORITHMS as b, type DitherAlgorithm as c, STUDIO_CHARACTER_SETS as d, STUDIO_CURVE_CHANNELS as e, STUDIO_PALETTES as f, STUDIO_STYLES as g, STUDIO_WARPS as h, type StudioCurveChannel as i, type StudioCurvePoint as j, type StudioCurves as k, type StudioLight as l, type StudioMask as m, type StudioStyle as n, type StudioWarp as o, type StudioWarpEdge as p, type StudioWarpType as q, createStudioCurveLookup as r, normalizeStudioCurve as s, normalizeStudioCurves as t, normalizeStudioSettings as u, normalizeStudioWarps as v, parseStudioSettings as w, serializeStudioSettings as x, studioCrop as y, studioDimensions as z };