Extract outercourse role graph wording

hardcore_role_outercourse.py

@@ -0,0 +1,84 @@
+from __future__ import annotations
+
+from typing import Any
+
+
+def _context_text(item_text: str, item_axis_values: dict[str, Any] | None) -> str:
+    return " ".join(
+        str(part or "").lower()
+        for part in (
+            item_text,
+            *((item_axis_values or {}).values()),
+        )
+    )
+
+
+def build_outercourse_role_graph(
+    woman: str,
+    man: str,
+    item_text: str,
+    item_axis_values: dict[str, Any] | None = None,
+    pov_labels: list[str] | None = None,
+) -> str:
+    position_text = str((item_axis_values or {}).get("position") or "").lower()
+    text = _context_text(item_text, item_axis_values)
+    man_is_pov = man in set(pov_labels or [])
+    if any(term in text for term in ("boobjob", "titjob", "breast-sex", "breast sex")):
+        if man_is_pov:
+            return (
+                f"{woman} kneels between the POV viewer's open thighs with her torso bent forward over his pelvis and shoulders low, "
+                "both hands lifting and pressing her breasts tightly around the POV viewer's penis shaft while the glans sits just below her lips."
+            )
+        return (
+            f"{woman} kneels between {man}'s open thighs with her torso bent forward over his pelvis and shoulders low while {man} sits with legs apart, "
+            f"{woman}'s hands lifting and pressing her breasts tightly around {man}'s penis shaft while the glans sits just below her lips."
+        )
+    if any(term in text for term in ("testicle", "balls-licking", "balls licking", "balls and mouth", "balls held")):
+        if man_is_pov:
+            return (
+                f"{woman} kneels very low between the POV viewer's open thighs with her torso bent forward and shoulders between his knees, "
+                "head tucked under the penis shaft at the base of the penis, mouth and tongue on the POV viewer's balls while his penis points upward above her face."
+            )
+        return (
+            f"{man} sits with legs apart while {woman} kneels very low between his open thighs with her torso bent forward and shoulders between his knees, "
+            f"head tucked under the penis shaft at the base of his penis, mouth and tongue on his balls while {man}'s penis points upward above her face."
+        )
+    if "penis-licking" in position_text or "penis licking" in text or "tongue along" in text or "tongue licking" in text:
+        if man_is_pov:
+            return (
+                f"{woman} bends forward between the POV viewer's open thighs, head low under the POV viewer's penis with her face directly under the penis, "
+                "tongue running along the underside from the penis shaft to the glans while one hand steadies the base of the penis."
+            )
+        return (
+            f"{woman} bends forward between {man}'s open thighs, head low under {man}'s penis with her face directly under the penis, "
+            f"tongue running along the underside from the penis shaft to the glans while one hand steadies the base of the penis."
+        )
+    if "footjob" in text or "soles" in text or "toes curled" in text or "feet stroking" in text:
+        if man_is_pov:
+            return (
+                f"{woman} faces the POV viewer with her hips back, torso visible behind her raised legs, and both knees bent open toward the camera, "
+                "both soles wrapped around the POV viewer's penis shaft in the lower foreground."
+            )
+        return (
+            f"{man} reclines with hips forward while {woman} faces him with her hips back and both knees bent open, "
+            f"wrapping both soles around {man}'s penis shaft while the contact stays centered."
+        )
+    if "handjob" in position_text or "handjob" in text or "hand job" in text or "hand wrapped" in text:
+        if man_is_pov:
+            return (
+                f"{woman} kneels between the POV viewer's open thighs with her torso leaning forward and face visible behind the penis shaft, "
+                "one hand wrapped around the POV viewer's penis shaft while the other hand steadies the base of the penis as she strokes toward the glans."
+            )
+        return (
+            f"{woman} kneels between {man}'s open thighs with her torso leaning forward and face visible behind the penis shaft, "
+            f"one hand wrapped around {man}'s penis shaft while the other hand steadies the base of the penis as she strokes toward the glans."
+        )
+    if man_is_pov:
+        return (
+            f"{woman} kneels close to the POV viewer's hips and keeps the POV viewer's penis centered in clear non-penetrative contact, "
+            "with her mouth, hands, breasts, or feet visibly working around the penis shaft."
+        )
+    return (
+        f"{woman} kneels close to {man}'s hips and keeps {man}'s penis centered in clear non-penetrative contact, "
+        "with her mouth, hands, breasts, or feet visibly working around the penis shaft."
+    )