@vue-pdf-viewer/shared 1.4.0 → 1.5.0-rc.1

package/dist/types.d.ts

@@ -308,3 +308,63 @@ export interface DeletedAnnotationData {
 export interface AnnotationPluginApi {
     exportToPdf: (annotations: Annotation[], deletedAnnotations?: DeletedAnnotationData[] | string[]) => Promise<Uint8Array | null>;
 }
+/**
+ * Programmatic API for text selection annotation tools (highlight, underline, strikethrough).
+ * Exposed on the VPdfViewer instance as `textSelectionControl`.
+ * Undefined when the annotation plugin is not loaded.
+ */
+export interface AnnotationTextSelectionControl {
+    /** Whether the highlight tool is currently active */
+    readonly isHighlightActive: boolean;
+    /** Whether the underline tool is currently active */
+    readonly isUnderlineActive: boolean;
+    /** Whether the strikethrough tool is currently active */
+    readonly isStrikethroughActive: boolean;
+    /** Current highlight color as CSS hex string, or null if not set */
+    readonly highlightColor: string | null;
+    /** Current underline color as CSS hex string, or null if not set */
+    readonly underlineColor: string | null;
+    /** Current strikethrough color as CSS hex string, or null if not set */
+    readonly strikethroughColor: string | null;
+    /** Toggle highlight tool. Activating deactivates other text selection tools. */
+    toggleHighlight(): void;
+    /** Toggle underline tool. Activating deactivates other text selection tools. */
+    toggleUnderline(): void;
+    /** Toggle strikethrough tool. Activating deactivates other text selection tools. */
+    toggleStrikethrough(): void;
+    /** Deactivate all text selection tools. */
+    deactivateAll(): void;
+    /** Set highlight color. Takes effect on the next annotation created. */
+    setHighlightColor(color: string): void;
+    /** Set underline color. Takes effect on the next annotation created. */
+    setUnderlineColor(color: string): void;
+    /** Set strikethrough color. Takes effect on the next annotation created. */
+    setStrikethroughColor(color: string): void;
+    /** Set the highlight color palette shown in the popover. Accepts LabelValuePair[] or string[] (1–12 colors). */
+    setHighlightColorPalette(colors: AnnotationHighlightColors): void;
+    /** Set the underline color palette shown in the popover. Accepts LabelValuePair[] or string[] (1–12 colors). */
+    setUnderlineColorPalette(colors: AnnotationUnderlineColors): void;
+    /** Set the strikethrough color palette shown in the popover. Accepts LabelValuePair[] or string[] (1–12 colors). */
+    setStrikethroughColorPalette(colors: AnnotationStrikethroughColors): void;
+}
+/**
+ * Programmatic API for the free text annotation tool.
+ * Exposed on the VPdfViewer instance as `freeTextControl`.
+ * Undefined when the annotation plugin is not loaded.
+ */
+export interface AnnotationFreeTextControl {
+    /** Whether the free text annotation tool is currently active */
+    readonly isActive: boolean;
+    /** Current default font color for new free text annotations (CSS hex string, e.g. '#000000'), or null if not set */
+    readonly fontColor: string | null;
+    /** Current default font size for new free text annotations (in points), or null if not set */
+    readonly fontSize: number | null;
+    /** Activate the free text tool. Deactivates all text-selection annotation tools. */
+    activate(): void;
+    /** Deactivate the free text tool. No-op if already inactive. */
+    deactivate(): void;
+    /** Set the default font color for new annotations (CSS hex string). Takes effect on the next annotation created. */
+    setFontColor(color: string): void;
+    /** Set the default font size for new annotations (in points). Takes effect on the next annotation created. */
+    setFontSize(size: number): void;
+}

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@vue-pdf-viewer/shared",
 	"private": false,
-	"version": "1.4.0",
+	"version": "1.5.0-rc.1",
 	"type": "module",
 	"main": "./dist/index.js",
 	"module": "./dist/index.js",