docs: update description for brand typography "files" field

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

@@ -12499,7 +12499,7 @@ var require_yaml_intelligence_resources = __commonJS({
                     }
                   ]
                 },
-                description: "The font files to include. These can be local or online. Local file paths should be relative to the `brand.yml` file. Online paths should be complete URLs.\n"
+                description: "The font files to include as an array (`- path: <path>` or `- <path>`). These can be local or online. Local file paths should be relative to the `brand.yml` file. Online paths should be complete URLs.\n"
               }
             },
             required: [
@@ -19887,6 +19887,13 @@ var require_yaml_intelligence_resources = __commonJS({
           },
           errorMessage: "type key not supported at project type-level. Use `project: type: ...` instead.",
           description: "internal-schema-hack"
+        },
+        {
+          name: "engines",
+          schema: {
+            arrayOf: "string"
+          },
+          description: "List execution engines you want to give priority when determining which engine should render a notebook. If two engines have support for a notebook, the one listed earlier will be chosen. Quarto's default order is 'knitr', 'jupyter', 'markdown', 'julia'."
         }
       ],
       "schema/schema.yml": [
@@ -21893,7 +21900,7 @@ var require_yaml_intelligence_resources = __commonJS({
         "The font display method, determines how a font face is font face is\nshown depending on its download status and readiness for use.",
         "A method for providing font files directly, either locally or from an\nonline location.",
         "The font family name.",
-        "The font files to include. These can be local or online. Local file\npaths should be relative to the <code>brand.yml</code> file. Online\npaths should be complete URLs.",
+        "The font files to include as an array (<em>i.e.</em>,\n<code>- path: &lt;path&gt;</code>). These can be local or online. Local\nfile paths should be relative to the <code>brand.yml</code> file. Online\npaths should be complete URLs.",
         "The path to the font file. This can be a local path or a URL.",
         "A locally-installed font family name. When used, the end-user is\nresponsible for ensuring that the font is installed on their system.",
         {
@@ -23616,6 +23623,7 @@ var require_yaml_intelligence_resources = __commonJS({
         "Disambiguating year suffix in author-date styles (e.g.&nbsp;\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.",
         {
           short: "Include an automatically generated table of contents",
           long: ""
@@ -23967,7 +23975,8 @@ var require_yaml_intelligence_resources = __commonJS({
         },
         "Disambiguating year suffix in author-date styles (e.g.&nbsp;\u201Ca\u201D in \u201CDoe,\n1999a\u201D).",
         "Manuscript configuration",
-        "internal-schema-hack"
+        "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."
       ],
       "schema/external-schemas.yml": [
         {
@@ -24196,12 +24205,12 @@ var require_yaml_intelligence_resources = __commonJS({
         mermaid: "%%"
       },
       "handlers/mermaid/schema.yml": {
-        _internalId: 194269,
+        _internalId: 194332,
         type: "object",
         description: "be an object",
         properties: {
           "mermaid-format": {
-            _internalId: 194261,
+            _internalId: 194324,
             type: "enum",
             enum: [
               "png",
@@ -24217,7 +24226,7 @@ var require_yaml_intelligence_resources = __commonJS({
             exhaustiveCompletions: true
           },
           theme: {
-            _internalId: 194268,
+            _internalId: 194331,
             type: "anyOf",
             anyOf: [
               {
@@ -33253,11 +33262,22 @@ var jupyterEngineSchema = defineCached(
   },
   "engine-jupyter"
 );
+var juliaEnginesSchema = defineCached(
+  // deno-lint-ignore require-await
+  async () => {
+    return {
+      schema: makeEngineSchema("julia"),
+      errorHandlers: []
+    };
+  },
+  "engine-julia"
+);
 async function getEngineOptionsSchema() {
   const obj = {
     markdown: await markdownEngineSchema(),
     knitr: await knitrEngineSchema(),
-    jupyter: await jupyterEngineSchema()
+    jupyter: await jupyterEngineSchema(),
+    julia: await juliaEnginesSchema()
   };
   return obj;
 }

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

@@ -5471,7 +5471,7 @@
                 }
               ]
             },
-            "description": "The font files to include. These can be local or online. Local file paths should be relative to the `brand.yml` file. Online paths should be complete URLs.\n"
+            "description": "The font files to include as an array (`- path: <path>` or `- <path>`). These can be local or online. Local file paths should be relative to the `brand.yml` file. Online paths should be complete URLs.\n"
           }
         },
         "required": [
@@ -12859,6 +12859,13 @@
       },
       "errorMessage": "type key not supported at project type-level. Use `project: type: ...` instead.",
       "description": "internal-schema-hack"
+    },
+    {
+      "name": "engines",
+      "schema": {
+        "arrayOf": "string"
+      },
+      "description": "List execution engines you want to give priority when determining which engine should render a notebook. If two engines have support for a notebook, the one listed earlier will be chosen. Quarto's default order is 'knitr', 'jupyter', 'markdown', 'julia'."
     }
   ],
   "schema/schema.yml": [
@@ -14865,7 +14872,7 @@
     "The font display method, determines how a font face is font face is\nshown depending on its download status and readiness for use.",
     "A method for providing font files directly, either locally or from an\nonline location.",
     "The font family name.",
-    "The font files to include. These can be local or online. Local file\npaths should be relative to the <code>brand.yml</code> file. Online\npaths should be complete URLs.",
+    "The font files to include as an array (<em>i.e.</em>,\n<code>- path: &lt;path&gt;</code>). These can be local or online. Local\nfile paths should be relative to the <code>brand.yml</code> file. Online\npaths should be complete URLs.",
     "The path to the font file. This can be a local path or a URL.",
     "A locally-installed font family name. When used, the end-user is\nresponsible for ensuring that the font is installed on their system.",
     {
@@ -16588,6 +16595,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": "Include an automatically generated table of contents",
       "long": ""
@@ -16939,7 +16947,8 @@
     },
     "Disambiguating year suffix in author-date styles (e.g.&nbsp;“a” in “Doe,\n1999a”).",
     "Manuscript configuration",
-    "internal-schema-hack"
+    "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’."
   ],
   "schema/external-schemas.yml": [
     {
@@ -17168,12 +17177,12 @@
     "mermaid": "%%"
   },
   "handlers/mermaid/schema.yml": {
-    "_internalId": 194269,
+    "_internalId": 194332,
     "type": "object",
     "description": "be an object",
     "properties": {
       "mermaid-format": {
-        "_internalId": 194261,
+        "_internalId": 194324,
         "type": "enum",
         "enum": [
           "png",
@@ -17189,7 +17198,7 @@
         "exhaustiveCompletions": true
       },
       "theme": {
-        "_internalId": 194268,
+        "_internalId": 194331,
         "type": "anyOf",
         "anyOf": [
           {

src/resources/schema/definitions.yml

@@ -2954,7 +2954,8 @@
                     #     string:
                     #       pattern: '^U\+[0-9A-F]{4}(?:-[0-9A-F]{4})?(?:,U\+[0-9A-F]{4}(?:-[0-9A-F]{4})?)*$'
         description: >
-          The font files to include. These can be local or online.
+          The font files to include as an array (`- path: <path>` or `- <path>`).
+          These can be local or online.
           Local file paths should be relative to the `brand.yml` file.
           Online paths should be complete URLs.
     required: [files, family, source]

src/resources/types/schema-types.ts

@@ -1469,7 +1469,7 @@ export type BrandFontFile = {
     path: string;
     style?: BrandFontStyle;
     weight?: BrandFontWeight;
-  }))[] /* The font files to include. These can be local or online. Local file paths should be relative to the `brand.yml` file. Online paths should be complete URLs. */;
+  }))[] /* The font files to include as an array (`- path: <path>` or `- <path>`). These can be local or online. Local file paths should be relative to the `brand.yml` file. Online paths should be complete URLs. */;
   source: "file";
 }; /* A method for providing font files directly, either locally or from an online location. */