@autumnsgrove/gossamer 0.0.1 → 0.1.0

package/dist/animation.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Gossamer Animation Utilities
+ *
+ * FPS limiting, animation loop management, and timing utilities.
+ */
+/**
+ * Animation state for tracking loop execution
+ */
+export interface AnimationState {
+    /** Whether animation is currently running */
+    isRunning: boolean;
+    /** Current animation frame ID */
+    frameId: number | null;
+    /** Timestamp of last frame */
+    lastFrameTime: number;
+    /** Frame interval in ms (derived from FPS) */
+    frameInterval: number;
+    /** Total elapsed time in ms */
+    elapsedTime: number;
+    /** Current frame count */
+    frameCount: number;
+}
+/**
+ * Options for creating an animation loop
+ */
+export interface AnimationOptions {
+    /** Target frames per second (default: 30) */
+    fps?: number;
+    /** Callback when animation starts */
+    onStart?: () => void;
+    /** Callback when animation stops */
+    onStop?: () => void;
+    /** Callback for each frame - return false to stop */
+    onFrame: (time: number, deltaTime: number, frameCount: number) => boolean | void;
+}
+/**
+ * Create a managed animation loop with FPS limiting
+ */
+export declare function createAnimationLoop(options: AnimationOptions): {
+    start: () => void;
+    stop: () => void;
+    pause: () => void;
+    resume: () => void;
+    getState: () => AnimationState;
+};
+/**
+ * Simple throttle function for limiting function execution
+ */
+export declare function throttle<T extends (...args: unknown[]) => unknown>(fn: T, limit: number): (...args: Parameters<T>) => void;
+/**
+ * Debounce function for delaying execution until activity stops
+ */
+export declare function debounce<T extends (...args: unknown[]) => unknown>(fn: T, delay: number): (...args: Parameters<T>) => void;
+/**
+ * Calculate actual FPS from frame times
+ */
+export declare function calculateFPS(frameTimes: number[], sampleSize?: number): number;
+/**
+ * Easing functions for smooth animations
+ */
+export declare const easings: {
+    /** Linear - no easing */
+    linear: (t: number) => number;
+    /** Ease in - slow start */
+    easeIn: (t: number) => number;
+    /** Ease out - slow end */
+    easeOut: (t: number) => number;
+    /** Ease in/out - slow start and end */
+    easeInOut: (t: number) => number;
+    /** Sine ease in */
+    sineIn: (t: number) => number;
+    /** Sine ease out */
+    sineOut: (t: number) => number;
+    /** Sine ease in/out */
+    sineInOut: (t: number) => number;
+    /** Bounce at end */
+    bounceOut: (t: number) => number;
+};
+export type EasingFunction = (t: number) => number;
+//# sourceMappingURL=animation.d.ts.map

package/dist/animation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animation.d.ts","sourceRoot":"","sources":["../src/animation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,6CAA6C;IAC7C,SAAS,EAAE,OAAO,CAAC;IACnB,iCAAiC;IACjC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,8BAA8B;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,aAAa,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,qDAAqD;IACrD,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,OAAO,GAAG,IAAI,CAAC;CAClF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,GAAG;IAC9D,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,QAAQ,EAAE,MAAM,cAAc,CAAC;CAChC,CAyFA;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EAChE,EAAE,EAAE,CAAC,EACL,KAAK,EAAE,MAAM,GACZ,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAkBlC;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EAChE,EAAE,EAAE,CAAC,EACL,KAAK,EAAE,MAAM,GACZ,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAalC;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,UAAU,GAAE,MAAW,GAAG,MAAM,CAUlF;AAED;;GAEG;AACH,eAAO,MAAM,OAAO;IAClB,yBAAyB;gBACb,MAAM,KAAG,MAAM;IAE3B,2BAA2B;gBACf,MAAM,KAAG,MAAM;IAE3B,0BAA0B;iBACb,MAAM,KAAG,MAAM;IAE5B,uCAAuC;mBACxB,MAAM,KAAG,MAAM;IAE9B,mBAAmB;gBACP,MAAM,KAAG,MAAM;IAE3B,oBAAoB;iBACP,MAAM,KAAG,MAAM;IAE5B,uBAAuB;mBACR,MAAM,KAAG,MAAM;IAE9B,oBAAoB;mBACL,MAAM,KAAG,MAAM;CAc/B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC"}

package/dist/characters.d.ts

@@ -0,0 +1,49 @@
+/**
+ * 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 declare const CHARACTER_SETS: Record<string, CharacterSet>;
+/**
+ * Get a character set by name
+ */
+export declare function getCharacterSet(name: string): CharacterSet | undefined;
+/**
+ * Get just the characters string from a named set
+ */
+export declare function getCharacters(name: string): string;
+/**
+ * List all available character set names
+ */
+export declare function getCharacterSetNames(): string[];
+/**
+ * Create a custom character set
+ */
+export declare function createCharacterSet(name: string, characters: string, description?: string, bestFor?: string[]): CharacterSet;
+/**
+ * Validate that a character string is suitable for ASCII rendering
+ * (should start with space and have at least 2 characters)
+ */
+export declare function validateCharacterSet(characters: string): boolean;
+/**
+ * Reverse a character set (for inverted brightness mapping)
+ */
+export declare function invertCharacters(characters: string): string;
+//# sourceMappingURL=characters.d.ts.map

package/dist/characters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"characters.d.ts","sourceRoot":"","sources":["../src/characters.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAoFvD,CAAC;AAEF;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEtE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAE/C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,WAAW,GAAE,MAAW,EACxB,OAAO,GAAE,MAAM,EAAO,GACrB,YAAY,CAOd;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAIhE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE3D"}

package/dist/index.d.ts

@@ -26,6 +26,27 @@ export interface GossamerConfig {
     /** 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;
+}
 /**
  * Default character set ordered from light to dark
  */
@@ -43,17 +64,22 @@ export declare function calculateBrightness(r: number, g: number, b: number): nu
  * Map a brightness value (0-255) to an ASCII character
  */
 export declare function brightnessToChar(brightness: number, characters?: string): string;
+export { GossamerRenderer } from './renderer';
+export type { RenderConfig } from './renderer';
+export { perlinNoise2D, fbmNoise, wavePattern, ripplePattern, staticNoise, seededNoise2D, generateBrightnessGrid, gridToImageData, DEFAULT_PATTERN_CONFIG, } from './patterns';
+export type { PatternConfig, PatternType } from './patterns';
+export { CHARACTER_SETS, getCharacterSet, getCharacters, getCharacterSetNames, createCharacterSet, validateCharacterSet, invertCharacters, } from './characters';
+export type { CharacterSet } from './characters';
+export { createAnimationLoop, throttle, debounce, calculateFPS, easings, } from './animation';
+export type { AnimationState, AnimationOptions, EasingFunction } from './animation';
+export { createCanvas, getDevicePixelRatio, resizeCanvasToContainer, createOffscreenCanvas, clearCanvas, getImageData, optimizeContext, setupTextRendering, measureTextWidth, calculateCellSize, setBlendMode, } from './utils/canvas';
+export type { CanvasOptions } from './utils/canvas';
+export { loadImage, loadAndScaleImage, imageToPixelData, extractBrightness, sampleImageCells, rgbToHex, hexToRgb, adjustBrightness, adjustContrast, invertColors, toGrayscale, } from './utils/image';
+export type { ImageLoadOptions } from './utils/image';
+export { createVisibilityObserver, createResizeObserver, prefersReducedMotion, onReducedMotionChange, isLowPowerMode, getRecommendedFPS, createFPSCounter, requestIdleCallback, cancelIdleCallback, isBrowser, isCanvasSupported, isOffscreenCanvasSupported, } from './utils/performance';
+export type { VisibilityCallback, PerformanceMetrics } from './utils/performance';
 /**
- * Gossamer v0.0.1 - Placeholder release
- *
- * Full implementation coming soon. This package will provide:
- * - 2D Canvas ASCII rendering
- * - Ambient pattern generation
- * - Image-to-ASCII conversion
- * - Animation loops
- * - Framework adapters (Svelte, React, Vue)
- *
- * @see https://github.com/AutumnsGrove/Gossamer
+ * Gossamer version
  */
-export declare const VERSION = "0.0.1";
+export declare const VERSION = "0.1.0";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2BAA2B;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uBAAuB;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uCAAuC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,+BAA+B;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,eAAe,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,cAAc,CASnD,CAAC;AAEF;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAE3E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,MAAM,EAClB,UAAU,GAAE,MAA2B,GACtC,MAAM,CAGR;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,OAAO,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}