{
  "id": "toyota",
  "version": "1.0.0",
  "name": "Toyota",
  "description": "Toyota Motor Sales, U.S.A. — the American sales and marketing arm of Toyota Motor Corporation. The Toyota mark is one of the most recognized automotive brands globally, anchored on a single signature color (Toyota Red, #EB0A1E / Pantone 186C) and the proprietary Toyota Type corporate face. Voice: confident, direct, human-centered (\"Let's Go Places\"). Visually, Toyota is light- first: white field, near-black wordmark and headline copy, and red as the brand-action color used sparingly and decisively.\n",
  "provenance": {
    "source": "https://www.toyota.com/",
    "license": "Proprietary — All Rights Reserved",
    "attribution": "Toyota Motor Sales, U.S.A., Inc. and Toyota Motor Corporation — all trademarks belong to Toyota Motor Corporation. Identity values verified from the official corporate horizontal-logo SVG (VIS_toyota_logo_horiz_black_RGB_2023.svg) served from delivery.tcom.assetscs.toyota.com and cross-referenced against the SETF Brand Portal (setfbranding.com/colors.html) which publishes Toyota Red as Pantone 186C / CMYK 0/100/90/0 / RGB 235/10/30 / HEX #EB0A1E.\n",
    "importedDate": "2026-05-19",
    "notes": "1.0.0 audit upgrade of toyota@0.1.0 — preserves the canonical Toyota Red + neutral palette and Toyota Type primary face, adds identity / on-identity roles for the white Toyota canvas, and expands the rules block from 3 to 7 typed entries grounded in Toyota corporate identity (toyota.com), Toyota Motor Corporation global brand-guide references, and the SETF Brand Portal Pantone documentation. The 0.1.0 spec remains historical.\n"
  },
  "tags": [
    "automotive",
    "oem",
    "toyota",
    "parent-brand",
    "red",
    "light-first"
  ],
  "palette": {
    "ref": "toyota@1.0.0",
    "swatches": [
      {
        "id": "toyota-red",
        "name": "Toyota Red",
        "value": "#EB0A1E",
        "description": "Primary Toyota brand red — used on the corporate mark and headline accents.",
        "aliases": []
      },
      {
        "id": "toyota-black",
        "name": "Toyota Black",
        "value": "#000000",
        "description": "Wordmark and headline text on light backgrounds.",
        "aliases": []
      },
      {
        "id": "toyota-graphite",
        "name": "Toyota Graphite",
        "value": "#252525",
        "description": "Near-black used by Southeast Toyota Dealers for the wordmark — softer than pure",
        "aliases": []
      },
      {
        "id": "toyota-white",
        "name": "Toyota White",
        "value": "#FFFFFF",
        "description": "Page background; reversed wordmark fill on dark surfaces.",
        "aliases": []
      },
      {
        "id": "toyota-platinum",
        "name": "Toyota Platinum",
        "value": "#F5F5F5",
        "description": "Subtle panel surface — feature blocks and quiet cards.",
        "aliases": []
      },
      {
        "id": "toyota-silver",
        "name": "Toyota Silver",
        "value": "#86939E",
        "description": "Secondary text and dividers — mirrors the SETF \"Supporting 5\" gray.",
        "aliases": []
      },
      {
        "id": "toyota-ash",
        "name": "Toyota Ash",
        "value": "#58595B",
        "description": "Tertiary text.",
        "aliases": []
      }
    ],
    "modes": {
      "light": {
        "roles": {
          "background": "toyota-white",
          "surface": "toyota-platinum",
          "surface-elevated": "toyota-white",
          "text-primary": "toyota-graphite",
          "text-secondary": "toyota-ash",
          "text-tertiary": "toyota-silver",
          "primary": "toyota-red",
          "primary-hover": "toyota-red",
          "accent": "toyota-red",
          "success": "toyota-silver",
          "warning": "toyota-red",
          "error": "toyota-red",
          "info": "toyota-ash"
        }
      },
      "dark": {
        "roles": {
          "background": "toyota-black",
          "surface": "toyota-graphite",
          "surface-elevated": "toyota-ash",
          "text-primary": "toyota-white",
          "text-secondary": "toyota-platinum",
          "text-tertiary": "toyota-silver",
          "primary": "toyota-red",
          "primary-hover": "toyota-red",
          "accent": "toyota-red",
          "success": "toyota-platinum",
          "warning": "toyota-red",
          "error": "toyota-red",
          "info": "toyota-silver"
        }
      }
    }
  },
  "fonts": [
    {
      "role": "heading",
      "ref": "toyota-type@1.0.0",
      "family": "ToyotaType",
      "classification": "sans-serif",
      "source": {
        "kind": "external",
        "family": "ToyotaType",
        "notes": "Licensed font; no public CDN. Distributed by Toyota Motor Corporation to authorized vendors. CSS @font-face declaration must reference internally hosted files.\n"
      },
      "fallbackStack": [
        "Helvetica Neue",
        "Helvetica",
        "-apple-system",
        "BlinkMacSystemFont",
        "Segoe UI",
        "Arial",
        "sans-serif"
      ],
      "availableStyles": [
        {
          "weight": 400,
          "style": "normal"
        },
        {
          "weight": 600,
          "style": "normal"
        }
      ]
    },
    {
      "role": "body",
      "ref": "toyota-type@1.0.0",
      "family": "ToyotaType",
      "classification": "sans-serif",
      "source": {
        "kind": "external",
        "family": "ToyotaType",
        "notes": "Licensed font; no public CDN. Distributed by Toyota Motor Corporation to authorized vendors. CSS @font-face declaration must reference internally hosted files.\n"
      },
      "fallbackStack": [
        "Helvetica Neue",
        "Helvetica",
        "-apple-system",
        "BlinkMacSystemFont",
        "Segoe UI",
        "Arial",
        "sans-serif"
      ],
      "availableStyles": [
        {
          "weight": 400,
          "style": "normal"
        },
        {
          "weight": 600,
          "style": "normal"
        }
      ]
    },
    {
      "role": "mono",
      "ref": "jetbrainsmono-nerdfont@1.0.0",
      "family": "JetBrainsMono Nerd Font",
      "classification": "monospace",
      "source": {
        "kind": "external",
        "family": "JetBrainsMono Nerd Font",
        "notes": "Nerd-Font-patched build of JetBrains Mono. Not available via Google Fonts. Download woff2/ttf files from the Nerd Fonts GitHub release and self-host, or install system-wide for terminal/IDE use.\n"
      },
      "fallbackStack": [
        "JetBrains Mono",
        "Fira Code",
        "Menlo",
        "Monaco",
        "Consolas",
        "Liberation Mono",
        "monospace"
      ],
      "availableStyles": [
        {
          "weight": 100,
          "style": "normal"
        },
        {
          "weight": 100,
          "style": "italic"
        },
        {
          "weight": 200,
          "style": "normal"
        },
        {
          "weight": 200,
          "style": "italic"
        },
        {
          "weight": 300,
          "style": "normal"
        },
        {
          "weight": 300,
          "style": "italic"
        },
        {
          "weight": 400,
          "style": "normal"
        },
        {
          "weight": 400,
          "style": "italic"
        },
        {
          "weight": 500,
          "style": "normal"
        },
        {
          "weight": 500,
          "style": "italic"
        },
        {
          "weight": 600,
          "style": "normal"
        },
        {
          "weight": 600,
          "style": "italic"
        },
        {
          "weight": 700,
          "style": "normal"
        },
        {
          "weight": 700,
          "style": "italic"
        },
        {
          "weight": 800,
          "style": "normal"
        },
        {
          "weight": 800,
          "style": "italic"
        }
      ]
    }
  ],
  "roles": {
    "colors": {
      "identity": "toyota-white",
      "on-identity": "toyota-graphite",
      "primary": "toyota-red",
      "primary-hover": "toyota-red",
      "accent": "toyota-red",
      "mark": "toyota-black",
      "text-primary-light": "toyota-graphite",
      "text-primary-dark": "toyota-white",
      "background-light": "toyota-white",
      "background-dark": "toyota-black",
      "surface-light": "toyota-platinum",
      "surface-dark": "toyota-graphite",
      "border-light": "toyota-silver"
    },
    "typography": {
      "display": "heading",
      "prose": "body",
      "code": "mono"
    }
  },
  "assets": [],
  "rules": [
    {
      "type": "contrastRatio",
      "target": "text-primary",
      "severity": "error",
      "rationale": "Toyota Graphite (#252525) on Toyota White (#FFFFFF) measures ~16:1, and Toyota White on Toyota Black is ~21:1 — both decisively past the AA floor. Toyota's marketing and dealer properties operate at AA as the published baseline; consumer-facing safety and financing copy must remain legible across devices, lighting, and printed media.\n",
      "against": "background",
      "minRatio": 4.5,
      "standard": "WCAG-AA"
    },
    {
      "type": "colorChoice",
      "target": "roles.colors.primary",
      "severity": "error",
      "rationale": "Toyota Red (#EB0A1E / Pantone 186C) is the single signature color in the Toyota brand system. Every other swatch in the palette is a neutral surface or text role; substituting any of them for the primary collapses the brand's visual recognition.\n",
      "allowed": [
        "toyota-red"
      ],
      "forbidden": [
        "toyota-black",
        "toyota-graphite",
        "toyota-white",
        "toyota-platinum",
        "toyota-silver",
        "toyota-ash"
      ]
    },
    {
      "type": "colorChoice",
      "target": "roles.colors.mark",
      "severity": "error",
      "rationale": "The Toyota wordmark renders in solid black on light surfaces and solid white on dark surfaces; the \"T-ellipses\" emblem may be rendered in Toyota Red as a featured mark. Mid-gray tints (graphite, platinum, silver, ash) are not authorized mark fills — they collapse the wordmark's silhouette against light surfaces.\n",
      "allowed": [
        "toyota-black",
        "toyota-white",
        "toyota-red"
      ],
      "forbidden": [
        "toyota-graphite",
        "toyota-platinum",
        "toyota-silver",
        "toyota-ash"
      ]
    },
    {
      "type": "forbiddenTreatment",
      "target": "logo",
      "severity": "error",
      "rationale": "The Toyota mark is one of the most-protected commercial marks in the world. Only Toyota-approved variants, clearspace ratios, and color treatments are permitted; Toyota Motor Corporation enforces the dealer and partner identity standards globally and exposes the approved treatments through licensed brand portals.\n",
      "treatments": [
        "stretched",
        "rotated",
        "recolored",
        "drop-shadow",
        "on-busy-photo",
        "gradient-fill",
        "inverted-without-variant",
        "outlined-only"
      ]
    },
    {
      "type": "enumMembership",
      "target": "typography.heading.fontWeight",
      "severity": "warning",
      "rationale": "Toyota Type is distributed in Book (400) and Semibold (600) — the two weights authorized in licensed Toyota brand packages, including the SETF Brand Portal's documented type pair. Other weights are not part of the licensed kit.\n",
      "allowed": [
        "400",
        "600"
      ]
    },
    {
      "type": "contextRestriction",
      "target": "roles.colors.primary",
      "severity": "error",
      "rationale": "Toyota Red is a signature color, not a surface color. Using it as a body-text fill or as a large-surface background breaks the discipline that gives the red its impact — it is reserved for the mark, primary CTAs, and brand-feature emphasis where Toyota's brand voice peaks.\n",
      "allowedContexts": [
        "cta-primary",
        "brand-feature",
        "mark-emphasis"
      ],
      "forbiddenContexts": [
        "body-text",
        "large-surface-fill",
        "background-fill"
      ]
    },
    {
      "type": "compositionConstraint",
      "target": "roles.colors.primary",
      "severity": "error",
      "rationale": "Toyota Red pairs with the Toyota neutral scale only. Placing it adjacent to a JMFE-family teal or Lexus chrome breaks the Toyota corporate-identity standalone posture — Toyota presents on its own palette, not adjacent to its partner / distributor identities.\n",
      "pairsWith": [
        "toyota-white",
        "toyota-platinum",
        "toyota-black",
        "toyota-graphite"
      ],
      "doesNotPairWith": [
        "jmfe-teal",
        "jma-teal",
        "wo-teal",
        "lexus-chrome"
      ]
    }
  ]
}