jupyterlab_github_markdown_alerts_extension 1.0.20 → 1.0.21

package/README.md

@@ -6,6 +6,9 @@
 [![Total PyPI downloads](https://static.pepy.tech/badge/jupyterlab-github-markdown-alerts-extension)](https://pepy.tech/project/jupyterlab-github-markdown-alerts-extension)
 [![JupyterLab 4](https://img.shields.io/badge/JupyterLab-4-orange.svg)](https://jupyterlab.readthedocs.io/en/stable/)
 
+> [!TIP]
+> This extension is part of the [stellars_jupyterlab_extensions](https://github.com/stellarshenson/stellars_jupyterlab_extensions) metapackage. Install all Stellars extensions at once: `pip install stellars_jupyterlab_extensions`
+
 A JupyterLab 4 extension that renders GitHub-style alert blocks in Markdown cells, providing visual emphasis for notes, tips, warnings, and other important information.
 
 This extension brings GitHub's alert syntax to JupyterLab, allowing you to create styled callout blocks using simple markdown notation. Alerts automatically adapt to light and dark themes, matching GitHub's visual design.

package/lib/index.js

@@ -34,12 +34,26 @@ const plugin = {
             };
             loadSettings();
         }
-        const originalRender = markdownParser.render.bind(markdownParser);
-        markdownParser.render = async (content) => {
-            const processedContent = processAlerts(content);
-            const renderedHtml = await originalRender(processedContent);
-            return postProcessAlerts(renderedHtml, showBackgrounds);
-        };
+        // Idempotent: never re-wrap on re-activation, otherwise originalRender
+        // would capture an already-wrapped function
+        if (!markdownParser.render.__alertsWrapped) {
+            const originalRender = markdownParser.render.bind(markdownParser);
+            const wrappedRender = async (content) => {
+                try {
+                    const processedContent = processAlerts(content);
+                    const renderedHtml = await originalRender(processedContent);
+                    return postProcessAlerts(renderedHtml, showBackgrounds);
+                }
+                catch (reason) {
+                    // Degrade to plain Markdown instead of rejecting render, which
+                    // would push rendermime into an un-highlighted fallback
+                    console.error('jupyterlab_github_markdown_alerts_extension: render failed, falling back to plain markdown', reason);
+                    return originalRender(content);
+                }
+            };
+            wrappedRender.__alertsWrapped = true;
+            markdownParser.render = wrappedRender;
+        }
         console.log('JupyterLab extension jupyterlab_github_markdown_alerts_extension is activated!');
     }
 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "jupyterlab_github_markdown_alerts_extension",
-    "version": "1.0.20",
+    "version": "1.0.21",
     "description": "Jupyterlab extension to render alerts tips like they are rendered in github in markdown",
     "keywords": [
         "jupyter",

package/src/__tests__/jupyterlab_github_markdown_alerts_extension.spec.ts

@@ -60,7 +60,9 @@ describe('processAlerts', () => {
 > | Cell 1   | Cell 2   |`;
       const result = processAlerts(input);
       // Tables require consecutive lines - single newlines between rows
-      expect(result).toContain('| Header 1 | Header 2 |\n|----------|----------|\n| Cell 1   | Cell 2   |');
+      expect(result).toContain(
+        '| Header 1 | Header 2 |\n|----------|----------|\n| Cell 1   | Cell 2   |'
+      );
     });
 
     it('should not insert blank lines between table rows', () => {
@@ -94,7 +96,9 @@ describe('processAlerts', () => {
 >
 > Paragraph three.`;
       const result = processAlerts(input);
-      expect(result).toContain('Paragraph one.\n\nParagraph two.\n\nParagraph three.');
+      expect(result).toContain(
+        'Paragraph one.\n\nParagraph two.\n\nParagraph three.'
+      );
     });
   });
 
@@ -197,7 +201,8 @@ describe('postProcessAlerts', () => {
   });
 
   it('should add background class when showBackgrounds is true', () => {
-    const input = '<!--ALERT_START:WARNING-->Warning content<!--ALERT_END:WARNING-->';
+    const input =
+      '<!--ALERT_START:WARNING-->Warning content<!--ALERT_END:WARNING-->';
     const result = postProcessAlerts(input, true);
     expect(result).toContain('markdown-alert-with-backgrounds');
   });

package/src/index.ts

@@ -52,13 +52,29 @@ const plugin: JupyterFrontEndPlugin<void> = {
       loadSettings();
     }
 
-    const originalRender = markdownParser.render.bind(markdownParser);
+    // Idempotent: never re-wrap on re-activation, otherwise originalRender
+    // would capture an already-wrapped function
+    if (!(markdownParser.render as any).__alertsWrapped) {
+      const originalRender = markdownParser.render.bind(markdownParser);
 
-    markdownParser.render = async (content: string): Promise<string> => {
-      const processedContent = processAlerts(content);
-      const renderedHtml = await originalRender(processedContent);
-      return postProcessAlerts(renderedHtml, showBackgrounds);
-    };
+      const wrappedRender = async (content: string): Promise<string> => {
+        try {
+          const processedContent = processAlerts(content);
+          const renderedHtml = await originalRender(processedContent);
+          return postProcessAlerts(renderedHtml, showBackgrounds);
+        } catch (reason) {
+          // Degrade to plain Markdown instead of rejecting render, which
+          // would push rendermime into an un-highlighted fallback
+          console.error(
+            'jupyterlab_github_markdown_alerts_extension: render failed, falling back to plain markdown',
+            reason
+          );
+          return originalRender(content);
+        }
+      };
+      (wrappedRender as any).__alertsWrapped = true;
+      markdownParser.render = wrappedRender;
+    }
 
     console.log(
       'JupyterLab extension jupyterlab_github_markdown_alerts_extension is activated!'

package/style/base.css

@@ -173,47 +173,47 @@ body[data-jp-theme-light='false']
 
 /* Optional backgrounds (enabled via settings) */
 .markdown-alert-with-backgrounds.markdown-alert-note {
-  background-color: rgba(9, 105, 218, 0.1);
+  background-color: rgb(9 105 218 / 10%);
 }
 
 .markdown-alert-with-backgrounds.markdown-alert-tip {
-  background-color: rgba(26, 127, 55, 0.1);
+  background-color: rgb(26 127 55 / 10%);
 }
 
 .markdown-alert-with-backgrounds.markdown-alert-important {
-  background-color: rgba(130, 80, 223, 0.1);
+  background-color: rgb(130 80 223 / 10%);
 }
 
 .markdown-alert-with-backgrounds.markdown-alert-warning {
-  background-color: rgba(154, 103, 0, 0.1);
+  background-color: rgb(154 103 0 / 10%);
 }
 
 .markdown-alert-with-backgrounds.markdown-alert-caution {
-  background-color: rgba(209, 36, 47, 0.1);
+  background-color: rgb(209 36 47 / 10%);
 }
 
 /* Dark theme backgrounds */
 body[data-jp-theme-light='false']
   .markdown-alert-with-backgrounds.markdown-alert-note {
-  background-color: rgba(47, 129, 247, 0.15);
+  background-color: rgb(47 129 247 / 15%);
 }
 
 body[data-jp-theme-light='false']
   .markdown-alert-with-backgrounds.markdown-alert-tip {
-  background-color: rgba(63, 185, 80, 0.15);
+  background-color: rgb(63 185 80 / 15%);
 }
 
 body[data-jp-theme-light='false']
   .markdown-alert-with-backgrounds.markdown-alert-important {
-  background-color: rgba(163, 113, 247, 0.15);
+  background-color: rgb(163 113 247 / 15%);
 }
 
 body[data-jp-theme-light='false']
   .markdown-alert-with-backgrounds.markdown-alert-warning {
-  background-color: rgba(210, 153, 34, 0.15);
+  background-color: rgb(210 153 34 / 15%);
 }
 
 body[data-jp-theme-light='false']
   .markdown-alert-with-backgrounds.markdown-alert-caution {
-  background-color: rgba(248, 81, 73, 0.15);
+  background-color: rgb(248 81 73 / 15%);
 }