From c287e3ec3280970ad30140d2d16e343532d98ee4 Mon Sep 17 00:00:00 2001
From: AJ Isaacs <ajisaacs27@gmail.com>
Date: Wed, 18 Mar 2026 12:57:27 -0400
Subject: [PATCH] feat(engine): add IFillStrategy interface and FillContext

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 OpenNest.Engine/Strategies/FillContext.cs   | 25 +++++++++++++++++++++
 OpenNest.Engine/Strategies/IFillStrategy.cs | 12 ++++++++++
 2 files changed, 37 insertions(+)
 create mode 100644 OpenNest.Engine/Strategies/FillContext.cs
 create mode 100644 OpenNest.Engine/Strategies/IFillStrategy.cs

diff --git a/OpenNest.Engine/Strategies/FillContext.cs b/OpenNest.Engine/Strategies/FillContext.cs
new file mode 100644
index 0000000..7899668
--- /dev/null
+++ b/OpenNest.Engine/Strategies/FillContext.cs
@@ -0,0 +1,25 @@
+using System;
+using System.Collections.Generic;
+using System.Threading;
+using OpenNest.Geometry;
+
+namespace OpenNest
+{
+    public class FillContext
+    {
+        public NestItem Item { get; init; }
+        public Box WorkArea { get; init; }
+        public Plate Plate { get; init; }
+        public int PlateNumber { get; init; }
+        public CancellationToken Token { get; init; }
+        public IProgress<NestProgress> Progress { get; init; }
+
+        public List<Part> CurrentBest { get; set; }
+        public FillScore CurrentBestScore { get; set; }
+        public NestPhase WinnerPhase { get; set; }
+        public List<PhaseResult> PhaseResults { get; } = new();
+        public List<AngleResult> AngleResults { get; } = new();
+
+        public Dictionary<string, object> SharedState { get; } = new();
+    }
+}
diff --git a/OpenNest.Engine/Strategies/IFillStrategy.cs b/OpenNest.Engine/Strategies/IFillStrategy.cs
new file mode 100644
index 0000000..86170f0
--- /dev/null
+++ b/OpenNest.Engine/Strategies/IFillStrategy.cs
@@ -0,0 +1,12 @@
+using System.Collections.Generic;
+
+namespace OpenNest
+{
+    public interface IFillStrategy
+    {
+        string Name { get; }
+        NestPhase Phase { get; }
+        int Order { get; }
+        List<Part> Fill(FillContext context);
+    }
+}