nerdbank-gitversioning 3.8.118 → 3.9.15-alpha.gead5232f6d

package/nbgv.cli/tools/net8.0/any/Nerdbank.GitVersioning.xml

@@ -3525,6 +3525,11 @@
             Backing field for the <see cref="P:Nerdbank.GitVersioning.VersionOptions.BuildNumberOffset"/> property.
             </summary>
         </member>
+        <member name="F:Nerdbank.GitVersioning.VersionOptions.versionHeightOffsetAppliesTo">
+            <summary>
+            Backing field for the <see cref="P:Nerdbank.GitVersioning.VersionOptions.VersionHeightOffsetAppliesTo"/> property.
+            </summary>
+        </member>
         <member name="F:Nerdbank.GitVersioning.VersionOptions.semVer1NumericIdentifierPadding">
             <summary>
             Backing field for the <see cref="P:Nerdbank.GitVersioning.VersionOptions.SemVer1NumericIdentifierPadding"/> property.
@@ -3735,6 +3740,29 @@
             resulting in a negative build number.
             </remarks>
         </member>
+        <member name="P:Nerdbank.GitVersioning.VersionOptions.EffectiveVersionHeightOffset">
+            <summary>
+            Gets the effective version height offset, taking into account the <see cref="P:Nerdbank.GitVersioning.VersionOptions.VersionHeightOffsetAppliesTo"/> property.
+            </summary>
+            <returns>
+            The version height offset if it applies to the current version, or 0 if the version has changed
+            such that the offset should no longer be applied.
+            </returns>
+        </member>
+        <member name="P:Nerdbank.GitVersioning.VersionOptions.VersionHeightOffsetAppliesTo">
+            <summary>
+            Gets or sets the version to which the <see cref="P:Nerdbank.GitVersioning.VersionOptions.VersionHeightOffset"/> applies.
+            When the <see cref="P:Nerdbank.GitVersioning.VersionOptions.Version"/> property changes such that the version height would be reset,
+            and this property does not match the new version, the <see cref="P:Nerdbank.GitVersioning.VersionOptions.VersionHeightOffset"/> will be ignored.
+            </summary>
+            <value>A semantic version, or <see langword="null"/> to indicate no constraint.</value>
+            <remarks>
+            This property is typically used in conjunction with <see cref="P:Nerdbank.GitVersioning.VersionOptions.VersionHeightOffset"/> to ensure
+            that the offset is only applied when the version matches the expected version. When the version
+            changes such that the version height would reset, this property can be used to automatically
+            stop applying the offset without needing to manually remove it from all version.json files.
+            </remarks>
+        </member>
         <member name="P:Nerdbank.GitVersioning.VersionOptions.SemVer1NumericIdentifierPadding">
             <summary>
             Gets or sets the minimum number of digits to use for numeric identifiers in SemVer 1.
@@ -4593,6 +4621,12 @@
             when calculating the integer to use as the <see cref="P:Nerdbank.GitVersioning.VersionOracle.BuildNumber"/>
             or elsewhere that the {height} macro is used.
             </summary>
+            <remarks>
+            This property returns the effective version height offset, which takes into account
+            the <see cref="P:Nerdbank.GitVersioning.VersionOptions.VersionHeightOffsetAppliesTo"/> property. If that property
+            is set and the version has changed such that the version height would be reset, this
+            will return 0 instead of the configured offset.
+            </remarks>
         </member>
         <member name="P:Nerdbank.GitVersioning.VersionOracle.BuildingRef">
             <summary>

package/nbgv.cli/tools/net8.0/any/nbgv.deps.json

@@ -6,7 +6,7 @@
   "compilationOptions": {},
   "targets": {
     ".NETCoreApp,Version=v8.0": {
-      "nbgv/3.8.118": {
+      "nbgv/3.9.15-alpha-gead5232f6d": {
         "dependencies": {
           "CSharpIsNullAnalyzer": "0.1.593",
           "DotNetAnalyzers.DocumentationAnalyzers": "1.0.0-beta.59",
@@ -18,7 +18,7 @@
           "StyleCop.Analyzers.Unstable": "1.2.0.556",
           "System.CommandLine": "2.0.0-beta7.25380.108",
           "System.Diagnostics.Tools": "4.3.0",
-          "Nerdbank.GitVersioning": "3.8.118.27059"
+          "Nerdbank.GitVersioning": "3.9.15.60117"
         },
         "runtime": {
           "nbgv.dll": {}
@@ -739,23 +739,23 @@
         },
         "runtime": {
           "Nerdbank.GitVersioning.dll": {
-            "assemblyVersion": "3.8.118.27059",
-            "fileVersion": "3.8.118.27059"
+            "assemblyVersion": "3.9.15.60117",
+            "fileVersion": "3.9.15.60117"
           }
         }
       },
-      "Nerdbank.GitVersioning/3.8.118.27059": {
+      "Nerdbank.GitVersioning/3.9.15.60117": {
         "runtime": {
           "Nerdbank.GitVersioning.dll": {
-            "assemblyVersion": "3.8.118.27059",
-            "fileVersion": "3.8.118.27059"
+            "assemblyVersion": "3.9.15.60117",
+            "fileVersion": "3.9.15.60117"
           }
         }
       }
     }
   },
   "libraries": {
-    "nbgv/3.8.118": {
+    "nbgv/3.9.15-alpha-gead5232f6d": {
       "type": "project",
       "serviceable": false,
       "sha512": ""
@@ -1255,7 +1255,7 @@
       "serviceable": false,
       "sha512": ""
     },
-    "Nerdbank.GitVersioning/3.8.118.27059": {
+    "Nerdbank.GitVersioning/3.9.15.60117": {
       "type": "reference",
       "serviceable": false,
       "sha512": ""

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nerdbank-gitversioning",
-  "version": "3.8.118",
+  "version": "3.9.15-alpha.gead5232f6d",
   "description": "Stamps your NPM packages with semver 2.0 compliant git commit specific version information.",
   "author": {
     "name": "Andrew Arnott",