cozyclay 2.1.1 → 3.0.1

package/src/motion3/rigs/y-bot-tpose.json

@@ -0,0 +1 @@
+{"model":"y-bot-tpose","units":"cm","mesh":"Alpha_Surface","bones":[{"name":"Hips","parent":-1,"localPos":[-0.000006757011760782916,99.79193878173828,0.00004844740033149719],"localQuat":[7.615435492247396e-11,-0.0000017453292503320135,0.00004363323128594654,0.9999999990465473],"worldPos":[-0.000006757011760782916,99.79193878173828,0.00004844740033149719],"worldQuat":[7.615435492247396e-11,-0.0000017453292503320135,0.00004363323128594654,0.9999999990465473]},{"name":"Spine","parent":0,"localPos":[0.0008597856133863019,9.923461876522225,-1.2273349078167588],"localQuat":[-0.06073022898235704,5.303745488019905e-22,0.000006119354919596912,0.9981542161661715],"worldPos":[-0.000008672608244745512,109.71540069587908,-1.227286457407732],"worldQuat":[-0.060730228859120175,-0.000004391963877518737,0.00004956605444176136,0.9981542149520963]},{"name":"Spine1","parent":1,"localPos":[0,11.731977989043784,-3.552713678800501e-15],"localQuat":[0.0001960924550491026,4.662287733052689e-14,-0.000009316072744031837,0.9999999807304797],"worldPos":[-0.0011632832276606084,121.36083978703566,-2.649627688070991],"worldQuat":[-0.06053449713743436,-0.00000494801144686156,0.00004026803743853935,0.9981661049195772]},{"name":"Spine2","parent":2,"localPos":[1.931491945550423e-11,13.458836780167971,6.235012506294879e-13],"localQuat":[0.057711730916465316,0.0000021958232674411106,0.000003285013706200134,0.9983332890868721],"worldPos":[-0.0022371547694859653,134.72103871836885,-4.27608729015328],"worldQuat":[-0.002827710078055566,-2.2517339024978275e-7,0.00004363254684471116,0.9999960010679366]},{"name":"Neck","parent":3,"localPos":[0.00002548122992670175,15.027761372130044,0.8779068542021755],"localQuat":[0.0028277058943183713,-8.816242878226746e-39,-7.234126583784003e-21,0.9999960020316957],"worldPos":[-0.003523660156014883,149.7535246254643,-3.4831824403326026],"worldQuat":[-4.186445695616128e-9,-1.017924801167934e-7,0.00004363300912729469,0.999999999048075]},{"name":"Head","parent":4,"localPos":[0.000002562548663041439,10.32183835340436,3.1424288991299827],"localQuat":[1.2407709188295404e-24,1.3234889800848435e-23,-3.3812794736012347e-21,1],"worldPos":[-0.0044224830930743595,160.07536296607333,-0.3407536277174854],"worldQuat":[-4.1864456956161264e-9,-1.0179248011679337e-7,0.000043633009127294685,0.999999999048075]},{"name":"HeadTop_End","parent":5,"localPos":[0.00015451594228192873,18.474670356296826,6.63639947863672],"localQuat":[6.93889473108785e-18,-6.61744490042423e-24,-1.0158249377722142e-20,1],"worldPos":[-0.005881529143937624,178.55003332101543,6.295645696100038],"worldQuat":[-4.186445688677232e-9,-1.0179248011679308e-7,0.00004363300912729468,0.999999999048075]},{"name":"LeftShoulder","parent":3,"localPos":[6.105824524896,9.10629188078309,0.757062475638635],"localQuat":[-0.45383506682997793,-0.5448493479758866,0.5511388470821386,-0.4397941465761588],"worldPos":[6.10279217248512,143.83199925791556,-3.5705353792059826],"worldQuat":[-0.4525659925709384,-0.5433084112379314,0.5526580275773418,-0.44109987213863294]},{"name":"LeftArm","parent":7,"localPos":[4.884981308350689e-15,12.92228632488431,2.842170943040401e-14],"localQuat":[-0.010451820107802023,-0.0010627185813176982,0.10115046260752789,0.9948156683526521],"worldPos":[18.75785325853472,143.5671732022338,-6.171454434247386],"worldQuat":[0.49997802104022876,0.5000219779933275,-0.4999777974641308,0.5000222015503447]},{"name":"LeftForeArm","parent":8,"localPos":[3.059411390893274e-9,27.404682159441652,-2.842170943040401e-14],"localQuat":[-1.0173904404505293e-20,6.815758221109549e-27,1.3234889800848457e-23,1],"worldPos":[46.162535310990236,143.5695947084291,-6.171442183765884],"worldQuat":[0.49997802104022876,0.5000219779933275,-0.4999777974641308,0.5000222015503447]},{"name":"LeftHand","parent":9,"localPos":[-0.000012820418092474029,27.614463806173113,2.3361064904747764e-7],"localQuat":[-3.397640826470449e-21,-1.8680226235633534e-27,5.2939559203393736e-23,1],"worldPos":[73.77699900937316,143.57203451753804,-6.171417016006557],"worldQuat":[0.49997802104022876,0.5000219779933275,-0.4999777974641308,0.5000222015503447]},{"name":"LeftHandRing1","parent":10,"localPos":[2.216630558205681,12.147010274148471,-0.009996226470974534],"localQuat":[5.56794949511021e-7,-3.067028835367668e-9,0.000004777353976607745,0.9999999999884335],"worldPos":[85.92400934395243,143.5831040665074,-8.388042142881478],"worldQuat":[0.49998068669282075,0.5000193094968617,-0.4999756886184537,0.500024313263825]},{"name":"LeftHandRing2","parent":11,"localPos":[0,3.601188659840844,0],"localQuat":[-0.000002306826384812874,1.861861504887997e-11,-0.000008071095064110734,0.999999999964768],"worldPos":[89.52519798990681,143.58341826103262,-8.388006124364832],"worldQuat":[0.4999754975118546,0.5000244982373176,-0.49997857087756026,0.5000214312542258]},{"name":"LeftHandRing3","parent":12,"localPos":[-7.140954494389007e-13,3.3073120118204997,2.2737367544323206e-13],"localQuat":[-3.2584970000852863e-21,-2.067951531382572e-25,-6.352747104407258e-22,1],"worldPos":[92.83250998771065,143.5837220743585,-8.388026432414401],"worldQuat":[0.49997549751185466,0.5000244982373176,-0.49997857087756026,0.5000214312542258]},{"name":"LeftHandRing4","parent":13,"localPos":[-0.0000241726316367874,3.660118102908669,0.000016886514032421474],"localQuat":[0.000008486035821629225,0.007396474405473809,0.0007707649842267434,0.9999723486255485],"worldPos":[96.49262807680708,143.5840414103271,-8.388024734185503],"worldQuat":[0.5040493957792119,0.5033194611486261,-0.4958855340273986,0.4966903097363882]},{"name":"LeftHandMiddle1","parent":10,"localPos":[-0.000018344155402694184,12.77552795411546,-0.0000010320898695681535],"localQuat":[5.567949752588633e-7,-2.6633364343577455e-9,2.0800236288001427e-7,0.9999999999998233],"worldPos":[86.55252691351437,143.5731644085546,-6.171392959489538],"worldQuat":[0.49997840212413347,0.5000215942797767,-0.49997797319957754,0.5000220284932966]},{"name":"LeftHandMiddle2","parent":15,"localPos":[-3.552713678800501e-15,3.61396789550858,-2.842170943040401e-14],"localQuat":[2.3697741078528623e-20,6.203854594147698e-25,-2.6469779601696844e-23,1],"worldPos":[90.16649479526663,143.5734797180353,-6.171389840137076],"worldQuat":[0.49997840212413347,0.5000215942797767,-0.49997797319957754,0.5000220284932966]},{"name":"LeftHandMiddle3","parent":16,"localPos":[0.000028508498060020315,3.4597625732240687,-8.526512829121202e-14],"localQuat":[1.692147750009982e-20,2.0679515313825724e-25,2.64697796016969e-23,1],"worldPos":[93.62625735534596,143.57378157349484,-6.171415362383127],"worldQuat":[0.49997840212413347,0.5000215942797767,-0.49997797319957754,0.5000220284932966]},{"name":"LeftHandMiddle4","parent":17,"localPos":[-0.000030473889779614183,3.680191040059995,-2.842170943040401e-14],"localQuat":[-0.00000133272714831852,0.004579424073341433,-0.000654144096597114,0.9999893004272004],"worldPos":[97.30644838137125,143.57410266077613,-6.171381711981186],"worldQuat":[0.5019349111684311,0.5026337814312043,-0.4980094305837711,0.4974004762403589]},{"name":"LeftHandThumb1","parent":10,"localPos":[-3.002975029424964,3.7888090485209744,2.1671489778191813],"localQuat":[0.25189492500135036,-0.05946403657250492,0.2219235197808198,0.940086659027326],"worldPos":[77.56599819190912,141.40522033116738,-3.168440292478436],"worldQuat":[0.6772116616355364,0.20343190021506413,-0.5147394802435296,0.484812432594653]},{"name":"LeftHandThumb2","parent":19,"localPos":[-1.9984014443252818e-15,4.744970523440218,2.842170943040401e-14],"localQuat":[0.0000069460704858849485,5.5796786860811154e-12,8.032883032279416e-7,0.9999999999755533],"worldPos":[81.24162844278966,139.28353174695044,-1.0464306132517085],"worldQuat":[0.6772151925776482,0.20342778079987783,-0.5147405038353289,0.48480814210593404]},{"name":"LeftHandThumb3","parent":20,"localPos":[-5.984102102729594e-13,4.3821287009303775,5.172751116333529e-12],"localQuat":[7.030691099565929e-18,7.121429504040547e-18,-1.5407439555097887e-32,1],"worldPos":[84.63615479208448,137.32403482337068,0.9133179986734019],"worldQuat":[0.6772151925776482,0.20342778079987775,-0.5147405038353289,0.48480814210593404]},{"name":"LeftHandThumb4","parent":21,"localPos":[-0.0000051284654249972306,3.459077859769903,4.03463474185628e-7],"localQuat":[0.009146816027813427,0.1256374250101491,0.07207247635857116,0.9894125182879566],"worldPos":[87.31565650284612,135.77728679427992,2.4602700847142343],"worldQuat":[0.7538118553684166,0.20866722684171796,-0.3911265183168664,0.4850213622280347]},{"name":"LeftHandIndex1","parent":10,"localPos":[-2.822044006965872,12.266617250897596,0.23182516767607808],"localQuat":[5.567949601161418e-7,-3.075281477739248e-9,0.00000487076476385117,0.9999999999879827],"worldPos":[86.04363543486608,143.34129324170544,-3.34936752423002],"worldQuat":[0.49998073339592125,0.5000192627891642,-0.4999756419148924,0.5000243599710406]},{"name":"LeftHandIndex2","parent":23,"localPos":[-1.3322676295501878e-15,3.891967773631521,0],"localQuat":[-3.0225470980600983e-21,0,-0.000006214320207710297,0.999999999980691],"worldPos":[89.93560319348254,143.34163280596658,-3.349327870283342],"worldQuat":[0.49997762610645813,0.5000223698198841,-0.4999787492167228,0.5000212529526508]},{"name":"LeftHandIndex3","parent":24,"localPos":[4.071321058063404e-11,3.415161132822689,-1.1368683772161603e-13],"localQuat":[4.6684518186119064e-23,-9.183549615799121e-41,2.1175823681357537e-22,1],"worldPos":[93.35076431329836,143.34193077006435,-3.3493355202090695],"worldQuat":[0.49997762610645813,0.5000223698198841,-0.4999787492167229,0.5000212529526508]},{"name":"LeftHandIndex4","parent":25,"localPos":[5.854722480158614e-7,3.0779876709090814,5.684341886080802e-14],"localQuat":[0.0000010393592226093013,0.004001602788212073,0.000022779581052790166,0.9999919932955144],"worldPos":[96.4287519724834,143.34219931663745,-3.3493430003052733],"worldQuat":[0.5019862492920715,0.5020073437901309,-0.4979631636001596,0.4980272281710877]},{"name":"LeftHandPinky1","parent":10,"localPos":[4.72583130478205,10.908194092064392,0.22613216873591568],"localQuat":[0.0000028521120612919424,-3.0577730863769185e-9,0.000141051374267014,0.9999999900481878],"worldPos":[84.68521515320175,143.3468662092345,-10.897243443373178],"worldQuat":[0.5000499694422342,0.49995002290857044,-0.49990869131728644,0.5000912946652625]},{"name":"LeftHandPinky2","parent":27,"localPos":[-5.329070518200751e-15,4.136657059551979,2.842170943040401e-14],"localQuat":[-0.0000059544873416476465,2.190560405006969e-9,-0.0003678839387923365,0.9999999323129735],"worldPos":[88.82187203349876,143.3472081321215,-10.896074631422186],"worldQuat":[0.4998630353195086,0.5001369272162459,-0.5000896549937187,0.49991032888321396]},{"name":"LeftHandPinky3","parent":28,"localPos":[4.3876013933186186e-13,2.594834461051775,0],"localQuat":[0.0000036591694282576963,8.409112616016821e-10,0.00022980932036022433,0.999999973587143],"worldPos":[91.41670621645012,143.34745351466333,-10.897250657097295],"worldQuat":[0.49997978792115133,0.5000202113293842,-0.49997658739741363,0.5000234114387793]},{"name":"LeftHandPinky4","parent":29,"localPos":[-2.948752353404416e-13,2.9238662720287607,-2.842170943040401e-14],"localQuat":[-0.0000010497831164166655,0.004099894588367042,-0.0005750644579927158,0.9999914300453439],"worldPos":[94.34057247729058,143.3477086145383,-10.89723194250163],"worldQuat":[0.5017372856540723,0.5023540149301887,-0.4982094589732469,0.49768210220741194]},{"name":"RightShoulder","parent":3,"localPos":[-6.1056956701096174,9.10638358733786,0.7570756312724551],"localQuat":[0.4538375688887134,-0.5448472538987562,0.5511399888422243,0.43979272809263187],"worldPos":[-6.1087279840345,143.8310253866605,-3.5705252284969617],"worldQuat":[0.45261579666489365,-0.5432669079313696,0.5526977464106563,0.44105012013225253]},{"name":"RightArm","parent":31,"localPos":[3.9968028886505635e-15,12.922286714484947,0],"localQuat":[-0.01045541384979725,0.0010630628959740092,-0.10114940861202837,0.9948157373885607],"worldPos":[-18.763745414580892,143.56389953844294,-6.171423447408117],"worldQuat":[0.5000215299672571,-0.4999784691060287,0.5000215360351153,0.4999784630368383]},{"name":"RightForeArm","parent":32,"localPos":[8.327427636345419e-9,27.404682159441318,-2.842170943040401e-14],"localQuat":[-3.388329060809388e-21,-1.5146129380243438e-28,8.271806125530284e-25,1],"worldPos":[-46.16842747236397,143.56153906740224,-6.171423771692651],"worldQuat":[0.5000215299672571,-0.49997846910602883,0.5000215360351153,0.4999784630368383]},{"name":"RightHand","parent":33,"localPos":[0.000012842842382454478,27.614463806155165,0.000015492399938921153],"localQuat":[-1.9727179218464944e-25,-7.573064690121704e-29,0,1],"worldPos":[-73.78289117474843,143.55914503465877,-6.17141126400836],"worldQuat":[0.5000215299672571,-0.4999784691060287,0.5000215360351153,0.4999784630368383]},{"name":"RightHandThumb1","parent":34,"localPos":[3.002974470681663,3.7888088905192205,2.1671490371761024],"localQuat":[0.25189499102226326,0.05946427874712486,-0.2219234615465524,0.9400866397658112],"worldPos":[-77.57151342274972,141.3916696607838,-3.168436839313407],"worldQuat":[0.6772291629398663,-0.20337279117491877,0.5147821060302558,0.4847675236487542]},{"name":"RightHandThumb2","parent":35,"localPos":[-6.8833827526759706e-15,4.744970470128291,2.842170943040401e-14],"localQuat":[0.000008453832451066965,-3.3376070678072775e-12,-3.9480215616198235e-7,0.9999999999641884],"worldPos":[-81.24677425676067,139.26933968812125,-1.0464288158806956],"worldQuat":[0.6772333413527709,-0.20336817191604672,0.5147836339017984,0.48476200168592604]},{"name":"RightHandThumb3","parent":36,"localPos":[-1.7763568394002505e-13,4.382135391768333,-4.092726157978177e-12],"localQuat":[-1.4347996972659013e-17,-5.998687332454958e-18,-1.387778780781447e-17,1],"worldPos":[-84.64095942776746,137.30923516924733,0.9133180789494266],"worldQuat":[0.6772333413527709,-0.20336817191604672,0.5147836339017984,0.48476200168592604]},{"name":"RightHandThumb4","parent":37,"localPos":[0.000011177533225659175,3.4590709023307085,-0.000023241859054223823],"localQuat":[0.00923206336161341,-0.1271302153500302,-0.0723276818427547,0.989202397788438],"worldPos":[-87.32019182850055,135.76203483248253,2.460268746809576],"worldQuat":[0.7545499013151971,-0.2090649481886763,0.389944180490974,0.4846543407061524]},{"name":"RightHandIndex1","parent":34,"localPos":[2.822042502024897,12.266617102415225,0.23182522345669554],"localQuat":[5.567922673046469e-7,-7.224337929733461e-9,-0.000004743924457641052,0.9999999999885925],"worldPos":[-86.04948829791044,143.32626324098368,-3.3493689108641775],"worldQuat":[0.5000241838181078,-0.4999758222398485,0.5000194389411731,0.4999805530753941]},{"name":"RightHandIndex2","parent":39,"localPos":[0,3.891967773619811,0],"localQuat":[1.695401251774016e-20,-4.135903062840235e-25,0.00000602627167052741,0.9999999999818419],"worldPos":[-89.94145605654246,143.32592367674323,-3.3493320316989923],"worldQuat":[0.5000211708188947,-0.4999788355123435,0.5000224519507367,0.4999775398133359]},{"name":"RightHandIndex3","parent":40,"localPos":[-5.1669779566054785e-12,3.4151611328221207,1.1368683772161603e-13],"localQuat":[-1.3593959205239575e-20,0,0,1],"worldPos":[-93.35661717635494,143.32562571266394,-3.349340831998884],"worldQuat":[0.5000211708188947,-0.4999788355123435,0.5000224519507367,0.4999775398133359]},{"name":"RightHandIndex4","parent":41,"localPos":[-0.0000012771572572845002,3.0779876709101757,-2.842170943040401e-14],"localQuat":[-0.00007290381402922513,-0.006709307422924062,0.0013745331778991744,0.9999765449936721],"worldPos":[-96.4346048355366,143.3253571661075,-3.3493500406116747],"worldQuat":[-0.5026405594004304,0.5040453607575476,-0.49730671352060296,-0.49596045712511533]},{"name":"RightHandMiddle1","parent":34,"localPos":[0.000016632154487439266,12.775527954114011,-0.0000010320893863990932],"localQuat":[5.567949633221699e-7,-7.289108692409176e-9,-3.662527039828292e-7,0.9999999999997777],"worldPos":[-86.55841908156046,143.55804566121927,-6.171394786911078],"worldQuat":[0.5000219951158138,-0.4999780112066047,0.5000216276573223,0.4999783641170999]},{"name":"RightHandMiddle2","parent":43,"localPos":[8.881784197001252e-16,3.6139678955093757,0],"localQuat":[-3.3759614098155274e-21,-4.135903062765133e-25,0,1],"worldPos":[-90.17238696331393,143.55773035173834,-6.171392183522983],"worldQuat":[0.5000219951158138,-0.4999780112066047,0.5000216276573223,0.4999783641170999]},{"name":"RightHandMiddle3","parent":44,"localPos":[-0.000029421479796454264,3.4597625732165085,1.4210854715202004e-13],"localQuat":[3.4003021678244415e-21,-8.271806125530284e-25,-7.940933880509075e-23,1],"worldPos":[-93.63214952338268,143.55742849627876,-6.1714191126993185],"worldQuat":[0.5000219951158138,-0.4999780112066047,0.5000216276573223,0.4999783641170999]},{"name":"RightHandMiddle4","parent":45,"localPos":[0.000028549065814509333,3.680191040067001,-5.684341886080802e-14],"localQuat":[-0.00005158123071926063,-0.006695195594000001,-0.0017083442773867367,0.9999761263426065],"worldPos":[-97.31234054942114,143.557107408997,-6.171387912540353],"worldQuat":[0.504186145435319,-0.5024851098604104,0.49578202059538456,0.49749897806327625]},{"name":"RightHandRing1","parent":34,"localPos":[-2.216632303077052,12.147002761381543,-0.009996270293299858],"localQuat":[5.567954667309114e-7,-7.224304767843245e-9,-0.000004803651127566965,0.9999999999883074],"worldPos":[-85.92989472518438,143.5680950366908,-8.38804371451417],"worldQuat":[0.5000242136815972,-0.49997579237346873,0.5000194090805982,0.49998058293828956]},{"name":"RightHandRing2","parent":47,"localPos":[0,3.6011962892353893,-8.526512829121202e-14],"localQuat":[-5.732183384702703e-21,0,0.000008071083662125689,0.9999999999674287],"worldPos":[-89.53109100054763,143.5677808414962,-8.388009160440863],"worldQuat":[0.5000201783188615,-0.4999798280944457,0.5000234444494263,0.4999765472235214]},{"name":"RightHandRing3","parent":48,"localPos":[-6.055600465515454e-12,3.307312011785328,-1.1368683772161603e-13],"localQuat":[3.2821615918857455e-21,-3.6734198463196485e-40,2.1175823681357546e-22,1],"worldPos":[-92.83840299967426,143.56749228695628,-8.38803081342569],"worldQuat":[0.5000201783188615,-0.4999798280944457,0.5000234444494263,0.4999765472235214]},{"name":"RightHandRing4","parent":49,"localPos":[0.00002417262415121968,3.6601181029476635,-2.842170943040401e-14],"localQuat":[-0.00006164489635359998,-0.007613221748708619,-0.000300224892743606,0.9999709720384515],"worldPos":[-96.49852108877111,143.56717295098406,-8.388030603602541],"worldQuat":[0.5039317385023292,-0.503652452411389,0.49602123868179077,0.49633651979941534]},{"name":"RightHandPinky1","parent":34,"localPos":[-4.725833119502555,10.90819434071372,0.2261320753251539],"localQuat":[5.567949828639406e-7,-7.530380981813863e-9,-0.000003132050030138696,0.99999999999494],"worldPos":[-84.69106594001192,143.3320733953033,-10.897244515904388],"worldQuat":[0.5000233780731588,-0.4999766283665967,0.5000202446951756,0.49997974695226793]},{"name":"RightHandPinky2","parent":51,"localPos":[0,4.13665008553545,-2.842170943040401e-14],"localQuat":[1.470867824118891e-22,8.271806125977124e-25,0.000010394374390791114,0.9999999999459783],"worldPos":[-88.8277160097222,143.33171248313417,-10.897218653721097],"worldQuat":[0.5000181811018849,-0.4999818257697831,0.5000254416448413,0.49997454952763204]},{"name":"RightHandPinky3","parent":52,"localPos":[-3.950617610826157e-12,2.5948410036845218,-8.526512829121202e-14],"localQuat":[6.674018442413745e-21,1.836709923259698e-40,-0.000010428465638715964,0.9999999999456235],"worldPos":[-91.42255700325643,143.33148608987582,-10.897256374372848],"worldQuat":[0.5000233951179858,-0.49997661132017523,0.5000202276502416,0.4999797639985816]},{"name":"RightHandPinky4","parent":53,"localPos":[4.362732397567015e-12,2.923866272034857,5.684341886080802e-14],"localQuat":[-0.00008226663950025322,-0.00849884034311731,0.0022061069470672434,0.9999614472754239],"worldPos":[-94.34642326410449,143.33123099000105,-10.897237895108226],"worldQuat":[-0.5031095764062739,0.5053508241180749,-0.4968132089402998,-0.4946493041680384]},{"name":"LeftUpLeg","parent":0,"localPos":[9.123873709849553,-6.657188518716367,-0.05540310527662988],"localQuat":[0.000020251728747483253,-0.006350177975401161,0.9999754277247583,-0.002969642442257367],"worldPos":[9.12444806072654,93.13554649657034,-0.05532280954860631],"worldQuat":[0.000018783520922709306,-0.006350171978846871,0.999975297231096,-0.00301328568169704]},{"name":"LeftLeg","parent":55,"localPos":[-4.618527782440651e-14,40.59943638074365,1.170175067954915e-13],"localQuat":[-0.018114309191591866,0.00018249364298742092,-0.005920146666904975,0.9998183786878614],"worldPos":[9.369107731941927,52.540121711606496,-0.5709414745281038],"worldQuat":[-0.0000715314874584385,-0.02446331907456045,0.9996964939479204,0.00290876113461602]},{"name":"LeftFoot","parent":56,"localPos":[-1.0658141036401503e-14,42.09902591219656,2.0872192862952943e-14],"localQuat":[0.5405498192560871,0.01436647216366454,0.024951033886733327,0.8408192096329419],"worldPos":[9.12441738143423,10.49219684921195,-2.6300976499043784],"worldQuat":[-0.01346031169880001,0.5198601039256607,0.853859207560786,-0.022107600933591907]},{"name":"LeftToeBase","parent":57,"localPos":[1.7763568394002505e-15,15.721559146548017,-1.509903313490213e-14],"localQuat":[0.2276920621809942,-0.032521469150786096,-0.015365592016704316,0.9730686396375217],"worldPos":[9.497939603229476,3.2836504838127345,11.336461068911172],"worldQuat":[0.0016492651748272183,0.7007886739142866,0.7132730439227728,0.01157925951782756]},{"name":"LeftToe_End","parent":58,"localPos":[1.7763568394002505e-15,9.999999999999991,4.890746918562172e-9],"localQuat":[3.842630640765734e-10,-2.181956872127079e-18,8.673617379884037e-19,1],"worldPos":[9.355871856763304,3.108427383452366,21.333916426176543],"worldQuat":[0.0016492651792767014,0.700788674188371,0.7132730436534856,0.011579259517193808]},{"name":"RightUpLeg","parent":0,"localPos":[-9.125032356625555,-6.655601347887028,-0.05535274484958799],"localQuat":[-0.000017972283601838397,-0.006333801286546503,0.9999752669985558,0.0030574547301418053],"worldPos":[-9.12445807483328,93.1355411499169,-0.055336149820714026],"worldQuat":[-0.000019441205218510228,-0.006333807477113975,0.9999753994199062,0.00301381152055421]},{"name":"RightLeg","parent":60,"localPos":[7.105427357601002e-15,40.59943859177964,2.6645352591003757e-14],"localQuat":[-0.018147073530042527,-0.00018249394989624574,0.005920149654138874,0.9998177845219228],"worldPos":[-9.369160167563622,52.54009755727,-0.5696263108436963],"worldQuat":[0.00007086285029500266,-0.024479715368387448,0.9996960941175567,-0.0029082503401009767]},{"name":"RightFoot","parent":61,"localPos":[-2.4868995751603507e-14,42.09902387472938,-6.217248937900877e-14],"localQuat":[0.5405636018310247,-0.014366037304083883,-0.024951225824318232,0.8408103506008421],"worldPos":[-9.12451164224619,10.492242047309674,-2.6301615125796047],"worldQuat":[0.013459958226241265,0.5198600714589466,0.8538592128932476,0.02210837363015364]},{"name":"RightToeBase","parent":62,"localPos":[3.552713678800501e-15,15.721558809599616,2.6645352591003757e-15],"localQuat":[0.22770869920802236,0.03211960072148292,0.015257901862228916,0.9730797891155923],"worldPos":[-9.498060396707743,3.2836958492734345,11.33639620371245],"worldQuat":[-0.0013617607248561205,0.700801240791512,0.7132661380535977,-0.011277536030161229]},{"name":"RightToe_End","parent":63,"localPos":[3.1880595940947387e-9,9.999999999999998,5.687534443410414e-9],"localQuat":[-3.109963189751316e-10,-1.6439215440311446e-16,-1.7347234759768052e-18,1],"worldPos":[-9.356269180688868,3.1086870931784847,21.33385924122101],"worldQuat":[-0.0013617607213487338,0.7008012405696887,0.7132661382715444,-0.011277536030584614]}],"landmarks":{"mouth":[0,158.399150390625,12.493875312805176],"headEllipsoid":{"centre":[-0.000016689300537109375,167.32984161376953,0.6807799339294434],"radii":[8.005595684051514,13.133369445800781,12.374487400054932]},"headJoint":[-0.0044224830930743595,160.07536296607333,-0.3407536277174854],"headTop":[-0.005881529143937624,178.55003332101543,6.295645696100038],"sole":{"ball":3.3,"tip":2.6}}}

package/src/motion3/scene.js

@@ -0,0 +1,60 @@
+// Scene records -> what the motion compiler and QA collide with: each drawable object as an
+// oriented box on its base pivot (bottom centre), sized by objectSize (scene-objects.js, the
+// one owner of footprint x scale) and turned by the renderer's Euler XYZ (rotX, rot, rotZ).
+// Every entry lists its `ancestors` (parent ids, nearest group first) and their poses
+// (`ancestorPoses`, the same order), so a group (an Empty, which has no box of its own) is known
+// by its parts (object-pose.js partsOf) and by its root pose. A saved take keeps scene.objects
+// and scene.others (take-source.js), so the groups are rebuilt from the entries: groupsOf.
+// `others` lists the records with no box (an Empty, a light, an effect, a plane) by id with their
+// renderer and ancestors: a switch entry (C15) may name them, and a skill finds a kit's lit parts
+// there. A body that glows (record.glow) says so (`glow: true`).
+import { objectSize } from "../object-size.js";
+import { mul, rx, ry, rz } from "./compiler/math.js";
+
+const NO_BODY = new Set(["empty", "plane", "cutout"]);
+
+/** Parent records of a record, nearest first (stops at a cycle, a missing parent or an attached record). */
+function ancestorsOf(o, byId) {
+	const out = [];
+	for (let p = byId.get(o.parent); p && !out.includes(p) && !p.attach; p = byId.get(p.parent)) out.push(p);
+	return out;
+}
+
+const poseOf = o => ({ pos: [o.x ?? 0, o.y ?? 0, o.z ?? 0], R: mul(rx(o.rotX ?? 0), mul(ry(o.rot ?? 0), rz(o.rotZ ?? 0))) });
+
+const groupCache = new WeakMap();
+
+/**
+ * The groups of a motion scene, rebuilt from its body entries: { id: { pos, R, ancestors,
+ * children } }. A group is body-less; `children` lists its direct children (bodies and groups).
+ */
+export function groupsOf(scene) {
+	const objects = scene?.objects ?? {};
+	if (groupCache.has(objects)) return groupCache.get(objects);
+	const groups = {};
+	for (const [id, o] of Object.entries(objects)) {
+		(o.ancestors ?? []).forEach((g, i) => {
+			const pose = o.ancestorPoses?.[i];
+			groups[g] ??= { pos: pose?.pos ?? [0, 0, 0], R: pose?.R ?? [[1, 0, 0], [0, 1, 0], [0, 0, 1]], ancestors: o.ancestors.slice(i + 1), children: [] };
+			const child = i ? o.ancestors[i - 1] : id;
+			if (!groups[g].children.includes(child)) groups[g].children.push(child);
+		});
+	}
+	groupCache.set(objects, groups);
+	return groups;
+}
+
+export function motionScene(objects = []) {
+	const out = {}, others = {}, byId = new Map(objects.filter(Boolean).map(o => [o.id, o]));
+	for (const o of objects) {
+		if (!o || o.hidden) continue;
+		const size = objectSize(o), up = ancestorsOf(o, byId);
+		if (NO_BODY.has(o.renderer) || !(size.width > 0 && size.height > 0 && size.depth > 0)) {
+			others[o.id] = { renderer: o.renderer, ancestors: up.map(p => p.id) };
+			continue;
+		}
+		out[o.id] = { name: o.name, renderer: o.renderer, ...poseOf(o), half: [size.width / 2, size.height / 2, size.depth / 2],
+			ancestors: up.map(p => p.id), ...(up.length ? { ancestorPoses: up.map(poseOf) } : {}), ...(o.glow ? { glow: true } : {}) };
+	}
+	return { objects: out, groups: groupsOf({ objects: out }), others };
+}

package/src/motion3/schema/brief.js

@@ -0,0 +1,89 @@
+// A JSON Schema fragment (describe.js) -> one short type line, for motion.describe
+// { topic: "essentials" }: `{f: int, set: object, step?: string[]}`. `?` marks an optional
+// field, `=v` a default, `lo..hi` a range, `A | B` a choice, `[key]: T` a map, `a_l|r` a field
+// that has a twin with the same type, `a|b?: T` optional fields with the same schema; a $ref to a
+// shared shape keeps its name (vec3, key, ...). With { means: true } each field also says what it
+// means, `hand_l|r?: vec3 (the WRIST target in world metres)`, from the schema's description.
+
+const BARE = { integer: "int", number: "number", string: "string", boolean: "bool" };
+/** Descriptions that say only the unit: the essentials notes give the units once. */
+const UNIT_ONLY = /^(degrees|m)$/;
+const range = s => (s.minimum !== undefined && s.maximum !== undefined ? ` ${s.minimum}..${s.maximum}` : "");
+/** A literal: strings in single quotes, so the JSON answer needs no escapes. */
+const lit = v => (typeof v === "string" ? `'${v}'` : JSON.stringify(v));
+const dflt = s => (s.default !== undefined ? `=${lit(s.default)}` : "");
+const wrap = t => (/[ |]/.test(t) && !/^[{[].*[}\]]$/.test(t) ? `(${t})` : t);
+/** The key name of a map from its description: "scene object or group id -> hinge or carry" -> "scene object or group id". */
+const keyOf = s => s.description?.match(/^(?:[^:]*: )?(.+?) -> /)?.[1] ?? "name";
+
+/** A value as a JS literal with single-quoted strings: an example inside a JSON string needs no escapes. */
+export function literal(v) {
+	if (Array.isArray(v)) return `[${v.map(literal).join(", ")}]`;
+	if (v && typeof v === "object") return `{${Object.entries(v).map(([k, x]) => `${k}: ${literal(x)}`).join(", ")}}`;
+	return lit(v);
+}
+
+/** The tail a description shares with an earlier one in the same line, from a word after ", " or ": ". */
+function sharedTail(d, earlier) {
+	let i = 0;
+	while (i < d.length && i < earlier.length && d[d.length - 1 - i] === earlier[earlier.length - 1 - i]) i += 1;
+	const tail = d.slice(d.length - i), cut = tail.search(/[,:] \S/);
+	return cut < 0 || tail.length - cut < 40 ? "" : tail.slice(cut + 2);
+}
+
+/** The fields of an object schema: `{ a: T, b?: T }`, a map `{ [key]: T }`, or both. */
+function objectLine(s, opts) {
+	const req = new Set(s.required ?? []), props = Object.entries(s.properties ?? {});
+	if (opts.depth === 0) return "object";
+	const inner = { ...opts, depth: opts.depth === undefined ? undefined : opts.depth - 1, seen: undefined };
+	// a long table of optional numbers with defaults (checks.limits): the names only
+	if (props.length > 8 && !req.size && props.every(([, v]) => v.type === "number" && v.default !== undefined)) return `{ [${props.map(([k]) => k).join("|")}]: number }`;
+	const twinned = new Set(props.map(([, v]) => v.$ref?.match(/^#\/properties\/(.+)$/)?.[1]).filter(Boolean));
+	const said = [];
+	/** "(meaning)" once: a meaning that ends like an earlier field's says "as <that field>" instead of the tail;
+	 * a field a sibling choice already explained (`opts.seen`, a switch's visible after a carry's) says nothing. */
+	const mean = (name, d) => {
+		if (opts.seen?.has(`${name}\0${d}`)) return "";
+		opts.seen?.add(`${name}\0${d}`);
+		for (const [n, e] of said) { const tail = sharedTail(d, e); if (tail) return ` (${d.slice(0, -tail.length - 2)}, as ${n})`; }
+		said.push([name, d]);
+		return ` (${d})`;
+	};
+	const typed = (name, v, t = briefType(v, inner)) => t + (opts.means && v.description && !UNIT_ONLY.test(v.description) && !t.includes(v.description) ? mean(name, v.description) : "");
+	// optional fields that read the same share one entry: `pitch|spine_pitch?: T`
+	const groups = new Map();
+	for (const [k, v] of props.filter(([, v]) => !v.$ref?.startsWith("#/properties/"))) {
+		const name = twinned.has(k) ? k.replace(/_l$/, "_l|r") : k, t = typed(name, v), same = req.has(k) ? `${k}\0` : t;
+		groups.set(same, { names: [...(groups.get(same)?.names ?? []), name], t, req: req.has(k) });
+	}
+	const fields = [...groups.values()].map(g => `${g.names.join("|")}${g.req ? "" : "?"}: ${g.t}`);
+	for (const [p, v] of Object.entries(s.patternProperties ?? {})) fields.push(`/${p}/: ${typed(p, v)}`);
+	const extra = s.additionalProperties && typeof s.additionalProperties === "object" ? s.additionalProperties : null;
+	if (extra) fields.push(`[${s.propertyNames?.enum?.join("|") ?? keyOf(s)}]: ${typed("", extra)}`);
+	return fields.length ? `{${fields.join(", ")}}` : `object${s.description ? ` (${s.description})` : ""}`;
+}
+
+/** schema -> type line; opts.means adds each field's meaning, opts.depth stops at that many object levels ("object"). */
+export function briefType(s, opts = {}) {
+	if (!s || typeof s !== "object") return "any";
+	const title = s.title ? `${s.title} ` : "", brief = x => briefType(x, opts);
+	if (s.$ref) return s.$ref.split("/").pop() + dflt(s);
+	if ("const" in s) return lit(s.const);
+	if (s.enum) return s.enum.map(lit).join("|") + dflt(s);
+	if (s.oneOf) {
+		const shapes = s.oneOf.filter(o => !(Object.keys(o).length === 1 && o.required)), picks = s.oneOf.flatMap(o => (shapes.includes(o) ? [] : o.required));
+		const own = s.type === "object" || s.properties ? objectLine(s, opts) : "";
+		// the choices share what they explained: a field that reads the same in an earlier choice says nothing more
+		const seen = new Set(), choice = shapes.length && shapes.every(o => o.pattern && !o.type) ? `string: ${shapes.map(o => o.description ?? o.pattern).join("; ")}`
+			: shapes.map(x => briefType(x, { ...opts, seen })).join(" | ");
+		return [title + own, choice, picks.length ? `(one of ${picks.join("|")})` : ""].filter(Boolean).join(" ") + (own ? "" : dflt(s));
+	}
+	if (s.type === "array") {
+		if (!s.items && !s.prefixItems) return `array${s.description ? ` (${s.description})` : ""}`;
+		if (s.prefixItems) return `[${s.prefixItems.map(brief).join(", ")}]`;
+		const n = s.minItems === s.maxItems && s.maxItems ? ` (${s.maxItems})` : s.maxItems ? ` (<= ${s.maxItems})` : "";
+		return `${wrap(brief(s.items))}[]${n}`;
+	}
+	if (s.type === "object" || s.properties) return title + objectLine(s, opts);
+	return (BARE[s.type] ?? "any") + range(s) + dflt(s);
+}

package/src/motion3/schema/fields.js

@@ -0,0 +1,44 @@
+// C1. The motion spec's field tables, the one source the validator (compiler/validate*.js),
+// the skills expander and motion.describe (describe.js) read. Channels, ranges and presets stay
+// in compiler/vocab.js, FIX_KEYS in fix/index.js, QA_LIMITS in qa/checks.js and the skill names
+// in skills/index.js; import those, never copy them here. See docs/motion-api-v3.1.md.
+
+/** Top-level spec fields. */
+export const SPEC_FIELDS = ["schema", "fps", "frames", "label", "keys", "anchors", "props", "fits", "objects", "generators", "checks", "fix", "use", "channels", "detourRadius", "search", "goals", "flow", "idle"];
+/** One key: { f, set, step?, src? } (src is written by the skills expander). */
+export const KEY_FIELDS = ["f", "set", "step", "src"];
+/** One spec.use entry. */
+export const USE_FIELDS = ["skill", "args", "f0"];
+/** Anchor fields by anchor kind (besides `kind`). */
+export const ANCHOR_FIELDS = { world: ["p"], body: ["p"], bone: ["bone", "offset"], segment: ["from", "to", "t", "tMin", "offset", "reach"],
+	object: ["object", "local"], landmark: ["name"], prop: ["prop", "point", "offset"], person: ["person", "bone", "offset"] };
+export const PROP_FIELDS = ["hand", "origin", "points"];
+export const FIT_FIELDS = ["side", "anchor", "effector", "offset", "orient"];
+/** spec.objects[id]: a hinge or a carry (a body or a group id), see C3; carry keys: C14; a switch (any record, C15) moves nothing; a follow (any record, C16) rides a point of the body; a free entry (C17) moves by keys and falls. */
+export const OBJECT_FIELDS = { hinge: ["pivot", "axis", "channel"], carry: ["prop", "at", "along", "visible", "level", "grab", "release", "keys", "fall"], switch: ["visible", "level"],
+	follow: ["follow", "offset", "aim", "visible", "level"], free: ["keys", "fall", "visible", "level"] };
+/** One spec.objects[id].fall entry (C17): the frame it starts to fall, what it lands on, how much it bounces, whether it rolls to rest. */
+export const FALL_FIELDS = ["at", "onto", "bounce", "tumble"];
+/** One spec.objects[id].keys entry (C14): the held object's world pose at frame f; aim (+ roll) in place of rot (C16). */
+export const OBJECT_KEY_FIELDS = ["f", "pos", "rot", "aim", "roll", "lean"];
+export const WALK_FIELDS = ["type", "f0", "steps", "step", "period", "swing", "halfWidth", "lift", "heading", "turnDistance", "pelvisHigh", "pelvisLow", "firstStep", "armSwing", "vary"];
+/** spec.checks keys. */
+export const CHECK_FIELDS = ["contacts", "orient", "below", "clearance", "appear", "supports", "allow", "limits", "mouthPoints"];
+/** Fields of one entry of each spec.checks list. */
+export const CHECK_ENTRY_FIELDS = {
+	contacts: ["name", "point", "target", "tol", "when"],
+	orient: ["name", "from", "to", "along", "minCos", "when"],
+	below: ["name", "joint", "ref", "min", "when"],
+	clearance: ["name", "part", "object", "min", "frames"],
+	appear: ["name", "channel", "joint", "anchor", "tol"],
+	supports: ["object", "part", "tol"],
+	allow: ["part", "object", "depth"],
+};
+/** One spec.goals entry (C8): exactly one of near | above | moved | still | speed; after / before order it on another goal. */
+export const GOAL_FIELDS = ["name", "near", "above", "moved", "still", "speed", "tol", "by", "at", "mode", "after", "before"];
+/** One motion.compile probes entry (C5): exactly one of distance | position. */
+export const PROBE_FIELDS = ["name", "distance", "position", "frames", "every"];
+/** Point reference kinds (C2, refs.js). */
+export const REF_KINDS = ["joint", "bone", "prop", "anchor", "landmark", "object", "person"];
+/** motion.describe topics (C9); examples: whole specs that compile (schema/spec-examples.js). */
+export const DESCRIBE_TOPICS = ["essentials", "spec", "skills", "anchors", "props", "objects", "checks", "goals", "probes", "channels", "refs", "fix", "examples"];

package/src/motion3/schema/spec-examples.js

@@ -0,0 +1,46 @@
+// motion.describe { topic: "examples" }: whole specs, each compiled at QA 0 on the scene its `scene`
+// line names (test/bus/verify-motion3-examples.mjs builds those scenes and compiles every spec on
+// both rigs). They come from the skills' and kits' own examples: reachGrip, smokeCigarette with
+// args.kit and the squat of the smoke pacing test, the sword kit's props and carry, a hinge.
+// Kept out of essentials (its budget is spent).
+const SCHEMA = "cozyclay.motion-spec.v1";
+
+export const SPEC_EXAMPLES = [
+	{ name: "reachGrip carry: take a lantern off its hook and walk off with it",
+		scene: "lantern: a 14 x 20 x 14 cm box hanging at (0.3, 0.95, 0.4); the character at the origin, yaw 0",
+		spec: { schema: SCHEMA, fps: 24, frames: "auto", label: "take the lantern and walk off",
+			use: [{ skill: "standIdle", f0: 0, args: { at: [0, 0], heading: 0 } },
+				{ skill: "reachGrip", f0: 10, args: { anchor: "handle", side: "l", define: { kind: "object", object: "lantern", local: [0, 0.22, 0] } } },
+				{ skill: "walkTo", f0: 70, args: { to: [0, 1.6], steps: 4 } }],
+			objects: { lantern: { prop: "handleGrip", grab: 30 } },
+			goals: [{ name: "lantern carried off", moved: "object:lantern", by: 0.8, at: [170, 184] }] } },
+	{ name: "squat and smoke, dressed by kits (smokeCigarette args.kit)",
+		scene: "object.createKit cigarette, lighter and exhale answered rootIds cig, lighter, exhale",
+		spec: { schema: SCHEMA, fps: 24, frames: 240, label: "squat and smoke",
+			keys: [{ f: 0, set: { root: [0, 0.45, -0.12], yaw: 0, pitch: 22, spine_pitch: 10, head_pitch: -12, foot_l: [0.16, 0.101, 0.02], foot_r: [-0.16, 0.101, 0.02],
+				fyaw_l: 15, fyaw_r: -15, knee_l: [0.45, 0, 1], knee_r: [-0.45, 0, 1] } }],
+			use: [{ skill: "smokeCigarette", f0: 1, args: { kit: { cig: "cig", lighter: "lighter", exhale: "exhale" } } }], fix: { retime: true },
+			goals: [{ name: "cigarette at the mouth", near: ["prop:cig.origin", "landmark:mouth"], tol: 0.08, at: [40, 230], mode: "any" }] } },
+	{ name: "aim keys: raise a held sword to guard, then point it at a target",
+		scene: "object.createKit sword answered rootId sword and the props and bind below",
+		spec: { schema: SCHEMA, fps: 24, frames: 60, label: "sword to guard, then point",
+			use: [{ skill: "standIdle", f0: 0, args: { at: [0, 0], heading: 0 } }],
+			props: { swordGrip: { hand: "r", origin: ["RightHandIndex2", "RightHandMiddle2"], points: { tip: [0, 0.87, -0.015] } } },
+			anchors: { target: { kind: "world", p: [-0.25, 1.52, 1.13] } },
+			objects: { sword: { prop: "swordGrip", at: [0, 0, -0.015], along: [0, 1, 0], keys: [{ f: 20, pos: [-0.25, 1, 0.35], aim: [0, 0.7, 0.7] },
+				{ f: 40, pos: [-0.25, 1.05, 0.4], aim: [0, 0.55, 0.85] }, { f: 59, pos: [-0.25, 1.05, 0.4], aim: [0, 0.55, 0.85] }] } },
+			goals: [{ name: "blade points at the target", near: ["prop:swordGrip.tip", "anchor:target"], tol: 0.1, at: [40, 59] }] } },
+	{ name: "hinge: push a door open by its knob",
+		scene: "door: a 0.9 x 2 x 0.04 m box, base at (0, 0, 0.75), hinged on its +x edge",
+		spec: { schema: SCHEMA, fps: 24, frames: 72, label: "push the door open",
+			use: [{ skill: "standIdle", f0: 0, args: { at: [-0.1, 0.45], heading: 0 } },
+				{ skill: "reachGrip", f0: 5, args: { anchor: "knob", side: "r", hold: 15, release: 8, define: { kind: "object", object: "door", local: [-0.35, 1, -0.04] } } }],
+			objects: { door: { pivot: [0.45, 0, 0.75], axis: [0, 1, 0], channel: "door" } },
+			keys: [{ f: 25, set: { door: 0 } }, { f: 40, set: { door: 10 } }, { f: 48, set: { door: 15 } }, { f: 70, set: { door: 75 } }],
+			goals: [{ name: "door swung open", moved: "object:door", by: 0.3, at: [60, 71] }] } },
+];
+
+export const EXAMPLE_NOTES = [
+	"Each spec compiles at QA 0 on its scene. Ids are examples: use the scene's (object.createKit answers rootId, props and bind).",
+	"The lantern rides the hand from grab on (no release); the knob anchor follows the hinged door; aim keys pose the sword, the arm follows; the last key holds the pose.",
+];

package/src/motion3/schema/topics.js

@@ -0,0 +1,113 @@
+// motion.describe examples and notes, one per topic (describe.js builds the schemas from
+// fields.js and types.js). Each example is a part of a spec that passes validation when merged
+// into a spec with standIdle at f0 0 and frames 60 (probes: a motion.compile probes list);
+// test/motion3/verify-motion3-describe.mjs checks that. Object ids are examples: use the scene's.
+import { CONVENTIONS } from "../compiler/vocab.js";
+import { FIX_KEYS } from "../fix/index.js";
+import { literal } from "./brief.js";
+import { WRIST_LIMITS } from "../compiler/arm-orient.js";
+import { KEY_BLEND } from "../object-keys.js";
+
+const SPOT = { kind: "world", p: [-0.2, 1.1, 0.35] };
+const GRIP = { hand: "r", origin: ["RightHandIndex2", "RightHandMiddle2"], points: { fingers: [0, 0, 0] } };
+
+export const EXAMPLES = {
+	spec: { schema: "cozyclay.motion-spec.v1", fps: 24, frames: "auto", label: "walk up and grip the bar",
+		use: [{ skill: "standIdle", f0: 0, args: { at: [0, 0], heading: 0 } }, { skill: "walkTo", f0: 10, args: { to: [0, 1.2] } },
+			{ skill: "reachGrip", f0: 140, args: { anchor: "bar", side: "r", define: { kind: "world", p: [-0.2, 1.2, 1.6] } } }],
+		keys: [{ f: 150, set: { head_pitch: 10 } }] },
+	anchors: { anchors: { spot: SPOT, pocket: { kind: "body", p: [0.13, -0.035, 0.08] }, knee: { kind: "segment", from: "LeftUpLeg", to: "LeftLeg", t: 0.45, reach: "l" },
+		handle: { kind: "object", object: "cup", local: [0.07, 0, 0] }, mouth: { kind: "landmark", name: "mouth" } },
+	keys: [{ f: 10, set: { armw_r: 1, w_spot_r: 0 } }, { f: 30, set: { w_spot_r: 1 } }] },
+	props: { props: { cupGrip: GRIP }, anchors: { spot: SPOT }, fits: [{ side: "r", anchor: "spot", effector: { prop: "cupGrip", point: "fingers" } }] },
+	objects: { props: { cupGrip: GRIP },
+		objects: { cup: { prop: "cupGrip", grab: 20, release: 50 }, door: { pivot: [0.9, 0, 0.5], axis: [0, 1, 0], channel: "door" },
+			bat: { prop: "cupGrip", grab: 52, keys: [{ f: 54, pos: [0.3, 1.2, 0.2], rot: [0, 0, 0.38268, 0.92388] }, { f: 58, pos: [0.3, 1.1, 0.4], aim: [0, -0.2, 1] }] },
+			ember: { visible: "ember_vis", level: "ember" }, puff: { follow: "landmark:mouth", aim: "face", visible: "ember_vis" } },
+		keys: [{ f: 0, set: { door: 0, ember_vis: 0, ember: 0.6 } }, { f: 30, set: { ember_vis: 1, ember: 2 }, step: ["ember_vis"] }, { f: 40, set: { door: -60 } }] },
+	checks: { anchors: { spot: SPOT }, checks: {
+		contacts: [{ name: "right hand on the spot", point: "joint:RightHand", target: "anchor:spot", tol: 0.05, when: [30, 40] }],
+		clearance: [{ name: "hand off the cup", part: "hand_r", object: "cup", min: 0.01, frames: [0, 20] }],
+		allow: [{ part: "hand", object: "cup", depth: 0.03 }], limits: { object: 0.01 } } },
+	goals: { anchors: { spot: SPOT }, goals: [
+		{ name: "hand at the spot", near: ["joint:RightHand", "anchor:spot"], tol: 0.06, at: [30, 40] },
+		{ name: "hand over the table", above: ["joint:RightHand", "object:table.top"], by: 0.05, at: 35, mode: "any" },
+		{ name: "cup lifted", moved: "object:cup", by: 0.1, at: [40, 59], after: "hand at the spot" },
+		{ name: "cup still before", still: "object:cup", at: [0, 59], before: "cup lifted" },
+		{ name: "hand quick", speed: "joint:RightHand", by: 1.2, at: [20, 30] }] },
+	probes: [{ name: "handToCup", distance: ["joint:RightHand", "object:cup"], frames: [0, 59] }, { name: "cupTop", position: "object:cup.top", frames: [0, 59], every: 10 }],
+	channels: { anchors: { spot: SPOT }, channels: ["lid"], keys: [
+		{ f: 0, set: { armw_r: 1, hand_r: [-0.25, 1.0, 0.2], elbow_r: [-0.5, -1, -0.3], fingers_r: { grip: 0 }, lid: 0 } },
+		{ f: 20, set: { w_spot_r: 1, fingers_r: { grip: 1 }, head_yaw: -15, spine_pitch: 8 } },
+		{ f: 30, set: { lid: 1 }, step: ["lid"] }] },
+	refs: { props: { cupGrip: GRIP }, anchors: { spot: SPOT }, goals: [
+		{ name: "fingers at the spot", near: ["prop:cupGrip.fingers", "anchor:spot"], at: 30 },
+		{ name: "cup at the mouth", near: ["object:cup.top", "landmark:mouth"], tol: 0.06, at: [40, 50] },
+		{ name: "hand above the hips", above: ["joint:RightHand", "bone:Hips"], at: 30 }] },
+	fix: { fix: { reach: true, slide: true, penetration: 0.02, self: true, retime: false } },
+};
+
+const UNITS = `World metres, +Y up; ${CONVENTIONS.yaw}; the character's left is +X at yaw 0. Angles in degrees.`;
+const NO_JUMP = "Without at/along it keeps its grab-frame offset to the palm: no jump.";
+/** The objects example's carry: a grip prop and the object it holds. */
+const CARRY = { props: EXAMPLES.objects.props, objects: { cup: EXAMPLES.objects.objects.cup } };
+
+export const NOTES = {
+	essentials: ["types: ? optional, =v default, a..b range, A | B one of, [key]: T map, a|b?: T both, x_l|r each side, (text) meaning.",
+		`A carried object: ${literal(CARRY)}. ${NO_JUMP}`,
+		"motion.describe { topic } or { topic: 'skills', name }: the rest."],
+	spec: [UNITS,
+		"frames: an integer, or \"auto\" (the last skill end, generator end or key f, plus 1); the stored spec keeps the number.",
+		"Any number may be { range: [lo, hi] } (int: true for frames): the compiler searches it, QA 0 first, at most search.budget compiles.",
+		"use expands skills (topic skills) into keys, anchors, props, fits and checks first; your own keys win on the same frame and your anchors/props replace a skill's.",
+		"Keys ease between values (step jumps); a channel holds its last value. Unknown fields are refused with the field list.",
+		"More: topics anchors, props, objects, checks, goals, probes, channels, refs, fix, skills."],
+	anchors: ["An anchor is a named point a hand can go to: key w_<anchor>_l / w_<anchor>_r from 0 to 1 with armw_<side> 1 (the IK arm).",
+		"An anchor name may not end in _l or _r.", "object anchors (a body or a group; local in its own axes) follow the object where it is (hinges, carries): put the other hand on a carried object with one; the carrying hand's own anchor stays where it took it. prop anchors are a point of a prop the other hand holds.",
+		"segment with reach slides from t toward tMin until the arm reaches it.",
+		"person { person: <character id>, bone, offset? } is another character's joint where its installed take has it that frame (a hand on a shoulder, a push on the chest): install that character's take first; reachGrip on it allows the hand to touch that person."],
+	props: ["A prop is a set of points fixed to one hand, [d, l, n] along the palm axes; prop:<prop>.origin is the mean of its origin bones.",
+		"fits: the hand target moves so the effector (a prop point or the mean of joints), not the wrist, lands on the anchor.",
+		"A fit on a scene body also turns the hand about the forearm into a grip: a thin body (a can, a bar, a handle, a neck) across the palm, else thumb up; never past a comfortable forearm turn. A wrist you turn (wtwist/wflex) wins; fit.orient: false (reachGrip args.orient: false) turns it off.",
+		"reachGrip adds props.<anchor>Grip and its fit. Carry a scene object with objects.<id>.prop (topic objects)."],
+	objects: ["A hinge turns the object (a body or a group) about pivot/axis by the angle channel your keys set (degrees).",
+		"A carry follows the prop's hand: before grab the scene pose, grab..release in the hand, after release frozen where it was let go.",
+		`No grab: in hand from frame 0; no release: to the end. ${NO_JUMP}`,
+		"A group (Empty) id moves all its parts; at/along pin a group's root to the palm too (an object.createKit kit). A carried object is an obstacle for the body and the scene.",
+		"A switch { visible?, level? } (no prop, no hinge field) moves nothing: it shows or hides any record (a part, a light, an effect) and sets its level, 0..4 light, glow and effect strength "
+			+ "(an unkeyed level reads 1). Hiding a group hides its parts. A carry takes level too.",
+		"keys pose a carried object in the world while it is in hand (grab <= f <= release): pos is its base (a group: its root), rot a quaternion [x, y, z, w], "
+			+ "or aim [x, y, z] the direction its +Y points (a bat's barrel), turned from how the hand holds it there, plus roll degrees about aim; no roll: the roll the arm holds most easily. "
+			+ `The object leads and the whole arm follows (the elbow swings, the forearm turns, the wrist adds the rest within ${Object.entries(WRIST_LIMITS).map(([k, [lo, hi]]) => `${k} ${lo}..${hi}`).join(", ")} deg; dev + toward the thumb); `
+			+ "a left hand on a prop anchor of it turns with it; "
+			+ `the hand eases in and out over ${KEY_BLEND} frames. A REACH group "<id>: n cm off its keys" is what the hand could not reach; `
+			+ "output.observations.held measures every key as drawn (deg off the asked +Y, cm off pos, the drawn +Y, the rot an aim key used).",
+		"free { keys?, fall? } moves what nobody holds: keys at any frame; fall drops it at frame at onto the still top below (onto: that one; else the floor) "
+			+ "to rest on a stable face, one small bounce (0: none). A carry falls before grab or after release.",
+		"A follow { follow: <ref>, offset?, aim?, visible?, level? } puts any record (an effect, a light, a part) on a body point every frame: "
+			+ "aim sets its +Y (an effect emits along it): up (default), face (forward), a direction or a ref (toward it); offset is metres along its axes after aim. It is no obstacle.",
+		"The editor's motion.keyObject writes one key from a drag (a hinge: its channel key)."],
+	checks: ["Each entry adds QA groups: contacts CONTACT, orient ORIENT, below BELOW, clearance CLEARANCE, appear APPEAR; supports mark where a part rests on an object (no FLOAT, no balance there); a foot on an object's top is on the ground without one.",
+		"when: a weight channel (active above 0.99) or [f0, f1]; clearance uses frames.", "Check points take joint:, prop: and anchor: only; goals and probes take every ref (topic refs).",
+		"allow excuses a body part inside an object up to depth; limits override the QA limits. Unnamed entries are named by place, contacts[0].",
+		"Other characters with an installed take are bodies too: PERSON \"<part> x person:<id>\" is a part inside that person; a touch you mean (a push, a hug) is allow { part, object: \"person:<id>\", depth }.",
+		"Speed, acceleration, knee bend and balance are style: measured in output.observations, not judged. Naming speedCore/speedLimb, accCore/accLimb, knee or balance in limits makes it a check (SPEED, ACC, KNEE, BALANCE). observations.near: each hand's and foot's nearest object and gap (< 0 inside), measured, not judged.",
+		"motion.qa { checks } replaces every check for a re-measure."],
+	goals: ["Exactly one of near (distance <= tol), above (a.y - b.y >= by), moved (an object's base moved at least by from the scene pose; any other point ref, e.g. prop:bat.tip, at least by from where it is at at[0], at: [f0, f1]), still (stays within tol, default 0.01 m, of where moved measures from) or speed (the point reaches by m/s).",
+		"at is an absolute frame or [f0, f1]; mode all (every frame; the default) or any (one frame; speed's default). A failed goal is a GOAL group first in qa.groups and makes qa.ok false.",
+		"after / before: another goal's name; at is cut to the frames after (before) the first frame that goal holds, so cause and effect keep their order wherever the event lands (the can moves after the kick). If that goal never holds, this one fails with value null.",
+		"Intent lines as goals: a contact is near between the touching point (joint:RightHandIndex4, joint:RightToeBase) and the object, tol 0.02-0.03; a negative is still on the object before: \"<contact goal>\"; an effect is moved on the object after: \"<contact goal>\" (mode any); a strike is speed of the joint, by m/s, before: \"<contact goal>\"; an effect on something nobody holds (a can that drops, a machine that rocks) moves it by spec.objects keys or fall (topic: \"objects\"), not a hinge or a swapped copy.",
+		"A cup or can brought to the mouth: give its aim keys lean 20-30 so the elbow stays low (observations.wrist raised counts the frames with the elbow over the shoulder)."],
+	probes: ["motion.compile { probes } (at most 16); spec.probes are measured too, not stored; answered whether or not it installs.",
+		"distance [a, b] -> { min, minAt, max, maxAt, mean, first, last } in m; a bare object:<id> measures to its surface. position -> { at: [{ f, p }] }, at most 16 rows."],
+	channels: ["key.set names channels; values ease between keys and hold after the last key. step: [channel] jumps at f instead.",
+		"Flow (spec.flow, on by default): the spine, head, arm swing/bend and wrist carry their speed through a key (a small overshoot) and trail the body (spine 1, head 2, arms 3 frames; lag: { spine, head, arms } or a number); feet, root, hand targets, weights, poles, fingers and objects land on their keys on time. flow: false turns it off; { smooth: false } or { lag: false } one part.",
+		"w_<anchor>_<side> (0..1) weights a hand onto an anchor; the weights of one hand add up to at most 1.",
+		"Any other numeric channel must come from spec.channels, a hinge (objects.<id>.channel), a check's when or a visible switch; names ending _vis are visibility switches (shown above 0.5)."],
+	refs: ["A ref names a point: joint:/bone:<Bone>, prop:<prop>.<point>, anchor:<name>, landmark:mouth, object:<id>[.center|.top|.base], person:<character id>.<Bone> (another character's joint in its installed take).",
+		"object:<id> takes a body or a group (the box around its parts); in a distance a bare object:<id> means its surface.",
+		"Goals and probes take every kind; spec.checks keep joint:, prop: and anchor:."],
+	fix: [`spec.fix keys: ${FIX_KEYS.join(", ")}; false turns all off. output.fixed reports what each one changed.`,
+		"reach, slide and self are on by default; penetration and retime are opt-in.",
+		"self keeps the arms out of the body on its fitted skin (QA BODY measures the same skin): wrist targets inside it go onto it, elbows turn about the shoulder-wrist line, a hand a little inside is pushed out. A fit's target (the mouth) is never moved; what is left is BODY, with checks.allow { part, object: <body part>, depth } for a contact meant to touch (a hand on a knee)."],
+};

package/src/motion3/schema/types.js

@@ -0,0 +1,149 @@
+// JSON Schema 2020-12 fragments for the fields of each table in schema/fields.js, keyed by the
+// field name. The field lists themselves stay in fields.js: describe.js walks those lists and
+// looks each field up here, and throws when one is missing, so a new field needs a type here.
+// Shared shapes are $refs into DEFS (describe.js adds the ones an answer uses).
+import { REF_KINDS, OBJECT_KEY_FIELDS } from "./fields.js";
+import { CONVENTIONS } from "../compiler/vocab.js";
+import { QA_LIMITS } from "../qa/checks.js";
+import { CAPSULES } from "../qa/geometry.js";
+
+const def = (d, extra) => ({ ...extra, ...(d ? { description: d } : {}) });
+export const num = (d, extra) => def(d, { type: "number", ...extra });
+export const int = (d, extra) => def(d, { type: "integer", ...extra });
+export const str = (d, extra) => def(d, { type: "string", ...extra });
+const bool = (d, extra) => def(d, { type: "boolean", ...extra });
+export const ref = (name, d) => def(d, { $ref: `#/$defs/${name}` });
+export const side = d => def(d, { enum: ["l", "r"] });
+const pair = (items, d) => def(d, { type: "array", prefixItems: [items, items], minItems: 2, maxItems: 2 });
+
+export const DEFS = {
+	vec3: { type: "array", items: { type: "number" }, minItems: 3, maxItems: 3 },
+	frameSpan: { type: "array", items: { type: "integer", minimum: 0 }, minItems: 2, maxItems: 2, description: "[f0, f1] inclusive" },
+	ref: { type: "string", pattern: `^(${REF_KINDS.join("|")}):.+$`, description: "a point ref (topic refs)" },
+	checkRef: { type: "string", pattern: "^(joint|prop|anchor):.+$", description: "joint:<Bone> | prop:<prop>.<point> | anchor:<name>" },
+	part: { type: "string", description: `a body capsule: ${CAPSULES.map(c => c[0]).join(", ")}; allow matches a prefix (hand = hand_l and hand_r)` },
+	when: { oneOf: [{ type: "string", description: "a weight channel: active where it is > 0.99" }, { $ref: "#/$defs/frameSpan" }] },
+};
+
+export const KEY_TYPES = {
+	f: int("frame", { minimum: 0 }), set: { type: "object", description: "{ channel: value } (topic channels)" },
+	step: { type: "array", items: { type: "string" }, description: "channels that jump at f instead of easing in" },
+	src: str("written by the skills expander; leave it out"),
+};
+
+export const USE_TYPES = { skill: str("a skill name (topic skills)"), args: { type: "object", description: "the skill's args (topic skills with name)" }, f0: int("first frame", { minimum: 0 }) };
+
+export const WALK_TYPES = {
+	type: { const: "walk" }, f0: int("first frame; needs a standing pose keyed before it", { minimum: 0 }), steps: int("footsteps", { minimum: 1, default: 8 }),
+	step: num("stride, m", { default: 0.5 }), period: int("frames per step", { default: 20 }), swing: int("frames a foot is in the air", { default: 14 }),
+	halfWidth: num("feet half-width, m", { default: 0.08 }), lift: num("foot lift, m", { default: 0.08 }), heading: pair({ type: "number" }, `[h0, h1] degrees; ${CONVENTIONS.yaw}`),
+	turnDistance: num("m walked while the heading turns h0 -> h1", { default: 0.4 }), pelvisHigh: num("hips offset over the stance foot, m"),
+	pelvisLow: num("hips offset at double support, m"), firstStep: num("first stride, m", { default: 0.4 }), armSwing: num("degrees", { default: 14 }),
+	vary: num("0..2, uneven steps as people walk (build-up, slow stop, left/right, turns) around the averages above; 0 = every step period frames, step m", { default: 1, minimum: 0, maximum: 2 }),
+};
+
+export const SPEC_TYPES = {
+	schema: { const: "cozyclay.motion-spec.v1" }, fps: { const: 24 },
+	frames: { oneOf: [int(null, { minimum: 1, maximum: 20000 }), { const: "auto", description: "the last skill end, generator end or key f, plus 1 (open values at their upper bound); the stored spec keeps the number" }] },
+	label: str("a short name for the take"),
+	keys: { type: "array", items: { $ref: "#/$defs/key" } },
+	anchors: { type: "object", description: "name -> anchor (topic anchors)" }, props: { type: "object", description: "name -> held prop (topic props)" },
+	fits: { type: "array", description: "topic props" }, objects: { type: "object", description: "scene object id -> hinge, carry, switch, follow or free (topic objects)" },
+	generators: { type: "array", items: { $ref: "#/$defs/walk" } }, checks: { type: "object", description: "topic checks" },
+	fix: { oneOf: [{ const: false }, { type: "object" }], description: "topic fix" }, use: { type: "array", items: { $ref: "#/$defs/use" } },
+	channels: { type: "array", items: { type: "string" }, description: "extra numeric channels your keys set" },
+	detourRadius: num("m; a hand moving between targets arcs around the torso this far out", { default: 0.25 }),
+	search: { type: "object", properties: { budget: int("compiles at most", { minimum: 1, maximum: 64, default: 32 }) }, additionalProperties: false },
+	goals: { type: "array", description: "topic goals" },
+	flow: { oneOf: [{ const: false }, { type: "object" }] },
+	idle: { const: false, description: "held poses do not breathe" },
+};
+
+export const ANCHOR_TYPES = {
+	p: ref("vec3", `world: a world point (m); body: root-relative, ${CONVENTIONS.pole}`), bone: str("bone name"), offset: ref("vec3", "world offset, m"),
+	from: str("bone"), to: str("bone"), t: num("0 = from .. 1 = to", { default: 0.5 }), tMin: num("with reach: the lowest t to slide back to", { default: 0.15 }),
+	reach: side("slide toward `from` until this arm reaches"), object: str("scene object id"), local: ref("vec3", "point in the object's frame, m"),
+	name: { const: "mouth" }, prop: str("a prop held by the other hand"), point: str("a point of that prop, or origin"),
+	person: str("a character id"),
+};
+
+const palm = d => ref("vec3", `${d} [d, l, n] on the palm axes (d to the middle finger, l to the thumb side, n = d x l), m`);
+/** Fields an anchor of each kind must have. */
+export const ANCHOR_REQUIRED = { world: ["p"], body: ["p"], bone: ["bone"], segment: ["from", "to"], object: ["object"], landmark: ["name"], prop: ["prop", "point"], person: ["person", "bone"] };
+
+export const PROP_TYPES = {
+	hand: side(), origin: { type: "array", items: { type: "string" }, minItems: 1, description: "bones whose mean is the prop origin" },
+	points: { type: "object", additionalProperties: palm("point:"), description: "name -> point" },
+};
+
+export const FIT_TYPES = {
+	side: side(), anchor: str("an anchor name"),
+	effector: { oneOf: [{ type: "object", properties: { prop: str(), point: str() }, required: ["prop", "point"] }, { type: "object", properties: { joints: { type: "array", items: { type: "string" } } }, required: ["joints"] }],
+		description: "the hand point fitted onto the anchor" },
+	offset: ref("vec3", "world offset, m"), orient: { type: "boolean", description: "false: no grip turn" },
+};
+
+const OBJECT_KEY_TYPES = { f: int(), pos: ref("vec3"), rot: { type: "array", items: { type: "number" }, minItems: 4, maxItems: 4, description: "quat x, y, z, w" },
+	aim: ref("vec3", "or rot: +Y dir"), roll: num("deg about aim"), lean: num("aim tilt", { minimum: 0, maximum: 45 }) };
+
+const FALL = { type: "object", properties: { at: int(), onto: str(), bounce: num(null, { default: 0.25, minimum: 0, maximum: 0.6 }), tumble: { type: "boolean" } }, required: ["at"], additionalProperties: false };
+/** A free entry's keys and fall (C17) are a carry's, at any frame: said once, not twice. */
+const AS_CARRY = { description: "as carry; keys at any frame" };
+export const FREE_TYPES = { keys: AS_CARRY, fall: AS_CARRY };
+
+export const OBJECT_TYPES = {
+	pivot: ref("vec3", "world hinge point"), axis: ref("vec3", "default +Y"), channel: str("angle channel, deg"),
+	prop: str("spec.props name: it rides that hand"), at: ref("vec3", "palm offset [d, l, n]"), along: ref("vec3", "+Y on the palm, fixed"),
+	visible: str("channel: shown > 0.5"), level: str("channel: strength 0..4"), grab: int("hand takes it", { default: 0 }), release: int("let go (else end)"),
+	keys: { type: "array", items: { type: "object", properties: Object.fromEntries(OBJECT_KEY_FIELDS.map(f => [f, OBJECT_KEY_TYPES[f]])), required: ["f", "pos"], additionalProperties: false },
+		description: "world pose at f; hand follows" },
+	fall: { ...FALL, description: "or a list; topic objects" },
+	follow: ref("ref"), offset: ref("vec3"), aim: { oneOf: [{ enum: ["face", "up"] }, { $ref: "#/$defs/vec3" }, { $ref: "#/$defs/ref" }], default: "up" },
+};
+
+export const CHECK_ENTRY_TYPES = {
+	name: str("the QA group's name"), point: ref("checkRef"), target: ref("checkRef"),
+	tol: num("m; default contacts 0.01, appear 0.035, supports 0.04"), when: ref("when"), from: ref("checkRef"), to: ref("checkRef"),
+	along: { oneOf: [{ enum: ["face", "up"] }, { $ref: "#/$defs/vec3" }] }, minCos: num("default 0.64"),
+	joint: str("bone"), ref: str("bone"), min: num("m; below default 0.08"), part: ref("part"),
+	object: str("scene object id"), frames: ref("frameSpan"), channel: str("a visibility channel"), anchor: str("an anchor name"), depth: num("allowed depth, m"),
+};
+
+/** Fields each checks entry must have. */
+export const CHECK_REQUIRED = { contacts: ["point", "target"], orient: ["from", "to", "along"], below: ["joint", "ref"], clearance: ["part", "object", "min"],
+	appear: ["channel", "joint", "anchor"], supports: ["object"], allow: ["part", "object", "depth"] };
+
+export const CHECKS_TYPES = {
+	limits: { type: "object", properties: Object.fromEntries(Object.entries(QA_LIMITS).map(([k, v]) => [k, num(null, { default: v })])), additionalProperties: false },
+	mouthPoints: { type: "array", items: str("prop.point"), description: "prop points allowed at the mouth" },
+};
+
+export const GOAL_TYPES = {
+	name: str(), near: pair({ $ref: "#/$defs/ref" }, "distance <= tol"), above: pair({ $ref: "#/$defs/ref" }, "a.y - b.y >= by"),
+	moved: str("a ref or an object id: an object's base moves at least `by` from the scene pose; any other point (prop:, joint:, landmark:, anchor:) at least `by` from where it is at at[0] (at: [f0, f1])"),
+	still: str("a ref or an object id: stays within `tol` of where moved measures from (an object: its scene pose; a point: where it is at at[0], at: [f0, f1])"),
+	speed: str("a point ref: its speed reaches `by` m/s (mode any by default)"),
+	tol: num("m; near default 0.05, still 0.01"), by: num("above m, default 0; moved m, default 0.05; speed m/s, needed"),
+	at: { oneOf: [int(null, { minimum: 0 }), { $ref: "#/$defs/frameSpan" }], description: "absolute frame or span" },
+	mode: { enum: ["all", "any"], description: "every frame of `at`, or one; default all, speed any" },
+	after: str("a goal's name: at starts after the first frame that goal holds"), before: str("a goal's name: at ends before the first frame that goal holds"),
+};
+
+export const PROBE_TYPES = {
+	name: str("the key of the answer"), distance: pair({ $ref: "#/$defs/ref" }, "min/max/mean/first/last m"), position: ref("ref", "world points"),
+	frames: ref("frameSpan", "absolute, default the whole take"), every: int("position: every n frames (<= 16 rows)", { minimum: 1 }),
+};
+
+export const FIX_TYPES = {
+	reach: bool("wrist targets past reach go onto it softly; hips lower for near-miss ankles", { default: true }),
+	slide: bool("lifts sunk soles; a planted heel or ball drifting under 1 cm stays put; a heel-up foot pivots on its ball", { default: true }),
+	penetration: { oneOf: [{ type: "boolean" }, { type: "number", minimum: 0, maximum: 0.05 }], default: 0, description: "push hands out of boxes up to this depth, m (true = 0.02)" },
+	self: bool("arms kept out of the body's skin (wrists, elbows)", { default: true }),
+	retime: bool("speed spikes borrow frames from the neighbouring keys", { default: false }),
+};
+
+export const REF_DOCS = {
+	joint: "joint:<Bone>", bone: "bone:<Bone> (= joint:)", prop: "prop:<prop>.<point> (origin exists)",
+	anchor: "anchor:<name>", landmark: "landmark:mouth", object: "object:<id>[.center|.top|.base], a body or group; bare = its surface (distance)",
+	person: "person:<id>.<Bone>",
+};