@pixerate/editor 0.256.0 → 0.258.0

package/dist/paint-editor/mark-settings.d.cts

@@ -79,7 +79,7 @@ export interface ParticleSettings {
     /** Wave: how far out of step the particles' waves are (0: all in step; 1: random phases). */
     wavePhaseJitter: number;
     /** Dots and beads: up to four sticker stamps drawn instead of round marks (empty: round). */
-    dotTextures: StampKind[];
+    dotTextures: Array<StampKind | `${string}:${string}`>;
     dotTextureOrder: DotTextureOrder;
     dotRotation: DotRotation;
 }

package/dist/paint-editor/mark-settings.d.ts

@@ -79,7 +79,7 @@ export interface ParticleSettings {
     /** Wave: how far out of step the particles' waves are (0: all in step; 1: random phases). */
     wavePhaseJitter: number;
     /** Dots and beads: up to four sticker stamps drawn instead of round marks (empty: round). */
-    dotTextures: StampKind[];
+    dotTextures: Array<StampKind | `${string}:${string}`>;
     dotTextureOrder: DotTextureOrder;
     dotRotation: DotRotation;
 }

package/dist/paint-editor/procedural.d.cts

@@ -28,7 +28,7 @@ import type { PaintBrush } from './brushes.cjs';
 import { type EffectPaintPixels } from './effect-paint.cjs';
 import { PenDabWalker, PenSmoother, type PenDab, type PenPoint, type StrokeCopy } from './engine.cjs';
 import { type PaperGrain } from './paper.cjs';
-import type { StampKind } from './mark-settings.cjs';
+import type { StickerArtLookup } from './sticker-art.cjs';
 export { DEFAULT_BRISTLE, DEFAULT_PARTICLE, DOT_ROTATIONS, DOT_TEXTURE_ORDERS, MAX_DOT_TEXTURES, normalizeBristle, normalizeParticle, PARTICLE_KINDS, PARTICLE_RENDERS, RIBBON_PAIRS, type BristleSettings, type DotRotation, type DotTextureOrder, type ParticleKind, type ParticleRender, type ParticleSettings, type RibbonPairs, } from './mark-settings.cjs';
 export interface ProceduralStrokeOptions {
     grain: PaperGrain | null;
@@ -39,6 +39,8 @@ export interface ProceduralStrokeOptions {
     paint?: PaintGradientSource | null;
     /** Effect paint: each pixel of a mark takes its colour (and alpha) from these canvas-sized pixels. */
     effect?: EffectPaintPixels | null;
+    /** Loaded sticker art, for textured dots of stickers from the sticker library. */
+    stampArt?: StickerArtLookup;
 }
 /** What a coverage-building stroke engine provides to the stroke session. */
 export interface CoverageStroke {
@@ -81,7 +83,7 @@ declare abstract class MarkStroke implements CoverageStroke {
      * Stamps a textured mark: `kind` from the sticker stamps over a square of half-size `r`, turned
      * `rotation` radians clockwise, with flow `alpha` towards `opacity`. Small marks are supersampled.
      */
-    protected stamp(x: number, y: number, r: number, kind: StampKind, rotation: number, seed: number, alpha: number, opacity: number, pressure: number, rects: RasterRect[]): void;
+    protected stamp(x: number, y: number, r: number, kind: string, rotation: number, seed: number, alpha: number, opacity: number, pressure: number, rects: RasterRect[]): void;
     /** A scratch buffer of `n` values (reused; valid until the next mark). */
     protected scratch(n: number): Float32Array;
     /**

package/dist/paint-editor/procedural.d.ts

@@ -28,7 +28,7 @@ import type { PaintBrush } from './brushes.js';
 import { type EffectPaintPixels } from './effect-paint.js';
 import { PenDabWalker, PenSmoother, type PenDab, type PenPoint, type StrokeCopy } from './engine.js';
 import { type PaperGrain } from './paper.js';
-import type { StampKind } from './mark-settings.js';
+import type { StickerArtLookup } from './sticker-art.js';
 export { DEFAULT_BRISTLE, DEFAULT_PARTICLE, DOT_ROTATIONS, DOT_TEXTURE_ORDERS, MAX_DOT_TEXTURES, normalizeBristle, normalizeParticle, PARTICLE_KINDS, PARTICLE_RENDERS, RIBBON_PAIRS, type BristleSettings, type DotRotation, type DotTextureOrder, type ParticleKind, type ParticleRender, type ParticleSettings, type RibbonPairs, } from './mark-settings.js';
 export interface ProceduralStrokeOptions {
     grain: PaperGrain | null;
@@ -39,6 +39,8 @@ export interface ProceduralStrokeOptions {
     paint?: PaintGradientSource | null;
     /** Effect paint: each pixel of a mark takes its colour (and alpha) from these canvas-sized pixels. */
     effect?: EffectPaintPixels | null;
+    /** Loaded sticker art, for textured dots of stickers from the sticker library. */
+    stampArt?: StickerArtLookup;
 }
 /** What a coverage-building stroke engine provides to the stroke session. */
 export interface CoverageStroke {
@@ -81,7 +83,7 @@ declare abstract class MarkStroke implements CoverageStroke {
      * Stamps a textured mark: `kind` from the sticker stamps over a square of half-size `r`, turned
      * `rotation` radians clockwise, with flow `alpha` towards `opacity`. Small marks are supersampled.
      */
-    protected stamp(x: number, y: number, r: number, kind: StampKind, rotation: number, seed: number, alpha: number, opacity: number, pressure: number, rects: RasterRect[]): void;
+    protected stamp(x: number, y: number, r: number, kind: string, rotation: number, seed: number, alpha: number, opacity: number, pressure: number, rects: RasterRect[]): void;
     /** A scratch buffer of `n` values (reused; valid until the next mark). */
     protected scratch(n: number): Float32Array;
     /**

package/dist/paint-editor/stamp-tip.d.cts

@@ -0,0 +1,45 @@
+/**
+ * Stamp tips: a dab, a particle dot or a spray droplet shaped like a sticker instead of the round
+ * computed tip. An editor stamp (`editor:star`, or a bare `star`) is drawn from its coverage
+ * function; any other sticker ref from its loaded art (`StickerArtCache`), by its alpha. The mark
+ * is laid in the paint colour: a stamp tip takes the sticker's shape, never its colours (keep
+ * those with `marks: objects`, which lays editable stickers).
+ */
+import type { RasterRect as CropBox } from '../raster/surface.cjs';
+import type { StickerArtLookup } from './sticker-art.cjs';
+/** Coverage 0..1 of a stamp at (u, v) of its unit square (−1..1, y down); `seed` varies shapes with random parts. */
+export type StampSampler = (u: number, v: number, seed: number) => number;
+/**
+ * The sampler of a stamp ref: an editor stamp's coverage, or the alpha of a sticker's loaded art
+ * (bilinear, centred in the unit square, aspect kept). `null` when the art is not loaded (or the
+ * ref is not a sticker): the caller paints the round tip instead.
+ */
+export declare function stampSampler(ref: string, art?: StickerArtLookup): StampSampler | null;
+/** A dab of a stamp tip: centre, radius (px), roundness squashing it across, angle (radians, counter-clockwise) and flow. */
+export interface StampDab {
+    x: number;
+    y: number;
+    radius: number;
+    roundness: number;
+    angle: number;
+    alpha: number;
+}
+/** The pixel rectangle a stamp dab can touch. */
+export declare function stampDabRect(d: StampDab): CropBox;
+/**
+ * Rasterizes one stamp dab over `rect` into `out` (coverage × flow): the stamp's unit square spans
+ * the tip's diameter, squashed by roundness and turned by the tip angle as a round tip would be.
+ * Small dabs are supersampled.
+ */
+export declare function rasterizeStampDab(d: StampDab, sample: StampSampler, seed: number, rect: CropBox, out: Float32Array): void;
+/** The sticker refs a brush lays that need loaded art (provider stickers; editor stamps need none). */
+export declare function brushStickerRefs(brush: {
+    engine: string;
+    stamp: string | null;
+    sticker: {
+        stamps: readonly string[];
+    };
+    particle: {
+        dotTextures: readonly string[];
+    };
+}): string[];

package/dist/paint-editor/stamp-tip.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Stamp tips: a dab, a particle dot or a spray droplet shaped like a sticker instead of the round
+ * computed tip. An editor stamp (`editor:star`, or a bare `star`) is drawn from its coverage
+ * function; any other sticker ref from its loaded art (`StickerArtCache`), by its alpha. The mark
+ * is laid in the paint colour: a stamp tip takes the sticker's shape, never its colours (keep
+ * those with `marks: objects`, which lays editable stickers).
+ */
+import type { RasterRect as CropBox } from '../raster/surface.js';
+import type { StickerArtLookup } from './sticker-art.js';
+/** Coverage 0..1 of a stamp at (u, v) of its unit square (−1..1, y down); `seed` varies shapes with random parts. */
+export type StampSampler = (u: number, v: number, seed: number) => number;
+/**
+ * The sampler of a stamp ref: an editor stamp's coverage, or the alpha of a sticker's loaded art
+ * (bilinear, centred in the unit square, aspect kept). `null` when the art is not loaded (or the
+ * ref is not a sticker): the caller paints the round tip instead.
+ */
+export declare function stampSampler(ref: string, art?: StickerArtLookup): StampSampler | null;
+/** A dab of a stamp tip: centre, radius (px), roundness squashing it across, angle (radians, counter-clockwise) and flow. */
+export interface StampDab {
+    x: number;
+    y: number;
+    radius: number;
+    roundness: number;
+    angle: number;
+    alpha: number;
+}
+/** The pixel rectangle a stamp dab can touch. */
+export declare function stampDabRect(d: StampDab): CropBox;
+/**
+ * Rasterizes one stamp dab over `rect` into `out` (coverage × flow): the stamp's unit square spans
+ * the tip's diameter, squashed by roundness and turned by the tip angle as a round tip would be.
+ * Small dabs are supersampled.
+ */
+export declare function rasterizeStampDab(d: StampDab, sample: StampSampler, seed: number, rect: CropBox, out: Float32Array): void;
+/** The sticker refs a brush lays that need loaded art (provider stickers; editor stamps need none). */
+export declare function brushStickerRefs(brush: {
+    engine: string;
+    stamp: string | null;
+    sticker: {
+        stamps: readonly string[];
+    };
+    particle: {
+        dotTextures: readonly string[];
+    };
+}): string[];

package/dist/paint-editor/stroke.d.cts

@@ -26,6 +26,8 @@ export interface StrokeSessionHost {
     update(layerId: string, surface: TiledSurface, rects: RasterRect[]): void;
     /** Ends the stroke: `surface` is the new pixels, or `null` when nothing changed / it was cancelled. */
     commit(session: PaintStrokeSession, surface: TiledSurface | null, cancelled: boolean): void;
+    /** Hears the raw samples as they arrive (after the input filter), before they are painted. */
+    sampled?(session: PaintStrokeSession, points: readonly PenPoint[]): void;
 }
 export interface StrokeSessionInit {
     layerId: string;
@@ -77,6 +79,8 @@ export interface StrokeSessionInit {
         nextId: number;
         art?: StickerArtLookup;
     };
+    /** Loaded sticker art for stamp tips and textured particle dots of stickers from the sticker library. */
+    stampArt?: StickerArtLookup;
     /** Gradient paint (resolved: concrete colours), or `null` for the one colour. Recorded with the stroke. */
     paint?: PaintGradientSource | null;
     /**

package/dist/paint-editor/stroke.d.ts

@@ -26,6 +26,8 @@ export interface StrokeSessionHost {
     update(layerId: string, surface: TiledSurface, rects: RasterRect[]): void;
     /** Ends the stroke: `surface` is the new pixels, or `null` when nothing changed / it was cancelled. */
     commit(session: PaintStrokeSession, surface: TiledSurface | null, cancelled: boolean): void;
+    /** Hears the raw samples as they arrive (after the input filter), before they are painted. */
+    sampled?(session: PaintStrokeSession, points: readonly PenPoint[]): void;
 }
 export interface StrokeSessionInit {
     layerId: string;
@@ -77,6 +79,8 @@ export interface StrokeSessionInit {
         nextId: number;
         art?: StickerArtLookup;
     };
+    /** Loaded sticker art for stamp tips and textured particle dots of stickers from the sticker library. */
+    stampArt?: StickerArtLookup;
     /** Gradient paint (resolved: concrete colours), or `null` for the one colour. Recorded with the stroke. */
     paint?: PaintGradientSource | null;
     /**

package/dist/stickers/index.cjs

@@ -3,13 +3,15 @@
 
 
 
+var _chunkRVGP2XLFcjs = require('../chunk-RVGP2XLF.cjs');
 
 
 
 
 
 
-var _chunkSABJMH6Mcjs = require('../chunk-SABJMH6M.cjs');
+
+var _chunkAVTPZO4Zcjs = require('../chunk-AVTPZO4Z.cjs');
 
 
 
@@ -334,4 +336,4 @@ async function checkStickerProvider(provider, options = {}) {
 
 
 
-exports.DEFAULT_STICKER_PAGE = _chunkJSDND7DFcjs.DEFAULT_STICKER_PAGE; exports.EDITOR_STICKERS_ID = _chunkJSDND7DFcjs.EDITOR_STICKERS_ID; exports.MAX_STICKER_PAGE = _chunkJSDND7DFcjs.MAX_STICKER_PAGE; exports.STAMP_KINDS = _chunkJSDND7DFcjs.STAMP_KINDS; exports.StickerBrowser = _chunkSABJMH6Mcjs.StickerBrowser; exports.StickerError = _chunkU67EN7GGcjs.StickerError; exports.StickersSlot = _chunkJSDND7DFcjs.StickersSlot; exports.checkStickerProvider = checkStickerProvider; exports.checkStickerSearchOptions = _chunkJSDND7DFcjs.checkStickerSearchOptions; exports.closestStickerRefs = _chunkJSDND7DFcjs.closestStickerRefs; exports.combineStickerProviders = combineStickerProviders; exports.createFakeStickerProvider = createFakeStickerProvider; exports.createInsertStickerTool = _chunkSABJMH6Mcjs.createInsertStickerTool; exports.createStickerToolProvider = _chunkSABJMH6Mcjs.createStickerToolProvider; exports.createStickerTools = _chunkSABJMH6Mcjs.createStickerTools; exports.describeStickerRef = _chunkSABJMH6Mcjs.describeStickerRef; exports.editorStampOf = _chunkJSDND7DFcjs.editorStampOf; exports.editorStickers = _chunkSABJMH6Mcjs.editorStickers; exports.insertSticker = _chunkSABJMH6Mcjs.insertSticker; exports.normalizeStickerRef = _chunkJSDND7DFcjs.normalizeStickerRef; exports.parseStickerRef = _chunkJSDND7DFcjs.parseStickerRef; exports.stampCoverage = _chunkJSDND7DFcjs.stampCoverage; exports.stampOutline = _chunkSABJMH6Mcjs.stampOutline; exports.stampPixels = _chunkSABJMH6Mcjs.stampPixels; exports.stickerForAgent = _chunkSABJMH6Mcjs.stickerForAgent; exports.stickerIdFor = _chunkJSDND7DFcjs.stickerIdFor; exports.stickerPage = _chunkJSDND7DFcjs.stickerPage; exports.stickerRefOf = _chunkJSDND7DFcjs.stickerRefOf;
+exports.DEFAULT_STICKER_PAGE = _chunkJSDND7DFcjs.DEFAULT_STICKER_PAGE; exports.EDITOR_STICKERS_ID = _chunkJSDND7DFcjs.EDITOR_STICKERS_ID; exports.MAX_STICKER_PAGE = _chunkJSDND7DFcjs.MAX_STICKER_PAGE; exports.STAMP_KINDS = _chunkJSDND7DFcjs.STAMP_KINDS; exports.StickerBrowser = _chunkRVGP2XLFcjs.StickerBrowser; exports.StickerError = _chunkU67EN7GGcjs.StickerError; exports.StickersSlot = _chunkJSDND7DFcjs.StickersSlot; exports.checkStickerProvider = checkStickerProvider; exports.checkStickerSearchOptions = _chunkJSDND7DFcjs.checkStickerSearchOptions; exports.closestStickerRefs = _chunkJSDND7DFcjs.closestStickerRefs; exports.combineStickerProviders = combineStickerProviders; exports.createFakeStickerProvider = createFakeStickerProvider; exports.createInsertStickerTool = _chunkAVTPZO4Zcjs.createInsertStickerTool; exports.createStickerToolProvider = _chunkAVTPZO4Zcjs.createStickerToolProvider; exports.createStickerTools = _chunkAVTPZO4Zcjs.createStickerTools; exports.describeStickerRef = _chunkAVTPZO4Zcjs.describeStickerRef; exports.editorStampOf = _chunkJSDND7DFcjs.editorStampOf; exports.editorStickers = _chunkRVGP2XLFcjs.editorStickers; exports.insertSticker = _chunkAVTPZO4Zcjs.insertSticker; exports.normalizeStickerRef = _chunkJSDND7DFcjs.normalizeStickerRef; exports.parseStickerRef = _chunkJSDND7DFcjs.parseStickerRef; exports.stampCoverage = _chunkJSDND7DFcjs.stampCoverage; exports.stampOutline = _chunkRVGP2XLFcjs.stampOutline; exports.stampPixels = _chunkRVGP2XLFcjs.stampPixels; exports.stickerForAgent = _chunkAVTPZO4Zcjs.stickerForAgent; exports.stickerIdFor = _chunkJSDND7DFcjs.stickerIdFor; exports.stickerPage = _chunkJSDND7DFcjs.stickerPage; exports.stickerRefOf = _chunkJSDND7DFcjs.stickerRefOf;

package/dist/stickers/index.js

@@ -1,15 +1,17 @@
 import {
   StickerBrowser,
+  editorStickers,
+  stampOutline,
+  stampPixels
+} from "../chunk-F7CPSRLN.js";
+import {
   createInsertStickerTool,
   createStickerToolProvider,
   createStickerTools,
   describeStickerRef,
-  editorStickers,
   insertSticker,
-  stampOutline,
-  stampPixels,
   stickerForAgent
-} from "../chunk-WZOGDKCQ.js";
+} from "../chunk-J5UQHWVL.js";
 import {
   DEFAULT_STICKER_PAGE,
   EDITOR_STICKERS_ID,

package/dist/typography/index.cjs

@@ -18,7 +18,8 @@
 var _chunk4XSBOGMKcjs = require('../chunk-4XSBOGMK.cjs');
 
 
-var _chunkTFF2GTGNcjs = require('../chunk-TFF2GTGN.cjs');
+var _chunkMEGSQUQOcjs = require('../chunk-MEGSQUQO.cjs');
+require('../chunk-SXQHWXEL.cjs');
 
 
 
@@ -572,7 +573,7 @@ function checkTypographyAccessibility(options) {
   if (font.size < 12) issues.push(`${font.size}px text is hard to read at any contrast; use 12px or more (16px for body text).`);
   const weight = _chunk4XSBOGMKcjs.normalizeFontWeight.call(void 0, font.weight);
   if (weight <= 300 && font.size < 24) issues.push(`Weight ${weight} at ${font.size}px has thin strokes that lower effective contrast; use 400 or heavier below 24px.`);
-  const suggestion = passesAA ? void 0 : _chunkTFF2GTGNcjs.suggestAccessibleForeground.call(void 0, fg, bg, { large });
+  const suggestion = passesAA ? void 0 : _chunkMEGSQUQOcjs.suggestAccessibleForeground.call(void 0, fg, bg, { large });
   return {
     ratio,
     large,

package/dist/typography/index.js

@@ -18,7 +18,8 @@ import {
 } from "../chunk-N4ZXW3WB.js";
 import {
   suggestAccessibleForeground
-} from "../chunk-YBAPT7NL.js";
+} from "../chunk-E2V5DA3W.js";
+import "../chunk-JC2SHA4A.js";
 import {
   contrastLevel,
   contrastRatio,