@pixerate/editor 0.113.0 → 0.115.0

package/dist/raster/index.js

@@ -1,7 +1,9 @@
 import {
+  BIT_DEPTHS,
   CURVE_LUT_SIZE,
   DEFAULT_GLOBAL_LIGHT,
   DIRECT_GAUSSIAN_MAX_SIGMA,
+  DeepCompositor,
   INTERPOLATIONS,
   LAYER_EFFECT_KINDS,
   LayerEffectError,
@@ -12,9 +14,7 @@ import {
   RasterCompositor,
   STROKE_CHAMFER_MAX,
   TransformTooLargeError,
-  ZlibError,
   activeEffectItems,
-  adler32,
   base64ToBytes,
   blendTile,
   buildEffectMaps,
@@ -25,12 +25,14 @@ import {
   compositeLayerEffects,
   compositeSurfaceOver,
   contourLut,
+  convertSurfaceDepth,
   curveLut,
   decodePng,
+  deepBytes,
+  deepTile,
   defaultEffectGradient,
   defaultLayerEffect,
-  deflate,
-  deflateRaw,
+  depthOf,
   effectColorHex,
   effectFillColors,
   effectReach,
@@ -45,9 +47,8 @@ import {
   gradientT,
   hasActiveEffects,
   hashNoise,
-  inflate,
-  inflateRaw,
   insertLayer,
+  isBitDepth,
   isInterpolation,
   isLayerEffectKind,
   isLayerLocked,
@@ -63,16 +64,33 @@ import {
   parseEffectColor,
   patchEffectMaps,
   pngDataUrl,
+  proxyOf,
+  readDeepRegion,
   reduceSurface,
   renderLayerEffects,
   scaleLayerEffect,
+  srgbDecode,
+  srgbEncode,
+  surfaceDepth,
+  surfaceFromDeepPixels,
+  tileSamples,
+  tileSamples16,
+  tileSamples32,
+  to16From32,
+  to16From8,
+  to32From16,
+  to32From8,
+  to8From16,
+  to8From32,
   transformSurface,
   transformedBounds,
   validateEffectGradient,
   validateLayerEffect,
   validateLayerEffects,
-  warpSurface
-} from "../chunk-LQEEDHOP.js";
+  warpSurface,
+  workingToSamples,
+  writeDeepRegion
+} from "../chunk-C6C5PDKU.js";
 import "../chunk-GX332W2C.js";
 import {
   BLEND_MODES,
@@ -116,12 +134,22 @@ import {
   translateSurface,
   uniformTile,
   writeRegion
-} from "../chunk-HNS7UHCM.js";
+} from "../chunk-XK5LZKBD.js";
+import {
+  ZlibError,
+  adler32,
+  deflate,
+  deflateRaw,
+  inflate,
+  inflateRaw
+} from "../chunk-6FCKOS2B.js";
 export {
+  BIT_DEPTHS,
   BLEND_MODES,
   CURVE_LUT_SIZE,
   DEFAULT_GLOBAL_LIGHT,
   DIRECT_GAUSSIAN_MAX_SIGMA,
+  DeepCompositor,
   INTERPOLATIONS,
   LAYER_EFFECT_KINDS,
   LayerEffectError,
@@ -159,12 +187,16 @@ export {
   compositeSurfaceOver,
   contentBounds,
   contourLut,
+  convertSurfaceDepth,
   curveLut,
   decodePng,
+  deepBytes,
+  deepTile,
   defaultEffectGradient,
   defaultLayerEffect,
   deflate,
   deflateRaw,
+  depthOf,
   effectColorHex,
   effectFillColors,
   effectReach,
@@ -185,6 +217,7 @@ export {
   inflate,
   inflateRaw,
   insertLayer,
+  isBitDepth,
   isBlendMode,
   isInterpolation,
   isLayerEffectKind,
@@ -208,6 +241,8 @@ export {
   patchEffectMaps,
   pigment8,
   pngDataUrl,
+  proxyOf,
+  readDeepRegion,
   readPixel,
   readRegion,
   reduceSurface,
@@ -215,14 +250,27 @@ export {
   scaleLayerEffect,
   setLum,
   solidSurface,
+  srgbDecode,
+  srgbEncode,
   standardBlendMode,
   surfaceBytes,
+  surfaceDepth,
+  surfaceFromDeepPixels,
   surfaceFromPixels,
   surfacesEqual,
   tileCoord,
   tileKey,
   tileRect,
+  tileSamples,
+  tileSamples16,
+  tileSamples32,
   tilesInRect,
+  to16From32,
+  to16From8,
+  to32From16,
+  to32From8,
+  to8From16,
+  to8From32,
   transformSurface,
   transformedBounds,
   translateSurface,
@@ -231,6 +279,8 @@ export {
   validateLayerEffect,
   validateLayerEffects,
   warpSurface,
+  workingToSamples,
+  writeDeepRegion,
   writeRegion
 };
 //# sourceMappingURL=index.js.map

package/dist/{render-BEriFuqK.d.cts → render-B1K_OoLy.d.cts}

@@ -1,4 +1,4 @@
-import { B as BlendMode, R as RasterRect, a as TiledSurface, M as MaskSurface, b as PixelSurface, T as TileKey } from './surface-C8RRg_Bh.cjs';
+import { a as BlendMode, R as RasterRect, j as TiledSurface, M as MaskSurface, c as PixelSurface, i as TileKey, h as Tile } from './surface-Cn30xIV6.cjs';
 import { H as Homography, V as Vec2 } from './types-CwMPoRMU.cjs';
 
 /**
@@ -832,6 +832,91 @@ declare class RasterCompositor<L extends CompositorLayer = CompositorLayer, S ex
 /** Tiles that differ between two surfaces (by tile identity), as tile keys. */
 declare function changedTiles(a: TiledSurface, b: TiledSurface): TileKey[];
 
+/**
+ * High bit depth tiles: 16-bit and 32-bit float samples alongside the 8-bit tile data.
+ *
+ * A tile may carry `deep` samples next to its `data`:
+ *
+ * - `Uint16Array`: 16 bits per channel, 0..65535, the same sRGB encoding and straight alpha as
+ *   the 8-bit data (`data = round(deep / 257)`).
+ * - `Float32Array`: 32-bit float per channel in **linear light** (sRGB primaries), straight
+ *   alpha, as Photoshop's 32-bit mode; colour may exceed 1 (`data` is the clamped sRGB encoding).
+ *
+ * `data` is always the 8-bit rendering of `deep`, so every 8-bit consumer (the compositor, the
+ * viewport, brushes, filters, the paint editor) keeps working unchanged and at full speed: it
+ * simply sees the 8-bit picture. A tile without `deep` holds 8-bit pixels; read at a higher depth
+ * (`tileSamples16` / `tileSamples32`) they are converted exactly as a bit-depth conversion would.
+ * Writers that only produce 8-bit data drop `deep` for the tiles they rewrite (those tiles become
+ * 8-bit precise), and writers that understand depth build tiles with `deepTile`.
+ *
+ * Masks (one channel) are coverage, not colour: their float samples are never linearised.
+ */
+
+/** Bits per channel: 8, 16 or 32 (float). */
+type BitDepth = 8 | 16 | 32;
+declare const BIT_DEPTHS: readonly BitDepth[];
+declare const isBitDepth: (v: unknown) => v is BitDepth;
+/** Deep samples of a tile: 16-bit encoded, or 32-bit linear float. */
+type DeepSamples = Uint16Array | Float32Array;
+/** sRGB-encoded 0..1 to linear light. */
+declare function srgbDecode(v: number): number;
+/** Linear light to sRGB-encoded (values above 1 extend the curve; below 0 clamp to 0). */
+declare function srgbEncode(v: number): number;
+/** 8-bit samples to 16-bit (`v × 257`, exact both ways). */
+declare function to16From8(data: ArrayLike<number>, out?: Uint16Array<ArrayBuffer>): Uint16Array;
+/** 8-bit samples to 32-bit float (colour linearised; alpha and masks as is). */
+declare function to32From8(data: ArrayLike<number>, channels: 1 | 4, out?: Float32Array<ArrayBuffer>): Float32Array;
+/** 16-bit samples to 32-bit float. */
+declare function to32From16(data: ArrayLike<number>, channels: 1 | 4, out?: Float32Array<ArrayBuffer>): Float32Array;
+/** 32-bit float samples to 16-bit (colour encoded and clamped to 0..1). */
+declare function to16From32(data: ArrayLike<number>, channels: 1 | 4, out?: Uint16Array<ArrayBuffer>): Uint16Array;
+/** 16-bit samples to 8-bit (rounded). */
+declare function to8From16(data: ArrayLike<number>, out?: Uint8ClampedArray<ArrayBuffer>): Uint8ClampedArray;
+/** 32-bit float samples to 8-bit (colour encoded and clamped). */
+declare function to8From32(data: ArrayLike<number>, channels: 1 | 4, out?: Uint8ClampedArray<ArrayBuffer>): Uint8ClampedArray;
+/** The 8-bit rendering of deep samples. */
+declare function proxyOf(deep: DeepSamples, channels: 1 | 4, out?: Uint8ClampedArray<ArrayBuffer>): Uint8ClampedArray;
+/** The bit depth deep samples hold. */
+declare const depthOf: (deep: DeepSamples) => 16 | 32;
+/**
+ * A stored tile from deep samples (`TILE × TILE × channels`): `null` when it renders as the
+ * surface default and holds nothing finer, an 8-bit tile when 8 bits hold it exactly (16-bit
+ * samples that are multiples of 257), else a tile with `deep` and its 8-bit rendering.
+ */
+declare function deepTile(deep: DeepSamples, channels: 1 | 4, defaultValue?: number): Tile | null;
+/** 16-bit samples of a tile (`undefined`: the default tile), converting 8-bit or float data. */
+declare function tileSamples16(tile: Tile | undefined, channels: 1 | 4, defaultValue?: number): Uint16Array;
+/** 32-bit float samples of a tile (`undefined`: the default tile), converting 8- or 16-bit data. */
+declare function tileSamples32(tile: Tile | undefined, channels: 1 | 4, defaultValue?: number): Float32Array;
+/** Deep samples of a tile at `depth` (16 or 32). */
+declare function tileSamples(tile: Tile | undefined, channels: 1 | 4, depth: 16 | 32, defaultValue?: number): DeepSamples;
+/** The deepest samples any tile of a surface holds: 8, 16 or 32. */
+declare function surfaceDepth(surface: TiledSurface): BitDepth;
+/** Copies `rect` of a surface at `depth` into a new buffer (`rect.width × rect.height × channels`). */
+declare function readDeepRegion(surface: TiledSurface, rect: RasterRect, depth: 16): Uint16Array;
+declare function readDeepRegion(surface: TiledSurface, rect: RasterRect, depth: 32): Float32Array;
+declare function readDeepRegion(surface: TiledSurface, rect: RasterRect, depth: 16 | 32): DeepSamples;
+/**
+ * Writes `rect.width × rect.height` interleaved deep samples at `rect` and returns the new
+ * surface. Partly covered tiles keep their other pixels, converted to the samples' depth.
+ */
+declare function writeDeepRegion(surface: TiledSurface, rect: RasterRect, samples: DeepSamples): TiledSurface;
+/** A surface holding `width × height` deep samples placed at (`x`, `y`). */
+declare function surfaceFromDeepPixels(pixels: {
+    width: number;
+    height: number;
+    data: DeepSamples;
+}, channels?: 1 | 4, x?: number, y?: number, defaultValue?: number): TiledSurface;
+/**
+ * The surface converted to `depth`: 8 drops every tile's deep samples (keeping their 8-bit
+ * rendering); 16 or 32 converts the deep samples tiles already hold. Tiles without deep samples
+ * are left alone (they read at any depth by conversion), so going up from 8 bits costs nothing.
+ * Returns the same surface when nothing changes.
+ */
+declare function convertSurfaceDepth(surface: TiledSurface, depth: BitDepth): TiledSurface;
+/** Bytes held by deep samples (in addition to `surfaceBytes`). */
+declare function deepBytes(surface: TiledSurface): number;
+
 /**
  * CPU renderer for layer effects.
  *
@@ -966,4 +1051,4 @@ declare function renderLayerEffects(effects: LayerEffects, layer: {
     fillOpacity?: number;
 }, backdrop: Uint8ClampedArray, canvas: EffectRect, ctx: EffectContext): void;
 
-export { type StrokeEffect as $, type EffectRect as A, type BevelContour as B, type CompositorLayer as C, DEFAULT_GLOBAL_LIGHT as D, type EffectFill as E, type GlowTechnique as F, type GroupBlendMode as G, type GradientColorStop as H, type Interpolation as I, type GradientOpacityStop as J, type GradientOverlayEffect as K, type LayerLocks as L, type GradientStyle as M, INTERPOLATIONS as N, type InnerGlowEffect as O, type InnerShadowEffect as P, LAYER_EFFECT_KINDS as Q, type RasterLayer as R, LayerEffectError as S, MAX_EFFECT_REACH as T, MAX_TRANSFORM_PIXELS as U, type OuterGlowEffect as V, type PatternOverlayEffect as W, PatternPlacement as X, PatternTile as Y, type ResampleOptions as Z, type SatinEffect as _, type RasterGroupLayer as a, type StrokePosition as a0, TransformTooLargeError as a1, blendTile as a2, builtinPattern as a3, builtinPatternIds as a4, changedTiles as a5, compositeSurfaceOver as a6, defaultEffectGradient as a7, defaultLayerEffect as a8, effectColorHex as a9, validateLayerEffect as aA, validateLayerEffects as aB, warpSurface as aC, type CompositorProfile as aD, type EffectCompositeInput as aE, type EffectMaps as aF, type GroupIn as aG, type PixelFilterSpec as aH, type RasterNode as aI, STROKE_CHAMFER_MAX as aJ, activeEffectItems as aK, buildEffectMaps as aL, compositeLayerEffects as aM, contourLut as aN, effectFillColors as aO, effectsAreLocal as aP, gradientT as aQ, patchEffectMaps as aR, effectReach as aa, effectsFingerprint as ab, effectsMargin as ac, effectsScale as ad, findLayer as ae, flattenLayers as af, hasActiveEffects as ag, hashNoise as ah, insertLayer as ai, isInterpolation as aj, isLayerEffectKind as ak, isLayerLocked as al, keysWeight as am, layerEffectFields as an, layerEffectLabel as ao, mapLayer as ap, mergeLayerEffect as aq, newEffectId as ar, normalizeLayerEffects as as, parseEffectColor as at, reduceSurface as au, renderLayerEffects as av, scaleLayerEffect as aw, transformSurface as ax, transformedBounds as ay, validateEffectGradient as az, type RasterPixelLayer as b, RasterCompositor as c, type RasterSources as d, type RasterLayerBase as e, type RasterMask as f, type GlobalLight as g, type EffectPattern as h, type LayerLocation as i, type LayerEffect as j, type LayerEffects as k, type CompositorOptions as l, type LayerEffectKind as m, type EffectContext as n, type BevelEmbossEffect as o, type BevelStyle as p, type BevelTechnique as q, type BevelTexture as r, type ColorOverlayEffect as s, type CompositeCallOptions as t, type CompositeStats as u, type ContourPoint as v, type DropShadowEffect as w, type EffectContour as x, type EffectGradient as y, type EffectPatternRef as z };
+export { type PixelFilterSpec as $, type GradientOverlayEffect as A, BIT_DEPTHS as B, type CompositorLayer as C, DEFAULT_GLOBAL_LIGHT as D, type EffectCompositeInput as E, type GradientStyle as F, type GlobalLight as G, type GroupBlendMode as H, type GroupIn as I, INTERPOLATIONS as J, type InnerGlowEffect as K, type InnerShadowEffect as L, type Interpolation as M, LAYER_EFFECT_KINDS as N, type LayerEffect as O, LayerEffectError as P, type LayerEffectKind as Q, type RasterSources as R, type LayerEffects as S, type LayerLocation as T, type LayerLocks as U, MAX_EFFECT_REACH as V, MAX_TRANSFORM_PIXELS as W, type OuterGlowEffect as X, type PatternOverlayEffect as Y, PatternPlacement as Z, PatternTile as _, RasterCompositor as a, tileSamples16 as a$, type RasterGroupLayer as a0, type RasterLayer as a1, type RasterLayerBase as a2, type RasterMask as a3, type RasterNode as a4, type RasterPixelLayer as a5, type ResampleOptions as a6, STROKE_CHAMFER_MAX as a7, type SatinEffect as a8, type StrokeEffect as a9, gradientT as aA, hasActiveEffects as aB, hashNoise as aC, insertLayer as aD, isBitDepth as aE, isInterpolation as aF, isLayerEffectKind as aG, isLayerLocked as aH, keysWeight as aI, layerEffectFields as aJ, layerEffectLabel as aK, mapLayer as aL, mergeLayerEffect as aM, newEffectId as aN, normalizeLayerEffects as aO, parseEffectColor as aP, patchEffectMaps as aQ, proxyOf as aR, readDeepRegion as aS, reduceSurface as aT, renderLayerEffects as aU, scaleLayerEffect as aV, srgbDecode as aW, srgbEncode as aX, surfaceDepth as aY, surfaceFromDeepPixels as aZ, tileSamples as a_, type StrokePosition as aa, TransformTooLargeError as ab, activeEffectItems as ac, blendTile as ad, buildEffectMaps as ae, builtinPattern as af, builtinPatternIds as ag, changedTiles as ah, compositeLayerEffects as ai, compositeSurfaceOver as aj, contourLut as ak, convertSurfaceDepth as al, deepBytes as am, deepTile as an, defaultEffectGradient as ao, defaultLayerEffect as ap, depthOf as aq, effectColorHex as ar, effectFillColors as as, effectReach as at, effectsAreLocal as au, effectsFingerprint as av, effectsMargin as aw, effectsScale as ax, findLayer as ay, flattenLayers as az, type CompositorProfile as b, tileSamples32 as b0, to16From32 as b1, to16From8 as b2, to32From16 as b3, to32From8 as b4, to8From16 as b5, to8From32 as b6, transformSurface as b7, transformedBounds as b8, validateEffectGradient as b9, validateLayerEffect as ba, validateLayerEffects as bb, warpSurface as bc, writeDeepRegion as bd, type BevelContour as c, type BevelEmbossEffect as d, type BevelStyle as e, type BevelTechnique as f, type BevelTexture as g, type BitDepth as h, type ColorOverlayEffect as i, type CompositeCallOptions as j, type CompositeStats as k, type CompositorOptions as l, type ContourPoint as m, type DeepSamples as n, type DropShadowEffect as o, type EffectContext as p, type EffectContour as q, type EffectFill as r, type EffectGradient as s, type EffectMaps as t, type EffectPattern as u, type EffectPatternRef as v, type EffectRect as w, type GlowTechnique as x, type GradientColorStop as y, type GradientOpacityStop as z };

package/dist/{render-tjzKaik-.d.ts → render-CrmHOgpo.d.ts}

@@ -1,4 +1,4 @@
-import { B as BlendMode, R as RasterRect, a as TiledSurface, M as MaskSurface, b as PixelSurface, T as TileKey } from './surface-C8RRg_Bh.js';
+import { a as BlendMode, R as RasterRect, j as TiledSurface, M as MaskSurface, c as PixelSurface, i as TileKey, h as Tile } from './surface-Cn30xIV6.js';
 import { H as Homography, V as Vec2 } from './types-CwMPoRMU.js';
 
 /**
@@ -832,6 +832,91 @@ declare class RasterCompositor<L extends CompositorLayer = CompositorLayer, S ex
 /** Tiles that differ between two surfaces (by tile identity), as tile keys. */
 declare function changedTiles(a: TiledSurface, b: TiledSurface): TileKey[];
 
+/**
+ * High bit depth tiles: 16-bit and 32-bit float samples alongside the 8-bit tile data.
+ *
+ * A tile may carry `deep` samples next to its `data`:
+ *
+ * - `Uint16Array`: 16 bits per channel, 0..65535, the same sRGB encoding and straight alpha as
+ *   the 8-bit data (`data = round(deep / 257)`).
+ * - `Float32Array`: 32-bit float per channel in **linear light** (sRGB primaries), straight
+ *   alpha, as Photoshop's 32-bit mode; colour may exceed 1 (`data` is the clamped sRGB encoding).
+ *
+ * `data` is always the 8-bit rendering of `deep`, so every 8-bit consumer (the compositor, the
+ * viewport, brushes, filters, the paint editor) keeps working unchanged and at full speed: it
+ * simply sees the 8-bit picture. A tile without `deep` holds 8-bit pixels; read at a higher depth
+ * (`tileSamples16` / `tileSamples32`) they are converted exactly as a bit-depth conversion would.
+ * Writers that only produce 8-bit data drop `deep` for the tiles they rewrite (those tiles become
+ * 8-bit precise), and writers that understand depth build tiles with `deepTile`.
+ *
+ * Masks (one channel) are coverage, not colour: their float samples are never linearised.
+ */
+
+/** Bits per channel: 8, 16 or 32 (float). */
+type BitDepth = 8 | 16 | 32;
+declare const BIT_DEPTHS: readonly BitDepth[];
+declare const isBitDepth: (v: unknown) => v is BitDepth;
+/** Deep samples of a tile: 16-bit encoded, or 32-bit linear float. */
+type DeepSamples = Uint16Array | Float32Array;
+/** sRGB-encoded 0..1 to linear light. */
+declare function srgbDecode(v: number): number;
+/** Linear light to sRGB-encoded (values above 1 extend the curve; below 0 clamp to 0). */
+declare function srgbEncode(v: number): number;
+/** 8-bit samples to 16-bit (`v × 257`, exact both ways). */
+declare function to16From8(data: ArrayLike<number>, out?: Uint16Array<ArrayBuffer>): Uint16Array;
+/** 8-bit samples to 32-bit float (colour linearised; alpha and masks as is). */
+declare function to32From8(data: ArrayLike<number>, channels: 1 | 4, out?: Float32Array<ArrayBuffer>): Float32Array;
+/** 16-bit samples to 32-bit float. */
+declare function to32From16(data: ArrayLike<number>, channels: 1 | 4, out?: Float32Array<ArrayBuffer>): Float32Array;
+/** 32-bit float samples to 16-bit (colour encoded and clamped to 0..1). */
+declare function to16From32(data: ArrayLike<number>, channels: 1 | 4, out?: Uint16Array<ArrayBuffer>): Uint16Array;
+/** 16-bit samples to 8-bit (rounded). */
+declare function to8From16(data: ArrayLike<number>, out?: Uint8ClampedArray<ArrayBuffer>): Uint8ClampedArray;
+/** 32-bit float samples to 8-bit (colour encoded and clamped). */
+declare function to8From32(data: ArrayLike<number>, channels: 1 | 4, out?: Uint8ClampedArray<ArrayBuffer>): Uint8ClampedArray;
+/** The 8-bit rendering of deep samples. */
+declare function proxyOf(deep: DeepSamples, channels: 1 | 4, out?: Uint8ClampedArray<ArrayBuffer>): Uint8ClampedArray;
+/** The bit depth deep samples hold. */
+declare const depthOf: (deep: DeepSamples) => 16 | 32;
+/**
+ * A stored tile from deep samples (`TILE × TILE × channels`): `null` when it renders as the
+ * surface default and holds nothing finer, an 8-bit tile when 8 bits hold it exactly (16-bit
+ * samples that are multiples of 257), else a tile with `deep` and its 8-bit rendering.
+ */
+declare function deepTile(deep: DeepSamples, channels: 1 | 4, defaultValue?: number): Tile | null;
+/** 16-bit samples of a tile (`undefined`: the default tile), converting 8-bit or float data. */
+declare function tileSamples16(tile: Tile | undefined, channels: 1 | 4, defaultValue?: number): Uint16Array;
+/** 32-bit float samples of a tile (`undefined`: the default tile), converting 8- or 16-bit data. */
+declare function tileSamples32(tile: Tile | undefined, channels: 1 | 4, defaultValue?: number): Float32Array;
+/** Deep samples of a tile at `depth` (16 or 32). */
+declare function tileSamples(tile: Tile | undefined, channels: 1 | 4, depth: 16 | 32, defaultValue?: number): DeepSamples;
+/** The deepest samples any tile of a surface holds: 8, 16 or 32. */
+declare function surfaceDepth(surface: TiledSurface): BitDepth;
+/** Copies `rect` of a surface at `depth` into a new buffer (`rect.width × rect.height × channels`). */
+declare function readDeepRegion(surface: TiledSurface, rect: RasterRect, depth: 16): Uint16Array;
+declare function readDeepRegion(surface: TiledSurface, rect: RasterRect, depth: 32): Float32Array;
+declare function readDeepRegion(surface: TiledSurface, rect: RasterRect, depth: 16 | 32): DeepSamples;
+/**
+ * Writes `rect.width × rect.height` interleaved deep samples at `rect` and returns the new
+ * surface. Partly covered tiles keep their other pixels, converted to the samples' depth.
+ */
+declare function writeDeepRegion(surface: TiledSurface, rect: RasterRect, samples: DeepSamples): TiledSurface;
+/** A surface holding `width × height` deep samples placed at (`x`, `y`). */
+declare function surfaceFromDeepPixels(pixels: {
+    width: number;
+    height: number;
+    data: DeepSamples;
+}, channels?: 1 | 4, x?: number, y?: number, defaultValue?: number): TiledSurface;
+/**
+ * The surface converted to `depth`: 8 drops every tile's deep samples (keeping their 8-bit
+ * rendering); 16 or 32 converts the deep samples tiles already hold. Tiles without deep samples
+ * are left alone (they read at any depth by conversion), so going up from 8 bits costs nothing.
+ * Returns the same surface when nothing changes.
+ */
+declare function convertSurfaceDepth(surface: TiledSurface, depth: BitDepth): TiledSurface;
+/** Bytes held by deep samples (in addition to `surfaceBytes`). */
+declare function deepBytes(surface: TiledSurface): number;
+
 /**
  * CPU renderer for layer effects.
  *
@@ -966,4 +1051,4 @@ declare function renderLayerEffects(effects: LayerEffects, layer: {
     fillOpacity?: number;
 }, backdrop: Uint8ClampedArray, canvas: EffectRect, ctx: EffectContext): void;
 
-export { type StrokeEffect as $, type EffectRect as A, type BevelContour as B, type CompositorLayer as C, DEFAULT_GLOBAL_LIGHT as D, type EffectFill as E, type GlowTechnique as F, type GroupBlendMode as G, type GradientColorStop as H, type Interpolation as I, type GradientOpacityStop as J, type GradientOverlayEffect as K, type LayerLocks as L, type GradientStyle as M, INTERPOLATIONS as N, type InnerGlowEffect as O, type InnerShadowEffect as P, LAYER_EFFECT_KINDS as Q, type RasterLayer as R, LayerEffectError as S, MAX_EFFECT_REACH as T, MAX_TRANSFORM_PIXELS as U, type OuterGlowEffect as V, type PatternOverlayEffect as W, PatternPlacement as X, PatternTile as Y, type ResampleOptions as Z, type SatinEffect as _, type RasterGroupLayer as a, type StrokePosition as a0, TransformTooLargeError as a1, blendTile as a2, builtinPattern as a3, builtinPatternIds as a4, changedTiles as a5, compositeSurfaceOver as a6, defaultEffectGradient as a7, defaultLayerEffect as a8, effectColorHex as a9, validateLayerEffect as aA, validateLayerEffects as aB, warpSurface as aC, type CompositorProfile as aD, type EffectCompositeInput as aE, type EffectMaps as aF, type GroupIn as aG, type PixelFilterSpec as aH, type RasterNode as aI, STROKE_CHAMFER_MAX as aJ, activeEffectItems as aK, buildEffectMaps as aL, compositeLayerEffects as aM, contourLut as aN, effectFillColors as aO, effectsAreLocal as aP, gradientT as aQ, patchEffectMaps as aR, effectReach as aa, effectsFingerprint as ab, effectsMargin as ac, effectsScale as ad, findLayer as ae, flattenLayers as af, hasActiveEffects as ag, hashNoise as ah, insertLayer as ai, isInterpolation as aj, isLayerEffectKind as ak, isLayerLocked as al, keysWeight as am, layerEffectFields as an, layerEffectLabel as ao, mapLayer as ap, mergeLayerEffect as aq, newEffectId as ar, normalizeLayerEffects as as, parseEffectColor as at, reduceSurface as au, renderLayerEffects as av, scaleLayerEffect as aw, transformSurface as ax, transformedBounds as ay, validateEffectGradient as az, type RasterPixelLayer as b, RasterCompositor as c, type RasterSources as d, type RasterLayerBase as e, type RasterMask as f, type GlobalLight as g, type EffectPattern as h, type LayerLocation as i, type LayerEffect as j, type LayerEffects as k, type CompositorOptions as l, type LayerEffectKind as m, type EffectContext as n, type BevelEmbossEffect as o, type BevelStyle as p, type BevelTechnique as q, type BevelTexture as r, type ColorOverlayEffect as s, type CompositeCallOptions as t, type CompositeStats as u, type ContourPoint as v, type DropShadowEffect as w, type EffectContour as x, type EffectGradient as y, type EffectPatternRef as z };
+export { type PixelFilterSpec as $, type GradientOverlayEffect as A, BIT_DEPTHS as B, type CompositorLayer as C, DEFAULT_GLOBAL_LIGHT as D, type EffectCompositeInput as E, type GradientStyle as F, type GlobalLight as G, type GroupBlendMode as H, type GroupIn as I, INTERPOLATIONS as J, type InnerGlowEffect as K, type InnerShadowEffect as L, type Interpolation as M, LAYER_EFFECT_KINDS as N, type LayerEffect as O, LayerEffectError as P, type LayerEffectKind as Q, type RasterSources as R, type LayerEffects as S, type LayerLocation as T, type LayerLocks as U, MAX_EFFECT_REACH as V, MAX_TRANSFORM_PIXELS as W, type OuterGlowEffect as X, type PatternOverlayEffect as Y, PatternPlacement as Z, PatternTile as _, RasterCompositor as a, tileSamples16 as a$, type RasterGroupLayer as a0, type RasterLayer as a1, type RasterLayerBase as a2, type RasterMask as a3, type RasterNode as a4, type RasterPixelLayer as a5, type ResampleOptions as a6, STROKE_CHAMFER_MAX as a7, type SatinEffect as a8, type StrokeEffect as a9, gradientT as aA, hasActiveEffects as aB, hashNoise as aC, insertLayer as aD, isBitDepth as aE, isInterpolation as aF, isLayerEffectKind as aG, isLayerLocked as aH, keysWeight as aI, layerEffectFields as aJ, layerEffectLabel as aK, mapLayer as aL, mergeLayerEffect as aM, newEffectId as aN, normalizeLayerEffects as aO, parseEffectColor as aP, patchEffectMaps as aQ, proxyOf as aR, readDeepRegion as aS, reduceSurface as aT, renderLayerEffects as aU, scaleLayerEffect as aV, srgbDecode as aW, srgbEncode as aX, surfaceDepth as aY, surfaceFromDeepPixels as aZ, tileSamples as a_, type StrokePosition as aa, TransformTooLargeError as ab, activeEffectItems as ac, blendTile as ad, buildEffectMaps as ae, builtinPattern as af, builtinPatternIds as ag, changedTiles as ah, compositeLayerEffects as ai, compositeSurfaceOver as aj, contourLut as ak, convertSurfaceDepth as al, deepBytes as am, deepTile as an, defaultEffectGradient as ao, defaultLayerEffect as ap, depthOf as aq, effectColorHex as ar, effectFillColors as as, effectReach as at, effectsAreLocal as au, effectsFingerprint as av, effectsMargin as aw, effectsScale as ax, findLayer as ay, flattenLayers as az, type CompositorProfile as b, tileSamples32 as b0, to16From32 as b1, to16From8 as b2, to32From16 as b3, to32From8 as b4, to8From16 as b5, to8From32 as b6, transformSurface as b7, transformedBounds as b8, validateEffectGradient as b9, validateLayerEffect as ba, validateLayerEffects as bb, warpSurface as bc, writeDeepRegion as bd, type BevelContour as c, type BevelEmbossEffect as d, type BevelStyle as e, type BevelTechnique as f, type BevelTexture as g, type BitDepth as h, type ColorOverlayEffect as i, type CompositeCallOptions as j, type CompositeStats as k, type CompositorOptions as l, type ContourPoint as m, type DeepSamples as n, type DropShadowEffect as o, type EffectContext as p, type EffectContour as q, type EffectFill as r, type EffectGradient as s, type EffectMaps as t, type EffectPattern as u, type EffectPatternRef as v, type EffectRect as w, type GlowTechnique as x, type GradientColorStop as y, type GradientOpacityStop as z };

package/dist/{retouch-CEIKR22W.d.cts → retouch-Bxkuc0KH.d.cts}

@@ -1,4 +1,4 @@
-import { B as BlendMode, R as RasterRect, T as TileKey, P as Pigment } from './surface-C8RRg_Bh.cjs';
+import { a as BlendMode, R as RasterRect, i as TileKey, Y as Pigment } from './surface-Cn30xIV6.cjs';
 
 /**
  * The brush engine (a subset of photocraft's `crates/paint`): a computed round tip with size,

package/dist/{retouch-BXmeSCaB.d.ts → retouch-Do6tBs2H.d.ts}

@@ -1,4 +1,4 @@
-import { B as BlendMode, R as RasterRect, T as TileKey, P as Pigment } from './surface-C8RRg_Bh.js';
+import { a as BlendMode, R as RasterRect, i as TileKey, Y as Pigment } from './surface-Cn30xIV6.js';
 
 /**
  * The brush engine (a subset of photocraft's `crates/paint`): a computed round tip with size,

package/dist/{surface-C8RRg_Bh.d.cts → surface-Cn30xIV6.d.cts}

@@ -223,6 +223,11 @@ interface Tile {
     readonly data: Uint8ClampedArray;
     /** The packed value of every pixel when the tile is uniform, else `null`. */
     readonly uniform: number | null;
+    /**
+     * High bit depth samples (see `./deep`): 16-bit sRGB-encoded or 32-bit linear float, of which
+     * `data` is the 8-bit rendering. Missing: the tile is 8-bit.
+     */
+    readonly deep?: Uint16Array | Float32Array;
 }
 /**
  * An immutable tiled surface. `channels` is 4 (RGBA) for layers and 1 for masks. Missing tiles
@@ -316,4 +321,4 @@ declare function collectTiles(surface: TiledSurface, into: Set<Tile>): void;
 /** True when two surfaces hold the same pixels (cheap when they share tiles). */
 declare function surfacesEqual(a: TiledSurface, b: TiledSurface): boolean;
 
-export { solidSurface as $, collectTiles as A, type BlendMode as B, contentBounds as C, createPigment as D, emptySurface as E, fillRect as F, finishTile as G, isSeparableBlendMode as H, lerpPigment as I, lerpPigmentInto as J, mixPigment8 as K, mixPigmentRgb as L, type MaskSurface as M, mixPigments as N, normalizeBlendMode as O, type Pigment as P, packRgba as Q, type RasterRect as R, SHADOW_AMBIENT as S, type TileKey as T, pigment8 as U, readPixel as V, readRegion as W, reflectanceToRgb as X, rgbToReflectance as Y, setLum as Z, setPigmentColor as _, TiledSurface as a, surfaceBytes as a0, surfaceFromPixels as a1, surfacesEqual as a2, tileCoord as a3, tileKey as a4, tileRect as a5, tilesInRect as a6, translateSurface as a7, uniformTile as a8, writeRegion as a9, type PixelSurface as b, type BlendModeInfo as c, BLEND_MODES as d, PAINTERLY_BLEND_MODES as e, type Tile as f, isPainterlyBlendMode as g, PIGMENT_BANDS as h, isBlendMode as i, PIGMENT_LAMBDA_MIN as j, PIGMENT_LAMBDA_STEP as k, PIGMENT_WAVELENGTHS as l, type PigmentOptions as m, type PigmentRgb as n, type Rgb as o, type Rgba as p, SurfaceDraft as q, TILE as r, standardBlendMode as s, TILE_SHIFT as t, blendChannel as u, blendImageData as v, blendLum as w, blendPixel as x, blendRgb as y, canvasCompositeOperation as z };
+export { PIGMENT_LAMBDA_STEP as $, normalizeBlendMode as A, BLEND_MODES as B, packRgba as C, pigment8 as D, readPixel as E, readRegion as F, setLum as G, solidSurface as H, standardBlendMode as I, surfaceBytes as J, surfaceFromPixels as K, surfacesEqual as L, type MaskSurface as M, tileCoord as N, tileKey as O, PAINTERLY_BLEND_MODES as P, tileRect as Q, type RasterRect as R, SHADOW_AMBIENT as S, TILE as T, tilesInRect as U, translateSurface as V, uniformTile as W, writeRegion as X, type Pigment as Y, PIGMENT_BANDS as Z, PIGMENT_LAMBDA_MIN as _, type BlendMode as a, PIGMENT_WAVELENGTHS as a0, type PigmentOptions as a1, type PigmentRgb as a2, createPigment as a3, lerpPigment as a4, lerpPigmentInto as a5, mixPigments as a6, reflectanceToRgb as a7, rgbToReflectance as a8, setPigmentColor as a9, type BlendModeInfo as b, type PixelSurface as c, type Rgb as d, type Rgba as e, SurfaceDraft as f, TILE_SHIFT as g, type Tile as h, type TileKey as i, TiledSurface as j, blendChannel as k, blendImageData as l, blendLum as m, blendPixel as n, blendRgb as o, canvasCompositeOperation as p, collectTiles as q, contentBounds as r, emptySurface as s, fillRect as t, finishTile as u, isBlendMode as v, isPainterlyBlendMode as w, isSeparableBlendMode as x, mixPigment8 as y, mixPigmentRgb as z };

package/dist/{surface-C8RRg_Bh.d.ts → surface-Cn30xIV6.d.ts}

@@ -223,6 +223,11 @@ interface Tile {
     readonly data: Uint8ClampedArray;
     /** The packed value of every pixel when the tile is uniform, else `null`. */
     readonly uniform: number | null;
+    /**
+     * High bit depth samples (see `./deep`): 16-bit sRGB-encoded or 32-bit linear float, of which
+     * `data` is the 8-bit rendering. Missing: the tile is 8-bit.
+     */
+    readonly deep?: Uint16Array | Float32Array;
 }
 /**
  * An immutable tiled surface. `channels` is 4 (RGBA) for layers and 1 for masks. Missing tiles
@@ -316,4 +321,4 @@ declare function collectTiles(surface: TiledSurface, into: Set<Tile>): void;
 /** True when two surfaces hold the same pixels (cheap when they share tiles). */
 declare function surfacesEqual(a: TiledSurface, b: TiledSurface): boolean;
 
-export { solidSurface as $, collectTiles as A, type BlendMode as B, contentBounds as C, createPigment as D, emptySurface as E, fillRect as F, finishTile as G, isSeparableBlendMode as H, lerpPigment as I, lerpPigmentInto as J, mixPigment8 as K, mixPigmentRgb as L, type MaskSurface as M, mixPigments as N, normalizeBlendMode as O, type Pigment as P, packRgba as Q, type RasterRect as R, SHADOW_AMBIENT as S, type TileKey as T, pigment8 as U, readPixel as V, readRegion as W, reflectanceToRgb as X, rgbToReflectance as Y, setLum as Z, setPigmentColor as _, TiledSurface as a, surfaceBytes as a0, surfaceFromPixels as a1, surfacesEqual as a2, tileCoord as a3, tileKey as a4, tileRect as a5, tilesInRect as a6, translateSurface as a7, uniformTile as a8, writeRegion as a9, type PixelSurface as b, type BlendModeInfo as c, BLEND_MODES as d, PAINTERLY_BLEND_MODES as e, type Tile as f, isPainterlyBlendMode as g, PIGMENT_BANDS as h, isBlendMode as i, PIGMENT_LAMBDA_MIN as j, PIGMENT_LAMBDA_STEP as k, PIGMENT_WAVELENGTHS as l, type PigmentOptions as m, type PigmentRgb as n, type Rgb as o, type Rgba as p, SurfaceDraft as q, TILE as r, standardBlendMode as s, TILE_SHIFT as t, blendChannel as u, blendImageData as v, blendLum as w, blendPixel as x, blendRgb as y, canvasCompositeOperation as z };
+export { PIGMENT_LAMBDA_STEP as $, normalizeBlendMode as A, BLEND_MODES as B, packRgba as C, pigment8 as D, readPixel as E, readRegion as F, setLum as G, solidSurface as H, standardBlendMode as I, surfaceBytes as J, surfaceFromPixels as K, surfacesEqual as L, type MaskSurface as M, tileCoord as N, tileKey as O, PAINTERLY_BLEND_MODES as P, tileRect as Q, type RasterRect as R, SHADOW_AMBIENT as S, TILE as T, tilesInRect as U, translateSurface as V, uniformTile as W, writeRegion as X, type Pigment as Y, PIGMENT_BANDS as Z, PIGMENT_LAMBDA_MIN as _, type BlendMode as a, PIGMENT_WAVELENGTHS as a0, type PigmentOptions as a1, type PigmentRgb as a2, createPigment as a3, lerpPigment as a4, lerpPigmentInto as a5, mixPigments as a6, reflectanceToRgb as a7, rgbToReflectance as a8, setPigmentColor as a9, type BlendModeInfo as b, type PixelSurface as c, type Rgb as d, type Rgba as e, SurfaceDraft as f, TILE_SHIFT as g, type Tile as h, type TileKey as i, TiledSurface as j, blendChannel as k, blendImageData as l, blendLum as m, blendPixel as n, blendRgb as o, canvasCompositeOperation as p, collectTiles as q, contentBounds as r, emptySurface as s, fillRect as t, finishTile as u, isBlendMode as v, isPainterlyBlendMode as w, isSeparableBlendMode as x, mixPigment8 as y, mixPigmentRgb as z };

package/dist/{svg-D_cfkhlB.d.cts → svg-BnRj0q8i.d.cts}

@@ -1,5 +1,5 @@
 import { B as BezierPath, A as AffineMatrix, S as SvgGradientDef } from './bezier-BfwIbVTl.cjs';
-import { V as VectorEffectType, a as VectorEffectParamsMap, b as VectorPathNode, c as VectorFillRule, d as VectorBooleanOperation, e as VectorNode, f as VectorEffect, g as VectorGroupNode, h as VectorBounds, i as VectorWarpMesh, j as VectorFilterType, k as VectorFilterParamsMap, l as VectorFilter, m as VectorGradient, n as Vec2, o as VectorGradientUnits, p as VectorGradientSpread, q as VectorGradientType, r as VectorPaint, s as VectorMatrix, t as VectorGradientStop, u as VectorStrokeAlign, v as VectorSubpath, w as VectorDocument, x as VectorWidthPoint } from './types-DyQq-WPY.cjs';
+import { V as VectorEffectType, a as VectorEffectParamsMap, b as VectorPathNode, c as VectorFillRule, d as VectorBooleanOperation, e as VectorNode, f as VectorEffect, g as VectorGroupNode, h as VectorBounds, i as VectorWarpMesh, j as VectorInstanceNode, k as VectorFilterType, l as VectorFilterParamsMap, m as VectorFilter, n as VectorGradient, o as Vec2, p as VectorGradientUnits, q as VectorGradientSpread, r as VectorGradientType, s as VectorPaint, t as VectorMatrix, u as VectorGradientStop, v as VectorStrokeAlign, w as VectorSubpath, x as VectorDocument, y as VectorWidthPoint } from './types-yINF17Ta.cjs';
 
 /**
  * Live appearance: path effect stacks and live boolean groups, evaluated on demand while the
@@ -99,7 +99,10 @@ declare function createVectorEffect<K extends VectorEffectType>(type: K, id: str
 }> | null;
 /** The node's effects that take part (enabled, of a known type). */
 declare function activeVectorEffects(node: VectorNode): VectorEffect[];
-/** Whether the node itself draws differently from its stored geometry (effects or a live boolean). */
+/**
+ * Whether the node itself draws differently from its stored geometry (effects or a live boolean).
+ * Text always does: it draws as its glyphs.
+ */
 declare function hasOwnVectorAppearance(node: VectorNode): boolean;
 /** Whether the node or anything inside it has a live appearance. */
 declare function hasVectorAppearance(node: VectorNode): boolean;
@@ -126,6 +129,8 @@ interface VectorBooleanOperand {
 declare function foldVectorBooleanOperands(operands: readonly VectorBooleanOperand[]): BezierPath;
 /** Applies an effect stack to shapes, top to bottom (disabled effects skipped). */
 declare function applyVectorEffects(shapes: readonly VectorAppearanceShape[], effects: readonly VectorEffect[] | null | undefined): VectorAppearanceShape[];
+/** What an instance draws as a plain group (cached per instance object; see `vectorInstanceGroup`). */
+declare function vectorInstanceDrawn(node: VectorInstanceNode): VectorGroupNode;
 /** The shapes of a child in its parent's space (hidden children have none), ordered by its index. */
 declare function vectorChildAppearanceShapes(child: VectorNode, index: number): VectorAppearanceShape[];
 /** The paths entering effect `effectId` of the node's stack (those above it applied), in the node's own space. */
@@ -161,7 +166,7 @@ declare function vectorAppearanceNodes(node: VectorNode): VectorPathNode[];
  * otherwise, like any live group, it becomes a group with that id holding one path per shape
  * (ids `<id>~fx<n>`). Groups without effects of their own keep their structure. Cached per node.
  */
-declare function expandVectorAppearance(node: VectorNode): VectorNode;
+declare function expandVectorAppearance(node: VectorNode): VectorPathNode | VectorGroupNode;
 /** Every node of a list expanded (the same array when nothing in it is live). */
 declare function expandVectorAppearances(nodes: readonly VectorNode[]): VectorNode[];
 /**
@@ -559,6 +564,13 @@ interface VectorSvgExportOptions {
      * or clip it (the animation editor's reveals and its Flair export use this).
      */
     wrap?: Readonly<Record<string, readonly VectorSvgWrapper[]>>;
+    /**
+     * How text is written: `text` (default) as SVG `<text>` placed character by character, or
+     * `outlines` as its glyph outlines (needs an outline shaper; otherwise text stays text). Text with
+     * path effects is always written as outlines when it has them. Either way the text is kept for
+     * import.
+     */
+    text?: 'text' | 'outlines';
 }
 /** A group written round a node (see `VectorSvgExportOptions.wrap`). */
 interface VectorSvgWrapper {
@@ -653,4 +665,4 @@ declare function parseSvgTransform(value: string | undefined): AffineMatrix;
 /** Parses SVG markup into a vector document. Throws when there is no `<svg>` element. */
 declare function parseVectorSvg(svg: string, options?: VectorSvgImportOptions): VectorDocument;
 
-export { isVectorGradient as $, type VectorSvgPatternDef as A, type VectorSvgWrapper as B, activeVectorEffects as C, activeVectorFilters as D, applyVectorCornersAttribute as E, applyVectorEffects as F, applyVectorGradientPatch as G, applyVectorGradientSpread as H, clearVectorLiveBooleanCache as I, convertVectorGradient as J, createVectorEffect as K, createVectorFilter as L, defaultVectorGradient as M, expandVectorAppearance as N, expandVectorAppearances as O, expandVectorGradientSpread as P, expandVectorGradientStops as Q, explicitVectorGradient as R, foldVectorBooleanOperands as S, gradientMidpointRemap as T, hasExplicitGradientGeometry as U, type VectorSvgExportOptions as V, hasOwnVectorAppearance as W, hasVectorAppearance as X, insertVectorGradientStop as Y, isCentredVectorGradient as Z, isVectorFilterType as _, type VectorGradientHandle as a, vectorOperandOperation as a$, isVectorLiveBoolean as a0, mapVectorGradient as a1, mapVectorPaint as a2, moveVectorGradientHandle as a3, moveVectorGradientStop as a4, normalizeVectorEffectParams as a5, normalizeVectorFilterParams as a6, parseSvgTransform as a7, parseVectorColor as a8, parseVectorSvg as a9, vectorEffectInputPaths as aA, vectorEnteredGroups as aB, vectorEnvelopeFrame as aC, vectorEnvelopeMap as aD, vectorEnvelopeMesh as aE, vectorFilterMarkup as aF, vectorFilterParamKeys as aG, vectorFilterReach as aH, vectorFilterSvg as aI, vectorGradientArea as aJ, vectorGradientAspect as aK, vectorGradientFocalParam as aL, vectorGradientHandles as aM, vectorGradientMatrix as aN, vectorGradientMidpointFromPosition as aO, vectorGradientMidpointPosition as aP, vectorGradientNeedsExpansion as aQ, vectorGradientParam as aR, vectorGradientPoints as aS, vectorGradientRamp as aT, vectorGradientSvgDefs as aU, vectorGradientTAt as aV, vectorGradientUnitsMatrix as aW, vectorLiveBooleanSteps as aX, vectorNodeEnvelope as aY, vectorNodeFilterSvg as aZ, vectorNodeLocalPaintBounds as a_, patternAttrs as aa, periodicVectorGradientStops as ab, pinVectorGradient as ac, removeVectorGradientStop as ad, reverseVectorGradient as ae, samplePlainStops as af, sampleVectorGradient as ag, sampleVectorGradientAt as ah, sampleVectorPaintDefAt as ai, sanitizeVectorEffects as aj, sanitizeVectorFilters as ak, sanitizeVectorGradient as al, setVectorGradientVector as am, sortedVectorGradientStops as an, spanVectorGradientStops as ao, transformVectorEffects as ap, transformVectorGradient as aq, transformVectorPaint as ar, vectorAppearanceNodes as as, vectorAppearanceOutline as at, vectorAppearanceShapes as au, vectorBoxMatrix as av, vectorChildAppearanceShapes as aw, vectorCornersAttribute as ax, vectorDocumentToSvg as ay, vectorEffectInputBounds as az, type VectorGradientPatch as b, vectorPaintToSvg as b0, vectorPathLocalBounds as b1, vectorStrokeSvgParts as b2, widthProfileFromAttribute as b3, widthProfileToAttribute as b4, type VectorEnvelopeParams as c, type VectorRenderFilter as d, type VectorAppearanceShape as e, type VectorFilterParamSpec as f, type VectorEffectParamSpec as g, type VectorRenderStrokeParts as h, type VectorPaintDef as i, VECTOR_EFFECT_DEFAULTS as j, VECTOR_EFFECT_LABELS as k, VECTOR_EFFECT_PARAM_SPECS as l, VECTOR_FILTER_DEFAULTS as m, VECTOR_FILTER_LABELS as n, VECTOR_FILTER_MENU as o, VECTOR_FILTER_PARAM_SPECS as p, VECTOR_GRADIENT_MAX_PERIODS as q, VECTOR_GRADIENT_MIN_STOPS as r, type VectorBooleanOperand as s, type VectorFilterPrimitive as t, type VectorGradientPoints as u, type VectorGradientRamp as v, type VectorGradientSvgOptions as w, type VectorPaintSvgOptions as x, type VectorRgba as y, type VectorSvgImportOptions as z };
+export { isVectorGradient as $, type VectorSvgPatternDef as A, type VectorSvgWrapper as B, activeVectorEffects as C, activeVectorFilters as D, applyVectorCornersAttribute as E, applyVectorEffects as F, applyVectorGradientPatch as G, applyVectorGradientSpread as H, clearVectorLiveBooleanCache as I, convertVectorGradient as J, createVectorEffect as K, createVectorFilter as L, defaultVectorGradient as M, expandVectorAppearance as N, expandVectorAppearances as O, expandVectorGradientSpread as P, expandVectorGradientStops as Q, explicitVectorGradient as R, foldVectorBooleanOperands as S, gradientMidpointRemap as T, hasExplicitGradientGeometry as U, type VectorSvgExportOptions as V, hasOwnVectorAppearance as W, hasVectorAppearance as X, insertVectorGradientStop as Y, isCentredVectorGradient as Z, isVectorFilterType as _, type VectorGradientHandle as a, vectorNodeLocalPaintBounds as a$, isVectorLiveBoolean as a0, mapVectorGradient as a1, mapVectorPaint as a2, moveVectorGradientHandle as a3, moveVectorGradientStop as a4, normalizeVectorEffectParams as a5, normalizeVectorFilterParams as a6, parseSvgTransform as a7, parseVectorColor as a8, parseVectorSvg as a9, vectorEffectInputPaths as aA, vectorEnteredGroups as aB, vectorEnvelopeFrame as aC, vectorEnvelopeMap as aD, vectorEnvelopeMesh as aE, vectorFilterMarkup as aF, vectorFilterParamKeys as aG, vectorFilterReach as aH, vectorFilterSvg as aI, vectorGradientArea as aJ, vectorGradientAspect as aK, vectorGradientFocalParam as aL, vectorGradientHandles as aM, vectorGradientMatrix as aN, vectorGradientMidpointFromPosition as aO, vectorGradientMidpointPosition as aP, vectorGradientNeedsExpansion as aQ, vectorGradientParam as aR, vectorGradientPoints as aS, vectorGradientRamp as aT, vectorGradientSvgDefs as aU, vectorGradientTAt as aV, vectorGradientUnitsMatrix as aW, vectorInstanceDrawn as aX, vectorLiveBooleanSteps as aY, vectorNodeEnvelope as aZ, vectorNodeFilterSvg as a_, patternAttrs as aa, periodicVectorGradientStops as ab, pinVectorGradient as ac, removeVectorGradientStop as ad, reverseVectorGradient as ae, samplePlainStops as af, sampleVectorGradient as ag, sampleVectorGradientAt as ah, sampleVectorPaintDefAt as ai, sanitizeVectorEffects as aj, sanitizeVectorFilters as ak, sanitizeVectorGradient as al, setVectorGradientVector as am, sortedVectorGradientStops as an, spanVectorGradientStops as ao, transformVectorEffects as ap, transformVectorGradient as aq, transformVectorPaint as ar, vectorAppearanceNodes as as, vectorAppearanceOutline as at, vectorAppearanceShapes as au, vectorBoxMatrix as av, vectorChildAppearanceShapes as aw, vectorCornersAttribute as ax, vectorDocumentToSvg as ay, vectorEffectInputBounds as az, type VectorGradientPatch as b, vectorOperandOperation as b0, vectorPaintToSvg as b1, vectorPathLocalBounds as b2, vectorStrokeSvgParts as b3, widthProfileFromAttribute as b4, widthProfileToAttribute as b5, type VectorEnvelopeParams as c, type VectorRenderFilter as d, type VectorAppearanceShape as e, type VectorFilterParamSpec as f, type VectorEffectParamSpec as g, type VectorRenderStrokeParts as h, type VectorPaintDef as i, VECTOR_EFFECT_DEFAULTS as j, VECTOR_EFFECT_LABELS as k, VECTOR_EFFECT_PARAM_SPECS as l, VECTOR_FILTER_DEFAULTS as m, VECTOR_FILTER_LABELS as n, VECTOR_FILTER_MENU as o, VECTOR_FILTER_PARAM_SPECS as p, VECTOR_GRADIENT_MAX_PERIODS as q, VECTOR_GRADIENT_MIN_STOPS as r, type VectorBooleanOperand as s, type VectorFilterPrimitive as t, type VectorGradientPoints as u, type VectorGradientRamp as v, type VectorGradientSvgOptions as w, type VectorPaintSvgOptions as x, type VectorRgba as y, type VectorSvgImportOptions as z };

package/dist/{svg-wIaKLrU0.d.ts → svg-CmmBFfGT.d.ts}

@@ -1,5 +1,5 @@
 import { B as BezierPath, A as AffineMatrix, S as SvgGradientDef } from './bezier-DYBvLgUH.js';
-import { V as VectorEffectType, a as VectorEffectParamsMap, b as VectorPathNode, c as VectorFillRule, d as VectorBooleanOperation, e as VectorNode, f as VectorEffect, g as VectorGroupNode, h as VectorBounds, i as VectorWarpMesh, j as VectorFilterType, k as VectorFilterParamsMap, l as VectorFilter, m as VectorGradient, n as Vec2, o as VectorGradientUnits, p as VectorGradientSpread, q as VectorGradientType, r as VectorPaint, s as VectorMatrix, t as VectorGradientStop, u as VectorStrokeAlign, v as VectorSubpath, w as VectorDocument, x as VectorWidthPoint } from './types-DtL_qLFz.js';
+import { V as VectorEffectType, a as VectorEffectParamsMap, b as VectorPathNode, c as VectorFillRule, d as VectorBooleanOperation, e as VectorNode, f as VectorEffect, g as VectorGroupNode, h as VectorBounds, i as VectorWarpMesh, j as VectorInstanceNode, k as VectorFilterType, l as VectorFilterParamsMap, m as VectorFilter, n as VectorGradient, o as Vec2, p as VectorGradientUnits, q as VectorGradientSpread, r as VectorGradientType, s as VectorPaint, t as VectorMatrix, u as VectorGradientStop, v as VectorStrokeAlign, w as VectorSubpath, x as VectorDocument, y as VectorWidthPoint } from './types-1SUQKDAw.js';
 
 /**
  * Live appearance: path effect stacks and live boolean groups, evaluated on demand while the
@@ -99,7 +99,10 @@ declare function createVectorEffect<K extends VectorEffectType>(type: K, id: str
 }> | null;
 /** The node's effects that take part (enabled, of a known type). */
 declare function activeVectorEffects(node: VectorNode): VectorEffect[];
-/** Whether the node itself draws differently from its stored geometry (effects or a live boolean). */
+/**
+ * Whether the node itself draws differently from its stored geometry (effects or a live boolean).
+ * Text always does: it draws as its glyphs.
+ */
 declare function hasOwnVectorAppearance(node: VectorNode): boolean;
 /** Whether the node or anything inside it has a live appearance. */
 declare function hasVectorAppearance(node: VectorNode): boolean;
@@ -126,6 +129,8 @@ interface VectorBooleanOperand {
 declare function foldVectorBooleanOperands(operands: readonly VectorBooleanOperand[]): BezierPath;
 /** Applies an effect stack to shapes, top to bottom (disabled effects skipped). */
 declare function applyVectorEffects(shapes: readonly VectorAppearanceShape[], effects: readonly VectorEffect[] | null | undefined): VectorAppearanceShape[];
+/** What an instance draws as a plain group (cached per instance object; see `vectorInstanceGroup`). */
+declare function vectorInstanceDrawn(node: VectorInstanceNode): VectorGroupNode;
 /** The shapes of a child in its parent's space (hidden children have none), ordered by its index. */
 declare function vectorChildAppearanceShapes(child: VectorNode, index: number): VectorAppearanceShape[];
 /** The paths entering effect `effectId` of the node's stack (those above it applied), in the node's own space. */
@@ -161,7 +166,7 @@ declare function vectorAppearanceNodes(node: VectorNode): VectorPathNode[];
  * otherwise, like any live group, it becomes a group with that id holding one path per shape
  * (ids `<id>~fx<n>`). Groups without effects of their own keep their structure. Cached per node.
  */
-declare function expandVectorAppearance(node: VectorNode): VectorNode;
+declare function expandVectorAppearance(node: VectorNode): VectorPathNode | VectorGroupNode;
 /** Every node of a list expanded (the same array when nothing in it is live). */
 declare function expandVectorAppearances(nodes: readonly VectorNode[]): VectorNode[];
 /**
@@ -559,6 +564,13 @@ interface VectorSvgExportOptions {
      * or clip it (the animation editor's reveals and its Flair export use this).
      */
     wrap?: Readonly<Record<string, readonly VectorSvgWrapper[]>>;
+    /**
+     * How text is written: `text` (default) as SVG `<text>` placed character by character, or
+     * `outlines` as its glyph outlines (needs an outline shaper; otherwise text stays text). Text with
+     * path effects is always written as outlines when it has them. Either way the text is kept for
+     * import.
+     */
+    text?: 'text' | 'outlines';
 }
 /** A group written round a node (see `VectorSvgExportOptions.wrap`). */
 interface VectorSvgWrapper {
@@ -653,4 +665,4 @@ declare function parseSvgTransform(value: string | undefined): AffineMatrix;
 /** Parses SVG markup into a vector document. Throws when there is no `<svg>` element. */
 declare function parseVectorSvg(svg: string, options?: VectorSvgImportOptions): VectorDocument;
 
-export { isVectorGradient as $, type VectorSvgPatternDef as A, type VectorSvgWrapper as B, activeVectorEffects as C, activeVectorFilters as D, applyVectorCornersAttribute as E, applyVectorEffects as F, applyVectorGradientPatch as G, applyVectorGradientSpread as H, clearVectorLiveBooleanCache as I, convertVectorGradient as J, createVectorEffect as K, createVectorFilter as L, defaultVectorGradient as M, expandVectorAppearance as N, expandVectorAppearances as O, expandVectorGradientSpread as P, expandVectorGradientStops as Q, explicitVectorGradient as R, foldVectorBooleanOperands as S, gradientMidpointRemap as T, hasExplicitGradientGeometry as U, type VectorSvgExportOptions as V, hasOwnVectorAppearance as W, hasVectorAppearance as X, insertVectorGradientStop as Y, isCentredVectorGradient as Z, isVectorFilterType as _, type VectorGradientHandle as a, vectorOperandOperation as a$, isVectorLiveBoolean as a0, mapVectorGradient as a1, mapVectorPaint as a2, moveVectorGradientHandle as a3, moveVectorGradientStop as a4, normalizeVectorEffectParams as a5, normalizeVectorFilterParams as a6, parseSvgTransform as a7, parseVectorColor as a8, parseVectorSvg as a9, vectorEffectInputPaths as aA, vectorEnteredGroups as aB, vectorEnvelopeFrame as aC, vectorEnvelopeMap as aD, vectorEnvelopeMesh as aE, vectorFilterMarkup as aF, vectorFilterParamKeys as aG, vectorFilterReach as aH, vectorFilterSvg as aI, vectorGradientArea as aJ, vectorGradientAspect as aK, vectorGradientFocalParam as aL, vectorGradientHandles as aM, vectorGradientMatrix as aN, vectorGradientMidpointFromPosition as aO, vectorGradientMidpointPosition as aP, vectorGradientNeedsExpansion as aQ, vectorGradientParam as aR, vectorGradientPoints as aS, vectorGradientRamp as aT, vectorGradientSvgDefs as aU, vectorGradientTAt as aV, vectorGradientUnitsMatrix as aW, vectorLiveBooleanSteps as aX, vectorNodeEnvelope as aY, vectorNodeFilterSvg as aZ, vectorNodeLocalPaintBounds as a_, patternAttrs as aa, periodicVectorGradientStops as ab, pinVectorGradient as ac, removeVectorGradientStop as ad, reverseVectorGradient as ae, samplePlainStops as af, sampleVectorGradient as ag, sampleVectorGradientAt as ah, sampleVectorPaintDefAt as ai, sanitizeVectorEffects as aj, sanitizeVectorFilters as ak, sanitizeVectorGradient as al, setVectorGradientVector as am, sortedVectorGradientStops as an, spanVectorGradientStops as ao, transformVectorEffects as ap, transformVectorGradient as aq, transformVectorPaint as ar, vectorAppearanceNodes as as, vectorAppearanceOutline as at, vectorAppearanceShapes as au, vectorBoxMatrix as av, vectorChildAppearanceShapes as aw, vectorCornersAttribute as ax, vectorDocumentToSvg as ay, vectorEffectInputBounds as az, type VectorGradientPatch as b, vectorPaintToSvg as b0, vectorPathLocalBounds as b1, vectorStrokeSvgParts as b2, widthProfileFromAttribute as b3, widthProfileToAttribute as b4, type VectorEnvelopeParams as c, type VectorRenderFilter as d, type VectorAppearanceShape as e, type VectorFilterParamSpec as f, type VectorEffectParamSpec as g, type VectorRenderStrokeParts as h, type VectorPaintDef as i, VECTOR_EFFECT_DEFAULTS as j, VECTOR_EFFECT_LABELS as k, VECTOR_EFFECT_PARAM_SPECS as l, VECTOR_FILTER_DEFAULTS as m, VECTOR_FILTER_LABELS as n, VECTOR_FILTER_MENU as o, VECTOR_FILTER_PARAM_SPECS as p, VECTOR_GRADIENT_MAX_PERIODS as q, VECTOR_GRADIENT_MIN_STOPS as r, type VectorBooleanOperand as s, type VectorFilterPrimitive as t, type VectorGradientPoints as u, type VectorGradientRamp as v, type VectorGradientSvgOptions as w, type VectorPaintSvgOptions as x, type VectorRgba as y, type VectorSvgImportOptions as z };
+export { isVectorGradient as $, type VectorSvgPatternDef as A, type VectorSvgWrapper as B, activeVectorEffects as C, activeVectorFilters as D, applyVectorCornersAttribute as E, applyVectorEffects as F, applyVectorGradientPatch as G, applyVectorGradientSpread as H, clearVectorLiveBooleanCache as I, convertVectorGradient as J, createVectorEffect as K, createVectorFilter as L, defaultVectorGradient as M, expandVectorAppearance as N, expandVectorAppearances as O, expandVectorGradientSpread as P, expandVectorGradientStops as Q, explicitVectorGradient as R, foldVectorBooleanOperands as S, gradientMidpointRemap as T, hasExplicitGradientGeometry as U, type VectorSvgExportOptions as V, hasOwnVectorAppearance as W, hasVectorAppearance as X, insertVectorGradientStop as Y, isCentredVectorGradient as Z, isVectorFilterType as _, type VectorGradientHandle as a, vectorNodeLocalPaintBounds as a$, isVectorLiveBoolean as a0, mapVectorGradient as a1, mapVectorPaint as a2, moveVectorGradientHandle as a3, moveVectorGradientStop as a4, normalizeVectorEffectParams as a5, normalizeVectorFilterParams as a6, parseSvgTransform as a7, parseVectorColor as a8, parseVectorSvg as a9, vectorEffectInputPaths as aA, vectorEnteredGroups as aB, vectorEnvelopeFrame as aC, vectorEnvelopeMap as aD, vectorEnvelopeMesh as aE, vectorFilterMarkup as aF, vectorFilterParamKeys as aG, vectorFilterReach as aH, vectorFilterSvg as aI, vectorGradientArea as aJ, vectorGradientAspect as aK, vectorGradientFocalParam as aL, vectorGradientHandles as aM, vectorGradientMatrix as aN, vectorGradientMidpointFromPosition as aO, vectorGradientMidpointPosition as aP, vectorGradientNeedsExpansion as aQ, vectorGradientParam as aR, vectorGradientPoints as aS, vectorGradientRamp as aT, vectorGradientSvgDefs as aU, vectorGradientTAt as aV, vectorGradientUnitsMatrix as aW, vectorInstanceDrawn as aX, vectorLiveBooleanSteps as aY, vectorNodeEnvelope as aZ, vectorNodeFilterSvg as a_, patternAttrs as aa, periodicVectorGradientStops as ab, pinVectorGradient as ac, removeVectorGradientStop as ad, reverseVectorGradient as ae, samplePlainStops as af, sampleVectorGradient as ag, sampleVectorGradientAt as ah, sampleVectorPaintDefAt as ai, sanitizeVectorEffects as aj, sanitizeVectorFilters as ak, sanitizeVectorGradient as al, setVectorGradientVector as am, sortedVectorGradientStops as an, spanVectorGradientStops as ao, transformVectorEffects as ap, transformVectorGradient as aq, transformVectorPaint as ar, vectorAppearanceNodes as as, vectorAppearanceOutline as at, vectorAppearanceShapes as au, vectorBoxMatrix as av, vectorChildAppearanceShapes as aw, vectorCornersAttribute as ax, vectorDocumentToSvg as ay, vectorEffectInputBounds as az, type VectorGradientPatch as b, vectorOperandOperation as b0, vectorPaintToSvg as b1, vectorPathLocalBounds as b2, vectorStrokeSvgParts as b3, widthProfileFromAttribute as b4, widthProfileToAttribute as b5, type VectorEnvelopeParams as c, type VectorRenderFilter as d, type VectorAppearanceShape as e, type VectorFilterParamSpec as f, type VectorEffectParamSpec as g, type VectorRenderStrokeParts as h, type VectorPaintDef as i, VECTOR_EFFECT_DEFAULTS as j, VECTOR_EFFECT_LABELS as k, VECTOR_EFFECT_PARAM_SPECS as l, VECTOR_FILTER_DEFAULTS as m, VECTOR_FILTER_LABELS as n, VECTOR_FILTER_MENU as o, VECTOR_FILTER_PARAM_SPECS as p, VECTOR_GRADIENT_MAX_PERIODS as q, VECTOR_GRADIENT_MIN_STOPS as r, type VectorBooleanOperand as s, type VectorFilterPrimitive as t, type VectorGradientPoints as u, type VectorGradientRamp as v, type VectorGradientSvgOptions as w, type VectorPaintSvgOptions as x, type VectorRgba as y, type VectorSvgImportOptions as z };