sevago-library 1.0.79 → 1.1.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.
Files changed (3) hide show
  1. package/CHANGELOG.md +19 -0
  2. package/README.md +175 -221
  3. package/package.json +115 -109
package/CHANGELOG.md ADDED
@@ -0,0 +1,19 @@
1
+ # sevago-library
2
+
3
+ ## 1.1.2
4
+
5
+ ### Patch Changes
6
+
7
+ - update deploy.sh
8
+
9
+ ## 1.1.1
10
+
11
+ ### Patch Changes
12
+
13
+ - 9332de0: add readme and how to use packages
14
+
15
+ ## 1.1.0
16
+
17
+ ### Minor Changes
18
+
19
+ - e3c7ce0: add changeset in packages
package/README.md CHANGED
@@ -1,221 +1,175 @@
1
- # Sevago SSO Frontend Library
2
-
3
- <div align="center">
4
-
5
- A comprehensive Single Sign-On (SSO) frontend library built with React, TypeScript, and Material-UI.
6
-
7
- [![npm version](https://img.shields.io/npm/v/sevago-library)](https://www.npmjs.com/package/sevago-library)
8
- [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
9
-
10
- </div>
11
-
12
- ---
13
-
14
- ## Support
15
-
16
- - **GitHub Issues:** [https://github.com/dev1-gmail2025/sevago-library/issues](https://github.com/dev1-gmail2025/sevago-library/issues)
17
- - **Repository:** [https://github.com/dev1-gmail2025/sevago-library](https://github.com/dev1-gmail2025/sevago-library)
18
- - **Material Symbols:** [https://fonts.google.com/icons](https://fonts.google.com/icons)
19
-
20
- ## Features
21
-
22
- - 🎨 Material-UI components with custom styling and theming
23
- - 📱 Responsive design with mobile support
24
- - 🎯 Full TypeScript support
25
- - 🎭 Framer Motion animations
26
- - 📊 System monitoring components
27
- - 🔧 Utility functions and constants
28
-
29
- ---
30
-
31
- ## Installation
32
-
33
- ```bash
34
- npm install sevago-library
35
- ```
36
-
37
- ### Peer Dependencies
38
-
39
- ```bash
40
- npm install react@^19.2.0 react-dom@^19.2.0 @emotion/react@>=11 @emotion/styled@>=11 @mui/material@>=5 @mui/system@>=5 @reduxjs/toolkit@^2.9.2 react-redux@^9.2.0 react-router-dom@^7.9.5 redux-persist@^6.0.0
41
- ```
42
-
43
- ---
44
-
45
- ## Quick Start
46
-
47
- ### Basic Setup
48
-
49
- ```tsx
50
- import React from 'react';
51
- import { Provider } from 'react-redux';
52
- import { PersistGate } from 'redux-persist/integration/react';
53
- import { BrowserRouter } from 'react-router-dom';
54
- import App from 'sevago-library';
55
-
56
- function RootApp() {
57
- return (
58
- <Provider store={store}>
59
- <PersistGate loading={null} persistor={persistor}>
60
- <BrowserRouter>
61
- <App />
62
- </BrowserRouter>
63
- </PersistGate>
64
- </Provider>
65
- );
66
- }
67
-
68
- export default RootApp;
69
- ```
70
-
71
- ---
72
-
73
- ### Constants
74
-
75
- #### Style Constants
76
-
77
- ```tsx
78
- import { STYLE, MODE, OPACITY } from 'sevago-library';
79
-
80
- const customStyle = {
81
- padding: STYLE.PADDING_GAP_LAYOUT,
82
- borderRadius: STYLE.BORDER_RADIUS_ELEMENT,
83
- height: STYLE.HEIGHT_DEFAULT_TEXT_FIELD_BUTTON,
84
- };
85
- ```
86
-
87
- #### Theme Modes
88
-
89
- ```tsx
90
- import { MODE } from 'sevago-library';
91
- import { createTheme } from '@mui/material/styles';
92
-
93
- const theme = createTheme(MODE.light); // or MODE.dark or MODE.other
94
- ```
95
-
96
- #### Opacity Constants
97
-
98
- ```tsx
99
- import { MODE, OPACITY } from 'sevago-library';
100
-
101
- const semiTransparent = `${MODE.light.palette.primary.main}${OPACITY[50]}`;
102
- ```
103
-
104
- ### Utilities
105
-
106
- #### Time Utils
107
-
108
- ```tsx
109
- import { timeUtils } from 'sevago-library';
110
-
111
- const timeAgo = timeUtils.getTimeAgo(new Date());
112
- const dateTime = timeUtils.getDateTime(new Date());
113
- const date = timeUtils.getDate(new Date());
114
- ```
115
-
116
- #### String Utils
117
-
118
- ```tsx
119
- import { stringUtils } from 'sevago-library';
120
-
121
- // Use string utility functions
122
- ```
123
-
124
- #### App Utils
125
-
126
- ```tsx
127
- import { Environment, getCurrentEnvironment } from 'sevago-library';
128
-
129
- // Get current environment based on hostname
130
- const env = getCurrentEnvironment();
131
- // Returns: Environment.DEVELOP | Environment.STAGING | Environment.PRODUCTION
132
-
133
- // Environment enum values
134
- const develop = Environment.DEVELOP; // "develop"
135
- const staging = Environment.STAGING; // "staging"
136
- const production = Environment.PRODUCTION; // "production"
137
- ```
138
-
139
- ### Enums
140
-
141
- ```tsx
142
- import { AppCategory, Mode, OrderType, Environment } from 'sevago-library';
143
-
144
- // Use enums
145
- const category = AppCategory.ALL;
146
- const mode = Mode.LIGHT;
147
- const order = OrderType.ASC;
148
- const env = Environment.DEVELOP;
149
- ```
150
-
151
- ---
152
-
153
- ## API Reference
154
-
155
- ### Components
156
-
157
- | Component | Description | Props |
158
- | -------------------------- | ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
159
- | `App` | Main application component with theme provider | None |
160
- | `SystemMonitorScreen` | System monitoring dashboard screen | `env: Environment`, `blacklist?: string[]` |
161
- | `AppGrid` | Application grid component with smart URL routing | `apps: AppInfo[]`, `env: Environment`, `columns?: number`, `rows?: number`, `iconSize?: number`, `iconRadius?: number`, `gap?: number \| string`, `showPagination?: boolean`, `titleVariant?`, `titleColor?`, `captionColor?` |
162
- | `AppsSidebar` | Applications sidebar component | `isOpen: boolean`, `onClose: () => void`, `env: Environment`, `position?: "left" \| "right"`, `blacklist?: string[]` |
163
- | `SystemMonitorSidebarPart` | System monitor sidebar part | - |
164
-
165
- ## TypeScript Support
166
-
167
- Full TypeScript support with comprehensive type definitions:
168
-
169
- ```tsx
170
- import type { AppInfo, AppGridProps, SystemMonitorScreenProps, AppsSidebarProps, Environment } from 'sevago-library';
171
-
172
- // AppInfo interface
173
- interface AppInfo {
174
- path: {
175
- develop: string;
176
- staging: string;
177
- production: string;
178
- };
179
- content: string;
180
- color: string;
181
- icon: string;
182
- group: AppGroup;
183
- }
184
- ```
185
-
186
- ---
187
-
188
- ## Development
189
-
190
- ### Prerequisites
191
-
192
- - Node.js >= 16.x
193
- - npm >= 7.x
194
-
195
- ### Getting Started
196
-
197
- ```bash
198
- # Clone the repository
199
- git clone https://github.com/dev1-gmail2025/sevago-library.git
200
- cd sevago-library
201
-
202
- # Install dependencies
203
- npm install
204
-
205
- # Run development server
206
- npm run dev
207
-
208
- # Build library
209
- npm run build:lib
210
-
211
- # Lint code
212
- npm run lint
213
- ```
214
-
215
- ---
216
-
217
- <div align="center">
218
-
219
- **Made with ❤️ for the Sevago SSO ecosystem**
220
-
221
- </div>
1
+ # Sevago SSO Frontend Library
2
+
3
+ <div align="center">
4
+
5
+ **React + TypeScript component library for the Sevago SSO ecosystem.**
6
+
7
+ [![npm version](https://img.shields.io/npm/v/sevago-library)](https://www.npmjs.com/package/sevago-library)
8
+ [![License: MIT](https://img.shields.io/badge/license-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
9
+
10
+ </div>
11
+
12
+ Sevago SSO Frontend Library provides reusable React components, shared constants, utilities, and TypeScript types used across Sevago frontend applications.
13
+
14
+ ---
15
+
16
+ ## Installation
17
+
18
+ Install the package in your project:
19
+
20
+ ```bash
21
+ npm install sevago-library
22
+ ```
23
+
24
+ Install required peer dependencies:
25
+
26
+ ```bash
27
+ npm install react react-dom @emotion/react @emotion/styled @mui/material @mui/system @reduxjs/toolkit react-redux react-router-dom redux-persist
28
+ ```
29
+
30
+ ---
31
+
32
+ ## Usage
33
+
34
+ Import components, constants, utilities, and types directly from the package:
35
+
36
+ ```tsx
37
+ import { AppGrid, MODE, timeUtils } from 'sevago-library';
38
+ import type { AppInfo } from 'sevago-library';
39
+
40
+ const theme = MODE.light;
41
+ const dateText = timeUtils.getDateTime(new Date());
42
+
43
+ function AppList({ apps }: { apps: AppInfo[] }) {
44
+ return (
45
+ <AppGrid
46
+ apps={apps}
47
+ columns={5}
48
+ rows={3}
49
+ onClickApp={(app) => window.open(app.path.production)}
50
+ />
51
+ );
52
+ }
53
+ ```
54
+
55
+ For applications that use the bundled provider/app shell:
56
+
57
+ ```tsx
58
+ import React from 'react';
59
+ import { Provider } from 'react-redux';
60
+ import { PersistGate } from 'redux-persist/integration/react';
61
+ import { BrowserRouter } from 'react-router-dom';
62
+ import App from 'sevago-library';
63
+
64
+ function RootApp() {
65
+ return (
66
+ <Provider store={store}>
67
+ <PersistGate loading={null} persistor={persistor}>
68
+ <BrowserRouter>
69
+ <App />
70
+ </BrowserRouter>
71
+ </PersistGate>
72
+ </Provider>
73
+ );
74
+ }
75
+
76
+ export default RootApp;
77
+ ```
78
+
79
+ ---
80
+
81
+ ## Documentation
82
+
83
+ Useful project references:
84
+
85
+ - [Repository](https://github.com/core-sevago/sevago-library)
86
+ - [npm package](https://www.npmjs.com/package/sevago-library)
87
+ - [Material Symbols](https://fonts.google.com/icons)
88
+
89
+ ---
90
+
91
+ ## Components
92
+
93
+ Common exports include:
94
+
95
+ - `AppGrid`
96
+ - `AppsSidebar`
97
+ - `SystemMonitorScreen`
98
+ - `SystemMonitorSidebarPart`
99
+ - `DefaultLayout`
100
+ - `LoadingComponent`
101
+ - `LogoComponent`
102
+ - `MotionBox`
103
+ - `NoteComponent`
104
+ - `PriceComponent`
105
+ - `ReviewComponent`
106
+
107
+ The library also exports shared elements, styles, constants, enums, interfaces, and utility functions.
108
+
109
+ ---
110
+
111
+ ## TypeScript
112
+
113
+ The package ships with generated TypeScript declarations from `dist`.
114
+
115
+ ```tsx
116
+ import type { AppInfo, AppGridProps, Environment } from 'sevago-library';
117
+ ```
118
+
119
+ ---
120
+
121
+ ## Questions
122
+
123
+ For issues and usage questions, use the project repository:
124
+
125
+ [https://github.com/core-sevago/sevago-library/issues](https://github.com/core-sevago/sevago-library/issues)
126
+
127
+ ---
128
+
129
+ ## Contributing
130
+
131
+ Create a changeset for every public change:
132
+
133
+ ```bash
134
+ npm run changeset
135
+ ```
136
+
137
+ Choose `patch`, `minor`, or `major`, then commit the generated file in `.changeset/`.
138
+
139
+ To publish a new version from a clean `master` branch:
140
+
141
+ ```bash
142
+ bash deploy.sh
143
+ ```
144
+
145
+ The deploy script applies Changesets, builds the library, commits release artifacts, publishes to npm, and pushes the release commit with tags.
146
+
147
+ ---
148
+
149
+ ## Changelog
150
+
151
+ The [changelog](https://github.com/core-sevago/sevago-library/blob/master/CHANGELOG.md) is generated by Changesets and updated for every release.
152
+
153
+ ---
154
+
155
+ ## Roadmap
156
+
157
+ Future changes should be tracked through GitHub issues and released with Changesets.
158
+
159
+ ---
160
+
161
+ ## License
162
+
163
+ This project is licensed under the [MIT license](https://opensource.org/licenses/MIT).
164
+
165
+ ---
166
+
167
+ ## Security
168
+
169
+ Do not publish credentials, tokens, private URLs, or environment files. Report security issues through the project maintainers.
170
+
171
+ ---
172
+
173
+ ## Keywords
174
+
175
+ `sso` `authentication` `react` `typescript` `sevago`
package/package.json CHANGED
@@ -1,109 +1,115 @@
1
- {
2
- "name": "sevago-library",
3
- "version": "1.0.79",
4
- "description": "Sevago SSO Frontend Library - A comprehensive SSO solution with React components",
5
- "main": "dist/index.js",
6
- "module": "dist/index.esm.js",
7
- "types": "dist/index.d.ts",
8
- "files": [
9
- "dist",
10
- "README.md"
11
- ],
12
- "scripts": {
13
- "build": "vite build --mode library",
14
- "prepare": "npm run build",
15
- "build:lib": "vite build --mode library",
16
- "lint": "eslint .",
17
- "preview": "vite preview",
18
- "dev": "storybook dev -p 6006 --disable-telemetry",
19
- "build-storybook": "storybook build -o docs && touch docs/.nojekyll",
20
- "storybook:test": "test-storybook --url http://127.0.0.1:6006",
21
- "storybook:test:ci": "start-server-and-test storybook http://127.0.0.1:6006 storybook:test",
22
- "chromatic": "chromatic --project-token=$CHROMATIC_PROJECT_TOKEN --exit-zero-on-changes --only-changed",
23
- "prepublishOnly": "npm run build:lib",
24
- "format": "prettier --write src/**/*.{js,jsx,ts,tsx,json,css,md}",
25
- "version:patch": "npm version patch",
26
- "version:publish": "npm version patch && npm publish --access public"
27
- },
28
- "keywords": [
29
- "sso",
30
- "authentication",
31
- "react",
32
- "typescript",
33
- "sevago"
34
- ],
35
- "author": "Sevago Team",
36
- "license": "MIT",
37
- "repository": {
38
- "type": "git",
39
- "url": "git+https://github.com/core-sevago/sevago-library"
40
- },
41
- "bugs": {
42
- "url": "https://github.com/core-sevago/sevago-library"
43
- },
44
- "homepage": "https://github.com/core-sevago/sevago-library",
45
- "peerDependencies": {
46
- "@emotion/react": ">=11",
47
- "@emotion/styled": ">=11",
48
- "@mui/material": ">=5",
49
- "@mui/system": ">=5",
50
- "@mui/x-date-pickers": "^8.2.0",
51
- "@reduxjs/toolkit": "^2.9.2",
52
- "@types/react-router-dom": "^5.3.3",
53
- "axios": "^1.12.2",
54
- "dayjs": "^1.11.18",
55
- "formik": "^2.4.6",
56
- "framer-motion": "^12.23.22",
57
- "react": "^19.2.0",
58
- "react-dom": "^19.2.0",
59
- "react-number-format": "^5.4.3",
60
- "react-redux": "^9.2.0",
61
- "react-router-dom": "^7.9.5",
62
- "redux-persist": "^6.0.0",
63
- "socket.io-client": "^4.8.1",
64
- "yup": "^1.7.1"
65
- },
66
- "dependencies": {
67
- "@storybook/core-events": "^8.6.14",
68
- "eslint-config-prettier": "^10.1.8",
69
- "eslint-plugin-prettier": "^5.5.4",
70
- "exceljs": "^4.4.0",
71
- "file-saver": "^2.0.5",
72
- "prettier": "^3.8.1"
73
- },
74
- "devDependencies": {
75
- "@eslint/js": "^9.36.0",
76
- "@mui/x-date-pickers": "^8.2.0",
77
- "@storybook/addon-essentials": "^8.6.18",
78
- "@storybook/addon-interactions": "^8.6.18",
79
- "@storybook/addon-links": "^8.6.18",
80
- "@storybook/react-vite": "^8.6.18",
81
- "@storybook/test": "^8.6.18",
82
- "@storybook/test-runner": "^0.22.0",
83
- "@types/file-saver": "^2.0.7",
84
- "@types/node": "^24.7.0",
85
- "@types/react": "^19.2.2",
86
- "@types/react-dom": "^19.2.2",
87
- "@types/react-router-dom": "^5.3.3",
88
- "@vitejs/plugin-react": "^5.0.4",
89
- "axios": "^1.12.2",
90
- "chromatic": "^11.29.0",
91
- "dayjs": "^1.11.18",
92
- "eslint": "^9.36.0",
93
- "eslint-plugin-react-hooks": "^5.2.0",
94
- "eslint-plugin-react-refresh": "^0.4.22",
95
- "formik": "^2.4.6",
96
- "framer-motion": "^12.23.22",
97
- "globals": "^16.4.0",
98
- "msw": "^2.11.1",
99
- "msw-storybook-addon": "^2.0.4",
100
- "react-number-format": "^5.4.3",
101
- "socket.io-client": "^4.8.1",
102
- "start-server-and-test": "^2.1.1",
103
- "typescript": "~5.9.3",
104
- "typescript-eslint": "^8.45.0",
105
- "vite": "^6.4.1",
106
- "vite-plugin-dts": "^4.5.4",
107
- "yup": "^1.7.1"
108
- }
109
- }
1
+ {
2
+ "name": "sevago-library",
3
+ "version": "1.1.2",
4
+ "description": "Sevago SSO Frontend Library - A comprehensive SSO solution with React components",
5
+ "main": "dist/index.js",
6
+ "module": "dist/index.esm.js",
7
+ "types": "dist/index.d.ts",
8
+ "files": [
9
+ "dist",
10
+ "CHANGELOG.md",
11
+ "README.md"
12
+ ],
13
+ "publishConfig": {
14
+ "access": "public"
15
+ },
16
+ "scripts": {
17
+ "build": "vite build --mode library",
18
+ "prepare": "npm run build",
19
+ "build:lib": "vite build --mode library",
20
+ "lint": "eslint .",
21
+ "preview": "vite preview",
22
+ "dev": "storybook dev -p 6006 --disable-telemetry",
23
+ "build-storybook": "storybook build -o docs && touch docs/.nojekyll",
24
+ "storybook:test": "test-storybook --url http://127.0.0.1:6006",
25
+ "storybook:test:ci": "start-server-and-test storybook http://127.0.0.1:6006 storybook:test",
26
+ "chromatic": "chromatic --project-token=$CHROMATIC_PROJECT_TOKEN --exit-zero-on-changes --only-changed",
27
+ "prepublishOnly": "npm run build:lib",
28
+ "format": "prettier --write src/**/*.{js,jsx,ts,tsx,json,css,md}",
29
+ "changeset": "changeset",
30
+ "version": "changeset version",
31
+ "release": "changeset publish"
32
+ },
33
+ "keywords": [
34
+ "sso",
35
+ "authentication",
36
+ "react",
37
+ "typescript",
38
+ "sevago"
39
+ ],
40
+ "author": "Sevago Team",
41
+ "license": "MIT",
42
+ "repository": {
43
+ "type": "git",
44
+ "url": "git+https://github.com/core-sevago/sevago-library"
45
+ },
46
+ "bugs": {
47
+ "url": "https://github.com/core-sevago/sevago-library"
48
+ },
49
+ "homepage": "https://github.com/core-sevago/sevago-library",
50
+ "peerDependencies": {
51
+ "@emotion/react": ">=11",
52
+ "@emotion/styled": ">=11",
53
+ "@mui/material": ">=5",
54
+ "@mui/system": ">=5",
55
+ "@mui/x-date-pickers": "^8.2.0",
56
+ "@reduxjs/toolkit": "^2.9.2",
57
+ "@types/react-router-dom": "^5.3.3",
58
+ "axios": "^1.12.2",
59
+ "dayjs": "^1.11.18",
60
+ "formik": "^2.4.6",
61
+ "framer-motion": "^12.23.22",
62
+ "react": "^19.2.0",
63
+ "react-dom": "^19.2.0",
64
+ "react-number-format": "^5.4.3",
65
+ "react-redux": "^9.2.0",
66
+ "react-router-dom": "^7.9.5",
67
+ "redux-persist": "^6.0.0",
68
+ "socket.io-client": "^4.8.1",
69
+ "yup": "^1.7.1"
70
+ },
71
+ "dependencies": {
72
+ "@storybook/core-events": "^8.6.14",
73
+ "eslint-config-prettier": "^10.1.8",
74
+ "eslint-plugin-prettier": "^5.5.4",
75
+ "exceljs": "^4.4.0",
76
+ "file-saver": "^2.0.5",
77
+ "prettier": "^3.8.1"
78
+ },
79
+ "devDependencies": {
80
+ "@changesets/cli": "^2.31.0",
81
+ "@eslint/js": "^9.36.0",
82
+ "@mui/x-date-pickers": "^8.2.0",
83
+ "@storybook/addon-essentials": "^8.6.18",
84
+ "@storybook/addon-interactions": "^8.6.18",
85
+ "@storybook/addon-links": "^8.6.18",
86
+ "@storybook/react-vite": "^8.6.18",
87
+ "@storybook/test": "^8.6.18",
88
+ "@storybook/test-runner": "^0.22.0",
89
+ "@types/file-saver": "^2.0.7",
90
+ "@types/node": "^24.7.0",
91
+ "@types/react": "^19.2.2",
92
+ "@types/react-dom": "^19.2.2",
93
+ "@types/react-router-dom": "^5.3.3",
94
+ "@vitejs/plugin-react": "^5.0.4",
95
+ "axios": "^1.12.2",
96
+ "chromatic": "^11.29.0",
97
+ "dayjs": "^1.11.18",
98
+ "eslint": "^9.36.0",
99
+ "eslint-plugin-react-hooks": "^5.2.0",
100
+ "eslint-plugin-react-refresh": "^0.4.22",
101
+ "formik": "^2.4.6",
102
+ "framer-motion": "^12.23.22",
103
+ "globals": "^16.4.0",
104
+ "msw": "^2.11.1",
105
+ "msw-storybook-addon": "^2.0.4",
106
+ "react-number-format": "^5.4.3",
107
+ "socket.io-client": "^4.8.1",
108
+ "start-server-and-test": "^2.1.1",
109
+ "typescript": "~5.9.3",
110
+ "typescript-eslint": "^8.45.0",
111
+ "vite": "^6.4.1",
112
+ "vite-plugin-dts": "^4.5.4",
113
+ "yup": "^1.7.1"
114
+ }
115
+ }