Added PowerPoint templates to the Slide Assistant (#1055)

Co-authored-by: Thorsten Sommer <SommerEngineering@users.noreply.github.com>

app/MindWork AI Studio/Tools/PowerPoint/TemplateLayout.cs

@@ -0,0 +1,36 @@
+namespace AIStudio.Tools.PowerPoint;
+
+/// <summary>
+/// One slide layout of a template.
+/// </summary>
+/// <param name="Name">The name the template gives the layout.</param>
+/// <param name="PartUri">Where the layout is stored inside the file, which identifies it when the presentation is written.</param>
+/// <param name="LayoutType">The layout type as the file spells it, e.g., "title" or "secHead"; empty when the file states none.</param>
+/// <param name="Slots">The slots in reading order: from top to bottom, and from left to right within a row.</param>
+internal sealed record TemplateLayout(string Name, Uri PartUri, string LayoutType, IReadOnlyList<TemplateSlot> Slots)
+{
+    /// <summary>
+    /// Finds the slot a placeholder of a slide based on this layout fills.
+    /// </summary>
+    /// <remarks>
+    /// PowerPoint links the placeholders of a slide to those of its layout by their index, and a
+    /// placeholder without an index, such as the title, by its type. A slide often states the type
+    /// less precisely than its layout does, e.g., none at all for a body, so the index wins.
+    /// </remarks>
+    /// <param name="placeholderType">The placeholder type as the slide spells it; "obj" when it states none.</param>
+    /// <param name="placeholderIndex">The placeholder index the slide states, if any.</param>
+    /// <returns>The slot, or null when the placeholder fills none, e.g., because it is the footer.</returns>
+    public TemplateSlot? SlotOf(string placeholderType, uint? placeholderIndex)
+    {
+        if (placeholderIndex is { } index && this.Slots.FirstOrDefault(slot => slot.PlaceholderIndex == index) is { } slotByIndex)
+            return slotByIndex;
+
+        var typeGroup = TypeGroupOf(placeholderType);
+        return this.Slots.FirstOrDefault(slot => (slot.PlaceholderIndex is null || placeholderIndex is null) && TypeGroupOf(slot.PlaceholderType) == typeGroup);
+    }
+
+    /// <summary>
+    /// The type a placeholder is matched by: a title is a title, whether it is centered or not.
+    /// </summary>
+    private static string TypeGroupOf(string placeholderType) => placeholderType == "ctrTitle" ? "title" : placeholderType;
+}