@pixerate/editor 0.268.1 → 0.269.0

package/dist/vector/index.js

@@ -35,7 +35,7 @@ import {
   traceField,
   traceVectorImage,
   vectorTraceContours
-} from "../chunk-HFY5LG5J.js";
+} from "../chunk-THBJHPUL.js";
 import {
   rasterizeCoverage
 } from "../chunk-ADMRNWR7.js";
@@ -66,7 +66,7 @@ import {
   reverseMorphContour,
   subpathToMorphContour,
   turnMorphContour
-} from "../chunk-QNY7BDFP.js";
+} from "../chunk-4CPOKP27.js";
 import {
   DEFAULT_VECTOR_FONT,
   IDENTITY_MATRIX,
@@ -556,14 +556,14 @@ import {
   withVectorStrokes,
   withVectorTargetPaint,
   zigzagPaths
-} from "../chunk-UVTO3D4E.js";
+} from "../chunk-FUDP5QBB.js";
 import {
   snapshotBrushLibrary
 } from "../chunk-KZI3YWKW.js";
 import "../chunk-JL6YH5WD.js";
 import {
   createProvenance
-} from "../chunk-M6DNZNVY.js";
+} from "../chunk-RWDSSK2I.js";
 import {
   bezierPathBounds,
   bezierPathToSvg,
@@ -615,8 +615,8 @@ import "../chunk-HVVR5PZW.js";
 import {
   deflate
 } from "../chunk-QGHEDC7B.js";
-import "../chunk-SIFAIGB3.js";
-import "../chunk-VDGBHYC7.js";
+import "../chunk-3AJCEJNH.js";
+import "../chunk-F7OO3DHP.js";
 import {
   EDITOR_DOCUMENT_FORMAT,
   defineEditorDocument,

package/package.json

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

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.