@pixerate/editor 0.280.0 → 0.282.0

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

@@ -102,3 +102,33 @@ export interface BristleSettings {
 }
 export declare const DEFAULT_BRISTLE: Readonly<BristleSettings>;
 export declare function normalizeBristle(raw?: Partial<BristleSettings>, base?: BristleSettings): BristleSettings;
+/** How antimatter blasts invert paint colour: `rgb` (channel complement) or `oklab` (flips lightness and hue so mid-grey changes too). */
+export type InvertMode = 'rgb' | 'oklab';
+export declare const INVERT_MODES: readonly InvertMode[];
+/** Antimatter engine settings. */
+export interface AntimatterSettings {
+    /** Blast size, in tip radii (1..6, default 2.5). */
+    blastRadius: number;
+    /** Stroke travel between blasts, in tip diameters (0.5..8, default 2). */
+    blastSpacing: number;
+    /** Paint needed under the tip to fire (0..1, default 0.1). */
+    threshold: number;
+    /** Strength of the colour inversion in the blast core (0..1, default 1). */
+    invert: number;
+    /** Colour inversion mode: `rgb` (default) or `oklab` (flips lightness and hue). */
+    invertMode: InvertMode;
+    /** Strength of the soot ring around the blast (0..1, default 0.6). */
+    scorch: number;
+    /** Paint destroyed at the centre — alpha removed (0..1, default 0.25). */
+    annihilate: number;
+    /** How many sparks fly out from each blast (0..1, default 0.5). */
+    sparks: number;
+    /** How far sparks fly, in tip diameters (0.5..8, default 3). */
+    sparkReach: number;
+    /** Depth of the dent and raised rim on layers with relief (0..1, default 0.5). */
+    crater: number;
+    /** Seconds a blast plays on screen (0..2, default 0.7; 0 shows the result at once). */
+    duration: number;
+}
+export declare const DEFAULT_ANTIMATTER: Readonly<AntimatterSettings>;
+export declare function normalizeAntimatter(raw?: Partial<AntimatterSettings>, base?: AntimatterSettings): AntimatterSettings;

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

@@ -102,3 +102,33 @@ export interface BristleSettings {
 }
 export declare const DEFAULT_BRISTLE: Readonly<BristleSettings>;
 export declare function normalizeBristle(raw?: Partial<BristleSettings>, base?: BristleSettings): BristleSettings;
+/** How antimatter blasts invert paint colour: `rgb` (channel complement) or `oklab` (flips lightness and hue so mid-grey changes too). */
+export type InvertMode = 'rgb' | 'oklab';
+export declare const INVERT_MODES: readonly InvertMode[];
+/** Antimatter engine settings. */
+export interface AntimatterSettings {
+    /** Blast size, in tip radii (1..6, default 2.5). */
+    blastRadius: number;
+    /** Stroke travel between blasts, in tip diameters (0.5..8, default 2). */
+    blastSpacing: number;
+    /** Paint needed under the tip to fire (0..1, default 0.1). */
+    threshold: number;
+    /** Strength of the colour inversion in the blast core (0..1, default 1). */
+    invert: number;
+    /** Colour inversion mode: `rgb` (default) or `oklab` (flips lightness and hue). */
+    invertMode: InvertMode;
+    /** Strength of the soot ring around the blast (0..1, default 0.6). */
+    scorch: number;
+    /** Paint destroyed at the centre — alpha removed (0..1, default 0.25). */
+    annihilate: number;
+    /** How many sparks fly out from each blast (0..1, default 0.5). */
+    sparks: number;
+    /** How far sparks fly, in tip diameters (0.5..8, default 3). */
+    sparkReach: number;
+    /** Depth of the dent and raised rim on layers with relief (0..1, default 0.5). */
+    crater: number;
+    /** Seconds a blast plays on screen (0..2, default 0.7; 0 shows the result at once). */
+    duration: number;
+}
+export declare const DEFAULT_ANTIMATTER: Readonly<AntimatterSettings>;
+export declare function normalizeAntimatter(raw?: Partial<AntimatterSettings>, base?: AntimatterSettings): AntimatterSettings;

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

@@ -22,6 +22,7 @@ import { type PaperGrain } from './paper.cjs';
 import { type Sticker } from './stickers.cjs';
 import type { StickerArtLookup } from './sticker-art.cjs';
 import type { StickerRef, StickerVariant } from '../stickers/types.cjs';
+import { AntimatterStrokeDriver, type AntimatterLayerOutput, type AntimatterStats, type AntimatterTarget } from './antimatter.cjs';
 import type { DualColor } from '../color/dual.cjs';
 export interface StrokeSessionHost {
     /** Shows the layer's live surface (no history); `rects` are where it changed. */
@@ -124,6 +125,14 @@ export interface StrokeSessionInit {
     ferro?: {
         surface: TiledSurface;
     } | null;
+    /**
+     * Antimatter paint: all visible fuel layers before the stroke (with `editable: true` on editable
+     * pixel layers), and the clock for blast playback.
+     */
+    antimatter?: {
+        targets: readonly AntimatterTarget[];
+        now?: () => number;
+    } | null;
 }
 export interface PaintStrokeResult {
     layerId: string;
@@ -138,6 +147,8 @@ export interface PaintStrokeResult {
     wet?: boolean;
     /** Sticker brushes: refs the spray picked but skipped because their art had not loaded yet. */
     skippedStickers?: string[];
+    /** Antimatter paint: blasts fired, sparks spawned, fuel measured, and which layers changed or were skipped. */
+    antimatter?: AntimatterStats;
 }
 export declare class PaintStrokeSession {
     private readonly host;
@@ -155,6 +166,7 @@ export declare class PaintStrokeSession {
     private thickDriver;
     private filmBuffer;
     private stickerSpray;
+    private antimatter;
     /** Light paint: the stroke's twin over the light channel, and what it left there. */
     private readonly lightTwin;
     private lightResult;
@@ -207,6 +219,10 @@ export declare class PaintStrokeSession {
     get open(): boolean;
     /** Adds raw pen samples (document pixels). */
     push(points: readonly PenPoint[]): void;
+    /** Antimatter strokes: per-layer outputs (pixel surface, light channel, thick channels) after the stroke so far. */
+    antimatterOutputs(): AntimatterLayerOutput[] | null;
+    /** Antimatter strokes: the driver, used to play blast animations after commit. */
+    antimatterDriver(): AntimatterStrokeDriver | null;
     /** Sticker strokes: the stickers sprayed so far. */
     stickers(): Sticker[] | null;
     /** Impasto or iridescent strokes: the layer's thick-paint channels with the stroke so far. */

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

@@ -22,6 +22,7 @@ import { type PaperGrain } from './paper.js';
 import { type Sticker } from './stickers.js';
 import type { StickerArtLookup } from './sticker-art.js';
 import type { StickerRef, StickerVariant } from '../stickers/types.js';
+import { AntimatterStrokeDriver, type AntimatterLayerOutput, type AntimatterStats, type AntimatterTarget } from './antimatter.js';
 import type { DualColor } from '../color/dual.js';
 export interface StrokeSessionHost {
     /** Shows the layer's live surface (no history); `rects` are where it changed. */
@@ -124,6 +125,14 @@ export interface StrokeSessionInit {
     ferro?: {
         surface: TiledSurface;
     } | null;
+    /**
+     * Antimatter paint: all visible fuel layers before the stroke (with `editable: true` on editable
+     * pixel layers), and the clock for blast playback.
+     */
+    antimatter?: {
+        targets: readonly AntimatterTarget[];
+        now?: () => number;
+    } | null;
 }
 export interface PaintStrokeResult {
     layerId: string;
@@ -138,6 +147,8 @@ export interface PaintStrokeResult {
     wet?: boolean;
     /** Sticker brushes: refs the spray picked but skipped because their art had not loaded yet. */
     skippedStickers?: string[];
+    /** Antimatter paint: blasts fired, sparks spawned, fuel measured, and which layers changed or were skipped. */
+    antimatter?: AntimatterStats;
 }
 export declare class PaintStrokeSession {
     private readonly host;
@@ -155,6 +166,7 @@ export declare class PaintStrokeSession {
     private thickDriver;
     private filmBuffer;
     private stickerSpray;
+    private antimatter;
     /** Light paint: the stroke's twin over the light channel, and what it left there. */
     private readonly lightTwin;
     private lightResult;
@@ -207,6 +219,10 @@ export declare class PaintStrokeSession {
     get open(): boolean;
     /** Adds raw pen samples (document pixels). */
     push(points: readonly PenPoint[]): void;
+    /** Antimatter strokes: per-layer outputs (pixel surface, light channel, thick channels) after the stroke so far. */
+    antimatterOutputs(): AntimatterLayerOutput[] | null;
+    /** Antimatter strokes: the driver, used to play blast animations after commit. */
+    antimatterDriver(): AntimatterStrokeDriver | null;
     /** Sticker strokes: the stickers sprayed so far. */
     stickers(): Sticker[] | null;
     /** Impasto or iridescent strokes: the layer's thick-paint channels with the stroke so far. */

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

@@ -49,6 +49,8 @@ export interface RecordedStroke {
      * readers), or effect paint (the effect it took its colours from; replays render it first).
      */
     paint?: PaintGradientSource | PaintEffectPaint;
+    /** Antimatter brushes: the visible fuel layer ids at the time of the stroke, so a replay reads fuel from (and changes) exactly the same layers. */
+    targets?: string[];
 }
 export declare function applyAffine(m: Affine, x: number, y: number): {
     x: number;

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

@@ -49,6 +49,8 @@ export interface RecordedStroke {
      * readers), or effect paint (the effect it took its colours from; replays render it first).
      */
     paint?: PaintGradientSource | PaintEffectPaint;
+    /** Antimatter brushes: the visible fuel layer ids at the time of the stroke, so a replay reads fuel from (and changes) exactly the same layers. */
+    targets?: string[];
 }
 export declare function applyAffine(m: Affine, x: number, y: number): {
     x: number;

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

@@ -10,7 +10,7 @@
  */
 import type { MixerLoad } from '../paint/exchange.cjs';
 import { type BlendModeInfo } from '../raster/blend.cjs';
-import type { ImpastoTool, WetMediumKind, WetTool, LivePatternKind } from './brushes.cjs';
+import type { ImpastoTool, InvertMode, WetMediumKind, WetTool, LivePatternKind } from './brushes.cjs';
 import type { FillRegionOptions, PaintEditorController } from './controller.cjs';
 import type { PenPoint } from './engine.cjs';
 import { type Point2 } from './guides.cjs';
@@ -156,7 +156,7 @@ export declare function guideOverlay(controller: PaintEditorController, drag?: {
     to: Point2;
     kind: GuideOverlayKind;
 }>;
-export { BRUSH_SLIDERS, brushEngineControls, GHOST_SLIDERS, IRIDESCENCE_SLIDERS, multiColorSliders, MUTATION_SLIDERS, patchBrushValue, type BrushEngineControls, type SliderControl } from './brush-controls.cjs';
+export { ANTIMATTER_SLIDERS, BRUSH_SLIDERS, brushEngineControls, GHOST_SLIDERS, IRIDESCENCE_SLIDERS, multiColorSliders, MUTATION_SLIDERS, patchBrushValue, type BrushEngineControls, type SliderControl } from './brush-controls.cjs';
 import type { SliderControl } from './brush-controls.cjs';
 export declare const PAPER_SLIDERS: readonly SliderControl[];
 /** Reads `a.b` from an object. */
@@ -274,6 +274,8 @@ export declare const PARTICLE_RENDER_LABELS: Readonly<Record<ParticleRender, str
 export declare const RIBBON_PAIR_LABELS: Readonly<Record<RibbonPairs, string>>;
 export declare const DOT_TEXTURE_ORDER_LABELS: Readonly<Record<DotTextureOrder, string>>;
 export declare const DOT_ROTATION_LABELS: Readonly<Record<DotRotation, string>>;
+/** Labels of the antimatter colour inversion modes. */
+export declare const INVERT_MODE_LABELS: Readonly<Record<InvertMode, string>>;
 /** Labels of the sticker stamps. */
 export declare const STAMP_LABELS: Readonly<Record<StampKind, string>>;
 /** Toggles one stamp in a sticker brush's set (never leaving it empty). */

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

@@ -10,7 +10,7 @@
  */
 import type { MixerLoad } from '../paint/exchange.js';
 import { type BlendModeInfo } from '../raster/blend.js';
-import type { ImpastoTool, WetMediumKind, WetTool, LivePatternKind } from './brushes.js';
+import type { ImpastoTool, InvertMode, WetMediumKind, WetTool, LivePatternKind } from './brushes.js';
 import type { FillRegionOptions, PaintEditorController } from './controller.js';
 import type { PenPoint } from './engine.js';
 import { type Point2 } from './guides.js';
@@ -156,7 +156,7 @@ export declare function guideOverlay(controller: PaintEditorController, drag?: {
     to: Point2;
     kind: GuideOverlayKind;
 }>;
-export { BRUSH_SLIDERS, brushEngineControls, GHOST_SLIDERS, IRIDESCENCE_SLIDERS, multiColorSliders, MUTATION_SLIDERS, patchBrushValue, type BrushEngineControls, type SliderControl } from './brush-controls.js';
+export { ANTIMATTER_SLIDERS, BRUSH_SLIDERS, brushEngineControls, GHOST_SLIDERS, IRIDESCENCE_SLIDERS, multiColorSliders, MUTATION_SLIDERS, patchBrushValue, type BrushEngineControls, type SliderControl } from './brush-controls.js';
 import type { SliderControl } from './brush-controls.js';
 export declare const PAPER_SLIDERS: readonly SliderControl[];
 /** Reads `a.b` from an object. */
@@ -274,6 +274,8 @@ export declare const PARTICLE_RENDER_LABELS: Readonly<Record<ParticleRender, str
 export declare const RIBBON_PAIR_LABELS: Readonly<Record<RibbonPairs, string>>;
 export declare const DOT_TEXTURE_ORDER_LABELS: Readonly<Record<DotTextureOrder, string>>;
 export declare const DOT_ROTATION_LABELS: Readonly<Record<DotRotation, string>>;
+/** Labels of the antimatter colour inversion modes. */
+export declare const INVERT_MODE_LABELS: Readonly<Record<InvertMode, string>>;
 /** Labels of the sticker stamps. */
 export declare const STAMP_LABELS: Readonly<Record<StampKind, string>>;
 /** Toggles one stamp in a sticker brush's set (never leaving it empty). */