{
  "version": 1,
  "updated": "2026-11-09",
  "rules": {
    "plot": "typicalMg unless the user moves the range control",
    "cafeDrinks": "caffeine follows shot count, not cup volume",
    "milk": "milk nutrition is in data/milks.json (per 100 ml, USDA). Milk changes calories, not caffeine. Do not invent milk macros.",
    "coldBrew": "range only, no typical value: the range comes from 11 published lab studies (see the cold-brew note and source), and recipes vary too much for one typical. The range is wide on purpose.",
    "brandCans": "lock the can the maker publishes. Do not rescale macros onto a different can.",
    "sessions": "yerba mate and tereré default to a gourd session, not a 200 ml cup"
  },
  "drinks": [
    {
      "id": "filter-coffee",
      "name": "Filter coffee",
      "family": "coffee",
      "kind": "cup",
      "servingMl": 200,
      "servingLabel": "200 ml",
      "caffeineMg": {
        "typical": 80,
        "low": 60,
        "high": 88,
        "confidence": "measured"
      },
      "energyKcal": 2,
      "macros": {
        "proteinG": 0.24,
        "carbG": 0,
        "sugarG": 0,
        "fatG": 0.04
      },
      "sourceIds": [
        "usda-171890"
      ],
      "note": "USDA brewed coffee, 40 mg/100 g, analytical range 30–44. Scaled to 200 ml at ~1 g/ml."
    },
    {
      "id": "espresso",
      "name": "Espresso",
      "family": "coffee",
      "kind": "shot",
      "shots": 1,
      "servingMl": 30,
      "servingLabel": "1 shot, 30 ml",
      "caffeineMg": {
        "typical": 63.6,
        "low": null,
        "high": null,
        "confidence": "measured-narrow"
      },
      "energyKcal": 2.7,
      "macros": {
        "proteinG": 0.04,
        "carbG": 0.5,
        "sugarG": 0,
        "fatG": 0.054
      },
      "sourceIds": [
        "usda-171891"
      ],
      "note": "USDA restaurant espresso, 212 mg and 9 kcal per 100 g. Only 2 analytical points, so no honest range."
    },
    {
      "id": "double-espresso",
      "name": "Double espresso",
      "family": "coffee",
      "kind": "shot",
      "shots": 2,
      "servingMl": 60,
      "servingLabel": "2 shots, 60 ml",
      "caffeineMg": {
        "typical": 127.2,
        "low": null,
        "high": null,
        "confidence": "scaled"
      },
      "energyKcal": 5.4,
      "macros": {
        "proteinG": 0.07,
        "carbG": 1,
        "sugarG": 0,
        "fatG": 0.108
      },
      "sourceIds": [
        "usda-171891"
      ],
      "note": "Two USDA shots. Starbucks doppio is a different object: 150 mg in 1.6 fl oz."
    },
    {
      "id": "americano",
      "name": "Americano",
      "family": "coffee",
      "kind": "shots-plus-water",
      "shots": 2,
      "servingMl": 200,
      "servingLabel": "2 shots, water to 200 ml",
      "caffeineMg": {
        "typical": 127.2,
        "low": null,
        "high": null,
        "confidence": "scaled"
      },
      "energyKcal": 5.4,
      "macros": {
        "proteinG": 0.07,
        "carbG": 1,
        "sugarG": 0,
        "fatG": 0.108
      },
      "sourceIds": [
        "usda-171891"
      ],
      "note": "Water does not add caffeine. A Starbucks Grande Americano is 225 mg / 15 kcal / 16 fl oz, three of their shots, not this cup."
    },
    {
      "id": "cappuccino",
      "name": "Cappuccino",
      "family": "coffee",
      "kind": "shots-plus-milk",
      "shots": 1,
      "milkMl": 150,
      "servingMl": 180,
      "servingLabel": "1 shot + milk, about 180 ml",
      "caffeineMg": {
        "typical": 63.6,
        "low": null,
        "high": null,
        "confidence": "scaled"
      },
      "energyKcal": null,
      "macros": null,
      "sourceIds": [
        "usda-171891"
      ],
      "note": "Caffeine is the shot. Calories wait on a chosen milk. Starbucks Grande cappuccino is 2 shots, 150 mg, 140 kcal, 5 g fat, 14 g carb, 12 g sugar, 9 g protein."
    },
    {
      "id": "caffe-latte",
      "name": "Caffe latte",
      "family": "coffee",
      "kind": "shots-plus-milk",
      "shots": 2,
      "milkMl": 180,
      "servingMl": 240,
      "servingLabel": "2 shots + milk, about 240 ml",
      "caffeineMg": {
        "typical": 127.2,
        "low": null,
        "high": null,
        "confidence": "scaled"
      },
      "energyKcal": null,
      "macros": null,
      "sourceIds": [
        "usda-171891"
      ],
      "note": "Caffeine is the shots. Starbucks Grande latte is 150 mg, 190 kcal, 7 g fat, 19 g carb, 18 g sugar, 13 g protein on their standard milk recipe."
    },
    {
      "id": "cold-brew",
      "name": "Cold brew",
      "family": "coffee",
      "kind": "cup",
      "servingMl": 200,
      "servingLabel": "200 ml",
      "caffeineMg": {
        "typical": null,
        "low": 96,
        "high": 360.2,
        "confidence": "range-only"
      },
      "energyKcal": null,
      "macros": null,
      "sourceIds": [
        "mystkowska-2024"
      ],
      "note": "No USDA cold-brew row. Range only, from a peer-reviewed review (11 cold-brew lab studies, mostly HPLC): cold brew ran 48.00-180.10 mg per 100 mL. Low and high are those ends scaled to 200 ml. No single typical value is given because recipes run from 5:100 to 20:100 coffee to water, including concentrates."
    },
    {
      "id": "decaf-coffee",
      "name": "Decaf coffee",
      "family": "coffee",
      "kind": "cup",
      "servingMl": 200,
      "servingLabel": "200 ml",
      "caffeineMg": {
        "typical": null,
        "low": 1.7,
        "high": 12.7,
        "confidence": "range-only"
      },
      "energyKcal": null,
      "macros": null,
      "sourceIds": [
        "fda-caffeine"
      ],
      "note": "FDA: decaf typically 2–15 mg per 8 fl oz. Scaled to 200 ml. Not caffeine-free. No single typical."
    },
    {
      "id": "green-tea",
      "name": "Green tea",
      "family": "tea",
      "kind": "cup",
      "servingMl": 200,
      "servingLabel": "200 ml",
      "caffeineMg": {
        "typical": 24,
        "low": 16,
        "high": 36,
        "confidence": "measured"
      },
      "energyKcal": 2,
      "macros": {
        "proteinG": 0.44,
        "carbG": 0,
        "sugarG": 0,
        "fatG": 0
      },
      "sourceIds": [
        "usda-171917",
        "fda-caffeine"
      ],
      "note": "USDA green tea, 12 mg/100 g, analytical range 8–18. FDA's separate 12 fl oz figure is 37 mg."
    },
    {
      "id": "black-tea",
      "name": "Black tea",
      "family": "tea",
      "kind": "cup",
      "servingMl": 200,
      "servingLabel": "200 ml",
      "caffeineMg": {
        "typical": 40,
        "low": null,
        "high": null,
        "confidence": "measured"
      },
      "energyKcal": 2,
      "macros": {
        "proteinG": 0,
        "carbG": 0.6,
        "sugarG": 0,
        "fatG": 0
      },
      "sourceIds": [
        "usda-173227",
        "fda-caffeine"
      ],
      "note": "USDA black tea, 20 mg/100 g. Matches FDA's 71 mg per 12 fl oz. Brew time moves this; USDA row has no min/max."
    },
    {
      "id": "yerba-mate",
      "name": "Yerba mate",
      "family": "mate",
      "kind": "session",
      "servingMl": 350,
      "servingLabel": "1 gourd, 350 ml",
      "caffeineMg": {
        "typical": 91,
        "low": 49,
        "high": 182,
        "confidence": "compiled"
      },
      "energyKcal": null,
      "macros": null,
      "sourceIds": [
        "bracafft"
      ],
      "note": "BraCaffT chimarrão: 26 mg/100 ml (14–52), 91 mg per 350 ml gourd. A real session is repeated pours, not one cup. Argentine HPLC work found 243–273 mg extracted across 15 servings."
    },
    {
      "id": "terere",
      "name": "Tereré",
      "family": "mate",
      "kind": "session",
      "servingMl": 350,
      "servingLabel": "1 gourd, 350 ml",
      "caffeineMg": {
        "typical": 84,
        "low": 60,
        "high": 126,
        "confidence": "compiled"
      },
      "energyKcal": null,
      "macros": null,
      "sourceIds": [
        "bracafft"
      ],
      "note": "BraCaffT tereré: 24 mg/100 ml (17–36), 84 mg per 350 ml gourd. Cold water still extracts caffeine. Do not model this as a 200 ml cup."
    },
    {
      "id": "red-bull",
      "name": "Red Bull",
      "family": "energy",
      "kind": "can",
      "servingMl": 250,
      "servingLabel": "8.4 fl oz / 250 ml can",
      "caffeineMg": {
        "typical": 80,
        "low": 80,
        "high": 80,
        "confidence": "label"
      },
      "energyKcal": 110,
      "macros": {
        "proteinG": 0,
        "carbG": 29,
        "sugarG": 26,
        "fatG": 0
      },
      "sourceIds": [
        "redbull-caffeine",
        "redbull-ingredients"
      ],
      "note": "Maker also publishes 114 mg / 12 fl oz, 151 mg / 16 fl oz, 198 mg / 20 fl oz. Macros below are locked only for the 8.4 fl oz can."
    },
    {
      "id": "monster-energy",
      "name": "Monster Energy",
      "family": "energy",
      "kind": "can",
      "servingMl": 473,
      "servingLabel": "16 fl oz can",
      "caffeineMg": {
        "typical": 160,
        "low": 160,
        "high": 160,
        "confidence": "label"
      },
      "energyKcal": 230,
      "macros": null,
      "sourceIds": [
        "monster-og"
      ],
      "note": "US Original Green, caffeine and calories stated for 16 fl oz. The maker page states no fat, carbohydrate, sugar or protein, so macros stay null. A 500 ml can is a different market object and is not locked."
    },
    {
      "id": "coca-cola",
      "name": "Coca-Cola",
      "family": "cola",
      "kind": "can",
      "servingMl": 355,
      "servingLabel": "12 fl oz can",
      "caffeineMg": {
        "typical": 34,
        "low": 34,
        "high": 34,
        "confidence": "label"
      },
      "energyKcal": 140,
      "macros": {
        "proteinG": 0,
        "carbG": 39,
        "sugarG": 39,
        "fatG": 0
      },
      "sourceIds": [
        "coke-faq",
        "coke-smartlabel"
      ],
      "note": "US 12 fl oz. Diet Coke is a different drink at 46 mg. Do not merge it with Coke or Coke Zero."
    },
    {
      "id": "coca-cola-zero",
      "name": "Coca-Cola Zero Sugar",
      "family": "cola",
      "kind": "can",
      "servingMl": 355,
      "servingLabel": "12 fl oz can",
      "caffeineMg": {
        "typical": 34,
        "low": 34,
        "high": 34,
        "confidence": "label"
      },
      "energyKcal": 0,
      "macros": {
        "proteinG": 0,
        "carbG": 0,
        "sugarG": 0,
        "fatG": 0
      },
      "sourceIds": [
        "coke-zero"
      ],
      "note": "Official product page: 34 mg and zero sugar, zero calories per 12 fl oz serving. Its source is confirmed for the figures it states."
    },
    {
      "id": "pepsi",
      "name": "Pepsi",
      "family": "cola",
      "kind": "can",
      "servingMl": 355,
      "servingLabel": "12 fl oz can",
      "caffeineMg": {
        "typical": 38,
        "low": 38,
        "high": 38,
        "confidence": "label"
      },
      "energyKcal": 150,
      "macros": {
        "proteinG": 0,
        "carbG": 41,
        "sugarG": 41,
        "fatG": 0
      },
      "sourceIds": [
        "pepsi-12"
      ],
      "note": "PepsiCo Product Facts: 38 mg caffeine and 150 calories per 12 fl oz can; label shows 0 g fat, 41 g carbohydrate, 41 g sugars (all added), 0 g protein."
    },
    {
      "id": "pepsi-zero",
      "name": "Pepsi Zero Sugar",
      "family": "cola",
      "kind": "can",
      "servingMl": 355,
      "servingLabel": "12 fl oz can, US",
      "caffeineMg": {
        "typical": 38,
        "low": 38,
        "high": 38,
        "confidence": "label"
      },
      "energyKcal": 0,
      "macros": {
        "proteinG": 0,
        "carbG": 0,
        "sugarG": 0,
        "fatG": 0
      },
      "sourceIds": [
        "pepsi-zero-12"
      ],
      "note": "US formula as fetched: 38 mg caffeine, same as regular Pepsi; label shows 0 calories, 0 g fat, 0 g carbohydrate, 0 g sugars, 0 g protein per 12 fl oz can. Older US cans and some Pepsi Black / Pepsi Max markets are not this number."
    }
  ]
}