poetry-charts 0.1.4 → 0.1.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 73dfd392d17b87636eeea4e4566432c7cd99db60f86a298e0c8f0e4db0ab975a
-  data.tar.gz: 4cffa7098a6f2244c9369584f492f8aaf005ef5738dfc608ac534419c6f7b274
+  metadata.gz: 4a52637ce30111cd3f0b53f0362ae2f943b7c9184f04d4e8ff39ff0a5701694a
+  data.tar.gz: 1dd2c325e2d16de0bbc0883332cad6cf1d46c2feea560d28b022dc793b266ddd
 SHA512:
-  metadata.gz: 0ffc568f9e74a322576b7f2003d821349cdd7cf4849073bd3771d709f637ad33325f11bc3c28d9526ddb17fcef06cd727664d9c45cec463728a46e42b3c17331
-  data.tar.gz: fcdc5263f1d4c8792bd881f68341630b5ec231c3761df8b7d719ef2bebbbe0a780eac62dfb5ba5df0f60b436eb7feff9987bcde338dd0fdb9dc20af1c60fe1ae
+  metadata.gz: db9401f68bf56fb3be0c65f725366d89fcf921f2f915acad97dcdb63c37f034d3115ce115744b866b0b57b30d582ad7b8e4dad6e467704e9748f2bf580bbf603
+  data.tar.gz: 9493dc5dc4243deebd4be0169938c72229032d279716f5f0a7244e97ced2654346cdbe316f082fb889030061fbd65868d595f90b76f10c7b0fcf9a9ba78ad6c2

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.6] - 2026-09-20
+
+### Changed
+
+- The gem is developed in the Poetry monorepo, roboruby/poetry, under `gems/poetry-charts`; the gemspec's source, changelog and issue links point there, and its file list no longer needs git on the machine (a path gem inside a slim image lists the same files).
+
+## [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

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

@@ -264,6 +264,7 @@ module Poetry
         # 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
@@ -271,6 +272,7 @@ module Poetry
           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)
@@ -285,6 +287,7 @@ module Poetry
           [[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
@@ -299,12 +302,14 @@ module Poetry
           [((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

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)
 

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_controller.js

@@ -3,24 +3,26 @@ import { applyCartesian } from "@poetry/charts/live/renderer"
 import { captureGeometry, matchJobs, applyJobs, finishJobs } from "@poetry/charts/motion/flip"
 import { tween } from "@poetry/charts/motion/tween"
 
-// The live channel: a chart rendered with live: true carries
-// its {spec, frame} payload in the DOM; this controller re-renders
-// client-side (the kernel renderer, in-place attribute updates) whenever
-// new data arrives - no server round trip. Two channels feed one path:
-//
-//   1. Replace the payload script's JSON - exactly what a
-//      turbo_stream.replace/update does. A MutationObserver picks it up.
-//   2. The JS/event API: dispatch `poetry-chart:update` with
-//      { detail: { data } } on the frame, or call update(data) on the
-//      controller instance.
-//
-// Updates animate through the shared FLIP machinery (old geometry ->
-// new, the same cross-render morph); a structure change (window growth, series
-// change) snaps instead of morphing. The tooltip's
-// embedded coordinates are regenerated by the renderer and a
-// live:updated dispatch tells the tooltip controller to re-read them,
-// so it serves fresh values mid-stream. prefers-reduced-motion snaps
-// every update.
+/**
+ * The live channel: a chart rendered with live: true carries
+ * its {spec, frame} payload in the DOM; this controller re-renders
+ * client-side (the kernel renderer, in-place attribute updates) whenever
+ * new data arrives - no server round trip. Two channels feed one path:
+ *
+ *   1. Replace the payload script's JSON - exactly what a
+ *      turbo_stream.replace/update does. A MutationObserver picks it up.
+ *   2. The JS/event API: dispatch `poetry-chart:update` with
+ *      { detail: { data } } on the frame, or call update(data) on the
+ *      controller instance.
+ *
+ * Updates animate through the shared FLIP machinery (old geometry ->
+ * new, the same cross-render morph); a structure change (window growth, series
+ * change) snaps instead of morphing. The tooltip's
+ * embedded coordinates are regenerated by the renderer and a
+ * live:updated dispatch tells the tooltip controller to re-read them,
+ * so it serves fresh values mid-stream. prefers-reduced-motion snaps
+ * every update.
+ */
 export default class ChartLiveController extends Controller {
   // The events this controller dispatches (manifest surface;
   // events_declaration.test.js enforces the list stays honest).