@logtape/logtape 0.11.0 → 0.12.0-dev.182

package/dist/formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.js","names":["levelAbbreviations: Record<LogLevel, string>","inspect: (value: unknown, options?: { colors?: boolean }) => string","options: TextFormatterOptions","ts: number","level: LogLevel","formatter: (values: FormattedValues) => string","record: LogRecord","values: FormattedValues","defaultTextFormatter: TextFormatter","ansiColors: Record<AnsiColor, string>","ansiStyles: Record<AnsiStyle, string>","defaultLevelColors: Record<LogLevel, AnsiColor | null>","options: AnsiColorFormatterOptions","value: unknown","ansiColorFormatter: TextFormatter","options: JsonLinesFormatterOptions","joinCategory: (category: readonly string[]) => string | readonly string[]","category: readonly string[]","getMessage: TextFormatter","getProperties: (\n    properties: Record<string, unknown>,\n  ) => Record<string, unknown>","result: Record<string, unknown>","jsonLinesFormatter: TextFormatter","logLevelStyles: Record<LogLevel, string>","values: unknown[]"],"sources":["../formatter.ts"],"sourcesContent":["import * as util from \"#util\";\nimport type { LogLevel } from \"./level.ts\";\nimport type { LogRecord } from \"./record.ts\";\n\n/**\n * A text formatter is a function that accepts a log record and returns\n * a string.\n *\n * @param record The log record to format.\n * @returns The formatted log record.\n */\nexport type TextFormatter = (record: LogRecord) => string;\n\n/**\n * The severity level abbreviations.\n */\nconst levelAbbreviations: Record<LogLevel, string> = {\n  \"debug\": \"DBG\",\n  \"info\": \"INF\",\n  \"warning\": \"WRN\",\n  \"error\": \"ERR\",\n  \"fatal\": \"FTL\",\n};\n\n/**\n * A platform-specific inspect function.  In Deno, this is {@link Deno.inspect},\n * and in Node.js/Bun it is `util.inspect()`.  If neither is available, it\n * falls back to {@link JSON.stringify}.\n *\n * @param value The value to inspect.\n * @param options The options for inspecting the value.\n *                If `colors` is `true`, the output will be ANSI-colored.\n * @returns The string representation of the value.\n */\nconst inspect: (value: unknown, options?: { colors?: boolean }) => string =\n  // @ts-ignore: Browser detection\n  // dnt-shim-ignore\n  typeof document !== \"undefined\" ||\n    // @ts-ignore: React Native detection\n    // dnt-shim-ignore\n    typeof navigator !== \"undefined\" && navigator.product === \"ReactNative\"\n    ? (v) => JSON.stringify(v)\n    // @ts-ignore: Deno global\n    // dnt-shim-ignore\n    : \"Deno\" in globalThis && \"inspect\" in globalThis.Deno &&\n        // @ts-ignore: Deno global\n        // dnt-shim-ignore\n        typeof globalThis.Deno.inspect === \"function\"\n    ? (v, opts) =>\n      // @ts-ignore: Deno global\n      // dnt-shim-ignore\n      globalThis.Deno.inspect(v, {\n        strAbbreviateSize: Infinity,\n        iterableLimit: Infinity,\n        ...opts,\n      })\n    // @ts-ignore: Node.js global\n    // dnt-shim-ignore\n    : util != null && \"inspect\" in util && typeof util.inspect === \"function\"\n    ? (v, opts) =>\n      // @ts-ignore: Node.js global\n      // dnt-shim-ignore\n      util.inspect(v, {\n        maxArrayLength: Infinity,\n        maxStringLength: Infinity,\n        ...opts,\n      })\n    : (v) => JSON.stringify(v);\n\n/**\n * The formatted values for a log record.\n * @since 0.6.0\n */\nexport interface FormattedValues {\n  /**\n   * The formatted timestamp.\n   */\n  timestamp: string | null;\n\n  /**\n   * The formatted log level.\n   */\n  level: string;\n\n  /**\n   * The formatted category.\n   */\n  category: string;\n\n  /**\n   * The formatted message.\n   */\n  message: string;\n\n  /**\n   * The unformatted log record.\n   */\n  record: LogRecord;\n}\n\n/**\n * The various options for the built-in text formatters.\n * @since 0.6.0\n */\nexport interface TextFormatterOptions {\n  /**\n   * The timestamp format.  This can be one of the following:\n   *\n   * - `\"date-time-timezone\"`: The date and time with the full timezone offset\n   *   (e.g., `\"2023-11-14 22:13:20.000 +00:00\"`).\n   * - `\"date-time-tz\"`: The date and time with the short timezone offset\n   *   (e.g., `\"2023-11-14 22:13:20.000 +00\"`).\n   * - `\"date-time\"`: The date and time without the timezone offset\n   *   (e.g., `\"2023-11-14 22:13:20.000\"`).\n   * - `\"time-timezone\"`: The time with the full timezone offset but without\n   *   the date (e.g., `\"22:13:20.000 +00:00\"`).\n   * - `\"time-tz\"`: The time with the short timezone offset but without the date\n   *   (e.g., `\"22:13:20.000 +00\"`).\n   * - `\"time\"`: The time without the date or timezone offset\n   *   (e.g., `\"22:13:20.000\"`).\n   * - `\"date\"`: The date without the time or timezone offset\n   *   (e.g., `\"2023-11-14\"`).\n   * - `\"rfc3339\"`: The date and time in RFC 3339 format\n   *   (e.g., `\"2023-11-14T22:13:20.000Z\"`).\n   * - `\"none\"` or `\"disabled\"`: No display\n   *\n   * Alternatively, this can be a function that accepts a timestamp and returns\n   * a string.\n   *\n   * The default is `\"date-time-timezone\"`.\n   */\n  timestamp?:\n    | \"date-time-timezone\"\n    | \"date-time-tz\"\n    | \"date-time\"\n    | \"time-timezone\"\n    | \"time-tz\"\n    | \"time\"\n    | \"date\"\n    | \"rfc3339\"\n    | \"none\"\n    | \"disabled\"\n    | ((ts: number) => string | null);\n\n  /**\n   * The log level format.  This can be one of the following:\n   *\n   * - `\"ABBR\"`: The log level abbreviation in uppercase (e.g., `\"INF\"`).\n   * - `\"FULL\"`: The full log level name in uppercase (e.g., `\"INFO\"`).\n   * - `\"L\"`: The first letter of the log level in uppercase (e.g., `\"I\"`).\n   * - `\"abbr\"`: The log level abbreviation in lowercase (e.g., `\"inf\"`).\n   * - `\"full\"`: The full log level name in lowercase (e.g., `\"info\"`).\n   * - `\"l\"`: The first letter of the log level in lowercase (e.g., `\"i\"`).\n   *\n   * Alternatively, this can be a function that accepts a log level and returns\n   * a string.\n   *\n   * The default is `\"ABBR\"`.\n   */\n  level?:\n    | \"ABBR\"\n    | \"FULL\"\n    | \"L\"\n    | \"abbr\"\n    | \"full\"\n    | \"l\"\n    | ((level: LogLevel) => string);\n\n  /**\n   * The separator between category names.  For example, if the separator is\n   * `\"·\"`, the category `[\"a\", \"b\", \"c\"]` will be formatted as `\"a·b·c\"`.\n   * The default separator is `\"·\"`.\n   *\n   * If this is a function, it will be called with the category array and\n   * should return a string, which will be used for rendering the category.\n   */\n  category?: string | ((category: readonly string[]) => string);\n\n  /**\n   * The format of the embedded values.\n   *\n   * A function that renders a value to a string.  This function is used to\n   * render the values in the log record.  The default is [`util.inspect()`] in\n   * Node.js/Bun and [`Deno.inspect()`] in Deno.\n   *\n   * [`util.inspect()`]: https://nodejs.org/api/util.html#utilinspectobject-options\n   * [`Deno.inspect()`]: https://docs.deno.com/api/deno/~/Deno.inspect\n   * @param value The value to render.\n   * @returns The string representation of the value.\n   */\n  value?: (value: unknown) => string;\n\n  /**\n   * How those formatted parts are concatenated.\n   *\n   * A function that formats the log record.  This function is called with the\n   * formatted values and should return a string.  Note that the formatted\n   * *should not* include a newline character at the end.\n   *\n   * By default, this is a function that formats the log record as follows:\n   *\n   * ```\n   * 2023-11-14 22:13:20.000 +00:00 [INF] category·subcategory: Hello, world!\n   * ```\n   * @param values The formatted values.\n   * @returns The formatted log record.\n   */\n  format?: (values: FormattedValues) => string;\n}\n\n/**\n * Get a text formatter with the specified options.  Although it's flexible\n * enough to create a custom formatter, if you want more control, you can\n * create a custom formatter that satisfies the {@link TextFormatter} type\n * instead.\n *\n * For more information on the options, see {@link TextFormatterOptions}.\n *\n * By default, the formatter formats log records as follows:\n *\n * ```\n * 2023-11-14 22:13:20.000 +00:00 [INF] category·subcategory: Hello, world!\n * ```\n * @param options The options for the text formatter.\n * @returns The text formatter.\n * @since 0.6.0\n */\nexport function getTextFormatter(\n  options: TextFormatterOptions = {},\n): TextFormatter {\n  const timestampRenderer =\n    options.timestamp == null || options.timestamp === \"date-time-timezone\"\n      ? (ts: number): string =>\n        new Date(ts).toISOString().replace(\"T\", \" \").replace(\"Z\", \" +00:00\")\n      : options.timestamp === \"date-time-tz\"\n      ? (ts: number): string =>\n        new Date(ts).toISOString().replace(\"T\", \" \").replace(\"Z\", \" +00\")\n      : options.timestamp === \"date-time\"\n      ? (ts: number): string =>\n        new Date(ts).toISOString().replace(\"T\", \" \").replace(\"Z\", \"\")\n      : options.timestamp === \"time-timezone\"\n      ? (ts: number): string =>\n        new Date(ts).toISOString().replace(/.*T/, \"\").replace(\"Z\", \" +00:00\")\n      : options.timestamp === \"time-tz\"\n      ? (ts: number): string =>\n        new Date(ts).toISOString().replace(/.*T/, \"\").replace(\"Z\", \" +00\")\n      : options.timestamp === \"time\"\n      ? (ts: number): string =>\n        new Date(ts).toISOString().replace(/.*T/, \"\").replace(\"Z\", \"\")\n      : options.timestamp === \"date\"\n      ? (ts: number): string => new Date(ts).toISOString().replace(/T.*/, \"\")\n      : options.timestamp === \"rfc3339\"\n      ? (ts: number): string => new Date(ts).toISOString()\n      : options.timestamp === \"none\" || options.timestamp === \"disabled\"\n      ? () => null\n      : options.timestamp;\n  const categorySeparator = options.category ?? \"·\";\n  const valueRenderer = options.value ?? inspect;\n  const levelRenderer = options.level == null || options.level === \"ABBR\"\n    ? (level: LogLevel): string => levelAbbreviations[level]\n    : options.level === \"abbr\"\n    ? (level: LogLevel): string => levelAbbreviations[level].toLowerCase()\n    : options.level === \"FULL\"\n    ? (level: LogLevel): string => level.toUpperCase()\n    : options.level === \"full\"\n    ? (level: LogLevel): string => level\n    : options.level === \"L\"\n    ? (level: LogLevel): string => level.charAt(0).toUpperCase()\n    : options.level === \"l\"\n    ? (level: LogLevel): string => level.charAt(0)\n    : options.level;\n  const formatter: (values: FormattedValues) => string = options.format ??\n    (({ timestamp, level, category, message }: FormattedValues) =>\n      `${timestamp ? `${timestamp} ` : \"\"}[${level}] ${category}: ${message}`);\n  return (record: LogRecord): string => {\n    let message = \"\";\n    for (let i = 0; i < record.message.length; i++) {\n      if (i % 2 === 0) message += record.message[i];\n      else message += valueRenderer(record.message[i]);\n    }\n    const timestamp = timestampRenderer(record.timestamp);\n    const level = levelRenderer(record.level);\n    const category = typeof categorySeparator === \"function\"\n      ? categorySeparator(record.category)\n      : record.category.join(categorySeparator);\n    const values: FormattedValues = {\n      timestamp,\n      level,\n      category,\n      message,\n      record,\n    };\n    return `${formatter(values)}\\n`;\n  };\n}\n\n/**\n * The default text formatter.  This formatter formats log records as follows:\n *\n * ```\n * 2023-11-14 22:13:20.000 +00:00 [INF] category·subcategory: Hello, world!\n * ```\n *\n * @param record The log record to format.\n * @returns The formatted log record.\n */\nexport const defaultTextFormatter: TextFormatter = getTextFormatter();\n\nconst RESET = \"\\x1b[0m\";\n\n/**\n * The ANSI colors.  These can be used to colorize text in the console.\n * @since 0.6.0\n */\nexport type AnsiColor =\n  | \"black\"\n  | \"red\"\n  | \"green\"\n  | \"yellow\"\n  | \"blue\"\n  | \"magenta\"\n  | \"cyan\"\n  | \"white\";\n\nconst ansiColors: Record<AnsiColor, string> = {\n  black: \"\\x1b[30m\",\n  red: \"\\x1b[31m\",\n  green: \"\\x1b[32m\",\n  yellow: \"\\x1b[33m\",\n  blue: \"\\x1b[34m\",\n  magenta: \"\\x1b[35m\",\n  cyan: \"\\x1b[36m\",\n  white: \"\\x1b[37m\",\n};\n\n/**\n * The ANSI text styles.\n * @since 0.6.0\n */\nexport type AnsiStyle =\n  | \"bold\"\n  | \"dim\"\n  | \"italic\"\n  | \"underline\"\n  | \"strikethrough\";\n\nconst ansiStyles: Record<AnsiStyle, string> = {\n  bold: \"\\x1b[1m\",\n  dim: \"\\x1b[2m\",\n  italic: \"\\x1b[3m\",\n  underline: \"\\x1b[4m\",\n  strikethrough: \"\\x1b[9m\",\n};\n\nconst defaultLevelColors: Record<LogLevel, AnsiColor | null> = {\n  debug: \"blue\",\n  info: \"green\",\n  warning: \"yellow\",\n  error: \"red\",\n  fatal: \"magenta\",\n};\n\n/**\n * The various options for the ANSI color formatter.\n * @since 0.6.0\n */\nexport interface AnsiColorFormatterOptions extends TextFormatterOptions {\n  /**\n   * The timestamp format.  This can be one of the following:\n   *\n   * - `\"date-time-timezone\"`: The date and time with the full timezone offset\n   *   (e.g., `\"2023-11-14 22:13:20.000 +00:00\"`).\n   * - `\"date-time-tz\"`: The date and time with the short timezone offset\n   *   (e.g., `\"2023-11-14 22:13:20.000 +00\"`).\n   * - `\"date-time\"`: The date and time without the timezone offset\n   *   (e.g., `\"2023-11-14 22:13:20.000\"`).\n   * - `\"time-timezone\"`: The time with the full timezone offset but without\n   *   the date (e.g., `\"22:13:20.000 +00:00\"`).\n   * - `\"time-tz\"`: The time with the short timezone offset but without the date\n   *   (e.g., `\"22:13:20.000 +00\"`).\n   * - `\"time\"`: The time without the date or timezone offset\n   *   (e.g., `\"22:13:20.000\"`).\n   * - `\"date\"`: The date without the time or timezone offset\n   *   (e.g., `\"2023-11-14\"`).\n   * - `\"rfc3339\"`: The date and time in RFC 3339 format\n   *   (e.g., `\"2023-11-14T22:13:20.000Z\"`).\n   *\n   * Alternatively, this can be a function that accepts a timestamp and returns\n   * a string.\n   *\n   * The default is `\"date-time-tz\"`.\n   */\n  timestamp?:\n    | \"date-time-timezone\"\n    | \"date-time-tz\"\n    | \"date-time\"\n    | \"time-timezone\"\n    | \"time-tz\"\n    | \"time\"\n    | \"date\"\n    | \"rfc3339\"\n    | ((ts: number) => string);\n\n  /**\n   * The ANSI style for the timestamp.  `\"dim\"` is used by default.\n   */\n  timestampStyle?: AnsiStyle | null;\n\n  /**\n   * The ANSI color for the timestamp.  No color is used by default.\n   */\n  timestampColor?: AnsiColor | null;\n\n  /**\n   * The ANSI style for the log level.  `\"bold\"` is used by default.\n   */\n  levelStyle?: AnsiStyle | null;\n\n  /**\n   * The ANSI colors for the log levels.  The default colors are as follows:\n   *\n   * - `\"debug\"`: `\"blue\"`\n   * - `\"info\"`: `\"green\"`\n   * - `\"warning\"`: `\"yellow\"`\n   * - `\"error\"`: `\"red\"`\n   * - `\"fatal\"`: `\"magenta\"`\n   */\n  levelColors?: Record<LogLevel, AnsiColor | null>;\n\n  /**\n   * The ANSI style for the category.  `\"dim\"` is used by default.\n   */\n  categoryStyle?: AnsiStyle | null;\n\n  /**\n   * The ANSI color for the category.  No color is used by default.\n   */\n  categoryColor?: AnsiColor | null;\n}\n\n/**\n * Get an ANSI color formatter with the specified options.\n *\n * ![A preview of an ANSI color formatter.](https://i.imgur.com/I8LlBUf.png)\n * @param option The options for the ANSI color formatter.\n * @returns The ANSI color formatter.\n * @since 0.6.0\n */\nexport function getAnsiColorFormatter(\n  options: AnsiColorFormatterOptions = {},\n): TextFormatter {\n  const format = options.format;\n  const timestampStyle = typeof options.timestampStyle === \"undefined\"\n    ? \"dim\"\n    : options.timestampStyle;\n  const timestampColor = options.timestampColor ?? null;\n  const timestampPrefix = `${\n    timestampStyle == null ? \"\" : ansiStyles[timestampStyle]\n  }${timestampColor == null ? \"\" : ansiColors[timestampColor]}`;\n  const timestampSuffix = timestampStyle == null && timestampColor == null\n    ? \"\"\n    : RESET;\n  const levelStyle = typeof options.levelStyle === \"undefined\"\n    ? \"bold\"\n    : options.levelStyle;\n  const levelColors = options.levelColors ?? defaultLevelColors;\n  const categoryStyle = typeof options.categoryStyle === \"undefined\"\n    ? \"dim\"\n    : options.categoryStyle;\n  const categoryColor = options.categoryColor ?? null;\n  const categoryPrefix = `${\n    categoryStyle == null ? \"\" : ansiStyles[categoryStyle]\n  }${categoryColor == null ? \"\" : ansiColors[categoryColor]}`;\n  const categorySuffix = categoryStyle == null && categoryColor == null\n    ? \"\"\n    : RESET;\n  return getTextFormatter({\n    timestamp: \"date-time-tz\",\n    value(value: unknown): string {\n      return inspect(value, { colors: true });\n    },\n    ...options,\n    format({ timestamp, level, category, message, record }): string {\n      const levelColor = levelColors[record.level];\n      timestamp = `${timestampPrefix}${timestamp}${timestampSuffix}`;\n      level = `${levelStyle == null ? \"\" : ansiStyles[levelStyle]}${\n        levelColor == null ? \"\" : ansiColors[levelColor]\n      }${level}${levelStyle == null && levelColor == null ? \"\" : RESET}`;\n      return format == null\n        ? `${timestamp} ${level} ${categoryPrefix}${category}:${categorySuffix} ${message}`\n        : format({\n          timestamp,\n          level,\n          category: `${categoryPrefix}${category}${categorySuffix}`,\n          message,\n          record,\n        });\n    },\n  });\n}\n\n/**\n * A text formatter that uses ANSI colors to format log records.\n *\n * ![A preview of ansiColorFormatter.](https://i.imgur.com/I8LlBUf.png)\n *\n * @param record The log record to format.\n * @returns The formatted log record.\n * @since 0.5.0\n */\nexport const ansiColorFormatter: TextFormatter = getAnsiColorFormatter();\n\n/**\n * Options for the {@link getJsonLinesFormatter} function.\n * @since 0.11.0\n */\nexport interface JsonLinesFormatterOptions {\n  /**\n   * The separator between category names.  For example, if the separator is\n   * `\".\"`, the category `[\"a\", \"b\", \"c\"]` will be formatted as `\"a.b.c\"`.\n   * If this is a function, it will be called with the category array and\n   * should return a string or an array of strings, which will be used\n   * for rendering the category.\n   *\n   * @default `\".\"`\n   */\n  readonly categorySeparator?:\n    | string\n    | ((category: readonly string[]) => string | readonly string[]);\n\n  /**\n   * The message format.  This can be one of the following:\n   *\n   * - `\"template\"`: The raw message template is used as the message.\n   * - `\"rendered\"`: The message is rendered with the values.\n   *\n   * @default `\"rendered\"`\n   */\n  readonly message?: \"template\" | \"rendered\";\n\n  /**\n   * The properties format.  This can be one of the following:\n   *\n   * - `\"flatten\"`: The properties are flattened into the root object.\n   * - `\"prepend:<prefix>\"`: The properties are prepended with the given prefix\n   *   (e.g., `\"prepend:ctx_\"` will prepend `ctx_` to each property key).\n   * - `\"nest:<key>\"`: The properties are nested under the given key\n   *   (e.g., `\"nest:properties\"` will nest the properties under the\n   *   `properties` key).\n   *\n   * @default `\"nest:properties\"`\n   */\n  readonly properties?: \"flatten\" | `prepend:${string}` | `nest:${string}`;\n}\n\n/**\n * Get a [JSON Lines] formatter with the specified options.  The log records\n * will be rendered as JSON objects, one per line, which is a common format\n * for log files.  This format is also known as Newline-Delimited JSON (NDJSON).\n * It looks like this:\n *\n * ```json\n * {\"@timestamp\":\"2023-11-14T22:13:20.000Z\",\"level\":\"INFO\",\"message\":\"Hello, world!\",\"logger\":\"my.logger\",\"properties\":{\"key\":\"value\"}}\n * ```\n *\n * [JSON Lines]: https://jsonlines.org/\n * @param options The options for the JSON Lines formatter.\n * @returns The JSON Lines formatter.\n * @since 0.11.0\n */\nexport function getJsonLinesFormatter(\n  options: JsonLinesFormatterOptions = {},\n): TextFormatter {\n  let joinCategory: (category: readonly string[]) => string | readonly string[];\n  if (typeof options.categorySeparator === \"function\") {\n    joinCategory = options.categorySeparator;\n  } else {\n    const separator = options.categorySeparator ?? \".\";\n    joinCategory = (category: readonly string[]): string =>\n      category.join(separator);\n  }\n\n  let getMessage: TextFormatter;\n  if (options.message === \"template\") {\n    getMessage = (record: LogRecord): string => {\n      if (typeof record.rawMessage === \"string\") {\n        return record.rawMessage;\n      }\n      let msg = \"\";\n      for (let i = 0; i < record.rawMessage.length; i++) {\n        msg += i % 2 < 1 ? record.rawMessage[i] : \"{}\";\n      }\n      return msg;\n    };\n  } else {\n    getMessage = (record: LogRecord): string => {\n      let msg = \"\";\n      for (let i = 0; i < record.message.length; i++) {\n        msg += i % 2 < 1\n          ? record.message[i]\n          : JSON.stringify(record.message[i]);\n      }\n      return msg;\n    };\n  }\n\n  const propertiesOption = options.properties ?? \"nest:properties\";\n  let getProperties: (\n    properties: Record<string, unknown>,\n  ) => Record<string, unknown>;\n  if (propertiesOption === \"flatten\") {\n    getProperties = (properties) => properties;\n  } else if (propertiesOption.startsWith(\"prepend:\")) {\n    const prefix = propertiesOption.substring(8);\n    if (prefix === \"\") {\n      throw new TypeError(\n        `Invalid properties option: ${\n          JSON.stringify(propertiesOption)\n        }. It must be of the form \"prepend:<prefix>\" where <prefix> is a non-empty string.`,\n      );\n    }\n    getProperties = (properties) => {\n      const result: Record<string, unknown> = {};\n      for (const key in properties) {\n        result[`${prefix}${key}`] = properties[key];\n      }\n      return result;\n    };\n  } else if (propertiesOption.startsWith(\"nest:\")) {\n    const key = propertiesOption.substring(5);\n    getProperties = (properties) => ({ [key]: properties });\n  } else {\n    throw new TypeError(\n      `Invalid properties option: ${\n        JSON.stringify(propertiesOption)\n      }. It must be \"flatten\", \"prepend:<prefix>\", or \"nest:<key>\".`,\n    );\n  }\n\n  return (record: LogRecord): string => {\n    return JSON.stringify({\n      \"@timestamp\": new Date(record.timestamp).toISOString(),\n      level: record.level === \"warning\" ? \"WARN\" : record.level.toUpperCase(),\n      message: getMessage(record),\n      logger: joinCategory(record.category),\n      ...getProperties(record.properties),\n    });\n  };\n}\n\n/**\n * The default [JSON Lines] formatter.  This formatter formats log records\n * as JSON objects, one per line, which is a common format for log files.\n * It looks like this:\n *\n * ```json\n * {\"@timestamp\":\"2023-11-14T22:13:20.000Z\",\"level\":\"INFO\",\"message\":\"Hello, world!\",\"logger\":\"my.logger\",\"properties\":{\"key\":\"value\"}}\n * ```\n *\n * You can customize the output by passing options to\n * {@link getJsonLinesFormatter}.  For example, you can change the category\n * separator, the message format, and how the properties are formatted.\n *\n * [JSON Lines]: https://jsonlines.org/\n * @since 0.11.0\n */\nexport const jsonLinesFormatter: TextFormatter = getJsonLinesFormatter();\n\n/**\n * A console formatter is a function that accepts a log record and returns\n * an array of arguments to pass to {@link console.log}.\n *\n * @param record The log record to format.\n * @returns The formatted log record, as an array of arguments for\n *          {@link console.log}.\n */\nexport type ConsoleFormatter = (record: LogRecord) => readonly unknown[];\n\n/**\n * The styles for the log level in the console.\n */\nconst logLevelStyles: Record<LogLevel, string> = {\n  \"debug\": \"background-color: gray; color: white;\",\n  \"info\": \"background-color: white; color: black;\",\n  \"warning\": \"background-color: orange; color: black;\",\n  \"error\": \"background-color: red; color: white;\",\n  \"fatal\": \"background-color: maroon; color: white;\",\n};\n\n/**\n * The default console formatter.\n *\n * @param record The log record to format.\n * @returns The formatted log record, as an array of arguments for\n *          {@link console.log}.\n */\nexport function defaultConsoleFormatter(record: LogRecord): readonly unknown[] {\n  let msg = \"\";\n  const values: unknown[] = [];\n  for (let i = 0; i < record.message.length; i++) {\n    if (i % 2 === 0) msg += record.message[i];\n    else {\n      msg += \"%o\";\n      values.push(record.message[i]);\n    }\n  }\n  const date = new Date(record.timestamp);\n  const time = `${date.getUTCHours().toString().padStart(2, \"0\")}:${\n    date.getUTCMinutes().toString().padStart(2, \"0\")\n  }:${date.getUTCSeconds().toString().padStart(2, \"0\")}.${\n    date.getUTCMilliseconds().toString().padStart(3, \"0\")\n  }`;\n  return [\n    `%c${time} %c${levelAbbreviations[record.level]}%c %c${\n      record.category.join(\"\\xb7\")\n    } %c${msg}`,\n    \"color: gray;\",\n    logLevelStyles[record.level],\n    \"background-color: default;\",\n    \"color: gray;\",\n    \"color: default;\",\n    ...values,\n  ];\n}\n"],"mappings":"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"}

package/dist/level.cjs

@@ -0,0 +1,64 @@
+
+//#region level.ts
+const logLevels = [
+	"debug",
+	"info",
+	"warning",
+	"error",
+	"fatal"
+];
+/**
+* Parses a log level from a string.
+*
+* @param level The log level as a string.  This is case-insensitive.
+* @returns The log level.
+* @throws {TypeError} If the log level is invalid.
+*/
+function parseLogLevel(level) {
+	level = level.toLowerCase();
+	switch (level) {
+		case "debug":
+		case "info":
+		case "warning":
+		case "error":
+		case "fatal": return level;
+		default: throw new TypeError(`Invalid log level: ${level}.`);
+	}
+}
+/**
+* Checks if a string is a valid log level.  This function can be used as
+* as a type guard to narrow the type of a string to a {@link LogLevel}.
+*
+* @param level The log level as a string.  This is case-sensitive.
+* @returns `true` if the string is a valid log level.
+*/
+function isLogLevel(level) {
+	switch (level) {
+		case "debug":
+		case "info":
+		case "warning":
+		case "error":
+		case "fatal": return true;
+		default: return false;
+	}
+}
+/**
+* Compares two log levels.
+* @param a The first log level.
+* @param b The second log level.
+* @returns A negative number if `a` is less than `b`, a positive number if `a`
+*          is greater than `b`, or zero if they are equal.
+* @since 0.8.0
+*/
+function compareLogLevel(a, b) {
+	const aIndex = logLevels.indexOf(a);
+	if (aIndex < 0) throw new TypeError(`Invalid log level: ${JSON.stringify(a)}.`);
+	const bIndex = logLevels.indexOf(b);
+	if (bIndex < 0) throw new TypeError(`Invalid log level: ${JSON.stringify(b)}.`);
+	return aIndex - bIndex;
+}
+
+//#endregion
+exports.compareLogLevel = compareLogLevel;
+exports.isLogLevel = isLogLevel;
+exports.parseLogLevel = parseLogLevel;

package/dist/level.d.cts

@@ -0,0 +1,34 @@
+//#region level.d.ts
+declare const logLevels: readonly ["debug", "info", "warning", "error", "fatal"];
+/**
+ * The severity level of a {@link LogRecord}.
+ */
+type LogLevel = typeof logLevels[number];
+/**
+ * Parses a log level from a string.
+ *
+ * @param level The log level as a string.  This is case-insensitive.
+ * @returns The log level.
+ * @throws {TypeError} If the log level is invalid.
+ */
+declare function parseLogLevel(level: string): LogLevel;
+/**
+ * Checks if a string is a valid log level.  This function can be used as
+ * as a type guard to narrow the type of a string to a {@link LogLevel}.
+ *
+ * @param level The log level as a string.  This is case-sensitive.
+ * @returns `true` if the string is a valid log level.
+ */
+declare function isLogLevel(level: string): level is LogLevel;
+/**
+ * Compares two log levels.
+ * @param a The first log level.
+ * @param b The second log level.
+ * @returns A negative number if `a` is less than `b`, a positive number if `a`
+ *          is greater than `b`, or zero if they are equal.
+ * @since 0.8.0
+ */
+declare function compareLogLevel(a: LogLevel, b: LogLevel): number;
+//#endregion
+export { LogLevel, compareLogLevel, isLogLevel, parseLogLevel };
+//# sourceMappingURL=level.d.cts.map

package/dist/level.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"level.d.cts","names":[],"sources":["../level.ts"],"sourcesContent":[],"mappings":";cAAM;;AAKN;AASA;AAqBgB,KA9BJ,QAAA,GA8Bc,OA9BI,SA8B8B,CAAA,MAAA,CAAA;AAqB5D;;;;AAAwD;;;iBA1CxC,aAAA,iBAA8B;;;;;;;;iBAqB9B,UAAA,0BAAoC;;;;;;;;;iBAqBpC,eAAA,IAAmB,aAAa"}

package/{types → dist}/level.d.ts

@@ -1,8 +1,9 @@
+//#region level.d.ts
 declare const logLevels: readonly ["debug", "info", "warning", "error", "fatal"];
 /**
  * The severity level of a {@link LogRecord}.
  */
-export type LogLevel = typeof logLevels[number];
+type LogLevel = typeof logLevels[number];
 /**
  * Parses a log level from a string.
  *
@@ -10,7 +11,7 @@ export type LogLevel = typeof logLevels[number];
  * @returns The log level.
  * @throws {TypeError} If the log level is invalid.
  */
-export declare function parseLogLevel(level: string): LogLevel;
+declare function parseLogLevel(level: string): LogLevel;
 /**
  * Checks if a string is a valid log level.  This function can be used as
  * as a type guard to narrow the type of a string to a {@link LogLevel}.
@@ -18,7 +19,7 @@ export declare function parseLogLevel(level: string): LogLevel;
  * @param level The log level as a string.  This is case-sensitive.
  * @returns `true` if the string is a valid log level.
  */
-export declare function isLogLevel(level: string): level is LogLevel;
+declare function isLogLevel(level: string): level is LogLevel;
 /**
  * Compares two log levels.
  * @param a The first log level.
@@ -27,6 +28,7 @@ export declare function isLogLevel(level: string): level is LogLevel;
  *          is greater than `b`, or zero if they are equal.
  * @since 0.8.0
  */
-export declare function compareLogLevel(a: LogLevel, b: LogLevel): number;
-export {};
+declare function compareLogLevel(a: LogLevel, b: LogLevel): number;
+//#endregion
+export { LogLevel, compareLogLevel, isLogLevel, parseLogLevel };
 //# sourceMappingURL=level.d.ts.map

package/dist/level.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"level.d.ts","names":[],"sources":["../level.ts"],"sourcesContent":[],"mappings":";cAAM;;AAKN;AASA;AAqBgB,KA9BJ,QAAA,GA8Bc,OA9BI,SA8B8B,CAAA,MAAA,CAAA;AAqB5D;;;;AAAwD;;;iBA1CxC,aAAA,iBAA8B;;;;;;;;iBAqB9B,UAAA,0BAAoC;;;;;;;;;iBAqBpC,eAAA,IAAmB,aAAa"}

package/dist/level.js

@@ -0,0 +1,62 @@
+//#region level.ts
+const logLevels = [
+	"debug",
+	"info",
+	"warning",
+	"error",
+	"fatal"
+];
+/**
+* Parses a log level from a string.
+*
+* @param level The log level as a string.  This is case-insensitive.
+* @returns The log level.
+* @throws {TypeError} If the log level is invalid.
+*/
+function parseLogLevel(level) {
+	level = level.toLowerCase();
+	switch (level) {
+		case "debug":
+		case "info":
+		case "warning":
+		case "error":
+		case "fatal": return level;
+		default: throw new TypeError(`Invalid log level: ${level}.`);
+	}
+}
+/**
+* Checks if a string is a valid log level.  This function can be used as
+* as a type guard to narrow the type of a string to a {@link LogLevel}.
+*
+* @param level The log level as a string.  This is case-sensitive.
+* @returns `true` if the string is a valid log level.
+*/
+function isLogLevel(level) {
+	switch (level) {
+		case "debug":
+		case "info":
+		case "warning":
+		case "error":
+		case "fatal": return true;
+		default: return false;
+	}
+}
+/**
+* Compares two log levels.
+* @param a The first log level.
+* @param b The second log level.
+* @returns A negative number if `a` is less than `b`, a positive number if `a`
+*          is greater than `b`, or zero if they are equal.
+* @since 0.8.0
+*/
+function compareLogLevel(a, b) {
+	const aIndex = logLevels.indexOf(a);
+	if (aIndex < 0) throw new TypeError(`Invalid log level: ${JSON.stringify(a)}.`);
+	const bIndex = logLevels.indexOf(b);
+	if (bIndex < 0) throw new TypeError(`Invalid log level: ${JSON.stringify(b)}.`);
+	return aIndex - bIndex;
+}
+
+//#endregion
+export { compareLogLevel, isLogLevel, parseLogLevel };
+//# sourceMappingURL=level.js.map

package/dist/level.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"level.js","names":["level: string","a: LogLevel","b: LogLevel"],"sources":["../level.ts"],"sourcesContent":["const logLevels = [\"debug\", \"info\", \"warning\", \"error\", \"fatal\"] as const;\n\n/**\n * The severity level of a {@link LogRecord}.\n */\nexport type LogLevel = typeof logLevels[number];\n\n/**\n * Parses a log level from a string.\n *\n * @param level The log level as a string.  This is case-insensitive.\n * @returns The log level.\n * @throws {TypeError} If the log level is invalid.\n */\nexport function parseLogLevel(level: string): LogLevel {\n  level = level.toLowerCase();\n  switch (level) {\n    case \"debug\":\n    case \"info\":\n    case \"warning\":\n    case \"error\":\n    case \"fatal\":\n      return level;\n    default:\n      throw new TypeError(`Invalid log level: ${level}.`);\n  }\n}\n\n/**\n * Checks if a string is a valid log level.  This function can be used as\n * as a type guard to narrow the type of a string to a {@link LogLevel}.\n *\n * @param level The log level as a string.  This is case-sensitive.\n * @returns `true` if the string is a valid log level.\n */\nexport function isLogLevel(level: string): level is LogLevel {\n  switch (level) {\n    case \"debug\":\n    case \"info\":\n    case \"warning\":\n    case \"error\":\n    case \"fatal\":\n      return true;\n    default:\n      return false;\n  }\n}\n\n/**\n * Compares two log levels.\n * @param a The first log level.\n * @param b The second log level.\n * @returns A negative number if `a` is less than `b`, a positive number if `a`\n *          is greater than `b`, or zero if they are equal.\n * @since 0.8.0\n */\nexport function compareLogLevel(a: LogLevel, b: LogLevel): number {\n  const aIndex = logLevels.indexOf(a);\n  if (aIndex < 0) {\n    throw new TypeError(`Invalid log level: ${JSON.stringify(a)}.`);\n  }\n  const bIndex = logLevels.indexOf(b);\n  if (bIndex < 0) {\n    throw new TypeError(`Invalid log level: ${JSON.stringify(b)}.`);\n  }\n  return aIndex - bIndex;\n}\n"],"mappings":";AAAA,MAAM,YAAY;CAAC;CAAS;CAAQ;CAAW;CAAS;AAAQ;;;;;;;;AAchE,SAAgB,cAAcA,OAAyB;AACrD,SAAQ,MAAM,aAAa;AAC3B,SAAQ,OAAR;EACE,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK,QACH,QAAO;EACT,QACE,OAAM,IAAI,WAAW,qBAAqB,MAAM;CACnD;AACF;;;;;;;;AASD,SAAgB,WAAWA,OAAkC;AAC3D,SAAQ,OAAR;EACE,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK;EACL,KAAK,QACH,QAAO;EACT,QACE,QAAO;CACV;AACF;;;;;;;;;AAUD,SAAgB,gBAAgBC,GAAaC,GAAqB;CAChE,MAAM,SAAS,UAAU,QAAQ,EAAE;AACnC,KAAI,SAAS,EACX,OAAM,IAAI,WAAW,qBAAqB,KAAK,UAAU,EAAE,CAAC;CAE9D,MAAM,SAAS,UAAU,QAAQ,EAAE;AACnC,KAAI,SAAS,EACX,OAAM,IAAI,WAAW,qBAAqB,KAAK,UAAU,EAAE,CAAC;AAE9D,QAAO,SAAS;AACjB"}

package/dist/logger.cjs

@@ -0,0 +1,351 @@
+const require_level = require('./level.cjs');
+
+//#region logger.ts
+/**
+* Get a logger with the given category.
+*
+* ```typescript
+* const logger = getLogger(["my-app"]);
+* ```
+*
+* @param category The category of the logger.  It can be a string or an array
+*                 of strings.  If it is a string, it is equivalent to an array
+*                 with a single element.
+* @returns The logger.
+*/
+function getLogger(category = []) {
+	return LoggerImpl.getLogger(category);
+}
+/**
+* The symbol for the global root logger.
+*/
+const globalRootLoggerSymbol = Symbol.for("logtape.rootLogger");
+/**
+* A logger implementation.  Do not use this directly; use {@link getLogger}
+* instead.  This class is exported for testing purposes.
+*/
+var LoggerImpl = class LoggerImpl {
+	parent;
+	children;
+	category;
+	sinks;
+	parentSinks = "inherit";
+	filters;
+	lowestLevel = "debug";
+	contextLocalStorage;
+	static getLogger(category = []) {
+		let rootLogger = globalRootLoggerSymbol in globalThis ? globalThis[globalRootLoggerSymbol] ?? null : null;
+		if (rootLogger == null) {
+			rootLogger = new LoggerImpl(null, []);
+			globalThis[globalRootLoggerSymbol] = rootLogger;
+		}
+		if (typeof category === "string") return rootLogger.getChild(category);
+		if (category.length === 0) return rootLogger;
+		return rootLogger.getChild(category);
+	}
+	constructor(parent, category) {
+		this.parent = parent;
+		this.children = {};
+		this.category = category;
+		this.sinks = [];
+		this.filters = [];
+	}
+	getChild(subcategory) {
+		const name = typeof subcategory === "string" ? subcategory : subcategory[0];
+		const childRef = this.children[name];
+		let child = childRef instanceof LoggerImpl ? childRef : childRef?.deref();
+		if (child == null) {
+			child = new LoggerImpl(this, [...this.category, name]);
+			this.children[name] = "WeakRef" in globalThis ? new WeakRef(child) : child;
+		}
+		if (typeof subcategory === "string" || subcategory.length === 1) return child;
+		return child.getChild(subcategory.slice(1));
+	}
+	/**
+	* Reset the logger.  This removes all sinks and filters from the logger.
+	*/
+	reset() {
+		while (this.sinks.length > 0) this.sinks.shift();
+		this.parentSinks = "inherit";
+		while (this.filters.length > 0) this.filters.shift();
+		this.lowestLevel = "debug";
+	}
+	/**
+	* Reset the logger and all its descendants.  This removes all sinks and
+	* filters from the logger and all its descendants.
+	*/
+	resetDescendants() {
+		for (const child of Object.values(this.children)) {
+			const logger = child instanceof LoggerImpl ? child : child.deref();
+			if (logger != null) logger.resetDescendants();
+		}
+		this.reset();
+	}
+	with(properties) {
+		return new LoggerCtx(this, { ...properties });
+	}
+	filter(record) {
+		for (const filter of this.filters) if (!filter(record)) return false;
+		if (this.filters.length < 1) return this.parent?.filter(record) ?? true;
+		return true;
+	}
+	*getSinks(level) {
+		if (this.lowestLevel === null || require_level.compareLogLevel(level, this.lowestLevel) < 0) return;
+		if (this.parent != null && this.parentSinks === "inherit") for (const sink of this.parent.getSinks(level)) yield sink;
+		for (const sink of this.sinks) yield sink;
+	}
+	emit(record, bypassSinks) {
+		if (this.lowestLevel === null || require_level.compareLogLevel(record.level, this.lowestLevel) < 0 || !this.filter(record)) return;
+		for (const sink of this.getSinks(record.level)) {
+			if (bypassSinks?.has(sink)) continue;
+			try {
+				sink(record);
+			} catch (error) {
+				const bypassSinks2 = new Set(bypassSinks);
+				bypassSinks2.add(sink);
+				metaLogger.log("fatal", "Failed to emit a log record to sink {sink}: {error}", {
+					sink,
+					error,
+					record
+				}, bypassSinks2);
+			}
+		}
+	}
+	log(level, rawMessage, properties, bypassSinks) {
+		const implicitContext = LoggerImpl.getLogger().contextLocalStorage?.getStore() ?? {};
+		let cachedProps = void 0;
+		const record = typeof properties === "function" ? {
+			category: this.category,
+			level,
+			timestamp: Date.now(),
+			get message() {
+				return parseMessageTemplate(rawMessage, this.properties);
+			},
+			rawMessage,
+			get properties() {
+				if (cachedProps == null) cachedProps = {
+					...implicitContext,
+					...properties()
+				};
+				return cachedProps;
+			}
+		} : {
+			category: this.category,
+			level,
+			timestamp: Date.now(),
+			message: parseMessageTemplate(rawMessage, {
+				...implicitContext,
+				...properties
+			}),
+			rawMessage,
+			properties: {
+				...implicitContext,
+				...properties
+			}
+		};
+		this.emit(record, bypassSinks);
+	}
+	logLazily(level, callback, properties = {}) {
+		const implicitContext = LoggerImpl.getLogger().contextLocalStorage?.getStore() ?? {};
+		let rawMessage = void 0;
+		let msg = void 0;
+		function realizeMessage() {
+			if (msg == null || rawMessage == null) {
+				msg = callback((tpl, ...values) => {
+					rawMessage = tpl;
+					return renderMessage(tpl, values);
+				});
+				if (rawMessage == null) throw new TypeError("No log record was made.");
+			}
+			return [msg, rawMessage];
+		}
+		this.emit({
+			category: this.category,
+			level,
+			get message() {
+				return realizeMessage()[0];
+			},
+			get rawMessage() {
+				return realizeMessage()[1];
+			},
+			timestamp: Date.now(),
+			properties: {
+				...implicitContext,
+				...properties
+			}
+		});
+	}
+	logTemplate(level, messageTemplate, values, properties = {}) {
+		const implicitContext = LoggerImpl.getLogger().contextLocalStorage?.getStore() ?? {};
+		this.emit({
+			category: this.category,
+			level,
+			message: renderMessage(messageTemplate, values),
+			rawMessage: messageTemplate,
+			timestamp: Date.now(),
+			properties: {
+				...implicitContext,
+				...properties
+			}
+		});
+	}
+	debug(message, ...values) {
+		if (typeof message === "string") this.log("debug", message, values[0] ?? {});
+		else if (typeof message === "function") this.logLazily("debug", message);
+		else if (!Array.isArray(message)) this.log("debug", "{*}", message);
+		else this.logTemplate("debug", message, values);
+	}
+	info(message, ...values) {
+		if (typeof message === "string") this.log("info", message, values[0] ?? {});
+		else if (typeof message === "function") this.logLazily("info", message);
+		else if (!Array.isArray(message)) this.log("info", "{*}", message);
+		else this.logTemplate("info", message, values);
+	}
+	warn(message, ...values) {
+		if (typeof message === "string") this.log("warning", message, values[0] ?? {});
+		else if (typeof message === "function") this.logLazily("warning", message);
+		else if (!Array.isArray(message)) this.log("warning", "{*}", message);
+		else this.logTemplate("warning", message, values);
+	}
+	error(message, ...values) {
+		if (typeof message === "string") this.log("error", message, values[0] ?? {});
+		else if (typeof message === "function") this.logLazily("error", message);
+		else if (!Array.isArray(message)) this.log("error", "{*}", message);
+		else this.logTemplate("error", message, values);
+	}
+	fatal(message, ...values) {
+		if (typeof message === "string") this.log("fatal", message, values[0] ?? {});
+		else if (typeof message === "function") this.logLazily("fatal", message);
+		else if (!Array.isArray(message)) this.log("fatal", "{*}", message);
+		else this.logTemplate("fatal", message, values);
+	}
+};
+/**
+* A logger implementation with contextual properties.  Do not use this
+* directly; use {@link Logger.with} instead.  This class is exported
+* for testing purposes.
+*/
+var LoggerCtx = class LoggerCtx {
+	logger;
+	properties;
+	constructor(logger, properties) {
+		this.logger = logger;
+		this.properties = properties;
+	}
+	get category() {
+		return this.logger.category;
+	}
+	get parent() {
+		return this.logger.parent;
+	}
+	getChild(subcategory) {
+		return this.logger.getChild(subcategory).with(this.properties);
+	}
+	with(properties) {
+		return new LoggerCtx(this.logger, {
+			...this.properties,
+			...properties
+		});
+	}
+	log(level, message, properties, bypassSinks) {
+		this.logger.log(level, message, typeof properties === "function" ? () => ({
+			...this.properties,
+			...properties()
+		}) : {
+			...this.properties,
+			...properties
+		}, bypassSinks);
+	}
+	logLazily(level, callback) {
+		this.logger.logLazily(level, callback, this.properties);
+	}
+	logTemplate(level, messageTemplate, values) {
+		this.logger.logTemplate(level, messageTemplate, values, this.properties);
+	}
+	debug(message, ...values) {
+		if (typeof message === "string") this.log("debug", message, values[0] ?? {});
+		else if (typeof message === "function") this.logLazily("debug", message);
+		else if (!Array.isArray(message)) this.log("debug", "{*}", message);
+		else this.logTemplate("debug", message, values);
+	}
+	info(message, ...values) {
+		if (typeof message === "string") this.log("info", message, values[0] ?? {});
+		else if (typeof message === "function") this.logLazily("info", message);
+		else if (!Array.isArray(message)) this.log("info", "{*}", message);
+		else this.logTemplate("info", message, values);
+	}
+	warn(message, ...values) {
+		if (typeof message === "string") this.log("warning", message, values[0] ?? {});
+		else if (typeof message === "function") this.logLazily("warning", message);
+		else if (!Array.isArray(message)) this.log("warning", "{*}", message);
+		else this.logTemplate("warning", message, values);
+	}
+	error(message, ...values) {
+		if (typeof message === "string") this.log("error", message, values[0] ?? {});
+		else if (typeof message === "function") this.logLazily("error", message);
+		else if (!Array.isArray(message)) this.log("error", "{*}", message);
+		else this.logTemplate("error", message, values);
+	}
+	fatal(message, ...values) {
+		if (typeof message === "string") this.log("fatal", message, values[0] ?? {});
+		else if (typeof message === "function") this.logLazily("fatal", message);
+		else if (!Array.isArray(message)) this.log("fatal", "{*}", message);
+		else this.logTemplate("fatal", message, values);
+	}
+};
+/**
+* The meta logger.  It is a logger with the category `["logtape", "meta"]`.
+*/
+const metaLogger = LoggerImpl.getLogger(["logtape", "meta"]);
+/**
+* Parse a message template into a message template array and a values array.
+* @param template The message template.
+* @param properties The values to replace placeholders with.
+* @returns The message template array and the values array.
+*/
+function parseMessageTemplate(template, properties) {
+	const message = [];
+	let part = "";
+	for (let i = 0; i < template.length; i++) {
+		const char = template.charAt(i);
+		const nextChar = template.charAt(i + 1);
+		if (char === "{" && nextChar === "{") {
+			part = part + char;
+			i++;
+		} else if (char === "}" && nextChar === "}") {
+			part = part + char;
+			i++;
+		} else if (char === "{") {
+			message.push(part);
+			part = "";
+		} else if (char === "}") {
+			let prop;
+			if (part.match(/^\s*\*\s*$/)) prop = part in properties ? properties[part] : "*" in properties ? properties["*"] : properties;
+			else if (part.match(/^\s|\s$/)) prop = part in properties ? properties[part] : properties[part.trim()];
+			else prop = properties[part];
+			message.push(prop);
+			part = "";
+		} else part = part + char;
+	}
+	message.push(part);
+	return message;
+}
+/**
+* Render a message template with values.
+* @param template The message template.
+* @param values The message template values.
+* @returns The message template values interleaved between the substitution
+*          values.
+*/
+function renderMessage(template, values) {
+	const args = [];
+	for (let i = 0; i < template.length; i++) {
+		args.push(template[i]);
+		if (i < values.length) args.push(values[i]);
+	}
+	return args;
+}
+
+//#endregion
+exports.LoggerImpl = LoggerImpl;
+exports.getLogger = getLogger;