@pixerate/editor 0.273.0 → 0.275.0

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

@@ -156,7 +156,7 @@ export declare function guideOverlay(controller: PaintEditorController, drag?: {
     to: Point2;
     kind: GuideOverlayKind;
 }>;
-export { BRUSH_SLIDERS, brushEngineControls, GHOST_SLIDERS, multiColorSliders, patchBrushValue, type BrushEngineControls, type SliderControl } from './brush-controls.js';
+export { 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. */
@@ -230,6 +230,39 @@ export declare const WET_MEDIUM_LABELS: Readonly<Record<WetMediumKind, string>>;
 export declare const IMPASTO_TOOL_LABELS: Readonly<Record<ImpastoTool, string>>;
 /** The light sliders (thick paint and metallic paper). */
 export declare const LIGHT_SLIDERS: readonly SliderControl[];
+/** The UV blacklight sliders. */
+export declare const UV_LIGHT_SLIDERS: readonly SliderControl[];
+/** The view tilt sliders (thin-film iridescence and specular highlights). */
+export declare const VIEW_TILT_SLIDERS: readonly SliderControl[];
+/**
+ * Maps `DeviceOrientationEvent` angles (`beta` front-to-back in degrees, `gamma` left-to-right in
+ * degrees) relative to `rest` (default `{ beta: 45, gamma: 0 }`, a tablet held in hand) into a
+ * `viewTilt` in `-1..1` (35° reaches full tilt), rounded to 0.01.
+ */
+export declare function deviceOrientationToViewTilt(betaOrEvent: number | {
+    beta?: number | null;
+    gamma?: number | null;
+} | null | undefined, gammaOrRest?: number | {
+    beta: number;
+    gamma: number;
+} | null | undefined, rest?: {
+    beta: number;
+    gamma: number;
+}): {
+    x: number;
+    y: number;
+};
+/**
+ * Asks iOS Safari for `DeviceOrientationEvent` permission when `requestPermission` is present
+ * (must be called from a user gesture on iOS 13+). Resolves to `'granted'` on browsers that do not
+ * gate `deviceorientation` behind a permission prompt, or `'unsupported'` without `DeviceOrientationEvent`.
+ */
+export declare function requestDeviceTiltPermission(): Promise<'granted' | 'denied' | 'unsupported'>;
+/**
+ * Listens to `deviceorientation` events on `globalThis` and updates `controller.setViewTilt` relative
+ * to the first reading's orientation. Returns a cleanup function.
+ */
+export declare function startDeviceTilt(controller: PaintEditorController): () => void;
 /** Labels of the particle kinds and renders. */
 export declare const PARTICLE_KIND_LABELS: Readonly<Record<ParticleKind, string>>;
 export declare const PARTICLE_RENDER_LABELS: Readonly<Record<ParticleRender, string>>;
@@ -263,6 +296,8 @@ export declare const PATH_STROKE_TAPERS: ReadonlyArray<{
 export declare const STROKE_SLIDERS: readonly SliderControl[];
 /** The sticker panel's sliders for the selected sticker. */
 export declare const STICKER_SLIDERS: readonly SliderControl[];
+/** The evolution panel's mutation sliders (`0..1`). */
+export declare const EVOLUTION_SLIDERS: readonly SliderControl[];
 /** Stencils a toolbar can lay with one click, centred on the canvas. */
 export declare function quickStencil(kind: 'ruler' | 'circle' | 'ellipse-mask' | 'edge-mask', canvas: {
     width: number;

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

@@ -32,6 +32,7 @@ import { TiledSurface, type RasterRect } from '../raster/surface.cjs';
 import type { PaintBrush, WetMediumKind } from './brushes.cjs';
 import { type PenPoint, type StrokeCopy } from './engine.cjs';
 import { type PaperGrain as PaperGrainType, type PaperSettings } from './paper.cjs';
+import type { FilmBuffer } from './thick.cjs';
 /** The paper as the wet simulation reads it. */
 export declare function wetPaperInput(paper: PaperSettings): WetPaperInput;
 export interface WetStrokeInit {
@@ -60,6 +61,8 @@ export interface WetStrokeInit {
      * the water like any pigment.
      */
     effect?: EffectPaintPixels | null;
+    /** Thin-film iridescence channel for wet brushes with `iridescence`. */
+    film?: FilmBuffer | null;
     /** Simulation steps per second (for ghost fade countdown). */
     speed?: number;
 }
@@ -137,7 +140,7 @@ export interface WetEvent {
     clock: number;
     /** How many strokes were recorded before it (where it falls between strokes in a replay). */
     at?: number;
-    kind: 'dry' | 'tilt' | 'params' | 'flow' | 'wet-paper';
+    kind: 'dry' | 'tilt' | 'params' | 'flow' | 'wet-paper' | 'ghost-release' | 'ghost-keep';
     layerId?: string;
     data?: unknown;
 }
@@ -296,6 +299,10 @@ export declare class PaintWetLayers {
         layerId: string;
         bounds: RasterRect | null;
     }>;
+    /** Starts the fade countdown of an agent-triggered ghost on `layerId`. */
+    releaseGhost(layerId: string, linger?: number): void;
+    /** Keeps an unclaimed agent-triggered ghost on `layerId` as ordinary wet paint. */
+    keepGhost(layerId: string): void;
     /** The layer's light paint with all its wet paint dried (`null` without a wet layer or light), without changing anything. */
     bakedLight(layerId: string): TiledSurface | null;
     /** The layer's pixels with all its wet paint dried (deterministic), without changing anything. */

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

@@ -32,6 +32,7 @@ import { TiledSurface, type RasterRect } from '../raster/surface.js';
 import type { PaintBrush, WetMediumKind } from './brushes.js';
 import { type PenPoint, type StrokeCopy } from './engine.js';
 import { type PaperGrain as PaperGrainType, type PaperSettings } from './paper.js';
+import type { FilmBuffer } from './thick.js';
 /** The paper as the wet simulation reads it. */
 export declare function wetPaperInput(paper: PaperSettings): WetPaperInput;
 export interface WetStrokeInit {
@@ -60,6 +61,8 @@ export interface WetStrokeInit {
      * the water like any pigment.
      */
     effect?: EffectPaintPixels | null;
+    /** Thin-film iridescence channel for wet brushes with `iridescence`. */
+    film?: FilmBuffer | null;
     /** Simulation steps per second (for ghost fade countdown). */
     speed?: number;
 }
@@ -137,7 +140,7 @@ export interface WetEvent {
     clock: number;
     /** How many strokes were recorded before it (where it falls between strokes in a replay). */
     at?: number;
-    kind: 'dry' | 'tilt' | 'params' | 'flow' | 'wet-paper';
+    kind: 'dry' | 'tilt' | 'params' | 'flow' | 'wet-paper' | 'ghost-release' | 'ghost-keep';
     layerId?: string;
     data?: unknown;
 }
@@ -296,6 +299,10 @@ export declare class PaintWetLayers {
         layerId: string;
         bounds: RasterRect | null;
     }>;
+    /** Starts the fade countdown of an agent-triggered ghost on `layerId`. */
+    releaseGhost(layerId: string, linger?: number): void;
+    /** Keeps an unclaimed agent-triggered ghost on `layerId` as ordinary wet paint. */
+    keepGhost(layerId: string): void;
     /** The layer's light paint with all its wet paint dried (`null` without a wet layer or light), without changing anything. */
     bakedLight(layerId: string): TiledSurface | null;
     /** The layer's pixels with all its wet paint dried (deterministic), without changing anything. */