asciify-engine 1.0.54 → 1.0.56

package/README.md

@@ -126,12 +126,12 @@ All conversion and render functions accept an `AsciiOptions` object. Spread `DEF
 | `charset` | `string` | Standard ramp | Characters ordered from dense to sparse, representing brightness levels. |
 | `brightness` | `number` | `0` | Brightness adjustment from `-1` (darker) to `1` (lighter). |
 | `contrast` | `number` | `1` | Contrast multiplier applied before character mapping. |
-| `invert` | `boolean` | `false` | Inverts the luminance mapping — light areas become dense, dark areas sparse. |
+| `invert` | `boolean \| 'auto'` | `false` | Inverts the luminance mapping — light areas become dense, dark areas sparse. Set to `'auto'` to auto-detect from OS color scheme (light mode → invert, dark mode → normal). |
 | `renderMode` | `'ascii' \| 'dots'` | `'ascii'` | Render as text characters or circular dot particles. |
 | `hoverEffect` | `string` | `'none'` | Interactive effect driven by cursor position. See hover effects below. |
 | `hoverStrength` | `number` | `0` | Effect intensity (0–1). `0` = hover disabled. |
 | `hoverRadius` | `number` | `0.2` | Effect radius relative to canvas size (0–1). |
-| `chromaKey` | `{r,g,b} \| string \| null` | `null` | Remove a background colour (green/blue screen). Keyed pixels become transparent spaces. Accepts `{r,g,b}`, any CSS colour string, or `null` to disable. |
+| `chromaKey` | `true \| 'blue-screen' \| {r,g,b} \| string \| null` | `null` | Remove a background colour. `true` = heuristic green screen (any shade). `'blue-screen'` = heuristic blue screen. Custom: `{r,g,b}` or any CSS hex string keyed by Euclidean distance. `null` to disable. |
 | `chromaKeyTolerance` | `number` | `60` | Euclidean RGB distance threshold for chroma-key detection. `0` = exact match, higher = more pixels removed (max useful ~100). |
 
 ### Chroma Key (Green/Blue Screen)
@@ -148,7 +148,7 @@ asciify(img, canvas, {
 
 // Blue screen
 asciify(img, canvas, {
-  options: { ...DEFAULT_OPTIONS, chromaKey: 'blue', chromaKeyTolerance: 70 },
+  options: { ...DEFAULT_OPTIONS, chromaKey: 'blue-screen', chromaKeyTolerance: 70 },
 });
 
 // Custom RGB key
@@ -238,7 +238,7 @@ stop();
 | `fontSize` | `number` | `13` | Character size in pixels. |
 | `speed` | `number` | `1` | Global animation speed multiplier. |
 | `density` | `number` | `0.55` | Fraction of grid cells that are active (0–1). |
-| `accentColor` | `string` | varies | Highlight or leading-character color (any CSS color string). |
+| `accentColor` | `string \| 'auto'` | varies | Highlight or leading-character color (any CSS hex string). Set to `'auto'` to auto-detect: probes `--accent-color`, `--color-accent`, `--accent`, `--primary` CSS variables on `:root`, then falls back to OS color scheme (dark ink in light mode, light ink in dark mode). |
 | `color` | `string` | — | Override the body character color. |
 
 ---
@@ -304,7 +304,7 @@ const animatedHtml = generateAnimatedEmbedCode(frames, options, fps);
 | `generateEmbedCode` | `(frame, options)` | `string` |
 | `generateAnimatedEmbedCode` | `(frames, options, fps)` | `string` |
 
-`asciifyVideo` options: `fitTo` (HTMLElement/selector — fits canvas to container + ResizeObserver), `preExtract` (pre-decode all frames, default false), `onReady(video)`, `onFrame()`
+`asciifyVideo` options: `fitTo` (HTMLElement/selector — fits canvas to container + ResizeObserver), `preExtract` (pre-decode all frames, default false), `trim: { start?: number; end?: number }` (loop a time slice in seconds, accepts floats), `onReady(video)`, `onFrame()`
 
 ---
 

package/dist/index.cjs

@@ -26,7 +26,32 @@ var CHARSETS = {
   katakana: " \uFF66\uFF67\uFF68\uFF69\uFF6A\uFF6B\uFF6C\uFF6D\uFF6E\uFF6F\uFF71\uFF72\uFF73\uFF74\uFF75\uFF76\uFF77\uFF78\uFF79\uFF7A\uFF7B\uFF7C\uFF7D\uFF7E\uFF7F\uFF80\uFF81\uFF82\uFF83\uFF84\uFF85\uFF86\uFF87\uFF88\uFF89\uFF8A\uFF8B\uFF8C\uFF8D\uFF8E\uFF8F\uFF90\uFF91\uFF92\uFF93\uFF94\uFF95\uFF96\uFF97\uFF98\uFF99\uFF9A\uFF9B\uFF9C\uFF9D",
   musical: " \u2669\u266A\u266B\u266C\u266D\u266E\u266F",
   emoji: " \u2B1B\u{1F7EB}\u{1F7E5}\u{1F7E7}\u{1F7E8}\u{1F7E9}\u{1F7E6}\u{1F7EA}\u2B1C",
-  circles: " .\xB7:\u2218\u25CB\u25E6\xB0\u2022\u2219"
+  circles: " .\xB7:\u2218\u25CB\u25E6\xB0\u2022\u2219",
+  shadows: " \xB7\u2218\u25E6\u25CB\u25CE\u2299\u25CF\u25C9",
+  starfield: " \u02D9\xB7\u2218\u2217\u2726\u2727\u2605\u25C6\u25CF",
+  geometric: " \xB7\u25B3\u25B7\u25C7\u25C8\u25C6\u25A3\u25A0\u2588",
+  pipes: " \u2576\u2500\u2510\u2514\u251C\u2524\u252C\u2534\u253C\u256C\u2592\u2593\u2588",
+  waves: " \u02DC\u223C\u2248\u3030\u224B\u223F\u223E\u222D\u222B",
+  shards: " \u2571\u2572\u2573\u25E4\u25E5\u25E3\u25E2\u25B3\u25B2\u25C6\u25FC\u2588",
+  smoke: " \xB7\u02D9\u205A\u2056\u2236\u2237\u22EE\u22F0\u22F1\u2234\u2235"
+};
+var CHARSET_SEQUENCES = {
+  /** Stars → softcircles → orbs — dreamy space feel */
+  cosmic: [CHARSETS.starfield, CHARSETS.circles, CHARSETS.shadows],
+  /** Katakana → braille dots → binary — hacker rain */
+  rain: [CHARSETS.katakana, CHARSETS.braille, CHARSETS.binary],
+  /** Box pipes → Claude glyphs → classic — terminal morph */
+  terminal: [CHARSETS.pipes, CHARSETS.claudeCode, CHARSETS.standard],
+  /** Shards → blocks → squares — shattering crystal */
+  crystal: [CHARSETS.shards, CHARSETS.geometric, CHARSETS.blocks],
+  /** Wave glyphs → smoke dots → circles — fluid / organic */
+  fluid: [CHARSETS.waves, CHARSETS.smoke, CHARSETS.circles],
+  /** Dense classic → art → blocks — maximum detail pulse */
+  pulse: [CHARSETS.dense, CHARSETS.standard, CHARSETS.blocks],
+  /** Braille → shadows → smoke — ethereal / dream-like */
+  dream: [CHARSETS.braille, CHARSETS.shadows, CHARSETS.smoke],
+  /** Geometric shapes → shards → starfield — sci-fi angular */
+  angular: [CHARSETS.geometric, CHARSETS.shards, CHARSETS.starfield]
 };
 var ART_STYLE_PRESETS = {
   classic: {
@@ -96,6 +121,44 @@ var ART_STYLE_PRESETS = {
     charset: CHARSETS.circles,
     colorMode: "accent",
     accentColor: "#d4ff00"
+  },
+  shadows: {
+    renderMode: "ascii",
+    charset: CHARSETS.shadows,
+    colorMode: "accent",
+    accentColor: "#50a0ff"
+  },
+  starfield: {
+    renderMode: "ascii",
+    charset: CHARSETS.starfield,
+    colorMode: "fullcolor"
+  },
+  geometric: {
+    renderMode: "ascii",
+    charset: CHARSETS.geometric,
+    colorMode: "grayscale"
+  },
+  pipes: {
+    renderMode: "ascii",
+    charset: CHARSETS.pipes,
+    colorMode: "accent",
+    accentColor: "#00ff88"
+  },
+  waves: {
+    renderMode: "ascii",
+    charset: CHARSETS.waves,
+    colorMode: "fullcolor"
+  },
+  shards: {
+    renderMode: "ascii",
+    charset: CHARSETS.shards,
+    colorMode: "grayscale"
+  },
+  smoke: {
+    renderMode: "ascii",
+    charset: CHARSETS.smoke,
+    colorMode: "accent",
+    accentColor: "#c850ff"
   }
 };
 var DEFAULT_OPTIONS = {
@@ -724,7 +787,7 @@ function imageToAsciiFrame(source, options, targetWidth, targetHeight) {
       const adjustedLum = adjustLuminance(lum, options.brightness, options.contrast);
       const ditheredLum = applyDither(adjustedLum, x, y, options.ditherStrength);
       const char = options.customText ? customTextToChar(ditheredLum, options.customText, x, y, cols, invertVal) : luminanceToChar(ditheredLum, options.charset, invertVal);
-      row.push({ char, r, g, b, a });
+      row.push({ char, r, g, b, a, lum: ditheredLum });
     }
     frame.push(row);
   }
@@ -968,9 +1031,12 @@ function renderFrameToCanvas(ctx, frame, options, canvasWidth, canvasHeight, tim
       ctx.textBaseline = "middle";
     }
     let charWeights = null;
+    const dynFrms = options.charsetFrames;
+    const hasDyn = !!dynFrms?.length;
+    const dynCharset = hasDyn ? dynFrms[Math.floor(Math.max(0, time) * (options.charsetFps ?? 2)) % dynFrms.length] : options.charset;
     if (useFastRect) {
       charWeights = {};
-      const csChars = [...options.charset];
+      const csChars = [...dynCharset];
       const csLen = csChars.length;
       for (let i = 0; i < csLen; i++) {
         charWeights[csChars[i]] = Math.max(0.1, (i + 0.3) / csLen);
@@ -981,7 +1047,9 @@ function renderFrameToCanvas(ctx, frame, options, canvasWidth, canvasHeight, tim
       const rowData = frame[y];
       for (let x = 0; x < cols; x++) {
         const cell = rowData[x];
-        if (cell.char === " " || cell.a < 10) continue;
+        if (cell.a < 10) continue;
+        const drawChar = hasDyn && cell.lum != null ? luminanceToChar(cell.lum, dynCharset, isInverted) : cell.char;
+        if (drawChar === " ") continue;
         const animMul = noAnimation ? 1 : getAnimationMultiplier(x, y, cols, rows, time, animStyle, animSpeed);
         if (animMul < 0.05) continue;
         let hoverScale = 1;
@@ -1021,7 +1089,7 @@ function renderFrameToCanvas(ctx, frame, options, canvasWidth, canvasHeight, tim
           color = getCellColorStr(cell, colorMode, acR, acG, acB, isInverted);
         }
         if (useFastRect) {
-          const weight = charWeights[cell.char] ?? 0.5;
+          const weight = charWeights[drawChar] ?? 0.5;
           const effAlpha = Math.min(1, cell.a * 0.00392156863 * animMul * (1 + hoverGlow)) * weight;
           if (effAlpha < 0.02) continue;
           if (effAlpha !== lastAlpha) {
@@ -1048,10 +1116,10 @@ function renderFrameToCanvas(ctx, frame, options, canvasWidth, canvasHeight, tim
           if (hoverScale !== 1) {
             ctx.translate(px, py);
             ctx.scale(hoverScale, hoverScale);
-            ctx.fillText(cell.char, 0, 0);
+            ctx.fillText(drawChar, 0, 0);
             ctx.setTransform(baseTransform);
           } else {
-            ctx.fillText(cell.char, px, py);
+            ctx.fillText(drawChar, px, py);
           }
         }
       }
@@ -2645,6 +2713,7 @@ async function asciifyWebcam(canvas, {
 exports.ART_STYLE_PRESETS = ART_STYLE_PRESETS;
 exports.BACKGROUND_TYPES = BACKGROUND_TYPES;
 exports.CHARSETS = CHARSETS;
+exports.CHARSET_SEQUENCES = CHARSET_SEQUENCES;
 exports.DEFAULT_OPTIONS = DEFAULT_OPTIONS;
 exports.HOVER_PRESETS = HOVER_PRESETS;
 exports.PALETTE_THEMES = PALETTE_THEMES;