@cupped/tokens 0.1.0

package/dist/json/tokens.dtcg.json

@@ -0,0 +1,1501 @@
+{
+  "color": {
+    "$type": "color",
+    "palette": {
+      "$description": "Raw palette values. Never consumed by apps — alias through the semantic layer.",
+      "white": {
+        "$value": "#FFFFFF"
+      },
+      "slate": {
+        "50": {
+          "$value": "#F8FAFC"
+        },
+        "100": {
+          "$value": "#F1F5F9"
+        },
+        "200": {
+          "$value": "#E2E8F0"
+        },
+        "400": {
+          "$value": "#94A3B8"
+        },
+        "600": {
+          "$value": "#475569"
+        },
+        "900": {
+          "$value": "#0F172A"
+        },
+        "$description": "Cool slate neutrals — carry all UI chrome."
+      },
+      "coral": {
+        "50": {
+          "$value": "#FDF2F0"
+        },
+        "500": {
+          "$value": "#E07A5F"
+        },
+        "550": {
+          "$value": "#D16A4F"
+        },
+        "600": {
+          "$value": "#C05539"
+        },
+        "650": {
+          "$value": "#AD4A30"
+        },
+        "$description": "Warm brand coral — carries action and brand. Coral = action; slate = chrome."
+      },
+      "ember": {
+        "$description": "Gamification source hue (streak fire). Promoted to a source token in the refreshed export; --streak aliases it.",
+        "fill": {
+          "$value": "#F97316"
+        },
+        "text": {
+          "$value": "#C2410C"
+        }
+      },
+      "green": {
+        "50": {
+          "$value": "#F0FDF4"
+        },
+        "500": {
+          "$value": "#22C55E"
+        },
+        "700": {
+          "$value": "#15803D"
+        }
+      },
+      "red": {
+        "50": {
+          "$value": "#FEF2F2"
+        },
+        "500": {
+          "$value": "#EF4444"
+        },
+        "700": {
+          "$value": "#B91C1C"
+        }
+      },
+      "amber": {
+        "50": {
+          "$value": "#FFFBEB"
+        },
+        "500": {
+          "$value": "#F59E0B"
+        },
+        "700": {
+          "$value": "#B45309"
+        }
+      },
+      "blue": {
+        "50": {
+          "$value": "#EFF6FF"
+        },
+        "500": {
+          "$value": "#3B82F6"
+        },
+        "700": {
+          "$value": "#1D4ED8"
+        }
+      },
+      "flavor": {
+        "$description": "SCA tasting vocabulary — parametric oklch band (\"Espresso\"), not hand-picked hexes. Fill band: L 0.555 · C 0.135 (bright) / 0.062 (earth) / earth ×0.7 (roasted). Text band: L 0.510 · C 0.110 (bright) / 0.060 (earth). Hue carries the flavor; lightness/chroma are shared, so every fill carries white text at ≥4.5:1 with zero exceptions.",
+        "fruity": {
+          "fill": {
+            "$value": "#B44C54",
+            "$extensions": {
+              "app.cupped": {
+                "oklch": {
+                  "l": 0.555,
+                  "c": 0.135,
+                  "h": 18
+                },
+                "band": "fill"
+              }
+            }
+          },
+          "text": {
+            "$value": "#9B494E",
+            "$extensions": {
+              "app.cupped": {
+                "oklch": {
+                  "l": 0.51,
+                  "c": 0.11,
+                  "h": 18
+                },
+                "band": "text"
+              }
+            }
+          }
+        },
+        "berry": {
+          "fill": {
+            "$value": "#AC4D7B",
+            "$extensions": {
+              "app.cupped": {
+                "oklch": {
+                  "l": 0.555,
+                  "c": 0.135,
+                  "h": 352
+                },
+                "band": "fill"
+              }
+            }
+          },
+          "text": {
+            "$value": "#94496D",
+            "$extensions": {
+              "app.cupped": {
+                "oklch": {
+                  "l": 0.51,
+                  "c": 0.11,
+                  "h": 352
+                },
+                "band": "text"
+              }
+            }
+          }
+        },
+        "citrus": {
+          "fill": {
+            "$value": "#A65F02",
+            "$extensions": {
+              "app.cupped": {
+                "oklch": {
+                  "l": 0.555,
+                  "c": 0.135,
+                  "h": 62
+                },
+                "band": "fill"
+              }
+            }
+          },
+          "text": {
+            "$value": "#925512",
+            "$extensions": {
+              "app.cupped": {
+                "oklch": {
+                  "l": 0.51,
+                  "c": 0.11,
+                  "h": 62
+                },
+                "band": "text"
+              }
+            }
+          }
+        },
+        "sweet": {
+          "fill": {
+            "$value": "#8E6E09",
+            "$extensions": {
+              "app.cupped": {
+                "oklch": {
+                  "l": 0.555,
+                  "c": 0.135,
+                  "h": 88
+                },
+                "band": "fill"
+              }
+            }
+          },
+          "text": {
+            "$value": "#7E6207",
+            "$extensions": {
+              "app.cupped": {
+                "oklch": {
+                  "l": 0.51,
+                  "c": 0.11,
+                  "h": 88
+                },
+                "band": "text"
+              }
+            }
+          }
+        },
+        "floral": {
+          "fill": {
+            "$value": "#865CB2",
+            "$extensions": {
+              "app.cupped": {
+                "oklch": {
+                  "l": 0.555,
+                  "c": 0.135,
+                  "h": 305
+                },
+                "band": "fill"
+              }
+            }
+          },
+          "text": {
+            "$value": "#755498",
+            "$extensions": {
+              "app.cupped": {
+                "oklch": {
+                  "l": 0.51,
+                  "c": 0.11,
+                  "h": 305
+                },
+                "band": "text"
+              }
+            }
+          }
+        },
+        "green": {
+          "fill": {
+            "$value": "#4E8429",
+            "$extensions": {
+              "app.cupped": {
+                "oklch": {
+                  "l": 0.555,
+                  "c": 0.135,
+                  "h": 135
+                },
+                "band": "fill"
+              }
+            }
+          },
+          "text": {
+            "$value": "#49742E",
+            "$extensions": {
+              "app.cupped": {
+                "oklch": {
+                  "l": 0.51,
+                  "c": 0.11,
+                  "h": 135
+                },
+                "band": "text"
+              }
+            }
+          }
+        },
+        "spice": {
+          "fill": {
+            "$value": "#B4503A",
+            "$extensions": {
+              "app.cupped": {
+                "oklch": {
+                  "l": 0.555,
+                  "c": 0.135,
+                  "h": 34
+                },
+                "band": "fill"
+              }
+            }
+          },
+          "text": {
+            "$value": "#9B4C3A",
+            "$extensions": {
+              "app.cupped": {
+                "oklch": {
+                  "l": 0.51,
+                  "c": 0.11,
+                  "h": 34
+                },
+                "band": "text"
+              }
+            }
+          }
+        },
+        "nutty": {
+          "fill": {
+            "$value": "#876F49",
+            "$extensions": {
+              "app.cupped": {
+                "oklch": {
+                  "l": 0.555,
+                  "c": 0.062,
+                  "h": 78
+                },
+                "band": "fill"
+              }
+            }
+          },
+          "text": {
+            "$value": "#79623E",
+            "$extensions": {
+              "app.cupped": {
+                "oklch": {
+                  "l": 0.51,
+                  "c": 0.06,
+                  "h": 78
+                },
+                "band": "text"
+              }
+            }
+          }
+        },
+        "chocolate": {
+          "fill": {
+            "$value": "#916951",
+            "$extensions": {
+              "app.cupped": {
+                "oklch": {
+                  "l": 0.555,
+                  "c": 0.062,
+                  "h": 52
+                },
+                "band": "fill"
+              }
+            }
+          },
+          "text": {
+            "$value": "#825C46",
+            "$extensions": {
+              "app.cupped": {
+                "oklch": {
+                  "l": 0.51,
+                  "c": 0.06,
+                  "h": 52
+                },
+                "band": "text"
+              }
+            }
+          }
+        },
+        "roasted": {
+          "fill": {
+            "$value": "#896B5E",
+            "$extensions": {
+              "app.cupped": {
+                "oklch": {
+                  "l": 0.555,
+                  "c": 0.0434,
+                  "h": 45
+                },
+                "band": "fill"
+              }
+            }
+          },
+          "text": {
+            "$value": "#7B5F52",
+            "$extensions": {
+              "app.cupped": {
+                "oklch": {
+                  "l": 0.51,
+                  "c": 0.042,
+                  "h": 45
+                },
+                "band": "text"
+              }
+            }
+          }
+        }
+      }
+    },
+    "surface": {
+      "canvas": {
+        "$value": "{color.palette.slate.50}",
+        "$description": "App background.",
+        "$extensions": {
+          "app.cupped": {
+            "cssName": "canvas"
+          }
+        }
+      },
+      "card": {
+        "$value": "{color.palette.white}",
+        "$description": "Cards, elevated surfaces.",
+        "$extensions": {
+          "app.cupped": {
+            "cssName": "card"
+          }
+        }
+      },
+      "canvas-border": {
+        "$value": "{color.palette.slate.200}",
+        "$description": "Default borders, dividers.",
+        "$extensions": {
+          "app.cupped": {
+            "cssName": "canvas-border"
+          }
+        }
+      },
+      "canvas-border-subtle": {
+        "$value": "{color.palette.slate.100}",
+        "$description": "Subtle dividers.",
+        "$extensions": {
+          "app.cupped": {
+            "cssName": "canvas-border-subtle"
+          }
+        }
+      }
+    },
+    "ink": {
+      "default": {
+        "$value": "{color.palette.slate.900}",
+        "$description": "Primary text, headings — 16.9:1 AAA.",
+        "$extensions": {
+          "app.cupped": {
+            "cssName": "ink",
+            "contrast": [
+              {
+                "against": "{color.surface.canvas}",
+                "min": 4.5
+              },
+              {
+                "against": "{color.surface.card}",
+                "min": 4.5
+              }
+            ]
+          }
+        }
+      },
+      "secondary": {
+        "$value": "{color.palette.slate.600}",
+        "$description": "Secondary text, labels — 7.5:1 AA.",
+        "$extensions": {
+          "app.cupped": {
+            "contrast": [
+              {
+                "against": "{color.surface.canvas}",
+                "min": 4.5
+              },
+              {
+                "against": "{color.surface.card}",
+                "min": 4.5
+              }
+            ]
+          }
+        }
+      },
+      "muted": {
+        "$value": "{color.palette.slate.400}",
+        "$description": "Placeholders, decorative only — never body text."
+      },
+      "inverse": {
+        "$value": "{color.palette.slate.50}",
+        "$description": "Text on dark / strong fills. Note: 4.36:1 on primary-strong (the spec's 4.6:1 claim is for pure white #FFFFFF); flagged upstream, not encoded as an invariant."
+      }
+    },
+    "primary": {
+      "default": {
+        "$value": "{color.palette.coral.500}",
+        "$description": "Accents, ≥24px display text, illustration. ~3.0:1 on white — NEVER text below 24px.",
+        "$extensions": {
+          "app.cupped": {
+            "cssName": "primary",
+            "minTextPx": 24
+          }
+        }
+      },
+      "strong": {
+        "$value": "{color.palette.coral.600}",
+        "$description": "Action coral · 4.6:1 — buttons, links, small colored text.",
+        "$extensions": {
+          "app.cupped": {
+            "contrast": [
+              {
+                "against": "{color.surface.card}",
+                "min": 4.5
+              },
+              {
+                "against": "{color.surface.canvas}",
+                "min": 3,
+                "note": "focus-ring outer color, non-text WCAG 2.2"
+              }
+            ]
+          }
+        }
+      },
+      "strong-hover": {
+        "$value": "{color.palette.coral.650}",
+        "$description": "Hover/pressed for primary-strong fills."
+      },
+      "hover": {
+        "$value": "{color.palette.coral.550}",
+        "$description": "Hover for decorative coral fills."
+      },
+      "light": {
+        "$value": "{color.palette.coral.50}",
+        "$description": "Subtle coral background."
+      },
+      "muted": {
+        "$value": "rgba(224, 122, 95, 0.12)",
+        "$description": "12% coral-500 wash."
+      }
+    },
+    "success": {
+      "default": {
+        "$value": "{color.palette.green.500}",
+        "$extensions": {
+          "app.cupped": {
+            "cssName": "success"
+          }
+        }
+      },
+      "light": {
+        "$value": "{color.palette.green.50}"
+      },
+      "ink": {
+        "$value": "{color.palette.green.700}",
+        "$description": "AA text/icon variant on success-light.",
+        "$extensions": {
+          "app.cupped": {
+            "contrast": [
+              {
+                "against": "{color.success.light}",
+                "min": 4.5
+              }
+            ]
+          }
+        }
+      }
+    },
+    "error": {
+      "default": {
+        "$value": "{color.palette.red.500}",
+        "$extensions": {
+          "app.cupped": {
+            "cssName": "error"
+          }
+        }
+      },
+      "light": {
+        "$value": "{color.palette.red.50}"
+      },
+      "ink": {
+        "$value": "{color.palette.red.700}",
+        "$description": "AA text/icon variant on error-light.",
+        "$extensions": {
+          "app.cupped": {
+            "contrast": [
+              {
+                "against": "{color.error.light}",
+                "min": 4.5
+              }
+            ]
+          }
+        }
+      }
+    },
+    "warning": {
+      "default": {
+        "$value": "{color.palette.amber.500}",
+        "$extensions": {
+          "app.cupped": {
+            "cssName": "warning"
+          }
+        }
+      },
+      "light": {
+        "$value": "{color.palette.amber.50}"
+      },
+      "ink": {
+        "$value": "{color.palette.amber.700}",
+        "$description": "AA text/icon variant on warning-light.",
+        "$extensions": {
+          "app.cupped": {
+            "contrast": [
+              {
+                "against": "{color.warning.light}",
+                "min": 4.5
+              }
+            ]
+          }
+        }
+      }
+    },
+    "info": {
+      "default": {
+        "$value": "{color.palette.blue.500}",
+        "$extensions": {
+          "app.cupped": {
+            "cssName": "info"
+          }
+        }
+      },
+      "light": {
+        "$value": "{color.palette.blue.50}"
+      },
+      "ink": {
+        "$value": "{color.palette.blue.700}",
+        "$description": "AA text/icon variant on info-light.",
+        "$extensions": {
+          "app.cupped": {
+            "contrast": [
+              {
+                "against": "{color.info.light}",
+                "min": 4.5
+              }
+            ]
+          }
+        }
+      }
+    },
+    "fruity": {
+      "$value": "{color.palette.flavor.fruity.fill}",
+      "$extensions": {
+        "app.cupped": {
+          "contrast": [
+            {
+              "against": "{color.on-flavor}",
+              "min": 4.5
+            }
+          ]
+        }
+      }
+    },
+    "floral": {
+      "$value": "{color.palette.flavor.floral.fill}",
+      "$extensions": {
+        "app.cupped": {
+          "contrast": [
+            {
+              "against": "{color.on-flavor}",
+              "min": 4.5
+            }
+          ]
+        }
+      }
+    },
+    "nutty": {
+      "$value": "{color.palette.flavor.nutty.fill}",
+      "$extensions": {
+        "app.cupped": {
+          "contrast": [
+            {
+              "against": "{color.on-flavor}",
+              "min": 4.5
+            }
+          ]
+        }
+      }
+    },
+    "chocolate": {
+      "$value": "{color.palette.flavor.chocolate.fill}",
+      "$extensions": {
+        "app.cupped": {
+          "contrast": [
+            {
+              "against": "{color.on-flavor}",
+              "min": 4.5
+            }
+          ]
+        }
+      }
+    },
+    "spice": {
+      "$value": "{color.palette.flavor.spice.fill}",
+      "$extensions": {
+        "app.cupped": {
+          "contrast": [
+            {
+              "against": "{color.on-flavor}",
+              "min": 4.5
+            }
+          ]
+        }
+      }
+    },
+    "sweet": {
+      "$value": "{color.palette.flavor.sweet.fill}",
+      "$extensions": {
+        "app.cupped": {
+          "contrast": [
+            {
+              "against": "{color.on-flavor}",
+              "min": 4.5
+            }
+          ]
+        }
+      }
+    },
+    "citrus": {
+      "$value": "{color.palette.flavor.citrus.fill}",
+      "$extensions": {
+        "app.cupped": {
+          "contrast": [
+            {
+              "against": "{color.on-flavor}",
+              "min": 4.5
+            }
+          ]
+        }
+      }
+    },
+    "green": {
+      "$value": "{color.palette.flavor.green.fill}",
+      "$extensions": {
+        "app.cupped": {
+          "contrast": [
+            {
+              "against": "{color.on-flavor}",
+              "min": 4.5
+            }
+          ]
+        }
+      }
+    },
+    "berry": {
+      "$value": "{color.palette.flavor.berry.fill}",
+      "$extensions": {
+        "app.cupped": {
+          "contrast": [
+            {
+              "against": "{color.on-flavor}",
+              "min": 4.5
+            }
+          ]
+        }
+      }
+    },
+    "roasted": {
+      "$value": "{color.palette.flavor.roasted.fill}",
+      "$extensions": {
+        "app.cupped": {
+          "contrast": [
+            {
+              "against": "{color.on-flavor}",
+              "min": 4.5
+            }
+          ]
+        }
+      }
+    },
+    "fruity-accessible": {
+      "$value": "{color.palette.flavor.fruity.text}",
+      "$extensions": {
+        "app.cupped": {
+          "contrast": [
+            {
+              "against": "{color.surface.card}",
+              "min": 5.5
+            }
+          ]
+        }
+      }
+    },
+    "berry-accessible": {
+      "$value": "{color.palette.flavor.berry.text}",
+      "$extensions": {
+        "app.cupped": {
+          "contrast": [
+            {
+              "against": "{color.surface.card}",
+              "min": 5.5
+            }
+          ]
+        }
+      }
+    },
+    "citrus-accessible": {
+      "$value": "{color.palette.flavor.citrus.text}",
+      "$extensions": {
+        "app.cupped": {
+          "contrast": [
+            {
+              "against": "{color.surface.card}",
+              "min": 5.5
+            }
+          ]
+        }
+      }
+    },
+    "sweet-accessible": {
+      "$value": "{color.palette.flavor.sweet.text}",
+      "$extensions": {
+        "app.cupped": {
+          "contrast": [
+            {
+              "against": "{color.surface.card}",
+              "min": 5.5
+            }
+          ]
+        }
+      }
+    },
+    "floral-accessible": {
+      "$value": "{color.palette.flavor.floral.text}",
+      "$extensions": {
+        "app.cupped": {
+          "contrast": [
+            {
+              "against": "{color.surface.card}",
+              "min": 5.5
+            }
+          ]
+        }
+      }
+    },
+    "green-accessible": {
+      "$value": "{color.palette.flavor.green.text}",
+      "$extensions": {
+        "app.cupped": {
+          "contrast": [
+            {
+              "against": "{color.surface.card}",
+              "min": 5.5
+            }
+          ]
+        }
+      }
+    },
+    "spice-accessible": {
+      "$value": "{color.palette.flavor.spice.text}",
+      "$extensions": {
+        "app.cupped": {
+          "contrast": [
+            {
+              "against": "{color.surface.card}",
+              "min": 5.5
+            }
+          ]
+        }
+      }
+    },
+    "nutty-accessible": {
+      "$value": "{color.palette.flavor.nutty.text}",
+      "$extensions": {
+        "app.cupped": {
+          "contrast": [
+            {
+              "against": "{color.surface.card}",
+              "min": 5.5
+            }
+          ]
+        }
+      }
+    },
+    "chocolate-accessible": {
+      "$value": "{color.palette.flavor.chocolate.text}",
+      "$extensions": {
+        "app.cupped": {
+          "contrast": [
+            {
+              "against": "{color.surface.card}",
+              "min": 5.5
+            }
+          ]
+        }
+      }
+    },
+    "roasted-accessible": {
+      "$value": "{color.palette.flavor.roasted.text}",
+      "$extensions": {
+        "app.cupped": {
+          "contrast": [
+            {
+              "against": "{color.surface.card}",
+              "min": 5.5
+            }
+          ]
+        }
+      }
+    },
+    "on-flavor": {
+      "$value": "{color.palette.white}",
+      "$description": "Text on SOLID flavor fills. White everywhere; the band guarantees AA."
+    },
+    "xp": {
+      "$value": "{color.sweet}",
+      "$description": "Gamification alias — reserved for reward moments, never decoration."
+    },
+    "xp-accessible": {
+      "$value": "{color.sweet-accessible}"
+    },
+    "ember": {
+      "$value": "{color.palette.ember.fill}",
+      "$description": "Gamification source hue (streak fire)."
+    },
+    "ember-accessible": {
+      "$value": "{color.palette.ember.text}",
+      "$extensions": {
+        "app.cupped": {
+          "contrast": [
+            {
+              "against": "{color.surface.card}",
+              "min": 4.5
+            }
+          ]
+        }
+      }
+    },
+    "streak": {
+      "$value": "{color.ember}",
+      "$description": "Gamification alias — change the source (ember), not the alias."
+    },
+    "streak-accessible": {
+      "$value": "{color.ember-accessible}"
+    },
+    "badge": {
+      "$value": "{color.floral}",
+      "$description": "Gamification alias — reserved for reward moments, never decoration."
+    },
+    "badge-accessible": {
+      "$value": "{color.floral-accessible}"
+    },
+    "zone": {
+      "$description": "TDS extraction zones — aliases of feedback.",
+      "ideal": {
+        "$value": "{color.success.default}"
+      },
+      "under": {
+        "$value": "{color.info.default}"
+      },
+      "over": {
+        "$value": "{color.error.default}"
+      },
+      "strong": {
+        "$value": "{color.warning.default}"
+      },
+      "weak": {
+        "$value": "{color.ink.muted}"
+      }
+    },
+    "chart": {
+      "$description": "Chart series — aliases.",
+      "sca": {
+        "$value": "{color.primary.default}"
+      },
+      "ucdavis": {
+        "$value": "{color.floral}"
+      },
+      "grid": {
+        "$value": "{color.surface.canvas-border}"
+      }
+    }
+  },
+  "dimension": {
+    "$type": "dimension",
+    "scale": {
+      "2": {
+        "$value": "2px"
+      },
+      "4": {
+        "$value": "4px"
+      },
+      "8": {
+        "$value": "8px"
+      },
+      "12": {
+        "$value": "12px"
+      },
+      "16": {
+        "$value": "16px"
+      },
+      "20": {
+        "$value": "20px"
+      },
+      "24": {
+        "$value": "24px"
+      },
+      "32": {
+        "$value": "32px"
+      },
+      "44": {
+        "$value": "44px"
+      },
+      "$description": "Raw 4pt-grid dimension stops (plus 2px ring width and the 9999px pill radius). Never consumed by apps — alias through the semantic layer.",
+      "full": {
+        "$value": "9999px"
+      }
+    }
+  },
+  "duration": {
+    "$type": "duration",
+    "$description": "Raw durations. Kept in the spec's original units so generated CSS matches the canonical export character-for-character; the native pipeline normalizes to ms numbers.",
+    "spring": {
+      "$value": "0.55s"
+    },
+    "stagger": {
+      "$value": "0.08s"
+    },
+    "shimmer": {
+      "$value": "1.5s"
+    },
+    "reduced": {
+      "$value": "120ms"
+    }
+  },
+  "font": {
+    "family": {
+      "$type": "fontFamily",
+      "$description": "Three families, each with a job: Inter for all UI, Instrument Serif for display (max one moment per screen), JetBrains Mono for the technical register. Never Lora, Fraunces, or Plus Jakarta.",
+      "sans": {
+        "$value": [
+          "Inter",
+          "-apple-system",
+          "BlinkMacSystemFont",
+          "Segoe UI",
+          "sans-serif"
+        ]
+      },
+      "serif": {
+        "$value": [
+          "Instrument Serif",
+          "Georgia",
+          "serif"
+        ]
+      },
+      "mono": {
+        "$value": [
+          "JetBrains Mono",
+          "ui-monospace",
+          "SFMono-Regular",
+          "monospace"
+        ]
+      }
+    },
+    "weight": {
+      "$type": "fontWeight",
+      "regular": {
+        "$value": 400
+      },
+      "medium": {
+        "$value": 500
+      },
+      "semibold": {
+        "$value": 600
+      },
+      "bold": {
+        "$value": 700
+      }
+    },
+    "size": {
+      "12": {
+        "$value": "12px"
+      },
+      "14": {
+        "$value": "14px"
+      },
+      "16": {
+        "$value": "16px"
+      },
+      "20": {
+        "$value": "20px"
+      },
+      "24": {
+        "$value": "24px"
+      },
+      "32": {
+        "$value": "32px"
+      },
+      "56": {
+        "$value": "56px"
+      },
+      "$type": "dimension",
+      "$description": "Raw size stops. Every size shipped in a component has a semantic token name — no ad-hoc sizes."
+    }
+  },
+  "shadow": {
+    "$type": "shadow",
+    "$description": "Shadow recipes for lifted surfaces — soft, low-opacity, slate-based, never harsh. Android elevations are judgment calls recorded in $extensions (no formulaic mapping).",
+    "sm": {
+      "$value": [
+        {
+          "color": "rgba(15,23,42,0.04)",
+          "offsetX": "0px",
+          "offsetY": "1px",
+          "blur": "2px",
+          "spread": "0px"
+        },
+        {
+          "color": "rgba(15,23,42,0.03)",
+          "offsetX": "0px",
+          "offsetY": "1px",
+          "blur": "1px",
+          "spread": "0px"
+        }
+      ],
+      "$description": "Cards, rows.",
+      "$extensions": {
+        "app.cupped": {
+          "androidElevation": 1
+        }
+      }
+    },
+    "md": {
+      "$value": [
+        {
+          "color": "rgba(15,23,42,0.06)",
+          "offsetX": "0px",
+          "offsetY": "4px",
+          "blur": "12px",
+          "spread": "0px"
+        },
+        {
+          "color": "rgba(15,23,42,0.04)",
+          "offsetX": "0px",
+          "offsetY": "1px",
+          "blur": "3px",
+          "spread": "0px"
+        }
+      ],
+      "$description": "Sheets, menus.",
+      "$extensions": {
+        "app.cupped": {
+          "androidElevation": 4
+        }
+      }
+    },
+    "lg": {
+      "$value": [
+        {
+          "color": "rgba(15,23,42,0.08)",
+          "offsetX": "0px",
+          "offsetY": "12px",
+          "blur": "32px",
+          "spread": "0px"
+        },
+        {
+          "color": "rgba(15,23,42,0.04)",
+          "offsetX": "0px",
+          "offsetY": "4px",
+          "blur": "8px",
+          "spread": "0px"
+        }
+      ],
+      "$description": "Modals, popovers.",
+      "$extensions": {
+        "app.cupped": {
+          "androidElevation": 8
+        }
+      }
+    },
+    "primary": {
+      "$value": [
+        {
+          "color": "rgba(224,122,95,0.28)",
+          "offsetX": "0px",
+          "offsetY": "12px",
+          "blur": "28px",
+          "spread": "0px"
+        },
+        {
+          "color": "rgba(224,122,95,0.18)",
+          "offsetX": "0px",
+          "offsetY": "4px",
+          "blur": "10px",
+          "spread": "0px"
+        }
+      ],
+      "$description": "Coral-tinted glow reserved for the FAB and hero actions — ties physicality to action.",
+      "$extensions": {
+        "app.cupped": {
+          "androidElevation": 8,
+          "androidShadowColor": "#E07A5F"
+        }
+      }
+    }
+  },
+  "material": {
+    "$description": "Translucency is used sparingly and only on chrome that floats over content (tab bar, sticky headers). Content surfaces are always opaque; one chrome layer per screen. prefers-reduced-transparency collapses chrome to opaque card.",
+    "chrome": {
+      "bg": {
+        "$type": "color",
+        "$value": "rgba(255, 255, 255, 0.95)",
+        "$description": "Chrome material — 95% card. The CSS target composes it live via color-mix; other targets get the pre-mixed value.",
+        "$extensions": {
+          "app.cupped": {
+            "cssValue": "color-mix(in srgb, var(--card) 95%, transparent)",
+            "reducedTransparency": "var(--card)",
+            "recipe": {
+              "base": "{color.surface.card}",
+              "opacity": 0.95
+            }
+          }
+        }
+      },
+      "blur": {
+        "$value": "saturate(1.4) blur(20px)",
+        "$description": "backdrop-filter for the chrome material. Native consumers use the numeric ingredients with expo-blur; the opaque card fallback is the default and iOS should prefer native materials.",
+        "$extensions": {
+          "app.cupped": {
+            "reducedTransparency": "none",
+            "recipe": {
+              "blurPx": 20,
+              "saturate": 1.4
+            }
+          }
+        }
+      }
+    },
+    "scrim": {
+      "$type": "color",
+      "$value": "rgba(15, 23, 42, 0.45)",
+      "$description": "Overlay scrim for sheets — 45% ink.",
+      "$extensions": {
+        "app.cupped": {
+          "cssName": "scrim",
+          "recipe": {
+            "base": "{color.ink.default}",
+            "opacity": 0.45
+          }
+        }
+      }
+    }
+  },
+  "spring": {
+    "$description": "Springy but settled — one shared spring for tab selection, sheet presents, press feedback. Apple-style response/damping; the native pipeline derives Reanimated physics params.",
+    "response": {
+      "$type": "duration",
+      "$value": "{duration.spring}",
+      "$extensions": {
+        "app.cupped": {
+          "reducedMotion": "var(--motion-reduced)"
+        }
+      }
+    },
+    "damping": {
+      "$type": "number",
+      "$value": 0.75
+    }
+  },
+  "tap": {
+    "$description": "Press feedback — a brief pulse.",
+    "scale": {
+      "$type": "number",
+      "$value": 0.95
+    },
+    "opacity": {
+      "$type": "number",
+      "$value": 0.8
+    }
+  },
+  "stagger": {
+    "delay": {
+      "$type": "duration",
+      "$value": "{duration.stagger}",
+      "$description": "Stagger siblings by this much.",
+      "$extensions": {
+        "app.cupped": {
+          "reducedMotion": "0s"
+        }
+      }
+    }
+  },
+  "shimmer": {
+    "duration": {
+      "$type": "duration",
+      "$value": "{duration.shimmer}",
+      "$description": "Skeleton shimmer cycle."
+    }
+  },
+  "motion": {
+    "reduced": {
+      "$type": "duration",
+      "$value": "{duration.reduced}",
+      "$description": "Reduced motion collapses springs/staggers to crossfades of this length — keep the state change, drop the travel."
+    }
+  },
+  "focus": {
+    "ring": {
+      "$type": "shadow",
+      "$value": [
+        {
+          "color": "{color.surface.card}",
+          "offsetX": "0px",
+          "offsetY": "0px",
+          "blur": "0px",
+          "spread": "2px"
+        },
+        {
+          "color": "{color.primary.strong}",
+          "offsetX": "0px",
+          "offsetY": "0px",
+          "blur": "0px",
+          "spread": "4px"
+        }
+      ],
+      "$description": "Opaque dual focus ring (refreshed export) — ≥3:1 non-text contrast on any surface. Outline is never removed without a replacement.",
+      "$extensions": {
+        "app.cupped": {
+          "innerWidthPx": 2,
+          "outerWidthPx": 2
+        }
+      }
+    }
+  },
+  "hit-target": {
+    "min": {
+      "$type": "dimension",
+      "$value": "{dimension.scale.44}",
+      "$description": "Minimum touch target, pt — always."
+    }
+  },
+  "radius": {
+    "$type": "dimension",
+    "$description": "Radii render as continuous (squircle) curves on iOS.",
+    "sm": {
+      "$value": "{dimension.scale.8}",
+      "$description": "Small chips."
+    },
+    "md": {
+      "$value": "{dimension.scale.12}",
+      "$description": "Buttons, inputs."
+    },
+    "lg": {
+      "$value": "{dimension.scale.16}",
+      "$description": "Cards."
+    },
+    "xl": {
+      "$value": "{dimension.scale.24}",
+      "$description": "Sheets, hero containers."
+    },
+    "full": {
+      "$value": "{dimension.scale.full}",
+      "$description": "Pills, avatars, FAB."
+    }
+  },
+  "space": {
+    "$type": "dimension",
+    "$description": "Strict 4pt grid with seven named stops — the only spacing values. Section-level layout composes multiples of xxl.",
+    "xs": {
+      "$value": "{dimension.scale.4}",
+      "$description": "Icon gaps, tag gaps."
+    },
+    "sm": {
+      "$value": "{dimension.scale.8}",
+      "$description": "Within-cluster gaps."
+    },
+    "md": {
+      "$value": "{dimension.scale.12}",
+      "$description": "Row padding, label gaps."
+    },
+    "base": {
+      "$value": "{dimension.scale.16}",
+      "$description": "Default gaps, card padding."
+    },
+    "lg": {
+      "$value": "{dimension.scale.20}",
+      "$description": "Content insets."
+    },
+    "xl": {
+      "$value": "{dimension.scale.24}",
+      "$description": "Between component groups."
+    },
+    "xxl": {
+      "$value": "{dimension.scale.32}",
+      "$description": "Between sections."
+    }
+  },
+  "ff": {
+    "$type": "fontFamily",
+    "sans": {
+      "$value": "{font.family.sans}",
+      "$description": "Inter — all UI.",
+      "$extensions": {
+        "app.cupped": {
+          "cssValue": "'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif"
+        }
+      }
+    },
+    "serif": {
+      "$value": "{font.family.serif}",
+      "$description": "Instrument Serif — display, one moment per screen.",
+      "$extensions": {
+        "app.cupped": {
+          "cssValue": "'Instrument Serif', Georgia, serif"
+        }
+      }
+    },
+    "mono": {
+      "$value": "{font.family.mono}",
+      "$description": "JetBrains Mono — technical detail (ratios, temps, grind).",
+      "$extensions": {
+        "app.cupped": {
+          "cssValue": "'JetBrains Mono', ui-monospace, SFMono-Regular, monospace"
+        }
+      }
+    }
+  },
+  "text": {
+    "$type": "dimension",
+    "$description": "Platform size scale. Weights and line-heights live on the matching type.* composite tokens.",
+    "screen-title": {
+      "$value": "{font.size.32}",
+      "$description": "Inter 700 · 1.1 · screen titles"
+    },
+    "sheet-title": {
+      "$value": "{font.size.24}",
+      "$description": "Inter 600 · 1.2 · sheet/modal titles"
+    },
+    "card-title": {
+      "$value": "{font.size.20}",
+      "$description": "Inter 600 · 1.25 · card titles (feed coffee name)"
+    },
+    "body": {
+      "$value": "{font.size.16}",
+      "$description": "Inter 400 · 1.5 · body"
+    },
+    "body-sm": {
+      "$value": "{font.size.14}",
+      "$description": "Inter 400 · 1.45 · secondary rows, metadata"
+    },
+    "caption": {
+      "$value": "{font.size.12}",
+      "$description": "Inter 500 · 1.4 · labels, timestamps"
+    }
+  },
+  "type": {
+    "$type": "typography",
+    "$description": "Composite text styles — the per-size weights and line-heights promoted from spec prose to first-class tokens. Emitted to native/JSON targets; the CSS target keeps the original flat --text-* size variables.",
+    "screen-title": {
+      "$value": {
+        "fontFamily": "{font.family.sans}",
+        "fontSize": "{text.screen-title}",
+        "fontWeight": "{font.weight.bold}",
+        "lineHeight": 1.1
+      }
+    },
+    "sheet-title": {
+      "$value": {
+        "fontFamily": "{font.family.sans}",
+        "fontSize": "{text.sheet-title}",
+        "fontWeight": "{font.weight.semibold}",
+        "lineHeight": 1.2
+      }
+    },
+    "card-title": {
+      "$value": {
+        "fontFamily": "{font.family.sans}",
+        "fontSize": "{text.card-title}",
+        "fontWeight": "{font.weight.semibold}",
+        "lineHeight": 1.25
+      }
+    },
+    "body": {
+      "$value": {
+        "fontFamily": "{font.family.sans}",
+        "fontSize": "{text.body}",
+        "fontWeight": "{font.weight.regular}",
+        "lineHeight": 1.5
+      }
+    },
+    "body-sm": {
+      "$value": {
+        "fontFamily": "{font.family.sans}",
+        "fontSize": "{text.body-sm}",
+        "fontWeight": "{font.weight.regular}",
+        "lineHeight": 1.45
+      }
+    },
+    "caption": {
+      "$value": {
+        "fontFamily": "{font.family.sans}",
+        "fontSize": "{text.caption}",
+        "fontWeight": "{font.weight.medium}",
+        "lineHeight": 1.4
+      }
+    },
+    "display": {
+      "$value": {
+        "fontFamily": "{font.family.serif}",
+        "fontSize": "{font.size.56}",
+        "fontWeight": "{font.weight.regular}",
+        "lineHeight": 1,
+        "letterSpacing": "-0.015em"
+      },
+      "$description": "Instrument Serif display — hero moments only, max one per screen, tracking −1.5%. Promoted from spec prose."
+    },
+    "mono": {
+      "$value": {
+        "fontFamily": "{font.family.mono}",
+        "fontSize": "{font.size.12}",
+        "fontWeight": "{font.weight.medium}",
+        "lineHeight": 1.4
+      },
+      "$description": "Technical register — ratios, temps, grind, extraction (11–13px range; 12 is the default). Promoted from spec prose."
+    }
+  }
+}