@termaxjs/editor-canvas 0.1.1

package/dist/GlyphAtlas.js

@@ -0,0 +1,158 @@
+/**
+ * Measure width and height for a monospace font in the browser.
+ */
+export function measureMonospaceFont(fontFamily, fontSize, lineHeightRatio = 1.5) {
+    if (typeof document === "undefined") {
+        // SSR / Node fallback
+        const charWidth = Math.round(fontSize * 0.6);
+        const lineHeight = Math.round(fontSize * lineHeightRatio);
+        return { charWidth, lineHeight };
+    }
+    const canvas = document.createElement("canvas");
+    const ctx = canvas.getContext("2d");
+    if (!ctx) {
+        const charWidth = Math.round(fontSize * 0.6);
+        const lineHeight = Math.round(fontSize * lineHeightRatio);
+        return { charWidth, lineHeight };
+    }
+    const font = `${fontSize}px ${fontFamily}`;
+    ctx.font = font;
+    const metrics = ctx.measureText("M");
+    const charWidth = Math.max(1, metrics.width);
+    const lineHeight = Math.round(fontSize * lineHeightRatio);
+    return { charWidth, lineHeight };
+}
+/**
+ * Bitmap glyph atlas to accelerate monospace rendering on Canvas.
+ */
+export class GlyphAtlas {
+    canvas = null;
+    ctx = null;
+    glyphMap = new Map();
+    font = "";
+    charWidth = 0;
+    lineHeight = 0;
+    dpr = 1;
+    curX = 0;
+    curY = 0;
+    cellW = 0;
+    cellH = 0;
+    constructor(fontFamily, fontSize, dpr = 1, charWidth, lineHeight) {
+        this.dpr = dpr;
+        this.font = `${fontSize}px ${fontFamily}`;
+        const m = measureMonospaceFont(fontFamily, fontSize);
+        this.charWidth = charWidth && charWidth > 0 ? charWidth : m.charWidth;
+        this.lineHeight = lineHeight && lineHeight > 0 ? lineHeight : m.lineHeight;
+        this.cellW = Math.ceil(this.charWidth * this.dpr);
+        this.cellH = Math.ceil(this.lineHeight * this.dpr);
+        this.initAtlas();
+    }
+    initAtlas() {
+        if (typeof document === "undefined" && typeof OffscreenCanvas === "undefined") {
+            return;
+        }
+        const atlasWidth = 1024 * this.dpr;
+        const atlasHeight = 512 * this.dpr;
+        if (typeof OffscreenCanvas !== "undefined") {
+            this.canvas = new OffscreenCanvas(atlasWidth, atlasHeight);
+            this.ctx = this.canvas.getContext("2d");
+        }
+        else if (typeof document !== "undefined") {
+            const c = document.createElement("canvas");
+            c.width = atlasWidth;
+            c.height = atlasHeight;
+            this.canvas = c;
+            this.ctx = c.getContext("2d");
+        }
+        if (this.ctx) {
+            this.ctx.font = `${Math.round(this.cellH * 0.7)}px monospace`;
+            this.ctx.textBaseline = "top";
+        }
+    }
+    /**
+     * Pre-warm the atlas with ASCII characters for a set of theme colors.
+     */
+    prewarm(colors) {
+        if (!this.ctx || !this.canvas)
+            return;
+        for (const color of colors) {
+            if (!color)
+                continue;
+            for (let code = 32; code <= 126; code++) {
+                const char = String.fromCharCode(code);
+                this.cacheGlyph(char, color);
+            }
+        }
+    }
+    cacheGlyph(char, color) {
+        if (!this.ctx || !this.canvas)
+            return null;
+        const key = `${char}:${color}`;
+        const existing = this.glyphMap.get(key);
+        if (existing)
+            return existing;
+        if (this.curX + this.cellW > this.canvas.width) {
+            this.curX = 0;
+            this.curY += this.cellH;
+        }
+        if (this.curY + this.cellH > this.canvas.height) {
+            // Atlas capacity reached
+            return null;
+        }
+        const x = this.curX;
+        const y = this.curY;
+        this.ctx.fillStyle = color;
+        this.ctx.fillText(char, x, y);
+        const loc = {
+            x,
+            y,
+            width: this.cellW,
+            height: this.cellH,
+        };
+        this.glyphMap.set(key, loc);
+        this.curX += this.cellW;
+        return loc;
+    }
+    getGlyph(char, color) {
+        const key = `${char}:${color}`;
+        const cached = this.glyphMap.get(key);
+        if (cached)
+            return cached;
+        return this.cacheGlyph(char, color);
+    }
+    /**
+     * Draw text on destination context using atlas when possible, falling back to fillText.
+     */
+    drawText(destCtx, text, color, x, y) {
+        if (!text)
+            return;
+        if (this.canvas && destCtx && typeof destCtx.drawImage === "function") {
+            let curX = x;
+            for (let i = 0; i < text.length; i++) {
+                const ch = text[i];
+                if (ch === " ") {
+                    curX += this.charWidth;
+                    continue;
+                }
+                const glyph = this.getGlyph(ch, color);
+                if (glyph) {
+                    destCtx.drawImage(this.canvas, glyph.x, glyph.y, glyph.width, glyph.height, curX, y, this.charWidth, this.lineHeight);
+                }
+                else {
+                    destCtx.fillStyle = color;
+                    destCtx.font = this.font;
+                    destCtx.textBaseline = "top";
+                    destCtx.fillText(ch, curX, y);
+                }
+                curX += this.charWidth;
+            }
+            return;
+        }
+        // Fallback path when atlas is unavailable
+        destCtx.fillStyle = color;
+        destCtx.font = this.font;
+        destCtx.textBaseline = "top";
+        destCtx.fillText(text, x, y);
+    }
+}
+//# sourceMappingURL=GlyphAtlas.js.map

package/dist/GlyphAtlas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GlyphAtlas.js","sourceRoot":"","sources":["../src/GlyphAtlas.ts"],"names":[],"mappings":"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"}

package/dist/KineticScroller.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Kinetic Momentum Scroller with spring-damped physics.
+ * Provides high-refresh (120Hz/144Hz) trackpad momentum interpolation.
+ */
+export interface KineticScrollState {
+    scrollTop: number;
+    scrollLeft: number;
+    maxScrollTop: number;
+    maxScrollLeft: number;
+}
+export interface KineticScrollerOptions {
+    friction?: number;
+    minVelocity?: number;
+    bounceFriction?: number;
+}
+export declare class KineticScroller {
+    private vx;
+    private vy;
+    private animId;
+    private readonly friction;
+    private readonly minVelocity;
+    private readonly bounceFriction;
+    private onUpdate;
+    private state;
+    constructor(options?: KineticScrollerOptions);
+    setState(state: Partial<KineticScrollState>): void;
+    setUpdateCallback(cb: (state: {
+        scrollTop: number;
+        scrollLeft: number;
+    }) => void): void;
+    /**
+     * Pushes a scroll impulse (e.g. from wheel event or touch drag release).
+     */
+    pushImpulse(deltaX: number, deltaY: number): void;
+    stop(): void;
+    isScrolling(): boolean;
+    private startLoop;
+}
+//# sourceMappingURL=KineticScroller.d.ts.map

package/dist/KineticScroller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KineticScroller.d.ts","sourceRoot":"","sources":["../src/KineticScroller.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,EAAE,CAAK;IACf,OAAO,CAAC,EAAE,CAAK;IACf,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAA6E;IAC7F,OAAO,CAAC,KAAK,CAKX;gBAEU,OAAO,GAAE,sBAA2B;IAMzC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,IAAI;IAIlD,iBAAiB,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,GAAG,IAAI;IAI9F;;OAEG;IACI,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAYjD,IAAI,IAAI,IAAI;IASZ,WAAW,IAAI,OAAO;IAQ7B,OAAO,CAAC,SAAS;CAiDlB"}

package/dist/KineticScroller.js

@@ -0,0 +1,102 @@
+/**
+ * Kinetic Momentum Scroller with spring-damped physics.
+ * Provides high-refresh (120Hz/144Hz) trackpad momentum interpolation.
+ */
+export class KineticScroller {
+    vx = 0;
+    vy = 0;
+    animId = null;
+    friction;
+    minVelocity;
+    bounceFriction;
+    onUpdate = null;
+    state = {
+        scrollTop: 0,
+        scrollLeft: 0,
+        maxScrollTop: 0,
+        maxScrollLeft: 0,
+    };
+    constructor(options = {}) {
+        this.friction = options.friction ?? 0.92;
+        this.minVelocity = options.minVelocity ?? 0.05;
+        this.bounceFriction = options.bounceFriction ?? 0.8;
+    }
+    setState(state) {
+        this.state = { ...this.state, ...state };
+    }
+    setUpdateCallback(cb) {
+        this.onUpdate = cb;
+    }
+    /**
+     * Pushes a scroll impulse (e.g. from wheel event or touch drag release).
+     */
+    pushImpulse(deltaX, deltaY) {
+        this.vx += deltaX;
+        this.vy += deltaY;
+        if (this.animId === null &&
+            (Math.abs(this.vx) > this.minVelocity || Math.abs(this.vy) > this.minVelocity)) {
+            this.startLoop();
+        }
+    }
+    stop() {
+        if (this.animId !== null && typeof cancelAnimationFrame !== "undefined") {
+            cancelAnimationFrame(this.animId);
+            this.animId = null;
+        }
+        this.vx = 0;
+        this.vy = 0;
+    }
+    isScrolling() {
+        return (this.animId !== null ||
+            Math.abs(this.vx) > this.minVelocity ||
+            Math.abs(this.vy) > this.minVelocity);
+    }
+    startLoop() {
+        const step = () => {
+            this.vx *= this.friction;
+            this.vy *= this.friction;
+            let nextTop = this.state.scrollTop + this.vy;
+            let nextLeft = this.state.scrollLeft + this.vx;
+            // Boundary clamping
+            if (nextTop < 0) {
+                nextTop = 0;
+                this.vy *= this.bounceFriction;
+            }
+            else if (nextTop > this.state.maxScrollTop) {
+                nextTop = this.state.maxScrollTop;
+                this.vy *= this.bounceFriction;
+            }
+            if (nextLeft < 0) {
+                nextLeft = 0;
+                this.vx *= this.bounceFriction;
+            }
+            else if (nextLeft > this.state.maxScrollLeft) {
+                nextLeft = this.state.maxScrollLeft;
+                this.vx *= this.bounceFriction;
+            }
+            this.state.scrollTop = nextTop;
+            this.state.scrollLeft = nextLeft;
+            if (this.onUpdate) {
+                this.onUpdate({ scrollTop: nextTop, scrollLeft: nextLeft });
+            }
+            if (Math.abs(this.vx) > this.minVelocity || Math.abs(this.vy) > this.minVelocity) {
+                if (typeof requestAnimationFrame !== "undefined") {
+                    this.animId = requestAnimationFrame(step);
+                }
+                else {
+                    this.animId = null;
+                }
+            }
+            else {
+                this.stop();
+            }
+        };
+        if (typeof requestAnimationFrame !== "undefined") {
+            this.animId = requestAnimationFrame(step);
+        }
+        else {
+            step();
+        }
+    }
+}
+//# sourceMappingURL=KineticScroller.js.map

package/dist/KineticScroller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"KineticScroller.js","sourceRoot":"","sources":["../src/KineticScroller.ts"],"names":[],"mappings":"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"}

package/dist/LigatureEngine.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Programming Font Ligature Engine.
+ * Detects multi-character ligature sequences and clusters them into unified glyph runs.
+ */
+export interface LigatureMatch {
+    start: number;
+    length: number;
+    text: string;
+}
+export declare const DEFAULT_LIGATURE_SEQUENCES: readonly string[];
+export declare class LigatureEngine {
+    private ligatures;
+    private maxLen;
+    constructor(sequences?: readonly string[]);
+    /**
+     * Scans a line or token string for ligature clusters.
+     */
+    findLigatures(text: string): LigatureMatch[];
+    /**
+     * Splits a string into segments of plain text and ligature clusters.
+     */
+    segmentText(text: string): Array<{
+        text: string;
+        isLigature: boolean;
+    }>;
+}
+//# sourceMappingURL=LigatureEngine.d.ts.map

package/dist/LigatureEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LigatureEngine.d.ts","sourceRoot":"","sources":["../src/LigatureEngine.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAGD,eAAO,MAAM,0BAA0B,EAAE,SAAS,MAAM,EA8BvD,CAAC;AAEF,qBAAa,cAAc;IACzB,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,MAAM,CAAS;gBAEX,SAAS,GAAE,SAAS,MAAM,EAA+B;IAKrE;;OAEG;IACI,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE;IA+BnD;;OAEG;IACI,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,OAAO,CAAA;KAAE,CAAC;CAgC/E"}

package/dist/LigatureEngine.js

@@ -0,0 +1,105 @@
+/**
+ * Programming Font Ligature Engine.
+ * Detects multi-character ligature sequences and clusters them into unified glyph runs.
+ */
+// Common programming ligature sequences ordered by length (longest first for greedy match)
+export const DEFAULT_LIGATURE_SEQUENCES = [
+    "<!--",
+    "-->",
+    "===",
+    "!==",
+    "...",
+    "::=",
+    "<=>",
+    "->",
+    "<-",
+    "=>",
+    "<=",
+    ">=",
+    "==",
+    "!=",
+    ":=",
+    "::",
+    "/*",
+    "*/",
+    "//",
+    "**",
+    "??",
+    "||",
+    "&&",
+    "++",
+    "--",
+    "<<",
+    ">>",
+    "|>",
+    "<|",
+];
+export class LigatureEngine {
+    ligatures;
+    maxLen;
+    constructor(sequences = DEFAULT_LIGATURE_SEQUENCES) {
+        this.ligatures = [...sequences].sort((a, b) => b.length - a.length);
+        this.maxLen = this.ligatures.reduce((max, s) => Math.max(max, s.length), 0);
+    }
+    /**
+     * Scans a line or token string for ligature clusters.
+     */
+    findLigatures(text) {
+        const matches = [];
+        const len = text.length;
+        let i = 0;
+        while (i < len) {
+            let matched = false;
+            const remaining = len - i;
+            const checkLen = Math.min(remaining, this.maxLen);
+            for (const seq of this.ligatures) {
+                if (seq.length <= checkLen && text.startsWith(seq, i)) {
+                    matches.push({
+                        start: i,
+                        length: seq.length,
+                        text: seq,
+                    });
+                    i += seq.length;
+                    matched = true;
+                    break;
+                }
+            }
+            if (!matched) {
+                i++;
+            }
+        }
+        return matches;
+    }
+    /**
+     * Splits a string into segments of plain text and ligature clusters.
+     */
+    segmentText(text) {
+        const matches = this.findLigatures(text);
+        if (matches.length === 0) {
+            return [{ text, isLigature: false }];
+        }
+        const segments = [];
+        let cur = 0;
+        for (const match of matches) {
+            if (match.start > cur) {
+                segments.push({
+                    text: text.slice(cur, match.start),
+                    isLigature: false,
+                });
+            }
+            segments.push({
+                text: match.text,
+                isLigature: true,
+            });
+            cur = match.start + match.length;
+        }
+        if (cur < text.length) {
+            segments.push({
+                text: text.slice(cur),
+                isLigature: false,
+            });
+        }
+        return segments;
+    }
+}
+//# sourceMappingURL=LigatureEngine.js.map

package/dist/LigatureEngine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LigatureEngine.js","sourceRoot":"","sources":["../src/LigatureEngine.ts"],"names":[],"mappings":"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"}

package/dist/WebGLGlyphAtlas.d.ts

@@ -0,0 +1,34 @@
+export interface WebGLGlyphUV {
+    u0: number;
+    v0: number;
+    u1: number;
+    v1: number;
+    width: number;
+    height: number;
+}
+/**
+ * GPU-friendly Texture Atlas for WebGL 2 / WebGPU instanced glyph and ligature rendering.
+ */
+export declare class WebGLGlyphAtlas {
+    private canvas;
+    private ctx;
+    private glyphMap;
+    charWidth: number;
+    lineHeight: number;
+    dpr: number;
+    readonly atlasWidth: number;
+    readonly atlasHeight: number;
+    private curX;
+    private curY;
+    private cellW;
+    private cellH;
+    private isDirty;
+    constructor(fontFamily: string, fontSize: number, dpr?: number, charWidth?: number, lineHeight?: number, atlasWidth?: number, atlasHeight?: number);
+    private initCanvas;
+    private prewarmAscii;
+    getOrRasterizeGlyph(char: string): WebGLGlyphUV | null;
+    getCanvasSource(): HTMLCanvasElement | OffscreenCanvas | null;
+    checkAndClearDirty(): boolean;
+    getGlyphUV(char: string): WebGLGlyphUV | null;
+}
+//# sourceMappingURL=WebGLGlyphAtlas.d.ts.map

package/dist/WebGLGlyphAtlas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebGLGlyphAtlas.d.ts","sourceRoot":"","sources":["../src/WebGLGlyphAtlas.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAoD;IAClE,OAAO,CAAC,GAAG,CAA6E;IACxF,OAAO,CAAC,QAAQ,CAAmC;IAC5C,SAAS,EAAE,MAAM,CAAK;IACtB,UAAU,EAAE,MAAM,CAAK;IACvB,GAAG,EAAE,MAAM,CAAK;IACvB,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,WAAW,EAAE,MAAM,CAAC;IACpC,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,OAAO,CAAkB;gBAG/B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,GAAG,SAAI,EACP,SAAS,CAAC,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,MAAM,EACnB,UAAU,SAAO,EACjB,WAAW,SAAO;IAgBpB,OAAO,CAAC,UAAU;IAmBlB,OAAO,CAAC,YAAY;IAMb,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAuCtD,eAAe,IAAI,iBAAiB,GAAG,eAAe,GAAG,IAAI;IAI7D,kBAAkB,IAAI,OAAO;IAM7B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;CAGrD"}

package/dist/WebGLGlyphAtlas.js

@@ -0,0 +1,99 @@
+import { measureMonospaceFont } from "./GlyphAtlas.js";
+/**
+ * GPU-friendly Texture Atlas for WebGL 2 / WebGPU instanced glyph and ligature rendering.
+ */
+export class WebGLGlyphAtlas {
+    canvas = null;
+    ctx = null;
+    glyphMap = new Map();
+    charWidth = 0;
+    lineHeight = 0;
+    dpr = 1;
+    atlasWidth;
+    atlasHeight;
+    curX = 0;
+    curY = 0;
+    cellW = 0;
+    cellH = 0;
+    isDirty = false;
+    constructor(fontFamily, fontSize, dpr = 1, charWidth, lineHeight, atlasWidth = 1024, atlasHeight = 1024) {
+        this.dpr = dpr;
+        this.atlasWidth = atlasWidth * dpr;
+        this.atlasHeight = atlasHeight * dpr;
+        const m = measureMonospaceFont(fontFamily, fontSize);
+        this.charWidth = charWidth && charWidth > 0 ? charWidth : m.charWidth;
+        this.lineHeight = lineHeight && lineHeight > 0 ? lineHeight : m.lineHeight;
+        this.cellW = Math.ceil(this.charWidth * this.dpr);
+        this.cellH = Math.ceil(this.lineHeight * this.dpr);
+        this.initCanvas(fontFamily, fontSize);
+        this.prewarmAscii();
+    }
+    initCanvas(fontFamily, fontSize) {
+        if (typeof OffscreenCanvas !== "undefined") {
+            this.canvas = new OffscreenCanvas(this.atlasWidth, this.atlasHeight);
+            this.ctx = this.canvas.getContext("2d");
+        }
+        else if (typeof document !== "undefined") {
+            const c = document.createElement("canvas");
+            c.width = this.atlasWidth;
+            c.height = this.atlasHeight;
+            this.canvas = c;
+            this.ctx = c.getContext("2d");
+        }
+        if (this.ctx) {
+            this.ctx.font = `${Math.round(fontSize * this.dpr)}px ${fontFamily}, monospace`;
+            this.ctx.textBaseline = "top";
+            this.ctx.fillStyle = "#ffffff";
+        }
+    }
+    prewarmAscii() {
+        for (let code = 32; code <= 126; code++) {
+            this.getOrRasterizeGlyph(String.fromCharCode(code));
+        }
+    }
+    getOrRasterizeGlyph(char) {
+        if (this.glyphMap.has(char)) {
+            return this.glyphMap.get(char);
+        }
+        if (!this.ctx)
+            return null;
+        const widthCells = char.length > 1 ? char.length : 1;
+        const requiredWidth = this.cellW * widthCells;
+        if (this.curX + requiredWidth > this.atlasWidth) {
+            this.curX = 0;
+            this.curY += this.cellH;
+        }
+        if (this.curY + this.cellH > this.atlasHeight) {
+            // Atlas capacity reached
+            return null;
+        }
+        const rx = this.curX;
+        const ry = this.curY;
+        this.ctx.fillStyle = "#ffffff";
+        this.ctx.fillText(char, rx, ry);
+        this.curX += requiredWidth;
+        this.isDirty = true;
+        const uv = {
+            u0: rx / this.atlasWidth,
+            v0: ry / this.atlasHeight,
+            u1: (rx + requiredWidth) / this.atlasWidth,
+            v1: (ry + this.cellH) / this.atlasHeight,
+            width: this.charWidth * widthCells,
+            height: this.lineHeight,
+        };
+        this.glyphMap.set(char, uv);
+        return uv;
+    }
+    getCanvasSource() {
+        return this.canvas;
+    }
+    checkAndClearDirty() {
+        const dirty = this.isDirty;
+        this.isDirty = false;
+        return dirty;
+    }
+    getGlyphUV(char) {
+        return this.glyphMap.get(char) ?? this.getOrRasterizeGlyph(char);
+    }
+}
+//# sourceMappingURL=WebGLGlyphAtlas.js.map

package/dist/WebGLGlyphAtlas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebGLGlyphAtlas.js","sourceRoot":"","sources":["../src/WebGLGlyphAtlas.ts"],"names":[],"mappings":"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"}

package/dist/WebGLViewportRenderer.d.ts

@@ -0,0 +1,26 @@
+import type { CanvasRenderOptions, CanvasViewport, LineDrawData, CaretRenderOptions, SelectionRenderOptions } from "./types.js";
+import type { WebGLGlyphAtlas } from "./WebGLGlyphAtlas.js";
+/**
+ * High-performance WebGL 2 Instanced Viewport Renderer with Ligature Clustering.
+ * Renders all glyphs and multi-character ligatures in a single GPU draw call at 144Hz-240Hz.
+ */
+export declare class WebGLViewportRenderer {
+    private gl;
+    private program;
+    private texture;
+    private quadVbo;
+    private instanceVbo;
+    private vao;
+    private atlas;
+    private ligatureEngine;
+    private maxInstances;
+    private instanceData;
+    private uResolutionLoc;
+    private uAtlasLoc;
+    constructor(canvas: HTMLCanvasElement, atlas: WebGLGlyphAtlas, _enableLigatures?: boolean);
+    private initGL;
+    private compileShader;
+    render(lines: LineDrawData[], viewport: CanvasViewport, options: CanvasRenderOptions, _caret?: CaretRenderOptions, _selection?: SelectionRenderOptions): void;
+    isSupported(): boolean;
+}
+//# sourceMappingURL=WebGLViewportRenderer.d.ts.map

package/dist/WebGLViewportRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebGLViewportRenderer.d.ts","sourceRoot":"","sources":["../src/WebGLViewportRenderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,sBAAsB,EACvB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AA2D5D;;;GAGG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,EAAE,CAAuC;IACjD,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,GAAG,CAAuC;IAClD,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,cAAc,CAAiB;IAGvC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,YAAY,CAA4C;IAChE,OAAO,CAAC,cAAc,CAAqC;IAC3D,OAAO,CAAC,SAAS,CAAqC;gBAE1C,MAAM,EAAE,iBAAiB,EAAE,KAAK,EAAE,eAAe,EAAE,gBAAgB,UAAO;IAMtF,OAAO,CAAC,MAAM;IAmEd,OAAO,CAAC,aAAa;IAad,MAAM,CACX,KAAK,EAAE,YAAY,EAAE,EACrB,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,mBAAmB,EAC5B,MAAM,CAAC,EAAE,kBAAkB,EAC3B,UAAU,CAAC,EAAE,sBAAsB,GAClC,IAAI;IAsKA,WAAW,IAAI,OAAO;CAG9B"}