compasso 0.1.0

package/dist/genogram/index.d.ts

@@ -0,0 +1,149 @@
+import { N as NodeShape, e as KinshipLexicon, d as GenogramTitleLabels, f as Person, i as Union, P as ParentLink, R as Relationship, c as GenogramSvgLabels, j as UnionStatus, b as GenogramInput } from '../kinship-Bkf87Jhu.js';
+export { G as GENOGRAM_SVG_LABELS_EN, a as GENOGRAM_TITLE_LABELS_EN, K as KINSHIP_EN, g as PersonSex, h as RelationshipMapClass, U as UNION_STATUSES, k as classifyRelationshipType, r as relationshipTypeTokens } from '../kinship-Bkf87Jhu.js';
+import { Point } from '../core/index.js';
+export { CHAR_W, estimateTextWidth, wrapLabel, xmlEscape } from '../core/index.js';
+import { a as EdgeLineStyle, c as QualityLexicon } from '../stroke-MQ427drt.js';
+export { E as EDGE_STROKE, b as EdgeStroke, q as qualityLineStyle } from '../stroke-MQ427drt.js';
+
+declare const NODE_SIZE = 56;
+/** Node label font size (px). The live SVG renders at this size; the PDF scales it. */
+declare const LABEL_FONT = 12;
+/** Line height for stacked node-label lines (px). */
+declare const LABEL_LINE_H = 14;
+/** Edge label font size (px) — kept for the shared metrics contract (invariant #9). */
+declare const EDGE_FONT = 11;
+declare const UNION_REL_ID_BASE = 1000000;
+declare const PARENT_REL_ID_BASE = 2000000;
+declare const PROMOTED_REL_ID_BASE = 3000000;
+/**
+ * Per-edge VISUAL union style applied at emission (§7.2 / FIX 3) — the McGoldrick
+ * notation for a declared union TYPE, WITHOUT touching the layout or the patient's
+ * words. `coparental` never gets one (it draws no edge). Defined here (not in
+ * fallback-svg) so a routed element can carry it and the emitter stays free of layout
+ * cycles; fallback-svg re-exports it for the existing call sites.
+ */
+interface UnionEdgeStyle {
+    /** Inline stroke-dasharray [dash, gap] on the bar; absent = solid (e.g. casado). */
+    dash?: readonly [number, number];
+    /** Diagonal status slashes at the midpoint: 1 = separação, 2 = divórcio. */
+    slashes?: 0 | 1 | 2;
+}
+interface GenogramNode {
+    personId: number;
+    /** Full, verbatim label (used for tooltips/aria — never truncated). */
+    label: string;
+    shape: NodeShape;
+    deceased: boolean;
+    /** Center of the node. */
+    cx: number;
+    cy: number;
+    /** Side length (square) / diameter (circle) / width (diamond). */
+    size: number;
+    /** Pre-wrapped display lines (already capped for the requested density). */
+    labelLines: string[];
+    /** Y of the TOP of the first label line's box (each next line is +LABEL_LINE_H). */
+    labelTop: number;
+}
+/** A routed map element — the orthogonal replacement for the old straight `GenogramEdge`. */
+type GenogramElementKind = "union-bar" | "union-elbow" | "descent" | "sibling-bar" | "bond";
+interface GenogramElement {
+    kind: GenogramElementKind;
+    /** Source row ids for traceability; merged bonds carry every merged rel id. */
+    relIds: number[];
+    /** data-edge-id value: highest relId (matches latestUnionPerPair's highest-wins). */
+    edgeId: number;
+    fromPersonId: number | null;
+    toPersonId: number | null;
+    /** Polyline; EVERY consecutive pair is axis-aligned (H or V). */
+    points: Point[];
+    /** Verbatim titles (one per source row), joined for the <title>. */
+    titles: string[];
+    lineStyle: EdgeLineStyle;
+    unionStyle?: UnionEdgeStyle;
+    dotted?: boolean;
+}
+interface GenogramLayout {
+    width: number;
+    height: number;
+    nodes: GenogramNode[];
+    elements: GenogramElement[];
+    /** People with NO drawn structural/bond connection — grouped to the side and labeled
+     *  "Sem ascendência registrada" so a loose glyph is never left unexplained. */
+    isolatedPersonIds: number[];
+}
+/**
+ * Deterministic, overlap-proof ORTHOGONAL layout (pure function of the inputs — same
+ * data always yields the same geometry). People are grouped by `generation` (null trails
+ * as a bottom row), rows ordered oldest-on-top. Declared structure is drawn as McGoldrick
+ * elements: same-row adjacent unions as straight bars, couples-with-children as a shared
+ * sibling bar, lone/co-parental genitors as dotted descents, and free-text relationships
+ * as orthogonally-routed bonds — NEVER promoting a bond into structure.
+ *
+ * @param unions       caller-deduped (one per pair) declared couple bonds.
+ * @param parentLinks  declared parent→child links (one row per declared genitor).
+ * @param relationships non-structural ties (drawn as bonds).
+ * @param opts.maxLabelChars cap each node's DISPLAY label to this many chars (compact
+ *   preview); the full verbatim text is still exposed on `node.label`.
+ * @param opts.kinship / opts.qualityLexicon / opts.titleLabels — locale packs (English
+ *   defaults; see `compasso/locales/pt-br`).
+ */
+interface GenogramLayoutOptions {
+    maxLabelChars?: number;
+    kinship?: KinshipLexicon;
+    qualityLexicon?: QualityLexicon;
+    titleLabels?: GenogramTitleLabels;
+}
+declare function computeGenogramLayout(people: Person[], unions: Union[], parentLinks: ParentLink[], relationships: Relationship[], opts?: GenogramLayoutOptions): GenogramLayout;
+
+interface GenogramSvgOptions {
+    /**
+     * Per-edge VISUAL union style (edgeId → {dash?, slashes?}), applied at emission.
+     * Gives each declared union TYPE its own McGoldrick notation. Overrides any
+     * `unionStyle` already on the element.
+     */
+    unionStyleByRelId?: ReadonlyMap<number, UnionEdgeStyle>;
+    /** Set false to suppress the legend (compact preview); default true. */
+    legend?: boolean;
+    /** Display vocabulary (legend/accessibility) — English default; see locale packs. */
+    labels?: GenogramSvgLabels;
+}
+/**
+ * Emits a self-contained SVG for a computed genogram layout. Pure + deterministic.
+ * Coordinates come straight from the layout; all interpolated text is XML-escaped; all
+ * presentation attributes are literal; there is NO text on map edges.
+ */
+declare function genogramLayoutSvg(layout: GenogramLayout, opts?: GenogramSvgOptions): string;
+
+/**
+ * McGoldrick notation per declared union TYPE — a per-edge VISUAL override applied at
+ * emission, never a synthesized quality. `coparental` is ABSENT on purpose: it draws
+ * NO couple element at all; the co-parenthood shows only on the descents converging
+ * on the child(ren).
+ */
+declare const UNION_NOTATION: Record<Exclude<UnionStatus, "coparental">, UnionEdgeStyle>;
+/**
+ * Duplicate unions for the same unordered pair should not exist (callers are expected
+ * to normalize), but if they do, the HIGHEST id wins — the most recent statement.
+ * NEVER a status-rank heuristic: recency is a fact, ranking would be an interpretation.
+ */
+declare function latestUnionPerPair(unions: Union[]): Union[];
+interface GenogramRenderOptions extends GenogramLayoutOptions {
+    /** Set false to suppress the legend (compact preview); default true. */
+    legend?: boolean;
+    /** Display vocabulary for the emitter (legend/accessibility) — English default. */
+    svgLabels?: GenogramSvgLabels;
+}
+interface GenogramRenderResult {
+    /** 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: GenogramLayout;
+}
+/**
+ * Renders a genogram input to a self-contained SVG string. Deterministic: same data →
+ * same SVG. Empty `people` yields an empty-but-valid SVG; callers decide their own
+ * empty state before calling.
+ */
+declare function genogramSvg(input: GenogramInput, opts?: GenogramRenderOptions): GenogramRenderResult;
+
+export { EDGE_FONT, EdgeLineStyle, type GenogramElement, type GenogramElementKind, GenogramInput, type GenogramLayout, type GenogramLayoutOptions, type GenogramNode, type GenogramRenderOptions, type GenogramRenderResult, GenogramSvgLabels, type GenogramSvgOptions, GenogramTitleLabels, KinshipLexicon, LABEL_FONT, LABEL_LINE_H, NODE_SIZE, NodeShape, PARENT_REL_ID_BASE, PROMOTED_REL_ID_BASE, ParentLink, Person, Point, QualityLexicon, Relationship, UNION_NOTATION, UNION_REL_ID_BASE, Union, type UnionEdgeStyle, UnionStatus, computeGenogramLayout, genogramLayoutSvg, genogramSvg, latestUnionPerPair };

package/dist/genogram/index.js

@@ -0,0 +1,4 @@
+export { EDGE_FONT, GENOGRAM_SVG_LABELS_EN, GENOGRAM_TITLE_LABELS_EN, KINSHIP_EN, LABEL_FONT, LABEL_LINE_H, NODE_SIZE, PARENT_REL_ID_BASE, PROMOTED_REL_ID_BASE, UNION_NOTATION, UNION_REL_ID_BASE, UNION_STATUSES, classifyRelationshipType, computeGenogramLayout, genogramLayoutSvg, genogramSvg, latestUnionPerPair, relationshipTypeTokens } from '../chunk-5RRRE2GF.js';
+export { CHAR_W, EDGE_STROKE, estimateTextWidth, qualityLineStyle, wrapLabel, xmlEscape } from '../chunk-E456YKAJ.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/genogram/index.js.map

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