nitro_kit 0.9.0 → 2.0.0.alpha.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 06ec36dc808b0223864423889cf64d62465c925e111a49d334110aadfa0859a3
-  data.tar.gz: 9a1f9f81419b52fcfb8c5a956e134f424419a4c5b922ecc68d820f3bfb135a9d
+  metadata.gz: 2cfb9e904d8890216a6c778b5dd10655e22f77fa7508fd4d9eb9521453b61cd8
+  data.tar.gz: 3c9564fa27b68e1a10c1febe8b7104416251a5203b1bd25aa89b1617cab1e116
 SHA512:
-  metadata.gz: dd3df11e3987edb2be111e580442b9ccac3d3e1f414bdb7933469f1ab7d1c29cf0e3b17648eb01793301ea64b8880a776d545428b34e76aabf779c9161e7c889
-  data.tar.gz: b5ef21b4509537b8e373278ea1fa52e08d154e5a46869c942ad39f2fe69888ba2cb215a85e00e1e34f196a94afbace25e2a6b1ed744ef18116724462b2a22676
+  metadata.gz: de02c676e41ea2cb0d674de967efa9c73aa8d6f65195af0bfae0ce35e305dc9fb5e53979659e5feed738cf0fdc4e968902931be726a5d1bd67f22a400ce3c0b2
+  data.tar.gz: 2ffdd83fe0f4005c5146a3d9e4fa13e7ce8a6b6d84d0a7e881aace598a6ff938836b20c15f29bde5f9d72e9bed8ef2e4a6b8a083add6986a0acdacb653221a4e

data/.agents/plugins/marketplace.json

@@ -0,0 +1,20 @@
+{
+  "name": "nitro-kit",
+  "interface": {
+    "displayName": "Nitro Kit"
+  },
+  "plugins": [
+    {
+      "name": "nitro-kit",
+      "source": {
+        "source": "local",
+        "path": "./plugins/nitro-kit"
+      },
+      "policy": {
+        "installation": "AVAILABLE",
+        "authentication": "ON_USE"
+      },
+      "category": "Developer"
+    }
+  ]
+}

data/CHANGELOG.md

@@ -0,0 +1,172 @@
+# Changelog
+
+## 2.0.0.alpha.2
+
+This alpha keeps the 2.0 API experimental while incorporating the first full
+catalog-pattern and external-agent testing pass.
+
+### Changed
+
+- Add the setup-only installer, project-local agent guidance, diagnostics, and
+  initialization prompt used by new and existing Rails applications.
+- Align desktop page-header actions with the title edge and improve nested
+  table and responsive dropzone composition.
+- Exercise desktop pointer capabilities in browser CI with environment-matched
+  Chrome tooling.
+
+### Fixed
+
+- Improve warning, destructive, form-error, and dark-mode contrast.
+- Preserve native list and fieldset semantics in form errors and grouped
+  controls.
+- Fix table-cell alignment leakage and cramped upload actions at narrow widths.
+
+## 2.0.0.alpha.1
+
+Nitro Kit 2.0 alpha is a ground-up, intentionally incompatible rebuild around gem-owned Phlex composition. It replaces the generated, helper-driven 1.x architecture with a versioned component system owned by the gem.
+
+### Breaking changes
+
+#### Packaging and API surface
+
+- Replace generated editable component copies with versioned `NitroKit::*` classes loaded from the gem.
+- Remove all `nk_*` ERB helpers, generated variant helpers, `from_template`, and template-buffer bridges.
+- Remove copied-component generators, schema/variant metadata, and legacy installation paths.
+- Add a setup-only generator, project-local Rails/Hotwire/UI skills, integration
+  diagnostics, and an agent initialization prompt for Nitro Kit 2.
+- Remove Tailwind Merge, consumer Tailwind requirements, old Tailwind assets, and internal component class strings.
+- Use Rails `form_with(..., builder: NitroKit::FormBuilder)` instead of `nk_form_with` or `nk_form_for`.
+- Remove vendored Floating UI and combobox navigation runtimes and the obsolete Datepicker and Switch controllers.
+
+#### Attribute boundary
+
+- Replace permissive component attributes with explicit options and `html:`, `aria:`, and `data:` boundaries.
+- Reject `class` and `style`; add the observable `desperately_need_a_class:` integration escape.
+- Reserve a named set of data keys instead of an ad hoc list. `Component::COMPONENT_OWNED_DATA_ATTRIBUTES` is `state`, `disabled`, `required`, `orientation`, `presentation`, `placement`, `layout`, and `field-type`; `Component::RESERVED_DATA_ATTRIBUTES` adds `nk`, `slot`, `variant`, `size`, `nk-escape`, and `enhanced`. Passing any of them through `data:` now raises. `data-controller` and `data-action` remain additive.
+- Settle the variant axis: `variant:` and `size:` on a root are the component's identity axes and are emitted only by the base component. A slot may carry its own owned `data-variant` when it has variant identity of its own, as `Toast::Item` and Dropdown items do; caller `data: { variant: }` stays reserved either way.
+
+#### Removed components and options
+
+- Remove `VStack` and `HStack` in favor of one explicit, responsive `Flex` component.
+- Remove the Datepicker component entirely. `Input`'s `type: :date` is the only date control, and `Field`/`FormBuilder` reach it through `as: :date`.
+- Remove the separate sortable-table component. Sorting lives on `Table` through `Table.new(sort:, direction:)` and `th(sort:, href:, sort_data:)`; `NitroKit::RansackTable` is not a core contract.
+- Remove `Combobox::Option` in favor of the shared, validated `NitroKit::Choice` value.
+- Remove `Alert`'s second palette axis. `Alert` now has one semantic `variant:` axis of `default info success warning error`, matching `Toast::Item`, with the tint driven by the Alert-owned `VARIANT_PALETTE`. There is no `color:` option; the `color:` palette belongs to `Badge` alone.
+
+#### Renamed and reshaped options
+
+- Rename Button's trailing-icon keyword to `icon_end:`, matching the `button-icon-end` slot. `icon_right:` is gone. `Dropdown#trigger` and `Tooltip#trigger` forward the same `icon:`/`icon_end:` pair.
+- Add `icon:` to `Dropdown#item` alongside its owned `data-variant` for `default` and `destructive` items.
+- Replace Dialog's ad hoc content declarations with exactly one required `panel(title:, description: nil, nonmodal: false)`. Nitro renders close button, title, description, then application content, so a sticky close control survives long panels. `dismissible: false` renders no close button and declaring one raises.
+- Rename `Dropzone`'s visible prompt keyword from `title:` to `label:`, and move its remaining user-facing strings into the `nitro_kit.dropzone.*` locale scope.
+- Require `label:` on `AvatarStack` to name the group, add `max:` to bound visible avatars and derive the `+N` indicator, and reject `aria: { label: }` and combining `max:` with an explicit `overflow`.
+- Give `AppShell` a `layout:` axis rather than a variant. The root is now `div[data-nk="app-shell"][data-layout]`, and the narrow drawer is a real modal `dialog` so the browser owns focus containment, inertness, and Escape.
+- Make `AppNavigation`'s body a real `ul`, with every entry an `li` and items rendering `li > a[data-slot="app-navigation-item-link"]` that carry their own attribute bags. `SettingsLayout` navigation uses the same `nav > ul > li > a` shape.
+- Reshape `Toast`. The list is `ol[data-slot="toast-list"]` whose id is the toast id plus `-list`, so a Turbo Stream can append `Toast::Item` directly to `nk-toast-list`. Items carry `role="status"`, or `role="alert"` for the error variant, and every item is `data-turbo-temporary` while the region and list survive. `dismissible: false` items are never auto-dismissed.
+- Scope checkable behavior to the one state HTML cannot express. `Checkbox` mounts `nk--checkable` only for `indeterminate: true`; ordinary checked state, `Switch`, and `RadioButton` mount no controller and mirror no `data-state`. A `Checkbox` description now requires a non-blank String `id:`.
+- Require `id:`, `name:`, `label:`, and `options:` on `Combobox`, validate the value against the declared options, and accept `label: false` only with `control_aria: { label: }` or `{ labelledby: }`. `Field` gains `as: :combobox`, `as: :rich_text`, and `as: :radio_group`, and rejects `label: false` for radio groups.
+
+### Added
+
+- Add `CommandPalette`, a native-dialog destination search with a declarative link baseline, optional Command-K or Control-K shortcut, local or server-rendered Turbo Frame results, result announcements, and Turbo-safe reset behavior.
+- Self-describing, classless `data-nk` roots and component-qualified `data-slot` contracts.
+- Static zero-specificity CSS, light and dark theme tokens with a no-JavaScript system fallback, and a separate Tailwind CSS v4 adapter.
+- Responsive Flex and Grid layouts with fixed mobile-first breakpoints, closed values, classless data contracts, and no Tailwind runtime; plus the constrained-width Container.
+- Sortable `Table` headers with caller-owned URLs, native `aria-sort`, and an optional Ransack gallery recipe.
+- Eleven blocks and shells: AuthShell, AppShell, SettingsLayout, Toolbar, PaginationBar, PageHeader, StatGrid, DataSection, FormSection, DangerZone, and EmptyState.
+- AppNavigation, AppearancePicker, DetailsTable, Dropzone, and ProgressiveImage components, plus the non-visual AppearanceBootstrap runtime.
+- Typed Choice values and direct-Phlex Rails FormBuilder integration with Active Model errors, native and direct uploads, and Turbo Frame/Stream examples.
+- Direct optional Pagy integration through `Pagination(pagy:)`, with an explicit URL callable for caller-owned destinations.
+- Optional Lexxy and Action Text integration through `form.field(..., as: :rich_text)`, preserving editor-native inputs, attachments, options, and behavior inside Nitro's Field contract.
+- Gem-owned importmap pins and Stimulus behavior for AppShell, AppearancePicker, Avatar, Button submission feedback, Checkbox (`nk--checkable`), Combobox, CommandPalette, Dialog, Dropdown, Dropzone, ProgressiveImage, Tabs, Toast, and Tooltip. Accordion needs no JavaScript at all.
+- `Typeset` for semantic rich content and `RichTextArea` for the host application's rich-text editor output.
+- A `nitro_kit.*` locale scope so component copy is translatable; Dropzone additionally hands its runtime strings to `nk--dropzone` as Stimulus values so no user-facing English lives in JavaScript.
+- A catalog-driven Phlex gallery covering components, blocks, broad application flows, complete application shells, responsive states, and light, dark, and system appearance.
+- A public customization guide and gallery wizard for documented tokens, deterministic CSS exports, and copyable AppShell composition.
+
+### License metadata
+
+- Mark the gem's existing custom NitroKit License as nonstandard and include `LICENSE` in the package. The license terms are unchanged.
+
+## 0.9.0
+
+### Added
+
+- Include assets in the gem package
+- Add integration test coverage for core components
+
+### Changed
+
+- Update pagination helper for the latest Pagy API
+- Resolve schema builder dependencies transitively
+
+### Fixed
+
+- Apply combobox root class correctly
+- Fix rendering NitroKit components inside NitroKit components
+- Fix Select prompt handling
+- Fix dropdown destructive item helper argument handling
+- Handle missing Pagy dependency gracefully
+
+## 0.8.0
+
+### Changed
+
+- Reformat as Rails Omakase rubocop style
+- Update Avatar component rendering for improved consistency
+- Add formatting tools and minor cleanup improvements
+
+### Fixed
+
+- Fix Select component empty rendering issue
+- Add missing `select` method to FormBuilder
+- Fix toast controller initialization timing issues
+- Add Table wrapper parameter
+- Remove default whitespace-nowrap from table cells
+
+## 0.7.0
+
+### Changed
+
+- Migrate from `builder_method` to `from_template` pattern
+- Update Input focus styling to use `focus-visible` for better accessibility
+- Improve `text_or_block` method with SafeBuffer handling
+- Remove I18n dependency from FormBuilder
+
+### Added
+
+- XL size option for Button component
+- `radio_button` method to FormBuilder
+- `nk_avatar_stack` helper and component
+- Pass options to Combobox in `combobox` method
+- Support for rendering fields as custom component classes
+
+### Fixed
+
+- Remove duplicate id from field checkbox hidden field
+- Fix checkbox field and textarea rendering
+- Add spacing between consecutive fieldsets
+- Improve dropdown functionality
+
+## 0.6.0
+
+NB: Nitro Kit has been re-licensed to disallow reselling as is. It is still free to use in your projects you just can't sell copies of it.
+
+### Breaking changes
+
+- Update color definitions and add some more. **You'll need to update the color definitions in your CSS file.** See [Getting Started](https://nitrokit.dev/getting_started)
+
+### Changed
+
+- Update `phlex` and `phlex-rails` dependencies
+- Increase button[size=sm] size
+
+### Added
+
+- Badge colors!
+- Support for `as:` prop in Dialog
+- `align:` prop for table cells
+
+## 0.5.2
+
+Start of this document

data/LICENSE

@@ -0,0 +1,28 @@
+# NitroKit License (v1.0)
+
+© 2025 Brainbow / Mikkel Malmberg
+
+## Grant of Rights
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to use, modify, and share the Software (including in commercial products), subject to the conditions below.
+
+## Conditions
+
+### 1. Commercial Usage Restrictions
+
+- You may use the Software for commercial purposes, including within commercial products or services.
+- You may not sell the Software as a standalone product.
+- You may not sell a product whose primary value derives from the Software with minimal modifications or additions (a "Repackaged Product").
+
+### 2. Attribution Requirements
+
+- All copies or substantial portions of the Software must include this license and copyright notice.
+- If the Software is used in a user-facing application, attribution in documentation or about section is sufficient.
+
+### 3. Disclaimer of Warranty
+
+The Software is provided "as is", without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose, and noninfringement. In no event shall the authors or copyright holders be liable for any claim, damages, or other liability, whether in an action of contract, tort or otherwise, arising from, out of, or in connection with the Software or the use or other dealings in the Software.
+
+## Termination
+
+Your rights under this license will terminate automatically if you fail to comply with any of its terms.

data/README.md

@@ -1,28 +1,35 @@
-<center><a href="https://nitrokit.dev"><img src="https://s3.brnbw.com/Artboard-q85JFfA8Auat32ByIAXtDAsbYGgs5MeTM4GDaonKhlxVniioPDLQTZUeynCfdBSHAfiRYhMWkGaYZC9ClkZS9aFgkBjx9mrAmnFs.png" alt="Nitro Kit" width="335" /></a></center>
+<p align="center">
+  <a href="https://nitrokit.dev"><img src="https://s3.brnbw.com/Artboard-q85JFfA8Auat32ByIAXtDAsbYGgs5MeTM4GDaonKhlxVniioPDLQTZUeynCfdBSHAfiRYhMWkGaYZC9ClkZS9aFgkBjx9mrAmnFs.png" alt="Nitro Kit" width="335"></a>
+</p>
 
-<p></p>
+# Nitro Kit
 
-**Nitro Kit** is a set of **generic UI components** to help you build your **Ruby on Rails** application.
+**Rails front-end for the agent era.**
 
-Rather than being fancy it is **purposefully modest**. Instead of giving you a black box, it is provided as a bunch of generators that give you a starting point to build upon.
+Nitro Kit is a gem-owned, agent-native UI system for Ruby on Rails. The `2.0.0.alpha.2` prerelease is a ground-up rebuild under active testing and must not be treated as stable. New documentation and the Nitro Kit Pro alpha catalog are coming next.
 
-Easy to customize, accessible, Rails native.
+[![RubyGems](https://img.shields.io/gem/v/nitro_kit.svg)](https://rubygems.org/gems/nitro_kit)
 
-_Nitro Kit is still pre 1.0 and is in active development._
+## Installation
 
-See [nitrokit.dev](https://nitrokit.dev).
+Install the alpha explicitly and keep it pinned while evaluating it.
 
-[![Rubygems](https://img.shields.io/gem/v/nitro_kit.svg)](https://rubygems.org/gems/nitro_kit)
-
----
+```ruby
+gem "nitro_kit", "2.0.0.alpha.2"
+```
 
-### Development
+Use the released gem and commit `Gemfile` with `Gemfile.lock`. Before upgrading, review the changelog, run `bundle update nitro_kit`, rerun the installer, and test the application.
 
 ```sh
-bin/setup
-bin/dev
+bundle install
+bin/rails generate nitro_kit:install
+bin/rails nitro_kit:doctor
 ```
 
-### License
+The [agent guide](docs/agent_guide.md), [Rails integration guide](docs/rails_integration.md), and [component contracts](docs/component_contracts.md) are included with the gem.
+
+Maintaining Nitro Kit 1? Its frozen documentation remains at [v1.nitrokit.dev](https://v1.nitrokit.dev).
+
+## License
 
-MIT
+Nitro Kit is distributed under the custom [NitroKit License](LICENSE).