poetry-charts 0.1.3 → 0.1.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2b2a5247d39050b61ead0f68c9b575831fa82326b7b9571925890df8c1cfff37
-  data.tar.gz: 8a0cb5648b7c2ecc0c018d089360715cf42e8c7bdd1e2b8a5cf504eafad5741f
+  metadata.gz: 72e699a235f9e9de484beb4a29c916524bda13d60ded979c372520be33189275
+  data.tar.gz: 0f1b5d2e8299f0195f5554d026d7006daa3df6b47b976c7ff01d7abd163f84d2
 SHA512:
-  metadata.gz: 47b7b7940d112e8d37c40be21efca67c0a07bb045a85be69d329755835604c135b333c4d20360813d6d051904d4f943db52856ecec744d8cb032b6cfa56f4776
-  data.tar.gz: 6a397692dd6c25fd37ae21b96293db1db28f26226c7746b6a11d2d735ee7ec00b7b7f614a4f8a2b7ffa17167ccb989808780947a652efe17bf4db398c75d438d
+  metadata.gz: 518bf2c87c5a39bd5915fbd143d9342846f8156c9e9382aca1c8d9e09518d024f1ae651ebb1bbfc655eed55bc787e4999823335fda7bcfd0f0ff1aae89b0eb0f
+  data.tar.gz: 54b8823fea3ab138f3a5394cdf4a90188c21b9f937964ad770fa09238ea6cff00c893df3c059d999a416cade33e9bc38c43192edff3158a17a0d98879c8d7037

data/.controller_docs

@@ -0,0 +1 @@
+0

data/.jsdoc_floor

@@ -0,0 +1 @@
+53

data/.mcp.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "rubydex": {
+      "command": "bundle",
+      "args": ["exec", "rdx", "mcp"]
+    }
+  }
+}

data/.yard-lint.yml

@@ -0,0 +1,25 @@
+# yard-lint: the documentation tier YARD's own gates miss - a documented
+# method missing a @param, an @example that does not parse, option tags,
+# tag order, invalid types. Runs as rake yard:lint (in the default task).
+# UndocumentedObjects stays off: yard:coverage gates public objects at its
+# recorded floor, and this validator counts the @api private internals the
+# gems hide on purpose (--hide-api is not honoured here). MissingReturn is
+# off until the @param backlog is cleared; revisit then.
+AllValidators:
+  YardOptions:
+    - --no-private
+Documentation/UndocumentedObjects:
+  Enabled: false
+Documentation/MissingReturn:
+  Enabled: false
+Tags/InvalidTypes:
+  Enabled: true
+# A **options splat passed through to a control is documented as @param
+# options [Hash], not one @option per key; and @example blocks here are
+# ERB as often as Ruby, which this validator cannot parse.
+Documentation/UndocumentedOptions:
+  Enabled: false
+Tags/OptionTags:
+  Enabled: false
+Tags/ExampleSyntax:
+  Enabled: false

data/.yard_coverage_all

@@ -0,0 +1 @@
+0

data/Archspec.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+# The architecture the family enforces by review, as checks (rake arch:check).
+# charts depends on core, and on ui only through the registry: no chart
+# names a ui component class.
+root "."
+source "app/**/*.rb", "lib/**/*.rb"
+
+component :components, in: "app/components/**/*.rb"
+component :lib, in: "lib/**/*.rb"
+
+lib.cannot_use :components, because: "lib reaches the components through the registry"
+lib.cannot_reference_constants "Poetry::Ui", "Poetry::Agent", "Poetry::Extract", "ApplicationController",
+                               because: "charts depends on core, on ui through the registry only, never the host"
+components.cannot_reference_constants "Poetry::Ui", "Poetry::Agent", "Poetry::Extract", "ApplicationController",
+                                      because: "charts depends on core, on ui through the registry only, never the host"
+no_cycles among: %i[lib components]

data/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## [0.1.5] - 2026-09-18
+
+### Added
+
+- The controllers manifest carries the prose beside each controller: its purpose (a JSDoc block above the class), the meaning of every value, and a summary of every action method, harvested when the manifest is generated; `rake stimulus:docs` holds the count of gaps at a committed floor, now zero.
+
+### Changed
+
+- The registry carries the gem's internal namespaces (`internals`), so `poetry check` can warn a host that names one.
+- 9 methods the reference already hid with `@api private` are Ruby-private now: each was called only by its own class or template, so the runtime enforces what the tag only stated. A host that reached one gets a NoMethodError instead of an internal that may change without notice. The tag remains on the internals the family shares between its gems and on whole internal classes.
+- Every class, module and method carries a one-sentence description, private helpers included: `rake yard:coverage:all` measures the whole tree (a tag-only docstring counts as blank) and the committed floor now stands at zero.
+- The area, line and composed charts draw their gridlines through one `grid_svg` builder instead of three identical template blocks; every visual baseline still matches.
+- The container, legend, tooltip and tooltip layer roots ride the core default `root_attributes`, passing only their own markup up; the rendered attributes are unchanged apart from their order on the element.
+
+## [0.1.4] - 2026-09-15
+
+### Changed
+
+- A horizontal bar chart's category strip fits its labels. The reserved left strip held about eight characters at the tick size, so a merchant name or a title was cut at the SVG edge. The strip now grows through the left margin to fit the longest formatted label (estimated by character count, capped at forty percent of the width), labels past the cap end in an ellipsis, and a live chart's recompute prints the same. An explicit `margin: { left: }` is the caller's layout and keeps the reserved strip.
+
 ## [0.1.3] - 2026-09-13
 
 Lockstep release with the family; no changes in this gem.

data/app/components/poetry/charts/area_chart/component.html.erb

@@ -15,20 +15,7 @@
         <% end %>
       </defs>
     <% end %>
-    <% if grid? %>
-      <g data-slot="chart-grid" aria-hidden="true">
-        <% if grid_config.horizontal %>
-          <% cartesian.y_ticks.each do |tick| %>
-            <line class="<%= css(:grid_line) %>" x1="<%= fnum(cartesian.plot_left) %>" x2="<%= fnum(cartesian.plot_right) %>" y1="<%= fnum(cartesian.y_scale.call(tick)) %>" y2="<%= fnum(cartesian.y_scale.call(tick)) %>" />
-          <% end %>
-        <% end %>
-        <% if grid_config.vertical %>
-          <% cartesian.x_centers.each do |x| %>
-            <line class="<%= css(:grid_line) %>" x1="<%= fnum(x) %>" x2="<%= fnum(x) %>" y1="<%= fnum(cartesian.plot_top) %>" y2="<%= fnum(cartesian.plot_bottom) %>" />
-          <% end %>
-        <% end %>
-      </g>
-    <% end %>
+    <%= grid_svg %>
     <%= cursor_svg(:line) %>
     <g data-slot="chart-areas"<% if animate? %> clip-path="url(#<%= chart_id %>-reveal)"<% end %>>
       <% series_entries.each do |entry| %>

data/app/components/poetry/charts/bar_chart/component.rb

@@ -72,7 +72,9 @@ module Poetry
         option :orientation, :symbol, default: :vertical,
                                       doc: ":vertical = columns (the default); :horizontal = bars growing rightward " \
                                            "- the category axis moves to the Y side (with_y_axis data_key:) and the " \
-                                           "numeric axis hides."
+                                           "numeric axis hides. The category strip widens to fit the longest label " \
+                                           "(up to 40% of the width; longer labels end in an ellipsis) unless " \
+                                           "margin: sets left: yourself."
 
         validates :offset, inclusion: { in: Cartesian::OFFSETS }
         validates :orientation, inclusion: { in: Cartesian::LAYOUTS }
@@ -242,9 +244,74 @@ module Poetry
           formatter ? formatter.call(category).to_s : category.to_s
         end
 
-        # The horizontal layout's category labels (the Y side).
+        # The horizontal layout's category labels (the Y side), cut to the
+        # strip with an ellipsis when the strip is auto-sized and capped.
         # @api private
         def category_tick_label(category)
+          label = formatted_category_label(category)
+          limit = category_label_max_chars
+          limit && label.length > limit ? "#{label[0, limit - 1]}…" : label
+        end
+
+        # The reserved left strip (Cartesian::Y_AXIS_WIDTH) fits about
+        # eight characters at the 12px tick size. In the horizontal layout
+        # the strip grows through the left margin to fit the longest
+        # formatted label - estimated by character count, capped at
+        # CATEGORY_STRIP_SHARE of the width - so merchant names and titles
+        # are not clipped at the SVG edge. An explicit margin left: is the
+        # caller's layout and switches the estimate (and the ellipsis) off.
+        CATEGORY_LABEL_CHAR_WIDTH = 6.4
+        # The widest the auto-sized strip may grow, as a share of the width.
+        CATEGORY_STRIP_SHARE = 0.4
+
+        # The axis margin, widened on the left by the category strip allowance when the strip auto-sizes.
+        # @api private
+        def axis_margin
+          base = super
+          allowance = category_strip_allowance
+          allowance.positive? ? base.merge(left: Cartesian::DEFAULT_MARGIN[:left] + allowance) : base
+        end
+
+        # Whether the category strip sizes itself: a horizontal chart with a y axis and no explicit left margin.
+        # @api private
+        def auto_category_strip?
+          horizontal? && y_axis? && !(margin || {}).to_h.symbolize_keys.key?(:left)
+        end
+
+        # Pixels the left margin grows by so the strip fits the labels.
+        # @api private
+        def category_strip_allowance
+          return 0 unless auto_category_strip?
+
+          needed = (longest_category_label * CATEGORY_LABEL_CHAR_WIDTH) + y_axis_config.tick_margin.to_f
+          [[needed, category_strip_cap].min - Cartesian::Y_AXIS_WIDTH, 0].max.ceil
+        end
+
+        # The most pixels the category strip may take, a share of the chart width.
+        # @api private
+        def category_strip_cap
+          (width * CATEGORY_STRIP_SHARE).floor
+        end
+
+        # Characters a label may keep before the ellipsis, nil when the
+        # strip is not auto-sized.
+        # @api private
+        def category_label_max_chars
+          return nil unless auto_category_strip?
+
+          [((category_strip_cap - y_axis_config.tick_margin.to_f) / CATEGORY_LABEL_CHAR_WIDTH).floor, 2].max
+        end
+
+        # The longest formatted category label, in characters.
+        # @api private
+        def longest_category_label
+          key = y_axis_config.data_key
+          data.map { |row| formatted_category_label(row.to_h[key] || row.to_h[key.to_sym]).length }.max || 0
+        end
+
+        # A category through the y axis's tick formatter when one is given, else as text.
+        # @api private
+        def formatted_category_label(category)
           formatter = y_axis_config&.tick_formatter
           formatter ? formatter.call(category).to_s : category.to_s
         end
@@ -305,12 +372,15 @@ module Poetry
           {
             "barGap" => bar_gap,
             "barCategoryGap" => bar_category_gap,
+            "categoryLabelMaxChars" => category_label_max_chars,
             "series" => series_entries.to_h { |e| [e.key, { "radius" => e.radius }] }
           }
         end
 
         private :cartesian, :bar_slots, :cells, :bar_path, :cell_fill, :active?
         private :cell_label, :x_tick_label, :category_tick_label, :y_tick_label, :svg_label_prefix, :coordinates_json
+        private :axis_margin, :auto_category_strip?, :category_strip_allowance, :category_strip_cap
+        private :category_label_max_chars, :longest_category_label, :formatted_category_label
         private :live_type, :live_series, :live_axes, :live_x_scale_type, :live_category_axis?, :live_frame_extras
       end
     end

data/app/components/poetry/charts/bar_math.rb

@@ -90,6 +90,8 @@ module Poetry
         text = value.to_s
         text.end_with?("%") ? total * (text.to_f / 100.0) : text.to_f
       end
+
+      private :bar_slots_for, :bar_cells, :motion_origin, :bar_path_for, :bar_percent_value
     end
   end
 end

data/app/components/poetry/charts/cartesian_family.rb

@@ -25,6 +25,7 @@ module Poetry
     #     include Poetry::Charts::CartesianFamily
     #   end
     module CartesianFamily
+      # Declares the x axis, the value axis, the grid and the class-level helpers on the including chart.
       def self.included(base)
         base.extend(ClassMethods)
 
@@ -99,7 +100,30 @@ module Poetry
         @grid_config
       end
 
-      private :x_axis_config, :y_axis_config, :grid_config
+      # The gridlines group, per the grid slot: horizontal rules at the value
+      # ticks, vertical rules at the category centers; nil without the slot.
+      def grid_svg
+        return unless grid?
+
+        lines = []
+        if grid_config.horizontal
+          cartesian.y_ticks.each do |tick|
+            y = cartesian.y_scale.call(tick)
+            lines << grid_line(cartesian.plot_left, cartesian.plot_right, y, y)
+          end
+        end
+        if grid_config.vertical
+          cartesian.x_centers.each { |x| lines << grid_line(x, x, cartesian.plot_top, cartesian.plot_bottom) }
+        end
+        tag.g(safe_join(lines), "data-slot": "chart-grid", "aria-hidden": true)
+      end
+
+      # One gridline from one point to another.
+      def grid_line(from_x, to_x, from_y, to_y)
+        tag.line(class: css(:grid_line), x1: fnum(from_x), x2: fnum(to_x), y1: fnum(from_y), y2: fnum(to_y))
+      end
+
+      private :x_axis_config, :y_axis_config, :grid_config, :grid_svg, :grid_line
     end
   end
 end

data/app/components/poetry/charts/composed_chart/component.html.erb

@@ -15,20 +15,7 @@
         <% end %>
       </defs>
     <% end %>
-    <% if grid? %>
-      <g data-slot="chart-grid" aria-hidden="true">
-        <% if grid_config.horizontal %>
-          <% cartesian.y_ticks.each do |tick| %>
-            <line class="<%= css(:grid_line) %>" x1="<%= fnum(cartesian.plot_left) %>" x2="<%= fnum(cartesian.plot_right) %>" y1="<%= fnum(cartesian.y_scale.call(tick)) %>" y2="<%= fnum(cartesian.y_scale.call(tick)) %>" />
-          <% end %>
-        <% end %>
-        <% if grid_config.vertical %>
-          <% cartesian.x_centers.each do |x| %>
-            <line class="<%= css(:grid_line) %>" x1="<%= fnum(x) %>" x2="<%= fnum(x) %>" y1="<%= fnum(cartesian.plot_top) %>" y2="<%= fnum(cartesian.plot_bottom) %>" />
-          <% end %>
-        <% end %>
-      </g>
-    <% end %>
+    <%= grid_svg %>
     <%= cursor_svg(:line) %>
     <%# Declaration order IS paint order. %>
     <% series_entries.each do |entry| %>

data/app/components/poetry/charts/composed_chart/component.rb

@@ -290,6 +290,7 @@ module Poetry
 
         private
 
+        # Records one series of the given mark with the defaults filled in, validating its curve.
         def push_series(mark, key:, **attrs)
           attrs = SERIES_DEFAULTS.merge(attrs)
           if attrs[:curve] && !CURVES.include?(attrs[:curve])

data/app/components/poetry/charts/container/component.html.erb

@@ -1,4 +1,4 @@
-<%= content_tag(:div, **root_attributes.to_attributes) do %>
+<%= content_tag(:div, **root_attributes) do %>
   <% if (css_text = theme_css) %><style><%= css_text.html_safe %></style><% end %>
   <%= content %>
 <% end %>

data/app/components/poetry/charts/container/component.rb

@@ -63,17 +63,16 @@ module Poetry
 
         # The frame div's attributes: part self-identification plus the
         # data-chart scope.
-        # @api private
         def root_attributes
-          html_attributes.merge_if_not_set(
+          super(
             {
               "data-slot" => "chart",
               "data-chart" => chart_id
-            }.merge(component_data_attributes)
+            }
           )
         end
 
-        private :chart_config, :chart_id, :theme_css, :root_attributes
+        private :chart_config, :chart_id, :theme_css
       end
     end
   end

data/app/components/poetry/charts/error_bars.rb

@@ -30,6 +30,8 @@ module Poetry
           "M#{f.call(center_x)},#{f.call(y_low)}V#{f.call(y_high)}" \
           "M#{f.call(center_x - half)},#{f.call(y_high)}H#{f.call(center_x + half)}"
       end
+
+      private :error_range, :error_bar_path
     end
   end
 end

data/app/components/poetry/charts/legend_content/component.html.erb

@@ -1,4 +1,4 @@
-<%= content_tag(:div, **root_attributes.to_attributes) do %>
+<%= content_tag(:div, **root_attributes) do %>
   <% rows.each do |row| %>
     <%= content_tag(toggle ? :button : :div, **(toggle ? toggle_attributes(row) : { data: { slot: "chart-legend-item" }, class: css(:item) })) do %>
       <% unless hide_icon || row[:color].nil? %>

data/app/components/poetry/charts/legend_content/component.rb

@@ -80,11 +80,8 @@ module Poetry
         end
 
         # The legend row's attributes with the part self-identification.
-        # @api private
         def root_attributes
-          html_attributes.merge_if_not_set(
-            { "data-slot" => "chart-legend-content" }.merge(component_data_attributes)
-          )
+          super({ "data-slot" => "chart-legend-content" })
         end
 
         # A swatch's guarded inline background (colors reaching a style
@@ -105,6 +102,7 @@ module Poetry
           entry.theme ? "var(--color-#{entry.key})" : entry.color
         end
 
+        # One legend item's key, label and color, the config filling what the item omits.
         def resolve(item)
           key = (item[:key] || item[:name]).to_s
           entry = chart_config[key]
@@ -115,7 +113,7 @@ module Poetry
           }
         end
 
-        private :chart_config, :rows, :toggle_attributes, :root_attributes, :swatch_style
+        private :chart_config, :rows, :toggle_attributes, :swatch_style
       end
     end
   end

data/app/components/poetry/charts/line_chart/component.html.erb

@@ -1,20 +1,7 @@
 <%= render Poetry::Charts::Container::Component.new(config: chart_config, id: chart_id.delete_prefix("chart-")) do %>
   <%= content_tag(:div, frame_attributes.merge("class" => css(:frame))) do %>
   <svg viewBox="0 0 <%= width %> <%= height %>" class="<%= css(:svg) %>" data-slot="chart-svg" aria-label="<%= svg_label %>" preserveAspectRatio="xMidYMid meet" <%= tag.attributes(svg_interaction_attributes) %>>
-    <% if grid? %>
-      <g data-slot="chart-grid" aria-hidden="true">
-        <% if grid_config.horizontal %>
-          <% cartesian.y_ticks.each do |tick| %>
-            <line class="<%= css(:grid_line) %>" x1="<%= fnum(cartesian.plot_left) %>" x2="<%= fnum(cartesian.plot_right) %>" y1="<%= fnum(cartesian.y_scale.call(tick)) %>" y2="<%= fnum(cartesian.y_scale.call(tick)) %>" />
-          <% end %>
-        <% end %>
-        <% if grid_config.vertical %>
-          <% cartesian.x_centers.each do |x| %>
-            <line class="<%= css(:grid_line) %>" x1="<%= fnum(x) %>" x2="<%= fnum(x) %>" y1="<%= fnum(cartesian.plot_top) %>" y2="<%= fnum(cartesian.plot_bottom) %>" />
-          <% end %>
-        <% end %>
-      </g>
-    <% end %>
+    <%= grid_svg %>
     <%= cursor_svg(:line) %>
     <g data-slot="chart-lines">
       <% series_entries.each do |entry| %>

data/app/components/poetry/charts/live.rb

@@ -17,6 +17,7 @@ module Poetry
       # The live controller's full-string identifier.
       CONTROLLER = "poetry--charts--live"
 
+      # Declares the live update wiring on the including chart: registration, the tooltip re-read and the zoom drag.
       def self.included(base)
         base.extend(ClassMethods)
 
@@ -136,13 +137,22 @@ module Poetry
       # bottom margin the cartesian sees.
       # @api private
       def live_margin
-        base = (margin || {}).to_h.symbolize_keys
+        base = axis_margin
         return base unless brush_config
 
         bottom = (base[:bottom] || Cartesian::DEFAULT_MARGIN[:bottom]).to_f
         base.merge(bottom: bottom + brush_config[:height] + BRUSH_GAP)
       end
 
+      # Hook: the caller's margin, before the brush reserve - a family
+      # that sizes an axis strip from its labels (the bar chart's
+      # horizontal category strip) grows a side here, so the server
+      # geometry and the client recompute read the same margin.
+      # @api private
+      def axis_margin
+        (margin || {}).to_h.symbolize_keys
+      end
+
       # The brush strip's y position - below the plot, above the reserved
       # margin.
       # @api private
@@ -288,7 +298,7 @@ module Poetry
         series_entries.any? { |entry| entry.respond_to?(:labels) && entry.labels }
       end
 
-      private :brush_config, :zoom?, :window_features?, :live_margin, :brush_top, :brush_svg
+      private :brush_config, :zoom?, :window_features?, :live_margin, :axis_margin, :brush_top, :brush_svg
       private :zoom_selection_svg, :window_plot_json, :window_brush_json, :live_payload, :live_payload_json, :live_spec
       private :live_frame, :live_frame_extras, :ensure_live_compatible!, :live_labels_configured?
     end

data/app/components/poetry/charts/motion.rb

@@ -15,6 +15,7 @@ module Poetry
       # The motion controller's full-string identifier.
       CONTROLLER = "poetry--charts--motion"
 
+      # Declares the motion controller on the including chart's frame.
       def self.included(base)
         base.extend(ClassMethods)
 

data/app/components/poetry/charts/polar_family.rb

@@ -20,6 +20,7 @@ module Poetry
       # The default polar margin - a slim, even inset on all sides.
       MARGIN = { top: 5, right: 5, bottom: 5, left: 5 }.freeze
 
+      # Declares the tooltip wiring on the including chart's svg.
       def self.included(base)
         base.use_stimulus do
           on :svg do

data/app/components/poetry/charts/reference_marks.rb

@@ -14,6 +14,7 @@ module Poetry
     # and fnum. Vertical layouts only (a horizontal bar raises - a
     # declared limit).
     module ReferenceMarks
+      # Declares the reference line, area and dot slots on the including chart.
       def self.included(base)
         # A dashed rule across the plot: x: (a category) draws it
         # vertical, y: (a value) horizontal; label: annotates it.
@@ -89,6 +90,7 @@ module Poetry
 
       private
 
+      # One reference mark's SVG, by its kind.
       def reference_mark_svg(mark)
         case mark[:kind]
         when :line then reference_line_svg(mark)
@@ -139,6 +141,7 @@ module Poetry
         safe_join([rect, label])
       end
 
+      # A reference dot's SVG: the circle, and its label above it when given.
       def reference_dot_svg(mark)
         cx = ref_x_pixel(mark[:x])
         cy = ref_y_pixel(mark[:y])

data/app/components/poetry/charts/tooltip_content/component.html.erb

@@ -1,4 +1,4 @@
-<%= content_tag(:div, **root_attributes.to_attributes) do %>
+<%= content_tag(:div, **root_attributes) do %>
   <% if label_text && !nest_label? %><div data-slot="chart-tooltip-label" class="<%= css(:label) %>"><%= label_text %></div><% end %>
   <div class="<%= css(:inner) %>">
     <% rows.each do |row| %>

data/app/components/poetry/charts/tooltip_content/component.rb

@@ -110,37 +110,40 @@ module Poetry
         end
 
         # The box's attributes with the part self-identification.
-        # @api private
         def root_attributes
-          html_attributes.merge_if_not_set(
-            { "data-slot" => "chart-tooltip-content" }.merge(component_data_attributes)
-          )
+          super("data-slot" => "chart-tooltip-content")
         end
 
         # One resolved tooltip row: name via config, color via item-else-config.
         # @api private
         class Row
+          # Wraps one tooltip item with the chart config it resolves against.
           def initialize(item, config)
             @item = item
             @config = config
           end
 
+          # The row's series key: the item's key, else its name, else value.
           def key
             (@item[:key] || @item[:name] || "value").to_s
           end
 
+          # The row's label, through the config.
           def name
             @config.label_for(key, @item[:name])
           end
 
+          # The row's swatch color: the item's own, else the config entry's.
           def color
             @item[:color] || @config[key]&.color
           end
 
+          # The row's raw value.
           def value
             @item[:value]
           end
 
+          # The value as text, a number with thousands separators; nil stays nil.
           def formatted_value
             return nil if value.nil?
             return ActiveSupport::NumberHelper.number_to_delimited(value) if value.is_a?(Numeric)
@@ -161,7 +164,6 @@ module Poetry
         end
 
         private :chart_config, :rows, :nest_label?, :label_text, :row_classes, :indicator_classes, :value_wrap_classes
-        private :root_attributes
       end
     end
   end

data/app/components/poetry/charts/tooltip_layer/component.html.erb

@@ -1,4 +1,4 @@
-<%= content_tag(:div, **root_attributes.to_attributes) do %>
+<%= content_tag(:div, **root_attributes) do %>
   <%= render Poetry::Charts::TooltipContent::Component.new(
         config: chart_config, items: items, label: hide_label ? nil : "…",
         indicator: indicator, hide_label: hide_label, hide_indicator: hide_indicator

data/app/components/poetry/charts/tooltip_layer/component.rb

@@ -43,18 +43,16 @@ module Poetry
 
         # The hidden box's attributes: part self-identification plus the
         # parent frame controller's tooltip target.
-        # @api private
         def root_attributes
-          html_attributes.merge_if_not_set(
+          super(
             {
               "data-slot" => "chart-tooltip",
               "hidden" => ""
-            }.merge(stimulus_attributes_for(:root))
-              .merge(component_data_attributes)
+            }
           )
         end
 
-        private :chart_config, :items, :root_attributes
+        private :chart_config, :items
       end
     end
   end

data/app/javascript/poetry/charts/adapter_controller.js

@@ -1,19 +1,24 @@
 import { Controller } from "@hotwired/stimulus"
 import { chartAdapter } from "@poetry/charts/adapter_registry"
 
-// The adapter mount: reads the FROZEN chart-spec v1 the
-// server embedded, hands it to the registered engine adapter, and owns
-// the lifecycle - render on connect, destroy on disconnect (Turbo-safe),
-// themeChanged on dark-mode flips. The helpers close the canvas gap:
-// resolveColor turns var(--color-key)/var(--chart-N) into concrete
-// values at paint time (CSS variables cannot reach a canvas).
+/**
+ * The adapter mount: reads the FROZEN chart-spec v1 the
+ * server embedded, hands it to the registered engine adapter, and owns
+ * the lifecycle - render on connect, destroy on disconnect (Turbo-safe),
+ * themeChanged on dark-mode flips. The helpers close the canvas gap:
+ * resolveColor turns var(--color-key)/var(--chart-N) into concrete
+ * values at paint time (CSS variables cannot reach a canvas).
+ */
 export default class ChartAdapterController extends Controller {
   // The events this controller dispatches (manifest surface;
   // events_declaration.test.js enforces the list stays honest).
   static events = ["poetry--charts--adapter:rendered"]
 
   static targets = ["mount", "spec"]
-  static values = { engine: String }
+  static values = {
+    // The registered engine adapter that renders the embedded spec.
+    engine: String
+  }
 
   /**
    * Mounts the declared engine: parses the embedded spec, validates the

data/app/javascript/poetry/charts/live/renderer.js

@@ -29,6 +29,11 @@ import {
 const X_AXIS_HEIGHT = 30
 const Y_AXIS_WIDTH = 60
 
+// The server cuts a horizontal chart's category labels to the auto-sized
+// strip with an ellipsis; a recompute prints them the same way.
+const categoryLabel = (label, maxChars) =>
+  maxChars && label.length > maxChars ? `${label.slice(0, maxChars - 1)}…` : label
+
 const CURVES = {
   linear: curveLinear,
   natural: curveNatural,
@@ -413,7 +418,7 @@ function applyAxes(svg, geometry, payload) {
       reconcile(yAxis.querySelectorAll("text"), geometry.categories.length).forEach((text, i) => {
         text.setAttribute("x", fnum(geometry.plotLeft - (frame.yTickMargin ?? 8)))
         text.setAttribute("y", fnum(geometry.xCenters[i]))
-        text.textContent = String(geometry.categories[i])
+        text.textContent = categoryLabel(String(geometry.categories[i]), frame.categoryLabelMaxChars)
       })
     } else {
       reconcile(yAxis.querySelectorAll("text"), geometry.yTicks.length).forEach((text, i) => {