@pixerate/editor 0.89.0 → 0.90.0

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

@@ -291,6 +291,31 @@ declare function serializeLayers(layers: readonly ImageLayer[]): {
     layers: SerializedLayer[];
     assets: Record<string, string>;
 };
+/**
+ * Where a host keeps layer pixels outside the JSON (`toJSON({ assets: 'external', store })`):
+ * `put` stores a PNG and returns a reference (a URL, a key) that `get` resolves later.
+ */
+interface ImageEditorAssetStore {
+    put(blob: Blob, info: {
+        id: string;
+        width: number;
+        height: number;
+    }): Promise<string>;
+    get(ref: string): Promise<Blob>;
+}
+/**
+ * Serializes a layer tree with its assets in `store`: each PNG is uploaded once per store (by
+ * content), and `assets` maps asset ids to the store's references.
+ */
+declare function serializeLayersExternal(layers: readonly ImageLayer[], store: ImageEditorAssetStore): Promise<{
+    layers: SerializedLayer[];
+    assets: Record<string, string>;
+}>;
+/**
+ * Turns external asset references back into data URLs through `store.get` (data URLs pass through),
+ * so the document loads like an inline one. References that fail are reported and left out.
+ */
+declare function resolveExternalAssets(assets: Record<string, string>, store: ImageEditorAssetStore | undefined, problems: string[]): Promise<Record<string, string>>;
 interface DeserializeContext {
     assets: Record<string, string>;
     /** Decodes an asset (PNG data URL by default). Throw for an unusable asset. */
@@ -984,6 +1009,151 @@ declare function parseBlend(value: unknown, allowPassThrough?: boolean): BlendMo
 /** The union of two rectangles (either may be null). */
 declare function unionRect(a: CropBox | null, b: CropBox | null): CropBox | null;
 
+interface PlaneLayout {
+    planes: number;
+    width: number;
+    height: number;
+    depth: number;
+    /** PSB: RLE row counts are 4 bytes. */
+    psb: boolean;
+}
+/** Decodes planar channel data (`planes` planes of `height` rows each). */
+declare function decodePlanes(compression: number, data: Uint8Array, l: PlaneLayout): Uint8Array;
+/** RLE-encodes planar data: row counts (u16, or u32 in PSB), then the packed rows. */
+declare function encodeRle(decoded: Uint8Array, l: PlaneLayout): Uint8Array;
+
+interface PsdHeader {
+    psb: boolean;
+    channels: number;
+    height: number;
+    width: number;
+    depth: number;
+    colorMode: number;
+}
+interface PsdRect {
+    top: number;
+    left: number;
+    bottom: number;
+    right: number;
+}
+interface PsdChannel {
+    id: number;
+    /** `null` for a zero-length channel. */
+    compression: number | null;
+    /** Encoded bytes, without the compression field. */
+    data: Uint8Array;
+}
+interface PsdLayerMask {
+    rect: PsdRect;
+    defaultColor: number;
+    flags: number;
+    userDensity?: number;
+    userFeather?: number;
+    vectorDensity?: number;
+    vectorFeather?: number;
+    /** The real (vector-combined) user mask, when present. */
+    real?: {
+        flags: number;
+        background: number;
+        rect: PsdRect;
+    };
+}
+interface PsdTaggedBlock {
+    key: string;
+    data: Uint8Array;
+}
+interface PsdLayerRecord {
+    rect: PsdRect;
+    channels: PsdChannel[];
+    blendKey: string;
+    opacity: number;
+    clipping: number;
+    flags: number;
+    mask?: PsdLayerMask;
+    /** The legacy (Pascal) name; `layerName` prefers `luni`. */
+    legacyName: string;
+    blocks: PsdTaggedBlock[];
+}
+interface PsdResource {
+    id: number;
+    name: string;
+    data: Uint8Array;
+}
+interface PsdFile {
+    header: PsdHeader;
+    colorModeData: Uint8Array;
+    resources: PsdResource[];
+    /** Bottom-most first, as stored. */
+    layers: PsdLayerRecord[];
+    /** The layer count was negative: the merged image's first extra channel is its alpha. */
+    mergedAlpha: boolean;
+    globalBlocks: PsdTaggedBlock[];
+    imageCompression: number;
+    imageData: Uint8Array;
+}
+/** Parses a PSD or PSB. Throws `PsdError` with what was wrong. */
+declare function readPsd(bytes: Uint8Array): PsdFile;
+declare function layerName(rec: PsdLayerRecord): string;
+interface PsdTreeNode {
+    /** Index into `PsdFile.layers` (the folder record for a group). */
+    index: number;
+    children?: PsdTreeNode[];
+}
+/** The layer tree, bottom-most first (the stored order, as in our model), from the `lsct` dividers. */
+declare function layerTree(file: PsdFile): PsdTreeNode[];
+/** One layer channel decoded to `depth`-bit planar bytes, or `undefined` if the layer has none. */
+declare function decodeLayerChannel(file: PsdFile, rec: PsdLayerRecord, id: number): Uint8Array | undefined;
+/** The merged image's channels decoded, planar. */
+declare function decodeMergedImage(file: PsdFile): Uint8Array;
+/** Serializes a file. Channel data must already be encoded; `encodeName` writes legacy (Pascal) names. */
+declare function writePsd(file: PsdFile, encodeName: (s: string) => Uint8Array): Uint8Array;
+
+/** PSD blend keys → our blend modes (`diss` is the one we lack). */
+declare const PSD_BLEND_KEYS: Record<string, LayerBlendMode>;
+/** What happened to one PSD layer on import. */
+interface PsdLayerSummary {
+    name: string;
+    /** Our layer type, or `null` when the layer was dropped. */
+    type: 'pixel' | 'adjustment' | 'group' | null;
+    /** `mapped`: held exactly; `approximated`: imported with losses; `dropped`: left out. */
+    status: 'mapped' | 'approximated' | 'dropped';
+    /** What Photoshop calls it (`pixel`, `type`, `smart-object`, `fill`, `shape`, `Levels` …). */
+    psdKind: string;
+    /** Why it is not `mapped`. */
+    notes: string[];
+    /** Our layer id (when imported). */
+    id?: string;
+    depth: number;
+}
+interface PsdImportResult {
+    width: number;
+    height: number;
+    /** Bottom to top, as in our model. */
+    layers: ImageLayer[];
+    /** One sentence per problem, naming the affected layers. */
+    warnings: string[];
+    /** Every PSD layer, bottom first, a group before its children. */
+    summary: PsdLayerSummary[];
+    /** Pixels per inch, when the file says. */
+    resolution?: number;
+    info: {
+        psb: boolean;
+        depth: number;
+        colorMode: string;
+        channels: number;
+    };
+}
+interface PsdImportOptions {
+    /** Makes layer ids (defaults to `psd-<n>`). */
+    newId?: (hint: string) => string;
+    /** Skip decoding pixels (inspection only). */
+    skipPixels?: boolean;
+}
+/** Maps a parsed PSD to our layers. */
+declare function psdToLayers(file: PsdFile, options?: PsdImportOptions): PsdImportResult;
+/** Parses and maps PSD / PSB bytes. Throws `PsdError` for files that cannot be read at all. */
+declare function importPsd(bytes: Uint8Array, options?: PsdImportOptions): PsdImportResult;
+
 /** Latest serialized schema version (`3`: layers). Documents with the old shape still write 1 or 2. */
 declare const IMAGE_EDITOR_SCHEMA_VERSION: 3;
 /** Changes to an adjustment layer; `params` is merged into the current parameters. */
@@ -1003,8 +1173,18 @@ interface SelectionCommandOptions {
     /** Feather the new shape by this many pixels before combining (default 0). */
     feather?: number;
 }
+/** Where an AI result goes (see `applyInpaintedImage`, `applyBackgroundRemovedImage`). */
+interface AIResultOptions {
+    /** `new-layer`: a new layer (inpainting) or a mask (background removal); `replace`: the Background's pixels. Default: by `isMultiLayer`. */
+    target?: 'new-layer' | 'replace';
+}
 /** Where the selection tools read colours from. */
 interface SampleOptions {
+    /**
+     * `composite` (default): the image, as before (with several layers: the composite of the pixel
+     * layers, or with `sampleMerged` of every layer); `active-layer`: only the active pixel layer.
+     */
+    sample?: 'composite' | 'active-layer';
     /** Sample the adjusted image (base adjustments and layers) instead of the source pixels. */
     sampleMerged?: boolean;
     /** Pixels to use instead of reading the source image (natural size, RGBA). */
@@ -1574,6 +1754,13 @@ declare class ImageEditorController {
     setPan(pan: ImagePoint): void;
     setComparing(comparing: boolean): void;
     setFit(fit: ImageEditorFit): void;
+    private blankSource;
+    /**
+     * What the renderer draws from: the source image, or, for a document without one (an opened
+     * PSD, a v3 document loaded on its own), a transparent canvas of the document size, since every
+     * pixel then comes from the layers. `null` when there is nothing to draw.
+     */
+    private drawSource;
     render(targetCanvas: HTMLCanvasElement, options?: RenderOptions): Promise<void>;
     renderExport(options?: ExportOptions): Promise<HTMLCanvasElement>;
     /**
@@ -1604,17 +1791,72 @@ declare class ImageEditorController {
      * and the space that `applyInpaintedImage` / `applyBackgroundRemovedImage` expect back.
      */
     renderSource(): Promise<HTMLCanvasElement>;
+    /**
+     * The image an AI hook should edit: the source (`toSourceDataURL`) when results replace the
+     * Background, or the composite of the layers without annotations, in the source frame, when
+     * they go to a new layer or mask (see `applyInpaintedImage`).
+     */
+    toAIInputDataURL(options?: AIResultOptions): Promise<string>;
     toSourceDataURL(options?: Pick<ExportOptions, 'format' | 'quality'>): Promise<string>;
     /**
-     * Replaces the source image with an inpainted result (natural image space, see
-     * `toSourceDataURL`) and clears the mask annotations, as ONE undoable step.
+     * Whether AI results go to layers: the document has more than one pixel layer or group (adjustment
+     * and annotation layers are edits of the image, not images of their own).
      */
-    applyInpaintedImage(newDataUrl: string): Promise<void>;
+    /** `new-layer` in multi-layer documents and documents without a source image, else `replace`. */
+    private defaultAITarget;
+    /** No source image, and no layer reading one (an opened PSD): the layers are the whole document. */
+    private isSourceless;
+    get isMultiLayer(): boolean;
     /**
-     * Replaces the source image with a background-removed result as ONE undoable step.
-     * Crop and annotations are kept (rescaled if the new image has different dimensions).
+     * Applies an inpainted result (natural image space, see `toSourceDataURL`) as ONE undoable step.
+     * In a document with several layers (see `isMultiLayer`), or with `target: 'new-layer'`, the
+     * result goes to a new pixel layer above the active layer, limited to the selection. Otherwise
+     * (`target: 'replace'`, the single-layer default) it replaces the Background's pixels and clears
+     * the mask annotations, as before. Resolves to the new layer's id in new-layer mode.
      */
-    applyBackgroundRemovedImage(newDataUrl: string): Promise<void>;
+    applyInpaintedImage(newDataUrl: string, options?: AIResultOptions): Promise<string | void>;
+    /**
+     * Applies a background-removed result as ONE undoable step. In a document with several layers
+     * (or with `target: 'new-layer'`) the result's alpha becomes the mask of the active pixel layer
+     * (or the Background), replacing its mask. Otherwise (`target: 'replace'`, the single-layer
+     * default) it replaces the Background's pixels; crop and annotations are kept (rescaled if the
+     * new image has different dimensions). Resolves to the masked layer's id in mask mode.
+     */
+    applyBackgroundRemovedImage(newDataUrl: string, options?: AIResultOptions): Promise<string | void>;
+    /**
+     * Rasterize Layer: an annotation layer becomes a pixel layer with the same id, name and
+     * properties (needs a canvas), and a pixel layer's filters are baked into its pixels. One undo
+     * step. Returns the layer id.
+     */
+    rasterizeLayer(id: string): Promise<string>;
+    /** Pixels per inch of the last opened PSD (written back by `toPsd`). */
+    private psdResolution;
+    /**
+     * Opens PSD / PSB bytes as the document (one undo step): the layers replace the stack and the
+     * document has no source image afterwards (every pixel comes from the layers). What the model
+     * cannot hold is approximated or left out; `warnings` says what, naming the layers.
+     * Throws `PsdError` for files that cannot be read at all.
+     */
+    loadPsd(bytes: Uint8Array): {
+        layerIds: string[];
+        warnings: string[];
+        width: number;
+        height: number;
+        summary: PsdImportResult['summary'];
+    };
+    /**
+     * The document as an 8-bit RGB PSD (PSB above 30 000 px) with real layers, groups, adjustment
+     * layers and masks, in the source frame. Layer filters and parametric (depth) masks are baked
+     * into pixels and masks, annotation layers are rasterized (in a browser; elsewhere they are left
+     * out), and the merged image is our composite. `warnings` lists every such change.
+     */
+    toPsd(): Promise<{
+        bytes: Uint8Array;
+        warnings: string[];
+        psb: boolean;
+        width: number;
+        height: number;
+    }>;
     private replaceSource;
     /**
      * The serializable state. A document whose layers still have the v1 / v2 shape (the
@@ -1623,6 +1865,22 @@ declare class ImageEditorController {
      * assets. `selection` is included (run-length encoded) only when something is selected.
      */
     toJSON(): SerializedImageEditorState;
+    /**
+     * With `assets: 'external'`, layer pixels go to `store` (each PNG uploaded once per store) and
+     * the v3 document holds the store's references. Old-shape documents have no assets either way.
+     */
+    toJSON(options: {
+        assets: 'external';
+        store: ImageEditorAssetStore;
+    }): Promise<SerializedImageEditorState>;
+    /**
+     * Loads a stored state whose v3 assets may live in an asset store (references other than data
+     * URLs are fetched with `store.get`), as one undo step. Assets that cannot be fetched are left
+     * out and listed in `lastLoadProblems`.
+     */
+    loadJSONAsync(data: SerializedImageEditorState, options?: {
+        store?: ImageEditorAssetStore;
+    }): Promise<void>;
     /** Loads a stored state of any version (one undo step). */
     loadJSON(data: SerializedImageEditorState): void;
     /** Problems found by the last `loadJSON` / `initialState` of a v3 document (unreadable layers or assets). */
@@ -1630,6 +1888,8 @@ declare class ImageEditorController {
     private applyStored;
     private serializeState;
 }
+/** Bilinear resample of RGBA pixels to `width × height`. */
+declare function resizePixels(px: PixelBuffer, width: number, height: number): PixelBuffer;
 /** A colour as RGBA bytes: `#rgb`, `#rrggbb`, `#rrggbbaa` or `[r, g, b, a?]` (0..255). */
 declare function parseColor(value: string | number[]): [number, number, number, number];
 /** `#rrggbb` of RGBA bytes (alpha dropped). */
@@ -2301,6 +2561,10 @@ declare function colorBalanceChannel(tones: readonly [readonly number[], readonl
  * blues, magentas).
  */
 declare function blackWhiteGray(c: readonly number[], weights: readonly number[]): number;
+/** D50 white (ICC PCS). */
+declare const D50: readonly [0.96422, 1, 0.82521];
+/** D50 XYZ → linear sRGB. */
+declare const XYZ_D50_TO_SRGB: readonly [readonly [3.133856, -1.616867, -0.490615], readonly [-0.978768, 1.916142, 0.033454], readonly [0.071945, -0.228991, 1.405243]];
 /**
  * Photo Filter's linear-light RGB matrix (row-major 3×3): the pixel's D50 XYZ, relative to white,
  * multiplied by the filter colour's mixed in by `density` (0..1). `normalizeY` keeps luminance Y.
@@ -2511,6 +2775,8 @@ interface SelectionToolOptions {
     antiAlias: boolean;
     /** Sample the adjusted image instead of the source. */
     sampleMerged: boolean;
+    /** Sample the whole image (`composite`, default) or only the active pixel layer. */
+    sample?: 'composite' | 'active-layer';
     distance: ColorDistance;
 }
 declare const DEFAULT_SELECTION_TOOL_OPTIONS: SelectionToolOptions;
@@ -2841,7 +3107,7 @@ type DropZone = 'above' | 'below' | 'inside';
 declare function dropZone(fraction: number, isGroup: boolean): DropZone;
 /** The placement for `move_layer` when `dragId` is dropped on row `targetId` in `zone`, or `null` for a no-op. */
 declare function dropPlacement(layers: readonly ImageLayer[], dragId: string, targetId: string, zone: DropZone): LayerPlacement | null;
-type LayerMenuAction = 'new-layer' | 'new-group' | 'duplicate' | 'delete' | 'group-selected' | 'ungroup' | 'merge-down' | 'merge-visible' | 'flatten' | 'via-copy' | 'via-cut' | 'add-mask' | 'add-mask-selection' | 'apply-mask' | 'delete-mask' | 'toggle-mask' | 'toggle-clip';
+type LayerMenuAction = 'new-layer' | 'new-group' | 'duplicate' | 'delete' | 'group-selected' | 'ungroup' | 'merge-down' | 'merge-visible' | 'flatten' | 'via-copy' | 'via-cut' | 'add-mask' | 'add-mask-selection' | 'apply-mask' | 'delete-mask' | 'toggle-mask' | 'toggle-clip' | 'rasterize';
 interface LayerMenuItem {
     action: LayerMenuAction;
     label: string;
@@ -2929,4 +3195,169 @@ declare class PaintGesture {
     cancel(): void;
 }
 
-export { ADJUSTMENT_KINDS, ADJUSTMENT_LAYER_CONTROLS, ADJUSTMENT_LAYER_OPACITY_CONTROL, ADJUSTMENT_LUT_SIZE, 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, D65, DEFAULT_ADJUSTMENTS, DEFAULT_DEPTH_MASK, DEFAULT_REFINE_EDGE_PARAMS, DEFAULT_SELECTION_TOOL_OPTIONS, DEFAULT_TRANSFORM, DEVELOP_FILTER_ID, type DepthMaskOptions, 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, 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, PaintGesture, type PaintOptions, type PaintPointerSample, type PaintStrokeResult, PaintStrokeSession, type PaintTool, type PenAnnotation, type PhotoFilterParams, type PixelBuffer, type PixelLayer, type PixelLayerInit, type PixelOp, PixelSurface, type PosterizeParams, type QuickMaskStyle, REFINE_EDGE_CONTROLS, type RasterMask, type RectAnnotation, type RefineEdgeControl, type RefineEdgeParams, type RemoveBackgroundHook, type RemoveBackgroundOptions, type RenderOptions, type RouteInput, SELECTION_MODES, SELECTION_MODE_LABELS, SELECTION_MODIFY_OPS, SELECTION_TOOLS, 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 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, activeAdjustmentLayers, 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, createImageLayerTools, createImagePaintTools, createImageSelectionTools, createSelectionMask, curveLut, curveLutFromLevels, curvePointToBox, curveSvgPath, decodeLayerMask, decodePngDataUrl, decodeSelectionRle, defaultAdjustmentParams, depthMaskAlpha, depthRasterMask, describeLayer, describeSelection, deserializeLayer, deserializeLayers, deserializeSelection, developFilter, developFromAdjustments, developTarget, distanceTransform, dropPlacement, dropZone, duplicateLayer, edgeWidth, ellipsePoints, ellipseSelection, emptyHistogram, encodeSelectionRle, encodeSurface, evaluateAdjustmentLayers, expandCoverage, 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, insertCurvePoint, invertMatrix3, invertSelection, isActiveFilter, isAdjustmentKind, isDefaultDepthMask, isLegacyShape, isPaintTool, isQuarterTurn, isQuarterTurnSwapped, isSelectionEmpty, isSelectionMode, isSpatialFilter, kelvinToTemperature, layerBadge, layerLabel, layerMaskCoverage, layerMaskFromSelection, layerMaskKey, layerMenu, layerPanelRows, 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, parseBlend, parseColor, parseSelectionMode, photoFilterMatrix, pixelLayerBounds, pixelLayers, placeLayer, pointerPressure, polygonCoverage, polygonSelection, posterizeValue, projectImagePoint, projectImageRect, projectMaskCoverage, projectQuarterTurn, quickMaskPixels, rangeLightness, rasterMaskFromLegacy, readAdjustmentControls, rectSelection, refineCoverage, refineEdgeHalo, refineSelection, removeAlpha, removeCurvePoint, removeLayer, removeLayerFilter, renderLayeredBase, requireLayer, requireUnlocked, resizeSelection, resolveMosaicRegionBounds, rgbToGray, rgbToHsl, runLayerMenuAction, sampleLut, sampleToneLut, selectionArea, selectionFromCoverage, selectionFromPixels, selectionModeFromModifiers, selectionOutline, selectionToCoverage, selectionToPixels, selectionValueAt, serializeLayer, serializeLayers, serializeSelection, setControlPath, setLayerMask, setLayerProperties, shiftCoverage, smoothCoverage, splitOverlayAnnotations, srgb8ToLab, srgbToLinear, sumHistograms, tempTintToXy, temperatureToKelvin, toHex, toneCurve, toneLuts, toneRange, ungroupLayer, unionRect, unprojectCanvasPoint, updateLayerFilter, updateLayerMaskProps, uvToXy, vibranceLinear, vibrancePixel, wbMatrix, whiteBalanceFromSample, whiteBalanceMatrix, withNewIds, xyToTempTint, xyToUv };
+/** A malformed or unsupported PSD; the message says what was wrong and where. */
+declare class PsdError extends Error {
+    constructor(message: string);
+}
+
+/**
+ * Photoshop ActionDescriptors (the structured values inside `vibA`, `blwh` and other blocks):
+ * read and write. Keys and class ids are 4-character codes, or longer strings.
+ */
+
+interface DescClass {
+    name: string;
+    classId: string;
+}
+type ReferenceItem = {
+    type: 'prop';
+    class: DescClass;
+    key: string;
+} | {
+    type: 'Clss';
+    class: DescClass;
+} | {
+    type: 'Enmr';
+    class: DescClass;
+    typeId: string;
+    value: string;
+} | {
+    type: 'rele';
+    class: DescClass;
+    offset: number;
+} | {
+    type: 'Idnt';
+    class: DescClass;
+    id: number;
+} | {
+    type: 'indx';
+    class: DescClass;
+    index: number;
+} | {
+    type: 'name';
+    class: DescClass;
+    name: string;
+};
+type DescValue = {
+    type: 'obj ';
+    items: ReferenceItem[];
+} | {
+    type: 'Objc' | 'GlbO';
+    value: Descriptor;
+} | {
+    type: 'VlLs';
+    items: DescValue[];
+} | {
+    type: 'doub';
+    value: number;
+} | {
+    type: 'UntF';
+    unit: string;
+    value: number;
+} | {
+    type: 'UnFl';
+    unit: string;
+    values: number[];
+} | {
+    type: 'TEXT';
+    value: string;
+} | {
+    type: 'enum';
+    typeId: string;
+    value: string;
+} | {
+    type: 'long';
+    value: number;
+} | {
+    type: 'comp';
+    value: number;
+} | {
+    type: 'bool';
+    value: boolean;
+} | {
+    type: 'type' | 'GlbC';
+    class: DescClass;
+} | {
+    type: 'alis' | 'Pth ' | 'tdta';
+    data: Uint8Array;
+} | {
+    type: 'ObAr';
+    prefix: number;
+    body: Descriptor;
+};
+interface Descriptor {
+    name: string;
+    classId: string;
+    items: Array<[string, DescValue]>;
+}
+/** A versioned descriptor from the start of `bytes` (trailing bytes are ignored). */
+declare function parseVersionedDescriptor(bytes: Uint8Array): Descriptor;
+declare function versionedDescriptorBytes(d: Descriptor): Uint8Array;
+
+/** Every adjustment block key Photoshop writes. */
+declare const ADJUSTMENT_KEYS: string[];
+/** Keys we read and write. */
+declare const SUPPORTED_ADJUSTMENT_KEYS: Record<string, AdjustmentKind>;
+type ParsedAdjustment = {
+    [K in AdjustmentKind]: {
+        kind: K;
+        params: AdjustmentParamsMap[K];
+        approximated?: string;
+    };
+}[AdjustmentKind];
+/**
+ * Our parameters for an adjustment block, or `null` when the key is not one of our kinds or the
+ * block cannot be read.
+ */
+declare function parseAdjustmentBlock(key: string, data: Uint8Array): ParsedAdjustment | null;
+/** The PSD block (key and data) for one of our adjustment layers. */
+declare function writeAdjustmentBlock<K extends AdjustmentKind>(kind: K, params: AdjustmentParamsMap[K]): {
+    key: string;
+    data: Uint8Array;
+};
+
+interface PsdExportInput {
+    width: number;
+    height: number;
+    /** Prepared stack, bottom to top. */
+    layers: readonly ImageLayer[];
+    /** The composite, `width × height` RGBA, written as the merged image. */
+    merged: ArrayLike<number>;
+    /** Pixels per inch (default 72). */
+    resolution?: number;
+}
+interface PsdExportResult {
+    bytes: Uint8Array;
+    psb: boolean;
+    /** Layer records written (group folders and dividers included). */
+    records: number;
+}
+/** Writes the prepared stack as PSD (or PSB) bytes. */
+declare function exportPsd(input: PsdExportInput): PsdExportResult;
+
+/** Framework-free helpers behind the PSD buttons of the React and Svelte layer panels. */
+
+/** Types the file pickers accept. */
+declare const PSD_FILE_ACCEPT = ".psd,.psb,image/vnd.adobe.photoshop,application/x-photoshop";
+/** Reads a picked file and opens it as the document (one undo step). Returns the import warnings. */
+declare function openPsdFile(controller: ImageEditorController, file: Blob): Promise<string[]>;
+/** A file name for the exported document: `name` with a `.psd` / `.psb` extension. */
+declare function psdFileName(name: string, psb: boolean): string;
+/**
+ * Writes the document as a PSD and offers it as a download (in a browser). Returns the file
+ * name and the export warnings.
+ */
+declare function downloadPsd(controller: ImageEditorController, name?: string): Promise<{
+    fileName: string;
+    warnings: string[];
+}>;
+
+/** Base64 (or a data URL) → bytes, refusing anything that is not base64 text. */
+declare function psdBytesFromBase64(data: unknown): Uint8Array;
+/**
+ * Agent tools for Photoshop files: `inspect_psd` (what a file holds and how it would map),
+ * `import_psd` (open it as the document) and `export_psd` (the document as a PSD).
+ */
+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 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, 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, createImageLayerTools, createImagePaintTools, createImagePsdTools, createImageSelectionTools, createSelectionMask, curveLut, curveLutFromLevels, curvePointToBox, curveSvgPath, decodeLayerChannel, decodeLayerMask, decodeMergedImage, decodePlanes, decodePngDataUrl, decodeSelectionRle, defaultAdjustmentParams, depthMaskAlpha, depthRasterMask, describeLayer, describeSelection, 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, 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, removeLayerFilter, renderLayeredBase, requireLayer, requireUnlocked, resizePixels, resizeSelection, resolveExternalAssets, resolveMosaicRegionBounds, rgbToGray, rgbToHsl, runLayerMenuAction, sampleLut, sampleToneLut, selectionArea, selectionFromCoverage, selectionFromPixels, selectionModeFromModifiers, selectionOutline, selectionToCoverage, selectionToPixels, selectionValueAt, serializeLayer, serializeLayers, serializeLayersExternal, serializeSelection, setControlPath, setLayerMask, setLayerProperties, shiftCoverage, smoothCoverage, splitOverlayAnnotations, srgb8ToLab, srgbToLinear, sumHistograms, tempTintToXy, temperatureToKelvin, toHex, toneCurve, toneLuts, toneRange, ungroupLayer, unionRect, unprojectCanvasPoint, updateLayerFilter, updateLayerMaskProps, uvToXy, versionedDescriptorBytes, vibranceLinear, vibrancePixel, wbMatrix, whiteBalanceFromSample, whiteBalanceMatrix, withNewIds, writeAdjustmentBlock, writePsd, xyToTempTint, xyToUv };