react-native-image-editor-skia 0.1.0

package/lib/module/gestures/useEditorGestures.js

@@ -0,0 +1,285 @@
+"use strict";
+
+import { useMemo } from 'react';
+import { Gesture } from 'react-native-gesture-handler';
+import { runOnJS, useSharedValue } from 'react-native-reanimated';
+import { useEditor } from '../context/EditorContext';
+import { FREEHAND_MIN_DISTANCE, HANDLE_SIZE, HIT_SLOP } from '../constants';
+import { applyToPoint, distance, invert } from '../utils/math';
+import { annotationCenter } from '../annotations/geometry';
+import { hitTest } from './hitTest';
+import { selectionHandles } from './handles';
+import { applyTransformToAnnotation } from './applyTransform';
+import { makeArrow, makeCircle, makeFreehand, makeMarker, makeText } from './createAnnotation';
+function isDrawTool(tool) {
+  'worklet';
+
+  return tool === 'circle' || tool === 'arrow' || tool === 'marker' || tool === 'freehand';
+}
+
+/**
+ * A single composed Pan gesture over the canvas. It branches on the active tool
+ * and, in select mode, on where the touch began (rotate handle → rotate, corner
+ * handle → resize, body → move, empty → (de)select). All geometry math runs on
+ * the UI thread; only final commits hop to JS via runOnJS.
+ */
+export function useEditorGestures() {
+  const editor = useEditor();
+  const {
+    tool,
+    selectedId,
+    annotations,
+    matrix,
+    draw,
+    live,
+    strokeColor,
+    strokeWidth,
+    dispatch,
+    setSelectedId,
+    setEditingTextId
+  } = editor;
+  const invMatrix = useMemo(() => invert(matrix), [matrix]);
+  const scaleFactor = useMemo(() => Math.hypot(matrix.a, matrix.b) || 1, [matrix]);
+  const slopImage = HIT_SLOP / scaleFactor;
+
+  // Per-gesture UI-thread scratch state.
+  const mode = useSharedValue('none');
+  const startImg = useSharedValue({
+    x: 0,
+    y: 0
+  });
+  const startDist = useSharedValue(0);
+  const startAngle = useSharedValue(0);
+  const activeId = useSharedValue(null);
+
+  // ---- JS-thread commit callbacks --------------------------------------
+  const selectId = id => setSelectedId(id);
+  const commitCircle = (center, radius) => dispatch({
+    type: 'ADD_ANNOTATION',
+    annotation: makeCircle(center, radius, {
+      strokeColor,
+      strokeWidth
+    })
+  });
+  const commitArrow = (start, end) => dispatch({
+    type: 'ADD_ANNOTATION',
+    annotation: makeArrow(start, end, {
+      strokeColor,
+      strokeWidth
+    })
+  });
+  const commitMarker = rect => dispatch({
+    type: 'ADD_ANNOTATION',
+    annotation: makeMarker(rect, strokeColor)
+  });
+  const commitFreehand = points => dispatch({
+    type: 'ADD_ANNOTATION',
+    annotation: makeFreehand(points, {
+      strokeColor,
+      strokeWidth
+    })
+  });
+  const placeText = origin => {
+    const annotation = makeText(origin, editor.textColor);
+    dispatch({
+      type: 'ADD_ANNOTATION',
+      annotation
+    });
+    setSelectedId(annotation.id);
+    setEditingTextId(annotation.id);
+  };
+  const commitTransform = (id, vals) => {
+    if (!id) {
+      return;
+    }
+    // Skip no-op transforms (a plain tap) so they don't pollute history.
+    const identity = vals.tx === 0 && vals.ty === 0 && vals.rotate === 0 && vals.scale === 1;
+    if (identity) {
+      return;
+    }
+    const target = annotations.find(a => a.id === id);
+    if (!target) {
+      return;
+    }
+    const updated = applyTransformToAnnotation(target, vals);
+    dispatch({
+      type: 'UPDATE_ANNOTATION',
+      id,
+      changes: updated
+    });
+  };
+  const resetLive = () => {
+    live.active.value = false;
+    live.tx.value = 0;
+    live.ty.value = 0;
+    live.rotate.value = 0;
+    live.scale.value = 1;
+  };
+
+  // ---- The gesture ------------------------------------------------------
+  const pan = useMemo(() => {
+    return Gesture.Pan().maxPointers(1).onBegin(e => {
+      'worklet';
+
+      if (tool === 'crop') {
+        mode.value = 'none';
+        return;
+      }
+      const screen = {
+        x: e.x,
+        y: e.y
+      };
+      const img = applyToPoint(invMatrix, screen);
+      startImg.value = img;
+      activeId.value = selectedId;
+      if (isDrawTool(tool)) {
+        mode.value = 'draw';
+        draw.active.value = true;
+        draw.start.value = img;
+        draw.current.value = img;
+        if (tool === 'freehand') {
+          draw.points.value = [img];
+        }
+        return;
+      }
+      if (tool === 'text') {
+        mode.value = 'text';
+        return;
+      }
+
+      // select tool: figure out what was grabbed.
+      const sel = selectedId ? annotations.find(a => a.id === selectedId) : undefined;
+      if (sel) {
+        const h = selectionHandles(sel, matrix);
+        const center = annotationCenter(sel);
+        if (distance(screen, h.rotate) <= HANDLE_SIZE * 1.5) {
+          mode.value = 'rotate';
+          live.origin.value = center;
+          live.active.value = true;
+          startAngle.value = Math.atan2(img.y - center.y, img.x - center.x);
+          return;
+        }
+        for (let i = 0; i < h.corners.length; i++) {
+          if (distance(screen, h.corners[i]) <= HANDLE_SIZE * 1.5) {
+            mode.value = 'resize';
+            live.origin.value = center;
+            live.active.value = true;
+            startDist.value = distance(center, img);
+            return;
+          }
+        }
+        // Body of the selected annotation → move it.
+        if (hitTest([sel], img, slopImage) === sel.id) {
+          mode.value = 'move';
+          live.origin.value = center;
+          live.active.value = true;
+          return;
+        }
+      }
+
+      // Otherwise (de)select whatever is under the touch.
+      const hitId = hitTest(annotations, img, slopImage);
+      runOnJS(selectId)(hitId);
+      activeId.value = hitId;
+      if (hitId) {
+        const target = annotations.find(a => a.id === hitId);
+        mode.value = 'move';
+        live.origin.value = annotationCenter(target);
+        live.active.value = true;
+      } else {
+        mode.value = 'none';
+      }
+    }).onChange(e => {
+      'worklet';
+
+      const screen = {
+        x: e.x,
+        y: e.y
+      };
+      const img = applyToPoint(invMatrix, screen);
+      switch (mode.value) {
+        case 'draw':
+          if (tool === 'freehand') {
+            const pts = draw.points.value;
+            const last = pts[pts.length - 1];
+            if (!last || distance(last, img) >= FREEHAND_MIN_DISTANCE) {
+              draw.points.value = [...pts, img];
+            }
+          } else {
+            draw.current.value = img;
+          }
+          break;
+        case 'move':
+          live.tx.value = img.x - startImg.value.x;
+          live.ty.value = img.y - startImg.value.y;
+          break;
+        case 'resize':
+          live.scale.value = startDist.value > 0 ? distance(live.origin.value, img) / startDist.value : 1;
+          break;
+        case 'rotate':
+          {
+            const ang = Math.atan2(img.y - live.origin.value.y, img.x - live.origin.value.x);
+            live.rotate.value = ang - startAngle.value;
+            break;
+          }
+        default:
+          break;
+      }
+    }).onEnd(() => {
+      'worklet';
+
+      if (mode.value === 'draw') {
+        draw.active.value = false;
+        const s = draw.start.value;
+        const c = draw.current.value;
+        if (tool === 'circle') {
+          const r = distance(s, c);
+          if (r > 2) runOnJS(commitCircle)(s, r);
+        } else if (tool === 'arrow') {
+          if (distance(s, c) > 2) runOnJS(commitArrow)(s, c);
+        } else if (tool === 'marker') {
+          const rect = {
+            x: Math.min(s.x, c.x),
+            y: Math.min(s.y, c.y),
+            width: Math.abs(c.x - s.x),
+            height: Math.abs(c.y - s.y)
+          };
+          if (rect.width > 2 && rect.height > 2) runOnJS(commitMarker)(rect);
+        } else if (tool === 'freehand') {
+          const pts = draw.points.value;
+          if (pts.length > 1) runOnJS(commitFreehand)(pts);
+          draw.points.value = [];
+        }
+        mode.value = 'none';
+        return;
+      }
+      if (mode.value === 'text') {
+        runOnJS(placeText)(startImg.value);
+        mode.value = 'none';
+        return;
+      }
+      if (mode.value === 'move' || mode.value === 'resize' || mode.value === 'rotate') {
+        const vals = {
+          tx: live.tx.value,
+          ty: live.ty.value,
+          rotate: live.rotate.value,
+          scale: live.scale.value,
+          origin: live.origin.value
+        };
+        runOnJS(commitTransform)(activeId.value, vals);
+        runOnJS(resetLive)();
+        mode.value = 'none';
+      }
+    }).onFinalize(() => {
+      'worklet';
+
+      // Safety: ensure draw preview is cleared if the gesture is cancelled.
+      if (draw.active.value && mode.value !== 'draw') {
+        draw.active.value = false;
+      }
+    });
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [tool, selectedId, annotations, matrix, strokeColor, strokeWidth]);
+  return pan;
+}
+//# sourceMappingURL=useEditorGestures.js.map

package/lib/module/gestures/useEditorGestures.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useMemo","Gesture","runOnJS","useSharedValue","useEditor","FREEHAND_MIN_DISTANCE","HANDLE_SIZE","HIT_SLOP","applyToPoint","distance","invert","annotationCenter","hitTest","selectionHandles","applyTransformToAnnotation","makeArrow","makeCircle","makeFreehand","makeMarker","makeText","isDrawTool","tool","useEditorGestures","editor","selectedId","annotations","matrix","draw","live","strokeColor","strokeWidth","dispatch","setSelectedId","setEditingTextId","invMatrix","scaleFactor","Math","hypot","a","b","slopImage","mode","startImg","x","y","startDist","startAngle","activeId","selectId","id","commitCircle","center","radius","type","annotation","commitArrow","start","end","commitMarker","rect","commitFreehand","points","placeText","origin","textColor","commitTransform","vals","identity","tx","ty","rotate","scale","target","find","updated","changes","resetLive","active","value","pan","Pan","maxPointers","onBegin","e","screen","img","current","sel","undefined","h","atan2","i","corners","length","hitId","onChange","pts","last","ang","onEnd","s","c","r","min","width","abs","height","onFinalize"],"sourceRoot":"..\\..\\..\\src","sources":["gestures/useEditorGestures.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/image/disposeRegistry.js

@@ -0,0 +1,57 @@
+"use strict";
+
+/**
+ * Tracks Skia native objects (SkImage / SkData / SkSurface / SkParagraph …) so
+ * they can be released deterministically. Skia objects are JSI HostObjects; the
+ * Hermes GC under-counts their native footprint and may never collect them, so
+ * we must call `.dispose()` explicitly. This registry is a safety net: register
+ * anything created imperatively, and `flush()` on unmount to guarantee cleanup.
+ */
+
+export class DisposeRegistry {
+  items = new Set();
+
+  /** Track an object and return it for convenient chaining. */
+  add(item) {
+    this.items.add(item);
+    return item;
+  }
+
+  /** Stop tracking without disposing (e.g. ownership handed elsewhere). */
+  forget(item) {
+    this.items.delete(item);
+  }
+
+  /** Dispose a single tracked object now. */
+  release(item) {
+    if (!item) {
+      return;
+    }
+    this.items.delete(item);
+    safeDispose(item);
+  }
+
+  /** Dispose everything still tracked. Call on unmount. */
+  flush() {
+    for (const item of this.items) {
+      safeDispose(item);
+    }
+    this.items.clear();
+  }
+  get size() {
+    return this.items.size;
+  }
+}
+
+/** Dispose without throwing if the object was already released. */
+export function safeDispose(item) {
+  if (!item) {
+    return;
+  }
+  try {
+    item.dispose();
+  } catch {
+    // Already disposed or not a real disposable — ignore.
+  }
+}
+//# sourceMappingURL=disposeRegistry.js.map

package/lib/module/image/disposeRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["DisposeRegistry","items","Set","add","item","forget","delete","release","safeDispose","flush","clear","size","dispose"],"sourceRoot":"..\\..\\..\\src","sources":["image/disposeRegistry.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;;AAMA,OAAO,MAAMA,eAAe,CAAC;EACnBC,KAAK,GAAG,IAAIC,GAAG,CAAa,CAAC;;EAErC;EACAC,GAAGA,CAAuBC,IAAO,EAAK;IACpC,IAAI,CAACH,KAAK,CAACE,GAAG,CAACC,IAAI,CAAC;IACpB,OAAOA,IAAI;EACb;;EAEA;EACAC,MAAMA,CAACD,IAAgB,EAAQ;IAC7B,IAAI,CAACH,KAAK,CAACK,MAAM,CAACF,IAAI,CAAC;EACzB;;EAEA;EACAG,OAAOA,CAACH,IAAmC,EAAQ;IACjD,IAAI,CAACA,IAAI,EAAE;MACT;IACF;IACA,IAAI,CAACH,KAAK,CAACK,MAAM,CAACF,IAAI,CAAC;IACvBI,WAAW,CAACJ,IAAI,CAAC;EACnB;;EAEA;EACAK,KAAKA,CAAA,EAAS;IACZ,KAAK,MAAML,IAAI,IAAI,IAAI,CAACH,KAAK,EAAE;MAC7BO,WAAW,CAACJ,IAAI,CAAC;IACnB;IACA,IAAI,CAACH,KAAK,CAACS,KAAK,CAAC,CAAC;EACpB;EAEA,IAAIC,IAAIA,CAAA,EAAW;IACjB,OAAO,IAAI,CAACV,KAAK,CAACU,IAAI;EACxB;AACF;;AAEA;AACA,OAAO,SAASH,WAAWA,CAACJ,IAAmC,EAAQ;EACrE,IAAI,CAACA,IAAI,EAAE;IACT;EACF;EACA,IAAI;IACFA,IAAI,CAACQ,OAAO,CAAC,CAAC;EAChB,CAAC,CAAC,MAAM;IACN;EAAA;AAEJ","ignoreList":[]}

package/lib/module/image/useLoadedImage.js

@@ -0,0 +1,117 @@
+"use strict";
+
+import { useEffect, useRef, useState } from 'react';
+import { Skia } from '@shopify/react-native-skia';
+import { safeDispose } from './disposeRegistry';
+function stripDataUri(base64) {
+  const comma = base64.indexOf(',');
+  if (base64.startsWith('data:') && comma !== -1) {
+    return base64.slice(comma + 1);
+  }
+  return base64;
+}
+
+/**
+ * Decode an {@link ImageSource} into an `SkImage`, managing native memory.
+ *
+ * Memory rules enforced here:
+ *  - The encoded `SkData` is disposed immediately after `MakeImageFromEncoded`;
+ *    the decoded `SkImage` owns its pixels, so retaining the encoded bytes would
+ *    roughly double memory usage.
+ *  - When `source` changes (or the component unmounts) the previous `SkImage` is
+ *    disposed before the next one is created.
+ *  - The input base64 string is consumed inside the effect and never copied into
+ *    state, so a large payload is not retained by this hook.
+ */
+export function useLoadedImage(source) {
+  const [state, setState] = useState({
+    image: null,
+    width: 0,
+    height: 0,
+    loading: true,
+    error: null
+  });
+
+  // Serialize the source so the effect re-runs only on a real change, without
+  // holding the (possibly huge) base64 string in a memoized ref.
+  const sourceKey = 'base64' in source ? `b64:${source.base64.length}:${source.base64.slice(-64)}` : `uri:${source.uri}`;
+  const currentImage = useRef(null);
+  useEffect(() => {
+    let cancelled = false;
+    const commit = image => {
+      if (cancelled) {
+        // A newer load superseded us — drop this result.
+        safeDispose(image);
+        return;
+      }
+      // Dispose the previous image before swapping in the new one.
+      if (currentImage.current && currentImage.current !== image) {
+        safeDispose(currentImage.current);
+      }
+      currentImage.current = image;
+      setState({
+        image,
+        width: image.width(),
+        height: image.height(),
+        loading: false,
+        error: null
+      });
+    };
+    const fail = error => {
+      if (cancelled) {
+        return;
+      }
+      setState(prev => ({
+        ...prev,
+        loading: false,
+        error
+      }));
+    };
+    setState(prev => ({
+      ...prev,
+      loading: true,
+      error: null
+    }));
+    try {
+      if ('base64' in source) {
+        const data = Skia.Data.fromBase64(stripDataUri(source.base64));
+        const image = Skia.Image.MakeImageFromEncoded(data);
+        safeDispose(data); // decoded pixels are owned by `image` now
+        if (!image) {
+          throw new Error('Failed to decode image from base64.');
+        }
+        commit(image);
+      } else {
+        // fromURI is async (may fetch a remote/local file).
+        Skia.Data.fromURI(source.uri).then(data => {
+          if (cancelled) {
+            safeDispose(data);
+            return;
+          }
+          const image = Skia.Image.MakeImageFromEncoded(data);
+          safeDispose(data);
+          if (!image) {
+            throw new Error(`Failed to decode image from URI: ${source.uri}`);
+          }
+          commit(image);
+        }).catch(e => fail(e instanceof Error ? e : new Error(String(e))));
+      }
+    } catch (e) {
+      fail(e instanceof Error ? e : new Error(String(e)));
+    }
+    return () => {
+      cancelled = true;
+    };
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [sourceKey]);
+
+  // Final safety net: dispose the last image when the hook unmounts.
+  useEffect(() => {
+    return () => {
+      safeDispose(currentImage.current);
+      currentImage.current = null;
+    };
+  }, []);
+  return state;
+}
+//# sourceMappingURL=useLoadedImage.js.map

package/lib/module/image/useLoadedImage.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useEffect","useRef","useState","Skia","safeDispose","stripDataUri","base64","comma","indexOf","startsWith","slice","useLoadedImage","source","state","setState","image","width","height","loading","error","sourceKey","length","uri","currentImage","cancelled","commit","current","fail","prev","data","Data","fromBase64","Image","MakeImageFromEncoded","Error","fromURI","then","catch","e","String"],"sourceRoot":"..\\..\\..\\src","sources":["image/useLoadedImage.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/index.js

@@ -0,0 +1,8 @@
+"use strict";
+
+export { ImageEditor } from './ImageEditor';
+// Advanced: build a custom UI on top of the editor state/context.
+export { EditorProvider, useEditor } from './context/EditorContext';
+export { exportImage } from './export/exportImage';
+export { DEFAULT_PALETTE, DEFAULT_STROKE_COLOR, DEFAULT_TEXT_COLOR } from './constants';
+//# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["ImageEditor","EditorProvider","useEditor","exportImage","DEFAULT_PALETTE","DEFAULT_STROKE_COLOR","DEFAULT_TEXT_COLOR"],"sourceRoot":"..\\..\\src","sources":["index.ts"],"mappings":";;AAAA,SAASA,WAAW,QAAQ,eAAe;AAuB3C;AACA,SAASC,cAAc,EAAEC,SAAS,QAAQ,yBAAyB;AACnE,SAASC,WAAW,QAAQ,sBAAsB;AAElD,SACEC,eAAe,EACfC,oBAAoB,EACpBC,kBAAkB,QACb,aAAa","ignoreList":[]}

package/lib/module/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/lib/module/state/history.js

@@ -0,0 +1,76 @@
+"use strict";
+
+import { MAX_HISTORY } from '../constants';
+
+/**
+ * Generic, pure undo/redo history over an immutable document `T`.
+ * Snapshots are cheap here because the document is plain JSON (annotations +
+ * scene transform) — it never contains image bytes.
+ */
+
+export function initHistory(present) {
+  return {
+    past: [],
+    present,
+    future: []
+  };
+}
+
+/** Replace the present, pushing the old present onto the undo stack. */
+export function commit(history, next) {
+  if (next === history.present) {
+    return history;
+  }
+  const past = [...history.past, history.present];
+  // Cap the depth to bound memory.
+  if (past.length > MAX_HISTORY) {
+    past.shift();
+  }
+  return {
+    past,
+    present: next,
+    future: []
+  };
+}
+
+/**
+ * Replace the present WITHOUT creating a history entry — used for live edits
+ * (e.g. typing in a text box) that should collapse into the eventual commit.
+ */
+export function replacePresent(history, next) {
+  return {
+    ...history,
+    present: next
+  };
+}
+export function undo(history) {
+  if (history.past.length === 0) {
+    return history;
+  }
+  const previous = history.past[history.past.length - 1];
+  const past = history.past.slice(0, -1);
+  return {
+    past,
+    present: previous,
+    future: [history.present, ...history.future]
+  };
+}
+export function redo(history) {
+  if (history.future.length === 0) {
+    return history;
+  }
+  const next = history.future[0];
+  const future = history.future.slice(1);
+  return {
+    past: [...history.past, history.present],
+    present: next,
+    future
+  };
+}
+export function canUndo(history) {
+  return history.past.length > 0;
+}
+export function canRedo(history) {
+  return history.future.length > 0;
+}
+//# sourceMappingURL=history.js.map

package/lib/module/state/history.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["MAX_HISTORY","initHistory","present","past","future","commit","history","next","length","shift","replacePresent","undo","previous","slice","redo","canUndo","canRedo"],"sourceRoot":"..\\..\\..\\src","sources":["state/history.ts"],"mappings":";;AAAA,SAASA,WAAW,QAAQ,cAAc;;AAE1C;AACA;AACA;AACA;AACA;;AAOA,OAAO,SAASC,WAAWA,CAAIC,OAAU,EAAc;EACrD,OAAO;IAAEC,IAAI,EAAE,EAAE;IAAED,OAAO;IAAEE,MAAM,EAAE;EAAG,CAAC;AAC1C;;AAEA;AACA,OAAO,SAASC,MAAMA,CAAIC,OAAmB,EAAEC,IAAO,EAAc;EAClE,IAAIA,IAAI,KAAKD,OAAO,CAACJ,OAAO,EAAE;IAC5B,OAAOI,OAAO;EAChB;EACA,MAAMH,IAAI,GAAG,CAAC,GAAGG,OAAO,CAACH,IAAI,EAAEG,OAAO,CAACJ,OAAO,CAAC;EAC/C;EACA,IAAIC,IAAI,CAACK,MAAM,GAAGR,WAAW,EAAE;IAC7BG,IAAI,CAACM,KAAK,CAAC,CAAC;EACd;EACA,OAAO;IAAEN,IAAI;IAAED,OAAO,EAAEK,IAAI;IAAEH,MAAM,EAAE;EAAG,CAAC;AAC5C;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASM,cAAcA,CAAIJ,OAAmB,EAAEC,IAAO,EAAc;EAC1E,OAAO;IAAE,GAAGD,OAAO;IAAEJ,OAAO,EAAEK;EAAK,CAAC;AACtC;AAEA,OAAO,SAASI,IAAIA,CAAIL,OAAmB,EAAc;EACvD,IAAIA,OAAO,CAACH,IAAI,CAACK,MAAM,KAAK,CAAC,EAAE;IAC7B,OAAOF,OAAO;EAChB;EACA,MAAMM,QAAQ,GAAGN,OAAO,CAACH,IAAI,CAACG,OAAO,CAACH,IAAI,CAACK,MAAM,GAAG,CAAC,CAAE;EACvD,MAAML,IAAI,GAAGG,OAAO,CAACH,IAAI,CAACU,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;EACtC,OAAO;IACLV,IAAI;IACJD,OAAO,EAAEU,QAAQ;IACjBR,MAAM,EAAE,CAACE,OAAO,CAACJ,OAAO,EAAE,GAAGI,OAAO,CAACF,MAAM;EAC7C,CAAC;AACH;AAEA,OAAO,SAASU,IAAIA,CAAIR,OAAmB,EAAc;EACvD,IAAIA,OAAO,CAACF,MAAM,CAACI,MAAM,KAAK,CAAC,EAAE;IAC/B,OAAOF,OAAO;EAChB;EACA,MAAMC,IAAI,GAAGD,OAAO,CAACF,MAAM,CAAC,CAAC,CAAE;EAC/B,MAAMA,MAAM,GAAGE,OAAO,CAACF,MAAM,CAACS,KAAK,CAAC,CAAC,CAAC;EACtC,OAAO;IACLV,IAAI,EAAE,CAAC,GAAGG,OAAO,CAACH,IAAI,EAAEG,OAAO,CAACJ,OAAO,CAAC;IACxCA,OAAO,EAAEK,IAAI;IACbH;EACF,CAAC;AACH;AAEA,OAAO,SAASW,OAAOA,CAAIT,OAAmB,EAAW;EACvD,OAAOA,OAAO,CAACH,IAAI,CAACK,MAAM,GAAG,CAAC;AAChC;AAEA,OAAO,SAASQ,OAAOA,CAAIV,OAAmB,EAAW;EACvD,OAAOA,OAAO,CAACF,MAAM,CAACI,MAAM,GAAG,CAAC;AAClC","ignoreList":[]}

package/lib/module/state/selectors.js

@@ -0,0 +1,14 @@
+"use strict";
+
+export function getAnnotationById(annotations, id) {
+  if (!id) {
+    return undefined;
+  }
+  return annotations.find(a => a.id === id);
+}
+
+/** Annotations in paint order (ascending z). */
+export function sortedByZ(annotations) {
+  return [...annotations].sort((a, b) => a.z - b.z);
+}
+//# sourceMappingURL=selectors.js.map

package/lib/module/state/selectors.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["getAnnotationById","annotations","id","undefined","find","a","sortedByZ","sort","b","z"],"sourceRoot":"..\\..\\..\\src","sources":["state/selectors.ts"],"mappings":";;AAEA,OAAO,SAASA,iBAAiBA,CAC/BC,WAAyB,EACzBC,EAAiB,EACO;EACxB,IAAI,CAACA,EAAE,EAAE;IACP,OAAOC,SAAS;EAClB;EACA,OAAOF,WAAW,CAACG,IAAI,CAAEC,CAAC,IAAKA,CAAC,CAACH,EAAE,KAAKA,EAAE,CAAC;AAC7C;;AAEA;AACA,OAAO,SAASI,SAASA,CAACL,WAAyB,EAAgB;EACjE,OAAO,CAAC,GAAGA,WAAW,CAAC,CAACM,IAAI,CAAC,CAACF,CAAC,EAAEG,CAAC,KAAKH,CAAC,CAACI,CAAC,GAAGD,CAAC,CAACC,CAAC,CAAC;AACnD","ignoreList":[]}