nitro_kit 2.0.0.beta.1 → 2.0.0.beta.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d67fc8219f9c8cbf6259acdc75b07e0e8fdaf8a18aa6c3b2eb1dacad0e6604bb
-  data.tar.gz: 3e441a1ca6d97476940f5f2dc1989c3e37ee7a27972e73e5e028031e09ede35c
+  metadata.gz: d426e47dadcb1efcc115e21074c210e35c4120fca8c4093abf1cc5c431689ce4
+  data.tar.gz: 04e353250240db16067074982096a1753afd7ba45f0da04675cff2621e48ac50
 SHA512:
-  metadata.gz: 3c040398b479d8037f426c10cf215e78fbd0fe6e91a2ad17759eb6d907212ed3301e18caa4dd50048cf82476b8c6839f8dda9a0d3079efb004fd6a47083aa6ec
-  data.tar.gz: 361b9646f81a7a37719c3c274a0e423b0105734d872412f530f6dd23e3b12855325b5158924bb3ead1c6d1c60678f5dd9acb722068b84f918e548557d6e59d8d
+  metadata.gz: b2874c385257fbaeae559112addd4702d06b12b510eefcde84c8408f422ce54e7326329f27d2843b420245abbde08acf95aa68f4fd85c69041ca6b477350910a
+  data.tar.gz: 153c7c83078bc7521af05540b4750ac3e82b5e5f99da6255c3372c37fa6ef3d1a084aad094e72f45d7da89a06dc294eb249f569dc67d9d8bfa594213a99945f4

data/CHANGELOG.md

@@ -1,6 +1,60 @@
 # Changelog
 
-## Unreleased
+## 2.0.0.beta.2
+
+### Added
+
+- Redesign Card with `header`, `description`, and `actions` slots so call sites
+  stop hand-rolling headers and footers. `actions` inside a `header` trail the
+  title and description; inside a `footer` they push to the end.
+- Add Card `size: :sm | :md | :lg` density and `variant: :default | :muted |
+  :outline` surfaces, emitted as owned `data-size` and `data-variant`
+  attributes. Sizes coordinate padding, part gaps, corners, and title size.
+- Add explicit `nitro_kit:eject COMPONENT` source-level customization, with
+  isolated Ruby/CSS/Stimulus dependencies, version provenance, and safe whole-snapshot
+  skip behavior unless `--force` is requested.
+- Desktop AppShell sidebar rail with hover/focus overlay peek and an accessible
+  pin toggle, enabled with `collapsible: true`. The default sidebar stays
+  expanded without a toggle or peek behavior; `sidebar: :collapsed` starts an
+  opted-in sidebar unpinned.
+  Mobile keeps its native drawer, and reduced motion disables rail animation.
+- Align rail selection backgrounds and pin controls, keep peek surfaces opaque,
+  and isolate nested shells. `brand(icon:)` keeps a brand mark on the rail
+  without cropping the full logotype.
+- Unpinning with a pointer collapses the sidebar immediately; hover peek
+  resumes after the pointer first leaves the sidebar.
+- Synchronize sidebar panel, reserved content track, and selection-highlight
+  transitions so pinning and unpinning do not snap ahead of the animation.
+  Keep the pin control outside hover/focus peek so direct expansion starts
+  the panel and content transitions together.
+- Preserve client sidebar pin state and its accessible toggle state across
+  Turbo morph refreshes without persisting it across page loads.
+
+### Changed
+
+- Card titles scale with the card's own size instead of the shared
+  `--nk-title-surface-size` role, which now covers dialogs, sheets, empty
+  states, and fieldsets.
+- Give card sections set apart by a divider at the top or bottom edge even
+  spacing, fixing the uneven medium footer padding. Tables inside `full`
+  regions align with the card gutter, and a trailing footer stays on the
+  bottom edge of a card stretched by a Grid row.
+- Align StatGrid, DangerZone, and EmptyState panels with the card's padding
+  and corners.
+- Stop FieldGroup spacing from counting hidden inputs as neighbours.
+- Replace ghost menu triggers inside gallery cards with the default button
+  treatment and rebuild the card gallery around header, body, and footer
+  recipes.
+
+### Upgrade notes
+
+- Pin `2.0.0.beta.2` explicitly. Beta releases may still change APIs; review
+  release notes before updating.
+- Cards no longer read `--nk-title-surface-size`; a theme that tuned card
+  headings through that token should pick a card `size:` instead.
+- Review application-owned card headers and footers built from raw `Flex`
+  rows and move them onto `header`, `description`, and `actions`. Existing
+  copied or ejected source is not updated automatically by this gem release.
 
 ## 2.0.0.beta.1
 

data/README.md

@@ -6,7 +6,7 @@
 
 **Audience:** Rails developers evaluating or installing Nitro Kit.
 
-Nitro Kit is a gem-owned Phlex UI system for Rails. The `2.0.0.beta.1` prerelease
+Nitro Kit is a gem-owned Phlex UI system for Rails. The `2.0.0.beta.2` prerelease
 is under active testing and is not stable.
 
 [![RubyGems](https://img.shields.io/gem/v/nitro_kit.svg)](https://rubygems.org/gems/nitro_kit)
@@ -16,7 +16,7 @@ is under active testing and is not stable.
 Pin the prerelease:
 
 ```ruby
-gem "nitro_kit", "2.0.0.beta.1"
+gem "nitro_kit", "2.0.0.beta.2"
 ```
 
 ```sh
@@ -34,6 +34,7 @@ Start with:
 - [Rails integration](docs/rails_integration.md)
 - [Component contracts](docs/component_contracts.md)
 - [Customization](docs/customization.md)
+- [Eject a component into application-owned code](docs/eject.md)
 - [Browser support](docs/browser_support.md)
 - [Nitro Kit 1.x migration](docs/migration_1_to_2.md)
 - [Coding-agent guide](docs/agent_guide.md)
@@ -60,6 +61,19 @@ Set up Nitro Kit before planning or implementing the product:
 Maintaining Nitro Kit 1? Its frozen documentation remains at
 [v1.nitrokit.dev](https://v1.nitrokit.dev).
 
+## Eject for source-level customization
+
+Prefer tokens and composition. When you need to change a component's source:
+
+```sh
+bin/rails generate nitro_kit:eject Button
+```
+
+Render `Ui::EjectedButton::Button.new("Save")` and load `ejected_button.css`
+after `nitro_kit.css`. Ruby, CSS, and Stimulus dependencies become application-owned;
+keep the gem installed for the shared kernel and tokens. See [Eject](docs/eject.md)
+for integration, collision handling, and upgrade responsibilities.
+
 ## License
 
 Nitro Kit uses the custom [NitroKit License](LICENSE).

data/STYLE_GUIDE.md

@@ -73,7 +73,8 @@ test/dummy/app/components/gallery/ # Phlex gallery pages
 test/integration/                  # catalog-driven route coverage
 ```
 
-Do not add component helper modules or copied-component generators.
+Do not add component helper modules or default copy-install. The explicit
+user-requested eject generator is the sole copying exception; see `docs/eject.md`.
 
 ## Component anatomy
 
@@ -443,6 +444,7 @@ Every component includes:
 - Structural and component-specific accessibility assertions.
 - A gallery combination page with meaningful permutations.
 - Long, missing optional, disabled, validation/error, dark, and narrow-width examples where relevant.
+- An "Under pressure" example flagged `stress: true`, composed from `Gallery::Hostile`, that the stress sweep audits.
 - Behavior tests for interactive components.
 
 The gallery uses explicit Phlex page classes and `Gallery::Catalog`. Do not add ERB component examples or infer routes from filenames. Every `Gallery::Example` pairs Preview and Code tabs. Keep the preview in the block passed to the gallery helper so `Gallery::SourceCode` can extract, highlight, and copy its executable Ruby body; use a concrete method source for inherited flow wrappers instead of duplicating snippets.