From a5bb324b5dcc534f71fc10711376b7d9273ae0ac Mon Sep 17 00:00:00 2001
From: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Date: Mon, 2 Mar 2026 14:10:06 -0300
Subject: [PATCH 1/2] feat: add accessibility support with aria attributes and
 keyboard navigation

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
---
 src/components/PDFElements.vue | 45 ++++++++++++++++++++++++++++++++++
 1 file changed, 45 insertions(+)

diff --git a/src/components/PDFElements.vue b/src/components/PDFElements.vue
index 4035d66..949edbf 100644
--- a/src/components/PDFElements.vue
+++ b/src/components/PDFElements.vue
@@ -23,14 +23,19 @@ SPDX-License-Identifier: AGPL-3.0-or-later
               />
                 <div
                 class="overlay"
+                :role="isAddingMode ? 'button' : undefined"
+                :tabindex="isAddingMode ? 0 : -1"
+                :aria-label="getOverlayAriaLabel(docIndex, pIndex)"
                 @mousemove="handleMouseMove"
                 @touchmove="handleMouseMove"
                 @click="handleOverlayClick(docIndex, pIndex, $event)"
                 @touchend="handleOverlayClick(docIndex, pIndex, $event)"
+                @keydown="handleOverlayKeyDown(docIndex, pIndex, $event)"
               >
                 <div
                   v-if="isAddingMode && previewPageDocIndex === docIndex && previewPageIndex === pIndex && previewElement && previewVisible"
                   class="preview-element"
+                  aria-hidden="true"
                   :style="{
                     left: `${previewPosition.x * previewScale.x}px`,
                     top: `${previewPosition.y * previewScale.y}px`,
@@ -217,6 +222,10 @@ export default defineComponent({
       type: Boolean,
       default: false,
     },
+    pageAriaLabel: {
+      type: Function as PropType<(info: { docIndex: number; docName: string; totalDocs: number; pageNumber: number; totalPages: number; isAddingMode: boolean }) => string>,
+      default: null,
+    },
     pdfjsOptions: {
       type: Object as PropType<Record<string, unknown>>,
       default: () => ({}),
@@ -730,6 +739,42 @@ export default defineComponent({
       }
     },
 
+    getOverlayAriaLabel(docIndex, pageIndex) {
+      const doc = this.pdfDocuments?.[docIndex]
+      const docName = doc?.name ?? `Document ${docIndex + 1}`
+      const totalDocs = this.pdfDocuments?.length ?? 1
+      const totalPages = doc?.numPages ?? 0
+      const pageNumber = pageIndex + 1
+      if (this.pageAriaLabel) {
+        return this.pageAriaLabel({ docIndex, docName, totalDocs, pageNumber, totalPages, isAddingMode: this.isAddingMode })
+      }
+      const docPrefix = totalDocs > 1 ? `Document ${docIndex + 1} of ${totalDocs} (${docName}), ` : ''
+      if (this.isAddingMode) {
+        return `${docPrefix}Page ${pageNumber} of ${totalPages}. Press Enter or Space to place here.`
+      }
+      return `${docPrefix}Page ${pageNumber} of ${totalPages}.`
+    },
+
+    handleOverlayKeyDown(docIndex, pageIndex, event) {
+      if (!this.isAddingMode || !this.previewElement) return
+      if (event.key !== 'Enter' && event.key !== ' ') return
+      event.preventDefault()
+
+      const pageWidth = this.getPageWidth(docIndex, pageIndex)
+      const pageHeight = this.getPageHeight(docIndex, pageIndex)
+      const scale = this.getDisplayedPageScale(docIndex, pageIndex) || 1
+
+      this.previewPageDocIndex = docIndex
+      this.previewPageIndex = pageIndex
+      this.previewScale = { x: scale, y: scale }
+      this.previewPosition = {
+        x: Math.round((pageWidth - this.previewElement.width) / 2),
+        y: Math.round((pageHeight - this.previewElement.height) / 2),
+      }
+      this.previewVisible = true
+      this.finishAdding()
+    },
+
     handleWheel(event) {
       if (!event.ctrlKey) return
       event.preventDefault()

From 60f6f50cd4fcbbceea02d7c168e8aef24b91a3fa Mon Sep 17 00:00:00 2001
From: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Date: Mon, 2 Mar 2026 14:10:16 -0300
Subject: [PATCH 2/2] chore: bump version to 1.1.0

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index de85f3d..723bdb3 100644
--- a/package.json
+++ b/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@libresign/pdf-elements",
   "description": "PDF viewer with draggable and resizable element overlays for Vue 3",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "author": "LibreCode <contact@librecode.coop>",
   "private": false,
   "main": "dist/index.js",