Merge pull request #472 from Kurante2801/release

Add SetXWithoutNotify and SetYWithoutNotify to BoxSlider

.github/workflows/getpackageversionfrompackage.yml

@@ -0,0 +1,70 @@
+name: Get the Package version from a UPM Package.json file
+
+on:
+  workflow_call:
+    inputs:
+      build-host:
+        required: true
+        type: string
+      version-file-path:
+        description: 'Optional, specify a path to search for the upm package.json file. Use this if validation fails to find a valid package.json file.\n **Note, Version file MUST contain the attribute "Unity" with the full Unity version expected, e.g. "2020.2.3f1"'
+        type: string
+        required: false
+    outputs:
+      packageversion:
+        description: "Returns the version of the UPM package"
+        value: ${{ jobs.get_package_version.outputs.upmpackageversion }}
+
+jobs:
+  get_package_version:
+    name: Get required Package version from UPM Package
+    runs-on: ${{ inputs.build-host }}
+    outputs:
+      upmpackageversion: ${{ steps.getVersion.outputs.packageversion }}
+    steps:
+      - name: Script Version
+        run: |
+          echo "::group::Script Versioning"
+          $scriptVersion = "1.0.0"
+          echo "Build Script Version: $scriptVersion"
+          echo "::endgroup::"
+        shell: pwsh
+      - uses: actions/checkout@v3
+        with:
+          submodules: recursive
+          clean: true
+      - id: getVersion
+        name: 'Get Package Version Number'
+        run: |
+          echo "::group::Validating input"
+
+          $versionFile = "${{ inputs.version-file-path }}"
+          if([string]::IsNullOrEmpty($versionFile))
+          {
+            echo 'version input was empty, using default'
+            $versionFile = 'package.json'
+          }
+          echo 'Checking for project json at $versionFile'
+
+          if ( -not (Test-Path -Path $versionFile) ) {
+            Write-Error "Failed to find a valid package.json file"
+            exit 1
+          }
+
+          echo "::endgroup::"
+
+          echo "::group::Package Version UPM check"
+
+          $package_json = Get-Content -Path $versionFile | ConvertFrom-Json
+          $packageVersion = $package_json.version
+
+          if([string]::IsNullOrEmpty($packageVersion)) {
+            Write-Error "Project.json version number does not exist or is empty"
+            exit 1
+          }
+
+          echo "packageversion=$packageVersion" >> $env:GITHUB_OUTPUT
+
+          echo "Detected version is $packageVersion"
+          echo "::endgroup::"
+        shell: pwsh

.github/workflows/main-publish.yml

@@ -5,7 +5,7 @@ on:
     types:
       - closed
     branches:
-      - main
+      - release
 
 jobs:
   # Get Version to tag and release the branch, no up-version - [no-ver] included in PR title

CHANGELOG.md

@@ -4,17 +4,18 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](http://keepachangelog.com/).
 
-## Release 2.3 - Reanimation - 2023/02/07
+## Release 2.3.2 - Rejuvenation - 2023/11/26
 
-It has been a tough time for all since the last update, but things have been moving steadily along.  In the past few months there has been a concerted effort to revamp and update the project ready for Unity 2022, as well as migrating the source repository over to GitHub and refreshing all the things.
-We hope the new release is better for everyone and we have paid close attention to the editor menus and places to find all the controls for this release.
+2023 is certainly an interesting year to keep you on your toes, and finding time to keep managing all the requests and updates that come in are taking their toll, especially for a FREE project, but nonetheless, I still do it.
+
+Mainly bugfixes for the end of year update, promoting some resolutions that have been verified and tested since the last release.
 
 To get up to speed with the Unity UI Extensions, check out the [Getting Started](https://unity-ui-extensions.github.io/GettingStarted.html) Page.
 
 > Ways to get in touch:
 >
-> - [Gitter Chat](https://gitter.im/Unity-UI-Extensions/Lobby) site for the UI Extensions project
 > - [GitHub Discussions](https://github.com/Unity-UI-Extensions/com.unity.uiextensions/discussions), if you have any questions, queries or suggestions
+> - [Gitter Chat](https://gitter.im/Unity-UI-Extensions/Lobby) site for the UI Extensions project
 >
 > Much easier that posting a question / issue on YouTube, Twitter or Facebook :D
 
@@ -28,64 +29,23 @@ For more details, see the [deprecation notice](https://github.com/Unity-UI-Exten
 
 ## Added
 
-- Added new FIFO based UI Line Render when dynamic line rendering is needed.
-- Added ResetSelectableHighlight component.
-- Added SetArc method to UICircle as requested.
-- Added new UIHorizontalScroller based on UIVerticalScroller.
-- Added OnHighlightChanged and OnPressChanged events for UI Button.
-- Added error handling around setting Unity UI Components for Vertical/Horizontal ScrollSnaps.
-- Added Editor Menu Option to create a Min/Max slider.
-- Added the ability to set a specific item for combobox controls on start and not just the first.
-- Added the ability to disable the combo boxes and make them read-only.
+- Add CalculatePointOnCurve for uilinerenderer (@victornor)
 
 ## Changed
 
-- Refresh FancyScrollView with the latest fixes
-- All Text based components updated to use TextMeshPro from Unity 2022 **Breaking Change**
-
-- Clean-up and reset pivots on scene start.
-- Merged in feature/improved-ui-highlightable (pull request UILineRenderer - issues with specifying point locations at runtime #123).
-- Merged in fix/rangesliderfix (pull request HorizontalScrollSnap Mask Area doesn't work when content created dynamically #125).
-- Merged in fix/infinitescrollcontentsize (pull request Gradient initialization should be in Awake() #126).
-- Merged in feature/controlTouchUp (pull request UILineRenderer mesh not updating in Editor scene view #127).
-- Upgraded RangeSlider to work in both Horizontal and Vertical setups.
-- Merged in RangeSlider-upgrade. (pull request Newtonsoft.Json.dll conflict #131)
-- Updated UIVertical scroller to be 2022 compliant.
-- Updated Curly UI to wait until end of the frame to recalculate positions.
-- Updated Depth Texture sampler in UI Particles Shaders.
-- Updated Points to always be an array of 1 when set to nothing for the Line Renderer.
-- Updated Cooldown button to work with Keyboard input.
-- Removed unneeded size calculation which caused some issues with mixed content.
-- Resolved an issue whereby the last row in a flow layout group would not size correctly.
-- Updated all components using "LayoutGroup" to override their OnDisable.
-- Updated validation in the new MinMaxSlider.
-- Updated Editor create options to add the correct Event System Input manager.
-- Updated initialisation logic to not cause an endless loop in the TabNavigationHelper.
-- Updated "Action" use to "UnityAction" to avoid Unity issues for DropDowns.
-- Updated UIVerticalScroller for standards.
-- Updated ReorderableList/ReorderableListElement to prevent creating a fake object for non-transferable items.
-- Updated panel drawing for ComboBox controls and added DropdownOffset.
-- Updated build issue with ReorderableListElement.
-- Updated NonDrawingGraphic to require a CanvasRender, else it causes an error on run.
+- fix: Fixed an null reference exception with the ResetSelectableHighlight (@FejZa)
+- fix: Resolved an issue where the last line in a flow layout group would overflow the rect bounds.
+- fix: GetPosition when Segments is null (@victornor)
+- fix: Fix Bug! NicerOutline color.a Loss when m_UseGraphicAlpha is true (wanliyun)
+- fix: Update to force Enumerated start for Accordion elements, Resolves: #455
+- Added argument to the UpdateLayout method for the HSS/VSS to move to a new starting page.
+- Updated implementations to handle 2023 support, with 2023 moving in to public release.
+- Added extra event on the AutoCompleteComboBox, to fire when an item in the list is selected, with its display name.
+- FlowLayoutGroup components updated to latest (likely the last as the author has stopped development)
 
 ## Deprecated
 
-- Marked ScrollPositionController as Obsolete, users should use the new Scoller.
-- BestFitOutline - Deprecated in Unity 2020 onwards. (still available for earlier versions)
-- NicerOutline - Deprecated in Unity 2020 onwards. (still available for earlier versions)
-- Marked TileSizeFitter as obsolete as Unity has made this unworkable.
-
-## Fixed
-
-- Resolved issues with DisplayAbove and using a 0 ItemsToDisplay for ComboBox controls.
-- Resolved startup issue that prevented the control from being used (Unity changed the start order in some instances), this was causing null reference issues with comboboxes.
-- Patch fix for UILineRenderer.
-- Resolves issue where the lower range value would become stuck when moving.
-- Updated Infinite scroll to work with content of different sizes.
-- Updated Dropdown list to NOT resize text Rect on draw.
-- Revised the Curly UI fix as it was preventing the graphic from being updated in the scene view.
-- Cleanup and ensuring the UIParticleSystem is disposed in onDestroy correctly.
-- Clean up range slider unused variables.
+- All deprecated Text based components now have "obsolete" tags, to avoid breaking code.  Note, these do not function in 2022 and above, as Unity have "changed" things.  For any affected component, I recommend updating to use TextMeshPro native features.
 
 ## Additional Notes
 
@@ -98,6 +58,7 @@ New for 2020, we have added OpenUPM support and the package can be installed usi
 ```cli
 `openupm add com.unity.uiextensions`
 ```
+
 > For more details on using [OpenUPM CLI, check the docs here](https://github.com/openupm/openupm-cli#installation).
 
 - Unity Package Manager - manual

Documentation~/com.unity.uiextensions.md

@@ -42,17 +42,18 @@ This version of the Unity UI Extensions is compatible with the following version
 
 ## [Release Notes](https://unity-ui-extensions.github.io/ReleaseNotes/RELEASENOTES)
 
-## Release 2.3 - Reanimation - 2022/02/07
+## Release 2.3.2 - Rejuvenation - 2023/11/26
 
-It has been a tough time for all since the last update, but things have been moving steadily along.  In the past few months there has been a concerted effort to revamp and update the project ready for Unity 2022, as well as migrating the source repository over to GitHub and refreshing all the things.
-We hope the new release is better for everyone and we have paid close attention to the editor menus and places to find all the controls for this release.
+2023 is certainly an interesting year to keep you on your toes, and finding time to keep managing all the requests and updates that come in are taking their toll, especially for a FREE project, but nonetheless, I still do it.
+
+Mainly bugfixes for the end of year update, promoting some resolutions that have been verified and tested since the last release.
 
 To get up to speed with the Unity UI Extensions, check out the [Getting Started](https://unity-ui-extensions.github.io/GettingStarted.html) Page.
 
 > Ways to get in touch:
 >
-> - [Gitter Chat](https://gitter.im/Unity-UI-Extensions/Lobby) site for the UI Extensions project
 > - [GitHub Discussions](https://github.com/Unity-UI-Extensions/com.unity.uiextensions/discussions), if you have any questions, queries or suggestions
+> - [Gitter Chat](https://gitter.im/Unity-UI-Extensions/Lobby) site for the UI Extensions project
 >
 > Much easier that posting a question / issue on YouTube, Twitter or Facebook :D
 
@@ -66,64 +67,23 @@ For more details, see the [deprecation notice](https://github.com/Unity-UI-Exten
 
 ## Added
 
-- Added new FIFO based UI Line Render when dynamic line rendering is needed.
-- Added ResetSelectableHighlight component.
-- Added SetArc method to UICircle as requested.
-- Added new UIHorizontalScroller based on UIVerticalScroller.
-- Added OnHighlightChanged and OnPressChanged events for UI Button.
-- Added error handling around setting Unity UI Components for Vertical/Horizontal ScrollSnaps.
-- Added Editor Menu Option to create a Min/Max slider.
-- Added the ability to set a specific item for combobox controls on start and not just the first.
-- Added the ability to disable the combo boxes and make them read-only.
+- Add CalculatePointOnCurve for uilinerenderer (@victornor)
 
 ## Changed
 
-- Refresh FancyScrollView with the latest fixes
-- All Text based components updated to use TextMeshPro from Unity 2022 **Breaking Change**
-
-- Clean-up and reset pivots on scene start.
-- Merged in feature/improved-ui-highlightable (pull request UILineRenderer - issues with specifying point locations at runtime #123).
-- Merged in fix/ragesliderfix (pull request HorizontalScrollSnap Mask Area doesn't work when content created dynamically #125).
-- Merged in fix/infinitescrollcontentsize (pull request Gradient initialization should be in Awake() #126).
-- Merged in feature/controlTouchUp (pull request UILineRenderer mesh not updating in Editor scene view #127).
-- Upgraded RangeSlider to work in both Horizontal and Vertical setups.
-- Merged in RangeSlider-upgrade. (pull request Newtonsoft.Json.dll conflict #131)
-- Updated UIVertical scroller to be 2022 compliant.
-- Updated Curly UI to wait until end of the frame to recalculate positions.
-- Updated Depth Texture sampler in UI Particles Shaders.
-- Updated Points to always be an array of 1 when set to nothing for the Line Renderer.
-- Updated Cooldown button to work with Keyboard input.
-- Removed unneeded size calculation which caused some issues with mixed content.
-- Resolved an issue whereby the last row in a flow layout group would not size correctly.
-- Updated all components using "LayoutGroup" to override their OnDisable.
-- Updated validation in the new MinMaxSlider.
-- Updated Editor create options to add the correct Event System Input manager.
-- Updated initialisation logic to not cause an endless loop in the TabNavigationHelper.
-- Updated "Action" use to "UnityAction" to avoid Unity issues for DropDowns.
-- Updated UIVerticalScroller for standards.
-- Updated ReorderableList/ReorderableListElement to prevent creating a fake object for non-transferable items.
-- Updated panel drawing for ComboBox controls and added DropdownOffset.
-- Updated build issue with ReorderableListElement.
-- Updated NonDrawingGraphic to require a CanvasRender, else it causes an error on run.
+- fix: Fixed an null reference exception with the ResetSelectableHighlight (@FejZa)
+- fix: Resolved an issue where the last line in a flow layout group would overflow the rect bounds.
+- fix: GetPosition when Segments is null (@victornor)
+- fix: Fix Bug! NicerOutline color.a Loss when m_UseGraphicAlpha is true (wanliyun)
+- fix: Update to force Enumerated start for Accordion elements, Resolves: #455
+- Added argument to the UpdateLayout method for the HSS/VSS to move to a new starting page.
+- Updated implementations to handle 2023 support, with 2023 moving in to public release.
+- Added extra event on the AutoCompleteComboBox, to fire when an item in the list is selected, with its display name.
+- FlowLayoutGroup components updated to latest (likely the last as the author has stopped development)
 
 ## Deprecated
 
-- Marked ScrollPositionController as Obsolete, users should use the new Scoller.
-- BestFitOutline - Deprecated in Unity 2020 onwards. (still available for earlier versions)
-- NicerOutline - Deprecated in Unity 2020 onwards. (still available for earlier versions)
-- Marked TileSizeFitter as obsolete as Unity has made this unworkable.
-
-## Fixed
-
-- Resolved issues with DisplayAbove and using a 0 ItemsToDisplay for ComboBox controls.
-- Resolved startup issue that prevented the control from being used (Unity changed the start order in some instances), this was causing null reference issues with comboboxes.
-- Patch fix for UILineRenderer.
-- Resolves issue where the lower range value would become stuck when moving.
-- Updated Infinite scroll to work with content of different sizes.
-- Updated Dropdown list to NOT resize text Rect on draw.
-- Revised the Curly UI fix as it was preventing the graphic from being updated in the scene view.
-- Cleanup and ensuring the UIParticleSystem is disposed in onDestroy correctly.
-- Clean up range slider unused variables.
+- All deprecated Text based components now have "obsolete" tags, to avoid breaking code.  Note, these do not function in 2022 and above, as Unity have "changed" things.  For any affected component, I recommend updating to use TextMeshPro native features.
 
 - [UI Extensions Issue log](https://github.com/Unity-UI-Extensions/com.unity.uiextensions/issues)
 

Editor/uGUITools.cs

@@ -6,7 +6,7 @@ namespace UnityEngine.UI.Extensions
 {
     public static class uGUITools
     {
-        [MenuItem("uGUI/Anchors to Corners %[")]
+        [MenuItem("Tools/UnityUIExtensions/Anchors to Corners %[")]
         static void AnchorsToCorners()
         {
             if (Selection.transforms == null || Selection.transforms.Length == 0)
@@ -37,7 +37,7 @@ namespace UnityEngine.UI.Extensions
             Undo.CollapseUndoOperations(undoGroup);
         }
 
-        [MenuItem("uGUI/Corners to Anchors %]")]
+        [MenuItem("Tools/UnityUIExtensions/Corners to Anchors %]")]
         static void CornersToAnchors()
         {
             if (Selection.transforms == null || Selection.transforms.Length == 0)
@@ -60,13 +60,13 @@ namespace UnityEngine.UI.Extensions
             Undo.CollapseUndoOperations(undoGroup);
         }
 
-        [MenuItem("uGUI/Mirror Horizontally Around Anchors %;")]
+        [MenuItem("Tools/UnityUIExtensions/Mirror Horizontally Around Anchors %;")]
         static void MirrorHorizontallyAnchors()
         {
             MirrorHorizontally(false);
         }
 
-        [MenuItem("uGUI/Mirror Horizontally Around Parent Center %:")]
+        [MenuItem("Tools/UnityUIExtensions/Mirror Horizontally Around Parent Center %:")]
         static void MirrorHorizontallyParent()
         {
             MirrorHorizontally(true);
@@ -96,13 +96,13 @@ namespace UnityEngine.UI.Extensions
             }
         }
 
-        [MenuItem("uGUI/Mirror Vertically Around Anchors %'")]
+        [MenuItem("Tools/UnityUIExtensions/Mirror Vertically Around Anchors %'")]
         static void MirrorVerticallyAnchors()
         {
             MirrorVertically(false);
         }
 
-        [MenuItem("uGUI/Mirror Vertically Around Parent Center %\"")]
+        [MenuItem("Tools/UnityUIExtensions/Mirror Vertically Around Parent Center %\"")]
         static void MirrorVerticallyParent()
         {
             MirrorVertically(true);

Examples~

@@ -1 +1 @@
-Subproject commit 2b2dba57650838e285c3336b4a26847931462570
+Subproject commit 1cfaa42b3fcc454950009cc03a8280fd18e38197

README.md

@@ -4,6 +4,11 @@ This is an extension project for the new Unity UI system which can be found at:
 
 > [Check out the control demos on our Tumblr page](https://unityuiextensions.tumblr.com/)
 
+[![openupm](https://img.shields.io/npm/v/com.unity.uiextensions?label=openupm&registry_uri=https://package.openupm.com)](https://openupm.com/packages/com.unity.uiextensions/)
+[![Publish main branch and increment version](https://github.com/Unity-UI-Extensions/com.unity.uiextensions/actions/workflows/main-publish.yml/badge.svg)](https://github.com/Unity-UI-Extensions/com.unity.uiextensions/actions/workflows/main-publish.yml)
+[![Publish development branch on Merge](https://github.com/Unity-UI-Extensions/com.unity.uiextensions/actions/workflows/development-publish.yml/badge.svg)](https://github.com/Unity-UI-Extensions/com.unity.uiextensions/actions/workflows/development-publish.yml)
+[![Build and test UPM packages for platforms, all branches except main](https://github.com/Unity-UI-Extensions/com.unity.uiextensions/actions/workflows/development-buildandtestupmrelease.yml/badge.svg)](https://github.com/Unity-UI-Extensions/com.unity.uiextensions/actions/workflows/development-buildandtestupmrelease.yml)
+
 ## [Intro](https://unity-ui-extensions.github.io/GettingStarted)
 
 For more info, here's a little introduction video for the project:
@@ -69,17 +74,18 @@ To get started with the project, here's a little guide:
 
 ## [Updates:](https://unity-ui-extensions.github.io/ReleaseNotes/RELEASENOTES)
 
-## Release 2.3 - Reanimation - 2022/02/07
+## Release 2.3.2 - Rejuvenation - 2023/11/26
 
-It has been a tough time for all since the last update, but things have been moving steadily along.  In the past few months there has been a concerted effort to revamp and update the project ready for Unity 2022, as well as migrating the source repository over to GitHub and refreshing all the things.
-We hope the new release is better for everyone and we have paid close attention to the editor menus and places to find all the controls for this release.
+2023 is certainly an interesting year to keep you on your toes, and finding time to keep managing all the requests and updates that come in are taking their toll, especially for a FREE project, but nonetheless, I still do it.
+
+Mainly bugfixes for the end of year update, promoting some resolutions that have been verified and tested since the last release.
 
 To get up to speed with the Unity UI Extensions, check out the [Getting Started](https://unity-ui-extensions.github.io/GettingStarted.html) Page.
 
 > Ways to get in touch:
 >
-> - [Gitter Chat](https://gitter.im/Unity-UI-Extensions/Lobby) site for the UI Extensions project
 > - [GitHub Discussions](https://github.com/Unity-UI-Extensions/com.unity.uiextensions/discussions), if you have any questions, queries or suggestions
+> - [Gitter Chat](https://gitter.im/Unity-UI-Extensions/Lobby) site for the UI Extensions project
 >
 > Much easier that posting a question / issue on YouTube, Twitter or Facebook :D
 
@@ -93,66 +99,25 @@ For more details, see the [deprecation notice](https://github.com/Unity-UI-Exten
 
 ## Added
 
-- Added new FIFO based UI Line Render when dynamic line rendering is needed.
-- Added ResetSelectableHighlight component.
-- Added SetArc method to UICircle as requested.
-- Added new UIHorizontalScroller based on UIVerticalScroller.
-- Added OnHighlightChanged and OnPressChanged events for UI Button.
-- Added error handling around setting Unity UI Components for Vertical/Horizontal ScrollSnaps.
-- Added Editor Menu Option to create a Min/Max slider.
-- Added the ability to set a specific item for combobox controls on start and not just the first.
-- Added the ability to disable the combo boxes and make them read-only.
+- Add CalculatePointOnCurve for uilinerenderer (@victornor)
 
 ## Changed
 
-- Refresh FancyScrollView with the latest fixes
-- All Text based components updated to use TextMeshPro from Unity 2022 **Breaking Change**
-
-- Clean-up and reset pivots on scene start.
-- Merged in feature/improved-ui-highlightable (pull request UILineRenderer - issues with specifying point locations at runtime #123).
-- Merged in fix/ragesliderfix (pull request HorizontalScrollSnap Mask Area doesn't work when content created dynamically #125).
-- Merged in fix/infinitescrollcontentsize (pull request Gradient initialization should be in Awake() #126).
-- Merged in feature/controlTouchUp (pull request UILineRenderer mesh not updating in Editor scene view #127).
-- Upgraded RangeSlider to work in both Horizontal and Vertical setups.
-- Merged in RangeSlider-upgrade. (pull request Newtonsoft.Json.dll conflict #131)
-- Updated UIVertical scroller to be 2022 compliant.
-- Updated Curly UI to wait until end of the frame to recalculate positions.
-- Updated Depth Texture sampler in UI Particles Shaders.
-- Updated Points to always be an array of 1 when set to nothing for the Line Renderer.
-- Updated Cooldown button to work with Keyboard input.
-- Removed unneeded size calculation which caused some issues with mixed content.
-- Resolved an issue whereby the last row in a flow layout group would not size correctly.
-- Updated all components using "LayoutGroup" to override their OnDisable.
-- Updated validation in the new MinMaxSlider.
-- Updated Editor create options to add the correct Event System Input manager.
-- Updated initialisation logic to not cause an endless loop in the TabNavigationHelper.
-- Updated "Action" use to "UnityAction" to avoid Unity issues for DropDowns.
-- Updated UIVerticalScroller for standards.
-- Updated ReorderableList/ReorderableListElement to prevent creating a fake object for non-transferable items.
-- Updated panel drawing for ComboBox controls and added DropdownOffset.
-- Updated build issue with ReorderableListElement.
-- Updated NonDrawingGraphic to require a CanvasRender, else it causes an error on run.
+- fix: Fixed an null reference exception with the ResetSelectableHighlight (@FejZa)
+- fix: Resolved an issue where the last line in a flow layout group would overflow the rect bounds.
+- fix: GetPosition when Segments is null (@victornor)
+- fix: Fix Bug! NicerOutline color.a Loss when m_UseGraphicAlpha is true (wanliyun)
+- fix: Update to force Enumerated start for Accordion elements, Resolves: #455
+- Added argument to the UpdateLayout method for the HSS/VSS to move to a new starting page.
+- Updated implementations to handle 2023 support, with 2023 moving in to public release.
+- Added extra event on the AutoCompleteComboBox, to fire when an item in the list is selected, with its display name.
+- FlowLayoutGroup components updated to latest (likely the last as the author has stopped development)
 
 ## Deprecated
 
-- Marked ScrollPositionController as Obsolete, users should use the new Scoller.
-- BestFitOutline - Deprecated in Unity 2020 onwards. (still available for earlier versions)
-- NicerOutline - Deprecated in Unity 2020 onwards. (still available for earlier versions)
-- Marked TileSizeFitter as obsolete as Unity has made this unworkable.
+- All deprecated Text based components now have "obsolete" tags, to avoid breaking code.  Note, these do not function in 2022 and above, as Unity have "changed" things.  For any affected component, I recommend updating to use TextMeshPro native features.
 
-## Fixed
-
-- Resolved issues with DisplayAbove and using a 0 ItemsToDisplay for ComboBox controls.
-- Resolved startup issue that prevented the control from being used (Unity changed the start order in some instances), this was causing null reference issues with comboboxes.
-- Patch fix for UILineRenderer.
-- Resolves issue where the lower range value would become stuck when moving.
-- Updated Infinite scroll to work with content of different sizes.
-- Updated Dropdown list to NOT resize text Rect on draw.
-- Revised the Curly UI fix as it was preventing the graphic from being updated in the scene view.
-- Cleanup and ensuring the UIParticleSystem is disposed in onDestroy correctly.
-- Clean up range slider unused variables.
-
-* [UI Extensions Issue log](https://github.com/Unity-UI-Extensions/com.unity.uiextensions/issues)
+- [UI Extensions Issue log](https://github.com/Unity-UI-Extensions/com.unity.uiextensions/issues)
 
 ## Upgrade Notes
 
@@ -251,9 +216,9 @@ Got a script you want added? Then just fork the [GitHub repository](https://gith
 
 Just ensure:
 
-* The header of the script should match the standard used in all scripts.
-* The script uses the **Unity.UI.Extensions** namespace so they do not affect any other developments.
-* (optional) Add Component and Editor options where possible. (editor options are in the Editor\UIExtensionsMenuOptions.cs file)
+- The header of the script should match the standard used in all scripts.
+- The script uses the **Unity.UI.Extensions** namespace so they do not affect any other developments.
+- (optional) Add Component and Editor options where possible. (editor options are in the Editor\UIExtensionsMenuOptions.cs file)
 
 ## [License](https://raw.githubusercontent.com/Unity-UI-Extensions/com.unity.uiextensions/release/LICENSE.md)
 

Runtime/Scripts/Controls/Accordion/AccordionElement.cs

@@ -2,217 +2,225 @@
 ///Sourced from - http://forum.unity3d.com/threads/accordion-type-layout.271818/
 
 using System;
+using System.Collections;
 using UnityEngine.UI.Extensions.Tweens;
 
 namespace UnityEngine.UI.Extensions
 {
     [RequireComponent(typeof(RectTransform), typeof(LayoutElement))]
-	[AddComponentMenu("UI/Extensions/Accordion/Accordion Element")]
-	public class AccordionElement : Toggle
-	{
+    [AddComponentMenu("UI/Extensions/Accordion/Accordion Element")]
+    public class AccordionElement : Toggle
+    {
 
-		[SerializeField] private float m_MinHeight = 18f;
+        [SerializeField] private float m_MinHeight = 18f;
 
-		public float MinHeight => m_MinHeight;
+        public float MinHeight => m_MinHeight;
 
-		[SerializeField] private float m_MinWidth = 40f;
+        [SerializeField] private float m_MinWidth = 40f;
 
-		public float MinWidth => m_MinWidth;
+        public float MinWidth => m_MinWidth;
 
-		private Accordion m_Accordion;
-		private RectTransform m_RectTransform;
-		private LayoutElement m_LayoutElement;
-		
-		[NonSerialized]
-		private readonly TweenRunner<FloatTween> m_FloatTweenRunner;
-		
-		protected AccordionElement()
-		{
-			if (this.m_FloatTweenRunner == null)
-				this.m_FloatTweenRunner = new TweenRunner<FloatTween>();
-			
-			this.m_FloatTweenRunner.Init(this);
-		}
-		
-		protected override void Awake()
-		{
-			base.Awake();
-			base.transition = Transition.None;
-			base.toggleTransition = ToggleTransition.None;
-			this.m_Accordion = this.gameObject.GetComponentInParent<Accordion>();
-			this.m_RectTransform = this.transform as RectTransform;
-			this.m_LayoutElement = this.gameObject.GetComponent<LayoutElement>();
-			this.onValueChanged.AddListener(OnValueChanged);
-		}
+        private Accordion m_Accordion;
+        private RectTransform m_RectTransform;
+        private LayoutElement m_LayoutElement;
+
+        [NonSerialized]
+        private readonly TweenRunner<FloatTween> m_FloatTweenRunner;
+
+        protected AccordionElement()
+        {
+            if (this.m_FloatTweenRunner == null)
+                this.m_FloatTweenRunner = new TweenRunner<FloatTween>();
+
+            this.m_FloatTweenRunner.Init(this);
+        }
+
+        protected override void Awake()
+        {
+            base.Awake();
+            base.transition = Transition.None;
+            base.toggleTransition = ToggleTransition.None;
+            this.m_Accordion = this.gameObject.GetComponentInParent<Accordion>();
+            this.m_RectTransform = this.transform as RectTransform;
+            this.m_LayoutElement = this.gameObject.GetComponent<LayoutElement>();
+            this.onValueChanged.AddListener(OnValueChanged);
+        }
+
+        private new IEnumerator Start()
+        {
+            base.Start();
+            yield return new WaitForEndOfFrame(); // Wait for the first frame
+            OnValueChanged(this.isOn);
+        }
 
 #if UNITY_EDITOR
-		protected override void OnValidate()
-		{
-			base.OnValidate();
-			this.m_Accordion = this.gameObject.GetComponentInParent<Accordion>();
+        protected override void OnValidate()
+        {
+            base.OnValidate();
+            this.m_Accordion = this.gameObject.GetComponentInParent<Accordion>();
 
-			if (this.group == null)
-			{
-				ToggleGroup tg = this.GetComponentInParent<ToggleGroup>();
-				
-				if (tg != null)
-				{
-					this.group = tg;
-				}
-			}
-			
-			LayoutElement le = this.gameObject.GetComponent<LayoutElement>();
+            if (this.group == null)
+            {
+                ToggleGroup tg = this.GetComponentInParent<ToggleGroup>();
 
-			if (le != null && m_Accordion != null)
-			{
-				if (this.isOn)
-				{
+                if (tg != null)
+                {
+                    this.group = tg;
+                }
+            }
+
+            LayoutElement le = this.gameObject.GetComponent<LayoutElement>();
+
+            if (le != null && m_Accordion != null)
+            {
+                if (this.isOn)
+                {
                     if (m_Accordion.ExpandVerticval)
                     {
-						le.preferredHeight = -1f;
-					}
-                    else
-                    {
-						le.preferredWidth = -1f;
+                        le.preferredHeight = -1f;
                     }
-				}
-				else
-				{
-					if (m_Accordion.ExpandVerticval)
-					{
-						le.preferredHeight = this.m_MinHeight;
-					}
                     else
                     {
-						le.preferredWidth = this.m_MinWidth;
+                        le.preferredWidth = -1f;
+                    }
+                }
+                else
+                {
+                    if (m_Accordion.ExpandVerticval)
+                    {
+                        le.preferredHeight = this.m_MinHeight;
+                    }
+                    else
+                    {
+                        le.preferredWidth = this.m_MinWidth;
 
-					}
-				}
-			}
-		}
+                    }
+                }
+            }
+        }
 #endif
 
-		public void OnValueChanged(bool state)
-		{
-			if (this.m_LayoutElement == null)
-				return;
-			
-			Accordion.Transition transition = (this.m_Accordion != null) ? this.m_Accordion.transition : Accordion.Transition.Instant;
+        public void OnValueChanged(bool state)
+        {
+            if (this.m_LayoutElement == null)
+                return;
 
-			if (transition == Accordion.Transition.Instant && m_Accordion != null)
-			{
-				if (state)
-				{
-					if (m_Accordion.ExpandVerticval)
-					{
-						this.m_LayoutElement.preferredHeight = -1f;
-					}
+            Accordion.Transition transition = (this.m_Accordion != null) ? this.m_Accordion.transition : Accordion.Transition.Instant;
+
+            if (transition == Accordion.Transition.Instant && m_Accordion != null)
+            {
+                if (state)
+                {
+                    if (m_Accordion.ExpandVerticval)
+                    {
+                        this.m_LayoutElement.preferredHeight = -1f;
+                    }
                     else
                     {
-						this.m_LayoutElement.preferredWidth = -1f;
-					}
-				}
-				else
-				{
-					if (m_Accordion.ExpandVerticval)
-					{
-						this.m_LayoutElement.preferredHeight = this.m_MinHeight;
-					}
+                        this.m_LayoutElement.preferredWidth = -1f;
+                    }
+                }
+                else
+                {
+                    if (m_Accordion.ExpandVerticval)
+                    {
+                        this.m_LayoutElement.preferredHeight = this.m_MinHeight;
+                    }
                     else
                     {
-						this.m_LayoutElement.preferredWidth = this.m_MinWidth;
-					}
-				}
-			}
-			else if (transition == Accordion.Transition.Tween)
-			{
-				if (state)
-				{
-					if (m_Accordion.ExpandVerticval)
-					{
-						this.StartTween(this.m_MinHeight, this.GetExpandedHeight());
-					}
+                        this.m_LayoutElement.preferredWidth = this.m_MinWidth;
+                    }
+                }
+            }
+            else if (transition == Accordion.Transition.Tween)
+            {
+                if (state)
+                {
+                    if (m_Accordion.ExpandVerticval)
+                    {
+                        this.StartTween(this.m_MinHeight, this.GetExpandedHeight());
+                    }
                     else
                     {
-						this.StartTween(this.m_MinWidth, this.GetExpandedWidth());
-					}
-				}
-				else
-				{
-					if (m_Accordion.ExpandVerticval)
-					{
-						this.StartTween(this.m_RectTransform.rect.height, this.m_MinHeight);
-					}
+                        this.StartTween(this.m_MinWidth, this.GetExpandedWidth());
+                    }
+                }
+                else
+                {
+                    if (m_Accordion.ExpandVerticval)
+                    {
+                        this.StartTween(this.m_RectTransform.rect.height, this.m_MinHeight);
+                    }
                     else
                     {
-						this.StartTween(this.m_RectTransform.rect.width, this.m_MinWidth);
-					}
-				}
-			}
-		}
-		
-		protected float GetExpandedHeight()
-		{
-			if (this.m_LayoutElement == null)
-				return this.m_MinHeight;
-			
-			float originalPrefH = this.m_LayoutElement.preferredHeight;
-			this.m_LayoutElement.preferredHeight = -1f;
-			float h = LayoutUtility.GetPreferredHeight(this.m_RectTransform);
-			this.m_LayoutElement.preferredHeight = originalPrefH;
-			
-			return h;
-		}
+                        this.StartTween(this.m_RectTransform.rect.width, this.m_MinWidth);
+                    }
+                }
+            }
+        }
 
-		protected float GetExpandedWidth()
-		{
-			if (this.m_LayoutElement == null)
-				return this.m_MinWidth;
+        protected float GetExpandedHeight()
+        {
+            if (this.m_LayoutElement == null)
+                return this.m_MinHeight;
 
-			float originalPrefW = this.m_LayoutElement.preferredWidth;
-			this.m_LayoutElement.preferredWidth = -1f;
-			float w = LayoutUtility.GetPreferredWidth(this.m_RectTransform);
-			this.m_LayoutElement.preferredWidth = originalPrefW;
+            float originalPrefH = this.m_LayoutElement.preferredHeight;
+            this.m_LayoutElement.preferredHeight = -1f;
+            float h = LayoutUtility.GetPreferredHeight(this.m_RectTransform);
+            this.m_LayoutElement.preferredHeight = originalPrefH;
 
-			return w;
-		}
+            return h;
+        }
 
-		protected void StartTween(float startFloat, float targetFloat)
-		{
-			float duration = (this.m_Accordion != null) ? this.m_Accordion.transitionDuration : 0.3f;
-			
-			FloatTween info = new FloatTween
-			{
-				duration = duration,
-				startFloat = startFloat,
-				targetFloat = targetFloat
-			};
-			if (m_Accordion.ExpandVerticval)
-			{
-				info.AddOnChangedCallback(SetHeight);
-			}
+        protected float GetExpandedWidth()
+        {
+            if (this.m_LayoutElement == null)
+                return this.m_MinWidth;
+
+            float originalPrefW = this.m_LayoutElement.preferredWidth;
+            this.m_LayoutElement.preferredWidth = -1f;
+            float w = LayoutUtility.GetPreferredWidth(this.m_RectTransform);
+            this.m_LayoutElement.preferredWidth = originalPrefW;
+
+            return w;
+        }
+
+        protected void StartTween(float startFloat, float targetFloat)
+        {
+            float duration = (this.m_Accordion != null) ? this.m_Accordion.transitionDuration : 0.3f;
+
+            FloatTween info = new FloatTween
+            {
+                duration = duration,
+                startFloat = startFloat,
+                targetFloat = targetFloat
+            };
+            if (m_Accordion.ExpandVerticval)
+            {
+                info.AddOnChangedCallback(SetHeight);
+            }
             else
             {
-				info.AddOnChangedCallback(SetWidth);
-			}
-			info.ignoreTimeScale = true;
-			this.m_FloatTweenRunner.StartTween(info);
-		}
-		
-		protected void SetHeight(float height)
-		{
-			if (this.m_LayoutElement == null)
-				return;
-				
-			this.m_LayoutElement.preferredHeight = height;
-		}
+                info.AddOnChangedCallback(SetWidth);
+            }
+            info.ignoreTimeScale = true;
+            this.m_FloatTweenRunner.StartTween(info);
+        }
 
-		protected void SetWidth(float width)
-		{
-			if (this.m_LayoutElement == null)
-				return;
+        protected void SetHeight(float height)
+        {
+            if (this.m_LayoutElement == null)
+                return;
 
-			this.m_LayoutElement.preferredWidth = width;
-		}
-	}
+            this.m_LayoutElement.preferredHeight = height;
+        }
+
+        protected void SetWidth(float width)
+        {
+            if (this.m_LayoutElement == null)
+                return;
+
+            this.m_LayoutElement.preferredWidth = width;
+        }
+    }
 }

Runtime/Scripts/Controls/ComboBox/AutoCompleteComboBox.cs

@@ -1,7 +1,6 @@
 ///Credit perchik
 ///Sourced from - http://forum.unity3d.com/threads/receive-onclick-event-and-pass-it-on-to-lower-ui-elements.293642/
 
-using System;
 using System.Collections.Generic;
 using System.Linq;
 
@@ -132,6 +131,9 @@ namespace UnityEngine.UI.Extensions
         [System.Serializable]
         public class SelectionValidityChangedEvent : Events.UnityEvent<bool> { }
 
+        [System.Serializable]
+        public class ItemSelectedEvent : Events.UnityEvent<string> { }
+
         [System.Serializable]
         public class ControlDisabledEvent : Events.UnityEvent<bool> { }
 
@@ -142,6 +144,8 @@ namespace UnityEngine.UI.Extensions
         public SelectionValidityChangedEvent OnSelectionValidityChanged;
         // fires in both cases
         public SelectionChangedEvent OnSelectionChanged;
+        // fires when an item is clicked
+        public ItemSelectedEvent OnItemSelected;
         // fires when item is changed;
         public ControlDisabledEvent OnControlDisabled;
 
@@ -359,10 +363,10 @@ namespace UnityEngine.UI.Extensions
         /// <param name="item"></param>
         private void OnItemClicked(string item)
         {
-            //Debug.Log("item " + item + " clicked");
             Text = item;
             _mainInput.text = Text;
             ToggleDropdownPanel(true);
+            OnItemSelected?.Invoke(Text);
         }
 
         private void RedrawPanel()

Runtime/Scripts/Controls/Sliders/BoxSlider.cs

@@ -367,5 +367,14 @@ namespace UnityEngine.UI.Extensions
             eventData.useDragThreshold = false;
         }
 
+        public void SetXWithoutNotify(float x)
+        {
+            SetX(x, false);
+        }
+
+        public void SetYWithoutNotify(float y)
+        {
+            SetY(y, false);
+        }
     }
 }

Runtime/Scripts/Effects/BestFitOutline.cs

@@ -2,10 +2,19 @@
 /// Sourced from - http://forum.unity3d.com/members/melang.593409/
 /// NOT supported in Unity 2022
 
+using System;
 #if !UNITY_2022_1_OR_NEWER
 using System.Collections.Generic;
+#endif
+
 namespace UnityEngine.UI.Extensions
 {
+#if UNITY_2022_1_OR_NEWER
+	[Obsolete("BestFitOutline is not supported in Unity 2022.1 or newer. Use TMPro instead.")]
+	public class BestFitOutline : Shadow
+	{
+	}
+#else
     [AddComponentMenu("UI/Effects/Extensions/BestFit Outline")]
 	public class BestFitOutline : Shadow
 	{
@@ -61,5 +70,5 @@ namespace UnityEngine.UI.Extensions
             }
         }
 	}
-}
-#endif
+#endif
+    }

Runtime/Scripts/Effects/CurvedText.cs

@@ -1,9 +1,17 @@
-/// Credit Breyer
-/// Sourced from - http://forum.unity3d.com/threads/scripts-useful-4-6-scripts-collection.264161/#post-1777407
-#if !UNITY_2022_1_OR_NEWER
+
+using System;
 
 namespace UnityEngine.UI.Extensions
 {
+#if UNITY_2022_1_OR_NEWER
+    [Obsolete("CurvedText is not supported in Unity 2022.1 or newer. Use TMPro instead.")]
+    public class CurvedText : BaseMeshEffect
+    {
+        public override void ModifyMesh(VertexHelper vh)
+        {
+        }
+    }
+#else
     [RequireComponent(typeof(Text))]
     [RequireComponent(typeof(RectTransform))]
     [AddComponentMenu("UI/Effects/Extensions/Curved Text")]
@@ -83,5 +91,5 @@ namespace UnityEngine.UI.Extensions
             }
         }
     }
-}
-#endif
+#endif
+}

Runtime/Scripts/Effects/CylinderText.cs

@@ -1,10 +1,20 @@
-/// adaption for cylindrical bending by herbst
+
+using System;
+
+/// adaption for cylindrical bending by herbst
 /// Credit Breyer
 /// Sourced from - http://forum.unity3d.com/threads/scripts-useful-4-6-scripts-collection.264161/#post-1777407
-#if !UNITY_2022_1_OR_NEWER
-
 namespace UnityEngine.UI.Extensions
 {
+#if UNITY_2022_1_OR_NEWER
+    [Obsolete("CylinderText is not supported in Unity 2022.1 or newer. Use TMPro instead.")]
+    public class CylinderText : BaseMeshEffect
+    {
+        public override void ModifyMesh(VertexHelper vh)
+        {
+        }
+    }
+#else
     [RequireComponent(typeof(Text))]
     [RequireComponent(typeof(RectTransform))]
     [AddComponentMenu("UI/Effects/Extensions/Cylinder Text")]
@@ -53,5 +63,5 @@ namespace UnityEngine.UI.Extensions
             }
         }
     }
-}
-#endif
+#endif
+}

Runtime/Scripts/Effects/LetterSpacing.cs

@@ -1,6 +1,4 @@
-/// Credit Deeperbeige
-/// Sourced from - http://forum.unity3d.com/threads/adjustable-character-spacing-free-script.288277/
-/*
+/*
 
 Produces an simple tracking/letter-spacing effect on UI Text components.
 
@@ -42,9 +40,23 @@ break down entirely, but it doesn't really do what you'd want either.
 */
 #if !UNITY_2022_1_OR_NEWER
 using System.Collections.Generic;
+#endif
 
+using System;
+
+/// Credit Deeperbeige
+/// Sourced from - http://forum.unity3d.com/threads/adjustable-character-spacing-free-script.288277/
 namespace UnityEngine.UI.Extensions
 {
+#if UNITY_2022_1_OR_NEWER
+    [Obsolete("LetterSpacing is not supported in Unity 2022.1 or newer. Use TMPro instead.")]
+    public class LetterSpacing : BaseMeshEffect
+    {
+        public override void ModifyMesh(VertexHelper vh)
+        {
+        }
+    }
+#else
     [AddComponentMenu("UI/Effects/Extensions/Letter Spacing")]
     ///Summary
     /// Note, Vertex Count has changed in 5.2.1+, is now 6 (two tris) instead of 4 (tri strip).
@@ -55,13 +67,13 @@ namespace UnityEngine.UI.Extensions
 
 		protected LetterSpacing() { }
 		
-		#if UNITY_EDITOR
+#if UNITY_EDITOR
 		protected override void OnValidate()
 		{
 			spacing = m_spacing;
 			base.OnValidate();
 		}
-		#endif
+#endif
 		
 		public float spacing
 		{
@@ -171,5 +183,5 @@ namespace UnityEngine.UI.Extensions
             vh.AddUIVertexTriangleStream(verts);
         }
 	}
-}
-#endif
+#endif
+}

Runtime/Scripts/Effects/MonoSpacing.cs

@@ -1,5 +1,3 @@
-/// Credit herbst / derived from LetterSpacing by Deeperbeige
-/// Sourced from - http://forum.unity3d.com/threads/adjustable-character-spacing-free-script.288277/
 /*
 
 Produces an simple mono-spacing effect on UI Text components.
@@ -41,11 +39,24 @@ break down entirely, but it doesn't really do what you'd want either.
 
 */
 #if !UNITY_2022_1_OR_NEWER
-
 using System.Collections.Generic;
+#endif
 
+using System;
+
+/// Credit herbst / derived from LetterSpacing by Deeperbeige
+/// Sourced from - http://forum.unity3d.com/threads/adjustable-character-spacing-free-script.288277/
 namespace UnityEngine.UI.Extensions
 {
+#if UNITY_2022_1_OR_NEWER
+    [Obsolete("MonoSpacing is not supported in Unity 2022.1 or newer. Use TMPro instead.")]
+    public class MonoSpacing : BaseMeshEffect
+    {
+        public override void ModifyMesh(VertexHelper vh)
+        {
+        }
+    }
+#else
     [AddComponentMenu("UI/Effects/Extensions/Mono Spacing")]
     [RequireComponent(typeof(Text))]
     [RequireComponent(typeof(RectTransform))]
@@ -76,13 +87,13 @@ namespace UnityEngine.UI.Extensions
             rectTransform = text.GetComponent<RectTransform>();
         }
 
-        #if UNITY_EDITOR
+#if UNITY_EDITOR
         protected override void OnValidate()
 		{
 			Spacing = m_spacing;
 			base.OnValidate();
 		}
-		#endif
+#endif
 		
 		public float Spacing
 		{
@@ -190,5 +201,5 @@ namespace UnityEngine.UI.Extensions
             vh.AddUIVertexTriangleStream(verts);
         }
 	}
-}
-#endif
+#endif
+    }

Runtime/Scripts/Effects/NicerOutline.cs

@@ -1,12 +1,25 @@
+
+#if !UNITY_2022_1_OR_NEWER
+using System.Collections.Generic;
+#endif
+
+using System;
+
 /// Credit Melang, Lee Hui
 /// Sourced from - http://forum.unity3d.com/members/melang.593409/
 /// GC Alloc fix - https://bitbucket.org/UnityUIExtensions/unity-ui-extensions/pull-requests/130
 /// NOT supported in Unity 2022
-
-#if !UNITY_2022_1_OR_NEWER
-using System.Collections.Generic;
 namespace UnityEngine.UI.Extensions
 {
+#if UNITY_2022_1_OR_NEWER
+	[Obsolete("BestFitOutline is not supported in Unity 2022.1 or newer. Use TMPro instead.")]
+	public class NicerOutline : BaseMeshEffect
+	{
+        public override void ModifyMesh(VertexHelper vh)
+        {
+        }
+    }
+#else
     //An outline that looks a bit nicer than the default one. It has less "holes" in the outline by drawing more copies of the effect
     [AddComponentMenu("UI/Effects/Extensions/Nicer Outline")]
 	public class NicerOutline : BaseMeshEffect
@@ -194,5 +207,5 @@ namespace UnityEngine.UI.Extensions
 		}
 #endif
 	}
-}
-#endif
+#endif
+    }

Runtime/Scripts/Layout/HorizontalScrollSnap.cs

@@ -223,12 +223,21 @@ namespace UnityEngine.UI.Extensions
         /// <summary>
         /// used for changing / updating between screen resolutions
         /// </summary>
-        public void UpdateLayout()
+        public void UpdateLayout(bool resetPositionToStart = false)
         {
             _lerp = false;
             DistributePages();
+
+            if (resetPositionToStart)
+            {
+                _currentPage = StartingScreen;
+            }
+
             if (MaskArea)
+            {
                 UpdateVisible();
+            }
+
             SetScrollContainerPosition();
             OnCurrentScreenChange(_currentPage);
         }

Runtime/Scripts/Layout/VerticalScrollSnap.cs

@@ -218,11 +218,21 @@ namespace UnityEngine.UI.Extensions
         /// <summary>
         /// used for changing / updating between screen resolutions
         /// </summary>
-        public void UpdateLayout()
+        public void UpdateLayout(bool resetPositionToStart = false)
         {
             _lerp = false;
             DistributePages();
-            if (MaskArea) UpdateVisible();
+
+            if (resetPositionToStart)
+            {
+                _currentPage = StartingScreen;
+            }
+
+            if (MaskArea)
+            {
+                UpdateVisible();
+            }
+
             SetScrollContainerPosition();
             OnCurrentScreenChange(_currentPage);
         }

package.json

@@ -1,7 +1,7 @@
 {
   "name": "com.unity.uiextensions",
   "displayName": "Unity UI Extensions",
-  "version": "2.3.2-pre.4",
+  "version": "2.3.2",
   "description": "An extension project for the Unity3D UI system, all crafted and contributed by the awesome Unity community",
   "author": "Simon darkside Jackson <@SimonDarksideJ>",
   "contributors": [