@morphemeris/armilla-core 0.1.0 → 0.3.0

package/docs/packs.md

@@ -0,0 +1,206 @@
+# Glyph pack reference
+
+Generated from the code by `UPDATE_DOCS=1 cargo test -p armilla-core --test docs`;
+do not edit by hand. Spec §3.8 defines the manifest the core reads; §10.6 the
+fallback rules. Packs key glyphs by the identifiers below — never by Unicode.
+
+A manifest is `{ schema_version: 1, id, version, units: 10, glyphs }` (at most 4096 glyphs); each glyph carries an
+origin-centered `bbox` in pack units, a `variants` map with at least `regular`, and
+a `stroke_only` hint. A pack may cover any subset of the registry: the core falls
+back per glyph to the compiled-in primitive pack and records every fallback in
+the scene's provenance.
+
+## Authoring tiers
+
+| tier | glyphs | meaning |
+| --- | --- | --- |
+| minimal | 52 | A default natal or transit wheel renders with zero fallbacks. |
+| standard | 101 | Adds every aspect, the big-four asteroids, the remaining apsides and derived points, the lots, the derived-point marks, and the kind glyphs — so ids beyond the pack degrade gracefully within its own style. |
+| complete | 147 | Every id in the registry; zero fallbacks anywhere. |
+
+## The registry
+
+Every id the core can emit, by family; the tier column names the first tier
+that includes the id.
+
+### signs (12)
+
+| id | tier |
+| --- | --- |
+| `aries` | minimal |
+| `taurus` | minimal |
+| `gemini` | minimal |
+| `cancer` | minimal |
+| `leo` | minimal |
+| `virgo` | minimal |
+| `libra` | minimal |
+| `scorpio` | minimal |
+| `sagittarius` | minimal |
+| `capricorn` | minimal |
+| `aquarius` | minimal |
+| `pisces` | minimal |
+
+### aspects (20)
+
+| id | tier |
+| --- | --- |
+| `conjunction` | minimal |
+| `opposition` | minimal |
+| `trine` | minimal |
+| `square` | minimal |
+| `sextile` | minimal |
+| `semi_sextile` | standard |
+| `quincunx` | standard |
+| `semi_square` | standard |
+| `sesquiquadrate` | standard |
+| `quintile` | standard |
+| `bi_quintile` | standard |
+| `septile` | standard |
+| `bi_septile` | standard |
+| `tri_septile` | standard |
+| `novile` | standard |
+| `bi_novile` | standard |
+| `quad_novile` | standard |
+| `quindecile` | standard |
+| `parallel` | standard |
+| `contraparallel` | standard |
+
+### marks (7)
+
+| id | tier |
+| --- | --- |
+| `retrograde` | minimal |
+| `direct` | minimal |
+| `stationary` | minimal |
+| `indicator` | minimal |
+| `midpoint` | standard |
+| `antiscion` | standard |
+| `contra_antiscion` | standard |
+
+### phases (4)
+
+| id | tier |
+| --- | --- |
+| `new_moon` | minimal |
+| `full_moon` | minimal |
+| `first_quarter` | minimal |
+| `last_quarter` | minimal |
+
+### events (2)
+
+| id | tier |
+| --- | --- |
+| `occultation` | complete |
+| `lunar_eclipse` | complete |
+
+### kinds (12)
+
+| id | tier |
+| --- | --- |
+| `luminary` | standard |
+| `planet` | standard |
+| `asteroid` | standard |
+| `centaur` | standard |
+| `tno` | standard |
+| `node` | standard |
+| `apsis` | standard |
+| `lot` | standard |
+| `angle` | standard |
+| `fixed_star` | standard |
+| `uranian` | standard |
+| `unknown` | standard |
+
+### bodies (90)
+
+| id | tier |
+| --- | --- |
+| `sun` | minimal |
+| `moon` | minimal |
+| `mercury` | minimal |
+| `venus` | minimal |
+| `earth` | minimal |
+| `mars` | minimal |
+| `jupiter` | minimal |
+| `saturn` | minimal |
+| `uranus` | minimal |
+| `neptune` | minimal |
+| `pluto` | minimal |
+| `ceres` | standard |
+| `pallas` | standard |
+| `juno` | standard |
+| `vesta` | standard |
+| `hygiea` | complete |
+| `astraea` | complete |
+| `eros` | complete |
+| `psyche` | complete |
+| `amor` | complete |
+| `sappho` | complete |
+| `urania` | complete |
+| `chiron` | minimal |
+| `pholus` | complete |
+| `nessus` | complete |
+| `asbolus` | complete |
+| `chariklo` | complete |
+| `eris` | complete |
+| `sedna` | complete |
+| `haumea` | complete |
+| `makemake` | complete |
+| `quaoar` | complete |
+| `orcus` | complete |
+| `ixion` | complete |
+| `varuna` | complete |
+| `gonggong` | complete |
+| `mean_node` | minimal |
+| `true_node` | minimal |
+| `north_node` | minimal |
+| `south_node` | minimal |
+| `mean_south_node` | minimal |
+| `true_south_node` | minimal |
+| `mean_apogee` | minimal |
+| `osculating_apogee` | standard |
+| `interpolated_apogee` | standard |
+| `interpolated_perigee` | standard |
+| `lilith` | minimal |
+| `mean_lilith` | minimal |
+| `true_lilith` | minimal |
+| `black_moon_lilith` | minimal |
+| `priapus` | standard |
+| `ascendant` | minimal |
+| `descendant` | minimal |
+| `midheaven` | minimal |
+| `imum_coeli` | minimal |
+| `vertex` | standard |
+| `antivertex` | standard |
+| `east_point` | standard |
+| `polar_ascendant` | standard |
+| `cupido` | complete |
+| `hades` | complete |
+| `zeus` | complete |
+| `kronos` | complete |
+| `apollon` | complete |
+| `admetos` | complete |
+| `vulkanus` | complete |
+| `poseidon` | complete |
+| `transpluto` | complete |
+| `regulus` | complete |
+| `spica` | complete |
+| `algol` | complete |
+| `aldebaran` | complete |
+| `antares` | complete |
+| `fomalhaut` | complete |
+| `sirius` | complete |
+| `vega` | complete |
+| `arcturus` | complete |
+| `betelgeuse` | complete |
+| `rigel` | complete |
+| `pollux` | complete |
+| `castor` | complete |
+| `procyon` | complete |
+| `alcyone` | complete |
+| `part_of_fortune` | standard |
+| `part_of_spirit` | standard |
+| `part_of_eros` | standard |
+| `part_of_necessity` | standard |
+| `part_of_courage` | standard |
+| `part_of_victory` | standard |
+| `part_of_nemesis` | standard |

package/docs/themes.md

@@ -47,6 +47,18 @@ The predicate language (§9.1) is a conjunction of `key=value` terms and `measur
 comparisons. Keys and closed value sets are listed in the generated
 [vocabulary reference](vocabulary.md).
 
+### Pinning the default
+
+The default theme's content evolves; a theme that says `extends: "default"` (or nothing) rides
+the latest. To freeze the base it was designed against, extend a **versioned base** instead:
+`extends: "default_v3"`. Every historical default ships in `@morphemeris/armilla-core` —
+`defaultTheme(3)` returns the snapshot, `DEFAULT_THEME_VERSION` names the newest — and the host
+supplies it as the chain's first document. Under the hood the current default still sits beneath
+as the implicit root, so marks the pinned era never styled (kinds and roles added since) render
+sensibly instead of unstyled. A pinned theme handed to a host that does not supply its snapshot
+fails with a `REF` error rather than silently rendering against the wrong base. Pinning freezes
+theme content only — layout behavior follows the core version you run.
+
 ## The palette
 
 `$token` in any color-valued property resolves to `palette[token][scheme]` for the environment's

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@morphemeris/armilla-core",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "TypeScript binding for the armilla layout core (WASM): generated types and typed wrappers, no logic.",
   "type": "module",
   "license": "MIT",
@@ -50,24 +50,9 @@
     "test:bdd": "node --import tsx ./node_modules/@cucumber/cucumber/bin/cucumber.js",
     "test": "pnpm test:unit && pnpm test:bdd",
     "bench": "node --import tsx bench/perf.ts",
+    "gen:default-themes": "node scripts/gen-default-themes.mjs",
     "build:wasm": "node scripts/build-wasm.mjs nodejs",
     "build:wasm:web": "node scripts/build-wasm.mjs web",
     "build:wasm:all": "node scripts/build-wasm.mjs all"
-  },
-  "devDependencies": {
-    "@cucumber/cucumber": "^13.2.1",
-    "@eslint/js": "^10.0.1",
-    "@tsconfig/node-lts": "^24.0.1",
-    "@tsconfig/strictest": "^2.0.8",
-    "@types/node": "^26.2.0",
-    "eslint": "^10.9.0",
-    "eslint-config-prettier": "^10.1.8",
-    "eslint-import-resolver-typescript": "^4.4.5",
-    "eslint-plugin-import-x": "^4.17.1",
-    "tsx": "^4.23.12",
-    "typescript": "^6.0.3",
-    "typescript-eslint": "^8.67.0",
-    "vitest": "^4.1.11",
-    "wasm-pack": "^0.15.0"
   }
 }