textmode.js 0.1.6-beta.4 → 0.1.6-beta.6

package/dist/types/rendering/webgl/Shader.d.ts

@@ -5,12 +5,13 @@ export declare class Shader {
     private gl;
     private program;
     private uniformLocations;
-    private attributeLocations;
+    private uniformTypes;
     private textureUnitCounter;
+    private maxTextureUnits;
     constructor(gl: WebGLRenderingContext, vertexSource: string, fragmentSource: string);
+    private cacheLocations;
     private createProgram;
     private createShader;
-    private cacheLocations;
     /**
      * Use this shader program
      */
@@ -19,19 +20,11 @@ export declare class Shader {
      * Set a single uniform value with automatic texture unit management
      */
     setUniform(name: string, value: any): void;
-    /**
-     * Get uniform info to determine the correct WebGL type
-     */
-    private getUniformInfo;
     private getNextTextureUnit;
     /**
-     * Check if this shader has a specific uniform
-     */
-    hasUniform(name: string): boolean;
-    /**
-     * Check if this shader has a specific attribute
+     * Check if a uniform is an integer type
      */
-    hasAttribute(name: string): boolean;
+    private isUniformInteger;
     /**
      * Get the WebGL program
      */

package/dist/types/rendering/webgl/StateCache.d.ts

@@ -1,6 +1,4 @@
 type Viewport = [number, number, number, number];
 export declare function setViewport(gl: WebGLRenderingContext, vp: Viewport): void;
 export declare function getViewport(gl: WebGLRenderingContext): Viewport | undefined;
-export declare function setIsFramebufferTarget(gl: WebGLRenderingContext, isFbo: boolean): void;
-export declare function getIsFramebufferTarget(gl: WebGLRenderingContext): boolean | undefined;
 export {};

package/dist/types/rendering/webgl/geometries/BaseGeometry.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Base class for WebGL geometry rendering with shared vertex buffer management
+ */
+export declare abstract class BaseGeometry {
+    protected gl: WebGLRenderingContext;
+    protected unitBuffer: WebGLBuffer | null;
+    protected bytesPerVertex: number;
+    private attribCache;
+    constructor(gl: WebGLRenderingContext);
+    /**
+     * Ensure the unit buffer is created and bound
+     */
+    protected ensureUnitBuffer(): void;
+    /**
+     * Enable vertex attributes and return their locations
+     */
+    protected enableAttribs(): {
+        positionLoc: number;
+        texLoc: number;
+    };
+    /**
+     * Disable vertex attributes
+     */
+    protected disableAttribs(positionLoc: number, texLoc: number): void;
+    /**
+     * Convert screen coordinates to NDC (Normalized Device Coordinates)
+     */
+    protected toNDC(x: number, y: number): {
+        nx: number;
+        ny: number;
+    };
+    /**
+     * Upload quad vertices to the buffer in NDC coordinates
+     */
+    protected uploadQuadNDC(x1: number, y1: number, x2: number, y2: number): void;
+    /**
+     * Dispose of WebGL resources used by this geometry
+     */
+    dispose(): void;
+}

package/dist/types/rendering/webgl/geometries/Line.d.ts

@@ -1,31 +1,11 @@
+import { BaseGeometry } from './BaseGeometry';
 /**
- * Line geometry for WebGL rendering that uses vertices to create lines of varying thickness.
- * Handles coordinate system differences between canvas and framebuffer targets by flipping Y-axis for framebuffers.
- * Creates a rectangular geometry to represent the line segment with the specified thickness.
+ * Line geometry renderer
  */
-export declare class Line {
-    /** The WebGL rendering context */
-    private gl;
-    /** The vertex buffer containing position and texture coordinates */
-    private vertexBuffer;
-    /** The number of vertices in this geometry (always 6 for two triangles) */
-    private readonly vertexCount;
-    /** Bytes per vertex: vec2+vec2 = 16 bytes */
-    private bytesPerVertex;
-    constructor(gl: WebGLRenderingContext, x1: number, y1: number, x2: number, y2: number, weight: number);
+export declare class Line extends BaseGeometry {
+    constructor(gl: WebGLRenderingContext);
     /**
-     * Generate vertex data for a rectangle representing the line with texture coordinates
-     * @private
+     * Draw a line from (x1, y1) to (x2, y2) with specified weight
      */
-    private generateVertices;
-    /**
-     * Generate vertex data for the line rectangle with texture coordinates
-     * Uses the four corners calculated based on line direction and thickness
-     * @private
-     */
-    private generateLineVertices;
-    /**
-     * Render the line using position and texture coordinate attributes
-     */
-    render(): void;
+    draw(x1: number, y1: number, x2: number, y2: number, weight: number): void;
 }

package/dist/types/rendering/webgl/geometries/Rectangle.d.ts

@@ -1,25 +1,15 @@
+import { BaseGeometry } from './BaseGeometry';
 /**
- * Simplified rectangle geometry for WebGL rendering using a unified vertex layout.
- * Always includes texture coordinates for maximum shader compatibility.
- * Handles coordinate system differences between canvas and framebuffer targets by flipping Y-axis for framebuffers.
+ * Rectangle geometry renderer with fill and stroke support
  */
-export declare class Rectangle {
-    /** The WebGL rendering context */
-    private gl;
-    /** The vertex buffer containing position and texture coordinates */
-    private vertexBuffer;
-    /** The number of vertices in this geometry (always 6 for two triangles) */
-    private readonly vertexCount;
-    /** Bytes per vertex: depends on position format (vec2 vs vec3) */
-    private bytesPerVertex;
-    constructor(gl: WebGLRenderingContext, x: number, y: number, width: number, height: number);
+export declare class Rectangle extends BaseGeometry {
+    constructor(gl: WebGLRenderingContext);
     /**
-     * Generate vertex data for the rectangle with texture coordinates
-     * @private
+     * Draw a filled rectangle
      */
-    private generateVertices;
+    drawFill(x: number, y: number, width: number, height: number): void;
     /**
-     * Render the rectangle using position and texture coordinate attributes
+     * Draw a rectangle stroke (outline)
      */
-    render(): void;
+    drawStroke(x: number, y: number, width: number, height: number, weight: number): void;
 }

package/dist/types/rendering/webgl/geometries/index.d.ts

@@ -0,0 +1,3 @@
+export { BaseGeometry } from './BaseGeometry';
+export { Rectangle } from './Rectangle';
+export { Line } from './Line';

package/dist/types/textmode/Canvas.d.ts

@@ -23,17 +23,6 @@ export declare class TextmodeCanvas {
      * Get the WebGL context for the overlay canvas
      */
     getWebGLContext(): WebGL2RenderingContext | WebGLRenderingContext;
-    /**
-     * Get the effective rendering dimensions accounting for CSS transforms
-     */
-    getEffectiveRenderingDimensions(): {
-        width: number;
-        height: number;
-    };
-    /**
-     * Check if the canvas is affected by CSS transforms
-     */
-    isTransformed(): boolean;
     /**
      * Set up ResizeObserver to monitor for CSS transform changes
      */

package/dist/types/textmode/ConversionPipeline.d.ts

@@ -1,6 +1,6 @@
 import type { Framebuffer } from "../rendering/webgl/Framebuffer";
 import type { GLRenderer } from "../rendering/webgl/Renderer";
-import { TextmodeConverter } from "./converters";
+import { TextmodeBrightnessConverter, TextmodeConverter } from "./converters";
 import type { TextmodeFont } from "./font";
 import type { TextmodeGrid } from "./Grid";
 /**
@@ -15,6 +15,10 @@ export declare class TextmodeConversionPipeline {
     private font;
     private grid;
     private converters;
+    /** Pre-configured brightness converter for easy access */
+    readonly brightness: TextmodeBrightnessConverter;
+    /** Pre-configured custom converter for easy access */
+    readonly custom: TextmodeConverter;
     private _resultFramebuffer;
     private _asciiShader;
     private _characterFramebuffer;
@@ -37,23 +41,22 @@ export declare class TextmodeConversionPipeline {
      */
     render(sourceFramebuffer: Framebuffer): void;
     /**
-     * Get a specific converter by name.
-     * @param name The name of the converter to retrieve.
-     * @returns The requested `TextmodeConverter` instance.
+     * Adds a new converter to the pipeline.
+     * @param converter The converter instance to add.
+     * @returns The added {@link TextmodeConverter} instance.
      */
-    get(name: string): TextmodeConverter | void;
     /**
      * Adds a new converter to the pipeline.
      * @param name A unique name for the converter.
      * @param type The type of converter to add. Can be either "brightness" or "custom".
      * @returns The newly created {@link TextmodeConverter} instance or `void` if the addition failed.
      */
-    add(name: string, type: "brightness" | "custom"): TextmodeConverter | void;
+    add(type: "brightness" | "custom"): TextmodeConverter | void;
     /**
-     * Removes a converter from the pipeline by name or instance.
-     * @param nameOrInstance The unique name of the converter or the converter instance to remove.
+     * Removes a converter from the pipeline.
+     * @param converter The converter instance to remove.
      */
-    remove(nameOrInstance: string | TextmodeConverter): void;
+    remove(converter: TextmodeConverter): void;
     /**
      * Returns the framebuffer containing the textmode conversion result.
      */

package/dist/types/textmode/Grid.d.ts

@@ -38,7 +38,7 @@ export declare class TextmodeGrid {
     /**
      * Reset the total grid width & height, and the offset to the outer canvas.
      */
-    private _resizeGrid;
+    private _updateDimensions;
     /**
      * Re-assign the grid cell dimensions and `reset()` the grid.
      * @param newCellWidth The new cell width.
@@ -77,11 +77,6 @@ export declare class TextmodeGrid {
     get cellWidth(): number;
     /** Returns the height of each cell in the grid. */
     get cellHeight(): number;
-    /**
-     * Dispose of this TextmodeGrid and clean up references.
-     * This method is idempotent and safe to call multiple times.
-     */
-    dispose(): void;
     /** Returns the number of columns in the grid. */
     get cols(): number;
     /** Returns the number of rows in the grid. */