@makefully/dutifully 1.15.0 → 1.16.0

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 1.16.0
+
+- Add `classfully` service client for approximating images as CSS class rules.
+
 ## 1.15.0
 
 - Skip unchanged Sharp, Packfully, and Stackfully image outputs via embedded per-service metadata hashes (`CheerfullySharpHash`, `CheerfullyPackfullyHash`, `CheerfullyStackfullyHash`).

package/README.md

@@ -156,6 +156,33 @@ Spacing: `padding` is empty gap beyond `extrude`; `extrude` is edge-pixel bleed
 
 Up-to-date atlas PNGs are skipped via an embedded `CheerfullyPackfullyHash` (source bytes + options). Descriptor files (json/css/atlas/xml) are not hash carriers.
 
+### Classfully
+
+This image-to-CSS service approximates still images as a CSS class rule (deterministic mutation search scored via headless Chromium screenshots). Every image under `src` is processed; `files` overrides are optional.
+
+```javascript
+{
+    "classfully": [{
+        "src": "./example/classfully/",
+        "output": "./example/classfully/out/",
+        "options": {
+            "maxIterations": 40,
+            "minAccuracy": 0.9,
+            "maxMutations": 256
+        },
+        "files": {
+            "swatch.png": {
+                "className": "swatch",
+                "css": "swatch.css"
+            }
+        }
+    }]
+}
+```
+
+* Omit `seed` to start from the image’s average `background-color`; pass `seed` (declarations or a `.css` file in `src`) to refine existing CSS.
+* Output defaults to `{stem}.css` with `.{stem} { … }`; override with `css` / `output` and `className`.
+
 ### Sharp
 
 This still-image service converts, compresses, resizes, and can emit multi-size thumbnails or favicon packs (including `.ico`). Every image under `src` is processed; `files` overrides are optional.

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@makefully/dutifully",
-    "version": "1.15.0",
+    "version": "1.16.0",
     "description": "Client tools for Cheerfully service.",
     "main": "./src/index.js",
     "bin": {
@@ -18,6 +18,7 @@
     "scripts": {
         "test": "node --test test/**/*.test.js",
         "test-allosaurus": "node ./cheer.js -service allosaurus",
+        "test-classfully": "node ./cheer.js -service classfully",
         "test-elevenlabs": "node ./cheer.js -service elevenlabs",
         "test-ffmpeg": "node ./cheer.js -service ffmpeg",
         "test-packfully": "node ./cheer.js -service packfully",
@@ -48,7 +49,8 @@
         "captions",
         "packfully",
         "atlas",
-        "spritesheet"
+        "spritesheet",
+        "classfully"
     ],
     "author": "Derek Detweiler <derek@makefullystudios.com>",
     "contributors": [

package/src/classes/Classfully.js

@@ -0,0 +1,15 @@
+const
+    Cheer = require('./Cheer'),
+    Classfully = class Classfully extends Cheer {
+        beforeSend (archive) {
+            const
+                {src} = this.config;
+
+            if (src) {
+                archive.directory(src, false);
+            }
+            super.beforeSend(archive);
+        }
+    };
+
+module.exports = Classfully;

package/src/index.js

@@ -4,6 +4,7 @@ const
     LipSync = require('./classes/LipSync'),
     parsers = {
         allosaurus: LipSync,
+        classfully: require('./classes/Classfully'),
         elevenlabs: require('./classes/ElevenLabs'),
         ffmpeg: require('./classes/FFMPEG'),
         packfully: require('./classes/Packfully'),