Types

import type {
  AddFormFieldPayload,
  AddTabOptions,
  CheckboxStyle,
  ExportPdfOptions,
  FormFieldDefinition,
  FormFieldOrigin,
  FormFieldType,
  FormFieldValue,
  SignatureData,
  SignatureHandlers,
  ViewerTabItem,
  ViewMode,
} from 'kviewer'

interface ExportPdfOptions {
  /** Burn annotations into PDF page content (non-editable). Default: false */
  flatten?: boolean
  /** Trigger browser file download. Default: false */
  download?: boolean
  /** Custom filename for download. Auto-generated if omitted. */
  fileName?: string
  /** Keep unmodified native PDF annotations. Default: false */
  preserveOriginalAnnotations?: boolean
}

interface ViewerTabItem {
  /** Unique tab identifier */
  id: string
  /** Display label in the tab bar */
  label: string
  /** PDF source: URL string, Uint8Array, or pdfjs-dist init params */
  source: string | Uint8Array | object
  /** Lucide icon name. Default: 'i-lucide-file-text' */
  icon?: string
  /** Whether the tab can be closed. Default: true */
  closable?: boolean
  /** View mode override for this tab */
  viewMode?: ViewMode
  /** Zoom override for this tab */
  zoom?: number
  /** Shape detection override for this tab */
  shapeDetection?: boolean
  /** Execute embedded PDF JavaScript for this document. Overrides
   *  `KViewerTabs.scripting` when set. Default: undefined (inherit). */
  scripting?: boolean
}

type ViewerMenuItem =
  | ViewerMenuButtonItem
  | ViewerMenuCheckboxItem
  | ViewerMenuSeparatorItem

interface ViewerMenuButtonItem {
  type: 'button'
  key: string          // stable id for Vue list rendering
  label: string
  icon?: string        // any Lucide icon name (e.g. 'i-lucide-trash')
  onSelect: () => void
  disabled?: boolean
}

interface ViewerMenuCheckboxItem {
  type: 'checkbox'
  key: string
  label: string
  icon?: string        // defaults to a checked/unchecked square
  checked: boolean     // keep this reactive — Vue re-renders on change
  onUpdate: (checked: boolean) => void
  disabled?: boolean
}

interface ViewerMenuSeparatorItem {
  type: 'separator'
  key: string
}

interface AddTabOptions {
  /** Insert at specific index. Default: end */
  index?: number
  /** Switch to the new tab. Default: true */
  activate?: boolean
}

interface StampDefinition {
  /** Unique stamp identifier */
  id: string
  /** Display name in stamp picker */
  name: string
  /** Image source (URL, SVG path, or base64) */
  imageUrl: string
  /** Optional preview thumbnail URL */
  previewUrl?: string
  /** Default width in points */
  width?: number
  /** Default height in points */
  height?: number
}

interface SignatureData {
  /** Unique signature identifier */
  id: string
  /** Base64 data URL or image URL */
  imageUrl: string
  /** Optional display name */
  name?: string
}

interface SignatureHandlers {
  /** Load all saved signatures */
  onLoad: () => Promise<SignatureData[]>
  /** Save a new signature. Returns the saved SignatureData */
  onSave: (imageUrl: string) => Promise<SignatureData>
  /** Delete a signature by ID */
  onDelete: (id: string) => Promise<void>
}

interface IAnnotationStore {
  /** Unique annotation ID */
  id: string
  /** 1-indexed page number */
  pageNumber: number
  /** Serialized Konva.js shape */
  konvaString: string
  /** Bounding box { x, y, width, height } */
  konvaClientRect: IRect
  /** Author name */
  title: string
  /** KViewer annotation type */
  type: AnnotationType
  /** Annotation color (hex) */
  color?: string | null
  /** PDF annotation subtype */
  subtype: PdfjsAnnotationSubtype
  /** Font size for text annotations */
  fontSize?: number | null
  /** pdfjs-dist annotation type number */
  pdfjsType: PdfjsAnnotationType
  /** pdfjs-dist editor type number */
  pdfjsEditorType: PdfjsAnnotationEditorType
  /** ISO date string */
  date: string
  /** Text or image content */
  contentsObj?: IAnnotationContentsObj | null
  /** Comment thread on this annotation */
  comments: IAnnotationComment[]
  /** Whether the annotation can be resized */
  resizable: boolean
  /** Whether the annotation can be dragged */
  draggable: boolean
}

enum AnnotationType {
  NONE = -1,
  SELECT = 0,
  HIGHLIGHT = 1,
  STRIKEOUT = 2,
  UNDERLINE = 3,
  FREETEXT = 4,
  RECTANGLE = 5,
  CIRCLE = 6,
  FREEHAND = 7,
  FREE_HIGHLIGHT = 8,
  SIGNATURE = 9,
  STAMP = 10,
  NOTE = 11,
  ARROW = 12,
  CLOUD = 13,
}

interface FormFieldValue {
  /** Internal field identifier */
  fieldId: string
  /** PDF field name */
  fieldName: string
  /** Field type */
  fieldType: FormFieldType
  /** Current value */
  value: string | boolean | string[]
}

type FormFieldType = 'text' | 'checkbox' | 'radio' | 'dropdown' | 'signature' | 'button'

interface FormFieldDefinition {
  id: string
  pageNumber: number
  fieldType: FormFieldType
  fieldName: string
  /** PDF user-space rect [x1, y1, x2, y2], bottom-left origin */
  rect: [number, number, number, number]
  readOnly: boolean
  required: boolean
  /** Where the field came from. Missing = 'parsed' for backward compat. */
  origin?: FormFieldOrigin
  /** For detected checkboxes */
  shapeType?: 'rectangle' | 'circle'
  /** Checkbox glyph style */
  checkboxStyle?: CheckboxStyle
  defaultValue?: string
  maxLen?: number
  multiLine?: boolean
  password?: boolean
  comb?: boolean
  exportValue?: string
  buttonValue?: string
  options?: { displayValue: string; exportValue: string }[]
  combo?: boolean
  multiSelect?: boolean
  editable?: boolean
  buttonLabel?: string
  /** Signature: placeholder text on the unsigned widget */
  promptText?: string
  /** Signature: lock other fields once signed */
  lockAction?: 'all' | 'include' | 'exclude'
  lockFieldNames?: string[]
  fontSize?: number
  fontName?: string
  color?: number[]
  backgroundColor?: number[]
  textAlignment?: number
  /** Opaque role tag for color-coding in form-edit mode */
  roleId?: string
}

type FormFieldOrigin = 'parsed' | 'detected' | 'placed'

type CheckboxStyle = 'check' | 'cross' | 'diamond' | 'circle' | 'star' | 'square'

interface AddFormFieldPayload {
  pageNumber: number
  fieldType: FormFieldType
  /** PDF user-space rect [x1, y1, x2, y2], bottom-left origin */
  rect: [number, number, number, number]
  /** Auto-generated when omitted. Multiple widgets sharing a fieldName
   *  + fieldType act as one PDF field; radios with the same fieldName
   *  form one option group. */
  fieldName?: string
  /** Opaque role tag for color-coding in form-edit mode */
  roleId?: string
  /** Default value. Used as the initial value, too. */
  defaultValue?: string
  readOnly?: boolean
  required?: boolean

  // checkbox
  checkboxStyle?: CheckboxStyle

  // signature
  promptText?: string
  lockAction?: 'all' | 'include' | 'exclude'
  lockFieldNames?: string[]

  // dropdown / listbox
  combo?: boolean
  multiSelect?: boolean
  options?: { displayValue: string; exportValue: string }[]

  // text
  multiLine?: boolean
  password?: boolean
  comb?: boolean
  maxLen?: number

  // radio (auto-generated when omitted)
  buttonValue?: string

  // appearance
  fontSize?: number
  fontName?: string
  /** RGB color tuple in 0–1 (PDF native) */
  color?: number[]
  /** RGB background color tuple in 0–1 (PDF native) */
  backgroundColor?: number[]
  /** 0 = left, 1 = center, 2 = right */
  textAlignment?: number
}

type ViewMode = 'fit-width' | 'fit-page' | 'fit-height'

interface IAnnotationComment {
  id: string
  title: string
  date: string
  content: string
  status?: CommentStatus
}

enum CommentStatus {
  Accepted = 'Accepted',
  Rejected = 'Rejected',
  Cancelled = 'Cancelled',
  Completed = 'Completed',
  None = 'None',
  Closed = 'Closed',
}

interface IAnnotationContentsObj {
  text: string
  image?: string  // Base64 encoded
}