poetry-ui 0.0.2

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

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+module Poetry
+  module Ui
+    # Prose containers for rendered markdown.
+    module Typeset
+      # The prose container for rendered markdown and other element-soup
+      # HTML: every bare heading, paragraph, list, and table inside is
+      # styled by the app-owned typeset.css the installer copies. Three
+      # rhythm variables (size / leading / flow) drive the scale -
+      # everything else derives - and preset: appends a tiny app-defined
+      # class that retunes them. Opt an embedded component's subtree out
+      # with class: "not-typeset"; wrap a wide block in a typeset-scroll
+      # div to scroll horizontally instead of compressing.
+      #
+      # @example
+      #   render Poetry::Ui::Typeset::Component.new(preset: "docs") do
+      #     @article_html
+      #   end
+      class Component < Poetry::Core::Component
+        requires_content "the rendered prose HTML"
+
+        # Projected into the registry, llms.txt, and the agent surface.
+        AGENT_RULES = [
+          "Wrap RENDERED markdown / prose HTML (headings, paragraphs, lists, tables) - never app " \
+          "chrome; poetry components style themselves.",
+          "preset: \"docs\" appends typeset-docs - a preset is a tiny class in the app's own CSS " \
+          "setting --typeset-size/-leading/-flow (and font vars).",
+          "Opt an embedded component OUT of the prose styling with class: \"not-typeset\" - it " \
+          "covers the whole subtree.",
+          "Wrap a wide table (or any wide block) in a typeset-scroll div inside the prose to " \
+          "scroll horizontally instead of compressing."
+        ].freeze
+
+        option :preset, :string,
+               doc: "Appends typeset-<preset> - a tiny class in the app's own CSS retuning the rhythm variables " \
+                    "(e.g. \"docs\")."
+
+        part "typeset", "The prose container - every bare element inside is styled by the " \
+                        "app-owned typeset.css; not-typeset (class or data attribute) opts a " \
+                        "subtree out"
+
+        # @api private
+        def before_render
+          ensure_content!
+        end
+
+        # @api private
+        def call
+          content_tag(:div, content, **root_attributes.to_attributes)
+        end
+
+        # @api private
+        def root_attributes
+          html_attributes.merge_if_not_set(
+            { "data-slot" => "typeset" }.merge(component_data_attributes)
+          )
+        end
+
+        # The preset rides the root class list (the caller's class: still
+        # wins conflicts through the merger, as everywhere).
+        # @api private
+        def css(element = nil, **options)
+          return super unless element.nil?
+
+          classnames(super, ("typeset-#{preset}" if preset.present?))
+        end
+
+        private :root_attributes, :css
+      end
+    end
+  end
+end

data/app/components/poetry/ui/typeset/preview.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module Poetry
+  module Ui
+    module Typeset
+      # The Typeset preview: a rendered-markdown fixture (the element soup a
+      # markdown renderer emits - headings, prose, list, quote, code, table)
+      # styled entirely by the app-owned typeset.css.
+      class Preview < Poetry::Core::Preview::Base
+        FIXTURE = <<~HTML
+          <h1>The Pilcrow Papers</h1>
+          <p>You render markdown and get back plain, unstyled HTML - headings,
+          paragraphs, lists, tables. <strong>Typeset</strong> styles everything
+          inside the container from three rhythm variables, and
+          <a href="#rhythm">everything else derives</a>.</p>
+          <h2 id="rhythm">Rhythm</h2>
+          <p>Three controls: <code>--typeset-size</code>,
+          <code>--typeset-leading</code>, and <code>--typeset-flow</code>.</p>
+          <ul>
+            <li>It fits its container - chat bubble or article.</li>
+            <li>It reads your theme tokens, so dark mode is free.</li>
+            <li>Appending a block never restyles earlier blocks.</li>
+          </ul>
+          <blockquote><p>Utilities on an element still win - the rules are
+          zero-specificity.</p></blockquote>
+          <pre><code>gem "poetry-ui"</code></pre>
+          <table>
+            <thead><tr><th>Control</th><th>Default</th></tr></thead>
+            <tbody>
+              <tr><td>size</td><td>1em</td></tr>
+              <tr><td>leading</td><td>1.75</td></tr>
+              <tr><td>flow</td><td>1.25em</td></tr>
+            </tbody>
+          </table>
+        HTML
+
+        def default
+          render_component(class: "max-w-xl") do
+            FIXTURE.html_safe
+          end
+        end
+      end
+    end
+  end
+end

data/app/components/poetry/ui/typeset/style.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Poetry
+  module Ui
+    module Typeset
+      # The switch class only: the actual element rules live in the
+      # app-owned typeset.css (copied at install). No cn-* name - the
+      # artifact is deliberately outside the theme layer: one CSS file
+      # the app owns.
+      class Style < Poetry::Core::Style
+        base "typeset"
+      end
+    end
+  end
+end

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

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Poetry
+  module Ui
+    # Serves llms.txt / llms-full.txt generated live from the component
+    # registry - the docs an LLM retrieves can never drift from the code.
+    class LlmsController < ActionController::Base
+      # GET /poetry/llms.txt - the catalog index.
+      def index
+        render plain: llms_text.index
+      end
+
+      # GET /poetry/llms-full.txt - the full per-component reference.
+      def full
+        render plain: llms_text.full
+      end
+
+      private
+
+      def llms_text
+        # 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)
+      end
+    end
+  end
+end