com.unity.splines@2.8.2

## [2.8.2] - 2025-09-18

### Fixed

- [DOCATT-4646], [DOCATT-5603], [DOCATT-7045], [DOCATT-5044], [DOCATT-6376], [DOCATT-6626] Clarified API documentation following user feedback.
- [SPLB-360] Fixed a bug when selecting the clear component option, resulting in out of range exception
- [SPLB-361] Fixed a bug where the spline would not animate with Scene/Domain reload disabled upon entering playmode
- [SPLB-356] Fixed a bug where a null reference exception would occur after baking a SplineInstantiate component and then pressing Undo.

Author: Unity Technologies

.attestation.p7m

@@ -1 +1 @@
-{"timestamp":1746566855,"signature":"HO9p3RckbKRJ5YvxQd7RtLCnqtt70oreKaLOX0+od464rkH0TMrtqHCDfRnNYKvVHkN01BA3bC6IY50nzBDNjOzuH6njPDpuwRsbbj9VvBhhZK09aRadXrl7c0lc5QD71xuZNO1VU8rVXRot5xGvd0p0tIxlpmZ9PeKZXfNaD0qnPTiXxAUJdQpdBpNwLz3ujQRaFUR4+HckNjtnivESM57H98QZq6rZatgr/UJNCbVkuTo4yejDJE2jU48rx61lgODj2qq9u2JZNpjjubXSb7tooe3sLU5zMI8ArzX+i3M1SeS5bSRM3DLTrkirRQaPQCTxJK0JPO1smZ3XusJBT6d611rPortvFOdc2ZcnjolP+ep9BJAGbA7L/Uebl4il/dw0jRV0fWieqM9EqK7jA4ye8ftUOJmIcxDgpHGntjuGsbaV4X+OV/co6eaof2FgXbhmAlSXoelEOHO7TFFE6u0le2Y4hdZNqImn2bF8DUPM9ngavrUKIZwsTAqNKBrG","publicKey":"LS0tLS1CRUdJTiBQVUJMSUMgS0VZLS0tLS0KTUlJQm9qQU5CZ2txaGtpRzl3MEJBUUVGQUFPQ0FZOEFNSUlCaWdLQ0FZRUFzdUhXYUhsZ0I1cVF4ZEJjTlJKSAordHR4SmoxcVY1NTdvMlZaRE1XaXhYRVBkRTBEMVFkT1JIRXNSS1RscmplUXlERU83ZlNQS0ZwZ1A3MU5TTnJCCkFHM2NFSU45aHNQVDhOVmllZmdWem5QTkVMenFkVmdEbFhpb2VpUnV6OERKWFgvblpmU1JWKytwbk9ySTRibG4KS0twelJlNW14OTc1SjhxZ1FvRktKT0NNRlpHdkJMR2MxSzZZaEIzOHJFODZCZzgzbUovWjBEYkVmQjBxZm13cgo2ZDVFUXFsd0E5Y3JZT1YyV1VpWXprSnBLNmJZNzRZNmM1TmpBcEFKeGNiaTFOaDlRVEhUcU44N0ZtMDF0R1ZwCjVNd1pXSWZuYVRUemEvTGZLelR5U0pka0tldEZMVGdkYXpMYlpzUEE2aHBSK0FJRTJhc0tLTi84UUk1N3UzU2cKL2xyMnZKS1IvU2l5eEN1Q20vQWJkYnJMbXk0WjlSdm1jMGdpclA4T0lLQWxBRWZ2TzV5Z2hSKy8vd1RpTFlzUQp1SllDM0V2UE16ZGdKUzdGR2FscnFLZzlPTCsxVzROY05yNWdveVdSUUJ0cktKaWlTZEJVWmVxb0RvSUY5NHpCCndGbzJJT1JFdXFqcU51M3diMWZIM3p1dGdtalFra3IxVjJhd3hmcExLWlROQWdNQkFBRT0KLS0tLS1FTkQgUFVCTElDIEtFWS0tLS0tCg"}
+{"timestamp":1757970422,"signature":"nMNeEND7In9XeSIqssS7g/agD+T9TkMOKwTl2kwp/0UhLtE6bBuuiqG8RStLM3qz4m5wRZLrGWs36ZTR1J2WFuUjC2as6ZSE7ItDsusnX5zhAQADU/ol5thot5fpwQm1G2nJUVUZOfHPCOc1uLIlruZ7bFwX9PwTZlDVk9GCNIe7N7cZ0CS5FdCyqQeuQjl99YC1PoHLifo+C1lPbqy0V1dEy6M9SacrAWSPWTmNaqLzfo46ircTPWS9zpx9dk3BQakBCHiF4cHFGIPpG5VTGpJqkR+SjsCbwjdPyI03BDOsZeCsUyIgvr2gSquBjDzARCqrzxKHNgLnb5WH/bnlrEIqslfMA0Ij/JdD1AYtycGlAjPd+Zb7EeF4utKbsYsv+E6jgkXVrwlCDH0JEgx2KhY1Iqy0E0k2rqPn8NJw41GV7G8KV63aVwK6pN8WcGZ+zi5oha+6UdySjnshSVAnBgBH/P4bxZVFpTMj5PqGuJLvDT7KQ8WeLm8ultfM5bIJ","publicKey":"LS0tLS1CRUdJTiBQVUJMSUMgS0VZLS0tLS0KTUlJQm9qQU5CZ2txaGtpRzl3MEJBUUVGQUFPQ0FZOEFNSUlCaWdLQ0FZRUFzdUhXYUhsZ0I1cVF4ZEJjTlJKSAordHR4SmoxcVY1NTdvMlZaRE1XaXhYRVBkRTBEMVFkT1JIRXNSS1RscmplUXlERU83ZlNQS0ZwZ1A3MU5TTnJCCkFHM2NFSU45aHNQVDhOVmllZmdWem5QTkVMenFkVmdEbFhpb2VpUnV6OERKWFgvblpmU1JWKytwbk9ySTRibG4KS0twelJlNW14OTc1SjhxZ1FvRktKT0NNRlpHdkJMR2MxSzZZaEIzOHJFODZCZzgzbUovWjBEYkVmQjBxZm13cgo2ZDVFUXFsd0E5Y3JZT1YyV1VpWXprSnBLNmJZNzRZNmM1TmpBcEFKeGNiaTFOaDlRVEhUcU44N0ZtMDF0R1ZwCjVNd1pXSWZuYVRUemEvTGZLelR5U0pka0tldEZMVGdkYXpMYlpzUEE2aHBSK0FJRTJhc0tLTi84UUk1N3UzU2cKL2xyMnZKS1IvU2l5eEN1Q20vQWJkYnJMbXk0WjlSdm1jMGdpclA4T0lLQWxBRWZ2TzV5Z2hSKy8vd1RpTFlzUQp1SllDM0V2UE16ZGdKUzdGR2FscnFLZzlPTCsxVzROY05yNWdveVdSUUJ0cktKaWlTZEJVWmVxb0RvSUY5NHpCCndGbzJJT1JFdXFqcU51M3diMWZIM3p1dGdtalFra3IxVjJhd3hmcExLWlROQWdNQkFBRT0KLS0tLS1FTkQgUFVCTElDIEtFWS0tLS0tCg"}

.signature

@@ -5,19 +5,31 @@ All notable changes to this package will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
+## [2.8.2] - 2025-09-18
+
+### Fixed
+
+- [DOCATT-4646], [DOCATT-5603], [DOCATT-7045], [DOCATT-5044], [DOCATT-6376], [DOCATT-6626] Clarified API documentation following user feedback.
+- [SPLB-360] Fixed a bug when selecting the clear component option, resulting in out of range exception
+- [SPLB-361] Fixed a bug where the spline would not animate with Scene/Domain reload disabled upon entering playmode
+- [SPLB-356] Fixed a bug where a null reference exception would occur after baking a SplineInstantiate component and then pressing Undo.
+
 ## [2.8.1] - 2025-03-28
 
-### Bug Fixes
+### Fixed
+
 - [SPLB-345] Fixed a bug which was causing null reference exceptions during shutdown in IL2CPP builds.
-- [SPLB-337] Fixed a bug where `JoinSplinesOnKnots` would throw a null reference exception when one of the splines was linked with another spline.
+- [SPLB-343] Fixed a bug where `JoinSplinesOnKnots` would throw a null reference exception when one of the splines was linked with another spline.
 - [SPLB-341] Fixed a bug where changing the tangent mode on a knot on a prefab would not persist when entering play mode.
 
 ### Changed
-- Internal code cleanup to align with release standards.
+
+- Cleaned up internal code to align with release standards.
 
 ## [2.8.0] - 2025-03-13
 
-### Bug Fixes
+### Fixed
+
 - [SPLB-322] Fixed a bug where `SplineExtrude` wouldn't update when multiple splines where modified.
 - [SPLB-323] Fixed a bug where splines displayed in the Scene view would not match serialization changes.
 - [SPLB-324] Re-added a dependency to the IMGUI module that was removed along with the UGUI package.
@@ -27,11 +39,13 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 - [SPLB-333] Fixed a bug where `Create Spline` tool would sometimes throw an exception when the Esc or Enter keys were pressed.
 
 ### Added
+
 - [SPLB-329] Added the ability to target a mesh in the library with a `SplineExtrude` component
 
 ## [2.7.2] - 2024-11-08
 
-### Bug Fixes
+### Fixed
+
 - [SPLB-315] Fixed a bug where the `DrawSplineTool` icon was missing in the Tools overlay.
 - [STO-3434] Fixed a bug where the `DrawSplineTool` prevented the use of the View tool.
 - [STO-3435] Fixed a bug where the `DrawSplineTool` did not display the Tool settings overlay.
@@ -53,7 +67,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 - New `SplineExtrude` and `SplineMesh` option enables new extrusion profiles, including `Circle`, `Square`, `Road`, and `Spline`.
 - Added a section in the documentation for the `Source Spline Container` in the `SplineExtrude` component.
 
-### Bug Fixes
+### Fixed
 
 - [SPLB-292] Removed the dependency on the UGUI package.
 - Removed the toggle to override the target spline in the `SplineExtrude` inspector.
@@ -64,7 +78,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 
 ## [2.6.1] - 2024-05-23
 
-### Bug Fixes
+### Fixed
 
 - [SPLB-275] Fixed a bug where the `SplineContainer` component would throw warning when entering playmode.
 - [SPLB-266] Fixed a bug where instantiating a `SplineExtrude` component at runtime would throw errors.
@@ -86,7 +100,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 
 - Changed supported version in the documentation dropdown selector to 2022.3 and later.
 
-### Bug Fixes
+### Fixed
 
 - [SPLB-246] Fixed performance and garbage collection (GC) memory allocation issues when evaluating splines using `SplineContainer` API.
 - [STO-3176] Fixed an issue where `FitSplineToPoints` utility would not fit splines correctly.
@@ -108,7 +122,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 - [SPLB-233] Removed transform handles while dragging a knot using direct manipulation.
 - [SPLB-234] Removed unnecessary spline metadata which was saved on disk.
 
-### Bug Fixes
+### Fixed
 
 - [SPLB-230] Fixed a bug where modifying the tangent mode on the last knot would change the spline shape unpredictably.
 - [SPLB-225] Fixed a bug where closing a Spline with the `Draw Splines Tool` had inconsistent behaviour.
@@ -120,7 +134,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 
 ## [2.5.1] - 2023-10-17
 
-### Bug Fixes
+### Fixed
 
 - [SPLB-208] Fixed a bug where `SplineToolContext` would attempt to draw empty Splines and flood the console with errors.
 
@@ -130,7 +144,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 
 - Exposed public API for `SplineInstantiate.Seed`.
 
-### Bug Fixes
+### Fixed
 
 - [SPLB-201] Fixed error messages showing in edit mode with spline components.
 - [SPLB-203] Fixed a bug where baking `SplineInstantiate` instances broke prefab connections.
@@ -160,7 +174,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 - [SPLB-167] Changed the evaluation of up vectors to use a cache instead of re-evaluate the values on every single request.
 - In Editor versions of 2023.2 or newer, moved the following actions from the Element Inspector to the Scene view context menu: Link, Unlink, Split, Join, and Reverse Spline Flow.
 
-### Bug Fixes
+### Fixed
 
 - [SPLB-176] Fixed a regression where the up vector would not evaluate correctly for some curves.
 - Fixed the setter for SplineAnimate.Normalized time to handle ping-pong direction correctly when set.
@@ -174,7 +188,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 - Exposed public APIs for `SplineTool` and `SplineHandles`.
 - Added a method to *bake* SplineInstantiate objects in the scene so the users can modify the resulting GameObjects.
 
-### Bug Fixes
+### Fixed
 
 - [SPLB-165] Fixed a bug that prevented actions from being retained with prefab instances that contained splines when entering playmode.
 - [SPLB-162] Fixed a bug where the start offset in `SplineAnimate` did not work in Play mode.

CHANGELOG.md

@@ -200,7 +200,7 @@ protected void OnEnable()
 
     bool Initialize()
     {
-        if (m_Components != null && m_Components.Length > 0)
+        if (m_SplineContainer != null && m_Components != null && m_Components.Length > 0)
             return true;
 
         m_SplineContainer = serializedObject.FindProperty("m_Container");
@@ -359,13 +359,17 @@ public override void OnInspectorGUI()
         EditorGUILayout.EndHorizontal();
         EditorGUILayout.Separator();
 
-        foreach (var splineInstantiate in m_Components)
+        // m_Components may have been made null as a result of the Bake operation (via OnDisable)
+        if (m_Components != null)
         {
-            if (dirtyInstances)
-                splineInstantiate.SetDirty();
+            foreach (var splineInstantiate in m_Components)
+            {
+                if (dirtyInstances)
+                    splineInstantiate.SetDirty();
 
-            if (updateInstances)
-                splineInstantiate.UpdateInstances();
+                if (updateInstances)
+                    splineInstantiate.UpdateInstances();
+            }
         }
 
         if (dirtyInstances || updateInstances)

Documentation~/getting-started-with-splines.md

@@ -137,7 +137,7 @@ public static HandleOrientation handleOrientation
         public override void OnActivated()
         {
             SplineSelection.changed += OnSplineSelectionChanged;
-            Spline.afterSplineWasModified += AfterSplineWasModified;
+            Spline.afterSplineWasModifiedSceneLoop += AfterSplineWasModified;
             Undo.undoRedoPerformed += UndoRedoPerformed;
             Tools.pivotRotationChanged += OnPivotRotationChanged;
             Tools.pivotModeChanged += OnPivotModeChanged;
@@ -152,7 +152,7 @@ public override void OnActivated()
         public override void OnWillBeDeactivated()
         {
             SplineSelection.changed -= OnSplineSelectionChanged;
-            Spline.afterSplineWasModified -= AfterSplineWasModified;
+            Spline.afterSplineWasModifiedSceneLoop -= AfterSplineWasModified;
             Undo.undoRedoPerformed -= UndoRedoPerformed;
             Tools.pivotRotationChanged -= OnPivotRotationChanged;
             Tools.pivotModeChanged -= OnPivotModeChanged;

Editor/Components/SplineInstantiateEditor.cs

@@ -36,7 +36,10 @@ static void ObjectEventChangesPublished(ref ObjectChangeEventStream stream)
                 if (type == ObjectChangeKind.ChangeGameObjectStructure)
                 {
                     stream.GetChangeGameObjectStructureEvent(i, out var changeGameObjectStructure);
+                    
+#pragma warning disable CS0618 // Type or member is obsolete
                     if (EditorUtility.InstanceIDToObject(changeGameObjectStructure.instanceId) is GameObject go)
+#pragma warning restore CS0618 // Type or member is obsolete
                         CheckForSplineExtrudeAdded(go);
                 }
             }

Editor/Tools/SplineTool.cs

@@ -89,7 +89,7 @@ public BezierKnot Transform(float4x4 matrix)
         }
 
         /// <summary>
-        /// Knot position addition. This operation only applies to the position, tangents and rotation are unmodified.
+        /// Adds a knot position. This operation applies only to the position and does not modify tangents or rotation.
         /// </summary>
         /// <param name="knot">The target knot.</param>
         /// <param name="rhs">The value to add.</param>
@@ -100,7 +100,7 @@ public BezierKnot Transform(float4x4 matrix)
         }
 
         /// <summary>
-        /// Knot position subtraction. This operation only applies to the position, tangents and rotation are unmodified.
+        /// Subtracts a knot position. This operation applies only to the position and does not modify tangents or rotation.
         /// </summary>
         /// <param name="knot">The target knot.</param>
         /// <param name="rhs">The value to subtract.</param>

Editor/Utilities/SplineExtrudeUtility.cs

@@ -41,6 +41,7 @@ public static float3 EvaluatePosition(BezierCurve curve,  float t)
 
         /// <summary>
         /// Given a Bezier curve, return an interpolated tangent at ratio t.
+        /// The tangent is the rate of change of the position of the curve at point `t`, with respect to `t`. It is the derivative of the position with respect to `t`.
         /// </summary>
         /// <param name="curve">A cubic Bezier curve.</param>
         /// <param name="t">A value between 0 and 1 representing the ratio along the curve.</param>
@@ -61,6 +62,7 @@ public static float3 EvaluateTangent(BezierCurve curve, float t)
 
         /// <summary>
         /// Given a Bezier curve, return an interpolated acceleration at ratio t.
+        /// The acceleration is the rate of change of the tangent of the curve at point `t`, with respect to `t`. It represents the derivative of the tangent, or the second derivative of the position, with respect to `t`.
         /// </summary>
         /// <param name="curve">A cubic Bezier curve.</param>
         /// <param name="t">A value between 0 and 1 representing the ratio along the curve.</param>

Runtime/BezierKnot.cs

@@ -278,6 +278,7 @@ public IEnumerable<string> GetSplineDataKeys(EmbeddedSplineDataType type)
 
 #if UNITY_EDITOR
         internal static Action<Spline> afterSplineWasModified;
+        internal static Action<Spline> afterSplineWasModifiedSceneLoop;
         [NonSerialized]
         bool m_QueueAfterSplineModifiedCallback;
 #endif
@@ -313,6 +314,7 @@ internal void SetDirty(SplineModification modificationEvent, int knotIndex = k_B
 
             m_QueueAfterSplineModifiedCallback = true;
 
+            UnityEditor.SceneView.duringSceneGui += OnAfterSplineWasModifiedSceneLoop;
             UnityEditor.EditorApplication.delayCall += () =>
             {
                 m_QueueAfterSplineModifiedCallback = false;
@@ -321,6 +323,14 @@ internal void SetDirty(SplineModification modificationEvent, int knotIndex = k_B
 #endif
         }
 
+#if UNITY_EDITOR
+        private void OnAfterSplineWasModifiedSceneLoop(UnityEditor.SceneView sceneView)
+        {
+            UnityEditor.SceneView.duringSceneGui -= OnAfterSplineWasModifiedSceneLoop;
+            afterSplineWasModifiedSceneLoop?.Invoke(this);
+        }
+#endif
+
         /// <summary>
         /// Invoked any time a spline property is modified.
         /// </summary>