Add expression intensity controls

README.md

@@ -127,6 +127,11 @@ Options:
 - `softcore_level`: `social_tease`, `lingerie_tease`, `implied_nude`, or
   `explicit_tease`.
 - `hardcore_level`: `explicit` or `hardcore`.
+- `softcore_expression_intensity`: `0.0` is mild/controlled, `0.5` is sensual,
+  `1.0` strongly favors more heated softcore faces.
+- `hardcore_expression_intensity`: `0.0` is controlled, `0.5` is balanced
+  hardcore, `1.0` strongly favors ahegao-style, drooling, fucked-out, climax,
+  and messy orgasm expressions.
 - `platform_style`: `hybrid`, `instagram`, or `onlyfans`.
 - `continuity`: `same_creator_same_room` keeps the scene/composition aligned;
   `same_creator_new_scene` keeps the same creator descriptor but lets the
@@ -144,6 +149,11 @@ The node keeps the original generator controls:
 - `minimal_clothing_ratio`: `-1` disables mixing; `0.0` to `1.0` mixes minimal/full clothing.
 - `ethnicity`: `any`, `asian`, `white_asian`.
 - `poses`: `standard` or `evocative`.
+- `expression_intensity`: `0.0` favors mild, neutral, controlled expressions;
+  `0.5` favors balanced category expressions; `1.0` strongly favors the most
+  intense expressions available in the selected category. This affects custom
+  JSON categories such as `Provocative erotic clothes` and `Hardcore sexual
+  poses`.
 - `standard_pose_ratio`: `-1` disables mixing; `0.0` to `1.0` mixes standard/evocative poses.
 - `backside_bias`: `0.0` to `1.0`, applies to evocative single-subject poses.
 - `figure`: `curvy`, `balanced`, `bombshell`.
@@ -210,22 +220,36 @@ provided, the node uses a generic composer that selects subject appearance,
 scene, pose, expression, composition, and a random item from the selected
 subcategory.
 
-Reusable location banks can be defined with top-level `scene_pools` in any
-`categories/*.json` file. Categories, subcategories, and items can reference
-them with `scene_pools`; referenced pools are merged with any local `scenes`.
-This keeps location expansion scalable without duplicating the same bedroom,
-selfie, mirror, creator, or group-sex locations across every subcategory.
+Reusable banks can be defined with top-level `scene_pools`,
+`expression_pools`, and `composition_pools` in any `categories/*.json` file.
+Categories, subcategories, and items can reference them with `scene_pools`,
+`expression_pools`, and `composition_pools`; referenced pools are merged with
+any local `scenes`, `expressions`, or `compositions`. This keeps expansion
+scalable without duplicating the same bedroom, selfie, mirror, creator,
+expression, camera, or group-sex framing across every subcategory.
 
-Set `"inherit_scenes": false` on a subcategory or item when it should use only
-its own `scenes` and `scene_pools` instead of also inheriting parent category
-locations. This is useful for narrow subcategories such as group scenes, vehicle
-sets, outdoor-only sets, or any category where a generic parent room would be a
-bad match.
+Set `"inherit_scenes": false`, `"inherit_expressions": false`, or
+`"inherit_compositions": false` on a subcategory or item when it should use only
+its own pools instead of also inheriting parent category values. This is useful
+for narrow subcategories such as group scenes, fetish sets, outdoor-only sets,
+or any category where generic parent wording would be a bad match.
 
 Example:
 
 ```json
 {
+  "expression_pools": {
+    "creator_tease_faces": [
+      "direct creator-shot eye contact",
+      "heavy-lidded bedroom gaze"
+    ]
+  },
+  "composition_pools": {
+    "creator_selfie_frames": [
+      "handheld selfie crop from face to hips",
+      "mirror selfie with phone visible and body framed clearly"
+    ]
+  },
   "scene_pools": {
     "creator_selfie_rooms": [
       {
@@ -241,7 +265,11 @@ Example:
         {
           "name": "Selfie set",
           "inherit_scenes": false,
+          "inherit_expressions": false,
+          "inherit_compositions": false,
           "scene_pools": ["creator_selfie_rooms"],
+          "expression_pools": ["creator_tease_faces"],
+          "composition_pools": ["creator_selfie_frames"],
           "items": ["simple outfit prompt"]
         }
       ]