feat(bindings): expose recipe reference fields for ingredients

Add RecipeReference struct to bindings with name and components fields,
allowing consumers to access recipe dependencies when an ingredient
references another recipe file (e.g., @./pasta/spaghetti).

Author: dubadub

bindings/src/lib.rs

@@ -581,7 +581,8 @@ a test @step @salt{1%mg} more text
                     quantity: Value::Number { value: 1.0 },
                     units: Some("mg".to_string())
                 }),
-                descriptor: None
+                descriptor: None,
+                reference: None
             })
         );
 
@@ -619,15 +620,17 @@ a test @step @salt{1%mg} more text
                 Ingredient {
                     name: "step".to_string(),
                     amount: None,
-                    descriptor: None
+                    descriptor: None,
+                    reference: None
                 },
                 Ingredient {
                     name: "salt".to_string(),
                     amount: Some(Amount {
                         quantity: Value::Number { value: 1.0 },
                         units: Some("mg".to_string())
                     }),
-                    descriptor: None
+                    descriptor: None,
+                    reference: None
                 },
             ]
         );
@@ -809,6 +812,7 @@ dried oregano
                     units: Some("g".to_string()),
                 }),
                 descriptor: None,
+                reference: None,
             },
             Ingredient {
                 name: "pepper".to_string(),
@@ -817,6 +821,7 @@ dried oregano
                     units: Some("mg".to_string()),
                 }),
                 descriptor: None,
+                reference: None,
             },
             Ingredient {
                 name: "salt".to_string(),
@@ -825,6 +830,7 @@ dried oregano
                     units: Some("kg".to_string()),
                 }),
                 descriptor: None,
+                reference: None,
             },
             Ingredient {
                 name: "pepper".to_string(),
@@ -833,6 +839,7 @@ dried oregano
                     units: Some("tsp".to_string()),
                 }),
                 descriptor: None,
+                reference: None,
             },
         ];
 
@@ -1212,4 +1219,31 @@ Combine @cheese{100%g} and @spinach{50%g}, then season to taste.
             }
         );
     }
+
+    #[test]
+    fn test_recipe_reference() {
+        use crate::{parse_recipe, RecipeReference};
+
+        let recipe = parse_recipe(
+            r#"
+Serve the @./pasta/spaghetti{1%portion} with sauce
+"#
+            .to_string(),
+            1.0,
+        );
+
+        let ingredient = recipe
+            .ingredients
+            .get(0)
+            .expect("No ingredients found");
+
+        assert_eq!(ingredient.name, "spaghetti");
+        assert_eq!(
+            ingredient.reference,
+            Some(RecipeReference {
+                name: "spaghetti".to_string(),
+                components: vec![".".to_string(), "pasta".to_string()],
+            })
+        );
+    }
 }

bindings/src/model.rs

@@ -4,7 +4,7 @@ use cooklang::metadata::{
     NameAndUrl as OriginalNameAndUrl, RecipeTime as OriginalRecipeTime,
     Servings as OriginalServings, StdKey as OriginalStdKey,
 };
-use cooklang::model::Item as OriginalItem;
+use cooklang::model::{Item as OriginalItem, RecipeReference as OriginalRecipeReference};
 use cooklang::quantity::{Quantity as OriginalQuantity, Value as OriginalValue};
 use cooklang::Recipe as OriginalRecipe;
 
@@ -84,12 +84,39 @@ pub struct BlockNote {
     pub text: String,
 }
 
+/// Represents a reference to another recipe file
+#[derive(uniffi::Record, Debug, PartialEq, Clone)]
+pub struct RecipeReference {
+    /// The recipe file name (without directory path)
+    pub name: String,
+    /// Directory path components (e.g., [".", "pasta"] for "./pasta/recipe")
+    pub components: Vec<String>,
+}
+
+impl RecipeReference {
+    /// Returns the full path as a string with the given separator
+    pub fn path(&self, separator: &str) -> String {
+        self.components.join(separator) + separator + &self.name
+    }
+}
+
+impl From<&OriginalRecipeReference> for RecipeReference {
+    fn from(reference: &OriginalRecipeReference) -> Self {
+        RecipeReference {
+            name: reference.name.clone(),
+            components: reference.components.clone(),
+        }
+    }
+}
+
 /// Represents an ingredient in the recipe
 #[derive(uniffi::Record, Debug, PartialEq, Clone)]
 pub struct Ingredient {
     pub name: String,
     pub amount: Option<Amount>,
     pub descriptor: Option<String>,
+    /// Reference to another recipe file, if this ingredient is a recipe reference
+    pub reference: Option<RecipeReference>,
 }
 
 /// Represents a piece of cookware used in the recipe
@@ -556,6 +583,7 @@ impl From<&cooklang::Ingredient> for Ingredient {
             name: ingredient.name.clone(),
             amount: ingredient.quantity.as_ref().map(|q| q.extract_amount()),
             descriptor: ingredient.note.clone(),
+            reference: ingredient.reference.as_ref().map(|r| r.into()),
         }
     }
 }