vasille-web 0.99.1
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 +122 -0
- package/index-node.js +4 -0
- package/index.d.ts +17 -0
- package/index.js +18 -0
- package/package.json +35 -0
package/README.md
ADDED
|
@@ -0,0 +1,122 @@
|
|
|
1
|
+
# Vasille
|
|
2
|
+
|
|
3
|
+

|
|
4
|
+
|
|
5
|
+
`Vasille Web` is a front-end framework, which is developed to provide the best `developer experience` ever. **Our goal is to keep is as simple as possible.** Developing web applications using Vasille must be *as fast as possible*.
|
|
6
|
+
|
|
7
|
+
[](https://www.npmjs.com/package/vasille)
|
|
8
|
+
|
|
9
|
+
## Table of content
|
|
10
|
+
|
|
11
|
+
* [Installation](#installation)
|
|
12
|
+
* [How to use Vasille](#how-to-use-vasille)
|
|
13
|
+
* [How SAFE is Vasille](#how-safe-is-vasille)
|
|
14
|
+
* [How SIMPLE is Vasille](#how-simple-is-vasille)
|
|
15
|
+
* [How POWERFUL is Vasille](#how-powerful-is-vasille)
|
|
16
|
+
* [Road Map](#road-map)
|
|
17
|
+
|
|
18
|
+
|
|
19
|
+
<hr>
|
|
20
|
+
|
|
21
|
+
## Installation
|
|
22
|
+
|
|
23
|
+
```
|
|
24
|
+
npm install vasille-web --save
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
## How to use Vasille
|
|
28
|
+
|
|
29
|
+
Create an app from a template
|
|
30
|
+
|
|
31
|
+
```bash
|
|
32
|
+
$ npm create vasille
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
Alternative method to create a TypeScript app.
|
|
36
|
+
```bash
|
|
37
|
+
$ npx degit vasille-js/example-typescript my-project
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
Alternative method to create a JavaScript app.
|
|
41
|
+
```bash
|
|
42
|
+
$ npx degit vasille-js/example-javascript my-project
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
### Full documentation:
|
|
46
|
+
* [Learn `Vasille` in 5 minutes](https://github.com/vasille-js/vasille-js/blob/v3/doc/V3-API.md)
|
|
47
|
+
|
|
48
|
+
### Examples
|
|
49
|
+
* [TypeScript Example](https://github.com/vasille-js/example-typescript)
|
|
50
|
+
* [JavaScript Example](https://github.com/vas[README.md](..%2Ftest%2Fmy-app%2FREADME.md)ille-js/example-javascript)
|
|
51
|
+
|
|
52
|
+
<hr>
|
|
53
|
+
|
|
54
|
+
## How SAFE is Vasille
|
|
55
|
+
|
|
56
|
+
The safe of your application is ensured by
|
|
57
|
+
* `100%` coverage of code by unit tests.
|
|
58
|
+
Each function, each branch is working as designed.
|
|
59
|
+
* OOP, DRY, KISS and SOLID principles are applied.
|
|
60
|
+
* `strong typing` makes your javascript/typescript code safe as C++ code.
|
|
61
|
+
All entities of `vasille` core library are strongly typed, including:
|
|
62
|
+
* data fields & properties.
|
|
63
|
+
* computed properties (function parameters & result).
|
|
64
|
+
* methods.
|
|
65
|
+
* events (defined handlers & event emit).
|
|
66
|
+
* DOM events & DOM operation (attributing, styling, etc.).
|
|
67
|
+
* slots of components.
|
|
68
|
+
* references to children.
|
|
69
|
+
* No asynchronous code, when the line of code is executed, the DOM and reactive things are already synced.
|
|
70
|
+
|
|
71
|
+
## How SIMPLE is Vasille
|
|
72
|
+
|
|
73
|
+
There is the "Hello World":
|
|
74
|
+
```typescript jsx
|
|
75
|
+
import { compose, mount } from "vasille-dx";
|
|
76
|
+
|
|
77
|
+
const App = compose(() => {
|
|
78
|
+
<p>Hello world</p>;
|
|
79
|
+
});
|
|
80
|
+
|
|
81
|
+
mount(document.body, App, {});
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
## How POWERFUL is Vasille
|
|
85
|
+
|
|
86
|
+
All of these are supported:
|
|
87
|
+
* Components.
|
|
88
|
+
* Reactive values (observables).
|
|
89
|
+
* Inline computed values.
|
|
90
|
+
* Multiline computed values.
|
|
91
|
+
* HTML & SVG tags.
|
|
92
|
+
* Component custom slots.
|
|
93
|
+
* 2-way data binding in components.
|
|
94
|
+
* Logic block (if, else).
|
|
95
|
+
* Loops (array, map, set).
|
|
96
|
+
|
|
97
|
+
<hr>
|
|
98
|
+
|
|
99
|
+
## Road map
|
|
100
|
+
|
|
101
|
+
* [x] Update the `Vasille Core` library to version 3.0.
|
|
102
|
+
* [x] `100%` Test Coverage for core Library v3.
|
|
103
|
+
* [x] Develop the `Vasille JSX` library.
|
|
104
|
+
* [x] `100%` Test Coverage for the JSX library.
|
|
105
|
+
* [x] Develop the `Vasille Babel Plugin`.
|
|
106
|
+
* [ ] `100%` Test Coverage fot babel plugin.
|
|
107
|
+
* [ ] Add CSS support (define styles in components).
|
|
108
|
+
* [ ] Add custom `<input/>` components with 2-way value binding.
|
|
109
|
+
* [ ] Add router.
|
|
110
|
+
* [ ] Develop dev-tools extension for debugging.
|
|
111
|
+
* [ ] Develop a lot of libraries for the framework.
|
|
112
|
+
|
|
113
|
+
## Questions
|
|
114
|
+
|
|
115
|
+
If you have questions, feel free to contact the maintainer of the project:
|
|
116
|
+
|
|
117
|
+
* [Author's Email](mailto:vas.lixcode@gmail.com)
|
|
118
|
+
* [Author's Telegram](https://t.me/lixcode)
|
|
119
|
+
|
|
120
|
+
<hr>
|
|
121
|
+
|
|
122
|
+
**Made in Moldova** 🇲🇩
|
package/index-node.js
ADDED
package/index.d.ts
ADDED
package/index.js
ADDED
package/package.json
ADDED
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "vasille-web",
|
|
3
|
+
"version": "0.99.1",
|
|
4
|
+
"description": "Front-end framework with best developer experience ever.",
|
|
5
|
+
"main": "index.js",
|
|
6
|
+
"types": "./index.d.ts",
|
|
7
|
+
"exports": {
|
|
8
|
+
"import": "./index.js",
|
|
9
|
+
"browser": "./index.js"
|
|
10
|
+
},
|
|
11
|
+
"scripts": {
|
|
12
|
+
"prepack": "cp -f ../README.md ./README.md"
|
|
13
|
+
},
|
|
14
|
+
"repository": {
|
|
15
|
+
"type": "git",
|
|
16
|
+
"url": "git+https://github.com/vasille-js/vasille-js.git"
|
|
17
|
+
},
|
|
18
|
+
"keywords": [
|
|
19
|
+
"frontend",
|
|
20
|
+
"dx",
|
|
21
|
+
"fast",
|
|
22
|
+
"simple",
|
|
23
|
+
"secure"
|
|
24
|
+
],
|
|
25
|
+
"author": "lixcode",
|
|
26
|
+
"license": "MIT",
|
|
27
|
+
"bugs": {
|
|
28
|
+
"url": "https://github.com/vasille-js/vasille-js/issues"
|
|
29
|
+
},
|
|
30
|
+
"homepage": "https://github.com/vasille-js/vasille-js#readme",
|
|
31
|
+
"dependencies": {
|
|
32
|
+
"babel-plugin-vasille": "^0.99.0",
|
|
33
|
+
"vasille-dx": "^3.0.1"
|
|
34
|
+
}
|
|
35
|
+
}
|