Merge remote-tracking branch 'origin/master'

# Conflicts:
#	src/Directory.Build.props

Author: a-gubskiy

src/Directory.Build.props

@@ -1,6 +1,7 @@
 <Project>
 
     <PropertyGroup>
+        <IsPackable>true</IsPackable>
         <GeneratePackageOnBuild>True</GeneratePackageOnBuild>
 
         <PackageReadmeFile>README.md</PackageReadmeFile>
@@ -10,10 +11,10 @@
         <Copyright>Andrew Gubskiy © 2025</Copyright>
         <Company>Ukrainian .NET Developer Community</Company>
 
-        <Version>10.5.5</Version>
-        <AssemblyVersion>10.5.5</AssemblyVersion>
-        <FileVersion>10.5.5</FileVersion>
-        <PackageVersion>10.5.5</PackageVersion>
+        <Version>10.5.8</Version>
+        <AssemblyVersion>10.5.8</AssemblyVersion>
+        <FileVersion>10.5.8</FileVersion>
+        <PackageVersion>10.5.8</PackageVersion>
 
         <RepositoryType>git</RepositoryType>
         <RepositoryUrl>https://github.com/dncuug/X.PagedList.git</RepositoryUrl>

src/X.PagedList.EF/PagedListExtensions.cs

@@ -11,7 +11,6 @@ namespace X.PagedList.EF;
 /// <summary>
 /// EntityFramework extension methods designed to simplify the creation of instances of <see cref="PagedList{T}"/>.
 /// </summary>
-[PublicAPI]
 public static class PagedListExtensions
 {
     /// <summary>

src/X.PagedList.EF/X.PagedList.EF.csproj

@@ -24,10 +24,6 @@
         <PackageReference Include="Microsoft.EntityFrameworkCore" Version="9.0.8" />
     </ItemGroup>
 
-    <ItemGroup>
-        <PackageReference Include="JetBrains.Annotations" Version="2025.2.0" PrivateAssets="all" />
-    </ItemGroup>
-
     <ItemGroup>
         <ProjectReference Include="..\X.PagedList\X.PagedList.csproj" />
     </ItemGroup>

src/X.PagedList.Mvc.Core/Fluent/HtmlPagerBuilder.cs

@@ -4,6 +4,13 @@
 
 namespace X.PagedList.Mvc.Core.Fluent;
 
+/// <summary>
+/// Fluent builder that configures and renders a pager for an <see cref="IPagedList"/> in ASP.NET Core MVC.
+/// </summary>
+/// <remarks>
+/// Uses <see cref="PagedListRenderOptions"/> to configure output and <see cref="IHtmlHelper"/> to render either
+/// the default pager or a custom partial view.
+/// </remarks>
 internal sealed class HtmlPagerBuilder : IHtmlPagerBuilder
 {
     private readonly IHtmlHelper _htmlHelper;
@@ -13,6 +20,11 @@ internal sealed class HtmlPagerBuilder : IHtmlPagerBuilder
     private PagedListRenderOptions _options;
     private string? _partialViewName;
 
+    /// <summary>
+    /// Initializes a new instance of the <see cref="HtmlPagerBuilder"/> class.
+    /// </summary>
+    /// <param name="htmlHelper">The <see cref="IHtmlHelper"/> used to render HTML.</param>
+    /// <param name="pagedList">The source <see cref="IPagedList"/> to paginate.</param>
     public HtmlPagerBuilder(IHtmlHelper htmlHelper, IPagedList pagedList)
     {
         _htmlHelper = htmlHelper;
@@ -21,132 +33,151 @@ public HtmlPagerBuilder(IHtmlHelper htmlHelper, IPagedList pagedList)
         _options = new PagedListRenderOptions();
     }
 
+    /// <inheritdoc />
     public IHtmlPagerBuilder Url(Func<int, string?> builder)
     {
         _generatePageUrl = builder;
 
         return this;
     }
 
+    /// <inheritdoc />
     public IHtmlPagerBuilder DisplayLinkToFirstPage(PagedListDisplayMode displayMode = PagedListDisplayMode.Always)
     {
         _options.DisplayLinkToFirstPage = displayMode;
 
         return this;
     }
 
+    /// <inheritdoc />
     public IHtmlPagerBuilder DisplayLinkToLastPage(PagedListDisplayMode displayMode = PagedListDisplayMode.Always)
     {
         _options.DisplayLinkToLastPage = displayMode;
 
         return this;
     }
 
+    /// <inheritdoc />
     public IHtmlPagerBuilder DisplayLinkToPreviousPage(PagedListDisplayMode displayMode = PagedListDisplayMode.Always)
     {
         _options.DisplayLinkToPreviousPage = displayMode;
 
         return this;
     }
 
+    /// <inheritdoc />
     public IHtmlPagerBuilder DisplayLinkToNextPage(PagedListDisplayMode displayMode = PagedListDisplayMode.Always)
     {
         _options.DisplayLinkToNextPage = displayMode;
 
         return this;
     }
 
+    /// <inheritdoc />
     public IHtmlPagerBuilder DisplayLinkToIndividualPages(bool displayMode = true)
     {
         _options.DisplayLinkToIndividualPages = displayMode;
 
         return this;
     }
 
+    /// <inheritdoc />
     public IHtmlPagerBuilder DisplayPageCountAndCurrentLocation(bool displayMode = true)
     {
         _options.DisplayPageCountAndCurrentLocation = displayMode;
 
         return this;
     }
 
+    /// <inheritdoc />
     public IHtmlPagerBuilder DisplayEllipsesWhenNotShowingAllPageNumbers(bool displayMode = true)
     {
         _options.DisplayEllipsesWhenNotShowingAllPageNumbers = displayMode;
 
         return this;
     }
 
+    /// <inheritdoc />
     public IHtmlPagerBuilder MaximumPageNumbersToDisplay(int pageNumbers)
     {
         _options.MaximumPageNumbersToDisplay = pageNumbers;
 
         return this;
     }
 
+    /// <inheritdoc />
     public IHtmlContent Classic()
     {
         _options = PagedListRenderOptions.Classic;
 
         return Build();
     }
 
+    /// <inheritdoc />
     public IHtmlContent ClassicPlusFirstAndLast()
     {
         _options = PagedListRenderOptions.ClassicPlusFirstAndLast;
 
         return Build();
     }
 
+    /// <inheritdoc />
     public IHtmlContent Minimal()
     {
         _options = PagedListRenderOptions.Minimal;
 
         return Build();
     }
 
+    /// <inheritdoc />
     public IHtmlContent MinimalWithPageCountText()
     {
         _options = PagedListRenderOptions.MinimalWithPageCountText;
 
         return Build();
     }
 
+    /// <inheritdoc />
     public IHtmlContent MinimalWithItemCountText()
     {
         _options = PagedListRenderOptions.MinimalWithItemCountText;
 
         return Build();
     }
 
+    /// <inheritdoc />
     public IHtmlContent PageNumbersOnly()
     {
         _options = PagedListRenderOptions.PageNumbersOnly;
 
         return Build();
     }
 
+    /// <inheritdoc />
     public IHtmlContent OnlyShowFivePagesAtATime()
     {
         _options = PagedListRenderOptions.OnlyShowFivePagesAtATime;
 
         return Build();
     }
 
+    /// <inheritdoc />
     public IHtmlPagerBuilder WithPartialView(string partialViewName)
     {
         _partialViewName = partialViewName;
 
         return this;
     }
 
+    /// <inheritdoc />
     public IHtmlContent Build(PagedListRenderOptions? options)
     {
         _options = options ?? _options;
 
         return Build();
     }
 
+    /// <inheritdoc />
     public IHtmlContent Build()
     {
         if (string.IsNullOrWhiteSpace(_partialViewName))
@@ -159,4 +190,4 @@ public IHtmlContent Build()
 
         return _htmlHelper.Partial(_partialViewName, _pagedList);
     }
-}
+}

src/X.PagedList.Mvc.Core/Fluent/HtmlPagerExtensions.cs

@@ -1,21 +1,41 @@
 using System.Linq;
-using JetBrains.Annotations;
 using Microsoft.AspNetCore.Html;
 using Microsoft.AspNetCore.Mvc.Rendering;
 using X.PagedList.Extensions;
 
 namespace X.PagedList.Mvc.Core.Fluent;
 
-[PublicAPI]
+/// <summary>
+/// Extension methods for generating pager markup for <c>X.PagedList</c> in ASP.NET Core MVC.
+/// </summary>
+/// <remarks>
+/// Provides a simple entry point to either build and render a pager immediately, or obtain a fluent builder
+/// (<see cref="IHtmlPagerBuilder"/>) to further configure the pager before rendering.
+/// </remarks>
 public static class HtmlPagerExtensions
 {
+    /// <summary>
+    /// Builds and returns an HTML pager for an empty paged list.
+    /// </summary>
+    /// <param name="htmlHelper">The HTML helper used to render the pager.</param>
+    /// <returns>An <see cref="IHtmlContent"/> containing the pager markup.</returns>
+    /// <remarks>
+    /// Useful when the current view model is not an <see cref="IPagedList"/> but a pager still needs to be rendered.
+    /// Internally constructs an empty paged list via <see cref="Enumerable.Empty{TResult}"/> and <c>ToPagedList()</c>.
+    /// </remarks>
     public static IHtmlContent Pager(this IHtmlHelper htmlHelper)
     {
         return new HtmlPagerBuilder(htmlHelper, Enumerable.Empty<object?>().ToPagedList()).Build();
     }
 
+    /// <summary>
+    /// Creates a fluent pager builder for the specified paged list.
+    /// </summary>
+    /// <param name="htmlHelper">The HTML helper used to configure and render the pager.</param>
+    /// <param name="list">The paged list providing paging metadata (page number, size, total item count).</param>
+    /// <returns>An <see cref="IHtmlPagerBuilder"/> that can be further configured and rendered.</returns>
     public static IHtmlPagerBuilder Pager(this IHtmlHelper htmlHelper, IPagedList list)
     {
         return new HtmlPagerBuilder(htmlHelper, list);
     }
-}
+}