@pixerate/editor 0.219.1 → 0.220.0

package/dist/image-editor/selection-worker.js

@@ -1,6 +1,6 @@
 import {
   startSelectionWorker
-} from "../chunk-3X244IZ5.js";
+} from "../chunk-A7GJ6BXI.js";
 import "../chunk-ZNA3IQZF.js";
 import "../chunk-ZIF4UJJ6.js";
 import "../chunk-VWEWY4FY.js";

package/dist/paint-editor/index.cjs

@@ -7,7 +7,7 @@ var _chunkZ64NRDEHcjs = require('../chunk-Z64NRDEH.cjs');
 
 
 
-var _chunkS55JFWDAcjs = require('../chunk-S55JFWDA.cjs');
+var _chunkR35YOUP2cjs = require('../chunk-R35YOUP2.cjs');
 require('../chunk-A2IS7EHE.cjs');
 require('../chunk-SS53NNZO.cjs');
 
@@ -1659,11 +1659,11 @@ function header(state, options) {
   return out;
 }
 function serializePaintDocument(state, options = {}) {
-  const { layers, assets } = _chunkS55JFWDAcjs.serializeLayers.call(void 0, state.layers);
+  const { layers, assets } = _chunkR35YOUP2cjs.serializeLayers.call(void 0, state.layers);
   return { ...header(state, options), layers, assets };
 }
 async function serializePaintDocumentExternal(state, store, options = {}) {
-  const { layers, assets } = await _chunkS55JFWDAcjs.serializeLayersExternal.call(void 0, state.layers, store);
+  const { layers, assets } = await _chunkR35YOUP2cjs.serializeLayersExternal.call(void 0, state.layers, store);
   return { ...header(state, options), layers, assets };
 }
 function paintLayersOnly(layers, problems) {
@@ -1700,7 +1700,7 @@ function deserializePaintDocument(raw) {
   const canvas = normalizeCanvas({ width: r.width, height: r.height, dpi: _nullishCoalesce(r.dpi, () => ( void 0)) });
   const paper = _chunkROVK6AXXcjs.normalizePaper.call(void 0, _nullishCoalesce(r.paper, () => ( {})));
   const assets = r.assets && typeof r.assets === "object" ? r.assets : {};
-  const layers = paintLayersOnly(_chunkS55JFWDAcjs.deserializeLayers.call(void 0, r.layers, { assets, problems }), problems);
+  const layers = paintLayersOnly(_chunkR35YOUP2cjs.deserializeLayers.call(void 0, r.layers, { assets, problems }), problems);
   const wanted = typeof r.activeLayerId === "string" ? r.activeLayerId : null;
   const activeLayerId = wanted && _chunkB46UQUDCcjs.findLayer.call(void 0, layers, wanted) ? wanted : _nullishCoalesce(_optionalChain([_chunkB46UQUDCcjs.flattenLayers.call(void 0, layers), 'access', _70 => _70.filter, 'call', _71 => _71((l) => l.type === "pixel"), 'access', _72 => _72.pop, 'call', _73 => _73(), 'optionalAccess', _74 => _74.id]), () => ( null));
   const wetEvents = Array.isArray(r.wetEvents) ? r.wetEvents.filter((e) => e && typeof e === "object" && Number.isInteger(e.clock) && typeof e.kind === "string") : [];
@@ -1716,7 +1716,7 @@ async function deserializePaintDocumentAsync(raw, store) {
   if (!raw || typeof raw !== "object") throw new Error("Not a paint document: expected a JSON object.");
   const r = raw;
   const problems = [];
-  const assets = await _chunkS55JFWDAcjs.resolveExternalAssets.call(void 0, _nullishCoalesce(r.assets, () => ( {})), store, problems);
+  const assets = await _chunkR35YOUP2cjs.resolveExternalAssets.call(void 0, _nullishCoalesce(r.assets, () => ( {})), store, problems);
   const loaded = deserializePaintDocument({ ...r, assets });
   return { ...loaded, problems: [...problems, ...loaded.problems] };
 }
@@ -5468,7 +5468,7 @@ var PaintEditorController = (_class10 = class _PaintEditorController {
       return next.type === "group" ? { ...next, children: toStandard(next.children) } : next;
     });
     const layers = toStandard(dried);
-    const result = _chunkS55JFWDAcjs.exportPsd.call(void 0, { width, height, layers: [paperLayer, ...layers], merged, resolution: dpi });
+    const result = _chunkR35YOUP2cjs.exportPsd.call(void 0, { width, height, layers: [paperLayer, ...layers], merged, resolution: dpi });
     for (const [mode, names] of changed) {
       const label = _nullishCoalesce(_optionalChain([_chunkOLNIPTB3cjs.BLEND_MODES, 'access', _279 => _279.find, 'call', _280 => _280((m) => m.id === mode), 'optionalAccess', _281 => _281.label]), () => ( mode));
       const std = _nullishCoalesce(_optionalChain([_chunkOLNIPTB3cjs.BLEND_MODES, 'access', _282 => _282.find, 'call', _283 => _283((m) => m.id === _chunkOLNIPTB3cjs.standardBlendMode.call(void 0, mode)), 'optionalAccess', _284 => _284.label]), () => ( _chunkOLNIPTB3cjs.standardBlendMode.call(void 0, mode)));

package/dist/paint-editor/index.js

@@ -7,7 +7,7 @@ import {
   resolveExternalAssets,
   serializeLayers,
   serializeLayersExternal
-} from "../chunk-F7Z2MKY2.js";
+} from "../chunk-S6KKLFZO.js";
 import "../chunk-3CI7FRMK.js";
 import "../chunk-ZNA3IQZF.js";
 import {

package/package.json

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

package/skills/pixerate-image-editor/SKILL.md

@@ -310,10 +310,11 @@ in the source frame at the document's bit depth, colour mode and profile. Read
 | `add_shape_component` | Add a live shape or path to a shape layer with `op` (`combine`, `subtract`, `intersect`, `exclude`), on top unless `index`. Use it for cut-outs, rings, badges. Returns the shape. |
 | `remove_shape_component` | Delete one component (not the last: delete the layer instead). Returns the shape. |
 | `merge_shape_components` | Merge Shape Components: the combined area becomes one plain component (live shapes become paths); the look does not change. Returns the shape. |
-| `get_vector_mask` | Read-only. A layer's vector mask: enabled, linked, inverted, fill rule, density, feather, bounds and components (subpaths in document px), or null. Read it before editing the path. |
+| `get_vector_mask` | Read-only. A layer's vector mask: enabled, linked, inverted, fill rule, density, feather, bounds, components (subpaths in document px), `edges` (hybrid soft segments) and `segmentCount`, or null. Read it before editing the path. |
 | `add_vector_mask` | Layer › Vector Mask on any layer but a shape: `from` `path` (a `shape`, `subpaths` or `components`, like `add_shape_layer`, or a document path's `pathId`), `selection` (traced, `tolerance` px), `reveal-all` or `hide-all` (empty path). Reveals inside the path, sharp at any size; it combines with the raster mask. Returns the vector mask. |
 | `set_vector_mask_path` | Replace the vector mask's path (properties kept). Returns the vector mask. |
 | `set_vector_mask_properties` | `enabled`, `linked` (false: stays put when the layer moves), `inverted`, `density`, `feather` px; the path is kept. Returns the vector mask. |
+| `set_vector_mask_edge` | Hybrid mask: one segment's edge (`component`, `subpath`, `segment`): `hard` (default), `feather` (`radius` px) or `matte` (a corridor `inner` px in to `outer` px out, solved from the layer's colours, for hair and fur). Modes blend where they meet. Check with `inspect_mask_edge` `target: "vector-mask"`. Returns the vector mask. |
 | `rasterize_vector_mask` | Multiply the path into the raster mask (adding one) and drop the vector mask, so it can be painted. Returns the mask summary. |
 | `remove_vector_mask` | Delete the vector mask (the raster mask stays). |
 | `selection_to_path` | Read-only. Make Work Path: the selection's outline as closed Bézier subpaths (`tolerance` px, `cornerRoundness`, `minArea`); returns `svg` and `fillRule: "evenodd"` to pass to `add_vector_mask`, `set_vector_mask_path` or `add_shape_layer`. |

package/skills/pixerate-image-editor/references/paths.md

@@ -10,3 +10,9 @@ panel). The Work Path is the scratch path; saved paths stay until deleted.
    handles → `set_path_geometry` (one undo step); shapes `set_shape_component`, vector masks
    `set_vector_mask_path`.
 4. **Read first**: `list_paths` for ids, names and bounds; `get_path` for the `components` to edit.
+5. **Hybrid vector masks**: a vector mask's segments can each have their own edge.
+   `set_vector_mask_edge` makes a segment `feather` (a soft falloff of `radius` px) or `matte` (a
+   corridor `inner` px inside to `outer` px outside, solved from the layer's colours, for hair and
+   fur); the rest stay `hard`. In the editor, Alt+Shift-click a vector mask segment with Direct
+   Selection to cycle hard → feather → matte. Edges are addressed by segment index, so after adding
+   or deleting anchors on that subpath, check `get_vector_mask` `edges` and set them again.

package/skills/pixerate-image-selection-masking/SKILL.md

@@ -104,7 +104,7 @@ This skill is the method. `pixerate-image-editor` has the full tool reference.
 | --- | --- |
 | Geometric areas: a frame, a screen, a band | `select_rect` / `select_ellipse`, with `feather` for soft transitions |
 | One object among others, where you can box it (a product on a table, a person in a group) | `select_object` with a `rect` a little larger than the object on every side; then `quick_select` add / subtract strokes for what it missed |
-| A subject with a clear outline (product, person, animal) | `select_subject` (with a host model, by description; without one it takes whatever stands out most, so check `method` and the result); else `select_object` around it, or `select_polygon` with `snapToEdges` (12–30 points within `width` of the edge), then `refine_selection` |
+| A subject with a clear outline (product, person, animal) | `select_subject` (with a host model, by description; without one it takes whatever stands out most, so check `method` and the result); else `select_object` around it, or `select_polygon` with `snapToEdges` (12–30 points within `width` of the edge), then `refine_selection`; hard sides and loose hair in one mask: `add_vector_mask` `from: "selection"`, then `set_vector_mask_edge` `matte` on the hair segments |
 | An area or subject that differs from its surroundings (a shirt, a sky, a car) | `quick_select` with strokes painted inside it, away from the edge (`size` a fraction of its width); `add` / `subtract` strokes where it fell short or leaked |
 | The sky (to replace, recolour, or to leave out with `invert_selection`) | `select_sky`; raise `threshold` for haze or a sunset glow, lower it if pale buildings come in |
 | A sharp subject on a blurred background (shallow depth of field) | `select_focus_area`; raise `range` if parts of the subject are missing, `noise` if grainy background comes in |
@@ -174,9 +174,9 @@ This skill is the method. `pixerate-image-editor` has the full tool reference.
   the image's border, which may be a bright sign rather than the person. When `method` is
   `saliency`, check with `capture_view`; if it's wrong, use `select_object` with a box.
 - **Object Selection takes part of the background:** without a model, anything in the box unlike
-  the background around it is the object (a shadow, a misty hill). Leave background on every side
-  (a box at the image's edge has none there), then `subtract` a `quick_select` stroke on extra.
-  `point` may stop at an inner edge, or miss parts coloured like the background: use a box.
+  the background around it is the object (a shadow, mist). Leave background on every side (none
+  past the image's edge), then `subtract` a `quick_select` stroke. `point` may stop at an inner
+  edge, miss background-coloured parts, or take a patch a small object sits in: box small ones.
 - **Quick Selection spills over a weak edge:** a stroke grows into neighbouring areas of a
   similar colour. Paint smaller strokes further from the edge, then a `subtract` stroke on the
   spill. Strokes near an edge also pull in the other side.