@pixerate/editor 0.244.0 → 0.246.0

package/dist/vector/index.js

@@ -26,7 +26,7 @@ import {
   traceField,
   traceVectorImage,
   vectorTraceContours
-} from "../chunk-OSTKS3YN.js";
+} from "../chunk-DQWPMGH2.js";
 import {
   applyHomography,
   homographyFromPoints,
@@ -53,7 +53,7 @@ import {
   reverseMorphContour,
   subpathToMorphContour,
   turnMorphContour
-} from "../chunk-5RFENYO5.js";
+} from "../chunk-A23PSOBB.js";
 import {
   DEFAULT_VECTOR_FONT,
   IDENTITY_MATRIX,
@@ -526,8 +526,8 @@ import {
   withVectorStrokes,
   withVectorTargetPaint,
   zigzagPaths
-} from "../chunk-4EQY4TZJ.js";
-import "../chunk-TBJEMELS.js";
+} from "../chunk-N6WUB3Y5.js";
+import "../chunk-VDAWA546.js";
 import {
   createProvenance
 } from "../chunk-M6DNZNVY.js";
@@ -582,7 +582,7 @@ import {
 import "../chunk-HF5QZS7Z.js";
 import {
   HistoryManager
-} from "../chunk-RNSANXPT.js";
+} from "../chunk-NS62CQ2B.js";
 import "../chunk-5UJHB3BW.js";
 import "../chunk-V6DT2CDH.js";
 import {

package/dist/video-editor/index.cjs

@@ -1,6 +1,6 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; } var _class; var _class2; var _class3; var _class4; var _class5; var _class6; var _class7; var _class8;
 
-var _chunk7V7QMFTIcjs = require('../chunk-7V7QMFTI.cjs');
+var _chunkQOBCBGGIcjs = require('../chunk-QOBCBGGI.cjs');
 
 
 
@@ -179,7 +179,7 @@ var _chunkSJ2CPTQCcjs = require('../chunk-SJ2CPTQC.cjs');
 require('../chunk-2BSBFBOA.cjs');
 
 
-var _chunkFJ2MSI43cjs = require('../chunk-FJ2MSI43.cjs');
+var _chunkWKPXOGZZcjs = require('../chunk-WKPXOGZZ.cjs');
 
 
 var _chunkLJZRHVZVcjs = require('../chunk-LJZRHVZV.cjs');
@@ -3663,7 +3663,7 @@ var VideoEditorController = (_class8 = class _VideoEditorController {
   __init54() {this.planBasis = /* @__PURE__ */ new Map()}
   __init55() {this.planCount = 0}
   constructor(options = {}) {;_class8.prototype.__init46.call(this);_class8.prototype.__init47.call(this);_class8.prototype.__init48.call(this);_class8.prototype.__init49.call(this);_class8.prototype.__init50.call(this);_class8.prototype.__init51.call(this);_class8.prototype.__init52.call(this);_class8.prototype.__init53.call(this);_class8.prototype.__init54.call(this);_class8.prototype.__init55.call(this);_class8.prototype.__init56.call(this);_class8.prototype.__init57.call(this);_class8.prototype.__init58.call(this);
-    this.history = _nullishCoalesce(options.history, () => ( new (0, _chunkFJ2MSI43cjs.HistoryManager)()));
+    this.history = _nullishCoalesce(options.history, () => ( new (0, _chunkWKPXOGZZcjs.HistoryManager)()));
     this.audioPeaks = options.audioPeaks instanceof VideoAudioPeaksCache ? options.audioPeaks : new VideoAudioPeaksCache(options.audioPeaks);
     this.luts = options.luts instanceof _chunkXNZFVYC2cjs.VideoLutCache ? options.luts : new (0, _chunkXNZFVYC2cjs.VideoLutCache)(options.luts);
     this.frameCache = _nullishCoalesce(options.frameCache, () => ( null));
@@ -6773,7 +6773,7 @@ async function openVideoClipEffectAuthoring(controller, clip, instance, options
   const at = _chunkXNZFVYC2cjs.findVideoClip.call(void 0, controller.getProject(), clip);
   if (!at) throw new Error(`There is no clip "${clip}".`);
   const doc = videoClipEffectDocument(at.clip, instance, provider.id);
-  const session = await _chunk7V7QMFTIcjs.createEffectAuthoringSession.call(void 0, { document: doc }, { ...options, provider });
+  const session = await _chunkQOBCBGGIcjs.createEffectAuthoringSession.call(void 0, { document: doc }, { ...options, provider });
   return {
     clip,
     instance,

package/dist/video-editor/index.js

@@ -1,6 +1,6 @@
 import {
   createEffectAuthoringSession
-} from "../chunk-X3ZINLIP.js";
+} from "../chunk-AU6MWQKZ.js";
 import {
   VIDEO_ADJUSTMENT_SCOPES,
   VIDEO_BLEND_MODES,
@@ -179,7 +179,7 @@ import {
 import "../chunk-HF5QZS7Z.js";
 import {
   HistoryManager
-} from "../chunk-RNSANXPT.js";
+} from "../chunk-NS62CQ2B.js";
 import {
   AnimationPlayer
 } from "../chunk-CXXXAZ7H.js";

package/package.json

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

package/skills/pixerate-canvas/SKILL.md

@@ -50,6 +50,14 @@ the pitfalls, and uses the tools below.
    `scope: "canvas"` for the whole drawing. Fix overlaps, misalignment and clipped text, then show
    the user with `canvas_select` or `canvas_highlight`.
 
+**Working alongside the user** (they are building and you add to it unasked): suggest instead of
+editing. `propose_nodes` shows ghosts the user accepts or dismisses, and nothing reaches the canvas
+or its history until then. Keep each proposal small and about one idea (a caption, the next card in
+a series, a missing connector), give it a `title` and a one-sentence `rationale`, and anchor it to
+the node it complements with `nearNodeId`. Never accept your own proposals unless the user asked
+you to. Withdraw stale ones with `reject_proposal`: when the user changes what a proposal builds on,
+`list_proposals` shows it under `missing`.
+
 ## Best practices
 
 - **Design-system thinking.** Anything that appears twice should be a component: build one main,
@@ -143,6 +151,19 @@ undo step and is not saved with the document. The host decides what the children
 | `explode_node` | Explode `node` (an id from `list_explodable_nodes`). Unless `multiple`, the node exploded before collapses (it comes back in `collapsed`). Exploding an exploded node changes nothing (`changed: false`). Returns the ids now `exploded`. Then use `get_editor_state` or `capture_view` to read or see the children. |
 | `collapse_node` | Collapse an exploded `node`. Returns the ids still `exploded` and those still `collapsing` (their children leave when the collapse animation ends). Fails when the node is not exploded. |
 
+### Proposals (suggest, don't edit)
+
+Hosts that let agents suggest additions add these. A proposal is new nodes and edges shown as ghosts
+(not draggable, selectable or saved). Accepting adds them as one undo step, recorded as made by
+whoever proposed it (`agent:<id>`); rejecting leaves the canvas and its history untouched.
+
+| Tool | Use it to |
+| --- | --- |
+| `propose_nodes` | Suggest nodes and edges without adding them: `title` (also the undo step name), `rationale`, `nodes` (each optional `id`, `type`, `data`, `position`, `width`, `height`, `nearNodeId`, `side`), `edges` (`source`, `target`, `label`). A node with `nearNodeId` (a canvas node or an earlier node of the proposal) is placed beside it and connected from it. Returns `proposalId`, the planned node ids and positions, edge ids and `anchors` (the canvas nodes it builds on). Read ids with `get_editor_state` first. |
+| `list_proposals` | List pending proposals: `id`, `title`, `rationale`, `origin`, nodes, edges, `anchors`, `missing` (anchors since removed: it can no longer be accepted) and the `readOnly` reason if accepting is disabled. Call it before `accept_proposal` or `reject_proposal`. |
+| `accept_proposal` | Add a pending proposal (`proposalId`) to the canvas as one undo step and drop it from the list. Returns the added `nodeIds`, `edgeIds` and `historyLabel`. Refuses, changing nothing, when the canvas is read-only or an anchor is `missing`. Only when the user asked. |
+| `reject_proposal` | Dismiss a pending proposal (`proposalId`): its ghosts go and nothing else changes. Use it to withdraw a suggestion that no longer fits. Returns the `proposalId` and `title`. |
+
 ### Write: components
 
 These are strict-schema tools. Each returns `{ ids }` of what it created or changed, or fails with
@@ -320,6 +341,10 @@ effects provider (for example Flair); without one the read tools say so and the
 
 ## Pitfalls
 
+- **Proposals are not on the canvas.** Their ids are not in `get_editor_state` until accepted, and
+  `canvas_connect` or `canvas_update_node` on them fails. Put the whole idea in one proposal (an
+  edge between two proposed nodes goes in its `edges`), or wait for the user to accept it.
+
 - **A shape node holds one effect.** `apply_effect` replaces the effect that is there. Effects draw on shape nodes only (nodes with `data.shape`).
 - **Effects belong to the provider they came from.** Each saved effect keeps its provider id. After the provider changes (another effects library), check `list_applied_effects` for `available: false` and re-apply those effects with ids from the new provider's `search_effects`; the old effect ids mean nothing to it.
 

package/skills/pixerate-paint-editor/references/light-paint.md

@@ -3,7 +3,8 @@
 Light paint is paint that gives off light: neon, light painting, glow-in-the-dark, glowing glassy
 tubes, glowing watercolour. Any dab, particle, bristle, Mixer Brush, impasto or wet paint brush
 lays it with `light.amount` above 0 (`set_brush`); the Light category presets are ready-made
-(`glow-gel`, `neon-marker`, `light-airbrush`, `spark-trail`, `glow-wash`).
+(`glow-gel`, `neon-marker`, `light-airbrush`, `spark-trail`, `glow-wash`,
+`highlighter`).
 
 - **What it does.** Each layer keeps a light channel next to its colour. The light's colour is the
   paint's colour at that pixel, so recolouring paint recolours its light. It glows (the paint
@@ -22,6 +23,11 @@ lays it with `light.amount` above 0 (`set_brush`); the Light category presets ar
   gradient (`set_paint`) for glowing glass tubes.
 - **Crossings.** Beads on one layer fuse where they cross (their heights combine by maximum), so
   clarity only shows other layers: paint one loop per layer for glassy crossings.
+- **Highlighter** (`highlighter`): fluorescent ink. A transparent chisel marker that multiplies,
+  so it glows a little brighter than the paper and text under it stays dark. Paint it on the
+  layer that holds the text (a tip blend works within its layer), and turn that layer's spill off
+  (`set_light_spill` `radius` 0): fluorescent ink does not light its surroundings, and spill would
+  wash the text out.
 - **Spill vs a glow layer style.** Spill takes each stroke's colour and strength. For a one-colour
   halo around everything on a layer, use a blend or an effect layer instead.
 - **Glowing watercolour** (wet paint brushes with `light.amount`, e.g. `glow-wash`): the light is