@cloudcannon/configuration-types 0.0.50 → 0.0.51

package/dist/documentation.json

@@ -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": "",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@cloudcannon/configuration-types",
-	"version": "0.0.50",
+	"version": "0.0.51",
 	"type": "module",
 	"description": "Contains TypeScript declarations and generates JSONSchema files for the CloudCannon configuration file.",
 	"author": "CloudCannon <support@cloudcannon.com>",

package/src/configuration.ts

@@ -4,7 +4,11 @@ import { CollectionGroupSchema, CollectionsConfigSchema } from './collections.ts
 import { InputsSchema } from './inputs.ts';
 import { MarkdownSettingsSchema } from './markdown.ts';
 import { PathsSchema } from './paths.ts';
-import { SnippetConfigSchema, SnippetsImportsSchema } from './snippets.ts';
+import {
+	SnippetConfigSchema,
+	SnippetDefinitionsSchema,
+	SnippetsImportsSchema,
+} from './snippets.ts';
 import { SourceEditorSchema } from './source-editor.ts';
 import { TimezoneSchema } from './timezone.ts';
 
@@ -111,11 +115,7 @@ export const ConfigurationSchema = z
 			description: 'Extended option used when creating more complex custom snippets.',
 		}),
 		_snippets_templates_from_glob: z.array(z.string()).optional(),
-		_snippets_definitions: z.record(z.string(), z.unknown()).optional().meta({
-			id: 'type._snippets_definitions',
-			title: 'Snippets Definitions',
-			description: 'Extended option used when creating more complex custom snippets.',
-		}),
+		_snippets_definitions: SnippetDefinitionsSchema,
 		_snippets_definitions_from_glob: z.array(z.string()).optional(),
 	})
 	.meta({

package/src/snippets.ts

@@ -298,5 +298,85 @@ export const SnippetsImportsSchema = z
 	})
 	.meta({ id: 'type._snippets_imports', title: 'Snippets Imports' });
 
+// Definition values that can be referenced via { ref: "key" } or { spread_ref: "key" }
+// These are reusable values that get substituted into snippet templates at runtime
+
+export const SnippetDefinitionSelectValueSchema = z
+	.object({
+		name: z.string().optional().meta({ description: 'The display name for this option.' }),
+		value: z
+			.union([
+				z.string().meta({ title: 'String' }),
+				z.number().meta({ title: 'Number' }),
+				z.boolean().meta({ title: 'Boolean' }),
+			])
+			.meta({
+				description: 'The value for this option.',
+			}),
+	})
+	.meta({
+		id: 'type.snippet-definition-select-value',
+		title: 'Snippet Definition Select Value',
+		description: 'A value option for select inputs, typically used in language lists.',
+	});
+
+export const SnippetDefinitionValueSchema = z
+	.union([
+		// Parser format - for format definitions like hugo_shortcode_format
+		ParserFormatSchema,
+		// Parser model - for single model definitions
+		ParserModelSchema,
+		// Array of parser models - for positional_args, named_args
+		z.array(ParserModelSchema).meta({
+			title: 'Parser Model Array',
+			description:
+				'An array of model configurations, typically used for positional_args or named_args.',
+		}),
+		// Array of select values - for language lists
+		z.array(SnippetDefinitionSelectValueSchema).meta({
+			title: 'Select Values Array',
+			description: 'An array of select options, typically used for language lists.',
+		}),
+		// Simple string value - for shortcode_name, tag_name, content_key, etc.
+		z.string().meta({
+			title: 'String Value',
+			description:
+				'A string value, commonly used for shortcode_name, tag_name, content_key, and similar definitions.',
+		}),
+		// Simple number value
+		z.number().meta({
+			title: 'Number Value',
+			description: 'A numeric value.',
+		}),
+		// Simple boolean value
+		z.boolean().meta({
+			title: 'Boolean Value',
+			description: 'A boolean value.',
+		}),
+		// Array of strings
+		z.array(z.string()).meta({
+			title: 'String Array',
+			description: 'An array of strings.',
+		}),
+	])
+	.meta({
+		id: '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" }.',
+	});
+
+export const SnippetDefinitionsSchema = z
+	.record(z.string(), SnippetDefinitionValueSchema)
+	.optional()
+	.meta({
+		id: 'type._snippets_definitions',
+		title: 'Snippets Definitions',
+		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.',
+	});
+
 export type SnippetConfig = z.infer<typeof SnippetConfigSchema>;
 export type SnippetsImports = z.infer<typeof SnippetsImportsSchema>;
+export type SnippetDefinitionValue = z.infer<typeof SnippetDefinitionValueSchema>;
+export type SnippetDefinitions = NonNullable<z.infer<typeof SnippetDefinitionsSchema>>;