@autumnsgrove/gossamer 0.0.1

package/README.md

@@ -0,0 +1,39 @@
+# gossamer (core)
+
+Core rendering engine for Gossamer ASCII visual effects.
+
+## Installation
+
+```bash
+pnpm add gossamer
+# or
+npm install gossamer
+```
+
+## Usage
+
+```typescript
+import { GossamerRenderer, generatePatternData } from 'gossamer';
+
+const canvas = document.getElementById('myCanvas') as HTMLCanvasElement;
+const renderer = new GossamerRenderer(canvas, {
+  characters: ' ·∙•◦○◉●',
+  cellSize: 12,
+  color: '#22c55e'
+});
+
+// Render animated clouds
+renderer.startAnimation((time) => {
+  return generatePatternData(
+    canvas.width,
+    canvas.height,
+    'perlin',
+    time * 0.001,
+    { frequency: 0.05, amplitude: 1.0, speed: 0.5 }
+  );
+}, 30);
+```
+
+## Documentation
+
+See the [main repository](https://github.com/AutumnsGrove/Gossamer) for full documentation.

package/dist/index.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Gossamer - ASCII Visual Effects Library
+ *
+ * Threads of light. Delicate textures woven through your space.
+ *
+ * @packageDocumentation
+ */
+/**
+ * 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;
+}
+/**
+ * Default character set ordered from light to dark
+ */
+export declare const DEFAULT_CHARACTERS = " .:-=+*#%@";
+/**
+ * Default configuration values
+ */
+export declare const DEFAULT_CONFIG: Required<GossamerConfig>;
+/**
+ * Calculate brightness from RGB values using luminance formula
+ * Uses the standard luminance coefficients: 0.21 R + 0.72 G + 0.07 B
+ */
+export declare function calculateBrightness(r: number, g: number, b: number): number;
+/**
+ * Map a brightness value (0-255) to an ASCII character
+ */
+export declare function brightnessToChar(brightness: number, characters?: string): string;
+/**
+ * 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
+ */
+export declare const VERSION = "0.0.1";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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"}

package/dist/index.js

@@ -0,0 +1,27 @@
+const DEFAULT_CHARACTERS = " .:-=+*#%@";
+const DEFAULT_CONFIG = {
+  characters: DEFAULT_CHARACTERS,
+  cellWidth: 8,
+  cellHeight: 12,
+  color: "#ffffff",
+  backgroundColor: "",
+  fontFamily: "monospace",
+  animate: false,
+  fps: 30
+};
+function calculateBrightness(r, g, b) {
+  return 0.21 * r + 0.72 * g + 0.07 * b;
+}
+function brightnessToChar(brightness, characters = DEFAULT_CHARACTERS) {
+  const index = Math.floor(brightness / 255 * (characters.length - 1));
+  return characters[Math.min(index, characters.length - 1)];
+}
+const VERSION = "0.0.1";
+export {
+  DEFAULT_CHARACTERS,
+  DEFAULT_CONFIG,
+  VERSION,
+  brightnessToChar,
+  calculateBrightness
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/index.ts"],"sourcesContent":["/**\n * Gossamer - ASCII Visual Effects Library\n *\n * Threads of light. Delicate textures woven through your space.\n *\n * @packageDocumentation\n */\n\n/**\n * Core configuration for ASCII rendering\n */\nexport interface GossamerConfig {\n  /** Character set for ASCII rendering (light to dark) */\n  characters?: string;\n  /** Cell width in pixels */\n  cellWidth?: number;\n  /** Cell height in pixels */\n  cellHeight?: number;\n  /** Foreground color */\n  color?: string;\n  /** Background color (transparent if not set) */\n  backgroundColor?: string;\n  /** Font family for ASCII characters */\n  fontFamily?: string;\n  /** Enable animation loop */\n  animate?: boolean;\n  /** Target FPS for animation */\n  fps?: number;\n}\n\n/**\n * Default character set ordered from light to dark\n */\nexport const DEFAULT_CHARACTERS = ' .:-=+*#%@';\n\n/**\n * Default configuration values\n */\nexport const DEFAULT_CONFIG: Required<GossamerConfig> = {\n  characters: DEFAULT_CHARACTERS,\n  cellWidth: 8,\n  cellHeight: 12,\n  color: '#ffffff',\n  backgroundColor: '',\n  fontFamily: 'monospace',\n  animate: false,\n  fps: 30,\n};\n\n/**\n * Calculate brightness from RGB values using luminance formula\n * Uses the standard luminance coefficients: 0.21 R + 0.72 G + 0.07 B\n */\nexport function calculateBrightness(r: number, g: number, b: number): number {\n  return 0.21 * r + 0.72 * g + 0.07 * b;\n}\n\n/**\n * Map a brightness value (0-255) to an ASCII character\n */\nexport function brightnessToChar(\n  brightness: number,\n  characters: string = DEFAULT_CHARACTERS\n): string {\n  const index = Math.floor((brightness / 255) * (characters.length - 1));\n  return characters[Math.min(index, characters.length - 1)];\n}\n\n/**\n * Gossamer v0.0.1 - Placeholder release\n *\n * Full implementation coming soon. This package will provide:\n * - 2D Canvas ASCII rendering\n * - Ambient pattern generation\n * - Image-to-ASCII conversion\n * - Animation loops\n * - Framework adapters (Svelte, React, Vue)\n *\n * @see https://github.com/AutumnsGrove/Gossamer\n */\nexport const VERSION = '0.0.1';\n"],"names":[],"mappings":"AAiCO,MAAM,qBAAqB;AAK3B,MAAM,iBAA2C;AAAA,EACtD,YAAY;AAAA,EACZ,WAAW;AAAA,EACX,YAAY;AAAA,EACZ,OAAO;AAAA,EACP,iBAAiB;AAAA,EACjB,YAAY;AAAA,EACZ,SAAS;AAAA,EACT,KAAK;AACP;AAMO,SAAS,oBAAoB,GAAW,GAAW,GAAmB;AAC3E,SAAO,OAAO,IAAI,OAAO,IAAI,OAAO;AACtC;AAKO,SAAS,iBACd,YACA,aAAqB,oBACb;AACR,QAAM,QAAQ,KAAK,MAAO,aAAa,OAAQ,WAAW,SAAS,EAAE;AACrE,SAAO,WAAW,KAAK,IAAI,OAAO,WAAW,SAAS,CAAC,CAAC;AAC1D;AAcO,MAAM,UAAU;"}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@autumnsgrove/gossamer",
+  "version": "0.0.1",
+  "description": "ASCII visual effects library - Threads of light for your web applications",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "dev": "vite build --watch",
+    "build": "tsc && vite build",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "clean": "rm -rf dist"
+  },
+  "keywords": [
+    "ascii",
+    "ascii-art",
+    "canvas",
+    "visual-effects",
+    "animation",
+    "graphics",
+    "text-art",
+    "ambient",
+    "texture",
+    "pattern"
+  ],
+  "author": "AutumnsGrove",
+  "license": "MIT",
+  "homepage": "https://github.com/AutumnsGrove/Gossamer#readme",
+  "bugs": {
+    "url": "https://github.com/AutumnsGrove/Gossamer/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AutumnsGrove/Gossamer.git",
+    "directory": "packages/core"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "typescript": "^5.3.0",
+    "vite": "^5.0.0",
+    "vite-plugin-dts": "^3.7.0",
+    "vitest": "^1.0.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1,81 @@
+/**
+ * Gossamer - ASCII Visual Effects Library
+ *
+ * Threads of light. Delicate textures woven through your space.
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * 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;
+}
+
+/**
+ * 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,
+};
+
+/**
+ * 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)];
+}
+
+/**
+ * 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
+ */
+export const VERSION = '0.0.1';