Weigh your recipes. cupful converts US cup, tablespoon, teaspoon and millilitre measures of common ingredients into grams, so a recipe written in Typst can print both.

#import "@preview/cupful:0.1.0": *

#ingredient(1, "cup", "all-purpose-flour")   // 1 cup all purpose flour (120 g)
#ingredient(2, "tbsp", "granulated-sugar")    // 2 tbsp granulated sugar (25 g)

#recipe-table(
  ((1.5, "cup", "all-purpose-flour"), (0.75, "cup", "brown-sugar"), (0.5, "cup", "butter")),
  factor: 2,  // double the recipe
)

Functions

• grams(amount, unit, ingredient, extra: (:)) returns a float. Units are cup, tbsp (1/16 cup), tsp (1/48 cup) and ml.
• ingredient(amount, unit, name, label: none, extra: (:)) returns content like 1 cup all purpose flour (120 g).
• recipe-table(items, factor: 1, extra: (:)) builds an ingredient/grams table, optionally scaled.
• kitchen-round(g) rounds to whole grams from 10 g up and to 0.5 g below that.
• densities is the built-in dictionary of grams per US cup. Add your own with extra: ("almond-flour": 96.0).

Where the numbers come from

One US customary cup is 236.588 ml, and water is 236.588 g per cup. Every other density is a packing convention: flour is spooned and levelled, brown sugar is packed, and so on. These are not physical constants. A dipped-and-packed cup of flour holds noticeably more than 120 g. The table is the same set of conventions used by the Ingredient Calculator cups-to-grams converter, which covers more ingredients and explains why a cup of flour can weigh different amounts.

MIT licensed.