@nodaro/prompts 1.19.0 → 1.21.0

package/src/character-motion/dance.ts

@@ -0,0 +1,125 @@
+import type { CharacterMotion } from "./types.js"
+
+/** dance — authored motion fragments. Stable ids survive copy revisions. */
+export const DANCE_MOTIONS: ReadonlyArray<CharacterMotion> = [
+  { "id": "groove-hip-hop", "label": "Hip-hop groove", "category": "dance", "description": "Bounce and rock on the beat, arms loose",
+    "promptHint": "the subject settles into a hip-hop groove, knees bouncing on the beat, chest rocking back and forth, shoulders dipping alternately, weight shifting foot to foot while the arms swing loose", "term": "grooves to a hip-hop beat" },
+  { "id": "sway-to-music", "label": "Sway to the music", "category": "dance", "description": "Rock side to side in time, arms relaxed",
+    "promptHint": "the subject sways side to side to the music, weight rocking from one foot to the other, hips following, arms relaxed at the sides, head nodding in time with the beat", "term": "sways side to side to the music" },
+  { "id": "sway-arms-raised", "label": "Arms-up sway", "category": "dance", "description": "Both arms overhead, swaying with the rhythm",
+    "promptHint": "the subject raises both arms overhead and sways side to side, wrists loose, hips rocking with each shift of weight, eyes closing as the body moves with the rhythm", "term": "sways with both arms raised overhead" },
+  { "id": "clap-along", "label": "Clap along", "category": "dance", "description": "Claps on the count, body pulsing with it",
+    "promptHint": "the subject claps along to the beat, hands meeting at chest height on each count, elbows out, knees bouncing lightly so the whole body pulses with the rhythm", "term": "claps along to the beat" },
+  { "id": "two-step-side-to-side", "label": "Two-step", "category": "dance", "description": "Step out, touch, step back, touch, shoulders bobbing",
+    "promptHint": "the subject two-steps side to side, stepping one foot out and bringing the other to meet it with a touch, then repeating the other way, shoulders bobbing and arms swinging loosely", "term": "two-steps side to side" },
+  { "id": "grapevine-side-step", "label": "Grapevine", "category": "dance", "description": "Step side, cross behind, step side, touch",
+    "promptHint": "the subject grapevines sideways, stepping one foot to the side, crossing the other behind it, stepping side again and touching the free foot beside it, then repeating back the other way", "term": "grapevines side to side" },
+  { "id": "raise-the-roof", "label": "Raise the roof", "category": "dance", "description": "Palms push up overhead in pumps on the beat",
+    "promptHint": "the subject raises the roof, both palms pushing upward overhead in short pumps on each beat, elbows bending and straightening, knees bouncing along and head nodding", "term": "raises the roof" },
+  { "id": "slow-dance-close-hold", "label": "Slow dance", "category": "dance", "description": "Close hold, swaying together with a partner",
+    "promptHint": "the subject and the partner slow dance in a close hold, arms around each other's neck and waist, swaying side to side in small steps, foreheads nearly touching", "term": "slow dances close with the partner",
+    "twoPerson": true, "requires": ["partner"] },
+  { "id": "do-house-footwork", "label": "House footwork", "category": "dance", "description": "Tight skipping steps, torso jacking",
+    "promptHint": "the subject drops into house footwork, feet skipping and crossing in tight patterns under the body, heels lifting, the torso jacking forward and back while the arms stay loose", "term": "does house footwork with a jacking torso" },
+  { "id": "do-toprock", "label": "Toprock", "category": "dance", "description": "Standing breakdance steps before the drop",
+    "promptHint": "the subject dances a breakdance toprock, stepping one foot across the other in a cross-step, arms swinging wide, chest lifted, bouncing on the beat before dropping toward the floor", "term": "dances a breakdance toprock" },
+  { "id": "spin-into-windmill", "label": "Windmill", "category": "dance", "description": "Floor spin on the shoulders, legs whipping",
+    "promptHint": "the subject drops to the floor and rolls into a windmill, legs spread wide in a V and whipping around in circles as the body rotates on the upper back and shoulders", "term": "drops into a breakdance windmill" },
+  { "id": "spin-on-the-head", "label": "Headspin", "category": "dance", "description": "Inverted spin on the crown, legs open in a V",
+    "promptHint": "the subject kicks up into a headstand and spins on the crown of the head, legs opening wide in a V and hands pushing off the floor to drive the rotation", "term": "spins on the head with legs open" },
+  { "id": "hit-a-freeze", "label": "Hold an improvised breakdance freeze", "category": "dance", "description": "Holds a model-chosen breakdance balance; exact choreography is unspecified.",
+    "promptHint": "the subject holds an improvised breakdance freeze, showing clear stable contact between the supporting limbs and the floor; the exact balance is model-chosen", "term": "holds an improvised, floor-supported breakdance freeze",
+    "requires": ["floor"], "startPose": "floor", "endPose": "floor", "aliases": ["breakdance freeze", "Breakdance Freeze"] },
+  { "id": "do-the-worm", "label": "The worm", "category": "dance", "description": "Face-down ripple inching across the floor",
+    "promptHint": "the subject dives face-down to the floor and does the worm, a ripple rolling from the chest through the hips to the feet so the body inches forward across the floor in waves", "term": "does the worm across the floor" },
+  { "id": "hit-pops", "label": "Popping", "category": "dance", "description": "Sharp muscle hits that jolt the body",
+    "promptHint": "the subject dances popping, the chest, arms and legs contracting and releasing in sharp muscle hits on each beat so the body jolts and snaps between held positions", "term": "pops with sharp muscle hits" },
+  { "id": "roll-an-arm-wave", "label": "Arm wave", "category": "dance", "description": "Wave rolls from one hand across to the other",
+    "promptHint": "the subject sends a wave through the arms, the ripple starting at the fingertips of one hand, rolling through the wrist, elbow and shoulder, across the chest and out through the other arm to the fingertips", "term": "rolls an arm wave across the shoulders" },
+  { "id": "lock-and-point", "label": "Locking", "category": "dance", "description": "Wrist rolls, sharp locks and points",
+    "promptHint": "the subject dances locking, rolling the wrists in tight circles then freezing the arms in a bent-elbow lock, pointing out to the side, dipping into a knee squat and bouncing back upright", "term": "locks with wrist rolls and sharp points" },
+  { "id": "whip-arms-waacking", "label": "Waacking", "category": "dance", "description": "Arm whips around the head, dramatic poses",
+    "promptHint": "the subject waacks, whipping the arms over and around the head in sharp circular strikes from the shoulder, wrists flicking, posing dramatically between each strike with chest lifted", "term": "waacks with arm whips around the head" },
+  { "id": "strike-vogue-poses", "label": "Vogue", "category": "dance", "description": "Angular hand poses snapping to a dip",
+    "promptHint": "the subject vogues, framing the face with angular hand movements that snap from one pose to the next, arms hitting crisp lines, hips squared, then dropping into a dramatic dip", "term": "vogues with angular hand poses into a dip" },
+  { "id": "krump-and-stomp", "label": "Krump", "category": "dance", "description": "Stomps, arm strikes and chest pops",
+    "promptHint": "the subject krumps, stomping the feet hard, arms swinging in big aggressive strikes, chest popping outward on each hit, the whole body jerking and buckling with raw intensity", "term": "krumps with chest pops and stomps" },
+  { "id": "spin-a-pirouette", "label": "Pirouette", "category": "dance", "description": "Ballet turn on one foot, spotting the head",
+    "promptHint": "the subject rises onto the ball of one foot and turns a ballet pirouette, the other foot tucked to the knee, arms rounded in front, head whipping to spot, then lands in fourth position", "term": "turns a ballet pirouette" },
+  { "id": "extend-into-arabesque", "label": "Arabesque", "category": "dance", "description": "Lift one leg behind into a held line",
+    "promptHint": "the subject shifts weight onto one straight leg and lifts the other behind, extending it high with a pointed foot while one arm reaches forward, holding the arabesque line", "term": "extends one leg into arabesque" },
+  { "id": "leap-grand-jete", "label": "Grand jeté", "category": "dance", "description": "Running split leap through the air",
+    "promptHint": "the subject takes a running preparation and springs into a grand jeté, legs opening into a full split in the air, front leg leading, arms lifted, landing on the front foot", "term": "springs into a grand jeté split leap" },
+  { "id": "drop-into-splits", "label": "Drop into splits", "category": "dance", "description": "Slides down into a full split, then pushes back up",
+    "promptHint": "the subject drops into the splits, one leg sliding forward and the other back until both are flat on the floor, arms flung out to the sides, then pushes back up to standing", "term": "drops into the splits" },
+  { "id": "reach-and-fall", "label": "Reach & fall", "category": "dance", "description": "Contemporary reach, fall to floor, recover",
+    "promptHint": "the subject reaches one arm forward and up until the weight tips past balance, then falls through the movement, spiraling down to the floor and rolling back up to standing", "term": "reaches off balance and falls to the floor" },
+  { "id": "throw-jazz-kick", "label": "Jazz kick", "category": "dance", "description": "High straight-leg kick, arms flung out",
+    "promptHint": "the subject steps forward and throws a high jazz kick, the leg swinging straight up in front to hip height or above, foot pointed, arms flung out to the sides for balance", "term": "throws a high jazz kick" },
+  { "id": "tap-dance-steps", "label": "Tap dance", "category": "dance", "description": "Shuffles and stamps in crisp rhythm",
+    "promptHint": "the subject tap dances, feet brushing, shuffling and stamping the floor in crisp rhythmic patterns, heels and toes striking alternately while the upper body stays upright and relaxed", "term": "tap dances with crisp shuffles and stamps" },
+  { "id": "irish-step-dance", "label": "Irish step dance", "category": "dance", "description": "Arms pinned, feet hopping and kicking on the beat",
+    "promptHint": "the subject irish step dances, arms pinned straight at the sides and torso rigid while the feet hop, kick and cross in pointed steps, toes striking the floor on each beat", "term": "irish step dances with arms pinned" },
+  { "id": "spin-salsa-turn", "label": "Salsa turn", "category": "dance", "description": "Hip-led steps into a full spot turn",
+    "promptHint": "the subject steps into a salsa turn, hips swinging with each step, spinning a full rotation on the ball of one foot, one arm raised, and stepping out on the beat facing forward again", "term": "spins a salsa spot turn" },
+  { "id": "sway-bachata-hips", "label": "Bachata sway", "category": "dance", "description": "Side steps with a hip pop on the fourth count",
+    "promptHint": "the subject steps side to side in a bachata basic, hips swaying with each step and popping upward on the fourth count, knees soft, arms held loosely at chest height", "term": "steps a bachata basic with a hip pop" },
+  { "id": "walk-tango-embrace", "label": "Tango walk", "category": "dance", "description": "Long strides in close embrace with a partner",
+    "promptHint": "the subject and the partner walk a tango in close embrace, chests connected, stepping in long deliberate strides with the knees brushing, heads turned sharply to the side, then pausing in a held stance", "term": "tangos with the partner in close embrace",
+    "twoPerson": true, "requires": ["partner"] },
+  { "id": "waltz-box-step", "label": "Waltz box step", "category": "dance", "description": "Closed-hold box step, rise and fall",
+    "promptHint": "the subject and the partner waltz a box step in closed hold, stepping forward, side and together, then back, side and together, rising on the toes on the second count and sinking on the third", "term": "waltzes a box step with the partner",
+    "twoPerson": true, "requires": ["partner"] },
+  { "id": "swing-out-lindy", "label": "Lindy swing out", "category": "dance", "description": "Rock step, send the partner out and catch",
+    "promptHint": "the subject leads the partner through a lindy hop swing out, pulling them in on a rock step, sending them spinning out to arm's length and catching the partner's hand as they swing back", "term": "swings the partner out in a lindy hop",
+    "twoPerson": true, "requires": ["partner"] },
+  { "id": "spin-partner", "label": "Underarm turn", "category": "dance", "description": "Leads the partner through a turn under the arm",
+    "promptHint": "the subject raises the partner's hand overhead and leads the partner through a full turn under the raised arm, the partner pivoting on the balls of the feet before settling back facing the subject", "term": "spins the partner under the arm",
+    "twoPerson": true, "requires": ["partner"] },
+  { "id": "dip-the-partner", "label": "Ballroom dip", "category": "dance", "description": "Supported backward dip, then lift upright",
+    "promptHint": "the subject steps forward and dips the partner backward, one arm supporting the partner's back as the partner arches the spine and extends one leg, holding the dip then lifting them upright", "term": "dips the partner backward",
+    "twoPerson": true, "requires": ["partner"] },
+  { "id": "shimmy-the-hips", "label": "Hip shimmy", "category": "dance", "description": "Belly-dance hip vibration, torso lifted",
+    "promptHint": "the subject shimmies the hips in a belly dance, knees alternating in small rapid bends so the hips vibrate side to side while the torso stays lifted and the arms float at shoulder height", "term": "shimmies the hips belly-dance style" },
+  { "id": "shimmy-the-shoulders", "label": "Shoulder shimmy", "category": "dance", "description": "Shoulders alternate forward and back in a flutter",
+    "promptHint": "the subject shimmies the shoulders, pushing one shoulder forward as the other pulls back and alternating in a rapid flutter, chest lifted, arms hanging loose, head steady with a grin", "term": "shimmies the shoulders" },
+  { "id": "flourish-flamenco-arms", "label": "Flamenco flourish", "category": "dance", "description": "Wrists circling overhead, heel stamps",
+    "promptHint": "the subject raises the arms in a flamenco flourish, wrists circling inward as the hands rotate above the head, back arched, chin lifted, then stamps the heels in a sharp rhythmic burst", "term": "flourishes flamenco arms and stamps the heels" },
+  { "id": "flourish-bollywood-hands", "label": "Bollywood flourish", "category": "dance", "description": "Rolling hand flicks, head slides, hip bounce",
+    "promptHint": "the subject performs a bollywood flourish, hands rolling and flicking outward from the chest with the fingers spread, head sliding side to side, hips bouncing in time with each step", "term": "flicks bollywood hands with a hip bounce" },
+  { "id": "do-bhangra", "label": "Bhangra", "category": "dance", "description": "Arms up, shoulders bouncing, knees lifting in hops",
+    "promptHint": "the subject does bhangra, both arms raised overhead with index fingers pointing up, shoulders bouncing on the beat while the knees lift high in alternating hops and the head shakes side to side", "term": "does bhangra with arms up" },
+  { "id": "dance-afrobeats-legwork", "label": "Afrobeats legwork", "category": "dance", "description": "Knees pumping, feet twisting, torso bent",
+    "promptHint": "the subject dances afrobeats legwork, knees pumping in and out, feet skipping and twisting on the floor in loose patterns, shoulders rolling, torso bent forward and bouncing with the groove", "term": "dances afrobeats legwork" },
+  { "id": "sway-capoeira-ginga", "label": "Capoeira ginga", "category": "dance", "description": "Rocking triangle step, guarding arm across the chest",
+    "promptHint": "the subject sways in a capoeira ginga, one foot stepping back into a low lunge as the opposite arm guards across the chest, then shifting forward and switching sides in a rocking triangle step", "term": "sways in capoeira ginga" },
+  { "id": "hit-kpop-point-move", "label": "Improvise K-pop point move", "category": "dance", "description": "Arms snap into a signature shape on the beat. Choreography is model-chosen.",
+    "promptHint": "the subject hits a k-pop point move, both arms snapping into a crisp angular shape in front of the chest on the beat, head tilting with it, then stepping side to side into the next sharp pose; the choreography is improvised rather than a specific signature routine", "term": "improvises a K-pop point move on the beat",
+    "kind": "compound", "aliases": ["K-Pop Point Move", "Kpop"] },
+  { "id": "moonwalk-backward", "label": "Moonwalk", "category": "dance", "description": "Glide backward while the feet seem to walk forward",
+    "promptHint": "the subject moonwalks, sliding backward across the floor while the feet appear to walk forward, one heel lifted as the flat foot glides, upper body upright and loose", "term": "moonwalks backward across the floor" },
+  { "id": "do-the-robot", "label": "The robot", "category": "dance", "description": "Stiff mechanical segments, stopping at joints",
+    "promptHint": "the subject does the robot, moving the arms and head in stiff mechanical segments that stop dead at each joint, torso locking between moves, with small jerky ticks between positions", "term": "does the robot with stiff isolations" },
+  { "id": "do-the-twist", "label": "The twist", "category": "dance", "description": "Feet planted, hips swiveling against shoulders",
+    "promptHint": "the subject does the twist, feet planted while the hips and knees swivel side to side in opposition to the shoulders, bending lower and rising back up as the arms pump", "term": "does the twist with swiveling hips" },
+  { "id": "throw-disco-point", "label": "Disco point", "category": "dance", "description": "Arm sweeps across then shoots up diagonally",
+    "promptHint": "the subject strikes a disco point, one arm sweeping across the body then shooting up diagonally with the index finger extended, hips pushing the other way on each beat", "term": "throws a disco point across the body" },
+  { "id": "do-the-floss", "label": "The floss", "category": "dance", "description": "Straight arms swing past the hips, hips opposite",
+    "promptHint": "the subject does the floss dance, both arms held straight and swinging together past the hips, passing behind the body on one side and in front on the other, while the hips swing the opposite way", "term": "does the floss arm swing" },
+  { "id": "hit-a-dab", "label": "Dab", "category": "dance", "description": "Head drops into the elbow, other arm shoots out",
+    "promptHint": "the subject dabs, dropping the head into the crook of one bent elbow while the other arm shoots straight out to the side and up, holding the shape then straightening", "term": "dabs into the elbow" },
+  { "id": "hit-the-woah", "label": "The woah", "category": "dance", "description": "Fists circle then lock sharply on the beat",
+    "promptHint": "the subject hits the woah, both fists circling once in front of the chest then locking sharply, one fist above the other, the body freezing in a lean on the beat", "term": "hits the woah" },
+  { "id": "do-the-griddy", "label": "The griddy", "category": "dance", "description": "Heels kick back on hops, arms pump, hands to eyes",
+    "promptHint": "the subject does the griddy, hopping forward on alternating feet as each heel kicks up behind, arms pumping in loose circles, then raises both hands to the eyes in a binocular shape", "term": "does the griddy" },
+  { "id": "do-the-running-man", "label": "Running man", "category": "dance", "description": "Knees lift while the standing foot slides back",
+    "promptHint": "the subject does the running man, one knee lifting high while the standing foot slides back, then switching, the feet appearing to run in place with the arms pumping", "term": "does the running man shuffle" },
+  { "id": "shuffle-cutting-shapes", "label": "Melbourne shuffle", "category": "dance", "description": "Running man into T-steps, cutting shapes",
+    "promptHint": "the subject dances the melbourne shuffle, feet kicking and sliding through running-man steps then twisting sideways into t-steps, heels and toes pivoting across the floor while the arms swing loosely", "term": "dances the Melbourne shuffle" },
+  { "id": "headbang-to-music", "label": "Headbang", "category": "dance", "description": "Head whips forward and back, hair flying",
+    "promptHint": "the subject headbangs, whipping the head forward and down then back up from the neck in time with a heavy beat, hair flying, shoulders hunched and hands gripping the air", "term": "headbangs to the music" },
+  { "id": "whip-hair-in-circle", "label": "Hair whip circle", "category": "dance", "description": "Head swings the hair through a full circle",
+    "promptHint": "the subject whips the hair in a full circle, bending forward at the waist and swinging the head around in a wide loop so the hair fans out and trails through the air", "term": "whips hair in a full circle" },
+  { "id": "roll-the-body", "label": "Body roll", "category": "dance", "description": "Wave from chest through ribs to hips",
+    "promptHint": "the subject rolls the body in a wave, the chest pushing forward first, then the ribs, stomach and hips following in sequence, ending with the hips tucked under", "term": "rolls the body from chest to hips" },
+]

package/src/character-motion/entrances-exits.ts

@@ -0,0 +1,92 @@
+import type { CharacterMotion } from "./types.js"
+
+/** entrances-exits — authored motion fragments. Stable ids survive copy revisions. */
+export const ENTRANCES_EXITS_MOTIONS: ReadonlyArray<CharacterMotion> = [
+  { "id": "walk-in-from-left", "label": "Walk in from left", "category": "entrances-exits", "description": "Enters from the left edge and stops at center",
+    "promptHint": "the subject walks into frame from the left edge at an even stride, weight rolling heel to toe, crosses toward center and stops facing forward", "term": "walks in from frame left" },
+  { "id": "walk-in-from-right", "label": "Walk in from right", "category": "entrances-exits", "description": "Enters from the right edge and stops at center",
+    "promptHint": "the subject walks into frame from the right edge at an even stride, weight rolling heel to toe, crosses toward center and stops facing forward", "term": "walks in from frame right" },
+  { "id": "enter-from-behind-camera", "label": "Enter from behind camera", "category": "entrances-exits", "description": "Passes the lens and walks into the scene",
+    "promptHint": "the subject steps into frame from behind the camera, passing close beside the lens with their back to it, and walks forward into the scene to stop mid-frame", "term": "enters past the camera from behind" },
+  { "id": "approach-from-background", "label": "Approach from background", "category": "entrances-exits", "description": "Distant figure walks up to mid-frame",
+    "promptHint": "the subject walks straight toward the camera from deep in the background, growing larger with each step, and stops at mid-distance facing forward", "term": "approaches from deep background" },
+  { "id": "walk-up-to-camera", "label": "Walk up to camera", "category": "entrances-exits", "description": "Closes in until the face fills the frame",
+    "promptHint": "the subject walks straight toward the camera from mid-frame, closing the distance until their face and shoulders fill the frame, and stops just short of the lens", "term": "walks up to the camera and stops" },
+  { "id": "run-toward-camera", "label": "Run toward camera", "category": "entrances-exits", "description": "Sprints straight at the lens and pulls up short",
+    "promptHint": "the subject runs straight toward the camera from deep in the background, arms pumping and torso leaning into the stride, and pulls up short just in front of the lens with chest heaving", "term": "runs toward the camera and stops" },
+  { "id": "run-in-and-stop", "label": "Run in from left and stop", "category": "entrances-exits", "description": "Runs in through frame left and stops near center.",
+    "promptHint": "the subject runs into frame from the left edge, slows over several steps and comes to a balanced stop near the center", "term": "runs in from frame left, stopping near center",
+    "aliases": ["Run In & Stop"] },
+  { "id": "burst-in-through-doorway", "label": "Burst in through doorway", "category": "entrances-exits", "description": "Slams through a door and plants both feet",
+    "promptHint": "the subject bursts through a doorway in the background, shoving the door open with one arm, lunging two steps forward and planting both feet with shoulders squared to the camera", "term": "bursts in through a doorway" },
+  { "id": "kick-open-door", "label": "Kick open door", "category": "entrances-exits", "description": "Boots a door open from behind and strides in",
+    "promptHint": "the subject kicks a closed door in the background open from the far side with the sole of one foot, the door swinging wide, and strides through the doorway toward the camera with shoulders squared, stopping in clear view", "term": "kicks the door open and steps through" },
+  { "id": "dive-through-window", "label": "Dive through window", "category": "entrances-exits", "description": "Launches headfirst through a window and rolls up",
+    "promptHint": "the subject launches headfirst through a window in the background toward the camera, arms crossed over the face, tucks into a shoulder roll on landing and comes up onto both feet", "term": "dives through a window and rolls" },
+  { "id": "climb-through-window", "label": "Climb through window", "category": "entrances-exits", "description": "Hoists in over a windowsill and drops to the floor",
+    "promptHint": "the subject grips a windowsill, hoists one leg over it followed by the other, ducks the head under the top of the window and drops quietly onto both feet inside", "term": "climbs in through a window" },
+  { "id": "stumble-in", "label": "Stumble in — right", "category": "entrances-exits", "description": "Trips in from the right and recovers balance (frame right).",
+    "promptHint": "the subject stumbles into frame from the right edge, one foot catching, torso pitching forward with arms flung out for balance, and regains balance to straighten up at center", "term": "stumbles in from frame right",
+    "aliases": ["Stumble In"] },
+  { "id": "sneak-in", "label": "Sneak in — left", "category": "entrances-exits", "description": "Creeps in low from the left, then stands (frame left).",
+    "promptHint": "the subject creeps into frame from the left edge in a low crouch, placing each foot carefully and glancing side to side, and straightens up cautiously at center", "term": "sneaks in from frame left",
+    "aliases": ["Sneak In"] },
+  { "id": "dash-across-frame", "label": "Dash across frame — left to right", "category": "entrances-exits", "description": "Sprints in from the left and out the right edge (frame left to right).",
+    "promptHint": "the subject sprints across frame from the left edge to the right edge without slowing, body leaning into the run, and is gone out the far side", "term": "dashes across frame left to right",
+    "endVisibility": "out-of-frame", "aliases": ["Dash Across Frame"] },
+  { "id": "slide-in-on-knees", "label": "Slide in from left on knees", "category": "entrances-exits", "description": "Slides in from frame left on both knees and comes to a stop.",
+    "promptHint": "the subject enters from the left edge sliding on both knees, slows and comes to a stop", "term": "slides from frame left on both knees, stopping",
+    "startPose": "floor", "endPose": "floor", "requires": ["smooth floor"], "aliases": ["Slide In On Knees"] },
+  { "id": "sock-slide-into-frame", "label": "Sock slide into frame", "category": "entrances-exits", "description": "Skids in on socked feet and catches balance",
+    "promptHint": "the subject slides into frame from the left edge on socked feet, knees soft and arms out for balance, skidding across a smooth floor and catching balance at center", "term": "sock-slides in from frame left" },
+  { "id": "drop-in-from-above", "label": "Drop in from above", "category": "entrances-exits", "description": "Lands from above, knees absorb, stands up",
+    "promptHint": "the subject drops into frame from above the top edge, lands on both feet with knees bending deep to absorb the impact and one hand touching the ground, and rises to stand", "term": "drops in from above and lands" },
+  { "id": "rise-into-frame", "label": "Rise into frame", "category": "entrances-exits", "description": "Stands up into view from the bottom edge",
+    "promptHint": "the subject rises into frame from below the bottom edge, standing up out of a crouch so the head appears first with shoulders and torso following until they stand fully upright at center", "term": "rises into frame from below" },
+  { "id": "pop-up-from-cover", "label": "Pop up from cover", "category": "entrances-exits", "description": "Springs into view from behind foreground cover",
+    "promptHint": "the subject pops up from behind an object in the foreground, head and shoulders springing into view above its top edge, and straightens to stand facing the camera", "term": "pops up from behind an object" },
+  { "id": "lean-into-frame", "label": "Lean into frame — left", "category": "entrances-exits", "description": "Head and shoulders tip in, then back out (frame left).",
+    "promptHint": "the subject leans into frame from the left edge, head and shoulders tipping into view while the feet stay planted out of shot, and leans back out of frame", "term": "leans in and out from frame left",
+    "endVisibility": "out-of-frame", "aliases": ["Lean Into Frame"] },
+  { "id": "peek-into-frame", "label": "Peek in from frame right", "category": "entrances-exits", "description": "Leans the head into view from the right and holds the peek.",
+    "promptHint": "the subject leans the head and one shoulder into view from the right edge of the frame and holds the peek while the rest of the body stays out of view", "term": "peeks into frame from the right",
+    "aliases": ["Peek Into Frame"] },
+  { "id": "enter-through-doorway", "label": "Enter through doorway", "category": "entrances-exits", "description": "Crosses a threshold and walks into view",
+    "promptHint": "the subject steps out through a doorway in the background, crossing the threshold with one foot after the other, and walks a few paces forward to stop in clear view", "term": "enters through a doorway" },
+  { "id": "step-out-of-shadow", "label": "Step out of shadow", "category": "entrances-exits", "description": "Emerges from a dark recess into clear view",
+    "promptHint": "the subject steps forward out of a dark recess at the back of the frame into clear view, face and body fully visible, and stops facing the camera", "term": "steps out of the shadows" },
+  { "id": "emerge-from-crowd", "label": "Emerge from crowd", "category": "entrances-exits", "description": "Pushes through bodies into open space",
+    "promptHint": "the subject pushes forward through a crowd of people, angling their shoulders past the people around them, and steps clear into open space at the front of the frame, stopping to face forward", "term": "emerges from a crowd" },
+  { "id": "step-around-corner", "label": "Step around corner", "category": "entrances-exits", "description": "Shoulder first, then the body swings into view",
+    "promptHint": "the subject steps around a corner into frame, one shoulder appearing first and the body swinging into view behind it, and walks a few paces forward to stop in the open", "term": "steps around a corner into frame" },
+  { "id": "walk-out-left", "label": "Exit frame left", "category": "entrances-exits", "description": "Walks out through the left edge of the frame.",
+    "promptHint": "the subject walks toward the left edge of the frame and continues until completely out of view", "term": "walks out through frame left",
+    "endVisibility": "out-of-frame", "aliases": ["Walk Out Left"] },
+  { "id": "walk-out-right", "label": "Exit frame right", "category": "entrances-exits", "description": "Walks out through the right edge of the frame.",
+    "promptHint": "the subject walks toward the right edge of the frame and continues until completely out of view", "term": "walks out through frame right",
+    "endVisibility": "out-of-frame", "aliases": ["Walk Out Right"] },
+  { "id": "run-out-of-frame", "label": "Run out through frame right", "category": "entrances-exits", "description": "Runs out of view through the right edge.",
+    "promptHint": "the subject runs toward the right edge of the frame and continues until completely out of view", "term": "runs out through frame right",
+    "endVisibility": "out-of-frame", "aliases": ["Run Out Of Frame"] },
+  { "id": "walk-away-into-distance", "label": "Walk away into distance", "category": "entrances-exits", "description": "Back to camera, shrinks into the background",
+    "promptHint": "the subject stands with their back to the camera and walks straight away into the background, shrinking with each step until they are a small distant figure", "term": "walks away into the distance" },
+  { "id": "run-away-into-distance", "label": "Run away into distance", "category": "entrances-exits", "description": "Back to camera, sprints off into the background",
+    "promptHint": "the subject turns their back to the camera and runs straight away into the background, arms pumping, shrinking with each stride until they are a small distant figure", "term": "runs away into the distance" },
+  { "id": "turn-and-walk-away", "label": "Turn & walk away", "category": "entrances-exits", "description": "Pivots away from camera and walks off",
+    "promptHint": "the subject stands facing the camera, pivots on one foot to turn their back, and walks off into the background, growing smaller until they are far from the camera", "term": "turns and walks away" },
+  { "id": "back-out-of-frame", "label": "Back out through frame left", "category": "entrances-exits", "description": "Retreats diagonally backward out of the left edge.",
+    "promptHint": "the subject keeps facing into the scene and steps diagonally backward toward the left edge until completely out of view", "term": "backs diagonally out through frame left",
+    "endVisibility": "out-of-frame", "aliases": ["Back Out Of Frame"] },
+  { "id": "dragged-out-of-frame", "label": "Dragged out of frame", "category": "entrances-exits", "description": "Hauled backward out of shot, hands clawing the floor",
+    "promptHint": "the subject is yanked backward off their feet and dragged flat on their back along the floor toward the bottom edge of frame, fingers clawing at the ground and legs kicking, until pulled out of shot", "term": "is dragged backward out of frame",
+    "endVisibility": "out-of-frame" },
+  { "id": "exit-past-camera", "label": "Exit past camera", "category": "entrances-exits", "description": "Walks past the camera and out of view.",
+    "promptHint": "the subject walks toward the camera, passes beside it and continues out of view", "term": "walks past the camera and out of view",
+    "endVisibility": "out-of-frame" },
+  { "id": "duck-out-of-frame", "label": "Duck below frame", "category": "entrances-exits", "description": "Lowers the body until out of view below the frame.",
+    "promptHint": "the subject bends the knees and lowers the head and torso until completely below the bottom edge of the frame", "term": "ducks below the bottom of the frame",
+    "endVisibility": "out-of-frame", "aliases": ["Duck Out Of Frame"] },
+  { "id": "exit-through-doorway", "label": "Exit through doorway", "category": "entrances-exits", "description": "Walks through a doorway and out of view.",
+    "promptHint": "the subject walks through the open doorway and continues until out of view", "term": "walks through a doorway and out of view",
+    "requires": ["open doorway"], "endVisibility": "out-of-frame" },
+]

package/src/character-motion/evasive-falls.ts

@@ -0,0 +1,92 @@
+import type { CharacterMotion } from "./types.js"
+
+/** evasive-falls — authored motion fragments. Stable ids survive copy revisions. */
+export const EVASIVE_FALLS_MOTIONS: ReadonlyArray<CharacterMotion> = [
+  { "id": "duck-under", "label": "Duck under", "category": "evasive-falls", "description": "Drops head and shoulders under a passing threat",
+    "promptHint": "the subject snaps the head and shoulders down, knees bending so the whole body dips below the line of a passing threat, before rising back to full height", "term": "ducks under a passing threat" },
+  { "id": "dodge-sideways", "label": "Sidestep dodge", "category": "evasive-falls", "description": "Lateral step out of the line of attack",
+    "promptHint": "the subject pushes off one foot and steps wide sideways, torso twisting out of the line of attack, weight landing on the outside leg before the feet reset square", "term": "sidesteps out of the line of attack" },
+  { "id": "lean-back-dodge", "label": "Lean-back dodge", "category": "evasive-falls", "description": "Bends backward from the waist under a swing",
+    "promptHint": "the subject bends backward from the waist and knees as if under a swing passing overhead, spine arching and arms trailing, the head dipping below the line of attack before snapping back upright", "term": "leans back under a swing" },
+  { "id": "flinch-away", "label": "Flinch", "category": "evasive-falls", "description": "Sharp involuntary jerk of the head and shoulders",
+    "promptHint": "the subject jerks the head and shoulders back and away, eyes squeezing shut and one hand half-raising toward the face, the body tensing before settling again", "term": "flinches back from a sudden threat" },
+  { "id": "jump-back-startled", "label": "Startled jump back", "category": "evasive-falls", "description": "Hops backward with hands rising in surprise",
+    "promptHint": "the subject startles and hops backward off both feet, hands flying up to chest height and shoulders hunching, landing a step behind the start position with the eyes wide", "term": "jumps back in surprise" },
+  { "id": "dive-for-cover", "label": "Dive for cover", "category": "evasive-falls", "description": "Launches headlong behind the nearest cover",
+    "promptHint": "the subject drives off both legs into a headlong dive toward the nearest cover, arms leading, body stretching horizontal through the air and landing on the forearms and chest behind it", "term": "dives for cover" },
+  { "id": "duck-behind-cover", "label": "Duck behind cover", "category": "evasive-falls", "description": "Drops low behind cover and presses against it",
+    "promptHint": "the subject darts sideways and drops into a crouch behind cover, back pressing flat against it, knees pulled in and head tucked below the top edge", "term": "drops into a crouch behind cover" },
+  { "id": "evasive-roll", "label": "Evasive roll", "category": "evasive-falls", "description": "Dives into a shoulder roll and comes up clear",
+    "promptHint": "the subject dives sideways into a shoulder roll, tucking the head and rolling diagonally across the back from shoulder to opposite hip, and comes up onto one knee clear of the danger", "term": "rolls out of the way" },
+  { "id": "hurdle-low-obstacle", "label": "Hurdle obstacle", "category": "evasive-falls", "description": "Leaps over something low without breaking stride",
+    "promptHint": "the subject takes off from one foot and clears a low obstacle, lead leg driving up and over with the trailing leg tucked, landing on the far side and carrying on", "term": "hurdles a low obstacle" },
+  { "id": "spin-away-from-danger", "label": "Half-turn and move away", "category": "evasive-falls", "description": "Turns halfway around and moves away in the new direction.",
+    "promptHint": "the subject pivots through a half-turn to face away from the original direction, then moves forward in the new direction", "term": "turns halfway around and moves away",
+    "startPose": "standing", "endPose": "standing", "aliases": ["Spin Away"] },
+  { "id": "hit-the-deck", "label": "Hit the deck", "category": "evasive-falls", "description": "Throws the body flat with arms over the head",
+    "promptHint": "the subject throws the body flat to the ground in one motion, landing on the forearms and belly with both hands clamped over the back of the head and the face pressed down", "term": "hits the deck" },
+  { "id": "drop-to-ground", "label": "Drop prone", "category": "evasive-falls", "description": "Lowers straight down to lie flat on the ground",
+    "promptHint": "the subject drops straight down from standing, knees folding and hands hitting the ground, and flattens out prone with the chest to the earth and head kept low", "term": "drops prone to the ground" },
+  { "id": "stumble-and-recover", "label": "Stumble & recover", "category": "evasive-falls", "description": "Loses footing mid-step and regains balance",
+    "promptHint": "the subject mis-steps and pitches forward off balance, arms windmilling outward and one foot slapping down ahead to catch the weight, before straightening up and continuing on", "term": "stumbles and recovers balance" },
+  { "id": "trip-and-fall", "label": "Trip & fall", "category": "evasive-falls", "description": "Catches a foot and goes down onto hands and knees",
+    "promptHint": "the subject catches a foot on something low, pitches forward past the point of recovery and goes down, hands slapping the ground first and knees following, ending sprawled on all fours", "term": "trips and falls forward" },
+  { "id": "slip-on-surface", "label": "Slip", "category": "evasive-falls", "description": "Feet shoot out on a slick surface",
+    "promptHint": "the subject steps onto a slick patch and the leading foot shoots out forward, arms flailing upward for balance, and drops onto one hip with both hands slapping the ground", "term": "slips on a slick surface" },
+  { "id": "fall-backward", "label": "Fall backward", "category": "evasive-falls", "description": "Topples onto the back, arms flung out",
+    "promptHint": "the subject tips backward past the heels, arms flinging out to the sides and knees buckling, landing seat-first and rolling flat onto the back with the head coming down last", "term": "falls flat on the back" },
+  { "id": "fall-forward", "label": "Fall forward", "category": "evasive-falls", "description": "Pitches face-down onto the ground",
+    "promptHint": "the subject pitches forward from the ankles like a felled tree, arms coming up too late to break the fall, and lands chest-first on the ground, head turning to one side on impact", "term": "falls forward face-down" },
+  { "id": "collapse-to-knees", "label": "Collapse to knees", "category": "evasive-falls", "description": "Legs give way and the body drops to both knees",
+    "promptHint": "the subject buckles at the knees and drops straight down onto both of them, torso folding forward, hands landing on the thighs as the head hangs low", "term": "collapses to both knees" },
+  { "id": "faint-and-crumple", "label": "Faint", "category": "evasive-falls", "description": "Goes limp and folds to the floor",
+    "promptHint": "the subject goes limp, eyes closing and knees folding first, the torso sagging sideways and the head lolling as the body crumples to the floor in a loose heap", "term": "faints and crumples to the floor" },
+  { "id": "knocked-back-by-blast", "label": "Blast knockback", "category": "evasive-falls", "description": "Body thrown backward off its feet by an unseen force",
+    "promptHint": "the subject is thrown backward off both feet as if hit by a shockwave, arms and legs flung forward, back arching, and lands hard on the shoulders sliding to a stop", "term": "is thrown backward by a blast" },
+  { "id": "stagger-backward", "label": "Stagger back", "category": "evasive-falls", "description": "Reels backward on unsteady feet",
+    "promptHint": "the subject reels backward on unsteady legs, heels catching and torso swaying, one arm reaching behind for balance, and steadies only after three or four lurching steps", "term": "staggers backward" },
+  { "id": "catch-on-wall", "label": "Catch on wall", "category": "evasive-falls", "description": "Lurches sideways and stops the fall against a wall",
+    "promptHint": "the subject lurches off balance toward a wall and throws out a hand flat against it, arm locking to catch the body weight, shoulder braced as the feet find footing again", "term": "catches a fall against the wall" },
+  { "id": "scramble-to-feet", "label": "Scramble to feet", "category": "evasive-falls", "description": "Pushes up from the ground and gets back upright",
+    "promptHint": "the subject pushes up from the ground onto hands and one knee, drives through the front foot to stand, and finds balance with a half-step as the body straightens", "term": "scrambles back to their feet" },
+  { "id": "scramble-backward", "label": "Scramble backward", "category": "evasive-falls", "description": "Crab-crawls away on hands and heels from the ground",
+    "promptHint": "the subject scrambles backward from the ground on hands and heels in a crab-crawl, pelvis lifting and dropping with each push, eyes locked on the threat as the distance opens", "term": "scrambles backward on hands and heels" },
+  { "id": "brace-for-impact", "label": "Brace for impact", "category": "evasive-falls", "description": "Plants the feet and tenses the whole body",
+    "promptHint": "the subject plants both feet wide, drops the weight low, tucks the chin and raises both forearms across the face and chest, every muscle tensing against an incoming impact", "term": "braces for impact" },
+  { "id": "cower-and-cover-head", "label": "Cower", "category": "evasive-falls", "description": "Shrinks down with both arms wrapped over the head",
+    "promptHint": "the subject shrinks down into a crouch, back rounding and both arms wrapping over the head with elbows tucked in, face turned down and away from the threat", "term": "cowers covering the head" },
+  { "id": "freeze-in-place", "label": "Freeze in place", "category": "evasive-falls", "description": "Stops dead mid-motion and holds completely still",
+    "promptHint": "the subject stops dead mid-motion, weight caught between steps, body locking rigid with the breath held and only the eyes moving as the stillness holds", "term": "freezes in place" },
+  { "id": "recoil-from-heat", "label": "Recoil from heat", "category": "evasive-falls", "description": "Turns away with a raised arm shielding the face",
+    "promptHint": "the subject recoils, twisting the torso away and throwing one forearm across the face as if against searing heat, taking two steps back with the eyes narrowed and the head turned", "term": "recoils from searing heat" },
+  { "id": "snatch-hand-back", "label": "Snatch hand back", "category": "evasive-falls", "description": "Yanks the hand away from something hot or sharp",
+    "promptHint": "the subject reaches toward something and yanks the hand back the instant it makes contact, cradling the fingers against the chest and taking a half step away", "term": "snatches the hand back" },
+  { "id": "shield-eyes", "label": "Shield eyes", "category": "evasive-falls", "description": "Raises a hand against a sudden glare",
+    "promptHint": "the subject squints and raises one hand flat above the brow as if against a sudden glare, head turning slightly aside and shoulders lifting, and lowers the hand once the eyes adjust", "term": "shields the eyes from glare" },
+  { "id": "flinch-from-loud-noise", "label": "Flinch from noise", "category": "evasive-falls", "description": "Claps both hands over the ears and hunches down",
+    "promptHint": "the subject claps both hands over the ears and hunches the shoulders up to the jaw, face screwing tight and the head ducking as if against a deafening noise", "term": "flinches from a deafening noise" },
+  { "id": "leap-back-from-edge", "label": "Leap back from edge", "category": "evasive-falls", "description": "Jumps back from a drop with arms windmilling",
+    "promptHint": "the subject teeters at the lip of a drop with toes over the edge and throws the weight backward, arms windmilling, landing two steps back from the brink with the chest heaving", "term": "leaps back from an edge" },
+  { "id": "back-away-hands-up", "label": "Hands-up retreat", "category": "evasive-falls", "description": "Retreats step by step with open palms raised",
+    "promptHint": "the subject raises both open palms to shoulder height and retreats one step at a time, eyes fixed ahead, weight staying on the back foot with each step", "term": "backs away with hands raised" },
+  { "id": "walk-into-glass-door", "label": "Walk into glass door", "category": "evasive-falls", "description": "Strides into an unseen pane and bounces off it",
+    "promptHint": "the subject strides forward and stops dead as the face and chest hit an unseen pane of glass, the head snapping back, one hand rising to the nose as the body rebounds a step", "term": "walks face-first into a glass door" },
+  { "id": "peek-through-fingers", "label": "Peek through fingers", "category": "evasive-falls", "description": "Covers the eyes, then parts the fingers to look",
+    "promptHint": "the subject claps both hands over the eyes and hunches the shoulders, then parts two fingers of one hand to peek through the gap before snapping them shut again", "term": "peeks through the fingers" },
+  { "id": "brace-back-against-door", "label": "Brace back against door", "category": "evasive-falls", "description": "Slams the back to a door and digs the heels in",
+    "promptHint": "the subject spins and slams the back flat against a door, both palms spread on it and heels digging into the floor, knees bent and shoulders driving into the door as if holding it shut", "term": "braces back against the door" },
+  { "id": "windmill-arms-losing-balance", "label": "Windmill arms", "category": "evasive-falls", "description": "Teeters on the toes and circles the arms to stay up",
+    "promptHint": "the subject teeters forward onto the toes, both arms whirling in big backward circles and the pelvis pushing back, holding the wobble on the balls of the feet before settling back onto the heels", "term": "windmills the arms to keep balance" },
+  { "id": "trip-on-stairs", "label": "Trip on stairs", "category": "evasive-falls", "description": "Clips a step going up and lands on the hands",
+    "promptHint": "the subject clips a toe on a stair while climbing, pitches forward onto the steps with both hands slapping the treads above, knees banging down, then pushes back up and climbs on", "term": "trips going up the stairs" },
+  { "id": "tip-over-in-chair", "label": "Tip over in chair", "category": "evasive-falls", "description": "Leans back too far and goes over with the chair",
+    "promptHint": "the subject leans back in a chair until it passes the tipping point, arms shooting out and feet lifting off the floor as the chair goes over backward and the subject lands on the back with legs in the air", "term": "tips over backward in a chair" },
+  { "id": "fall-into-pool", "label": "Fall into pool", "category": "evasive-falls", "description": "Loses footing at the edge and drops into the water",
+    "promptHint": "the subject loses footing at the edge of the water and topples in fully clothed, arms flailing, hitting the surface side-on with a splash and surfacing a moment later with hair and clothes streaming", "term": "falls into the water fully clothed" },
+  { "id": "pulled-under-water", "label": "Pulled under water", "category": "evasive-falls", "description": "Jerked down beneath the surface, arms grabbing up",
+    "promptHint": "the subject is treading water when the body jerks downward as if yanked from below, both arms shooting up and clawing at the surface, head going under and the fingertips vanishing last", "term": "is pulled under the water" },
+  { "id": "clutch-hat-in-wind", "label": "Clutch hat in wind", "category": "evasive-falls", "description": "Grabs a hat to the head and leans into a gust",
+    "promptHint": "the subject slaps one hand down onto the crown of a hat and holds it there, leaning the body forward and squinting as if into a hard gust, the free hand pinning a flapping coat", "term": "clutches a hat against the wind" },
+  { "id": "run-shielding-from-rain", "label": "Run shielding from rain", "category": "evasive-falls", "description": "Hurries with a jacket held over the head",
+    "promptHint": "the subject pulls a jacket up over the head with both hands, shoulders hunched and elbows tucked, and hurries forward in short steps as if dodging a downpour", "term": "runs with a jacket held overhead" },
+]