vasille-jsx 5.0.0 → 5.1.0

package/README.md

@@ -2,9 +2,11 @@
 
 ![Vasille.js logo](https://raw.githubusercontent.com/vasille-js/vasille-js/refs/heads/v5/doc/img/logo.png)
 
-`SteelFrameKit` is a front-end development kit, which is developed to provide bulletproof frontends.
+`SteelFrameKit` is a front-end development kit, which is developed to provide fault tolerant web applications.
 
-[![npm](https://img.shields.io/npm/v/vasille?style=flat-square)](https://www.npmjs.com/package/vasille)
+[![npm](https://img.shields.io/npm/v/steel-frame?style=round-square)](https://www.npmjs.com/package/steel-frame)
+[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/vasille-js/steel-frame)
+[![Coverage Status](https://coveralls.io/repos/github/vasille-js/steel-frame/badge.svg?branch=v5)](https://coveralls.io/github/vasille-js/steel-frame?branch=v5)
 
 ## Table of content
 
@@ -19,11 +21,12 @@
   - [How POWERFUL is SteelFrameKit](#how-powerful-is-steelframekit)
   - [Road map](#road-map)
   - [Change log](#change-log)
-    - [5.0.0](#500)
-    - [4.3.0](#430)
-    - [4.2.0](#420)
-    - [4.1.0](#410)
-    - [4.0.0](#400)
+    - [5.1](#51)
+    - [5.0](#50)
+    - [4.0 - 4.3](#40---43)
+    - [3.0 - 3.2](#30---32)
+    - [2.0 - 2.3](#20---23)
+    - [1.0 - 1.2](#10---12)
   - [Questions](#questions)
 
 
@@ -44,10 +47,10 @@ $ npm create steel-frame
 ```
 
 ### Full documentation:
-* [Learn `SteelFrameKit` in 5 minutes](https://github.com/vasille-js/vasille-js/blob/v4/doc/V4-API.md)
-* [Router Documentation](https://github.com/vasille-js/vasille-js/blob/v4/doc/Router-API.md)
-* [Compostion functions](https://github.com/vasille-js/vasille-js/blob/v4/doc/Compositions.md)
-* [Dependency injection](https://github.com/vasille-js/vasille-js/blob/v4/doc/Context.md)
+* [Learn `SteelFrameKit` in 5 minutes](https://github.com/vasille-js/vasille-js/blob/v5/doc/V4-API.md)
+* [Router Documentation](https://github.com/vasille-js/vasille-js/blob/v5/doc/Router-API.md)
+* [Compostion functions](https://github.com/vasille-js/vasille-js/blob/v5/doc/Compositions.md)
+* [Dependency injection](https://github.com/vasille-js/vasille-js/blob/v5/doc/Context.md)
 
 ### Examples
 * [TypeScript Example](https://github.com/vasille-js/example-typescript)
@@ -92,7 +95,7 @@ All of these are supported:
 * Reactive values (observables).
 * Inline computed values.
 * Multiline computed values.
-* HTML & SVG tags.
+* HTML tags.
 * Component custom slots.
 * 2-way data binding in components.
 * Logic block (if, else).
@@ -103,7 +106,6 @@ All of these are supported:
 
 ## Road map
 
-* [x] Update the `core` library to version 3.0.
 * [x] `100%` Test Coverage for core Library v3.
 * [x] Develop the `JSX` library.
 * [x] `100%` Test Coverage for the JSX library.
@@ -117,25 +119,47 @@ All of these are supported:
 
 ## Change log
 
-### 5.0.0
+We respect semantic versioning:
+- A major version is increased when we make incompatible API changes.
+- A minor version is increased when we add functionality.
+- Patch version is increased when we fix bugs.
 
-Add support for context and dependencies injection.
+### 5.1
 
-### 4.3.0
+Add support for web components compile target `web build components`.
+_Web components as custom tags are supported in any version._
 
-Add new function `safe` which make functions safe, errors are reported automatically.
+### 5.0
 
-### 4.2.0
+- Add support for context and dependencies injection.
+- New developement direction: `fault tolerant`.
+- Renamed to `steel-frame`. **[API change]**
+- Removed `forward` and `backward` functions. **[API change]**
+- Removed `Debug` component. **[API change]**
 
-Add support for inlined conditions in JSX, binary `&&` and ternary `?:` operator.
+### 4.0 - 4.3
 
-### 4.1.0
+- Initial version of the framework with file based routing and building scripts (`web dev` and `web build spa`).
+- Reactive values naming switched to `$` prefix. **[API change]**
+- `4.1` Added SSG (static site generation) as build option `web build static`.
+- `4.2` Add support for inlined conditions in JSX, binary `&&` and ternary `?:` operator.
+- `4.3` Add new function `safe` which make functions safe, errors are reported automatically.
 
-Added SSG (static site generation) as build option `sf build static`.
+### 3.0 - 3.2
 
-### 4.0.0
+- Switch to a babel plugin to compile components code. **[API change]**
+- 100% of the code has been covered with unit tests.
+- New developement direction: `keep it simple`.
 
-Initial version of the framework with file based routing and building scripts (`sf dev` and `sf build spa`).
+### 2.0 - 2.3
+
+- Introduces components compilation via a typescript plugin. **[API change]**
+- New developement direction: `write less, do more`.
+
+### 1.0 - 1.2
+
+- Initial version of a core library.
+- Developemnt direction: `performance-first`.
 
 ## Questions
 

package/lib/dev/components.js

@@ -15,7 +15,7 @@ export function DevSlot({ model, slot, ...options }, ctx, defaultSlot, usage) {
     catch (e) {
         ctx.runner.inspector.reportComponentSlotError({
             targetId: "id" in ctx && typeof ctx.id === "number" ? ctx.id : 0,
-            error: e,
+            error: e instanceof Error ? `${e.message}\n${e.stack}` : `${e}`,
             usage: usage,
             time: Date.now(),
         });

package/lib/dev/compose.js

@@ -21,7 +21,7 @@ export function devView(renderer, declaration, name) {
         catch (e) {
             node.runner.inspector.reportComponentError({
                 targetId: frag.id,
-                error: e,
+                error: e instanceof Error ? `${e.message}\n${e.stack}` : `${e}`,
                 time: Date.now(),
             });
             reportError(e);

package/lib/dev/index.js

@@ -8,9 +8,10 @@ export { AbstractInspector, EarlyInspector, earlyInspector } from "./early-inspe
 function devErrorHandler(e) {
     earlyInspector.reportError({
         targetId: 0,
-        error: e instanceof Error ? (e.stack ?? e.message) : `${e}`,
+        error: e instanceof Error ? `${e.message}\n${e.stack}` : `${e}`,
         time: Date.now(),
     });
+    console.error(e);
 }
 coreSetErrorHandler(devErrorHandler);
 export function setErrorHandler(fn) {

package/lib/internal.js

@@ -73,11 +73,3 @@ export function set(o, key, value, createRef = ref) {
     }
     return value;
 }
-export function forward(value) {
-    return new Expression(v => v, [value]);
-}
-export function backward(value) {
-    const r = new Reference(value.V);
-    r.on(v => (value.V = v));
-    return r;
-}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vasille-jsx",
-  "version": "5.0.0",
+  "version": "5.1.0",
   "description": "The same framework which is designed to build bulletproof frontends (JSX components)",
   "main": "lib/index.js",
   "exports": {
@@ -65,6 +65,6 @@
     "typescript-eslint": "^8.39.1"
   },
   "dependencies": {
-    "vasille": "5.0.0"
+    "vasille": "^5.0.0"
   }
 }

package/types/internal.d.ts

@@ -1,4 +1,4 @@
-import { IValue, Reactive, KindOfIValue, Expression, Reference, SetModel, MapModel, ArrayModel } from "vasille";
+import { IValue, Reactive, KindOfIValue, Expression, SetModel, MapModel, ArrayModel } from "vasille";
 export declare function expr<T, Args extends unknown[]>(ctx: Reactive | undefined, func: (...args: Args) => T, values: KindOfIValue<Args>): Expression<T, Args>;
 /**
  * It transforms a non-reactive value to a reactive one.
@@ -37,5 +37,3 @@ export declare function match(name: string | number | symbol, data?: unknown, cr
  * 2. `arr[0] = 23` to `set(arr, 0, 23)`
  */
 export declare function set(o: object, key: string | symbol | number, value: unknown, createRef?: typeof ref): unknown;
-export declare function forward<T>(value: IValue<T>): Expression<T, [v: T]>;
-export declare function backward<T>(value: IValue<T>): Reference<T>;