intl

# Changelog

All notable changes to this project will be documented in this file.

This project follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [1.0.0] - 2026-07-31

### Changed

* Requires `localize ~> 1.0`.

## [1.0.0-rc.1] - 2026-07-28

Requires Localize `~> 1.0-rc.7`.

### Changed

* `Intl.DurationFormat` joins duration parts with the CLDR unit list pattern matching the format width, per ECMA-402, instead of an "and" conjunction. `:en` now renders "2 hours, 30 minutes" (was "2 hours and 30 minutes") and "2h 30m" for `style: :narrow`.

* `Intl.supported_values_of(:unit)` returns a flat sorted list of unit names instead of a map of units grouped by category, matching its `@spec` and the shape the other keys return.

### Added

* `Intl.DisplayNames.of/2` accepts the JS `dateTimeField` names `:week_of_year` and `:time_zone_name` (and the `"weekOfYear"` / `"timeZoneName"` strings) alongside Localize's `:week` and `:zone`.

### Fixed

* `Intl.DurationFormat` per-unit style options (`hours: :narrow`) are applied again; Localize 1.0.0-rc.7 renamed the underlying per-unit width option from `:styles` to `:formats`, and the old key was silently ignored.

* `Intl.NumberFormat` accepts an atom as the `:unit` option rather than raising `FunctionClauseError`, and returns an error tuple for a unit that is neither a string nor an atom.

* `Intl.supported_values_of(:collation)` excludes `"standard"` and `"search"` from the returned collation values, per ECMA-402 `supportedValuesOf`.

## [1.0.0-rc.0] - 2026-07-23

### Added

* `Intl.NumberFormat.format_to_parts/2` and `format_to_parts!/2` return typed parts per JS `formatToParts()`, for all styles including `:unit` and `currency_display: :name`.

* `Intl.NumberFormat.format_range_to_parts/3` and `format_range_to_parts!/3` implement JS `formatRangeToParts()` with `:source` tagging (`:start_range`, `:end_range`, `:shared`).

* `Intl.NumberFormat.format_range/3` supports `style: :unit`: the unit pattern is applied once to the range ("2–5 kilometers") with the TR35 plural-range category.

* `Intl.DateTimeFormat.format_to_parts/2` and `format_to_parts!/2` implement JS `formatToParts()` across styles, component skeletons, and combined date+time wrappers.

* `Intl.DateTimeFormat.format_range_to_parts/3` and `format_range_to_parts!/3` implement JS `formatRangeToParts()` with `:source` tagging.

* `Intl.DateTimeFormat.format/2` supports the `:numbering_system` option: any CLDR numbering system renders all numeric fields.

* `Intl.DurationFormat.format_to_parts/2` and `format_to_parts!/2` implement JS `formatToParts()`; numeric parts carry a `:unit` key.

* `Intl.NumberFormat.format_range_to_parts/3` supports `style: :unit`, completing range parts for all styles.

* `Intl.Segmenter.segment_with_metadata/2` and `segment_with_metadata!/2` mirror the JS segment objects: `:segment`, `:index` (byte offset), and `:word_like?` (the JS `isWordLike`, via `Unicode.String.word_like?/1`).

* `Intl.DateTimeFormat.format/2` supports the `:fractional_second_digits` component option (1–3 digits).

* `Intl.ListFormat.format_to_parts/2` and `format_to_parts!/2` implement JS `formatToParts()` with `:element` and `:literal` parts.

* `Intl.RelativeTimeFormat.format_to_parts/3` and `format_to_parts!/3` implement JS `formatToParts()`; the `:integer` part carries a `:unit` key.

* `Intl.DurationFormat.format/2` supports the JS per-unit style options (`:hours`, `:minutes`, …) and per-unit display options (`:hours_display`, …, `:auto` or `:always`).

* `Intl.NumberFormat.format/2` supports `:minimum_integer_digits`, `:trailing_zero_display` (`:strip_if_integer`), and `:rounding_priority` (`:more_precision`, `:less_precision`).

* `Intl.DateTimeFormat.format/2` supports the `:era`, `:day_period`, `:time_zone_name`, `:hour12`, and `:hour_cycle` component options.

* `Intl.PluralRules.select_range/3` and `select_range!/3` implement JS `selectRange()` using the CLDR plural-ranges data.

* `Intl.Collator` supports `:usage` (`:sort`, `:search`) and `:collation` (`:phonebook`, `:pinyin`, `:emoji`, …).

* `Intl.supported_locales_of/1` implements the JS `supportedLocalesOf()` static methods as one top-level function.

* `Intl.supported_values_of/1` supports `:collation` and `:time_zone`, completing the JS `supportedValuesOf()` key set.

* `Intl.RelativeTimeFormat.format/3` honours `numeric: :always`, forcing "1 day ago" instead of "yesterday".

### Changed

* Localize 1.0.0-rc.3 or later is required.

* `currency_display: :name` applies the currency's fraction digits ("1,234.50 US dollars", previously "1,234 US dollars"), matching JS.

* With the default `rounding_priority: :auto`, a significant-digit bound causes fraction-digit bounds to be ignored entirely, per ECMA-402.

* Relative time offsets of zero format with the future pattern ("in 0 days") per ECMA-402.

### Fixed

* `Intl.DateTimeFormat` component options (`:year`, `:month`, `:day`, …) now match a locale format. Previously the generated skeleton was passed as a literal pattern, rendering without locale separators ("2025March15" instead of "March 15, 2025").

## [0.3.0] - 2026-07-22

### Added

* `Intl.NumberFormat.format/2` supports `notation: :scientific` and `notation: :engineering`.

* `Intl.NumberFormat.format/2` supports `:currency_display` (`:symbol`, `:narrow_symbol`, `:code`, `:name`) and `:currency_sign` (`:standard`, `:accounting`).

* `Intl.NumberFormat.format/2` supports `:use_grouping` (`:always`, `:auto`, `:min2`, `true`, `false`), mapped to Localize `:minimum_grouping_digits`.

* `Intl.NumberFormat.format/2` supports `:minimum_significant_digits`, `:maximum_significant_digits`, `:numbering_system`, and `:rounding_increment`.

* `Intl.NumberFormat.format/2` supports `:sign_display` (`:auto`, `:always`, `:except_zero`, `:negative`, `:never`) mirroring the JS `signDisplay` option.

* `:numbering_system` accepts any valid CLDR numbering system for any locale, including algorithmic systems, and `-u-nu-` locale extensions are honoured.

* `Intl.NumberFormat.format_range/3` supports the `:currency` and `:percent` styles in addition to `:decimal`.

### Changed

* Localize 1.0.0-rc.0 or later is required. Compact notation now applies the ECMA-402 default precision of at most two significant digits ("1.2K" for 1234), matching JS.

* Negative currency amounts render the sign before the symbol ("-$1.00", previously "$-1.00"), matching JS `Intl.NumberFormat`.

* `Intl.DurationFormat` translates its `:style` option to the Localize `:format` option, following the Localize 0.43 rename.

### Fixed

* `Intl.NumberFormat.format/2` returns `{:error, %ArgumentError{}}` for invalid `:style`, `:notation`, or `:compact_display` values instead of raising `CaseClauseError`.

## [0.2.0] - 2025-05-12

### Bug Fixes

* Relax the dependency requirement for `localize` to be "~> 0.31 or ~> 1.0".

## [0.1.0] - 2025-04-16

### Highlights

Initial release of `Intl`, an Elixir interface modelled on the JavaScript Intl API.

This library provides a familiar API for developers who know JS Intl, adapted to idiomatic Elixir conventions. It delegates to the `Localize` library for all locale-aware formatting and data access.

Supported modules:

* `Intl.NumberFormat` — locale-aware number, currency, percent, and unit formatting.

* `Intl.DateTimeFormat` — locale-aware date and time formatting with range support.

* `Intl.ListFormat` — list joining with conjunctions, disjunctions, or unit separators.

* `Intl.DisplayNames` — localized names for regions, languages, currencies, scripts, calendars, and date-time fields.

* `Intl.RelativeTimeFormat` — relative time strings ("3 days ago", "in 2 hours").

* `Intl.PluralRules` — CLDR plural category selection (cardinal and ordinal).

* `Intl.Collator` — locale-aware string comparison and sorting via the Unicode Collation Algorithm.

* `Intl.DurationFormat` — locale-aware duration formatting.

* `Intl.Segmenter` — text segmentation into graphemes (built-in), words, and sentences (via optional `unicode_string` dependency).

See the [README](https://github.com/elixir-cldr/intl/blob/v0.1.0/README.md) for usage examples and the [compatibility matrix](https://github.com/elixir-cldr/intl/blob/v0.1.0/compatibility.md) for a detailed comparison with the JS Intl API.