* Renders markdown to HTML using remark-html. * @param {string} value a markdown string to render to HTML. * @return {string} an HTML string

Callback for when part of user's address is updated. * adds it to the full address in our internal state and * calls the parent's callback *

* Temporarily creates a <textarea> in the browser and copies its content. * @param {string} copyText the text to copy. * @param {boolean} isPerm

* Updates the component state to reflect which element was clicked. * @param {Pick<EmailState, K>} statePatch an object containing * the state

Shared logic between creating email and letter pages

When user-inputted fields change, update them in our variable map, * and (try) to update the body text If the user has edited the template, t

convert an entry from blackmad's city council api into unifed OfficialAddress structure * * officials sometimes have multiple offices, like in their

convert an entire response from blackmad's city council API to OfficialAddresses * * @param {BlackmadCityCouncilResponse} cityCouncilMembers the API

fetch officials from blackmad's city council API * * @param {BaseOfficialApiParams} input params * @return {Promise<OfficialAddress[]>} addre

fetch officials from google & blackmad APIs based on user address * * @param {FetchOfficialsParams} params input params * @return {Promise<Of

fetch officials from google civic info API * @param {FetchOfficialsParams} input params * @return {Promise<OfficialAddress[]>} addresses of offi

convert one official from google's civic info API to OfficialAddresses * * @param {GoogleCivicRepsResponseOffice} office the office of the official

convert an entire response from google's civic info API to OfficialAddresses * * @param {GoogleCivicRepsResponse} reps the API response to convert

* Groups the array of email metadata passed to it by state * and assigns each state an ID number. * @param {Array<SharedTemplateMetadata>} metadata

Is this offical a city council person * * @param {LevelsAndRoles} official offical to check * @return {boolean} is this offical a city council pers

Generates the text in the checkout button to reflect what the user needs to do to get it enabled * or what the total cost is * * @return {str

Callback for when a user clicks a checkbox on an address so we * can update our list of currently checked addresses * @param {boolean} isChecked

* Redirects the browser to a mailto: link containing the email information

parses out the [SOME VARIABLE] names from template, minus the ones mentioned in SpecialVars * ensure there is a key that a user can enter their email

* Renders each email definition it is passed into an email page link. * @param {Array<SharedTemplateMetadata>} data * An array of objects cont

Renders the overall letter sending form * * @param {LetterFormProps} the component props * @return {ReactElement} the rendered component

* React client-side mount method.

* Create a group containing emails. * @param {string} name the state name. * @param {Array<SharedTemplateMetadata>} templates the state's emails

* Initialize the component and its state. * @param {PageProps<EmailProps>} props

* Initialize the component and its state. * @param {PageProps<EmailProps>} props

* Initialize the component. * @param {FooterProps} props

* Initialize the component and its state. * @param {TemplateListItemProps} props

* Initialize the list component along with its filter options. * @param {TemplateListProps} props

* Initialize the component. * @param {PageProps<SiteProps>} props

* Initialize the component. * @param {PageProps<SiteProps>} props

constructor * @param {string} googleApiKey a google api key with civic info api perms

constructor * @param {string} googleApiKey a google api key with civic info api perms

* Handles changing the component state appropriately before copying * link content.

Handles checkout submit click * * @param {React.SyntheticEvent} event the click even

If the user edits the textarea, mark it dirty and set the new body text * @param {ChangeEvent} event the event generated by use typing into the bod

* Updates component state with the currently selected geographical state. * @param {ReactSelectOption} selectedState * The option object of th

* React render method. * @return {React.ReactNode} the rendered component

* React render method. * @return {React.ReactNode} the rendered component

* React render method. * @return {React.ReactNode} the rendered component

* React render method. * @return {React.ReactNode} the rendered component

* React render method. * @return {React.ReactNode} the rendered component

* React render method. * @return {React.ReactNode} the rendered component

* React render method. * @return {React.ReactNode} the rendered component

* React render method. * @return {React.ReactNode} the rendered component

* React render method. * @return {React.ReactNode} the rendered component

* React render method. * @return {React.ReactNode} the rendered component

* React render method. * @return {React.ReactNode} the rendered component

This is the handler we pass to the user address MyAddressInput sub-component * @param {Address} address the user inputted address