@heroiclands/fonts 0.1.2 → 0.1.3

package/README.md

@@ -14,18 +14,19 @@ Qalezu, the Khelathi alphabet, is written right to left on code points of its ow
 
 Every script draws on a block of code points of its own, and every face of a script draws its script's block: Pirzath Carved, Pirzath Hand and Pirzath Hand Lifted share the Pirzath block, so changing the face changes only the look. The blocks are registered in `BLOCKS` in `tools/codepoint_order.py`; `tools/codepoints.py` checks that every face's code points lie in its registered blocks, that no two blocks overlap, and that this table is the registry's.
 
-| Range             | Use                                                                                             | Direction     |
-| ----------------- | ----------------------------------------------------------------------------------------------- | ------------- |
-| U+1E960–U+1E9FF   | Khelathi Zethu Glyphs, overflow beyond its main block                                           | right to left |
-| U+1EA00–U+1EA3F   | Qalezu: signs, digits and punctuation                                                           | right to left |
-| U+1EA40–U+1EC6F   | Khelathi Zethu Glyphs                                                                           | right to left |
-| U+1ECC0–U+1ECFF   | Qalezu: a sign with a catch before it                                                           | right to left |
-| U+F0000–U+F00FF   | Pirzath                                                                                         | left to right |
-| U+F0100–U+F01FF   | Thuravark                                                                                       | left to right |
-| U+F0200–U+F02FF   | Semaron                                                                                         | left to right |
-| U+F0300–U+F0FFF   | Reserved for the remaining alphabets and syllabaries, 256 code points each as they are assigned | left to right |
-| U+F1000–U+F2FFF   | Reserved for Teng Chou                                                                          | left to right |
-| U+100000–U+10FFFD | Plane 16, unassigned                                                                            | –             |
+| Range             | Use                                                                                                       | Direction     |
+| ----------------- | --------------------------------------------------------------------------------------------------------- | ------------- |
+| U+13430–U+1343F   | Egyptian Hieroglyph Format Controls, Unicode's own: Khelathi Zethu Glyphs' quadrat and cartouche controls | left to right |
+| U+1E960–U+1E9FF   | Khelathi Zethu Glyphs, overflow beyond its main block                                                     | right to left |
+| U+1EA00–U+1EA3F   | Qalezu: signs, digits and punctuation                                                                     | right to left |
+| U+1EA40–U+1EC6F   | Khelathi Zethu Glyphs: signs, and its format controls at U+1EC60–U+1EC6F                                  | right to left |
+| U+1ECC0–U+1ECFF   | Qalezu: a sign with a catch before it                                                                     | right to left |
+| U+F0000–U+F00FF   | Pirzath                                                                                                   | left to right |
+| U+F0100–U+F01FF   | Thuravark                                                                                                 | left to right |
+| U+F0200–U+F02FF   | Semaron                                                                                                   | left to right |
+| U+F0300–U+F0FFF   | Reserved for the remaining alphabets and syllabaries, 256 code points each as they are assigned           | left to right |
+| U+F1000–U+F2FFF   | Reserved for Teng Chou                                                                                    | left to right |
+| U+100000–U+10FFFD | Plane 16, unassigned                                                                                      | –             |
 
 - **Left-to-right scripts** (Pirzath, Thuravark, Semaron) sit in plane 15, the Supplementary Private Use Area-A, whose characters are left to right by default. Each takes 256 code points. U+F0300 to U+F0FFF is reserved for the remaining alphabets and syllabaries, 256 code points each as they are assigned, and U+F1000 to U+F2FFF for Teng Chou.
 - **Right-to-left scripts** (Qalezu and Khelathi Zethu Glyphs) sit in unassigned code points of plane 1 whose default bidi class is right to left. That is why their text runs right to left in any editor, browser or typesetter, mixed with English and with no controls. Because the code points are unassigned rather than private, Unicode could in principle assign them to a script later. Qalezu takes U+1EA00 to U+1EA3F for its signs, digits and punctuation and U+1ECC0 to U+1ECFF for a sign with a catch before it. Khelathi Zethu Glyphs takes U+1EA40 to U+1EC6F with U+1E960 to U+1E9FF as overflow, 720 code points together. U+1ED50 to U+1EDFF is the remaining free right-to-left range, kept for a further right-to-left script.
@@ -37,7 +38,7 @@ The fonts are licensed under the SIL Open Font License 1.1; see `LICENSE`. Under
 
 ## Installing and using the fonts
 
-The fonts are published to npm as `@heroiclands/fonts`. The package holds each font as WOFF2 and TrueType, `fonts.css` with one `@font-face` rule and one `hl-<font>` class per family, `fonts.json`, the manifest of the families, and `keyboards/`, the keyboard layouts, Emacs input methods and cheatsheets for typing in them.
+The fonts are published to npm as `@heroiclands/fonts`. The package holds each font as WOFF2 and TrueType, `fonts.css` with one `@font-face` rule and one `hl-<font>` class per family, `fonts.json`, the manifest of the families, `keyboards/`, the keyboard layouts, Emacs input methods and cheatsheets for typing in them, and `charts/`, the cheatsheet of each font.
 
 ```sh
 npm install @heroiclands/fonts
@@ -70,7 +71,7 @@ CONFIG.fontDefinitions["Pirzath Carved"] = {
 typst compile --font-path node_modules/@heroiclands/fonts/fonts book.typ
 ```
 
-`fonts.json` states, for each entry, its `name` (unique across the manifest), its `family` (the font-family), its `hl-<font>` class, its `files`, its `direction`, its OpenType `features` and its `codepoints`: every character the font draws, each with its code point, glyph name, kind and the key that types it. The class sets the family's `font-family`, `font-feature-settings` and, for a right-to-left family, `direction`. Pirzath Hand's joined form needs `ss01`, which its class turns on; Pirzath Hand Lifted is the same font with `ss01` turned off.
+`fonts.json` states, for each entry, its `name` (unique across the manifest), its `family` (the font-family), its `hl-<font>` class, its `files`, its `direction`, its OpenType `features` and its `codepoints`: every character the font draws, each with its code point, character name where the script's name table gives one, glyph name and kind, and for a sign of Khelathi Zethu Glyphs the sign id that types it; that font's format controls are of kind `control`. The class sets the family's `font-family`, `font-feature-settings` and, for a right-to-left family, `direction`. Pirzath Hand's joined form needs `ss01`, which its class turns on; Pirzath Hand Lifted is the same font with `ss01` turned off.
 
 A note's text in one of these fonts is the font's own code points. They are typed with the keyboard layouts in `keyboards/`, or produced by a mapping in the consuming build.
 
@@ -78,14 +79,39 @@ The fonts are licensed under the SIL Open Font License 1.1, which `LICENSE` carr
 
 ## Typing in the fonts
 
-A note records Unicode characters, so typing in a family's fonts needs a keyboard layout that produces its code points. Each family has one, and the faces of a family share their code points, so one layout types for every face: the three Pirzath faces share the Pirzath layout. The layouts come from the `key` of each row of `fonts.json`'s `codepoints` tables, and `keyboards/` carries them:
+A note records Unicode characters, so typing in these fonts needs a keyboard layout that produces their code points. HL Semaron, HL Pirzath, HL Thuravark and HL Qalezu type by sound: every sound of thalorna's spelling guide, _Pronouncing Thalorna_, sits on one key or chord, and that key is the same in every layout. Each layout types its script's own characters for the sound, exactly as the script's mapping note spells it, so one key may type several code points: in HL Semaron, `a` types U+F0230, Shift+A U+F0200, Option+T (_th_) U+F0250 and Option+C (_ch_) U+F0241 U+F0240 U+F0236. A key whose sound the script does not write types nothing in that layout, and no key types a roman letter, except the keys of markup described below. A script's faces share its code points, so the Pirzath layout types Pirzath Carved, Pirzath Hand and Pirzath Hand Lifted alike.
 
-- **macOS layouts.** `keyboards/macos/HeroicLands.bundle` holds one layout for Semaron, Pirzath, Thuravark and Qalezu: HL Semaron, HL Pirzath, HL Thuravark and HL Qalezu. Copy the bundle to `~/Library/Keyboard Layouts/`, log out and back in, then add each layout under System Settings → Keyboard → Text Input → Input Sources, where the layouts appear under the language English. Letters sit on their roman keys and numerals on the digit row; Shift types capitals or digraph letters, and Option types what is left: Semaron's `th` and long vowels, Pirzath's numerals ten to fifteen and the length mark, Qalezu's doubled signs and the signs after a catch.
-- **Windows layouts.** `keyboards/windows/<family>.klc` is the Microsoft Keyboard Layout Creator source of HL Semaron, HL Pirzath, HL Thuravark and HL Qalezu, saved as UTF-16 with a byte order mark. Option is the right Alt key (AltGr). A character of plane 15 is a ligature entry holding its surrogate pair, which Windows delivers as one character. MSKLC builds the installer on Windows only: open the `.klc` in Microsoft Keyboard Layout Creator, choose Project, Build DLL and Setup Package, and run the `setup.exe` it writes. Then add the layout under Settings, Time & language, Language & region, English (United States), Keyboard.
-- **Linux layouts.** `keyboards/linux/hl_<family>` is an XKB symbols file for each of the four families, with a `U<hex>` keysym for every character. Option is the third level, reached with the right Alt key. Copy the files to `~/.config/xkb/symbols/`, then run `setxkbmap -I$HOME/.config/xkb -layout hl_pirzath` under X11; a desktop that reads `~/.config/xkb` lists them as custom layouts. `setxkbmap us` returns to the usual layout.
-- **Emacs input methods.** `keyboards/emacs/heroiclands-<family>.el` defines a Quail input method per family. Put the directory on `load-path`, evaluate `(require 'heroiclands-semaron)`, then `M-x set-input-method RET heroiclands-semaron`. Shift is the shifted character. Emacs has no Option key, so Option+x is typed `\` and then the key x types: Option+E is `\e` and Option+Shift+A is `\A`.
-- **Khelathi Zethu Glyphs.** It has far more signs than a keyboard has keys, so it has an Emacs input method only, typed by sign id: `08-001` inserts that sign.
-- **Cheatsheets.** `keyboards/<family>.md` lists every key beside its Emacs sequence, code point and glyph, and `specimens/<face folder>/keyboard.png` draws each key beside its glyph in every face of the family, Pirzath's three faces side by side.
+[`keyboards/index.md`](keyboards/index.md) is the cheatsheet: a diagram of the shared keys on an ANSI keyboard, the principles of the key map, and a table of every key or chord, its sound and each script's output as glyphs, code points and character names. `keyboards/<script>.md` gives one script's table.
+
+**The key map.** Letters sit on their roman keys and capitals on Shift. A consonant pair sits on Option and its first letter (Option+T _th_, Option+C _ch_), with _ny_ on Option+Y and _ts_ on Option+X. An acute vowel sits on Option and its vowel. The vowel pairs sit on Option and the digit row: the long vowels _aa ee ii oo uu_ on 1 to 5, then _ai au ei oi ou_ on 6 to 0, and _ie uo ae ea_ on `-`, `=`, `[` and `]`. The diaeresis vowels sit on Option and `;`, `'`, `,`, `.` and `/`. The catch is `'`, the stop `.`, the pause `,`, and the open and close quotes Shift+`,` and Shift+`.`, the keys of `<` and `>`; only Pirzath writes quotation marks, so those keys type nothing in the other layouts. Digits sit on the digit row, and Pirzath's numerals ten to fifteen on Shift+2 to Shift+7. A capital is always Shift and its small sound's key: Option+Shift+T is _Th_.
+
+**Markup types itself.** In every layout on every platform, the characters Markdown and a span's `[text]{font=…}` need type themselves, as plain ASCII, at their U.S. positions: `` * _ [ ] { } ( ) = : | \ ~ ` ``. A note's markup is written without switching layouts, and no script draws it. `#` is not among them, because Shift+3 is Pirzath's numeral eleven. In Emacs the backslash key is the prefix of the Option chords, so a backslash is typed twice.
+
+**Where the outputs come from.** `tools/sound_keys.json` puts each sound on its key and states the principles. `keyboards/sounds.json` gives each sound's output in each script; `tools/sounds.mjs` writes it by running each sound's spelling through the four mapping notes on thalorna's `origin/main` (`Lore/Scripts/Semaron_Spelling.md`, `Pirzath_Spelling.md`, `Thuravark_Spelling.md` and `Qalezu_Spelling.md`) with package-build's own mapping rules, the ones a run marked `map=` is set by. A vowel is spelled inside a word, between two _t_'s, and _y_ before an _a_, where it is the glide; so a vowel in Qalezu, which writes consonants only, types nothing. `tools/keyboards.py` writes the layouts from those two files, and the fonts build needs no thalorna checkout:
+
+```sh
+node tools/sounds.mjs --thalorna ~/dev/HeroicLands/thalorna --write
+.venv/bin/python tools/keyboards.py
+```
+
+**What a platform cannot carry.** A Windows layout types at most four UTF-16 code units from one key, the limit Microsoft Keyboard Layout Creator puts on a ligature, so Semaron's _ch_ and _Ch_, three plane-15 characters each, type nothing on Windows. An XKB key types one keysym, so every sound a script writes with more than one code point types nothing on Linux. macOS and Emacs carry every output. The cheatsheet lists each of these keys.
+
+The layouts and input methods are in `keyboards/`:
+
+- **macOS layouts.** `keyboards/macos/HeroicLands.bundle` holds HL Semaron, HL Pirzath, HL Thuravark and HL Qalezu. Copy the bundle to `~/Library/Keyboard Layouts/`, log out and back in, then add each layout under System Settings → Keyboard → Text Input → Input Sources, where the layouts appear under the language English. Command and Control chords type the US keys, so shortcuts keep working.
+- **Windows layouts.** `keyboards/windows/<script>.klc` is the Microsoft Keyboard Layout Creator source of each layout, saved as UTF-16 with a byte order mark. Option is the right Alt key (AltGr). Every output is a ligature entry, a character of plane 1 or plane 15 written as its surrogate pair. MSKLC builds the installer on Windows only: open the `.klc` in Microsoft Keyboard Layout Creator, choose Project, Build DLL and Setup Package, and run the `setup.exe` it writes. Then add the layout under Settings, Time & language, Language & region, English (United States), Keyboard.
+- **Linux layouts.** `keyboards/linux/hl_<script>` is an XKB symbols file for each layout, with a `U<hex>` keysym on every key that types one character and `VoidSymbol` on the rest. Option is the third level, reached with the right Alt key. Copy the files to `~/.config/xkb/symbols/`, then run `setxkbmap -I$HOME/.config/xkb -layout hl_pirzath` under X11; a desktop that reads `~/.config/xkb` lists them as custom layouts. `setxkbmap us` returns to the usual layout.
+- **Emacs input methods.** `keyboards/emacs/heroiclands-<script>.el` defines a Quail input method per layout. Put the directory on `load-path`, evaluate `(require 'heroiclands-semaron)`, then `M-x set-input-method RET heroiclands-semaron`. Shift is the shifted character. Emacs has no Option key, so Option+x is typed `\` and then the key x types: Option+T is `\t` and Option+Shift+T is `\T`.
+- **Khelathi Zethu Glyphs.** Zethu writes meanings, not sounds, and has far more signs than a keyboard has keys, so it has an Emacs input method only, `heroiclands-zethu`, typed by sign id: `08-001` inserts that sign. `keyboards/zethu.md` lists the ids. The format controls have no key: a mapping in the consuming build writes them.
+
+## Cheatsheets
+
+Each font has a cheatsheet of every character it draws, in `charts/`; [`charts/index.md`](charts/index.md) links them all. A sheet holds two views:
+
+- **A code chart**, laid out like Unicode's charts: columns headed by the code point without its last hex digit, rows `0` to `F`, each cell holding the glyph above its code point, and a code point the font does not draw hatched. The grid runs left to right in every font. A long range is split into pages of eight columns, and a column with no character is left out.
+- **A table** of Character Name, Character, Code Point (`U+05DC`), Entity (`&#1500;`) and Hex Entity (`&#x05DC;`), in code point order and grouped by kind.
+
+The glyphs are outlines taken from the font, so a sheet reads without the font installed: `charts/<face folder>/chart-<n>.svg` and `.png` are the chart pages, `charts/<face folder>/glyphs/U+XXXX.svg` is one glyph for the table, and `charts/<face folder>.md` embeds both. Pirzath Hand Lifted is drawn with `ss01` off. Character names are Unicode-style (uppercase ASCII letters, digits, spaces and hyphens) and come from `tools/names/<script>.json`, one JSON object per script of `"U+XXXX": "NAME"` pairs, which `tools/write_css.py` writes into `fonts.json`. A script without that file has no names, and its table shows an empty Character Name cell. Khelathi Zethu Glyphs names a sign `ZETHU CHARACTER <n>`, where n is its code point's position in the font's code point space: U+1EA40 is `ZETHU CHARACTER 001`, and the overflow block U+1E960 to U+1E9FF continues after the main block. A format control takes Unicode's name at its Unicode code point, `EGYPTIAN HIEROGLYPH VERTICAL JOINER`, and the font's own at its twin, `ZETHU VERTICAL JOINER`. `tools/zethu_names.py` writes `tools/names/zethu.json`, so drawing a sign renames no other.
 
 ## Setting up
 
@@ -102,7 +128,7 @@ python3 -m venv .venv
 .venv/bin/pip install -r requirements.txt
 ```
 
-The source of each font is a UFO under `sources/`: `PirzathCarved.ufo`, `PirzathHand.ufo`, `ThuravarkCarved.ufo`, `QalezuHand.ufo`, `KhelathiZethuGlyphs.ufo` and `SemaronKuriale.ufo`. Open one in FontForge, Glyphs or RoboFont to edit it. The UFO carries the outlines, the character map, the metrics and `features.fea`, which holds every OpenType feature.
+The source of each font is a UFO under `sources/`: `PirzathCarved.ufo`, `PirzathHand.ufo`, `ThuravarkCarved.ufo`, `QalezuHand.ufo`, `KhelathiZethuGlyphs.ufo` and `SemaronKuriale.ufo`. Open one in FontForge, Glyphs or RoboFont to edit it. The UFO carries the outlines, the character map, the metrics and `features.fea`, which holds every OpenType feature. Every glyph's advance is its ink width plus one sidebearing a side, the same across its face; `tools/respace.py` sets a UFO to that rule, and `design/making-fonts.md` gives each face's sidebearing.
 
 Build the fonts into `fonts/`. The build is reproducible, so the committed fonts match a fresh build byte for byte:
 
@@ -110,7 +136,7 @@ Build the fonts into `fonts/`. The build is reproducible, so the committed fonts
 PATH=.venv/bin:$PATH ./build.sh
 ```
 
-`build.sh` runs `fontmake` and compresses the `.woff2`, once per font (`PirzathCarved` shown), then runs `tools/write_css.py`, which writes `fonts.css` and `fonts.json` from the built fonts' name tables and one table of per-family facts. `tools/keyboards.py` then writes `keyboards/` and each family's `specimens/<face folder>/keyboard.png` from `fonts.json`; `tools/keyboard_keys.py` is the one place that assigns a key to each character:
+`build.sh` runs `fontmake` and compresses the `.woff2`, once per font (`PirzathCarved` shown), adding Khelathi Zethu Glyphs' quadrat layout between the two with `tools/khelathi-zethu-glyphs/layout.py`, then runs `tools/write_css.py`, which writes `fonts.css` and `fonts.json` from the built fonts' name tables and one table of per-family facts. `tools/keyboards.py` then writes `keyboards/` from `tools/sound_keys.json` and `keyboards/sounds.json` (see [Typing in the fonts](#typing-in-the-fonts)). `tools/charts.py` last writes `charts/` from `fonts.json` and the built fonts, and rasterizes the chart pages with `resvg-py`, pinned in `requirements.txt`:
 
 ```sh
 export SOURCE_DATE_EPOCH=1767225600
@@ -137,15 +163,19 @@ Check the built fonts, render the specimens, and prove that each guard fails a b
 .venv/bin/python tools/semaron-kuriale/check_font.py
 .venv/bin/python tools/notdef_box.py
 .venv/bin/python tools/vertical.py
+.venv/bin/python tools/spacing.py                 # every face is set at a natural spacing; --report prints the measures
 .venv/bin/python tools/font_names.py
 .venv/bin/python tools/codepoints.py
-.venv/bin/python tools/keyboards_guard.py --fixtures-only   # the layouts type every character
+.venv/bin/python tools/keyboards_guard.py --fixtures-only   # the layouts type each sound's output, and nothing else
+.venv/bin/python tools/charts_guard.py            # every character is on its sheet; unnamed rows are listed
+.venv/bin/python tools/khelathi-zethu-glyphs/quadrats.py   # quadrats and cartouches land where the layout puts them
 .venv/bin/python tools/codepoints_chart.py         # specimens/<face>/codepoints.png
 .venv/bin/python tools/pirzath/specimens.py       # specimens/pirzath/
 .venv/bin/python tools/pirzath-hand/specimens.py  # specimens/pirzath-hand/
 .venv/bin/python tools/thuravark-carved/specimens.py     # specimens/thuravark-carved/
 .venv/bin/python tools/qalezu-hand/specimens.py        # specimens/qalezu-hand/
 .venv/bin/python tools/khelathi-zethu-glyphs/specimens.py         # specimens/khelathi-zethu-glyphs/
+.venv/bin/python tools/khelathi-zethu-glyphs/paint_guard.py       # every drawn sign has a paint map
 .venv/bin/python tools/semaron-kuriale/specimens.py     # specimens/semaron-kuriale/
 .venv/bin/python tools/prove_guards.py
 ```
@@ -160,7 +190,7 @@ Each guard shapes every form of its lexicon and asserts the font renders it righ
 .venv/bin/python tools/semaron-kuriale/guard.py --thalorna /path/to/thalorna
 ```
 
-`tools/keyboards_guard.py` also reads the layouts back and asserts that each puts every character of its family on the key `fonts.json` names. Without `--fixtures-only` it shapes every lexicon form of the families above with the fonts' Latin typing rules, maps each glyph to its code point, and asserts that the family's layout has a key for it; it reads thalorna the same way, through `--thalorna`. Qalezu's forms go through its converter first, and Khelathi Zethu Glyphs is checked on the sign ids of its sample inscriptions.
+`tools/keyboards_guard.py` checks the key map (no key or chord carries two sounds, every sound has a key, a capital sits on Shift and its small sound's key) and reads every layout and input method back: each key must type exactly the code points `keyboards/sounds.json` gives its sound in the script, or nothing where the script does not write the sound or the platform cannot carry it, and no key may type a character below U+0080. Without `--fixtures-only` it also writes `keyboards/sounds.json` afresh from thalorna's mapping notes, through `tools/sounds.mjs` under `node`, and fails where the committed file differs.
 
 ```sh
 .venv/bin/python tools/keyboards_guard.py --thalorna /path/to/thalorna
@@ -174,4 +204,23 @@ Khelathi Zethu Glyphs is the temple hieroglyphs of the Khelathi, on U+1EA40 to U
 .venv/bin/python tools/khelathi-zethu-glyphs/guard.py
 ```
 
+Every drawn Zethu sign has a paint map in `tools/khelathi-zethu-glyphs/paint.json`: each enclosed region of the sign, named by a seed point in glyph units, and its colour category, such as `skin-male`, `linen` or `water`, so a banner, a stele or the book paints the sign the conventional way. `tools/khelathi-zethu-glyphs/paint.py` finds the regions and writes the painted contact sheets to `specimens/khelathi-zethu-glyphs/paint/`; a renderer imports it to find the same regions. `paint_guard.py` fails when a drawn sign has no map or a seed misses its region:
+
+```sh
+.venv/bin/python tools/khelathi-zethu-glyphs/paint_guard.py
+.venv/bin/python tools/khelathi-zethu-glyphs/paint.py
+```
+
+**Quadrats and cartouches.** Khelathi Zethu Glyphs lays out quadrats and cartouches itself from format controls typed between its signs: the vertical and horizontal joiners, the four corner insertions, begin and end segment, and begin and end enclosure, the cartouche. Each control is mapped at its Unicode code point, U+13430 to U+1343D, and at the same offset from U+1EC60 in the font's own block; `tools/khelathi-zethu-glyphs/controls.json` lists them. Notes and text store the font's own controls, U+1EC60 to U+1EC6D, the recommended form. The font accepts the Unicode controls so that text pasted from standard Egyptian text shapes in HarfBuzz tools, but a browser shapes a run of one script at a time and the Unicode controls belong to the Egyptian script, so in a browser they fall out of the run of signs and the quadrat comes apart. In a page, text in the font needs no markup and no feature turned on:
+
+```html
+<span class="hl-khelathi-zethu-glyphs">&#x1EA41;&#x1EC60;&#x1EA42;</span>
+```
+
+sets sign 01-002 over sign 01-003. `build.sh` adds the layout to the built font with `tools/khelathi-zethu-glyphs/layout.py`, and `tools/khelathi-zethu-glyphs/quadrats.py` shapes the fixtures of `quadrats.json`, the samples written with joiners, runs of quadrats and a seeded sweep of random ones, and asserts where every sign lands. The layout works in a horizontal line; a column is laid out by the page. `design/khelathi-zethu-glyphs.md` gives the controls, the layout and its limits, and `specimens/khelathi-zethu-glyphs/quadrats/` shows them.
+
+```sh
+.venv/bin/python tools/khelathi-zethu-glyphs/quadrats.py
+```
+
 See `design/khelathi-zethu-glyphs.md`.

package/charts/index.md

@@ -0,0 +1,11 @@
+# Cheatsheets
+
+Each font has a sheet of every character it draws: a code chart laid out like Unicode's, and a table of each character's name, glyph and code point.
+
+- [Khelathi Zethu Glyphs](khelathi-zethu-glyphs.md): 364 characters on 6 chart pages
+- [Pirzath Carved](pirzath.md): 64 characters on 1 chart page
+- [Pirzath Hand](pirzath-hand.md): 64 characters on 1 chart page
+- [Pirzath Hand Lifted](pirzath-hand-lifted.md): 64 characters on 1 chart page
+- [Qalezu Hand](qalezu-hand.md): 101 characters on 2 chart pages
+- [Semaron Kuriale](semaron-kuriale.md): 70 characters on 1 chart page
+- [Thuravark Carved](thuravark-carved.md): 40 characters on 1 chart page

package/charts/khelathi-zethu-glyphs/chart-1.svg

@@ -0,0 +1,104 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="380" height="1786" viewBox="0 0 380 1786">
+<title>Khelathi Zethu Glyphs U+13430–U+1343F, page 1 of 6</title>
+<defs>
+<pattern id="hatch" width="7" height="7" patternUnits="userSpaceOnUse" patternTransform="rotate(45)"><line x1="0" y1="0" x2="0" y2="7" stroke="#8d877e" stroke-width="1"/></pattern>
+</defs>
+<rect width="380" height="1786" fill="#ffffff"/>
+<text x="16" y="38" font-family="Helvetica, Arial, sans-serif" font-size="22" fill="#161412">Khelathi Zethu Glyphs</text>
+<text x="16" y="60" font-family="Helvetica, Arial, sans-serif" font-size="14" fill="#6b665f">U+13430–U+1343F, page 1 of 6</text>
+<text x="94.0" y="96" text-anchor="middle" font-family="Helvetica, Arial, sans-serif" font-size="15" font-weight="bold" fill="#161412">1343</text>
+<text x="40" y="163.0" text-anchor="end" font-family="Helvetica, Arial, sans-serif" font-size="15" font-weight="bold" fill="#161412">0</text>
+<text x="40" y="267.0" text-anchor="end" font-family="Helvetica, Arial, sans-serif" font-size="15" font-weight="bold" fill="#161412">1</text>
+<text x="40" y="371.0" text-anchor="end" font-family="Helvetica, Arial, sans-serif" font-size="15" font-weight="bold" fill="#161412">2</text>
+<text x="40" y="475.0" text-anchor="end" font-family="Helvetica, Arial, sans-serif" font-size="15" font-weight="bold" fill="#161412">3</text>
+<text x="40" y="579.0" text-anchor="end" font-family="Helvetica, Arial, sans-serif" font-size="15" font-weight="bold" fill="#161412">4</text>
+<text x="40" y="683.0" text-anchor="end" font-family="Helvetica, Arial, sans-serif" font-size="15" font-weight="bold" fill="#161412">5</text>
+<text x="40" y="787.0" text-anchor="end" font-family="Helvetica, Arial, sans-serif" font-size="15" font-weight="bold" fill="#161412">6</text>
+<text x="40" y="891.0" text-anchor="end" font-family="Helvetica, Arial, sans-serif" font-size="15" font-weight="bold" fill="#161412">7</text>
+<text x="40" y="995.0" text-anchor="end" font-family="Helvetica, Arial, sans-serif" font-size="15" font-weight="bold" fill="#161412">8</text>
+<text x="40" y="1099.0" text-anchor="end" font-family="Helvetica, Arial, sans-serif" font-size="15" font-weight="bold" fill="#161412">9</text>
+<text x="40" y="1203.0" text-anchor="end" font-family="Helvetica, Arial, sans-serif" font-size="15" font-weight="bold" fill="#161412">A</text>
+<text x="40" y="1307.0" text-anchor="end" font-family="Helvetica, Arial, sans-serif" font-size="15" font-weight="bold" fill="#161412">B</text>
+<text x="40" y="1411.0" text-anchor="end" font-family="Helvetica, Arial, sans-serif" font-size="15" font-weight="bold" fill="#161412">C</text>
+<text x="40" y="1515.0" text-anchor="end" font-family="Helvetica, Arial, sans-serif" font-size="15" font-weight="bold" fill="#161412">D</text>
+<text x="40" y="1619.0" text-anchor="end" font-family="Helvetica, Arial, sans-serif" font-size="15" font-weight="bold" fill="#161412">E</text>
+<text x="40" y="1723.0" text-anchor="end" font-family="Helvetica, Arial, sans-serif" font-size="15" font-weight="bold" fill="#161412">F</text>
+<g class="drawn" id="cp-13430" transform="translate(50 106)">
+<title>EGYPTIAN HIEROGLYPH VERTICAL JOINER U+13430</title>
+<g fill="#161412"></g>
+<text x="44.0" y="95" text-anchor="middle" font-family="Helvetica, Arial, sans-serif" font-size="12" fill="#6b665f">13430</text>
+</g>
+<g class="drawn" id="cp-13431" transform="translate(50 210)">
+<title>EGYPTIAN HIEROGLYPH HORIZONTAL JOINER U+13431</title>
+<g fill="#161412"></g>
+<text x="44.0" y="95" text-anchor="middle" font-family="Helvetica, Arial, sans-serif" font-size="12" fill="#6b665f">13431</text>
+</g>
+<g class="drawn" id="cp-13432" transform="translate(50 314)">
+<title>EGYPTIAN HIEROGLYPH INSERT AT TOP START U+13432</title>
+<g fill="#161412"></g>
+<text x="44.0" y="95" text-anchor="middle" font-family="Helvetica, Arial, sans-serif" font-size="12" fill="#6b665f">13432</text>
+</g>
+<g class="drawn" id="cp-13433" transform="translate(50 418)">
+<title>EGYPTIAN HIEROGLYPH INSERT AT BOTTOM START U+13433</title>
+<g fill="#161412"></g>
+<text x="44.0" y="95" text-anchor="middle" font-family="Helvetica, Arial, sans-serif" font-size="12" fill="#6b665f">13433</text>
+</g>
+<g class="drawn" id="cp-13434" transform="translate(50 522)">
+<title>EGYPTIAN HIEROGLYPH INSERT AT TOP END U+13434</title>
+<g fill="#161412"></g>
+<text x="44.0" y="95" text-anchor="middle" font-family="Helvetica, Arial, sans-serif" font-size="12" fill="#6b665f">13434</text>
+</g>
+<g class="drawn" id="cp-13435" transform="translate(50 626)">
+<title>EGYPTIAN HIEROGLYPH INSERT AT BOTTOM END U+13435</title>
+<g fill="#161412"></g>
+<text x="44.0" y="95" text-anchor="middle" font-family="Helvetica, Arial, sans-serif" font-size="12" fill="#6b665f">13435</text>
+</g>
+<rect class="undrawn" x="50" y="730" width="88" height="104" fill="url(#hatch)"/>
+<g class="drawn" id="cp-13437" transform="translate(50 834)">
+<title>EGYPTIAN HIEROGLYPH BEGIN SEGMENT U+13437</title>
+<g fill="#161412"></g>
+<text x="44.0" y="95" text-anchor="middle" font-family="Helvetica, Arial, sans-serif" font-size="12" fill="#6b665f">13437</text>
+</g>
+<g class="drawn" id="cp-13438" transform="translate(50 938)">
+<title>EGYPTIAN HIEROGLYPH END SEGMENT U+13438</title>
+<g fill="#161412"></g>
+<text x="44.0" y="95" text-anchor="middle" font-family="Helvetica, Arial, sans-serif" font-size="12" fill="#6b665f">13438</text>
+</g>
+<rect class="undrawn" x="50" y="1042" width="88" height="104" fill="url(#hatch)"/>
+<rect class="undrawn" x="50" y="1146" width="88" height="104" fill="url(#hatch)"/>
+<rect class="undrawn" x="50" y="1250" width="88" height="104" fill="url(#hatch)"/>
+<g class="drawn" id="cp-1343C" transform="translate(50 1354)">
+<title>EGYPTIAN HIEROGLYPH BEGIN ENCLOSURE U+1343C</title>
+<g fill="#161412"><path transform="translate(37.01 56.85) scale(0.05200 -0.05200)" d="M0 812H8L21 824L13 825L0 826L1 838L14 837L28 836V835L42 832L55 828H56L69 823L82 816L95 808L107 800L108 799L120 790V789L131 779H132L143 767L154 754L165 741V740L175 726L185 711V710L194 695V694L203 678V677L211 660L219 642L227 623L233 603L240 583L245 563V562L250 542L251 541L255 520L259 498L262 476L265 454L267 431L269 408L270 385V363V362V340L269 317L267 294L265 271L262 249L259 227L255 205L251 184L250 183L245 163V162L240 142L233 122L227 102L219 83L211 65L203 48V47L194 31V30L185 15V14L175 -1L165 -15V-16L154 -29L143 -42L132 -54H131L120 -64V-65L108 -74L107 -75L95 -83L82 -91L69 -98L56 -103H55L42 -107L28 -110V-111L14 -112L1 -113L0 -101L11 -100L20 -85L12 -86H11L0 -87L-1 -75H11L21 -73L32 -71L43 -67L53 -63L64 -58L74 -51L85 -44L95 -36L105 -26L115 -16L125 -5L134 7L143 20L152 34L161 49L169 64L177 81L184 98L191 115L197 134L203 153L209 172L213 192L218 212L222 233L225 254L227 276L229 297L231 319L232 341V362V384L231 406L229 428L227 449L225 471L222 492L218 513L213 533L209 553L203 572L197 591L191 610L184 627L177 644L169 661L161 676L152 691L143 705L134 718L125 730L115 741L105 751L95 761L85 769L74 776L64 783L53 788L43 792L32 796L21 798L11 800H-1ZM244 340 243 332 257 322 258 340V352L244 362ZM243 318 241 296V291L254 279L255 295L256 310L243 320ZM124 749 134 738V737L142 728L159 727L155 733L145 747L140 752L123 750ZM239 274 237 253V252L236 249L248 237L250 251L253 268L240 279ZM233 231 230 210 229 208 241 196 243 207 247 226 234 238ZM244 385V374L258 364V385L257 394L243 404ZM225 189 220 169V168L231 154L234 166L238 184L227 197ZM215 149 209 130 208 128 218 114 222 126 227 143 217 156ZM202 111 195 93 193 89 202 74 208 88 214 103 204 117ZM220 556 224 539 240 532 239 539 234 559 233 562 217 568ZM230 515 233 498 248 490 247 496 243 518V520L227 527ZM92 -54 81 -61V-62L70 -68H69V-69L66 -86L76 -80L88 -73L93 -70V-53ZM209 595 214 579 230 573 228 580 222 599 221 602 204 607ZM171 682 180 666 184 657 201 653 200 655 192 672 188 681 171 683ZM237 473V472L239 457L254 448L253 452L250 474V479L234 487ZM195 632 200 619 217 614 215 619 208 637 206 642 189 646ZM241 429 242 416 257 406V408L255 430V437L240 445ZM153 712 154 711 163 697 165 693 182 691 175 704 166 718H149ZM163 28 155 16 161 0 165 6 175 21 177 26 170 41ZM188 76 180 59 176 52 183 36H184L192 53L197 64L189 78ZM103 770 113 760H114L115 758L132 761L123 770L112 780L110 782L93 778ZM114 -35H113L103 -45L102 -46L103 -63L112 -55L123 -45L126 -43L123 -25ZM47 -79H46L35 -82L33 -83L23 -99H26L39 -96L51 -92L55 -90L58 -74ZM144 0 134 -12V-13L131 -16L134 -34L145 -22L154 -10L148 6ZM69 793H70L81 787V786L83 785L101 790H100L88 798L76 805L74 806L59 799ZM21 810H23H24L35 807L46 804H47L63 812L51 817L39 821L33 822Z"/></g>
+<text x="44.0" y="95" text-anchor="middle" font-family="Helvetica, Arial, sans-serif" font-size="12" fill="#6b665f">1343C</text>
+</g>
+<g class="drawn" id="cp-1343D" transform="translate(50 1458)">
+<title>EGYPTIAN HIEROGLYPH END ENCLOSURE U+1343D</title>
+<g fill="#161412"><path transform="translate(30.82 56.85) scale(0.05200 -0.05200)" d="M414 -112H413L400 -111L399 -110L386 -107L372 -103L359 -98H358L346 -91H345L333 -83H332L320 -75V-74L308 -65V-64L296 -54L285 -42H284L274 -29H273L263 -16V-15L253 -1H252L243 14V15L233 30V31L225 47L224 48L216 65L208 83L201 102L194 122L188 142L182 162V163L177 183V184L173 205L169 227L165 249L162 271L160 294L159 317L158 327L156 328L154 330L128 318L80 284L76 281L71 279L66 278L61 279L56 281L52 284L49 288L47 292L46 298L47 303L49 307L52 311L56 314L58 315L108 350H109L133 362L109 375H108L58 410L56 411L52 414L49 418L47 422L46 428L47 433L49 437L52 441L56 444L61 446L66 447L71 446L76 444L80 441L128 407L154 395L156 397L158 398L159 408L160 431L162 454L165 476L169 498L173 520L177 541V542L182 562V563L188 583L194 603L201 623L208 642L216 660L224 677L225 678L233 694V695L243 710V711L252 726H253L263 740V741L273 754H274L284 767H285L296 779L308 789V790L320 799V800L332 808H333L345 816H346L358 823H359L372 828L386 832L399 835L400 836L413 837H414L427 838H454V834L461 829L449 812H454V800H428H417L406 798L396 796L385 792L374 788L364 783L353 776L343 769L333 761L322 751L312 741L303 730L293 718L284 705L275 691L267 676L259 661L251 644L244 627L237 610L230 591L224 572L219 553L214 533L210 513L206 492L203 471L200 449L198 428L197 406L196 397L205 391L211 382L215 373L216 362L215 352L211 342L205 334L196 328L197 319L198 297L200 276L203 254L206 233L210 212L214 192L219 172L224 153L230 134L237 115L244 98L251 81L259 64L267 49L275 34L284 20L293 7L303 -5L312 -16L322 -26L333 -36L343 -44L353 -51L364 -58L374 -63L385 -67L396 -71L406 -73L417 -75H428H454V-79L461 -84L449 -101H454V-113H427ZM347 786V787L358 793L361 794L362 811L351 805L339 798L334 795L336 779ZM381 804 392 807H393L397 808L405 824H402L389 821L376 817L372 815L371 799ZM294 -13 293 -12 285 -1 268 -2 272 -8 283 -22 287 -27 303 -24ZM325 -45 314 -35 311 -32 295 -35 304 -45 316 -55 318 -57 333 -52ZM314 760 325 770 327 772 325 788 316 780 304 770 302 768 306 751ZM248 59 243 69 226 73 227 70 235 53 240 44 256 43ZM274 13V14L265 28L262 33L245 34L253 21L261 8H278ZM185 406V407L186 429L187 436L174 446L172 430L171 416ZM265 697 273 710 267 726 262 719 253 704 250 700 258 685ZM225 614 232 632 235 637 226 651 219 637 214 623 224 609ZM404 -85 393 -82H392L381 -79L379 -78L364 -87L376 -92L389 -96L395 -97L405 -85ZM188 451 191 472V473L192 477L179 488L177 474L175 458L188 447ZM213 576 219 595 220 598 210 612 206 599 200 582 211 570ZM194 494 198 515 199 518 187 530 184 518 181 500 193 488ZM202 536 207 556 208 558 197 571 194 559 189 541 201 529ZM219 130 214 147 197 153 199 145 206 126V123L223 119ZM232 93 227 108 210 112 212 106 219 88 221 83 238 80ZM207 169 203 187 187 194 189 186 194 166V164L210 158ZM240 649 248 666 252 674 244 690V689L235 672L230 662L239 648ZM198 210 195 228 179 235 180 229 184 207 185 205 200 199ZM191 252V253L189 269L174 277V273L177 251L178 247L193 240ZM358 -68 347 -62V-61L343 -59L327 -64V-65L339 -73L351 -80L354 -82L368 -73ZM186 296 185 311 171 320V317L172 295L173 289L188 281ZM417 -87 406 -99 415 -100 427 -101H437L447 -87H428H427ZM284 725 293 737 294 738 298 742 294 759H293L283 747L274 735L280 720ZM123 397H122H121L98 414L82 408L108 390ZM114 340 90 323V306L114 323L116 340ZM437 812 447 826H427L416 825L409 811H416L427 812H428ZM142 342 138 352 126 345 124 329 144 339ZM142 382 144 386 134 391 117 384 138 373ZM85 423V422L83 418L89 420ZM77 314 80 311 81 310V316ZM171 404 170 402H173ZM184 324 183 323 185 322Z"/></g>
+<text x="44.0" y="95" text-anchor="middle" font-family="Helvetica, Arial, sans-serif" font-size="12" fill="#6b665f">1343D</text>
+</g>
+<rect class="undrawn" x="50" y="1562" width="88" height="104" fill="url(#hatch)"/>
+<rect class="undrawn" x="50" y="1666" width="88" height="104" fill="url(#hatch)"/>
+<line x1="50" y1="106" x2="50" y2="1770" stroke="#7a756d" stroke-width="1"/>
+<line x1="138" y1="106" x2="138" y2="1770" stroke="#7a756d" stroke-width="1"/>
+<line x1="50" y1="106" x2="138" y2="106" stroke="#7a756d" stroke-width="1"/>
+<line x1="50" y1="210" x2="138" y2="210" stroke="#7a756d" stroke-width="1"/>
+<line x1="50" y1="314" x2="138" y2="314" stroke="#7a756d" stroke-width="1"/>
+<line x1="50" y1="418" x2="138" y2="418" stroke="#7a756d" stroke-width="1"/>
+<line x1="50" y1="522" x2="138" y2="522" stroke="#7a756d" stroke-width="1"/>
+<line x1="50" y1="626" x2="138" y2="626" stroke="#7a756d" stroke-width="1"/>
+<line x1="50" y1="730" x2="138" y2="730" stroke="#7a756d" stroke-width="1"/>
+<line x1="50" y1="834" x2="138" y2="834" stroke="#7a756d" stroke-width="1"/>
+<line x1="50" y1="938" x2="138" y2="938" stroke="#7a756d" stroke-width="1"/>
+<line x1="50" y1="1042" x2="138" y2="1042" stroke="#7a756d" stroke-width="1"/>
+<line x1="50" y1="1146" x2="138" y2="1146" stroke="#7a756d" stroke-width="1"/>
+<line x1="50" y1="1250" x2="138" y2="1250" stroke="#7a756d" stroke-width="1"/>
+<line x1="50" y1="1354" x2="138" y2="1354" stroke="#7a756d" stroke-width="1"/>
+<line x1="50" y1="1458" x2="138" y2="1458" stroke="#7a756d" stroke-width="1"/>
+<line x1="50" y1="1562" x2="138" y2="1562" stroke="#7a756d" stroke-width="1"/>
+<line x1="50" y1="1666" x2="138" y2="1666" stroke="#7a756d" stroke-width="1"/>
+<line x1="50" y1="1770" x2="138" y2="1770" stroke="#7a756d" stroke-width="1"/>
+<line x1="48.5" y1="106" x2="139.5" y2="106" stroke="#161412" stroke-width="3"/>
+<line x1="50" y1="72" x2="50" y2="1770" stroke="#161412" stroke-width="3"/>
+<line x1="138" y1="72" x2="138" y2="1770" stroke="#161412" stroke-width="3"/>
+</svg>