textmode.js 0.2.1-beta.3 → 0.2.1-beta.5

package/dist/types/textmode/mixins/MouseMixin.d.ts

@@ -1,5 +1,5 @@
 import type { Mixin } from './TextmodifierMixin';
-import type { MousePosition, MouseEventHandler } from '../managers';
+import type { MousePosition } from '../managers';
 /**
  * Capabilities provided by the MouseMixin
  */
@@ -19,7 +19,7 @@ export interface MouseCapabilities {
      * });
      * ```
      */
-    mouseClicked(callback: MouseEventHandler): void;
+    mouseClicked(callback: () => void): void;
     /**
      * Set a callback function that will be called when the mouse is pressed down.
      *
@@ -34,7 +34,7 @@ export interface MouseCapabilities {
      * });
      * ```
      */
-    mousePressed(callback: MouseEventHandler): void;
+    mousePressed(callback: () => void): void;
     /**
      * Set a callback function that will be called when the mouse is released.
      *
@@ -49,7 +49,7 @@ export interface MouseCapabilities {
      * });
      * ```
      */
-    mouseReleased(callback: MouseEventHandler): void;
+    mouseReleased(callback: () => void): void;
     /**
      * Set a callback function that will be called when the mouse moves.
      *
@@ -67,7 +67,7 @@ export interface MouseCapabilities {
      * });
      * ```
      */
-    mouseMoved(callback: MouseEventHandler): void;
+    mouseMoved(callback: () => void): void;
     /**
      * Set a callback function that will be called when the mouse wheel is scrolled.
      *
@@ -83,7 +83,7 @@ export interface MouseCapabilities {
      * });
      * ```
      */
-    mouseScrolled(callback: MouseEventHandler): void;
+    mouseScrolled(callback: () => void): void;
     /**
      * Get the current mouse position in grid coordinates.
      *

package/dist/types/textmode/mixins/RenderingMixin.d.ts

@@ -1,6 +1,7 @@
 import type { Mixin } from './TextmodifierMixin';
 import type { GLShader } from '../../rendering/webgl/Shader';
 import type { GLFramebuffer } from '../../rendering';
+import { TextmodeImage } from '../TextmodeImage';
 /**
  * Options for creating a framebuffer.
  */
@@ -128,7 +129,12 @@ export interface RenderingCapabilities {
      * });
      * ```
      */
-    image(framebuffer: GLFramebuffer, x: number, y: number, width?: number, height?: number): void;
+    image(source: GLFramebuffer | TextmodeImage, x: number, y: number, width?: number, height?: number): void;
+    /**
+     * Load an image and return a TextmodeImage that can be drawn with image().
+     * @param src URL or existing HTMLImageElement
+     */
+    loadImage(src: string | HTMLImageElement): Promise<TextmodeImage>;
     /**
      * Set a uniform value for the current custom shader.
      * @param name The name of the uniform variable
@@ -240,7 +246,10 @@ export interface RenderingCapabilities {
      */
     createFilterShader(fragmentSource: string): GLShader;
     /**
-     * Sets the rotation angles for subsequent shape rendering operations
+     * Sets the rotation angles for subsequent shape rendering operations.
+     *
+     * All geometries rotate around the center of the shape.
+     *
      * @param degreesX The rotation angle in degrees around the X-axis (optional, defaults to 0)
      * @param degreesY The rotation angle in degrees around the Y-axis (optional, defaults to 0)
      * @param degreesZ The rotation angle in degrees around the Z-axis (optional, defaults to 0)
@@ -267,7 +276,10 @@ export interface RenderingCapabilities {
      */
     rotate(degreesX?: number, degreesY?: number, degreesZ?: number): void;
     /**
-     * Sets the X-axis rotation angle for subsequent shape rendering operations
+     * Sets the X-axis rotation angle for subsequent shape rendering operations.
+     *
+     * All geometries rotate around the center of the shape.
+     *
      * @param degrees The rotation angle in degrees around the X-axis
      *
      * @example
@@ -286,7 +298,10 @@ export interface RenderingCapabilities {
      */
     rotateX(degrees: number): void;
     /**
-     * Sets the Y-axis rotation angle for subsequent shape rendering operations
+     * Sets the Y-axis rotation angle for subsequent shape rendering operations.
+     *
+     * All geometries rotate around the center of the shape.
+     *
      * @param degrees The rotation angle in degrees around the Y-axis
      *
      * @example
@@ -305,7 +320,10 @@ export interface RenderingCapabilities {
      */
     rotateY(degrees: number): void;
     /**
-     * Sets the Z-axis rotation angle for subsequent shape rendering operations
+     * Sets the Z-axis rotation angle for subsequent shape rendering operations.
+     *
+     * All geometries rotate around the center of the shape.
+     *
      * @param degrees The rotation angle in degrees around the Z-axis
      *
      * @example

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "textmode.js",
-  "version": "0.2.1-beta.3",
+  "version": "0.2.1-beta.5",
   "description": "textmode.js is a lightweight creative coding library for creating real-time ASCII art on the web.",
   "type": "module",
   "types": "./dist/types/index.d.ts",

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

@@ -1,35 +0,0 @@
-/**
- * Interface for shader data with minification support
- */
-export interface ShaderData {
-    /** The shader source code (minified in production, original in development) */
-    sourceCode: string;
-    /** Original unminified source code (available in development builds) */
-    originalCode?: string;
-    /** Mapping of original uniform names to minified names and types */
-    uniforms: Record<string, {
-        /** Minified uniform name used in the shader */
-        variableName: string;
-        /** GLSL type of the uniform (vec2, sampler2D, etc.) */
-        variableType: string;
-    }>;
-    /** Mapping of const variables (if any) */
-    consts: Record<string, {
-        /** Substitution value for the const */
-        variableName: string;
-        /** GLSL type of the const */
-        variableType: string;
-    }>;
-}
-/**
- * Union type for shader imports - either ShaderData or plain string (for backward compatibility)
- */
-export type ShaderSource = ShaderData | string;
-/**
- * Helper to normalize shader source to ShaderData format
- */
-export declare function normalizeShaderData(source: ShaderSource): ShaderData;
-/**
- * Extract just the source code from ShaderSource
- */
-export declare function getShaderCode(source: ShaderSource): string;

package/dist/types/textmode/font/utils/CmapParser.d.ts

@@ -1,47 +0,0 @@
-import type { TyprFont } from '../typr/types.ts';
-import { FontTableReader } from './FontTableReader.ts';
-/**
- * Specialized utility for character mapping operations.
- * Provides high-level character extraction and validation functions.
- */
-export declare class CmapParser {
-    private _tableReader;
-    constructor(tableReader: FontTableReader);
-    /**
-     * Extracts all available characters from a font's cmap tables.
-     * Returns an array of unique character strings.
-     */
-    $extractAllCharacters(font: TyprFont): string[];
-    /**
-     * Validates whether a character exists in the font.
-     */
-    $characterExists(font: TyprFont, character: string): boolean;
-    /**
-     * Validates whether all characters in a string exist in the font.
-     */
-    $allCharactersExist(font: TyprFont, text: string): boolean;
-    /**
-     * Filters out characters that don't exist in the font.
-     */
-    $filterExistingCharacters(font: TyprFont, characters: string[]): string[];
-    /**
-     * Filters out problematic characters that might cause rendering issues.
-     */
-    $filterProblematicCharacters(characters: string[]): string[];
-    /**
-     * Extracts characters from a Format 4 cmap table (Basic Multilingual Plane).
-     */
-    private _extractCharactersFromFormat4;
-    /**
-     * Extracts characters from a Format 12 cmap table (Extended Unicode ranges).
-     */
-    private _extractCharactersFromFormat12;
-    /**
-     * Calculates the glyph index for a character in a Format 4 cmap table.
-     */
-    private _calculateGlyphIndexFormat4;
-    /**
-     * Checks if a character is valid for rendering.
-     */
-    private _isValidCharacter;
-}