@holz/ansi-terminal-backend 0.0.0

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## Unreleased

package/dist/holz-ansi-terminal-backend.js

@@ -0,0 +1,59 @@
+var t = /* @__PURE__ */ ((r) => (r.Error = "error", r.Warn = "warn", r.Info = "info", r.Debug = "debug", r))(t || {});
+function e(r) {
+  return `\x1B[${r}`;
+}
+const s = {
+  black: e("30m"),
+  red: e("31m"),
+  green: e("32m"),
+  yellow: e("33m"),
+  blue: e("34m"),
+  magenta: e("35m"),
+  cyan: e("36m"),
+  white: e("37m")
+}, n = {
+  reset: e("0m"),
+  bold: e("1m"),
+  dim: e("2m")
+};
+class u {
+  constructor(o = {}) {
+    this.console = o.console ?? console;
+  }
+  processLog(o) {
+    const l = [
+      {
+        include: !0,
+        command: "%s",
+        content: i[o.level]
+      },
+      {
+        include: !0,
+        command: "%s",
+        content: o.message
+      },
+      {
+        include: o.origin.length > 0,
+        command: "%s",
+        content: `${n.dim}${o.origin.join(":")}${n.reset}`
+      },
+      {
+        include: Object.keys(o.context).length > 0,
+        command: "%O",
+        content: o.context
+      }
+    ].filter((c) => c.include), m = l.map((c) => c.command).join(" "), a = l.map((c) => c.content), d = o.level === t.Error ? "error" : "log";
+    this.console[d](m, ...a);
+  }
+}
+const i = {
+  [t.Debug]: `${n.bold}${s.cyan}debug${n.reset}`,
+  [t.Info]: `${n.bold}${s.green}info${n.reset} `,
+  [t.Warn]: `${n.bold}${s.yellow}warn${n.reset} `,
+  [t.Error]: `${n.bold}${s.red}error${n.reset}`
+};
+export {
+  u as AnsiTerminalBackend,
+  u as default
+};
+//# sourceMappingURL=holz-ansi-terminal-backend.js.map

package/dist/holz-ansi-terminal-backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"holz-ansi-terminal-backend.js","sources":["../../holz-core/dist/holz-core.js","../src/ansi-codes.ts","../src/ansi-terminal-backend.ts"],"sourcesContent":["var t = /* @__PURE__ */ ((s) => (s.Error = \"error\", s.Warn = \"warn\", s.Info = \"info\", s.Debug = \"debug\", s))(t || {});\nclass e {\n  constructor(r, o) {\n    this.processor = r, this.origin = o;\n  }\n  static create(r) {\n    return new e(r, []);\n  }\n  /** Extend the logger to attach a class or module name to logs. */\n  namespace(r) {\n    return new e(this.processor, this.origin.concat(r));\n  }\n  /** Log a frequent and verbose progress update. */\n  debug(r, o) {\n    this.forwardLog(t.Debug, r, o);\n  }\n  /** Log a high-level progress update. */\n  info(r, o) {\n    this.forwardLog(t.Info, r, o);\n  }\n  /** Log something concerning. */\n  warn(r, o) {\n    this.forwardLog(t.Warn, r, o);\n  }\n  /** Log a critical failure. */\n  error(r, o) {\n    this.forwardLog(t.Error, r, o);\n  }\n  forwardLog(r, o, c = {}) {\n    this.processor.processLog({\n      message: o,\n      level: r,\n      origin: this.origin,\n      context: c\n    });\n  }\n}\nconst a = e.create;\nclass i {\n  constructor(r) {\n    this.processors = r;\n  }\n  processLog(r) {\n    this.processors.forEach((o) => {\n      o.processLog(r);\n    });\n  }\n}\nfunction h(s) {\n  return new i(s);\n}\nclass n {\n  constructor(r, o) {\n    this.predicate = r, this.processor = o;\n  }\n  processLog(r) {\n    this.predicate(r) && this.processor.processLog(r);\n  }\n}\nfunction g(s, r) {\n  return new n(s, r);\n}\nexport {\n  t as LogLevel,\n  h as combine,\n  a as createLogger,\n  g as filter\n};\n//# sourceMappingURL=holz-core.js.map\n","function ansiCode(code: string) {\n  return `\\x1b[${code}`;\n}\n\n/**\n * Unix only. This will break for win32 terminals and may spew garbage on\n * terminals without 4-bit color support.\n *\n * TODO: Strip colors on non-interactive TTYs.\n */\n\nexport const color = {\n  black: ansiCode('30m'),\n  red: ansiCode('31m'),\n  green: ansiCode('32m'),\n  yellow: ansiCode('33m'),\n  blue: ansiCode('34m'),\n  magenta: ansiCode('35m'),\n  cyan: ansiCode('36m'),\n  white: ansiCode('37m'),\n};\n\nexport const code = {\n  reset: ansiCode('0m'),\n  bold: ansiCode('1m'),\n  dim: ansiCode('2m'),\n};\n","import type { Log, LogProcessor } from '@holz/core';\nimport { LogLevel } from '@holz/core';\nimport { color, code } from './ansi-codes';\n\n/**\n * A backend that prints logs to a 3-bit ansi terminal. This should work on\n * most Unix systems and Windows >= 10.\n *\n * NOTE: This is not smart enough to detect if the output is a TTY or if it\n * supports colors, nor is this the appropriate place to check. Without color\n * ques, the printed text is much less understandable. It is better to check\n * when constructing the logger instead.\n */\nexport default class AnsiTerminalBackend implements LogProcessor {\n  private console: MinimalConsole;\n\n  constructor(options: Options = {}) {\n    this.console = options.console ?? console;\n  }\n\n  processLog(log: Log) {\n    const segments = [\n      {\n        include: true,\n        command: '%s',\n        content: logLevelLabel[log.level],\n      },\n      {\n        include: true,\n        command: '%s',\n        content: log.message,\n      },\n      {\n        include: log.origin.length > 0,\n        command: '%s',\n        content: `${code.dim}${log.origin.join(':')}${code.reset}`,\n      },\n      {\n        include: Object.keys(log.context).length > 0,\n        command: '%O',\n        content: log.context,\n      },\n    ].filter((segment) => segment.include);\n\n    const command = segments.map((segment) => segment.command).join(' ');\n    const values = segments.map((segment) => segment.content);\n\n    // Errors should always use stderr.\n    const channel: keyof MinimalConsole =\n      log.level === LogLevel.Error ? 'error' : 'log';\n\n    this.console[channel](command, ...values);\n  }\n}\n\nconst logLevelLabel: Record<LogLevel, string> = {\n  [LogLevel.Debug]: `${code.bold}${color.cyan}debug${code.reset}`,\n  [LogLevel.Info]: `${code.bold}${color.green}info${code.reset} `,\n  [LogLevel.Warn]: `${code.bold}${color.yellow}warn${code.reset} `,\n  [LogLevel.Error]: `${code.bold}${color.red}error${code.reset}`,\n};\n\ninterface Options {\n  console?: MinimalConsole;\n}\n\n/**\n * A subset of the Console interface. Must support printf-style interpolation.\n */\nexport interface MinimalConsole {\n  /** Log to stdout. */\n  log: Console['log'];\n\n  /** Log to stderr. */\n  error: Console['error'];\n}\n"],"names":["s","ansiCode","code","color","AnsiTerminalBackend","options","log","segments","logLevelLabel","segment","command","values","channel","LogLevel"],"mappings":"AAAA,IAAI,IAAqB,kBAACA,OAAOA,EAAE,QAAQ,SAASA,EAAE,OAAO,QAAQA,EAAE,OAAO,QAAQA,EAAE,QAAQ,SAASA,IAAI,KAAK,EAAE;ACApH,SAASC,EAASC,GAAc;AAC9B,SAAO,QAAQA;AACjB;AASO,MAAMC,IAAQ;AAAA,EACnB,OAAOF,EAAS,KAAK;AAAA,EACrB,KAAKA,EAAS,KAAK;AAAA,EACnB,OAAOA,EAAS,KAAK;AAAA,EACrB,QAAQA,EAAS,KAAK;AAAA,EACtB,MAAMA,EAAS,KAAK;AAAA,EACpB,SAASA,EAAS,KAAK;AAAA,EACvB,MAAMA,EAAS,KAAK;AAAA,EACpB,OAAOA,EAAS,KAAK;AACvB,GAEaC,IAAO;AAAA,EAClB,OAAOD,EAAS,IAAI;AAAA,EACpB,MAAMA,EAAS,IAAI;AAAA,EACnB,KAAKA,EAAS,IAAI;AACpB;ACbA,MAAqBG,EAA4C;AAAA,EAG/D,YAAYC,IAAmB,IAAI;AAC5B,SAAA,UAAUA,EAAQ,WAAW;AAAA,EACpC;AAAA,EAEA,WAAWC,GAAU;AACnB,UAAMC,IAAW;AAAA,MACf;AAAA,QACE,SAAS;AAAA,QACT,SAAS;AAAA,QACT,SAASC,EAAcF,EAAI,KAAK;AAAA,MAClC;AAAA,MACA;AAAA,QACE,SAAS;AAAA,QACT,SAAS;AAAA,QACT,SAASA,EAAI;AAAA,MACf;AAAA,MACA;AAAA,QACE,SAASA,EAAI,OAAO,SAAS;AAAA,QAC7B,SAAS;AAAA,QACT,SAAS,GAAGJ,EAAK,MAAMI,EAAI,OAAO,KAAK,GAAG,IAAIJ,EAAK;AAAA,MACrD;AAAA,MACA;AAAA,QACE,SAAS,OAAO,KAAKI,EAAI,OAAO,EAAE,SAAS;AAAA,QAC3C,SAAS;AAAA,QACT,SAASA,EAAI;AAAA,MACf;AAAA,IACA,EAAA,OAAO,CAACG,MAAYA,EAAQ,OAAO,GAE/BC,IAAUH,EAAS,IAAI,CAACE,MAAYA,EAAQ,OAAO,EAAE,KAAK,GAAG,GAC7DE,IAASJ,EAAS,IAAI,CAACE,MAAYA,EAAQ,OAAO,GAGlDG,IACJN,EAAI,UAAUO,EAAS,QAAQ,UAAU;AAE3C,SAAK,QAAQD,CAAO,EAAEF,GAAS,GAAGC,CAAM;AAAA,EAC1C;AACF;AAEA,MAAMH,IAA0C;AAAA,EAC9C,CAACK,EAAS,KAAK,GAAG,GAAGX,EAAK,OAAOC,EAAM,YAAYD,EAAK;AAAA,EACxD,CAACW,EAAS,IAAI,GAAG,GAAGX,EAAK,OAAOC,EAAM,YAAYD,EAAK;AAAA,EACvD,CAACW,EAAS,IAAI,GAAG,GAAGX,EAAK,OAAOC,EAAM,aAAaD,EAAK;AAAA,EACxD,CAACW,EAAS,KAAK,GAAG,GAAGX,EAAK,OAAOC,EAAM,WAAWD,EAAK;AACzD;"}

package/dist/holz-ansi-terminal-backend.umd.cjs

@@ -0,0 +1,2 @@
+(function(c,n){typeof exports=="object"&&typeof module<"u"?n(exports):typeof define=="function"&&define.amd?define(["exports"],n):(c=typeof globalThis<"u"?globalThis:c||self,n(c["holz-ansi-terminal-backend"]={}))})(this,function(c){"use strict";var n=(r=>(r.Error="error",r.Warn="warn",r.Info="info",r.Debug="debug",r))(n||{});function e(r){return`\x1B[${r}`}const s={black:e("30m"),red:e("31m"),green:e("32m"),yellow:e("33m"),blue:e("34m"),magenta:e("35m"),cyan:e("36m"),white:e("37m")},o={reset:e("0m"),bold:e("1m"),dim:e("2m")};class l{constructor(t={}){this.console=t.console??console}processLog(t){const d=[{include:!0,command:"%s",content:m[t.level]},{include:!0,command:"%s",content:t.message},{include:t.origin.length>0,command:"%s",content:`${o.dim}${t.origin.join(":")}${o.reset}`},{include:Object.keys(t.context).length>0,command:"%O",content:t.context}].filter(i=>i.include),a=d.map(i=>i.command).join(" "),u=d.map(i=>i.content),f=t.level===n.Error?"error":"log";this.console[f](a,...u)}}const m={[n.Debug]:`${o.bold}${s.cyan}debug${o.reset}`,[n.Info]:`${o.bold}${s.green}info${o.reset} `,[n.Warn]:`${o.bold}${s.yellow}warn${o.reset} `,[n.Error]:`${o.bold}${s.red}error${o.reset}`};c.AnsiTerminalBackend=l,c.default=l,Object.defineProperties(c,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}})});
+//# sourceMappingURL=holz-ansi-terminal-backend.umd.cjs.map

package/dist/holz-ansi-terminal-backend.umd.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"holz-ansi-terminal-backend.umd.cjs","sources":["../../holz-core/dist/holz-core.js","../src/ansi-codes.ts","../src/ansi-terminal-backend.ts"],"sourcesContent":["var t = /* @__PURE__ */ ((s) => (s.Error = \"error\", s.Warn = \"warn\", s.Info = \"info\", s.Debug = \"debug\", s))(t || {});\nclass e {\n  constructor(r, o) {\n    this.processor = r, this.origin = o;\n  }\n  static create(r) {\n    return new e(r, []);\n  }\n  /** Extend the logger to attach a class or module name to logs. */\n  namespace(r) {\n    return new e(this.processor, this.origin.concat(r));\n  }\n  /** Log a frequent and verbose progress update. */\n  debug(r, o) {\n    this.forwardLog(t.Debug, r, o);\n  }\n  /** Log a high-level progress update. */\n  info(r, o) {\n    this.forwardLog(t.Info, r, o);\n  }\n  /** Log something concerning. */\n  warn(r, o) {\n    this.forwardLog(t.Warn, r, o);\n  }\n  /** Log a critical failure. */\n  error(r, o) {\n    this.forwardLog(t.Error, r, o);\n  }\n  forwardLog(r, o, c = {}) {\n    this.processor.processLog({\n      message: o,\n      level: r,\n      origin: this.origin,\n      context: c\n    });\n  }\n}\nconst a = e.create;\nclass i {\n  constructor(r) {\n    this.processors = r;\n  }\n  processLog(r) {\n    this.processors.forEach((o) => {\n      o.processLog(r);\n    });\n  }\n}\nfunction h(s) {\n  return new i(s);\n}\nclass n {\n  constructor(r, o) {\n    this.predicate = r, this.processor = o;\n  }\n  processLog(r) {\n    this.predicate(r) && this.processor.processLog(r);\n  }\n}\nfunction g(s, r) {\n  return new n(s, r);\n}\nexport {\n  t as LogLevel,\n  h as combine,\n  a as createLogger,\n  g as filter\n};\n//# sourceMappingURL=holz-core.js.map\n","function ansiCode(code: string) {\n  return `\\x1b[${code}`;\n}\n\n/**\n * Unix only. This will break for win32 terminals and may spew garbage on\n * terminals without 4-bit color support.\n *\n * TODO: Strip colors on non-interactive TTYs.\n */\n\nexport const color = {\n  black: ansiCode('30m'),\n  red: ansiCode('31m'),\n  green: ansiCode('32m'),\n  yellow: ansiCode('33m'),\n  blue: ansiCode('34m'),\n  magenta: ansiCode('35m'),\n  cyan: ansiCode('36m'),\n  white: ansiCode('37m'),\n};\n\nexport const code = {\n  reset: ansiCode('0m'),\n  bold: ansiCode('1m'),\n  dim: ansiCode('2m'),\n};\n","import type { Log, LogProcessor } from '@holz/core';\nimport { LogLevel } from '@holz/core';\nimport { color, code } from './ansi-codes';\n\n/**\n * A backend that prints logs to a 3-bit ansi terminal. This should work on\n * most Unix systems and Windows >= 10.\n *\n * NOTE: This is not smart enough to detect if the output is a TTY or if it\n * supports colors, nor is this the appropriate place to check. Without color\n * ques, the printed text is much less understandable. It is better to check\n * when constructing the logger instead.\n */\nexport default class AnsiTerminalBackend implements LogProcessor {\n  private console: MinimalConsole;\n\n  constructor(options: Options = {}) {\n    this.console = options.console ?? console;\n  }\n\n  processLog(log: Log) {\n    const segments = [\n      {\n        include: true,\n        command: '%s',\n        content: logLevelLabel[log.level],\n      },\n      {\n        include: true,\n        command: '%s',\n        content: log.message,\n      },\n      {\n        include: log.origin.length > 0,\n        command: '%s',\n        content: `${code.dim}${log.origin.join(':')}${code.reset}`,\n      },\n      {\n        include: Object.keys(log.context).length > 0,\n        command: '%O',\n        content: log.context,\n      },\n    ].filter((segment) => segment.include);\n\n    const command = segments.map((segment) => segment.command).join(' ');\n    const values = segments.map((segment) => segment.content);\n\n    // Errors should always use stderr.\n    const channel: keyof MinimalConsole =\n      log.level === LogLevel.Error ? 'error' : 'log';\n\n    this.console[channel](command, ...values);\n  }\n}\n\nconst logLevelLabel: Record<LogLevel, string> = {\n  [LogLevel.Debug]: `${code.bold}${color.cyan}debug${code.reset}`,\n  [LogLevel.Info]: `${code.bold}${color.green}info${code.reset} `,\n  [LogLevel.Warn]: `${code.bold}${color.yellow}warn${code.reset} `,\n  [LogLevel.Error]: `${code.bold}${color.red}error${code.reset}`,\n};\n\ninterface Options {\n  console?: MinimalConsole;\n}\n\n/**\n * A subset of the Console interface. Must support printf-style interpolation.\n */\nexport interface MinimalConsole {\n  /** Log to stdout. */\n  log: Console['log'];\n\n  /** Log to stderr. */\n  error: Console['error'];\n}\n"],"names":["t","s","ansiCode","code","color","AnsiTerminalBackend","options","log","segments","logLevelLabel","segment","command","values","channel","LogLevel"],"mappings":"qPAAA,IAAIA,GAAsBC,IAAOA,EAAE,MAAQ,QAASA,EAAE,KAAO,OAAQA,EAAE,KAAO,OAAQA,EAAE,MAAQ,QAASA,IAAID,GAAK,EAAE,ECApH,SAASE,EAASC,EAAc,CAC9B,MAAO,QAAQA,GACjB,CASO,MAAMC,EAAQ,CACnB,MAAOF,EAAS,KAAK,EACrB,IAAKA,EAAS,KAAK,EACnB,MAAOA,EAAS,KAAK,EACrB,OAAQA,EAAS,KAAK,EACtB,KAAMA,EAAS,KAAK,EACpB,QAASA,EAAS,KAAK,EACvB,KAAMA,EAAS,KAAK,EACpB,MAAOA,EAAS,KAAK,CACvB,EAEaC,EAAO,CAClB,MAAOD,EAAS,IAAI,EACpB,KAAMA,EAAS,IAAI,EACnB,IAAKA,EAAS,IAAI,CACpB,ECbA,MAAqBG,CAA4C,CAG/D,YAAYC,EAAmB,GAAI,CAC5B,KAAA,QAAUA,EAAQ,SAAW,OACpC,CAEA,WAAWC,EAAU,CACnB,MAAMC,EAAW,CACf,CACE,QAAS,GACT,QAAS,KACT,QAASC,EAAcF,EAAI,KAAK,CAClC,EACA,CACE,QAAS,GACT,QAAS,KACT,QAASA,EAAI,OACf,EACA,CACE,QAASA,EAAI,OAAO,OAAS,EAC7B,QAAS,KACT,QAAS,GAAGJ,EAAK,MAAMI,EAAI,OAAO,KAAK,GAAG,IAAIJ,EAAK,OACrD,EACA,CACE,QAAS,OAAO,KAAKI,EAAI,OAAO,EAAE,OAAS,EAC3C,QAAS,KACT,QAASA,EAAI,OACf,CACA,EAAA,OAAQG,GAAYA,EAAQ,OAAO,EAE/BC,EAAUH,EAAS,IAAKE,GAAYA,EAAQ,OAAO,EAAE,KAAK,GAAG,EAC7DE,EAASJ,EAAS,IAAKE,GAAYA,EAAQ,OAAO,EAGlDG,EACJN,EAAI,QAAUO,EAAS,MAAQ,QAAU,MAE3C,KAAK,QAAQD,CAAO,EAAEF,EAAS,GAAGC,CAAM,CAC1C,CACF,CAEA,MAAMH,EAA0C,CAC9C,CAACK,EAAS,KAAK,EAAG,GAAGX,EAAK,OAAOC,EAAM,YAAYD,EAAK,QACxD,CAACW,EAAS,IAAI,EAAG,GAAGX,EAAK,OAAOC,EAAM,YAAYD,EAAK,SACvD,CAACW,EAAS,IAAI,EAAG,GAAGX,EAAK,OAAOC,EAAM,aAAaD,EAAK,SACxD,CAACW,EAAS,KAAK,EAAG,GAAGX,EAAK,OAAOC,EAAM,WAAWD,EAAK,OACzD"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@holz/ansi-terminal-backend",
+  "version": "0.0.0",
+  "description": "An ANSI terminal backend for Holz",
+  "type": "module",
+  "main": "./dist/holz-ansi-terminal-backend.umd.cjs",
+  "module": "./dist/holz-ansi-terminal-backend.js",
+  "types": "./src/index.ts",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/PsychoLlama/holz",
+    "directory": "packages/holz-ansi-terminal-backend"
+  },
+  "exports": {
+    ".": {
+      "require": "./dist/holz-ansi-terminal-backend.umd.cjs",
+      "import": "./dist/holz-ansi-terminal-backend.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "author": "Jesse Gibson",
+  "license": "MIT",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "src"
+  ],
+  "keywords": [
+    "holz-backend",
+    "ansi",
+    "terminal"
+  ],
+  "scripts": {
+    "prepare": "vite build --sourcemap",
+    "test:unit": "vitest --color --passWithNoTests",
+    "test:coverage": "run test:unit --coverage"
+  },
+  "devDependencies": {
+    "@holz/core": "0.0.0",
+    "@types/node": "^18.14.0",
+    "@vitest/coverage-c8": "0.28.5",
+    "vite": "^4.0.0",
+    "vitest": "^0.28.5"
+  }
+}

package/src/__tests__/ansi-terminal-backend.test.ts

@@ -0,0 +1,106 @@
+import { format } from 'util';
+import { createLogger } from '@holz/core';
+import type { MinimalConsole } from '../ansi-terminal-backend';
+import AnsiTerminalBackend from '../ansi-terminal-backend';
+
+class MockConsole implements MinimalConsole {
+  log(...strings: Array<unknown>) {
+    this.stdout(format(...strings));
+  }
+
+  error(...strings: Array<unknown>) {
+    this.stderr(format(...strings));
+  }
+
+  stdout = vi.fn();
+  stderr = vi.fn();
+}
+
+describe('Terminal backend', () => {
+  it('prints the message to the terminal', () => {
+    const terminal = new MockConsole();
+    const backend = new AnsiTerminalBackend({ console: terminal });
+
+    const logger = createLogger(backend);
+    logger.info('hello world');
+
+    expect(terminal.stdout).toHaveBeenCalledWith(
+      expect.stringContaining('hello world')
+    );
+  });
+
+  it('includes the log level', () => {
+    const terminal = new MockConsole();
+    const backend = new AnsiTerminalBackend({ console: terminal });
+
+    const logger = createLogger(backend);
+    logger.debug('shout');
+    logger.info('normal');
+    logger.warn('hmmmm');
+    logger.error('oh no');
+
+    expect(terminal.stdout).toHaveBeenCalledWith(
+      expect.stringContaining('debug')
+    );
+
+    expect(terminal.stdout).toHaveBeenCalledWith(
+      expect.stringContaining('info')
+    );
+
+    expect(terminal.stdout).toHaveBeenCalledWith(
+      expect.stringContaining('warn')
+    );
+
+    expect(terminal.stderr).toHaveBeenCalledWith(
+      expect.stringContaining('error')
+    );
+  });
+
+  it('includes the log namespace', () => {
+    const terminal = new MockConsole();
+    const backend = new AnsiTerminalBackend({ console: terminal });
+    const logger = createLogger(backend)
+      .namespace('my-lib')
+      .namespace('MyClass');
+
+    logger.debug('initialized');
+
+    expect(terminal.stdout).toHaveBeenCalledWith(
+      expect.stringContaining('my-lib:MyClass')
+    );
+  });
+
+  it('includes the log context', () => {
+    const terminal = new MockConsole();
+    const backend = new AnsiTerminalBackend({ console: terminal });
+    const logger = createLogger(backend);
+
+    logger.info('creating session', { sessionId: 3109 });
+
+    // Hard to test without replicating the implementation.
+    expect(terminal.stdout).toHaveBeenCalledWith(
+      expect.stringContaining('sessionId')
+    );
+
+    expect(terminal.stdout).toHaveBeenCalledWith(
+      expect.stringContaining('3109')
+    );
+  });
+
+  it('does not include the log context if it is empty', () => {
+    const terminal = new MockConsole();
+    const backend = new AnsiTerminalBackend({ console: terminal });
+    const logger = createLogger(backend);
+
+    logger.warn('activating death ray', {});
+
+    // Hard to test without replicating the implementation.
+    expect(terminal.stdout).not.toHaveBeenCalledWith(
+      expect.stringContaining('{')
+    );
+
+    expect(terminal.stdout).not.toHaveBeenCalledWith(
+      expect.stringContaining('}')
+    );
+  });
+});

package/src/ansi-codes.ts

@@ -0,0 +1,27 @@
+function ansiCode(code: string) {
+  return `\x1b[${code}`;
+}
+
+/**
+ * Unix only. This will break for win32 terminals and may spew garbage on
+ * terminals without 4-bit color support.
+ *
+ * TODO: Strip colors on non-interactive TTYs.
+ */
+
+export const color = {
+  black: ansiCode('30m'),
+  red: ansiCode('31m'),
+  green: ansiCode('32m'),
+  yellow: ansiCode('33m'),
+  blue: ansiCode('34m'),
+  magenta: ansiCode('35m'),
+  cyan: ansiCode('36m'),
+  white: ansiCode('37m'),
+};
+
+export const code = {
+  reset: ansiCode('0m'),
+  bold: ansiCode('1m'),
+  dim: ansiCode('2m'),
+};

package/src/ansi-terminal-backend.ts

@@ -0,0 +1,76 @@
+import type { Log, LogProcessor } from '@holz/core';
+import { LogLevel } from '@holz/core';
+import { color, code } from './ansi-codes';
+
+/**
+ * A backend that prints logs to a 3-bit ansi terminal. This should work on
+ * most Unix systems and Windows >= 10.
+ *
+ * NOTE: This is not smart enough to detect if the output is a TTY or if it
+ * supports colors, nor is this the appropriate place to check. Without color
+ * ques, the printed text is much less understandable. It is better to check
+ * when constructing the logger instead.
+ */
+export default class AnsiTerminalBackend implements LogProcessor {
+  private console: MinimalConsole;
+
+  constructor(options: Options = {}) {
+    this.console = options.console ?? console;
+  }
+
+  processLog(log: Log) {
+    const segments = [
+      {
+        include: true,
+        command: '%s',
+        content: logLevelLabel[log.level],
+      },
+      {
+        include: true,
+        command: '%s',
+        content: log.message,
+      },
+      {
+        include: log.origin.length > 0,
+        command: '%s',
+        content: `${code.dim}${log.origin.join(':')}${code.reset}`,
+      },
+      {
+        include: Object.keys(log.context).length > 0,
+        command: '%O',
+        content: log.context,
+      },
+    ].filter((segment) => segment.include);
+
+    const command = segments.map((segment) => segment.command).join(' ');
+    const values = segments.map((segment) => segment.content);
+
+    // Errors should always use stderr.
+    const channel: keyof MinimalConsole =
+      log.level === LogLevel.Error ? 'error' : 'log';
+
+    this.console[channel](command, ...values);
+  }
+}
+
+const logLevelLabel: Record<LogLevel, string> = {
+  [LogLevel.Debug]: `${code.bold}${color.cyan}debug${code.reset}`,
+  [LogLevel.Info]: `${code.bold}${color.green}info${code.reset} `,
+  [LogLevel.Warn]: `${code.bold}${color.yellow}warn${code.reset} `,
+  [LogLevel.Error]: `${code.bold}${color.red}error${code.reset}`,
+};
+
+interface Options {
+  console?: MinimalConsole;
+}
+
+/**
+ * A subset of the Console interface. Must support printf-style interpolation.
+ */
+export interface MinimalConsole {
+  /** Log to stdout. */
+  log: Console['log'];
+
+  /** Log to stderr. */
+  error: Console['error'];
+}

package/src/index.ts

@@ -0,0 +1,4 @@
+export {
+  default,
+  default as AnsiTerminalBackend,
+} from './ansi-terminal-backend';