@getforma/core 1.0.2 → 1.0.4

package/README.md

@@ -174,7 +174,7 @@ See [The `h()` function](#the-h-function) below for the full signature and all c
 
 ### 3. HTML Runtime (no build step)
 
-Drop a script tag, write `data-*` attributes. Zero config, zero tooling — works from a CDN.
+One `<script>` tag. One HTML file. No npm, no bundler, no `node_modules`, no config files. Just open it in a browser.
 
 ```html
 <script src="https://cdn.jsdelivr.net/npm/@getforma/core@latest/dist/formajs-runtime.global.js"></script>
@@ -186,7 +186,52 @@ Drop a script tag, write `data-*` attributes. Zero config, zero tooling — work
 </div>
 ```
 
-The expression parser is hand-written — no `eval()`, no `new Function()` by default. For strict CSP environments, use the hardened build:
+That's a working reactive counter. No JavaScript file. No build step. Just HTML.
+
+**Here's what you get from a single HTML file with one script tag:**
+
+```html
+<script src="https://cdn.jsdelivr.net/npm/@getforma/core@latest/dist/formajs-runtime.global.js"></script>
+
+<div data-forma-state='{
+  "query": "",
+  "items": ["Apples", "Bananas", "Cherries", "Dates", "Elderberries"],
+  "darkMode": false
+}'>
+
+  <!-- Two-way binding: type in the input, the list filters instantly -->
+  <input data-model="{query}" placeholder="Search fruits...">
+
+  <!-- Computed value: derived from query, updates automatically -->
+  <p data-computed="matchCount = items.filter(i => i.toLowerCase().includes(query.toLowerCase())).length"
+     data-text="{'Found ' + matchCount + ' results'}"></p>
+
+  <!-- Conditional rendering: show/hide based on state -->
+  <p data-show="{query.length > 0 && matchCount === 0}">No matches found.</p>
+
+  <!-- List rendering: keyed reconciliation, only changed items re-render -->
+  <ul data-list="{items.filter(i => i.toLowerCase().includes(query.toLowerCase()))}">
+    <li>{item}</li>
+  </ul>
+
+  <!-- Event handling with $dispatch: cross-component communication -->
+  <button data-on:click="{darkMode = !darkMode}">
+    Toggle Dark Mode
+  </button>
+
+  <!-- Dynamic classes and attributes -->
+  <div data-class:dark="{darkMode}" data-bind:data-theme="{darkMode ? 'dark' : 'light'}">
+    Theme is: <span data-text="{darkMode ? 'Dark' : 'Light'}"></span>
+  </div>
+
+  <!-- Persist to localStorage: survives page refresh -->
+  <div data-persist="{darkMode}"></div>
+</div>
+```
+
+That single HTML file gives you: reactive state, two-way data binding, computed values, conditional rendering, list rendering with filtering, event handling, dynamic CSS classes, dynamic attributes, and localStorage persistence. **No JavaScript written. No build tools installed.**
+
+The expression parser is hand-written and CSP-safe — no `eval()`, no `new Function()` by default. For strict CSP environments, use the hardened build:
 
 ```html
 <script src="https://cdn.jsdelivr.net/npm/@getforma/core@latest/dist/formajs-runtime-hardened.global.js"></script>
@@ -767,18 +812,28 @@ See the [`examples/`](./examples) directory:
 
 ---
 
-## Ecosystem
+## Part of the Forma Stack
 
-FormaJS is the reactive frontend layer of a full-stack Rust + TypeScript framework.
+### Frontend (TypeScript)
 
-| Package | Language | Description |
-|---|---|---|
-| [@getforma/core](https://www.npmjs.com/package/@getforma/core) | TypeScript | This library — reactive DOM, signals, islands, SSR hydration |
-| [@getforma/compiler](https://github.com/getforma-dev/forma-tools) | TypeScript | TypeScript-to-FMIR compiler, Vite plugin, esbuild SSR plugin |
-| [@getforma/build](https://github.com/getforma-dev/forma-tools) | TypeScript | esbuild pipeline with content hashing, compression, manifest |
-| [@getforma/create-app](https://github.com/getforma-dev/create-forma-app) | TypeScript | `npx @getforma/create-app` — scaffold a new Forma project |
-| [forma-ir](https://crates.io/crates/forma-ir) | Rust | FMIR binary format: parser, walker, WASM exports |
-| [forma-server](https://crates.io/crates/forma-server) | Rust | Axum middleware for SSR, asset serving, CSP |
+| Package | Description |
+|---|---|
+| [@getforma/core](https://www.npmjs.com/package/@getforma/core) | **This library** — reactive DOM, signals, islands, SSR hydration |
+| [@getforma/compiler](https://www.npmjs.com/package/@getforma/compiler) | Vite plugin — h() optimization, server function transforms, FMIR emission |
+| [@getforma/build](https://www.npmjs.com/package/@getforma/build) | Production pipeline — esbuild bundling, content hashing, compression, manifest |
+
+### Backend (Rust)
+
+| Package | Description |
+|---|---|
+| [forma-ir](https://crates.io/crates/forma-ir) | FMIR binary format — parser, walker, WASM exports |
+| [forma-server](https://crates.io/crates/forma-server) | Axum middleware — SSR page rendering, asset serving, CSP headers |
+
+### Full Framework
+
+| Package | Description |
+|---|---|
+| [@getforma/create-app](https://github.com/getforma-dev/create-forma-app) | `npx @getforma/create-app` — scaffolds a Rust server + TypeScript frontend project |
 
 ---
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@getforma/core",
   "author": "Forma <victor@getforma.dev>",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Real DOM reactive library — fine-grained signals, islands architecture, SSR hydration. No virtual DOM, no diffing. ~15KB gzipped.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -138,12 +138,31 @@
     "fine-grained",
     "real-dom",
     "no-vdom",
+    "no-virtual-dom",
     "tc39-signals",
-    "preact-signals",
+    "alien-signals",
     "lightweight",
     "typescript",
+    "jsx",
     "hyperscript",
-    "state-management"
+    "state-management",
+    "islands",
+    "islands-architecture",
+    "hydration",
+    "ssr",
+    "server-side-rendering",
+    "csp",
+    "csp-safe",
+    "content-security-policy",
+    "declarative",
+    "data-attributes",
+    "alpine-alternative",
+    "solidjs-alternative",
+    "rust-ssr",
+    "web-components",
+    "progressive-enhancement",
+    "zero-build",
+    "cdn"
   ],
   "license": "MIT",
   "repository": {