@optique/logtape 1.0.0-dev.921 → 1.0.1

package/dist/index.cjs

@@ -25,6 +25,8 @@ const __optique_core_valueparser = __toESM(require("@optique/core/valueparser"))
 const __optique_core_primitives = __toESM(require("@optique/core/primitives"));
 const __optique_core_modifiers = __toESM(require("@optique/core/modifiers"));
 const __optique_core_message = __toESM(require("@optique/core/message"));
+const node_path = __toESM(require("node:path"));
+const __optique_core_nonempty = __toESM(require("@optique/core/nonempty"));
 const __optique_core_constructs = __toESM(require("@optique/core/constructs"));
 
 //#region src/loglevel.ts
@@ -40,6 +42,17 @@ const LOG_LEVELS = [
 	"fatal"
 ];
 /**
+* Validates that the given value is a valid {@link LogLevel}.
+*
+* @param value The value to validate.
+* @param paramName The parameter name for the error message.
+* @throws {TypeError} If the value is not a valid log level.
+* @since 1.0.0
+*/
+function validateLogLevel(value, paramName) {
+	if (!LOG_LEVELS.includes(value)) throw new TypeError(`Invalid log level for ${paramName}: ${String(value)}.  Expected ${LOG_LEVELS.map((l) => `"${l}"`).join(", ")}.`);
+}
+/**
 * Creates a {@link ValueParser} for LogTape log levels.
 *
 * This parser validates that the input is one of the valid LogTape severity
@@ -112,6 +125,7 @@ const WARNING_INDEX = 2;
 *
 * @param options Configuration options for the verbosity parser.
 * @returns A {@link Parser} that produces a {@link LogLevel}.
+* @throws {TypeError} If `baseLevel` is not a valid log level.
 *
 * @example Basic usage
 * ```typescript
@@ -146,6 +160,7 @@ function verbosity(options = {}) {
 	const short = options.short ?? "-v";
 	const long = options.long ?? "--verbose";
 	const baseLevel = options.baseLevel ?? "warning";
+	validateLogLevel(baseLevel, "baseLevel");
 	const baseIndex = VERBOSITY_LEVELS.indexOf(baseLevel);
 	const effectiveBaseIndex = baseIndex >= 0 ? baseIndex : WARNING_INDEX;
 	const flagParser = (0, __optique_core_primitives.flag)(short, long, { description: options.description ?? __optique_core_message.message`Be more verbose. Can be repeated.` });
@@ -168,6 +183,8 @@ function verbosity(options = {}) {
 *
 * @param options Configuration options for the debug flag parser.
 * @returns A {@link Parser} that produces a {@link LogLevel}.
+* @throws {TypeError} If `debugLevel` or `normalLevel` is not a valid log
+*   level.
 *
 * @example Basic usage
 * ```typescript
@@ -201,6 +218,8 @@ function debug(options = {}) {
 	const long = options.long ?? "--debug";
 	const debugLevel = options.debugLevel ?? "debug";
 	const normalLevel = options.normalLevel ?? "info";
+	validateLogLevel(debugLevel, "debugLevel");
+	validateLogLevel(normalLevel, "normalLevel");
 	const flagParser = (0, __optique_core_primitives.flag)(short, long, { description: options.description ?? __optique_core_message.message`Enable debug logging.` });
 	return (0, __optique_core_modifiers.map)((0, __optique_core_modifiers.optional)(flagParser), (value) => {
 		return value === true ? debugLevel : normalLevel;
@@ -218,11 +237,15 @@ function debug(options = {}) {
 *
 * @param options Configuration options for the parser.
 * @returns A {@link ValueParser} that produces a {@link LogOutput}.
+* @throws {TypeError} If `options.metavar` is an empty string.
 */
 function logOutputValueParser(options = {}) {
+	const metavar = options.metavar ?? "FILE";
+	(0, __optique_core_nonempty.ensureNonEmptyString)(metavar);
 	return {
-		$mode: "sync",
-		metavar: options.metavar ?? "FILE",
+		mode: "sync",
+		metavar,
+		placeholder: { type: "console" },
 		parse(input) {
 			if (input === "-") return {
 				success: true,
@@ -251,7 +274,8 @@ function logOutputValueParser(options = {}) {
 			yield {
 				kind: "file",
 				type: "file",
-				pattern: prefix
+				pattern: prefix,
+				includeHidden: (0, node_path.basename)(prefix).startsWith(".") && (0, node_path.basename)(prefix) !== ".."
 			};
 		}
 	};
@@ -264,6 +288,7 @@ function logOutputValueParser(options = {}) {
 *
 * @param options Configuration options for the log output parser.
 * @returns A {@link Parser} that produces a {@link LogOutput} or `undefined`.
+* @throws {TypeError} If `options.metavar` is an empty string.
 *
 * @example Basic usage
 * ```typescript
@@ -299,6 +324,10 @@ function logOutput(options = {}) {
 *
 * @param options Configuration options for the console sink.
 * @returns A {@link Sink} function.
+* @throws {TypeError} If `options.stream` is not `"stdout"` or `"stderr"`
+*   when `streamResolver` is not provided.
+* @throws {TypeError} If `streamResolver` returns a value other than
+*   `"stdout"` or `"stderr"`.
 *
 * @example Static stream selection
 * ```typescript
@@ -320,10 +349,23 @@ function logOutput(options = {}) {
 * @since 0.8.0
 */
 function createConsoleSink(options = {}) {
-	const defaultStream = options.stream ?? "stderr";
 	const streamResolver = options.streamResolver;
+	const defaultStream = options.stream ?? "stderr";
+	const invalidStreamError = (value) => {
+		let repr;
+		if (typeof value === "string") repr = JSON.stringify(value);
+		else if (value === null || typeof value !== "object") repr = String(value);
+		else try {
+			repr = JSON.stringify(value) ?? String(value);
+		} catch {
+			repr = String(value);
+		}
+		return /* @__PURE__ */ new TypeError(`Invalid stream: expected "stdout" or "stderr", got ${repr}.`);
+	};
+	if (!streamResolver && defaultStream !== "stdout" && defaultStream !== "stderr") throw invalidStreamError(defaultStream);
 	return (record) => {
 		const stream = streamResolver ? streamResolver(record.level) : defaultStream;
+		if (stream !== "stdout" && stream !== "stderr") throw invalidStreamError(stream);
 		const messageParts = [];
 		for (let i = 0; i < record.message.length; i++) {
 			const part = record.message[i];
@@ -331,7 +373,8 @@ function createConsoleSink(options = {}) {
 			else messageParts.push(String(part));
 		}
 		const formattedMessage = messageParts.join("");
-		const timestamp = record.timestamp ? new Date(record.timestamp).toISOString() : (/* @__PURE__ */ new Date()).toISOString();
+		const ts = record.timestamp;
+		const timestamp = new Date(ts != null && !Number.isNaN(ts) ? ts : Date.now()).toISOString();
 		const category = record.category.join(".");
 		const level = record.level.toUpperCase().padEnd(7);
 		const line = `${timestamp} [${level}] ${category}: ${formattedMessage}`;
@@ -348,7 +391,11 @@ function createConsoleSink(options = {}) {
 * @param output The log output destination.
 * @param consoleSinkOptions Options for console sink (only used when output is console).
 * @returns A promise that resolves to a {@link Sink}.
-* @throws {Error} If file output is requested but `@logtape/file` is not installed.
+* @throws {Error} If file output is requested but `@logtape/file` is not
+*   installed.
+* @throws If `@logtape/file` is installed but `getFileSink(output.path)` fails
+*   at runtime (e.g., the target directory does not exist), the original error
+*   propagates as-is.
 *
 * @example Console output
 * ```typescript
@@ -368,9 +415,9 @@ function createConsoleSink(options = {}) {
 */
 async function createSink(output, consoleSinkOptions = {}) {
 	if (output.type === "console") return createConsoleSink(consoleSinkOptions);
+	let getFileSink;
 	try {
-		const { getFileSink } = await import("@logtape/file");
-		return getFileSink(output.path);
+		({getFileSink} = await import("@logtape/file"));
 	} catch (e) {
 		throw new Error(`File sink requires @logtape/file package. Install it with:
   npm install @logtape/file
@@ -379,6 +426,7 @@ async function createSink(output, consoleSinkOptions = {}) {
 
 Original error: ${e}`);
 	}
+	return getFileSink(output.path);
 }
 
 //#endregion
@@ -430,6 +478,9 @@ Original error: ${e}`);
 * // --debug
 * ```
 *
+* @throws {TypeError} If the `level` discriminant is not one of `"option"`,
+*   `"verbosity"`, or `"debug"`, or if a log level option (`default`,
+*   `debugLevel`, `normalLevel`, or `baseLevel`) is not a valid log level.
 * @since 0.8.0
 */
 function loggingOptions(config) {
@@ -442,6 +493,7 @@ function loggingOptions(config) {
 			const long = config.long ?? "--log-level";
 			const short = config.short ?? "-l";
 			const defaultLevel = config.default ?? "info";
+			validateLogLevel(defaultLevel, "default");
 			levelParser = (0, __optique_core_modifiers.withDefault)((0, __optique_core_primitives.option)(short, long, logLevel()), defaultLevel);
 			break;
 		}
@@ -464,16 +516,19 @@ function loggingOptions(config) {
 			levelParser = debug(debugOptions);
 			break;
 		}
+		default: throw new TypeError(`Unsupported level configuration: ${String(config.level)}.  Expected "option", "verbosity", or "debug".`);
 	}
 	const defaultOutput = { type: "console" };
 	const outputParser = (0, __optique_core_modifiers.withDefault)(logOutput({ long: outputLong }), defaultOutput);
 	if (!outputEnabled) {
 		const constantOutputParser = {
-			$mode: "sync",
+			mode: "sync",
 			$valueType: [],
 			$stateType: [],
 			priority: 0,
 			usage: [],
+			leadingNames: /* @__PURE__ */ new Set(),
+			acceptingAnyToken: false,
 			initialState: void 0,
 			parse: (context) => ({
 				success: true,

package/dist/index.d.cts

@@ -8,6 +8,15 @@ import { Parser } from "@optique/core/parser";
  * All valid log levels in order from lowest to highest severity.
  */
 declare const LOG_LEVELS: readonly LogLevel$1[];
+/**
+ * Validates that the given value is a valid {@link LogLevel}.
+ *
+ * @param value The value to validate.
+ * @param paramName The parameter name for the error message.
+ * @throws {TypeError} If the value is not a valid log level.
+ * @since 1.0.0
+ */
+
 /**
  * Options for creating a log level value parser.
  * @since 0.8.0
@@ -105,6 +114,7 @@ interface VerbosityOptions {
  *
  * @param options Configuration options for the verbosity parser.
  * @returns A {@link Parser} that produces a {@link LogLevel}.
+ * @throws {TypeError} If `baseLevel` is not a valid log level.
  *
  * @example Basic usage
  * ```typescript
@@ -177,6 +187,8 @@ interface DebugOptions {
  *
  * @param options Configuration options for the debug flag parser.
  * @returns A {@link Parser} that produces a {@link LogLevel}.
+ * @throws {TypeError} If `debugLevel` or `normalLevel` is not a valid log
+ *   level.
  *
  * @example Basic usage
  * ```typescript
@@ -228,9 +240,10 @@ type LogOutput = {
 interface ConsoleSinkOptions {
   /**
    * The stream to write to. Either `"stdout"` or `"stderr"`.
+   * If `null` or `undefined`, defaults to `"stderr"`.
    * @default `"stderr"`
    */
-  readonly stream?: "stdout" | "stderr";
+  readonly stream?: "stdout" | "stderr" | null;
   /**
    * A function that determines which stream to use based on the log level.
    * If provided, this takes precedence over the `stream` option.
@@ -287,6 +300,7 @@ interface LogOutputOptions {
  *
  * @param options Configuration options for the log output parser.
  * @returns A {@link Parser} that produces a {@link LogOutput} or `undefined`.
+ * @throws {TypeError} If `options.metavar` is an empty string.
  *
  * @example Basic usage
  * ```typescript
@@ -313,6 +327,10 @@ declare function logOutput(options?: LogOutputOptions): Parser<"sync", LogOutput
  *
  * @param options Configuration options for the console sink.
  * @returns A {@link Sink} function.
+ * @throws {TypeError} If `options.stream` is not `"stdout"` or `"stderr"`
+ *   when `streamResolver` is not provided.
+ * @throws {TypeError} If `streamResolver` returns a value other than
+ *   `"stdout"` or `"stderr"`.
  *
  * @example Static stream selection
  * ```typescript
@@ -343,7 +361,11 @@ declare function createConsoleSink(options?: ConsoleSinkOptions): Sink$1;
  * @param output The log output destination.
  * @param consoleSinkOptions Options for console sink (only used when output is console).
  * @returns A promise that resolves to a {@link Sink}.
- * @throws {Error} If file output is requested but `@logtape/file` is not installed.
+ * @throws {Error} If file output is requested but `@logtape/file` is not
+ *   installed.
+ * @throws If `@logtape/file` is installed but `getFileSink(output.path)` fails
+ *   at runtime (e.g., the target directory does not exist), the original error
+ *   propagates as-is.
  *
  * @example Console output
  * ```typescript
@@ -561,6 +583,9 @@ type LoggingOptionsConfig = LoggingOptionsWithLevel | LoggingOptionsWithVerbosit
  * // --debug
  * ```
  *
+ * @throws {TypeError} If the `level` discriminant is not one of `"option"`,
+ *   `"verbosity"`, or `"debug"`, or if a log level option (`default`,
+ *   `debugLevel`, `normalLevel`, or `baseLevel`) is not a valid log level.
  * @since 0.8.0
  */
 declare function loggingOptions(config: LoggingOptionsConfig): Parser<"sync", LoggingOptionsResult, unknown>;

package/dist/index.d.ts

@@ -8,6 +8,15 @@ import { Parser } from "@optique/core/parser";
  * All valid log levels in order from lowest to highest severity.
  */
 declare const LOG_LEVELS: readonly LogLevel$1[];
+/**
+ * Validates that the given value is a valid {@link LogLevel}.
+ *
+ * @param value The value to validate.
+ * @param paramName The parameter name for the error message.
+ * @throws {TypeError} If the value is not a valid log level.
+ * @since 1.0.0
+ */
+
 /**
  * Options for creating a log level value parser.
  * @since 0.8.0
@@ -105,6 +114,7 @@ interface VerbosityOptions {
  *
  * @param options Configuration options for the verbosity parser.
  * @returns A {@link Parser} that produces a {@link LogLevel}.
+ * @throws {TypeError} If `baseLevel` is not a valid log level.
  *
  * @example Basic usage
  * ```typescript
@@ -177,6 +187,8 @@ interface DebugOptions {
  *
  * @param options Configuration options for the debug flag parser.
  * @returns A {@link Parser} that produces a {@link LogLevel}.
+ * @throws {TypeError} If `debugLevel` or `normalLevel` is not a valid log
+ *   level.
  *
  * @example Basic usage
  * ```typescript
@@ -228,9 +240,10 @@ type LogOutput = {
 interface ConsoleSinkOptions {
   /**
    * The stream to write to. Either `"stdout"` or `"stderr"`.
+   * If `null` or `undefined`, defaults to `"stderr"`.
    * @default `"stderr"`
    */
-  readonly stream?: "stdout" | "stderr";
+  readonly stream?: "stdout" | "stderr" | null;
   /**
    * A function that determines which stream to use based on the log level.
    * If provided, this takes precedence over the `stream` option.
@@ -287,6 +300,7 @@ interface LogOutputOptions {
  *
  * @param options Configuration options for the log output parser.
  * @returns A {@link Parser} that produces a {@link LogOutput} or `undefined`.
+ * @throws {TypeError} If `options.metavar` is an empty string.
  *
  * @example Basic usage
  * ```typescript
@@ -313,6 +327,10 @@ declare function logOutput(options?: LogOutputOptions): Parser<"sync", LogOutput
  *
  * @param options Configuration options for the console sink.
  * @returns A {@link Sink} function.
+ * @throws {TypeError} If `options.stream` is not `"stdout"` or `"stderr"`
+ *   when `streamResolver` is not provided.
+ * @throws {TypeError} If `streamResolver` returns a value other than
+ *   `"stdout"` or `"stderr"`.
  *
  * @example Static stream selection
  * ```typescript
@@ -343,7 +361,11 @@ declare function createConsoleSink(options?: ConsoleSinkOptions): Sink$1;
  * @param output The log output destination.
  * @param consoleSinkOptions Options for console sink (only used when output is console).
  * @returns A promise that resolves to a {@link Sink}.
- * @throws {Error} If file output is requested but `@logtape/file` is not installed.
+ * @throws {Error} If file output is requested but `@logtape/file` is not
+ *   installed.
+ * @throws If `@logtape/file` is installed but `getFileSink(output.path)` fails
+ *   at runtime (e.g., the target directory does not exist), the original error
+ *   propagates as-is.
  *
  * @example Console output
  * ```typescript
@@ -561,6 +583,9 @@ type LoggingOptionsConfig = LoggingOptionsWithLevel | LoggingOptionsWithVerbosit
  * // --debug
  * ```
  *
+ * @throws {TypeError} If the `level` discriminant is not one of `"option"`,
+ *   `"verbosity"`, or `"debug"`, or if a log level option (`default`,
+ *   `debugLevel`, `normalLevel`, or `baseLevel`) is not a valid log level.
  * @since 0.8.0
  */
 declare function loggingOptions(config: LoggingOptionsConfig): Parser<"sync", LoggingOptionsResult, unknown>;

package/dist/index.js

@@ -2,6 +2,8 @@ import { choice } from "@optique/core/valueparser";
 import { flag, option } from "@optique/core/primitives";
 import { map, multiple, optional, withDefault } from "@optique/core/modifiers";
 import { message } from "@optique/core/message";
+import { basename } from "node:path";
+import { ensureNonEmptyString } from "@optique/core/nonempty";
 import { group, object } from "@optique/core/constructs";
 
 //#region src/loglevel.ts
@@ -17,6 +19,17 @@ const LOG_LEVELS = [
 	"fatal"
 ];
 /**
+* Validates that the given value is a valid {@link LogLevel}.
+*
+* @param value The value to validate.
+* @param paramName The parameter name for the error message.
+* @throws {TypeError} If the value is not a valid log level.
+* @since 1.0.0
+*/
+function validateLogLevel(value, paramName) {
+	if (!LOG_LEVELS.includes(value)) throw new TypeError(`Invalid log level for ${paramName}: ${String(value)}.  Expected ${LOG_LEVELS.map((l) => `"${l}"`).join(", ")}.`);
+}
+/**
 * Creates a {@link ValueParser} for LogTape log levels.
 *
 * This parser validates that the input is one of the valid LogTape severity
@@ -89,6 +102,7 @@ const WARNING_INDEX = 2;
 *
 * @param options Configuration options for the verbosity parser.
 * @returns A {@link Parser} that produces a {@link LogLevel}.
+* @throws {TypeError} If `baseLevel` is not a valid log level.
 *
 * @example Basic usage
 * ```typescript
@@ -123,6 +137,7 @@ function verbosity(options = {}) {
 	const short = options.short ?? "-v";
 	const long = options.long ?? "--verbose";
 	const baseLevel = options.baseLevel ?? "warning";
+	validateLogLevel(baseLevel, "baseLevel");
 	const baseIndex = VERBOSITY_LEVELS.indexOf(baseLevel);
 	const effectiveBaseIndex = baseIndex >= 0 ? baseIndex : WARNING_INDEX;
 	const flagParser = flag(short, long, { description: options.description ?? message`Be more verbose. Can be repeated.` });
@@ -145,6 +160,8 @@ function verbosity(options = {}) {
 *
 * @param options Configuration options for the debug flag parser.
 * @returns A {@link Parser} that produces a {@link LogLevel}.
+* @throws {TypeError} If `debugLevel` or `normalLevel` is not a valid log
+*   level.
 *
 * @example Basic usage
 * ```typescript
@@ -178,6 +195,8 @@ function debug(options = {}) {
 	const long = options.long ?? "--debug";
 	const debugLevel = options.debugLevel ?? "debug";
 	const normalLevel = options.normalLevel ?? "info";
+	validateLogLevel(debugLevel, "debugLevel");
+	validateLogLevel(normalLevel, "normalLevel");
 	const flagParser = flag(short, long, { description: options.description ?? message`Enable debug logging.` });
 	return map(optional(flagParser), (value) => {
 		return value === true ? debugLevel : normalLevel;
@@ -195,11 +214,15 @@ function debug(options = {}) {
 *
 * @param options Configuration options for the parser.
 * @returns A {@link ValueParser} that produces a {@link LogOutput}.
+* @throws {TypeError} If `options.metavar` is an empty string.
 */
 function logOutputValueParser(options = {}) {
+	const metavar = options.metavar ?? "FILE";
+	ensureNonEmptyString(metavar);
 	return {
-		$mode: "sync",
-		metavar: options.metavar ?? "FILE",
+		mode: "sync",
+		metavar,
+		placeholder: { type: "console" },
 		parse(input) {
 			if (input === "-") return {
 				success: true,
@@ -228,7 +251,8 @@ function logOutputValueParser(options = {}) {
 			yield {
 				kind: "file",
 				type: "file",
-				pattern: prefix
+				pattern: prefix,
+				includeHidden: basename(prefix).startsWith(".") && basename(prefix) !== ".."
 			};
 		}
 	};
@@ -241,6 +265,7 @@ function logOutputValueParser(options = {}) {
 *
 * @param options Configuration options for the log output parser.
 * @returns A {@link Parser} that produces a {@link LogOutput} or `undefined`.
+* @throws {TypeError} If `options.metavar` is an empty string.
 *
 * @example Basic usage
 * ```typescript
@@ -276,6 +301,10 @@ function logOutput(options = {}) {
 *
 * @param options Configuration options for the console sink.
 * @returns A {@link Sink} function.
+* @throws {TypeError} If `options.stream` is not `"stdout"` or `"stderr"`
+*   when `streamResolver` is not provided.
+* @throws {TypeError} If `streamResolver` returns a value other than
+*   `"stdout"` or `"stderr"`.
 *
 * @example Static stream selection
 * ```typescript
@@ -297,10 +326,23 @@ function logOutput(options = {}) {
 * @since 0.8.0
 */
 function createConsoleSink(options = {}) {
-	const defaultStream = options.stream ?? "stderr";
 	const streamResolver = options.streamResolver;
+	const defaultStream = options.stream ?? "stderr";
+	const invalidStreamError = (value) => {
+		let repr;
+		if (typeof value === "string") repr = JSON.stringify(value);
+		else if (value === null || typeof value !== "object") repr = String(value);
+		else try {
+			repr = JSON.stringify(value) ?? String(value);
+		} catch {
+			repr = String(value);
+		}
+		return /* @__PURE__ */ new TypeError(`Invalid stream: expected "stdout" or "stderr", got ${repr}.`);
+	};
+	if (!streamResolver && defaultStream !== "stdout" && defaultStream !== "stderr") throw invalidStreamError(defaultStream);
 	return (record) => {
 		const stream = streamResolver ? streamResolver(record.level) : defaultStream;
+		if (stream !== "stdout" && stream !== "stderr") throw invalidStreamError(stream);
 		const messageParts = [];
 		for (let i = 0; i < record.message.length; i++) {
 			const part = record.message[i];
@@ -308,7 +350,8 @@ function createConsoleSink(options = {}) {
 			else messageParts.push(String(part));
 		}
 		const formattedMessage = messageParts.join("");
-		const timestamp = record.timestamp ? new Date(record.timestamp).toISOString() : (/* @__PURE__ */ new Date()).toISOString();
+		const ts = record.timestamp;
+		const timestamp = new Date(ts != null && !Number.isNaN(ts) ? ts : Date.now()).toISOString();
 		const category = record.category.join(".");
 		const level = record.level.toUpperCase().padEnd(7);
 		const line = `${timestamp} [${level}] ${category}: ${formattedMessage}`;
@@ -325,7 +368,11 @@ function createConsoleSink(options = {}) {
 * @param output The log output destination.
 * @param consoleSinkOptions Options for console sink (only used when output is console).
 * @returns A promise that resolves to a {@link Sink}.
-* @throws {Error} If file output is requested but `@logtape/file` is not installed.
+* @throws {Error} If file output is requested but `@logtape/file` is not
+*   installed.
+* @throws If `@logtape/file` is installed but `getFileSink(output.path)` fails
+*   at runtime (e.g., the target directory does not exist), the original error
+*   propagates as-is.
 *
 * @example Console output
 * ```typescript
@@ -345,9 +392,9 @@ function createConsoleSink(options = {}) {
 */
 async function createSink(output, consoleSinkOptions = {}) {
 	if (output.type === "console") return createConsoleSink(consoleSinkOptions);
+	let getFileSink;
 	try {
-		const { getFileSink } = await import("@logtape/file");
-		return getFileSink(output.path);
+		({getFileSink} = await import("@logtape/file"));
 	} catch (e) {
 		throw new Error(`File sink requires @logtape/file package. Install it with:
   npm install @logtape/file
@@ -356,6 +403,7 @@ async function createSink(output, consoleSinkOptions = {}) {
 
 Original error: ${e}`);
 	}
+	return getFileSink(output.path);
 }
 
 //#endregion
@@ -407,6 +455,9 @@ Original error: ${e}`);
 * // --debug
 * ```
 *
+* @throws {TypeError} If the `level` discriminant is not one of `"option"`,
+*   `"verbosity"`, or `"debug"`, or if a log level option (`default`,
+*   `debugLevel`, `normalLevel`, or `baseLevel`) is not a valid log level.
 * @since 0.8.0
 */
 function loggingOptions(config) {
@@ -419,6 +470,7 @@ function loggingOptions(config) {
 			const long = config.long ?? "--log-level";
 			const short = config.short ?? "-l";
 			const defaultLevel = config.default ?? "info";
+			validateLogLevel(defaultLevel, "default");
 			levelParser = withDefault(option(short, long, logLevel()), defaultLevel);
 			break;
 		}
@@ -441,16 +493,19 @@ function loggingOptions(config) {
 			levelParser = debug(debugOptions);
 			break;
 		}
+		default: throw new TypeError(`Unsupported level configuration: ${String(config.level)}.  Expected "option", "verbosity", or "debug".`);
 	}
 	const defaultOutput = { type: "console" };
 	const outputParser = withDefault(logOutput({ long: outputLong }), defaultOutput);
 	if (!outputEnabled) {
 		const constantOutputParser = {
-			$mode: "sync",
+			mode: "sync",
 			$valueType: [],
 			$stateType: [],
 			priority: 0,
 			usage: [],
+			leadingNames: /* @__PURE__ */ new Set(),
+			acceptingAnyToken: false,
 			initialState: void 0,
 			parse: (context) => ({
 				success: true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/logtape",
-  "version": "1.0.0-dev.921+754748bd",
+  "version": "1.0.1",
   "description": "LogTape logging integration for Optique CLI parser",
   "keywords": [
     "CLI",
@@ -54,7 +54,8 @@
   },
   "sideEffects": false,
   "peerDependencies": {
-    "@logtape/logtape": "^1.2.2"
+    "@logtape/file": "^2.0.4",
+    "@logtape/logtape": "^2.0.4"
   },
   "peerDependenciesMeta": {
     "@logtape/file": {
@@ -62,10 +63,11 @@
     }
   },
   "dependencies": {
-    "@optique/core": "1.0.0-dev.921+754748bd"
+    "@optique/core": "1.0.1"
   },
   "devDependencies": {
-    "@logtape/logtape": "^1.2.2",
+    "@logtape/file": "^2.0.4",
+    "@logtape/logtape": "^2.0.4",
     "@types/node": "^20.19.9",
     "tsdown": "^0.13.0",
     "typescript": "^5.8.3"