@pixerate/editor 0.249.0 → 0.251.0

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

@@ -0,0 +1,104 @@
+/**
+ * The settings of the sticker, particle and bristle engines: types, defaults and normalisers, with
+ * no rendering code (sticker refs and the stamp list come from the renderer-free `stickers/`), so
+ * the brush model (`@pixerate/editor/brushes`) can read and check them without bundling the
+ * renderers. `stickers.ts` and `procedural.ts` re-export them.
+ */
+import { type StampKind } from '../stickers/stamps.cjs';
+import type { StickerRef } from '../stickers/types.cjs';
+export { STAMP_KINDS, type StampKind } from '../stickers/stamps.cjs';
+/** Sticker spray settings (each 0..1 unless noted). */
+export interface StickerSettings {
+    /**
+     * The stickers to spray (one picked at random per sticker): refs `provider:id`. A bare editor
+     * stamp (`"star"`) is read as `editor:star`.
+     */
+    stamps: StickerRef[];
+    /** How closely stickers follow each other: about `density × 4` per tip diameter of travel (0.25 ≈ one per diameter). */
+    density: number;
+    /** Random size change. */
+    sizeJitter: number;
+    /** Random turn, as a fraction of ±180°. */
+    rotationJitter: number;
+    /** How far from the path stickers land, in tip diameters (0..2). */
+    scatter: number;
+    /** Random colour change (hue and lightness). */
+    colorJitter: number;
+}
+/** At most this many stickers in a sticker brush. */
+export declare const MAX_STICKER_STAMPS = 16;
+export declare const DEFAULT_STICKER: Readonly<StickerSettings>;
+export declare function normalizeStickerSettings(raw?: Partial<StickerSettings>, base?: StickerSettings): StickerSettings;
+export type ParticleKind = 'string' | 'spring' | 'orbit' | 'flow' | 'elastic' | 'fuzzy';
+export declare const PARTICLE_KINDS: readonly ParticleKind[];
+export type ParticleRender = 'dot' | 'line' | 'sequence' | 'ribbon';
+export declare const PARTICLE_RENDERS: readonly ParticleRender[];
+/** Ribbon: which particles' paths are joined (`adjacent`: each to its neighbour; `first-last`: one band between the outermost two). */
+export type RibbonPairs = 'adjacent' | 'first-last';
+export declare const RIBBON_PAIRS: readonly RibbonPairs[];
+/** Textured dots: the stamps in turn, or one picked at random (seeded) per dot. */
+export type DotTextureOrder = 'sequence' | 'random';
+export declare const DOT_TEXTURE_ORDERS: readonly DotTextureOrder[];
+/** Textured dots: turned with the particle's motion, at random, or at the tip angle. */
+export type DotRotation = 'follow' | 'random' | 'fixed';
+export declare const DOT_ROTATIONS: readonly DotRotation[];
+/** Textured dots: at most this many stamps. */
+export declare const MAX_DOT_TEXTURES = 4;
+/** Particle engine settings (each 0..1 unless noted). */
+export interface ParticleSettings {
+    kind: ParticleKind;
+    render: ParticleRender;
+    /** Particles, 1..64. */
+    count: number;
+    /** Mark size as a fraction of the tip size. */
+    size: number;
+    /** How far apart the particles start, as a fraction of the tip size. */
+    spread: number;
+    /** Spring and string stiffness (stiff follows closely; soft swings wide). */
+    stiffness: number;
+    /** How quickly motion dies down. */
+    damping: number;
+    /** Orbit and flow speed. */
+    speed: number;
+    /** Pull downwards (−1 up .. 1 down). */
+    gravity: number;
+    /** Flow particles' lifetime. */
+    life: number;
+    /** Sequence: spacing of the beads along each path. */
+    interval: number;
+    /** Ribbon: opacity of the fill between the paths, relative to their edges. */
+    ribbonFill: number;
+    /** Ribbon: which paths are joined. */
+    ribbonPairs: RibbonPairs;
+    /** Wave: how far each particle's drawn place swings sideways, as a fraction of the tip size (0: no wave). */
+    waveAmplitude: number;
+    /** Wave: wavelength in px of pen travel, 4..2000. */
+    waveLength: number;
+    /** Wave: how fast the waves run (0: they stand still on the path; 1: about four a second while the pen moves). */
+    waveSpeed: number;
+    /** 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[];
+    dotTextureOrder: DotTextureOrder;
+    dotRotation: DotRotation;
+}
+export declare const DEFAULT_PARTICLE: Readonly<ParticleSettings>;
+export declare function normalizeParticle(raw?: Partial<ParticleSettings>, base?: ParticleSettings): ParticleSettings;
+/** Bristle engine settings (each 0..1 unless noted). */
+export interface BristleSettings {
+    /** Bristles in the tuft, 3..128. */
+    count: number;
+    /** Stiff bristles follow the tip; soft ones lag and bend into curves at turns. */
+    stiffness: number;
+    /** How far pressure spreads the tuft. */
+    splay: number;
+    /** Width of each bristle's line as a fraction of the tip size. */
+    thickness: number;
+    /** Paint per bristle: 1 never runs dry; lower, bristles run out along the stroke (dry brush). */
+    load: number;
+    /** Random variation between bristles (length, paint, position). */
+    jitter: number;
+}
+export declare const DEFAULT_BRISTLE: Readonly<BristleSettings>;
+export declare function normalizeBristle(raw?: Partial<BristleSettings>, base?: BristleSettings): BristleSettings;

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

@@ -0,0 +1,104 @@
+/**
+ * The settings of the sticker, particle and bristle engines: types, defaults and normalisers, with
+ * no rendering code (sticker refs and the stamp list come from the renderer-free `stickers/`), so
+ * the brush model (`@pixerate/editor/brushes`) can read and check them without bundling the
+ * renderers. `stickers.ts` and `procedural.ts` re-export them.
+ */
+import { type StampKind } from '../stickers/stamps.js';
+import type { StickerRef } from '../stickers/types.js';
+export { STAMP_KINDS, type StampKind } from '../stickers/stamps.js';
+/** Sticker spray settings (each 0..1 unless noted). */
+export interface StickerSettings {
+    /**
+     * The stickers to spray (one picked at random per sticker): refs `provider:id`. A bare editor
+     * stamp (`"star"`) is read as `editor:star`.
+     */
+    stamps: StickerRef[];
+    /** How closely stickers follow each other: about `density × 4` per tip diameter of travel (0.25 ≈ one per diameter). */
+    density: number;
+    /** Random size change. */
+    sizeJitter: number;
+    /** Random turn, as a fraction of ±180°. */
+    rotationJitter: number;
+    /** How far from the path stickers land, in tip diameters (0..2). */
+    scatter: number;
+    /** Random colour change (hue and lightness). */
+    colorJitter: number;
+}
+/** At most this many stickers in a sticker brush. */
+export declare const MAX_STICKER_STAMPS = 16;
+export declare const DEFAULT_STICKER: Readonly<StickerSettings>;
+export declare function normalizeStickerSettings(raw?: Partial<StickerSettings>, base?: StickerSettings): StickerSettings;
+export type ParticleKind = 'string' | 'spring' | 'orbit' | 'flow' | 'elastic' | 'fuzzy';
+export declare const PARTICLE_KINDS: readonly ParticleKind[];
+export type ParticleRender = 'dot' | 'line' | 'sequence' | 'ribbon';
+export declare const PARTICLE_RENDERS: readonly ParticleRender[];
+/** Ribbon: which particles' paths are joined (`adjacent`: each to its neighbour; `first-last`: one band between the outermost two). */
+export type RibbonPairs = 'adjacent' | 'first-last';
+export declare const RIBBON_PAIRS: readonly RibbonPairs[];
+/** Textured dots: the stamps in turn, or one picked at random (seeded) per dot. */
+export type DotTextureOrder = 'sequence' | 'random';
+export declare const DOT_TEXTURE_ORDERS: readonly DotTextureOrder[];
+/** Textured dots: turned with the particle's motion, at random, or at the tip angle. */
+export type DotRotation = 'follow' | 'random' | 'fixed';
+export declare const DOT_ROTATIONS: readonly DotRotation[];
+/** Textured dots: at most this many stamps. */
+export declare const MAX_DOT_TEXTURES = 4;
+/** Particle engine settings (each 0..1 unless noted). */
+export interface ParticleSettings {
+    kind: ParticleKind;
+    render: ParticleRender;
+    /** Particles, 1..64. */
+    count: number;
+    /** Mark size as a fraction of the tip size. */
+    size: number;
+    /** How far apart the particles start, as a fraction of the tip size. */
+    spread: number;
+    /** Spring and string stiffness (stiff follows closely; soft swings wide). */
+    stiffness: number;
+    /** How quickly motion dies down. */
+    damping: number;
+    /** Orbit and flow speed. */
+    speed: number;
+    /** Pull downwards (−1 up .. 1 down). */
+    gravity: number;
+    /** Flow particles' lifetime. */
+    life: number;
+    /** Sequence: spacing of the beads along each path. */
+    interval: number;
+    /** Ribbon: opacity of the fill between the paths, relative to their edges. */
+    ribbonFill: number;
+    /** Ribbon: which paths are joined. */
+    ribbonPairs: RibbonPairs;
+    /** Wave: how far each particle's drawn place swings sideways, as a fraction of the tip size (0: no wave). */
+    waveAmplitude: number;
+    /** Wave: wavelength in px of pen travel, 4..2000. */
+    waveLength: number;
+    /** Wave: how fast the waves run (0: they stand still on the path; 1: about four a second while the pen moves). */
+    waveSpeed: number;
+    /** 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[];
+    dotTextureOrder: DotTextureOrder;
+    dotRotation: DotRotation;
+}
+export declare const DEFAULT_PARTICLE: Readonly<ParticleSettings>;
+export declare function normalizeParticle(raw?: Partial<ParticleSettings>, base?: ParticleSettings): ParticleSettings;
+/** Bristle engine settings (each 0..1 unless noted). */
+export interface BristleSettings {
+    /** Bristles in the tuft, 3..128. */
+    count: number;
+    /** Stiff bristles follow the tip; soft ones lag and bend into curves at turns. */
+    stiffness: number;
+    /** How far pressure spreads the tuft. */
+    splay: number;
+    /** Width of each bristle's line as a fraction of the tip size. */
+    thickness: number;
+    /** Paint per bristle: 1 never runs dry; lower, bristles run out along the stroke (dry brush). */
+    load: number;
+    /** Random variation between bristles (length, paint, position). */
+    jitter: number;
+}
+export declare const DEFAULT_BRISTLE: Readonly<BristleSettings>;
+export declare function normalizeBristle(raw?: Partial<BristleSettings>, base?: BristleSettings): BristleSettings;

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

@@ -28,7 +28,8 @@ 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 './stickers.cjs';
+import type { StampKind } from './mark-settings.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;
     paperDepth: number;
@@ -91,62 +92,6 @@ declare abstract class MarkStroke implements CoverageStroke {
     /** Marks along a segment, spaced by a fraction of the radius. */
     protected segment(x0: number, y0: number, x1: number, y1: number, r: number, alpha: number, opacity: number, pressure: number, rects: RasterRect[]): void;
 }
-export type ParticleKind = 'string' | 'spring' | 'orbit' | 'flow' | 'elastic' | 'fuzzy';
-export declare const PARTICLE_KINDS: readonly ParticleKind[];
-export type ParticleRender = 'dot' | 'line' | 'sequence' | 'ribbon';
-export declare const PARTICLE_RENDERS: readonly ParticleRender[];
-/** Ribbon: which particles' paths are joined (`adjacent`: each to its neighbour; `first-last`: one band between the outermost two). */
-export type RibbonPairs = 'adjacent' | 'first-last';
-export declare const RIBBON_PAIRS: readonly RibbonPairs[];
-/** Textured dots: the stamps in turn, or one picked at random (seeded) per dot. */
-export type DotTextureOrder = 'sequence' | 'random';
-export declare const DOT_TEXTURE_ORDERS: readonly DotTextureOrder[];
-/** Textured dots: turned with the particle's motion, at random, or at the tip angle. */
-export type DotRotation = 'follow' | 'random' | 'fixed';
-export declare const DOT_ROTATIONS: readonly DotRotation[];
-/** Textured dots: at most this many stamps. */
-export declare const MAX_DOT_TEXTURES = 4;
-/** Particle engine settings (each 0..1 unless noted). */
-export interface ParticleSettings {
-    kind: ParticleKind;
-    render: ParticleRender;
-    /** Particles, 1..64. */
-    count: number;
-    /** Mark size as a fraction of the tip size. */
-    size: number;
-    /** How far apart the particles start, as a fraction of the tip size. */
-    spread: number;
-    /** Spring and string stiffness (stiff follows closely; soft swings wide). */
-    stiffness: number;
-    /** How quickly motion dies down. */
-    damping: number;
-    /** Orbit and flow speed. */
-    speed: number;
-    /** Pull downwards (−1 up .. 1 down). */
-    gravity: number;
-    /** Flow particles' lifetime. */
-    life: number;
-    /** Sequence: spacing of the beads along each path. */
-    interval: number;
-    /** Ribbon: opacity of the fill between the paths, relative to their edges. */
-    ribbonFill: number;
-    /** Ribbon: which paths are joined. */
-    ribbonPairs: RibbonPairs;
-    /** Wave: how far each particle's drawn place swings sideways, as a fraction of the tip size (0: no wave). */
-    waveAmplitude: number;
-    /** Wave: wavelength in px of pen travel, 4..2000. */
-    waveLength: number;
-    /** Wave: how fast the waves run (0: they stand still on the path; 1: about four a second while the pen moves). */
-    waveSpeed: number;
-    /** 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[];
-    dotTextureOrder: DotTextureOrder;
-    dotRotation: DotRotation;
-}
-export declare const DEFAULT_PARTICLE: Readonly<ParticleSettings>;
-export declare function normalizeParticle(raw?: Partial<ParticleSettings>, base?: ParticleSettings): ParticleSettings;
 /**
  * Adds the area polygon `pts` (x, y pairs, even-odd) covers in each pixel of `rect`, times `weight`, to `out`,
  * exactly across each of `RIBBON_SUB` sub-rows per row. Points on an edge two polygons share
@@ -189,23 +134,6 @@ export declare class ParticleStroke extends MarkStroke {
      */
     private telescope;
 }
-/** Bristle engine settings (each 0..1 unless noted). */
-export interface BristleSettings {
-    /** Bristles in the tuft, 3..128. */
-    count: number;
-    /** Stiff bristles follow the tip; soft ones lag and bend into curves at turns. */
-    stiffness: number;
-    /** How far pressure spreads the tuft. */
-    splay: number;
-    /** Width of each bristle's line as a fraction of the tip size. */
-    thickness: number;
-    /** Paint per bristle: 1 never runs dry; lower, bristles run out along the stroke (dry brush). */
-    load: number;
-    /** Random variation between bristles (length, paint, position). */
-    jitter: number;
-}
-export declare const DEFAULT_BRISTLE: Readonly<BristleSettings>;
-export declare function normalizeBristle(raw?: Partial<BristleSettings>, base?: BristleSettings): BristleSettings;
 /** A bristle-brush stroke: every bristle draws its own line. */
 export declare class BristleStroke extends MarkStroke {
     private readonly tufts;
@@ -213,4 +141,3 @@ export declare class BristleStroke extends MarkStroke {
     constructor(brush: PaintBrush, options: ProceduralStrokeOptions);
     protected advance(copy: number, d: PenDab, rects: RasterRect[]): void;
 }
-export {};

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

@@ -28,7 +28,8 @@ 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 './stickers.js';
+import type { StampKind } from './mark-settings.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;
     paperDepth: number;
@@ -91,62 +92,6 @@ declare abstract class MarkStroke implements CoverageStroke {
     /** Marks along a segment, spaced by a fraction of the radius. */
     protected segment(x0: number, y0: number, x1: number, y1: number, r: number, alpha: number, opacity: number, pressure: number, rects: RasterRect[]): void;
 }
-export type ParticleKind = 'string' | 'spring' | 'orbit' | 'flow' | 'elastic' | 'fuzzy';
-export declare const PARTICLE_KINDS: readonly ParticleKind[];
-export type ParticleRender = 'dot' | 'line' | 'sequence' | 'ribbon';
-export declare const PARTICLE_RENDERS: readonly ParticleRender[];
-/** Ribbon: which particles' paths are joined (`adjacent`: each to its neighbour; `first-last`: one band between the outermost two). */
-export type RibbonPairs = 'adjacent' | 'first-last';
-export declare const RIBBON_PAIRS: readonly RibbonPairs[];
-/** Textured dots: the stamps in turn, or one picked at random (seeded) per dot. */
-export type DotTextureOrder = 'sequence' | 'random';
-export declare const DOT_TEXTURE_ORDERS: readonly DotTextureOrder[];
-/** Textured dots: turned with the particle's motion, at random, or at the tip angle. */
-export type DotRotation = 'follow' | 'random' | 'fixed';
-export declare const DOT_ROTATIONS: readonly DotRotation[];
-/** Textured dots: at most this many stamps. */
-export declare const MAX_DOT_TEXTURES = 4;
-/** Particle engine settings (each 0..1 unless noted). */
-export interface ParticleSettings {
-    kind: ParticleKind;
-    render: ParticleRender;
-    /** Particles, 1..64. */
-    count: number;
-    /** Mark size as a fraction of the tip size. */
-    size: number;
-    /** How far apart the particles start, as a fraction of the tip size. */
-    spread: number;
-    /** Spring and string stiffness (stiff follows closely; soft swings wide). */
-    stiffness: number;
-    /** How quickly motion dies down. */
-    damping: number;
-    /** Orbit and flow speed. */
-    speed: number;
-    /** Pull downwards (−1 up .. 1 down). */
-    gravity: number;
-    /** Flow particles' lifetime. */
-    life: number;
-    /** Sequence: spacing of the beads along each path. */
-    interval: number;
-    /** Ribbon: opacity of the fill between the paths, relative to their edges. */
-    ribbonFill: number;
-    /** Ribbon: which paths are joined. */
-    ribbonPairs: RibbonPairs;
-    /** Wave: how far each particle's drawn place swings sideways, as a fraction of the tip size (0: no wave). */
-    waveAmplitude: number;
-    /** Wave: wavelength in px of pen travel, 4..2000. */
-    waveLength: number;
-    /** Wave: how fast the waves run (0: they stand still on the path; 1: about four a second while the pen moves). */
-    waveSpeed: number;
-    /** 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[];
-    dotTextureOrder: DotTextureOrder;
-    dotRotation: DotRotation;
-}
-export declare const DEFAULT_PARTICLE: Readonly<ParticleSettings>;
-export declare function normalizeParticle(raw?: Partial<ParticleSettings>, base?: ParticleSettings): ParticleSettings;
 /**
  * Adds the area polygon `pts` (x, y pairs, even-odd) covers in each pixel of `rect`, times `weight`, to `out`,
  * exactly across each of `RIBBON_SUB` sub-rows per row. Points on an edge two polygons share
@@ -189,23 +134,6 @@ export declare class ParticleStroke extends MarkStroke {
      */
     private telescope;
 }
-/** Bristle engine settings (each 0..1 unless noted). */
-export interface BristleSettings {
-    /** Bristles in the tuft, 3..128. */
-    count: number;
-    /** Stiff bristles follow the tip; soft ones lag and bend into curves at turns. */
-    stiffness: number;
-    /** How far pressure spreads the tuft. */
-    splay: number;
-    /** Width of each bristle's line as a fraction of the tip size. */
-    thickness: number;
-    /** Paint per bristle: 1 never runs dry; lower, bristles run out along the stroke (dry brush). */
-    load: number;
-    /** Random variation between bristles (length, paint, position). */
-    jitter: number;
-}
-export declare const DEFAULT_BRISTLE: Readonly<BristleSettings>;
-export declare function normalizeBristle(raw?: Partial<BristleSettings>, base?: BristleSettings): BristleSettings;
 /** A bristle-brush stroke: every bristle draws its own line. */
 export declare class BristleStroke extends MarkStroke {
     private readonly tufts;
@@ -213,4 +141,3 @@ export declare class BristleStroke extends MarkStroke {
     constructor(brush: PaintBrush, options: ProceduralStrokeOptions);
     protected advance(copy: number, d: PenDab, rects: RasterRect[]): void;
 }
-export {};

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

@@ -18,6 +18,7 @@ import { type StampKind } from '../stickers/stamps.cjs';
 import type { StickerRef } from '../stickers/types.cjs';
 import { type StickerArtLookup } from './sticker-art.cjs';
 export { STAMP_KINDS, stampCoverage, type StampKind } from '../stickers/stamps.cjs';
+export { DEFAULT_STICKER, MAX_STICKER_STAMPS, normalizeStickerSettings, type StickerSettings } from './mark-settings.cjs';
 import { type EffectPaintPixels } from './effect-paint.cjs';
 /** One sticker (document pixels). */
 export interface Sticker {
@@ -39,28 +40,6 @@ export interface Sticker {
     /** Texture seed. */
     seed: number;
 }
-/** Sticker spray settings (each 0..1 unless noted). */
-export interface StickerSettings {
-    /**
-     * The stickers to spray (one picked at random per sticker): refs `provider:id`. A bare editor
-     * stamp (`"star"`) is read as `editor:star`.
-     */
-    stamps: StickerRef[];
-    /** How closely stickers follow each other: about `density × 4` per tip diameter of travel (0.25 ≈ one per diameter). */
-    density: number;
-    /** Random size change. */
-    sizeJitter: number;
-    /** Random turn, as a fraction of ±180°. */
-    rotationJitter: number;
-    /** How far from the path stickers land, in tip diameters (0..2). */
-    scatter: number;
-    /** Random colour change (hue and lightness). */
-    colorJitter: number;
-}
-/** At most this many stickers in a sticker brush. */
-export declare const MAX_STICKER_STAMPS = 16;
-export declare const DEFAULT_STICKER: Readonly<StickerSettings>;
-export declare function normalizeStickerSettings(raw?: Partial<StickerSettings>, base?: StickerSettings): StickerSettings;
 /** The pixel rectangle a sticker covers. */
 export declare function stickerRect(s: Sticker): RasterRect;
 /** The editor stamp a sticker shows, or `null` for a provider's sticker. */

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

@@ -18,6 +18,7 @@ import { type StampKind } from '../stickers/stamps.js';
 import type { StickerRef } from '../stickers/types.js';
 import { type StickerArtLookup } from './sticker-art.js';
 export { STAMP_KINDS, stampCoverage, type StampKind } from '../stickers/stamps.js';
+export { DEFAULT_STICKER, MAX_STICKER_STAMPS, normalizeStickerSettings, type StickerSettings } from './mark-settings.js';
 import { type EffectPaintPixels } from './effect-paint.js';
 /** One sticker (document pixels). */
 export interface Sticker {
@@ -39,28 +40,6 @@ export interface Sticker {
     /** Texture seed. */
     seed: number;
 }
-/** Sticker spray settings (each 0..1 unless noted). */
-export interface StickerSettings {
-    /**
-     * The stickers to spray (one picked at random per sticker): refs `provider:id`. A bare editor
-     * stamp (`"star"`) is read as `editor:star`.
-     */
-    stamps: StickerRef[];
-    /** How closely stickers follow each other: about `density × 4` per tip diameter of travel (0.25 ≈ one per diameter). */
-    density: number;
-    /** Random size change. */
-    sizeJitter: number;
-    /** Random turn, as a fraction of ±180°. */
-    rotationJitter: number;
-    /** How far from the path stickers land, in tip diameters (0..2). */
-    scatter: number;
-    /** Random colour change (hue and lightness). */
-    colorJitter: number;
-}
-/** At most this many stickers in a sticker brush. */
-export declare const MAX_STICKER_STAMPS = 16;
-export declare const DEFAULT_STICKER: Readonly<StickerSettings>;
-export declare function normalizeStickerSettings(raw?: Partial<StickerSettings>, base?: StickerSettings): StickerSettings;
 /** The pixel rectangle a sticker covers. */
 export declare function stickerRect(s: Sticker): RasterRect;
 /** The editor stamp a sticker shows, or `null` for a provider's sticker. */

package/dist/raster/index.cjs

@@ -81,6 +81,7 @@ var _chunkK6PXS6DOcjs = require('../chunk-K6PXS6DO.cjs');
 
 
 
+var _chunkW5M3J7PVcjs = require('../chunk-W5M3J7PV.cjs');
 
 
 
@@ -115,7 +116,6 @@ var _chunkK6PXS6DOcjs = require('../chunk-K6PXS6DO.cjs');
 
 
 
-var _chunk2VX55NFMcjs = require('../chunk-2VX55NFM.cjs');
 
 
 
@@ -124,7 +124,7 @@ var _chunk2VX55NFMcjs = require('../chunk-2VX55NFM.cjs');
 
 
 
-var _chunkW5M3J7PVcjs = require('../chunk-W5M3J7PV.cjs');
+var _chunk2VX55NFMcjs = require('../chunk-2VX55NFM.cjs');
 
 
 

package/dist/raster/index.js

@@ -73,6 +73,15 @@ import {
   DIRECT_GAUSSIAN_MAX_SIGMA,
   gaussianBlur
 } from "../chunk-ZIF4UJJ6.js";
+import {
+  base64ToBytes,
+  bytesToBase64,
+  decodePng,
+  encodePng,
+  isPng,
+  parseDataUrl,
+  pngDataUrl
+} from "../chunk-OTTT5N3K.js";
 import {
   BIT_DEPTHS,
   BLEND_MODES,
@@ -116,15 +125,6 @@ import {
   to8From32,
   writeDeepRegion
 } from "../chunk-IRSTHLQQ.js";
-import {
-  base64ToBytes,
-  bytesToBase64,
-  decodePng,
-  encodePng,
-  isPng,
-  parseDataUrl,
-  pngDataUrl
-} from "../chunk-OTTT5N3K.js";
 import {
   SurfaceDraft,
   TILE,

package/dist/stickers/index.cjs

@@ -3,13 +3,13 @@
 
 
 
-var _chunkLJRCU3BJcjs = require('../chunk-LJRCU3BJ.cjs');
 
 
 
 
 
 
+var _chunkSABJMH6Mcjs = require('../chunk-SABJMH6M.cjs');
 
 
 
@@ -24,7 +24,11 @@ var _chunkLJRCU3BJcjs = require('../chunk-LJRCU3BJ.cjs');
 
 
 
-var _chunkZEYMKDYScjs = require('../chunk-ZEYMKDYS.cjs');
+
+var _chunkJSDND7DFcjs = require('../chunk-JSDND7DF.cjs');
+
+
+var _chunkU67EN7GGcjs = require('../chunk-U67EN7GG.cjs');
 require('../chunk-3K6HWEXZ.cjs');
 
 
@@ -91,8 +95,8 @@ function createFakeStickerProvider(options = {}) {
     name: "Fake stickers",
     version: "1",
     capabilities: { supportsSearch: true, supportsSvg: true, supportsRaster: true, maxSize: 512 },
-    list: (o) => _chunkZEYMKDYScjs.stickerPage.call(void 0, summaries, o),
-    search: (q, o) => _chunkZEYMKDYScjs.stickerPage.call(void 0, summaries, o, q),
+    list: (o) => _chunkJSDND7DFcjs.stickerPage.call(void 0, summaries, o),
+    search: (q, o) => _chunkJSDND7DFcjs.stickerPage.call(void 0, summaries, o, q),
     describe(id) {
       const s = find(id);
       if (!s) return void 0;
@@ -102,12 +106,12 @@ function createFakeStickerProvider(options = {}) {
     async load(id, o = {}) {
       if (options.loadDelayMs) await new Promise((r) => setTimeout(r, options.loadDelayMs));
       const s = find(id);
-      if (!s) throw new (0, _chunkZEYMKDYScjs.StickerError)("unknown_sticker", `No fake sticker "${id}".`);
-      if (_optionalChain([options, 'access', _ => _.failIds, 'optionalAccess', _2 => _2.includes, 'call', _3 => _3(id)])) throw new (0, _chunkZEYMKDYScjs.StickerError)("load_failed", `The fake sticker "${id}" failed to load (failIds).`);
+      if (!s) throw new (0, _chunkU67EN7GGcjs.StickerError)("unknown_sticker", `No fake sticker "${id}".`);
+      if (_optionalChain([options, 'access', _ => _.failIds, 'optionalAccess', _2 => _2.includes, 'call', _3 => _3(id)])) throw new (0, _chunkU67EN7GGcjs.StickerError)("load_failed", `The fake sticker "${id}" failed to load (failIds).`);
       const fill = s.shape === "badge" && o.colour ? o.colour.toLowerCase() : s.colours[0];
       if (o.format === "png") {
         const size = _nullishCoalesce(o.size, () => ( 128));
-        if (!(Number.isInteger(size) && size >= 8 && size <= 512)) throw new (0, _chunkZEYMKDYScjs.StickerError)("invalid_argument", `size must be 8..512 px, got ${size}.`);
+        if (!(Number.isInteger(size) && size >= 8 && size <= 512)) throw new (0, _chunkU67EN7GGcjs.StickerError)("invalid_argument", `size must be 8..512 px, got ${size}.`);
         return { kind: "image", url: _chunkW5M3J7PVcjs.pngDataUrl.call(void 0, size, size, pixelsOf(s, size, fill)), width: size, height: size };
       }
       return { kind: "svg", svg: svgOf(s, fill) };
@@ -119,23 +123,23 @@ function createFakeStickerProvider(options = {}) {
 function combineStickerProviders(providers, options = {}) {
   const ids = providers.map((p) => p.id);
   const dup = ids.find((id, i) => ids.indexOf(id) !== i);
-  if (dup) throw new (0, _chunkZEYMKDYScjs.StickerError)("invalid_argument", `Two sticker providers have the id "${dup}"; give each a unique id.`);
+  if (dup) throw new (0, _chunkU67EN7GGcjs.StickerError)("invalid_argument", `Two sticker providers have the id "${dup}"; give each a unique id.`);
   const byId = new Map(providers.map((p) => [p.id, p]));
   const owner = (ref) => {
-    const { provider, id } = _chunkZEYMKDYScjs.parseStickerRef.call(void 0, ref);
+    const { provider, id } = _chunkJSDND7DFcjs.parseStickerRef.call(void 0, ref);
     const p = byId.get(provider);
-    if (!p) throw new (0, _chunkZEYMKDYScjs.StickerError)("unknown_provider", `No sticker provider "${provider}"; the providers are ${ids.join(", ") || "none"}.`);
+    if (!p) throw new (0, _chunkU67EN7GGcjs.StickerError)("unknown_provider", `No sticker provider "${provider}"; the providers are ${ids.join(", ") || "none"}.`);
     return { p, id };
   };
-  const prefix = (p, s) => ({ ...s, id: _chunkZEYMKDYScjs.stickerRefOf.call(void 0, p, s.id) });
+  const prefix = (p, s) => ({ ...s, id: _chunkJSDND7DFcjs.stickerRefOf.call(void 0, p, s.id) });
   const page = async (query, o = {}) => {
-    const { after, limit = _chunkZEYMKDYScjs.DEFAULT_STICKER_PAGE, ...filters } = o;
-    _chunkZEYMKDYScjs.checkStickerSearchOptions.call(void 0, { limit });
+    const { after, limit = _chunkJSDND7DFcjs.DEFAULT_STICKER_PAGE, ...filters } = o;
+    _chunkJSDND7DFcjs.checkStickerSearchOptions.call(void 0, { limit });
     let i = 0;
     let inner;
     if (after !== void 0) {
       const m = /^(\d+)\|(.*)$/.exec(after);
-      if (!m || Number(m[1]) >= providers.length) throw new (0, _chunkZEYMKDYScjs.StickerError)("invalid_argument", `after "${after}" is not a cursor from this provider; pass the next value of the previous page.`);
+      if (!m || Number(m[1]) >= providers.length) throw new (0, _chunkU67EN7GGcjs.StickerError)("invalid_argument", `after "${after}" is not a cursor from this provider; pass the next value of the previous page.`);
       i = Number(m[1]);
       inner = m[2] || void 0;
     }
@@ -179,7 +183,7 @@ function combineStickerProviders(providers, options = {}) {
         return void 0;
       }
       const d = await o.p.describe(o.id);
-      return d ? { ...d, id: _chunkZEYMKDYScjs.stickerRefOf.call(void 0, o.p, d.id) } : void 0;
+      return d ? { ...d, id: _chunkJSDND7DFcjs.stickerRefOf.call(void 0, o.p, d.id) } : void 0;
     },
     async load(ref, o) {
       const { p, id } = owner(ref);
@@ -328,4 +332,6 @@ async function checkStickerProvider(provider, options = {}) {
 
 
 
-exports.DEFAULT_STICKER_PAGE = _chunkZEYMKDYScjs.DEFAULT_STICKER_PAGE; exports.EDITOR_STICKERS_ID = _chunkZEYMKDYScjs.EDITOR_STICKERS_ID; exports.MAX_STICKER_PAGE = _chunkZEYMKDYScjs.MAX_STICKER_PAGE; exports.STAMP_KINDS = _chunkZEYMKDYScjs.STAMP_KINDS; exports.StickerBrowser = _chunkLJRCU3BJcjs.StickerBrowser; exports.StickerError = _chunkZEYMKDYScjs.StickerError; exports.StickersSlot = _chunkZEYMKDYScjs.StickersSlot; exports.checkStickerProvider = checkStickerProvider; exports.checkStickerSearchOptions = _chunkZEYMKDYScjs.checkStickerSearchOptions; exports.closestStickerRefs = _chunkZEYMKDYScjs.closestStickerRefs; exports.combineStickerProviders = combineStickerProviders; exports.createFakeStickerProvider = createFakeStickerProvider; exports.createStickerToolProvider = _chunkZEYMKDYScjs.createStickerToolProvider; exports.createStickerTools = _chunkZEYMKDYScjs.createStickerTools; exports.describeStickerRef = _chunkZEYMKDYScjs.describeStickerRef; exports.editorStampOf = _chunkZEYMKDYScjs.editorStampOf; exports.editorStickers = _chunkLJRCU3BJcjs.editorStickers; exports.normalizeStickerRef = _chunkZEYMKDYScjs.normalizeStickerRef; exports.parseStickerRef = _chunkZEYMKDYScjs.parseStickerRef; exports.stampCoverage = _chunkZEYMKDYScjs.stampCoverage; exports.stampOutline = _chunkLJRCU3BJcjs.stampOutline; exports.stampPixels = _chunkLJRCU3BJcjs.stampPixels; exports.stickerForAgent = _chunkZEYMKDYScjs.stickerForAgent; exports.stickerIdFor = _chunkZEYMKDYScjs.stickerIdFor; exports.stickerPage = _chunkZEYMKDYScjs.stickerPage; exports.stickerRefOf = _chunkZEYMKDYScjs.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 = _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;

package/dist/stickers/index.d.cts

@@ -12,5 +12,5 @@ export { editorStickers, stampOutline, stampPixels } from './editor.cjs';
 export { createFakeStickerProvider, type FakeStickerProviderOptions } from './fake.cjs';
 export { combineStickerProviders } from './combine.cjs';
 export { checkStickerProvider, type StickerConformanceIssue, type StickerConformanceOptions } from './conformance.cjs';
-export { createStickerTools, createStickerToolProvider, describeStickerRef, stickerForAgent, type StickerToolsOptions } from './tools.cjs';
+export { createInsertStickerTool, insertSticker, createStickerTools, createStickerToolProvider, describeStickerRef, stickerForAgent, type StickerInsertHost, type StickerPlacement, type StickerToolsOptions } from './tools.cjs';
 export { StickerBrowser, type StickerBrowserItem, type StickerBrowserState } from './browser.cjs';