@logtape/config 1.4.0-dev.1

package/dist/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","names":["parsed: ParsedModuleReference","shorthands: ShorthandRegistry","type: \"sinks\" | \"filters\" | \"formatters\"","mod: Record<string, unknown>","config: SinkConfig","sink: Sink","options: Record<string, unknown>","fmtOptions: Record<string, unknown>","config: FilterConfig"],"sources":["../src/loader.ts"],"sourcesContent":["import { parseModuleReference } from \"./parser.ts\";\nimport { ConfigError } from \"./types.ts\";\nimport type {\n  FilterConfig,\n  FormatterConfig,\n  ParsedModuleReference,\n  ShorthandRegistry,\n  SinkConfig,\n} from \"./types.ts\";\nimport type { Filter, Sink } from \"@logtape/logtape\";\n\n/**\n * Loads a module and extracts the specified export.\n *\n * @param parsed Parsed module reference\n * @param shorthands Shorthand registry for resolving shorthands\n * @param type Type of shorthand (sinks, filters, formatters)\n * @returns The loaded module export\n * @since 1.4.0\n */\nexport async function loadModuleExport(\n  parsed: ParsedModuleReference,\n  shorthands: ShorthandRegistry,\n  type: \"sinks\" | \"filters\" | \"formatters\",\n): Promise<unknown> {\n  if (parsed.isShorthand) {\n    const registry = shorthands[type];\n    const resolved = registry ? registry[parsed.shorthandName!] : undefined;\n\n    if (!resolved) {\n      throw new ConfigError(\n        `Unknown ${type.slice(0, -1)} shorthand: #${parsed.shorthandName}`,\n      );\n    }\n\n    const resolvedParsed = parseModuleReference(resolved);\n    // Inherit isFactory from the original shorthand usage if meaningful?\n    // Actually, the resolved string decides the module and export.\n    // The usage (with or without parens) decides if we call it.\n    // But here we are just loading the export.\n    return loadModuleExport(resolvedParsed, shorthands, type);\n  }\n\n  if (!parsed.modulePath) {\n    throw new ConfigError(\"Module path is missing\");\n  }\n\n  let mod: Record<string, unknown>;\n  try {\n    mod = await import(parsed.modulePath);\n  } catch (e) {\n    throw new ConfigError(\n      `Failed to load module ${parsed.modulePath}: ${e}`,\n    );\n  }\n\n  const exportName = parsed.exportName ?? \"default\";\n  const exported = mod[exportName];\n\n  if (exported === undefined) {\n    throw new ConfigError(\n      `Module ${parsed.modulePath} does not have export '${exportName}'`,\n    );\n  }\n\n  return exported;\n}\n\n/**\n * Creates a sink from configuration.\n *\n * @param config Sink configuration\n * @param shorthands Shorthand registry\n * @returns The created sink\n * @since 1.4.0\n */\nexport async function createSink(\n  config: SinkConfig,\n  shorthands: ShorthandRegistry,\n): Promise<Sink> {\n  const parsed = parseModuleReference(config.type);\n  const factory = await loadModuleExport(parsed, shorthands, \"sinks\");\n\n  let sink: Sink;\n  if (parsed.isFactory) {\n    if (typeof factory !== \"function\") {\n      throw new ConfigError(\n        `Export ${parsed.exportName} in ${parsed.modulePath} is not a function, but invoked as factory`,\n      );\n    }\n\n    // Process formatter if present\n    const options: Record<string, unknown> = { ...config };\n    delete options.type;\n\n    if (options.formatter) {\n      if (typeof options.formatter === \"string\") {\n        const fmtParsed = parseModuleReference(options.formatter);\n        const fmtFactory = await loadModuleExport(\n          fmtParsed,\n          shorthands,\n          \"formatters\",\n        );\n        if (fmtParsed.isFactory) {\n          if (typeof fmtFactory !== \"function\") {\n            throw new ConfigError(\n              `Formatter ${options.formatter} is not a function`,\n            );\n          }\n          options.formatter = (fmtFactory as (opts?: unknown) => unknown)({});\n        } else {\n          options.formatter = fmtFactory;\n        }\n      } else {\n        // FormatterConfig\n        const fmtConfig = options.formatter as FormatterConfig;\n        const fmtParsed = parseModuleReference(fmtConfig.type);\n        const fmtFactory = await loadModuleExport(\n          fmtParsed,\n          shorthands,\n          \"formatters\",\n        );\n\n        if (fmtParsed.isFactory) {\n          if (typeof fmtFactory !== \"function\") {\n            throw new ConfigError(\n              `Formatter ${fmtConfig.type} is not a function`,\n            );\n          }\n          const fmtOptions: Record<string, unknown> = { ...fmtConfig };\n          delete fmtOptions.type;\n          options.formatter = (fmtFactory as (opts: unknown) => unknown)(\n            fmtOptions,\n          );\n        } else {\n          options.formatter = fmtFactory;\n        }\n      }\n    }\n\n    sink = (factory as (opts: unknown) => Sink)(options);\n  } else {\n    sink = factory as Sink;\n  }\n\n  return sink;\n}\n\n/**\n * Creates a filter from configuration.\n *\n * @param config Filter configuration\n * @param shorthands Shorthand registry\n * @returns The created filter\n * @since 1.4.0\n */\nexport async function createFilter(\n  config: FilterConfig,\n  shorthands: ShorthandRegistry,\n): Promise<Filter> {\n  const parsed = parseModuleReference(config.type);\n  const factory = await loadModuleExport(parsed, shorthands, \"filters\");\n\n  if (parsed.isFactory) {\n    if (typeof factory !== \"function\") {\n      throw new ConfigError(\n        `Export ${parsed.exportName} in ${parsed.modulePath} is not a function, but invoked as factory`,\n      );\n    }\n    const options: Record<string, unknown> = { ...config };\n    delete options.type;\n    return (factory as (opts: unknown) => Filter)(options);\n  }\n\n  return factory as Filter;\n}\n"],"mappings":";;;;;;;;;;;;;AAoBA,eAAsB,iBACpBA,QACAC,YACAC,MACkB;AAClB,KAAI,OAAO,aAAa;EACtB,MAAM,WAAW,WAAW;EAC5B,MAAM,WAAW,WAAW,SAAS,OAAO;AAE5C,OAAK,SACH,OAAM,IAAI,aACP,UAAU,KAAK,MAAM,GAAG,GAAG,CAAC,eAAe,OAAO,cAAc;EAIrE,MAAM,iBAAiB,qBAAqB,SAAS;AAKrD,SAAO,iBAAiB,gBAAgB,YAAY,KAAK;CAC1D;AAED,MAAK,OAAO,WACV,OAAM,IAAI,YAAY;CAGxB,IAAIC;AACJ,KAAI;AACF,QAAM,MAAM,OAAO,OAAO;CAC3B,SAAQ,GAAG;AACV,QAAM,IAAI,aACP,wBAAwB,OAAO,WAAW,IAAI,EAAE;CAEpD;CAED,MAAM,aAAa,OAAO,cAAc;CACxC,MAAM,WAAW,IAAI;AAErB,KAAI,oBACF,OAAM,IAAI,aACP,SAAS,OAAO,WAAW,yBAAyB,WAAW;AAIpE,QAAO;AACR;;;;;;;;;AAUD,eAAsB,WACpBC,QACAH,YACe;CACf,MAAM,SAAS,qBAAqB,OAAO,KAAK;CAChD,MAAM,UAAU,MAAM,iBAAiB,QAAQ,YAAY,QAAQ;CAEnE,IAAII;AACJ,KAAI,OAAO,WAAW;AACpB,aAAW,YAAY,WACrB,OAAM,IAAI,aACP,SAAS,OAAO,WAAW,MAAM,OAAO,WAAW;EAKxD,MAAMC,UAAmC,EAAE,GAAG,OAAQ;AACtD,SAAO,QAAQ;AAEf,MAAI,QAAQ,UACV,YAAW,QAAQ,cAAc,UAAU;GACzC,MAAM,YAAY,qBAAqB,QAAQ,UAAU;GACzD,MAAM,aAAa,MAAM,iBACvB,WACA,YACA,aACD;AACD,OAAI,UAAU,WAAW;AACvB,eAAW,eAAe,WACxB,OAAM,IAAI,aACP,YAAY,QAAQ,UAAU;AAGnC,YAAQ,YAAY,AAAC,WAA2C,CAAE,EAAC;GACpE,MACC,SAAQ,YAAY;EAEvB,OAAM;GAEL,MAAM,YAAY,QAAQ;GAC1B,MAAM,YAAY,qBAAqB,UAAU,KAAK;GACtD,MAAM,aAAa,MAAM,iBACvB,WACA,YACA,aACD;AAED,OAAI,UAAU,WAAW;AACvB,eAAW,eAAe,WACxB,OAAM,IAAI,aACP,YAAY,UAAU,KAAK;IAGhC,MAAMC,aAAsC,EAAE,GAAG,UAAW;AAC5D,WAAO,WAAW;AAClB,YAAQ,YAAY,AAAC,WACnB,WACD;GACF,MACC,SAAQ,YAAY;EAEvB;AAGH,SAAO,AAAC,QAAoC,QAAQ;CACrD,MACC,QAAO;AAGT,QAAO;AACR;;;;;;;;;AAUD,eAAsB,aACpBC,QACAP,YACiB;CACjB,MAAM,SAAS,qBAAqB,OAAO,KAAK;CAChD,MAAM,UAAU,MAAM,iBAAiB,QAAQ,YAAY,UAAU;AAErE,KAAI,OAAO,WAAW;AACpB,aAAW,YAAY,WACrB,OAAM,IAAI,aACP,SAAS,OAAO,WAAW,MAAM,OAAO,WAAW;EAGxD,MAAMK,UAAmC,EAAE,GAAG,OAAQ;AACtD,SAAO,QAAQ;AACf,SAAO,AAAC,QAAsC,QAAQ;CACvD;AAED,QAAO;AACR"}

package/dist/mod.cjs

@@ -0,0 +1,9 @@
+const require_types = require('./types.cjs');
+const require_shorthands = require('./shorthands.cjs');
+const require_config = require('./config.cjs');
+const require_env = require('./env.cjs');
+
+exports.ConfigError = require_types.ConfigError;
+exports.DEFAULT_SHORTHANDS = require_shorthands.DEFAULT_SHORTHANDS;
+exports.configureFromObject = require_config.configureFromObject;
+exports.expandEnvVars = require_env.expandEnvVars;

package/dist/mod.d.cts

@@ -0,0 +1,5 @@
+import { ConfigError, ConfigureOptions, EnvExpansionOptions, FilterConfig, FormatterConfig, LogTapeConfig, LoggerConfig, ShorthandRegistry, SinkConfig } from "./types.cjs";
+import { configureFromObject } from "./config.cjs";
+import { expandEnvVars } from "./env.cjs";
+import { DEFAULT_SHORTHANDS } from "./shorthands.cjs";
+export { ConfigError, ConfigureOptions, DEFAULT_SHORTHANDS, EnvExpansionOptions, FilterConfig, FormatterConfig, LogTapeConfig, LoggerConfig, ShorthandRegistry, SinkConfig, configureFromObject, expandEnvVars };

package/dist/mod.d.ts

@@ -0,0 +1,5 @@
+import { ConfigError, ConfigureOptions, EnvExpansionOptions, FilterConfig, FormatterConfig, LogTapeConfig, LoggerConfig, ShorthandRegistry, SinkConfig } from "./types.js";
+import { configureFromObject } from "./config.js";
+import { expandEnvVars } from "./env.js";
+import { DEFAULT_SHORTHANDS } from "./shorthands.js";
+export { ConfigError, ConfigureOptions, DEFAULT_SHORTHANDS, EnvExpansionOptions, FilterConfig, FormatterConfig, LogTapeConfig, LoggerConfig, ShorthandRegistry, SinkConfig, configureFromObject, expandEnvVars };

package/dist/mod.js

@@ -0,0 +1,6 @@
+import { ConfigError } from "./types.js";
+import { DEFAULT_SHORTHANDS } from "./shorthands.js";
+import { configureFromObject } from "./config.js";
+import { expandEnvVars } from "./env.js";
+
+export { ConfigError, DEFAULT_SHORTHANDS, configureFromObject, expandEnvVars };

package/dist/parser.cjs

@@ -0,0 +1,43 @@
+
+//#region src/parser.ts
+/**
+* Parses a module reference string.
+*
+* Formats:
+* - `#shorthand()` - Shorthand with factory
+* - `#shorthand` - Shorthand without factory
+* - `module#export()` - Module with named export factory
+* - `module#export` - Module with named export
+* - `module()` - Module with default export factory
+* - `module` - Module with default export
+*
+* @param reference The module reference string
+* @returns Parsed module reference
+* @since 1.4.0
+*/
+function parseModuleReference(reference) {
+	const isShorthand = reference.startsWith("#");
+	const isFactory = reference.endsWith("()");
+	const cleanRef = isFactory ? reference.slice(0, -2) : reference;
+	if (isShorthand) return {
+		isShorthand: true,
+		shorthandName: cleanRef.slice(1),
+		isFactory
+	};
+	const hashIndex = cleanRef.indexOf("#");
+	if (hashIndex !== -1) return {
+		isShorthand: false,
+		modulePath: cleanRef.slice(0, hashIndex),
+		exportName: cleanRef.slice(hashIndex + 1),
+		isFactory
+	};
+	return {
+		isShorthand: false,
+		modulePath: cleanRef,
+		exportName: "default",
+		isFactory
+	};
+}
+
+//#endregion
+exports.parseModuleReference = parseModuleReference;

package/dist/parser.js

@@ -0,0 +1,43 @@
+//#region src/parser.ts
+/**
+* Parses a module reference string.
+*
+* Formats:
+* - `#shorthand()` - Shorthand with factory
+* - `#shorthand` - Shorthand without factory
+* - `module#export()` - Module with named export factory
+* - `module#export` - Module with named export
+* - `module()` - Module with default export factory
+* - `module` - Module with default export
+*
+* @param reference The module reference string
+* @returns Parsed module reference
+* @since 1.4.0
+*/
+function parseModuleReference(reference) {
+	const isShorthand = reference.startsWith("#");
+	const isFactory = reference.endsWith("()");
+	const cleanRef = isFactory ? reference.slice(0, -2) : reference;
+	if (isShorthand) return {
+		isShorthand: true,
+		shorthandName: cleanRef.slice(1),
+		isFactory
+	};
+	const hashIndex = cleanRef.indexOf("#");
+	if (hashIndex !== -1) return {
+		isShorthand: false,
+		modulePath: cleanRef.slice(0, hashIndex),
+		exportName: cleanRef.slice(hashIndex + 1),
+		isFactory
+	};
+	return {
+		isShorthand: false,
+		modulePath: cleanRef,
+		exportName: "default",
+		isFactory
+	};
+}
+
+//#endregion
+export { parseModuleReference };
+//# sourceMappingURL=parser.js.map

package/dist/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","names":["reference: string"],"sources":["../src/parser.ts"],"sourcesContent":["import type { ParsedModuleReference } from \"./types.ts\";\n\n/**\n * Parses a module reference string.\n *\n * Formats:\n * - `#shorthand()` - Shorthand with factory\n * - `#shorthand` - Shorthand without factory\n * - `module#export()` - Module with named export factory\n * - `module#export` - Module with named export\n * - `module()` - Module with default export factory\n * - `module` - Module with default export\n *\n * @param reference The module reference string\n * @returns Parsed module reference\n * @since 1.4.0\n */\nexport function parseModuleReference(reference: string): ParsedModuleReference {\n  const isShorthand = reference.startsWith(\"#\");\n  const isFactory = reference.endsWith(\"()\");\n  const cleanRef = isFactory ? reference.slice(0, -2) : reference;\n\n  if (isShorthand) {\n    return {\n      isShorthand: true,\n      shorthandName: cleanRef.slice(1),\n      isFactory,\n    };\n  }\n\n  const hashIndex = cleanRef.indexOf(\"#\");\n  if (hashIndex !== -1) {\n    return {\n      isShorthand: false,\n      modulePath: cleanRef.slice(0, hashIndex),\n      exportName: cleanRef.slice(hashIndex + 1),\n      isFactory,\n    };\n  }\n\n  return {\n    isShorthand: false,\n    modulePath: cleanRef,\n    exportName: \"default\",\n    isFactory,\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAiBA,SAAgB,qBAAqBA,WAA0C;CAC7E,MAAM,cAAc,UAAU,WAAW,IAAI;CAC7C,MAAM,YAAY,UAAU,SAAS,KAAK;CAC1C,MAAM,WAAW,YAAY,UAAU,MAAM,GAAG,GAAG,GAAG;AAEtD,KAAI,YACF,QAAO;EACL,aAAa;EACb,eAAe,SAAS,MAAM,EAAE;EAChC;CACD;CAGH,MAAM,YAAY,SAAS,QAAQ,IAAI;AACvC,KAAI,cAAc,GAChB,QAAO;EACL,aAAa;EACb,YAAY,SAAS,MAAM,GAAG,UAAU;EACxC,YAAY,SAAS,MAAM,YAAY,EAAE;EACzC;CACD;AAGH,QAAO;EACL,aAAa;EACb,YAAY;EACZ,YAAY;EACZ;CACD;AACF"}

package/dist/shorthands.cjs

@@ -0,0 +1,46 @@
+
+//#region src/shorthands.ts
+/**
+* Default shorthand mappings for built-in sinks and formatters.
+* @since 1.4.0
+*/
+const DEFAULT_SHORTHANDS = {
+	sinks: {
+		console: "@logtape/logtape#getConsoleSink",
+		stream: "@logtape/logtape#getStreamSink"
+	},
+	filters: {},
+	formatters: {
+		text: "@logtape/logtape#getTextFormatter",
+		ansiColor: "@logtape/logtape#getAnsiColorFormatter",
+		jsonLines: "@logtape/logtape#getJsonLinesFormatter"
+	}
+};
+/**
+* Merges user shorthands with default shorthands.
+* @param defaults Default shorthands
+* @param custom Custom shorthands
+* @returns Merged shorthands
+* @since 1.4.0
+*/
+function mergeShorthands(defaults, custom) {
+	if (!custom) return defaults;
+	return {
+		sinks: {
+			...defaults.sinks,
+			...custom.sinks
+		},
+		filters: {
+			...defaults.filters,
+			...custom.filters
+		},
+		formatters: {
+			...defaults.formatters,
+			...custom.formatters
+		}
+	};
+}
+
+//#endregion
+exports.DEFAULT_SHORTHANDS = DEFAULT_SHORTHANDS;
+exports.mergeShorthands = mergeShorthands;

package/dist/shorthands.d.cts

@@ -0,0 +1,19 @@
+import { ShorthandRegistry } from "./types.cjs";
+
+//#region src/shorthands.d.ts
+
+/**
+ * Default shorthand mappings for built-in sinks and formatters.
+ * @since 1.4.0
+ */
+declare const DEFAULT_SHORTHANDS: ShorthandRegistry;
+/**
+ * Merges user shorthands with default shorthands.
+ * @param defaults Default shorthands
+ * @param custom Custom shorthands
+ * @returns Merged shorthands
+ * @since 1.4.0
+ */
+//#endregion
+export { DEFAULT_SHORTHANDS };
+//# sourceMappingURL=shorthands.d.cts.map

package/dist/shorthands.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shorthands.d.cts","names":[],"sources":["../src/shorthands.ts"],"sourcesContent":[],"mappings":";;;;;;AAMA;;cAAa,oBAAoB"}

package/dist/shorthands.d.ts

@@ -0,0 +1,19 @@
+import { ShorthandRegistry } from "./types.js";
+
+//#region src/shorthands.d.ts
+
+/**
+ * Default shorthand mappings for built-in sinks and formatters.
+ * @since 1.4.0
+ */
+declare const DEFAULT_SHORTHANDS: ShorthandRegistry;
+/**
+ * Merges user shorthands with default shorthands.
+ * @param defaults Default shorthands
+ * @param custom Custom shorthands
+ * @returns Merged shorthands
+ * @since 1.4.0
+ */
+//#endregion
+export { DEFAULT_SHORTHANDS };
+//# sourceMappingURL=shorthands.d.ts.map

package/dist/shorthands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shorthands.d.ts","names":[],"sources":["../src/shorthands.ts"],"sourcesContent":[],"mappings":";;;;;;AAMA;;cAAa,oBAAoB"}

package/dist/shorthands.js

@@ -0,0 +1,45 @@
+//#region src/shorthands.ts
+/**
+* Default shorthand mappings for built-in sinks and formatters.
+* @since 1.4.0
+*/
+const DEFAULT_SHORTHANDS = {
+	sinks: {
+		console: "@logtape/logtape#getConsoleSink",
+		stream: "@logtape/logtape#getStreamSink"
+	},
+	filters: {},
+	formatters: {
+		text: "@logtape/logtape#getTextFormatter",
+		ansiColor: "@logtape/logtape#getAnsiColorFormatter",
+		jsonLines: "@logtape/logtape#getJsonLinesFormatter"
+	}
+};
+/**
+* Merges user shorthands with default shorthands.
+* @param defaults Default shorthands
+* @param custom Custom shorthands
+* @returns Merged shorthands
+* @since 1.4.0
+*/
+function mergeShorthands(defaults, custom) {
+	if (!custom) return defaults;
+	return {
+		sinks: {
+			...defaults.sinks,
+			...custom.sinks
+		},
+		filters: {
+			...defaults.filters,
+			...custom.filters
+		},
+		formatters: {
+			...defaults.formatters,
+			...custom.formatters
+		}
+	};
+}
+
+//#endregion
+export { DEFAULT_SHORTHANDS, mergeShorthands };
+//# sourceMappingURL=shorthands.js.map

package/dist/shorthands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shorthands.js","names":["DEFAULT_SHORTHANDS: ShorthandRegistry","defaults: ShorthandRegistry","custom?: ShorthandRegistry"],"sources":["../src/shorthands.ts"],"sourcesContent":["import type { ShorthandRegistry } from \"./types.ts\";\n\n/**\n * Default shorthand mappings for built-in sinks and formatters.\n * @since 1.4.0\n */\nexport const DEFAULT_SHORTHANDS: ShorthandRegistry = {\n  sinks: {\n    console: \"@logtape/logtape#getConsoleSink\",\n    stream: \"@logtape/logtape#getStreamSink\",\n  },\n  filters: {},\n  formatters: {\n    text: \"@logtape/logtape#getTextFormatter\",\n    ansiColor: \"@logtape/logtape#getAnsiColorFormatter\",\n    jsonLines: \"@logtape/logtape#getJsonLinesFormatter\",\n  },\n};\n\n/**\n * Merges user shorthands with default shorthands.\n * @param defaults Default shorthands\n * @param custom Custom shorthands\n * @returns Merged shorthands\n * @since 1.4.0\n */\nexport function mergeShorthands(\n  defaults: ShorthandRegistry,\n  custom?: ShorthandRegistry,\n): ShorthandRegistry {\n  if (!custom) return defaults;\n\n  return {\n    sinks: { ...defaults.sinks, ...custom.sinks },\n    filters: { ...defaults.filters, ...custom.filters },\n    formatters: { ...defaults.formatters, ...custom.formatters },\n  };\n}\n"],"mappings":";;;;;AAMA,MAAaA,qBAAwC;CACnD,OAAO;EACL,SAAS;EACT,QAAQ;CACT;CACD,SAAS,CAAE;CACX,YAAY;EACV,MAAM;EACN,WAAW;EACX,WAAW;CACZ;AACF;;;;;;;;AASD,SAAgB,gBACdC,UACAC,QACmB;AACnB,MAAK,OAAQ,QAAO;AAEpB,QAAO;EACL,OAAO;GAAE,GAAG,SAAS;GAAO,GAAG,OAAO;EAAO;EAC7C,SAAS;GAAE,GAAG,SAAS;GAAS,GAAG,OAAO;EAAS;EACnD,YAAY;GAAE,GAAG,SAAS;GAAY,GAAG,OAAO;EAAY;CAC7D;AACF"}

package/dist/types.cjs

@@ -0,0 +1,15 @@
+
+//#region src/types.ts
+/**
+* Error thrown when configuration is invalid.
+* @since 1.4.0
+*/
+var ConfigError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "ConfigError";
+	}
+};
+
+//#endregion
+exports.ConfigError = ConfigError;

package/dist/types.d.cts

@@ -0,0 +1,146 @@
+import { LogLevel } from "@logtape/logtape";
+
+//#region src/types.d.ts
+
+/**
+ * Configuration object schema for `configureFromObject()`.
+ * @since 1.4.0
+ */
+interface LogTapeConfig {
+  /**
+   * The sinks to configure.
+   */
+  sinks?: Record<string, SinkConfig>;
+  /**
+   * The filters to configure.
+   */
+  filters?: Record<string, FilterConfig>;
+  /**
+   * The loggers to configure.
+   */
+  loggers?: LoggerConfig[];
+  /**
+   * Whether to reset the configuration before applying this one.
+   */
+  reset?: boolean;
+}
+/**
+ * Sink configuration with module reference.
+ * @since 1.4.0
+ */
+interface SinkConfig {
+  /** Module reference in `module#export()` format */
+  type: string;
+  /** Formatter configuration or shorthand */
+  formatter?: string | FormatterConfig;
+  /** Additional options passed to the factory function */
+  [key: string]: unknown;
+}
+/**
+ * Filter configuration with module reference.
+ * @since 1.4.0
+ */
+interface FilterConfig {
+  /** Module reference in `module#export()` format */
+  type: string;
+  /** Additional options passed to the factory function */
+  [key: string]: unknown;
+}
+/**
+ * Formatter configuration with module reference.
+ * @since 1.4.0
+ */
+interface FormatterConfig {
+  /** Module reference in `module#export()` format */
+  type: string;
+  /** Additional options passed to the factory function */
+  [key: string]: unknown;
+}
+/**
+ * Logger configuration.
+ * @since 1.4.0
+ */
+interface LoggerConfig {
+  /**
+   * The category of the logger.
+   */
+  category: string | string[];
+  /**
+   * The sink identifiers to use.
+   */
+  sinks?: string[];
+  /**
+   * The filter identifiers to use.
+   */
+  filters?: string[];
+  /**
+   * The lowest log level to log.
+   */
+  lowestLevel?: LogLevel;
+  /**
+   * Whether to inherit the parent's sinks.
+   */
+  parentSinks?: "inherit" | "override";
+}
+/**
+ * Registry of shorthand mappings.
+ * @since 1.4.0
+ */
+interface ShorthandRegistry {
+  /**
+   * The shorthand mappings for sinks.
+   */
+  sinks?: Record<string, string>;
+  /**
+   * The shorthand mappings for filters.
+   */
+  filters?: Record<string, string>;
+  /**
+   * The shorthand mappings for formatters.
+   */
+  formatters?: Record<string, string>;
+}
+/**
+ * Options for `configureFromObject()`.
+ * @since 1.4.0
+ */
+interface ConfigureOptions {
+  /**
+   * Custom shorthand mappings to extend or override defaults.
+   */
+  shorthands?: ShorthandRegistry;
+  /**
+   * How to handle invalid configuration entries.
+   *
+   * - `"throw"` (default): Throw `ConfigError` on any invalid configuration.
+   * - `"warn"`: Apply only valid parts and log warnings to meta logger.
+   */
+  onInvalidConfig?: "throw" | "warn";
+}
+/**
+ * Options for environment variable expansion.
+ * @since 1.4.0
+ */
+interface EnvExpansionOptions {
+  /**
+   * Regular expression pattern for matching environment variables.
+   * Default: `/\$\{([^}:]+)(?::([^}]+))?\}/g` (matches `${VAR}` or `${VAR:default}`)
+   */
+  pattern?: RegExp;
+}
+/**
+ * Parsed module reference.
+ * @since 1.4.0
+ */
+
+/**
+ * Error thrown when configuration is invalid.
+ * @since 1.4.0
+ */
+declare class ConfigError extends Error {
+  constructor(message: string);
+}
+//# sourceMappingURL=types.d.ts.map
+//#endregion
+export { ConfigError, ConfigureOptions, EnvExpansionOptions, FilterConfig, FormatterConfig, LogTapeConfig, LoggerConfig, ShorthandRegistry, SinkConfig };
+//# sourceMappingURL=types.d.cts.map

package/dist/types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.cts","names":[],"sources":["../src/types.ts"],"sourcesContent":[],"mappings":";;;;;;AAMA;;AAIyB,UAJR,aAAA,CAIQ;EAAU;;;EAKjB,KAKN,CAAA,EAVF,MAUE,CAAA,MAAA,EAVa,UAUb,CAAA;EAAY;AAYxB;AAaA;EAWiB,OAAA,CAAA,EAzCL,MAyCK,CAAA,MAAe,EAzCL,YAyCK,CAAA;EAWf;AA+BjB;;EAAkC,OAIxB,CAAA,EAlFE,YAkFF,EAAA;EAAM;;AAUK;EAOJ,KAAA,CAAA,EAAA,OAAA;AAmBjB;AA6BA;;;;UAvIiB,UAAA;;;;uBAIM;;;;;;;;UASN,YAAA;;;;;;;;;;UAWA,eAAA;;;;;;;;;;UAWA,YAAA;;;;;;;;;;;;;;;;gBAmBD;;;;;;;;;;UAYC,iBAAA;;;;UAIP;;;;YAKE;;;;eAKG;;;;;;UAOE,gBAAA;;;;eAIF;;;;;;;;;;;;;UAeE,mBAAA;;;;;YAKL;;;;;;;;;;;cAwBC,WAAA,SAAoB,KAAK"}

package/dist/types.d.ts

@@ -0,0 +1,146 @@
+import { LogLevel } from "@logtape/logtape";
+
+//#region src/types.d.ts
+
+/**
+ * Configuration object schema for `configureFromObject()`.
+ * @since 1.4.0
+ */
+interface LogTapeConfig {
+  /**
+   * The sinks to configure.
+   */
+  sinks?: Record<string, SinkConfig>;
+  /**
+   * The filters to configure.
+   */
+  filters?: Record<string, FilterConfig>;
+  /**
+   * The loggers to configure.
+   */
+  loggers?: LoggerConfig[];
+  /**
+   * Whether to reset the configuration before applying this one.
+   */
+  reset?: boolean;
+}
+/**
+ * Sink configuration with module reference.
+ * @since 1.4.0
+ */
+interface SinkConfig {
+  /** Module reference in `module#export()` format */
+  type: string;
+  /** Formatter configuration or shorthand */
+  formatter?: string | FormatterConfig;
+  /** Additional options passed to the factory function */
+  [key: string]: unknown;
+}
+/**
+ * Filter configuration with module reference.
+ * @since 1.4.0
+ */
+interface FilterConfig {
+  /** Module reference in `module#export()` format */
+  type: string;
+  /** Additional options passed to the factory function */
+  [key: string]: unknown;
+}
+/**
+ * Formatter configuration with module reference.
+ * @since 1.4.0
+ */
+interface FormatterConfig {
+  /** Module reference in `module#export()` format */
+  type: string;
+  /** Additional options passed to the factory function */
+  [key: string]: unknown;
+}
+/**
+ * Logger configuration.
+ * @since 1.4.0
+ */
+interface LoggerConfig {
+  /**
+   * The category of the logger.
+   */
+  category: string | string[];
+  /**
+   * The sink identifiers to use.
+   */
+  sinks?: string[];
+  /**
+   * The filter identifiers to use.
+   */
+  filters?: string[];
+  /**
+   * The lowest log level to log.
+   */
+  lowestLevel?: LogLevel;
+  /**
+   * Whether to inherit the parent's sinks.
+   */
+  parentSinks?: "inherit" | "override";
+}
+/**
+ * Registry of shorthand mappings.
+ * @since 1.4.0
+ */
+interface ShorthandRegistry {
+  /**
+   * The shorthand mappings for sinks.
+   */
+  sinks?: Record<string, string>;
+  /**
+   * The shorthand mappings for filters.
+   */
+  filters?: Record<string, string>;
+  /**
+   * The shorthand mappings for formatters.
+   */
+  formatters?: Record<string, string>;
+}
+/**
+ * Options for `configureFromObject()`.
+ * @since 1.4.0
+ */
+interface ConfigureOptions {
+  /**
+   * Custom shorthand mappings to extend or override defaults.
+   */
+  shorthands?: ShorthandRegistry;
+  /**
+   * How to handle invalid configuration entries.
+   *
+   * - `"throw"` (default): Throw `ConfigError` on any invalid configuration.
+   * - `"warn"`: Apply only valid parts and log warnings to meta logger.
+   */
+  onInvalidConfig?: "throw" | "warn";
+}
+/**
+ * Options for environment variable expansion.
+ * @since 1.4.0
+ */
+interface EnvExpansionOptions {
+  /**
+   * Regular expression pattern for matching environment variables.
+   * Default: `/\$\{([^}:]+)(?::([^}]+))?\}/g` (matches `${VAR}` or `${VAR:default}`)
+   */
+  pattern?: RegExp;
+}
+/**
+ * Parsed module reference.
+ * @since 1.4.0
+ */
+
+/**
+ * Error thrown when configuration is invalid.
+ * @since 1.4.0
+ */
+declare class ConfigError extends Error {
+  constructor(message: string);
+}
+//# sourceMappingURL=types.d.ts.map
+//#endregion
+export { ConfigError, ConfigureOptions, EnvExpansionOptions, FilterConfig, FormatterConfig, LogTapeConfig, LoggerConfig, ShorthandRegistry, SinkConfig };
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../src/types.ts"],"sourcesContent":[],"mappings":";;;;;;AAMA;;AAIyB,UAJR,aAAA,CAIQ;EAAU;;;EAKjB,KAKN,CAAA,EAVF,MAUE,CAAA,MAAA,EAVa,UAUb,CAAA;EAAY;AAYxB;AAaA;EAWiB,OAAA,CAAA,EAzCL,MAyCK,CAAA,MAAe,EAzCL,YAyCK,CAAA;EAWf;AA+BjB;;EAAkC,OAIxB,CAAA,EAlFE,YAkFF,EAAA;EAAM;;AAUK;EAOJ,KAAA,CAAA,EAAA,OAAA;AAmBjB;AA6BA;;;;UAvIiB,UAAA;;;;uBAIM;;;;;;;;UASN,YAAA;;;;;;;;;;UAWA,eAAA;;;;;;;;;;UAWA,YAAA;;;;;;;;;;;;;;;;gBAmBD;;;;;;;;;;UAYC,iBAAA;;;;UAIP;;;;YAKE;;;;eAKG;;;;;;UAOE,gBAAA;;;;eAIF;;;;;;;;;;;;;UAeE,mBAAA;;;;;YAKL;;;;;;;;;;;cAwBC,WAAA,SAAoB,KAAK"}

package/dist/types.js

@@ -0,0 +1,15 @@
+//#region src/types.ts
+/**
+* Error thrown when configuration is invalid.
+* @since 1.4.0
+*/
+var ConfigError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "ConfigError";
+	}
+};
+
+//#endregion
+export { ConfigError };
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","names":["message: string"],"sources":["../src/types.ts"],"sourcesContent":["import type { LogLevel } from \"@logtape/logtape\";\n\n/**\n * Configuration object schema for `configureFromObject()`.\n * @since 1.4.0\n */\nexport interface LogTapeConfig {\n  /**\n   * The sinks to configure.\n   */\n  sinks?: Record<string, SinkConfig>;\n\n  /**\n   * The filters to configure.\n   */\n  filters?: Record<string, FilterConfig>;\n\n  /**\n   * The loggers to configure.\n   */\n  loggers?: LoggerConfig[];\n\n  /**\n   * Whether to reset the configuration before applying this one.\n   */\n  reset?: boolean;\n}\n\n/**\n * Sink configuration with module reference.\n * @since 1.4.0\n */\nexport interface SinkConfig {\n  /** Module reference in `module#export()` format */\n  type: string;\n  /** Formatter configuration or shorthand */\n  formatter?: string | FormatterConfig;\n  /** Additional options passed to the factory function */\n  [key: string]: unknown;\n}\n\n/**\n * Filter configuration with module reference.\n * @since 1.4.0\n */\nexport interface FilterConfig {\n  /** Module reference in `module#export()` format */\n  type: string;\n  /** Additional options passed to the factory function */\n  [key: string]: unknown;\n}\n\n/**\n * Formatter configuration with module reference.\n * @since 1.4.0\n */\nexport interface FormatterConfig {\n  /** Module reference in `module#export()` format */\n  type: string;\n  /** Additional options passed to the factory function */\n  [key: string]: unknown;\n}\n\n/**\n * Logger configuration.\n * @since 1.4.0\n */\nexport interface LoggerConfig {\n  /**\n   * The category of the logger.\n   */\n  category: string | string[];\n\n  /**\n   * The sink identifiers to use.\n   */\n  sinks?: string[];\n\n  /**\n   * The filter identifiers to use.\n   */\n  filters?: string[];\n\n  /**\n   * The lowest log level to log.\n   */\n  lowestLevel?: LogLevel;\n\n  /**\n   * Whether to inherit the parent's sinks.\n   */\n  parentSinks?: \"inherit\" | \"override\";\n}\n\n/**\n * Registry of shorthand mappings.\n * @since 1.4.0\n */\nexport interface ShorthandRegistry {\n  /**\n   * The shorthand mappings for sinks.\n   */\n  sinks?: Record<string, string>;\n\n  /**\n   * The shorthand mappings for filters.\n   */\n  filters?: Record<string, string>;\n\n  /**\n   * The shorthand mappings for formatters.\n   */\n  formatters?: Record<string, string>;\n}\n\n/**\n * Options for `configureFromObject()`.\n * @since 1.4.0\n */\nexport interface ConfigureOptions {\n  /**\n   * Custom shorthand mappings to extend or override defaults.\n   */\n  shorthands?: ShorthandRegistry;\n\n  /**\n   * How to handle invalid configuration entries.\n   *\n   * - `\"throw\"` (default): Throw `ConfigError` on any invalid configuration.\n   * - `\"warn\"`: Apply only valid parts and log warnings to meta logger.\n   */\n  onInvalidConfig?: \"throw\" | \"warn\";\n}\n\n/**\n * Options for environment variable expansion.\n * @since 1.4.0\n */\nexport interface EnvExpansionOptions {\n  /**\n   * Regular expression pattern for matching environment variables.\n   * Default: `/\\$\\{([^}:]+)(?::([^}]+))?\\}/g` (matches `${VAR}` or `${VAR:default}`)\n   */\n  pattern?: RegExp;\n}\n\n/**\n * Parsed module reference.\n * @since 1.4.0\n */\nexport interface ParsedModuleReference {\n  /** Whether this is a shorthand (starts with #) */\n  isShorthand: boolean;\n  /** The shorthand name (if isShorthand is true) */\n  shorthandName?: string;\n  /** The module path */\n  modulePath?: string;\n  /** The export name (after #) */\n  exportName?: string;\n  /** Whether this is a factory function (ends with ()) */\n  isFactory: boolean;\n}\n\n/**\n * Error thrown when configuration is invalid.\n * @since 1.4.0\n */\nexport class ConfigError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"ConfigError\";\n  }\n}\n"],"mappings":";;;;;AAuKA,IAAa,cAAb,cAAiC,MAAM;CACrC,YAAYA,SAAiB;AAC3B,QAAM,QAAQ;AACd,OAAK,OAAO;CACb;AACF"}