@kesha-antonov/react-native-chat 5.0.1 → 6.0.1

package/lib/components/floatingNoteMath.js

@@ -0,0 +1,143 @@
+/*
+ * Geometry of the floating round note:
+ * where it docks, how far a drag may take it, and where it settles - or
+ * whether it slides out and closes - when the finger lifts. Kept free of React
+ * so it runs on the UI thread inside the drag gesture and under Jest alike.
+ */
+
+/** The floating circle is 120dp. */
+export const FLOATING_NOTE_SIZE = 120;
+/** Distance kept from the edges it docks to (`getSideCoord`). */
+export const FLOATING_NOTE_MARGIN = 10;
+/** Released this close to an edge, it snaps onto it (`animateToBoundsMaybe`). */
+export const FLOATING_NOTE_SNAP = 20;
+/** Show, hide and settle all run 150ms with a decelerate curve. */
+export const FLOATING_NOTE_MS = 150;
+/** It appears from, and shrinks back to, 80% of its size. */
+export const FLOATING_NOTE_HIDDEN_SCALE = 0.8;
+/**
+ * How far ahead a release's velocity carries it, in seconds. Deciding on
+ * the lift position alone feels stuck; projecting a little lets a flick reach an edge
+ * (or fly off it) the way a flick does everywhere else on the platform.
+ */
+export const FLOATING_NOTE_FLING_S = 0.1;
+
+/** Which edge it is docked to on one axis, or `free` in between. */
+
+/**
+ * A remembered position that survives the area resizing: the side per axis,
+ * or the fraction across it.
+ */
+
+/** The first position: the top right corner. */
+export const DEFAULT_FLOATING_DOCK = {
+  sideX: 'end',
+  px: 0,
+  sideY: 'start',
+  py: 0
+};
+/** One axis of `getSideCoord`: `room` is the area's length less the note's. */
+export const sideCoord = (side, fraction, room) => {
+  'worklet';
+
+  if (side === 'start') return FLOATING_NOTE_MARGIN;
+  if (side === 'end') return room - FLOATING_NOTE_MARGIN;
+  return Math.round((room - FLOATING_NOTE_MARGIN * 2) * fraction) + FLOATING_NOTE_MARGIN;
+};
+export const dockPoint = (dock, area, size = FLOATING_NOTE_SIZE) => {
+  'worklet';
+
+  return {
+    x: sideCoord(dock.sideX, dock.px, area.width - size),
+    y: sideCoord(dock.sideY, dock.py, area.height - size)
+  };
+};
+
+/**
+ * Where a drag may take it: up to half its width past either side, which is
+ * how it gets thrown away, but never past the top or bottom.
+ */
+export const clampDrag = (x, y, area, size = FLOATING_NOTE_SIZE) => {
+  'worklet';
+
+  const overshoot = size / 2;
+  return {
+    x: Math.min(Math.max(x, -overshoot), area.width - size + overshoot),
+    y: Math.min(Math.max(y, 0), Math.max(0, area.height - size))
+  };
+};
+
+/** Past a side it fades, down to half at the furthest it may go. */
+export const dragAlpha = (x, width, size = FLOATING_NOTE_SIZE) => {
+  'worklet';
+
+  const overshoot = size / 2;
+  if (x < 0) return 1 + x / overshoot * 0.5;
+  if (x > width - size) return 1 - (x - width + size) / overshoot * 0.5;
+  return 1;
+};
+const fraction = (value, from, to) => {
+  'worklet';
+
+  return to === from ? 0 : Math.min(1, Math.max(0, (value - from) / (to - from)));
+};
+
+/**
+ * Where it goes when the finger lifts (`animateToBoundsMaybe`): onto a side
+ * when within 20dp of its docked spot or less than a quarter past the edge;
+ * out and closed when dragged further past it; otherwise it stays where it was
+ * put. Vertically it snaps to the top or bottom spot within 20dp, or stays.
+ */
+export const settleFloatingNote = (x, y, velocityX, area, dock, size = FLOATING_NOTE_SIZE) => {
+  'worklet';
+
+  const flung = clampDrag(x + velocityX * FLOATING_NOTE_FLING_S, y, area, size).x;
+  const startX = sideCoord('start', 0, area.width - size);
+  const endX = sideCoord('end', 0, area.width - size);
+  const startY = sideCoord('start', 0, area.height - size);
+  const endY = sideCoord('end', 0, area.height - size);
+  const quarter = size / 4;
+  let nextX = flung;
+  let sideX = 'free';
+  let px = fraction(flung, startX, endX);
+  if (Math.abs(startX - flung) <= FLOATING_NOTE_SNAP || flung < 0 && flung > -quarter) {
+    nextX = startX;
+    sideX = 'start';
+    px = 0;
+  } else if (Math.abs(endX - flung) <= FLOATING_NOTE_SNAP || flung > area.width - size && flung < area.width - size + quarter) {
+    nextX = endX;
+    sideX = 'end';
+    px = 0;
+  } else if (dragAlpha(flung, area.width, size) !== 1) {
+    return {
+      x: flung < 0 ? -size : area.width,
+      y,
+      isClosing: true,
+      dock
+    };
+  }
+  let nextY = y;
+  let sideY = 'free';
+  let py = fraction(y, startY, endY);
+  if (Math.abs(startY - y) <= FLOATING_NOTE_SNAP || y <= startY) {
+    nextY = startY;
+    sideY = 'start';
+    py = 0;
+  } else if (Math.abs(endY - y) <= FLOATING_NOTE_SNAP || y >= endY) {
+    nextY = endY;
+    sideY = 'end';
+    py = 0;
+  }
+  return {
+    x: nextX,
+    y: nextY,
+    isClosing: false,
+    dock: {
+      sideX,
+      px,
+      sideY,
+      py
+    }
+  };
+};
+//# sourceMappingURL=floatingNoteMath.js.map

package/lib/components/floatingNoteMath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"floatingNoteMath.js","names":["FLOATING_NOTE_SIZE","FLOATING_NOTE_MARGIN","FLOATING_NOTE_SNAP","FLOATING_NOTE_MS","FLOATING_NOTE_HIDDEN_SCALE","FLOATING_NOTE_FLING_S","DEFAULT_FLOATING_DOCK","sideX","px","sideY","py","sideCoord","side","fraction","room","Math","round","dockPoint","dock","area","size","x","width","y","height","clampDrag","overshoot","min","max","dragAlpha","value","from","to","settleFloatingNote","velocityX","flung","startX","endX","startY","endY","quarter","nextX","abs","isClosing","nextY"],"sources":["../../src/components/floatingNoteMath.ts"],"sourcesContent":["/*\n * Geometry of the floating round note:\n * where it docks, how far a drag may take it, and where it settles - or\n * whether it slides out and closes - when the finger lifts. Kept free of React\n * so it runs on the UI thread inside the drag gesture and under Jest alike.\n */\n\n/** The floating circle is 120dp. */\nexport const FLOATING_NOTE_SIZE = 120\n/** Distance kept from the edges it docks to (`getSideCoord`). */\nexport const FLOATING_NOTE_MARGIN = 10\n/** Released this close to an edge, it snaps onto it (`animateToBoundsMaybe`). */\nexport const FLOATING_NOTE_SNAP = 20\n/** Show, hide and settle all run 150ms with a decelerate curve. */\nexport const FLOATING_NOTE_MS = 150\n/** It appears from, and shrinks back to, 80% of its size. */\nexport const FLOATING_NOTE_HIDDEN_SCALE = 0.8\n/**\n * How far ahead a release's velocity carries it, in seconds. Deciding on\n * the lift position alone feels stuck; projecting a little lets a flick reach an edge\n * (or fly off it) the way a flick does everywhere else on the platform.\n */\nexport const FLOATING_NOTE_FLING_S = 0.1\n\n/** Which edge it is docked to on one axis, or `free` in between. */\nexport type DockSide = 'start' | 'end' | 'free'\n\n/**\n * A remembered position that survives the area resizing: the side per axis,\n * or the fraction across it.\n */\nexport interface FloatingDock {\n  sideX: DockSide\n  px: number\n  sideY: DockSide\n  py: number\n}\n\n/** The first position: the top right corner. */\nexport const DEFAULT_FLOATING_DOCK: FloatingDock = { sideX: 'end', px: 0, sideY: 'start', py: 0 }\n\nexport interface FloatingArea {\n  width: number\n  height: number\n}\n\n/** One axis of `getSideCoord`: `room` is the area's length less the note's. */\nexport const sideCoord = (side: DockSide, fraction: number, room: number) => {\n  'worklet'\n  if (side === 'start')\n    return FLOATING_NOTE_MARGIN\n  if (side === 'end')\n    return room - FLOATING_NOTE_MARGIN\n  return Math.round((room - FLOATING_NOTE_MARGIN * 2) * fraction) + FLOATING_NOTE_MARGIN\n}\n\nexport const dockPoint = (dock: FloatingDock, area: FloatingArea, size = FLOATING_NOTE_SIZE) => {\n  'worklet'\n  return {\n    x: sideCoord(dock.sideX, dock.px, area.width - size),\n    y: sideCoord(dock.sideY, dock.py, area.height - size),\n  }\n}\n\n/**\n * Where a drag may take it: up to half its width past either side, which is\n * how it gets thrown away, but never past the top or bottom.\n */\nexport const clampDrag = (x: number, y: number, area: FloatingArea, size = FLOATING_NOTE_SIZE) => {\n  'worklet'\n  const overshoot = size / 2\n  return {\n    x: Math.min(Math.max(x, -overshoot), area.width - size + overshoot),\n    y: Math.min(Math.max(y, 0), Math.max(0, area.height - size)),\n  }\n}\n\n/** Past a side it fades, down to half at the furthest it may go. */\nexport const dragAlpha = (x: number, width: number, size = FLOATING_NOTE_SIZE) => {\n  'worklet'\n  const overshoot = size / 2\n  if (x < 0)\n    return 1 + (x / overshoot) * 0.5\n  if (x > width - size)\n    return 1 - ((x - width + size) / overshoot) * 0.5\n  return 1\n}\n\nexport interface FloatingSettle {\n  x: number\n  y: number\n  /** It slides out past a side; playback stops once it is gone. */\n  isClosing: boolean\n  /** The position to remember, unchanged when closing. */\n  dock: FloatingDock\n}\n\nconst fraction = (value: number, from: number, to: number) => {\n  'worklet'\n  return to === from ? 0 : Math.min(1, Math.max(0, (value - from) / (to - from)))\n}\n\n/**\n * Where it goes when the finger lifts (`animateToBoundsMaybe`): onto a side\n * when within 20dp of its docked spot or less than a quarter past the edge;\n * out and closed when dragged further past it; otherwise it stays where it was\n * put. Vertically it snaps to the top or bottom spot within 20dp, or stays.\n */\nexport const settleFloatingNote = (\n  x: number,\n  y: number,\n  velocityX: number,\n  area: FloatingArea,\n  dock: FloatingDock,\n  size = FLOATING_NOTE_SIZE\n): FloatingSettle => {\n  'worklet'\n  const flung = clampDrag(x + velocityX * FLOATING_NOTE_FLING_S, y, area, size).x\n  const startX = sideCoord('start', 0, area.width - size)\n  const endX = sideCoord('end', 0, area.width - size)\n  const startY = sideCoord('start', 0, area.height - size)\n  const endY = sideCoord('end', 0, area.height - size)\n  const quarter = size / 4\n\n  let nextX = flung\n  let sideX: DockSide = 'free'\n  let px = fraction(flung, startX, endX)\n  if (Math.abs(startX - flung) <= FLOATING_NOTE_SNAP || (flung < 0 && flung > -quarter)) {\n    nextX = startX\n    sideX = 'start'\n    px = 0\n  } else if (\n    Math.abs(endX - flung) <= FLOATING_NOTE_SNAP ||\n    (flung > area.width - size && flung < area.width - size + quarter)\n  ) {\n    nextX = endX\n    sideX = 'end'\n    px = 0\n  } else if (dragAlpha(flung, area.width, size) !== 1) {\n    return { x: flung < 0 ? -size : area.width, y, isClosing: true, dock }\n  }\n\n  let nextY = y\n  let sideY: DockSide = 'free'\n  let py = fraction(y, startY, endY)\n  if (Math.abs(startY - y) <= FLOATING_NOTE_SNAP || y <= startY) {\n    nextY = startY\n    sideY = 'start'\n    py = 0\n  } else if (Math.abs(endY - y) <= FLOATING_NOTE_SNAP || y >= endY) {\n    nextY = endY\n    sideY = 'end'\n    py = 0\n  }\n\n  return { x: nextX, y: nextY, isClosing: false, dock: { sideX, px, sideY, py } }\n}\n"],"mappings":"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","ignoreList":[]}

package/lib/components/haptics.d.ts

@@ -0,0 +1,5 @@
+/** An impact tick, or nothing when `expo-haptics` is missing. Never throws. */
+export declare const impactHaptic: (style?: "Light" | "Medium" | "Heavy") => void;
+/** The selection tick (`UISelectionFeedbackGenerator`), or nothing. Never throws. */
+export declare const selectionHaptic: () => void;
+//# sourceMappingURL=haptics.d.ts.map

package/lib/components/haptics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"haptics.d.ts","sourceRoot":"","sources":["../../src/components/haptics.ts"],"names":[],"mappings":"AAIA,+EAA+E;AAC/E,eAAO,MAAM,YAAY,GAAI,QAAO,OAAO,GAAG,QAAQ,GAAG,OAAiB,SAQzE,CAAA;AAED,qFAAqF;AACrF,eAAO,MAAM,eAAe,YAQ3B,CAAA"}

package/lib/components/haptics.js

@@ -0,0 +1,26 @@
+import { getExpoHaptics } from '../optional';
+
+// Optional haptics (`expo-haptics`), resolved on the first tick.
+
+/** An impact tick, or nothing when `expo-haptics` is missing. Never throws. */
+export const impactHaptic = (style = 'Light') => {
+  try {
+    const expoHaptics = getExpoHaptics();
+    const result = expoHaptics?.impactAsync?.(expoHaptics?.ImpactFeedbackStyle?.[style]);
+    result?.catch?.(() => {});
+  } catch {
+    // haptics are a nicety; never fail an interaction over them
+  }
+};
+
+/** The selection tick (`UISelectionFeedbackGenerator`), or nothing. Never throws. */
+export const selectionHaptic = () => {
+  try {
+    const expoHaptics = getExpoHaptics();
+    const result = expoHaptics?.selectionAsync?.();
+    result?.catch?.(() => {});
+  } catch {
+    // haptics are a nicety; never fail an interaction over them
+  }
+};
+//# sourceMappingURL=haptics.js.map

package/lib/components/haptics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"haptics.js","names":["getExpoHaptics","impactHaptic","style","expoHaptics","result","impactAsync","ImpactFeedbackStyle","catch","selectionHaptic","selectionAsync"],"sources":["../../src/components/haptics.ts"],"sourcesContent":["import { getExpoHaptics } from '../optional'\n\n// Optional haptics (`expo-haptics`), resolved on the first tick.\n\n/** An impact tick, or nothing when `expo-haptics` is missing. Never throws. */\nexport const impactHaptic = (style: 'Light' | 'Medium' | 'Heavy' = 'Light') => {\n  try {\n    const expoHaptics = getExpoHaptics()\n    const result = expoHaptics?.impactAsync?.(expoHaptics?.ImpactFeedbackStyle?.[style])\n    result?.catch?.(() => {})\n  } catch {\n    // haptics are a nicety; never fail an interaction over them\n  }\n}\n\n/** The selection tick (`UISelectionFeedbackGenerator`), or nothing. Never throws. */\nexport const selectionHaptic = () => {\n  try {\n    const expoHaptics = getExpoHaptics()\n    const result = expoHaptics?.selectionAsync?.()\n    result?.catch?.(() => {})\n  } catch {\n    // haptics are a nicety; never fail an interaction over them\n  }\n}\n"],"mappings":"AAAA,SAASA,cAAc,QAAQ,aAAa;;AAE5C;;AAEA;AACA,OAAO,MAAMC,YAAY,GAAGA,CAACC,KAAmC,GAAG,OAAO,KAAK;EAC7E,IAAI;IACF,MAAMC,WAAW,GAAGH,cAAc,CAAC,CAAC;IACpC,MAAMI,MAAM,GAAGD,WAAW,EAAEE,WAAW,GAAGF,WAAW,EAAEG,mBAAmB,GAAGJ,KAAK,CAAC,CAAC;IACpFE,MAAM,EAAEG,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC;EAC3B,CAAC,CAAC,MAAM;IACN;EAAA;AAEJ,CAAC;;AAED;AACA,OAAO,MAAMC,eAAe,GAAGA,CAAA,KAAM;EACnC,IAAI;IACF,MAAML,WAAW,GAAGH,cAAc,CAAC,CAAC;IACpC,MAAMI,MAAM,GAAGD,WAAW,EAAEM,cAAc,GAAG,CAAC;IAC9CL,MAAM,EAAEG,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC;EAC3B,CAAC,CAAC,MAAM;IACN;EAAA;AAEJ,CAAC","ignoreList":[]}

package/lib/components/mediaDownload.d.ts

@@ -0,0 +1,14 @@
+/** A remote `http(s)` source, which is fetched with progress before it is decoded. */
+export declare const isRemoteUri: (uri: string | undefined) => boolean;
+export interface Download {
+    promise: Promise<ArrayBuffer>;
+    abort: () => void;
+}
+/**
+ * Fetches `uri` into memory, reporting 0..1 as it arrives. `XMLHttpRequest` is
+ * the one React Native transport that reports download progress, which is what
+ * drives the ring on a voice note being fetched. `onProgress` is not
+ * called when the server sends no length.
+ */
+export declare const downloadWithProgress: (uri: string, onProgress: (fraction: number) => void) => Download;
+//# sourceMappingURL=mediaDownload.d.ts.map

package/lib/components/mediaDownload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mediaDownload.d.ts","sourceRoot":"","sources":["../../src/components/mediaDownload.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,eAAO,MAAM,WAAW,GAAI,KAAK,MAAM,GAAG,SAAS,YAAuC,CAAA;AAE1F,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,CAAA;IAC7B,KAAK,EAAE,MAAM,IAAI,CAAA;CAClB;AAED;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAAI,KAAK,MAAM,EAAE,YAAY,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,KAAG,QAmC1F,CAAA"}

package/lib/components/mediaDownload.js

@@ -0,0 +1,43 @@
+/** A remote `http(s)` source, which is fetched with progress before it is decoded. */
+export const isRemoteUri = uri => !!uri && /^https?:\/\//i.test(uri);
+/**
+ * Fetches `uri` into memory, reporting 0..1 as it arrives. `XMLHttpRequest` is
+ * the one React Native transport that reports download progress, which is what
+ * drives the ring on a voice note being fetched. `onProgress` is not
+ * called when the server sends no length.
+ */
+export const downloadWithProgress = (uri, onProgress) => {
+  const xhr = new XMLHttpRequest();
+  let isAborted = false;
+  const promise = new Promise((resolve, reject) => {
+    xhr.open('GET', uri);
+    xhr.responseType = 'arraybuffer';
+    xhr.onprogress = event => {
+      if (event.lengthComputable && event.total > 0) onProgress(Math.min(1, event.loaded / event.total));
+    };
+    xhr.onload = () => {
+      if (xhr.status >= 200 && xhr.status < 300 && xhr.response) {
+        onProgress(1);
+        resolve(xhr.response);
+      } else {
+        reject(new Error(`HTTP ${xhr.status}`));
+      }
+    };
+    xhr.onerror = () => reject(new Error('network'));
+    xhr.onabort = () => reject(new Error('aborted'));
+    xhr.send();
+  });
+  return {
+    promise,
+    abort: () => {
+      if (isAborted) return;
+      isAborted = true;
+      try {
+        xhr.abort();
+      } catch {
+        // already done
+      }
+    }
+  };
+};
+//# sourceMappingURL=mediaDownload.js.map

package/lib/components/mediaDownload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mediaDownload.js","names":["isRemoteUri","uri","test","downloadWithProgress","onProgress","xhr","XMLHttpRequest","isAborted","promise","Promise","resolve","reject","open","responseType","onprogress","event","lengthComputable","total","Math","min","loaded","onload","status","response","Error","onerror","onabort","send","abort"],"sources":["../../src/components/mediaDownload.ts"],"sourcesContent":["/** A remote `http(s)` source, which is fetched with progress before it is decoded. */\nexport const isRemoteUri = (uri: string | undefined) => !!uri && /^https?:\\/\\//i.test(uri)\n\nexport interface Download {\n  promise: Promise<ArrayBuffer>\n  abort: () => void\n}\n\n/**\n * Fetches `uri` into memory, reporting 0..1 as it arrives. `XMLHttpRequest` is\n * the one React Native transport that reports download progress, which is what\n * drives the ring on a voice note being fetched. `onProgress` is not\n * called when the server sends no length.\n */\nexport const downloadWithProgress = (uri: string, onProgress: (fraction: number) => void): Download => {\n  const xhr = new XMLHttpRequest()\n  let isAborted = false\n  const promise = new Promise<ArrayBuffer>((resolve, reject) => {\n    xhr.open('GET', uri)\n    xhr.responseType = 'arraybuffer'\n    xhr.onprogress = event => {\n      if (event.lengthComputable && event.total > 0)\n        onProgress(Math.min(1, event.loaded / event.total))\n    }\n    xhr.onload = () => {\n      if (xhr.status >= 200 && xhr.status < 300 && xhr.response) {\n        onProgress(1)\n        resolve(xhr.response as ArrayBuffer)\n      } else {\n        reject(new Error(`HTTP ${xhr.status}`))\n      }\n    }\n    xhr.onerror = () => reject(new Error('network'))\n    xhr.onabort = () => reject(new Error('aborted'))\n    xhr.send()\n  })\n  return {\n    promise,\n    abort: () => {\n      if (isAborted)\n        return\n      isAborted = true\n      try {\n        xhr.abort()\n      } catch {\n        // already done\n      }\n    },\n  }\n}\n"],"mappings":"AAAA;AACA,OAAO,MAAMA,WAAW,GAAIC,GAAuB,IAAK,CAAC,CAACA,GAAG,IAAI,eAAe,CAACC,IAAI,CAACD,GAAG,CAAC;AAO1F;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAME,oBAAoB,GAAGA,CAACF,GAAW,EAAEG,UAAsC,KAAe;EACrG,MAAMC,GAAG,GAAG,IAAIC,cAAc,CAAC,CAAC;EAChC,IAAIC,SAAS,GAAG,KAAK;EACrB,MAAMC,OAAO,GAAG,IAAIC,OAAO,CAAc,CAACC,OAAO,EAAEC,MAAM,KAAK;IAC5DN,GAAG,CAACO,IAAI,CAAC,KAAK,EAAEX,GAAG,CAAC;IACpBI,GAAG,CAACQ,YAAY,GAAG,aAAa;IAChCR,GAAG,CAACS,UAAU,GAAGC,KAAK,IAAI;MACxB,IAAIA,KAAK,CAACC,gBAAgB,IAAID,KAAK,CAACE,KAAK,GAAG,CAAC,EAC3Cb,UAAU,CAACc,IAAI,CAACC,GAAG,CAAC,CAAC,EAAEJ,KAAK,CAACK,MAAM,GAAGL,KAAK,CAACE,KAAK,CAAC,CAAC;IACvD,CAAC;IACDZ,GAAG,CAACgB,MAAM,GAAG,MAAM;MACjB,IAAIhB,GAAG,CAACiB,MAAM,IAAI,GAAG,IAAIjB,GAAG,CAACiB,MAAM,GAAG,GAAG,IAAIjB,GAAG,CAACkB,QAAQ,EAAE;QACzDnB,UAAU,CAAC,CAAC,CAAC;QACbM,OAAO,CAACL,GAAG,CAACkB,QAAuB,CAAC;MACtC,CAAC,MAAM;QACLZ,MAAM,CAAC,IAAIa,KAAK,CAAC,QAAQnB,GAAG,CAACiB,MAAM,EAAE,CAAC,CAAC;MACzC;IACF,CAAC;IACDjB,GAAG,CAACoB,OAAO,GAAG,MAAMd,MAAM,CAAC,IAAIa,KAAK,CAAC,SAAS,CAAC,CAAC;IAChDnB,GAAG,CAACqB,OAAO,GAAG,MAAMf,MAAM,CAAC,IAAIa,KAAK,CAAC,SAAS,CAAC,CAAC;IAChDnB,GAAG,CAACsB,IAAI,CAAC,CAAC;EACZ,CAAC,CAAC;EACF,OAAO;IACLnB,OAAO;IACPoB,KAAK,EAAEA,CAAA,KAAM;MACX,IAAIrB,SAAS,EACX;MACFA,SAAS,GAAG,IAAI;MAChB,IAAI;QACFF,GAAG,CAACuB,KAAK,CAAC,CAAC;MACb,CAAC,CAAC,MAAM;QACN;MAAA;IAEJ;EACF,CAAC;AACH,CAAC","ignoreList":[]}

package/lib/components/mediaPalette.d.ts

@@ -4,8 +4,8 @@ import { ChatTheme } from '../Theme';
  *
  * The accent cannot be used for both positions: in the default light theme
  * `colors.accent` and `colors.outgoingBubble` are the same azure, so an accent
- * circle on an outgoing bubble is invisible (1:1 contrast). Telegram solves this
- * the same way - the control inverts on the sender's side.
+ * circle on an outgoing bubble is invisible (1:1 contrast), so the control inverts on
+ * the sender's side.
  */
 export interface MediaPalette {
     /** Filled circle behind the play/pause glyph. */
@@ -19,5 +19,10 @@ export interface MediaPalette {
     /** Duration and other meta text. */
     meta: string;
 }
+/**
+ * The voice colors: the play
+ * button and played bars in the bubble's fill color, unplayed bars in its track color. On the
+ * day theme's green bubble they are greens; on the night gradient, white.
+ */
 export declare const getMediaPalette: (theme: ChatTheme, position: "left" | "right") => MediaPalette;
 //# sourceMappingURL=mediaPalette.d.ts.map

package/lib/components/mediaPalette.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mediaPalette.d.ts","sourceRoot":"","sources":["../../src/components/mediaPalette.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAEpC;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAA;IACf,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAA;IAChB,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAA;CACb;AAED,eAAO,MAAM,eAAe,GAC1B,OAAO,SAAS,EAChB,UAAU,MAAM,GAAG,OAAO,KACzB,YAeE,CAAA"}
+{"version":3,"file":"mediaPalette.d.ts","sourceRoot":"","sources":["../../src/components/mediaPalette.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAEpC;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAA;IACf,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAA;IAChB,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAC1B,OAAO,SAAS,EAChB,UAAU,MAAM,GAAG,OAAO,KACzB,YAeE,CAAA"}

package/lib/components/mediaPalette.js

@@ -1,16 +1,28 @@
-export const getMediaPalette = (theme, position) => position === 'right'
-    ? {
-        control: theme.colors.outgoingText,
-        glyph: theme.colors.outgoingBubble,
-        progress: theme.colors.outgoingText,
-        track: 'rgba(255, 255, 255, 0.45)',
-        meta: theme.colors.outgoingText,
-    }
-    : {
-        control: theme.colors.accent,
-        glyph: '#FFFFFF',
-        progress: theme.colors.accent,
-        track: 'rgba(0, 0, 0, 0.20)',
-        meta: theme.colors.incomingMeta,
-    };
+/**
+ * Colors for the play/pause control and progress track inside a media bubble.
+ *
+ * The accent cannot be used for both positions: in the default light theme
+ * `colors.accent` and `colors.outgoingBubble` are the same azure, so an accent
+ * circle on an outgoing bubble is invisible (1:1 contrast), so the control inverts on
+ * the sender's side.
+ */
+
+/**
+ * The voice colors: the play
+ * button and played bars in the bubble's fill color, unplayed bars in its track color. On the
+ * day theme's green bubble they are greens; on the night gradient, white.
+ */
+export const getMediaPalette = (theme, position) => position === 'right' ? {
+  control: theme.colors.outgoingVoiceFill,
+  glyph: theme.colors.outgoingBubble,
+  progress: theme.colors.outgoingVoiceFill,
+  track: theme.colors.outgoingVoiceTrack,
+  meta: theme.colors.outgoingMeta
+} : {
+  control: theme.colors.incomingVoiceFill,
+  glyph: '#FFFFFF',
+  progress: theme.colors.incomingVoiceFill,
+  track: theme.colors.incomingVoiceTrack,
+  meta: theme.colors.incomingMeta
+};
 //# sourceMappingURL=mediaPalette.js.map

package/lib/components/mediaPalette.js.map

@@ -1 +1 @@
-{"version":3,"file":"mediaPalette.js","sourceRoot":"","sources":["../../src/components/mediaPalette.ts"],"names":[],"mappings":"AAuBA,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,KAAgB,EAChB,QAA0B,EACZ,EAAE,CAChB,QAAQ,KAAK,OAAO;IAClB,CAAC,CAAC;QACA,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,YAAY;QAClC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,cAAc;QAClC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,YAAY;QACnC,KAAK,EAAE,2BAA2B;QAClC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,YAAY;KAChC;IACD,CAAC,CAAC;QACA,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM;QAC5B,KAAK,EAAE,SAAS;QAChB,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM;QAC7B,KAAK,EAAE,qBAAqB;QAC5B,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,YAAY;KAChC,CAAA"}
+{"version":3,"file":"mediaPalette.js","names":["getMediaPalette","theme","position","control","colors","outgoingVoiceFill","glyph","outgoingBubble","progress","track","outgoingVoiceTrack","meta","outgoingMeta","incomingVoiceFill","incomingVoiceTrack","incomingMeta"],"sources":["../../src/components/mediaPalette.ts"],"sourcesContent":["import { ChatTheme } from '../Theme'\n\n/**\n * Colors for the play/pause control and progress track inside a media bubble.\n *\n * The accent cannot be used for both positions: in the default light theme\n * `colors.accent` and `colors.outgoingBubble` are the same azure, so an accent\n * circle on an outgoing bubble is invisible (1:1 contrast), so the control inverts on\n * the sender's side.\n */\nexport interface MediaPalette {\n  /** Filled circle behind the play/pause glyph. */\n  control: string\n  /** The glyph itself. */\n  glyph: string\n  /** Played portion of the waveform / progress track. */\n  progress: string\n  /** Unplayed portion. */\n  track: string\n  /** Duration and other meta text. */\n  meta: string\n}\n\n/**\n * The voice colors: the play\n * button and played bars in the bubble's fill color, unplayed bars in its track color. On the\n * day theme's green bubble they are greens; on the night gradient, white.\n */\nexport const getMediaPalette = (\n  theme: ChatTheme,\n  position: 'left' | 'right'\n): MediaPalette =>\n  position === 'right'\n    ? {\n      control: theme.colors.outgoingVoiceFill,\n      glyph: theme.colors.outgoingBubble,\n      progress: theme.colors.outgoingVoiceFill,\n      track: theme.colors.outgoingVoiceTrack,\n      meta: theme.colors.outgoingMeta,\n    }\n    : {\n      control: theme.colors.incomingVoiceFill,\n      glyph: '#FFFFFF',\n      progress: theme.colors.incomingVoiceFill,\n      track: theme.colors.incomingVoiceTrack,\n      meta: theme.colors.incomingMeta,\n    }\n"],"mappings":"AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAcA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMA,eAAe,GAAGA,CAC7BC,KAAgB,EAChBC,QAA0B,KAE1BA,QAAQ,KAAK,OAAO,GAChB;EACAC,OAAO,EAAEF,KAAK,CAACG,MAAM,CAACC,iBAAiB;EACvCC,KAAK,EAAEL,KAAK,CAACG,MAAM,CAACG,cAAc;EAClCC,QAAQ,EAAEP,KAAK,CAACG,MAAM,CAACC,iBAAiB;EACxCI,KAAK,EAAER,KAAK,CAACG,MAAM,CAACM,kBAAkB;EACtCC,IAAI,EAAEV,KAAK,CAACG,MAAM,CAACQ;AACrB,CAAC,GACC;EACAT,OAAO,EAAEF,KAAK,CAACG,MAAM,CAACS,iBAAiB;EACvCP,KAAK,EAAE,SAAS;EAChBE,QAAQ,EAAEP,KAAK,CAACG,MAAM,CAACS,iBAAiB;EACxCJ,KAAK,EAAER,KAAK,CAACG,MAAM,CAACU,kBAAkB;EACtCH,IAAI,EAAEV,KAAK,CAACG,MAAM,CAACW;AACrB,CAAC","ignoreList":[]}

package/lib/components/mediaPlayback.d.ts

@@ -1,22 +1,221 @@
+import { NotePlayer, NotePlayerCache } from './roundNotePlayers';
 /**
  * Module-level registry so only one piece of media plays at a time.
  *
  * Every voice note and round video note owns its own player, and nothing
  * coordinated them: starting a second note left the first one playing, and a
- * chat with several round notes played all of them at once. Telegram always
- * stops the current one when a new one starts.
+ * chat with several round notes played all of them at once. Now the current
+ * one always stops when a new one starts.
  *
  * Deliberately not React context - bubbles are recycled by the list, and the
  * registry has to outlive individual mounts to stop a player whose row has
  * already scrolled away.
  */
-type StopHandler = () => void;
+/**
+ * Why a player is told to stop. `replaced`: another note started, so this one
+ * is no longer current and resets its progress. `paused`: something else took the audio (a
+ * recording), so it pauses and stays current.
+ */
+export type StopReason = 'replaced' | 'paused';
+type StopHandler = (reason: StopReason) => void;
 /**
  * Claim playback for `id`, stopping whatever else was playing.
- * Call when a player actually starts.
+ * Call when a player actually starts. A paused note may keep its claim, so a
+ * later note can still reset it.
  */
 export declare const claimPlayback: (id: string, stop: StopHandler) => void;
-/** Give up the claim (on pause, completion or unmount). */
+/** Give up the claim (on completion, reset or unmount). */
 export declare const releasePlayback: (id: string) => void;
+/**
+ * Pause whatever is playing. Recording calls this first: opening the mic takes
+ * audio focus, which pauses the playing note - otherwise it would bleed straight into the new take. The
+ * paused note keeps its claim and stays current.
+ */
+export declare const stopAllPlayback: () => void;
+/** A tap of the speed pill cycles through these. */
+export declare const PLAYBACK_RATES: readonly [1, 1.5, 2];
+/**
+ * The presets a long press on the speed pill offers: Slow, Normal, Medium,
+ * Fast, Very fast and Super fast.
+ */
+export declare const PLAYBACK_RATE_PRESETS: readonly [0.5, 1, 1.2, 1.5, 1.7, 2];
+export declare const getPlaybackRate: () => number;
+export declare const setPlaybackRate: (rate: number) => void;
+/** The next step on the speed pill after `rate`. */
+export declare const nextPlaybackRate: (rate: number) => 2 | 1 | 1.5;
+/** The shared playback speed, re-rendering when any note changes it. */
+export declare const usePlaybackRate: () => number;
+export declare const subscribePlaybackRate: (listener: (rate: number) => void) => () => void;
+/** What a message needs for the "play the next note" lookup. */
+interface PlaylistMessage {
+    _id: string | number;
+    audio?: string;
+    video?: string;
+    videoNote?: boolean;
+    isMediaUnread?: boolean;
+}
+/** Chat-level playback options, from the `mediaPlayback` prop. */
+export interface MediaPlaybackOptions {
+    isAutoPlayNextEnabled: boolean;
+    isRoundVideoAutoplayEnabled: boolean;
+    onMediaRead?: (message: any) => void;
+    isNearEar?: boolean;
+    onTranscribe?: (message: any) => void;
+    onViewOnceEnd?: (message: any) => void;
+    isFloatingRoundNoteEnabled?: boolean;
+}
+/** A mounted player the controller can start when the previous note ends. */
+interface PlaylistEntry {
+    play: () => void;
+}
+/**
+ * Per-chat coordinator for auto-playing the next note. When a voice or round
+ * note finishes on its own, playback moves on to the next newer voice/round
+ * message in the chat, so a run of notes plays as one.
+ *
+ * The chat feeds it the current messages on every render (a ref write, no
+ * re-render), and players register by message id while they are mounted. The
+ * next note can only be started if its row is mounted - the list virtualizes,
+ * but the next note sits right below the current one, so it nearly always is.
+ */
+export interface MediaPlaybackController {
+    setMessages: (messages: readonly PlaylistMessage[], isInverted: boolean) => void;
+    setOptions: (options: MediaPlaybackOptions) => void;
+    getOptions: () => MediaPlaybackOptions;
+    /** Notified when `isNearEar` flips (raise to listen). */
+    subscribeNearEar: (listener: () => void) => () => void;
+    register: (messageId: string | number, entry: PlaylistEntry) => () => void;
+    /** Called by a player whose note reached its end without being paused. */
+    onEnded: (messageId: string | number) => void;
+    /**
+     * An incoming unread note started playing: report it, since playing
+     * marks the content read.
+     */
+    markRead: (messageId: string | number) => void;
+    /**
+     * The round note grown to play, if any. Its row hides the sender's avatar
+     * meanwhile.
+     */
+    setGrownNote: (messageId: string | number | null, timeShift?: number) => void;
+    getGrownNote: () => string | number | null;
+    /**
+     * How far the grown note's right edge moved from where it rests, so the
+     * bubble can carry the sent time along with the circle.
+     */
+    getGrownTimeShift: () => number;
+    subscribeGrownNote: (listener: () => void) => () => void;
+    /**
+     * The note that owns playback, playing or paused, for the "now playing" bar
+     * at the top of the chat.
+     */
+    setNowPlaying: (entry: NowPlayingEntry | null) => void;
+    /** Clears the bar only if `messageId` still owns it. */
+    clearNowPlaying: (messageId: string | number) => void;
+    getNowPlaying: () => NowPlayingEntry | null;
+    subscribeNowPlaying: (listener: () => void) => () => void;
+    getMessage: (messageId: string | number) => PlaylistMessage | undefined;
+    /** Set by the chat: scrolls the list so a message sits mid-screen. */
+    setScroller: (scroll: ((messageId: string | number) => void) | null) => void;
+    /**
+     * Centres a message in the list, used when a round note starts playing.
+     */
+    scrollToMessage: (messageId: string | number) => void;
+    /**
+     * The messages whose rows are at least partly on screen, from the list's
+     * viewability. The playing round note floats once its row is no longer
+     * among them.
+     */
+    setViewableMessages: (messageIds: readonly (string | number)[]) => void;
+    /** `undefined` until the list first reports, so nothing floats before layout. */
+    isMessageViewable: (messageId: string | number) => boolean | undefined;
+    subscribeViewable: (listener: () => void) => () => void;
+    /** The round note drawn floating over the list, while its view is mounted. */
+    setFloatingNote: (messageId: string | number | null) => void;
+    getFloatingNote: () => string | number | null;
+    subscribeFloatingNote: (listener: () => void) => () => void;
+    /** Round note players, which outlive their rows while the note is current. */
+    notePlayers: NotePlayerCache;
+}
+/** What the "now playing" bar shows and controls. */
+export interface NowPlayingEntry {
+    messageId: string | number;
+    kind: 'voice' | 'round';
+    isPlaying: boolean;
+    toggle: () => void;
+    stop: () => void;
+    /** A round note's expo-video player, so the floating note shows the same video. */
+    player?: unknown;
+}
+export declare const createMediaPlaybackController: () => MediaPlaybackController;
+export declare const MediaPlaybackContext: import("react").Context<MediaPlaybackController | null>;
+/**
+ * Inside the long-press copy of a message: the chat's playback, to show (never drive). The copy
+ * sits over its hidden original while the menu is open; its media mirrors what the original is
+ * playing, as Telegram's lifted message does, instead of starting a player of its own.
+ */
+export declare const LiftedPlaybackContext: import("react").Context<MediaPlaybackController | null>;
+/**
+ * The horizontal shift of each grown round note, by its player key, so a lifted copy of it sits
+ * exactly over the original.
+ */
+export declare const noteGrowShifts: Map<string, number>;
+/** A lifted copy started (or stopped) showing the media under `key`. */
+export declare const setMediaLifted: (key: string, isLifted: boolean) => void;
+/** Whether a lifted copy is showing the media under `key`. */
+export declare const useIsMediaLifted: (key: string) => boolean;
+/**
+ * Registers a player for auto-play-next and returns the `onEnded` callback it
+ * should fire when its note finishes on its own. A no-op outside a `Chat`, or
+ * when the message id is unknown.
+ */
+export declare const usePlaylistEntry: (messageId: string | number | undefined, play: () => void) => import("react").RefObject<() => void>;
+/**
+ * Whether round notes loop silently in the list, and a callback that reports
+ * an incoming unread note as read. Both are no-ops outside a `Chat`.
+ */
+export declare const useNotePlaybackOptions: (messageId: string | number | undefined) => {
+    isRoundVideoAutoplayEnabled: boolean;
+    isNearEar: boolean;
+    onTranscribe: ((message: any) => void) | undefined;
+    onViewOnceEnd: ((message: any) => void) | undefined;
+    markReadRef: import("react").RefObject<() => void>;
+};
+/** Whether this message's round note is grown to play; false outside a `Chat`. */
+export declare const useIsNoteGrown: (messageId: string | number | undefined) => boolean;
+/** Reports this note growing or shrinking back, so its row can hide the avatar. */
+export declare const useReportNoteGrown: (messageId: string | number | undefined, isGrown: boolean, timeShift?: number) => void;
+/** How far this message's grown round note moved its right edge; 0 at rest. */
+export declare const useNoteTimeShift: (messageId: string | number | undefined) => number;
+/**
+ * Puts this note in the "now playing" bar while it owns playback, playing or
+ * paused, and takes it out when it stops, is replaced or unmounts.
+ */
+export declare const useReportNowPlaying: (messageId: string | number | undefined, kind: "voice" | "round", isCurrent: boolean, isPlaying: boolean, toggle: () => void, stop: () => void, player?: unknown) => void;
+/** Centres a message in the chat's list; a no-op outside a `Chat`. */
+export declare const useScrollToMessage: () => (messageId: string | number | undefined) => void;
+/** The note in the "now playing" bar, or null; null outside a `Chat`. */
+export declare const useNowPlaying: () => NowPlayingEntry | null;
+/** The phone is held to the ear (raise to listen); false outside a `Chat`. */
+export declare const useIsNearEar: () => boolean;
+/**
+ * Whether a message's row is on screen: `undefined` outside a `Chat` or before
+ * the list has reported, so callers can tell "scrolled away" from "unknown".
+ */
+export declare const useIsMessageViewable: (messageId: string | number | undefined) => boolean | undefined;
+/** Whether this message's round note is currently drawn floating over the list. */
+export declare const useIsNoteFloating: (messageId: string | number | undefined) => boolean;
+/** The chat's round note players, or a shared cache outside a `Chat`. */
+export declare const useNotePlayerCache: () => NotePlayerCache;
+/**
+ * Hands a current round note whose row is unmounting over to a detached
+ * session, so it keeps playing (and floating) until it ends, another note
+ * starts, or its row mounts again and takes it back. Without a `Chat`, or
+ * while the chat itself is going away, the note just stops.
+ */
+export declare const detachRoundNoteFromRow: (controller: MediaPlaybackController | null, cache: NotePlayerCache, cacheKey: string | number, messageId: string | number | undefined, player: NotePlayer, isPlaying: boolean, 
+/** False for a note that must not outlive its row (a view-once one). */
+canFloat?: boolean) => void;
+/** The chat's playback controller, or `null` outside a `Chat`. */
+export declare const useMediaPlaybackController: () => MediaPlaybackController | null;
 export {};
 //# sourceMappingURL=mediaPlayback.d.ts.map

package/lib/components/mediaPlayback.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mediaPlayback.d.ts","sourceRoot":"","sources":["../../src/components/mediaPlayback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,KAAK,WAAW,GAAG,MAAM,IAAI,CAAA;AAI7B;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,IAAI,MAAM,EAAE,MAAM,WAAW,SAW1D,CAAA;AAED,2DAA2D;AAC3D,eAAO,MAAM,eAAe,GAAI,IAAI,MAAM,SAEzC,CAAA"}
+{"version":3,"file":"mediaPlayback.d.ts","sourceRoot":"","sources":["../../src/components/mediaPlayback.ts"],"names":[],"mappings":"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"}