poetry-charts 0.0.2

data/config/component_registry.yml

@@ -0,0 +1,3055 @@
+# poetry component registry - generated by `bin/rake registry:generate` FROM SOURCE.
+# DO NOT EDIT: CI verifies this file matches a fresh build (rake registry:verify).
+---
+components:
+  poetry/charts/adapter_chart:
+    class_name: Poetry::Charts::AdapterChart::Component
+    identifier: poetry--charts--adapter_chart
+    bem_block: poetry-charts-adapter_chart
+    styles: []
+    options:
+    - name: axes
+      type:
+      description: 'The axis config ({ x:, y: } hashes), also spec-carried.'
+    - name: config
+      type:
+      required: true
+      description: 'The series config - key => { label:, color: } - naming and coloring
+        every series.'
+    - name: data
+      type:
+      required: true
+      description: The rows to plot, serialized into the spec.
+    - name: engine
+      type: string
+      required: true
+      description: The registered adapter's name; the controller hands it the mount
+        and the spec.
+    - name: id
+      type: string
+      description: Explicit DOM id token, stable across renders; otherwise the chart
+        gets a unique per-render id.
+    - name: label
+      type: string
+      description: Accessible name for the mount; defaults to one built from the type
+        and engine.
+    - name: series
+      type:
+      required: true
+      description: The series list ({ data_key:, ... } hashes) - the closed spec's
+        replacement for slots.
+    - name: type
+      type: symbol
+      variants:
+      - area
+      - bar
+      - line
+      - pie
+      - radar
+      - radial
+      required: true
+      description: The chart type carried in the spec (see Spec::TYPES).
+    slots: []
+    description: 'The bring-your-own-engine path: a themed mount and chart-spec JSON
+      for a client library (Chart.js, etc.) to draw, instead of poetry''s server-side
+      SVG.'
+    elements:
+    - frame
+    - mount
+    capsule: 9305db093df7
+    controllers:
+    - identifier: poetry--charts--adapter
+      targets:
+      - mount
+      - spec
+      values:
+      - engine
+      actions: []
+      events:
+      - poetry--charts--adapter:rendered
+    agent_rules:
+    - 'The adapter path takes series:/axes: ARGUMENTS (the closed spec), not slots.'
+    - 'The host must register the engine first: registerChartAdapter(name, adapter)
+      - poetry ships createChartJsAdapter(Chart) as the reference.'
+    - 'The Container contract still applies: config colors, --chart tokens, dark mode.'
+    - Prefer the default engine; adapters are for engine-specific needs (e.g. >10k
+      points on canvas).
+    parts:
+    - name: chart-adapter-mount
+      description: The engine's drawing surface (role=img carrying the accessible
+        label) - the registered adapter renders into it
+    - name: chart-spec
+      description: The frozen chart-spec v1, served as JSON in an application/json
+        script for the adapter to consume
+    stimulus:
+    - element: frame
+      controllers:
+      - identifier: poetry--charts--adapter
+        registers: true
+        values:
+        - name: engine
+    - element: mount
+      controllers:
+      - identifier: poetry--charts--adapter
+        targets:
+        - name: mount
+    - element: spec
+      controllers:
+      - identifier: poetry--charts--adapter
+        targets:
+        - name: spec
+  poetry/charts/area_chart:
+    class_name: Poetry::Charts::AreaChart::Component
+    identifier: poetry--charts--area_chart
+    bem_block: poetry-charts-area_chart
+    styles: []
+    options:
+    - name: animate
+      type: boolean
+      default: true
+      description: Entrance animation switch - reduced-motion users always get the
+        finished chart regardless.
+    - name: animation_begin
+      type: integer
+      default: 0
+      description: Pre-animation hold in milliseconds.
+    - name: animation_duration
+      type: integer
+      default: 1500
+      description: Entrance/morph duration in milliseconds.
+    - name: animation_easing
+      type: symbol
+      default: ease
+      description: Animation easing keyword (see EASINGS).
+    - name: config
+      type:
+      required: true
+      description: 'The series config - key => { label:, color: } - naming and coloring
+        every series.'
+    - name: data
+      type:
+      required: true
+      description: 'The rows to plot: an array of hashes, one per x category.'
+    - name: height
+      type: integer
+      default: 360
+      description: ViewBox height in pixels.
+    - name: id
+      type: string
+      description: Explicit DOM id token, stable across renders; otherwise the chart
+        gets a unique per-render id.
+    - name: label
+      type: string
+      description: Accessible name for the chart SVG; defaults to one built from the
+        configured series.
+    - name: live
+      type: boolean
+      default: false
+      description: Embeds the {spec, frame} payload so the client renderer can recompute
+        geometry when data changes without a server round-trip.
+    - name: margin
+      type:
+      description: 'Plot margin overrides ({ top:, right:, bottom:, left: }), merged
+        over the defaults.'
+    - name: offset
+      type: symbol
+      variants:
+      - none
+      - expand
+      default: none
+      description: Stack baseline mode - :expand normalizes each stack to percentages.
+    - name: sync
+      type: string
+    - name: width
+      type: integer
+      default: 640
+      description: ViewBox width in pixels; the rendered chart scales to its container.
+    - name: zoom
+      type: boolean
+      default: false
+      description: 'Drag-to-zoom on the plot; slices the data client-side, so it needs
+        live: true.'
+    slots:
+    - name: reference_lines
+      many: true
+      setter_args:
+        reference_line: 0
+      setter_kwargs:
+        reference_line:
+        - x
+        - "y"
+        - label
+        - stroke_dasharray
+    - name: reference_areas
+      many: true
+      setter_args:
+        reference_area: 0
+      setter_kwargs:
+        reference_area:
+        - x1
+        - x2
+        - y1
+        - y2
+        - label
+        - fill_opacity
+    - name: reference_dots
+      many: true
+      setter_args:
+        reference_dot: 0
+      setter_kwargs:
+        reference_dot:
+        - x
+        - "y"
+        - r
+        - label
+    - name: brush
+      many: false
+      description: 'The brush strip below the x axis - drag its window to slice the
+        visible range; needs live: true.'
+      setter_args:
+        brush: 0
+      setter_kwargs:
+        brush:
+        - height
+    - name: areas
+      many: true
+      description: 'An area series bound to data_key:. Areas sharing a stack: id pile
+        up; gradient: true fades the fill; curve: picks the interpolation.'
+      setter_args:
+        area: 0
+      setter_kwargs:
+        area:
+        - data_key
+        - stack
+        - curve
+        - fill_opacity
+        - gradient
+        - stroke_width
+    - name: x_axis
+      many: false
+      setter_args:
+        x_axis: 0
+      setter_kwargs:
+        x_axis:
+        - data_key
+        - tick_formatter
+        - tick_margin
+    - name: y_axis
+      many: false
+      description: 'The value axis: tick_count: sets how many ticks show; tick_formatter:
+        reshapes each label; tick_margin: pads it.'
+      setter_args:
+        y_axis: 0
+      setter_kwargs:
+        y_axis:
+        - tick_count
+        - tick_formatter
+        - tick_margin
+    - name: grid
+      many: false
+      setter_args:
+        grid: 0
+      setter_kwargs:
+        grid:
+        - vertical
+        - horizontal
+    - name: legend
+      many: false
+      setter_args:
+        legend: 0
+    - name: tooltip
+      many: false
+      setter_args:
+        tooltip: 0
+    description: An area chart for volume or cumulative totals over a continuous axis.
+    elements:
+    - frame
+    - svg
+    - grid_line
+    - tick
+    - cursor_line
+    - cursor_band
+    - reference_line
+    - reference_area
+    - reference_dot
+    - error_bar
+    - brush_track
+    - brush_window
+    - brush_handle
+    capsule: adf1ec3bc1d1
+    controllers:
+    - identifier: poetry--charts--live
+      targets:
+      - payload
+      values: []
+      actions:
+      - receive
+      - setWindow
+      - toggleSeries
+      - update
+      events:
+      - poetry--charts--live:settled
+      - poetry--charts--live:updated
+    - identifier: poetry--charts--motion
+      targets: []
+      values: []
+      actions: []
+      events:
+      - poetry--charts--motion:settled
+    - identifier: poetry--charts--tooltip
+      targets:
+      - data
+      - svg
+      - tooltip
+      values:
+      - sync
+      actions:
+      - blur
+      - count
+      - enter
+      - focus
+      - keydown
+      - leave
+      - move
+      - refresh
+      - show
+      events:
+      - poetry--charts--tooltip:hide
+      - poetry--charts--tooltip:show
+    - identifier: poetry--charts--window
+      targets: []
+      values:
+      - brush
+      - plot
+      - zoom
+      actions:
+      - reset
+      - startBrush
+      - startZoom
+      events: []
+    agent_rules:
+    - 'Compose from slots: with_grid / with_x_axis(data_key:) / with_area(data_key:)
+      / with_legend.'
+    - 'Stack areas by giving them the same stack: id; offset: :expand makes the stack
+      percent-based.'
+    - Colors come from the config - never set fill/stroke on an area directly.
+    - 'gradient: true on an area gets the source''s 5%/95% fade fill.'
+    - Charts render complete on the server; the tooltip layer attaches separately.
+    - 'Entrance animation is on by default (source parity); animate: false for a static
+      chart. Reduced-motion users always get the finished chart.'
+    parts:
+    - name: chart-brush
+      description: 'The brush strip group (with_brush): track + window + two handles
+        below the x axis'
+    - name: chart-brush-track
+      description: The full-width brush rail
+    - name: chart-brush-window
+      description: The selected-range rect the drag moves
+    - name: chart-brush-handle
+      description: One draggable window edge
+      states:
+      - attr: data-edge
+        condition: always - which edge
+        values:
+        - start
+        - end
+    - name: chart-zoom-selection
+      description: 'The zoom drag-selection overlay (zoom: true), hidden until a drag
+        starts'
+    - name: chart-live-payload
+      description: The embedded {spec, frame} JSON the live renderer recomputes geometry
+        from
+    - name: chart-svg
+      description: The chart canvas (<svg>) - server-computed geometry in a fixed
+        viewBox; role=img, or the focusable role=application accessibilityLayer when
+        the tooltip attaches
+      states:
+      - attr: data-animate
+        condition: present when animate (the default) - the motion stylesheet and
+          controller key the entrance off it
+      - attr: data-motion
+        condition: runtime - the motion rig stamps the animation lifecycle (entrance/morph,
+          then settled)
+        values:
+        - entrance
+        - morph
+        - settled
+      vars:
+      - name: "--poetry-motion-duration"
+        description: the entrance/morph duration (animation_duration, ms)
+      - name: "--poetry-motion-easing"
+        description: the animation easing keyword (animation_easing)
+      - name: "--poetry-motion-delay"
+        description: the pre-animation hold (animation_begin, ms)
+    - name: chart-motion-reveal
+      description: The entrance clipPath rect (the ported area reveal) - the motion
+        stylesheet scales it 0 -> 1; only when animate
+    - name: chart-grid
+      description: The gridline group (with_grid) - horizontal and/or vertical rules
+        across the plot
+    - name: chart-cursor
+      description: The hover cursor, hidden until the tooltip controller positions
+        and reveals it at the active index - a vertical rule or a translucent band
+        rect (bar charts)
+    - name: chart-areas
+      description: The area-mark group - a fill path plus top-curve stroke per series,
+        clipped by the reveal rect while animating
+    - name: chart-area
+      description: One series' fill path (var(--color-<key>) or its gradient)
+      states:
+      - attr: data-key
+        condition: the series key
+    - name: chart-area-stroke
+      description: One series' top-curve stroke path (the source strokes the curve,
+        never the area outline)
+      states:
+      - attr: data-key
+        condition: the series key
+    - name: chart-active-dots
+      description: The hover-marker group (with_tooltip) - pre-rendered hidden circles
+        for every series x index
+    - name: chart-active-dot
+      description: One hover marker - display=none until the tooltip controller reveals
+        the active index's dot
+      states:
+      - attr: data-key
+        condition: the series key
+      - attr: data-index
+        condition: the datum index
+      - attr: data-active
+        condition: runtime - rides the marker while its index is the active one
+    - name: chart-x-axis
+      description: The x-axis tick-label group (with_x_axis)
+    - name: chart-y-axis
+      description: The y-axis tick-label group (with_y_axis)
+    - name: chart-coordinates
+      description: The embedded per-index geometry payload (<script type=application/json>)
+        the tooltip controller reads - zero chart math in the browser
+    stimulus:
+    - element: frame
+      controllers:
+      - identifier: poetry--charts--tooltip
+        conditional: if tooltip?
+        registers: true
+        values:
+        - name: sync
+          conditional: if
+      - identifier: poetry--charts--motion
+        conditional: if animate?
+        registers: true
+      - identifier: poetry--charts--live
+        conditional: if live?
+        registers: true
+        actions:
+        - method: receive
+          'on': poetry-chart:update
+      - identifier: poetry--charts--tooltip
+        conditional: if
+        actions:
+        - method: refresh
+          'on': poetry--charts--live:updated
+      - identifier: poetry--charts--window
+        conditional: if window_features?
+        registers: true
+        values:
+        - name: zoom
+        - name: plot
+        - name: brush
+          conditional: if
+    - element: svg
+      controllers:
+      - identifier: poetry--charts--tooltip
+        conditional: if tooltip?
+        targets:
+        - name: svg
+        actions:
+        - method: move
+          'on': pointermove
+        - method: leave
+          'on': pointerleave
+        - method: focus
+          'on': focus
+        - method: blur
+          'on': blur
+        - method: keydown
+          'on': keydown
+      - identifier: poetry--charts--window
+        conditional: if zoom?
+        actions:
+        - method: startZoom
+          'on': pointerdown
+        - method: reset
+          'on': dblclick
+    - element: coordinates
+      controllers:
+      - identifier: poetry--charts--tooltip
+        conditional: if tooltip?
+        targets:
+        - name: data
+    - element: tooltip_layer
+      controllers:
+      - identifier: poetry--charts--tooltip
+        conditional: if tooltip?
+        targets:
+        - name: tooltip
+    - element: live_payload
+      controllers:
+      - identifier: poetry--charts--live
+        targets:
+        - name: payload
+    - element: brush
+      controllers:
+      - identifier: poetry--charts--window
+        conditional: if
+        actions:
+        - method: startBrush
+          'on': pointerdown
+  poetry/charts/bar_chart:
+    class_name: Poetry::Charts::BarChart::Component
+    identifier: poetry--charts--bar_chart
+    bem_block: poetry-charts-bar_chart
+    styles: []
+    options:
+    - name: animate
+      type: boolean
+      default: true
+      description: Entrance animation switch - reduced-motion users always get the
+        finished chart regardless.
+    - name: animation_begin
+      type: integer
+      default: 0
+      description: Pre-animation hold in milliseconds.
+    - name: animation_duration
+      type: integer
+      default: 400
+      description: Entrance/morph duration in milliseconds.
+    - name: animation_easing
+      type: symbol
+      default: ease
+      description: Animation easing keyword (see EASINGS).
+    - name: bar_category_gap
+      type: string
+      default: 10%
+      description: 'Band trim on each side: a percent string of the band width, or
+        a bare pixel number.'
+    - name: bar_gap
+      type: integer
+      default: 4
+      description: Pixels between side-by-side bars inside one category band.
+    - name: config
+      type:
+      required: true
+      description: 'The series config - key => { label:, color: } - naming and coloring
+        every series.'
+    - name: data
+      type:
+      required: true
+      description: 'The rows to plot: an array of hashes, one per category.'
+    - name: height
+      type: integer
+      default: 360
+      description: ViewBox height in pixels.
+    - name: id
+      type: string
+      description: Explicit DOM id token, stable across renders; otherwise the chart
+        gets a unique per-render id.
+    - name: label
+      type: string
+      description: Accessible name for the chart SVG; defaults to one built from the
+        configured series.
+    - name: live
+      type: boolean
+      default: false
+      description: Embeds the {spec, frame} payload so the client renderer can recompute
+        geometry when data changes without a server round-trip.
+    - name: margin
+      type:
+      description: 'Plot margin overrides ({ top:, right:, bottom:, left: }), merged
+        over the defaults.'
+    - name: offset
+      type: symbol
+      variants:
+      - none
+      - expand
+      default: none
+      description: Stack baseline mode - :expand normalizes each stack to percentages.
+    - name: orientation
+      type: symbol
+      variants:
+      - vertical
+      - horizontal
+      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."
+    - name: sync
+      type: string
+    - name: width
+      type: integer
+      default: 640
+      description: ViewBox width in pixels; the rendered chart scales to its container.
+    - name: zoom
+      type: boolean
+      default: false
+      description: 'Drag-to-zoom on the plot; slices the data client-side, so it needs
+        live: true.'
+    slots:
+    - name: reference_lines
+      many: true
+      setter_args:
+        reference_line: 0
+      setter_kwargs:
+        reference_line:
+        - x
+        - "y"
+        - label
+        - stroke_dasharray
+    - name: reference_areas
+      many: true
+      setter_args:
+        reference_area: 0
+      setter_kwargs:
+        reference_area:
+        - x1
+        - x2
+        - y1
+        - y2
+        - label
+        - fill_opacity
+    - name: reference_dots
+      many: true
+      setter_args:
+        reference_dot: 0
+      setter_kwargs:
+        reference_dot:
+        - x
+        - "y"
+        - r
+        - label
+    - name: brush
+      many: false
+      description: 'The brush strip below the x axis - drag its window to slice the
+        visible range; needs live: true.'
+      setter_args:
+        brush: 0
+      setter_kwargs:
+        brush:
+        - height
+    - name: bars
+      many: true
+      description: 'A bar series bound to data_key:. Bars sharing a stack: id pile
+        up; radius: rounds corners; labels:/label_key: stamp values; color_key:/cell_fill:
+        color per cell; active_index: highlights one bar; error_key: adds whiskers.'
+      setter_args:
+        bar: 0
+      setter_kwargs:
+        bar:
+        - data_key
+        - stack
+        - radius
+        - labels
+        - label_key
+        - color_key
+        - cell_fill
+        - active_index
+        - stroke_width
+        - error_key
+        - error_width
+    - name: x_axis
+      many: false
+      setter_args:
+        x_axis: 0
+      setter_kwargs:
+        x_axis:
+        - data_key
+        - tick_formatter
+        - tick_margin
+    - name: y_axis
+      many: false
+      description: 'The y axis: data_key: makes it the category axis (horizontal orientation);
+        tick_count:/tick_formatter:/tick_margin: as on the x axis.'
+      setter_args:
+        y_axis: 0
+      setter_kwargs:
+        y_axis:
+        - data_key
+        - tick_count
+        - tick_formatter
+        - tick_margin
+    - name: grid
+      many: false
+      setter_args:
+        grid: 0
+      setter_kwargs:
+        grid:
+        - vertical
+        - horizontal
+    - name: legend
+      many: false
+      setter_args:
+        legend: 0
+    - name: tooltip
+      many: false
+      setter_args:
+        tooltip: 0
+    description: A bar chart for comparing values across categories.
+    elements:
+    - frame
+    - svg
+    - grid_line
+    - tick
+    - cursor_line
+    - cursor_band
+    - reference_line
+    - reference_area
+    - reference_dot
+    - error_bar
+    - brush_track
+    - brush_window
+    - brush_handle
+    - label
+    capsule: b8433411927b
+    controllers:
+    - identifier: poetry--charts--live
+      targets:
+      - payload
+      values: []
+      actions:
+      - receive
+      - setWindow
+      - toggleSeries
+      - update
+      events:
+      - poetry--charts--live:settled
+      - poetry--charts--live:updated
+    - identifier: poetry--charts--motion
+      targets: []
+      values: []
+      actions: []
+      events:
+      - poetry--charts--motion:settled
+    - identifier: poetry--charts--tooltip
+      targets:
+      - data
+      - svg
+      - tooltip
+      values:
+      - sync
+      actions:
+      - blur
+      - count
+      - enter
+      - focus
+      - keydown
+      - leave
+      - move
+      - refresh
+      - show
+      events:
+      - poetry--charts--tooltip:hide
+      - poetry--charts--tooltip:show
+    - identifier: poetry--charts--window
+      targets: []
+      values:
+      - brush
+      - plot
+      - zoom
+      actions:
+      - reset
+      - startBrush
+      - startZoom
+      events: []
+    agent_rules:
+    - 'Compose from slots: with_grid / with_x_axis(data_key:) / with_bar(data_key:)
+      / with_legend.'
+    - 'radius: 8 rounds all corners; stacked bars use arrays - [0,0,4,4] bottom bar,
+      [4,4,0,0] top bar.'
+    - 'Stack bars with the same stack: id; negatives automatically drop below the
+      zero line.'
+    - 'cell_fill: ->(row, value) { ... } colors bars per datum (validated CSS-safe);
+      color_key: reads a row key.'
+    - 'active_index: highlights one bar (fill-opacity 0.8 + dashed stroke - the active
+      block look).'
+    - 'Entrance animation is on by default (source parity); animate: false for a static
+      chart. Reduced-motion users always get the finished chart.'
+    parts:
+    - name: chart-brush
+      description: 'The brush strip group (with_brush): track + window + two handles
+        below the x axis'
+    - name: chart-brush-track
+      description: The full-width brush rail
+    - name: chart-brush-window
+      description: The selected-range rect the drag moves
+    - name: chart-brush-handle
+      description: One draggable window edge
+      states:
+      - attr: data-edge
+        condition: always - which edge
+        values:
+        - start
+        - end
+    - name: chart-zoom-selection
+      description: 'The zoom drag-selection overlay (zoom: true), hidden until a drag
+        starts'
+    - name: chart-live-payload
+      description: The embedded {spec, frame} JSON the live renderer recomputes geometry
+        from
+    - name: chart-svg
+      description: The chart canvas (<svg>) - server-computed geometry in a fixed
+        viewBox; role=img, or the focusable role=application accessibilityLayer when
+        the tooltip attaches
+      states:
+      - attr: data-animate
+        condition: present when animate (the default) - the motion stylesheet and
+          controller key the entrance off it
+      - attr: data-motion
+        condition: runtime - the motion rig stamps the animation lifecycle (entrance/morph,
+          then settled)
+        values:
+        - entrance
+        - morph
+        - settled
+      vars:
+      - name: "--poetry-motion-duration"
+        description: the entrance/morph duration (animation_duration, ms)
+      - name: "--poetry-motion-easing"
+        description: the animation easing keyword (animation_easing)
+      - name: "--poetry-motion-delay"
+        description: the pre-animation hold (animation_begin, ms)
+    - name: chart-grid
+      description: The gridline group (with_grid) - horizontal and/or vertical rules
+        across the plot
+    - name: chart-cursor
+      description: The hover cursor, hidden until the tooltip controller positions
+        and reveals it at the active index - a vertical rule or a translucent band
+        rect (bar charts)
+    - name: chart-bars
+      description: The bar-mark group wrapping every series
+    - name: chart-bar-series
+      description: One series' bar group
+      states:
+      - attr: data-key
+        condition: the series key
+    - name: chart-bar
+      description: One bar cell (a per-corner rounded-rect path)
+      states:
+      - attr: data-key
+        condition: the series key
+      - attr: data-index
+        condition: the datum index
+      - attr: data-active
+        condition: the highlighted cell - server-rendered from active_index:, and
+          the tooltip controller marks the hovered index at runtime
+      - attr: data-motion-origin
+        condition: when animate - the zero edge the entrance grows from
+        values:
+        - bottom
+        - top
+        - left
+        - right
+    - name: chart-labels
+      description: 'One series'' value-label group (labels: true)'
+      states:
+      - attr: data-key
+        condition: the series key
+    - name: chart-x-axis
+      description: The x-axis tick-label group (with_x_axis)
+    - name: chart-y-axis
+      description: The y-axis tick-label group (with_y_axis)
+    - name: chart-coordinates
+      description: The embedded per-index geometry payload (<script type=application/json>)
+        the tooltip controller reads - zero chart math in the browser
+    stimulus:
+    - element: frame
+      controllers:
+      - identifier: poetry--charts--tooltip
+        conditional: if tooltip?
+        registers: true
+        values:
+        - name: sync
+          conditional: if
+      - identifier: poetry--charts--motion
+        conditional: if animate?
+        registers: true
+      - identifier: poetry--charts--live
+        conditional: if live?
+        registers: true
+        actions:
+        - method: receive
+          'on': poetry-chart:update
+      - identifier: poetry--charts--tooltip
+        conditional: if
+        actions:
+        - method: refresh
+          'on': poetry--charts--live:updated
+      - identifier: poetry--charts--window
+        conditional: if window_features?
+        registers: true
+        values:
+        - name: zoom
+        - name: plot
+        - name: brush
+          conditional: if
+    - element: svg
+      controllers:
+      - identifier: poetry--charts--tooltip
+        conditional: if tooltip?
+        targets:
+        - name: svg
+        actions:
+        - method: move
+          'on': pointermove
+        - method: leave
+          'on': pointerleave
+        - method: focus
+          'on': focus
+        - method: blur
+          'on': blur
+        - method: keydown
+          'on': keydown
+      - identifier: poetry--charts--window
+        conditional: if zoom?
+        actions:
+        - method: startZoom
+          'on': pointerdown
+        - method: reset
+          'on': dblclick
+    - element: coordinates
+      controllers:
+      - identifier: poetry--charts--tooltip
+        conditional: if tooltip?
+        targets:
+        - name: data
+    - element: tooltip_layer
+      controllers:
+      - identifier: poetry--charts--tooltip
+        conditional: if tooltip?
+        targets:
+        - name: tooltip
+    - element: live_payload
+      controllers:
+      - identifier: poetry--charts--live
+        targets:
+        - name: payload
+    - element: brush
+      controllers:
+      - identifier: poetry--charts--window
+        conditional: if
+        actions:
+        - method: startBrush
+          'on': pointerdown
+  poetry/charts/composed_chart:
+    class_name: Poetry::Charts::ComposedChart::Component
+    identifier: poetry--charts--composed_chart
+    bem_block: poetry-charts-composed_chart
+    styles: []
+    options:
+    - name: animate
+      type: boolean
+      default: true
+      description: Entrance animation switch - reduced-motion users always get the
+        finished chart regardless.
+    - name: animation_begin
+      type: integer
+      default: 0
+      description: Pre-animation hold in milliseconds.
+    - name: animation_duration
+      type: integer
+      default: 1500
+      description: Entrance/morph duration in milliseconds.
+    - name: animation_easing
+      type: symbol
+      default: ease
+      description: Animation easing keyword (see EASINGS).
+    - name: bar_category_gap
+      type: string
+      default: 10%
+      description: 'Band trim on each side: a percent string of the band width, or
+        a bare pixel number.'
+    - name: bar_gap
+      type: integer
+      default: 4
+      description: Pixels between side-by-side bars inside one category band.
+    - name: config
+      type:
+      required: true
+      description: 'The series config - key => { label:, color: } - naming and coloring
+        every series.'
+    - name: data
+      type:
+      required: true
+      description: 'The rows to plot: an array of hashes, one per x category.'
+    - name: height
+      type: integer
+      default: 360
+      description: ViewBox height in pixels.
+    - name: id
+      type: string
+      description: Explicit DOM id token, stable across renders; otherwise the chart
+        gets a unique per-render id.
+    - name: label
+      type: string
+      description: Accessible name for the chart SVG; defaults to one built from the
+        configured series.
+    - name: margin
+      type:
+      description: 'Plot margin overrides ({ top:, right:, bottom:, left: }), merged
+        over the defaults.'
+    - name: sync
+      type: string
+    - name: width
+      type: integer
+      default: 640
+      description: ViewBox width in pixels; the rendered chart scales to its container.
+    slots:
+    - name: reference_lines
+      many: true
+      setter_args:
+        reference_line: 0
+      setter_kwargs:
+        reference_line:
+        - x
+        - "y"
+        - label
+        - stroke_dasharray
+    - name: reference_areas
+      many: true
+      setter_args:
+        reference_area: 0
+      setter_kwargs:
+        reference_area:
+        - x1
+        - x2
+        - y1
+        - y2
+        - label
+        - fill_opacity
+    - name: reference_dots
+      many: true
+      setter_args:
+        reference_dot: 0
+      setter_kwargs:
+        reference_dot:
+        - x
+        - "y"
+        - r
+        - label
+    - name: areas
+      many: true
+      description: 'An area mark bound to data_key:; areas sharing a stack: id pile
+        up (area stacks never join bar stacks).'
+      setter_args:
+        area: 0
+      setter_kwargs:
+        area:
+        - data_key
+        - stack
+        - curve
+        - fill_opacity
+        - gradient
+        - stroke_width
+    - name: bars
+      many: true
+      description: 'A bar mark bound to data_key:; radius: rounds corners; bars sharing
+        a stack: id pile up within the bar marks.'
+      setter_args:
+        bar: 0
+      setter_kwargs:
+        bar:
+        - data_key
+        - stack
+        - radius
+    - name: lines
+      many: true
+      description: 'A line mark bound to data_key:; dots: marks each point.'
+      setter_args:
+        line: 0
+      setter_kwargs:
+        line:
+        - data_key
+        - curve
+        - stroke_width
+        - dots
+        - dot_radius
+    - name: x_axis
+      many: false
+      setter_args:
+        x_axis: 0
+      setter_kwargs:
+        x_axis:
+        - data_key
+        - tick_formatter
+        - tick_margin
+    - name: y_axis
+      many: false
+      description: 'The value axis: tick_count: sets how many ticks show; tick_formatter:
+        reshapes each label; tick_margin: pads it.'
+      setter_args:
+        y_axis: 0
+      setter_kwargs:
+        y_axis:
+        - tick_count
+        - tick_formatter
+        - tick_margin
+    - name: grid
+      many: false
+      setter_args:
+        grid: 0
+      setter_kwargs:
+        grid:
+        - vertical
+        - horizontal
+    - name: legend
+      many: false
+      setter_args:
+        legend: 0
+    - name: tooltip
+      many: false
+      setter_args:
+        tooltip: 0
+    description: A composed chart layering bars, lines, and areas on shared axes.
+    elements:
+    - frame
+    - svg
+    - grid_line
+    - tick
+    - cursor_line
+    - cursor_band
+    - reference_line
+    - reference_area
+    - reference_dot
+    - error_bar
+    capsule: 6947e8a26d43
+    controllers:
+    - identifier: poetry--charts--motion
+      targets: []
+      values: []
+      actions: []
+      events:
+      - poetry--charts--motion:settled
+    - identifier: poetry--charts--tooltip
+      targets:
+      - data
+      - svg
+      - tooltip
+      values:
+      - sync
+      actions:
+      - blur
+      - count
+      - enter
+      - focus
+      - keydown
+      - leave
+      - move
+      - refresh
+      - show
+      events:
+      - poetry--charts--tooltip:hide
+      - poetry--charts--tooltip:show
+    agent_rules:
+    - 'Mix marks freely: with_area / with_bar / with_line - declaration order is paint
+      order.'
+    - All marks share the x band and ONE y domain; lines and areas ride the band centers.
+    - 'stack: ids only combine within the same mark type (a bar stack never joins
+      an area stack).'
+    - Colors come from the config - never set fill/stroke on a mark directly.
+    - Entrance animation is on by default; each mark keeps its own reveal mechanism.
+    parts:
+    - name: chart-svg
+      description: The chart canvas (<svg>) - server-computed geometry in a fixed
+        viewBox; role=img, or the focusable role=application accessibilityLayer when
+        the tooltip attaches
+      states:
+      - attr: data-animate
+        condition: present when animate (the default) - the motion stylesheet and
+          controller key the entrance off it
+      - attr: data-motion
+        condition: runtime - the motion rig stamps the animation lifecycle (entrance/morph,
+          then settled)
+        values:
+        - entrance
+        - morph
+        - settled
+      vars:
+      - name: "--poetry-motion-duration"
+        description: the entrance/morph duration (animation_duration, ms)
+      - name: "--poetry-motion-easing"
+        description: the animation easing keyword (animation_easing)
+      - name: "--poetry-motion-delay"
+        description: the pre-animation hold (animation_begin, ms)
+    - name: chart-motion-reveal
+      description: The entrance clipPath rect (the ported area reveal) - the motion
+        stylesheet scales it 0 -> 1; only when animate
+    - name: chart-grid
+      description: The gridline group (with_grid) - horizontal and/or vertical rules
+        across the plot
+    - name: chart-cursor
+      description: The hover cursor, hidden until the tooltip controller positions
+        and reveals it at the active index - a vertical rule or a translucent band
+        rect (bar charts)
+    - name: chart-areas
+      description: The area-mark group - a fill path plus top-curve stroke per series,
+        clipped by the reveal rect while animating
+    - name: chart-area
+      description: One series' fill path (var(--color-<key>) or its gradient)
+      states:
+      - attr: data-key
+        condition: the series key
+    - name: chart-area-stroke
+      description: One series' top-curve stroke path (the source strokes the curve,
+        never the area outline)
+      states:
+      - attr: data-key
+        condition: the series key
+    - name: chart-bar-series
+      description: One series' bar group
+      states:
+      - attr: data-key
+        condition: the series key
+    - name: chart-bar
+      description: One bar cell (a per-corner rounded-rect path)
+      states:
+      - attr: data-key
+        condition: the series key
+      - attr: data-index
+        condition: the datum index
+      - attr: data-active
+        condition: runtime - the tooltip controller marks the hovered index
+      - attr: data-motion-origin
+        condition: when animate - the zero edge the entrance grows from
+        values:
+        - bottom
+        - top
+    - name: chart-lines
+      description: The line-mark group - each series' curve plus its companion marks
+    - name: chart-line
+      description: One series' stroked curve - pathLength=1 when animating so the
+        dash draw-in needs no measurement
+      states:
+      - attr: data-key
+        condition: the series key
+    - name: chart-dots
+      description: 'One series'' point-dot group (dots: true)'
+      states:
+      - attr: data-key
+        condition: the series key
+    - name: chart-dot
+      description: One point dot (<circle>)
+    - name: chart-active-dots
+      description: The hover-marker group (with_tooltip) - pre-rendered hidden circles
+        for every series x index
+    - name: chart-active-dot
+      description: One hover marker - display=none until the tooltip controller reveals
+        the active index's dot
+      states:
+      - attr: data-key
+        condition: the series key
+      - attr: data-index
+        condition: the datum index
+      - attr: data-active
+        condition: runtime - rides the marker while its index is the active one
+    - name: chart-x-axis
+      description: The x-axis tick-label group (with_x_axis)
+    - name: chart-coordinates
+      description: The embedded per-index geometry payload (<script type=application/json>)
+        the tooltip controller reads - zero chart math in the browser
+    stimulus:
+    - element: frame
+      controllers:
+      - identifier: poetry--charts--tooltip
+        conditional: if tooltip?
+        registers: true
+        values:
+        - name: sync
+          conditional: if
+      - identifier: poetry--charts--motion
+        conditional: if animate?
+        registers: true
+    - element: svg
+      controllers:
+      - identifier: poetry--charts--tooltip
+        conditional: if tooltip?
+        targets:
+        - name: svg
+        actions:
+        - method: move
+          'on': pointermove
+        - method: leave
+          'on': pointerleave
+        - method: focus
+          'on': focus
+        - method: blur
+          'on': blur
+        - method: keydown
+          'on': keydown
+    - element: coordinates
+      controllers:
+      - identifier: poetry--charts--tooltip
+        conditional: if tooltip?
+        targets:
+        - name: data
+    - element: tooltip_layer
+      controllers:
+      - identifier: poetry--charts--tooltip
+        conditional: if tooltip?
+        targets:
+        - name: tooltip
+  poetry/charts/container:
+    class_name: Poetry::Charts::Container::Component
+    identifier: poetry--charts--container
+    bem_block: poetry-charts-container
+    styles: []
+    options:
+    - name: config
+      type:
+      required: true
+      description: 'The series config - key => { label:, color: } - driving the per-series
+        color emission.'
+    - name: id
+      type: string
+      description: Explicit DOM id token, stable across renders; otherwise the frame
+        gets a unique per-render id.
+    slots: []
+    elements: []
+    capsule: 7b90eeaff974
+    agent_rules:
+    - Every chart lives inside poetry_chart_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.'
+    parts:
+    - name: chart
+      description: The chart frame (<div>) - the aspect-video chrome, the tooltip
+        layer's positioning anchor, and the id scope the per-series colors are emitted
+        for
+      states:
+      - attr: data-chart
+        condition: 'always - the chart instance id (explicit id: or unique per render);
+          the scoped color emission keys off it'
+      vars:
+      - name: "--color-*"
+        description: per-series color, one entry per series key - the frame's <style>
+          block emits them for [data-chart=<id>] in both themes
+  poetry/charts/legend_content:
+    class_name: Poetry::Charts::LegendContent::Component
+    identifier: poetry--charts--legend_content
+    bem_block: poetry-charts-legend_content
+    styles:
+    - name: align
+      type: symbol
+      variants:
+      - top
+      - bottom
+      default: bottom
+      required: true
+      description: 'Which chart edge the legend sits on: :top pads below it, :bottom
+        (the default) pads above. A style axis, not an option - options silently drop
+        the dictionary''s variant classes.'
+    options:
+    - name: config
+      type:
+      required: true
+      description: 'The series config - key => { label:, color: } - the default item
+        source.'
+    - name: hide_icon
+      type: boolean
+      default: false
+      description: Hides the color swatches, leaving labels only.
+    - name: items
+      type:
+      description: 'Explicit entries ([{ key:, name:, color: }]) overriding the config-derived
+        list.'
+    - name: toggle
+      type: boolean
+      default: false
+      description: 'Interactive legend: items render as buttons that toggle their
+        series through the live controller (the host chart guards that live: is on).'
+    slots: []
+    elements:
+    - item
+    - swatch
+    - toggle
+    capsule: e0df3abb928a
+    agent_rules:
+    - 'The legend derives from the chart config by default - omit items: unless slices
+      differ from series.'
+    - 'align: :top pads below (pb-3), :bottom (default) pads above (pt-3) - matching
+      the chart edge it sits on.'
+    identity: false
+    parts:
+    - name: chart-legend-content
+      description: The legend row (<div>) - centered swatch + label pairs
+    - name: chart-legend-item
+      description: One legend entry (<div>; a <button> in toggle mode)
+      states:
+      - attr: data-key
+        condition: in toggle mode - the series key the button toggles
+      - attr: data-hidden
+        condition: in toggle mode - the item's series is toggled off (the live controller
+          stamps it at runtime; the item dims)
+    - name: chart-legend-swatch
+      description: The color swatch (<div>) - inline background-color carries the
+        entry's color; omitted with hide_icon or colorless entries
+  poetry/charts/line_chart:
+    class_name: Poetry::Charts::LineChart::Component
+    identifier: poetry--charts--line_chart
+    bem_block: poetry-charts-line_chart
+    styles: []
+    options:
+    - name: animate
+      type: boolean
+      default: true
+      description: Entrance animation switch - reduced-motion users always get the
+        finished chart regardless.
+    - name: animation_begin
+      type: integer
+      default: 0
+      description: Pre-animation hold in milliseconds.
+    - name: animation_duration
+      type: integer
+      default: 1500
+      description: Entrance/morph duration in milliseconds.
+    - name: animation_easing
+      type: symbol
+      default: ease
+      description: Animation easing keyword (see EASINGS).
+    - name: config
+      type:
+      required: true
+      description: 'The series config - key => { label:, color: } - naming and coloring
+        every series.'
+    - name: data
+      type:
+      required: true
+      description: 'The rows to plot: an array of hashes, one per x category.'
+    - name: height
+      type: integer
+      default: 360
+      description: ViewBox height in pixels.
+    - name: id
+      type: string
+      description: Explicit DOM id token, stable across renders; otherwise the chart
+        gets a unique per-render id.
+    - name: label
+      type: string
+      description: Accessible name for the chart SVG; defaults to one built from the
+        configured series.
+    - name: live
+      type: boolean
+      default: false
+      description: Embeds the {spec, frame} payload so the client renderer can recompute
+        geometry when data changes without a server round-trip.
+    - name: margin
+      type:
+      description: 'Plot margin overrides ({ top:, right:, bottom:, left: }), merged
+        over the defaults.'
+    - name: sync
+      type: string
+    - name: width
+      type: integer
+      default: 640
+      description: ViewBox width in pixels; the rendered chart scales to its container.
+    - name: zoom
+      type: boolean
+      default: false
+      description: 'Drag-to-zoom on the plot; slices the data client-side, so it needs
+        live: true.'
+    slots:
+    - name: reference_lines
+      many: true
+      setter_args:
+        reference_line: 0
+      setter_kwargs:
+        reference_line:
+        - x
+        - "y"
+        - label
+        - stroke_dasharray
+    - name: reference_areas
+      many: true
+      setter_args:
+        reference_area: 0
+      setter_kwargs:
+        reference_area:
+        - x1
+        - x2
+        - y1
+        - y2
+        - label
+        - fill_opacity
+    - name: reference_dots
+      many: true
+      setter_args:
+        reference_dot: 0
+      setter_kwargs:
+        reference_dot:
+        - x
+        - "y"
+        - r
+        - label
+    - name: brush
+      many: false
+      description: 'The brush strip below the x axis - drag its window to slice the
+        visible range; needs live: true.'
+      setter_args:
+        brush: 0
+      setter_kwargs:
+        brush:
+        - height
+    - name: lines
+      many: true
+      description: 'A line series bound to data_key:. dots: marks each point; dot_color_key:
+        reads per-point dot colors from the row; labels: stamps each value above its
+        point; error_key: adds error whiskers.'
+      setter_args:
+        line: 0
+      setter_kwargs:
+        line:
+        - data_key
+        - curve
+        - stroke_width
+        - dots
+        - dot_radius
+        - dot_color_key
+        - labels
+        - error_key
+        - error_width
+    - name: x_axis
+      many: false
+      setter_args:
+        x_axis: 0
+      setter_kwargs:
+        x_axis:
+        - data_key
+        - tick_formatter
+        - tick_margin
+    - name: y_axis
+      many: false
+      description: 'The value axis: tick_count: sets how many ticks show; tick_formatter:
+        reshapes each label; tick_margin: pads it.'
+      setter_args:
+        y_axis: 0
+      setter_kwargs:
+        y_axis:
+        - tick_count
+        - tick_formatter
+        - tick_margin
+    - name: grid
+      many: false
+      setter_args:
+        grid: 0
+      setter_kwargs:
+        grid:
+        - vertical
+        - horizontal
+    - name: legend
+      many: false
+      setter_args:
+        legend: 0
+    - name: tooltip
+      many: false
+      setter_args:
+        tooltip: 0
+    description: A line chart for trends over a continuous axis.
+    elements:
+    - frame
+    - svg
+    - grid_line
+    - tick
+    - cursor_line
+    - cursor_band
+    - reference_line
+    - reference_area
+    - reference_dot
+    - error_bar
+    - brush_track
+    - brush_window
+    - brush_handle
+    - label
+    capsule: b8433411927b
+    controllers:
+    - identifier: poetry--charts--live
+      targets:
+      - payload
+      values: []
+      actions:
+      - receive
+      - setWindow
+      - toggleSeries
+      - update
+      events:
+      - poetry--charts--live:settled
+      - poetry--charts--live:updated
+    - identifier: poetry--charts--motion
+      targets: []
+      values: []
+      actions: []
+      events:
+      - poetry--charts--motion:settled
+    - identifier: poetry--charts--tooltip
+      targets:
+      - data
+      - svg
+      - tooltip
+      values:
+      - sync
+      actions:
+      - blur
+      - count
+      - enter
+      - focus
+      - keydown
+      - leave
+      - move
+      - refresh
+      - show
+      events:
+      - poetry--charts--tooltip:hide
+      - poetry--charts--tooltip:show
+    - identifier: poetry--charts--window
+      targets: []
+      values:
+      - brush
+      - plot
+      - zoom
+      actions:
+      - reset
+      - startBrush
+      - startZoom
+      events: []
+    agent_rules:
+    - 'Compose from slots: with_grid / with_x_axis(data_key:) / with_line(data_key:)
+      / with_legend.'
+    - 'Lines default to stroke-width 2 and NO dots (the ported block look); dots:
+      true adds them.'
+    - 'dot_color_key: reads a per-row data key for per-point dot colors (the dots-colors
+      block).'
+    - 'labels: true stamps each value above its point; give the chart margin top when
+      using it.'
+    - Colors come from the config - never set stroke on a line directly.
+    - 'Entrance animation is on by default (source parity); animate: false for a static
+      chart. Reduced-motion users always get the finished chart.'
+    parts:
+    - name: chart-brush
+      description: 'The brush strip group (with_brush): track + window + two handles
+        below the x axis'
+    - name: chart-brush-track
+      description: The full-width brush rail
+    - name: chart-brush-window
+      description: The selected-range rect the drag moves
+    - name: chart-brush-handle
+      description: One draggable window edge
+      states:
+      - attr: data-edge
+        condition: always - which edge
+        values:
+        - start
+        - end
+    - name: chart-zoom-selection
+      description: 'The zoom drag-selection overlay (zoom: true), hidden until a drag
+        starts'
+    - name: chart-live-payload
+      description: The embedded {spec, frame} JSON the live renderer recomputes geometry
+        from
+    - name: chart-svg
+      description: The chart canvas (<svg>) - server-computed geometry in a fixed
+        viewBox; role=img, or the focusable role=application accessibilityLayer when
+        the tooltip attaches
+      states:
+      - attr: data-animate
+        condition: present when animate (the default) - the motion stylesheet and
+          controller key the entrance off it
+      - attr: data-motion
+        condition: runtime - the motion rig stamps the animation lifecycle (entrance/morph,
+          then settled)
+        values:
+        - entrance
+        - morph
+        - settled
+      vars:
+      - name: "--poetry-motion-duration"
+        description: the entrance/morph duration (animation_duration, ms)
+      - name: "--poetry-motion-easing"
+        description: the animation easing keyword (animation_easing)
+      - name: "--poetry-motion-delay"
+        description: the pre-animation hold (animation_begin, ms)
+    - name: chart-grid
+      description: The gridline group (with_grid) - horizontal and/or vertical rules
+        across the plot
+    - name: chart-cursor
+      description: The hover cursor, hidden until the tooltip controller positions
+        and reveals it at the active index - a vertical rule or a translucent band
+        rect (bar charts)
+    - name: chart-lines
+      description: The line-mark group - each series' curve plus its companion marks
+    - name: chart-line
+      description: One series' stroked curve - pathLength=1 when animating so the
+        dash draw-in needs no measurement
+      states:
+      - attr: data-key
+        condition: the series key
+    - name: chart-dots
+      description: 'One series'' point-dot group (dots: true)'
+      states:
+      - attr: data-key
+        condition: the series key
+    - name: chart-dot
+      description: One point dot (<circle>)
+    - name: chart-error-bars
+      description: One series' error-whisker group (error_key:) - cap-stem-cap paths
+        in the foreground color
+      states:
+      - attr: data-key
+        condition: the series key
+    - name: chart-labels
+      description: 'One series'' value-label group (labels: true)'
+      states:
+      - attr: data-key
+        condition: the series key
+    - name: chart-reference
+      description: The reference-mark group (with_reference_line/_area/_dot), painted
+        above the series
+    - name: chart-active-dots
+      description: The hover-marker group (with_tooltip) - pre-rendered hidden circles
+        for every series x index
+    - name: chart-active-dot
+      description: One hover marker - display=none until the tooltip controller reveals
+        the active index's dot
+      states:
+      - attr: data-key
+        condition: the series key
+      - attr: data-index
+        condition: the datum index
+      - attr: data-active
+        condition: runtime - rides the marker while its index is the active one
+    - name: chart-x-axis
+      description: The x-axis tick-label group (with_x_axis)
+    - name: chart-coordinates
+      description: The embedded per-index geometry payload (<script type=application/json>)
+        the tooltip controller reads - zero chart math in the browser
+    stimulus:
+    - element: frame
+      controllers:
+      - identifier: poetry--charts--tooltip
+        conditional: if tooltip?
+        registers: true
+        values:
+        - name: sync
+          conditional: if
+      - identifier: poetry--charts--motion
+        conditional: if animate?
+        registers: true
+      - identifier: poetry--charts--live
+        conditional: if live?
+        registers: true
+        actions:
+        - method: receive
+          'on': poetry-chart:update
+      - identifier: poetry--charts--tooltip
+        conditional: if
+        actions:
+        - method: refresh
+          'on': poetry--charts--live:updated
+      - identifier: poetry--charts--window
+        conditional: if window_features?
+        registers: true
+        values:
+        - name: zoom
+        - name: plot
+        - name: brush
+          conditional: if
+    - element: svg
+      controllers:
+      - identifier: poetry--charts--tooltip
+        conditional: if tooltip?
+        targets:
+        - name: svg
+        actions:
+        - method: move
+          'on': pointermove
+        - method: leave
+          'on': pointerleave
+        - method: focus
+          'on': focus
+        - method: blur
+          'on': blur
+        - method: keydown
+          'on': keydown
+      - identifier: poetry--charts--window
+        conditional: if zoom?
+        actions:
+        - method: startZoom
+          'on': pointerdown
+        - method: reset
+          'on': dblclick
+    - element: coordinates
+      controllers:
+      - identifier: poetry--charts--tooltip
+        conditional: if tooltip?
+        targets:
+        - name: data
+    - element: tooltip_layer
+      controllers:
+      - identifier: poetry--charts--tooltip
+        conditional: if tooltip?
+        targets:
+        - name: tooltip
+    - element: live_payload
+      controllers:
+      - identifier: poetry--charts--live
+        targets:
+        - name: payload
+    - element: brush
+      controllers:
+      - identifier: poetry--charts--window
+        conditional: if
+        actions:
+        - method: startBrush
+          'on': pointerdown
+  poetry/charts/pie_chart:
+    class_name: Poetry::Charts::PieChart::Component
+    identifier: poetry--charts--pie_chart
+    bem_block: poetry-charts-pie_chart
+    styles: []
+    options:
+    - name: animate
+      type: boolean
+      default: true
+      description: Entrance animation switch - reduced-motion users always get the
+        finished chart regardless.
+    - name: animation_begin
+      type: integer
+      default: 400
+      description: Pre-animation hold in milliseconds.
+    - name: animation_duration
+      type: integer
+      default: 1500
+      description: Entrance/morph duration in milliseconds.
+    - name: animation_easing
+      type: symbol
+      default: ease
+      description: Animation easing keyword (see EASINGS).
+    - name: config
+      type:
+      required: true
+      description: 'The series config - name => { label:, color: } - naming and coloring
+        the slices.'
+    - name: data
+      type:
+      description: 'Default rows for pies that don''t bring their own data: - one
+        hash per slice.'
+    - name: height
+      type: integer
+      default: 250
+      description: ViewBox height in pixels.
+    - name: id
+      type: string
+      description: Explicit DOM id token, stable across renders; otherwise the chart
+        gets a unique per-render id.
+    - name: label
+      type: string
+      description: Accessible name for the chart SVG; defaults to one built from the
+        configured series.
+    - name: margin
+      type:
+      description: 'Margin overrides ({ top:, right:, bottom:, left: }), merged over
+        the slim polar default.'
+    - name: sync
+      type: string
+    - name: width
+      type: integer
+      default: 250
+      description: ViewBox width in pixels; the rendered chart scales to its container.
+    slots:
+    - name: pies
+      many: true
+      description: 'One ring of slices reading data_key: values and name_key: slice
+        names. inner_radius: makes the donut; padding_angle: spaces the slices; active_index:
+        pops one out by active_grow: pixels.'
+      setter_args:
+        pie: 0
+      setter_kwargs:
+        pie:
+        - data_key
+        - data
+        - name_key
+        - inner_radius
+        - outer_radius
+        - padding_angle
+        - stroke_width
+        - color_key
+        - labels
+        - label_key
+        - active_index
+        - active_grow
+    - name: center_label
+      many: false
+      description: 'The donut-hole text: a title line plus an optional subtitle.'
+      setter_args:
+        center_label: 0
+      setter_kwargs:
+        center_label:
+        - title
+        - subtitle
+    - name: legend
+      many: false
+      description: 'The legend row: align:, items:, and hide_icon:.'
+      setter_args:
+        legend: 0
+    - name: tooltip
+      many: false
+      description: The hover tooltip; the slice name carries the label, so hide_label
+        defaults on.
+      setter_args:
+        tooltip: 0
+    description: A pie chart for showing parts of a whole.
+    slot_extras:
+    - py
+    elements:
+    - frame
+    - svg
+    - inside_label
+    - center_title
+    - center_subtitle
+    capsule: 0e163387c077
+    controllers:
+    - identifier: poetry--charts--motion
+      targets: []
+      values: []
+      actions: []
+      events:
+      - poetry--charts--motion:settled
+    - identifier: poetry--charts--tooltip
+      targets:
+      - data
+      - svg
+      - tooltip
+      values:
+      - sync
+      actions:
+      - blur
+      - count
+      - enter
+      - focus
+      - keydown
+      - leave
+      - move
+      - refresh
+      - show
+      events:
+      - poetry--charts--tooltip:hide
+      - poetry--charts--tooltip:show
+    agent_rules:
+    - Rows carry their slice color in a fill key (var(--color-<name>)); the config
+      maps names to labels.
+    - 'inner_radius: 60 makes the donut; with_center_label(title:, subtitle:) fills
+      the hole.'
+    - 'Stacked pies: two with_pie slots with their own data: and non-overlapping radii.'
+    - 'active_index: pops one slice out by 10px (the donut-active look).'
+    - The tooltip walks slices by hover AND arrow keys (role=application when attached).
+    - 'Entrance animation is on by default (source parity); animate: false for a static
+      chart. Reduced-motion users always get the finished chart.'
+    parts:
+    - name: chart-svg
+      description: The chart canvas (<svg>) - the aria-label surface, the tooltip's
+        focus/keyboard surface (role=application when it attaches), and the motion
+        rig's mount
+      states:
+      - attr: data-animate
+        condition: when animate (the default) - the entrance tier's flag the motion
+          stylesheet and controller key off
+      - attr: data-motion
+        condition: runtime, when animate - the motion engine's lifecycle stamp
+        values:
+        - entrance
+        - morph
+        - settled
+      vars:
+      - name: "--poetry-motion-delay"
+        description: the motion rig's entrance delay (animation_begin)
+      - name: "--poetry-motion-duration"
+        description: the motion rig's entrance duration (animation_duration)
+      - name: "--poetry-motion-easing"
+        description: the motion rig's easing keyword (animation_easing)
+    - name: chart-pie
+      description: One pie's slice group (<g>) - a ring per with_pie slot
+      states:
+      - attr: data-key
+        condition: always - the series key
+    - name: chart-pie-sector
+      description: One slice (<path>) - fill from its row's color, popped out when
+        active
+      states:
+      - attr: data-key
+        condition: always - the series key
+      - attr: data-index
+        condition: on the first pie's slices - the datum index the tooltip walks
+      - attr: data-active
+        condition: the active slice - server-rendered via active_index:, and reflected
+          onto the hovered/arrow-keyed index by the tooltip controller at runtime
+      - attr: data-motion-group
+        condition: when animate - the motion rig's sweep group (one per ring)
+      - attr: data-motion-sector
+        condition: when animate - the motion rig's server-computed sector params for
+          the fan-out sweep
+    - name: chart-labels
+      description: A series' value labels (<g> of <text>, aria-hidden), rendered when
+        the series opts into labels
+      states:
+      - attr: data-key
+        condition: always - the series key
+    - name: chart-center-label
+      description: The center text (<text>) - title tspan plus optional subtitle filling
+        the chart's middle
+    - name: chart-coordinates
+      description: The embedded JSON payload (<script>) the tooltip controller reads
+        - per-category anchors and pre-formatted values, zero chart math in the browser
+    stimulus:
+    - element: frame
+      controllers:
+      - identifier: poetry--charts--tooltip
+        conditional: if tooltip?
+        registers: true
+        values:
+        - name: sync
+          conditional: if
+      - identifier: poetry--charts--motion
+        conditional: if animate?
+        registers: true
+    - element: svg
+      controllers:
+      - identifier: poetry--charts--tooltip
+        conditional: if tooltip?
+        targets:
+        - name: svg
+        actions:
+        - method: move
+          'on': pointermove
+        - method: leave
+          'on': pointerleave
+        - method: focus
+          'on': focus
+        - method: blur
+          'on': blur
+        - method: keydown
+          'on': keydown
+      - identifier: poetry--charts--tooltip
+        conditional: if tooltip?
+        actions:
+        - method: enter
+          'on': pointerover
+    - element: coordinates
+      controllers:
+      - identifier: poetry--charts--tooltip
+        conditional: if tooltip?
+        targets:
+        - name: data
+    - element: tooltip_layer
+      controllers:
+      - identifier: poetry--charts--tooltip
+        conditional: if tooltip?
+        targets:
+        - name: tooltip
+  poetry/charts/radar_chart:
+    class_name: Poetry::Charts::RadarChart::Component
+    identifier: poetry--charts--radar_chart
+    bem_block: poetry-charts-radar_chart
+    styles: []
+    options:
+    - name: animate
+      type: boolean
+      default: true
+      description: Entrance animation switch - reduced-motion users always get the
+        finished chart regardless.
+    - name: animation_begin
+      type: integer
+      default: 0
+      description: Pre-animation hold in milliseconds.
+    - name: animation_duration
+      type: integer
+      default: 1500
+      description: Entrance/morph duration in milliseconds.
+    - name: animation_easing
+      type: symbol
+      default: ease
+      description: Animation easing keyword (see EASINGS).
+    - name: config
+      type:
+      required: true
+      description: 'The series config - key => { label:, color: } - naming and coloring
+        every series.'
+    - name: data
+      type:
+      required: true
+      description: 'The rows to plot: an array of hashes, one per category.'
+    - name: height
+      type: integer
+      default: 250
+      description: ViewBox height in pixels.
+    - name: id
+      type: string
+      description: Explicit DOM id token, stable across renders; otherwise the chart
+        gets a unique per-render id.
+    - name: label
+      type: string
+      description: Accessible name for the chart SVG; defaults to one built from the
+        configured series.
+    - name: margin
+      type:
+      description: 'Margin overrides ({ top:, right:, bottom:, left: }), merged over
+        the slim polar default.'
+    - name: outer_radius
+      type:
+      default: 80%
+      description: 'The rim radius: a percent string of the max radius, or pixels.'
+    - name: sync
+      type: string
+    - name: width
+      type: integer
+      default: 250
+      description: ViewBox width in pixels; the rendered chart scales to its container.
+    slots:
+    - name: radars
+      many: true
+      description: 'A radar series bound to data_key:. fill_opacity: 0 with stroke_width:
+        2 draws lines only; dots: marks every vertex.'
+      setter_args:
+        radar: 0
+      setter_kwargs:
+        radar:
+        - data_key
+        - fill_opacity
+        - stroke_width
+        - dots
+        - dot_radius
+    - name: angle_axis
+      many: false
+      description: 'The category labels around the rim: data_key: names the field;
+        tick_formatter: reshapes each label.'
+      setter_args:
+        angle_axis: 0
+      setter_kwargs:
+        angle_axis:
+        - data_key
+        - tick_formatter
+    - name: grid
+      many: false
+      description: 'The polar grid: type: :circle swaps polygons for circles; radial_lines:
+        false drops the spokes; fill: tints every ring with a series color at opacity:.'
+      setter_args:
+        grid: 0
+      setter_kwargs:
+        grid:
+        - type
+        - radial_lines
+        - fill
+        - opacity
+    - name: legend
+      many: false
+      description: 'The legend row: align:, items:, and hide_icon:.'
+      setter_args:
+        legend: 0
+    - name: tooltip
+      many: false
+      description: The hover tooltip - multi-series rows under the category label.
+      setter_args:
+        tooltip: 0
+    description: A radar chart for comparing several variables on radial axes.
+    elements:
+    - frame
+    - svg
+    - grid_line
+    - grid_fill
+    - tick
+    capsule: e07db6d1050e
+    controllers:
+    - identifier: poetry--charts--motion
+      targets: []
+      values: []
+      actions: []
+      events:
+      - poetry--charts--motion:settled
+    - identifier: poetry--charts--tooltip
+      targets:
+      - data
+      - svg
+      - tooltip
+      values:
+      - sync
+      actions:
+      - blur
+      - count
+      - enter
+      - focus
+      - keydown
+      - leave
+      - move
+      - refresh
+      - show
+      events:
+      - poetry--charts--tooltip:hide
+      - poetry--charts--tooltip:show
+    agent_rules:
+    - 'Compose from slots: with_angle_axis(data_key:) / with_grid / with_radar(data_key:)
+      / with_legend.'
+    - 'Radars fill at 0.6 opacity by default; lines-only = fill_opacity: 0, stroke_width:
+      2.'
+    - 'with_grid type: :circle swaps polygons for circles; fill: :desktop tints every
+      grid ring (opacity 0.2, compounding toward the center - the grid-fill look).'
+    - 'dots: true marks every vertex (r 4, solid).'
+    - Colors come from the config - never set fill/stroke on a radar directly.
+    - 'Entrance animation is on by default (source parity); animate: false for a static
+      chart. Reduced-motion users always get the finished chart.'
+    parts:
+    - name: chart-svg
+      description: The chart canvas (<svg>) - the aria-label surface, the tooltip's
+        focus/keyboard surface (role=application when it attaches), and the motion
+        rig's mount
+      states:
+      - attr: data-animate
+        condition: when animate (the default) - the entrance tier's flag the motion
+          stylesheet and controller key off
+      - attr: data-motion
+        condition: runtime, when animate - the motion engine's lifecycle stamp
+        values:
+        - entrance
+        - morph
+        - settled
+      vars:
+      - name: "--poetry-motion-delay"
+        description: the motion rig's entrance delay (animation_begin)
+      - name: "--poetry-motion-duration"
+        description: the motion rig's entrance duration (animation_duration)
+      - name: "--poetry-motion-easing"
+        description: the motion rig's easing keyword (animation_easing)
+      - name: "--poetry-motion-center"
+        description: the polar center the CSS entrance scales the series from
+    - name: chart-polar-grid
+      description: The polar grid (<g>, aria-hidden) - ring and spoke linework behind
+        the series
+    - name: chart-radars
+      description: The series layer (<g>) - every radar polygon renders here; the
+        CSS entrance scales this group from the polar center
+    - name: chart-radar
+      description: One series' closed polygon (<path>) - config color, 0.6 fill by
+        default
+      states:
+      - attr: data-key
+        condition: always - the series key
+    - name: chart-dots
+      description: 'A series'' vertex dots (<g>), rendered when dots: true'
+      states:
+      - attr: data-key
+        condition: always - the series key
+    - name: chart-dot
+      description: One vertex dot (<circle>) - solid, at the series color
+    - name: chart-angle-axis
+      description: The category labels around the rim (<g> of <text>)
+    - name: chart-hit-wedges
+      description: The tooltip's hit layer (<g>), rendered when the tooltip attaches
+    - name: chart-hit-wedge
+      description: One per-category hit wedge (<path>, transparent but painted so
+        it hit-tests) - the tooltip's hover target
+      states:
+      - attr: data-index
+        condition: always - the datum index
+      - attr: data-active
+        condition: the hovered/arrow-keyed category - the tooltip controller reflects
+          the active index here at runtime
+    - name: chart-coordinates
+      description: The embedded JSON payload (<script>) the tooltip controller reads
+        - per-category anchors and pre-formatted values, zero chart math in the browser
+    stimulus:
+    - element: frame
+      controllers:
+      - identifier: poetry--charts--tooltip
+        conditional: if tooltip?
+        registers: true
+        values:
+        - name: sync
+          conditional: if
+      - identifier: poetry--charts--motion
+        conditional: if animate?
+        registers: true
+    - element: svg
+      controllers:
+      - identifier: poetry--charts--tooltip
+        conditional: if tooltip?
+        targets:
+        - name: svg
+        actions:
+        - method: move
+          'on': pointermove
+        - method: leave
+          'on': pointerleave
+        - method: focus
+          'on': focus
+        - method: blur
+          'on': blur
+        - method: keydown
+          'on': keydown
+      - identifier: poetry--charts--tooltip
+        conditional: if tooltip?
+        actions:
+        - method: enter
+          'on': pointerover
+    - element: coordinates
+      controllers:
+      - identifier: poetry--charts--tooltip
+        conditional: if tooltip?
+        targets:
+        - name: data
+    - element: tooltip_layer
+      controllers:
+      - identifier: poetry--charts--tooltip
+        conditional: if tooltip?
+        targets:
+        - name: tooltip
+  poetry/charts/radial_bar_chart:
+    class_name: Poetry::Charts::RadialBarChart::Component
+    identifier: poetry--charts--radial_bar_chart
+    bem_block: poetry-charts-radial_bar_chart
+    styles: []
+    options:
+    - name: animate
+      type: boolean
+      default: true
+      description: Entrance animation switch - reduced-motion users always get the
+        finished chart regardless.
+    - name: animation_begin
+      type: integer
+      default: 0
+      description: Pre-animation hold in milliseconds.
+    - name: animation_duration
+      type: integer
+      default: 1500
+      description: Entrance/morph duration in milliseconds.
+    - name: animation_easing
+      type: symbol
+      default: ease
+      description: Animation easing keyword (see EASINGS).
+    - name: config
+      type:
+      required: true
+      description: 'The series config - name => { label:, color: } - naming and coloring
+        the rings.'
+    - name: data
+      type:
+      required: true
+      description: 'The rows to plot: an array of hashes, one ring per row.'
+    - name: end_angle
+      type: integer
+      default: 360
+      description: Where the sweep ends - 180 makes a half gauge.
+    - name: height
+      type: integer
+      default: 250
+      description: ViewBox height in pixels.
+    - name: id
+      type: string
+      description: Explicit DOM id token, stable across renders; otherwise the chart
+        gets a unique per-render id.
+    - name: inner_radius
+      type:
+      default: 20%
+      description: 'The innermost ring edge: a percent string of the max radius, or
+        pixels.'
+    - name: label
+      type: string
+      description: Accessible name for the chart SVG; defaults to one built from the
+        configured series.
+    - name: margin
+      type:
+      description: 'Margin overrides ({ top:, right:, bottom:, left: }), merged over
+        the slim polar default.'
+    - name: max_value
+      type:
+      description: 'The angle-axis maximum: nil = the largest single value, so the
+        largest ring closes the full sweep EXACTLY (nicing it would leave a notch);
+        stacked gauges pass the stack total when the segments should fill the span.'
+    - name: name_key
+      type: string
+      default: name
+      description: The row key naming each ring.
+    - name: outer_radius
+      type:
+      default: 80%
+      description: 'The outermost ring edge: a percent string of the max radius, or
+        pixels.'
+    - name: start_angle
+      type: integer
+      default: 0
+      description: Where the sweep starts, in degrees.
+    - name: sync
+      type: string
+    - name: width
+      type: integer
+      default: 250
+      description: ViewBox width in pixels; the rendered chart scales to its container.
+    slots:
+    - name: radial_bars
+      many: true
+      description: 'A radial series reading data_key: values. background: draws the
+        muted track ring; bars sharing a stack: id share the ring and stack by angle;
+        corner_radius: rounds the arc ends.'
+      setter_args:
+        radial_bar: 0
+      setter_kwargs:
+        radial_bar:
+        - data_key
+        - stack
+        - background
+        - corner_radius
+        - color_key
+        - labels
+        - label_key
+    - name: polar_grid
+      many: false
+      description: 'The disc track behind the rings: radii: places the circles (default:
+        each ring''s centerline), fills: tints them, and radial_lines: draws the faint
+        value spokes that show through ring gaps and the open wedge (on by default;
+        gauges turn them off).'
+      setter_args:
+        polar_grid: 0
+      setter_kwargs:
+        polar_grid:
+        - radii
+        - fills
+        - radial_lines
+    - name: center_label
+      many: false
+      description: 'The center text: a title line plus an optional subtitle. The default
+        is the full gauge''s big centered number; compact: shrinks it and sits it
+        just above a half gauge''s flat baseline.'
+      setter_args:
+        center_label: 0
+      setter_kwargs:
+        center_label:
+        - title
+        - subtitle
+        - compact
+    - name: legend
+      many: false
+      description: 'The legend row: align:, items:, and hide_icon:.'
+      setter_args:
+        legend: 0
+    - name: tooltip
+      many: false
+      description: The hover tooltip; the ring name carries the label, so hide_label
+        defaults on.
+      setter_args:
+        tooltip: 0
+    description: A radial bar chart with bars wrapped around a circular axis.
+    elements:
+    - frame
+    - svg
+    - background_ring
+    - grid_circle
+    - grid_fill_muted
+    - grid_fill_background
+    - inside_label
+    - center_title
+    - center_title_compact
+    - center_subtitle
+    capsule: 753933f16121
+    controllers:
+    - identifier: poetry--charts--motion
+      targets: []
+      values: []
+      actions: []
+      events:
+      - poetry--charts--motion:settled
+    - identifier: poetry--charts--tooltip
+      targets:
+      - data
+      - svg
+      - tooltip
+      values:
+      - sync
+      actions:
+      - blur
+      - count
+      - enter
+      - focus
+      - keydown
+      - leave
+      - move
+      - refresh
+      - show
+      events:
+      - poetry--charts--tooltip:hide
+      - poetry--charts--tooltip:show
+    agent_rules:
+    - One ring per data row; rows carry their color in a fill key (var(--color-<name>)).
+    - 'background: true draws the muted track ring behind each bar (the gauge look).'
+    - 'Stack two radial bars with the same stack: id - they share the ring and stack
+      by ANGLE.'
+    - corner_radius rounds the arc ends (10 on a 10px ring = full pill caps).
+    - with_polar_grid(radii:, fills:) draws the shape/text blocks' disc track; with_center_label
+      fills the middle.
+    - 'Entrance animation is on by default (source parity); animate: false for a static
+      chart. Reduced-motion users always get the finished chart.'
+    parts:
+    - name: chart-svg
+      description: The chart canvas (<svg>) - the aria-label surface, the tooltip's
+        focus/keyboard surface (role=application when it attaches), and the motion
+        rig's mount
+      states:
+      - attr: data-animate
+        condition: when animate (the default) - the entrance tier's flag the motion
+          stylesheet and controller key off
+      - attr: data-motion
+        condition: runtime, when animate - the motion engine's lifecycle stamp
+        values:
+        - entrance
+        - morph
+        - settled
+      vars:
+      - name: "--poetry-motion-delay"
+        description: the motion rig's entrance delay (animation_begin)
+      - name: "--poetry-motion-duration"
+        description: the motion rig's entrance duration (animation_duration)
+      - name: "--poetry-motion-easing"
+        description: the motion rig's easing keyword (animation_easing)
+    - name: chart-polar-grid
+      description: The polar grid (<g>, aria-hidden) - ring and spoke linework behind
+        the series
+    - name: chart-radial-series
+      description: One series' ring group (<g>)
+      states:
+      - attr: data-key
+        condition: always - the series key
+    - name: chart-radial-background
+      description: 'The muted track ring (<path>) behind a bar, rendered when background:
+        true'
+    - name: chart-radial-bar
+      description: One angular bar (<path>) - a ring per data row, sweep proportional
+        to value
+      states:
+      - attr: data-key
+        condition: always - the series key
+      - attr: data-index
+        condition: on the first series' bars - the datum index the tooltip walks
+      - attr: data-active
+        condition: the hovered/arrow-keyed bar - the tooltip controller reflects the
+          active index here at runtime
+      - attr: data-motion-group
+        condition: when animate - the motion rig's sweep group (one per ring)
+      - attr: data-motion-sector
+        condition: when animate - the motion rig's server-computed sector params for
+          the fan-out sweep
+    - name: chart-labels
+      description: A series' value labels (<g> of <text>, aria-hidden), rendered when
+        the series opts into labels
+      states:
+      - attr: data-key
+        condition: always - the series key
+    - name: chart-center-label
+      description: The center text (<text>) - title tspan plus optional subtitle filling
+        the chart's middle
+    - name: chart-coordinates
+      description: The embedded JSON payload (<script>) the tooltip controller reads
+        - per-category anchors and pre-formatted values, zero chart math in the browser
+    stimulus:
+    - element: frame
+      controllers:
+      - identifier: poetry--charts--tooltip
+        conditional: if tooltip?
+        registers: true
+        values:
+        - name: sync
+          conditional: if
+      - identifier: poetry--charts--motion
+        conditional: if animate?
+        registers: true
+    - element: svg
+      controllers:
+      - identifier: poetry--charts--tooltip
+        conditional: if tooltip?
+        targets:
+        - name: svg
+        actions:
+        - method: move
+          'on': pointermove
+        - method: leave
+          'on': pointerleave
+        - method: focus
+          'on': focus
+        - method: blur
+          'on': blur
+        - method: keydown
+          'on': keydown
+      - identifier: poetry--charts--tooltip
+        conditional: if tooltip?
+        actions:
+        - method: enter
+          'on': pointerover
+    - element: coordinates
+      controllers:
+      - identifier: poetry--charts--tooltip
+        conditional: if tooltip?
+        targets:
+        - name: data
+    - element: tooltip_layer
+      controllers:
+      - identifier: poetry--charts--tooltip
+        conditional: if tooltip?
+        targets:
+        - name: tooltip
+  poetry/charts/scatter_chart:
+    class_name: Poetry::Charts::ScatterChart::Component
+    identifier: poetry--charts--scatter_chart
+    bem_block: poetry-charts-scatter_chart
+    styles: []
+    options:
+    - name: animate
+      type: boolean
+      default: true
+      description: Entrance animation switch - reduced-motion users always get the
+        finished chart regardless.
+    - name: animation_begin
+      type: integer
+      default: 0
+      description: Pre-animation hold in milliseconds.
+    - name: animation_duration
+      type: integer
+      default: 400
+      description: Entrance/morph duration in milliseconds.
+    - name: animation_easing
+      type: symbol
+      default: linear
+      description: Animation easing keyword (see EASINGS).
+    - name: config
+      type:
+      required: true
+      description: 'The series config - key => { label:, color: } - naming and coloring
+        every series.'
+    - name: data
+      type:
+      description: 'Default rows for series that don''t bring their own data: - one
+        hash per point.'
+    - name: height
+      type: integer
+      default: 360
+      description: ViewBox height in pixels.
+    - name: id
+      type: string
+      description: Explicit DOM id token, stable across renders; otherwise the chart
+        gets a unique per-render id.
+    - name: label
+      type: string
+      description: Accessible name for the chart SVG; defaults to one built from the
+        configured series.
+    - name: margin
+      type:
+      description: 'Plot margin overrides ({ top:, right:, bottom:, left: }), merged
+        over the defaults.'
+    - name: sync
+      type: string
+    - name: width
+      type: integer
+      default: 640
+      description: ViewBox width in pixels; the rendered chart scales to its container.
+    slots:
+    - name: reference_lines
+      many: true
+      setter_args:
+        reference_line: 0
+      setter_kwargs:
+        reference_line:
+        - x
+        - "y"
+        - label
+        - stroke_dasharray
+    - name: reference_areas
+      many: true
+      setter_args:
+        reference_area: 0
+      setter_kwargs:
+        reference_area:
+        - x1
+        - x2
+        - y1
+        - y2
+        - label
+        - fill_opacity
+    - name: reference_dots
+      many: true
+      setter_args:
+        reference_dot: 0
+      setter_kwargs:
+        reference_dot:
+        - x
+        - "y"
+        - r
+        - label
+    - name: scatters
+      many: true
+      description: 'A point series colored by key:. data: gives it its own rows; error_key:
+        adds error whiskers.'
+      setter_args:
+        scatter: 0
+      setter_kwargs:
+        scatter:
+        - key
+        - data
+        - error_key
+        - error_width
+    - name: x_axis
+      many: false
+      description: 'The numeric x axis: data_key: names the row key to plot; name:
+        labels its tooltip row.'
+      setter_args:
+        x_axis: 0
+      setter_kwargs:
+        x_axis:
+        - data_key
+        - tick_count
+        - tick_margin
+        - name
+    - name: y_axis
+      many: false
+      description: 'The numeric y axis: data_key: names the row key to plot; name:
+        labels its tooltip row.'
+      setter_args:
+        y_axis: 0
+      setter_kwargs:
+        y_axis:
+        - data_key
+        - tick_count
+        - tick_margin
+        - name
+    - name: z_axis
+      many: false
+      description: 'A third dimension sizing the markers: range: is marker AREA in
+        px2 mapped linearly from the data_key: values.'
+      setter_args:
+        z_axis: 0
+      setter_kwargs:
+        z_axis:
+        - data_key
+        - range
+    - name: grid
+      many: false
+      description: 'The gridlines: both directions by default.'
+      setter_args:
+        grid: 0
+      setter_kwargs:
+        grid:
+        - vertical
+        - horizontal
+    - name: legend
+      many: false
+      description: 'The legend row: align:, items:, and hide_icon:.'
+      setter_args:
+        legend: 0
+    - name: tooltip
+      many: false
+      description: The hover tooltip - per-point x/y(/z) rows under the series name.
+      setter_args:
+        tooltip: 0
+    description: A scatter chart for the relationship between two variables.
+    elements:
+    - frame
+    - svg
+    - grid_line
+    - tick
+    - reference_line
+    - reference_area
+    - reference_dot
+    - error_bar
+    capsule: 132a5aba612e
+    controllers:
+    - identifier: poetry--charts--motion
+      targets: []
+      values: []
+      actions: []
+      events:
+      - poetry--charts--motion:settled
+    - identifier: poetry--charts--tooltip
+      targets:
+      - data
+      - svg
+      - tooltip
+      values:
+      - sync
+      actions:
+      - blur
+      - count
+      - enter
+      - focus
+      - keydown
+      - leave
+      - move
+      - refresh
+      - show
+      events:
+      - poetry--charts--tooltip:hide
+      - poetry--charts--tooltip:show
+    agent_rules:
+    - 'Both axes are numeric: with_x_axis(data_key:) / with_y_axis(data_key:) name
+      the row keys to plot.'
+    - 'with_scatter(key:) colors points var(--color-<key>); data: gives a series its
+      own rows.'
+    - 'with_z_axis(data_key:, range: [64, 144]) sizes points by a third dimension
+      - the range is marker AREA in px2 (the source''s z-axis contract).'
+    - The tooltip hits per point and shows the x/y(/z) values with the series color.
+    - 'Entrance animation is on by default (400ms linear, source-exact); animate:
+      false for a static chart.'
+    parts:
+    - name: chart-svg
+      description: The chart canvas (<svg>) - server-computed geometry in a fixed
+        viewBox; role=img, or the focusable role=application accessibilityLayer when
+        the tooltip attaches
+      states:
+      - attr: data-animate
+        condition: present when animate (the default) - the motion stylesheet and
+          controller key the entrance off it
+      - attr: data-motion
+        condition: runtime - the motion rig stamps the animation lifecycle (entrance/morph,
+          then settled)
+        values:
+        - entrance
+        - morph
+        - settled
+      vars:
+      - name: "--poetry-motion-duration"
+        description: the entrance/morph duration (animation_duration, ms)
+      - name: "--poetry-motion-easing"
+        description: the animation easing keyword (animation_easing)
+      - name: "--poetry-motion-delay"
+        description: the pre-animation hold (animation_begin, ms)
+    - name: chart-grid
+      description: The gridline group (with_grid) - horizontal and/or vertical rules
+        across the plot
+    - name: chart-scatters
+      description: The scatter-mark group - every series' points flattened with a
+        global index
+    - name: chart-scatter-point
+      description: One data point (<circle>) - r carries the z-axis area sizing
+      states:
+      - attr: data-key
+        condition: the series key
+      - attr: data-index
+        condition: the point's global index across every series
+      - attr: data-active
+        condition: runtime - the tooltip controller marks the hovered point
+    - name: chart-error-bars
+      description: One series' error-whisker group (error_key:) - cap-stem-cap paths
+        in the foreground color
+      states:
+      - attr: data-key
+        condition: the series key
+    - name: chart-reference
+      description: The reference-mark group (with_reference_line/_area/_dot), painted
+        above the series
+    - name: chart-x-axis
+      description: The x-axis tick-label group (with_x_axis)
+    - name: chart-y-axis
+      description: The y-axis tick-label group (with_y_axis)
+    - name: chart-coordinates
+      description: The embedded per-index geometry payload (<script type=application/json>)
+        the tooltip controller reads - zero chart math in the browser
+    stimulus:
+    - element: frame
+      controllers:
+      - identifier: poetry--charts--tooltip
+        conditional: if tooltip?
+        registers: true
+        values:
+        - name: sync
+          conditional: if
+      - identifier: poetry--charts--motion
+        conditional: if animate?
+        registers: true
+    - element: svg
+      controllers:
+      - identifier: poetry--charts--tooltip
+        conditional: if tooltip?
+        targets:
+        - name: svg
+        actions:
+        - method: move
+          'on': pointermove
+        - method: leave
+          'on': pointerleave
+        - method: focus
+          'on': focus
+        - method: blur
+          'on': blur
+        - method: keydown
+          'on': keydown
+      - identifier: poetry--charts--tooltip
+        conditional: if tooltip?
+        actions:
+        - method: enter
+          'on': pointerover
+    - element: coordinates
+      controllers:
+      - identifier: poetry--charts--tooltip
+        conditional: if tooltip?
+        targets:
+        - name: data
+    - element: tooltip_layer
+      controllers:
+      - identifier: poetry--charts--tooltip
+        conditional: if tooltip?
+        targets:
+        - name: tooltip
+  poetry/charts/tooltip_content:
+    class_name: Poetry::Charts::TooltipContent::Component
+    identifier: poetry--charts--tooltip_content
+    bem_block: poetry-charts-tooltip_content
+    styles: []
+    options:
+    - name: config
+      type:
+      required: true
+      description: 'The series config - key => { label:, color: } - resolving row
+        names and colors.'
+    - name: hide_indicator
+      type: boolean
+      default: false
+      description: Hides the row swatches.
+    - name: hide_label
+      type: boolean
+      default: false
+      description: Hides the category label.
+    - name: indicator
+      type: symbol
+      variants:
+      - dot
+      - line
+      - dashed
+      default: dot
+      description: The row swatch shape.
+    - name: items
+      type:
+      required: true
+      description: 'The rows: [{ key:, name:, value:, color: }] hashes, one per series.'
+    - name: label
+      type: string
+      description: The category label above the rows, resolved through the config.
+    slots: []
+    elements:
+    - label
+    - inner
+    - row
+    - row_dot
+    - indicator
+    - indicator_dot
+    - indicator_line
+    - indicator_dashed
+    - indicator_dashed_nested
+    - value_wrap
+    - value_wrap_center
+    - value_wrap_end
+    - name
+    - value
+    capsule: 74b8c24f20d2
+    agent_rules:
+    - Tooltip rows resolve names/colors through the chart config - pass key:, not
+      a display string.
+    - 'indicator: :dot (default) | :line | :dashed matches the ported variants.'
+    - Numeric values render delimited (1,234) in the mono tabular column automatically.
+    identity: false
+    parts:
+    - name: chart-tooltip-content
+      description: The tooltip box (<div>) - the styled chrome the chart's tooltip
+        controller positions and text-swaps
+    - name: chart-tooltip-label
+      description: The category label (<div>) - above the rows, or nested inside the
+        single row for line/dashed indicators
+    - name: chart-tooltip-item
+      description: One series row (<div>) - indicator + name + value
+      states:
+      - attr: data-key
+        condition: always - the series key the controller matches values by
+    - name: chart-tooltip-indicator
+      description: The row's swatch (<div>) - dot/line/dashed per indicator:, hidden
+        with hide_indicator
+      vars:
+      - name: "--color-bg"
+        description: the swatch fill - carries the row's series color (inline; polar
+          charts retint it to the hovered slice's color at runtime)
+      - name: "--color-border"
+        description: the swatch border - the same series color as the fill
+    - name: chart-tooltip-name
+      description: The series name (<span>) - resolved through the chart config
+    - name: chart-tooltip-value
+      description: The formatted value (<span>) - the mono tabular column, numbers
+        delimited
+  poetry/charts/tooltip_layer:
+    class_name: Poetry::Charts::TooltipLayer::Component
+    identifier: poetry--charts--tooltip_layer
+    bem_block: poetry-charts-tooltip_layer
+    styles: []
+    options:
+    - name: config
+      type:
+      required: true
+      description: 'The series config - key => { label:, color: } - resolving row
+        names and colors.'
+    - name: hide_indicator
+      type: boolean
+      default: false
+      description: Hides the row swatches.
+    - name: hide_label
+      type: boolean
+      default: false
+      description: Hides the category label.
+    - name: indicator
+      type: symbol
+      default: dot
+      description: The row swatch shape.
+    - name: series_keys
+      type:
+      required: true
+      description: The series keys to pre-render rows for.
+    slots: []
+    elements: []
+    capsule: 3aa9cd90e2e1
+    controllers:
+    - identifier: poetry--charts--tooltip
+      targets:
+      - data
+      - svg
+      - tooltip
+      values:
+      - sync
+      actions:
+      - blur
+      - count
+      - enter
+      - focus
+      - keydown
+      - leave
+      - move
+      - refresh
+      - show
+      events:
+      - poetry--charts--tooltip:hide
+      - poetry--charts--tooltip:show
+    identity: false
+    stimulus:
+    - element: root
+      controllers:
+      - identifier: poetry--charts--tooltip
+        targets:
+        - name: tooltip
+helpers:
+  poetry_chart:
+    yields: the dispatched chart component
+helper_args:
+  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_line_chart: 0