compasso 0.4.0 → 0.5.0

package/dist/genogram/index.d.cts

@@ -1,11 +1,11 @@
-import { N as NodeShape, a as Person, c as Union, P as ParentLink, R as Relationship, d as UnionStatus, G as GenogramInput } from '../types-BnMG7TCd.cjs';
-export { b as PersonSex, U as UNION_STATUSES } from '../types-BnMG7TCd.cjs';
-import { d as KinshipLexicon, c as GenogramTitleLabels, b as GenogramSvgLabels } from '../kinship-Dy_ijjJV.cjs';
-export { G as GENOGRAM_SVG_LABELS_EN, a as GENOGRAM_TITLE_LABELS_EN, K as KINSHIP_EN, R as RelationshipMapClass, e as classifyRelationshipType, r as relationshipTypeTokens } from '../kinship-Dy_ijjJV.cjs';
-import { P as Point } from '../text-DuO_PwYw.cjs';
-export { C as CHAR_W, e as estimateTextWidth, w as wrapLabel } from '../text-DuO_PwYw.cjs';
+import { N as NodeShape, a as Person, c as Union, P as ParentLink, R as Relationship, d as UnionStatus, G as GenogramInput } from '../types-jE2fdM1t.cjs';
+export { b as PersonSex, U as UNION_STATUSES } from '../types-jE2fdM1t.cjs';
+import { d as KinshipLexicon, c as GenogramTitleLabels, b as GenogramSvgLabels } from '../kinship-BOUss5cT.cjs';
+export { G as GENOGRAM_SVG_LABELS_EN, a as GENOGRAM_TITLE_LABELS_EN, K as KINSHIP_EN, R as RelationshipMapClass, e as classifyRelationshipType, r as relationshipTypeTokens } from '../kinship-BOUss5cT.cjs';
+import { P as Point } from '../geometry-P-XGqGe7.cjs';
 import { a as EdgeLineStyle, c as QualityLexicon } from '../stroke-MQ427drt.cjs';
 export { E as EDGE_STROKE, b as EdgeStroke, q as qualityLineStyle } from '../stroke-MQ427drt.cjs';
+export { C as CHAR_W, e as estimateTextWidth, w as wrapLabel } from '../text-DDVzpwPZ.cjs';
 export { x as xmlEscape } from '../xml-DDae1eUr.cjs';
 
 declare const NODE_SIZE = 56;
@@ -37,6 +37,8 @@ interface GenogramNode {
     label: string;
     shape: NodeShape;
     deceased: boolean;
+    /** Caller-declared: this node was annotated. Mirrors Person.annotated — never interpreted. */
+    annotated: boolean;
     /** Center of the node. */
     cx: number;
     cy: number;
@@ -64,6 +66,8 @@ interface GenogramElement {
     lineStyle: EdgeLineStyle;
     unionStyle?: UnionEdgeStyle;
     dotted?: boolean;
+    /** Caller-declared: this edge was annotated. Propagated from the source input row(s). */
+    annotated: boolean;
 }
 interface GenogramLayout {
     width: number;
@@ -109,6 +113,12 @@ interface GenogramSvgOptions {
     legend?: boolean;
     /** Display vocabulary (legend/accessibility) — English default; see locale packs. */
     labels?: GenogramSvgLabels;
+    /**
+     * Legend label for annotated elements. When provided AND at least one element or node is
+     * annotated, a legend row is added (used-keys-only). The library supplies no default —
+     * the caller owns the wording (domain-agnostic).
+     */
+    annotationLabel?: string;
 }
 /**
  * Emits a self-contained SVG for a computed genogram layout. Pure + deterministic.
@@ -135,6 +145,12 @@ interface GenogramRenderOptions extends GenogramLayoutOptions {
     legend?: boolean;
     /** Display vocabulary for the emitter (legend/accessibility) — English default. */
     svgLabels?: GenogramSvgLabels;
+    /**
+     * Verbatim legend label for caller-declared `annotated` people/unions/parentage/bonds.
+     * When set AND something is annotated, a legend row with the marker glyph + this label is
+     * added. compasso never supplies a default — the caller owns the wording (domain-specific).
+     */
+    annotationLabel?: string;
 }
 interface GenogramRenderResult {
     /** Self-contained SVG (numeric width/height + matching viewBox — PDF-embedder safe). */

package/dist/genogram/index.d.ts

@@ -1,11 +1,11 @@
-import { N as NodeShape, a as Person, c as Union, P as ParentLink, R as Relationship, d as UnionStatus, G as GenogramInput } from '../types-BnMG7TCd.js';
-export { b as PersonSex, U as UNION_STATUSES } from '../types-BnMG7TCd.js';
-import { d as KinshipLexicon, c as GenogramTitleLabels, b as GenogramSvgLabels } from '../kinship-DqEklrDN.js';
-export { G as GENOGRAM_SVG_LABELS_EN, a as GENOGRAM_TITLE_LABELS_EN, K as KINSHIP_EN, R as RelationshipMapClass, e as classifyRelationshipType, r as relationshipTypeTokens } from '../kinship-DqEklrDN.js';
-import { P as Point } from '../text-DuO_PwYw.js';
-export { C as CHAR_W, e as estimateTextWidth, w as wrapLabel } from '../text-DuO_PwYw.js';
+import { N as NodeShape, a as Person, c as Union, P as ParentLink, R as Relationship, d as UnionStatus, G as GenogramInput } from '../types-jE2fdM1t.js';
+export { b as PersonSex, U as UNION_STATUSES } from '../types-jE2fdM1t.js';
+import { d as KinshipLexicon, c as GenogramTitleLabels, b as GenogramSvgLabels } from '../kinship-BF90HyyS.js';
+export { G as GENOGRAM_SVG_LABELS_EN, a as GENOGRAM_TITLE_LABELS_EN, K as KINSHIP_EN, R as RelationshipMapClass, e as classifyRelationshipType, r as relationshipTypeTokens } from '../kinship-BF90HyyS.js';
+import { P as Point } from '../geometry-P-XGqGe7.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';
+export { C as CHAR_W, e as estimateTextWidth, w as wrapLabel } from '../text-DDVzpwPZ.js';
 export { x as xmlEscape } from '../xml-DDae1eUr.js';
 
 declare const NODE_SIZE = 56;
@@ -37,6 +37,8 @@ interface GenogramNode {
     label: string;
     shape: NodeShape;
     deceased: boolean;
+    /** Caller-declared: this node was annotated. Mirrors Person.annotated — never interpreted. */
+    annotated: boolean;
     /** Center of the node. */
     cx: number;
     cy: number;
@@ -64,6 +66,8 @@ interface GenogramElement {
     lineStyle: EdgeLineStyle;
     unionStyle?: UnionEdgeStyle;
     dotted?: boolean;
+    /** Caller-declared: this edge was annotated. Propagated from the source input row(s). */
+    annotated: boolean;
 }
 interface GenogramLayout {
     width: number;
@@ -109,6 +113,12 @@ interface GenogramSvgOptions {
     legend?: boolean;
     /** Display vocabulary (legend/accessibility) — English default; see locale packs. */
     labels?: GenogramSvgLabels;
+    /**
+     * Legend label for annotated elements. When provided AND at least one element or node is
+     * annotated, a legend row is added (used-keys-only). The library supplies no default —
+     * the caller owns the wording (domain-agnostic).
+     */
+    annotationLabel?: string;
 }
 /**
  * Emits a self-contained SVG for a computed genogram layout. Pure + deterministic.
@@ -135,6 +145,12 @@ interface GenogramRenderOptions extends GenogramLayoutOptions {
     legend?: boolean;
     /** Display vocabulary for the emitter (legend/accessibility) — English default. */
     svgLabels?: GenogramSvgLabels;
+    /**
+     * Verbatim legend label for caller-declared `annotated` people/unions/parentage/bonds.
+     * When set AND something is annotated, a legend row with the marker glyph + this label is
+     * added. compasso never supplies a default — the caller owns the wording (domain-specific).
+     */
+    annotationLabel?: string;
 }
 interface GenogramRenderResult {
     /** Self-contained SVG (numeric width/height + matching viewBox — PDF-embedder safe). */

package/dist/genogram/index.js

@@ -1,4 +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-RWPGGWO5.js';
-export { CHAR_W, EDGE_STROKE, estimateTextWidth, qualityLineStyle, wrapLabel, xmlEscape } from '../chunk-O3BT2O42.js';
+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-Z66YUOUM.js';
+export { CHAR_W, EDGE_STROKE, estimateTextWidth, qualityLineStyle, wrapLabel, xmlEscape } from '../chunk-DVLWT565.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/geometry-P-XGqGe7.d.cts

@@ -0,0 +1,8 @@
+interface Point {
+    x: number;
+    y: number;
+}
+/** "M x y L x y …" path data from a polyline. */
+declare function pathData(points: Point[]): string;
+
+export { type Point as P, pathData as p };

package/dist/geometry-P-XGqGe7.d.ts

@@ -0,0 +1,8 @@
+interface Point {
+    x: number;
+    y: number;
+}
+/** "M x y L x y …" path data from a polyline. */
+declare function pathData(points: Point[]): string;
+
+export { type Point as P, pathData as p };

package/dist/grid-BMgUSly1.d.cts

@@ -0,0 +1,79 @@
+interface CompartmentMetrics {
+    /** Shared box width (all compartments share straight vertical sides). */
+    boxW: number;
+    /** Total box height (sum of all compartment heights). */
+    boxH: number;
+    /** Per-compartment row info: the line strings, the y of the compartment's
+     *  first-line baseline region (top of the padY region above the first line),
+     *  and the font size carried through. */
+    rows: {
+        lines: string[];
+        top: number;
+        font: number;
+    }[];
+    /** Y-coordinates of internal horizontal dividers (one between each pair of
+     *  consecutive compartments). Length = compartments.length - 1. */
+    dividerYs: number[];
+}
+/**
+ * Measures a multi-compartment UML-style box.
+ *
+ * @param compartments  Ordered list of compartments (top→bottom). Each carries
+ *   its pre-wrapped `lines` and the `font` size for those lines.
+ *   An EMPTY compartment (`lines.length === 0`) still reserves one blank row of
+ *   `lineH` height so the abstract-class empty-operations divider is always drawn.
+ * @param opts
+ *   - padX   Horizontal padding inside the box (applied left + right).
+ *   - padY   Vertical padding above the first line and below the last line of
+ *            each compartment.
+ *   - lineH  Height of a single line (applies to every compartment uniformly).
+ *   - minW   Minimum box width (shared across all compartments).
+ *   - sepPad Reserved for future per-separator padding; currently unused in
+ *            geometry (dividers are flush horizontal rules) but accepted in the
+ *            signature per the brief contract.
+ */
+declare function measureCompartmentBox(compartments: {
+    lines: string[];
+    font: number;
+}[], opts: {
+    padX: number;
+    padY: number;
+    lineH: number;
+    minW: number;
+    sepPad: number;
+}): CompartmentMetrics;
+
+interface GridCell {
+    col: number;
+    row: number;
+    w: number;
+    h: number;
+}
+interface GridResult {
+    /** Center x of each cell (parallel to the input cells array). */
+    cellX: number[];
+    /** Center y of each cell (parallel to the input cells array). */
+    cellY: number[];
+    /** Width of each column (index = column index, 0 … maxCol). */
+    colW: number[];
+    /** Height of each row (index = row index, 0 … maxRow). */
+    rowH: number[];
+}
+/**
+ * Packs a set of cells into a declared 2-D grid.
+ *
+ * @param cells  Each cell declares its (col, row) position and its own (w, h).
+ *   Multiple cells may share a column or row; no two cells may share BOTH
+ *   col and row (undefined behaviour — first-write wins for column/row maxima).
+ *   Columns and rows are identified by non-negative integer indices. Sparse
+ *   grids (gaps in column or row numbering) are legal; the skipped indices
+ *   get width/height 0 and contribute zero extent.
+ * @param gaps   colGap: horizontal gutter between adjacent columns;
+ *               rowGap: vertical gutter between adjacent rows.
+ */
+declare function packGrid(cells: GridCell[], gaps: {
+    colGap: number;
+    rowGap: number;
+}): GridResult;
+
+export { type CompartmentMetrics as C, type GridCell as G, type GridResult as a, measureCompartmentBox as m, packGrid as p };

package/dist/grid-BMgUSly1.d.ts

@@ -0,0 +1,79 @@
+interface CompartmentMetrics {
+    /** Shared box width (all compartments share straight vertical sides). */
+    boxW: number;
+    /** Total box height (sum of all compartment heights). */
+    boxH: number;
+    /** Per-compartment row info: the line strings, the y of the compartment's
+     *  first-line baseline region (top of the padY region above the first line),
+     *  and the font size carried through. */
+    rows: {
+        lines: string[];
+        top: number;
+        font: number;
+    }[];
+    /** Y-coordinates of internal horizontal dividers (one between each pair of
+     *  consecutive compartments). Length = compartments.length - 1. */
+    dividerYs: number[];
+}
+/**
+ * Measures a multi-compartment UML-style box.
+ *
+ * @param compartments  Ordered list of compartments (top→bottom). Each carries
+ *   its pre-wrapped `lines` and the `font` size for those lines.
+ *   An EMPTY compartment (`lines.length === 0`) still reserves one blank row of
+ *   `lineH` height so the abstract-class empty-operations divider is always drawn.
+ * @param opts
+ *   - padX   Horizontal padding inside the box (applied left + right).
+ *   - padY   Vertical padding above the first line and below the last line of
+ *            each compartment.
+ *   - lineH  Height of a single line (applies to every compartment uniformly).
+ *   - minW   Minimum box width (shared across all compartments).
+ *   - sepPad Reserved for future per-separator padding; currently unused in
+ *            geometry (dividers are flush horizontal rules) but accepted in the
+ *            signature per the brief contract.
+ */
+declare function measureCompartmentBox(compartments: {
+    lines: string[];
+    font: number;
+}[], opts: {
+    padX: number;
+    padY: number;
+    lineH: number;
+    minW: number;
+    sepPad: number;
+}): CompartmentMetrics;
+
+interface GridCell {
+    col: number;
+    row: number;
+    w: number;
+    h: number;
+}
+interface GridResult {
+    /** Center x of each cell (parallel to the input cells array). */
+    cellX: number[];
+    /** Center y of each cell (parallel to the input cells array). */
+    cellY: number[];
+    /** Width of each column (index = column index, 0 … maxCol). */
+    colW: number[];
+    /** Height of each row (index = row index, 0 … maxRow). */
+    rowH: number[];
+}
+/**
+ * Packs a set of cells into a declared 2-D grid.
+ *
+ * @param cells  Each cell declares its (col, row) position and its own (w, h).
+ *   Multiple cells may share a column or row; no two cells may share BOTH
+ *   col and row (undefined behaviour — first-write wins for column/row maxima).
+ *   Columns and rows are identified by non-negative integer indices. Sparse
+ *   grids (gaps in column or row numbering) are legal; the skipped indices
+ *   get width/height 0 and contribute zero extent.
+ * @param gaps   colGap: horizontal gutter between adjacent columns;
+ *               rowGap: vertical gutter between adjacent rows.
+ */
+declare function packGrid(cells: GridCell[], gaps: {
+    colGap: number;
+    rowGap: number;
+}): GridResult;
+
+export { type CompartmentMetrics as C, type GridCell as G, type GridResult as a, measureCompartmentBox as m, packGrid as p };