round-core 0.1.1 → 0.1.3

package/README.md

@@ -20,7 +20,7 @@ Extension for [VSCode](https://marketplace.visualstudio.com/items?itemName=ZtaMD
 
 --- 
 
-Instead of a Virtual DOM diff, Round updates the UI by subscribing DOM updates directly to reactive primitives (**signals**) and **bindables**. This keeps rendering predictable, small, and fast for interactive apps.
+Instead of a Virtual DOM diff, Round updates the UI by subscribing DOM updates directly to reactive primitives **signals** and **bindables**. This keeps rendering predictable, small, and fast for interactive apps.
 
 The `round-core` package is the **foundation of RoundJS**.
 
@@ -163,6 +163,23 @@ effect(() => {
 name('Grace');
 ```
 
+### `untrack(fn)`
+
+Run a function without tracking any signals it reads.
+
+```javascript
+import { signal, untrack, effect } from 'round-core';
+
+const count = signal(0);
+effect(() => {
+    console.log('Count is:', count());
+    untrack(() => {
+        // This read won't trigger the effect if it changes elsewhere
+        console.log('Static value:', count());
+    });
+});
+```
+
 ### `bindable(initialValue)`
 
 `bindable()` creates a signal intended for **two-way DOM bindings**.
@@ -206,14 +223,24 @@ export function TodoList() {
     
     return (
         <div>
-            {todos().map(todo => <div>{todo.text}</div>)}
+            {for(todo in todos()){
+                <div>{todo.text}</div>
+            }}
             <button onClick={() => store.addTodo('Buy Milk')}>Add</button>
         </div>
     );
 }
 
 // 3. Persistence (Optional)
-store.persist('my-app-store'); 
+store.persist('my-app-store', { 
+    debounce: 100, // ms
+    exclude: ['someSecretKey'] 
+}); 
+
+// 4. Advanced Methods
+store.patch({ filter: 'completed' }); // Update multiple keys at once
+const data = store.snapshot({ reactive: false }); // Get static JSON of state
+store.set('todos', []); // Direct set
 ```
 
 ### `bindable.object(initialObject)` and deep binding
@@ -241,6 +268,38 @@ export function Profile() {
 }
 ```
 
+## Lifecycle Hooks
+
+Round provides hooks to tap into the lifecycle of components. These must be called during the synchronous execution of your component function.
+
+### `onMount(fn)`
+Runs after the component is first created and its elements are added to the DOM. If `fn` returns a function, it's used as a cleanup (equivalent to `onUnmount`).
+
+### `onUnmount(fn)`
+Runs when the component's elements are removed from the DOM.
+
+### `onUpdate(fn)`
+Runs whenever any signal read during the component's *initial* render is updated.
+
+### `onCleanup(fn)`
+Alias for `onUnmount`.
+
+```jsx
+import { onMount, onUnmount } from 'round-core';
+
+export function MyComponent() {
+    onMount(() => {
+        console.log('Mounted!');
+        const timer = setInterval(() => {}, 1000);
+        return () => clearInterval(timer); // Cleanup
+    });
+
+    onUnmount(() => console.log('Goodbye!'));
+
+    return <div>Hello</div>;
+}
+```
+
 ### `.validate(validator, options)`
 
 Attach validation to a signal/bindable.
@@ -398,6 +457,22 @@ Round aims to provide strong developer feedback:
 - Runtime error reporting with safe boundaries.
 - `ErrorBoundary` to catch render-time errors and show a fallback.
 
+### `ErrorBoundary`
+
+Wrap components to prevent the whole app from crashing if a child fails to render.
+
+```jsx
+import { ErrorBoundary } from 'round-core';
+
+function DangerousComponent() {
+    throw new Error('Boom!');
+}
+
+<ErrorBoundary fallback={(err) => <div className="error">Something went wrong: {err.message}</div>}>
+    <DangerousComponent />
+</ErrorBoundary>
+```
+
 ## CLI
 
 The CLI is intended for day-to-day development:

package/package.json

@@ -1,26 +1,36 @@
 {
     "name": "round-core",
-    "version": "0.1.1",
+    "version": "0.1.3",
     "description": "A lightweight frontend framework for SPA with signals and fine grained reactivity",
-    "main": "./dist/index.js",
-    "types": "./dist/index.d.ts",
+    "main": "./src/index.js",
+    "types": "./src/index.d.ts",
     "readme": "README.md",
     "exports": {
-        ".": "./dist/index.js",
-        "./vite-plugin": "./dist/vite-plugin.js"
+        ".": {
+            "types": "./src/index.d.ts",
+            "default": "./src/index.js"
+        },
+        "./vite-plugin": {
+            "types": "./src/compiler/vite-plugin.d.ts",
+            "default": "./src/compiler/vite-plugin.js"
+        }
     },
+    "files": [
+        "src",
+        "README.md",
+        "LICENSE"
+    ],
     "type": "module",
     "icon": "Round.png",
     "repository": {
         "url": "https://github.com/ZtaMDev/RoundJS.git"
     },
     "bin": {
-        "round": "./dist/cli.js"
+        "round": "./src/cli.js"
     },
     "scripts": {
         "dev": "node ./src/cli.js dev --config ./test/main/round.config.json",
         "build": "node ./src/cli.js build --config ./test/main/round.config.json",
-        "build:core": "vite build -c vite.config.build.js",
         "bench": "bun run --cwd benchmarks bench",
         "bench:build": "bun run --cwd benchmarks bench:build",
         "bench:runtime": "bun run --cwd benchmarks bench:runtime"
@@ -33,11 +43,7 @@
     ],
     "author": "Round Framework Team",
     "license": "MIT",
-    "files": [
-        "dist"
-    ],
     "dependencies": {
-        "marked": "^12.0.2",
         "vite": "^5.0.0"
     },
     "devDependencies": {