[ { "path": ".all-contributorsrc", "content": "{\n \"projectName\": \"downshift\",\n \"projectOwner\": \"downshift-js\",\n \"repoType\": \"github\",\n \"files\": [\n \"README.md\"\n ],\n \"imageSize\": 100,\n \"commit\": false,\n \"contributors\": [\n {\n \"login\": \"kentcdodds\",\n \"name\": \"Kent C. Dodds\",\n \"avatar_url\": \"https://avatars.githubusercontent.com/u/1500684?v=3\",\n \"profile\": \"https://kentcdodds.com\",\n \"contributions\": [\n \"code\",\n \"doc\",\n \"infra\",\n \"test\",\n \"review\",\n \"blog\",\n \"bug\",\n \"example\",\n \"ideas\",\n \"talk\"\n ]\n },\n {\n \"login\": \"ryanflorence\",\n \"name\": \"Ryan Florence\",\n \"avatar_url\": \"https://avatars0.githubusercontent.com/u/100200?v=4\",\n \"profile\": \"http://twitter.com/ryanflorence\",\n \"contributions\": [\n \"ideas\"\n ]\n },\n {\n \"login\": \"jaredly\",\n \"name\": \"Jared Forsyth\",\n \"avatar_url\": \"https://avatars3.githubusercontent.com/u/112170?v=4\",\n \"profile\": \"http://jaredforsyth.com\",\n \"contributions\": [\n \"ideas\",\n \"doc\"\n ]\n },\n {\n \"login\": \"jtmthf\",\n \"name\": \"Jack Moore\",\n \"avatar_url\": \"https://avatars1.githubusercontent.com/u/8162598?v=4\",\n \"profile\": \"https://github.com/jtmthf\",\n \"contributions\": [\n \"example\"\n ]\n },\n {\n \"login\": \"souporserious\",\n \"name\": \"Travis Arnold\",\n \"avatar_url\": \"https://avatars1.githubusercontent.com/u/2762082?v=4\",\n \"profile\": \"https://souporserious.com/\",\n \"contributions\": [\n \"code\",\n \"doc\"\n ]\n },\n {\n \"login\": \"marcysutton\",\n \"name\": \"Marcy Sutton\",\n \"avatar_url\": \"https://avatars0.githubusercontent.com/u/1045233?v=4\",\n \"profile\": \"http://marcysutton.com\",\n \"contributions\": [\n \"bug\",\n \"ideas\"\n ]\n },\n {\n \"login\": \"tizmagik\",\n \"name\": \"Jeremy Gayed\",\n \"avatar_url\": \"https://avatars2.githubusercontent.com/u/244704?v=4\",\n \"profile\": \"http://www.jeremygayed.com\",\n \"contributions\": [\n \"example\"\n ]\n },\n {\n \"login\": \"Haroenv\",\n \"name\": \"Haroen Viaene\",\n \"avatar_url\": \"https://avatars3.githubusercontent.com/u/6270048?v=4\",\n \"profile\": \"https://haroen.me\",\n \"contributions\": [\n \"example\"\n ]\n },\n {\n \"login\": \"rezof\",\n \"name\": \"monssef\",\n \"avatar_url\": \"https://avatars2.githubusercontent.com/u/15073300?v=4\",\n \"profile\": \"https://github.com/rezof\",\n \"contributions\": [\n \"example\"\n ]\n },\n {\n \"login\": \"FezVrasta\",\n \"name\": \"Federico Zivolo\",\n \"avatar_url\": \"https://avatars2.githubusercontent.com/u/5382443?v=4\",\n \"profile\": \"https://fezvrasta.github.io\",\n \"contributions\": [\n \"doc\"\n ]\n },\n {\n \"login\": \"divyenduz\",\n \"name\": \"Divyendu Singh\",\n \"avatar_url\": \"https://avatars3.githubusercontent.com/u/746482?v=4\",\n \"profile\": \"https://divyendusingh.com\",\n \"contributions\": [\n \"example\",\n \"code\",\n \"doc\",\n \"test\"\n ]\n },\n {\n \"login\": \"salmanmanekia\",\n \"name\": \"Muhammad Salman\",\n \"avatar_url\": \"https://avatars1.githubusercontent.com/u/841955?v=4\",\n \"profile\": \"https://github.com/salmanmanekia\",\n \"contributions\": [\n \"code\"\n ]\n },\n {\n \"login\": \"psicotropicos\",\n \"name\": \"João Alberto\",\n \"avatar_url\": \"https://avatars3.githubusercontent.com/u/10820159?v=4\",\n \"profile\": \"https://twitter.com/psicotropidev\",\n \"contributions\": [\n \"code\"\n ]\n },\n {\n \"login\": \"bernard-lin\",\n \"name\": \"Bernard Lin\",\n \"avatar_url\": \"https://avatars0.githubusercontent.com/u/16327281?v=4\",\n \"profile\": \"https://github.com/bernard-lin\",\n \"contributions\": [\n \"code\",\n \"doc\"\n ]\n },\n {\n \"login\": \"geoffdavis92\",\n \"name\": \"Geoff Davis\",\n \"avatar_url\": \"https://avatars1.githubusercontent.com/u/7330124?v=4\",\n \"profile\": \"https://geoffdavis.info\",\n \"contributions\": [\n \"example\"\n ]\n },\n {\n \"login\": \"reznord\",\n \"name\": \"Anup\",\n \"avatar_url\": \"https://avatars0.githubusercontent.com/u/3415488?v=4\",\n \"profile\": \"https://github.com/reznord\",\n \"contributions\": [\n \"doc\"\n ]\n },\n {\n \"login\": \"ferdinandsalis\",\n \"name\": \"Ferdinand Salis\",\n \"avatar_url\": \"https://avatars0.githubusercontent.com/u/340520?v=4\",\n \"profile\": \"http://ferdinandsalis.com\",\n \"contributions\": [\n \"bug\",\n \"code\"\n ]\n },\n {\n \"login\": \"tkh44\",\n \"name\": \"Kye Hohenberger\",\n \"avatar_url\": \"https://avatars2.githubusercontent.com/u/662750?v=4\",\n \"profile\": \"https://github.com/tkh44\",\n \"contributions\": [\n \"bug\"\n ]\n },\n {\n \"login\": \"jgoux\",\n \"name\": \"Julien Goux\",\n \"avatar_url\": \"https://avatars0.githubusercontent.com/u/1443499?v=4\",\n \"profile\": \"https://github.com/jgoux\",\n \"contributions\": [\n \"bug\",\n \"code\",\n \"test\"\n ]\n },\n {\n \"login\": \"jseminck\",\n \"name\": \"Joachim Seminck\",\n \"avatar_url\": \"https://avatars2.githubusercontent.com/u/9586897?v=4\",\n \"profile\": \"https://github.com/jseminck\",\n \"contributions\": [\n \"code\"\n ]\n },\n {\n \"login\": \"the-simian\",\n \"name\": \"Jesse Harlin\",\n \"avatar_url\": \"https://avatars3.githubusercontent.com/u/954596?v=4\",\n \"profile\": \"http://jesseharlin.net/\",\n \"contributions\": [\n \"bug\",\n \"example\"\n ]\n },\n {\n \"login\": \"pbomb\",\n \"name\": \"Matt Parrish\",\n \"avatar_url\": \"https://avatars0.githubusercontent.com/u/1402095?v=4\",\n \"profile\": \"https://github.com/pbomb\",\n \"contributions\": [\n \"tool\",\n \"review\"\n ]\n },\n {\n \"login\": \"thomhos\",\n \"name\": \"thom\",\n \"avatar_url\": \"https://avatars1.githubusercontent.com/u/11661846?v=4\",\n \"profile\": \"http://thom.kr\",\n \"contributions\": [\n \"code\"\n ]\n },\n {\n \"login\": \"vutran\",\n \"name\": \"Vu Tran\",\n \"avatar_url\": \"https://avatars2.githubusercontent.com/u/1088312?v=4\",\n \"profile\": \"http://twitter.com/tranvu\",\n \"contributions\": [\n \"code\"\n ]\n },\n {\n \"login\": \"codiemullins\",\n \"name\": \"Codie Mullins\",\n \"avatar_url\": \"https://avatars1.githubusercontent.com/u/74193?v=4\",\n \"profile\": \"https://github.com/codiemullins\",\n \"contributions\": [\n \"code\",\n \"example\"\n ]\n },\n {\n \"login\": \"morajabi\",\n \"name\": \"Mohammad Rajabifard\",\n \"avatar_url\": \"https://avatars3.githubusercontent.com/u/12202757?v=4\",\n \"profile\": \"https://morajabi.me\",\n \"contributions\": [\n \"doc\",\n \"ideas\"\n ]\n },\n {\n \"login\": \"tansongyang\",\n \"name\": \"Frank Tan\",\n \"avatar_url\": \"https://avatars3.githubusercontent.com/u/9488719?v=4\",\n \"profile\": \"https://github.com/tansongyang\",\n \"contributions\": [\n \"code\"\n ]\n },\n {\n \"login\": \"srph\",\n \"name\": \"Kier Borromeo\",\n \"avatar_url\": \"https://avatars3.githubusercontent.com/u/5093058?v=4\",\n \"profile\": \"https://kierb.com\",\n \"contributions\": [\n \"example\"\n ]\n },\n {\n \"login\": \"paul-veevers\",\n \"name\": \"Paul Veevers\",\n \"avatar_url\": \"https://avatars1.githubusercontent.com/u/8969456?v=4\",\n \"profile\": \"https://github.com/paul-veevers\",\n \"contributions\": [\n \"code\"\n ]\n },\n {\n \"login\": \"Ronolibert\",\n \"name\": \"Ron Cruz\",\n \"avatar_url\": \"https://avatars2.githubusercontent.com/u/13622298?v=4\",\n \"profile\": \"https://github.com/Ronolibert\",\n \"contributions\": [\n \"doc\"\n ]\n },\n {\n \"login\": \"rickMcGavin\",\n \"name\": \"Rick McGavin\",\n \"avatar_url\": \"https://avatars1.githubusercontent.com/u/13605633?v=4\",\n \"profile\": \"http://rickmcgavin.github.io\",\n \"contributions\": [\n \"doc\"\n ]\n },\n {\n \"login\": \"vejersele\",\n \"name\": \"Jelle Versele\",\n \"avatar_url\": \"https://avatars0.githubusercontent.com/u/869669?v=4\",\n \"profile\": \"http://twitter.com/vejersele\",\n \"contributions\": [\n \"example\"\n ]\n },\n {\n \"login\": \"brentertz\",\n \"name\": \"Brent Ertz\",\n \"avatar_url\": \"https://avatars1.githubusercontent.com/u/202773?v=4\",\n \"profile\": \"https://github.com/brentertz\",\n \"contributions\": [\n \"ideas\"\n ]\n },\n {\n \"login\": \"Dajust\",\n \"name\": \"Justice Mba \",\n \"avatar_url\": \"https://avatars3.githubusercontent.com/u/8015514?v=4\",\n \"profile\": \"https://github.com/Dajust\",\n \"contributions\": [\n \"code\",\n \"doc\",\n \"ideas\"\n ]\n },\n {\n \"login\": \"ellismarkf\",\n \"name\": \"Mark Ellis\",\n \"avatar_url\": \"https://avatars2.githubusercontent.com/u/3925281?v=4\",\n \"profile\": \"http://mfellis.com\",\n \"contributions\": [\n \"ideas\"\n ]\n },\n {\n \"login\": \"usandfriends\",\n \"name\": \"us͡an̸df͘rien͜ds͠\",\n \"avatar_url\": \"https://avatars1.githubusercontent.com/u/3241922?v=4\",\n \"profile\": \"http://ronak.io/\",\n \"contributions\": [\n \"bug\",\n \"code\",\n \"test\"\n ]\n },\n {\n \"login\": \"robin-drexler\",\n \"name\": \"Robin Drexler\",\n \"avatar_url\": \"https://avatars0.githubusercontent.com/u/474248?v=4\",\n \"profile\": \"https://www.robin-drexler.com/\",\n \"contributions\": [\n \"bug\",\n \"code\"\n ]\n },\n {\n \"login\": \"arturoromeroslc\",\n \"name\": \"Arturo Romero\",\n \"avatar_url\": \"https://avatars0.githubusercontent.com/u/7406639?v=4\",\n \"profile\": \"http://arturoromero.info/\",\n \"contributions\": [\n \"example\"\n ]\n },\n {\n \"login\": \"yp\",\n \"name\": \"yp\",\n \"avatar_url\": \"https://avatars1.githubusercontent.com/u/275483?v=4\",\n \"profile\": \"http://algolab.eu/pirola\",\n \"contributions\": [\n \"bug\",\n \"code\",\n \"test\"\n ]\n },\n {\n \"login\": \"ifyoumakeit\",\n \"name\": \"Dave Garwacke\",\n \"avatar_url\": \"https://avatars0.githubusercontent.com/u/3998604?v=4\",\n \"profile\": \"http://www.warbyparker.com\",\n \"contributions\": [\n \"doc\"\n ]\n },\n {\n \"login\": \"Drapegnik\",\n \"name\": \"Ivan Pazhitnykh\",\n \"avatar_url\": \"https://avatars3.githubusercontent.com/u/11758660?v=4\",\n \"profile\": \"http://linkedin.com/in/drapegnik\",\n \"contributions\": [\n \"code\",\n \"test\"\n ]\n },\n {\n \"login\": \"Rendez\",\n \"name\": \"Luis Merino\",\n \"avatar_url\": \"https://avatars0.githubusercontent.com/u/61776?v=4\",\n \"profile\": \"https://github.com/Rendez\",\n \"contributions\": [\n \"doc\"\n ]\n },\n {\n \"login\": \"arahansen\",\n \"name\": \"Andrew Hansen\",\n \"avatar_url\": \"https://avatars0.githubusercontent.com/u/8746094?v=4\",\n \"profile\": \"http://twitter.com/arahansen\",\n \"contributions\": [\n \"code\",\n \"test\",\n \"ideas\"\n ]\n },\n {\n \"login\": \"Jwhiles\",\n \"name\": \"John Whiles\",\n \"avatar_url\": \"https://avatars3.githubusercontent.com/u/20307225?v=4\",\n \"profile\": \"http://www.johnwhiles.com\",\n \"contributions\": [\n \"code\"\n ]\n },\n {\n \"login\": \"wKovacs64\",\n \"name\": \"Justin Hall\",\n \"avatar_url\": \"https://avatars1.githubusercontent.com/u/1288694?v=4\",\n \"profile\": \"https://github.com/wKovacs64\",\n \"contributions\": [\n \"infra\"\n ]\n },\n {\n \"login\": \"petetnt\",\n \"name\": \"Pete Nykänen\",\n \"avatar_url\": \"https://avatars2.githubusercontent.com/u/7641760?v=4\",\n \"profile\": \"https://twitter.com/pete_tnt\",\n \"contributions\": [\n \"review\"\n ]\n },\n {\n \"login\": \"jaredpalmer\",\n \"name\": \"Jared Palmer\",\n \"avatar_url\": \"https://avatars2.githubusercontent.com/u/4060187?v=4\",\n \"profile\": \"http://jaredpalmer.com\",\n \"contributions\": [\n \"code\"\n ]\n },\n {\n \"login\": \"philipyoungg\",\n \"name\": \"Philip Young\",\n \"avatar_url\": \"https://avatars3.githubusercontent.com/u/11477718?v=4\",\n \"profile\": \"http://www.philipyoungg.com\",\n \"contributions\": [\n \"code\",\n \"test\",\n \"ideas\"\n ]\n },\n {\n \"login\": \"alexandernanberg\",\n \"name\": \"Alexander Nanberg\",\n \"avatar_url\": \"https://avatars3.githubusercontent.com/u/8997319?v=4\",\n \"profile\": \"https://alexandernanberg.com\",\n \"contributions\": [\n \"doc\",\n \"code\"\n ]\n },\n {\n \"login\": \"httpete-ire\",\n \"name\": \"Pete Redmond\",\n \"avatar_url\": \"https://avatars2.githubusercontent.com/u/1556430?v=4\",\n \"profile\": \"https://httpete.com\",\n \"contributions\": [\n \"bug\"\n ]\n },\n {\n \"login\": \"Zashy\",\n \"name\": \"Nick Lavin\",\n \"avatar_url\": \"https://avatars2.githubusercontent.com/u/1706342?v=4\",\n \"profile\": \"https://github.com/Zashy\",\n \"contributions\": [\n \"bug\",\n \"code\",\n \"test\"\n ]\n },\n {\n \"login\": \"jlongster\",\n \"name\": \"James Long\",\n \"avatar_url\": \"https://avatars2.githubusercontent.com/u/17031?v=4\",\n \"profile\": \"http://jlongster.com\",\n \"contributions\": [\n \"bug\",\n \"code\"\n ]\n },\n {\n \"login\": \"cycomachead\",\n \"name\": \"Michael Ball\",\n \"avatar_url\": \"https://avatars0.githubusercontent.com/u/1505907?v=4\",\n \"profile\": \"http://michaelball.co\",\n \"contributions\": [\n \"bug\",\n \"code\",\n \"test\"\n ]\n },\n {\n \"login\": \"Julienng\",\n \"name\": \"CAVALEIRO Julien\",\n \"avatar_url\": \"https://avatars0.githubusercontent.com/u/8990614?v=4\",\n \"profile\": \"https://github.com/Julienng\",\n \"contributions\": [\n \"example\"\n ]\n },\n {\n \"login\": \"kimgronqvist\",\n \"name\": \"Kim Grönqvist\",\n \"avatar_url\": \"https://avatars1.githubusercontent.com/u/3421067?v=4\",\n \"profile\": \"http://www.kimgronqvist.se\",\n \"contributions\": [\n \"code\",\n \"test\"\n ]\n },\n {\n \"login\": \"tiansijie\",\n \"name\": \"Sijie\",\n \"avatar_url\": \"https://avatars2.githubusercontent.com/u/3675602?v=4\",\n \"profile\": \"http://sijietian.com\",\n \"contributions\": [\n \"bug\",\n \"code\"\n ]\n },\n {\n \"login\": \"donysukardi\",\n \"name\": \"Dony Sukardi\",\n \"avatar_url\": \"https://avatars0.githubusercontent.com/u/410792?v=4\",\n \"profile\": \"http://dsds.io\",\n \"contributions\": [\n \"example\",\n \"question\",\n \"code\",\n \"test\"\n ]\n },\n {\n \"login\": \"dmmulroy\",\n \"name\": \"Dillon Mulroy\",\n \"avatar_url\": \"https://avatars1.githubusercontent.com/u/2755722?v=4\",\n \"profile\": \"https://dillonmulroy.com\",\n \"contributions\": [\n \"doc\"\n ]\n },\n {\n \"login\": \"curtiswilkinson\",\n \"name\": \"Curtis Tate Wilkinson\",\n \"avatar_url\": \"https://avatars3.githubusercontent.com/u/12440573?v=4\",\n \"profile\": \"https://twitter.com/curtytate\",\n \"contributions\": [\n \"code\"\n ]\n },\n {\n \"login\": \"brikou\",\n \"name\": \"Brice BERNARD\",\n \"avatar_url\": \"https://avatars3.githubusercontent.com/u/383212?v=4\",\n \"profile\": \"https://github.com/brikou\",\n \"contributions\": [\n \"bug\",\n \"code\"\n ]\n },\n {\n \"login\": \"xutopia\",\n \"name\": \"Tony Xu\",\n \"avatar_url\": \"https://avatars3.githubusercontent.com/u/14304503?v=4\",\n \"profile\": \"https://github.com/xutopia\",\n \"contributions\": [\n \"code\"\n ]\n },\n {\n \"login\": \"newyork-anthonyng\",\n \"name\": \"Anthony Ng\",\n \"avatar_url\": \"https://avatars1.githubusercontent.com/u/14035529?v=4\",\n \"profile\": \"http://anthonyng.me\",\n \"contributions\": [\n \"doc\"\n ]\n },\n {\n \"login\": \"notruth\",\n \"name\": \"S S\",\n \"avatar_url\": \"https://avatars2.githubusercontent.com/u/11996139?v=4\",\n \"profile\": \"https://github.com/notruth\",\n \"contributions\": [\n \"question\",\n \"code\",\n \"doc\",\n \"ideas\",\n \"test\"\n ]\n },\n {\n \"login\": \"austintackaberry\",\n \"name\": \"Austin Tackaberry\",\n \"avatar_url\": \"https://avatars0.githubusercontent.com/u/29493001?v=4\",\n \"profile\": \"http://austintackaberry.co\",\n \"contributions\": [\n \"question\",\n \"code\",\n \"doc\",\n \"bug\",\n \"example\",\n \"ideas\",\n \"review\",\n \"test\"\n ]\n },\n {\n \"login\": \"jduthon\",\n \"name\": \"Jean Duthon\",\n \"avatar_url\": \"https://avatars3.githubusercontent.com/u/4168055?v=4\",\n \"profile\": \"https://github.com/jduthon\",\n \"contributions\": [\n \"bug\",\n \"code\"\n ]\n },\n {\n \"login\": \"Antontelesh\",\n \"name\": \"Anton Telesh\",\n \"avatar_url\": \"https://avatars3.githubusercontent.com/u/3889580?v=4\",\n \"profile\": \"http://antontelesh.github.io\",\n \"contributions\": [\n \"bug\",\n \"code\"\n ]\n },\n {\n \"login\": \"ericedem\",\n \"name\": \"Eric Edem\",\n \"avatar_url\": \"https://avatars3.githubusercontent.com/u/1060669?v=4\",\n \"profile\": \"https://github.com/ericedem\",\n \"contributions\": [\n \"code\",\n \"doc\",\n \"ideas\",\n \"test\"\n ]\n },\n {\n \"login\": \"indiesquidge\",\n \"name\": \"Austin Wood\",\n \"avatar_url\": \"https://avatars3.githubusercontent.com/u/3409645?v=4\",\n \"profile\": \"https://github.com/indiesquidge\",\n \"contributions\": [\n \"question\",\n \"doc\",\n \"review\"\n ]\n },\n {\n \"login\": \"mmmurray\",\n \"name\": \"Mark Murray\",\n \"avatar_url\": \"https://avatars3.githubusercontent.com/u/14275790?v=4\",\n \"profile\": \"https://github.com/mmmurray\",\n \"contributions\": [\n \"infra\"\n ]\n },\n {\n \"login\": \"gsimone\",\n \"name\": \"Gianmarco\",\n \"avatar_url\": \"https://avatars0.githubusercontent.com/u/1862172?v=4\",\n \"profile\": \"https://github.com/gsimone\",\n \"contributions\": [\n \"bug\",\n \"code\"\n ]\n },\n {\n \"login\": \"pastr\",\n \"name\": \"Emmanuel Pastor\",\n \"avatar_url\": \"https://avatars2.githubusercontent.com/u/6838136?v=4\",\n \"profile\": \"https://github.com/pastr\",\n \"contributions\": [\n \"example\"\n ]\n },\n {\n \"login\": \"dalehurwitz\",\n \"name\": \"dalehurwitz\",\n \"avatar_url\": \"https://avatars2.githubusercontent.com/u/10345034?v=4\",\n \"profile\": \"https://github.com/dalehurwitz\",\n \"contributions\": [\n \"code\"\n ]\n },\n {\n \"login\": \"blobor\",\n \"name\": \"Bogdan Lobor\",\n \"avatar_url\": \"https://avatars1.githubusercontent.com/u/4813007?v=4\",\n \"profile\": \"https://github.com/blobor\",\n \"contributions\": [\n \"bug\",\n \"code\"\n ]\n },\n {\n \"login\": \"infiniteluke\",\n \"name\": \"Luke Herrington\",\n \"avatar_url\": \"https://avatars0.githubusercontent.com/u/1127238?v=4\",\n \"profile\": \"https://github.com/infiniteluke\",\n \"contributions\": [\n \"example\"\n ]\n },\n {\n \"login\": \"drobannx\",\n \"name\": \"Brandon Clemons\",\n \"avatar_url\": \"https://avatars2.githubusercontent.com/u/6361167?v=4\",\n \"profile\": \"https://github.com/drobannx\",\n \"contributions\": [\n \"code\"\n ]\n },\n {\n \"login\": \"aMollusk\",\n \"name\": \"Kieran\",\n \"avatar_url\": \"https://avatars0.githubusercontent.com/u/10591587?v=4\",\n \"profile\": \"https://github.com/aMollusk\",\n \"contributions\": [\n \"code\"\n ]\n },\n {\n \"login\": \"Brushedoctopus\",\n \"name\": \"Brushedoctopus\",\n \"avatar_url\": \"https://avatars3.githubusercontent.com/u/11570627?v=4\",\n \"profile\": \"https://github.com/Brushedoctopus\",\n \"contributions\": [\n \"bug\",\n \"code\"\n ]\n },\n {\n \"login\": \"cameronprattedwards\",\n \"name\": \"Cameron Edwards\",\n \"avatar_url\": \"https://avatars3.githubusercontent.com/u/5456216?v=4\",\n \"profile\": \"http://cameronpedwards.com\",\n \"contributions\": [\n \"code\",\n \"test\"\n ]\n },\n {\n \"login\": \"stereobooster\",\n \"name\": \"stereobooster\",\n \"avatar_url\": \"https://avatars2.githubusercontent.com/u/179534?v=4\",\n \"profile\": \"https://github.com/stereobooster\",\n \"contributions\": [\n \"code\",\n \"test\"\n ]\n },\n {\n \"login\": \"1Copenut\",\n \"name\": \"Trevor Pierce\",\n \"avatar_url\": \"https://avatars0.githubusercontent.com/u/934879?v=4\",\n \"profile\": \"https://github.com/1Copenut\",\n \"contributions\": [\n \"review\"\n ]\n },\n {\n \"login\": \"franklixuefei\",\n \"name\": \"Xuefei Li\",\n \"avatar_url\": \"https://avatars1.githubusercontent.com/u/1334982?v=4\",\n \"profile\": \"http://xuefei-frank.com\",\n \"contributions\": [\n \"code\"\n ]\n },\n {\n \"login\": \"alfredringstad\",\n \"name\": \"Alfred Ringstad\",\n \"avatar_url\": \"https://avatars0.githubusercontent.com/u/7252803?v=4\",\n \"profile\": \"https://hyperlab.se\",\n \"contributions\": [\n \"code\"\n ]\n },\n {\n \"login\": \"dovidweisz\",\n \"name\": \"D[oa]vid Weisz\",\n \"avatar_url\": \"https://avatars0.githubusercontent.com/u/6895497?v=4\",\n \"profile\": \"https://github.com/dovidweisz\",\n \"contributions\": [\n \"code\"\n ]\n },\n {\n \"login\": \"RoystonS\",\n \"name\": \"Royston Shufflebotham\",\n \"avatar_url\": \"https://avatars0.githubusercontent.com/u/19773?v=4\",\n \"profile\": \"https://github.com/RoystonS\",\n \"contributions\": [\n \"bug\",\n \"code\"\n ]\n },\n {\n \"login\": \"MichaelDeBoey\",\n \"name\": \"Michaël De Boey\",\n \"avatar_url\": \"https://avatars3.githubusercontent.com/u/6643991?v=4\",\n \"profile\": \"http://michaeldeboey.be\",\n \"contributions\": [\n \"code\"\n ]\n },\n {\n \"login\": \"EricHenry\",\n \"name\": \"Henry\",\n \"avatar_url\": \"https://avatars3.githubusercontent.com/u/4412771?v=4\",\n \"profile\": \"https://github.com/EricHenry\",\n \"contributions\": [\n \"code\"\n ]\n },\n {\n \"login\": \"green-arrow\",\n \"name\": \"Andrew Walton\",\n \"avatar_url\": \"https://avatars3.githubusercontent.com/u/2180127?v=4\",\n \"profile\": \"http://www.greenarrow.me\",\n \"contributions\": [\n \"bug\",\n \"code\",\n \"test\"\n ]\n },\n {\n \"login\": \"arthurdenner\",\n \"name\": \"Arthur Denner\",\n \"avatar_url\": \"https://avatars0.githubusercontent.com/u/13774309?v=4\",\n \"profile\": \"https://github.com/arthurdenner\",\n \"contributions\": [\n \"code\"\n ]\n },\n {\n \"login\": \"stipsan\",\n \"name\": \"Cody Olsen\",\n \"avatar_url\": \"https://avatars2.githubusercontent.com/u/81981?v=4\",\n \"profile\": \"http://twitter.com/stipsan\",\n \"contributions\": [\n \"code\"\n ]\n },\n {\n \"login\": \"TLadd\",\n \"name\": \"Thomas Ladd\",\n \"avatar_url\": \"https://avatars0.githubusercontent.com/u/5084492?v=4\",\n \"profile\": \"https://github.com/TLadd\",\n \"contributions\": [\n \"code\"\n ]\n },\n {\n \"login\": \"lixualinta\",\n \"name\": \"lixualinta\",\n \"avatar_url\": \"https://avatars3.githubusercontent.com/u/34634369?v=4\",\n \"profile\": \"https://github.com/lixualinta\",\n \"contributions\": [\n \"code\"\n ]\n },\n {\n \"login\": \"JCofman\",\n \"name\": \"Jacob Cofman\",\n \"avatar_url\": \"https://avatars2.githubusercontent.com/u/2118956?v=4\",\n \"profile\": \"https://twitter.com/JCofman\",\n \"contributions\": [\n \"code\"\n ]\n },\n {\n \"login\": \"jf248\",\n \"name\": \"Joshua Freedman\",\n \"avatar_url\": \"https://avatars3.githubusercontent.com/u/19275184?v=4\",\n \"profile\": \"https://github.com/jf248\",\n \"contributions\": [\n \"code\"\n ]\n },\n {\n \"login\": \"AmyScript\",\n \"name\": \"Amy\",\n \"avatar_url\": \"https://avatars1.githubusercontent.com/u/24494020?v=4\",\n \"profile\": \"https://github.com/AmyScript\",\n \"contributions\": [\n \"example\"\n ]\n },\n {\n \"login\": \"roginfarrer\",\n \"name\": \"Rogin Farrer\",\n \"avatar_url\": \"https://avatars1.githubusercontent.com/u/9063669?v=4\",\n \"profile\": \"http://twitter.com/roginfarrer\",\n \"contributions\": [\n \"code\"\n ]\n },\n {\n \"login\": \"rifler\",\n \"name\": \"Dmitrii Kanatnikov\",\n \"avatar_url\": \"https://avatars3.githubusercontent.com/u/871583\",\n \"profile\": \"https://github.com/rifler\",\n \"contributions\": [\n \"code\"\n ]\n },\n {\n \"login\": \"dallonf\",\n \"name\": \"Dallon Feldner\",\n \"avatar_url\": \"https://avatars2.githubusercontent.com/u/346300?v=4\",\n \"profile\": \"https://github.com/dallonf\",\n \"contributions\": [\n \"bug\",\n \"code\"\n ]\n },\n {\n \"login\": \"samuelfullerthomas\",\n \"name\": \"Samuel Fuller Thomas\",\n \"avatar_url\": \"https://avatars2.githubusercontent.com/u/10165959?v=4\",\n \"profile\": \"https://samuelfullerthomas.com\",\n \"contributions\": [\n \"code\"\n ]\n },\n {\n \"login\": \"audiolion\",\n \"name\": \"Ryan Castner\",\n \"avatar_url\": \"https://avatars1.githubusercontent.com/u/2430381?v=4\",\n \"profile\": \"http://audiolion.github.io\",\n \"contributions\": [\n \"code\"\n ]\n },\n {\n \"login\": \"silviuavram\",\n \"name\": \"Silviu Alexandru Avram\",\n \"avatar_url\": \"https://avatars2.githubusercontent.com/u/11275392?v=4\",\n \"profile\": \"https://github.com/silviuavram\",\n \"contributions\": [\n \"bug\",\n \"code\",\n \"test\"\n ]\n },\n {\n \"login\": \"akronb\",\n \"name\": \"Anton Volkov\",\n \"avatar_url\": \"https://avatars1.githubusercontent.com/u/15676655?v=4\",\n \"profile\": \"https://github.com/akronb\",\n \"contributions\": [\n \"code\",\n \"test\"\n ]\n },\n {\n \"login\": \"keeganstreet\",\n \"name\": \"Keegan Street\",\n \"avatar_url\": \"https://avatars3.githubusercontent.com/u/513363?v=4\",\n \"profile\": \"http://keegan.st\",\n \"contributions\": [\n \"bug\",\n \"code\"\n ]\n },\n {\n \"login\": \"mdugue\",\n \"name\": \"Manuel Dugué\",\n \"avatar_url\": \"https://avatars1.githubusercontent.com/u/894149?v=4\",\n \"profile\": \"http://manueldugue.de\",\n \"contributions\": [\n \"code\"\n ]\n },\n {\n \"login\": \"mkaradeniz\",\n \"name\": \"Max Karadeniz\",\n \"avatar_url\": \"https://avatars2.githubusercontent.com/u/12477983?v=4\",\n \"profile\": \"https://github.com/mkaradeniz\",\n \"contributions\": [\n \"code\"\n ]\n },\n {\n \"login\": \"GonchuB\",\n \"name\": \"Gonzalo Beviglia\",\n \"avatar_url\": \"https://avatars3.githubusercontent.com/u/857221?v=4\",\n \"profile\": \"https://medium.com/@gonchub\",\n \"contributions\": [\n \"bug\",\n \"code\",\n \"review\"\n ]\n },\n {\n \"login\": \"kilrain\",\n \"name\": \"Brian Kilrain\",\n \"avatar_url\": \"https://avatars2.githubusercontent.com/u/47700687?v=4\",\n \"profile\": \"https://github.com/kilrain\",\n \"contributions\": [\n \"bug\",\n \"code\",\n \"test\",\n \"doc\"\n ]\n },\n {\n \"login\": \"rincedd\",\n \"name\": \"Gerd Zschaler\",\n \"avatar_url\": \"https://avatars0.githubusercontent.com/u/321265?v=4\",\n \"profile\": \"http://www.gzschaler.de\",\n \"contributions\": [\n \"code\",\n \"bug\"\n ]\n },\n {\n \"login\": \"gaskar\",\n \"name\": \"Karen Gasparyan\",\n \"avatar_url\": \"https://avatars1.githubusercontent.com/u/491166?v=4\",\n \"profile\": \"https://github.com/gaskar\",\n \"contributions\": [\n \"code\"\n ]\n },\n {\n \"login\": \"kserjey\",\n \"name\": \"Sergey Korchinskiy\",\n \"avatar_url\": \"https://avatars1.githubusercontent.com/u/19753880?v=4\",\n \"profile\": \"https://github.com/kserjey\",\n \"contributions\": [\n \"bug\",\n \"code\",\n \"test\"\n ]\n },\n {\n \"login\": \"edygar\",\n \"name\": \"Edygar Oliveira\",\n \"avatar_url\": \"https://avatars.githubusercontent.com/u/566280?v=3\",\n \"profile\": \"https://github.com/edygar\",\n \"contributions\": [\n \"code\",\n \"bug\"\n ]\n },\n {\n \"login\": \"epeicher\",\n \"name\": \"epeicher\",\n \"avatar_url\": \"https://avatars1.githubusercontent.com/u/3519124?v=4\",\n \"profile\": \"https://github.com/epeicher\",\n \"contributions\": [\n \"bug\"\n ]\n },\n {\n \"login\": \"francoischalifour\",\n \"name\": \"François Chalifour\",\n \"avatar_url\": \"https://avatars3.githubusercontent.com/u/6137112?v=4\",\n \"profile\": \"https://francoischalifour.com\",\n \"contributions\": [\n \"code\",\n \"test\",\n \"platform\"\n ]\n },\n {\n \"login\": \"maxmalov\",\n \"name\": \"Maxim Malov\",\n \"avatar_url\": \"https://avatars2.githubusercontent.com/u/284129?v=4\",\n \"profile\": \"https://github.com/maxmalov\",\n \"contributions\": [\n \"bug\",\n \"code\"\n ]\n },\n {\n \"login\": \"epiqueras\",\n \"name\": \"Enrique Piqueras\",\n \"avatar_url\": \"https://avatars2.githubusercontent.com/u/19157096?v=4\",\n \"profile\": \"https://epiqueras.github.io\",\n \"contributions\": [\n \"ideas\"\n ]\n },\n {\n \"login\": \"layershifter\",\n \"name\": \"Oleksandr Fediashov\",\n \"avatar_url\": \"https://avatars0.githubusercontent.com/u/14183168?v=4\",\n \"profile\": \"https://twitter.com/layershifter\",\n \"contributions\": [\n \"code\",\n \"infra\",\n \"ideas\"\n ]\n },\n {\n \"login\": \"saitonakamura\",\n \"name\": \"Mikhail Bashurov\",\n \"avatar_url\": \"https://avatars1.githubusercontent.com/u/1552189?v=4\",\n \"profile\": \"https://github.com/saitonakamura\",\n \"contributions\": [\n \"code\",\n \"bug\"\n ]\n },\n {\n \"login\": \"jgodi\",\n \"name\": \"Joshua Godi\",\n \"avatar_url\": \"https://avatars1.githubusercontent.com/u/870799?v=4\",\n \"profile\": \"http://www.joshuagodi.com\",\n \"contributions\": [\n \"code\"\n ]\n },\n {\n \"login\": \"lukyth\",\n \"name\": \"Kanitkorn Sujautra\",\n \"avatar_url\": \"https://avatars3.githubusercontent.com/u/7040242?v=4\",\n \"profile\": \"https://github.com/lukyth\",\n \"contributions\": [\n \"bug\",\n \"code\"\n ]\n },\n {\n \"login\": \"jorgemoya\",\n \"name\": \"Jorge Moya\",\n \"avatar_url\": \"https://avatars3.githubusercontent.com/u/196129?v=4\",\n \"profile\": \"https://github.com/jorgemoya\",\n \"contributions\": [\n \"code\",\n \"bug\"\n ]\n },\n {\n \"login\": \"KubaJastrz\",\n \"name\": \"Jakub Jastrzębski\",\n \"avatar_url\": \"https://avatars0.githubusercontent.com/u/6443113?v=4\",\n \"profile\": \"https://kubajastrz.com\",\n \"contributions\": [\n \"code\"\n ]\n },\n {\n \"login\": \"mufasa71\",\n \"name\": \"Shukhrat Mukimov\",\n \"avatar_url\": \"https://avatars1.githubusercontent.com/u/626420?v=4\",\n \"profile\": \"https://github.com/mufasa71\",\n \"contributions\": [\n \"code\"\n ]\n },\n {\n \"login\": \"jhonnymoreira\",\n \"name\": \"Jhonny Moreira\",\n \"avatar_url\": \"https://avatars0.githubusercontent.com/u/2177742?v=4\",\n \"profile\": \"http://jhonnymoreira.dev\",\n \"contributions\": [\n \"code\"\n ]\n },\n {\n \"login\": \"stefanprobst\",\n \"name\": \"stefanprobst\",\n \"avatar_url\": \"https://avatars0.githubusercontent.com/u/20753323?v=4\",\n \"profile\": \"https://github.com/stefanprobst\",\n \"contributions\": [\n \"code\",\n \"test\"\n ]\n },\n {\n \"login\": \"louisaspicer\",\n \"name\": \"Louisa Spicer\",\n \"avatar_url\": \"https://avatars1.githubusercontent.com/u/20270031?v=4\",\n \"profile\": \"https://github.com/louisaspicer\",\n \"contributions\": [\n \"code\",\n \"bug\"\n ]\n },\n {\n \"login\": \"neet\",\n \"name\": \"Ryō Igarashi\",\n \"avatar_url\": \"https://avatars2.githubusercontent.com/u/19276905?v=4\",\n \"profile\": \"https://neet.love\",\n \"contributions\": [\n \"bug\",\n \"code\"\n ]\n },\n {\n \"login\": \"rlue\",\n \"name\": \"Ryan Lue\",\n \"avatar_url\": \"https://avatars2.githubusercontent.com/u/12194123?v=4\",\n \"profile\": \"http://ryanlue.com/\",\n \"contributions\": [\n \"doc\"\n ]\n },\n {\n \"login\": \"mattleonowicz\",\n \"name\": \"Mateusz Leonowicz\",\n \"avatar_url\": \"https://avatars3.githubusercontent.com/u/9438872?v=4\",\n \"profile\": \"https://github.com/mattleonowicz\",\n \"contributions\": [\n \"code\"\n ]\n },\n {\n \"login\": \"atomicpages\",\n \"name\": \"Dennis Thompson\",\n \"avatar_url\": \"https://avatars2.githubusercontent.com/u/1824291?v=4\",\n \"profile\": \"https://github.com/atomicpages\",\n \"contributions\": [\n \"test\"\n ]\n },\n {\n \"login\": \"mayicodefuture\",\n \"name\": \"Maksym Boytsov\",\n \"avatar_url\": \"https://avatars1.githubusercontent.com/u/32408893?v=4\",\n \"profile\": \"https://mayicodefuture.live\",\n \"contributions\": [\n \"code\"\n ]\n },\n {\n \"login\": \"IwalkAlone\",\n \"name\": \"Sergey Skrynnikov\",\n \"avatar_url\": \"https://avatars1.githubusercontent.com/u/5685800?v=4\",\n \"profile\": \"http://dataart.com\",\n \"contributions\": [\n \"code\",\n \"test\"\n ]\n },\n {\n \"login\": \"vvo\",\n \"name\": \"Vincent Voyer\",\n \"avatar_url\": \"https://avatars0.githubusercontent.com/u/123822?v=4\",\n \"profile\": \"https://www.linkedin.com/in/vvoyer\",\n \"contributions\": [\n \"doc\"\n ]\n },\n {\n \"login\": \"limejoe\",\n \"name\": \"limejoe\",\n \"avatar_url\": \"https://avatars2.githubusercontent.com/u/7977551?v=4\",\n \"profile\": \"https://github.com/limejoe\",\n \"contributions\": [\n \"code\",\n \"bug\"\n ]\n },\n {\n \"login\": \"k88manish\",\n \"name\": \"Manish Kumar\",\n \"avatar_url\": \"https://avatars2.githubusercontent.com/u/19614770?v=4\",\n \"profile\": \"https://github.com/k88manish\",\n \"contributions\": [\n \"code\"\n ]\n },\n {\n \"login\": \"fcrezza\",\n \"name\": \"Anang Fachreza\",\n \"avatar_url\": \"https://avatars2.githubusercontent.com/u/48123020?v=4\",\n \"profile\": \"https://github.com/fcrezza\",\n \"contributions\": [\n \"doc\",\n \"example\"\n ]\n },\n {\n \"login\": \"ndeom\",\n \"name\": \"Nick Deom\",\n \"avatar_url\": \"https://avatars2.githubusercontent.com/u/56491159?v=4\",\n \"profile\": \"http://nickdeom.com\",\n \"contributions\": [\n \"code\",\n \"bug\"\n ]\n },\n {\n \"login\": \"clementgarbay\",\n \"name\": \"Clément Garbay\",\n \"avatar_url\": \"https://avatars3.githubusercontent.com/u/12433625?v=4\",\n \"profile\": \"https://github.com/clementgarbay\",\n \"contributions\": [\n \"code\"\n ]\n },\n {\n \"login\": \"KaiminHuang\",\n \"name\": \"Kaimin Huang\",\n \"avatar_url\": \"https://avatars.githubusercontent.com/u/5600404?v=4\",\n \"profile\": \"https://github.com/KaiminHuang\",\n \"contributions\": [\n \"code\",\n \"bug\"\n ]\n },\n {\n \"login\": \"davewelling\",\n \"name\": \"David Welling\",\n \"avatar_url\": \"https://avatars.githubusercontent.com/u/1242456?v=4\",\n \"profile\": \"http://theredcircuit.com\",\n \"contributions\": [\n \"code\",\n \"bug\",\n \"ideas\",\n \"research\"\n ]\n },\n {\n \"login\": \"chandrasekhar1996\",\n \"name\": \"chandrasekhar1996\",\n \"avatar_url\": \"https://avatars.githubusercontent.com/u/33996892?v=4\",\n \"profile\": \"https://github.com/chandrasekhar1996\",\n \"contributions\": [\n \"bug\",\n \"code\"\n ]\n },\n {\n \"login\": \"drewbrend\",\n \"name\": \"Brendan Drew\",\n \"avatar_url\": \"https://avatars.githubusercontent.com/u/5375799?v=4\",\n \"profile\": \"https://github.com/drewbrend\",\n \"contributions\": [\n \"code\"\n ]\n },\n {\n \"login\": \"jeanpan\",\n \"name\": \"Jean Pan\",\n \"avatar_url\": \"https://avatars.githubusercontent.com/u/1307026?v=4\",\n \"profile\": \"https://github.com/jeanpan\",\n \"contributions\": [\n \"code\"\n ]\n },\n {\n \"login\": \"tjenkinson\",\n \"name\": \"Tom Jenkinson\",\n \"avatar_url\": \"https://avatars.githubusercontent.com/u/3259993?v=4\",\n \"profile\": \"https://tjenkinson.me\",\n \"contributions\": [\n \"infra\"\n ]\n },\n {\n \"login\": \"aliceHendicott\",\n \"name\": \"Alice Hendicott\",\n \"avatar_url\": \"https://avatars.githubusercontent.com/u/40346716?v=4\",\n \"profile\": \"https://github.com/aliceHendicott\",\n \"contributions\": [\n \"code\",\n \"bug\"\n ]\n },\n {\n \"login\": \"zmdavis\",\n \"name\": \"Zach Davis\",\n \"avatar_url\": \"https://avatars.githubusercontent.com/u/25305144?v=4\",\n \"profile\": \"https://github.com/zmdavis\",\n \"contributions\": [\n \"code\",\n \"bug\"\n ]\n }\n ],\n \"repoHost\": \"https://github.com\",\n \"contributorsPerLine\": 7,\n \"skipCi\": true,\n \"commitConvention\": \"angular\",\n \"commitType\": \"docs\"\n}\n" }, { "path": ".flowconfig", "content": "[ignore]\n.*/node_modules/\n\n[include]\n./test\n\n[libs]\n\n[lints]\nall=error\n\n[options]\n" }, { "path": ".gitattributes", "content": "* text=auto\n*.js text eol=lf\n" }, { "path": ".github/ISSUE_TEMPLATE.md", "content": "\n\n- `downshift` version:\n- `node` version:\n- `npm` (or `yarn`) version:\n\n**Relevant code or config**\n\n```javascript\n```\n\n**What you did**:\n\n**What happened**:\n\n\n\n**Reproduction repository**:\n\n\n\n**Problem description**:\n\n**Suggested solution**:\n" }, { "path": ".github/PULL_REQUEST_TEMPLATE.md", "content": "\n\n# Pull Request\n\n## What\n\n\n\n## Why\n\n\n\n## How\n\n\n\n## Changes\n\n\n\n## Checklist\n\n\n\n\n- [ ] Documentation\n- [ ] Tests\n- [ ] TypeScript Types\n- [ ] Ready to be merged\n \n\n\n" }, { "path": ".github/workflows/validate.yml", "content": "name: validate\non:\n push:\n branches:\n - '+([0-9])?(.{+([0-9]),x}).x'\n - 'master'\n - 'next'\n - 'next-major'\n - 'beta'\n - 'alpha'\n - '!all-contributors/**'\n pull_request: {}\njobs:\n main:\n # ignore all-contributors PRs\n if: ${{ !contains(github.head_ref, 'all-contributors') }}\n strategy:\n matrix:\n node: [20, 22, 24]\n runs-on: ubuntu-latest\n steps:\n - name: 🛑 Cancel Previous Runs\n uses: styfle/cancel-workflow-action@0.12.1\n with:\n access_token: ${{ secrets.GITHUB_TOKEN }}\n - name: ⬇️ Checkout repo\n uses: actions/checkout@v5\n\n - name: Increase watchers\n run:\n echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf\n && sudo sysctl -p\n\n - name: ⎔ Setup node\n uses: actions/setup-node@v5\n with:\n node-version: ${{ matrix.node }}\n\n - name: 📥 Download deps\n uses: bahmutov/npm-install@v1\n with:\n useLockFile: false\n\n - name: ▶️ Run validate script\n run: npm run validate\n env:\n FORCE_COLOR: true\n\n - name: ⬆️ Upload coverage report\n uses: codecov/codecov-action@v5\n env:\n CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}\n\n release:\n needs: main\n runs-on: ubuntu-latest\n if:\n ${{ github.repository == 'downshift-js/downshift' &&\n contains('refs/heads/master,refs/heads/beta,refs/heads/next,refs/heads/alpha',\n github.ref) && github.event_name == 'push' }}\n steps:\n - name: 🛑 Cancel Previous Runs\n uses: styfle/cancel-workflow-action@0.12.1\n with:\n access_token: ${{ secrets.GITHUB_TOKEN }}\n\n - name: ⬇️ Checkout repo\n uses: actions/checkout@v5\n\n - name: ⎔ Setup node\n uses: actions/setup-node@v5\n with:\n node-version: 24\n\n - name: 📥 Download deps\n uses: bahmutov/npm-install@v1\n with:\n useLockFile: false\n\n - name: 🏗 Run build script\n run: npm run build\n\n - name: 🚀 Release\n uses: cycjimmy/semantic-release-action@v6\n with:\n semantic_version: 24\n branches: |\n [\n '+([0-9])?(.{+([0-9]),x}).x',\n 'master',\n 'next',\n 'next-major',\n {name: 'beta', prerelease: true},\n {name: 'alpha', prerelease: true}\n ]\n env:\n GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}\n NPM_TOKEN: ${{ secrets.NPM_TOKEN }}" }, { "path": ".gitignore", "content": "node_modules\ncoverage\ndist\n.opt-in\n.opt-out\n.DS_Store\n.next\n.eslintcache\npreact/\n\ncypress/videos\ncypress/screenshots\n\n# these cause more harm than good\n# when working with contributors\npackage-lock.json\nyarn.lock\nflow-coverage/\n\n# Production\n/build\n\n# Generated files\n.docusaurus\n.cache-loader\n\n# Misc\n.env.local\n.env.development.local\n.env.test.local\n.env.production.local\n\nnpm-debug.log*\n\n# IDE settings\n.idea\n" }, { "path": ".npmrc", "content": "registry=https://registry.npmjs.org/\npackage-lock=false\n" }, { "path": ".nvmrc", "content": "16.14.0\n" }, { "path": ".prettierignore", "content": "node_modules/\ncoverage/\ndist/\npreact/\npackage-lock.json\npackage.json\n" }, { "path": "CHANGELOG.md", "content": "# CHANGELOG\n\nThe changelog is automatically updated using\n[semantic-release](https://github.com/semantic-release/semantic-release). You\ncan see it on the [releases page](../../releases).\n" }, { "path": "CODE_OF_CONDUCT.md", "content": "# Contributor Covenant Code of Conduct\n\n\n\n\n\n**Table of Contents**\n\n- [Our Pledge](#our-pledge)\n- [Our Standards](#our-standards)\n- [Our Responsibilities](#our-responsibilities)\n- [Scope](#scope)\n- [Enforcement](#enforcement)\n- [Attribution](#attribution)\n\n\n\n## Our Pledge\n\nIn the interest of fostering an open and welcoming environment, we as\ncontributors and maintainers pledge to making participation in our project and\nour community a harassment-free experience for everyone, regardless of age, body\nsize, disability, ethnicity, gender identity and expression, level of\nexperience, nationality, personal appearance, race, religion, or sexual identity\nand orientation.\n\n## Our Standards\n\nExamples of behavior that contributes to creating a positive environment\ninclude:\n\n- Using welcoming and inclusive language\n- Being respectful of differing viewpoints and experiences\n- Gracefully accepting constructive criticism\n- Focusing on what is best for the community\n- Showing empathy towards other community members\n\nExamples of unacceptable behavior by participants include:\n\n- The use of sexualized language or imagery and unwelcome sexual attention or\n advances\n- Trolling, insulting/derogatory comments, and personal or political attacks\n- Public or private harassment\n- Publishing others' private information, such as a physical or electronic\n address, without explicit permission\n- Other conduct which could reasonably be considered inappropriate in a\n professional setting\n\n## Our Responsibilities\n\nProject maintainers are responsible for clarifying the standards of acceptable\nbehavior and are expected to take appropriate and fair corrective action in\nresponse to any instances of unacceptable behavior.\n\nProject maintainers have the right and responsibility to remove, edit, or reject\ncomments, commits, code, wiki edits, issues, and other contributions that are\nnot aligned to this Code of Conduct, or to ban temporarily or permanently any\ncontributor for other behaviors that they deem inappropriate, threatening,\noffensive, or harmful.\n\n## Scope\n\nThis Code of Conduct applies both within project spaces and in public spaces\nwhen an individual is representing the project or its community. Examples of\nrepresenting a project or community include using an official project e-mail\naddress, posting via an official social media account, or acting as an appointed\nrepresentative at an online or offline event. Representation of a project may be\nfurther defined and clarified by project maintainers.\n\n## Enforcement\n\nInstances of abusive, harassing, or otherwise unacceptable behavior may be\nreported by contacting the project team at kent+coc@doddsfamily.us. All\ncomplaints will be reviewed and investigated and will result in a response that\nis deemed necessary and appropriate to the circumstances. The project team is\nobligated to maintain confidentiality with regard to the reporter of an\nincident. Further details of specific enforcement policies may be posted\nseparately.\n\nProject maintainers who do not follow or enforce the Code of Conduct in good\nfaith may face temporary or permanent repercussions as determined by other\nmembers of the project's leadership.\n\n## Attribution\n\nThis Code of Conduct is adapted from the [Contributor Covenant][homepage],\nversion 1.4, available at [http://contributor-covenant.org/version/1/4][version]\n\n[homepage]: http://contributor-covenant.org\n[version]: http://contributor-covenant.org/version/1/4/\n" }, { "path": "CONTRIBUTING.md", "content": "# Contributing\n\nThanks for being willing to contribute!\n\n**Working on your first Pull Request?** You can learn how from this _free_\nseries [How to Contribute to an Open Source Project on GitHub][egghead]\n\n## Project setup\n\n1. Fork and clone the repo\n2. `npm run setup` to setup and validate your clone of the project\n3. Create a branch for your PR\n\n> Tip: Keep your `master` branch pointing at the original repository and make\n> pull requests from branches on your fork. To do this, run:\n>\n> ```\n> git remote add upstream https://github.com/downshift-js/downshift.git\n> git fetch upstream\n> git branch --set-upstream-to=upstream/master master\n> ```\n>\n> This will add the original repository as a \"remote\" called \"upstream,\" Then\n> fetch the git information from that remote, then set your local `master`\n> branch to use the upstream master branch whenever you run `git pull`. Then you\n> can make all of your pull request branches based on this `master` branch.\n> Whenever you want to update your version of `master`, do a regular `git pull`.\n\n## Committing and Pushing changes\n\nPlease make sure to run the tests before you commit your changes. You can run\n`npm run test:update` which will update any snapshots that need updating. Make\nsure to include those changes (if they exist) in your commit. We also track the\nbundle sizes in a `.size-snapshot.json` file, this will likely update when you\nmake changes to the codebase.\n\n### Tests\n\nThere are quite a few test scripts that run as part of a `validate` script in\nthis project:\n\n- lint - ESLint stuff, pretty basic. Please fix any errors/warnings :)\n- build-and-test - This ensures that the built version of `downshift` is what we\n expect. These tests live in `other/misc-tests/__tests__`.\n- test:cover - This is primarily unit tests on the source code and accounts for\n most of the coverage. We enforce 100% code coverage on this library. These\n tests live in `src/__tests__`\n- test:ts - This runs `tsc` on the codebase to make sure the type script\n definitions are correct for the `tsx` files in the `test` directory.\n- test:ssr - This ensures that downshift works with server-side rendering (it\n can run and render in an environment without the DOM). These tests live in\n `other/ssr/__tests__`\n- test:cypress - This runs tests in an actual browser. It runs and tests the\n storybook examples. These tests live in `cypress/integration`.\n\n### opt into git hooks\n\nThere are git hooks set up with this project that are automatically installed\nwhen you install dependencies. They're really handy, but are turned off by\ndefault (so as to not hinder new contributors). You can opt into these by\ncreating a file called `.opt-in` at the root of the project and putting this\ninside:\n\n```\npre-commit\n```\n\n## Help needed\n\nPlease checkout the [the open issues][issues]\n\nAlso, please watch the repo and respond to questions/bug reports/feature\nrequests! Thanks!\n\n[egghead]:\n https://app.egghead.io/playlists/how-to-contribute-to-an-open-source-project-on-github\n[all-contributors]: https://github.com/kentcdodds/all-contributors\n[issues]: https://github.com/downshift-js/downshift/issues\n" }, { "path": "LICENSE", "content": "The MIT License (MIT)\nCopyright (c) 2017 PayPal\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n" }, { "path": "README.md", "content": "

\n downshift 🏎\n
\n \"downshift\n
\n

\n

Primitives to build simple, flexible, WAI-ARIA compliant React\nautocomplete, combobox or select dropdown components.

\n\n> [Read the docs](https://downshift-js.com) |\n> [See the intro blog post](https://kentcdodds.com/blog/introducing-downshift-for-react)\n> |\n> [Listen to the Episode 79 of the Full Stack Radio podcast](https://fullstackradio.com/79)\n\n
\n\n[![Build Status][build-badge]][build]\n[![Code Coverage][coverage-badge]][coverage]\n[![downloads][downloads-badge]][npmcharts] [![version][version-badge]][package]\n[![MIT License][license-badge]][license]\n\n[![All Contributors](https://img.shields.io/badge/all_contributors-113-orange.svg?style=flat-square)](#contributors)\n[![PRs Welcome][prs-badge]][prs] [![Chat][chat-badge]][chat]\n[![Code of Conduct][coc-badge]][coc]\n[![Join the community on Spectrum][spectrum-badge]][spectrum]\n\n[![Supports React and Preact][react-badge]][react]\n[![size][size-badge]][unpkg-dist] [![gzip size][gzip-badge]][unpkg-dist]\n[![module formats: umd, cjs, and es][module-formats-badge]][unpkg-dist]\n\n## The problem\n\nYou need an autocomplete, a combobox or a select experience in your application\nand you want it to be accessible. You also want it to be simple and flexible to\naccount for your use cases. Finally, it should follow the [ARIA][aria] design\npattern for a [combobox][combobox-aria-example] or a\n[select][select-aria-example], depending on your use case.\n\n## This solution\n\nThe library offers a couple of solutions. The first solution, which is the one\nwe recommend you to try first, is a set of React hooks. Each hook provides the\nstateful logic needed to make the corresponding component functional and\naccessible. Navigate to the documentation for each by using the links in the\nlist below.\n\n- [useSelect][useselect-readme] for a custom select component.\n- [useCombobox][combobox-readme] for a combobox or autocomplete input.\n- [useTagGroup][tag-group-readme] for a tag group component. Also useful to\n build a multiple selection combobox or select component with tags.\n\nThe second solution is the `Downshift` component, which can also be used to\ncreate accessible combobox and select components, providing the logic in the\nform of a render prop. It served as inspiration for developing the hooks and it\nhas been around for a while. It established a successful pattern for making\ncomponents accessible and functional while giving developers complete freedom\nwhen building the UI.\n\nBoth _useSelect_ and _useCombobox_ support the latest ARIA combobox patterns for\nW3C, which _Downshift_ does not. Consequently, we strongly recommend the you use\nthe hooks. The hooks have been migrated to the ARIA 1.2 combobox pattern in the\nversion 7 of _downshift_. There is a [Migration Guide][migration-guide-v7] that\ndocuments the changes introduced in version 7.\n\nThe `README` on this page covers only the component while each hook has its own\n`README` page. You can navigate to the [hooks page][hooks-readme] or go directly\nto the hook you need by using the links in the list above.\n\nFor examples on how to use the hooks or the Downshift component, check out our\n[docsite][docsite]!\n\n**🚨 Use the Downshift hooks 🚨**\n\nIf you are new to the library, consider the _useSelect_ and _useCombobox_ hooks\nas the first option. As mentioned above, the hooks benefit from the updated ARIA\npatterns and are actively maintained and improved. If there are use cases that\nare supported by the _Downshift_ component and not by the hooks, please create\nan issue in our repo. The _Downshift_ component is going to be removed\ncompletely once the hooks become mature.\n\n### Downshift\n\nThis is a component that controls user interactions and state for you so you can\ncreate autocomplete, combobox or select dropdown components. It uses a [render\nprop][use-a-render-prop] which gives you maximum flexibility with a minimal API\nbecause you are responsible for the rendering of everything and you simply apply\nprops to what you're rendering.\n\nThis differs from other solutions which render things for their use case and\nthen expose many options to allow for extensibility resulting in a bigger API\nthat is less flexible as well as making the implementation more complicated and\nharder to contribute to.\n\n> NOTE: The original use case of this component is autocomplete, however the API\n> is powerful and flexible enough to build things like dropdowns as well.\n\n## Table of Contents\n\n\n\n\n- [Installation](#installation)\n- [Usage](#usage)\n- [Basic Props](#basic-props)\n - [children](#children)\n - [itemToString](#itemtostring)\n - [onChange](#onchange)\n - [stateReducer](#statereducer)\n- [Advanced Props](#advanced-props)\n - [initialSelectedItem](#initialselecteditem)\n - [initialInputValue](#initialinputvalue)\n - [initialHighlightedIndex](#initialhighlightedindex)\n - [initialIsOpen](#initialisopen)\n - [defaultHighlightedIndex](#defaulthighlightedindex)\n - [defaultIsOpen](#defaultisopen)\n - [selectedItemChanged](#selecteditemchanged)\n - [getA11yStatusMessage](#geta11ystatusmessage)\n - [onSelect](#onselect)\n - [onStateChange](#onstatechange)\n - [onInputValueChange](#oninputvaluechange)\n - [itemCount](#itemcount)\n - [highlightedIndex](#highlightedindex)\n - [inputValue](#inputvalue)\n - [isOpen](#isopen)\n - [selectedItem](#selecteditem)\n - [id](#id)\n - [inputId](#inputid)\n - [labelId](#labelid)\n - [menuId](#menuid)\n - [getItemId](#getitemid)\n - [environment](#environment)\n - [onOuterClick](#onouterclick)\n - [scrollIntoView](#scrollintoview)\n- [stateChangeTypes](#statechangetypes)\n- [Control Props](#control-props)\n- [Children Function](#children-function)\n - [prop getters](#prop-getters)\n - [actions](#actions)\n - [state](#state)\n - [props](#props)\n- [Event Handlers](#event-handlers)\n - [default handlers](#default-handlers)\n - [customizing handlers](#customizing-handlers)\n- [Utilities](#utilities)\n - [resetIdCounter](#resetidcounter)\n- [React Native](#react-native)\n - [Gotchas](#gotchas)\n- [Advanced React Component Patterns course](#advanced-react-component-patterns-course)\n- [Examples](#examples)\n- [FAQ](#faq)\n- [Inspiration](#inspiration)\n- [Other Solutions](#other-solutions)\n- [Bindings for ReasonML](#bindings-for-reasonml)\n- [Contributors](#contributors)\n- [LICENSE](#license)\n\n\n\n## Installation\n\nThis module is distributed via [npm][npm] which is bundled with [node][node] and\nshould be installed as one of your project's `dependencies`:\n\n```\nnpm install --save downshift\n```\n\n> This package also depends on `react`. Please make sure you have it installed\n> as well.\n\n> Note also this library supports `preact` out of the box. If you are using\n> `preact` then use the corresponding module in the `preact/dist` folder. You\n> can even `import Downshift from 'downshift/preact'` 👍\n\n## Usage\n\n> [Try it out in the browser][code-sandbox-try-it-out]\n\n```jsx\nimport * as React from 'react'\nimport {render} from 'react-dom'\nimport Downshift from 'downshift'\n\nconst items = [\n {value: 'apple'},\n {value: 'pear'},\n {value: 'orange'},\n {value: 'grape'},\n {value: 'banana'},\n]\n\nrender(\n \n alert(selection ? `You selected ${selection.value}` : 'Selection Cleared')\n }\n itemToString={item => (item ? item.value : '')}\n >\n {({\n getInputProps,\n getItemProps,\n getLabelProps,\n getMenuProps,\n isOpen,\n inputValue,\n highlightedIndex,\n selectedItem,\n getRootProps,\n }) => (\n
\n \n \n \n
\n \n \n )}\n ,\n document.getElementById('root'),\n)\n```\n\nThere is also an [example without getRootProps][code-sandbox-no-get-root-props].\n\n> Warning: The example without `getRootProps` is not fully accessible with\n> screen readers as it's not possible to achieve the HTML structure suggested by\n> ARIA. We recommend following the example with `getRootProps`. Examples on how\n> to use `Downshift` component with and without `getRootProps` are on the\n> [docsite](https://downshift-js.com/).\n\n`Downshift` is the only component exposed by this package. It doesn't render\nanything itself, it just calls the render function and renders that. [\"Use a\nrender prop!\"][use-a-render-prop]!\n`{downshift =>
/* your JSX here! */
}`.\n\n## Basic Props\n\nThis is the list of props that you should probably know about. There are some\n[advanced props](#advanced-props) below as well.\n\n### children\n\n> `function({})` | _required_\n\nThis is called with an object. Read more about the properties of this object in\nthe section \"[Children Function](#children-function)\".\n\n### itemToString\n\n> `function(item: any)` | defaults to: `item => (item ? String(item) : '')`\n\nIf your items are stored as, say, objects instead of strings, downshift still\nneeds a string representation for each one (e.g., to set `inputValue`).\n\n**Note:** This callback _must_ include a null check: it is invoked with `null`\nwhenever the user abandons input via ``.\n\n### onChange\n\n> `function(selectedItem: any, stateAndHelpers: object)` | optional, no useful\n> default\n\nCalled when the selected item changes, either by the user selecting an item or\nthe user clearing the selection. Called with the item that was selected or\n`null` and the new state of `downshift`. (see `onStateChange` for more info on\n`stateAndHelpers`).\n\n- `selectedItem`: The item that was just selected. `null` if the selection was\n cleared.\n- `stateAndHelpers`: This is the same thing your `children` function is called\n with (see [Children Function](#children-function))\n\n### stateReducer\n\n> `function(state: object, changes: object)` | optional\n\n**🚨 This is a really handy power feature 🚨**\n\nThis function will be called each time `downshift` sets its internal state (or\ncalls your `onStateChange` handler for control props). It allows you to modify\nthe state change that will take place which can give you fine grain control over\nhow the component interacts with user updates without having to use\n[Control Props](#control-props). It gives you the current state and the state\nthat will be set, and you return the state that you want to set.\n\n- `state`: The full current state of downshift.\n- `changes`: These are the properties that are about to change. This also has a\n `type` property which you can learn more about in the\n [`stateChangeTypes`](#statechangetypes) section.\n\n```jsx\nconst ui = (\n {/* your callback */}\n)\n\nfunction stateReducer(state, changes) {\n // this prevents the menu from being closed when the user\n // selects an item with a keyboard or mouse\n switch (changes.type) {\n case Downshift.stateChangeTypes.keyDownEnter:\n case Downshift.stateChangeTypes.clickItem:\n return {\n ...changes,\n isOpen: state.isOpen,\n highlightedIndex: state.highlightedIndex,\n }\n default:\n return changes\n }\n}\n```\n\n> NOTE: This is only called when state actually changes. You should not attempt\n> to use this to handle events. If you wish to handle events, put your event\n> handlers directly on the elements (make sure to use the prop getters though!\n> For example: `` should be\n> ``). Also, your reducer\n> function should be \"pure.\" This means it should do nothing other than return\n> the state changes you want to have happen.\n\n## Advanced Props\n\n### initialSelectedItem\n\n> `any` | defaults to `null`\n\nPass an item or an array of items that should be selected when downshift is\ninitialized.\n\n### initialInputValue\n\n> `string` | defaults to `''`\n\nThis is the initial input value when downshift is initialized.\n\n### initialHighlightedIndex\n\n> `number`/`null` | defaults to `defaultHighlightedIndex`\n\nThis is the initial value to set the highlighted index to when downshift is\ninitialized.\n\n### initialIsOpen\n\n> `boolean` | defaults to `defaultIsOpen`\n\nThis is the initial `isOpen` value when downshift is initialized.\n\n### defaultHighlightedIndex\n\n> `number`/`null` | defaults to `null`\n\nThis is the value to set the `highlightedIndex` to anytime downshift is reset,\nwhen the selection is cleared, when an item is selected or when the inputValue\nis changed.\n\n### defaultIsOpen\n\n> `boolean` | defaults to `false`\n\nThis is the value to set the `isOpen` to anytime downshift is reset, when the\nthe selection is cleared, or when an item is selected.\n\n### selectedItemChanged\n\n> `function(prevItem: any, item: any)` | defaults to:\n> `(prevItem, item) => (prevItem !== item)`\n\nUsed to determine if the new `selectedItem` has changed compared to the previous\n`selectedItem` and properly update Downshift's internal state.\n\n### getA11yStatusMessage\n\n> `function({/* see below */})` | default messages provided in English\n\nThis function is passed as props to a `Status` component nested within and\nallows you to create your own assertive ARIA statuses.\n\nA default `getA11yStatusMessage` function is provided that will check\n`resultCount` and return \"No results are available.\" or if there are results ,\n\"`resultCount` results are available, use up and down arrow keys to navigate.\nPress Enter key to select.\"\n\nThe object you are passed to generate your status message has the following\nproperties:\n\n\n\n| property | type | description |\n| --------------------- | --------------- | -------------------------------------------------------------------------------------------- |\n| `highlightedIndex` | `number`/`null` | The currently highlighted index |\n| `highlightedItem` | `any` | The value of the highlighted item |\n| `inputValue` | `string` | The current input value |\n| `isOpen` | `boolean` | The `isOpen` state |\n| `itemToString` | `function(any)` | The `itemToString` function (see props) for getting the string value from one of the options |\n| `previousResultCount` | `number` | The total items showing in the dropdown the last time the status was updated |\n| `resultCount` | `number` | The total items showing in the dropdown |\n| `selectedItem` | `any` | The value of the currently selected item |\n\n### onSelect\n\n> `function(selectedItem: any, stateAndHelpers: object)` | optional, no useful\n> default\n\nCalled when the user selects an item, regardless of the previous selected item.\nCalled with the item that was selected and the new state of `downshift`. (see\n`onStateChange` for more info on `stateAndHelpers`).\n\n- `selectedItem`: The item that was just selected\n- `stateAndHelpers`: This is the same thing your `children` function is called\n with (see [Children Function](#children-function))\n\n### onStateChange\n\n> `function(changes: object, stateAndHelpers: object)` | optional, no useful\n> default\n\nThis function is called anytime the internal state changes. This can be useful\nif you're using downshift as a \"controlled\" component, where you manage some or\nall of the state (e.g., isOpen, selectedItem, highlightedIndex, etc) and then\npass it as props, rather than letting downshift control all its state itself.\nThe parameters both take the shape of internal state\n(`{highlightedIndex: number, inputValue: string, isOpen: boolean, selectedItem: any}`)\nbut differ slightly.\n\n- `changes`: These are the properties that actually have changed since the last\n state change. This also has a `type` property which you can learn more about\n in the [`stateChangeTypes`](#statechangetypes) section.\n- `stateAndHelpers`: This is the exact same thing your `children` function is\n called with (see [Children Function](#children-function))\n\n> Tip: This function will be called any time _any_ state is changed. The best\n> way to determine whether any particular state was changed, you can use\n> `changes.hasOwnProperty('propName')`.\n\n> NOTE: This is only called when state actually changes. You should not attempt\n> to use this to handle events. If you wish to handle events, put your event\n> handlers directly on the elements (make sure to use the prop getters though!\n> For example: `` should be\n> ``).\n\n### onInputValueChange\n\n> `function(inputValue: string, stateAndHelpers: object)` | optional, no useful\n> default\n\nCalled whenever the input value changes. Useful to use instead or in combination\nof `onStateChange` when `inputValue` is a controlled prop to\n[avoid issues with cursor positions](https://github.com/downshift-js/downshift/issues/217).\n\n- `inputValue`: The current value of the input\n- `stateAndHelpers`: This is the same thing your `children` function is called\n with (see [Children Function](#children-function))\n\n### itemCount\n\n> `number` | optional, defaults the number of times you call getItemProps\n\nThis is useful if you're using some kind of virtual listing component for\n\"windowing\" (like\n[`react-virtualized`](https://github.com/bvaughn/react-virtualized)).\n\n### highlightedIndex\n\n> `number` | **control prop** (read more about this in\n> [the Control Props section](#control-props))\n\nThe index that should be highlighted\n\n### inputValue\n\n> `string` | **control prop** (read more about this in\n> [the Control Props section](#control-props))\n\nThe value the input should have\n\n### isOpen\n\n> `boolean` | **control prop** (read more about this in\n> [the Control Props section](#control-props))\n\nWhether the menu should be considered open or closed. Some aspects of the\ndownshift component respond differently based on this value (for example, if\n`isOpen` is true when the user hits \"Enter\" on the input field, then the item at\nthe `highlightedIndex` item is selected).\n\n### selectedItem\n\n> `any`/`Array(any)` | **control prop** (read more about this in\n> [the Control Props section](#control-props))\n\nThe currently selected item.\n\n### id\n\n> `string` | defaults to a generated ID\n\nYou should not normally need to set this prop. It's only useful if you're server\nrendering items (which each have an `id` prop generated based on the `downshift`\n`id`). For more information see the `FAQ` below.\n\n### inputId\n\n> `string` | defaults to a generated ID\n\nUsed for `aria` attributes and the `id` prop of the element (`input`) you use\n[`getInputProps`](#getinputprops) with.\n\n### labelId\n\n> `string` | defaults to a generated ID\n\nUsed for `aria` attributes and the `id` prop of the element (`label`) you use\n[`getLabelProps`](#getlabelprops) with.\n\n### menuId\n\n> `string` | defaults to a generated ID\n\nUsed for `aria` attributes and the `id` prop of the element (`ul`) you use\n[`getMenuProps`](#getmenuprops) with.\n\n### getItemId\n\n> `function(index)` | defaults to a function that generates an ID based on the\n> index\n\nUsed for `aria` attributes and the `id` prop of the element (`li`) you use\n[`getInputProps`](#getinputprops) with.\n\n### environment\n\n> `window` | defaults to `window`\n\nThis prop is only useful if you're rendering downshift within a different\n`window` context from where your JavaScript is running; for example, an iframe\nor a shadow-root. If the given context is lacking `document` and/or\n`add|removeEventListener` on its prototype (as is the case for a shadow-root)\nthen you will need to pass in a custom object that is able to provide\n[access to these properties](https://gist.github.com/Rendez/1dd55882e9b850dd3990feefc9d6e177)\nfor downshift.\n\n### onOuterClick\n\n> `function(stateAndHelpers: object)` | optional\n\nA helper callback to help control internal state of downshift like `isOpen` as\nmentioned in [this issue](https://github.com/downshift-js/downshift/issues/206).\nThe same behavior can be achieved using `onStateChange`, but this prop is\nprovided as a helper because it's a fairly common use-case if you're controlling\nthe `isOpen` state:\n\n```jsx\nconst ui = (\n this.setState({menuIsOpen: false})}\n >\n {/* your callback */}\n \n)\n```\n\nThis callback will only be called if `isOpen` is `true`.\n\n### scrollIntoView\n\n> `function(node: HTMLElement, menuNode: HTMLElement)` | defaults to internal\n> implementation\n\nThis allows you to customize how the scrolling works when the highlighted index\nchanges. It receives the node to be scrolled to and the root node (the root node\nyou render in downshift). Internally we use\n[`compute-scroll-into-view`](https://www.npmjs.com/package/compute-scroll-into-view)\nso if you use that package then you wont be adding any additional bytes to your\nbundle :)\n\n## stateChangeTypes\n\nThere are a few props that expose changes to state\n([`onStateChange`](#onstatechange) and [`stateReducer`](#statereducer)). For you\nto make the most of these APIs, it's important for you to understand why state\nis being changed. To accomplish this, there's a `type` property on the `changes`\nobject you get. This `type` corresponds to a `Downshift.stateChangeTypes`\nproperty.\n\nThe list of all possible values this `type` property can take is defined in\n[this file](https://github.com/downshift-js/downshift/blob/master/src/stateChangeTypes.js)\nand is as follows:\n\n- `Downshift.stateChangeTypes.unknown`\n- `Downshift.stateChangeTypes.mouseUp`\n- `Downshift.stateChangeTypes.itemMouseEnter`\n- `Downshift.stateChangeTypes.keyDownArrowUp`\n- `Downshift.stateChangeTypes.keyDownArrowDown`\n- `Downshift.stateChangeTypes.keyDownEscape`\n- `Downshift.stateChangeTypes.keyDownEnter`\n- `Downshift.stateChangeTypes.keyDownHome`\n- `Downshift.stateChangeTypes.keyDownEnd`\n- `Downshift.stateChangeTypes.clickItem`\n- `Downshift.stateChangeTypes.blurInput`\n- `Downshift.stateChangeTypes.changeInput`\n- `Downshift.stateChangeTypes.keyDownSpaceButton`\n- `Downshift.stateChangeTypes.clickButton`\n- `Downshift.stateChangeTypes.blurButton`\n- `Downshift.stateChangeTypes.controlledPropUpdatedSelectedItem`\n- `Downshift.stateChangeTypes.touchEnd`\n\nSee [`stateReducer`](#statereducer) for a concrete example on how to use the\n`type` property.\n\n## Control Props\n\ndownshift manages its own state internally and calls your `onChange` and\n`onStateChange` handlers with any relevant changes. The state that downshift\nmanages includes: `isOpen`, `selectedItem`, `inputValue`, and\n`highlightedIndex`. Your Children function (read more below) can be used to\nmanipulate this state and can likely support many of your use cases.\n\nHowever, if more control is needed, you can pass any of these pieces of state as\na prop (as indicated above) and that state becomes controlled. As soon as\n`this.props[statePropKey] !== undefined`, internally, `downshift` will determine\nits state based on your prop's value rather than its own internal state. You\nwill be required to keep the state up to date (this is where `onStateChange`\ncomes in really handy), but you can also control the state from anywhere, be\nthat state from other components, `redux`, `react-router`, or anywhere else.\n\n> Note: This is very similar to how normal controlled components work elsewhere\n> in react (like ``). If you want to learn more about this concept, you\n> can learn about that from this the\n> [Advanced React Component Patterns course](#advanced-react-component-patterns-course)\n\n## Children Function\n\nThis is where you render whatever you want to based on the state of `downshift`.\nYou use it like so:\n\n```javascript\nconst ui = (\n \n {downshift => (\n // use downshift utilities and state here, like downshift.isOpen,\n // downshift.getInputProps, etc.\n
{/* more jsx here */}
\n )}\n \n)\n```\n\nThe properties of this `downshift` object can be split into three categories as\nindicated below:\n\n### prop getters\n\n> See\n> [the blog post about prop getters](https://kentcdodds.com/blog/how-to-give-rendering-control-to-users-with-prop-getters)\n\n> NOTE: These prop-getters provide important `aria-` attributes which are very\n> important to your component being accessible. It's recommended that you\n> utilize these functions and apply the props they give you to your components.\n\nThese functions are used to apply props to the elements that you render. This\ngives you maximum flexibility to render what, when, and wherever you like. You\ncall these on the element in question (for example:\n`\n\n| property | type | description |\n| ---------------------- | ----------------- | ---------------------------------------------------------------------------------------------- |\n| `getToggleButtonProps` | `function({})` | returns the props you should apply to any menu toggle button element you render. |\n| `getInputProps` | `function({})` | returns the props you should apply to the `input` element that you render. |\n| `getItemProps` | `function({})` | returns the props you should apply to any menu item elements you render. |\n| `getLabelProps` | `function({})` | returns the props you should apply to the `label` element that you render. |\n| `getMenuProps` | `function({},{})` | returns the props you should apply to the `ul` element (or root of your menu) that you render. |\n| `getRootProps` | `function({},{})` | returns the props you should apply to the root element that you render. It can be optional. |\n\n#### `getRootProps`\n\n
\n\n\n If you cannot render a div as the root element, then read this\n\n\nMost of the time, you can just render a `div` yourself and `Downshift` will\napply the props it needs to do its job (and you don't need to call this\nfunction). However, if you're rendering a composite component (custom component)\nas the root element, then you'll need to call `getRootProps` and apply that to\nyour root element (downshift will throw an error otherwise).\n\nThere are no required properties for this method.\n\nOptional properties:\n\n- `refKey`: if you're rendering a composite component, that component will need\n to accept a prop which it forwards to the root DOM element. Commonly, folks\n call this `innerRef`. So you'd call: `getRootProps({refKey: 'innerRef'})` and\n your composite component would forward like: `
`.\n It defaults to `ref`.\n\nIf you're rendering a composite component, `Downshift` checks that\n`getRootProps` is called and that `refKey` is a prop of the returned composite\ncomponent. This is done to catch common causes of errors but, in some cases, the\ncheck could fail even if the ref is correctly forwarded to the root DOM\ncomponent. In these cases, you can provide the object\n`{suppressRefError : true}` as the second argument to `getRootProps` to\ncompletely bypass the check.\\\n**Please use it with extreme care and only if you are absolutely sure that the\nref is correctly forwarded otherwise `Downshift` will unexpectedly fail.**\\\nSee [#235](https://github.com/downshift-js/downshift/issues/235) for the\ndiscussion that lead to this.\n\n
\n\n#### `getInputProps`\n\nThis method should be applied to the `input` you render. It is recommended that\nyou pass all props as an object to this method which will compose together any\nof the event handlers you need to apply to the `input` while preserving the ones\nthat `downshift` needs to apply to make the `input` behave.\n\nThere are no required properties for this method.\n\nOptional properties:\n\n- `disabled`: If this is set to true, then no event handlers will be returned\n from `getInputProps` and a `disabled` prop will be returned (effectively\n disabling the input).\n\n- `aria-label`: By default the menu will add an `aria-labelledby` that refers to\n the `