From 1b5c7b82bf87d3f67a9577997ef5c40a89d45081 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]" <github-actions[bot]@users.noreply.github.com>
Date: Sun, 14 Dec 2025 11:15:28 +0000
Subject: [PATCH] spec: add treemap-basic specification

Created from issue #766
---
 plots/treemap-basic/specification.md   | 26 +++++++++++++++++++++
 plots/treemap-basic/specification.yaml | 31 ++++++++++++++++++++++++++
 2 files changed, 57 insertions(+)
 create mode 100644 plots/treemap-basic/specification.md
 create mode 100644 plots/treemap-basic/specification.yaml

diff --git a/plots/treemap-basic/specification.md b/plots/treemap-basic/specification.md
new file mode 100644
index 0000000000..761ee7b91c
--- /dev/null
+++ b/plots/treemap-basic/specification.md
@@ -0,0 +1,26 @@
+# treemap-basic: Basic Treemap
+
+## Description
+
+A treemap displaying hierarchical data as nested rectangles, where each rectangle's area is proportional to its value. This visualization excels at showing part-to-whole relationships in hierarchical structures, making it easy to spot large and small items at a glance. Treemaps efficiently use screen space to display large amounts of hierarchical data in a compact form.
+
+## Applications
+
+- Disk space usage visualization by folder and file size
+- Budget allocation breakdown by department and project
+- Market capitalization comparison by sector and company
+- Website traffic analysis by country and city
+
+## Data
+
+- `category` (string) - main category or parent group
+- `subcategory` (string) - optional sub-category for nested hierarchy
+- `value` (numeric) - size/magnitude determining each rectangle's area
+- Size: 5-50 items
+
+## Notes
+
+- Use distinct colors for main categories to aid quick identification
+- Add labels for larger rectangles; smaller ones may omit labels for clarity
+- Include subtle borders between rectangles to show hierarchy boundaries
+- Show hierarchy through nesting depth or color shading intensity
diff --git a/plots/treemap-basic/specification.yaml b/plots/treemap-basic/specification.yaml
new file mode 100644
index 0000000000..bd7eb4468a
--- /dev/null
+++ b/plots/treemap-basic/specification.yaml
@@ -0,0 +1,31 @@
+# Specification-level metadata for treemap-basic
+# Auto-synced to PostgreSQL on push to main
+
+spec_id: treemap-basic
+title: Basic Treemap
+
+# Specification tracking
+created: 2025-12-14T11:15:11Z
+issue: 766
+suggested: MarkusNeusinger
+history: []
+
+# Classification tags (applies to all library implementations)
+tags:
+  plot_type:
+    - treemap
+    - hierarchical
+  domain:
+    - general
+    - business
+    - finance
+  features:
+    - basic
+    - hierarchical
+    - part-to-whole
+  audience:
+    - beginner
+    - intermediate
+  data_type:
+    - categorical
+    - numeric