[javadoc] Add interfaces for fragment reference PSI elements

IJ-MR-174748

GitOrigin-RevId: 0db4a62e4216d01f52e49dfbe68f94654709c097

java/java-psi-api/src/com/intellij/psi/javadoc/PsiDocFragmentName.java

@@ -0,0 +1,18 @@
+// Copyright 2000-2025 JetBrains s.r.o. and contributors. Use of this source code is governed by the Apache 2.0 license.
+package com.intellij.psi.javadoc;
+
+import com.intellij.psi.PsiClass;
+import com.intellij.psi.PsiElement;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * Represents the name of a fragment reference, for instance {@code my-id} in {@code Foo##my-id}.
+ */
+public interface PsiDocFragmentName extends PsiElement {
+
+  /**
+   * Returns the class that contains the fragment reference.
+   */
+  @Nullable PsiClass getScope();
+
+}

java/java-psi-api/src/com/intellij/psi/javadoc/PsiDocFragmentRef.java

@@ -0,0 +1,17 @@
+// Copyright 2000-2025 JetBrains s.r.o. and contributors. Use of this source code is governed by the Apache 2.0 license.
+package com.intellij.psi.javadoc;
+
+import com.intellij.psi.PsiClass;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * Represents a fragment reference, for instance {@code Foo##my-id}.
+ */
+public interface PsiDocFragmentRef extends PsiDocTagValue {
+
+  /**
+   * Returns the class that contains the fragment reference.
+   */
+  @Nullable PsiClass getScope();
+
+}