@dryanovski/gamefoo 0.2.3 → 0.2.5

package/src/core/fonts/internal/font_4x6.ts

@@ -0,0 +1,180 @@
+/**
+ * Built-in 4x6 pixel bitmap font.
+ *
+ * Each character is a 4-pixel-wide, 6-pixel-tall glyph stored as an
+ * array of 6 integers. Each integer is a bitmask where bit 3
+ * (MSB) corresponds to the leftmost pixel and bit 0 to the rightmost.
+ *
+ * Small but readable, good for status bars.
+ *
+ * Supported characters: uppercase A–Z, lowercase a–z, digits 0–9,
+ * and common punctuation / special characters.
+ *
+ * @category Fonts
+ * @since 0.2.0
+ * @internal
+ *
+ * @example Reading a glyph
+ * ```ts
+ * import FONT_4x6 from "./font_4x6";
+ *
+ * const letterA = FONT_4x6["A"];
+ * // 6, 9, 9, 15, 9, 9
+ * ```
+ */
+
+/** Catalogue name used by {@link FontBitmap} to look up this font. */
+export const FONT_4x6_NAME = "4x6";
+
+/**
+ * Glyph width in pixels (excluding spacing).
+ * @defaultValue `4`
+ */
+export const FONT_4x6_WIDTH = 4;
+
+/**
+ * Glyph height in pixels.
+ * @defaultValue `6`
+ */
+export const FONT_4x6_HEIGHT = 6;
+
+/**
+ * Horizontal spacing between glyphs in pixels.
+ * @defaultValue `1`
+ */
+export const FONT_4x6_SPACING = 1;
+
+/**
+ * Complete set of supported characters as a single string.
+ */
+export const FONT_4x6_CHARS =
+  "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz !?.,:;-+*/\\()[]{}<>=#%&@^_'\"`~|$";
+
+/**
+ * Glyph data keyed by character.
+ *
+ * Each value is a 6-element `number[]` where each entry is a 4-bit
+ * row bitmask (bit 3 = leftmost pixel, bit 0 = rightmost pixel).
+ *
+ * @see {@link FontBitmap} — consumes this data for rendering
+ */
+export const FONT_4x6: Record<string, number[]> = {
+  "0": [6, 9, 11, 13, 9, 6],
+  "1": [2, 6, 2, 2, 2, 7],
+  "2": [6, 9, 1, 6, 8, 15],
+  "3": [14, 1, 6, 1, 1, 14],
+  "4": [3, 5, 9, 15, 1, 1],
+  "5": [15, 8, 14, 1, 1, 14],
+  "6": [3, 4, 14, 9, 9, 6],
+  "7": [15, 1, 2, 4, 4, 4],
+  "8": [6, 9, 6, 9, 9, 6],
+  "9": [6, 9, 9, 7, 1, 12],
+  A: [6, 9, 9, 15, 9, 9],
+  B: [14, 9, 14, 9, 9, 14],
+  C: [7, 8, 8, 8, 8, 7],
+  D: [14, 9, 9, 9, 9, 14],
+  E: [15, 8, 14, 8, 8, 15],
+  F: [15, 8, 14, 8, 8, 8],
+  G: [7, 8, 8, 11, 9, 7],
+  H: [9, 9, 15, 9, 9, 9],
+  I: [14, 4, 4, 4, 4, 14],
+  J: [7, 1, 1, 1, 9, 6],
+  K: [9, 10, 12, 10, 9, 9],
+  L: [8, 8, 8, 8, 8, 15],
+  M: [9, 15, 15, 9, 9, 9],
+  N: [9, 13, 11, 9, 9, 9],
+  O: [6, 9, 9, 9, 9, 6],
+  P: [14, 9, 9, 14, 8, 8],
+  Q: [6, 9, 9, 9, 6, 3],
+  R: [14, 9, 9, 14, 9, 9],
+  S: [7, 8, 6, 1, 1, 14],
+  T: [15, 4, 4, 4, 4, 4],
+  U: [9, 9, 9, 9, 9, 6],
+  V: [9, 9, 9, 9, 6, 6],
+  W: [9, 9, 9, 15, 15, 9],
+  X: [9, 9, 6, 6, 9, 9],
+  Y: [9, 9, 6, 4, 4, 4],
+  Z: [15, 1, 2, 4, 8, 15],
+  a: [0, 6, 1, 7, 9, 7],
+  b: [8, 8, 14, 9, 9, 14],
+  c: [0, 7, 8, 8, 8, 7],
+  d: [1, 1, 7, 9, 9, 7],
+  e: [0, 6, 9, 15, 8, 7],
+  f: [3, 4, 14, 4, 4, 4],
+  g: [0, 7, 9, 7, 1, 14],
+  h: [8, 8, 14, 9, 9, 9],
+  i: [0, 4, 0, 4, 4, 6],
+  j: [0, 2, 0, 2, 2, 12],
+  k: [8, 9, 10, 12, 10, 9],
+  l: [4, 4, 4, 4, 4, 3],
+  m: [0, 0, 14, 15, 9, 9],
+  n: [0, 0, 14, 9, 9, 9],
+  o: [0, 0, 6, 9, 9, 6],
+  p: [0, 0, 14, 9, 14, 8],
+  q: [0, 0, 7, 9, 7, 1],
+  r: [0, 0, 7, 8, 8, 8],
+  s: [0, 0, 7, 12, 3, 14],
+  t: [4, 4, 14, 4, 4, 3],
+  u: [0, 0, 9, 9, 9, 7],
+  v: [0, 0, 9, 9, 6, 6],
+  w: [0, 0, 9, 9, 15, 9],
+  x: [0, 0, 9, 6, 6, 9],
+  y: [0, 0, 9, 7, 1, 14],
+  z: [0, 0, 15, 2, 4, 15],
+  " ": [0, 0, 0, 0, 0, 0],
+  "!": [2, 2, 2, 2, 0, 2],
+  "?": [6, 9, 1, 2, 0, 2],
+  ".": [0, 0, 0, 0, 0, 4],
+  ",": [0, 0, 0, 0, 4, 8],
+  ":": [0, 4, 0, 4, 0, 0],
+  ";": [0, 4, 0, 4, 4, 8],
+  "-": [0, 0, 15, 0, 0, 0],
+  "+": [0, 4, 14, 4, 0, 0],
+  "*": [0, 9, 6, 6, 9, 0],
+  "/": [1, 1, 2, 4, 8, 8],
+  "\\": [8, 8, 4, 2, 1, 1],
+  "(": [2, 4, 4, 4, 4, 2],
+  ")": [4, 2, 2, 2, 2, 4],
+  "[": [6, 4, 4, 4, 4, 6],
+  "]": [6, 2, 2, 2, 2, 6],
+  "{": [3, 4, 12, 4, 4, 3],
+  "}": [12, 2, 3, 2, 2, 12],
+  "<": [1, 2, 4, 4, 2, 1],
+  ">": [8, 4, 2, 2, 4, 8],
+  "=": [0, 15, 0, 15, 0, 0],
+  "#": [5, 15, 5, 15, 5, 0],
+  "%": [9, 1, 2, 4, 8, 9],
+  "&": [4, 10, 4, 10, 9, 7],
+  "@": [6, 9, 11, 11, 8, 6],
+  "^": [4, 10, 0, 0, 0, 0],
+  _: [0, 0, 0, 0, 0, 15],
+  "'": [6, 4, 0, 0, 0, 0],
+  '"': [10, 10, 0, 0, 0, 0],
+  "`": [8, 4, 0, 0, 0, 0],
+  "~": [0, 6, 9, 9, 0, 0],
+  "|": [4, 4, 4, 4, 4, 4],
+  $: [4, 7, 12, 7, 1, 14],
+};
+
+/**
+ * Complete metadata object for the 4x6 font, used by the
+ * {@link FontBitmap} catalogue at module load time.
+ *
+ * @internal
+ */
+export const metadata = {
+  /** Catalogue name. */
+  name: FONT_4x6_NAME,
+  /** Cell width including spacing (4 + 1 = 5). */
+  width: FONT_4x6_WIDTH + FONT_4x6_SPACING,
+  /** Cell height (6). */
+  height: FONT_4x6_HEIGHT,
+  /** Inter-glyph spacing (1). */
+  spacing: FONT_4x6_SPACING,
+  /** Supported character string. */
+  chars: FONT_4x6_CHARS,
+  /** Glyph bitmask data. */
+  data: FONT_4x6,
+};
+
+export default FONT_4x6;

package/src/core/fonts/internal/font_5x5.ts

@@ -0,0 +1,137 @@
+/**
+ * Built-in 5x5 pixel bitmap font.
+ *
+ * Each character is a 5-pixel-wide, 5-pixel-tall glyph stored as an
+ * array of five integers. Each integer is a bitmask where bit 4
+ * (MSB) corresponds to the leftmost pixel and bit 0 to the rightmost.
+ *
+ * Supported characters: `A–Z`, `0–9`, and space.
+ *
+ * @category Fonts
+ * @since 0.1.0
+ * @internal
+ *
+ * @example Reading a glyph
+ * ```ts
+ * import FONT_5x5 from "./font_5x5";
+ *
+ * const letterA = FONT_5x5["A"];
+ * // [14, 17, 31, 17, 17]
+ * //
+ * //  .###.   = 0b01110 = 14
+ * //  #...#   = 0b10001 = 17
+ * //  #####   = 0b11111 = 31
+ * //  #...#   = 0b10001 = 17
+ * //  #...#   = 0b10001 = 17
+ * ```
+ */
+
+/** Catalogue name used by {@link FontBitmap} to look up this font. */
+export const FONT_5x5_NAME = "5x5";
+
+/**
+ * Glyph width in pixels (excluding spacing).
+ * @defaultValue `5`
+ */
+export const FONT_5x5_WIDTH = 5;
+
+/**
+ * Glyph height in pixels.
+ * @defaultValue `5`
+ */
+export const FONT_5x5_HEIGHT = 5;
+
+/**
+ * Horizontal spacing between glyphs in pixels.
+ * @defaultValue `1`
+ */
+export const FONT_5x5_SPACING = 1;
+
+/**
+ * Complete set of supported characters as a single string.
+ */
+export const FONT_5x5_CHARS = "ABCDEFGHIJKLMNOPQRSTUVWXYZ 0123456789";
+
+/**
+ * Glyph data keyed by character.
+ *
+ * Each value is a 5-element `number[]` where each entry is a 5-bit
+ * row bitmask (bit 4 = leftmost pixel, bit 0 = rightmost pixel).
+ *
+ * @see {@link FontBitmap} — consumes this data for rendering
+ */
+export const FONT_5x5: Record<string, number[]> = {
+  A: [14, 17, 31, 17, 17],
+  B: [30, 17, 30, 17, 30],
+  C: [15, 16, 16, 16, 15],
+  D: [30, 17, 17, 17, 30],
+  E: [31, 16, 28, 16, 31],
+  F: [31, 16, 28, 16, 16],
+  G: [15, 16, 19, 17, 15],
+  H: [17, 17, 31, 17, 17],
+  I: [31, 4, 4, 4, 31],
+  L: [16, 16, 16, 16, 31],
+  M: [17, 27, 21, 17, 17],
+  N: [17, 25, 21, 19, 17],
+  O: [14, 17, 17, 17, 14],
+  P: [30, 17, 30, 16, 16],
+  R: [30, 17, 30, 18, 17],
+  S: [15, 16, 14, 1, 30],
+  T: [31, 4, 4, 4, 4],
+  U: [17, 17, 17, 17, 14],
+  V: [17, 17, 17, 10, 4],
+  W: [17, 17, 21, 27, 17],
+  Y: [17, 10, 4, 4, 4],
+  " ": [0, 0, 0, 0, 0],
+  "0": [14, 17, 17, 17, 14],
+  "1": [4, 12, 4, 4, 14],
+  "2": [14, 17, 6, 8, 31],
+  "3": [30, 1, 14, 1, 30],
+  "4": [18, 18, 31, 2, 2],
+  "5": [31, 16, 30, 1, 30],
+  "6": [14, 16, 30, 17, 14],
+  "7": [31, 1, 2, 4, 4],
+  "8": [14, 17, 14, 17, 14],
+  "9": [14, 17, 15, 1, 14],
+  ".": [0, 0, 0, 12, 12],
+  ",": [0, 0, 0, 12, 4],
+  "/": [1, 2, 4, 8, 16],
+  "|": [4, 4, 4, 4, 4],
+  "(": [2, 4, 4, 4, 2],
+  ")": [8, 4, 4, 4, 8],
+  "?": [14, 17, 6, 0, 4],
+  "!": [4, 4, 4, 0, 4],
+  "#": [10, 31, 10, 31, 10],
+  $: [14, 16, 14, 1, 14],
+  "%": [19, 9, 4, 18, 25],
+  "@": [14, 17, 21, 21, 14],
+  "^": [4, 10, 17, 0, 0],
+  "&": [14, 17, 14, 21, 14],
+  "*": [0, 10, 4, 10, 0],
+  "-": [0, 0, 31, 0, 0],
+  "+": [0, 4, 14, 4, 0],
+  "=": [0, 14, 0, 14, 0],
+};
+
+/**
+ * Complete metadata object for the 5x5 font, used by the
+ * {@link FontBitmap} catalogue at module load time.
+ *
+ * @internal
+ */
+export const metadata = {
+  /** Catalogue name. */
+  name: FONT_5x5_NAME,
+  /** Cell width including spacing (5 + 1 = 6). */
+  width: FONT_5x5_WIDTH + FONT_5x5_SPACING,
+  /** Cell height (5). */
+  height: FONT_5x5_HEIGHT,
+  /** Inter-glyph spacing (1). */
+  spacing: FONT_5x5_SPACING,
+  /** Supported character string. */
+  chars: FONT_5x5_CHARS,
+  /** Glyph bitmask data. */
+  data: FONT_5x5,
+};
+
+export default FONT_5x5;

package/src/core/fonts/internal/font_6x8.ts

@@ -0,0 +1,180 @@
+/**
+ * Built-in 6x8 pixel bitmap font.
+ *
+ * Each character is a 6-pixel-wide, 8-pixel-tall glyph stored as an
+ * array of 8 integers. Each integer is a bitmask where bit 5
+ * (MSB) corresponds to the leftmost pixel and bit 0 to the rightmost.
+ *
+ * Classic arcade and console aesthetic.
+ *
+ * Supported characters: uppercase A–Z, lowercase a–z, digits 0–9,
+ * and common punctuation / special characters.
+ *
+ * @category Fonts
+ * @since 0.2.0
+ * @internal
+ *
+ * @example Reading a glyph
+ * ```ts
+ * import FONT_6x8 from "./font_6x8";
+ *
+ * const letterA = FONT_6x8["A"];
+ * // 12, 18, 33, 33, 63, 33, 33, 0
+ * ```
+ */
+
+/** Catalogue name used by {@link FontBitmap} to look up this font. */
+export const FONT_6x8_NAME = "6x8";
+
+/**
+ * Glyph width in pixels (excluding spacing).
+ * @defaultValue `6`
+ */
+export const FONT_6x8_WIDTH = 6;
+
+/**
+ * Glyph height in pixels.
+ * @defaultValue `8`
+ */
+export const FONT_6x8_HEIGHT = 8;
+
+/**
+ * Horizontal spacing between glyphs in pixels.
+ * @defaultValue `1`
+ */
+export const FONT_6x8_SPACING = 1;
+
+/**
+ * Complete set of supported characters as a single string.
+ */
+export const FONT_6x8_CHARS =
+  "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz !?.,:;-+*/\\()[]{}<>=#%&@^_'\"`~|$";
+
+/**
+ * Glyph data keyed by character.
+ *
+ * Each value is a 8-element `number[]` where each entry is a 6-bit
+ * row bitmask (bit 5 = leftmost pixel, bit 0 = rightmost pixel).
+ *
+ * @see {@link FontBitmap} — consumes this data for rendering
+ */
+export const FONT_6x8: Record<string, number[]> = {
+  "0": [30, 33, 35, 37, 41, 49, 30, 0],
+  "1": [12, 28, 12, 12, 12, 12, 63, 0],
+  "2": [30, 33, 1, 14, 16, 32, 63, 0],
+  "3": [30, 33, 1, 30, 1, 33, 30, 0],
+  "4": [6, 14, 22, 38, 63, 6, 6, 0],
+  "5": [63, 32, 62, 1, 1, 33, 30, 0],
+  "6": [30, 33, 32, 62, 33, 33, 30, 0],
+  "7": [63, 1, 2, 4, 8, 16, 32, 0],
+  "8": [30, 33, 33, 30, 33, 33, 30, 0],
+  "9": [30, 33, 33, 31, 1, 33, 30, 0],
+  A: [12, 18, 33, 33, 63, 33, 33, 0],
+  B: [62, 33, 33, 62, 33, 33, 62, 0],
+  C: [30, 33, 32, 32, 32, 33, 30, 0],
+  D: [60, 34, 33, 33, 33, 34, 60, 0],
+  E: [63, 32, 32, 60, 32, 32, 63, 0],
+  F: [63, 32, 32, 60, 32, 32, 32, 0],
+  G: [30, 33, 32, 39, 33, 33, 31, 0],
+  H: [33, 33, 33, 63, 33, 33, 33, 0],
+  I: [30, 12, 12, 12, 12, 12, 30, 0],
+  J: [15, 3, 3, 3, 3, 35, 30, 0],
+  K: [33, 34, 36, 40, 52, 34, 33, 0],
+  L: [32, 32, 32, 32, 32, 32, 63, 0],
+  M: [33, 51, 45, 37, 33, 33, 33, 0],
+  N: [33, 49, 41, 37, 35, 33, 33, 0],
+  O: [30, 33, 33, 33, 33, 33, 30, 0],
+  P: [62, 33, 33, 62, 32, 32, 32, 0],
+  Q: [30, 33, 33, 33, 37, 34, 29, 0],
+  R: [62, 33, 33, 62, 36, 34, 33, 0],
+  S: [31, 32, 32, 30, 1, 1, 62, 0],
+  T: [63, 12, 12, 12, 12, 12, 12, 0],
+  U: [33, 33, 33, 33, 33, 33, 30, 0],
+  V: [33, 33, 33, 33, 18, 18, 12, 0],
+  W: [33, 33, 33, 37, 45, 51, 33, 0],
+  X: [33, 18, 12, 12, 18, 33, 33, 0],
+  Y: [33, 33, 18, 12, 12, 12, 12, 0],
+  Z: [63, 1, 2, 12, 16, 32, 63, 0],
+  a: [0, 0, 30, 1, 31, 33, 31, 0],
+  b: [32, 32, 46, 49, 33, 49, 46, 0],
+  c: [0, 0, 30, 32, 32, 32, 30, 0],
+  d: [1, 1, 29, 35, 33, 35, 29, 0],
+  e: [0, 0, 30, 33, 63, 32, 30, 0],
+  f: [14, 17, 16, 60, 16, 16, 16, 0],
+  g: [0, 29, 35, 33, 31, 1, 30, 0],
+  h: [32, 32, 46, 49, 33, 33, 33, 0],
+  i: [12, 0, 12, 28, 12, 12, 30, 0],
+  j: [6, 0, 6, 6, 6, 38, 28, 0],
+  k: [32, 32, 33, 38, 56, 38, 33, 0],
+  l: [24, 8, 8, 8, 8, 8, 30, 0],
+  m: [0, 0, 54, 41, 33, 33, 33, 0],
+  n: [0, 0, 46, 49, 33, 33, 33, 0],
+  o: [0, 0, 30, 33, 33, 33, 30, 0],
+  p: [0, 46, 49, 33, 49, 46, 32, 32],
+  q: [0, 29, 35, 33, 35, 29, 1, 1],
+  r: [0, 0, 30, 32, 32, 32, 32, 0],
+  s: [0, 0, 31, 32, 30, 1, 62, 0],
+  t: [16, 16, 60, 16, 16, 17, 14, 0],
+  u: [0, 0, 33, 33, 33, 35, 29, 0],
+  v: [0, 0, 33, 33, 18, 18, 12, 0],
+  w: [0, 0, 33, 33, 37, 45, 18, 0],
+  x: [0, 0, 33, 18, 12, 18, 33, 0],
+  y: [0, 33, 33, 33, 31, 1, 30, 0],
+  z: [0, 0, 63, 2, 12, 16, 63, 0],
+  " ": [0, 0, 0, 0, 0, 0, 0, 0],
+  "!": [12, 12, 12, 12, 12, 0, 12, 0],
+  "?": [30, 33, 1, 6, 12, 0, 12, 0],
+  ".": [0, 0, 0, 0, 0, 12, 12, 0],
+  ",": [0, 0, 0, 0, 12, 12, 24, 0],
+  ":": [0, 12, 12, 0, 12, 12, 0, 0],
+  ";": [0, 12, 12, 0, 12, 12, 24, 0],
+  "-": [0, 0, 0, 63, 0, 0, 0, 0],
+  "+": [0, 12, 12, 63, 12, 12, 0, 0],
+  "*": [0, 33, 18, 12, 18, 33, 0, 0],
+  "/": [1, 1, 2, 12, 16, 32, 0, 0],
+  "\\": [32, 16, 8, 4, 2, 1, 0, 0],
+  "(": [6, 12, 24, 24, 24, 12, 6, 0],
+  ")": [24, 12, 6, 6, 6, 12, 24, 0],
+  "[": [30, 16, 16, 16, 16, 16, 30, 0],
+  "]": [30, 2, 2, 2, 2, 2, 30, 0],
+  "{": [14, 24, 24, 48, 24, 24, 14, 0],
+  "}": [28, 6, 6, 3, 6, 6, 28, 0],
+  "<": [3, 12, 48, 48, 12, 3, 0, 0],
+  ">": [48, 12, 3, 3, 12, 48, 0, 0],
+  "=": [0, 63, 0, 63, 0, 0, 0, 0],
+  "#": [18, 18, 63, 18, 63, 18, 18, 0],
+  "%": [33, 34, 4, 12, 16, 32, 33, 0],
+  "&": [24, 36, 36, 25, 38, 36, 27, 0],
+  "@": [30, 33, 33, 47, 41, 32, 31, 0],
+  "^": [12, 18, 33, 0, 0, 0, 0, 0],
+  _: [0, 0, 0, 0, 0, 0, 63, 0],
+  "'": [12, 12, 24, 0, 0, 0, 0, 0],
+  '"': [36, 36, 0, 0, 0, 0, 0, 0],
+  "`": [24, 12, 0, 0, 0, 0, 0, 0],
+  "~": [0, 17, 42, 36, 0, 0, 0, 0],
+  "|": [12, 12, 12, 12, 12, 12, 12, 0],
+  $: [12, 30, 32, 30, 1, 30, 12, 0],
+};
+
+/**
+ * Complete metadata object for the 6x8 font, used by the
+ * {@link FontBitmap} catalogue at module load time.
+ *
+ * @internal
+ */
+export const metadata = {
+  /** Catalogue name. */
+  name: FONT_6x8_NAME,
+  /** Cell width including spacing (6 + 1 = 7). */
+  width: FONT_6x8_WIDTH + FONT_6x8_SPACING,
+  /** Cell height (8). */
+  height: FONT_6x8_HEIGHT,
+  /** Inter-glyph spacing (1). */
+  spacing: FONT_6x8_SPACING,
+  /** Supported character string. */
+  chars: FONT_6x8_CHARS,
+  /** Glyph bitmask data. */
+  data: FONT_6x8,
+};
+
+export default FONT_6x8;

package/src/core/fonts/internal/font_8x13.ts

@@ -0,0 +1,180 @@
+/**
+ * Built-in 8x13 pixel bitmap font.
+ *
+ * Each character is a 8-pixel-wide, 13-pixel-tall glyph stored as an
+ * array of 13 integers. Each integer is a bitmask where bit 7
+ * (MSB) corresponds to the leftmost pixel and bit 0 to the rightmost.
+ *
+ * Tall, elegant glyphs for dialogue boxes and UI.
+ *
+ * Supported characters: uppercase A–Z, lowercase a–z, digits 0–9,
+ * and common punctuation / special characters.
+ *
+ * @category Fonts
+ * @since 0.2.0
+ * @internal
+ *
+ * @example Reading a glyph
+ * ```ts
+ * import FONT_8x13 from "./font_8x13";
+ *
+ * const letterA = FONT_8x13["A"];
+ * // 0, 0, 24, 36, 66, 66, 126, 66, 66, 66, 0, 0, 0
+ * ```
+ */
+
+/** Catalogue name used by {@link FontBitmap} to look up this font. */
+export const FONT_8x13_NAME = "8x13";
+
+/**
+ * Glyph width in pixels (excluding spacing).
+ * @defaultValue `8`
+ */
+export const FONT_8x13_WIDTH = 8;
+
+/**
+ * Glyph height in pixels.
+ * @defaultValue `13`
+ */
+export const FONT_8x13_HEIGHT = 13;
+
+/**
+ * Horizontal spacing between glyphs in pixels.
+ * @defaultValue `1`
+ */
+export const FONT_8x13_SPACING = 1;
+
+/**
+ * Complete set of supported characters as a single string.
+ */
+export const FONT_8x13_CHARS =
+  "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz !?.,:;-+*/\\()[]{}<>=#%&@^_'\"`~|$";
+
+/**
+ * Glyph data keyed by character.
+ *
+ * Each value is a 13-element `number[]` where each entry is a 8-bit
+ * row bitmask (bit 7 = leftmost pixel, bit 0 = rightmost pixel).
+ *
+ * @see {@link FontBitmap} — consumes this data for rendering
+ */
+export const FONT_8x13: Record<string, number[]> = {
+  "0": [0, 0, 60, 66, 70, 74, 82, 98, 66, 60, 0, 0, 0],
+  "1": [0, 0, 24, 56, 24, 24, 24, 24, 24, 126, 0, 0, 0],
+  "2": [0, 0, 60, 66, 2, 4, 8, 48, 64, 126, 0, 0, 0],
+  "3": [0, 0, 124, 2, 2, 60, 2, 2, 2, 124, 0, 0, 0],
+  "4": [0, 0, 4, 12, 20, 36, 68, 254, 4, 4, 0, 0, 0],
+  "5": [0, 0, 254, 128, 128, 252, 2, 2, 66, 60, 0, 0, 0],
+  "6": [0, 0, 62, 64, 128, 252, 130, 130, 66, 60, 0, 0, 0],
+  "7": [0, 0, 254, 2, 4, 8, 16, 32, 64, 128, 0, 0, 0],
+  "8": [0, 0, 60, 66, 66, 60, 66, 66, 66, 60, 0, 0, 0],
+  "9": [0, 0, 60, 66, 66, 62, 2, 2, 66, 60, 0, 0, 0],
+  A: [0, 0, 24, 36, 66, 66, 126, 66, 66, 66, 0, 0, 0],
+  B: [0, 0, 252, 66, 66, 124, 66, 66, 66, 252, 0, 0, 0],
+  C: [0, 0, 60, 66, 128, 128, 128, 128, 66, 60, 0, 0, 0],
+  D: [0, 0, 248, 68, 66, 66, 66, 66, 68, 248, 0, 0, 0],
+  E: [0, 0, 254, 128, 128, 252, 128, 128, 128, 254, 0, 0, 0],
+  F: [0, 0, 254, 128, 128, 252, 128, 128, 128, 128, 0, 0, 0],
+  G: [0, 0, 62, 64, 128, 142, 130, 130, 66, 62, 0, 0, 0],
+  H: [0, 0, 66, 66, 66, 126, 66, 66, 66, 66, 0, 0, 0],
+  I: [0, 0, 126, 24, 24, 24, 24, 24, 24, 126, 0, 0, 0],
+  J: [0, 0, 62, 8, 8, 8, 8, 136, 136, 112, 0, 0, 0],
+  K: [0, 0, 130, 132, 136, 144, 224, 144, 136, 134, 0, 0, 0],
+  L: [0, 0, 128, 128, 128, 128, 128, 128, 128, 254, 0, 0, 0],
+  M: [0, 0, 130, 198, 170, 146, 130, 130, 130, 130, 0, 0, 0],
+  N: [0, 0, 130, 194, 162, 146, 138, 134, 130, 130, 0, 0, 0],
+  O: [0, 0, 60, 66, 129, 129, 129, 129, 66, 60, 0, 0, 0],
+  P: [0, 0, 252, 130, 130, 252, 128, 128, 128, 128, 0, 0, 0],
+  Q: [0, 0, 60, 66, 129, 129, 129, 133, 70, 61, 0, 0, 0],
+  R: [0, 0, 252, 130, 130, 252, 144, 136, 132, 130, 0, 0, 0],
+  S: [0, 0, 62, 64, 128, 124, 2, 2, 2, 252, 0, 0, 0],
+  T: [0, 0, 254, 16, 16, 16, 16, 16, 16, 16, 0, 0, 0],
+  U: [0, 0, 130, 130, 130, 130, 130, 130, 68, 56, 0, 0, 0],
+  V: [0, 0, 130, 130, 68, 68, 40, 40, 16, 16, 0, 0, 0],
+  W: [0, 0, 130, 130, 130, 130, 146, 170, 198, 130, 0, 0, 0],
+  X: [0, 0, 130, 68, 40, 16, 16, 40, 68, 130, 0, 0, 0],
+  Y: [0, 0, 130, 68, 40, 16, 16, 16, 16, 16, 0, 0, 0],
+  Z: [0, 0, 254, 4, 8, 16, 16, 32, 64, 254, 0, 0, 0],
+  a: [0, 0, 0, 0, 60, 2, 62, 66, 66, 62, 0, 0, 0],
+  b: [0, 64, 64, 64, 124, 66, 66, 66, 66, 124, 0, 0, 0],
+  c: [0, 0, 0, 0, 62, 64, 128, 128, 64, 62, 0, 0, 0],
+  d: [0, 2, 2, 2, 62, 66, 66, 66, 66, 62, 0, 0, 0],
+  e: [0, 0, 0, 0, 60, 66, 126, 64, 64, 62, 0, 0, 0],
+  f: [0, 14, 16, 16, 60, 16, 16, 16, 16, 16, 0, 0, 0],
+  g: [0, 0, 0, 62, 66, 66, 66, 62, 2, 124, 0, 0, 0],
+  h: [0, 64, 64, 64, 124, 66, 66, 66, 66, 66, 0, 0, 0],
+  i: [0, 24, 24, 0, 56, 24, 24, 24, 24, 62, 0, 0, 0],
+  j: [0, 6, 6, 0, 6, 6, 6, 6, 70, 60, 0, 0, 0],
+  k: [0, 64, 64, 68, 72, 112, 120, 72, 68, 66, 0, 0, 0],
+  l: [0, 56, 24, 24, 24, 24, 24, 24, 24, 62, 0, 0, 0],
+  m: [0, 0, 0, 0, 218, 170, 170, 170, 130, 130, 0, 0, 0],
+  n: [0, 0, 0, 0, 124, 66, 66, 66, 66, 66, 0, 0, 0],
+  o: [0, 0, 0, 0, 60, 66, 129, 129, 66, 60, 0, 0, 0],
+  p: [0, 0, 0, 124, 66, 66, 66, 124, 64, 64, 64, 0, 0],
+  q: [0, 0, 0, 62, 66, 66, 66, 62, 2, 2, 2, 0, 0],
+  r: [0, 0, 0, 0, 94, 96, 64, 64, 64, 64, 0, 0, 0],
+  s: [0, 0, 0, 0, 62, 64, 60, 2, 2, 124, 0, 0, 0],
+  t: [0, 32, 32, 126, 32, 32, 32, 32, 34, 28, 0, 0, 0],
+  u: [0, 0, 0, 0, 66, 66, 66, 66, 70, 58, 0, 0, 0],
+  v: [0, 0, 0, 0, 66, 66, 36, 36, 24, 24, 0, 0, 0],
+  w: [0, 0, 0, 0, 130, 130, 146, 170, 198, 130, 0, 0, 0],
+  x: [0, 0, 0, 0, 66, 36, 24, 24, 36, 66, 0, 0, 0],
+  y: [0, 0, 0, 66, 66, 66, 66, 62, 2, 124, 0, 0, 0],
+  z: [0, 0, 0, 0, 254, 4, 8, 48, 64, 254, 0, 0, 0],
+  " ": [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0],
+  "!": [0, 0, 24, 24, 24, 24, 24, 24, 0, 24, 0, 0, 0],
+  "?": [0, 0, 60, 66, 2, 4, 8, 8, 0, 8, 0, 0, 0],
+  ".": [0, 0, 0, 0, 0, 0, 0, 0, 24, 24, 0, 0, 0],
+  ",": [0, 0, 0, 0, 0, 0, 0, 24, 24, 48, 0, 0, 0],
+  ":": [0, 0, 0, 0, 24, 24, 0, 24, 24, 0, 0, 0, 0],
+  ";": [0, 0, 0, 0, 24, 24, 0, 24, 24, 48, 0, 0, 0],
+  "-": [0, 0, 0, 0, 0, 254, 0, 0, 0, 0, 0, 0, 0],
+  "+": [0, 0, 0, 16, 16, 254, 16, 16, 0, 0, 0, 0, 0],
+  "*": [0, 0, 66, 36, 254, 36, 66, 0, 0, 0, 0, 0, 0],
+  "/": [0, 2, 4, 8, 16, 16, 32, 64, 128, 0, 0, 0, 0],
+  "\\": [0, 128, 64, 32, 16, 16, 8, 4, 2, 0, 0, 0, 0],
+  "(": [0, 6, 8, 16, 32, 32, 32, 16, 8, 6, 0, 0, 0],
+  ")": [0, 96, 16, 8, 4, 4, 4, 8, 16, 96, 0, 0, 0],
+  "[": [0, 120, 64, 64, 64, 64, 64, 64, 64, 120, 0, 0, 0],
+  "]": [0, 30, 2, 2, 2, 2, 2, 2, 2, 30, 0, 0, 0],
+  "{": [0, 30, 32, 32, 32, 64, 32, 32, 32, 30, 0, 0, 0],
+  "}": [0, 120, 4, 4, 4, 2, 4, 4, 4, 120, 0, 0, 0],
+  "<": [0, 0, 4, 8, 16, 32, 16, 8, 4, 0, 0, 0, 0],
+  ">": [0, 0, 32, 16, 8, 4, 8, 16, 32, 0, 0, 0, 0],
+  "=": [0, 0, 0, 0, 254, 0, 254, 0, 0, 0, 0, 0, 0],
+  "#": [0, 36, 36, 254, 36, 36, 254, 36, 36, 0, 0, 0, 0],
+  "%": [0, 0, 194, 196, 8, 16, 32, 67, 131, 0, 0, 0, 0],
+  "&": [0, 0, 48, 72, 72, 48, 74, 68, 72, 54, 0, 0, 0],
+  "@": [0, 0, 60, 66, 157, 165, 165, 158, 64, 60, 0, 0, 0],
+  "^": [0, 24, 36, 66, 0, 0, 0, 0, 0, 0, 0, 0, 0],
+  _: [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 254, 0, 0],
+  "'": [0, 24, 24, 48, 0, 0, 0, 0, 0, 0, 0, 0, 0],
+  '"': [0, 72, 72, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0],
+  "`": [0, 48, 24, 8, 0, 0, 0, 0, 0, 0, 0, 0, 0],
+  "~": [0, 0, 0, 70, 137, 144, 0, 0, 0, 0, 0, 0, 0],
+  "|": [0, 24, 24, 24, 24, 24, 24, 24, 24, 24, 0, 0, 0],
+  $: [0, 24, 62, 96, 96, 60, 6, 6, 124, 24, 0, 0, 0],
+};
+
+/**
+ * Complete metadata object for the 8x13 font, used by the
+ * {@link FontBitmap} catalogue at module load time.
+ *
+ * @internal
+ */
+export const metadata = {
+  /** Catalogue name. */
+  name: FONT_8x13_NAME,
+  /** Cell width including spacing (8 + 1 = 9). */
+  width: FONT_8x13_WIDTH + FONT_8x13_SPACING,
+  /** Cell height (13). */
+  height: FONT_8x13_HEIGHT,
+  /** Inter-glyph spacing (1). */
+  spacing: FONT_8x13_SPACING,
+  /** Supported character string. */
+  chars: FONT_8x13_CHARS,
+  /** Glyph bitmask data. */
+  data: FONT_8x13,
+};
+
+export default FONT_8x13;