From bfbec425f4ce6f8839b98ba626df499883b02fbd Mon Sep 17 00:00:00 2001
From: Joseph Doherty <dohertj2@Josephs-MacBook-Pro.local>
Date: Tue, 6 Jan 2026 23:21:28 -0500
Subject: [PATCH] feat(ExcelIO): add ColumnDefinition for fluent mapping

---
 ...{FileController.cs => FileIOController.cs} |  0
 .../Mapping/ColumnDefinition.cs               | 34 +++++++++++++++++++
 2 files changed, 34 insertions(+)
 rename NEW/src/JdeScoping.Api/Controllers/{FileController.cs => FileIOController.cs} (100%)
 create mode 100644 NEW/src/JdeScoping.ExcelIO/Mapping/ColumnDefinition.cs

diff --git a/NEW/src/JdeScoping.Api/Controllers/FileController.cs b/NEW/src/JdeScoping.Api/Controllers/FileIOController.cs
similarity index 100%
rename from NEW/src/JdeScoping.Api/Controllers/FileController.cs
rename to NEW/src/JdeScoping.Api/Controllers/FileIOController.cs
diff --git a/NEW/src/JdeScoping.ExcelIO/Mapping/ColumnDefinition.cs b/NEW/src/JdeScoping.ExcelIO/Mapping/ColumnDefinition.cs
new file mode 100644
index 0000000..fade702
--- /dev/null
+++ b/NEW/src/JdeScoping.ExcelIO/Mapping/ColumnDefinition.cs
@@ -0,0 +1,34 @@
+namespace JdeScoping.ExcelIO.Mapping;
+
+/// <summary>
+/// Defines how a property maps to an Excel column.
+/// </summary>
+public sealed class ColumnDefinition
+{
+    /// <summary>Property name for debugging/error messages.</summary>
+    public required string PropertyName { get; init; }
+
+    /// <summary>Compiled delegate to get property value from object.</summary>
+    public required Func<object, object?> ValueGetter { get; init; }
+
+    /// <summary>Property type for formatting decisions.</summary>
+    public required Type PropertyType { get; init; }
+
+    /// <summary>Column display order (lower = leftmost).</summary>
+    public int Order { get; set; }
+
+    /// <summary>Column header text.</summary>
+    public string HeaderText { get; set; } = string.Empty;
+
+    /// <summary>Excel number format string.</summary>
+    public string Format { get; set; } = "@";
+
+    /// <summary>Auto-size column width.</summary>
+    public bool AutoWidth { get; set; } = true;
+
+    /// <summary>Manual column width (when AutoWidth = false).</summary>
+    public double Width { get; set; }
+
+    /// <summary>Enable text wrapping.</summary>
+    public bool WrapText { get; set; }
+}