asciify-engine 1.0.94 → 1.0.96

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "asciify-engine",
-  "version": "1.0.94",
+  "version": "1.0.96",
   "description": "Framework-agnostic ASCII art engine. Convert images, videos, and GIFs into ASCII art rendered on canvas.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -20,7 +20,7 @@
   },
   "files": [
     "dist",
-    ".agents/skills/asciify-engine",
+    "skills/asciify-engine",
     "README.md",
     "LICENSE"
   ],
@@ -101,7 +101,7 @@
   "homepage": "https://asciify.org",
   "repository": {
     "type": "git",
-    "url": "https://github.com/ayangabryl/asciify-engine"
+    "url": "git+https://github.com/ayangabryl/asciify-engine.git"
   },
   "dependencies": {
     "gifuct-js": "^2.1.2"

package/{.agents/skills → 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.93`  
+**Current version:** `1.0.96`  
 **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.93
+npm install asciify-engine@1.0.96
 ```
 
 ## Mental Model
@@ -64,15 +64,15 @@ Use legacy object frames only when you need per-cell mutation, dots mode, heavy
 - `gifToAsciiFrames()`
 - `renderFrameToCanvas()`
 
-Use `options.sourceCrop` when the source media has empty edges or needs tighter framing without changing the destination canvas size. Percent values are normalized `0–1` by default:
+Use `options.sourceCrop` when the source media has empty edges or needs tighter framing without changing the destination canvas size. Percent values are normalized `0–1` by default. Passing only `height` or only `width` preserves source proportions and centers the crop:
 
 ```ts
 options: {
-  sourceCrop: { y: 0.16, height: 0.62 },
+  sourceCrop: { height: 0.7 },
 }
 ```
 
-`sourceCrop` is opt-in. When omitted, the engine samples the full source exactly as older versions did.
+Set `x`, `y`, `width`, and `height` together only when manual framing is needed. `sourceCrop` is opt-in; when omitted, the engine samples the full source exactly as older versions did.
 
 ## Visual Target
 
@@ -221,7 +221,7 @@ await asciifyVideo(video, canvas, {
   fitTo: hero,
   options: {
     chromaKey: true,
-    sourceCrop: { y: 0.16, height: 0.62 },
+    sourceCrop: { height: 0.7 },
   },
 });
 ```