Release v0.7.0

Author: bradgessler

CHANGELOG.md

@@ -1,26 +1,30 @@
-## [Unreleased]
+## [0.7.0] - 2026-03-01
 
 ### Added
 
 - **Radio and checkbox groups** via `Field(:plan).radios(...)` and `Field(:roles).checkboxes(...)`.
-  Now return renderable Phlex components (like `input`, `select`) so they work as one-liners
+  Return renderable Phlex components (like `input`, `select`) so they work as one-liners
   via Kit. Without a block, renders default `<label><input> Text</label>` markup per choice.
-  With a block, yields each `Choice` for custom markup — choice methods (`.input`,
-  `.label`) render directly into the component's output. Accepts the same option formats as
+  With a block, yields each `Choice` for custom markup — `choice.input` and
+  `choice.label` render directly into the component's output. Accepts the same option formats as
   `select`. Auto-detects Rails enums when called with no arguments.
   `choice.label` without a block defaults to rendering `choice.text`.
+  Subclass `Components::Radios` or `Components::Checkboxes` to customize defaults.
 - **Hash options** for `select`, `radios`, and `checkboxes` — e.g. `radios(1 => "Basic", 2 => "Pro")`.
 - **Radio component** with `field(:gender).radio("male")` API. Automatically handles name, value, and checked state. Each radio gets a unique DOM id based on its value (e.g. `user_gender_male`).
 - **Checkbox collection support** — three modes:
   - **Boolean** (on/off toggle): `Field(:featured).checkbox` renders with hidden "0" input
   - **All-options** (pick from known set): `Field(:role_ids).checkbox(value: role.id)` with `[]` name and unique ids per value
   - **Field collection** (from existing array): `field(:role_ids).collection { |r| r.checkbox }` for values already on the model
+- **Choices module** (`Superform::Rails::Choices`) — `Choices::Choice` holds per-option state,
+  `Choices::Mapper` (renamed from `OptionMapper`) maps option args to `(value, text)` pairs.
 - **Unique DOM ids** for radio and checkbox groups via `DOM#id(*suffixes)`. Prevents duplicate ids in valid HTML and allows labels to target individual inputs.
 - **Select improvements**: blank options (`nil`) at any position, `multiple: true` support with hidden input for empty submissions, ActiveRecord relations as options.
 - **Preview server** — run `bin/preview` to view example forms at localhost:3000 with hot-reloading.
 
 ### Changed
 
+- `OptionMapper` renamed to `Choices::Mapper`. If you referenced `Superform::Rails::OptionMapper` directly, update to `Superform::Rails::Choices::Mapper`.
 - **Deprecation**: Components now accept HTML attributes as keyword arguments directly instead of wrapping them in `attributes:`. The old `attributes:` keyword still works but emits a deprecation warning and will be removed in a future version.
 
   ```ruby

lib/superform/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Superform
-  VERSION = "0.6.1"
+  VERSION = "0.7.0"
 end