# NDPalette 1.0.0

* First stable release.

* `nd_informal_tints` provides six informal soft backgrounds (**not**
  Notre Dame brand colors), from the lightest tint to the warmest soft
  yellow: `faint_white` (`#fdfcfa`), `soft_white` (`#faf7f1`),
  `faint_yellow` (`#fefdf3`), `soft_yellow_light` (`#fdf9e6`), `soft_yellow`
  (`#faf3d7`), and `soft_yellow_warm` (`#f6edc6`). The two `faint_*` tints
  sit just off pure white (CIE L* about 99) for the lightest touch.

* The `"nd"` data palette holds Metallic Gold at the sixth position, after
  Dark Sky Blue, so the two golds (Bright Gold and Metallic Gold) are not
  paired until a plot has six or more groups.

* The colorblind palette is now built from Notre Dame's own colors. The
  borrowed Okabe-Ito palette has been **removed** (`palette = "okabe_ito"`
  no longer resolves) and replaced by `palette = "nd_cvd"` (aliases
  `"colorblind"`, `"cvd"`): a colorblind-friendly ordering of the actual
  Notre Dame colors, derived by a greedy search that maximizes the
  worst-case CIE-Lab Delta-E across simulated deuteranopia, protanopia,
  and tritanopia. The ten anchors stay distinguishable for two through ten
  categories and lead with the CVD-safe ND Blue + Bright Gold pair.
  `nd_palettes` is now `nd`, `nd_cvd`, and `former`.

* `scale_color_nd()`, `scale_fill_nd()`, and `scale_colour_nd()` gain a
  `palette` argument, so the colorblind-friendly or former palettes apply
  to a plot the same way as the default, e.g.
  `scale_color_nd(palette = "nd_cvd")`.

* `nd_colors` now catalogs three additional current secondary brand
  colors from the University palette: Medium Blue (`#143865`), Dark Gold
  (`#8c7535`), and Light Green (`#b3dac5`), reachable with `nd_color()`.
  The full set of official colors on the University branding page is now
  represented. `nd_colors` also gains a `description` column: a short
  plain-language note on each color's tier and hue. It is most useful for
  the seven former colors, whose keys give the hue but not the tier — six
  were former *secondary* colors and `purple` was the lone former
  *tertiary* color.

* The R Markdown stylesheet (`nd_css()`) now uses Warm White (`#efe9d9`)
  as the page background instead of a near-white, for a softer page.

* `nd_css()` gains a `web_fonts` argument. `nd_css(web_fonts = TRUE)` adds a
  Google Fonts import for two open-source typefaces close in feel to the
  brand fonts (Montserrat for body text, Zilla Slab for headings); the
  default stays offline with a system font stack.

* The main vignette now opens with a quick start covering every workflow
  the easy way --- `ggplot2`, base R graphics, R Markdown, and Shiny --- so
  the default colors are one step away with no manual color picking. It also
  adds a base R graphics section, a section on mixing in a color from
  outside the palette, and a section on theming R Markdown reports.

* New vignette *Theming a Shiny app with NDPalette*, plus two runnable
  example apps under `inst/examples/`: `nd-shiny-app` (a palette explorer)
  and `nd-smd-app` (the book's Standardized Mean Difference app, rebuilt on
  the DMAR package and themed with NDPalette; running it needs DMAR).

# NDPalette 0.1.0

* Initial version.

* `nd_palette()` returns colors from the Notre Dame brand palette
  (`"nd"`, the default), the Okabe-Ito colorblind-safe palette
  (`"okabe_ito"`), or the seven former Notre Dame brand colors
  (`"former"`). The `"nd"` palette leads with six Notre Dame brand
  colors that read clearly on a white background (navy, bright gold,
  green, bright blue, metallic gold, and dark sky blue) and extends
  through the seven former Notre Dame brand colors, thirteen anchors in
  all, interpolating beyond thirteen. The
  warm whites and the medium and light sky-blue tints are excluded and
  never emitted.

* `ggplot2` scales `scale_color_nd()`, `scale_fill_nd()`, and the
  British-spelling alias `scale_colour_nd()` apply the `"nd"` palette to
  the `colour` and `fill` aesthetics.

* `show_palette()` draws a row of color swatches to preview any
  palette, defaulting to the full Notre Dame set. Swatches can be
  labeled with their hexadecimal values (the default), left unlabeled,
  or labeled with readable names passed as a character vector.

* `nd_palettes`, a named list of the three fixed anchor palettes
  (thirteen Notre Dame colors, eight Okabe-Ito colors, and the seven
  former Notre Dame colors), is exported for tools and users that want
  the raw hexadecimal anchors.

* `nd_colors`, a data frame cataloging every Notre Dame color the
  package knows about with its brand (University or Athletics) and role
  (primary, secondary, former, tint, or neutral), is exported as a
  reference, and `nd_color()` looks up hex values from it by name or by
  role. The Athletics colors (a shared blue, the dome golds, and Irish
  Green) are reference only and never enter `nd_palette()` or the scales.

* `nd_tints`, a named vector of the four near-white Notre Dame brand
  tints (warm white, light warm white, medium sky blue, and light sky
  blue), is exported for backgrounds, fills, and the light end of
  sequential brand ramps. These tints are too light to read as data
  colors on white and are never returned by `nd_palette()`.

* `nd_css()` builds a Notre Dame R Markdown stylesheet from the package
  colors, so an HTML report and its plots carry one brand palette and
  cannot drift apart. `nd_css_path()` returns the copy shipped with the
  package (for the YAML `css` field), and `html_nd_document()` is an R
  Markdown output format that applies it.
