mhx 2026.1.0 → 2026.1.1

package/README.md

@@ -0,0 +1,82 @@
+# mhx
+
+MoonBit Hypermedia X (mhx) is a type-safe Hypermedia-Driven Architecture (HDA)
+library for the browser, inspired by htmx. It uses `mx-*` attributes to declare
+hypermedia behavior and runs as a compact JS runtime compiled from MoonBit.
+
+## Install
+
+```bash
+npm install mhx
+```
+
+## Usage
+
+Import the runtime and initialize it once on startup. The npm entry already
+initializes the FFI glue.
+
+```js
+import mhx, { init_mhx } from "mhx";
+
+init_mhx();
+```
+
+### HTML Attributes
+
+mhx uses `mx-*` attributes (not `hx-*`) to define hypermedia behaviors:
+
+```html
+<!-- Simple GET request -->
+<button mx-get="/api/data" mx-target="#result">
+  Load Data
+</button>
+
+<!-- POST with trigger modifiers -->
+<form mx-post="/api/submit" mx-trigger="submit" mx-swap="outerHTML">
+  <input name="email" type="email" />
+  <button type="submit">Submit</button>
+</form>
+
+<!-- Click with delay and filter -->
+<button mx-get="/api/action" mx-trigger="click[ctrlKey] delay:500ms">
+  Ctrl+Click (with 500ms delay)
+</button>
+
+<!-- Debounced input -->
+<input
+  mx-get="/api/search"
+  mx-trigger="input changed debounce:300ms"
+  mx-target="#search-results"
+  name="q"
+/>
+```
+
+## API
+
+The npm entry exports the following helpers:
+
+- `init_mhx()` - initialize mhx (call once after DOM is ready)
+- `process(element)` - process newly added elements
+- `handle_event(event)` - manually dispatch an event
+- `get_instance()` - access the internal singleton instance
+- `version` - runtime version string
+
+```js
+import { process } from "mhx";
+
+const node = document.querySelector("#new-content");
+process(node);
+```
+
+## Build from Source
+
+```bash
+pnpm build
+```
+
+This builds `dist/index.js` and `dist/mhx_ffi.js`, which are used by the npm
+wrapper at `npm/index.js`.
+
+## License
+
+Apache-2.0

package/README.npm.md

@@ -0,0 +1,82 @@
+# mhx
+
+MoonBit Hypermedia X (mhx) is a type-safe Hypermedia-Driven Architecture (HDA)
+library for the browser, inspired by htmx. It uses `mx-*` attributes to declare
+hypermedia behavior and runs as a compact JS runtime compiled from MoonBit.
+
+## Install
+
+```bash
+npm install mhx
+```
+
+## Usage
+
+Import the runtime and initialize it once on startup. The npm entry already
+initializes the FFI glue.
+
+```js
+import mhx, { init_mhx } from "mhx";
+
+init_mhx();
+```
+
+### HTML Attributes
+
+mhx uses `mx-*` attributes (not `hx-*`) to define hypermedia behaviors:
+
+```html
+<!-- Simple GET request -->
+<button mx-get="/api/data" mx-target="#result">
+  Load Data
+</button>
+
+<!-- POST with trigger modifiers -->
+<form mx-post="/api/submit" mx-trigger="submit" mx-swap="outerHTML">
+  <input name="email" type="email" />
+  <button type="submit">Submit</button>
+</form>
+
+<!-- Click with delay and filter -->
+<button mx-get="/api/action" mx-trigger="click[ctrlKey] delay:500ms">
+  Ctrl+Click (with 500ms delay)
+</button>
+
+<!-- Debounced input -->
+<input
+  mx-get="/api/search"
+  mx-trigger="input changed debounce:300ms"
+  mx-target="#search-results"
+  name="q"
+/>
+```
+
+## API
+
+The npm entry exports the following helpers:
+
+- `init_mhx()` - initialize mhx (call once after DOM is ready)
+- `process(element)` - process newly added elements
+- `handle_event(event)` - manually dispatch an event
+- `get_instance()` - access the internal singleton instance
+- `version` - runtime version string
+
+```js
+import { process } from "mhx";
+
+const node = document.querySelector("#new-content");
+process(node);
+```
+
+## Build from Source
+
+```bash
+pnpm build
+```
+
+This builds `dist/index.js` and `dist/mhx_ffi.js`, which are used by the npm
+wrapper at `npm/index.js`.
+
+## License
+
+Apache-2.0

package/npm/index.js

@@ -1,12 +1,19 @@
 import * as mhx from "../dist/index.js";
 import { initMhxFfi } from "../dist/mhx_ffi.js";
 
-initMhxFfi(mhx);
+initMhxFfi({
+  on_fetch_success: mhx.on_fetch_success,
+  on_fetch_error: mhx.on_fetch_error,
+  on_mutation_observed: mhx.on_mutation_observed,
+});
 
 export const init_mhx = mhx.init_mhx;
 export const process = mhx.process;
 export const handle_event = mhx.handle_event;
 export const get_instance = mhx.get_instance;
 export const version = mhx.version;
+export const on_fetch_success = mhx.on_fetch_success;
+export const on_fetch_error = mhx.on_fetch_error;
+export const on_mutation_observed = mhx.on_mutation_observed;
 
 export default mhx;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mhx",
-  "version": "2026.1.0",
+  "version": "2026.1.1",
   "type": "module",
   "exports": "./npm/index.js",
   "files": [
@@ -9,13 +9,13 @@
     "LICENSE",
     "README.mbt.md"
   ],
+  "scripts": {
+    "build:moon": "moon fmt && moon check && moon test && moon build --target js",
+    "build": "pnpm build:moon && mkdir -p dist && cp _build/js/release/build/main/main.js dist/index.js && cp src/ffi/mhx_ffi.js dist/mhx_ffi.js"
+  },
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/f4ah6o/mhx.mbt"
-  },
-  "scripts": {
-    "build:moon": "moon fmt && moon check && moon test && moon build --target js",
-    "build": "pnpm build:moon && mkdir -p dist && cp _build/js/release/build/main/main.js dist/index.js && cp src/ffi/mhx_ffi.js dist/mhx_ffi.js"
   }
-}
+}