vasille-web 5.0.0 → 5.0.2

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)
 
 
@@ -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/jsx-runtime.js

@@ -1 +1,2 @@
+const internal = Symbol("internal");
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vasille-web",
-  "version": "5.0.0",
+  "version": "5.0.2",
   "description": "The same framework which is designed to build bulletproof frontends.",
   "main": "index.js",
   "types": "./index.d.ts",

package/types/jsx-runtime.d.ts

@@ -1,24 +1,31 @@
 import type { RawStyleProps } from "./spec/css.ts";
 import type { HtmlTagMap } from "./spec/html.ts";
-type prefixedObject<T, P extends string> = {
+export type { TagEvents, TagAttrs, TagProps } from "./spec/html.ts";
+export type prefixedObject<T, P extends string> = {
     [K in keyof T as K extends string ? `${P}${K}` : never]?: T[K];
 };
-type EventHandlers<T> = {
+export type EventHandlers<T> = {
     [K in keyof T]: T[K] | [T[K], boolean | AddEventListenerOptions];
 };
 export type ClassItem = string | Record<string, boolean> | false;
+declare const internal: unique symbol;
+export interface VasilleElement {
+    [internal]: typeof internal;
+}
+export type VasilleChild = VasilleElement | string | number | boolean | null | undefined;
+export type VasilleSlot = VasilleChild | VasilleChild[];
 type HtmlInput<K extends keyof HTMLElementTagNameMap & keyof HtmlTagMap> = {
     callback?: (node: HTMLElementTagNameMap[K]) => unknown;
     class?: ClassItem[] | string;
     style?: RawStyleProps | string;
-    slot?: unknown;
+    "vasille:slot"?: VasilleSlot;
 } & Partial<HtmlTagMap[K]["attrs"]> & prefixedObject<EventHandlers<HtmlTagMap[K]["events"]>, "on"> & Partial<prefixedObject<HtmlTagMap[K]["props"], "bind:">>;
 export declare namespace JSX {
     type ElementType = keyof IntrinsicElements | ((props: any) => void);
-    type Element = never;
-    type ElementClass = never;
+    type Element = VasilleElement;
+    type ElementClass = VasilleElement;
     interface ElementChildrenAttribute {
-        slot: unknown;
+        "vasille:slot": VasilleSlot;
     }
     interface IntrinsicElements {
         a: HtmlInput<"a">;
@@ -133,4 +140,3 @@ export declare namespace JSX {
         wbr: HtmlInput<"wbr">;
     }
 }
-export {};

package/types/spec/html.d.ts

@@ -4,10 +4,10 @@ export interface Tag<Attrs, Events, Props> {
     events: Events;
     props: Props;
 }
-type TagEvents<Target> = {
+export type TagEvents<Target> = {
     [K in keyof HTMLElementEventMap]: EventHandler<HTMLElementEventMap[K], Target> | undefined;
 };
-interface TagAttrs {
+export interface TagAttrs {
     id: string;
     accesskey: string;
     autocapitalize: "off" | "none" | "on" | "sentences" | "words" | "characters";
@@ -27,6 +27,8 @@ interface TagAttrs {
     itemtype: string;
     lang: string;
     nonce: string;
+    part: string;
+    slot: string;
     spellcheck: "true" | "false" | "" | boolean;
     tabindex: number;
     title: string;
@@ -97,6 +99,7 @@ interface AAttrs extends TagAttrs {
     hreflang: string;
     type: string;
     referrerpolicy: string;
+    rel: string;
 }
 interface QAttrs extends TagAttrs {
     cite: string;
@@ -520,7 +523,7 @@ export interface TagEventsProps<T extends Element> {
     onwaiting?: ((this: T, ev: Event) => any) | null;
     onwheel?: ((this: T, ev: WheelEvent) => any) | null;
 }
-interface TagProps<T extends Element> extends TagEventsProps<T> {
+export interface TagProps<T extends Element> extends TagEventsProps<T> {
     autofocus?: boolean;
     className?: string;
     nonce?: string | undefined;