{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/blinkpdf-io/json-schema/blinkpdf-io-render-validate-ok-results-item-any-of0-typography-notes-item-schema.json",
  "title": "Render.ValidateOk.results.item.anyOf0.typographyNotes.item",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/blinkpdf-io-stamp-api-openapi.yml#/components/schemas/Render.ValidateOk.results.item.anyOf0.typographyNotes.item",
  "additionalProperties": false,
  "type": "object",
  "required": [
    "code",
    "impact",
    "family"
  ],
  "properties": {
    "code": {
      "description": "Informational typography diagnostic kind",
      "type": "string",
      "enum": [
        "variant_collapsed",
        "weight_not_in_fetch",
        "weight_unavailable",
        "variant_role_unknown",
        "variant_map_family_unresolved",
        "fontstack_weighted_dropped",
        "heading_variant_dropped",
        "role_cuts_unavailable",
        "google_font_axis_ignored",
        "google_font_weight_snapped",
        "line_height_capped"
      ]
    },
    "impact": {
      "description": "What the note changed in the PDF, on the impact scale of `Render.Diagnostic`: `appearance` when a cut or a line was not painted as named (`weight_unavailable`, `role_cuts_unavailable`, `heading_variant_dropped`, `line_height_capped`, `google_font_weight_snapped`, and `weight_not_in_fetch` for a weight a compose text names, which paints the nearest cut the URL fetched), `none` for an advisory on the request (`weight_not_in_fetch` for a `variantMap` weight, which is fetched all the same). A typography note never loses content.",
      "type": "string",
      "enum": [
        "none",
        "appearance"
      ]
    },
    "family": {
      "description": "Family the note applies to: its pool display name, hosted key, or the `blink://asset` handle of an uploaded font",
      "type": "string"
    },
    "weight": {
      "description": "Offending CSS weight (present for `weight_not_in_fetch` and `weight_unavailable`)",
      "type": "number"
    },
    "italic": {
      "description": "Present for `weight_unavailable` when the unserved cut is the italic one of `weight`; the upright cut of that weight was served",
      "const": true,
      "type": "boolean"
    },
    "suggestUrl": {
      "description": "For `weight_not_in_fetch`: a Google Fonts CSS2 URL (`https://fonts.googleapis.com/css2?family=…`) that declares `family` alone, with the upright weights the request fetched for it plus each missing weight, and the italic cuts it fetched (a note from a `variantMap` entry adds the italic cuts it misses). It corrects the entry of `googleFontsUrls` that declares `family`: when that entry declares no other family, put this URL in its place; otherwise keep its other families in it and declare `family` as this URL does.",
      "type": "string"
    },
    "role": {
      "description": "Unrecognized variantMap role (`variant_role_unknown`), or the named role whose cuts the hosted family lacks (`role_cuts_unavailable`)",
      "type": "string"
    },
    "didYouMean": {
      "description": "Nearest declared family names for a near-miss family (present for `variant_map_family_unresolved`)",
      "type": "array",
      "items": {
        "additionalProperties": false,
        "type": "object",
        "required": [
          "key"
        ],
        "properties": {
          "key": {
            "type": "string"
          }
        }
      }
    },
    "hint": {
      "description": "Why the note fired and how to resolve it; present on every note that advises a fix, which is every code except `variant_collapsed`, `weight_not_in_fetch`, `weight_unavailable`, and `variant_role_unknown`",
      "type": "string"
    },
    "axis": {
      "description": "Google Fonts axis tag accepted but ignored (present for `google_font_axis_ignored`), e.g. `wdth`",
      "type": "string"
    }
  }
}