Use only Model namespace

docs/docfx.json

@@ -9,7 +9,8 @@
           ]
         }
       ],
-      "dest": "api"
+      "dest": "api",
+      "enumSortOrder": "declaringOrder"
     }
   ],
   "build": {

src/DotTiled.Benchmark/Program.cs

@@ -39,7 +39,7 @@ namespace MyBenchmarks
 
     [BenchmarkCategory("MapFromInMemoryTmxString")]
     [Benchmark(Baseline = true, Description = "DotTiled")]
-    public DotTiled.Model.Map LoadWithDotTiledFromInMemoryTmxString()
+    public DotTiled.Model LoadWithDotTiledFromInMemoryTmxString()
     {
       using var stringReader = new StringReader(_tmxContents);
       using var xmlReader = XmlReader.Create(stringReader);
@@ -49,7 +49,7 @@ namespace MyBenchmarks
 
     [BenchmarkCategory("MapFromInMemoryTmjString")]
     [Benchmark(Baseline = true, Description = "DotTiled")]
-    public DotTiled.Model.Map LoadWithDotTiledFromInMemoryTmjString()
+    public DotTiled.Model LoadWithDotTiledFromInMemoryTmjString()
     {
       using var mapReader = new DotTiled.Serialization.Tmj.TmjMapReader(_tmjContents, _ => throw new Exception(), _ => throw new Exception(), []);
       return mapReader.ReadMap();

src/DotTiled.Tests/Assert/AssertData.cs

@@ -1,4 +1,4 @@
-using DotTiled.Model.Layers;
+using DotTiled.Model;
 
 namespace DotTiled.Tests;
 

src/DotTiled.Tests/Assert/AssertImage.cs

@@ -1,4 +1,4 @@
-using DotTiled.Model.Tilesets;
+using DotTiled.Model;
 
 namespace DotTiled.Tests;
 

src/DotTiled.Tests/Assert/AssertLayer.cs

@@ -1,4 +1,4 @@
-using DotTiled.Model.Layers;
+using DotTiled.Model;
 
 namespace DotTiled.Tests;
 

src/DotTiled.Tests/Assert/AssertObject.cs

@@ -1,4 +1,4 @@
-using DotTiled.Model.Layers.Objects;
+using DotTiled.Model;
 
 namespace DotTiled.Tests;
 

src/DotTiled.Tests/Assert/AssertProperties.cs

@@ -1,4 +1,4 @@
-using DotTiled.Model.Properties;
+using DotTiled.Model;
 
 namespace DotTiled.Tests;
 

src/DotTiled.Tests/Assert/AssertTileset.cs

@@ -1,5 +1,5 @@
-using DotTiled.Model.Layers;
-using DotTiled.Model.Tilesets;
+using DotTiled.Model;
+using DotTiled.Model;
 
 namespace DotTiled.Tests;
 

src/DotTiled.Tests/Serialization/TestData.cs

@@ -1,6 +1,6 @@
 using System.Xml;
-using DotTiled.Model.Properties;
-using DotTiled.Model.Properties.CustomTypes;
+using DotTiled.Model;
+using DotTiled.Model;
 
 namespace DotTiled.Tests;
 

src/DotTiled.Tests/Serialization/TestData/Map/default-map/default-map.cs

@@ -1,5 +1,5 @@
 using DotTiled.Model;
-using DotTiled.Model.Layers;
+using DotTiled.Model;
 
 namespace DotTiled.Tests;
 

src/DotTiled.Tests/Serialization/TestData/Map/map-external-tileset-multi/map-external-tileset-multi.cs

@@ -1,8 +1,8 @@
 using System.Globalization;
 using DotTiled.Model;
-using DotTiled.Model.Layers;
-using DotTiled.Model.Properties;
-using DotTiled.Model.Tilesets;
+using DotTiled.Model;
+using DotTiled.Model;
+using DotTiled.Model;
 
 namespace DotTiled.Tests;
 

src/DotTiled.Tests/Serialization/TestData/Map/map-external-tileset-wangset/map-external-tileset-wangset.cs

@@ -1,7 +1,7 @@
 using System.Globalization;
 using DotTiled.Model;
-using DotTiled.Model.Layers;
-using DotTiled.Model.Tilesets;
+using DotTiled.Model;
+using DotTiled.Model;
 
 namespace DotTiled.Tests;
 

src/DotTiled.Tests/Serialization/TestData/Map/map-with-common-props/map-with-common-props.cs

@@ -1,7 +1,7 @@
 using System.Globalization;
 using DotTiled.Model;
-using DotTiled.Model.Layers;
-using DotTiled.Model.Properties;
+using DotTiled.Model;
+using DotTiled.Model;
 
 namespace DotTiled.Tests;
 

src/DotTiled.Tests/Serialization/TestData/Map/map-with-custom-type-props/map-with-custom-type-props.cs

@@ -1,8 +1,8 @@
 using System.Globalization;
 using DotTiled.Model;
-using DotTiled.Model.Layers;
-using DotTiled.Model.Properties;
-using DotTiled.Model.Properties.CustomTypes;
+using DotTiled.Model;
+using DotTiled.Model;
+using DotTiled.Model;
 
 namespace DotTiled.Tests;
 

src/DotTiled.Tests/Serialization/TestData/Map/map-with-embedded-tileset/map-with-embedded-tileset.cs

@@ -1,7 +1,7 @@
 using System.Globalization;
 using DotTiled.Model;
-using DotTiled.Model.Layers;
-using DotTiled.Model.Tilesets;
+using DotTiled.Model;
+using DotTiled.Model;
 
 namespace DotTiled.Tests;
 

src/DotTiled.Tests/Serialization/TestData/Map/map-with-external-tileset/map-with-external-tileset.cs

@@ -1,7 +1,7 @@
 using System.Globalization;
 using DotTiled.Model;
-using DotTiled.Model.Layers;
-using DotTiled.Model.Tilesets;
+using DotTiled.Model;
+using DotTiled.Model;
 
 namespace DotTiled.Tests;
 

src/DotTiled.Tests/Serialization/TestData/Map/map-with-flippingflags/map-with-flippingflags.cs

@@ -1,7 +1,7 @@
 using System.Globalization;
 using DotTiled.Model;
-using DotTiled.Model.Layers;
-using DotTiled.Model.Tilesets;
+using DotTiled.Model;
+using DotTiled.Model;
 
 namespace DotTiled.Tests;
 

src/DotTiled.Tests/Serialization/TestData/Map/map-with-many-layers/map-with-many-layers.cs

@@ -1,9 +1,9 @@
 using System.Numerics;
 using DotTiled.Model;
-using DotTiled.Model.Layers;
-using DotTiled.Model.Layers.Objects;
-using DotTiled.Model.Properties;
-using DotTiled.Model.Tilesets;
+using DotTiled.Model;
+using DotTiled.Model;
+using DotTiled.Model;
+using DotTiled.Model;
 
 namespace DotTiled.Tests;
 

src/DotTiled.Tests/Serialization/Tmj/TmjMapReaderTests.cs

@@ -1,6 +1,6 @@
 using DotTiled.Model;
-using DotTiled.Model.Properties.CustomTypes;
-using DotTiled.Model.Tilesets;
+using DotTiled.Model;
+using DotTiled.Model;
 using DotTiled.Serialization.Tmj;
 
 namespace DotTiled.Tests;

src/DotTiled.Tests/Serialization/Tmx/TmxMapReaderTests.cs

@@ -1,7 +1,7 @@
 using System.Xml;
 using DotTiled.Model;
-using DotTiled.Model.Properties.CustomTypes;
-using DotTiled.Model.Tilesets;
+using DotTiled.Model;
+using DotTiled.Model;
 using DotTiled.Serialization.Tmx;
 
 namespace DotTiled.Tests;

src/DotTiled/DotTiled.csproj

@@ -3,6 +3,7 @@
   <PropertyGroup>
     <TargetFramework>net8.0</TargetFramework>
     <Nullable>enable</Nullable>
+    <GenerateDocumentationFile>true</GenerateDocumentationFile>
   </PropertyGroup>
 
 </Project>

src/DotTiled/Model/Color.cs

@@ -1,22 +1,57 @@
 using System;
 using System.Diagnostics.CodeAnalysis;
 using System.Globalization;
+using System.Threading;
 
 namespace DotTiled.Model;
 
+/// <summary>
+/// Represents a Tiled color.
+/// </summary>
 public class Color : IParsable<Color>, IEquatable<Color>
 {
+  /// <summary>
+  /// The red component of the color.
+  /// </summary>
   public required byte R { get; set; }
+
+  /// <summary>
+  /// The green component of the color.
+  /// </summary>
   public required byte G { get; set; }
+
+  /// <summary>
+  /// The blue component of the color.
+  /// </summary>
   public required byte B { get; set; }
+
+  /// <summary>
+  /// The alpha component of the color.
+  /// </summary>
   public byte A { get; set; } = 255;
 
+  /// <summary>
+  /// Attempts to parse the specified string into a <see cref="Color"/>. Expects strings in the format <c>#RRGGBB</c> or <c>#AARRGGBB</c>.
+  /// The leading <c>#</c> is optional.
+  /// </summary>
+  /// <param name="s">A string value to parse into a <see cref="Color"/></param>
+  /// <param name="provider">An object that supplies culture-specific information about the format of s.</param>
+  /// <returns>The parsed <see cref="Color"/></returns>
+  /// <exception cref="FormatException">Thrown in case the provided string <paramref name="s"/> is not in a valid format.</exception>
   public static Color Parse(string s, IFormatProvider? provider)
   {
     TryParse(s, provider, out var result);
     return result ?? throw new FormatException($"Invalid format for TiledColor: {s}");
   }
 
+  /// <summary>
+  /// Attempts to parse the specified string into a <see cref="Color"/>. Expects strings in the format <c>#RRGGBB</c> or <c>#AARRGGBB</c>.
+  /// The leading <c>#</c> is optional.
+  /// </summary>
+  /// <param name="s">A string value to parse into a <see cref="Color"/></param>
+  /// <param name="provider">An object that supplies culture-specific information about the format of s.</param>
+  /// <param name="result">When this method returns, contains the parsed <see cref="Color"/> or <c>null</c> on failure.</param>
+  /// <returns><c>true</c> if <paramref name="s"/> was successfully parsed; otherwise, <c>false</c>.</returns>
   public static bool TryParse(
     [NotNullWhen(true)] string? s,
     IFormatProvider? provider,
@@ -55,6 +90,7 @@ public class Color : IParsable<Color>, IEquatable<Color>
     return true;
   }
 
+  /// <inheritdoc/>
   public bool Equals(Color? other)
   {
     if (other is null)
@@ -63,9 +99,12 @@ public class Color : IParsable<Color>, IEquatable<Color>
     return R == other.R && G == other.G && B == other.B && A == other.A;
   }
 
+  /// <inheritdoc/>
   public override bool Equals(object? obj) => obj is Color other && Equals(other);
 
+  /// <inheritdoc/>
   public override int GetHashCode() => HashCode.Combine(R, G, B, A);
 
+  /// <inheritdoc/>
   public override string ToString() => $"#{A:x2}{R:x2}{G:x2}{B:x2}";
 }

src/DotTiled/Model/Layers/BaseLayer.cs

@@ -1,7 +1,6 @@
 using System.Collections.Generic;
-using DotTiled.Model.Properties;
 
-namespace DotTiled.Model.Layers;
+namespace DotTiled.Model;
 
 public abstract class BaseLayer
 {

src/DotTiled/Model/Layers/Data.cs

@@ -1,6 +1,6 @@
 using System;
 
-namespace DotTiled.Model.Layers;
+namespace DotTiled.Model;
 
 public enum DataEncoding
 {

src/DotTiled/Model/Layers/Group.cs

@@ -1,6 +1,6 @@
 using System.Collections.Generic;
 
-namespace DotTiled.Model.Layers;
+namespace DotTiled.Model;
 
 public class Group : BaseLayer
 {

src/DotTiled/Model/Layers/ImageLayer.cs

@@ -1,6 +1,4 @@
-using DotTiled.Model.Tilesets;
-
-namespace DotTiled.Model.Layers;
+namespace DotTiled.Model;
 
 public class ImageLayer : BaseLayer
 {

src/DotTiled/Model/Layers/ObjectLayer.cs

@@ -1,7 +1,6 @@
 using System.Collections.Generic;
-using DotTiled.Model.Layers.Objects;
 
-namespace DotTiled.Model.Layers;
+namespace DotTiled.Model;
 
 public enum DrawOrder
 {

src/DotTiled/Model/Layers/Objects/EllipseObject.cs

@@ -1,3 +1,3 @@
-namespace DotTiled.Model.Layers.Objects;
+namespace DotTiled.Model;
 
 public class EllipseObject : Object { }

src/DotTiled/Model/Layers/Objects/Object.cs

@@ -1,7 +1,6 @@
 using System.Collections.Generic;
-using DotTiled.Model.Properties;
 
-namespace DotTiled.Model.Layers.Objects;
+namespace DotTiled.Model;
 
 public abstract class Object
 {

src/DotTiled/Model/Layers/Objects/PointObject.cs

@@ -1,3 +1,3 @@
-namespace DotTiled.Model.Layers.Objects;
+namespace DotTiled.Model;
 
 public class PointObject : Object { }

src/DotTiled/Model/Layers/Objects/PolygonObject.cs

@@ -1,7 +1,7 @@
 using System.Collections.Generic;
 using System.Numerics;
 
-namespace DotTiled.Model.Layers.Objects;
+namespace DotTiled.Model;
 
 public class PolygonObject : Object
 {

src/DotTiled/Model/Layers/Objects/PolylineObject.cs

@@ -1,7 +1,7 @@
 using System.Collections.Generic;
 using System.Numerics;
 
-namespace DotTiled.Model.Layers.Objects;
+namespace DotTiled.Model;
 
 public class PolylineObject : Object
 {

src/DotTiled/Model/Layers/Objects/RectangleObject.cs

@@ -1,3 +1,3 @@
-namespace DotTiled.Model.Layers.Objects;
+namespace DotTiled.Model;
 
 public class RectangleObject : Object { }

src/DotTiled/Model/Layers/Objects/TextObject.cs

@@ -1,7 +1,6 @@
 using System.Globalization;
 
-namespace DotTiled.Model.Layers.Objects;
-
+namespace DotTiled.Model;
 
 public enum TextHorizontalAlignment
 {

src/DotTiled/Model/Layers/Objects/TileObject.cs

@@ -1,4 +1,4 @@
-namespace DotTiled.Model.Layers.Objects;
+namespace DotTiled.Model;
 
 public class TileObject : Object
 {

src/DotTiled/Model/Layers/TileLayer.cs

@@ -1,4 +1,4 @@
-namespace DotTiled.Model.Layers;
+namespace DotTiled.Model;
 
 public class TileLayer : BaseLayer
 {

src/DotTiled/Model/Map.cs

@@ -1,66 +1,205 @@
 using System.Collections.Generic;
 using System.Globalization;
-using DotTiled.Model.Layers;
-using DotTiled.Model.Properties;
-using DotTiled.Model.Tilesets;
 
 namespace DotTiled.Model;
 
+/// <summary>
+/// Map orientation enumeration. The map orientation determines the alignment of the tiles in the map.
+/// </summary>
 public enum MapOrientation
 {
+  /// <summary>
+  /// Orthogonal orientation. This is the typical top-down grid-based layout.
+  /// </summary>
   Orthogonal,
+
+  /// <summary>
+  /// Isometric orientation. This is a type of axonometric projection where the tiles are shown as rhombuses, as seen from a side-on view.
+  /// </summary>
   Isometric,
+
+  /// <summary>
+  /// Staggered orientation. This is an isometric projection with a side-on view where the tiles are arranged in a staggered grid.
+  /// </summary>
   Staggered,
+
+  /// <summary>
+  /// Hexagonal orientation. This is a type of axial projection where the tiles are shown as hexagons, as seen from a top-down view.
+  /// </summary>
   Hexagonal
 }
 
+/// <summary>
+/// Render order enumeration. The order in which tiles on tile layers are rendered.
+/// </summary>
 public enum RenderOrder
 {
+  /// <summary>
+  /// Right-down render order. Starts at top-left and proceeds right then down.
+  /// </summary>
   RightDown,
+
+  /// <summary>
+  /// Right-up render order. Starts at bottom-left and proceeds right then up.
+  /// </summary>
   RightUp,
+
+  /// <summary>
+  /// Left-down render order. Starts at top-right and proceeds left then down.
+  /// </summary>
   LeftDown,
+
+  /// <summary>
+  /// Left-up render order. Starts at bottom-right and proceeds left then up.
+  /// </summary>
   LeftUp
 }
 
+/// <summary>
+/// Stagger axis enumeration. For staggered and hexagonal maps, determines which axis (X or Y) is staggered.
+/// </summary>
 public enum StaggerAxis
 {
+  /// <summary>
+  /// X stagger axis.
+  /// </summary>
   X,
+
+  /// <summary>
+  /// Y stagger axis.
+  /// </summary>
   Y
 }
 
+/// <summary>
+/// Stagger index enumeration. For staggered and hexagonal maps, determines whether the "even" or "odd" indexes along the staggered axis are shifted.
+/// </summary>
 public enum StaggerIndex
 {
+  /// <summary>
+  /// Even stagger index.
+  /// </summary>
   Odd,
+
+  /// <summary>
+  /// Odd stagger index.
+  /// </summary>
   Even
 }
 
+/// <summary>
+/// Represents a Tiled map.
+/// </summary>
 public class Map
 {
-  // Attributes
+  /// <summary>
+  /// The TMX format version. Is incremented to match minor Tiled releases.
+  /// </summary>
   public required string Version { get; set; }
+
+  /// <summary>
+  /// The Tiled version used to save the file.
+  /// </summary>
   public required string TiledVersion { get; set; }
+
+  /// <summary>
+  /// The class of this map.
+  /// </summary>
   public string Class { get; set; } = "";
+
+  /// <summary>
+  /// Map orientation.
+  /// </summary>
   public required MapOrientation Orientation { get; set; }
+
+  /// <summary>
+  /// The order in which tiles on tile layers are rendered.
+  /// </summary>
   public RenderOrder RenderOrder { get; set; } = RenderOrder.RightDown;
+
+  /// <summary>
+  /// The compression level to use for tile layer data (defaults to -1, which means to use the algorithm default).
+  /// Typically only useful for parsing, but may be interesting for certain use cases.
+  /// </summary>
   public int CompressionLevel { get; set; } = -1;
+
+  /// <summary>
+  /// The width of the map in tiles.
+  /// </summary>
   public required uint Width { get; set; }
+
+  /// <summary>
+  /// The height of the map in tiles.
+  /// </summary>
   public required uint Height { get; set; }
+
+  /// <summary>
+  /// The width of a tile.
+  /// </summary>
   public required uint TileWidth { get; set; }
+
+  /// <summary>
+  /// The height of a tile.
+  /// </summary>
   public required uint TileHeight { get; set; }
+
+  /// <summary>
+  /// Only for hexagonal maps. Determines the width or height (depending on the staggered axis) of the tile's edge, in pixels.
+  /// </summary>
   public uint? HexSideLength { get; set; }
+
+  /// <summary>
+  /// For staggered and hexagonal maps, determines which axis (X or Y) is staggered.
+  /// </summary>
   public StaggerAxis? StaggerAxis { get; set; }
+
+  /// <summary>
+  /// For staggered and hexagonal maps, determines whether the "even" or "odd" indexes along the staggered axis are shifted.
+  /// </summary>
   public StaggerIndex? StaggerIndex { get; set; }
+
+  /// <summary>
+  /// X coordinate of the parallax origin in pixels.
+  /// </summary>
   public float ParallaxOriginX { get; set; } = 0.0f;
+
+  /// <summary>
+  /// Y coordinate of the parallax origin in pixels.
+  /// </summary>
   public float ParallaxOriginY { get; set; } = 0.0f;
+
+  /// <summary>
+  /// The background color of the map.
+  /// </summary>
   public Color BackgroundColor { get; set; } = Color.Parse("#00000000", CultureInfo.InvariantCulture);
+
+  /// <summary>
+  /// Stores the next available ID for new layers. This number is used to prevent reuse of the same ID after layers have been removed.
+  /// </summary>
   public required uint NextLayerID { get; set; }
+
+  /// <summary>
+  /// Stores the next available ID for new objects. This number is used to prevent reuse of the same ID after objects have been removed.
+  /// </summary>
   public required uint NextObjectID { get; set; }
+
+  /// <summary>
+  /// Whether this map is infinite. An infinite map has no fixed size and can grow in all directions. Its layer data is stored in chunks.
+  /// </summary>
   public bool Infinite { get; set; } = false;
 
-  // At most one of
+  /// <summary>
+  /// Map properties.
+  /// </summary>
   public Dictionary<string, IProperty>? Properties { get; set; }
 
-  // Any number of
+  /// <summary>
+  /// List of tilesets used by the map.
+  /// </summary>
   public List<Tileset> Tilesets { get; set; } = [];
+
+  /// <summary>
+  /// Hierarchical list of layers. <see cref="Group"/> is a layer type which can contain sub-layers to create a hierarchy.
+  /// </summary>
   public List<BaseLayer> Layers { get; set; } = [];
 }

src/DotTiled/Model/Properties/BoolProperty.cs

@@ -1,4 +1,4 @@
-namespace DotTiled.Model.Properties;
+namespace DotTiled.Model;
 
 public class BoolProperty : IProperty
 {

src/DotTiled/Model/Properties/ClassProperty.cs

@@ -1,7 +1,7 @@
 using System.Collections.Generic;
 using System.Linq;
 
-namespace DotTiled.Model.Properties;
+namespace DotTiled.Model;
 
 public class ClassProperty : IProperty
 {

src/DotTiled/Model/Properties/ColorProperty.cs

@@ -1,4 +1,4 @@
-namespace DotTiled.Model.Properties;
+namespace DotTiled.Model;
 
 public class ColorProperty : IProperty
 {

src/DotTiled/Model/Properties/CustomTypes/CustomClassDefinition.cs

@@ -1,7 +1,7 @@
 using System;
 using System.Collections.Generic;
 
-namespace DotTiled.Model.Properties.CustomTypes;
+namespace DotTiled.Model;
 
 [Flags]
 public enum CustomClassUseAs

src/DotTiled/Model/Properties/CustomTypes/CustomEnumDefinition.cs

@@ -1,6 +1,6 @@
 using System.Collections.Generic;
 
-namespace DotTiled.Model.Properties.CustomTypes;
+namespace DotTiled.Model;
 
 public enum CustomEnumStorageType
 {

src/DotTiled/Model/Properties/CustomTypes/CustomTypeDefinition.cs

@@ -1,4 +1,4 @@
-namespace DotTiled.Model.Properties.CustomTypes;
+namespace DotTiled.Model;
 
 public abstract class CustomTypeDefinition
 {

src/DotTiled/Model/Properties/FileProperty.cs

@@ -1,4 +1,4 @@
-namespace DotTiled.Model.Properties;
+namespace DotTiled.Model;
 
 public class FileProperty : IProperty
 {

src/DotTiled/Model/Properties/FloatProperty.cs

@@ -1,4 +1,4 @@
-namespace DotTiled.Model.Properties;
+namespace DotTiled.Model;
 
 public class FloatProperty : IProperty
 {

src/DotTiled/Model/Properties/IProperty.cs

@@ -1,4 +1,4 @@
-namespace DotTiled.Model.Properties;
+namespace DotTiled.Model;
 
 public interface IProperty
 {

src/DotTiled/Model/Properties/IntProperty.cs

@@ -1,4 +1,4 @@
-namespace DotTiled.Model.Properties;
+namespace DotTiled.Model;
 
 public class IntProperty : IProperty
 {

src/DotTiled/Model/Properties/ObjectProperty.cs

@@ -1,4 +1,4 @@
-namespace DotTiled.Model.Properties;
+namespace DotTiled.Model;
 
 public class ObjectProperty : IProperty
 {

src/DotTiled/Model/Properties/PropertyType.cs

@@ -1,4 +1,4 @@
-namespace DotTiled.Model.Properties;
+namespace DotTiled.Model;
 
 public enum PropertyType
 {

src/DotTiled/Model/Properties/StringProperty.cs

@@ -1,4 +1,4 @@
-namespace DotTiled.Model.Properties;
+namespace DotTiled.Model;
 
 public class StringProperty : IProperty
 {

src/DotTiled/Model/Template.cs

@@ -1,11 +1,17 @@
-using DotTiled.Model.Layers.Objects;
-using DotTiled.Model.Tilesets;
-
 namespace DotTiled.Model;
 
+/// <summary>
+/// Represents a Tiled template. A template is a reusable object that can be placed in an <see cref="DotTiled.Model"/> inside the Tiled editor.
+/// </summary>
 public class Template
 {
-  // At most one of (if the template is a tile object)
+  /// <summary>
+  /// If the template represents a tile object, this property will contain the tileset that the tile belongs to.
+  /// </summary>
   public Tileset? Tileset { get; set; }
+
+  /// <summary>
+  /// The object that this template represents.
+  /// </summary>
   public required Object Object { get; set; }
 }

src/DotTiled/Model/Tilesets/Frame.cs

@@ -1,4 +1,4 @@
-namespace DotTiled.Model.Tilesets;
+namespace DotTiled.Model;
 
 public class Frame
 {

src/DotTiled/Model/Tilesets/Grid.cs

@@ -1,4 +1,4 @@
-namespace DotTiled.Model.Tilesets;
+namespace DotTiled.Model;
 
 public enum GridOrientation
 {

src/DotTiled/Model/Tilesets/Image.cs

@@ -1,4 +1,4 @@
-namespace DotTiled.Model.Tilesets;
+namespace DotTiled.Model;
 
 public enum ImageFormat
 {

src/DotTiled/Model/Tilesets/Tile.cs

@@ -1,8 +1,6 @@
 using System.Collections.Generic;
-using DotTiled.Model.Layers;
-using DotTiled.Model.Properties;
 
-namespace DotTiled.Model.Tilesets;
+namespace DotTiled.Model;
 
 public class Tile
 {

src/DotTiled/Model/Tilesets/TileOffset.cs

@@ -1,4 +1,4 @@
-namespace DotTiled.Model.Tilesets;
+namespace DotTiled.Model;
 
 public class TileOffset
 {

src/DotTiled/Model/Tilesets/Tileset.cs

@@ -1,7 +1,6 @@
 using System.Collections.Generic;
-using DotTiled.Model.Properties;
 
-namespace DotTiled.Model.Tilesets;
+namespace DotTiled.Model;
 
 public enum ObjectAlignment
 {

src/DotTiled/Model/Tilesets/Transformations.cs

@@ -1,4 +1,4 @@
-namespace DotTiled.Model.Tilesets;
+namespace DotTiled.Model;
 
 public class Transformations
 {

src/DotTiled/Model/Tilesets/WangColor.cs

@@ -1,7 +1,6 @@
 using System.Collections.Generic;
-using DotTiled.Model.Properties;
 
-namespace DotTiled.Model.Tilesets;
+namespace DotTiled.Model;
 
 public class WangColor
 {

src/DotTiled/Model/Tilesets/WangTile.cs

@@ -1,4 +1,4 @@
-namespace DotTiled.Model.Tilesets;
+namespace DotTiled.Model;
 
 public class WangTile
 {

src/DotTiled/Model/Tilesets/Wangset.cs

@@ -1,7 +1,6 @@
 using System.Collections.Generic;
-using DotTiled.Model.Properties;
 
-namespace DotTiled.Model.Tilesets;
+namespace DotTiled.Model;
 
 public class Wangset
 {

src/DotTiled/Serialization/Helpers.cs

@@ -3,9 +3,9 @@ using System.Collections.Generic;
 using System.IO;
 using System.IO.Compression;
 using System.Linq;
-using DotTiled.Model.Layers;
-using DotTiled.Model.Properties;
-using DotTiled.Model.Tilesets;
+using DotTiled.Model;
+using DotTiled.Model;
+using DotTiled.Model;
 
 namespace DotTiled.Serialization;
 

src/DotTiled/Serialization/ITilesetReader.cs

@@ -1,5 +1,5 @@
 using System;
-using DotTiled.Model.Tilesets;
+using DotTiled.Model;
 
 namespace DotTiled.Serialization;
 

src/DotTiled/Serialization/Tmj/TjTemplateReader.cs

@@ -1,8 +1,6 @@
 using System;
 using System.Collections.Generic;
 using DotTiled.Model;
-using DotTiled.Model.Properties.CustomTypes;
-using DotTiled.Model.Tilesets;
 
 namespace DotTiled.Serialization.Tmj;
 

src/DotTiled/Serialization/Tmj/Tmj.Data.cs

@@ -5,7 +5,7 @@ using System.IO;
 using System.IO.Compression;
 using System.Linq;
 using System.Text.Json;
-using DotTiled.Model.Layers;
+using DotTiled.Model;
 
 namespace DotTiled.Serialization.Tmj;
 

src/DotTiled/Serialization/Tmj/Tmj.Group.cs

@@ -4,9 +4,6 @@ using System.Globalization;
 using System.Numerics;
 using System.Text.Json;
 using DotTiled.Model;
-using DotTiled.Model.Layers;
-using DotTiled.Model.Properties;
-using DotTiled.Model.Properties.CustomTypes;
 
 namespace DotTiled.Serialization.Tmj;
 

src/DotTiled/Serialization/Tmj/Tmj.ImageLayer.cs

@@ -4,10 +4,7 @@ using System.Globalization;
 using System.Numerics;
 using System.Text.Json;
 using DotTiled.Model;
-using DotTiled.Model.Layers;
-using DotTiled.Model.Properties;
-using DotTiled.Model.Properties.CustomTypes;
-using DotTiled.Model.Tilesets;
+using DotTiled.Model;
 
 namespace DotTiled.Serialization.Tmj;
 

src/DotTiled/Serialization/Tmj/Tmj.Layer.cs

@@ -4,8 +4,6 @@ using System.Globalization;
 using System.Numerics;
 using System.Text.Json;
 using DotTiled.Model;
-using DotTiled.Model.Layers;
-using DotTiled.Model.Properties.CustomTypes;
 
 namespace DotTiled.Serialization.Tmj;
 

src/DotTiled/Serialization/Tmj/Tmj.Map.cs

@@ -5,10 +5,6 @@ using System.IO;
 using System.Linq;
 using System.Text.Json;
 using DotTiled.Model;
-using DotTiled.Model.Layers;
-using DotTiled.Model.Properties;
-using DotTiled.Model.Properties.CustomTypes;
-using DotTiled.Model.Tilesets;
 
 namespace DotTiled.Serialization.Tmj;
 

src/DotTiled/Serialization/Tmj/Tmj.ObjectLayer.cs

@@ -4,10 +4,6 @@ using System.Globalization;
 using System.Numerics;
 using System.Text.Json;
 using DotTiled.Model;
-using DotTiled.Model.Layers;
-using DotTiled.Model.Layers.Objects;
-using DotTiled.Model.Properties;
-using DotTiled.Model.Properties.CustomTypes;
 
 namespace DotTiled.Serialization.Tmj;
 

src/DotTiled/Serialization/Tmj/Tmj.Properties.cs

@@ -4,8 +4,6 @@ using System.IO;
 using System.Linq;
 using System.Text.Json;
 using DotTiled.Model;
-using DotTiled.Model.Properties;
-using DotTiled.Model.Properties.CustomTypes;
 
 namespace DotTiled.Serialization.Tmj;
 

src/DotTiled/Serialization/Tmj/Tmj.Template.cs

@@ -4,8 +4,6 @@ using System.Globalization;
 using System.Numerics;
 using System.Text.Json;
 using DotTiled.Model;
-using DotTiled.Model.Properties.CustomTypes;
-using DotTiled.Model.Tilesets;
 
 namespace DotTiled.Serialization.Tmj;
 

src/DotTiled/Serialization/Tmj/Tmj.TileLayer.cs

@@ -4,9 +4,6 @@ using System.Globalization;
 using System.Numerics;
 using System.Text.Json;
 using DotTiled.Model;
-using DotTiled.Model.Layers;
-using DotTiled.Model.Properties;
-using DotTiled.Model.Properties.CustomTypes;
 
 namespace DotTiled.Serialization.Tmj;
 

src/DotTiled/Serialization/Tmj/Tmj.Tileset.cs

@@ -6,10 +6,6 @@ using System.IO.Compression;
 using System.Linq;
 using System.Text.Json;
 using DotTiled.Model;
-using DotTiled.Model.Layers;
-using DotTiled.Model.Properties;
-using DotTiled.Model.Properties.CustomTypes;
-using DotTiled.Model.Tilesets;
 
 namespace DotTiled.Serialization.Tmj;
 

src/DotTiled/Serialization/Tmj/TmjMapReader.cs

@@ -4,8 +4,6 @@ using System.IO;
 using System.Text;
 using System.Text.Json;
 using DotTiled.Model;
-using DotTiled.Model.Properties.CustomTypes;
-using DotTiled.Model.Tilesets;
 
 namespace DotTiled.Serialization.Tmj;
 

src/DotTiled/Serialization/Tmj/TsjTilesetReader.cs

@@ -1,8 +1,6 @@
 using System;
 using System.Collections.Generic;
 using DotTiled.Model;
-using DotTiled.Model.Properties.CustomTypes;
-using DotTiled.Model.Tilesets;
 
 namespace DotTiled.Serialization.Tmj;
 

src/DotTiled/Serialization/Tmx/Tmx.Chunk.cs

@@ -1,5 +1,5 @@
 using System.Xml;
-using DotTiled.Model.Layers;
+using DotTiled.Model;
 
 namespace DotTiled.Serialization.Tmx;
 

src/DotTiled/Serialization/Tmx/Tmx.Data.cs

@@ -4,7 +4,7 @@ using System.IO;
 using System.IO.Compression;
 using System.Linq;
 using System.Xml;
-using DotTiled.Model.Layers;
+using DotTiled.Model;
 
 namespace DotTiled.Serialization.Tmx;
 

src/DotTiled/Serialization/Tmx/Tmx.Map.cs

@@ -4,10 +4,6 @@ using System.Globalization;
 using System.Linq;
 using System.Xml;
 using DotTiled.Model;
-using DotTiled.Model.Layers;
-using DotTiled.Model.Properties;
-using DotTiled.Model.Properties.CustomTypes;
-using DotTiled.Model.Tilesets;
 
 namespace DotTiled.Serialization.Tmx;
 

src/DotTiled/Serialization/Tmx/Tmx.ObjectLayer.cs

@@ -5,11 +5,6 @@ using System.Linq;
 using System.Numerics;
 using System.Xml;
 using DotTiled.Model;
-using DotTiled.Model.Layers;
-using DotTiled.Model.Layers.Objects;
-using DotTiled.Model.Properties;
-using DotTiled.Model.Properties.CustomTypes;
-using DotTiled.Model.Tilesets;
 
 namespace DotTiled.Serialization.Tmx;
 

src/DotTiled/Serialization/Tmx/Tmx.Properties.cs

@@ -2,8 +2,6 @@ using System.Collections.Generic;
 using System.Linq;
 using System.Xml;
 using DotTiled.Model;
-using DotTiled.Model.Properties;
-using DotTiled.Model.Properties.CustomTypes;
 
 namespace DotTiled.Serialization.Tmx;
 

src/DotTiled/Serialization/Tmx/Tmx.TileLayer.cs

@@ -3,10 +3,6 @@ using System.Collections.Generic;
 using System.Linq;
 using System.Xml;
 using DotTiled.Model;
-using DotTiled.Model.Layers;
-using DotTiled.Model.Properties;
-using DotTiled.Model.Properties.CustomTypes;
-using DotTiled.Model.Tilesets;
 
 namespace DotTiled.Serialization.Tmx;
 

src/DotTiled/Serialization/Tmx/Tmx.Tileset.cs

@@ -4,10 +4,6 @@ using System.IO;
 using System.Linq;
 using System.Xml;
 using DotTiled.Model;
-using DotTiled.Model.Layers;
-using DotTiled.Model.Properties;
-using DotTiled.Model.Properties.CustomTypes;
-using DotTiled.Model.Tilesets;
 
 namespace DotTiled.Serialization.Tmx;
 

src/DotTiled/Serialization/Tmx/TmxMapReader.cs

@@ -2,8 +2,6 @@ using System;
 using System.Collections.Generic;
 using System.Xml;
 using DotTiled.Model;
-using DotTiled.Model.Properties.CustomTypes;
-using DotTiled.Model.Tilesets;
 
 namespace DotTiled.Serialization.Tmx;
 

src/DotTiled/Serialization/Tmx/TsxTilesetReader.cs

@@ -2,8 +2,6 @@ using System;
 using System.Collections.Generic;
 using System.Xml;
 using DotTiled.Model;
-using DotTiled.Model.Properties.CustomTypes;
-using DotTiled.Model.Tilesets;
 
 namespace DotTiled.Serialization.Tmx;
 

src/DotTiled/Serialization/Tmx/TxTemplateReader.cs

@@ -2,8 +2,6 @@ using System;
 using System.Collections.Generic;
 using System.Xml;
 using DotTiled.Model;
-using DotTiled.Model.Properties.CustomTypes;
-using DotTiled.Model.Tilesets;
 
 namespace DotTiled.Serialization.Tmx;