Release: prepare v0.13.0

CHANGELOG.md

@@ -3,9 +3,9 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning v2.0.0](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased] (0.13.0)
+## [0.13.0] - 2023-01-27
 ### Changed
-- **(Breaking change.)** The library is now distributes in the form of two assemblies: `WpfMath` and `WpfMath.Shared` (as a future cross-platform core of the library).
+- **(Breaking change.)** The library is now distributed in the form of two assemblies: `WpfMath` and `WpfMath.Shared` (as a future cross-platform core of the library).
 
   Both of the assemblies are still distributed in the same NuGet package.
 
@@ -246,4 +246,5 @@ This was the initially published version. It consisted entirely of the original
 [0.10.0]: https://github.com/ForNeVeR/wpf-math/compare/0.9.0...v0.10.0
 [0.11.0]: https://github.com/ForNeVeR/wpf-math/compare/v0.10.0...v0.11.0
 [0.12.0]: https://github.com/ForNeVeR/wpf-math/compare/v0.11.0...v0.12.0
-[Unreleased]: https://github.com/ForNeVeR/wpf-math/compare/v0.12.0...HEAD
+[0.13.0]: https://github.com/ForNeVeR/wpf-math/compare/v0.12.0...v0.13.0
+[Unreleased]: https://github.com/ForNeVeR/wpf-math/compare/v0.13.0...HEAD

Directory.Build.props

@@ -1,9 +1,12 @@
 <Project>
 
+    <PropertyGroup Label="Versioning">
+        <Version>0.13.0</Version>
+    </PropertyGroup>
+
     <PropertyGroup Condition=" '$(MSBuildProjectExtension)' == '.csproj' ">
         <LangVersion>11</LangVersion>
         <Nullable Condition=" $([MSBuild]::IsTargetFrameworkCompatible('$(TargetFramework)', 'netstandard2.1')) ">enable</Nullable>
         <Nullable Condition=" '$(Nullable)' != 'enable' ">annotations</Nullable>
     </PropertyGroup>
-
 </Project>

MAINTAINERSHIP.md

@@ -8,7 +8,7 @@ Publish a New Version
 2. Update the copyright year in `src/WpfMath/WpfMath.csproj`, if required.
 3. Prepare a corresponding entry in [the changelog][changelog] (usually by renaming the "Unreleased" section).
 4. Copy-paste the said entry to the `<PackageReleaseNotes>` element of `src/WpfMath/WpfMath.csproj`.
-5. Set `<Version>` in `src/WpfMath/WpfMath.csproj`.
+5. Set `<Version>` in the `Directory.Build.props` file.
 6. Push a tag in form of `v<VERSION>`, e.g. `v0.0.1`. GitHub Actions will do the rest (push a NuGet package).
 
 Prepare NuGet Package Locally

src/WpfMath/WpfMath.csproj

@@ -8,18 +8,37 @@
     </PropertyGroup>
     <PropertyGroup>
         <PackageId>WpfMath</PackageId>
-        <Version>0.12.0</Version>
         <Title>WPF-Math</Title>
         <Authors>ForNeVeR</Authors>
         <PackageLicenseExpression>MIT</PackageLicenseExpression>
         <PackageProjectUrl>https://github.com/ForNeVeR/wpf-math</PackageProjectUrl>
         <RepositoryUrl>https://github.com/ForNeVeR/wpf-math.git</RepositoryUrl>
         <AssemblyTitle>WPF-Math</AssemblyTitle>
-        <PackageReleaseNotes>Added:
-- TeX's environment support with only one environment for now: `\begin{pmatrix}` (see [#329][pull-329]).
+        <PackageReleaseNotes>[Changed]
 
-Changed:
-- The project is now built on .NET 7 SDK and C# 11 (shouldn't change the supported framework set).
+- (Breaking change.) The library is now distributed in the form of two assemblies: WpfMath and WpfMath.Shared (as a future cross-platform core of the library).
+Both of the assemblies are still distributed in the same NuGet package.
+A lot of types were moved to WpfMath.Shared assembly (preserving their namespaces).
+- (Breaking change.) It is no longer recommended to create instances of TexEnvironment using the public constructor. Use WpfMath.Rendering.WpfTeXEnvironment::Create instead.
+- (Breaking change.) It is no longer recommended to create instances of TexFormulaParser using public constructors. Use WpfMath.Parsers.WpfTeXFormulaParser::Instance instead.
+- (Breaking change.) WPF-specific WpfMath.Rendering.IBrush has been replaced with WpfMath.Rendering.IBrush in most of the public interfaces. Use WpfMath.Rendering.WpfBrushExtensions to convert back and forth to the WPF type.
+- (Breaking change.) WpfMath.Rendering.IElementRenderer has been updated:
+- RenderGlyphRun has been replaced with RenderCharacter method (not reliant on any WPF-specific types),
+- RenderRectangle now receives an instance of a new WpfMath.Rendering.Rectangle type (decoupled from WPF).
+- WpfMath.TexRenderer is now obsolete. Consult the documentation on new recommended ways to perform custom rendering. There are new extension methods in two classes (WpfMath.Rendering.WpfTeXFormulaExtensions and WpfMath.Rendering.TeXFormulaExtensions) that are the main way to render formulae now.
+- (Breaking change.) WpfMath.TexFormnula::GetRenderer is gone. Create a TexRenderer using constructor (obsolete) or use the aforementioned extension methods instead.
+
+[Added]
+
+- WpfMath.CharInfo: a new public type to work with a font character. Use WpfMath.Fonts.WpfCharInfoEx::GetGlyphRun if you need to get a System.Windows.Media.GlyphRun from it.
+- WpfMath.Rendering.WpfTeXFormulaExtensions to render a WpfMath.TexFormula into a System.Windows.Media.Imaging.BitmapSource or System.Windows.Media.Geometry.
+- New classes for WPF-Math porting to platforms other than WPF (consult the WpfMath.Rendering.IElementRenderer interface and TexFormulaParser constructor parameters to know more).
+- WpfMath.Colors.RgbaColor as a new portable color representation.
+- WpfMath.Fonts.IFontProvider: implement this interface to provide alternate font reading functionality.
+- WpfMath.Fonts.ITeXFont: implement this interface to provide access to a platform-specific font resource.
+- WpfMath.Rendering.IBrushFactory: implement this interface to provide access to creation of platform-specific solid-colored brushes.
+- WpfMath.TeXFontMetrics that contains some measurements of a font glyph.
+- An utility Result struct is now public.
         </PackageReleaseNotes>
         <PackageTags>wpf;latex;formula</PackageTags>
         <Description>.NET library for rendering mathematical formulae using the LaTeX typsetting style, for the WPF framework.</Description>