textmode.js 0.7.1 → 0.8.0-beta.2

package/dist/types/textmode/mixins/interfaces/ITouchMixin.d.ts

@@ -1,4 +1,4 @@
-import type { TouchEventHandler, TouchLongPressHandler, TouchPinchHandler, TouchPosition, TouchRotateHandler, TouchSwipeHandler, TouchTapHandler } from "../../managers/TouchManager";
+import type { TouchEventHandler, TouchLongPressHandler, TouchPinchHandler, TouchPosition, TouchRotateHandler, TouchSwipeHandler, TouchTapHandler } from '../../managers/TouchManager';
 /**
  * Capabilities exposed by the TouchMixin for handling touch interaction and gestures.
  */

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

@@ -1,5 +1,5 @@
-import type { TextmodePlugin } from "./managers/PluginManager";
-import type { LoadingScreenOptions } from "./loading/";
+import type { TextmodePlugin } from './managers/PluginManager';
+import type { LoadingScreenOptions } from './loading/';
 /**
  * Options for creating a {@link Textmodifier} instance.
  */
@@ -22,10 +22,6 @@ export type TextmodeOptions = {
     height?: number;
     /**
      * URL or path to a custom font file *(.otf/.ttf)*.
-     *
-     * Required when using minified builds that don't include a default font.
-     *
-     * Optional for full builds *(will override embedded font if provided)*.
      */
     fontSource?: string;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "textmode.js",
-  "version": "0.7.1",
+  "version": "0.8.0-beta.2",
   "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",
@@ -23,7 +23,9 @@
     "test": "vitest",
     "test:ui": "vitest --ui",
     "test:run": "vitest run",
-    "test:coverage": "vitest --coverage"
+    "test:coverage": "vitest --coverage",
+    "format": "prettier --write \"src/**/*.{ts,js}\"",
+    "format:check": "prettier --check \"src/**/*.{ts,js}\""
   },
   "devDependencies": {
     "@mapwhit/glsl-minify": "^1.0.0",
@@ -32,6 +34,7 @@
     "@types/node": "^24.0.13",
     "@vitest/ui": "^3.1.2",
     "jsdom": "^26.1.0",
+    "prettier": "^3.7.4",
     "terser": "^5.43.1",
     "tslib": "^2.8.1",
     "typedoc": "^0.28.13",

package/dist/types/textmode/layers/filters/index.d.ts

@@ -1,6 +0,0 @@
-export type { FilterName, BuiltInFilterName, BuiltInFilterParams, QueuedFilter, FilterContext, TextmodeFilterStrategy } from '../../filters';
-export { FilterRegistry, TextmodeFilterManager as FilterManager } from '../../filters';
-/**
- * @deprecated Use `FilterManager` instead. This alias exists for backwards compatibility.
- */
-export { TextmodeFilterManager as LayerFilterManager } from '../../filters';

package/dist/types/textmode/loadables/video/TextmodeVideoPreloader.d.ts

@@ -1,29 +0,0 @@
-import type { TextmodeVideoPreloadCallbacks, TextmodeVideoPreloadStrategy } from './types';
-/**
- * Handles extracting still frames from an {@link HTMLVideoElement} into WebGL textures
- * so that {@link TextmodeVideo} can render deterministic, frame-accurate playback.
- */
-export declare class TextmodeVideoPreloader {
-    private readonly _gl;
-    private readonly _videoElement;
-    private _frameRate;
-    private _totalFrames;
-    private _isPreloaded;
-    private _preloadedFrames;
-    private _lastProgressBucket;
-    constructor(gl: WebGL2RenderingContext, videoElement: HTMLVideoElement);
-    get isPreloaded(): boolean;
-    get totalFrames(): number;
-    get frameRate(): number | null;
-    get textures(): readonly WebGLTexture[];
-    dispose(): void;
-    preload(frameRate: number, callbacks?: TextmodeVideoPreloadCallbacks): Promise<TextmodeVideoPreloadStrategy>;
-    private _initializePreloadState;
-    private _finalizePreloadSuccess;
-    private _captureSourceToTexture;
-    private _reportPreloadProgress;
-    private _tryPreloadWithTrackProcessor;
-    private _preloadWithLegacySeeking;
-    private _waitForSeek;
-    private _deletePreloadedTextures;
-}

package/dist/types/textmode/loadables/video/types.d.ts

@@ -1,43 +0,0 @@
-/**
- * Options for preloading video frames in {@link TextmodeVideo}.
- *
- * When providing this options object as a second argument to {@link Textmodifier.loadVideo},
- * you can choose to preload all video frames at a specified frame rate before using the video.
- *
- * When preloading, the video will not play live asynchronously. Instead, all frames will be captured
- * upfront, allowing for frame-accurate seeking and rendering.
- *
- * This is especially useful for scenarios where precise frame control is needed,
- * like capturing GIFs/videos from textmode.js canvas using the `textmode.export.js` add-on library without
- * missing frames due to asynchronous video playback.
- *
- * Preloading takes time proportional to the video length and frame rate, which introduces significant delays
- * before the sketch can start rendering. Therefore, it is recommended to use this feature only when intending
- * to capture or export frames, rather than for real-time playback.
- */
-export interface TextmodeVideoOptions {
-    /** Frame rate to use when preloading video frames. If not specified, video will not be preloaded. */
-    frameRate?: number;
-    /** Callback invoked periodically during preloading to report progress. */
-    onProgress?: (progress: TextmodeVideoPreloadProgress) => void;
-    /** Callback invoked once preloading is complete. */
-    onComplete?: (summary: TextmodeVideoPreloadComplete) => void;
-    /** Callback invoked if an error occurs during preloading. */
-    onError?: (error: Error) => void;
-}
-export type TextmodeVideoPreloadStrategy = 'captureStream' | 'seeking';
-export interface TextmodeVideoPreloadProgress {
-    percent: number;
-    loadedFrames: number;
-    totalFrames: number;
-    strategy: TextmodeVideoPreloadStrategy;
-}
-export interface TextmodeVideoPreloadComplete {
-    totalFrames: number;
-    strategy: TextmodeVideoPreloadStrategy;
-}
-export type TextmodeVideoPreloadCallbacks = {
-    onProgress?: (progress: TextmodeVideoPreloadProgress) => void;
-    onComplete?: (summary: TextmodeVideoPreloadComplete) => void;
-    onError?: (error: Error) => void;
-};

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

@@ -1,8 +0,0 @@
-import type { Mixin } from './TextmodifierMixin';
-import type { IFontMixin } from './interfaces/IFontMixin';
-/**
- * Mixin that adds font capabilities to a class
- * @param Base The base class to extend
- * @returns Extended class with font capabilities
- */
-export declare const FontMixin: Mixin<IFontMixin>;

package/dist/types/textmode/mixins/interfaces/IFontMixin.d.ts

@@ -1,46 +0,0 @@
-/**
- * Interface for font capabilities that will be mixed into Textmodifier
- */
-export interface IFontMixin {
-    /**
-     * Update the font used for rendering.
-     * @param fontSource The URL of the font to load.
-     *
-     * @example
-     * ```javascript
-     * // Create a Textmodifier instance
-     * const t = textmode.create();
-     *
-     * t.setup(async () => {
-     *  // Load a custom font from a URL
-     *  await t.loadFont('https://example.com/fonts/myfont.ttf');
-     *
-     *  // Local font example
-     *  // await t.loadFont('./fonts/myfont.ttf');
-     * });
-     * ```
-     */
-    loadFont(fontSource: string): Promise<void>;
-    /**
-     * Set the font size used for rendering.
-     * @param size The font size to set.
-     *
-     * @example
-     * ```javascript
-     * // Create a Textmodifier instance
-     * const t = textmode.create();
-     *
-     * t.setup(() => {
-     *  // Set the font size to 32
-     *  t.fontSize(32);
-     * });
-     *
-     * t.draw(() => {
-     *  t.background(0);
-     *  t.char('A');
-     *  t.rect(5, 5);
-     * });
-     * ```
-     */
-    fontSize(size: number): void;
-}