@morphemeris/armilla-core 0.1.0

package/dist/types.generated.d.ts

@@ -0,0 +1,1274 @@
+export type TrackKind = "wheel" | "dial" | "strip" | "declination" | "grid" | "tally" | "timeline" | "midpoints" | "dispositors" | "calendar" | "ephemeris" | "cycles" | "periods" | "map";
+export type Space = {
+    /**
+     * Width in abstract units.
+     */
+    width: number;
+    /**
+     * Height in abstract units.
+     */
+    height: number;
+};
+export type SceneTypography = {
+    /**
+     * Font family.
+     */
+    family: string;
+    /**
+     * Fallback families, in order.
+     */
+    fallback: ReadonlyArray<string>;
+};
+export type BandInfo = {
+    /**
+     * Band role.
+     */
+    role: string;
+    /**
+     * The chart in this band, for chart bands.
+     */
+    chart: string | null;
+    /**
+     * Inner radius (polar) or top (linear).
+     */
+    inner: number;
+    /**
+     * Outer radius (polar) or bottom (linear).
+     */
+    outer: number;
+    /**
+     * Lane count.
+     */
+    lanes: number;
+};
+export type TrackInfo = {
+    /**
+     * The layout kind id (`wheel`, `dial`, ..., `grid`, `tally`).
+     */
+    kind: TrackKind;
+    /**
+     * Center of a polar track in scene units.
+     */
+    center: [number, number];
+    /**
+     * Outer radius of the outermost band (polar tracks).
+     */
+    outer_radius: number;
+    /**
+     * Periodic modulus in degrees; `None` on the declination graph.
+     */
+    modulus: number | null;
+    /**
+     * The longitude at the reference angle.
+     */
+    origin_lon: number;
+    /**
+     * Degrees, screen-counterclockwise from 3 o'clock, of axis parameter 0.
+     */
+    reference_angle: number;
+    /**
+     * `ccw` or `cw` (polar) — the direction of increasing longitude.
+     */
+    sense: string;
+    /**
+     * Bands outermost first.
+     */
+    bands: ReadonlyArray<BandInfo>;
+};
+export type Treatment = "normal" | "dim" | "emphasize";
+export type MarkKind = "glyph" | "text" | "line" | "path" | "arc" | "sector" | "circle";
+export type Anchor = "start" | "middle" | "end";
+export type Baseline = "alphabetic" | "middle";
+export type Segment = {
+    "op": "move";
+    /**
+     * X.
+     */
+    x: number;
+    /**
+     * Y.
+     */
+    y: number;
+} | {
+    "op": "line";
+    /**
+     * X.
+     */
+    x: number;
+    /**
+     * Y.
+     */
+    y: number;
+} | {
+    "op": "arc";
+    /**
+     * X radius.
+     */
+    rx: number;
+    /**
+     * Y radius.
+     */
+    ry: number;
+    /**
+     * Axis rotation in degrees.
+     */
+    rotation: number;
+    /**
+     * Large-arc flag.
+     */
+    large: boolean;
+    /**
+     * Sweep flag.
+     */
+    sweep: boolean;
+    /**
+     * End X.
+     */
+    x: number;
+    /**
+     * End Y.
+     */
+    y: number;
+} | {
+    "op": "cubic";
+    /**
+     * First control X.
+     */
+    x1: number;
+    /**
+     * First control Y.
+     */
+    y1: number;
+    /**
+     * Second control X.
+     */
+    x2: number;
+    /**
+     * Second control Y.
+     */
+    y2: number;
+    /**
+     * End X.
+     */
+    x: number;
+    /**
+     * End Y.
+     */
+    y: number;
+} | {
+    "op": "close";
+};
+export type Geometry = {
+    /**
+     * Glyph id.
+     */
+    glyph: string;
+    /**
+     * Variant actually served.
+     */
+    variant: string;
+    /**
+     * Origin X.
+     */
+    x: number;
+    /**
+     * Origin Y.
+     */
+    y: number;
+    /**
+     * Scene units per pack unit.
+     */
+    scale: number;
+    /**
+     * Rotation in degrees.
+     */
+    rotation: number;
+} | {
+    /**
+     * The text.
+     */
+    text: string;
+    /**
+     * X.
+     */
+    x: number;
+    /**
+     * Y.
+     */
+    y: number;
+    /**
+     * Anchor.
+     */
+    anchor: Anchor;
+    /**
+     * Baseline.
+     */
+    baseline: Baseline;
+    /**
+     * Rotation in degrees.
+     */
+    rotation: number;
+} | {
+    /**
+     * Center X.
+     */
+    cx: number;
+    /**
+     * Center Y.
+     */
+    cy: number;
+    /**
+     * Inner radius.
+     */
+    r_inner: number;
+    /**
+     * Outer radius.
+     */
+    r_outer: number;
+    /**
+     * Start angle.
+     */
+    start_deg: number;
+    /**
+     * End angle.
+     */
+    end_deg: number;
+} | {
+    /**
+     * Center X.
+     */
+    cx: number;
+    /**
+     * Center Y.
+     */
+    cy: number;
+    /**
+     * Radius.
+     */
+    r: number;
+    /**
+     * Start angle.
+     */
+    start_deg: number;
+    /**
+     * End angle.
+     */
+    end_deg: number;
+    /**
+     * Sweep direction: `true` = counterclockwise on screen.
+     */
+    sweep: boolean;
+} | {
+    /**
+     * Center X.
+     */
+    cx: number;
+    /**
+     * Center Y.
+     */
+    cy: number;
+    /**
+     * Radius.
+     */
+    r: number;
+} | {
+    /**
+     * Start X.
+     */
+    x1: number;
+    /**
+     * Start Y.
+     */
+    y1: number;
+    /**
+     * End X.
+     */
+    x2: number;
+    /**
+     * End Y.
+     */
+    y2: number;
+} | {
+    /**
+     * Segments, absolute coordinates.
+     */
+    d: ReadonlyArray<Segment>;
+};
+export type Decoration = "none" | "ring" | "underline" | "glyph";
+export type Style = {
+    /**
+     * Stroke paint.
+     */
+    stroke: string;
+    /**
+     * Fill paint.
+     */
+    fill: string;
+    /**
+     * Stroke width in scene units.
+     */
+    width: number;
+    /**
+     * Dash array; empty is solid.
+     */
+    dash: ReadonlyArray<number>;
+    /**
+     * Opacity in `[0, 1]`.
+     */
+    opacity: number;
+    /**
+     * Font size in scene units.
+     */
+    font_size: number;
+    /**
+     * Font weight, 100..=900.
+     */
+    font_weight: number;
+    /**
+     * Glyph variant name, resolved against the pack later.
+     */
+    glyph_variant: string;
+    /**
+     * Decoration.
+     */
+    decoration: Decoration;
+    /**
+     * Painters enforce `width = max(width, min_width)`.
+     */
+    min_width: number;
+    /**
+     * Set by `shrink`; 1.0 otherwise. Not rule-settable.
+     */
+    glyph_scale_factor: number;
+    /**
+     * From the pack. Not rule-settable.
+     */
+    stroke_only: boolean;
+    /**
+     * Text template for roles that compose text from data (spec §10.5):
+     * `{p}` phase letter, `{d}` degrees, `{m}` zero-padded minutes.
+     * Empty means the role's built-in format; consumed by layout, not
+     * painters, and omitted from the scene when empty.
+     */
+    template?: string;
+};
+export type Tag = {
+    /**
+     * Tag key (spec §7.3).
+     */
+    key: string;
+    /**
+     * Tag value.
+     */
+    value: string;
+};
+export type DivisionKind = "sign" | "modality" | "bounds" | "decan" | "term" | "element" | "month" | "week" | "day" | "weekday" | "year";
+export type Subject = {
+    "type": "point";
+    /**
+     * Chart role (`natal`, `transit`, ...).
+     */
+    chart: string;
+    /**
+     * astrologica body id.
+     */
+    body: string;
+} | {
+    "type": "relation";
+    /**
+     * `chart` for intra-chart; `chart_a+chart_b` for inter-chart.
+     */
+    chart_part: string;
+    /**
+     * First body, in upstream order.
+     */
+    body_a: string;
+    /**
+     * Second body, in upstream order.
+     */
+    body_b: string;
+    /**
+     * Aspect id (`square`, `parallel`, ...).
+     */
+    aspect: string;
+} | {
+    "type": "event";
+    /**
+     * The target's chart role.
+     */
+    chart: string;
+    /**
+     * The moving (transiting/progressed) body id.
+     */
+    moving: string;
+    /**
+     * The target body id.
+     */
+    target: string;
+    /**
+     * Aspect id.
+     */
+    aspect: string;
+    /**
+     * Occurrence index among events sharing the same triple,
+     * ordered by enter date — so ids stay stable as events append.
+     */
+    pass: number;
+} | {
+    "type": "almanac";
+    /**
+     * The composed key (§7.4): `lunation:full:2026-03-03`,
+     * `ingress:moon-virgo:2026-03-02`,
+     * `station:jupiter-direct:2026-03-11`, `void:{start}`.
+     */
+    key: string;
+} | {
+    "type": "series";
+    /**
+     * The composed key (§7.4): `series:{body}`,
+     * `separation:{a}-{b}`, `index:outer`.
+     */
+    key: string;
+} | {
+    "type": "acg";
+    /**
+     * The chart role the lines belong to.
+     */
+    chart: string;
+    /**
+     * The composed key (§7.4):
+     * `acg:{body}:{angle | cusp{value}}:{mode}`, the cusp value per
+     * §13.1.
+     */
+    key: string;
+} | {
+    "type": "period";
+    /**
+     * The chart role the periods belong to.
+     */
+    chart: string;
+    /**
+     * The composed key (§7.4):
+     * `period:{technique}:{level}:{start}`, start verbatim from the
+     * record.
+     */
+    key: string;
+} | {
+    "type": "dispositor";
+    /**
+     * Chart role.
+     */
+    chart: string;
+    /**
+     * The disposed body (the arrow's tail).
+     */
+    from: string;
+    /**
+     * Its dispositor (the arrow's head).
+     */
+    to: string;
+} | {
+    "type": "derived";
+    /**
+     * Chart role.
+     */
+    chart: string;
+    /**
+     * Kind id (`midpoint`, `lot`, `antiscion`, `contra_antiscion`).
+     */
+    kind: string;
+    /**
+     * Constituent body ids, in upstream order.
+     */
+    constituents: ReadonlyArray<string>;
+} | {
+    "type": "pattern";
+    /**
+     * Chart role.
+     */
+    chart: string;
+    /**
+     * Pattern id (`t_square`, `yod`, ...).
+     */
+    pattern: string;
+    /**
+     * Member body ids, in upstream order.
+     */
+    bodies: ReadonlyArray<string>;
+} | {
+    "type": "cusp";
+    /**
+     * Chart role.
+     */
+    chart: string;
+    /**
+     * House number, 1-12.
+     */
+    house: number;
+} | {
+    "type": "division";
+    /**
+     * What kind of division.
+     */
+    kind: DivisionKind;
+    /**
+     * The division's value (`aries`, `cardinal`, `out`, ...).
+     */
+    value: string;
+} | {
+    "type": "frame";
+    /**
+     * Chart role.
+     */
+    chart: string;
+} | {
+    "type": "track";
+};
+export type Mark = {
+    /**
+     * Stable id (spec §7.4).
+     */
+    id: string;
+    /**
+     * The geometry kind; painters switch on it.
+     */
+    kind: MarkKind;
+    /**
+     * Geometry by kind (spec §13.1).
+     */
+    geometry: Geometry;
+    /**
+     * Fully resolved style (spec §10.5).
+     */
+    style: Style;
+    /**
+     * What the mark is (spec §7.2).
+     */
+    role: string;
+    /**
+     * What it depicts (spec §7.1).
+     */
+    subject: Subject;
+    /**
+     * Tags, a multiset (spec §7.3); environment tags are not emitted.
+     */
+    tags: ReadonlyArray<Tag>;
+    /**
+     * Measures (spec §5.3).
+     */
+    measures: {
+        [key in string]: number;
+    };
+    /**
+     * View-state treatment (spec §11.3).
+     */
+    treatment: Treatment;
+};
+export type SchemaVersions = {
+    /**
+     * Chart input.
+     */
+    chart_input: number;
+    /**
+     * Theme.
+     */
+    theme: number;
+    /**
+     * View state.
+     */
+    view_state: number;
+    /**
+     * Environment (fixed by the spec; always 1).
+     */
+    environment: number;
+    /**
+     * Scene.
+     */
+    scene: number;
+};
+export type PackRef = {
+    /**
+     * Pack id.
+     */
+    id: string;
+    /**
+     * Pack version string.
+     */
+    version: string;
+};
+export type GlyphPackProvenance = {
+    /**
+     * What the theme asked for.
+     */
+    requested: PackRef;
+    /**
+     * What served the theme-pack role.
+     */
+    used: PackRef;
+};
+export type EnvironmentDoc = {
+    /**
+     * Output medium.
+     */
+    medium: Medium;
+    /**
+     * Light or dark scheme.
+     */
+    scheme: Scheme;
+    /**
+     * Contrast preference.
+     */
+    contrast: Contrast;
+    /**
+     * Motion preference (consumed by painters; carried for predicates).
+     */
+    motion: Motion;
+    /**
+     * Layout density.
+     */
+    density: Density;
+};
+export type Provenance = {
+    /**
+     * The core crate version.
+     */
+    core_version: string;
+    /**
+     * SHA-256 (hex) of the canonical JSON of the chart input.
+     */
+    input_digest: string;
+    /**
+     * Schema versions of every document involved.
+     */
+    schema_versions: SchemaVersions;
+    /**
+     * Document to original version, when migration ran.
+     */
+    migrated_from?: {
+        [key in string]: number;
+    } | null;
+    /**
+     * `(id, version)` of every theme in the chain, root first.
+     */
+    theme_chain: ReadonlyArray<[string, string]>;
+    /**
+     * `caller` or `default`.
+     */
+    orb_table: string;
+    /**
+     * The pack the theme asked for and the one that served it.
+     */
+    glyph_pack: GlyphPackProvenance;
+    /**
+     * Glyph ids served from the primitive pack as a fallback.
+     */
+    glyph_fallbacks: ReadonlyArray<string>;
+    /**
+     * Degradation notes, sorted (`origin:asc→aries`, `variant:bold→regular`,
+     * `collision:overflow:<band>`, ...).
+     */
+    degraded: ReadonlyArray<string>;
+    /**
+     * The environment the scene was laid out for.
+     */
+    environment: EnvironmentDoc;
+};
+export type Scene = {
+    /**
+     * Always [`SCENE_SCHEMA_VERSION`] for scenes this core emits.
+     */
+    schema_version: number;
+    /**
+     * The coordinate space.
+     */
+    space: Space;
+    /**
+     * The font stack for text marks (spec §14).
+     */
+    typography: SceneTypography;
+    /**
+     * Track geometry for hosts (hit-testing); painters ignore it.
+     */
+    tracks: ReadonlyArray<TrackInfo>;
+    /**
+     * Marks in paint order (spec §13.2).
+     */
+    marks: ReadonlyArray<Mark>;
+    /**
+     * What happened (spec §13.3).
+     */
+    provenance: Provenance;
+};
+export type Medium = "screen" | "print" | "export";
+export type Scheme = "light" | "dark";
+export type Contrast = "normal" | "high";
+export type Motion = "full" | "reduced";
+export type Density = "normal" | "compact";
+export type Origin = "asc" | "aries" | "mc";
+export type OriginSpec = Origin | number;
+export type TreatRuleDoc = {
+    /**
+     * The predicate; accepts the compact string form on input.
+     */
+    when: string | {
+        all: ReadonlyArray<Record<string, unknown>>;
+    };
+    /**
+     * The treatment.
+     */
+    treat: "hide" | "show" | "dim" | "emphasize";
+    /**
+     * Spec §3.5 (2026-09-06): a disabled rule rides the document and its
+     * bookmark but the treatment cascade skips it — hosts toggle rules
+     * for quick comparisons without losing them. Omitted when false.
+     */
+    disabled?: boolean;
+    /**
+     * Spec §3.5 (2026-09-06): an optional host-display name — "hide A's
+     * intra aspects" reads better than its predicate. Never interpreted.
+     */
+    name?: string;
+};
+export type Window = {
+    /**
+     * Start of the visible range (inclusive).
+     */
+    start: string;
+    /**
+     * End of the visible range (exclusive).
+     */
+    end: string;
+};
+export type Region = {
+    /**
+     * `[min, max]` longitude, within `[-180, 180]`.
+     */
+    lon: [number, number];
+    /**
+     * `[min, max]` latitude, within `[-90, 90]`.
+     */
+    lat: [number, number];
+};
+export type Place = {
+    /**
+     * Latitude in degrees, north positive, `[-90, 90]`.
+     */
+    latitude: number;
+    /**
+     * Longitude in degrees, east positive, `[-180, 180]`.
+     */
+    longitude: number;
+};
+export type ViewStateDoc = {
+    /**
+     * Always [`VIEW_STATE_SCHEMA_VERSION`].
+     */
+    schema_version: number;
+    /**
+     * Ordered treatment rules; later wins.
+     */
+    rules?: ReadonlyArray<TreatRuleDoc>;
+    /**
+     * Whose cusps and angles draw.
+     */
+    frame?: string | null;
+    /**
+     * Band role to chart role.
+     */
+    bands?: {
+        [key in string]: string;
+    } | null;
+    /**
+     * Origin override.
+     */
+    origin?: OriginSpec | null;
+    /**
+     * Modulus override where the track kind accepts one; an explicit
+     * `null` means non-periodic.
+     */
+    modulus?: number | null | null;
+    /**
+     * Dial pointer longitude.
+     */
+    indicator?: number | null;
+    /**
+     * The time map's visible date range (spec §6.10); absent = the
+     * events' extent, snapped outward to month boundaries.
+     */
+    window?: Window | null;
+    /**
+     * The time map's now-cursor date (spec §6.10), ISO-8601 UTC.
+     */
+    cursor?: string | null;
+    /**
+     * Expanded period subject keys (spec §6.16, 2026-09-20):
+     * `period:{technique}:{level}:{start}` entries whose child periods
+     * draw. Unknown keys are ignored.
+     */
+    expanded?: ReadonlyArray<string>;
+    /**
+     * The map's visible window (spec §6.17); absent = the whole world
+     * clipped at ±85°.
+     */
+    region?: Region | null;
+    /**
+     * The map's place marker (spec §6.17).
+     */
+    place?: Place | null;
+    /**
+     * Hover/selection rules; applied after `rules`, excluded from bookmarks.
+     */
+    transient?: ReadonlyArray<TreatRuleDoc>;
+};
+export type TimelineEvent = {
+    /**
+     * The moving (transiting/progressed/directed) body id. Not required
+     * to appear in any chart — its positions are a time series upstream.
+     */
+    moving: string;
+    /**
+     * The aspect the moving body makes.
+     */
+    aspect: string;
+    /**
+     * The target body; must name a position in the target chart.
+     */
+    target: string;
+    /**
+     * The target's chart role; defaults to the first chart in input
+     * order when absent.
+     */
+    chart: string | null;
+    /**
+     * When the moving body enters orb.
+     */
+    enter: string;
+    /**
+     * The exact passes, ascending — one, or three across a retrograde
+     * loop; may be empty for a span that never perfects in range.
+     */
+    exacts: ReadonlyArray<string>;
+    /**
+     * When the moving body leaves orb.
+     */
+    leave: string;
+    /**
+     * The moving body's motion at `enter` (spec §6.10). Absent means no
+     * motion display: the bar stays one unsegmented mark.
+     */
+    motion?: StationDirection | null;
+    /**
+     * Instants the motion flips, ascending within `[enter, leave]`;
+     * requires `motion` (spec §6.10). Absent and empty are the same
+     * document.
+     */
+    stations?: ReadonlyArray<string>;
+};
+export type LunationPhase = "new" | "first_quarter" | "full" | "last_quarter";
+export type EclipseKind = "solar" | "lunar";
+export type StationDirection = "retrograde" | "direct";
+export type AlmanacEvent = {
+    "kind": "lunation";
+    /**
+     * When the phase perfects (§6.10 timestamp format).
+     */
+    timestamp: string;
+    /**
+     * Which of the four phases.
+     */
+    phase: LunationPhase;
+    /**
+     * The lunation's ecliptic longitude, for its sign and degree.
+     */
+    longitude?: number | null;
+    /**
+     * Present when the lunation is an eclipse.
+     */
+    eclipse?: EclipseKind | null;
+} | {
+    "kind": "ingress";
+    /**
+     * When it crosses.
+     */
+    timestamp: string;
+    /**
+     * The moving body.
+     */
+    body: string;
+    /**
+     * The sign entered.
+     */
+    sign: string;
+} | {
+    "kind": "station";
+    /**
+     * When the speed crosses zero.
+     */
+    timestamp: string;
+    /**
+     * The stationing body.
+     */
+    body: string;
+    /**
+     * The motion it turns to.
+     */
+    station: StationDirection;
+    /**
+     * The station's ecliptic longitude.
+     */
+    longitude?: number | null;
+} | {
+    "kind": "void";
+    /**
+     * The last exact aspect before the sign change.
+     */
+    start: string;
+    /**
+     * The ingress that ends the void.
+     */
+    end: string;
+    /**
+     * The closing aspect that begins the void, when upstream
+     * names it.
+     */
+    aspect?: string | null;
+    /**
+     * The planet the moon's closing aspect perfects to.
+     */
+    target?: string | null;
+};
+export type BasemapKind = "land" | "border";
+export type BasemapFeature = {
+    /**
+     * Land ring or border polyline.
+     */
+    kind: BasemapKind;
+    /**
+     * `[longitude, latitude]` pairs; lon `[-180, 180]`, lat `[-90, 90]`,
+     * no consecutive jump wider than 180° of longitude.
+     */
+    points: ReadonlyArray<[number, number]>;
+};
+export type Basemap = {
+    /**
+     * Names the geography source in the map legend.
+     */
+    id: string;
+    /**
+     * The features, drawn in order.
+     */
+    features: ReadonlyArray<BasemapFeature>;
+};
+export type LayoutOptionsDoc = {
+    /**
+     * Layout kind.
+     */
+    kind: TrackKind;
+    /**
+     * Scene width; the kind's default when absent.
+     */
+    width?: number;
+    /**
+     * Scene height.
+     */
+    height?: number;
+    /**
+     * Margin.
+     */
+    margin?: number;
+    /**
+     * Glyph pack manifest, parsed by the surface.
+     */
+    pack?: unknown;
+    /**
+     * Band assignment, band role to chart role.
+     */
+    bands?: {
+        [key in string]: string;
+    };
+    /**
+     * Frame chart role.
+     */
+    frame?: string;
+};
+export type TableKind = "positions" | "cusps" | "aspects";
+export type TableOptions = {
+    /**
+     * The listing kind.
+     */
+    kind: TableKind;
+    /**
+     * Chart role — or, for the aspects kind, an inter-chart pair key
+     * (`"a+b"`). View state `frame` overrides it; absent means the
+     * single chart.
+     */
+    chart?: string;
+};
+export type TableCell = {
+    /**
+     * The column this cell fills.
+     */
+    column: string;
+    /**
+     * Formatted text; empty when upstream gave no value.
+     */
+    text: string;
+    /**
+     * Glyph id for body, sign, and aspect cells.
+     */
+    glyph?: string | null;
+};
+export type TableColumn = {
+    /**
+     * Column id, referenced by every cell.
+     */
+    id: string;
+    /**
+     * Display heading.
+     */
+    label: string;
+    /**
+     * `start` for names, `end` for numeric columns.
+     */
+    align: string;
+};
+export type TableRow = {
+    /**
+     * Stable id (spec §7.4).
+     */
+    id: string;
+    /**
+     * The subject's tags, role and id included.
+     */
+    tags: ReadonlyArray<Tag>;
+    /**
+     * The subject's measures (spec §5.3), for host-side sorting.
+     */
+    measures: {
+        [key in string]: number;
+    };
+    /**
+     * View-state treatment; hidden rows never appear.
+     */
+    treatment: Treatment;
+    /**
+     * Cells in column order.
+     */
+    cells: ReadonlyArray<TableCell>;
+};
+export type TableModel = {
+    /**
+     * The listing kind.
+     */
+    kind: string;
+    /**
+     * The chart role, or the inter-chart pair key.
+     */
+    chart: string;
+    /**
+     * Column order is presentation order.
+     */
+    columns: ReadonlyArray<TableColumn>;
+    /**
+     * Rows in input order; hidden rows are already omitted.
+     */
+    rows: ReadonlyArray<TableRow>;
+};
+export type MapLine = {
+    /**
+     * Stable id (spec §7.4).
+     */
+    id: string;
+    /**
+     * The §6.17 line vocabulary, role and id included.
+     */
+    tags: ReadonlyArray<Tag>;
+    /**
+     * The body glyph the §6.17 map labels the line with.
+     */
+    glyph: string;
+    /**
+     * `AC` | `DC` | `MC` | `IC` | the cusp value, carrying the raised
+     * mode mark under the same dual-mode rule as the map.
+     */
+    designation: string;
+    /**
+     * View-state treatment; hidden lines never appear.
+     */
+    treatment: Treatment;
+    /**
+     * Upstream segments verbatim: `[longitude, latitude]` pairs, the
+     * §3.1 basemap convention; segment breaks are upstream's
+     * terminations.
+     */
+    segments: ReadonlyArray<ReadonlyArray<[number, number]>>;
+};
+export type MapLinesModel = {
+    /**
+     * The chart role the lines belong to.
+     */
+    chart: string;
+    /**
+     * Lines in input order; hidden lines are already omitted.
+     */
+    lines: ReadonlyArray<MapLine>;
+};
+export type ErrorCode = "SHAPE" | "VERSION" | "IDENT" | "LIMIT" | "REF" | "ORB_MISSING" | "LINT" | "PACK" | "INTERNAL";
+export type Document = "chart_input" | "theme" | "view_state" | "environment" | "workspace" | "bookmark" | "pack" | "scene";
+export type ErrorRecord = {
+    /**
+     * Error category.
+     */
+    code: ErrorCode;
+    /**
+     * JSON pointer into the offending document (e.g. `/charts/natal/aspects/0`).
+     */
+    path: string;
+    /**
+     * Human-readable message. Never echoes more than 64 bytes of input.
+     */
+    message: string;
+    /**
+     * Which document the path points into.
+     */
+    document: Document;
+};
+export type LintCode = "L001" | "L002" | "L003" | "L004" | "L005" | "L006" | "L007" | "L008" | "L009";
+export type Severity = "warning" | "error";
+export type Finding = {
+    /**
+     * The code.
+     */
+    code: LintCode;
+    /**
+     * Index into the concatenated rule list; `None` for chain-level codes.
+     */
+    rule_index: number | null;
+    /**
+     * Severity.
+     */
+    severity: Severity;
+    /**
+     * Human-readable message; never echoes more than 64 bytes of input.
+     */
+    message: string;
+};
+export type Explanation = {
+    /**
+     * Index into the root-first concatenation of the chain's rules — the
+     * same indexing the linter's findings use.
+     */
+    rule_index: number;
+    /**
+     * The `id` of the theme document whose rule it is.
+     */
+    theme_id: string;
+};
+export type PanelKind = "wheel" | "dial" | "strip" | "declination" | "grid" | "tally" | "timeline" | "midpoints" | "dispositors" | "calendar" | "ephemeris" | "cycles" | "periods" | "table" | "text";
+export type LayoutKind = "grid";
+export type GridLayout = {
+    /**
+     * The layout kind.
+     */
+    kind: LayoutKind;
+    /**
+     * Grid width in cells.
+     */
+    columns: number;
+    /**
+     * Grid height in cells.
+     */
+    rows: number;
+};
+export type CellSpec = {
+    /**
+     * Leftmost column, zero-based.
+     */
+    col: number;
+    /**
+     * Topmost row, zero-based.
+     */
+    row: number;
+    /**
+     * Columns spanned, at least 1.
+     */
+    col_span: number;
+    /**
+     * Rows spanned, at least 1.
+     */
+    row_span: number;
+};
+export type Panel = {
+    /**
+     * Identifier, unique within the workspace.
+     */
+    id: string;
+    /**
+     * What the panel renders. `grid`, `table`, and `text` are out of the
+     * core's render scope (§1.4); a host renders them by other means.
+     */
+    kind: PanelKind;
+    /**
+     * Default band assignment, band role to chart role; view state
+     * `bands` may override (§11.4).
+     */
+    charts?: {
+        [key in string]: string;
+    };
+    /**
+     * Default frame chart role.
+     */
+    frame?: string | null;
+    /**
+     * The theme this panel resolves, or `inherit` from the workspace host.
+     */
+    theme: string;
+    /**
+     * An independent view state, or membership in a shared group.
+     */
+    view: "own" | {
+        shared: string;
+    };
+    /**
+     * Where the panel sits on the grid.
+     */
+    cell: CellSpec;
+    /**
+     * Per-kind options (e.g. grid `variant`); opaque to the core.
+     */
+    options?: Record<string, unknown>;
+};
+export type Workspace = {
+    /**
+     * Always [`WORKSPACE_SCHEMA_VERSION`].
+     */
+    schema_version: number;
+    /**
+     * Identifier.
+     */
+    id: string;
+    /**
+     * Display name.
+     */
+    name: string;
+    /**
+     * What the host must supply — roles, never chart identities: a
+     * workspace is a page design that applies to any chart set that
+     * fills its roles.
+     */
+    chart_roles: ReadonlyArray<string>;
+    /**
+     * The grid panels span.
+     */
+    layout: GridLayout;
+    /**
+     * The panels.
+     */
+    panels: ReadonlyArray<Panel>;
+    /**
+     * Shared view states by group name; panels link by naming a group.
+     */
+    views?: {
+        [key in string]: ViewStateDoc;
+    };
+};