Add option for whether to dismiss a footnote when touching outside it

This option is especially useful if the footnote is expanded inline
instead of in a popover because then it doesn't make sense to hide it
when clicking another place in the document.

src/dom/events.ts

@@ -59,7 +59,7 @@ const delegate = (
 export function addListeners(useCases: UseCases): () => void {
   const controller = new AbortController()
   const { signal } = controller
-  const toggleOnTouch = touchHandler(useCases.toggle, useCases.dismissAll)
+  const toggleOnTouch = touchHandler(useCases.toggle, useCases.documentTouch)
   const dismissOnEscape = escapeHandler(useCases.dismissAll)
   const throttledReposition = throttle(useCases.repositionAll, FRAME)
   const throttledResize = throttle(useCases.resizeAll, FRAME)

src/settings.ts

@@ -17,6 +17,7 @@ export const DEFAULT_SETTINGS: Settings = {
   anchorPattern: /(fn|footnote|note)[:\-_\d]/gi,
   dismissDelay: 100,
   dismissOnUnhover: false,
+  dismissOnDocumentTouch: true,
   footnoteSelector: 'li',
   hoverDelay: 250,
   numberResetSelector: '',

src/use-cases.ts

@@ -10,6 +10,7 @@ export type UseCaseSettings<T> = Readonly<{
   dismissCallback?: ActionCallback<T>
   dismissDelay: number
   dismissOnUnhover: boolean
+  dismissOnDocumentTouch: boolean
   hoverDelay: number
 }>
 
@@ -36,6 +37,7 @@ export type UseCases = Readonly<{
   activate: DelayedFootnoteAction
   dismiss: DelayedFootnoteAction
   dismissAll: () => void
+  documentTouch: () => void
   hover: FootnoteAction
   repositionAll: () => void
   resizeAll: () => void
@@ -82,12 +84,20 @@ export function createUseCases<T>(
     }
   }
 
+  const dismissAll = () => footnotes.forEach(dismiss(settings.dismissDelay))
+
   return {
     activate: (id, delay) => ifFound(activate(delay))(id),
 
     dismiss: (id, delay) => ifFound(dismiss(delay))(id),
 
-    dismissAll: () => footnotes.forEach(dismiss(settings.dismissDelay)),
+    dismissAll,
+
+    documentTouch: () => {
+      if (settings.dismissOnDocumentTouch) {
+        dismissAll()
+      }
+    },
 
     repositionAll: () => footnotes.forEach((current) => current.reposition()),