@cxbox-ui/core 1.34.1 → 1.34.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 +1 -1
- package/README.md +61 -29
- package/cxbox-ui-core.js +19 -19
- package/cxbox-ui-core.js.map +1 -1
- package/interfaces/filters.js.map +1 -1
- package/interfaces/objectMap.js.map +1 -1
- package/interfaces/operation.js.map +1 -1
- package/interfaces/router.js.map +1 -1
- package/interfaces/view.js.map +1 -1
- package/interfaces/widget.js.map +1 -1
- package/package.json +2 -2
package/LICENSE
CHANGED
|
@@ -186,7 +186,7 @@
|
|
|
186
186
|
same "printed page" as the copyright notice for easier
|
|
187
187
|
identification within third-party archives.
|
|
188
188
|
|
|
189
|
-
Copyright
|
|
189
|
+
Copyright 2022 OOO "SI IKS LAB"
|
|
190
190
|
|
|
191
191
|
Licensed under the Apache License, Version 2.0 (the "License");
|
|
192
192
|
you may not use this file except in compliance with the License.
|
package/README.md
CHANGED
|
@@ -1,22 +1,69 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
1
|
+
<h2 align="center">CXBOX UI</h2>
|
|
2
|
+
|
|
3
|
+
<div align="center">
|
|
4
|
+
<a href="https://github.com/CX-Box/cxbox-ui/actions/workflows/build.yml"><img src="https://github.com/CX-Box/cxbox-ui/actions/workflows/build.yml/badge.svg" title="">
|
|
5
|
+
</a>
|
|
6
|
+
<a href="https://sonarcloud.io/summary/overall?id=CX-Box_cxbox-ui"><img src="https://sonarcloud.io/api/project_badges/measure?project=CX-Box_cxbox-ui&metric=alert_status&branch=main" alt="sonar" title="">
|
|
7
|
+
</a>
|
|
8
|
+
</div>
|
|
9
|
+
|
|
10
|
+
<blockquote>
|
|
11
|
+
<div>
|
|
12
|
+
<p align="center">
|
|
13
|
+
<h4 align="center">CXBOX - Rapid Enterprise Level Application Development Platform</h4>
|
|
14
|
+
|
|
15
|
+
<p align="center">
|
|
16
|
+
<a href="http://www.apache.org/licenses/LICENSE-2.0"><img src="https://img.shields.io/badge/license-Apache%20License%202.0-blue.svg?style=flat" alt="license" title=""></a>
|
|
17
|
+
</p>
|
|
18
|
+
|
|
19
|
+
<div align="center">
|
|
20
|
+
<h3>
|
|
21
|
+
<a href="https://cxbox.org/" target="_blank">
|
|
22
|
+
Website
|
|
23
|
+
</a>
|
|
24
|
+
<span> | </span>
|
|
25
|
+
<a href="http://demo.cxbox.org/" target="_blank">
|
|
26
|
+
Demo
|
|
27
|
+
</a>
|
|
28
|
+
<span> | </span>
|
|
29
|
+
<a href="https://doc.cxbox.org/" target="_blank">
|
|
30
|
+
Documentation
|
|
31
|
+
</a>
|
|
32
|
+
</h3>
|
|
33
|
+
|
|
34
|
+
</div>
|
|
35
|
+
|
|
36
|
+
|
|
37
|
+
|
|
38
|
+
<h3>Description</h2>
|
|
39
|
+
<p>
|
|
40
|
+
CXBOX main purpose is to speed up development of typical Enterprise Level Application based on Spring Boot. A fixed
|
|
41
|
+
contract with a user interface called <a href="https://github.com/CX-Box/cxbox-ui" target="_blank">Cxbox-UI</a> allows backend developer to create
|
|
42
|
+
typical interfaces providing just Json meta files. Full set of typical Enterprise Level UI components included -
|
|
43
|
+
widgets, fields, layouts (views), navigation (screens).
|
|
44
|
+
</p>
|
|
45
|
+
</div>
|
|
46
|
+
|
|
47
|
+
<h3>Using CXBOX</h2>
|
|
48
|
+
<ul>
|
|
49
|
+
<li> <a href="https://plugins.jetbrains.com/plugin/19523-tesler-helper" target="_blank">download Intellij Plugin</a> adds platform specific autocomplete, inspection, navigation and code generation features.
|
|
50
|
+
</li>
|
|
51
|
+
<li>
|
|
52
|
+
<a href="https://github.com/CX-Box/cxbox-demo" target="_blank">download Demo</a> and follow <a href="https://github.com/CX-Box/cxbox-demo#readme" target="_blank">README.md</a> instructions. Feel free to use demo as template project to start your own projects
|
|
53
|
+
</li>
|
|
54
|
+
</ul>
|
|
55
|
+
</blockquote>
|
|
56
|
+
|
|
57
|
+
# CXBOX UI
|
|
58
|
+
|
|
59
|
+
## Main concepts
|
|
13
60
|
|
|
14
61
|
UI side of Cxbox framework is based on a concept of configurable dashboards ("views") with widgets. Visually widgets could be represented as a card with a table, graph, form or something more exotic inside.
|
|
15
62
|
Internally, every widget has a direct link to an entity that we call "business component" (BC). BC controls what data is displayed on widget and whhich interactions are available to the user. Interactions could be a simple filtration or some complex business process, initiated through Cxbox API.
|
|
16
63
|
Information about loaded views and widgets grouped into "screens" and stored in application Redux store.
|
|
17
64
|
Client applications could reuse, extend and customize that functionality by providing its own reducers and epics, widgets and ui controls.
|
|
18
65
|
|
|
19
|
-
|
|
66
|
+
## Installation
|
|
20
67
|
|
|
21
68
|
Cxbox UI distributed in form of ES5 compatible npm package:
|
|
22
69
|
```sh
|
|
@@ -25,7 +72,7 @@ yarn add @cxbox-ui/core
|
|
|
25
72
|
|
|
26
73
|
Several libraries are specified as peer dependencies and should be installed for client application: react, react-dom, redux, react-redux, rxjs, redux-observable, antd, axios.
|
|
27
74
|
|
|
28
|
-
|
|
75
|
+
## Usage
|
|
29
76
|
|
|
30
77
|
<Provider> component provides configurable Redux context and should be used on top level of your application:
|
|
31
78
|
|
|
@@ -61,21 +108,6 @@ function mapStateToProps(store) {
|
|
|
61
108
|
export default connect(mapStateToProps)(ClientComponent)
|
|
62
109
|
```
|
|
63
110
|
|
|
64
|
-
# Documentation
|
|
65
|
-
|
|
66
|
-
The documentation is divided into several sections:
|
|
67
|
-
* [Tutorial](http://idocs.cxbox.io/ui/#/screen/tutorial)
|
|
68
|
-
* [Components Overview](http://idocs.cxbox.io/ui/#/screen/components)
|
|
69
|
-
* [Features](http://idocs.cxbox.io/ui/#/screen/features)
|
|
70
|
-
* [API Reference](https://CX-Box.github.io/cxbox-ui)
|
|
71
|
-
|
|
72
|
-
You could also check our [changelog section](https://github.com/CX-Box/cxbox-ui/blob/main/CHANGELOG.md).
|
|
73
|
-
|
|
74
|
-
# Reporting an error
|
|
75
|
-
|
|
76
|
-
In case you've encountered a problem, please open an issue with reproducible example and detailed description.
|
|
77
|
-
If you are also willing to provide a fix, please check our [contributing guide](https://github.com/CX-Box/cxbox-ui/blob/main/CONTRIBUTING.md)!
|
|
78
|
-
|
|
79
111
|
# Contributing
|
|
80
112
|
|
|
81
113
|
All contributions are welcomed, as even a minor pull request with grammar fixes or a single documentation update is of a significant help for us!
|