@kesha-antonov/react-native-chat 5.0.0 → 6.0.0

package/lib/components/composerPanels.js

@@ -0,0 +1,22 @@
+import { createContext, useContext } from 'react';
+
+/**
+ * Lets the message list close a panel the composer has open in the keyboard's place (the emoji
+ * keyboard), so a tap on the chat hides it. The composer registers its closer; the
+ * list calls `close` on a tap. A plain mutable store, so neither side re-renders for it.
+ */
+
+export const createComposerPanelsStore = () => {
+  let closer = null;
+  return {
+    close: () => closer?.(),
+    setCloser: next => {
+      closer = next;
+    }
+  };
+};
+export const ComposerPanelsContext = createContext(null);
+export const useComposerPanels = () => {
+  return useContext(ComposerPanelsContext);
+};
+//# sourceMappingURL=composerPanels.js.map

package/lib/components/composerPanels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composerPanels.js","names":["createContext","useContext","createComposerPanelsStore","closer","close","setCloser","next","ComposerPanelsContext","useComposerPanels"],"sources":["../../src/components/composerPanels.ts"],"sourcesContent":["import { createContext, useContext } from 'react'\n\n/**\n * Lets the message list close a panel the composer has open in the keyboard's place (the emoji\n * keyboard), so a tap on the chat hides it. The composer registers its closer; the\n * list calls `close` on a tap. A plain mutable store, so neither side re-renders for it.\n */\nexport interface ComposerPanelsStore {\n  close: () => void\n  setCloser: (closer: (() => void) | null) => void\n}\n\nexport const createComposerPanelsStore = (): ComposerPanelsStore => {\n  let closer: (() => void) | null = null\n  return {\n    close: () => closer?.(),\n    setCloser: next => {\n      closer = next\n    },\n  }\n}\n\nexport const ComposerPanelsContext = createContext<ComposerPanelsStore | null>(null)\n\nexport const useComposerPanels = () => useContext(ComposerPanelsContext)\n"],"mappings":"AAAA,SAASA,aAAa,EAAEC,UAAU,QAAQ,OAAO;;AAEjD;AACA;AACA;AACA;AACA;;AAMA,OAAO,MAAMC,yBAAyB,GAAGA,CAAA,KAA2B;EAClE,IAAIC,MAA2B,GAAG,IAAI;EACtC,OAAO;IACLC,KAAK,EAAEA,CAAA,KAAMD,MAAM,GAAG,CAAC;IACvBE,SAAS,EAAEC,IAAI,IAAI;MACjBH,MAAM,GAAGG,IAAI;IACf;EACF,CAAC;AACH,CAAC;AAED,OAAO,MAAMC,qBAAqB,GAAGP,aAAa,CAA6B,IAAI,CAAC;AAEpF,OAAO,MAAMQ,iBAAiB,GAAGA,CAAA;EAAA,OAAMP,UAAU,CAACM,qBAAqB,CAAC;AAAA","ignoreList":[]}

package/lib/components/defaultMessageActions.d.ts

@@ -0,0 +1,30 @@
+import { ChatLabels } from '../i18n';
+import { IMessage, MessageActionKey, MessageMenuItem, User } from '../Models';
+import { ClipboardAdapter } from '../optional';
+/**
+ * The order of the actions the library can offer by itself, as a messenger lists them for a
+ * regular message: Reply, Copy, Forward, Pin / Unpin, Edit, Delete - with Select before
+ * Delete.
+ */
+export declare const DEFAULT_MESSAGE_ACTION_KEYS: MessageActionKey[];
+export interface DefaultMessageActionsOptions<TMessage extends IMessage> {
+    message: TMessage;
+    user?: User;
+    labels: ChatLabels;
+    /** Which actions to build, in this order. */
+    keys: MessageActionKey[];
+    clipboard: ClipboardAdapter | null;
+    onReply?: (message: TMessage) => void;
+    onEdit?: (message: TMessage) => void;
+    onForward?: (message: TMessage) => void;
+    onPin?: (message: TMessage) => void;
+    onSelect?: (message: TMessage) => void;
+    onDelete?: (message: TMessage) => void;
+}
+/**
+ * The actions that can work for this message: Reply when replying is on, Copy for text when a
+ * clipboard resolves, Edit for your own text when the app handles edits, and Forward, Pin and
+ * Delete when the app handles them.
+ */
+export declare function buildDefaultMessageActions<TMessage extends IMessage>({ message, user, labels, keys, clipboard, onReply, onEdit, onForward, onPin, onSelect, onDelete, }: DefaultMessageActionsOptions<TMessage>): MessageMenuItem[];
+//# sourceMappingURL=defaultMessageActions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"defaultMessageActions.d.ts","sourceRoot":"","sources":["../../src/components/defaultMessageActions.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAGpC,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAI9C;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,EAAE,gBAAgB,EAAoE,CAAA;AA4B9H,MAAM,WAAW,4BAA4B,CAAC,QAAQ,SAAS,QAAQ;IACrE,OAAO,EAAE,QAAQ,CAAA;IACjB,IAAI,CAAC,EAAE,IAAI,CAAA;IACX,MAAM,EAAE,UAAU,CAAA;IAClB,6CAA6C;IAC7C,IAAI,EAAE,gBAAgB,EAAE,CAAA;IACxB,SAAS,EAAE,gBAAgB,GAAG,IAAI,CAAA;IAClC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,IAAI,CAAA;IACrC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,IAAI,CAAA;IACpC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,IAAI,CAAA;IACvC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,IAAI,CAAA;IACnC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,IAAI,CAAA;IACtC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,IAAI,CAAA;CACvC;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,SAAS,QAAQ,EAAG,EACrE,OAAO,EACP,IAAI,EACJ,MAAM,EACN,IAAI,EACJ,SAAS,EACT,OAAO,EACP,MAAM,EACN,SAAS,EACT,KAAK,EACL,QAAQ,EACR,QAAQ,GACT,EAAE,4BAA4B,CAAC,QAAQ,CAAC,GAAG,eAAe,EAAE,CAyD5D"}

package/lib/components/defaultMessageActions.js

@@ -0,0 +1,124 @@
+import React from 'react';
+import { devHint } from '../logging';
+import { Icon } from './Icon';
+import { PencilIcon, ReplyArrowIcon, TrashIcon } from './MediaControls';
+
+/**
+ * The order of the actions the library can offer by itself, as a messenger lists them for a
+ * regular message: Reply, Copy, Forward, Pin / Unpin, Edit, Delete - with Select before
+ * Delete.
+ */
+export const DEFAULT_MESSAGE_ACTION_KEYS = ['reply', 'copy', 'forward', 'pin', 'edit', 'select', 'delete'];
+const iconRenderer = (name, Fallback) => {
+  const render = ({
+    color,
+    size
+  }) => <Icon name={name} color={color} size={size} fallback={Fallback ? <Fallback color={color} size={size} /> : null} />;
+  return render;
+};
+
+// Built once: a fresh renderer per menu would be a fresh prop per row.
+const ICONS = {
+  reply: iconRenderer('reply', ReplyArrowIcon),
+  copy: iconRenderer('copy'),
+  forward: iconRenderer('forward'),
+  pin: iconRenderer('pushpin'),
+  unpin: iconRenderer('pinOff'),
+  edit: iconRenderer('pencil', PencilIcon),
+  select: iconRenderer('checkCircle'),
+  delete: iconRenderer('trash', TrashIcon)
+};
+/**
+ * The actions that can work for this message: Reply when replying is on, Copy for text when a
+ * clipboard resolves, Edit for your own text when the app handles edits, and Forward, Pin and
+ * Delete when the app handles them.
+ */
+export function buildDefaultMessageActions({
+  message,
+  user,
+  labels,
+  keys,
+  clipboard,
+  onReply,
+  onEdit,
+  onForward,
+  onPin,
+  onSelect,
+  onDelete
+}) {
+  if (message.system) return [];
+  const isOwn = user?._id != null && message.user?._id === user._id;
+  const text = message.text;
+  const items = [];
+  for (const key of keys) switch (key) {
+    case 'reply':
+      if (onReply) items.push({
+        key,
+        label: labels.actionReply,
+        icon: ICONS.reply,
+        onPress: () => onReply(message)
+      });
+      break;
+    case 'copy':
+      if (!text) break;
+      if (!clipboard) {
+        devHint('copy-no-clipboard', 'Chat: the "Copy" message action is hidden - install `expo-clipboard` or `@react-native-clipboard/clipboard` to show it');
+        break;
+      }
+      items.push({
+        key,
+        label: labels.actionCopy,
+        icon: ICONS.copy,
+        onPress: () => clipboard.setString(text)
+      });
+      break;
+    case 'edit':
+      if (onEdit && isOwn && !!text) items.push({
+        key,
+        label: labels.actionEdit,
+        icon: ICONS.edit,
+        onPress: () => onEdit(message)
+      });
+      break;
+    case 'forward':
+      if (onForward) items.push({
+        key,
+        label: labels.actionForward,
+        icon: ICONS.forward,
+        onPress: () => onForward(message)
+      });
+      break;
+    case 'pin':
+      if (onPin) items.push(message.isPinned ? {
+        key,
+        label: labels.actionUnpin,
+        icon: ICONS.unpin,
+        onPress: () => onPin(message)
+      } : {
+        key,
+        label: labels.actionPin,
+        icon: ICONS.pin,
+        onPress: () => onPin(message)
+      });
+      break;
+    case 'select':
+      if (onSelect) items.push({
+        key,
+        label: labels.actionSelect,
+        icon: ICONS.select,
+        onPress: () => onSelect(message)
+      });
+      break;
+    case 'delete':
+      if (onDelete) items.push({
+        key,
+        label: labels.actionDelete,
+        icon: ICONS.delete,
+        // Not red: the message menu draws Delete like any other row.
+        onPress: () => onDelete(message)
+      });
+      break;
+  }
+  return items;
+}
+//# sourceMappingURL=defaultMessageActions.js.map

package/lib/components/defaultMessageActions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultMessageActions.js","names":["React","devHint","Icon","PencilIcon","ReplyArrowIcon","TrashIcon","DEFAULT_MESSAGE_ACTION_KEYS","iconRenderer","name","Fallback","render","color","size","ICONS","reply","copy","forward","pin","unpin","edit","select","delete","buildDefaultMessageActions","message","user","labels","keys","clipboard","onReply","onEdit","onForward","onPin","onSelect","onDelete","system","isOwn","_id","text","items","key","push","label","actionReply","icon","onPress","actionCopy","setString","actionEdit","actionForward","isPinned","actionUnpin","actionPin","actionSelect","actionDelete"],"sources":["../../src/components/defaultMessageActions.tsx"],"sourcesContent":["import React from 'react'\n\nimport { ChatLabels } from '../i18n'\nimport { IconName, IconRenderer } from '../Icons'\nimport { devHint } from '../logging'\nimport { IMessage, MessageActionKey, MessageMenuItem, User } from '../Models'\nimport { ClipboardAdapter } from '../optional'\nimport { Icon } from './Icon'\nimport { PencilIcon, ReplyArrowIcon, TrashIcon } from './MediaControls'\n\n/**\n * The order of the actions the library can offer by itself, as a messenger lists them for a\n * regular message: Reply, Copy, Forward, Pin / Unpin, Edit, Delete - with Select before\n * Delete.\n */\nexport const DEFAULT_MESSAGE_ACTION_KEYS: MessageActionKey[] = ['reply', 'copy', 'forward', 'pin', 'edit', 'select', 'delete']\n\ntype DrawnIcon = (props: { color?: string, size?: number }) => React.ReactNode\n\nconst iconRenderer = (name: IconName, Fallback?: DrawnIcon): IconRenderer => {\n  const render: IconRenderer = ({ color, size }) => (\n    <Icon\n      name={name}\n      color={color}\n      size={size}\n      fallback={Fallback ? <Fallback color={color} size={size} /> : null}\n    />\n  )\n  return render\n}\n\n// Built once: a fresh renderer per menu would be a fresh prop per row.\nconst ICONS: Record<MessageActionKey | 'unpin', IconRenderer> = {\n  reply: iconRenderer('reply', ReplyArrowIcon),\n  copy: iconRenderer('copy'),\n  forward: iconRenderer('forward'),\n  pin: iconRenderer('pushpin'),\n  unpin: iconRenderer('pinOff'),\n  edit: iconRenderer('pencil', PencilIcon),\n  select: iconRenderer('checkCircle'),\n  delete: iconRenderer('trash', TrashIcon),\n}\n\nexport interface DefaultMessageActionsOptions<TMessage extends IMessage> {\n  message: TMessage\n  user?: User\n  labels: ChatLabels\n  /** Which actions to build, in this order. */\n  keys: MessageActionKey[]\n  clipboard: ClipboardAdapter | null\n  onReply?: (message: TMessage) => void\n  onEdit?: (message: TMessage) => void\n  onForward?: (message: TMessage) => void\n  onPin?: (message: TMessage) => void\n  onSelect?: (message: TMessage) => void\n  onDelete?: (message: TMessage) => void\n}\n\n/**\n * The actions that can work for this message: Reply when replying is on, Copy for text when a\n * clipboard resolves, Edit for your own text when the app handles edits, and Forward, Pin and\n * Delete when the app handles them.\n */\nexport function buildDefaultMessageActions<TMessage extends IMessage> ({\n  message,\n  user,\n  labels,\n  keys,\n  clipboard,\n  onReply,\n  onEdit,\n  onForward,\n  onPin,\n  onSelect,\n  onDelete,\n}: DefaultMessageActionsOptions<TMessage>): MessageMenuItem[] {\n  if (message.system)\n    return []\n\n  const isOwn = user?._id != null && message.user?._id === user._id\n  const text = message.text\n\n  const items: MessageMenuItem[] = []\n  for (const key of keys)\n    switch (key) {\n      case 'reply':\n        if (onReply)\n          items.push({ key, label: labels.actionReply, icon: ICONS.reply, onPress: () => onReply(message) })\n        break\n      case 'copy':\n        if (!text)\n          break\n        if (!clipboard) {\n          devHint(\n            'copy-no-clipboard',\n            'Chat: the \"Copy\" message action is hidden - install `expo-clipboard` or `@react-native-clipboard/clipboard` to show it'\n          )\n          break\n        }\n        items.push({ key, label: labels.actionCopy, icon: ICONS.copy, onPress: () => clipboard.setString(text) })\n        break\n      case 'edit':\n        if (onEdit && isOwn && !!text)\n          items.push({ key, label: labels.actionEdit, icon: ICONS.edit, onPress: () => onEdit(message) })\n        break\n      case 'forward':\n        if (onForward)\n          items.push({ key, label: labels.actionForward, icon: ICONS.forward, onPress: () => onForward(message) })\n        break\n      case 'pin':\n        if (onPin)\n          items.push(message.isPinned\n            ? { key, label: labels.actionUnpin, icon: ICONS.unpin, onPress: () => onPin(message) }\n            : { key, label: labels.actionPin, icon: ICONS.pin, onPress: () => onPin(message) })\n        break\n      case 'select':\n        if (onSelect)\n          items.push({ key, label: labels.actionSelect, icon: ICONS.select, onPress: () => onSelect(message) })\n        break\n      case 'delete':\n        if (onDelete)\n          items.push({\n            key,\n            label: labels.actionDelete,\n            icon: ICONS.delete,\n            // Not red: the message menu draws Delete like any other row.\n            onPress: () => onDelete(message),\n          })\n        break\n    }\n\n  return items\n}\n"],"mappings":"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","ignoreList":[]}

package/lib/components/earpiece.d.ts

@@ -0,0 +1,56 @@
+/**
+ * `startAudioAgain` seeks to 0 when `audioProgress * duration` is under a
+ * second: a note just started is heard from its beginning at the ear.
+ */
+export declare const RAISE_RESTART_SECONDS = 1;
+/**
+ * Points both engines at the earpiece or back at the speaker.
+ *
+ * iOS has one shared AVAudioSession: the `playAndRecord` category without
+ * `defaultToSpeaker` plays through the receiver, like the voice-call
+ * stream on Android. `playback` is the plain speaker route
+ * the players start in. On Android, expo-audio's `shouldRouteThroughEarpiece`
+ * switches the system to communication mode with the speakerphone off;
+ * react-native-audio-api has no Android routing of its own.
+ */
+export declare const applyEarpieceRoute: (isEarpiece: boolean) => void;
+/** Holds the earpiece route until the returned release is called. */
+export declare const acquireEarpiece: () => () => void;
+/** Whether audio is currently routed to the earpiece. */
+export declare const isEarpieceRouted: () => boolean;
+export type RaiseToListenAction = {
+    type: 'listen';
+    fromStart: boolean;
+} | {
+    type: 'pause';
+} | {
+    type: 'release';
+} | null;
+/**
+ * One step of raise to listen. `isListening`: this player holds the earpiece.
+ * Raised with the note current: listen (from the start if under a second in).
+ * Lowered while listening: back to the speaker and pause. No longer current
+ * while listening (it ended or another note took over): drop the claim without
+ * pausing, so the next note can keep the earpiece.
+ */
+export declare const raiseToListenStep: ({ isListening, isNearEar, isCurrent, positionSeconds, }: {
+    isListening: boolean;
+    isNearEar: boolean;
+    isCurrent: boolean;
+    positionSeconds: number;
+}) => RaiseToListenAction;
+export interface RaiseToListenOptions {
+    /** The note is current: playing, or paused part-way. */
+    isCurrent: boolean;
+    /** Seconds played so far. */
+    getPositionSeconds: () => number;
+    /** Play at the ear; `fromStart` rewinds first. */
+    listen: (fromStart: boolean) => void;
+    pause: () => void;
+}
+/**
+ * Raise to listen for one player, driven by `mediaPlayback.isNearEar`. Voice
+ * and round notes use it. A no-op outside a `Chat`.
+ */
+export declare const useRaiseToListen: ({ isCurrent, getPositionSeconds, listen, pause }: RaiseToListenOptions) => void;
+//# sourceMappingURL=earpiece.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"earpiece.d.ts","sourceRoot":"","sources":["../../src/components/earpiece.ts"],"names":[],"mappings":"AAgBA;;;GAGG;AACH,eAAO,MAAM,qBAAqB,IAAI,CAAA;AAEtC;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,GAAI,YAAY,OAAO,SAqBrD,CAAA;AAYD,qEAAqE;AACrE,eAAO,MAAM,eAAe,kBA4B3B,CAAA;AAED,yDAAyD;AACzD,eAAO,MAAM,gBAAgB,eAAiB,CAAA;AAE9C,MAAM,MAAM,mBAAmB,GAC3B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB,IAAI,CAAA;AAER;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAAI,yDAK/B;IACD,WAAW,EAAE,OAAO,CAAA;IACpB,SAAS,EAAE,OAAO,CAAA;IAClB,SAAS,EAAE,OAAO,CAAA;IAClB,eAAe,EAAE,MAAM,CAAA;CACxB,KAAG,mBAWH,CAAA;AAED,MAAM,WAAW,oBAAoB;IACnC,wDAAwD;IACxD,SAAS,EAAE,OAAO,CAAA;IAClB,6BAA6B;IAC7B,kBAAkB,EAAE,MAAM,MAAM,CAAA;IAChC,kDAAkD;IAClD,MAAM,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,CAAA;IACpC,KAAK,EAAE,MAAM,IAAI,CAAA;CAClB;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAAI,kDAAkD,oBAAoB,SAmCtG,CAAA"}

package/lib/components/earpiece.js

@@ -0,0 +1,218 @@
+import { c as _c } from "react/compiler-runtime";
+import { useEffect, useLayoutEffect, useRef } from 'react';
+import { getAudioApi, getExpoAudio } from '../optional';
+import { useIsNearEar } from './mediaPlayback';
+
+/**
+ * Raise to listen: with a voice or round note current, holding the phone to
+ * the ear moves playback to the earpiece and plays it, restarting a note that
+ * had played for under a second; lowering it goes back to the speaker and
+ * pauses.
+ */
+
+// Both audio engines are optional peers, resolved like everywhere else.
+const audioApi = getAudioApi();
+const expoAudio = getExpoAudio();
+
+/**
+ * `startAudioAgain` seeks to 0 when `audioProgress * duration` is under a
+ * second: a note just started is heard from its beginning at the ear.
+ */
+export const RAISE_RESTART_SECONDS = 1;
+
+/**
+ * Points both engines at the earpiece or back at the speaker.
+ *
+ * iOS has one shared AVAudioSession: the `playAndRecord` category without
+ * `defaultToSpeaker` plays through the receiver, like the voice-call
+ * stream on Android. `playback` is the plain speaker route
+ * the players start in. On Android, expo-audio's `shouldRouteThroughEarpiece`
+ * switches the system to communication mode with the speakerphone off;
+ * react-native-audio-api has no Android routing of its own.
+ */
+export const applyEarpieceRoute = isEarpiece => {
+  try {
+    audioApi?.AudioManager?.setAudioSessionOptions?.(isEarpiece ? {
+      iosCategory: 'playAndRecord',
+      iosMode: 'default',
+      iosOptions: []
+    } : {
+      iosCategory: 'playback',
+      iosMode: 'default',
+      iosOptions: []
+    });
+  } catch {
+    // an engine that cannot route must not stop playback
+  }
+  try {
+    const pending = expoAudio?.setAudioModeAsync?.({
+      playsInSilentMode: true,
+      allowsRecording: isEarpiece,
+      shouldRouteThroughEarpiece: isEarpiece
+    });
+    pending?.catch?.(() => {});
+  } catch {
+    // an engine that cannot route must not stop playback
+  }
+};
+
+/*
+ * Several players can want the earpiece across a hand-over (a note ends at the
+ * ear and auto-play starts the next one), so the route is reference counted,
+ * and going back to the speaker waits a tick: the next note's claim, made in
+ * the same commit, cancels it instead of flipping the route twice.
+ */
+let holders = 0;
+let isRouted = false;
+let restoreTimer = null;
+
+/** Holds the earpiece route until the returned release is called. */
+export const acquireEarpiece = () => {
+  holders++;
+  if (restoreTimer != null) {
+    clearTimeout(restoreTimer);
+    restoreTimer = null;
+  }
+  if (!isRouted) {
+    isRouted = true;
+    applyEarpieceRoute(true);
+  }
+  let isReleased = false;
+  return () => {
+    if (isReleased) return;
+    isReleased = true;
+    holders--;
+    if (holders > 0 || restoreTimer != null) return;
+    restoreTimer = setTimeout(() => {
+      restoreTimer = null;
+      if (holders > 0 || !isRouted) return;
+      isRouted = false;
+      applyEarpieceRoute(false);
+    }, 0);
+  };
+};
+
+/** Whether audio is currently routed to the earpiece. */
+export const isEarpieceRouted = () => isRouted;
+/**
+ * One step of raise to listen. `isListening`: this player holds the earpiece.
+ * Raised with the note current: listen (from the start if under a second in).
+ * Lowered while listening: back to the speaker and pause. No longer current
+ * while listening (it ended or another note took over): drop the claim without
+ * pausing, so the next note can keep the earpiece.
+ */
+export const raiseToListenStep = ({
+  isListening,
+  isNearEar,
+  isCurrent,
+  positionSeconds
+}) => {
+  if (!isListening) return isNearEar && isCurrent ? {
+    type: 'listen',
+    fromStart: !(positionSeconds >= RAISE_RESTART_SECONDS)
+  } : null;
+  if (!isNearEar) return {
+    type: 'pause'
+  };
+  if (!isCurrent) return {
+    type: 'release'
+  };
+  return null;
+};
+/**
+ * Raise to listen for one player, driven by `mediaPlayback.isNearEar`. Voice
+ * and round notes use it. A no-op outside a `Chat`.
+ */
+export const useRaiseToListen = t0 => {
+  const $ = _c(14);
+  const {
+    isCurrent,
+    getPositionSeconds,
+    listen,
+    pause
+  } = t0;
+  const isNearEar = useIsNearEar();
+  const releaseRef = useRef(null);
+  let t1;
+  if ($[0] !== getPositionSeconds || $[1] !== listen || $[2] !== pause) {
+    t1 = {
+      getPositionSeconds,
+      listen,
+      pause
+    };
+    $[0] = getPositionSeconds;
+    $[1] = listen;
+    $[2] = pause;
+    $[3] = t1;
+  } else {
+    t1 = $[3];
+  }
+  const actionsRef = useRef(t1);
+  let t2;
+  if ($[4] !== getPositionSeconds || $[5] !== listen || $[6] !== pause) {
+    t2 = () => {
+      actionsRef.current = {
+        getPositionSeconds,
+        listen,
+        pause
+      };
+    };
+    $[4] = getPositionSeconds;
+    $[5] = listen;
+    $[6] = pause;
+    $[7] = t2;
+  } else {
+    t2 = $[7];
+  }
+  useLayoutEffect(t2);
+  let t3;
+  let t4;
+  if ($[8] !== isCurrent || $[9] !== isNearEar) {
+    t3 = () => {
+      const action = raiseToListenStep({
+        isListening: releaseRef.current != null,
+        isNearEar,
+        isCurrent,
+        positionSeconds: actionsRef.current.getPositionSeconds()
+      });
+      if (!action) {
+        return;
+      }
+      if (action.type === "listen") {
+        releaseRef.current = acquireEarpiece();
+        actionsRef.current.listen(action.fromStart);
+        return;
+      }
+      releaseRef.current?.();
+      releaseRef.current = null;
+      if (action.type === "pause") {
+        actionsRef.current.pause();
+      }
+    };
+    t4 = [isNearEar, isCurrent];
+    $[8] = isCurrent;
+    $[9] = isNearEar;
+    $[10] = t3;
+    $[11] = t4;
+  } else {
+    t3 = $[10];
+    t4 = $[11];
+  }
+  useEffect(t3, t4);
+  let t5;
+  let t6;
+  if ($[12] === Symbol.for("react.memo_cache_sentinel")) {
+    t5 = () => () => {
+      releaseRef.current?.();
+      releaseRef.current = null;
+    };
+    t6 = [];
+    $[12] = t5;
+    $[13] = t6;
+  } else {
+    t5 = $[12];
+    t6 = $[13];
+  }
+  useEffect(t5, t6);
+};
+//# sourceMappingURL=earpiece.js.map

package/lib/components/earpiece.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"earpiece.js","names":["useEffect","useLayoutEffect","useRef","getAudioApi","getExpoAudio","useIsNearEar","audioApi","expoAudio","RAISE_RESTART_SECONDS","applyEarpieceRoute","isEarpiece","AudioManager","setAudioSessionOptions","iosCategory","iosMode","iosOptions","pending","setAudioModeAsync","playsInSilentMode","allowsRecording","shouldRouteThroughEarpiece","catch","holders","isRouted","restoreTimer","acquireEarpiece","clearTimeout","isReleased","setTimeout","isEarpieceRouted","raiseToListenStep","isListening","isNearEar","isCurrent","positionSeconds","type","fromStart","useRaiseToListen","t0","$","_c","getPositionSeconds","listen","pause","releaseRef","t1","actionsRef","t2","current","t3","t4","action","t5","t6","Symbol","for"],"sources":["../../src/components/earpiece.ts"],"sourcesContent":["import { useEffect, useLayoutEffect, useRef } from 'react'\n\nimport { getAudioApi, getExpoAudio } from '../optional'\nimport { useIsNearEar } from './mediaPlayback'\n\n/**\n * Raise to listen: with a voice or round note current, holding the phone to\n * the ear moves playback to the earpiece and plays it, restarting a note that\n * had played for under a second; lowering it goes back to the speaker and\n * pauses.\n */\n\n// Both audio engines are optional peers, resolved like everywhere else.\nconst audioApi = getAudioApi()\nconst expoAudio = getExpoAudio()\n\n/**\n * `startAudioAgain` seeks to 0 when `audioProgress * duration` is under a\n * second: a note just started is heard from its beginning at the ear.\n */\nexport const RAISE_RESTART_SECONDS = 1\n\n/**\n * Points both engines at the earpiece or back at the speaker.\n *\n * iOS has one shared AVAudioSession: the `playAndRecord` category without\n * `defaultToSpeaker` plays through the receiver, like the voice-call\n * stream on Android. `playback` is the plain speaker route\n * the players start in. On Android, expo-audio's `shouldRouteThroughEarpiece`\n * switches the system to communication mode with the speakerphone off;\n * react-native-audio-api has no Android routing of its own.\n */\nexport const applyEarpieceRoute = (isEarpiece: boolean) => {\n  try {\n    audioApi?.AudioManager?.setAudioSessionOptions?.(\n      isEarpiece\n        ? { iosCategory: 'playAndRecord', iosMode: 'default', iosOptions: [] }\n        : { iosCategory: 'playback', iosMode: 'default', iosOptions: [] }\n    )\n  } catch {\n    // an engine that cannot route must not stop playback\n  }\n\n  try {\n    const pending = expoAudio?.setAudioModeAsync?.({\n      playsInSilentMode: true,\n      allowsRecording: isEarpiece,\n      shouldRouteThroughEarpiece: isEarpiece,\n    })\n    pending?.catch?.(() => {})\n  } catch {\n    // an engine that cannot route must not stop playback\n  }\n}\n\n/*\n * Several players can want the earpiece across a hand-over (a note ends at the\n * ear and auto-play starts the next one), so the route is reference counted,\n * and going back to the speaker waits a tick: the next note's claim, made in\n * the same commit, cancels it instead of flipping the route twice.\n */\nlet holders = 0\nlet isRouted = false\nlet restoreTimer: ReturnType<typeof setTimeout> | null = null\n\n/** Holds the earpiece route until the returned release is called. */\nexport const acquireEarpiece = () => {\n  holders++\n  if (restoreTimer != null) {\n    clearTimeout(restoreTimer)\n    restoreTimer = null\n  }\n  if (!isRouted) {\n    isRouted = true\n    applyEarpieceRoute(true)\n  }\n\n  let isReleased = false\n  return () => {\n    if (isReleased)\n      return\n    isReleased = true\n    holders--\n    if (holders > 0 || restoreTimer != null)\n      return\n\n    restoreTimer = setTimeout(() => {\n      restoreTimer = null\n      if (holders > 0 || !isRouted)\n        return\n      isRouted = false\n      applyEarpieceRoute(false)\n    }, 0)\n  }\n}\n\n/** Whether audio is currently routed to the earpiece. */\nexport const isEarpieceRouted = () => isRouted\n\nexport type RaiseToListenAction =\n  | { type: 'listen', fromStart: boolean }\n  | { type: 'pause' }\n  | { type: 'release' }\n  | null\n\n/**\n * One step of raise to listen. `isListening`: this player holds the earpiece.\n * Raised with the note current: listen (from the start if under a second in).\n * Lowered while listening: back to the speaker and pause. No longer current\n * while listening (it ended or another note took over): drop the claim without\n * pausing, so the next note can keep the earpiece.\n */\nexport const raiseToListenStep = ({\n  isListening,\n  isNearEar,\n  isCurrent,\n  positionSeconds,\n}: {\n  isListening: boolean\n  isNearEar: boolean\n  isCurrent: boolean\n  positionSeconds: number\n}): RaiseToListenAction => {\n  if (!isListening)\n    return isNearEar && isCurrent\n      ? { type: 'listen', fromStart: !(positionSeconds >= RAISE_RESTART_SECONDS) }\n      : null\n\n  if (!isNearEar)\n    return { type: 'pause' }\n  if (!isCurrent)\n    return { type: 'release' }\n  return null\n}\n\nexport interface RaiseToListenOptions {\n  /** The note is current: playing, or paused part-way. */\n  isCurrent: boolean\n  /** Seconds played so far. */\n  getPositionSeconds: () => number\n  /** Play at the ear; `fromStart` rewinds first. */\n  listen: (fromStart: boolean) => void\n  pause: () => void\n}\n\n/**\n * Raise to listen for one player, driven by `mediaPlayback.isNearEar`. Voice\n * and round notes use it. A no-op outside a `Chat`.\n */\nexport const useRaiseToListen = ({ isCurrent, getPositionSeconds, listen, pause }: RaiseToListenOptions) => {\n  const isNearEar = useIsNearEar()\n  const releaseRef = useRef<(() => void) | null>(null)\n  const actionsRef = useRef({ getPositionSeconds, listen, pause })\n  useLayoutEffect(() => {\n    actionsRef.current = { getPositionSeconds, listen, pause }\n  })\n\n  useEffect(() => {\n    const action = raiseToListenStep({\n      isListening: releaseRef.current != null,\n      isNearEar,\n      isCurrent,\n      positionSeconds: actionsRef.current.getPositionSeconds(),\n    })\n    if (!action)\n      return\n\n    if (action.type === 'listen') {\n      // Route first, so the first syllable is not heard on the speaker.\n      releaseRef.current = acquireEarpiece()\n      actionsRef.current.listen(action.fromStart)\n      return\n    }\n\n    releaseRef.current?.()\n    releaseRef.current = null\n    if (action.type === 'pause')\n      actionsRef.current.pause()\n  }, [isNearEar, isCurrent])\n\n  useEffect(() => () => {\n    releaseRef.current?.()\n    releaseRef.current = null\n  }, [])\n}\n"],"mappings":"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","ignoreList":[]}

package/lib/components/floatingNoteMath.d.ts

@@ -0,0 +1,66 @@
+/** The floating circle is 120dp. */
+export declare const FLOATING_NOTE_SIZE = 120;
+/** Distance kept from the edges it docks to (`getSideCoord`). */
+export declare const FLOATING_NOTE_MARGIN = 10;
+/** Released this close to an edge, it snaps onto it (`animateToBoundsMaybe`). */
+export declare const FLOATING_NOTE_SNAP = 20;
+/** Show, hide and settle all run 150ms with a decelerate curve. */
+export declare const FLOATING_NOTE_MS = 150;
+/** It appears from, and shrinks back to, 80% of its size. */
+export declare 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 declare const FLOATING_NOTE_FLING_S = 0.1;
+/** Which edge it is docked to on one axis, or `free` in between. */
+export type DockSide = 'start' | 'end' | 'free';
+/**
+ * A remembered position that survives the area resizing: the side per axis,
+ * or the fraction across it.
+ */
+export interface FloatingDock {
+    sideX: DockSide;
+    px: number;
+    sideY: DockSide;
+    py: number;
+}
+/** The first position: the top right corner. */
+export declare const DEFAULT_FLOATING_DOCK: FloatingDock;
+export interface FloatingArea {
+    width: number;
+    height: number;
+}
+/** One axis of `getSideCoord`: `room` is the area's length less the note's. */
+export declare const sideCoord: (side: DockSide, fraction: number, room: number) => number;
+export declare const dockPoint: (dock: FloatingDock, area: FloatingArea, size?: number) => {
+    x: number;
+    y: number;
+};
+/**
+ * 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 declare const clampDrag: (x: number, y: number, area: FloatingArea, size?: number) => {
+    x: number;
+    y: number;
+};
+/** Past a side it fades, down to half at the furthest it may go. */
+export declare const dragAlpha: (x: number, width: number, size?: number) => number;
+export interface FloatingSettle {
+    x: number;
+    y: number;
+    /** It slides out past a side; playback stops once it is gone. */
+    isClosing: boolean;
+    /** The position to remember, unchanged when closing. */
+    dock: FloatingDock;
+}
+/**
+ * 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 declare const settleFloatingNote: (x: number, y: number, velocityX: number, area: FloatingArea, dock: FloatingDock, size?: number) => FloatingSettle;
+//# sourceMappingURL=floatingNoteMath.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"floatingNoteMath.d.ts","sourceRoot":"","sources":["../../src/components/floatingNoteMath.ts"],"names":[],"mappings":"AAOA,oCAAoC;AACpC,eAAO,MAAM,kBAAkB,MAAM,CAAA;AACrC,iEAAiE;AACjE,eAAO,MAAM,oBAAoB,KAAK,CAAA;AACtC,iFAAiF;AACjF,eAAO,MAAM,kBAAkB,KAAK,CAAA;AACpC,mEAAmE;AACnE,eAAO,MAAM,gBAAgB,MAAM,CAAA;AACnC,6DAA6D;AAC7D,eAAO,MAAM,0BAA0B,MAAM,CAAA;AAC7C;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,MAAM,CAAA;AAExC,oEAAoE;AACpE,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,CAAA;AAE/C;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,QAAQ,CAAA;IACf,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,QAAQ,CAAA;IACf,EAAE,EAAE,MAAM,CAAA;CACX;AAED,gDAAgD;AAChD,eAAO,MAAM,qBAAqB,EAAE,YAA6D,CAAA;AAEjG,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAED,+EAA+E;AAC/E,eAAO,MAAM,SAAS,GAAI,MAAM,QAAQ,EAAE,UAAU,MAAM,EAAE,MAAM,MAAM,WAOvE,CAAA;AAED,eAAO,MAAM,SAAS,GAAI,MAAM,YAAY,EAAE,MAAM,YAAY,EAAE,aAAyB;;;CAM1F,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS,GAAI,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,MAAM,YAAY,EAAE,aAAyB;;;CAO5F,CAAA;AAED,oEAAoE;AACpE,eAAO,MAAM,SAAS,GAAI,GAAG,MAAM,EAAE,OAAO,MAAM,EAAE,aAAyB,WAQ5E,CAAA;AAED,MAAM,WAAW,cAAc;IAC7B,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,iEAAiE;IACjE,SAAS,EAAE,OAAO,CAAA;IAClB,wDAAwD;IACxD,IAAI,EAAE,YAAY,CAAA;CACnB;AAOD;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAC7B,GAAG,MAAM,EACT,GAAG,MAAM,EACT,WAAW,MAAM,EACjB,MAAM,YAAY,EAClB,MAAM,YAAY,EAClB,aAAyB,KACxB,cAyCF,CAAA"}