tutuca 0.9.113 → 0.9.115

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tutuca",
-  "version": "0.9.113",
+  "version": "0.9.115",
   "type": "module",
   "description": "SPA framework with immutable state and virtual DOM; dependency-free browser bundle",
   "main": "./dist/tutuca.js",
@@ -24,27 +24,28 @@
   },
   "scripts": {
     "clean": "rm -rf dist skill",
-    "dist": "bun scripts/dist.js",
-    "dist-ext": "bun scripts/dist-ext.js",
-    "dist-immutable": "bun scripts/dist-immutable.js",
-    "dist-all": "bun run dist-immutable && bun run dist && bun run dist-ext && bun run smoke",
+    "dist": "node scripts/dist.js",
+    "dist-ext": "node scripts/dist-ext.js",
+    "dist-immutable": "node scripts/dist-immutable.js",
+    "dist-all": "npm run dist-immutable && npm run dist && npm run dist-ext && npm run smoke",
     "smoke": "node scripts/smoke.js",
-    "release": "bun run dist-all && bun run sync-docs-storybook && bun run build-skill && (npm publish --access public; bun run clean-skill)",
-    "release-dry": "bun run dist-all && bun run sync-docs-storybook && bun run build-skill && (npm publish --dry-run; bun run clean-skill)",
-    "sync-docs-storybook": "bun scripts/sync-docs-storybook.js",
-    "build-skill": "bun scripts/build-skill.js",
+    "release": "npm run dist-all && npm run sync-docs-storybook && npm run build-skill && (npm publish --access public; npm run clean-skill)",
+    "release-dry": "npm run dist-all && npm run sync-docs-storybook && npm run build-skill && (npm publish --dry-run; npm run clean-skill)",
+    "sync-docs-storybook": "node scripts/sync-docs-storybook.js",
+    "build-skill": "node scripts/build-skill.js",
     "clean-skill": "rm -rf skill",
-    "test": "bun run dist && bun run dist-ext && bun test test/*.test.js",
-    "test-watch": "bun test --watch test/*.test.js",
-    "format": "bunx @biomejs/biome format --write",
-    "lint": "bunx @biomejs/biome lint",
-    "lint-fix": "bunx @biomejs/biome lint --write",
-    "fix": "bunx @biomejs/biome check --write",
-    "tutuca": "bun tools/tutuca.js",
-    "storybook": "bun scripts/serve-storybook.js",
-    "storybook:examples": "bun scripts/storybook-examples.js",
-    "stresstest": "bun scripts/stresstest.js",
-    "smoke-test": "bun tools/tutuca.js lint ./test/todo.js && bun tools/tutuca.js render ./test/todo.js && bun tools/tutuca.js test ./test/todo.js && bun tools/tutuca.js lint ./test/json.js && bun tools/tutuca.js render ./test/json.js"
+    "pretest": "npm run dist && npm run dist-ext",
+    "test": "vitest run",
+    "test-watch": "vitest",
+    "format": "biome format --write",
+    "lint": "biome lint",
+    "lint-fix": "biome lint --write",
+    "fix": "biome check --write",
+    "tutuca": "node tools/tutuca.js",
+    "storybook": "node scripts/serve-storybook.js",
+    "storybook:examples": "node scripts/storybook-examples.js",
+    "stresstest": "node scripts/stresstest.js",
+    "smoke-test": "node tools/tutuca.js lint ./test/todo.js && node tools/tutuca.js render ./test/todo.js && node tools/tutuca.js test ./test/todo.js && node tools/tutuca.js lint ./test/json.js && node tools/tutuca.js render ./test/json.js"
   },
   "sideEffects": [
     "./deps/chai.js"
@@ -92,7 +93,9 @@
   "devDependencies": {
     "@biomejs/biome": "^2.5.1",
     "chai": "^6.2.2",
+    "esbuild": "^0.28.1",
     "fast-check": "^4.8.0",
-    "htmlparser2": "^12.0.0"
+    "htmlparser2": "^12.0.0",
+    "vitest": "^4.1.10"
   }
 }

package/skill/margaui/components/menu.md

@@ -10,10 +10,11 @@ Versatile nav list for sidebars, sub-menus, mega-menus, file trees.
 
 - Sidebars, dropdown contents, mobile drawer contents.
 - For a large horizontal nav bar with per-item popover panels, use **megamenu** instead.
+- `menu-paged` turns `li > details > summary` submenus into drill-down pages: the open branch replaces the list and its summary becomes a "Back" row (label it with `aria-label`).
 
 ## Core classes
 
-`menu`; orientation `menu-vertical|horizontal`; size `menu-xs|sm|md|lg|xl`; child states `menu-active|disabled|title`.
+`menu`; orientation `menu-vertical|horizontal`; navigation `menu-paged`; size `menu-xs|sm|md|lg|xl`; child states `menu-active|disabled|title`.
 
 ## Examples
 
@@ -819,6 +820,35 @@ Source: `playground/components/menu/menu-without-padding-and-border-radius.html`
 </ul>
 ```
 
+### Paged menu
+
+Source: `playground/components/menu/paged-menu.html`
+
+```html
+<ul class="menu menu-paged bg-base-200 rounded-box w-56">
+  <li><a>Item 1</a></li>
+  <li>
+    <details>
+      <summary>Parent</summary>
+      <ul>
+        <li><a>Submenu 1</a></li>
+        <li><a>Submenu 2</a></li>
+        <li>
+          <details>
+            <summary aria-label="Back to Parent">Nested parent</summary>
+            <ul>
+              <li><a>Nested 1</a></li>
+              <li><a>Nested 2</a></li>
+            </ul>
+          </details>
+        </li>
+      </ul>
+    </details>
+  </li>
+  <li><a>Item 3</a></li>
+</ul>
+```
+
 ### Responsive vertical on small screen horizontal on large screen
 
 Source: `playground/components/menu/responsive-vertical-on-small-screen-horizontal-on-large-screen.html`

package/skill/tutuca/cli.md

@@ -20,7 +20,7 @@ npm i -g tutuca
 tutuca <command> <module-path> [name] [flags]
 
 # from a checkout of this repo
-bun tools/tutuca.js <command> <module-path> [name] [flags]
+node tools/tutuca.js <command> <module-path> [name] [flags]
 ```
 
 The command comes **first**, the module path second, an optional component

package/skill/tutuca/core.md

@@ -599,14 +599,32 @@ plain literal. (Genuine exceptions exist — e.g. a file input needs
 
 `@on.<event>+<mod>+<mod>=...`
 
+Guards — run the handler only when they hold:
+
 - All events: `+ctrl`, `+cmd`/`+meta`, `+alt`
 - `keydown` only: `+send` (Enter), `+cancel` (Escape)
 
+Effects — act on the DOM event, on all events:
+
+- `+prevent` → `event.preventDefault()`
+- `+stop` → `event.stopPropagation()`
+
 ```html
 <input @on.keydown+send="$submit value" @on.keydown+cancel="$reset" />
 <button @on.click+ctrl="$soloOnly">ctrl-click</button>
+<form @on.submit+prevent="$save">…</form>
+<input @on.keydown+send+prevent="$submit value" />
 ```
 
+Effects apply only when every guard on the same handler passed, whatever
+order they are written in: `+send+prevent` prevents on Enter and nothing
+else. They run from the app's root listener, which is where tutuca listens
+— that is invisible to `+prevent` (the default action happens after the
+event finishes propagating) but it makes `+stop` narrower than it looks:
+it stops listeners *outside* the app root only. DOM ancestors between the
+target and the root have already seen the event, and tutuca runs a single
+handler per event anyway, so `+stop` never suppresses another `@on`.
+
 ### Web Components & Custom Events
 
 Custom elements just work, and any `CustomEvent` they fire is reachable

package/skill/tutuca/patterns/handle-events.md

@@ -11,9 +11,12 @@
 <input @on.input="$setN valueAsInt" />
 <button @on.click="$addItem JsonSelector">+</button>
 
-<!-- modifiers: keydown +send (Enter) / +cancel (Esc), and +ctrl/+cmd/+alt -->
+<!-- guards: keydown +send (Enter) / +cancel (Esc), and +ctrl/+cmd/+alt -->
 <input @on.keydown+send="$submit value" @on.keydown+cancel="$reset" />
 
+<!-- effects on any event: +prevent, +stop (applied only if the guards passed) -->
+<form @on.submit+prevent="$save">…</form>
+
 <!-- custom elements: any CustomEvent reaches @on.<name>, detail is `value` -->
 <emoji-picker @on.emoji-click="onPick value"></emoji-picker>
 ```

package/skill/tutuca/testing.md

@@ -30,7 +30,8 @@ export function getTests({ describe, test, expect }) {
   (`expect.objectContaining`, `toHaveBeenCalled…`, `toMatchSnapshot`) are
   **not** available — tutuca has no mocking layer.
 - `test` and `describe` are **Tutuca's own** subset of the common
-  Mocha/Bun-style API, injected by `tutuca test` — not Bun's built-ins.
+  Mocha/Jest-style API, injected by `tutuca test` — they are not imported
+  from a test runner, so don't reach for one's extras.
   Available calls: `describe(title, fn)`, `describe(Component, fn)`,
   `describe(title, { component }, fn)`, and `test(title, fn)`. There is
   no `before` / `after` / `beforeEach` / `it` / skip-flag — don't reach
@@ -183,9 +184,9 @@ const r = collectIterBindings(MyComp, c, c.items, {
   `MyComp.make({ field: ... })` so handlers that read `this.field` see
   the value you want.
 - The redirect uses Node's `module.register`, which is how the `tutuca`
-  bin runs. Under a Bun-driven CLI it degrades to the no-op stub — if you
-  see `collectIterBindings` return `[]`, import it from `tutuca/dev`
-  explicitly.
+  bin runs. On a runtime without loader-hook support it degrades to the
+  no-op stub — if you see `collectIterBindings` return `[]`, import it
+  from `tutuca/dev` explicitly.
 
 Example: