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

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

@@ -1,21 +1,114 @@
 import type { Mixin } from './TextmodifierMixin';
-import type { MousePosition, MouseEventHandler } from '../mouse';
+import type { MousePosition, MouseEventHandler } from '../managers';
 /**
  * Capabilities provided by the MouseMixin
  */
 export interface MouseCapabilities {
-    /** Get the current mouse position in grid coordinates */
-    readonly mouse: MousePosition;
-    /** Set a callback for when the mouse is clicked */
+    /**
+     * Set a callback function that will be called when the mouse is clicked.
+     *
+     * @param callback The function to call when the mouse is clicked
+     *
+     * @example
+     * ```javascript
+     * const t = textmode.create({ width: 800, height: 600 });
+     *
+     * t.mouseClicked((data) => {
+     *   console.log(`Clicked at grid position: ${data.position.x}, ${data.position.y}`);
+     *   console.log(`Button: ${data.button}`); // 0=left, 1=middle, 2=right
+     * });
+     * ```
+     */
     mouseClicked(callback: MouseEventHandler): void;
-    /** Set a callback for when the mouse is pressed down */
+    /**
+     * Set a callback function that will be called when the mouse is pressed down.
+     *
+     * @param callback The function to call when the mouse is pressed
+     *
+     * @example
+     * ```javascript
+     * const t = textmode.create({ width: 800, height: 600 });
+     *
+     * t.mousePressed((data) => {
+     *   console.log(`Mouse pressed at: ${data.position.x}, ${data.position.y}`);
+     * });
+     * ```
+     */
     mousePressed(callback: MouseEventHandler): void;
-    /** Set a callback for when the mouse is released */
+    /**
+     * Set a callback function that will be called when the mouse is released.
+     *
+     * @param callback The function to call when the mouse is released
+     *
+     * @example
+     * ```javascript
+     * const t = textmode.create({ width: 800, height: 600 });
+     *
+     * t.mouseReleased((data) => {
+     *   console.log(`Mouse released at: ${data.position.x}, ${data.position.y}`);
+     * });
+     * ```
+     */
     mouseReleased(callback: MouseEventHandler): void;
-    /** Set a callback for when the mouse moves */
+    /**
+     * Set a callback function that will be called when the mouse moves.
+     *
+     * @param callback The function to call when the mouse moves
+     *
+     * @example
+     * ```javascript
+     * const t = textmode.create({ width: 800, height: 600 });
+     *
+     * t.mouseMoved((data) => {
+     *   if (data.position.x !== -1 && data.position.y !== -1) {
+     *     console.log(`Mouse moved to: ${data.position.x}, ${data.position.y}`);
+     *     console.log(`Previous position: ${data.previousPosition.x}, ${data.previousPosition.y}`);
+     *   }
+     * });
+     * ```
+     */
     mouseMoved(callback: MouseEventHandler): void;
-    /** Set a callback for when the mouse wheel is scrolled */
+    /**
+     * Set a callback function that will be called when the mouse wheel is scrolled.
+     *
+     * @param callback The function to call when the mouse wheel is scrolled
+     *
+     * @example
+     * ```javascript
+     * const t = textmode.create({ width: 800, height: 600 });
+     *
+     * t.mouseScrolled((data) => {
+     *   console.log(`Mouse scrolled at: ${data.position.x}, ${data.position.y}`);
+     *   console.log(`Scroll delta: ${data.delta?.x}, ${data.delta?.y}`);
+     * });
+     * ```
+     */
     mouseScrolled(callback: MouseEventHandler): void;
+    /**
+     * Get the current mouse position in grid coordinates.
+     *
+     * Returns the mouse position as grid cell coordinates *(column, row)*.
+     *
+     * If the mouse is outside the grid or the instance is not ready,
+     * it returns `{ x: -1, y: -1 }`.
+     *
+     * @example
+     * ```javascript
+     * const t = textmode.create({ width: 800, height: 600 });
+     *
+     * t.draw(() => {
+     *   const mousePos = t.mouse;
+     *
+     *   if (mousePos.x !== -1 && mousePos.y !== -1) {
+     *     // Mouse is over the grid
+     *     t.char('*');
+     *     t.charColor(255, 0, 0);
+     *     t.point(mousePos.x, mousePos.y);
+     *   }
+     * });
+     * ```
+     */
+    get mouse(): MousePosition;
 }
 /**
  * Mixin that adds mouse tracking capabilities to Textmodifier.

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

@@ -1,5 +1,15 @@
 import type { Mixin } from './TextmodifierMixin';
 import type { GLShader } from '../../rendering/webgl/Shader';
+import type { GLFramebuffer } from '../../rendering';
+/**
+ * Options for creating a framebuffer.
+ */
+export type TextmodeFramebufferOptions = {
+    /** Width of the framebuffer in grid cells */
+    width: number;
+    /** Height of the framebuffer in grid cells */
+    height: number;
+};
 /**
  * Supported uniform value types for shader parameters
  */
@@ -39,6 +49,86 @@ export interface RenderingCapabilities {
      * ```
      */
     shader(shader: GLShader): void;
+    /**
+     * Create a new framebuffer for offscreen rendering.
+     *
+     * The framebuffer uses the same 5-attachment MRT structure as the main
+     * rendering pipeline, allowing all standard drawing operations to work
+     * seamlessly when rendering to the framebuffer.
+     *
+     * @param options Configuration options for the framebuffer.
+     * @returns A new Framebuffer instance.
+     *
+     * @example
+     * ```javascript
+     * const t = textmode.create({
+     *   width: 800,
+     *   height: 600,
+     * });
+     *
+     * // Create a framebuffer with 50x30 grid cells
+     * const fb = t.createFramebuffer({
+     *   width: 50,
+     *   height: 30
+     * });
+     *
+     * t.draw(() => {
+     *   // Render to framebuffer
+     *   fb.begin();
+     *   t.background(255, 0, 0);
+     *   t.charColor(255);
+     *   t.rect(10, 10, 20, 10);
+     *   fb.end();
+     *
+     *   // Render framebuffer to main canvas
+     *   t.background(0);
+     *   t.image(fb, 0, 0);
+     * });
+     * ```
+     */
+    createFramebuffer(options: TextmodeFramebufferOptions): GLFramebuffer;
+    /**
+     * Render a framebuffer to the current render target.
+     *
+     * This method takes the 5 MRT attachments from the source framebuffer
+     * and renders them at the specified position.
+     * The framebuffer content will be processed through the same rendering
+     * pipeline as normal drawing operations.
+     *
+     * @param framebuffer The framebuffer to render
+     * @param x X position on the grid where to place the framebuffer content *(top-left corner)*
+     * @param y Y position on the grid where to place the framebuffer content *(top-left corner)*
+     * @param width Optional width to scale the framebuffer content *(defaults to framebuffer width)*
+     * @param height Optional height to scale the framebuffer content *(defaults to framebuffer height)*
+     *
+     * @example
+     * ```javascript
+     * const t = textmode.create({
+     *   width: 800,
+     *   height: 600,
+     * });
+     *
+     * const fb = t.createFramebuffer({width: 30, height: 20});
+     *
+     * t.draw(() => {
+     *   // Draw something to the framebuffer
+     *   fb.begin();
+     *   t.charColor(255, 0, 0);
+     *   t.rect(5, 5, 20, 10);
+     *   fb.end();
+     *
+     *   // Clear main canvas and render framebuffer content
+     *   t.background(0);
+     *
+     *   // Render at original size
+     *   t.image(fb, 10, 10);
+     *
+     *   // Render scaled version
+     *   t.image(fb, 50, 10, 60, 40);
+     * });
+     * ```
+     */
+    image(framebuffer: GLFramebuffer, x: number, y: number, width?: number, height?: number): void;
     /**
      * Set a uniform value for the current custom shader.
      * @param name The name of the uniform variable
@@ -318,6 +408,8 @@ export interface RenderingCapabilities {
      *
      * t.draw(() => {
      *   t.background(0);
+     *
+     *   t.char('*');
      *   t.point(10, 10);
      * });
      * ```

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

@@ -7,8 +7,8 @@ import type { TextmodeCanvas } from '../Canvas';
 import type { TextmodeGrid } from '../Grid';
 import type { AnimationController } from '../AnimationController';
 import type { GLFramebuffer, Shader } from '../../rendering';
-import type { MouseManager } from '../mouse';
-import type { KeyboardManager } from '../keyboard';
+import type { MouseManager } from '../managers';
+import type { KeyboardManager } from '../managers';
 /**
  * Constructor type for mixin pattern
  */

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

@@ -5,5 +5,5 @@ export { FontMixin, type FontCapabilities } from './FontMixin';
 export { AnimationMixin, type AnimationCapabilities } from './AnimationMixin';
 export { MouseMixin, type MouseCapabilities } from './MouseMixin';
 export { KeyboardMixin, type KeyboardCapabilities } from './KeyboardMixin';
-export type { MousePosition, MouseEventData, MouseEventHandler } from '../mouse';
-export type { KeyboardEventData, KeyboardEventHandler, KeyState } from '../keyboard';
+export type { MousePosition, MouseEventData, MouseEventHandler } from '../managers';
+export type { KeyboardEventData, KeyboardEventHandler, KeyState } from '../managers';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "textmode.js",
-  "version": "0.2.1-beta.1",
+  "version": "0.2.1-beta.3",
   "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",
@@ -32,6 +32,7 @@
     "test:coverage": "vitest --coverage"
   },
   "devDependencies": {
+    "@mapwhit/glsl-minify": "^1.0.0",
     "@rollup/plugin-terser": "^0.4.4",
     "@types/jsdom": "^21.1.7",
     "@types/node": "^24.0.13",
@@ -39,9 +40,9 @@
     "jsdom": "^26.1.0",
     "terser": "^5.43.1",
     "tslib": "^2.8.1",
-    "typedoc": "^0.28.7",
+    "typedoc": "^0.28.13",
     "typedoc-plugin-markdown": "^4.7.0",
-    "typescript": "^5.8.3",
+    "typescript": "^5.9.2",
     "vite": "^6.3.4",
     "vite-plugin-glsl": "^1.5.1",
     "vitest": "^3.1.2"

package/dist/types/textmode/keyboard/index.d.ts

@@ -1,2 +0,0 @@
-export { KeyboardManager } from './KeyboardManager';
-export type { KeyboardEventData, KeyboardEventHandler, KeyState } from './KeyboardManager';

package/dist/types/textmode/mouse/index.d.ts

@@ -1,2 +0,0 @@
-export { MouseManager } from './MouseManager';
-export type { MousePosition, MouseEventData, MouseEventHandler } from './MouseManager';