asciify-engine 1.0.105 → 1.0.107

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "asciify-engine",
-  "version": "1.0.105",
+  "version": "1.0.107",
   "description": "Framework-agnostic ASCII art engine. Convert images, videos, and GIFs into ASCII art rendered on canvas.",
   "type": "module",
   "main": "./dist/index.cjs",

package/skills/asciify-engine/SKILL.md

@@ -8,7 +8,7 @@ description: Convert images, videos, GIFs, webcam streams, text, and animated ba
 Use this skill for the `asciify-engine` npm package.
 
 **Package:** `asciify-engine`  
-**Current version:** `1.0.105`  
+**Current version:** `1.0.107`  
 **Playground:** https://asciify.org  
 **GitHub:** https://github.com/ayangabryl/asciify-engine
 
@@ -36,7 +36,7 @@ npm install asciify-engine
 For existing apps, install the latest tested version:
 
 ```bash
-npm install asciify-engine@1.0.105
+npm install asciify-engine@1.0.107
 ```
 
 ## Mental Model
@@ -90,6 +90,8 @@ options: {
 
 For centered crops, `sourceCrop: { height: 0.7 }` keeps 70% of the source and preserves the original source aspect. `preserveAspect` is only for single-dimension `width`/`height` crops; do not use it to force hero bands. For wide heroes, crop with `top`/`bottom` and let the engine derive the cropped aspect. `sourceCrop` is opt-in; when omitted, the engine samples the full source exactly as older versions did.
 
+When `sourceCrop` and `chromaKey` are both enabled for video, `asciifyVideo` does a one-time foreground trim inside the crop window. For scrubbed or trimmed video it samples the playback range and uses the union of the keyed foreground bounds. This removes keyed empty margins before layout sizing, which is the right fix when the canvas is full width but the visible ASCII subject still appears short on one side.
+
 Use top-level `asciifyVideo` layout options when the destination needs full-bleed framing. These affect the visible canvas only, not the sampled media:
 
 ```ts
@@ -111,7 +113,7 @@ Mental split:
 - `sourceCrop` chooses the source window before ASCII conversion.
 - CSS-like insets change the crop aspect naturally; the engine keeps ASCII proportions intact.
 - `objectFit`, `objectPosition`, `scale`, `width`, and `height` place the rendered canvas in the page.
-- Use `objectFit: 'cover'` for full-width/full-bleed heroes.
+- Use `objectFit: 'cover'` for full-width/full-bleed heroes and backgrounds.
 - Use `objectFit: 'contain'` for previews where the whole source should remain visible.
 - Use `scale` for gentle overfill instead of CSS width hacks like `110vw`.
 
@@ -164,7 +166,7 @@ Recommended starting point:
 ```ts
 {
   fitTo: hero,
-  objectFit: 'contain',
+  objectFit: 'cover',
   objectPosition: 'center bottom',
   width: '100%',
   height: '100%',