Add group for options that need Typst specific content in docs

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

@@ -9669,6 +9669,55 @@
         "long": "For HTML output, sets the `margin-bottom` property on the Body element.\n\nFor LaTeX output, sets the bottom margin if `geometry` is not \nused (otherwise `geometry` overrides this value)\n\nFor ConTeXt output, sets the bottom margin if `layout` is not used, \notherwise `layout` overrides these.\n\nFor `wkhtmltopdf` sets the bottom page margin.\n"
       }
     },
+    {
+      "name": "margin",
+      "tags": {
+        "formats": [
+          "typst"
+        ]
+      },
+      "schema": {
+        "object": {
+          "closed": true,
+          "properties": {
+            "x": {
+              "string": {
+                "description": "Horizontal margin (e.g. 1.5in)"
+              }
+            },
+            "y": {
+              "string": {
+                "description": "Vertical margin (e.g. 1.5in)"
+              }
+            },
+            "top": {
+              "string": {
+                "description": "Top margin (e.g. 1.5in)"
+              }
+            },
+            "bottom": {
+              "string": {
+                "description": "Bottom margin (e.g. 1.5in)"
+              }
+            },
+            "left": {
+              "string": {
+                "description": "Left margin (e.g. 1.5in)"
+              }
+            },
+            "right": {
+              "string": {
+                "description": "Right margin (e.g. 1.5in)"
+              }
+            }
+          }
+        }
+      },
+      "description": {
+        "short": "Page margins for Typst output.",
+        "long": "A dictionary specifying page margins. Use `x` and `y` for symmetric\nhorizontal/vertical margins, or `top`, `bottom`, `left`, `right` for\nindividual sides. Values should include units (e.g. `1.5in`, `2cm`).\n"
+      }
+    },
     {
       "name": "geometry",
       "schema": {
@@ -11802,54 +11851,12 @@
       "name": "margin",
       "tags": {
         "formats": [
-          "revealjs",
-          "typst"
-        ]
-      },
-      "schema": {
-        "anyOf": [
-          "number",
-          {
-            "object": {
-              "closed": true,
-              "properties": {
-                "x": {
-                  "string": {
-                    "description": "Horizontal margin (e.g. 5cm)"
-                  }
-                },
-                "y": {
-                  "string": {
-                    "description": "Vertical margin (e.g. 5cm)"
-                  }
-                },
-                "top": {
-                  "string": {
-                    "description": "Top margin (e.g. 5cm)"
-                  }
-                },
-                "bottom": {
-                  "string": {
-                    "description": "Bottom margin (e.g. 5cm)"
-                  }
-                },
-                "left": {
-                  "string": {
-                    "description": "Left margin (e.g. 5cm)"
-                  }
-                },
-                "right": {
-                  "string": {
-                    "description": "Right margin (e.g. 5cm)"
-                  }
-                }
-              }
-            }
-          }
+          "revealjs"
         ]
       },
+      "schema": "number",
       "default": 0.1,
-      "description": "For `revealjs`, the factor of the display size that should remain empty around the content (e.g. 0.1).\n\nFor `typst`, a dictionary with the fields defined in the Typst documentation:\n`x`, `y`, `top`, `bottom`, `left`, `right` (margins are specified in `cm` units,\ne.g. `5cm`).\n"
+      "description": "Factor of the display size that should remain empty around the content (e.g. 0.1)."
     },
     {
       "name": "min-scale",
@@ -13616,6 +13623,9 @@
       "dashboard": {
         "title": "Dashboard"
       },
+      "typst": {
+        "title": "Typst"
+      },
       "options": {
         "title": "Format Options"
       },
@@ -16264,17 +16274,17 @@
     "Sets the CSS <code>color</code> property.",
     {
       "short": "Sets the color of hyperlinks in the document.",
-      "long": "For HTML output, sets the CSS <code>color</code> property on all\nlinks.\nFor LaTeX output, The color used for internal links using color\noptions allowed by <a href=\"https://ctan.org/pkg/xcolor\"><code>xcolor</code></a>, including\nthe <code>dvipsnames</code>, <code>svgnames</code>, and\n<code>x11names</code> lists.\nFor ConTeXt output, sets the color for both external links and links\nwithin the document."
+      "long": "For HTML output, sets the CSS <code>color</code> property on all\nlinks.\nFor LaTeX output, The color used for internal links using color\noptions allowed by <a href=\"https://ctan.org/pkg/xcolor\"><code>xcolor</code></a>, including\nthe <code>dvipsnames</code>, <code>svgnames</code>, and\n<code>x11names</code> lists.\nFor ConTeXt output, sets the color for both external links and links\nwithin the document.\nFor Typst output, sets the color of internal hyperlinks using Typst\ncolor syntax."
     },
     "Sets the CSS <code>background-color</code> property on code elements\nand adds extra padding.",
     "Sets the CSS <code>background-color</code> property on the html\nelement.",
     {
-      "short": "The color used for external links using color options allowed by\n<code>xcolor</code>",
-      "long": "The color used for external links using color options allowed by <a href=\"https://ctan.org/pkg/xcolor\"><code>xcolor</code></a>, including\nthe <code>dvipsnames</code>, <code>svgnames</code>, and\n<code>x11names</code> lists."
+      "short": "The color used for external links.",
+      "long": "For LaTeX output, the color used for external links using color\noptions allowed by <a href=\"https://ctan.org/pkg/xcolor\"><code>xcolor</code></a>, including\nthe <code>dvipsnames</code>, <code>svgnames</code>, and\n<code>x11names</code> lists.\nFor Typst output, sets the color of external file links using Typst\ncolor syntax."
     },
     {
-      "short": "The color used for citation links using color options allowed by\n<code>xcolor</code>",
-      "long": "The color used for citation links using color options allowed by <a href=\"https://ctan.org/pkg/xcolor\"><code>xcolor</code></a>, including\nthe <code>dvipsnames</code>, <code>svgnames</code>, and\n<code>x11names</code> lists."
+      "short": "The color used for citation links.",
+      "long": "For LaTeX output, the color used for citation links using color\noptions allowed by <a href=\"https://ctan.org/pkg/xcolor\"><code>xcolor</code></a>, including\nthe <code>dvipsnames</code>, <code>svgnames</code>, and\n<code>x11names</code> lists.\nFor Typst output, sets the color of citation links using Typst color\nsyntax."
     },
     {
       "short": "The color used for linked URLs using color options allowed by\n<code>xcolor</code>",
@@ -16470,6 +16480,10 @@
       "short": "Sets the font used for when displaying code.",
       "long": "For HTML output, sets the CSS font-family property on code\nelements.\nFor PowerPoint output, sets the font used for code.\nFor LaTeX output, the monospace font family for use with\n<code>xelatex</code> or <code>lualatex</code>: take the name of any\nsystem font, using the <a href=\"https://ctan.org/pkg/fontspec\"><code>fontspec</code></a>\npackage.\nFor ConTeXt output, the monspace font family. Use the name of any\nsystem font. See <a href=\"https://wiki.contextgarden.net/Fonts\">ConTeXt\nFonts</a> for more information."
     },
+    {
+      "short": "Sets the font used for code in Typst output.",
+      "long": "For Typst output, sets the font used for displaying code. Takes the\nname of any font available to Typst (system fonts or fonts in\ndirectories specified by <code>font-paths</code>)."
+    },
     {
       "short": "Sets the main font size for the document.",
       "long": "For HTML output, sets the base CSS <code>font-size</code>\nproperty.\nFor LaTeX and ConTeXt output, sets the font size for the document\nbody text."
@@ -16491,8 +16505,8 @@
       "long": "The sans serif font family for use with <code>xelatex</code> or\n<code>lualatex</code>. Takes the name of any system font, using the <a href=\"https://ctan.org/pkg/fontspec\"><code>fontspec</code></a>\npackage."
     },
     {
-      "short": "The math font family for use with <code>xelatex</code> or\n<code>lualatex</code>.",
-      "long": "The math font family for use with <code>xelatex</code> or\n<code>lualatex</code>. Takes the name of any system font, using the <a href=\"https://ctan.org/pkg/fontspec\"><code>fontspec</code></a>\npackage."
+      "short": "The math font family for use with <code>xelatex</code>,\n<code>lualatex</code>, or Typst.",
+      "long": "For LaTeX output, the math font family for use with\n<code>xelatex</code> or <code>lualatex</code>. Takes the name of any\nsystem font, using the <a href=\"https://ctan.org/pkg/fontspec\"><code>fontspec</code></a>\npackage.\nFor Typst output, sets the font used for mathematical content."
     },
     {
       "short": "The CJK main font family for use with <code>xelatex</code> or\n<code>lualatex</code>.",
@@ -16530,7 +16544,7 @@
     "The line height, for example, <code>12p</code>.",
     {
       "short": "Sets the line height or spacing for text in the document.",
-      "long": "For HTML output sets the CSS <code>line-height</code> property on the\nhtml element, which is preferred to be unitless.\nFor LaTeX output, adjusts line spacing using the <a href=\"https://ctan.org/pkg/setspace\">setspace</a> package, e.g.&nbsp;1.25,\n1.5."
+      "long": "For HTML output sets the CSS <code>line-height</code> property on the\nhtml element, which is preferred to be unitless.\nFor LaTeX output, adjusts line spacing using the <a href=\"https://ctan.org/pkg/setspace\">setspace</a> package, e.g.&nbsp;1.25,\n1.5.\nFor Typst output, adjusts the spacing between lines of text."
     },
     "Adjusts line spacing using the <code>\\setupinterlinespace</code>\ncommand.",
     "The typeface style for links in the document.",
@@ -16832,6 +16846,16 @@
       "short": "Sets the bottom margin of the document.",
       "long": "For HTML output, sets the <code>margin-bottom</code> property on the\nBody element.\nFor LaTeX output, sets the bottom margin if <code>geometry</code> is\nnot used (otherwise <code>geometry</code> overrides this value)\nFor ConTeXt output, sets the bottom margin if <code>layout</code> is\nnot used, otherwise <code>layout</code> overrides these.\nFor <code>wkhtmltopdf</code> sets the bottom page margin."
     },
+    {
+      "short": "Page margins for Typst output.",
+      "long": "A dictionary specifying page margins. Use <code>x</code> and\n<code>y</code> for symmetric horizontal/vertical margins, or\n<code>top</code>, <code>bottom</code>, <code>left</code>,\n<code>right</code> for individual sides. Values should include units\n(e.g.&nbsp;<code>1.5in</code>, <code>2cm</code>)."
+    },
+    "Horizontal margin (e.g.&nbsp;1.5in)",
+    "Vertical margin (e.g.&nbsp;1.5in)",
+    "Top margin (e.g.&nbsp;1.5in)",
+    "Bottom margin (e.g.&nbsp;1.5in)",
+    "Left margin (e.g.&nbsp;1.5in)",
+    "Right margin (e.g.&nbsp;1.5in)",
     {
       "short": "Options for the geometry package.",
       "long": "Options for the <a href=\"https://ctan.org/pkg/geometry\">geometry</a>\npackage. For example:"
@@ -17165,13 +17189,7 @@
       "short": "The ‘normal’ height of the presentation",
       "long": "The “normal” height of the presentation, aspect ratio will be\npreserved when the presentation is scaled to fit different resolutions.\nCan be specified using percentage units."
     },
-    "For <code>revealjs</code>, the factor of the display size that should\nremain empty around the content (e.g.&nbsp;0.1).\nFor <code>typst</code>, a dictionary with the fields defined in the\nTypst documentation: <code>x</code>, <code>y</code>, <code>top</code>,\n<code>bottom</code>, <code>left</code>, <code>right</code> (margins are\nspecified in <code>cm</code> units, e.g.&nbsp;<code>5cm</code>).",
-    "Horizontal margin (e.g.&nbsp;5cm)",
-    "Vertical margin (e.g.&nbsp;5cm)",
-    "Top margin (e.g.&nbsp;5cm)",
-    "Bottom margin (e.g.&nbsp;5cm)",
-    "Left margin (e.g.&nbsp;5cm)",
-    "Right margin (e.g.&nbsp;5cm)",
+    "Factor of the display size that should remain empty around the\ncontent (e.g.&nbsp;0.1).",
     "Bounds for smallest possible scale to apply to content",
     "Bounds for largest possible scale to apply to content",
     "Vertical centering of slides",
@@ -18104,11 +18122,7 @@
     "Disambiguating year suffix in author-date styles (e.g.&nbsp;“a” in “Doe,\n1999a”).",
     "Manuscript configuration",
     "internal-schema-hack",
-    "List execution engines you want to give priority when determining\nwhich engine should render a notebook. If two engines have support for a\nnotebook, the one listed earlier will be chosen. Quarto’s default order\nis ‘knitr’, ‘jupyter’, ‘markdown’, ‘julia’.",
-    {
-      "short": "Sets the font used for code in Typst output.",
-      "long": "For Typst output, sets the font used for displaying code. Takes the\nname of any font available to Typst (system fonts or fonts in\ndirectories specified by <code>font-paths</code>)."
-    }
+    "List execution engines you want to give priority when determining\nwhich engine should render a notebook. If two engines have support for a\nnotebook, the one listed earlier will be chosen. Quarto’s default order\nis ‘knitr’, ‘jupyter’, ‘markdown’, ‘julia’."
   ],
   "schema/external-schemas.yml": [
     {
@@ -18338,12 +18352,12 @@
     "mermaid": "%%"
   },
   "handlers/mermaid/schema.yml": {
-    "_internalId": 222606,
+    "_internalId": 222532,
     "type": "object",
     "description": "be an object",
     "properties": {
       "mermaid-format": {
-        "_internalId": 222598,
+        "_internalId": 222524,
         "type": "enum",
         "enum": [
           "png",
@@ -18359,7 +18373,7 @@
         "exhaustiveCompletions": true
       },
       "theme": {
-        "_internalId": 222605,
+        "_internalId": 222531,
         "type": "anyOf",
         "anyOf": [
           {
@@ -18493,7 +18507,7 @@
       },
       "description": {
         "short": "Visual style for theorem environments in Typst output.",
-        "long": "Controls how theorems, lemmas, definitions, etc. are rendered:\n- `simple`: Plain text with bold title and italic body (default)\n- `fancy`: Colored boxes using brand colors\n- `clouds`: Rounded colored background boxes\n- `rainbow`: Colored left border with colored title\n"
+        "long": "Controls how theorems, lemmas, definitions, etc. are rendered:\n\n- `simple`: Plain text with bold title and italic body (default)\n- `fancy`: Colored boxes using brand colors\n- `clouds`: Rounded colored background boxes\n- `rainbow`: Colored left border with colored title\n"
       }
     }
   ],

src/resources/schema/document-layout.yml

@@ -278,6 +278,38 @@
 
       For `wkhtmltopdf` sets the bottom page margin.
 
+- name: margin
+  tags:
+    formats: [typst]
+  schema:
+    object:
+      closed: true
+      properties:
+        x:
+          string:
+            description: "Horizontal margin (e.g. 1.5in)"
+        y:
+          string:
+            description: "Vertical margin (e.g. 1.5in)"
+        top:
+          string:
+            description: "Top margin (e.g. 1.5in)"
+        bottom:
+          string:
+            description: "Bottom margin (e.g. 1.5in)"
+        left:
+          string:
+            description: "Left margin (e.g. 1.5in)"
+        right:
+          string:
+            description: "Right margin (e.g. 1.5in)"
+  description:
+    short: "Page margins for Typst output."
+    long: |
+      A dictionary specifying page margins. Use `x` and `y` for symmetric
+      horizontal/vertical margins, or `top`, `bottom`, `left`, `right` for
+      individual sides. Values should include units (e.g. `1.5in`, `2cm`).
+
 - name: geometry
   schema:
     maybeArrayOf: string

src/resources/schema/document-reveal-layout.yml

@@ -33,38 +33,10 @@
 
 - name: margin
   tags:
-    formats: [revealjs, typst]
-  schema:
-    anyOf:
-      - number
-      - object:
-          closed: true
-          properties:
-            x:
-              string:
-                description: "Horizontal margin (e.g. 5cm)"
-            y:
-              string:
-                description: "Vertical margin (e.g. 5cm)"
-            top:
-              string:
-                description: "Top margin (e.g. 5cm)"
-            bottom:
-              string:
-                description: "Bottom margin (e.g. 5cm)"
-            left:
-              string:
-                description: "Left margin (e.g. 5cm)"
-            right:
-              string:
-                description: "Right margin (e.g. 5cm)"
+    formats: [revealjs]
+  schema: number
   default: 0.1
-  description: |
-    For `revealjs`, the factor of the display size that should remain empty around the content (e.g. 0.1).
-
-    For `typst`, a dictionary with the fields defined in the Typst documentation:
-    `x`, `y`, `top`, `bottom`, `left`, `right` (margins are specified in `cm` units,
-    e.g. `5cm`).
+  description: "Factor of the display size that should remain empty around the content (e.g. 0.1)."
 
 - name: min-scale
   tags:

src/resources/schema/document-typst.yml

@@ -39,6 +39,7 @@
     short: "Visual style for theorem environments in Typst output."
     long: |
       Controls how theorems, lemmas, definitions, etc. are rendered:
+
       - `simple`: Plain text with bold title and italic body (default)
       - `fancy`: Colored boxes using brand colors
       - `clouds`: Rounded colored background boxes

src/resources/schema/groups.yml

@@ -25,6 +25,8 @@ document:
     title: "Title & Author"
   dashboard:
     title: "Dashboard"
+  typst:
+    title: "Typst"
   options:
     title: "Format Options"
   toc: