scope to classes and interfaces

Author: panteliselef

.typedoc/custom-plugin.mjs

@@ -83,19 +83,6 @@ function getRelativeLinkReplacements() {
 
 function getCatchAllReplacements() {
   return [
-    // Robustly remove the full Experimental section (including optional Example/code block)
-    // from the first "**`Experimental`**" until the next heading (## ...) or end of file.
-    // This covers variations in wording/whitespace and ensures the block is stripped.
-    {
-      pattern: /(?:^|\r?\n)\*\*`Experimental`\*\*[\s\S]*?(?=(?:\r?\n##\s)|$)/g,
-      replace: '',
-    },
-    // As a safeguard, remove any leftover Example section that specifically shows ClerkProvider clerkJsVersion snippet
-    {
-      pattern:
-        /(?:^|\r?\n)## Example\r?\n(?:\r?\n)?```tsx[\s\S]*?ClerkProvider\s+clerkJsVersion="[^"]*"[\s\S]*?```(?:\r?\n)?/g,
-      replace: '',
-    },
     {
       pattern: /\(setActiveParams\)/g,
       replace: '([setActiveParams](/docs/references/javascript/types/set-active-params))',

.typedoc/custom-theme.mjs

@@ -52,12 +52,18 @@ class ClerkMarkdownThemeContext extends MarkdownThemeContext {
        * @param {{ headingLevel?: number; showSummary?: boolean; showTags?: boolean; showReturns?: boolean; isTableColumn?: boolean }} [options]
        */
       comment: (model, options) => {
-        if (model?.modifierTags.has('@experimental')) {
-          const originalBlockTags = model.blockTags;
-          model.blockTags = model.blockTags.filter(tag => tag.name !== '@example');
+        if (
+          model.hasModifier('@experimental') &&
+          [ReflectionKind.Class, ReflectionKind.Interface].includes(this.page?.model?.kind)
+        ) {
+          model.removeModifier('@experimental');
+          model.removeTags('@example');
+          model.removeTags('@see');
+
           const res = superPartials.comment(model, options);
-          model.blockTags = originalBlockTags;
-          return res;
+
+          const [line, ...linesToInclude] = res.replace(/^\n\n/, '').split('\n');
+          return linesToInclude.join('\n');
         }
         return superPartials.comment(model, options);
       },