@moku-labs/common 0.1.0 → 0.2.0

package/README.md

@@ -53,6 +53,7 @@ bun add @moku-labs/common @moku-labs/core
 | [`envPlugin`](src/plugins/env/README.md) | core plugin | Multi-provider environment / secret injection, validated and frozen at `onInit`, with `PUBLIC_` cross-validation. Exposed as `ctx.env`. |
 | `dotenv` · `processEnv` · `cloudflareBindings` | env providers (Node) | Resolve env from `.env` files / `process.env` / Cloudflare bindings. Import `node:fs`. |
 | `browserEnv` | env provider (browser) | Reads `import.meta.env` + `globalThis.__ENV__`. Zero `node:*`. |
+| [`createBrandConsole` · `createBrandPrompts` · `brandedSink`](src/cli/README.md) | CLI kit (Node) | The family's branded terminal renderer — console / prompts / log-sink + ANSI primitives. Imported from `@moku-labs/common/cli`. |
 | `Log` · `Env` | type namespaces | `Log.LogApi`, `Env.EnvConfig`, … |
 
 ## Usage
@@ -88,6 +89,7 @@ import { browserEnv } from "@moku-labs/common/browser"; // browser (node-free)
 | Entry | Format | For | Includes |
 |---|---|---|---|
 | **`@moku-labs/common`** | dual ESM + CJS | Node | the full catalog, incl. the Node env providers (`dotenv` / `processEnv` / `cloudflareBindings`) |
+| **`@moku-labs/common/cli`** | dual ESM + CJS | Node CLIs | the branded CLI kit — `createBrandConsole`, `createBrandPrompts`, `brandedSink`, and the ANSI primitives |
 | **`@moku-labs/common/browser`** | ESM-only | client bundles | `logPlugin`, `envPlugin`, `browserEnv` and the `Log` / `Env` types — **with all node-only code excluded** |
 
 Importing `@moku-labs/common/browser` can **never** drag `node:*` code into a client bundle, regardless of bundler or tree-shaking — its static import graph references zero node-only modules. CI proves it:

package/dist/browser.d.mts

@@ -137,6 +137,12 @@ type LogApi = {
    */
   addSink(sink: LogSink): void; /** Clear all recorded entries while keeping registered sinks. */
   reset(): void;
+  /**
+   * Remove all registered output sinks. The in-memory trace (`entries`) is
+   * unaffected, so `trace()`/`expect()` keep working — used to replace the default
+   * console sink (e.g. a CLI plugin swapping in a branded sink from `@moku-labs/common/cli`).
+   */
+  clearSinks(): void;
 };
 //#endregion
 //#region src/plugins/log/index.d.ts
@@ -341,4 +347,4 @@ declare function browserEnv(options?: {
  */
 declare const envPlugin: import("@moku-labs/core").CorePluginInstance<"env", EnvConfig, EnvState, EnvApi>;
 //#endregion
-export { types_d_exports as Env, types_d_exports$1 as Log, browserEnv, envPlugin, logPlugin };
+export { types_d_exports as Env, type EnvApi, type EnvConfig, type EnvProvider, type EnvState, type EnvVarSpec, type ExpectChain, types_d_exports$1 as Log, type LogApi, type LogConfig, type LogEntry, type LogLevel, type LogSink, type LogState, browserEnv, envPlugin, logPlugin };

package/dist/browser.mjs

@@ -393,6 +393,19 @@ function createLogApi(ctx) {
 		*/
 		reset() {
 			state.entries.length = 0;
+		},
+		/**
+		* Remove all registered output sinks; the in-memory trace (`entries`) is
+		* unaffected, so `trace()`/`expect()` keep working.
+		*
+		* @example
+		* ```ts
+		* log.clearSinks();
+		* log.addSink(brandedSink()); // from @moku-labs/common/cli
+		* ```
+		*/
+		clearSinks() {
+			state.sinks.length = 0;
 		}
 	};
 }