@cloudcannon/configuration-types 0.0.50 → 0.0.52

package/dist/documentation.json

@@ -671,7 +671,7 @@
     "collections_config.*.path": {
       "gid": "collections_config.*.path",
       "title": "",
-      "description": "This key defines the folder path for the collection key in which it is nested.\n\nThe value for this key is relative to your [Site source](/documentation/articles/configuration-file-reference/#source).\n\nEach Collection must have a unique path.",
+      "description": "This key defines the folder path for the collection key in which it is nested.\n\nThe value for this key is relative to your [Site source](/documentation/developer-reference/configuration-file/source/).\n\nEach Collection must have a unique path.",
       "examples": [
         {
           "description": "In this example, the files for the `blog` Collection are located in the `content/blog` folder.",
@@ -686,7 +686,7 @@
         "gid": "collections_config.*.path",
         "url": "/configuration-file/collections_config/*/path/",
         "title": "",
-        "description": "This key defines the folder path for the collection key in which it is nested.\n\nThe value for this key is relative to your [Site source](/documentation/articles/configuration-file-reference/#source).\n\nEach Collection must have a unique path.",
+        "description": "This key defines the folder path for the collection key in which it is nested.\n\nThe value for this key is relative to your [Site source](/documentation/developer-reference/configuration-file/source/).\n\nEach Collection must have a unique path.",
         "examples": [
           {
             "description": "In this example, the files for the `blog` Collection are located in the `content/blog` folder.",
@@ -711,7 +711,7 @@
     "collections_config.*.glob": {
       "gid": "collections_config.*.glob",
       "title": "",
-      "description": "This key defines globs which filter the files visible in the *Collection browser* for a given Collection.\n\nValues in this array are relative to the Collection [path](/documentation/articles/collections-reference/#path).\n\nGlobs can be positive (e.g. `*.yml`), or negative (e.g. `!**/*.json`).\n\nFiles are included in a Collection if they match any positive globs and do not match any negative globs.\n\nIf you do not define any positive globs, CloudCannon will include all non-developer files in a Collection unless they match a negative\nglob.\n\n> For more information about developer files, please read our documentation on the [include\\_developer\\_files](/documentation/articles/collections-reference/#include_developer_files) key.\n\nDefining a negative glob for a Collection does not remove a file from the associated Collection folder in your Git repository.\n\nSimilarly, defining a positive glob for a file in a folder outside your Collection path does not move the file.",
+      "description": "This key defines globs which filter the files visible in the *Collection browser* for a given Collection.\n\nGlobs can be positive (e.g. `*.yml`), or negative (e.g. `!**/*.json`).\n\nFiles are included in a Collection if they match any positive globs and do not match any negative globs.\n\nIf you do not define any positive globs, CloudCannon will include all non-developer files in a Collection unless they match a negative\nglob.\n\nDefining a negative glob for a Collection does not remove a file from the associated Collection folder in your Git repository.\n\nSimilarly, defining a positive glob for a file in a folder outside your Collection path does not move the file.",
       "examples": [
         {
           "description": "In this example, the *Collection browser* will show all files in the `data` folder except for the `secret.yml` file.",
@@ -739,7 +739,7 @@
         "gid": "collections_config.*.glob",
         "url": "/configuration-file/collections_config/*/glob/",
         "title": "",
-        "description": "This key defines globs which filter the files visible in the *Collection browser* for a given Collection.\n\nValues in this array are relative to the Collection [path](/documentation/articles/collections-reference/#path).\n\nGlobs can be positive (e.g. `*.yml`), or negative (e.g. `!**/*.json`).\n\nFiles are included in a Collection if they match any positive globs and do not match any negative globs.\n\nIf you do not define any positive globs, CloudCannon will include all non-developer files in a Collection unless they match a negative\nglob.\n\n> For more information about developer files, please read our documentation on the [include\\_developer\\_files](/documentation/articles/collections-reference/#include_developer_files) key.\n\nDefining a negative glob for a Collection does not remove a file from the associated Collection folder in your Git repository.\n\nSimilarly, defining a positive glob for a file in a folder outside your Collection path does not move the file.",
+        "description": "This key defines globs which filter the files visible in the *Collection browser* for a given Collection.\n\nGlobs can be positive (e.g. `*.yml`), or negative (e.g. `!**/*.json`).\n\nFiles are included in a Collection if they match any positive globs and do not match any negative globs.\n\nIf you do not define any positive globs, CloudCannon will include all non-developer files in a Collection unless they match a negative\nglob.\n\nDefining a negative glob for a Collection does not remove a file from the associated Collection folder in your Git repository.\n\nSimilarly, defining a positive glob for a file in a folder outside your Collection path does not move the file.",
         "examples": [
           {
             "description": "In this example, the *Collection browser* will show all files in the `data` folder except for the `secret.yml` file.",
@@ -990,7 +990,7 @@
     "collections_config.*.include_developer_files": {
       "gid": "collections_config.*.include_developer_files",
       "title": "",
-      "description": "This key toggles whether CloudCannon removes developer files from your *Collection browser*. CloudCannon excludes files that probably shouldn't be edited in a CMS from your *Collection browser*, for example files like `README.md` or\n`package.json`. CloudCannon excludes these files even if you have configured globs to allow them.\n\nSetting this key to `true` will allow CloudCannon to show developer files,\nassuming they are not filtered out by any configured\n[globs](/documentation/articles/collections-reference/#glob).",
+      "description": "This key toggles whether CloudCannon removes developer files from your *Collection browser*. CloudCannon excludes files that probably shouldn't be edited in a CMS from your *Collection browser*, for example files like `README.md` or\n`package.json`. CloudCannon excludes these files even if you have configured globs to allow them.\n\nSetting this key to `true` will allow CloudCannon to show developer files,\nassuming they are not filtered out by any configured\n[globs](/documentation/developer-reference/configuration-file/collections_config/*/glob/). ",
       "examples": [
         {
           "description": "In this example, we want to see developer files in the *Collection browser* for the `data` Collection.",
@@ -1006,7 +1006,7 @@
         "gid": "collections_config.*.include_developer_files",
         "url": "/configuration-file/collections_config/*/include_developer_files/",
         "title": "",
-        "description": "This key toggles whether CloudCannon removes developer files from your *Collection browser*. CloudCannon excludes files that probably shouldn't be edited in a CMS from your *Collection browser*, for example files like `README.md` or\n`package.json`. CloudCannon excludes these files even if you have configured globs to allow them.\n\nSetting this key to `true` will allow CloudCannon to show developer files,\nassuming they are not filtered out by any configured\n[globs](/documentation/articles/collections-reference/#glob).",
+        "description": "This key toggles whether CloudCannon removes developer files from your *Collection browser*. CloudCannon excludes files that probably shouldn't be edited in a CMS from your *Collection browser*, for example files like `README.md` or\n`package.json`. CloudCannon excludes these files even if you have configured globs to allow them.\n\nSetting this key to `true` will allow CloudCannon to show developer files,\nassuming they are not filtered out by any configured\n[globs](/documentation/developer-reference/configuration-file/collections_config/*/glob/). ",
         "examples": [
           {
             "description": "In this example, we want to see developer files in the *Collection browser* for the `data` Collection.",
@@ -8858,7 +8858,7 @@
     "collections_config.*.add_options": {
       "gid": "collections_config.*.add_options",
       "title": "",
-      "description": "This key defines the options available in the *\\+ Add* button dropdown at the top right of your *Collection browser*.\n\nConfiguring add options for a Collection will remove CloudCannon's default \"Add a file\" option from the *\\+ Add* button dropdown.\n\nAdditionally, any Schemas you have configured for a Collection will also appear in the *\\+ Add* dropdown.\n\nFor more information on these options, please read our reference documentation on [disable\\_add](/documentation/articles/collections-reference/#disable_add), [disable\\_add\\_folder](/documentation/articles/collections-reference/#disable_add_folder), and [schemas](/documentation/articles/schemas-reference/#schemas).",
+      "description": "This key defines the options available in the *\\+ Add* button dropdown at the top right of your *Collection browser*.\n\nConfiguring add options for a Collection will remove CloudCannon's default \"Add a file\" option from the *\\+ Add* button dropdown.\n\nAdditionally, any Schemas you have configured for a Collection will also appear in the *\\+ Add* dropdown.",
       "examples": [
         {
           "description": "In this example, we have configured two standard add options for the `people` Collection. The first option uses the `employee` Schema, and the second option uses the `contractor` Schema and opens files in the [Data Editor](/documentation/articles/what-is-the-data-editor/).",
@@ -8880,7 +8880,7 @@
         "gid": "collections_config.*.add_options",
         "url": "/configuration-file/collections_config/*/add_options/",
         "title": "",
-        "description": "This key defines the options available in the *\\+ Add* button dropdown at the top right of your *Collection browser*.\n\nConfiguring add options for a Collection will remove CloudCannon's default \"Add a file\" option from the *\\+ Add* button dropdown.\n\nAdditionally, any Schemas you have configured for a Collection will also appear in the *\\+ Add* dropdown.\n\nFor more information on these options, please read our reference documentation on [disable\\_add](/documentation/articles/collections-reference/#disable_add), [disable\\_add\\_folder](/documentation/articles/collections-reference/#disable_add_folder), and [schemas](/documentation/articles/schemas-reference/#schemas).",
+        "description": "This key defines the options available in the *\\+ Add* button dropdown at the top right of your *Collection browser*.\n\nConfiguring add options for a Collection will remove CloudCannon's default \"Add a file\" option from the *\\+ Add* button dropdown.\n\nAdditionally, any Schemas you have configured for a Collection will also appear in the *\\+ Add* dropdown.",
         "examples": [
           {
             "description": "In this example, we have configured two standard add options for the `people` Collection. The first option uses the `employee` Schema, and the second option uses the `contractor` Schema and opens files in the [Data Editor](/documentation/articles/what-is-the-data-editor/).",
@@ -12753,7 +12753,7 @@
     "collections_config.*.add_options.[*].(add-option).base_path": {
       "gid": "collections_config.*.add_options.[*].(add-option).base_path",
       "title": "",
-      "description": "This key defines a path for files created using an option in the *\\+ Add* button dropdown.\n\nThis path overrides the path for the current Collection and subfolder open in the *Collection browser*.\n\nThis key is useful if you need to specify a specific subfolder within a Collection.\n\nThe value for this key is relative to your Collection [path](/documentation/articles/collections-reference/#path).",
+      "description": "This key defines a path for files created using an option in the *\\+ Add* button dropdown.\n\nThis path overrides the path for the current Collection and subfolder open in the *Collection browser*.\n\nThis key is useful if you need to specify a specific subfolder within a Collection.",
       "examples": [
         {
           "description": "In this example, we want team members in the `_posts` Collection to create new files in the`blog` subfolder of the `_drafts` Collection rather than the current *Collection browser* they have open. By configuring the `base_path` value to `/../_drafts/blog`, new files will be created in a different Collection subfolder (i.e., `_drafts`) when a team member selects this option from the *\\+ Add* button dropdown.",
@@ -12768,7 +12768,7 @@
         "gid": "collections_config.*.add_options.[*].(add-option).base_path",
         "url": "/configuration-file/collections_config/*/add_options/[*]/(add-option)/base_path/",
         "title": "",
-        "description": "This key defines a path for files created using an option in the *\\+ Add* button dropdown.\n\nThis path overrides the path for the current Collection and subfolder open in the *Collection browser*.\n\nThis key is useful if you need to specify a specific subfolder within a Collection.\n\nThe value for this key is relative to your Collection [path](/documentation/articles/collections-reference/#path).",
+        "description": "This key defines a path for files created using an option in the *\\+ Add* button dropdown.\n\nThis path overrides the path for the current Collection and subfolder open in the *Collection browser*.\n\nThis key is useful if you need to specify a specific subfolder within a Collection.",
         "examples": [
           {
             "description": "In this example, we want team members in the `_posts` Collection to create new files in the`blog` subfolder of the `_drafts` Collection rather than the current *Collection browser* they have open. By configuring the `base_path` value to `/../_drafts/blog`, new files will be created in a different Collection subfolder (i.e., `_drafts`) when a team member selects this option from the *\\+ Add* button dropdown.",
@@ -36742,7 +36742,7 @@
     "type._structures_from_glob": {
       "gid": "type._structures_from_glob",
       "title": "",
-      "description": "This key defines globs that filter which files CloudCannon should use for *Structure* configuration.\n\nValues in this array are relative to the root of your repository (i.e., `/`, not the value of `source`) and must end in the file extension\n`.cloudcannon.structures.yml`.\n\nYou can use this key anywhere you would use the `_structures` key in the configuration cascade.\n\nPlease see our documentation on [values_from_glob](/documentation/articles/configuration-file-reference/#values_from_glob) for defining individual\n*Structure* values in a split *Configuration File*.\n\nThis key has no default.",
+      "description": "This key defines globs that filter which files CloudCannon should use for *Structure* configuration.\n\nValues in this array are relative to the root of your repository (i.e., `/`, not the value of `source`) and must end in the file extension\n`.cloudcannon.structures.yml`.\n\nYou can use this key anywhere you would use the `_structures` key in the configuration cascade.\n\nPlease see our documentation on [values_from_glob](/documentation/developer-reference/configuration-file/types/structure/values_from_glob/) for defining individual\n*Structure* values in a split *Configuration File*.\n\nThis key has no default.",
       "examples": [
         {
           "description": "In this example, we have several *Structure Configuration Files* in the `.cloudcannon/structures/` folder. The value of the `_structures_from_glob` key tells CloudCannon to use the `staffMembers.cloudcannon.structures.yml` file in that folder.",
@@ -36764,7 +36764,7 @@
         "gid": "type._structures_from_glob",
         "url": "/configuration-file/types/_structures_from_glob/",
         "title": "",
-        "description": "This key defines globs that filter which files CloudCannon should use for *Structure* configuration.\n\nValues in this array are relative to the root of your repository (i.e., `/`, not the value of `source`) and must end in the file extension\n`.cloudcannon.structures.yml`.\n\nYou can use this key anywhere you would use the `_structures` key in the configuration cascade.\n\nPlease see our documentation on [values_from_glob](/documentation/articles/configuration-file-reference/#values_from_glob) for defining individual\n*Structure* values in a split *Configuration File*.\n\nThis key has no default.",
+        "description": "This key defines globs that filter which files CloudCannon should use for *Structure* configuration.\n\nValues in this array are relative to the root of your repository (i.e., `/`, not the value of `source`) and must end in the file extension\n`.cloudcannon.structures.yml`.\n\nYou can use this key anywhere you would use the `_structures` key in the configuration cascade.\n\nPlease see our documentation on [values_from_glob](/documentation/developer-reference/configuration-file/types/structure/values_from_glob/) for defining individual\n*Structure* values in a split *Configuration File*.\n\nThis key has no default.",
         "examples": [
           {
             "description": "In this example, we have several *Structure Configuration Files* in the `.cloudcannon/structures/` folder. The value of the `_structures_from_glob` key tells CloudCannon to use the `staffMembers.cloudcannon.structures.yml` file in that folder.",
@@ -41146,7 +41146,7 @@
     "type.structure.values_from_glob": {
       "gid": "type.structure.values_from_glob",
       "title": "",
-      "description": "This key defines globs that filter which files CloudCannon should use for *Structure* value configuration.\n\nValues in this array are relative to the root of your repository (i.e., `/`, not the value of `source`) and must end in the file extension\n`.cloudcannon.structure-value.yml` (note the singular form of \"value\").\n\nYou can use this key anywhere you would use the `_structures.*.values` key.\n\nPlease see our documentation on [structures_from_glob](/documentation/articles/configuration-file-reference/#_structures_from_glob) for defining a\n*Structure* in a split *Configuration File*.\n\nThis key has no default.",
+      "description": "This key defines globs that filter which files CloudCannon should use for *Structure* value configuration.\n\nValues in this array are relative to the root of your repository (i.e., `/`, not the value of `source`) and must end in the file extension\n`.cloudcannon.structure-value.yml` (note the singular form of \"value\").\n\nYou can use this key anywhere you would use the `_structures.*.values` key.\n\nPlease see our documentation on [structures_from_glob](/documentation/developer-reference/configuration-file/types/_structures_from_glob/) for defining a\n*Structure* in a split *Configuration File*.\n\nThis key has no default.",
       "examples": [
         {
           "description": "In this example, the `staff` Array Input uses inline *Structure* values from the main *Configuration File* and also references another value from the `boardMember.cloudcannon.structure_value.yml` in the `/.cloudcannon/structures/` folder.",
@@ -41168,7 +41168,7 @@
         "gid": "type.structure.values_from_glob",
         "url": "/configuration-file/types/structure/values_from_glob/",
         "title": "",
-        "description": "This key defines globs that filter which files CloudCannon should use for *Structure* value configuration.\n\nValues in this array are relative to the root of your repository (i.e., `/`, not the value of `source`) and must end in the file extension\n`.cloudcannon.structure-value.yml` (note the singular form of \"value\").\n\nYou can use this key anywhere you would use the `_structures.*.values` key.\n\nPlease see our documentation on [structures_from_glob](/documentation/articles/configuration-file-reference/#_structures_from_glob) for defining a\n*Structure* in a split *Configuration File*.\n\nThis key has no default.",
+        "description": "This key defines globs that filter which files CloudCannon should use for *Structure* value configuration.\n\nValues in this array are relative to the root of your repository (i.e., `/`, not the value of `source`) and must end in the file extension\n`.cloudcannon.structure-value.yml` (note the singular form of \"value\").\n\nYou can use this key anywhere you would use the `_structures.*.values` key.\n\nPlease see our documentation on [structures_from_glob](/documentation/developer-reference/configuration-file/types/_structures_from_glob/) for defining a\n*Structure* in a split *Configuration File*.\n\nThis key has no default.",
         "examples": [
           {
             "description": "In this example, the `staff` Array Input uses inline *Structure* values from the main *Configuration File* and also references another value from the `boardMember.cloudcannon.structure_value.yml` in the `/.cloudcannon/structures/` folder.",
@@ -50376,7 +50376,9 @@
       "appears_in": [
         "type.snippet.params.*.(argument-list-parser-config).options.models",
         "type.snippet.params.*.(argument-parser-config).options",
-        "type.snippet.params.*.(key-value-list-parser-config).options.models"
+        "type.snippet.params.*.(key-value-list-parser-config).options.models",
+        "type.snippet-definition-value",
+        "type.snippet-definition-value.(parser-model-array)"
       ],
       "properties": {
         "source_key": {
@@ -50908,7 +50910,8 @@
       "appears_in": [
         "type.snippet.params.*.(argument-list-parser-config).options",
         "type.snippet.params.*.(argument-parser-config).options",
-        "type.snippet.params.*.(key-value-list-parser-config).options"
+        "type.snippet.params.*.(key-value-list-parser-config).options",
+        "type.snippet-definition-value"
       ],
       "properties": {
         "root_boundary": {
@@ -57015,19 +57018,64 @@
     "type._snippets_definitions": {
       "gid": "type._snippets_definitions",
       "title": "",
-      "description": "This key defines extended options used when creating more complex custom snippets.",
+      "description": "A record of reusable values that can be referenced in snippet templates. Values are substituted using `{ ref: \"key\" }` for direct replacement or `{ spread_ref: \"key\" }` for spreading arrays/objects. Common definition types include parser formats, argument models, select option lists, and simple string values like shortcode names.",
+      "examples": [
+        {
+          "description": "Define reusable values like shortcode names, argument models, and parser formats that can be referenced in snippet templates.",
+          "language": "yaml",
+          "code": "_snippets_definitions:\n  # Simple string value for the shortcode name\n  shortcode_name: \"highlight\"\n  content_key: \"content\"\n\n  # Array of argument models for positional arguments\n  positional_args:\n    - editor_key: \"language\"\n      type: \"string\"\n    - editor_key: \"linenos\"\n      type: \"boolean\"\n      optional: true\n      default: false\n\n  # Parser format configuration\n  custom_format:\n    root_pair_delimiter:\n      - \" \"\n    root_value_delimiter: \"=\"\n    string_boundary:\n      - '\"'\n      - \"'\"\n      - \"\"\n    allow_booleans: true\n    allow_numbers: true",
+          "annotations": [],
+          "source": "/cloudcannon.config.yml"
+        },
+        {
+          "description": "Reference definitions in snippet templates using `{ ref: \"key\" }` syntax. This allows you to reuse common configurations across multiple snippets.",
+          "language": "yaml",
+          "code": "_snippets_definitions:\n  shortcode_name: \"figure\"\n  named_args:\n    - editor_key: \"src\"\n      type: \"string\"\n    - editor_key: \"alt\"\n      type: \"string\"\n      optional: true\n\n_snippets_templates:\n  my_shortcode_template:\n    snippet: \"{{< [[name]] [[args]] >}}\"\n    params:\n      name:\n        parser: \"literal\"\n        options:\n          literal:\n            ref: \"shortcode_name\"\n      args:\n        parser: \"key_values\"\n        options:\n          models:\n            ref: \"named_args\"\n\n_snippets:\n  figure:\n    template: \"my_shortcode_template\"\n    definitions:\n      shortcode_name: \"figure\"\n      named_args:\n        - editor_key: \"src\"\n          type: \"string\"\n        - editor_key: \"alt\"\n          type: \"string\"",
+          "annotations": [],
+          "source": "/cloudcannon.config.yml"
+        },
+        {
+          "description": "Define a list of select options for use in snippet inputs, such as a list of programming languages for a code highlighting snippet.",
+          "language": "yaml",
+          "code": "_snippets_definitions:\n  languages:\n    - name: \"JavaScript\"\n      value: \"js\"\n    - name: \"Python\"\n      value: \"python\"\n    - name: \"Ruby\"\n      value: \"ruby\"\n    - name: \"HTML\"\n      value: \"html\"\n    - name: \"CSS\"\n      value: \"css\"",
+          "annotations": [],
+          "source": "/cloudcannon.config.yml"
+        }
+      ],
       "type": "object",
       "documentation": {
         "gid": "type._snippets_definitions",
         "url": "/configuration-file/types/_snippets_definitions/",
         "title": "",
-        "description": "This key defines extended options used when creating more complex custom snippets.",
-        "examples": [],
-        "show_in_navigation": true
+        "description": "A record of reusable values that can be referenced in snippet templates. Values are substituted using `{ ref: \"key\" }` for direct replacement or `{ spread_ref: \"key\" }` for spreading arrays/objects. Common definition types include parser formats, argument models, select option lists, and simple string values like shortcode names.",
+        "examples": [
+          {
+            "description": "Define reusable values like shortcode names, argument models, and parser formats that can be referenced in snippet templates.",
+            "language": "yaml",
+            "code": "_snippets_definitions:\n  # Simple string value for the shortcode name\n  shortcode_name: \"highlight\"\n  content_key: \"content\"\n\n  # Array of argument models for positional arguments\n  positional_args:\n    - editor_key: \"language\"\n      type: \"string\"\n    - editor_key: \"linenos\"\n      type: \"boolean\"\n      optional: true\n      default: false\n\n  # Parser format configuration\n  custom_format:\n    root_pair_delimiter:\n      - \" \"\n    root_value_delimiter: \"=\"\n    string_boundary:\n      - '\"'\n      - \"'\"\n      - \"\"\n    allow_booleans: true\n    allow_numbers: true",
+            "annotations": [],
+            "source": "/cloudcannon.config.yml"
+          },
+          {
+            "description": "Reference definitions in snippet templates using `{ ref: \"key\" }` syntax. This allows you to reuse common configurations across multiple snippets.",
+            "language": "yaml",
+            "code": "_snippets_definitions:\n  shortcode_name: \"figure\"\n  named_args:\n    - editor_key: \"src\"\n      type: \"string\"\n    - editor_key: \"alt\"\n      type: \"string\"\n      optional: true\n\n_snippets_templates:\n  my_shortcode_template:\n    snippet: \"{{< [[name]] [[args]] >}}\"\n    params:\n      name:\n        parser: \"literal\"\n        options:\n          literal:\n            ref: \"shortcode_name\"\n      args:\n        parser: \"key_values\"\n        options:\n          models:\n            ref: \"named_args\"\n\n_snippets:\n  figure:\n    template: \"my_shortcode_template\"\n    definitions:\n      shortcode_name: \"figure\"\n      named_args:\n        - editor_key: \"src\"\n          type: \"string\"\n        - editor_key: \"alt\"\n          type: \"string\"",
+            "annotations": [],
+            "source": "/cloudcannon.config.yml"
+          },
+          {
+            "description": "Define a list of select options for use in snippet inputs, such as a list of programming languages for a code highlighting snippet.",
+            "language": "yaml",
+            "code": "_snippets_definitions:\n  languages:\n    - name: \"JavaScript\"\n      value: \"js\"\n    - name: \"Python\"\n      value: \"python\"\n    - name: \"Ruby\"\n      value: \"ruby\"\n    - name: \"HTML\"\n      value: \"html\"\n    - name: \"CSS\"\n      value: \"css\"",
+            "annotations": [],
+            "source": "/cloudcannon.config.yml"
+          }
+        ],
+        "show_in_navigation": false
       },
       "developer_documentation": {
         "title": "Snippets Definitions",
-        "description": "Extended option used when creating more complex custom snippets."
+        "description": "A record of reusable values that can be referenced in snippet templates. Values are substituted using { ref: \"key\" } for direct replacement or { spread_ref: \"key\" } for spreading arrays/objects."
       },
       "url": "/configuration-file/types/_snippets_definitions/",
       "required": false,
@@ -57038,10 +57086,395 @@
       ],
       "additionalProperties": [
         {
-          "type": "unknown"
+          "gid": "type.snippet-definition-value"
+        }
+      ]
+    },
+    "type.snippet-definition-value": {
+      "gid": "type.snippet-definition-value",
+      "title": "Snippet Definition Value",
+      "description": "A reusable value that can be referenced in snippet templates via `{ ref: \"key\" }` or `{ spread_ref: \"key\" }`. Can be a string, number, boolean, parser format, parser model, array of models, or array of select options.",
+      "documentation": {
+        "gid": "type.snippet-definition-value",
+        "url": "/configuration-file/types/snippet-definition-value/",
+        "title": "Snippet Definition Value",
+        "description": "A reusable value that can be referenced in snippet templates via `{ ref: \"key\" }` or `{ spread_ref: \"key\" }`. Can be a string, number, boolean, parser format, parser model, array of models, or array of select options.",
+        "examples": [],
+        "show_in_navigation": true
+      },
+      "developer_documentation": {
+        "title": "Snippet Definition Value",
+        "description": "A reusable value that can be referenced in snippet templates via { ref: \"key\" } or { spread_ref: \"key\" }."
+      },
+      "url": "/configuration-file/types/snippet-definition-value/",
+      "required": false,
+      "key": "snippet-definition-value",
+      "full_key": "snippet-definition-value",
+      "appears_in": [
+        "type._snippets_definitions"
+      ],
+      "anyOf": [
+        {
+          "gid": "type.snippet-format"
+        },
+        {
+          "gid": "type.snippet-model"
+        },
+        {
+          "gid": "type.snippet-definition-value.(parser-model-array)"
+        },
+        {
+          "gid": "type.snippet-definition-value.(select-values-array)"
+        },
+        {
+          "gid": "type.snippet-definition-value.(string-value)"
+        },
+        {
+          "gid": "type.snippet-definition-value.(number-value)"
+        },
+        {
+          "gid": "type.snippet-definition-value.(boolean-value)"
+        },
+        {
+          "gid": "type.snippet-definition-value.(string-array)"
+        }
+      ]
+    },
+    "type.snippet-definition-value.(parser-model-array)": {
+      "gid": "type.snippet-definition-value.(parser-model-array)",
+      "title": "Parser Model Array",
+      "description": "An array of parser model configurations. Typically used for `positional_args` or `named_args` definitions that specify the arguments a snippet accepts. Each model defines an argument's editor key, type, default value, and whether it's optional.",
+      "type": "array",
+      "documentation": {
+        "gid": "type.snippet-definition-value.(parser-model-array)",
+        "url": "/configuration-file/types/snippet-definition-value/(parser-model-array)/",
+        "title": "Parser Model Array",
+        "description": "An array of parser model configurations. Typically used for `positional_args` or `named_args` definitions that specify the arguments a snippet accepts. Each model defines an argument's editor key, type, default value, and whether it's optional.",
+        "examples": [],
+        "show_in_navigation": false
+      },
+      "developer_documentation": {
+        "title": "Parser Model Array",
+        "description": "An array of model configurations, typically used for positional_args or named_args."
+      },
+      "url": "/configuration-file/types/snippet-definition-value/(parser-model-array)/",
+      "required": false,
+      "key": "snippet-definition-value(parser-model-array)",
+      "full_key": "snippet-definition-value(parser-model-array)",
+      "parent": "type.snippet-definition-value",
+      "appears_in": [],
+      "items": [
+        {
+          "gid": "type.snippet-model"
+        }
+      ]
+    },
+    "type.snippet-definition-value.(select-values-array)": {
+      "gid": "type.snippet-definition-value.(select-values-array)",
+      "title": "Select Values Array",
+      "description": "An array of select option values. Commonly used for language lists in code highlighting snippets, where each option has a display name and a value. For example: `[{ name: \"JavaScript\", value: \"js\" }, { name: \"Python\", value: \"python\" }]`.",
+      "type": "array",
+      "documentation": {
+        "gid": "type.snippet-definition-value.(select-values-array)",
+        "url": "/configuration-file/types/snippet-definition-value/(select-values-array)/",
+        "title": "Select Values Array",
+        "description": "An array of select option values. Commonly used for language lists in code highlighting snippets, where each option has a display name and a value. For example: `[{ name: \"JavaScript\", value: \"js\" }, { name: \"Python\", value: \"python\" }]`.",
+        "examples": [],
+        "show_in_navigation": false
+      },
+      "developer_documentation": {
+        "title": "Select Values Array",
+        "description": "An array of select options, typically used for language lists."
+      },
+      "url": "/configuration-file/types/snippet-definition-value/(select-values-array)/",
+      "required": false,
+      "key": "snippet-definition-value(select-values-array)",
+      "full_key": "snippet-definition-value(select-values-array)",
+      "parent": "type.snippet-definition-value",
+      "appears_in": [],
+      "items": [
+        {
+          "gid": "type.snippet-definition-select-value"
+        }
+      ]
+    },
+    "type.snippet-definition-select-value": {
+      "gid": "type.snippet-definition-select-value",
+      "title": "Snippet Definition Select Value",
+      "description": "A value option for select inputs, typically used in language lists. Contains a display name and the actual value to use.",
+      "type": "object",
+      "documentation": {
+        "gid": "type.snippet-definition-select-value",
+        "url": "/configuration-file/types/snippet-definition-select-value/",
+        "title": "Snippet Definition Select Value",
+        "description": "A value option for select inputs, typically used in language lists. Contains a display name and the actual value to use.",
+        "examples": [],
+        "show_in_navigation": true
+      },
+      "developer_documentation": {
+        "title": "Snippet Definition Select Value",
+        "description": "A value option for select inputs, typically used in language lists."
+      },
+      "url": "/configuration-file/types/snippet-definition-select-value/",
+      "required": false,
+      "key": "snippet-definition-select-value",
+      "full_key": "snippet-definition-select-value",
+      "appears_in": [
+        "type.snippet-definition-value.(select-values-array)"
+      ],
+      "properties": {
+        "name": {
+          "gid": "type.snippet-definition-select-value.name"
+        },
+        "value": {
+          "gid": "type.snippet-definition-select-value.value"
+        }
+      }
+    },
+    "type.snippet-definition-select-value.name": {
+      "gid": "type.snippet-definition-select-value.name",
+      "title": "",
+      "description": "The display name shown to users when selecting this option. For example, \"JavaScript\" for a language with value \"js\".",
+      "type": "string",
+      "documentation": {
+        "gid": "type.snippet-definition-select-value.name",
+        "url": "/configuration-file/types/snippet-definition-select-value/name/",
+        "title": "",
+        "description": "The display name shown to users when selecting this option. For example, \"JavaScript\" for a language with value \"js\".",
+        "examples": [],
+        "show_in_navigation": false
+      },
+      "developer_documentation": {
+        "description": "The display name for this option."
+      },
+      "url": "/configuration-file/types/snippet-definition-select-value/name/",
+      "required": false,
+      "key": "name",
+      "full_key": "snippet-definition-select-value.name",
+      "parent": "type.snippet-definition-select-value",
+      "appears_in": []
+    },
+    "type.snippet-definition-select-value.value": {
+      "gid": "type.snippet-definition-select-value.value",
+      "title": "",
+      "description": "The actual value used when this option is selected. Can be a string, number, or boolean. For example, \"js\" for JavaScript or 4 for an indentation level.",
+      "documentation": {
+        "gid": "type.snippet-definition-select-value.value",
+        "url": "/configuration-file/types/snippet-definition-select-value/value/",
+        "title": "",
+        "description": "The actual value used when this option is selected. Can be a string, number, or boolean. For example, \"js\" for JavaScript or 4 for an indentation level.",
+        "examples": [],
+        "show_in_navigation": false
+      },
+      "developer_documentation": {
+        "description": "The value for this option."
+      },
+      "url": "/configuration-file/types/snippet-definition-select-value/value/",
+      "required": true,
+      "key": "value",
+      "full_key": "snippet-definition-select-value.value",
+      "parent": "type.snippet-definition-select-value",
+      "appears_in": [],
+      "anyOf": [
+        {
+          "gid": "type.snippet-definition-select-value.value.(string)"
+        },
+        {
+          "gid": "type.snippet-definition-select-value.value.(number)"
+        },
+        {
+          "gid": "type.snippet-definition-select-value.value.(boolean)"
+        }
+      ]
+    },
+    "type.snippet-definition-select-value.value.(string)": {
+      "gid": "type.snippet-definition-select-value.value.(string)",
+      "title": "String Select Value",
+      "type": "string",
+      "documentation": {
+        "gid": "type.snippet-definition-select-value.value.(string)",
+        "url": "/configuration-file/types/snippet-definition-select-value/value/(string)/",
+        "title": "String Select Value",
+        "description": "",
+        "examples": [],
+        "show_in_navigation": false
+      },
+      "developer_documentation": {
+        "title": "String"
+      },
+      "url": "/configuration-file/types/snippet-definition-select-value/value/(string)/",
+      "required": false,
+      "key": "value(string)",
+      "full_key": "snippet-definition-select-value.value(string)",
+      "parent": "type.snippet-definition-select-value.value",
+      "appears_in": []
+    },
+    "type.snippet-definition-select-value.value.(number)": {
+      "gid": "type.snippet-definition-select-value.value.(number)",
+      "title": "Number Select Value",
+      "type": "number",
+      "documentation": {
+        "gid": "type.snippet-definition-select-value.value.(number)",
+        "url": "/configuration-file/types/snippet-definition-select-value/value/(number)/",
+        "title": "Number Select Value",
+        "description": "",
+        "examples": [],
+        "show_in_navigation": false
+      },
+      "developer_documentation": {
+        "title": "Number"
+      },
+      "url": "/configuration-file/types/snippet-definition-select-value/value/(number)/",
+      "required": false,
+      "key": "value(number)",
+      "full_key": "snippet-definition-select-value.value(number)",
+      "parent": "type.snippet-definition-select-value.value",
+      "appears_in": []
+    },
+    "type.snippet-definition-select-value.value.(boolean)": {
+      "gid": "type.snippet-definition-select-value.value.(boolean)",
+      "title": "Boolean Select Value",
+      "type": "boolean",
+      "documentation": {
+        "gid": "type.snippet-definition-select-value.value.(boolean)",
+        "url": "/configuration-file/types/snippet-definition-select-value/value/(boolean)/",
+        "title": "Boolean Select Value",
+        "description": "",
+        "examples": [],
+        "show_in_navigation": false
+      },
+      "developer_documentation": {
+        "title": "Boolean"
+      },
+      "url": "/configuration-file/types/snippet-definition-select-value/value/(boolean)/",
+      "required": false,
+      "key": "value(boolean)",
+      "full_key": "snippet-definition-select-value.value(boolean)",
+      "parent": "type.snippet-definition-select-value.value",
+      "appears_in": []
+    },
+    "type.snippet-definition-value.(string-value)": {
+      "gid": "type.snippet-definition-value.(string-value)",
+      "title": "String Value",
+      "description": "A string value definition. Commonly used for `shortcode_name`, `tag_name`, `content_key`, `include_name`, and similar definitions that identify snippet components by name.",
+      "type": "string",
+      "documentation": {
+        "gid": "type.snippet-definition-value.(string-value)",
+        "url": "/configuration-file/types/snippet-definition-value/(string-value)/",
+        "title": "String Value",
+        "description": "A string value definition. Commonly used for `shortcode_name`, `tag_name`, `content_key`, `include_name`, and similar definitions that identify snippet components by name.",
+        "examples": [],
+        "show_in_navigation": false
+      },
+      "developer_documentation": {
+        "title": "String Value",
+        "description": "A string value, commonly used for shortcode_name, tag_name, content_key, and similar definitions."
+      },
+      "url": "/configuration-file/types/snippet-definition-value/(string-value)/",
+      "required": false,
+      "key": "snippet-definition-value(string-value)",
+      "full_key": "snippet-definition-value(string-value)",
+      "parent": "type.snippet-definition-value",
+      "appears_in": []
+    },
+    "type.snippet-definition-value.(number-value)": {
+      "gid": "type.snippet-definition-value.(number-value)",
+      "title": "Number Value",
+      "description": "A numeric value definition. Use for counts, sizes, or other numeric values that can be referenced in snippet templates.",
+      "type": "number",
+      "documentation": {
+        "gid": "type.snippet-definition-value.(number-value)",
+        "url": "/configuration-file/types/snippet-definition-value/(number-value)/",
+        "title": "Number Value",
+        "description": "A numeric value definition. Use for counts, sizes, or other numeric values that can be referenced in snippet templates.",
+        "examples": [],
+        "show_in_navigation": false
+      },
+      "developer_documentation": {
+        "title": "Number Value",
+        "description": "A numeric value."
+      },
+      "url": "/configuration-file/types/snippet-definition-value/(number-value)/",
+      "required": false,
+      "key": "snippet-definition-value(number-value)",
+      "full_key": "snippet-definition-value(number-value)",
+      "parent": "type.snippet-definition-value",
+      "appears_in": []
+    },
+    "type.snippet-definition-value.(boolean-value)": {
+      "gid": "type.snippet-definition-value.(boolean-value)",
+      "title": "Boolean Value",
+      "description": "A boolean value definition. Use for flags and toggles that can be referenced in snippet templates.",
+      "type": "boolean",
+      "documentation": {
+        "gid": "type.snippet-definition-value.(boolean-value)",
+        "url": "/configuration-file/types/snippet-definition-value/(boolean-value)/",
+        "title": "Boolean Value",
+        "description": "A boolean value definition. Use for flags and toggles that can be referenced in snippet templates.",
+        "examples": [],
+        "show_in_navigation": false
+      },
+      "developer_documentation": {
+        "title": "Boolean Value",
+        "description": "A boolean value."
+      },
+      "url": "/configuration-file/types/snippet-definition-value/(boolean-value)/",
+      "required": false,
+      "key": "snippet-definition-value(boolean-value)",
+      "full_key": "snippet-definition-value(boolean-value)",
+      "parent": "type.snippet-definition-value",
+      "appears_in": []
+    },
+    "type.snippet-definition-value.(string-array)": {
+      "gid": "type.snippet-definition-value.(string-array)",
+      "title": "String Array",
+      "description": "An array of string values. Useful for defining lists of allowed values, delimiters, or other string collections that can be referenced in snippet templates.",
+      "type": "array",
+      "documentation": {
+        "gid": "type.snippet-definition-value.(string-array)",
+        "url": "/configuration-file/types/snippet-definition-value/(string-array)/",
+        "title": "String Array",
+        "description": "An array of string values. Useful for defining lists of allowed values, delimiters, or other string collections that can be referenced in snippet templates.",
+        "examples": [],
+        "show_in_navigation": false
+      },
+      "developer_documentation": {
+        "title": "String Array",
+        "description": "An array of strings."
+      },
+      "url": "/configuration-file/types/snippet-definition-value/(string-array)/",
+      "required": false,
+      "key": "snippet-definition-value(string-array)",
+      "full_key": "snippet-definition-value(string-array)",
+      "parent": "type.snippet-definition-value",
+      "appears_in": [],
+      "items": [
+        {
+          "gid": "type.snippet-definition-value.(string-array).[*]"
         }
       ]
     },
+    "type.snippet-definition-value.(string-array).[*]": {
+      "gid": "type.snippet-definition-value.(string-array).[*]",
+      "title": "",
+      "description": "A string item in the array.",
+      "type": "string",
+      "documentation": {
+        "gid": "type.snippet-definition-value.(string-array).[*]",
+        "url": "/configuration-file/types/snippet-definition-value/(string-array)/[*]/",
+        "title": "",
+        "description": "A string item in the array.",
+        "examples": [],
+        "show_in_navigation": false
+      },
+      "developer_documentation": {},
+      "url": "/configuration-file/types/snippet-definition-value/(string-array)/[*]/",
+      "required": false,
+      "key": "snippet-definition-value(string-array)[*]",
+      "full_key": "snippet-definition-value(string-array)[*]",
+      "parent": "type.snippet-definition-value.(string-array)",
+      "appears_in": []
+    },
     "_snippets_definitions_from_glob": {
       "gid": "_snippets_definitions_from_glob",
       "title": "",