@autumnsgrove/gossamer 0.0.1 → 0.1.1

package/dist/renderer.d.ts

@@ -0,0 +1,140 @@
+/**
+ * Gossamer Core Renderer
+ *
+ * Canvas-based ASCII rendering engine. Converts image data to ASCII characters
+ * by mapping brightness values to a character set.
+ */
+/**
+ * Configuration for the Gossamer renderer
+ */
+export interface RenderConfig {
+    /** Canvas element to render to */
+    canvas: HTMLCanvasElement;
+    /** Character set ordered from light to dark */
+    characters: string;
+    /** Width of each character cell in pixels */
+    cellWidth: number;
+    /** Height of each character cell in pixels */
+    cellHeight: number;
+    /** Color for rendering characters */
+    color: string;
+    /** Background color (empty string for transparent) */
+    backgroundColor: string;
+    /** Font family */
+    fontFamily: string;
+    /** Custom brightness calculation function */
+    brightnessFunction: (r: number, g: number, b: number) => number;
+}
+/**
+ * Core ASCII renderer class
+ *
+ * Handles all canvas rendering operations for ASCII effects.
+ * Supports both static rendering and animation loops.
+ */
+export declare class GossamerRenderer {
+    private ctx;
+    private config;
+    private animationId;
+    private lastFrameTime;
+    private isRunning;
+    private charAtlas;
+    private atlasCharacters;
+    constructor(canvas: HTMLCanvasElement, config?: Partial<Omit<RenderConfig, 'canvas'>>);
+    /**
+     * Build character texture atlas for fast rendering
+     * Pre-renders all characters to an offscreen canvas, then uses drawImage
+     * instead of fillText for 5-10x faster rendering
+     */
+    private buildCharacterAtlas;
+    /**
+     * Set up the canvas with optimal rendering settings
+     */
+    private setupCanvas;
+    /**
+     * Update the renderer configuration
+     */
+    updateConfig(config: Partial<Omit<RenderConfig, 'canvas'>>): void;
+    /**
+     * Resize the canvas to match new dimensions
+     */
+    resize(width: number, height: number): void;
+    /**
+     * Get the current canvas dimensions
+     */
+    getDimensions(): {
+        width: number;
+        height: number;
+    };
+    /**
+     * Calculate the number of cells that fit in the canvas
+     */
+    getCellCount(): {
+        cols: number;
+        rows: number;
+    };
+    /**
+     * Clear the canvas
+     */
+    clear(): void;
+    /**
+     * Render a single frame from image data
+     */
+    renderFrame(imageData: ImageData): void;
+    /**
+     * Render ASCII from a brightness grid (for pattern-based rendering)
+     */
+    renderFromBrightnessGrid(grid: number[][]): void;
+    /**
+     * Render ASCII with per-cell colors (for colored image rendering)
+     */
+    renderWithColors(data: Array<{
+        char: string;
+        color: string;
+        x: number;
+        y: number;
+    }>): void;
+    /**
+     * PERFORMANCE: Render from BrightnessBuffer using texture atlas
+     *
+     * Uses pre-rendered character sprites instead of fillText calls.
+     * 5-10x faster than renderFromBrightnessGrid for large canvases.
+     *
+     * @param buffer - BrightnessBuffer from fillBrightnessBuffer
+     */
+    renderFromBuffer(buffer: {
+        data: Uint8Array;
+        cols: number;
+        rows: number;
+    }): void;
+    /**
+     * PERFORMANCE: Render brightness grid using atlas (legacy grid format)
+     *
+     * @param grid - 2D array of brightness values
+     */
+    renderGridFast(grid: number[][]): void;
+    /**
+     * Calculate average brightness for a cell region
+     */
+    private getCellBrightness;
+    /**
+     * Start an animation loop with FPS limiting
+     */
+    startAnimation(updateFn: (time: number, deltaTime: number) => ImageData | number[][], fps?: number): void;
+    /**
+     * Stop the animation loop
+     */
+    stopAnimation(): void;
+    /**
+     * Check if animation is currently running
+     */
+    isAnimating(): boolean;
+    /**
+     * Pause animation (can be resumed)
+     */
+    pause(): void;
+    /**
+     * Clean up and destroy the renderer
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=renderer.d.ts.map

package/dist/renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../src/renderer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,kCAAkC;IAClC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,kBAAkB,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;CACjE;AAeD;;;;;GAKG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,GAAG,CAA2B;IACtC,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,SAAS,CAAkB;IAGnC,OAAO,CAAC,SAAS,CAAoD;IACrE,OAAO,CAAC,eAAe,CAAc;gBAEzB,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAE,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAM;IAiBzF;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IA6C3B;;OAEG;IACH,OAAO,CAAC,WAAW;IAYnB;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC,GAAG,IAAI;IAiBjE;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAO3C;;OAEG;IACH,aAAa,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAOlD;;OAEG;IACH,YAAY,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;IAU9C;;OAEG;IACH,KAAK,IAAI,IAAI;IAWb;;OAEG;IACH,WAAW,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAoBvC;;OAEG;IACH,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,IAAI;IAmBhD;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI;IAW1F;;;;;;;OAOG;IACH,gBAAgB,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAgDhF;;;;OAIG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,IAAI;IAiCtC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAyBzB;;OAEG;IACH,cAAc,CACZ,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,SAAS,GAAG,MAAM,EAAE,EAAE,EACrE,GAAG,GAAE,MAAW,GACf,IAAI;IAgCP;;OAEG;IACH,aAAa,IAAI,IAAI;IAQrB;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,OAAO,IAAI,IAAI;CAGhB"}

package/dist/style.css

@@ -0,0 +1,124 @@
+
+  .gossamer-clouds.svelte-sqd1fq {
+    position: absolute;
+    inset: 0;
+    width: 100%;
+    height: 100%;
+    overflow: hidden;
+    pointer-events: none;
+    z-index: 0;
+  }
+
+  .gossamer-canvas.svelte-sqd1fq {
+    display: block;
+    width: 100%;
+    height: 100%;
+  }
+
+  .gossamer-image.svelte-1v5c3d1 {
+    position: relative;
+    display: inline-block;
+    overflow: hidden;
+  }
+
+  .gossamer-image.hoverable.svelte-1v5c3d1 {
+    cursor: pointer;
+  }
+
+  .gossamer-canvas.svelte-1v5c3d1 {
+    display: block;
+    opacity: 1;
+    transition-property: opacity;
+    transition-timing-function: ease-in-out;
+  }
+
+  .gossamer-canvas.hidden.svelte-1v5c3d1 {
+    opacity: 0;
+  }
+
+  .gossamer-original.svelte-1v5c3d1 {
+    position: absolute;
+    inset: 0;
+    width: 100%;
+    height: 100%;
+    object-fit: cover;
+    opacity: 0;
+    transition-property: opacity;
+    transition-timing-function: ease-in-out;
+  }
+
+  .gossamer-original.visible.svelte-1v5c3d1 {
+    opacity: 1;
+  }
+
+  .gossamer-image-loading.svelte-1v5c3d1,
+  .gossamer-image-error.svelte-1v5c3d1 {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    width: 100%;
+    height: 100%;
+    min-height: 100px;
+    color: currentColor;
+    opacity: 0.5;
+  }
+
+  .gossamer-image-error.svelte-1v5c3d1 {
+    color: #ef4444;
+  }
+
+  .gossamer-text.svelte-fd3qw5 {
+    position: relative;
+    display: inline-block;
+  }
+
+  .gossamer-canvas.svelte-fd3qw5 {
+    display: block;
+  }
+
+  .gossamer-text-sr.svelte-fd3qw5 {
+    position: absolute;
+    width: 1px;
+    height: 1px;
+    padding: 0;
+    margin: -1px;
+    overflow: hidden;
+    clip: rect(0, 0, 0, 0);
+    white-space: nowrap;
+    border: 0;
+  }
+
+  .gossamer-overlay.svelte-1oexqwo {
+    position: absolute;
+    inset: 0;
+    width: 100%;
+    height: 100%;
+    overflow: hidden;
+    pointer-events: none;
+    z-index: 1;
+  }
+
+  .gossamer-canvas.svelte-1oexqwo {
+    display: block;
+    width: 100%;
+    height: 100%;
+  }
+
+  .gossamer-border.svelte-qe7ze6 {
+    position: relative;
+    display: block;
+  }
+
+  .gossamer-border-canvas.svelte-qe7ze6 {
+    position: absolute;
+    inset: 0;
+    width: 100%;
+    height: 100%;
+    pointer-events: none;
+    z-index: 0;
+  }
+
+  .gossamer-border-content.svelte-qe7ze6 {
+    position: relative;
+    z-index: 1;
+  }

package/dist/svelte/GossamerBorder.svelte.d.ts

@@ -0,0 +1 @@
+export { SvelteComponentTyped as default } from 'svelte';

package/dist/svelte/GossamerClouds.svelte.d.ts

@@ -0,0 +1 @@
+export { SvelteComponentTyped as default } from 'svelte';

package/dist/svelte/GossamerImage.svelte.d.ts

@@ -0,0 +1 @@
+export { SvelteComponentTyped as default } from 'svelte';

package/dist/svelte/GossamerOverlay.svelte.d.ts

@@ -0,0 +1 @@
+export { SvelteComponentTyped as default } from 'svelte';

package/dist/svelte/GossamerText.svelte.d.ts

@@ -0,0 +1 @@
+export { SvelteComponentTyped as default } from 'svelte';

package/dist/svelte/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Gossamer - Svelte 5 Components
+ *
+ * ASCII visual effects components for Svelte applications.
+ *
+ * @packageDocumentation
+ */
+export { default as GossamerClouds } from './GossamerClouds.svelte';
+export { default as GossamerImage } from './GossamerImage.svelte';
+export { default as GossamerText } from './GossamerText.svelte';
+export { default as GossamerOverlay } from './GossamerOverlay.svelte';
+export { default as GossamerBorder } from './GossamerBorder.svelte';
+export type { GossamerCloudsProps } from './GossamerClouds.svelte';
+export type { GossamerImageProps } from './GossamerImage.svelte';
+export type { GossamerTextProps } from './GossamerText.svelte';
+export type { GossamerOverlayProps, BlendMode } from './GossamerOverlay.svelte';
+export type { GossamerBorderProps, BorderStyle } from './GossamerBorder.svelte';
+export { PRESETS, grovePresets, seasonalPresets, ambientPresets, getPreset, getPresetNames, getPresetsByCategory, } from './presets';
+export { type GossamerConfig, type PresetConfig, type PatternConfig, type PatternType, type CharacterSet, DEFAULT_CHARACTERS, DEFAULT_CONFIG, CHARACTER_SETS, calculateBrightness, brightnessToChar, getCharacterSet, getCharacters, getCharacterSetNames, invertCharacters, prefersReducedMotion, VERSION, } from '../index';
+//# sourceMappingURL=index.d.ts.map

package/dist/svelte/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/svelte/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAMpE,YAAY,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,YAAY,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,YAAY,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,YAAY,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAChF,YAAY,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAMhF,OAAO,EACL,OAAO,EACP,YAAY,EACZ,eAAe,EACf,cAAc,EACd,SAAS,EACT,cAAc,EACd,oBAAoB,GACrB,MAAM,WAAW,CAAC;AAMnB,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,YAAY,EAGjB,kBAAkB,EAClB,cAAc,EACd,cAAc,EAGd,mBAAmB,EACnB,gBAAgB,EAGhB,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,gBAAgB,EAGhB,oBAAoB,EAGpB,OAAO,GACR,MAAM,UAAU,CAAC"}