@pixerate/editor 0.249.0 → 0.251.0

package/dist/canvas/index.d.cts

@@ -44,3 +44,4 @@ export * from './explosion-tools.cjs';
 export * from './proposals.cjs';
 export * from './changeFeed.cjs';
 export * from './proposal-tools.cjs';
+export * from './stickers.cjs';

package/dist/canvas/index.d.ts

@@ -44,3 +44,4 @@ export * from './explosion-tools.js';
 export * from './proposals.js';
 export * from './changeFeed.js';
 export * from './proposal-tools.js';
+export * from './stickers.js';

package/dist/canvas/index.js

@@ -1,25 +1,3 @@
-import {
-  brushstrokeSeed,
-  getBrushedShapeSvg,
-  isBrushedShape,
-  listCanvasBrushes,
-  loadCanvasBrushstrokeRenderer,
-  pathDataToPolyline,
-  profileAlongPolyline,
-  renderCanvasBrushSwatch,
-  renderShapeBrushstroke,
-  validateCanvasBrush,
-  validateCanvasBrushPaint
-} from "../chunk-6BIDVPED.js";
-import {
-  PATHFINDER_OPERATIONS,
-  PlanarMap,
-  contourEnclosesArea,
-  cutOutPiece,
-  hatchPath,
-  interiorPoint,
-  pathfinder
-} from "../chunk-65MDXWA7.js";
 import {
   ARCH_METRICS,
   GANTT_METRICS,
@@ -54,13 +32,35 @@ import {
   textWidth,
   timelineGeometry
 } from "../chunk-DKNEQX7T.js";
+import {
+  brushstrokeSeed,
+  getBrushedShapeSvg,
+  isBrushedShape,
+  listCanvasBrushes,
+  loadCanvasBrushstrokeRenderer,
+  pathDataToPolyline,
+  profileAlongPolyline,
+  renderCanvasBrushSwatch,
+  renderShapeBrushstroke,
+  validateCanvasBrush,
+  validateCanvasBrushPaint
+} from "../chunk-5JNA6LLY.js";
+import {
+  PATHFINDER_OPERATIONS,
+  PlanarMap,
+  contourEnclosesArea,
+  cutOutPiece,
+  hatchPath,
+  interiorPoint,
+  pathfinder
+} from "../chunk-65MDXWA7.js";
 import {
   TokenError,
   getTokenCollection,
   getTokenVariable,
   isTokenInScope,
   resolveToken
-} from "../chunk-YGQVCQTG.js";
+} from "../chunk-ILP77UD6.js";
 import {
   DEFAULT_NODE_HEIGHT,
   DEFAULT_NODE_WIDTH,
@@ -121,11 +121,11 @@ import {
 } from "../chunk-5ED73EC6.js";
 import {
   layoutChart
-} from "../chunk-N4DFDI73.js";
+} from "../chunk-WKMUBATU.js";
+import "../chunk-O6OGNDND.js";
 import {
   createChartSpec
-} from "../chunk-QARCM66V.js";
-import "../chunk-O6OGNDND.js";
+} from "../chunk-6ZZKRH7R.js";
 import "../chunk-II2WIF5Z.js";
 import {
   PathOpsError,
@@ -212,6 +212,9 @@ import {
   shapeToPolygon,
   simplifyRing
 } from "../chunk-PWBZH3FK.js";
+import {
+  StickerError
+} from "../chunk-SZTI6EER.js";
 import {
   EffectRendererPool
 } from "../chunk-EHLOCVWB.js";
@@ -220,7 +223,7 @@ import {
   EffectsSlot,
   createEffectToolProvider,
   resolveEffectValues
-} from "../chunk-OFH6Q67U.js";
+} from "../chunk-JA57JIT5.js";
 import "../chunk-V2ZCJRDM.js";
 import {
   brushstrokeScaleBucket
@@ -241,7 +244,7 @@ import {
   pageHidden,
   realClock,
   wrapAnimationTime
-} from "../chunk-CXXXAZ7H.js";
+} from "../chunk-F6R67I3A.js";
 import {
   ANIMATION_EASING_LABELS,
   ANIMATION_EASING_PRESETS,
@@ -266,14 +269,13 @@ import {
   oklabToRgb,
   parseOklab,
   rgbToOklab
-} from "../chunk-V6DT2CDH.js";
+} from "../chunk-M2TPMYJE.js";
 import {
   normalizeTokenColor
 } from "../chunk-2WPNAGHI.js";
-import "../chunk-BP6KSGVD.js";
-import "../chunk-6ADHGQ73.js";
-import "../chunk-JEGJP4OW.js";
-import "../chunk-F67XMVDI.js";
+import "../chunk-7272D3K2.js";
+import "../chunk-YBAPT7NL.js";
+import "../chunk-MHLU6GRJ.js";
 import "../chunk-6ONMQ6WF.js";
 
 // src/canvas/trajectory.ts
@@ -12650,6 +12652,57 @@ function createCanvasProposalToolProvider(proposals, options = {}) {
     tools: [proposeTool, listTool, acceptTool, rejectTool]
   };
 }
+
+// src/canvas/stickers.ts
+function stickerCanvasNode(placement, id) {
+  const { description, asset } = placement;
+  const silhouette = (asset.kind === "svg" ? asset.silhouette : void 0) ?? description.silhouette;
+  if (!silhouette) throw new StickerError("unsupported_format", `"${placement.ref}" has no outline (silhouette); the canvas places stickers by their outline. Pick one whose describe_sticker lists a silhouette.`);
+  const fill = placement.colour ?? description.colours?.[0] ?? "#1f2937";
+  const shape = { kind: "path", d: silhouette, viewBox: [0, 0, description.width, description.height], fillRule: "evenodd", fill };
+  const sticker = { ref: placement.ref, licence: description.licence };
+  return {
+    id,
+    type: SHAPE_NODE_TYPE,
+    position: { x: placement.x - placement.width / 2, y: placement.y - placement.height / 2 },
+    width: placement.width,
+    height: placement.height,
+    data: { label: description.name, [SHAPE_DATA_KEY]: shape, sticker }
+  };
+}
+function createCanvasStickerHost(options) {
+  let n3 = 0;
+  const newId = () => {
+    if (options.createId) return options.createId();
+    const taken = new Set(options.getNodes().map((x) => x.id));
+    let id;
+    do
+      id = `sticker-${++n3}`;
+    while (taken.has(id));
+    return id;
+  };
+  return {
+    noun: "shape node",
+    format: "svg",
+    defaultCentre: () => {
+      if (options.defaultCentre) return options.defaultCentre();
+      const nodes = options.getNodes();
+      if (!nodes.length) return { x: 0, y: 0 };
+      const xs = nodes.flatMap((x) => [x.position.x, x.position.x + (x.width ?? 0)]);
+      const ys = nodes.flatMap((x) => [x.position.y, x.position.y + (x.height ?? 0)]);
+      return { x: (Math.min(...xs) + Math.max(...xs)) / 2, y: (Math.min(...ys) + Math.max(...ys)) / 2 };
+    },
+    insert(placement) {
+      const node = stickerCanvasNode(placement, newId());
+      const before = options.getNodes();
+      const next = [...before, node];
+      const label = `Insert ${placement.description.name}`;
+      if (options.history) options.history.execute({ name: label, execute: () => options.setNodes(next), undo: () => options.setNodes(before), redo: () => options.setNodes(next) });
+      else options.setNodes(next);
+      return { id: node.id };
+    }
+  };
+}
 export {
   ANIMATABLE_PROPERTIES,
   ANIMATION_DATA_KEY,
@@ -12806,6 +12859,7 @@ export {
   createCanvasProposalToolProvider,
   createCanvasProposals,
   createCanvasScenesStore,
+  createCanvasStickerHost,
   createDefaultStrokeStyle,
   createFanOutTrajectory,
   createGuideIndex,
@@ -13135,6 +13189,7 @@ export {
   splitSegment,
   springAt,
   springSettleMs,
+  stickerCanvasNode,
   streamedDiagramText,
   streamlinePoints,
   strikeGesture,

package/dist/canvas/stickers.d.cts

@@ -0,0 +1,35 @@
+/**
+ * Stickers on the canvas: `insert_sticker` (see `@pixerate/editor/stickers`) adds a shape node
+ * whose path is the sticker's outline (`silhouette`), filled in its colour (the tint, or its
+ * dominant colour), so it resizes, recolours and combines like any shape. The canvas has no image
+ * nodes, so multi-colour art is reduced to its outline in one colour; `data.sticker` keeps the ref
+ * and licence.
+ */
+import type { Command } from '../history/types.cjs';
+import type { StickerLicence, StickerRef } from '../stickers/types.cjs';
+import type { StickerInsertHost, StickerPlacement } from '../stickers/tools.cjs';
+import type { CanvasNode } from './types.cjs';
+/** What a sticker node remembers: where it came from. */
+export interface CanvasStickerData {
+    ref: StickerRef;
+    licence: StickerLicence;
+}
+export interface CanvasStickerHostOptions<TNode extends CanvasNode = CanvasNode> {
+    getNodes: () => TNode[];
+    setNodes: (nodes: TNode[]) => void;
+    /** When set, every insertion is one undoable command. */
+    history?: {
+        execute(command: Command): void;
+    };
+    /** New node ids (default `sticker-<n>`, skipping ids in use). */
+    createId?: () => string;
+    /** The default centre (default the middle of the nodes' bounds, or 0, 0). */
+    defaultCentre?: () => {
+        x: number;
+        y: number;
+    };
+}
+/** The shape node for a placed sticker (top-left at its box), or a refusal naming what is missing. */
+export declare function stickerCanvasNode(placement: StickerPlacement, id: string): CanvasNode;
+/** `insert_sticker` for a canvas: a shape node from the sticker's outline, one undo step. */
+export declare function createCanvasStickerHost<TNode extends CanvasNode = CanvasNode>(options: CanvasStickerHostOptions<TNode>): StickerInsertHost;

package/dist/canvas/stickers.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Stickers on the canvas: `insert_sticker` (see `@pixerate/editor/stickers`) adds a shape node
+ * whose path is the sticker's outline (`silhouette`), filled in its colour (the tint, or its
+ * dominant colour), so it resizes, recolours and combines like any shape. The canvas has no image
+ * nodes, so multi-colour art is reduced to its outline in one colour; `data.sticker` keeps the ref
+ * and licence.
+ */
+import type { Command } from '../history/types.js';
+import type { StickerLicence, StickerRef } from '../stickers/types.js';
+import type { StickerInsertHost, StickerPlacement } from '../stickers/tools.js';
+import type { CanvasNode } from './types.js';
+/** What a sticker node remembers: where it came from. */
+export interface CanvasStickerData {
+    ref: StickerRef;
+    licence: StickerLicence;
+}
+export interface CanvasStickerHostOptions<TNode extends CanvasNode = CanvasNode> {
+    getNodes: () => TNode[];
+    setNodes: (nodes: TNode[]) => void;
+    /** When set, every insertion is one undoable command. */
+    history?: {
+        execute(command: Command): void;
+    };
+    /** New node ids (default `sticker-<n>`, skipping ids in use). */
+    createId?: () => string;
+    /** The default centre (default the middle of the nodes' bounds, or 0, 0). */
+    defaultCentre?: () => {
+        x: number;
+        y: number;
+    };
+}
+/** The shape node for a placed sticker (top-left at its box), or a refusal naming what is missing. */
+export declare function stickerCanvasNode(placement: StickerPlacement, id: string): CanvasNode;
+/** `insert_sticker` for a canvas: a shape node from the sticker's outline, one undo step. */
+export declare function createCanvasStickerHost<TNode extends CanvasNode = CanvasNode>(options: CanvasStickerHostOptions<TNode>): StickerInsertHost;