@pixerate/editor 0.118.0 → 0.120.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pixerate/editor",
-  "version": "0.118.0",
+  "version": "0.120.0",
   "description": "UI-agnostic rich text and media editing core library",
   "author": "Pixerate",
   "license": "MIT",

package/skills/pixerate-image-editor/references/photoshop-files.md

@@ -25,8 +25,11 @@
    included), `fill_pixels`, `clear_pixels`, every retouching tool (Clone Stamp and the healing
    tools sample at depth, from the layer or the float composite) and `transform_layer`
    (resampled at depth; whole-pixel moves exact) keep the depth (32-bit paint and resampling work
-   in linear light). Mask painting, layer filters and layer effects still compute in 8 bits: the
-   pixels they change get 8-bit precision, every pixel they leave alone keeps its deep samples. Afterwards work with `list_layers` as
+   in linear light). Layer masks keep the depth too: 16- and 32-bit masks open and save at depth,
+   blend with their full precision, and the brush, eraser, `fill_pixels` and `clear_pixels` paint
+   them at depth (retouching on a mask stays 8-bit). Layer filters and layer effects still
+   compute in 8 bits: the pixels they change get 8-bit precision, every pixel they leave alone
+   keeps its deep samples. Afterwards work with `list_layers` as
    usual: there is no Background source image, every pixel comes from the layers.
 4. **Smart objects come in live**: embedded contents (a PSB opens as a nested document you can
    edit with `edit_smart_object_contents`, a PNG as raster contents), the placement and warp, the

package/skills/pixerate-vector/SKILL.md

@@ -46,6 +46,8 @@ carry a live effect stack. Every command is a `vector.*` command run with `run_c
 - **Connectors** are open paths with a `connector` whose ends are glued to other objects' sites
   (the middle of a side, or the centre); they are routed again after every edit, so they follow
   what they connect. A free end stays where it is.
+- **Symmetry groups** draw their children plus mirrored or rotated copies. Add art to one with
+  `parentId` on `vector.addShape` / `vector.addPath`; only the originals are stored and edited.
 - Coordinates are document units. A rotated node stores its geometry in its own space: the
   `bounds` that `vector.list` reports are document-space, its `d` is the node's own.
 
@@ -313,6 +315,16 @@ the browser's shaper they are kept but not drawn until outlines are available.
 | `vector.listConnectors` | Read every connector: route and each end's glued object, side setting, side in use and position. |
 | `vector.listConnectionSites` | Read an object's sites (top, right, bottom, left, centre) with positions and outward normals, to pick a `side`. |
 
+### Symmetry
+
+| Command | Use it to |
+| --- | --- |
+| `vector.makeSymmetry` | Put objects (or, with `ids: []`, nothing yet) in a live symmetry group: `mode` vertical / horizontal / dual / diagonal / radial (`copies`, `mirror`), `center`, `rotation`. Its copies follow every edit. Use for logos, mandalas, faces, ornaments: draw one half or one wedge. Returns `{ id, symmetry, children }`. |
+| `vector.setSymmetry` | Change mode, centre, rotation, copies or mirroring. Returns `{ groups }`. |
+| `vector.releaseSymmetry` | Stop repeating; `expand: true` keeps the copies as real objects (to edit one side alone). Returns `{ ids }` of the added objects. |
+| `vector.enterSymmetry` | Hand the canvas to the user drawing inside a symmetry group (pen, pencil, shapes, text go in, mirrored live). Returns `{ id }`. |
+| `vector.exitSymmetry` | Stop drawing inside it. |
+
 ### Masks and clipping
 
 | Command | Use it to |
@@ -331,7 +343,7 @@ contents whole while you work, without losing the mask.
 
 | Command | Use it to |
 | --- | --- |
-| `vector.addEffect` | Add a live path effect `type` (trim, roundCorners, puckerBloat, twist, zigzag, wiggle, offset, merge, repeater, envelope) with `params` to `ids`, at `index` in the stack (default last). Effects apply top to bottom. Returns `{ effects: [{ nodeId, effectId }] }`. |
+| `vector.addEffect` | Add a live path effect `type` (trim, roundCorners, puckerBloat, twist, zigzag, wiggle, offset, merge, repeater, envelope, contour: concentric steps blending to end colours, blockShadow: the shape swept along an angle under it, a long shadow when endOpacity fades) with `params` to `ids`, at `index` in the stack (default last). Effects apply top to bottom. Returns `{ effects: [{ nodeId, effectId }] }`. |
 | `vector.updateEffect` | Change effect `effectId` on `nodeId`: `params` (merged), `enabled`, or move it to `index` (0 applies first). Returns the node's effect stack. |
 | `vector.removeEffect` | Remove effect `effectId` from `nodeId`. |
 | `vector.envelope` | Warp with a live envelope: a `preset` (arc, arcLower, arcUpper, arch, bulge, shellLower, shellUpper, flag, wave, fish, rise, fisheye, inflate, squeeze, twist) with `bend`, `horizontal`, `vertical` (percent, -100 to 100) and `orientation`; or a `mesh` of `rows` x `columns` (1 to 16, optional control `points`); or `topObject: true` (top closed path becomes the envelope), `release: true`, `expand: true`. Reapplying changes an existing envelope. |

package/skills/pixerate-vector/references/commands.md

@@ -110,6 +110,8 @@ default below. Lengths are in the node's own units, angles degrees, percentages
 | offset | amount 5, join `miter`, miterLimit 4, copies 1, copyOffset 0 | Grow or shrink; copies make concentric rings. |
 | merge | mode `add` (also `merge`, `subtract`, `intersect`, `exclude`) | Combine the shapes above it into one, in the bottom shape's style. |
 | repeater | copies 3, offset 0, position {x 100, y 0}, anchor {x 0, y 0}, rotation 0, scale {x 100, y 100} (%), startOpacity 100, endOpacity 100 (%), composite `below` | Copy i is moved, rotated and scaled k = i + offset times about the anchor; fractional copies fade the last one. Radial patterns: position {0, 0}, rotation 360 / copies. |
+| contour | direction `inside`, steps 4, offset 6, fillColor `#ffffff`, strokeColor null, acceleration 0, join `round`, miterLimit 4 | CorelDRAW's Contour: each shape plus `steps` concentric copies `offset` apart (`center`: inward until the shape is used up), their fill and stroke blending to the end colours (null keeps the shape's colour); inside steps draw over the shape, outside ones under it. Acceleration −100…100 holds the colour back (positive) or rushes it (negative). Use for embossed badges, topographic lines and soft glows. |
+| blockShadow | angle 45 (degrees, 0 right, 90 down), distance 20, color `#1e293b` (null: the shape's own fill), opacity 100, endOpacity 100 (%) | CorelDRAW's Block Shadow: each shape swept `distance` along `angle` as one solid shape drawn under all of them. Set endOpacity below opacity (e.g. 0) with a long distance for a flat-design long shadow. The direction is in the node's own space, so it turns with the node. Put it last in the stack so it shadows the final shapes. |
 | envelope | style `arc`, bend 50, horizontal 0, vertical 0, orientation `horizontal`, rows 2, columns 2, mesh null | Prefer `vector.envelope`. |
 
 Effects apply in stack order (index 0 first) to everything above them; effects after a repeater