nitro_kit 2.0.0.alpha.5 → 2.0.0.beta.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (33) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +33 -0
  3. data/README.md +2 -2
  4. data/STYLE_GUIDE.md +2 -2
  5. data/app/assets/stylesheets/nitro_kit.css +298 -115
  6. data/app/components/nitro_kit/app_shell.rb +1 -1
  7. data/app/components/nitro_kit/dialog.rb +5 -3
  8. data/app/components/nitro_kit/dropzone.rb +18 -2
  9. data/app/components/nitro_kit/form_builder.rb +2 -0
  10. data/app/javascript/controllers/nk/dropzone_controller.js +20 -0
  11. data/docs/agent_guide.md +5 -0
  12. data/docs/component_contracts.md +53 -47
  13. data/docs/customization.md +3 -4
  14. data/docs/hotwire.md +2 -2
  15. data/docs/migration_1_to_2.md +1 -1
  16. data/docs/patterns/application_foundation.md +20 -2
  17. data/docs/patterns/crud_resource.md +19 -4
  18. data/docs/patterns/destructive_action.md +31 -17
  19. data/docs/patterns/inset_workspace.md +178 -0
  20. data/docs/patterns/queryable_collection.md +104 -44
  21. data/docs/patterns/resource_form.md +16 -12
  22. data/docs/rails_integration.md +1 -1
  23. data/lib/nitro_kit/version.rb +1 -1
  24. data/plugins/nitro-kit/skills/nitro-kit-hotwire/SKILL.md +6 -1
  25. data/plugins/nitro-kit/skills/nitro-kit-rails/SKILL.md +1 -1
  26. data/plugins/nitro-kit/skills/nitro-kit-ui/SKILL.md +10 -2
  27. data/src/stylesheets/nitro_kit/components/app_shell.css +1 -19
  28. data/src/stylesheets/nitro_kit/components/dialog.css +18 -1
  29. data/src/stylesheets/nitro_kit/components/dropzone.css +276 -72
  30. data/src/stylesheets/nitro_kit/components/pagination.css +1 -12
  31. data/src/stylesheets/nitro_kit/components/table.css +2 -1
  32. data/src/stylesheets/nitro_kit/components/toolbar.css +0 -10
  33. metadata +2 -1
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 2f703b97ad2c84b8c66a306453dd1070554fe7c45f994a36672639af781856ed
4
- data.tar.gz: 9343dd1db39ec96141f560eeebf0edd873d3b68960a36ffdc0abe413b0b66491
3
+ metadata.gz: d67fc8219f9c8cbf6259acdc75b07e0e8fdaf8a18aa6c3b2eb1dacad0e6604bb
4
+ data.tar.gz: 3e441a1ca6d97476940f5f2dc1989c3e37ee7a27972e73e5e028031e09ede35c
5
5
  SHA512:
6
- metadata.gz: 13e10affc36f849b140ee76f99fb6c7ce4403767d1b2da3a20decb2d15fbcc898bf725b637db7d1f2476c7fd12059e4ffb4449a137309253119de03eb18450a6
7
- data.tar.gz: 4889ff8fdd803acfb652511c0938247a5edc0e1ead51687c5ed97966bf2493038def6d2d34b91a1b498310d78c62390ab29cee5fce3763393e9aa01f986263e0
6
+ metadata.gz: 3c040398b479d8037f426c10cf215e78fbd0fe6e91a2ad17759eb6d907212ed3301e18caa4dd50048cf82476b8c6839f8dda9a0d3079efb004fd6a47083aa6ec
7
+ data.tar.gz: 361b9646f81a7a37719c3c274a0e423b0105734d872412f530f6dd23e3b12855325b5158924bb3ead1c6d1c60678f5dd9acb722068b84f918e548557d6e59d8d
data/CHANGELOG.md CHANGED
@@ -2,6 +2,39 @@
2
2
 
3
3
  ## Unreleased
4
4
 
5
+ ## 2.0.0.beta.1
6
+
7
+ ### Changed
8
+
9
+ - Promote Nitro Kit 2 to beta after application evals and real-project review.
10
+ - Update installation examples and public contracts to pin the beta release.
11
+ - No component runtime or API changes from 2.0.0.alpha.6.
12
+
13
+ ### Upgrade notes
14
+
15
+ - Pin `2.0.0.beta.1` explicitly. Beta releases may still change APIs; review
16
+ release notes before updating. Nitro Kit 1 applications require migration.
17
+
18
+ ## 2.0.0.alpha.6
19
+
20
+ ### Changed
21
+
22
+ - Simplify application shells and responsive resource layouts, with clearer
23
+ guidance on page widths and application-owned spacing.
24
+ - Default full-page search, filtering, and pagination to Turbo Drive with
25
+ normal history and caching behavior.
26
+ - Improve dialog composition: reset inherited text alignment, keep the close
27
+ control clear of content, and document explicit Cancel actions.
28
+ - Improve upload and mobile gallery examples and resource form compositions.
29
+
30
+ ### Upgrade notes
31
+
32
+ - Use the documented dialog header/body/footer composition and add a visible
33
+ Cancel action when a confirmation needs one; the corner close control is
34
+ separate.
35
+ - Review application-owned pages for unnecessary width limits. Existing
36
+ copied source is not updated automatically by this gem release.
37
+
5
38
  ## 2.0.0.alpha.5
6
39
 
7
40
  ### Added
data/README.md CHANGED
@@ -6,7 +6,7 @@
6
6
 
7
7
  **Audience:** Rails developers evaluating or installing Nitro Kit.
8
8
 
9
- Nitro Kit is a gem-owned Phlex UI system for Rails. The `2.0.0.alpha.5` prerelease
9
+ Nitro Kit is a gem-owned Phlex UI system for Rails. The `2.0.0.beta.1` prerelease
10
10
  is under active testing and is not stable.
11
11
 
12
12
  [![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.
16
16
  Pin the prerelease:
17
17
 
18
18
  ```ruby
19
- gem "nitro_kit", "2.0.0.alpha.5"
19
+ gem "nitro_kit", "2.0.0.beta.1"
20
20
  ```
21
21
 
22
22
  ```sh
data/STYLE_GUIDE.md CHANGED
@@ -379,7 +379,7 @@ Every responsive property accepts either one scalar or its own whitespace-separa
379
379
 
380
380
  Application shells own responsive chrome, not application policy. Every shell has exactly one navigation tree and one main region, plus optional unique brand and topbar regions. Account actions compose inside the topbar. Navigation uses named header, body, section, footer, spacer, divider, and item parts. Keep product routes and current-destination policy in the caller, and use native navigation and landmark elements.
381
381
 
382
- Nitro owns the shell breakpoint, fixed/sticky placement, overscroll background, independent navigation scrolling, and narrow-screen disclosure behavior. Sidebar places brand/navigation in a sticky desktop sidebar; topbar places brand/navigation/actions in a sticky desktop header; hybrid combines sidebar navigation with the header. All three reflow the one navigation tree into the narrow drawer. Do not add arbitrary breakpoint, sticky-region, or route-registry options. Reflect open state through ARIA and `data-state`; expose a skip link and labelled landmarks; trap, move, and restore focus for the narrow drawer; close on Escape, backdrop, outside activation, and Turbo navigation; and release inert state, scroll locks, and listeners on disconnect. Visible desktop navigation must not retain drawer semantics, `inert`, or `aria-hidden`. Keep shell-specific public tokens semantic and limited to canvas/sidebar colors, border, sidebar width, and topbar height.
382
+ Nitro owns the shell breakpoint, fixed/sticky placement, overscroll background, independent navigation scrolling, and narrow-screen disclosure behavior. Sidebar combines a left navigation rail with the page toolbar above the content; topbar places navigation in a horizontal header with page actions below it. Both reflow the one navigation tree into the narrow drawer. Do not add arbitrary breakpoint, sticky-region, or route-registry options. Reflect open state through ARIA and `data-state`; expose a skip link and labelled landmarks; trap, move, and restore focus for the narrow drawer; close on Escape, backdrop, outside activation, and Turbo navigation; and release inert state, scroll locks, and listeners on disconnect. Visible desktop navigation must not retain drawer semantics, `inert`, or `aria-hidden`. Keep shell-specific public tokens semantic and limited to canvas/sidebar colors, border, sidebar width, and topbar height.
383
383
 
384
384
  ## Rails forms
385
385
 
@@ -447,7 +447,7 @@ Every component includes:
447
447
 
448
448
  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.
449
449
 
450
- Complete application examples combine shells, navigation, forms, tables, uploads, images, and overlays in sidebar, topbar, and hybrid layouts. Appearance coverage includes zero, one, and multiple pickers; light, dark, cross-tab updates, and live system preference changes. Theme coverage proves the contract rather than a tool: the documented token set, the set declared in `tokens.css`, and the set the bundled stylesheet serves are the same set, component CSS consumes only declared public tokens, and scoped `--nk-*` overrides on an application-owned wrapper reach Nitro descendants through inheritance.
450
+ Complete application examples combine shells, navigation, forms, tables, uploads, images, and overlays in sidebar and topbar layouts. Appearance coverage includes zero, one, and multiple pickers; light, dark, cross-tab updates, and live system preference changes. Theme coverage proves the contract rather than a tool: the documented token set, the set declared in `tokens.css`, and the set the bundled stylesheet serves are the same set, component CSS consumes only declared public tokens, and scoped `--nk-*` overrides on an application-owned wrapper reach Nitro descendants through inheritance.
451
451
 
452
452
  Ship a public customization guide and align the README and Rails integration docs whenever appearance, theme tokens, or shell composition changes. Document token load order, scoped light/dark overrides, CSP setup, customizer-export installation, and copyable Phlex examples; architecture notes alone are not user documentation.
453
453