@officexapp/vidfarm-devcli 0.21.35 → 0.21.36

package/dist/src/devcli/sticker-pack.js

@@ -164,6 +164,24 @@ export function keySafeArtInstruction(keyColorHex) {
         `background. Keep the whole palette in strong contrast to ${hex}. The background must be visible ONLY around the ` +
         `outside of the objects, never showing through inside them.`);
 }
+/**
+ * The same clause for the SMART keyer (devcli/plate-key.ts), which deletes only
+ * plate that reaches the sheet's edge. Three of the four bans above stop being
+ * necessary: a shape's enclosed interior can hold ANY color (including the plate
+ * color), outline/line-art shapes keep their middles, and a near-plate fill is
+ * safe as long as it is enclosed. What still matters is the silhouette — the
+ * outer edge has to be distinguishable from the plate, and nothing may fade into
+ * it — so this asks for exactly that and nothing more.
+ */
+export function connectivitySafeArtInstruction(keyColorHex) {
+    const hex = keyColorHex.toUpperCase();
+    return (`KEY-SAFE ARTWORK (only the ${hex} background AROUND the objects gets deleted, never a color sealed inside one): ` +
+        `each object's OUTER EDGE must be a clearly different color from ${hex} and must be crisp — no soft glow, blur, mist, ` +
+        `feathering, drop shadow or reflection fading from the object into the background, and no ${hex} touching the object's ` +
+        `outline from the inside. Inside that outline the art is FREE: any palette (including ${hex} itself), flat or shaded or ` +
+        `painterly, filled or outlined, as long as every enclosed area is sealed by the artwork rather than opening out to the ` +
+        `background.`);
+}
 /** At/above this `hole_pct` a sticker is worth warning about: past ~a fifth of
  *  its own box, "the key ate the fill" is far more likely than "the artist drew
  *  a ring". Tuned to stay quiet on letter counters, handles and small gaps. */
@@ -523,6 +541,36 @@ export async function analyzeKeyedArt(sourcePath) {
     const hole_pct = Math.round((holeArea / (opaque + holeArea)) * 1000) / 10;
     return { holes: holes.length, hole_pct, hollow: hole_pct >= HOLE_WARN_PCT };
 }
+/**
+ * What share of a transparent still is actually opaque. Used to sanity-check a
+ * matte before trusting it: an ONNX matting pass on art it doesn't recognize as a
+ * subject can come back empty (everything transparent — a blank sticker) or
+ * untouched (everything opaque — the background still attached), and both look
+ * like success to the file system. Returns null when there's no alpha to read.
+ */
+export async function measureOpaqueShare(sourcePath) {
+    if (!existsSync(sourcePath))
+        return null;
+    const dims = await probeImageDimensions(sourcePath);
+    if (!dims)
+        return null;
+    const longSide = Math.max(dims.width, dims.height);
+    const scale = longSide > 320 ? 320 / longSide : 1;
+    const sw = Math.max(1, Math.round(dims.width * scale));
+    const sh = Math.max(1, Math.round(dims.height * scale));
+    let alpha;
+    try {
+        alpha = await readAlphaPlane(sourcePath, sw, sh);
+    }
+    catch {
+        return null;
+    }
+    let opaque = 0;
+    for (let i = 0; i < alpha.length; i++)
+        if (alpha[i] > 8)
+            opaque++;
+    return Math.round((opaque / alpha.length) * 1000) / 10;
+}
 /**
  * Re-encode a transparent still as a transparent GIF — the format a lot of
  * sticker surfaces (chat, forums, Notion, old-school web overlays) still want.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@officexapp/vidfarm-devcli",
-  "version": "0.21.35",
+  "version": "0.21.36",
   "description": "Local bridge for the Vidfarm Trackpad Editor. `vidfarm serve <template_id>` boots the FULL editor on localhost (disk-backed records/storage, free in-process render); edit composition.html on disk (Claude Code, Codex, etc.) and the browser live-morphs it.",
   "type": "module",
   "bin": {
@@ -25,6 +25,7 @@
     "dist/src/devcli/local-backend.js",
     "dist/src/devcli/local-frontend-server.js",
     "dist/src/devcli/local-render.js",
+    "dist/src/devcli/plate-key.js",
     "dist/src/devcli/port-utils.js",
     "dist/src/devcli/process-scan.js",
     "dist/src/devcli/qa-check.js",
@@ -97,7 +98,7 @@
     "test:clips": "node --import tsx --test test/clip-curation.test.ts",
     "test:qa": "node --import tsx --test test/qa-check.test.ts",
     "test:studio-brand": "node --import tsx --test test/studio-brand.test.ts",
-    "test:stickers": "node --import tsx --test test/sticker-pack.test.ts",
+    "test:stickers": "node --import tsx --test test/sticker-pack.test.ts test/plate-key.test.ts",
     "test:social-recycle": "node --import tsx --test test/social-recycle.test.ts",
     "test:dedupe": "node --import tsx --test test/dedupe-recipe.test.ts",
     "check:skills": "node scripts/build-director-skill-rollup.mjs --check && node scripts/check-skill-routes.mjs && node scripts/check-skill-nav.mjs",