@pixerate/editor 0.279.0 → 0.280.0

package/dist/paint-editor/index.js

@@ -42,7 +42,7 @@ import {
   resolveExternalAssets,
   serializeLayers,
   serializeLayersExternal
-} from "../chunk-FNIWHSLI.js";
+} from "../chunk-NJDEKU5D.js";
 import "../chunk-ADMRNWR7.js";
 import "../chunk-WJ4WQJCC.js";
 import {
@@ -125,7 +125,7 @@ import {
   wetPaperInput,
   wetPigmentOf,
   withStrokePath
-} from "../chunk-HHX7ST6Z.js";
+} from "../chunk-YOM76H2V.js";
 import {
   BRUSH_ID,
   BRUSH_PRESETS,
@@ -250,7 +250,7 @@ import {
   normalizeWetParams,
   pigmentOf,
   wetSupport
-} from "../chunk-CTHWXW5M.js";
+} from "../chunk-V6LQND7D.js";
 import "../chunk-J23JOHPR.js";
 import {
   CoverageMap,

package/dist/vector/commands.d.cts

@@ -4,6 +4,7 @@ import type { VectorBooleanOperation } from './types.cjs';
 import { type VectorEffect } from './types.cjs';
 import { type VectorBlendMode, type VectorFilter, type VectorPaintLayer, type VectorStrokeLayer } from './types.cjs';
 import { type VectorMaskSummary } from './mask.cjs';
+import { type VectorTracePixels } from './trace.cjs';
 import { type VectorLens, type VectorSymmetry } from './types.cjs';
 import { type VectorConnector } from './types.cjs';
 import { type VectorFrame, type VectorResizing } from './types.cjs';
@@ -14,7 +15,31 @@ export interface VectorCommandOptions {
     group?: string;
     /** Command scope. Omit for global commands. */
     scope?: string;
+    /**
+     * Loads an image that `vector.traceImage` and the stylise commands (`vector.mosaicImage`, …)
+     * are given by reference instead of as a PNG data URL: an http(s) or asset URL, or a host id
+     * such as a canvas node's. Agents can name an image but cannot write out its bytes, so without
+     * this they can only trace PNGs they produced themselves. Return `null` when there is no such
+     * image; throw (or reject) with a sentence when it cannot be loaded. `maxPixels` is the most the
+     * commands trace: scale larger images down to fit.
+     */
+    resolveImage?: VectorImageResolver;
+    /**
+     * What `resolveImage` accepts, for the `image` argument's description (default "an image
+     * URL"), e.g. "the id of an image node on the canvas, or an http(s) URL".
+     */
+    imageReferences?: string;
 }
+/** An image a host loaded for a reference: RGBA pixels, or a PNG (data URL or bytes). */
+export type VectorResolvedImage = {
+    image: VectorTracePixels;
+} | {
+    png: string | Uint8Array;
+};
+/** See `VectorCommandOptions.resolveImage`. */
+export type VectorImageResolver = (ref: string, options: {
+    maxPixels: number;
+}) => VectorResolvedImage | null | undefined | Promise<VectorResolvedImage | null | undefined>;
 /** A node as listed for agents. */
 export interface VectorNodeListing {
     id: string;

package/dist/vector/commands.d.ts

@@ -4,6 +4,7 @@ import type { VectorBooleanOperation } from './types.js';
 import { type VectorEffect } from './types.js';
 import { type VectorBlendMode, type VectorFilter, type VectorPaintLayer, type VectorStrokeLayer } from './types.js';
 import { type VectorMaskSummary } from './mask.js';
+import { type VectorTracePixels } from './trace.js';
 import { type VectorLens, type VectorSymmetry } from './types.js';
 import { type VectorConnector } from './types.js';
 import { type VectorFrame, type VectorResizing } from './types.js';
@@ -14,7 +15,31 @@ export interface VectorCommandOptions {
     group?: string;
     /** Command scope. Omit for global commands. */
     scope?: string;
+    /**
+     * Loads an image that `vector.traceImage` and the stylise commands (`vector.mosaicImage`, …)
+     * are given by reference instead of as a PNG data URL: an http(s) or asset URL, or a host id
+     * such as a canvas node's. Agents can name an image but cannot write out its bytes, so without
+     * this they can only trace PNGs they produced themselves. Return `null` when there is no such
+     * image; throw (or reject) with a sentence when it cannot be loaded. `maxPixels` is the most the
+     * commands trace: scale larger images down to fit.
+     */
+    resolveImage?: VectorImageResolver;
+    /**
+     * What `resolveImage` accepts, for the `image` argument's description (default "an image
+     * URL"), e.g. "the id of an image node on the canvas, or an http(s) URL".
+     */
+    imageReferences?: string;
 }
+/** An image a host loaded for a reference: RGBA pixels, or a PNG (data URL or bytes). */
+export type VectorResolvedImage = {
+    image: VectorTracePixels;
+} | {
+    png: string | Uint8Array;
+};
+/** See `VectorCommandOptions.resolveImage`. */
+export type VectorImageResolver = (ref: string, options: {
+    maxPixels: number;
+}) => VectorResolvedImage | null | undefined | Promise<VectorResolvedImage | null | undefined>;
 /** A node as listed for agents. */
 export interface VectorNodeListing {
     id: string;