labre-mcp 0.1.0

package/dist/frameworks/wardley/chain/_legacy/write/chain/lib/layout/adjust-x.mjs

@@ -0,0 +1,224 @@
+// Step 4 of the write:chain:* pipeline — deterministic X adjustment for
+// READABILITY around the LLM-proposed `xHint`.
+//
+// Contract: the LLM (step 2, generate-chain) emits an inline `xHint` per
+// component for visual clarity (NOT evolution maturity — that is a phase 3
+// concern, hidden here). This step preserves the LLM's intent within a
+// tolerance band of ±BAND_HALF, while enforcing four readability invariants:
+//
+//   1. Initialisation
+//      X(c) = c.xHint                                         (or fallback)
+//      X_anchor(c) = X(c)                                     (band centre)
+//      Clamp to [LEFT_BOUND, RIGHT_BOUND].
+//      When xHint is undefined (LLM degradation or per-component miss),
+//      fall back to a uniform spread within the component's Y level so
+//      orphans do not all collapse to a single X.
+//
+//   2. Supplier alignment (parents↔children)
+//      A "supplier" c with ≥ 2 consumers (components A such that A → c) is
+//      recentred on the mean X of those consumers, capped to the band
+//      [X_anchor − BAND_HALF, X_anchor + BAND_HALF]. Single-consumer
+//      suppliers and orphans keep X_anchor.
+//      Pass order: top-down by Y descending (consumers first), so each
+//      supplier sees the post-pass X of its consumers.
+//
+//   3. Anti-collision
+//      Within each Y level (|ΔY| < EDGE_GAP_Y), sort by current X
+//      ascending and sweep left-to-right enforcing MIN_GAP_X between
+//      consecutive components. Pushing past X_anchor + BAND_HALF emits a
+//      warning on the ambient collector but the push is still applied
+//      (the unicity invariant for (X, Y) takes precedence over band
+//      preservation).
+//
+//   4. Map width
+//      mapWidth scales with the densest ±DENSITY_WINDOW_HALF horizontal
+//      window. Mirrors the canvas-height rule in compute-visibility:
+//      width grows linearly above a saturation count.
+//
+// Anchors traverse this pipeline like any other component (rule D2):
+// the legacy 0.5 pinning is gone. Multi-anchor X collisions are resolved
+// by the LLM xHint heuristic in step 2 (generate-chain), which assigns
+// distinct buckets per anchor.
+import { getCurrentCollector } from '#lib/degradation/index.mjs';
+import { EDGE_MIN_GAP } from './compute-visibility.mjs';
+// ─── Constants ──────────────────────────────────────────────────────────
+export const LEFT_BOUND = 0.10;
+export const RIGHT_BOUND = 0.90;
+/** Tolerance band around X_anchor (the LLM-proposed xHint). */
+export const BAND_HALF = 0.10;
+/** Minimum X gap between two components sharing a Y level. */
+export const MIN_GAP_X = 0.02;
+/** Half-width of the sliding window used for horizontal density. */
+export const DENSITY_WINDOW_HALF = 0.05;
+/** Strict threshold on K above which mapWidth is scaled. */
+export const DENSITY_LIMIT_K = 4;
+/** Reference window count used to compute the width scale factor. */
+export const DENSITY_REFERENCE_K = 5;
+export const BASE_CANVAS_WIDTH = 1216;
+/** Y delta below which two components are considered "at the same level"
+ *  for anti-collision purposes. Aligned with the EDGE_MIN_GAP invariant
+ *  enforced upstream by compute-visibility. */
+export const EDGE_GAP_Y = EDGE_MIN_GAP;
+// ─── Helpers ────────────────────────────────────────────────────────────
+function clamp(x, lo, hi) {
+    if (x < lo)
+        return lo;
+    if (x > hi)
+        return hi;
+    return x;
+}
+function warn(source, message) {
+    const collector = getCurrentCollector();
+    if (collector) {
+        collector.recordError(source, new Error(message), {
+            recoverable: true,
+            severity: 'warning',
+        });
+    }
+}
+/** Group components by approximate Y level (within EDGE_GAP_Y). Returns
+ *  groups in arbitrary order; ordering inside a group is preserved. */
+function groupByYLevel(components) {
+    const sorted = [...components].sort((a, b) => b.visibility - a.visibility);
+    const groups = [];
+    for (const c of sorted) {
+        const last = groups[groups.length - 1];
+        if (last && Math.abs(last[0].visibility - c.visibility) < EDGE_GAP_Y) {
+            last.push(c);
+        }
+        else {
+            groups.push([c]);
+        }
+    }
+    return groups;
+}
+/** Initial X for a component: xHint clamped, or a uniform per-Y-level
+ *  spread when xHint is missing. The fallback mirrors the legacy
+ *  initialSpread behaviour just enough to give the deterministic passes
+ *  something to work with. */
+function initialX(components) {
+    const out = new Map();
+    // First pass — honour every defined xHint.
+    for (const c of components) {
+        if (typeof c.xHint === 'number') {
+            out.set(c.name, clamp(c.xHint, LEFT_BOUND, RIGHT_BOUND));
+        }
+    }
+    // Second pass — uniform per-level spread for components with no hint.
+    // Spread positions inside each level, skipping slots already occupied
+    // by hinted siblings so the fallback doesn't trample the LLM intent.
+    const groups = groupByYLevel(components);
+    for (const group of groups) {
+        const missing = group.filter(c => !out.has(c.name));
+        if (missing.length === 0)
+            continue;
+        const n = missing.length;
+        if (n === 1) {
+            out.set(missing[0].name, (LEFT_BOUND + RIGHT_BOUND) / 2);
+            continue;
+        }
+        for (let i = 0; i < n; i++) {
+            const x = LEFT_BOUND + ((RIGHT_BOUND - LEFT_BOUND) * i) / (n - 1);
+            out.set(missing[i].name, x);
+        }
+    }
+    return out;
+}
+/** Pass 2 — supplier alignment. */
+function alignSuppliers(chain, x, xAnchor) {
+    const consumers = new Map();
+    for (const c of chain.components)
+        consumers.set(c.name, []);
+    for (const link of chain.links) {
+        consumers.get(link.to)?.push(link.from);
+    }
+    // Top-down by Y descending — consumers (higher Y) settled before suppliers.
+    const order = [...chain.components].sort((a, b) => b.visibility - a.visibility);
+    for (const c of order) {
+        const cons = consumers.get(c.name) ?? [];
+        if (cons.length < 2)
+            continue;
+        const xs = [];
+        for (const n of cons) {
+            const xn = x.get(n);
+            if (xn !== undefined)
+                xs.push(xn);
+        }
+        if (xs.length < 2)
+            continue;
+        const target = xs.reduce((s, v) => s + v, 0) / xs.length;
+        const anchor = xAnchor.get(c.name) ?? target;
+        const constrained = clamp(target, anchor - BAND_HALF, anchor + BAND_HALF);
+        x.set(c.name, clamp(constrained, LEFT_BOUND, RIGHT_BOUND));
+    }
+}
+/** Pass 3 — anti-collision sweep within each Y level. */
+function antiCollision(chain, x, xAnchor) {
+    const groups = groupByYLevel(chain.components);
+    for (const group of groups) {
+        if (group.length < 2)
+            continue;
+        const sorted = [...group].sort((a, b) => {
+            const ax = x.get(a.name) ?? 0;
+            const bx = x.get(b.name) ?? 0;
+            return ax - bx || a.name.localeCompare(b.name);
+        });
+        for (let i = 1; i < sorted.length; i++) {
+            const prev = sorted[i - 1];
+            const curr = sorted[i];
+            const prevX = x.get(prev.name) ?? 0;
+            const currX = x.get(curr.name) ?? 0;
+            if (currX - prevX >= MIN_GAP_X)
+                continue;
+            const desired = prevX + MIN_GAP_X;
+            const anchor = xAnchor.get(curr.name) ?? desired;
+            if (desired > anchor + BAND_HALF || desired > RIGHT_BOUND) {
+                warn('write-chain:adjust-x', `anti-collision pushed "${curr.name}" past its tolerance band ` +
+                    `to clear "${prev.name}" at y=${curr.visibility.toFixed(3)}`);
+            }
+            x.set(curr.name, clamp(desired, LEFT_BOUND, RIGHT_BOUND));
+        }
+    }
+}
+/** Pass 4 — densest ±DENSITY_WINDOW_HALF window count, drives mapWidth. */
+function computeMapWidth(x) {
+    const xs = [...x.values()].sort((a, b) => a - b);
+    if (xs.length === 0)
+        return BASE_CANVAS_WIDTH;
+    let kMax = 0;
+    let left = 0;
+    for (let right = 0; right < xs.length; right++) {
+        while (xs[right] - xs[left] > 2 * DENSITY_WINDOW_HALF)
+            left++;
+        const count = right - left + 1;
+        if (count > kMax)
+            kMax = count;
+    }
+    if (kMax <= DENSITY_LIMIT_K)
+        return BASE_CANVAS_WIDTH;
+    return Math.ceil((BASE_CANVAS_WIDTH * kMax) / DENSITY_REFERENCE_K);
+}
+/**
+ * Adjust X for readability around the LLM-proposed xHint and compute the
+ * required canvas width. Returns a new chain (input is not mutated); the
+ * `evolution` field carries the final X coordinate.
+ */
+export function adjustX(chain) {
+    const x = initialX(chain.components);
+    const xAnchor = new Map(x);
+    alignSuppliers(chain, x, xAnchor);
+    antiCollision(chain, x, xAnchor);
+    const width = computeMapWidth(x);
+    return {
+        chain: {
+            metadata: chain.metadata,
+            links: chain.links,
+            components: chain.components.map(c => ({
+                ...c,
+                evolution: clamp(x.get(c.name) ?? c.evolution, LEFT_BOUND, RIGHT_BOUND),
+            })),
+        },
+        mapSize: { width },
+    };
+}
+//# sourceMappingURL=adjust-x.mjs.map

package/dist/frameworks/wardley/chain/_legacy/write/chain/lib/layout/adjust-x.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"adjust-x.mjs","sourceRoot":"","sources":["../../../../../../../../../src/frameworks/wardley/chain/_legacy/write/chain/lib/layout/adjust-x.mts"],"names":[],"mappings":"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"}

package/dist/frameworks/wardley/chain/_legacy/write/chain/lib/layout/canonical-snap.d.mts

@@ -0,0 +1,41 @@
+import type { LabelOffset, PositionedValueChain } from '#types/value-chain.mjs';
+import type { EmitOwmOptions } from '../emit/emit-owm.mjs';
+/** Pixel gap between the right edge of a left-aligned label and the
+ *  component circle. Empirical, validated by the user 2026-05-06. */
+export declare const LEFT_FLUSH_BUFFER_PX = 3;
+/** Constant offset for the right cardinal and right diagonals. */
+export declare const RIGHT_OFFSET_PX = 20;
+/** Y offsets for the cardinals. */
+export declare const TOP_OFFSET_PX = -25;
+export declare const BOTTOM_OFFSET_PX = 25;
+/** Y offset magnitude for diagonals. */
+export declare const DIAGONAL_DY_OFFSET_PX = 15;
+export declare const SCORE_HARD_PENALTY = 1000;
+export declare const SCORE_SPACING_PENALTY = 100;
+export declare const SCORE_EDGE_PENALTY = 10;
+export declare const SCORE_AXIS_PENALTY = 1;
+/**
+ * Eight V5 canonical label offsets for `componentName`. The LEFT
+ * cardinals scale with the label width so the right edge of the
+ * label sits `LEFT_FLUSH_BUFFER_PX` pixels left of the component
+ * circle.
+ */
+export declare function canonicalOffsetsFor(componentName: string): ReadonlyArray<LabelOffset>;
+export interface SnapResult {
+    chain: PositionedValueChain;
+    /** Names of components whose label was snapped to a canonical
+     *  position by this pass. Excludes labels that were left at their
+     *  V6 continuous position. */
+    snapped: string[];
+}
+/**
+ * For each non-anchor component, evaluate the V6 continuous offset
+ * alongside the 8 V5 canonical candidates and pick the best
+ * (minimum hard violations, with canonical preferred at hard ties).
+ * After the per-label sweep, run `projectHardConstraints` once more
+ * as defensive cleanup.
+ *
+ * The input chain is not mutated.
+ */
+export declare function snapToCanonical(chain: PositionedValueChain, emitOpts: EmitOwmOptions): SnapResult;
+//# sourceMappingURL=canonical-snap.d.mts.map

package/dist/frameworks/wardley/chain/_legacy/write/chain/lib/layout/canonical-snap.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical-snap.d.mts","sourceRoot":"","sources":["../../../../../../../../../src/frameworks/wardley/chain/_legacy/write/chain/lib/layout/canonical-snap.mts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EACV,WAAW,EAEX,oBAAoB,EACrB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAW3D;qEACqE;AACrE,eAAO,MAAM,oBAAoB,IAAI,CAAC;AACtC,kEAAkE;AAClE,eAAO,MAAM,eAAe,KAAK,CAAC;AAClC,mCAAmC;AACnC,eAAO,MAAM,aAAa,MAAM,CAAC;AACjC,eAAO,MAAM,gBAAgB,KAAK,CAAC;AACnC,wCAAwC;AACxC,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAIxC,eAAO,MAAM,kBAAkB,OAAU,CAAC;AAC1C,eAAO,MAAM,qBAAqB,MAAM,CAAC;AACzC,eAAO,MAAM,kBAAkB,KAAQ,CAAC;AACxC,eAAO,MAAM,kBAAkB,IAAO,CAAC;AAwBvC;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,MAAM,GAAG,aAAa,CAAC,WAAW,CAAC,CAarF;AAmCD,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,oBAAoB,CAAC;IAC5B;;kCAE8B;IAC9B,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,oBAAoB,EAC3B,QAAQ,EAAE,cAAc,GACvB,UAAU,CAqDZ"}

package/dist/frameworks/wardley/chain/_legacy/write/chain/lib/layout/canonical-snap.mjs

@@ -0,0 +1,149 @@
+// Phase 7 — canonical snap refinement after V6 force-directed.
+//
+// V6's continuous-position simulation finds a globally-good layout
+// but doesn't apply the V5 canonical conventions (proportional
+// `dx_left = -(name.length × 7 + 3)`, `dy ∈ {0, ±25}` family,
+// preference for cardinal directions). On a 14-component Spotify
+// chain the user manually re-snapped 11 labels back to canonical
+// positions, calling them "the finishing touches".
+//
+// Phase 7 reproduces this finishing pass deterministically: per
+// label, evaluate the V6 continuous offset alongside 8 V5 canonical
+// candidates, score each, prefer the canonical when it doesn't
+// degrade the hard-violation count.
+import { computeGeometry } from '#lib/owm/analytical-geometry.mjs';
+import { detectAllOverlaps, } from '#lib/owm/overlap-detector.mjs';
+import { LABEL_CHAR_WIDTH } from '#lib/owm/svg-bbox-parser.mjs';
+import { projectHardConstraints } from './force-directed.mjs';
+// ─── Canonical offset constants (re-introduced from V5) ────────────────
+/** Pixel gap between the right edge of a left-aligned label and the
+ *  component circle. Empirical, validated by the user 2026-05-06. */
+export const LEFT_FLUSH_BUFFER_PX = 3;
+/** Constant offset for the right cardinal and right diagonals. */
+export const RIGHT_OFFSET_PX = 20;
+/** Y offsets for the cardinals. */
+export const TOP_OFFSET_PX = -25;
+export const BOTTOM_OFFSET_PX = 25;
+/** Y offset magnitude for diagonals. */
+export const DIAGONAL_DY_OFFSET_PX = 15;
+// ─── Score weights (mirror V5 verify-layout) ──────────────────────────
+export const SCORE_HARD_PENALTY = 1000;
+export const SCORE_SPACING_PENALTY = 100;
+export const SCORE_EDGE_PENALTY = 10;
+export const SCORE_AXIS_PENALTY = 1;
+const HARD_KINDS = new Set([
+    'label-label',
+    'component-label',
+    'label-canvas',
+]);
+const PENALTY_BY_KIND = {
+    'label-label': SCORE_HARD_PENALTY,
+    'component-label': SCORE_HARD_PENALTY,
+    'label-canvas': SCORE_HARD_PENALTY,
+    'label-spacing': SCORE_SPACING_PENALTY,
+    'label-edge': SCORE_EDGE_PENALTY,
+    'label-axis': SCORE_AXIS_PENALTY,
+    // Out of scope for label-only optimisation.
+    'anchor-anchor': 0,
+    'anchor-component': 0,
+    'anchor-label': 0,
+    'component-component': 0,
+};
+// ─── Canonical candidate set ──────────────────────────────────────────
+/**
+ * Eight V5 canonical label offsets for `componentName`. The LEFT
+ * cardinals scale with the label width so the right edge of the
+ * label sits `LEFT_FLUSH_BUFFER_PX` pixels left of the component
+ * circle.
+ */
+export function canonicalOffsetsFor(componentName) {
+    const labelWidth = Math.max(1, componentName.length) * LABEL_CHAR_WIDTH;
+    const dxLeft = -(labelWidth + LEFT_FLUSH_BUFFER_PX);
+    return [
+        { dx: 0, dy: BOTTOM_OFFSET_PX }, // BELOW
+        { dx: 0, dy: TOP_OFFSET_PX }, // ABOVE
+        { dx: RIGHT_OFFSET_PX, dy: 0 }, // RIGHT
+        { dx: dxLeft, dy: 0 }, // LEFT (proportional)
+        { dx: RIGHT_OFFSET_PX, dy: -DIAGONAL_DY_OFFSET_PX }, // RIGHT_UP
+        { dx: RIGHT_OFFSET_PX, dy: DIAGONAL_DY_OFFSET_PX }, // RIGHT_DOWN
+        { dx: dxLeft, dy: -DIAGONAL_DY_OFFSET_PX }, // LEFT_UP
+        { dx: dxLeft, dy: DIAGONAL_DY_OFFSET_PX }, // LEFT_DOWN
+    ];
+}
+// ─── Helpers ──────────────────────────────────────────────────────────
+function withLabel(chain, name, label) {
+    return {
+        metadata: chain.metadata,
+        links: chain.links,
+        components: chain.components.map(c => c.name === name ? { ...c, label } : c),
+    };
+}
+function sameOffset(a, b) {
+    return a.dx === b.dx && a.dy === b.dy;
+}
+function scoreOverlaps(overlaps) {
+    let hard = 0;
+    let total = 0;
+    for (const ov of overlaps) {
+        if (HARD_KINDS.has(ov.kind))
+            hard++;
+        const penalty = PENALTY_BY_KIND[ov.kind] ?? 0;
+        total += penalty * ov.severity;
+    }
+    return { hard, total };
+}
+/**
+ * For each non-anchor component, evaluate the V6 continuous offset
+ * alongside the 8 V5 canonical candidates and pick the best
+ * (minimum hard violations, with canonical preferred at hard ties).
+ * After the per-label sweep, run `projectHardConstraints` once more
+ * as defensive cleanup.
+ *
+ * The input chain is not mutated.
+ */
+export function snapToCanonical(chain, emitOpts) {
+    let current = chain;
+    const snappedNames = [];
+    for (const c of chain.components) {
+        if (c.role === 'anchor')
+            continue;
+        const continuous = c.label;
+        const canonicalSet = canonicalOffsetsFor(c.name);
+        const evals = [];
+        const evalCandidate = (offset, isCanonical) => {
+            const trial = withLabel(current, c.name, offset);
+            const geometry = computeGeometry(trial, emitOpts);
+            const overlaps = detectAllOverlaps(geometry);
+            const { hard, total } = scoreOverlaps(overlaps);
+            evals.push({ offset, isCanonical, hard, total });
+        };
+        evalCandidate(continuous, false);
+        for (const cand of canonicalSet)
+            evalCandidate(cand, true);
+        // Selection rules:
+        //  1. Lower hard always wins.
+        //  2. Same hard — canonical preferred over continuous.
+        //  3. Same hard + same canonicality — lower total score wins.
+        let best = evals[0];
+        for (let i = 1; i < evals.length; i++) {
+            const cand = evals[i];
+            const winsOnHard = cand.hard < best.hard;
+            const sameHardCanonicalWins = cand.hard === best.hard && cand.isCanonical && !best.isCanonical;
+            const sameClassLowerScore = cand.hard === best.hard && cand.isCanonical === best.isCanonical && cand.total < best.total;
+            if (winsOnHard || sameHardCanonicalWins || sameClassLowerScore) {
+                best = cand;
+            }
+        }
+        if (!sameOffset(best.offset, continuous)) {
+            current = withLabel(current, c.name, best.offset);
+            if (best.isCanonical)
+                snappedNames.push(c.name);
+        }
+    }
+    // Defensive final projection — guarantees hard = 0 even if a snap
+    // accidentally introduced a residual (impossible by construction
+    // of the filter, but cheap insurance).
+    current = projectHardConstraints(current, emitOpts);
+    return { chain: current, snapped: snappedNames };
+}
+//# sourceMappingURL=canonical-snap.mjs.map

package/dist/frameworks/wardley/chain/_legacy/write/chain/lib/layout/canonical-snap.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical-snap.mjs","sourceRoot":"","sources":["../../../../../../../../../src/frameworks/wardley/chain/_legacy/write/chain/lib/layout/canonical-snap.mts"],"names":[],"mappings":"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"}

package/dist/frameworks/wardley/chain/_legacy/write/chain/lib/layout/compute-visibility.d.mts

@@ -0,0 +1,47 @@
+import type { PositionedValueChain, RawValueChain } from '#types/value-chain.mjs';
+export declare const ANCHOR_VISIBILITY = 0.95;
+export declare const Y_MIN = 0.1;
+/** Floor on the effective chain length used to derive `step`. Ensures that
+ *  short graphs (L=1, L=2) keep components close to the anchor instead of
+ *  spreading them across the full canvas. */
+export declare const MIN_EFFECTIVE_L = 3;
+/** Half-amplitude cap of the semantic jitter (so peak-to-peak ≤ 0.10). */
+export declare const BAND_MAX = 0.05;
+/** Minimum visible gap between a parent and its child after jitter. */
+export declare const EDGE_MIN_GAP = 0.01;
+/** Sub-step push applied to secondary anchors so they don't collide with
+ *  regular components at depth(child) − 1. */
+export declare const SECONDARY_ANCHOR_OFFSET = 0.3;
+/** Y placeholder for components unreachable from any anchor. */
+export declare const ORPHAN_FALLBACK_Y = 0.5;
+/** X placeholder seeded by this step for every non-anchor component. The
+ *  value is overwritten by step 4 (adjust-x) using `xHint` or a uniform
+ *  per-Y-level fallback, so it carries no semantic meaning. */
+export declare const INITIAL_EVOLUTION_PLACEHOLDER = 0.5;
+export declare const BASE_CANVAS_HEIGHT = 650;
+/** Strict threshold on L above which the canvas height is scaled. */
+export declare const DENSITY_LIMIT_L = 24;
+/** Reference chain length used to compute the height scale factor. */
+export declare const DENSITY_REFERENCE_L = 25;
+/** Compute the OWM canvas height for the given longest-chain length.
+ *  Height is scaled when L > DENSITY_LIMIT_L so the per-step pixel gap
+ *  remains readable. Width is the responsibility of step 4 (adjust-x). */
+export declare function computeMapHeight(L: number): number;
+export interface ComputeVisibilityResult {
+    chain: PositionedValueChain;
+    mapSize: {
+        height: number;
+    };
+}
+/**
+ * Compute the Y coordinate for every component plus the OWM canvas size.
+ *
+ * Returns a `PositionedValueChain` where:
+ *   - `visibility` respects the strict edge-direction rule,
+ *   - `evolution` is seeded with `INITIAL_EVOLUTION_PLACEHOLDER` (overwritten by step 4 — adjust-x),
+ *   - `label` is the placeholder `{ dx: 0, dy: 0 }` (filled by step 5 — place-labels).
+ *
+ * Throws when no anchor (`role === 'anchor'`) is present.
+ */
+export declare function computeVisibility(raw: RawValueChain): ComputeVisibilityResult;
+//# sourceMappingURL=compute-visibility.d.mts.map

package/dist/frameworks/wardley/chain/_legacy/write/chain/lib/layout/compute-visibility.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute-visibility.d.mts","sourceRoot":"","sources":["../../../../../../../../../src/frameworks/wardley/chain/_legacy/write/chain/lib/layout/compute-visibility.mts"],"names":[],"mappings":"AAkEA,OAAO,KAAK,EAIV,oBAAoB,EACpB,aAAa,EAEd,MAAM,wBAAwB,CAAC;AAIhC,eAAO,MAAM,iBAAiB,OAAO,CAAC;AACtC,eAAO,MAAM,KAAK,MAAO,CAAC;AAC1B;;6CAE6C;AAC7C,eAAO,MAAM,eAAe,IAAI,CAAC;AACjC,0EAA0E;AAC1E,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,uEAAuE;AACvE,eAAO,MAAM,YAAY,OAAO,CAAC;AACjC;8CAC8C;AAC9C,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAC3C,gEAAgE;AAChE,eAAO,MAAM,iBAAiB,MAAO,CAAC;AACtC;;+DAE+D;AAC/D,eAAO,MAAM,6BAA6B,MAAM,CAAC;AAIjD,eAAO,MAAM,kBAAkB,MAAM,CAAC;AACtC,qEAAqE;AACrE,eAAO,MAAM,eAAe,KAAK,CAAC;AAClC,sEAAsE;AACtE,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAuGtC;;0EAE0E;AAC1E,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAGlD;AAgBD,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,oBAAoB,CAAC;IAC5B,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7B;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,aAAa,GAAG,uBAAuB,CAiG7E"}