Rename directory "engines" to "languages"

languages/chef/parser/regex.ts

@@ -0,0 +1,160 @@
+/**
+ * For each regular expression below:
+ * - Doc comments include the details of each capture group in the regex.
+ * - Regex comments provide a little overview of the regex, where
+ *   [...] denotes optional clause, <...> denotes capture group.
+ */
+
+/**
+ * Regular expression for `Take ingredient from refrigerator` op
+ * Capture groups:
+ * 1. **Ingredient name**: string with letters and spaces
+ */
+export const TakeFromFridgeRegex =
+  /**    <Ingredient>                   */
+  /^Take ([a-zA-Z ]+?) from(?: the)? refrigerator$/;
+
+/**
+ * Regular expression for `Put ingredient into nth bowl` op
+ * Capture groups:
+ * 1. **Ingredient name**: string with letters and spaces
+ * 2. **Mixing bowl index** (optional): integer
+ */
+export const PutInBowlRegex =
+  /**             <Ingredient>              [    <Bowl identifier>  ]             */
+  /^Put(?: the)? ([a-zA-Z ]+?) into(?: the)?(?: (\d+)(?:nd|rd|th|st))? mixing bowl$/;
+
+/**
+ * Regular expression for `Fold ingredient into nth bowl` op
+ * Capture groups:
+ * 1. **Ingredient name**: string with letters and spaces
+ * 2. **Mixing bowl index** (optional): integer
+ */
+export const FoldIntoBowlRegex =
+  /**             <Ingredient>               [    <Bowl identifier>  ]             */
+  /^Fold(?: the)? ([a-zA-Z ]+?) into(?: the)?(?: (\d+)(?:nd|rd|th|st))? mixing bowl$/;
+
+/**
+ * Regular expression to match the four main arithmetic operations in Chef.
+ * Capture groups:
+ * 1. **Operation name**: `"Add" | "Remove" | "Combine" | "Divide"`
+ * 2. **Ingredient name**: string with letters and spaces
+ * 3. **Proverb** (optional): `"to" | "into" | "from"`
+ * 4. **Mixing bowl index** (optional): integer
+ */
+export const ArithmeticOpRegex =
+  /**    <Operation name>       <Ingredient> [     <Proverb>            [    <Bowl identifier>  ]             ] */
+  /^(Add|Remove|Combine|Divide) ([a-zA-Z ]+?)(?: (to|into|from)(?: the)?(?: (\d+)(?:nd|rd|th|st))? mixing bowl)?$/;
+
+/**
+ * Regular expression for the `Add dry ingredients ...` op.
+ * Capture groups:
+ * 1. **Mixing bowl index** (optional): integer
+ */
+export const AddDryIngsOpRegex =
+  /**                  [              [    <Bowl identifier>  ]             ] */
+  /^Add dry ingredients(?: to(?: the)?(?: (\d+)(?:nd|rd|th|st))? mixing bowl)?$/;
+
+/**
+ * Regular expression for the `Liquefy contents` op
+ * Capture groups:
+ * 1. **Mixing bowl index** (optional): integer
+ */
+export const LiquefyBowlRegex =
+  /**                      [     <Bowl identifier> ]             */
+  /^Liquefy(?: the)? contents of the(?: (\d+)(?:nd|rd|th|st))? mixing bowl$/;
+
+/**
+ * Regular expression for the `Liquefy ingredient` op
+ * Capture groups:
+ * 1. **Ingredient name**: string with letters and spaces
+ */
+export const LiquefyIngRegex =
+  /**                <Ingredient> */
+  /^Liquefy(?: the)? ([a-zA-Z ]+?)$/;
+
+/**
+ * Regular expression to match the `Stir <bowl> for <n> minutes` op.
+ * Capture groups:
+ * 1. **Mixing bowl index** (optional): integer
+ * 2. **Number of mins**: integer
+ */
+export const StirBowlRegex =
+  /**   [      [     <Bowl identifier> ]?            ]?   <Number>        */
+  /^Stir(?: the(?: (\d+)(?:nd|rd|th|st))? mixing bowl)? for (\d+) minutes?$/;
+
+/**
+ * Regular expression to match the `Stir <ingredient> into [nth] mixing bowl` op.
+ * Capture groups:
+ * 1. **Ingredient name**: string with letters and spaces
+ * 2. **Mixing bowl index** (optional): integer
+ */
+export const StirIngredientRegex =
+  /**    <Ingredient>          [  <Bowl identifier>    ]             */
+  /^Stir ([a-zA-Z ]+?) into the(?: (\d+)(?:nd|rd|th|st))? mixing bowl$/;
+
+/**
+ * Regular expression to match the `Mix [the [nth] mixing bowl] well` op.
+ * Capture groups:
+ * 1. **Mixing bowl index** (optional): integer
+ */
+export const MixBowlRegex =
+  /**  [      [     <Bowl identifier> ]?            ]?     */
+  /^Mix(?: the(?: (\d+)(?:nd|rd|th|st))? mixing bowl)? well$/;
+
+/**
+ * Regular expression for the `Clean bowl` op
+ * Capture groups:
+ * 1. **Mixing bowl index** (optional): integer
+ */
+export const CleanBowlRegex =
+  /**             [    <Bowl identifier>  ]             */
+  /^Clean(?: the)?(?: (\d+)(?:nd|rd|th|st))? mixing bowl$/;
+
+/**
+ * Regular expression to match the `Pour ...` op.
+ * Capture groups:
+ * 1. **Mixing bowl index** (optional): integer
+ * 2. **Baking dish index** (optional): integer
+ */
+export const PourBowlRegex =
+  /**                   [     <Bowl identifier> ]?                     [     <Bowl identifier> ]?            */
+  /^Pour contents of the(?: (\d+)(?:nd|rd|th|st))? mixing bowl into the(?: (\d+)(?:nd|rd|th|st))? baking dish$/;
+
+/**
+ * Regular expression to match the `Serve with` op.
+ * Capture groups:
+ * 1. **Name of aux recipe**: string with alphanumerics and spaces
+ */
+export const ServeWithRegex =
+  /**           <aux recipe>  */
+  /^Serve with ([a-zA-Z0-9 ]+)$/;
+
+/**
+ * Regular expression to match the `Refrigerate` op.
+ * Capture groups:
+ * 1. **Number of hours** (optional): integer
+ */
+export const RefrigerateRegex =
+  /**          [   <num of hours> ] */
+  /^Refrigerate(?: for (\d+) hours?)?$/;
+
+/**
+ * Regular expression to match the `Verb the ingredient` op.
+ * Capture groups:
+ * 1. **Verb**: string with letters
+ * 2. **Ingredient name**: string with letters and spaces
+ */
+export const LoopOpenerRegex =
+  /** <Verb>             <Ingredient> */
+  /^([a-zA-Z]+?)(?: the)? ([a-zA-Z ]+)$/;
+
+/**
+ * Regular expression to match the `Verb [the ing] until verbed` op.
+ * Capture groups:
+ * 1. **Ingredient name** (optional): string with letters and spaces
+ * 2. **Matched verb**: string with letters
+ */
+export const LoopEnderRegex =
+  /**   Verb      [       <Ingredient> ]        <Verbed>  */
+  /^(?:[a-zA-Z]+?)(?: the)?(?: ([a-zA-Z ]+?))? until ([a-zA-Z]+)$/;