@pixerate/editor 0.267.0 → 0.268.1

package/dist/vector/index.js

@@ -35,7 +35,7 @@ import {
   traceField,
   traceVectorImage,
   vectorTraceContours
-} from "../chunk-YIC6MAJ2.js";
+} from "../chunk-HFY5LG5J.js";
 import {
   rasterizeCoverage
 } from "../chunk-ADMRNWR7.js";
@@ -66,7 +66,7 @@ import {
   reverseMorphContour,
   subpathToMorphContour,
   turnMorphContour
-} from "../chunk-OSEXT7JL.js";
+} from "../chunk-QNY7BDFP.js";
 import {
   DEFAULT_VECTOR_FONT,
   IDENTITY_MATRIX,
@@ -556,10 +556,10 @@ import {
   withVectorStrokes,
   withVectorTargetPaint,
   zigzagPaths
-} from "../chunk-4IDUYB45.js";
+} from "../chunk-UVTO3D4E.js";
 import {
   snapshotBrushLibrary
-} from "../chunk-AGNUD5BI.js";
+} from "../chunk-KZI3YWKW.js";
 import "../chunk-JL6YH5WD.js";
 import {
   createProvenance
@@ -598,19 +598,19 @@ import {
 } from "../chunk-MV7CYFMJ.js";
 import "../chunk-V2ZCJRDM.js";
 import "../chunk-GSTSZPSR.js";
+import "../chunk-W6JDUXP3.js";
 import {
   GRAIN_PATTERNS
-} from "../chunk-TXFWZ5ZJ.js";
-import "../chunk-GCVFEPJG.js";
+} from "../chunk-ACTHSQOI.js";
 import "../chunk-4D6KP5BV.js";
 import "../chunk-ODBT55Q7.js";
+import "../chunk-IRSTHLQQ.js";
 import {
   bytesToBase64,
   decodePng,
   isPng,
   parseDataUrl
 } from "../chunk-OTTT5N3K.js";
-import "../chunk-IRSTHLQQ.js";
 import "../chunk-HVVR5PZW.js";
 import {
   deflate

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pixerate/editor",
-  "version": "0.267.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-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 and preview_brush - brushes made of facets (kind, medium and variety or tool, tip, marks, dynamics, behaviour, light, motion, colour), 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, 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, 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.
 ---
 
 # Brushes
@@ -15,9 +15,9 @@ built-in presets (read-only) and the user's brushes, shared by every editor that
 | Kind | `mark` lays a material; `tool` works on paint already down. |
 | Medium and variety | Marks: what it lays (`paint`, `ink`, `dry`, `spray`) and what kind (`oil`, `watercolor`, `gouache`, `pencil`, `charcoal`, `airbrush`, `marker`, `highlighter`…). Descriptive, for finding brushes; a wet brush whose variety is `watercolor`, `gouache` or `oil` paints that medium. |
 | Tool | Tools: `eraser`, `blender`, `smudge`, and on wet paint `water`, `dryer`, `blow`, `blot`, `wet-blend`, `wet-drag`. |
-| Tip | `shape` (`round`, `flat`, `chisel` are ellipses set by `roundness` and `angle`; `bristle` has a tuft; `stamp` takes the shape of `stamps`: an editor stamp `editor:star` or any sticker ref from `find_stickers`), size in px, hardness, spacing, opacity, flow, blend mode. |
+| Tip | `shape` (`round`, `flat`, `chisel` are ellipses set by `roundness` and `angle`; `bristle` has a tuft; `stamp` takes the shape of `stamps`: an editor stamp `editor:star`, any sticker ref from `find_stickers`, or an image source `source:<id>` from `list_brush_sources`), size in px, hardness (an image tip fades towards its edges below 1), spacing, opacity, flow, blend mode, and `grain`: texture inside each dab (`source`: a pattern such as `rough`, `canvas`, `sanded`, or `source:<id>`; `mode` `texturised` stays put on the canvas, `moving` rolls with the tip; `scale`, `depth`, `contrast`, `invert`). |
 | Marks | `continuous` dabs (default; on a stamp tip every dab is the first stamp's shape, in the paint colour), `scatter` (a spray: droplets across the tip, `density`, `size`), `particles` (strands, springs, ribbons, sparks; textured dots from the stamps) or `objects` (each mark an editable sticker, in its own colours). |
-| Dynamics | Pen feel: pressure to size and opacity, smoothing, tilt, velocity, jitter, rotation. |
+| Dynamics | Pen feel: pressure to size and opacity, smoothing, tilt, velocity, jitter (`sizeJitter`, `angleJitter` for rotation, `opacityJitter`, `scatter`), rotation, `count` (dabs per spacing step, each jittered) and `flip` (mirror dabs at random: `x`, `y`, `xy`). |
 | Behaviour | `surface` `dry`, `wet` (`wet` settings) or `thick` (`thick` impasto settings); paper `grain`; `exchange` (pick-up and mix; a `reservoir` makes a Mixer Brush); tool `strength`. |
 | Light | Light the brush gives off (`amount`), plus suggested layer `spill` and `glow`. |
 | Motion | Animation after painting (live effect paint, particle `waveSpeed`). |
@@ -31,7 +31,16 @@ and **wet oil** are `paint` on `surface: 'wet'`; **impasto** is `surface: 'thick
 pressure to size); **crayon** and **chalk** are `dry` with high `grain`; a **highlighter** is
 `ink` / `highlighter`, a multiply chisel tip with a little light, `spill` radius 0, fluorescent
 yellow by default; a **stamp brush** is a `stamp` tip with continuous marks; **particle** and
-**sticker** brushes are `marks` particles or objects on a `stamp` tip.
+**sticker** brushes are `marks` particles or objects on a `stamp` tip. An **image brush** (a
+scanned charcoal mark, a leaf, a dry-brush texture) is a `stamp` tip whose stamp is an image
+source, usually with `tip.grain`, `angleJitter`, `flip` and a little `scatter` so repeats don't
+show.
+
+**Image sources** are the images tips and grain are made from, kept in the library with their
+bytes (a grey mask, at most 512 px) and their licence. `add_brush_source` makes one from a PNG:
+the marks are read from its transparency, its dark parts (a scan on paper) or its light parts
+(white on black). Library files (`export_brushes`) and saved paintings carry the sources their
+brushes name, so they paint and replay the same anywhere.
 
 ## Host profiles
 
@@ -40,9 +49,9 @@ paints without (warnings), each with a fix; lists and writes use the current hos
 
 | Host | Renders |
 | --- | --- |
-| Paint editor (`paint`) | Everything. |
-| Image editor (`image`) | Dry dabs on round, flat and chisel tips, the Mixer Brush and the eraser; no wet or thick surface, particles, objects, light or motion. Pick one with `set_brush_preset`. |
-| Canvas (`canvas`) | Dry dab brushes along a path (no tools, wet, thick, particles, objects or light); velocity is ignored. Draw with one as `canvas.drawFreehand` `brush`. |
+| Paint editor (`paint`) | Everything, image tips and tip grain included. |
+| Image editor (`image`) | Dry dabs on round, flat and chisel tips, the Mixer Brush and the eraser; no wet or thick surface, particles, objects, stamp or image tips, light or motion; it paints without tip grain and `count`. Pick one with `set_brush_preset`. |
+| Canvas (`canvas`) | Dry dab brushes along a path (no tools, wet, thick, particles, objects, stamp or image tips, or light); velocity, tip grain and `count` are ignored. Draw with one as `canvas.drawFreehand` `brush`. |
 | Vector strokes (`vector`) | As canvas, plus wet paint (watercolour, gouache, wet oils: simulated in the stroke's own area, then dried), the Mixer Brush, and the smudge and blender tools (acting on the shapes beneath the stroke); light brushes paint as plain colour. The wet tools (water, hair dryer, blow, wet blend, wet drag, blot), thick paint, particles, objects and erasers are refused. Draw with one as `vector.addBrushstroke` `brushId`. |
 
 Every host lists the presets its profile admits and the library's saved brushes it admits, and
@@ -66,7 +75,11 @@ drawn.
    in the editor (`set_brush` with the new id, then `paint_stroke`).
 5. **Tune it.** `update_brush` with the facets to change, or `unset` to drop whole facets. It
    returns the leaf paths `changed`. Built-in presets can't be changed: `duplicate_brush` first.
-6. **Share it.** `export_brushes` writes a library file; `import_brushes` adds one (version 1
+6. **From an image.** `add_brush_source` with the PNG (`channel` when `auto` picks the wrong
+   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
    files of the paint editor's older brushes are migrated). `check_brush` with `host` before
    handing a brush to another editor.
 
@@ -92,6 +105,13 @@ drawn.
   to make its preview visible: choosing the brush makes that default the user's colour.
 - Stamp tips paint the sticker's shape in the paint colour; to keep a sticker's own colours, use
   `marks` objects instead.
+- Image tips: crop the image to the mark and give it a transparent or plain background, so the
+  dab is the mark and not its box. Spacing 0.2–0.4 for a continuous mark, above 1 for separate
+  prints; add `angleJitter`, `flip` and `scatter` so the same image doesn't repeat visibly.
+- Grain: `texturised` grain (default) is a texture the stroke reveals, like paper; `moving` grain
+  belongs to the tip and rolls with it (a sponge, a roller). Depth 0.4–0.7 reads as texture;
+  1 leaves only the peaks. Use `tip.grain` for the tool's texture and `behaviour.grain` for the
+  paper's.
 
 ## Pitfalls
 
@@ -107,6 +127,11 @@ drawn.
   (`editor:star`…). A ref the host's sticker library can't load is refused with the closest
   refs. Only the paint editor renders stamp tips and scatter marks; canvas, vector and the image
   editor refuse them (`check_brush` says so).
+- **Image sources.** A `source:<id>` the library doesn't have is refused, with the closest ids;
+  add it first. Replacing a source's image (`overwrite`) changes every brush that names it, but
+  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.
 - **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
@@ -133,3 +158,5 @@ drawn.
 | `export_brushes` | Library file (pixerate-brushes v2) of the saved brushes or the `ids` given. Returns `file`, for `import_brushes`. |
 | `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`. |
+| `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

@@ -57,7 +57,8 @@ Ask when you cannot tell from the request; say what you assumed when you can.
 | For canvas strokes | Base on a dry preset (pencil, pastel, charcoal, marker, ink); no wet surface, particles, stickers or tools; no light. |
 | For vector strokes | As canvas, but a wet surface (watercolour, gouache, wet oil), the Mixer Brush and the smudge and blender tools work too; no thick paint, particles, stickers, erasers or wet tools. |
 | A brush that must work in another editor | `check_brush` with that `host`, then `create_brush` from its `degraded` brush under a new id. |
-| A texture (chalk, charcoal, dry brush) | Raise `behaviour.grain` (0.8..1) and add `dynamics.sizeJitter`; test on rough paper. |
+| A texture (chalk, charcoal, dry brush) | Raise `behaviour.grain` (0.8..1) and add `dynamics.sizeJitter`; test on rough paper. For texture that shows on any paper, give the tip its own grain: `tip.grain` `{ source: "sanded", depth: 0.6 }` (paint editor; other hosts paint without it). |
+| A brush from an image (a scanned mark, a leaf, a texture) | `list_brush_sources`, or `add_brush_source` with the PNG (keep its `licence`); then `tip` `{ shape: "stamp", stamps: ["source:<id>"] }`, spacing 0.2–0.4, `dynamics.angleJitter`, `flip` and a little `scatter`. The image as grain instead: `tip.grain.source`. Paint editor only. |
 | A light brush (neon, glow) | `light.amount`, and paint it on dark paper; a highlighter keeps `light.spill.radius` 0. |
 | 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. |
@@ -74,6 +75,11 @@ basedOn: "highlighter", colour: { default: "#ff6ec7" } }`, then `check_brush`.
 `{ id: "board-chalk", name: "Board chalk", basedOn: "chalk", colour: { default: { light:
 "#334155", dark: "#f8fafc" } } }`: white chalk in dark mode, slate on light paper.
 
+**A charcoal brush from a scan.** `add_brush_source` `{ name: "Charcoal scan", image: <PNG>,
+channel: "darkness" }` → `create_brush` `{ id: "scan-charcoal", name: "Scan charcoal", basedOn:
+"charcoal-stick", tip: { shape: "stamp", stamps: ["source:charcoal-scan"], spacing: 0.25, grain:
+{ source: "rough", depth: 0.5 } }, dynamics: { angleJitter: 0.3, flip: "xy" } }` → `preview_brush`.
+
 **Port a wet brush to vector.** `check_brush` `{ id, host: "vector" }`; `create_brush` from the
 `degraded` brush with `id` `<id>-vector`; `check_brush` again.
 
@@ -94,3 +100,4 @@ basedOn: "highlighter", colour: { default: "#ff6ec7" } }`, then `check_brush`.
 - `create_brush`, `update_brush`, `duplicate_brush`: make and tune the brush.
 - `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.

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

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

@@ -42,6 +42,12 @@ is never part of a layer. Coordinates are document pixels, (0, 0) top-left, y do
   same two ratios. `get_mixer_brush` reads what the brush carries; `clean_mixer_brush` wipes it.
 - **Grain**: a brush's grain response times the paper's `depth` decides how much light pressure
   skips the valleys. Pencil, pastel and charcoal are grainy; airbrush, marker and ink are not.
+  A brush can also carry its own texture, `tip.grain` (a pattern such as `sanded` or `canvas`, or
+  an image source; `texturised` stays put, `moving` rolls with the tip), which shows on any paper.
+- **Image tips**: a stamp tip whose stamp is an image source (`source:<id>`, added with the
+  brush library's `add_brush_source`) paints every dab as that image in the paint colour, with
+  hardness, roundness, angle, pressure size, `dynamics.count`, `flip` and jitter. Strokes record
+  the source, and the saved painting carries its bytes, so replays and exports match.
 - **Strokes are data.** Every stroke is recorded (brush, colour, raw points, seed, symmetry
   copies) and gets a `strokeId`. `replay_strokes` paints recorded strokes again, exactly or
   varied. That is the main way an agent should make many similar marks.

package/skills/pixerate-paint-editor/references/brush-facets.md

@@ -8,7 +8,9 @@ more; this is where each one went.
 | Engine setting | Facet |
 | --- | --- |
 | Tip size, hardness, spacing, angle, roundness, opacity, flow, blend | `tip` |
-| Smoothing, pressure, tilt, velocity, jitter, scatter, rotation | `dynamics` |
+| Smoothing, pressure, tilt, velocity, jitter, scatter, rotation, dabs per step (`count`), random `flip` | `dynamics` |
+| Image tip | `tip` `{ shape: 'stamp', stamps: ['source:<id>'] }` (an image source from `add_brush_source`) |
+| Texture inside the tip | `tip.grain` `{ source: 'sanded' or 'source:<id>', mode: 'texturised' or 'moving', scale, depth, contrast, invert }` |
 | Grain, pick-up and mix (behavior), blender and smudge strength | `behaviour` (`grain`, `exchange`, `strength`, `distance`, `length`, `mixing`) |
 | Mixer Brush reservoir | `behaviour.exchange.reservoir` (`load`, `refill`, `loadsColour`) |
 | Wet engine (medium, water, pigment, body…) | `behaviour.surface` `wet` and `behaviour.wet` |

package/skills/pixerate-paint-sketch-to-finish/SKILL.md

@@ -66,6 +66,7 @@ This skill is the method. `pixerate-paint-editor` has the full tool reference.
 | Clean geometric lines (curves, circles, borders) | `stroke_path` with SVG path data and a `pressure` taper, on the Ink layer |
 | Flats | `marker` or a flat brush on a layer under the ink |
 | Patterned or textured flats (sky, gradient, galaxy) | `set_effect_paint` with a provider generator, then a flat dry brush on the Flats layer; `set_color` after |
+| Textured passes (dry brush, sponge, foliage) | A brush with `tip.grain` (`set_brush` `{ tip: { grain: { source: "sanded", depth: 0.6 } } }`) or an image tip from the brush library, with `dynamics.angleJitter` and `flip` so repeats don't show |
 | Shadows | Clipped layer, `multiply` or `shadow`, a cool colour |
 | Light, glow | Clipped layer, `highlight` or `screen` |
 | Warm or cool a whole area | Clipped layer in `tint` |