@recipe-book/core 0.1.1 → 0.1.2

package/dist/steps/temperature.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/steps/temperature.ts"],"sourcesContent":["import type { Temperature, TemperatureUnit } from '../units/temperature'\nimport type { TemperatureReading } from './segment'\n\ntype TemperatureMatch = {\n  start: number\n  end: number\n  reading: TemperatureReading\n  alternatives: TemperatureReading[]\n}\n\ntype Reading = {\n  value: number\n  unit: TemperatureUnit | undefined\n  fan: boolean\n  /** True when it counts only after a word such as \"at\", as \"350°\" and \"180 C\" do. */\n  cued: boolean\n  end: number\n}\n\n/**\n * The readings in a run, first included, and whether a gas mark was among\n * them. Readings for the same kind of oven are one setting written in both\n * units, so \"350°F or 375°F\" and \"350°F or 200°C\" are separate settings.\n * `clash` is set when a reading was turned away for that reason.\n */\ntype Run = { readings: TemperatureReading[]; gas: boolean; clash?: boolean }\n\n// Every quantifier is bounded, lookbehind reads at most LOOKBACK characters,\n// and a run holds at most MAX_ITEMS items, so each call does constant work and\n// a scan stays linear in the text length.\nconst LOOKBACK = 24\nconst MAX_ITEMS = 6\n\n// The lookahead never changes a reading, since no scale starts with a digit,\n// \".\" or \",\". It's there for speed: it turns a longer number away before\n// DEGREES and SCALE are tried.\nconst NUMBER = /(\\d{1,4})(\\.\\d{1,2})?(?![.,]?\\d)/y\n// Every word boundary in this file except LETTER, below, treats a Latin or\n// Cyrillic letter, a combining mark, a digit, or \"_\" as continuing a word,\n// since those scripts write the units and separate words with spaces:\n// \"200 fèves\" isn't 200 °F. Chinese, Japanese, and Korean attach words and\n// particles straight to a number or unit, as in \"45°C/113°F的温水\" and\n// \"180°C에서\", so their letters end a word. So do Greek letters, since Greek\n// writes the unit in its own letters: \"180°Cγια\" is missing a space. So does\n// U+0345, a combining mark that only sits on a Greek vowel. Under \"/iu\" the\n// Greek iotas fold onto it and match \"\\p{M}\", so each of these boundaries\n// lets \"ι\" end a word explicitly. \"º\" and \"ª\" end a unit letter too, as in\n// \"180Cº\". The unit may be a Cyrillic \"С\", as in \"180 °С\".\nconst DEGREES =\n  /(?:-|\\s{0,3})(?:([℃℉])|(?:[°º˚]|degrees?(?!(?!ι)[\\p{sc=Latin}\\p{sc=Cyrillic}\\p{M}\\d_]))(?:\\s{0,3}(?:(cel[cs]ius|centigrade|fahrenheit|[cfс])(?!(?![ºªι])[\\p{sc=Latin}\\p{sc=Cyrillic}\\p{M}\\d_])|\\(([cf])\\)))?)/iuy\nconst SCALE =\n  /(\\s{0,3})(cel[cs]ius|centigrade|fahrenheit|[cf])(?!(?![ºªι])[\\p{sc=Latin}\\p{sc=Cyrillic}\\p{M}\\d_])(?:°|\\s{1,3}degrees?(?!(?!ι)[\\p{sc=Latin}\\p{sc=Cyrillic}\\p{M}\\d_]))?/iuy\nconst FAN_AFTER =\n  /(?:\\s{1,3}|-)(?:(?:fan|convection)(?:[- ](?:forced|assisted|oven))?|umluft|hei(?:ß|ss)luft)(?!(?!ι)[\\p{sc=Latin}\\p{sc=Cyrillic}\\p{M}\\d_])/iuy\nconst FAN_GROUP =\n  /\\s{0,3}\\(\\s{0,2}(?:(?:fan|convection)(?:[- ](?:forced|assisted|oven))?|umluft|hei(?:ß|ss)luft)\\s{0,2}\\)/iy\nconst FAN_BEFORE =\n  /(?:(?:fan|convection)(?:[- ](?:forced|assisted|oven))?|umluft|hei(?:ß|ss)luft)\\s{1,3}/iy\nconst FAN_PREFIX =\n  /(?:^|ι|[^\\p{sc=Latin}\\p{sc=Cyrillic}\\p{M}\\d_])((?:(?:fan|convection)(?:[- ](?:forced|assisted|oven))?|umluft|hei(?:ß|ss)luft)\\s{1,3})$/iu\nconst GAS =\n  /(?:gas(?:\\s{1,3}mark)?|mark)\\s{0,3}(?:\\d{1,2}(?:[-/\\u2013]\\d{1,2})?|[¼½¾])(?!(?!ι)[\\p{sc=Latin}\\p{sc=Cyrillic}\\p{M}\\d_])/iuy\nconst SEPARATOR = /\\s{0,3}(?:(?:,?\\s{0,3}or(?=\\s)|[-/,\\u2013\\u2014])\\s{0,3})?/iy\n// A parenthesis may hedge what it restates, as in \"350°F (about 180°C)\".\nconst OPEN =\n  /\\s{0,3}\\(\\s{0,2}(?:(?:about|around|roughly|approx(?:imately|\\.)?|ca\\.|i\\.e\\.,?|or)\\s{1,3}|[~≈]\\s{0,2})?/iy\nconst CLOSE = /\\s{0,2}\\)/y\n// Readings this close are one setting written in both units: 170°C is 338°F,\n// and recipes round it to 325°F or 350°F.\nconst OVEN_STEP = 10\n\n// A number that takes its scale from a later one, as 350 does in \"350–375°F\",\n// \"350 to 375 degrees F\", and \"350° (175°C)\". The later one stays text too,\n// so a converter never rewrites one end of a range.\nconst SHARED =\n  /\\d\\s{0,3}(?:(?:[°º˚]|degrees?)\\s{0,3}\\(|(?:[°º˚]|degrees?)?\\s{0,3}(?:[-\\u2010-\\u2015~/&]|to|and|or))\\s{0,3}$/i\n// A gas mark before \"/\" or \"or\" has its own scale, so the 200C in\n// \"gas 6/200C\" and \"gas mark 6 or 200C\" is read. Other joiners can start a\n// range, as in \"gas 4–5\" and \"gas mark 4 to 5\", so SHARED still applies.\nconst GAS_ALTERNATIVE = /(?:gas|mark)\\s{0,3}\\d{1,2}\\s{0,3}(?:\\/|or)\\s{0,3}$/i\nconst RANGE_AFTER = /\\s{0,3}(?:[-\\u2010-\\u2015~/&]|to|and|or)\\s{0,3}-?\\d/iy\n// A number that continues another, as in \"1.5\" and \"10:30\", isn't a reading,\n// and \"Reduce the heat by 20°F\" is a difference; converting it is wrong.\nconst NOT_A_READING =\n  /\\d[.,:]$|(?:^|ι|[^\\p{sc=Latin}\\p{sc=Cyrillic}\\p{M}\\d_])by\\s{1,3}(?:(?:about|around|roughly|approximately|another|an?|further|additional|extra)\\s{1,3}){0,3}$/iu\n// Words that make a bare \"350°\" or \"350 degrees\" an oven setting rather than\n// an angle, as in \"rotate the pan 180 degrees\", and \"180 C\" a temperature\n// rather than cups, as in \"add 100 c sugar\".\nconst SETTING =\n  /(?:^|ι|[^\\p{sc=Latin}\\p{sc=Cyrillic}\\p{M}\\d_])(?:at|to|of|be|is|until|oven|bake|roast|reads?|reach(?:es)?|registers?|hits?)\\s{1,3}(?:(?:about|around|roughly|approximately)\\s{1,3})?$/iu\nconst OVEN_AFTER =\n  /\\s{1,3}oven(?!(?!ι)[\\p{sc=Latin}\\p{sc=Cyrillic}\\p{M}\\d_])/iuy\n\nconst SIGN = /[-\\u2212]/\nconst SIGN_BEFORE = /[\\s(]/\n// ASCII only: Chinese puts numbers right after words, as in \"预热至200°C\".\nconst LETTER = /[a-z]/i\n\n/**\n * Matches a temperature, or a run of readings that state one setting several\n * ways, whose first number starts at `digit`. Text before `floor` belongs to\n * an earlier segment and is never included.\n */\nexport function matchTemperature(\n  text: string,\n  digit: number,\n  floor: number,\n  assumed: TemperatureUnit | undefined,\n): TemperatureMatch | undefined {\n  // Past the start of the text, `charAt` gives '' where an index would read a\n  // key set on `Object.prototype`.\n  const negative =\n    digit > floor &&\n    SIGN.test(text[digit - 1] ?? '') &&\n    SIGN_BEFORE.test(text.charAt(digit - 2) || ' ')\n  const start = negative ? digit - 1 : digit\n  const before = text.slice(Math.max(floor, start - LOOKBACK), start)\n  if (\n    LETTER.test(text.charAt(start - 1)) ||\n    NOT_A_READING.test(before) ||\n    (SHARED.test(before) && !GAS_ALTERNATIVE.test(before))\n  ) {\n    return undefined\n  }\n\n  const first = readingAt(text, digit)\n  if (!first) {\n    return undefined\n  }\n\n  const prefix = FAN_PREFIX.exec(before)?.[1]\n  const unit = first.unit ?? assumed\n  if (!unit || (!first.unit && exec(RANGE_AFTER, text, first.end))) {\n    return undefined\n  }\n\n  const reading: TemperatureReading = {\n    temperature: {\n      value: negative && first.value ? -first.value : first.value,\n      unit,\n    },\n    fan: Boolean(prefix) || first.fan,\n  }\n  const run: Run = { readings: [reading], gas: false }\n  let end = extend(text, first.end, run)\n  // A reading that needs a cue word is a temperature without one when the\n  // author restated it, as in \"Oven: 180 C (350 F).\"\n  if (\n    first.cued &&\n    run.readings.length < 2 &&\n    !(prefix || SETTING.test(before) || exec(OVEN_AFTER, text, first.end))\n  ) {\n    return undefined\n  }\n  // A marker after a pair, as in \"170°C (340°F) Fan\", is for the whole pair.\n  const fanEnd =\n    text[end - 1] === ')' && !run.readings.some(({ fan }) => fan)\n      ? at(FAN_AFTER, text, end)\n      : undefined\n  if (fanEnd !== undefined) {\n    end = fanEnd\n    for (const item of run.readings) {\n      item.fan = true\n    }\n  }\n\n  return {\n    start: prefix ? start - prefix.length : start,\n    end,\n    reading,\n    alternatives: run.readings.slice(1),\n  }\n}\n\n/**\n * Adds the items that follow `end` to `run`, such as \"/170C fan\" or\n * \"(200 degrees C)\", and returns where they stop. Groups don't nest.\n */\nfunction extend(text: string, end: number, run: Run, grouped?: true): number {\n  // Where the last reading after a joiner starts, and the run's size before it.\n  let owner: [number, number] | undefined\n  for (let count = 1; count < MAX_ITEMS; count++) {\n    run.clash = false\n    let group: number | undefined\n    if (!grouped) {\n      const { readings, gas } = run\n      const { length } = readings\n      const first = itemAt(text, at(OPEN, text, end), run)\n      group =\n        first === undefined\n          ? undefined\n          : at(CLOSE, text, extend(text, first, run, true))\n      if (group !== undefined) {\n        // An unmarked reading that restates a fan reading, as 340°F does in\n        // \"170°C fan (340°F)\", is for a fan oven too.\n        const fanOwner = readings[length - 1]\n        for (const item of readings.slice(length)) {\n          const { unit } = item.temperature\n          if (\n            fanOwner?.fan &&\n            near(item.temperature, fanOwner.temperature) &&\n            !readings.some(\n              (other) => other.fan && other.temperature.unit === unit,\n            )\n          ) {\n            item.fan = true\n          }\n        }\n      } else {\n        readings.length = length\n        run.gas = gas\n      }\n    }\n    // A parenthesis that clashes with the run restates the reading before it,\n    // which is a setting of its own, as in \"190°C (375°F) or 170°C fan\n    // (340°F)\", so the run ends before that reading.\n    if (run.clash && owner) {\n      run.readings.length = owner[1]\n      return owner[0]\n    }\n    const size = run.readings.length\n    const next = group ?? itemAt(text, at(SEPARATOR, text, end), run)\n    if (next === undefined) {\n      break\n    }\n    owner = run.readings.length > size ? [end, size] : undefined\n    end = next\n  }\n  return end\n}\n\n/**\n * A reading with its scale that restates the run's reading for the same kind\n * of oven in the other unit, or is the first for its kind, or a gas mark when\n * the run has none yet.\n */\nfunction itemAt(\n  text: string,\n  index: number | undefined,\n  run: Run,\n): number | undefined {\n  if (index === undefined) {\n    return undefined\n  }\n\n  const reading = readingAt(text, index)\n  if (reading?.unit) {\n    const { value, unit, fan } = reading\n    const temperature = { value, unit }\n    if (\n      run.readings.some(\n        (item) =>\n          item.fan === fan &&\n          (item.temperature.unit === unit ||\n            !near(item.temperature, temperature)),\n      )\n    ) {\n      run.clash = true\n      return undefined\n    }\n    run.readings.push({ temperature, fan })\n    return reading.end\n  }\n\n  const end = run.gas ? undefined : at(GAS, text, index)\n  if (end !== undefined) {\n    run.gas = true\n  }\n  return end\n}\n\n/**\n * Reads one temperature: an optional fan marker, a number, then a scale, a\n * degree sign, or the word \"degree\" or \"degrees\". `unit` is undefined when\n * only a degree sign or word says it is a temperature.\n */\nfunction readingAt(text: string, index: number): Reading | undefined {\n  const marked = at(FAN_BEFORE, text, index)\n  const number = exec(NUMBER, text, marked ?? index)\n  if (!number) {\n    return undefined\n  }\n\n  const [digits, integer = '', fraction] = number\n  const after = number.index + digits.length\n  let scale = exec(DEGREES, text, after)\n  let name = scale && (scale[1] ?? scale[2] ?? scale[3])\n  let cups = false\n  if (!scale) {\n    scale = exec(SCALE, text, after)\n    name = scale?.[2]\n    // A lone letter needs two digits, as in \"180C\" and \"350 F\". A C that could\n    // be cups needs three digits and, to start a run, a word such as \"to\"\n    // before it, so \"2C\", \"12 C bowl\", and \"add 100 c sugar\" stay text.\n    cups = name === 'c' || (name === 'C' && Boolean(scale?.[1]))\n    if (\n      !scale ||\n      (name?.length === 1 &&\n        (fraction || integer.length < (cups || name === 'f' ? 3 : 2)))\n    ) {\n      return undefined\n    }\n  }\n\n  const end = scale.index + scale[0].length\n  const fanEnd = at(FAN_AFTER, text, end) ?? at(FAN_GROUP, text, end)\n\n  return {\n    value: Number(digits),\n    unit: name ? (/^[cс℃]/i.test(name) ? 'C' : 'F') : undefined,\n    fan: marked !== undefined || fanEnd !== undefined,\n    cued: !name || cups,\n    end: fanEnd ?? end,\n  }\n}\n\nfunction near(a: Temperature, b: Temperature): boolean {\n  return Math.abs(celsius(a) - celsius(b)) <= OVEN_STEP\n}\n\nfunction celsius({ value, unit }: Temperature): number {\n  return unit === 'C' ? value : (value - 32) / 1.8\n}\n\nfunction exec(\n  pattern: RegExp,\n  text: string,\n  index: number,\n): RegExpExecArray | null {\n  pattern.lastIndex = index\n  return pattern.exec(text)\n}\n\n/** Where sticky `pattern` ends when it matches at `index`. */\nfunction at(pattern: RegExp, text: string, index: number): number | undefined {\n  return exec(pattern, text, index) ? pattern.lastIndex : undefined\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/steps/temperature.ts"],"sourcesContent":["import type { Temperature, TemperatureUnit } from '../units/temperature'\nimport type { TemperatureReading } from './segment'\n\ntype TemperatureMatch = {\n  start: number\n  end: number\n  reading: TemperatureReading\n  alternatives: TemperatureReading[]\n}\n\ntype Reading = {\n  value: number\n  unit: TemperatureUnit | undefined\n  fan: boolean\n  /** True when it counts only after a word such as \"at\", as \"350°\" and \"180 C\" do. */\n  cued: boolean\n  end: number\n}\n\n/**\n * The readings in a run, first included, and whether a gas mark was among\n * them. Readings for the same kind of oven are one setting written in both\n * units, so \"350°F or 375°F\" and \"350°F or 200°C\" are separate settings.\n * `clash` is set when a reading was turned away for that reason.\n */\ntype Run = { readings: TemperatureReading[]; gas: boolean; clash?: boolean }\n\n// Every quantifier is bounded, lookbehind reads at most LOOKBACK characters,\n// and a run holds at most MAX_ITEMS items, so each call does constant work and\n// a scan stays linear in the text length.\nconst LOOKBACK = 24\nconst MAX_ITEMS = 6\n\n// The lookahead never changes a reading, since no scale starts with a digit,\n// \".\" or \",\". It's there for speed: it turns a longer number away before\n// DEGREES and SCALE are tried.\nconst NUMBER = /(\\d{1,4})(\\.\\d{1,2})?(?![.,]?\\d)/y\n// Every word boundary in this file except LETTER, below, treats a Latin or\n// Cyrillic letter, a combining mark, a digit, or \"_\" as continuing a word,\n// since those scripts write the units and separate words with spaces:\n// \"200 fèves\" isn't 200 °F. Chinese, Japanese, and Korean attach words and\n// particles straight to a number or unit, as in \"45°C/113°F的温水\" and\n// \"180°C에서\", so their letters end a word. So do Greek letters, since Greek\n// writes the unit in its own letters: \"180°Cγια\" is missing a space. So does\n// U+0345, a combining mark that only sits on a Greek vowel. Under \"/iu\" the\n// Greek iotas fold onto it and match \"\\p{M}\", so each of these boundaries\n// lets \"ι\" end a word explicitly. \"º\" and \"ª\" end a unit letter too, as in\n// \"180Cº\". The unit may be a Cyrillic \"С\", as in \"180 °С\".\nconst DEGREES =\n  /(?:-|\\s{0,3})(?:([℃℉])|(?:[°º˚]|degrees?(?!(?!ι)[\\p{sc=Latin}\\p{sc=Cyrillic}\\p{M}\\d_]))(?:\\s{0,3}(?:(cel[cs]ius|centigrade|fahrenheit|[cfс])(?!(?![ºªι])[\\p{sc=Latin}\\p{sc=Cyrillic}\\p{M}\\d_])|\\(([cf])\\)))?)/iuy\nconst SCALE =\n  /(\\s{0,3})(cel[cs]ius|centigrade|fahrenheit|[cf])(?!(?![ºªι])[\\p{sc=Latin}\\p{sc=Cyrillic}\\p{M}\\d_])(?:°|\\s{1,3}degrees?(?!(?!ι)[\\p{sc=Latin}\\p{sc=Cyrillic}\\p{M}\\d_]))?/iuy\nconst FAN_AFTER =\n  /(?:\\s{1,3}|-)(?:(?:fan|convection)(?:[- ](?:forced|assisted|oven))?|umluft|hei(?:ß|ss)luft)(?!(?!ι)[\\p{sc=Latin}\\p{sc=Cyrillic}\\p{M}\\d_])/iuy\nconst FAN_GROUP =\n  /\\s{0,3}\\(\\s{0,2}(?:(?:fan|convection)(?:[- ](?:forced|assisted|oven))?|umluft|hei(?:ß|ss)luft)\\s{0,2}\\)/iy\nconst FAN_BEFORE =\n  /(?:(?:fan|convection)(?:[- ](?:forced|assisted|oven))?|umluft|hei(?:ß|ss)luft)\\s{1,3}/iy\nconst FAN_PREFIX =\n  /(?:^|ι|[^\\p{sc=Latin}\\p{sc=Cyrillic}\\p{M}\\d_])((?:(?:fan|convection)(?:[- ](?:forced|assisted|oven))?|umluft|hei(?:ß|ss)luft)\\s{1,3})$/iu\nconst GAS =\n  /(?:gas(?:\\s{1,3}mark)?|mark)\\s{0,3}(?:\\d{1,2}(?:[-/\\u2013]\\d{1,2})?|[¼½¾])(?!(?!ι)[\\p{sc=Latin}\\p{sc=Cyrillic}\\p{M}\\d_])/iuy\nconst SEPARATOR = /\\s{0,3}(?:(?:,?\\s{0,3}or(?=\\s)|[-/,\\u2013\\u2014])\\s{0,3})?/iy\n// A parenthesis may hedge what it restates, as in \"350°F (about 180°C)\".\nconst OPEN =\n  /\\s{0,3}\\(\\s{0,2}(?:(?:about|around|roughly|approx(?:imately|\\.)?|ca\\.|i\\.e\\.,?|or)\\s{1,3}|[~≈]\\s{0,2})?/iy\nconst CLOSE = /\\s{0,2}\\)/y\n// Readings this close are one setting written in both units: 170°C is 338°F,\n// and recipes round it to 325°F or 350°F.\nconst OVEN_STEP = 10\n\n// A number that takes its scale from a later one, as 350 does in \"350–375°F\",\n// \"350 to 375 degrees F\", and \"350° (175°C)\". The later one stays text too, so\n// a range with its unit only on the second end stays text when a joiner below\n// joins its ends. With another word, such as \"through\" or \"till\", between them,\n// only the second end is a temperature.\nconst SHARED =\n  /\\d\\s{0,3}(?:(?:[°º˚]|degrees?)\\s{0,3}\\(|(?:[°º˚]|degrees?)?\\s{0,3}(?:[-\\u2010-\\u2015~/&]|to|and|or))\\s{0,3}$/i\n// A gas mark before \"/\" or \"or\" has its own scale, so the 200C in\n// \"gas 6/200C\" and \"gas mark 6 or 200C\" is read. Other joiners can start a\n// range, as in \"gas 4–5\" and \"gas mark 4 to 5\", so SHARED still applies.\nconst GAS_ALTERNATIVE = /(?:gas|mark)\\s{0,3}\\d{1,2}\\s{0,3}(?:\\/|or)\\s{0,3}$/i\nconst RANGE_AFTER = /\\s{0,3}(?:[-\\u2010-\\u2015~/&]|to|and|or)\\s{0,3}-?\\d/iy\n// A number that continues another, as in \"1.5\" and \"10:30\", isn't a reading,\n// and \"Reduce the heat by 20°F\" is a difference; converting it is wrong.\nconst NOT_A_READING =\n  /\\d[.,:]$|(?:^|ι|[^\\p{sc=Latin}\\p{sc=Cyrillic}\\p{M}\\d_])by\\s{1,3}(?:(?:about|around|roughly|approximately|another|an?|further|additional|extra)\\s{1,3}){0,3}$/iu\n// Words that make a bare \"350°\" or \"350 degrees\" an oven setting rather than\n// an angle, as in \"rotate the pan 180 degrees\", and \"180 C\" a temperature\n// rather than cups, as in \"add 100 c sugar\".\nconst SETTING =\n  /(?:^|ι|[^\\p{sc=Latin}\\p{sc=Cyrillic}\\p{M}\\d_])(?:at|to|of|be|is|until|oven|bake|roast|reads?|reach(?:es)?|registers?|hits?)\\s{1,3}(?:(?:about|around|roughly|approximately)\\s{1,3})?$/iu\nconst OVEN_AFTER =\n  /\\s{1,3}oven(?!(?!ι)[\\p{sc=Latin}\\p{sc=Cyrillic}\\p{M}\\d_])/iuy\n\nconst SIGN = /[-\\u2212]/\nconst SIGN_BEFORE = /[\\s(]/\n// ASCII only: Chinese puts numbers right after words, as in \"预热至200°C\".\nconst LETTER = /[a-z]/i\n\n/**\n * Matches a temperature, or a run of readings that state one setting several\n * ways, whose first number starts at `digit`. Text before `floor` belongs to\n * an earlier segment and is never included.\n */\nexport function matchTemperature(\n  text: string,\n  digit: number,\n  floor: number,\n  assumed: TemperatureUnit | undefined,\n): TemperatureMatch | undefined {\n  // Past the start of the text, `charAt` gives '' where an index would read a\n  // key set on `Object.prototype`.\n  // A \"-\" right after a number with no unit of its own, or with only a degree\n  // sign, as in \"350 -375°F\" and \"350° -375°F\", is a range's dash. After a\n  // unit, as in \"4°C -18°C\", it may start a second reading.\n  const negative =\n    digit > floor &&\n    SIGN.test(text[digit - 1] ?? '') &&\n    SIGN_BEFORE.test(text.charAt(digit - 2) || ' ') &&\n    !SHARED.test(text.slice(Math.max(floor, digit - LOOKBACK), digit))\n  const start = negative ? digit - 1 : digit\n  const before = text.slice(Math.max(floor, start - LOOKBACK), start)\n  if (\n    LETTER.test(text.charAt(start - 1)) ||\n    NOT_A_READING.test(before) ||\n    (SHARED.test(before) && !GAS_ALTERNATIVE.test(before))\n  ) {\n    return undefined\n  }\n\n  const first = readingAt(text, digit)\n  if (!first) {\n    return undefined\n  }\n\n  const prefix = FAN_PREFIX.exec(before)?.[1]\n  const unit = first.unit ?? assumed\n  if (!unit || (!first.unit && exec(RANGE_AFTER, text, first.end))) {\n    return undefined\n  }\n\n  const reading: TemperatureReading = {\n    temperature: {\n      value: negative && first.value ? -first.value : first.value,\n      unit,\n    },\n    fan: Boolean(prefix) || first.fan,\n  }\n  const run: Run = { readings: [reading], gas: false }\n  let end = extend(text, first.end, run)\n  // A reading that needs a cue word is a temperature without one when the\n  // author restated it, as in \"Oven: 180 C (350 F).\"\n  if (\n    first.cued &&\n    run.readings.length < 2 &&\n    !(prefix || SETTING.test(before) || exec(OVEN_AFTER, text, first.end))\n  ) {\n    return undefined\n  }\n  // A marker after a pair, as in \"170°C (340°F) Fan\", is for the whole pair.\n  const fanEnd =\n    text[end - 1] === ')' && !run.readings.some(({ fan }) => fan)\n      ? at(FAN_AFTER, text, end)\n      : undefined\n  if (fanEnd !== undefined) {\n    end = fanEnd\n    for (const item of run.readings) {\n      item.fan = true\n    }\n  }\n\n  return {\n    start: prefix ? start - prefix.length : start,\n    end,\n    reading,\n    alternatives: run.readings.slice(1),\n  }\n}\n\n/**\n * Adds the items that follow `end` to `run`, such as \"/170C fan\" or\n * \"(200 degrees C)\", and returns where they stop. Groups don't nest.\n */\nfunction extend(text: string, end: number, run: Run, grouped?: true): number {\n  // Where the last reading after a joiner starts, and the run's size before it.\n  let owner: [number, number] | undefined\n  for (let count = 1; count < MAX_ITEMS; count++) {\n    run.clash = false\n    let group: number | undefined\n    if (!grouped) {\n      const { readings, gas } = run\n      const { length } = readings\n      const first = itemAt(text, at(OPEN, text, end), run)\n      group =\n        first === undefined\n          ? undefined\n          : at(CLOSE, text, extend(text, first, run, true))\n      if (group !== undefined) {\n        // An unmarked reading that restates a fan reading, as 340°F does in\n        // \"170°C fan (340°F)\", is for a fan oven too.\n        const fanOwner = readings[length - 1]\n        for (const item of readings.slice(length)) {\n          const { unit } = item.temperature\n          if (\n            fanOwner?.fan &&\n            near(item.temperature, fanOwner.temperature) &&\n            !readings.some(\n              (other) => other.fan && other.temperature.unit === unit,\n            )\n          ) {\n            item.fan = true\n          }\n        }\n      } else {\n        readings.length = length\n        run.gas = gas\n      }\n    }\n    // A parenthesis that clashes with the run restates the reading before it,\n    // which is a setting of its own, as in \"190°C (375°F) or 170°C fan\n    // (340°F)\", so the run ends before that reading.\n    if (run.clash && owner) {\n      run.readings.length = owner[1]\n      return owner[0]\n    }\n    const size = run.readings.length\n    const next = group ?? itemAt(text, at(SEPARATOR, text, end), run)\n    if (next === undefined) {\n      break\n    }\n    owner = run.readings.length > size ? [end, size] : undefined\n    end = next\n  }\n  return end\n}\n\n/**\n * A reading with its scale that restates the run's reading for the same kind\n * of oven in the other unit, or is the first for its kind, or a gas mark when\n * the run has none yet.\n */\nfunction itemAt(\n  text: string,\n  index: number | undefined,\n  run: Run,\n): number | undefined {\n  if (index === undefined) {\n    return undefined\n  }\n\n  const reading = readingAt(text, index)\n  if (reading?.unit) {\n    const { value, unit, fan } = reading\n    const temperature = { value, unit }\n    if (\n      run.readings.some(\n        (item) =>\n          item.fan === fan &&\n          (item.temperature.unit === unit ||\n            !near(item.temperature, temperature)),\n      )\n    ) {\n      run.clash = true\n      return undefined\n    }\n    run.readings.push({ temperature, fan })\n    return reading.end\n  }\n\n  const end = run.gas ? undefined : at(GAS, text, index)\n  if (end !== undefined) {\n    run.gas = true\n  }\n  return end\n}\n\n/**\n * Reads one temperature: an optional fan marker, a number, then a scale, a\n * degree sign, or the word \"degree\" or \"degrees\". `unit` is undefined when\n * only a degree sign or word says it is a temperature.\n */\nfunction readingAt(text: string, index: number): Reading | undefined {\n  const marked = at(FAN_BEFORE, text, index)\n  const number = exec(NUMBER, text, marked ?? index)\n  if (!number) {\n    return undefined\n  }\n\n  const [digits, integer = '', fraction] = number\n  const after = number.index + digits.length\n  let scale = exec(DEGREES, text, after)\n  let name = scale && (scale[1] ?? scale[2] ?? scale[3])\n  let cups = false\n  if (!scale) {\n    scale = exec(SCALE, text, after)\n    name = scale?.[2]\n    // A lone letter needs two digits, as in \"180C\" and \"350 F\". A C that could\n    // be cups needs three digits and, to start a run, a word such as \"to\"\n    // before it, so \"2C\", \"12 C bowl\", and \"add 100 c sugar\" stay text.\n    cups = name === 'c' || (name === 'C' && Boolean(scale?.[1]))\n    if (\n      !scale ||\n      (name?.length === 1 &&\n        (fraction || integer.length < (cups || name === 'f' ? 3 : 2)))\n    ) {\n      return undefined\n    }\n  }\n\n  const end = scale.index + scale[0].length\n  const fanEnd = at(FAN_AFTER, text, end) ?? at(FAN_GROUP, text, end)\n\n  return {\n    value: Number(digits),\n    unit: name ? (/^[cс℃]/i.test(name) ? 'C' : 'F') : undefined,\n    fan: marked !== undefined || fanEnd !== undefined,\n    cued: !name || cups,\n    end: fanEnd ?? end,\n  }\n}\n\nfunction near(a: Temperature, b: Temperature): boolean {\n  return Math.abs(celsius(a) - celsius(b)) <= OVEN_STEP\n}\n\nfunction celsius({ value, unit }: Temperature): number {\n  return unit === 'C' ? value : (value - 32) / 1.8\n}\n\nfunction exec(\n  pattern: RegExp,\n  text: string,\n  index: number,\n): RegExpExecArray | null {\n  pattern.lastIndex = index\n  return pattern.exec(text)\n}\n\n/** Where sticky `pattern` ends when it matches at `index`. */\nfunction at(pattern: RegExp, text: string, index: number): number | undefined {\n  return exec(pattern, text, index) ? pattern.lastIndex : undefined\n}\n"],"mappings":"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","names":[]}

package/dist/{types-BknM8KOd.d.cts → types-CKIoWsz8.d.cts}

@@ -1,4 +1,9 @@
-/** Thrown, or returned by the `parse*` functions, when data fails validation. */
+/**
+ * Thrown, or returned by the `parse*` functions, when data fails validation.
+ *
+ * Use `isRecipeValidationError` rather than `instanceof` to detect it, so the
+ * check also works when two copies of the package are installed.
+ */
 declare class RecipeValidationError extends RecipeBookError {
     readonly code: ValidationErrorCode;
     /**
@@ -20,7 +25,7 @@ declare class RecipeValidationError extends RecipeBookError {
 /**
  * Codes for errors thrown by Recipe Book. May grow in minor releases.
  *
- * @see https://recipe-book.siraj.page/errors
+ * @see https://recipe-book.siraj.page/errors/
  */
 type RecipeBookErrorCode = 'invalid_recipe' | 'invalid_quantity' | 'invalid_ingredient' | 'invalid_argument' | 'incompatible_units' | 'unknown_unit' | 'missing_parent';
 /** Codes for problems found in recipe data. May grow in minor releases. */
@@ -73,6 +78,16 @@ type ParseResult<T> = {
 };
 /** True for errors thrown by any copy of Recipe Book. Checks `name` and `code`, not `instanceof`. */
 declare function isRecipeBookError(error: unknown): error is RecipeBookError;
+/**
+ * True for a `RecipeValidationError` from any copy of Recipe Book, so its
+ * `issues` can be read. Checks `name`, `code`, and `issues`, not `instanceof`.
+ *
+ * @example
+ * if (isRecipeValidationError(error)) {
+ *   error.issues // readonly RecipeIssue[]
+ * }
+ */
+declare function isRecipeValidationError(error: unknown): error is RecipeValidationError;
 
 /** A measurement system. `'us'` is US customary. */
 type System = 'metric' | 'us';
@@ -623,6 +638,8 @@ type Recipe = {
     equipment: Equipment[];
     nutrition?: Nutrition | undefined;
 };
+/** The same type as `Recipe`, for files that import `@recipe-book/react` as `Recipe`. */
+type ParsedRecipe = Recipe;
 
-export { RecipeBookError as i, RecipeValidationError as m, isRecipeBookError as o, units as u };
-export type { Amount as A, CustomTime as C, Dimension as D, Equipment as E, Ingredient as I, Note as N, ParseResult as P, Quantity as Q, Recipe as R, System as S, Times as T, UnitAlias as U, ValidationErrorCode as V, Yield as Y, Servings as a, Step as b, Range as c, UnitId as d, UnitIdOf as e, UnitDefinition as f, IngredientSection as g, Nutrition as h, RecipeBookErrorCode as j, RecipeIssue as k, RecipeIssueCode as l, StepSection as n };
+export { RecipeBookError as j, RecipeValidationError as n, isRecipeBookError as p, isRecipeValidationError as q, units as u };
+export type { Amount as A, CustomTime as C, Dimension as D, Equipment as E, Ingredient as I, Note as N, ParseResult as P, Quantity as Q, Recipe as R, System as S, Times as T, UnitAlias as U, ValidationErrorCode as V, Yield as Y, Servings as a, Step as b, Range as c, UnitId as d, UnitIdOf as e, UnitDefinition as f, IngredientSection as g, Nutrition as h, ParsedRecipe as i, RecipeBookErrorCode as k, RecipeIssue as l, RecipeIssueCode as m, StepSection as o };

package/dist/{types-BknM8KOd.d.ts → types-CKIoWsz8.d.ts}

@@ -1,4 +1,9 @@
-/** Thrown, or returned by the `parse*` functions, when data fails validation. */
+/**
+ * Thrown, or returned by the `parse*` functions, when data fails validation.
+ *
+ * Use `isRecipeValidationError` rather than `instanceof` to detect it, so the
+ * check also works when two copies of the package are installed.
+ */
 declare class RecipeValidationError extends RecipeBookError {
     readonly code: ValidationErrorCode;
     /**
@@ -20,7 +25,7 @@ declare class RecipeValidationError extends RecipeBookError {
 /**
  * Codes for errors thrown by Recipe Book. May grow in minor releases.
  *
- * @see https://recipe-book.siraj.page/errors
+ * @see https://recipe-book.siraj.page/errors/
  */
 type RecipeBookErrorCode = 'invalid_recipe' | 'invalid_quantity' | 'invalid_ingredient' | 'invalid_argument' | 'incompatible_units' | 'unknown_unit' | 'missing_parent';
 /** Codes for problems found in recipe data. May grow in minor releases. */
@@ -73,6 +78,16 @@ type ParseResult<T> = {
 };
 /** True for errors thrown by any copy of Recipe Book. Checks `name` and `code`, not `instanceof`. */
 declare function isRecipeBookError(error: unknown): error is RecipeBookError;
+/**
+ * True for a `RecipeValidationError` from any copy of Recipe Book, so its
+ * `issues` can be read. Checks `name`, `code`, and `issues`, not `instanceof`.
+ *
+ * @example
+ * if (isRecipeValidationError(error)) {
+ *   error.issues // readonly RecipeIssue[]
+ * }
+ */
+declare function isRecipeValidationError(error: unknown): error is RecipeValidationError;
 
 /** A measurement system. `'us'` is US customary. */
 type System = 'metric' | 'us';
@@ -623,6 +638,8 @@ type Recipe = {
     equipment: Equipment[];
     nutrition?: Nutrition | undefined;
 };
+/** The same type as `Recipe`, for files that import `@recipe-book/react` as `Recipe`. */
+type ParsedRecipe = Recipe;
 
-export { RecipeBookError as i, RecipeValidationError as m, isRecipeBookError as o, units as u };
-export type { Amount as A, CustomTime as C, Dimension as D, Equipment as E, Ingredient as I, Note as N, ParseResult as P, Quantity as Q, Recipe as R, System as S, Times as T, UnitAlias as U, ValidationErrorCode as V, Yield as Y, Servings as a, Step as b, Range as c, UnitId as d, UnitIdOf as e, UnitDefinition as f, IngredientSection as g, Nutrition as h, RecipeBookErrorCode as j, RecipeIssue as k, RecipeIssueCode as l, StepSection as n };
+export { RecipeBookError as j, RecipeValidationError as n, isRecipeBookError as p, isRecipeValidationError as q, units as u };
+export type { Amount as A, CustomTime as C, Dimension as D, Equipment as E, Ingredient as I, Note as N, ParseResult as P, Quantity as Q, Recipe as R, System as S, Times as T, UnitAlias as U, ValidationErrorCode as V, Yield as Y, Servings as a, Step as b, Range as c, UnitId as d, UnitIdOf as e, UnitDefinition as f, IngredientSection as g, Nutrition as h, ParsedRecipe as i, RecipeBookErrorCode as k, RecipeIssue as l, RecipeIssueCode as m, StepSection as o };

package/dist/units/convert.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/units/convert.ts"],"sourcesContent":["import { RecipeBookError } from '../errors'\nimport {\n  checkQuantity,\n  checkResult,\n  mapAmount,\n  type SameAmount,\n} from '../quantity/amount'\nimport type { Amount, Quantity } from '../quantity/types'\nimport { getUnit, unknownUnitError } from './lookup'\nimport {\n  lookupUnit,\n  type System,\n  type UnitDefinition,\n  type UnitId,\n} from './registry'\nimport { checkSystem, inSystem } from './system'\n\n/**\n * Converts a quantity to another unit of the same dimension. Both ends of a\n * range convert. Nothing is rounded, so the amount can be off in its last\n * digit: 5 tbsp is 14.999999999999998 tsp.\n *\n * @throws {RecipeBookError} `incompatible_units` across dimensions (cup to g),\n *   between a count unit and a different unit, or for a bare count. Check with\n *   {@link canConvert} first when the units come from data.\n * @throws {RecipeBookError} `unknown_unit` when either unit is not a unit id.\n * @throws {RecipeBookError} `invalid_argument` when `quantity` isn't a quantity object, the amount is not a finite number greater than 0 or a range of them, a range's `min` isn't less than its `max`, the quantity has `max` set, as a `Servings` or `Yield` has, or the result overflows to `Infinity` or underflows to 0, which only an amount above about 1e300 or below about 1e-300 can do.\n *\n * @example\n * convert({ amount: 1, unit: 'cup' }, 'ml') // { amount: 236.5882365, unit: 'ml' }\n * convert({ amount: { min: 2, max: 3 }, unit: 'tbsp' }, 'tsp') // { amount: { min: 6, max: 9 }, unit: 'tsp' }\n */\nexport function convert<A extends Amount, To extends UnitId>(\n  quantity: Quantity & { amount: A },\n  to: To,\n): { amount: SameAmount<A>; unit: To } {\n  const amount = checkQuantity('convert', quantity)\n  const target = getUnit(to)\n  const source =\n    quantity.unit === undefined ? undefined : getUnit(quantity.unit)\n\n  if (source?.id === target.id) {\n    return { amount: amount as SameAmount<A>, unit: to }\n  }\n  if (\n    source?.toBase === undefined ||\n    target.toBase === undefined ||\n    source.dimension !== target.dimension\n  ) {\n    throw incompatibleUnits(source, target)\n  }\n\n  const fromBase = source.toBase\n  const toBase = target.toBase\n  return {\n    amount: checkResult(\n      'convert',\n      mapAmount(amount, (value) => (value * fromBase) / toBase),\n    ) as SameAmount<A>,\n    unit: to,\n  }\n}\n\n/**\n * True when {@link convert} can convert between the two units: same unit, or\n * mass to mass, or volume to volume. Never throws, so it is safe on untrusted data.\n *\n * @example\n * canConvert('cup', 'ml') // true\n * canConvert('cup', 'g') // false\n * canConvert(undefined, 'g') // false: a bare count has no size\n */\nexport function canConvert(from: UnitId | undefined, to: UnitId): boolean {\n  const source = lookupUnit(from)\n  const target = lookupUnit(to)\n\n  if (!source || !target) {\n    return false\n  }\n\n  // Only count units lack `toBase`, so a target with the source's dimension has one.\n  return (\n    source.id === target.id ||\n    (source.toBase !== undefined && source.dimension === target.dimension)\n  )\n}\n\n/**\n * Expresses a quantity in a measurement system, choosing the display unit\n * from that system's ladder: g and kg, ml and l, oz and lb, or tsp, tbsp, and\n * cup. Nothing is rounded, so the amount can be off in its last digit, as with\n * {@link convert}.\n *\n * Returns the quantity unchanged when its unit is already native to `system`\n * (tsp and tbsp are native to both), when it is a count unit, or when it has\n * no unit.\n *\n * @throws {RecipeBookError} `invalid_argument` for an unknown system, an invalid amount, a quantity with `max` set, as a `Servings` or `Yield` has, or a result that overflows to `Infinity` or underflows to 0, which only an amount above about 1e300 or below about 1e-300 can do.\n * @throws {RecipeBookError} `unknown_unit` when the unit is not a unit id.\n *\n * @example\n * toSystem({ amount: 250, unit: 'g' }, 'us') // { amount: 8.818…, unit: 'oz' }\n * toSystem({ amount: 0.5, unit: 'cup' }, 'metric') // { amount: 118.29…, unit: 'ml' }\n * toSystem({ amount: 3, unit: 'tsp' }, 'metric') // unchanged\n */\nexport function toSystem<A extends Amount>(\n  quantity: Quantity & { amount: A },\n  system: System,\n): { amount: SameAmount<A>; unit?: UnitId | undefined } {\n  const amount = checkQuantity('toSystem', quantity)\n  checkSystem('toSystem', system)\n  const { unit } = quantity\n\n  if (unit !== undefined && !lookupUnit(unit)) {\n    throw unknownUnitError(unit)\n  }\n\n  const checked = { amount, unit }\n  const result = inSystem(checked, system)\n  checkResult('toSystem', result.amount)\n  return (result === checked ? quantity : result) as {\n    amount: SameAmount<A>\n    unit?: UnitId | undefined\n  }\n}\n\nfunction incompatibleUnits(\n  source: UnitDefinition | undefined,\n  target: UnitDefinition,\n): RecipeBookError {\n  const example =\n    target.dimension === 'mass'\n      ? '120 g'\n      : target.dimension === 'volume'\n        ? '250 ml'\n        : `1 ${target.id}`\n  const fix = `Add an equivalent to the ingredient, e.g. equivalents: [\"${example}\"].`\n\n  if (!source) {\n    return new RecipeBookError(\n      'incompatible_units',\n      `Cannot convert a quantity without a unit to ${target.id}; a bare count such as \"2 eggs\" has no fixed size. ${fix}`,\n    )\n  }\n\n  const countUnit = [source, target].find((unit) => unit.toBase === undefined)\n  if (countUnit) {\n    return new RecipeBookError(\n      'incompatible_units',\n      `Cannot convert ${source.id} to ${target.id}; ${countUnit.id} is a count unit with no fixed size. ${fix}`,\n    )\n  }\n\n  return new RecipeBookError(\n    'incompatible_units',\n    `Cannot convert ${source.id} (${source.dimension}) to ${target.id} (${target.dimension}). ${fix}`,\n  )\n}\n"],"mappings":";AAAA,SAAS,uBAAuB;AAChC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AAEP,SAAS,SAAS,wBAAwB;AAC1C;AAAA,EACE;AAAA,OAIK;AACP,SAAS,aAAa,gBAAgB;AAiB/B,SAAS,QACd,UACA,IACqC;AACrC,QAAM,SAAS,cAAc,WAAW,QAAQ;AAChD,QAAM,SAAS,QAAQ,EAAE;AACzB,QAAM,SACJ,SAAS,SAAS,SAAY,SAAY,QAAQ,SAAS,IAAI;AAEjE,MAAI,QAAQ,OAAO,OAAO,IAAI;AAC5B,WAAO,EAAE,QAAiC,MAAM,GAAG;AAAA,EACrD;AACA,MACE,QAAQ,WAAW,UACnB,OAAO,WAAW,UAClB,OAAO,cAAc,OAAO,WAC5B;AACA,UAAM,kBAAkB,QAAQ,MAAM;AAAA,EACxC;AAEA,QAAM,WAAW,OAAO;AACxB,QAAM,SAAS,OAAO;AACtB,SAAO;AAAA,IACL,QAAQ;AAAA,MACN;AAAA,MACA,UAAU,QAAQ,CAAC,UAAW,QAAQ,WAAY,MAAM;AAAA,IAC1D;AAAA,IACA,MAAM;AAAA,EACR;AACF;AAWO,SAAS,WAAW,MAA0B,IAAqB;AACxE,QAAM,SAAS,WAAW,IAAI;AAC9B,QAAM,SAAS,WAAW,EAAE;AAE5B,MAAI,CAAC,UAAU,CAAC,QAAQ;AACtB,WAAO;AAAA,EACT;AAGA,SACE,OAAO,OAAO,OAAO,MACpB,OAAO,WAAW,UAAa,OAAO,cAAc,OAAO;AAEhE;AAoBO,SAAS,SACd,UACA,QACsD;AACtD,QAAM,SAAS,cAAc,YAAY,QAAQ;AACjD,cAAY,YAAY,MAAM;AAC9B,QAAM,EAAE,KAAK,IAAI;AAEjB,MAAI,SAAS,UAAa,CAAC,WAAW,IAAI,GAAG;AAC3C,UAAM,iBAAiB,IAAI;AAAA,EAC7B;AAEA,QAAM,UAAU,EAAE,QAAQ,KAAK;AAC/B,QAAM,SAAS,SAAS,SAAS,MAAM;AACvC,cAAY,YAAY,OAAO,MAAM;AACrC,SAAQ,WAAW,UAAU,WAAW;AAI1C;AAEA,SAAS,kBACP,QACA,QACiB;AACjB,QAAM,UACJ,OAAO,cAAc,SACjB,UACA,OAAO,cAAc,WACnB,WACA,KAAK,OAAO,EAAE;AACtB,QAAM,MAAM,4DAA4D,OAAO;AAE/E,MAAI,CAAC,QAAQ;AACX,WAAO,IAAI;AAAA,MACT;AAAA,MACA,+CAA+C,OAAO,EAAE,sDAAsD,GAAG;AAAA,IACnH;AAAA,EACF;AAEA,QAAM,YAAY,CAAC,QAAQ,MAAM,EAAE,KAAK,CAAC,SAAS,KAAK,WAAW,MAAS;AAC3E,MAAI,WAAW;AACb,WAAO,IAAI;AAAA,MACT;AAAA,MACA,kBAAkB,OAAO,EAAE,OAAO,OAAO,EAAE,KAAK,UAAU,EAAE,wCAAwC,GAAG;AAAA,IACzG;AAAA,EACF;AAEA,SAAO,IAAI;AAAA,IACT;AAAA,IACA,kBAAkB,OAAO,EAAE,KAAK,OAAO,SAAS,QAAQ,OAAO,EAAE,KAAK,OAAO,SAAS,MAAM,GAAG;AAAA,EACjG;AACF;","names":[]}
+{"version":3,"sources":["../../src/units/convert.ts"],"sourcesContent":["import { RecipeBookError } from '../errors'\nimport {\n  checkQuantity,\n  checkResult,\n  mapAmount,\n  type SameAmount,\n} from '../quantity/amount'\nimport type { Amount, Quantity } from '../quantity/types'\nimport { getUnit, unknownUnitError } from './lookup'\nimport {\n  lookupUnit,\n  type System,\n  type UnitDefinition,\n  type UnitId,\n} from './registry'\nimport { checkSystem, inSystem } from './system'\n\n/**\n * Converts a quantity to another unit of the same dimension. Both ends of a\n * range convert. Nothing is rounded, so the amount can be off in its last\n * digit: 5 tbsp is 14.999999999999998 tsp.\n *\n * An error thrown by a getter or proxy in the input passes through.\n *\n * @throws {RecipeBookError} `incompatible_units` across dimensions (cup to g),\n *   between a count unit and a different unit, or for a bare count. Check with\n *   {@link canConvert} first when the units come from data.\n * @throws {RecipeBookError} `unknown_unit` when either unit is not a unit id.\n * @throws {RecipeBookError} `invalid_argument` when `quantity` isn't a quantity object, the amount is not a finite number greater than 0 or a range of them, a range's `min` isn't less than its `max`, the quantity has `max` set, as a `Servings` or `Yield` has, or the result overflows to `Infinity` or underflows to 0, which only an amount above about 1e300 or below about 1e-300 can do.\n *\n * @example\n * convert({ amount: 1, unit: 'cup' }, 'ml') // { amount: 236.5882365, unit: 'ml' }\n * convert({ amount: { min: 2, max: 3 }, unit: 'tbsp' }, 'tsp') // { amount: { min: 6, max: 9 }, unit: 'tsp' }\n */\nexport function convert<A extends Amount, To extends UnitId>(\n  quantity: Quantity & { amount: A },\n  to: To,\n): { amount: SameAmount<A>; unit: To } {\n  const amount = checkQuantity('convert', quantity)\n  const target = getUnit(to)\n  const source =\n    quantity.unit === undefined ? undefined : getUnit(quantity.unit)\n\n  if (source?.id === target.id) {\n    return { amount: amount as SameAmount<A>, unit: to }\n  }\n  if (\n    source?.toBase === undefined ||\n    target.toBase === undefined ||\n    source.dimension !== target.dimension\n  ) {\n    throw incompatibleUnits(source, target)\n  }\n\n  const fromBase = source.toBase\n  const toBase = target.toBase\n  return {\n    amount: checkResult(\n      'convert',\n      mapAmount(amount, (value) => (value * fromBase) / toBase),\n    ) as SameAmount<A>,\n    unit: to,\n  }\n}\n\n/**\n * True when {@link convert} can convert between the two units: same unit, or\n * mass to mass, or volume to volume. Never throws, so it is safe on untrusted data.\n *\n * @example\n * canConvert('cup', 'ml') // true\n * canConvert('cup', 'g') // false\n * canConvert(undefined, 'g') // false: a bare count has no size\n */\nexport function canConvert(from: UnitId | undefined, to: UnitId): boolean {\n  const source = lookupUnit(from)\n  const target = lookupUnit(to)\n\n  if (!source || !target) {\n    return false\n  }\n\n  // Only count units lack `toBase`, so a target with the source's dimension has one.\n  return (\n    source.id === target.id ||\n    (source.toBase !== undefined && source.dimension === target.dimension)\n  )\n}\n\n/**\n * Expresses a quantity in a measurement system, choosing the display unit\n * from that system's ladder: g and kg, ml and l, oz and lb, or tsp, tbsp, and\n * cup. Nothing is rounded, so the amount can be off in its last digit, as with\n * {@link convert}.\n *\n * Returns the quantity unchanged when its unit is already native to `system`\n * (tsp and tbsp are native to both), when it is a count unit, or when it has\n * no unit.\n *\n * An error thrown by a getter or proxy in the input passes through.\n *\n * @throws {RecipeBookError} `invalid_argument` for an unknown system, an invalid amount, a quantity with `max` set, as a `Servings` or `Yield` has, or a result that overflows to `Infinity` or underflows to 0, which only an amount above about 1e300 or below about 1e-300 can do.\n * @throws {RecipeBookError} `unknown_unit` when the unit is not a unit id.\n *\n * @example\n * toSystem({ amount: 250, unit: 'g' }, 'us') // { amount: 8.818…, unit: 'oz' }\n * toSystem({ amount: 0.5, unit: 'cup' }, 'metric') // { amount: 118.29…, unit: 'ml' }\n * toSystem({ amount: 3, unit: 'tsp' }, 'metric') // unchanged\n */\nexport function toSystem<A extends Amount>(\n  quantity: Quantity & { amount: A },\n  system: System,\n): { amount: SameAmount<A>; unit?: UnitId | undefined } {\n  const amount = checkQuantity('toSystem', quantity)\n  checkSystem('toSystem', system)\n  const { unit } = quantity\n\n  if (unit !== undefined && !lookupUnit(unit)) {\n    throw unknownUnitError(unit)\n  }\n\n  const checked = { amount, unit }\n  const result = inSystem(checked, system)\n  checkResult('toSystem', result.amount)\n  return (result === checked ? quantity : result) as {\n    amount: SameAmount<A>\n    unit?: UnitId | undefined\n  }\n}\n\nfunction incompatibleUnits(\n  source: UnitDefinition | undefined,\n  target: UnitDefinition,\n): RecipeBookError {\n  const example =\n    target.dimension === 'mass'\n      ? '120 g'\n      : target.dimension === 'volume'\n        ? '250 ml'\n        : `1 ${target.id}`\n  const fix = `Add an equivalent to the ingredient, e.g. equivalents: [\"${example}\"].`\n\n  if (!source) {\n    return new RecipeBookError(\n      'incompatible_units',\n      `Cannot convert a quantity without a unit to ${target.id}; a bare count such as \"2 eggs\" has no fixed size. ${fix}`,\n    )\n  }\n\n  const countUnit = [source, target].find((unit) => unit.toBase === undefined)\n  if (countUnit) {\n    return new RecipeBookError(\n      'incompatible_units',\n      `Cannot convert ${source.id} to ${target.id}; ${countUnit.id} is a count unit with no fixed size. ${fix}`,\n    )\n  }\n\n  return new RecipeBookError(\n    'incompatible_units',\n    `Cannot convert ${source.id} (${source.dimension}) to ${target.id} (${target.dimension}). ${fix}`,\n  )\n}\n"],"mappings":";AAAA,SAAS,uBAAuB;AAChC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AAEP,SAAS,SAAS,wBAAwB;AAC1C;AAAA,EACE;AAAA,OAIK;AACP,SAAS,aAAa,gBAAgB;AAmB/B,SAAS,QACd,UACA,IACqC;AACrC,QAAM,SAAS,cAAc,WAAW,QAAQ;AAChD,QAAM,SAAS,QAAQ,EAAE;AACzB,QAAM,SACJ,SAAS,SAAS,SAAY,SAAY,QAAQ,SAAS,IAAI;AAEjE,MAAI,QAAQ,OAAO,OAAO,IAAI;AAC5B,WAAO,EAAE,QAAiC,MAAM,GAAG;AAAA,EACrD;AACA,MACE,QAAQ,WAAW,UACnB,OAAO,WAAW,UAClB,OAAO,cAAc,OAAO,WAC5B;AACA,UAAM,kBAAkB,QAAQ,MAAM;AAAA,EACxC;AAEA,QAAM,WAAW,OAAO;AACxB,QAAM,SAAS,OAAO;AACtB,SAAO;AAAA,IACL,QAAQ;AAAA,MACN;AAAA,MACA,UAAU,QAAQ,CAAC,UAAW,QAAQ,WAAY,MAAM;AAAA,IAC1D;AAAA,IACA,MAAM;AAAA,EACR;AACF;AAWO,SAAS,WAAW,MAA0B,IAAqB;AACxE,QAAM,SAAS,WAAW,IAAI;AAC9B,QAAM,SAAS,WAAW,EAAE;AAE5B,MAAI,CAAC,UAAU,CAAC,QAAQ;AACtB,WAAO;AAAA,EACT;AAGA,SACE,OAAO,OAAO,OAAO,MACpB,OAAO,WAAW,UAAa,OAAO,cAAc,OAAO;AAEhE;AAsBO,SAAS,SACd,UACA,QACsD;AACtD,QAAM,SAAS,cAAc,YAAY,QAAQ;AACjD,cAAY,YAAY,MAAM;AAC9B,QAAM,EAAE,KAAK,IAAI;AAEjB,MAAI,SAAS,UAAa,CAAC,WAAW,IAAI,GAAG;AAC3C,UAAM,iBAAiB,IAAI;AAAA,EAC7B;AAEA,QAAM,UAAU,EAAE,QAAQ,KAAK;AAC/B,QAAM,SAAS,SAAS,SAAS,MAAM;AACvC,cAAY,YAAY,OAAO,MAAM;AACrC,SAAQ,WAAW,UAAU,WAAW;AAI1C;AAEA,SAAS,kBACP,QACA,QACiB;AACjB,QAAM,UACJ,OAAO,cAAc,SACjB,UACA,OAAO,cAAc,WACnB,WACA,KAAK,OAAO,EAAE;AACtB,QAAM,MAAM,4DAA4D,OAAO;AAE/E,MAAI,CAAC,QAAQ;AACX,WAAO,IAAI;AAAA,MACT;AAAA,MACA,+CAA+C,OAAO,EAAE,sDAAsD,GAAG;AAAA,IACnH;AAAA,EACF;AAEA,QAAM,YAAY,CAAC,QAAQ,MAAM,EAAE,KAAK,CAAC,SAAS,KAAK,WAAW,MAAS;AAC3E,MAAI,WAAW;AACb,WAAO,IAAI;AAAA,MACT;AAAA,MACA,kBAAkB,OAAO,EAAE,OAAO,OAAO,EAAE,KAAK,UAAU,EAAE,wCAAwC,GAAG;AAAA,IACzG;AAAA,EACF;AAEA,SAAO,IAAI;AAAA,IACT;AAAA,IACA,kBAAkB,OAAO,EAAE,KAAK,OAAO,SAAS,QAAQ,OAAO,EAAE,KAAK,OAAO,SAAS,MAAM,GAAG;AAAA,EACjG;AACF;","names":[]}

package/dist/units/temperature.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/units/temperature.ts"],"sourcesContent":["import { describeValue, RecipeBookError } from '../errors'\n\n/** Degrees Celsius or Fahrenheit. */\nexport type TemperatureUnit = 'C' | 'F'\n\n/**\n * An oven or food temperature. Temperatures are not quantities: converting\n * them is affine, and scaling a recipe never changes them.\n */\nexport type Temperature = { value: number; unit: TemperatureUnit }\n\n/**\n * Converts a temperature between Celsius and Fahrenheit. Nothing is rounded,\n * so the value can be off in its last digits: −18 °C is\n * −0.3999999999999986 °F.\n *\n * @throws {RecipeBookError} `invalid_argument` for a non-finite value, an unknown unit, or a result that overflows to `Infinity` or `-Infinity`, which only a value beyond about ±2e307 can do.\n *\n * @example\n * convertTemperature({ value: 350, unit: 'F' }, 'C') // { value: 176.66…, unit: 'C' }\n * convertTemperature({ value: 180, unit: 'C' }, 'F') // { value: 356, unit: 'F' }\n */\nexport function convertTemperature(\n  temperature: Temperature,\n  to: TemperatureUnit,\n): Temperature {\n  const { value, unit } = temperature ?? {}\n\n  if (typeof value !== 'number' || !Number.isFinite(value)) {\n    throw invalidArgument(\n      `value must be a finite number, received ${describeValue(value)}`,\n    )\n  }\n  if (unit !== 'C' && unit !== 'F') {\n    throw invalidArgument(\n      `temperature unit must be \"C\" or \"F\", received ${describeValue(unit)}`,\n    )\n  }\n  if (to !== 'C' && to !== 'F') {\n    throw invalidArgument(\n      `target unit must be \"C\" or \"F\", received ${describeValue(to)}`,\n    )\n  }\n\n  if (unit === to) {\n    return { value, unit }\n  }\n\n  const result = to === 'C' ? ((value - 32) * 5) / 9 : (value * 9) / 5 + 32\n  if (!Number.isFinite(result)) {\n    throw invalidArgument(\n      `the result must be a finite number, but it is ${result}`,\n    )\n  }\n  return { value: result, unit: to }\n}\n\nfunction invalidArgument(detail: string): RecipeBookError {\n  return new RecipeBookError(\n    'invalid_argument',\n    `convertTemperature: ${detail}.`,\n  )\n}\n"],"mappings":";AAAA,SAAS,eAAe,uBAAuB;AAsBxC,SAAS,mBACd,aACA,IACa;AACb,QAAM,EAAE,OAAO,KAAK,IAAI,eAAe,CAAC;AAExC,MAAI,OAAO,UAAU,YAAY,CAAC,OAAO,SAAS,KAAK,GAAG;AACxD,UAAM;AAAA,MACJ,2CAA2C,cAAc,KAAK,CAAC;AAAA,IACjE;AAAA,EACF;AACA,MAAI,SAAS,OAAO,SAAS,KAAK;AAChC,UAAM;AAAA,MACJ,iDAAiD,cAAc,IAAI,CAAC;AAAA,IACtE;AAAA,EACF;AACA,MAAI,OAAO,OAAO,OAAO,KAAK;AAC5B,UAAM;AAAA,MACJ,4CAA4C,cAAc,EAAE,CAAC;AAAA,IAC/D;AAAA,EACF;AAEA,MAAI,SAAS,IAAI;AACf,WAAO,EAAE,OAAO,KAAK;AAAA,EACvB;AAEA,QAAM,SAAS,OAAO,OAAQ,QAAQ,MAAM,IAAK,IAAK,QAAQ,IAAK,IAAI;AACvE,MAAI,CAAC,OAAO,SAAS,MAAM,GAAG;AAC5B,UAAM;AAAA,MACJ,iDAAiD,MAAM;AAAA,IACzD;AAAA,EACF;AACA,SAAO,EAAE,OAAO,QAAQ,MAAM,GAAG;AACnC;AAEA,SAAS,gBAAgB,QAAiC;AACxD,SAAO,IAAI;AAAA,IACT;AAAA,IACA,uBAAuB,MAAM;AAAA,EAC/B;AACF;","names":[]}
+{"version":3,"sources":["../../src/units/temperature.ts"],"sourcesContent":["import { describeValue, RecipeBookError } from '../errors'\n\n/** Degrees Celsius or Fahrenheit. */\nexport type TemperatureUnit = 'C' | 'F'\n\n/**\n * An oven or food temperature. Temperatures are not quantities: converting\n * them is affine, and scaling a recipe never changes them.\n */\nexport type Temperature = { value: number; unit: TemperatureUnit }\n\n/**\n * Converts a temperature between Celsius and Fahrenheit. Nothing is rounded,\n * so the value can be off in its last digits: −18 °C is\n * −0.3999999999999986 °F.\n *\n * An error thrown by a getter or proxy in the input passes through.\n *\n * @throws {RecipeBookError} `invalid_argument` for a non-finite value, an unknown unit, or a result that overflows to `Infinity` or `-Infinity`, which only a value beyond about ±2e307 can do.\n *\n * @example\n * convertTemperature({ value: 350, unit: 'F' }, 'C') // { value: 176.66…, unit: 'C' }\n * convertTemperature({ value: 180, unit: 'C' }, 'F') // { value: 356, unit: 'F' }\n */\nexport function convertTemperature(\n  temperature: Temperature,\n  to: TemperatureUnit,\n): Temperature {\n  const { value, unit } = temperature ?? {}\n\n  if (typeof value !== 'number' || !Number.isFinite(value)) {\n    throw invalidArgument(\n      `value must be a finite number, received ${describeValue(value)}`,\n    )\n  }\n  if (unit !== 'C' && unit !== 'F') {\n    throw invalidArgument(\n      `temperature unit must be \"C\" or \"F\", received ${describeValue(unit)}`,\n    )\n  }\n  if (to !== 'C' && to !== 'F') {\n    throw invalidArgument(\n      `target unit must be \"C\" or \"F\", received ${describeValue(to)}`,\n    )\n  }\n\n  if (unit === to) {\n    return { value, unit }\n  }\n\n  const result = to === 'C' ? ((value - 32) * 5) / 9 : (value * 9) / 5 + 32\n  if (!Number.isFinite(result)) {\n    throw invalidArgument(\n      `the result must be a finite number, but it is ${result}`,\n    )\n  }\n  return { value: result, unit: to }\n}\n\nfunction invalidArgument(detail: string): RecipeBookError {\n  return new RecipeBookError(\n    'invalid_argument',\n    `convertTemperature: ${detail}.`,\n  )\n}\n"],"mappings":";AAAA,SAAS,eAAe,uBAAuB;AAwBxC,SAAS,mBACd,aACA,IACa;AACb,QAAM,EAAE,OAAO,KAAK,IAAI,eAAe,CAAC;AAExC,MAAI,OAAO,UAAU,YAAY,CAAC,OAAO,SAAS,KAAK,GAAG;AACxD,UAAM;AAAA,MACJ,2CAA2C,cAAc,KAAK,CAAC;AAAA,IACjE;AAAA,EACF;AACA,MAAI,SAAS,OAAO,SAAS,KAAK;AAChC,UAAM;AAAA,MACJ,iDAAiD,cAAc,IAAI,CAAC;AAAA,IACtE;AAAA,EACF;AACA,MAAI,OAAO,OAAO,OAAO,KAAK;AAC5B,UAAM;AAAA,MACJ,4CAA4C,cAAc,EAAE,CAAC;AAAA,IAC/D;AAAA,EACF;AAEA,MAAI,SAAS,IAAI;AACf,WAAO,EAAE,OAAO,KAAK;AAAA,EACvB;AAEA,QAAM,SAAS,OAAO,OAAQ,QAAQ,MAAM,IAAK,IAAK,QAAQ,IAAK,IAAI;AACvE,MAAI,CAAC,OAAO,SAAS,MAAM,GAAG;AAC5B,UAAM;AAAA,MACJ,iDAAiD,MAAM;AAAA,IACzD;AAAA,EACF;AACA,SAAO,EAAE,OAAO,QAAQ,MAAM,GAAG;AACnC;AAEA,SAAS,gBAAgB,QAAiC;AACxD,SAAO,IAAI;AAAA,IACT;AAAA,IACA,uBAAuB,MAAM;AAAA,EAC/B;AACF;","names":[]}

package/dist/validation.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/validation.ts"],"sourcesContent":["import {\n  type ParseResult,\n  quote,\n  RecipeBookError,\n  type RecipeIssue,\n  type RecipeIssueCode,\n  truncate,\n  type ValidationErrorCode,\n} from './errors'\nimport { hasOwn, isRecord, issue, type Path, warning } from './issues'\nimport { closestMatch } from './suggest'\n\n// Only parsing and fromJsonLd use this module. Nothing React's imports from core\n// load may import it, or every page with React parts loads it once any page\n// parses. scripts/check-parser-split.js checks this.\n\n/** Thrown, or returned by the `parse*` functions, when data fails validation. */\nexport class RecipeValidationError extends RecipeBookError {\n  declare readonly code: ValidationErrorCode\n  /**\n   * Every problem found, errors and warnings, in a stable order: fields in\n   * model order (recipe fields, ingredients, steps, notes, equipment, then\n   * nutrition), list items in input order, and unknown fields last within\n   * their object.\n   */\n  declare readonly issues: readonly RecipeIssue[]\n\n  /**\n   * @param subject - What was validated, shown as given at the start of the\n   *   message, e.g. `'\"Buttermilk pancakes\"'`. Recipe Book's own errors quote\n   *   the recipe's name or the input text like a JSON string, cut with \"…\"\n   *   when longer than 60 UTF-16 code units.\n   */\n  constructor(\n    code: ValidationErrorCode,\n    issues: readonly RecipeIssue[],\n    subject = code === 'invalid_recipe'\n      ? 'Recipe'\n      : code === 'invalid_quantity'\n        ? 'Quantity'\n        : 'Ingredient',\n  ) {\n    super(code, summarize(subject, issues))\n    // The base class declares `name` readonly.\n    Object.assign(this, { name: 'RecipeValidationError' })\n    this.issues = issues\n  }\n}\n\n// Messages end up in logs, so they stay bounded however large the input is.\nconst MAX_LISTED = 10\n// Keys in paths come from input, so only ASCII identifiers print bare. Others\n// print quoted, so `[\"a.b\"]` and look-alikes such as `bakeꓸtime` can't pass for nesting.\nconst IDENTIFIER = /^[A-Za-z_$][\\w$]*$/\n\nfunction summarize(subject: string, issues: readonly RecipeIssue[]): string {\n  const count = issues.length\n  const header = `${subject} has ${count} ${count === 1 ? 'problem' : 'problems'}:`\n  const listed = issues.slice(0, MAX_LISTED)\n  const paths = listed.map((issue) => formatPath(issue.path))\n  const width = Math.max(0, ...paths.map((path) => path.length))\n  const lines = listed.map(\n    (issue, i) =>\n      `  ${issue.severity === 'error' ? '✖' : '⚠'} ${paths[i]!.padEnd(width)}  ${issue.message}`,\n  )\n\n  if (count > listed.length) {\n    lines.push(\n      `  …and ${count - listed.length} more. error.issues lists them all.`,\n    )\n  }\n\n  return [header, ...lines].join('\\n')\n}\n\nfunction formatPath(path: readonly (string | number)[]): string {\n  if (path.length === 0) {\n    return '(root)'\n  }\n\n  return path.reduce<string>(\n    (text, segment) =>\n      typeof segment === 'number'\n        ? `${text}[${segment}]`\n        : IDENTIFIER.test(segment)\n          ? text\n            ? `${text}.${truncate(segment)}`\n            : truncate(segment)\n          : `${text}[${quote(segment)}]`,\n    '',\n  )\n}\n\n/** Records an error and returns `undefined`, so readers can `return error(...)`. */\nexport function error(\n  issues: RecipeIssue[],\n  code: RecipeIssueCode,\n  path: Path,\n  message: string,\n  suggestion?: string,\n): undefined {\n  issues.push(issue('error', code, path, message, suggestion))\n  return undefined\n}\n\nexport function toResult<T>(\n  code: RecipeValidationError['code'],\n  data: T | undefined,\n  issues: RecipeIssue[],\n  subject?: string,\n): ParseResult<T> {\n  if (\n    data === undefined ||\n    issues.some((issue) => issue.severity === 'error')\n  ) {\n    return {\n      success: false,\n      error: new RecipeValidationError(code, issues, subject),\n    }\n  }\n\n  return { success: true, data, warnings: issues }\n}\n\n/**\n * A copy of an object's own enumerable fields on a null prototype, so fields\n * inherited from a prototype, including a polluted `Object.prototype`, are never read.\n */\nexport function asRecord(value: unknown): Record<string, unknown> | undefined {\n  return isRecord(value)\n    ? Object.assign(Object.create(null) as Record<string, unknown>, value)\n    : undefined\n}\n\n/** The known keys of `T`. The type makes the compiler check that none is missing or extra. */\nexport type Fields<T> = { readonly [K in keyof T]-?: true }\n\n/**\n * Warns about each key of `record` that isn't in `fields`. Suggestions ignore\n * a trailing `Content`, so schema.org names such as `fatContent` suggest `fat`.\n */\nexport function checkFields(\n  issues: RecipeIssue[],\n  record: Record<string, unknown>,\n  fields: Readonly<Record<string, unknown>>,\n  path: Path,\n): void {\n  for (const key of Object.keys(record)) {\n    if (hasOwn(fields, key)) {\n      continue\n    }\n\n    const suggestion = closestMatch(\n      key.replace(/Content$/, ''),\n      Object.keys(fields),\n    )\n\n    warning(\n      issues,\n      'unknown_field',\n      [...path, key],\n      suggestion\n        ? `Unknown field. Did you mean \"${suggestion}\"?`\n        : 'Unknown field. It is ignored.',\n      suggestion,\n    )\n  }\n}\n"],"mappings":";AAAA;AAAA,EAEE;AAAA,EACA;AAAA,EAGA;AAAA,OAEK;AACP,SAAS,QAAQ,UAAU,OAAkB,eAAe;AAC5D,SAAS,oBAAoB;AAOtB,IAAM,wBAAN,cAAoC,gBAAgB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAgBzD,YACE,MACA,QACA,UAAU,SAAS,mBACf,WACA,SAAS,qBACP,aACA,cACN;AACA,UAAM,MAAM,UAAU,SAAS,MAAM,CAAC;AAEtC,WAAO,OAAO,MAAM,EAAE,MAAM,wBAAwB,CAAC;AACrD,SAAK,SAAS;AAAA,EAChB;AACF;AAGA,IAAM,aAAa;AAGnB,IAAM,aAAa;AAEnB,SAAS,UAAU,SAAiB,QAAwC;AAC1E,QAAM,QAAQ,OAAO;AACrB,QAAM,SAAS,GAAG,OAAO,QAAQ,KAAK,IAAI,UAAU,IAAI,YAAY,UAAU;AAC9E,QAAM,SAAS,OAAO,MAAM,GAAG,UAAU;AACzC,QAAM,QAAQ,OAAO,IAAI,CAACA,WAAU,WAAWA,OAAM,IAAI,CAAC;AAC1D,QAAM,QAAQ,KAAK,IAAI,GAAG,GAAG,MAAM,IAAI,CAAC,SAAS,KAAK,MAAM,CAAC;AAC7D,QAAM,QAAQ,OAAO;AAAA,IACnB,CAACA,QAAO,MACN,KAAKA,OAAM,aAAa,UAAU,WAAM,QAAG,IAAI,MAAM,CAAC,EAAG,OAAO,KAAK,CAAC,KAAKA,OAAM,OAAO;AAAA,EAC5F;AAEA,MAAI,QAAQ,OAAO,QAAQ;AACzB,UAAM;AAAA,MACJ,eAAU,QAAQ,OAAO,MAAM;AAAA,IACjC;AAAA,EACF;AAEA,SAAO,CAAC,QAAQ,GAAG,KAAK,EAAE,KAAK,IAAI;AACrC;AAEA,SAAS,WAAW,MAA4C;AAC9D,MAAI,KAAK,WAAW,GAAG;AACrB,WAAO;AAAA,EACT;AAEA,SAAO,KAAK;AAAA,IACV,CAAC,MAAM,YACL,OAAO,YAAY,WACf,GAAG,IAAI,IAAI,OAAO,MAClB,WAAW,KAAK,OAAO,IACrB,OACE,GAAG,IAAI,IAAI,SAAS,OAAO,CAAC,KAC5B,SAAS,OAAO,IAClB,GAAG,IAAI,IAAI,MAAM,OAAO,CAAC;AAAA,IACjC;AAAA,EACF;AACF;AAGO,SAAS,MACd,QACA,MACA,MACA,SACA,YACW;AACX,SAAO,KAAK,MAAM,SAAS,MAAM,MAAM,SAAS,UAAU,CAAC;AAC3D,SAAO;AACT;AAEO,SAAS,SACd,MACA,MACA,QACA,SACgB;AAChB,MACE,SAAS,UACT,OAAO,KAAK,CAACA,WAAUA,OAAM,aAAa,OAAO,GACjD;AACA,WAAO;AAAA,MACL,SAAS;AAAA,MACT,OAAO,IAAI,sBAAsB,MAAM,QAAQ,OAAO;AAAA,IACxD;AAAA,EACF;AAEA,SAAO,EAAE,SAAS,MAAM,MAAM,UAAU,OAAO;AACjD;AAMO,SAAS,SAAS,OAAqD;AAC5E,SAAO,SAAS,KAAK,IACjB,OAAO,OAAO,uBAAO,OAAO,IAAI,GAA8B,KAAK,IACnE;AACN;AASO,SAAS,YACd,QACA,QACA,QACA,MACM;AACN,aAAW,OAAO,OAAO,KAAK,MAAM,GAAG;AACrC,QAAI,OAAO,QAAQ,GAAG,GAAG;AACvB;AAAA,IACF;AAEA,UAAM,aAAa;AAAA,MACjB,IAAI,QAAQ,YAAY,EAAE;AAAA,MAC1B,OAAO,KAAK,MAAM;AAAA,IACpB;AAEA;AAAA,MACE;AAAA,MACA;AAAA,MACA,CAAC,GAAG,MAAM,GAAG;AAAA,MACb,aACI,gCAAgC,UAAU,OAC1C;AAAA,MACJ;AAAA,IACF;AAAA,EACF;AACF;","names":["issue"]}
+{"version":3,"sources":["../src/validation.ts"],"sourcesContent":["import {\n  type ParseResult,\n  quote,\n  RecipeBookError,\n  type RecipeIssue,\n  type RecipeIssueCode,\n  truncate,\n  type ValidationErrorCode,\n} from './errors'\nimport { hasOwn, isRecord, issue, type Path, warning } from './issues'\nimport { closestMatch } from './suggest'\n\n// Only parsing and fromJsonLd use this module. Nothing React's imports from core\n// load may import it, or every page with React parts loads it once any page\n// parses. scripts/check-parser-split.js checks this.\n\n/**\n * Thrown, or returned by the `parse*` functions, when data fails validation.\n *\n * Use `isRecipeValidationError` rather than `instanceof` to detect it, so the\n * check also works when two copies of the package are installed.\n */\nexport class RecipeValidationError extends RecipeBookError {\n  declare readonly code: ValidationErrorCode\n  /**\n   * Every problem found, errors and warnings, in a stable order: fields in\n   * model order (recipe fields, ingredients, steps, notes, equipment, then\n   * nutrition), list items in input order, and unknown fields last within\n   * their object.\n   */\n  declare readonly issues: readonly RecipeIssue[]\n\n  /**\n   * @param subject - What was validated, shown as given at the start of the\n   *   message, e.g. `'\"Buttermilk pancakes\"'`. Recipe Book's own errors quote\n   *   the recipe's name or the input text like a JSON string, cut with \"…\"\n   *   when longer than 60 UTF-16 code units.\n   */\n  constructor(\n    code: ValidationErrorCode,\n    issues: readonly RecipeIssue[],\n    subject = code === 'invalid_recipe'\n      ? 'Recipe'\n      : code === 'invalid_quantity'\n        ? 'Quantity'\n        : 'Ingredient',\n  ) {\n    super(code, summarize(subject, issues))\n    // The base class declares `name` readonly.\n    Object.assign(this, { name: 'RecipeValidationError' })\n    this.issues = issues\n  }\n}\n\n// Messages end up in logs, so they stay bounded however large the input is.\nconst MAX_LISTED = 10\n// Keys in paths come from input, so only ASCII identifiers print bare. Others\n// print quoted, so `[\"a.b\"]` and look-alikes such as `bakeꓸtime` can't pass for nesting.\nconst IDENTIFIER = /^[A-Za-z_$][\\w$]*$/\n\nfunction summarize(subject: string, issues: readonly RecipeIssue[]): string {\n  const count = issues.length\n  const header = `${subject} has ${count} ${count === 1 ? 'problem' : 'problems'}:`\n  const listed = issues.slice(0, MAX_LISTED)\n  const paths = listed.map((issue) => formatPath(issue.path))\n  const width = Math.max(0, ...paths.map((path) => path.length))\n  const lines = listed.map(\n    (issue, i) =>\n      `  ${issue.severity === 'error' ? '✖' : '⚠'} ${paths[i]!.padEnd(width)}  ${issue.message}`,\n  )\n\n  if (count > listed.length) {\n    lines.push(\n      `  …and ${count - listed.length} more. error.issues lists them all.`,\n    )\n  }\n\n  return [header, ...lines].join('\\n')\n}\n\nfunction formatPath(path: readonly (string | number)[]): string {\n  if (path.length === 0) {\n    return '(root)'\n  }\n\n  return path.reduce<string>(\n    (text, segment) =>\n      typeof segment === 'number'\n        ? `${text}[${segment}]`\n        : IDENTIFIER.test(segment)\n          ? text\n            ? `${text}.${truncate(segment)}`\n            : truncate(segment)\n          : `${text}[${quote(segment)}]`,\n    '',\n  )\n}\n\n/** Records an error and returns `undefined`, so readers can `return error(...)`. */\nexport function error(\n  issues: RecipeIssue[],\n  code: RecipeIssueCode,\n  path: Path,\n  message: string,\n  suggestion?: string,\n): undefined {\n  issues.push(issue('error', code, path, message, suggestion))\n  return undefined\n}\n\nexport function toResult<T>(\n  code: RecipeValidationError['code'],\n  data: T | undefined,\n  issues: RecipeIssue[],\n  subject?: string,\n): ParseResult<T> {\n  if (\n    data === undefined ||\n    issues.some((issue) => issue.severity === 'error')\n  ) {\n    return {\n      success: false,\n      error: new RecipeValidationError(code, issues, subject),\n    }\n  }\n\n  return { success: true, data, warnings: issues }\n}\n\n/**\n * A copy of an object's own enumerable fields on a null prototype, so fields\n * inherited from a prototype, including a polluted `Object.prototype`, are never read.\n */\nexport function asRecord(value: unknown): Record<string, unknown> | undefined {\n  return isRecord(value)\n    ? Object.assign(Object.create(null) as Record<string, unknown>, value)\n    : undefined\n}\n\n/** The known keys of `T`. The type makes the compiler check that none is missing or extra. */\nexport type Fields<T> = { readonly [K in keyof T]-?: true }\n\n/**\n * Warns about each key of `record` that isn't in `fields`. Suggestions ignore\n * a trailing `Content`, so schema.org names such as `fatContent` suggest `fat`.\n */\nexport function checkFields(\n  issues: RecipeIssue[],\n  record: Record<string, unknown>,\n  fields: Readonly<Record<string, unknown>>,\n  path: Path,\n): void {\n  for (const key of Object.keys(record)) {\n    if (hasOwn(fields, key)) {\n      continue\n    }\n\n    const suggestion = closestMatch(\n      key.replace(/Content$/, ''),\n      Object.keys(fields),\n    )\n\n    warning(\n      issues,\n      'unknown_field',\n      [...path, key],\n      suggestion\n        ? `Unknown field. Did you mean \"${suggestion}\"?`\n        : 'Unknown field. It is ignored.',\n      suggestion,\n    )\n  }\n}\n"],"mappings":";AAAA;AAAA,EAEE;AAAA,EACA;AAAA,EAGA;AAAA,OAEK;AACP,SAAS,QAAQ,UAAU,OAAkB,eAAe;AAC5D,SAAS,oBAAoB;AAYtB,IAAM,wBAAN,cAAoC,gBAAgB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAgBzD,YACE,MACA,QACA,UAAU,SAAS,mBACf,WACA,SAAS,qBACP,aACA,cACN;AACA,UAAM,MAAM,UAAU,SAAS,MAAM,CAAC;AAEtC,WAAO,OAAO,MAAM,EAAE,MAAM,wBAAwB,CAAC;AACrD,SAAK,SAAS;AAAA,EAChB;AACF;AAGA,IAAM,aAAa;AAGnB,IAAM,aAAa;AAEnB,SAAS,UAAU,SAAiB,QAAwC;AAC1E,QAAM,QAAQ,OAAO;AACrB,QAAM,SAAS,GAAG,OAAO,QAAQ,KAAK,IAAI,UAAU,IAAI,YAAY,UAAU;AAC9E,QAAM,SAAS,OAAO,MAAM,GAAG,UAAU;AACzC,QAAM,QAAQ,OAAO,IAAI,CAACA,WAAU,WAAWA,OAAM,IAAI,CAAC;AAC1D,QAAM,QAAQ,KAAK,IAAI,GAAG,GAAG,MAAM,IAAI,CAAC,SAAS,KAAK,MAAM,CAAC;AAC7D,QAAM,QAAQ,OAAO;AAAA,IACnB,CAACA,QAAO,MACN,KAAKA,OAAM,aAAa,UAAU,WAAM,QAAG,IAAI,MAAM,CAAC,EAAG,OAAO,KAAK,CAAC,KAAKA,OAAM,OAAO;AAAA,EAC5F;AAEA,MAAI,QAAQ,OAAO,QAAQ;AACzB,UAAM;AAAA,MACJ,eAAU,QAAQ,OAAO,MAAM;AAAA,IACjC;AAAA,EACF;AAEA,SAAO,CAAC,QAAQ,GAAG,KAAK,EAAE,KAAK,IAAI;AACrC;AAEA,SAAS,WAAW,MAA4C;AAC9D,MAAI,KAAK,WAAW,GAAG;AACrB,WAAO;AAAA,EACT;AAEA,SAAO,KAAK;AAAA,IACV,CAAC,MAAM,YACL,OAAO,YAAY,WACf,GAAG,IAAI,IAAI,OAAO,MAClB,WAAW,KAAK,OAAO,IACrB,OACE,GAAG,IAAI,IAAI,SAAS,OAAO,CAAC,KAC5B,SAAS,OAAO,IAClB,GAAG,IAAI,IAAI,MAAM,OAAO,CAAC;AAAA,IACjC;AAAA,EACF;AACF;AAGO,SAAS,MACd,QACA,MACA,MACA,SACA,YACW;AACX,SAAO,KAAK,MAAM,SAAS,MAAM,MAAM,SAAS,UAAU,CAAC;AAC3D,SAAO;AACT;AAEO,SAAS,SACd,MACA,MACA,QACA,SACgB;AAChB,MACE,SAAS,UACT,OAAO,KAAK,CAACA,WAAUA,OAAM,aAAa,OAAO,GACjD;AACA,WAAO;AAAA,MACL,SAAS;AAAA,MACT,OAAO,IAAI,sBAAsB,MAAM,QAAQ,OAAO;AAAA,IACxD;AAAA,EACF;AAEA,SAAO,EAAE,SAAS,MAAM,MAAM,UAAU,OAAO;AACjD;AAMO,SAAS,SAAS,OAAqD;AAC5E,SAAO,SAAS,KAAK,IACjB,OAAO,OAAO,uBAAO,OAAO,IAAI,GAA8B,KAAK,IACnE;AACN;AASO,SAAS,YACd,QACA,QACA,QACA,MACM;AACN,aAAW,OAAO,OAAO,KAAK,MAAM,GAAG;AACrC,QAAI,OAAO,QAAQ,GAAG,GAAG;AACvB;AAAA,IACF;AAEA,UAAM,aAAa;AAAA,MACjB,IAAI,QAAQ,YAAY,EAAE;AAAA,MAC1B,OAAO,KAAK,MAAM;AAAA,IACpB;AAEA;AAAA,MACE;AAAA,MACA;AAAA,MACA,CAAC,GAAG,MAAM,GAAG;AAAA,MACb,aACI,gCAAgC,UAAU,OAC1C;AAAA,MACJ;AAAA,IACF;AAAA,EACF;AACF;","names":["issue"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@recipe-book/core",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Framework-agnostic recipe parsing, scaling, unit conversion and formatting.",
   "homepage": "https://recipe-book.siraj.page",
   "license": "MIT",