basket:
  slug: essentials-us
  name: Essentials Basket USA
  marketCode: us
  methodology: fixed
  baseDate: "2025-01-01"
  description: >
    Core household essentials tracked weekly across US grocery retailers.
    Weighted to reflect a typical household of 4 in the United States.
    Does not represent official CPI. Tracks consumer price pressure only.

  items:
    - id: eggs_12
      category: eggs
      canonicalName: Eggs Fresh 12 Pack
      weight: 0.12
      baseUnit: ct
      substitutionGroup: eggs
      minBaseQty: 10
      maxBaseQty: 15

    - id: milk_1l
      category: dairy
      canonicalName: Whole Milk 1 Gallon
      weight: 0.10
      baseUnit: ml
      substitutionGroup: milk_full_fat
      minBaseQty: 3500
      maxBaseQty: 4000

    - id: bread_white
      category: bread
      canonicalName: White Sandwich Bread Loaf
      weight: 0.08
      baseUnit: g
      substitutionGroup: bread_white
      minBaseQty: 500
      maxBaseQty: 700

    - id: rice_1kg
      category: rice
      canonicalName: Long Grain White Rice 2lb
      weight: 0.08
      baseUnit: g
      substitutionGroup: rice_white
      minBaseQty: 800
      maxBaseQty: 1100

    - id: cooking_oil_vegetable_1l
      category: cooking_oil
      canonicalName: Vegetable Oil 48oz
      weight: 0.07
      baseUnit: ml
      substitutionGroup: cooking_oil_vegetable
      minBaseQty: 1200
      maxBaseQty: 1600

    - id: chicken_whole_1kg
      category: chicken
      canonicalName: Whole Chicken Fresh
      weight: 0.12
      baseUnit: g
      substitutionGroup: chicken_whole
      minBaseQty: 1200
      maxBaseQty: 2000

    - id: tomatoes_1kg
      category: tomatoes
      canonicalName: Tomatoes Fresh
      weight: 0.08
      baseUnit: g
      substitutionGroup: tomatoes
      minBaseQty: 800
      maxBaseQty: 1200
      negativeTokens: ["chopped", "peeled", "sauce", "paste", "canned", "puree", "sundried"]

    - id: onions_1kg
      category: onions
      canonicalName: Yellow Onions 3lb
      weight: 0.06
      baseUnit: g
      substitutionGroup: onions
      minBaseQty: 1000
      maxBaseQty: 1600
      negativeTokens: ["powder", "flakes", "rings", "pickled", "seeds", "sets"]

    - id: water_1_5l
      category: water
      canonicalName: Drinking Water 24 Pack 16oz
      weight: 0.07
      baseUnit: ml
      substitutionGroup: water_still
      minBaseQty: 6000
      maxBaseQty: 10000
      negativeTokens: ["sparkling", "flavored", "flavoured"]

    - id: sugar_1kg
      category: sugar
      canonicalName: Granulated White Sugar 4lb
      weight: 0.06
      baseUnit: g
      substitutionGroup: sugar_white
      minBaseQty: 1600
      maxBaseQty: 2000
      negativeTokens: ["brown", "baby", "mascavo", "sachets", "powdered"]

    - id: cheese_cheddar_200g
      category: dairy
      canonicalName: Cheddar Cheese Slices 8oz
      weight: 0.08
      baseUnit: g
      substitutionGroup: cheese_cheddar
      minBaseQty: 200
      maxBaseQty: 280

    - id: yogurt_500g
      category: dairy
      canonicalName: Plain Yogurt 32oz
      weight: 0.08
      baseUnit: g
      substitutionGroup: yogurt_plain
      minBaseQty: 800
      maxBaseQty: 1000
      negativeTokens: ["drink", "drinking", "plant-based", "vegan", "greek", "fruit"]
