Bendik Aagaard LynghaugandClaude Fable 5
870aa79668
The integration test runs the counter through the real browser path in happy-dom: start(), store events, raf-batched morph, DOM click handlers, emit coalescing. examples/counter is the Phase 2 exit criterion: one app module mounted zero-build in a browser via import map and string-rendered by node examples/counter/render.js. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_014NgfSjHE11oFpoSnLVKLXd
3.5 KiB
3.5 KiB
choo v8 — branch notes
This branch is the working tree for the v8 modernization effort. The v7 code
at the repo root is untouched and stays authoritative until 8.0.0 ships;
everything new lives under packages/.
Layout
packages/core—@choojs/core: the Choo class, same API as choo v7 (use/route/start/mount/toString/emit), ported to ESM. The nano* internals are consolidated intolib/as attributed ports:lib/bus.js← nanobus 4.5.0lib/router.js← nanorouter 4.0.0 + wayfarer 7.0.1 (+ trie)lib/cache.js← choo component/cache.js + nanolru 1.0.0lib/raf.js← nanoraf 3.1.0,lib/href.js← nanohref 3.1.0lib/timing.js← nanotiming 7.3.1 (unified on globalperformance)lib/dom.js← document-ready 2.0.1 + scroll-to-anchor 1.0.0lib/query.js— nanoquery replaced byURLSearchParams
packages/html—@choojs/html: the rendering package.server.js— server-side tagged template (← nanohtml 1.10.0 server, transform branches removed; pure runtime)browser.js— runtime-only cached template tag: each template literal is parsed once (WeakMap keyed on its strings array) into a plus hole instructions; renders clone and fill. Values never pass through innerHTML. Document-level roots ( etc.) parse via DOMParser since drops them. Known limits: no dynamic tag names, no holes in raw-text elements, SVG fragments need theirmorph.js— ← nanomorph 5.4.3, consolidated to one moduleraw.js— mark pre-encoded strings (works with both renderers)packages/component—@choojs/component: ← nanocomponent 6.6.0 + on-load 3.4.1 as ES classes; the future island/hydration boundary.examples/counter— the isomorphic proof: one app module, mounted zero-build in the browser via import map (index.html), string-rendered in Node (render.js).- Phase 1: monorepo scaffold, ESM ports, choo v7 node test suite green
on
node --test(Node ≥ 24), CI on GitHub Actions - URL normalization fix: WHATWG URL parsing, single decode with raw fallback (no more URIError on '%'), NFC matching, per-segment wildcard decode, decoded state.href
- Phase 2 (core): browser renderer rewrite,
@choojs/component, zero-build counter example, full-app integration test in happy-dom - Phase 2 (remaining): adoption-style hydration with mismatch warnings, Playwright suite in a real browser, benchmarks vs nanohtml v1 / µhtml
- Phase 3: v8 wiring (
toStream, devtools, codemod) - Phase 4: bankai v10 (Vite 8/Rolldown shell, SSR middleware, 103 Early Hints, service worker, precompression)
- Phase 5: docs, examples, launch
choo()still works withoutnew;Choois also a named export.- nanoquery →
URLSearchParams(same output shape, repeated keys → arrays). - Assertions live in
lib/assert.jsso production builds can strip them. - Everything targets Node ≥ 24 and Baseline Widely Available browsers; there is no compile step and no transpilation anywhere.
Status vs the modernization plan
Deliberate changes from v7
Attribution
All ported modules are MIT-licensed work by the original choojs/nano* authors and contributors; per-file headers note the source package and version. This branch exists to carry that work forward, not to replace it.