feat(theme): emit stability blockquotes for JSDoc stability tags

pages/v5.x/webpack/namespaces/dependencies.md

@@ -125,13 +125,13 @@ implement this method to allow the occurrence order plugin to count correctly
 
 #### `getReference(moduleGraph)`
 
+> Stability: 0 - Deprecated
+
 * `moduleGraph` {ModuleGraph}
 * Returns: {never}
 
 Returns the referenced module and export
 
-##### Deprecated
-
 #### `getReferencedExports(moduleGraph, runtime)`
 
 * `moduleGraph` {ModuleGraph}
@@ -333,13 +333,13 @@ implement this method to allow the occurrence order plugin to count correctly
 
 #### `getReference(moduleGraph)`
 
+> Stability: 0 - Deprecated
+
 * `moduleGraph` {ModuleGraph}
 * Returns: {never}
 
 Returns the referenced module and export
 
-##### Deprecated
-
 #### `getReferencedExports(moduleGraph, runtime)`
 
 * `moduleGraph` {ModuleGraph}
@@ -516,13 +516,13 @@ implement this method to allow the occurrence order plugin to count correctly
 
 #### `getReference(moduleGraph)`
 
+> Stability: 0 - Deprecated
+
 * `moduleGraph` {ModuleGraph}
 * Returns: {never}
 
 Returns the referenced module and export
 
-##### Deprecated
-
 #### `getReferencedExports(moduleGraph, runtime)`
 
 * `moduleGraph` {ModuleGraph}
@@ -693,13 +693,13 @@ implement this method to allow the occurrence order plugin to count correctly
 
 #### `getReference(moduleGraph)`
 
+> Stability: 0 - Deprecated
+
 * `moduleGraph` {ModuleGraph}
 * Returns: {never}
 
 Returns the referenced module and export
 
-##### Deprecated
-
 #### `getReferencedExports(moduleGraph, runtime)`
 
 * `moduleGraph` {ModuleGraph}

pages/v5.x/webpack/namespaces/esm.md

@@ -469,14 +469,14 @@ This data will be passed to restoreFromUnsafeCache later.
 
 #### `needRebuild(fileTimestamps, contextTimestamps)`
 
+> Stability: 0 - Deprecated
+
 * `fileTimestamps` {Map}
 * `contextTimestamps` {Map}
 * Returns: {boolean}
 
 Use needBuild instead
 
-##### Deprecated
-
 #### `originalSource()`
 
 * Returns: {Source}
@@ -512,15 +512,15 @@ Use needBuild instead
 
 #### `source(dependencyTemplates, runtimeTemplate[, type])`
 
+> Stability: 0 - Deprecated
+
 * `dependencyTemplates` {DependencyTemplates}
 * `runtimeTemplate` {RuntimeTemplate}
 * `type` {string}
 * Returns: {Source}
 
 Use codeGeneration() instead
 
-##### Deprecated
-
 #### `updateCacheModule(module)`
 
 * `module` {Module}
@@ -543,9 +543,9 @@ and properties.
 
 #### Static method: `getSourceBasicTypes(module)`
 
+> Stability: 0 - Deprecated
+
 * `module` {Module}
 * Returns: {ReadonlySet}
 
 In webpack 6, call getSourceBasicTypes() directly on the module instance instead of using this static method.
-
-##### Deprecated

pages/v5.x/webpack/namespaces/javascript.md

@@ -353,12 +353,12 @@ Block pre walking iterates the scope for block variable declarations
 
 #### `inScope(params, fn)`
 
+> Stability: 0 - Deprecated
+
 * `params` {string|Identifier|Property|MemberExpression|ObjectPattern|ArrayPattern|RestElement|AssignmentPattern[]}
 * `fn` {object}
 * Returns: {void}
 
-##### Deprecated
-
 #### `isAsiPosition(pos)`
 
 * `pos` {number}

pages/v5.x/webpack/namespaces/runtime.md

@@ -477,14 +477,14 @@ This data will be passed to restoreFromUnsafeCache later.
 
 #### `needRebuild(fileTimestamps, contextTimestamps)`
 
+> Stability: 0 - Deprecated
+
 * `fileTimestamps` {Map}
 * `contextTimestamps` {Map}
 * Returns: {boolean}
 
 Use needBuild instead
 
-##### Deprecated
-
 #### `originalSource()`
 
 * Returns: {Source}
@@ -520,15 +520,15 @@ Use needBuild instead
 
 #### `source(dependencyTemplates, runtimeTemplate[, type])`
 
+> Stability: 0 - Deprecated
+
 * `dependencyTemplates` {DependencyTemplates}
 * `runtimeTemplate` {RuntimeTemplate}
 * `type` {string}
 * Returns: {Source}
 
 Use codeGeneration() instead
 
-##### Deprecated
-
 #### `updateCacheModule(module)`
 
 * `module` {Module}
@@ -546,13 +546,13 @@ and properties.
 
 #### Static method: `getSourceBasicTypes(module)`
 
+> Stability: 0 - Deprecated
+
 * `module` {Module}
 * Returns: {ReadonlySet}
 
 In webpack 6, call getSourceBasicTypes() directly on the module instance instead of using this static method.
 
-##### Deprecated
-
 ***
 
 ## Class: `LoadScriptRuntimeModule`
@@ -1025,14 +1025,14 @@ This data will be passed to restoreFromUnsafeCache later.
 
 #### `needRebuild(fileTimestamps, contextTimestamps)`
 
+> Stability: 0 - Deprecated
+
 * `fileTimestamps` {Map}
 * `contextTimestamps` {Map}
 * Returns: {boolean}
 
 Use needBuild instead
 
-##### Deprecated
-
 #### `originalSource()`
 
 * Returns: {Source}
@@ -1068,15 +1068,15 @@ Use needBuild instead
 
 #### `source(dependencyTemplates, runtimeTemplate[, type])`
 
+> Stability: 0 - Deprecated
+
 * `dependencyTemplates` {DependencyTemplates}
 * `runtimeTemplate` {RuntimeTemplate}
 * `type` {string}
 * Returns: {Source}
 
 Use codeGeneration() instead
 
-##### Deprecated
-
 #### `updateCacheModule(module)`
 
 * `module` {Module}
@@ -1099,9 +1099,9 @@ and properties.
 
 #### Static method: `getSourceBasicTypes(module)`
 
+> Stability: 0 - Deprecated
+
 * `module` {Module}
 * Returns: {ReadonlySet}
 
 In webpack 6, call getSourceBasicTypes() directly on the module instance instead of using this static method.
-
-##### Deprecated

pages/v5.x/webpack/namespaces/web.md

@@ -469,14 +469,14 @@ This data will be passed to restoreFromUnsafeCache later.
 
 #### `needRebuild(fileTimestamps, contextTimestamps)`
 
+> Stability: 0 - Deprecated
+
 * `fileTimestamps` {Map}
 * `contextTimestamps` {Map}
 * Returns: {boolean}
 
 Use needBuild instead
 
-##### Deprecated
-
 #### `originalSource()`
 
 * Returns: {Source}
@@ -512,15 +512,15 @@ Use needBuild instead
 
 #### `source(dependencyTemplates, runtimeTemplate[, type])`
 
+> Stability: 0 - Deprecated
+
 * `dependencyTemplates` {DependencyTemplates}
 * `runtimeTemplate` {RuntimeTemplate}
 * `type` {string}
 * Returns: {Source}
 
 Use codeGeneration() instead
 
-##### Deprecated
-
 #### `updateCacheModule(module)`
 
 * `module` {Module}
@@ -543,13 +543,13 @@ and properties.
 
 #### Static method: `getSourceBasicTypes(module)`
 
+> Stability: 0 - Deprecated
+
 * `module` {Module}
 * Returns: {ReadonlySet}
 
 In webpack 6, call getSourceBasicTypes() directly on the module instance instead of using this static method.
 
-##### Deprecated
-
 ***
 
 ## Class: `FetchCompileAsyncWasmPlugin`
@@ -1064,14 +1064,14 @@ This data will be passed to restoreFromUnsafeCache later.
 
 #### `needRebuild(fileTimestamps, contextTimestamps)`
 
+> Stability: 0 - Deprecated
+
 * `fileTimestamps` {Map}
 * `contextTimestamps` {Map}
 * Returns: {boolean}
 
 Use needBuild instead
 
-##### Deprecated
-
 #### `originalSource()`
 
 * Returns: {Source}
@@ -1107,15 +1107,15 @@ Use needBuild instead
 
 #### `source(dependencyTemplates, runtimeTemplate[, type])`
 
+> Stability: 0 - Deprecated
+
 * `dependencyTemplates` {DependencyTemplates}
 * `runtimeTemplate` {RuntimeTemplate}
 * `type` {string}
 * Returns: {Source}
 
 Use codeGeneration() instead
 
-##### Deprecated
-
 #### `updateCacheModule(module)`
 
 * `module` {Module}
@@ -1138,13 +1138,13 @@ and properties.
 
 #### Static method: `getSourceBasicTypes(module)`
 
+> Stability: 0 - Deprecated
+
 * `module` {Module}
 * Returns: {ReadonlySet}
 
 In webpack 6, call getSourceBasicTypes() directly on the module instance instead of using this static method.
 
-##### Deprecated
-
 ***
 
 ## Class: `JsonpTemplatePlugin`
@@ -1166,9 +1166,9 @@ Apply the plugin
 
 #### Static method: `getCompilationHooks(compilation)`
 
+> Stability: 0 - Deprecated
+
 * `compilation` {Compilation}
 * Returns: {JsonpCompilationPluginHooks}
 
 use JsonpChunkLoadingRuntimeModule.getCompilationHooks instead
-
-##### Deprecated

plugins/theme/helpers/index.mjs

@@ -30,4 +30,38 @@ export default (ctx) => ({
   typedList(entries) {
     return entries.map(ctx.helpers.typedListItem).join("\n");
   },
+
+  stabilityBlockquote(comment) {
+    if (!comment) return null;
+
+    const deprecated = comment.blockTags?.find((t) => t.tag === "@deprecated");
+    const isExperimental =
+      comment.modifierTags?.has("@experimental") ||
+      comment.modifierTags?.has("@beta");
+    const legacy = comment.blockTags?.find((t) => t.tag === "@legacy");
+
+    if (deprecated) {
+      const message = deprecated.content?.length
+        ? ctx.helpers.getCommentParts(deprecated.content).trim()
+        : "";
+      return message
+        ? `> Stability: 0 - Deprecated: ${message}`
+        : `> Stability: 0 - Deprecated`;
+    }
+
+    if (isExperimental) {
+      return `> Stability: 1 - Experimental`;
+    }
+
+    if (legacy) {
+      const message = legacy.content?.length
+        ? ctx.helpers.getCommentParts(legacy.content).trim()
+        : "";
+      return message
+        ? `> Stability: 3 - Legacy: ${message}`
+        : `> Stability: 3 - Legacy`;
+    }
+
+    return null;
+  },
 });