@pixerate/editor 0.203.0 → 0.205.0

package/dist/vector/index.js

@@ -9470,24 +9470,42 @@ var VectorEditorController = class _VectorEditorController {
    * placed by position.
    */
   reorderNode(id, index) {
+    return this.moveNode(id, { index });
+  }
+  /**
+   * Moves a node into group `parentId` (null: the top level; left out: where it is) at `index`
+   * among its new siblings (bottom to top, 0 the bottom; left out: the top), as dragging it in a
+   * layers panel does. It stays where it is on the canvas. Clipping groups and blends keep their
+   * children: their mask and keys are placed by position.
+   */
+  moveNode(id, options = {}) {
     const node = this.getNode(id);
-    if (!node) return { ok: false, message: `No node "${id}".` };
-    let parent = null;
-    walkVectorNodes(this.doc.nodes, (n2, p) => {
-      if (n2.id === id) parent = p;
-    });
-    const group = parent;
-    if (group && (isVectorMaskGroup(group) || isVectorBlendGroup(group))) {
-      return { ok: false, message: "The order inside a clipping group or blend is fixed." };
-    }
-    const siblings = group ? group.children : this.doc.nodes;
-    const from = siblings.findIndex((n2) => n2.id === id);
-    const to = Math.max(0, Math.min(siblings.length - 1, Math.round(index)));
-    if (from === to) return { ok: true };
+    const at = node && locateVectorNode(this.doc.nodes, id);
+    if (!node || !at) return { ok: false, message: `No node "${id}".` };
+    const fixed = (g) => !!g && (isVectorMaskGroup(g) || isVectorBlendGroup(g));
+    if (fixed(at.parent)) return { ok: false, message: "The order inside a clipping group or blend is fixed." };
+    const parentId = options.parentId === void 0 ? at.parent?.id ?? null : options.parentId;
+    const target = parentId === null ? null : this.getNode(parentId);
+    if (parentId !== null) {
+      if (target?.type !== "group") return { ok: false, message: `"${parentId}" is not a group.` };
+      if (parentId === id || findVectorNode([node], parentId)) return { ok: false, message: "A layer cannot go inside itself." };
+      if (fixed(target)) return { ok: false, message: "The order inside a clipping group or blend is fixed." };
+    }
+    const groupId = target?.id ?? null;
+    const without = mapTree(this.doc.nodes, (n2) => n2.id === id ? null : n2);
+    const inGroup = groupId === null ? null : findVectorNode(without, groupId);
+    const siblings = inGroup?.type === "group" ? inGroup.children : without;
+    const to = Math.max(0, Math.min(siblings.length, Math.round(options.index ?? siblings.length)));
+    if (groupId === (at.parent?.id ?? null) && to === at.index) return { ok: true };
+    const from = vectorParentMatrix(this.doc.nodes, id) ?? IDENTITY_MATRIX;
+    const into = groupId === null ? IDENTITY_MATRIX : vectorWorldMatrix(this.doc.nodes, groupId) ?? IDENTITY_MATRIX;
+    const m = multiplyMatrices(from, invertMatrix(into));
     const next = [...siblings];
-    next.splice(from, 1);
-    next.splice(to, 0, node);
-    this.change("Move Layer", () => group ? this.replaceNode(group.id, { ...group, children: next }) : this.setDoc(next));
+    next.splice(to, 0, isIdentityMatrix(m) ? node : transformVectorNode(node, m));
+    this.change(
+      "Move Layer",
+      () => this.setDoc(groupId === null ? next : mapTree(without, (n2) => n2.id === groupId && n2.type === "group" ? { ...n2, children: next } : n2))
+    );
     return { ok: true };
   }
   /**
@@ -17880,6 +17898,27 @@ function createVectorCommands(controller, options = {}) {
         return { ok: true };
       }
     },
+    {
+      ...base,
+      id: `${prefix}moveLayer`,
+      label: "Move Layer\u2026",
+      keywords: ["reorder", "layer", "order", "into group", "out of group", "reparent", "nest", "z-index"],
+      description: "Moves one node to a position among its siblings (0 the bottom; default the top), as dragging it in the layers panel does. With `parentId` it moves into that group, or with null to the top level; it stays where it is on the canvas.",
+      params: {
+        type: "object",
+        properties: {
+          id: { type: "string", description: "The node to move." },
+          index: { type: "integer", minimum: 0, description: "Position among its new siblings, bottom to top (default: the top)." },
+          parentId: { type: ["string", "null"], description: "The group to move into, or null for the top level (default: its current parent)." }
+        },
+        required: ["id"]
+      },
+      undoable: true,
+      run: (_ctx, params) => {
+        check2(controller.moveNode(params.id, { index: params.index, parentId: params.parentId }));
+        return { ok: true };
+      }
+    },
     {
       ...base,
       id: `${prefix}group`,

package/package.json

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

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

@@ -269,7 +269,7 @@ in the source frame at the document's bit depth, colour mode and profile. Read
 | `grow_selection` | Select › Grow: add connected pixels within `tolerance` (default 32) of a selected colour; follows colour, not distance. `sample`, `sampleMerged`. Fails when nothing is selected. Returns the summary. |
 | `select_similar` | Select › Similar: add every pixel in the image within `tolerance` of a selected colour, connected or not. Fails when nothing is selected. Returns the summary. |
 | `reselect` | Bring back the last selection `deselect` cleared (one undo step). Fails when there is none. Returns the summary. |
-| `refine_selection` | Refine Edge: snap the selection edge to image edges within `radius` px (0..64, default 8), with `smartRadius`, `smooth` 0..100, `feather` px, `contrast` 0..100 and `shiftEdge` -100..100 %. Use on hair, fur, foliage or after loading a coarse AI mask. |
+| `refine_selection` | Select and Mask: snap the selection edge to image edges within `radius` px (0..64, default 8), with `smartRadius`, `smooth` 0..100, `feather` px, `contrast` 0..100 and `shiftEdge` -100..100 %, then `output` to `selection` (default), `layer-mask`, `new-layer` or `new-layer-with-mask` (on `layerId`, default active; new layers hide the source), with `decontaminate` 0..100 for new layers. One step; returns `layerId` / `newLayerId`. Use on hair, fur, foliage or after a coarse AI mask. |
 | `update_adjustment_layer` | Change a layer's `enabled` (false hides it without deleting), `blend`, `opacity` (0..1) or `name` in one undo step. Returns the layer. Its parameters change with `set_adjustments`. Toggle `enabled` to compare a layer's effect before and after. |
 | `move_adjustment_layer` | Move a layer to index `to` (0 = bottom, applied first; past the top means top). Order matters: a curves layer above a hue/saturation layer works on its output. Fails when the layer is already there. Returns the ids bottom to top. |
 | `remove_adjustment_layer` | Delete a layer and its mask. Prefer hiding it with `update_adjustment_layer` when the user may want it back. Returns the remaining ids. |

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

@@ -115,10 +115,12 @@ This skill is the method. `pixerate-image-editor` has the full tool reference.
 
 ## Recipes
 
-- **Cut out a subject onto a new background:** select (table), refine, then `layer_via_copy`.
-  Add the new background with `add_pixel_layer` and move it under the cutout (`move_layer`).
-  `render_preview` and look for a halo; if there is one, load the copy's pixels back as a
-  selection, `shrink` 1 px, and mask.
+- **Cut out a subject onto a new background:** select (table), then `refine_selection` with
+  `output: "new-layer-with-mask"` (revisable) and, for hair or fur, `decontaminate` 50–100 so
+  the old background's colour leaves the soft edge. Add the new background with
+  `add_pixel_layer` and move it under the cutout (`move_layer`). `render_preview` and look for a
+  halo; if there is one, raise `decontaminate`, or load the mask as a selection, `contract`
+  1 px, and output again.
 - **Replace the sky:** `select_sky` (or `magic_wand` / `select_color_range` `preset: "blues"`
   if it finds none), `add` missed patches, `refine_selection` radius 8–16 along the horizon and trees, then
   `add_layer_mask` on the new sky layer. Match it with a clipped curves layer (`clipped: true`).
@@ -176,7 +178,8 @@ This skill is the method. `pixerate-image-editor` has the full tool reference.
   background, and drop `snapToEdges` where the edge is too faint.
 - **Over-feathering hard objects:** a 10 px feather on a product looks like a glow. Keep hard
   edges at 0–2 px and refine soft ones instead.
-- **Halo:** the old background shows as a light or dark fringe. `contract` 1–2 px or
+- **Halo:** the old background shows as a light or dark fringe. `decontaminate` on a
+  new-layer output for soft edges; for hard ones `contract` 1–2 px or
   `shiftEdge` negative before masking.
 - **Baking too early:** `apply_layer_mask`, `merge_down` and `layer_via_copy` with `cut: true`
   are hard to revise. Keep masks until the user is happy.

package/skills/pixerate-vector/SKILL.md

@@ -246,6 +246,7 @@ arrays, to build or replace a stack in one call.
 | `vector.align` | Align `ids` on `edge` (left, center, right, top, middle, bottom) to their combined bounds, or to the artboard with `to: "artboard"` (also the default for a single node). |
 | `vector.distribute` | Give three or more nodes equal gaps in `direction` horizontal or vertical. |
 | `vector.arrange` | Change stacking `order` within each node's parent: front, forward, backward, back. |
+| `vector.moveLayer` | Move one node `id` to `index` among its siblings (0 the bottom; default the top); `parentId` moves it into a group, or `null` to the top level. It stays put on the canvas. |
 | `vector.group` | Group nodes that share a parent, with an optional `name`. Returns `{ id }`. |
 | `vector.ungroup` | Replace groups with their children (ungrouping a blend expands it). |
 | `vector.select` | Select nodes by `ids` (`add: true` to extend; an empty list clears). Selection is the default target of most commands. |