@inkbar/vue 0.8.0 → 0.9.0

package/README.md

@@ -52,6 +52,7 @@ import {
   InkZoomSelect,
   InkThreadPopover,
 } from '@inkbar/vue'
+import { highlightTool, noteTool, redactAreaTool } from '@inkbar/core/dom'
 import type { Annotation } from '@inkbar/core'
 import { assets } from 'virtual:inkbar-assets'
 import '@inkbar/theme/theme.css'
@@ -59,12 +60,14 @@ import '@inkbar/theme/theme.css'
 defineProps<{ signedUrl: string; documentId: string }>()
 
 const annotations = ref<Annotation[]>([])
+const tools = [highlightTool(), redactAreaTool(), noteTool()]
 </script>
 
 <template>
   <InkRoot
     :src="{ url: signedUrl, key: documentId }"
     :assets="assets"
+    :tools="tools"
     v-model:annotations="annotations"
   >
     <InkToolbar>
@@ -90,7 +93,9 @@ const annotations = ref<Annotation[]>([])
 </template>
 ```
 
-Each control is a separate component, so put them in any order or leave some out. Buttons show icons from `@inkbar/icons`. Put your own in a button's default slot to replace one, and use `InkIcon` to put the same icons on your own buttons.
+`select-text` and `select` are always there. Every other tool is opt-in: pass the ones you offer through `tools`, from the tool factories in `@inkbar/core/dom`, or `allTools()` for all of them. A button for a tool you did not pass renders disabled and hidden, a tool menu renders nothing, and each logs an `InkError('UnknownTool')` to the console once. If the active tool leaves `tools`, the viewer switches to `select-text` and reports it through `update:tool`.
+
+Each control is a separate component, so put them in any order or leave some out. Buttons show icons from `@inkbar/icons`. Put your own in a button's default slot to replace one, and use `InkIcon` to put the same icons on your own buttons. For a button of your own, such as `<InkToolbarButton @click="download">Download</InkToolbarButton>`, use `InkToolbarButton`: it joins the toolbar's arrow-key focus and looks like the other buttons.
 
 `v-model:annotations` makes your list the source of truth. Leave it off and Inkbar keeps the state itself, with undo and redo.
 
@@ -130,7 +135,7 @@ The highlight tool leaves `contents` free for the comment. `doc.text(page)` retu
 
 ## Signatures
 
-`InkSignatureMenu` lists saved signatures, picks one for the `signature` tool, removes them, and opens `InkSignatureDialog` to draw, type or upload a new one. These are marks on the page, not cryptographic signatures. Pass `signatures` to `InkRoot` to keep them somewhere: `createLocalSignatureStore(key)` from `@inkbar/core` uses `localStorage`, and without it they last until reload. `signatureFonts` lists the handwriting fonts the Type tab offers; load them with `@font-face`. A placed signature keeps its aspect ratio when resized.
+`InkSignatureMenu` lists saved signatures, picks one for the `signature` tool, removes them, and opens `InkSignatureDialog` to draw, type or upload a new one. The menu needs `signatureTool()` in `tools`. The dialog and signature form fields work without it; the dialog then only saves the signature. These are marks on the page, not cryptographic signatures. Pass `signatures` to `InkRoot` to keep them somewhere: `createLocalSignatureStore(key)` from `@inkbar/core` uses `localStorage`, and without it they last until reload. `signatureFonts` lists the handwriting fonts the Type tab offers; load them with `@font-face`. A placed signature keeps its aspect ratio when resized.
 
 ## Plugins
 

package/dist/components/InkHighlightMenu.js.map

@@ -1 +1 @@
-{"version":3,"file":"InkHighlightMenu.js","names":["_sfc_main","InkHighlightMenu_vue_vue_type_script_setup_true_lang_default","InkHighlightMenu_default"],"sources":["../../src/components/InkHighlightMenu.vue"],"sourcesContent":["<script setup lang=\"ts\">\n/*\n * A split button for the highlight tool. The main part activates the tool with the current\n * markup kind and draws that kind's icon; the chevron opens a menu of the four kinds plus\n * the markup colour. Choosing a kind switches to the tool with it. The colour is a nested\n * `InkColorMenu` scoped to the `markup` style group, so it works whatever tool is active.\n */\nimport {\n  focusInitialMenuItem,\n  handleMenuKeys,\n  highlightMenuModel,\n  MARKUP_ICONS,\n  MARKUP_KINDS,\n  menuItems,\n  type HighlightOptions,\n  type MarkupKind,\n} from '@inkbar/core/dom'\nimport { ChevronDown } from '@inkbar/icons'\nimport {\n  PopoverAnchor,\n  PopoverContent,\n  PopoverPortal,\n  PopoverRoot,\n  PopoverTrigger,\n  ToolbarButton,\n} from 'reka-ui'\nimport { computed, ref } from 'vue'\n\nimport { useDocument } from '../composables/useDocument'\nimport { useTool } from '../composables/useTool'\nimport { useToolOptions } from '../composables/useToolOptions'\n\nimport InkColorMenu from './InkColorMenu.vue'\nimport InkIcon from './InkIcon.vue'\n\ndefineOptions({ inheritAttrs: false })\nconst { tool, setTool } = useTool()\nconst { options, setOptions } = useToolOptions<HighlightOptions>('highlight')\nconst { document: doc } = useDocument()\nconst open = ref(false)\n\nconst model = computed(() => highlightMenuModel(options.value, MARKUP_KINDS))\nconst active = computed(() => tool.value === 'highlight')\n/** The colour the chosen kind gets while the markup style leaves it unset. */\nconst fallback = computed(() => doc.value?.annotations.defaults.color(model.value.kind))\nconst icon = computed(() => MARKUP_ICONS[model.value.kind])\n\n/** ArrowDown opens on the first item; a click opens on the checked one. */\nlet focusFirst = false\nfunction onTriggerKeydown(e: KeyboardEvent): void {\n  if (e.key !== 'ArrowDown' || e.defaultPrevented || open.value) return\n  e.preventDefault()\n  focusFirst = true\n  open.value = true\n}\n\nfunction onOpenAutoFocus(e: Event): void {\n  e.preventDefault()\n  // One highlight menu is open at a time.\n  const menu = document.querySelector('[data-ink-menu=\"highlight\"] [role=\"menu\"]')\n  if (menu) {\n    if (focusFirst) menuItems(menu)[0]?.focus({ preventScroll: true })\n    else focusInitialMenuItem(menu)\n  }\n  focusFirst = false\n}\n\nfunction choose(kind: MarkupKind): void {\n  setOptions({ kind })\n  setTool('highlight')\n  open.value = false\n}\n\n// Reka's typed props stop at its own; ARIA and listeners go through bound objects.\nconst mainAttrs = computed(() => ({\n  'aria-pressed': String(active.value),\n  'aria-label': model.value.label,\n  title: model.value.label,\n  onClick: () => setTool('highlight'),\n}))\nconst triggerAttrs = {\n  'aria-label': 'Choose highlight',\n  title: 'Choose highlight',\n  'aria-haspopup': 'menu' as const,\n  onKeydown: onTriggerKeydown,\n}\nconst menuAttrs = { 'aria-label': 'Highlights' }\n/** The colour trigger is an item of this menu, reached with the arrow keys. */\nconst colourAttrs = { role: 'menuitem', tabindex: -1 }\nconst innerAttrs = {\n  role: 'menu',\n  'aria-label': 'Highlights',\n  // Capture, so the arrow keys move on from the colour item before its own ArrowDown\n  // opens the nested menu.\n  onKeydownCapture: (e: KeyboardEvent) =>\n    handleMenuKeys(e, e.currentTarget as HTMLElement),\n}\n</script>\n\n<template>\n  <PopoverRoot v-model:open=\"open\">\n    <PopoverAnchor as-child>\n      <div\n        role=\"group\"\n        aria-label=\"Highlight\"\n        class=\"ink-split-button ink-highlight-menu\"\n        data-ink-highlight-menu\n        v-bind=\"$attrs\"\n      >\n        <ToolbarButton\n          class=\"ink-tool-button ink-highlight-button\"\n          data-ink-tool-button\n          data-ink-highlight-button\n          data-tool=\"highlight\"\n          :data-kind=\"model.kind\"\n          :data-state=\"active ? 'on' : 'off'\"\n          v-bind=\"mainAttrs\"\n        >\n          <slot :active=\"active\" :kind=\"model.kind\"><InkIcon :icon=\"icon\" /></slot>\n        </ToolbarButton>\n        <ToolbarButton as-child>\n          <PopoverTrigger as-child>\n            <button\n              type=\"button\"\n              class=\"ink-menu-trigger ink-highlight-menu-trigger\"\n              data-ink-highlight-menu-trigger\n              :data-state=\"open ? 'open' : 'closed'\"\n              v-bind=\"triggerAttrs\"\n            >\n              <InkIcon :icon=\"ChevronDown\" />\n            </button>\n          </PopoverTrigger>\n        </ToolbarButton>\n        <PopoverPortal>\n          <PopoverContent\n            class=\"ink-select-content ink-menu-content\"\n            data-ink-select-content\n            data-ink-menu=\"highlight\"\n            side=\"bottom\"\n            align=\"start\"\n            :side-offset=\"4\"\n            :collision-padding=\"8\"\n            v-bind=\"menuAttrs\"\n            @open-auto-focus=\"onOpenAutoFocus\"\n          >\n            <div v-bind=\"innerAttrs\">\n              <div role=\"group\" aria-label=\"Kinds\" class=\"ink-highlight-kinds\">\n                <button\n                  v-for=\"item in model.items\"\n                  :key=\"item.kind\"\n                  type=\"button\"\n                  role=\"menuitemradio\"\n                  class=\"ink-select-item ink-menu-item ink-highlight-item\"\n                  data-ink-select-item\n                  tabindex=\"-1\"\n                  :data-key=\"item.kind\"\n                  :aria-checked=\"item.checked\"\n                  :data-state=\"item.checked ? 'checked' : 'unchecked'\"\n                  @click=\"choose(item.kind)\"\n                >\n                  <InkIcon :icon=\"MARKUP_ICONS[item.kind]\" :size=\"16\" />\n                  {{ item.label }}\n                </button>\n              </div>\n              <div role=\"separator\" class=\"ink-select-separator\" />\n              <div role=\"group\" aria-label=\"Colour\" class=\"ink-highlight-colour\">\n                <span class=\"ink-highlight-colour-label\" aria-hidden=\"true\">Colour</span>\n                <InkColorMenu\n                  property=\"border\"\n                  group=\"markup\"\n                  label=\"Highlight colour\"\n                  standalone\n                  :fallback=\"fallback\"\n                  v-bind=\"colourAttrs\"\n                />\n              </div>\n            </div>\n          </PopoverContent>\n        </PopoverPortal>\n      </div>\n    </PopoverAnchor>\n  </PopoverRoot>\n</template>\n"],"mappings":""}
+{"version":3,"file":"InkHighlightMenu.js","names":["_sfc_main","InkHighlightMenu_vue_vue_type_script_setup_true_lang_default","InkHighlightMenu_default"],"sources":["../../src/components/InkHighlightMenu.vue"],"sourcesContent":["<script setup lang=\"ts\">\n/*\n * A split button for the highlight tool. The main part activates the tool with the current\n * markup kind and draws that kind's icon; the chevron opens a menu of the four kinds plus\n * the markup colour. Choosing a kind switches to the tool with it. The colour is a nested\n * `InkColorMenu` scoped to the `markup` style group, so it works whatever tool is active.\n */\nimport {\n  focusInitialMenuItem,\n  handleMenuKeys,\n  highlightMenuModel,\n  MARKUP_ICONS,\n  MARKUP_KINDS,\n  menuItems,\n  type HighlightOptions,\n  type MarkupKind,\n} from '@inkbar/core/dom'\nimport { ChevronDown } from '@inkbar/icons'\nimport {\n  PopoverAnchor,\n  PopoverContent,\n  PopoverPortal,\n  PopoverRoot,\n  PopoverTrigger,\n  ToolbarButton,\n} from 'reka-ui'\nimport { computed, ref } from 'vue'\n\nimport { useDocument } from '../composables/useDocument'\nimport { useRegisteredTool } from '../composables/useRegisteredTool'\nimport { useTool } from '../composables/useTool'\nimport { useToolOptionsWhile } from '../composables/useToolOptions'\n\nimport InkColorMenu from './InkColorMenu.vue'\nimport InkIcon from './InkIcon.vue'\n\ndefineOptions({ inheritAttrs: false })\nconst { tool, setTool } = useTool()\n// Nothing renders while no `highlight` tool is registered.\nconst registered = useRegisteredTool('highlight')\nconst { options, setOptions } = useToolOptionsWhile<HighlightOptions>(\n  'highlight',\n  registered\n)\nconst { document: doc } = useDocument()\nconst open = ref(false)\n\nconst model = computed(() => highlightMenuModel(options.value, MARKUP_KINDS))\nconst active = computed(() => tool.value === 'highlight')\n/** The colour the chosen kind gets while the markup style leaves it unset. */\nconst fallback = computed(() => doc.value?.annotations.defaults.color(model.value.kind))\nconst icon = computed(() => MARKUP_ICONS[model.value.kind])\n\n/** ArrowDown opens on the first item; a click opens on the checked one. */\nlet focusFirst = false\nfunction onTriggerKeydown(e: KeyboardEvent): void {\n  if (e.key !== 'ArrowDown' || e.defaultPrevented || open.value) return\n  e.preventDefault()\n  focusFirst = true\n  open.value = true\n}\n\nfunction onOpenAutoFocus(e: Event): void {\n  e.preventDefault()\n  // One highlight menu is open at a time.\n  const menu = document.querySelector('[data-ink-menu=\"highlight\"] [role=\"menu\"]')\n  if (menu) {\n    if (focusFirst) menuItems(menu)[0]?.focus({ preventScroll: true })\n    else focusInitialMenuItem(menu)\n  }\n  focusFirst = false\n}\n\nfunction choose(kind: MarkupKind): void {\n  setOptions({ kind })\n  setTool('highlight')\n  open.value = false\n}\n\n// Reka's typed props stop at its own; ARIA and listeners go through bound objects.\nconst mainAttrs = computed(() => ({\n  'aria-pressed': String(active.value),\n  'aria-label': model.value.label,\n  title: model.value.label,\n  onClick: () => setTool('highlight'),\n}))\nconst triggerAttrs = {\n  'aria-label': 'Choose highlight',\n  title: 'Choose highlight',\n  'aria-haspopup': 'menu' as const,\n  onKeydown: onTriggerKeydown,\n}\nconst menuAttrs = { 'aria-label': 'Highlights' }\n/** The colour trigger is an item of this menu, reached with the arrow keys. */\nconst colourAttrs = { role: 'menuitem', tabindex: -1 }\nconst innerAttrs = {\n  role: 'menu',\n  'aria-label': 'Highlights',\n  // Capture, so the arrow keys move on from the colour item before its own ArrowDown\n  // opens the nested menu.\n  onKeydownCapture: (e: KeyboardEvent) =>\n    handleMenuKeys(e, e.currentTarget as HTMLElement),\n}\n</script>\n\n<template>\n  <PopoverRoot v-if=\"registered\" v-model:open=\"open\">\n    <PopoverAnchor as-child>\n      <div\n        role=\"group\"\n        aria-label=\"Highlight\"\n        class=\"ink-split-button ink-highlight-menu\"\n        data-ink-highlight-menu\n        v-bind=\"$attrs\"\n      >\n        <ToolbarButton\n          class=\"ink-tool-button ink-highlight-button\"\n          data-ink-tool-button\n          data-ink-highlight-button\n          data-tool=\"highlight\"\n          :data-kind=\"model.kind\"\n          :data-state=\"active ? 'on' : 'off'\"\n          v-bind=\"mainAttrs\"\n        >\n          <slot :active=\"active\" :kind=\"model.kind\"><InkIcon :icon=\"icon\" /></slot>\n        </ToolbarButton>\n        <ToolbarButton as-child>\n          <PopoverTrigger as-child>\n            <button\n              type=\"button\"\n              class=\"ink-menu-trigger ink-highlight-menu-trigger\"\n              data-ink-highlight-menu-trigger\n              :data-state=\"open ? 'open' : 'closed'\"\n              v-bind=\"triggerAttrs\"\n            >\n              <InkIcon :icon=\"ChevronDown\" />\n            </button>\n          </PopoverTrigger>\n        </ToolbarButton>\n        <PopoverPortal>\n          <PopoverContent\n            class=\"ink-select-content ink-menu-content\"\n            data-ink-select-content\n            data-ink-menu=\"highlight\"\n            side=\"bottom\"\n            align=\"start\"\n            :side-offset=\"4\"\n            :collision-padding=\"8\"\n            v-bind=\"menuAttrs\"\n            @open-auto-focus=\"onOpenAutoFocus\"\n          >\n            <div v-bind=\"innerAttrs\">\n              <div role=\"group\" aria-label=\"Kinds\" class=\"ink-highlight-kinds\">\n                <button\n                  v-for=\"item in model.items\"\n                  :key=\"item.kind\"\n                  type=\"button\"\n                  role=\"menuitemradio\"\n                  class=\"ink-select-item ink-menu-item ink-highlight-item\"\n                  data-ink-select-item\n                  tabindex=\"-1\"\n                  :data-key=\"item.kind\"\n                  :aria-checked=\"item.checked\"\n                  :data-state=\"item.checked ? 'checked' : 'unchecked'\"\n                  @click=\"choose(item.kind)\"\n                >\n                  <InkIcon :icon=\"MARKUP_ICONS[item.kind]\" :size=\"16\" />\n                  {{ item.label }}\n                </button>\n              </div>\n              <div role=\"separator\" class=\"ink-select-separator\" />\n              <div role=\"group\" aria-label=\"Colour\" class=\"ink-highlight-colour\">\n                <span class=\"ink-highlight-colour-label\" aria-hidden=\"true\">Colour</span>\n                <InkColorMenu\n                  property=\"border\"\n                  group=\"markup\"\n                  label=\"Highlight colour\"\n                  standalone\n                  :fallback=\"fallback\"\n                  v-bind=\"colourAttrs\"\n                />\n              </div>\n            </div>\n          </PopoverContent>\n        </PopoverPortal>\n      </div>\n    </PopoverAnchor>\n  </PopoverRoot>\n</template>\n"],"mappings":""}

package/dist/components/InkHighlightMenu.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InkHighlightMenu.vue.d.ts","sourceRoot":"","sources":["../../src/components/InkHighlightMenu.vue"],"names":[],"mappings":"AA8hBA,QAAA,IAAI,QAAQ;;;CAAY,CAAC;AACzB,KAAK,WAAW,GAAG,EAAE,GACnB;IAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,QAAQ,KAAK,GAAG,CAAA;CAAE,CAAC;AAGhD,QAAA,MAAM,UAAU,+QACd,CAAC;AACH,QAAA,MAAM,YAAY,EAAS,eAAe,CAAC,OAAO,UAAU,EAAE,WAAW,CAAC,CAAC;wBACtD,OAAO,YAAY;AAAxC,wBAAyC;AACzC,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAChC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KACV,CAAA;CACD,CAAC"}
+{"version":3,"file":"InkHighlightMenu.vue.d.ts","sourceRoot":"","sources":["../../src/components/InkHighlightMenu.vue"],"names":[],"mappings":"AAgjBA,QAAA,IAAI,QAAQ;;;CAAY,CAAC;AACzB,KAAK,WAAW,GAAG,EAAE,GACnB;IAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,QAAQ,KAAK,GAAG,CAAA;CAAE,CAAC;AAGhD,QAAA,MAAM,UAAU,+QACd,CAAC;AACH,QAAA,MAAM,YAAY,EAAS,eAAe,CAAC,OAAO,UAAU,EAAE,WAAW,CAAC,CAAC;wBACtD,OAAO,YAAY;AAAxC,wBAAyC;AACzC,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IAChC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KACV,CAAA;CACD,CAAC"}

package/dist/components/InkHighlightMenu.vue_vue_type_script_setup_true_lang.js

@@ -1,99 +1,101 @@
-import { useDocument as e } from "../composables/useDocument.js";
-import { useTool as t } from "../composables/useTool.js";
-import { useToolOptions as n } from "../composables/useToolOptions.js";
-import r from "./InkIcon.js";
-import i from "./InkColorMenu.js";
-import { Fragment as a, computed as o, createBlock as s, createElementBlock as c, createElementVNode as l, createTextVNode as u, createVNode as d, defineComponent as f, guardReactiveProps as p, mergeProps as m, normalizeProps as h, openBlock as g, ref as _, renderList as v, renderSlot as y, toDisplayString as b, unref as x, withCtx as S } from "vue";
-import { MARKUP_ICONS as C, MARKUP_KINDS as w, focusInitialMenuItem as T, handleMenuKeys as E, highlightMenuModel as D, menuItems as O } from "@inkbar/core/dom";
-import { PopoverAnchor as k, PopoverContent as A, PopoverPortal as j, PopoverRoot as M, PopoverTrigger as N, ToolbarButton as P } from "reka-ui";
-import { ChevronDown as F } from "@inkbar/icons";
+import { useRegisteredTool as e } from "../composables/useRegisteredTool.js";
+import { useDocument as t } from "../composables/useDocument.js";
+import { useTool as n } from "../composables/useTool.js";
+import { useToolOptionsWhile as r } from "../composables/useToolOptions.js";
+import i from "./InkIcon.js";
+import a from "./InkColorMenu.js";
+import { Fragment as o, computed as s, createBlock as c, createCommentVNode as l, createElementBlock as u, createElementVNode as d, createTextVNode as f, createVNode as p, defineComponent as m, guardReactiveProps as h, mergeProps as g, normalizeProps as _, openBlock as v, ref as y, renderList as b, renderSlot as x, toDisplayString as S, unref as C, withCtx as w } from "vue";
+import { MARKUP_ICONS as T, MARKUP_KINDS as E, focusInitialMenuItem as D, handleMenuKeys as O, highlightMenuModel as k, menuItems as A } from "@inkbar/core/dom";
+import { PopoverAnchor as j, PopoverContent as M, PopoverPortal as N, PopoverRoot as P, PopoverTrigger as F, ToolbarButton as I } from "reka-ui";
+import { ChevronDown as L } from "@inkbar/icons";
 //#region src/components/InkHighlightMenu.vue?vue&type=script&setup=true&lang.ts
-var ee = ["data-state"], I = {
+var R = ["data-state"], z = {
 	role: "group",
 	"aria-label": "Kinds",
 	class: "ink-highlight-kinds"
-}, L = [
+}, B = [
 	"data-key",
 	"aria-checked",
 	"data-state",
 	"onClick"
-], R = {
+], ee = {
 	role: "group",
 	"aria-label": "Colour",
 	class: "ink-highlight-colour"
-}, z = /*@__PURE__*/ f({
+}, V = /*@__PURE__*/ m({
 	inheritAttrs: !1,
 	__name: "InkHighlightMenu",
-	setup(f) {
-		let { tool: z, setTool: B } = t(), { options: V, setOptions: H } = n("highlight"), { document: U } = e(), W = _(!1), G = o(() => D(V.value, w)), K = o(() => z.value === "highlight"), q = o(() => U.value?.annotations.defaults.color(G.value.kind)), J = o(() => C[G.value.kind]), Y = !1;
-		function X(e) {
-			e.key !== "ArrowDown" || e.defaultPrevented || W.value || (e.preventDefault(), Y = !0, W.value = !0);
+	setup(m) {
+		let { tool: V, setTool: H } = n(), U = e("highlight"), { options: W, setOptions: G } = r("highlight", U), { document: K } = t(), q = y(!1), J = s(() => k(W.value, E)), Y = s(() => V.value === "highlight"), X = s(() => K.value?.annotations.defaults.color(J.value.kind)), Z = s(() => T[J.value.kind]), Q = !1;
+		function $(e) {
+			e.key !== "ArrowDown" || e.defaultPrevented || q.value || (e.preventDefault(), Q = !0, q.value = !0);
 		}
-		function Z(e) {
+		function te(e) {
 			e.preventDefault();
 			let t = document.querySelector("[data-ink-menu=\"highlight\"] [role=\"menu\"]");
-			t && (Y ? O(t)[0]?.focus({ preventScroll: !0 }) : T(t)), Y = !1;
+			t && (Q ? A(t)[0]?.focus({ preventScroll: !0 }) : D(t)), Q = !1;
 		}
-		function Q(e) {
-			H({ kind: e }), B("highlight"), W.value = !1;
+		function ne(e) {
+			G({ kind: e }), H("highlight"), q.value = !1;
 		}
-		let $ = o(() => ({
-			"aria-pressed": String(K.value),
-			"aria-label": G.value.label,
-			title: G.value.label,
-			onClick: () => B("highlight")
-		})), te = {
+		let re = s(() => ({
+			"aria-pressed": String(Y.value),
+			"aria-label": J.value.label,
+			title: J.value.label,
+			onClick: () => H("highlight")
+		})), ie = {
 			"aria-label": "Choose highlight",
 			title: "Choose highlight",
 			"aria-haspopup": "menu",
-			onKeydown: X
-		}, ne = { "aria-label": "Highlights" }, re = {
+			onKeydown: $
+		}, ae = { "aria-label": "Highlights" }, oe = {
 			role: "menuitem",
 			tabindex: -1
-		}, ie = {
+		}, se = {
 			role: "menu",
 			"aria-label": "Highlights",
-			onKeydownCapture: (e) => E(e, e.currentTarget)
+			onKeydownCapture: (e) => O(e, e.currentTarget)
 		};
-		return (e, t) => (g(), s(x(M), {
-			open: W.value,
-			"onUpdate:open": t[0] ||= (e) => W.value = e
+		return (e, t) => C(U) ? (v(), c(C(P), {
+			key: 0,
+			open: q.value,
+			"onUpdate:open": t[0] ||= (e) => q.value = e
 		}, {
-			default: S(() => [d(x(k), { "as-child": "" }, {
-				default: S(() => [l("div", m({
+			default: w(() => [p(C(j), { "as-child": "" }, {
+				default: w(() => [d("div", g({
 					role: "group",
 					"aria-label": "Highlight",
 					class: "ink-split-button ink-highlight-menu",
 					"data-ink-highlight-menu": ""
 				}, e.$attrs), [
-					d(x(P), m({
+					p(C(I), g({
 						class: "ink-tool-button ink-highlight-button",
 						"data-ink-tool-button": "",
 						"data-ink-highlight-button": "",
 						"data-tool": "highlight",
-						"data-kind": G.value.kind,
-						"data-state": K.value ? "on" : "off"
-					}, $.value), {
-						default: S(() => [y(e.$slots, "default", {
-							active: K.value,
-							kind: G.value.kind
-						}, () => [d(r, { icon: J.value }, null, 8, ["icon"])])]),
+						"data-kind": J.value.kind,
+						"data-state": Y.value ? "on" : "off"
+					}, re.value), {
+						default: w(() => [x(e.$slots, "default", {
+							active: Y.value,
+							kind: J.value.kind
+						}, () => [p(i, { icon: Z.value }, null, 8, ["icon"])])]),
 						_: 3
 					}, 16, ["data-kind", "data-state"]),
-					d(x(P), { "as-child": "" }, {
-						default: S(() => [d(x(N), { "as-child": "" }, {
-							default: S(() => [l("button", m({
+					p(C(I), { "as-child": "" }, {
+						default: w(() => [p(C(F), { "as-child": "" }, {
+							default: w(() => [d("button", g({
 								type: "button",
 								class: "ink-menu-trigger ink-highlight-menu-trigger",
 								"data-ink-highlight-menu-trigger": "",
-								"data-state": W.value ? "open" : "closed"
-							}, te), [d(r, { icon: x(F) }, null, 8, ["icon"])], 16, ee)]),
+								"data-state": q.value ? "open" : "closed"
+							}, ie), [p(i, { icon: C(L) }, null, 8, ["icon"])], 16, R)]),
 							_: 1
 						})]),
 						_: 1
 					}),
-					d(x(j), null, {
-						default: S(() => [d(x(A), m({
+					p(C(N), null, {
+						default: w(() => [p(C(M), g({
 							class: "ink-select-content ink-menu-content",
 							"data-ink-select-content": "",
 							"data-ink-menu": "highlight",
@@ -101,9 +103,9 @@ var ee = ["data-state"], I = {
 							align: "start",
 							"side-offset": 4,
 							"collision-padding": 8
-						}, ne, { onOpenAutoFocus: Z }), {
-							default: S(() => [l("div", h(p(ie)), [
-								l("div", I, [(g(!0), c(a, null, v(G.value.items, (e) => (g(), c("button", {
+						}, ae, { onOpenAutoFocus: te }), {
+							default: w(() => [d("div", _(h(se)), [
+								d("div", z, [(v(!0), u(o, null, b(J.value.items, (e) => (v(), u("button", {
 									key: e.kind,
 									type: "button",
 									role: "menuitemradio",
@@ -113,25 +115,25 @@ var ee = ["data-state"], I = {
 									"data-key": e.kind,
 									"aria-checked": e.checked,
 									"data-state": e.checked ? "checked" : "unchecked",
-									onClick: (t) => Q(e.kind)
-								}, [d(r, {
-									icon: x(C)[e.kind],
+									onClick: (t) => ne(e.kind)
+								}, [p(i, {
+									icon: C(T)[e.kind],
 									size: 16
-								}, null, 8, ["icon"]), u(" " + b(e.label), 1)], 8, L))), 128))]),
-								t[2] ||= l("div", {
+								}, null, 8, ["icon"]), f(" " + S(e.label), 1)], 8, B))), 128))]),
+								t[2] ||= d("div", {
 									role: "separator",
 									class: "ink-select-separator"
 								}, null, -1),
-								l("div", R, [t[1] ||= l("span", {
+								d("div", ee, [t[1] ||= d("span", {
 									class: "ink-highlight-colour-label",
 									"aria-hidden": "true"
-								}, "Colour", -1), d(i, m({
+								}, "Colour", -1), p(a, g({
 									property: "border",
 									group: "markup",
 									label: "Highlight colour",
 									standalone: "",
-									fallback: q.value
-								}, re), null, 16, ["fallback"])])
+									fallback: X.value
+								}, oe), null, 16, ["fallback"])])
 							], 16)]),
 							_: 1
 						}, 16)]),
@@ -141,10 +143,10 @@ var ee = ["data-state"], I = {
 				_: 3
 			})]),
 			_: 3
-		}, 8, ["open"]));
+		}, 8, ["open"])) : l("", !0);
 	}
 });
 //#endregion
-export { z as default };
+export { V as default };
 
 //# sourceMappingURL=InkHighlightMenu.vue_vue_type_script_setup_true_lang.js.map

package/dist/components/InkHighlightMenu.vue_vue_type_script_setup_true_lang.js.map

@@ -1 +1 @@
-{"version":3,"file":"InkHighlightMenu.vue_vue_type_script_setup_true_lang.js","names":["$attrs","_openBlock","_createBlock","_unref","_withCtx","_createVNode","_createElementVNode","_mergeProps","_renderSlot","InkIcon","_normalizeProps","_guardReactiveProps","_createElementBlock","_Fragment","_renderList","_createTextVNode","_toDisplayString","InkColorMenu","InkIcon_default","InkColorMenu_default","_hoisted_1","_hoisted_2","_hoisted_3","_hoisted_4","InkHighlightMenu_vue_vue_type_script_setup_true_lang_default","useTool","useToolOptions","doc","useDocument","open","ref","model","computed","highlightMenuModel","options","MARKUP_KINDS","active","tool","fallback","icon","MARKUP_ICONS","focusFirst","onTriggerKeydown","onOpenAutoFocus","menu","menuItems","focusInitialMenuItem","choose","setOptions","setTool","mainAttrs","triggerAttrs","menuAttrs","colourAttrs","innerAttrs","handleMenuKeys","openBlock","createBlock","unref","PopoverRoot","_cache","$event","withCtx","createVNode","PopoverAnchor","createElementVNode","mergeProps","_ctx","ToolbarButton","renderSlot","PopoverTrigger","ChevronDown","PopoverPortal","PopoverContent","normalizeProps","guardReactiveProps","createElementBlock","Fragment","renderList","item","createTextVNode","toDisplayString"],"sources":["../../src/components/InkHighlightMenu.vue"],"sourcesContent":["<script setup lang=\"ts\">\n/*\n * A split button for the highlight tool. The main part activates the tool with the current\n * markup kind and draws that kind's icon; the chevron opens a menu of the four kinds plus\n * the markup colour. Choosing a kind switches to the tool with it. The colour is a nested\n * `InkColorMenu` scoped to the `markup` style group, so it works whatever tool is active.\n */\nimport {\n  focusInitialMenuItem,\n  handleMenuKeys,\n  highlightMenuModel,\n  MARKUP_ICONS,\n  MARKUP_KINDS,\n  menuItems,\n  type HighlightOptions,\n  type MarkupKind,\n} from '@inkbar/core/dom'\nimport { ChevronDown } from '@inkbar/icons'\nimport {\n  PopoverAnchor,\n  PopoverContent,\n  PopoverPortal,\n  PopoverRoot,\n  PopoverTrigger,\n  ToolbarButton,\n} from 'reka-ui'\nimport { computed, ref } from 'vue'\n\nimport { useDocument } from '../composables/useDocument'\nimport { useTool } from '../composables/useTool'\nimport { useToolOptions } from '../composables/useToolOptions'\n\nimport InkColorMenu from './InkColorMenu.vue'\nimport InkIcon from './InkIcon.vue'\n\ndefineOptions({ inheritAttrs: false })\nconst { tool, setTool } = useTool()\nconst { options, setOptions } = useToolOptions<HighlightOptions>('highlight')\nconst { document: doc } = useDocument()\nconst open = ref(false)\n\nconst model = computed(() => highlightMenuModel(options.value, MARKUP_KINDS))\nconst active = computed(() => tool.value === 'highlight')\n/** The colour the chosen kind gets while the markup style leaves it unset. */\nconst fallback = computed(() => doc.value?.annotations.defaults.color(model.value.kind))\nconst icon = computed(() => MARKUP_ICONS[model.value.kind])\n\n/** ArrowDown opens on the first item; a click opens on the checked one. */\nlet focusFirst = false\nfunction onTriggerKeydown(e: KeyboardEvent): void {\n  if (e.key !== 'ArrowDown' || e.defaultPrevented || open.value) return\n  e.preventDefault()\n  focusFirst = true\n  open.value = true\n}\n\nfunction onOpenAutoFocus(e: Event): void {\n  e.preventDefault()\n  // One highlight menu is open at a time.\n  const menu = document.querySelector('[data-ink-menu=\"highlight\"] [role=\"menu\"]')\n  if (menu) {\n    if (focusFirst) menuItems(menu)[0]?.focus({ preventScroll: true })\n    else focusInitialMenuItem(menu)\n  }\n  focusFirst = false\n}\n\nfunction choose(kind: MarkupKind): void {\n  setOptions({ kind })\n  setTool('highlight')\n  open.value = false\n}\n\n// Reka's typed props stop at its own; ARIA and listeners go through bound objects.\nconst mainAttrs = computed(() => ({\n  'aria-pressed': String(active.value),\n  'aria-label': model.value.label,\n  title: model.value.label,\n  onClick: () => setTool('highlight'),\n}))\nconst triggerAttrs = {\n  'aria-label': 'Choose highlight',\n  title: 'Choose highlight',\n  'aria-haspopup': 'menu' as const,\n  onKeydown: onTriggerKeydown,\n}\nconst menuAttrs = { 'aria-label': 'Highlights' }\n/** The colour trigger is an item of this menu, reached with the arrow keys. */\nconst colourAttrs = { role: 'menuitem', tabindex: -1 }\nconst innerAttrs = {\n  role: 'menu',\n  'aria-label': 'Highlights',\n  // Capture, so the arrow keys move on from the colour item before its own ArrowDown\n  // opens the nested menu.\n  onKeydownCapture: (e: KeyboardEvent) =>\n    handleMenuKeys(e, e.currentTarget as HTMLElement),\n}\n</script>\n\n<template>\n  <PopoverRoot v-model:open=\"open\">\n    <PopoverAnchor as-child>\n      <div\n        role=\"group\"\n        aria-label=\"Highlight\"\n        class=\"ink-split-button ink-highlight-menu\"\n        data-ink-highlight-menu\n        v-bind=\"$attrs\"\n      >\n        <ToolbarButton\n          class=\"ink-tool-button ink-highlight-button\"\n          data-ink-tool-button\n          data-ink-highlight-button\n          data-tool=\"highlight\"\n          :data-kind=\"model.kind\"\n          :data-state=\"active ? 'on' : 'off'\"\n          v-bind=\"mainAttrs\"\n        >\n          <slot :active=\"active\" :kind=\"model.kind\"><InkIcon :icon=\"icon\" /></slot>\n        </ToolbarButton>\n        <ToolbarButton as-child>\n          <PopoverTrigger as-child>\n            <button\n              type=\"button\"\n              class=\"ink-menu-trigger ink-highlight-menu-trigger\"\n              data-ink-highlight-menu-trigger\n              :data-state=\"open ? 'open' : 'closed'\"\n              v-bind=\"triggerAttrs\"\n            >\n              <InkIcon :icon=\"ChevronDown\" />\n            </button>\n          </PopoverTrigger>\n        </ToolbarButton>\n        <PopoverPortal>\n          <PopoverContent\n            class=\"ink-select-content ink-menu-content\"\n            data-ink-select-content\n            data-ink-menu=\"highlight\"\n            side=\"bottom\"\n            align=\"start\"\n            :side-offset=\"4\"\n            :collision-padding=\"8\"\n            v-bind=\"menuAttrs\"\n            @open-auto-focus=\"onOpenAutoFocus\"\n          >\n            <div v-bind=\"innerAttrs\">\n              <div role=\"group\" aria-label=\"Kinds\" class=\"ink-highlight-kinds\">\n                <button\n                  v-for=\"item in model.items\"\n                  :key=\"item.kind\"\n                  type=\"button\"\n                  role=\"menuitemradio\"\n                  class=\"ink-select-item ink-menu-item ink-highlight-item\"\n                  data-ink-select-item\n                  tabindex=\"-1\"\n                  :data-key=\"item.kind\"\n                  :aria-checked=\"item.checked\"\n                  :data-state=\"item.checked ? 'checked' : 'unchecked'\"\n                  @click=\"choose(item.kind)\"\n                >\n                  <InkIcon :icon=\"MARKUP_ICONS[item.kind]\" :size=\"16\" />\n                  {{ item.label }}\n                </button>\n              </div>\n              <div role=\"separator\" class=\"ink-select-separator\" />\n              <div role=\"group\" aria-label=\"Colour\" class=\"ink-highlight-colour\">\n                <span class=\"ink-highlight-colour-label\" aria-hidden=\"true\">Colour</span>\n                <InkColorMenu\n                  property=\"border\"\n                  group=\"markup\"\n                  label=\"Highlight colour\"\n                  standalone\n                  :fallback=\"fallback\"\n                  v-bind=\"colourAttrs\"\n                />\n              </div>\n            </div>\n          </PopoverContent>\n        </PopoverPortal>\n      </div>\n    </PopoverAnchor>\n  </PopoverRoot>\n</template>\n"],"mappings":"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"}
+{"version":3,"file":"InkHighlightMenu.vue_vue_type_script_setup_true_lang.js","names":["$attrs","_unref","_openBlock","_createBlock","_withCtx","_createVNode","_createElementVNode","_mergeProps","_renderSlot","InkIcon","_normalizeProps","_guardReactiveProps","_createElementBlock","_Fragment","_renderList","_createTextVNode","_toDisplayString","InkColorMenu","_createCommentVNode","InkIcon_default","InkColorMenu_default","_hoisted_1","_hoisted_2","_hoisted_3","_hoisted_4","InkHighlightMenu_vue_vue_type_script_setup_true_lang_default","useTool","registered","useRegisteredTool","useToolOptionsWhile","doc","useDocument","open","ref","model","computed","highlightMenuModel","options","MARKUP_KINDS","active","tool","fallback","icon","MARKUP_ICONS","focusFirst","onTriggerKeydown","onOpenAutoFocus","menu","menuItems","focusInitialMenuItem","choose","setOptions","setTool","mainAttrs","triggerAttrs","menuAttrs","colourAttrs","innerAttrs","handleMenuKeys","unref","openBlock","createBlock","PopoverRoot","_cache","$event","withCtx","createVNode","PopoverAnchor","createElementVNode","mergeProps","_ctx","ToolbarButton","renderSlot","PopoverTrigger","ChevronDown","PopoverPortal","PopoverContent","normalizeProps","guardReactiveProps","createElementBlock","Fragment","renderList","item","createTextVNode","toDisplayString","createCommentVNode"],"sources":["../../src/components/InkHighlightMenu.vue"],"sourcesContent":["<script setup lang=\"ts\">\n/*\n * A split button for the highlight tool. The main part activates the tool with the current\n * markup kind and draws that kind's icon; the chevron opens a menu of the four kinds plus\n * the markup colour. Choosing a kind switches to the tool with it. The colour is a nested\n * `InkColorMenu` scoped to the `markup` style group, so it works whatever tool is active.\n */\nimport {\n  focusInitialMenuItem,\n  handleMenuKeys,\n  highlightMenuModel,\n  MARKUP_ICONS,\n  MARKUP_KINDS,\n  menuItems,\n  type HighlightOptions,\n  type MarkupKind,\n} from '@inkbar/core/dom'\nimport { ChevronDown } from '@inkbar/icons'\nimport {\n  PopoverAnchor,\n  PopoverContent,\n  PopoverPortal,\n  PopoverRoot,\n  PopoverTrigger,\n  ToolbarButton,\n} from 'reka-ui'\nimport { computed, ref } from 'vue'\n\nimport { useDocument } from '../composables/useDocument'\nimport { useRegisteredTool } from '../composables/useRegisteredTool'\nimport { useTool } from '../composables/useTool'\nimport { useToolOptionsWhile } from '../composables/useToolOptions'\n\nimport InkColorMenu from './InkColorMenu.vue'\nimport InkIcon from './InkIcon.vue'\n\ndefineOptions({ inheritAttrs: false })\nconst { tool, setTool } = useTool()\n// Nothing renders while no `highlight` tool is registered.\nconst registered = useRegisteredTool('highlight')\nconst { options, setOptions } = useToolOptionsWhile<HighlightOptions>(\n  'highlight',\n  registered\n)\nconst { document: doc } = useDocument()\nconst open = ref(false)\n\nconst model = computed(() => highlightMenuModel(options.value, MARKUP_KINDS))\nconst active = computed(() => tool.value === 'highlight')\n/** The colour the chosen kind gets while the markup style leaves it unset. */\nconst fallback = computed(() => doc.value?.annotations.defaults.color(model.value.kind))\nconst icon = computed(() => MARKUP_ICONS[model.value.kind])\n\n/** ArrowDown opens on the first item; a click opens on the checked one. */\nlet focusFirst = false\nfunction onTriggerKeydown(e: KeyboardEvent): void {\n  if (e.key !== 'ArrowDown' || e.defaultPrevented || open.value) return\n  e.preventDefault()\n  focusFirst = true\n  open.value = true\n}\n\nfunction onOpenAutoFocus(e: Event): void {\n  e.preventDefault()\n  // One highlight menu is open at a time.\n  const menu = document.querySelector('[data-ink-menu=\"highlight\"] [role=\"menu\"]')\n  if (menu) {\n    if (focusFirst) menuItems(menu)[0]?.focus({ preventScroll: true })\n    else focusInitialMenuItem(menu)\n  }\n  focusFirst = false\n}\n\nfunction choose(kind: MarkupKind): void {\n  setOptions({ kind })\n  setTool('highlight')\n  open.value = false\n}\n\n// Reka's typed props stop at its own; ARIA and listeners go through bound objects.\nconst mainAttrs = computed(() => ({\n  'aria-pressed': String(active.value),\n  'aria-label': model.value.label,\n  title: model.value.label,\n  onClick: () => setTool('highlight'),\n}))\nconst triggerAttrs = {\n  'aria-label': 'Choose highlight',\n  title: 'Choose highlight',\n  'aria-haspopup': 'menu' as const,\n  onKeydown: onTriggerKeydown,\n}\nconst menuAttrs = { 'aria-label': 'Highlights' }\n/** The colour trigger is an item of this menu, reached with the arrow keys. */\nconst colourAttrs = { role: 'menuitem', tabindex: -1 }\nconst innerAttrs = {\n  role: 'menu',\n  'aria-label': 'Highlights',\n  // Capture, so the arrow keys move on from the colour item before its own ArrowDown\n  // opens the nested menu.\n  onKeydownCapture: (e: KeyboardEvent) =>\n    handleMenuKeys(e, e.currentTarget as HTMLElement),\n}\n</script>\n\n<template>\n  <PopoverRoot v-if=\"registered\" v-model:open=\"open\">\n    <PopoverAnchor as-child>\n      <div\n        role=\"group\"\n        aria-label=\"Highlight\"\n        class=\"ink-split-button ink-highlight-menu\"\n        data-ink-highlight-menu\n        v-bind=\"$attrs\"\n      >\n        <ToolbarButton\n          class=\"ink-tool-button ink-highlight-button\"\n          data-ink-tool-button\n          data-ink-highlight-button\n          data-tool=\"highlight\"\n          :data-kind=\"model.kind\"\n          :data-state=\"active ? 'on' : 'off'\"\n          v-bind=\"mainAttrs\"\n        >\n          <slot :active=\"active\" :kind=\"model.kind\"><InkIcon :icon=\"icon\" /></slot>\n        </ToolbarButton>\n        <ToolbarButton as-child>\n          <PopoverTrigger as-child>\n            <button\n              type=\"button\"\n              class=\"ink-menu-trigger ink-highlight-menu-trigger\"\n              data-ink-highlight-menu-trigger\n              :data-state=\"open ? 'open' : 'closed'\"\n              v-bind=\"triggerAttrs\"\n            >\n              <InkIcon :icon=\"ChevronDown\" />\n            </button>\n          </PopoverTrigger>\n        </ToolbarButton>\n        <PopoverPortal>\n          <PopoverContent\n            class=\"ink-select-content ink-menu-content\"\n            data-ink-select-content\n            data-ink-menu=\"highlight\"\n            side=\"bottom\"\n            align=\"start\"\n            :side-offset=\"4\"\n            :collision-padding=\"8\"\n            v-bind=\"menuAttrs\"\n            @open-auto-focus=\"onOpenAutoFocus\"\n          >\n            <div v-bind=\"innerAttrs\">\n              <div role=\"group\" aria-label=\"Kinds\" class=\"ink-highlight-kinds\">\n                <button\n                  v-for=\"item in model.items\"\n                  :key=\"item.kind\"\n                  type=\"button\"\n                  role=\"menuitemradio\"\n                  class=\"ink-select-item ink-menu-item ink-highlight-item\"\n                  data-ink-select-item\n                  tabindex=\"-1\"\n                  :data-key=\"item.kind\"\n                  :aria-checked=\"item.checked\"\n                  :data-state=\"item.checked ? 'checked' : 'unchecked'\"\n                  @click=\"choose(item.kind)\"\n                >\n                  <InkIcon :icon=\"MARKUP_ICONS[item.kind]\" :size=\"16\" />\n                  {{ item.label }}\n                </button>\n              </div>\n              <div role=\"separator\" class=\"ink-select-separator\" />\n              <div role=\"group\" aria-label=\"Colour\" class=\"ink-highlight-colour\">\n                <span class=\"ink-highlight-colour-label\" aria-hidden=\"true\">Colour</span>\n                <InkColorMenu\n                  property=\"border\"\n                  group=\"markup\"\n                  label=\"Highlight colour\"\n                  standalone\n                  :fallback=\"fallback\"\n                  v-bind=\"colourAttrs\"\n                />\n              </div>\n            </div>\n          </PopoverContent>\n        </PopoverPortal>\n      </div>\n    </PopoverAnchor>\n  </PopoverRoot>\n</template>\n"],"mappings":"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"}

package/dist/components/InkRoot.js.map

@@ -1 +1 @@
-{"version":3,"file":"InkRoot.js","names":["_sfc_main","InkRoot_vue_vue_type_script_setup_true_lang_default","InkRoot_default"],"sources":["../../src/components/InkRoot.vue"],"sourcesContent":["<script setup lang=\"ts\">\nimport {\n  createMemorySignatureStore,\n  createSignatureLibrary,\n  InkError,\n  openDocument,\n  readonly,\n  writable,\n} from '@inkbar/core'\nimport {\n  attachHistoryKeys,\n  createPluginHost,\n  createSearchController,\n  createToolOptions,\n  handleFindKey,\n  pageSelectionText,\n  viewerSearchOf,\n  cssVariableDefaults,\n  FONT_FAMILIES,\n  keepHistoryFocus,\n  SIGNATURE_FONTS,\n  trackToolStyle,\n} from '@inkbar/core/dom'\nimport { Primitive } from 'reka-ui'\nimport {\n  computed,\n  onBeforeUnmount,\n  onUnmounted,\n  onMounted,\n  onUpdated,\n  ref,\n  shallowRef,\n  useTemplateRef,\n  watch,\n} from 'vue'\n\nimport { provideInkContext, type InkHistory, type InkStatus } from '../context'\nimport { createRefHistory } from '../ref-history'\nimport { useReadable } from '../use-readable'\n\nimport type {\n  Annotation,\n  AnnotationChange,\n  AnnotationDefaults,\n  DocumentSource,\n  FieldsChange,\n  FieldValues,\n  FormAction,\n  InkDocument,\n  PdfAssets,\n  SignatureStore,\n} from '@inkbar/core'\nimport type {\n  DecorateAnnotation,\n  InkPlugin,\n  PluginHost,\n  SearchController,\n  Tool,\n  ToolController,\n  ToolId,\n  ToolStyle,\n  Viewport,\n  ZoomValue,\n} from '@inkbar/core/dom'\n\nconst props = withDefaults(\n  defineProps<{\n    src: DocumentSource | null\n    assets: PdfAssets\n    password?: string | undefined\n    /** Colour defaults. Without it, the theme's CSS variables on the root element apply. */\n    defaults?: AnnotationDefaults | undefined\n    /**\n     * Pass (with v-model) to put annotations under the host's control. The mode is fixed when a\n     * document opens: passing or dropping this prop later takes effect on the next open.\n     */\n    annotations?: Annotation[] | undefined\n    /**\n     * Pass (with `v-model:fields`) to put the form's field values under the host's control. A\n     * commit shows at once and is reported after; the host's push wins. The mode is fixed when\n     * a document opens, as for `annotations`.\n     */\n    fields?: FieldValues | undefined\n    /** Tints fillable form fields. Default true. A change applies to the open document in place. */\n    formHighlight?: boolean | undefined\n    tool?: ToolId | undefined\n    /**\n     * Host tools, added to the built-ins; one with a built-in's id replaces it. Read when a\n     * document opens.\n     */\n    tools?: Tool[] | undefined\n    /**\n     * Plugins, set up once when the root is created; a later change to this prop is not\n     * applied. Their tools join `tools`, their decoration and page layers apply to every\n     * document, and their commands are placed with `InkCommand` or `useCommand`.\n     */\n    plugins?: InkPlugin[] | undefined\n    /**\n     * Adds `data-*` attributes, classes and a screen-reader description to each annotation's\n     * element (see `DecorateAnnotation`). Decorations re-apply whenever the annotations change\n     * and when this prop changes, without rebuilding the viewer. Pass a new function when its\n     * output would change for any other reason.\n     */\n    decorateAnnotation?: DecorateAnnotation | undefined\n    /**\n     * The font families text boxes offer, replacing the PDF standard families\n     * (`FONT_FAMILIES`). Fonts beyond those are the PDF writer's to embed.\n     */\n    fonts?: string[] | undefined\n    /**\n     * Where saved signatures live. Default: memory, gone on reload.\n     * `createLocalSignatureStore` keeps them in the browser; a host can keep them anywhere.\n     * A new store takes effect at once, for the menus and the `signature` tool alike.\n     */\n    signatures?: SignatureStore | undefined\n    /** The handwriting fonts a typed signature offers; the host loads them. */\n    signatureFonts?: string[] | undefined\n    page?: number | undefined\n    zoom?: ZoomValue | undefined\n    /** Undo history. Defaults to on for uncontrolled, off for controlled. */\n    history?: boolean | undefined\n    asChild?: boolean\n  }>(),\n  {\n    password: undefined,\n    defaults: undefined,\n    annotations: undefined,\n    fields: undefined,\n    formHighlight: undefined,\n    tool: undefined,\n    tools: undefined,\n    plugins: undefined,\n    decorateAnnotation: undefined,\n    fonts: undefined,\n    signatures: undefined,\n    signatureFonts: undefined,\n    page: undefined,\n    zoom: undefined,\n    history: undefined,\n    asChild: false,\n  }\n)\n\nconst emit = defineEmits<{\n  'update:annotations': [next: Annotation[]]\n  change: [change: AnnotationChange]\n  /** Committed field values, in full, with what changed them. */\n  'update:fields': [next: FieldValues, change: FieldsChange]\n  /** The form asked to submit, open a link, send mail, print or prompt. Inkbar does none. */\n  'form-action': [action: FormAction]\n  'update:tool': [tool: ToolId]\n  'update:page': [page: number]\n  'update:zoom': [zoom: ZoomValue]\n  ready: [doc: InkDocument]\n  /**\n   * Opening failed, or later a form script failed or a signature field refused its signing.\n   * An error from while the document opened comes after `ready`.\n   */\n  error: [error: InkError]\n  activate: [id: string]\n}>()\n\ntype TestHookElement = HTMLElement & { __inkDocument?: InkDocument | undefined }\n\n// A template ref on Primitive is a component instance; the context needs its element.\nconst primitive = useTemplateRef<{ $el: unknown }>('primitive')\nconst rootEl = shallowRef<HTMLElement | null>(null)\nfunction syncRootEl(): void {\n  const el = primitive.value?.$el\n  rootEl.value = el instanceof HTMLElement ? el : null\n}\n\nconst document = shallowRef<InkDocument | null>(null)\n/** Overrides the document's status while opening, and when opening itself failed. */\nconst override = shallowRef<InkStatus | null>(null)\nconst idle: InkStatus = { state: 'idle' }\nconst documentStatus = useReadable<InkStatus>(() => document.value?.status ?? null, idle)\nconst status = computed<InkStatus>(() => override.value ?? documentStatus.value)\nconst annotationList = useReadable<readonly Annotation[]>(\n  () => document.value?.annotations.list ?? null,\n  []\n)\nconst selection = useReadable<readonly string[]>(\n  () => document.value?.annotations.selection ?? null,\n  []\n)\nconst viewport = shallowRef<Viewport | null>(null)\nconst toolController = shallowRef<ToolController | null>(null)\nconst internalTool = ref<ToolId>(props.tool ?? 'select-text')\nconst activated = ref<string | null>(null)\n\nconst controlled = computed(() => props.annotations !== undefined)\nconst fieldsControlled = computed(() => props.fields !== undefined)\n\nfunction setActivated(id: string | null): void {\n  activated.value = id\n  if (id) emit('activate', id)\n}\n\nconst noop = () => {}\n\n/** Signed URLs change; the key does not. Bytes and Blobs are their own identity. */\nfunction identity(src: DocumentSource | null): unknown {\n  if (src === null) return null\n  if (typeof src === 'string') return src\n  if ('key' in src) return src.key\n  return src\n}\n\nfunction setTestHook(doc: InkDocument | undefined): void {\n  if (import.meta.env.DEV && rootEl.value)\n    (rootEl.value as TestHookElement).__inkDocument = doc\n}\n\nlet generation = 0\nlet stopFormErrors: () => void = noop\nfunction release(): void {\n  stopFormErrors()\n  stopFormErrors = noop\n  // Cleared first, so the plugins close their stores while the document is still alive.\n  const doc = document.value\n  document.value = null\n  doc?.destroy()\n  setTestHook(undefined)\n}\n\nasync function open(): Promise<void> {\n  const gen = ++generation\n  const src = props.src\n  release()\n  refHistory.clear()\n  if (src === null) {\n    override.value = null\n    return\n  }\n  override.value = { state: 'loading' }\n  syncRootEl()\n  let doc: InkDocument\n  try {\n    doc = await openDocument(src, {\n      assets: props.assets,\n      password: props.password,\n      defaults:\n        props.defaults ?? (rootEl.value ? cssVariableDefaults(rootEl.value) : undefined),\n      // Controlled hosts get the ref history below; core's own stack stays off.\n      history: controlled.value ? false : (props.history ?? true),\n      annotations: controlled.value\n        ? {\n            mode: 'controlled',\n            initial: props.annotations ?? [],\n            onChange: (next, change) => {\n              emit('update:annotations', next)\n              emit('change', change)\n            },\n          }\n        : { mode: 'uncontrolled' },\n      fields: fieldsControlled.value\n        ? {\n            mode: 'controlled',\n            initial: props.fields ?? {},\n            onChange: (next, change) => emit('update:fields', next, change),\n          }\n        : { mode: 'uncontrolled' },\n    })\n  } catch (cause) {\n    if (gen !== generation) return\n    const error =\n      cause instanceof InkError\n        ? cause\n        : new InkError(\n            'InvalidPdf',\n            cause instanceof Error ? cause.message : String(cause),\n            {},\n            cause\n          )\n    override.value = { state: 'error', error }\n    emit('error', error)\n    return\n  }\n  if (gen !== generation) {\n    doc.destroy()\n    return\n  }\n  // The prop may have changed while the file loaded, when there was no store to apply it to.\n  if (doc.annotations.mode === 'controlled' && props.annotations !== undefined)\n    doc.annotations.setControlledValue(props.annotations)\n  // The same for the fields; a document whose fields opened uncontrolled ignores the push.\n  if (props.fields !== undefined) doc.form.setControlledValue(props.fields)\n  // A form script that fails leaves the form fillable; the failure goes to `error`. Subscribed\n  // before anyone hears of the document, so the form replays the errors from while it opened\n  // here, not to a listener added in `ready`; they are held until `ready` has gone out.\n  let held: InkError[] | undefined = []\n  stopFormErrors = doc.form.on('error', (e) => {\n    if (held) held.push(e)\n    else emit('error', e)\n  })\n  document.value = doc\n  override.value = null\n  setTestHook(doc)\n  const s = doc.status.get()\n  if (s.state === 'ready') emit('ready', doc)\n  else if (s.state === 'error') emit('error', s.error)\n  const early = held\n  held = undefined\n  if (gen === generation) for (const e of early) emit('error', e)\n}\n\nconst refHistory = createRefHistory({\n  source: () => props.annotations,\n  apply: (list) => document.value?.annotations.replaceAll(list, 'history'),\n  enabled: computed(() => controlled.value && props.history === true),\n  store: () =>\n    document.value?.annotations.mode === 'controlled' ? document.value.annotations : null,\n})\nconst coreCanUndo = useReadable(() => document.value?.history.canUndo ?? null, false)\nconst coreCanRedo = useReadable(() => document.value?.history.canRedo ?? null, false)\nconst inkHistory: InkHistory = {\n  canUndo: computed(() =>\n    controlled.value ? refHistory.canUndo.value : coreCanUndo.value\n  ),\n  canRedo: computed(() =>\n    controlled.value ? refHistory.canRedo.value : coreCanRedo.value\n  ),\n  undo: () => (controlled.value ? refHistory.undo() : document.value?.history.undo()),\n  redo: () => (controlled.value ? refHistory.redo() : document.value?.history.redo()),\n  clear: () => (controlled.value ? refHistory.clear() : document.value?.history.clear()),\n  batch: (fn) => {\n    if (controlled.value) refHistory.batch(fn)\n    else if (document.value) document.value.history.batch(fn)\n    else fn()\n  },\n  track: (store) =>\n    controlled.value\n      ? refHistory.track(store)\n      : (document.value?.history.track(store) ?? noop),\n  react: (fn) =>\n    controlled.value ? refHistory.react(fn) : (document.value?.history.react(fn) ?? noop),\n}\n\n// The undo and redo keys anywhere in the root do what InkUndo and InkRedo do. When either\n// button undoes or redoes the last step and disables itself, focus goes back to the document.\n// The find key listens here too.\nwatch(\n  rootEl,\n  (el, _prev, onCleanup) => {\n    if (!el) return\n    const stopKeys = attachHistoryKeys(el, () => ({\n      canUndo: inkHistory.canUndo.value,\n      canRedo: inkHistory.canRedo.value,\n      undo: inkHistory.undo,\n      redo: inkHistory.redo,\n    }))\n    const stopFocus = keepHistoryFocus(el, () =>\n      el.querySelector<HTMLElement>('[data-ink-scroll]')\n    )\n    // Not a template listener: Vue leaves those on the element when it unmounts.\n    el.addEventListener('keydown', onKeydown)\n    onCleanup(() => {\n      stopKeys()\n      stopFocus()\n      el.removeEventListener('keydown', onKeydown)\n    })\n  },\n  { immediate: true }\n)\n\n/*\n * One plugin host for the root's life, built once mounted so that no `setup` runs on the\n * server, where nothing would clean it up. Until then `pluginHost` is null, and InkCommand\n * renders its command disabled. The host follows `hostDocument`, which is set after `document`\n * (a sync watch): when the host reads `inkHistory` for a new document, it is that document's\n * history.\n */\nconst hostDocument = writable<InkDocument | null>(null)\nwatch(document, (doc) => hostDocument.set(doc), { flush: 'sync' })\nconst viewportEl = shallowRef<HTMLElement | null>(null)\nconst hostRoot = writable<HTMLElement | null>(null)\nwatch(viewportEl, (el) => hostRoot.set(el), { flush: 'sync' })\nconst hostActivated = writable<string | null>(null)\nwatch(activated, (id) => hostActivated.set(id), { flush: 'sync' })\nconst pluginHost = shallowRef<PluginHost | null>(null)\n/** One search controller for the root's life, built with the plugin host that shares it. */\nconst search = shallowRef<SearchController | null>(null)\nfunction setUpPlugins(): void {\n  const controller = createSearchController({\n    document: readonly(hostDocument),\n    viewport: () => viewport.value,\n  })\n  search.value = controller\n  pluginHost.value = createPluginHost({\n    plugins: props.plugins ?? [],\n    document: readonly(hostDocument),\n    history: () => inkHistory,\n    activated: readonly(hostActivated),\n    // As in `createViewer`: an id not in the open document is ignored.\n    setActivated: (id) => {\n      if (id === null || document.value?.annotations.get(id)) setActivated(id)\n    },\n    root: readonly(hostRoot),\n    decorate: () => props.decorateAnnotation,\n    viewport: () => viewport.value,\n    search: viewerSearchOf(controller),\n  })\n}\n\n/** Ctrl/Cmd+F while focus is in the root and a find bar is mounted; else the browser's. */\nfunction onKeydown(e: KeyboardEvent): void {\n  const controller = search.value\n  const root = e.currentTarget\n  if (controller && root instanceof HTMLElement)\n    handleFindKey(e, controller, () => pageSelectionText(root))\n}\n\n/** The document's tool style; it batches through `inkHistory`, whichever mode is on. */\nconst toolStyle = shallowRef<ToolStyle | null>(null)\nlet setStyleTool: ((id: ToolId) => void) | undefined\nwatch(\n  document,\n  (doc) => {\n    if (!doc) {\n      toolStyle.value = null\n      setStyleTool = undefined\n      return\n    }\n    const tracker = trackToolStyle({\n      store: doc.annotations,\n      history: { batch: (fn) => inkHistory.batch(fn) },\n      // The plugins' tools too, so a plugin tool's style group applies (the host is set by now:\n      // it is built on mount, before the first document opens).\n      tools: [...(props.tools ?? []), ...(pluginHost.value?.tools ?? [])],\n      tool: internalTool.value,\n    })\n    setStyleTool = (id) => tracker.setTool(id)\n    toolStyle.value = tracker.toolStyle\n  },\n  // Sync: the style is in place before InkViewport's watcher mounts the engine with it.\n  { immediate: true, flush: 'sync' }\n)\nwatch(internalTool, (id) => setStyleTool?.(id))\n\n// Plugins and the document on the client only: on the server InkRoot renders its empty slot.\n// The plugins first, so the first document opens with their stores and reactions.\nonMounted(() => {\n  syncRootEl()\n  // A plugin whose setup throws still leaves the document to open; the error then goes to\n  // Vue's error handling (`onErrorCaptured`, `app.config.errorHandler`).\n  try {\n    setUpPlugins()\n  } finally {\n    void open()\n  }\n})\nonUpdated(syncRootEl)\n\n// Separate sources, so a new `{ url, key }` object with the same key compares equal.\nwatch([() => identity(props.src), () => props.password], () => void open())\n\nwatch(\n  () => props.annotations,\n  (next) => {\n    if (next && document.value?.annotations.mode === 'controlled')\n      document.value.annotations.setControlledValue(next)\n  }\n)\n\nwatch(\n  () => props.fields,\n  (next) => {\n    if (next) document.value?.form.setControlledValue(next)\n  }\n)\n\nwatch(\n  () => props.tool,\n  (t) => {\n    if (t) internalTool.value = t\n  }\n)\n\nfunction setTool(id: ToolId): void {\n  // Picking the active tool again starts it afresh, as after a one-shot tool's use.\n  const tc = toolController.value\n  if (internalTool.value === id && tc?.active.get() === id) tc.set(id)\n  internalTool.value = id\n  emit('update:tool', id)\n}\n\nonBeforeUnmount(() => {\n  generation++\n  release()\n})\n\n// After the children: InkViewport's engine, and the plugin layers with it, are gone by now, as\n// in `createViewer`, so no layer `destroy` runs after the plugins' cleanups.\nonUnmounted(() => {\n  pluginHost.value?.destroy()\n  pluginHost.value = null\n  search.value?.destroy()\n  search.value = null\n})\n\nconst signatures = computed(() =>\n  createSignatureLibrary(props.signatures ?? createMemorySignatureStore())\n)\nwatch(signatures, (lib) => void lib.refresh(), { immediate: true })\n/** Tool options last as long as the root; the tool style is per document. */\nconst toolOptions = createToolOptions()\n\nprovideInkContext({\n  assets: computed(() => props.assets),\n  document,\n  status,\n  annotations: annotationList,\n  selection,\n  viewport,\n  tools: toolController,\n  tool: internalTool,\n  setTool,\n  hostTools: computed(() => props.tools),\n  decorateAnnotation: computed(() => props.decorateAnnotation),\n  fonts: computed(() => props.fonts ?? FONT_FAMILIES),\n  toolOptions,\n  signatures,\n  signatureFonts: computed(() => props.signatureFonts ?? SIGNATURE_FONTS),\n  toolStyle,\n  zoomModel: computed(() => props.zoom),\n  pageModel: computed(() => props.page),\n  reportZoom: (z) => emit('update:zoom', z),\n  reportPage: (p) => emit('update:page', p),\n  activated,\n  setActivated,\n  pluginHost,\n  search,\n  viewportEl,\n  history: inkHistory,\n  rootEl,\n  formHighlight: computed(() => props.formHighlight),\n  reportFormAction: (a) => emit('form-action', a),\n  reportError: (e) => emit('error', e),\n})\n\n// `history` is what `useHistory()` returns inside the root, for hosts that hold a template ref:\n// a controlled host calls `history.clear()` after loading its saved list.\ndefineExpose({ document, status, rootEl, history: inkHistory })\n</script>\n\n<template>\n  <Primitive\n    ref=\"primitive\"\n    :as-child=\"props.asChild\"\n    as=\"div\"\n    data-ink-root\n    :data-state=\"status.state\"\n  >\n    <slot :status=\"status\" :document=\"document\" />\n  </Primitive>\n</template>\n"],"mappings":""}
+{"version":3,"file":"InkRoot.js","names":["_sfc_main","InkRoot_vue_vue_type_script_setup_true_lang_default","InkRoot_default"],"sources":["../../src/components/InkRoot.vue"],"sourcesContent":["<script setup lang=\"ts\">\nimport {\n  createMemorySignatureStore,\n  createSignatureLibrary,\n  InkError,\n  openDocument,\n  readonly,\n  writable,\n} from '@inkbar/core'\nimport {\n  attachHistoryKeys,\n  createPluginHost,\n  createSearchController,\n  createToolOptions,\n  handleFindKey,\n  pageSelectionText,\n  viewerSearchOf,\n  cssVariableDefaults,\n  FONT_FAMILIES,\n  keepHistoryFocus,\n  SIGNATURE_FONTS,\n  trackToolStyle,\n  unknownTool,\n} from '@inkbar/core/dom'\nimport { Primitive } from 'reka-ui'\nimport {\n  computed,\n  onBeforeUnmount,\n  onUnmounted,\n  onMounted,\n  onUpdated,\n  ref,\n  shallowRef,\n  useTemplateRef,\n  watch,\n} from 'vue'\n\nimport { registeredToolIds } from '../composables/useRegisteredTool'\nimport { provideInkContext, type InkHistory, type InkStatus } from '../context'\nimport { createRefHistory } from '../ref-history'\nimport { useReadable } from '../use-readable'\n\nimport type {\n  Annotation,\n  AnnotationChange,\n  AnnotationDefaults,\n  DocumentSource,\n  FieldsChange,\n  FieldValues,\n  FormAction,\n  InkDocument,\n  PdfAssets,\n  SignatureStore,\n} from '@inkbar/core'\nimport type {\n  DecorateAnnotation,\n  InkPlugin,\n  PluginHost,\n  SearchController,\n  Tool,\n  ToolController,\n  ToolId,\n  ToolStyle,\n  Viewport,\n  ZoomValue,\n} from '@inkbar/core/dom'\n\nconst props = withDefaults(\n  defineProps<{\n    src: DocumentSource | null\n    assets: PdfAssets\n    password?: string | undefined\n    /** Colour defaults. Without it, the theme's CSS variables on the root element apply. */\n    defaults?: AnnotationDefaults | undefined\n    /**\n     * Pass (with v-model) to put annotations under the host's control. The mode is fixed when a\n     * document opens: passing or dropping this prop later takes effect on the next open.\n     */\n    annotations?: Annotation[] | undefined\n    /**\n     * Pass (with `v-model:fields`) to put the form's field values under the host's control. A\n     * commit shows at once and is reported after; the host's push wins. The mode is fixed when\n     * a document opens, as for `annotations`.\n     */\n    fields?: FieldValues | undefined\n    /** Tints fillable form fields. Default true. A change applies to the open document in place. */\n    formHighlight?: boolean | undefined\n    tool?: ToolId | undefined\n    /**\n     * The creation tools, such as `allTools()` or a pick of the tool factories. `select-text`\n     * and `select` are always present; a tool with either id replaces it. They are read when a\n     * document opens: a tool added later is usable from the next open, one removed stops at\n     * once. When the active tool goes, the viewer switches to `select-text` and emits\n     * `update:tool`. A controlled `tool` naming a missing tool is reported back as\n     * `select-text` and is not applied again when the tool appears later. Each mounted control\n     * for a missing tool logs its own `UnknownTool`.\n     */\n    tools?: Tool[] | undefined\n    /**\n     * Plugins, set up once when the root is created; a later change to this prop is not\n     * applied. Their tools join `tools`, their decoration and page layers apply to every\n     * document, and their commands are placed with `InkCommand` or `useCommand`.\n     */\n    plugins?: InkPlugin[] | undefined\n    /**\n     * Adds `data-*` attributes, classes and a screen-reader description to each annotation's\n     * element (see `DecorateAnnotation`). Decorations re-apply whenever the annotations change\n     * and when this prop changes, without rebuilding the viewer. Pass a new function when its\n     * output would change for any other reason.\n     */\n    decorateAnnotation?: DecorateAnnotation | undefined\n    /**\n     * The font families text boxes offer, replacing the PDF standard families\n     * (`FONT_FAMILIES`). Fonts beyond those are the PDF writer's to embed.\n     */\n    fonts?: string[] | undefined\n    /**\n     * Where saved signatures live. Default: memory, gone on reload.\n     * `createLocalSignatureStore` keeps them in the browser; a host can keep them anywhere.\n     * A new store takes effect at once, for the menus and the `signature` tool alike.\n     */\n    signatures?: SignatureStore | undefined\n    /** The handwriting fonts a typed signature offers; the host loads them. */\n    signatureFonts?: string[] | undefined\n    page?: number | undefined\n    zoom?: ZoomValue | undefined\n    /** Undo history. Defaults to on for uncontrolled, off for controlled. */\n    history?: boolean | undefined\n    asChild?: boolean\n  }>(),\n  {\n    password: undefined,\n    defaults: undefined,\n    annotations: undefined,\n    fields: undefined,\n    formHighlight: undefined,\n    tool: undefined,\n    tools: undefined,\n    plugins: undefined,\n    decorateAnnotation: undefined,\n    fonts: undefined,\n    signatures: undefined,\n    signatureFonts: undefined,\n    page: undefined,\n    zoom: undefined,\n    history: undefined,\n    asChild: false,\n  }\n)\n\nconst emit = defineEmits<{\n  'update:annotations': [next: Annotation[]]\n  change: [change: AnnotationChange]\n  /** Committed field values, in full, with what changed them. */\n  'update:fields': [next: FieldValues, change: FieldsChange]\n  /** The form asked to submit, open a link, send mail, print or prompt. Inkbar does none. */\n  'form-action': [action: FormAction]\n  'update:tool': [tool: ToolId]\n  'update:page': [page: number]\n  'update:zoom': [zoom: ZoomValue]\n  ready: [doc: InkDocument]\n  /**\n   * Opening failed, or later a form script failed or a signature field refused its signing.\n   * An error from while the document opened comes after `ready`.\n   */\n  error: [error: InkError]\n  activate: [id: string]\n}>()\n\ntype TestHookElement = HTMLElement & { __inkDocument?: InkDocument | undefined }\n\n// A template ref on Primitive is a component instance; the context needs its element.\nconst primitive = useTemplateRef<{ $el: unknown }>('primitive')\nconst rootEl = shallowRef<HTMLElement | null>(null)\nfunction syncRootEl(): void {\n  const el = primitive.value?.$el\n  rootEl.value = el instanceof HTMLElement ? el : null\n}\n\nconst document = shallowRef<InkDocument | null>(null)\n/** Overrides the document's status while opening, and when opening itself failed. */\nconst override = shallowRef<InkStatus | null>(null)\nconst idle: InkStatus = { state: 'idle' }\nconst documentStatus = useReadable<InkStatus>(() => document.value?.status ?? null, idle)\nconst status = computed<InkStatus>(() => override.value ?? documentStatus.value)\nconst annotationList = useReadable<readonly Annotation[]>(\n  () => document.value?.annotations.list ?? null,\n  []\n)\nconst selection = useReadable<readonly string[]>(\n  () => document.value?.annotations.selection ?? null,\n  []\n)\nconst viewport = shallowRef<Viewport | null>(null)\nconst toolController = shallowRef<ToolController | null>(null)\nconst internalTool = ref<ToolId>(props.tool ?? 'select-text')\nconst activated = ref<string | null>(null)\n\nconst controlled = computed(() => props.annotations !== undefined)\nconst fieldsControlled = computed(() => props.fields !== undefined)\n\nfunction setActivated(id: string | null): void {\n  activated.value = id\n  if (id) emit('activate', id)\n}\n\nconst noop = () => {}\n\n/** Signed URLs change; the key does not. Bytes and Blobs are their own identity. */\nfunction identity(src: DocumentSource | null): unknown {\n  if (src === null) return null\n  if (typeof src === 'string') return src\n  if ('key' in src) return src.key\n  return src\n}\n\nfunction setTestHook(doc: InkDocument | undefined): void {\n  if (import.meta.env.DEV && rootEl.value)\n    (rootEl.value as TestHookElement).__inkDocument = doc\n}\n\nlet generation = 0\nlet stopFormErrors: () => void = noop\nfunction release(): void {\n  stopFormErrors()\n  stopFormErrors = noop\n  // Cleared first, so the plugins close their stores while the document is still alive.\n  const doc = document.value\n  document.value = null\n  doc?.destroy()\n  setTestHook(undefined)\n}\n\nasync function open(): Promise<void> {\n  const gen = ++generation\n  const src = props.src\n  release()\n  refHistory.clear()\n  if (src === null) {\n    override.value = null\n    return\n  }\n  override.value = { state: 'loading' }\n  syncRootEl()\n  let doc: InkDocument\n  try {\n    doc = await openDocument(src, {\n      assets: props.assets,\n      password: props.password,\n      defaults:\n        props.defaults ?? (rootEl.value ? cssVariableDefaults(rootEl.value) : undefined),\n      // Controlled hosts get the ref history below; core's own stack stays off.\n      history: controlled.value ? false : (props.history ?? true),\n      annotations: controlled.value\n        ? {\n            mode: 'controlled',\n            initial: props.annotations ?? [],\n            onChange: (next, change) => {\n              emit('update:annotations', next)\n              emit('change', change)\n            },\n          }\n        : { mode: 'uncontrolled' },\n      fields: fieldsControlled.value\n        ? {\n            mode: 'controlled',\n            initial: props.fields ?? {},\n            onChange: (next, change) => emit('update:fields', next, change),\n          }\n        : { mode: 'uncontrolled' },\n    })\n  } catch (cause) {\n    if (gen !== generation) return\n    const error =\n      cause instanceof InkError\n        ? cause\n        : new InkError(\n            'InvalidPdf',\n            cause instanceof Error ? cause.message : String(cause),\n            {},\n            cause\n          )\n    override.value = { state: 'error', error }\n    emit('error', error)\n    return\n  }\n  if (gen !== generation) {\n    doc.destroy()\n    return\n  }\n  // The prop may have changed while the file loaded, when there was no store to apply it to.\n  if (doc.annotations.mode === 'controlled' && props.annotations !== undefined)\n    doc.annotations.setControlledValue(props.annotations)\n  // The same for the fields; a document whose fields opened uncontrolled ignores the push.\n  if (props.fields !== undefined) doc.form.setControlledValue(props.fields)\n  // A form script that fails leaves the form fillable; the failure goes to `error`. Subscribed\n  // before anyone hears of the document, so the form replays the errors from while it opened\n  // here, not to a listener added in `ready`; they are held until `ready` has gone out.\n  let held: InkError[] | undefined = []\n  stopFormErrors = doc.form.on('error', (e) => {\n    if (held) held.push(e)\n    else emit('error', e)\n  })\n  document.value = doc\n  override.value = null\n  setTestHook(doc)\n  const s = doc.status.get()\n  if (s.state === 'ready') emit('ready', doc)\n  else if (s.state === 'error') emit('error', s.error)\n  const early = held\n  held = undefined\n  if (gen === generation) for (const e of early) emit('error', e)\n}\n\nconst refHistory = createRefHistory({\n  source: () => props.annotations,\n  apply: (list) => document.value?.annotations.replaceAll(list, 'history'),\n  enabled: computed(() => controlled.value && props.history === true),\n  store: () =>\n    document.value?.annotations.mode === 'controlled' ? document.value.annotations : null,\n})\nconst coreCanUndo = useReadable(() => document.value?.history.canUndo ?? null, false)\nconst coreCanRedo = useReadable(() => document.value?.history.canRedo ?? null, false)\nconst inkHistory: InkHistory = {\n  canUndo: computed(() =>\n    controlled.value ? refHistory.canUndo.value : coreCanUndo.value\n  ),\n  canRedo: computed(() =>\n    controlled.value ? refHistory.canRedo.value : coreCanRedo.value\n  ),\n  undo: () => (controlled.value ? refHistory.undo() : document.value?.history.undo()),\n  redo: () => (controlled.value ? refHistory.redo() : document.value?.history.redo()),\n  clear: () => (controlled.value ? refHistory.clear() : document.value?.history.clear()),\n  batch: (fn) => {\n    if (controlled.value) refHistory.batch(fn)\n    else if (document.value) document.value.history.batch(fn)\n    else fn()\n  },\n  track: (store) =>\n    controlled.value\n      ? refHistory.track(store)\n      : (document.value?.history.track(store) ?? noop),\n  react: (fn) =>\n    controlled.value ? refHistory.react(fn) : (document.value?.history.react(fn) ?? noop),\n}\n\n// The undo and redo keys anywhere in the root do what InkUndo and InkRedo do. When either\n// button undoes or redoes the last step and disables itself, focus goes back to the document.\n// The find key listens here too.\nwatch(\n  rootEl,\n  (el, _prev, onCleanup) => {\n    if (!el) return\n    const stopKeys = attachHistoryKeys(el, () => ({\n      canUndo: inkHistory.canUndo.value,\n      canRedo: inkHistory.canRedo.value,\n      undo: inkHistory.undo,\n      redo: inkHistory.redo,\n    }))\n    const stopFocus = keepHistoryFocus(el, () =>\n      el.querySelector<HTMLElement>('[data-ink-scroll]')\n    )\n    // Not a template listener: Vue leaves those on the element when it unmounts.\n    el.addEventListener('keydown', onKeydown)\n    onCleanup(() => {\n      stopKeys()\n      stopFocus()\n      el.removeEventListener('keydown', onKeydown)\n    })\n  },\n  { immediate: true }\n)\n\n/*\n * One plugin host for the root's life, built once mounted so that no `setup` runs on the\n * server, where nothing would clean it up. Until then `pluginHost` is null, and InkCommand\n * renders its command disabled. The host follows `hostDocument`, which is set after `document`\n * (a sync watch): when the host reads `inkHistory` for a new document, it is that document's\n * history.\n */\nconst hostDocument = writable<InkDocument | null>(null)\nwatch(document, (doc) => hostDocument.set(doc), { flush: 'sync' })\nconst viewportEl = shallowRef<HTMLElement | null>(null)\nconst hostRoot = writable<HTMLElement | null>(null)\nwatch(viewportEl, (el) => hostRoot.set(el), { flush: 'sync' })\nconst hostActivated = writable<string | null>(null)\nwatch(activated, (id) => hostActivated.set(id), { flush: 'sync' })\nconst pluginHost = shallowRef<PluginHost | null>(null)\n/** One search controller for the root's life, built with the plugin host that shares it. */\nconst search = shallowRef<SearchController | null>(null)\nfunction setUpPlugins(): void {\n  const controller = createSearchController({\n    document: readonly(hostDocument),\n    viewport: () => viewport.value,\n  })\n  search.value = controller\n  pluginHost.value = createPluginHost({\n    plugins: props.plugins ?? [],\n    document: readonly(hostDocument),\n    history: () => inkHistory,\n    activated: readonly(hostActivated),\n    // As in `createViewer`: an id not in the open document is ignored.\n    setActivated: (id) => {\n      if (id === null || document.value?.annotations.get(id)) setActivated(id)\n    },\n    root: readonly(hostRoot),\n    decorate: () => props.decorateAnnotation,\n    viewport: () => viewport.value,\n    search: viewerSearchOf(controller),\n  })\n}\n\n/** Ctrl/Cmd+F while focus is in the root and a find bar is mounted; else the browser's. */\nfunction onKeydown(e: KeyboardEvent): void {\n  const controller = search.value\n  const root = e.currentTarget\n  if (controller && root instanceof HTMLElement)\n    handleFindKey(e, controller, () => pageSelectionText(root))\n}\n\n/** The document's tool style; it batches through `inkHistory`, whichever mode is on. */\nconst toolStyle = shallowRef<ToolStyle | null>(null)\nlet setStyleTool: ((id: ToolId) => void) | undefined\nwatch(\n  document,\n  (doc) => {\n    if (!doc) {\n      toolStyle.value = null\n      setStyleTool = undefined\n      return\n    }\n    const tracker = trackToolStyle({\n      store: doc.annotations,\n      history: { batch: (fn) => inkHistory.batch(fn) },\n      // The plugins' tools too, so a plugin tool's style group applies (the host is set by now:\n      // it is built on mount, before the first document opens).\n      tools: [...(props.tools ?? []), ...(pluginHost.value?.tools ?? [])],\n      tool: internalTool.value,\n    })\n    setStyleTool = (id) => tracker.setTool(id)\n    toolStyle.value = tracker.toolStyle\n  },\n  // Sync: the style is in place before InkViewport's watcher mounts the engine with it.\n  { immediate: true, flush: 'sync' }\n)\nwatch(internalTool, (id) => setStyleTool?.(id))\n\n// Plugins and the document on the client only: on the server InkRoot renders its empty slot.\n// The plugins first, so the first document opens with their stores and reactions.\nonMounted(() => {\n  syncRootEl()\n  // A plugin whose setup throws still leaves the document to open; the error then goes to\n  // Vue's error handling (`onErrorCaptured`, `app.config.errorHandler`).\n  try {\n    setUpPlugins()\n  } finally {\n    mounted.value = true\n    void open()\n  }\n})\nonUpdated(syncRootEl)\n\n// Separate sources, so a new `{ url, key }` object with the same key compares equal.\nwatch([() => identity(props.src), () => props.password], () => void open())\n\nwatch(\n  () => props.annotations,\n  (next) => {\n    if (next && document.value?.annotations.mode === 'controlled')\n      document.value.annotations.setControlledValue(next)\n  }\n)\n\nwatch(\n  () => props.fields,\n  (next) => {\n    if (next) document.value?.form.setControlledValue(next)\n  }\n)\n\n/*\n * The tools are known once the plugins are set up on mount. A tool id nobody registered is\n * logged as `UnknownTool`; as the active tool, from a `tool` prop or because it left `tools`,\n * it falls back to `select-text`, reported through `update:tool`. A controlled `tool` that\n * stays on the missing id is not applied again.\n */\nconst mounted = ref(false)\n/** The ids of the tools the current viewer was built with; InkViewport sets them. */\nconst openedToolIds = shallowRef<readonly ToolId[] | null>(null)\nconst toolIds = computed(() =>\n  registeredToolIds(props.tools, pluginHost.value, openedToolIds.value)\n)\nconst isRegistered = (id: ToolId): boolean => !mounted.value || toolIds.value.includes(id)\nconst logUnknownTool = (id: ToolId): void => console.error(unknownTool(id, toolIds.value))\n\nfunction fallBack(id: ToolId): void {\n  logUnknownTool(id)\n  internalTool.value = 'select-text'\n  emit('update:tool', 'select-text')\n}\n\nwatch(\n  () => props.tool,\n  (t) => {\n    if (!t) return\n    if (isRegistered(t)) internalTool.value = t\n    else fallBack(t)\n  }\n)\nwatch([mounted, toolIds], () => {\n  if (!isRegistered(internalTool.value)) fallBack(internalTool.value)\n})\n\nfunction setTool(id: ToolId): void {\n  // As the tool controller does: a missing tool is logged and nothing changes.\n  if (!isRegistered(id)) {\n    logUnknownTool(id)\n    return\n  }\n  // Picking the active tool again starts it afresh, as after a one-shot tool's use.\n  const tc = toolController.value\n  if (internalTool.value === id && tc?.active.get() === id) tc.set(id)\n  internalTool.value = id\n  emit('update:tool', id)\n}\n\nonBeforeUnmount(() => {\n  generation++\n  release()\n})\n\n// After the children: InkViewport's engine, and the plugin layers with it, are gone by now, as\n// in `createViewer`, so no layer `destroy` runs after the plugins' cleanups.\nonUnmounted(() => {\n  pluginHost.value?.destroy()\n  pluginHost.value = null\n  search.value?.destroy()\n  search.value = null\n})\n\nconst signatures = computed(() =>\n  createSignatureLibrary(props.signatures ?? createMemorySignatureStore())\n)\nwatch(signatures, (lib) => void lib.refresh(), { immediate: true })\n/** Tool options last as long as the root; the tool style is per document. */\nconst toolOptions = createToolOptions()\n\nprovideInkContext({\n  assets: computed(() => props.assets),\n  document,\n  status,\n  annotations: annotationList,\n  selection,\n  viewport,\n  tools: toolController,\n  tool: internalTool,\n  setTool,\n  hostTools: computed(() => props.tools),\n  openedToolIds,\n  decorateAnnotation: computed(() => props.decorateAnnotation),\n  fonts: computed(() => props.fonts ?? FONT_FAMILIES),\n  toolOptions,\n  signatures,\n  signatureFonts: computed(() => props.signatureFonts ?? SIGNATURE_FONTS),\n  toolStyle,\n  zoomModel: computed(() => props.zoom),\n  pageModel: computed(() => props.page),\n  reportZoom: (z) => emit('update:zoom', z),\n  reportPage: (p) => emit('update:page', p),\n  activated,\n  setActivated,\n  pluginHost,\n  search,\n  viewportEl,\n  history: inkHistory,\n  rootEl,\n  formHighlight: computed(() => props.formHighlight),\n  reportFormAction: (a) => emit('form-action', a),\n  reportError: (e) => emit('error', e),\n})\n\n// `history` is what `useHistory()` returns inside the root, for hosts that hold a template ref:\n// a controlled host calls `history.clear()` after loading its saved list.\ndefineExpose({ document, status, rootEl, history: inkHistory })\n</script>\n\n<template>\n  <Primitive\n    ref=\"primitive\"\n    :as-child=\"props.asChild\"\n    as=\"div\"\n    data-ink-root\n    :data-state=\"status.state\"\n  >\n    <slot :status=\"status\" :document=\"document\" />\n  </Primitive>\n</template>\n"],"mappings":""}

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

@@ -22,8 +22,13 @@ type __VLS_Props = {
     formHighlight?: boolean | undefined;
     tool?: ToolId | undefined;
     /**
-     * Host tools, added to the built-ins; one with a built-in's id replaces it. Read when a
-     * document opens.
+     * The creation tools, such as `allTools()` or a pick of the tool factories. `select-text`
+     * and `select` are always present; a tool with either id replaces it. They are read when a
+     * document opens: a tool added later is usable from the next open, one removed stops at
+     * once. When the active tool goes, the viewer switches to `select-text` and emits
+     * `update:tool`. A controlled `tool` naming a missing tool is reported back as
+     * `select-text` and is not applied again when the tool appears later. Each mounted control
+     * for a missing tool logs its own `UnknownTool`.
      */
     tools?: Tool[] | undefined;
     /**
@@ -71,6 +76,7 @@ declare const __VLS_base: import('vue').DefineComponent<__VLS_Props, {
     rootEl: import('vue').ShallowRef<HTMLElement | null, HTMLElement | null>;
     history: InkHistory;
 }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    ready: (doc: InkDocument) => any;
     "update:annotations": (next: ({
         type: "highlight" | "underline" | "strikeout" | "squiggly";
         quads: {
@@ -482,10 +488,10 @@ declare const __VLS_base: import('vue').DefineComponent<__VLS_Props, {
     "update:tool": (tool: ToolId) => any;
     "update:page": (page: number) => any;
     "update:zoom": (zoom: ZoomValue) => any;
-    ready: (doc: InkDocument) => any;
     error: (error: InkError) => any;
     activate: (id: string) => any;
 }, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onReady?: (doc: InkDocument) => any;
     "onUpdate:annotations"?: (next: ({
         type: "highlight" | "underline" | "strikeout" | "squiggly";
         quads: {
@@ -897,7 +903,6 @@ declare const __VLS_base: import('vue').DefineComponent<__VLS_Props, {
     "onUpdate:tool"?: (tool: ToolId) => any;
     "onUpdate:page"?: (page: number) => any;
     "onUpdate:zoom"?: (zoom: ZoomValue) => any;
-    onReady?: (doc: InkDocument) => any;
     onError?: (error: InkError) => any;
     onActivate?: (id: string) => any;
 }>, {

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

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