steel-frame 7.1.2 → 7.2.0

package/README.md

@@ -23,7 +23,7 @@ but it hasn't changed what it cost to be wrong, `Steel Frame` do it.
   - [How POWERFUL is Steel Frame](#how-powerful-is-steel-frame)
   - [Road map](#road-map)
   - [Change log](#change-log)
-    - [7.0](#70)
+    - [7.0 - 7.2](#70---72)
     - [6.0 RC (never released)](#60-rc-never-released)
     - [5.0 - 5.1](#50---51)
     - [4.0 - 4.3](#40---43)
@@ -133,12 +133,10 @@ We respect semantic versioning:
 - A minor version is increased when we add functionality.
 - Patch version is increased when we fix bugs.
 
-### 7.1
-
-- Add support for ARIA attributtes.
-
-### 7.0
+### 7.0 - 7.2
 
+- **7.2**: Add models to reactive conversion of buildin models.
+- **7.1**: Add support for ARIA attributtes.
 - Add `debounced` and `field` functions, which extend the reativity system.
 - Add `Zombie` component, it keeps HTML elements alive some time after destruction.
 - Add `abortSignal` to cancel fetch requests and timers when component is destroyed.

package/build/export/index.d.ts

@@ -1,6 +1,7 @@
-import { AppNode, ArrayModel, MapModel, SetModel, ScreenProps } from "vasille";
+import { AppNode, ScreenProps } from "vasille";
 import type { VasilleSlot } from "vasille-web/jsx-runtime";
 import { WebRouter, WebTagOptions, CssStyleInjector, StyleSheetProps } from "vasille-web/types";
+import { ArrayModel, MapModel, SetModel } from "./models.js";
 export { safe } from "vasille";
 /** Set a handler for component errors */
 export declare function setErrorHandler(handler: (e: unknown) => void): void;
@@ -171,19 +172,19 @@ export declare function Else(props: {
     slot?: () => void;
     "vasille:slot"?: VasilleSlot;
 }): void;
-/** Renders content several times using a model (array, map or set) */
+/** Renders content several times using a model (array, map, or set) */
 export declare function For<T>(props: {
-    of: ReadonlyArray<T>;
+    of: ReadonlyArray<T> | ArrayModel<T>;
     slot?: (value: T) => void;
     "vasille:slot"?: VasilleSlot;
 }): void;
 export declare function For<T>(props: {
-    of: ReadonlySet<T>;
+    of: ReadonlySet<T> | SetModel<T>;
     slot?: (value: T) => void;
     "vasille:slot"?: VasilleSlot;
 }): void;
 export declare function For<K, T>(props: {
-    of: ReadonlyMap<K, T>;
+    of: ReadonlyMap<K, T> | MapModel<K, T>;
     slot?: (value: T, index: K) => void;
     "vasille:slot"?: VasilleSlot;
 }): void;
@@ -201,17 +202,17 @@ export declare function ArrayView<T>(props: {
 }): void;
 /** Renders content of an `array model`, which can be updated via `push`, `pull`, ... */
 export declare function ArrayModelView<T>(props: {
-    of: ReadonlyArray<T>;
+    of: ArrayModel<T>;
     slot: (value: T, r_index: number) => void;
 }): void;
 /** Renders content of a `map model`, which can be updated via `set`, `delete`, ... */
 export declare function MapModelView<K, T>(props: {
-    of: ReadonlyMap<K, T>;
+    of: MapModel<K, T>;
     slot: (r_value: T, key: K) => void;
 }): void;
 /** Renders content of a `set model`, which can be updated via `add`, `delete`, ... */
 export declare function SetModelView<T>(props: {
-    of: ReadonlySet<T>;
+    of: SetModel<T>;
     slot: (value: T) => void;
 }): void;
 /** Will be translated to for (let value of value) { slot(item) } */
@@ -389,3 +390,4 @@ export declare function impute<Class>(className: abstract new (...args: unknown[
 /** Share a setting value when it is missing */
 export declare function impute(key: string, value: string): string;
 export type { WebComponent, WebComponentAdapter, WebComponentAttributes, WebComponentEventHandler, WebComponentProps, WebComponentEvents, WebTagOptions, AttrType, StyleType, WebRouter, ElementStyleProps, IdeSide, AppSide, SsgRouterMode, NavigationMode, ClassItem, WebRouterInitialization, CssStyleInjector, StyleSheetProps, } from "vasille-web/types";
+export type { ArrayModel, MapModel, SetModel } from "./models.js";

package/build/export/models.d.ts

@@ -0,0 +1,44 @@
+/** Encapsulate an array for more comfortable editing */
+export declare class ArrayModel<T> {
+    private constructor();
+    /** Give read access to the encapsulated array */
+    get array(): readonly T[];
+    /** Pop the last item of the array */
+    pop(): T | undefined;
+    /** Append items to the end of the array */
+    push(...items: Array<T>): number;
+    /** Shift the first item of the array */
+    shift(): T | undefined;
+    /** Sort items inside the array */
+    sort(compareFn?: (a: T, b: T) => number): this;
+    /** Splice calls `Array.splice` */
+    splice(start: number, deleteCount?: number, ...items: T[]): T[];
+    /** Prepend items to the array */
+    unshift(...items: T[]): number;
+    /** Replace an item of the array */
+    replace(at: number, with_: T): this;
+}
+/** Encapsulate an array for more comfortable editing */
+export declare class SetModel<T> {
+    private constructor();
+    /** Give read access to the encapsulated data */
+    get set(): ReadonlySet<T>;
+    /** Add a new value to the set */
+    add(value: T): this;
+    /** Clear the set */
+    clear(): void;
+    /** Delete a value from the set, return true if the value was deleted */
+    delete(value: T): boolean;
+}
+/** Encapsulate an array for more comfortable editing */
+export declare class MapModel<K, T> {
+    private constructor();
+    /** Give read access to the encapsulated data */
+    get map(): ReadonlyMap<K, T>;
+    /** Clear the map */
+    clear(): void;
+    /** Delete a value from the map, return true if the value was deleted */
+    delete(key: K): boolean;
+    /** Set a new value to the map at a given key */
+    set(key: K, value: T): this;
+}

package/build/export/models.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "steel-frame",
-    "version": "7.1.2",
+    "version": "7.2.0",
     "description": "SteelFrame: Build Fault-Tolerant Web Applications Effortlessly.",
     "main": "build/cli/run.js",
     "types": "./index.d.ts",
@@ -60,7 +60,7 @@
         "@inquirer/select": "^5.2.6",
         "csstype": "^3.1.3",
         "esbuild": "^0.28.2",
-        "vasille-web": "7.1.0",
+        "vasille-web": "7.2.0",
         "vite": "^8.3.4",
         "vite-plugin-babel": "^1.7.3",
         "vite-plugin-inspect": "^12.1.0",