textmode.js 0.2.0-beta.5 → 0.2.1-beta.1

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,7 +1,7 @@
 {
   "name": "textmode.js",
-  "version": "0.2.0-beta.5",
-  "description": "Apply real-time ASCII conversion to any HTML canvas.",
+  "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",
   "main": "./dist/textmode.umd.js",
@@ -55,14 +55,18 @@
     "petscii",
     "textmode",
     "canvas",
-    "webgl"
+    "webgl",
+    "creative-coding",
+    "art",
+    "design",
+    "graphics"
   ],
   "author": "humanbydefinition",
   "license": "MIT",
   "bugs": {
     "url": "https://github.com/humanbydefinition/textmode.js/issues"
   },
-  "homepage": "https://github.com/humanbydefinition/textmode.js",
+  "homepage": "https://code.textmode.art",
   "files": [
     "dist"
   ]