initial

2026-04-15 23:10:35 +02:00
commit 9f70a7ed7b
15 changed files with 817 additions and 0 deletions
--- a/README.md
+++ b/README.md
@@ -0,0 +1,121 @@
+<p align="center"><img src=".gitea/readme/icon.png"/></p>
+
+<h1 align="center">MSEssentials.UI.Common.Converters</h1>
+
+<h3 align="center"><b>Set of helpers, class extensions, UI controls used in my other C# projects</b></h3>
+
+<p align="center">MSEssentials is package of useful classes, helpers, extensions and UI controls, I use in my C# projects. UI.Common.Converters subpackage contains base classes for UI framework-specific XAML converters.</p>
+
+---
+
+## Informations
+
+> [!Important]
+> **For Github users:**
+>
+> This is only mirror repository. All changes are first uploaded to the repository <a href="https://repos.mateuszskoczek.com/MSEssentials/MSEssentials.UI.Common.Converters">here</a>. Releases are also published on original repository. However, Github repository handles issues and pull requests for better accessibility.
+
+## NuGet registry status
+
+<table>
+    <tr>
+        <th>
+            Subpackage
+        </th>
+        <th>
+            Status
+        </th>
+    </tr>
+    <tr>
+        <td>
+            <b>MSEssentials.UI.Common.Converters</b>
+        </td>
+        <td>
+            <a href="https://www.nuget.org/packages/MSEssentials.UI.Common.Converters/"><img src="https://img.shields.io/nuget/v/MSEssentials.UI.Common.Converters.svg?style=flat-square"></a>
+        </td>
+    </tr>
+    <tr>
+        <th colspan=2>
+            Other subpackages
+        </th>
+    </tr>
+    <tr>
+        <td>
+            MSEssentials.Extensions
+        </td>
+        <td>
+            <a href="https://www.nuget.org/packages/MSEssentials.Extensions/"><img src="https://img.shields.io/nuget/v/MSEssentials.Extensions.svg?style=flat-square"></a>
+        </td>
+    </tr>
+    <tr>
+        <td>
+            MSEssentials.AspNetCore.Attributes
+        </td>
+        <td>
+            <a href="https://www.nuget.org/packages/MSEssentials.AspNetCore.Attributes/"><img src="https://img.shields.io/nuget/v/MSEssentials.AspNetCore.Attributes.svg?style=flat-square"></a>
+        </td>
+    </tr>
+    <tr>
+        <td>
+            MSEssentials.UI.Common.MVVM
+        </td>
+        <td>
+            <a href="https://www.nuget.org/packages/MSEssentials.UI.Common.MVVM/"><img src="https://img.shields.io/nuget/v/MSEssentials.UI.Common.MVVM.svg?style=flat-square"></a>
+        </td>
+    </tr>
+    <tr>
+        <td>
+            MSEssentials.UI.WinUI.Behaviors
+        </td>
+        <td>
+            <a href="https://www.nuget.org/packages/MSEssentials.UI.WinUI.Behaviors/"><img src="https://img.shields.io/nuget/v/MSEssentials.UI.WinUI.Behaviors.svg?style=flat-square"></a>
+        </td>
+    </tr>
+    <tr>
+        <td>
+            MSEssentials.UI.WinUI.Converters
+        </td>
+        <td>
+            <a href="https://www.nuget.org/packages/MSEssentials.UI.WinUI.Converters/"><img src="https://img.shields.io/nuget/v/MSEssentials.UI.WinUI.Converters.svg?style=flat-square"></a>
+        </td>
+    </tr>
+    <tr>
+        <td>
+            MSEssentials.UI.WinUI.Controls
+        </td>
+        <td>
+            <a href="https://www.nuget.org/packages/MSEssentials.UI.WinUI.Controls/"><img src="https://img.shields.io/nuget/v/MSEssentials.UI.WinUI.Controls.svg?style=flat-square"></a>
+        </td>
+    </tr>
+</table>
+
+## Features
+
+- **ObjectToIntConverter** - converts any object to int (and back, created mainly for enums)
+- **ObjectToStringConverter** - converts any object to string (created mainly for enums)
+
+## Installation and usage
+
+You can download package from official NuGet registry or .nupkg file itself from Releases tab.
+
+**CLI:**
+
+```
+dotnet add package MSEssentials.UI.Common.Converters
+```
+
+**Package reference in .csproj file:**
+
+```
+<PackageReference Include="MSEssentials.UI.Common.Converters" Version="<version>" />
+```
+
+## Attribution and contribution
+
+This project is open source on MIT License, so you can just copy and upload again to your repository. But according to the license, you must include information about the original author. You can find license <a href="https://repos.mateuszskoczek.com/MSEssentials/MSEssentials.UI.Common.Converters/src/branch/main/LICENSE">here</a>.
+
+However, the preferred way to contribute would be to propose improvements in a pull request, through issues, or through other means of communication.
+
+**Other sources:**
+
+- Icon by <a href="icons8.com">Icons8</a>