feat: expand search badges to classify plain, legacy, and shared results

Extends the search-tags plugin beyond legacy-only badges. Search results
now show color-coded badges based on URL pattern classification:
- green "plain" for plain client methods (recommended API)
- gray "legacy" for chainable wrapper interfaces and create-*-api modules
- blue "shared" for data type definitions (Props, Sys, etc.)

Wrapper interfaces under entities/ are detected by converting the
directory name to PascalCase and matching the filename.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

Author: michaelphamcf

docs/plugins/search-tags/search-tags.css

@@ -1,4 +1,6 @@
-.search-tag-legacy {
+.search-tag-legacy,
+.search-tag-plain,
+.search-tag-shared {
   display: inline-block;
   margin-left: 0.5em;
   padding: 0.05em 0.4em;
@@ -7,21 +9,58 @@
   line-height: 1.4;
   border-radius: 3px;
   vertical-align: middle;
+  opacity: 0.8;
+  pointer-events: none;
+}
+
+.search-tag-legacy {
   color: var(--color-text-aside, #6e7781);
   background: var(--color-background-secondary, rgba(0, 0, 0, 0.06));
   border: 1px solid var(--color-accent, rgba(0, 0, 0, 0.08));
-  opacity: 0.8;
-  pointer-events: none;
+}
+
+.search-tag-plain {
+  color: #1a7f37;
+  background: rgba(26, 127, 55, 0.08);
+  border: 1px solid rgba(26, 127, 55, 0.2);
+}
+
+.search-tag-shared {
+  color: #0969da;
+  background: rgba(9, 105, 218, 0.08);
+  border: 1px solid rgba(9, 105, 218, 0.2);
 }
 
 [data-theme='dark'] .search-tag-legacy {
   background: rgba(255, 255, 255, 0.08);
   border-color: rgba(255, 255, 255, 0.1);
 }
 
+[data-theme='dark'] .search-tag-plain {
+  color: #3fb950;
+  background: rgba(63, 185, 80, 0.12);
+  border-color: rgba(63, 185, 80, 0.25);
+}
+
+[data-theme='dark'] .search-tag-shared {
+  color: #58a6ff;
+  background: rgba(88, 166, 255, 0.12);
+  border-color: rgba(88, 166, 255, 0.25);
+}
+
 @media (prefers-color-scheme: dark) {
   .search-tag-legacy:not([data-theme='light'] *) {
     background: rgba(255, 255, 255, 0.08);
     border-color: rgba(255, 255, 255, 0.1);
   }
+  .search-tag-plain:not([data-theme='light'] *) {
+    color: #3fb950;
+    background: rgba(63, 185, 80, 0.12);
+    border-color: rgba(63, 185, 80, 0.25);
+  }
+  .search-tag-shared:not([data-theme='light'] *) {
+    color: #58a6ff;
+    background: rgba(88, 166, 255, 0.12);
+    border-color: rgba(88, 166, 255, 0.25);
+  }
 }

docs/plugins/search-tags/search-tags.js

@@ -1,18 +1,48 @@
 /**
- * Search result tagger — adds visual badges to legacy client results so users
- * can distinguish plain client methods from legacy chainable methods at a glance.
+ * Search result tagger — adds visual badges so users can distinguish plain
+ * client, legacy client, and shared type results at a glance.
  *
- * Detection uses the href on each result's <a> element:
- *   - entities/<type>/<Wrapper>.html#<method>  → legacy wrapper method (inherited)
- *   - create-*-api                             → legacy module page
+ * Classification uses the href on each result's <a> element:
+ *   - create-*-api                              → legacy
+ *   - *PlainClientAPI*                          → plain
+ *   - entities/{dir}/{WrapperInterface}.html    → legacy
+ *   - entities/... (everything else)            → shared
+ *   - plain/...                                 → plain
+ *   - top-level {entity}.html                   → plain
  *
  * Injected inline by typedoc-search-tags.mjs via the head.end hook.
  */
 
 ;(function () {
   'use strict'
 
-  var LEGACY_URL_PATTERN = /^(?:entities\/|create-)/
+  var SKIP_TOP_LEVEL = /^(index|modules|common-types|getting-started|shared-types|hierarchy)(\.|$)/
+
+  function toPascalCase(kebab) {
+    return kebab.replace(/(^|-)([a-z])/g, function (_, _sep, ch) {
+      return ch.toUpperCase()
+    })
+  }
+
+  function classify(rel) {
+    if (/^create-/.test(rel)) return 'legacy'
+    if (rel.indexOf('PlainClientAPI') !== -1) return 'plain'
+
+    if (/^entities\//.test(rel)) {
+      var parts = rel.replace(/#.*$/, '').split('/')
+      if (parts.length >= 3) {
+        var dir = parts[1]
+        var file = parts[2].replace(/\.html$/, '')
+        if (file === toPascalCase(dir)) return 'legacy'
+      }
+      return 'shared'
+    }
+
+    if (/^plain\//.test(rel)) return 'plain'
+    if (/^[a-z][a-z0-9-]*\.html/.test(rel) && !SKIP_TOP_LEVEL.test(rel)) return 'plain'
+
+    return null
+  }
 
   function tagResults(list) {
     var items = list.querySelectorAll('li')
@@ -24,18 +54,18 @@
       var anchor = li.querySelector('a')
       if (!anchor) continue
 
-      // Extract the relative path portion of the href
       var href = anchor.getAttribute('href') || ''
       var base = document.documentElement.dataset.base || './'
       var rel = href
       if (href.indexOf(base) === 0) {
         rel = href.slice(base.length)
       }
 
-      if (LEGACY_URL_PATTERN.test(rel)) {
+      var tag = classify(rel)
+      if (tag) {
         var badge = document.createElement('span')
-        badge.className = 'search-tag-legacy'
-        badge.textContent = 'legacy'
+        badge.className = 'search-tag-' + tag
+        badge.textContent = tag
         anchor.appendChild(badge)
       }
     }

typedoc.config.mjs

@@ -110,6 +110,7 @@ export default {
     'typedoc-plugin-missing-exports',
     'typedoc-github-theme',
     './docs/plugins/version-selector/typedoc-version-selector.mjs',
+    './docs/plugins/search-tags/typedoc-search-tags.mjs',
   ],
 
   // Places internal types next to the module that owns them rather than