feat(web-generator): update deprecation alertbox

Author: AugustinMauroy

src/generators/jsx-ast/utils/__tests__/transformHeadingNode.test.mjs

@@ -0,0 +1,65 @@
+import assert from 'node:assert/strict';
+import { describe, it } from 'node:test';
+
+import { transformHeadingNode } from '../buildContent.mjs';
+
+describe('transformHeadingNode (deprecation Type -> AlertBox level)', () => {
+  const makeHeading = () => ({
+    type: 'heading',
+    depth: 3,
+    data: { type: 'misc', slug: 's', text: 'Heading' },
+    children: [{ type: 'text', value: 'Heading' }],
+  });
+
+  const makeParent = typeText => ({
+    children: [
+      makeHeading(),
+      {
+        type: 'paragraph',
+        children: [{ type: 'text', value: `Type: ${typeText}` }],
+      },
+    ],
+  });
+
+  it('maps documentation/compilation to info', () => {
+    const entry = { api: 'deprecations' };
+    const parent = makeParent('Documentation');
+    const node = parent.children[0];
+
+    transformHeadingNode(entry, {}, node, 0, parent);
+
+    const alert = parent.children[1];
+    assert.equal(alert.name, 'AlertBox');
+    const levelAttr = alert.attributes.find(a => a.name === 'level');
+    assert.ok(levelAttr);
+    assert.equal(levelAttr.value, 'info');
+  });
+
+  it('maps runtime/application to warning', () => {
+    const entry = { api: 'deprecations' };
+    const parent = makeParent('Runtime');
+    const node = parent.children[0];
+
+    transformHeadingNode(entry, {}, node, 0, parent);
+
+    const alert = parent.children[1];
+    assert.equal(alert.name, 'AlertBox');
+    const levelAttr = alert.attributes.find(a => a.name === 'level');
+    assert.ok(levelAttr);
+    assert.equal(levelAttr.value, 'warning');
+  });
+
+  it('falls back to danger for unknown types', () => {
+    const entry = { api: 'deprecations' };
+    const parent = makeParent('SomeOtherThing');
+    const node = parent.children[0];
+
+    transformHeadingNode(entry, {}, node, 0, parent);
+
+    const alert = parent.children[1];
+    assert.equal(alert.name, 'AlertBox');
+    const levelAttr = alert.attributes.find(a => a.name === 'level');
+    assert.ok(levelAttr);
+    assert.equal(levelAttr.value, 'danger');
+  });
+});

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

@@ -180,16 +180,50 @@ 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
-    parent.children[index + 1] = createJSXElement(JSX_IMPORTS.AlertBox.name, {
-      children: slice(
-        parent.children[index + 1],
-        TYPE_PREFIX_LENGTH,
-        undefined,
-        {
-          textHandling: { boundaries: 'preserve' },
+    // Extract the nodes representing the type text
+    const sliced = slice(
+      parent.children[index + 1],
+      TYPE_PREFIX_LENGTH,
+      undefined,
+      { textHandling: { boundaries: 'preserve' } }
+    ).node.children;
+
+    // Derive plain text for type matching
+    const typeText = sliced
+      .map(n => {
+        if (n.type === 'text') {
+          return n.value;
+        }
+        if (n.type === 'inlineCode') {
+          return n.value;
+        }
+        if (n.type === 'link' && Array.isArray(n.children)) {
+          return n.children.map(c => c.value || '').join('');
         }
-      ).node.children,
-      level: 'danger',
+        return '';
+      })
+      .join('')
+      .trim()
+      .toLowerCase();
+
+    // Map user-facing deprecation types to AlertBox levels
+    // documentation / compilation -> blue (`info`)
+    // runtime / application -> orange (`warning`)
+    // fallback -> danger (red)
+    let level = 'danger';
+
+    if (typeText.includes('documentation') || typeText.includes('compil')) {
+      level = 'info';
+    } else if (
+      typeText.includes('runtime') ||
+      typeText.includes('application')
+    ) {
+      level = 'warning';
+    }
+
+    parent.children[index + 1] = createJSXElement(JSX_IMPORTS.AlertBox.name, {
+      children: sliced,
+      level,
       title: 'Type',
     });
   }