j UdZddlmZddlZddlZddlmZddlmZm Z m Z m Z m Z m Z mZmZgdZeeefZeeeeefZdZedd hZd Zd ZeeehZddZdddZddZddZGddZdd"Zdd&Z ed'(Gd)d*Z!e d+e d*fZ"ed'(Gd,d-Z#e$d.Z%e$d/Z&dd1Z'ed'(Gd2d3Z( ddd8Z) ddd:Z* ddd=Z+dd@Z,ddAdBdCdDddQZ-dCdd'dRddXZ.dd^Z/dd_Z0dd`Z1ddddZ2ed'(GdedfZ3ddiZ4ddjZ5ddkZ6ddlZ7ed'(GdmdnZ8e8dodpe4e8dqdre5e8dsdte6e8dudve7fZ9dwe:dx<e;dyedddddZ?ddZ@dddddZAddZBdddddZCdddddZDed'(GddZEddZFdS)aMacro-scale pointer behaviour planning (pure, no I/O, no browser). WHY THIS LAYER EXISTS --------------------- How a single move from A to B is *shaped* is only half of what a pointer stream shows. The other half is what the pointer does between the moves, and where the moves end: * a pointer that is perfectly still except for the second it takes to slide from one control to the next is still, measurably, a pointer that exists only in order to click. Measured on the current path, the cursor is motionless for ~96% of a session; * if every movement terminates on a clickable element then the SET OF ENDPOINTS is itself a signature, and no amount of per-path polish removes it. A human parks the cursor on empty page area, drags it out of the text being read, and fidgets while a page scrolls. So the interesting statistics here are not "is this curve pretty" but "how often does the pointer move at all", "how long are the silences", "where do the movements end" and "does the shape of all of that differ between two sessions". DESIGN: PLAN, DO NOT PERFORM ---------------------------- Every function below is pure: it takes a seed and geometry and returns a timeline of :class:`Step` objects. Something else - the caller - walks that timeline and dispatches it. Nothing here imports Playwright, opens a socket or reads a clock. That is what makes the behaviour testable with plain arithmetic instead of a live page, and it is why the numbers in the tests are assertions rather than screenshots. The walker is ``_cursor``: it turns a timeline into pointer events against absolute deadlines. What is planned here and what actually reaches the wire therefore differ, and deliberately so - see ``_cursor`` for the rule that decides which planned events survive a machine that cannot deliver them all. DESIGN: THIS MODULE PLANS *WHERE AND WHEN*, NOT *HOW A STROKE IS SHAPED* ------------------------------------------------------------------------ There are two scales, and exactly one owner each. ``_motion`` owns the shape and the pacing of a single stroke from A to B. This module owns everything above that: how many strokes an action is made of, where they aim, how long the hand waits between them, and what it does when it is not aiming at anything. The seam is the ``render`` argument threaded through every planner below. It takes a start, an end and a kind, and returns the steps of that one stroke. It is REQUIRED, not defaulted. This module used to carry its own stroke model as a fallback, which meant two intra-move laws could ship in one package and a detector would see a different one depending on which call site ran. That model was deleted on 2026-07-26 and the seam made mandatory, so a call site that forgets the renderer is a TypeError rather than a silent second law. ``_cursor`` injects one backed by ``_motion``, and it is the only stroke model in force everywhere. Two stroke models running side by side in one product would be two measurably different families of movement inside one session. DESIGN: EVERY PARAMETER COMES FROM THE SESSION SEED --------------------------------------------------- Pause length, drift amplitude, pointing speed, where the speed peak sits, how readily the hand overshoots, how often it moves for no reason: all of it is drawn per session from the seed (:class:`PointerPersona`). A number compiled into the package is the same number in every install and every account, and a fixed shape is an invariant across every session of every user - which is exactly the property a behavioural classifier wants. Two seeds must look like two people; one seed must reproduce exactly. PROVENANCE OF THE NUMBERS ------------------------- Each constant below carries a comment saying where it comes from. Two labels are used and they are not interchangeable: ``[lit]`` grounded in the human motor-control / HCI literature (Fitts' law and its Shannon form; the Meyer et al. 1988 optimised-submovement account of overshoot-and-correct; Flash & Hogan 1985 minimum-jerk velocity profiles; the 8-12 Hz physiological tremor band; heavy-tailed, roughly log-normal dwell times in reading and browsing). ``[judg]`` chosen by judgement. Plausible, bounded, and deliberately randomised per session so that being wrong about the centre of a range costs less - but not measured. Do not quote a ``[judg]`` number as if it were evidence. ) annotationsN) dataclass)AnyCallableDictIterableListOptionalSequenceTuple)StepPointerPersona TypingPersona plan_typingplan_hesitation plan_click act_nonce popup_numberPageActs PlanStatsinitial_pointer landing_point plan_idle plan_scroll plan_approachplan_aimless_movesteps_from_waypoints tail_within summarize BURST_GAP_MSi@approachcorrectwheelwaitseedinttagstrreturncdd|dzz }|dD]}||z}|dzdz}|pdS)a-FNV-1a mix - independent PRNG streams per logical bucket from one seed. The same idiom is used elsewhere in the package. Two different tags give two streams that advance independently, so adding a planner later cannot shift the numbers an existing planner produces for the same seed. l%#Ds_ asciilll>[=)encode)r&r(hcs PC:\Projects\Historical\venv\Lib\site-packages\invisible_playwright/_behaviour.py _sub_seedr2sS dZ/0A ZZ 55 Q  "4 4 ? nonce random.RandomcPtjt||d|S)N:)randomRandomr2)r&r(r4s r1_rngr:s* =4C)9)9%)9)9:: ; ;;r3pagencLt|dzt|dzzS)zThe nonce of the `n`-th act of one kind on the session's `page`-th page. The page goes in the high bits, so two pages never share a nonce and the first page (0) keeps the plain count 1, 2, 3. r,)r')r;r<s r1rrs$ IIOA 3 44r3opener Optional[int]kcxd|dnt|t|fz}dtd|dzzS)uThe number of the `k`-th page (1, 2, ...) the SITE opened from the page numbered `opener`, or, with `opener` None, the `k`-th one of the session whose opener is not a page we know. ⛔ A SEPARATE SPACE FROM THE PAGES THE SCRIPT ASKS FOR, and that is the point. Those are numbered 0, 1, 2 by the client in the order of the calls; a popup arrives when the engine says so, which no script controls, so a popup drawing from the same count would push every later `new_page()` one number further whenever it happened to land first (measured: an `asyncio.gather` of a click that opens a popup and a `new_page()`). Keyed by its opener and its rank among that opener's popups, a popup has a number its own script decides: the second popup the first page opened. Bit 62 set and a 62-bit hash below it: never one of the client's small numbers, and two popups collide with odds of 2**-62. z popup:%s:%dN-lrl)r'r2)r?rAr(s r1rrsA" &.33c&kk3q66J JC  !S))]; <?chc2|tvrdS|tvrdSdS)NLR?) _LEFT_HAND _RIGHT_HAND)rs r1_handrs' Zs [s 3r3ceZdZUdZded<ded<ded<ded<ded<ded <ded <ded <ded <ded <ded<eddZddZdS)ru'The parameters of one session's typing hand. Drawn from the session seed. Same shape as :class:`PointerPersona` and for the same reason: every field is a range, because the centre is an estimate and the width is the admission that people differ. A single hardcoded value would be a constant shared by every install. ⛔ It is drawn on its OWN tagged stream (`typing-persona`), so adding it does not move a single number any existing seed produces for the pointer. That property is why `_sub_seed` takes a tag at all. r'r&rXdwell_median_ms dwell_sigma gap_median_ms gap_sigmaalternate_hand_factorsame_hand_factorsame_key_factorhesitation_ratehesitation_median_mshesitation_sigmar*'TypingPersona'ct|d}|||dd|dd|dd|dd |d d |d d |dd|dd|dd|dd S)Nztyping-personagO@g]@rgzG?rg`m@g(\?gףp= ?gGz?gq= ףp?gp= ף?gףp= ?rg?g{Gz?gQ?@z@g@rr) r&rrrrrrrrrrrrs r1rzTypingPersona.from_seeds ' ( (sIIdE22 $--))D%00iid++"#))D$"7"7YYtT22IIdD11IIdD11!"5&!9!9YYtT22    r3r]r5c8t||j|jS)zOne stop to think, in milliseconds, drawn from `rng`. The only place a hesitation's distribution is written: `plan_typing` and `plan_hesitation` both draw through here. )rerr)rIr]s r1 hesitation_mszTypingPersona.hesitation_mss 3 94;PQQQr3N)r&r'r*r)r]r5r*rX)rQrRrSrTrnrrrrVr3r1rrs  III  !      [ RRRRRRr3rrMpersonaclicksList[Tuple[float, float]]ct|jd|}g}ttd|D]U}t ||j|j}||dz krdnt ||jd}|||fV|S)uGOne `(dwell_ms, gap_ms)` per press of a click or a double click. `dwell_ms` is how long the button stays down; `gap_ms` is the wait before the NEXT press, and is zero for the last one because the pause after a click belongs to whatever happens next. ⛔ SAME SHAPE AS `plan_typing`, AND FOR THE SAME REASON. A press with no duration is a press no hand made, whether it is a finger on a key or a finger on a button: `mouseup.timeStamp - mousedown.timeStamp` came back as the cost of one protocol round trip. The double click had the matching defect one level up - two presses with nothing between them, delivered as a `dblclick` anyway because the event is born from `clickCount` rather than from the interval, so the page saw a double click no operating system would have accepted as one. clickrMrag333333?) r:r&rangemaxrer~rrappend)rrr4routidwellgaps r1rrs" W\7E**A%'C 3q&>> " "!!Aw<#5776A:ooss7#A4HH  E3<    Jr3textct|jd|}g}t|D]\}}t||j|j}|t |dz kr||dfn||dz}t||j|j } ||kr | |j z} nAt|t|} } | dkr| dkr| | | kr|j n|j z} ||jkr| ||z } ||| f|S)uTOne `(dwell_ms, gap_ms)` per character of `text`. `dwell_ms` is how long that key stays down; `gap_ms` is the wait before the NEXT key goes down, and is zero for the last character because the pause after the last keystroke belongs to whatever happens next, not to typing. ⛔ THE PLAN IS COMPUTED WHERE THE SEED IS, which is here, and carried to the engine with the text. The engine holds no seed and decides no timing: it obeys. That is the same division the cursor already uses, and it is what keeps one session's rhythm from being a property of the machine. typingrMrar)r:r& enumeratererrlenrrrrrrrr8rr) rrr4rrrrrnxtrabs r1rr,sJ W\8U++A%'C4!!2Aw68KLL D A   JJs| $ $ $ E1q5k!W2G4EFF 99 7* *CC99eCjjqACxxAHHa55$57 88::/ / / 7((++ +C E3<    Jr3rKtimesc tj||tfdtt d|DS)aHow long this typist stops before `act`, in milliseconds: `times` of its hesitations, drawn on the stream for `act` and `nonce`. The same hand `plan_typing` pauses with in the middle of a word, so the pause before a field and the pause inside it are one person's. Each act has its own tagged stream, so adding an act cannot move a number another act or the typing itself draws for the same seed; the nonce makes two acts of the same kind in one session two different pauses. c3BK|]}VdSrH)r).0_rrs r1 z"plan_hesitation..[s1FFAw$$Q''FFFFFFr3rM)r:r&sumrr)rrKr4rrs` @r1rrOsO W\3&&A FFFFFs1e}}1E1EFFF F FFr3distancetarget_wctd|}tjt|d|z dz}|j|j|zz}|tj|d|jz}t|ddS)avMovement time for a pointing motion. [lit] Fitts, Shannon form. ``target_w`` is the effective width of what is being aimed at along the direction of travel. A movement that aims at nothing in particular passes a large width, which is why parking the cursor is fast and hitting a small button is slow - the property a fixed ~1 s duration cannot express. r?raN@gp@) rrblog2rqrrrcrdrsr\)rr]rrwidxmts r1 _fitts_msrbs CA )C#&&*S0 1 1C  g036 6B$(399S'"233 4 44B "dF # ##r3gk@rra) duration_msr noise_scalelead_msstartPointendrkboundsrenderRendererrOptional[float]rr List[Step]c$||||| ||S)a One stroke, drawn by whoever owns stroke shape in this configuration. ``target_w`` IS forwarded: Fitts' law needs the width of the thing being hit, and two points do not contain it. The renderer implements the law and was being fed a per-seed constant, so a stroke to a 20 px control and one to a 200 px control took the same time. Handing it the box is giving the model a fact, not overriding its pacing. ``duration_ms``/``noise_scale`` are NOT forwarded. Those are pacing, and a renderer that owns pacing owns it completely; a caller that set half of it would produce a stroke that is neither model's. That distinction survived the deletion of the built-in model - it is about which layer knows what, not about which model wins. )rkrrrrV) rr]rrrkrrrrrrs r1_legrus+F 6%4# % % %%r3)rr skip_firstraw Iterable[Any]Optional[Point]rboolc g}t|}d}t|D]\}} t| dd} | Tt| drDt| t| j} } tt| ddpd} nct | }t|dt|d} } t |dkrt|dnd} |dkr5|r3|t| dz }t| t| f} |t| dz }|.t| d|d} t| d|d} t| t| f}||kr|d krz| t| | || d}|}|S) aVAdapt a foreign waypoint stream to this module's :class:`Step`. Accepts either objects carrying ``x`` / ``y`` / ``dt_ms`` or plain ``(x, y, dt_ms)`` triples, which is what lets a renderer be plugged in without this module importing it. ``skip_first`` drops the leading waypoint: a generator that returns a path inclusive of both endpoints starts on the pointer's current position, and dispatching that would be an event with zero displacement. Two adjacent waypoints that round to the same device pixel *and* are closer together than a device could report them are merged. A duplicate that is genuinely separated in time is left alone, because "no two consecutive events ever share a pixel" is as much an invariant as "every event is 0.5 px off" - a hand holding still really does report the same pixel twice. The threshold is one millisecond: two points scheduled in the same instant are one sample written twice, while 40 ms apart is a hand holding still. Raising it to the 8 ms sampling floor was TRIED on 2026-07-26 and reverted, because it did not do what it was meant to: the duplicate rate through the macro path only moved from 0.098 to 0.095 (the in-binary generator is 0.081). The duplicates are not merge-threshold artefacts - they come from the small reading-and-drifting movements the macro layer plans, whose displacements round to the same device pixel while being genuinely separated in time. Fixing them means changing those movements, not this merge. Recorded so the next person does not re-try the same lever. Nrhridt_msrarrMrrhrirjrk) rXrgetattrhasattrrituplerrroundr\rr )rrkrrrrpendinglast_keyrprhpxpydtseqkeys r1rrsHCGnnG*.H#1 AsD ! ! =WQ__=1XXuQSzzBwq'3//6377BB((C3q6]]E#a&MMB"%c((Q,,s1vCB 66j6 s2s|| #Gb 599-H 3r3<<  C++BC++BRyy%))$ (??w}}  4"W4@@@AAA Jr3stepsSequence[Step] budget_msanchorviewportc |dkssgSdtD}|sgSt|dz }d}tt|dz ddD]E}||j}||z|kr|t|dz krn||z }|}||krnFfd||dD} ||dz } | dkr| j| jfn| djdz | djf} |d| dz |d| dz } } g}d}| D]}t |j| z|j| zf|}t|dt|df}||krU|t|d|d|j|j |}|S) a&The last ``budget_ms`` of a plan, re-anchored on the current position. A caller cannot travel back in time: when a plan covers a stretch of wall clock that has ALREADY passed, the only honest thing it can dispatch is the end of it. Taking the tail keeps the plan's own distribution of episode kinds and gaps instead of inventing a compressed one, and re-anchoring keeps the displacements while moving them to wherever the pointer actually is - the plan's absolute coordinates belong to a history that did not happen. rac4g|]\}}|jtv|SrV)rk_NON_MOTION_KINDS)rrss r1 ztail_within..s) P P PDAq>O0O0Oa0O0O0Or3rMc g|] }| SrVrV)rrrs r1rztail_within..s - - -E!H - - -r3Nrrr) rrrrjrhri _in_viewportrrr rk)rrrrmotionrusedjcostkeptprevoriginrlrmrrrrrs` r1rrsCu P PIe,, P P PF  KK!OE D 3v;;?B + +VAY( $; " "qCKK!O';'; E   9   E  - - - -fUVVn - - -D %=1 D/3qyyeDkmU4[] + + Q Ca?FAY "F1Iq $9BC +/H  !#(AC"H-x 8 8QqT{{E!A$KK( (??  4!A$!A$!&IIIJJJ Jr3c<|\}}t|d}|dkr8|d|zd|z|d|zd|zfS|d|zd|z|d |zd |zfS) aqA plausible seeded resting position for the cursor at page load. Never the viewport origin. A pointer whose first movement of every session departs from (0, 0) says the session began with no pointer state at all, which no real navigation produces: the cursor is wherever the previous interaction left it. [judg] Two cases, with weights chosen by reasoning rather than measurement: the user arrived by clicking a link on the previous page (so the cursor sits somewhere in the content area), or by using browser chrome - address bar, a bookmark, a tab - which leaves it near the top edge. zpointer-origing(\?g ףp= ?g= ףp=?gQ?g(\?g{Gz?g ףp= ?g{Gzt?g ףp= ?)r:r8r)r&rrr/rs r1rrs DAq T#$$AxxzzD $(D1H--qyy4!8/L/LMM IIdQhq ) )199UQYq+I+I JJr3ctj|j}ttj|||jddS)a One idle pause. [lit] log-normal: mostly short, with a genuine tail. Clipped to [180 ms, 75 s]. The floor keeps a pause distinguishable from a within-burst sampling gap; the ceiling stops a single draw from swallowing a whole session. Both are [judg]. gf@gO@)rblogrzr\rcrdr{)rr]mus r1 _pause_msr -sC ') * *B $(399R)<==>>w O OOr3@rmarginct|\}}t|d|||z t|d|||z fS)NrrM)r\)rrrrr/s r1rr8s> DAq 1Q4V , ,fQqT61v:.N.N OOr3cbeZdZUdZded<ded<ded<ded <d ed <d ed <ded<ddZdS) _IdleContextzEverything an episode needs, and the only way it changes the plan. ``get_pos`` rather than a position: a settle emits several twitches and each one starts where the last ended, so the episode has to see the cursor move as it emits. rrr5r]rrrrrXpause_mszCallable[[], Point]get_poszCallable[[List[Step]], None]emitampr*c |jddtjz}|}t |d|tj|zz|d|tj|zzf|jS)z>A destination ``amp`` px away in a uniformly random direction.ra@rrM) r]rrbpirrcossinr)rIrangposs r1nudgez_IdleContext.nudge]swhsC$'M22llnn VcDHSMM) )3q6C$(3--4G+G H M   r3N)rrXr*r)rQrRrSrTrnrrVr3r1rrLsOOOOOO    &&&&      r3rr0rFc |j}t|jddD]}||jj|jddz}t|j|j| |d|j |jdd|jj z|j | }|jd d }| |d S) z1-3 near-invisible adjustments, a pixel or two. The hand is resting on the mouse; [lit] 8-12 Hz tremor plus the fact that mouse friction swallows most of it. rMrg @settleD@^@rkrrrrrgy@N)rrr]randintrrrvrrrrryrr)r0leadrdestsegs r1 _idle_settler)gs :D 15==A&& ' 'wwqy*QU]]3-D-DDEE19aeQYY[[$X( u}}T599AI)rrrs r1rrs. O Otq!16AF? O O O O O Or3z>cumulative weights must increase, or an episode is unreachablerzEthe last episode must catch every roll, or plan_idle can emit nothing)r4rc t|d|}g|ddfd } t||} | z|krnn} |} t||||| fd | } tD]$} | | jkr| | n%| kr| z |krn|td Dz }|d kr7td d|tS)aPlan what the pointer does during ``duration_ms`` of "reading". This is the piece that has no counterpart today: between two clicks the current behaviour is exactly nothing. The plan here is a sequence of (pause, small action) episodes: settle 1-3 near-invisible adjustments, a pixel or two. The hand is resting on the mouse; [lit] 8-12 Hz tremor plus the fact that mouse friction swallows most of it. drift a slow, small displacement of a few to a few tens of px. reposition parking the cursor somewhere else entirely - out of the paragraph being read, towards a scrollbar, off to one side. This one ends NOWHERE by construction. trace a slow mostly-horizontal sweep, the cursor loosely following a line of text. Weights are [judg]: small fidgets dominate, deliberate repositioning is occasional. The point is the shape, not the exact split - and every amplitude scales with the session's persona, so the split a detector could measure is not the same split in the next session. The plan covers exactly ``duration_ms``: when the next pause would overrun the budget the episodes stop and the leftover time is emitted as a single ``"wait"`` step. Silence is a legitimate outcome of an idle period - it just has to be accounted for rather than dropped, or every activity fraction computed from the timeline comes out too high. idlerar(rr*rFc|sdS||dj|djftd|Dz dS)z>Append a planned segment and advance the clock and the cursor.Nrc3$K|] }|jV dSrHrjrrs r1rz*plan_idle..emit..s$//aqz//////r3)extendrhrir)r(elapsedrrs r1rzplan_idle..emitsa  F S2wy#b')$ 3//3//////r3TcSrHrV)rsr1zplan_idle..s3r3)rr]rrrrrc3$K|] }|jV dSrHrGrHs r1rzplan_idle.. s$ ; ; ; ; ; ; ; ;r3r7rrMr)r(rr*rF) r:r r8rrAr>r?rrr _WAIT_KIND)r&rrrrr4rrrpausebeforerollctxepisoderesidualrJrrs @@@r1rrsJ T65!!AE CG 0 0 0 0 0 0 0 0'1%% U?k ) ) xxzz7H"(5#.;;;T;;;&  Ggl"" S!!!# f   u G k ! ! ):S ; ;U ; ; ;;;;H3 TCFc!fx)+++ , , , Lr3gY@)tick_dyr4ticksrUct|d|}g} |} tt|dD]} | r|ddn|dd} | t | d| d| t ||dd z |d kr|j|d d z} |ddtj z}t| d| tj |zz| d| tj |zzf|}t||| |d||dd||dd }|r/| ||dj|djf} |r|dkr|j|ddz} |ddtj z}t| d| tj |zz| d| tj |zzf|}t||| |d||dd||dd }| || S)a_Plan a scroll burst with the pointer motion that goes with it. A hand that is turning a wheel is a hand resting on a mouse, and a mouse under a moving finger does not hold perfectly still: the wheel finger flexes, the palm shifts, and the cursor creeps by a pixel or several. A wheel event stream with a byte-identical pointer position throughout is a hand that is not attached to the mouse. Returns a single interleaved timeline: ``kind == "wheel"`` steps carry the scroll delta in ``dy`` and repeat the current pointer position, everything else is a pointer move. [lit] a notched wheel produces discrete detents, so ticks are discrete and the inter-tick gap is short. [judg] 55-115 ms between detents while spinning, a creep of a pixel or two per tick, and an occasional larger settle when the burst ends. scrollrgK@\@r@p@rMg333333?gffffff?)rhrirjrkrmrrrrar scroll_driftg>@r5r"r$rgQ?r@g@r,r#rrgt@)r:rrrrr _WHEEL_KINDr8rvrbrrrrrrIrhrirw)r&rrrrVrUr4rrrrrrrrr'r(s r1rrs8 T8U##AE C 3ua== ! !--()Eaiie$$$qyyu/E/E TCFc!fs*$qyyt'<'<<>>> ? ? ? 88::  #aiiS&9&99C))Ctw//CQ# --s1vdhsmm8K/KLDw3>&#$99T4#8#8& #t0D0DFFFC - S!!!2wy#b'), d""3!4!44iiS47]++ VcDHSMM) )3q6C$(3--4G+G H   7AsDwv yy66"AIIdE,B,BDDD  S Lr3boxBoxuxuycZ|\}}}}t||zt||zzS)zEExtent of a rectangle along the direction of travel - the W in Fitts.)r8)r]r_r`rrr/s r1_support_widthrb[s.JAq!Q q2v;;QV $$r3rr)spreadkeeprcrdc|\}}}}||dz z||dz z} }t||||z|||zz |||zz} t|| ||z| ||zz | ||zz} | | fS)aWhere inside a control the pointer actually stops. [judg] Gaussian about the centre with sigma = ``spread`` of the box side, clipped to the middle ``2 * keep`` of it, so the landing is inside, biased to the middle, and essentially never the exact geometric centre. Landing on the centre pixel of every control is a stronger signal than any curve shape: it is one exact number, it is the same number for every install, and any handler can read it off a single event. The default clip is tight on purpose. This point is also handed to the automation layer as the click position, and a point far out towards a border is a point that a rounded corner, a rotated element or an inline box that does not fill its bounding rectangle can fail to contain. r)r\rd) r]r]rcrdbxbybwbhcxcyrhris r1rras NBB "s(]BcMBsyyR&[))2r >2r >JJAsyyR&[))2r >2r >JJA q6Mr3widthctjt|dt|dz dz}dd|zz|jz}t |ddS)a!Probability that this movement overshoots and needs a correction. [lit] Meyer et al.'s optimised-submovement account: pointing is a fast ballistic primary submovement plus, when the primary misses, one or more slower corrective submovements. Corrections get more likely as the index of difficulty rises - far targets and small targets. [judg] the intercept and slope below, and the persona multiplier; they are set so that an easy move (ID ~ 1) corrects rarely and a hard one (ID ~ 6) corrects most of the time. rr皙?g(\µ?gQ?g)\(?)rbrrr|r\)rrrlrrs r1overshoot_probabilityroxsW )C#&&UC83> ? ?C  w55A !T4  r3)r4landingtargetrpct|d|}t||} || n|}|d|dz |d|dz } } tj| | } | dkrgS| | z | | z }} t t || |d}g}|t|| |krt| dd| z| d dz}t|d t d d | z}| dd |z}t|d| |zz||zz |d||zz| |zzf|}|t||||d|t |dzd|z }|r|dj|djfn|}t| dddd}t||||d|||| }||z }|r|dkrt|d| ddz|d| ddzf|}|t||||d|| dd|t| dddd z }n4|d krtt| dd| zd zd t dd | z}|d| |zz |d||zz f}|t||||d|t |d zd!|z }|r|dj|djfn|}|t||||d|| d"d#|t| d$ddd z }n|t||||d|||z }|S)%aPlan a movement that ends on a control, the way a hand ends on one. ``landing`` overrides where inside the control the pointer stops. The caller passes it when it also has to tell the automation layer where to click: the two must be the same point, or the pointer lands on one pixel and the click is dispatched at another. Three outcomes, in decreasing order of frequency for hard targets: overshoot + correct the primary submovement carries past the target, the eye catches it, a short corrective submovement comes back. [lit] Meyer et al. 1988. undershoot + settle the primary stops short and the hand creeps in. straight in one submovement, lands, done. The dwell between the primary and the correction is not padding: [lit] visually-guided correction cannot start before roughly 100-150 ms of feedback delay, so the gap exists in real pointing and its absence is itself informative. r"NrrMrrrag ףp= ?g?rr5g{Gz?rrgd@rkrrrrg@_@r"gF@gq@r#r2rrgI@g@`@g[@rZr$gQ?rnr#rgg@rY)r:rrbhypotrrbr8ror8rdrr\rrrhri)r&rrrqrr4rprrdrawnrlrmdistr_r`rlroverlateralpastrrcorrmicroshortstops r1rrs[> T:u%%A &! $ $EeeGG QZ&) #WQZ&)%;B :b"  D czz $YT B vr2.. 4 4EExxzz)'4????1773 --..31D1DDdCS$+!6!677''#td{++ QZ"t) #b7l 2 QZ"t) #b7l 2 4    gq&$Z"53;66xIII I,1=uRy{E"IK((vqwwud++T599GQW9V"8UDDD    MAHHJJ%% aggc3///aggc3>O>O1OPE T'1gu9!'QYYtU5K5K!)"()=)=tU"K"KMMM ME d  s1773 5566.s00%r2r2a++++BG++++Hd1g0H0H0H0Hb0H0H0H0H000000r3r1rrs)r:listrranyrr)r&rrrr~r4rrrr/boxesr'rrs @r1rrs & T9e$$A DAq "  E GQW D 2YY $(D1H--qyy4!8/L/LM0000).00000  E  FLx$@$@FU8 M M MMr3ceZdZUdZded<ded<ded<ded<ded<ded <ded <ded <ded <ded <ded<dS)rzFDescriptive statistics of a planned timeline. No I/O, pure arithmetic.rXtotal_ms active_msactive_fractionr'n_stepsn_movesn_wheeln_burstsn_duplicate_positionsbursts_on_controlon_control_fractionlongest_pause_msN)rQrRrSrTrnrVr3r1rrsPPOOOLLLLLLLLLMMMr3rc d}d}dx}x}x}x}}d}d} d} d} |D]} || jz }| jtvrD| jtkr|dz }| r|dz }| tvr|dz }d} t || j}d} ^|dz }| jt kr | r || jz }n,| r|dz }| tvr|dz }t || j}d} | j} t| jt| j f} | | | kr|dz }| } | r|dz }| tvr|dz }t|||dkr||z ndt|||||||r||z nd| S) a>Reduce a timeline to the numbers worth asserting on. ``active_ms`` is wall time spent inside a burst of motion: the delay of a move step counts as active when it is short enough to be part of a continuous movement (``BURST_GAP_MS``). The long delay that opens a burst is the pause before it and counts as still. Applied to the behaviour this module replaces - one ~1 s movement every twenty-odd seconds and nothing in between - this measure yields the ~4% that motivated the work, so the "after" number is comparable to the "before" number. rarNFrMT) rrrrrrrrrrr) rjrkrr\_ON_CONTROL_KINDSrr rrhrirr)rtotalactivemovesr$burstsdupson_ctrl longest_pauseprev_posin_burstlast_move_kindrrs r1rr,s E F.//E/E/F/TGM*.HHN   6& & &v$$  !! !%666qLG  qz::MH    : % %( % aj FF !! !%666qLG qz::MHQSzz5::&  C8OO AID!  . . . qLG ,1AII%3E "!28AWv--c&    r3)r&r'r(r)r*r'rP)r&r'r(r)r4r'r*r5)r;r'r<r'r*r')r?r@rAr'r*r')rWrXrYrXrZrXr*rX)r]r5r^rXr_rXr*rX)rr)r*r))rMr)rrrr'r4r'r*r)rr)rrr4r'r*r)rrM) rrrKr)r4r'rr'r*rX) rrr]r5rrXrrXr*rX)rrr]r5rrrrrkr)rrrrrrrrXrrXrrXr*r) rrrkr)rrXrrrrr*r) rrrrXrrrrr*r)r&r'rrr*r)rrr]r5r*rX)r)rrrrrrXr*r)r0rr*rF)r&r'rrrrrrrrXr4r'rrr*r)r&r'rrrrrrrVr'rUrXr4r'rrr*r)r]r^r_rXr`rXr*rX) r]r^r]r5rcrXrdrXr*r)rrrrXrlrXr*rX)r&r'rrrrrqr^rrr4r'rprrrr*r)r&r'rrrrrrr~rr4r'rrr*r)rrr*r)GrT __future__rrbr8 dataclassesrrrrrrr r r r __all__rXrr^r frozensetrr\rNrr2r:rrrr\rer rrsetrrrrrrrrrrrrr rrr)r/r3r:r<rArnallzipr>rrrbrrorrrrrVr3r1rs>PPPb#""""" !!!!!!   . eUl E5% &' Iz9566  I{J788    <<<<<5555====*''''''''''''''''T3333 4 4 4 4" $!!!!!!!!\ Cf% & $p p p p p p p p PS= > > cJKK  $JRJRJRJRJRJRJRJRZ78:     FDE!" G G G G G&$$$$8$($%$%$%$%$%$%V" >>>>>>B1111pKKKK0PPPPPPPPP( $        4$ 8 8 8 8 % % % %HHHH $))))))))L4..L$ ,,Lz**L$ ,, , s O Oss>>!"";M'N'N O O OOOFFDFFOb$$$K%$$VVVVVVH??????L%%%% DH $.!!!!0#XXXXXXJ&*MMMMMMf $         DDDDDDr3