pub(all) struct DigestGroup {
  digest : String
  paths : Array[String]
  bytes : Int64
}

pub(all) struct ExtensionStats {
  extension : String
  count : Int
  readable : Int
  unreadable : Int
  bytes : Int64
}

pub(all) struct ImageInfo {
  width : Int
  height : Int
  luminance : Int
  red : Int
  green : Int
  blue : Int
}

pub(all) struct InventorySummary {
  total : Int
  readable : Int
  unreadable : Int
  bytes : Int64
  minimum_size : Int
  maximum_size : Int
  average_size : Int64
  landscape : Int
  portrait : Int
  square : Int
  unknown_dimensions : Int
  pixels : Int64
  duplicate_file_groups : Int
  duplicate_files : Int
}

pub(all) enum Kind {
  Exact
  Similar
  Conflict
  New
  Unreadable
} derive(Eq)

pub(all) struct Photo {
  path : String
  name : String
  digest : String
  fingerprint : String?
  size : Int
  image_info : ImageInfo?
}

pub(all) struct PlanSummary {
  total : Int
  exact : Int
  similar : Int
  conflict : Int
  new_count : Int
  unreadable : Int
  copyable : Int
  needs_review : Int
  selected_by_default : Int
  total_bytes : Int64
  copyable_bytes : Int64
  review_bytes : Int64
}

pub(all) struct ReviewPage {
  rows : Array[ReviewRow]
  total_matches : Int
  offset : Int
  page_size : Int
  page_count : Int
  has_previous : Bool
  has_next : Bool
}

pub(all) struct ReviewQuery {
  text : String
  kind : Kind?
  minimum_size : Int?
  maximum_size : Int?
  sort : ReviewSort
  offset : Int
  page_size : Int
}

pub(all) struct ReviewRow {
  path : String
  name : String
  digest : String
  kind : Kind
  match_path : String?
  similarity_distance : Int?
  destination : String?
  size : Int
  image_info : ImageInfo?
}

pub(all) enum ReviewSort {
  PathAscending
  NameAscending
  SizeDescending
  SimilarityAscending
  CategoryThenPath
} derive(Eq)

pub(all) struct SimilarityGroup {
  paths : Array[String]
  pair_count : Int
  minimum_distance : Int
  maximum_distance : Int
}

pub(all) struct SimilarityGroupsSummary {
  groups : Int
  members : Int
  pairs : Int
  largest_group : Int
}

pub(all) struct SimilarityHit {
  path : String
  name : String
  digest : String
  distance : Int
}

pub struct SimilarityIndex {
  max_distance : Int
  entries : Array[Photo]
  buckets64 : Array[Map[String, Array[Int]]]
  buckets176 : Array[Map[String, Array[Int]]]
}

pub(all) enum SizeBand {
  Under256KiB
  From256KiBTo1MiB
  From1MiBTo8MiB
  From8MiBTo32MiB
  AtLeast32MiB
} derive(Eq)

pub(all) struct SizeBandStats {
  band : SizeBand
  count : Int
  bytes : Int64
}

fn analyze_image(data : Bytes, extension : String) -> (String, ImageInfo)?

fn build_plan(existing : Array[Photo], incoming : Array[Photo], similar_limit? : Int) -> Array[ReviewRow]

fn csv_field(value : String) -> String

fn default_review_query() -> ReviewQuery

fn duplicate_digest_groups(photos : Array[Photo]) -> Array[DigestGroup]

fn extension_summary(photos : Array[Photo]) -> Array[ExtensionStats]

fn extension_summary_csv(items : Array[ExtensionStats]) -> String

fn find_similarity_group(groups : Array[SimilarityGroup], path : String) -> SimilarityGroup?

fn fingerprint(data : Bytes, extension : String) -> String?

fn format_bytes(bytes : Int64) -> String

fn hamming_distance(a : String, b : String) -> Int

fn image_info_label(info : ImageInfo) -> String

fn image_review_notes(info : ImageInfo) -> Array[String]

fn inventory_json(summary : InventorySummary, extensions : Array[ExtensionStats], size_bands : Array[SizeBandStats]) -> String

fn inventory_summary(photos : Array[Photo]) -> InventorySummary

fn json_string(value : String) -> String

fn new_similarity_index(max_distance : Int) -> SimilarityIndex

fn normalized_extension(name : String) -> String

fn plan_summary(rows : Array[ReviewRow]) -> PlanSummary

fn query_review_rows(rows : Array[ReviewRow], query : ReviewQuery) -> ReviewPage

fn review_page_number(offset : Int, page_size : Int) -> Int

fn review_page_start(page_number : Int, page_size : Int) -> Int

fn review_rows_csv(rows : Array[ReviewRow]) -> String

fn review_rows_json(rows : Array[ReviewRow]) -> String

fn similarity_groups(photos : Array[Photo], limit : Int) -> Array[SimilarityGroup]

fn similarity_groups_csv(groups : Array[SimilarityGroup]) -> String

fn similarity_groups_json(groups : Array[SimilarityGroup]) -> String

fn similarity_groups_summary(groups : Array[SimilarityGroup]) -> SimilarityGroupsSummary

fn similarity_pairs_csv(pairs : Array[(String, String, Int)]) -> String

fn size_band(size : Int) -> SizeBand

fn size_distribution(photos : Array[Photo]) -> Array[SizeBandStats]