feat(pygal): implement bar-grouped

plots/bar-grouped/implementations/python/pygal.py

@@ -1,7 +1,7 @@
-""" pyplots.ai
+""" anyplot.ai
 bar-grouped: Grouped Bar Chart
-Library: pygal 3.1.0 | Python 3.13.11
-Quality: 92/100 | Created: 2025-12-24
+Library: pygal 3.1.0 | Python 3.13.13
+Quality: 85/100 | Updated: 2026-05-06
 """
 
 import pygal

plots/bar-grouped/metadata/python/pygal.yaml

@@ -1,158 +1,197 @@
 library: pygal
+language: python
 specification_id: bar-grouped
 created: '2025-12-24T21:28:20Z'
-updated: '2025-12-24T21:30:30Z'
-generated_by: claude-opus-4-5-20251101
-workflow_run: 20494139035
-issue: 0
-python_version: 3.13.11
+updated: '2026-05-06T11:15:39Z'
+generated_by: claude-haiku
+workflow_run: 25431367665
+issue: 1822
+python_version: 3.13.13
 library_version: 3.1.0
-preview_url: https://storage.googleapis.com/anyplot-images/plots/bar-grouped/pygal/plot.png
-preview_html: https://storage.googleapis.com/anyplot-images/plots/bar-grouped/pygal/plot.html
-quality_score: 92
-impl_tags:
-  dependencies: []
-  techniques:
-  - html-export
-  patterns: []
-  dataprep: []
-  styling: []
+preview_url_light: https://storage.googleapis.com/anyplot-images/plots/bar-grouped/python/pygal/plot-light.png
+preview_url_dark: https://storage.googleapis.com/anyplot-images/plots/bar-grouped/python/pygal/plot-dark.png
+preview_html_light: https://storage.googleapis.com/anyplot-images/plots/bar-grouped/python/pygal/plot-light.html
+preview_html_dark: https://storage.googleapis.com/anyplot-images/plots/bar-grouped/python/pygal/plot-dark.html
+quality_score: 85
 review:
   strengths:
-  - Excellent use of pygal Style class for comprehensive visual customization
-  - Clean data structure with meaningful business context (quarterly revenue by product)
-  - Value labels with currency formatting ($X.XM) enhance readability
-  - Good color palette that is both visually appealing and accessible
-  - Proper dual output (PNG and HTML) leveraging pygal interactive capabilities
+  - Perfect visual legibility in both light and dark themes with no contrast or readability
+    issues
+  - Correct Okabe-Ito palette implementation with brand green (#009E73) as first series;
+    theme-adaptive backgrounds and chrome working properly
+  - Proper grouped bar chart structure with clear visual separation between category
+    groups and excellent use of the 4800×2700 canvas
+  - Value labels on bars provide precise data interpretation without clutter
+  - Clean, deterministic, reproducible code with no unnecessary complexity
+  - Correct mapping of data to x-axis (quarters), y-axis (revenue), and groups (product
+    lines)
   weaknesses:
-  - Legend placement in top-left could be moved to a less intrusive position
-  - Font sizes deviate from library style guide recommendations
-  image_description: 'The plot displays a grouped bar chart showing quarterly revenue
-    data for three product lines. Four quarters (Q1-Q4) are shown on the x-axis with
-    three bars per quarter representing Software (blue #306998), Hardware (yellow
-    #FFD43B), and Services (coral/pink #FF6B6B). The y-axis shows Revenue in millions
-    of dollars ranging from $0.0M to $6.0M. Each bar has a value label on top (e.g.,
-    $4.2M, $5.1M, $6.3M). The legend is positioned in the top-left corner. The title
-    "bar-grouped · pygal · pyplots.ai" appears at the top. The background is white
-    with subtle horizontal grid lines, and the overall layout is clean and well-proportioned.'
+  - Design lacks visual hierarchy or emphasis - plot displays data clearly but doesn't
+    guide viewer to key insights
+  - Four-sided spines present; removing top/right spines would improve visual refinement
+    per style guide
+  - Legend labels and axis annotations could be larger and more descriptive
+  - No distinctive pygal features leveraged (interactive tooltips remain absent in
+    static output)
+  image_description: |-
+    Light render (plot-light.png):
+      Background: Warm off-white (#FAF8F1), clean and professional
+      Chrome: Title "bar-grouped · pygal · anyplot.ai" at top in dark text, clearly visible
+              Y-axis labeled "Revenue ($M)" with dark tick labels
+              X-axis labeled "Quarter" with Q1-Q4 category labels
+              Legend in top-left corner showing Software, Hardware, Services
+              Grid lines subtle and non-competing with data
+      Data: Three series shown as grouped bars:
+            - Green (#009E73) = Software (first series, brand green - correct)
+            - Orange (#D55E00) = Hardware (second series)
+            - Blue (#0072B2) = Services (third series)
+            Value labels on top of bars (e.g., "$4.2M")
+      Legibility verdict: PASS - All text clearly readable, excellent contrast, professional appearance
+
+    Dark render (plot-dark.png):
+      Background: Warm near-black (#1A1A17), matching light theme color scheme
+      Chrome: Title in light text, clearly visible against dark background
+              Y-axis labeled "Revenue ($M)" with light tick labels
+              X-axis labeled "Quarter" with Q1-Q4 category labels
+              Legend in top-left corner with light text on dark background
+              Grid lines subtle against dark surface
+      Data: Identical colors to light render:
+            - Green (#009E73) = Software (IDENTICAL to light render)
+            - Orange (#D55E00) = Hardware (IDENTICAL to light render)
+            - Blue (#0072B2) = Services (IDENTICAL to light render)
+            Value labels readable on bars
+      Legibility verdict: PASS - No dark-on-dark failures, all text readable, proper theme adaptation with identical data colors between light/dark
+
+    Both renders successfully demonstrate theme-adaptive implementation with correct Okabe-Ito palette and theme-appropriate chrome.
   criteria_checklist:
     visual_quality:
-      score: 36
-      max: 40
+      score: 30
+      max: 30
       items:
       - id: VQ-01
         name: Text Legibility
-        score: 9
-        max: 10
+        score: 8
+        max: 8
         passed: true
-        comment: Title, axis labels, and value labels are all clearly readable. Font
-          sizes are well-scaled for the 4800x2700 canvas.
+        comment: All text perfectly readable in both light and dark themes with explicit
+          font sizing for large canvas
       - id: VQ-02
         name: No Overlap
-        score: 8
-        max: 8
+        score: 6
+        max: 6
         passed: true
-        comment: No overlapping text elements; all labels are cleanly separated.
+        comment: Bars perfectly spaced with no overlapping elements or text collisions
       - id: VQ-03
         name: Element Visibility
-        score: 8
-        max: 8
+        score: 6
+        max: 6
         passed: true
-        comment: Bars are well-sized with good spacing between groups and within groups.
+        comment: All bars, grid lines, and labels clearly visible and appropriately
+          sized
       - id: VQ-04
         name: Color Accessibility
-        score: 5
-        max: 5
+        score: 2
+        max: 2
         passed: true
-        comment: Blue, yellow, and coral provide excellent contrast and are colorblind-friendly
-          (no red-green only distinction).
+        comment: Okabe-Ito palette with high contrast between series; colorblind-safe
       - id: VQ-05
-        name: Layout Balance
+        name: Layout & Canvas
         score: 4
-        max: 5
+        max: 4
         passed: true
-        comment: Good canvas utilization; plot fills majority of space. Legend placement
-          in top-left is functional but slightly crowds the first data point area.
+        comment: Excellent canvas utilization with balanced margins and whitespace
       - id: VQ-06
-        name: Axis Labels
+        name: Axis Labels & Title
         score: 2
         max: 2
         passed: true
-        comment: 'Both axes have descriptive labels with units: "Revenue ($M)" and
-          "Quarter".'
+        comment: Title and axis labels present and descriptive; format follows spec
       - id: VQ-07
-        name: Grid & Legend
-        score: 0
+        name: Palette Compliance
+        score: 2
         max: 2
         passed: true
-        comment: Grid is subtle and appropriate. However, legend position overlaps
-          with the plot area margin and could be better placed.
+        comment: 'Okabe-Ito palette correct with first series as #009E73; backgrounds
+          match theme tokens; chrome properly adapted'
+    design_excellence:
+      score: 11
+      max: 20
+      items:
+      - id: DE-01
+        name: Aesthetic Sophistication
+        score: 5
+        max: 8
+        passed: false
+        comment: Professional styling with custom Style object; functional but lacks
+          distinctive design elements
+      - id: DE-02
+        name: Visual Refinement
+        score: 3
+        max: 6
+        passed: false
+        comment: Grid subtly styled but all four spines retained; could be refined
+          by removing top/right spines
+      - id: DE-03
+        name: Data Storytelling
+        score: 3
+        max: 6
+        passed: false
+        comment: Data clearly presented but lacks visual hierarchy or emphasis to
+          guide viewer attention
     spec_compliance:
-      score: 25
-      max: 25
+      score: 15
+      max: 15
       items:
       - id: SC-01
         name: Plot Type
-        score: 8
-        max: 8
-        passed: true
-        comment: Correct grouped bar chart implementation.
-      - id: SC-02
-        name: Data Mapping
         score: 5
         max: 5
         passed: true
-        comment: Categories on x-axis, groups as separate series, values as bar heights.
-      - id: SC-03
+        comment: Correct grouped bar chart implementation
+      - id: SC-02
         name: Required Features
-        score: 5
-        max: 5
+        score: 4
+        max: 4
         passed: true
-        comment: 'All spec features present: distinct colors, clear legend, consistent
-          bar widths, value labels on bars.'
-      - id: SC-04
-        name: Data Range
+        comment: 'All required elements present: multiple series, categories, groups,
+          distinct colors, legend'
+      - id: SC-03
+        name: Data Mapping
         score: 3
         max: 3
         passed: true
-        comment: Y-axis shows full range from 0 to above maximum value.
-      - id: SC-05
-        name: Legend Accuracy
-        score: 2
-        max: 2
-        passed: true
-        comment: Legend correctly identifies all three product lines.
-      - id: SC-06
-        name: Title Format
-        score: 2
-        max: 2
+        comment: Categories on x-axis, values on y-axis, groups properly mapped as
+          side-by-side bars
+      - id: SC-04
+        name: Title & Legend
+        score: 3
+        max: 3
         passed: true
-        comment: Correctly uses "{spec-id} · {library} · pyplots.ai" format.
+        comment: Title follows format spec; legend labels match series names
     data_quality:
-      score: 19
-      max: 20
+      score: 14
+      max: 15
       items:
       - id: DQ-01
         name: Feature Coverage
-        score: 7
-        max: 8
+        score: 5
+        max: 6
         passed: true
-        comment: Shows variation across quarters and between product lines. Software
-          shows growth trend, all series show different patterns.
+        comment: Shows multiple product lines across four quarters demonstrating grouped
+          bar capability effectively
       - id: DQ-02
         name: Realistic Context
-        score: 7
-        max: 7
+        score: 5
+        max: 5
         passed: true
-        comment: Quarterly revenue by product line is a real, comprehensible business
-          scenario.
+        comment: Quarterly revenue data is realistic and neutral; values plausible
+          for business context
       - id: DQ-03
         name: Appropriate Scale
-        score: 5
-        max: 5
+        score: 4
+        max: 4
         passed: true
-        comment: Revenue values in $2.5M-$6.3M range are realistic for product line
-          quarterly revenue.
+        comment: Y-axis range (0-6.0M) appropriate for data with sensible increments
     code_quality:
       score: 9
       max: 10
@@ -162,43 +201,55 @@ review:
         score: 3
         max: 3
         passed: true
-        comment: 'Simple linear flow: imports → data → style → chart → save.'
+        comment: 'Clean linear code: imports → data → style → chart → save'
       - id: CQ-02
         name: Reproducibility
         score: 2
-        max: 3
+        max: 2
         passed: true
-        comment: Data is deterministic (hardcoded values), but no random seed needed
-          since no random data is used. Minor deduction for not using numpy/random
-          at all.
+        comment: Hardcoded deterministic data ensures reproducibility
       - id: CQ-03
         name: Clean Imports
         score: 2
         max: 2
         passed: true
-        comment: Only pygal and Style are imported, both are used.
+        comment: Only necessary imports for pygal and Style
       - id: CQ-04
-        name: No Deprecated API
+        name: Code Elegance
         score: 1
-        max: 1
-        passed: true
-        comment: Uses current pygal API.
+        max: 2
+        passed: false
+        comment: Clean code but environment-variable-based theme adaptation could
+          be more explicit
       - id: CQ-05
-        name: Output Correct
+        name: Output & API
         score: 1
         max: 1
         passed: true
-        comment: Saves as plot.png and plot.html.
-    library_features:
-      score: 3
-      max: 5
+        comment: Renders produce plot-light.png, plot-dark.png, and HTML files correctly
+    library_mastery:
+      score: 6
+      max: 10
       items:
-      - id: LF-01
-        name: Uses distinctive library features
-        score: 3
+      - id: LM-01
+        name: Idiomatic Usage
+        score: 4
         max: 5
         passed: true
-        comment: Uses pygal's Style customization, print_values with custom formatter,
-          SVG/PNG dual output. Could leverage more advanced features like tooltips
-          configuration or animation settings.
+        comment: Correct use of pygal.Bar(), .add(), Style object following standard
+          patterns; theme adaptation working
+      - id: LM-02
+        name: Distinctive Features
+        score: 2
+        max: 5
+        passed: false
+        comment: Uses custom Style for theming but doesn't leverage pygal-specific
+          features like interactive tooltips
   verdict: APPROVED
+impl_tags:
+  dependencies: []
+  techniques: []
+  patterns:
+  - data-generation
+  dataprep: []
+  styling: []