Changes in version 1.0.0 (2025-12-08)                  

Initial CRAN Release

First public release of charisma - an R package for reproducible color
characterization of digital images for biological studies (and other
things).

Features

  - Automatic Color Classification: Classify image colors into one of 10
    discrete, biologically-inspired categories (black, blue, brown,
    green, grey, orange, purple, red, white, yellow)

  - CLUT System: Color Look-Up Table (CLUT) with scientifically-defined
    HSV boundaries for each color category, validated across 3.6+
    million color coordinates

  - Main Functions:
    
      - charisma(): Main color classification pipeline with automatic
        thresholding
      - charisma2(): Rewind and edit saved charisma objects without
        re-running full pipeline
      - color2label(): Convert individual RGB/HSV colors to discrete
        labels
      - validate(): Validate CLUT completeness across color space

  - Integration:
    
      - Leverages recolorize for image preprocessing and color
        segmentation
      - Optional pavo integration for color pattern geometry analysis
      - Supports both interactive and automated workflows

  - Reproducibility:
    
      - Complete state tracking with merge/replacement history
      - Save and reload analyses with full provenance
      - Deterministic color classification for cross-study comparisons

  - Visualization:
    
      - Plot methods for charisma objects
      - Mosaic plots showing color proportions
      - Color masks and classification overlays

Documentation

  - Comprehensive vignette with step-by-step tutorial
  - Example data from bird (Tangara fastuosa)
  - Tips for museum specimens and automated workflows
  - pkgdown website with full documentation

Testing

  - Unit tests covering main functions
  - Example workflows validated against published results
  - CLUT validation across full HSV color space