@autumnsgrove/gossamer 0.1.0 → 0.2.0

package/dist/index.test.js

@@ -0,0 +1,92 @@
+/**
+ * Tests for core index functions
+ */
+import { describe, it, expect } from 'vitest';
+import { calculateBrightness, brightnessToChar, DEFAULT_CHARACTERS, DEFAULT_CONFIG, VERSION, } from './index';
+describe('calculateBrightness', () => {
+    it('should return 0 for black', () => {
+        expect(calculateBrightness(0, 0, 0)).toBe(0);
+    });
+    it('should return 255 for white', () => {
+        expect(calculateBrightness(255, 255, 255)).toBeCloseTo(255, 5);
+    });
+    it('should weight green highest', () => {
+        // Green contributes 0.72, so pure green should be brighter than pure red
+        const greenBrightness = calculateBrightness(0, 255, 0);
+        const redBrightness = calculateBrightness(255, 0, 0);
+        const blueBrightness = calculateBrightness(0, 0, 255);
+        expect(greenBrightness).toBeGreaterThan(redBrightness);
+        expect(greenBrightness).toBeGreaterThan(blueBrightness);
+        expect(redBrightness).toBeGreaterThan(blueBrightness);
+    });
+    it('should calculate correct luminance values', () => {
+        // Pure red: 0.21 * 255 = 53.55
+        expect(calculateBrightness(255, 0, 0)).toBeCloseTo(53.55, 1);
+        // Pure green: 0.72 * 255 = 183.6
+        expect(calculateBrightness(0, 255, 0)).toBeCloseTo(183.6, 1);
+        // Pure blue: 0.07 * 255 = 17.85
+        expect(calculateBrightness(0, 0, 255)).toBeCloseTo(17.85, 1);
+    });
+    it('should handle mid-gray', () => {
+        const gray = calculateBrightness(128, 128, 128);
+        // 128 * (0.21 + 0.72 + 0.07) = 128
+        expect(gray).toBe(128);
+    });
+});
+describe('brightnessToChar', () => {
+    it('should return space for brightness 0', () => {
+        expect(brightnessToChar(0)).toBe(' ');
+    });
+    it('should return last character for brightness 255', () => {
+        expect(brightnessToChar(255)).toBe('@');
+    });
+    it('should map mid-brightness to middle character', () => {
+        // With ' .:-=+*#%@' (10 chars), brightness 127-128 should be around index 4-5
+        const char = brightnessToChar(127);
+        expect(['=', '+'].includes(char)).toBe(true);
+    });
+    it('should use custom character set', () => {
+        const customSet = ' abc';
+        expect(brightnessToChar(0, customSet)).toBe(' ');
+        expect(brightnessToChar(255, customSet)).toBe('c');
+    });
+    it('should handle two-character set', () => {
+        const binarySet = ' #';
+        expect(brightnessToChar(0, binarySet)).toBe(' ');
+        expect(brightnessToChar(127, binarySet)).toBe(' ');
+        expect(brightnessToChar(255, binarySet)).toBe('#');
+    });
+    it('should clamp to valid range', () => {
+        // Even with extreme values, should not crash
+        expect(() => brightnessToChar(-10)).not.toThrow();
+        expect(() => brightnessToChar(300)).not.toThrow();
+    });
+});
+describe('DEFAULT_CHARACTERS', () => {
+    it('should be standard ASCII art character set', () => {
+        expect(DEFAULT_CHARACTERS).toBe(' .:-=+*#%@');
+    });
+    it('should start with space', () => {
+        expect(DEFAULT_CHARACTERS[0]).toBe(' ');
+    });
+    it('should have 10 characters', () => {
+        expect(DEFAULT_CHARACTERS.length).toBe(10);
+    });
+});
+describe('DEFAULT_CONFIG', () => {
+    it('should have all required properties', () => {
+        expect(DEFAULT_CONFIG.characters).toBe(DEFAULT_CHARACTERS);
+        expect(DEFAULT_CONFIG.cellWidth).toBe(8);
+        expect(DEFAULT_CONFIG.cellHeight).toBe(12);
+        expect(DEFAULT_CONFIG.color).toBe('#ffffff');
+        expect(DEFAULT_CONFIG.backgroundColor).toBe('');
+        expect(DEFAULT_CONFIG.fontFamily).toBe('monospace');
+        expect(DEFAULT_CONFIG.animate).toBe(false);
+        expect(DEFAULT_CONFIG.fps).toBe(30);
+    });
+});
+describe('VERSION', () => {
+    it('should be a semver string', () => {
+        expect(VERSION).toMatch(/^\d+\.\d+\.\d+$/);
+    });
+});

package/dist/patterns.d.ts

@@ -76,6 +76,84 @@ export declare function staticNoise(seed?: number): number;
  * @returns Value between 0 and 1
  */
 export declare function seededNoise2D(x: number, y: number, seed?: number): number;
+/**
+ * Clouds pattern - soft, billowy fbm with gentle movement
+ * The signature Gossamer effect!
+ *
+ * @param x - X coordinate
+ * @param y - Y coordinate
+ * @param time - Time value for animation
+ * @param config - Pattern configuration
+ * @returns Value between -1 and 1
+ */
+export declare function cloudsPattern(x: number, y: number, time: number, config?: PatternConfig): number;
+/**
+ * Plasma pattern - classic demoscene effect
+ * Combines sine waves at different frequencies and phases
+ *
+ * @param x - X coordinate
+ * @param y - Y coordinate
+ * @param time - Time value for animation
+ * @param config - Pattern configuration
+ * @returns Value between -1 and 1
+ */
+export declare function plasmaPattern(x: number, y: number, time: number, config?: PatternConfig): number;
+/**
+ * Vortex pattern - swirling spiral around center
+ *
+ * @param x - X coordinate
+ * @param y - Y coordinate
+ * @param centerX - Vortex center X
+ * @param centerY - Vortex center Y
+ * @param time - Time value for animation
+ * @param config - Pattern configuration
+ * @returns Value between -1 and 1
+ */
+export declare function vortexPattern(x: number, y: number, centerX: number, centerY: number, time: number, config?: PatternConfig): number;
+/**
+ * Matrix pattern - falling columns like digital rain
+ *
+ * @param x - X coordinate (column)
+ * @param y - Y coordinate (row)
+ * @param time - Time value for animation
+ * @param config - Pattern configuration
+ * @returns Value between -1 and 1
+ */
+export declare function matrixPattern(x: number, y: number, time: number, config?: PatternConfig): number;
+/**
+ * Gradient pattern - smooth animated gradients
+ *
+ * @param x - X coordinate
+ * @param y - Y coordinate
+ * @param cols - Total columns (for normalization)
+ * @param rows - Total rows (for normalization)
+ * @param time - Time value for animation
+ * @param config - Pattern configuration
+ * @returns Value between -1 and 1
+ */
+export declare function gradientPattern(x: number, y: number, cols: number, rows: number, time: number, config?: PatternConfig): number;
+/**
+ * Diamond pattern - interference creating diamond shapes
+ *
+ * @param x - X coordinate
+ * @param y - Y coordinate
+ * @param time - Time value for animation
+ * @param config - Pattern configuration
+ * @returns Value between -1 and 1
+ */
+export declare function diamondPattern(x: number, y: number, time: number, config?: PatternConfig): number;
+/**
+ * Fractal pattern - animated Mandelbrot/Julia set
+ *
+ * @param x - X coordinate
+ * @param y - Y coordinate
+ * @param cols - Total columns (for centering)
+ * @param rows - Total rows (for centering)
+ * @param time - Time value for animation
+ * @param config - Pattern configuration
+ * @returns Value between -1 and 1
+ */
+export declare function fractalPattern(x: number, y: number, cols: number, rows: number, time: number, config?: PatternConfig): number;
 /**
  * Generate a brightness grid for pattern rendering
  *
@@ -86,7 +164,7 @@ export declare function seededNoise2D(x: number, y: number, seed?: number): numb
  * @param config - Pattern configuration
  * @returns 2D array of brightness values (0-255)
  */
-export declare function generateBrightnessGrid(cols: number, rows: number, pattern: 'perlin' | 'waves' | 'static' | 'ripple' | 'fbm', time?: number, config?: PatternConfig): number[][];
+export declare function generateBrightnessGrid(cols: number, rows: number, pattern: PatternType, time?: number, config?: PatternConfig): number[][];
 /**
  * Generate ImageData from a brightness grid
  *
@@ -96,5 +174,44 @@ export declare function generateBrightnessGrid(cols: number, rows: number, patte
  * @returns ImageData object
  */
 export declare function gridToImageData(grid: number[][], cellWidth: number, cellHeight: number): ImageData;
-export type PatternType = 'perlin' | 'waves' | 'static' | 'ripple' | 'fbm';
+export type PatternType = 'perlin' | 'waves' | 'static' | 'ripple' | 'fbm' | 'clouds' | 'plasma' | 'vortex' | 'matrix' | 'gradient' | 'diamond' | 'fractal';
+/**
+ * Reusable brightness buffer using flat Uint8Array
+ * ~30% faster than number[][] due to contiguous memory and no GC pressure
+ */
+export interface BrightnessBuffer {
+    /** Flat array of brightness values (0-255), row-major order */
+    data: Uint8Array;
+    /** Number of columns */
+    cols: number;
+    /** Number of rows */
+    rows: number;
+}
+/**
+ * Create a reusable brightness buffer
+ * Call once at init, then reuse with fillBrightnessBuffer
+ *
+ * @param cols - Number of columns
+ * @param rows - Number of rows
+ * @returns Reusable buffer object
+ */
+export declare function createBrightnessBuffer(cols: number, rows: number): BrightnessBuffer;
+/**
+ * Fill an existing brightness buffer with pattern data (zero allocation)
+ * Use this in animation loops for best performance
+ *
+ * @param buffer - Pre-allocated buffer from createBrightnessBuffer
+ * @param pattern - Pattern type to generate
+ * @param time - Current time in seconds
+ * @param config - Pattern configuration
+ */
+export declare function fillBrightnessBuffer(buffer: BrightnessBuffer, pattern: PatternType, time?: number, config?: PatternConfig): void;
+/**
+ * Get brightness value from buffer at (col, row)
+ * @param buffer - Brightness buffer
+ * @param col - Column index
+ * @param row - Row index
+ * @returns Brightness value 0-255
+ */
+export declare function getBufferValue(buffer: BrightnessBuffer, col: number, row: number): number;
 //# sourceMappingURL=patterns.d.ts.map

package/dist/patterns.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"patterns.d.ts","sourceRoot":"","sources":["../src/patterns.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,aAIpC,CAAC;AAkDF;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAwB1D;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,MAAU,EAAE,WAAW,GAAE,MAAY,GAAG,MAAM,CAcrG;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,aAAsC,GAC7C,MAAM,CAOR;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,aAAsC,GAC7C,MAAM,CAOR;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAOjD;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,GAAE,MAAU,GAAG,MAAM,CAG5E;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,KAAK,EACzD,IAAI,GAAE,MAAU,EAChB,MAAM,GAAE,aAAsC,GAC7C,MAAM,EAAE,EAAE,CAiDZ;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,CAyBlG;AAED,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,KAAK,CAAC"}
+{"version":3,"file":"patterns.d.ts","sourceRoot":"","sources":["../src/patterns.ts"],"names":[],"mappings":"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"}