feat: add bump_per_commit option to control version increment behavior

When bump_per_commit is false, only apply a single +1 increment for the
highest bump level across all commits, matching standard semantic-release
behavior. Defaults to true to preserve backward compatibility.

Closes #11

Author: xotahal

lib/fastlane/plugin/semantic_release/actions/analyze_commits.rb

@@ -101,6 +101,18 @@ def self.get_beginning_of_next_sprint(params)
         }
       end
 
+      def self.clamp_version(next_major, next_minor, next_patch, base_major, base_minor, base_patch)
+        if next_major > base_major
+          [base_major + 1, 0, 0]
+        elsif next_minor > base_minor
+          [next_major, base_minor + 1, 0]
+        elsif next_patch > base_patch
+          [next_major, next_minor, base_patch + 1]
+        else
+          [next_major, next_minor, next_patch]
+        end
+      end
+
       def self.is_releasable(params)
         # Hash of the commit where is the last version
         beginning = get_beginning_of_next_sprint(params)
@@ -122,6 +134,11 @@ def self.is_releasable(params)
         next_minor = (version.split('.')[1] || 0).to_i
         next_patch = (version.split('.')[2] || 0).to_i
 
+        # Save base version for potential clamping
+        base_major = next_major
+        base_minor = next_minor
+        base_patch = next_patch
+
         is_next_version_compatible_with_codepush = true
 
         # Get commits log between last version and head
@@ -171,6 +188,11 @@ def self.is_releasable(params)
           UI.message("#{next_version}: #{subject}") if params[:show_version_path]
         end
 
+        # When bump_per_commit is false, clamp to single increment
+        unless params[:bump_per_commit]
+          next_major, next_minor, next_patch = clamp_version(next_major, next_minor, next_patch, base_major, base_minor, base_patch)
+        end
+
         next_version = "#{next_major}.#{next_minor}.#{next_patch}"
 
         is_next_version_releasable = Helper::SemanticReleaseHelper.semver_gt(next_version, version)
@@ -201,6 +223,9 @@ def self.is_codepush_friendly(params)
         next_major = 0
         next_minor = 0
         next_patch = 0
+        base_major = next_major
+        base_minor = next_minor
+        base_patch = next_patch
         last_incompatible_codepush_version = '0.0.0'
 
         if hash_lines.to_i > 1
@@ -246,6 +271,10 @@ def self.is_codepush_friendly(params)
           end
         end
 
+        unless params[:bump_per_commit]
+          next_major, next_minor, next_patch = clamp_version(next_major, next_minor, next_patch, base_major, base_minor, base_patch)
+        end
+
         Actions.lane_context[SharedValues::RELEASE_LAST_INCOMPATIBLE_CODEPUSH_VERSION] = last_incompatible_codepush_version
       end
 
@@ -353,6 +382,13 @@ def self.available_options
             default_value: false,
             type: Boolean,
             optional: true
+          ),
+          FastlaneCore::ConfigItem.new(
+            key: :bump_per_commit,
+            description: "When true (default), each fix/feat commit increments the version. When false, only bump once per release (matching semantic-release behavior)",
+            default_value: true,
+            type: Boolean,
+            optional: true
           )
         ]
       end

spec/analyze_commits_spec.rb

@@ -448,6 +448,65 @@ def execute_lane_test(params)
       end
     end
 
+    describe "bump_per_commit false" do
+      it "should increment patch only once for multiple fixes" do
+        commits = [
+          "fix: first fix|",
+          "fix: second fix|",
+          "fix: third fix|"
+        ]
+        test_analyze_commits(commits)
+
+        expect(execute_lane_test(match: 'v*', bump_per_commit: false)).to eq(true)
+        expect(Fastlane::Actions.lane_context[Fastlane::Actions::SharedValues::RELEASE_NEXT_VERSION]).to eq("1.0.9")
+      end
+
+      it "should increment minor only once for feat + fixes" do
+        commits = [
+          "feat: new feature|",
+          "fix: first fix|",
+          "fix: second fix|"
+        ]
+        test_analyze_commits(commits)
+
+        expect(execute_lane_test(match: 'v*', bump_per_commit: false)).to eq(true)
+        expect(Fastlane::Actions.lane_context[Fastlane::Actions::SharedValues::RELEASE_NEXT_VERSION]).to eq("1.1.0")
+      end
+
+      it "should increment minor only once for multiple feats" do
+        commits = [
+          "feat: feature one|",
+          "feat: feature two|"
+        ]
+        test_analyze_commits(commits)
+
+        expect(execute_lane_test(match: 'v*', bump_per_commit: false)).to eq(true)
+        expect(Fastlane::Actions.lane_context[Fastlane::Actions::SharedValues::RELEASE_NEXT_VERSION]).to eq("1.1.0")
+      end
+
+      it "should increment major only once for breaking + feat + fix" do
+        commits = [
+          "fix: ...|BREAKING CHANGE: something",
+          "feat: ...|",
+          "fix: ...|"
+        ]
+        test_analyze_commits(commits)
+
+        expect(execute_lane_test(match: 'v*', bump_per_commit: false)).to eq(true)
+        expect(Fastlane::Actions.lane_context[Fastlane::Actions::SharedValues::RELEASE_NEXT_VERSION]).to eq("2.0.0")
+      end
+
+      it "should return false when there is no releasable change" do
+        commits = [
+          "docs: update readme|",
+          "chore: cleanup|"
+        ]
+        test_analyze_commits(commits)
+
+        expect(execute_lane_test(match: 'v*', bump_per_commit: false)).to eq(false)
+      end
+    end
+
     after do
     end
   end