update

Co-Authored-By: Claudio Wunder <[email protected]>

Author: AugustinMauroy

src/generators/jsx-ast/constants.mjs

@@ -5,11 +5,21 @@ import { JSX_IMPORTS } from '../web/constants.mjs';
  *
  * @see https://nodejs.org/api/documentation.html#stability-index
  */
+
+// Alert level constants — prefer importing from UI library if available
+// but not available for now
+export const ALERT_LEVELS = {
+  DANGER: 'danger',
+  WARNING: 'warning',
+  INFO: 'info',
+  SUCCESS: 'success',
+};
+
 export const STABILITY_LEVELS = [
-  'danger', // (0) Deprecated
-  'warning', // (1) Experimental
-  'success', // (2) Stable
-  'info', // (3) Legacy
+  ALERT_LEVELS.DANGER, // (0) Deprecated
+  ALERT_LEVELS.WARNING, // (1) Experimental
+  ALERT_LEVELS.SUCCESS, // (2) Stable
+  ALERT_LEVELS.INFO, // (3) Legacy
 ];
 
 // How deep should the Table of Contents go?
@@ -154,6 +164,6 @@ export const TYPES_WITH_METHOD_SIGNATURES = [
 // Patterns to map deprecation "Type" text to AlertBox levels.
 // Order matters: first match wins.
 export const DEPRECATION_TYPE_PATTERNS = [
-  { pattern: /^(Documentation|Compilation)/i, level: 'info' },
-  { pattern: /^(Runtime|Application)/i, level: 'warning' },
+  { pattern: /^(Documentation|Compilation)/i, level: ALERT_LEVELS.INFO },
+  { pattern: /^(Runtime|Application)/i, level: ALERT_LEVELS.WARNING },
 ];

src/generators/jsx-ast/utils/buildContent.mjs

@@ -17,6 +17,7 @@ import {
   INTERNATIONALIZABLE,
   STABILITY_PREFIX_LENGTH,
   DEPRECATION_TYPE_PATTERNS,
+  ALERT_LEVELS,
   TYPES_WITH_METHOD_SIGNATURES,
   TYPE_PREFIX_LENGTH,
 } from '../constants.mjs';
@@ -173,7 +174,7 @@ export const transformStabilityNode = (node, index, parent) => {
 const getLevelFromDeprecationType = typeText => {
   const match = DEPRECATION_TYPE_PATTERNS.find(p => p.pattern.test(typeText));
 
-  return match ? match.level : 'danger';
+  return match ? match.level : ALERT_LEVELS.DANGER;
 };
 
 /**
@@ -194,12 +195,11 @@ export const transformHeadingNode = (entry, remark, node, index, parent) => {
   if (entry.api === 'deprecations' && node.depth === 3) {
     // On the 'deprecations.md' page, "Type: <XYZ>" turns into an AlertBox
     // Extract the nodes representing the type text
-    const sliced = slice(
-      parent.children[index + 1],
-      TYPE_PREFIX_LENGTH,
-      undefined,
-      { textHandling: { boundaries: 'preserve' } }
-    ).node.children;
+    const {
+      node: { children: sliced },
+    } = slice(parent.children[index + 1], TYPE_PREFIX_LENGTH, undefined, {
+      textHandling: { boundaries: 'preserve' },
+    });
 
     parent.children[index + 1] = createJSXElement(JSX_IMPORTS.AlertBox.name, {
       children: sliced,