@pixerate/editor 0.268.0 → 0.268.1

package/dist/image-editor/index.js

@@ -110,6 +110,7 @@ import {
   applyProcess2Adjustments,
   applyProcess2Float,
   applySmartFilters,
+  assertAdjustmentParams,
   backgroundLayer,
   blackWhiteGray,
   blurFilter,
@@ -408,7 +409,7 @@ import {
   writePsd,
   xyToTempTint,
   xyToUv
-} from "../chunk-74ODPZLX.js";
+} from "../chunk-LDOD7VCT.js";
 import {
   flattenPath,
   rasterizeCoverage
@@ -14005,7 +14006,7 @@ function createImageSelectionTools(controller) {
       properties: {
         layerId: { type: "string", description: "Existing adjustment layer to mask." },
         kind: { type: "string", enum: ADJUSTMENT_KINDS.map((k) => k.kind), description: "Kind of a new layer to add and mask (instead of layerId)." },
-        params: { type: "object", description: "Parameters for the new layer (see list_controls)." },
+        params: { type: "object", description: 'Parameters for the new layer, nested as in add_adjustment_layer: {"master":{"gamma":1.2}}, not dotted control ids.' },
         density: { type: "number", minimum: 0, maximum: 1, description: "Mask density 0-1." },
         feather: { type: "number", minimum: 0, maximum: 1e3, description: "Mask feather in pixels." }
       },
@@ -14025,6 +14026,7 @@ function createImageSelectionTools(controller) {
         controller.applySelectionAsLayerMask(layerId, props);
         id = layerId;
       } else if (isAdjustmentKind(kind)) {
+        assertAdjustmentParams(kind, params);
         id = controller.addAdjustmentLayer({
           kind,
           params,
@@ -18554,12 +18556,12 @@ function createImageEditorToolProvider(controller, options = {}) {
   const addLayer = {
     name: "add_adjustment_layer",
     title: "Add an adjustment layer",
-    description: "Adds a non-destructive adjustment layer on top of the stack (one undoable step) and returns it; with a selection it is masked by it (useSelection, default true; masked in the result says so). clipped clips it to the layer directly below in the same step, so it adjusts only that layer (clipped in the result). Kinds: " + ADJUSTMENT_KINDS.map((k) => k.kind).join(", ") + ". Omitted params are neutral.",
+    description: "Adds a non-destructive adjustment layer on top of the stack (one undoable step) and returns it; with a selection it is masked by it (useSelection, default true; masked in the result says so). clipped clips it to the layer directly below in the same step, so it adjusts only that layer (clipped in the result). Kinds: " + ADJUSTMENT_KINDS.map((k) => k.kind).join(", ") + ". Omitted params are neutral; an unknown or mistyped key is refused with the accepted shape.",
     inputSchema: {
       type: "object",
       properties: {
         kind: { type: "string", enum: ADJUSTMENT_KINDS.map((k) => k.kind), description: "Adjustment kind." },
-        params: { type: "object", description: "Initial parameters (see list_controls); merged with neutral defaults." },
+        params: { type: "object", description: 'Initial parameters, merged with neutral defaults. Nested, not dotted control ids: levels gamma is {"master":{"gamma":1.2}}, not {"master.gamma":1.2}. See list_controls for the ranges.' },
         opacity: { type: "number", minimum: 0, maximum: 1, description: "Layer opacity 0-1 (default 1)." },
         blend: { type: "string", enum: BLEND_MODES.map((m) => m.id), description: "Blend mode (default normal)." },
         name: { type: "string", description: "Layer name shown in the layers panel." },
@@ -18586,6 +18588,7 @@ function createImageEditorToolProvider(controller, options = {}) {
         if (ref !== void 0 && !controller.getLayer(ref)) throw new Error(`Unknown layer "${ref}". Call list_layers for ids.`);
       }
       if (parentId !== void 0 && controller.getLayer(parentId)?.type !== "group") throw new Error(`Layer "${parentId}" is not a group.`);
+      assertAdjustmentParams(kind, params);
       const id = controller.addAdjustmentLayer({ kind, params, opacity, blend, name, aboveId, parentId, useSelection: useSelection !== false, clipped: clipped === true });
       const layer = controller.getAdjustmentLayer(id);
       return { layer: JSON.parse(JSON.stringify(layer)), index: controller.getAdjustmentLayers().findIndex((l) => l.id === id), masked: Boolean(layer.mask), clipped: Boolean(controller.getLayer(id)?.clipped) };
@@ -21836,6 +21839,7 @@ export {
   applyStrokeToDeepTile,
   applyStrokeToTile,
   applyToneToDeepTile,
+  assertAdjustmentParams,
   backgroundLayer,
   base64ToBytes,
   baseProjection,

package/dist/paint-editor/index.cjs

@@ -34,7 +34,7 @@ var _chunk7TD63DZPcjs = require('../chunk-7TD63DZP.cjs');
 
 
 
-var _chunkB3G7BKUVcjs = require('../chunk-B3G7BKUV.cjs');
+var _chunkJ4GXP53Rcjs = require('../chunk-J4GXP53R.cjs');
 require('../chunk-YZWM6ZIP.cjs');
 require('../chunk-3ZRNK3RO.cjs');
 
@@ -2850,11 +2850,11 @@ function header(state, options) {
   return out;
 }
 function serializePaintDocument(state, options = {}) {
-  const { layers, assets } = _chunkB3G7BKUVcjs.serializeLayers.call(void 0, state.layers);
+  const { layers, assets } = _chunkJ4GXP53Rcjs.serializeLayers.call(void 0, state.layers);
   return { ...header(state, options), layers, assets };
 }
 async function serializePaintDocumentExternal(state, store, options = {}) {
-  const { layers, assets } = await _chunkB3G7BKUVcjs.serializeLayersExternal.call(void 0, state.layers, store);
+  const { layers, assets } = await _chunkJ4GXP53Rcjs.serializeLayersExternal.call(void 0, state.layers, store);
   return { ...header(state, options), layers, assets };
 }
 function paintLayersOnly(layers, problems) {
@@ -2891,7 +2891,7 @@ function deserializePaintDocument(raw) {
   const canvas = normalizeCanvas({ width: r.width, height: r.height, dpi: _nullishCoalesce(r.dpi, () => ( void 0)) });
   const paper = _chunkJBB3GDBBcjs.normalizePaper.call(void 0, _nullishCoalesce(r.paper, () => ( {})));
   const assets = r.assets && typeof r.assets === "object" ? r.assets : {};
-  const layers = paintLayersOnly(_chunkB3G7BKUVcjs.deserializeLayers.call(void 0, r.layers, { assets, problems }), problems);
+  const layers = paintLayersOnly(_chunkJ4GXP53Rcjs.deserializeLayers.call(void 0, r.layers, { assets, problems }), problems);
   const wanted = typeof r.activeLayerId === "string" ? r.activeLayerId : null;
   const activeLayerId = wanted && _chunkPVJMTLPJcjs.findLayer.call(void 0, layers, wanted) ? wanted : _nullishCoalesce(_optionalChain([_chunkPVJMTLPJcjs.flattenLayers.call(void 0, layers), 'access', _124 => _124.filter, 'call', _125 => _125((l) => l.type === "pixel"), 'access', _126 => _126.pop, 'call', _127 => _127(), 'optionalAccess', _128 => _128.id]), () => ( null));
   const wetEvents = Array.isArray(r.wetEvents) ? r.wetEvents.filter((e) => e && typeof e === "object" && Number.isInteger(e.clock) && typeof e.kind === "string") : [];
@@ -2907,7 +2907,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 _chunkB3G7BKUVcjs.resolveExternalAssets.call(void 0, _nullishCoalesce(r.assets, () => ( {})), store, problems);
+  const assets = await _chunkJ4GXP53Rcjs.resolveExternalAssets.call(void 0, _nullishCoalesce(r.assets, () => ( {})), store, problems);
   const loaded = deserializePaintDocument({ ...r, assets });
   return { ...loaded, problems: [...problems, ...loaded.problems] };
 }
@@ -7377,7 +7377,7 @@ var PaintEditorController = (_class14 = class _PaintEditorController {
       return next.type === "group" ? { ...next, children: toStandard(next.children) } : next;
     });
     const layers = toStandard(dried);
-    const result = _chunkB3G7BKUVcjs.exportPsd.call(void 0, { width, height, layers: [paperLayer, ...layers], merged, resolution: dpi });
+    const result = _chunkJ4GXP53Rcjs.exportPsd.call(void 0, { width, height, layers: [paperLayer, ...layers], merged, resolution: dpi });
     for (const [mode, names] of changed) {
       const label = _nullishCoalesce(_optionalChain([_chunk2VX55NFMcjs.BLEND_MODES, 'access', _416 => _416.find, 'call', _417 => _417((m) => m.id === mode), 'optionalAccess', _418 => _418.label]), () => ( mode));
       const std = _nullishCoalesce(_optionalChain([_chunk2VX55NFMcjs.BLEND_MODES, 'access', _419 => _419.find, 'call', _420 => _420((m) => m.id === _chunk2VX55NFMcjs.standardBlendMode.call(void 0, mode)), 'optionalAccess', _421 => _421.label]), () => ( _chunk2VX55NFMcjs.standardBlendMode.call(void 0, mode)));
@@ -10710,7 +10710,7 @@ function createPaintEditorToolProvider(controller, options = {}) {
   tools.push(..._chunk62MFUHSIcjs.createPigmentTools.call(void 0, ));
   tools.push(..._chunkPFHJS4HEcjs.createStickerTools.call(void 0, { provider: () => c.stickersProvider }));
   tools.push(
-    ..._chunkB3G7BKUVcjs.createLayerEffectTools.call(void 0, 
+    ..._chunkJ4GXP53Rcjs.createLayerEffectTools.call(void 0, 
       {
         requireLayer: (id) => void c.getLayerEffects(id),
         getLayerEffects: (id) => c.getLayerEffects(id),
@@ -12092,7 +12092,7 @@ function toolList(provider) {
 function uiTables() {
   return {
     tools: PAINT_TOOLS,
-    brushOptions: _chunkB3G7BKUVcjs.BRUSH_OPTION_CONTROLS,
+    brushOptions: _chunkJ4GXP53Rcjs.BRUSH_OPTION_CONTROLS,
     blendMenu: BLEND_MENU_GROUPS,
     layerEffects: _chunkPVJMTLPJcjs.LAYER_EFFECT_MENU.map(({ kind, label }) => ({ kind, label, controls: _chunkPVJMTLPJcjs.layerEffectControls.call(void 0, _chunkPVJMTLPJcjs.defaultLayerEffect.call(void 0, kind, kind)) })),
     sliders: { paper: PAPER_SLIDERS, wet: WET_PARAM_SLIDERS, wetTilt: WET_TILT_SLIDERS, wetSpeed: WET_SPEED_SLIDER, light: LIGHT_SLIDERS, stroke: STROKE_SLIDERS, sticker: STICKER_SLIDERS },

package/dist/paint-editor/index.js

@@ -34,7 +34,7 @@ import {
   resolveExternalAssets,
   serializeLayers,
   serializeLayersExternal
-} from "../chunk-74ODPZLX.js";
+} from "../chunk-LDOD7VCT.js";
 import "../chunk-ADMRNWR7.js";
 import "../chunk-WJ4WQJCC.js";
 import {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pixerate/editor",
-  "version": "0.268.0",
+  "version": "0.268.1",
   "description": "UI-agnostic rich text and media editing core library",
   "author": "Pixerate",
   "license": "MIT",
@@ -375,6 +375,115 @@
       }
     }
   },
+  "typesVersions": {
+    "*": {
+      "grammar": [
+        "./dist/grammar/index.d.ts"
+      ],
+      "extensions": [
+        "./dist/extensions/index.d.ts"
+      ],
+      "serializers": [
+        "./dist/serializers/index.d.ts"
+      ],
+      "spreadsheet": [
+        "./dist/spreadsheet/index.d.ts"
+      ],
+      "history": [
+        "./dist/history/index.d.ts"
+      ],
+      "animation": [
+        "./dist/animation/index.d.ts"
+      ],
+      "animation-editor": [
+        "./dist/animation-editor/index.d.ts"
+      ],
+      "video-editor": [
+        "./dist/video-editor/index.d.ts"
+      ],
+      "canvas": [
+        "./dist/canvas/index.d.ts"
+      ],
+      "agent": [
+        "./dist/agent/index.d.ts"
+      ],
+      "tools": [
+        "./dist/tools/index.d.ts"
+      ],
+      "raster": [
+        "./dist/raster/index.d.ts"
+      ],
+      "cms": [
+        "./dist/cms/index.d.ts"
+      ],
+      "paint": [
+        "./dist/paint/index.d.ts"
+      ],
+      "image-editor": [
+        "./dist/image-editor/index.d.ts"
+      ],
+      "image-editor/selection-worker": [
+        "./dist/image-editor/selection-worker.d.ts"
+      ],
+      "paint-editor": [
+        "./dist/paint-editor/index.d.ts"
+      ],
+      "brushes": [
+        "./dist/brushes/index.d.ts"
+      ],
+      "commands": [
+        "./dist/commands/index.d.ts"
+      ],
+      "persistence": [
+        "./dist/persistence/index.d.ts"
+      ],
+      "generation": [
+        "./dist/generation/index.d.ts"
+      ],
+      "compare": [
+        "./dist/compare/index.d.ts"
+      ],
+      "tokens": [
+        "./dist/tokens/index.d.ts"
+      ],
+      "color": [
+        "./dist/color/index.d.ts"
+      ],
+      "typography": [
+        "./dist/typography/index.d.ts"
+      ],
+      "gradient": [
+        "./dist/gradient/index.d.ts"
+      ],
+      "export": [
+        "./dist/export/index.d.ts"
+      ],
+      "parameters": [
+        "./dist/parameters/index.d.ts"
+      ],
+      "vector": [
+        "./dist/vector/index.d.ts"
+      ],
+      "chart": [
+        "./dist/chart/index.d.ts"
+      ],
+      "chart-maps": [
+        "./dist/chart-maps/index.d.ts"
+      ],
+      "effects": [
+        "./dist/effects/index.d.ts"
+      ],
+      "stickers": [
+        "./dist/stickers/index.d.ts"
+      ],
+      "diagram": [
+        "./dist/diagram/index.d.ts"
+      ],
+      "bridge": [
+        "./dist/bridge/index.d.ts"
+      ]
+    }
+  },
   "bin": {
     "pixerate-mcp-bridge": "./dist/bridge/cli.js"
   },

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

@@ -195,7 +195,7 @@ in the source frame at the document's bit depth, colour mode and profile. Read
 | Tool | Use it to |
 | --- | --- |
 | `set_adjustments` | Set base controls and existing layer parameters in one undo step: `values` is a map of control id or `layers.<layerId>.<controlId>` path to number; `label` is echoed. Values are clamped to range; returns `applied` and `clamped` (and a note when `tint` is set on a process 1 edit). Unknown ids fail and change nothing. Cannot set curves points, booleans or colours. |
-| `add_adjustment_layer` | Add a layer above the other adjustment layers and below annotations (or directly above `aboveId`, or at the top of group `parentId`): `kind` (curves, levels, hueSaturation, vibrance, colorBalance, blackWhite, photoFilter, invert, posterize, threshold), optional `params` merged with neutral defaults, `opacity` 0..1 (default 1), `blend` (default normal), `name`. With a selection the layer is masked by it (`useSelection`, default true; `false` for a global layer; `masked` in the result). `clipped: true` (with `aboveId`) clips it to the layer below in the same undo step so it adjusts only that layer; refused when nothing is below. Returns the layer (with its new id), its stack index, `masked` and `clipped`. The only tool that sets curves points, `colorize`, `preserveLuminosity`, a black and white `tint` or a photo filter `color`. |
+| `add_adjustment_layer` | Add a layer above the other adjustment layers and below annotations (or directly above `aboveId`, or at the top of group `parentId`): `kind` (curves, levels, hueSaturation, vibrance, colorBalance, blackWhite, photoFilter, invert, posterize, threshold), optional `params` merged with neutral defaults and nested, not dotted (`{ master: { gamma: 1.2 } }`, never `{ "master.gamma": 1.2 }`; an unknown or mistyped key is refused and the error lists the accepted shape), `opacity` 0..1 (default 1), `blend` (default normal), `name`. With a selection the layer is masked by it (`useSelection`, default true; `false` for a global layer; `masked` in the result). `clipped: true` (with `aboveId`) clips it to the layer below in the same undo step so it adjusts only that layer; refused when nothing is below. Returns the layer (with its new id), its stack index, `masked` and `clipped`. The only tool that sets curves points, `colorize`, `preserveLuminosity`, a black and white `tint` or a photo filter `color`. |
 | `select_all` | Select › All. Returns the selection summary (`empty`, `bounds`, `area`, `percent`). |
 | `deselect` | Clear the selection so edits apply to the whole layer. Returns the empty summary. |
 | `invert_selection` | Select › Inverse (soft edges stay soft; with nothing selected, selects all). Returns the summary. |