@dryanovski/gamefoo 0.2.1 → 0.2.5

package/dist/core/fonts/internal/font_5x5.js

@@ -0,0 +1,129 @@
+/**
+ * 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 = {
+    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/dist/core/fonts/internal/font_6x8.js

@@ -0,0 +1,171 @@
+/**
+ * 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 = {
+    "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/dist/core/fonts/internal/font_8x13.js

@@ -0,0 +1,171 @@
+/**
+ * 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 = {
+    "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;

package/dist/core/fonts/internal/font_8x8.js

@@ -0,0 +1,171 @@
+/**
+ * Built-in 8x8 pixel bitmap font.
+ *
+ * Each character is a 8-pixel-wide, 8-pixel-tall glyph stored as an
+ * array of 8 integers. Each integer is a bitmask where bit 7
+ * (MSB) corresponds to the leftmost pixel and bit 0 to the rightmost.
+ *
+ * Chunky square glyphs, ideal at 2× or 4× scale.
+ *
+ * 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_8x8 from "./font_8x8";
+ *
+ * const letterA = FONT_8x8["A"];
+ * // 24, 36, 66, 66, 126, 66, 66, 0
+ * ```
+ */
+/** Catalogue name used by {@link FontBitmap} to look up this font. */
+export const FONT_8x8_NAME = "8x8";
+/**
+ * Glyph width in pixels (excluding spacing).
+ * @defaultValue `8`
+ */
+export const FONT_8x8_WIDTH = 8;
+/**
+ * Glyph height in pixels.
+ * @defaultValue `8`
+ */
+export const FONT_8x8_HEIGHT = 8;
+/**
+ * Horizontal spacing between glyphs in pixels.
+ * @defaultValue `1`
+ */
+export const FONT_8x8_SPACING = 1;
+/**
+ * Complete set of supported characters as a single string.
+ */
+export const FONT_8x8_CHARS = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz !?.,:;-+*/\\()[]{}<>=#%&@^_'\"`~|$";
+/**
+ * Glyph data keyed by character.
+ *
+ * Each value is a 8-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_8x8 = {
+    "0": [60, 66, 70, 74, 82, 98, 60, 0],
+    "1": [24, 56, 24, 24, 24, 24, 126, 0],
+    "2": [60, 66, 2, 12, 48, 64, 126, 0],
+    "3": [126, 2, 4, 28, 2, 2, 124, 0],
+    "4": [4, 12, 20, 36, 68, 254, 4, 0],
+    "5": [254, 128, 252, 2, 2, 66, 60, 0],
+    "6": [62, 64, 128, 252, 130, 130, 124, 0],
+    "7": [254, 4, 8, 16, 32, 64, 128, 0],
+    "8": [60, 66, 66, 60, 66, 66, 60, 0],
+    "9": [60, 66, 66, 62, 2, 2, 60, 0],
+    A: [24, 36, 66, 66, 126, 66, 66, 0],
+    B: [252, 66, 66, 124, 66, 66, 252, 0],
+    C: [62, 64, 128, 128, 128, 64, 62, 0],
+    D: [248, 68, 66, 66, 66, 68, 248, 0],
+    E: [254, 128, 128, 252, 128, 128, 254, 0],
+    F: [254, 128, 128, 252, 128, 128, 128, 0],
+    G: [62, 64, 128, 142, 130, 66, 62, 0],
+    H: [66, 66, 66, 126, 66, 66, 66, 0],
+    I: [126, 24, 24, 24, 24, 24, 126, 0],
+    J: [62, 4, 4, 4, 132, 136, 112, 0],
+    K: [130, 132, 136, 240, 136, 132, 130, 0],
+    L: [128, 128, 128, 128, 128, 128, 254, 0],
+    M: [130, 198, 170, 146, 130, 130, 130, 0],
+    N: [130, 194, 162, 146, 138, 134, 130, 0],
+    O: [60, 66, 129, 129, 129, 66, 60, 0],
+    P: [252, 130, 130, 252, 128, 128, 128, 0],
+    Q: [60, 66, 129, 129, 133, 66, 61, 0],
+    R: [252, 130, 130, 252, 136, 132, 130, 0],
+    S: [62, 64, 128, 124, 2, 2, 252, 0],
+    T: [254, 16, 16, 16, 16, 16, 16, 0],
+    U: [130, 130, 130, 130, 130, 68, 56, 0],
+    V: [130, 130, 68, 68, 40, 40, 16, 0],
+    W: [130, 130, 130, 146, 170, 198, 130, 0],
+    X: [130, 68, 40, 16, 40, 68, 130, 0],
+    Y: [130, 68, 40, 16, 16, 16, 16, 0],
+    Z: [254, 4, 8, 16, 32, 64, 254, 0],
+    a: [0, 0, 60, 2, 62, 66, 62, 0],
+    b: [64, 64, 124, 66, 66, 66, 124, 0],
+    c: [0, 0, 62, 64, 64, 64, 62, 0],
+    d: [2, 2, 62, 66, 66, 66, 62, 0],
+    e: [0, 0, 60, 66, 126, 64, 62, 0],
+    f: [14, 16, 16, 62, 16, 16, 16, 0],
+    g: [0, 62, 66, 66, 62, 2, 60, 0],
+    h: [64, 64, 124, 66, 66, 66, 66, 0],
+    i: [16, 0, 48, 16, 16, 16, 62, 0],
+    j: [8, 0, 8, 8, 8, 72, 48, 0],
+    k: [64, 68, 72, 112, 72, 68, 66, 0],
+    l: [96, 32, 32, 32, 32, 32, 126, 0],
+    m: [0, 0, 218, 170, 170, 130, 130, 0],
+    n: [0, 0, 124, 66, 66, 66, 66, 0],
+    o: [0, 0, 60, 66, 66, 66, 60, 0],
+    p: [0, 124, 66, 66, 124, 64, 64, 0],
+    q: [0, 62, 66, 66, 62, 2, 2, 0],
+    r: [0, 0, 94, 96, 64, 64, 64, 0],
+    s: [0, 0, 62, 64, 60, 2, 124, 0],
+    t: [32, 32, 126, 32, 32, 34, 28, 0],
+    u: [0, 0, 66, 66, 66, 70, 58, 0],
+    v: [0, 0, 66, 66, 36, 40, 16, 0],
+    w: [0, 0, 130, 130, 146, 170, 68, 0],
+    x: [0, 0, 66, 36, 24, 36, 66, 0],
+    y: [0, 66, 66, 66, 62, 2, 60, 0],
+    z: [0, 0, 254, 4, 24, 96, 254, 0],
+    " ": [0, 0, 0, 0, 0, 0, 0, 0],
+    "!": [24, 24, 24, 24, 24, 0, 24, 0],
+    "?": [60, 66, 2, 4, 8, 0, 8, 0],
+    ".": [0, 0, 0, 0, 0, 48, 48, 0],
+    ",": [0, 0, 0, 0, 48, 48, 96, 0],
+    ":": [0, 24, 24, 0, 24, 24, 0, 0],
+    ";": [0, 24, 24, 0, 24, 24, 48, 0],
+    "-": [0, 0, 0, 254, 0, 0, 0, 0],
+    "+": [0, 16, 16, 254, 16, 16, 0, 0],
+    "*": [0, 130, 68, 56, 68, 130, 0, 0],
+    "/": [2, 4, 8, 16, 32, 64, 128, 0],
+    "\\": [128, 64, 32, 16, 8, 4, 2, 0],
+    "(": [12, 16, 32, 32, 32, 16, 12, 0],
+    ")": [48, 8, 4, 4, 4, 8, 48, 0],
+    "[": [120, 64, 64, 64, 64, 64, 120, 0],
+    "]": [30, 2, 2, 2, 2, 2, 30, 0],
+    "{": [30, 48, 16, 96, 16, 48, 30, 0],
+    "}": [120, 12, 8, 6, 8, 12, 120, 0],
+    "<": [4, 8, 16, 32, 16, 8, 4, 0],
+    ">": [32, 16, 8, 4, 8, 16, 32, 0],
+    "=": [0, 0, 254, 0, 254, 0, 0, 0],
+    "#": [36, 36, 254, 36, 254, 36, 36, 0],
+    "%": [194, 196, 8, 16, 32, 67, 131, 0],
+    "&": [56, 68, 72, 48, 74, 68, 58, 0],
+    "@": [60, 66, 157, 165, 158, 64, 60, 0],
+    "^": [16, 40, 68, 130, 0, 0, 0, 0],
+    _: [0, 0, 0, 0, 0, 0, 254, 0],
+    "'": [24, 24, 48, 0, 0, 0, 0, 0],
+    '"': [72, 72, 0, 0, 0, 0, 0, 0],
+    "`": [48, 24, 8, 0, 0, 0, 0, 0],
+    "~": [0, 70, 137, 144, 0, 0, 0, 0],
+    "|": [24, 24, 24, 24, 24, 24, 24, 0],
+    $: [24, 62, 96, 60, 6, 124, 24, 0],
+};
+/**
+ * Complete metadata object for the 8x8 font, used by the
+ * {@link FontBitmap} catalogue at module load time.
+ *
+ * @internal
+ */
+export const metadata = {
+    /** Catalogue name. */
+    name: FONT_8x8_NAME,
+    /** Cell width including spacing (8 + 1 = 9). */
+    width: FONT_8x8_WIDTH + FONT_8x8_SPACING,
+    /** Cell height (8). */
+    height: FONT_8x8_HEIGHT,
+    /** Inter-glyph spacing (1). */
+    spacing: FONT_8x8_SPACING,
+    /** Supported character string. */
+    chars: FONT_8x8_CHARS,
+    /** Glyph bitmask data. */
+    data: FONT_8x8,
+};
+export default FONT_8x8;