@embedpdf/vue 3.0.0-next.15 → 3.0.0-next.16

package/dist/{DocumentScope.vue_vue_type_script_setup_true_lang-CtTu1FGX.js → DocumentScope.vue_vue_type_script_setup_true_lang-C-7yeEGh.js}

@@ -1,4 +1,4 @@
-import { epdfThemeVariables, browserClock } from "@embedpdf/web";
+import { epdfThemeVariables, browserPrinter, browserClock } from "@embedpdf/web";
 import { defineComponent, shallowRef, toRaw, watch, onMounted, onUnmounted, computed, renderSlot, openBlock, createElementBlock, Fragment, createCommentVNode, onScopeDispose, unref } from "vue";
 import { isLocalEngine, createKernel, viewerSettingsOf } from "@embedpdf/core";
 import { d as devWarn } from "./dev-CtMlvxjZ.js";
@@ -73,7 +73,8 @@ const _sfc_main$3 = /* @__PURE__ */ defineComponent({
           engine,
           plugins: initial.plugins,
           settings: settingsOf(),
-          clock: browserClock()
+          clock: browserClock(),
+          printer: browserPrinter()
         });
       } catch (error) {
         bootError.value = error;
@@ -188,4 +189,4 @@ export {
   _sfc_main$3 as c,
   epdfTheme as e
 };
-//# sourceMappingURL=DocumentScope.vue_vue_type_script_setup_true_lang-CtTu1FGX.js.map
+//# sourceMappingURL=DocumentScope.vue_vue_type_script_setup_true_lang-C-7yeEGh.js.map

package/dist/DocumentScope.vue_vue_type_script_setup_true_lang-C-7yeEGh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocumentScope.vue_vue_type_script_setup_true_lang-C-7yeEGh.js","sources":["../src/theme.ts","../src/runtime/Viewer.vue","../src/runtime/KernelProvider.vue","../src/runtime/DocumentGate.vue","../src/runtime/DocumentScope.vue"],"sourcesContent":["/**\n * `epdfTheme()`: a theme written with setting names, as a style for the\n * element around your viewer. The variables and their lookup are framework-free\n * (`@embedpdf/web`); this only types the result as Vue's style.\n */\nimport type { CSSProperties } from 'vue';\nimport { epdfThemeVariables, type EpdfTheme } from '@embedpdf/web';\n\nexport type { EpdfTheme } from '@embedpdf/web';\n\n/**\n * The CSS variables of a theme, for a `:style` binding: `<div :style=\"epdfTheme({ accent })\">`.\n * Everything inside the element follows them, and a CSS variable wins over any setting.\n */\nexport function epdfTheme(theme: EpdfTheme): CSSProperties {\n  return epdfThemeVariables(theme) as CSSProperties;\n}\n","<!--\n  <Viewer>: owns the kernel. It creates and starts the kernel when it mounts\n  (never on the server) and destroys it when it unmounts; the components inside\n  read it through composables. `engine`, `plugins` and `initialDocuments` are\n  read once; `identity`, `scope`, `accent` and `page` are the viewer's settings\n  and follow the props.\n-->\n<script setup lang=\"ts\">\nimport { computed, onMounted, onUnmounted, shallowRef, toRaw, watch } from 'vue';\nimport { createKernel, isLocalEngine, viewerSettingsOf } from '@embedpdf/core';\nimport { browserClock, browserPrinter } from '@embedpdf/web';\nimport type {\n  AnyPlugin,\n  Engine,\n  EngineFactory,\n  Identity,\n  InitialDocument,\n  Kernel,\n  ViewerPageSettings,\n  ViewerSettings,\n} from '@embedpdf/core';\nimport { devWarn } from '../dev';\nimport { provideViewer } from './kernel';\n\nconst props = defineProps<{\n  /**\n   * The engine, as an instance or a function. An instance is borrowed: the\n   * viewer uses it and never destroys it (a module-level `localEngine()`\n   * shared by every viewer). A function is the viewer's own: it calls it when\n   * it mounts and destroys the engine when it unmounts. Read once.\n   */\n  engine: Engine | EngineFactory;\n  /** The plugins, created once next to the engine. Read once. */\n  plugins: AnyPlugin[];\n  /** Documents to open when the viewer starts, with optional tab names. Read once. */\n  initialDocuments?: InitialDocument[];\n  /**\n   * Who the user is, for every document opened without an `identity` of its\n   * own (which replaces this one). Documents opened after a change use the new\n   * value; open ones keep theirs. The local engine only: the cloud engine reads\n   * it from the document's token.\n   */\n  identity?: Identity;\n  /**\n   * What the user may do, as permissions, in every document opened without a\n   * `scope` of its own. Left out, they may do everything. Changes reach the\n   * documents opened after them, as `identity`.\n   */\n  scope?: readonly string[];\n  /** The color every part without a color of its own follows. CSS `--epdf-accent` wins over it. */\n  accent?: string;\n  /** How pages look: `background` before the picture arrives, and the `shadow` under each page. */\n  page?: Partial<ViewerPageSettings>;\n}>();\n\nconst emit = defineEmits<{\n  /**\n   * The kernel has started: before the default slot mounts and before\n   * `initialDocuments` open. The door for code outside Vue components\n   * (register commands, subscribe to events).\n   */\n  ready: [kernel: Kernel];\n}>();\n\ndefineSlots<{\n  /** The viewer's content, mounted once the kernel has started. */\n  default?(): unknown;\n  /** Shown while the kernel starts; the composables already work in it. */\n  fallback?(): unknown;\n  /** Shown when the kernel couldn't be created or started. Without it, a failed start shows nothing. */\n  error?(props: { error: unknown }): unknown;\n}>();\n\n/**\n * The viewer's settings as the props give them: a prop left out is its\n * default. Values reach the kernel raw: a reactive copy would be another object\n * to it, and can't be sent to a worker.\n */\nconst settingsOf = (): ViewerSettings =>\n  viewerSettingsOf({\n    identity: toRaw(props.identity),\n    scope: toRaw(props.scope),\n    accent: props.accent,\n    page: toRaw(props.page),\n  });\n\nconst kernel = shallowRef<Kernel | null>(null);\nconst phase = shallowRef<'booting' | 'ready' | 'error'>('booting');\nconst bootError = shallowRef<unknown>(null);\n// Goes up on every kernel change; every reader's computed depends on it.\nconst revision = shallowRef(0);\n\nprovideViewer({\n  get kernel() {\n    return kernel.value;\n  },\n  track: () => {\n    void revision.value;\n  },\n});\n\n// Read once: a changed engine or plugin list can't mean \"rebuild the\n// workspace\", which would drop every open document. Raw, because the kernel\n// knows a plugin's token by identity, and a reactive copy is another object.\nconst initial = {\n  engine: toRaw(props.engine),\n  plugins: toRaw(props.plugins),\n  initialDocuments: toRaw(props.initialDocuments),\n};\nwatch(\n  () => props.plugins,\n  () =>\n    devWarn(\n      'viewer-plugins-init-only',\n      '<Viewer> plugins are read once, when it mounts; a new list is ignored. ' +\n        'Create the list once, next to the engine, not inline in the template.',\n    ),\n);\nwatch(\n  () => props.engine,\n  (engine) => {\n    // An inline `:engine=\"() => localEngine()\"` is a new function on every\n    // render; only another engine instance is worth a warning.\n    if (typeof engine === 'function') return;\n    devWarn(\n      'viewer-engine-init-only',\n      '<Viewer> engine is read once, when it mounts; another engine is ignored. ' +\n        'To use another engine, mount a new <Viewer>, for example with a new `key`.',\n    );\n  },\n);\n\nlet teardown: (() => void) | null = null;\n\nonMounted(() => {\n  // A function is the viewer's own engine: called now, destroyed on unmount.\n  // An instance is borrowed. Construction is synchronous and inert either way,\n  // so warming up a local engine overlaps its boot with the plugins' start.\n  const ownsEngine = typeof initial.engine === 'function';\n  const engine: Engine = ownsEngine\n    ? (initial.engine as EngineFactory)()\n    : (initial.engine as Engine);\n  if (isLocalEngine(engine)) engine.warmup();\n  let created: Kernel;\n  try {\n    created = createKernel({\n      engine,\n      plugins: initial.plugins,\n      settings: settingsOf(),\n      clock: browserClock(),\n      printer: browserPrinter(),\n    });\n  } catch (error) {\n    // A plan or dependency error shows in the `error` slot.\n    bootError.value = error;\n    phase.value = 'error';\n    if (ownsEngine) void engine.destroy();\n    return;\n  }\n  const stopTracking = created.subscribe(() => {\n    revision.value += 1;\n  });\n  // The kernel is on the binding from now on, so the fallback can use it.\n  kernel.value = created;\n  let alive = true;\n  created.start().then(\n    () => {\n      if (!alive) return;\n      emit('ready', created);\n      phase.value = 'ready';\n      // Every tab appears at once, in order; the `active` entry (else the\n      // first) is selected; a failure shows as that document's status.\n      created.documents.openAll(initial.initialDocuments ?? []);\n    },\n    (error: unknown) => {\n      if (!alive) return;\n      bootError.value = error;\n      phase.value = 'error';\n    },\n  );\n  teardown = () => {\n    alive = false;\n    stopTracking();\n    // The kernel first (it closes every document's handle), then the engine\n    // the viewer owns.\n    void created.destroy().then(() => {\n      if (ownsEngine) void engine.destroy();\n    });\n  };\n});\n\n// After the content has unmounted, so its own cleanups still reach a live kernel.\nonUnmounted(() => teardown?.());\n\n// Props compare by value: an inline `:page=\"{ shadow: 'none' }\"` is a new\n// object on every render, and settings that didn't change change nothing.\nwatch(settingsOf, (settings) => kernel.value?.updateSettings(settings));\n\ndefineExpose({\n  /** The started kernel; null before it starts and after a failed start. */\n  kernel: computed(() => (phase.value === 'ready' ? kernel.value : null)),\n});\n</script>\n\n<template>\n  <slot v-if=\"phase === 'error'\" name=\"error\" :error=\"bootError\" />\n  <template v-else-if=\"kernel\">\n    <slot v-if=\"phase === 'ready'\" />\n    <slot v-else name=\"fallback\" />\n  </template>\n</template>\n","<!--\n  <KernelProvider :kernel>: gives its content a kernel someone else created and\n  owns, so every composable inside works against that kernel. The full viewer's\n  Vue wrapper puts the components it shows in the viewer inside one. It never\n  starts or destroys the kernel; <Viewer> is the component that owns one. The\n  kernel is read once: for another one, mount a new provider (a new `key`).\n-->\n<script setup lang=\"ts\">\nimport { onScopeDispose, shallowRef, toRaw, watch } from 'vue';\nimport type { Kernel } from '@embedpdf/core';\nimport { devWarn } from '../dev';\nimport { provideViewer } from './kernel';\n\nconst props = defineProps<{\n  /** The kernel, created and started by its owner. Read once. */\n  kernel: Kernel;\n}>();\n\ndefineSlots<{ default?(): unknown }>();\n\n// Read once, as `<Viewer>` reads its engine: the composables inside took this kernel when they\n// were set up, and a new one under them would leave them reading the old one. Raw, because a\n// reactive copy of the kernel is another object.\nconst kernel = toRaw(props.kernel);\nwatch(\n  () => props.kernel,\n  () =>\n    devWarn(\n      'kernel-provider-kernel-init-only',\n      '<KernelProvider> kernel is read once, when it mounts; another kernel is ignored. ' +\n        'To give its content another kernel, mount a new <KernelProvider>, for example with a new `key`.',\n    ),\n);\n\n// Goes up on every change the kernel announces; every reader's computed depends on it.\nconst revision = shallowRef(0);\nonScopeDispose(\n  kernel.subscribe(() => {\n    revision.value += 1;\n  }),\n);\n\nprovideViewer({\n  kernel,\n  track: () => {\n    void revision.value;\n  },\n});\n</script>\n\n<template>\n  <slot />\n</template>\n","<!--\n  <DocumentGate>: renders its content only while this subtree has a ready\n  document, the structural way to say \"this UI is defined over a document\".\n  Workspace UI (toolbars, commands) lives outside it; document UI (the Stage,\n  panels) inside. A document that waits for its password, or failed, renders\n  the `#locked` or `#error` slot with it, or else `#fallback`. It decides\n  whether; <DocumentScope> decides which document.\n-->\n<script setup lang=\"ts\">\nimport type { DocumentInfo, FailedDocumentInfo, LockedDocumentInfo } from '@embedpdf/core';\nimport { useDocument } from './documents';\n\ndefineSlots<{\n  /** Rendered while the document is ready. */\n  default?(): unknown;\n  /** Shown while this subtree has no document: none is open, or it's still opening. */\n  fallback?(): unknown;\n  /** Shown while the document waits for its password; `#fallback` without it. */\n  locked?(props: { document: LockedDocumentInfo }): unknown;\n  /** Shown when the document couldn't be opened, with why; `#fallback` without it. */\n  error?(props: { document: FailedDocumentInfo }): unknown;\n}>();\n\nconst current = useDocument((document: DocumentInfo) => document);\n</script>\n\n<template>\n  <slot v-if=\"current.status === 'ready'\" />\n  <slot\n    v-else-if=\"current.status === 'locked' && $slots.locked\"\n    name=\"locked\"\n    :document=\"current as LockedDocumentInfo\"\n  />\n  <slot\n    v-else-if=\"current.status === 'error' && $slots.error\"\n    name=\"error\"\n    :document=\"current as FailedDocumentInfo\"\n  />\n  <slot v-else name=\"fallback\" />\n</template>\n","<!--\n  <DocumentScope :id>: binds its content to one document, for panes and\n  comparisons. The composables inside talk to that document instead of the\n  active one, and `useDocuments()` calls without an id use it.\n-->\n<script setup lang=\"ts\">\nimport { provideDocumentScope } from './kernel';\n\nconst props = defineProps<{\n  /** The document's id. */\n  id: string;\n}>();\n\ndefineSlots<{ default?(): unknown }>();\n\nprovideDocumentScope(() => props.id);\n</script>\n\n<template>\n  <slot />\n</template>\n"],"names":["_renderSlot","_createElementBlock","_Fragment","_unref","$slots"],"mappings":"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"}

package/dist/{DocumentScope.vue_vue_type_script_setup_true_lang-loLSm4lV.cjs → DocumentScope.vue_vue_type_script_setup_true_lang-czzeUzPl.cjs}

@@ -74,7 +74,8 @@ const _sfc_main$3 = /* @__PURE__ */ vue.defineComponent({
           engine,
           plugins: initial.plugins,
           settings: settingsOf(),
-          clock: web.browserClock()
+          clock: web.browserClock(),
+          printer: web.browserPrinter()
         });
       } catch (error) {
         bootError.value = error;
@@ -187,4 +188,4 @@ exports._sfc_main$1 = _sfc_main;
 exports._sfc_main$2 = _sfc_main$2;
 exports._sfc_main$3 = _sfc_main$3;
 exports.epdfTheme = epdfTheme;
-//# sourceMappingURL=DocumentScope.vue_vue_type_script_setup_true_lang-loLSm4lV.cjs.map
+//# sourceMappingURL=DocumentScope.vue_vue_type_script_setup_true_lang-czzeUzPl.cjs.map

package/dist/DocumentScope.vue_vue_type_script_setup_true_lang-czzeUzPl.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocumentScope.vue_vue_type_script_setup_true_lang-czzeUzPl.cjs","sources":["../src/theme.ts","../src/runtime/Viewer.vue","../src/runtime/KernelProvider.vue","../src/runtime/DocumentGate.vue","../src/runtime/DocumentScope.vue"],"sourcesContent":["/**\n * `epdfTheme()`: a theme written with setting names, as a style for the\n * element around your viewer. The variables and their lookup are framework-free\n * (`@embedpdf/web`); this only types the result as Vue's style.\n */\nimport type { CSSProperties } from 'vue';\nimport { epdfThemeVariables, type EpdfTheme } from '@embedpdf/web';\n\nexport type { EpdfTheme } from '@embedpdf/web';\n\n/**\n * The CSS variables of a theme, for a `:style` binding: `<div :style=\"epdfTheme({ accent })\">`.\n * Everything inside the element follows them, and a CSS variable wins over any setting.\n */\nexport function epdfTheme(theme: EpdfTheme): CSSProperties {\n  return epdfThemeVariables(theme) as CSSProperties;\n}\n","<!--\n  <Viewer>: owns the kernel. It creates and starts the kernel when it mounts\n  (never on the server) and destroys it when it unmounts; the components inside\n  read it through composables. `engine`, `plugins` and `initialDocuments` are\n  read once; `identity`, `scope`, `accent` and `page` are the viewer's settings\n  and follow the props.\n-->\n<script setup lang=\"ts\">\nimport { computed, onMounted, onUnmounted, shallowRef, toRaw, watch } from 'vue';\nimport { createKernel, isLocalEngine, viewerSettingsOf } from '@embedpdf/core';\nimport { browserClock, browserPrinter } from '@embedpdf/web';\nimport type {\n  AnyPlugin,\n  Engine,\n  EngineFactory,\n  Identity,\n  InitialDocument,\n  Kernel,\n  ViewerPageSettings,\n  ViewerSettings,\n} from '@embedpdf/core';\nimport { devWarn } from '../dev';\nimport { provideViewer } from './kernel';\n\nconst props = defineProps<{\n  /**\n   * The engine, as an instance or a function. An instance is borrowed: the\n   * viewer uses it and never destroys it (a module-level `localEngine()`\n   * shared by every viewer). A function is the viewer's own: it calls it when\n   * it mounts and destroys the engine when it unmounts. Read once.\n   */\n  engine: Engine | EngineFactory;\n  /** The plugins, created once next to the engine. Read once. */\n  plugins: AnyPlugin[];\n  /** Documents to open when the viewer starts, with optional tab names. Read once. */\n  initialDocuments?: InitialDocument[];\n  /**\n   * Who the user is, for every document opened without an `identity` of its\n   * own (which replaces this one). Documents opened after a change use the new\n   * value; open ones keep theirs. The local engine only: the cloud engine reads\n   * it from the document's token.\n   */\n  identity?: Identity;\n  /**\n   * What the user may do, as permissions, in every document opened without a\n   * `scope` of its own. Left out, they may do everything. Changes reach the\n   * documents opened after them, as `identity`.\n   */\n  scope?: readonly string[];\n  /** The color every part without a color of its own follows. CSS `--epdf-accent` wins over it. */\n  accent?: string;\n  /** How pages look: `background` before the picture arrives, and the `shadow` under each page. */\n  page?: Partial<ViewerPageSettings>;\n}>();\n\nconst emit = defineEmits<{\n  /**\n   * The kernel has started: before the default slot mounts and before\n   * `initialDocuments` open. The door for code outside Vue components\n   * (register commands, subscribe to events).\n   */\n  ready: [kernel: Kernel];\n}>();\n\ndefineSlots<{\n  /** The viewer's content, mounted once the kernel has started. */\n  default?(): unknown;\n  /** Shown while the kernel starts; the composables already work in it. */\n  fallback?(): unknown;\n  /** Shown when the kernel couldn't be created or started. Without it, a failed start shows nothing. */\n  error?(props: { error: unknown }): unknown;\n}>();\n\n/**\n * The viewer's settings as the props give them: a prop left out is its\n * default. Values reach the kernel raw: a reactive copy would be another object\n * to it, and can't be sent to a worker.\n */\nconst settingsOf = (): ViewerSettings =>\n  viewerSettingsOf({\n    identity: toRaw(props.identity),\n    scope: toRaw(props.scope),\n    accent: props.accent,\n    page: toRaw(props.page),\n  });\n\nconst kernel = shallowRef<Kernel | null>(null);\nconst phase = shallowRef<'booting' | 'ready' | 'error'>('booting');\nconst bootError = shallowRef<unknown>(null);\n// Goes up on every kernel change; every reader's computed depends on it.\nconst revision = shallowRef(0);\n\nprovideViewer({\n  get kernel() {\n    return kernel.value;\n  },\n  track: () => {\n    void revision.value;\n  },\n});\n\n// Read once: a changed engine or plugin list can't mean \"rebuild the\n// workspace\", which would drop every open document. Raw, because the kernel\n// knows a plugin's token by identity, and a reactive copy is another object.\nconst initial = {\n  engine: toRaw(props.engine),\n  plugins: toRaw(props.plugins),\n  initialDocuments: toRaw(props.initialDocuments),\n};\nwatch(\n  () => props.plugins,\n  () =>\n    devWarn(\n      'viewer-plugins-init-only',\n      '<Viewer> plugins are read once, when it mounts; a new list is ignored. ' +\n        'Create the list once, next to the engine, not inline in the template.',\n    ),\n);\nwatch(\n  () => props.engine,\n  (engine) => {\n    // An inline `:engine=\"() => localEngine()\"` is a new function on every\n    // render; only another engine instance is worth a warning.\n    if (typeof engine === 'function') return;\n    devWarn(\n      'viewer-engine-init-only',\n      '<Viewer> engine is read once, when it mounts; another engine is ignored. ' +\n        'To use another engine, mount a new <Viewer>, for example with a new `key`.',\n    );\n  },\n);\n\nlet teardown: (() => void) | null = null;\n\nonMounted(() => {\n  // A function is the viewer's own engine: called now, destroyed on unmount.\n  // An instance is borrowed. Construction is synchronous and inert either way,\n  // so warming up a local engine overlaps its boot with the plugins' start.\n  const ownsEngine = typeof initial.engine === 'function';\n  const engine: Engine = ownsEngine\n    ? (initial.engine as EngineFactory)()\n    : (initial.engine as Engine);\n  if (isLocalEngine(engine)) engine.warmup();\n  let created: Kernel;\n  try {\n    created = createKernel({\n      engine,\n      plugins: initial.plugins,\n      settings: settingsOf(),\n      clock: browserClock(),\n      printer: browserPrinter(),\n    });\n  } catch (error) {\n    // A plan or dependency error shows in the `error` slot.\n    bootError.value = error;\n    phase.value = 'error';\n    if (ownsEngine) void engine.destroy();\n    return;\n  }\n  const stopTracking = created.subscribe(() => {\n    revision.value += 1;\n  });\n  // The kernel is on the binding from now on, so the fallback can use it.\n  kernel.value = created;\n  let alive = true;\n  created.start().then(\n    () => {\n      if (!alive) return;\n      emit('ready', created);\n      phase.value = 'ready';\n      // Every tab appears at once, in order; the `active` entry (else the\n      // first) is selected; a failure shows as that document's status.\n      created.documents.openAll(initial.initialDocuments ?? []);\n    },\n    (error: unknown) => {\n      if (!alive) return;\n      bootError.value = error;\n      phase.value = 'error';\n    },\n  );\n  teardown = () => {\n    alive = false;\n    stopTracking();\n    // The kernel first (it closes every document's handle), then the engine\n    // the viewer owns.\n    void created.destroy().then(() => {\n      if (ownsEngine) void engine.destroy();\n    });\n  };\n});\n\n// After the content has unmounted, so its own cleanups still reach a live kernel.\nonUnmounted(() => teardown?.());\n\n// Props compare by value: an inline `:page=\"{ shadow: 'none' }\"` is a new\n// object on every render, and settings that didn't change change nothing.\nwatch(settingsOf, (settings) => kernel.value?.updateSettings(settings));\n\ndefineExpose({\n  /** The started kernel; null before it starts and after a failed start. */\n  kernel: computed(() => (phase.value === 'ready' ? kernel.value : null)),\n});\n</script>\n\n<template>\n  <slot v-if=\"phase === 'error'\" name=\"error\" :error=\"bootError\" />\n  <template v-else-if=\"kernel\">\n    <slot v-if=\"phase === 'ready'\" />\n    <slot v-else name=\"fallback\" />\n  </template>\n</template>\n","<!--\n  <KernelProvider :kernel>: gives its content a kernel someone else created and\n  owns, so every composable inside works against that kernel. The full viewer's\n  Vue wrapper puts the components it shows in the viewer inside one. It never\n  starts or destroys the kernel; <Viewer> is the component that owns one. The\n  kernel is read once: for another one, mount a new provider (a new `key`).\n-->\n<script setup lang=\"ts\">\nimport { onScopeDispose, shallowRef, toRaw, watch } from 'vue';\nimport type { Kernel } from '@embedpdf/core';\nimport { devWarn } from '../dev';\nimport { provideViewer } from './kernel';\n\nconst props = defineProps<{\n  /** The kernel, created and started by its owner. Read once. */\n  kernel: Kernel;\n}>();\n\ndefineSlots<{ default?(): unknown }>();\n\n// Read once, as `<Viewer>` reads its engine: the composables inside took this kernel when they\n// were set up, and a new one under them would leave them reading the old one. Raw, because a\n// reactive copy of the kernel is another object.\nconst kernel = toRaw(props.kernel);\nwatch(\n  () => props.kernel,\n  () =>\n    devWarn(\n      'kernel-provider-kernel-init-only',\n      '<KernelProvider> kernel is read once, when it mounts; another kernel is ignored. ' +\n        'To give its content another kernel, mount a new <KernelProvider>, for example with a new `key`.',\n    ),\n);\n\n// Goes up on every change the kernel announces; every reader's computed depends on it.\nconst revision = shallowRef(0);\nonScopeDispose(\n  kernel.subscribe(() => {\n    revision.value += 1;\n  }),\n);\n\nprovideViewer({\n  kernel,\n  track: () => {\n    void revision.value;\n  },\n});\n</script>\n\n<template>\n  <slot />\n</template>\n","<!--\n  <DocumentGate>: renders its content only while this subtree has a ready\n  document, the structural way to say \"this UI is defined over a document\".\n  Workspace UI (toolbars, commands) lives outside it; document UI (the Stage,\n  panels) inside. A document that waits for its password, or failed, renders\n  the `#locked` or `#error` slot with it, or else `#fallback`. It decides\n  whether; <DocumentScope> decides which document.\n-->\n<script setup lang=\"ts\">\nimport type { DocumentInfo, FailedDocumentInfo, LockedDocumentInfo } from '@embedpdf/core';\nimport { useDocument } from './documents';\n\ndefineSlots<{\n  /** Rendered while the document is ready. */\n  default?(): unknown;\n  /** Shown while this subtree has no document: none is open, or it's still opening. */\n  fallback?(): unknown;\n  /** Shown while the document waits for its password; `#fallback` without it. */\n  locked?(props: { document: LockedDocumentInfo }): unknown;\n  /** Shown when the document couldn't be opened, with why; `#fallback` without it. */\n  error?(props: { document: FailedDocumentInfo }): unknown;\n}>();\n\nconst current = useDocument((document: DocumentInfo) => document);\n</script>\n\n<template>\n  <slot v-if=\"current.status === 'ready'\" />\n  <slot\n    v-else-if=\"current.status === 'locked' && $slots.locked\"\n    name=\"locked\"\n    :document=\"current as LockedDocumentInfo\"\n  />\n  <slot\n    v-else-if=\"current.status === 'error' && $slots.error\"\n    name=\"error\"\n    :document=\"current as FailedDocumentInfo\"\n  />\n  <slot v-else name=\"fallback\" />\n</template>\n","<!--\n  <DocumentScope :id>: binds its content to one document, for panes and\n  comparisons. The composables inside talk to that document instead of the\n  active one, and `useDocuments()` calls without an id use it.\n-->\n<script setup lang=\"ts\">\nimport { provideDocumentScope } from './kernel';\n\nconst props = defineProps<{\n  /** The document's id. */\n  id: string;\n}>();\n\ndefineSlots<{ default?(): unknown }>();\n\nprovideDocumentScope(() => props.id);\n</script>\n\n<template>\n  <slot />\n</template>\n"],"names":["epdfThemeVariables","viewerSettingsOf","toRaw","shallowRef","provideViewer","watch","devWarn","onMounted","isLocalEngine","createKernel","browserClock","browserPrinter","onUnmounted","computed","_renderSlot","_createElementBlock","_Fragment","onScopeDispose","useDocument","_unref","$slots","provideDocumentScope"],"mappings":"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"}

package/dist/annotation/text-box.d.cts

@@ -22,6 +22,7 @@ export declare function provideLookScale(scale: Readonly<Ref<number>>): void;
  * ```
  *
  * `ref` goes on your element (render nothing inside it: the editor owns what's
- * in it); `style` and `editing` are refs.
+ * in it); `style` and `editing` are refs. `style` fills the element's parent at
+ * a legible size: draw the box's frame on the parent.
  */
 export declare function useRichTextEditor(annotation: MaybeRefOrGetter<Annotation>): RichTextEditor;

package/dist/annotation/text-box.d.ts

@@ -22,6 +22,7 @@ export declare function provideLookScale(scale: Readonly<Ref<number>>): void;
  * ```
  *
  * `ref` goes on your element (render nothing inside it: the editor owns what's
- * in it); `style` and `editing` are refs.
+ * in it); `style` and `editing` are refs. `style` fills the element's parent at
+ * a legible size: draw the box's frame on the parent.
  */
 export declare function useRichTextEditor(annotation: MaybeRefOrGetter<Annotation>): RichTextEditor;

package/dist/annotation.cjs

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const pluginAnnotation = require("@embedpdf/plugin-annotation");
-const composables = require("./composables-BuHvnUlo.cjs");
+const composables = require("./composables-Bi6QvJpj.cjs");
 exports.AnnotationDraftMenu = composables._sfc_main;
 exports.AnnotationLayer = composables._sfc_main$1;
 exports.AnnotationMenu = composables._sfc_main$2;

package/dist/annotation.js

@@ -1,5 +1,5 @@
 export * from "@embedpdf/plugin-annotation";
-import { _, a, b, c, f, u, d, e, g, h, i, j, k, l, m, n, o, p } from "./composables-CIkhKwAg.js";
+import { _, a, b, c, f, u, d, e, g, h, i, j, k, l, m, n, o, p } from "./composables-DK3lwh38.js";
 export {
   _ as AnnotationDraftMenu,
   a as AnnotationLayer,

package/dist/attachment.cjs

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const pluginAttachment = require("@embedpdf/plugin-attachment");
+const capabilities = require("./capabilities-DVNJmgy7.cjs");
+const state = require("./state-M22NDJQo.cjs");
+function useAttachment() {
+  return capabilities.useCapability(pluginAttachment.AttachmentToken);
+}
+const useAttachmentState = state.stateComposable(pluginAttachment.attachmentState);
+function useAttachmentEvent(select, handler) {
+  capabilities.useCapabilityEvent(pluginAttachment.AttachmentToken, select, handler);
+}
+exports.useAttachment = useAttachment;
+exports.useAttachmentEvent = useAttachmentEvent;
+exports.useAttachmentState = useAttachmentState;
+Object.keys(pluginAttachment).forEach((k) => {
+  if (k !== "default" && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+    enumerable: true,
+    get: () => pluginAttachment[k]
+  });
+});
+//# sourceMappingURL=attachment.cjs.map

package/dist/attachment.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment.cjs","sources":["../src/attachment.ts"],"sourcesContent":["/**\n * @embedpdf/vue/attachment: the Vue view of `@embedpdf/plugin-attachment`.\n * Reading the state reads the document's attachments; the plugin keeps them\n * live off the document's event stream, lists the pages' files with them, and\n * shows your own adds and removes at once.\n *\n *   const attachment = useAttachment();\n *   const { files, canAdd } = useAttachmentState();\n *   const { bytes, name, mimeType } = await attachment.download(file);\n */\n\n// One line per feature: registration travels with the UI.\nexport * from '@embedpdf/plugin-attachment';\nimport type { EventHook } from '@embedpdf/core';\nimport { AttachmentToken, attachmentState } from '@embedpdf/plugin-attachment';\nimport type { AttachmentCapability } from '@embedpdf/plugin-attachment';\n\nimport { useCapability, useCapabilityEvent } from './runtime/capabilities';\nimport { stateComposable } from './state';\n\n/**\n * The attachment API (add, remove, download, reveal) of the nearest\n * `<DocumentScope>`'s document, else the active one. The object never\n * changes; outside a document every method throws `not-ready`.\n */\nexport function useAttachment(): AttachmentCapability {\n  return useCapability(AttachmentToken);\n}\n\n/**\n * The files the document carries, the load state, and whether you may add and\n * save files, as refs (the page's State table, declared once in\n * `attachmentState`). With a selector, one ref for the value it picks, which\n * updates only when that value changes.\n */\nexport const useAttachmentState = stateComposable(attachmentState);\n\n/** Subscribe to one attachment event while the component lives: `useAttachmentEvent((attachment) => attachment.onChanged, handler)`. */\nexport function useAttachmentEvent<Event>(\n  select: (attachment: AttachmentCapability) => EventHook<Event>,\n  handler: (event: Event) => void,\n): void {\n  useCapabilityEvent(AttachmentToken, select, handler);\n}\n"],"names":["useCapability","AttachmentToken","stateComposable","attachmentState","useCapabilityEvent"],"mappings":";;;;;AAyBO,SAAS,gBAAsC;AACpD,SAAOA,aAAAA,cAAcC,iBAAAA,eAAe;AACtC;AAQO,MAAM,qBAAqBC,MAAAA,gBAAgBC,iBAAAA,eAAe;AAG1D,SAAS,mBACd,QACA,SACM;AACNC,kCAAmBH,iBAAAA,iBAAiB,QAAQ,OAAO;AACrD;;;;;;;;;;"}

package/dist/attachment.d.cts

@@ -0,0 +1,34 @@
+/**
+ * @embedpdf/vue/attachment: the Vue view of `@embedpdf/plugin-attachment`.
+ * Reading the state reads the document's attachments; the plugin keeps them
+ * live off the document's event stream, lists the pages' files with them, and
+ * shows your own adds and removes at once.
+ *
+ *   const attachment = useAttachment();
+ *   const { files, canAdd } = useAttachmentState();
+ *   const { bytes, name, mimeType } = await attachment.download(file);
+ */
+export * from '@embedpdf/plugin-attachment';
+import type { EventHook } from '@embedpdf/core';
+import type { AttachmentCapability } from '@embedpdf/plugin-attachment';
+/**
+ * The attachment API (add, remove, download, reveal) of the nearest
+ * `<DocumentScope>`'s document, else the active one. The object never
+ * changes; outside a document every method throws `not-ready`.
+ */
+export declare function useAttachment(): AttachmentCapability;
+/**
+ * The files the document carries, the load state, and whether you may add and
+ * save files, as refs (the page's State table, declared once in
+ * `attachmentState`). With a selector, one ref for the value it picks, which
+ * updates only when that value changes.
+ */
+export declare const useAttachmentState: import("./state.cjs").StateComposable<{
+    files: readonly import("@embedpdf/plugin-attachment").AttachedFile[];
+    selected: readonly import("@embedpdf/plugin-attachment").AttachedFile[];
+    status: import("@embedpdf/core").ResourceStatus;
+    canAdd: boolean;
+    canDownload: boolean;
+}>;
+/** Subscribe to one attachment event while the component lives: `useAttachmentEvent((attachment) => attachment.onChanged, handler)`. */
+export declare function useAttachmentEvent<Event>(select: (attachment: AttachmentCapability) => EventHook<Event>, handler: (event: Event) => void): void;

package/dist/attachment.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @embedpdf/vue/attachment: the Vue view of `@embedpdf/plugin-attachment`.
+ * Reading the state reads the document's attachments; the plugin keeps them
+ * live off the document's event stream, lists the pages' files with them, and
+ * shows your own adds and removes at once.
+ *
+ *   const attachment = useAttachment();
+ *   const { files, canAdd } = useAttachmentState();
+ *   const { bytes, name, mimeType } = await attachment.download(file);
+ */
+export * from '@embedpdf/plugin-attachment';
+import type { EventHook } from '@embedpdf/core';
+import type { AttachmentCapability } from '@embedpdf/plugin-attachment';
+/**
+ * The attachment API (add, remove, download, reveal) of the nearest
+ * `<DocumentScope>`'s document, else the active one. The object never
+ * changes; outside a document every method throws `not-ready`.
+ */
+export declare function useAttachment(): AttachmentCapability;
+/**
+ * The files the document carries, the load state, and whether you may add and
+ * save files, as refs (the page's State table, declared once in
+ * `attachmentState`). With a selector, one ref for the value it picks, which
+ * updates only when that value changes.
+ */
+export declare const useAttachmentState: import("./state.js").StateComposable<{
+    files: readonly import("@embedpdf/plugin-attachment").AttachedFile[];
+    selected: readonly import("@embedpdf/plugin-attachment").AttachedFile[];
+    status: import("@embedpdf/core").ResourceStatus;
+    canAdd: boolean;
+    canDownload: boolean;
+}>;
+/** Subscribe to one attachment event while the component lives: `useAttachmentEvent((attachment) => attachment.onChanged, handler)`. */
+export declare function useAttachmentEvent<Event>(select: (attachment: AttachmentCapability) => EventHook<Event>, handler: (event: Event) => void): void;

package/dist/attachment.js

@@ -0,0 +1,17 @@
+import { AttachmentToken, attachmentState } from "@embedpdf/plugin-attachment";
+export * from "@embedpdf/plugin-attachment";
+import { a as useCapability, b as useCapabilityEvent } from "./capabilities-C7YzgPCX.js";
+import { a as stateComposable } from "./state-DZg8q3v6.js";
+function useAttachment() {
+  return useCapability(AttachmentToken);
+}
+const useAttachmentState = stateComposable(attachmentState);
+function useAttachmentEvent(select, handler) {
+  useCapabilityEvent(AttachmentToken, select, handler);
+}
+export {
+  useAttachment,
+  useAttachmentEvent,
+  useAttachmentState
+};
+//# sourceMappingURL=attachment.js.map

package/dist/attachment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment.js","sources":["../src/attachment.ts"],"sourcesContent":["/**\n * @embedpdf/vue/attachment: the Vue view of `@embedpdf/plugin-attachment`.\n * Reading the state reads the document's attachments; the plugin keeps them\n * live off the document's event stream, lists the pages' files with them, and\n * shows your own adds and removes at once.\n *\n *   const attachment = useAttachment();\n *   const { files, canAdd } = useAttachmentState();\n *   const { bytes, name, mimeType } = await attachment.download(file);\n */\n\n// One line per feature: registration travels with the UI.\nexport * from '@embedpdf/plugin-attachment';\nimport type { EventHook } from '@embedpdf/core';\nimport { AttachmentToken, attachmentState } from '@embedpdf/plugin-attachment';\nimport type { AttachmentCapability } from '@embedpdf/plugin-attachment';\n\nimport { useCapability, useCapabilityEvent } from './runtime/capabilities';\nimport { stateComposable } from './state';\n\n/**\n * The attachment API (add, remove, download, reveal) of the nearest\n * `<DocumentScope>`'s document, else the active one. The object never\n * changes; outside a document every method throws `not-ready`.\n */\nexport function useAttachment(): AttachmentCapability {\n  return useCapability(AttachmentToken);\n}\n\n/**\n * The files the document carries, the load state, and whether you may add and\n * save files, as refs (the page's State table, declared once in\n * `attachmentState`). With a selector, one ref for the value it picks, which\n * updates only when that value changes.\n */\nexport const useAttachmentState = stateComposable(attachmentState);\n\n/** Subscribe to one attachment event while the component lives: `useAttachmentEvent((attachment) => attachment.onChanged, handler)`. */\nexport function useAttachmentEvent<Event>(\n  select: (attachment: AttachmentCapability) => EventHook<Event>,\n  handler: (event: Event) => void,\n): void {\n  useCapabilityEvent(AttachmentToken, select, handler);\n}\n"],"names":[],"mappings":";;;;AAyBO,SAAS,gBAAsC;AACpD,SAAO,cAAc,eAAe;AACtC;AAQO,MAAM,qBAAqB,gBAAgB,eAAe;AAG1D,SAAS,mBACd,QACA,SACM;AACN,qBAAmB,iBAAiB,QAAQ,OAAO;AACrD;"}

package/dist/{composables-BuHvnUlo.cjs → composables-Bi6QvJpj.cjs}

@@ -245,9 +245,11 @@ function useRichTextEditor(annotation) {
   const item = capabilities.useOptionalSelector(
     host.AnnotationToken,
     (host2) => {
-      const key = core.annotationKey(vue.toValue(annotation).ref);
       const { transform } = page$1.value;
-      return host2.listTextItems(page$1.value.ref, { zoom: transform.zoom, rotation: transform.rotation }).find((text) => text.ref !== null && core.annotationKey(text.ref) === key) ?? null;
+      return host2.getTextItem(vue.toValue(annotation).ref, {
+        zoom: transform.zoom,
+        rotation: transform.rotation
+      });
     },
     null
   );
@@ -255,14 +257,14 @@ function useRichTextEditor(annotation) {
   const scale = vue.computed(
     () => web.textBoxEditorScaleOf(item.value, page$1.value.transform, lookScale.value)
   );
-  const element = useTextBoxEditor(item, scale);
+  const own = vue.computed(() => item.value ? web.ownTextBoxOf(item.value, scale.value) : null);
+  const element = useTextBoxEditor(item, () => {
+    var _a;
+    return ((_a = own.value) == null ? void 0 : _a.scale) ?? scale.value;
+  });
   const style = vue.computed(() => {
-    const text = item.value;
-    if (!text) return NO_STYLE;
-    return {
-      ...web.textBoxStyleOf(text.css, scale.value),
-      ...text.editing ? { pointerEvents: "auto" } : {}
-    };
+    var _a;
+    return ((_a = own.value) == null ? void 0 : _a.style) ?? NO_STYLE;
   });
   return {
     ref: (target) => {
@@ -338,46 +340,19 @@ const _sfc_main$7 = /* @__PURE__ */ vue.defineComponent({
   },
   setup(__props) {
     const props = __props;
-    const plate = vue.computed(() => web.textPlateInPixels(props.item, props.page.transform));
-    const element = useTextBoxEditor(
-      () => props.item,
-      () => plate.value.scale
-    );
     const chrome = useAnnotationSettings((settings) => settings.chrome);
     const accent = documents.useViewerSettings((settings) => settings.accent);
     const outline = vue.computed(() => web.annotationChromePaint(chrome.value, accent.value).textOutline);
-    const style = vue.computed(() => {
-      const { item } = props;
-      const { left, top, width, height, scale } = plate.value;
-      return {
-        position: "absolute",
-        left: `${left}px`,
-        top: `${top}px`,
-        width: `${width}px`,
-        // Fixed to the plate: the box never grows with its text; it scrolls while
-        // typing and clips otherwise, where the baked appearance clips.
-        height: `${height}px`,
-        ...web.textBoxStyleOf(item.css, scale),
-        boxSizing: "border-box",
-        // The box's fill and border are the vector scene's, under this layer.
-        background: "transparent",
-        whiteSpace: "pre-wrap",
-        overflowWrap: "break-word",
-        overflowY: item.editing ? "auto" : "hidden",
-        overflowX: "hidden",
-        outline: item.editing ? `1px solid ${outline.value}` : "none",
-        cursor: item.editing ? "text" : "default",
-        // A plain text box turns about its centre, as the baked appearance does.
-        ...item.rot ? { transform: `rotate(${item.rot}deg)`, transformOrigin: "center" } : {},
-        // Not typing: clicks fall through to the shapes (select, move, resize).
-        pointerEvents: item.editing ? "auto" : "none"
-      };
-    });
+    const box = vue.computed(() => web.freeTextBoxOf(props.item, props.page.transform, outline.value));
+    const element = useTextBoxEditor(
+      () => props.item,
+      () => box.value.scale
+    );
     return (_ctx, _cache) => {
       return vue.openBlock(), vue.createElementBlock("div", {
         ref_key: "element",
         ref: element,
-        style: vue.normalizeStyle(style.value)
+        style: vue.normalizeStyle(box.value.style)
       }, null, 4);
     };
   }
@@ -1000,4 +975,4 @@ exports.useCommentThreads = useCommentThreads;
 exports.useComments = useComments;
 exports.useFilePickerProvider = useFilePickerProvider;
 exports.useRichTextEditor = useRichTextEditor;
-//# sourceMappingURL=composables-BuHvnUlo.cjs.map
+//# sourceMappingURL=composables-Bi6QvJpj.cjs.map