🤖 Sync Liquid Docs Schema (#317)

Co-authored-by: shopify-dev-bot[bot] <95105344+shopify-dev-bot[bot]@users.noreply.github.com>

data/objects.json

@@ -5260,6 +5260,30 @@
  ],
  "summary": "The current page URL with the URL parameter related to the filter removed.",
  "name": "url_to_remove"
+ },
+ {
+ "deprecated": false,
+ "deprecation_reason": "",
+ "description": "",
+ "examples": [
+
+ ],
+ "return_type": [
+ {
+ "type": "string",
+ "name": "swatch",
+ "description": "",
+ "array_value": ""
+ },
+ {
+ "type": "string",
+ "name": "text",
+ "description": "",
+ "array_value": ""
+ }
+ ],
+ "summary": "Describes how to present the filter values.\n\nReturns a value only for `list` type filters. Returns `nil` for other types.",
+ "name": "presentation"
  }
  ],
  "summary": "A [storefront filter](https://help.shopify.com/manual/online-store/themes/customizing-themes/storefront-filters).",
@@ -5276,6 +5300,80 @@
 
  ]
  },
+ {
+ "access": {
+ "global": false,
+ "parents": [
+ {
+ "object": "filter_value",
+ "property": "display"
+ }
+ ],
+ "template": [
+
+ ]
+ },
+ "deprecated": false,
+ "deprecation_reason": "",
+ "description": "",
+ "properties": [
+ {
+ "deprecated": false,
+ "deprecation_reason": "",
+ "description": "",
+ "examples": [
+
+ ],
+ "return_type": [
+ {
+ "type": "string",
+ "name": "colors",
+ "description": "",
+ "array_value": ""
+ },
+ {
+ "type": "string",
+ "name": "image",
+ "description": "",
+ "array_value": ""
+ }
+ ],
+ "summary": "The type of visual representation.",
+ "name": "type"
+ },
+ {
+ "deprecated": false,
+ "deprecation_reason": "",
+ "description": "Can be a list of [`colors`](/docs/api/liquid/objects/color) or an [`image`](/docs/api/liquid/objects/image).\nRefer to the [`type`](#filter_value_display-type) property to determine the type of visual representation.",
+ "examples": [
+
+ ],
+ "return_type": [
+ {
+ "type": "untyped",
+ "name": "",
+ "description": "",
+ "array_value": ""
+ }
+ ],
+ "summary": "The visual representation.",
+ "name": "value"
+ }
+ ],
+ "summary": "The visual representation of a filter value.",
+ "name": "filter_value_display",
+ "examples": [
+
+ ],
+ "json_data": {
+ "path": "",
+ "handle": "",
+ "data_from_file": ""
+ },
+ "return_type": [
+
+ ]
+ },
  {
  "access": {
  "global": false,
@@ -5330,7 +5428,7 @@
  {
  "deprecated": false,
  "deprecation_reason": "",
- "description": "",
+ "description": "For example, `High` will be used in the URL as `filter.v.option.strength=High`.",
  "examples": [
 
  ],
@@ -5342,7 +5440,7 @@
  "array_value": ""
  }
  ],
- "summary": "The value.",
+ "summary": "The value for the URL parameter. The `value` is paired with the [`param_name`](#filter_value-param_name) property.",
  "name": "value"
  },
  {
@@ -5402,7 +5500,7 @@
  {
  "deprecated": false,
  "deprecation_reason": "",
- "description": "",
+ "description": "> Note:\n> Any [pagination](/docs/api/liquid/tags/paginate) URL parameters are removed.",
  "examples": [
 
  ],
@@ -5420,7 +5518,7 @@
  {
  "deprecated": false,
  "deprecation_reason": "",
- "description": "",
+ "description": "> Note:\n> Any [pagination](/docs/api/liquid/tags/paginate) URL parameters are also removed.",
  "examples": [
 
  ],
@@ -5434,6 +5532,24 @@
  ],
  "summary": "The current page URL with the filter value parameter removed.",
  "name": "url_to_remove"
+ },
+ {
+ "deprecated": false,
+ "deprecation_reason": "",
+ "description": "Returns a visual representation for the filter value.\nIf no visual representation is available, then `nil` is returned.",
+ "examples": [
+
+ ],
+ "return_type": [
+ {
+ "type": "filter_value_display",
+ "name": "",
+ "description": "",
+ "array_value": ""
+ }
+ ],
+ "summary": "The visual representation of the filter value.",
+ "name": "display"
  }
  ],
  "summary": "A specific value of a filter.",
@@ -9348,7 +9464,7 @@
  {
  "deprecated": false,
  "deprecation_reason": "",
- "description": "The following table outlines the value format for each metafield type:\n\n<table>\n <thead>\n <tr>\n <th>Type</th>\n <th>Returned format</th>\n </tr>\n </thead>\n <tbody>\n <tr>\n <td>\n <code>single_line_text_field</code><br><br>\n <code>multi_line_text_field</code>\n </td>\n <td><a href=\"/docs/api/liquid/basics#string\">A string</a></td>\n </tr>\n <tr>\n <td>\n <code>rich_text_field</code>\n </td>\n <td>A field that supports headings, lists, links, bold, and italics</td>\n </tr>\n <tr>\n <td>\n <code>product_reference</code>\n </td>\n <td><a href=\"/docs/api/liquid/objects/product\">A product object</a></td>\n </tr>\n <tr>\n <td>\n <code>collection_reference</code>\n </td>\n <td><a href=\"/docs/api/liquid/objects/collection\">A collection object</a></td>\n </tr>\n <tr>\n <td>\n <code>variant_reference</code>\n </td>\n <td><a href=\"/docs/api/liquid/objects/variant\">A variant object</a></td>\n </tr>\n <tr>\n <td>\n <code>page_reference</code>\n </td>\n <td><a href=\"/docs/api/liquid/objects/page\">A page object</a></td>\n </tr>\n <tr>\n <td>\n <code>file_reference</code>\n </td>\n <td>\n <a href=\"/docs/api/liquid/objects/generic-file\">A generic_file object</a><br><br>\n <a href=\"/docs/api/liquid/objects/media\">A media object (images and videos only)</a>\n </td>\n </tr>\n <tr>\n <td>\n <code>number_integer</code><br><br>\n <code>number_decimal</code>\n </td>\n <td><a href=\"/docs/api/liquid/basics#number\">A number</a></td>\n </tr>\n <tr>\n <td>\n <code>date</code><br><br>\n <code>date_time</code>\n </td>\n <td>A date string. To format the string, use the <a href=\"/docs/api/liquid/filters/date\">date</a> filter.</td>\n </tr>\n <tr>\n <td>\n <code>url_reference</code>\n </td>\n <td><a href=\"/docs/api/liquid/basics#string\">A url string</a></td>\n </tr>\n <tr>\n <td>\n <code>json</code>\n </td>\n <td><a href=\"https://developer.mozilla.org/en-US/docs/Learn/JavaScript/Objects/JSON\">A JSON object</a></td>\n </tr>\n <tr>\n <td>\n <code>boolean</code>\n </td>\n <td><a href=\"/docs/api/liquid/basics#boolean\">A boolean</a></td>\n <tr>\n <td>\n <code>color</code>\n </td>\n <td><a href=\"/docs/api/liquid/objects/color\">A color object</a></td>\n </tr>\n <tr>\n <td>\n <code>weight</code><br><br>\n <code>volume</code><br><br>\n <code>dimension</code>\n </td>\n <td><a href=\"/docs/api/liquid/objects/measurement\">A measurement object</a></td>\n </tr>\n <tr>\n <td>\n <code>rating</code>\n </td>\n <td><a href=\"/docs/api/liquid/objects/rating\">A rating object</a></td>\n </tr>\n <tr>\n <td>\n <code>list</code>\n </td>\n <td><a href=\"/docs/api/liquid/basics#array\">An array of objects, numbers, or strings, depending on the list type</a></td>\n </tr>\n <tr>\n <td>\n <code>money</code>\n </td>\n <td><a href=\"/docs/api/liquid/objects/money\">A money object, displayed in the customer's local (presentment) currency.</a></td>\n </tr>\n </tbody>\n</table>",
+ "description": "The following table outlines the value format for each metafield type:\n\n<table>\n <thead>\n <tr>\n <th>Type</th>\n <th>Returned format</th>\n </tr>\n </thead>\n <tbody>\n <tr>\n <td>\n <code>single_line_text_field</code><br><br>\n <code>multi_line_text_field</code>\n </td>\n <td><a href=\"/docs/api/liquid/basics#string\">A string</a></td>\n </tr>\n <tr>\n <td>\n <code>rich_text_field</code>\n </td>\n <td>A field that supports headings, lists, links, bold, and italics</td>\n </tr>\n <tr>\n <td>\n <code>product_reference</code>\n </td>\n <td><a href=\"/docs/api/liquid/objects/product\">A product object</a></td>\n </tr>\n <tr>\n <td>\n <code>collection_reference</code>\n </td>\n <td><a href=\"/docs/api/liquid/objects/collection\">A collection object</a></td>\n </tr>\n <tr>\n <td>\n <code>variant_reference</code>\n </td>\n <td><a href=\"/docs/api/liquid/objects/variant\">A variant object</a></td>\n </tr>\n <tr>\n <td>\n <code>page_reference</code>\n </td>\n <td><a href=\"/docs/api/liquid/objects/page\">A page object</a></td>\n </tr>\n <tr>\n <td>\n <code>file_reference</code>\n </td>\n <td>\n <a href=\"/docs/api/liquid/objects/generic-file\">A generic_file object</a><br><br>\n <a href=\"/docs/api/liquid/objects/media\">A media object (images and videos only)</a>\n </td>\n </tr>\n <tr>\n <td>\n <code>number_integer</code><br><br>\n <code>number_decimal</code>\n </td>\n <td><a href=\"/docs/api/liquid/basics#number\">A number</a></td>\n </tr>\n <tr>\n <td>\n <code>date</code><br><br>\n <code>date_time</code>\n </td>\n <td>A date string. To format the string, use the <a href=\"/docs/api/liquid/filters/date\">date</a> filter.</td>\n </tr>\n <tr>\n <td>\n <code>url_reference</code>\n </td>\n <td><a href=\"/docs/api/liquid/basics#string\">A url string</a></td>\n </tr>\n <tr>\n <td>\n <code>json</code>\n </td>\n <td><a href=\"https://developer.mozilla.org/en-US/docs/Learn/JavaScript/Objects/JSON\">A JSON object</a></td>\n </tr>\n <tr>\n <td>\n <code>boolean</code>\n </td>\n <td><a href=\"/docs/api/liquid/basics#boolean\">A boolean</a></td>\n <tr>\n <td>\n <code>color</code>\n </td>\n <td><a href=\"/docs/api/liquid/objects/color\">A color object</a></td>\n </tr>\n <tr>\n <td>\n <code>weight</code><br><br>\n <code>volume</code><br><br>\n <code>dimension</code>\n </td>\n <td><a href=\"/docs/api/liquid/objects/measurement\">A measurement object</a></td>\n </tr>\n <tr>\n <td>\n <code>rating</code>\n </td>\n <td><a href=\"/docs/api/liquid/objects/rating\">A rating object</a></td>\n </tr>\n <tr>\n <td>\n <code>money</code>\n </td>\n <td><a href=\"/docs/api/liquid/objects/money\">A money object, displayed in the customer's local (presentment) currency.</a></td>\n </tr>\n </tbody>\n</table>",
  "examples": [
 
  ],
@@ -9491,12 +9607,6 @@
  "description": "",
  "array_value": ""
  },
- {
- "type": "string",
- "name": "list",
- "description": "",
- "array_value": ""
- },
  {
  "type": "string",
  "name": "money",

data/tags.json

@@ -823,7 +823,7 @@
  },
  {
  "name": "with",
- "description": "You can pass a single object to a snippet using the `with` parameter. You can also supply an optional `as` parameter to specify a custom name to reference the object inside the snippet.\n",
+ "description": "You can pass a single object to a snippet using the `with` parameter. You can also supply an optional `as` parameter to specify a custom name to reference the object inside the snippet. If you don't use the `as` parameter to specify a custom name, then you can reference the object using the snippet filename.\n",
  "syntax": "{% render 'filename' with object as name %}",
  "path": "/",
  "raw_liquid": "",