warn users about fig-width and fig-height at cell level

Author: cscheid

src/resources/editor/tools/vs-code.mjs

@@ -12364,12 +12364,18 @@ var require_yaml_intelligence_resources = __commonJS({
         {
           name: "fig-width",
           schema: "number",
-          description: "Default width for figures generated by Matplotlib or R graphics"
+          description: {
+            short: "Default width for figures generated by Matplotlib or R graphics",
+            long: "Default width for figures generated by Matplotlib or R graphics.\n\nNote that with the Jupyter engine, this option has no effect when\nprovided at the cell level; it can only be provided with\ndocument or project metadata.\n"
+          }
         },
         {
           name: "fig-height",
           schema: "number",
-          description: "Default height for figures generated by Matplotlib or R graphics"
+          description: {
+            short: "Default height for figures generated by Matplotlib or R graphics",
+            long: "Default width for figures generated by Matplotlib or R graphics.\n\nNote that with the Jupyter engine, this option has no effect when\nprovided at the cell level; it can only be provided with\ndocument or project metadata.\n"
+          }
         },
         {
           name: "fig-format",
@@ -12387,7 +12393,10 @@ var require_yaml_intelligence_resources = __commonJS({
         {
           name: "fig-dpi",
           schema: "number",
-          description: "Default DPI for figures generated by Matplotlib or R graphics"
+          description: {
+            short: "Default DPI for figures generated by Matplotlib or R graphics",
+            long: "Default DPI for figures generated by Matplotlib or R graphics.\n\nNote that with the Jupyter engine, this option has no effect when\nprovided at the cell level; it can only be provided with\ndocument or project metadata.\n"
+          }
         },
         {
           name: "fig-asp",
@@ -26476,7 +26485,7 @@ function createSourceContext(src, location) {
         const endColumn = lineNumber < end.line ? rawLine.length : end.column;
         contextLines.push(content);
         contextLines.push(
-          " ".repeat(prefixWidth + startColumn) + "~".repeat(endColumn - startColumn)
+          " ".repeat(prefixWidth + startColumn - 1) + "~".repeat(endColumn - startColumn + 1)
         );
       }
     }

src/resources/editor/tools/yaml/web-worker.js

@@ -5340,12 +5340,18 @@
     {
       "name": "fig-width",
       "schema": "number",
-      "description": "Default width for figures generated by Matplotlib or R graphics"
+      "description": {
+        "short": "Default width for figures generated by Matplotlib or R graphics",
+        "long": "Default width for figures generated by Matplotlib or R graphics.\n\nNote that with the Jupyter engine, this option has no effect when\nprovided at the cell level; it can only be provided with\ndocument or project metadata.\n"
+      }
     },
     {
       "name": "fig-height",
       "schema": "number",
-      "description": "Default height for figures generated by Matplotlib or R graphics"
+      "description": {
+        "short": "Default height for figures generated by Matplotlib or R graphics",
+        "long": "Default width for figures generated by Matplotlib or R graphics.\n\nNote that with the Jupyter engine, this option has no effect when\nprovided at the cell level; it can only be provided with\ndocument or project metadata.\n"
+      }
     },
     {
       "name": "fig-format",
@@ -5363,7 +5369,10 @@
     {
       "name": "fig-dpi",
       "schema": "number",
-      "description": "Default DPI for figures generated by Matplotlib or R graphics"
+      "description": {
+        "short": "Default DPI for figures generated by Matplotlib or R graphics",
+        "long": "Default DPI for figures generated by Matplotlib or R graphics.\n\nNote that with the Jupyter engine, this option has no effect when\nprovided at the cell level; it can only be provided with\ndocument or project metadata.\n"
+      }
     },
     {
       "name": "fig-asp",

src/resources/editor/tools/yaml/yaml-intelligence-resources.json

@@ -1,10 +1,24 @@
 - name: fig-width
   schema: number
-  description: "Default width for figures generated by Matplotlib or R graphics"
+  description:
+    short: "Default width for figures generated by Matplotlib or R graphics"
+    long: |
+      Default width for figures generated by Matplotlib or R graphics.
+
+      Note that with the Jupyter engine, this option has no effect when
+      provided at the cell level; it can only be provided with
+      document or project metadata.
 
 - name: fig-height
   schema: number
-  description: "Default height for figures generated by Matplotlib or R graphics"
+  description:
+    short: "Default height for figures generated by Matplotlib or R graphics"
+    long: |
+      Default width for figures generated by Matplotlib or R graphics.
+
+      Note that with the Jupyter engine, this option has no effect when
+      provided at the cell level; it can only be provided with
+      document or project metadata.
 
 - name: fig-format
   schema:
@@ -13,7 +27,14 @@
 
 - name: fig-dpi
   schema: number
-  description: "Default DPI for figures generated by Matplotlib or R graphics"
+  description:
+    short: "Default DPI for figures generated by Matplotlib or R graphics"
+    long: |
+      Default DPI for figures generated by Matplotlib or R graphics.
+
+      Note that with the Jupyter engine, this option has no effect when
+      provided at the cell level; it can only be provided with
+      document or project metadata.
 
 - name: fig-asp
   tags: