@pushengineering/umg-web-components 2.0.3 → 2.0.4

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.
Files changed (2) hide show
  1. package/package.json +1 -1
  2. package/readme.md +22 -69
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@pushengineering/umg-web-components",
3
- "version": "2.0.3",
3
+ "version": "2.0.4",
4
4
  "type": "module",
5
5
  "module": "dist/components/index.js",
6
6
  "files": [
package/readme.md CHANGED
@@ -1,81 +1,34 @@
1
- # Table of Contents
2
1
 
3
- - [Table of Contents](#table-of-contents)
4
- - [UMG UX Components Library README](#umg-ux-components-library-readme)
5
- - [Learn More about Web Components](#learn-more-about-web-components)
6
- - [Local Development Environment](#local-development-environment)
7
- - [Prerequisites](#prerequisites)
8
- - [Installation](#installation)
9
- - [Build scripts](#build-scripts)
10
- - [Lit - Lightning-Fast Components](#lit---lightning-fast-components)
11
- - [Storybook Integration for Component Previews and Documentation](#storybook-integration-for-component-previews-and-documentation)
2
+ # UMG Web Components Library
3
+ This library provides a collection of native UX web components built with [Lit](https://lit.dev/docs/).
4
+ The components are designed to be fast, reusable, and highly customisable for any project, without relying on proprietary technologies or frameworks. They leverage standard Web APIs and are compatible with all modern browsers.
12
5
 
13
- # UMG UX Components Library README
14
- Welcome to the UMG UX Components Library! This library provides a collection of UX frontend components designed to be fast, reusable, and highly customisable for any project, without relying on proprietary technologies or frameworks. These components leverage standard Web APIs and are compatible with all modern browsers.
6
+ Components are exported as native ES Modules and can be directly used in web applications using raw module imports. If your application does not support native modules, tools like Rollup or Webpack can be used to prepare the components for serving in your production environment as needed.
15
7
 
16
- ## Learn More about Web Components
17
- To deepen your understanding of web components, their key concepts, and the specific web APIs we employ, we recommend reading the [MDN guide on Web Components](https://developer.mozilla.org/en-US/docs/Web/API/Web_components).
18
-
19
-
20
- # Local Development Environment
21
-
22
- ## Prerequisites
23
-
24
- Before you begin, make sure you have the following prerequisites installed on your system:
25
-
26
- Node.js v16.14 or higher. You can download it from [here](https://nodejs.org/en/download)
27
- [PNPM](https://pnpm.io/) v8 or higher. Install it via these links: [Mac](https://github.com/nvm-sh/nvm) | [Windows](https://github.com/coreybutler/nvm-windows)
8
+ To keep code sizes to a minimum Lit is not exported with the library and will need to be installed as a dependency of your project.
28
9
 
29
10
  ## Installation
30
- 1. Install Node.js globally using one of the following methods:
31
- - Mac: [NVM](https://github.com/nvm-sh/nvm)
32
- - Windows: [NVM for Windows](https://github.com/coreybutler/nvm-windows)
33
- - Direct download: [Node.js](https://nodejs.org/en/download)
34
-
35
- 2. Install PNPM globally using one of the following methods:
36
- - Mac: ``brew install pnpm``
37
- - Windows PowerShell: Run the command ``iwr https://get.pnpm.io/install.ps1 -useb | iex``
38
-
39
- For more details, check the: [PNPM documentation](https://pnpm.io/)
40
-
41
- 1. Clone the project repository using this command:
42
- ```
43
- git clone git@github.com:Push-Entertainment/umg-component-library.git
44
- ```
45
11
 
46
- 2. Initialise the project by running the following command in your terminal within the project's root directory:
47
- ```
48
- pnpm install
49
- ```
12
+ Install the package as dependency of your application:
50
13
 
51
- ## Build scripts
14
+ `npm i @pushengineering/umg-web-components`
15
+ `yarn add @pushengineering/umg-web-components`
16
+ `pnpm add @pushengineering/umg-web-components`
52
17
 
53
- We've provided various build scripts to streamline your development process:
18
+ Install Lit as a dependency:
54
19
 
55
- - Develop components: `pnpm dev`
56
- - Develop Storybook: `pnpm dev-storybook`
57
- - Build components and design tokens: `pnpm build`
58
- - Build components, design tokens and Storybook static site: `pnpm build-all`
59
- - Build design tokens: `pnpm build-tokens`
60
- - Build Storybook static site: `pnpm build-storybook`
61
-
62
- # Lit - Lightning-Fast Components
63
-
64
- Our library is built using Lit, a framework that simplifies component development without sacrificing performance or relying on non-standard frameworks. Lit builds on web component standards, is lightweight, and reduces boilerplate code. You can find Lit 2's documentation [here](https://lit.dev/docs/).
65
-
66
- To save time, minimise errors, and future-proof your code, we've written this library in TypeScript and utilise Lit's decorator methods, which TypeScript transpiles into browser-compatible JavaScript.
67
-
68
- # Storybook Integration for Component Previews and Documentation
69
-
70
- We've seamlessly integrated Storybook into our component library to provide you with a powerful playground tool with component previews and comprehensive documentation. Storybook serves as a valuable resource for both developers and designers, offering a visual representation of each component's behavior and appearance in different scenarios.
71
-
72
- - Exploring Components in Storybook
73
- With Storybook, you can easily navigate and explore our components:
74
-
75
- - Preview Components: View live, interactive previews of each component to understand how they look and behave in various situations.
20
+ `npm i lit`
21
+
22
+ ## Further information
76
23
 
77
- - Component Variations: Explore different variations and configurations of each component, helping you tailor them to your specific project requirements.
24
+ [Push Engineering Git Repository](https://github.com/Push-Entertainment/umg-component-library)
78
25
 
79
- - Interactive Documentation: Access detailed documentation and usage examples for each component, making it easier to implement them effectively in your project.
26
+ ## Release Version 2
27
+ - Supports UMG Grand Royal layouts:
28
+ - Single Slick V1 themes
29
+ - Multipage Slick V1 themes
80
30
 
81
- The Storybook application can be loaded into a browser by running `pnpm dev-storybook` in `node_modules/@pushengineering/umg-components`.
31
+ ### Patches in this release
32
+ - Social component
33
+ - Social icon links target property was not being passed to child button icons.
34
+ - Missing social icons previously added to the Icon component had not merged into the main release branch.