pub(all) suberror OfficeError {
  UnsupportedFileExtension(String)
  InvalidPackage(String)
  FormatMismatch(expected~ : DocumentFormat, actual~ : DocumentFormat)
  ResourceLimit(kind~ : String, limit~ : Int, actual~ : Int)
  Cancelled
} derive(Eq, 
@moonbitlang/core/debug.Debug
Debug)

pub(all) suberror SelectorError {
  SelectorError(code~ : String, offset~ : Int, input~ : String, message~ : String)
}

pub(all) struct CapabilityAction {
  name : String
  requires : Array[String]
  forbids : Array[String]
  restrictions : Array[String]
}

pub(all) struct CapabilityCommand {
  name : String
  summary : String
  usage : String
  formats : Array[String]
  aliases : Array[String]
  inputs : Array[CapabilityField]
  outputs : Array[CapabilityField]
  output_modes : Array[String]
  variants : Array[CapabilityVariant]
}

pub(all) struct CapabilityField {
  name : String
  type_name : String
  required : Bool
  description : String
}

pub(all) struct CapabilityFormat {
  name : String
  aliases : Array[String]
  description : String
  selector : CapabilitySelector
}

pub(all) struct CapabilitySelector {
  schema : String
  root : String
  status : String
  examples : Array[String]
  description : String
}

pub(all) struct CapabilityVariant {
  name : String
  usage : String
  result_schema : String
  registry : Json?
  inputs : Array[CapabilityField]
  outputs : Array[CapabilityField]
  constraints : Array[String]
  actions : Array[CapabilityAction]
  output_modes : Array[String]
}

pub struct CellAddress {
  column : Int
  row : Int
}

pub(all) enum DocumentFormat {
  Xlsx
  Docx
} derive(Eq, 
@moonbitlang/core/debug.Debug
Debug)

pub struct OfficeSelector {
  format : DocumentFormat
  segments : ReadOnlyArray[SelectorSegment]
  coordinate : SelectorCoordinate?
  stability : SelectorStability
}

pub(all) struct ProtocolError {
  code : String
  message : String
  details : Json?
}

pub(all) struct ProtocolWarning {
  code : String
  message : String
}

pub enum SegmentSelection {
  Position(Int)
  Key(String, String)
}

pub enum SelectorCoordinate {
  Cell(CellAddress)
  Range(CellAddress, CellAddress)
}

pub struct SelectorSegment {
  name : String
  selection : SegmentSelection?
}

pub enum SelectorStability {
  Stable
  SnapshotRelative
}

let SCHEMA_CAPABILITIES : String

let SCHEMA_CAPABILITY : String

let SCHEMA_DOCX_BATCH_RESULT : String

let SCHEMA_DOCX_CREATE_RESULT : String

let SCHEMA_DOCX_ELEMENT : String

let SCHEMA_DOCX_MATCHES : String

let SCHEMA_DOCX_OUTLINE : String

let SCHEMA_DOCX_QUERY : String

let SCHEMA_DOCX_TEXT : String

let SCHEMA_DUMP_RESULT : String

let SCHEMA_FINDING_RECORD : String

let SCHEMA_ISSUES_RESULT : String

let SCHEMA_PREVIEW_RESULT : String

let SCHEMA_RAW_CHANGE : String

let SCHEMA_RAW_INVENTORY : String

let SCHEMA_RAW_PART : String

let SCHEMA_RAW_RESULT : String

let SCHEMA_REPLAY_RESULT : String

let SCHEMA_TEMPLATE_RESULT : String

let SCHEMA_TRANSACTION : String

let SCHEMA_VALIDATE_RESULT : String

let SCHEMA_XLSX_BATCH_RESULT : String

let SCHEMA_XLSX_CREATE_RESULT : String

let SCHEMA_XLSX_ELEMENT : String

let SCHEMA_XLSX_OUTLINE : String

let SCHEMA_XLSX_QUERY : String

let SCHEMA_XLSX_TEXT : String

let SELECTOR_MAX_DEPTH : Int

let SELECTOR_MAX_LENGTH : Int

let SELECTOR_MAX_NAME_LENGTH : Int

let SELECTOR_MAX_SELECTIONS : Int

let SELECTOR_MAX_VALUE_LENGTH : Int

let XLSX_TRANSACTION_MAX_CANDIDATE_ARCHIVE_BYTES : Int

let XLSX_TRANSACTION_MAX_CANDIDATE_ENTRY_BYTES : Int

let XLSX_TRANSACTION_MAX_DECODED_XML_BYTES : Int

let XLSX_TRANSACTION_MAX_MATERIALIZED_CELLS : Int

let XLSX_TRANSACTION_MAX_ROW_COLUMN_LINES : Int

let XLSX_TRANSACTION_MAX_XML_MARKUP_TOKENS : Int

fn capabilities_data(format? : DocumentFormat, operation? : String) -> Json

fn capability_commands() -> Array[CapabilityCommand]

fn capability_fingerprint() -> String

fn capability_formats() -> Array[CapabilityFormat]

fn capability_records(format? : DocumentFormat, operation? : String) -> Array[Json]

fn detect_archive_format(path : StringView, archive : 
@moonbit-community/flate/zip.Archive
Archive, max_xml_part_bytes? : Int, max_xml_total_units? : Int, cancelled? : () -> Bool) -> DocumentFormat raise OfficeError

fn detect_format(path : StringView, data : BytesView, max_package_bytes? : Int, max_archive_entries? : Int, max_entry_uncompressed_bytes? : Int, max_total_uncompressed_bytes? : Int, max_xml_part_bytes? : Int, max_xml_total_units? : Int, cancelled? : () -> Bool) -> DocumentFormat raise OfficeError

fn find_capability_command(value : StringView) -> CapabilityCommand?

fn output_failure(error : ProtocolError, warnings? : Array[ProtocolWarning]) -> Json

fn output_success(data : Json, warnings? : Array[ProtocolWarning]) -> Json

fn parse_selector(source : String) -> OfficeSelector raise SelectorError

fn protocol_error(code : String, message : String, details? : Json) -> ProtocolError

fn protocol_warning(code : String, message : String) -> ProtocolWarning

fn resolve_format_alias(value : StringView) -> DocumentFormat?

fn selector_for_xlsx_cell(sheet_name : String, address : String) -> OfficeSelector raise SelectorError

fn selector_for_xlsx_range(sheet_name : String, range : String) -> OfficeSelector raise SelectorError

fn selector_for_xlsx_sheet(sheet_name : String) -> OfficeSelector raise SelectorError

fn selector_for_xlsx_workbook() -> OfficeSelector raise SelectorError

fn selector_from_docx_projection_path(path : String) -> OfficeSelector raise SelectorError

fn sha256_hex(data : BytesView) -> String