zodiacfonts 1.0.0 → 1.1.1

package/CHANGELOG.md

@@ -0,0 +1,44 @@
+# Changelog
+
+All notable changes to the `zodiacfonts` package are documented here.  
+Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).  
+Versioning follows [Semantic Versioning](https://semver.org/).
+
+---
+
+## [1.1.0] — 2026-06-20
+
+### Added
+- **Icon font layer** — the FREE family (`ZodiacFontFREE.woff2`) is now included in
+  the npm tarball and can be used as a web icon font alongside the SVGs.
+- `css/zodiac-fonts.css` — `@font-face` + `.zf` base class + all 55 FREE glyph rules +
+  46 PRO class stubs (codepoints published; PRO glyphs require a Pro license and
+  `ZodiacFontPRO.woff2` to render).
+- `css/zodiac-fonts.min.css` — minified version, recommended for production.
+- `js/zodiac-fonts.js` — ES module companion script; auto-runs on `DOMContentLoaded`
+  in plain HTML and exports `checkZodiacGlyphs()` for SPA frameworks.
+- `js/zodiac-fonts.min.js` — minified version.
+- `scss/zodiac-fonts.scss` — Sass source with `$zf-font-path` and `$zf-font-family`
+  `!default` variables for easy customisation before `@use`.
+- `package.json` `exports` map — subpath imports (`zodiacfonts/css`, `zodiacfonts/scss`,
+  `zodiacfonts/js`) now resolve correctly in all bundlers.
+- `unicode-range` descriptor in `@font-face` — scopes the FREE font to only its 55
+  codepoints; prevents fallback interference for unmapped PRO slots.
+
+### Changed
+- Repo structure reorganised: generated files moved from root into `css/`, `js/`, and
+  `scss/` subdirectories. `fonts/` continues to hold the WOFF2.
+- `sideEffects` in `package.json` updated to `["**/*.css", "**/*.scss"]` so bundlers
+  do not tree-shake stylesheet imports.
+
+---
+
+## [1.0.0] — 2026-06-06
+
+### Added
+- 55 free astrology SVG symbols across 8 categories: zodiac signs, main planets,
+  lunar phases, celestial points, dwarf planets & asteroids, houses, major aspects,
+  and movements.
+- `glyphs.json` — machine-readable manifest with `name`, `slug`, `reference`,
+  `codepoint`, and `file` for every symbol.
+- SIL Open Font License 1.1 (`OFL.txt`).

package/README.md

@@ -27,6 +27,7 @@ Zodiac signs, planets, lunar phases, houses, aspects and more — free for perso
 - [What's inside](#whats-inside)
 - [Installation](#installation)
 - [Usage](#usage)
+- [Icon font](#icon-font)
 - [Theming with `currentColor`](#theming-with-currentcolor)
 - [Folder structure](#folder-structure)
 - [The manifest (`glyphs.json`)](#the-manifest-glyphsjson)
@@ -59,7 +60,21 @@ Every SVG is normalized to a `0 0 512 512` viewBox and drawn with
 
 ```bash
 npm install zodiacfonts
-# symbols are then available under node_modules/zodiacfonts/icons/<category>/<name>.svg
+```
+
+Then reference icons by their package path — no manual file copying needed:
+
+```js
+// Vite / webpack / Rollup
+import ariesUrl from 'zodiacfonts/icons/signs/aries.svg';
+
+// React + SVGR (renders as a component)
+import AriesIcon from 'zodiacfonts/icons/signs/aries.svg?react';
+
+// Node.js / SSR (resolve the file path)
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+const ariesPath = require.resolve('zodiacfonts/icons/signs/aries.svg');
 ```
 
 **Download / clone** (recommended for static sites)
@@ -74,6 +89,9 @@ from [`icons/`](./icons).
 
 ## Usage
 
+> Paths below use the repo-relative form (`icons/signs/aries.svg`) — substitute
+> `zodiacfonts/icons/signs/aries.svg` when referencing from an npm install.
+
 ### As an image
 
 ```html
@@ -110,9 +128,82 @@ export const Aries = () => <img src={ariesUrl} alt="Aries" width={48} height={48
 <img src="assets/zodiac/signs/aries.svg" alt="Aries" width="48" height="48" />
 ```
 
-## Theming with `currentColor`
+## Icon font
+
+Zodiac Fonts ships an optional icon font layer alongside the SVGs, letting you render glyphs with
+a single HTML class — no image files or inline SVG required.
+
+### Quick start (CDN)
+
+```html
+<!-- Add to your <head> — the font + all glyph classes load automatically -->
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/zodiacfonts@latest/css/zodiac-fonts.min.css" />
+
+<!-- Render a glyph -->
+<i class="zf zf-aries" aria-hidden="true"></i>
+<span class="zf zf-moon" aria-label="Moon"></span>
+```
+
+### Quick start (npm / self-hosted)
+
+```bash
+npm install zodiacfonts
+```
+
+```js
+// Bundler (Vite, webpack, etc.) — plain CSS
+import 'zodiacfonts/css';
 
-Because the strokes use `currentColor`, an **inlined** SVG follows the CSS `color` property:
+// Sass / SCSS projects — override font path if needed
+// $zf-font-path: '/your/assets/ZodiacFontFREE.woff2';
+@use 'zodiacfonts/scss';
+```
+
+Or copy `css/zodiac-fonts.min.css` and the `fonts/` folder to your project and link the CSS manually.
+
+### FREE vs PRO glyphs
+
+The stylesheet ships CSS classes for **all 101 glyphs** — the 55 FREE ones and the 46 PRO stubs.
+FREE classes render immediately. PRO classes (marked `/* PRO */` in the source CSS) require
+a Pro license and `ZodiacFontPRO.woff2` to be self-hosted alongside `ZodiacFontFREE.woff2`.
+
+See [zodiacfonts.com/documentation](https://www.zodiacfonts.com/documentation) for the Pro
+integration guide, character map, and live preview of all 101 glyphs.
+
+### PRO usage detector
+
+Include the optional checker script to get a browser console warning whenever a PRO glyph
+class is used without the PRO font loaded. **No code needed** — it runs automatically.
+
+```html
+<!-- plain HTML / SSG — add after your CSS link, runs on DOMContentLoaded -->
+<script type="module" src="https://cdn.jsdelivr.net/npm/zodiacfonts@latest/js/zodiac-fonts.min.js"></script>
+```
+
+```js
+// SPA (React, Vue, Angular) — call inside your mount lifecycle
+import { checkZodiacGlyphs } from 'zodiacfonts/js';
+
+// React
+useEffect(() => { checkZodiacGlyphs(); }, []);
+
+// Vue
+onMounted(() => checkZodiacGlyphs());
+
+// Angular
+ngOnInit() { checkZodiacGlyphs(); }
+```
+
+When a PRO glyph is detected the console shows:
+
+```
+[Zodiac Fonts] PRO glyph detected: .zf-ophiuchus
+  This glyph requires a Pro license — it will not render with the FREE font.
+  Self-host ZodiacFontPRO.woff2 after purchasing a Pro license.
+  → https://www.zodiacfonts.com/documentation
+```
+
+## Theming with `currentColor`
 
 ```css
 .zodiac-icon { color: rebeccapurple; }
@@ -138,6 +229,8 @@ Sizing is just `width` / `height` (or `font-size` when inlined and using `1em` d
 
 ```
 zodiacfonts/
+├── fonts/
+│   └── ZodiacFontFREE.woff2         icon font (FREE codepoints only)
 ├── icons/
 │   ├── signs/                       aries.svg, taurus.svg, … (12)
 │   ├── main-planets/                sun.svg, moon.svg, … (11)
@@ -147,6 +240,14 @@ zodiacfonts/
 │   ├── houses/                      house-one.svg … medium-coeli.svg (14)
 │   ├── major-aspects/               conjunction.svg, trine.svg, … (5)
 │   └── movements/                   retrograde.svg (1)
+├── css/
+│   ├── zodiac-fonts.css             icon font CSS (FREE rules + PRO stubs)
+│   └── zodiac-fonts.min.css         minified (recommended for production)
+├── js/
+│   ├── zodiac-fonts.js              ES module companion script
+│   └── zodiac-fonts.min.js          minified
+├── scss/
+│   └── zodiac-fonts.scss            Sass source with $zf-* override variables
 ├── glyphs.json                      machine-readable manifest of all 55 symbols
 ├── OFL.txt                          SIL Open Font License 1.1
 ├── package.json

package/css/zodiac-fonts.css

@@ -0,0 +1,150 @@
+/*!
+ * Zodiac Fonts — free astrology icon font (55 free + 46 PRO stubs)
+ * SIL Open Font License 1.1 · https://www.zodiacfonts.com
+ * Generated from glyphs.json — do not edit by hand.
+ */
+@font-face {
+  font-family: 'Zodiac Fonts';
+  src: url('../fonts/ZodiacFontFREE.woff2') format('woff2');
+  font-weight: 400;
+  font-style: normal;
+  font-display: block;
+  unicode-range: U+E000, U+E001, U+E002, U+E004, U+E005, U+E006, U+E007, U+E008, U+E009, U+E00A, U+E00B, U+E00C, U+E100, U+E101, U+E102, U+E103, U+E104, U+E105, U+E106, U+E107, U+E108, U+E10A, U+E10B, U+E204, U+E205, U+E206, U+E207, U+E208, U+E209, U+E20A, U+E20B, U+E300, U+E301, U+E302, U+E401, U+E500, U+E501, U+E502, U+E503, U+E504, U+E505, U+E506, U+E507, U+E508, U+E509, U+E50A, U+E50B, U+E50C, U+E50D, U+E600, U+E601, U+E602, U+E603, U+E604, U+E901;
+}
+
+.zf {
+  font-family: 'Zodiac Fonts';
+  font-style: normal;
+  font-weight: 400;
+  font-variant: normal;
+  text-transform: none;
+  line-height: 1;
+  display: inline-block;
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+}
+
+.zf-aries::before { content: "\e000"; }
+.zf-cancer::before { content: "\e001"; }
+.zf-libra::before { content: "\e002"; }
+.zf-capricorn::before { content: "\e004"; }
+.zf-taurus::before { content: "\e005"; }
+.zf-leo::before { content: "\e006"; }
+.zf-scorpio::before { content: "\e007"; }
+.zf-aquarius::before { content: "\e008"; }
+.zf-gemini::before { content: "\e009"; }
+.zf-virgo::before { content: "\e00a"; }
+.zf-sagittarius::before { content: "\e00b"; }
+.zf-pisces::before { content: "\e00c"; }
+
+.zf-earth::before { content: "\e100"; }
+.zf-sun::before { content: "\e101"; }
+.zf-moon::before { content: "\e102"; }
+.zf-mercury::before { content: "\e103"; }
+.zf-venus::before { content: "\e104"; }
+.zf-mars::before { content: "\e105"; }
+.zf-jupiter::before { content: "\e106"; }
+.zf-saturn::before { content: "\e107"; }
+.zf-uranus::before { content: "\e108"; }
+.zf-neptune::before { content: "\e10a"; }
+.zf-pluto::before { content: "\e10b"; }
+
+.zf-new-moon::before { content: "\e204"; }
+.zf-waxing-crescent::before { content: "\e205"; }
+.zf-first-quarter::before { content: "\e206"; }
+.zf-waxing-gibbous::before { content: "\e207"; }
+.zf-full-moon::before { content: "\e208"; }
+.zf-waning-gibbous::before { content: "\e209"; }
+.zf-last-quarter::before { content: "\e20a"; }
+.zf-waning-crescent::before { content: "\e20b"; }
+
+.zf-north-node::before { content: "\e300"; }
+.zf-south-node::before { content: "\e301"; }
+.zf-lilith::before { content: "\e302"; }
+
+.zf-chiron::before { content: "\e401"; }
+
+.zf-house-one::before { content: "\e500"; }
+.zf-house-two::before { content: "\e501"; }
+.zf-house-three::before { content: "\e502"; }
+.zf-house-four::before { content: "\e503"; }
+.zf-house-five::before { content: "\e504"; }
+.zf-house-six::before { content: "\e505"; }
+.zf-house-seven::before { content: "\e506"; }
+.zf-house-eight::before { content: "\e507"; }
+.zf-house-nine::before { content: "\e508"; }
+.zf-house-ten::before { content: "\e509"; }
+.zf-house-eleven::before { content: "\e50a"; }
+.zf-house-twelve::before { content: "\e50b"; }
+.zf-ascendant::before { content: "\e50c"; }
+.zf-medium-coeli::before { content: "\e50d"; }
+
+.zf-conjunction::before { content: "\e600"; }
+.zf-opposition::before { content: "\e601"; }
+.zf-square::before { content: "\e602"; }
+.zf-trine::before { content: "\e603"; }
+.zf-sextile::before { content: "\e604"; }
+
+.zf-retrograde::before { content: "\e901"; }
+
+/* ─── PRO glyphs ─────────────────────────────────────────────────────────────
+   These classes are part of the full Zodiac Fonts API. They will NOT render
+   with the free font — the FREE font only covers the 55 codepoints above.
+   To display PRO glyphs, purchase a Pro license and self-host ZodiacFontPRO.woff2.
+   → https://www.zodiacfonts.com/documentation
+   ─────────────────────────────────────────────────────────────────────────── */
+
+.zf-capricorn-1::before { content: "\e003"; } /* PRO */
+.zf-ophiuchus::before { content: "\e00d"; } /* PRO */
+.zf-sign-cardinal::before { content: "\e00e"; } /* PRO */
+.zf-sign-fixed::before { content: "\e00f"; } /* PRO */
+.zf-sign-mutable::before { content: "\e010"; } /* PRO */
+
+.zf-uranus-2::before { content: "\e109"; } /* PRO */
+.zf-pluto-2::before { content: "\e10c"; } /* PRO */
+
+.zf-solar-eclipse-1::before { content: "\e200"; } /* PRO */
+.zf-lunar-eclipse-1::before { content: "\e201"; } /* PRO */
+.zf-solar-eclipse-2::before { content: "\e202"; } /* PRO */
+.zf-lunar-eclipse-2::before { content: "\e203"; } /* PRO */
+
+.zf-wheel-of-fortune::before { content: "\e303"; } /* PRO */
+.zf-vertex::before { content: "\e304"; } /* PRO */
+
+.zf-ceres::before { content: "\e400"; } /* PRO */
+.zf-pallas::before { content: "\e402"; } /* PRO */
+.zf-juno::before { content: "\e403"; } /* PRO */
+.zf-vesta-1::before { content: "\e404"; } /* PRO */
+.zf-vesta-2::before { content: "\e405"; } /* PRO */
+.zf-comet::before { content: "\e406"; } /* PRO */
+.zf-sedna::before { content: "\e407"; } /* PRO */
+.zf-makemake::before { content: "\e408"; } /* PRO */
+.zf-haumea::before { content: "\e409"; } /* PRO */
+.zf-proserpine::before { content: "\e40a"; } /* PRO */
+.zf-hygiea::before { content: "\e40b"; } /* PRO */
+.zf-eris-1::before { content: "\e40c"; } /* PRO */
+.zf-eris-2::before { content: "\e40d"; } /* PRO */
+
+.zf-imum-coeli::before { content: "\e50e"; } /* PRO */
+.zf-descendant::before { content: "\e50f"; } /* PRO */
+
+.zf-semi-sextile::before { content: "\e700"; } /* PRO */
+.zf-inconjunct::before { content: "\e701"; } /* PRO */
+.zf-semi-square::before { content: "\e702"; } /* PRO */
+.zf-septile::before { content: "\e703"; } /* PRO */
+.zf-sesquiquadrate::before { content: "\e704"; } /* PRO */
+.zf-quintile-2::before { content: "\e705"; } /* PRO */
+.zf-quintile::before { content: "\e706"; } /* PRO */
+.zf-biquintile::before { content: "\e707"; } /* PRO */
+.zf-biquintile-2::before { content: "\e708"; } /* PRO */
+.zf-novile::before { content: "\e709"; } /* PRO */
+.zf-parallel::before { content: "\e70a"; } /* PRO */
+.zf-contra-parallel::before { content: "\e70b"; } /* PRO */
+.zf-decile::before { content: "\e70c"; } /* PRO */
+
+.zf-element-fire::before { content: "\e800"; } /* PRO */
+.zf-element-air::before { content: "\e801"; } /* PRO */
+.zf-element-earth::before { content: "\e802"; } /* PRO */
+.zf-element-water::before { content: "\e803"; } /* PRO */
+
+.zf-direct::before { content: "\e900"; } /* PRO */

package/css/zodiac-fonts.min.css

@@ -0,0 +1,5 @@
+/*!
+ * Zodiac Fonts — free astrology icon font (55 free + 46 PRO stubs)
+ * SIL Open Font License 1.1 · https://www.zodiacfonts.com
+ * Generated from glyphs.json — do not edit by hand.
+ */@font-face{font-family:Zodiac Fonts;src:url(../fonts/ZodiacFontFREE.woff2) format("woff2");font-weight:400;font-style:normal;font-display:block;unicode-range:U+E000,U+E001,U+E002,U+E004,U+E005,U+E006,U+E007,U+E008,U+E009,U+E00A,U+E00B,U+E00C,U+E100,U+E101,U+E102,U+E103,U+E104,U+E105,U+E106,U+E107,U+E108,U+E10A,U+E10B,U+E204,U+E205,U+E206,U+E207,U+E208,U+E209,U+E20A,U+E20B,U+E300,U+E301,U+E302,U+E401,U+E500,U+E501,U+E502,U+E503,U+E504,U+E505,U+E506,U+E507,U+E508,U+E509,U+E50A,U+E50B,U+E50C,U+E50D,U+E600,U+E601,U+E602,U+E603,U+E604,U+E901}.zf{font-family:Zodiac Fonts;font-style:normal;font-weight:400;font-variant:normal;text-transform:none;line-height:1;display:inline-block;-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}.zf-aries:before{content:"\e000"}.zf-cancer:before{content:"\e001"}.zf-libra:before{content:"\e002"}.zf-capricorn:before{content:"\e004"}.zf-taurus:before{content:"\e005"}.zf-leo:before{content:"\e006"}.zf-scorpio:before{content:"\e007"}.zf-aquarius:before{content:"\e008"}.zf-gemini:before{content:"\e009"}.zf-virgo:before{content:"\e00a"}.zf-sagittarius:before{content:"\e00b"}.zf-pisces:before{content:"\e00c"}.zf-earth:before{content:"\e100"}.zf-sun:before{content:"\e101"}.zf-moon:before{content:"\e102"}.zf-mercury:before{content:"\e103"}.zf-venus:before{content:"\e104"}.zf-mars:before{content:"\e105"}.zf-jupiter:before{content:"\e106"}.zf-saturn:before{content:"\e107"}.zf-uranus:before{content:"\e108"}.zf-neptune:before{content:"\e10a"}.zf-pluto:before{content:"\e10b"}.zf-new-moon:before{content:"\e204"}.zf-waxing-crescent:before{content:"\e205"}.zf-first-quarter:before{content:"\e206"}.zf-waxing-gibbous:before{content:"\e207"}.zf-full-moon:before{content:"\e208"}.zf-waning-gibbous:before{content:"\e209"}.zf-last-quarter:before{content:"\e20a"}.zf-waning-crescent:before{content:"\e20b"}.zf-north-node:before{content:"\e300"}.zf-south-node:before{content:"\e301"}.zf-lilith:before{content:"\e302"}.zf-chiron:before{content:"\e401"}.zf-house-one:before{content:"\e500"}.zf-house-two:before{content:"\e501"}.zf-house-three:before{content:"\e502"}.zf-house-four:before{content:"\e503"}.zf-house-five:before{content:"\e504"}.zf-house-six:before{content:"\e505"}.zf-house-seven:before{content:"\e506"}.zf-house-eight:before{content:"\e507"}.zf-house-nine:before{content:"\e508"}.zf-house-ten:before{content:"\e509"}.zf-house-eleven:before{content:"\e50a"}.zf-house-twelve:before{content:"\e50b"}.zf-ascendant:before{content:"\e50c"}.zf-medium-coeli:before{content:"\e50d"}.zf-conjunction:before{content:"\e600"}.zf-opposition:before{content:"\e601"}.zf-square:before{content:"\e602"}.zf-trine:before{content:"\e603"}.zf-sextile:before{content:"\e604"}.zf-retrograde:before{content:"\e901"}.zf-capricorn-1:before{content:"\e003"}.zf-ophiuchus:before{content:"\e00d"}.zf-sign-cardinal:before{content:"\e00e"}.zf-sign-fixed:before{content:"\e00f"}.zf-sign-mutable:before{content:"\e010"}.zf-uranus-2:before{content:"\e109"}.zf-pluto-2:before{content:"\e10c"}.zf-solar-eclipse-1:before{content:"\e200"}.zf-lunar-eclipse-1:before{content:"\e201"}.zf-solar-eclipse-2:before{content:"\e202"}.zf-lunar-eclipse-2:before{content:"\e203"}.zf-wheel-of-fortune:before{content:"\e303"}.zf-vertex:before{content:"\e304"}.zf-ceres:before{content:"\e400"}.zf-pallas:before{content:"\e402"}.zf-juno:before{content:"\e403"}.zf-vesta-1:before{content:"\e404"}.zf-vesta-2:before{content:"\e405"}.zf-comet:before{content:"\e406"}.zf-sedna:before{content:"\e407"}.zf-makemake:before{content:"\e408"}.zf-haumea:before{content:"\e409"}.zf-proserpine:before{content:"\e40a"}.zf-hygiea:before{content:"\e40b"}.zf-eris-1:before{content:"\e40c"}.zf-eris-2:before{content:"\e40d"}.zf-imum-coeli:before{content:"\e50e"}.zf-descendant:before{content:"\e50f"}.zf-semi-sextile:before{content:"\e700"}.zf-inconjunct:before{content:"\e701"}.zf-semi-square:before{content:"\e702"}.zf-septile:before{content:"\e703"}.zf-sesquiquadrate:before{content:"\e704"}.zf-quintile-2:before{content:"\e705"}.zf-quintile:before{content:"\e706"}.zf-biquintile:before{content:"\e707"}.zf-biquintile-2:before{content:"\e708"}.zf-novile:before{content:"\e709"}.zf-parallel:before{content:"\e70a"}.zf-contra-parallel:before{content:"\e70b"}.zf-decile:before{content:"\e70c"}.zf-element-fire:before{content:"\e800"}.zf-element-air:before{content:"\e801"}.zf-element-earth:before{content:"\e802"}.zf-element-water:before{content:"\e803"}.zf-direct:before{content:"\e900"}

package/js/zodiac-fonts.js

@@ -0,0 +1,49 @@
+/**
+ * zodiac-fonts.js — Zodiac Fonts companion script
+ * Part of Zodiac Fonts · https://www.zodiacfonts.com
+ * Generated — do not edit by hand.
+ *
+ * Usage (plain HTML / SSG — runs automatically on DOMContentLoaded):
+ *   <script type="module" src="zodiac-fonts.js"></script>
+ *
+ * Usage (SPA — React, Vue, Angular — call inside your mount lifecycle):
+ *   import { checkZodiacGlyphs } from './zodiac-fonts.js';
+ *   checkZodiacGlyphs();
+ */
+
+/** Slugs of all PRO glyphs (generated from glyphs-list.json). */
+const PRO_SLUGS = new Set(["capricorn-1", "ophiuchus", "sign-cardinal", "sign-fixed", "sign-mutable", "uranus-2", "pluto-2", "solar-eclipse-1", "lunar-eclipse-1", "solar-eclipse-2", "lunar-eclipse-2", "wheel-of-fortune", "vertex", "ceres", "pallas", "juno", "vesta-1", "vesta-2", "comet", "sedna", "makemake", "haumea", "proserpine", "hygiea", "eris-1", "eris-2", "imum-coeli", "descendant", "semi-sextile", "inconjunct", "semi-square", "septile", "sesquiquadrate", "quintile-2", "quintile", "biquintile", "biquintile-2", "novile", "parallel", "contra-parallel", "decile", "element-fire", "element-air", "element-earth", "element-water", "direct"]);
+const DOCS_URL = 'https://www.zodiacfonts.com/documentation';
+
+/**
+ * Scans the document for elements using PRO glyph classes and emits a
+ * console warning for each one found. Safe to call multiple times.
+ * No-op in SSR / non-browser environments.
+ */
+export function checkZodiacGlyphs() {
+  if (typeof document === 'undefined') return; // SSR guard
+  document.querySelectorAll('.zf').forEach(function (el) {
+    el.classList.forEach(function (cls) {
+      if (cls.startsWith('zf-') && PRO_SLUGS.has(cls.slice(3))) {
+        console.warn(
+          '[Zodiac Fonts] PRO glyph detected: .' + cls + '\n' +
+          '  This glyph requires a Pro license — it will not render with the FREE font.\n' +
+          '  Self-host ZodiacFontPRO.woff2 after purchasing a Pro license.\n' +
+          '  \u2192 ' + DOCS_URL,
+        );
+      }
+    });
+  });
+}
+
+// Auto-run on plain HTML pages — no adaptor effort needed.
+// In bundled SPA apps, call checkZodiacGlyphs() manually inside your
+// framework's mount lifecycle (useEffect, onMounted, ngOnInit, etc.).
+if (typeof document !== 'undefined') {
+  var run = function () { checkZodiacGlyphs(); };
+  if (document.readyState === 'loading') {
+    document.addEventListener('DOMContentLoaded', run);
+  } else {
+    run(); // script loaded after DOM is ready (e.g. deferred or dynamic import)
+  }
+}

package/js/zodiac-fonts.min.js

@@ -0,0 +1,4 @@
+const i=new Set(["capricorn-1","ophiuchus","sign-cardinal","sign-fixed","sign-mutable","uranus-2","pluto-2","solar-eclipse-1","lunar-eclipse-1","solar-eclipse-2","lunar-eclipse-2","wheel-of-fortune","vertex","ceres","pallas","juno","vesta-1","vesta-2","comet","sedna","makemake","haumea","proserpine","hygiea","eris-1","eris-2","imum-coeli","descendant","semi-sextile","inconjunct","semi-square","septile","sesquiquadrate","quintile-2","quintile","biquintile","biquintile-2","novile","parallel","contra-parallel","decile","element-fire","element-air","element-earth","element-water","direct"]),a="https://www.zodiacfonts.com/documentation";export function checkZodiacGlyphs(){typeof document>"u"||document.querySelectorAll(".zf").forEach(function(t){t.classList.forEach(function(e){e.startsWith("zf-")&&i.has(e.slice(3))&&console.warn("[Zodiac Fonts] PRO glyph detected: ."+e+`
+  This glyph requires a Pro license \u2014 it will not render with the FREE font.
+  Self-host ZodiacFontPRO.woff2 after purchasing a Pro license.
+  \u2192 `+a)})})}if(typeof document<"u"){var n=function(){checkZodiacGlyphs()};document.readyState==="loading"?document.addEventListener("DOMContentLoaded",n):n()}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zodiacfonts",
-  "version": "1.0.0",
+  "version": "1.1.1",
   "description": "Free astrology icons & symbols — 55 hand-crafted, currentColor-ready SVG glyphs (zodiac signs, planets, houses, aspects, lunar phases). Part of Zodiac Fonts.",
   "keywords": [
     "astrology",
@@ -28,10 +28,27 @@
   "author": "Zodiac Fonts (https://www.zodiacfonts.com)",
   "type": "module",
   "files": [
+    "fonts",
     "icons",
+    "css",
+    "js",
+    "scss",
     "glyphs.json",
     "OFL.txt",
+    "CHANGELOG.md",
     "README.md"
   ],
-  "sideEffects": false
+  "exports": {
+    "./css": "./css/zodiac-fonts.css",
+    "./css/min": "./css/zodiac-fonts.min.css",
+    "./js": "./js/zodiac-fonts.js",
+    "./scss": "./scss/zodiac-fonts.scss",
+    "./glyphs.json": "./glyphs.json",
+    "./icons/*": "./icons/*",
+    "./fonts/*": "./fonts/*"
+  },
+  "sideEffects": [
+    "**/*.css",
+    "**/*.scss"
+  ]
 }

package/scss/zodiac-fonts.scss

@@ -0,0 +1,162 @@
+// zodiac-fonts.scss — Zodiac Fonts Sass source
+// Part of Zodiac Fonts · https://www.zodiacfonts.com
+// Generated from glyphs.json — do not edit by hand.
+//
+// Usage with a bundler (Vite, webpack, Angular CLI, etc.):
+//   @use 'zodiacfonts/scss';                // default font path
+//
+// Override the font path before importing:
+//   $zf-font-path: '/your/assets/ZodiacFontFREE.woff2';
+//   @use 'zodiacfonts/scss';
+//
+// Available variables (all `!default`, override before @use):
+//   $zf-font-path    Path to ZodiacFontFREE.woff2 (default: relative to this file)
+//   $zf-font-family  Font-family name registered with @font-face
+
+$zf-font-path:   '../fonts/ZodiacFontFREE.woff2' !default;
+$zf-font-family: 'Zodiac Fonts' !default;
+
+@font-face {
+  font-family: $zf-font-family;
+  src: url(#{$zf-font-path}) format('woff2');
+  font-weight: 400;
+  font-style: normal;
+  font-display: block;
+  unicode-range: U+E000, U+E001, U+E002, U+E004, U+E005, U+E006, U+E007, U+E008, U+E009, U+E00A, U+E00B, U+E00C, U+E100, U+E101, U+E102, U+E103, U+E104, U+E105, U+E106, U+E107, U+E108, U+E10A, U+E10B, U+E204, U+E205, U+E206, U+E207, U+E208, U+E209, U+E20A, U+E20B, U+E300, U+E301, U+E302, U+E401, U+E500, U+E501, U+E502, U+E503, U+E504, U+E505, U+E506, U+E507, U+E508, U+E509, U+E50A, U+E50B, U+E50C, U+E50D, U+E600, U+E601, U+E602, U+E603, U+E604, U+E901;
+}
+
+.zf {
+  font-family: $zf-font-family;
+  font-style: normal;
+  font-weight: 400;
+  font-variant: normal;
+  text-transform: none;
+  line-height: 1;
+  display: inline-block;
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+}
+
+.zf-aries::before { content: "\e000"; }
+.zf-cancer::before { content: "\e001"; }
+.zf-libra::before { content: "\e002"; }
+.zf-capricorn::before { content: "\e004"; }
+.zf-taurus::before { content: "\e005"; }
+.zf-leo::before { content: "\e006"; }
+.zf-scorpio::before { content: "\e007"; }
+.zf-aquarius::before { content: "\e008"; }
+.zf-gemini::before { content: "\e009"; }
+.zf-virgo::before { content: "\e00a"; }
+.zf-sagittarius::before { content: "\e00b"; }
+.zf-pisces::before { content: "\e00c"; }
+
+.zf-earth::before { content: "\e100"; }
+.zf-sun::before { content: "\e101"; }
+.zf-moon::before { content: "\e102"; }
+.zf-mercury::before { content: "\e103"; }
+.zf-venus::before { content: "\e104"; }
+.zf-mars::before { content: "\e105"; }
+.zf-jupiter::before { content: "\e106"; }
+.zf-saturn::before { content: "\e107"; }
+.zf-uranus::before { content: "\e108"; }
+.zf-neptune::before { content: "\e10a"; }
+.zf-pluto::before { content: "\e10b"; }
+
+.zf-new-moon::before { content: "\e204"; }
+.zf-waxing-crescent::before { content: "\e205"; }
+.zf-first-quarter::before { content: "\e206"; }
+.zf-waxing-gibbous::before { content: "\e207"; }
+.zf-full-moon::before { content: "\e208"; }
+.zf-waning-gibbous::before { content: "\e209"; }
+.zf-last-quarter::before { content: "\e20a"; }
+.zf-waning-crescent::before { content: "\e20b"; }
+
+.zf-north-node::before { content: "\e300"; }
+.zf-south-node::before { content: "\e301"; }
+.zf-lilith::before { content: "\e302"; }
+
+.zf-chiron::before { content: "\e401"; }
+
+.zf-house-one::before { content: "\e500"; }
+.zf-house-two::before { content: "\e501"; }
+.zf-house-three::before { content: "\e502"; }
+.zf-house-four::before { content: "\e503"; }
+.zf-house-five::before { content: "\e504"; }
+.zf-house-six::before { content: "\e505"; }
+.zf-house-seven::before { content: "\e506"; }
+.zf-house-eight::before { content: "\e507"; }
+.zf-house-nine::before { content: "\e508"; }
+.zf-house-ten::before { content: "\e509"; }
+.zf-house-eleven::before { content: "\e50a"; }
+.zf-house-twelve::before { content: "\e50b"; }
+.zf-ascendant::before { content: "\e50c"; }
+.zf-medium-coeli::before { content: "\e50d"; }
+
+.zf-conjunction::before { content: "\e600"; }
+.zf-opposition::before { content: "\e601"; }
+.zf-square::before { content: "\e602"; }
+.zf-trine::before { content: "\e603"; }
+.zf-sextile::before { content: "\e604"; }
+
+.zf-retrograde::before { content: "\e901"; }
+
+// ─── PRO glyphs ────────────────────────────────────────────────────────────
+// These classes are part of the full Zodiac Fonts API. They will NOT render
+// with the free font. Purchase a Pro license and self-host ZodiacFontPRO.woff2.
+// → https://www.zodiacfonts.com/documentation
+// ──────────────────────────────────────────────────────────────────────────
+
+.zf-capricorn-1::before { content: "\e003"; } // PRO
+.zf-ophiuchus::before { content: "\e00d"; } // PRO
+.zf-sign-cardinal::before { content: "\e00e"; } // PRO
+.zf-sign-fixed::before { content: "\e00f"; } // PRO
+.zf-sign-mutable::before { content: "\e010"; } // PRO
+
+.zf-uranus-2::before { content: "\e109"; } // PRO
+.zf-pluto-2::before { content: "\e10c"; } // PRO
+
+.zf-solar-eclipse-1::before { content: "\e200"; } // PRO
+.zf-lunar-eclipse-1::before { content: "\e201"; } // PRO
+.zf-solar-eclipse-2::before { content: "\e202"; } // PRO
+.zf-lunar-eclipse-2::before { content: "\e203"; } // PRO
+
+.zf-wheel-of-fortune::before { content: "\e303"; } // PRO
+.zf-vertex::before { content: "\e304"; } // PRO
+
+.zf-ceres::before { content: "\e400"; } // PRO
+.zf-pallas::before { content: "\e402"; } // PRO
+.zf-juno::before { content: "\e403"; } // PRO
+.zf-vesta-1::before { content: "\e404"; } // PRO
+.zf-vesta-2::before { content: "\e405"; } // PRO
+.zf-comet::before { content: "\e406"; } // PRO
+.zf-sedna::before { content: "\e407"; } // PRO
+.zf-makemake::before { content: "\e408"; } // PRO
+.zf-haumea::before { content: "\e409"; } // PRO
+.zf-proserpine::before { content: "\e40a"; } // PRO
+.zf-hygiea::before { content: "\e40b"; } // PRO
+.zf-eris-1::before { content: "\e40c"; } // PRO
+.zf-eris-2::before { content: "\e40d"; } // PRO
+
+.zf-imum-coeli::before { content: "\e50e"; } // PRO
+.zf-descendant::before { content: "\e50f"; } // PRO
+
+.zf-semi-sextile::before { content: "\e700"; } // PRO
+.zf-inconjunct::before { content: "\e701"; } // PRO
+.zf-semi-square::before { content: "\e702"; } // PRO
+.zf-septile::before { content: "\e703"; } // PRO
+.zf-sesquiquadrate::before { content: "\e704"; } // PRO
+.zf-quintile-2::before { content: "\e705"; } // PRO
+.zf-quintile::before { content: "\e706"; } // PRO
+.zf-biquintile::before { content: "\e707"; } // PRO
+.zf-biquintile-2::before { content: "\e708"; } // PRO
+.zf-novile::before { content: "\e709"; } // PRO
+.zf-parallel::before { content: "\e70a"; } // PRO
+.zf-contra-parallel::before { content: "\e70b"; } // PRO
+.zf-decile::before { content: "\e70c"; } // PRO
+
+.zf-element-fire::before { content: "\e800"; } // PRO
+.zf-element-air::before { content: "\e801"; } // PRO
+.zf-element-earth::before { content: "\e802"; } // PRO
+.zf-element-water::before { content: "\e803"; } // PRO
+
+.zf-direct::before { content: "\e900"; } // PRO