asciify-engine 1.0.54 → 1.0.55

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,14 @@ 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 ART_STYLE_PRESETS = {
   classic: {
@@ -96,6 +103,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 = {