textmode.js 0.7.0 → 0.7.1-beta.2

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

@@ -1,5 +1,4 @@
 import type { GLRenderer, GLFramebuffer } from '../../rendering';
-import type { TextmodeGrid } from '../Grid';
 import type { TextmodeLayer } from './TextmodeLayer';
 /**
  * Parameters for the composite operation.
@@ -15,6 +14,18 @@ export interface CompositeParams {
     baseLayer: TextmodeLayer;
     /** The array of user layers to composite on top of the base. */
     layers: readonly TextmodeLayer[];
+    /** Canvas width in pixels. */
+    canvasWidth: number;
+    /** Canvas height in pixels. */
+    canvasHeight: number;
+    /** Grid width in pixels (layer size). */
+    gridWidth: number;
+    /** Grid height in pixels (layer size). */
+    gridHeight: number;
+    /** X offset to center the grid within the canvas. */
+    baseOffsetX: number;
+    /** Y offset to center the grid within the canvas. */
+    baseOffsetY: number;
 }
 /**
  * Handles the compositing of multiple layers using shader-based blending.
@@ -42,16 +53,16 @@ export declare class Layer2DCompositor {
     constructor(renderer: GLRenderer);
     /**
      * Initialize the compositor's framebuffers.
-     * @param grid The grid defining the render dimensions.
+     * @param canvasWidth The canvas width in pixels.
+     * @param canvasHeight The canvas height in pixels.
      * @ignore
      */
-    $initialize(grid: TextmodeGrid): void;
+    $initialize(canvasWidth: number, canvasHeight: number): void;
     /**
      * Composite all layers onto the target framebuffer.
      * @param params The composite parameters.
-     * @param grid The grid defining render dimensions.
      */
-    $composite(params: CompositeParams, grid: TextmodeGrid): void;
+    $composite(params: CompositeParams): void;
     /**
      * Blend a single layer onto the current composite.
      */
@@ -62,10 +73,11 @@ export declare class Layer2DCompositor {
     private _copyToTarget;
     /**
      * Resize the compositor's framebuffers.
-     * @param grid The grid defining the new dimensions.
+     * @param canvasWidth The canvas width in pixels.
+     * @param canvasHeight The canvas height in pixels.
      * @ignore
      */
-    $resize(grid: TextmodeGrid): void;
+    $resize(canvasWidth: number, canvasHeight: number): void;
     /**
      * Dispose of all compositor resources.
      * @ignore

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

@@ -25,6 +25,8 @@ export declare class TextmodeLayer implements ITextmodeLayer {
     $offsetX: number;
     /** @ignore */
     $offsetY: number;
+    /** @ignore */
+    $rotation: number;
     private _deps?;
     private _drawFramebuffer?;
     private _asciiFramebuffer?;
@@ -66,6 +68,7 @@ export declare class TextmodeLayer implements ITextmodeLayer {
         x: number;
         y: number;
     } | void;
+    rotateZ(z?: number): number | void;
     filter<T extends BuiltInFilterName>(name: T, params?: BuiltInFilterParams[T]): void;
     filter(name: FilterName, params?: unknown): void;
     /**

package/dist/types/textmode/layers/interfaces/ITextmodeLayer.d.ts

@@ -269,6 +269,38 @@ export interface ITextmodeLayer {
         x: number;
         y: number;
     } | void;
+    /**
+     * Set or get the layer's rotation in degrees around its center.
+     *
+     * The rotation is applied during compositing around the center of the layer's
+     * rectangular bounds. The rotation origin remains at the center even when
+     * an offset is applied.
+     *
+     * @param z The rotation angle in degrees. Positive values rotate clockwise.
+     * @returns The current rotation in degrees if no parameter is provided.
+     *
+     * @example
+     * ```typescript
+     * const t = textmode.create();
+     *
+     * const rotatingLayer = t.layers.add({ blendMode: 'normal', opacity: 1.0 });
+     *
+     * rotatingLayer.draw(() => {
+     *   t.clear();
+     *   t.charColor(255, 200, 100);
+     *   t.char('#');
+     *   t.rect(10, 5);
+     * });
+     *
+     * t.draw(() => {
+     *   t.background(20, 20, 40);
+     *
+     *   // Rotate the layer over time
+     *   rotatingLayer.rotate(t.frameCount * 2);
+     * });
+     * ```
+     */
+    rotateZ(z?: number): number | void;
     /**
      * Apply a post-processing filter to this layer's rendered output.
      *

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

@@ -46,6 +46,10 @@ export interface TextmodeLayerOptions {
      * The vertical offset of the layer in pixels. Default is `0`.
      */
     offsetY?: number;
+    /**
+     * The rotation of the layer in degrees around its center. Default is `0`.
+     */
+    rotation?: number;
 }
 /**
  * Dependencies required by a TextmodeLayer to function.

package/package.json

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