poetry-ui 0.1.1 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: be9d330390d3bf48c36cd783dfaf4fdd00a0cf6073b9b8944caf10104abf66b7
-  data.tar.gz: 99aa8e106788b9a8d597b149e68c8d6353c7a49876a32969f106327a7d1be813
+  metadata.gz: d60854dfc65e3eb23ea1bdb0541a9e6290d69d8712ec913e1df746667def08f2
+  data.tar.gz: ede37b77181f5842f3d6d484757d1c38a08d3b2883596dc9e65daf4d6f54e27b
 SHA512:
-  metadata.gz: 6f60d8c522645d60374997d18bcea9ff4baaeb2f5fd888374966d008ef362f216b7cb0fa2f022f4f6b2127c10aa6750de2e37546c9aec380b37e79a909cee29a
-  data.tar.gz: 1b8bf7807b8f0836d702577677038fd1d42a5b2a8283579eee0471bd20026de193487d42ebe5861615fa9b2b1969087e1201a7fb5791b6715c4d6cdec63824d9
+  metadata.gz: 8ca0c7adb7ee3844f1debc06a974b6103b3414fb79d9bc3a18ce237591d260b99352efd91337b90ec5cb6d840fc7cb2d3d8cb48eb2c0c8014cb2b7f55768ee37
+  data.tar.gz: c828928ac82441d518eaf35dc879eb8e134e070b88ca32c6559add9ec5d48786f126d4a3bfac5784a1413a4ee29328ff38707ae540a74b04c26ad50c7d770bdf

data/CHANGELOG.md

@@ -1,5 +1,56 @@
 # Changelog
 
+## [0.1.3] - 2026-09-13
+
+### Fixed
+
+- `poetry_webmcp_form ... do |form|` is no longer a yieldless block to `poetry check`: the registry's helpers section now says the helper yields the form builder, as the helper's own example always showed.
+- `bin/rails poetry:check` accepts the app's own `poetry_*` helper methods (the adapter `poetry:pagination` copies in, a wrapper of the host's own): their names come from `app/helpers` boot-free, their options and blocks are their own, and the wiring rules still apply. A composed trigger's `do |wiring|` is no longer flagged either (poetry-core 0.1.3).
+
+## [0.1.2] - 2026-09-13
+
+### Added
+
+- The install names the theme it puts in the slot: on a first install or an explicit `--theme`, one line says which theme fills `poetry/style-default.css`, that the slot name never changes, and that the file's first line names the theme. The Theming and Installation guides say the same, for the reader who opens a file called default and finds vega.
+
+- `poetry:install` and `poetry:skill` say so when the host gitignores `.claude/skills`: the skills still serve that checkout, and the note names the refresh command teammates and CI run (`bin/rails g poetry:skill`) or the alternative of un-ignoring the directory. Asked of git only; no git, no repository, or a tracked directory stay silent.
+
+- App components are first-class on the booted surfaces. A component the app defines on the DSL with `helper :name` renders through that helper, `poetry:check` lints it under that name with its own contract, `/poetry/llms.txt` and `llms-full.txt` list it under an App components section with its agent rules, and `poetry:skill` writes a `references/app.md` with a menu line. The AGENTS.md section and the poetry-component skill teach the declaration. The MCP server's `check` tool learns the declared helpers from source, so it agrees the helper exists; its contracts and the runtime skill map stay gem-only (boot-free by design).
+
+- `poetry:install --no-preflight`, for an app that imports Tailwind without preflight: vendors the reset floor (`poetry/reset.css`, Tailwind's preflight at zero specificity, generated from the pinned binary and gated against it) into `layer(base)` ahead of the theme, and on a fresh entry writes the split no-preflight import. A plain re-run keeps the floor once installed. Measured against the golden corpus: without preflight two thirds of the components render differently even behind a modern reset, so the floor is what keeps them whole; `POETRY_PREFLIGHT=0 rake test:visual` proves it. The installer and `poetry:check` warn (`preflight-missing`) when an entry imports neither preflight nor the floor.
+- `poetry:design:overrides` counts only a rule against a theme-owned `cn-*` name (a gem dictionary's or the installed fragment's own) as an override. A host kit's own `cn-*` dictionary, or a page helper class in that namespace, is no longer reported as undeclared drift; a blanket declaration written to silence those now shows as stale.
+- `bin/rails poetry:stimulus:manifest` writes the app's controllers manifest (`config/controllers_manifest.json`, the file a gem commits) from `app/javascript/controllers`; registered at boot, a host controller validates like poetry's (the DSL by Symbol at class load, template wiring in `poetry:check`, its API in the registry). A controller the reader cannot describe is named and stays unvalidated until its entry is written by hand in the same file, where regeneration keeps it. `poetry:check` warns (`manifest-stale`) and `poetry:verify` fails when the entries the reader produced no longer match the sources; hand-written entries never count.
+- `bin/rails poetry:registry` writes the app's own components to `config/component_registry.yml`, the path a gem's registry lives at, so the MCP server and the runtime skill find them boot-free with full contracts and agent rules. Opt-in; once written, `poetry:check` warns (`registry-stale`) and `poetry:verify` fails when the file no longer matches the classes.
+
+### Changed
+
+- The reset floor's header and the Installation guide say exactly what wins: an unlayered host rule always, a host rule in `layer(base)` when it comes after the floor's import, and `[hidden]` keeps preflight's `!important` on purpose. `poetry:verify` names the remedy when a kit's own `cn-*` class is not in the compiled CSS. The AGENTS.md section spells JSON output as `POETRY_CHECK_JSON=1`.
+
+- The upgrade path holds on real hosts: `--charts` is remembered by the vendored `poetry/charts.css`, so a plain re-run refreshes the chart files and a theme switch swaps the chart fragment with the theme; the superseded 0.1.1 tokens import converges however it was written (indented, annotated, or with a carriage return, which it keeps); every `eval_gemfile` spelling is read before `herb` is added; the Claude Code skills are refreshed like the vendored CSS, without an overwrite prompt (`--skip` keeps a hand-edited one); an AGENTS.md begin marker without its end is an error naming the file, a byte-identical section reports `identical`, the section is written in the file's own line endings, and only the first section is replaced.
+
+- `poetry:check` hands the runner the app root, so the mailer exemption and the design tier judge a template by its path inside the app; an unreadable file is a warning in the report, not a crash of the task.
+
+- `poetry:check` reports `registry-invalid` when `config/component_registry.yml` exists but is not a registry (empty, malformed, the wrong shape), naming `bin/rails poetry:registry` as the fix; the committed registry regenerates with every helper named.
+
+- The scaffold form template is the form builder's: `form_with(model:, builder: Poetry::Ui::FormBuilder)` and one `f.input` per attribute, the control inferred from the column, the name and the validations, with the template adding only what the generator knows and the model cannot say (`as: :text` for rich text, `multiple: true` for many attachments, `required: true` from `null: false`). The gem's reference CRUD form now follows the gem's own first rule about forms. A host that installed the templates before keeps its copy (re-runs never overwrite); delete `lib/templates/erb/scaffold/_form.html.erb.tt` and re-run `poetry:scaffold_templates` for the builder version. On the way, two inference gaps in the builder: `has_many_attached` attributes infer a file input (the plural responder), and `website` / `permalink` infer a URL input like `url` does.
+
+- The form builder's agent rules say which parts a builder field renders (`field-label`, `field-description` for the hint, `field-error`), so llms.txt's Forms section, the registry, the MCP server and the skill all name the slots a wiring test asserts on; the Testing guide says the same.
+
+- `poetry:check` treats mailer templates as email, not pages: under a `*_mailer/` directory or in the mailer layout the raw-color rule stays quiet (an inline hex is the only paint a mail client honours) and the design tier skips them; every other rule runs there as before. The AGENTS.md section says so.
+
+- An off-list variant or a missing required option now raises at construction in development and test (poetry-core's runtime values tier) instead of rendering unstyled; the AGENTS.md section says so beside the check.
+- poetry-ui pins its components to `css_mode :tailwind`, and the class-name merger follows: a host's global `BemMerger` (for a kit of its own) never reaches poetry-ui's utility conflict resolution. A host's global `css_mode = :bem` (for a kit of its own on the DSL) no longer strips poetry-ui's styling; the two render side by side. The seeded initializer's comment says so instead of offering `:bem` as a poetry-ui option.
+- `poetry:check` and the AGENTS.md census find registry roots by convention (every loaded engine with a published registry, then the app's own file) and name no gem; poetry-charts is no longer special-cased, and any engine built on the DSL that commits a registry joins the check the same way.
+- `poetry:install` imports `tokens.css` into `layer(theme)`, so a token the host already declares (`--primary`, `--accent`, `--muted`, ...) keeps its value whatever the order in the Tailwind entry, and that value now reaches Poetry's components too. Before, the appended import landed after the host's own `:root` and took the same names over: an app's brand color vanished before a single Poetry component rendered. A re-run rewrites the earlier unlayered import line in place.
+- `poetry:install` reports, before writing anything, every Poetry token name and theme key the app's stylesheets already declare, with the file and line and what Poetry paints with that role. It never blocks. `poetry:check` repeats the report as `token-collision` warnings.
+
+- The WebMCP agent-focus rules (`:tool-form-active`, `:tool-submit-active`) leave the nine theme fragments, where they were identical, for poetry-agent's own stylesheet; `poetry:install` vendors it into `layer(base)` when that gem is bundled. A host without poetry-agent no longer carries them, nor the two warnings the CSS optimizer printed for the origin-trial pseudo-classes on every minified build (the Rails Tailwind task minifies by default, so every build and watch run).
+
+### Fixed
+
+- `poetry:install --force` no longer rewrites the four files the install seeds once for the host to own (`config/poetry_components.yml`, the initializer, `poetry/base.css`, `poetry/typeset.css`); a re-run with the flag used to reset a host's override declarations and settings to the seed. The vendored artifacts refresh on every run, so the flag is never needed on an upgrade.
+- `poetry:install` no longer adds a second `herb` declaration when the gem is declared in a file the Gemfile pulls in with `eval_gemfile` (a shared Gemfile).
+
 ## [0.1.1] - 2026-09-08
 
 ### Added

data/README.md

@@ -59,8 +59,8 @@ bin/rails g poetry:add <name>  # adds newly-shipped files, never overwrites
 ```
 
 And `rails g scaffold` itself can produce poetry-composed views — a
-DataTable index with sanitized URL state, Field-composed forms, and a
-matching controller — by installing the app-owned template overrides once:
+DataTable index with sanitized URL state, forms on the poetry form
+builder, and a matching controller — by installing the app-owned template overrides once:
 
 ```bash
 bin/rails g poetry:scaffold_templates

data/THIRD_PARTY_NOTICES.md

@@ -33,6 +33,35 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 ```
 
+## Tailwind CSS
+
+- Source: https://github.com/tailwindlabs/tailwindcss (MIT)
+- `reset/reset.css` (the reset floor `poetry:install --no-preflight` vendors) is preflight, generated from the pinned tailwindcss binary with every selector wrapped in `:where()`
+
+```
+MIT License
+
+Copyright (c) Tailwind Labs, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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.
+```
+
 ## Base UI
 
 - Source: https://github.com/mui/base-ui (MIT)

data/app/components/poetry/ui/dialog/component.rb

@@ -169,7 +169,7 @@ module Poetry
         # block--modifier tokens ARE the host's styling contract.
         # @api private
         def html_attributes
-          return super unless Poetry::Core::Config.current.css_mode == :tailwind
+          return super unless css_mode == :tailwind
 
           @html_attributes.merge(class: classnames(@html_attributes[:class]))
         end

data/app/controllers/poetry/ui/llms_controller.rb

@@ -21,7 +21,11 @@ module Poetry
         # The shared builder (the llms construction rule, extended): the
         # served text uses the exact registry construction the committed
         # file is generated from - helpers and blocks sections included.
-        Poetry::Core::LlmsText.new(registry: Poetry::Ui.registry)
+        # The app's own components ride along (their section follows the
+        # gem catalog), so an agent reading llms-full.txt sees their agent
+        # rules and helpers too.
+        Poetry::Core::LlmsText.new(registry: Poetry::Ui.registry,
+                                   host_registry: Poetry::Core::HostComponents.registry(root: Rails.root))
       end
     end
   end

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

@@ -982,6 +982,10 @@ module Poetry
             { "name" => "value", "type" => "object" }
           ]
         },
+        "poetry_webmcp_form" => {
+          "yields" => "the form builder (Poetry::Ui::FormBuilder unless builder: says otherwise) - " \
+                      "form.field and form.input author the tool's parameters; every standard field helper works"
+        },
         "poetry_input_group_addon" => {
           "options" => [{ "name" => "align", "type" => "symbol", "default" => "inline-start",
                           "variants" => INPUT_GROUP_ALIGNS.map(&:to_s) }]

data/app/helpers/poetry/ui/form_builder/type_inference.rb

@@ -17,7 +17,7 @@ module Poetry
         STRING_HEURISTICS = {
           /password/ => :password,
           /email/ => :email,
-          /\burl\b|_url\b/ => :url,
+          /\burl\b|_url\b|website|permalink/ => :url,
           /phone|\btel\b/ => :tel,
           /search|query/ => :search
         }.freeze
@@ -43,9 +43,11 @@ module Poetry
           COLUMN_TYPES.fetch(column, :string)
         end
 
+        # has_one_attached answers to <name>_attachment, has_many_attached
+        # to <name>_attachments; the other two are the classic uploaders.
         def attachment_attribute?(method)
-          object.respond_to?("#{method}_attachment") || object.respond_to?("#{method}_attacher") ||
-            object.respond_to?("remote_#{method}_url")
+          object.respond_to?("#{method}_attachment") || object.respond_to?("#{method}_attachments") ||
+            object.respond_to?("#{method}_attacher") || object.respond_to?("remote_#{method}_url")
         end
 
         def enum_attribute?(method)

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

@@ -32,6 +32,9 @@ module Poetry
         "overrides the presence inference (aria only).",
         "Hints/placeholders resolve from poetry_form.* i18n (simple_form.* keys keep working " \
         "as a fallback); pass hint:/placeholder: to override.",
+        "Every builder field renders a Field, so wiring tests assert on its parts: the label is " \
+        "data-slot=field-label, the hint data-slot=field-description, the error data-slot=field-error, " \
+        "with the control inside (never a bare hint or description slot).",
         "f.submit renders a poetry Button with the Rails i18n label; f.fieldset(legend:)/" \
         "f.group lay out sections; boolean f.input renders the horizontal Field " \
         "(switch: true -> the setting row).",