@inkbar/vue 0.10.0 → 0.12.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"InkOutlineNodes.vue_vue_type_script_setup_true_lang.js","names":["$slots","_resolveComponent","_openBlock","_createElementBlock","_Fragment","_renderList","_mergeProps","_createElementVNode","_withModifiers","_createVNode","InkIcon","_unref","_renderSlot","_createTextVNode","_toDisplayString","_createSlots","_withCtx","_createCommentVNode","InkIcon_default","_hoisted_1","_hoisted_2","_hoisted_3","_hoisted_4","_hoisted_5","InkOutlineNodes_vue_vue_type_script_setup_true_lang_default","props","__props","isOpen","item","_component_InkOutlineNodes","resolveComponent","openBlock","createElementBlock","Fragment","renderList","mergeProps","createElementVNode","withModifiers","createVNode","unref","ChevronRight","renderSlot","_ctx","createTextVNode","toDisplayString","createSlots","withCtx","slotProps","createCommentVNode"],"sources":["../../src/components/InkOutlineNodes.vue"],"sourcesContent":["<script setup lang=\"ts\">\n/*\n * One level of `InkOutline`'s tree, and below it the levels of the items that have children.\n * Internal: it renders the markup `OutlineController.itemAttrs` documents and spreads what the\n * controller gives it.\n */\nimport { ChevronRight } from '@inkbar/icons'\n\nimport InkIcon from './InkIcon.vue'\n\nimport type { OutlineItem } from '@inkbar/core'\nimport type { OutlineController } from '@inkbar/core/dom'\n\nconst props = defineProps<{\n  items: readonly OutlineItem[]\n  controller: OutlineController\n  /** Reads the controller's stores so a render follows them. */\n  attrs: (id: string) => Record<string, string | undefined>\n  expanded: ReadonlySet<string>\n  current: string | null\n}>()\n\nconst isOpen = (item: OutlineItem): boolean => props.expanded.has(item.id)\n\ndefineSlots<{\n  item?(props: { item: OutlineItem; current: boolean; expanded: boolean }): unknown\n}>()\n</script>\n\n<template>\n  <li\n    v-for=\"item in items\"\n    :key=\"item.id\"\n    class=\"ink-outline-item\"\n    :data-ink-outline-item=\"item.id\"\n    :data-bold=\"item.bold ? '' : undefined\"\n    :data-italic=\"item.italic ? '' : undefined\"\n    :style=\"{ '--ink-outline-level': item.id.split('.').length - 1 }\"\n    v-bind=\"attrs(item.id)\"\n  >\n    <div\n      class=\"ink-outline-row\"\n      v-bind=\"controller.rowAttrs(item.id)\"\n      @click=\"controller.activate(item.id)\"\n    >\n      <span\n        v-if=\"item.children.length > 0\"\n        class=\"ink-outline-toggle\"\n        aria-hidden=\"true\"\n        @click.stop=\"controller.toggle(item.id)\"\n      >\n        <InkIcon :icon=\"ChevronRight\" />\n      </span>\n      <span v-else class=\"ink-outline-spacer\" aria-hidden=\"true\" />\n      <span class=\"ink-outline-title\" v-bind=\"controller.titleAttrs(item.id)\">\n        <slot\n          name=\"item\"\n          :item=\"item\"\n          :current=\"current === item.id\"\n          :expanded=\"isOpen(item)\"\n        >\n          {{ item.title }}\n        </slot>\n      </span>\n    </div>\n    <ul\n      v-if=\"item.children.length > 0\"\n      class=\"ink-outline-group\"\n      role=\"group\"\n      :hidden=\"!expanded.has(item.id)\"\n    >\n      <InkOutlineNodes\n        :items=\"item.children\"\n        :controller=\"controller\"\n        :attrs=\"attrs\"\n        :expanded=\"expanded\"\n        :current=\"current\"\n      >\n        <template v-if=\"$slots.item\" #item=\"slotProps\">\n          <slot name=\"item\" v-bind=\"slotProps\" />\n        </template>\n      </InkOutlineNodes>\n    </ul>\n  </li>\n</template>\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;EAaA,IAAMyB,IAAQC,GASRC,KAAU,MAA+BF,EAAM,SAAS,IAAIG,EAAK,EAAE;;;GAQvE,OAAA1B,EAAA,EAAA,GAAAC,EAqDKC,GAAA,MAAAC,EApDYqB,EAAA,QAAR,OADTxB,EAAA,GAAAC,EAqDK,MArDLG,EAqDK;IAnDF,KAAKsB,EAAK;IACX,OAAM;IACL,yBAAuBA,EAAK;IAC5B,aAAWA,EAAK,OAAI,KAAQ,KAAA;IAC5B,eAAaA,EAAK,SAAM,KAAQ,KAAA;IAChC,OAAK,EAAA,uBAA2BA,EAAK,GAAG,MAAK,GAAA,CAAA,CAAM,SAAM,EAAA;GAClD,GAAA,EAAA,SAAA,GAAA,GAAAF,EAAA,MAAME,EAAK,EAAE,CAAA,GAAA,CAErBrB,EAwBM,OAxBND,EAwBM,EAvBJ,OAAM,kBAAiB,GAAA,EAAA,SAAA,GAAA,GACfoB,EAAA,WAAW,SAASE,EAAK,EAAE,GAAA,EAClC,UAAK,MAAEF,EAAA,WAAW,SAASE,EAAK,EAAE,EAAA,CAAA,GAAA,CAG3BA,EAAK,SAAS,SAAM,KAD5B1B,EAAA,GAAAC,EAOO,QAAA;;IALL,OAAM;IACN,eAAY;IACX,SAAKK,GAAA,MAAOkB,EAAA,WAAW,OAAOE,EAAK,EAAE,GAAA,CAAA,MAAA,CAAA;GAEtCnB,GAAAA,CAAAA,EAAgCC,GAAA,EAAtB,MAAMC,EAAA6B,CAAA,EAAY,GAAA,MAAA,GAAA,CAAA,MAAA,CAAA,CAAA,GAAA,GAAAnB,CAAA,MAE9BnB,EAAA,GAAAC,EAA6D,QAA7DmB,CAA6D,IAC7Df,EASO,QATPD,EASO,EATD,OAAM,oBAAmB,GAAA,EAAA,SAAA,GAAA,GAASoB,EAAA,WAAW,WAAWE,EAAK,EAAE,CAAA,GAAA,CACnEhB,EAOO8B,EAAA,QAAA,QAAA;IALE;IACN,SAAShB,EAAA,YAAYE,EAAK;IAC1B,UAAUD,EAAOC,CAAI;GAJxB,SAOO,CADFf,EAAAC,EAAAc,EAAK,KAAK,GAAA,CAAA,CAAA,CAAA,CAAA,GAAA,EAAA,CAAA,GAAA,IAAAR,CAAA,GAKXQ,EAAK,SAAS,SAAM,KAD5B1B,EAAA,GAAAC,EAiBK,MAAA;;IAfH,OAAM;IACN,MAAK;IACJ,QAAM,CAAGuB,EAAA,SAAS,IAAIE,EAAK,EAAE;GAE9BnB,GAAAA,CAAAA,EAUkBoB,GAAA;IATf,OAAOD,EAAK;IACZ,YAAYF,EAAA;IACZ,OAAOA,EAAA;IACP,UAAUA,EAAA;IACV,SAASA,EAAA;GAEM1B,GAAAA,EAAAA,EAAAA,GAAAA,EAAAA,GAAAA,CAAAA,EAAAA,OAAO,OAAA;IAAO,MAAA;IAC5B,IAAAgB,GADkC,MAAS,CAC3CJ,EAAuC8B,EAAA,QAAA,QAAvCpC,EAAuC,EAAA,SAAA,GAAA,GAAbyC,CAAS,CAAA,CAAA,CAAA"}

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  attachFileKeys,\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    // Ctrl or Cmd+P prints and +S downloads, as InkPrintButton and InkDownloadButton do.\n    const stopFileKeys = attachFileKeys(el, () => document.value)\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      stopFileKeys()\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":""}
+{"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  createMemoryStorage,\n  createSignatureLibrary,\n  createStorageSignatureStore,\n  InkError,\n  openDocument,\n  readonly,\n  writable,\n} from '@inkbar/core'\nimport {\n  attachFileKeys,\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  getCurrentInstance,\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  ViewerAction,\n  InkDocument,\n  InkStorage,\n  PdfAssets,\n  SignatureStore,\n} from '@inkbar/core'\nimport type {\n  DecorateAnnotation,\n  InkPlugin,\n  Navigation,\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 the viewer keeps what lasts between visits: saved signatures, each `InkSidebar`'s\n     * width and the plugins' settings. Default: memory, gone on reload. `createLocalStorage`\n     * keeps them in the browser; a host can keep them anywhere. Read once, when the root is\n     * created.\n     */\n    storage?: InkStorage | undefined\n    /**\n     * Where saved signatures live, in place of `storage`. A new store takes effect at once, for\n     * the menus and the `signature` tool alike.\n     * @deprecated Pass `storage`; signatures are kept in it under `signatures`. Removed in 0.13.0.\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    storage: 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  /**\n   * The viewer asked the host to submit a form, open a link, send mail, print or prompt. Inkbar\n   * does none of these.\n   */\n  action: [action: ViewerAction]\n  /** @deprecated Use `action`. Removed in 0.13.0. Not emitted when `action` has a listener. */\n  'form-action': [action: ViewerAction]\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}>()\nconst instance = getCurrentInstance()\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 navigation = shallowRef<Navigation | 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    // Ctrl or Cmd+P prints and +S downloads, as InkPrintButton and InkDownloadButton do.\n    const stopFileKeys = attachFileKeys(el, () => document.value)\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      stopFileKeys()\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' })\n/** Read once, like `plugins`: the sidebars and the plugins load from it as they are created. */\nconst storage = props.storage ?? createMemoryStorage()\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    storage,\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 storageSignatures = createStorageSignatureStore(storage)\n// The deprecated `signatures` wins when both are given.\nconst signatures = computed(() =>\n  createSignatureLibrary(props.signatures ?? storageSignatures)\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  navigation,\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  storage,\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  reportAction: (a) => {\n    // Emits cannot say who listens, so ask the vnode: `@action` wins over `@form-action`.\n    const listeners = instance?.vnode.props\n    if (!listeners?.onAction && listeners?.onFormAction) emit('form-action', a)\n    else emit('action', a)\n  },\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

@@ -1,4 +1,4 @@
-import { InkError, Annotation, AnnotationChange, AnnotationDefaults, DocumentSource, FieldsChange, FieldValues, FormAction, InkDocument, PdfAssets, SignatureStore } from '@inkbar/core';
+import { InkError, Annotation, AnnotationChange, AnnotationDefaults, DocumentSource, FieldsChange, FieldValues, ViewerAction, InkDocument, InkStorage, PdfAssets, SignatureStore } from '@inkbar/core';
 import { InkHistory, InkStatus } from '../context';
 import { DecorateAnnotation, InkPlugin, Tool, ToolId, ZoomValue } from '@inkbar/core/dom';
 type __VLS_Props = {
@@ -50,9 +50,16 @@ type __VLS_Props = {
      */
     fonts?: string[] | undefined;
     /**
-     * Where saved signatures live. Default: memory, gone on reload.
-     * `createLocalSignatureStore` keeps them in the browser; a host can keep them anywhere.
-     * A new store takes effect at once, for the menus and the `signature` tool alike.
+     * Where the viewer keeps what lasts between visits: saved signatures, each `InkSidebar`'s
+     * width and the plugins' settings. Default: memory, gone on reload. `createLocalStorage`
+     * keeps them in the browser; a host can keep them anywhere. Read once, when the root is
+     * created.
+     */
+    storage?: InkStorage | undefined;
+    /**
+     * Where saved signatures live, in place of `storage`. A new store takes effect at once, for
+     * the menus and the `signature` tool alike.
+     * @deprecated Pass `storage`; signatures are kept in it under `signatures`. Removed in 0.13.0.
      */
     signatures?: SignatureStore | undefined;
     /** The handwriting fonts a typed signature offers; the host loads them. */
@@ -497,7 +504,8 @@ declare const __VLS_base: import('vue').DefineComponent<__VLS_Props, {
     })[]) => any;
     change: (change: AnnotationChange) => any;
     "update:fields": (next: Readonly<Record<string, import('@inkbar/core').FieldValue>>, change: FieldsChange) => any;
-    "form-action": (action: FormAction) => any;
+    action: (action: ViewerAction) => any;
+    "form-action": (action: ViewerAction) => any;
     "update:tool": (tool: ToolId) => any;
     "update:page": (page: number) => any;
     "update:zoom": (zoom: ZoomValue) => any;
@@ -925,7 +933,8 @@ declare const __VLS_base: import('vue').DefineComponent<__VLS_Props, {
     })[]) => any;
     onChange?: (change: AnnotationChange) => any;
     "onUpdate:fields"?: (next: Readonly<Record<string, import('@inkbar/core').FieldValue>>, change: FieldsChange) => any;
-    "onForm-action"?: (action: FormAction) => any;
+    onAction?: (action: ViewerAction) => any;
+    "onForm-action"?: (action: ViewerAction) => any;
     "onUpdate:tool"?: (tool: ToolId) => any;
     "onUpdate:page"?: (page: number) => any;
     "onUpdate:zoom"?: (zoom: ZoomValue) => any;
@@ -1360,6 +1369,7 @@ declare const __VLS_base: import('vue').DefineComponent<__VLS_Props, {
     plugins: InkPlugin[] | undefined;
     decorateAnnotation: DecorateAnnotation | undefined;
     fonts: string[] | undefined;
+    storage: InkStorage | undefined;
     signatures: SignatureStore | undefined;
     signatureFonts: string[] | undefined;
     zoom: ZoomValue | undefined;

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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"}