labre-mcp 0.1.0

package/dist/lib/mcp-notifications.mjs

@@ -0,0 +1,130 @@
+// MCP Log Notification utility
+//
+// Sends JSON-RPC 2.0 notifications (method: "notifications/message") to stdout,
+// following the MCP specification for server-initiated log messages.
+//
+// These notifications are fire-and-forget (no id, no response expected).
+// They allow MCP clients (e.g., Claude Code) to display real-time progress
+// during tool execution.
+//
+// Verbose mode:
+//   Debug-level messages are only emitted when verbose mode is enabled.
+//   Toggle via environment variable WARDLEY_VERBOSE=1 (or "true"/"yes")
+//   or programmatically with setVerbose(true/false).
+//   Info, warning, and error levels are always emitted regardless of this flag.
+//
+// Spec: https://modelcontextprotocol.io/specification — Logging
+//
+// Usage:
+//   import { sendLog, logInfo, logDebug, logError, setVerbose, isVerbose } from './mcp-notifications.mjs';
+//   logInfo('estimateEvolution', 'Starting evaluation for "ERP"');
+//   logDebug('estimateEvolution', 'Parsing input...'); // only if verbose
+// ─── Log Levels ─────────────────────────────────────────────────────────────
+/** Valid MCP log levels (subset used by this project). */
+export const LOG_LEVELS = ['debug', 'info', 'warning', 'error'];
+// ─── Verbose Mode ───────────────────────────────────────────────────────────
+/**
+ * Resolve the initial verbose state from environment variable WARDLEY_VERBOSE.
+ * Accepts "1", "true", or "yes" (case-insensitive) as truthy values.
+ */
+function resolveVerboseFromEnv() {
+    const raw = (process.env.WARDLEY_VERBOSE ?? '').trim().toLowerCase();
+    return raw === '1' || raw === 'true' || raw === 'yes';
+}
+/** Internal verbose flag — mutable via setVerbose(). */
+let _verbose = resolveVerboseFromEnv();
+export function setVerbose(enabled) {
+    _verbose = Boolean(enabled);
+}
+/**
+ * Returns the current verbose mode state.
+ *
+ * @returns {boolean} true if debug-level messages will be emitted
+ */
+export function isVerbose() {
+    return _verbose;
+}
+// ─── Core Send Function ─────────────────────────────────────────────────────
+/**
+ * Send an MCP log notification to stdout.
+ *
+ * Emits both:
+ *   - notifications/claude/channel (for Claude Code chat visibility)
+ *   - notifications/message (standard MCP logging, for other clients)
+ *
+ * @param {string} level - Log level: 'debug' | 'info' | 'warning' | 'error'
+ * @param {string} logger - Logger name (typically the tool name)
+ * @param {string} data - Human-readable log message
+ */
+export function sendLog(level, logger, data) {
+    // Channel notification — visible in Claude Code chat
+    const channel = {
+        jsonrpc: '2.0',
+        method: 'notifications/claude/channel',
+        params: {
+            content: data,
+            meta: {
+                level,
+                tool: logger,
+            },
+        },
+    };
+    process.stdout.write(JSON.stringify(channel) + '\n');
+    // Standard MCP log — for non-Claude clients
+    const standard = {
+        jsonrpc: '2.0',
+        method: 'notifications/message',
+        params: {
+            level,
+            logger,
+            data,
+        },
+    };
+    process.stdout.write(JSON.stringify(standard) + '\n');
+}
+// ─── Convenience Helpers ────────────────────────────────────────────────────
+/**
+ * Send an info-level log notification.
+ * Use for start/end of tool invocations.
+ *
+ * @param {string} logger - Logger name (tool name)
+ * @param {string} message - Human-readable message
+ */
+export function logInfo(logger, message) {
+    sendLog('info', logger, message);
+}
+/**
+ * Send a debug-level log notification.
+ * Use for intermediate steps (parsing, LLM calls, strategy evaluation).
+ *
+ * **Only emitted when verbose mode is enabled** (WARDLEY_VERBOSE=1 or setVerbose(true)).
+ * When verbose mode is off, this function is a no-op.
+ *
+ * @param {string} logger - Logger name (tool name)
+ * @param {string} message - Human-readable message
+ */
+export function logDebug(logger, message) {
+    if (!_verbose)
+        return;
+    sendLog('debug', logger, message);
+}
+/**
+ * Send an error-level log notification.
+ * Use for LLM errors, timeouts, rate limits, API failures.
+ *
+ * @param {string} logger - Logger name (tool name)
+ * @param {string} message - Human-readable error description
+ */
+export function logError(logger, message) {
+    sendLog('error', logger, message);
+}
+/**
+ * Send a warning-level log notification.
+ *
+ * @param {string} logger - Logger name (tool name)
+ * @param {string} message - Human-readable warning
+ */
+export function logWarning(logger, message) {
+    sendLog('warning', logger, message);
+}
+//# sourceMappingURL=mcp-notifications.mjs.map

package/dist/lib/mcp-notifications.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-notifications.mjs","sourceRoot":"","sources":["../../src/lib/mcp-notifications.mts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,EAAE;AACF,gFAAgF;AAChF,qEAAqE;AACrE,EAAE;AACF,yEAAyE;AACzE,2EAA2E;AAC3E,yBAAyB;AACzB,EAAE;AACF,gBAAgB;AAChB,wEAAwE;AACxE,wEAAwE;AACxE,qDAAqD;AACrD,gFAAgF;AAChF,EAAE;AACF,gEAAgE;AAChE,EAAE;AACF,SAAS;AACT,2GAA2G;AAC3G,mEAAmE;AACnE,0EAA0E;AAE1E,+EAA+E;AAE/E,0DAA0D;AAC1D,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;AAEhE,+EAA+E;AAE/E;;;GAGG;AACH,SAAS,qBAAqB;IAC5B,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrE,OAAO,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,KAAK,CAAC;AACxD,CAAC;AAED,wDAAwD;AACxD,IAAI,QAAQ,GAAG,qBAAqB,EAAE,CAAC;AAUvC,MAAM,UAAU,UAAU,CAAC,OAAgB;IACzC,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAC9B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS;IACvB,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,+EAA+E;AAE/E;;;;;;;;;;GAUG;AACH,MAAM,UAAU,OAAO,CAAC,KAAe,EAAE,MAAc,EAAE,IAAY;IACnE,qDAAqD;IACrD,MAAM,OAAO,GAAG;QACd,OAAO,EAAE,KAAK;QACd,MAAM,EAAE,8BAA8B;QACtC,MAAM,EAAE;YACN,OAAO,EAAE,IAAI;YACb,IAAI,EAAE;gBACJ,KAAK;gBACL,IAAI,EAAE,MAAM;aACb;SACF;KACF,CAAC;IACF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IAErD,4CAA4C;IAC5C,MAAM,QAAQ,GAAG;QACf,OAAO,EAAE,KAAK;QACd,MAAM,EAAE,uBAAuB;QAC/B,MAAM,EAAE;YACN,KAAK;YACL,MAAM;YACN,IAAI;SACL;KACF,CAAC;IACF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC;AACxD,CAAC;AAED,+EAA+E;AAE/E;;;;;;GAMG;AACH,MAAM,UAAU,OAAO,CAAC,MAAc,EAAE,OAAe;IACrD,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AACnC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAc,EAAE,OAAe;IACtD,IAAI,CAAC,QAAQ;QAAE,OAAO;IACtB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AACpC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAc,EAAE,OAAe;IACtD,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AACpC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,MAAc,EAAE,OAAe;IACxD,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AACtC,CAAC"}

package/dist/lib/owm/analytical-geometry.d.mts

@@ -0,0 +1,26 @@
+import type { PositionedValueChain } from '../../types/value-chain.mjs';
+import type { EmitOwmOptions } from '#work-on-value-chain/write/chain/lib/emit/emit-owm.mjs';
+import { type SvgGeometry } from './svg-bbox-parser.mjs';
+/** Default visible map width when DSL omits `size [w, h]`. Matches
+ *  cli-owm's `options?.width ?? 500`. */
+export declare const DEFAULT_MAP_WIDTH = 500;
+/** Default visible map height when DSL omits `size [w, h]`. */
+export declare const DEFAULT_MAP_HEIGHT = 600;
+/** SVG outer width = mapWidth + horizontal padding (35 left + 70
+ *  right axis area). Matches cli-owm `svgWidth = width + 105`. */
+export declare const SVG_PADDING_X = 105;
+/** SVG outer height = mapHeight + vertical padding (45 top axis +
+ *  92 bottom axis labels). Matches cli-owm `svgHeight = height + 137`. */
+export declare const SVG_PADDING_Y = 137;
+/**
+ * Compute the SvgGeometry that cli-owm would produce for `chain`,
+ * without actually invoking cli-owm. Output shape is byte-equivalent
+ * to `parseSvgGeometry(adapter.render(generateChainOwmSyntax(chain,
+ * emitOpts)))` modulo float-rounding noise (tolerance ≤ 1 px).
+ *
+ * Items are emitted in the chain.components order (anchors and
+ * components interleaved). The downstream overlap detector is order-
+ * agnostic.
+ */
+export declare function computeGeometry(chain: PositionedValueChain, emitOpts: EmitOwmOptions): SvgGeometry;
+//# sourceMappingURL=analytical-geometry.d.mts.map

package/dist/lib/owm/analytical-geometry.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytical-geometry.d.mts","sourceRoot":"","sources":["../../../src/lib/owm/analytical-geometry.mts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EACV,oBAAoB,EAErB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wDAAwD,CAAC;AAC7F,OAAO,EASL,KAAK,WAAW,EAEjB,MAAM,uBAAuB,CAAC;AAI/B;yCACyC;AACzC,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC,+DAA+D;AAC/D,eAAO,MAAM,kBAAkB,MAAM,CAAC;AACtC;kEACkE;AAClE,eAAO,MAAM,aAAa,MAAM,CAAC;AACjC;0EAC0E;AAC1E,eAAO,MAAM,aAAa,MAAM,CAAC;AA6BjC;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,oBAAoB,EAC3B,QAAQ,EAAE,cAAc,GACvB,WAAW,CA4Db"}

package/dist/lib/owm/analytical-geometry.mjs

@@ -0,0 +1,116 @@
+// Pure-JS replacement for `parseSvgGeometry(adapter.render(emit(chain)))`.
+// Computes the same `SvgGeometry` shape directly from the
+// `PositionedValueChain` + `EmitOwmOptions`, without invoking
+// cli-owm. Phase 6 of the verify-layout plan.
+//
+// This module exists because cli-owm is fully deterministic — circles
+// at `(maturity × W, (1 - visibility) × H)`, labels at
+// `(circle.x + dx, circle.y + dy)`, anchors as `text-anchor="middle"`
+// at the same circle coordinates. So we can predict every pixel from
+// the chain alone and skip the SVG render entirely. The vendor smoke
+// test (`src/lib/vendor/cli-owm/__smoke.test.mts`) and the regression
+// test (`analytical-geometry.test.mts`) jointly guarantee the
+// analytical model stays faithful to cli-owm's output.
+//
+// Constants captured from `src/lib/vendor/cli-owm/render.mts:69-77`
+// at commit `4950f330`. A future bump of the vendor will require
+// re-validating the constants below.
+import { LABEL_CHAR_WIDTH, LABEL_HEIGHT, COMPONENT_RADIUS, PHASE_AXIS_RATIOS, } from './svg-bbox-parser.mjs';
+// ─── Constants matching cli-owm 4950f330 ───────────────────────────────
+/** Default visible map width when DSL omits `size [w, h]`. Matches
+ *  cli-owm's `options?.width ?? 500`. */
+export const DEFAULT_MAP_WIDTH = 500;
+/** Default visible map height when DSL omits `size [w, h]`. */
+export const DEFAULT_MAP_HEIGHT = 600;
+/** SVG outer width = mapWidth + horizontal padding (35 left + 70
+ *  right axis area). Matches cli-owm `svgWidth = width + 105`. */
+export const SVG_PADDING_X = 105;
+/** SVG outer height = mapHeight + vertical padding (45 top axis +
+ *  92 bottom axis labels). Matches cli-owm `svgHeight = height + 137`. */
+export const SVG_PADDING_Y = 137;
+// ─── Coordinate helpers (mirror cli-owm:render.ts) ─────────────────────
+function maturityToX(maturity, width) {
+    return maturity * width;
+}
+function visibilityToY(visibility, height) {
+    return (1 - visibility) * height;
+}
+// ─── Bbox builders (identical to svg-bbox-parser private helpers) ──────
+function circleBbox(cx, cy, r) {
+    return { x: cx - r, y: cy - r, width: 2 * r, height: 2 * r };
+}
+function textBbox(x, y, anchor, content) {
+    const width = Math.max(1, content.length) * LABEL_CHAR_WIDTH;
+    const top = y - (LABEL_HEIGHT - 2);
+    const left = anchor === 'middle' ? x - width / 2
+        : anchor === 'end' ? x - width
+            : /* start */ x;
+    return { x: left, y: top, width, height: LABEL_HEIGHT };
+}
+// ─── Public API ─────────────────────────────────────────────────────────
+/**
+ * Compute the SvgGeometry that cli-owm would produce for `chain`,
+ * without actually invoking cli-owm. Output shape is byte-equivalent
+ * to `parseSvgGeometry(adapter.render(generateChainOwmSyntax(chain,
+ * emitOpts)))` modulo float-rounding noise (tolerance ≤ 1 px).
+ *
+ * Items are emitted in the chain.components order (anchors and
+ * components interleaved). The downstream overlap detector is order-
+ * agnostic.
+ */
+export function computeGeometry(chain, emitOpts) {
+    const mapWidth = emitOpts.size?.width ?? DEFAULT_MAP_WIDTH;
+    const mapHeight = emitOpts.size?.height ?? DEFAULT_MAP_HEIGHT;
+    const canvas = {
+        width: mapWidth + SVG_PADDING_X,
+        height: mapHeight + SVG_PADDING_Y,
+    };
+    const mapArea = { x: 0, y: 0, width: mapWidth, height: mapHeight };
+    const phaseAxes = PHASE_AXIS_RATIOS.map(r => mapArea.x + r * mapArea.width);
+    const items = [];
+    const positions = new Map();
+    for (const c of chain.components) {
+        const cx = maturityToX(c.evolution, mapWidth);
+        const cy = visibilityToY(c.visibility, mapHeight);
+        positions.set(c.name, { cx, cy });
+        if (c.role === 'anchor') {
+            // cli-owm renders anchors as `text-anchor="middle"` text at (cx, cy).
+            items.push({
+                name: c.name,
+                kind: 'anchor',
+                bbox: textBbox(cx, cy, 'middle', c.name),
+            });
+            continue;
+        }
+        // Components: circle + label. cli-owm's default label offset when
+        // missing is (5, -10) but the chain pipeline always assigns one
+        // via place-labels.mts.
+        items.push({
+            name: c.name,
+            kind: 'component',
+            bbox: circleBbox(cx, cy, COMPONENT_RADIUS),
+        });
+        const dx = c.label?.dx ?? 5;
+        const dy = c.label?.dy ?? -10;
+        items.push({
+            name: c.name,
+            kind: 'label',
+            bbox: textBbox(cx + dx, cy + dy, 'start', c.name),
+        });
+    }
+    const edges = [];
+    for (const link of chain.links) {
+        const from = positions.get(link.from);
+        const to = positions.get(link.to);
+        if (!from || !to)
+            continue;
+        edges.push({
+            from: link.from,
+            to: link.to,
+            x1: from.cx, y1: from.cy,
+            x2: to.cx, y2: to.cy,
+        });
+    }
+    return { items, edges, canvas, mapArea, phaseAxes };
+}
+//# sourceMappingURL=analytical-geometry.mjs.map

package/dist/lib/owm/analytical-geometry.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytical-geometry.mjs","sourceRoot":"","sources":["../../../src/lib/owm/analytical-geometry.mts"],"names":[],"mappings":"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"}

package/dist/lib/owm/cli-owm-adapter.d.mts

@@ -0,0 +1,5 @@
+import type { OwmRenderAdapter } from './render-adapter.mjs';
+export declare class CliOwmAdapter implements OwmRenderAdapter {
+    render(dsl: string): string;
+}
+//# sourceMappingURL=cli-owm-adapter.d.mts.map

package/dist/lib/owm/cli-owm-adapter.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-owm-adapter.d.mts","sourceRoot":"","sources":["../../../src/lib/owm/cli-owm-adapter.mts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,qBAAa,aAAc,YAAW,gBAAgB;IACpD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;CAQ5B"}

package/dist/lib/owm/cli-owm-adapter.mjs

@@ -0,0 +1,26 @@
+// Concrete OwmRenderAdapter backed by the vendored cli-owm renderer
+// (src/lib/vendor/cli-owm). This is the ONLY file in the project that
+// imports the vendored renderer directly — every other consumer goes
+// through the OwmRenderAdapter interface.
+//
+// Canvas sizing: cli-owm's `render()` accepts width/height options
+// but its own parser does NOT auto-feed `map.presentation.size` (the
+// `size [w, h]` directive in the DSL) into them. We do that here so
+// the rendered SVG honours the DSL canvas, matching what
+// onlinewardleymaps.com does. When the DSL omits `size`, the parser
+// returns `{ width: 0, height: 0 }` and we fall back to cli-owm's
+// internal defaults (500×600) by passing no options.
+import { parse, render } from '../vendor/cli-owm/index.mjs';
+export class CliOwmAdapter {
+    render(dsl) {
+        const map = parse(dsl);
+        const sz = map.presentation?.size;
+        const opts = {};
+        if (sz && sz.width > 0)
+            opts.width = sz.width;
+        if (sz && sz.height > 0)
+            opts.height = sz.height;
+        return render(map, opts);
+    }
+}
+//# sourceMappingURL=cli-owm-adapter.mjs.map

package/dist/lib/owm/cli-owm-adapter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-owm-adapter.mjs","sourceRoot":"","sources":["../../../src/lib/owm/cli-owm-adapter.mts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,sEAAsE;AACtE,qEAAqE;AACrE,0CAA0C;AAC1C,EAAE;AACF,mEAAmE;AACnE,qEAAqE;AACrE,oEAAoE;AACpE,yDAAyD;AACzD,oEAAoE;AACpE,kEAAkE;AAClE,qDAAqD;AAErD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAG5D,MAAM,OAAO,aAAa;IACxB,MAAM,CAAC,GAAW;QAChB,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QACvB,MAAM,EAAE,GAAG,GAAG,CAAC,YAAY,EAAE,IAAI,CAAC;QAClC,MAAM,IAAI,GAAwC,EAAE,CAAC;QACrD,IAAI,EAAE,IAAI,EAAE,CAAC,KAAK,GAAI,CAAC;YAAE,IAAI,CAAC,KAAK,GAAI,EAAE,CAAC,KAAK,CAAC;QAChD,IAAI,EAAE,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;YAAE,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC,MAAM,CAAC;QACjD,OAAO,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC3B,CAAC;CACF"}

package/dist/lib/owm/overlap-detector.d.mts

@@ -0,0 +1,93 @@
+import type { Bbox, Canvas, EdgeSegment, GeometryItem, GeometryReport, SvgGeometry } from './svg-bbox-parser.mjs';
+/** Threshold (px²) below which a rect-rect overlap area is treated as
+ *  zero (anti-jitter against floating-point noise from text bbox
+ *  approximation). */
+export declare const OVERLAP_THRESHOLD_PX = 1;
+/** Threshold (px) below which a label↔edge crossing length is treated
+ *  as zero (segment grazes the label corner). */
+export declare const EDGE_CROSSING_THRESHOLD_PX = 1;
+/** Minimum visual gap between a label and any other rendered element
+ *  (another label, a foreign component circle, or a foreign anchor
+ *  text). Below this, the elements feel visually merged and the
+ *  detector emits a `label-spacing` soft violation. Set to 1.5 ×
+ *  LABEL_HEIGHT (24 px) per user calibration on 2026-05-06 — a label
+ *  17 px from a foreign circle was reported as ambiguous, so 16 px
+ *  was too lax. */
+export declare const MIN_LABEL_SPACING_PX = 24;
+export type OverlapKind = 'anchor-anchor' | 'anchor-component' | 'anchor-label' | 'component-component' | 'component-label' | 'label-label' | 'label-canvas' | 'label-edge' | 'label-spacing' | 'label-axis';
+/** Synthetic geometry item used for non-rect targets in overlap
+ *  reports (canvas, edges, phase axes). Has the same shape as
+ *  `GeometryItem` so consumers can treat the `b` side uniformly. */
+export interface SyntheticGeometry {
+    name: string;
+    kind: 'canvas' | 'edge' | 'axis';
+    bbox: Bbox;
+}
+export interface Overlap {
+    /** Always a parsed GeometryItem (component / label / anchor). */
+    a: GeometryItem;
+    /** Either another GeometryItem (rect-rect overlap) or a synthetic
+     *  item for canvas-overflow, edge-crossing, or phase-axis-crossing
+     *  reports. The synthetic bbox is the offending region. */
+    b: GeometryItem | SyntheticGeometry;
+    kind: OverlapKind;
+    /** Pixel² for rect-rect, pixel² of overflow for canvas, pixel
+     *  length for edge crossings, slack-to-min for label-spacing,
+     *  bbox-axis crossing width for label-axis. */
+    severity: number;
+}
+/**
+ * Chebyshev gap between two axis-aligned rectangles : the larger of
+ * the horizontal and vertical separations. Returns 0 when the
+ * rectangles overlap. This metric matches the way labels feel
+ * visually distinct: two labels diagonally offset by (5, 5) are as
+ * visually merged as two side-by-side at (5, 0).
+ */
+export declare function rectGap(a: Bbox, b: Bbox): number;
+/**
+ * How much of `bbox` is on each side of the vertical line `axisX`,
+ * doubled. A label centered exactly on the axis returns its full
+ * width ; a label barely grazing the axis returns near-0. Returns
+ * 0 when the axis does not pierce the bbox.
+ */
+export declare function bboxAxisCrossingWidth(bbox: Bbox, axisX: number): number;
+/**
+ * Area (px²) of `bbox` that falls outside the rectangle
+ * `[0, 0, canvas.width, canvas.height]`. Returns 0 when canvas is
+ * undefined (width or height ≤ 0) — caller should treat that as
+ * "canvas constraint not applicable" rather than "no overflow".
+ */
+export declare function bboxOutsideCanvasArea(bbox: Bbox, canvas: Canvas): number;
+/**
+ * True iff the segment from (seg.x1, seg.y1) to (seg.x2, seg.y2)
+ * intersects the axis-aligned rectangle `rect`. Considers both
+ * endpoint-inside and segment-crossing-edge cases.
+ */
+export declare function segmentRectIntersects(seg: EdgeSegment, rect: Bbox): boolean;
+/**
+ * Pixel length of the portion of `seg` that lies inside `rect`,
+ * computed via Liang-Barsky parametric clipping. Returns 0 when the
+ * segment misses the rectangle entirely.
+ */
+export declare function segmentInRectLength(seg: EdgeSegment, rect: Bbox): number;
+/**
+ * V2 — pairwise rectangle overlap detection over a flat geometry
+ * report. Self-overlaps (same `name` + `kind`) are filtered out, but
+ * unlike V2 we DO report (component, label) pairs of the same name —
+ * the V3 business rule says a label must not overlap any node circle,
+ * including its own. Sorted by descending severity.
+ */
+export declare function detectOverlaps(geometry: GeometryReport): Overlap[];
+/**
+ * V3 — full overlap pass over `SvgGeometry`. Combines:
+ *   - `detectOverlaps` (rect-rect)
+ *   - canvas-overflow per label
+ *   - label↔edge crossings, skipping edges incident to the label's
+ *     own component
+ *
+ * Returned list is sorted by descending severity. Severity unit
+ * differs by kind (px² for rect-rect and canvas, px for edges) — the
+ * caller weights them with HARD/SOFT penalties.
+ */
+export declare function detectAllOverlaps(geometry: SvgGeometry): Overlap[];
+//# sourceMappingURL=overlap-detector.d.mts.map

package/dist/lib/owm/overlap-detector.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlap-detector.d.mts","sourceRoot":"","sources":["../../../src/lib/owm/overlap-detector.mts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EACV,IAAI,EACJ,MAAM,EACN,WAAW,EACX,YAAY,EACZ,cAAc,EACd,WAAW,EACZ,MAAM,uBAAuB,CAAC;AAE/B;;sBAEsB;AACtB,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAEtC;iDACiD;AACjD,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAE5C;;;;;;mBAMmB;AACnB,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC,MAAM,MAAM,WAAW,GACnB,eAAe,GACf,kBAAkB,GAClB,cAAc,GACd,qBAAqB,GACrB,iBAAiB,GACjB,aAAa,GACb,cAAc,GACd,YAAY,GACZ,eAAe,GACf,YAAY,CAAC;AAEjB;;oEAEoE;AACpE,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;IACjC,IAAI,EAAE,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,OAAO;IACtB,iEAAiE;IACjE,CAAC,EAAE,YAAY,CAAC;IAChB;;+DAE2D;IAC3D,CAAC,EAAE,YAAY,GAAG,iBAAiB,CAAC;IACpC,IAAI,EAAE,WAAW,CAAC;IAClB;;mDAE+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAaD;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,GAAG,MAAM,CAIhD;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGvE;AAWD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAWxE;AAsBD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAS3E;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,GAAG,MAAM,CA+BxE;AAkCD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,EAAE,CAiBlE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO,EAAE,CAgFlE"}