{"id":30325776,"url":"https://github.com/atomantic/escher_svg","last_synced_at":"2025-08-17T23:07:50.415Z","repository":{"id":307982740,"uuid":"1029807812","full_name":"atomantic/escher_svg","owner":"atomantic","description":"Experimental Vibes","archived":false,"fork":false,"pushed_at":"2025-08-03T11:30:08.000Z","size":399,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-03T13:13:04.848Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/atomantic.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-31T15:51:54.000Z","updated_at":"2025-08-03T11:30:11.000Z","dependencies_parsed_at":"2025-08-03T13:26:20.767Z","dependency_job_id":null,"html_url":"https://github.com/atomantic/escher_svg","commit_stats":null,"previous_names":["atomantic/escher_svg"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/atomantic/escher_svg","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atomantic%2Fescher_svg","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atomantic%2Fescher_svg/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atomantic%2Fescher_svg/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atomantic%2Fescher_svg/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/atomantic","download_url":"https://codeload.github.com/atomantic/escher_svg/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atomantic%2Fescher_svg/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270918404,"owners_count":24667679,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-17T02:00:09.016Z","response_time":129,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-08-17T23:07:49.831Z","updated_at":"2025-08-17T23:07:50.401Z","avatar_url":"https://github.com/atomantic.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# escher_svg\n\n\u003e This is just a quick, naive test of claude code using the following prompts:\n\u003e - create a README.md for this repo that describes escher_svg as a JavaSript utility that will make a SVG of a random Escher like tessellation\n\u003e - Plan the project\n\u003e - execute the plan\n\u003e - initialize a git repo, set origin to git@github.com:atomantic/escher_svg.git and commit/push to main\n\u003e - there is empty space between the shapes\n\u003e\n\u003e The result needs more correction and massaging to get to something like what an escher pattern would look like (flipped rows, animal shapes--might require a diffusion model, etc)  \n\nA JavaScript utility that generates SVG images of random Escher-like tessellations.\n\n## Overview\n\nescher_svg creates mathematically-inspired tessellation patterns reminiscent of M.C. Escher's famous works. Each generated SVG features unique, interlocking shapes that tile seamlessly across the canvas using wallpaper group symmetries and shape deformations.\n\n## Features\n\n- **Random Pattern Generation**: Creates unique Escher-like tessellations with organic shape deformations\n- **Multiple Base Shapes**: Supports triangles, squares, hexagons, pentagons, and octagons\n- **Symmetry Groups**: Implements wallpaper group transformations (p1, p2, pm, p3, p4, p6)\n- **Color Schemes**: Generates harmonious color palettes (monochrome, complementary, analogous, triadic)\n- **Shape Deformations**: Applies wave, spike, and curve transformations for organic Escher-like effects\n- **CLI Interface**: Easy command-line tool for quick pattern generation\n- **Scalable Output**: Clean SVG format for infinite scalability\n\n## Installation\n\n```bash\nnpm install escher_svg\n```\n\n## Usage\n\n### Programmatic API\n\n```javascript\nconst EscherSVG = require('escher_svg');\n\n// Create generator instance\nconst escher = new EscherSVG({\n  width: 800,\n  height: 600,\n  tileSize: 60\n});\n\n// Generate random Escher-like pattern\nconst svg = escher.generate();\n\n// Generate specific patterns\nconst squareSVG = escher.generateSquare();\nconst hexSVG = escher.generateHexagonal();\nconst triangleSVG = escher.generateTriangular();\n\n// Save to file\nconst fs = require('fs');\nfs.writeFileSync('pattern.svg', svg);\n```\n\n### Command Line Interface\n\n```bash\n# Generate random pattern\nescher-svg\n\n# Specify output file and dimensions\nescher-svg -o mypattern.svg -w 1200 -h 800\n\n# Generate specific pattern type\nescher-svg --pattern hexagon --tile 40\n\n# See all options\nescher-svg --help\n```\n\n### CLI Options\n\n- `-o, --output \u003cfile\u003e`: Output filename (default: tessellation.svg)\n- `-w, --width \u003cpixels\u003e`: Canvas width (default: 800)\n- `-h, --height \u003cpixels\u003e`: Canvas height (default: 600)  \n- `-t, --tile \u003csize\u003e`: Base tile size (default: 60)\n- `-p, --pattern \u003ctype\u003e`: Pattern type: random, square, hexagon, triangle (default: random)\n- `-s, --seed \u003cnumber\u003e`: Random seed for reproducible patterns\n\n## Examples\n\nRun the example generator to see various pattern types:\n\n```bash\nnpm run example\n```\n\nThis generates several example SVGs in the `examples/` directory showing different pattern types and color schemes.\n\n## Architecture\n\n- **Geometry Engine**: Point, Polygon, and Line classes with transformation methods\n- **Tessellation System**: Pattern generation with wallpaper group symmetries\n- **SVG Renderer**: Clean SVG output with styling and gradients\n- **Pattern Generator**: Random shape creation with organic deformations\n- **CLI Tool**: Command-line interface for easy usage\n\n## Pattern Types\n\n- **p1**: Simple translation (basic tiling)\n- **p2**: 180° rotational symmetry\n- **pm**: Mirror reflection\n- **p3**: 120° rotational symmetry (triangular)\n- **p4**: 90° rotational symmetry (square)\n- **p6**: 60° rotational symmetry (hexagonal)\n\n## Shape Deformations\n\n- **Wave**: Sinusoidal edge deformation with adjustable amplitude and frequency\n- **Spike**: Pointed protrusions from polygon edges\n- **Curve**: Bezier curve deformations (planned)\n\n## Testing\n\n```bash\nnpm test\n```\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fatomantic%2Fescher_svg","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fatomantic%2Fescher_svg","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fatomantic%2Fescher_svg/lists"}