poetry-ui 0.1.12 → 0.1.13

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8676875c7f97a1dd931abb718a49a3da6877873b20aafec53006b68a022a04ca
-  data.tar.gz: 40933fec5bc880f597fd5eec6b2eb2485087ce141280d5c05e3e30fc949a7863
+  metadata.gz: fd69e4a483a5ff3e4ab764d00853296fb1719e0ccb37d93b576412d578464dbb
+  data.tar.gz: 4574dd426ea32bbff47837b78ccdc4a60599f87a007252ec3850387ba1a2535a
 SHA512:
-  metadata.gz: b1d773fc597f9d72558ffca7a6ae6f3fade21d73fe06455c6e3fa319107f7bfc741e6d4c9b758b57879fffdf43e61db0a7d88cf2c3211e10999e6486e6882360
-  data.tar.gz: aaa0f3b9bc18469dec3de18ef48c55f05e508a519b9e1423ce580781fbbcc008d7fd7a750553c387eb06c14d92f5f1414b0900f60e83c7a5d06086f03691ef0e
+  metadata.gz: 93efa9fe4b2ac3e533988fd3e499d37d2f7db28c68282723de8f6326716833ac988b3f9934fe84802c2f28203a67353eaa24cecb84384e2f148bad4abb9cd4f3
+  data.tar.gz: 1a94d395feea2e02280c6eb3d214b51aeddf6dea6a097e926816a8769f8c9d5d2080fdc3872f1f0a559d81a390ca129f6d74aef3f161f5fc36a65c07f8245c87

data/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## [0.1.13] - 2026-10-13
+
+### Added
+
+- `poetry:add` rewrites `config/controllers_manifest.json` when a registry item installs a Stimulus controller under `app/javascript/controllers`, as `poetry:stimulus:manifest` would. A component that names its controller by Symbol now loads after the install instead of raising until the host ran the task by hand. The generator says to commit the manifest and restart a running server.
+
+### Fixed
+
+- `poetry:check` no longer warns about `poetry_native_select_option` and `poetry_native_select_optgroup` inside a loop. They render plain `<option>` and `<optgroup>` tags with no id to keep stable, and the `key:` the warning asked for would only leak into the HTML as an attribute. The registry's helpers section declares both identity-free, like the table parts.
+
 ## [0.1.12] - 2026-10-07
 
 ### Fixed

data/app/helpers/poetry/ui/components_helper.rb

@@ -972,9 +972,11 @@ module Poetry
       # these literals statically (the crash class: a helper-only literal
       # like align: :leading that no component contract covers, failing
       # only at render). Plain wrapper helpers need no entry here;
-      # registry generation lists them name-only. The table parts declare
-      # identity false: they mint no id, so the stable-identity rules have
-      # nothing to ask of them (a keyed row derives its id).
+      # registry generation lists them name-only. The table parts and the
+      # native select's option and optgroup declare identity false: they
+      # mint no id, so the stable-identity rules have nothing to ask of
+      # them (a keyed row derives its id; key: on an option would only
+      # leak as an HTML attribute).
       HELPER_CONTRACTS = {
         "poetry_table_header" => { "identity" => false },
         "poetry_table_body" => { "identity" => false },
@@ -983,6 +985,8 @@ module Poetry
         "poetry_table_head" => { "identity" => false },
         "poetry_table_cell" => { "identity" => false },
         "poetry_table_caption" => { "identity" => false },
+        "poetry_native_select_option" => { "identity" => false },
+        "poetry_native_select_optgroup" => { "identity" => false },
         "poetry_toast_trigger" => {
           "options" => [
             { "name" => "template", "type" => "string",

data/config/component_registry.yml

@@ -12160,8 +12160,10 @@ helpers:
   poetry_kbd_group: {}
   poetry_message_group: {}
   poetry_message_scroller_item: {}
-  poetry_native_select_optgroup: {}
-  poetry_native_select_option: {}
+  poetry_native_select_optgroup:
+    identity: false
+  poetry_native_select_option:
+    identity: false
   poetry_navigation_menu_link: {}
   poetry_optimistic_form:
     yields: the form builder - form.optimistic_template authors the predicted turbo-stream(s);

data/lib/generators/poetry/add/add_generator.rb

@@ -35,6 +35,9 @@ module Poetry
     MANIFEST = "config/poetry_components.yml"
     # The host's Tailwind entry stylesheet (for @source injection).
     TAILWIND_ENTRY = "app/assets/tailwind/application.css"
+    # Where an item's Stimulus controllers land; a write here refreshes the
+    # app's controllers manifest.
+    CONTROLLERS_DIR = "app/javascript/controllers/"
 
     desc "Copy poetry components/blocks (plus dependencies) into the app, from the gems or any registry address"
 
@@ -116,10 +119,29 @@ module Poetry
       plan.writes.each { |write| create_file write.target, write.content, skip: true }
       plan.block_installs.each { |name| install_block(name) }
       apply_css(plan)
+      refresh_controllers_manifest(plan)
       report(plan)
       record_in_manifest(plan.manifest)
     end
 
+    # An item that brings a Stimulus controller joins the app's controllers
+    # manifest straight away (as `bin/rails poetry:stimulus:manifest` would),
+    # so the component that names it by Symbol loads, and check validates
+    # its wiring. The manifest is read at boot: a running server restarts.
+    def refresh_controllers_manifest(plan)
+      return if options[:pretend] || behavior == :revoke
+      return unless plan.writes.any? { |write| write.target.to_s.start_with?(CONTROLLERS_DIR) }
+
+      result = Poetry::Core::Stimulus::HostManifest.generate!(root: Pathname(destination_root))
+      count = result.definitions.size
+      say_status :stimulus, "wrote config/controllers_manifest.json (#{count} controller#{"s" unless count == 1}) - " \
+                            "commit it, and restart a running server so components that name them load", :green
+      result.skipped.each do |skip|
+        say_status :stimulus,
+                   "skipped #{skip.identifier}: #{skip.reason} (unvalidated until written by hand)", :yellow
+      end
+    end
+
     # The install plan for remote addresses through the registry client.
     def build_plan(remote)
       config = manifest_config

data/lib/poetry/ui/version.rb

@@ -3,6 +3,6 @@
 module Poetry
   module Ui
     # The gem version.
-    VERSION = "0.1.12"
+    VERSION = "0.1.13"
   end
 end

data/lib/tasks/poetry/design.rake

@@ -271,6 +271,10 @@ def poetry_design_report(plan, written)
     out << "  contrast (merged set, AA floor):"
     plan.contrast.each { |result| out << "    #{result}" }
   end
+  if plan.edges.any?
+    out << "  faint edges (shipped; border and input vanish on these surfaces):"
+    plan.edges.each { |edge| out << "    #{edge}" }
+  end
   if plan.dropped.any?
     out << "  dropped (never guessed):"
     plan.dropped.each { |drop| out << "    #{drop.name}: #{drop.reason}" }
@@ -295,6 +299,10 @@ def poetry_design_report_json(plan, written)
       { "mode" => r.mode, "pair" => r.label, "ratio" => r.ratio.round(2), "pass" => r.pass,
         "suggestion" => r.suggestion, "shipped_failing" => r.shipped }.compact
     end,
+    "edges" => plan.edges.map do |e|
+      { "mode" => e.mode, "edge" => e.edge, "surface" => e.surface, "ratio" => e.ratio.round(2),
+        "suggestion" => e.suggestion }.compact
+    end,
     "dropped" => plan.dropped.map do |d|
       { "name" => d.name, "value" => d.value, "mode" => d.mode, "reason" => d.reason }.compact
     end,

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: poetry-ui
 version: !ruby/object:Gem::Version
-  version: 0.1.12
+  version: 0.1.13
 platform: ruby
 authors:
 - Matt Solt
 bindir: exe
 cert_chain: []
-date: 2026-10-07 00:00:00.000000000 Z
+date: 2026-10-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: poetry-core
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.1.12
+        version: 0.1.13
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.1.12
+        version: 0.1.13
 description: 'The component library of Poetry, the AI-native frontend framework for
   Rails: accessible, themeable, agent-legible ViewComponents built entirely on poetry-core''s
   public DSL.'