@dexteel/mesf-core 7.6.0 → 7.8.0
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/.release-please-manifest.json +1 -1
- package/CHANGELOG.md +25 -0
- package/GEMINI.md +92 -0
- package/dist/index.esm.js +263 -94
- package/dist/index.esm.js.map +1 -1
- package/dist/pages/trendings/components/chart/repository/TrendingRepository.d.ts +6 -1
- package/dist/pages/trendings-v2/components/chart/utils/LocalStorageUtils.d.ts +4 -0
- package/package.json +6 -5
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,30 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## [7.8.0](https://github.com/dexteel/mesf-core-frontend/compare/@dexteel/mesf-core-v7.7.0...@dexteel/mesf-core-v7.8.0) (2025-12-22)
|
|
4
|
+
|
|
5
|
+
|
|
6
|
+
### Features
|
|
7
|
+
|
|
8
|
+
* **Trendings V2:** auto-scroll, select, and toast on tag search result click in Tags Tree V2 ([5b869fb](https://github.com/dexteel/mesf-core-frontend/commit/5b869fb6ef38b7f4f7ad8e9b8c101db774970b52))
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
### Bug Fixes
|
|
12
|
+
|
|
13
|
+
* **Trendings V2:** Fix wiping of views when saving ([33ca2d4](https://github.com/dexteel/mesf-core-frontend/commit/33ca2d413b4adddc48692f93eb1f3804339a9bc3))
|
|
14
|
+
|
|
15
|
+
## [7.7.0](https://github.com/dexteel/mesf-core-frontend/compare/@dexteel/mesf-core-v7.6.0...@dexteel/mesf-core-v7.7.0) (2025-12-22)
|
|
16
|
+
|
|
17
|
+
|
|
18
|
+
### Features
|
|
19
|
+
|
|
20
|
+
* **Trendings V2:** add resizable-panels to Trendings V2 ([9c7dd08](https://github.com/dexteel/mesf-core-frontend/commit/9c7dd0846792dc3a8f18f7c70f4cc7e3db98650a))
|
|
21
|
+
|
|
22
|
+
|
|
23
|
+
### Bug Fixes
|
|
24
|
+
|
|
25
|
+
* **CreateProfile:** add validation to ProfileName field to prevent whitespace input ([#573](https://github.com/dexteel/mesf-core-frontend/issues/573)) ([0c31f95](https://github.com/dexteel/mesf-core-frontend/commit/0c31f95a87286bc8a7dd9247ad37e05051227b8e))
|
|
26
|
+
* **Trendings V2:** fix autoscale functionality ([3ce4265](https://github.com/dexteel/mesf-core-frontend/commit/3ce42652c305afa5391abd5cbe835c17f248b2bf))
|
|
27
|
+
|
|
3
28
|
## [7.6.0](https://github.com/dexteel/mesf-core-frontend/compare/@dexteel/mesf-core-v7.5.2...@dexteel/mesf-core-v7.6.0) (2025-12-17)
|
|
4
29
|
|
|
5
30
|
|
package/GEMINI.md
ADDED
|
@@ -0,0 +1,92 @@
|
|
|
1
|
+
# @dexteel/mesf-core
|
|
2
|
+
|
|
3
|
+
## Project Overview
|
|
4
|
+
|
|
5
|
+
`@dexteel/mesf-core` is a React component library built with TypeScript and bundled using Rollup. It provides a comprehensive set of components, contexts, and utilities designed for building Manufacturing Execution Systems (MES). It acts as a core foundation for MESF-based applications, handling common concerns like authentication, navigation, settings, and layout.
|
|
6
|
+
|
|
7
|
+
**Key Technologies:**
|
|
8
|
+
* **Core:** React 18, TypeScript
|
|
9
|
+
* **Build Tool:** Rollup
|
|
10
|
+
* **UI Framework:** Material-UI (MUI) v6
|
|
11
|
+
* **Data Grid:** AG Grid
|
|
12
|
+
* **Data Visualization:** Chart.js, ECharts
|
|
13
|
+
* **State Management:** React Context, Redux Toolkit, React Query
|
|
14
|
+
* **Authentication:** Azure MSAL
|
|
15
|
+
* **Real-time:** SignalR
|
|
16
|
+
|
|
17
|
+
## Building and Running
|
|
18
|
+
|
|
19
|
+
This project is a library, so "running" it typically means building it for consumption or watching for changes while linked to a consuming application.
|
|
20
|
+
|
|
21
|
+
* **Build for Production:**
|
|
22
|
+
```bash
|
|
23
|
+
npm run build
|
|
24
|
+
```
|
|
25
|
+
This cleans the `dist` folder and runs Rollup to produce the production bundle.
|
|
26
|
+
|
|
27
|
+
* **Watch Mode (Development):**
|
|
28
|
+
```bash
|
|
29
|
+
npm run watch
|
|
30
|
+
# OR
|
|
31
|
+
npm start
|
|
32
|
+
```
|
|
33
|
+
This runs Rollup in watch mode, rebuilding on file changes.
|
|
34
|
+
|
|
35
|
+
* **CI Build:**
|
|
36
|
+
```bash
|
|
37
|
+
npm run ci
|
|
38
|
+
```
|
|
39
|
+
Performs a clean build suitable for CI environments.
|
|
40
|
+
|
|
41
|
+
* **Type Check:**
|
|
42
|
+
```bash
|
|
43
|
+
npm run type-check
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
## Development Conventions
|
|
47
|
+
|
|
48
|
+
* **Code Formatting:** The project uses [Biome](https://biomejs.dev/) for formatting and organizing imports.
|
|
49
|
+
* Run check and fix: `npx @biomejs/biome check --write ./src`
|
|
50
|
+
* **Note:** A pre-commit hook is configured to automatically run Biome on staged files.
|
|
51
|
+
* **Linting:** Linting rules are currently disabled in `biome.json`.
|
|
52
|
+
|
|
53
|
+
* **Project Structure:**
|
|
54
|
+
* `src/index.ts`: The main entry point that exports all public APIs (components, hooks, utilities).
|
|
55
|
+
* `src/MESFMain.tsx`: The main "shell" component that wraps the application with necessary providers (Auth, Theme, Router, etc.).
|
|
56
|
+
|
|
57
|
+
## Architecture
|
|
58
|
+
|
|
59
|
+
The library follows a modular architecture designed to be consumed as a single package.
|
|
60
|
+
|
|
61
|
+
### Key Components & Modules
|
|
62
|
+
|
|
63
|
+
* **`MESFMain`**: The top-level component that consumes applications should use. It accepts `routes`, `navbar`, and `authentication` configuration, setting up the entire application shell.
|
|
64
|
+
* **Contexts**: Extensive use of React Context for global state:
|
|
65
|
+
* `userContext`: Authentication and user profile.
|
|
66
|
+
* `UTLSettingContext`: User settings and preferences.
|
|
67
|
+
* `assetContext`: Management of plant assets.
|
|
68
|
+
* `LogbookSettingsContext`: Configuration for logbook features.
|
|
69
|
+
* **Services**: `src/services` contains singletons for API communication (`ApiService`) and time handling (`TimeService`).
|
|
70
|
+
* **Configuration**: `src/configuration` contains admin modules and pages for managing system settings.
|
|
71
|
+
|
|
72
|
+
### Directory Map
|
|
73
|
+
|
|
74
|
+
* `src/account/`: Authentication logic (Azure AD, Login strategies).
|
|
75
|
+
* `src/components/`: Reusable UI components (Modals, Navigation, Shared buttons/icons).
|
|
76
|
+
* `src/configuration/`: Admin pages and configuration logic.
|
|
77
|
+
* `src/context/`: React Context providers.
|
|
78
|
+
* `src/controls/`: Complex form controls (Asset pickers, Tree pickers, Date filters).
|
|
79
|
+
* `src/hooks/`: Custom hooks (e.g., `useMesfRealtime`).
|
|
80
|
+
* `src/pages/`: Domain-specific pages provided by the core (Logbook, Trending, SP Executor).
|
|
81
|
+
* `src/utils/`: Helper functions.
|
|
82
|
+
|
|
83
|
+
## Dependencies
|
|
84
|
+
|
|
85
|
+
This library relies heavily on **peer dependencies**. Consuming applications are expected to provide:
|
|
86
|
+
* React & React DOM
|
|
87
|
+
* Material-UI (MUI) components & styling
|
|
88
|
+
* AG Grid
|
|
89
|
+
* React Router DOM
|
|
90
|
+
* Date management libraries (Moment, Date-fns)
|
|
91
|
+
|
|
92
|
+
Check `package.json` for the full list of peer dependencies and their required versions.
|