Refactor AutoPluginHelper to extend (Project => Project)

AutoPluginHelper now extends (Project => Project), making all helpers
directly usable as configuration functions without calling .configure.

Changes:
- AutoPluginHelper requires apply(project: Project): Project
- Simple helpers: renamed configure to apply
- Parameterized helpers: apply(project) delegates to apply()(project)
- OssumIncPlugin: With.* returns helper objects directly
- Updated all call sites to use helpers without .configure suffix

Usage:
- With.Scala3 works directly (no parentheses needed)
- With.Scala3() still works for default parameters
- With.Scala3.configure(version = Some("3.4.0")) for custom params

All 14 scripted tests pass. Backwards compatible to 0.22.2.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: reidspencer

build.sbt

@@ -21,9 +21,9 @@ lazy val `sbt-ossuminc` = project
   .in(file("."))
   .enablePlugins(SbtPlugin)
   .configure(RootProjectInfo.initialize("sbt-ossuminc", startYr = 2015))
-  .configure(DynamicVersioning.configure)
-  .configure(Scala2.configure)
-  .configure(GithubPublishing.configure)
+  .configure(DynamicVersioning)
+  .configure(Scala2)
+  .configure(GithubPublishing)
   .settings(
     sbtPlugin := true,
     licenses += "Apache V2.0" -> url("https://www.apache.org/licenses/LICENSE-2.0"),

project/SonatypePublishing.scala

@@ -35,7 +35,7 @@ object SonatypePublishing extends AutoPluginHelper {
 
   private val defaultSonatypeServer = "s01.oss.sonatype.org"
 
-  def configure(project: Project): Project =
+  def apply(project: Project): Project =
     project
       .enablePlugins(SonatypePlugin)
       .settings(

src/main/scala/com/ossuminc/sbt/DocSite.scala

@@ -41,7 +41,7 @@ object DocSite {
     Project
       .apply(dirName, file(dirName))
       .enablePlugins(OssumIncPlugin)
-      .configure(With.basic, With.scala3)
+      .configure(With.basic, With.Scala3)
       .configure(
         helpers.Unidoc.configure(
           outpath,

src/main/scala/com/ossuminc/sbt/OssumIncPlugin.scala

@@ -28,156 +28,186 @@ object OssumIncPlugin extends AutoPlugin {
     // Clauses to customize the major declarations
     object With {
 
-      def akka: ConfigFunc = helpers.Akka.configure
-
-      def Akka = helpers.Akka
+      // ===== PascalCase helpers (preferred) =====
 
       /** Use this to provide dependencies on most recent Akka libraries */
+      def Akka: helpers.Akka.type = helpers.Akka
 
       /** Use this to provide handy sbt command line aliases */
-      def aliases: ConfigFunc = helpers.HandyAliases.configure
-
-      /** Use this to configure AsciiDoc document generation for static websites and PDFs */
-      val AsciiDoc = helpers.AsciiDoc
+      def Aliases: helpers.HandyAliases.type = helpers.HandyAliases
 
-      /** Use this to have the build generate build information. "I know this because sbt knows
-        * this"
-        */
-      def build_info: ConfigFunc = helpers.BuildInfo.configure
+      /** Use this to configure AsciiDoc document generation */
+      val AsciiDoc: helpers.AsciiDoc.type = helpers.AsciiDoc
 
+      /** Use this to have the build generate build information */
       def BuildInfo: helpers.BuildInfo.type = helpers.BuildInfo
 
-      /** Configure the project to require a certain percentage of coverage in test cases */
-      def coverage(percent: Double = 50.0d)(project: Project): Project =
-        project
-          .configure(helpers.ScalaCoverage.configure)
-          .settings(
-            helpers.ScalaCoverage.Keys.coveragePercent := percent
-          )
-
-      /** Use dynamic versioning based on the most recent tag, and the commit hash and data/time
-        * stamp if necessary
-        */
-      def dynver: ConfigFunc = helpers.DynamicVersioning.configure
+      /** Use dynamic versioning based on git tags */
+      def DynVer: helpers.DynamicVersioning.type = helpers.DynamicVersioning
 
       /** Use this to get git command line support at the sbt prompt */
-      def git: ConfigFunc = helpers.Git.configure
+      def Git: helpers.Git.type = helpers.Git
 
-      /** Configure this project to be published as a Maven GitHub Package in the organization
-        * specified by Root
+      /** Configure publishing to GitHub Packages
         * @note
-        *   Do not combine this with SonatypePublishing
+        *   Do not combine with SonatypePublishing
         */
-      def GithubPublishing: ConfigFunc = helpers.GithubPublishing.configure
+      def GithubPublishing: helpers.GithubPublishing.type = helpers.GithubPublishing
 
-      /** Use this to get the `headerCheck` and `headerCreate` sbt commands to generate source file
-        * headers automatically
-        */
-      def header: ConfigFunc = helpers.Header.configure
+      /** Use this to manage source file headers automatically */
+      def Header: helpers.Header.type = helpers.Header
 
+      /** Configure IntelliJ IDEA plugin development */
       def IdeaPlugin: helpers.IdeaPlugin.type = helpers.IdeaPlugin
 
       /** Use this to enable compilation of Java code too */
-      def java: ConfigFunc = helpers.Java.configure
-
-      /** Use this to configure your project to compile Scala to ScalaJS via scala.js */
-      def ScalaJS: helpers.ScalaJS.type = helpers.ScalaJS
-      def scalajs: ConfigFunc = helpers.ScalaJS.configure
-
-      /** @deprecated Use ScalaJS instead - this alias will be removed in 2.0 */
-      @deprecated("Use ScalaJS instead", "1.0.0")
-      def Javascript: helpers.ScalaJS.type = helpers.ScalaJS
+      def Java: helpers.Java.type = helpers.Java
 
-      /** Use this to configure your project to include typical laminar dependencies */
+      /** Use this to configure Laminar dependencies */
       def Laminar: helpers.Laminar.type = helpers.Laminar
 
+      /** Configure binary compatibility checking */
       def MiMa: helpers.MiMa.type = helpers.MiMa
 
-      /** Use this to configure your project to build native code with Scala.Native */
+      /** Use this to build native code with Scala Native */
       def Native: helpers.Native.type = helpers.Native
 
-      /** Do not configure this project for Lightbend's Migration Manager */
-      def noMiMa: ConfigFunc = helpers.MiMa.without
-
-      /** Configure this project to produce no artifact and not be published */
-      def noPublishing(project: Project): Project =
-        project.settings(
-          publishArtifact := false, // no artifact to publish for the virtual root project
-          publish := {}, // just to be sure
-          publishLocal := {}, // and paranoid
-          publishTo := Some(Resolver.defaultLocal),
-          publish / skip := true
-        )
-
+      /** Configure sbt-native-packager */
       def Packaging: helpers.Packaging.type = helpers.Packaging
 
-      /** Configure this project to be published as open source
-        * @note
-        *   Do not combine this with SonatypePublishing
-        */
-      def SonatypePublishing: ConfigFunc = helpers.SonatypePublishing.configure
-
-      /** Configure this project to support releasing with a systematic release procedure */
-      def release: ConfigFunc = helpers.Release.configure
+      /** Configure the release process */
+      def Release: helpers.Release.type = helpers.Release
 
-      /** Add extra resolvers to the build for this project */
-      def resolvers: ConfigFunc = helpers.Resolvers.configure
+      /** Add extra resolvers to the build */
+      def Resolvers: helpers.Resolvers.type = helpers.Resolvers
 
-      /** Configure dependency on a version of the RIDDL library */
-      def riddl: ConfigFunc = helpers.Riddl.configure
-      def Riddl = helpers.Riddl
+      /** Configure dependency on RIDDL library */
+      def Riddl: helpers.Riddl.type = helpers.Riddl
 
       /** Compile scala code as Scala 2.13.latest */
-      def scala2: ConfigFunc = helpers.Scala2.configure
+      def Scala2: helpers.Scala2.type = helpers.Scala2
 
       /** Compile scala code as Scala 3's latest LTS release */
-      def scala3: ConfigFunc = helpers.Scala3.configure
+      def Scala3: helpers.Scala3.type = helpers.Scala3
+
+      /** Configure ScalablyTyped for TypeScript facades */
+      def ScalablyTyped: helpers.ScalablyTyped.type = helpers.ScalablyTyped
 
-      /** Configure this project to use standard Scalafmt formatting rules. */
+      /** Configure code coverage testing */
+      def ScalaCoverage: helpers.ScalaCoverage.type = helpers.ScalaCoverage
+
+      /** Configure standard Scalafmt formatting rules */
       def Scalafmt: helpers.Scalafmt.type = helpers.Scalafmt
 
-      /** Add scalaTest libraries to the libraryDependencies */
-      def Scalatest: helpers.Scalatest.type = helpers.Scalatest
+      /** Configure Scala.js compilation */
+      def ScalaJS: helpers.ScalaJS.type = helpers.ScalaJS
 
-      /** Configure this project to enable coverage testing */
-      def scoverage: ConfigFunc = helpers.ScalaCoverage.configure
+      /** Add ScalaTest libraries to the libraryDependencies */
+      def Scalatest: helpers.Scalatest.type = helpers.Scalatest
 
-      def ScalablyTyped: helpers.ScalablyTyped.type = helpers.ScalablyTyped
+      /** Configure publishing to Sonatype/Maven Central
+        * @note
+        *   Do not combine with GithubPublishing
+        */
+      def SonatypePublishing: helpers.SonatypePublishing.type = helpers.SonatypePublishing
 
+      /** Configure unified API documentation */
       def Unidoc: helpers.Unidoc.type = helpers.Unidoc
 
+      // ===== Deprecated lowercase aliases (will be removed in 2.0) =====
+
+      @deprecated("Use Akka instead", "1.1.0")
+      def akka: helpers.Akka.type = helpers.Akka
+
+      @deprecated("Use Aliases instead", "1.1.0")
+      def aliases: helpers.HandyAliases.type = helpers.HandyAliases
+
+      @deprecated("Use BuildInfo instead", "1.1.0")
+      def build_info: helpers.BuildInfo.type = helpers.BuildInfo
+
+      @deprecated("Use DynVer instead", "1.1.0")
+      def dynver: helpers.DynamicVersioning.type = helpers.DynamicVersioning
+
+      @deprecated("Use Git instead", "1.1.0")
+      def git: helpers.Git.type = helpers.Git
+
+      @deprecated("Use Header instead", "1.1.0")
+      def header: helpers.Header.type = helpers.Header
+
+      @deprecated("Use Java instead", "1.1.0")
+      def java: helpers.Java.type = helpers.Java
+
+      @deprecated("Use ScalaJS instead", "1.1.0")
+      def Javascript: helpers.ScalaJS.type = helpers.ScalaJS
+
+      @deprecated("Use Release instead", "1.1.0")
+      def release: helpers.Release.type = helpers.Release
+
+      @deprecated("Use Resolvers instead", "1.1.0")
+      def resolvers: helpers.Resolvers.type = helpers.Resolvers
+
+      @deprecated("Use Riddl instead", "1.1.0")
+      def riddl: helpers.Riddl.type = helpers.Riddl
+
+      @deprecated("Use Scala2 instead", "1.1.0")
+      def scala2: helpers.Scala2.type = helpers.Scala2
+
+      @deprecated("Use Scala3 instead", "1.1.0")
+      def scala3: helpers.Scala3.type = helpers.Scala3
+
+      @deprecated("Use ScalaJS instead", "1.1.0")
+      def scalajs: helpers.ScalaJS.type = helpers.ScalaJS
+
+      @deprecated("Use ScalaCoverage instead", "1.1.0")
+      def scoverage: helpers.ScalaCoverage.type = helpers.ScalaCoverage
+
+      // ===== Special helpers =====
+
+      /** Configure code coverage with minimum threshold */
+      def coverage(percent: Double = 50.0d)(project: Project): Project =
+        project
+          .configure(helpers.ScalaCoverage)
+          .settings(
+            helpers.ScalaCoverage.Keys.coveragePercent := percent
+          )
+
+      /** Do not configure binary compatibility checking */
+      def noMiMa: ConfigFunc = helpers.MiMa.without
+
+      /** Configure project to produce no artifact and not be published */
+      def noPublishing(project: Project): Project =
+        project.settings(
+          publishArtifact := false,
+          publish := {},
+          publishLocal := {},
+          publishTo := Some(Resolver.defaultLocal),
+          publish / skip := true
+        )
+
+      /** Apply multiple configuration functions */
       def these(cfuncs: ConfigFunc*)(project: Project): Project =
         cfuncs.foldLeft(project) { (p, func) =>
           p.configure(func)
         }
 
-      /** Use this to more easily configure:
-        *   - [[com.ossuminc.sbt.OssumIncPlugin.autoImport.With.aliases]],
-        *   - [[com.ossuminc.sbt.OssumIncPlugin.autoImport.With.dynver]]
-        *   - [[com.ossuminc.sbt.OssumIncPlugin.autoImport.With.git]]
-        *   - [[com.ossuminc.sbt.OssumIncPlugin.autoImport.With.header]]
-        *   - [[com.ossuminc.sbt.OssumIncPlugin.autoImport.With.resolvers]] more easily
-        */
-      def basic(project: Project): Project =
-        these(aliases, dynver, git, header, resolvers)(project)
+      // ===== Composite helpers =====
 
-      /** Configure support for all the simple things:
-        *   - [[com.ossuminc.sbt.OssumIncPlugin.autoImport.With.typical]]
-        *   - [[com.ossuminc.sbt.OssumIncPlugin.autoImport.With.java]]
-        *   - [[com.ossuminc.sbt.OssumIncPlugin.autoImport.With.build_info]]
-        *   - [[com.ossuminc.sbt.OssumIncPlugin.autoImport.With.release]]
-        */
-      def everything(project: Project): Project = {
-        project.configure(typical)
-        these(java, release)(project)
-      }
+      /** Configure: Aliases, DynVer, Git, Header, Resolvers */
+      def basic(project: Project): Project =
+        these(Aliases, DynVer, Git, Header, Resolvers)(project)
 
-      /** Use this to enable the [[basic]] features as well as [[scala3]] and [[build_info]] */
+      /** Configure: basic + Scala3 + Scalatest */
       def typical(project: Project): Project = {
         project
           .configure(basic)
-          .configure(scala3)
-          .configure(Scalatest())
+          .configure(Scala3)
+          .configure(Scalatest)
+      }
+
+      /** Configure: typical + Java + Release */
+      def everything(project: Project): Project = {
+        project.configure(typical)
+        these(Java, Release)(project)
       }
     }
   }

src/main/scala/com/ossuminc/sbt/Plugin.scala

@@ -31,7 +31,7 @@ object Plugin {
       .apply(dirName, file(dirName))
       .enablePlugins(OssumIncPlugin, SbtPlugin, JavaAppPackaging)
       .disablePlugins(ScoverageSbtPlugin)
-      .configure(With.basic, With.scala2, helpers.Scalafmt.configure, With.SonatypePublishing)
+      .configure(With.basic, With.Scala2, helpers.Scalafmt, With.SonatypePublishing)
       .settings(
         name := dirName,
         moduleName := { if (modName.isEmpty) dirName else modName },

src/main/scala/com/ossuminc/sbt/Root.scala

@@ -48,7 +48,7 @@ object Root {
           devs,
           spdx
         ),
-        helpers.Resolvers.configure
+        helpers.Resolvers
       )
   }
 }

src/main/scala/com/ossuminc/sbt/helpers/Akka.scala

@@ -142,5 +142,5 @@ object Akka extends AutoPluginHelper {
   }
 
   /** Configure Akka with latest release */
-  def configure(project: Project): Project = forRelease("")(project)
+  def apply(project: Project): Project = forRelease("")(project)
 }

src/main/scala/com/ossuminc/sbt/helpers/AsciiDoc.scala

@@ -31,7 +31,7 @@ object AsciiDoc extends AutoPluginHelper {
     * Enables both HTML and PDF generation from AsciiDoc sources located in src/asciidoc.
     * Generated HTML will be placed in target/site/asciidoc, and PDFs in target/asciidoc-pdf.
     */
-  def configure(project: Project): Project = apply()(project)
+  def apply(project: Project): Project = apply()(project)
 
   /** Configure AsciiDoc support with custom options
     *

src/main/scala/com/ossuminc/sbt/helpers/AutoPluginHelper.scala

@@ -18,19 +18,17 @@ package com.ossuminc.sbt.helpers
 
 import sbt.Project
 
-/** A Little Help For AutoPlugins This trait just provides some definitions and makes it easier to
-  * set up the plugin requirements. Just list the helpers upon which your plugin is dependent in the
-  * autoPlugins method and the rest is taken care of.
+/** A Little Help For AutoPlugins. This trait extends `(Project => Project)`
+  * so helpers can be used directly as configuration functions:
+  * `.configure(With.Scala3)` instead of `.configure(With.Scala3.configure)`.
   */
-trait AutoPluginHelper extends {
+trait AutoPluginHelper extends (Project => Project) {
 
-  /** The typical configuration function type for this helper
+  /** Apply this helper's configuration to a project.
     * @param project
     *   The project to which the configuration should be applied
     * @return
-    *   The same project passed as an argument, but modified with the configuration this helper
-    *   provides.
+    *   The same project with this helper's configuration applied.
     */
-
-  def configure(project: Project): Project
+  def apply(project: Project): Project
 }

src/main/scala/com/ossuminc/sbt/helpers/BuildInfo.scala

@@ -19,7 +19,7 @@ object BuildInfo extends AutoPluginHelper {
     * @return
     *   The same project passed as an argument, post configuration
     */
-  def configure(project: Project): Project = {
+  def apply(project: Project): Project = {
     val utcDate: String = java.time.Instant
       .now()
       .atZone(java.time.ZoneOffset.UTC)
@@ -79,7 +79,7 @@ object BuildInfo extends AutoPluginHelper {
     *   The keys and value to add to the BuildInfo output
     */
   def withKeys(keyValues: (String, Any)*)(project: Project): Project = {
-    configure(project).settings(
+    apply(project).settings(
       buildInfoKeys ++= { keyValues.map { case (k, v) => BuildInfoKey.action(k) { v } } }
     )
   }