kviewer 0.3.3 → 0.3.5

package/dist/runtime/selection-items.d.ts

@@ -0,0 +1,61 @@
+import type { InjectionKey, Ref } from 'vue';
+import type { FormFieldDefinition, IAnnotationStore } from './annotation/engine/types.js';
+/** What the floating selection popover is currently attached to. Passed to
+ *  every custom-item callback so a single item list can serve both the
+ *  Konva annotation selection and the HTML placed-field selection. */
+export interface ViewerSelectionContext {
+    /** `'annotation'` = Konva-drawn annotation(s); `'field'` = a user-placed
+     *  HTML form field (e.g. a signature field). */
+    kind: 'annotation' | 'field';
+    /** The selected annotation(s): one entry for a single selection, several
+     *  for a marquee multi-select, empty when `kind` is `'field'`. */
+    annotations: IAnnotationStore[];
+    /** The selected placed form field. Null when `kind` is `'annotation'`. */
+    field: FormFieldDefinition | null;
+}
+/** A custom control appended to the floating selection popover shown when
+ *  an annotation or a placed form field is selected. Pass an array of
+ *  these to `<KViewer :selection-items="...">` (or `<KViewerTabs>`).
+ *
+ *  Mirrors the `menuItems` discriminated-union pattern; scoped to the
+ *  controls a compact floating toolbar can carry. */
+export type ViewerSelectionItem = ViewerSelectionButtonItem | ViewerSelectionSelectItem;
+export interface ViewerSelectionButtonItem {
+    type: 'button';
+    /** Stable key for Vue list rendering. Keep unique within the array. */
+    key: string;
+    /** Tooltip / accessible label. Rendered as text when no icon is set. */
+    label: string;
+    /** Lucide-style icon name. When set, the button is icon-only. */
+    icon?: string;
+    /** Fired on click with the current selection. */
+    onSelect: (ctx: ViewerSelectionContext) => void;
+    /** Disables the item without removing it. */
+    disabled?: boolean;
+    /** Show the item only for selections this predicate accepts. Omit to
+     *  show it for both annotation and field selections. */
+    visible?: (ctx: ViewerSelectionContext) => boolean;
+}
+export interface ViewerSelectionSelectItem {
+    type: 'select';
+    key: string;
+    /** Accessible label / tooltip for the select. */
+    label?: string;
+    /** Options shown in the dropdown. */
+    items: {
+        label: string;
+        value: string;
+    }[];
+    /** Current value — a plain (reactive) string, or a getter deriving it
+     *  from the current selection. */
+    value?: string | ((ctx: ViewerSelectionContext) => string | undefined);
+    placeholder?: string;
+    /** Fired with the chosen option value and the current selection. */
+    onUpdate: (value: string, ctx: ViewerSelectionContext) => void;
+    disabled?: boolean;
+    visible?: (ctx: ViewerSelectionContext) => boolean;
+}
+/** Provided by KViewer so both selection popovers (the Konva annotation
+ *  toolbar and the placed-field toolbar, which lives deep inside the page
+ *  DOM layer) can read the host's items without prop-drilling. */
+export declare const SELECTION_ITEMS_KEY: InjectionKey<Ref<ViewerSelectionItem[] | undefined>>;

package/dist/runtime/selection-items.js

@@ -0,0 +1 @@
+export const SELECTION_ITEMS_KEY = Symbol("kviewer-selection-items");

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

@@ -1,7 +1,10 @@
 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. */
+ *  whole self-contained sub-component. `hand` / `marquee` are readonly-gated.
+ *  `marquee` has no button in the default toolbar — hand mode rubber-band
+ *  selects on empty-space mouse drags; the dedicated mode remains for hosts
+ *  that want touch-capable multi-select via the `tools` prop. */
 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

package/dist/types.d.mts

@@ -1,4 +1,4 @@
-export { type ActiveTool, type AddFormFieldPayload, type CheckboxStyle, type ExportPdfOptions, type FormFieldDefinition, type FormFieldOrigin, type FormFieldType, type FormFieldValue, type KVIEWER_EMBED_PROTOCOL_VERSION, type KVIEWER_EMBED_UNSUPPORTED_METHOD_ERROR_NAME, type KViewerApi, type KViewerEmbedBridgeOptions, type KViewerEmbedClient, type KViewerEmbedClientOptions, type KViewerEmbedEventName, type KViewerEmbedEventPayloads, type KViewerEmbedMethodName, type KViewerHostApi, type PlacedFieldDefaults, type SignatureData, type SignatureFieldStatus, 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 { type ActiveTool, type AddFormFieldPayload, type CheckboxStyle, type ExportPdfOptions, type FormFieldDefinition, type FormFieldOrigin, type FormFieldType, type FormFieldValue, type IAnnotationStore, type KVIEWER_EMBED_PROTOCOL_VERSION, type KVIEWER_EMBED_UNSUPPORTED_METHOD_ERROR_NAME, type KViewerApi, type KViewerEmbedBridgeOptions, type KViewerEmbedClient, type KViewerEmbedClientOptions, type KViewerEmbedEventName, type KViewerEmbedEventPayloads, type KViewerEmbedMethodName, type KViewerHostApi, type PlacedFieldDefaults, type SignatureData, type SignatureFieldStatus, type SignatureHandlers, type ViewMode, type ViewerBottomToolId, type ViewerLayoutToolId, type ViewerMenuButtonItem, type ViewerMenuCheckboxItem, type ViewerMenuItem, type ViewerMenuSeparatorItem, type ViewerSelectionButtonItem, type ViewerSelectionContext, type ViewerSelectionItem, type ViewerSelectionSelectItem, 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.3.3",
+  "version": "0.3.5",
   "description": "Kabema PDF Editor",
   "repository": "kabema/kviewer",
   "license": "MIT",