@inkbar/svelte 0.4.0 → 0.6.0

package/dist/components/InkRoot.svelte

@@ -11,7 +11,13 @@
     PdfAssets,
     SignatureStore,
   } from '@inkbar/core'
-  import type { Tool, ToolId, ZoomValue } from '@inkbar/core/dom'
+  import type {
+    DecorateAnnotation,
+    InkPlugin,
+    Tool,
+    ToolId,
+    ZoomValue,
+  } from '@inkbar/core/dom'
   import type { Snippet } from 'svelte'
   import type { HTMLAttributes } from 'svelte/elements'
 
@@ -39,6 +45,19 @@
      * document opens.
      */
     tools?: Tool[] | undefined
+    /**
+     * Plugins, set up once when the root is created; a later change to this prop is not
+     * applied. Their tools join `tools`, their decoration and page layers apply to every
+     * document, and their commands are placed with `InkCommand` or `useCommand`.
+     */
+    plugins?: InkPlugin[] | undefined
+    /**
+     * Adds `data-*` attributes, classes and a screen-reader description to each annotation's
+     * element (see `DecorateAnnotation`). Decorations re-apply whenever the annotations change
+     * and when this prop changes, without rebuilding the viewer. Pass a new function when its
+     * output would change for any other reason.
+     */
+    decorateAnnotation?: DecorateAnnotation | undefined
     /**
      * The font families text boxes offer, replacing the PDF standard families
      * (`FONT_FAMILIES`). Fonts beyond those are the PDF writer's to embed.
@@ -79,8 +98,11 @@
     createSnapshotHistory,
     InkError as InkErrorClass,
     openDocument,
+    readonly,
+    writable,
   } from '@inkbar/core'
   import {
+    createPluginHost,
     createToolOptions,
     cssVariableDefaults,
     FONT_FAMILIES,
@@ -94,7 +116,8 @@
   import { setInkContext, type InkContext, type InkHistory } from '../context.js'
   import { useReadable } from '../use-readable.svelte.js'
 
-  import type { ToolController, Viewport } from '@inkbar/core/dom'
+  import type { PluginHistory } from '@inkbar/core'
+  import type { PluginHost, ToolController, Viewport } from '@inkbar/core/dom'
 
   let {
     src,
@@ -107,6 +130,8 @@
     tool = $bindable(),
     onToolChange,
     tools: hostTools,
+    plugins,
+    decorateAnnotation,
     fonts,
     signatures: signatureStore,
     signatureFonts,
@@ -138,6 +163,7 @@
   const IDLE: InkStatus = { state: 'idle' }
   const NO_ANNOTATIONS: readonly Annotation[] = []
   const NO_IDS: readonly string[] = []
+  const noop = (): void => undefined
 
   /** Signed URLs change; the key does not. Bytes and Blobs are their own identity. */
   function identity(source: DocumentSource | null): unknown {
@@ -152,6 +178,8 @@
   }
 
   let document = $state.raw<InkDocument | null>(null)
+  /** The same document outside the reactive graph, for the plugins' history. */
+  let documentNow: InkDocument | null = null
   /** Overrides the document's status while opening, and when opening itself failed. */
   let override = $state.raw<InkStatus | null>(null)
   let activated = $state<string | null>(null)
@@ -198,6 +226,8 @@
     const pw = sourcePassword
     let cancelled = false
     let opened: InkDocument | null = null
+    /** The snapshot history's hold on a controlled document's store. */
+    let detach: () => void = noop
     untrack(() => snapshotHistory.clear())
     const source = untrack(() => src)
     if (source === null) {
@@ -241,7 +271,13 @@
         const current = untrack(() => annotations)
         if (doc.annotations.mode === 'controlled' && current !== undefined)
           doc.annotations.setControlledValue(current)
+        documentNow = doc
         document = doc
+        // Controlled edits run the plugins' reactions inside their own snapshot step.
+        if (doc.annotations.mode === 'controlled')
+          detach = snapshotHistory.attach(doc.annotations)
+        // The document is current, so the host reads its history when it hears of it.
+        hostDocument.set(doc)
         override = null
         setTestHook(ref, doc)
         const s = doc.status.get()
@@ -264,7 +300,11 @@
     })()
     return () => {
       cancelled = true
+      // Cleared first, so the plugins close their stores while the document is still alive.
+      hostDocument.set(null)
+      detach()
       opened?.destroy()
+      documentNow = null
       document = null
       setTestHook(ref, undefined)
     }
@@ -279,12 +319,15 @@
   })
 
   function setTool(id: ToolId): void {
+    // Picking the active tool again starts it afresh, as after a one-shot tool's use.
+    if (currentTool === id && tools?.active.get() === id) tools.set(id)
     tool = id
     onToolChange?.(id)
   }
   function setActivated(id: string | null): void {
     activated = id
     activatedNow = id
+    hostActivated.set(id)
     if (id) onActivate?.(id)
   }
   function reportZoom(z: ZoomValue): void {
@@ -315,8 +358,65 @@
       else if (document) document.history.batch(fn)
       else fn()
     },
+    track: (store) => pluginHistory.track(store),
+    react: (fn) => pluginHistory.react(fn),
   }
 
+  /**
+   * The history the plugins reach, picked by the open document's mode when they call. The host
+   * reads it as soon as a document opens, so it goes by `documentNow`, which is set by then.
+   */
+  const activeHistory = (): PluginHistory | undefined => {
+    const doc = documentNow
+    if (!doc) return undefined
+    return doc.annotations.mode === 'controlled' ? snapshotHistory : doc.history
+  }
+  const pluginHistory: PluginHistory = {
+    batch: (fn) => {
+      const h = activeHistory()
+      if (h) h.batch(fn)
+      else fn()
+    },
+    track: (store) => activeHistory()?.track(store) ?? noop,
+    react: (fn) => activeHistory()?.react(fn) ?? noop,
+  }
+
+  /*
+   * One plugin host for the root's life, built in an effect so that no `setup` runs on the
+   * server, where effects never run and nothing would clean it up. Until then `pluginHost` is
+   * null and InkCommand renders its command disabled. The open effect above runs first, but
+   * the document it opens arrives after an await, so the host is in place by then. It follows
+   * these writables rather than the root's state: the open effect sets `hostDocument` once
+   * `documentNow` is current.
+   */
+  const hostDocument = writable<InkDocument | null>(null)
+  const hostActivated = writable<string | null>(null)
+  const viewportEl = writable<HTMLElement | null>(null)
+  let pluginHost = $state.raw<PluginHost | null>(null)
+  $effect(() => {
+    const host = untrack(() =>
+      createPluginHost({
+        // Read once, as documented on the prop.
+        plugins: plugins ?? [],
+        document: readonly(hostDocument),
+        history: () => pluginHistory,
+        activated: readonly(hostActivated),
+        // As in `createViewer`: an id not in the open document is ignored.
+        setActivated: (id) => {
+          if (id === null || documentNow?.annotations.get(id)) setActivated(id)
+        },
+        root: readonly(viewportEl),
+        decorate: () => decorateAnnotation,
+        viewport: () => viewport,
+      })
+    )
+    pluginHost = host
+    // Destroyed after InkViewport's engine and its plugin layers, as in `createViewer`: Svelte
+    // creates a component's effects after its template and tears them down in creation order,
+    // so the children's teardowns run first.
+    return () => host.destroy()
+  })
+
   /** The document's tool style; it batches through `inkHistory`, whichever mode is on. */
   const styleTracker = $derived.by(() => {
     const doc = document
@@ -325,7 +425,8 @@
       trackToolStyle({
         store: doc.annotations,
         history: { batch: (fn) => inkHistory.batch(fn) },
-        tools: hostTools,
+        // The plugins' tools too, so a plugin tool's style group applies.
+        tools: [...(hostTools ?? []), ...(pluginHost?.tools ?? [])],
         tool: currentTool,
       })
     )
@@ -351,6 +452,10 @@
     get selection() {
       return selection.current
     },
+    get pluginHost() {
+      return pluginHost
+    },
+    viewportEl,
     get viewport() {
       return viewport
     },
@@ -364,6 +469,9 @@
     get hostTools() {
       return hostTools
     },
+    get decorateAnnotation() {
+      return decorateAnnotation
+    },
     get fonts() {
       return fonts ?? FONT_FAMILIES
     },

package/dist/components/InkRoot.svelte.d.ts

@@ -1,6 +1,6 @@
 import type { ChildSnippet } from './child-snippet.js';
 import type { Annotation, AnnotationChange, AnnotationDefaults, DocumentSource, InkDocument, InkError, InkStatus, PdfAssets, SignatureStore } from '@inkbar/core';
-import type { Tool, ToolId, ZoomValue } from '@inkbar/core/dom';
+import type { DecorateAnnotation, InkPlugin, Tool, ToolId, ZoomValue } from '@inkbar/core/dom';
 import type { Snippet } from 'svelte';
 import type { HTMLAttributes } from 'svelte/elements';
 export interface InkRootProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children' | 'onchange' | 'onerror'> {
@@ -24,6 +24,19 @@ export interface InkRootProps extends Omit<HTMLAttributes<HTMLDivElement>, 'chil
      * document opens.
      */
     tools?: Tool[] | undefined;
+    /**
+     * Plugins, set up once when the root is created; a later change to this prop is not
+     * applied. Their tools join `tools`, their decoration and page layers apply to every
+     * document, and their commands are placed with `InkCommand` or `useCommand`.
+     */
+    plugins?: InkPlugin[] | undefined;
+    /**
+     * Adds `data-*` attributes, classes and a screen-reader description to each annotation's
+     * element (see `DecorateAnnotation`). Decorations re-apply whenever the annotations change
+     * and when this prop changes, without rebuilding the viewer. Pass a new function when its
+     * output would change for any other reason.
+     */
+    decorateAnnotation?: DecorateAnnotation | undefined;
     /**
      * The font families text boxes offer, replacing the PDF standard families
      * (`FONT_FAMILIES`). Fonts beyond those are the PDF writer's to embed.

package/dist/components/InkRoot.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InkRoot.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/components/InkRoot.svelte.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"InkRoot.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/components/InkRoot.svelte.ts"],"names":[],"mappings":"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"}

package/dist/components/InkShapeMenu.svelte

@@ -18,9 +18,7 @@
 
 <script lang="ts">
   import {
-    focusInitialMenuItem,
     handleMenuKeys,
-    menuItems,
     SHAPE_COLUMNS,
     SHAPE_ICONS,
     SHAPE_KINDS,
@@ -35,12 +33,15 @@
   import { useToolOptions } from '../hooks/useToolOptions.svelte.js'
 
   import InkIcon from './InkIcon.svelte'
+  import { createMenuOpenFocus } from './menu-open-focus.js'
 
   let { class: className, children, ...rest }: InkShapeMenuProps = $props()
 
   const current = useTool()
   const shape = useToolOptions<ShapeOptions>('shape')
   let open = $state(false)
+  /** The split button: the panel lines up under it rather than the chevron. */
+  let group = $state<HTMLElement | null>(null)
 
   const model = $derived(shapeMenuModel(shape.options, SHAPE_KINDS))
   const active = $derived(current.tool === 'shape')
@@ -48,15 +49,14 @@
   let menu = $state<HTMLElement | null>(null)
 
   /** ArrowDown opens on the first item; a click opens on the checked one. */
-  let focusFirst = false
-  // Bits runs the open-focus callback more than once, so the flag outlives it; reset on close.
+  const openFocus = createMenuOpenFocus()
   $effect(() => {
-    if (!open) focusFirst = false
+    if (!open) openFocus.reset()
   })
   function onTriggerKeydown(e: KeyboardEvent): void {
     if (e.key !== 'ArrowDown' || e.defaultPrevented || open) return
     e.preventDefault()
-    focusFirst = true
+    openFocus.first()
     open = true
   }
 
@@ -68,6 +68,7 @@
 </script>
 
 <div
+  bind:this={group}
   role="group"
   aria-label="Shape"
   class={['ink-split-button ink-shape-menu', className]}
@@ -115,17 +116,13 @@
         class="ink-select-content ink-menu-content"
         data-ink-select-content=""
         data-ink-menu="shape"
+        customAnchor={group}
         side="bottom"
         align="start"
         sideOffset={4}
         collisionPadding={8}
-        onOpenAutoFocus={(e) => {
-          e.preventDefault()
-          if (menu) {
-            if (focusFirst) menuItems(menu)[0]?.focus({ preventScroll: true })
-            else focusInitialMenuItem(menu)
-          }
-        }}
+        onOpenAutoFocus={(e) => openFocus.onOpenAutoFocus(e, menu)}
+        onfocusin={openFocus.onfocusin}
         onkeydown={(e) => menu && handleMenuKeys(e, menu)}
       >
         <div

package/dist/components/InkShapeMenu.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InkShapeMenu.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/components/InkShapeMenu.svelte.ts"],"names":[],"mappings":"AAGE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAA;AACrC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAErD;;;;GAIG;AACH,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAC7C,cAAc,CAAC,cAAc,CAAC,EAC9B,UAAU,CACX;IACC,uCAAuC;IACvC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CAC/B;AAoGH,QAAA,MAAM,YAAY,uDAAwC,CAAC;AAC3D,KAAK,YAAY,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;AACpD,eAAe,YAAY,CAAC"}
+{"version":3,"file":"InkShapeMenu.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/components/InkShapeMenu.svelte.ts"],"names":[],"mappings":"AAGE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAA;AACrC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAErD;;;;GAIG;AACH,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAC7C,cAAc,CAAC,cAAc,CAAC,EAC9B,UAAU,CACX;IACC,uCAAuC;IACvC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CAC/B;AA+FH,QAAA,MAAM,YAAY,uDAAwC,CAAC;AAC3D,KAAK,YAAY,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;AACpD,eAAe,YAAY,CAAC"}

package/dist/components/InkSignatureMenu.svelte

@@ -21,9 +21,7 @@
 
 <script lang="ts">
   import {
-    focusInitialMenuItem,
     handleMenuKeys,
-    menuItems,
     SIGNATURE_LABELS,
     signatureMenuModel,
     signaturePreview,
@@ -39,6 +37,7 @@
 
   import InkIcon from './InkIcon.svelte'
   import InkSignatureDialog from './InkSignatureDialog.svelte'
+  import { createMenuOpenFocus } from './menu-open-focus.js'
 
   import type { SignatureOptions, SignatureTemplate } from '@inkbar/core'
 
@@ -58,15 +57,16 @@
   const model = $derived(signatureMenuModel(templates.current, signature.options))
   const active = $derived(current.tool === 'signature')
   let open = $state(false)
+  /** The split button: the panel lines up under it rather than the chevron. */
+  let group = $state<HTMLElement | null>(null)
   let creating = $state(false)
   let menu = $state<HTMLElement | null>(null)
   let main = $state<HTMLElement | null>(null)
 
   /** ArrowDown opens on the first item; a click opens on the checked one. */
-  let focusFirst = false
-  // Bits runs the open-focus callback more than once, so the flag outlives it; reset on close.
+  const openFocus = createMenuOpenFocus()
   $effect(() => {
-    if (!open) focusFirst = false
+    if (!open) openFocus.reset()
   })
   /** Set while the menu closes for the dialog, which takes focus instead of the trigger. */
   let toDialog = false
@@ -74,7 +74,7 @@
   function onTriggerKeydown(e: KeyboardEvent): void {
     if (e.key !== 'ArrowDown' || e.defaultPrevented || open) return
     e.preventDefault()
-    focusFirst = true
+    openFocus.first()
     open = true
   }
 
@@ -115,6 +115,7 @@
 </script>
 
 <div
+  bind:this={group}
   role="group"
   aria-label={SIGNATURE_LABELS.sign}
   class={['ink-split-button ink-signature-menu', className]}
@@ -160,17 +161,13 @@
         class="ink-select-content ink-menu-content"
         data-ink-select-content=""
         data-ink-menu="signature"
+        customAnchor={group}
         side="bottom"
         align="start"
         sideOffset={4}
         collisionPadding={8}
-        onOpenAutoFocus={(e) => {
-          e.preventDefault()
-          if (menu) {
-            if (focusFirst) menuItems(menu)[0]?.focus({ preventScroll: true })
-            else focusInitialMenuItem(menu)
-          }
-        }}
+        onOpenAutoFocus={(e) => openFocus.onOpenAutoFocus(e, menu)}
+        onfocusin={openFocus.onfocusin}
         onCloseAutoFocus={(e) => {
           if (toDialog) e.preventDefault()
           toDialog = false

package/dist/components/InkSignatureMenu.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InkSignatureMenu.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/components/InkSignatureMenu.svelte.ts"],"names":[],"mappings":"AAGE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAA;AACrC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAErD;;;;;GAKG;AACH,MAAM,WAAW,qBAAsB,SAAQ,IAAI,CACjD,cAAc,CAAC,cAAc,CAAC,EAC9B,UAAU,CACX;IACC,uCAAuC;IACvC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC9B,mFAAmF;IACnF,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;CACtC;AAuLH,QAAA,MAAM,gBAAgB,2DAAwC,CAAC;AAC/D,KAAK,gBAAgB,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC5D,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"InkSignatureMenu.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/components/InkSignatureMenu.svelte.ts"],"names":[],"mappings":"AAGE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAA;AACrC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAErD;;;;;GAKG;AACH,MAAM,WAAW,qBAAsB,SAAQ,IAAI,CACjD,cAAc,CAAC,cAAc,CAAC,EAC9B,UAAU,CACX;IACC,uCAAuC;IACvC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC9B,mFAAmF;IACnF,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;CACtC;AAkLH,QAAA,MAAM,gBAAgB,2DAAwC,CAAC;AAC/D,KAAK,gBAAgB,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC5D,eAAe,gBAAgB,CAAC"}

package/dist/components/InkThreadPopover.svelte

@@ -137,6 +137,13 @@
   }
 </script>
 
+<svelte:document
+  onpointerdowncapture={(e) =>
+    open && focusReturn.onPressOutside(e, '[data-ink-thread-popover]', close)}
+  onpointerup={focusReturn.onPressEnd}
+  onpointercancel={focusReturn.onPressEnd}
+/>
+
 <Popover.Root bind:open={() => open, onOpenChange}>
   <Popover.Portal>
     {#if note && anchor}

package/dist/components/InkThreadPopover.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InkThreadPopover.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/components/InkThreadPopover.svelte.ts"],"names":[],"mappings":"AAGE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAC9D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAA;AAErC,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC,sBAAsB,CAAC,CAAC,GAAG,SAAS,CAAA;CACzD;AA6LH,QAAA,MAAM,gBAAgB,2DAAwC,CAAC;AAC/D,KAAK,gBAAgB,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC5D,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"InkThreadPopover.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/components/InkThreadPopover.svelte.ts"],"names":[],"mappings":"AAGE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAC9D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAA;AAErC,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC,sBAAsB,CAAC,CAAC,GAAG,SAAS,CAAA;CACzD;AAgMH,QAAA,MAAM,gBAAgB,2DAAwC,CAAC;AAC/D,KAAK,gBAAgB,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC5D,eAAe,gBAAgB,CAAC"}

package/dist/components/InkToolButton.svelte

@@ -27,6 +27,7 @@
   } from '@inkbar/icons'
   import { Toolbar } from 'bits-ui'
 
+  import { useInkContext } from '../context.js'
   import { useTool } from '../hooks/useTool.svelte.js'
 
   import { asBitsProps } from './child-snippet.js'
@@ -56,11 +57,18 @@
     ...rest
   }: InkToolButtonProps = $props()
 
+  const ctx = useInkContext('InkToolButton')
   const current = useTool()
   const active = $derived(current.tool === tool)
-  // A host tool has no built-in name or icon: `label` and `children` supply them.
-  const name = $derived(label ?? TOOL_LABELS[tool] ?? tool)
-  const icon = $derived(ICONS[tool])
+  /** A host or plugin tool by this id, for the name and icon core has none for. */
+  const own = $derived(
+    [...(ctx.hostTools ?? []), ...(ctx.pluginHost?.tools ?? [])].find(
+      (t) => t.id === tool
+    )
+  )
+  // `label` and `children` win; then core's name and icon; then the tool's own.
+  const name = $derived(label ?? TOOL_LABELS[tool] ?? own?.label ?? tool)
+  const icon = $derived(ICONS[tool] ?? own?.icon)
 </script>
 
 <Toolbar.Button

package/dist/components/InkToolButton.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InkToolButton.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/components/InkToolButton.svelte.ts"],"names":[],"mappings":"AAGE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAA;AACrC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AAE3D,MAAM,WAAW,kBAAmB,SAAQ,IAAI,CAAC,oBAAoB,EAAE,UAAU,CAAC;IAChF,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,GAAG,SAAS,CAAA;IACpE,KAAK,CAAC,EAAE,YAAY,GAAG,SAAS,CAAA;CACjC;AA4EH,QAAA,MAAM,aAAa,wDAAwC,CAAC;AAC5D,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AACtD,eAAe,aAAa,CAAC"}
+{"version":3,"file":"InkToolButton.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/components/InkToolButton.svelte.ts"],"names":[],"mappings":"AAGE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAA;AACrC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AAE3D,MAAM,WAAW,kBAAmB,SAAQ,IAAI,CAAC,oBAAoB,EAAE,UAAU,CAAC;IAChF,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,GAAG,SAAS,CAAA;IACpE,KAAK,CAAC,EAAE,YAAY,GAAG,SAAS,CAAA;CACjC;AAqFH,QAAA,MAAM,aAAa,wDAAwC,CAAC;AAC5D,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AACtD,eAAe,aAAa,CAAC"}

package/dist/components/InkViewport.svelte

@@ -43,7 +43,7 @@
   import InkPage from './InkPage.svelte'
 
   import type { InkDocument, InkStatus } from '@inkbar/core'
-  import type { PageMount, ViewerEngine, ZoomValue } from '@inkbar/core/dom'
+  import type { PageMount, ToolId, ViewerEngine, ZoomValue } from '@inkbar/core/dom'
 
   let {
     mode = 'continuous',
@@ -126,6 +126,11 @@
       buffer,
       tool: ctx.tool,
       ...(ctx.hostTools ? { tools: ctx.hostTools } : {}),
+      // The engine adds the plugins' tools and layers, and decorates through the host, which
+      // reads `decorateAnnotation` first.
+      ...(ctx.pluginHost ? { plugins: ctx.pluginHost } : {}),
+      // Read through, so the effect below can re-apply a new function without a rebuild.
+      decorateAnnotation: (a) => ctx.decorateAnnotation?.(a),
       ...(ctx.toolStyle ? { toolStyle: ctx.toolStyle } : {}),
       toolHistory: { batch: (fn) => ctx.history.batch(fn) },
       toolOptions: ctx.toolOptions,
@@ -155,7 +160,15 @@
           lastReportedPage = p
           ctx.reportPage(p)
         }
-        stops = [vp.zoom.subscribe(reportZoom), vp.currentPage.subscribe(reportPage)]
+        // A tool that switches itself (a one-shot tool once used) is reported as a pick.
+        const followTool = (id: ToolId): void => {
+          if (id !== ctx.tool) ctx.setTool(id)
+        }
+        stops = [
+          vp.zoom.subscribe(reportZoom),
+          vp.currentPage.subscribe(reportPage),
+          tc.active.subscribe(followTool),
+        ]
         // Whatever the build restored is reported once; nothing is when it matched.
         reportZoom(vp.zoom.get())
         reportPage(vp.currentPage.get())
@@ -181,6 +194,16 @@
     })
   }
 
+  // The plugins' `root`. Before the build below, so it is set when the engine mounts.
+  $effect(() => {
+    const el = scroll
+    const { viewportEl } = ctx
+    viewportEl.set(el)
+    return () => {
+      if (viewportEl.get() === el) viewportEl.set(null)
+    }
+  })
+
   // Build for a new document or status; tear down on the next change and on unmount. Only the
   // values read before `untrack` are dependencies, each through a derived, which notifies only
   // when the value changes: the status is a new object on every engine report.
@@ -229,6 +252,13 @@
     })
   })
 
+  // A new decorateAnnotation re-applies to the mounted annotation elements at once.
+  const decorate = $derived(ctx.decorateAnnotation)
+  $effect(() => {
+    void decorate
+    untrack(() => engine?.redecorate())
+  })
+
   // The setters below run untracked: core relays out inside them and the engine's page
   // callbacks read and write `pages`. Tracked, each effect would depend on the list it changes
   // and run again, without end when the host holds a zoom the viewport clamps.

package/dist/components/InkViewport.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InkViewport.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/components/InkViewport.svelte.ts"],"names":[],"mappings":"AAGE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AACrF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAA;AACrC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAErD,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAC5C,cAAc,CAAC,cAAc,CAAC,EAC9B,UAAU,CACX;IACC,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB,QAAQ,CAAC,EAAE,YAAY,CAAA;IACvB,iCAAiC;IACjC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC7B,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC;QAAE,KAAK,EAAE,QAAQ,CAAA;KAAE,CAAC,CAAC,GAAG,SAAS,CAAA;IAClD,UAAU,CAAC,EAAE,OAAO,CAAC,CAAC,mBAAmB,CAAC,CAAC,GAAG,SAAS,CAAA;IACvD,wFAAwF;IACxF,SAAS,CAAC,EAAE,OAAO,CAAC,CAAC;QAAE,KAAK,EAAE,QAAQ,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,GAAG,SAAS,CAAA;CACrE;AA8RH,QAAA,MAAM,WAAW,sDAAwC,CAAC;AAC1D,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;AAClD,eAAe,WAAW,CAAC"}
+{"version":3,"file":"InkViewport.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/components/InkViewport.svelte.ts"],"names":[],"mappings":"AAGE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AACrF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAA;AACrC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAErD,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAC5C,cAAc,CAAC,cAAc,CAAC,EAC9B,UAAU,CACX;IACC,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB,QAAQ,CAAC,EAAE,YAAY,CAAA;IACvB,iCAAiC;IACjC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC7B,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC;QAAE,KAAK,EAAE,QAAQ,CAAA;KAAE,CAAC,CAAC,GAAG,SAAS,CAAA;IAClD,UAAU,CAAC,EAAE,OAAO,CAAC,CAAC,mBAAmB,CAAC,CAAC,GAAG,SAAS,CAAA;IACvD,wFAAwF;IACxF,SAAS,CAAC,EAAE,OAAO,CAAC,CAAC;QAAE,KAAK,EAAE,QAAQ,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,GAAG,SAAS,CAAA;CACrE;AA4TH,QAAA,MAAM,WAAW,sDAAwC,CAAC;AAC1D,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;AAClD,eAAe,WAAW,CAAC"}

package/dist/components/menu-open-focus.d.ts

@@ -0,0 +1,12 @@
+export interface MenuOpenFocus {
+    /** Makes the next open start on the first item (ArrowDown on the trigger). */
+    first: () => void;
+    /** For the content's `onOpenAutoFocus`. */
+    onOpenAutoFocus: (e: Event, menu: HTMLElement | null) => void;
+    /** For the content's `onfocusin`: remembers where the user is. */
+    onfocusin: (e: FocusEvent) => void;
+    /** Call when the menu closes. */
+    reset: () => void;
+}
+export declare function createMenuOpenFocus(): MenuOpenFocus;
+//# sourceMappingURL=menu-open-focus.d.ts.map

package/dist/components/menu-open-focus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu-open-focus.d.ts","sourceRoot":"","sources":["../../src/lib/components/menu-open-focus.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,aAAa;IAC5B,8EAA8E;IAC9E,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,2CAA2C;IAC3C,eAAe,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAA;IAC7D,kEAAkE;IAClE,SAAS,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,IAAI,CAAA;IAClC,iCAAiC;IACjC,KAAK,EAAE,MAAM,IAAI,CAAA;CAClB;AAED,wBAAgB,mBAAmB,IAAI,aAAa,CAsBnD"}

package/dist/components/menu-open-focus.js

@@ -0,0 +1,35 @@
+/*
+ * Where a toolbar menu puts focus as it opens: the first item when ArrowDown opened it, else the
+ * checked one. Bits can remount a popover's focus scope just after it opens, which sends focus
+ * to the trigger and runs the open-focus callback again; by then the user may have moved on, so
+ * a repeat run goes back to the item they last focused.
+ */
+import { focusInitialMenuItem, menuItems } from '@inkbar/core/dom';
+export function createMenuOpenFocus() {
+    let first = false;
+    let last = null;
+    return {
+        first: () => {
+            first = true;
+        },
+        onOpenAutoFocus: (e, menu) => {
+            e.preventDefault();
+            if (!menu)
+                return;
+            if (last && menu.contains(last))
+                last.focus({ preventScroll: true });
+            else if (first)
+                menuItems(menu)[0]?.focus({ preventScroll: true });
+            else
+                focusInitialMenuItem(menu);
+        },
+        onfocusin: (e) => {
+            if (e.target instanceof HTMLElement)
+                last = e.target;
+        },
+        reset: () => {
+            first = false;
+            last = null;
+        },
+    };
+}

package/dist/components/popover-focus.d.ts

@@ -5,6 +5,18 @@ export interface PopoverFocusReturn {
     beforeRemove: FocusReturn['beforeRemove'];
     /** Bits UI's `onOpenAutoFocus` handler. Leaves the default alone: focus moves into the popover. */
     onOpenAutoFocus: (event: Event) => void;
+    /**
+     * A document-level pointer press, captured. `inside` selects the popover's content. A press on
+     * the viewer's own scroll element, outside the popover, that will not activate an annotation
+     * closes it now, through `close`, before the press moves focus. Bits UI closes it a beat
+     * later, and its focus trap pulls focus back into the popover in between, which ends a text
+     * selection the press has just begun. Nothing is focused when it closes this way: the press
+     * places focus. Every other press (a toolbar, a host's menu portaled out of the popover) is
+     * left to Bits UI, whose layer stack knows what belongs to the popover.
+     */
+    onPressOutside: (event: PointerEvent, inside: string, close: () => void) => void;
+    /** A pointer release or cancel, captured. */
+    onPressEnd: () => void;
     /** Bits UI's `onCloseAutoFocus` handler. Prevents the default; the planner places focus. */
     onCloseAutoFocus: (event: Event, anchor: HTMLElement | null) => void;
 }
@@ -21,8 +33,10 @@ export declare function keepOpenOnAnnotation(event: PointerEvent): void;
  * close reaches the planner one microtask late, and only when no open was reported after it.
  *
  * This relies on Bits UI reporting a remount as a close and then an open within one synchronous
- * call (observed in bits-ui 2.19.5, `FocusScope.mount`). If that changes, the browser case 'a
- * card opened by selection alone takes focus without passing it through the annotation' fails.
+ * call (observed in bits-ui 2.19.5, `FocusScope.mount`). The unit case 'a close followed by an
+ * open in the same tick moves no focus and uses up the removal plan' pins the planner's side, and
+ * the browser case 'a popover opened without passing focus through the annotation takes focus'
+ * checks that an open moves focus straight into the popover.
  *
  * A close that is superseded this way moves no focus, but it still uses up whatever
  * `beforeRemove` planned for it, so the plan cannot leak into a later close. A close that is

package/dist/components/popover-focus.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"popover-focus.d.ts","sourceRoot":"","sources":["../../src/lib/components/popover-focus.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,WAAW,EACjB,MAAM,kBAAkB,CAAA;AAIzB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAE/C,iFAAiF;AACjF,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,WAAW,CAAC,cAAc,CAAC,CAAA;IACzC,mGAAmG;IACnG,eAAe,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;IACvC,4FAA4F;IAC5F,gBAAgB,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAA;CACrE;AAED,8GAA8G;AAC9G,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAE9D;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,UAAU,GAAG,kBAAkB,CAkClE"}
+{"version":3,"file":"popover-focus.d.ts","sourceRoot":"","sources":["../../src/lib/components/popover-focus.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,WAAW,EACjB,MAAM,kBAAkB,CAAA;AAKzB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAE/C,iFAAiF;AACjF,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,WAAW,CAAC,cAAc,CAAC,CAAA;IACzC,mGAAmG;IACnG,eAAe,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;IACvC;;;;;;;;OAQG;IACH,cAAc,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,IAAI,KAAK,IAAI,CAAA;IAChF,6CAA6C;IAC7C,UAAU,EAAE,MAAM,IAAI,CAAA;IACtB,4FAA4F;IAC5F,gBAAgB,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAA;CACrE;AAED,8GAA8G;AAC9G,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAE9D;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,UAAU,GAAG,kBAAkB,CAiDlE"}