@micahdb/tscon 0.0.0-stage → 0.1.0

package/dist/colour.js

@@ -0,0 +1,77 @@
+/**
+ * Indices into the 16-entry terminal {@link PALETTE}.
+ *
+ * The palette is split into eight "dark" colours (0..7) and eight "bright"
+ * colours (8..15). Glyph text encodes a foreground and background colour as
+ * 4-bit values, the high bit of which selects the bright half of the palette.
+ *
+ * Use these members with the `Colour` escape sequences understood by
+ * {@link textGlyphs} (`\fX`, `\FX`, `\bX`, `\BX`) and as the `fg`/`bg`
+ * indices when building glyphs programmatically.
+ *
+ * @example
+ * ```ts
+ * import { Colour } from "@micahdb/tscon";
+ *
+ * // bright-blue foreground on black background
+ * const text = "\\F4\\b0Link";
+ * ```
+ */
+export var Colour;
+(function (Colour) {
+    // palette indices
+    Colour[Colour["BLACK"] = 0] = "BLACK";
+    Colour[Colour["RED"] = 1] = "RED";
+    Colour[Colour["GREEN"] = 2] = "GREEN";
+    Colour[Colour["ORANGE"] = 3] = "ORANGE";
+    Colour[Colour["BLUE"] = 4] = "BLUE";
+    Colour[Colour["MAGENTA"] = 5] = "MAGENTA";
+    Colour[Colour["CYAN"] = 6] = "CYAN";
+    Colour[Colour["GREY"] = 7] = "GREY";
+    Colour[Colour["BRIGHT_BLACK"] = 8] = "BRIGHT_BLACK";
+    Colour[Colour["BRIGHT_RED"] = 9] = "BRIGHT_RED";
+    Colour[Colour["BRIGHT_GREEN"] = 10] = "BRIGHT_GREEN";
+    Colour[Colour["YELLOW"] = 11] = "YELLOW";
+    Colour[Colour["BRIGHT_BLUE"] = 12] = "BRIGHT_BLUE";
+    Colour[Colour["BRIGHT_MAGENTA"] = 13] = "BRIGHT_MAGENTA";
+    Colour[Colour["BRIGHT_CYAN"] = 14] = "BRIGHT_CYAN";
+    Colour[Colour["WHITE"] = 15] = "WHITE";
+})(Colour || (Colour = {}));
+/**
+ * The 16-colour terminal palette as flat 8-bit-per-channel RGB bytes.
+ *
+ * The array contains 48 entries: 16 colours of three bytes each, ordered to
+ * match the {@link Colour} enum. Each triplet is an `[R, G, B]` value in the
+ * range `0x00`-`0xff`.
+ *
+ * The first eight entries are the dark colours ({@link Colour.BLACK} ..
+ * {@link Colour.GREY}) and the last eight are the bright colours
+ * ({@link Colour.BRIGHT_BLACK} .. {@link Colour.WHITE}).
+ *
+ * @example
+ * ```ts
+ * import { Colour, PALETTE } from "@micahdb/tscon";
+ *
+ * const [r, g, b] = PALETTE.slice(Colour.BLUE * 3, Colour.BLUE * 3 + 3);
+ * ```
+ */
+export const PALETTE = [
+    // dark colours
+    0x08, 0x08, 0x08, // Colour.BLACK
+    0xed, 0x33, 0x3b, // Colour.RED
+    0x57, 0xe3, 0x89, // Colour.GREEN
+    0xff, 0x78, 0x00, // Colour.ORANGE
+    0x62, 0xa0, 0xea, // Colour.BLUE
+    0x91, 0x41, 0xac, // Colour.MAGENTA
+    0x5b, 0xc8, 0xaf, // Colour.CYAN
+    0xc0, 0xc0, 0xc0, // Colour.GREY
+    // bright colours
+    0x80, 0x80, 0x80, // Colour.BRIGHT_BLACK
+    0xf6, 0x61, 0x51, // Colour.BRIGHT_RED
+    0x8f, 0xf0, 0xa4, // Colour.BRIGHT_GREEN
+    0xff, 0xa3, 0x48, // Colour.YELLOW
+    0x99, 0xc1, 0xf1, // Colour.BRIGHT_BLUE
+    0xdc, 0x8a, 0xdd, // Colour.BRIGHT_MAGENTA
+    0x93, 0xdd, 0xc2, // Colour.BRIGHT_CYAN
+    0xf4, 0xf4, 0xf4 // Colour.WHITE
+];

package/dist/cp437.d.ts

@@ -0,0 +1,48 @@
+/**
+ * The 256 characters of IBM Code Page 437, as a string indexed by code.
+ *
+ * Index 0 is a blank (the CP437 NUL is unused) and index 255 is also treated
+ * as blank; all other indices 1..254 map to the corresponding CP437 glyph.
+ * This is the character set tscon's bitmap font covers and that
+ * {@link textGlyphs} encodes glyphs in.
+ *
+ * NOTE: chars at 0 and 255 are ignored.
+ */
+export declare const CP437_CHARS = " \u263A\u263B\u2665\u2666\u2663\u2660\u2022\u25D8\u25CB\u25D9\u2642\u2640\u266A\u266B\u263C\u25BA\u25C4\u2195\u203C\u00B6\u00A7\u25AC\u21A8\u2191\u2193\u2192\u2190\u221F\u2194\u25B2\u25BC !\"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\\]^_`abcdefghijklmnopqrstuvwxyz{|}~\u2302\u00C7\u00FC\u00E9\u00E2\u00E4\u00E0\u00E5\u00E7\u00EA\u00EB\u00E8\u00EF\u00EE\u00EC\u00C4\u00C5\u00C9\u00E6\u00C6\u00F4\u00F6\u00F2\u00FB\u00F9\u00FF\u00D6\u00DC\u00A2\u00A3\u00A5\u20A7\u0192\u00E1\u00ED\u00F3\u00FA\u00F1\u00D1\u00AA\u00BA\u00BF\u2310\u00AC\u00BD\u00BC\u00A1\u00AB\u00BB\u2591\u2592\u2593\u2502\u2524\u2561\u2562\u2556\u2555\u2563\u2551\u2557\u255D\u255C\u255B\u2510\u2514\u2534\u252C\u251C\u2500\u253C\u255E\u255F\u255A\u2554\u2569\u2566\u2560\u2550\u256C\u2567\u2568\u2564\u2565\u2559\u2558\u2552\u2553\u256B\u256A\u2518\u250C\u2588\u2584\u258C\u2590\u2580\u03B1\u00DF\u0393\u03C0\u03A3\u03C3\u00B5\u03C4\u03A6\u0398\u03A9\u03B4\u221E\u03C6\u03B5\u2229\u2261\u00B1\u2265\u2264\u2320\u2321\u00F7\u2248\u00B0\u2219\u00B7\u221A\u207F\u00B2\u25A0 ";
+/**
+ * Map a Unicode code point to its CP437 index, or `0` if not representable.
+ *
+ * Characters in {@link CP437_CHARS} are mapped to their index (1..254); any
+ * code point above the maximum one present in CP437 (or otherwise absent)
+ * returns `0` (blank). This is used internally by {@link textGlyphs} when
+ * encoding characters into glyphs.
+ *
+ * @param code_point  The Unicode code point to look up.
+ * @returns           The CP437 index (1..254), or `0` if not representable.
+ */
+export declare function charCodeInCp437(code_point: number): number;
+/**
+ * Render the CP437 character set onto a 2D canvas for use as a font texture.
+ *
+ * Loads the given `font` CSS string via the Font Loading API, measures an
+ * `"A"` glyph to determine per-cell dimensions, then paints all 255 CP437
+ * glyphs into a 32-column x 8-row grid on the supplied `canvas` (white on
+ * black). Box-drawing characters are replaced with `"@"` placeholders so
+ * they are not double-drawn; tscon's built-in bitmap font is used for those.
+ *
+ * The resulting canvas is intended to be captured (e.g. via `toDataURL` or a
+ * WebGL texture upload) to produce an application-provided font texture that
+ * can be assigned to {@link Canvas.user_font}.
+ *
+ * @example
+ * ```ts
+ * import { renderCp437 } from "@micahdb/tscon";
+ *
+ * const canvas = document.getElementById("2d") as HTMLCanvasElement;
+ * await renderCp437(canvas, "160px 'JetBrains Mono'");
+ * ```
+ *
+ * @param canvas  The 2D canvas to render onto. Its `width`/`height` are set.
+ * @param font    A CSS font string used to render the glyphs.
+ */
+export declare function renderCp437(canvas: HTMLCanvasElement, font: string): Promise<void>;

package/dist/cp437.js

@@ -0,0 +1,124 @@
+/*
+╔═══════════ Code Page 437 ══════════╗
+║                                    ║
+║   ☺☻♥♦♣♠•◘○◙♂♀♪♫☼►◄↕‼¶§▬↨↑↓→←∟↔▲▼  ║
+║   !"#$%&'()*+,-./0123456789:;<=>?  ║
+║  @ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_  ║
+║  `abcdefghijklmnopqrstuvwxyz{|}~⌂  ║
+║  ÇüéâäàåçêëèïîìÄÅÉæÆôöòûùÿÖÜ¢£¥₧ƒ  ║
+║  áíóúñѪº¿⌐¬½¼¡«»░▒▓│┤╡╢╖╕╣║╗╝╜╛┐  ║
+║  └┴┬├─┼╞╟╚╔╩╦╠═╬╧╨╤╥╙╘╒╓╫╪┘┌█▄▌▐▀  ║
+║  αßΓπΣσµτΦΘΩδ∞φε∩≡±≥≤⌠⌡÷≈°∙·√ⁿ²■   ║
+║                                    ║
+╚════════════════════════════════════╝
+*/
+/**
+ * The 256 characters of IBM Code Page 437, as a string indexed by code.
+ *
+ * Index 0 is a blank (the CP437 NUL is unused) and index 255 is also treated
+ * as blank; all other indices 1..254 map to the corresponding CP437 glyph.
+ * This is the character set tscon's bitmap font covers and that
+ * {@link textGlyphs} encodes glyphs in.
+ *
+ * NOTE: chars at 0 and 255 are ignored.
+ */
+export const CP437_CHARS = `\
+ ☺☻♥♦♣♠•◘○◙♂♀♪♫☼►◄↕‼¶§▬↨↑↓→←∟↔▲▼\
+ !"#$%&'()*+,-./0123456789:;<=>?\
+@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\\]^_\
+\`abcdefghijklmnopqrstuvwxyz{|}~⌂\
+ÇüéâäàåçêëèïîìÄÅÉæÆôöòûùÿÖÜ¢£¥₧ƒ\
+áíóúñѪº¿⌐¬½¼¡«»░▒▓│┤╡╢╖╕╣║╗╝╜╛┐\
+└┴┬├─┼╞╟╚╔╩╦╠═╬╧╨╤╥╙╘╒╓╫╪┘┌█▄▌▐▀\
+αßΓπΣσµτΦΘΩδ∞φε∩≡±≥≤⌠⌡÷≈°∙·√ⁿ²■ `;
+let max_code_point = 0;
+for (let i = 1; i < 255; i++) {
+    const code_point = CP437_CHARS.codePointAt(i);
+    if (code_point > max_code_point) {
+        max_code_point = code_point;
+    }
+}
+const CP437_MAX_CODE_POINT = max_code_point;
+// map from any character code point <= CP437_MAX_CODE_POINT to index in CP437
+const CP437_MAP = new Uint8Array(CP437_MAX_CODE_POINT + 1);
+// populate CP437_MAP
+for (let i = 1; i < 255; i++) {
+    const code_point = CP437_CHARS.codePointAt(i);
+    CP437_MAP[code_point] = i;
+}
+/**
+ * Map a Unicode code point to its CP437 index, or `0` if not representable.
+ *
+ * Characters in {@link CP437_CHARS} are mapped to their index (1..254); any
+ * code point above the maximum one present in CP437 (or otherwise absent)
+ * returns `0` (blank). This is used internally by {@link textGlyphs} when
+ * encoding characters into glyphs.
+ *
+ * @param code_point  The Unicode code point to look up.
+ * @returns           The CP437 index (1..254), or `0` if not representable.
+ */
+export function charCodeInCp437(code_point) {
+    if (code_point > CP437_MAX_CODE_POINT) {
+        return 0;
+    }
+    return CP437_MAP[code_point];
+}
+/**
+ * Render the CP437 character set onto a 2D canvas for use as a font texture.
+ *
+ * Loads the given `font` CSS string via the Font Loading API, measures an
+ * `"A"` glyph to determine per-cell dimensions, then paints all 255 CP437
+ * glyphs into a 32-column x 8-row grid on the supplied `canvas` (white on
+ * black). Box-drawing characters are replaced with `"@"` placeholders so
+ * they are not double-drawn; tscon's built-in bitmap font is used for those.
+ *
+ * The resulting canvas is intended to be captured (e.g. via `toDataURL` or a
+ * WebGL texture upload) to produce an application-provided font texture that
+ * can be assigned to {@link Canvas.user_font}.
+ *
+ * @example
+ * ```ts
+ * import { renderCp437 } from "@micahdb/tscon";
+ *
+ * const canvas = document.getElementById("2d") as HTMLCanvasElement;
+ * await renderCp437(canvas, "160px 'JetBrains Mono'");
+ * ```
+ *
+ * @param canvas  The 2D canvas to render onto. Its `width`/`height` are set.
+ * @param font    A CSS font string used to render the glyphs.
+ */
+export async function renderCp437(canvas, font) {
+    await document.fonts.load(font);
+    const ctx = canvas.getContext("2d");
+    ctx.font = font;
+    const metrics = ctx.measureText("A");
+    const padding = 1; // px
+    const glyph_width = metrics.width + 2 * padding;
+    const glyph_height = 2 * metrics.width + 2 * padding;
+    const ascent = Math.ceil(metrics.fontBoundingBoxAscent);
+    const cols = 32;
+    const rows = 8;
+    canvas.width = glyph_width * cols;
+    canvas.height = glyph_height * rows;
+    // fill canvas with black first
+    ctx.fillStyle = "black";
+    ctx.fillRect(0, 0, canvas.width, canvas.height);
+    // reset these
+    ctx.font = font;
+    ctx.fillStyle = "white";
+    // don't want to draw box drawing characters;
+    // the moderndos font will be used for these
+    const box_drawing = "░▒▓│┤╡╢╖╕╣║╗╝╜╛┐└┴┬├─┼╞╟╚╔╩╦╠═╬╧╨╤╥╙╘╒╓╫╪┘┌█▄▌▐▀";
+    const chars = CP437_CHARS.replace(box_drawing, "@".repeat(box_drawing.length));
+    // render all glyphs
+    for (let i = 1; i < 255; i++) {
+        const x = (i % cols) * glyph_width;
+        const y = Math.floor(i / cols) * glyph_height;
+        ctx.save();
+        ctx.beginPath();
+        ctx.rect(x + padding, y + padding, glyph_width - 2 * padding, glyph_height - 2 * padding);
+        ctx.clip();
+        ctx.fillText(chars.slice(i, i + 1), x + padding, y + ascent + padding);
+        ctx.restore();
+    }
+}

package/dist/glyphs.d.ts

@@ -0,0 +1,222 @@
+/**
+ * Number of columns a tab advances the cursor by.
+ *
+ * Tabs in text processed by {@link textToLines} and {@link textGlyphs}
+ * advance the column position to the next multiple of this width.
+ */
+export declare const TAB_WIDTH = 8;
+/**
+ * Layout `text` into lines no wider than `cols` columns.
+ *
+ * This is the line-breaking pass used by {@link textGlyphs}. It interprets
+ * the tscon text escape sequences so they are not counted against the
+ * column budget, and returns the raw visible content of each line as a
+ * string (still containing the escape codes for later processing).
+ *
+ * The following escape sequences are recognised and treated as taking up
+ * zero columns:
+ *
+ * - `\\` -- a literal backslash (collapses to one displayed char)
+ * - `\aX` and `\aX{options}` -- an anchor in group `X` (0-9), with an
+ *   optional `{...}` options string
+ * - `\fX` / `\FX` -- set foreground to colour `X` (dark / bright)
+ * - `\bX` / `\BX` -- set background to colour `X` (dark / bright)
+ *
+ * Newlines always break the line. A backslash immediately followed by a
+ * newline is a line continuation: the two characters are removed and the
+ * following content joins the current line. Tabs advance to the next
+ * multiple of {@link TAB_WIDTH}.
+ *
+ * When `wrap` is `true`, lines longer than `cols` are wrapped at the most
+ * recent space (or broken mid-word if a single word fills a whole line).
+ * When `wrap` is `false`, lines longer than `cols` are truncated at the
+ * end of the line and the rest of that logical line is discarded.
+ *
+ * @example
+ * ```ts
+ * import { textToLines } from "@micahdb/tscon";
+ *
+ * textToLines("hello world", 80, true);   // ["hello world"]
+ * ```
+ *
+ * @param text  The text to lay out, possibly with escape sequences.
+ * @param cols  Maximum number of visible columns per line. If `<= 0`, an
+ *              empty array is returned.
+ * @param wrap  Whether to word-wrap long lines (`true`) or truncate them
+ *              (`false`).
+ * @returns     The laid-out visible lines, with escape sequences preserved.
+ */
+export declare function textToLines(text: string, cols: number, wrap: boolean): string[];
+/**
+ * A named position inside a {@link Glyphs} block, produced by an `\aX`
+ * anchor escape sequence in the source text.
+ *
+ * Anchors are grouped by the single digit `X` (0-9) following the `\a`
+ * escape, and the position recorded is the row/column of the glyph the
+ * anchor precedes. The optional `{...}` payload becomes {@link options}.
+ *
+ * They are how the text format marks interactive or navigable points
+ * (links, section headings, image placements, etc.) that the application
+ * can later find and render -- for example link text + URL or a section hash.
+ */
+export type Anchor = {
+    /**
+     * The text inside the anchor's optional `{...}` payload, or `null` if
+     * the anchor had no payload (or an empty payload, which is treated as
+     * `null`). Conventions like `"text|url"` are defined by the caller.
+     */
+    options: string | null;
+    /** Row (y) of the anchor within the glyph grid. */
+    row: number;
+    /** Column (x) of the anchor within the glyph grid. */
+    col: number;
+};
+/**
+ * A grid of pre-rendered terminal glyphs produced by {@link textGlyphs}.
+ *
+ * Each cell is a single 16-bit value packing a CP437 character code in the
+ * low byte and a 4-bit foreground / 4-bit background colour pair in the
+ * high byte: `[ fg (4) | bg (4) | char_code (8) ]`. Colours are indices into
+ * {@link PALETTE} (see {@link Colour}). Cells that are blank (a space on
+ * the default black-on-black colour) are left as zero.
+ *
+ * `data` is laid out row-major with `rows * cols` entries, so the glyph at
+ * `(row, col)` is at index `row * cols + col`.
+ *
+ * {@link anchors} records the positions of every `\aX` anchor found while
+ * rendering, keyed by group number 0-9.
+ *
+ * Pass a `Glyphs` to {@link Terminal.blit} to copy it onto the console's
+ * framebuffer.
+ */
+export type Glyphs = {
+    /** Packed glyph data, length `rows * cols`, row-major. */
+    data: Uint16Array;
+    /** Number of rows in the grid. */
+    rows: number;
+    /** Number of columns in the grid. */
+    cols: number;
+    /**
+     * Anchors keyed by group number (0-9). Each value is the list of
+     * anchors in that group, in the order they appear in the text.
+     */
+    anchors: Record<number, Anchor[]>;
+};
+/**
+ * Render `text` into a grid of terminal glyphs `cols` wide.
+ *
+ * This is the primary text-rendering entry point. It runs {@link textToLines}
+ * to lay the text out, then encodes each visible character as a packed
+ * 16-bit glyph (CP437 code + colour pair) into the resulting {@link Glyphs}.
+ *
+ * The escape sequences understood by the text format are interpreted here:
+ *
+ * - `\\` -- emits a single literal backslash
+ * - `\aX` / `\aX{options}` -- records an anchor in group `X` (0-9) at the
+ *   current position, with optional `options` string (see {@link Anchor})
+ * - `\fX` / `\FX` -- set foreground colour to `X` (dark / bright)
+ * - `\bX` / `\BX` -- set background colour to `X` (dark / bright)
+ *
+ * Colours `X` are clamped to 0-7; the `F`/`B` (capital) variants add 8 to
+ * select the bright half of the palette. The initial foreground is
+ * {@link Colour.WHITE} and the initial background is {@link Colour.BLACK}.
+ *
+ * Tabs advance the column to the next multiple of {@link TAB_WIDTH} but
+ * do not emit anything. Characters outside the CP437 range map to 0
+ * (blank), and trailing space on the default colour is left as zero so it
+ * does not overwrite whatever is already on the console.
+ *
+ * @example
+ * ```ts
+ * import { textGlyphs } from "@micahdb/tscon";
+ *
+ * // bright-blue on black "Link", 4 cols wide
+ * const g = textGlyphs("\\F4\\b0Link", 4, false);
+ * ```
+ *
+ * @param text  The text to render, with escape sequences.
+ * @param cols  Width of the grid in cells. If `<= 0`, an empty grid is
+ *              returned.
+ * @param wrap  Whether to word-wrap long lines (`true`) or truncate them
+ *              (`false`).
+ * @returns     The rendered glyph grid, with anchors populated.
+ */
+export declare function textGlyphs(text: string, cols: number, wrap: boolean): Glyphs;
+/**
+ * How each cell of a {@link TexGlyphs} grid samples its source texture.
+ *
+ * The value is packed into each texture-glyph and read by the renderer's
+ * vertex shader to decide, per cell, how to turn the source texture into a
+ * drawn glyph.
+ *
+ * - `SAMPLE`    -- render the source texture directly. Each cell is given UV
+ *                  coordinates into the texture, so the full rendered region
+ *                  simply shows the source texture as-is.
+ * - `GLYPHS`    -- sample the texture and convert it to a glyph: the
+ *                  character is chosen by the sample's brightness and the
+ *                  colour by dithering (Bayer matrix + nearest palette hue).
+ *                  The background stays black. Preferred when you want the
+ *                  texture rendered as coloured characters without it being
+ *                  too bright or jarring.
+ * - `BG_GLYPHS` -- like `GLYPHS`, but also sets the background colour, so
+ *                  the full glyph (foreground + background) carries more of
+ *                  the sample's colour. This is noticeably brighter and more
+ *                  visually accurate; use it when no text is drawn on top of
+ *                  the rendered texture.
+ * - `MIX`       -- alternate `SAMPLE`/`GLYPHS` in a checkerboard pattern.
+ * - `ROWS`      -- alternate `SAMPLE`/`GLYPHS` by row.
+ * - `COLS`      -- alternate `SAMPLE`/`GLYPHS` by column.
+ */
+export declare enum TexGlyphMode {
+    SAMPLE = 0,
+    GLYPHS = 1,
+    BG_GLYPHS = 2,
+    MIX = 3,
+    ROWS = 4,
+    COLS = 5
+}
+/**
+ * A grid of texture-sampling descriptors produced by {@link textureGlyphs}
+ * and consumed by {@link Renderer.draw}.
+ *
+ * Each cell is a 32-bit value packing the cell's row, its {@link TexGlyphMode},
+ * and its column: `[ row (8) | mode (8) | col (16) ]`.
+ *
+ * `data` is laid out row-major with `rows * cols` entries.
+ */
+export type TexGlyphs = {
+    /** Packed texture-glyph data, length `rows * cols`, row-major. */
+    data: Uint32Array;
+    /** Number of rows in the grid. */
+    rows: number;
+    /** Number of columns in the grid. */
+    cols: number;
+};
+/**
+ * Build a {@link TexGlyphs} grid of `rows` by `cols` cells that samples a
+ * texture in the given {@link TexGlyphMode}.
+ *
+ * The grid is sized to match a region of the terminal (typically the whole
+ * canvas, `canvas.rows` x `canvas.cols`, or a smaller sub-region) and is
+ * passed to {@link Renderer.draw} along with the texture to display.
+ *
+ * For the `MIX`, `ROWS`, and `COLS` modes the requested `mode` is used as a
+ * base and individual cells are switched between `SAMPLE` and `GLYPHS`
+ * according to the pattern (see {@link TexGlyphMode} for what each mode does
+ * to the sampled texture). The packed per-cell value encodes the cell's own
+ * row/column and the (possibly per-cell) effective mode.
+ *
+ * @example
+ * ```ts
+ * import { TexGlyphMode, textureGlyphs } from "@micahdb/tscon";
+ *
+ * // whole-canvas glyphs that sample the texture as coloured characters
+ * const tg = textureGlyphs(canvas.rows, canvas.cols, TexGlyphMode.GLYPHS);
+ * ```
+ *
+ * @param rows  Height of the grid in cells.
+ * @param cols  Width of the grid in cells.
+ * @param mode  Sampling mode to apply to the cells.
+ * @returns     The packed texture-glyph grid.
+ */
+export declare function textureGlyphs(rows: number, cols: number, mode: TexGlyphMode): TexGlyphs;