poetry-charts 0.1.2 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9ddba8811f1d688f8e5404a49df8831559ee34fb35c84f963f1e50c302b1c3c2
-  data.tar.gz: a409c8899a1cabbe20c91f0d50adb82a57622308fbbbab5c8af06a3249f42da9
+  metadata.gz: 73dfd392d17b87636eeea4e4566432c7cd99db60f86a298e0c8f0e4db0ab975a
+  data.tar.gz: 4cffa7098a6f2244c9369584f492f8aaf005ef5738dfc608ac534419c6f7b274
 SHA512:
-  metadata.gz: bab7bbbe2b44f740da46aed0f6f9da2be90fdac7b4ba21d2b8157898e83488e920a60a0317ce7f093942f1bd3fdc17c71a246dc33ab027f1ded7b28041bf33d8
-  data.tar.gz: dfad68141b7d158b2080421e2e57ddcae51445448d3a2754c9b9ae8814bff9fc4e59d470d58cd02c2716b9c28f7e887e2bc191cd19f16fb77927647f12e13899
+  metadata.gz: 0ffc568f9e74a322576b7f2003d821349cdd7cf4849073bd3771d709f637ad33325f11bc3c28d9526ddb17fcef06cd727664d9c45cec463728a46e42b3c17331
+  data.tar.gz: fcdc5263f1d4c8792bd881f68341630b5ec231c3761df8b7d719ef2bebbbe0a780eac62dfb5ba5df0f60b436eb7feff9987bcde338dd0fdb9dc20af1c60fe1ae

data/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## [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.
+
 ## [0.1.2] - 2026-09-13
 
 ### Changed

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,69 @@ 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
+
+        # @api private
+        def axis_margin
+          base = super
+          allowance = category_strip_allowance
+          allowance.positive? ? base.merge(left: Cartesian::DEFAULT_MARGIN[:left] + allowance) : base
+        end
+
+        # @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
+
+        # @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
+
+        # @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
+
+        # @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 +367,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/live.rb

@@ -136,13 +136,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 +297,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/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) => {

data/config/component_registry.yml

@@ -583,7 +583,9 @@ components:
       default: vertical
       description: ":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."
+        and the 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."
     - name: sync
       type: string
     - name: width

data/lib/poetry/charts/version.rb

@@ -3,6 +3,6 @@
 module Poetry
   module Charts
     # The gem version.
-    VERSION = "0.1.2"
+    VERSION = "0.1.4"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: poetry-charts
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.4
 platform: ruby
 authors:
 - Matt Solt
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.1.2
+        version: 0.1.4
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.1.2
+        version: 0.1.4
 description: Charts whose geometry is computed on the server (Ruby; d3-scale/d3-shape
   semantics, recharts' nice ticks) and shipped as finished SVG - no-JS valid, CSS-variable
   themed, zero client chart math. Stimulus chrome reads server-embedded coordinates
@@ -180,7 +180,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.16
+rubygems_version: 4.0.20
 specification_version: 4
 summary: 'Poetry''s chart tier: server-rendered SVG charts for Rails.'
 test_files: []