@pixerate/editor 0.129.0 → 0.131.0

package/dist/vector/index.js

@@ -42,7 +42,7 @@ import {
   reverseMorphContour,
   subpathToMorphContour,
   turnMorphContour
-} from "../chunk-A6KHMKI4.js";
+} from "../chunk-ECVI5QRE.js";
 import {
   DEFAULT_VECTOR_FONT,
   IDENTITY_MATRIX,
@@ -74,6 +74,9 @@ import {
   VECTOR_GRADIENT_TYPES,
   VECTOR_HORIZONTAL_RESIZING,
   VECTOR_HORIZONTAL_RESIZING_LABELS,
+  VECTOR_LENS_LABELS,
+  VECTOR_LENS_SPECS,
+  VECTOR_LENS_TYPES,
   VECTOR_MASK_TYPES,
   VECTOR_MERGE_MODES,
   VECTOR_MESH_MAX,
@@ -198,6 +201,7 @@ import {
   isVectorFrame,
   isVectorFreeformGradient,
   isVectorGradient,
+  isVectorLens,
   isVectorLiveBoolean,
   isVectorMaskActive,
   isVectorMaskGroup,
@@ -212,6 +216,7 @@ import {
   mapBezierPath,
   mapVectorGradient,
   mapVectorPaint,
+  mapVectorPaintColors,
   mapVectorPoints,
   mapVectorShadedPaint,
   mapVectorSubpaths,
@@ -265,6 +270,7 @@ import {
   replaceVectorText,
   rerouteVectorConnectors,
   resizeWarpMesh,
+  resolveVectorLenses,
   resolveVectorSymbols,
   reverseSubpath,
   reverseVectorGradient,
@@ -284,6 +290,7 @@ import {
   sanitizeVectorFilters,
   sanitizeVectorFrame,
   sanitizeVectorGradient,
+  sanitizeVectorLens,
   sanitizeVectorMask,
   sanitizeVectorResizing,
   sanitizeVectorShadedPaint,
@@ -300,6 +307,7 @@ import {
   setVectorGradientVector,
   setVectorTextShaper,
   setWidthPoint,
+  shadeVectorColor,
   simplifyPolyline,
   skewMatrix,
   sortedVectorGradientStops,
@@ -308,6 +316,7 @@ import {
   splitWarpMeshU,
   splitWarpMeshV,
   starSubpath,
+  stripVectorLensViews,
   stripVectorSymbolArt,
   strokePositionPoint,
   strokeWidthProfileOf,
@@ -337,6 +346,7 @@ import {
   vectorAppearanceOutline,
   vectorAppearanceShapes,
   vectorArtboards,
+  vectorBevelFaces,
   vectorBlendModeCss,
   vectorBlendModeFromCss,
   vectorBoundsInside,
@@ -355,6 +365,7 @@ import {
   vectorEnvelopeFrame,
   vectorEnvelopeMap,
   vectorEnvelopeMesh,
+  vectorExtrudeFaces,
   vectorFills,
   vectorFilterMarkup,
   vectorFilterParamKeys,
@@ -384,6 +395,8 @@ import {
   vectorGradientUnitsMatrix,
   vectorInstanceDrawn,
   vectorInstanceGroup,
+  vectorLensColorMap,
+  vectorLensDrawn,
   vectorLiveBooleanSteps,
   vectorMaskContains,
   vectorMaskContentBounds,
@@ -413,11 +426,13 @@ import {
   vectorNodesNear,
   vectorOperandOperation,
   vectorPaintLayerNodes,
+  vectorPaintSolid,
   vectorPaintToSvg,
   vectorParentMatrix,
   vectorPathAt,
   vectorPathData,
   vectorPathLocalBounds,
+  vectorPathRings,
   vectorPathTextPositions,
   vectorPathWorldBezier,
   vectorRepeaterCopies,
@@ -478,7 +493,7 @@ import {
   withVectorStrokes,
   withVectorTargetPaint,
   zigzagPaths
-} from "../chunk-ROZFX4QI.js";
+} from "../chunk-IEYXYMRQ.js";
 import {
   bezierPathBounds,
   bezierPathToSvg,
@@ -2291,12 +2306,20 @@ function collapsedNode(node, box, prefix) {
   byPrefix.set(prefix, out);
   return out;
 }
+var lensResolved = /* @__PURE__ */ new WeakMap();
+function resolvedLensNodes(doc) {
+  const hit = lensResolved.get(doc.nodes);
+  if (hit) return hit;
+  const nodes = resolveVectorLenses(doc).nodes;
+  lensResolved.set(doc.nodes, nodes);
+  return nodes;
+}
 function getVectorSceneRenderData(state, options = {}) {
   const defs = [];
   const filters = [];
   const prefix = options.idPrefix ?? "ve-";
   const v = state.viewport;
-  const all = state.document.nodes;
+  const all = resolvedLensNodes(state.document);
   const stats = { nodes: all.length, culled: 0, collapsed: 0 };
   let nodes;
   const size = options.viewportSize;
@@ -3512,6 +3535,7 @@ ${offset}
 var pdfString = (s) => `(${s.replace(/[\\()]/g, (c) => `\\${c}`).replace(/[^\x20-\x7e]/g, "?")})`;
 function vectorDocumentToPdf(doc, options = {}) {
   const notes = /* @__PURE__ */ new Set();
+  doc = resolveVectorLenses(doc);
   const scale = options.scale ?? 1;
   const compress = options.compress !== false;
   const frames = options.pages === "artboards" ? vectorArtboards(doc) : [];
@@ -3724,9 +3748,10 @@ function nodeGroup(node, notes) {
   if (node.filters?.length) notes.push(`${label(node)}: filters (shadows, glows, blurs) are not part of Lottie (left out).`);
   const m = nodeMatrix(node);
   let items = [];
-  const live = (node.effects ?? []).some((e) => e.enabled !== false && (e.type === "wiggle" || e.type === "envelope" || e.type === "contour" || e.type === "blockShadow"));
-  if (node.type === "text" || node.type === "instance" || live || isVectorMaskGroup(node) || isVectorFrame(node) || isVectorSymmetryGroup(node)) {
-    if (live) notes.push(`${label(node)}: wiggle, envelope, contour and block shadow effects have no Lottie equivalent (exported as drawn).`);
+  const live = (node.effects ?? []).some((e) => e.enabled !== false && (e.type === "wiggle" || e.type === "envelope" || e.type === "contour" || e.type === "blockShadow" || e.type === "extrude" || e.type === "bevel"));
+  if (node.type === "text" || node.type === "instance" || live || isVectorMaskGroup(node) || isVectorFrame(node) || isVectorSymmetryGroup(node) || isVectorLens(node)) {
+    if (live) notes.push(`${label(node)}: wiggle, envelope, contour, block shadow, extrude and bevel effects have no Lottie equivalent (exported as drawn).`);
+    if (isVectorLens(node)) notes.push(`${label(node)}: a lens exports as drawn (what it shows now, clipped by its outline).`);
     if (isVectorMaskGroup(node) && node.mask?.type !== "clip") notes.push(`${label(node)}: opacity masks are not exported (the contents are drawn whole).`);
     const drawn = isVectorFrame(node) ? vectorFrameDrawn(node) : node;
     const shapes = isVectorMaskGroup(drawn) && drawn.mask?.type === "clip" ? vectorAppearanceShapes({ ...drawn, transform: void 0 }) : null;
@@ -3780,6 +3805,7 @@ function vectorDocumentToLottie(doc, options = {}) {
   const fps = options.fps ?? 30;
   const op = Math.max(1, Math.round(options.frames ?? 1));
   const shapes = [];
+  if (!options.nodes) doc = resolveVectorLenses(doc);
   for (const n2 of [...options.nodes ?? doc.nodes].reverse()) {
     const g = nodeGroup(n2, notes);
     if (g) shapes.push(g);
@@ -6977,7 +7003,7 @@ var VectorEditorController = class _VectorEditorController {
       out = { ...out, symbols: out.symbols.map((s) => s.id === edit.symbolId ? { ...s, nodes: out.nodes } : s) };
     }
     out = resolveVectorSymbols(out);
-    return rerouteVectorConnectors(this.solved(out));
+    return resolveVectorLenses(rerouteVectorConnectors(this.solved(out)));
   }
   /**
    * `doc` with its constraints solved (geometry edited since the last solve moving least) and
@@ -7471,7 +7497,7 @@ var VectorEditorController = class _VectorEditorController {
     return vectorDocumentToSvg(this.storedDocument(), options);
   }
   toJSON() {
-    return cloneVectorDocument(stripVectorSymbolArt(this.storedDocument()));
+    return cloneVectorDocument(stripVectorLensViews(stripVectorSymbolArt(this.storedDocument())));
   }
   /** Adds a node (ids are kept unless taken). Returns its id. */
   addNode(node, options = {}) {
@@ -10129,6 +10155,51 @@ var VectorEditorController = class _VectorEditorController {
    * (`{ nodeId, side? }`) or unglue it (`null`, the end staying where it is), and `route`,
    * `radius`, `gap` set how they run. Plain open paths given by id become connectors. One undo step.
    */
+  /**
+   * Makes closed paths lenses (CorelDRAW's Lens) or changes their lens: `lens` is merged over the
+   * current settings (a different `type` starts from that type's defaults), and `null` makes
+   * them plain paths again. One undo step. Returns each path's id and resulting lens.
+   */
+  setLens(lens, options = {}) {
+    const ids = options.ids ?? this.selection;
+    if (!ids.length) return { ok: false, message: "Select a closed path to make a lens first." };
+    if (lens && lens.type !== void 0 && !VECTOR_LENS_TYPES.includes(lens.type)) return { ok: false, message: `Unknown lens "${lens.type}": use ${VECTOR_LENS_TYPES.join(", ")}.` };
+    if (lens?.color !== void 0 && lens.color !== null && !parseVectorColor(lens.color)) return { ok: false, message: `"${lens.color}" is not a colour: use a CSS colour such as #ff0000.` };
+    const next = /* @__PURE__ */ new Map();
+    for (const id of ids) {
+      const n2 = this.getNode(id);
+      if (!n2) return { ok: false, message: `There is no node "${id}".` };
+      if (n2.locked) return { ok: false, message: `"${id}" is locked; unlock it first.` };
+      if (lens === null) {
+        if (n2.type === "path" && n2.lens) next.set(id, null);
+        continue;
+      }
+      if (n2.type !== "path" || !n2.subpaths.some((sp) => sp.closed) || isVectorConnector(n2)) return { ok: false, message: `"${id}" is not a closed path: only closed paths can be lenses.` };
+      const type = lens.type ?? n2.lens?.type;
+      if (!type) return { ok: false, message: `"${id}" is not a lens yet: pass a type (${VECTOR_LENS_TYPES.join(", ")}).` };
+      const spec = VECTOR_LENS_SPECS[type];
+      if (lens.amount !== void 0 && !(Number.isFinite(lens.amount) && lens.amount >= spec.min && lens.amount <= spec.max)) return { ok: false, message: `amount for a ${type} lens must be from ${spec.min} to ${spec.max} (${spec.unit}).` };
+      const base = n2.lens && n2.lens.type === type ? n2.lens : { type };
+      next.set(id, sanitizeVectorLens({ ...base, ...lens, type }));
+    }
+    if (!next.size) return { ok: true, lenses: [] };
+    this.change(
+      lens === null ? "Remove Lens" : "Lens",
+      () => {
+        this.setDoc(
+          mapTree(this.doc.nodes, (n2) => {
+            if (!next.has(n2.id) || n2.type !== "path") return n2;
+            const l = next.get(n2.id);
+            if (l) return { ...n2, lens: l };
+            const { lens: _l, lensView: _v, ...rest } = n2;
+            return rest;
+          })
+        );
+      },
+      options.merge
+    );
+    return { ok: true, lenses: [...next].map(([id, l]) => ({ id, lens: l })) };
+  }
   setConnector(patch, options = {}) {
     const ids = options.ids ?? this.selection;
     if (!ids.length) return { ok: false, message: "Select a connector first." };
@@ -13889,7 +13960,7 @@ function pencilPressureProfile(points, pressures) {
 }
 
 // src/vector/commands.ts
-var EFFECT_PARAMS_DESCRIPTION = "Effect parameters (missing ones keep their value or default). trim: start, end (percent), offset (degrees), mode simultaneous|individual. roundCorners: radius. puckerBloat: amount (\u2212100\u2026100). twist: angle, center {x, y} (offset from the middle). zigzag: size, ridges, smooth. wiggle: size, detail, smooth, speed, correlation, phase, seed, time (seconds). offset: amount, join miter|round|bevel, miterLimit, copies, copyOffset. merge: mode merge|add|subtract|intersect|exclude. repeater: copies (fractions fade the last), offset, position {x, y}, anchor {x, y} (offset from the middle), rotation, scale {x, y} (percent), startOpacity, endOpacity (percent), composite below|above. contour: direction inside|outside|center, steps, offset, fillColor / strokeColor (end colours, null keeps the colour), acceleration (\u2212100\u2026100), join. blockShadow: angle (degrees, 0 right, 90 down), distance, color (null: the shape fill colour), opacity, endOpacity (percent; lower than opacity fades it into a long shadow). envelope: style (a warp preset: arc|arcLower|arcUpper|arch|bulge|shellLower|shellUpper|flag|wave|fish|rise|fisheye|inflate|squeeze|twist, or mesh), bend, horizontal, vertical (percent, \u2212100\u2026100), orientation horizontal|vertical, rows, columns, mesh { us, vs, points } (node space; prefer vector.envelope).";
+var EFFECT_PARAMS_DESCRIPTION = "Effect parameters (missing ones keep their value or default). trim: start, end (percent), offset (degrees), mode simultaneous|individual. roundCorners: radius. puckerBloat: amount (\u2212100\u2026100). twist: angle, center {x, y} (offset from the middle). zigzag: size, ridges, smooth. wiggle: size, detail, smooth, speed, correlation, phase, seed, time (seconds). offset: amount, join miter|round|bevel, miterLimit, copies, copyOffset. merge: mode merge|add|subtract|intersect|exclude. repeater: copies (fractions fade the last), offset, position {x, y}, anchor {x, y} (offset from the middle), rotation, scale {x, y} (percent), startOpacity, endOpacity (percent), composite below|above. contour: direction inside|outside|center, steps, offset, fillColor / strokeColor (end colours, null keeps the colour), acceleration (\u2212100\u2026100), join. blockShadow: angle (degrees, 0 right, 90 down), distance, color (null: the shape fill colour), opacity, endOpacity (percent; lower than opacity fades it into a long shadow). extrude: mode parallel|perspective, angle (degrees) and depth (units) for parallel, vanishingPoint {x, y} (offset from the middle) and toward (percent of the way there) for perspective, color (null: the shape fill colour), lightAngle (degrees the light comes from, 0 right, -90 above), shading (percent). bevel: width (units), lightAngle (degrees), shading (percent), color (null: the shape fill colour). envelope: style (a warp preset: arc|arcLower|arcUpper|arch|bulge|shellLower|shellUpper|flag|wave|fish|rise|fisheye|inflate|squeeze|twist, or mesh), bend, horizontal, vertical (percent, \u2212100\u2026100), orientation horizontal|vertical, rows, columns, mesh { us, vs, points } (node space; prefer vector.envelope).";
 var fail = (message) => {
   throw new Error(message);
 };
@@ -14086,7 +14157,8 @@ function createVectorCommands(controller, options = {}) {
           ...isVectorFrame(n2) ? { frameRect: n2.frame } : {},
           ...n2.resizing ? { resizing: n2.resizing } : {},
           ...n2.type === "path" && n2.connector ? { connector: n2.connector } : {},
-          ...n2.type === "group" && n2.symmetry ? { symmetry: n2.symmetry } : {}
+          ...n2.type === "group" && n2.symmetry ? { symmetry: n2.symmetry } : {},
+          ...n2.type === "path" && n2.lens ? { lens: n2.lens } : {}
         });
         if (n2.type === "group") visit(n2.children, depth + 1);
       }
@@ -15050,6 +15122,50 @@ function createVectorCommands(controller, options = {}) {
       }
     }
   ];
+  const LENS_AMOUNTS = VECTOR_LENS_TYPES.map((t) => `${t} ${VECTOR_LENS_SPECS[t].min}\u2026${VECTOR_LENS_SPECS[t].max} ${VECTOR_LENS_SPECS[t].unit} (default ${VECTOR_LENS_SPECS[t].amount})`).join("; ");
+  const lensCommands = () => [
+    {
+      ...base,
+      id: `${prefix}setLens`,
+      label: "Lens\u2026",
+      keywords: ["lens", "magnify", "fisheye", "fish eye", "invert", "brighten", "grayscale", "heat map", "wireframe", "transparency", "tint", "loupe"],
+      description: "Makes closed paths (`ids`, default the selection) lenses, or changes their lens: inside its outline, what is drawn below shows changed (magnify, fisheye, brighten, invert, tintedGrayscale, colorAdd, colorLimit, heatMap, wireframe, or the lens's own fill see-through for transparency). The lens follows every edit below it; its bounds stay its own shape. Pass type to make or switch a lens (missing values take that type's defaults); omit it to change amount or color of existing lenses. One undo step. Returns { lenses: [{ id, lens }] }.",
+      params: {
+        type: "object",
+        properties: {
+          ids: { ...IDS, description: "Closed paths to make or change (default: the selection)." },
+          type: { type: "string", enum: [...VECTOR_LENS_TYPES], description: "What the lens does. Required for a path that is not a lens yet." },
+          amount: { type: "number", description: `Strength, by type: ${LENS_AMOUNTS}.` },
+          color: { type: ["string", "null"], description: "CSS colour for tintedGrayscale, colorAdd, colorLimit and wireframe (default per type; ignored by the others)." }
+        },
+        additionalProperties: false
+      },
+      undoable: true,
+      enabled: enabledFor,
+      run: (_ctx, params) => {
+        const { ids: list2, ...patch } = params ?? {};
+        if (!Object.keys(patch).length) fail("Pass at least one of type, amount, color.");
+        const r = controller.setLens(patch, list2 ? { ids: list2 } : {});
+        check(r);
+        return { lenses: r.lenses ?? [] };
+      }
+    },
+    {
+      ...base,
+      id: `${prefix}removeLens`,
+      label: "Remove Lens",
+      keywords: ["lens", "remove", "plain"],
+      description: "Makes lenses (`ids`, default the selection) plain paths again; ids that are not lenses are skipped. One undo step. Returns { ids } of the paths that stopped being lenses.",
+      params: { type: "object", properties: { ids: { ...IDS, description: "Lens ids (default: the selection)." } }, additionalProperties: false },
+      undoable: true,
+      enabled: enabledFor,
+      run: (_ctx, params) => {
+        const r = controller.setLens(null, params?.ids ? { ids: params.ids } : {});
+        check(r);
+        return { ids: (r.lenses ?? []).map((l) => l.id) };
+      }
+    }
+  ];
   const pdfCommands = () => [
     {
       ...base,
@@ -15886,6 +16002,7 @@ function createVectorCommands(controller, options = {}) {
     ...lottieCommands(),
     ...pdfCommands(),
     ...symmetryCommands(),
+    ...lensCommands(),
     {
       ...base,
       id: `${prefix}setCorners`,
@@ -16917,6 +17034,9 @@ export {
   VECTOR_HORIZONTAL_RESIZING,
   VECTOR_HORIZONTAL_RESIZING_LABELS,
   VECTOR_INK_MAX_CORNERS,
+  VECTOR_LENS_LABELS,
+  VECTOR_LENS_SPECS,
+  VECTOR_LENS_TYPES,
   VECTOR_MASK_TYPES,
   VECTOR_MASK_TYPE_LABELS,
   VECTOR_MASK_TYPE_OPTIONS,
@@ -17123,6 +17243,7 @@ export {
   isVectorFrame,
   isVectorFreeformGradient,
   isVectorGradient,
+  isVectorLens,
   isVectorLiveBoolean,
   isVectorMaskActive,
   isVectorMaskGroup,
@@ -17142,6 +17263,7 @@ export {
   mapVectorGradient,
   mapWarpMeshPoints as mapVectorMeshPoints,
   mapVectorPaint,
+  mapVectorPaintColors,
   mapVectorPoints,
   mapVectorShadedPaint,
   mapVectorSubpaths,
@@ -17212,6 +17334,7 @@ export {
   resampleGradientStops,
   resizeWarpMesh as resizeVectorMesh,
   resolveVectorBlendOptions,
+  resolveVectorLenses,
   resolveVectorSymbols,
   reverseMorphContour,
   reverseSubpath,
@@ -17233,6 +17356,7 @@ export {
   sanitizeVectorFilters,
   sanitizeVectorFrame,
   sanitizeVectorGradient,
+  sanitizeVectorLens,
   sanitizeVectorMask,
   sanitizeVectorResizing,
   sanitizeVectorShadedPaint,
@@ -17250,6 +17374,7 @@ export {
   setVectorGradientVector,
   setVectorTextShaper,
   setWidthPoint,
+  shadeVectorColor,
   simplifyPolyline,
   smoothSubpath,
   solve8,
@@ -17261,6 +17386,7 @@ export {
   splitWarpMeshU as splitVectorMeshU,
   splitWarpMeshV as splitVectorMeshV,
   starSubpath,
+  stripVectorLensViews,
   stripVectorSymbolArt,
   strokePositionPoint,
   strokeWidthProfileOf,
@@ -17300,6 +17426,7 @@ export {
   vectorAppearanceOutline,
   vectorAppearanceShapes,
   vectorArtboards,
+  vectorBevelFaces,
   vectorBlendColorDistance,
   vectorBlendKeyTargets,
   vectorBlendKeys,
@@ -17339,6 +17466,7 @@ export {
   vectorEnvelopeMap,
   vectorEnvelopeMesh,
   vectorExpressionNames,
+  vectorExtrudeFaces,
   vectorFillMap,
   vectorFills,
   vectorFilterMarkup,
@@ -17375,6 +17503,8 @@ export {
   vectorInkShapeName,
   vectorInstanceDrawn,
   vectorInstanceGroup,
+  vectorLensColorMap,
+  vectorLensDrawn,
   vectorLiveBooleanSteps,
   vectorMaskContains,
   vectorMaskContentBounds,
@@ -17410,6 +17540,7 @@ export {
   vectorNodesNear,
   vectorOperandOperation,
   vectorPaintLayerNodes,
+  vectorPaintSolid,
   vectorPaintSwatch,
   vectorPaintToHex,
   vectorPaintToSvg,
@@ -17419,6 +17550,7 @@ export {
   vectorPathData,
   vectorPathEntries,
   vectorPathLocalBounds,
+  vectorPathRings,
   vectorPathTextPositions,
   vectorPathWorldBezier,
   vectorPathfinderShape,