Release 2024.0.11

.github/workflows/Nuke.yml

@@ -9,8 +9,8 @@ jobs:
     runs-on: windows-2022
     steps:
       - name: Checkout
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         with:
           fetch-depth: 0
       - name: Run Nuke Build
-        run: ./.nuke/build.cmd --GitHubToken ${{ secrets.GITHUB_TOKEN }}
+        run: ./.nuke/build.cmd PublishGitHub --GitHubToken ${{ secrets.GITHUB_TOKEN }}

.github/workflows/Qodana.yml

@@ -14,13 +14,14 @@ jobs:
       pull-requests: write
       checks: write
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
         with:
           ref: ${{ github.event.pull_request.head.sha }}
           fetch-depth: 0
       - name: 'Qodana Scan'
-        uses: JetBrains/qodana-action@v2023.2
+        uses: JetBrains/qodana-action@main
         with:
-          args: --linter,jetbrains/qodana-dotnet:2023.3-eap
+          pr-mode: false
+          github-token: ${{ secrets.GITHUB_TOKEN }}
         env:
-          QODANA_TOKEN: ${{ secrets.QODANA_TOKEN }}
+          QODANA_TOKEN: ${{ secrets.QODANA_TOKEN }}

.nuke/build.ps1

@@ -13,7 +13,7 @@ Set-StrictMode -Version 2.0; $ErrorActionPreference = "Stop"; $ConfirmPreference
 ###########################################################################
 
 $SolutionDirectory = Split-Path $PSScriptRoot -Parent
-$BuildProjectFile = "$SolutionDirectory\Build\Build.csproj"
+$BuildProjectFile = "$SolutionDirectory\build\Build.csproj"
 $TempDirectory = "$SolutionDirectory\.nuke\temp"
 
 $DotNetGlobalFile = "$SolutionDirectory\global.json"

Changelog.md

@@ -1,5 +1,53 @@
 # Changelog
 
+# 2023-12-25 **2024.0.11**
+
+In this release RevitLookup welcomes you with improved visuals, support for templates to fine-tune data display, improved navigation, in-depth color support, let's take a look
+
+## General
+
+- **Navigation**. Updated navigation allows `Ctrl + Click` in the tree or grid to open any selected item or group of items in a new tab. 
+    This also allows you to analyze items that RevitLookup doesn't support, how about looking at StackTrace for exceptions 
+    ![изображение](https://github.com/jeremytammik/RevitLookup/assets/20504884/0c13c6da-772f-453b-9d34-bff609c04d95)
+
+- **Color Preview**. Changes to the user interface give us the ability to customize the display of any type of data. 
+    And now you will be able to visually see how materials or ribbon looks like. 
+    `Autodesk.Revit.DB.Color` and `System.Windows.Media.Color` are supported
+    ![изображение](https://github.com/jeremytammik/RevitLookup/assets/20504884/3b736961-26fa-4a24-b916-bb7c4fddfda9)
+
+## Improvements
+
+- **Update available notification**. Updates are now checked automatically and an icon is now displayed in the navigation area if a new version is available
+
+    ![изображение](https://github.com/jeremytammik/RevitLookup/assets/20504884/b7ab5fd0-b927-4b9a-805c-91e45fbd9f14)
+
+- **Background effects** Available on windows 11 only.
+
+    Acrylic:
+
+    ![изображение](https://github.com/jeremytammik/RevitLookup/assets/20504884/259012f7-f19d-4779-8b17-4be96a404023)
+
+    Blur:
+
+    ![изображение](https://github.com/jeremytammik/RevitLookup/assets/20504884/e8046bf0-ae48-446e-94e3-e3fdc59898e4)
+
+    The visual representation of the background depends on your desktop image and current theme
+
+- **Color extensions** Convert color to other formats HEX, CMYK, etc. Color name identification, `en` and `ru` localizations available. 
+    `Autodesk.Revit.DB.Color` and `System.Windows.Media.Color` are supported
+    ![изображение](https://github.com/jeremytammik/RevitLookup/assets/20504884/668a9c5c-3239-4100-8829-63fc71c880fb)
+
+## Bugs
+
+- Fixed incorrect display when switching themes on windows 10 https://github.com/jeremytammik/RevitLookup/issues/194
+- Returned deleted notification when checking for updates
+
+## Misc
+
+- Updated developer's [guide](https://github.com/jeremytammik/RevitLookup/blob/dev/Contributing.md#styles).
+
+Here, I'm wrapping things up. Wishing everyone a splendid New Year and a joyous Christmas ahead. As always, yours truly @Nice3point 🎅
+
 # 2023-12-01 **2024.0.10**
 
 ## General

Contributing.md

@@ -22,8 +22,8 @@ The naming should be descriptive and direct, giving a clear idea of the function
 
 ## Prerequisites for Compiling RevitLookup
 
-- .Net 7 SDK or newer
-- Visual Studio 2022 / JetBrains Rider 2022.3 or newer
+- .Net 8 SDK or newer
+- Visual Studio 2022 / JetBrains Rider 2023.3 or newer
 
 ## Architecture
 
@@ -160,4 +160,45 @@ public sealed class ElementDescriptor : Descriptor, IDescriptorConnector
             .AddShortcut(bindableElement, ModifierKeys.Alt, Key.F7);
     }
 }
-```
+```
+
+## Styles
+
+The application UI is divided into templates, where each template can be customized for different types of data. 
+There are several different rules for customizing TreeView, DataGrid row, DataGrid cell and they are all located in the file `RevitLookup/Views/Pages/Abstraction/SnoopViewBase.Styles.cs`.
+
+Suggested methods search for a style/template by name:
+
+```C#
+public override DataTemplate SelectTemplate(object item, DependencyObject container)
+{
+    if (item is null) return null;
+
+    var descriptor = (Descriptor) item;
+    var presenter = (FrameworkElement) container;
+    var templateName = descriptor.Value.Descriptor switch
+    {
+        ColorDescriptor => "DataGridColorCellTemplate",
+        ColorMediaDescriptor => "DataGridColorCellTemplate",
+        _ => "DefaultLookupDataGridCellTemplate"
+    };
+
+    return (DataTemplate) presenter.FindResource(templateName);
+}
+```
+
+The templates themselves are located in the `RevitLookup/Views/Controls` folder. 
+For example, in the `RevitLookup/Views/Controls/DataGrid/DataGridCellTemplate.xaml` file there is a cell template that displays the text:
+
+```xaml
+<DataTemplate
+    x:Key="DefaultLookupDataGridCellTemplate">
+    <TextBlock
+        d:DataContext="{d:DesignInstance objects:Descriptor}"
+        Text="{Binding Value.Descriptor,
+            Converter={converters:CombinedDescriptorConverter},
+            Mode=OneTime}" />
+</DataTemplate>
+```
+
+References to additional files must be registered in `RevitLookup/Views/Resources/RevitLookup.Ui.xaml`.

RevitLookup.sln

@@ -3,12 +3,6 @@ Microsoft Visual Studio Solution File, Format Version 12.00
 # Visual Studio Version 16
 VisualStudioVersion = 16.0.31205.134
 MinimumVisualStudioVersion = 10.0.40219.1
-Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "RevitLookup", "RevitLookup\RevitLookup.csproj", "{05C77115-2277-4DFC-8F95-BE37E5F1130F}"
-EndProject
-Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Installer", "Installer\Installer.csproj", "{B3814652-9158-4056-A721-1A380DE74BAE}"
-EndProject
-Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Build", "Build\Build.csproj", "{64D9C223-D070-46CD-A635-04FD4E1BEC3C}"
-EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution Items", "{374DC381-78CC-4FC7-A566-EB8C71C6369F}"
 	ProjectSection(SolutionItems) = preProject
 		Readme.md = Readme.md
@@ -17,11 +11,17 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution
 		Build\Build.Configuration.cs = Build\Build.Configuration.cs
 	EndProjectSection
 EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "RevitLookup.UI", "RevitLookup.UI\RevitLookup.UI.csproj", "{CE5C104B-D76E-49DA-8BD6-BF472224AEC0}"
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Installer", "install\Installer.csproj", "{B3814652-9158-4056-A721-1A380DE74BAE}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Build", "build\Build.csproj", "{64D9C223-D070-46CD-A635-04FD4E1BEC3C}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "RevitLookup", "source\RevitLookup\RevitLookup.csproj", "{05C77115-2277-4DFC-8F95-BE37E5F1130F}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "RevitLookup.UI", "source\RevitLookup.UI\RevitLookup.UI.csproj", "{CE5C104B-D76E-49DA-8BD6-BF472224AEC0}"
 EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "RevitLookup.UI.Demo", "RevitLookup.UI.Demo\RevitLookup.UI.Demo.csproj", "{67B8906F-21B0-4CE3-82F7-8E608B9D53CA}"
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "RevitLookup.UI.Demo", "source\RevitLookup.UI.Demo\RevitLookup.UI.Demo.csproj", "{67B8906F-21B0-4CE3-82F7-8E608B9D53CA}"
 EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Benchmarks", "Benchmarks\Benchmarks.csproj", "{827646DF-D373-4D40-8F0B-1E9842E3CE9A}"
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Benchmarks", "source\Benchmarks\Benchmarks.csproj", "{827646DF-D373-4D40-8F0B-1E9842E3CE9A}"
 EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution

RevitLookup.sln.DotSettings

@@ -22,6 +22,7 @@ Software - Restricted Rights) and DFAR 252.227-7013(c)(1)(ii)
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Addin/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Addins/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=APIUI/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=CIEXYZ/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Comparers/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=DFAR/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=hwnd/@EntryIndexedValue">True</s:Boolean>