kviewer 0.2.1 → 0.2.2

package/dist/runtime/composables/useViewerState.js

@@ -41,7 +41,12 @@ export function provideViewerState() {
   function setFitMode(mode) {
     fitMode.value = mode;
   }
+  let _applyScaleFn = null;
   function setScale(value) {
+    if (_applyScaleFn) {
+      _applyScaleFn(value);
+      return;
+    }
     fitMode.value = "custom";
     scale.value = value;
   }
@@ -212,6 +217,9 @@ export function provideViewerState() {
     },
     setDownloadPdfFn(fn) {
       _downloadPdfFn = fn;
+    },
+    setApplyScaleFn(fn) {
+      _applyScaleFn = fn;
     }
   };
 }

package/dist/runtime/i18n/messages.d.ts

@@ -0,0 +1,252 @@
+/**
+ * Built-in UI message catalog.
+ *
+ * kviewer is consumed both as a Nuxt module (wrench) and through the
+ * iframe embed bridge by non-Nuxt hosts (esign/React), so it cannot
+ * depend on a host i18n library. The catalog is intentionally tiny:
+ * locale comes from the Viewer `locale` prop (or the module option),
+ * and hosts may override individual strings via the `messages` prop.
+ */
+export declare const messages: {
+    readonly en: {
+        readonly cancel: "Cancel";
+        readonly ok: "OK";
+        readonly save: "Save";
+        readonly clear: "Clear";
+        readonly delete: "Delete";
+        readonly download: "Download";
+        readonly search: "Search";
+        readonly marqueeSelect: "Marquee select";
+        readonly eraser: "Eraser";
+        readonly color: "Color";
+        readonly editText: "Edit text";
+        readonly strokeWidth: "Stroke width";
+        readonly decreaseStrokeWidth: "Decrease stroke width";
+        readonly increaseStrokeWidth: "Increase stroke width";
+        readonly noProperties: "No properties";
+        readonly detectFormFields: "Detect form fields";
+        readonly disableFormFieldDetection: "Disable form field detection";
+        readonly fitWidth: "Fit width";
+        readonly fitPage: "Fit page";
+        readonly stamp: "Stamp";
+        readonly signature: "Signature";
+        readonly searchPlaceholder: "Find in document...";
+        readonly previousMatch: "Previous match";
+        readonly nextMatch: "Next match";
+        readonly matchCase: "Match case";
+        readonly wholeWord: "Whole word";
+        readonly highlightAll: "Highlight all";
+        readonly closeSearch: "Close search";
+        readonly noResults: "No results";
+        readonly typeToSearch: "Type to search";
+        readonly freeText: "Free text";
+        readonly startTyping: "Start typing...";
+        readonly drawSignature: "Draw signature";
+        readonly noSavedSignatures: "No saved signatures";
+        readonly addSignature: "Add signature";
+        readonly selectedCount: "{count} selected";
+        readonly pageTransition: "Page transition";
+        readonly continuous: "Continuous";
+        readonly pageByPage: "Page by page";
+        readonly rotate: "Rotate";
+        readonly rotateClockwise: "Clockwise";
+        readonly rotateCounterclockwise: "Counterclockwise";
+        readonly layout: "Layout";
+        readonly singlePage: "Single page";
+        readonly twoPages: "Two pages";
+        readonly stylusMode: "Stylus mode";
+        readonly fullscreen: "Fullscreen";
+        readonly fieldProperties: "Field properties";
+        readonly fieldName: "Field name";
+        readonly fieldNameHint: "Shared names group radio buttons and bind multiple widgets to the same value.";
+        readonly required: "Required";
+        readonly readOnly: "Read-only";
+        readonly multiLine: "Multi-line";
+        readonly maxLength: "Max length";
+        readonly noLimit: "No limit";
+        readonly style: "Style";
+        readonly checkboxStyleHint: "Glyph drawn when checked. Saved as /MK /CA on export.";
+        readonly options: "Options";
+        readonly optionLabelPlaceholder: "Label";
+        readonly addOption: "Add option";
+        readonly comboBox: "Combo box (collapsible)";
+        readonly allowCustomText: "Allow custom text";
+        readonly multiSelect: "Multi-select";
+        readonly promptText: "Prompt text";
+        readonly clickToSign: "Click to sign";
+        readonly promptTextHint: "Shown on the unsigned widget. Defaults to \"{default}\".";
+        readonly lockFieldsAfterSigning: "Lock fields after signing";
+        readonly lockFieldsHint: "Once this signature is filled, listed fields become read-only inside the viewer. Not preserved on PDF export.";
+        readonly lockNone: "None";
+        readonly lockAllOther: "All other fields";
+        readonly lockSelectedOnly: "Selected fields only";
+        readonly lockAllExceptSelected: "All except selected";
+        readonly lockTheseFields: "Lock these fields";
+        readonly lockAllFieldsExcept: "Lock all fields except";
+        readonly noOtherNamedFields: "No other named fields in the document.";
+        readonly group: "Group";
+        readonly newGroup: "+ New group";
+        readonly radioGroupHint: "Radios sharing a group act as one — picking one clears the others.";
+        readonly optionValue: "Option value";
+        readonly optionValueHint: "Value stored when this option is selected. Must be unique inside the group.";
+        readonly typeLabel: "Type";
+        readonly pageLabel: "Page";
+        readonly deleteField: "Delete field";
+        readonly selectFieldHint: "Select a placed field to edit its properties.";
+        readonly fieldTypeText: "Text field";
+        readonly fieldTypeCheckbox: "Checkbox";
+        readonly fieldTypeRadio: "Radio button";
+        readonly fieldTypeSignature: "Signature field";
+        readonly fieldTypeDropdown: "Dropdown";
+        readonly fieldTypeButton: "Button";
+        readonly fieldTypeGeneric: "Field";
+        readonly fieldOnPage: "{type} on page {page}";
+        readonly styleCheck: "Check";
+        readonly styleCross: "Cross";
+        readonly styleDiamond: "Diamond";
+        readonly styleCircle: "Circle";
+        readonly styleStar: "Star";
+        readonly styleSquare: "Square";
+        readonly toolSelect: "Select";
+        readonly toolHighlight: "Highlight";
+        readonly toolStrikeout: "Strike out";
+        readonly toolUnderline: "Underline";
+        readonly toolRectangle: "Rectangle";
+        readonly toolCircle: "Ellipse";
+        readonly toolNote: "Note";
+        readonly toolArrow: "Arrow";
+        readonly toolCloud: "Cloud";
+        readonly toolFreehand: "Pen";
+        readonly toolFreeHighlight: "Highlighter";
+        readonly toolFreeText: "Text";
+        readonly toolSignature: "Signature";
+        readonly toolStamp: "Stamp";
+        readonly toolFormText: "Text field";
+        readonly toolFormCheckbox: "Checkbox";
+        readonly toolFormSignature: "Signature field";
+        readonly toolFormRadio: "Radio button";
+        readonly toolEraser: "Eraser";
+    };
+    readonly de: {
+        readonly cancel: "Abbrechen";
+        readonly ok: "OK";
+        readonly save: "Speichern";
+        readonly clear: "Leeren";
+        readonly delete: "Löschen";
+        readonly download: "Herunterladen";
+        readonly search: "Suchen";
+        readonly marqueeSelect: "Mehrfachauswahl";
+        readonly eraser: "Radierer";
+        readonly color: "Farbe";
+        readonly editText: "Text bearbeiten";
+        readonly strokeWidth: "Linienstärke";
+        readonly decreaseStrokeWidth: "Linienstärke verringern";
+        readonly increaseStrokeWidth: "Linienstärke erhöhen";
+        readonly noProperties: "Keine Eigenschaften";
+        readonly detectFormFields: "Formularfelder erkennen";
+        readonly disableFormFieldDetection: "Formularfeld-Erkennung deaktivieren";
+        readonly fitWidth: "Seitenbreite";
+        readonly fitPage: "Ganze Seite";
+        readonly stamp: "Stempel";
+        readonly signature: "Unterschrift";
+        readonly searchPlaceholder: "Im Dokument suchen...";
+        readonly previousMatch: "Vorheriger Treffer";
+        readonly nextMatch: "Nächster Treffer";
+        readonly matchCase: "Groß-/Kleinschreibung";
+        readonly wholeWord: "Ganzes Wort";
+        readonly highlightAll: "Alle hervorheben";
+        readonly closeSearch: "Suche schließen";
+        readonly noResults: "Keine Treffer";
+        readonly typeToSearch: "Suchbegriff eingeben";
+        readonly freeText: "Freitext";
+        readonly startTyping: "Text eingeben...";
+        readonly drawSignature: "Unterschrift zeichnen";
+        readonly noSavedSignatures: "Keine gespeicherten Unterschriften";
+        readonly addSignature: "Unterschrift hinzufügen";
+        readonly selectedCount: "{count} ausgewählt";
+        readonly pageTransition: "Seitenübergang";
+        readonly continuous: "Fortlaufend";
+        readonly pageByPage: "Seite für Seite";
+        readonly rotate: "Drehen";
+        readonly rotateClockwise: "Im Uhrzeigersinn";
+        readonly rotateCounterclockwise: "Gegen den Uhrzeigersinn";
+        readonly layout: "Layout";
+        readonly singlePage: "Einseitig";
+        readonly twoPages: "Zweiseitig";
+        readonly stylusMode: "Stiftmodus";
+        readonly fullscreen: "Vollbildansicht";
+        readonly fieldProperties: "Feldeigenschaften";
+        readonly fieldName: "Feldname";
+        readonly fieldNameHint: "Gleiche Namen gruppieren Optionsfelder und verbinden mehrere Widgets mit demselben Wert.";
+        readonly required: "Pflichtfeld";
+        readonly readOnly: "Schreibgeschützt";
+        readonly multiLine: "Mehrzeilig";
+        readonly maxLength: "Maximale Länge";
+        readonly noLimit: "Kein Limit";
+        readonly style: "Stil";
+        readonly checkboxStyleHint: "Symbol im angekreuzten Zustand. Wird beim Export als /MK /CA gespeichert.";
+        readonly options: "Optionen";
+        readonly optionLabelPlaceholder: "Beschriftung";
+        readonly addOption: "Option hinzufügen";
+        readonly comboBox: "Kombinationsfeld (aufklappbar)";
+        readonly allowCustomText: "Eigenen Text erlauben";
+        readonly multiSelect: "Mehrfachauswahl";
+        readonly promptText: "Hinweistext";
+        readonly clickToSign: "Zum Unterschreiben klicken";
+        readonly promptTextHint: "Wird auf dem nicht unterschriebenen Feld angezeigt. Standard: \"{default}\".";
+        readonly lockFieldsAfterSigning: "Felder nach Unterschrift sperren";
+        readonly lockFieldsHint: "Sobald diese Unterschrift ausgefüllt ist, werden die gewählten Felder im Viewer schreibgeschützt. Wird beim PDF-Export nicht übernommen.";
+        readonly lockNone: "Keine";
+        readonly lockAllOther: "Alle anderen Felder";
+        readonly lockSelectedOnly: "Nur ausgewählte Felder";
+        readonly lockAllExceptSelected: "Alle außer ausgewählte";
+        readonly lockTheseFields: "Diese Felder sperren";
+        readonly lockAllFieldsExcept: "Alle Felder sperren außer";
+        readonly noOtherNamedFields: "Keine weiteren benannten Felder im Dokument.";
+        readonly group: "Gruppe";
+        readonly newGroup: "+ Neue Gruppe";
+        readonly radioGroupHint: "Optionsfelder derselben Gruppe wirken als eines — die Auswahl eines Feldes hebt die anderen auf.";
+        readonly optionValue: "Optionswert";
+        readonly optionValueHint: "Wert, der bei Auswahl dieser Option gespeichert wird. Muss innerhalb der Gruppe eindeutig sein.";
+        readonly typeLabel: "Typ";
+        readonly pageLabel: "Seite";
+        readonly deleteField: "Feld löschen";
+        readonly selectFieldHint: "Wählen Sie ein platziertes Feld aus, um seine Eigenschaften zu bearbeiten.";
+        readonly fieldTypeText: "Textfeld";
+        readonly fieldTypeCheckbox: "Kontrollkästchen";
+        readonly fieldTypeRadio: "Optionsfeld";
+        readonly fieldTypeSignature: "Unterschriftsfeld";
+        readonly fieldTypeDropdown: "Auswahlliste";
+        readonly fieldTypeButton: "Schaltfläche";
+        readonly fieldTypeGeneric: "Feld";
+        readonly fieldOnPage: "{type} auf Seite {page}";
+        readonly styleCheck: "Haken";
+        readonly styleCross: "Kreuz";
+        readonly styleDiamond: "Raute";
+        readonly styleCircle: "Kreis";
+        readonly styleStar: "Stern";
+        readonly styleSquare: "Quadrat";
+        readonly toolSelect: "Auswählen";
+        readonly toolHighlight: "Hervorheben";
+        readonly toolStrikeout: "Durchstreichen";
+        readonly toolUnderline: "Unterstreichen";
+        readonly toolRectangle: "Rechteck";
+        readonly toolCircle: "Ellipse";
+        readonly toolNote: "Notiz";
+        readonly toolArrow: "Pfeil";
+        readonly toolCloud: "Wolke";
+        readonly toolFreehand: "Stift";
+        readonly toolFreeHighlight: "Marker";
+        readonly toolFreeText: "Text";
+        readonly toolSignature: "Unterschrift";
+        readonly toolStamp: "Stempel";
+        readonly toolFormText: "Textfeld";
+        readonly toolFormCheckbox: "Kontrollkästchen";
+        readonly toolFormSignature: "Unterschriftsfeld";
+        readonly toolFormRadio: "Optionsfeld";
+        readonly toolEraser: "Radierer";
+    };
+};
+export type KviewerLocale = keyof typeof messages;
+export type MessageKey = keyof typeof messages.en;
+export declare const KVIEWER_LOCALES: KviewerLocale[];

package/dist/runtime/i18n/messages.js

@@ -0,0 +1,249 @@
+export const messages = {
+  en: {
+    // Common actions
+    cancel: "Cancel",
+    ok: "OK",
+    save: "Save",
+    clear: "Clear",
+    delete: "Delete",
+    download: "Download",
+    // Toolbar
+    search: "Search",
+    marqueeSelect: "Marquee select",
+    eraser: "Eraser",
+    color: "Color",
+    editText: "Edit text",
+    strokeWidth: "Stroke width",
+    decreaseStrokeWidth: "Decrease stroke width",
+    increaseStrokeWidth: "Increase stroke width",
+    noProperties: "No properties",
+    detectFormFields: "Detect form fields",
+    disableFormFieldDetection: "Disable form field detection",
+    fitWidth: "Fit width",
+    fitPage: "Fit page",
+    stamp: "Stamp",
+    signature: "Signature",
+    // Search panel
+    searchPlaceholder: "Find in document...",
+    previousMatch: "Previous match",
+    nextMatch: "Next match",
+    matchCase: "Match case",
+    wholeWord: "Whole word",
+    highlightAll: "Highlight all",
+    closeSearch: "Close search",
+    noResults: "No results",
+    typeToSearch: "Type to search",
+    // Modals
+    freeText: "Free text",
+    startTyping: "Start typing...",
+    drawSignature: "Draw signature",
+    noSavedSignatures: "No saved signatures",
+    addSignature: "Add signature",
+    selectedCount: "{count} selected",
+    // Page settings menu
+    pageTransition: "Page transition",
+    continuous: "Continuous",
+    pageByPage: "Page by page",
+    rotate: "Rotate",
+    rotateClockwise: "Clockwise",
+    rotateCounterclockwise: "Counterclockwise",
+    layout: "Layout",
+    singlePage: "Single page",
+    twoPages: "Two pages",
+    stylusMode: "Stylus mode",
+    fullscreen: "Fullscreen",
+    // Form-field sidebar
+    fieldProperties: "Field properties",
+    fieldName: "Field name",
+    fieldNameHint: "Shared names group radio buttons and bind multiple widgets to the same value.",
+    required: "Required",
+    readOnly: "Read-only",
+    multiLine: "Multi-line",
+    maxLength: "Max length",
+    noLimit: "No limit",
+    style: "Style",
+    checkboxStyleHint: "Glyph drawn when checked. Saved as /MK /CA on export.",
+    options: "Options",
+    optionLabelPlaceholder: "Label",
+    addOption: "Add option",
+    comboBox: "Combo box (collapsible)",
+    allowCustomText: "Allow custom text",
+    multiSelect: "Multi-select",
+    promptText: "Prompt text",
+    clickToSign: "Click to sign",
+    promptTextHint: 'Shown on the unsigned widget. Defaults to "{default}".',
+    lockFieldsAfterSigning: "Lock fields after signing",
+    lockFieldsHint: "Once this signature is filled, listed fields become read-only inside the viewer. Not preserved on PDF export.",
+    lockNone: "None",
+    lockAllOther: "All other fields",
+    lockSelectedOnly: "Selected fields only",
+    lockAllExceptSelected: "All except selected",
+    lockTheseFields: "Lock these fields",
+    lockAllFieldsExcept: "Lock all fields except",
+    noOtherNamedFields: "No other named fields in the document.",
+    group: "Group",
+    newGroup: "+ New group",
+    radioGroupHint: "Radios sharing a group act as one \u2014 picking one clears the others.",
+    optionValue: "Option value",
+    optionValueHint: "Value stored when this option is selected. Must be unique inside the group.",
+    typeLabel: "Type",
+    pageLabel: "Page",
+    deleteField: "Delete field",
+    selectFieldHint: "Select a placed field to edit its properties.",
+    fieldTypeText: "Text field",
+    fieldTypeCheckbox: "Checkbox",
+    fieldTypeRadio: "Radio button",
+    fieldTypeSignature: "Signature field",
+    fieldTypeDropdown: "Dropdown",
+    fieldTypeButton: "Button",
+    fieldTypeGeneric: "Field",
+    fieldOnPage: "{type} on page {page}",
+    // Checkbox glyph styles
+    styleCheck: "Check",
+    styleCross: "Cross",
+    styleDiamond: "Diamond",
+    styleCircle: "Circle",
+    styleStar: "Star",
+    styleSquare: "Square",
+    // Tool tooltips (keyed from the engine tool `name`)
+    toolSelect: "Select",
+    toolHighlight: "Highlight",
+    toolStrikeout: "Strike out",
+    toolUnderline: "Underline",
+    toolRectangle: "Rectangle",
+    toolCircle: "Ellipse",
+    toolNote: "Note",
+    toolArrow: "Arrow",
+    toolCloud: "Cloud",
+    toolFreehand: "Pen",
+    toolFreeHighlight: "Highlighter",
+    toolFreeText: "Text",
+    toolSignature: "Signature",
+    toolStamp: "Stamp",
+    toolFormText: "Text field",
+    toolFormCheckbox: "Checkbox",
+    toolFormSignature: "Signature field",
+    toolFormRadio: "Radio button",
+    toolEraser: "Eraser"
+  },
+  de: {
+    cancel: "Abbrechen",
+    ok: "OK",
+    save: "Speichern",
+    clear: "Leeren",
+    delete: "L\xF6schen",
+    download: "Herunterladen",
+    search: "Suchen",
+    marqueeSelect: "Mehrfachauswahl",
+    eraser: "Radierer",
+    color: "Farbe",
+    editText: "Text bearbeiten",
+    strokeWidth: "Linienst\xE4rke",
+    decreaseStrokeWidth: "Linienst\xE4rke verringern",
+    increaseStrokeWidth: "Linienst\xE4rke erh\xF6hen",
+    noProperties: "Keine Eigenschaften",
+    detectFormFields: "Formularfelder erkennen",
+    disableFormFieldDetection: "Formularfeld-Erkennung deaktivieren",
+    fitWidth: "Seitenbreite",
+    fitPage: "Ganze Seite",
+    stamp: "Stempel",
+    signature: "Unterschrift",
+    searchPlaceholder: "Im Dokument suchen...",
+    previousMatch: "Vorheriger Treffer",
+    nextMatch: "N\xE4chster Treffer",
+    matchCase: "Gro\xDF-/Kleinschreibung",
+    wholeWord: "Ganzes Wort",
+    highlightAll: "Alle hervorheben",
+    closeSearch: "Suche schlie\xDFen",
+    noResults: "Keine Treffer",
+    typeToSearch: "Suchbegriff eingeben",
+    freeText: "Freitext",
+    startTyping: "Text eingeben...",
+    drawSignature: "Unterschrift zeichnen",
+    noSavedSignatures: "Keine gespeicherten Unterschriften",
+    addSignature: "Unterschrift hinzuf\xFCgen",
+    selectedCount: "{count} ausgew\xE4hlt",
+    pageTransition: "Seiten\xFCbergang",
+    continuous: "Fortlaufend",
+    pageByPage: "Seite f\xFCr Seite",
+    rotate: "Drehen",
+    rotateClockwise: "Im Uhrzeigersinn",
+    rotateCounterclockwise: "Gegen den Uhrzeigersinn",
+    layout: "Layout",
+    singlePage: "Einseitig",
+    twoPages: "Zweiseitig",
+    stylusMode: "Stiftmodus",
+    fullscreen: "Vollbildansicht",
+    fieldProperties: "Feldeigenschaften",
+    fieldName: "Feldname",
+    fieldNameHint: "Gleiche Namen gruppieren Optionsfelder und verbinden mehrere Widgets mit demselben Wert.",
+    required: "Pflichtfeld",
+    readOnly: "Schreibgesch\xFCtzt",
+    multiLine: "Mehrzeilig",
+    maxLength: "Maximale L\xE4nge",
+    noLimit: "Kein Limit",
+    style: "Stil",
+    checkboxStyleHint: "Symbol im angekreuzten Zustand. Wird beim Export als /MK /CA gespeichert.",
+    options: "Optionen",
+    optionLabelPlaceholder: "Beschriftung",
+    addOption: "Option hinzuf\xFCgen",
+    comboBox: "Kombinationsfeld (aufklappbar)",
+    allowCustomText: "Eigenen Text erlauben",
+    multiSelect: "Mehrfachauswahl",
+    promptText: "Hinweistext",
+    clickToSign: "Zum Unterschreiben klicken",
+    promptTextHint: 'Wird auf dem nicht unterschriebenen Feld angezeigt. Standard: "{default}".',
+    lockFieldsAfterSigning: "Felder nach Unterschrift sperren",
+    lockFieldsHint: "Sobald diese Unterschrift ausgef\xFCllt ist, werden die gew\xE4hlten Felder im Viewer schreibgesch\xFCtzt. Wird beim PDF-Export nicht \xFCbernommen.",
+    lockNone: "Keine",
+    lockAllOther: "Alle anderen Felder",
+    lockSelectedOnly: "Nur ausgew\xE4hlte Felder",
+    lockAllExceptSelected: "Alle au\xDFer ausgew\xE4hlte",
+    lockTheseFields: "Diese Felder sperren",
+    lockAllFieldsExcept: "Alle Felder sperren au\xDFer",
+    noOtherNamedFields: "Keine weiteren benannten Felder im Dokument.",
+    group: "Gruppe",
+    newGroup: "+ Neue Gruppe",
+    radioGroupHint: "Optionsfelder derselben Gruppe wirken als eines \u2014 die Auswahl eines Feldes hebt die anderen auf.",
+    optionValue: "Optionswert",
+    optionValueHint: "Wert, der bei Auswahl dieser Option gespeichert wird. Muss innerhalb der Gruppe eindeutig sein.",
+    typeLabel: "Typ",
+    pageLabel: "Seite",
+    deleteField: "Feld l\xF6schen",
+    selectFieldHint: "W\xE4hlen Sie ein platziertes Feld aus, um seine Eigenschaften zu bearbeiten.",
+    fieldTypeText: "Textfeld",
+    fieldTypeCheckbox: "Kontrollk\xE4stchen",
+    fieldTypeRadio: "Optionsfeld",
+    fieldTypeSignature: "Unterschriftsfeld",
+    fieldTypeDropdown: "Auswahlliste",
+    fieldTypeButton: "Schaltfl\xE4che",
+    fieldTypeGeneric: "Feld",
+    fieldOnPage: "{type} auf Seite {page}",
+    styleCheck: "Haken",
+    styleCross: "Kreuz",
+    styleDiamond: "Raute",
+    styleCircle: "Kreis",
+    styleStar: "Stern",
+    styleSquare: "Quadrat",
+    toolSelect: "Ausw\xE4hlen",
+    toolHighlight: "Hervorheben",
+    toolStrikeout: "Durchstreichen",
+    toolUnderline: "Unterstreichen",
+    toolRectangle: "Rechteck",
+    toolCircle: "Ellipse",
+    toolNote: "Notiz",
+    toolArrow: "Pfeil",
+    toolCloud: "Wolke",
+    toolFreehand: "Stift",
+    toolFreeHighlight: "Marker",
+    toolFreeText: "Text",
+    toolSignature: "Unterschrift",
+    toolStamp: "Stempel",
+    toolFormText: "Textfeld",
+    toolFormCheckbox: "Kontrollk\xE4stchen",
+    toolFormSignature: "Unterschriftsfeld",
+    toolFormRadio: "Optionsfeld",
+    toolEraser: "Radierer"
+  }
+};
+export const KVIEWER_LOCALES = Object.keys(messages);

package/dist/runtime/public-types.d.ts

@@ -2,6 +2,7 @@ export type { ExportPdfOptions } from './annotation/pdf-export/export.js';
 export type { ViewerTabItem, AddTabOptions } from './components/ViewerTabs.vue.js';
 export type { AddFormFieldPayload, CheckboxStyle, FormFieldDefinition, FormFieldOrigin, FormFieldType, FormFieldValue, SignatureData, SignatureHandlers, } from './annotation/engine/types.js';
 export type { ViewMode } from './composables/viewMode.js';
+export type { ViewerState, ActiveTool } from './composables/useViewerState.js';
 export type { KViewerApi, KViewerEmbedBridgeOptions, } from './embed/bridge-host.js';
 export { useKViewerEmbedBridge } from './embed/bridge-host.js';
 export type { KViewerEmbedClientOptions } from './embed/bridge-client.js';
@@ -9,3 +10,4 @@ export { KViewerEmbedClient } from './embed/bridge-client.js';
 export type { EventName as KViewerEmbedEventName, EventPayloads as KViewerEmbedEventPayloads, MethodName as KViewerEmbedMethodName, } from './embed/protocol.js';
 export { KVIEWER_EMBED_PROTOCOL_VERSION } from './embed/protocol.js';
 export type { ViewerMenuItem, ViewerMenuButtonItem, ViewerMenuCheckboxItem, ViewerMenuSeparatorItem, } from './menu-items.js';
+export type { ViewerToolId, ViewerTopToolId, ViewerBottomToolId, ViewerLayoutToolId, ViewerToolEntry, ViewerToolSlot, } from './toolbar-tools.js';

package/dist/runtime/toolbar-tools.d.ts

@@ -0,0 +1,54 @@
+import type { InjectionKey, Ref } from 'vue';
+import { AnnotationType } from './annotation/engine/types.js';
+/** Built-in tools that live in the top navigation row. Each maps to a
+ *  whole self-contained sub-component. `hand` / `marquee` are readonly-gated. */
+export type ViewerTopToolId = 'menu' | 'pageSettings' | 'zoom' | 'hand' | 'marquee' | 'pageInfo' | 'search';
+/** Built-in tools that live in the second (annotation) row, controlled
+ *  per individual button. IDs match the annotation `name` in
+ *  `annotation/engine/config.ts` (so `freeHighlight` never collides with
+ *  the text-selection `highlight`). The `select`/`highlight`/`strikeout`/
+ *  `underline`/`circle`/`note`/`arrow`/`cloud` entries have no button in
+ *  the default toolbar — they are opt-in extras a host may add. */
+export type ViewerBottomToolId = 'properties' | 'freehand' | 'freeHighlight' | 'freeText' | 'stamp' | 'signature' | 'rectangle' | 'formText' | 'formCheckbox' | 'formRadio' | 'formSignature' | 'undo' | 'redo' | 'eraser' | 'select' | 'highlight' | 'strikeout' | 'underline' | 'circle' | 'note' | 'arrow' | 'cloud';
+/** Layout primitives usable in either row. `separator` draws a vertical
+ *  divider; `spacer` pushes everything after it to the right (flex
+ *  `ml-auto`) — this is how you reproduce today's right-aligned group. */
+export type ViewerLayoutToolId = 'separator' | 'spacer';
+export type ViewerToolId = ViewerTopToolId | ViewerBottomToolId | ViewerLayoutToolId;
+/** A custom toolbar button, rendered from the host-supplied `#tool-<name>`
+ *  slot at this position. Mirrors the `menuItems` discriminated-union
+ *  pattern. See {@link ViewerToolEntry}. */
+export interface ViewerToolSlot {
+    type: 'slot';
+    /** Stable key for v-for; also the slot name unless `name` is set. */
+    key: string;
+    /** Slot-name suffix — the host fills `#tool-<name>`. Defaults to `key`. */
+    name?: string;
+    /** Which row to place this custom button in. When omitted it inherits
+     *  the row of the preceding entry (top until the first bottom tool). */
+    row?: 'top' | 'bottom';
+}
+/** One entry in the `tools` prop: either a built-in tool ID (a plain
+ *  string — controls presence + order) or a {@link ViewerToolSlot} object
+ *  that injects a custom button via a named slot. */
+export type ViewerToolEntry = ViewerToolId | ViewerToolSlot;
+/** Top-row built-in IDs. */
+export declare const TOP_TOOL_IDS: ReadonlySet<string>;
+/** Top-row tools hidden whenever `readonly` is true. */
+export declare const READONLY_HIDDEN_TOP: ReadonlySet<string>;
+/** Form-mode bottom-row tools — render only when `formEditMode` is on. */
+export declare const FORM_TOOLS: ReadonlySet<string>;
+/** Draw/annotate-mode bottom-row tools — render only when `formEditMode`
+ *  is off (matches today's center swap). */
+export declare const DRAW_TOOLS: ReadonlySet<string>;
+/** Bottom-row built-in IDs (everything that is not top-row or layout). */
+export declare const BOTTOM_TOOL_IDS: ReadonlySet<string>;
+/** Maps an annotation-button ID to the {@link AnnotationType} it selects.
+ *  `stamp`/`signature` are pickers and `undo`/`redo`/`properties` are not
+ *  annotation tools, so they are intentionally absent. `eraser` is handled
+ *  separately (it is not an annotation type). */
+export declare const ANNOTATION_TOOL_TYPES: Partial<Record<string, AnnotationType>>;
+/** Injection key for the toolbar `styleVersion` ref. `ViewerBar` provides
+ *  it (bumped when `ToolProperties` edits a tool's style) so standalone
+ *  `AnnotationToolButton`s refresh their color indicator. */
+export declare const STYLE_VERSION_KEY: InjectionKey<Ref<number>>;

package/dist/runtime/toolbar-tools.js

@@ -0,0 +1,79 @@
+import { AnnotationType } from "./annotation/engine/types.js";
+export const TOP_TOOL_IDS = /* @__PURE__ */ new Set([
+  "menu",
+  "pageSettings",
+  "zoom",
+  "hand",
+  "marquee",
+  "pageInfo",
+  "search"
+]);
+export const READONLY_HIDDEN_TOP = /* @__PURE__ */ new Set([
+  "hand",
+  "marquee"
+]);
+export const FORM_TOOLS = /* @__PURE__ */ new Set([
+  "formText",
+  "formCheckbox",
+  "formRadio",
+  "formSignature"
+]);
+export const DRAW_TOOLS = /* @__PURE__ */ new Set([
+  "freehand",
+  "freeHighlight",
+  "freeText",
+  "stamp",
+  "signature",
+  "rectangle",
+  "select",
+  "highlight",
+  "strikeout",
+  "underline",
+  "circle",
+  "note",
+  "arrow",
+  "cloud"
+]);
+export const BOTTOM_TOOL_IDS = /* @__PURE__ */ new Set([
+  "properties",
+  "freehand",
+  "freeHighlight",
+  "freeText",
+  "stamp",
+  "signature",
+  "rectangle",
+  "formText",
+  "formCheckbox",
+  "formRadio",
+  "formSignature",
+  "undo",
+  "redo",
+  "eraser",
+  "select",
+  "highlight",
+  "strikeout",
+  "underline",
+  "circle",
+  "note",
+  "arrow",
+  "cloud"
+]);
+export const ANNOTATION_TOOL_TYPES = {
+  freehand: AnnotationType.FREEHAND,
+  freeHighlight: AnnotationType.FREE_HIGHLIGHT,
+  freeText: AnnotationType.FREETEXT,
+  rectangle: AnnotationType.RECTANGLE,
+  formText: AnnotationType.FORM_TEXT,
+  formCheckbox: AnnotationType.FORM_CHECKBOX,
+  formRadio: AnnotationType.FORM_RADIO,
+  formSignature: AnnotationType.FORM_SIGNATURE,
+  select: AnnotationType.SELECT,
+  highlight: AnnotationType.HIGHLIGHT,
+  strikeout: AnnotationType.STRIKEOUT,
+  underline: AnnotationType.UNDERLINE,
+  circle: AnnotationType.CIRCLE,
+  note: AnnotationType.NOTE,
+  arrow: AnnotationType.ARROW,
+  cloud: AnnotationType.CLOUD
+};
+export const STYLE_VERSION_KEY = Symbol("kviewer-style-version");