@nypl/design-system-react-components 1.6.0-vite-rc-3 → 1.6.0-vite-rc-5
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 +9 -21
- package/dist/design-system-react-components.cjs +78 -83
- package/dist/design-system-react-components.js +18895 -21326
- package/dist/src/components/Icons/IconSvgs.d.ts +6 -0
- package/dist/src/components/Link/Link.d.ts +2 -0
- package/dist/src/components/List/List.d.ts +3 -2
- package/dist/src/components/Logo/Logo.d.ts +3 -2
- package/dist/src/components/Logo/logoVariables.d.ts +2 -0
- package/dist/src/components/StyleGuide/ColorCard.d.ts +3 -3
- package/dist/src/index.d.ts +1 -3
- package/dist/src/theme/components/breadcrumb.d.ts +13 -0
- package/dist/src/theme/components/select.d.ts +1 -0
- package/dist/src/theme/components/textInput.d.ts +6 -0
- package/package.json +13 -15
- package/dist/src/components/Footer/Footer.d.ts +0 -14
- package/dist/src/components/Footer/footerLinks.d.ts +0 -12
- package/dist/src/components/Header/Header.d.ts +0 -21
- package/dist/src/components/Header/components/HeaderLogin.d.ts +0 -12
- package/dist/src/components/Header/components/HeaderLoginButton.d.ts +0 -10
- package/dist/src/components/Header/components/HeaderLowerNav.d.ts +0 -6
- package/dist/src/components/Header/components/HeaderMobileIconNav.d.ts +0 -6
- package/dist/src/components/Header/components/HeaderMobileNav.d.ts +0 -6
- package/dist/src/components/Header/components/HeaderMobileNavButton.d.ts +0 -6
- package/dist/src/components/Header/components/HeaderSearchButton.d.ts +0 -9
- package/dist/src/components/Header/components/HeaderSearchForm.d.ts +0 -10
- package/dist/src/components/Header/components/HeaderSitewideAlerts.d.ts +0 -7
- package/dist/src/components/Header/components/HeaderUpperNav.d.ts +0 -7
- package/dist/src/components/Header/context/headerContext.d.ts +0 -13
- package/dist/src/components/Header/utils/googleAnalyticsUtils.d.ts +0 -16
- package/dist/src/components/Header/utils/headerUtils.d.ts +0 -94
- package/dist/src/theme/components/footer.d.ts +0 -244
- package/dist/src/theme/components/header/header.d.ts +0 -72
- package/dist/src/theme/components/header/headerLogin.d.ts +0 -327
- package/dist/src/theme/components/header/headerLoginButton.d.ts +0 -69
- package/dist/src/theme/components/header/headerLowerNav.d.ts +0 -70
- package/dist/src/theme/components/header/headerMobileIconNav.d.ts +0 -28
- package/dist/src/theme/components/header/headerMobileNav.d.ts +0 -86
- package/dist/src/theme/components/header/headerMobileNavButton.d.ts +0 -34
- package/dist/src/theme/components/header/headerSearchButton.d.ts +0 -83
- package/dist/src/theme/components/header/headerSearchForm.d.ts +0 -183
- package/dist/src/theme/components/header/headerSitewideAlerts.d.ts +0 -42
- package/dist/src/theme/components/header/headerUpperNav.d.ts +0 -72
package/README.md
CHANGED
|
@@ -8,8 +8,8 @@ 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/v1/?path=/
|
|
12
|
-
- [Development/QA - deployed to Vercel](https://nypl-design-system.vercel.app/?path=/
|
|
11
|
+
- [Production - deployed to Github Pages](https://nypl.github.io/nypl-design-system/reservoir/v1/?path=/docs/welcome--docs)
|
|
12
|
+
- [Development/QA - deployed to Vercel](https://nypl-design-system.vercel.app/?path=/docs/welcome--docs)
|
|
13
13
|
|
|
14
14
|
| Table of Contents | |
|
|
15
15
|
| ----------------- | ----------------------------------------------------------------------------------- |
|
|
@@ -127,20 +127,6 @@ function NewComponent(props) {
|
|
|
127
127
|
}
|
|
128
128
|
```
|
|
129
129
|
|
|
130
|
-
### NYPL DS, NYPL Header, and NYPL Footer
|
|
131
|
-
|
|
132
|
-
```jsx
|
|
133
|
-
<body>
|
|
134
|
-
<NYPLHeader />
|
|
135
|
-
|
|
136
|
-
<div class="app">
|
|
137
|
-
<!-- your code here -->
|
|
138
|
-
</div>
|
|
139
|
-
|
|
140
|
-
<NYPLFooter />
|
|
141
|
-
</body>
|
|
142
|
-
```
|
|
143
|
-
|
|
144
130
|
## Using Chakra UI Components
|
|
145
131
|
|
|
146
132
|
The Chakra UI component library has been integrated into the Reservoir Design System. We are still progressing towards using Chakra components and patterns to build DS components, and therefore documentation and features are expected to change. While the implementation details of DS components will use Chakra, the DS package itself will export _some_ Chakra components.
|
|
@@ -152,13 +138,13 @@ The list of re-exported Chakra components can be found in the main [index.ts](/s
|
|
|
152
138
|
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:
|
|
153
139
|
|
|
154
140
|
- [MDX format](/src/docs/Chakra.stories.mdx)
|
|
155
|
-
- [Storybook page](https://nypl.github.io/nypl-design-system/reservoir/v1/?path=/
|
|
141
|
+
- [Storybook page](https://nypl.github.io/nypl-design-system/reservoir/v1/?path=/docs/chakra-ui--docs)
|
|
156
142
|
|
|
157
143
|
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).
|
|
158
144
|
|
|
159
145
|
## Storybook
|
|
160
146
|
|
|
161
|
-
The Reservoir Design System leverages Storybook to document all the React components and style guidelines. The Storybook documentation can be found [here](https://nypl.github.io/nypl-design-system/reservoir/v1/?path=/
|
|
147
|
+
The Reservoir Design System leverages Storybook to document all the React components and style guidelines. The Storybook documentation can be found [here](https://nypl.github.io/nypl-design-system/reservoir/v1/?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.
|
|
162
148
|
|
|
163
149
|
### Documentation Instances
|
|
164
150
|
|
|
@@ -166,13 +152,13 @@ There are currently two main instances of the Reservoir Design System Storybook
|
|
|
166
152
|
|
|
167
153
|
**Production**
|
|
168
154
|
|
|
169
|
-
The production Storybook documentation is deployed to [Github Pages](https://nypl.github.io/nypl-design-system/reservoir/v1/?path=/
|
|
155
|
+
The production Storybook documentation is deployed to [Github Pages](https://nypl.github.io/nypl-design-system/reservoir/v1/?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` branch.
|
|
170
156
|
|
|
171
157
|
As of July, 2021, the Github Pages production site gets deployed every two weeks on the same schedule as npm releases.
|
|
172
158
|
|
|
173
159
|
**Development**
|
|
174
160
|
|
|
175
|
-
The development Storybook documentation is deployed to [Vercel](https://nypl-design-system.vercel.app/?path=/
|
|
161
|
+
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.
|
|
176
162
|
|
|
177
163
|
**Preview Sites**
|
|
178
164
|
|
|
@@ -203,7 +189,9 @@ To help consuming application developers understand which version of the DS is r
|
|
|
203
189
|
|
|
204
190
|
### Static Build
|
|
205
191
|
|
|
206
|
-
|
|
192
|
+
_Make sure not to commit the directory created from the following process_.
|
|
193
|
+
|
|
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/v1/?path=/docs/welcome--docs). In the event that you do run the static Storybook npm script, run:
|
|
207
195
|
|
|
208
196
|
```sh
|
|
209
197
|
$ npm run build-storybook:v1
|