@nxgt/material 3.57.0 → 3.58.0

package/dist/lib/components/ui/media/image-editor/image-editor.slice.d.ts

@@ -252,7 +252,7 @@ export declare const imageEditorSlice: import('@reduxjs/toolkit').Slice<ImageEdi
         split: boolean;
         aspect: ImageEditorAspect;
         exportOptions: {
-            format: import('./types.js').ImageEditorExportFormat;
+            format: import('./types-session.js').ImageEditorExportFormat;
             quality: number;
             scale: number;
         };
@@ -507,7 +507,7 @@ export declare const imageEditorSlice: import('@reduxjs/toolkit').Slice<ImageEdi
         split: boolean;
         aspect: ImageEditorAspect;
         exportOptions: {
-            format: import('./types.js').ImageEditorExportFormat;
+            format: import('./types-session.js').ImageEditorExportFormat;
             quality: number;
             scale: number;
         };
@@ -763,7 +763,7 @@ export declare const imageEditorSlice: import('@reduxjs/toolkit').Slice<ImageEdi
         split: boolean;
         aspect: ImageEditorAspect;
         exportOptions: {
-            format: import('./types.js').ImageEditorExportFormat;
+            format: import('./types-session.js').ImageEditorExportFormat;
             quality: number;
             scale: number;
         };
@@ -1017,7 +1017,7 @@ export declare const imageEditorSlice: import('@reduxjs/toolkit').Slice<ImageEdi
         split: boolean;
         aspect: ImageEditorAspect;
         exportOptions: {
-            format: import('./types.js').ImageEditorExportFormat;
+            format: import('./types-session.js').ImageEditorExportFormat;
             quality: number;
             scale: number;
         };
@@ -1271,7 +1271,7 @@ export declare const imageEditorSlice: import('@reduxjs/toolkit').Slice<ImageEdi
         split: boolean;
         aspect: ImageEditorAspect;
         exportOptions: {
-            format: import('./types.js').ImageEditorExportFormat;
+            format: import('./types-session.js').ImageEditorExportFormat;
             quality: number;
             scale: number;
         };
@@ -1525,7 +1525,7 @@ export declare const imageEditorSlice: import('@reduxjs/toolkit').Slice<ImageEdi
         split: boolean;
         aspect: ImageEditorAspect;
         exportOptions: {
-            format: import('./types.js').ImageEditorExportFormat;
+            format: import('./types-session.js').ImageEditorExportFormat;
             quality: number;
             scale: number;
         };
@@ -1779,7 +1779,7 @@ export declare const imageEditorSlice: import('@reduxjs/toolkit').Slice<ImageEdi
         split: boolean;
         aspect: ImageEditorAspect;
         exportOptions: {
-            format: import('./types.js').ImageEditorExportFormat;
+            format: import('./types-session.js').ImageEditorExportFormat;
             quality: number;
             scale: number;
         };
@@ -2033,7 +2033,7 @@ export declare const imageEditorSlice: import('@reduxjs/toolkit').Slice<ImageEdi
         split: boolean;
         aspect: ImageEditorAspect;
         exportOptions: {
-            format: import('./types.js').ImageEditorExportFormat;
+            format: import('./types-session.js').ImageEditorExportFormat;
             quality: number;
             scale: number;
         };
@@ -2287,16 +2287,16 @@ export declare const imageEditorSlice: import('@reduxjs/toolkit').Slice<ImageEdi
         split: boolean;
         aspect: ImageEditorAspect;
         exportOptions: {
-            format: import('./types.js').ImageEditorExportFormat;
+            format: import('./types-session.js').ImageEditorExportFormat;
             quality: number;
             scale: number;
         };
         editingId: string | null;
         shortcutsOpen: boolean;
     }, action: PayloadAction<Partial<ImageEditorExportOptions>>) => void;
-    addAnnotation: (state: ImageEditorChromeState, action: PayloadAction<import('./types.js').ImageEditorAnnotation>) => void;
+    addAnnotation: (state: ImageEditorChromeState, action: PayloadAction<import('./types-edits.js').ImageEditorAnnotation>) => void;
     updateAnnotation: (state: ImageEditorChromeState, action: PayloadAction<{
-        annotation: import('./types.js').ImageEditorAnnotation;
+        annotation: import('./types-edits.js').ImageEditorAnnotation;
         gesture?: string;
     }>) => void;
     moveAnnotation: (state: ImageEditorChromeState, action: PayloadAction<{
@@ -2310,12 +2310,12 @@ export declare const imageEditorSlice: import('@reduxjs/toolkit').Slice<ImageEdi
     bringToFront: (state: ImageEditorChromeState, action: PayloadAction<string>) => void;
     clearAnnotations: (state: ImageEditorChromeState) => void;
     selectAnnotation: (state: ImageEditorChromeState, action: PayloadAction<string | null>) => void;
-    setBrush: (state: ImageEditorChromeState, action: PayloadAction<Partial<import('./types.js').ImageEditorBrush>>) => void;
+    setBrush: (state: ImageEditorChromeState, action: PayloadAction<Partial<import('./types-session.js').ImageEditorBrush>>) => void;
     turn: (state: ImageEditorChromeState, action: PayloadAction<1 | -1>) => void;
     flip: (state: ImageEditorChromeState, action: PayloadAction<"x" | "y">) => void;
     setStraighten: (state: ImageEditorChromeState, action: PayloadAction<number>) => void;
     setCrop: (state: ImageEditorChromeState, action: PayloadAction<{
-        rect: import('./types.js').ImageEditorRect;
+        rect: import('./types-edits.js').ImageEditorRect;
         gesture?: string;
     }>) => void;
     resetTransform: (state: ImageEditorChromeState) => void;
@@ -2566,7 +2566,7 @@ export declare const imageEditorSlice: import('@reduxjs/toolkit').Slice<ImageEdi
         split: boolean;
         aspect: ImageEditorAspect;
         exportOptions: {
-            format: import('./types.js').ImageEditorExportFormat;
+            format: import('./types-session.js').ImageEditorExportFormat;
             quality: number;
             scale: number;
         };
@@ -2820,7 +2820,7 @@ export declare const imageEditorSlice: import('@reduxjs/toolkit').Slice<ImageEdi
         split: boolean;
         aspect: ImageEditorAspect;
         exportOptions: {
-            format: import('./types.js').ImageEditorExportFormat;
+            format: import('./types-session.js').ImageEditorExportFormat;
             quality: number;
             scale: number;
         };
@@ -3074,7 +3074,7 @@ export declare const imageEditorSlice: import('@reduxjs/toolkit').Slice<ImageEdi
         split: boolean;
         aspect: ImageEditorAspect;
         exportOptions: {
-            format: import('./types.js').ImageEditorExportFormat;
+            format: import('./types-session.js').ImageEditorExportFormat;
             quality: number;
             scale: number;
         };
@@ -3332,7 +3332,7 @@ export declare const imageEditorSlice: import('@reduxjs/toolkit').Slice<ImageEdi
         split: boolean;
         aspect: ImageEditorAspect;
         exportOptions: {
-            format: import('./types.js').ImageEditorExportFormat;
+            format: import('./types-session.js').ImageEditorExportFormat;
             quality: number;
             scale: number;
         };
@@ -3586,7 +3586,7 @@ export declare const imageEditorSlice: import('@reduxjs/toolkit').Slice<ImageEdi
         split: boolean;
         aspect: ImageEditorAspect;
         exportOptions: {
-            format: import('./types.js').ImageEditorExportFormat;
+            format: import('./types-session.js').ImageEditorExportFormat;
             quality: number;
             scale: number;
         };
@@ -3840,7 +3840,7 @@ export declare const imageEditorSlice: import('@reduxjs/toolkit').Slice<ImageEdi
         split: boolean;
         aspect: ImageEditorAspect;
         exportOptions: {
-            format: import('./types.js').ImageEditorExportFormat;
+            format: import('./types-session.js').ImageEditorExportFormat;
             quality: number;
             scale: number;
         };
@@ -4094,7 +4094,7 @@ export declare const imageEditorSlice: import('@reduxjs/toolkit').Slice<ImageEdi
         split: boolean;
         aspect: ImageEditorAspect;
         exportOptions: {
-            format: import('./types.js').ImageEditorExportFormat;
+            format: import('./types-session.js').ImageEditorExportFormat;
             quality: number;
             scale: number;
         };
@@ -4348,7 +4348,7 @@ export declare const imageEditorSlice: import('@reduxjs/toolkit').Slice<ImageEdi
         split: boolean;
         aspect: ImageEditorAspect;
         exportOptions: {
-            format: import('./types.js').ImageEditorExportFormat;
+            format: import('./types-session.js').ImageEditorExportFormat;
             quality: number;
             scale: number;
         };
@@ -4604,7 +4604,7 @@ export declare const imageEditorActions: import('@reduxjs/toolkit').CaseReducerA
         split: boolean;
         aspect: ImageEditorAspect;
         exportOptions: {
-            format: import('./types.js').ImageEditorExportFormat;
+            format: import('./types-session.js').ImageEditorExportFormat;
             quality: number;
             scale: number;
         };
@@ -4859,7 +4859,7 @@ export declare const imageEditorActions: import('@reduxjs/toolkit').CaseReducerA
         split: boolean;
         aspect: ImageEditorAspect;
         exportOptions: {
-            format: import('./types.js').ImageEditorExportFormat;
+            format: import('./types-session.js').ImageEditorExportFormat;
             quality: number;
             scale: number;
         };
@@ -5115,7 +5115,7 @@ export declare const imageEditorActions: import('@reduxjs/toolkit').CaseReducerA
         split: boolean;
         aspect: ImageEditorAspect;
         exportOptions: {
-            format: import('./types.js').ImageEditorExportFormat;
+            format: import('./types-session.js').ImageEditorExportFormat;
             quality: number;
             scale: number;
         };
@@ -5369,7 +5369,7 @@ export declare const imageEditorActions: import('@reduxjs/toolkit').CaseReducerA
         split: boolean;
         aspect: ImageEditorAspect;
         exportOptions: {
-            format: import('./types.js').ImageEditorExportFormat;
+            format: import('./types-session.js').ImageEditorExportFormat;
             quality: number;
             scale: number;
         };
@@ -5623,7 +5623,7 @@ export declare const imageEditorActions: import('@reduxjs/toolkit').CaseReducerA
         split: boolean;
         aspect: ImageEditorAspect;
         exportOptions: {
-            format: import('./types.js').ImageEditorExportFormat;
+            format: import('./types-session.js').ImageEditorExportFormat;
             quality: number;
             scale: number;
         };
@@ -5877,7 +5877,7 @@ export declare const imageEditorActions: import('@reduxjs/toolkit').CaseReducerA
         split: boolean;
         aspect: ImageEditorAspect;
         exportOptions: {
-            format: import('./types.js').ImageEditorExportFormat;
+            format: import('./types-session.js').ImageEditorExportFormat;
             quality: number;
             scale: number;
         };
@@ -6131,7 +6131,7 @@ export declare const imageEditorActions: import('@reduxjs/toolkit').CaseReducerA
         split: boolean;
         aspect: ImageEditorAspect;
         exportOptions: {
-            format: import('./types.js').ImageEditorExportFormat;
+            format: import('./types-session.js').ImageEditorExportFormat;
             quality: number;
             scale: number;
         };
@@ -6385,7 +6385,7 @@ export declare const imageEditorActions: import('@reduxjs/toolkit').CaseReducerA
         split: boolean;
         aspect: ImageEditorAspect;
         exportOptions: {
-            format: import('./types.js').ImageEditorExportFormat;
+            format: import('./types-session.js').ImageEditorExportFormat;
             quality: number;
             scale: number;
         };
@@ -6639,16 +6639,16 @@ export declare const imageEditorActions: import('@reduxjs/toolkit').CaseReducerA
         split: boolean;
         aspect: ImageEditorAspect;
         exportOptions: {
-            format: import('./types.js').ImageEditorExportFormat;
+            format: import('./types-session.js').ImageEditorExportFormat;
             quality: number;
             scale: number;
         };
         editingId: string | null;
         shortcutsOpen: boolean;
     }, action: PayloadAction<Partial<ImageEditorExportOptions>>) => void;
-    addAnnotation: (state: ImageEditorChromeState, action: PayloadAction<import('./types.js').ImageEditorAnnotation>) => void;
+    addAnnotation: (state: ImageEditorChromeState, action: PayloadAction<import('./types-edits.js').ImageEditorAnnotation>) => void;
     updateAnnotation: (state: ImageEditorChromeState, action: PayloadAction<{
-        annotation: import('./types.js').ImageEditorAnnotation;
+        annotation: import('./types-edits.js').ImageEditorAnnotation;
         gesture?: string;
     }>) => void;
     moveAnnotation: (state: ImageEditorChromeState, action: PayloadAction<{
@@ -6662,12 +6662,12 @@ export declare const imageEditorActions: import('@reduxjs/toolkit').CaseReducerA
     bringToFront: (state: ImageEditorChromeState, action: PayloadAction<string>) => void;
     clearAnnotations: (state: ImageEditorChromeState) => void;
     selectAnnotation: (state: ImageEditorChromeState, action: PayloadAction<string | null>) => void;
-    setBrush: (state: ImageEditorChromeState, action: PayloadAction<Partial<import('./types.js').ImageEditorBrush>>) => void;
+    setBrush: (state: ImageEditorChromeState, action: PayloadAction<Partial<import('./types-session.js').ImageEditorBrush>>) => void;
     turn: (state: ImageEditorChromeState, action: PayloadAction<1 | -1>) => void;
     flip: (state: ImageEditorChromeState, action: PayloadAction<"x" | "y">) => void;
     setStraighten: (state: ImageEditorChromeState, action: PayloadAction<number>) => void;
     setCrop: (state: ImageEditorChromeState, action: PayloadAction<{
-        rect: import('./types.js').ImageEditorRect;
+        rect: import('./types-edits.js').ImageEditorRect;
         gesture?: string;
     }>) => void;
     resetTransform: (state: ImageEditorChromeState) => void;
@@ -6918,7 +6918,7 @@ export declare const imageEditorActions: import('@reduxjs/toolkit').CaseReducerA
         split: boolean;
         aspect: ImageEditorAspect;
         exportOptions: {
-            format: import('./types.js').ImageEditorExportFormat;
+            format: import('./types-session.js').ImageEditorExportFormat;
             quality: number;
             scale: number;
         };
@@ -7172,7 +7172,7 @@ export declare const imageEditorActions: import('@reduxjs/toolkit').CaseReducerA
         split: boolean;
         aspect: ImageEditorAspect;
         exportOptions: {
-            format: import('./types.js').ImageEditorExportFormat;
+            format: import('./types-session.js').ImageEditorExportFormat;
             quality: number;
             scale: number;
         };
@@ -7426,7 +7426,7 @@ export declare const imageEditorActions: import('@reduxjs/toolkit').CaseReducerA
         split: boolean;
         aspect: ImageEditorAspect;
         exportOptions: {
-            format: import('./types.js').ImageEditorExportFormat;
+            format: import('./types-session.js').ImageEditorExportFormat;
             quality: number;
             scale: number;
         };
@@ -7684,7 +7684,7 @@ export declare const imageEditorActions: import('@reduxjs/toolkit').CaseReducerA
         split: boolean;
         aspect: ImageEditorAspect;
         exportOptions: {
-            format: import('./types.js').ImageEditorExportFormat;
+            format: import('./types-session.js').ImageEditorExportFormat;
             quality: number;
             scale: number;
         };
@@ -7938,7 +7938,7 @@ export declare const imageEditorActions: import('@reduxjs/toolkit').CaseReducerA
         split: boolean;
         aspect: ImageEditorAspect;
         exportOptions: {
-            format: import('./types.js').ImageEditorExportFormat;
+            format: import('./types-session.js').ImageEditorExportFormat;
             quality: number;
             scale: number;
         };
@@ -8192,7 +8192,7 @@ export declare const imageEditorActions: import('@reduxjs/toolkit').CaseReducerA
         split: boolean;
         aspect: ImageEditorAspect;
         exportOptions: {
-            format: import('./types.js').ImageEditorExportFormat;
+            format: import('./types-session.js').ImageEditorExportFormat;
             quality: number;
             scale: number;
         };
@@ -8446,7 +8446,7 @@ export declare const imageEditorActions: import('@reduxjs/toolkit').CaseReducerA
         split: boolean;
         aspect: ImageEditorAspect;
         exportOptions: {
-            format: import('./types.js').ImageEditorExportFormat;
+            format: import('./types-session.js').ImageEditorExportFormat;
             quality: number;
             scale: number;
         };
@@ -8700,7 +8700,7 @@ export declare const imageEditorActions: import('@reduxjs/toolkit').CaseReducerA
         split: boolean;
         aspect: ImageEditorAspect;
         exportOptions: {
-            format: import('./types.js').ImageEditorExportFormat;
+            format: import('./types-session.js').ImageEditorExportFormat;
             quality: number;
             scale: number;
         };
@@ -8711,7 +8711,7 @@ export declare const imageEditorActions: import('@reduxjs/toolkit').CaseReducerA
 export declare const imageEditorSelectors: {
     selectCanUndo: (state: ImageEditorChromeState) => boolean;
     selectCanRedo: (state: ImageEditorChromeState) => boolean;
-    selectSelected: (state: ImageEditorChromeState) => import('./types.js').ImageEditorAnnotation | undefined;
+    selectSelected: (state: ImageEditorChromeState) => import('./types-edits.js').ImageEditorAnnotation | undefined;
     selectIsDirty: (state: ImageEditorChromeState) => boolean;
     selectAdjustedCount: (state: ImageEditorChromeState) => number;
 };

package/dist/lib/components/ui/media/image-editor/image-editor.stage-gestures.d.ts

@@ -0,0 +1,29 @@
+import { ImageEditorAnnotation, ImageEditorBrush, ImageEditorMarkupTool } from './types.js';
+import { StagePoint, StagePointerOptions } from './use-stage-pointer.js';
+export type StageGesture = {
+    kind: 'draw';
+    mark: ImageEditorAnnotation;
+    start: StagePoint;
+} | {
+    kind: 'move';
+    id: string;
+    last: StagePoint;
+    gesture: string;
+} | {
+    kind: 'erase';
+} | {
+    kind: 'text';
+    at: StagePoint;
+    mark?: ImageEditorAnnotation;
+};
+/** A new mark of `tool` starting at `p`. */
+export declare function startMark(tool: ImageEditorMarkupTool, p: StagePoint, brush: ImageEditorBrush): ImageEditorAnnotation | null;
+/** The mark being drawn, stretched to `p`. */
+export declare function extendMark(mark: ImageEditorAnnotation, start: StagePoint, p: StagePoint): ImageEditorAnnotation;
+/** Whether a mark is big enough to keep (a click is not a rectangle). */
+export declare function isVisible(mark: ImageEditorAnnotation): boolean;
+/**
+ * What a press at `p` starts for the current tool. Select and erase act at
+ * once (they select or remove a mark); text is opened on release.
+ */
+export declare function beginGesture(o: StagePointerOptions, p: StagePoint): StageGesture | null;

package/dist/lib/components/ui/media/image-editor/image-editor.stage-paint.d.ts

@@ -0,0 +1,17 @@
+import { RenderSource } from './image-editor.render.js';
+import { ImageEditorAnnotation, ImageEditorEdits } from './types.js';
+/** Output pixels per source pixel for a canvas `displayWidth` wide on screen. */
+export declare function stageScale(source: RenderSource, edits: ImageEditorEdits, region: 'crop' | 'full', displayWidth: number): number;
+/**
+ * Paints the cached image layer on the visible canvas, then the marks (and
+ * the draft being drawn) and the selected mark's outline over it.
+ */
+export declare function paintStage(canvas: HTMLCanvasElement, layer: HTMLCanvasElement, ctx: CanvasRenderingContext2D, view: {
+    source: RenderSource;
+    edits: ImageEditorEdits;
+    region: 'crop' | 'full';
+    scale: number;
+    comparing: boolean;
+    hiddenId: string | null;
+    selectedId: string | null;
+}, draft?: ImageEditorAnnotation): void;

package/dist/lib/components/ui/media/image-editor/partials/crop-aspect-picker.d.ts

@@ -0,0 +1,2 @@
+/** The crop ratio presets; hidden when the editor locks the aspect. */
+export declare function CropAspectPicker(): import("react").JSX.Element | null;

package/dist/lib/components/ui/media/image-editor/partials/crop-orientation.d.ts

@@ -0,0 +1,2 @@
+/** The turn and mirror buttons and the straightening slider. */
+export declare function CropOrientation(): import("react").JSX.Element;

package/dist/lib/components/ui/media/image-editor/partials/editor-export-options.d.ts

@@ -0,0 +1,2 @@
+/** The format, quality (lossy formats only) and size radio groups of the export menu. */
+export declare function EditorExportOptions(): import("react").JSX.Element;

package/dist/lib/components/ui/media/image-editor/partials/editor-file-info.d.ts

@@ -0,0 +1,2 @@
+/** The file name and the original size, shown in the middle of the top bar. */
+export declare function EditorFileInfo(): import("react").JSX.Element;

package/dist/lib/components/ui/media/image-editor/partials/editor-history-buttons.d.ts

@@ -0,0 +1,2 @@
+/** Undo, Redo and Reset all. */
+export declare function EditorHistoryButtons(): import("react").JSX.Element;

package/dist/lib/components/ui/media/image-editor/partials/markup-brush-section.d.ts

@@ -0,0 +1,2 @@
+/** The colour, size and fill / background switches of the next (or selected) mark. */
+export declare function MarkupBrushSection(): import("react").JSX.Element;

package/dist/lib/components/ui/media/image-editor/partials/markup-tool-picker.d.ts

@@ -0,0 +1,2 @@
+/** The row of drawing tools. */
+export declare function MarkupToolPicker(): import("react").JSX.Element;

package/dist/lib/components/ui/media/image-editor/types-edits.d.ts

@@ -0,0 +1,106 @@
+/** Light and colour, each centred on 0 (no change) unless noted. */
+export type ImageEditorAdjustments = {
+    /** −100…100 */
+    exposure: number;
+    /** −100…100 */
+    brightness: number;
+    /** −100…100 */
+    contrast: number;
+    /** −100…100: brightens (or darkens) the light tones only. */
+    highlights: number;
+    /** −100…100: brightens (or darkens) the dark tones only. */
+    shadows: number;
+    /** −100…100 */
+    saturation: number;
+    /** −100…100: saturation that spares the colours already saturated. */
+    vibrance: number;
+    /** −100…100: cool (blue) to warm (amber). */
+    warmth: number;
+    /** −100…100: green to magenta. */
+    tint: number;
+    /** −180…180 degrees around the colour wheel. */
+    hue: number;
+    /** 0…100: lifts the blacks and dims the whites (a matte look). */
+    fade: number;
+    /** 0…100: the brown tone of old prints. */
+    sepia: number;
+    /** 0…100: darkens the corners. */
+    vignette: number;
+    /** 0…100: film grain. */
+    grain: number;
+    /** 0…100: a Gaussian blur, scaled with the image. */
+    blur: number;
+};
+export type ImageEditorAdjustmentKey = keyof ImageEditorAdjustments;
+/** A rectangle in the oriented image, every value a fraction (0…1). */
+export type ImageEditorRect = {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+};
+/** Turns of 90° clockwise, then the mirror, then a small straightening tilt. */
+export type ImageEditorTransform = {
+    /** 0, 1, 2 or 3 quarter turns clockwise. */
+    quarterTurns: number;
+    flipX: boolean;
+    flipY: boolean;
+    /** −45…45 degrees; the image is scaled up so no corner shows empty. */
+    straighten: number;
+};
+type AnnotationBase = {
+    id: string;
+    color: string;
+    size: number;
+};
+/**
+ * A mark drawn over the image. Coordinates are fractions of the oriented
+ * image (before the crop), so a mark stays on what it points at whatever
+ * the crop; `size` is a fraction of the image's shorter side.
+ */
+export type ImageEditorAnnotation = (AnnotationBase & {
+    kind: 'pen' | 'highlighter';
+    /** Flat list of x, y pairs. */
+    points: number[];
+}) | (AnnotationBase & {
+    kind: 'line' | 'arrow';
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+}) | (AnnotationBase & ImageEditorRect & {
+    kind: 'rect' | 'ellipse';
+    fill: boolean;
+}) | (AnnotationBase & ImageEditorRect & {
+    kind: 'redact';
+}) | (AnnotationBase & {
+    kind: 'text';
+    x: number;
+    y: number;
+    text: string;
+    /** Draws the text on a rounded plate of the contrasting colour. */
+    background: boolean;
+});
+export type ImageEditorAnnotationKind = ImageEditorAnnotation['kind'];
+/**
+ * Everything the user changed, non-destructively: the original image is
+ * never touched, and these edits can be stored and applied again
+ * (`defaultEdits`).
+ */
+export type ImageEditorEdits = {
+    adjustments: ImageEditorAdjustments;
+    /** A preset from `IMAGE_EDITOR_FILTERS`; `'none'` for the original look. */
+    filter: string;
+    /** 0…100: how much of the filter is applied. */
+    filterIntensity: number;
+    transform: ImageEditorTransform;
+    /** The kept part of the oriented image. */
+    crop: ImageEditorRect;
+    annotations: ImageEditorAnnotation[];
+};
+/** Edits to start from: any part may be left out, and is then neutral. */
+export type ImageEditorEditsInput = Partial<Omit<ImageEditorEdits, 'adjustments' | 'transform'>> & {
+    adjustments?: Partial<ImageEditorAdjustments>;
+    transform?: Partial<ImageEditorTransform>;
+};
+export {};

package/dist/lib/components/ui/media/image-editor/types-session.d.ts

@@ -0,0 +1,58 @@
+import { ImageEditorEdits } from './types-edits.js';
+/** The editor's panels, in the order the tool rail shows them. */
+export type ImageEditorTool = 'adjust' | 'filters' | 'crop' | 'markup';
+/** What a pointer does on the stage while the Markup panel is open. */
+export type ImageEditorMarkupTool = 'select' | 'pen' | 'highlighter' | 'eraser' | 'line' | 'arrow' | 'rect' | 'ellipse' | 'text' | 'redact';
+export type ImageEditorExportFormat = 'image/png' | 'image/jpeg' | 'image/webp';
+export type ImageEditorExportOptions = {
+    format: ImageEditorExportFormat;
+    /** 0…1, for JPEG and WebP. */
+    quality: number;
+    /** Fraction of the cropped size, 0.1…1. */
+    scale: number;
+};
+export type ImageEditorResult = {
+    blob: Blob;
+    file: File;
+    width: number;
+    height: number;
+    edits: ImageEditorEdits;
+};
+/** The pen, shape and text settings the next mark is drawn with. */
+export type ImageEditorBrush = {
+    color: string;
+    /** Fraction of the image's shorter side. */
+    size: number;
+    fill: boolean;
+    background: boolean;
+};
+/** A crop ratio: `null` is free, `'original'` keeps the image's own. */
+export type ImageEditorAspect = number | 'original' | null;
+export type ImageEditorAspectPreset = {
+    id: string;
+    label: string;
+    value: ImageEditorAspect;
+};
+export type ImageEditorChromeState = {
+    edits: ImageEditorEdits;
+    past: ImageEditorEdits[];
+    future: ImageEditorEdits[];
+    /** The gesture the last history entry belongs to; a slider drag is one. */
+    historyGroup: string | null;
+    tool: ImageEditorTool;
+    markupTool: ImageEditorMarkupTool;
+    brush: ImageEditorBrush;
+    selectedId: string | null;
+    /** `null` fits the image to the stage. */
+    zoom: number | null;
+    /** Shows the original while held. */
+    comparing: boolean;
+    /** Shows the original and the result side by side, split by a handle. */
+    split: boolean;
+    aspect: ImageEditorAspect;
+    exportOptions: ImageEditorExportOptions;
+    /** The text mark being retyped: its drawn copy is hidden under the text box. */
+    editingId: string | null;
+    /** The keyboard shortcuts dialog. */
+    shortcutsOpen: boolean;
+};