poetry-charts 0.0.2 → 0.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 99231ee56a021b648de82294be7e444f38195bef2046f2df58bd24f0e3a8f46d
-  data.tar.gz: 4561421c7a07d32b09212358b80fb7753e1022b401552d47d3da42d0787fbb05
+  metadata.gz: 1d9c28b2545df07306fa7b6f8392f8549a5123bd15ef1e55eb32fd5d3f5515d3
+  data.tar.gz: cb3328e0f55c18efb58e3d11f7f893d3509a84dd7825d7ea8ccb7c1df5fca5b9
 SHA512:
-  metadata.gz: 0b4dfbc1ca25a2478d3696cd7b5f83e370b50dffd544c89185e1fec3843326920c263073a3cd42f464d2e97bf1d190cccc3bf35d973c0a047ff8dcaf6f6fb8ed
-  data.tar.gz: 4e9e085244c9fc7ac1fcdf23546465854d5f1e6a921bbe6d9b8a9b6a84b1cecd294564b1571c9b1a636f31ad299f19e521254c2b7e470eac4bf6cd3f67577833
+  metadata.gz: f78a9851ffa415adabd9e06ac6d6780126bdfed09634be40ceb3d86ebcc40d553a03c22a95adc4b3ecfdcac9342af55079e48de8a8013b0a892199eba99921bd
+  data.tar.gz: 95be4f0045ae57905563522830a8b98703bdb1c068bc6a9333de4bb7f29132fb75d07ff2c29cdd96c3460a1f90766b72a932efadcb966ac296f3eae1954ba0aa

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

@@ -12,13 +12,13 @@ module Poetry
       # chrome. The content block is the chart body.
       #
       # @example
-      #   <%= poetry_chart_container(config: { desktop: { label: "Desktop", color: "var(--chart-1)" } }) do %>
+      #   <%= poetry_container(config: { desktop: { label: "Desktop", color: "var(--chart-1)" } }) do %>
       #     ...the chart body...
       #   <% end %>
       class Component < Poetry::Core::Component
         # Projected into the registry and agent surface.
         AGENT_RULES = [
-          "Every chart lives inside poetry_chart_container(config:) - the config maps series keys to labels/colors.",
+          "Every chart lives inside poetry_container(config:) - the config maps series keys to labels/colors.",
           "Reference series colors as var(--color-<key>); never hard-code a color in chart markup.",
           "Config colors point at theme tokens (var(--chart-1..5)) or use theme: { light:, dark: } maps.",
           "Give charts an explicit id: when the page renders more than one of the same chart."

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

@@ -10,7 +10,7 @@ module Poetry
       # to override, e.g. per-slice pie legends.
       #
       # @example
-      #   <%= poetry_chart_legend_content(config: config) %>
+      #   <%= poetry_legend_content(config: config) %>
       class Component < Poetry::Core::Component
         # Projected into the registry and agent surface.
         AGENT_RULES = [

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

@@ -12,7 +12,7 @@ module Poetry
       # row's swatch follows its series.
       #
       # @example
-      #   <%= poetry_chart_tooltip_content(config: config,
+      #   <%= poetry_tooltip_content(config: config,
       #                                    items: [{ key: :desktop, value: 186 }]) %>
       #
       # Items are `{ key:, name:, value:, color: }` hashes; names resolve

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

@@ -2,8 +2,12 @@
 
 module Poetry
   module Charts
-    # The poetry_chart_* view helpers - the agent-facing chart surface,
-    # from the chart-root dispatcher down to the per-family helpers.
+    # The poetry_* chart view helpers - the agent-facing chart surface, from
+    # the chart-root dispatcher down to one helper per component. Every
+    # registered component answers to poetry_<component name>, the
+    # convention the registry, `poetry check`, llms.txt, and the skills
+    # derive helper names from; the three poetry_chart_* wrappers stay as
+    # aliases for callers that adopted them.
     module ComponentsHelper
       # Chart type symbols mapped to their component class names - the
       # dispatch table behind poetry_chart.
@@ -85,41 +89,133 @@ module Poetry
         render(Poetry::Charts::BarChart::Component.new(**), &)
       end
 
+      # Renders a composed chart - areas, bars, and lines sharing one x band
+      # and one y domain; declaration order is paint order.
+      #
+      # @example
+      #   <%= poetry_composed_chart(data: data, config: config) do |c| %>
+      #     <% c.with_bar data_key: :desktop %>
+      #     <% c.with_line data_key: :mobile %>
+      #   <% end %>
+      #
+      # @see Poetry::Charts::ComposedChart::Component
+      def poetry_composed_chart(**, &)
+        render(Poetry::Charts::ComposedChart::Component.new(**), &)
+      end
+
+      # Renders a pie chart - one or more rings of slices; inner_radius on a
+      # pie makes the donut, with_center_label fills the hole.
+      #
+      # @example
+      #   <%= poetry_pie_chart(data: data, config: config) do |c| %>
+      #     <% c.with_pie data_key: :visitors, name_key: :browser, inner_radius: 60 %>
+      #     <% c.with_tooltip %>
+      #   <% end %>
+      #
+      # @see Poetry::Charts::PieChart::Component
+      def poetry_pie_chart(**, &)
+        render(Poetry::Charts::PieChart::Component.new(**), &)
+      end
+
+      # Renders a radar chart - series drawn as polygons over a polar grid.
+      #
+      # @example
+      #   <%= poetry_radar_chart(data: data, config: config) do |c| %>
+      #     <% c.with_radar data_key: :desktop %>
+      #   <% end %>
+      #
+      # @see Poetry::Charts::RadarChart::Component
+      def poetry_radar_chart(**, &)
+        render(Poetry::Charts::RadarChart::Component.new(**), &)
+      end
+
+      # Renders a radial bar chart - values as arcs around a shared center.
+      #
+      # @example
+      #   <%= poetry_radial_bar_chart(data: data, config: config) do |c| %>
+      #     <% c.with_radial_bar data_key: :visitors %>
+      #   <% end %>
+      #
+      # @see Poetry::Charts::RadialBarChart::Component
+      def poetry_radial_bar_chart(**, &)
+        render(Poetry::Charts::RadialBarChart::Component.new(**), &)
+      end
+
+      # Renders a scatter chart - points positioned by two numeric keys.
+      #
+      # @example
+      #   <%= poetry_scatter_chart(data: data, config: config) do |c| %>
+      #     <% c.with_scatter data_key: :desktop %>
+      #   <% end %>
+      #
+      # @see Poetry::Charts::ScatterChart::Component
+      def poetry_scatter_chart(**, &)
+        render(Poetry::Charts::ScatterChart::Component.new(**), &)
+      end
+
+      # Renders the adapter mount directly - the closed spec (type:,
+      # engine:, series:, axes:) handed to a registered client-side engine.
+      # poetry_chart(type, engine:) is the same call with the type first.
+      #
+      # @example
+      #   <%= poetry_adapter_chart(type: :line, engine: :chartjs, data: data, config: config,
+      #                            series: [{ data_key: :desktop }]) %>
+      #
+      # @see Poetry::Charts::AdapterChart::Component
+      def poetry_adapter_chart(**)
+        render(Poetry::Charts::AdapterChart::Component.new(**))
+      end
+
       # Renders the chart container - the sized, theme-scoped wrapper that
       # emits var(--color-<key>) for every configured series and hosts the
       # chart plus its tooltip and legend.
       #
       # @example
-      #   <%= poetry_chart_container(config: config, class: "h-64") do %>
+      #   <%= poetry_container(config: config, class: "h-64") do %>
       #     <%= poetry_area_chart(data: data, config: config) %>
       #   <% end %>
       #
       # @see Poetry::Charts::Container::Component
-      def poetry_chart_container(**, &)
+      def poetry_container(**, &)
         render(Poetry::Charts::Container::Component.new(**), &)
       end
+      alias poetry_chart_container poetry_container
 
       # Renders the tooltip panel a chart's hover layer positions and fills -
       # place it inside the container alongside the chart.
       #
       # @example
-      #   <%= poetry_chart_tooltip_content(indicator: :line) %>
+      #   <%= poetry_tooltip_content(indicator: :line) %>
       #
       # @see Poetry::Charts::TooltipContent::Component
-      def poetry_chart_tooltip_content(**, &)
+      def poetry_tooltip_content(**, &)
         render(Poetry::Charts::TooltipContent::Component.new(**), &)
       end
+      alias poetry_chart_tooltip_content poetry_tooltip_content
+
+      # Renders the hover layer that positions the tooltip over a chart -
+      # the charts attach it themselves through with_tooltip; reach for the
+      # helper only when composing the layer by hand.
+      #
+      # @example
+      #   <%= poetry_tooltip_layer(chart_id: "traffic") %>
+      #
+      # @see Poetry::Charts::TooltipLayer::Component
+      def poetry_tooltip_layer(**, &)
+        render(Poetry::Charts::TooltipLayer::Component.new(**), &)
+      end
 
       # Renders a standalone legend for the configured series - a swatch
       # plus label per entry.
       #
       # @example
-      #   <%= poetry_chart_legend_content(config: config) %>
+      #   <%= poetry_legend_content(config: config) %>
       #
       # @see Poetry::Charts::LegendContent::Component
-      def poetry_chart_legend_content(**, &)
+      def poetry_legend_content(**, &)
         render(Poetry::Charts::LegendContent::Component.new(**), &)
       end
+      alias poetry_chart_legend_content poetry_legend_content
     end
   end
 end

data/config/component_registry.yml

@@ -1314,7 +1314,7 @@ components:
     elements: []
     capsule: 7b90eeaff974
     agent_rules:
-    - Every chart lives inside poetry_chart_container(config:) - the config maps series
+    - Every chart lives inside poetry_container(config:) - the config maps series
       keys to labels/colors.
     - Reference series colors as var(--color-<key>); never hard-code a color in chart
       markup.
@@ -3046,10 +3046,20 @@ helpers:
   poetry_chart:
     yields: the dispatched chart component
 helper_args:
+  poetry_adapter_chart: 0
   poetry_area_chart: 0
   poetry_bar_chart: 0
   poetry_chart: 1
   poetry_chart_container: 0
   poetry_chart_legend_content: 0
   poetry_chart_tooltip_content: 0
+  poetry_composed_chart: 0
+  poetry_container: 0
+  poetry_legend_content: 0
   poetry_line_chart: 0
+  poetry_pie_chart: 0
+  poetry_radar_chart: 0
+  poetry_radial_bar_chart: 0
+  poetry_scatter_chart: 0
+  poetry_tooltip_content: 0
+  poetry_tooltip_layer: 0

data/lib/poetry/charts/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: poetry-charts
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.4
 platform: ruby
 authors:
 - Matt Solt
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.0.2
+        version: 0.0.4
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.0.2
+        version: 0.0.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