Mark directives as restricted or not

Author: romanowski

modules/directives/src/main/scala/scala/build/preprocessing/directives/DirectiveHandler.scala

@@ -24,6 +24,9 @@ trait DirectiveHandler[T] {
   def usageMd: String       = s"`$usage`"
   def examples: Seq[String] = Nil
 
+  /** Is this directive an advanved feature, that will not be accessible when running scala-cli as `scala` */
+  def isRestricted: Boolean
+
   def keys: Seq[String]
 
   def handleValues(

modules/directives/src/main/scala/scala/build/preprocessing/directives/RequireDirectiveHandler.scala

@@ -4,4 +4,6 @@ import scala.build.options.BuildRequirements
 
 trait RequireDirectiveHandler extends DirectiveHandler[BuildRequirements] {
   type ProcessedRequireDirective = ProcessedDirective[BuildRequirements]
+
+  override def isRestricted = true
 }

modules/directives/src/main/scala/scala/build/preprocessing/directives/UsingCompilerPluginDirectiveHandler.scala

@@ -16,6 +16,7 @@ case object UsingCompilerPluginDirectiveHandler extends UsingDirectiveHandler {
   override def examples = Seq(
     "//> using plugin \"org.typelevel:::kind-projector:0.13.2\""
   )
+  override def isRestricted = true
 
   private def parseDependency(depStr: String): Either[BuildException, AnyDependency] =
     DependencyParser.parse(depStr)

modules/directives/src/main/scala/scala/build/preprocessing/directives/UsingCustomJarDirectiveHandler.scala

@@ -17,6 +17,7 @@ case object UsingCustomJarDirectiveHandler extends UsingDirectiveHandler {
   override def examples = Seq(
     "//> using jar \"/Users/alexandre/Library/Caches/Coursier/v1/https/repo1.maven.org/maven2/com/chuusai/shapeless_2.13/2.3.7/shapeless_2.13-2.3.7.jar\""
   )
+  override def isRestricted = true
 
   def keys = Seq("jar", "jars")
   def handleValues(

modules/directives/src/main/scala/scala/build/preprocessing/directives/UsingDependencyDirectiveHandler.scala

@@ -18,6 +18,7 @@ case object UsingDependencyDirectiveHandler extends UsingDirectiveHandler {
     "//> using lib \"org.scalameta::munit:0.7.29\"",
     "//> using lib \"tabby:tabby:0.2.3,url=https://github.com/bjornregnell/tabby/releases/download/v0.2.3/tabby_3-0.2.3.jar\""
   )
+  override def isRestricted = true
 
   private def parseDependency(depStr: String): Either[BuildException, AnyDependency] =
     DependencyParser.parse(depStr)

modules/directives/src/main/scala/scala/build/preprocessing/directives/UsingJavaHomeDirectiveHandler.scala

@@ -15,6 +15,7 @@ case object UsingJavaHomeDirectiveHandler extends UsingDirectiveHandler {
   override def examples = Seq(
     "//> using java-home \"/Users/Me/jdks/11\""
   )
+  override def isRestricted = true
 
   override def getValueNumberBounds(key: String): UsingDirectiveValueNumberBounds =
     UsingDirectiveValueNumberBounds(1, 1)

modules/directives/src/main/scala/scala/build/preprocessing/directives/UsingJavaOptionsDirectiveHandler.scala

@@ -14,6 +14,7 @@ case object UsingJavaOptionsDirectiveHandler extends UsingDirectiveHandler {
   override def examples = Seq(
     "//> using javaOpt \"-Xmx2g\", \"-Dsomething=a\""
   )
+  override def isRestricted = true
 
   def keys = Seq("javaOpt", "javaOptions", "java-opt", "java-options")
   def handleValues(

modules/directives/src/main/scala/scala/build/preprocessing/directives/UsingJavaPropsDirectiveHandler.scala

@@ -13,6 +13,7 @@ case object UsingJavaPropsDirectiveHandler extends UsingDirectiveHandler {
   override def examples = Seq(
     "//> using javaProp \"foo1=bar\", \"foo2\""
   )
+  override def isRestricted = true
 
   def keys = Seq("javaProp")
   def handleValues(

modules/directives/src/main/scala/scala/build/preprocessing/directives/UsingMainClassDirectiveHandler.scala

@@ -22,6 +22,8 @@ case object UsingMainClassDirectiveHandler extends UsingDirectiveHandler {
 
   def keys = Seq("main-class", "mainClass")
 
+  override def isRestricted = true
+
   override def getValueNumberBounds(key: String) = UsingDirectiveValueNumberBounds(1, 1)
 
   def handleValues(

modules/directives/src/main/scala/scala/build/preprocessing/directives/UsingOptionDirectiveHandler.scala

@@ -15,6 +15,7 @@ case object UsingOptionDirectiveHandler extends UsingDirectiveHandler {
     "//> using option \"-Xasync\"",
     "//> using options \"-Xasync\", \"-Xfatal-warnings\""
   )
+  override def isRestricted = true
 
   def keys = Seq("option", "options")
   def handleValues(