@ape-egg/vibe 4.3.0 → 4.3.1

package/README.md

@@ -1,6 +1,6 @@
 # Vibe
 
-**Version 4.3.0** — Runtime-first reactivity for plain HTML. Drop a script tag into any page and get reactive bindings, control flow, and URL-loaded components — no build step required. Compile later if you want; the compiler is a separate, optional package (`@ape-egg/vibe-compiler`).
+**Version 4.3.1** — Runtime-first reactivity for plain HTML. Drop a script tag into any page and get reactive bindings, control flow, and URL-loaded components — no build step required. Compile later if you want; the compiler is a separate, optional package (`@ape-egg/vibe-compiler`).
 
 ## Security model & CSP
 
@@ -291,7 +291,7 @@ A standalone client-side router built on one contract: `$.page = { path, route,
 
 **Keyed outlet**: `key` on a fetched `<component>` declares its identity — when the resolved key changes, the component remounts even if `src` is unchanged. With `key="@[page.path]"`, param→param navigation on the same route (`/brawlers/0 → /brawlers/1` — same fragment src) mounts fresh, exactly like an MPA reload on the new URL. `src` and `key` are the wrapper's own contract and are never passed to the component as props.
 
-**Link claiming**: one document-level click listener claims same-origin, unmodified, untargeted clicks whose pathname matches a **real** route — pushState + a fresh `$.page` assignment + `document.title` swap when the route carries one, scroll to top. Everything else navigates natively: other origins, modified clicks, `target`/`download` links, same-page hash anchors, and unrouted paths — which is what makes mixed MPA/SPA output work. `'*'` never claims a click; it only resolves deep-link entries and popstate. `popstate` re-resolves (including `'*'`) without scrolling — the browser restores position.
+**Link claiming**: one document-level click listener claims same-origin, unmodified, untargeted clicks whose pathname matches a **real** route — pushState + a fresh `$.page` assignment + `document.title` swap when the route carries one, scroll to top. The entry route gets the same title swap when `setupSpa` runs, so a deep link never shows the shell's title. Everything else navigates natively: other origins, modified clicks, `target`/`download` links, same-page hash anchors, and unrouted paths — which is what makes mixed MPA/SPA output work. `'*'` never claims a click; it only resolves deep-link entries and popstate. `popstate` re-resolves (including `'*'`) without scrolling — the browser restores position.
 
 **No match, no `'*'`**: `$.page.src` stays unset and the outlet mounts nothing. There is no built-in 404.
 
@@ -525,7 +525,7 @@ The pages tree becomes three things:
 
 1. **Page fragments** at `/components/vibe-spa/<pages-relative-path>` — each page's body content, with its head `<style>` tags prepended and its `<script type="module">` carried along byte-identical. No rewrites: `vibe()` itself applies defaults semantics once booted (see App-Lifetime State Defaults above), so page state gets app-lifetime behavior with the page's own import.
 2. **A generated route table** — `pages/brawlers/$index.html` → `{ route: '/brawlers/:index', src: '/components/vibe-spa/brawlers/$index.html', title: <harvested from the page's <title>> }`. `$param` → `:param`, terminal `$$name` → `:name*`, terminal `index` serves its directory path. Sorted most-specific-first.
-3. **A composed shell** at the output root `/index.html` — plain runtime-Vibe code: the deduped union of every page's head resources (`<meta>` keeps only the set common to all pages; page-specific meta is dropped with a verbose note), the `/` route's title, the union of page body attributes minus `vibe-fouc`, one generated boot script (`resolve` seeds `$.page`, `setupSpa` wires navigation — imports reuse the pages' own import style), and the keyed route outlet: `<component src="@[page.src]" key="@[page.path]"></component>` (a path change remounts the fragment even when the route — and so the src — is unchanged: param→param navigation mounts fresh, like the MPA reload it replaces).
+3. **A composed shell** at the output root `/index.html` — plain runtime-Vibe code: the deduped union of every page's head resources (`<meta>` keeps only the set common to all pages; page-specific meta is dropped with a verbose note), the `/` route's title, the union of page body attributes minus `vibe-fouc`, a `window.__MANIFEST__` hint naming the shell's own hyperspeed manifest (the shell is the document at every route, so the runtime loads that one manifest directly instead of probing paths derived from the URL), one generated boot script (`resolve` seeds `$.page`, `setupSpa` wires navigation — imports reuse the pages' own import style), and the keyed route outlet: `<component src="@[page.src]" key="@[page.path]"></component>` (a path change remounts the fragment even when the route — and so the src — is unchanged: param→param navigation mounts fresh, like the MPA reload it replaces).
 
 **What SPA mode skips**: per-page stamped HTML, per-page manifests, and the `pages/` output directory. Fragments are runtime-parsed on mount (per-route lazy loading falls out of the reactive src for free); the shell itself gets a manifest but is deliberately left unstamped — it is served at every route path, so its first paint is location-dependent by nature. The shell ships **without** `vibe-fouc`: its absence is the compiled-mode marker (it gates hyperspeed manifest loading), and there is nothing to flash — the outlet is empty and fragments hydrate off-DOM before insertion.
 
@@ -539,7 +539,7 @@ The pages tree becomes three things:
 }
 ```
 
-Dev-server equivalents: any "history API fallback" option (`http-server` can't rewrite; `vite preview`, `serve -s`, and Caddy `try_files` all can).
+Dev-server equivalents: any "history API fallback" option (`vite preview`, `serve -s`, Caddy `try_files`, or `http-server -P http://localhost:8080?` — the trailing `?` proxies unresolved paths to the root).
 
 **Watch mode**: `--spa --watch` re-runs the SPA pass on any pages-tree change — edited pages re-transform, added/removed pages resync the route table and prune orphan fragments, title/head edits recompose the shell, and the shell's manifest refreshes.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ape-egg/vibe",
-  "version": "4.3.0",
+  "version": "4.3.1",
   "type": "module",
   "description": "Runtime-first reactivity for plain HTML \u2014 no build step, no virtual DOM, no new syntax to learn",
   "main": "index.js",

package/runtime/constants.js

@@ -1,4 +1,4 @@
-export const VERSION = '4.3.0';
+export const VERSION = '4.3.1';
 
 export const DEBUGGER_NAME = '[vibe-debug]:';
 export const FOUC_CLASS_OR_ATTR = 'vibe-fouc';

package/spa.js

@@ -57,9 +57,13 @@ export const navigate = (path) =>
   activeRouter ? activeRouter.navigate(path) : location.assign(new URL(path, location.origin));
 
 export const setupSpa = ({ routes, onNavigate }) => {
-  const apply = onNavigate ?? (({ path, route, params, src, name, title }) => {
+  const swapTitle = (resolved) => {
+    if (resolved?.title) document.title = resolved.title;
+  };
+  const apply = onNavigate ?? ((resolved) => {
+    const { path, route, params, src, name } = resolved;
     window.$.page = { path, route, params, src, name };
-    if (title) document.title = title;
+    swapTitle(resolved);
   });
 
   const claim = (target) => {
@@ -117,6 +121,7 @@ export const setupSpa = ({ routes, onNavigate }) => {
 
   document.addEventListener('click', onClick);
   addEventListener('popstate', onPopstate);
+  if (!onNavigate) swapTitle(resolve(location, routes));
 
   const dispose = () => {
     document.removeEventListener('click', onClick);