kviewer 0.2.0 → 0.2.2

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");

package/dist/types.d.mts

@@ -1,4 +1,4 @@
-export { type AddFormFieldPayload, type CheckboxStyle, type ExportPdfOptions, type FormFieldDefinition, type FormFieldOrigin, type FormFieldType, type FormFieldValue, type KVIEWER_EMBED_PROTOCOL_VERSION, type KViewerApi, type KViewerEmbedBridgeOptions, type KViewerEmbedClient, type KViewerEmbedClientOptions, type KViewerEmbedEventName, type KViewerEmbedEventPayloads, type KViewerEmbedMethodName, type SignatureData, type SignatureHandlers, type ViewMode, type ViewerMenuButtonItem, type ViewerMenuCheckboxItem, type ViewerMenuItem, type ViewerMenuSeparatorItem, type useKViewerEmbedBridge } from '../dist/runtime/public-types.js'
+export { type ActiveTool, type AddFormFieldPayload, type CheckboxStyle, type ExportPdfOptions, type FormFieldDefinition, type FormFieldOrigin, type FormFieldType, type FormFieldValue, type KVIEWER_EMBED_PROTOCOL_VERSION, type KViewerApi, type KViewerEmbedBridgeOptions, type KViewerEmbedClient, type KViewerEmbedClientOptions, type KViewerEmbedEventName, type KViewerEmbedEventPayloads, type KViewerEmbedMethodName, type SignatureData, type SignatureHandlers, type ViewMode, type ViewerBottomToolId, type ViewerLayoutToolId, type ViewerMenuButtonItem, type ViewerMenuCheckboxItem, type ViewerMenuItem, type ViewerMenuSeparatorItem, type ViewerState, type ViewerToolEntry, type ViewerToolId, type ViewerToolSlot, type ViewerTopToolId, type useKViewerEmbedBridge } from '../dist/runtime/public-types.js'
 
 export { default } from './module.mjs'
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kviewer",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Kabema PDF Editor",
   "repository": "kabema/kviewer",
   "license": "MIT",
@@ -28,26 +28,14 @@
     "playground",
     "docs"
   ],
-  "scripts": {
-    "prepack": "nuxt-module-build build",
-    "dev": "npm run dev:prepare && portless kviewer nuxt dev playground",
-    "dev:build": "nuxt build playground",
-    "dev:prepare": "nuxt-module-build build --stub && nuxt-module-build prepare && nuxt prepare playground",
-    "release": "npm run lint && npm run test && npm run prepack && changelogen --release && npm publish && git push --follow-tags",
-    "lint": "eslint .",
-    "test": "vitest run --exclude '**/e2e/**'",
-    "test:watch": "vitest watch",
-    "test:types": "vue-tsc --noEmit && cd playground && vue-tsc --noEmit",
-    "test:e2e": "playwright test",
-    "test:e2e:ui": "playwright test --ui"
-  },
   "dependencies": {
     "@iconify-json/lucide": "^1.2.101",
     "@nuxt/kit": "^4.4.2",
     "@nuxt/ui": "^4.6.0",
+    "@pdf-lib/fontkit": "^1.1.1",
     "konva": "^10.2.3",
     "pdf-lib": "^1.17.1",
-    "pdfjs-dist": "^5.6.205",
+    "pdfjs-dist": "^6.0.227",
     "tailwindcss": "^4.2.2"
   },
   "devDependencies": {
@@ -70,20 +58,15 @@
     "vitest": "^4.1.1",
     "vue-tsc": "^3.2.6"
   },
-  "packageManager": "pnpm@10.33.0",
-  "pnpm": {
-    "onlyBuiltDependencies": [
-      "canvas",
-      "@parcel/watcher",
-      "better-sqlite3",
-      "esbuild",
-      "sharp",
-      "vue-demi",
-      "unrs-resolver"
-    ],
-    "overrides": {
-      "vue": "^3.5.32",
-      "vue-router": "^5.0.4"
-    }
+  "scripts": {
+    "dev": "npm run dev:prepare && portless kviewer nuxt dev playground",
+    "dev:build": "nuxt build playground",
+    "dev:prepare": "nuxt-module-build build --stub && nuxt-module-build prepare && nuxt prepare playground",
+    "lint": "eslint .",
+    "test": "vitest run --exclude '**/e2e/**'",
+    "test:watch": "vitest watch",
+    "test:types": "vue-tsc --noEmit && cd playground && vue-tsc --noEmit",
+    "test:e2e": "playwright test",
+    "test:e2e:ui": "playwright test --ui"
   }
-}
+}