├── .gitignore
├── LICENSE
├── Makefile
├── README.md
├── docs
    ├── accessibility.md
    ├── css-style-guide.md
    ├── js-guide.md
    └── typechecking-faqs.md
├── packages
    ├── convert-to-es-modules
    │   ├── README.md
    │   ├── index.js
    │   ├── package.json
    │   ├── src
    │   │   ├── convert-exports.js
    │   │   ├── convert-imports.js
    │   │   ├── sort-imports.js
    │   │   └── util.js
    │   ├── test
    │   │   ├── convert-exports-test.js
    │   │   ├── convert-imports-test.js
    │   │   └── sort-imports-test.js
    │   └── yarn.lock
    └── eslint-config-hypothesis
    │   ├── .prettierrc
    │   ├── CHANGELOG.md
    │   ├── README.md
    │   ├── base.js
    │   ├── index.js
    │   ├── jsx.js
    │   ├── package.json
    │   ├── react.js
    │   └── ts.js
└── tools
    ├── print-change-list.py
    └── requirements.txt


/.gitignore:
--------------------------------------------------------------------------------
1 | build/
2 | node_modules/
3 | 


--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
 1 | Copyright (c) 2013-2016 Hypothes.is Project and contributors
 2 | 
 3 | Redistribution and use in source and binary forms, with or without
 4 | modification, are permitted provided that the following conditions are met:
 5 | 
 6 | 1. Redistributions of source code must retain the above copyright notice, this
 7 |    list of conditions and the following disclaimer.
 8 | 2. Redistributions in binary form must reproduce the above copyright notice,
 9 |    this list of conditions and the following disclaimer in the documentation
10 |    and/or other materials provided with the distribution.
11 | 
12 | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
13 | ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
14 | WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
15 | DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
16 | ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
17 | (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
18 | LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
19 | ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
20 | (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
21 | SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
22 | 
23 | 
24 | Subcomponents
25 | 
26 | The project includes a number of subcomponents with separate
27 | copyright notices and license terms. Your use of the code for the these
28 | subcomponents is subject to the terms and conditions of the following licenses.
29 | 
30 | For the AngularJS subcomponents:
31 | 
32 |  Copyright (c) 2014-2016 Google, Inc. http://angular.io
33 | 
34 |  Permission is hereby granted, free of charge, to any person obtaining a copy
35 |  of this software and associated documentation files (the "Software"), to deal
36 |  in the Software without restriction, including without limitation the rights
37 |  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
38 |  copies of the Software, and to permit persons to whom the Software is
39 |  furnished to do so, subject to the following conditions:
40 | 
41 |  The above copyright notice and this permission notice shall be included in
42 |  all copies or substantial portions of the Software.
43 | 
44 |  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
45 |  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
46 |  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
47 |  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
48 |  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
49 |  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
50 |  THE SOFTWARE.
51 | 
52 | For the annotator subcomponent:
53 | 
54 |  Copyright 2012 Aron Carroll, Rufus Pollock, and Nick Stenning.
55 | 
56 |  Permission is hereby granted, free of charge, to any person obtaining a copy
57 |  of this software and associated documentation files (the "Software"), to deal
58 |  in the Software without restriction, including without limitation the rights
59 |  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
60 |  copies of the Software, and to permit persons to whom the Software is
61 |  furnished to do so, subject to the following conditions:
62 | 
63 |  The above copyright notice and this permission notice shall be included in
64 |  all copies or substantial portions of the Software.
65 | 
66 |  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
67 |  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
68 |  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
69 |  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
70 |  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
71 |  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
72 |  THE SOFTWARE.
73 | 
74 | For the KaTeX subcomponent:
75 | 
76 |  The MIT License (MIT)
77 | 
78 |  Copyright (c) 2015 Khan Academy
79 | 
80 |  Permission is hereby granted, free of charge, to any person obtaining a copy
81 |  of this software and associated documentation files (the "Software"), to deal
82 |  in the Software without restriction, including without limitation the rights
83 |  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
84 |  copies of the Software, and to permit persons to whom the Software is
85 |  furnished to do so, subject to the following conditions:
86 | 
87 |  The above copyright notice and this permission notice shall be included in all
88 |  copies or substantial portions of the Software.
89 | 
90 |  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
91 |  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
92 |  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
93 |  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
94 |  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
95 |  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
96 |  SOFTWARE.
97 | 


--------------------------------------------------------------------------------
/Makefile:
--------------------------------------------------------------------------------
1 | .PHONY: deps
2 | deps:
3 | 	pip3 install -r tools/requirements.txt
4 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
 1 | Hypothesis Front-end Toolkit
 2 | ============================
 3 | 
 4 | This repository contains shared tools, documentation and resources for
 5 | front-end projects in Hypothesis.
 6 | 
 7 | ## Documentation
 8 | 
 9 | The `docs/` folder contains our style guides and other documentation which is
10 | useful when writing Hypothesis code across different projects.
11 | 
12 | * [JavaScript guide](docs/js-guide.md)
13 | * The [CSS Style Guide](docs/css-style-guide.md)
14 | * Guidelines for [creating accessible web user interfaces](docs/accessibility.md)
15 | 
16 | ## Packages
17 | 
18 | The `packages/` folder contains a set of npm packages that provide resources such
19 | as base config files for front-end tooling, utility scripts etc. that are
20 | useful across multiple Hypothesis projects. These include:
21 | 
22 |  - [**eslint-config-hypothesis**](packages/eslint-config-hypothesis) - A [shareable configuration](http://eslint.org/docs/developer-guide/shareable-configs)
23 |    for ESLint
24 | 
25 | ### Publishing package updates
26 | 
27 | Prerequisites:
28 | 
29 | - Set up an npm account with 2FA enabled, and ask a lead developer to add you to
30 |   the [Hypothesis](https://www.npmjs.com/settings/hypothesis/packages)
31 |   organization in npm
32 | - Ensure that the package you want to publish is associated with the `developers`
33 |   team in this organization
34 | 
35 | To publish a new version of a package:
36 | 
37 | 1. Ensure any changes you want to include have been merged. Then check out the
38 |    `main` branch of the repository and switch to the package's directory.
39 | 2. Add an entry for the new version of the package in the changelog.
40 |    See https://keepachangelog.com/en/1.0.0/ for details of the format that we use.
41 | 3. Run `npm version` with appropriate flags (eg. `npm version minor`) to update
42 |    the package version.
43 | 4. Commit and push the changes from the previous step
44 | 5. Run `npm publish` to publish the new version
45 | 


--------------------------------------------------------------------------------
/docs/accessibility.md:
--------------------------------------------------------------------------------
 1 | Accessibility Guidance
 2 | ======================
 3 | 
 4 | This document provides guidance and links to useful resources and tools for
 5 | creating web-based content & interfaces which are accessible to the widest
 6 | possible range of users.
 7 | 
 8 | It is not intended to be exhaustive but rather to highlight important best
 9 | practices and provide a shared reference which is useful when implementing or
10 | reviewing UI changes.
11 | 
12 | ## Guidelines
13 | 
14 | ### Mobile
15 | 
16 | 1. **Use media queries to adapt layout to display size** - Use `@media` queries
17 |    to adjust the layout depending on screen size to provide more usable
18 |    interfaces on small screens.
19 | 1. **Make interactive controls big enough to tap.** Make sure any UI controls
20 |    that respond to taps are large enough to tap easily with a finger.
21 | 
22 |    * Interactive controls should generally be at least 44x44px in size on
23 |      touch-screen devices.
24 |    * Use `@media (pointer: coarse)` to adjust the size of tap-able items on
25 |      devices with touch screens.
26 | 1. **Use semantic markup.**  Use appropriate semantic HTML elements for
27 |    individual items on a page (headings, links, buttons) as well as regions
28 |    (navigation, main content, header and footer). This enables the user agent to
29 |    provide various affordances such as smarter hit testing.
30 | 1. **Use large font sizes for input fields.** Input fields should use a 16px font or
31 |    larger to make them easily readable and to prevent iOS Safari "zooming in"
32 |    when the field is focused.
33 | 
34 | ### Assistive Technology (eg. Screen Readers)
35 | 
36 | 1. **Use semantic markup.** Use appropriate semantic HTML elements for
37 |    individual items on a page (headings, links, buttons) as well as regions
38 |    (navigation, main content, header and footer). Use of these elements helps
39 |    assistive technology to:
40 | 
41 |    1. Provide helpful descriptions of items.
42 |    1. Identify major landmarks on the page for faster navigation.
43 |    1. Identify important elements of a particular type (forms, links, headings)
44 |       for faster navigation.
45 |    1. Group elements together appropriately for navigation.
46 | 1. **Associate text labels with items.**
47 |    * Ensure that any buttons or links which do not have an explicit text label
48 |      have an accessible label set via the `aria-label` attribute.
49 |    * Ensure that form elements have either a placeholder or associated `<label>`
50 |      element. The label should be associated with its control using the `for`
51 |      attribute.
52 | 1. **Use ARIA roles to clarify meaning and relationships.** Not all of the
53 |    meaning of complex HTML elements and their relationships can be inferred via
54 |    element types and DOM structure. Use the `role` and other ARIA attributes
55 |    where appropriate to clarify this. See the [WAI-ARIA authoring
56 |    practices](https://www.w3.org/TR/wai-aria-practices/) for examples.
57 | 1. **Indicate control states.** Use ARIA attributes such as `aria-expanded` to
58 |    indicate the state of complex controls such as popup menus.
59 | 1. **Support keyboard usage.** It should be possible to navigate to items on a
60 |    page and use them with only a keyboard. See the [WAI-ARIA authoring
61 |    practices](https://www.w3.org/TR/wai-aria-practices/) for a description of
62 |    standard keyboard behaviour of various common controls.
63 | 1. **Test with an actual screen reader.** Following the other advice in this
64 |    section will go a long way towards making content more accessible. However,
65 |    it is important to actually try performing tasks with a screen reader to
66 |    ensure that everything has been labeled appropriately, that items on the page
67 |    are grouped appropriately and that complex controls are usable.
68 |    * **VoiceOver** is built into OS X and iOS.
69 |    * **Orca** ships with most Linux distributions.
70 |    * **[NVDA](https://www.nvaccess.org)** for Windows is free to download.
71 | 
72 | ### Other
73 | 
74 | 1. **Do not rely on color hue to indicate item states.** To avoid problems for
75 |    colorblind users, do not rely on hue as the only indicator of an item's
76 |    state. [Sim Daltonism](https://michelf.ca/projects/sim-daltonism/) is a
77 |    useful tool for simulating color blindness on Mac and iOS.
78 | 
79 | ## References
80 | 
81 | * **[Web Accessibility Initiative ARIA
82 | Overview](https://www.w3.org/WAI/intro/aria.php)**. An introduction to the web
83 | platform standards relevant to making web content more accessible.
84 | * **[WAI-ARIA Authoring Practices](https://www.w3.org/TR/wai-aria-practices/)**.
85 | Detailed guidance on how to make various kinds of common widget accessible. It
86 | describes standard keyboard interactions and use of ARIA attributes for
87 | different types of widget.
88 | * **[AppleVis](https://www.applevis.com/)**. A community site for blind/visually
89 | impaired OS X users. Useful for getting a feel for common problems that visually
90 | impaired users experience and learning how they perform various tasks.
91 | 


--------------------------------------------------------------------------------
/docs/css-style-guide.md:
--------------------------------------------------------------------------------
 1 | # Hypothesis CSS Style Guide
 2 | 
 3 | Hypothesis is transitioning to a utility-first approach for CSS styling, supported by [Tailwind CSS](https://tailwindcss.com/). We use [SASS](https://sass-lang.com/) to build output CSS stylesheets.
 4 | 
 5 | Using Tailwind's utility-first approach obviates the need to spend much time thinking about or documenting how CSS classes should be named or organized, and can prevent us from creating tempting but sometimes confusing or unmaintainable abstractions.
 6 | 
 7 | Our current CSS conventions are:
 8 | 
 9 | - Use a utility-first approach and let it help you shape your components:
10 |   - Use Tailwind utility classes within the source markup for components whenever possible
11 |   - Find yourself repeating classes in a component? It may be a signal to break that component up. Be liberal with the creation of sub-components to avoid repeating yourself (especially within the same component module).
12 | - Use Tailwind configuration to express and define the design system:
13 |   - Each application starts with the [shared Tailwind preset](https://github.com/hypothesis/frontend-shared/blob/main/src/tailwind.preset.js) provided by the `frontend-shared` package
14 |   - Each application may extend that Tailwind preset with local values (e.g. [the client's current configuration](https://github.com/hypothesis/client/blob/master/tailwind.config.mjs))
15 | - Make use of layers:
16 |   - Each CSS (SASS) entrypoint should enable the [Tailwind `base`, `components` and `utilities` layers](https://tailwindcss.com/docs/functions-and-directives#layer) and should structure any partials/imports along the lines of those layers.
17 |   - Using Tailwind layers for now puts us in a prime position to take advantage of native CSS layers.
18 | - Be thoughtful when authoring external CSS:
19 |   - External CSS: it's sometimes necessary! We're not aiming for an airtight system in which there is no external CSS. Use your judgment. On the other hand, check first: can you do it with Tailwind/a utility class instead?
20 |   - Add external CSS to the relevant Tailwind layer, and use the [`@apply` directive](https://tailwindcss.com/docs/functions-and-directives#apply) to inline Tailwind utility classes.
21 |   - Be alert if you find yourself trying to come up with class names or Tailwind configuration property names. Re-consider if there is a Tailwind-y way to avoid naming and abstractions.
22 | - Don't rely too much on SASS' features:
23 |   - Avoid SASS variables, mixins, and functions.
24 |   - Remove unused SASS (variables, mixins, etc.) as you encounter them.
25 | - Respect specificity and the cascade (in external CSS):
26 |   - Most selectors should have a specificity of 0 1 0 (equates to a single classname, e.g.[`.my-selector`](https://polypane.app/css-specificity-calculator/#selector=.my-selector)).
27 |   - Use layers (ordering) to your advantage. Given equal specificity, something in the `utilities` layer should override something in the `components` layer, e.g.
28 |   - Be very wary about selectors with higher specificity
29 |   - Avoid nesting, especially deep nesting, in SASS
30 | - Style with empathy
31 |   - We use [`classnames`](https://www.npmjs.com/package/classnames) in our UI components to split up long lists of utility classes and provide commenting ([example](https://github.com/hypothesis/client/blob/6d50b1b5465c2f1c83d6bb3f673e8266b5396c85/src/annotator/components/AdderToolbar.js))
32 |   - We comment our external CSS carefully and structure it for best comprehensibility ([example](https://github.com/hypothesis/client/blob/master/src/styles/annotator/components/Buckets.scss))
33 | 
34 | ## Transitioning and legacy SASS
35 | 
36 | At time of writing, Hypothesis front-end apps are midway through transitioning a from BEM-convention, heavy-mixin, highly-abstracted SASS structure to Tailwind/utility-first. Existing non-Tailwind SASS should be migrated as time allows.
37 | 
38 | ## Browser Support
39 | 
40 | Hypothesis applications should work within any modern web browser (a version of Chrome, Firefox, Safari, Microsoft Edge, or equivalent released within the last 12 months). Note that as of 1 July 2020, Hypothesis does not support Internet Explorer.
41 | 
42 | ## Further Reading
43 | 
44 | - [Tailwind CSS documentation](https://tailwindcss.com/docs/installation): Tailwind documents it and explains it so we don't have to
45 | - [Trello's CSS Guidelines](https://github.com/trello/trellisheets) . See also the 'Further Reading'
46 |   section at the end of that article
47 | - [Strategies for Keeping CSS specificity low](https://css-tricks.com/strategies-keeping-css-specificity-low) explains the problems with CSS specificity and why most formalized approaches to CSS advocate flat structures
48 | - [CSS Tricks](https://css-tricks.com/css/) has links to blog posts and guides from other projects on the tools and approaches they use to styling web UIs
49 | 


--------------------------------------------------------------------------------
/docs/js-guide.md:
--------------------------------------------------------------------------------
  1 | # JavaScript / TypeScript guide
  2 | 
  3 | This document explains the tools and conventions that we use to maintain
  4 | quality and consistency of our JavaScript and TypeScript code.
  5 | 
  6 | The rationales for various conventions are documented briefly _in italics_.
  7 | Exceptions are noted **in bold**.
  8 | 
  9 | ## Language style guide
 10 | 
 11 | ### Use of newer ES language features
 12 | 
 13 | Projects should generally prefer native ES language features over equivalent
 14 | idioms from earlier versions of the language (eg. classes over constructor functions,
 15 | `import` over `require(...)`).
 16 | 
 17 | _The native features typically enable better tooling._
 18 | 
 19 | Projects may use any ES language features which meet all of the following criteria:
 20 | 
 21 | 1. Supported by the tooling we use (Babel, ESLint)
 22 | 2. Supported natively in the stable release of at least two major browsers.
 23 | 
 24 |    _Waiting for the feature to advance far enough to be natively supported
 25 |    reduces maintenance problems due to using language features which are not
 26 |    widely supported or which are revised significantly during the standardization
 27 |    process._
 28 | 
 29 | 3. Can be transpiled for supported browsers that do not natively support the
 30 |    feature without excessive overhead.
 31 | 
 32 |    _Some language features (generators, as a historical example) are difficult
 33 |    to transpile for older browsers without introducing a lot of code that
 34 |    slows startup and makes debugging difficult._
 35 | 
 36 | As an exception, [JSX](https://reactjs.org/docs/introducing-jsx.html) is used for
 37 | creating UI components.
 38 | 
 39 | ### Module naming
 40 | 
 41 | Modules should use lowercase, hyphen-separated names (`helpful-module.js`).
 42 | 
 43 | **Exception:** Modules whose primary export is a Preact component should use a
 44 | CamelCase name that matches the component name (eg. `ShinyButton.js`). _This is a
 45 | React/Preact ecosystem convention._
 46 | 
 47 | ### Import structure
 48 | 
 49 | Imports should be placed at the top of a module, grouped into sections by their
 50 | relation to the current project:
 51 | 
 52 | 1. Platform (node, browser) imports
 53 | 2. Third-party imports
 54 | 3. Imports from other directories in the current package
 55 | 4. Imports from the same directory in the current package
 56 | 
 57 | Within each group import lines should be sorted alphabetically by module path.
 58 | 
 59 | ```js
 60 | import { readFile } from 'fs';
 61 | 
 62 | import { render } from 'markdown';
 63 | 
 64 | import { fetchData } from './data-source';
 65 | import { formatDate } from './utils/date';
 66 | ```
 67 | 
 68 | ### Default exports
 69 | 
 70 | Avoid default exports. Use named exports instead.
 71 | 
 72 | _Using named exports helps with grep-ability as it encourages the
 73 | symbol to have the same name everywhere it is used. Automated refactoring tools
 74 | are more likely to update all references to a symbol when renaming it._
 75 | 
 76 | **Exception:** Modules whose primary export is a single Preact component should
 77 | default-export that component. _This is a React/Preact ecosystem convention._
 78 | 
 79 | ### Variable declarations
 80 | 
 81 | Variables should be declared with `const` where possible, or `let` if not.
 82 | 
 83 | _Use of `const` makes it clear that a variable is only assigned in one place._
 84 | 
 85 | ### Identifier naming
 86 | 
 87 | Variables, functions (except for Preact components) and object properties should
 88 | use camelCase naming. Acronyms should be lower-case if they are the first "word"
 89 | of an identifier or upper-case otherwise. Classes and Preact components should
 90 | use PascalCase naming.
 91 | 
 92 | _These conventions match web platform APIs and the Preact/React ecosystem_.
 93 | 
 94 | Correct examples:
 95 | 
 96 | ```js
 97 | const pdfTitle = ...;
 98 | 
 99 | function getPDFTitle() {
100 |    ...
101 | }
102 | 
103 | class PDFIntegration { ... };
104 | ```
105 | 
106 | **Exception:** Objects containing deserialized API response bodies or serializable API request bodies may
107 | use non-camel-case identifier names.
108 | 
109 | #### Ref naming
110 | 
111 | Preact does not allow the `ref` prop to be accessed by on non-HTML components. Instead it
112 | offers a wrapper method called [forwardRef](https://preactjs.com/guide/v10/switching-to-preact/#forwardref)
113 | to extract the ref for you. Unfortunately the wrapper method is included with `preact/compat` which
114 | is a library we currently don't import nor want to because of a number of global side effects. For
115 | this reason, we simply use a custom property with a "Ref" suffix and pass the ref object to
116 | that property. For example, `buttonRef`, `panelRef` or `fooBarRef` would all be valid names.
117 | It is then up to the component to pull out the ref passed to that prop and attach it to the
118 | underlying `HTMLElement`.
119 | 
120 | e.g.
121 | 
122 | ```tsx
123 | export type FooBarProps = {
124 |   fooBarRef: Ref<HTMLInputElement>;
125 | };
126 | 
127 | export default function FooBar({
128 |   fooBarRef
129 | }: FooBarProps) {
130 |    return (
131 |       <input type="text" ref={fooBarRef}/>
132 |    )
133 | }
134 | ```
135 | 
136 | ## Formatting code
137 | 
138 | All of our projects use [Prettier](https://prettier.io) to format JavaScript code,
139 | with the following `.prettierrc` configuration:
140 | 
141 | ```json
142 | {
143 |   "arrowParens": "avoid",
144 |   "singleQuote": true
145 | }
146 | ```
147 | 
148 | All other config options are set to the Prettier defaults.
149 | 
150 | ## Lint setup
151 | 
152 | Our projects use [ESLint](https://eslint.org) to:
153 | 
154 | - Catch common JavaScript coding errors
155 | - Detect HTML usage errors in Preact components
156 | - Identify potential accessibility errors in Preact components
157 | - Ensure correct usage of the "hooks" APIs in Preact components
158 | - Encourage stylistic consistency across projects (although many basic aspects
159 |   of code style are handled by Prettier)
160 | 
161 | Projects should use the `eslint-config-hypothesis` package from this repository
162 | as a base configuration, with any additional project-specific configuration added
163 | on top.
164 | 
165 | [Lint suppressions](https://eslint.org/docs/2.13.1/user-guide/configuring#disabling-rules-with-inline-comments)
166 | may be used where there are reasonable reasons to ignore a particular lint warning.
167 | Try to scope any suppressions to the narrowest scope possible and add a comment
168 | to explain any that may be non-obvious to another developer reading the code
169 | in future.
170 | 
171 | ## Documenting and type-checking code
172 | 
173 | ### JSDoc
174 | 
175 | It is recommended to use [JSDoc](https://jsdoc.app) to document function
176 | parameters and object properties.
177 | 
178 | Hypothesis uses the variant of JSDoc understood by the TypeScript compiler.
179 | See [the reference](https://www.typescriptlang.org/docs/handbook/type-checking-javascript-files.html)
180 | in the TypeScript handbook for guidance on supported JSDoc syntax as well as
181 | details on how to specify various types correctly.
182 | 
183 | ### Typechecking
184 | 
185 | Production code which runs in the browser should be written in TypeScript. Tooling which runs
186 | directly in Node can be written in JavaScript. JS scripts may have type annotations in the form
187 | of JSDoc comments.
188 | 
189 | Unit and integration tests are generally written in JS and not type-checked.
190 | This is because our tests often create mocks/fakes which take liberties when implementing the type
191 | they stand in for (eg. only implementing the used subset of an API). As a consequence any type
192 | checking would have to be relaxed (eg. using `any` frequently).
193 | 
194 | See the [Typechecking FAQs](typechecking-faqs.md) page for recommendations on JSDoc / TypeScript usage in projects.
195 | 
196 | ## Testing
197 | 
198 | Hypothesis makes use of extensive unit testing to help prevent regressions.
199 | Our standard test setup is to use [Mocha](https://mochajs.org) and
200 | [Chai](https://www.chaijs.com) together with [Karma](http://karma-runner.github.io/latest/index.html).
201 | We also use [Istanbul](https://istanbul.js.org) for generating code coverage reports.
202 | 
203 | Many unit tests make use of the [mockable-imports](https://github.com/robertknight/babel-plugin-mockable-imports)
204 | Babel plugin to enable mocking dependencies of the code being tested in order
205 | to isolate the unit test from implementation details of the dependency.
206 | 
207 | ## Creating UI components
208 | 
209 | Interactive UI components are created using [Preact](https://preactjs.com), a
210 | lightweight implementation of the [React](https://reactjs.org) APIs.
211 | 
212 | If you are unfamiliar with React or Preact, reading the [React tutorial](https://reactjs.org/docs/hello-world.html)
213 | is recommended to familiarize yourself with the concepts and best practices.
214 | Even though we use Preact, we frequently refer to the React documentation
215 | for guidance on conceptual issues.
216 | 
217 | React/Preact provide several two main APIs for authoring components: function
218 | and class-based. Hypothesis uses [function components](https://reactjs.org/docs/components-and-props.html)
219 | together with the ["hooks" API](https://reactjs.org/docs/hooks-intro.html)
220 | for managing internal state and effects.
221 | 
222 | ### Testing components
223 | 
224 | For Preact UI component tests, we use [Enzyme](https://enzymejs.github.io/enzyme/)
225 | in the "Full DOM Rendering" mode. The "Shallow rendering" mode is avoided
226 | and instead components imported by the component being tested are mocked using
227 | the same `mockable-imports` Babel plugin that is used to mock imports in other code.
228 | 
229 | _See [this blog post](https://robertknight.me.uk/posts/shallow-rendering-revisited/)
230 | for the rationale for avoiding shallow rendering but continuing to mock child
231 | components using a different method. The [Testing Overview](https://reactjs.org/docs/testing.html)
232 | section of the React docs also has useful general guidance._
233 | 


--------------------------------------------------------------------------------
/docs/typechecking-faqs.md:
--------------------------------------------------------------------------------
 1 | # Typechecking FAQs
 2 | 
 3 | This is a collection of answers to some common questions that have arisen when using TypeScript in our projects,
 4 | especially from developers who are new to the language.
 5 | 
 6 | ## Where is the canonical reference for how to specify types/write TypeScript and JSDoc?
 7 | 
 8 | See the [TypeScript Handbook](https://www.typescriptlang.org/docs/handbook/basic-types.html).
 9 | 
10 | For code that is authored in JS and annotated using JSDoc comments, see [the JSDoc page](https://www.typescriptlang.org/docs/handbook/jsdoc-supported-types.html) and [checking JavaScript files page](https://www.typescriptlang.org/docs/handbook/type-checking-javascript-files.html).
11 | 
12 | ## How do I tell TS to ignore a line of code?
13 | 
14 | Put `@ts-ignore` in a comment to ignore the next line.
15 | 
16 | ## What are the conventions for specifying prop types for Preact components?
17 | 
18 | Props are described using TypeScript and documented using JSDoc, like so:
19 | 
20 | ```tsx
21 | export type MyButtonProps = {
22 |   /** Text label for the button. */
23 |   label: string;
24 | };
25 | 
26 | export default function MyButton({ label }: MyButtonProps) {
27 |   // Content here
28 | }
29 | ```
30 | 
31 | For small helper components which are not exported from a module, you can, optionally, use a more succinct "inline" syntax:
32 | 
33 | ```tsx
34 | function MyButton({ label }: { label: string }) {
35 | }
36 | ```
37 | 
38 | ## How do I set a CSS property or HTML attribute that is a boolean or number rather than a string?
39 | 
40 | Given code like this:
41 | 
42 | ```js
43 | someElement.setAttribute('attr', 42)
44 | ```
45 | 
46 | TS will complain that attribute values must be strings, although the code would actually work as the value would be coerced
47 | at runtime. To keep TS happy, convert the value explicitly:
48 | 
49 | ```js
50 | someElement.setAttribute('attr', myNumber.toString())
51 | ```
52 | 
53 | ## How do I tell TS that a variable is not null/undefined?
54 | 
55 | Sometimes will warn that a value might be null or undefined in a certain context and that this case is not handled.
56 | 
57 | First, have a think about whether TS is right. If so, add a check for this.
58 | 
59 | Sometimes you may know that a value cannot be null for reasons that may not be obvious from a glance at the code. In this case you can use the `!` operator
60 | or a `value as T` type cast.
61 | 
62 | For example, supposing you have an HTMLElement and you try to access its `parentElement`. In general, that property can be null if the element has no parent. You might know that this cannot be the case in a certain situation though:
63 | 
64 | ```ts
65 | const parentEl = someElement.parentElement!;
66 | ```
67 | 


--------------------------------------------------------------------------------
/packages/convert-to-es-modules/README.md:
--------------------------------------------------------------------------------
  1 | # convert-to-es-modules
  2 | 
  3 | A script to assist with conversion of Hypothesis projects from
  4 | CommonJS to ES module syntax. It is built on [recast](https://github.com/benjamn/recast)
  5 | and Babel.
  6 | 
  7 | The script makes some assumptions about the content of the projects which are
  8 | true for the projects we need to use it with.
  9 | 
 10 | A notable feature of this script compared to alternatives is that it tries to
 11 | be intelligent about deciding whether to convert a CommonJS require (`var foo = require("foo")`)
 12 | to a namespace import (`import * as foo from "foo"`) or a default import
 13 | (`import foo from "foo"`). The script examines the contents of the target module,
 14 | which is assumed to be a CommonJS/Node module, and looks for assignments to
 15 | `module.exports` or `exports`. If it finds an assignment to an object literal
 16 | (`module.exports = { … }`) it assumes that the module does not have a default
 17 | export and therefore it uses a namespace import. If it finds an assignment to
 18 | anything else (eg. a function, an identifier) it assumes that the module has
 19 | a default export.
 20 | 
 21 | ## Usage
 22 | 
 23 | To convert all JavaScript files in the `src` directory of a project from
 24 | CommonJS to ES modules:
 25 | 
 26 | ```sh
 27 | $ yarn install
 28 | $ cd path/to/your/project
 29 | 
 30 | # nb. `/path/to/frontend-toolkit` refers to the absolute path where you have
 31 | # cloned this repository.
 32 | 
 33 | $ node /path/to/frontend-toolkit/convert-to-es-modules/index.js -i -e 'src/**/*.js'
 34 | ```
 35 | 
 36 | The `-i` flag enables conversion of imports. The `-e` flag enables conversion
 37 | of exports.
 38 | 
 39 | ## Options
 40 | 
 41 | The script accepts several options. Use the `--help` argument for details.
 42 | 
 43 | ## Configuration
 44 | 
 45 | The tool accepts extended configuration in a JSON file specified via the
 46 | `--config` argument:
 47 | 
 48 | ```
 49 | $ node convert-to-es-modules/index.js --config config.json 'src/**/*.js'
 50 | ```
 51 | 
 52 | The following configuration options are available:
 53 | 
 54 | **hasDefaultExport**
 55 | 
 56 | Override the tool's detection of whether a module has a default export or not:
 57 | 
 58 | ```
 59 | {
 60 |   "hasDefaultExport": {
 61 |     "katex": false
 62 |   }
 63 | }
 64 | ```
 65 | 
 66 | This option is useful if the tool's simple heuristics do not correctly detect
 67 | whether an npm package should be treated as having a default export or not.
 68 | 
 69 | ## Limitations
 70 | 
 71 | There are several limitations / scenarios which this script will not handle
 72 | automatically. The recommended approach to using it is to refactor occurrences
 73 | of these patterns before running this script, although you can also fix them up
 74 | afterwards:
 75 | 
 76 | - Only `var … = require` statements at the top level of a module are converted
 77 |   to imports. This is because `import` statements must occur at the top level
 78 |   of a file (ie. outside of any conditionals, loops or functions).
 79 | - Detection of whether to use namespace imports (`import * as foo from "foo"`)
 80 |   vs default imports (`import foo from "foo"`) is based on heuristics about
 81 |   what the imported module assigns to `module.exports` (if it is a CommonJS
 82 |   module) or whether it has an `export default` declaration (if it is an ES
 83 |   module). The heuristic is to assume that `module.exports` assignments where
 84 |   the right-hand side is an object literal with only identifiers as values
 85 |   (eg. `module.exports = { foo, bar: baz }`) should be converted to namespace
 86 |   imports. Anything else results in a default export. This heuristic may not
 87 |   always be correct.
 88 | - CommonJS modules which logically have both a default export (eg. a function)
 89 |   and named exports (eg. auxilliary functions) are implemented by assigning
 90 |   properties to the object which is the default export. When converting to ES
 91 |   modules the idiomatic approach would be to have a default export and separate
 92 |   named exports. This script cannot make this change automatically.
 93 | 
 94 | ## References
 95 | 
 96 | For information on parsing and transforming code with Babel, see the
 97 | [Babel Handbook](https://github.com/jamiebuilds/babel-handbook/blob/master/translations/en/README.md).
 98 | 
 99 | To see the parsed structures of various code, see [AST Explorer](https://astexplorer.net).
100 | 
101 | For information about Recast, which enables preserving unmodified parts of the code,
102 | see the [Recast repo](https://github.com/benjamn/recast).
103 | 


--------------------------------------------------------------------------------
/packages/convert-to-es-modules/index.js:
--------------------------------------------------------------------------------
  1 | "use strict";
  2 | 
  3 | const fs = require("fs");
  4 | const path = require("path");
  5 | 
  6 | const glob = require("glob");
  7 | const resolve = require("resolve");
  8 | 
  9 | const {
 10 |   convertCommonJSImports,
 11 |   processCommonJSImports
 12 | } = require("./src/convert-imports");
 13 | const {
 14 |   convertCommonJSExports,
 15 |   detectDefaultExport
 16 | } = require("./src/convert-exports");
 17 | 
 18 | /**
 19 |  * Return JavaScript source for a module.
 20 |  *
 21 |  * This just reads the module if it is already JavaScript or compiles it to JavaScript
 22 |  * otherwise.
 23 |  */
 24 | function getJavaScriptSource(modulePath, transpilers = {}) {
 25 |   let code = fs.readFileSync(modulePath).toString();
 26 |   if (!modulePath.endsWith(".js")) {
 27 |     const ext = path.extname(modulePath);
 28 |     if (transpilers[ext]) {
 29 |       return transpilers[ext](code);
 30 |     } else {
 31 |       throw new Error(`Unable to compile ${modulePath} to JavaScript`);
 32 |     }
 33 |   }
 34 |   return code;
 35 | }
 36 | 
 37 | let srcGlob;
 38 | 
 39 | const program = require("commander");
 40 | program
 41 |   .option("-c, --config <path>", "Path to JSON configuration file")
 42 |   .option("--log", "Write transformed code to stdout instead of modifying file")
 43 |   .option("-i, --convert-imports")
 44 |   .option("-e, --convert-exports")
 45 |   .arguments("<paths>")
 46 |   .action(paths => {
 47 |     srcGlob = paths;
 48 |   });
 49 | 
 50 | program.parse(process.argv);
 51 | 
 52 | let config = {};
 53 | if (program.config) {
 54 |   config = JSON.parse(fs.readFileSync(program.config));
 55 | }
 56 | 
 57 | const srcPaths = glob.sync(srcGlob);
 58 | const transpilers = {
 59 |   ".coffee": code => require("coffee-script").compile(code)
 60 | };
 61 | 
 62 | // Step 1: Find all the modules `require`-d by the modules we are going to convert.
 63 | console.log(`Finding direct dependencies of files matching "${srcGlob}"...`);
 64 | 
 65 | let modulePaths = srcPaths.flatMap(srcPath => {
 66 |   const requiredPaths = [];
 67 |   const code = fs.readFileSync(srcPath).toString();
 68 |   processCommonJSImports(code, srcPath, (path, requirePath, requireAbsPath) => {
 69 |     requiredPaths.push(requireAbsPath);
 70 |   });
 71 |   return requiredPaths;
 72 | });
 73 | modulePaths = Array.from(new Set(modulePaths)); // Remove duplicates.
 74 | 
 75 | // Step 2: Analyze the exports of each module that is `require`-d to determine
 76 | // whether it has a default export. We need this information to know whether
 77 | // a statement such as `var foo = require('foo')` should be converted to
 78 | // `import foo from 'foo'` or `import * as foo from 'foo'`.
 79 | console.log("Analyzing module exports...");
 80 | let hasDefaultExport = {};
 81 | modulePaths.forEach(absPath => {
 82 |   try {
 83 |     if (absPath.endsWith(".js") || path.extname(absPath) in transpilers) {
 84 |       // If this module is JavaScript or something that this script can convert
 85 |       // to JavaScript then process it to determine whether it has a default export.
 86 |       const code = getJavaScriptSource(absPath, transpilers);
 87 |       hasDefaultExport[absPath] = detectDefaultExport(code);
 88 |     } else {
 89 |       // For other file types supported by custom loaders, make a default assumption
 90 |       // that they do have a default export as that is the most typical case.
 91 |       hasDefaultExport[absPath] = true;
 92 |     }
 93 |   } catch (err) {
 94 |     console.error(`Could not process ${absPath}`, err);
 95 |   }
 96 | });
 97 | 
 98 | // Apply overrides for modules where the type of default export is not correctly
 99 | // determined automatically by the logic above.
100 | const hasDefaultExportOverrides = {};
101 | Object.assign(hasDefaultExportOverrides, config.hasDefaultExport);
102 | 
103 | Object.keys(hasDefaultExportOverrides).forEach(dependency => {
104 |   const absPath = resolve.sync(dependency, {
105 |     basedir: process.cwd()
106 |   });
107 |   hasDefaultExport[absPath] = hasDefaultExportOverrides[dependency];
108 | });
109 | 
110 | // Step 3. Re-process each module and convert top-level CommonJS requires to
111 | // imports.
112 | console.log("Converting CommonJS imports to `import ... from ...` syntax...");
113 | srcPaths.forEach(path => {
114 |   let code = fs.readFileSync(path).toString();
115 | 
116 |   if (program.convertImports) {
117 |     code = convertCommonJSImports(code, path, hasDefaultExport);
118 |   }
119 | 
120 |   if (program.convertExports) {
121 |     code = convertCommonJSExports(code);
122 |   }
123 | 
124 |   if (program.log) {
125 |     console.log(code);
126 |   } else {
127 |     fs.writeFileSync(path, code);
128 |   }
129 | });
130 | 


--------------------------------------------------------------------------------
/packages/convert-to-es-modules/package.json:
--------------------------------------------------------------------------------
 1 | {
 2 |   "name": "convert-to-es-modules",
 3 |   "version": "1.0.0",
 4 |   "description": "Convert CommonJS to ES module syntax",
 5 |   "main": "index.js",
 6 |   "repository": "https://github.com/hypothesis/frontend-toolkit",
 7 |   "author": "Robert Knight <robertknight@hypothes.is>",
 8 |   "license": "BSD-2-Clause",
 9 |   "private": true,
10 |   "dependencies": {
11 |     "@babel/core": "^7.7.7",
12 |     "coffee-script": "^1.12.7",
13 |     "commander": "^4.1.0",
14 |     "glob": "^7.1.6",
15 |     "recast": "^0.18.5",
16 |     "resolve": "^1.14.2"
17 |   },
18 |   "scripts": {
19 |     "format": "prettier --write **/*.js",
20 |     "test": "mocha"
21 |   },
22 |   "devDependencies": {
23 |     "chai": "^4.2.0",
24 |     "mocha": "^7.0.0",
25 |     "prettier": "1.19.1"
26 |   }
27 | }
28 | 


--------------------------------------------------------------------------------
/packages/convert-to-es-modules/src/convert-exports.js:
--------------------------------------------------------------------------------
  1 | "use strict";
  2 | 
  3 | const { parse, printAST, traverse, types } = require("./util");
  4 | 
  5 | /**
  6 |  * Move the comments from before one source AST node to a destination AST node.
  7 |  */
  8 | function transferComments(fromNode, toNode) {
  9 |   const comments = fromNode.leadingComments || [];
 10 |   fromNode.leadingComments = [];
 11 |   fromNode.comments = [];
 12 |   toNode.comments = [...comments];
 13 | }
 14 | 
 15 | /**
 16 |  * Test whether an object literal is a "simple" mapping of names to identifiers.
 17 |  *
 18 |  * When such expressions appear in a `module.exports` assignment they can be
 19 |  * converted to an export list (`export { foo, bar as baz, ... }`).
 20 |  */
 21 | function areValuesAllIdentifiers(objectExpressionNode) {
 22 |   return objectExpressionNode.properties.every(node =>
 23 |     types.isIdentifier(node.value)
 24 |   );
 25 | }
 26 | 
 27 | /**
 28 |  * Find all the CommonJS/Node `module.exports` assignments in a source file and invoke
 29 |  * `callback` with the Babel AST path.
 30 |  *
 31 |  * @param {string|AST} code - Source code of module as either source code or a parsed AST
 32 |  * @param {Function} callback - Callback invoked with Babel AST path object
 33 |  */
 34 | function processCommonJSExports(code, callback) {
 35 |   const ast = typeof code === "string" ? parse(code) : code;
 36 | 
 37 |   traverse(ast, {
 38 |     AssignmentExpression(path) {
 39 |       const target = path.node.left;
 40 | 
 41 |       // module.exports = ...
 42 |       const isModuleExportsAssignment =
 43 |         target.type === "MemberExpression" &&
 44 |         target.object.name === "module" &&
 45 |         target.property.name === "exports";
 46 | 
 47 |       // exports = ...
 48 |       const isExportsAssignment =
 49 |         target.type === "Identifier" && target.name === "exports";
 50 | 
 51 |       if (!isModuleExportsAssignment && !isExportsAssignment) {
 52 |         return;
 53 |       }
 54 | 
 55 |       callback(path);
 56 |     }
 57 |   });
 58 | 
 59 |   return ast;
 60 | }
 61 | 
 62 | /**
 63 |  * Convert CommonJS exports assignments (`module.exports = ...`, `exports = ...`)
 64 |  * into ES module export declarations.
 65 |  *
 66 |  * @param {string} code
 67 |  * @return {string} The converted code
 68 |  */
 69 | function convertCommonJSExports(code) {
 70 |   const ast = processCommonJSExports(code, path => {
 71 |     let exportDecl;
 72 | 
 73 |     // Convert `module.exports = { name1, name2, name3: localName, ... }` exports
 74 |     // to named exports.
 75 |     if (
 76 |       types.isObjectExpression(path.node.right) &&
 77 |       areValuesAllIdentifiers(path.node.right)
 78 |     ) {
 79 |       const objNode = path.node.right;
 80 | 
 81 |       // List of `[exportName, localName]` tuples of exports where we can't
 82 |       // just add an `export` keyword in front of the original declaration for
 83 |       // the exported variable/function.
 84 |       const exports = [];
 85 | 
 86 |       // For simple exports of functions and variables which don't change the
 87 |       // name, add an `export` specifier directly before the original declaration.
 88 |       objNode.properties.forEach(propNode => {
 89 |         let handled = false;
 90 | 
 91 |         const localName = propNode.value.name;
 92 |         if (propNode.key.name === localName) {
 93 |           const exportBinding = path.scope.bindings[localName];
 94 |           const localPath = exportBinding.path;
 95 | 
 96 |           // Check that the binding refers to something that we can put `export`
 97 |           // in front of.
 98 |           if (
 99 |             types.isFunctionDeclaration(localPath) ||
100 |             types.isClassDeclaration(localPath)
101 |           ) {
102 |             handled = true;
103 |             const exportDecl = types.exportNamedDeclaration(localPath.node, []);
104 | 
105 |             // Move any comments above the function/class declaration so that
106 |             // they appear above the export declaration instead of between
107 |             // the `export` keyword and the function/class declaration.
108 |             transferComments(localPath.node, exportDecl);
109 | 
110 |             localPath.replaceWith(exportDecl);
111 |           }
112 |         }
113 | 
114 |         if (!handled) {
115 |           exports.push([propNode.key.name, localName]);
116 |         }
117 |       });
118 | 
119 |       // For other exports, create an `export { ... }` list where the original
120 |       // `module.exports` assignment was.
121 |       if (exports.length > 0) {
122 |         const exportSpecifiers = exports.map(([name, localName]) =>
123 |           types.exportSpecifier(
124 |             types.identifier(localName),
125 |             types.identifier(name)
126 |           )
127 |         );
128 |         exportDecl = types.exportNamedDeclaration(null, exportSpecifiers);
129 |       }
130 |     } else {
131 |       // Convert other kinds of exports to default exports.
132 | 
133 |       const exportExpr = path.node.right;
134 |       let handled = false;
135 | 
136 |       // When `module.exports = <local function or class identifier>` is encountered,
137 |       // put `export default` in front of the original declaration.
138 |       if (types.isIdentifier(exportExpr)) {
139 |         const exportBinding = path.scope.bindings[exportExpr.name];
140 |         if (
141 |           types.isFunctionDeclaration(exportBinding.path.node) ||
142 |           types.isClassDeclaration(exportBinding.path.node)
143 |         ) {
144 |           handled = true;
145 |           const exportDecl = types.exportDefaultDeclaration(
146 |             exportBinding.path.node
147 |           );
148 | 
149 |           // Move any comments above the function/class declaration so that
150 |           // they appear above the export declaration instead of between
151 |           // the `export` keyword and the function/class declaration.
152 |           transferComments(exportBinding.path.node, exportDecl);
153 | 
154 |           exportBinding.path.replaceWith(exportDecl);
155 |         }
156 |       }
157 | 
158 |       // For other cases replace `module.exports = <expression>` with
159 |       // `export default <expression>`.
160 |       if (!handled) {
161 |         exportDecl = types.exportDefaultDeclaration(exportExpr);
162 |       }
163 |     }
164 | 
165 |     if (exportDecl) {
166 |       // Replace parent ExpressionStatement with export declaration.
167 |       const leadingComments = path.node.leadingComments || [];
168 |       exportDecl.comments = [...leadingComments];
169 |       path.parentPath.replaceWith(exportDecl);
170 |     } else {
171 |       // All of the exports were processed by adding an `export` keyword in
172 |       // front of the original declaration. Therefore we can just remove the
173 |       // `module.exports = ...` assignment.
174 |       path.parentPath.remove();
175 |     }
176 |   });
177 | 
178 |   return printAST(ast);
179 | }
180 | 
181 | /**
182 |  * Analyze the exports of a CommonJS or ES module and return `true` if the module
183 |  * should be considered to have a "default" export.
184 |  */
185 | function detectDefaultExport(code) {
186 |   let hasDefaultExport = false;
187 | 
188 |   const ast = parse(code);
189 | 
190 |   processCommonJSExports(ast, path => {
191 |     hasDefaultExport =
192 |       !types.isObjectExpression(path.node.right) ||
193 |       !areValuesAllIdentifiers(path.node.right);
194 |   });
195 | 
196 |   // Find ES default exports.
197 |   traverse(ast, {
198 |     ExportDefaultDeclaration(path) {
199 |       hasDefaultExport = true;
200 |     }
201 |   });
202 | 
203 |   return hasDefaultExport;
204 | }
205 | 
206 | module.exports = { convertCommonJSExports, detectDefaultExport };
207 | 


--------------------------------------------------------------------------------
/packages/convert-to-es-modules/src/convert-imports.js:
--------------------------------------------------------------------------------
  1 | "use strict";
  2 | 
  3 | const path = require("path");
  4 | 
  5 | const resolve = require("resolve");
  6 | 
  7 | const { parse, printAST, traverse, types } = require("./util");
  8 | const { groupImportsInFile } = require("./sort-imports");
  9 | 
 10 | /**
 11 |  * Return the absolute path of a dependency `require`'d by `modulePath`
 12 |  *
 13 |  * @param {string} modulePath - Absolute path to calling module
 14 |  * @param {string} dependency - Path of the dependency, as specified by code in `modulePath`
 15 |  * @return {string} Absolute path to the dependency
 16 |  */
 17 | function absoluteDependencyPath(modulePath, dependency) {
 18 |   if (typeof modulePath !== "string") {
 19 |     throw new Error("Module path is not a string");
 20 |   }
 21 |   if (typeof dependency !== "string") {
 22 |     throw new Error("Dependency path is not a string");
 23 |   }
 24 | 
 25 |   return resolve.sync(dependency, {
 26 |     basedir: path.dirname(modulePath),
 27 |     extensions: [".js", ".coffee"]
 28 |   });
 29 | }
 30 | 
 31 | /**
 32 |  * Find all the CommonJS/Node `require` calls in a source file and invoke
 33 |  * `callback` with `(path, dependencyPath, absoluteDependencyPath)` where
 34 |  * `path` is a Babel AST path.
 35 |  */
 36 | function processCommonJSImports(code, modulePath, callback) {
 37 |   const ast = parse(code);
 38 |   traverse(ast, {
 39 |     CallExpression(path) {
 40 |       // Check that this is a `require` call with a single string literal arg.
 41 |       const isRequireCall =
 42 |         types.isIdentifier(path.node.callee) &&
 43 |         path.node.callee.name === "require";
 44 | 
 45 |       if (!isRequireCall) {
 46 |         return;
 47 |       }
 48 | 
 49 |       if (
 50 |         path.node.arguments.length !== 1 ||
 51 |         !types.isStringLiteral(path.node.arguments[0])
 52 |       ) {
 53 |         return;
 54 |       }
 55 | 
 56 |       const dependencyPath = path.node.arguments[0].value;
 57 |       const absPath = absoluteDependencyPath(modulePath, dependencyPath);
 58 | 
 59 |       callback(path, dependencyPath, absPath);
 60 |     }
 61 |   });
 62 | 
 63 |   return ast;
 64 | }
 65 | 
 66 | /**
 67 |  * Convert CommonJS/Node `require` statements to ES `import` syntax.
 68 |  *
 69 |  * @param {string} code - Module source
 70 |  * @param {string} modulePath - Absolute path to the JS module to convert.
 71 |  * @param {Object} hasDefaultExport - A map of absolute paths to dependencies to
 72 |  *   booleans indicating whether the module has a default export or not.
 73 |  */
 74 | function convertCommonJSImports(code, modulePath, hasDefaultExport) {
 75 |   const getImportCategory = dependency =>
 76 |     dependency.startsWith(".") ? "local" : "npm";
 77 | 
 78 |   const ast = processCommonJSImports(
 79 |     code,
 80 |     modulePath,
 81 |     (path, requirePath, requireAbsPath) => {
 82 |       let esImportDecl;
 83 |       let cjsRequireStatement;
 84 | 
 85 |       if (
 86 |         types.isVariableDeclarator(path.parent) &&
 87 |         types.isVariableDeclaration(path.parentPath.parent) &&
 88 |         types.isProgram(path.parentPath.parentPath.parent)
 89 |       ) {
 90 |         // Top level `var ... = require('<path>');` statement.
 91 | 
 92 |         if (types.isIdentifier(path.parent.id)) {
 93 |           // var foo = require('foo');
 94 |           let specifier;
 95 |           if (hasDefaultExport[requireAbsPath]) {
 96 |             specifier = types.importDefaultSpecifier(
 97 |               types.identifier(path.parent.id.name)
 98 |             );
 99 |           } else {
100 |             specifier = types.importNamespaceSpecifier(
101 |               types.identifier(path.parent.id.name)
102 |             );
103 |           }
104 | 
105 |           esImportDecl = types.importDeclaration(
106 |             [specifier],
107 |             types.stringLiteral(requirePath)
108 |           );
109 | 
110 |           // Replace the grandparent `var ... = ...` statement with an `import`
111 |           // statement.
112 |           cjsRequireStatement = path.parentPath.parentPath;
113 |         } else if (types.isObjectPattern(path.parent.id)) {
114 |           // var { foo } = require('foo');
115 |           const specifiers = [];
116 |           path.parent.id.properties.forEach(pattern => {
117 |             if (!types.isIdentifier(pattern.key)) {
118 |               throw new Error(
119 |                 `Unsupported object pattern syntax for "${requirePath}" require`
120 |               );
121 |             }
122 |             if (!types.isIdentifier(pattern.value)) {
123 |               throw new Error(
124 |                 `Unsupported object pattern syntax for "${requirePath}" require`
125 |               );
126 |             }
127 | 
128 |             const exportName = pattern.key.name;
129 |             const alias = pattern.value.name;
130 | 
131 |             if (exportName === "default") {
132 |               specifiers.push(
133 |                 types.importDefaultSpecifier(types.identifier(alias))
134 |               );
135 |             } else {
136 |               specifiers.push(
137 |                 types.importSpecifier(
138 |                   types.identifier(alias),
139 |                   types.identifier(exportName)
140 |                 )
141 |               );
142 |             }
143 |           });
144 | 
145 |           esImportDecl = types.importDeclaration(
146 |             specifiers,
147 |             types.stringLiteral(requirePath)
148 |           );
149 | 
150 |           // Replace the grandparent `var ... = ...` statement with an `import`
151 |           // statement.
152 |           cjsRequireStatement = path.parentPath.parentPath;
153 |         } else {
154 |           throw new Error(`Unable to handle require for "${requirePath}"`);
155 |         }
156 |       } else if (
157 |         types.isExpressionStatement(path.parent) &&
158 |         types.isProgram(path.parentPath.parent)
159 |       ) {
160 |         // Top-level `require('foo');` statement.
161 |         esImportDecl = types.importDeclaration(
162 |           [],
163 |           types.stringLiteral(requirePath)
164 |         );
165 | 
166 |         // Replace the containing statement with an import declaration.
167 |         cjsRequireStatement = path.parentPath;
168 |       }
169 | 
170 |       let importCategory = getImportCategory(requirePath);
171 | 
172 |       if (esImportDecl && cjsRequireStatement) {
173 |         // Copy any comments from above the `require` statement to above the new
174 |         // `import` declaration.
175 |         const leadingComments = cjsRequireStatement.node.leadingComments || [];
176 |         esImportDecl.comments = [...leadingComments];
177 | 
178 |         cjsRequireStatement.replaceWith(esImportDecl);
179 |       }
180 |     }
181 |   );
182 | 
183 |   let output = printAST(ast);
184 | 
185 |   // Filter out "use strict" directives as modules are always strict.
186 |   // We use a regex rather than AST traversal here because the parser ignores
187 |   // these directives when parsing the source as a module and does not include them
188 |   // in the AST.
189 |   const useStrictDirective = /^\s*['"]use strict['"][\s;]*$/g;
190 |   output = output
191 |     .split("\n")
192 |     .filter(line => !line.match(useStrictDirective))
193 |     .join("\n");
194 | 
195 |   // Recast does not preserve blank lines between imports after converting them
196 |   // from `require` to `import` syntax. Since we group imports according to
197 |   // simple rules, we can fix up the imports with a simple script.
198 |   return groupImportsInFile(output);
199 | }
200 | 
201 | module.exports = { convertCommonJSImports, processCommonJSImports };
202 | 


--------------------------------------------------------------------------------
/packages/convert-to-es-modules/src/sort-imports.js:
--------------------------------------------------------------------------------
  1 | "use strict";
  2 | 
  3 | const BLANK_LINE = /^\s*$/;
  4 | const IMPORT_LINE = /^\s*import.*from ['"](.*)['"];?/;
  5 | 
  6 | /**
  7 |  * Extract the module path from an ES `import` statement.
  8 |  */
  9 | function getImportPath(line) {
 10 |   const importMatch = line.match(IMPORT_LINE);
 11 |   return importMatch ? importMatch[1] : null;
 12 | }
 13 | 
 14 | /**
 15 |  * Sort and group a list of import lines.
 16 |  *
 17 |  * @param {string[]} - Lines that are either empty or contain import declarations.
 18 |  */
 19 | function sortAndGroupImports(lines) {
 20 |   // Group imports by location relative to calling package.
 21 |   const imports = {
 22 |     vendor: [],
 23 |     samePackage: [],
 24 |     sameDir: []
 25 |   };
 26 | 
 27 |   const getCategory = path => {
 28 |     if (path.startsWith("./")) {
 29 |       return "sameDir";
 30 |     } else if (path.startsWith("../")) {
 31 |       return "samePackage";
 32 |     } else {
 33 |       return "vendor";
 34 |     }
 35 |   };
 36 | 
 37 |   for (let line of lines) {
 38 |     const importPath = getImportPath(line);
 39 |     if (!importPath) {
 40 |       // Skip blank lines.
 41 |       continue;
 42 |     }
 43 | 
 44 |     const category = getCategory(importPath);
 45 |     imports[category].push(line);
 46 |   }
 47 | 
 48 |   const sortedLines = [];
 49 | 
 50 |   // Sort each section and add a blank line between sections.
 51 |   Object.keys(imports).forEach((section, index, sections) => {
 52 |     // console.log('imports in category', section, ':', imports[section]);
 53 |     const sorted = imports[section].sort((a, b) =>
 54 |       getImportPath(a).localeCompare(getImportPath(b))
 55 |     );
 56 | 
 57 |     if (sorted.length > 0) {
 58 |       if (sortedLines.length > 0) {
 59 |         sortedLines.push("");
 60 |       }
 61 |       sortedLines.push(...sorted);
 62 |     }
 63 |   });
 64 | 
 65 |   return sortedLines;
 66 | }
 67 | 
 68 | /**
 69 |  * Insert blank lines between local and third-party package imports.
 70 |  *
 71 |  * @param {string} code
 72 |  */
 73 | function groupImportsInFile(code) {
 74 |   const lines = code.split("\n");
 75 | 
 76 |   // Find groups of imports with optional blank lines before, after or in-between.
 77 |   const lineTypes = lines
 78 |     .map(line => {
 79 |       if (line.match(BLANK_LINE)) {
 80 |         return "B";
 81 |       } else if (line.match(IMPORT_LINE)) {
 82 |         return "I";
 83 |       } else {
 84 |         return "O";
 85 |       }
 86 |     })
 87 |     .join("");
 88 | 
 89 |   const importGroups = [];
 90 |   for (let match of lineTypes.matchAll(/B*I[BI]*/g)) {
 91 |     importGroups.push([match.index, match.index + match[0].length - 1]);
 92 |   }
 93 | 
 94 |   let output = [];
 95 |   let prevEnd = -1;
 96 | 
 97 |   for (let [start, end] of importGroups) {
 98 |     const linesBeforeGroup = lines.slice(prevEnd + 1, start);
 99 |     if (linesBeforeGroup.length > 0) {
100 |       if (prevEnd !== -1) {
101 |         output.push("");
102 |       }
103 |       output.push(...linesBeforeGroup);
104 |       output.push("");
105 |     }
106 | 
107 |     const importLines = lines.slice(start, end + 1);
108 |     const sortedLines = sortAndGroupImports(importLines);
109 |     output.push(...sortedLines);
110 |     prevEnd = end;
111 |   }
112 | 
113 |   // Add the non-import lines after the final import group.
114 |   if (prevEnd !== -1) {
115 |     output.push("");
116 |   }
117 |   output.push(...lines.slice(prevEnd + 1));
118 | 
119 |   return output.join("\n");
120 | }
121 | 
122 | module.exports = { groupImportsInFile };
123 | 


--------------------------------------------------------------------------------
/packages/convert-to-es-modules/src/util.js:
--------------------------------------------------------------------------------
 1 | "use strict";
 2 | 
 3 | const traverse = require("@babel/traverse").default;
 4 | const types = require("@babel/types");
 5 | 
 6 | const recast = require("recast");
 7 | 
 8 | function parse(code) {
 9 |   return recast.parse(code, {
10 |     parser: require("recast/parsers/babel")
11 |   });
12 | }
13 | 
14 | /**
15 |  * Print a transformed AST using Recast, preserving the original source of any
16 |  * unmodified nodes.
17 |  */
18 | function printAST(ast) {
19 |   const output = recast.print(ast, {
20 |     quote: "single"
21 |   });
22 |   return output.code;
23 | }
24 | 
25 | module.exports = {
26 |   parse,
27 |   printAST,
28 |   traverse,
29 |   types
30 | };
31 | 


--------------------------------------------------------------------------------
/packages/convert-to-es-modules/test/convert-exports-test.js:
--------------------------------------------------------------------------------
  1 | "use strict";
  2 | 
  3 | const { assert } = require("chai");
  4 | 
  5 | const {
  6 |   convertCommonJSExports,
  7 |   detectDefaultExport
  8 | } = require("../src/convert-exports");
  9 | 
 10 | describe("convert-exports", () => {
 11 |   describe("convertCommonJSExports", () => {
 12 |     it("converts `module.exports = <identifier>` assignments to default exports", () => {
 13 |       const input = `
 14 |       // Do something.
 15 |       function foo() {
 16 |       }
 17 | 
 18 |       module.exports = foo;
 19 |       `;
 20 | 
 21 |       const expected = `
 22 |       // Do something.
 23 |       export default function foo() {
 24 |       }
 25 |       `;
 26 | 
 27 |       const output = convertCommonJSExports(input);
 28 |       assert.equal(output, expected);
 29 |     });
 30 | 
 31 |     it("adds export declarations to named exports", () => {
 32 |       const input = `
 33 |       function foo() {}
 34 |       class Bar {}
 35 | 
 36 |       module.exports = { foo, Bar };
 37 |       `;
 38 | 
 39 |       const expected = `
 40 |       export function foo() {}
 41 |       export class Bar {}
 42 |       `;
 43 | 
 44 |       const output = convertCommonJSExports(input);
 45 |       assert.equal(output, expected);
 46 |     });
 47 | 
 48 |     it("uses correct export name for aliased exports", () => {
 49 |       const input = `
 50 |       function foo() {}
 51 | 
 52 |       module.exports = { boop: foo };
 53 |       `;
 54 | 
 55 |       const expected = `
 56 |       function foo() {}
 57 | 
 58 |       export { foo as boop };
 59 |       `;
 60 | 
 61 |       const output = convertCommonJSExports(input);
 62 |       assert.equal(output, expected);
 63 |     });
 64 | 
 65 |     it("creates an export list for more complex named exports", () => {
 66 |       const input = `
 67 |       var foo = 1, bar = 2;
 68 | 
 69 |       module.exports = { foo, bar };
 70 |       `;
 71 | 
 72 |       const expected = `
 73 |       var foo = 1, bar = 2;
 74 | 
 75 |       export { foo, bar };
 76 |       `;
 77 | 
 78 |       const output = convertCommonJSExports(input);
 79 |       assert.equal(output, expected);
 80 |     });
 81 | 
 82 |     it("creates an export list for more complex default exports", () => {
 83 |       const input = `
 84 |       module.exports = function () {};
 85 |       `;
 86 |       const expected = `
 87 |       export default function () {};
 88 |       `;
 89 |       const output = convertCommonJSExports(input);
 90 |       assert.equal(output, expected);
 91 |     });
 92 |   });
 93 | 
 94 |   describe("detectDefaultExport", () => {
 95 |     it("returns `false` if module exports an object literal where all values are identifiers", () => {
 96 |       const code = `module.exports = { foo: bar, meep }`;
 97 |       assert.equal(detectDefaultExport(code), false);
 98 |     });
 99 | 
100 |     it("returns `true` if module exports an object-literal with non-identifier values", () => {
101 |       const code = `module.exports = { foo: 'abc' };`;
102 |       assert.equal(detectDefaultExport(code), true);
103 |     });
104 | 
105 |     it("returns `true` if module exports a non-object literal", () => {
106 |       const code = `module.exports = SomeClass;`;
107 |       assert.equal(detectDefaultExport(code), true);
108 |     });
109 | 
110 |     it("returns `true` if module has a default ES export", () => {
111 |       const code = `export default function foo () {}`;
112 |       assert.equal(detectDefaultExport(code), true);
113 |     });
114 |   });
115 | });
116 | 


--------------------------------------------------------------------------------
/packages/convert-to-es-modules/test/convert-imports-test.js:
--------------------------------------------------------------------------------
  1 | "use strict";
  2 | 
  3 | const { assert } = require("chai");
  4 | 
  5 | const { convertCommonJSImports } = require("../src/convert-imports");
  6 | 
  7 | describe("convert-imports", () => {
  8 |   describe("convertCommonJSImports", () => {
  9 |     const commanderPath = require.resolve("commander");
 10 | 
 11 |     it("converts CommonJS imports to namespace ES imports", () => {
 12 |       const input = `
 13 |       var commander = require("commander");
 14 |       `;
 15 |       const expected = `
 16 |       import * as commander from 'commander';
 17 |       `;
 18 | 
 19 |       // Pretend "commander" has no default export.
 20 |       const hasDefaultExport = { [commanderPath]: false };
 21 | 
 22 |       const output = convertCommonJSImports(
 23 |         input,
 24 |         "src/test.js",
 25 |         hasDefaultExport
 26 |       );
 27 | 
 28 |       assert.equal(output.trim(), expected.trim());
 29 |     });
 30 | 
 31 |     it("converts CommonJS imports to default ES imports", () => {
 32 |       const input = `
 33 |       var commander = require("commander");
 34 |       `;
 35 |       const expected = `
 36 |       import commander from 'commander';
 37 |       `;
 38 | 
 39 |       // Pretend "commander" does have a default export.
 40 |       const hasDefaultExport = { [commanderPath]: true };
 41 | 
 42 |       const output = convertCommonJSImports(
 43 |         input,
 44 |         "src/test.js",
 45 |         hasDefaultExport
 46 |       );
 47 | 
 48 |       assert.equal(output.trim(), expected.trim());
 49 |     });
 50 | 
 51 |     it("converts named imports to ES imports", () => {
 52 |       const input = `
 53 |       var { foo, bar } = require("commander");
 54 |       var { foo: wibble } = require("commander");
 55 |       `;
 56 |       const expected = `
 57 |       import { foo, bar } from 'commander';
 58 |       import { foo as wibble } from 'commander';
 59 |       `;
 60 | 
 61 |       const hasDefaultExport = {};
 62 | 
 63 |       const output = convertCommonJSImports(
 64 |         input,
 65 |         "src/test.js",
 66 |         hasDefaultExport
 67 |       );
 68 | 
 69 |       assert.equal(output.trim(), expected.trim());
 70 |     });
 71 | 
 72 |     [
 73 |       // Input imports already grouped.
 74 |       `
 75 |         var foo = require("commander");
 76 |         var bar = require("commander");
 77 | 
 78 |         var local = require("./convert-imports-test");
 79 |         var local2 = require("../src/convert-imports");
 80 |       `,
 81 | 
 82 |       // Input imports not grouped.
 83 |       `
 84 |         var foo = require("commander");
 85 |         var bar = require("commander");
 86 |         var local = require("./convert-imports-test");
 87 |         var local2 = require("../src/convert-imports");
 88 |       `
 89 |     ].forEach(input => {
 90 |       it("inserts a blank line between local and vendor imports", () => {
 91 |         const expected = `
 92 |         import * as foo from 'commander';
 93 |         import * as bar from 'commander';
 94 | 
 95 |         import * as local2 from '../src/convert-imports';
 96 | 
 97 |         import * as local from './convert-imports-test';
 98 |         `;
 99 | 
100 |         const hasDefaultExport = {};
101 | 
102 |         const output = convertCommonJSImports(
103 |           input,
104 |           __filename,
105 |           hasDefaultExport
106 |         );
107 | 
108 |         assert.equal(output.trim(), expected.trim());
109 |       });
110 |     });
111 | 
112 |     it("strips 'use strict' literals", () => {
113 |       const input = `
114 | 'use strict';
115 | 
116 | const foo = require("commander");
117 | 
118 | function test() {
119 |   "use strict";
120 | }
121 |       `;
122 | 
123 |       const expected = `
124 | import * as foo from 'commander';
125 | 
126 | function test() {
127 | }
128 | `;
129 | 
130 |       const hasDefaultExport = {};
131 |       const output = convertCommonJSImports(
132 |         input,
133 |         __filename,
134 |         hasDefaultExport
135 |       );
136 | 
137 |       assert.equal(output.trim(), expected.trim());
138 |     });
139 |   });
140 | });
141 | 


--------------------------------------------------------------------------------
/packages/convert-to-es-modules/test/sort-imports-test.js:
--------------------------------------------------------------------------------
  1 | "use strict";
  2 | 
  3 | const { assert } = require("chai");
  4 | 
  5 | const { groupImportsInFile } = require("../src/sort-imports");
  6 | 
  7 | describe("sort-imports", () => {
  8 |   describe("groupImportsInFile", () => {
  9 |     it("sorts imports into vendor, same-package and same-dir sections", () => {
 10 |       const input = `
 11 | import localUtility from "../util/local-utility";
 12 | import LocalComponent from "./LocalComponent";
 13 | import * as vendorLib from "vendor-lib";
 14 | import vendorFunc from "vendor-func";
 15 | 
 16 | function MyWidget() {
 17 | }
 18 |       `;
 19 | 
 20 |       const expected = `
 21 | import vendorFunc from "vendor-func";
 22 | import * as vendorLib from "vendor-lib";
 23 | 
 24 | import localUtility from "../util/local-utility";
 25 | 
 26 | import LocalComponent from "./LocalComponent";
 27 | 
 28 | function MyWidget() {
 29 | }
 30 | `;
 31 | 
 32 |       const output = groupImportsInFile(input);
 33 |       assert.equal(output.trim(), expected.trim());
 34 |     });
 35 | 
 36 |     it("sorts each non-blank line delimited section independently", () => {
 37 |       const input = `
 38 | import zorp from "zorp";
 39 | 
 40 | function FooBar() {}
 41 | 
 42 | // Comment
 43 | 
 44 | import zerg from "zerg";
 45 | import bar from "bar";
 46 | `;
 47 | 
 48 |       const expected = `
 49 | import zorp from "zorp";
 50 | 
 51 | function FooBar() {}
 52 | 
 53 | // Comment
 54 | 
 55 | import bar from "bar";
 56 | import zerg from "zerg";
 57 | `;
 58 | 
 59 |       const output = groupImportsInFile(input);
 60 |       assert.equal(output.trim(), expected.trim());
 61 |     });
 62 | 
 63 |     [
 64 |       // Input with leading/trailing blank lines.
 65 |       `
 66 | function FooBar() {}
 67 | 
 68 | // Comment
 69 | 
 70 | class Woot {}
 71 |       `,
 72 | 
 73 |       // Input with content on the first (and last) line.
 74 |       "function FooBar() {}"
 75 |     ].forEach(input => {
 76 |       it("leaves input with no imports unchanged", () => {
 77 |         const output = groupImportsInFile(input);
 78 |         assert.equal(output.trim(), input.trim());
 79 |       });
 80 |     });
 81 | 
 82 |     it("preserves lines before first import", () => {
 83 |       const input = `
 84 | // This is a test
 85 | const foo = 42;
 86 | 
 87 | import bar from "bar";
 88 | `;
 89 |       const output = groupImportsInFile(input);
 90 |       assert.equal(output.trim(), input.trim());
 91 |     });
 92 | 
 93 |     it("preserves lines after last import", () => {
 94 |       const input = `
 95 | import bar from "bar";
 96 | 
 97 | // This is a test
 98 | const foo = 42;
 99 | `;
100 |       const output = groupImportsInFile(input);
101 |       assert.equal(output.trim(), input.trim());
102 |     });
103 |   });
104 | });
105 | 


--------------------------------------------------------------------------------
/packages/convert-to-es-modules/yarn.lock:
--------------------------------------------------------------------------------
   1 | # THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY.
   2 | # yarn lockfile v1
   3 | 
   4 | 
   5 | "@babel/code-frame@^7.0.0", "@babel/code-frame@^7.5.5":
   6 |   version "7.5.5"
   7 |   resolved "https://registry.yarnpkg.com/@babel/code-frame/-/code-frame-7.5.5.tgz#bc0782f6d69f7b7d49531219699b988f669a8f9d"
   8 |   integrity sha512-27d4lZoomVyo51VegxI20xZPuSHusqbQag/ztrBC7wegWoQ1nLREPVSKSW8byhTlzTKyNE4ifaTA6lCp7JjpFw==
   9 |   dependencies:
  10 |     "@babel/highlight" "^7.0.0"
  11 | 
  12 | "@babel/code-frame@^7.22.13":
  13 |   version "7.22.13"
  14 |   resolved "https://registry.yarnpkg.com/@babel/code-frame/-/code-frame-7.22.13.tgz#e3c1c099402598483b7a8c46a721d1038803755e"
  15 |   integrity sha512-XktuhWlJ5g+3TJXc5upd9Ks1HutSArik6jf2eAjYFyIOf4ej3RN+184cZbzDvbPnuTJIUhPKKJE3cIsYTiAT3w==
  16 |   dependencies:
  17 |     "@babel/highlight" "^7.22.13"
  18 |     chalk "^2.4.2"
  19 | 
  20 | "@babel/core@^7.7.7":
  21 |   version "7.7.7"
  22 |   resolved "https://registry.yarnpkg.com/@babel/core/-/core-7.7.7.tgz#ee155d2e12300bcc0cff6a8ad46f2af5063803e9"
  23 |   integrity sha512-jlSjuj/7z138NLZALxVgrx13AOtqip42ATZP7+kYl53GvDV6+4dCek1mVUo8z8c8Xnw/mx2q3d9HWh3griuesQ==
  24 |   dependencies:
  25 |     "@babel/code-frame" "^7.5.5"
  26 |     "@babel/generator" "^7.7.7"
  27 |     "@babel/helpers" "^7.7.4"
  28 |     "@babel/parser" "^7.7.7"
  29 |     "@babel/template" "^7.7.4"
  30 |     "@babel/traverse" "^7.7.4"
  31 |     "@babel/types" "^7.7.4"
  32 |     convert-source-map "^1.7.0"
  33 |     debug "^4.1.0"
  34 |     json5 "^2.1.0"
  35 |     lodash "^4.17.13"
  36 |     resolve "^1.3.2"
  37 |     semver "^5.4.1"
  38 |     source-map "^0.5.0"
  39 | 
  40 | "@babel/generator@^7.23.0":
  41 |   version "7.23.0"
  42 |   resolved "https://registry.yarnpkg.com/@babel/generator/-/generator-7.23.0.tgz#df5c386e2218be505b34837acbcb874d7a983420"
  43 |   integrity sha512-lN85QRR+5IbYrMWM6Y4pE/noaQtg4pNiqeNGX60eqOfo6gtEj6uw/JagelB8vVztSd7R6M5n1+PQkDbHbBRU4g==
  44 |   dependencies:
  45 |     "@babel/types" "^7.23.0"
  46 |     "@jridgewell/gen-mapping" "^0.3.2"
  47 |     "@jridgewell/trace-mapping" "^0.3.17"
  48 |     jsesc "^2.5.1"
  49 | 
  50 | "@babel/generator@^7.7.7":
  51 |   version "7.7.7"
  52 |   resolved "https://registry.yarnpkg.com/@babel/generator/-/generator-7.7.7.tgz#859ac733c44c74148e1a72980a64ec84b85f4f45"
  53 |   integrity sha512-/AOIBpHh/JU1l0ZFS4kiRCBnLi6OTHzh0RPk3h9isBxkkqELtQNFi1Vr/tiG9p1yfoUdKVwISuXWQR+hwwM4VQ==
  54 |   dependencies:
  55 |     "@babel/types" "^7.7.4"
  56 |     jsesc "^2.5.1"
  57 |     lodash "^4.17.13"
  58 |     source-map "^0.5.0"
  59 | 
  60 | "@babel/helper-environment-visitor@^7.22.20":
  61 |   version "7.22.20"
  62 |   resolved "https://registry.yarnpkg.com/@babel/helper-environment-visitor/-/helper-environment-visitor-7.22.20.tgz#96159db61d34a29dba454c959f5ae4a649ba9167"
  63 |   integrity sha512-zfedSIzFhat/gFhWfHtgWvlec0nqB9YEIVrpuwjruLlXfUSnA8cJB0miHKwqDnQ7d32aKo2xt88/xZptwxbfhA==
  64 | 
  65 | "@babel/helper-function-name@^7.23.0":
  66 |   version "7.23.0"
  67 |   resolved "https://registry.yarnpkg.com/@babel/helper-function-name/-/helper-function-name-7.23.0.tgz#1f9a3cdbd5b2698a670c30d2735f9af95ed52759"
  68 |   integrity sha512-OErEqsrxjZTJciZ4Oo+eoZqeW9UIiOcuYKRJA4ZAgV9myA+pOXhhmpfNCKjEH/auVfEYVFJ6y1Tc4r0eIApqiw==
  69 |   dependencies:
  70 |     "@babel/template" "^7.22.15"
  71 |     "@babel/types" "^7.23.0"
  72 | 
  73 | "@babel/helper-hoist-variables@^7.22.5":
  74 |   version "7.22.5"
  75 |   resolved "https://registry.yarnpkg.com/@babel/helper-hoist-variables/-/helper-hoist-variables-7.22.5.tgz#c01a007dac05c085914e8fb652b339db50d823bb"
  76 |   integrity sha512-wGjk9QZVzvknA6yKIUURb8zY3grXCcOZt+/7Wcy8O2uctxhplmUPkOdlgoNhmdVee2c92JXbf1xpMtVNbfoxRw==
  77 |   dependencies:
  78 |     "@babel/types" "^7.22.5"
  79 | 
  80 | "@babel/helper-split-export-declaration@^7.22.6":
  81 |   version "7.22.6"
  82 |   resolved "https://registry.yarnpkg.com/@babel/helper-split-export-declaration/-/helper-split-export-declaration-7.22.6.tgz#322c61b7310c0997fe4c323955667f18fcefb91c"
  83 |   integrity sha512-AsUnxuLhRYsisFiaJwvp1QF+I3KjD5FOxut14q/GzovUe6orHLesW2C7d754kRm53h5gqrz6sFl6sxc4BVtE/g==
  84 |   dependencies:
  85 |     "@babel/types" "^7.22.5"
  86 | 
  87 | "@babel/helper-string-parser@^7.22.5":
  88 |   version "7.22.5"
  89 |   resolved "https://registry.yarnpkg.com/@babel/helper-string-parser/-/helper-string-parser-7.22.5.tgz#533f36457a25814cf1df6488523ad547d784a99f"
  90 |   integrity sha512-mM4COjgZox8U+JcXQwPijIZLElkgEpO5rsERVDJTc2qfCDfERyob6k5WegS14SX18IIjv+XD+GrqNumY5JRCDw==
  91 | 
  92 | "@babel/helper-validator-identifier@^7.22.20":
  93 |   version "7.22.20"
  94 |   resolved "https://registry.yarnpkg.com/@babel/helper-validator-identifier/-/helper-validator-identifier-7.22.20.tgz#c4ae002c61d2879e724581d96665583dbc1dc0e0"
  95 |   integrity sha512-Y4OZ+ytlatR8AI+8KZfKuL5urKp7qey08ha31L8b3BwewJAoJamTzyvxPR/5D+KkdJCGPq/+8TukHBlY10FX9A==
  96 | 
  97 | "@babel/helpers@^7.7.4":
  98 |   version "7.7.4"
  99 |   resolved "https://registry.yarnpkg.com/@babel/helpers/-/helpers-7.7.4.tgz#62c215b9e6c712dadc15a9a0dcab76c92a940302"
 100 |   integrity sha512-ak5NGZGJ6LV85Q1Zc9gn2n+ayXOizryhjSUBTdu5ih1tlVCJeuQENzc4ItyCVhINVXvIT/ZQ4mheGIsfBkpskg==
 101 |   dependencies:
 102 |     "@babel/template" "^7.7.4"
 103 |     "@babel/traverse" "^7.7.4"
 104 |     "@babel/types" "^7.7.4"
 105 | 
 106 | "@babel/highlight@^7.0.0":
 107 |   version "7.5.0"
 108 |   resolved "https://registry.yarnpkg.com/@babel/highlight/-/highlight-7.5.0.tgz#56d11312bd9248fa619591d02472be6e8cb32540"
 109 |   integrity sha512-7dV4eu9gBxoM0dAnj/BCFDW9LFU0zvTrkq0ugM7pnHEgguOEeOz1so2ZghEdzviYzQEED0r4EAgpsBChKy1TRQ==
 110 |   dependencies:
 111 |     chalk "^2.0.0"
 112 |     esutils "^2.0.2"
 113 |     js-tokens "^4.0.0"
 114 | 
 115 | "@babel/highlight@^7.22.13":
 116 |   version "7.22.20"
 117 |   resolved "https://registry.yarnpkg.com/@babel/highlight/-/highlight-7.22.20.tgz#4ca92b71d80554b01427815e06f2df965b9c1f54"
 118 |   integrity sha512-dkdMCN3py0+ksCgYmGG8jKeGA/8Tk+gJwSYYlFGxG5lmhfKNoAy004YpLxpS1W2J8m/EK2Ew+yOs9pVRwO89mg==
 119 |   dependencies:
 120 |     "@babel/helper-validator-identifier" "^7.22.20"
 121 |     chalk "^2.4.2"
 122 |     js-tokens "^4.0.0"
 123 | 
 124 | "@babel/parser@^7.22.15", "@babel/parser@^7.23.0":
 125 |   version "7.23.0"
 126 |   resolved "https://registry.yarnpkg.com/@babel/parser/-/parser-7.23.0.tgz#da950e622420bf96ca0d0f2909cdddac3acd8719"
 127 |   integrity sha512-vvPKKdMemU85V9WE/l5wZEmImpCtLqbnTvqDS2U1fJ96KrxoW7KrXhNsNCblQlg8Ck4b85yxdTyelsMUgFUXiw==
 128 | 
 129 | "@babel/parser@^7.7.4", "@babel/parser@^7.7.7":
 130 |   version "7.7.7"
 131 |   resolved "https://registry.yarnpkg.com/@babel/parser/-/parser-7.7.7.tgz#1b886595419cf92d811316d5b715a53ff38b4937"
 132 |   integrity sha512-WtTZMZAZLbeymhkd/sEaPD8IQyGAhmuTuvTzLiCFM7iXiVdY0gc0IaI+cW0fh1BnSMbJSzXX6/fHllgHKwHhXw==
 133 | 
 134 | "@babel/template@^7.22.15":
 135 |   version "7.22.15"
 136 |   resolved "https://registry.yarnpkg.com/@babel/template/-/template-7.22.15.tgz#09576efc3830f0430f4548ef971dde1350ef2f38"
 137 |   integrity sha512-QPErUVm4uyJa60rkI73qneDacvdvzxshT3kksGqlGWYdOTIUOwJ7RDUL8sGqslY1uXWSL6xMFKEXDS3ox2uF0w==
 138 |   dependencies:
 139 |     "@babel/code-frame" "^7.22.13"
 140 |     "@babel/parser" "^7.22.15"
 141 |     "@babel/types" "^7.22.15"
 142 | 
 143 | "@babel/template@^7.7.4":
 144 |   version "7.7.4"
 145 |   resolved "https://registry.yarnpkg.com/@babel/template/-/template-7.7.4.tgz#428a7d9eecffe27deac0a98e23bf8e3675d2a77b"
 146 |   integrity sha512-qUzihgVPguAzXCK7WXw8pqs6cEwi54s3E+HrejlkuWO6ivMKx9hZl3Y2fSXp9i5HgyWmj7RKP+ulaYnKM4yYxw==
 147 |   dependencies:
 148 |     "@babel/code-frame" "^7.0.0"
 149 |     "@babel/parser" "^7.7.4"
 150 |     "@babel/types" "^7.7.4"
 151 | 
 152 | "@babel/traverse@^7.7.4":
 153 |   version "7.23.2"
 154 |   resolved "https://registry.yarnpkg.com/@babel/traverse/-/traverse-7.23.2.tgz#329c7a06735e144a506bdb2cad0268b7f46f4ad8"
 155 |   integrity sha512-azpe59SQ48qG6nu2CzcMLbxUudtN+dOM9kDbUqGq3HXUJRlo7i8fvPoxQUzYgLZ4cMVmuZgm8vvBpNeRhd6XSw==
 156 |   dependencies:
 157 |     "@babel/code-frame" "^7.22.13"
 158 |     "@babel/generator" "^7.23.0"
 159 |     "@babel/helper-environment-visitor" "^7.22.20"
 160 |     "@babel/helper-function-name" "^7.23.0"
 161 |     "@babel/helper-hoist-variables" "^7.22.5"
 162 |     "@babel/helper-split-export-declaration" "^7.22.6"
 163 |     "@babel/parser" "^7.23.0"
 164 |     "@babel/types" "^7.23.0"
 165 |     debug "^4.1.0"
 166 |     globals "^11.1.0"
 167 | 
 168 | "@babel/types@^7.22.15", "@babel/types@^7.22.5", "@babel/types@^7.23.0":
 169 |   version "7.23.0"
 170 |   resolved "https://registry.yarnpkg.com/@babel/types/-/types-7.23.0.tgz#8c1f020c9df0e737e4e247c0619f58c68458aaeb"
 171 |   integrity sha512-0oIyUfKoI3mSqMvsxBdclDwxXKXAUA8v/apZbc+iSyARYou1o8ZGDxbUYyLFoW2arqS2jDGqJuZvv1d/io1axg==
 172 |   dependencies:
 173 |     "@babel/helper-string-parser" "^7.22.5"
 174 |     "@babel/helper-validator-identifier" "^7.22.20"
 175 |     to-fast-properties "^2.0.0"
 176 | 
 177 | "@babel/types@^7.7.4":
 178 |   version "7.7.4"
 179 |   resolved "https://registry.yarnpkg.com/@babel/types/-/types-7.7.4.tgz#516570d539e44ddf308c07569c258ff94fde9193"
 180 |   integrity sha512-cz5Ji23KCi4T+YIE/BolWosrJuSmoZeN1EFnRtBwF+KKLi8GG/Z2c2hOJJeCXPk4mwk4QFvTmwIodJowXgttRA==
 181 |   dependencies:
 182 |     esutils "^2.0.2"
 183 |     lodash "^4.17.13"
 184 |     to-fast-properties "^2.0.0"
 185 | 
 186 | "@jridgewell/gen-mapping@^0.3.2":
 187 |   version "0.3.3"
 188 |   resolved "https://registry.yarnpkg.com/@jridgewell/gen-mapping/-/gen-mapping-0.3.3.tgz#7e02e6eb5df901aaedb08514203b096614024098"
 189 |   integrity sha512-HLhSWOLRi875zjjMG/r+Nv0oCW8umGb0BgEhyX3dDX3egwZtB8PqLnjz3yedt8R5StBrzcg4aBpnh8UA9D1BoQ==
 190 |   dependencies:
 191 |     "@jridgewell/set-array" "^1.0.1"
 192 |     "@jridgewell/sourcemap-codec" "^1.4.10"
 193 |     "@jridgewell/trace-mapping" "^0.3.9"
 194 | 
 195 | "@jridgewell/resolve-uri@^3.1.0":
 196 |   version "3.1.1"
 197 |   resolved "https://registry.yarnpkg.com/@jridgewell/resolve-uri/-/resolve-uri-3.1.1.tgz#c08679063f279615a3326583ba3a90d1d82cc721"
 198 |   integrity sha512-dSYZh7HhCDtCKm4QakX0xFpsRDqjjtZf/kjI/v3T3Nwt5r8/qz/M19F9ySyOqU94SXBmeG9ttTul+YnR4LOxFA==
 199 | 
 200 | "@jridgewell/set-array@^1.0.1":
 201 |   version "1.1.2"
 202 |   resolved "https://registry.yarnpkg.com/@jridgewell/set-array/-/set-array-1.1.2.tgz#7c6cf998d6d20b914c0a55a91ae928ff25965e72"
 203 |   integrity sha512-xnkseuNADM0gt2bs+BvhO0p78Mk762YnZdsuzFV018NoG1Sj1SCQvpSqa7XUaTam5vAGasABV9qXASMKnFMwMw==
 204 | 
 205 | "@jridgewell/sourcemap-codec@^1.4.10", "@jridgewell/sourcemap-codec@^1.4.14":
 206 |   version "1.4.15"
 207 |   resolved "https://registry.yarnpkg.com/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.4.15.tgz#d7c6e6755c78567a951e04ab52ef0fd26de59f32"
 208 |   integrity sha512-eF2rxCRulEKXHTRiDrDy6erMYWqNw4LPdQ8UQA4huuxaQsVeRPFl2oM8oDGxMFhJUWZf9McpLtJasDDZb/Bpeg==
 209 | 
 210 | "@jridgewell/trace-mapping@^0.3.17", "@jridgewell/trace-mapping@^0.3.9":
 211 |   version "0.3.20"
 212 |   resolved "https://registry.yarnpkg.com/@jridgewell/trace-mapping/-/trace-mapping-0.3.20.tgz#72e45707cf240fa6b081d0366f8265b0cd10197f"
 213 |   integrity sha512-R8LcPeWZol2zR8mmH3JeKQ6QRCFb7XgUhV9ZlGhHLGyg4wpPiPZNQOOWhFZhxKw8u//yTbNGI42Bx/3paXEQ+Q==
 214 |   dependencies:
 215 |     "@jridgewell/resolve-uri" "^3.1.0"
 216 |     "@jridgewell/sourcemap-codec" "^1.4.14"
 217 | 
 218 | ansi-colors@3.2.3:
 219 |   version "3.2.3"
 220 |   resolved "https://registry.yarnpkg.com/ansi-colors/-/ansi-colors-3.2.3.tgz#57d35b8686e851e2cc04c403f1c00203976a1813"
 221 |   integrity sha512-LEHHyuhlPY3TmuUYMh2oz89lTShfvgbmzaBcxve9t/9Wuy7Dwf4yoAKcND7KFT1HAQfqZ12qtc+DUrBMeKF9nw==
 222 | 
 223 | ansi-regex@^3.0.0:
 224 |   version "3.0.1"
 225 |   resolved "https://registry.yarnpkg.com/ansi-regex/-/ansi-regex-3.0.1.tgz#123d6479e92ad45ad897d4054e3c7ca7db4944e1"
 226 |   integrity sha512-+O9Jct8wf++lXxxFc4hc8LsjaSq0HFzzL7cVsw8pRDIPdjKD2mT4ytDZlLuSBZ4cLKZFXIrMGO7DbQCtMJJMKw==
 227 | 
 228 | ansi-regex@^4.1.0:
 229 |   version "4.1.0"
 230 |   resolved "https://registry.yarnpkg.com/ansi-regex/-/ansi-regex-4.1.0.tgz#8b9f8f08cf1acb843756a839ca8c7e3168c51997"
 231 |   integrity sha512-1apePfXM1UOSqw0o9IiFAovVz9M5S1Dg+4TrDwfMewQ6p/rmMueb7tWZjQ1rx4Loy1ArBggoqGpfqqdI4rondg==
 232 | 
 233 | ansi-styles@^3.2.0, ansi-styles@^3.2.1:
 234 |   version "3.2.1"
 235 |   resolved "https://registry.yarnpkg.com/ansi-styles/-/ansi-styles-3.2.1.tgz#41fbb20243e50b12be0f04b8dedbf07520ce841d"
 236 |   integrity sha512-VT0ZI6kZRdTh8YyJw3SMbYm/u+NqfsAxEpWO0Pf9sq8/e94WxxOpPKx9FR1FlyCtOVDNOQ+8ntlqFxiRc+r5qA==
 237 |   dependencies:
 238 |     color-convert "^1.9.0"
 239 | 
 240 | anymatch@~3.1.1:
 241 |   version "3.1.1"
 242 |   resolved "https://registry.yarnpkg.com/anymatch/-/anymatch-3.1.1.tgz#c55ecf02185e2469259399310c173ce31233b142"
 243 |   integrity sha512-mM8522psRCqzV+6LhomX5wgp25YVibjh8Wj23I5RPkPppSVSjyKD2A2mBJmWGa+KN7f2D6LNh9jkBCeyLktzjg==
 244 |   dependencies:
 245 |     normalize-path "^3.0.0"
 246 |     picomatch "^2.0.4"
 247 | 
 248 | argparse@^1.0.7:
 249 |   version "1.0.10"
 250 |   resolved "https://registry.yarnpkg.com/argparse/-/argparse-1.0.10.tgz#bcd6791ea5ae09725e17e5ad988134cd40b3d911"
 251 |   integrity sha512-o5Roy6tNG4SL/FOkCAN6RzjiakZS25RLYFrcMttJqbdd8BWrnA+fGz57iN5Pb06pvBGvl5gQ0B48dJlslXvoTg==
 252 |   dependencies:
 253 |     sprintf-js "~1.0.2"
 254 | 
 255 | assertion-error@^1.1.0:
 256 |   version "1.1.0"
 257 |   resolved "https://registry.yarnpkg.com/assertion-error/-/assertion-error-1.1.0.tgz#e60b6b0e8f301bd97e5375215bda406c85118c0b"
 258 |   integrity sha512-jgsaNduz+ndvGyFt3uSuWqvy4lCnIJiovtouQN5JZHOKCS2QuhEdbcQHFhVksz2N2U9hXJo8odG7ETyWlEeuDw==
 259 | 
 260 | ast-types@0.13.2:
 261 |   version "0.13.2"
 262 |   resolved "https://registry.yarnpkg.com/ast-types/-/ast-types-0.13.2.tgz#df39b677a911a83f3a049644fb74fdded23cea48"
 263 |   integrity sha512-uWMHxJxtfj/1oZClOxDEV1sQ1HCDkA4MG8Gr69KKeBjEVH0R84WlejZ0y2DcwyBlpAEMltmVYkVgqfLFb2oyiA==
 264 | 
 265 | balanced-match@^1.0.0:
 266 |   version "1.0.0"
 267 |   resolved "https://registry.yarnpkg.com/balanced-match/-/balanced-match-1.0.0.tgz#89b4d199ab2bee49de164ea02b89ce462d71b767"
 268 |   integrity sha1-ibTRmasr7kneFk6gK4nORi1xt2c=
 269 | 
 270 | binary-extensions@^2.0.0:
 271 |   version "2.0.0"
 272 |   resolved "https://registry.yarnpkg.com/binary-extensions/-/binary-extensions-2.0.0.tgz#23c0df14f6a88077f5f986c0d167ec03c3d5537c"
 273 |   integrity sha512-Phlt0plgpIIBOGTT/ehfFnbNlfsDEiqmzE2KRXoX1bLIlir4X/MR+zSyBEkL05ffWgnRSf/DXv+WrUAVr93/ow==
 274 | 
 275 | brace-expansion@^1.1.7:
 276 |   version "1.1.11"
 277 |   resolved "https://registry.yarnpkg.com/brace-expansion/-/brace-expansion-1.1.11.tgz#3c7fcbf529d87226f3d2f52b966ff5271eb441dd"
 278 |   integrity sha512-iCuPHDFgrHX7H2vEI/5xpz07zSHB00TpugqhmYtVmMO6518mCuRMoOYFldEBl0g187ufozdaHgWKcYFb61qGiA==
 279 |   dependencies:
 280 |     balanced-match "^1.0.0"
 281 |     concat-map "0.0.1"
 282 | 
 283 | braces@~3.0.2:
 284 |   version "3.0.2"
 285 |   resolved "https://registry.yarnpkg.com/braces/-/braces-3.0.2.tgz#3454e1a462ee8d599e236df336cd9ea4f8afe107"
 286 |   integrity sha512-b8um+L1RzM3WDSzvhm6gIz1yfTbBt6YTlcEKAvsmqCZZFw46z626lVj9j1yEPW33H5H+lBQpZMP1k8l+78Ha0A==
 287 |   dependencies:
 288 |     fill-range "^7.0.1"
 289 | 
 290 | browser-stdout@1.3.1:
 291 |   version "1.3.1"
 292 |   resolved "https://registry.yarnpkg.com/browser-stdout/-/browser-stdout-1.3.1.tgz#baa559ee14ced73452229bad7326467c61fabd60"
 293 |   integrity sha512-qhAVI1+Av2X7qelOfAIYwXONood6XlZE/fXaBSmW/T5SzLAmCgzi+eiWE7fUvbHaeNBQH13UftjpXxsfLkMpgw==
 294 | 
 295 | camelcase@^5.0.0:
 296 |   version "5.3.1"
 297 |   resolved "https://registry.yarnpkg.com/camelcase/-/camelcase-5.3.1.tgz#e3c9b31569e106811df242f715725a1f4c494320"
 298 |   integrity sha512-L28STB170nwWS63UjtlEOE3dldQApaJXZkOI1uMFfzf3rRuPegHaHesyee+YxQ+W6SvRDQV6UrdOdRiR153wJg==
 299 | 
 300 | chai@^4.2.0:
 301 |   version "4.2.0"
 302 |   resolved "https://registry.yarnpkg.com/chai/-/chai-4.2.0.tgz#760aa72cf20e3795e84b12877ce0e83737aa29e5"
 303 |   integrity sha512-XQU3bhBukrOsQCuwZndwGcCVQHyZi53fQ6Ys1Fym7E4olpIqqZZhhoFJoaKVvV17lWQoXYwgWN2nF5crA8J2jw==
 304 |   dependencies:
 305 |     assertion-error "^1.1.0"
 306 |     check-error "^1.0.2"
 307 |     deep-eql "^3.0.1"
 308 |     get-func-name "^2.0.0"
 309 |     pathval "^1.1.0"
 310 |     type-detect "^4.0.5"
 311 | 
 312 | chalk@^2.0.0, chalk@^2.0.1, chalk@^2.4.2:
 313 |   version "2.4.2"
 314 |   resolved "https://registry.yarnpkg.com/chalk/-/chalk-2.4.2.tgz#cd42541677a54333cf541a49108c1432b44c9424"
 315 |   integrity sha512-Mti+f9lpJNcwF4tWV8/OrTTtF1gZi+f8FqlyAdouralcFWFQWF2+NgCHShjkCb+IFBLq9buZwE1xckQU4peSuQ==
 316 |   dependencies:
 317 |     ansi-styles "^3.2.1"
 318 |     escape-string-regexp "^1.0.5"
 319 |     supports-color "^5.3.0"
 320 | 
 321 | check-error@^1.0.2:
 322 |   version "1.0.2"
 323 |   resolved "https://registry.yarnpkg.com/check-error/-/check-error-1.0.2.tgz#574d312edd88bb5dd8912e9286dd6c0aed4aac82"
 324 |   integrity sha1-V00xLt2Iu13YkS6Sht1sCu1KrII=
 325 | 
 326 | chokidar@3.3.0:
 327 |   version "3.3.0"
 328 |   resolved "https://registry.yarnpkg.com/chokidar/-/chokidar-3.3.0.tgz#12c0714668c55800f659e262d4962a97faf554a6"
 329 |   integrity sha512-dGmKLDdT3Gdl7fBUe8XK+gAtGmzy5Fn0XkkWQuYxGIgWVPPse2CxFA5mtrlD0TOHaHjEUqkWNyP1XdHoJES/4A==
 330 |   dependencies:
 331 |     anymatch "~3.1.1"
 332 |     braces "~3.0.2"
 333 |     glob-parent "~5.1.0"
 334 |     is-binary-path "~2.1.0"
 335 |     is-glob "~4.0.1"
 336 |     normalize-path "~3.0.0"
 337 |     readdirp "~3.2.0"
 338 |   optionalDependencies:
 339 |     fsevents "~2.1.1"
 340 | 
 341 | cliui@^5.0.0:
 342 |   version "5.0.0"
 343 |   resolved "https://registry.yarnpkg.com/cliui/-/cliui-5.0.0.tgz#deefcfdb2e800784aa34f46fa08e06851c7bbbc5"
 344 |   integrity sha512-PYeGSEmmHM6zvoef2w8TPzlrnNpXIjTipYK780YswmIP9vjxmd6Y2a3CB2Ks6/AU8NHjZugXvo8w3oWM2qnwXA==
 345 |   dependencies:
 346 |     string-width "^3.1.0"
 347 |     strip-ansi "^5.2.0"
 348 |     wrap-ansi "^5.1.0"
 349 | 
 350 | coffee-script@^1.12.7:
 351 |   version "1.12.7"
 352 |   resolved "https://registry.yarnpkg.com/coffee-script/-/coffee-script-1.12.7.tgz#c05dae0cb79591d05b3070a8433a98c9a89ccc53"
 353 |   integrity sha512-fLeEhqwymYat/MpTPUjSKHVYYl0ec2mOyALEMLmzr5i1isuG+6jfI2j2d5oBO3VIzgUXgBVIcOT9uH1TFxBckw==
 354 | 
 355 | color-convert@^1.9.0:
 356 |   version "1.9.3"
 357 |   resolved "https://registry.yarnpkg.com/color-convert/-/color-convert-1.9.3.tgz#bb71850690e1f136567de629d2d5471deda4c1e8"
 358 |   integrity sha512-QfAUtd+vFdAtFQcC8CCyYt1fYWxSqAiK2cSD6zDB8N3cpsEBAvRxp9zOGg6G/SHHJYAT88/az/IuDGALsNVbGg==
 359 |   dependencies:
 360 |     color-name "1.1.3"
 361 | 
 362 | color-name@1.1.3:
 363 |   version "1.1.3"
 364 |   resolved "https://registry.yarnpkg.com/color-name/-/color-name-1.1.3.tgz#a7d0558bd89c42f795dd42328f740831ca53bc25"
 365 |   integrity sha1-p9BVi9icQveV3UIyj3QIMcpTvCU=
 366 | 
 367 | commander@^4.1.0:
 368 |   version "4.1.0"
 369 |   resolved "https://registry.yarnpkg.com/commander/-/commander-4.1.0.tgz#545983a0603fe425bc672d66c9e3c89c42121a83"
 370 |   integrity sha512-NIQrwvv9V39FHgGFm36+U9SMQzbiHvU79k+iADraJTpmrFFfx7Ds0IvDoAdZsDrknlkRk14OYoWXb57uTh7/sw==
 371 | 
 372 | concat-map@0.0.1:
 373 |   version "0.0.1"
 374 |   resolved "https://registry.yarnpkg.com/concat-map/-/concat-map-0.0.1.tgz#d8a96bd77fd68df7793a73036a3ba0d5405d477b"
 375 |   integrity sha1-2Klr13/Wjfd5OnMDajug1UBdR3s=
 376 | 
 377 | convert-source-map@^1.7.0:
 378 |   version "1.7.0"
 379 |   resolved "https://registry.yarnpkg.com/convert-source-map/-/convert-source-map-1.7.0.tgz#17a2cb882d7f77d3490585e2ce6c524424a3a442"
 380 |   integrity sha512-4FJkXzKXEDB1snCFZlLP4gpC3JILicCpGbzG9f9G7tGqGCzETQ2hWPrcinA9oU4wtf2biUaEH5065UnMeR33oA==
 381 |   dependencies:
 382 |     safe-buffer "~5.1.1"
 383 | 
 384 | debug@3.2.6:
 385 |   version "3.2.6"
 386 |   resolved "https://registry.yarnpkg.com/debug/-/debug-3.2.6.tgz#e83d17de16d8a7efb7717edbe5fb10135eee629b"
 387 |   integrity sha512-mel+jf7nrtEl5Pn1Qx46zARXKDpBbvzezse7p7LqINmdoIk8PYP5SySaxEmYv6TZ0JyEKA1hsCId6DIhgITtWQ==
 388 |   dependencies:
 389 |     ms "^2.1.1"
 390 | 
 391 | debug@^4.1.0:
 392 |   version "4.1.1"
 393 |   resolved "https://registry.yarnpkg.com/debug/-/debug-4.1.1.tgz#3b72260255109c6b589cee050f1d516139664791"
 394 |   integrity sha512-pYAIzeRo8J6KPEaJ0VWOh5Pzkbw/RetuzehGM7QRRX5he4fPHx2rdKMB256ehJCkX+XRQm16eZLqLNS8RSZXZw==
 395 |   dependencies:
 396 |     ms "^2.1.1"
 397 | 
 398 | decamelize@^1.2.0:
 399 |   version "1.2.0"
 400 |   resolved "https://registry.yarnpkg.com/decamelize/-/decamelize-1.2.0.tgz#f6534d15148269b20352e7bee26f501f9a191290"
 401 |   integrity sha1-9lNNFRSCabIDUue+4m9QH5oZEpA=
 402 | 
 403 | deep-eql@^3.0.1:
 404 |   version "3.0.1"
 405 |   resolved "https://registry.yarnpkg.com/deep-eql/-/deep-eql-3.0.1.tgz#dfc9404400ad1c8fe023e7da1df1c147c4b444df"
 406 |   integrity sha512-+QeIQyN5ZuO+3Uk5DYh6/1eKO0m0YmJFGNmFHGACpf1ClL1nmlV/p4gNgbl2pJGxgXb4faqo6UE+M5ACEMyVcw==
 407 |   dependencies:
 408 |     type-detect "^4.0.0"
 409 | 
 410 | define-properties@^1.1.2, define-properties@^1.1.3:
 411 |   version "1.1.3"
 412 |   resolved "https://registry.yarnpkg.com/define-properties/-/define-properties-1.1.3.tgz#cf88da6cbee26fe6db7094f61d870cbd84cee9f1"
 413 |   integrity sha512-3MqfYKj2lLzdMSf8ZIZE/V+Zuy+BgD6f164e8K2w7dgnpKArBDerGYpM46IYYcjnkdPNMjPk9A6VFB8+3SKlXQ==
 414 |   dependencies:
 415 |     object-keys "^1.0.12"
 416 | 
 417 | diff@3.5.0:
 418 |   version "3.5.0"
 419 |   resolved "https://registry.yarnpkg.com/diff/-/diff-3.5.0.tgz#800c0dd1e0a8bfbc95835c202ad220fe317e5a12"
 420 |   integrity sha512-A46qtFgd+g7pDZinpnwiRJtxbC1hpgf0uzP3iG89scHk0AUC7A1TGxf5OiiOUv/JMZR8GOt8hL900hV0bOy5xA==
 421 | 
 422 | emoji-regex@^7.0.1:
 423 |   version "7.0.3"
 424 |   resolved "https://registry.yarnpkg.com/emoji-regex/-/emoji-regex-7.0.3.tgz#933a04052860c85e83c122479c4748a8e4c72156"
 425 |   integrity sha512-CwBLREIQ7LvYFB0WyRvwhq5N5qPhc6PMjD6bYggFlI5YyDgl+0vxq5VHbMOFqLg7hfWzmu8T5Z1QofhmTIhItA==
 426 | 
 427 | es-abstract@^1.17.0-next.1:
 428 |   version "1.17.0"
 429 |   resolved "https://registry.yarnpkg.com/es-abstract/-/es-abstract-1.17.0.tgz#f42a517d0036a5591dbb2c463591dc8bb50309b1"
 430 |   integrity sha512-yYkE07YF+6SIBmg1MsJ9dlub5L48Ek7X0qz+c/CPCHS9EBXfESorzng4cJQjJW5/pB6vDF41u7F8vUhLVDqIug==
 431 |   dependencies:
 432 |     es-to-primitive "^1.2.1"
 433 |     function-bind "^1.1.1"
 434 |     has "^1.0.3"
 435 |     has-symbols "^1.0.1"
 436 |     is-callable "^1.1.5"
 437 |     is-regex "^1.0.5"
 438 |     object-inspect "^1.7.0"
 439 |     object-keys "^1.1.1"
 440 |     object.assign "^4.1.0"
 441 |     string.prototype.trimleft "^2.1.1"
 442 |     string.prototype.trimright "^2.1.1"
 443 | 
 444 | es-to-primitive@^1.2.1:
 445 |   version "1.2.1"
 446 |   resolved "https://registry.yarnpkg.com/es-to-primitive/-/es-to-primitive-1.2.1.tgz#e55cd4c9cdc188bcefb03b366c736323fc5c898a"
 447 |   integrity sha512-QCOllgZJtaUo9miYBcLChTUaHNjJF3PYs1VidD7AwiEj1kYxKeQTctLAezAOH5ZKRH0g2IgPn6KwB4IT8iRpvA==
 448 |   dependencies:
 449 |     is-callable "^1.1.4"
 450 |     is-date-object "^1.0.1"
 451 |     is-symbol "^1.0.2"
 452 | 
 453 | escape-string-regexp@1.0.5, escape-string-regexp@^1.0.5:
 454 |   version "1.0.5"
 455 |   resolved "https://registry.yarnpkg.com/escape-string-regexp/-/escape-string-regexp-1.0.5.tgz#1b61c0562190a8dff6ae3bb2cf0200ca130b86d4"
 456 |   integrity sha1-G2HAViGQqN/2rjuyzwIAyhMLhtQ=
 457 | 
 458 | esprima@^4.0.0, esprima@~4.0.0:
 459 |   version "4.0.1"
 460 |   resolved "https://registry.yarnpkg.com/esprima/-/esprima-4.0.1.tgz#13b04cdb3e6c5d19df91ab6987a8695619b0aa71"
 461 |   integrity sha512-eGuFFw7Upda+g4p+QHvnW0RyTX/SVeJBDM/gCtMARO0cLuT2HcEKnTPvhjV6aGeqrCB/sbNop0Kszm0jsaWU4A==
 462 | 
 463 | esutils@^2.0.2:
 464 |   version "2.0.3"
 465 |   resolved "https://registry.yarnpkg.com/esutils/-/esutils-2.0.3.tgz#74d2eb4de0b8da1293711910d50775b9b710ef64"
 466 |   integrity sha512-kVscqXk4OCp68SZ0dkgEKVi6/8ij300KBWTJq32P/dYeWTSwK41WyTxalN1eRmA5Z9UU/LX9D7FWSmV9SAYx6g==
 467 | 
 468 | fill-range@^7.0.1:
 469 |   version "7.0.1"
 470 |   resolved "https://registry.yarnpkg.com/fill-range/-/fill-range-7.0.1.tgz#1919a6a7c75fe38b2c7c77e5198535da9acdda40"
 471 |   integrity sha512-qOo9F+dMUmC2Lcb4BbVvnKJxTPjCm+RRpe4gDuGrzkL7mEVl/djYSu2OdQ2Pa302N4oqkSg9ir6jaLWJ2USVpQ==
 472 |   dependencies:
 473 |     to-regex-range "^5.0.1"
 474 | 
 475 | find-up@3.0.0, find-up@^3.0.0:
 476 |   version "3.0.0"
 477 |   resolved "https://registry.yarnpkg.com/find-up/-/find-up-3.0.0.tgz#49169f1d7993430646da61ecc5ae355c21c97b73"
 478 |   integrity sha512-1yD6RmLI1XBfxugvORwlck6f75tYL+iR0jqwsOrOxMZyGYqUuDhJ0l4AXdO1iX/FTs9cBAMEk1gWSEx1kSbylg==
 479 |   dependencies:
 480 |     locate-path "^3.0.0"
 481 | 
 482 | flat@^4.1.0:
 483 |   version "4.1.0"
 484 |   resolved "https://registry.yarnpkg.com/flat/-/flat-4.1.0.tgz#090bec8b05e39cba309747f1d588f04dbaf98db2"
 485 |   integrity sha512-Px/TiLIznH7gEDlPXcUD4KnBusa6kR6ayRUVcnEAbreRIuhkqow/mun59BuRXwoYk7ZQOLW1ZM05ilIvK38hFw==
 486 |   dependencies:
 487 |     is-buffer "~2.0.3"
 488 | 
 489 | fs.realpath@^1.0.0:
 490 |   version "1.0.0"
 491 |   resolved "https://registry.yarnpkg.com/fs.realpath/-/fs.realpath-1.0.0.tgz#1504ad2523158caa40db4a2787cb01411994ea4f"
 492 |   integrity sha1-FQStJSMVjKpA20onh8sBQRmU6k8=
 493 | 
 494 | fsevents@~2.1.1:
 495 |   version "2.1.2"
 496 |   resolved "https://registry.yarnpkg.com/fsevents/-/fsevents-2.1.2.tgz#4c0a1fb34bc68e543b4b82a9ec392bfbda840805"
 497 |   integrity sha512-R4wDiBwZ0KzpgOWetKDug1FZcYhqYnUYKtfZYt4mD5SBz76q0KR4Q9o7GIPamsVPGmW3EYPPJ0dOOjvx32ldZA==
 498 | 
 499 | function-bind@^1.1.1:
 500 |   version "1.1.1"
 501 |   resolved "https://registry.yarnpkg.com/function-bind/-/function-bind-1.1.1.tgz#a56899d3ea3c9bab874bb9773b7c5ede92f4895d"
 502 |   integrity sha512-yIovAzMX49sF8Yl58fSCWJ5svSLuaibPxXQJFLmBObTuCr0Mf1KiPopGM9NiFjiYBCbfaa2Fh6breQ6ANVTI0A==
 503 | 
 504 | get-caller-file@^2.0.1:
 505 |   version "2.0.5"
 506 |   resolved "https://registry.yarnpkg.com/get-caller-file/-/get-caller-file-2.0.5.tgz#4f94412a82db32f36e3b0b9741f8a97feb031f7e"
 507 |   integrity sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==
 508 | 
 509 | get-func-name@^2.0.0:
 510 |   version "2.0.2"
 511 |   resolved "https://registry.yarnpkg.com/get-func-name/-/get-func-name-2.0.2.tgz#0d7cf20cd13fda808669ffa88f4ffc7a3943fc41"
 512 |   integrity sha512-8vXOvuE167CtIc3OyItco7N/dpRtBbYOsPsXCz7X/PMnlGjYjSGuZJgM1Y7mmew7BKf9BqvLX2tnOVy1BBUsxQ==
 513 | 
 514 | glob-parent@~5.1.0:
 515 |   version "5.1.2"
 516 |   resolved "https://registry.yarnpkg.com/glob-parent/-/glob-parent-5.1.2.tgz#869832c58034fe68a4093c17dc15e8340d8401c4"
 517 |   integrity sha512-AOIgSQCepiJYwP3ARnGx+5VnTu2HBYdzbGP45eLw1vr3zB3vZLeyed1sC9hnbcOc9/SrMyM5RPQrkGz4aS9Zow==
 518 |   dependencies:
 519 |     is-glob "^4.0.1"
 520 | 
 521 | glob@7.1.3:
 522 |   version "7.1.3"
 523 |   resolved "https://registry.yarnpkg.com/glob/-/glob-7.1.3.tgz#3960832d3f1574108342dafd3a67b332c0969df1"
 524 |   integrity sha512-vcfuiIxogLV4DlGBHIUOwI0IbrJ8HWPc4MU7HzviGeNho/UJDfi6B5p3sHeWIQ0KGIU0Jpxi5ZHxemQfLkkAwQ==
 525 |   dependencies:
 526 |     fs.realpath "^1.0.0"
 527 |     inflight "^1.0.4"
 528 |     inherits "2"
 529 |     minimatch "^3.0.4"
 530 |     once "^1.3.0"
 531 |     path-is-absolute "^1.0.0"
 532 | 
 533 | glob@^7.1.6:
 534 |   version "7.1.6"
 535 |   resolved "https://registry.yarnpkg.com/glob/-/glob-7.1.6.tgz#141f33b81a7c2492e125594307480c46679278a6"
 536 |   integrity sha512-LwaxwyZ72Lk7vZINtNNrywX0ZuLyStrdDtabefZKAY5ZGJhVtgdznluResxNmPitE0SAO+O26sWTHeKSI2wMBA==
 537 |   dependencies:
 538 |     fs.realpath "^1.0.0"
 539 |     inflight "^1.0.4"
 540 |     inherits "2"
 541 |     minimatch "^3.0.4"
 542 |     once "^1.3.0"
 543 |     path-is-absolute "^1.0.0"
 544 | 
 545 | globals@^11.1.0:
 546 |   version "11.12.0"
 547 |   resolved "https://registry.yarnpkg.com/globals/-/globals-11.12.0.tgz#ab8795338868a0babd8525758018c2a7eb95c42e"
 548 |   integrity sha512-WOBp/EEGUiIsJSp7wcv/y6MO+lV9UoncWqxuFfm8eBwzWNgyfBd6Gz+IeKQ9jCmyhoH99g15M3T+QaVHFjizVA==
 549 | 
 550 | growl@1.10.5:
 551 |   version "1.10.5"
 552 |   resolved "https://registry.yarnpkg.com/growl/-/growl-1.10.5.tgz#f2735dc2283674fa67478b10181059355c369e5e"
 553 |   integrity sha512-qBr4OuELkhPenW6goKVXiv47US3clb3/IbuWF9KNKEijAy9oeHxU9IgzjvJhHkUzhaj7rOUD7+YGWqUjLp5oSA==
 554 | 
 555 | has-flag@^3.0.0:
 556 |   version "3.0.0"
 557 |   resolved "https://registry.yarnpkg.com/has-flag/-/has-flag-3.0.0.tgz#b5d454dc2199ae225699f3467e5a07f3b955bafd"
 558 |   integrity sha1-tdRU3CGZriJWmfNGfloH87lVuv0=
 559 | 
 560 | has-symbols@^1.0.0, has-symbols@^1.0.1:
 561 |   version "1.0.1"
 562 |   resolved "https://registry.yarnpkg.com/has-symbols/-/has-symbols-1.0.1.tgz#9f5214758a44196c406d9bd76cebf81ec2dd31e8"
 563 |   integrity sha512-PLcsoqu++dmEIZB+6totNFKq/7Do+Z0u4oT0zKOJNl3lYK6vGwwu2hjHs+68OEZbTjiUE9bgOABXbP/GvrS0Kg==
 564 | 
 565 | has@^1.0.3:
 566 |   version "1.0.3"
 567 |   resolved "https://registry.yarnpkg.com/has/-/has-1.0.3.tgz#722d7cbfc1f6aa8241f16dd814e011e1f41e8796"
 568 |   integrity sha512-f2dvO0VU6Oej7RkWJGrehjbzMAjFp5/VKPp5tTpWIV4JHHZK1/BxbFRtf/siA2SWTe09caDmVtYYzWEIbBS4zw==
 569 |   dependencies:
 570 |     function-bind "^1.1.1"
 571 | 
 572 | he@1.2.0:
 573 |   version "1.2.0"
 574 |   resolved "https://registry.yarnpkg.com/he/-/he-1.2.0.tgz#84ae65fa7eafb165fddb61566ae14baf05664f0f"
 575 |   integrity sha512-F/1DnUGPopORZi0ni+CvrCgHQ5FyEAHRLSApuYWMmrbSwoN2Mn/7k+Gl38gJnR7yyDZk6WLXwiGod1JOWNDKGw==
 576 | 
 577 | inflight@^1.0.4:
 578 |   version "1.0.6"
 579 |   resolved "https://registry.yarnpkg.com/inflight/-/inflight-1.0.6.tgz#49bd6331d7d02d0c09bc910a1075ba8165b56df9"
 580 |   integrity sha1-Sb1jMdfQLQwJvJEKEHW6gWW1bfk=
 581 |   dependencies:
 582 |     once "^1.3.0"
 583 |     wrappy "1"
 584 | 
 585 | inherits@2:
 586 |   version "2.0.4"
 587 |   resolved "https://registry.yarnpkg.com/inherits/-/inherits-2.0.4.tgz#0fa2c64f932917c3433a0ded55363aae37416b7c"
 588 |   integrity sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==
 589 | 
 590 | is-binary-path@~2.1.0:
 591 |   version "2.1.0"
 592 |   resolved "https://registry.yarnpkg.com/is-binary-path/-/is-binary-path-2.1.0.tgz#ea1f7f3b80f064236e83470f86c09c254fb45b09"
 593 |   integrity sha512-ZMERYes6pDydyuGidse7OsHxtbI7WVeUEozgR/g7rd0xUimYNlvZRE/K2MgZTjWy725IfelLeVcEM97mmtRGXw==
 594 |   dependencies:
 595 |     binary-extensions "^2.0.0"
 596 | 
 597 | is-buffer@~2.0.3:
 598 |   version "2.0.4"
 599 |   resolved "https://registry.yarnpkg.com/is-buffer/-/is-buffer-2.0.4.tgz#3e572f23c8411a5cfd9557c849e3665e0b290623"
 600 |   integrity sha512-Kq1rokWXOPXWuaMAqZiJW4XxsmD9zGx9q4aePabbn3qCRGedtH7Cm+zV8WETitMfu1wdh+Rvd6w5egwSngUX2A==
 601 | 
 602 | is-callable@^1.1.4, is-callable@^1.1.5:
 603 |   version "1.1.5"
 604 |   resolved "https://registry.yarnpkg.com/is-callable/-/is-callable-1.1.5.tgz#f7e46b596890456db74e7f6e976cb3273d06faab"
 605 |   integrity sha512-ESKv5sMCJB2jnHTWZ3O5itG+O128Hsus4K4Qh1h2/cgn2vbgnLSVqfV46AeJA9D5EeeLa9w81KUXMtn34zhX+Q==
 606 | 
 607 | is-date-object@^1.0.1:
 608 |   version "1.0.2"
 609 |   resolved "https://registry.yarnpkg.com/is-date-object/-/is-date-object-1.0.2.tgz#bda736f2cd8fd06d32844e7743bfa7494c3bfd7e"
 610 |   integrity sha512-USlDT524woQ08aoZFzh3/Z6ch9Y/EWXEHQ/AaRN0SkKq4t2Jw2R2339tSXmwuVoY7LLlBCbOIlx2myP/L5zk0g==
 611 | 
 612 | is-extglob@^2.1.1:
 613 |   version "2.1.1"
 614 |   resolved "https://registry.yarnpkg.com/is-extglob/-/is-extglob-2.1.1.tgz#a88c02535791f02ed37c76a1b9ea9773c833f8c2"
 615 |   integrity sha1-qIwCU1eR8C7TfHahueqXc8gz+MI=
 616 | 
 617 | is-fullwidth-code-point@^2.0.0:
 618 |   version "2.0.0"
 619 |   resolved "https://registry.yarnpkg.com/is-fullwidth-code-point/-/is-fullwidth-code-point-2.0.0.tgz#a3b30a5c4f199183167aaab93beefae3ddfb654f"
 620 |   integrity sha1-o7MKXE8ZkYMWeqq5O+764937ZU8=
 621 | 
 622 | is-glob@^4.0.1, is-glob@~4.0.1:
 623 |   version "4.0.1"
 624 |   resolved "https://registry.yarnpkg.com/is-glob/-/is-glob-4.0.1.tgz#7567dbe9f2f5e2467bc77ab83c4a29482407a5dc"
 625 |   integrity sha512-5G0tKtBTFImOqDnLB2hG6Bp2qcKEFduo4tZu9MT/H6NQv/ghhy30o55ufafxJ/LdH79LLs2Kfrn85TLKyA7BUg==
 626 |   dependencies:
 627 |     is-extglob "^2.1.1"
 628 | 
 629 | is-number@^7.0.0:
 630 |   version "7.0.0"
 631 |   resolved "https://registry.yarnpkg.com/is-number/-/is-number-7.0.0.tgz#7535345b896734d5f80c4d06c50955527a14f12b"
 632 |   integrity sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==
 633 | 
 634 | is-regex@^1.0.5:
 635 |   version "1.0.5"
 636 |   resolved "https://registry.yarnpkg.com/is-regex/-/is-regex-1.0.5.tgz#39d589a358bf18967f726967120b8fc1aed74eae"
 637 |   integrity sha512-vlKW17SNq44owv5AQR3Cq0bQPEb8+kF3UKZ2fiZNOWtztYE5i0CzCZxFDwO58qAOWtxdBRVO/V5Qin1wjCqFYQ==
 638 |   dependencies:
 639 |     has "^1.0.3"
 640 | 
 641 | is-symbol@^1.0.2:
 642 |   version "1.0.3"
 643 |   resolved "https://registry.yarnpkg.com/is-symbol/-/is-symbol-1.0.3.tgz#38e1014b9e6329be0de9d24a414fd7441ec61937"
 644 |   integrity sha512-OwijhaRSgqvhm/0ZdAcXNZt9lYdKFpcRDT5ULUuYXPoT794UNOdU+gpT6Rzo7b4V2HUl/op6GqY894AZwv9faQ==
 645 |   dependencies:
 646 |     has-symbols "^1.0.1"
 647 | 
 648 | isexe@^2.0.0:
 649 |   version "2.0.0"
 650 |   resolved "https://registry.yarnpkg.com/isexe/-/isexe-2.0.0.tgz#e8fbf374dc556ff8947a10dcb0572d633f2cfa10"
 651 |   integrity sha1-6PvzdNxVb/iUehDcsFctYz8s+hA=
 652 | 
 653 | js-tokens@^4.0.0:
 654 |   version "4.0.0"
 655 |   resolved "https://registry.yarnpkg.com/js-tokens/-/js-tokens-4.0.0.tgz#19203fb59991df98e3a287050d4647cdeaf32499"
 656 |   integrity sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==
 657 | 
 658 | js-yaml@3.13.1:
 659 |   version "3.13.1"
 660 |   resolved "https://registry.yarnpkg.com/js-yaml/-/js-yaml-3.13.1.tgz#aff151b30bfdfa8e49e05da22e7415e9dfa37847"
 661 |   integrity sha512-YfbcO7jXDdyj0DGxYVSlSeQNHbD7XPWvrVWeVUujrQEoZzWJIRrCPoyk6kL6IAjAG2IolMK4T0hNUe0HOUs5Jw==
 662 |   dependencies:
 663 |     argparse "^1.0.7"
 664 |     esprima "^4.0.0"
 665 | 
 666 | jsesc@^2.5.1:
 667 |   version "2.5.2"
 668 |   resolved "https://registry.yarnpkg.com/jsesc/-/jsesc-2.5.2.tgz#80564d2e483dacf6e8ef209650a67df3f0c283a4"
 669 |   integrity sha512-OYu7XEzjkCQ3C5Ps3QIZsQfNpqoJyZZA99wd9aWd05NCtC5pWOkShK2mkL6HXQR6/Cy2lbNdPlZBpuQHXE63gA==
 670 | 
 671 | json5@^2.1.0:
 672 |   version "2.2.3"
 673 |   resolved "https://registry.yarnpkg.com/json5/-/json5-2.2.3.tgz#78cd6f1a19bdc12b73db5ad0c61efd66c1e29283"
 674 |   integrity sha512-XmOWe7eyHYH14cLdVPoyg+GOH3rYX++KpzrylJwSW98t3Nk+U8XOl8FWKOgwtzdb8lXGf6zYwDUzeHMWfxasyg==
 675 | 
 676 | locate-path@^3.0.0:
 677 |   version "3.0.0"
 678 |   resolved "https://registry.yarnpkg.com/locate-path/-/locate-path-3.0.0.tgz#dbec3b3ab759758071b58fe59fc41871af21400e"
 679 |   integrity sha512-7AO748wWnIhNqAuaty2ZWHkQHRSNfPVIsPIfwEOWO22AmaoVrWavlOcMR5nzTLNYvp36X220/maaRsrec1G65A==
 680 |   dependencies:
 681 |     p-locate "^3.0.0"
 682 |     path-exists "^3.0.0"
 683 | 
 684 | lodash@^4.17.13, lodash@^4.17.15:
 685 |   version "4.17.21"
 686 |   resolved "https://registry.yarnpkg.com/lodash/-/lodash-4.17.21.tgz#679591c564c3bffaae8454cf0b3df370c3d6911c"
 687 |   integrity sha512-v2kDEe57lecTulaDIuNTPy3Ry4gLGJ6Z1O3vE1krgXZNrsQ+LFTGHVxVjcXPs17LhbZVGedAJv8XZ1tvj5FvSg==
 688 | 
 689 | log-symbols@2.2.0:
 690 |   version "2.2.0"
 691 |   resolved "https://registry.yarnpkg.com/log-symbols/-/log-symbols-2.2.0.tgz#5740e1c5d6f0dfda4ad9323b5332107ef6b4c40a"
 692 |   integrity sha512-VeIAFslyIerEJLXHziedo2basKbMKtTw3vfn5IzG0XTjhAVEJyNHnL2p7vc+wBDSdQuUpNw3M2u6xb9QsAY5Eg==
 693 |   dependencies:
 694 |     chalk "^2.0.1"
 695 | 
 696 | minimatch@3.0.4, minimatch@^3.0.4:
 697 |   version "3.0.4"
 698 |   resolved "https://registry.yarnpkg.com/minimatch/-/minimatch-3.0.4.tgz#5166e286457f03306064be5497e8dbb0c3d32083"
 699 |   integrity sha512-yJHVQEhyqPLUTgt9B83PXu6W3rx4MvvHvSUvToogpwoGDOUQ+yDrR0HRot+yOCdCO7u4hX3pWft6kWBBcqh0UA==
 700 |   dependencies:
 701 |     brace-expansion "^1.1.7"
 702 | 
 703 | minimist@0.0.8:
 704 |   version "0.0.8"
 705 |   resolved "https://registry.yarnpkg.com/minimist/-/minimist-0.0.8.tgz#857fcabfc3397d2625b8228262e86aa7a011b05d"
 706 |   integrity sha1-hX/Kv8M5fSYluCKCYuhqp6ARsF0=
 707 | 
 708 | mkdirp@0.5.1:
 709 |   version "0.5.1"
 710 |   resolved "https://registry.yarnpkg.com/mkdirp/-/mkdirp-0.5.1.tgz#30057438eac6cf7f8c4767f38648d6697d75c903"
 711 |   integrity sha1-MAV0OOrGz3+MR2fzhkjWaX11yQM=
 712 |   dependencies:
 713 |     minimist "0.0.8"
 714 | 
 715 | mocha@^7.0.0:
 716 |   version "7.0.0"
 717 |   resolved "https://registry.yarnpkg.com/mocha/-/mocha-7.0.0.tgz#c60d14bf3de9601f549b3ff5be657eb8381c54bf"
 718 |   integrity sha512-CirsOPbO3jU86YKjjMzFLcXIb5YiGLUrjrXFHoJ3e2z9vWiaZVCZQ2+gtRGMPWF+nFhN6AWwLM/juzAQ6KRkbA==
 719 |   dependencies:
 720 |     ansi-colors "3.2.3"
 721 |     browser-stdout "1.3.1"
 722 |     chokidar "3.3.0"
 723 |     debug "3.2.6"
 724 |     diff "3.5.0"
 725 |     escape-string-regexp "1.0.5"
 726 |     find-up "3.0.0"
 727 |     glob "7.1.3"
 728 |     growl "1.10.5"
 729 |     he "1.2.0"
 730 |     js-yaml "3.13.1"
 731 |     log-symbols "2.2.0"
 732 |     minimatch "3.0.4"
 733 |     mkdirp "0.5.1"
 734 |     ms "2.1.1"
 735 |     node-environment-flags "1.0.6"
 736 |     object.assign "4.1.0"
 737 |     strip-json-comments "2.0.1"
 738 |     supports-color "6.0.0"
 739 |     which "1.3.1"
 740 |     wide-align "1.1.3"
 741 |     yargs "13.3.0"
 742 |     yargs-parser "13.1.1"
 743 |     yargs-unparser "1.6.0"
 744 | 
 745 | ms@2.1.1:
 746 |   version "2.1.1"
 747 |   resolved "https://registry.yarnpkg.com/ms/-/ms-2.1.1.tgz#30a5864eb3ebb0a66f2ebe6d727af06a09d86e0a"
 748 |   integrity sha512-tgp+dl5cGk28utYktBsrFqA7HKgrhgPsg6Z/EfhWI4gl1Hwq8B/GmY/0oXZ6nF8hDVesS/FpnYaD/kOWhYQvyg==
 749 | 
 750 | ms@^2.1.1:
 751 |   version "2.1.2"
 752 |   resolved "https://registry.yarnpkg.com/ms/-/ms-2.1.2.tgz#d09d1f357b443f493382a8eb3ccd183872ae6009"
 753 |   integrity sha512-sGkPx+VjMtmA6MX27oA4FBFELFCZZ4S4XqeGOXCv68tT+jb3vk/RyaKWP0PTKyWtmLSM0b+adUTEvbs1PEaH2w==
 754 | 
 755 | node-environment-flags@1.0.6:
 756 |   version "1.0.6"
 757 |   resolved "https://registry.yarnpkg.com/node-environment-flags/-/node-environment-flags-1.0.6.tgz#a30ac13621f6f7d674260a54dede048c3982c088"
 758 |   integrity sha512-5Evy2epuL+6TM0lCQGpFIj6KwiEsGh1SrHUhTbNX+sLbBtjidPZFAnVK9y5yU1+h//RitLbRHTIMyxQPtxMdHw==
 759 |   dependencies:
 760 |     object.getownpropertydescriptors "^2.0.3"
 761 |     semver "^5.7.0"
 762 | 
 763 | normalize-path@^3.0.0, normalize-path@~3.0.0:
 764 |   version "3.0.0"
 765 |   resolved "https://registry.yarnpkg.com/normalize-path/-/normalize-path-3.0.0.tgz#0dcd69ff23a1c9b11fd0978316644a0388216a65"
 766 |   integrity sha512-6eZs5Ls3WtCisHWp9S2GUy8dqkpGi4BVSz3GaqiE6ezub0512ESztXUwUB6C6IKbQkY2Pnb/mD4WYojCRwcwLA==
 767 | 
 768 | object-inspect@^1.7.0:
 769 |   version "1.7.0"
 770 |   resolved "https://registry.yarnpkg.com/object-inspect/-/object-inspect-1.7.0.tgz#f4f6bd181ad77f006b5ece60bd0b6f398ff74a67"
 771 |   integrity sha512-a7pEHdh1xKIAgTySUGgLMx/xwDZskN1Ud6egYYN3EdRW4ZMPNEDUTF+hwy2LUC+Bl+SyLXANnwz/jyh/qutKUw==
 772 | 
 773 | object-keys@^1.0.11, object-keys@^1.0.12, object-keys@^1.1.1:
 774 |   version "1.1.1"
 775 |   resolved "https://registry.yarnpkg.com/object-keys/-/object-keys-1.1.1.tgz#1c47f272df277f3b1daf061677d9c82e2322c60e"
 776 |   integrity sha512-NuAESUOUMrlIXOfHKzD6bpPu3tYt3xvjNdRIQ+FeT0lNb4K8WR70CaDxhuNguS2XG+GjkyMwOzsN5ZktImfhLA==
 777 | 
 778 | object.assign@4.1.0, object.assign@^4.1.0:
 779 |   version "4.1.0"
 780 |   resolved "https://registry.yarnpkg.com/object.assign/-/object.assign-4.1.0.tgz#968bf1100d7956bb3ca086f006f846b3bc4008da"
 781 |   integrity sha512-exHJeq6kBKj58mqGyTQ9DFvrZC/eR6OwxzoM9YRoGBqrXYonaFyGiFMuc9VZrXf7DarreEwMpurG3dd+CNyW5w==
 782 |   dependencies:
 783 |     define-properties "^1.1.2"
 784 |     function-bind "^1.1.1"
 785 |     has-symbols "^1.0.0"
 786 |     object-keys "^1.0.11"
 787 | 
 788 | object.getownpropertydescriptors@^2.0.3:
 789 |   version "2.1.0"
 790 |   resolved "https://registry.yarnpkg.com/object.getownpropertydescriptors/-/object.getownpropertydescriptors-2.1.0.tgz#369bf1f9592d8ab89d712dced5cb81c7c5352649"
 791 |   integrity sha512-Z53Oah9A3TdLoblT7VKJaTDdXdT+lQO+cNpKVnya5JDe9uLvzu1YyY1yFDFrcxrlRgWrEFH0jJtD/IbuwjcEVg==
 792 |   dependencies:
 793 |     define-properties "^1.1.3"
 794 |     es-abstract "^1.17.0-next.1"
 795 | 
 796 | once@^1.3.0:
 797 |   version "1.4.0"
 798 |   resolved "https://registry.yarnpkg.com/once/-/once-1.4.0.tgz#583b1aa775961d4b113ac17d9c50baef9dd76bd1"
 799 |   integrity sha1-WDsap3WWHUsROsF9nFC6753Xa9E=
 800 |   dependencies:
 801 |     wrappy "1"
 802 | 
 803 | p-limit@^2.0.0:
 804 |   version "2.2.2"
 805 |   resolved "https://registry.yarnpkg.com/p-limit/-/p-limit-2.2.2.tgz#61279b67721f5287aa1c13a9a7fbbc48c9291b1e"
 806 |   integrity sha512-WGR+xHecKTr7EbUEhyLSh5Dube9JtdiG78ufaeLxTgpudf/20KqyMioIUZJAezlTIi6evxuoUs9YXc11cU+yzQ==
 807 |   dependencies:
 808 |     p-try "^2.0.0"
 809 | 
 810 | p-locate@^3.0.0:
 811 |   version "3.0.0"
 812 |   resolved "https://registry.yarnpkg.com/p-locate/-/p-locate-3.0.0.tgz#322d69a05c0264b25997d9f40cd8a891ab0064a4"
 813 |   integrity sha512-x+12w/To+4GFfgJhBEpiDcLozRJGegY+Ei7/z0tSLkMmxGZNybVMSfWj9aJn8Z5Fc7dBUNJOOVgPv2H7IwulSQ==
 814 |   dependencies:
 815 |     p-limit "^2.0.0"
 816 | 
 817 | p-try@^2.0.0:
 818 |   version "2.2.0"
 819 |   resolved "https://registry.yarnpkg.com/p-try/-/p-try-2.2.0.tgz#cb2868540e313d61de58fafbe35ce9004d5540e6"
 820 |   integrity sha512-R4nPAVTAU0B9D35/Gk3uJf/7XYbQcyohSKdvAxIRSNghFl4e71hVoGnBNQz9cWaXxO2I10KTC+3jMdvvoKw6dQ==
 821 | 
 822 | path-exists@^3.0.0:
 823 |   version "3.0.0"
 824 |   resolved "https://registry.yarnpkg.com/path-exists/-/path-exists-3.0.0.tgz#ce0ebeaa5f78cb18925ea7d810d7b59b010fd515"
 825 |   integrity sha1-zg6+ql94yxiSXqfYENe1mwEP1RU=
 826 | 
 827 | path-is-absolute@^1.0.0:
 828 |   version "1.0.1"
 829 |   resolved "https://registry.yarnpkg.com/path-is-absolute/-/path-is-absolute-1.0.1.tgz#174b9268735534ffbc7ace6bf53a5a9e1b5c5f5f"
 830 |   integrity sha1-F0uSaHNVNP+8es5r9TpanhtcX18=
 831 | 
 832 | path-parse@^1.0.6:
 833 |   version "1.0.7"
 834 |   resolved "https://registry.yarnpkg.com/path-parse/-/path-parse-1.0.7.tgz#fbc114b60ca42b30d9daf5858e4bd68bbedb6735"
 835 |   integrity sha512-LDJzPVEEEPR+y48z93A0Ed0yXb8pAByGWo/k5YYdYgpY2/2EsOsksJrq7lOHxryrVOn1ejG6oAp8ahvOIQD8sw==
 836 | 
 837 | pathval@^1.1.0:
 838 |   version "1.1.1"
 839 |   resolved "https://registry.yarnpkg.com/pathval/-/pathval-1.1.1.tgz#8534e77a77ce7ac5a2512ea21e0fdb8fcf6c3d8d"
 840 |   integrity sha512-Dp6zGqpTdETdR63lehJYPeIOqpiNBNtc7BpWSLrOje7UaIsE5aY92r/AunQA7rsXvet3lrJ3JnZX29UPTKXyKQ==
 841 | 
 842 | picomatch@^2.0.4:
 843 |   version "2.2.1"
 844 |   resolved "https://registry.yarnpkg.com/picomatch/-/picomatch-2.2.1.tgz#21bac888b6ed8601f831ce7816e335bc779f0a4a"
 845 |   integrity sha512-ISBaA8xQNmwELC7eOjqFKMESB2VIqt4PPDD0nsS95b/9dZXvVKOlz9keMSnoGGKcOHXfTvDD6WMaRoSc9UuhRA==
 846 | 
 847 | prettier@1.19.1:
 848 |   version "1.19.1"
 849 |   resolved "https://registry.yarnpkg.com/prettier/-/prettier-1.19.1.tgz#f7d7f5ff8a9cd872a7be4ca142095956a60797cb"
 850 |   integrity sha512-s7PoyDv/II1ObgQunCbB9PdLmUcBZcnWOcxDh7O0N/UwDEsHyqkW+Qh28jW+mVuCdx7gLB0BotYI1Y6uI9iyew==
 851 | 
 852 | private@^0.1.8:
 853 |   version "0.1.8"
 854 |   resolved "https://registry.yarnpkg.com/private/-/private-0.1.8.tgz#2381edb3689f7a53d653190060fcf822d2f368ff"
 855 |   integrity sha512-VvivMrbvd2nKkiG38qjULzlc+4Vx4wm/whI9pQD35YrARNnhxeiRktSOhSukRLFNlzg6Br/cJPet5J/u19r/mg==
 856 | 
 857 | readdirp@~3.2.0:
 858 |   version "3.2.0"
 859 |   resolved "https://registry.yarnpkg.com/readdirp/-/readdirp-3.2.0.tgz#c30c33352b12c96dfb4b895421a49fd5a9593839"
 860 |   integrity sha512-crk4Qu3pmXwgxdSgGhgA/eXiJAPQiX4GMOZZMXnqKxHX7TaoL+3gQVo/WeuAiogr07DpnfjIMpXXa+PAIvwPGQ==
 861 |   dependencies:
 862 |     picomatch "^2.0.4"
 863 | 
 864 | recast@^0.18.5:
 865 |   version "0.18.5"
 866 |   resolved "https://registry.yarnpkg.com/recast/-/recast-0.18.5.tgz#9d5adbc07983a3c8145f3034812374a493e0fe4d"
 867 |   integrity sha512-sD1WJrpLQAkXGyQZyGzTM75WJvyAd98II5CHdK3IYbt/cZlU0UzCRVU11nUFNXX9fBVEt4E9ajkMjBlUlG+Oog==
 868 |   dependencies:
 869 |     ast-types "0.13.2"
 870 |     esprima "~4.0.0"
 871 |     private "^0.1.8"
 872 |     source-map "~0.6.1"
 873 | 
 874 | require-directory@^2.1.1:
 875 |   version "2.1.1"
 876 |   resolved "https://registry.yarnpkg.com/require-directory/-/require-directory-2.1.1.tgz#8c64ad5fd30dab1c976e2344ffe7f792a6a6df42"
 877 |   integrity sha1-jGStX9MNqxyXbiNE/+f3kqam30I=
 878 | 
 879 | require-main-filename@^2.0.0:
 880 |   version "2.0.0"
 881 |   resolved "https://registry.yarnpkg.com/require-main-filename/-/require-main-filename-2.0.0.tgz#d0b329ecc7cc0f61649f62215be69af54aa8989b"
 882 |   integrity sha512-NKN5kMDylKuldxYLSUfrbo5Tuzh4hd+2E8NPPX02mZtn1VuREQToYe/ZdlJy+J3uCpfaiGF05e7B8W0iXbQHmg==
 883 | 
 884 | resolve@^1.14.2, resolve@^1.3.2:
 885 |   version "1.14.2"
 886 |   resolved "https://registry.yarnpkg.com/resolve/-/resolve-1.14.2.tgz#dbf31d0fa98b1f29aa5169783b9c290cb865fea2"
 887 |   integrity sha512-EjlOBLBO1kxsUxsKjLt7TAECyKW6fOh1VRkykQkKGzcBbjjPIxBqGh0jf7GJ3k/f5mxMqW3htMD3WdTUVtW8HQ==
 888 |   dependencies:
 889 |     path-parse "^1.0.6"
 890 | 
 891 | safe-buffer@~5.1.1:
 892 |   version "5.1.2"
 893 |   resolved "https://registry.yarnpkg.com/safe-buffer/-/safe-buffer-5.1.2.tgz#991ec69d296e0313747d59bdfd2b745c35f8828d"
 894 |   integrity sha512-Gd2UZBJDkXlY7GbJxfsE8/nvKkUEU1G38c1siN6QP6a9PT9MmHB8GnpscSmMJSoF8LOIrt8ud/wPtojys4G6+g==
 895 | 
 896 | semver@^5.4.1, semver@^5.7.0:
 897 |   version "5.7.2"
 898 |   resolved "https://registry.yarnpkg.com/semver/-/semver-5.7.2.tgz#48d55db737c3287cd4835e17fa13feace1c41ef8"
 899 |   integrity sha512-cBznnQ9KjJqU67B52RMC65CMarK2600WFnbkcaiwWq3xy/5haFJlshgnpjovMVJ+Hff49d8GEn0b87C5pDQ10g==
 900 | 
 901 | set-blocking@^2.0.0:
 902 |   version "2.0.0"
 903 |   resolved "https://registry.yarnpkg.com/set-blocking/-/set-blocking-2.0.0.tgz#045f9782d011ae9a6803ddd382b24392b3d890f7"
 904 |   integrity sha1-BF+XgtARrppoA93TgrJDkrPYkPc=
 905 | 
 906 | source-map@^0.5.0:
 907 |   version "0.5.7"
 908 |   resolved "https://registry.yarnpkg.com/source-map/-/source-map-0.5.7.tgz#8a039d2d1021d22d1ea14c80d8ea468ba2ef3fcc"
 909 |   integrity sha1-igOdLRAh0i0eoUyA2OpGi6LvP8w=
 910 | 
 911 | source-map@~0.6.1:
 912 |   version "0.6.1"
 913 |   resolved "https://registry.yarnpkg.com/source-map/-/source-map-0.6.1.tgz#74722af32e9614e9c287a8d0bbde48b5e2f1a263"
 914 |   integrity sha512-UjgapumWlbMhkBgzT7Ykc5YXUT46F0iKu8SGXq0bcwP5dz/h0Plj6enJqjz1Zbq2l5WaqYnrVbwWOWMyF3F47g==
 915 | 
 916 | sprintf-js@~1.0.2:
 917 |   version "1.0.3"
 918 |   resolved "https://registry.yarnpkg.com/sprintf-js/-/sprintf-js-1.0.3.tgz#04e6926f662895354f3dd015203633b857297e2c"
 919 |   integrity sha1-BOaSb2YolTVPPdAVIDYzuFcpfiw=
 920 | 
 921 | "string-width@^1.0.2 || 2":
 922 |   version "2.1.1"
 923 |   resolved "https://registry.yarnpkg.com/string-width/-/string-width-2.1.1.tgz#ab93f27a8dc13d28cac815c462143a6d9012ae9e"
 924 |   integrity sha512-nOqH59deCq9SRHlxq1Aw85Jnt4w6KvLKqWVik6oA9ZklXLNIOlqg4F2yrT1MVaTjAqvVwdfeZ7w7aCvJD7ugkw==
 925 |   dependencies:
 926 |     is-fullwidth-code-point "^2.0.0"
 927 |     strip-ansi "^4.0.0"
 928 | 
 929 | string-width@^3.0.0, string-width@^3.1.0:
 930 |   version "3.1.0"
 931 |   resolved "https://registry.yarnpkg.com/string-width/-/string-width-3.1.0.tgz#22767be21b62af1081574306f69ac51b62203961"
 932 |   integrity sha512-vafcv6KjVZKSgz06oM/H6GDBrAtz8vdhQakGjFIvNrHA6y3HCF1CInLy+QLq8dTJPQ1b+KDUqDFctkdRW44e1w==
 933 |   dependencies:
 934 |     emoji-regex "^7.0.1"
 935 |     is-fullwidth-code-point "^2.0.0"
 936 |     strip-ansi "^5.1.0"
 937 | 
 938 | string.prototype.trimleft@^2.1.1:
 939 |   version "2.1.1"
 940 |   resolved "https://registry.yarnpkg.com/string.prototype.trimleft/-/string.prototype.trimleft-2.1.1.tgz#9bdb8ac6abd6d602b17a4ed321870d2f8dcefc74"
 941 |   integrity sha512-iu2AGd3PuP5Rp7x2kEZCrB2Nf41ehzh+goo8TV7z8/XDBbsvc6HQIlUl9RjkZ4oyrW1XM5UwlGl1oVEaDjg6Ag==
 942 |   dependencies:
 943 |     define-properties "^1.1.3"
 944 |     function-bind "^1.1.1"
 945 | 
 946 | string.prototype.trimright@^2.1.1:
 947 |   version "2.1.1"
 948 |   resolved "https://registry.yarnpkg.com/string.prototype.trimright/-/string.prototype.trimright-2.1.1.tgz#440314b15996c866ce8a0341894d45186200c5d9"
 949 |   integrity sha512-qFvWL3/+QIgZXVmJBfpHmxLB7xsUXz6HsUmP8+5dRaC3Q7oKUv9Vo6aMCRZC1smrtyECFsIT30PqBJ1gTjAs+g==
 950 |   dependencies:
 951 |     define-properties "^1.1.3"
 952 |     function-bind "^1.1.1"
 953 | 
 954 | strip-ansi@^4.0.0:
 955 |   version "4.0.0"
 956 |   resolved "https://registry.yarnpkg.com/strip-ansi/-/strip-ansi-4.0.0.tgz#a8479022eb1ac368a871389b635262c505ee368f"
 957 |   integrity sha1-qEeQIusaw2iocTibY1JixQXuNo8=
 958 |   dependencies:
 959 |     ansi-regex "^3.0.0"
 960 | 
 961 | strip-ansi@^5.0.0, strip-ansi@^5.1.0, strip-ansi@^5.2.0:
 962 |   version "5.2.0"
 963 |   resolved "https://registry.yarnpkg.com/strip-ansi/-/strip-ansi-5.2.0.tgz#8c9a536feb6afc962bdfa5b104a5091c1ad9c0ae"
 964 |   integrity sha512-DuRs1gKbBqsMKIZlrffwlug8MHkcnpjs5VPmL1PAh+mA30U0DTotfDZ0d2UUsXpPmPmMMJ6W773MaA3J+lbiWA==
 965 |   dependencies:
 966 |     ansi-regex "^4.1.0"
 967 | 
 968 | strip-json-comments@2.0.1:
 969 |   version "2.0.1"
 970 |   resolved "https://registry.yarnpkg.com/strip-json-comments/-/strip-json-comments-2.0.1.tgz#3c531942e908c2697c0ec344858c286c7ca0a60a"
 971 |   integrity sha1-PFMZQukIwml8DsNEhYwobHygpgo=
 972 | 
 973 | supports-color@6.0.0:
 974 |   version "6.0.0"
 975 |   resolved "https://registry.yarnpkg.com/supports-color/-/supports-color-6.0.0.tgz#76cfe742cf1f41bb9b1c29ad03068c05b4c0e40a"
 976 |   integrity sha512-on9Kwidc1IUQo+bQdhi8+Tijpo0e1SS6RoGo2guUwn5vdaxw8RXOF9Vb2ws+ihWOmh4JnCJOvaziZWP1VABaLg==
 977 |   dependencies:
 978 |     has-flag "^3.0.0"
 979 | 
 980 | supports-color@^5.3.0:
 981 |   version "5.5.0"
 982 |   resolved "https://registry.yarnpkg.com/supports-color/-/supports-color-5.5.0.tgz#e2e69a44ac8772f78a1ec0b35b689df6530efc8f"
 983 |   integrity sha512-QjVjwdXIt408MIiAqCX4oUKsgU2EqAGzs2Ppkm4aQYbjm+ZEWEcW4SfFNTr4uMNZma0ey4f5lgLrkB0aX0QMow==
 984 |   dependencies:
 985 |     has-flag "^3.0.0"
 986 | 
 987 | to-fast-properties@^2.0.0:
 988 |   version "2.0.0"
 989 |   resolved "https://registry.yarnpkg.com/to-fast-properties/-/to-fast-properties-2.0.0.tgz#dc5e698cbd079265bc73e0377681a4e4e83f616e"
 990 |   integrity sha1-3F5pjL0HkmW8c+A3doGk5Og/YW4=
 991 | 
 992 | to-regex-range@^5.0.1:
 993 |   version "5.0.1"
 994 |   resolved "https://registry.yarnpkg.com/to-regex-range/-/to-regex-range-5.0.1.tgz#1648c44aae7c8d988a326018ed72f5b4dd0392e4"
 995 |   integrity sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==
 996 |   dependencies:
 997 |     is-number "^7.0.0"
 998 | 
 999 | type-detect@^4.0.0, type-detect@^4.0.5:
1000 |   version "4.0.8"
1001 |   resolved "https://registry.yarnpkg.com/type-detect/-/type-detect-4.0.8.tgz#7646fb5f18871cfbb7749e69bd39a6388eb7450c"
1002 |   integrity sha512-0fr/mIH1dlO+x7TlcMy+bIDqKPsw/70tVyeHW787goQjhmqaZe10uwLujubK9q9Lg6Fiho1KUKDYz0Z7k7g5/g==
1003 | 
1004 | which-module@^2.0.0:
1005 |   version "2.0.0"
1006 |   resolved "https://registry.yarnpkg.com/which-module/-/which-module-2.0.0.tgz#d9ef07dce77b9902b8a3a8fa4b31c3e3f7e6e87a"
1007 |   integrity sha1-2e8H3Od7mQK4o6j6SzHD4/fm6Ho=
1008 | 
1009 | which@1.3.1:
1010 |   version "1.3.1"
1011 |   resolved "https://registry.yarnpkg.com/which/-/which-1.3.1.tgz#a45043d54f5805316da8d62f9f50918d3da70b0a"
1012 |   integrity sha512-HxJdYWq1MTIQbJ3nw0cqssHoTNU267KlrDuGZ1WYlxDStUtKUhOaJmh112/TZmHxxUfuJqPXSOm7tDyas0OSIQ==
1013 |   dependencies:
1014 |     isexe "^2.0.0"
1015 | 
1016 | wide-align@1.1.3:
1017 |   version "1.1.3"
1018 |   resolved "https://registry.yarnpkg.com/wide-align/-/wide-align-1.1.3.tgz#ae074e6bdc0c14a431e804e624549c633b000457"
1019 |   integrity sha512-QGkOQc8XL6Bt5PwnsExKBPuMKBxnGxWWW3fU55Xt4feHozMUhdUMaBCk290qpm/wG5u/RSKzwdAC4i51YigihA==
1020 |   dependencies:
1021 |     string-width "^1.0.2 || 2"
1022 | 
1023 | wrap-ansi@^5.1.0:
1024 |   version "5.1.0"
1025 |   resolved "https://registry.yarnpkg.com/wrap-ansi/-/wrap-ansi-5.1.0.tgz#1fd1f67235d5b6d0fee781056001bfb694c03b09"
1026 |   integrity sha512-QC1/iN/2/RPVJ5jYK8BGttj5z83LmSKmvbvrXPNCLZSEb32KKVDJDl/MOt2N01qU2H/FkzEa9PKto1BqDjtd7Q==
1027 |   dependencies:
1028 |     ansi-styles "^3.2.0"
1029 |     string-width "^3.0.0"
1030 |     strip-ansi "^5.0.0"
1031 | 
1032 | wrappy@1:
1033 |   version "1.0.2"
1034 |   resolved "https://registry.yarnpkg.com/wrappy/-/wrappy-1.0.2.tgz#b5243d8f3ec1aa35f1364605bc0d1036e30ab69f"
1035 |   integrity sha1-tSQ9jz7BqjXxNkYFvA0QNuMKtp8=
1036 | 
1037 | y18n@^4.0.0:
1038 |   version "4.0.1"
1039 |   resolved "https://registry.yarnpkg.com/y18n/-/y18n-4.0.1.tgz#8db2b83c31c5d75099bb890b23f3094891e247d4"
1040 |   integrity sha512-wNcy4NvjMYL8gogWWYAO7ZFWFfHcbdbE57tZO8e4cbpj8tfUcwrwqSl3ad8HxpYWCdXcJUCeKKZS62Av1affwQ==
1041 | 
1042 | yargs-parser@13.1.1, yargs-parser@^13.1.1:
1043 |   version "13.1.1"
1044 |   resolved "https://registry.yarnpkg.com/yargs-parser/-/yargs-parser-13.1.1.tgz#d26058532aa06d365fe091f6a1fc06b2f7e5eca0"
1045 |   integrity sha512-oVAVsHz6uFrg3XQheFII8ESO2ssAf9luWuAd6Wexsu4F3OtIW0o8IribPXYrD4WC24LWtPrJlGy87y5udK+dxQ==
1046 |   dependencies:
1047 |     camelcase "^5.0.0"
1048 |     decamelize "^1.2.0"
1049 | 
1050 | yargs-unparser@1.6.0:
1051 |   version "1.6.0"
1052 |   resolved "https://registry.yarnpkg.com/yargs-unparser/-/yargs-unparser-1.6.0.tgz#ef25c2c769ff6bd09e4b0f9d7c605fb27846ea9f"
1053 |   integrity sha512-W9tKgmSn0DpSatfri0nx52Joq5hVXgeLiqR/5G0sZNDoLZFOr/xjBUDcShCOGNsBnEMNo1KAMBkTej1Hm62HTw==
1054 |   dependencies:
1055 |     flat "^4.1.0"
1056 |     lodash "^4.17.15"
1057 |     yargs "^13.3.0"
1058 | 
1059 | yargs@13.3.0, yargs@^13.3.0:
1060 |   version "13.3.0"
1061 |   resolved "https://registry.yarnpkg.com/yargs/-/yargs-13.3.0.tgz#4c657a55e07e5f2cf947f8a366567c04a0dedc83"
1062 |   integrity sha512-2eehun/8ALW8TLoIl7MVaRUrg+yCnenu8B4kBlRxj3GJGDKU1Og7sMXPNm1BYyM1DOJmTZ4YeN/Nwxv+8XJsUA==
1063 |   dependencies:
1064 |     cliui "^5.0.0"
1065 |     find-up "^3.0.0"
1066 |     get-caller-file "^2.0.1"
1067 |     require-directory "^2.1.1"
1068 |     require-main-filename "^2.0.0"
1069 |     set-blocking "^2.0.0"
1070 |     string-width "^3.0.0"
1071 |     which-module "^2.0.0"
1072 |     y18n "^4.0.0"
1073 |     yargs-parser "^13.1.1"
1074 | 


--------------------------------------------------------------------------------
/packages/eslint-config-hypothesis/.prettierrc:
--------------------------------------------------------------------------------
1 | {
2 |   "singleQuote": true,
3 |   "trailingComma": "es5"
4 | }
5 | 


--------------------------------------------------------------------------------
/packages/eslint-config-hypothesis/CHANGELOG.md:
--------------------------------------------------------------------------------
 1 | # Changelog
 2 | 
 3 | All notable changes to this project will be documented in this file.
 4 | 
 5 | The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 6 | and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 7 | 
 8 | ## [v3.3.1] - 2025-05-06
 9 | 
10 | - Improve eslint config for tests [#61](https://github.com/hypothesis/frontend-toolkit/pull/61)
11 | 
12 | ## [v3.3.0] - 2025-05-06
13 | 
14 | - Replace `eslint-plugin-mocha` with `@vitest/eslint-plugin` [#60](https://github.com/hypothesis/frontend-toolkit/pull/60)
15 | 
16 | ## [v3.2.0] - 2025-02-17
17 | 
18 | - Disable `react/no-unknown-property` rule in favor of TypeScript [#58](https://github.com/hypothesis/frontend-toolkit/pull/58)
19 | 
20 | ## [v3.1.0] - 2024-10-18
21 | 
22 | - Add new `/base`, `/ts` and `/jsx` entry points with more granular ESLint configuration [#54](https://github.com/hypothesis/frontend-toolkit/pull/54)
23 | 
24 | ## [v3.0.0] - 2024-10-16
25 | 
26 | - Migrate to ESLint flat config and support ESLint 9 [#50](https://github.com/hypothesis/frontend-toolkit/pull/50)
27 | 
28 | ## [v2.6.0] - 2022-07-20
29 | 
30 | - Assume use of JSX runtime [#42](https://github.com/hypothesis/frontend-toolkit/pull/42)
31 | 
32 | ## [v2.5.0] - 2021-05-05
33 | 
34 | ### Changed
35 | 
36 | - Update to ES 2021 [#31](https://github.com/hypothesis/frontend-toolkit/pull/31)
37 | 
38 | 


--------------------------------------------------------------------------------
/packages/eslint-config-hypothesis/README.md:
--------------------------------------------------------------------------------
 1 | # eslint-config-hypothesis
 2 | 
 3 | A [shareable ESLint configuration](https://eslint.org/docs/developer-guide/shareable-configs)
 4 | for Hypothesis frontend projects.
 5 | 
 6 | To use it:
 7 | 
 8 | 1. Add `eslint-config-hypothesis` as a dependency to your project
 9 | 2. Add the config's peer dependencies (see `peerDependencies` in `package.json`)
10 |    to your project's dependencies. Some of them are required only for some
11 |    entry points.
12 | 3. Add an ESLint config file to the repository which extends the desired
13 |    "hypothesis" config. For example, a `eslint.config.js` file with the
14 |    following content:
15 |    ```js
16 |    import hypothesisBase from 'eslint-config-hypothesis/base';
17 |    import hypothesisTS from 'eslint-config-hypothesis/ts';
18 |    import hypothesisJSX from 'eslint-config-hypothesis/jsx';
19 |    
20 |    export default [
21 |     ...hypothesisBase,
22 |     ...hypothesisTS, // Optionally add this if the project uses TypeScript
23 |     ...hypothesisJSX, // Optionally add this if the project uses JSX
24 |     {
25 |       // Other project config
26 |     },
27 |    ];
28 |    ```
29 | 
30 | ## Rule notes
31 | 
32 | - In `/base` entry point, all `recommended` rules from `@eslint/js` are enabled
33 |   and the config assumes that you are using mocha for tests
34 | - In `/jsx` entry point, all `react.recommended`, `react.jsx-runtime`,
35 |   `react-hooks` and `jsx-a11y.recommended` rules are enabled, assuming
36 |   React/Preact is used for any interactive UI
37 | - In `/ts` entry point, all `typescript-eslint.recommended` rules are enabled
38 | - All rules are configured to produce errors and not warnings. This is based on
39 |   the principle that an issue is either worth fixing or should be ignored, and
40 |   warnings just add noise
41 | - Code formatting rules that are obsoleted by automated formatters are disabled.
42 |   You should [*use Prettier*](https://prettier.io) to auto-format code.
43 | 


--------------------------------------------------------------------------------
/packages/eslint-config-hypothesis/base.js:
--------------------------------------------------------------------------------
 1 | import eslint from '@eslint/js';
 2 | import vitest from '@vitest/eslint-plugin';
 3 | import { defineConfig } from 'eslint/config';
 4 | import globals from 'globals';
 5 | 
 6 | export default defineConfig(
 7 |   eslint.configs.recommended,
 8 |   {
 9 |     rules: {
10 |       // Standard ESLint rules.
11 |       //
12 |       // See https://eslint.org/docs/rules/.
13 |       //
14 |       // Stylistic rules are omitted for things that are handled automatically
15 |       // by Prettier.
16 |       'array-callback-return': 'error',
17 |       'block-scoped-var': 'error',
18 |       'consistent-this': ['error', 'self'],
19 |       'consistent-return': 'error',
20 |       curly: 'error',
21 |       'dot-notation': 'error',
22 |       eqeqeq: 'error',
23 |       'guard-for-in': 'error',
24 |       'new-cap': 'error',
25 |       'no-caller': 'error',
26 |       'no-case-declarations': 'error',
27 |       'no-console': ['error', { allow: ['warn', 'error'] }],
28 |       'no-extra-bind': 'error',
29 |       'no-lone-blocks': 'error',
30 |       'no-lonely-if': 'error',
31 |       'no-self-compare': 'error',
32 |       'no-throw-literal': 'error',
33 |       'no-undef-init': 'error',
34 |       'no-unneeded-ternary': 'error',
35 |       'no-unused-expressions': 'error',
36 |       'no-useless-concat': 'error',
37 |       'one-var-declaration-per-line': ['error', 'always'],
38 |       'prefer-arrow-callback': ['error', { allowNamedFunctions: true }],
39 |       'prefer-const': ['error', { destructuring: 'all' }],
40 |       strict: ['error', 'safe'],
41 | 
42 |       // Stylistic rules about use of ES2015+ features.
43 |       //
44 |       // See https://eslint.org/docs/rules/#ecmascript-6
45 |       'no-var': 'error',
46 |     },
47 |     languageOptions: {
48 |       globals: {
49 |         ...globals.browser,
50 |         sinon: 'readonly',
51 |         assert: 'readonly',
52 |       }
53 |     },
54 |   },
55 | 
56 |   // Tests
57 |   {
58 |     files: ['**/*-test.js', '**/test/*.js'],
59 |     languageOptions: {
60 |       globals: {
61 |         ...vitest.environments.env.globals,
62 | 
63 |         // We use `context` instead of `define` in many cases, as it was
64 |         // available with Mocha, before Vitest was adopted and replaced it.
65 |         // However, every project is responsible for aliasing `define` to
66 |         // `context` itself, by doing something in the lines of
67 |         // `globalThis.context ??= globalThis.describe`
68 |         context: true,
69 |       },
70 |     }
71 |   }
72 | );
73 | 


--------------------------------------------------------------------------------
/packages/eslint-config-hypothesis/index.js:
--------------------------------------------------------------------------------
1 | import base from './base.js'
2 | import react from './react.js'
3 | 
4 | export default [
5 |   ...base,
6 |   ...react,
7 | ];
8 | 


--------------------------------------------------------------------------------
/packages/eslint-config-hypothesis/jsx.js:
--------------------------------------------------------------------------------
1 | import jsxA11y from 'eslint-plugin-jsx-a11y';
2 | import react from './react.js';
3 | 
4 | export default [
5 |   ...react,
6 |   jsxA11y.flatConfigs.recommended,
7 | ];
8 | 


--------------------------------------------------------------------------------
/packages/eslint-config-hypothesis/package.json:
--------------------------------------------------------------------------------
 1 | {
 2 |   "name": "eslint-config-hypothesis",
 3 |   "version": "3.3.1",
 4 |   "type": "module",
 5 |   "description": "A base ESLint configuration for Hypothesis projects",
 6 |   "homepage": "https://hypothes.is",
 7 |   "bugs": "https://github.com/hypothesis/frontend-toolkit/issues",
 8 |   "repository": "hypothesis/frontend-toolkit",
 9 |   "main": "index.js",
10 |   "scripts": {
11 |     "test": "echo \"Warning: no test specified\" && exit 0"
12 |   },
13 |   "exports": {
14 |     ".": {
15 |       "import": "./index.js"
16 |     },
17 |     "./base": {
18 |       "import": "./base.js"
19 |     },
20 |     "./jsx": {
21 |       "import": "./jsx.js"
22 |     },
23 |     "./ts": {
24 |       "import": "./ts.js"
25 |     }
26 |   },
27 |   "devDependencies": {
28 |     "@vitest/eslint-plugin": "^1.1.43",
29 |     "eslint": "^9.12.0",
30 |     "eslint-plugin-jsx-a11y": "^6.10.0",
31 |     "eslint-plugin-react": "^7.34.3",
32 |     "eslint-plugin-react-hooks": "^5.0.0",
33 |     "globals": "^15.11.0",
34 |     "typescript-eslint": "^8.10.0"
35 |   },
36 |   "peerDependencies": {
37 |     "@vitest/eslint-plugin": ">=1.1.43",
38 |     "eslint-plugin-jsx-a11y": ">=6.10.0",
39 |     "eslint-plugin-react": ">=7.34.0",
40 |     "eslint-plugin-react-hooks": ">=5.0.0",
41 |     "globals": ">=15.11.0",
42 |     "typescript-eslint": ">=8.10.0"
43 |   },
44 |   "peerDependenciesMeta": {
45 |     "eslint-plugin-jsx-a11y": {
46 |       "optional": true
47 |     },
48 |     "eslint-plugin-react": {
49 |       "optional": true
50 |     },
51 |     "eslint-plugin-react-hooks": {
52 |       "optional": true
53 |     },
54 |     "typescript-eslint": {
55 |       "optional": true
56 |     }
57 |   },
58 |   "keywords": [],
59 |   "author": "",
60 |   "license": "BSD-2-Clause"
61 | }
62 | 


--------------------------------------------------------------------------------
/packages/eslint-config-hypothesis/react.js:
--------------------------------------------------------------------------------
 1 | import react from 'eslint-plugin-react';
 2 | import reactHooks from 'eslint-plugin-react-hooks';
 3 | 
 4 | export default [
 5 |   react.configs.flat.recommended,
 6 |   react.configs.flat['jsx-runtime'],
 7 |   {
 8 |     plugins: {
 9 |       'react-hooks': reactHooks,
10 |     },
11 |     rules: {
12 |       // plugin:react/recommended rules
13 |       //
14 |       // See https://github.com/yannickcr/eslint-plugin-react#list-of-supported-rules
15 |       // and https://reactjs.org/docs/hooks-rules.html#eslint-plugin
16 |       'react/self-closing-comp': 'error',
17 |       'react-hooks/rules-of-hooks': 'error',
18 |       'react-hooks/exhaustive-deps': 'error',
19 | 
20 |       // Prop type checking is handled by TypeScript.
21 |       'react/no-unknown-property': 'off',
22 |       'react/prop-types': 'off',
23 |     },
24 |     languageOptions: {
25 |       parserOptions: {
26 |         ecmaFeatures: {
27 |           jsx: true,
28 |         },
29 |       },
30 |     },
31 |     settings: {
32 |       react: {
33 |         version: '18.0'
34 |       }
35 |     },
36 |   }
37 | ];
38 | 


--------------------------------------------------------------------------------
/packages/eslint-config-hypothesis/ts.js:
--------------------------------------------------------------------------------
 1 | import tseslint from 'typescript-eslint';
 2 | 
 3 | export default tseslint.config(
 4 |   ...tseslint.configs.recommended,
 5 |   {
 6 |     rules: {
 7 |       // Upgrade TS rules from warning to error.
 8 |       '@typescript-eslint/no-unused-vars': 'error',
 9 | 
10 |       // Disable TS rules that we dislike.
11 |       '@typescript-eslint/ban-ts-comment': 'off',
12 |       '@typescript-eslint/no-empty-function': 'off',
13 |       '@typescript-eslint/no-explicit-any': 'off',
14 |       '@typescript-eslint/no-non-null-assertion': 'off',
15 |       '@typescript-eslint/no-this-alias': 'off',
16 | 
17 |       // Enforce consistency in cases where TypeScript supports old and new
18 |       // syntaxes for the same thing.
19 |       //
20 |       // - Require `<var> as <type>` for casts
21 |       // - Require `import type` for type imports. The corresponding rule for
22 |       //   exports is not enabled yet because that requires setting up type-aware
23 |       //   linting.
24 |       '@typescript-eslint/consistent-type-assertions': 'error',
25 |       '@typescript-eslint/consistent-type-imports': 'error',
26 |     },
27 |   },
28 | );
29 | 


--------------------------------------------------------------------------------
/tools/print-change-list.py:
--------------------------------------------------------------------------------
  1 | #!/usr/bin/env python3
  2 | 
  3 | import argparse
  4 | import re
  5 | from subprocess import run
  6 | import textwrap
  7 | from os import getenv
  8 | from subprocess import PIPE
  9 | from sys import exit, stderr
 10 | 
 11 | import dateutil.parser
 12 | import requests
 13 | 
 14 | GITHUB_API_URL = 'https://api.github.com'
 15 | 
 16 | 
 17 | class PRInfo(object):
 18 |     def __init__(self, id, title):
 19 |         self.id = id
 20 |         self.title = title
 21 | 
 22 | 
 23 | def pr_link(repo, id):
 24 |     """Return a link to a GitHub Pull Request in markdown format"""
 25 | 
 26 |     return '[#{id}](https://github.com/{repo}/pull/{id})'.format(id=id, repo=repo)
 27 | 
 28 | 
 29 | def get_last_tag():
 30 |     proc = run(['git','tag','--list','--sort=-taggerdate'],
 31 |         stdout=PIPE)
 32 |     tags = proc.stdout.decode().splitlines()
 33 | 
 34 |     if tags:
 35 |         return tags[0]
 36 |     else:
 37 |         return None
 38 | 
 39 | 
 40 | def get_tag_date(tag):
 41 |     tag_date_result = run(['git', 'tag', '--list', tag, '--format=%(taggerdate)'],
 42 |         stdout=PIPE)
 43 |     tag_date_str = tag_date_result.stdout.decode().strip()
 44 |     return dateutil.parser.parse(tag_date_str)
 45 | 
 46 | 
 47 | def github_request(auth_token, repo, path, **kwargs):
 48 |     """
 49 |     Make a GitHub API request and return an iterator over items in the response.
 50 | 
 51 |     `github_request` follows `next` links in paged responses automatically.
 52 |     """
 53 |     params = kwargs
 54 |     url = '{}/repos/{}/{}'.format(GITHUB_API_URL, repo, path)
 55 |     headers = {}
 56 |     if auth_token:
 57 |         headers['Authorization'] = 'token {}'.format(auth_token)
 58 | 
 59 |     while url:
 60 |         res = requests.get(url, headers=headers, params=params)
 61 |         if res.status_code != 200:
 62 |             raise Exception('GitHub request {} failed:'.format(url), res.text)
 63 | 
 64 |         page = res.json()
 65 |         if isinstance(page, list):
 66 |             for item in page:
 67 |                 yield item
 68 |             try:
 69 |                 url = res.links['next']['url']
 70 |             except KeyError:
 71 |                 url = None
 72 |             params = None
 73 |         else:
 74 |             yield page
 75 |             break
 76 | 
 77 | 
 78 | def get_prs_merged_since(auth_token, repo, tag):
 79 |     """
 80 |     Return all pull requests merged since `tag` was created.
 81 | 
 82 |     Pull requests are sorted in ascending order of merge date.
 83 |     """
 84 |     tag_date = get_tag_date(tag)
 85 |     prs = []
 86 | 
 87 |     def merge_date(pr):
 88 |         if pr.get('merged_at'):
 89 |             return dateutil.parser.parse(pr['merged_at'])
 90 |         else:
 91 |             return None
 92 | 
 93 |     # The GitHub API does not provide a `since` parameter to retrieve PRs
 94 |     # closed since a given date, so instead we iterate over PRs in descending
 95 |     # order of last update and stop when we reach a PR that was last updated
 96 |     # before the given tag was created.
 97 |     for closed_pr in github_request(auth_token, repo, 'pulls', state='closed',
 98 |                                     sort='updated', direction='desc'):
 99 |         pr_date = dateutil.parser.parse(closed_pr['updated_at'])
100 |         if pr_date < tag_date:
101 |             break
102 |         merged_at = merge_date(closed_pr)
103 |         if merged_at and merged_at > tag_date:
104 |             prs += [closed_pr]
105 | 
106 |     return sorted(prs, key=merge_date)
107 | 
108 | 
109 | def format_list(items):
110 |     def format_item(item, col_width):
111 |         formatted = ''
112 |         for line in iter(textwrap.wrap(item, col_width - 2)):
113 |             if len(formatted) == 0:
114 |                 formatted = formatted + '- ' + line
115 |             else:
116 |                 formatted = formatted + '\n  ' + line
117 |         return formatted
118 | 
119 |     return '\n\n'.join([format_item(item, 80) for item in items])
120 | 
121 | 
122 | def current_github_repo(remote='origin'):
123 |     """
124 |     Return the GitHub repository and organization associated with a Git remote.
125 | 
126 |     This function assumes that `remote` has a SSH or HTTPS URL containing
127 |     'github.com' and ending with '{org}/{repo}.git'.
128 |     """
129 | 
130 |     proc = run(['git', 'remote', 'get-url', remote], stdout=PIPE)
131 |     url = proc.stdout.strip().decode('utf-8')
132 | 
133 |     if 'github.com' in url:
134 |         match = re.search('([^:/]+)/([^/]+)\.git$', url)
135 |         org = match.group(1)
136 |         repo = match.group(2)
137 |         return (org, repo)
138 |     else:
139 |         return None
140 | 
141 |     
142 | def main():
143 |     parser = argparse.ArgumentParser(description=
144 | """
145 | Generates a list of changes since the last tag was created, in the format
146 | recommended by http://keepachangelog.com.
147 | """
148 | )
149 | 
150 |     current_repo = ''
151 |     try:
152 |         (org, repo) = current_github_repo()
153 |         current_repo = '{}/{}'.format(org, repo)
154 |     except TypeError:
155 |         pass
156 | 
157 |     parser.add_argument('--tag', default=get_last_tag(), help='The tag to list changes since')
158 |     parser.add_argument('--repo', default=current_repo, help='The GitHub repository to generate a change list for')
159 |     parser.add_argument('--token', default=getenv('GITHUB_TOKEN'), help='GitHub API access token')
160 |     args = parser.parse_args()
161 | 
162 |     if not args.repo:
163 |         print('Could not determine current GitHub repo. Use the --repo argument',file=stderr)
164 |         exit(1)
165 | 
166 |     if not args.tag:
167 |         print('Could not find last tag. Use the --tag argument', file=stderr)
168 |         exit(1)
169 | 
170 |     pr_details = []
171 |     for pr in get_prs_merged_since(args.token, args.repo, args.tag):
172 |         pr_details += [PRInfo(pr['number'], title=pr['title'].strip())]
173 | 
174 |     def item_label(pr):
175 |         return '{} ({}).'.format(pr.title, pr_link(args.repo, pr.id))
176 | 
177 |     print("""
178 | ****
179 | Changes since {repo} {tag}:
180 | 
181 | Please edit the output below before including it in the change log.
182 | See http://keepachangelog.com for further advice.
183 | 
184 | Only include changes which are interesting to users of the package or
185 | application, and use a description they will be able to understand.
186 | ****
187 | 
188 | ## [Unreleased]
189 | 
190 | ### Changed
191 | """.format(repo=args.repo, tag=args.tag))
192 |     print(format_list([item_label(pr) for pr in pr_details]))
193 | 
194 | 
195 | if __name__ == '__main__':
196 |     main()
197 | 


--------------------------------------------------------------------------------
/tools/requirements.txt:
--------------------------------------------------------------------------------
1 | python-dateutil
2 | requests
3 | 


--------------------------------------------------------------------------------