@moku-labs/web 0.5.2 → 0.5.4

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

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

package/dist/index.d.cts

@@ -1,5 +1,6 @@
 import { ComponentChildren, VNode } from "preact";
 import { EmitFn } from "@moku-labs/core";
+import { BundledTheme, ThemeRegistrationAny } from "shiki";
 import { Pluggable, Processor } from "unified";
 
 //#region \0rolldown/runtime.js
@@ -1680,8 +1681,15 @@ type Config$1 = {
    */
   trustedContent: boolean; /** Additional remark plugins, concatenated AFTER framework defaults. Defaults to []. */
   extraRemarkPlugins?: readonly Pluggable[]; /** Additional rehype plugins, concatenated after custom transforms, before Shiki + sanitize. Defaults to []. */
-  extraRehypePlugins?: readonly Pluggable[]; /** Shiki theme name for syntax highlighting. Defaults to "github-dark". */
-  shikiTheme?: string; /** Author applied to articles whose frontmatter omits author. Defaults to undefined. */
+  extraRehypePlugins?: readonly Pluggable[];
+  /**
+   * Shiki theme for syntax highlighting: a bundled theme NAME — typed as Shiki's
+   * `BundledTheme` union so editors autocomplete the ~60 built-ins (default
+   * "github-dark") — or a custom `ThemeRegistration` object. Passed straight through
+   * to `@shikijs/rehype`'s `theme`. (Like Shiki's own theme type, an arbitrary string
+   * still compiles via the object arm, so this is autocomplete, not typo-rejection.)
+   */
+  shikiTheme?: BundledTheme | ThemeRegistrationAny; /** Author applied to articles whose frontmatter omits author. Defaults to undefined. */
   defaultAuthor?: string;
 };
 /**

package/dist/index.d.mts

@@ -1,6 +1,7 @@
 import { EmitFn } from "@moku-labs/core";
 import { Pluggable, Processor } from "unified";
 import { ComponentChildren, VNode } from "preact";
+import { BundledTheme, ThemeRegistrationAny } from "shiki";
 
 //#region src/plugins/log/types.d.ts
 declare namespace types_d_exports$6 {
@@ -1680,8 +1681,15 @@ type Config$1 = {
    */
   trustedContent: boolean; /** Additional remark plugins, concatenated AFTER framework defaults. Defaults to []. */
   extraRemarkPlugins?: readonly Pluggable[]; /** Additional rehype plugins, concatenated after custom transforms, before Shiki + sanitize. Defaults to []. */
-  extraRehypePlugins?: readonly Pluggable[]; /** Shiki theme name for syntax highlighting. Defaults to "github-dark". */
-  shikiTheme?: string; /** Author applied to articles whose frontmatter omits author. Defaults to undefined. */
+  extraRehypePlugins?: readonly Pluggable[];
+  /**
+   * Shiki theme for syntax highlighting: a bundled theme NAME — typed as Shiki's
+   * `BundledTheme` union so editors autocomplete the ~60 built-ins (default
+   * "github-dark") — or a custom `ThemeRegistration` object. Passed straight through
+   * to `@shikijs/rehype`'s `theme`. (Like Shiki's own theme type, an arbitrary string
+   * still compiles via the object arm, so this is autocomplete, not typo-rejection.)
+   */
+  shikiTheme?: BundledTheme | ThemeRegistrationAny; /** Author applied to articles whose frontmatter omits author. Defaults to undefined. */
   defaultAuthor?: string;
 };
 /**

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

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.2"
+  "version": "0.5.4"
 }