@pixerate/editor 0.275.0 → 0.276.0

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

@@ -63,4 +63,46 @@ export declare const WET_PARAM_SCHEMA: {
         readonly description: string;
     };
 };
+export declare const LIVE_PATTERN_SCHEMA: {
+    readonly pattern: {
+        readonly type: "string";
+        readonly enum: readonly ["spots", "stripes", "coral", "maze", "worms"];
+        readonly description: "Pearson Gray-Scott preset: spots, stripes, coral, maze or worms (default spots). Sets feed and kill unless explicit feed/kill are also passed.";
+    };
+    readonly feed: {
+        readonly type: "number";
+        readonly minimum: 0.005;
+        readonly maximum: 0.1;
+        readonly description: "Gray-Scott feed rate F, 0.005..0.1 (default: the pattern preset’s feed rate).";
+    };
+    readonly kill: {
+        readonly type: "number";
+        readonly minimum: 0.02;
+        readonly maximum: 0.08;
+        readonly description: "Gray-Scott kill rate k, 0.02..0.08 (default: the pattern preset’s kill rate).";
+    };
+    readonly scale: {
+        readonly type: "number";
+        readonly minimum: 0.25;
+        readonly maximum: 4;
+        readonly description: "Diffusion scale 0.25..4 (larger values grow broader pattern features; default 1).";
+    };
+    readonly contrast: {
+        readonly type: "number";
+        readonly minimum: 0;
+        readonly maximum: 2;
+        readonly description: "How strongly V modulates the wet pigment or blends toward secondColor, 0..2 (default 0.85).";
+    };
+    readonly secondColor: {
+        readonly type: readonly ["string", "null"];
+        readonly pattern: "^#[0-9a-fA-F]{6}$";
+        readonly description: "Optional #rrggbb colour that high-V pattern ridges blend toward, or null to modulate pigment contrast (default null).";
+    };
+    readonly relief: {
+        readonly type: "number";
+        readonly minimum: 0;
+        readonly maximum: 1;
+        readonly description: string;
+    };
+};
 export declare function createPaintWetTools(c: PaintEditorController): PaintAgentTool[];

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

@@ -28,6 +28,7 @@ import { type EffectPaintPixels } from './effect-paint.cjs';
 import { type WetParams, type WetTilt } from '../paint/wet/model.cjs';
 import { type WetGpuProvider } from '../paint/wet/gpu.cjs';
 import { WetWorld, type WetBackendInfo, type WetGhostState, type WetPaperInput, type WetSnapshot, type WetWorldOptions } from '../paint/wet/world.cjs';
+import { LivePatternField, type LivePatternStats, type LivePatternsInput, type LivePatternsSettings } from '../paint/live-patterns.cjs';
 import { TiledSurface, type RasterRect } from '../raster/surface.cjs';
 import type { PaintBrush, WetMediumKind } from './brushes.cjs';
 import { type PenPoint, type StrokeCopy } from './engine.cjs';
@@ -115,6 +116,7 @@ export declare const WET_MEDIUM_PARAMS: Readonly<Record<WetMediumKind, Partial<W
 export interface WetLayerSettings {
     params: WetParams;
     flow: WetFlowSpec;
+    livePatterns?: LivePatternsSettings | null;
     ghost?: WetGhostState | null;
 }
 /** One wet layer as tools describe it. */
@@ -130,6 +132,7 @@ export interface WetLayerInfo {
     activeTiles: number;
     params: WetParams;
     flow: WetFlowSpec;
+    livePatterns?: LivePatternsSettings | null;
     /** Active ghost fade on the layer (`remaining` seconds of simulated time), when one is fading. */
     ghost?: {
         remaining: number;
@@ -140,7 +143,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' | 'ghost-release' | 'ghost-keep';
+    kind: 'dry' | 'tilt' | 'params' | 'flow' | 'wet-paper' | 'live-patterns' | 'seed-live-patterns' | 'ghost-release' | 'ghost-keep';
     layerId?: string;
     data?: unknown;
 }
@@ -158,6 +161,10 @@ export interface PaintWetHost {
     layerLight(id: string): TiledSurface | null;
     /** Shows new light paint for wet layers (not an undo step); the next `updateSurfaces` redraws. */
     updateLights(lights: ReadonlyMap<string, TiledSurface>): void;
+    /** The layer's thick height map (one channel), or `null` without any. */
+    layerHeight?(id: string): TiledSurface | null;
+    /** Shows new thick height maps for wet layers with live pattern relief (not an undo step). */
+    updateHeights?(heights: ReadonlyMap<string, TiledSurface>): void;
     /** The paint dried while time passed (the editor records nothing, it just redraws). */
     changed(): void;
 }
@@ -209,6 +216,7 @@ export declare class PaintWetLayers {
     world: WetWorld | null;
     tilt: WetTilt;
     readonly settings: Map<string, WetLayerSettings>;
+    readonly patterns: Map<string, LivePatternField>;
     paused: boolean;
     /** Wet strokes dry as soon as they end (one undo step with the stroke). */
     instantDry: boolean;
@@ -260,10 +268,21 @@ export declare class PaintWetLayers {
     /** Resolves when no batch is running. */
     idle(): Promise<void>;
     settingsOf(layerId: string, medium?: WetMediumKind): WetLayerSettings;
+    patternFieldOf(layerId: string): LivePatternField;
     /** Puts a layer in the world (its current pixels become the base under the wet paint). */
     ensureLane(layerId: string, medium?: WetMediumKind): WetWorld;
     setParams(layerId: string, update: Partial<WetParams>): WetParams;
     setFlow(layerId: string, update: Partial<WetFlowSpec>): WetFlowSpec;
+    setLivePatterns(layerId: string, update: LivePatternsInput | null): LivePatternsSettings | null;
+    seedLivePatterns(layerId: string, points: ReadonlyArray<{
+        x: number;
+        y: number;
+        strength?: number;
+    }>, radius: number, seed?: number, settings?: LivePatternsInput): {
+        seededCells: number;
+        stats: LivePatternStats;
+    };
+    livePatternStats(layerId: string): LivePatternStats;
     setTilt(update: Partial<WetTilt>): WetTilt;
     /** The paper changed. */
     paperChanged(): void;
@@ -274,6 +293,8 @@ export declare class PaintWetLayers {
     syncDisplays(maxTiles?: number): RasterRect[];
     /** Like `syncDisplays`, shading on the GPU when Engine B is active (all stale tiles at once). */
     syncDisplaysGpu(maxCpuTiles: number, lead?: boolean): Promise<RasterRect[]>;
+    /** Updates thick height maps for any layers with live pattern relief (`relief > 0`). */
+    private syncHeights;
     /** Shows each wet layer's live light paint (the light under it with the wet light shaded in). */
     private syncLights;
     /** Drops the wet layers whose paint has all dried (they become ordinary pixel layers). */

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

@@ -28,6 +28,7 @@ import { type EffectPaintPixels } from './effect-paint.js';
 import { type WetParams, type WetTilt } from '../paint/wet/model.js';
 import { type WetGpuProvider } from '../paint/wet/gpu.js';
 import { WetWorld, type WetBackendInfo, type WetGhostState, type WetPaperInput, type WetSnapshot, type WetWorldOptions } from '../paint/wet/world.js';
+import { LivePatternField, type LivePatternStats, type LivePatternsInput, type LivePatternsSettings } from '../paint/live-patterns.js';
 import { TiledSurface, type RasterRect } from '../raster/surface.js';
 import type { PaintBrush, WetMediumKind } from './brushes.js';
 import { type PenPoint, type StrokeCopy } from './engine.js';
@@ -115,6 +116,7 @@ export declare const WET_MEDIUM_PARAMS: Readonly<Record<WetMediumKind, Partial<W
 export interface WetLayerSettings {
     params: WetParams;
     flow: WetFlowSpec;
+    livePatterns?: LivePatternsSettings | null;
     ghost?: WetGhostState | null;
 }
 /** One wet layer as tools describe it. */
@@ -130,6 +132,7 @@ export interface WetLayerInfo {
     activeTiles: number;
     params: WetParams;
     flow: WetFlowSpec;
+    livePatterns?: LivePatternsSettings | null;
     /** Active ghost fade on the layer (`remaining` seconds of simulated time), when one is fading. */
     ghost?: {
         remaining: number;
@@ -140,7 +143,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' | 'ghost-release' | 'ghost-keep';
+    kind: 'dry' | 'tilt' | 'params' | 'flow' | 'wet-paper' | 'live-patterns' | 'seed-live-patterns' | 'ghost-release' | 'ghost-keep';
     layerId?: string;
     data?: unknown;
 }
@@ -158,6 +161,10 @@ export interface PaintWetHost {
     layerLight(id: string): TiledSurface | null;
     /** Shows new light paint for wet layers (not an undo step); the next `updateSurfaces` redraws. */
     updateLights(lights: ReadonlyMap<string, TiledSurface>): void;
+    /** The layer's thick height map (one channel), or `null` without any. */
+    layerHeight?(id: string): TiledSurface | null;
+    /** Shows new thick height maps for wet layers with live pattern relief (not an undo step). */
+    updateHeights?(heights: ReadonlyMap<string, TiledSurface>): void;
     /** The paint dried while time passed (the editor records nothing, it just redraws). */
     changed(): void;
 }
@@ -209,6 +216,7 @@ export declare class PaintWetLayers {
     world: WetWorld | null;
     tilt: WetTilt;
     readonly settings: Map<string, WetLayerSettings>;
+    readonly patterns: Map<string, LivePatternField>;
     paused: boolean;
     /** Wet strokes dry as soon as they end (one undo step with the stroke). */
     instantDry: boolean;
@@ -260,10 +268,21 @@ export declare class PaintWetLayers {
     /** Resolves when no batch is running. */
     idle(): Promise<void>;
     settingsOf(layerId: string, medium?: WetMediumKind): WetLayerSettings;
+    patternFieldOf(layerId: string): LivePatternField;
     /** Puts a layer in the world (its current pixels become the base under the wet paint). */
     ensureLane(layerId: string, medium?: WetMediumKind): WetWorld;
     setParams(layerId: string, update: Partial<WetParams>): WetParams;
     setFlow(layerId: string, update: Partial<WetFlowSpec>): WetFlowSpec;
+    setLivePatterns(layerId: string, update: LivePatternsInput | null): LivePatternsSettings | null;
+    seedLivePatterns(layerId: string, points: ReadonlyArray<{
+        x: number;
+        y: number;
+        strength?: number;
+    }>, radius: number, seed?: number, settings?: LivePatternsInput): {
+        seededCells: number;
+        stats: LivePatternStats;
+    };
+    livePatternStats(layerId: string): LivePatternStats;
     setTilt(update: Partial<WetTilt>): WetTilt;
     /** The paper changed. */
     paperChanged(): void;
@@ -274,6 +293,8 @@ export declare class PaintWetLayers {
     syncDisplays(maxTiles?: number): RasterRect[];
     /** Like `syncDisplays`, shading on the GPU when Engine B is active (all stale tiles at once). */
     syncDisplaysGpu(maxCpuTiles: number, lead?: boolean): Promise<RasterRect[]>;
+    /** Updates thick height maps for any layers with live pattern relief (`relief > 0`). */
+    private syncHeights;
     /** Shows each wet layer's live light paint (the light under it with the wet light shaded in). */
     private syncLights;
     /** Drops the wet layers whose paint has all dried (they become ordinary pixel layers). */