@autumnsgrove/gossamer 0.1.0 → 0.2.0

package/src/characters.ts

@@ -1,164 +0,0 @@
-/**
- * Gossamer Character Sets
- *
- * Predefined character sets for ASCII rendering, ordered from light to dark.
- * Character density determines which character represents each brightness level.
- */
-
-/**
- * Character set configuration
- */
-export interface CharacterSet {
-  /** Unique identifier for the character set */
-  name: string;
-  /** Description of the set's aesthetic */
-  description: string;
-  /** Characters ordered from lightest (space) to darkest */
-  characters: string;
-  /** Recommended use cases */
-  bestFor: string[];
-}
-
-/**
- * Standard character sets for ASCII rendering
- */
-export const CHARACTER_SETS: Record<string, CharacterSet> = {
-  standard: {
-    name: 'Standard',
-    description: 'Classic ASCII art character set',
-    characters: ' .:-=+*#%@',
-    bestFor: ['general', 'images', 'patterns'],
-  },
-
-  dense: {
-    name: 'Dense',
-    description: 'High detail character set with many gradations',
-    characters: " .'`^\",:;Il!i><~+_-?][}{1)(|\\/tfjrxnuvczXYUJCLQ0OZmwqpdbkhao*#MW&8%B@$",
-    bestFor: ['detailed images', 'portraits', 'high contrast'],
-  },
-
-  minimal: {
-    name: 'Minimal',
-    description: 'Clean and simple with few characters',
-    characters: ' .:*#',
-    bestFor: ['backgrounds', 'subtle effects', 'clean aesthetic'],
-  },
-
-  grove: {
-    name: 'Grove',
-    description: 'Organic, soft characters inspired by nature',
-    characters: ' ·∙•◦○◉●',
-    bestFor: ['organic patterns', 'soft backgrounds', 'nature themes'],
-  },
-
-  dots: {
-    name: 'Dots',
-    description: 'Braille-like dot patterns',
-    characters: ' ⋅∘∙●',
-    bestFor: ['stipple effects', 'pointillism', 'dotted textures'],
-  },
-
-  blocks: {
-    name: 'Blocks',
-    description: 'Block-based characters for sharp edges',
-    characters: ' ░▒▓█',
-    bestFor: ['retro effects', 'pixel art', 'bold patterns'],
-  },
-
-  lines: {
-    name: 'Lines',
-    description: 'Line-based characters for directional effects',
-    characters: ' -─═╌│┃',
-    bestFor: ['rain effects', 'streaks', 'motion blur'],
-  },
-
-  stars: {
-    name: 'Stars',
-    description: 'Star and sparkle characters',
-    characters: ' ·✧✦✫✬✯★',
-    bestFor: ['sparkle effects', 'night sky', 'magical themes'],
-  },
-
-  nature: {
-    name: 'Nature',
-    description: 'Nature-themed decorative characters',
-    characters: ' .~≈∿⌇☘',
-    bestFor: ['decorative', 'themed effects', 'organic patterns'],
-  },
-
-  weather: {
-    name: 'Weather',
-    description: 'Weather-related symbols',
-    characters: ' ·.:*❄❅❆',
-    bestFor: ['snow effects', 'weather simulations', 'seasonal themes'],
-  },
-
-  binary: {
-    name: 'Binary',
-    description: 'Digital-style binary characters',
-    characters: ' 01',
-    bestFor: ['digital effects', 'matrix style', 'tech themes'],
-  },
-
-  math: {
-    name: 'Math',
-    description: 'Mathematical symbols',
-    characters: ' +-×÷=≠≈∞',
-    bestFor: ['abstract patterns', 'tech themes', 'decorative'],
-  },
-};
-
-/**
- * Get a character set by name
- */
-export function getCharacterSet(name: string): CharacterSet | undefined {
-  return CHARACTER_SETS[name];
-}
-
-/**
- * Get just the characters string from a named set
- */
-export function getCharacters(name: string): string {
-  return CHARACTER_SETS[name]?.characters || CHARACTER_SETS.standard.characters;
-}
-
-/**
- * List all available character set names
- */
-export function getCharacterSetNames(): string[] {
-  return Object.keys(CHARACTER_SETS);
-}
-
-/**
- * Create a custom character set
- */
-export function createCharacterSet(
-  name: string,
-  characters: string,
-  description: string = '',
-  bestFor: string[] = []
-): CharacterSet {
-  return {
-    name,
-    description,
-    characters,
-    bestFor,
-  };
-}
-
-/**
- * Validate that a character string is suitable for ASCII rendering
- * (should start with space and have at least 2 characters)
- */
-export function validateCharacterSet(characters: string): boolean {
-  if (characters.length < 2) return false;
-  if (characters[0] !== ' ') return false;
-  return true;
-}
-
-/**
- * Reverse a character set (for inverted brightness mapping)
- */
-export function invertCharacters(characters: string): string {
-  return characters.split('').reverse().join('');
-}

package/src/index.test.ts

@@ -1,115 +0,0 @@
-/**
- * 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/src/index.ts

@@ -1,203 +0,0 @@
-/**
- * Gossamer - ASCII Visual Effects Library
- *
- * Threads of light. Delicate textures woven through your space.
- *
- * @packageDocumentation
- */
-
-// =============================================================================
-// Core Types
-// =============================================================================
-
-/**
- * Core configuration for ASCII rendering
- */
-export interface GossamerConfig {
-  /** Character set for ASCII rendering (light to dark) */
-  characters?: string;
-  /** Cell width in pixels */
-  cellWidth?: number;
-  /** Cell height in pixels */
-  cellHeight?: number;
-  /** Foreground color */
-  color?: string;
-  /** Background color (transparent if not set) */
-  backgroundColor?: string;
-  /** Font family for ASCII characters */
-  fontFamily?: string;
-  /** Enable animation loop */
-  animate?: boolean;
-  /** Target FPS for animation */
-  fps?: number;
-}
-
-/**
- * Preset configuration for effects
- */
-export interface PresetConfig {
-  /** Preset display name */
-  name: string;
-  /** Preset description */
-  description: string;
-  /** Character set */
-  characters: string;
-  /** Pattern type */
-  pattern: 'perlin' | 'waves' | 'static' | 'ripple' | 'fbm';
-  /** Pattern frequency */
-  frequency: number;
-  /** Pattern amplitude */
-  amplitude: number;
-  /** Animation speed */
-  speed: number;
-  /** Default opacity */
-  opacity: number;
-}
-
-// =============================================================================
-// Constants
-// =============================================================================
-
-/**
- * Default character set ordered from light to dark
- */
-export const DEFAULT_CHARACTERS = ' .:-=+*#%@';
-
-/**
- * Default configuration values
- */
-export const DEFAULT_CONFIG: Required<GossamerConfig> = {
-  characters: DEFAULT_CHARACTERS,
-  cellWidth: 8,
-  cellHeight: 12,
-  color: '#ffffff',
-  backgroundColor: '',
-  fontFamily: 'monospace',
-  animate: false,
-  fps: 30,
-};
-
-// =============================================================================
-// Core Functions
-// =============================================================================
-
-/**
- * Calculate brightness from RGB values using luminance formula
- * Uses the standard luminance coefficients: 0.21 R + 0.72 G + 0.07 B
- */
-export function calculateBrightness(r: number, g: number, b: number): number {
-  return 0.21 * r + 0.72 * g + 0.07 * b;
-}
-
-/**
- * Map a brightness value (0-255) to an ASCII character
- */
-export function brightnessToChar(
-  brightness: number,
-  characters: string = DEFAULT_CHARACTERS
-): string {
-  const index = Math.floor((brightness / 255) * (characters.length - 1));
-  return characters[Math.min(index, characters.length - 1)];
-}
-
-// =============================================================================
-// Module Exports
-// =============================================================================
-
-// Renderer
-export { GossamerRenderer } from './renderer';
-export type { RenderConfig } from './renderer';
-
-// Patterns
-export {
-  perlinNoise2D,
-  fbmNoise,
-  wavePattern,
-  ripplePattern,
-  staticNoise,
-  seededNoise2D,
-  generateBrightnessGrid,
-  gridToImageData,
-  DEFAULT_PATTERN_CONFIG,
-} from './patterns';
-export type { PatternConfig, PatternType } from './patterns';
-
-// Characters
-export {
-  CHARACTER_SETS,
-  getCharacterSet,
-  getCharacters,
-  getCharacterSetNames,
-  createCharacterSet,
-  validateCharacterSet,
-  invertCharacters,
-} from './characters';
-export type { CharacterSet } from './characters';
-
-// Animation
-export {
-  createAnimationLoop,
-  throttle,
-  debounce,
-  calculateFPS,
-  easings,
-} from './animation';
-export type { AnimationState, AnimationOptions, EasingFunction } from './animation';
-
-// Canvas Utilities
-export {
-  createCanvas,
-  getDevicePixelRatio,
-  resizeCanvasToContainer,
-  createOffscreenCanvas,
-  clearCanvas,
-  getImageData,
-  optimizeContext,
-  setupTextRendering,
-  measureTextWidth,
-  calculateCellSize,
-  setBlendMode,
-} from './utils/canvas';
-export type { CanvasOptions } from './utils/canvas';
-
-// Image Utilities
-export {
-  loadImage,
-  loadAndScaleImage,
-  imageToPixelData,
-  extractBrightness,
-  sampleImageCells,
-  rgbToHex,
-  hexToRgb,
-  adjustBrightness,
-  adjustContrast,
-  invertColors,
-  toGrayscale,
-} from './utils/image';
-export type { ImageLoadOptions } from './utils/image';
-
-// Performance Utilities
-export {
-  createVisibilityObserver,
-  createResizeObserver,
-  prefersReducedMotion,
-  onReducedMotionChange,
-  isLowPowerMode,
-  getRecommendedFPS,
-  createFPSCounter,
-  requestIdleCallback,
-  cancelIdleCallback,
-  isBrowser,
-  isCanvasSupported,
-  isOffscreenCanvasSupported,
-} from './utils/performance';
-export type { VisibilityCallback, PerformanceMetrics } from './utils/performance';
-
-// =============================================================================
-// Version
-// =============================================================================
-
-/**
- * Gossamer version
- */
-export const VERSION = '0.1.0';