@veeqo/ui 0.1.23 → 0.1.25
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 +15 -50
- package/dist/components/Accordion/Accordion.d.ts +0 -1
- package/dist/components/Accordion/styled.d.ts +17 -6
- package/dist/index.esm.js +1 -1
- package/dist/index.esm.js.map +1 -1
- package/dist/index.js +1 -1
- package/dist/index.js.map +1 -1
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -2,26 +2,27 @@
|
|
|
2
2
|
|
|
3
3
|
## Intro
|
|
4
4
|
|
|
5
|
-
The frontend component library for reusable components in Veeqo which aim to reflect the [Veeqo Design System](https://www.figma.com/file/KFfBvJvYT4evKe9eiLEnwD/%F0%9F%8E%A8-Design-System?type=design&node-id=8067-38719&mode=design&t=v1hqIzanCtyYARwt-0). When possible we should aim to re-use components in this library all over the frontend and reduce the amount of custom components we create
|
|
5
|
+
The frontend component library for reusable components in Veeqo which aim to reflect the [Veeqo Design System](https://www.figma.com/file/KFfBvJvYT4evKe9eiLEnwD/%F0%9F%8E%A8-Design-System?type=design&node-id=8067-38719&mode=design&t=v1hqIzanCtyYARwt-0). When possible we should aim to re-use components in this library all over the frontend and reduce the amount of custom components we create.
|
|
6
6
|
|
|
7
|
-
This library has been re-written and refactored with the aims of enable tree-shaking which will allow us to reduce our bundle size and decrease page load times while also simplifying the library making it easier to work with and develop.
|
|
7
|
+
**Performance**: This library has been re-written and refactored with the aims of enable tree-shaking which will allow us to reduce our bundle size and decrease page load times while also simplifying the library making it easier to work with and develop.
|
|
8
8
|
|
|
9
|
-
Icons and Integrations **WILL**
|
|
9
|
+
In the longer term Icons and Integrations **WILL** be moved to their own library, but currently live in [veeqo-frontend](https://github.com/veeqo/veeqo-frontend/). _For now please use individual icons to preserve tree shaking, while downstream uses can use the old component library Glyph component if needed (not tree shakable, huge size)._
|
|
10
10
|
|
|
11
|
-
|
|
12
|
-
- Our Integrations now live in [@veeqo/integrations](https://www.npmjs.com/package/@veeqo/integrations).
|
|
11
|
+
### Links ⚓️
|
|
13
12
|
|
|
14
|
-
|
|
13
|
+
**This Library**: [Storybook 📋](https://www.ui.veeqo.amazon.dev/?path=/docs/get-started-how-to-install--docs) | [Playroom 🛝](https://www.ui.veeqo.amazon.dev/playroom/)
|
|
14
|
+
|
|
15
|
+
**Old Library**: [Storybook 📋](https://master.d1cz47hw90nvy2.amplifyapp.com/) | [Playroom 🛝](https://master.d1cz47hw90nvy2.amplifyapp.com/playroom)
|
|
15
16
|
|
|
16
17
|
## Getting Started
|
|
17
18
|
|
|
18
19
|
Setup should be simple, clone the repo and use npm to install all dependencies.
|
|
19
20
|
|
|
20
|
-
|
|
21
|
+
Start storybook with `npm run storybook`, and Playroom (including the storybook playroom integration) in a seperate terminal use `npm run playroom:start`.
|
|
21
22
|
|
|
22
|
-
|
|
23
|
+
### Testing
|
|
23
24
|
|
|
24
|
-
Note:
|
|
25
|
+
With this new library we aim to improve the quality of the code, and would like good test coverage of our components covering its main behaviour. Note:
|
|
25
26
|
|
|
26
27
|
- We use [React testing library](https://testing-library.com/docs/react-testing-library/intro/).
|
|
27
28
|
- Run tests with `npm run test`
|
|
@@ -29,61 +30,25 @@ Note:
|
|
|
29
30
|
|
|
30
31
|
### Prettier Setup
|
|
31
32
|
|
|
32
|
-
Everything should mostly be setup already, if prettier isn't automatically formatting please check your `.vscode/settings.json` and adjust if needed (
|
|
33
|
+
Everything should mostly be setup already, if prettier isn't automatically formatting please check your `.vscode/settings.json` and adjust if needed (don't push to git).
|
|
33
34
|
|
|
34
35
|
You will need to install [ESlint](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint) and [Prettier](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode) VSCode Extensions, if you haven't already.
|
|
35
36
|
|
|
36
37
|
## Publishing to NPM
|
|
37
38
|
|
|
38
|
-
_We currently deploy to NPM, which is an automated process once you merge._
|
|
39
|
+
_We currently deploy to NPM, which is an **automated process** once you merge._
|
|
39
40
|
|
|
40
41
|
### Publishing
|
|
41
42
|
|
|
42
43
|
Versioning will happen on the `package.json` version number, and is for the library as a whole instead of per component for simplicity.
|
|
43
44
|
|
|
44
|
-
|
|
45
|
+
**After** you have made your changes, use `npm run patch` or `npm run minor` or `npm run major` according to the update size:
|
|
45
46
|
|
|
46
47
|
- This create update the version number by the amount specified in the command you entered above.
|
|
47
48
|
- **Create a git tag** for that version, making the version history straightward to look back on.
|
|
48
49
|
- Update the changelog based on your commits.
|
|
49
50
|
- Push this readme change upstream
|
|
50
51
|
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
<details>
|
|
54
|
-
<summary>To publish beta versions...</summary>
|
|
55
|
-
|
|
56
|
-
### Getting NPM Access
|
|
57
|
-
|
|
58
|
-
#### 1. Register NPM and request package access
|
|
59
|
-
|
|
60
|
-
In order to make sure you're not a random stranger to do the publish, you need to register your amazon account (email ending with @amazon.com) on [npm](https://www.npmjs.com/). And then create a ticket in this [system](https://t.corp.amazon.com/create) to request you permission to access Veeqo-FE package, using the following options to create this access request ticket.
|
|
61
|
-
|
|
62
|
-
```
|
|
63
|
-
Category (C)
|
|
64
|
-
Veeqo
|
|
65
|
-
|
|
66
|
-
Type (T)
|
|
67
|
-
Access Provisioning
|
|
52
|
+
**If you run the script more than once** we will have duplicate tags, which will ruin the changelog (easy to spot) and stop us using those versions in the future. Please use `npm tags:remove v<yourversion>` to remove the tag.
|
|
68
53
|
|
|
69
|
-
|
|
70
|
-
Access Requests
|
|
71
|
-
```
|
|
72
|
-
|
|
73
|
-
Ps: feel free to PM your manager about your access request too as sometimes they may miss the emails
|
|
74
|
-
|
|
75
|
-
#### 2. Authenticate
|
|
76
|
-
|
|
77
|
-
Once you've granted the access to Veeqo-FE package, make sure you have authenticated NPM and logged in with your account on your local machine.
|
|
78
|
-
|
|
79
|
-
An easy way to do this is to run:
|
|
80
|
-
|
|
81
|
-
```
|
|
82
|
-
npm login
|
|
83
|
-
```
|
|
84
|
-
|
|
85
|
-
### Creating
|
|
86
|
-
|
|
87
|
-
Publish off your branch, don't merge to master. Adjust the package.lock version number yourself before publishing and make sure to publish with a tag (to not update `latest`).
|
|
88
|
-
|
|
89
|
-
</details>
|
|
54
|
+
After this is done, merge your PR and GitHub actions will do the rest! If your version hasn't deployed within a few mins ([check here](https://www.npmjs.com/package/@veeqo/ui?activeTab=versions)), please reach out on slack.
|
|
@@ -4,11 +4,22 @@ declare const Left: import("styled-components").StyledComponent<"div", any, {
|
|
|
4
4
|
glyphColor: string;
|
|
5
5
|
}, never>;
|
|
6
6
|
declare const Right: import("styled-components").StyledComponent<any, any, object, string | number | symbol>;
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
7
|
+
/**
|
|
8
|
+
* Due to unique behaviour observed in Safari, we override the outline property when
|
|
9
|
+
* the accordion is focussed.
|
|
10
|
+
*/
|
|
11
|
+
declare const AccordionSummary: import("styled-components").StyledComponent<"summary", any, {}, never>;
|
|
10
12
|
declare const Top: import("styled-components").StyledComponent<"div", any, {}, never>;
|
|
11
|
-
declare const Arrow: import("styled-components").StyledComponent<(props: any) => import("react").JSX.Element, any, {}, never>;
|
|
12
13
|
declare const Description: import("styled-components").StyledComponent<"span", any, {} & import("../Text/types").TextProps, never>;
|
|
13
|
-
declare const
|
|
14
|
-
|
|
14
|
+
declare const AccordionContent: import("styled-components").StyledComponent<import("framer-motion").CustomDomComponent<{
|
|
15
|
+
[x: string]: any;
|
|
16
|
+
[x: number]: any;
|
|
17
|
+
[x: symbol]: any;
|
|
18
|
+
} & {
|
|
19
|
+
theme?: any;
|
|
20
|
+
} & {
|
|
21
|
+
as?: string | import("react").ComponentType<any> | undefined;
|
|
22
|
+
forwardedAs?: string | import("react").ComponentType<any> | undefined;
|
|
23
|
+
}>, any, {}, never>;
|
|
24
|
+
declare const AccordionDetails: import("styled-components").StyledComponent<"details", any, {}, never>;
|
|
25
|
+
export { AccordionSummary, Top, Text, Left, Right, Description, AccordionDetails, AccordionContent, };
|