astroglyphs-2K 0.1.0__tar.gz

astroglyphs_2k-0.1.0/.gitignore

@@ -0,0 +1,11 @@
+*.pyc
+__pycache__/
+.venv/
+venv/
+build/
+dist/
+*.egg-info/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+_apicheck.*

astroglyphs_2k-0.1.0/CHANGELOG.md

@@ -0,0 +1,34 @@
+# Changelog
+
+All notable changes to **astroglyphs_2K** are documented here. The format follows
+[Keep a Changelog](https://keepachangelog.com/) and the project uses
+[Semantic Versioning](https://semver.org/).
+
+## [Unreleased]
+
+## [0.1.0] — 2026-09-15
+
+Initial release — curated OFL astrology glyph fonts + metrics + embedding helpers.
+
+### Added
+- **Curated "best of Noto" astrology glyphs**, subset from the Noto family and renamed per the
+  OFL Reserved Font Name clause: `AstroSym` (Noto Sans Symbols — planets, nodes, 12 signs,
+  asteroids, Chiron, Lilith, Hygeia, aspect symbols), `AstroSym2` (Noto Sans Symbols 2 — Sun,
+  Eros, Eris, Sedna), `AstroMath` (Noto Sans Math — ⊗ Part of Fortune), `AstroText` (Noto Sans —
+  digits, Latin, ℞ · ° · ′ · ″).
+- **`font_face_css(embed=True, fontset="astroset")`** — self-contained `<style>` inlining the
+  fonts as `data:` woff2 URIs. `fontset="fullset"` swaps in the full Noto coverage (text + every
+  symbol) under the same family names for anyone who needs more than astrology.
+- **`SYM_FAMILY` / `TXT_FAMILY`** ready-made `font-family` stacks (embedded first, system
+  fallbacks after, so `embed=False` degrades gracefully).
+- **`glyph_metrics(ch)` / `GLYPH_METRICS`** — real per-glyph ink-bbox metrics (advance, ymin,
+  ymax, xmin, xmax as em fractions) from the source outlines, for precise layout.
+- **Installable font files** — each fontset (`astroset`, `fullset`) is shipped as `.ttf`
+  (TrueType, native), `.otf` (OpenType-CFF, converted via qu2cu) and `.woff2` package data.
+  `save_fonts(dest, fontset, formats)` writes them to a directory and `font_bytes(family,
+  fontset, fmt)` returns the raw bytes — so the glyphs are usable as embedded web fonts *and*
+  as installable desktop fonts, not only as base64.
+- Zero runtime dependencies. `tools/build.py` regenerates the data + font files from the vendored
+  Noto sources (needs fonttools + brotli; build-only) and is deterministic.
+
+[0.1.0]: https://github.com/NoahChristian/astroglyphs_2K/releases/tag/v0.1.0

astroglyphs_2k-0.1.0/LICENSE

@@ -0,0 +1,29 @@
+MIT License
+
+Copyright (c) 2026 Elizabeth Huston, Ph.D. and Noah Christian, Ph.D.
+
+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:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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.
+
+---
+
+The bundled glyph data (the Astro* subset fonts under src/astroglyphs_2K/, both the
+base64 "astroset" data and the "fullset" woff2 files) is derived from the Noto fonts
+and is licensed separately under the SIL Open Font License, Version 1.1 — see
+LICENSES/OFL.txt. The subsets are renamed (Astro*) so they are not distributed under
+a Noto Reserved Font Name.

astroglyphs_2k-0.1.0/LICENSES/OFL.txt

@@ -0,0 +1,93 @@
+Copyright 2022 The Noto Project Authors (https://github.com/notofonts/latin-greek-cyrillic)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+https://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

astroglyphs_2k-0.1.0/PKG-INFO

@@ -0,0 +1,95 @@
+Metadata-Version: 2.5
+Name: astroglyphs_2K
+Version: 0.1.0
+Summary: Curated OFL astrology glyph fonts (the best of Noto) + metrics + embedding helpers
+Project-URL: Homepage, https://github.com/NoahChristian/astroglyphs_2K
+Project-URL: Repository, https://github.com/NoahChristian/astroglyphs_2K
+Author: Elizabeth Huston, Noah Christian
+License-Expression: MIT
+License-File: LICENSE
+Keywords: astrology,fonts,glyphs,noto,ofl,planets,svg,webfont,zodiac
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Multimedia :: Graphics
+Classifier: Topic :: Scientific/Engineering :: Astronomy
+Requires-Python: >=3.10
+Provides-Extra: build
+Requires-Dist: brotli>=1.0; extra == 'build'
+Requires-Dist: fonttools>=4.4; extra == 'build'
+Provides-Extra: test
+Requires-Dist: mypy>=1.10; extra == 'test'
+Requires-Dist: pytest>=7; extra == 'test'
+Requires-Dist: ruff>=0.6; extra == 'test'
+Description-Content-Type: text/markdown
+
+# astroglyphs_2K
+
+Curated **OFL astrology glyph fonts** — the "best of Noto" — plus per-glyph metrics and one-line
+embedding helpers, so any chart renderer gets **deterministic** astrology symbols instead of
+depending on whatever fonts the viewer has installed.
+
+The good astrology fonts (Linotype Astrology Pi and friends) are proprietary and can't be
+bundled. astroglyphs_2K subsets the freely-licensed **Noto** family into compact web fonts you
+can inline directly into an SVG or HTML page, and tells you exactly how big each glyph is.
+
+```bash
+pip install astroglyphs_2K
+```
+
+```python
+import astroglyphs_2K as ag
+
+svg = (ag.font_face_css()                      # <style> with the embedded @font-face rules
+       + f'<text font-family={ag.SYM_FAMILY!r}>☉︎ ♄︎ ♏︎</text>'
+       + f'<text font-family={ag.TXT_FAMILY!r}>22°℞ 36′</text>')
+```
+
+## What's inside
+
+All glyphs are subset from Noto and **renamed** per the OFL Reserved Font Name clause:
+
+| Family | Source (Noto) | Glyphs |
+|---|---|---|
+| `AstroSym`  | Noto Sans Symbols   | planets (Moon–Pluto), nodes, the 12 signs, asteroids, Chiron, Lilith, Hygeia, aspect symbols |
+| `AstroSym2` | Noto Sans Symbols 2 | the Sun, Eros, Eris, Sedna |
+| `AstroMath` | Noto Sans Math      | ⊗ Part of Fortune |
+| `AstroText` | Noto Sans           | digits, Latin, `℞` · `°` · `′` · `″` |
+
+`SYM_FAMILY` and `TXT_FAMILY` are ready-made `font-family` stacks (embedded families first,
+system fallbacks after), so with `font_face_css(embed=False)` the page degrades gracefully to
+the viewer's own fonts.
+
+## API
+
+- `font_face_css(embed=True)` → a `<style>` element inlining every font as a `data:` woff2 URI
+  (self-contained; returns `""` when `embed=False`).
+- `SYM_FAMILY`, `TXT_FAMILY` → `font-family` stacks.
+- `glyph_metrics(ch)` → `(advance, ymin, ymax, xmin, xmax)` in fractions of the em (ink bounding
+  box from the outline) — for laying glyphs out without guessing.
+- `save_fonts(dest, fontset="astroset", formats=("ttf","otf","woff2"))` → write the packaged
+  **installable font files** (TrueType `.ttf`, OpenType-CFF `.otf`, web `.woff2`) into a directory;
+  `font_bytes(family, fontset, fmt)` returns one file's raw bytes. Both `astroset` (the compact
+  astrology subset) and `fullset` (the whole renamed Noto family) are available.
+- `GLYPH_METRICS`, `SYMBOL_FAMILY_NAMES`, `TEXT_FAMILY_NAME`, `FONT_SETS`, `FONT_FORMATS`,
+  `OFL_ATTRIBUTION`.
+
+## Licensing
+
+Code: **MIT**. Bundled font data: **SIL Open Font License 1.1** (the subset Noto glyphs) — see
+[`LICENSES/OFL.txt`](LICENSES/OFL.txt) and `astroglyphs_2K.OFL_ATTRIBUTION`. The subsets are
+renamed (`Astro*`) so they are not distributed under a Noto Reserved Font Name.
+
+## Rebuilding the data
+
+```bash
+pip install -e ".[build]"      # fonttools + brotli
+python tools/build.py          # regenerates src/astroglyphs_2K/_data.py from tools/fonts/*.ttf
+```
+
+Deterministic: the same vendored sources produce the same `_data.py`.
+
+MIT © 2026 Elizabeth Huston, Ph.D. and Noah Christian, Ph.D. · bundled glyphs © the Noto Project (OFL 1.1)

astroglyphs_2k-0.1.0/README.md

@@ -0,0 +1,67 @@
+# astroglyphs_2K
+
+Curated **OFL astrology glyph fonts** — the "best of Noto" — plus per-glyph metrics and one-line
+embedding helpers, so any chart renderer gets **deterministic** astrology symbols instead of
+depending on whatever fonts the viewer has installed.
+
+The good astrology fonts (Linotype Astrology Pi and friends) are proprietary and can't be
+bundled. astroglyphs_2K subsets the freely-licensed **Noto** family into compact web fonts you
+can inline directly into an SVG or HTML page, and tells you exactly how big each glyph is.
+
+```bash
+pip install astroglyphs_2K
+```
+
+```python
+import astroglyphs_2K as ag
+
+svg = (ag.font_face_css()                      # <style> with the embedded @font-face rules
+       + f'<text font-family={ag.SYM_FAMILY!r}>☉︎ ♄︎ ♏︎</text>'
+       + f'<text font-family={ag.TXT_FAMILY!r}>22°℞ 36′</text>')
+```
+
+## What's inside
+
+All glyphs are subset from Noto and **renamed** per the OFL Reserved Font Name clause:
+
+| Family | Source (Noto) | Glyphs |
+|---|---|---|
+| `AstroSym`  | Noto Sans Symbols   | planets (Moon–Pluto), nodes, the 12 signs, asteroids, Chiron, Lilith, Hygeia, aspect symbols |
+| `AstroSym2` | Noto Sans Symbols 2 | the Sun, Eros, Eris, Sedna |
+| `AstroMath` | Noto Sans Math      | ⊗ Part of Fortune |
+| `AstroText` | Noto Sans           | digits, Latin, `℞` · `°` · `′` · `″` |
+
+`SYM_FAMILY` and `TXT_FAMILY` are ready-made `font-family` stacks (embedded families first,
+system fallbacks after), so with `font_face_css(embed=False)` the page degrades gracefully to
+the viewer's own fonts.
+
+## API
+
+- `font_face_css(embed=True)` → a `<style>` element inlining every font as a `data:` woff2 URI
+  (self-contained; returns `""` when `embed=False`).
+- `SYM_FAMILY`, `TXT_FAMILY` → `font-family` stacks.
+- `glyph_metrics(ch)` → `(advance, ymin, ymax, xmin, xmax)` in fractions of the em (ink bounding
+  box from the outline) — for laying glyphs out without guessing.
+- `save_fonts(dest, fontset="astroset", formats=("ttf","otf","woff2"))` → write the packaged
+  **installable font files** (TrueType `.ttf`, OpenType-CFF `.otf`, web `.woff2`) into a directory;
+  `font_bytes(family, fontset, fmt)` returns one file's raw bytes. Both `astroset` (the compact
+  astrology subset) and `fullset` (the whole renamed Noto family) are available.
+- `GLYPH_METRICS`, `SYMBOL_FAMILY_NAMES`, `TEXT_FAMILY_NAME`, `FONT_SETS`, `FONT_FORMATS`,
+  `OFL_ATTRIBUTION`.
+
+## Licensing
+
+Code: **MIT**. Bundled font data: **SIL Open Font License 1.1** (the subset Noto glyphs) — see
+[`LICENSES/OFL.txt`](LICENSES/OFL.txt) and `astroglyphs_2K.OFL_ATTRIBUTION`. The subsets are
+renamed (`Astro*`) so they are not distributed under a Noto Reserved Font Name.
+
+## Rebuilding the data
+
+```bash
+pip install -e ".[build]"      # fonttools + brotli
+python tools/build.py          # regenerates src/astroglyphs_2K/_data.py from tools/fonts/*.ttf
+```
+
+Deterministic: the same vendored sources produce the same `_data.py`.
+
+MIT © 2026 Elizabeth Huston, Ph.D. and Noah Christian, Ph.D. · bundled glyphs © the Noto Project (OFL 1.1)

astroglyphs_2k-0.1.0/pyproject.toml

@@ -0,0 +1,68 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "astroglyphs_2K"
+version = "0.1.0"
+description = "Curated OFL astrology glyph fonts (the best of Noto) + metrics + embedding helpers"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [
+    { name = "Elizabeth Huston" },
+    { name = "Noah Christian" },
+]
+keywords = [
+    "astrology", "fonts", "glyphs", "svg", "noto", "ofl", "zodiac", "planets", "webfont",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Topic :: Multimedia :: Graphics",
+    "Topic :: Scientific/Engineering :: Astronomy",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+]
+# The runtime is pure data + stdlib — no dependencies. The bundled glyphs are subset from the
+# Noto family and licensed under the SIL Open Font License 1.1 (see LICENSES/OFL.txt); the code
+# is MIT. fonttools + brotli are needed only to REBUILD the data (tools/build.py).
+dependencies = []
+
+[project.optional-dependencies]
+build = ["fonttools>=4.4", "brotli>=1.0"]
+test = ["pytest>=7", "ruff>=0.6", "mypy>=1.10"]
+
+[project.urls]
+Homepage = "https://github.com/NoahChristian/astroglyphs_2K"
+Repository = "https://github.com/NoahChristian/astroglyphs_2K"
+
+[tool.hatch.build]
+# ship the generated font files (ttf/otf/woff2 for astroset + fullset) as binary package data
+artifacts = [
+    "src/astroglyphs_2K/fonts/astroset/*",
+    "src/astroglyphs_2K/fonts/fullset/*",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/astroglyphs_2K"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/astroglyphs_2K", "tools", "README.md", "CHANGELOG.md", "LICENSE", "LICENSES"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B"]
+# E501: the generated _data.py holds long base64 lines. UP031: %-formatting is deliberate.
+ignore = ["E501", "UP031"]
+
+[tool.mypy]
+python_version = "3.10"
+files = ["src/astroglyphs_2K"]
+ignore_missing_imports = true
+disallow_untyped_defs = false

astroglyphs_2k-0.1.0/src/astroglyphs_2K/__init__.py

@@ -0,0 +1,148 @@
+"""astroglyphs_2K — curated OFL astrology glyph fonts (the "best of Noto") + metrics + embedding.
+
+A tiny, zero-runtime-dependency toolkit that gives any chart renderer a deterministic,
+embeddable set of astrology glyphs. The good astrology fonts are proprietary; this subsets and
+re-packages the freely-licensed **Noto** family (SIL Open Font License) into compact web fonts
+plus real per-glyph metrics, so charts render identically on every device instead of depending
+on whatever symbol font the viewer happens to have.
+
+Glyph routing (all OFL, subset + renamed per the Reserved Font Name clause):
+- **AstroSym**  (Noto Sans Symbols)   — planets, nodes, 12 signs, asteroids, Chiron, Lilith, Hygeia
+- **AstroSym2** (Noto Sans Symbols 2) — the Sun, Eros, Eris, Sedna
+- **AstroMath** (Noto Sans Math)      — ⊗ Part of Fortune
+- **AstroText** (Noto Sans)           — digits, Latin, ℞ · ° · ′ · ″
+
+Quick use (inline in an SVG or HTML):
+    import astroglyphs_2K as ag
+    svg = ag.font_face_css() + '<text font-family=%r>%s</text>' % (ag.SYM_FAMILY, "☉︎")
+
+Regenerate the bundled data with ``python tools/build.py`` (needs fonttools + brotli; build-only).
+"""
+
+import base64 as _base64
+import importlib.resources as _res
+
+from ._data import (  # noqa: F401
+    GLYPH_METRICS,
+    OFL_ATTRIBUTION,
+    SOURCE_FONT_VERSIONS,
+    SYMBOL_FAMILY_NAMES,
+    SYMBOLS_WOFF2_B64,
+    TEXT_FAMILY_NAME,
+    TEXT_WOFF2_B64,
+)
+
+__version__ = "0.1.0"
+
+# System fallbacks (used when embedding is off, or a viewer strips the embedded face).
+# Family names are single-quoted so the stacks are valid both in a CSS `font-family:` value
+# AND inside a double-quoted SVG/HTML `font-family="..."` attribute (single quotes can't
+# collide with the double-quote delimiter); font-family matching ignores quote style, so the
+# `@font-face` rules below keep their double quotes and still bind to these single-quoted refs.
+_SYM_FALLBACK = "'Segoe UI Symbol','Noto Sans Symbols2','Apple Symbols',system-ui,sans-serif"
+_TXT_FALLBACK = "system-ui,-apple-system,'Segoe UI',Roboto,sans-serif"
+
+#: font-family stack for symbol glyphs (embedded families first, then system fallbacks)
+SYM_FAMILY = ",".join("'%s'" % n for n in SYMBOL_FAMILY_NAMES) + "," + _SYM_FALLBACK
+#: font-family stack for text (numerals, labels, ℞/°/′/″)
+TXT_FAMILY = "'%s',%s" % (TEXT_FAMILY_NAME, _TXT_FALLBACK)
+
+#: the font file formats shipped as package data for each fontset
+FONT_FORMATS = ("ttf", "otf", "woff2")
+#: the fontsets available as installable/exportable files
+FONT_SETS = ("astroset", "fullset")
+
+__all__ = [
+    "__version__", "SYM_FAMILY", "TXT_FAMILY", "font_face_css", "glyph_metrics",
+    "GLYPH_METRICS", "SYMBOL_FAMILY_NAMES", "TEXT_FAMILY_NAME", "OFL_ATTRIBUTION",
+    "SOURCE_FONT_VERSIONS", "save_fonts", "font_bytes", "FONT_FORMATS", "FONT_SETS",
+]
+
+
+def _face(fam, b64, weight=False):
+    w = ";font-weight:100 900" if weight else ""
+    return ('@font-face{font-family:"%s";src:url(data:font/woff2;base64,%s) '
+            'format("woff2")%s;}' % (fam, b64, w))
+
+
+def _fullset_b64(fam):
+    """Base64 of a full-coverage woff2, read from package data (the 'fullset' perk)."""
+    return _base64.b64encode(font_bytes(fam, "fullset", "woff2")).decode("ascii")
+
+
+def _families():
+    return list(SYMBOL_FAMILY_NAMES) + [TEXT_FAMILY_NAME]
+
+
+def font_bytes(family: str, fontset: str = "astroset", fmt: str = "ttf") -> bytes:
+    """Raw bytes of one packaged font file — ``family`` (e.g. "AstroSym", "AstroText"),
+    ``fontset`` ("astroset" or "fullset") and ``fmt`` ("ttf", "otf" or "woff2")."""
+    if fontset not in FONT_SETS:
+        raise ValueError("fontset must be one of %r, not %r" % (FONT_SETS, fontset))
+    if fmt not in FONT_FORMATS:
+        raise ValueError("fmt must be one of %r, not %r" % (FONT_FORMATS, fmt))
+    if family not in _families():
+        raise ValueError("family must be one of %r, not %r" % (_families(), family))
+    return (_res.files(__name__).joinpath("fonts").joinpath(fontset)
+            .joinpath(family + "." + fmt).read_bytes())
+
+
+def save_fonts(dest_dir, fontset: str = "astroset", formats=("ttf", "otf", "woff2")) -> list:
+    """Write the packaged font files for ``fontset`` into ``dest_dir`` and return the paths.
+
+    These are the renamed OFL glyph fonts: installable desktop fonts (``ttf`` native, ``otf``/CFF)
+    plus the web font (``woff2``). ``"astroset"`` is the compact astrology subset; ``"fullset"`` is
+    the whole renamed Noto family (much larger). Example — export installable fonts::
+
+        import astroglyphs_2K as ag
+        ag.save_fonts("~/astro-fonts", fontset="fullset", formats=("ttf", "otf"))
+    """
+    import os
+    import pathlib
+    dest = pathlib.Path(os.path.expanduser(str(dest_dir)))
+    dest.mkdir(parents=True, exist_ok=True)
+    written = []
+    for fam in _families():
+        for fmt in formats:
+            out = dest / (fam + "." + fmt)
+            out.write_bytes(font_bytes(fam, fontset, fmt))
+            written.append(out)
+    return written
+
+
+def font_face_css(embed: bool = True, fontset: str = "astroset") -> str:
+    """Return a ``<style>`` element with the ``@font-face`` rules for the embedded fonts.
+
+    Each face inlines its woff2 as a ``data:`` URI, so the output is self-contained (no network,
+    no external files). Returns ``""`` when ``embed`` is False — then ``SYM_FAMILY`` / ``TXT_FAMILY``
+    fall back to the viewer's system fonts.
+
+    ``fontset``:
+      - ``"astroset"`` (default) — the compact curated astrology subset (~60 KB total). Covers
+        everything astrology renders; the metrics in ``GLYPH_METRICS`` describe exactly this set.
+      - ``"fullset"`` — the whole megacollection: the FULL Noto fonts (text + every symbol),
+        under the same family names, for anyone who wants coverage beyond astrology. Much larger
+        (a few MB inlined per document) — turn it up to 11 only when you need it.
+    """
+    if not embed:
+        return ""
+    if fontset == "astroset":
+        faces = [_face(fam, b64)
+                 for fam, b64 in zip(SYMBOL_FAMILY_NAMES, SYMBOLS_WOFF2_B64, strict=True)]
+        faces.append(_face(TEXT_FAMILY_NAME, TEXT_WOFF2_B64, weight=True))
+    elif fontset == "fullset":
+        faces = [_face(fam, _fullset_b64(fam)) for fam in SYMBOL_FAMILY_NAMES]
+        faces.append(_face(TEXT_FAMILY_NAME, _fullset_b64(TEXT_FAMILY_NAME), weight=True))
+    else:
+        raise ValueError("fontset must be 'astroset' or 'fullset', not %r" % fontset)
+    return "<style>" + "".join(faces) + "</style>"
+
+
+def glyph_metrics(ch):
+    """Metrics for a glyph as ``(advance, ymin, ymax, xmin, xmax)`` in fractions of the em
+    (ink bounding box from the outline), or ``None`` if the glyph isn't in the inventory.
+
+    ``ch`` may be a single-character string or an int codepoint.
+    """
+    cp = ord(ch) if isinstance(ch, str) else int(ch)
+    return GLYPH_METRICS.get(cp)