@moku-labs/web 0.5.3 → 0.5.5

package/dist/browser.mjs

@@ -633,18 +633,28 @@ function createLogApi(ctx) {
 }
 //#endregion
 //#region src/plugins/log/sinks.ts
+/** Severity rank for threshold comparison (higher = more severe). */
+const LEVEL_RANK = {
+	debug: 10,
+	info: 20,
+	warn: 30,
+	error: 40
+};
 /**
 * Build the console sink: routes entries by channel — `error` → `console.error`,
 * `warn` → `console.warn`, and `debug`/`info` → `console.log`. The full entry
-* object is forwarded so the console serializes its `event` and `data`.
+* object is forwarded so the console serializes its `event` and `data`. Entries
+* below `minLevel` are dropped (the in-memory trace still records everything).
 *
+* @param minLevel - Lowest severity to print. Defaults to `"debug"` (print all).
 * @returns A {@link LogSink} that writes to the matching `console` channel.
 * @example
 * ```ts
-* state.sinks.push(consoleSink());
+* state.sinks.push(consoleSink("info")); // suppress debug spam
 * ```
 */
-function consoleSink() {
+function consoleSink(minLevel = "debug") {
+	const threshold = LEVEL_RANK[minLevel];
 	return { 
 	/**
 	* Route a single entry to the console channel matching its level.
@@ -656,6 +666,7 @@ function consoleSink() {
 	* ```
 	*/
 write(entry) {
+		if (LEVEL_RANK[entry.level] < threshold) return;
 		if (entry.level === "error") console.error(entry);
 		else if (entry.level === "warn") console.warn(entry);
 		else console.log(entry);
@@ -663,18 +674,22 @@ write(entry) {
 }
 /**
 * Install mode-selected default sinks at onInit. The in-memory trace is always
-* on (`state.entries`); the console sink is added only in dev/production.
+* on (`state.entries`); the console sink is added only in dev/production. `dev`
+* prints everything (debug+); `production` prints `info`+ only, so the per-phase
+* `debug` events (build:bundle, build:pages, …) don't spam a prod build. Both
+* modes still record all levels in the in-memory trace.
 *
 * @param ctx - Core plugin context (`{ config, state }`).
 * @param ctx.config - Resolved log config (`{ mode }`).
 * @param ctx.state - Mutable log state (`{ entries, sinks }`).
 * @example
 * ```ts
-* // mode "dev" -> state.sinks === [consoleSink()]; mode "test" -> state.sinks === []
+* // "dev" -> [consoleSink("debug")]; "production" -> [consoleSink("info")]; "test"/"silent" -> []
 * ```
 */
 function installDefaultSinks(ctx) {
-	if (ctx.config.mode === "dev" || ctx.config.mode === "production") ctx.state.sinks.push(consoleSink());
+	if (ctx.config.mode === "dev") ctx.state.sinks.push(consoleSink("debug"));
+	else if (ctx.config.mode === "production") ctx.state.sinks.push(consoleSink("info"));
 }
 //#endregion
 //#region src/plugins/log/state.ts
@@ -3288,11 +3303,10 @@ function createSpaKernel(state, config, emit, deps) {
 			const region = document.querySelector(resolved.swapSelector);
 			if (!region) return false;
 			handleStart(pathname);
-			const { renderVNode } = await import("./render-BL9Fv6G6.mjs");
+			const { renderVNode } = await import("./render-BNe0s7fr.mjs");
 			syncDataHead(hit.route, routeContext);
 			unmountPageSpecific(state, emit);
 			runSwap(() => {
-				region.replaceChildren();
 				renderVNode(vnode, region);
 				scanAndMount(state, emit, resolved.swapSelector);
 				notifyNavEnd(state);

package/dist/index.cjs

@@ -667,18 +667,28 @@ function createLogApi(ctx) {
 }
 //#endregion
 //#region src/plugins/log/sinks.ts
+/** Severity rank for threshold comparison (higher = more severe). */
+const LEVEL_RANK = {
+	debug: 10,
+	info: 20,
+	warn: 30,
+	error: 40
+};
 /**
 * Build the console sink: routes entries by channel — `error` → `console.error`,
 * `warn` → `console.warn`, and `debug`/`info` → `console.log`. The full entry
-* object is forwarded so the console serializes its `event` and `data`.
+* object is forwarded so the console serializes its `event` and `data`. Entries
+* below `minLevel` are dropped (the in-memory trace still records everything).
 *
+* @param minLevel - Lowest severity to print. Defaults to `"debug"` (print all).
 * @returns A {@link LogSink} that writes to the matching `console` channel.
 * @example
 * ```ts
-* state.sinks.push(consoleSink());
+* state.sinks.push(consoleSink("info")); // suppress debug spam
 * ```
 */
-function consoleSink() {
+function consoleSink(minLevel = "debug") {
+	const threshold = LEVEL_RANK[minLevel];
 	return { 
 	/**
 	* Route a single entry to the console channel matching its level.
@@ -690,6 +700,7 @@ function consoleSink() {
 	* ```
 	*/
 write(entry) {
+		if (LEVEL_RANK[entry.level] < threshold) return;
 		if (entry.level === "error") console.error(entry);
 		else if (entry.level === "warn") console.warn(entry);
 		else console.log(entry);
@@ -697,18 +708,22 @@ write(entry) {
 }
 /**
 * Install mode-selected default sinks at onInit. The in-memory trace is always
-* on (`state.entries`); the console sink is added only in dev/production.
+* on (`state.entries`); the console sink is added only in dev/production. `dev`
+* prints everything (debug+); `production` prints `info`+ only, so the per-phase
+* `debug` events (build:bundle, build:pages, …) don't spam a prod build. Both
+* modes still record all levels in the in-memory trace.
 *
 * @param ctx - Core plugin context (`{ config, state }`).
 * @param ctx.config - Resolved log config (`{ mode }`).
 * @param ctx.state - Mutable log state (`{ entries, sinks }`).
 * @example
 * ```ts
-* // mode "dev" -> state.sinks === [consoleSink()]; mode "test" -> state.sinks === []
+* // "dev" -> [consoleSink("debug")]; "production" -> [consoleSink("info")]; "test"/"silent" -> []
 * ```
 */
 function installDefaultSinks(ctx) {
-	if (ctx.config.mode === "dev" || ctx.config.mode === "production") ctx.state.sinks.push(consoleSink());
+	if (ctx.config.mode === "dev") ctx.state.sinks.push(consoleSink("debug"));
+	else if (ctx.config.mode === "production") ctx.state.sinks.push(consoleSink("info"));
 }
 //#endregion
 //#region src/plugins/log/state.ts
@@ -6686,11 +6701,10 @@ function createSpaKernel(state, config, emit, deps) {
 			const region = document.querySelector(resolved.swapSelector);
 			if (!region) return false;
 			handleStart(pathname);
-			const { renderVNode } = await Promise.resolve().then(() => require("./render-BSTM0Akv.cjs"));
+			const { renderVNode } = await Promise.resolve().then(() => require("./render-DLZEOe4M.cjs"));
 			syncDataHead(hit.route, routeContext);
 			unmountPageSpecific(state, emit);
 			runSwap(() => {
-				region.replaceChildren();
 				renderVNode(vnode, region);
 				scanAndMount(state, emit, resolved.swapSelector);
 				notifyNavEnd(state);

package/dist/index.mjs

@@ -654,18 +654,28 @@ function createLogApi(ctx) {
 }
 //#endregion
 //#region src/plugins/log/sinks.ts
+/** Severity rank for threshold comparison (higher = more severe). */
+const LEVEL_RANK = {
+	debug: 10,
+	info: 20,
+	warn: 30,
+	error: 40
+};
 /**
 * Build the console sink: routes entries by channel — `error` → `console.error`,
 * `warn` → `console.warn`, and `debug`/`info` → `console.log`. The full entry
-* object is forwarded so the console serializes its `event` and `data`.
+* object is forwarded so the console serializes its `event` and `data`. Entries
+* below `minLevel` are dropped (the in-memory trace still records everything).
 *
+* @param minLevel - Lowest severity to print. Defaults to `"debug"` (print all).
 * @returns A {@link LogSink} that writes to the matching `console` channel.
 * @example
 * ```ts
-* state.sinks.push(consoleSink());
+* state.sinks.push(consoleSink("info")); // suppress debug spam
 * ```
 */
-function consoleSink() {
+function consoleSink(minLevel = "debug") {
+	const threshold = LEVEL_RANK[minLevel];
 	return { 
 	/**
 	* Route a single entry to the console channel matching its level.
@@ -677,6 +687,7 @@ function consoleSink() {
 	* ```
 	*/
 write(entry) {
+		if (LEVEL_RANK[entry.level] < threshold) return;
 		if (entry.level === "error") console.error(entry);
 		else if (entry.level === "warn") console.warn(entry);
 		else console.log(entry);
@@ -684,18 +695,22 @@ write(entry) {
 }
 /**
 * Install mode-selected default sinks at onInit. The in-memory trace is always
-* on (`state.entries`); the console sink is added only in dev/production.
+* on (`state.entries`); the console sink is added only in dev/production. `dev`
+* prints everything (debug+); `production` prints `info`+ only, so the per-phase
+* `debug` events (build:bundle, build:pages, …) don't spam a prod build. Both
+* modes still record all levels in the in-memory trace.
 *
 * @param ctx - Core plugin context (`{ config, state }`).
 * @param ctx.config - Resolved log config (`{ mode }`).
 * @param ctx.state - Mutable log state (`{ entries, sinks }`).
 * @example
 * ```ts
-* // mode "dev" -> state.sinks === [consoleSink()]; mode "test" -> state.sinks === []
+* // "dev" -> [consoleSink("debug")]; "production" -> [consoleSink("info")]; "test"/"silent" -> []
 * ```
 */
 function installDefaultSinks(ctx) {
-	if (ctx.config.mode === "dev" || ctx.config.mode === "production") ctx.state.sinks.push(consoleSink());
+	if (ctx.config.mode === "dev") ctx.state.sinks.push(consoleSink("debug"));
+	else if (ctx.config.mode === "production") ctx.state.sinks.push(consoleSink("info"));
 }
 //#endregion
 //#region src/plugins/log/state.ts
@@ -6673,11 +6688,10 @@ function createSpaKernel(state, config, emit, deps) {
 			const region = document.querySelector(resolved.swapSelector);
 			if (!region) return false;
 			handleStart(pathname);
-			const { renderVNode } = await import("./render-BL9Fv6G6.mjs");
+			const { renderVNode } = await import("./render-BNe0s7fr.mjs");
 			syncDataHead(hit.route, routeContext);
 			unmountPageSpecific(state, emit);
 			runSwap(() => {
-				region.replaceChildren();
 				renderVNode(vnode, region);
 				scanAndMount(state, emit, resolved.swapSelector);
 				notifyNavEnd(state);

package/dist/render-BNe0s7fr.mjs

@@ -0,0 +1,32 @@
+import { render } from "preact";
+//#region src/plugins/spa/render.ts
+/**
+* Render a route's `VNode` into the live swap region, starting from a clean slate
+* each time. Preact keeps the previous vdom tree on the container and diffs the
+* next render against it — but the kernel clears the region between navs to drop
+* the static SSR markup. A raw `replaceChildren()` would delete the live DOM out
+* from under Preact's retained vdom, so the next diff patches detached nodes → an
+* empty region (the bug where a SECOND consecutive client nav went blank).
+*
+* To stay correct without tracking element identity, first `render(null, region)`
+* — this unmounts any Preact tree Preact owns AND resets its retained vdom pointer
+* (a no-op the first time, when the region still holds raw SSR/HTML). Then clear
+* whatever static children remain, then mount the new VNode fresh. Reuses the
+* build's component output verbatim (same `route.render`), so the client paint
+* matches the SSG paint.
+*
+* @param vnode - The VNode produced by the matched route's `.render(ctx)`.
+* @param region - The swap-region element to render into.
+* @example
+* ```ts
+* const { renderVNode } = await import("./render");
+* renderVNode(route._handlers.render(ctx), document.querySelector("main > section"));
+* ```
+*/
+function renderVNode(vnode, region) {
+	render(null, region);
+	region.replaceChildren();
+	render(vnode, region);
+}
+//#endregion
+export { renderVNode };

package/dist/render-DLZEOe4M.cjs

@@ -0,0 +1,32 @@
+let preact = require("preact");
+//#region src/plugins/spa/render.ts
+/**
+* Render a route's `VNode` into the live swap region, starting from a clean slate
+* each time. Preact keeps the previous vdom tree on the container and diffs the
+* next render against it — but the kernel clears the region between navs to drop
+* the static SSR markup. A raw `replaceChildren()` would delete the live DOM out
+* from under Preact's retained vdom, so the next diff patches detached nodes → an
+* empty region (the bug where a SECOND consecutive client nav went blank).
+*
+* To stay correct without tracking element identity, first `render(null, region)`
+* — this unmounts any Preact tree Preact owns AND resets its retained vdom pointer
+* (a no-op the first time, when the region still holds raw SSR/HTML). Then clear
+* whatever static children remain, then mount the new VNode fresh. Reuses the
+* build's component output verbatim (same `route.render`), so the client paint
+* matches the SSG paint.
+*
+* @param vnode - The VNode produced by the matched route's `.render(ctx)`.
+* @param region - The swap-region element to render into.
+* @example
+* ```ts
+* const { renderVNode } = await import("./render");
+* renderVNode(route._handlers.render(ctx), document.querySelector("main > section"));
+* ```
+*/
+function renderVNode(vnode, region) {
+	(0, preact.render)(null, region);
+	region.replaceChildren();
+	(0, preact.render)(vnode, region);
+}
+//#endregion
+exports.renderVNode = renderVNode;

package/package.json

@@ -112,5 +112,5 @@
     "test:integration": "vitest run --project integration",
     "test:coverage": "vitest run --project unit --project integration --coverage"
   },
-  "version": "0.5.3"
+  "version": "0.5.5"
 }

package/dist/render-BL9Fv6G6.mjs

@@ -1,20 +0,0 @@
-import { render } from "preact";
-//#region src/plugins/spa/render.ts
-/**
-* Render a route's `VNode` into the live swap region, replacing its contents.
-* Reuses the build's component output verbatim (same `route.render`), so the
-* client paint matches the SSG paint.
-*
-* @param vnode - The VNode produced by the matched route's `.render(ctx)`.
-* @param region - The swap-region element to render into.
-* @example
-* ```ts
-* const { renderVNode } = await import("./render");
-* renderVNode(route._handlers.render(ctx), document.querySelector("main > section"));
-* ```
-*/
-function renderVNode(vnode, region) {
-	render(vnode, region);
-}
-//#endregion
-export { renderVNode };

package/dist/render-BSTM0Akv.cjs

@@ -1,20 +0,0 @@
-let preact = require("preact");
-//#region src/plugins/spa/render.ts
-/**
-* Render a route's `VNode` into the live swap region, replacing its contents.
-* Reuses the build's component output verbatim (same `route.render`), so the
-* client paint matches the SSG paint.
-*
-* @param vnode - The VNode produced by the matched route's `.render(ctx)`.
-* @param region - The swap-region element to render into.
-* @example
-* ```ts
-* const { renderVNode } = await import("./render");
-* renderVNode(route._handlers.render(ctx), document.querySelector("main > section"));
-* ```
-*/
-function renderVNode(vnode, region) {
-	(0, preact.render)(vnode, region);
-}
-//#endregion
-exports.renderVNode = renderVNode;