@orkestrel/console 0.0.16 → 0.0.17

package/dist/src/core/index.d.cts

@@ -952,6 +952,20 @@ export declare const LEVEL_COLORS: Readonly<Record<LogLevel, Exclude<Color, 'def
  */
 export declare const LEVEL_SEVERITY: Readonly<Record<LogLevel, number>>;
 
+/**
+ * Yields a position for each requested blank line without allocating the whole sequence.
+ * @example
+ * ```ts
+ * [...new LineIterator(2)] // [0, 1]
+ * ```
+ */
+export declare class LineIterator implements IterableIterator<number> {
+    #private;
+    constructor(count: number);
+    next(): IteratorResult<number>;
+    [Symbol.iterator](): IterableIterator<number>;
+}
+
 /**
  * Lists every {@link LogLevel}, in ascending severity order — the levels a logger exposes as
  * methods and the manager fans out to. The source of truth for the level axis (drives
@@ -1540,6 +1554,15 @@ export declare function renderBar(options: BarOptions): string;
  */
 export declare function renderBox(options: BoxOptions): string;
 
+/**
+ * Renders a box's top border across the supplied inner span.
+ * @example
+ * ```ts
+ * renderBoxTop({ content: '' }, 3) // '┌───┐'
+ * ```
+ */
+export declare function renderBoxTop(options: BoxOptions, span: number): string;
+
 /**
  * Declares a swappable style renderer — the seam that turns style data into output for one
  * target. The cross-environment default is the ANSI renderer (SGR escape codes); a

package/dist/src/core/index.d.ts

@@ -952,6 +952,20 @@ export declare const LEVEL_COLORS: Readonly<Record<LogLevel, Exclude<Color, 'def
  */
 export declare const LEVEL_SEVERITY: Readonly<Record<LogLevel, number>>;
 
+/**
+ * Yields a position for each requested blank line without allocating the whole sequence.
+ * @example
+ * ```ts
+ * [...new LineIterator(2)] // [0, 1]
+ * ```
+ */
+export declare class LineIterator implements IterableIterator<number> {
+    #private;
+    constructor(count: number);
+    next(): IteratorResult<number>;
+    [Symbol.iterator](): IterableIterator<number>;
+}
+
 /**
  * Lists every {@link LogLevel}, in ascending severity order — the levels a logger exposes as
  * methods and the manager fans out to. The source of truth for the level axis (drives
@@ -1540,6 +1554,15 @@ export declare function renderBar(options: BarOptions): string;
  */
 export declare function renderBox(options: BoxOptions): string;
 
+/**
+ * Renders a box's top border across the supplied inner span.
+ * @example
+ * ```ts
+ * renderBoxTop({ content: '' }, 3) // '┌───┐'
+ * ```
+ */
+export declare function renderBoxTop(options: BoxOptions, span: number): string;
+
 /**
  * Declares a swappable style renderer — the seam that turns style data into output for one
  * target. The cross-environment default is the ANSI renderer (SGR escape codes); a

package/dist/src/core/index.js

@@ -1,6 +1,6 @@
-import { isArray, isError, isFunction, isInstance, isObject } from "@orkestrel/contract";
+import { INTRINSICS, holds, isArray, isError, isFunction, isInstance, isObject, isString } from "@orkestrel/contract";
 import { Emitter } from "@orkestrel/emitter";
-//#region src/core/constants.ts
+// src/core/constants.ts
 /**
 * Maps each {@link Color} to its SGR foreground parameter — the 8 base colors at 30–37 and their
 * bright variants at 90–97. `default` is intentionally absent (it emits no code).
@@ -111,7 +111,7 @@ var BEL = String.fromCharCode(7);
 /** Holds the Control Sequence Introducer (`ESC[`) that opens every SGR sequence. */
 var CSI = `[`;
 /** Holds the full SGR reset sequence (`ESC[0m`) appended after a styled run. */
-var RESET = `${CSI}0m`;
+var RESET = ``;
 /**
 * Matches any ANSI/VT escape sequence — CSI (SGR color/style plus cursor/erase/scroll,
 * including colon-parameterized SGR), OSC / DCS / PM / APC / SOS string sequences
@@ -484,8 +484,7 @@ var DEFAULT_THEME = Object.freeze({
 	}),
 	chrome: Object.freeze({ attributes: Object.freeze(["dim"]) })
 });
-//#endregion
-//#region src/core/errors.ts
+// src/core/errors.ts
 /**
 * Carries a {@link ConsoleErrorCode} and an optional `context` bag — the error the console layer
 * throws for an internal invariant violated at a defensive guard.
@@ -499,6 +498,7 @@ var ConsoleError = class extends Error {
 	context;
 	constructor(code, message, context) {
 		super(message);
+		Object.defineProperty(this, Symbol.for("@orkestrel/console.ConsoleError"), { value: this });
 		this.name = "ConsoleError";
 		this.code = code;
 		if (context !== void 0) this.context = context;
@@ -520,10 +520,14 @@ var ConsoleError = class extends Error {
 * ```
 */
 function isConsoleError(value) {
-	return isInstance(value, ConsoleError);
+	return holds(() => {
+		if (!isInstance(value, Error) || INTRINSICS.prototype(value) === Error.prototype) return false;
+		if (INTRINSICS.describe(value, Symbol.for("@orkestrel/console.ConsoleError"))?.value !== value) return false;
+		const context = INTRINSICS.reflect.read(value, "context");
+		return INTRINSICS.reflect.read(value, "code") === "INVARIANT" && isString(INTRINSICS.reflect.read(value, "message")) && (context === void 0 || isObject(context) || isFunction(context));
+	});
 }
-//#endregion
-//#region src/core/helpers.ts
+// src/core/helpers.ts
 /**
 * Removes every ANSI escape sequence from `text`, returning the plain visible string.
 *
@@ -887,23 +891,32 @@ function renderBox(options) {
 	const inner = lines.reduce((max, line) => Math.max(max, width(line)), Math.max(0, titleRoom, budget));
 	const gutter = " ".repeat(padding);
 	const bar = paint(styler, chars.vertical, options.style);
-	const span = inner + padding * 2;
-	let top;
-	if (options.title === void 0) top = paint(styler, `${chars.topLeft}${repeatTo(chars.horizontal, span)}${chars.topRight}`, options.style);
+	const top = renderBoxTop(options, inner + padding * 2);
+	const bottom = paint(styler, `${chars.bottomLeft}${repeatTo(chars.horizontal, inner + padding * 2)}${chars.bottomRight}`, options.style);
+	return [
+		top,
+		...lines.map((line) => `${bar}${gutter}${align(line, inner)}${gutter}${bar}`),
+		bottom
+	].join("\n");
+}
+/**
+* Renders a box's top border across the supplied inner span.
+* @example
+* ```ts
+* renderBoxTop({ content: '' }, 3) // '┌───┐'
+* ```
+*/
+function renderBoxTop(options, span) {
+	const chars = BORDER_CHARS[options.border ?? "single"];
+	const styler = options.styler;
+	if (options.title === void 0) return paint(styler, `${chars.topLeft}${repeatTo(chars.horizontal, span)}${chars.topRight}`, options.style);
 	else {
 		const caption = ` ${options.title} `;
 		const room = span - width(caption);
 		const lead = paint(styler, repeatTo(chars.horizontal, 1), options.style);
 		const rest = room - 1 <= 0 ? "" : paint(styler, repeatTo(chars.horizontal, room - 1), options.style);
-		top = `${paint(styler, chars.topLeft, options.style)}${lead}${paint(styler, caption, options.style)}${rest}${paint(styler, chars.topRight, options.style)}`;
+		return `${paint(styler, chars.topLeft, options.style)}${lead}${paint(styler, caption, options.style)}${rest}${paint(styler, chars.topRight, options.style)}`;
 	}
-	const bottom = paint(styler, `${chars.bottomLeft}${repeatTo(chars.horizontal, inner + padding * 2)}${chars.bottomRight}`, options.style);
-	const body = lines.map((line) => `${bar}${gutter}${align(line, inner)}${gutter}${bar}`);
-	return [
-		top,
-		...body,
-		bottom
-	].join("\n");
 }
 /**
 * Renders a bordered grid of `columns` + `rows` with per-column alignment and width-aware
@@ -1127,8 +1140,7 @@ function renderBar(options) {
 	const filledCells = Math.round(fraction * track);
 	return `${`${paint(options.styler, repeatTo(fill, filledCells), options.style)}${repeatTo(empty, track - filledCells)}`} ${Math.round(fraction * 100)}% (${current}/${options.total})`;
 }
-//#endregion
-//#region src/core/renderers/ANSIRenderer.ts
+// src/core/renderers/ANSIRenderer.ts
 /**
 * Implements the cross-environment default {@link RendererInterface} — renders style data as ANSI
 * SGR escape codes, stateless and event-free.
@@ -1160,7 +1172,7 @@ var ANSIRenderer = class {
 		if (text === "") return text;
 		const codes = this.#codes(style);
 		if (codes.length === 0) return text;
-		return `${CSI}${codes.join(";")}m${text}${RESET}`;
+		return `[${codes.join(";")}m${text}${RESET}`;
 	}
 	#codes(style) {
 		const codes = [];
@@ -1170,8 +1182,7 @@ var ANSIRenderer = class {
 		return codes;
 	}
 };
-//#endregion
-//#region src/core/Retention.ts
+// src/core/Retention.ts
 /**
 * Implements the bounded, level-keyed retention engine the console and process captures buffer
 * through — one capped total buffer
@@ -1227,8 +1238,7 @@ var Retention = class {
 		if (buffer.length > this.#limit) buffer.shift();
 	}
 };
-//#endregion
-//#region src/core/Capture.ts
+// src/core/Capture.ts
 /**
 * Implements an observable console interceptor — it takes control of the global `console.*` on
 * the read side. While `active`, every configured `console.x` call is captured as a frozen
@@ -1335,8 +1345,7 @@ var Capture = class {
 		});
 	}
 };
-//#endregion
-//#region src/core/Styler.ts
+// src/core/Styler.ts
 /**
 * Builds the fluent, composable styling surface — the consumer-facing API over the style
 * engine. It
@@ -1478,8 +1487,7 @@ var Styler = class Styler {
 		}));
 	}
 };
-//#endregion
-//#region src/core/factories.ts
+// src/core/factories.ts
 /**
 * Creates the fluent, composable {@link StylerInterface} — ANSI by default, retargeted by a
 * `renderer` and stripped of color by `enabled: false`.
@@ -1626,8 +1634,7 @@ function createCaptureResult(fn, options) {
 		throw error;
 	}
 }
-//#endregion
-//#region src/core/loggers/Logger.ts
+// src/core/loggers/Logger.ts
 /**
 * Implements an observable, leveled logger — the entry point into the structured-logging
 * pipeline. Each `debug` / `info` / `warn` / `error` call builds a frozen {@link LogRecord},
@@ -1737,8 +1744,7 @@ var Logger = class {
 		if (this.#entries.length > this.#limit) this.#entries.shift();
 	}
 };
-//#endregion
-//#region src/core/loggers/LoggerManager.ts
+// src/core/loggers/LoggerManager.ts
 /**
 * Implements an event-free registry of named {@link Logger}s plus a convenience fan-out — the
 * manager over the logging layer (a registry, never observable itself; each {@link Logger}
@@ -1832,16 +1838,41 @@ var LoggerManager = class {
 			this.#loggers.clear();
 			return;
 		}
-		if (isArray(names)) {
-			let removed = true;
-			for (const name of names) if (!this.#loggers.delete(name)) removed = false;
-			return removed;
-		}
+		if (isArray(names)) return Iterator.from(names).reduce((removed, name) => this.#loggers.delete(name) && removed, true);
 		return this.#loggers.delete(names);
 	}
 };
-//#endregion
-//#region src/core/Reporter.ts
+// src/core/LineIterator.ts
+/**
+* Yields a position for each requested blank line without allocating the whole sequence.
+* @example
+* ```ts
+* [...new LineIterator(2)] // [0, 1]
+* ```
+*/
+var LineIterator = class {
+	#count;
+	#index = 0;
+	constructor(count) {
+		this.#count = count;
+	}
+	next() {
+		if (!(this.#index < this.#count)) return {
+			done: true,
+			value: void 0
+		};
+		const value = this.#index;
+		this.#index += 1;
+		return {
+			done: false,
+			value
+		};
+	}
+	[Symbol.iterator]() {
+		return this;
+	}
+};
+// src/core/Reporter.ts
 /**
 * Implements a lean, event-free narrative reporter — the composable verb set for human /
 * build-run output. Each verb formats its line through the shared {@link StylerInterface} and
@@ -1919,7 +1950,7 @@ var Reporter = class {
 		this.#sink.write(text);
 	}
 	blank(count = 1) {
-		for (let index = 0; index < count; index += 1) this.#sink.write("");
+		Iterator.from(new LineIterator(count)).forEach(() => this.#sink.write(""));
 	}
 	#resolveStyle(options) {
 		return {
@@ -1929,8 +1960,7 @@ var Reporter = class {
 		};
 	}
 };
-//#endregion
-//#region src/core/Spinner.ts
+// src/core/Spinner.ts
 /**
 * Implements a self-driving, observable activity spinner — a glyph cycle that advances on a
 * periodic timer, writing each `\r` + frame line to its {@link SinkInterface} and emitting it on
@@ -2048,8 +2078,7 @@ var Spinner = class {
 		this.#sink.write(`\r${line}`);
 	}
 };
-//#endregion
-//#region src/core/Progress.ts
+// src/core/Progress.ts
 /**
 * Implements an update-driven, observable progress bar — {@link update} recomputes the bar through
 * {@link renderBar}, writes `\r` + bar to its {@link SinkInterface}, and emits the `{ current,
@@ -2168,7 +2197,6 @@ var Progress = class {
 		this.#sink.write(`\r${line}${final ? "\n" : ""}`, level);
 	}
 };
-//#endregion
-export { ANSIRenderer, ANSI_PATTERN, ATTRIBUTES, ATTRIBUTE_CODES, BACKGROUND_CODES, BAR_EMPTY, BAR_FILL, BEL, BORDER_CHARS, CAPTURE_LEVELS, CAPTURE_LEVEL_MAP, COLORS, CONTROL_PATTERN, CSI, Capture, ConsoleError, DEFAULT_ALIGN, DEFAULT_BAR_WIDTH, DEFAULT_BORDER, DEFAULT_CAPTURE_LIMIT, DEFAULT_LOG_LEVEL, DEFAULT_LOG_LIMIT, DEFAULT_PADDING, DEFAULT_SPINNER_INTERVAL, DEFAULT_THEME, DEFAULT_WIDTH, EMPTY_STYLE, ESC, FOREGROUND_CODES, LEVEL_COLORS, LEVEL_SEVERITY, LOG_LEVELS, Logger, LoggerManager, Progress, RESET, RESET_CODE, Reporter, Retention, SECOND_MS, SEPARATOR_FILL, SEPARATOR_TITLE_GAP, SPINNER_FRAMES, STATUS_COLORS, STATUS_ICONS, STATUS_LEVELS, Spinner, align, cellAt, createCaptureResult, createConsoleSink, createStyler, createTheme, formatArgs, formatDuration, formatRecord, formatTime, freezeStyle, isConsoleError, meetsLevel, paint, renderBar, renderBox, renderSeparator, renderTable, renderTree, renderTreeChildren, repeatTo, selectWriter, stringifyValue, strip, stripControls, width };
+export { ANSIRenderer, ANSI_PATTERN, ATTRIBUTES, ATTRIBUTE_CODES, BACKGROUND_CODES, BAR_EMPTY, BAR_FILL, BEL, BORDER_CHARS, CAPTURE_LEVELS, CAPTURE_LEVEL_MAP, COLORS, CONTROL_PATTERN, CSI, Capture, ConsoleError, DEFAULT_ALIGN, DEFAULT_BAR_WIDTH, DEFAULT_BORDER, DEFAULT_CAPTURE_LIMIT, DEFAULT_LOG_LEVEL, DEFAULT_LOG_LIMIT, DEFAULT_PADDING, DEFAULT_SPINNER_INTERVAL, DEFAULT_THEME, DEFAULT_WIDTH, EMPTY_STYLE, ESC, FOREGROUND_CODES, LEVEL_COLORS, LEVEL_SEVERITY, LOG_LEVELS, LineIterator, Logger, LoggerManager, Progress, RESET, RESET_CODE, Reporter, Retention, SECOND_MS, SEPARATOR_FILL, SEPARATOR_TITLE_GAP, SPINNER_FRAMES, STATUS_COLORS, STATUS_ICONS, STATUS_LEVELS, Spinner, align, cellAt, createCaptureResult, createConsoleSink, createStyler, createTheme, formatArgs, formatDuration, formatRecord, formatTime, freezeStyle, isConsoleError, meetsLevel, paint, renderBar, renderBox, renderBoxTop, renderSeparator, renderTable, renderTree, renderTreeChildren, repeatTo, selectWriter, stringifyValue, strip, stripControls, width };
 
 //# sourceMappingURL=index.js.map