{
  "$id": "https://docs.sherpo.io/overview/blocks/schema.json",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Block",
  "description": "A block of a body, of any type the block reference lists.",
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The block's id, unique within its body."
        },
        "type": {
          "type": "string",
          "const": "actions",
          "description": "The block's type."
        },
        "actions": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string"
              },
              "href": {
                "type": "string"
              },
              "variant": {
                "type": "string",
                "enum": [
                  "primary",
                  "secondary",
                  "ghost"
                ]
              },
              "showArrow": {
                "type": "boolean"
              }
            },
            "required": [
              "label",
              "href"
            ],
            "additionalProperties": false
          },
          "description": "The buttons, each with its `label`, `href`, `variant` and whether it shows an arrow."
        },
        "alignment": {
          "type": "string",
          "enum": [
            "start",
            "center",
            "end"
          ],
          "description": "How its content aligns: `start`, `center` or `end`."
        },
        "secondaryDefaultVariant": {
          "type": "string",
          "enum": [
            "secondary",
            "ghost"
          ],
          "description": "The look of every button after the first that names no `variant`."
        },
        "hidden": {
          "type": "boolean",
          "description": "Whether the block is hidden: it, and every block it holds, doesn't show."
        }
      },
      "required": [
        "id",
        "type",
        "actions"
      ],
      "description": "A row of link buttons.",
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The block's id, unique within its body."
        },
        "type": {
          "type": "string",
          "const": "article-list",
          "description": "The block's type."
        },
        "hidden": {
          "type": "boolean",
          "description": "Whether the block is hidden: it, and every block it holds, doesn't show."
        }
      },
      "required": [
        "id",
        "type"
      ],
      "description": "A product's articles or episodes, newest first, made for a blog's or a podcast's page.",
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The block's id, unique within its body."
        },
        "type": {
          "type": "string",
          "const": "article-search",
          "description": "The block's type."
        },
        "hidden": {
          "type": "boolean",
          "description": "Whether the block is hidden: it, and every block it holds, doesn't show."
        }
      },
      "required": [
        "id",
        "type"
      ],
      "description": "A search and filters over a product's articles or episodes, made for a blog's or a podcast's page.",
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The block's id, unique within its body."
        },
        "type": {
          "type": "string",
          "const": "aside",
          "description": "The block's type."
        },
        "target": {
          "default": "aside",
          "type": "string",
          "enum": [
            "main",
            "aside"
          ],
          "description": "Which column: `main` or `aside` (the side one)."
        },
        "priority": {
          "type": "string",
          "enum": [
            "low",
            "high"
          ],
          "description": "Which column comes first on a narrow screen: the `high` one."
        },
        "blocks": {
          "type": "array",
          "items": {
            "$ref": "#"
          },
          "description": "The blocks it holds."
        },
        "hidden": {
          "type": "boolean",
          "description": "Whether the block is hidden: it, and every block it holds, doesn't show."
        }
      },
      "required": [
        "id",
        "type",
        "blocks"
      ],
      "description": "A column of a product's page: the main one, or the side one.",
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The block's id, unique within its body."
        },
        "type": {
          "type": "string",
          "const": "audio",
          "description": "The block's type."
        },
        "src": {
          "default": "",
          "type": "string",
          "description": "An external URL, when no `fileId` names a store file."
        },
        "fileId": {
          "type": "string",
          "description": "A store file's id, listed in the read's `files`."
        },
        "title": {
          "type": "string",
          "description": "A title shown above its waveform."
        },
        "caption": {
          "type": "string",
          "description": "A caption under it."
        },
        "startTime": {
          "type": "number",
          "description": "Where it starts playing, in seconds."
        },
        "hidden": {
          "type": "boolean",
          "description": "Whether the block is hidden: it, and every block it holds, doesn't show."
        }
      },
      "required": [
        "id",
        "type"
      ],
      "description": "An audio file played with its waveform: a store file, or an external URL.",
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The block's id, unique within its body."
        },
        "type": {
          "type": "string",
          "const": "background-image",
          "description": "The block's type."
        },
        "src": {
          "default": "",
          "type": "string",
          "description": "An external URL, when no `fileId` names a store file."
        },
        "width": {
          "type": "number",
          "description": "Its width in pixels."
        },
        "height": {
          "type": "number",
          "description": "Its height in pixels."
        },
        "fileId": {
          "type": "string",
          "description": "A store file's id, listed in the read's `files`."
        },
        "hidden": {
          "type": "boolean",
          "description": "Whether the block is hidden: it, and every block it holds, doesn't show."
        }
      },
      "required": [
        "id",
        "type"
      ],
      "description": "An image the page's background takes while the blocks after it show.",
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The block's id, unique within its body."
        },
        "type": {
          "type": "string",
          "const": "card",
          "description": "The block's type."
        },
        "blocks": {
          "type": "array",
          "items": {
            "$ref": "#"
          },
          "description": "The blocks it holds."
        },
        "hidden": {
          "type": "boolean",
          "description": "Whether the block is hidden: it, and every block it holds, doesn't show."
        }
      },
      "required": [
        "id",
        "type"
      ],
      "description": "A card holding blocks.",
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The block's id, unique within its body."
        },
        "type": {
          "type": "string",
          "const": "carousel",
          "description": "The block's type."
        },
        "title": {
          "type": "string",
          "description": "Kept, but not shown."
        },
        "subtitle": {
          "type": "string",
          "description": "Kept, but not shown."
        },
        "description": {
          "type": "string",
          "description": "Kept, but not shown."
        },
        "items": {
          "type": "array",
          "items": {
            "$ref": "#"
          },
          "description": "The slides, one block each."
        },
        "autoplay": {
          "type": "boolean",
          "description": "Kept, but has no effect."
        },
        "alignment": {
          "type": "string",
          "enum": [
            "start",
            "center",
            "end"
          ],
          "description": "Kept, but not shown."
        },
        "hidden": {
          "type": "boolean",
          "description": "Whether the block is hidden: it, and every block it holds, doesn't show."
        }
      },
      "required": [
        "id",
        "type",
        "items"
      ],
      "description": "A row of slides, one block each, scrolled sideways.",
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The block's id, unique within its body."
        },
        "type": {
          "type": "string",
          "const": "contact",
          "description": "The block's type."
        },
        "channels": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string"
              },
              "value": {
                "type": "string"
              },
              "type": {
                "type": "string",
                "enum": [
                  "email",
                  "phone",
                  "address",
                  "link"
                ]
              }
            },
            "required": [
              "label",
              "value"
            ],
            "additionalProperties": false
          },
          "description": "Each channel: its `label`, its `value` and its `type` (`email`, `phone`, `address` or `link`)."
        },
        "hidden": {
          "type": "boolean",
          "description": "Whether the block is hidden: it, and every block it holds, doesn't show."
        }
      },
      "required": [
        "id",
        "type",
        "channels"
      ],
      "description": "Ways to reach the store.",
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The block's id, unique within its body."
        },
        "type": {
          "type": "string",
          "const": "diagram",
          "description": "The block's type."
        },
        "source": {
          "default": "",
          "type": "string",
          "description": "The diagram in Mermaid syntax: a flowchart (`flowchart LR`), `sequenceDiagram`, `stateDiagram-v2`, `classDiagram`, `erDiagram` or an XY chart (`xychart-beta`), with no styling directives."
        },
        "hidden": {
          "type": "boolean",
          "description": "Whether the block is hidden: it, and every block it holds, doesn't show."
        }
      },
      "required": [
        "id",
        "type"
      ],
      "description": "A diagram drawn from Mermaid source in the store's colors.",
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The block's id, unique within its body."
        },
        "type": {
          "type": "string",
          "const": "download",
          "description": "The block's type."
        },
        "fileId": {
          "default": "",
          "type": "string",
          "description": "A store file's id, listed in the read's `files`."
        },
        "label": {
          "type": "string",
          "description": "What the link reads; the file's name when unset."
        },
        "fragment": {
          "type": "string",
          "pattern": "^#[\\w=&.~%-]{1,200}$",
          "description": "Where the file opens, such as a PDF page: `#page=2`."
        },
        "inline": {
          "type": "boolean",
          "description": "Whether it shows as a link inside the sentence that holds it, rather than a card."
        },
        "rules": {
          "minItems": 1,
          "maxItems": 8,
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "productId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 64
              },
              "tierId": {
                "type": "string",
                "minLength": 1,
                "maxLength": 64
              }
            },
            "required": [
              "productId"
            ],
            "additionalProperties": false
          },
          "description": "Who may download a private file: a buyer of any rule's product (`productId`), at its tier (`tierId`) or above when it names one."
        },
        "hidden": {
          "type": "boolean",
          "description": "Whether the block is hidden: it, and every block it holds, doesn't show."
        }
      },
      "required": [
        "id",
        "type"
      ],
      "description": "A store file to download: a card, or with `inline` a link inside a sentence.",
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The block's id, unique within its body."
        },
        "type": {
          "type": "string",
          "const": "event-date",
          "description": "The block's type."
        },
        "hidden": {
          "type": "boolean",
          "description": "Whether the block is hidden: it, and every block it holds, doesn't show."
        }
      },
      "required": [
        "id",
        "type"
      ],
      "description": "An event's dates and times, each in its own time zone and the visitor's, with a link to add it to a calendar. On an event's page only.",
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The block's id, unique within its body."
        },
        "type": {
          "type": "string",
          "const": "event-details",
          "description": "The block's type."
        },
        "product": {
          "type": "string",
          "description": "The event product's id."
        },
        "hidden": {
          "type": "boolean",
          "description": "Whether the block is hidden: it, and every block it holds, doesn't show."
        }
      },
      "required": [
        "id",
        "type",
        "product"
      ],
      "description": "One of the store's events, as a card with its next date, its place and a link to its page.",
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The block's id, unique within its body."
        },
        "type": {
          "type": "string",
          "const": "event-list",
          "description": "The block's type."
        },
        "title": {
          "type": "string",
          "description": "The heading over the cards; \"Upcoming events\" when unset."
        },
        "past": {
          "type": "boolean",
          "description": "Whether past events show under the upcoming ones, the latest first; false when unset."
        },
        "hidden": {
          "type": "boolean",
          "description": "Whether the block is hidden: it, and every block it holds, doesn't show."
        }
      },
      "required": [
        "id",
        "type"
      ],
      "description": "The store's upcoming events as cards, the next first, and past ones under them when asked.",
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The block's id, unique within its body."
        },
        "type": {
          "type": "string",
          "const": "event-location",
          "description": "The block's type."
        },
        "hidden": {
          "type": "boolean",
          "description": "Whether the block is hidden: it, and every block it holds, doesn't show."
        }
      },
      "required": [
        "id",
        "type"
      ],
      "description": "An event's place: its venue and address, or how it is joined online. On an event's page only.",
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The block's id, unique within its body."
        },
        "type": {
          "type": "string",
          "const": "expandable",
          "description": "The block's type."
        },
        "title": {
          "type": "string",
          "description": "Kept, but not shown."
        },
        "defaultExpanded": {
          "default": false,
          "type": "boolean",
          "description": "Whether it starts showing all of its blocks."
        },
        "blocks": {
          "type": "array",
          "items": {
            "$ref": "#"
          },
          "description": "The blocks it holds."
        },
        "hidden": {
          "type": "boolean",
          "description": "Whether the block is hidden: it, and every block it holds, doesn't show."
        }
      },
      "required": [
        "id",
        "type",
        "blocks"
      ],
      "description": "Blocks shown up to a set height, with a button to show the rest.",
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The block's id, unique within its body."
        },
        "type": {
          "type": "string",
          "const": "faq",
          "description": "The block's type."
        },
        "items": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "question": {
                "type": "string"
              },
              "answer": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "array",
                    "items": {
                      "$ref": "#"
                    }
                  }
                ]
              },
              "category": {
                "type": "string"
              }
            },
            "required": [
              "question"
            ],
            "additionalProperties": false
          },
          "description": "Each question, its answer (blocks; a plain text becomes a `markdown` block, blank lines separating its paragraphs) and an optional `category` to group it under."
        },
        "hidden": {
          "type": "boolean",
          "description": "Whether the block is hidden: it, and every block it holds, doesn't show."
        }
      },
      "required": [
        "id",
        "type",
        "items"
      ],
      "description": "Questions and their answers.",
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The block's id, unique within its body."
        },
        "type": {
          "type": "string",
          "const": "formula",
          "description": "The block's type."
        },
        "tex": {
          "default": "",
          "type": "string",
          "description": "The formula in TeX, as KaTeX reads it, such as `\\frac{a}{b}`."
        },
        "hidden": {
          "type": "boolean",
          "description": "Whether the block is hidden: it, and every block it holds, doesn't show."
        }
      },
      "required": [
        "id",
        "type"
      ],
      "description": "A display formula, rendered as math.",
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The block's id, unique within its body."
        },
        "type": {
          "type": "string",
          "const": "grid",
          "description": "The block's type."
        },
        "columns": {
          "type": "object",
          "properties": {
            "desktop": {
              "type": "integer",
              "minimum": 1,
              "maximum": 12
            },
            "tablet": {
              "type": "integer",
              "minimum": 1,
              "maximum": 12
            },
            "mobile": {
              "type": "integer",
              "minimum": 1,
              "maximum": 12
            }
          },
          "description": "How many columns it shows (1 to 12) on `desktop`, `tablet` and `mobile`.",
          "additionalProperties": false
        },
        "blocks": {
          "type": "array",
          "items": {
            "$ref": "#"
          },
          "description": "The blocks it holds."
        },
        "hidden": {
          "type": "boolean",
          "description": "Whether the block is hidden: it, and every block it holds, doesn't show."
        }
      },
      "required": [
        "id",
        "type",
        "blocks"
      ],
      "description": "Blocks laid out in columns.",
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The block's id, unique within its body."
        },
        "type": {
          "type": "string",
          "const": "grid-products",
          "description": "The block's type."
        },
        "hidden": {
          "type": "boolean",
          "description": "Whether the block is hidden: it, and every block it holds, doesn't show."
        }
      },
      "required": [
        "id",
        "type"
      ],
      "description": "The store's products, as cards in a grid.",
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The block's id, unique within its body."
        },
        "type": {
          "type": "string",
          "const": "hero",
          "description": "The block's type."
        },
        "eyebrow": {
          "type": "string",
          "description": "A short line over the title."
        },
        "title": {
          "type": "string",
          "description": "The title; a product page's hero shows the product's own when it is empty."
        },
        "subtitle": {
          "type": "string",
          "description": "A line under the title."
        },
        "description": {
          "type": "string",
          "description": "A paragraph under the title."
        },
        "alignment": {
          "type": "string",
          "enum": [
            "start",
            "center",
            "end"
          ],
          "description": "How its content aligns: `start`, `center` or `end`."
        },
        "primaryAction": {
          "type": "object",
          "properties": {
            "label": {
              "type": "string"
            },
            "href": {
              "type": "string"
            },
            "variant": {
              "type": "string",
              "enum": [
                "primary",
                "secondary",
                "ghost"
              ]
            },
            "showArrow": {
              "type": "boolean"
            }
          },
          "required": [
            "label",
            "href"
          ],
          "description": "A link button: its `label`, `href` and `variant`, and whether it shows an arrow.",
          "additionalProperties": false
        },
        "secondaryAction": {
          "type": "object",
          "properties": {
            "label": {
              "type": "string"
            },
            "href": {
              "type": "string"
            },
            "variant": {
              "type": "string",
              "enum": [
                "primary",
                "secondary",
                "ghost"
              ]
            },
            "showArrow": {
              "type": "boolean"
            }
          },
          "required": [
            "label",
            "href"
          ],
          "description": "A link button: its `label`, `href` and `variant`, and whether it shows an arrow.",
          "additionalProperties": false
        },
        "highlights": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Short points listed under the description."
        },
        "additionalContent": {
          "anyOf": [
            {
              "$ref": "#"
            },
            {
              "type": "array",
              "items": {
                "$ref": "#"
              }
            }
          ],
          "description": "Blocks shown with the heading: beside it on wide screens unless it is centered, under it otherwise."
        },
        "lineProducts": {
          "default": {
            "id": "default-line",
            "hidden": false,
            "type": "line-products"
          },
          "type": "object",
          "properties": {
            "id": {
              "type": "string"
            },
            "type": {
              "type": "string",
              "const": "line-products"
            },
            "hidden": {
              "type": "boolean"
            }
          },
          "required": [
            "id",
            "type"
          ],
          "description": "A `line-products` block it shows under its content, the store's support products.",
          "additionalProperties": false
        },
        "hidden": {
          "type": "boolean",
          "description": "Whether the block is hidden: it, and every block it holds, doesn't show."
        }
      },
      "required": [
        "id",
        "type"
      ],
      "description": "The heading section that opens a page.",
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The block's id, unique within its body."
        },
        "type": {
          "type": "string",
          "const": "hr",
          "description": "The block's type."
        },
        "style": {
          "type": "string",
          "enum": [
            "solid",
            "dashed",
            "dotted"
          ],
          "description": "Its line: `solid`, `dashed` or `dotted`."
        },
        "hidden": {
          "type": "boolean",
          "description": "Whether the block is hidden: it, and every block it holds, doesn't show."
        }
      },
      "required": [
        "id",
        "type"
      ],
      "description": "A horizontal rule.",
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The block's id, unique within its body."
        },
        "type": {
          "type": "string",
          "const": "image",
          "description": "The block's type."
        },
        "src": {
          "default": "",
          "type": "string",
          "description": "An external URL, when no `fileId` names a store file."
        },
        "alt": {
          "default": "",
          "type": "string",
          "description": "The image described, for those who can't see it."
        },
        "width": {
          "type": "number",
          "description": "Its width in pixels."
        },
        "height": {
          "type": "number",
          "description": "Its height in pixels."
        },
        "fileId": {
          "type": "string",
          "description": "A store file's id, listed in the read's `files`."
        },
        "caption": {
          "type": "string",
          "description": "A caption under it."
        },
        "borderless": {
          "type": "boolean",
          "description": "Whether it shows without its frame."
        },
        "size": {
          "type": "string",
          "enum": [
            "small",
            "medium",
            "full"
          ],
          "description": "How wide it shows: `small`, `medium` or `full`."
        },
        "fit": {
          "type": "string",
          "enum": [
            "contain",
            "cover"
          ],
          "description": "Whether the media is cropped to its frame (`cover`) or fits inside it (`contain`)."
        },
        "align": {
          "type": "string",
          "enum": [
            "start",
            "center",
            "end"
          ],
          "description": "How its content aligns: `start`, `center` or `end`."
        },
        "hidden": {
          "type": "boolean",
          "description": "Whether the block is hidden: it, and every block it holds, doesn't show."
        }
      },
      "required": [
        "id",
        "type"
      ],
      "description": "An image: a store file, or an external URL.",
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The block's id, unique within its body."
        },
        "type": {
          "type": "string",
          "const": "line-products",
          "description": "The block's type."
        },
        "hidden": {
          "type": "boolean",
          "description": "Whether the block is hidden: it, and every block it holds, doesn't show."
        }
      },
      "required": [
        "id",
        "type"
      ],
      "description": "The store's support products (tips, donations, calls), in a row.",
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The block's id, unique within its body."
        },
        "type": {
          "type": "string",
          "const": "logo-cloud",
          "description": "The block's type."
        },
        "logos": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string"
              },
              "src": {
                "default": "",
                "type": "string"
              },
              "fileId": {
                "type": "string"
              },
              "href": {
                "type": "string"
              },
              "scale": {
                "type": "number",
                "minimum": 0.15,
                "maximum": 1
              }
            },
            "required": [
              "name"
            ],
            "additionalProperties": false
          },
          "description": "Each logo: its `name`, a store file (`fileId`) or external URL (`src`), an optional link (`href`) and `scale` (0.15 to 1)."
        },
        "monochrome": {
          "type": "boolean",
          "description": "Whether the logos show in one color."
        },
        "hidden": {
          "type": "boolean",
          "description": "Whether the block is hidden: it, and every block it holds, doesn't show."
        }
      },
      "required": [
        "id",
        "type",
        "logos"
      ],
      "description": "A row of logos.",
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The block's id, unique within its body."
        },
        "type": {
          "type": "string",
          "const": "map",
          "description": "The block's type."
        },
        "latitude": {
          "type": "number",
          "minimum": -85.0511,
          "maximum": 85.0511,
          "description": "The point's latitude in decimal degrees, from -85.0511 to 85.0511, kept to 6 decimals."
        },
        "longitude": {
          "type": "number",
          "minimum": -180,
          "maximum": 180,
          "description": "The point's longitude in decimal degrees, from -180 to 180, kept to 6 decimals."
        },
        "venue": {
          "type": "string",
          "maxLength": 200,
          "description": "The place's name, shown over the map."
        },
        "address": {
          "type": "string",
          "maxLength": 500,
          "description": "The place's address, its lines joined by line breaks."
        },
        "mapUrl": {
          "type": "string",
          "maxLength": 2000,
          "description": "A map link for the place (https, with no credentials), where `openInMaps` leads."
        },
        "openInMaps": {
          "default": false,
          "type": "boolean",
          "description": "Whether it shows an \"Open in maps\" link: to `mapUrl`, else OpenStreetMap at the point."
        },
        "size": {
          "type": "string",
          "enum": [
            "small",
            "medium",
            "full"
          ],
          "description": "How wide it shows: `small`, `medium` or `full`."
        },
        "align": {
          "type": "string",
          "enum": [
            "start",
            "center",
            "end"
          ],
          "description": "How its content aligns: `start`, `center` or `end`."
        },
        "hidden": {
          "type": "boolean",
          "description": "Whether the block is hidden: it, and every block it holds, doesn't show."
        }
      },
      "required": [
        "id",
        "type",
        "latitude",
        "longitude"
      ],
      "description": "A place on a map: the store's own map of the point, its name and address over it, and the map's credit.",
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The block's id, unique within its body."
        },
        "type": {
          "type": "string",
          "const": "markdown",
          "description": "The block's type."
        },
        "title": {
          "type": "string",
          "description": "Kept, but not shown."
        },
        "subtitle": {
          "type": "string",
          "description": "Kept, but not shown."
        },
        "content": {
          "type": "string",
          "description": "A rich text."
        },
        "allowMultipleColumns": {
          "type": "boolean",
          "description": "Whether a long text may flow in columns on wide screens."
        },
        "hidden": {
          "type": "boolean",
          "description": "Whether the block is hidden: it, and every block it holds, doesn't show."
        }
      },
      "required": [
        "id",
        "type",
        "content"
      ],
      "description": "A rich text.",
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The block's id, unique within its body."
        },
        "type": {
          "type": "string",
          "const": "portfolio-activity",
          "description": "The block's type."
        },
        "hidden": {
          "type": "boolean",
          "description": "Whether the block is hidden: it, and every block it holds, doesn't show."
        }
      },
      "required": [
        "id",
        "type"
      ],
      "description": "A portfolio's trades and events. On a portfolio's page only.",
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The block's id, unique within its body."
        },
        "type": {
          "type": "string",
          "const": "portfolio-chart",
          "description": "The block's type."
        },
        "hidden": {
          "type": "boolean",
          "description": "Whether the block is hidden: it, and every block it holds, doesn't show."
        }
      },
      "required": [
        "id",
        "type"
      ],
      "description": "A portfolio's performance chart. On a portfolio's page only.",
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The block's id, unique within its body."
        },
        "type": {
          "type": "string",
          "const": "portfolio-holdings",
          "description": "The block's type."
        },
        "hidden": {
          "type": "boolean",
          "description": "Whether the block is hidden: it, and every block it holds, doesn't show."
        }
      },
      "required": [
        "id",
        "type"
      ],
      "description": "A portfolio's holdings. On a portfolio's page only.",
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The block's id, unique within its body."
        },
        "type": {
          "type": "string",
          "const": "portfolio-stats",
          "description": "The block's type."
        },
        "hidden": {
          "type": "boolean",
          "description": "Whether the block is hidden: it, and every block it holds, doesn't show."
        }
      },
      "required": [
        "id",
        "type"
      ],
      "description": "A portfolio's headline figures. On a portfolio's page only.",
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The block's id, unique within its body."
        },
        "type": {
          "type": "string",
          "const": "portfolio-watchlist",
          "description": "The block's type."
        },
        "hidden": {
          "type": "boolean",
          "description": "Whether the block is hidden: it, and every block it holds, doesn't show."
        }
      },
      "required": [
        "id",
        "type"
      ],
      "description": "A portfolio's watchlist. On a portfolio's page only.",
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The block's id, unique within its body."
        },
        "type": {
          "type": "string",
          "const": "portfolio-weights",
          "description": "The block's type."
        },
        "hidden": {
          "type": "boolean",
          "description": "Whether the block is hidden: it, and every block it holds, doesn't show."
        }
      },
      "required": [
        "id",
        "type"
      ],
      "description": "A portfolio's holdings by weight. On a portfolio's page only.",
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The block's id, unique within its body."
        },
        "type": {
          "type": "string",
          "const": "pricing",
          "description": "The block's type."
        },
        "plans": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string"
              },
              "price": {
                "type": "string"
              },
              "discountedPrice": {
                "type": "string"
              },
              "description": {
                "type": "string"
              },
              "highlight": {
                "type": "boolean"
              },
              "features": {
                "type": "array",
                "items": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string"
                        },
                        "description": {
                          "type": "string"
                        },
                        "state": {
                          "type": "string",
                          "enum": [
                            "available",
                            "beta",
                            "unavailable",
                            "unsupported"
                          ]
                        }
                      },
                      "required": [
                        "name"
                      ],
                      "additionalProperties": false
                    }
                  ]
                }
              },
              "primaryAction": {
                "type": "object",
                "properties": {
                  "label": {
                    "type": "string"
                  },
                  "href": {
                    "type": "string"
                  },
                  "variant": {
                    "type": "string",
                    "enum": [
                      "primary",
                      "secondary",
                      "ghost"
                    ]
                  },
                  "showArrow": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "label",
                  "href"
                ],
                "additionalProperties": false
              },
              "secondaryAction": {
                "type": "object",
                "properties": {
                  "label": {
                    "type": "string"
                  },
                  "href": {
                    "type": "string"
                  },
                  "variant": {
                    "type": "string",
                    "enum": [
                      "primary",
                      "secondary",
                      "ghost"
                    ]
                  },
                  "showArrow": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "label",
                  "href"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "name",
              "price",
              "features"
            ],
            "additionalProperties": false
          },
          "description": "Each plan: its `name`, `price` (as shown), optional `discountedPrice`, `description` and `highlight`, its `features` (a name, or a name with a `description` and a `state`) and up to two actions."
        },
        "footnote": {
          "type": "string",
          "description": "A note under the plans."
        },
        "hidden": {
          "type": "boolean",
          "description": "Whether the block is hidden: it, and every block it holds, doesn't show."
        }
      },
      "required": [
        "id",
        "type",
        "plans"
      ],
      "description": "Plans side by side, with their prices and features.",
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The block's id, unique within its body."
        },
        "type": {
          "type": "string",
          "const": "product-card",
          "description": "The block's type."
        },
        "productId": {
          "type": "string",
          "description": "The product's id."
        },
        "hidden": {
          "type": "boolean",
          "description": "Whether the block is hidden: it, and every block it holds, doesn't show."
        }
      },
      "required": [
        "id",
        "type",
        "productId"
      ],
      "description": "One of the store's products, as a card.",
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The block's id, unique within its body."
        },
        "type": {
          "type": "string",
          "const": "product-content",
          "description": "The block's type."
        },
        "hidden": {
          "type": "boolean",
          "description": "Whether the block is hidden: it, and every block it holds, doesn't show."
        }
      },
      "required": [
        "id",
        "type"
      ],
      "description": "A product page's list of the files it gives.",
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The block's id, unique within its body."
        },
        "type": {
          "type": "string",
          "const": "product-description",
          "description": "The block's type."
        },
        "hidden": {
          "type": "boolean",
          "description": "Whether the block is hidden: it, and every block it holds, doesn't show."
        }
      },
      "required": [
        "id",
        "type"
      ],
      "description": "A product's `description` text.",
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The block's id, unique within its body."
        },
        "type": {
          "type": "string",
          "const": "product-get",
          "description": "The block's type."
        },
        "hidden": {
          "type": "boolean",
          "description": "Whether the block is hidden: it, and every block it holds, doesn't show."
        }
      },
      "required": [
        "id",
        "type"
      ],
      "description": "A product page's buying section: its prices and the button to get it.",
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The block's id, unique within its body."
        },
        "type": {
          "type": "string",
          "const": "product-pages",
          "description": "The block's type."
        },
        "hidden": {
          "type": "boolean",
          "description": "Whether the block is hidden: it, and every block it holds, doesn't show."
        }
      },
      "required": [
        "id",
        "type"
      ],
      "description": "A product page's list of its lessons, episodes or articles.",
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The block's id, unique within its body."
        },
        "type": {
          "type": "string",
          "const": "product-review",
          "description": "The block's type."
        },
        "hidden": {
          "type": "boolean",
          "description": "Whether the block is hidden: it, and every block it holds, doesn't show."
        }
      },
      "required": [
        "id",
        "type"
      ],
      "description": "A product's reviews: their count and average rating.",
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The block's id, unique within its body."
        },
        "type": {
          "type": "string",
          "const": "product-summary",
          "description": "The block's type."
        },
        "hidden": {
          "type": "boolean",
          "description": "Whether the block is hidden: it, and every block it holds, doesn't show."
        }
      },
      "required": [
        "id",
        "type"
      ],
      "description": "What a product holds, counted: its lessons, videos, files and the like.",
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The block's id, unique within its body."
        },
        "type": {
          "type": "string",
          "const": "product-what-you-get",
          "description": "The block's type."
        },
        "hidden": {
          "type": "boolean",
          "description": "Whether the block is hidden: it, and every block it holds, doesn't show."
        }
      },
      "required": [
        "id",
        "type"
      ],
      "description": "What a product gives, its `what_you_get` text.",
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The block's id, unique within its body."
        },
        "type": {
          "type": "string",
          "const": "products",
          "description": "The block's type."
        },
        "hidden": {
          "type": "boolean",
          "description": "Whether the block is hidden: it, and every block it holds, doesn't show."
        }
      },
      "required": [
        "id",
        "type"
      ],
      "description": "The store's products, as cards in a grid. An older form of `grid-products`.",
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The block's id, unique within its body."
        },
        "type": {
          "type": "string",
          "const": "side-by-side",
          "description": "The block's type."
        },
        "title": {
          "type": "string",
          "description": "Kept, but not shown."
        },
        "subtitle": {
          "type": "string",
          "description": "Kept, but not shown."
        },
        "description": {
          "type": "string",
          "description": "Kept, but not shown."
        },
        "left": {
          "type": "array",
          "items": {
            "$ref": "#"
          },
          "description": "The blocks of the left column."
        },
        "right": {
          "type": "array",
          "items": {
            "$ref": "#"
          },
          "description": "The blocks of the right column."
        },
        "alignment": {
          "type": "string",
          "enum": [
            "start",
            "center",
            "end"
          ],
          "description": "Kept, but not shown."
        },
        "horizontalAlignment": {
          "type": "string",
          "enum": [
            "start",
            "center",
            "end"
          ],
          "description": "How the two columns align vertically: `start`, `center` (the default) or `end`."
        },
        "hidden": {
          "type": "boolean",
          "description": "Whether the block is hidden: it, and every block it holds, doesn't show."
        }
      },
      "required": [
        "id",
        "type"
      ],
      "description": "Two columns of blocks side by side.",
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The block's id, unique within its body."
        },
        "type": {
          "type": "string",
          "const": "slideshow",
          "description": "The block's type."
        },
        "fileId": {
          "type": "string",
          "description": "A store PDF's id, listed in the read's `files`."
        },
        "title": {
          "type": "string",
          "description": "A title shown above it."
        },
        "caption": {
          "type": "string",
          "description": "A caption under it."
        },
        "hidden": {
          "type": "boolean",
          "description": "Whether the block is hidden: it, and every block it holds, doesn't show."
        }
      },
      "required": [
        "id",
        "type"
      ],
      "description": "A PDF from the store's files shown a page at a time, as a lesson's slides are, with no download.",
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The block's id, unique within its body."
        },
        "type": {
          "type": "string",
          "const": "spacer",
          "description": "The block's type."
        },
        "size": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "xs",
                "sm",
                "md",
                "lg",
                "xl"
              ]
            },
            {
              "type": "number",
              "minimum": -1000,
              "maximum": 1000
            }
          ],
          "description": "Its height: `xs` to `xl`, or pixels (a negative number pulls the next block up)."
        },
        "hidden": {
          "type": "boolean",
          "description": "Whether the block is hidden: it, and every block it holds, doesn't show."
        }
      },
      "required": [
        "id",
        "type"
      ],
      "description": "Empty space between blocks.",
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The block's id, unique within its body."
        },
        "type": {
          "type": "string",
          "const": "stats",
          "description": "The block's type."
        },
        "items": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "label": {
                "type": "string"
              },
              "value": {
                "type": "string"
              },
              "description": {
                "type": "string"
              }
            },
            "required": [
              "label",
              "value"
            ],
            "additionalProperties": false
          },
          "description": "Each figure: its `value`, its `label` and an optional `description`."
        },
        "footnote": {
          "type": "string",
          "description": "A note under the figures."
        },
        "hidden": {
          "type": "boolean",
          "description": "Whether the block is hidden: it, and every block it holds, doesn't show."
        }
      },
      "required": [
        "id",
        "type",
        "items"
      ],
      "description": "Figures with their labels.",
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The block's id, unique within its body."
        },
        "type": {
          "type": "string",
          "const": "theme-aware",
          "description": "The block's type."
        },
        "light": {
          "type": "array",
          "items": {
            "$ref": "#"
          },
          "description": "The blocks shown in light mode."
        },
        "dark": {
          "type": "array",
          "items": {
            "$ref": "#"
          },
          "description": "The blocks shown in dark mode."
        },
        "hidden": {
          "type": "boolean",
          "description": "Whether the block is hidden: it, and every block it holds, doesn't show."
        }
      },
      "required": [
        "id",
        "type",
        "light",
        "dark"
      ],
      "description": "Blocks shown in light mode, and others in dark mode.",
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The block's id, unique within its body."
        },
        "type": {
          "type": "string",
          "const": "timeline",
          "description": "The block's type."
        },
        "items": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string"
              },
              "description": {
                "type": "string"
              },
              "date": {
                "type": "string"
              },
              "state": {
                "type": "string",
                "enum": [
                  "success",
                  "error",
                  "warning",
                  "unknown"
                ]
              },
              "color": {
                "anyOf": [
                  {
                    "type": "string",
                    "enum": [
                      "emerald",
                      "amber",
                      "rose",
                      "sky",
                      "fuchsia"
                    ]
                  },
                  {
                    "type": "string",
                    "pattern": "^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$"
                  }
                ]
              },
              "shape": {
                "type": "string",
                "enum": [
                  "circle",
                  "square",
                  "heart",
                  "star",
                  "xmark",
                  "check"
                ]
              }
            },
            "required": [
              "title"
            ],
            "not": {
              "required": [
                "state"
              ],
              "anyOf": [
                {
                  "required": [
                    "color"
                  ]
                },
                {
                  "required": [
                    "shape"
                  ]
                }
              ]
            },
            "additionalProperties": false
          },
          "description": "Each step: its `title`, optional `description` and `date`, and either a `state` or its own `color` and `shape`, never both."
        },
        "hidden": {
          "type": "boolean",
          "description": "Whether the block is hidden: it, and every block it holds, doesn't show."
        }
      },
      "required": [
        "id",
        "type",
        "items"
      ],
      "description": "Dated steps in order.",
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The block's id, unique within its body."
        },
        "type": {
          "type": "string",
          "const": "titled-section",
          "description": "The block's type."
        },
        "title": {
          "type": "string",
          "description": "The heading."
        },
        "subtitle": {
          "type": "string",
          "description": "A line under the heading."
        },
        "description": {
          "type": "string",
          "description": "A paragraph under the heading."
        },
        "eyebrow": {
          "type": "string",
          "description": "A short line over the heading."
        },
        "alignment": {
          "type": "string",
          "enum": [
            "start",
            "center",
            "end"
          ],
          "description": "How its content aligns: `start`, `center` or `end`."
        },
        "blocks": {
          "anyOf": [
            {
              "$ref": "#"
            },
            {
              "type": "array",
              "items": {
                "$ref": "#"
              }
            }
          ],
          "description": "The blocks it holds; a single block is read as a list of one."
        },
        "block": {
          "$ref": "#",
          "description": "One block it holds, read when `blocks` is unset or empty. An older form of `blocks`."
        },
        "hidden": {
          "type": "boolean",
          "description": "Whether the block is hidden: it, and every block it holds, doesn't show."
        }
      },
      "required": [
        "id",
        "type"
      ],
      "description": "A section of blocks under a heading.",
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The block's id, unique within its body."
        },
        "type": {
          "type": "string",
          "const": "video",
          "description": "The block's type."
        },
        "src": {
          "default": "",
          "type": "string",
          "description": "An external URL, when no `fileId` names a store file."
        },
        "width": {
          "type": "number",
          "description": "Its width in pixels."
        },
        "height": {
          "type": "number",
          "description": "Its height in pixels."
        },
        "duration": {
          "type": "number",
          "description": "Its length in seconds."
        },
        "startTime": {
          "type": "number",
          "description": "Where it starts playing, in seconds."
        },
        "fileId": {
          "type": "string",
          "description": "A store file's id, listed in the read's `files`."
        },
        "caption": {
          "type": "string",
          "description": "A caption under it."
        },
        "poster": {
          "type": "string",
          "description": "The poster's external URL, when no `posterFileId` names one."
        },
        "posterFileId": {
          "type": "string",
          "description": "The poster's store file id."
        },
        "size": {
          "type": "string",
          "enum": [
            "small",
            "medium",
            "full"
          ],
          "description": "How wide it shows: `small`, `medium` or `full`."
        },
        "fit": {
          "type": "string",
          "enum": [
            "contain",
            "cover"
          ],
          "description": "Whether the media is cropped to its frame (`cover`) or fits inside it (`contain`)."
        },
        "align": {
          "type": "string",
          "enum": [
            "start",
            "center",
            "end"
          ],
          "description": "How its content aligns: `start`, `center` or `end`."
        },
        "autoplay": {
          "type": "boolean",
          "description": "Whether it plays, muted, as soon as it shows."
        },
        "loop": {
          "type": "boolean",
          "description": "Whether it starts over when it ends."
        },
        "hidden": {
          "type": "boolean",
          "description": "Whether the block is hidden: it, and every block it holds, doesn't show."
        }
      },
      "required": [
        "id",
        "type"
      ],
      "description": "A video: a store file, or an external URL.",
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The block's id, unique within its body."
        },
        "type": {
          "type": "string",
          "const": "youtube",
          "description": "The block's type."
        },
        "url": {
          "type": "string",
          "description": "The video's YouTube URL."
        },
        "startTime": {
          "type": "number",
          "description": "Where it starts playing, in seconds."
        },
        "caption": {
          "type": "string",
          "description": "A caption under it."
        },
        "hidden": {
          "type": "boolean",
          "description": "Whether the block is hidden: it, and every block it holds, doesn't show."
        }
      },
      "required": [
        "id",
        "type",
        "url"
      ],
      "description": "A YouTube video.",
      "additionalProperties": false
    }
  ]
}