git-hash-art 0.6.0 → 0.8.0

package/ALGORITHM.md

@@ -11,12 +11,13 @@ Hash String
   │
   ├─► Archetype Selection (1 of 10 visual personalities)
   │
-  ├─► Color Scheme (palette mode from archetype + temperature mode)
+  ├─► Color Scheme (palette mode from archetype + temperature mode + contrast enforcement)
   │
   └─► Rendering Pipeline (parameters overridden by archetype)
        │
        0.  Archetype Override (gridSize, layers, opacity, sizes, styles)
        1.  Background Layer (7 styles: radial, linear, solid, multi-stop)
+       1a. Background Luminance → contrast enforcement threshold
        1b. Layered Background (faint shapes + concentric rings)
        2.  Composition Mode Selection
        2b. Symmetry Mode Selection (none / bilateral / quad)
@@ -27,7 +28,8 @@ Hash String
        │   ├─ Blend Mode (per-layer compositing)
        │   ├─ Render Style (archetype-preferred + random mix)
        │   ├─ Position (composition mode + focal bias + density check)
-       │   ├─ Shape Selection (layer-weighted)
+       │   ├─ Shape Selection (4 categories: basic, complex, sacred, procedural)
+       │   ├─ Contrast Enforcement (ensure readability vs background)
        │   ├─ Atmospheric Depth (desaturation on later layers)
        │   ├─ Temperature Contrast (foreground opposite to background)
        │   ├─ Styling (transparency, glow, gradients, color jitter)
@@ -267,13 +269,25 @@ Later layers progressively desaturate their colors (0% on layer 0, up to 30% on
 
 ### Shape Selection (Layer-Weighted)
 
-Shapes are divided into three categories with weights that shift across layers:
+Shapes are divided into four categories with weights that shift across layers:
 
 | Category | Shapes | Early layers | Late layers |
 |----------|--------|-------------|-------------|
 | **Basic** | circle, square, triangle, hexagon, diamond, cube | High weight | Low weight |
 | **Complex** | star, platonic solid, fibonacci spiral, islamic pattern, celtic knot, merkaba, fractal | Medium | Medium-high |
 | **Sacred** | mandala, flower of life, tree of life, Metatron's cube, Sri Yantra, seed of life, vesica piscis, torus, egg of life | Low | High |
+| **Procedural** | blob, ngon, lissajous, superellipse, spirograph, waveRing, rose | Medium (always present) | Medium-high |
+
+Procedural shapes are hash-derived — their geometry is generated from the RNG, so every hash produces unique shapes that don't exist in any other generation. See the Procedural Shapes section below for details.
+
+### Contrast Enforcement
+
+After color selection, every foreground color (fills, strokes, flow lines, connecting curves) is checked against the average background luminance. If the luminance difference is below the minimum threshold (0.15), the color is adjusted:
+
+- **Light backgrounds** — foreground colors are darkened and saturated
+- **Dark backgrounds** — foreground colors are lightened and saturated
+
+This prevents the white-on-white and dark-on-dark readability problems that occur when light palette modes (pastel-light, high-contrast) combine with light background styles (solid-light, radial-light).
 
 ### Size Distribution
 
@@ -366,6 +380,19 @@ Mathematically precise sacred geometry patterns:
 - **Torus** — 2D projection of a torus via line segments
 - **Egg of Life** — 7 circles in tight hexagonal packing
 
+### Procedural Shapes
+Hash-derived shapes whose geometry is generated from the RNG. Every hash produces unique shapes that don't exist in any other generation:
+
+| Shape | Algorithm | Hash Controls |
+|-------|-----------|---------------|
+| **Blob** | Smooth closed curve via quadratic bezier through 5-9 control points arranged around a circle | Number of lobes (5-9), radius jitter per lobe (50-100%) |
+| **Ngon** | Irregular polygon with independent vertex displacement | Side count (3-12), vertex jitter amount (10-50%) |
+| **Lissajous** | Parametric curve `x = sin(a*t + φ), y = sin(b*t)` | Frequency ratios a,b (1-5 each), phase offset φ |
+| **Superellipse** | `|x|^n + |y|^n = 1` rendered parametrically | Exponent n: 0.3 (spiky astroid) → 2 (circle) → 5 (rounded rectangle) |
+| **Spirograph** | Hypotrochoid curve `(R-r)cos(t) + d*cos((R-r)t/r)` | Inner radius ratio r (0.2-0.8), pen distance d (0.3-1.0) |
+| **Wave Ring** | Concentric rings with sinusoidal radial displacement | Ring count (2-5), wave frequency (3-14), amplitude (5-20%) |
+| **Rose** | Polar rose curve `r = cos(k*θ)` | Petal parameter k (2-7), producing k or 2k petals |
+
 ## Configuration
 
 All parameters are exposed via `GenerationConfig`:

package/CHANGELOG.md

@@ -4,8 +4,24 @@ All notable changes to this project will be documented in this file. Dates are d
 
 Generated by [`auto-changelog`](https://github.com/CookPete/auto-changelog).
 
+#### [0.8.0](https://github.com/gfargo/git-hash-art/compare/0.7.0...0.8.0)
+
+- feat: major visual quality improvements [`#14`](https://github.com/gfargo/git-hash-art/pull/14)
+- fix: convert generateExamples.js to CJS require() syntax [`0662e61`](https://github.com/gfargo/git-hash-art/commit/0662e61ef82ef879b1e31929e640a797ca3278bd)
+
+#### [0.7.0](https://github.com/gfargo/git-hash-art/compare/0.6.0...0.7.0)
+
+> 19 March 2026
+
+- feat: procedural shape generators and contrast enforcement [`#13`](https://github.com/gfargo/git-hash-art/pull/13)
+- feat: procedural shapes and contrast enforcement [`4f018ab`](https://github.com/gfargo/git-hash-art/commit/4f018abb4c89849954ccc941ee7e9ab468231f78)
+- docs: update ALGORITHM.md with procedural shapes and contrast enforcement [`3e044fd`](https://github.com/gfargo/git-hash-art/commit/3e044fd940fbc0f62e3a9696fa815145cf315f67)
+- chore: release v0.7.0 [`1c0ad5e`](https://github.com/gfargo/git-hash-art/commit/1c0ad5e112c2c5547e4f83c7808e09ebb0db5e40)
+
 #### [0.6.0](https://github.com/gfargo/git-hash-art/compare/0.5.0...0.6.0)
 
+> 19 March 2026
+
 - feat: archetype system, palette modes, background variety, and CLI [`#12`](https://github.com/gfargo/git-hash-art/pull/12)
 - feat: archetype system for dramatically different visual personalities [`2a1b919`](https://github.com/gfargo/git-hash-art/commit/2a1b919c51d3bfbd9d5c7a381ea5e104f81df2f6)
 - feat: add CLI for generating art from terminal [`184372a`](https://github.com/gfargo/git-hash-art/commit/184372a584f68031bf44379f385f2e78691f98aa)

package/bin/generateExamples.js

@@ -1,7 +1,8 @@
-import fs from 'fs';
-import path from 'path';
-import { generateImageFromHash, saveImageToFile } from '../dist/main.js';
-import { PRESETS } from '../src/lib/constants.js';
+#!/usr/bin/env node
+const fs = require('fs');
+const path = require('path');
+const { generateImageFromHash, saveImageToFile } = require('../dist/main.js');
+const { PRESETS } = require('../dist/main.js');
 
 const OUTPUT_DIR = './examples';
 
@@ -21,7 +22,7 @@ function generateTestCases() {
       const imageBuffer = generateImageFromHash(testCase.hash, {
         width: testCase.width,
         height: testCase.height,
-        ...testCase, // Include any additional configuration from the preset
+        ...testCase,
       });
       const outputPath = saveImageToFile(imageBuffer, OUTPUT_DIR, testCase.hash, label, testCase.width, testCase.height);
       results.push({ label, hash: testCase.hash, outputPath, success: true });
@@ -47,13 +48,4 @@ function generateTestCases() {
   });
 }
 
-// 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}`);
-