mtg_card_maker 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 86af6b0b99b18a80e1c1262b0dee561827cd44bb5c3cda356b80ea82084bb6a5
-  data.tar.gz: 44666f6b704373a2200ab303605a28681f699bc3d3286ae334a53d08e1d974c8
+  metadata.gz: 7fa254f0344ffc52479fb2be5aae9a6f0486b9ebff42b684156260bfe4814879
+  data.tar.gz: 34cdc3ed5192c5e89e7a4e0d58260f5276fbfa920a48e286c9638757e301342c
 SHA512:
-  metadata.gz: c89f4152f692fcae4517b2ed0ee3905b3ade4d64f066a9604734a80d3fb1d8ea1faae059b8490d672d0c2bf7c278f90887cc4075c548444b02b97e760c9021d3
-  data.tar.gz: 83a778be41a404a1fa74cf813d8d9d7cc360c370381fb6417e295c790a33139668eb6a89b41573b793ccb7de27b88a6516919b2b2d5a0534d54e1a6a7a659215
+  metadata.gz: cf7b3b64a9c76fcb695571a3320cc5fdf9746c7719f411eb3ebaaa9d64573aec3862990f99b0818b754ed6b62191ff40b73d7997536328fc85e35f2b9a286626
+  data.tar.gz: ebc7ed18847e53e800e9fe2b7156e82ad470ac22984c2f418a8e662680f63a1bd46693808f804295408c185014760e05a3a0e7898517ae7fa07dbd29777591a7

data/CHANGELOG.md

@@ -1,5 +1,25 @@
 ## [Unreleased]
 
+## [0.2.0] - 2026-10-11
+
+### 📜 License
+- **Relicensed from CC BY-NC-ND 4.0 to the MIT License.** Version 0.1.0 remains available under its original license.
+- Wizards of the Coast materials and the bundled Goudy Bookletter 1911 font (SIL OFL 1.1) are explicitly excluded from the MIT grant and keep their own terms (see `LICENSE.txt`).
+- Generated cards no longer carry "Some rights reserved"; the footer now reads "MTG Card Maker by Joe Sharp". Cards and their content belong to their creators.
+- Replaced the bundled Goudy Mediaeval DemiBold font, which is licensed for personal use only, with Goudy Bookletter 1911. Embedded card text renders slightly differently, and SVGs with embedded fonts are about 38 KB larger.
+
+### ⚠️ Breaking Changes
+- **Dropped support for Ruby 3.2.** Ruby 3.3 or higher is now required (Ruby 3.2 reached end of life in March 2026).
+
+### ✨ Features
+- Hybrid and Phyrexian mana symbol support, with a new `IconFilenameService` for symbol mapping
+- SVG to WebP conversion script (experimental)
+- Italicized flavor text
+- Improved SVG initialization and viewBox scaling in card rendering
+
+### 📚 Documentation
+- README updated with new symbols and Markdown docs support; YARD documentation refreshed
+
 ## [0.1.0] - 2025-07-12
 
 ### 🎯 Initial Release

data/LICENSE.txt

@@ -1,20 +1,65 @@
-Creative Commons Attribution-NonCommercial-NoDerivs 4.0 International (CC BY-NC-ND 4.0)
+MIT License
 
-Copyright (c) 2025 joe-sharp
+Copyright (c) 2025 Joe Sharp
 
-This work is licensed under the Creative Commons Attribution-NonCommercial-NoDerivs 4.0 International License. To view a copy of this license, visit http://creativecommons.org/licenses/by-nc-nd/4.0/ or send a letter to Creative Commons, PO Box 1866, Mountain View, CA 94042, USA.
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
 
-You are free to:
-Share — copy and redistribute the material in any medium or format
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
 
-The licensor cannot revoke these freedoms as long as you follow the license terms.
-Under the following terms:
-- Attribution — You must give appropriate credit, provide a link to the license, and indicate if changes were made. You may do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use.
-- NonCommercial — You may not use the material for commercial purposes.
-- NoDerivatives — If you remix, transform, or build upon the material, you may not distribute the modified material.
-No additional restrictions — You may not apply legal terms or technological measures that legally restrict others from doing anything the license permits.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
 
-Notices:
-You do not have to comply with the license for elements of the material in the public domain or where your use is permitted by an applicable exception or limitation.
+--------------------------------------------------------------------------------
+Materials NOT covered by the MIT License above
+--------------------------------------------------------------------------------
 
-No warranties are given. The license may not give you all of the permissions necessary for your intended use. For example, other rights such as publicity, privacy, or moral rights may limit how you use the material.
+The MIT License applies only to the original code and original assets created
+by Joe Sharp. The following materials are owned by third parties, are not
+licensed to you by this project, and are excluded from the grant above:
+
+1. Wizards of the Coast materials
+
+   Magic: The Gathering, its name, mana symbols, set symbols, card frame and
+   layout designs, and related marks are property of Wizards of the Coast LLC.
+   MTG Card Maker is unofficial Fan Content permitted under the Fan Content
+   Policy (https://company.wizards.com/en/legal/fancontentpolicy). It is not
+   approved or endorsed by Wizards. Portions of the materials used are
+   property of Wizards of the Coast. (c) Wizards of the Coast LLC.
+
+   Use of these materials, including cards generated with this software, is
+   governed by the Fan Content Policy, which does not permit commercial use.
+   Nothing in the MIT License grants you any rights in them.
+
+2. Goudy Bookletter 1911 font
+
+   lib/mtg_card_maker/fonts/GoudyBookletter1911.ttf, its base64 copy
+   (goudy_bookletter_base64.txt), and the font as embedded in generated SVG
+   files are Copyright (c) 2010, Barry Schwartz (crudfactory.com), licensed
+   under the SIL Open Font License, Version 1.1. The license text is in
+   lib/mtg_card_maker/fonts/OFL.txt. The font remains under that license,
+   not the MIT License.
+
+3. Sample artwork
+
+   The card artwork and finished sample cards in the images/ directory of the
+   source repository (which are not part of the published gem) are
+   AI-generated and are included for illustration only. They are not covered
+   by the MIT License, and no rights in them are granted.
+
+Cards you generate belong to you: the MIT License says nothing about the
+text, artwork, or other content you put on them. The jsharp.svg and
+qrcode.svg icons bundled in lib/mtg_card_maker/icons/ are original to this
+project and are covered by the MIT License.
+
+Questions about the author's own original assets: joesharp13@gmail.com

data/README.md

@@ -1,69 +1,75 @@
 # MTG Card Maker
 
 <p align=center>
-<img src="images/mtgcm_card.png" width="300" />
+  <img src="images/mtgcm_card.webp"
+       alt="A card featuring artwork of a fiery dragon and anvil"
+       width="300" />
 </p>
 
-A Ruby gem for creating fan-made Magic: The Gathering cards. This tool allows you to generate custom MTG cards with proper formatting, mana costs, and card layouts. All you need to supply is the artwork image url/path, or simply overlay on top of an image of your choosing.
+A Ruby gem for creating high quality fan-made Magic: The Gathering cards. This tool generates custom MTG cards with authentic formatting, comprehensive mana cost support, and precise card layouts. Perfect for game designers, content creators, and MTG enthusiasts.
 
-Please note this gem is in early beta, and should not be used in any production application. **Using it commercially is a violation of the license.** Please suggest feature ideas you have after reviewing the open issues here: https://github.com/joe-sharp/mtg_card_maker/issues
+
+Please note this gem is for fan content creation only. **Wizards of the Coast's Fan Content Policy does not permit commercial use of cards made with Magic: The Gathering materials.** If you have ideas for improvements, please create a feature request after reviewing the open issues here: https://github.com/joe-sharp/mtg_card_maker/issues
 
 ## Features
 #### 🎨 Card Customization
 
 **Core Card Properties:**
-- **Card Name**: Customizable card titles with optional font support
-- **Mana Cost**: Support for 0-9, X, and all MTG mana symbols (W, U, B, R, G, C), alternate icon sets coming soon!
-- **Type Line**: Customizable Card types and subtypes (Creature, Instant, Sorcery, etc.)
-- **Description**: Rules text with automatic word wrapping and formatting
-- **Flavor Text**: Optional italicized flavor text at the bottom of cards
-- **Power/Toughness**: For creature cards, customizable power and toughness values, frame hides when omitted
+- **Card Name**: Customizable card titles with embedded font support
+- **Mana Cost**: Complete MTG symbol support including hybrid, Phyrexian, and numeric costs
+- **Type Line**: Customizable card types and subtypes (Creature, Instant, Sorcery, etc.)
+- **Rules Text**: Rich text with automatic word wrapping and symbol replacement
+- **Flavor Text**: Optional italicized flavor text with proper formatting
+- **Power/Toughness**: Dynamic power/toughness display
 
 **Visual Customization:**
-- **Color Schemes**: 8 built-in colors (white, blue, black, red, green, colorless, gold, artifact), split colors coming soon!
-- **Border Color**: Customizable border colors (white, black, gold, silver)
-- **Art Integration**: Support for custom artwork via image URLs, or simply layer the svg over your art of choice
+- **Color Schemes**: 8 card colors (white, blue, black, red, green, colorless, gold, artifact)
+- **Border Colors**: Customizable borders (white, black, gold, silver)
+- **Art Integration**: Flexible artwork support via URLs or local paths
+- **Font Embedding**: Base64 font embedding for portability
 
-#### 🖼️ Sprite Sheet Features
+#### 🖼️ Advanced Sprite Sheet Features
 
-**Efficiency Optimizations:**
+**Performance Optimizations:**
 - **Shared Assets**: Fonts, gradients, and masks defined once per sprite sheet
-- **Reduced File Size**: Significantly smaller file sizes compared to individual cards
-- **Layout Optimization**: Ideal for web applications, printing and digital displays
+- **File Size Reduction**: Significantly smaller than individual card files
+- **Layout Optimization**: Ideal for web applications, printing
+and digital displays
 
 **Layout Control:**
-- **Cards Per Row**: Configurable number of cards per row (default: 4)
-- **Spacing Control**: Adjustable spacing between cards in pixels (default: 30)
-- **Automatic Sizing**: Dynamic sprite sheet dimensions based on card count
+- **Cards Per Row**: Configurable grid layout (default: 4)
+- **Spacing Control**: Pixel-perfect spacing between cards (default: 30px)
+- **Dynamic Sizing**: Automatic sprite sheet dimensions based on card count
 
 **Batch Processing:**
-- **YAML Configuration**: Define multiple cards in structured YAML files
-- **CLI Integration**: Command-line tools for adding cards to YAML files
-- **Error Handling**: Robust error handling for invalid configurations
+- **YAML Configuration**: Structured card definitions with validation
+- **CLI Integration**: Streamlined command-line workflow
+- **Error Handling**: Robust validation and helpful error messages
 
-#### 🛠️ Technical Features
+#### 🛠️ Technical Excellence
 
 **SVG Generation:**
-- **Vector Graphics**: High-quality SVG output suitable for any size
+- **Vector Graphics**: High-quality SVG output suitable for any scale
 - **Print Ready**: Optimized for both digital and print applications
 - **Cross-Platform**: Compatible with all modern browsers and design software
+  - NOTE: inline symbols in rule text may not render in some design software
 
-**Development Tools:**
-- **Guard Integration**: Automated testing and code quality monitoring
-- **Status Summary**: Real-time development status with integrity checks
-- **Comprehensive Testing**: 95%+ test coverage with RSpec
-- **Code Quality**: RuboCop integration for consistent code style
+**Development Infrastructure:**
+- **Guard Integration**: Automated testing and quality monitoring
+- **Status Summary**: Real-time development feedback with integrity checks
+- **Comprehensive Testing**: 480+ tests with fixtures and helpers
+- **Code Quality**: Zero RuboCop violations, consistent style
 
 **Documentation:**
-- **YARD Documentation**: Comprehensive API documentation (95.96% documented)
-- **CLI Help**: Detailed command-line help and examples
-- **Examples**: Multiple example configurations and use cases
+- **YARD Documentation**: 96.30% documented with local server
+- **CLI Help**: Comprehensive command-line help and examples
+- **Examples**: Multiple configuration examples and use cases
 
-## Installation
+## 💽 Installation
 
 ### Prerequisites
 
-This gem requires Ruby 3.2 or higher. The version of Ruby included with macOS is typically outdated and won't work. You can install a newer version of Ruby using tools like [asdf](https://asdf-vm.com/) (with the [Ruby plugin](https://github.com/asdf-vm/asdf-ruby)), [rbenv](https://github.com/rbenv/rbenv) or [RVM](https://rvm.io/). Note: This gem seems to work just fine on Ruby 3.5.0 but cannot be tested in CI currently.
+This gem requires Ruby 3.3 or higher. The version of Ruby included with macOS is typically outdated and won't work. You can install a newer version of Ruby using tools like [asdf](https://asdf-vm.com/) (with the [Ruby plugin](https://github.com/asdf-vm/asdf-ruby)), [rbenv](https://github.com/rbenv/rbenv) or [RVM](https://rvm.io/). Note: This gem seems to work just fine on Ruby 3.5.0 but cannot be tested in CI currently.
 
 Install the gem:
 ```bash
@@ -85,8 +91,9 @@ flavor_text: "Flavor text"        # Optional
 power: 4                          # Optional
 toughness: 4                      # Optional
 color: red                        # Optional (default: colorless)
-border_color: gold           # Optional (default: white)
-art: path/to/art.jpg        # Optional
+border_color: gold                # Optional (default: white)
+art: path/to/art.jpg              # Optional
+embed_font: false                 # Optional (default: true)
 ```
 
 **Color Schemes Available:**
@@ -101,7 +108,116 @@ art: path/to/art.jpg        # Optional
 `white`     => White cards
 ```
 
-### 🚀 Usage Examples
+**Symbols Available for Mana Cost:**
+
+**Mana Symbols:**
+- `W` - White mana <img src="images/icons/white.svg" width="16" valign="middle" />
+- `B` - Black mana <img src="images/icons/black.svg" width="16" valign="middle" />
+- `R` - Red mana <img src="images/icons/red.svg" width="16" valign="middle" />
+- `G` - Green mana <img src="images/icons/green.svg" width="16" valign="middle" />
+- `U` - Blue mana <img src="images/icons/blue.svg" width="16" valign="middle" />
+- `C` - Colorless mana <img src="images/icons/colorless.svg" width="16" valign="middle" />
+- `S` - Snow mana <img src="images/icons/snow.svg" width="16" valign="middle" />
+- `{C/P}` - Colorless Phyrexian mana <img src="images/icons/phyrexian/colorless.svg" width="20" valign="middle" />
+- `{R/P}` - Red Phyrexian mana <img src="images/icons/phyrexian/red.svg" width="20" valign="middle" />
+- `{G/P}` - Green Phyrexian mana <img src="images/icons/phyrexian/green.svg" width="20" valign="middle" />
+- `{U/P}` - Blue Phyrexian mana <img src="images/icons/phyrexian/blue.svg" width="20" valign="middle" />
+- `{B/P}` - Black Phyrexian mana <img src="images/icons/phyrexian/black.svg" width="20" valign="middle" />
+- `{W/P}` - White Phyrexian mana <img src="images/icons/phyrexian/white.svg" width="20" valign="middle" />
+
+**Advanced Mana Support:**
+Hybrid and Phyrexian mana are now fully supported! See all the
+notations below in the rule text section. The notation uses curly braces for complex symbols:
+- `{R/G}` Red / Green Mana <img src="images/icons/hybrid/red-green.svg" width="20" valign="middle" />
+- `{G/W/P}` Green / White Phyrexian Mana <img src="images/icons/phyrexian/green-white.svg" width="20" valign="middle" />
+
+**Numeric Symbols:**
+- `0` through `99` - Generic mana costs (0-99) <img src="images/icons/single-digit.svg" width="16" valign="middle" />
+- `X` - X symbol <img src="images/icons/x.svg" width="16" valign="middle" />
+
+**Combination Examples:**
+- `16US` - 16 generic + 1 blue + 1 snow <img src="images/icons/double-digit.svg" width="16" valign="middle" /> <img src="images/icons/blue.svg" width="16" valign="middle" /> <img src="images/icons/snow.svg" width="16" valign="middle" />
+- `XG` - X generic + 1 green <img src="images/icons/x.svg" width="16" valign="middle" /> <img src="images/icons/green.svg" width="16" valign="middle" />
+- `X3R` - X generic + 3 generic + 1 red <img src="images/icons/x.svg" width="16" valign="middle" /> <img src="images/icons/single-digit.svg" width="16" valign="middle" /> <img src="images/icons/red.svg" width="16" valign="middle" />
+- `3WU` - 3 generic + 1 white + 1 blue <img src="images/icons/single-digit.svg" width="16" valign="middle" /> <img src="images/icons/white.svg" width="16" valign="middle" /> <img src="images/icons/blue.svg" width="16" valign="middle" />
+- `WU{B/P}RG` White, Blue, Phyrexian Black, Red, Green <img src="images/icons/white.svg" width="16" valign="middle" /> <img src="images/icons/blue.svg" width="16" valign="middle" /> <img src="images/icons/phyrexian/black.svg" width="20" valign="middle" /> <img src="images/icons/red.svg" width="16" valign="middle" /> <img src="images/icons/green.svg" width="16" valign="middle" />
+- `X` - X generic only <img src="images/icons/x.svg" width="16" valign="middle" />
+- `3` - 3 generic only <img src="images/icons/single-digit.svg" width="16" valign="middle" />
+- `B` - black only <img src="images/icons/black.svg" width="16" valign="middle" />
+
+**Symbols Available in Rules Text:**
+
+You can use MTG symbols in your rules text by wrapping them in curly braces "{C}". The following symbols are supported:
+
+**Mana Symbols:**
+- `{W}` - White mana <img src="images/icons/white.svg" width="16" valign="middle" />
+- `{B}` - Black mana <img src="images/icons/black.svg" width="16" valign="middle" />
+- `{R}` - Red mana <img src="images/icons/red.svg" width="16" valign="middle" />
+- `{G}` - Green mana <img src="images/icons/green.svg" width="16" valign="middle" />
+- `{U}` - Blue mana <img src="images/icons/blue.svg" width="16" valign="middle" />
+- `{C}` - Colorless mana <img src="images/icons/colorless.svg" width="16" valign="middle" />
+- `{S}` - Snow mana symbol <img src="images/icons/snow.svg" width="16" valign="middle" />
+- `{C/P}` - Colorless Phyrexian mana <img src="images/icons/phyrexian/colorless.svg" width="20" valign="middle" />
+- `{R/P}` - Red Phyrexian mana <img src="images/icons/phyrexian/red.svg" width="20" valign="middle" />
+- `{G/P}` - Green Phyrexian mana <img src="images/icons/phyrexian/green.svg" width="20" valign="middle" />
+- `{U/P}` - Blue Phyrexian mana <img src="images/icons/phyrexian/blue.svg" width="20" valign="middle" />
+- `{B/P}` - Black Phyrexian mana <img src="images/icons/phyrexian/black.svg" width="20" valign="middle" />
+- `{W/P}` - White Phyrexian mana <img src="images/icons/phyrexian/white.svg" width="20" valign="middle" />
+
+**Hybrid Mana Symbols:**
+
+**White hybrid:** `{W/B}` `{W/R}` `{W/G}` `{W/U}` - <img src="images/icons/hybrid/white-black.svg" width="20" valign="middle" /> <img src="images/icons/hybrid/white-red.svg" width="20" valign="middle" /> <img src="images/icons/hybrid/white-green.svg" width="20" valign="middle" /> <img src="images/icons/hybrid/white-blue.svg" width="20" valign="middle" />
+
+**Black hybrid:** `{B/W}` `{B/R}` `{B/G}` `{B/U}` - <img src="images/icons/hybrid/black-white.svg" width="20" valign="middle" /> <img src="images/icons/hybrid/black-red.svg" width="20" valign="middle" /> <img src="images/icons/hybrid/black-green.svg" width="20" valign="middle" /> <img src="images/icons/hybrid/black-blue.svg" width="20" valign="middle" />
+
+**Red hybrid:** `{R/W}` `{R/B}` `{R/G}` `{R/U}` - <img src="images/icons/hybrid/red-white.svg" width="20" valign="middle" /> <img src="images/icons/hybrid/red-black.svg" width="20" valign="middle" /> <img src="images/icons/hybrid/red-green.svg" width="20" valign="middle" /> <img src="images/icons/hybrid/red-blue.svg" width="20" valign="middle" />
+
+**Green hybrid:** `{G/W}` `{G/B}` `{G/R}` `{G/U}` - <img src="images/icons/hybrid/green-white.svg" width="20" valign="middle" /> <img src="images/icons/hybrid/green-black.svg" width="20" valign="middle" /> <img src="images/icons/hybrid/green-red.svg" width="20" valign="middle" /> <img src="images/icons/hybrid/green-blue.svg" width="20" valign="middle" />
+
+**Blue hybrid:** `{U/W}` `{U/B}` `{U/R}` `{U/G}` - <img src="images/icons/hybrid/blue-white.svg" width="20" valign="middle" /> <img src="images/icons/hybrid/blue-black.svg" width="20" valign="middle" /> <img src="images/icons/hybrid/blue-red.svg" width="20" valign="middle" /> <img src="images/icons/hybrid/blue-green.svg" width="20" valign="middle" />
+
+**"Two-brids":** `{2/W}` `{2/B}` `{2/R}` `{2/G}` `{2/U}` - <img src="images/icons/hybrid/2-white.svg" width="20" valign="middle" /> <img src="images/icons/hybrid/2-black.svg" width="20" valign="middle" /> <img src="images/icons/hybrid/2-red.svg" width="20" valign="middle" /> <img src="images/icons/hybrid/2-green.svg" width="20" valign="middle" /> <img src="images/icons/hybrid/2-blue.svg" width="20" valign="middle" />
+
+**Colorless hybrid:** `{C/W}` `{C/B}` `{C/R}` `{C/G}` `{C/U}` - <img src="images/icons/hybrid/colorless-white.svg" width="20" valign="middle" /> <img src="images/icons/hybrid/colorless-black.svg" width="20" valign="middle" /> <img src="images/icons/hybrid/colorless-red.svg" width="20" valign="middle" /> <img src="images/icons/hybrid/colorless-green.svg" width="20" valign="middle" /> <img src="images/icons/hybrid/colorless-blue.svg" width="20" valign="middle" />
+
+**Phyrexian Hybrid Mana Symbols:**
+
+**White Phyrexian hybrid:** `{W/B/P}` `{W/R/P}` `{W/G/P}` `{W/U/P}` - <img src="images/icons/phyrexian/white-black.svg" width="20" valign="middle" /> <img src="images/icons/phyrexian/white-red.svg" width="20" valign="middle" /> <img src="images/icons/phyrexian/white-green.svg" width="20" valign="middle" /> <img src="images/icons/phyrexian/white-blue.svg" width="20" valign="middle" />
+
+**Black Phyrexian hybrid:** `{B/W/P}` `{B/R/P}` `{B/G/P}` `{B/U/P}` - <img src="images/icons/phyrexian/black-white.svg" width="20" valign="middle" /> <img src="images/icons/phyrexian/black-red.svg" width="20" valign="middle" /> <img src="images/icons/phyrexian/black-green.svg" width="20" valign="middle" /> <img src="images/icons/phyrexian/black-blue.svg" width="20" valign="middle" />
+
+**Red Phyrexian hybrid:** `{R/W/P}` `{R/B/P}` `{R/G/P}` `{R/U/P}` - <img src="images/icons/phyrexian/red-white.svg" width="20" valign="middle" /> <img src="images/icons/phyrexian/red-black.svg" width="20" valign="middle" /> <img src="images/icons/phyrexian/red-green.svg" width="20" valign="middle" /> <img src="images/icons/phyrexian/red-blue.svg" width="20" valign="middle" />
+
+**Green Phyrexian hybrid:** `{G/W/P}` `{G/B/P}` `{G/R/P}` `{G/U/P}` - <img src="images/icons/phyrexian/green-white.svg" width="20" valign="middle" /> <img src="images/icons/phyrexian/green-black.svg" width="20" valign="middle" /> <img src="images/icons/phyrexian/green-red.svg" width="20" valign="middle" /> <img src="images/icons/phyrexian/green-blue.svg" width="20" valign="middle" />
+
+**Blue Phyrexian hybrid:** `{U/W/P}` `{U/B/P}` `{U/R/P}` `{U/G/P}` - <img src="images/icons/phyrexian/blue-white.svg" width="20" valign="middle" /> <img src="images/icons/phyrexian/blue-black.svg" width="20" valign="middle" /> <img src="images/icons/phyrexian/blue-red.svg" width="20" valign="middle" /> <img src="images/icons/phyrexian/blue-green.svg" width="20" valign="middle" />
+
+**Numeric Symbols:**
+- `{0}` through `{99}` - Generic mana costs (0-99) <img src="images/icons/single-digit.svg" width="16" valign="middle" />
+- `{X}` - X symbol <img src="images/icons/x.svg" width="16" valign="middle" />
+
+**Special Symbols:**
+- `{T}` - Tap symbol <img src="images/icons/tap.svg" width="16" valign="middle" />
+- `{Q}` - Untap symbol <img src="images/icons/untap.svg" width="16" valign="middle" />
+- `{E}` - Energy symbol <img src="images/icons/energy.svg" width="16" valign="middle" />
+
+**Example Usage:**
+```yaml
+rules_text: "{T}: Add {W} or {U} to your mana pool."
+```
+<p align=center>
+  <img src="images/icons/tap.svg"
+       alt="{T}" width="16" valign="middle" />
+  : Add
+  <img src="images/icons/white.svg"
+       alt="{W}" width="16" valign="middle" />
+  or
+  <img src="images/icons/blue.svg"
+       alt="{U}" width="16" valign="middle" />
+  to your mana pool
+</p>
+
+## 🧪 Basic Examples
 
 ### Single Card
 
@@ -110,8 +226,8 @@ art: path/to/art.jpg        # Optional
 mtg_card_maker generate_card \
   --name="Lightning Bolt" \
   --mana-cost=R \
-  --type-text=Instant \
-  --description="Deal 3 damage to any target." \
+  --type-line=Instant \
+  --rules-text="Deal 3 damage to any target." \
   --color=red
 ```
 
@@ -120,8 +236,8 @@ mtg_card_maker generate_card \
 mtg_card_maker add_card deck.yml \
   --name="Counterspell" \
   --mana-cost="UU" \
-  --type-text="Instant" \
-  --description="Counter target spell." \
+  --type-line="Instant" \
+  --rules-text="Counter target spell." \
   --color="blue"
 ```
 *Shortcuts:*
@@ -149,32 +265,76 @@ mtg_card_maker generate_sprite deck.yml sprite_sheet.svg \
 *Shortcuts:*
 - `gs` or `gcs` for `generate_sprite`
 
-### Examples
+### 🖼️ Experimental WebP Conversion
+
+**⚠️ Experimental Feature - Mac Only**
+
+The gem includes experimental support for converting SVG cards to WebP format using Chrome's headless mode. This feature is currently **Mac-only** and requires specific dependencies.
+
+**Why?:**
+It seems a lot more user-friendly for use in things like this README.md file. The file size is bigger and it can't scale so I wouldn't use this option unless something in the SVG isn't working with whatever you are trying to do. You should also report that at https://github.com/joe-sharp/mtg_card_maker/issues . Thanks in advance!
+
+**Prerequisites:**
+- **macOS**: Chrome must be installed at `/Applications/Google Chrome.app/Contents/MacOS/Google Chrome`
+- **cwebp**: Google's WebP encoder must be installed (install via Homebrew: `brew install webp`)
+
+**Usage:**
+```bash
+# Convert a single SVG card to WebP
+bin/svg_to_webp output_card.svg
+
+# Convert any SVG file to WebP
+bin/svg_to_webp path/to/your/card.svg
+```
+
+**Features:**
+- **Lossless Conversion**: High-quality WebP output with transparency support
+- **Automatic Cropping**: Removes Chrome's window chrome for clean card output
+- **Optimized Dimensions**: Outputs at 630x880 pixels (standard MTG card ratio)
+- **Transparent Background**: Preserves transparency for web and design use
+
+**Caveats:**
+- **Platform Limitation**: Currently only works on macOS with Chrome installed
+- **Dependency Required**: Requires `cwebp` command-line tool for final processing
+- **Experimental Status**: May have issues with complex SVG content or Chrome updates
+- **File Size**: WebP files may be larger than optimized SVGs for simple cards
+
+**Future Plans:**
+- Cross-platform support (Windows, Linux)
+- Integration with main CLI commands
+
+## 🔮 Examples
 
 <p>
-<img align=right src="images/joe-sharp_card.png" alt="a sample card generated by the application" width="300" />
+<img align=right
+     src="images/joe-sharp_card.webp"
+     alt="A card featuring artwork of a bearded man writing on a magical scroll with a feather pen"
+     width="300" />
 </p>
 
-**Generate a simple creature:**
+**Generate a creature card:**
 
 ```bash
 mtg_card_maker generate_card \
   --name="Joe Sharp" \
-  --mana-cost=2UR \
-  --type-text="Engineer - Fullstack" \
-  --description='When Joe Sharp enters the battlefield, create a 1/1 Code token with "This token can debug any program."\n\nWhenever you cast a Red spell, draw a card.' \
-  --flavor-text='"I write code everyday." - Joe Sharp' \
+  --mana-cost=3UR \
+  --type-line="Engineer - Fullstack" \
+  --rules-text='When Joe Sharp enters the battlefield, all malfunctioning computers begin working.\nWhenever you cast a Red spell, draw a card.\n\n{E}: Debug program. Ignore this cost, if a Coffee token is in play.\n\n' \
+  --flavor-text='\"Nothing is true, everything is a string.\"\n\t\t\t\t- The ENV Creed' \
   --power=3 \
   --toughness=3 \
   --border-color=gold \
-  --color=blue
+  --color=blue \
+  --art=images/joe.webp
 ```
 
+
+
 **Add multiple cards to a YAML file:**
 ```bash
-mtg_card_maker add_card deck.yml --name="Lightning Bolt" --mana-cost="R" --type-text="Instant" --description="Deal 3 damage to any target." --color="red"
+mtg_card_maker add_card deck.yml --name="Lightning Bolt" --mana-cost="R" --type-line="Instant" --rules-text="Deal 3 damage to any target." --color="red"
 
-mtg_card_maker add_card deck.yml --name="Counterspell" --mana-cost="UU" --type-text="Instant" --description="Counter target spell." --color="blue"
+mtg_card_maker add_card deck.yml --name="Counterspell" --mana-cost="UU" --type-line="Instant" --rules-text="Counter target spell." --color="blue"
 ```
 
 **Generate a sprite sheet from YAML:**
@@ -182,7 +342,7 @@ mtg_card_maker add_card deck.yml --name="Counterspell" --mana-cost="UU" --type-t
 mtg_card_maker generate_sprite deck.yml sprite_sheet.svg --cards-per-row=3 --spacing=20
 ```
 
-## Development
+## 🚧 Development
 
 ### Setup
 
@@ -207,6 +367,12 @@ bundle exec guard
 - RSpec results are saved to `tmp/rspec_status.txt`
 - Status summary provides real-time feedback on code quality and card generation
 
+**Development Benefits:**
+- **Zero Configuration**: Just run `bundle exec guard` and start coding
+- **Instant Feedback**: See test results and code quality status immediately
+- **Regression Prevention**: Automatic integrity checks prevent breaking changes
+- **Productivity Boost**: Focus on coding while Guard handles quality assurance
+
 ### Status Summary Script
 
 The `bin/status_summary` script provides a comprehensive development status overview, it is meant to only be run by guard.
@@ -252,7 +418,23 @@ bundle exec rubocop
 # Or run `bundle exec guard` and monitor output_card.svg and color_cards_sprite.svg for changes, it is far better, really.
 ```
 
-## Documentation
+## 🏗️ Technical Architecture
+
+**Design Patterns & Best Practices:**
+- **Layered Architecture**: Clean separation between card components (art, text, frame, border)
+- **Factory Pattern**: `LayerFactory` provides flexible layer creation
+- **Service-Oriented Design**: Dedicated services for icons, sprites, gradients, and text rendering
+- **Single Responsibility**: Each class has a focused, well-defined purpose
+- **Dependency Injection**: Clean interfaces and testable components
+
+**Advanced Features:**
+- **Symbol Replacement Engine**: Sophisticated parsing of MTG notation with regex optimization
+- **Dynamic Gradient Generation**: Real-time SVG gradient creation for card colors
+- **Font Embedding System**: Base64 font embedding for portable SVG files
+- **Sprite Sheet Optimization**: Shared asset management reducing file sizes considerably
+- **Comprehensive Validation**: Robust error handling and input validation throughout
+
+## 📰 Documentation
 
 ### API Documentation
 
@@ -269,37 +451,37 @@ bundle exec yard server
 ```
 Then visit `http://localhost:8808` to browse the documentation.
 
-### Key Classes
 
-- **MtgCardMaker**: Main module with card generation examples
-- **BaseCard**: High-level card creation interface
-- **Template**: SVG canvas and layer management
-- **BaseLayer**: Abstract base class for all card layers
-- **ColorScheme**: Unified color system for all MTG colors
-- **LayerFactory**: Factory pattern for creating card layers
-- **CLI**: Command-line interface with Thor integration
 
 ### Installation and Release
 
 To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
 
-## Contributing
+## 🤝🏻 Contributing
 
 Bug reports and pull requests are welcome on GitHub at https://github.com/joe-sharp/mtg_card_maker. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/joe-sharp/mtg_card_maker/blob/main/CODE_OF_CONDUCT.md).
 
-## License
+## 🪪 License
+
+The code in this gem is available as open source under the terms of the [MIT License](LICENSE.txt).
+
+The MIT License does **not** cover:
+
+- **Wizards of the Coast materials** (the Magic: The Gathering name, mana and set symbols, card frame and layout designs). These are property of Wizards of the Coast and are used under the Fan Content Policy, which does not permit commercial use.
+- **The Goudy Bookletter 1911 font**, © 2010 Barry Schwartz, licensed under the [SIL Open Font License 1.1](lib/mtg_card_maker/fonts/OFL.txt).
+- **The sample artwork and sample cards in `images/`**, which are AI-generated, are for illustration only and are not licensed for reuse. They are not part of the gem.
 
-<a href="https://projects.joe-sharp.com/mtg_card_maker">MTG Card Maker</a> © 2025 by <a href="https://github.com/joe-sharp/mtg_card_maker">Joe Sharp</a> is licensed under <a href="https://creativecommons.org/licenses/by-nc-nd/4.0/">CC BY-NC-ND 4.0</a> <img src="https://mirrors.creativecommons.org/presskit/icons/cc.svg" width="20" valign=bottom><img src="https://mirrors.creativecommons.org/presskit/icons/by.svg" width="20" valign=bottom><img src="https://mirrors.creativecommons.org/presskit/icons/nc.svg" width="20" valign=bottom><img src="https://mirrors.creativecommons.org/presskit/icons/nd.svg" width="20" valign=bottom>
+Cards you generate, including their text and artwork, belong to you.
 
-The gem is available as open source under the terms of this license.
+See [LICENSE.txt](LICENSE.txt) for details.
 
-## Copyright
+## ©️ Copyright
 
-© 2025 Joe Sharp. Some rights reserved.
+© 2025 Joe Sharp. Released under the MIT License.
 MTG Card Maker is unofficial Fan Content permitted under the [Fan Content Policy.](https://company.wizards.com/en/legal/fancontentpolicy) Not approved/endorsed by Wizards. Portions of the materials used are property of Wizards of the Coast. © Wizards of the Coast LLC.
 
-The removal or alteration of copyright notices, attributions, and/or QR codes from generated images constitutes a material breach of the license agreement. All copyright notices and identifying marks must remain intact and unmodified in accordance with the terms of use.
+Please keep the copyright notices, attributions, and QR code on generated cards intact.
 
-## Code of Conduct
+## 🧙🏻 Code of Conduct
 
 Everyone interacting in the MTG Card Maker project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/joe-sharp/mtg_card_maker/blob/main/CODE_OF_CONDUCT.md).

data/lib/mtg_card_maker/base_card.rb

@@ -121,9 +121,11 @@ module MtgCardMaker
     # @option config [String] :border_color the border color
     # @option config [Symbol, String] :color the color scheme
     # @option config [String] :art the URL or path for card artwork
+    # @option config [Boolean] :embed_font whether to embed the font as base64 (default: true)
     def initialize(config)
       assign_attributes(config)
-      @template = Template.new
+      validate_required_fields
+      @template = Template.new(embed_font: config.fetch(:embed_font, true))
       add_layers
     end
 
@@ -185,6 +187,15 @@ module MtgCardMaker
       @art = config[:art]
     end
 
+    def validate_required_fields
+      required_fields = %i[name type_line rules_text]
+      missing_fields = required_fields.select { |field| send(field).nil? || send(field).to_s.strip.empty? }
+
+      return if missing_fields.empty?
+
+      raise ArgumentError, "Missing required fields: #{missing_fields.join(', ')}"
+    end
+
     def define_art_window_mask
       svg = @template.instance_variable_get(:@svg)
       svg.defs do
@@ -200,8 +211,20 @@ module MtgCardMaker
       end
     end
 
+    def define_gradients_for_card
+      svg = @template.instance_variable_get(:@svg)
+      SvgGradientService.define_all_gradients(svg, @color_scheme)
+
+      # Also define gradients for border layer
+      return unless @border_color
+
+      border_color_scheme = ColorScheme.new(@border_color.to_sym)
+      SvgGradientService.define_all_gradients(svg, border_color_scheme)
+    end
+
     def add_layers
       define_art_window_mask
+      define_gradients_for_card
       # Use LayerFactory to create layers in order
       layers = LayerFactory.create_layers_for_card(self, DEFAULTS[:mask_id], self)
       layers.each { |layer| @template.add_layer(layer) }