From 48180259d2631f583170aa1ac05af8629a687451 Mon Sep 17 00:00:00 2001
From: Joseph Doherty <dohertj2@Josephs-MacBook-Pro.local>
Date: Tue, 6 Jan 2026 23:22:56 -0500
Subject: [PATCH] feat(ExcelIO): add ColumnBuilder fluent API

---
 .../Mapping/ColumnBuilder.cs                  | 52 +++++++++++++++++++
 1 file changed, 52 insertions(+)
 create mode 100644 NEW/src/JdeScoping.ExcelIO/Mapping/ColumnBuilder.cs

diff --git a/NEW/src/JdeScoping.ExcelIO/Mapping/ColumnBuilder.cs b/NEW/src/JdeScoping.ExcelIO/Mapping/ColumnBuilder.cs
new file mode 100644
index 0000000..d82fded
--- /dev/null
+++ b/NEW/src/JdeScoping.ExcelIO/Mapping/ColumnBuilder.cs
@@ -0,0 +1,52 @@
+namespace JdeScoping.ExcelIO.Mapping;
+
+/// <summary>
+/// Fluent builder for configuring Excel column properties.
+/// </summary>
+/// <typeparam name="T">The model type being mapped.</typeparam>
+/// <typeparam name="TProperty">The property type.</typeparam>
+public sealed class ColumnBuilder<T, TProperty>
+{
+    private readonly ColumnDefinition _definition;
+
+    internal ColumnBuilder(ColumnDefinition definition)
+    {
+        _definition = definition;
+    }
+
+    /// <summary>Sets the column display order.</summary>
+    public ColumnBuilder<T, TProperty> Order(int order)
+    {
+        _definition.Order = order;
+        return this;
+    }
+
+    /// <summary>Sets the column header text.</summary>
+    public ColumnBuilder<T, TProperty> Header(string text)
+    {
+        _definition.HeaderText = text;
+        return this;
+    }
+
+    /// <summary>Sets the Excel number format.</summary>
+    public ColumnBuilder<T, TProperty> Format(string format)
+    {
+        _definition.Format = format;
+        return this;
+    }
+
+    /// <summary>Sets a fixed column width (disables auto-width).</summary>
+    public ColumnBuilder<T, TProperty> Width(double width)
+    {
+        _definition.AutoWidth = false;
+        _definition.Width = width;
+        return this;
+    }
+
+    /// <summary>Enables text wrapping for the column.</summary>
+    public ColumnBuilder<T, TProperty> WrapText(bool wrap = true)
+    {
+        _definition.WrapText = wrap;
+        return this;
+    }
+}