compasso 0.1.0 → 0.3.0

package/dist/pedigree/index.d.ts

@@ -0,0 +1,155 @@
+import { c as PedigreeInput, d as PedigreeRole, Z as Zygosity, f as PedigreeTitleLabels, e as PedigreeSvgLabels } from '../labels-DNqRkWuI.js';
+export { C as Condition, I as Individual, L as LIFE_STATUSES, a as LifeStatus, M as Mating, P as PEDIGREE_SVG_LABELS_EN, b as PEDIGREE_TITLE_LABELS_EN, S as Sibship, T as TwinGroup } from '../labels-DNqRkWuI.js';
+import { P as Point } from '../text-DuO_PwYw.js';
+export { e as estimateTextWidth } from '../text-DuO_PwYw.js';
+import { N as NodeShape } from '../types-BnMG7TCd.js';
+export { b as PersonSex } from '../types-BnMG7TCd.js';
+
+/** Stable machine-readable issue codes (kebab-case; part of the public contract). */
+type PedigreeIssueCode = "duplicate-id" | "unknown-partner" | "self-mating" | "unknown-sibship-mating" | "unknown-child" | "child-of-two-sibships" | "twin-not-in-sibship" | "twin-group-too-small" | "twin-group-not-contiguous" | "generation-not-integer" | "unknown-condition" | "too-many-conditions" | "generation-inversion";
+interface PedigreeIssue {
+    code: PedigreeIssueCode;
+    message: string;
+}
+/** Thrown by computePedigreeLayout / pedigreeSvg on a structurally invalid pedigree. */
+declare class PedigreeValidationError extends Error {
+    readonly issues: readonly PedigreeIssue[];
+    constructor(issues: readonly PedigreeIssue[]);
+}
+/** The PSSC quadrant cap: ≤4 conditions partition a glyph; beyond that needs a key/table. */
+declare const MAX_CONDITIONS_PER_INDIVIDUAL = 4;
+/**
+ * Computes ALL validation issues for the input, deduplicated and deterministically sorted
+ * (code, then message) — array order of individuals/matings/sibships never changes the
+ * result. Empty input (no individuals AND no matings AND no sibships) is valid by
+ * definition (the renderer's empty-but-valid SVG case) and reports no issues.
+ */
+declare function pedigreeIssues(input: PedigreeInput): readonly PedigreeIssue[];
+/** Throws PedigreeValidationError (carrying ALL issues) when the input is invalid. */
+declare function validatePedigree(input: PedigreeInput): void;
+
+/** Glyph side length / diameter (px). */
+declare const PED_GLYPH = 40;
+/** Node label font size (px). */
+declare const PED_LABEL_FONT = 12;
+/** Line height for stacked label lines (px). */
+declare const PED_LABEL_LINE_H = 14;
+/** Font size for the "II-3" within-generation address drawn under each glyph. */
+declare const PED_ADDRESS_FONT = 10;
+/** Gap from a glyph's bottom to the top of its first label line. */
+declare const PED_LABEL_GAP = 6;
+declare const PED_MATING_ID_BASE = 1000000;
+declare const PED_DESCENT_ID_BASE = 2000000;
+declare const PED_SIBBAR_ID_BASE = 3000000;
+declare const PED_RISER_ID_BASE = 4000000;
+declare const PED_TWINBAR_ID_BASE = 5000000;
+interface PedigreeNode {
+    individualId: number;
+    shape: NodeShape;
+    cx: number;
+    cy: number;
+    size: number;
+    deceased: boolean;
+    carrier: boolean;
+    role: PedigreeRole;
+    stillbirth: boolean;
+    /** Condition ids in declared order → vertical fill partitions (≤4); [] = unaffected. */
+    affectedBy: number[];
+    labelLines: string[];
+    /** Top of the first label line's box (below the glyph). */
+    labelTop: number;
+    /** "II-3" within-generation address. */
+    addressLabel: string;
+    /** Verbatim <title> text (never truncated). */
+    title: string;
+}
+type PedigreeElementKind = "mating" | "mating-elbow" | "descent" | "sibship-bar" | "riser" | "twin-bar";
+interface PedigreeElement {
+    /** Namespaced id (PED_*_ID_BASE + …). */
+    edgeId: number;
+    kind: PedigreeElementKind;
+    /** Every consecutive pair axis-aligned. */
+    points: Point[];
+    /** mating: draw a second parallel line (the PSSC consanguineous double line). */
+    consanguineous: boolean;
+    title: string;
+}
+/** Roman label + the y of a generation row (the left-margin gutter). */
+interface PedigreeGenerationLabel {
+    roman: string;
+    y: number;
+}
+interface PedigreeLayout {
+    width: number;
+    height: number;
+    nodes: PedigreeNode[];
+    elements: PedigreeElement[];
+    generations: PedigreeGenerationLabel[];
+    /** Used condition ids in declared order → assigned fill ink + verbatim label (the legend
+     *  keys these; label kept here so the emitter never re-derives it from a node title). */
+    conditionFills: {
+        id: number;
+        ink: string;
+        label: string;
+    }[];
+    /** Twin zygosities actually used (drives the used-keys-only legend). */
+    twinZygositiesUsed: Zygosity[];
+    /** Junction points of unknown-zygosity twin groups — the emitter draws a "?" at each. */
+    unknownTwinJunctions: Point[];
+    /** Individuals in no mating and no sibship — grouped + drawn aside (genogram precedent). */
+    isolatedIndividualIds: number[];
+}
+interface PedigreeLayoutOptions {
+    /** Cap each node's DISPLAY label (compact preview); verbatim text stays in `title`. */
+    maxLabelChars?: number;
+    /** Locale pack for <title>s — English default; see locale packs. */
+    titleLabels?: PedigreeTitleLabels;
+}
+/**
+ * Fixed condition fill ramp — the existing zinc ink array (NO new palette, §1.7). At most
+ * 4 conditions are ever drawn (the PSSC quadrant cap, enforced in ./validate.ts), so 4
+ * distinct, decodable solids suffice; the legend keys each one.
+ */
+declare const PED_CONDITION_FILLS: readonly ["#52525b", "#a1a1aa", "#3f3f46", "#71717a"];
+/**
+ * Deterministic, overlap-proof pedigree layout (pure function of the inputs). Validates
+ * first and THROWS PedigreeValidationError on a structurally invalid pedigree — never
+ * sanitizes. Empty input yields an empty, padded layout.
+ */
+declare function computePedigreeLayout(input: PedigreeInput, opts?: PedigreeLayoutOptions): PedigreeLayout;
+
+interface PedigreeSvgOptions {
+    /** Set false to suppress the legend (compact preview); default true. */
+    legend?: boolean;
+    /** Display vocabulary (legend/accessibility) — English default; see locale packs. */
+    labels?: PedigreeSvgLabels;
+}
+/**
+ * Emits a self-contained SVG for a computed pedigree layout. Pure + deterministic.
+ * Coordinates come straight from the layout; all interpolated text is XML-escaped; all
+ * presentation attributes are literal. The legend lists ONLY the features actually used.
+ */
+declare function pedigreeLayoutSvg(layout: PedigreeLayout, opts?: PedigreeSvgOptions): string;
+
+interface PedigreeRenderOptions extends PedigreeLayoutOptions {
+    /** Set false to suppress the legend (compact preview); default true. */
+    legend?: boolean;
+    /** Display vocabulary for the emitter (legend/accessibility) — English default. */
+    svgLabels?: PedigreeSvgLabels;
+}
+interface PedigreeRenderResult {
+    /** Self-contained SVG (numeric width/height + matching viewBox — PDF-embedder safe). */
+    svg: string;
+    /** The computed layout, for callers that decorate or hit-test the diagram. */
+    layout: PedigreeLayout;
+}
+/**
+ * Renders a pedigree input to a self-contained SVG string. Deterministic: same data → same
+ * SVG (array order never matters; a sibship's `childIds` order is honored as the declared
+ * left-to-right birth order). Throws PedigreeValidationError — carrying EVERY issue,
+ * deterministically sorted — on a structurally invalid pedigree. Empty input yields an
+ * empty-but-valid SVG; callers decide their own empty state.
+ */
+declare function pedigreeSvg(input: PedigreeInput, opts?: PedigreeRenderOptions): PedigreeRenderResult;
+
+export { MAX_CONDITIONS_PER_INDIVIDUAL, NodeShape, PED_ADDRESS_FONT, PED_CONDITION_FILLS, PED_DESCENT_ID_BASE, PED_GLYPH, PED_LABEL_FONT, PED_LABEL_GAP, PED_LABEL_LINE_H, PED_MATING_ID_BASE, PED_RISER_ID_BASE, PED_SIBBAR_ID_BASE, PED_TWINBAR_ID_BASE, type PedigreeElement, type PedigreeElementKind, type PedigreeGenerationLabel, PedigreeInput, type PedigreeIssue, type PedigreeIssueCode, type PedigreeLayout, type PedigreeLayoutOptions, type PedigreeNode, type PedigreeRenderOptions, type PedigreeRenderResult, PedigreeRole, PedigreeSvgLabels, type PedigreeSvgOptions, PedigreeTitleLabels, PedigreeValidationError, Point, Zygosity, computePedigreeLayout, pedigreeIssues, pedigreeLayoutSvg, pedigreeSvg, validatePedigree };

package/dist/pedigree/index.js

@@ -0,0 +1,4 @@
+export { LIFE_STATUSES, MAX_CONDITIONS_PER_INDIVIDUAL, PEDIGREE_SVG_LABELS_EN, PEDIGREE_TITLE_LABELS_EN, PED_ADDRESS_FONT, PED_CONDITION_FILLS, PED_DESCENT_ID_BASE, PED_GLYPH, PED_LABEL_FONT, PED_LABEL_GAP, PED_LABEL_LINE_H, PED_MATING_ID_BASE, PED_RISER_ID_BASE, PED_SIBBAR_ID_BASE, PED_TWINBAR_ID_BASE, PedigreeValidationError, computePedigreeLayout, pedigreeIssues, pedigreeLayoutSvg, pedigreeSvg, validatePedigree } from '../chunk-F47C6ZEB.js';
+export { estimateTextWidth } from '../chunk-O3BT2O42.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/pedigree/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}