compasso 0.3.0 → 0.4.0

package/dist/org-chart/index.d.ts

@@ -0,0 +1,168 @@
+import { e as OrgChartInput, d as OrgBoxStyle, g as OrgChartTitleLabels, f as OrgChartSvgLabels } from '../labels-RtFw9tX1.js';
+export { O as ORG_CHART_SVG_LABELS_EN, a as ORG_CHART_TITLE_LABELS_EN, b as ORG_REPORT_KINDS, c as ORG_VACANCIES, h as OrgPosition, i as OrgReport, j as OrgReportKind, k as OrgVacancy } from '../labels-RtFw9tX1.js';
+import { P as Point } from '../text-DuO_PwYw.js';
+export { e as estimateTextWidth } from '../text-DuO_PwYw.js';
+
+/** Stable machine-readable issue codes (kebab-case; part of the public contract). */
+type OrgChartIssueCode = "duplicate-id" | "unknown-manager" | "unknown-report" | "self-report" | "multiple-managers" | "assistant-has-reports" | "too-many-matrix-edges" | "cycle";
+/**
+ * Routing capacity: the max number of dotted (matrix) connections one position can be an
+ * endpoint of (as manager OR report). Each such edge must escape that box's edge to a
+ * box-free column at a distinct (column, exit-y) slot; a finite box edge holds only finitely
+ * many clean orthogonal exits, so beyond this the escape columns/exit-rows would collide.
+ * 5 is the conservative bound proven collision-free even for the shortest single-line box —
+ * a position with more matrix lines than this is rejected rather than misdrawn (the
+ * reject-don't-repair doctrine). Realistic matrix orgs sit far below it.
+ */
+declare const ORG_MAX_MATRIX_EDGES_PER_NODE = 5;
+interface OrgChartIssue {
+    code: OrgChartIssueCode;
+    message: string;
+}
+/** Thrown by computeOrgChartLayout / orgChartSvg on a structurally invalid chart. */
+declare class OrgChartValidationError extends Error {
+    readonly issues: readonly OrgChartIssue[];
+    constructor(issues: readonly OrgChartIssue[]);
+}
+/**
+ * Computes ALL validation issues for the input, deduplicated and deterministically sorted
+ * (code, then message) — array order of `positions`/`reports` never changes the result.
+ * Empty input (no positions AND no reports) is valid by definition (the renderer's
+ * empty-but-valid SVG case) and reports no issues. A forest (zero/one/many roots) is
+ * valid and never reported.
+ */
+declare function orgChartIssues(input: OrgChartInput): readonly OrgChartIssue[];
+/** Throws OrgChartValidationError (carrying ALL issues) when the input is invalid. */
+declare function validateOrgChart(input: OrgChartInput): void;
+
+/** Name line font size (px). */
+declare const ORG_LABEL_FONT = 12;
+/** Title + subtitle + vacant marker font size (px). */
+declare const ORG_TITLE_FONT = 10;
+/** Line height for stacked label lines inside a box (px). */
+declare const ORG_LABEL_LINE_H = 14;
+declare const ORG_STEM_ID_BASE = 1000000;
+declare const ORG_BUS_ID_BASE = 2000000;
+declare const ORG_DROP_ID_BASE = 3000000;
+declare const ORG_ASSIST_ID_BASE = 4000000;
+declare const ORG_DOTTED_ID_BASE = 5000000;
+type OrgElementKind = "stem" | "bus" | "drop" | "assist" | "dotted";
+interface OrgNode {
+    positionId: number;
+    /** Box center x. */
+    cx: number;
+    /** Box top y. */
+    top: number;
+    boxW: number;
+    boxH: number;
+    /** "solid" = filled, "dashed" = vacant (presentation-only derived value). */
+    style: OrgBoxStyle;
+    /** Wrapped display lines per family (drawn centered, stacked, by font size). */
+    nameLines: string[];
+    titleLines: string[];
+    subtitleLines: string[];
+    /** Localized "(vago)" marker line; null on filled boxes. */
+    vacantMarker: string | null;
+    /** True for side-branched assistant nodes (legend + harness use it). */
+    isAssistant: boolean;
+    /** Depth of the row this node lives in (assistant: its manager's row + 1 band). */
+    depth: number;
+    /** Verbatim <title> text. */
+    title: string;
+}
+interface OrgElement {
+    /** Namespaced id (ORG_*_ID_BASE + managerId / reportId / report.id). */
+    edgeId: number;
+    kind: OrgElementKind;
+    /** ≥2 waypoints, every consecutive pair axis-aligned (H or V). */
+    points: Point[];
+    /** True only on "dotted" elements. */
+    dashed: boolean;
+    /** Verbatim <title> text (woven from the title-label pack). */
+    title: string;
+}
+interface OrgChartLayout {
+    width: number;
+    height: number;
+    nodes: OrgNode[];
+    elements: OrgElement[];
+    /** Forest order, ascending id. */
+    rootPositionIds: number[];
+}
+interface OrgChartLayoutOptions {
+    /** Cap each box's DISPLAY label (compact preview); verbatim text stays in `title`. */
+    maxLabelChars?: number;
+    /** Locale pack for box/element <title>s — English default; see locale packs. */
+    titleLabels?: OrgChartTitleLabels;
+}
+/** A node's own symmetric-or-asymmetric half-extents plus its children's half-extents. */
+interface PackNode {
+    ownHalfL: number;
+    ownHalfR: number;
+    /** One entry per child, in placement order; empty = leaf. */
+    children: {
+        halfL: number;
+        halfR: number;
+    }[];
+}
+interface PackGaps {
+    siblingGap: number;
+}
+interface PackResult {
+    /** Subtree half-extents (cover the ENTIRE subtree). */
+    halfL: number;
+    halfR: number;
+    /** Center offset of each child relative to this node's center (parallel to children). */
+    offsets: number[];
+}
+/**
+ * Span-packs a node's children into disjoint horizontal intervals (the fault-tree `pack`
+ * transposed top-down). Children c1..cn: x1 = 0; x_{i+1} = x_i + halfR_i + siblingGap +
+ * halfL_{i+1}. Parent axis a = (x1 + xn)/2 — centered over its line-report block. The
+ * returned offsets are each child's center MINUS the parent axis. Subtree halfL/halfR
+ * extend ownHalf* to cover the children block. Pure + deterministic.
+ */
+declare function packSubtree(node: PackNode, gaps: PackGaps): PackResult;
+/**
+ * Deterministic, overlap-proof org-chart layout (pure function of the inputs). Validates
+ * first and THROWS OrgChartValidationError on a structurally invalid chart — never
+ * sanitizes. Empty input (no positions AND no reports) yields an empty, padded layout.
+ */
+declare function computeOrgChartLayout(input: OrgChartInput, opts?: OrgChartLayoutOptions): OrgChartLayout;
+
+interface OrgChartSvgOptions {
+    /** Set false to suppress the legend (compact preview); default true. */
+    legend?: boolean;
+    /** Display vocabulary (legend/accessibility) — English default; see locale packs. */
+    labels?: OrgChartSvgLabels;
+}
+/**
+ * Emits a self-contained SVG for a computed org-chart 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
+ * present (a solid line, an assistant, a dotted edge, a vacant box), in canonical order.
+ */
+declare function orgChartLayoutSvg(layout: OrgChartLayout, opts?: OrgChartSvgOptions): string;
+
+interface OrgChartRenderOptions extends OrgChartLayoutOptions {
+    /** Set false to suppress the legend (compact preview); default true. */
+    legend?: boolean;
+    /** Display vocabulary for the emitter (legend/accessibility) — English default. */
+    svgLabels?: OrgChartSvgLabels;
+}
+interface OrgChartRenderResult {
+    /** 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: OrgChartLayout;
+}
+/**
+ * Renders an org-chart input to a self-contained SVG string. Deterministic: same data →
+ * same SVG (array order never matters; sibling order among reports is the ascending
+ * reportId). Throws OrgChartValidationError — carrying EVERY issue, deterministically
+ * sorted — on a structurally invalid chart. Empty input yields an empty-but-valid SVG;
+ * callers decide their own empty state.
+ */
+declare function orgChartSvg(input: OrgChartInput, opts?: OrgChartRenderOptions): OrgChartRenderResult;
+
+export { ORG_ASSIST_ID_BASE, ORG_BUS_ID_BASE, ORG_DOTTED_ID_BASE, ORG_DROP_ID_BASE, ORG_LABEL_FONT, ORG_LABEL_LINE_H, ORG_MAX_MATRIX_EDGES_PER_NODE, ORG_STEM_ID_BASE, ORG_TITLE_FONT, OrgBoxStyle, OrgChartInput, type OrgChartIssue, type OrgChartIssueCode, type OrgChartLayout, type OrgChartLayoutOptions, type OrgChartRenderOptions, type OrgChartRenderResult, OrgChartSvgLabels, type OrgChartSvgOptions, OrgChartTitleLabels, OrgChartValidationError, type OrgElement, type OrgElementKind, type OrgNode, type PackGaps, type PackNode, type PackResult, Point, computeOrgChartLayout, orgChartIssues, orgChartLayoutSvg, orgChartSvg, packSubtree, validateOrgChart };

package/dist/org-chart/index.js

@@ -0,0 +1,4 @@
+export { ORG_ASSIST_ID_BASE, ORG_BUS_ID_BASE, ORG_CHART_SVG_LABELS_EN, ORG_CHART_TITLE_LABELS_EN, ORG_DOTTED_ID_BASE, ORG_DROP_ID_BASE, ORG_LABEL_FONT, ORG_LABEL_LINE_H, ORG_MAX_MATRIX_EDGES_PER_NODE, ORG_REPORT_KINDS, ORG_STEM_ID_BASE, ORG_TITLE_FONT, ORG_VACANCIES, OrgChartValidationError, computeOrgChartLayout, orgChartIssues, orgChartLayoutSvg, orgChartSvg, packSubtree, validateOrgChart } from '../chunk-UJVU7B44.js';
+export { estimateTextWidth } from '../chunk-O3BT2O42.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/org-chart/index.js.map

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

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "compasso",
-  "version": "0.3.0",
-  "description": "Standards-faithful relational and analytical diagrams (genogram, ecomap, fault tree, fishbone, pedigree, phylogenetic tree) as pure SVG strings. Deterministic, zero dependencies, server-safe.",
+  "version": "0.4.0",
+  "description": "Standards-faithful relational and analytical diagrams (genogram, ecomap, fault tree, fishbone, pedigree, phylogenetic tree, org chart) as pure SVG strings. Deterministic, zero dependencies, server-safe.",
   "license": "MIT",
   "author": "Victor Canô",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/VictorCano/compasso.git"
+    "url": "git+https://github.com/Tchori-Labs/compasso.git"
   },
   "type": "module",
   "sideEffects": false,
@@ -94,6 +94,16 @@
         "default": "./dist/phylo/index.cjs"
       }
     },
+    "./org-chart": {
+      "import": {
+        "types": "./dist/org-chart/index.d.ts",
+        "default": "./dist/org-chart/index.js"
+      },
+      "require": {
+        "types": "./dist/org-chart/index.d.cts",
+        "default": "./dist/org-chart/index.cjs"
+      }
+    },
     "./locales/pt-br": {
       "import": {
         "types": "./dist/locales/pt-br.d.ts",
@@ -108,6 +118,15 @@
   "files": [
     "dist"
   ],
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:update": "vitest run -u",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "pnpm typecheck && pnpm test && pnpm build",
+    "lint": "eslint ."
+  },
   "keywords": [
     "genogram",
     "ecomap",
@@ -119,6 +138,10 @@
     "phylogenetics",
     "cladogram",
     "phylogram",
+    "org-chart",
+    "organogram",
+    "organizational-chart",
+    "hierarchy",
     "svg",
     "diagram",
     "mcgoldrick",
@@ -128,6 +151,7 @@
   "engines": {
     "node": ">=18"
   },
+  "packageManager": "pnpm@10.33.2",
   "devDependencies": {
     "@types/node": "^24",
     "eslint": "^10.4.1",
@@ -135,12 +159,5 @@
     "typescript": "^5",
     "typescript-eslint": "^8.61.0",
     "vitest": "4.1.8"
-  },
-  "scripts": {
-    "build": "tsup",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "typecheck": "tsc --noEmit",
-    "lint": "eslint ."
   }
-}
+}