@pixerate/editor 0.279.0 → 0.280.0

package/dist/vector/index.js

@@ -35,7 +35,7 @@ import {
   traceField,
   traceVectorImage,
   vectorTraceContours
-} from "../chunk-N4MCWQZ7.js";
+} from "../chunk-HN57I7KT.js";
 import {
   rasterizeCoverage
 } from "../chunk-ADMRNWR7.js";
@@ -66,7 +66,7 @@ import {
   reverseMorphContour,
   subpathToMorphContour,
   turnMorphContour
-} from "../chunk-DWPFGWW5.js";
+} from "../chunk-FKO3CY2C.js";
 import {
   DEFAULT_VECTOR_FONT,
   IDENTITY_MATRIX,
@@ -556,7 +556,7 @@ import {
   withVectorStrokes,
   withVectorTargetPaint,
   zigzagPaths
-} from "../chunk-HHX7ST6Z.js";
+} from "../chunk-YOM76H2V.js";
 import {
   snapshotBrushLibrary
 } from "../chunk-PPDUCZZV.js";
@@ -597,7 +597,7 @@ import {
   resolveEffectValues
 } from "../chunk-MV7CYFMJ.js";
 import "../chunk-V2ZCJRDM.js";
-import "../chunk-CTHWXW5M.js";
+import "../chunk-V6LQND7D.js";
 import "../chunk-J23JOHPR.js";
 import {
   GRAIN_PATTERNS
@@ -16551,17 +16551,72 @@ function createVectorCommands(controller, options = {}) {
       }
     }
   ];
+  const resolveImage = options.resolveImage;
+  const IMAGE_WHAT = resolveImage ? "an image (a PNG data URL, or a reference the editor loads)" : "a PNG (base64 data URL)";
+  const IMAGE_PARAM = {
+    type: "string",
+    description: resolveImage ? `The image: a data:image/png;base64,\u2026 URL, or ${options.imageReferences ?? "an image URL"} (up to ${VECTOR_TRACE_MAX_PIXELS / 1e6} million pixels).` : "The image as a data:image/png;base64,\u2026 URL (up to 4 million pixels)."
+  };
+  const decodePngBytes = (bytes, what) => {
+    if (!isPng(bytes)) fail(`${what} is not a PNG.`);
+    try {
+      return decodePng(bytes, { maxPixels: VECTOR_TRACE_MAX_PIXELS });
+    } catch (e) {
+      return fail(`The PNG could not be read: ${e.message}`);
+    }
+  };
+  const fromResolved = (ref, resolved) => {
+    if (!resolved || typeof resolved !== "object") return fail(`There is no image "${ref}".`);
+    if ("image" in resolved && resolved.image) return resolved.image;
+    if ("png" in resolved && typeof resolved.png === "string") {
+      const parsed = parseDataUrl(resolved.png);
+      if (!parsed) fail(`The image "${ref}" was loaded as something other than a PNG data URL.`);
+      return decodePngBytes(parsed.bytes, `The image "${ref}"`);
+    }
+    if ("png" in resolved && resolved.png instanceof Uint8Array) return decodePngBytes(resolved.png, `The image "${ref}"`);
+    return fail(`The image "${ref}" was loaded as nothing usable (expected { image } or { png }).`);
+  };
+  const withImage = (image, use) => {
+    if (typeof image !== "string" || !image.trim()) fail("image is empty.");
+    if (/^data:/i.test(image)) {
+      const parsed = parseDataUrl(image);
+      if (!parsed || !isPng(parsed.bytes)) fail(resolveImage ? "image must be a PNG data URL (data:image/png;base64,\u2026) or a reference to an image." : "image must be a PNG data URL (data:image/png;base64,\u2026).");
+      return use(decodePngBytes(parsed.bytes, "image"));
+    }
+    if (!resolveImage) return fail("image must be a PNG data URL (data:image/png;base64,\u2026).");
+    const ref = image.trim();
+    const load = async () => {
+      let resolved;
+      try {
+        resolved = await resolveImage(ref, { maxPixels: VECTOR_TRACE_MAX_PIXELS });
+      } catch (e) {
+        return fail(`The image "${ref}" could not be loaded: ${e instanceof Error ? e.message : String(e)}`);
+      }
+      return use(fromResolved(ref, resolved));
+    };
+    return load();
+  };
+  const imageResult = (r) => {
+    check2(r);
+    return {
+      id: r.id,
+      paths: r.ids.map((id) => {
+        const n2 = controller.getNode(id);
+        return { id, name: n2.name, fill: n2.fill, subpaths: n2.subpaths.length };
+      })
+    };
+  };
   const traceCommands = () => [
     {
       ...base,
       id: `${prefix}traceImage`,
       label: "Image Trace\u2026",
       keywords: ["trace", "image trace", "live trace", "vectorize", "bitmap to vector", "png to svg", "autotrace", "posterize"],
-      description: "Traces a PNG (base64 data URL) into vector paths and adds them as one group: `threshold` mode makes one even-odd path where the image is dark (or opaque with channel alpha); `color` mode makes a stacked path per colour (median-cut to `colors`, the most common at the bottom). Placed with its top-left at x, y and `width` wide (default one unit per pixel). One undo step. Returns { id, paths: [{ id, name, fill, subpaths }] }.",
+      description: "Traces " + IMAGE_WHAT + " into vector paths and adds them as one group: `threshold` mode makes one even-odd path where the image is dark (or opaque with channel alpha); `color` mode makes a stacked path per colour (median-cut to `colors`, the most common at the bottom). Placed with its top-left at x, y and `width` wide (default one unit per pixel). One undo step. Returns { id, paths: [{ id, name, fill, subpaths }] }.",
       params: {
         type: "object",
         properties: {
-          image: { type: "string", description: "The image as a data:image/png;base64,\u2026 URL (up to 4 million pixels)." },
+          image: IMAGE_PARAM,
           mode: { type: "string", enum: ["threshold", "color"], description: "threshold (one colour, default) or color (a path per colour)." },
           channel: { type: "string", enum: ["luminance", "alpha"], description: "Threshold mode: trace dark pixels (luminance, default) or opaque ones (alpha)." },
           threshold: { type: "number", minimum: 0, maximum: 1, description: "Threshold mode: inside where darkness (or alpha) reaches this (default 0.5)." },
@@ -16581,61 +16636,28 @@ function createVectorCommands(controller, options = {}) {
       undoable: true,
       run: (_ctx, params) => {
         const { image, ...options2 } = params;
-        const parsed = parseDataUrl(image);
-        if (!parsed || !isPng(parsed.bytes)) fail("image must be a PNG data URL (data:image/png;base64,\u2026).");
-        let decoded2;
-        try {
-          decoded2 = decodePng(parsed.bytes, { maxPixels: VECTOR_TRACE_MAX_PIXELS });
-        } catch (e) {
-          return fail(`The PNG could not be read: ${e.message}`);
-        }
-        const r = controller.traceImage(decoded2, options2);
-        check2(r);
-        return {
-          id: r.id,
-          paths: r.ids.map((id) => {
-            const n2 = controller.getNode(id);
-            return { id, name: n2.name, fill: n2.fill, subpaths: n2.subpaths.length };
-          })
-        };
+        return withImage(image, (pixels) => imageResult(controller.traceImage(pixels, options2)));
       }
     }
   ];
   const IMAGE_PLACE = {
-    image: { type: "string", description: "The picture as a data:image/png;base64,\u2026 URL (up to 4 million pixels)." },
+    image: resolveImage ? IMAGE_PARAM : { type: "string", description: "The picture as a data:image/png;base64,\u2026 URL (up to 4 million pixels)." },
     x: { type: "number", description: "Left edge in document units (default 0)." },
     y: { type: "number", description: "Top edge in document units (default 0)." },
     width: { type: "number", exclusiveMinimum: 0, description: "Width in document units (default: the image width in pixels)." },
     name: { type: "string", description: "Group name (default: the style's name)." }
   };
-  const decodeImage = (image) => {
-    const parsed = parseDataUrl(image);
-    if (!parsed || !isPng(parsed.bytes)) fail("image must be a PNG data URL (data:image/png;base64,\u2026).");
-    try {
-      return decodePng(parsed.bytes, { maxPixels: VECTOR_TRACE_MAX_PIXELS });
-    } catch (e) {
-      return fail(`The PNG could not be read: ${e.message}`);
-    }
-  };
   const stylize = (style, label2, keywords, description, props) => ({
     ...base,
     id: `${prefix}${style}Image`,
     label: label2,
     keywords: ["stylize", "stylise", "bitmap to vector", "artistic", "png to svg", ...keywords],
-    description: `${description} Added as one group placed with its top-left at x, y and width wide; colours of one kind share a compound path. One undo step. Returns { id, paths: [{ id, name, fill, subpaths }] }.`,
+    description: `${resolveImage ? description.replace("a PNG", IMAGE_WHAT) : description} Added as one group placed with its top-left at x, y and width wide; colours of one kind share a compound path. One undo step. Returns { id, paths: [{ id, name, fill, subpaths }] }.`,
     params: { type: "object", properties: { ...IMAGE_PLACE, ...props }, required: ["image"], additionalProperties: false },
     undoable: true,
     run: (_ctx, params) => {
       const { image, ...options2 } = params;
-      const r = controller.stylizeImage(decodeImage(image), style, options2);
-      check2(r);
-      return {
-        id: r.id,
-        paths: r.ids.map((id) => {
-          const n2 = controller.getNode(id);
-          return { id, name: n2.name, fill: n2.fill, subpaths: n2.subpaths.length };
-        })
-      };
+      return withImage(image, (pixels) => imageResult(controller.stylizeImage(pixels, style, options2)));
     }
   });
   const CELL = (dflt, what) => ({ type: "number", minimum: 1, description: `${what} in image pixels (default ${dflt}); larger draws fewer, bigger shapes.` });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pixerate/editor",
-  "version": "0.279.0",
+  "version": "0.280.0",
   "description": "UI-agnostic rich text and media editing core library",
   "author": "Pixerate",
   "license": "MIT",
@@ -494,7 +494,7 @@
   ],
   "sideEffects": false,
   "devDependencies": {
-    "@anthropic-ai/sdk": "1.1.0",
+    "@anthropic-ai/sdk": "1.6.0",
     "@dagrejs/dagre": "^1.1.8",
     "@tiptap/core": "^2.27.3",
     "@tiptap/extension-character-count": "^2.27.3",
@@ -521,17 +521,17 @@
     "@tiptap/suggestion": "^2.27.3",
     "@types/dagre": "^0.7.54",
     "@types/markdown-it": "^14.2.0",
-    "@types/node": "^26.6.5",
+    "@types/node": "^26.6.6",
     "assemblyscript": "0.28.20",
     "fast-check": "^4.10.2",
     "markdown-it": "^15.0.3",
     "markdown-it-task-lists": "^2.1.1",
-    "mermaid": "12.2.0",
+    "mermaid": "12.3.0",
     "prosemirror-markdown": "^1.13.9",
     "tiptap-markdown": "^0.8.10",
     "tsup": "^9.0.0",
     "typescript": "^5.7.3",
-    "vitest": "^5.0.5",
+    "vitest": "^5.1.0",
     "@pixerate/markdown-conformance": "0.2.0"
   },
   "peerDependencies": {

package/skills/pixerate-vector/SKILL.md

@@ -131,7 +131,7 @@ the pitfalls, and uses the commands below.
 
 | Command | Use it to |
 | --- | --- |
-| `vector.traceImage` | Turn a PNG (data URL) into vector paths in one group: `threshold` mode for one-colour art (logos, scans, silhouettes; `channel: "alpha"` for cut-outs), `color` mode for a stacked path per colour (`colors` 2–32). Raise `tolerance` for fewer anchors, `cornerRoundness` 0 for sharp polygons. Place it with `x`, `y`, `width`. Returns `{ id, paths }`; check `subpaths` counts and simplify or delete specks after. |
+| `vector.traceImage` | Turn a PNG (data URL) into vector paths in one group, or an image the host loads by reference (its `image` description says which: a canvas image node's id, a URL); pass the reference instead of writing the image out: `threshold` mode for one-colour art (logos, scans, silhouettes; `channel: "alpha"` for cut-outs), `color` mode for a stacked path per colour (`colors` 2–32). Raise `tolerance` for fewer anchors, `cornerRoundness` 0 for sharp polygons. Place it with `x`, `y`, `width`. Returns `{ id, paths }`; check `subpaths` counts and simplify or delete specks after. |
 | `vector.mosaicImage` | Stylise a PNG as mosaic tiles (`cell` px, `shape` square / circle, `gap`, `colors`): pixel art, tiled murals. Returns `{ id, paths }`, one compound path per colour. |
 | `vector.halftoneImage` | Stylise a PNG as halftone dots on a turned screen (`cell`, `angle`, ink `color` or null for the picture's colours): comic and pop-art looks, print effects. |
 | `vector.lowPolyImage` | Stylise a PNG as low-poly triangles (`cell`, `jitter`, `seed`, `colors`): geometric portraits and backdrops. |