spec: add waffle-basic specification

plots/waffle-basic/specification.md

@@ -0,0 +1,26 @@
+# waffle-basic: Basic Waffle Chart
+
+## Description
+
+A waffle chart displays proportions using a grid of equal-sized squares where colored squares represent parts of a whole. Each square typically represents 1% of the total, making it easy to count and compare values visually. It provides an intuitive alternative to pie charts, offering more accurate perception of proportions.
+
+## Applications
+
+- Visualizing survey results and polling data to show response distributions
+- Displaying budget allocation across spending categories
+- Tracking progress towards goals (e.g., fundraising at 73% of target)
+- Showing demographic breakdowns in population studies
+
+## Data
+
+- `category` (categorical) - Category labels for each segment
+- `value` (numeric) - Proportions or percentages for each category
+- Size: 2-6 categories typical
+- Note: Values should sum to 100 or be normalized to percentages
+
+## Notes
+
+- Standard grid is 10x10 (100 squares) where each square = 1%
+- Use distinct, contrasting colors for each category
+- Include a legend identifying categories with their percentages
+- Round values to whole squares for clean visualization

plots/waffle-basic/specification.yaml

@@ -0,0 +1,30 @@
+# Specification-level metadata for waffle-basic
+# Auto-synced to PostgreSQL on push to main
+
+spec_id: waffle-basic
+title: Basic Waffle Chart
+
+# Specification tracking
+created: 2025-12-15T20:44:32Z
+issue: 998
+suggested: MarkusNeusinger
+history: []
+
+# Classification tags (applies to all library implementations)
+tags:
+  plot_type:
+    - waffle
+    - proportion
+  domain:
+    - general
+    - business
+    - statistics
+  features:
+    - basic
+    - part-to-whole
+    - grid
+  audience:
+    - beginner
+  data_type:
+    - categorical
+    - numeric