@pixerate/editor 0.268.0 → 0.268.2

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.2",
   "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-brushes/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: pixerate-brushes
-description: How to find, describe, create, change, check and share brushes in the Pixerate brush library through list_brush_presets, describe_brush, create_brush, update_brush, duplicate_brush, remove_brush, check_brush, export_brushes, import_brushes, preview_brush, add_brush_source and list_brush_sources - brushes made of facets (kind, medium and variety or tool, tip, marks, dynamics, behaviour, light, motion, colour), image tips and tip grain made from image sources, the built-in presets, and the host profiles that say what the paint editor, image editor, canvas and vector strokes can render. Use when asked to make, design, tweak, save, copy, delete, export, import or check a brush, make a brush from an image (a scanned mark, a leaf, a texture), give a brush grain, find a brush for a medium (pencil, ink, watercolour, oil, airbrush, highlighter), or make a brush work in another editor.
+description: How to find, describe, create, change, check and share brushes in the Pixerate brush library through list_brush_presets, describe_brush, create_brush, update_brush, duplicate_brush, remove_brush, check_brush, export_brushes, import_brushes, import_brush_pack, preview_brush, add_brush_source and list_brush_sources - brushes made of facets (kind, medium and variety or tool, tip, marks, dynamics, behaviour, light, motion, colour), image tips and tip grain made from image sources, the built-in presets, and the host profiles that say what the paint editor, image editor, canvas and vector strokes can render. Use when asked to make, design, tweak, save, copy, delete, export, import or check a brush, make a brush from an image (a scanned mark, a leaf, a texture), give a brush grain, bring in a Photoshop .abr or Procreate .brush / .brushset pack, find a brush for a medium (pencil, ink, watercolour, oil, airbrush, highlighter), or make a brush work in another editor.
 ---
 
 # Brushes
@@ -79,7 +79,10 @@ drawn.
    part; keep the `licence` it came with), then `create_brush` with `tip: { shape: "stamp",
    stamps: ["source:<id>"] }` for an image tip, or `tip.grain.source` for grain.
    `list_brush_sources` lists them and which brushes use each.
-7. **Share it.** `export_brushes` writes a library file; `import_brushes` adds one (version 1
+7. **Bring in a pack.** `import_brush_pack` with the file (base64), its `fileName` and the
+   `licence` it came with. Read `brushes` (with `renderable` for this host), `unsupported` (what
+   was not mapped) and `licence`, then `preview_brush` a few and tune them with `update_brush`.
+8. **Share it.** `export_brushes` writes a library file; `import_brushes` adds one (version 1
    files of the paint editor's older brushes are migrated). `check_brush` with `host` before
    handing a brush to another editor.
 
@@ -132,6 +135,11 @@ drawn.
   not strokes already painted. Objects marks take stickers only, so an image source there is
   dropped (`problems` says so). Brush packs are often licensed for personal use only: keep the
   `licence` text with the source.
+- **Brush packs.** Only the tips (and Procreate grain) are imported: dynamics, pencil curves,
+  patterns, dual brushes and wet settings are listed in `unsupported`, so imported brushes paint
+  with default feel; tune them. Imported image tips are stamp tips, so canvas, vector and the image
+  editor can't paint them (`renderable` false). Packs are often for personal use only: pass and
+  keep their `licence`; never redistribute a library file of imported brushes without checking it.
 - **Out-of-range values** are refused by the schema (`tip.size` is 1..2500 px); a stored brush
   is clamped on import and reported in `problems`.
 - **The paint editor paints from this library.** Its `set_brush` picks a brush by id here and
@@ -159,4 +167,5 @@ drawn.
 | `import_brushes` | Add a library `file` (v2, v1 migrated, or a bare list): built-in ids and taken ids are skipped unless `overwrite`. Returns `added`, `replaced`, `skipped`, `problems`. |
 | `preview_brush` | Only when the host renders previews: a sample stroke with a brush (`id`, `width`, `height`, `color`) as an image. |
 | `add_brush_source` | Add an image (`name`, `image` PNG data: URL, optional `id`, `channel` auto / alpha / darkness / lightness, `invert`, `licence`, `origin`, `overwrite`) as a source for image tips and grain. Returns `id`, `ref` (`source:<id>`), `width`, `height`, `problems`, `replaced`. Then `create_brush` / `update_brush` with the ref in `tip.stamps` or `tip.grain.source`. |
+| `import_brush_pack` | Import a Photoshop `.abr` or Procreate `.brush` / `.brushset` (`file` base64 or a data: URL, `fileName`, optional `format`, `prefix`, `licence`, `overwrite`). Returns `format`, `brushes` (id, name, `renderable` here), `sources`, `skipped`, `unsupported`, `licence`, `problems`. Then `preview_brush` and `update_brush` to tune. |
 | `list_brush_sources` | The library's image sources (`text`, `offset`, `limit`). Returns `sources` (id, ref, name, width, height, licence, origin, `usedBy` brush ids) and `total`. Call before naming a `source:` ref. |

package/skills/pixerate-brushes-design/SKILL.md

@@ -63,6 +63,7 @@ Ask when you cannot tell from the request; say what you assumed when you can.
 | A colour that depends on the background (chalk, white ink) | `colour.default` as a light / dark pair `{ light, dark }`: the editor takes the side for its colour scheme when the brush is chosen. |
 | A shape as the tip (stars, leaves, a logo) | `tip.shape` stamp with `stamps` (an editor stamp or a ref from `find_stickers`), continuous marks; it paints in the user's colour. Keep the sticker's colours with `marks` objects. Paint editor only. |
 | A spray can or mist | `basedOn` `spray-can`, or `medium` spray with `marks` scatter (`density`, `size`). Paint editor only. |
+| From a brush pack the user owns (.abr, .brushset) | `import_brush_pack` with its `licence`, pick the closest imported brush, then `update_brush` its feel (pressure, jitter, grain): packs import tips, not dynamics. |
 | A change to a built-in | `duplicate_brush`, then `update_brush` the copy. |
 | Tune a brush from a host that can't paint all of it | `update_brush` there: what the host can't use is kept (`kept`), not stripped; refused only if the change adds it. |
 
@@ -101,3 +102,4 @@ channel: "darkness" }` → `create_brush` `{ id: "scan-charcoal", name: "Scan ch
 - `check_brush`: prove it works for the host, and get a degraded spec when it doesn't.
 - `preview_brush`: look at a sample stroke when the host renders previews.
 - `add_brush_source`, `list_brush_sources`: images for image tips and grain.
+- `import_brush_pack`: tips and grain from a Photoshop or Procreate pack.

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. |