From 6f1d5b736dce6c5beb71c9d1b5ec810e653a45bf Mon Sep 17 00:00:00 2001
From: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Date: Sun, 5 Apr 2026 19:44:00 -0300
Subject: [PATCH 1/3] feat: add themeable action toolbar hooks

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

diff --git a/src/components/DraggableElement.vue b/src/components/DraggableElement.vue
index 549a4b4..ec9ca8c 100644
--- a/src/components/DraggableElement.vue
+++ b/src/components/DraggableElement.vue
@@ -7,16 +7,36 @@ SPDX-License-Identifier: AGPL-3.0-or-later
   <div class="draggable-wrapper">
     <div
       v-if="isSelected && !isBeingDraggedGlobally && showSelectionUi && showDefaultActions"
-      class="actions-toolbar"
+      class="actions-toolbar pdf-elements-actions-toolbar"
       :style="toolbarStyle"
     >
-      <slot name="actions" :object="object" :onDelete="onDelete" :onDuplicate="onDuplicate">
-        <button class="action-btn" type="button" title="Duplicate" @click.stop="onDuplicate">
+      <slot
+        name="actions"
+        :object="object"
+        :onDelete="onDelete"
+        :onDuplicate="onDuplicate"
+        :toolbarClass="toolbarClass"
+        :actionClass="actionClass"
+        :actionAttrs="actionAttrs"
+      >
+        <button
+          class="action-btn pdf-elements-action-btn"
+          type="button"
+          title="Duplicate"
+          v-bind="actionAttrs"
+          @click.stop="onDuplicate"
+        >
           <svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor">
             <path d="M16 1H6a2 2 0 0 0-2 2v12h2V3h10V1zm3 4H10a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h9a2 2 0 0 0 2-2V7a2 2 0 0 0-2-2zm0 16H10V7h9v14z"/>
           </svg>
         </button>
-        <button class="action-btn" type="button" title="Delete" @click.stop="onDelete">
+        <button
+          class="action-btn pdf-elements-action-btn"
+          type="button"
+          title="Delete"
+          v-bind="actionAttrs"
+          @click.stop="onDelete"
+        >
           <svg width="16" height="16" viewBox="0 0 16 16" fill="currentColor">
             <path d="M6.5 1h3a.5.5 0 0 1 .5.5v1H6v-1a.5.5 0 0 1 .5-.5ZM11 2.5v-1A1.5 1.5 0 0 0 9.5 0h-3A1.5 1.5 0 0 0 5 1.5v1H2.5a.5.5 0 0 0 0 1h.5v10.5A1.5 1.5 0 0 0 4.5 15h7a1.5 1.5 0 0 0 1.5-1.5V3.5h.5a.5.5 0 0 0 0-1H11Zm1 1v10.5a.5.5 0 0 1-.5.5h-7a.5.5 0 0 1-.5-.5V3.5h8Z"/>
           </svg>
@@ -223,6 +243,17 @@ export default defineComponent({
         pointerEvents: 'none',
       } as CSSProperties
     },
+    toolbarClass() {
+      return 'pdf-elements-actions-toolbar'
+    },
+    actionClass() {
+      return 'pdf-elements-action-btn'
+    },
+    actionAttrs() {
+      return {
+        'data-pdf-elements-action': 'true',
+      }
+    },
   },
   mounted() {
     this.handleClickOutside = this.handleClickOutside.bind(this)
@@ -487,28 +518,48 @@ export default defineComponent({
 .actions-toolbar {
   position: absolute;
   display: flex;
-  gap: 4px;
-  background: #1f2937;
-  border-radius: 6px;
-  padding: 6px 8px;
-  box-shadow: 0 4px 12px -2px rgba(0, 0, 0, 0.15), 0 2px 6px -2px rgba(0, 0, 0, 0.1);
+  gap: var(--pdf-elements-toolbar-gap, 4px);
+  background: var(--pdf-elements-toolbar-background, var(--color-main-background, #ffffff));
+  color: var(--pdf-elements-toolbar-color, var(--color-main-text, #222222));
+  border: 1px solid var(--pdf-elements-toolbar-border-color, var(--color-border, #d1d5db));
+  border-radius: var(--pdf-elements-toolbar-border-radius, 6px);
+  padding: var(--pdf-elements-toolbar-padding, 6px 8px);
+  box-shadow: var(--pdf-elements-toolbar-shadow, 0 4px 12px -2px rgba(0, 0, 0, 0.15), 0 2px 6px -2px rgba(0, 0, 0, 0.1));
   z-index: 5;
   white-space: nowrap;
 }
 .action-btn {
-  border: none;
-  background: transparent;
-  color: #ffffff;
-  padding: 4px;
-  border-radius: 4px;
+  border: var(--pdf-elements-action-btn-border, none);
+  background: var(--pdf-elements-action-btn-background, transparent);
+  color: var(--pdf-elements-action-btn-color, currentColor);
+  padding: var(--pdf-elements-action-btn-padding, 4px);
+  border-radius: var(--pdf-elements-action-btn-radius, 4px);
+  min-height: var(--pdf-elements-action-btn-min-height, auto);
+  min-width: var(--pdf-elements-action-btn-min-width, auto);
   cursor: pointer;
   display: flex;
   align-items: center;
   justify-content: center;
-  transition: background 120ms ease;
+  transition: background-color 120ms ease;
 }
 .action-btn:hover {
-  background: rgba(255, 255, 255, 0.1);
+  background: var(--pdf-elements-action-btn-hover-background, var(--color-background-hover, rgba(0, 0, 0, 0.08)));
+}
+
+.actions-toolbar :deep(.pdf-elements-action-btn),
+.actions-toolbar :deep([data-pdf-elements-action]) {
+  border: var(--pdf-elements-action-btn-border, none);
+  background: var(--pdf-elements-action-btn-background, transparent);
+  color: var(--pdf-elements-action-btn-color, currentColor);
+  border-radius: var(--pdf-elements-action-btn-radius, 4px);
+  min-height: var(--pdf-elements-action-btn-min-height, auto);
+  min-width: var(--pdf-elements-action-btn-min-width, auto);
+  box-shadow: var(--pdf-elements-action-btn-shadow, none);
+}
+
+.actions-toolbar :deep(.pdf-elements-action-btn:hover),
+.actions-toolbar :deep([data-pdf-elements-action]:hover) {
+  background: var(--pdf-elements-action-btn-hover-background, var(--color-background-hover, rgba(0, 0, 0, 0.08)));
 }
 .draggable-element {
   position: absolute;

From 00bde200b0846ce3eaf9073fa0294f991fc13d33 Mon Sep 17 00:00:00 2001
From: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Date: Sun, 5 Apr 2026 19:44:01 -0300
Subject: [PATCH 2/3] feat: forward full action slot props

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

diff --git a/src/components/PDFElements.vue b/src/components/PDFElements.vue
index 6e06811..1dc09eb 100644
--- a/src/components/PDFElements.vue
+++ b/src/components/PDFElements.vue
@@ -97,12 +97,7 @@ SPDX-License-Identifier: AGPL-3.0-or-later
                     </slot>
                   </template>
                   <template #actions="slotProps">
-                    <slot
-                      name="actions"
-                      :object="slotProps.object"
-                      :onDelete="slotProps.onDelete"
-                      :onDuplicate="slotProps.onDuplicate"
-                    />
+                    <slot name="actions" v-bind="slotProps" />
                   </template>
                 </DraggableElement>
               </div>

From a662b5d483b6c7d4a21566fc8190139f6ec65da5 Mon Sep 17 00:00:00 2001
From: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Date: Sun, 5 Apr 2026 19:44:02 -0300
Subject: [PATCH 3/3] docs: document action slot hooks and theme variables

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
---
 README.md | 52 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 52 insertions(+)

diff --git a/README.md b/README.md
index d47901c..b69aa8a 100644
--- a/README.md
+++ b/README.md
@@ -69,3 +69,55 @@ Example:
 - `element-{type}` - Custom element rendering (e.g., `element-signature`)
 - `custom` - Fallback for elements without specific type
 - `actions` - Custom action buttons
+
+#### `actions` slot props
+
+The `actions` slot receives:
+
+- `object`
+- `onDelete`
+- `onDuplicate`
+- `toolbarClass` (`pdf-elements-actions-toolbar`)
+- `actionClass` (`pdf-elements-action-btn`)
+- `actionAttrs` (`{ 'data-pdf-elements-action': 'true' }`)
+
+Use these hooks to style third-party button components consistently (for example, Nextcloud `NcButton`) without relying on internal scoped selectors.
+
+Example:
+
+```vue
+<template #actions="slotProps">
+	<NcButton
+		:class="slotProps.actionClass"
+		v-bind="slotProps.actionAttrs"
+		type="button"
+		variant="tertiary"
+		@click.stop="slotProps.onDuplicate"
+	>
+		Duplicate
+	</NcButton>
+</template>
+```
+
+### Theme variables
+
+Action toolbar and action buttons can be themed via CSS variables and follow host theme tokens by default.
+
+| Variable | Description |
+|---|---|
+| `--pdf-elements-toolbar-gap` | Toolbar button gap |
+| `--pdf-elements-toolbar-padding` | Toolbar padding |
+| `--pdf-elements-toolbar-background` | Toolbar background color |
+| `--pdf-elements-toolbar-color` | Toolbar text/icon color |
+| `--pdf-elements-toolbar-border-color` | Toolbar border color |
+| `--pdf-elements-toolbar-border-radius` | Toolbar border radius |
+| `--pdf-elements-toolbar-shadow` | Toolbar shadow |
+| `--pdf-elements-action-btn-border` | Action button border |
+| `--pdf-elements-action-btn-background` | Action button background |
+| `--pdf-elements-action-btn-color` | Action button text/icon color |
+| `--pdf-elements-action-btn-padding` | Action button padding |
+| `--pdf-elements-action-btn-radius` | Action button border radius |
+| `--pdf-elements-action-btn-min-height` | Action button min height |
+| `--pdf-elements-action-btn-min-width` | Action button min width |
+| `--pdf-elements-action-btn-shadow` | Action button shadow |
+| `--pdf-elements-action-btn-hover-background` | Action button hover background |