comments for world:targets (#312)

* docs for world:targets

* Update src/jecs.d.ts

Co-authored-by: dai <contact@daimond113.com>

* remove world:targets() mention in 042_target.luau

* ensure doc comments are same across files

---------

Co-authored-by: dai <contact@daimond113.com>

Author: kurokuukyo

src/jecs.d.ts

@@ -155,6 +155,14 @@ export class World {
 	 */
 	target(entity: Entity, relation: Entity, index?: number): Entity | undefined;
 
+	/**
+	 * Gets an iterator for all targets of a relationship.
+	 * Returns an empty iterator if no matches are found.
+	 * @param entity The entity using a relationship pair.
+	 * @param relation The "relationship" component/tag
+	 */
+	targets(entity: Entity, relation: Entity): IterFn<[]>
+
 	/**
 	 * Deletes an entity (and its components/relationships) from the world entirely.
 	 * @param entity The entity to delete.

src/jecs.luau

@@ -254,7 +254,8 @@ export type World = {
 		index: number?
 	) -> Entity<unknown>?,
 
-	-- Gets an iterator for all viable targets of a relationship
+	-- Gets an iterator for all targets of a relationship.
+	-- Returns an empty iterator if no matches are found.
 	targets: <T>(
 		self: World,
 		id: Entity<T> | number,