textmode.js 0.2.0 → 0.2.1-beta.1

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

@@ -0,0 +1,39 @@
+import type { Mixin } from './TextmodifierMixin';
+import type { KeyboardEventHandler } from '../keyboard';
+/**
+ * Capabilities provided by the KeyboardMixin
+ */
+export interface KeyboardCapabilities {
+    /** Check if a specific key is currently pressed */
+    isKeyPressed(key: string): boolean;
+    /** Get the last key that was pressed */
+    readonly lastKeyPressed: string | null;
+    /** Get the last key that was released */
+    readonly lastKeyReleased: string | null;
+    /** Get all currently pressed keys */
+    readonly pressedKeys: string[];
+    /** Get current modifier key states */
+    readonly modifierState: {
+        ctrl: boolean;
+        shift: boolean;
+        alt: boolean;
+        meta: boolean;
+    };
+    /** Set a callback for when a key is pressed down */
+    keyPressed(callback: KeyboardEventHandler): void;
+    /** Set a callback for when a key is released */
+    keyReleased(callback: KeyboardEventHandler): void;
+    /** Clear all key states */
+    clearKeyStates(): void;
+}
+/**
+ * Mixin that adds keyboard interaction capabilities to Textmodifier.
+ *
+ * This is a thin wrapper around KeyboardManager that provides the public API
+ * for keyboard interaction. All the actual implementation is handled by the
+ * KeyboardManager instance in the TextmodifierContext.
+ *
+ * Provides p5.js-like keyboard functionality including key state tracking,
+ * event callbacks, and special key handling.
+ */
+export declare const KeyboardMixin: Mixin<KeyboardCapabilities>;

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

@@ -0,0 +1,27 @@
+import type { Mixin } from './TextmodifierMixin';
+import type { MousePosition, MouseEventHandler } from '../mouse';
+/**
+ * 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 */
+    mouseClicked(callback: MouseEventHandler): void;
+    /** Set a callback for when the mouse is pressed down */
+    mousePressed(callback: MouseEventHandler): void;
+    /** Set a callback for when the mouse is released */
+    mouseReleased(callback: MouseEventHandler): void;
+    /** Set a callback for when the mouse moves */
+    mouseMoved(callback: MouseEventHandler): void;
+    /** Set a callback for when the mouse wheel is scrolled */
+    mouseScrolled(callback: MouseEventHandler): void;
+}
+/**
+ * Mixin that adds mouse tracking capabilities to Textmodifier.
+ *
+ * This is a thin wrapper around MouseManager that provides the public API
+ * for mouse interaction. All the actual implementation is handled by the
+ * MouseManager instance in the TextmodifierContext.
+ */
+export declare const MouseMixin: Mixin<MouseCapabilities>;

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

@@ -304,6 +304,25 @@ export interface RenderingCapabilities {
      * ```
      */
     rect(x: number, y: number, width?: number, height?: number): void;
+    /**
+     * Draw a single point at (x, y) with the current settings.
+     * @param x X-coordinate of the point
+     * @param y Y-coordinate of the point
+     *
+     * @example
+     * ```javascript
+     * const t = textmode.create({
+     *   width: 800,
+     *   height: 600,
+     * })
+     *
+     * t.draw(() => {
+     *   t.background(0);
+     *   t.point(10, 10);
+     * });
+     * ```
+     */
+    point(x: number, y: number): void;
     /**
      * Draw a line from point (x1, y1) to point (x2, y2) with the settings.
      * @param x1 X-coordinate of the line start point

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

@@ -7,6 +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';
 /**
  * Constructor type for mixin pattern
  */
@@ -30,6 +32,10 @@ export interface TextmodifierContext {
     readonly _grid: TextmodeGrid;
     /** Animation controller for managing rendering loop @ignore */
     readonly _animationController: AnimationController;
+    /** Mouse interaction manager @ignore */
+    readonly _mouseManager: MouseManager;
+    /** Keyboard interaction manager @ignore */
+    readonly _keyboardManager: KeyboardManager;
     /** Draw shader that contains content drawn by the user @ignore */
     readonly _textmodeDrawShader: Shader;
     /** Framebuffer used for offscreen rendering @ignore */

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

@@ -3,3 +3,7 @@ export { RenderingMixin, type RenderingCapabilities } from './RenderingMixin';
 export { ExportMixin, type ExportCapabilities } from './ExportMixin';
 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';

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

@@ -0,0 +1,130 @@
+import type { TextmodeCanvas } from '../Canvas';
+import type { TextmodeGrid } from '../Grid';
+/**
+ * Mouse coordinates in grid space
+ */
+export interface MousePosition {
+    /** Grid X coordinate (column), -1 if mouse is outside grid */
+    x: number;
+    /** Grid Y coordinate (row), -1 if mouse is outside grid */
+    y: number;
+}
+/**
+ * Mouse event data passed to event handlers
+ */
+export interface MouseEventData {
+    /** Current mouse position in grid coordinates */
+    position: MousePosition;
+    /** Previous mouse position in grid coordinates */
+    previousPosition: MousePosition;
+    /** Mouse button that triggered the event (for click events) */
+    button?: number;
+    /** Scroll delta for wheel events */
+    delta?: {
+        x: number;
+        y: number;
+    };
+    /** Original DOM event */
+    originalEvent: MouseEvent | WheelEvent;
+}
+/**
+ * Mouse event handler function type
+ */
+export type MouseEventHandler = (data: MouseEventData) => void;
+/**
+ * Manages all mouse interaction for a Textmodifier instance.
+ * Handles event listeners, coordinate conversion, and event dispatching.
+ */
+export declare class MouseManager {
+    private _canvas;
+    private _grid;
+    private _mousePosition;
+    private _previousMousePosition;
+    private _lastClientCoordinates;
+    private _mouseMoveListener;
+    private _mouseLeaveListener;
+    private _mouseDownListener;
+    private _mouseUpListener;
+    private _clickListener;
+    private _wheelListener;
+    private _areListenersSetup;
+    private _mouseClickedCallback?;
+    private _mousePressedCallback?;
+    private _mouseReleasedCallback?;
+    private _mouseMovedCallback?;
+    private _mouseScrolledCallback?;
+    constructor(canvas: TextmodeCanvas);
+    /**
+     * Update the grid reference (useful when grid changes after font loading)
+     */
+    $initialize(grid: TextmodeGrid): void;
+    /**
+     * Setup mouse event listeners on the canvas.
+     */
+    $setupListeners(): void;
+    /**
+     * Remove mouse event listeners from the canvas.
+     */
+    $cleanupListeners(): void;
+    /**
+     * Force an immediate update of the mouse position.
+     * This is useful when grid dimensions change (font size, window resize, etc.)
+     * and we need to recalculate the mouse coordinates without waiting for a mouse event.
+     */
+    $updatePosition(): void;
+    /**
+     * Set a callback function that will be called when the mouse is clicked.
+     * @param callback The function to call when the mouse is clicked
+     */
+    $setClickedCallback(callback: MouseEventHandler): void;
+    /**
+     * 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
+     */
+    $setPressedCallback(callback: MouseEventHandler): void;
+    /**
+     * Set a callback function that will be called when the mouse is released.
+     * @param callback The function to call when the mouse is released
+     */
+    $setReleasedCallback(callback: MouseEventHandler): void;
+    /**
+     * Set a callback function that will be called when the mouse moves.
+     * @param callback The function to call when the mouse moves
+     */
+    $setMovedCallback(callback: MouseEventHandler): void;
+    /**
+     * 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
+     */
+    $setScrolledCallback(callback: MouseEventHandler): void;
+    /**
+     * Get the current mouse position in grid coordinates.
+     * Returns a copy to prevent external modification.
+     */
+    $getPosition(): MousePosition;
+    /**
+     * Handle mouse moved events
+     */
+    private _handleMouseMoved;
+    /**
+     * Handle mouse pressed events
+     */
+    private _handleMousePressed;
+    /**
+     * Handle mouse released events
+     */
+    private _handleMouseReleased;
+    /**
+     * Handle mouse clicked events
+     */
+    private _handleMouseClicked;
+    /**
+     * Handle mouse scrolled events
+     */
+    private _handleMouseScrolled;
+    /**
+     * Update mouse position based on mouse event.
+     * Converts pixel coordinates to grid coordinates.
+     */
+    private _updateMousePosition;
+}

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "textmode.js",
-  "version": "0.2.0",
+  "version": "0.2.1-beta.1",
   "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",