From d0837c404c7aece081c5f3aa1c7f666b917383f2 Mon Sep 17 00:00:00 2001
From: Scott Rhamy <scott@rhamy.com>
Date: Sun, 23 Nov 2025 10:02:20 -0500
Subject: [PATCH] Add Tools/Pivot

---
 docs/src/content/components/Pivot.md        | 20 ++++++++++++++++++
 docs/src/examples/Pivot/pivot-longer.svelte | 23 +++++++++++++++++++++
 docs/src/examples/Pivot/pivot-wider.svelte  | 17 +++++++++++++++
 3 files changed, 60 insertions(+)
 create mode 100644 docs/src/content/components/Pivot.md
 create mode 100644 docs/src/examples/Pivot/pivot-longer.svelte
 create mode 100644 docs/src/examples/Pivot/pivot-wider.svelte

diff --git a/docs/src/content/components/Pivot.md b/docs/src/content/components/Pivot.md
new file mode 100644
index 000000000..b7433c590
--- /dev/null
+++ b/docs/src/content/components/Pivot.md
@@ -0,0 +1,20 @@
+---
+description: Utility function to reshape and aggregate tabular data, converting between long and wide formats.
+category: tools
+layers: []
+related: []
+---
+
+<script lang="ts">
+  import Example from '$lib/components/Example.svelte';
+</script>
+
+## Usage
+
+### PivotLonger (Columns to Rows)
+
+<Example name="pivot-longer"  />
+
+### PivotWider (Rows to Columns)
+
+<Example name="pivot-wider"  />
diff --git a/docs/src/examples/Pivot/pivot-longer.svelte b/docs/src/examples/Pivot/pivot-longer.svelte
new file mode 100644
index 000000000..7ed84b55c
--- /dev/null
+++ b/docs/src/examples/Pivot/pivot-longer.svelte
@@ -0,0 +1,23 @@
+<script lang="ts">
+	import { pivotLonger } from 'layerchart';
+
+	import Code from '$lib/components/Code.svelte';
+	import Json from '$lib/components/Json.svelte';
+	import { wideData, longData } from '$lib/utils/data';
+</script>
+
+<Code
+	source="pivotLonger(wideData, ['apples', 'bananas', 'cherries', 'grapes'], 'fruit', 'value')"
+	language="js"
+/>
+
+<h2 class="pt-4">Before</h2>
+
+<Json value={wideData} class="rounded-sm" />
+
+<h2>After</h2>
+
+<Json
+	value={pivotLonger(wideData, ['apples', 'bananas', 'cherries', 'grapes'], 'fruit', 'value')}
+	class="rounded-sm"
+/>
diff --git a/docs/src/examples/Pivot/pivot-wider.svelte b/docs/src/examples/Pivot/pivot-wider.svelte
new file mode 100644
index 000000000..f5d63071e
--- /dev/null
+++ b/docs/src/examples/Pivot/pivot-wider.svelte
@@ -0,0 +1,17 @@
+<script lang="ts">
+	import { pivotWider } from 'layerchart';
+
+	import Code from '$lib/components/Code.svelte';
+	import Json from '$lib/components/Json.svelte';
+	import { longData } from '$lib/utils/data';
+</script>
+
+<Code source="pivotWider(longData, 'year', 'fruit', 'value')" language="js" />
+
+<h2 class="pt-4">Before</h2>
+
+<Json value={longData} class="rounded-sm" />
+
+<h2>After</h2>
+
+<Json value={pivotWider(longData, 'year', 'fruit', 'value')} class="rounded-sm" />