@pixerate/editor 0.94.0 → 0.96.0

package/dist/image-editor/index.d.cts

@@ -1,9 +1,9 @@
-import { X as RasterLayerBase, Y as RasterMask$1, _ as RasterPixelLayer, z as GroupBlendMode, M as LayerLocation$1, N as LayerLocks, L as LayerEffect, G as GlobalLight, a as LayerEffects, $ as RasterSources, U as RasterCompositor, l as CompositorOptions, t as EffectPattern, K as LayerEffectKind } from '../zlib-BJ6U7LuB.cjs';
-export { i as CompositeCallOptions, j as CompositeStats, o as DIRECT_GAUSSIAN_MAX_SIGMA, p as DecodedPng, a3 as ZlibError, a4 as adler32, a5 as base64ToBytes, a6 as blendTile, a9 as bytesToBase64, aa as changedTiles, ab as curveLut, ac as decodePng, af as deflate, ag as deflateRaw, am as encodePng, an as findLayer, ao as flattenLayers, ap as gaussianBlur, as as inflate, at as inflateRaw, au as insertLayer, aw as isLayerLocked, ax as isPng, aA as mapLayer, aE as parseDataUrl, aG as pngDataUrl } from '../zlib-BJ6U7LuB.cjs';
-import { P as PixelSurface, h as TiledSurface, B as BlendMode } from '../surface-CuBg2c6k.cjs';
-export { a as BLEND_MODES, b as BlendModeInfo, M as MaskSurface, R as RasterRect, c as Rgb, d as Rgba, S as SurfaceDraft, T as TILE, e as TILE_SHIFT, f as Tile, g as TileKey, i as blendChannel, j as blendImageData, k as blendLum, l as blendPixel, m as blendRgb, n as canvasCompositeOperation, o as collectTiles, p as contentBounds, q as emptySurface, r as fillRect, s as finishTile, t as isBlendMode, u as isSeparableBlendMode, v as normalizeBlendMode, w as packRgba, x as readPixel, y as readRegion, z as setLum, A as solidSurface, C as surfaceBytes, D as surfaceFromPixels, E as surfacesEqual, F as tileCoord, G as tileKey, H as tileRect, I as tilesInRect, J as translateSurface, K as uniformTile, L as writeRegion } from '../surface-CuBg2c6k.cjs';
-import { BrushSettings, StrokeCoverage, StrokeApply, StrokePoint } from '../paint/index.cjs';
-export { CoverageMap, DEFAULT_BRUSH, Dab, DabWalker, MAX_BRUSH_SIZE, PIGMENT_BANDS, PIGMENT_LAMBDA_MIN, PIGMENT_LAMBDA_STEP, PIGMENT_WAVELENGTHS, Pigment, PigmentOptions, PigmentRgb, applyStrokeToTile, coverageTileCoord, createPigment, createPigmentTools, dabCoverage, dabRect, lerpPigment, lerpPigmentInto, mixPigments, normalizeBrush, rasterizeDab, reflectanceToRgb, rgbToReflectance, setPigmentColor, smoothPoints, tipFalloff, tipReach, tipShape, walkDabs } from '../paint/index.cjs';
+import { RasterLayerBase, RasterMask as RasterMask$1, RasterPixelLayer, GroupBlendMode, LayerLocation as LayerLocation$1, LayerLocks, LayerEffect, GlobalLight, LayerEffects, EffectPattern, RasterSources, RasterCompositor, CompositorOptions, LayerEffectKind } from '../raster/index.cjs';
+export { BevelContour, BevelEmbossEffect, BevelStyle, BevelTechnique, BevelTexture, ColorOverlayEffect, CompositeCallOptions, CompositeStats, ContourPoint, DEFAULT_GLOBAL_LIGHT, DIRECT_GAUSSIAN_MAX_SIGMA, DecodedPng, DropShadowEffect, EffectContour, EffectFill, EffectGradient, EffectPatternRef, EffectRect, GlowTechnique, GradientColorStop, GradientOpacityStop, GradientOverlayEffect, GradientStyle, InnerGlowEffect, InnerShadowEffect, LAYER_EFFECT_KINDS, LayerEffectError, MAX_EFFECT_REACH, OuterGlowEffect, PatternOverlayEffect, PatternPlacement, PatternTile, SatinEffect, StrokeEffect, StrokePosition, ZlibError, adler32, base64ToBytes, blendTile, builtinPattern, builtinPatternIds, bytesToBase64, changedTiles, curveLut, decodePng, defaultEffectGradient, defaultLayerEffect, deflate, deflateRaw, effectColorHex, effectReach, effectsFingerprint, effectsMargin, effectsScale, encodePng, findLayer, flattenLayers, gaussianBlur, hasActiveEffects, hashNoise, inflate, inflateRaw, insertLayer, isLayerEffectKind, isLayerLocked, isPng, layerEffectFields, layerEffectLabel, mapLayer, mergeLayerEffect, newEffectId, normalizeLayerEffects, parseDataUrl, parseEffectColor, pngDataUrl, renderLayerEffects, scaleLayerEffect, validateEffectGradient, validateLayerEffect, validateLayerEffects } from '../raster/index.cjs';
+import { P as PixelSurface, T as TiledSurface, B as BlendMode } from '../surface-DIA-XatS.cjs';
+export { a as BLEND_MODES, b as BlendModeInfo, M as MaskSurface, R as RasterRect, c as Rgb, d as Rgba, S as SurfaceDraft, e as TILE, f as TILE_SHIFT, g as Tile, h as TileKey, i as blendChannel, j as blendImageData, k as blendLum, l as blendPixel, m as blendRgb, n as canvasCompositeOperation, o as collectTiles, p as contentBounds, q as emptySurface, r as fillRect, s as finishTile, t as isBlendMode, u as isSeparableBlendMode, v as mixPigment8, w as mixPigmentRgb, x as normalizeBlendMode, y as packRgba, z as readPixel, A as readRegion, C as setLum, D as solidSurface, E as surfaceBytes, F as surfaceFromPixels, G as surfacesEqual, H as tileCoord, I as tileKey, J as tileRect, K as tilesInRect, L as translateSurface, N as uniformTile, O as writeRegion } from '../surface-DIA-XatS.cjs';
+import { BrushSettings, MixerSettings, MixerLoad, StrokeCoverage, MixerTarget, MixerStroke, StrokeApply, StrokePoint } from '../paint/index.cjs';
+export { CoverageMap, DEFAULT_BRUSH, DEFAULT_MIXER, Dab, DabWalker, EMPTY_MIXER_LOAD, MAX_BRUSH_SIZE, MIXER_DRAIN, MIXER_PICKUP_RATE, MIXING_MODELS, MixingModel, PIGMENT_BANDS, PIGMENT_LAMBDA_MIN, PIGMENT_LAMBDA_STEP, PIGMENT_WAVELENGTHS, Pigment, PigmentOptions, PigmentRgb, applyStrokeToTile, cleanMixer, coverageTileCoord, createPigment, createPigmentTools, dabCoverage, dabRect, lerpPigment, lerpPigmentInto, loadMixer, mixPigments, normalizeBrush, normalizeMixer, rasterizeDab, reflectanceToRgb, rgbToReflectance, setPigmentColor, smoothPoints, tipFalloff, tipReach, tipShape, walkDabs } from '../paint/index.cjs';
 import { b as LoadReport, J as JsonObject, f as MigrationStep } from '../migrate-iTlm3a8h.cjs';
 import { a as AgentToolProvider, A as AgentTool } from '../registry-BqA1AZt0.cjs';
 import { b as CaptureSurface } from '../capture-DFEMFmVt.cjs';
@@ -286,7 +286,17 @@ interface SerializedLayeredImageEditorState {
     selection?: SerializedSelection;
     /** Global light for layer effects (missing = 120°, 30°). */
     globalLight?: GlobalLight;
+    /** The document's patterns for pattern effects, each an RGBA PNG data URL. */
+    patterns?: SerializedPattern[];
 }
+interface SerializedPattern {
+    id: string;
+    name: string;
+    png: string;
+}
+declare function serializePatterns(patterns: readonly EffectPattern[]): SerializedPattern[];
+/** Reads stored patterns, skipping (and reporting in `problems`) any that cannot be decoded. */
+declare function deserializePatterns(raw: unknown, problems?: string[]): EffectPattern[];
 interface EncodedSurface {
     url: string;
     x: number;
@@ -1174,6 +1184,10 @@ interface PsdImportResult {
     summary: PsdLayerSummary[];
     /** Pixels per inch, when the file says. */
     resolution?: number;
+    /** The patterns embedded in the file (`Patt` / `Pat2` / `Pat3`), which pattern effects use. */
+    patterns: EffectPattern[];
+    /** The global light (image resources 1037 and 1049), when the file has one. */
+    globalLight?: GlobalLight;
     info: {
         psb: boolean;
         depth: number;
@@ -1260,16 +1274,27 @@ interface PaintOptions {
     foreground: string;
     /** `#rrggbb`: what the eraser paints on transparency-locked layers and masks. */
     background: string;
+    /** Mixer Brush options (wet, load, mix, load / clean each stroke, RGB or pigment mixing). */
+    mixer: MixerSettings;
+    /** What the Mixer Brush carries now: its reservoir, how much is left and the picked-up colour. */
+    mixerLoad: MixerLoad;
 }
+/** Paint tools a stroke can use. */
+type StrokeTool = 'brush' | 'eraser' | 'mixer';
 /** A stroke: tool, target (default the active layer and target) and brush / colour overrides. */
 interface StrokeInit {
-    tool?: 'brush' | 'eraser';
+    tool?: StrokeTool;
     layerId?: string;
     channel?: LayerTarget;
     /** Overrides of the paint options' brush. */
     brush?: Partial<BrushSettings>;
-    /** Paint colour (default the foreground). Masks take its grey value. */
+    /**
+     * Paint colour (default the foreground). Masks take its grey value. For the mixer, the colour
+     * the reservoir is loaded with: given, it loads the brush whatever `loadEachStroke` says.
+     */
     color?: string | number[];
+    /** Overrides of the paint options' Mixer Brush settings (tool `mixer`). */
+    mixer?: Partial<MixerSettings>;
     /** Eraser colour on locked transparency / masks (default the background). */
     background?: string | number[];
     /** Kept with the stroke for replays (v1 brushes have no jitter). */
@@ -1293,14 +1318,25 @@ interface PaintStrokeResult {
     /** Document rectangle that changed (null when nothing did). */
     bounds: CropBox | null;
     dabs: number;
+    /** The Mixer Brush's load after the stroke (tool `mixer` only). */
+    mixerLoad?: MixerLoad;
 }
 /** An opaque pre-stroke history snapshot. */
 type HistoryEntryHandle = {
     readonly __historyEntry: unique symbol;
 };
+/** How a Mixer Brush stroke starts (see `PaintStrokeSession`). */
+interface MixerStrokeInit {
+    /** Makes the stroke over the session's live pixels. */
+    create(pixels: MixerTarget): MixerStroke;
+    /** Stores the brush load when the stroke ends and returns it (after any clean). */
+    end(load: MixerLoad): MixerLoad;
+}
 /**
  * A stroke in progress (see `beginStroke`): `push` input points as they arrive, then `end` (one
- * undo step) or `cancel`.
+ * undo step) or `cancel`. Brush and eraser strokes build up a coverage map composited over the
+ * pre-stroke pixels; Mixer Brush strokes paint dab by dab into the live pixels, so each dab picks
+ * up what the dabs before it laid down.
  */
 declare class PaintStrokeSession {
     private readonly controller;
@@ -1309,19 +1345,25 @@ declare class PaintStrokeSession {
         channel: LayerTarget;
         surface: TiledSurface;
     };
-    private readonly stroke;
     private readonly apply;
     private readonly before;
     private readonly base;
     private readonly live;
     private readonly touched;
+    private readonly stroke;
+    private readonly mixer;
+    private readonly mixerInit;
+    /** Mixer tiles written since the last update: they get new tile objects so the compositor sees them change. */
+    private readonly fresh;
     private last;
     private closed;
     constructor(controller: ImageEditorController, target: {
         id: string;
         channel: LayerTarget;
         surface: TiledSurface;
-    }, stroke: StrokeCoverage, apply: StrokeApply);
+    }, stroke: StrokeCoverage | MixerStrokeInit, apply: StrokeApply);
+    /** The live pixels a mixer stroke reads and writes; base tiles are copied on first write. */
+    private mixerPixels;
     get layerId(): string;
     /** Adds input points (document pixels); the stack shows the stroke so far. */
     push(points: readonly StrokePoint[]): void;
@@ -1586,6 +1628,11 @@ declare class ImageEditorController {
     setLayerEffectsEnabled(id: string, enabled: boolean, scale?: number, commitToHistory?: boolean): LayerEffects;
     /** Replaces a layer's effects (one undo step; `null` removes them). Returns the effects. */
     setLayerEffects(id: string, effects: LayerEffects | null, commitToHistory?: boolean): LayerEffects;
+    private patternIds;
+    /** Changes whenever the document's pattern list is replaced (the compositor then drops its caches). */
+    private patternsVersion;
+    /** The document's patterns (from an opened PSD), besides the built-in ones. */
+    getDocumentPatterns(): EffectPattern[];
     /** The light effects with "use global light" follow. */
     getGlobalLight(): GlobalLight;
     /** Sets the global light (one undo step). `angle` -360..360°, `altitude` 0..90°. Returns it. */
@@ -1617,9 +1664,19 @@ declare class ImageEditorController {
         mask?: boolean;
     }): PixelBuffer | null;
     /** Brush settings, colours and tool options of the paint tools (view state, no undo). */
-    setPaintOptions(options: Partial<Omit<PaintOptions, 'brush'>> & {
+    setPaintOptions(options: Partial<Omit<PaintOptions, 'brush' | 'mixer' | 'mixerLoad'>> & {
         brush?: Partial<BrushSettings>;
+        mixer?: Partial<MixerSettings>;
     }): PaintOptions;
+    /**
+     * Loads the Mixer Brush's reservoir full with `color` (default the foreground); the picked-up
+     * colour is kept. View state, no undo. Returns the brush load.
+     */
+    loadMixerBrush(color?: string | number[]): MixerLoad;
+    /** Cleans the Mixer Brush: empties the pickup well (the reservoir is kept). Returns the brush load. */
+    cleanMixerBrush(): MixerLoad;
+    /** Empties the Mixer Brush entirely (no reservoir, nothing picked up). Returns the brush load. */
+    emptyMixerBrush(): MixerLoad;
     /** D: black foreground, white background. */
     resetPaintColors(): void;
     /** X: swaps the foreground and background colours. */
@@ -1635,6 +1692,8 @@ declare class ImageEditorController {
      * without recording history.
      */
     beginStroke(init?: StrokeInit): PaintStrokeSession;
+    /** A Mixer Brush stroke's start: the settings, and the load (refilled when asked or set to). */
+    private mixerStroke;
     /** @internal Shows a stroke's live surface (no history). */
     _strokeUpdate(layerId: string, channel: LayerTarget, surface: TiledSurface, rects: CropBox[]): void;
     /** @internal Commits a finished stroke as one undo step (`before` is the pre-stroke state). */
@@ -1643,7 +1702,7 @@ declare class ImageEditorController {
     _captureForStroke(): HistoryEntryHandle;
     /**
      * Paints a whole stroke in one call (agents, replays): `points` in document pixels with optional
-     * pressure, through the brush or eraser. One undo step. Returns the layer, channel, the changed
+     * pressure, through the brush, eraser or Mixer Brush. One undo step. Returns the layer, channel, the changed
      * document bounds and the number of dabs.
      */
     paintStroke(init: StrokeInit & {
@@ -2219,7 +2278,7 @@ interface ImageAnnotation extends BaseAnnotation {
 }
 type Annotation = PenAnnotation | RectAnnotation | CircleAnnotation | ArrowAnnotation | LineAnnotation | TextAnnotation | ImageAnnotation;
 type CreateAnnotationPayload = Omit<PenAnnotation, 'id'> | Omit<RectAnnotation, 'id'> | Omit<CircleAnnotation, 'id'> | Omit<ArrowAnnotation, 'id'> | Omit<LineAnnotation, 'id'> | Omit<TextAnnotation, 'id'> | Omit<ImageAnnotation, 'id'>;
-type ImageEditorTool = 'select' | 'crop' | 'pen' | 'rect' | 'circle' | 'arrow' | 'line' | 'text' | 'watermark' | 'move' | 'brush' | 'eraser';
+type ImageEditorTool = 'select' | 'crop' | 'pen' | 'rect' | 'circle' | 'arrow' | 'line' | 'text' | 'watermark' | 'move' | 'brush' | 'eraser' | 'mixer';
 type ImageEditorFit = 'contain' | 'margin';
 interface ImageEditorState {
     sourceUrl: string | null;
@@ -2274,6 +2333,11 @@ interface ImageEditorState {
      * missing = angle 120°, altitude 30°. Recorded in undo history and saved in `toJSON()`.
      */
     globalLight?: GlobalLight;
+    /**
+     * The document's patterns (from an opened PSD), which pattern effects use by id besides the
+     * built-in ones. Recorded in undo history and saved in `toJSON()`.
+     */
+    patterns?: EffectPattern[];
 }
 /**
  * A stored editor state in the document-level schema (versions 1 and 2). Documents whose layer
@@ -3184,23 +3248,41 @@ declare function layerMenu(controller: ImageEditorController): LayerMenuItem[];
 /** Runs a menu action on the active layer. Resolves to the error message when it was refused. */
 declare function runLayerMenuAction(controller: ImageEditorController, action: LayerMenuAction): Promise<string | null>;
 
+/** A Mixer Brush load as tool output: hex colours and the amount left. */
+declare function mixerLoadResult(load: MixerLoad): {
+    reservoir: string | null;
+    amount: number;
+    pickup: string | null;
+};
 /**
- * Agent tools for painting: `paint_stroke` (brush or eraser along points, on pixels or a mask),
- * `fill_pixels` and `clear_pixels` (Edit › Fill / Clear inside the selection). Each is one undo
- * step and returns the layer, channel and changed bounds.
+ * Agent tools for painting: `paint_stroke` (brush, Mixer Brush or eraser along points, on pixels
+ * or a mask), `fill_pixels` and `clear_pixels` (Edit › Fill / Clear inside the selection), each
+ * one undo step returning the layer, channel and changed bounds; and the Mixer Brush's load:
+ * `get_mixer_brush`, `load_mixer_brush` and `clean_mixer_brush` (view state, no undo).
  */
 declare function createImagePaintTools(controller: ImageEditorController): AgentTool[];
 
 /**
  * The paint tools' view model, shared by the React and Svelte editors: the brush options bar's
- * controls, Photoshop's shortcuts (B, E, V, [ ], Shift+[ ], number keys, D, X) and a pointer
- * gesture that turns pointer events into strokes (Brush, Eraser) or layer moves (Move).
+ * controls, Photoshop's shortcuts (B, Shift+B, E, V, [ ], Shift+[ ], number keys, D, X) and a
+ * pointer gesture that turns pointer events into strokes (Brush, Mixer Brush, Eraser) or layer
+ * moves (Move).
  */
 
 /** Controls of the brush options bar (`hardness`, `opacity`, `flow`, `smoothing` shown in %). */
 declare const BRUSH_OPTION_CONTROLS: readonly (ControlSpec & {
     id: 'size' | 'hardness' | 'opacity' | 'flow' | 'smoothing';
 })[];
+/** Controls of the Mixer Brush (shown in %, with the brush controls, while the mixer is active). */
+declare const MIXER_OPTION_CONTROLS: readonly (ControlSpec & {
+    id: 'wet' | 'load' | 'mix';
+})[];
+/** The Mixer Brush's mixing models, for its RGB / Pigment toggle. */
+declare const MIXER_MIXING_OPTIONS: readonly {
+    id: MixerSettings['mixing'];
+    label: string;
+    title: string;
+}[];
 /** The paint tools in the toolbar. */
 declare const PAINT_TOOLS: readonly [{
     readonly id: "move";
@@ -3210,6 +3292,10 @@ declare const PAINT_TOOLS: readonly [{
     readonly id: "brush";
     readonly label: "Brush";
     readonly shortcut: "B";
+}, {
+    readonly id: "mixer";
+    readonly label: "Mixer";
+    readonly shortcut: "Shift+B";
 }, {
     readonly id: "eraser";
     readonly label: "Eraser";
@@ -3217,6 +3303,8 @@ declare const PAINT_TOOLS: readonly [{
 }];
 type PaintTool = (typeof PAINT_TOOLS)[number]['id'];
 declare const isPaintTool: (tool: string) => tool is PaintTool;
+/** `#rrggbb` of an sRGB triple (0..1), e.g. the Mixer Brush's reservoir. */
+declare function rgbUnitToHex(c: readonly [number, number, number]): string;
 interface ShortcutEvent {
     key: string;
     shiftKey?: boolean;
@@ -3228,7 +3316,7 @@ interface ShortcutEvent {
 }
 /**
  * Applies a paint shortcut. Returns true when it was one (the caller then prevents the default).
- * B / E / V choose the tool; [ and ] change the size, with Shift the hardness by 25 %; 1..9 set the
+ * B / Shift+B (Mixer Brush) / E / V choose the tool; [ and ] change the size, with Shift the hardness by 25 %; 1..9 set the
  * opacity to 10..90 % and 0 to 100 %; D resets the colours to black and white; X swaps them.
  */
 declare function handlePaintShortcut(controller: ImageEditorController, e: ShortcutEvent): boolean;
@@ -3243,7 +3331,7 @@ declare function pointerPressure(e: {
     pressure?: number;
 }): number;
 /**
- * Turns pointer events into strokes (Brush, Eraser on the active layer's target) or layer moves
+ * Turns pointer events into strokes (Brush, Mixer Brush, Eraser on the active layer's target) or layer moves
  * (Move on the active pixel layer). `down` returns an error message when the tool cannot act.
  */
 declare class PaintGesture {
@@ -3391,16 +3479,85 @@ interface PsdExportInput {
     merged: ArrayLike<number>;
     /** Pixels per inch (default 72). */
     resolution?: number;
+    /** The document's patterns; those the effects use are embedded (built-in ones too). */
+    patterns?: readonly EffectPattern[];
+    /** Written as image resources 1037 and 1049. */
+    globalLight?: GlobalLight;
 }
 interface PsdExportResult {
     bytes: Uint8Array;
     psb: boolean;
     /** Layer records written (group folders and dividers included). */
     records: number;
+    /** One sentence per loss, naming the layers. */
+    warnings: string[];
 }
 /** Writes the prepared stack as PSD (or PSB) bytes. */
 declare function exportPsd(input: PsdExportInput): PsdExportResult;
 
+interface ParsedLayerEffects {
+    effects: LayerEffects;
+    /** What could not be held exactly (empty when the mapping is exact). */
+    notes: string[];
+}
+/**
+ * Parses `lfx2` / `lfxs` / `lmfx` block data (u32 version 0, then a versioned descriptor).
+ * Effects marked `present: false` are left out. Returns `null` when the data is not a descriptor.
+ */
+declare function parseLfx2(data: Uint8Array): ParsedLayerEffects | null;
+/**
+ * Writes effects as `lfx2` block data, Scale Effects baked into the sizes (Photoshop's `Scl ` is
+ * written as 100 %). Several instances of one kind go into its multi key
+ * (`dropShadowMulti`, `frameFXMulti` …); kinds without one keep only the first instance.
+ * Returns the data and how many instances had to be left out.
+ */
+declare function writeLfx2(effects: LayerEffects): {
+    data: Uint8Array;
+    dropped: number;
+};
+/** Parses legacy `lrFX` effects: drop / inner shadows, outer / inner glows and solid fill. Bevels are skipped. */
+declare function parseLrfx(data: Uint8Array): ParsedLayerEffects | null;
+
+/**
+ * Patterns: the global `Patt` / `Pat2` / `Pat3` tagged blocks (8 / 16 / 32-bit documents), which
+ * pattern overlays, pattern strokes and bevel textures refer to by id.
+ *
+ * ```text
+ * pattern  := version u32 (1), image mode u32, height u16, width u16,
+ *             name (Unicode string), unique id (Pascal string, unpadded),
+ *             [indexed: 768-byte palette], virtual memory array list
+ * VMA list := version u32 (3), length u32, rect (top, left, bottom, right i32),
+ *             channel count u32, then count + 2 arrays (user mask, sheet mask)
+ * array    := written u32 (0 = absent), length u32 (0 = absent), depth u32, rect,
+ *             depth u16, compression u8 (0 raw, 1 PackBits), data
+ * ```
+ *
+ * Each pattern in a block is prefixed by its u32 length and padded to 4 bytes. Photoshop writes
+ * the channel count as 24 and marks only the real channels as written; the first written arrays
+ * are the colour channels and the next one is transparency.
+ */
+
+/** Pattern block keys, by document depth. */
+declare const PATTERN_BLOCK_KEYS: string[];
+/** One pattern tile as stored: planar samples. */
+interface PsdPattern {
+    mode: number;
+    width: number;
+    height: number;
+    name: string;
+    id: string;
+    palette?: Uint8Array;
+    depth: number;
+    channels: Uint8Array[];
+    alpha?: Uint8Array;
+}
+/** The patterns of a `Patt` / `Pat2` / `Pat3` block. Throws `PsdError` on malformed data. */
+declare function parsePatternBlock(data: Uint8Array): PsdPattern[];
+/** A stored pattern as straight 8-bit sRGB RGBA, for rendering. */
+declare function psdPatternToEffectPattern(p: PsdPattern): EffectPattern;
+/** Writes 8-bit RGB(A) patterns as `Patt` block data (PackBits channels, transparency in the user mask slot). */
+declare function writePatternBlock(patterns: readonly EffectPattern[]): Uint8Array;
+
 /** Framework-free helpers behind the PSD buttons of the React and Svelte layer panels. */
 
 /** Types the file pickers accept. */
@@ -3426,4 +3583,4 @@ declare function psdBytesFromBase64(data: unknown): Uint8Array;
  */
 declare function createImagePsdTools(controller: ImageEditorController): AgentTool[];
 
-export { ADJUSTMENT_KEYS, ADJUSTMENT_KINDS, ADJUSTMENT_LAYER_CONTROLS, ADJUSTMENT_LAYER_OPACITY_CONTROL, ADJUSTMENT_LUT_SIZE, type AIResultOptions, AS_SHOT_KELVIN, type AdjustmentKind, type AdjustmentKindInfo, type AdjustmentLayer, type AdjustmentLayerBase, type AdjustmentLayerInit, type AdjustmentLayerMask, type AdjustmentLayerNode, type AdjustmentLayerOf, type AdjustmentLayerUpdate, type AdjustmentParamsMap, type Annotation, type AnnotationLayer, type AnnotationPlacement, type AnnotationType, type ArrowAnnotation, type AspectRatio, BACKGROUND_LAYER_ID, BACKGROUND_LAYER_NAME, BLUR_FILTER_ID, BRUSH_OPTION_CONTROLS, type BaseAnnotation, type BlackWhiteParams, BlendMode, type BlurFilter, BrushSettings, type Chromaticity, type CircleAnnotation, type ColorBalanceParams, type ColorBalanceTone, type ColorDistance, type ColorRangeOptions, type ColorRangeSample, CompositorOptions, type CompositorSources, type ControlSection, type ControlSpec, type ControlTrack, type CreateAnnotationPayload, type CropBox, type CropHandle, type CurvePoint, type CurvesParams, D50, D65, DEFAULT_ADJUSTMENTS, DEFAULT_DEPTH_MASK, DEFAULT_REFINE_EDGE_PARAMS, DEFAULT_SELECTION_TOOL_OPTIONS, DEFAULT_TRANSFORM, DEVELOP_FILTER_ID, type DepthMaskOptions, type DescValue, type Descriptor, type DeserializeContext, type DevelopFilter, type DevelopSettings, type DropZone, EMPTY_DISTANCE, type ExportOptions, type FillOptions, GUIDED_FILTER_EPS, type GestureModifiers, type GroupLayer, HISTOGRAM_BINS, HUE_RANGE_LABELS, type HistogramChannel, type HistoryEntryHandle, type HueRange, type HueSaturationParams, IDENTITY_MATRIX3, IMAGE_ADJUSTMENT_CONTROLS, IMAGE_EDITOR_SCHEMA_VERSION, IMAGE_EDITOR_STATE_VERSION, type ImageAdjustments, type ImageAnnotation, type ImageDimensions, type ImageEditorAIHooks, type ImageEditorAssetStore, ImageEditorController, type ImageEditorDocumentLoad, type ImageEditorFit, type ImageEditorOptions, ImageEditorRenderer, type ImageEditorState, type ImageEditorTool, type ImageEditorToolProviderOptions, type ImageHistogram, type ImageLayer, type ImageLayerType, type ImagePoint, type ImageProcessVersion, type ImageProjection, type ImageTransform, type InpaintHook, type InpaintOptions, type InvertParams, LATEST_PROCESS_VERSION, LAYERED_SCHEMA_VERSION, LEGACY_PROCESS_VERSION, LUMA_709, type LayerBase, type LayerBlendMode, LayerCompositor, type LayerFilter, type LayerFilterKind, type LayerLocation, LayerLocks, type LayerMaskProps, type LayerMenuAction, type LayerMenuItem, LayerOperationError, type LayerPanelRow, type LayerPlacement, type LayerProperties, type LayerSourcesHost, type LayerStack, type LayerTarget, type LegacyParts, type LegacySerializedImageEditorState, type LegacyViewResult, type LevelsChannel, type LevelsParams, type LineAnnotation, MAX_KELVIN, MIN_KELVIN, MIRED_PER_TEMPERATURE_UNIT, type MagicWandOptions, type Matrix3, type MosaicImageDataLike, type MosaicRegion, PAINT_TOOLS, PSD_BLEND_KEYS, PSD_FILE_ACCEPT, PaintGesture, type PaintOptions, type PaintPointerSample, type PaintStrokeResult, PaintStrokeSession, type PaintTool, type ParsedAdjustment, type PenAnnotation, type PhotoFilterParams, type PixelBuffer, type PixelLayer, type PixelLayerInit, type PixelOp, PixelSurface, type PlaneLayout, type PosterizeParams, type PsdChannel, PsdError, type PsdExportInput, type PsdExportResult, type PsdFile, type PsdHeader, type PsdImportOptions, type PsdImportResult, type PsdLayerMask, type PsdLayerRecord, type PsdLayerSummary, type PsdRect, type PsdResource, type PsdTaggedBlock, type PsdTreeNode, type QuickMaskStyle, REFINE_EDGE_CONTROLS, type RasterMask, type RectAnnotation, type ReferenceItem, type RefineEdgeControl, type RefineEdgeParams, type RemoveBackgroundHook, type RemoveBackgroundOptions, type RenderOptions, type RouteInput, SELECTION_MODES, SELECTION_MODE_LABELS, SELECTION_MODIFY_OPS, SELECTION_TOOLS, SUPPORTED_ADJUSTMENT_KEYS, type SampleOptions, type SelectionChannel, type SelectionCommandOptions, SelectionGesture, type SelectionMask, type SelectionMode, type SelectionModifyOp, type SelectionToolKind, type SelectionToolOptions, type SerializeContext, type SerializedAdjustmentLayer, type SerializedAnnotationLayer, type SerializedGroupLayer, type SerializedImageEditorState, type SerializedLayer, type SerializedLayerEffects, type SerializedLayeredImageEditorState, type SerializedPixelLayer, type SerializedRasterMask, type SerializedSelection, type ShapeSelectionOptions, type ShortcutEvent, StrokeApply, StrokeCoverage, type StrokeInit, StrokePoint, TINT_SCALE, TONE_LUT_SIZE, TONE_RANGE_PRESETS, type TextAnnotation, type ThresholdParams, TiledSurface, type ToneRangePreset, type UnitLevels, VIBRANCE_GREY, type VibranceParams, type ViewportMetrics, XYZ_D50_TO_SRGB, activeAdjustmentLayers, addLayerEffect, addLayerFilter, addToHistogram, adjustmentKindLabel, adjustmentLayersKey, adjustmentNodeAsLayer, adjustmentNodeFromLegacy, annotationLayerFor, annotationLayerName, applyAdjustmentLayers, applyAdjustments, applyBoxBlur, applyDepthMask, applyImageProjectionToContext, applyLegacyAdjustments, applyMatrix3, applyOutputStage, applyProcess2Adjustments, applyRegionBlur, applyRegionMosaic, backgroundLayer, baseProjection, blackWhiteGray, blurFilter, borderCoverage, boxMean, boxToCurvePoint, bradfordAdaptation, buildLayerMaskPlanes, buildToneLut, calculateCropDrag, canvasToImagePoint, clampControlValue, clampCropToImage, colorBalanceChannel, colorRange, combineSelections, compileAdjustmentLayer, computeHistogram, computeSelectionBounds, contractCoverage, controlPosition, controlTrackBackground, coverageToByte, coveringRect, createAdjustmentLayer, createImageCaptureSurface, createImageEditTools, createImageEditorToolProvider, createImageEffectTools, createImageLayerTools, createImagePaintTools, createImagePsdTools, createImageSelectionTools, createSelectionMask, curveLutFromLevels, curvePointToBox, curveSvgPath, decodeLayerChannel, decodeLayerMask, decodeMergedImage, decodePlanes, decodePngDataUrl, decodeSelectionRle, defaultAdjustmentParams, depthMaskAlpha, depthRasterMask, describeLayer, describeLayerEffects, describeSelection, deserializeEffects, deserializeLayer, deserializeLayers, deserializeSelection, developFilter, developFromAdjustments, developTarget, distanceTransform, downloadPsd, dropPlacement, dropZone, duplicateLayer, edgeWidth, ellipsePoints, ellipseSelection, emptyHistogram, encodeRle, encodeSelectionRle, encodeSurface, evaluateAdjustmentLayers, expandCoverage, exportPsd, featherCoverage, findAdjustmentControl, findLayerControl, formatControlValue, fullSelection, getAnnotationBounds, getControlPath, getCropCursor, getRotatedSize, getViewportMetrics, getViewportProjection, globalImageCache, greyMorphology, groupLayers, guidePlanes, guidedFilterColor, handlePaintShortcut, hasResampledLegacyMask, hashMaskContent, hexToRgb, histogramPath, hitTestAnnotation, hitTestCrop, hitTestCurvePoint, hslToRgb, hueRange, hueRangeTables, hueRangeWeight, hueSaturation, identityCurve, identityLevels, imageEditorStateMigrations, imageToCanvasPoint, importPsd, insertCurvePoint, invertMatrix3, invertSelection, isActiveFilter, isAdjustmentKind, isDefaultDepthMask, isLegacyShape, isPaintTool, isQuarterTurn, isQuarterTurnSwapped, isSelectionEmpty, isSelectionMode, isSpatialFilter, kelvinToTemperature, layerBadge, layerEffectsOf, layerLabel, layerMaskCoverage, layerMaskFromSelection, layerMaskKey, layerMenu, layerName, layerPanelRows, layerTree, layerTypeLabel, layersFromLegacy, legacyAdjustmentLayer, legacyMaskOf, legacyView, levelsValue, linearSrgbToXy, linearToSrgb, loadImageEditorDocument, magicWand, mapCropHandle, maskSummary, migrateSerializedImageEditorState, migrateToLayeredState, modifySelection, moveCurvePoint, moveLayer, mulMatrix3, needsLegacyBase, neutralHueRange, newLayerId, normalizeAdjustmentLayer, normalizeAdjustmentLayers, normalizeAngle, normalizeFilter, normalizeLayerMask, normalizeProcessVersion, normalizeRect, normalizeRefineEdgeParams, normalizeStoredAdjustments, offsetLayer, openPsdFile, parseAdjustmentBlock, parseBlend, parseColor, parseSelectionMode, parseVersionedDescriptor, photoFilterMatrix, pixelLayerBounds, pixelLayers, placeLayer, pointerPressure, polygonCoverage, polygonSelection, posterizeValue, projectImagePoint, projectImageRect, projectMaskCoverage, projectQuarterTurn, psdBytesFromBase64, psdFileName, psdToLayers, quickMaskPixels, rangeLightness, rasterMaskFromLegacy, readAdjustmentControls, readPsd, rectSelection, refineCoverage, refineEdgeHalo, refineSelection, removeAlpha, removeCurvePoint, removeLayer, removeLayerEffect, removeLayerFilter, renderLayeredBase, requireLayer, requireUnlocked, resizePixels, resizeSelection, resolveExternalAssets, resolveMosaicRegionBounds, rgbToGray, rgbToHsl, runLayerMenuAction, sampleLut, sampleToneLut, selectionArea, selectionFromCoverage, selectionFromPixels, selectionModeFromModifiers, selectionOutline, selectionToCoverage, selectionToPixels, selectionValueAt, serializeEffects, serializeLayer, serializeLayers, serializeLayersExternal, serializeSelection, setControlPath, setLayerEffects, setLayerEffectsEnabled, setLayerMask, setLayerProperties, shiftCoverage, smoothCoverage, splitOverlayAnnotations, srgb8ToLab, srgbToLinear, sumHistograms, tempTintToXy, temperatureToKelvin, toHex, toneCurve, toneLuts, toneRange, ungroupLayer, unionRect, unprojectCanvasPoint, updateLayerEffect, updateLayerFilter, updateLayerMaskProps, uvToXy, versionedDescriptorBytes, vibranceLinear, vibrancePixel, wbMatrix, whiteBalanceFromSample, whiteBalanceMatrix, withNewIds, writeAdjustmentBlock, writePsd, xyToTempTint, xyToUv };
+export { ADJUSTMENT_KEYS, ADJUSTMENT_KINDS, ADJUSTMENT_LAYER_CONTROLS, ADJUSTMENT_LAYER_OPACITY_CONTROL, ADJUSTMENT_LUT_SIZE, type AIResultOptions, AS_SHOT_KELVIN, type AdjustmentKind, type AdjustmentKindInfo, type AdjustmentLayer, type AdjustmentLayerBase, type AdjustmentLayerInit, type AdjustmentLayerMask, type AdjustmentLayerNode, type AdjustmentLayerOf, type AdjustmentLayerUpdate, type AdjustmentParamsMap, type Annotation, type AnnotationLayer, type AnnotationPlacement, type AnnotationType, type ArrowAnnotation, type AspectRatio, BACKGROUND_LAYER_ID, BACKGROUND_LAYER_NAME, BLUR_FILTER_ID, BRUSH_OPTION_CONTROLS, type BaseAnnotation, type BlackWhiteParams, BlendMode, type BlurFilter, BrushSettings, type Chromaticity, type CircleAnnotation, type ColorBalanceParams, type ColorBalanceTone, type ColorDistance, type ColorRangeOptions, type ColorRangeSample, CompositorOptions, type CompositorSources, type ControlSection, type ControlSpec, type ControlTrack, type CreateAnnotationPayload, type CropBox, type CropHandle, type CurvePoint, type CurvesParams, D50, D65, DEFAULT_ADJUSTMENTS, DEFAULT_DEPTH_MASK, DEFAULT_REFINE_EDGE_PARAMS, DEFAULT_SELECTION_TOOL_OPTIONS, DEFAULT_TRANSFORM, DEVELOP_FILTER_ID, type DepthMaskOptions, type DescValue, type Descriptor, type DeserializeContext, type DevelopFilter, type DevelopSettings, type DropZone, EMPTY_DISTANCE, EffectPattern, type ExportOptions, type FillOptions, GUIDED_FILTER_EPS, type GestureModifiers, GlobalLight, type GroupLayer, HISTOGRAM_BINS, HUE_RANGE_LABELS, type HistogramChannel, type HistoryEntryHandle, type HueRange, type HueSaturationParams, IDENTITY_MATRIX3, IMAGE_ADJUSTMENT_CONTROLS, IMAGE_EDITOR_SCHEMA_VERSION, IMAGE_EDITOR_STATE_VERSION, type ImageAdjustments, type ImageAnnotation, type ImageDimensions, type ImageEditorAIHooks, type ImageEditorAssetStore, ImageEditorController, type ImageEditorDocumentLoad, type ImageEditorFit, type ImageEditorOptions, ImageEditorRenderer, type ImageEditorState, type ImageEditorTool, type ImageEditorToolProviderOptions, type ImageHistogram, type ImageLayer, type ImageLayerType, type ImagePoint, type ImageProcessVersion, type ImageProjection, type ImageTransform, type InpaintHook, type InpaintOptions, type InvertParams, LATEST_PROCESS_VERSION, LAYERED_SCHEMA_VERSION, LEGACY_PROCESS_VERSION, LUMA_709, type LayerBase, type LayerBlendMode, LayerCompositor, LayerEffect, LayerEffectKind, LayerEffects, type LayerFilter, type LayerFilterKind, type LayerLocation, LayerLocks, type LayerMaskProps, type LayerMenuAction, type LayerMenuItem, LayerOperationError, type LayerPanelRow, type LayerPlacement, type LayerProperties, type LayerSourcesHost, type LayerStack, type LayerTarget, type LegacyParts, type LegacySerializedImageEditorState, type LegacyViewResult, type LevelsChannel, type LevelsParams, type LineAnnotation, MAX_KELVIN, MIN_KELVIN, MIRED_PER_TEMPERATURE_UNIT, MIXER_MIXING_OPTIONS, MIXER_OPTION_CONTROLS, type MagicWandOptions, type Matrix3, MixerLoad, MixerSettings, MixerStroke, type MixerStrokeInit, MixerTarget, type MosaicImageDataLike, type MosaicRegion, PAINT_TOOLS, PATTERN_BLOCK_KEYS, PSD_BLEND_KEYS, PSD_FILE_ACCEPT, PaintGesture, type PaintOptions, type PaintPointerSample, type PaintStrokeResult, PaintStrokeSession, type PaintTool, type ParsedAdjustment, type ParsedLayerEffects, type PenAnnotation, type PhotoFilterParams, type PixelBuffer, type PixelLayer, type PixelLayerInit, type PixelOp, PixelSurface, type PlaneLayout, type PosterizeParams, type PsdChannel, PsdError, type PsdExportInput, type PsdExportResult, type PsdFile, type PsdHeader, type PsdImportOptions, type PsdImportResult, type PsdLayerMask, type PsdLayerRecord, type PsdLayerSummary, type PsdPattern, type PsdRect, type PsdResource, type PsdTaggedBlock, type PsdTreeNode, type QuickMaskStyle, REFINE_EDGE_CONTROLS, type RasterMask, type RectAnnotation, type ReferenceItem, type RefineEdgeControl, type RefineEdgeParams, type RemoveBackgroundHook, type RemoveBackgroundOptions, type RenderOptions, type RouteInput, SELECTION_MODES, SELECTION_MODE_LABELS, SELECTION_MODIFY_OPS, SELECTION_TOOLS, SUPPORTED_ADJUSTMENT_KEYS, type SampleOptions, type SelectionChannel, type SelectionCommandOptions, SelectionGesture, type SelectionMask, type SelectionMode, type SelectionModifyOp, type SelectionToolKind, type SelectionToolOptions, type SerializeContext, type SerializedAdjustmentLayer, type SerializedAnnotationLayer, type SerializedGroupLayer, type SerializedImageEditorState, type SerializedLayer, type SerializedLayerEffects, type SerializedLayeredImageEditorState, type SerializedPattern, type SerializedPixelLayer, type SerializedRasterMask, type SerializedSelection, type ShapeSelectionOptions, type ShortcutEvent, StrokeApply, StrokeCoverage, type StrokeInit, StrokePoint, type StrokeTool, TINT_SCALE, TONE_LUT_SIZE, TONE_RANGE_PRESETS, type TextAnnotation, type ThresholdParams, TiledSurface, type ToneRangePreset, type UnitLevels, VIBRANCE_GREY, type VibranceParams, type ViewportMetrics, XYZ_D50_TO_SRGB, activeAdjustmentLayers, addLayerEffect, addLayerFilter, addToHistogram, adjustmentKindLabel, adjustmentLayersKey, adjustmentNodeAsLayer, adjustmentNodeFromLegacy, annotationLayerFor, annotationLayerName, applyAdjustmentLayers, applyAdjustments, applyBoxBlur, applyDepthMask, applyImageProjectionToContext, applyLegacyAdjustments, applyMatrix3, applyOutputStage, applyProcess2Adjustments, applyRegionBlur, applyRegionMosaic, backgroundLayer, baseProjection, blackWhiteGray, blurFilter, borderCoverage, boxMean, boxToCurvePoint, bradfordAdaptation, buildLayerMaskPlanes, buildToneLut, calculateCropDrag, canvasToImagePoint, clampControlValue, clampCropToImage, colorBalanceChannel, colorRange, combineSelections, compileAdjustmentLayer, computeHistogram, computeSelectionBounds, contractCoverage, controlPosition, controlTrackBackground, coverageToByte, coveringRect, createAdjustmentLayer, createImageCaptureSurface, createImageEditTools, createImageEditorToolProvider, createImageEffectTools, createImageLayerTools, createImagePaintTools, createImagePsdTools, createImageSelectionTools, createSelectionMask, curveLutFromLevels, curvePointToBox, curveSvgPath, decodeLayerChannel, decodeLayerMask, decodeMergedImage, decodePlanes, decodePngDataUrl, decodeSelectionRle, defaultAdjustmentParams, depthMaskAlpha, depthRasterMask, describeLayer, describeLayerEffects, describeSelection, deserializeEffects, deserializeLayer, deserializeLayers, deserializePatterns, deserializeSelection, developFilter, developFromAdjustments, developTarget, distanceTransform, downloadPsd, dropPlacement, dropZone, duplicateLayer, edgeWidth, ellipsePoints, ellipseSelection, emptyHistogram, encodeRle, encodeSelectionRle, encodeSurface, evaluateAdjustmentLayers, expandCoverage, exportPsd, featherCoverage, findAdjustmentControl, findLayerControl, formatControlValue, fullSelection, getAnnotationBounds, getControlPath, getCropCursor, getRotatedSize, getViewportMetrics, getViewportProjection, globalImageCache, greyMorphology, groupLayers, guidePlanes, guidedFilterColor, handlePaintShortcut, hasResampledLegacyMask, hashMaskContent, hexToRgb, histogramPath, hitTestAnnotation, hitTestCrop, hitTestCurvePoint, hslToRgb, hueRange, hueRangeTables, hueRangeWeight, hueSaturation, identityCurve, identityLevels, imageEditorStateMigrations, imageToCanvasPoint, importPsd, insertCurvePoint, invertMatrix3, invertSelection, isActiveFilter, isAdjustmentKind, isDefaultDepthMask, isLegacyShape, isPaintTool, isQuarterTurn, isQuarterTurnSwapped, isSelectionEmpty, isSelectionMode, isSpatialFilter, kelvinToTemperature, layerBadge, layerEffectsOf, layerLabel, layerMaskCoverage, layerMaskFromSelection, layerMaskKey, layerMenu, layerName, layerPanelRows, layerTree, layerTypeLabel, layersFromLegacy, legacyAdjustmentLayer, legacyMaskOf, legacyView, levelsValue, linearSrgbToXy, linearToSrgb, loadImageEditorDocument, magicWand, mapCropHandle, maskSummary, migrateSerializedImageEditorState, migrateToLayeredState, mixerLoadResult, modifySelection, moveCurvePoint, moveLayer, mulMatrix3, needsLegacyBase, neutralHueRange, newLayerId, normalizeAdjustmentLayer, normalizeAdjustmentLayers, normalizeAngle, normalizeFilter, normalizeLayerMask, normalizeProcessVersion, normalizeRect, normalizeRefineEdgeParams, normalizeStoredAdjustments, offsetLayer, openPsdFile, parseAdjustmentBlock, parseBlend, parseColor, parseLfx2, parseLrfx, parsePatternBlock, parseSelectionMode, parseVersionedDescriptor, photoFilterMatrix, pixelLayerBounds, pixelLayers, placeLayer, pointerPressure, polygonCoverage, polygonSelection, posterizeValue, projectImagePoint, projectImageRect, projectMaskCoverage, projectQuarterTurn, psdBytesFromBase64, psdFileName, psdPatternToEffectPattern, psdToLayers, quickMaskPixels, rangeLightness, rasterMaskFromLegacy, readAdjustmentControls, readPsd, rectSelection, refineCoverage, refineEdgeHalo, refineSelection, removeAlpha, removeCurvePoint, removeLayer, removeLayerEffect, removeLayerFilter, renderLayeredBase, requireLayer, requireUnlocked, resizePixels, resizeSelection, resolveExternalAssets, resolveMosaicRegionBounds, rgbToGray, rgbToHsl, rgbUnitToHex, runLayerMenuAction, sampleLut, sampleToneLut, selectionArea, selectionFromCoverage, selectionFromPixels, selectionModeFromModifiers, selectionOutline, selectionToCoverage, selectionToPixels, selectionValueAt, serializeEffects, serializeLayer, serializeLayers, serializeLayersExternal, serializePatterns, serializeSelection, setControlPath, setLayerEffects, setLayerEffectsEnabled, setLayerMask, setLayerProperties, shiftCoverage, smoothCoverage, splitOverlayAnnotations, srgb8ToLab, srgbToLinear, sumHistograms, tempTintToXy, temperatureToKelvin, toHex, toneCurve, toneLuts, toneRange, ungroupLayer, unionRect, unprojectCanvasPoint, updateLayerEffect, updateLayerFilter, updateLayerMaskProps, uvToXy, versionedDescriptorBytes, vibranceLinear, vibrancePixel, wbMatrix, whiteBalanceFromSample, whiteBalanceMatrix, withNewIds, writeAdjustmentBlock, writeLfx2, writePatternBlock, writePsd, xyToTempTint, xyToUv };