[JEWEL-1277] Add FrontMatter metadata block support for Markdown

BUILD.bazel

@@ -963,6 +963,8 @@ jvm_library(
     "//platform/jewel/markdown/core:jewel-markdown-core-tests_test_lib",
     "//platform/jewel/markdown/extensions/autolink:jewel-markdown-extensions-autolink-tests",
     "//platform/jewel/markdown/extensions/autolink:jewel-markdown-extensions-autolink-tests_test_lib",
+    "//platform/jewel/markdown/extensions/front-matter:jewel-markdown-extensions-frontMatter-tests",
+    "//platform/jewel/markdown/extensions/front-matter:jewel-markdown-extensions-frontMatter-tests_test_lib",
     "//platform/jewel/markdown/extensions/gfm-alerts:jewel-markdown-extensions-gfmAlerts-tests",
     "//platform/jewel/markdown/extensions/gfm-alerts:jewel-markdown-extensions-gfmAlerts-tests_test_lib",
     "//platform/jewel/markdown/extensions/gfm-tables:jewel-markdown-extensions-gfmTables-tests",

build/bazel-generated-file-list.txt

@@ -656,6 +656,7 @@ platform/jewel/int-ui/int-ui-standalone
 platform/jewel/int-ui/int-ui-standalone-tests
 platform/jewel/markdown/core
 platform/jewel/markdown/extensions/autolink
+platform/jewel/markdown/extensions/front-matter
 platform/jewel/markdown/extensions/gfm-alerts
 platform/jewel/markdown/extensions/gfm-strikethrough
 platform/jewel/markdown/extensions/gfm-tables

intellij.idea.community.main.tests.iml

@@ -210,6 +210,7 @@
     <orderEntry type="module" module-name="intellij.platform.jewel.ideLafBridge.tests" scope="TEST" />
     <orderEntry type="module" module-name="intellij.platform.jewel.markdown.core.tests" scope="TEST" />
     <orderEntry type="module" module-name="intellij.platform.jewel.markdown.extensions.autolink.tests" scope="TEST" />
+    <orderEntry type="module" module-name="intellij.platform.jewel.markdown.extensions.frontMatter.tests" scope="TEST" />
     <orderEntry type="module" module-name="intellij.platform.jewel.markdown.extensions.gfmAlerts.tests" scope="TEST" />
     <orderEntry type="module" module-name="intellij.platform.jewel.markdown.extensions.gfmTables.tests" scope="TEST" />
     <orderEntry type="module" module-name="intellij.platform.jewel.markdown.extensions.images.tests" scope="TEST" />

platform/build-scripts/src/org/jetbrains/intellij/build/productLayout/CommunityModuleSets.kt

@@ -320,6 +320,7 @@ object CommunityModuleSets {
     module("intellij.platform.jewel.markdown.extensions.gfmAlerts")
     module("intellij.platform.jewel.markdown.extensions.gfmTables")
     module("intellij.platform.jewel.markdown.extensions.gfmStrikethrough")
+    module("intellij.platform.jewel.markdown.extensions.frontMatter")
     module("intellij.platform.jewel.markdown.extensions.images")
     module("intellij.platform.jewel.markdown.core")
   }

platform/compose/markdown/BUILD.bazel

@@ -19,6 +19,7 @@ jvm_library(
     "//platform/jewel/markdown/extensions/autolink",
     "//platform/jewel/markdown/extensions/gfm-alerts",
     "//platform/jewel/markdown/extensions/gfm-strikethrough",
+    "//platform/jewel/markdown/extensions/front-matter",
     "//platform/jewel/markdown/extensions/gfm-tables",
     "//platform/jewel/markdown/extensions/images",
     "//platform/jewel/markdown/ide-laf-bridge-styling",
@@ -29,6 +30,7 @@ jvm_library(
     "//platform/jewel/markdown/extensions/autolink",
     "//platform/jewel/markdown/extensions/gfm-alerts",
     "//platform/jewel/markdown/extensions/gfm-strikethrough",
+    "//platform/jewel/markdown/extensions/front-matter",
     "//platform/jewel/markdown/extensions/gfm-tables",
     "//platform/jewel/markdown/extensions/images",
     "//platform/jewel/markdown/ide-laf-bridge-styling",
@@ -52,6 +54,8 @@ jvm_library(
     "//platform/jewel/markdown/extensions/gfm-alerts:gfm-alerts_test_lib",
     "//platform/jewel/markdown/extensions/gfm-strikethrough",
     "//platform/jewel/markdown/extensions/gfm-strikethrough:gfm-strikethrough_test_lib",
+    "//platform/jewel/markdown/extensions/front-matter",
+    "//platform/jewel/markdown/extensions/front-matter:front-matter_test_lib",
     "//platform/jewel/markdown/extensions/gfm-tables",
     "//platform/jewel/markdown/extensions/gfm-tables:gfm-tables_test_lib",
     "//platform/jewel/markdown/extensions/images",
@@ -66,6 +70,7 @@ jvm_library(
     "//platform/jewel/markdown/extensions/autolink:autolink_test_lib",
     "//platform/jewel/markdown/extensions/gfm-alerts:gfm-alerts_test_lib",
     "//platform/jewel/markdown/extensions/gfm-strikethrough:gfm-strikethrough_test_lib",
+    "//platform/jewel/markdown/extensions/front-matter:front-matter_test_lib",
     "//platform/jewel/markdown/extensions/gfm-tables:gfm-tables_test_lib",
     "//platform/jewel/markdown/extensions/images:images_test_lib",
     "//platform/jewel/markdown/ide-laf-bridge-styling:ide-laf-bridge-styling_test_lib",

platform/compose/markdown/intellij.platform.compose.markdown.iml

@@ -33,6 +33,7 @@
     <orderEntry type="module" module-name="intellij.platform.jewel.markdown.extensions.autolink" exported="" />
     <orderEntry type="module" module-name="intellij.platform.jewel.markdown.extensions.gfmAlerts" exported="" />
     <orderEntry type="module" module-name="intellij.platform.jewel.markdown.extensions.gfmStrikethrough" exported="" />
+    <orderEntry type="module" module-name="intellij.platform.jewel.markdown.extensions.frontMatter" exported="" />
     <orderEntry type="module" module-name="intellij.platform.jewel.markdown.extensions.gfmTables" exported="" />
     <orderEntry type="module" module-name="intellij.platform.jewel.markdown.extensions.images" exported="" />
     <orderEntry type="module" module-name="intellij.platform.jewel.markdown.ideLafBridgeStyling" exported="" />

platform/compose/markdown/resources/intellij.platform.compose.markdown.xml

@@ -6,6 +6,7 @@
     <module name="intellij.platform.jewel.markdown.extensions.autolink" />
     <module name="intellij.platform.jewel.markdown.extensions.images" />
     <module name="intellij.platform.jewel.markdown.extensions.gfmAlerts" />
+    <module name="intellij.platform.jewel.markdown.extensions.frontMatter" />
     <module name="intellij.platform.jewel.markdown.extensions.gfmTables" />
     <module name="intellij.platform.jewel.markdown.extensions.gfmStrikethrough" />
   </dependencies>

platform/jewel/markdown/extensions/front-matter/BUILD.bazel

@@ -0,0 +1,144 @@
+### auto-generated section `build intellij.platform.jewel.markdown.extensions.frontMatter` start
+load("//build:compiler-options.bzl", "create_kotlinc_options")
+load("@rules_jvm//:jvm.bzl", "jvm_library", "resourcegroup")
+
+create_kotlinc_options(
+  name = "custom_front-matter",
+  opt_in = [
+    "androidx.compose.ui.ExperimentalComposeUiApi",
+    "androidx.compose.foundation.ExperimentalFoundationApi",
+    "org.jetbrains.jewel.foundation.ExperimentalJewelApi",
+    "org.jetbrains.jewel.foundation.InternalJewelApi",
+  ],
+  x_context_parameters = True,
+  x_explicit_api_mode = "strict"
+)
+
+resourcegroup(
+  name = "front-matter_resources",
+  srcs = glob(["src/main/resources/**/*"]),
+  strip_prefix = "src/main/resources"
+)
+
+jvm_library(
+  name = "front-matter",
+  module_name = "intellij.platform.jewel.markdown.extensions.frontMatter",
+  visibility = ["//visibility:public"],
+  srcs = glob(["src/main/kotlin/**/*.kt", "src/main/kotlin/**/*.java", "src/main/kotlin/**/*.form"], allow_empty = True),
+  resources = [":front-matter_resources"],
+  kotlinc_opts = ":custom_front-matter",
+  deps = [
+    "@lib//:kotlin-stdlib",
+    "//libraries/kotlinx/coroutines/core",
+    "@lib//:jetbrains-annotations",
+    "//platform/jewel/markdown/core",
+    "//platform/jewel/markdown/extensions/gfm-tables",
+    "//platform/jewel/ui",
+    "//platform/jewel/foundation",
+    "//libraries/compose-foundation-desktop",
+    "//libraries/compose-runtime-desktop",
+  ],
+  plugins = ["@lib//:compose-plugin"]
+)
+
+jvm_library(
+  name = "front-matter_test_lib",
+  module_name = "intellij.platform.jewel.markdown.extensions.frontMatter",
+  visibility = ["//visibility:public"],
+  srcs = glob([], allow_empty = True),
+  kotlinc_opts = ":custom_front-matter",
+  runtime_deps = [
+    ":front-matter",
+    "//libraries/kotlinx/coroutines/core:core_test_lib",
+    "//platform/jewel/markdown/core:core_test_lib",
+    "//platform/jewel/markdown/extensions/gfm-tables:gfm-tables_test_lib",
+    "//platform/jewel/ui:ui_test_lib",
+    "//platform/jewel/foundation:foundation_test_lib",
+    "//libraries/compose-foundation-desktop:compose-foundation-desktop_test_lib",
+    "//libraries/compose-runtime-desktop:compose-runtime-desktop_test_lib",
+    "//libraries/compose-foundation-desktop-junit",
+    "//libraries/compose-foundation-desktop-junit:compose-foundation-desktop-junit_test_lib",
+    "//libraries/junit4",
+    "//libraries/junit4:junit4_test_lib",
+  ],
+  plugins = ["@lib//:compose-plugin"]
+)
+### auto-generated section `build intellij.platform.jewel.markdown.extensions.frontMatter` end
+
+### auto-generated section `iml intellij.platform.jewel.markdown.extensions.frontMatter` start
+exports_files([
+  "intellij.platform.jewel.markdown.extensions.frontMatter.iml",
+], visibility = ["//visibility:public"])
+### auto-generated section `iml intellij.platform.jewel.markdown.extensions.frontMatter` end
+
+### auto-generated section `build intellij.platform.jewel.markdown.extensions.frontMatter.tests` start
+create_kotlinc_options(
+  name = "custom_jewel-markdown-extensions-frontMatter-tests",
+  opt_in = [
+    "androidx.compose.ui.ExperimentalComposeUiApi",
+    "androidx.compose.foundation.ExperimentalFoundationApi",
+    "org.jetbrains.jewel.foundation.ExperimentalJewelApi",
+    "org.jetbrains.jewel.foundation.InternalJewelApi",
+  ],
+  x_context_parameters = True,
+  x_explicit_api_mode = "strict"
+)
+
+jvm_library(
+  name = "jewel-markdown-extensions-frontMatter-tests",
+  module_name = "intellij.platform.jewel.markdown.extensions.frontMatter.tests",
+  visibility = ["//visibility:public"],
+  srcs = glob([], allow_empty = True),
+  plugins = ["@lib//:compose-plugin"]
+)
+
+jvm_library(
+  name = "jewel-markdown-extensions-frontMatter-tests_test_lib",
+  visibility = ["//visibility:public"],
+  srcs = glob(["src/test/kotlin/**/*.kt", "src/test/kotlin/**/*.java", "src/test/kotlin/**/*.form"], allow_empty = True),
+  kotlinc_opts = ":custom_jewel-markdown-extensions-frontMatter-tests",
+  associates = [
+    "//platform/jewel/markdown/extensions/front-matter",
+    "//platform/jewel/markdown/extensions/front-matter:front-matter_test_lib",
+  ],
+  deps = [
+    "@lib//:kotlin-stdlib",
+    "//libraries/kotlinx/coroutines/core",
+    "//libraries/kotlinx/coroutines/core:core_test_lib",
+    "@lib//:jetbrains-annotations",
+    "//platform/jewel/markdown/core",
+    "//platform/jewel/markdown/core:core_test_lib",
+    "//platform/jewel/markdown/extensions/gfm-tables",
+    "//platform/jewel/markdown/extensions/gfm-tables:gfm-tables_test_lib",
+    "//platform/jewel/ui",
+    "//platform/jewel/ui:ui_test_lib",
+    "//platform/jewel/foundation",
+    "//platform/jewel/foundation:foundation_test_lib",
+    "//libraries/compose-foundation-desktop",
+    "//libraries/compose-foundation-desktop:compose-foundation-desktop_test_lib",
+    "//libraries/compose-runtime-desktop",
+    "//libraries/compose-runtime-desktop:compose-runtime-desktop_test_lib",
+    "//libraries/compose-foundation-desktop-junit",
+    "//libraries/compose-foundation-desktop-junit:compose-foundation-desktop-junit_test_lib",
+    "//libraries/junit4",
+    "//libraries/junit4:junit4_test_lib",
+  ],
+  runtime_deps = [":jewel-markdown-extensions-frontMatter-tests"],
+  plugins = ["@lib//:compose-plugin"]
+)
+### auto-generated section `build intellij.platform.jewel.markdown.extensions.frontMatter.tests` end
+
+### auto-generated section `iml intellij.platform.jewel.markdown.extensions.frontMatter.tests` start
+exports_files([
+  "intellij.platform.jewel.markdown.extensions.frontMatter.tests.iml",
+], visibility = ["//visibility:public"])
+### auto-generated section `iml intellij.platform.jewel.markdown.extensions.frontMatter.tests` end
+
+### auto-generated section `test intellij.platform.jewel.markdown.extensions.frontMatter.tests` start
+load("@community//build:tests-options.bzl", "jps_test")
+
+jps_test(
+  name = "jewel-markdown-extensions-frontMatter-tests_test",
+  runtime_deps = [":jewel-markdown-extensions-frontMatter-tests_test_lib"]
+)
+### auto-generated section `test intellij.platform.jewel.markdown.extensions.frontMatter.tests` end

platform/jewel/markdown/extensions/front-matter/api-dump-experimental.txt

@@ -0,0 +1,7 @@
+*f:org.jetbrains.jewel.markdown.extensions.frontmatter.FrontMatterProcessorExtension
+- org.jetbrains.jewel.markdown.extensions.MarkdownProcessorExtension
+- sf:$stable:I
+- sf:INSTANCE:org.jetbrains.jewel.markdown.extensions.frontmatter.FrontMatterProcessorExtension
+- getBlockProcessorExtension():org.jetbrains.jewel.markdown.extensions.MarkdownBlockProcessorExtension
+- getParserExtension():org.commonmark.parser.Parser$ParserExtension
+- getTextRendererExtension():org.commonmark.renderer.text.TextContentRenderer$TextContentRendererExtension

platform/jewel/markdown/extensions/front-matter/build.gradle.kts

@@ -0,0 +1,21 @@
+import org.jetbrains.kotlin.compose.compiler.gradle.ComposeFeatureFlag
+
+plugins {
+    jewel
+    `jewel-check-public-api`
+    alias(libs.plugins.composeDesktop)
+    alias(libs.plugins.compose.compiler)
+}
+
+dependencies {
+    implementation(projects.markdown.core)
+    implementation(projects.markdown.extensions.gfmTables)
+
+    testImplementation(compose.desktop.uiTestJUnit4)
+}
+
+publicApiValidation {
+    excludedClassRegexes = setOf("org.jetbrains.jewel.markdown.extensions.frontmatter.*")
+}
+
+composeCompiler { featureFlags.add(ComposeFeatureFlag.OptimizeNonSkippingGroups) }

platform/jewel/markdown/extensions/front-matter/exposed-third-party-api.txt

@@ -0,0 +1 @@
+org/commonmark/**

platform/jewel/markdown/extensions/front-matter/intellij.platform.jewel.markdown.extensions.frontMatter.iml

@@ -0,0 +1,46 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="JAVA_MODULE" version="4">
+  <component name="FacetManager">
+    <facet type="kotlin-language" name="Kotlin">
+      <configuration version="5" platform="JVM 21" allPlatforms="JVM [21]" useProjectSettings="false">
+        <compilerSettings>
+          <option name="additionalArguments" value="-Xjvm-default=all -opt-in=androidx.compose.ui.ExperimentalComposeUiApi -Xcontext-parameters -opt-in=androidx.compose.foundation.ExperimentalFoundationApi -opt-in=org.jetbrains.jewel.foundation.ExperimentalJewelApi -opt-in=org.jetbrains.jewel.foundation.InternalJewelApi -Xexplicit-api=strict -XXLanguage:+AllowEagerSupertypeAccessibilityChecks -progressive" />
+        </compilerSettings>
+        <compilerArguments>
+          <stringArguments>
+            <stringArg name="jvmTarget" arg="21" />
+            <stringArg name="apiVersion" arg="2.3" />
+            <stringArg name="languageVersion" arg="2.3" />
+          </stringArguments>
+          <arrayArguments>
+            <arrayArg name="pluginClasspaths">
+              <args>$MAVEN_REPOSITORY$/org/jetbrains/kotlin/kotlin-compose-compiler-plugin/2.3.20/kotlin-compose-compiler-plugin-2.3.20.jar</args>
+            </arrayArg>
+          </arrayArguments>
+        </compilerArguments>
+      </configuration>
+    </facet>
+  </component>
+  <component name="NewModuleRootManager" inherit-compiler-output="true">
+    <exclude-output />
+    <content url="file://$MODULE_DIR$">
+      <sourceFolder url="file://$MODULE_DIR$/src/main/resources" type="java-resource" />
+      <sourceFolder url="file://$MODULE_DIR$/src/main/kotlin" isTestSource="false" />
+      <excludeFolder url="file://$MODULE_DIR$/bin" />
+      <excludeFolder url="file://$MODULE_DIR$/build" />
+    </content>
+    <orderEntry type="inheritedJdk" />
+    <orderEntry type="library" name="kotlin-stdlib" level="project" />
+    <orderEntry type="module" module-name="intellij.libraries.kotlinx.coroutines.core" />
+    <orderEntry type="library" name="jetbrains-annotations" level="project" />
+    <orderEntry type="sourceFolder" forTests="false" />
+    <orderEntry type="module" module-name="intellij.platform.jewel.markdown.core" />
+    <orderEntry type="module" module-name="intellij.platform.jewel.markdown.extensions.gfmTables" />
+    <orderEntry type="module" module-name="intellij.platform.jewel.ui" />
+    <orderEntry type="module" module-name="intellij.platform.jewel.foundation" />
+    <orderEntry type="module" module-name="intellij.libraries.compose.foundation.desktop" />
+    <orderEntry type="module" module-name="intellij.libraries.compose.runtime.desktop" />
+    <orderEntry type="module" module-name="intellij.libraries.compose.foundation.desktop.junit" scope="TEST" />
+    <orderEntry type="module" module-name="intellij.libraries.junit4" scope="TEST" />
+  </component>
+</module>