@elurjs/kit 2.4.5 → 2.4.7

package/CHANGELOG.md

@@ -1,10 +1,47 @@
 # Changelog
 
-All notable changes to Nix.js Kit are documented in this file.
+All notable changes to Elur Kit are documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.4.7]
+
+### Changed
+
+- **Client entry now defers hydration with `requestIdleCallback`** — the
+  auto-generated `entry-client.ts` wraps `hydrateIslands(registry)` in
+  `requestIdleCallback(hydrate, { timeout: 2000 })` (with a `setTimeout`
+  fallback) so the browser can paint the server-rendered HTML before
+  hydrating islands. This reduces LCP element render delay on mobile
+  devices where the main thread was blocked by synchronous hydration.
+  Islands with directive `"load"` already have SSR-rendered DOM, so
+  users see content immediately — hydration only adds interactivity.
+
+## [2.4.6]
+
+### Fixed
+
+- **`isSSR()` always returned `false`** — the kit's `ssr-flag.ts` used
+  `Symbol.for("@elurjs/core/reactivity-state")` while `@elurjs/core` < 3.5.1
+  used `Symbol.for("elur/reactivity-state")`. The mismatched symbols meant
+  the kit's `setSSR(true)` during `renderToString` never wrote to the core's
+  reactivity state, so `isSSR()` read `undefined` and defaulted to `false`.
+  Fixed in `@elurjs/core@3.5.1` which now namespaces its internal symbols
+  under `@elurjs/core/*`. Peer dependency bumped to `^3.5.1`.
+
+### Changed
+
+- **`happy-dom` re-added as a test-only `devDependency`** — it was fully
+  removed in v2.4, but 5 client-side test suites (`island.test.ts`,
+  `island-reactive-array.test.ts`, `island-client-only.test.ts`,
+  `client-router.test.ts`, `client-router-a11y.test.ts`) still imported it
+  and failed with `ERR_MODULE_NOT_FOUND`. It is now back **only** in
+  `devDependencies` to provide a DOM environment for those tests. It is
+  never imported by `src/`, never referenced by either vite build config,
+  and never shipped in the published bundle (`files` contains only
+  `dist/lib`). `test/happy-dom-optional.test.ts` guards this invariant.
+
 ## [2.4.4]
 
 ### Fixed

package/README.md

@@ -191,11 +191,17 @@ Options:
   manifest, no variants, no `<picture>`). The registry state is now in a
   dedicated shared chunk (`image/registry.js`) that both the CLI and the
   library import, ensuring a single module instance.
-- **`happy-dom` fully removed** — the kit no longer depends on
-  happy-dom in any form. SSR uses the core's DOM-free
+- **`happy-dom` removed from the runtime** — the kit no longer depends on
+  happy-dom at runtime. SSR uses the core's DOM-free
   `renderToString` (`@elurjs/core/server`) directly. The legacy DOM
   fallback (`renderWithDom`) was deleted along with all `external`/
-  `globals` references in the vite build configs.
+  `globals` references in the vite build configs. `happy-dom` is kept
+  **only** as a `devDependency` to provide a DOM environment for the
+  client-side test suites (`island.test.ts`, `client-router.test.ts`,
+  ...); it is never imported by `src/`, never referenced by either vite
+  build config, and never shipped in the published bundle (`files`
+  contains only `dist/lib`). See
+  `test/happy-dom-optional.test.ts` for the guard that enforces this.
 - **`raw()` now supports server rendering** — added
   `ELUR_RENDER_PROTOCOL.renderServer` to `raw()` so it works with the
   core's DOM-free SSR (previously relied on the happy-dom fallback).

package/dist/lib/cli.cjs

@@ -211,7 +211,15 @@ function buildEntrySource(islands, outFile, hydrateImport = "@elurjs/kit/island"
 	const islandHydration = registryLines ? `const registry = {
 ${registryLines}
 };
-hydrateIslands(registry);
+// Defer hydration until the browser is idle so the first paint is not
+// blocked. Islands with directive "load" already have SSR-rendered DOM,
+// so the user sees content immediately — hydration only adds interactivity.
+const hydrate = () => hydrateIslands(registry);
+if ("requestIdleCallback" in window) {
+  requestIdleCallback(hydrate, { timeout: 2000 });
+} else {
+  setTimeout(hydrate, 0);
+}
 document.addEventListener("elur:rendered", () => {
   cleanupHydratedIslands();
   hydrateIslands(registry);