{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/hydrafetch-com/json-schema/hydrafetch-com-styleguide-response-dto-schema.json",
  "title": "StyleguideResponseDto",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/hydrafetch-com-brand-api-openapi.yml#/components/schemas/StyleguideResponseDto",
  "type": "object",
  "properties": {
    "data": {
      "description": "Null when the domain could not be rendered. An unresolved domain is free.",
      "type": [
        "object",
        "null"
      ],
      "allOf": [
        {
          "$ref": "#/$defs/WebStyleguideDataDto"
        }
      ]
    }
  },
  "required": [
    "data"
  ],
  "$defs": {
    "StyleguideBandDto": {
      "type": "object",
      "properties": {
        "background": {
          "type": "string"
        },
        "color": {
          "type": "string"
        },
        "count": {
          "type": "number"
        }
      },
      "required": [
        "background"
      ]
    },
    "StyleguideButtonBorderDto": {
      "type": "object",
      "properties": {
        "width": {
          "type": "number"
        },
        "style": {
          "type": "string"
        },
        "color": {
          "type": [
            "object",
            "null"
          ]
        }
      },
      "required": [
        "width",
        "style",
        "color"
      ]
    },
    "StyleguideButtonDto": {
      "type": "object",
      "properties": {
        "background": {
          "type": "string",
          "description": "The fill. Absent on an outlined button, which has only a border."
        },
        "color": {
          "type": [
            "object",
            "null"
          ]
        },
        "radius": {
          "type": "string"
        },
        "paddingX": {
          "type": "number"
        },
        "paddingY": {
          "type": "number"
        },
        "fontWeight": {
          "type": [
            "object",
            "null"
          ]
        },
        "fontSize": {
          "type": "number"
        },
        "minWidth": {
          "type": "number",
          "description": "Width of the sampled button as it rendered, not a minimum the site sets. A button centring its label with flex has no padding to report, so this is the size to copy."
        },
        "minHeight": {
          "type": "number",
          "description": "Height of the sampled button as it rendered, not a minimum the site sets."
        },
        "border": {
          "$ref": "#/$defs/StyleguideButtonBorderDto"
        },
        "shadow": {
          "type": "string"
        },
        "css": {
          "type": "string",
          "description": "The same button as CSS declarations you can paste into a rule."
        }
      },
      "required": [
        "radius"
      ]
    },
    "StyleguideColorDto": {
      "type": "object",
      "properties": {
        "hex": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "role": {
          "type": "string",
          "enum": [
            "background",
            "surface",
            "text",
            "accent"
          ],
          "description": "Roles rather than a ranked list, so a colour drops straight into a theme instead of leaving you to guess which one is safe behind text."
        }
      },
      "required": [
        "hex",
        "role"
      ]
    },
    "StyleguideComponentsDto": {
      "type": "object",
      "properties": {
        "panel": {
          "description": "The treatment most large boxes on the page share: cards, panels, framed sections.",
          "allOf": [
            {
              "$ref": "#/$defs/StyleguidePanelDto"
            }
          ]
        },
        "header": {
          "description": "The top navigation bar.",
          "allOf": [
            {
              "$ref": "#/$defs/StyleguideHeaderDto"
            }
          ]
        },
        "headingOnPanel": {
          "type": "string",
          "enum": [
            "on-border",
            "inside",
            "above"
          ],
          "description": "Where a panel's title sits: across its top border like a fieldset legend, inside its padding, or just above it."
        },
        "tabs": {
          "description": "How the selected and other tabs are drawn.",
          "allOf": [
            {
              "$ref": "#/$defs/StyleguideTabsDto"
            }
          ]
        },
        "band": {
          "description": "A full-width section painted in a color far from the page, such as a dark hero band.",
          "allOf": [
            {
              "$ref": "#/$defs/StyleguideBandDto"
            }
          ]
        }
      }
    },
    "StyleguideContrastDto": {
      "type": "object",
      "properties": {
        "textOnBackground": {
          "type": "number",
          "description": "Contrast ratio of text against background."
        },
        "meetsAA": {
          "type": "boolean",
          "description": "Whether that ratio clears WCAG AA."
        },
        "accentOnBackground": {
          "type": "number"
        }
      }
    },
    "StyleguideDarkButtonDto": {
      "type": "object",
      "properties": {
        "background": {
          "type": "string"
        },
        "color": {
          "type": "string"
        }
      },
      "required": [
        "background"
      ]
    },
    "StyleguideDarkDto": {
      "type": "object",
      "properties": {
        "colors": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/StyleguideColorDto"
          }
        },
        "button": {
          "$ref": "#/$defs/StyleguideDarkButtonDto"
        },
        "contrast": {
          "$ref": "#/$defs/StyleguideContrastDto"
        }
      },
      "required": [
        "colors"
      ]
    },
    "StyleguideDecorationDto": {
      "type": "object",
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "pattern",
            "fill",
            "outline"
          ],
          "description": "A layer the site draws behind or beside its panels: a patterned image, a solid block or an outline, offset to read as a shadow."
        },
        "offsetX": {
          "type": "number"
        },
        "offsetY": {
          "type": "number"
        },
        "image": {
          "type": "string",
          "description": "The pattern's image on the site's own server. Recreate it rather than linking to it."
        },
        "color": {
          "type": "string"
        }
      },
      "required": [
        "kind"
      ]
    },
    "StyleguideFontDto": {
      "type": "object",
      "properties": {
        "role": {
          "type": "string",
          "enum": [
            "h1",
            "h2",
            "h3",
            "h4",
            "body",
            "link"
          ]
        },
        "family": {
          "type": "string"
        },
        "size": {
          "type": "number",
          "description": "Computed size in pixels."
        },
        "weight": {
          "type": [
            "object",
            "null"
          ]
        },
        "lineHeight": {
          "type": "number"
        },
        "letterSpacing": {
          "type": "string"
        },
        "fallbacks": {
          "description": "The rest of the declared stack, for rendering before the webfont arrives.",
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "role",
        "family"
      ]
    },
    "StyleguideFontUsageDto": {
      "type": "object",
      "properties": {
        "family": {
          "type": "string"
        },
        "words": {
          "type": "number"
        },
        "percentWords": {
          "type": "number"
        }
      },
      "required": [
        "family",
        "words",
        "percentWords"
      ]
    },
    "StyleguideHeaderBorderDto": {
      "type": "object",
      "properties": {
        "width": {
          "type": "number"
        },
        "color": {
          "type": "string"
        }
      }
    },
    "StyleguideHeaderDto": {
      "type": "object",
      "properties": {
        "background": {
          "type": "string"
        },
        "color": {
          "type": "string"
        },
        "height": {
          "type": "number"
        },
        "sticky": {
          "type": "boolean",
          "description": "Whether the bar stays pinned while the page scrolls."
        },
        "borderBottom": {
          "$ref": "#/$defs/StyleguideHeaderBorderDto"
        },
        "css": {
          "type": "string"
        }
      },
      "required": [
        "background"
      ]
    },
    "StyleguidePanelBorderDto": {
      "type": "object",
      "properties": {
        "width": {
          "type": "number"
        },
        "style": {
          "type": "string"
        },
        "color": {
          "type": "string",
          "description": "A hex color, or rgba() when the border is translucent."
        }
      }
    },
    "StyleguidePanelDto": {
      "type": "object",
      "properties": {
        "border": {
          "$ref": "#/$defs/StyleguidePanelBorderDto"
        },
        "radius": {
          "type": "string"
        },
        "background": {
          "type": "string"
        },
        "shadow": {
          "type": "string"
        },
        "decoration": {
          "$ref": "#/$defs/StyleguideDecorationDto"
        },
        "padding": {
          "type": "string",
          "description": "Vertical then horizontal padding."
        },
        "color": {
          "type": "string",
          "description": "Text color inside the panel."
        },
        "count": {
          "type": "number",
          "description": "How many boxes on the page share this treatment."
        },
        "css": {
          "type": "string",
          "description": "The panel as CSS declarations. A patterned decoration is not included; read `decoration` for it."
        }
      }
    },
    "StyleguideRadiusDto": {
      "type": "object",
      "properties": {
        "default": {
          "type": "string"
        },
        "card": {
          "type": "string"
        },
        "button": {
          "type": "string"
        }
      }
    },
    "StyleguideTabDto": {
      "type": "object",
      "properties": {
        "background": {
          "type": "string"
        },
        "color": {
          "type": "string"
        },
        "fontWeight": {
          "type": "string"
        },
        "radius": {
          "type": "string"
        },
        "border": {
          "$ref": "#/$defs/StyleguideHeaderBorderDto"
        },
        "borderBottom": {
          "description": "Absent with `border` set means the tab is open at the bottom, joined to the panel below.",
          "allOf": [
            {
              "$ref": "#/$defs/StyleguideHeaderBorderDto"
            }
          ]
        },
        "css": {
          "type": "string"
        }
      },
      "required": [
        "color"
      ]
    },
    "StyleguideTabsDto": {
      "type": "object",
      "properties": {
        "active": {
          "description": "The selected tab.",
          "allOf": [
            {
              "$ref": "#/$defs/StyleguideTabDto"
            }
          ]
        },
        "inactive": {
          "description": "A tab that is not selected.",
          "allOf": [
            {
              "$ref": "#/$defs/StyleguideTabDto"
            }
          ]
        }
      }
    },
    "StyleguideWebfontDto": {
      "type": "object",
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "google",
            "custom"
          ]
        },
        "files": {
          "type": "object",
          "additionalProperties": {
            "type": "string"
          },
          "description": "Weight to file URL on the site's own servers, for a family that has no public source. The files are licensed to the site, so check the licence before linking to them. Empty for a Google family: use `stylesheet` instead."
        },
        "stylesheet": {
          "type": "string",
          "description": "For a family published on Google Fonts, its Google stylesheet, even when the site hosts its own copy."
        }
      },
      "required": [
        "type",
        "files"
      ]
    },
    "WebStyleguideDataDto": {
      "type": "object",
      "properties": {
        "domain": {
          "type": "string"
        },
        "page": {
          "type": "string",
          "description": "The page that was read, when you asked for one with `url`."
        },
        "mode": {
          "type": "string",
          "enum": [
            "light",
            "dark"
          ],
          "description": "Whether the page as first loaded is light or dark. `colors` describe this mode."
        },
        "dark": {
          "description": "The colors the site switches to when the visitor prefers a dark theme. Null means we checked and the site does not change, so do not invent a dark palette from it. Absent on guides read before we checked.",
          "type": [
            "object",
            "null"
          ],
          "allOf": [
            {
              "$ref": "#/$defs/StyleguideDarkDto"
            }
          ]
        },
        "components": {
          "description": "How the parts are drawn, beyond the tokens: panel borders and decorative shadows, the header bar, and where headings sit on panels. This is what makes a site recognisable.",
          "allOf": [
            {
              "$ref": "#/$defs/StyleguideComponentsDto"
            }
          ]
        },
        "colors": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/StyleguideColorDto"
          }
        },
        "typography": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/StyleguideFontDto"
          }
        },
        "webfonts": {
          "type": "object",
          "additionalProperties": {
            "$ref": "#/$defs/StyleguideWebfontDto"
          },
          "description": "Keyed by family name."
        },
        "fontUsage": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/StyleguideFontUsageDto"
          }
        },
        "radius": {
          "$ref": "#/$defs/StyleguideRadiusDto"
        },
        "shadows": {
          "type": "object",
          "additionalProperties": {
            "type": "string"
          },
          "description": "Keyed by size, for example `sm`, `md`, `lg`."
        },
        "spacing": {
          "type": "object",
          "additionalProperties": {
            "type": "string"
          },
          "description": "Keyed by step, for example `xs` through `xl`."
        },
        "button": {
          "$ref": "#/$defs/StyleguideButtonDto"
        },
        "secondaryButton": {
          "description": "The second call to action, painted differently from the first, or outlined.",
          "allOf": [
            {
              "$ref": "#/$defs/StyleguideButtonDto"
            }
          ]
        },
        "contrast": {
          "description": "Whether you can put text on what we handed you.",
          "allOf": [
            {
              "$ref": "#/$defs/StyleguideContrastDto"
            }
          ]
        },
        "resolvedAt": {
          "type": [
            "object",
            "null"
          ]
        },
        "css": {
          "type": "string",
          "description": "The same design as a stylesheet you can paste in: `@font-face` rules for the webfonts and a `:root` block of CSS variables for colors, fonts, the type scale, radius, shadows and spacing. Values that are not plain colors, lengths, font names or https font files are left out."
        },
        "tailwind": {
          "type": "string",
          "description": "The same tokens as a Tailwind CSS v4 stylesheet. Paste it as your main CSS file and classes such as `bg-accent`, `font-heading`, `text-h1`, `rounded-button` and `shadow-md` use the site's design."
        },
        "shadcn": {
          "type": "string",
          "description": "The colors, radius and fonts under shadcn/ui variable names (`--background`, `--foreground`, `--primary`, `--card`, `--muted`, `--border` and the rest). Replace the `:root` block in a shadcn project's globals.css with it."
        }
      },
      "required": [
        "domain",
        "colors",
        "typography",
        "resolvedAt"
      ]
    }
  }
}