proper schemas for typst and revealjs logos

fixes #12180

typst needs separate schema because path is optional for typst logo object

Author: gordonwoodhull

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/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."

tests/docs/smoke-all/brand/logo/override-logo-path-alt.qmd

@@ -1,7 +1,14 @@
 ---
 title: brand and base logo
 format:
-  dashboard: default
+  dashboard:
+    logo:
+      path: posit-logo-2024.svg
+      alt: posit logo
+  revealjs: # test schema
+    logo:
+      path: posit-logo-2024.svg
+      alt: posit logo
 brand:
   logo:
     images:
@@ -13,9 +20,6 @@ brand:
         alt: posit logo
     medium: quarto
     large: posit
-logo:
-  path: posit-logo-2024.svg
-  alt: posit logo
 _quarto:
   tests:
     dashboard: