@oh-just-another/scene 0.57.0

package/dist/anchors.js

@@ -0,0 +1,322 @@
+import { isContainer } from "./container.js";
+import { getElementLocalBounds, isPolygon } from "./shape.js";
+const EMPTY_ANCHOR_EXCLUDE = new Set();
+/**
+ * The 9 canonical named anchors every built-in shape exposes. They map to
+ * the local bounding box of a shape — four corners, four edge centres, and
+ * the geometric centre.
+ *
+ *   top-left ─── top ─── top-right
+ *       │         │          │
+ *      left ─── center ─── right
+ *       │         │          │
+ *  bottom-left ─ bottom ─ bottom-right
+ *
+ * `top` / `right` / `bottom` / `left` are the edge centres; `top-left` etc.
+ * are the corners. Hosts may add custom anchors per shape via the
+ * `anchors` field on `ElementBase`.
+ */
+export const STANDARD_ANCHOR_RATIOS = {
+    "top-left": { x: 0, y: 0 },
+    top: { x: 0.5, y: 0 },
+    "top-right": { x: 1, y: 0 },
+    right: { x: 1, y: 0.5 },
+    "bottom-right": { x: 1, y: 1 },
+    bottom: { x: 0.5, y: 1 },
+    "bottom-left": { x: 0, y: 1 },
+    left: { x: 0, y: 0.5 },
+    center: { x: 0.5, y: 0.5 },
+};
+/** All 9 standard anchor names, in clockwise-from-top-left order. */
+export const STANDARD_ANCHORS = [
+    "top-left",
+    "top",
+    "top-right",
+    "right",
+    "bottom-right",
+    "bottom",
+    "bottom-left",
+    "left",
+    "center",
+];
+/**
+ * Resolve a named anchor to its *local-space* position inside the shape's
+ * bounding box. Returns `undefined` if the name isn't a standard anchor
+ * and isn't declared in the shape's own `anchors` map.
+ *
+ * Hosts looking up an `AnchorRef` should call `getAnchorLocal` /
+ * `getAnchorWorld` instead — those handle every `AnchorRef` kind.
+ */
+export const getNamedAnchorLocal = (shape, name) => {
+    return lookupNamed(shape, name);
+};
+/**
+ * Resolve any `AnchorRef` to a point in the shape's local coordinate
+ * space (before `position` / `rotation` / `scale`). Throws on an unknown
+ * named anchor — callers either pass a `ratio` / `absolute` ref or use a
+ * registered standard / custom name.
+ */
+export const getAnchorLocal = (shape, anchor) => {
+    return resolveAnchorRefLocal(shape, anchor);
+};
+/**
+ * Resolve any `AnchorRef` to a world-space point. Applies the shape's
+ * `position` + `rotation` + `scale` to the local resolution from
+ * `getAnchorLocal`.
+ */
+export const getAnchorWorld = (shape, anchor) => {
+    const local = getAnchorLocal(shape, anchor);
+    const sx = local.x * shape.scale.x;
+    const sy = local.y * shape.scale.y;
+    const cos = Math.cos(shape.rotation);
+    const sin = Math.sin(shape.rotation);
+    return {
+        x: shape.position.x + (sx * cos - sy * sin),
+        y: shape.position.y + (sx * sin + sy * cos),
+    };
+};
+/**
+ * World-space outward unit normal at an anchor — the direction "away from
+ * the shape" used to push port dots a few pixels off the edge and to seed
+ * a link's exit stub.
+ *
+ * Computed as the direction from the shape's geometric centre to the
+ * anchor's world point, so it automatically respects rotation / non-
+ * uniform scale and works for cardinal ports, polygon edge midpoints, and
+ * corners alike. Returns `{ x: 0, y: -1 }` (up) as a stable fallback when
+ * the anchor coincides with the centre (e.g. a custom centre anchor),
+ * where "outward" is undefined.
+ */
+export const getAnchorOutwardNormal = (shape, anchor) => {
+    const point = getAnchorWorld(shape, anchor);
+    const centre = getAnchorWorld(shape, { kind: "named", name: "center" });
+    const dx = point.x - centre.x;
+    const dy = point.y - centre.y;
+    const len = Math.hypot(dx, dy);
+    if (len < 1e-6)
+        return { x: 0, y: -1 };
+    return { x: dx / len, y: dy / len };
+};
+/**
+ * Find the anchor on `shape` whose world position is closest to
+ * `worldPoint`. Returns the canonical `AnchorRef` you can persist on an
+ * `LinkEndpoint` so future renders stay locked to that port.
+ *
+ * Useful when committing an edge whose endpoint dropped near a shape:
+ * snap the drop position to the nearest of the 9 standard anchors (plus
+ * custom ones) so the edge tracks the shape on subsequent edits.
+ */
+export const findNearestAnchor = (shape, worldPoint, excludeNames = EMPTY_ANCHOR_EXCLUDE) => {
+    let best = null;
+    for (const [name, _local] of geometryDefaultAnchorsLocal(shape)) {
+        void _local;
+        if (excludeNames.has(name))
+            continue;
+        const ref = defaultAnchorRef(name);
+        const world = getAnchorWorld(shape, ref);
+        const dx = world.x - worldPoint.x;
+        const dy = world.y - worldPoint.y;
+        const distance = Math.hypot(dx, dy);
+        if (best === null || distance < best.distance) {
+            best = { ref, world, distance };
+        }
+    }
+    // `geometryDefaultAnchorsLocal` normally yields the 4 cardinal ports
+    // (or a polygon's edge midpoints), so `best` is set in practice. The
+    // only empty case is a degenerate polygon (<2 points) with no custom
+    // anchors — fall back to the geometric centre so the caller always
+    // gets a usable ref.
+    if (!best) {
+        return {
+            ref: { kind: "named", name: "center" },
+            world: getAnchorWorld(shape, { kind: "named", name: "center" }),
+            distance: Infinity,
+        };
+    }
+    return best;
+};
+/**
+ * Map a default-anchor key (from `geometryDefaultAnchorsLocal`) to the
+ * canonical `AnchorRef` to persist on a link endpoint. Polygon edge
+ * midpoints (`edge-<n>`) become an `edge` ref pinned to the edge midpoint
+ * (`t = 0.5`) so the endpoint tracks the real sloped edge; everything
+ * else (cardinal names, custom names) is a `named` ref.
+ */
+const defaultAnchorRef = (key) => {
+    const m = /^edge-(\d+)$/.exec(key);
+    if (m)
+        return { kind: "edge", index: Number(m[1]), t: 0.5 };
+    return { kind: "named", name: key };
+};
+/**
+ * Materialise the full anchor table for a shape — every standard anchor
+ * plus every custom one declared in `shape.anchors`. Custom entries with
+ * the same name as a standard anchor override the standard placement.
+ * Returns *local-space* coordinates.
+ *
+ * Renderers that draw port-dots use this to enumerate the dots once per
+ * frame instead of resolving each name individually.
+ */
+/**
+ * Anchor names that should not be offered as snap targets for the
+ * given shape, used by the edge-draw snap engine and the hover port-
+ * dot overlay. Containers omit `center` because that point lives
+ * inside the drop-zone, where a snap-to-anchor would compete with
+ * the reparent / drop gesture. Hosts can still target the centre
+ * explicitly via `kind: "anchor", anchor: { kind: "named", name:
+ * "center" }` — only the auto snap is filtered.
+ */
+export const snapExcludedAnchors = (shape) => {
+    if (isContainer(shape))
+        return CONTAINER_SNAP_EXCLUDED;
+    return EMPTY_ANCHOR_EXCLUDE;
+};
+const CONTAINER_SNAP_EXCLUDED = new Set(["center"]);
+export const listAnchorsLocal = (shape) => {
+    const out = new Map();
+    const b = getElementLocalBounds(shape);
+    for (const name of STANDARD_ANCHORS) {
+        const ratio = STANDARD_ANCHOR_RATIOS[name];
+        out.set(name, { x: b.x + b.width * ratio.x, y: b.y + b.height * ratio.y });
+    }
+    if (shape.anchors) {
+        for (const [name, ref] of Object.entries(shape.anchors)) {
+            out.set(name, resolveAnchorRefLocal(shape, ref));
+        }
+    }
+    return out;
+};
+/**
+ * Geometry-aware default connection points for a shape, in *local* space.
+ *
+ * Unlike `listAnchorsLocal` (which always returns the 9 AABB-relative
+ * standard anchors), this returns the points the editor offers as the
+ * default snap/draw targets, derived from the shape's *real* geometry:
+ *
+ *   - **polygon** — the midpoint of every edge (works for triangle,
+ *     hexagon, …; points sit on the actual sloped edges, not the bbox).
+ *   - **rectangle / ellipse / everything else** — the four bbox edge
+ *     centres (`top` / `right` / `bottom` / `left`). For an axis-aligned
+ *     rectangle these are the real edge midpoints; for an ellipse the
+ *     cardinal points already lie on the curve.
+ *
+ * Corners and the centre are excluded — the centre is never a magnet
+ * target, and corner ports are visual noise for the default set
+ * (templates can still declare custom anchors there via `shape.anchors`).
+ *
+ * A shape's own `shape.anchors` entries are merged on top (and override a
+ * default with the same name), so a template can fully customise the port
+ * layout while non-templated shapes get sensible geometry-aware defaults.
+ *
+ * Returns a name→local-point map. Default names are the polygon edge
+ * indices (`edge-0`, `edge-1`, …) or the cardinal names (`top` / `right` /
+ * `bottom` / `left`).
+ */
+export const geometryDefaultAnchorsLocal = (shape) => {
+    const out = new Map();
+    if (isPolygon(shape)) {
+        addPolygonEdgeMidpoints(shape, out);
+    }
+    else {
+        const b = getElementLocalBounds(shape);
+        for (const name of CARDINAL_ANCHORS) {
+            const ratio = STANDARD_ANCHOR_RATIOS[name];
+            out.set(name, { x: b.x + b.width * ratio.x, y: b.y + b.height * ratio.y });
+        }
+    }
+    if (shape.anchors) {
+        for (const [name, ref] of Object.entries(shape.anchors)) {
+            out.set(name, resolveAnchorRefLocal(shape, ref));
+        }
+    }
+    return out;
+};
+/** The four bbox edge centres — the default port set for non-polygon shapes. */
+export const CARDINAL_ANCHORS = ["top", "right", "bottom", "left"];
+// --- internal ---
+/**
+ * Insert the midpoint of every polygon edge into `out`, keyed `edge-0`,
+ * `edge-1`, … in vertex order. A polygon with N vertices has N edges
+ * (the last wraps back to the first). Degenerate polygons (<2 points)
+ * contribute nothing.
+ */
+const addPolygonEdgeMidpoints = (shape, out) => {
+    const pts = shape.points;
+    if (pts.length < 2)
+        return;
+    for (let i = 0; i < pts.length; i++) {
+        const a = pts[i];
+        const b = pts[(i + 1) % pts.length];
+        if (a === undefined || b === undefined)
+            continue;
+        out.set(`edge-${i}`, { x: (a.x + b.x) / 2, y: (a.y + b.y) / 2 });
+    }
+};
+const resolveAnchorRefLocal = (shape, anchor) => {
+    switch (anchor.kind) {
+        case "named": {
+            const point = lookupNamed(shape, anchor.name);
+            if (!point) {
+                throw new Error(`Unknown anchor "${anchor.name}" on shape ${shape.id} (type ${shape.type}). ` +
+                    `Standard names: ${STANDARD_ANCHORS.join(", ")}; custom anchors live on shape.anchors.`);
+            }
+            return point;
+        }
+        case "ratio": {
+            const b = getElementLocalBounds(shape);
+            return { x: b.x + b.width * anchor.position.x, y: b.y + b.height * anchor.position.y };
+        }
+        case "absolute": {
+            const b = getElementLocalBounds(shape);
+            return { x: b.x + anchor.offset.x, y: b.y + anchor.offset.y };
+        }
+        case "edge": {
+            return resolveEdgeRefLocal(shape, anchor.index, anchor.t);
+        }
+    }
+};
+/**
+ * Resolve an `edge` AnchorRef to local space: the point at parameter `t`
+ * along polygon edge `index` (wrapping). For a non-polygon shape (or a
+ * degenerate polygon) there are no real edges, so fall back to the
+ * geometric centre — keeps the resolver total without throwing.
+ */
+const resolveEdgeRefLocal = (shape, index, t) => {
+    if (isPolygon(shape) && shape.points.length >= 2) {
+        const pts = shape.points;
+        const n = pts.length;
+        // Wrap a possibly out-of-range / negative index into [0, n).
+        const i = ((index % n) + n) % n;
+        const a = pts[i];
+        const b = pts[(i + 1) % n];
+        if (a !== undefined && b !== undefined) {
+            const tc = t < 0 ? 0 : t > 1 ? 1 : t;
+            return { x: a.x + (b.x - a.x) * tc, y: a.y + (b.y - a.y) * tc };
+        }
+    }
+    const bounds = getElementLocalBounds(shape);
+    return { x: bounds.x + bounds.width / 2, y: bounds.y + bounds.height / 2 };
+};
+const lookupNamed = (shape, name) => {
+    const custom = shape.anchors?.[name];
+    if (custom !== undefined) {
+        // Custom entry — resolve recursively (custom may itself be a ratio /
+        // absolute ref). Recursion is bounded: anchors don't reference each
+        // other by name (`kind: "named"` chains are not followed here).
+        if (custom.kind === "named")
+            return lookupNamed(shape, custom.name);
+        return resolveAnchorRefLocal(shape, custom);
+    }
+    if (isPolygon(shape) && name.startsWith("edge-")) {
+        const index = parseInt(name.slice(5), 10);
+        if (!isNaN(index))
+            return resolveEdgeRefLocal(shape, index, 0.5);
+    }
+    const standard = STANDARD_ANCHOR_RATIOS[name];
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- `name` is cast from a broader type; a non-standard name yields undefined at runtime.
+    if (!standard)
+        return undefined;
+    const b = getElementLocalBounds(shape);
+    return { x: b.x + b.width * standard.x, y: b.y + b.height * standard.y };
+};
+//# sourceMappingURL=anchors.js.map

package/dist/anchors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchors.js","sourceRoot":"","sources":["../src/anchors.ts"],"names":[],"mappings":"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"}

package/dist/annotation-geometry.d.ts

@@ -0,0 +1,11 @@
+import type { Vec2 } from "@oh-just-another/types";
+import type { Annotation } from "./annotation.js";
+import type { Scene } from "./scene.js";
+/**
+ * World-space position where the pin should render. When the annotation
+ * is anchored to a shape, the stored `position` is added to the shape's
+ * world position (so the pin follows shape moves). When the shape is
+ * gone — or the annotation is a free-floater — `position` is used as-is.
+ */
+export declare const getAnnotationWorldPosition: (scene: Scene, annotation: Annotation) => Vec2;
+//# sourceMappingURL=annotation-geometry.d.ts.map

package/dist/annotation-geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotation-geometry.d.ts","sourceRoot":"","sources":["../src/annotation-geometry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGxC;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,GAAI,OAAO,KAAK,EAAE,YAAY,UAAU,KAAG,IAQjF,CAAC"}

package/dist/annotation-geometry.js

@@ -0,0 +1,19 @@
+import { getElement } from "./queries.js";
+/**
+ * World-space position where the pin should render. When the annotation
+ * is anchored to a shape, the stored `position` is added to the shape's
+ * world position (so the pin follows shape moves). When the shape is
+ * gone — or the annotation is a free-floater — `position` is used as-is.
+ */
+export const getAnnotationWorldPosition = (scene, annotation) => {
+    if (annotation.elementId === null)
+        return annotation.position;
+    const shape = getElement(scene, annotation.elementId);
+    if (!shape)
+        return annotation.position;
+    return {
+        x: shape.position.x + annotation.position.x,
+        y: shape.position.y + annotation.position.y,
+    };
+};
+//# sourceMappingURL=annotation-geometry.js.map

package/dist/annotation-geometry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotation-geometry.js","sourceRoot":"","sources":["../src/annotation-geometry.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,KAAY,EAAE,UAAsB,EAAQ,EAAE;IACvF,IAAI,UAAU,CAAC,SAAS,KAAK,IAAI;QAAE,OAAO,UAAU,CAAC,QAAQ,CAAC;IAC9D,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;IACtD,IAAI,CAAC,KAAK;QAAE,OAAO,UAAU,CAAC,QAAQ,CAAC;IACvC,OAAO;QACL,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;QAC3C,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;KAC5C,CAAC;AACJ,CAAC,CAAC"}

package/dist/annotation.d.ts

@@ -0,0 +1,32 @@
+import type { AnnotationId, CommentId, ElementId, Vec2 } from "@oh-just-another/types";
+/**
+ * Threaded comment inside an annotation. `body` is plain text — host can
+ * render mentions / markdown / etc. on top. `createdAt` is an ISO-8601
+ * string for serialization stability across timezones.
+ */
+export interface Comment {
+    readonly id: CommentId;
+    readonly authorId: string;
+    readonly authorName: string;
+    readonly body: string;
+    readonly createdAt: string;
+}
+/**
+ * Pin + comment thread anchored either to a free world-space position
+ * or to a specific shape. When `elementId` is set, the position is
+ * resolved as `shape.position + offset`; if the shape moves, the pin
+ * follows it. `position` is the world-space (or local-to-shape when
+ * `elementId` is set) offset.
+ *
+ * `resolved` is a UI-only flag: marks the thread as closed. Doesn't
+ * delete history.
+ */
+export interface Annotation {
+    readonly id: AnnotationId;
+    readonly elementId: ElementId | null;
+    readonly position: Vec2;
+    readonly resolved: boolean;
+    readonly thread: readonly Comment[];
+    readonly createdAt: string;
+}
+//# sourceMappingURL=annotation.d.ts.map

package/dist/annotation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotation.d.ts","sourceRoot":"","sources":["../src/annotation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAEvF;;;;GAIG;AACH,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,YAAY,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B"}

package/dist/annotation.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=annotation.js.map

package/dist/annotation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotation.js","sourceRoot":"","sources":["../src/annotation.ts"],"names":[],"mappings":""}

package/dist/constants.d.ts

@@ -0,0 +1,186 @@
+/**
+ * Tunable thresholds for the scene-level helpers (snap engine, hit-test
+ * cheap-cull). Keep magic numbers here so hosts can re-tune the engine
+ * without touching the algorithm code.
+ */
+/**
+ * Half-side of the bounding box used by `isProbeNearElement` to cheap-cull
+ * snap candidates. Shapes farther than this from the probe (plus the
+ * snap threshold cushion) are skipped without the full anchor walk.
+ *
+ * The default of 1000 world units covers any typical editor shape; bump
+ * it if hosts work with very large diagrams where the cheap-cull starts
+ * to over-prune real candidates.
+ */
+export declare const SNAP_PROBE_CULL_RADIUS = 1000;
+/**
+ * Fallback grid spacing (world units) used by snap-to-grid when the
+ * viewport has no `gridSize` (grid hidden) but snapping is still on.
+ * Lets the user keep clean grid-aligned geometry without a visible
+ * grid. Matches the app's default `gridSize` of 20. Range: 4–64.
+ */
+export declare const DEFAULT_GRID_SPACING = 20;
+/**
+ * Padding (world units) the elbow router inflates obstacle bboxes
+ * by before searching. Larger values keep edges visibly clear of
+ * shapes; smaller values let the router squeeze through tight
+ * spaces. 20 px matches the gridSize default for diagrams that
+ * snap to a 20-unit grid.
+ */
+export declare const ELBOW_OBSTACLE_MARGIN = 20;
+/**
+ * Epsilon used to decide whether an axis-aligned segment runs
+ * *along* an obstacle boundary (allowed) or *through* it (blocked).
+ * A degenerate small value catches floating-point fuzz from
+ * `inflate` arithmetic without admitting real crossings.
+ */
+export declare const ELBOW_OBSTACLE_INTERIOR_EPSILON = 0.5;
+/**
+ * Per-turn cost added in the elbow A* so the router minimises BENDS first,
+ * distance second (lexicographic — far larger than any plausible canvas
+ * distance). Keeps routes stable: small shape moves no longer flip between
+ * equal-distance alternatives, and the path takes the fewest corners.
+ */
+export declare const ELBOW_BEND_PENALTY = 100000;
+/**
+ * Hysteresis band (world px) for the C-wrap side choice in `wrapRoute`.
+ * When the connector must wrap around the union of its two bound shapes,
+ * the over/under (or left/right) side is picked from the endpoints'
+ * midpoint vs the union centre. Within this band of the centre the
+ * previous side is kept (read from `edge.routedPoints`), so a small
+ * back-and-forth drag doesn't thrash; the side only switches once the
+ * midpoint moves this far past the centre. Larger = stickier.
+ * Range: 8–48.
+ */
+export declare const ELBOW_WRAP_HYSTERESIS = 24;
+/**
+ * Perf cap for "avoid obstacles" routing. The A* grid scales with the
+ * number of obstacle corners, and the route is recomputed every frame
+ * while a shape is dragged, so above this many scene shapes we skip
+ * whole-scene avoidance and fall back to the cheap two-box elbow (the
+ * link still keeps clear of its own ends). Range: 60–300.
+ */
+export declare const ELBOW_AVOID_MAX_OBSTACLES = 150;
+/**
+ * Length (world px) of the fixed, non-movable terminal segment an elbow
+ * connector always leaves at each end before its first bend — the endpoint
+ * is pushed out this far along its exit heading so the connector departs/
+ * arrives perpendicular to the edge and there's buffer room to draw the
+ * arrowhead. Must stay ≥ ELBOW_OBSTACLE_MARGIN so the pushed-out point
+ * sits outside the inflated obstacle the A* router avoids. Larger → more
+ * breathing room before the first bend. Range: 16–40.
+ */
+export declare const ELBOW_TERMINAL_BUFFER = 30;
+/**
+ * --- Self-loop connectors (a link whose both ends bind to the SAME element) ---
+ *
+ * A self-loop is routed OUTSIDE the element so it reads as a loop/arc instead of
+ * a flat line on (or across) the shape.
+ *
+ * - `SELF_LOOP_SIZE` — how far (world px) the loop bows out past the element's
+ *   edge. Fixed for every element. Range: 24–80.
+ * - `SELF_LOOP_SPREAD` — when both ends resolve to the SAME point (centre /
+ *   floating / same anchor) the two exit points are spread this far apart along
+ *   the edge so the loop has width. Clamped to a third of the side. Range: 12–40.
+ * - `SELF_LOOP_CURVE_ARM_FACTOR` — control-arm length for a curved self-loop as a
+ *   multiple of `SELF_LOOP_SIZE`; larger = rounder, more pronounced arc. 2.2
+ *   gives a clean teardrop. Range: 1.5–3.
+ */
+export declare const SELF_LOOP_SIZE = 40;
+export declare const SELF_LOOP_SPREAD = 24;
+export declare const SELF_LOOP_CURVE_ARM_FACTOR = 2.2;
+/**
+ * Clearance (world px) a candidate centred path (the "thread"/mid-S or the
+ * C-wrap) must keep from a bound shape's interior before it counts as CROSSING
+ * it. This is the threshold that decides thread-vs-wrap-vs-A*: a larger value
+ * makes the router bail off the direct/centred path sooner (route stays further
+ * from shapes), a smaller value lets it skim closer to an edge before detouring.
+ * At 1 px it only rejects genuine interior crossings, allowing edge-grazing.
+ * Range: 1–8.
+ */
+export declare const ELBOW_OBSTACLE_CLEARANCE = 1;
+/**
+ * Parametric step used to sample each segment of a candidate path when testing
+ * whether it crosses a shape (`pathCrossesObstacle`). Smaller = finer (catches
+ * a narrow shape a coarse sampling would skip) at more cost; 0.1 samples 11
+ * points per segment, enough for typical shape sizes. Range: 0.02–0.2.
+ */
+export declare const ELBOW_CROSS_SAMPLE_STEP = 0.1;
+/**
+ * --- Curved (bezier) link geometry ---
+ *
+ * Shared by the renderer (draws cubic beziers), hit-testing and bounds
+ * (flatten the same curve) so the visible curve and the clickable curve
+ * agree. Lives in scene so lower layers own the geometry; renderer-core
+ * imports it.
+ *
+ * - `CURVE_CATMULL_TENSION` — divisor for the Catmull-Rom tangents in the
+ *   spline→bezier conversion (waypointed curves). 6 is canonical uniform
+ *   Catmull-Rom (control point = P + (Pnext − Pprev) / 6). Larger → tighter;
+ *   smaller → looser. Range: 4–8.
+ * - `CURVE_END_TANGENT_RATIO` — for a no-waypoint span the cubic's control
+ *   arms leave/enter the endpoints along their edge normals with length =
+ *   this fraction of the endpoint distance, so the connector exits/enters
+ *   perpendicular to the element edge (flowchart look). Larger → rounder /
+ *   more pronounced. Range: 0.25–0.6.
+ * - `CURVE_END_TANGENT_MAX_PX` — caps that control-arm length (world px) so a
+ *   long link doesn't over-bow. Range: 60–160.
+ * - `CURVE_FLATTEN_SEGMENTS` — samples per cubic when flattening the curve
+ *   for hit-testing / bounds. Higher = closer to the drawn curve. Range:
+ *   8–24.
+ */
+export declare const CURVE_CATMULL_TENSION = 6;
+export declare const CURVE_END_TANGENT_RATIO = 0.8;
+export declare const CURVE_END_TANGENT_MAX_PX = 240;
+export declare const CURVE_FLATTEN_SEGMENTS = 16;
+/**
+ * --- Roundness (Style.roundness) ---
+ *
+ * Adaptive radius: pick a fixed radius for shapes bigger than the cutoff,
+ * scale proportionally for smaller ones so the corner doesn't dominate.
+ * 32 px / 0.25 looks rounded without becoming a capsule across the
+ * realistic shape-size range.
+ */
+/** Fixed pixel radius used by adaptive rounding for shapes ≥ cutoff. */
+export declare const ADAPTIVE_CORNER_RADIUS = 32;
+/**
+ * Proportional radius (0..1 of the smaller side) used by adaptive
+ * rounding for shapes below the cutoff, and the fall-through when
+ * `Roundness.value` is omitted but the type is `round`.
+ */
+export declare const PROPORTIONAL_CORNER_RADIUS = 0.25;
+/**
+ * --- Text bounds estimation ---
+ *
+ * The text bounder has no layout engine, so it approximates the box.
+ * Renderers compute the precise layout (via `measureText`) during
+ * draw / caret positioning; these factors only drive selection bbox
+ * and resize-handle placement, where a rough estimate is fine.
+ *
+ * - `TEXT_APPROX_CHAR_WIDTH_FACTOR` — average glyph advance as a
+ *   fraction of font size (~0.6 for proportional Latin text).
+ * - `TEXT_LINE_HEIGHT_FACTOR` — line height as a multiple of font
+ *   size. Must match the renderer's `DEFAULT_LINE_HEIGHT_FACTOR`.
+ */
+export declare const TEXT_APPROX_CHAR_WIDTH_FACTOR = 0.6;
+export declare const TEXT_LINE_HEIGHT_FACTOR = 1.2;
+/**
+ * --- Frame header (label strip) geometry ---
+ *
+ * The frame's name is drawn in a strip ABOVE the frame body (local y in
+ * `[-FRAME_HEADER_HEIGHT, 0]`). Shared by the renderer (draws it), the
+ * editor (header double-click → rename hit zone + render overflow) and
+ * react-ui (positions the inline name editor) so all three agree.
+ *
+ * - `FRAME_HEADER_HEIGHT` — strip height (world px).
+ * - `FRAME_HEADER_PADDING_X` — horizontal text inset, each side (world px).
+ * - `FRAME_HEADER_FONT_SIZE` — label font size (world px).
+ *
+ * The strip width is dynamic: it hugs the label width but is capped at the
+ * frame's own width (a too-long name is ellipsised) — computed in the
+ * renderer, which can measure text.
+ */
+export declare const FRAME_HEADER_HEIGHT = 24;
+export declare const FRAME_HEADER_PADDING_X = 8;
+export declare const FRAME_HEADER_FONT_SIZE = 12;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAE3C;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC;;;;;GAKG;AACH,eAAO,MAAM,+BAA+B,MAAM,CAAC;AAEnD;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,SAAS,CAAC;AAEzC;;;;;;;;;GASG;AACH,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAE7C;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,cAAc,KAAK,CAAC;AACjC,eAAO,MAAM,gBAAgB,KAAK,CAAC;AACnC,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAE9C;;;;;;;;GAQG;AACH,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAE3C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,qBAAqB,IAAI,CAAC;AACvC,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAC3C,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAC5C,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC;;;;;;;GAOG;AAEH,wEAAwE;AACxE,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAE/C;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,6BAA6B,MAAM,CAAC;AACjD,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAE3C;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,mBAAmB,KAAK,CAAC;AACtC,eAAO,MAAM,sBAAsB,IAAI,CAAC;AACxC,eAAO,MAAM,sBAAsB,KAAK,CAAC"}