mcp-marmiton 1.5.0 → 1.7.0

package/README.md

@@ -81,9 +81,36 @@ landed somewhere the arithmetic did not put it, a half egg taken to a whole one
 or 133.4 g written as 135 g.
 
 Two rules are enforced. Scaling a recipe **down never asks for more** than the
-original: half a sachet at factor 0.667 becomes a third of a sachet, never a whole
-one. And scaling never **silently drops** an ingredient by rounding it to zero,
-which is why small amounts come back as fractions.
+original: half a sachet at factor 0.667 stays half a sachet, never a whole one.
+And scaling never **silently drops** an ingredient by rounding it to zero, which
+is why small amounts come back as fractions.
+
+**A counted thing is divided by what it holds, not by what holds it.** A boîte de
+tomates is poured and the rest kept, a sachet de sucre vanillé is split by eye, a
+feuille de gélatine is cut with scissors, a branche de thym is broken in two: all
+of those land on a half. Half an oeuf would have to be
+beaten and weighed, which is not an amount a recipe asks for, so a count of oeufs,
+jaunes or blancs d'oeufs lands on a whole number. A few things are decided by what
+they are: a clou de girofle and a zeste are counted whole, a pot and a bouteille
+hold enough for a quarter to be a portion, a tranche is cut off
+something larger and the board takes a corner off it in the same gesture, a
+gousse d'ail is split in two and no finer, a blanc de poulet is
+meat and halves, and a douzaine states a number of things rather than a measure
+of them, so `2 douzaines d'escargots` at three quarters comes back as
+`18 escargots`.
+
+**A thing counted on its own is divided by the size of one against what a recipe
+puts in.** Une crevette, une moule, une noisette, un grain de poivre, une baie de
+genièvre, un anis étoilé is already a portion: a recipe counts twelve of them
+and a smaller recipe puts one fewer in the pan, so they land on a whole number.
+Un gigot, une baguette, un camembert, un ananas, un oignon, une pastèque, une
+pintade, un poulet, un poireau sits at
+the other end of that comparison, asked for by the one or the two and shared out
+with a knife, so they go as far as the quarter. A cut carved off one of them
+stops at the half, une cuisse and une aile being the portion the knife already
+produced. Un jus stops at the half: half
+the jus of a citron is taken by squeezing half the fruit, and a quarter of one
+has to be poured out and measured back.
 
 Approximate measures are quantities too. A pinch, a handful, a bouchon or a
 ramequin has the size the cook gives it, and the recipe's proportion lives in how
@@ -94,7 +121,8 @@ converted into grams or spoons, where published equivalences span a fourfold
 range; an order of magnitude belongs in a note, never in the quantity.
 
 Ranges are read as one quantity: "2 à 3 gousses" doubled reads "4 à 6 gousses",
-and `amount` reports the upper bound, since that is what a cook buys.
+with `amount` holding the lower bound and `amountMax` the upper one. Where both
+ends land on the same amount, the line states that amount once and says so.
 
 A line that writes an article where a digit would go is read as one of the
 measure that follows it: `un bouchon de rhum` scaled sixfold is
@@ -107,8 +135,10 @@ the line as published.
 Each ingredient also carries `adjusted`, which says whether rounding moved the
 number away from the exact product.
 
-Below a quarter there is nothing a kitchen can measure, so the amount is clamped
-up and **the line stops holding its share of the recipe**. Half a sachet of
+A shrinking line keeps the smallest share still worth measuring: a knife takes an
+oignon to a quarter, a boîte or a sachet goes to a half, an oeuf stops at one.
+Under that floor the amount is clamped up and **the line stops holding its share
+of the recipe**. Half a sachet of
 baking powder against three pots of flour comes out four times too strong that
 way, so the ingredient and the response both say it happened rather than leaving
 you to find out in the oven.
@@ -293,10 +323,25 @@ ailleurs que là où le calcul la mettait, un demi-œuf ramené à un œuf entie
 133,4 g écrits 135 g.
 
 Deux règles sont garanties. Réduire une recette **ne demande jamais davantage** que
-l'originale : un demi-sachet au facteur 0,667 devient un tiers de sachet, jamais un
+l'originale : un demi-sachet au facteur 0,667 reste un demi-sachet, jamais un
 sachet entier. Et l'adaptation ne **supprime jamais** un ingrédient en l'arrondissant
 à zéro, d'où les fractions pour les petites quantités.
 
+**Un dénombrable se divise selon son contenu, pas selon son emballage.** Une boîte
+de tomates se verse et le reste se garde, un sachet de sucre vanillé se partage à
+l'œil, une feuille de gélatine se coupe aux ciseaux, une branche de thym se casse
+en deux : tous tombent sur une demie. Un demi-œuf, lui,
+demanderait de le battre et de le peser, ce qu'aucune recette ne demande : un
+nombre d'œufs, de jaunes ou de blancs d'œufs tombe sur un entier. Quelques cas se
+décident sur la nature de la chose : un clou de girofle et un zeste se comptent
+entiers, un pot et une bouteille en contiennent assez pour qu'un quart soit une
+portion, une tranche est déjà taillée dans plus grand et la planche lui reprend
+un coin du même geste, une gousse d'ail se coupe en deux et pas plus fin, un
+blanc de poulet est une viande et
+se coupe en deux, et une douzaine
+énonce un nombre de choses plutôt qu'une mesure, si bien que
+« 2 douzaines d'escargots » réduites d'un quart reviennent en « 18 escargots ».
+
 Les mesures approximatives sont des quantités elles aussi. Une pincée, une
 poignée, un bouchon ou un ramequin ont la taille que le cuisinier leur donne,
 et la proportion de la recette tient au nombre demandé : ce nombre est donc
@@ -307,8 +352,9 @@ note. Aucune conversion en grammes ni en cuillères : les
 sa place dans une note, jamais dans la quantité.
 
 Les fourchettes sont lues comme une seule quantité : « 2 à 3 gousses » doublé
-donne « 4 à 6 gousses », et `amount` renvoie la borne haute, celle que l'on
-achète.
+donne « 4 à 6 gousses », `amount` portant la borne basse et `amountMax` la borne
+haute. Quand les deux bornes tombent sur la même valeur, la ligne énonce cette
+valeur une fois et le signale.
 
 Une ligne qui écrit un article là où irait un chiffre est lue comme une unité de
 la mesure qui suit : « un bouchon de rhum » multiplié par six donne « 6 bouchons
@@ -321,8 +367,10 @@ publiée.
 Chaque ingrédient porte aussi `adjusted`, qui dit si l'arrondi a déplacé le
 nombre par rapport au produit exact.
 
-Sous un quart, il n'y a plus rien qu'une cuisine puisse mesurer : la quantité est
-alors remontée et **la ligne cesse de tenir sa part de la recette**. Un demi-sachet
+Une ligne qui rétrécit garde la plus petite part qui vaille encore la peine : le
+couteau mène un oignon au quart, une boîte ou un sachet s'arrêtent à la demie, un
+œuf s'arrête à l'unité. Sous ce plancher, la quantité est remontée et **la ligne
+cesse de tenir sa part de la recette**. Un demi-sachet
 de levure face à trois pots de farine ressort ainsi quatre fois trop dosé, donc
 l'ingrédient et la réponse le disent, plutôt que de vous le laisser découvrir au
 four.