proper schema for typst logo

news/changelog-1.8.md

@@ -43,6 +43,7 @@ All changes included in 1.8:
 
 ### `typst`
 
+- ([#12180](https://github.com/quarto-dev/quarto-cli/issues/12180): Typst schema / autocomplete for `logo` option has `path` and `alt`.
 - ([#12554](https://github.com/quarto-dev/quarto-cli/pull/12554)): CSS properties `font-weight` and `font-style` are translated to Typst `text` properties.
 - ([#12695](https://github.com/quarto-dev/quarto-cli/issues/12695)): Resolve Typst `font-paths` that start with `/` relative to project root.
 - ([#12739](https://github.com/quarto-dev/quarto-cli/pull/12739)): Remove unused variable `heading-background-color` and `heading-decoration` from Typst's templates. They are leftover from previous change, and not part of Brand.yml schema for typography of headings.

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

@@ -12035,6 +12035,33 @@ var require_yaml_intelligence_resources = __commonJS({
             }
           ]
         },
+        {
+          id: "logo-options-path-optional",
+          object: {
+            closed: false,
+            properties: {
+              path: {
+                schema: "path",
+                description: "Path or brand.yml logo resource name.\n"
+              },
+              alt: {
+                schema: "string",
+                description: "Alternative text for the logo, used for accessibility.\n"
+              }
+            }
+          }
+        },
+        {
+          id: "logo-specifier-path-optional",
+          anyOf: [
+            "string",
+            {
+              schema: {
+                ref: "logo-options-path-optional"
+              }
+            }
+          ]
+        },
         {
           id: "logo-light-dark-specifier",
           description: "Any of the ways a logo can be specified: string, object, or light/dark object of string or object\n",
@@ -18288,15 +18315,11 @@ var require_yaml_intelligence_resources = __commonJS({
           name: "logo",
           tags: {
             formats: [
-              "revealjs",
-              "typst"
+              "revealjs"
             ]
           },
           schema: {
-            anyOf: [
-              "string",
-              "object"
-            ]
+            ref: "logo-specifier"
           },
           description: "Logo image (placed in bottom right corner of slides)"
         },
@@ -24614,7 +24637,10 @@ var require_yaml_intelligence_resources = __commonJS({
         "Disambiguating year suffix in author-date styles (e.g. \u201Ca\u201D in \u201CDoe,\n1999a\u201D).",
         "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\u2019s default order\nis \u2018knitr\u2019, \u2018jupyter\u2019, \u2018markdown\u2019, \u2018julia\u2019."
+        "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\u2019s default order\nis \u2018knitr\u2019, \u2018jupyter\u2019, \u2018markdown\u2019, \u2018julia\u2019.",
+        "Path or brand.yml logo resource name.",
+        "Alternative text for the logo, used for accessibility.",
+        "The logo image."
       ],
       "schema/external-schemas.yml": [
         {
@@ -24843,12 +24869,12 @@ var require_yaml_intelligence_resources = __commonJS({
         mermaid: "%%"
       },
       "handlers/mermaid/schema.yml": {
-        _internalId: 197491,
+        _internalId: 197511,
         type: "object",
         description: "be an object",
         properties: {
           "mermaid-format": {
-            _internalId: 197483,
+            _internalId: 197503,
             type: "enum",
             enum: [
               "png",
@@ -24864,7 +24890,7 @@ var require_yaml_intelligence_resources = __commonJS({
             exhaustiveCompletions: true
           },
           theme: {
-            _internalId: 197490,
+            _internalId: 197510,
             type: "anyOf",
             anyOf: [
               {
@@ -24929,6 +24955,20 @@ var require_yaml_intelligence_resources = __commonJS({
           },
           description: "When defined, run axe-core accessibility tests on the document."
         }
+      ],
+      "schema/document-typst.yml": [
+        {
+          name: "logo",
+          schema: {
+            ref: "logo-specifier-path-optional"
+          },
+          tags: {
+            formats: [
+              "typst"
+            ]
+          },
+          description: "The logo image."
+        }
       ]
     };
   }

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

@@ -5007,6 +5007,33 @@
         }
       ]
     },
+    {
+      "id": "logo-options-path-optional",
+      "object": {
+        "closed": false,
+        "properties": {
+          "path": {
+            "schema": "path",
+            "description": "Path or brand.yml logo resource name.\n"
+          },
+          "alt": {
+            "schema": "string",
+            "description": "Alternative text for the logo, used for accessibility.\n"
+          }
+        }
+      }
+    },
+    {
+      "id": "logo-specifier-path-optional",
+      "anyOf": [
+        "string",
+        {
+          "schema": {
+            "ref": "logo-options-path-optional"
+          }
+        }
+      ]
+    },
     {
       "id": "logo-light-dark-specifier",
       "description": "Any of the ways a logo can be specified: string, object, or light/dark object of string or object\n",
@@ -11260,15 +11287,11 @@
       "name": "logo",
       "tags": {
         "formats": [
-          "revealjs",
-          "typst"
+          "revealjs"
         ]
       },
       "schema": {
-        "anyOf": [
-          "string",
-          "object"
-        ]
+        "ref": "logo-specifier"
       },
       "description": "Logo image (placed in bottom right corner of slides)"
     },
@@ -17586,7 +17609,10 @@
     "Disambiguating year suffix in author-date styles (e.g. “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’."
+    "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’.",
+    "Path or brand.yml logo resource name.",
+    "Alternative text for the logo, used for accessibility.",
+    "The logo image."
   ],
   "schema/external-schemas.yml": [
     {
@@ -17815,12 +17841,12 @@
     "mermaid": "%%"
   },
   "handlers/mermaid/schema.yml": {
-    "_internalId": 197491,
+    "_internalId": 197511,
     "type": "object",
     "description": "be an object",
     "properties": {
       "mermaid-format": {
-        "_internalId": 197483,
+        "_internalId": 197503,
         "type": "enum",
         "enum": [
           "png",
@@ -17836,7 +17862,7 @@
         "exhaustiveCompletions": true
       },
       "theme": {
-        "_internalId": 197490,
+        "_internalId": 197510,
         "type": "anyOf",
         "anyOf": [
           {
@@ -17901,5 +17927,19 @@
       },
       "description": "When defined, run axe-core accessibility tests on the document."
     }
+  ],
+  "schema/document-typst.yml": [
+    {
+      "name": "logo",
+      "schema": {
+        "ref": "logo-specifier-path-optional"
+      },
+      "tags": {
+        "formats": [
+          "typst"
+        ]
+      },
+      "description": "The logo image."
+    }
   ]
 }

src/resources/schema/definitions.yml

@@ -2619,6 +2619,25 @@
     - schema:
         ref: logo-options
 
+- id: logo-options-path-optional
+  object:
+    closed: false # e.g. to allow typst location, padding, padding-*, width
+    properties:
+      path:
+        schema: path
+        description: >
+          Path or brand.yml logo resource name.
+      alt:
+        schema: string
+        description: >
+          Alternative text for the logo, used for accessibility.
+
+- id: logo-specifier-path-optional
+  anyOf:
+    - string
+    - schema:
+        ref: logo-options-path-optional
+
 - id: logo-light-dark-specifier
   description: >
     Any of the ways a logo can be specified: string, object, or light/dark object of

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

@@ -1,10 +1,8 @@
 - name: logo
   tags:
-    formats: [revealjs, typst]
+    formats: [revealjs]
   schema:
-    anyOf:
-      - string
-      - object
+    ref: logo-specifier
   description: "Logo image (placed in bottom right corner of slides)"
 
 - name: footer

src/resources/schema/document-typst.yml

@@ -0,0 +1,6 @@
+- name: logo
+  schema:
+    ref: logo-specifier-path-optional
+  tags:
+    formats: [typst]
+  description: "The logo image."