git-hash-art 0.0.1

package/.release-it.json

@@ -0,0 +1,17 @@
+{
+  "npm": {
+    "publish": true
+  },
+  "github": {
+    "publish": true,
+    "release": true
+  },
+  "git": {
+    "requireBranch": "main",
+    "commitMessage": "chore: release v${version}"
+  },
+  "hooks": {
+    "before:init": ["git pull", "yarn lint"],
+    "after:bump": "npx auto-changelog -p"
+  }
+}

package/README.md

@@ -0,0 +1,138 @@
+# git-hash-art
+
+Generate beautiful, deterministic abstract art from git commit hashes. Perfect for creating unique visual representations of your project's commits, generating placeholder images, or creating artistic wallpapers.
+
+## Features
+
+- Generate consistent, deterministic abstract art from any git hash
+- Configurable canvas sizes and output formats
+- Built-in presets for common social media and device sizes
+- Harmonious color schemes based on hash values
+- Grid-based composition system for balanced layouts
+- Multiple shape types and layering effects
+- Customizable output settings
+
+## Installation
+
+```bash
+npm install git-hash-art
+```
+
+## Basic Usage
+
+```javascript
+import { generateImageFromHash } from 'git-hash-art';
+
+// Generate art from a git hash with default settings
+const gitHash = '46192e59d42f741c761cbea79462a8b3815dd905';
+generateImageFromHash(gitHash);
+```
+
+## Advanced Usage
+
+```javascript
+// Custom configuration
+const config = {
+  width: 1920,
+  height: 1080,
+  gridSize: 6,
+  layers: 7,
+  shapesPerLayer: 30,
+  minShapeSize: 20,
+  maxShapeSize: 180,
+  baseOpacity: 0.6,
+  opacityReduction: 0.1
+};
+
+generateImageFromHash(gitHash, config);
+```
+
+## Configuration Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `width` | number | 1024 | Canvas width in pixels |
+| `height` | number | 1024 | Canvas height in pixels |
+| `gridSize` | number | 4 | Number of grid cells (gridSize x gridSize) |
+| `layers` | number | 5 | Number of layers to generate |
+| `shapesPerLayer` | number | - | Base number of shapes per layer (defaults to grid cells * 1.5) |
+| `minShapeSize` | number | 20 | Minimum shape size |
+| `maxShapeSize` | number | 180 | Maximum shape size |
+| `baseOpacity` | number | 0.6 | Starting opacity for first layer |
+| `opacityReduction` | number | 0.1 | How much to reduce opacity per layer |
+
+## Preset Sizes
+
+The package includes several preset configurations for common use cases:
+
+```javascript
+import { PRESETS } from 'git-hash-art-generator';
+
+// Generate an Instagram-sized image
+generateImageFromHash(gitHash, PRESETS['instagram'].config);
+
+// Generate a mobile wallpaper
+generateImageFromHash(gitHash, PRESETS['phone-wallpaper'].config);
+```
+
+Available presets include:
+- Standard (1024x1024)
+- Banner (1920x480)
+- Ultrawide (3440x1440)
+- Instagram (1080x1080)
+- Instagram Story (1080x1920)
+- Twitter Header (1500x500)
+- LinkedIn Banner (1584x396)
+- Phone Wallpaper (1170x2532)
+- Tablet Wallpaper (2048x2732)
+- Print sizes (A4/A3 at 300 DPI)
+
+## CLI Usage
+
+The package includes a command-line interface:
+
+```bash
+# Generate with default settings
+npx git-hash-art current
+
+# Generate from specific hash
+npx git-hash-art generate <hash>
+
+# Generate with custom size
+npx git-hash-art generate <hash> --width 1920 --height 1080
+```
+
+## Integration Examples
+
+### GitHub Actions
+
+```yaml
+name: Generate Commit Art
+on: [push]
+jobs:
+  generate-art:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/setup-node@v2
+      - run: npm install git-hash-art-generator
+      - run: npx git-hash-art current --output artwork/
+```
+
+### Git Hooks
+
+```bash
+#!/bin/sh
+# .git/hooks/post-commit
+
+hash=$(git rev-parse HEAD)
+npx git-hash-art generate $hash --output .git/artwork/
+```
+
+## Contributing
+
+Contributions are welcome! Please see our [Contributing Guidelines](CONTRIBUTING.md) for more details.
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.

package/bin/generateExamples.js

@@ -0,0 +1,59 @@
+import fs from 'fs';
+import path from 'path';
+import { generateImageFromHash, saveImageToFile } from '../dist/main.js';
+import { PRESETS } from '../src/lib/constants.js';
+
+const OUTPUT_DIR = './examples';
+
+// Ensure the output directory exists
+if (!fs.existsSync(OUTPUT_DIR)) {
+  fs.mkdirSync(OUTPUT_DIR, { recursive: true });
+}
+
+function generateTestCases() {
+  console.log("Generating test cases...");
+  console.log("Output directory:", path.resolve(OUTPUT_DIR));
+
+  const results = [];
+  for (const [label, testCase] of Object.entries(PRESETS)) {
+    try {
+      console.log(`Generating image for ${label}...`);
+      const imageBuffer = generateImageFromHash(testCase.hash, {
+        width: testCase.width,
+        height: testCase.height,
+        ...testCase, // Include any additional configuration from the preset
+      });
+      const outputPath = saveImageToFile(imageBuffer, OUTPUT_DIR, testCase.hash, label, testCase.width, testCase.height);
+      results.push({ label, hash: testCase.hash, outputPath, success: true });
+    } catch (error) {
+      console.error(`Failed to generate image for ${label}:`, error);
+      results.push({
+        label,
+        hash: testCase.hash,
+        success: false,
+        error: error.message,
+      });
+    }
+  }
+
+  console.log("\nGeneration Summary:");
+  console.log("------------------");
+  results.forEach(({ label, success, outputPath, error }) => {
+    if (success) {
+      console.log(`✓ ${label}: ${outputPath}`);
+    } else {
+      console.log(`✗ ${label}: Failed - ${error}`);
+    }
+  });
+}
+
+// Run the test cases
+generateTestCases();
+
+
+
+// const gitHash = '1234567890abcdef1234567890abcdef12345678';
+// const imageBuffer = generateImageFromHash(gitHash, { width: 1024, height: 1024 });
+// const savedImagePath = saveImageToFile(imageBuffer, './output', gitHash, 'example', 1024, 1024);
+// console.log(`Image saved to: ${savedImagePath}`);
+