Implement filePathPattern in the script configuration with handling

also
- tests
- extending kdoc for the definitions

compiler/tests/org/jetbrains/kotlin/codegen/AbstractCustomScriptCodegenTest.kt

@@ -149,3 +149,7 @@ abstract class TestScriptWithSimpleEnvVars
 @Suppress("unused")
 @KotlinScript(fileExtension = "customext")
 abstract class TestScriptWithNonKtsExtension(val name: String)
+
+@Suppress("unused")
+@KotlinScript(filePathPattern = "(.*/)?pathPattern[0-9]\\..+")
+abstract class TestScriptWithPathPattern(val name2: String)

compiler/tests/org/jetbrains/kotlin/codegen/CustomScriptCodegenTestGenerated.java

@@ -29,6 +29,11 @@ public class CustomScriptCodegenTestGenerated extends AbstractCustomScriptCodege
         KotlinTestUtils.assertAllTestsPresentByMetadata(this.getClass(), new File("compiler/testData/codegen/customScript"), Pattern.compile("^(.*)$"), TargetBackend.ANY, true);
     }
 
+    @TestMetadata("pathPattern5.kts")
+    public void testPathPattern5_kts() throws Exception {
+        runTest("compiler/testData/codegen/customScript/pathPattern5.kts");
+    }
+
     @TestMetadata("simpleEnvVars.kts")
     public void testSimpleEnvVars_kts() throws Exception {
         runTest("compiler/testData/codegen/customScript/simpleEnvVars.kts");