nitro_kit 2.0.0.beta.1 → 2.0.0.beta.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d67fc8219f9c8cbf6259acdc75b07e0e8fdaf8a18aa6c3b2eb1dacad0e6604bb
-  data.tar.gz: 3e441a1ca6d97476940f5f2dc1989c3e37ee7a27972e73e5e028031e09ede35c
+  metadata.gz: 84caf95e1c63e0461bef9e9a0183b67d02bf3c00fee964f0d0ee321a23b5457f
+  data.tar.gz: 9ebac7e5aa8f5cc74f4930838b0760a364eaebc7f1d9a01d99d8a15ce152b135
 SHA512:
-  metadata.gz: 3c040398b479d8037f426c10cf215e78fbd0fe6e91a2ad17759eb6d907212ed3301e18caa4dd50048cf82476b8c6839f8dda9a0d3079efb004fd6a47083aa6ec
-  data.tar.gz: 361b9646f81a7a37719c3c274a0e423b0105734d872412f530f6dd23e3b12855325b5158924bb3ead1c6d1c60678f5dd9acb722068b84f918e548557d6e59d8d
+  metadata.gz: 56d6151cb701d8254ee9671d900f8053ddcd023435b03157f590dbad2f5f283e489f4db54e34de122996006af532c725cd86cc0491d48810b17fa343e1654da4
+  data.tar.gz: 482fa5ddf8c57c09c3f7d6f3e4e607fcd125dcecf8ff23500474cb8926469e73c139a4126610bf4df7e59d37ada2ea47d38e2bcc462649a95248cf7009424ac1

data/CHANGELOG.md

@@ -1,6 +1,101 @@
 # Changelog
 
-## Unreleased
+## 2.0.0.beta.3
+
+### Added
+
+- Ship `app/assets/tailwind/nitro_kit/engine.css` for `tailwindcss-rails`
+  engine support, so a Tailwind CSS v4 application can `@import
+"../builds/tailwind/nitro_kit"` and load Nitro Kit through its single
+  compiled `tailwind` stylesheet. The engine keeps that entry out of the asset
+  pipeline, and `nitro_kit:doctor` and the installer expect only `tailwind`
+  when the import is present.
+
+### Changed
+
+- Fold the Tailwind CSS v4 adapter into `nitro_kit.css`. The distribution
+  stylesheet now opens with the global cascade-layer order and carries the
+  Tailwind theme aliases from `src/stylesheets/nitro_kit/tailwind.css`, so a
+  Tailwind application links `nitro_kit` then `tailwind` and nothing else.
+
+### Fixed
+
+- Replace the invalid `::file-selector-button:disabled` reset selector with
+  `:disabled::file-selector-button`, which Lightning CSS otherwise warns about
+  when the stylesheet goes through a Tailwind build.
+
+### Removed
+
+- The separate `nitro_kit-tailwind-v4.css` asset. Remove it from the layout's
+  `stylesheet_link_tag`; `nitro_kit:doctor` flags a leftover link.
+
+### Upgrade notes
+
+- Pin `2.0.0.beta.3` explicitly. Beta releases may still change APIs; review
+  release notes before updating.
+- Delete `"nitro_kit-tailwind-v4"` from every `stylesheet_link_tag`. The
+  `nitro_kit` stylesheet now provides the cascade-layer order and Tailwind
+  theme aliases itself, and must load before the compiled `tailwind`
+  stylesheet. Run `nitro_kit:doctor` to confirm the layout.
+- A `tailwindcss-rails` application can optionally collapse to one stylesheet:
+  add `@import "../builds/tailwind/nitro_kit";` above `@import "tailwindcss";`
+  in `app/assets/tailwind/application.css` and link only `tailwind`.
+
+## 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.3` 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.3"
 ```
 
 ```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
 
@@ -329,7 +330,7 @@ Before JavaScript connects, `:root` follows `prefers-color-scheme`. Explicit `[d
 
 Customization tools may read, preview, and export documented public tokens. Model customizer state as an immutable, explicitly versioned value object with closed named choices and readable URL parameters; never serialize an opaque arbitrary-token blob. Exports use stable selector and declaration ordering, cover light, dark, and system fallback, and contain only documented public variables. Structural preview choices may emit copyable component-composition examples, but never component implementations. Customization tools must not expose private `--_nk-*` values, edit the generated distribution asset, generate component copies, or turn arbitrary CSS into a Nitro contract.
 
-The optional `nitro_kit-tailwind-v4.css` adapter is a separate asset. It may map Nitro values into Tailwind v4 theme variables, but Tailwind compilation, source detection, and utilities remain application concerns. Do not add Tailwind as a Nitro runtime dependency.
+`src/stylesheets/nitro_kit/tailwind.css` declares the global cascade-layer order and maps Nitro values into Tailwind v4 theme variables so a compiled Tailwind stylesheet composes with the distribution asset. Tailwind compilation, source detection, and utilities remain application concerns. Do not add Tailwind as a Nitro runtime dependency.
 
 ## Baseline
 
@@ -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.