ruact 0.0.18 → 0.0.19

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: afeffed3bf00af43d750b220dbffbdd62758269d578bb649912d7fbee157df86
-  data.tar.gz: 2bae60da180b2a5b6c85fe49c3adc42d3431c1cfee7666c9fdbf79b92815049b
+  metadata.gz: 7d7fb20ee09bec81b05b4e1cafba8f511e46a77d2bee2afc7bb92ca8e026483d
+  data.tar.gz: 6111ba333bf9067854a13c62ec66f13297c78c3a6c4c419f39284d001d57d2c4
 SHA512:
-  metadata.gz: 79f5785e73237b512b1fce27e9b085538c57954921bf92544fc8d4f80c2646f27e5e46baa23b1a565beb567b8e4762a108a0f2885b3ec85f9b822216889afadd
-  data.tar.gz: 3421862773a8f0669533bd70e39aed531b9ae2c4ce42205bc6939bc6311d76f5c45e4527d39752793bebc343af29ba96ebffd3fd58a6f414bb16fba879cfcbeb
+  metadata.gz: 1b9ed6e86719935a5494f4a847c1938e903c4440f0b026ba3c1780eb0407fe6cf2214b448b3a6e34b8c10e45f42c3e4964dd2bcbaa14c33ec35d5e71114d7bbc
+  data.tar.gz: c25217ef2564fc948c0aee0191878a4addeefaf4e3edb45986e6d0b1d8b547f17cdc72b15a366d8a9d886db378e522b3c7394fd00ba22f9e05fd11dab8e49a61

data/CHANGELOG.md

@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.0.19] - 2026-10-08
+
+### Fixed
+
+- **A component exported from a file that exports several now renders as itself.** When one file exported more than one client component — as shadcn/ui's `components/ui/dialog.tsx` exports `Dialog`, `DialogTrigger`, `DialogContent` and the rest — every ERB tag naming one of them rendered whichever of the file's components the manifest listed first, with no error: a `<DialogTrigger>` rendered a `Dialog`, and a dialog composed from its parts in ERB never opened. Each tag now imports its own export. Files exporting a single component were not affected.
+
+### Changed
+
+- **The `AGENTS.md` section the install writes tells agents to key list items.** In an ERB loop whose items hold components, each item needs a `data-react-key`: ERB has no `key`, so React matches the items by position, and when the list changes a component's state shows on the wrong item, with no warning. Re-run `rails generate ruact:install --force` to refresh the section.
+
 ## [0.0.18] - 2026-10-07
 
 ### Added
@@ -480,7 +490,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - **E2E test app** — `e2e/` Rails app (no DB, in-memory Post model) with full CRUD system tests validating the complete request cycle.
 
-[Unreleased]: https://github.com/luizcg/ruact/compare/v0.0.18...HEAD
+[Unreleased]: https://github.com/luizcg/ruact/compare/v0.0.19...HEAD
+[0.0.19]: https://github.com/luizcg/ruact/releases/tag/v0.0.19
 [0.0.18]: https://github.com/luizcg/ruact/releases/tag/v0.0.18
 [0.0.17]: https://github.com/luizcg/ruact/releases/tag/v0.0.17
 [0.0.16]: https://github.com/luizcg/ruact/releases/tag/v0.0.16

data/lib/generators/ruact/install/templates/AGENTS.md.tt

@@ -20,8 +20,7 @@ truth" below) instead of guessing.
   adds it; `ruact_pages only:` narrows it). The page's renderer owns navigation:
   going between a ruact page and a plain Rails/Turbo page is a full page load.
 - Interactive components live in `app/javascript/components/` as `"use client"`
-  files, mounted from ERB with a PascalCase self-closing tag:
-  `<LikeButton postId={@post.id} />`.
+  files, mounted from ERB with a PascalCase tag: `<LikeButton postId={@post.id} />`.
 - Mutations are ordinary non-GET controller actions on a controller that does
   `include Ruact::Server`. Reads are `Ruact::Query` classes in `app/queries/`.
 - ruact generates a typed TypeScript module from the route table; React imports
@@ -78,10 +77,11 @@ READ IT instead of simulating the name generation. Regenerate after routes/queri
 ## Five traps
 
 1. **Every component tag closes.** `<Badge label={@x} />` has no children;
-   `<Card title={@t}>...</Card>` passes the ERB between its tags — HTML, loops,
-   partials, other components — to the component as `children`. An opening tag
-   that never closes, or a closing tag with no opening, fails LOUDLY with a
+   `<Card title={@t}>...</Card>` passes the ERB between its tags to the
+   component as `children`. An unclosed or stray tag fails LOUDLY with a
    `PreprocessorError` naming file:line. `<Suspense fallback="...">` pairs too.
+   In a loop of items holding components, give each item a `data-react-key`
+   (the record's id): React matches them by position otherwise, silently.
 2. **`{}` props are Ruby, not JavaScript.** `<Badge label={@post.title} />`
    evaluates `@post.title` as a Ruby expression in the ERB. No JS ternaries,
    no `{...spread}`. A quoted value (`title="Hi"`) is a

data/lib/ruact/client_manifest.rb

@@ -49,9 +49,13 @@ module Ruact
     # every client component eagerly (`virtual:ruact/registry`), so there is
     # nothing to load — and React reads +chunks+ as `[chunkId, filename]` pairs,
     # which the manifest's one-URL list is not.
-    def resolve(module_id, _export_name)
-      entry = by_module_id(module_id)
-      raise "ClientManifest: no entry for module_id=#{module_id.inspect}" unless entry
+    #
+    # The entry is looked up by module AND export: one file can export several
+    # components (shadcn/ui's dialog.tsx exports Dialog, DialogTrigger, …), and
+    # each tag imports its own.
+    def resolve(module_id, export_name)
+      entry = data.each_value.find { |e| e["id"] == module_id && e["name"] == export_name }
+      raise "ClientManifest: no entry for module_id=#{module_id.inspect} export=#{export_name.inspect}" unless entry
 
       [entry["id"], NO_CHUNKS, entry["name"]]
     end
@@ -248,9 +252,5 @@ module Ruact
     def entries_by_name
       data
     end
-
-    def by_module_id(id)
-      data.values.find { |entry| entry["id"] == id }
-    end
   end
 end

data/lib/ruact/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Ruact
-  VERSION = "0.0.18"
+  VERSION = "0.0.19"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ruact
 version: !ruby/object:Gem::Version
-  version: 0.0.18
+  version: 0.0.19
 platform: ruby
 authors:
 - Luiz Garcia