@nypl/design-system-react-components 2.0.0-rc8 → 2.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +13 -8
- package/dist/design-system-react-components.cjs +73 -119
- package/dist/design-system-react-components.js +18340 -22172
- package/dist/src/index.d.ts +0 -7
- package/package.json +2 -2
- package/dist/src/components/FilterBar/FilterBar.d.ts +0 -61
- package/dist/src/components/MultiSelect/MultiSelect.d.ts +0 -61
- package/dist/src/components/MultiSelect/MultiSelectDialog.d.ts +0 -8
- package/dist/src/components/MultiSelect/MultiSelectListbox.d.ts +0 -9
- package/dist/src/components/MultiSelect/MultiSelectMenuButton.d.ts +0 -27
- package/dist/src/components/MultiSelectGroup/MultiSelectGroup.d.ts +0 -28
- package/dist/src/hooks/useFilterBar.d.ts +0 -21
- package/dist/src/hooks/useMultiSelect.d.ts +0 -15
package/README.md
CHANGED
|
@@ -8,8 +8,9 @@ The Reservoir Design System (DS) is NYPL’s open-source extensible React librar
|
|
|
8
8
|
|
|
9
9
|
Storybook documentation
|
|
10
10
|
|
|
11
|
-
- [Production - deployed to Github Pages](https://nypl.github.io/nypl-design-system/reservoir/
|
|
11
|
+
- [V2 Production - deployed to Github Pages](https://nypl.github.io/nypl-design-system/reservoir/v2/?path=/docs/welcome--docs)
|
|
12
12
|
- [Development/QA - deployed to Vercel](https://nypl-design-system.vercel.app/?path=/docs/welcome--docs)
|
|
13
|
+
- [V1 Production - deployed to Vercel](https://nypl-design-system-git-reservoir-v173-nypl.vercel.app/)
|
|
13
14
|
|
|
14
15
|
| Table of Contents | |
|
|
15
16
|
| ----------------- | ----------------------------------------------------------------------------------- |
|
|
@@ -138,21 +139,21 @@ The list of re-exported Chakra components can be found in the main [index.ts](/s
|
|
|
138
139
|
Find more information about the Design System's internal use of Chakra to create and refactor components in the Storybook documentation page. The following two links have the same information but in different formats for your reading preference:
|
|
139
140
|
|
|
140
141
|
- [MDX format](/src/docs/Chakra.stories.mdx)
|
|
141
|
-
- [Storybook page](https://nypl.github.io/nypl-design-system/reservoir/
|
|
142
|
+
- [Storybook page](https://nypl.github.io/nypl-design-system/reservoir/v2/?path=/docs/chakra-ui--docs)
|
|
142
143
|
|
|
143
144
|
Chakra was integrated into the Design System in version `0.25.0`. For those looking to update to a version greater than or equal `0.25.0`, check out our [Chakra Migration Guide](/CHAKRA_MIGRATION_GUIDE.md).
|
|
144
145
|
|
|
145
146
|
## Storybook
|
|
146
147
|
|
|
147
|
-
The Reservoir Design System leverages Storybook to document all the React components and style guidelines. The Storybook documentation can be found [
|
|
148
|
+
The Reservoir Design System leverages Storybook to document all the React components and style guidelines. The Storybook documentation for version 2.x can be found [on Github Pages](https://nypl.github.io/nypl-design-system/reservoir/v2/?path=/docs/welcome--docs). For your convenience, the Reservoir Design System components have been organized into logical categories based on both form and function. Please refer to the COMPONENTS section in the Storybook sidebar.
|
|
148
149
|
|
|
149
150
|
### Documentation Instances
|
|
150
151
|
|
|
151
|
-
There are currently
|
|
152
|
+
There are currently three main instances of the Reservoir Design System Storybook documentation. There are also "preview" sites that are used to quickly and easily view pull request changes.
|
|
152
153
|
|
|
153
154
|
**Production**
|
|
154
155
|
|
|
155
|
-
The production Storybook documentation is deployed to [Github Pages](https://nypl.github.io/nypl-design-system/reservoir/
|
|
156
|
+
The production Storybook documentation for DS version 2.x is deployed to [Github Pages](https://nypl.github.io/nypl-design-system/reservoir/v2/?path=/docs/welcome--docs). This is the main instance we use to share the latest stable release of the Reservoir Design System. This documentation site is deployed through [Github Actions](/.github/workflows/gh-pages.yml) only on merges to the `release` and `gh-pages` branches.
|
|
156
157
|
|
|
157
158
|
As of July, 2021, the Github Pages production site gets deployed every two weeks on the same schedule as npm releases.
|
|
158
159
|
|
|
@@ -160,6 +161,10 @@ As of July, 2021, the Github Pages production site gets deployed every two weeks
|
|
|
160
161
|
|
|
161
162
|
The development Storybook documentation is deployed to [Vercel](https://nypl-design-system.vercel.app/?path=/docs/welcome--docs). This development site has all the working updates that get merged to the `development` branch. This means that this site is constantly being updated as pull requests are being merged in. This site is used to see the lastest changes during a working sprint before a production release is made.
|
|
162
163
|
|
|
164
|
+
**Version 1.x**
|
|
165
|
+
|
|
166
|
+
The Storybook documentation for DS version 1.x is deployed to [Vercel](https://nypl-design-system-git-reservoir-v173-nypl.vercel.app/). If you are using a DS version less than 2.0, this is the Storybook documentation you should be referencing. While the DS team will continue to support version 1.x, we will not be adding new features or components to this version. We highly recommend updating to version 2.x for design update and bug fixes.
|
|
167
|
+
|
|
163
168
|
**Preview Sites**
|
|
164
169
|
|
|
165
170
|
Preview Storybook documentation sites are deployed to Vercel on every commit push to every branch in this repository. They follow a pattern such as `nypl-design-system-[hash]-nypl.vercel.app` where `[hash]` is a random hash created by Vercel. This means that the URL varies and that those instances are eventually shut off. They are not meant to be used as long-term sites but rather for reviewing working changes within the team.
|
|
@@ -191,13 +196,13 @@ To help consuming application developers understand which version of the DS is r
|
|
|
191
196
|
|
|
192
197
|
_Make sure not to commit the directory created from the following process_.
|
|
193
198
|
|
|
194
|
-
There should be no need to run the static Storybook instance while actively developing -- it's used exclusively for building out the `gh-pages` environment and deploying it to [Github Pages](https://nypl.github.io/nypl-design-system/reservoir/
|
|
199
|
+
There should be no need to run the static Storybook instance while actively developing -- it's used exclusively for building out the `gh-pages` environment and deploying it to [Github Pages](https://nypl.github.io/nypl-design-system/reservoir/v2/?path=/docs/welcome--docs). In the event that you do run the static Storybook npm script, run:
|
|
195
200
|
|
|
196
201
|
```sh
|
|
197
|
-
$ npm run build-storybook:
|
|
202
|
+
$ npm run build-storybook:v2
|
|
198
203
|
```
|
|
199
204
|
|
|
200
|
-
You can then view `/reservoir/
|
|
205
|
+
You can then view `/reservoir/v2/index.html` in your browser. _Make sure not to commit this directory_.
|
|
201
206
|
|
|
202
207
|
## Accessibility
|
|
203
208
|
|