@morphemeris/armilla-core 0.1.0 → 0.3.0

package/dist/default-themes.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/default-themes.test.js

@@ -0,0 +1,83 @@
+/**
+ * Versioned default-theme history (spec §10.2, §13.5): the binding ships every
+ * historical default-theme snapshot so hosts can pin a theme's base via
+ * `extends: "default_v<n>"`. Build the WASM first: `pnpm build:wasm`.
+ *
+ * The history gate: when `crates/core/themes/default.json` changes content,
+ * the latest snapshot no longer matches and this suite fails until a new
+ * snapshot is cut (`node scripts/gen-default-themes.mjs bump`).
+ */
+import { readdirSync, readFileSync } from 'node:fs';
+import { describe, expect, it } from 'vitest';
+import { DEFAULT_THEME_VERSION, defaultTheme, layout } from './index.js';
+const historyDir = new URL('../../../crates/core/themes/history/', import.meta.url);
+const natal = JSON.parse(readFileSync(new URL('../../../fixtures/charts/natal_timed.json', import.meta.url), 'utf-8'));
+const environment = {
+    medium: 'screen',
+    scheme: 'light',
+    contrast: 'normal',
+    motion: 'full',
+    density: 'normal',
+};
+const emptyView = { schema_version: 1 };
+const historyFiles = () => readdirSync(historyDir).sort();
+const readSnapshot = (version) => JSON.parse(readFileSync(new URL(`default_v${String(version)}.json`, historyDir), 'utf-8'));
+describe('the history on disk', () => {
+    it('is contiguous default_v1..default_vN with N = DEFAULT_THEME_VERSION', () => {
+        const expected = Array.from({ length: DEFAULT_THEME_VERSION }, (_, i) => `default_v${String(i + 1)}.json`).sort();
+        expect(historyFiles()).toEqual(expected);
+    });
+    it('gives every snapshot the id of its filename and no extends', () => {
+        for (let v = 1; v <= DEFAULT_THEME_VERSION; v += 1) {
+            const doc = readSnapshot(v);
+            expect(doc['id']).toBe(`default_v${String(v)}`);
+            expect(doc['extends']).toBeUndefined();
+        }
+    });
+    it('keeps snapshot version strings distinct (each content change bumps the doc version)', () => {
+        const versions = Array.from({ length: DEFAULT_THEME_VERSION }, (_, i) => String(readSnapshot(i + 1)['version']));
+        expect(new Set(versions).size).toBe(versions.length);
+    });
+    it('matches the current built-in default in its latest snapshot, modulo id (the bump gate)', () => {
+        const latest = readSnapshot(DEFAULT_THEME_VERSION);
+        const current = defaultTheme();
+        expect({ ...latest, id: 'default' }).toEqual(current);
+    });
+});
+describe('defaultTheme(version)', () => {
+    it('returns the current default with the version omitted, unchanged behavior', () => {
+        const doc = defaultTheme();
+        expect(doc['id']).toBe('default');
+    });
+    it('returns the pinned snapshot for a history version, verbatim', () => {
+        const doc = defaultTheme(1);
+        expect(doc).toEqual(readSnapshot(1));
+        expect(doc['id']).toBe('default_v1');
+    });
+    it('rejects versions outside 1..DEFAULT_THEME_VERSION', () => {
+        expect(() => defaultTheme(0)).toThrow(/version/);
+        expect(() => defaultTheme(DEFAULT_THEME_VERSION + 1)).toThrow(/version/);
+        expect(() => defaultTheme(1.5)).toThrow(/version/);
+    });
+});
+describe('pinned chains', () => {
+    const pinned = {
+        schema_version: 1,
+        id: 'pin_probe',
+        name: 'Pin probe',
+        version: '0.0.1',
+        author: 'test',
+        license: 'MIT',
+        extends: `default_v${String(DEFAULT_THEME_VERSION)}`,
+        rules: [],
+    };
+    it('lays out with the snapshot supplied as the pinned base', () => {
+        const scene = layout(natal, [defaultTheme(DEFAULT_THEME_VERSION), pinned], emptyView, environment, { kind: 'wheel' });
+        expect(scene.marks.length).toBeGreaterThan(0);
+        const chainIds = scene.provenance.theme_chain.map(([id]) => id);
+        expect(chainIds).toEqual(['default', `default_v${String(DEFAULT_THEME_VERSION)}`, 'pin_probe']);
+    });
+    it('fails loudly (REF), never drifts silently, when the pin is not resolved by the host', () => {
+        expect(() => layout(natal, [pinned], emptyView, environment, { kind: 'wheel' })).toThrow(/extends/);
+    });
+});

package/dist/surface.d.ts

@@ -4,6 +4,7 @@
  * this wholesale and differ only in how the WASM artifact loads.
  */
 export { ArmillaError, bookmark, defaultTheme, explain, layout, lint, mapLines, migrate, paintSvg, tableRows, unbookmark, validateWorkspace, version, } from './armilla.js';
+export { DEFAULT_THEME_VERSION } from './default-themes.generated.js';
 export { naturalEarth110m } from './basemap.generated.js';
 export { vocabulary } from './vocabulary.generated.js';
 export type { Anchor, BandInfo, Basemap, BasemapFeature, BasemapKind, Baseline, CellSpec, ChartInputDoc, Decoration, EnvironmentDoc, ErrorRecord, Explanation, Finding, Geometry, GridLayout, LayoutOptionsDoc, MapLine, MapLinesModel, Mark, MarkKind, OriginSpec, Place, Region, PackManifestDoc, PackRef, Paint, Panel, PanelKind, PanelViewBinding, Provenance, Scene, SceneTypography, SchemaVersions, Segment, Space, Style, Subject, TableCell, TableColumn, TableKind, TableModel, TableOptions, TableRow, Tag, ThemeDoc, TrackInfo, TrackKind, Treatment, TreatRuleDoc, ViewStateDoc, Vocabulary, VocabularyKey, Workspace, WorkspaceDoc, } from './types.js';

package/dist/surface.js

@@ -4,6 +4,7 @@
  * this wholesale and differ only in how the WASM artifact loads.
  */
 export { ArmillaError, bookmark, defaultTheme, explain, layout, lint, mapLines, migrate, paintSvg, tableRows, unbookmark, validateWorkspace, version, } from './armilla.js';
+export { DEFAULT_THEME_VERSION } from './default-themes.generated.js';
 export { naturalEarth110m } from './basemap.generated.js';
 export { vocabulary } from './vocabulary.generated.js';
 export { SCENE_SCHEMA_VERSION, isScene } from './types.js';

package/dist/types.d.ts

@@ -7,7 +7,7 @@
  * few aliases that have no Rust counterpart.
  */
 export * from './types.generated.js';
-import type { Scene, Workspace } from './types.generated.js';
+import type { PackManifest, Scene, Workspace } from './types.generated.js';
 /** The scene schema version this binding understands (spec §3.9). */
 export declare const SCENE_SCHEMA_VERSION: 1;
 /** A resolved paint: a color string or `'none'` (spec §10.5). */
@@ -26,8 +26,12 @@ export type WorkspaceDoc = Workspace;
 export type ChartInputDoc = unknown;
 /** A theme document (spec §3.4); passed through to the core. */
 export type ThemeDoc = unknown;
-/** A glyph pack manifest (spec §3.8); passed through to the core. */
-export type PackManifestDoc = unknown;
+/**
+ * A glyph pack manifest (spec §3.8), typed since 2026-09-21 — the generated
+ * `PackManifest` shape. The core still validates; extra `GlyphGeometry`
+ * fields pass through untouched (the authoring-spec extension seam).
+ */
+export type PackManifestDoc = PackManifest;
 /**
  * One §7.3 tag key in the predicate vocabulary (spec §13.5, §19): its value
  * space — the closed values expanded (`role` lists the §7.2 roles, `house`

package/dist/types.generated.d.ts

@@ -991,6 +991,77 @@ export type LayoutOptionsDoc = {
      */
     frame?: string;
 };
+export type JsonValue = number | string | boolean | ReadonlyArray<JsonValue> | {
+    [key in string]: JsonValue;
+} | null;
+export type BBox = {
+    /**
+     * Left edge.
+     */
+    x: number;
+    /**
+     * Top edge (y-down).
+     */
+    y: number;
+    /**
+     * Width.
+     */
+    w: number;
+    /**
+     * Height.
+     */
+    h: number;
+};
+export type GlyphGeometry = {
+    /**
+     * SVG path data, origin-centered, y-down.
+     */
+    d: string;
+} & ({
+    [key in string]: number | string | boolean | ReadonlyArray<JsonValue> | {
+        [key in string]: JsonValue;
+    } | null;
+});
+export type Glyph = {
+    /**
+     * Authoring box in pack units, origin-centered.
+     */
+    bbox: BBox;
+    /**
+     * Geometry per variant; at least `regular`.
+     */
+    variants: {
+        [key in string]: GlyphGeometry;
+    };
+    /**
+     * Pack-level rendering hint carried into style (spec §10.5).
+     */
+    stroke_only: boolean;
+};
+export type PackManifest = {
+    /**
+     * Always [`PACK_SCHEMA_VERSION`].
+     */
+    schema_version: number;
+    /**
+     * Pack id.
+     */
+    id: string;
+    /**
+     * Pack version string.
+     */
+    version: string;
+    /**
+     * The box size glyph geometry is authored in (10 for wheel-style packs).
+     */
+    units: number;
+    /**
+     * Glyphs by id.
+     */
+    glyphs: {
+        [key in string]: Glyph;
+    };
+};
 export type TableKind = "positions" | "cusps" | "aspects";
 export type TableOptions = {
     /**

package/docs/changelog.md

@@ -35,3 +35,10 @@ Additions within version 1 (optional fields; older documents parse unchanged):
   cascade channels — a later `dim`/`emphasize` no longer resurrects a hidden mark; only
   `show` cancels a hide (restoring normal emphasis, as before). Behavioral, no schema
   change; rule lists that relied on dim-after-hide re-showing marks now keep them hidden.
+- 2026-09-21 — pack manifest (§3.8): `units` must be 10 at schema_version 1 (previously any
+  positive number was accepted but anything but 10 rendered mis-scaled — theme glyph scales
+  are scene units per pack unit, tuned against 10-unit boxes). The required-glyph registry
+  gains the four lunation phases the §6.13 calendar emits, and the registry is published as
+  the generated pack reference (`docs/packs.md` / `docs/packs.json`) with the three authoring
+  tiers (minimal / standard / complete). The binding's `PackManifestDoc` becomes the generated
+  `PackManifest` type instead of `unknown`.

package/docs/packs.json

@@ -0,0 +1,478 @@
+{
+  "groups": {
+    "aspects": [
+      "conjunction",
+      "opposition",
+      "trine",
+      "square",
+      "sextile",
+      "semi_sextile",
+      "quincunx",
+      "semi_square",
+      "sesquiquadrate",
+      "quintile",
+      "bi_quintile",
+      "septile",
+      "bi_septile",
+      "tri_septile",
+      "novile",
+      "bi_novile",
+      "quad_novile",
+      "quindecile",
+      "parallel",
+      "contraparallel"
+    ],
+    "bodies": [
+      "sun",
+      "moon",
+      "mercury",
+      "venus",
+      "earth",
+      "mars",
+      "jupiter",
+      "saturn",
+      "uranus",
+      "neptune",
+      "pluto",
+      "ceres",
+      "pallas",
+      "juno",
+      "vesta",
+      "hygiea",
+      "astraea",
+      "eros",
+      "psyche",
+      "amor",
+      "sappho",
+      "urania",
+      "chiron",
+      "pholus",
+      "nessus",
+      "asbolus",
+      "chariklo",
+      "eris",
+      "sedna",
+      "haumea",
+      "makemake",
+      "quaoar",
+      "orcus",
+      "ixion",
+      "varuna",
+      "gonggong",
+      "mean_node",
+      "true_node",
+      "north_node",
+      "south_node",
+      "mean_south_node",
+      "true_south_node",
+      "mean_apogee",
+      "osculating_apogee",
+      "interpolated_apogee",
+      "interpolated_perigee",
+      "lilith",
+      "mean_lilith",
+      "true_lilith",
+      "black_moon_lilith",
+      "priapus",
+      "ascendant",
+      "descendant",
+      "midheaven",
+      "imum_coeli",
+      "vertex",
+      "antivertex",
+      "east_point",
+      "polar_ascendant",
+      "cupido",
+      "hades",
+      "zeus",
+      "kronos",
+      "apollon",
+      "admetos",
+      "vulkanus",
+      "poseidon",
+      "transpluto",
+      "regulus",
+      "spica",
+      "algol",
+      "aldebaran",
+      "antares",
+      "fomalhaut",
+      "sirius",
+      "vega",
+      "arcturus",
+      "betelgeuse",
+      "rigel",
+      "pollux",
+      "castor",
+      "procyon",
+      "alcyone",
+      "part_of_fortune",
+      "part_of_spirit",
+      "part_of_eros",
+      "part_of_necessity",
+      "part_of_courage",
+      "part_of_victory",
+      "part_of_nemesis"
+    ],
+    "events": [
+      "occultation",
+      "lunar_eclipse"
+    ],
+    "kinds": [
+      "luminary",
+      "planet",
+      "asteroid",
+      "centaur",
+      "tno",
+      "node",
+      "apsis",
+      "lot",
+      "angle",
+      "fixed_star",
+      "uranian",
+      "unknown"
+    ],
+    "marks": [
+      "retrograde",
+      "direct",
+      "stationary",
+      "indicator",
+      "midpoint",
+      "antiscion",
+      "contra_antiscion"
+    ],
+    "phases": [
+      "new_moon",
+      "full_moon",
+      "first_quarter",
+      "last_quarter"
+    ],
+    "signs": [
+      "aries",
+      "taurus",
+      "gemini",
+      "cancer",
+      "leo",
+      "virgo",
+      "libra",
+      "scorpio",
+      "sagittarius",
+      "capricorn",
+      "aquarius",
+      "pisces"
+    ]
+  },
+  "manifest": {
+    "max_glyphs": 4096,
+    "schema_version": 1,
+    "units": 10.0
+  },
+  "tiers": {
+    "complete": [
+      "aries",
+      "taurus",
+      "gemini",
+      "cancer",
+      "leo",
+      "virgo",
+      "libra",
+      "scorpio",
+      "sagittarius",
+      "capricorn",
+      "aquarius",
+      "pisces",
+      "conjunction",
+      "opposition",
+      "trine",
+      "square",
+      "sextile",
+      "semi_sextile",
+      "quincunx",
+      "semi_square",
+      "sesquiquadrate",
+      "quintile",
+      "bi_quintile",
+      "septile",
+      "bi_septile",
+      "tri_septile",
+      "novile",
+      "bi_novile",
+      "quad_novile",
+      "quindecile",
+      "parallel",
+      "contraparallel",
+      "retrograde",
+      "direct",
+      "stationary",
+      "indicator",
+      "midpoint",
+      "antiscion",
+      "contra_antiscion",
+      "new_moon",
+      "full_moon",
+      "first_quarter",
+      "last_quarter",
+      "occultation",
+      "lunar_eclipse",
+      "luminary",
+      "planet",
+      "asteroid",
+      "centaur",
+      "tno",
+      "node",
+      "apsis",
+      "lot",
+      "angle",
+      "fixed_star",
+      "uranian",
+      "unknown",
+      "sun",
+      "moon",
+      "mercury",
+      "venus",
+      "earth",
+      "mars",
+      "jupiter",
+      "saturn",
+      "uranus",
+      "neptune",
+      "pluto",
+      "ceres",
+      "pallas",
+      "juno",
+      "vesta",
+      "hygiea",
+      "astraea",
+      "eros",
+      "psyche",
+      "amor",
+      "sappho",
+      "urania",
+      "chiron",
+      "pholus",
+      "nessus",
+      "asbolus",
+      "chariklo",
+      "eris",
+      "sedna",
+      "haumea",
+      "makemake",
+      "quaoar",
+      "orcus",
+      "ixion",
+      "varuna",
+      "gonggong",
+      "mean_node",
+      "true_node",
+      "north_node",
+      "south_node",
+      "mean_south_node",
+      "true_south_node",
+      "mean_apogee",
+      "osculating_apogee",
+      "interpolated_apogee",
+      "interpolated_perigee",
+      "lilith",
+      "mean_lilith",
+      "true_lilith",
+      "black_moon_lilith",
+      "priapus",
+      "ascendant",
+      "descendant",
+      "midheaven",
+      "imum_coeli",
+      "vertex",
+      "antivertex",
+      "east_point",
+      "polar_ascendant",
+      "cupido",
+      "hades",
+      "zeus",
+      "kronos",
+      "apollon",
+      "admetos",
+      "vulkanus",
+      "poseidon",
+      "transpluto",
+      "regulus",
+      "spica",
+      "algol",
+      "aldebaran",
+      "antares",
+      "fomalhaut",
+      "sirius",
+      "vega",
+      "arcturus",
+      "betelgeuse",
+      "rigel",
+      "pollux",
+      "castor",
+      "procyon",
+      "alcyone",
+      "part_of_fortune",
+      "part_of_spirit",
+      "part_of_eros",
+      "part_of_necessity",
+      "part_of_courage",
+      "part_of_victory",
+      "part_of_nemesis"
+    ],
+    "minimal": [
+      "aries",
+      "taurus",
+      "gemini",
+      "cancer",
+      "leo",
+      "virgo",
+      "libra",
+      "scorpio",
+      "sagittarius",
+      "capricorn",
+      "aquarius",
+      "pisces",
+      "sun",
+      "moon",
+      "mercury",
+      "venus",
+      "earth",
+      "mars",
+      "jupiter",
+      "saturn",
+      "uranus",
+      "neptune",
+      "pluto",
+      "mean_node",
+      "true_node",
+      "north_node",
+      "south_node",
+      "mean_south_node",
+      "true_south_node",
+      "chiron",
+      "lilith",
+      "mean_lilith",
+      "true_lilith",
+      "black_moon_lilith",
+      "mean_apogee",
+      "ascendant",
+      "descendant",
+      "midheaven",
+      "imum_coeli",
+      "conjunction",
+      "opposition",
+      "trine",
+      "square",
+      "sextile",
+      "retrograde",
+      "direct",
+      "stationary",
+      "indicator",
+      "new_moon",
+      "full_moon",
+      "first_quarter",
+      "last_quarter"
+    ],
+    "standard": [
+      "aries",
+      "taurus",
+      "gemini",
+      "cancer",
+      "leo",
+      "virgo",
+      "libra",
+      "scorpio",
+      "sagittarius",
+      "capricorn",
+      "aquarius",
+      "pisces",
+      "sun",
+      "moon",
+      "mercury",
+      "venus",
+      "earth",
+      "mars",
+      "jupiter",
+      "saturn",
+      "uranus",
+      "neptune",
+      "pluto",
+      "mean_node",
+      "true_node",
+      "north_node",
+      "south_node",
+      "mean_south_node",
+      "true_south_node",
+      "chiron",
+      "lilith",
+      "mean_lilith",
+      "true_lilith",
+      "black_moon_lilith",
+      "mean_apogee",
+      "ascendant",
+      "descendant",
+      "midheaven",
+      "imum_coeli",
+      "conjunction",
+      "opposition",
+      "trine",
+      "square",
+      "sextile",
+      "retrograde",
+      "direct",
+      "stationary",
+      "indicator",
+      "new_moon",
+      "full_moon",
+      "first_quarter",
+      "last_quarter",
+      "semi_sextile",
+      "quincunx",
+      "semi_square",
+      "sesquiquadrate",
+      "quintile",
+      "bi_quintile",
+      "septile",
+      "bi_septile",
+      "tri_septile",
+      "novile",
+      "bi_novile",
+      "quad_novile",
+      "quindecile",
+      "parallel",
+      "contraparallel",
+      "ceres",
+      "pallas",
+      "juno",
+      "vesta",
+      "osculating_apogee",
+      "interpolated_apogee",
+      "interpolated_perigee",
+      "priapus",
+      "vertex",
+      "antivertex",
+      "east_point",
+      "polar_ascendant",
+      "part_of_fortune",
+      "part_of_spirit",
+      "part_of_eros",
+      "part_of_necessity",
+      "part_of_courage",
+      "part_of_victory",
+      "part_of_nemesis",
+      "midpoint",
+      "antiscion",
+      "contra_antiscion",
+      "luminary",
+      "planet",
+      "asteroid",
+      "centaur",
+      "tno",
+      "node",
+      "apsis",
+      "lot",
+      "angle",
+      "fixed_star",
+      "uranian",
+      "unknown"
+    ]
+  }
+}