@narmi/design_system 2.11.1 → 2.11.2

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/LICENSE.md CHANGED
@@ -7,4 +7,3 @@ The above copyright notice and this permission notice shall be included in all c
7
7
  The rights granted above may only be exercised to develop and distribute applications that integrate or interoperate with Narmi software or services, and in the case of external, stand-alone applications that do not embed directly inside Narmi, the rights granted above may only be exercised to develop and distribute applications that are dissimilar and visually distinct from Narmi products and services (including the internal administration page(s) of Narmi banking products), as determined by Narmi in its sole discretion.
8
8
 
9
9
  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
10
-
package/README.md CHANGED
@@ -11,6 +11,7 @@ custom experiences in combination with the [Narmi API](https://www.narmi.com/dev
11
11
  ## Getting started
12
12
 
13
13
  ### Installation
14
+
14
15
  Narmi Design System is published as a single NPM package.
15
16
 
16
17
  ```
@@ -18,6 +19,7 @@ npm install @narmi/design_system --save
18
19
  ```
19
20
 
20
21
  #### Peer dependencies
22
+
21
23
  Your project must provide the following packages as peer dependencies:
22
24
 
23
25
  - React (>=16.9, supports Hooks)
@@ -26,12 +28,12 @@ Your project must provide the following packages as peer dependencies:
26
28
 
27
29
  - 📖 [Storybook (latest)](https://narmi.github.io/design_system/)
28
30
  - 🎨 [Design Guidelines](https://zeroheight.com/8ac87d4ba/p/446c38-narmi-design-system-nds)
29
- - ✏️ [Contributing](https://github.com/narmi/design_system/blob/master/CONTRIBUTING.md)
30
-
31
+ - ✏️ [Contributing](https://github.com/narmi/design_system/blob/master/CONTRIBUTING.md)
31
32
 
32
33
  ## Usage
33
34
 
34
35
  ### Components
36
+
35
37
  Components can be imported from package root:
36
38
 
37
39
  ```
@@ -39,6 +41,7 @@ import { Button, Tooltip } from '@narmi/design_system';
39
41
  ```
40
42
 
41
43
  ### Style Helpers
44
+
42
45
  NDS provides a set of global CSS helper classes to make it easy to tweak
43
46
  styling in your markup with standard Narmi design values. For example:
44
47
 
@@ -53,6 +56,7 @@ styling in your markup with standard Narmi design values. For example:
53
56
  For full documentation of available classes, see [storybook docs](https://narmi.github.io/design_system/).
54
57
 
55
58
  ### Design tokens
59
+
56
60
  All available distributions of design tokens can be found in `dist/tokens`.
57
61
  All CSS custom properites from design tokens are already included in the base
58
62
  stylesheet, `dist/style.css`.
@@ -60,19 +64,21 @@ stylesheet, `dist/style.css`.
60
64
  To request a new distribution, please [file an issue](https://github.com/narmi/design_system/issues/new/choose).
61
65
 
62
66
  ### Versioning
67
+
63
68
  This project uses [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
64
69
  Refer to the [**Changelog**](https://github.com/narmi/design_system/blob/master/CHANGELOG.md) for details.
65
70
 
66
71
  ### Browser Support
72
+
67
73
  See [`.browserslistrc`](https://github.com/narmi/design_system/blob/master/.editorconfig) for officially supported browsers or
68
74
  run `npx browserslist` in this project locally to see a full list of targeted browsers.
69
75
 
70
76
  This project does not support any version of Internet Explorer.
71
77
 
72
-
73
78
  ## Contributing
74
79
 
75
80
  ### Local development
81
+
76
82
  To run project locally:
77
83
 
78
84
  ```
@@ -83,31 +89,34 @@ npm run dev
83
89
 
84
90
  ### NPM scripts
85
91
 
86
- `npm run` command | Description
87
- -------------------- | ---------------------------------------
88
- `build:jsdoc` | builds jsDoc documentation to `dist/`
89
- `build:tokens` | builds all distributions of design tokens to `dist/`
90
- `build:components` | builds all components and base stylesheet to `dist/`
91
- `build` | builds everytyhing
92
- `test` | runs all jest tests
93
- `storybook` | starts storybook in dev server mode on `:6006`
94
- `watch` | watches `src` dir, triggering `build` on changes
95
- `dev` | **Start storybook and watch for all `src` changes**
92
+ | `npm run` command | Description |
93
+ | ------------------ | ---------------------------------------------------- |
94
+ | `build:jsdoc` | builds jsDoc documentation to `dist/` |
95
+ | `build:tokens` | builds all distributions of design tokens to `dist/` |
96
+ | `build:components` | builds all components and base stylesheet to `dist/` |
97
+ | `build` | builds everytyhing |
98
+ | `test` | runs all jest tests |
99
+ | `storybook` | starts storybook in dev server mode on `:6006` |
100
+ | `watch` | watches `src` dir, triggering `build` on changes |
101
+ | `dev` | **Start storybook and watch for all `src` changes** |
96
102
 
97
103
  ### Releases
104
+
98
105
  This project uses [`semantic-release`](https://semantic-release.gitbook.io/semantic-release/),
99
- configured to use [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/).
106
+ configured to use [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/).
100
107
 
101
108
  Any time new commits are added to the `master` branch, the GitHub Action "release" will run `semantic-release`. The job will
102
109
  parse recent git tags and commit messages to determine the new version number, tag the release, publish to NPM, and update the changelog.
103
110
 
104
111
  #### Major releases
112
+
105
113
  All PRs target `master` unless it contains breaking changes. Any branch continaing breaking change commits should target the open major release branch.
106
114
  For example, if NDS is on major version `1`, breaking changes should target the branch `major/v2`.
107
115
 
108
116
  Branches containing breaking change commits should follow the naming convention `breaking/<branch name>`.
109
117
 
110
118
  ### Commit Guidelines
119
+
111
120
  This project requires structured commit messages in the [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) format:
112
121
 
113
122
  ```
@@ -121,16 +130,19 @@ Adding a bang (`!`) to the commit type denotes a breaking change ([see docs](htt
121
130
  #### Examples
122
131
 
123
132
  Making a fix without scope specified:
133
+
124
134
  ```
125
135
  fix: update global `text-rendering` value
126
136
  ```
127
137
 
128
138
  Adding a feature within the scope of the Button component:
139
+
129
140
  ```
130
141
  feat(Button): add secondary button variant
131
142
  ```
132
143
 
133
144
  Breaking change within the Button component scope:
145
+
134
146
  ```
135
147
  refactor(Button)!: remove variant `disabled`. The `disabled` boolean prop is now used to disable a button.
136
148
  ```
@@ -149,4 +161,3 @@ If you are making a breaking change, please [note it in your commit message](htt
149
161
  ## License
150
162
 
151
163
  Source code is under a custom license based on MIT. The license restricts `@narmi/design_system` usage to applications that integrate or interoperate with Narmi software or services, with additional restrictions for external, stand-alone applications. Please see LICENSE.md for full details.
152
-