@myrmidon/gve-snapshot-rendition 2.0.4 → 2.0.6

package/dist/models.d.ts

@@ -91,78 +91,49 @@ export interface CharNode {
     label: string;
     data: string;
     sourceTag?: string;
-    features?: Feature[];
+    /** Features keyed by version tag (e.g. "v1" → feature list). */
+    features?: Record<string, Feature[]>;
 }
 /**
  * Execution step of a char-based chain operation.
  */
 export interface ChainOperationContextStep {
-    /**
-     * The operation that was executed.
-     */
+    /** The operation that was executed. */
     operation: CharChainOperation;
-    /**
-     * The input version tag.
-     */
+    /** The input version tag. */
     inputTag: string;
-    /**
-     * The output version tag.
-     */
+    /** The output version tag. */
     outputTag: string;
-    /**
-     * The string synthetically representing the resulting text
-     * version.
-     */
+    /** The string synthetically representing the resulting text version. */
     result?: string;
-    /**
-     * The features emitted up to the executed operation.
-     * These are the features of the text as a whole, and
-     * those belonging to specific nodes, each keyed under
-     * a string built with `v` + output version tag + `_`
-     * + node ID (e.g. `v1_2` for node with ID 2 at version 1).
-     */
-    featureSet: {
-        features: OperationFeature[];
-        nodeFeatures: Record<string, OperationFeature[]>;
-    };
-    /**
-     * The reference node IDs of the operation which was
-     * executed.
-     */
+    /** The reference node IDs of the operation which was executed. */
     refNodeIds: number[];
 }
 /**
  * Result of execution of a char-based chain.
  */
 export interface CharChainResult {
-    /**
-     * The base text, as an array of character nodes or string.
-     * This is not returned by the API, but can be supplied
-     * by the caller.
-     */
-    text?: CharNode[] | string;
-    /**
-     * The execution steps of the chain.
-     */
+    /** The execution steps of the chain. */
     steps: ChainOperationContextStep[];
+    /** The chain dump, which is the text representation of the chain. */
+    chainDump: string | null;
+    /** The list of all unique tags in the chain, including v0. */
+    chainTags: string[];
     /**
-     * The chain dump, which is the text representation of the chain.
+     * All character nodes in the chain (base text and added nodes).
+     * Node features are keyed by version tag.
      */
-    chainDump: string;
+    nodes: CharNode[];
     /**
-     * The list of all unique tags in the chain.
+     * IDs of nodes forming each version's text, keyed by version tag.
+     * Includes v0 (base text).
      */
-    chainTags: string[];
+    versionNodeIds: Record<string, number[]>;
     /**
-     * The sets of nodes in their order, for each version tag.
-     * These nodes are collected by following the path defined
-     * by the set of links of each version tag; so each of the
-     * sets contains only the nodes used at that step to build
-     * the text version, with their features up to that stage.
+     * Global features accumulated up to each version, keyed by version tag.
+     * Includes v0 (empty list).
      */
-    taggedNodes: {
-        [key: string]: CharNode[];
-    };
+    globalFeatures: Record<string, OperationFeature[]>;
 }
 /**
  * The input and output tags of a char-based chain operation.

package/dist/rendering/feature-resolver.d.ts

@@ -1,4 +1,4 @@
-import { Feature, OperationFeature } from "../models";
+import { Feature, CharNode } from "../models";
 import { GveRenditionSettings } from "../settings/settings";
 import { Logger } from "../core/logger";
 /**
@@ -11,7 +11,6 @@ export interface HintOverrides {
     scaleX?: string;
     scaleY?: string;
     rotation?: string;
-    solid?: boolean;
     displacedSpan?: {
         nodeId: number;
         count: number;
@@ -36,14 +35,13 @@ export interface RenditionConfig {
     textPosition?: string;
     textOffsetX: number | string;
     textOffsetY: number | string;
-    textSolid?: boolean;
     textDisplacedSpan?: {
         nodeId: number;
         count: number;
     };
     textValue?: string;
     hints?: string[];
-    hintOverrides?: Map<string, HintOverrides>;
+    hintOverrides?: Map<string | number, HintOverrides>;
     hintVars?: Map<string, string>;
 }
 /**
@@ -64,9 +62,8 @@ export declare class FeatureResolver {
      * @returns Resolved rendition configuration
      */
     resolve(baseSettings: GveRenditionSettings, features: Feature[] | undefined, nodeFeatureContext?: {
-        nodeFeatures: Record<string, OperationFeature[]>;
+        refNodes: CharNode[];
         outputTag: string;
-        refNodeIds: number[];
     }): RenditionConfig;
     /**
      * Extract character offsets from init features.
@@ -89,7 +86,9 @@ export declare class FeatureResolver {
     getRenditionFeatureValue(features: Feature[] | undefined, featureName: string): string | undefined;
     /**
      * Parse r_h-* hint override features.
-     * Format: "value" applies to all hints, or "@hintId1 hintId2:value" applies to specific hints.
+     * Format: "value" applies to all hints, or "@target1 target2:value" applies to specific hints.
+     * Targets can be hint ID strings or 1-based ordinal integers (e.g., "@1 beta:e" targets
+     * the first hint by position and all hints with key "beta"). Numbers and keys can be mixed.
      *
      * @param featureName - The feature name (e.g., "r_h-position")
      * @param value - The feature value

package/dist/rendering/hint-renderer.d.ts

@@ -4,7 +4,6 @@ import { OperationHint } from "../settings/hint-models";
 import { Logger } from "../core/logger";
 import { AnimationEngine } from "../animation/animation-engine";
 import { BoundsCache } from "./bounds-cache";
-import { SpreadingEngine } from "./spreading-engine";
 import { HintOverrides } from "./feature-resolver";
 /**
  * Hint renderer handles rendering of operation hints.
@@ -15,8 +14,7 @@ export declare class HintRenderer {
     private _logger;
     private _animationEngine;
     private _boundsCache;
-    private _spreadingEngine;
-    constructor(settings: GveRenditionSettings, logger: Logger, animationEngine: AnimationEngine, boundsCache: BoundsCache, spreadingEngine: SpreadingEngine);
+    constructor(settings: GveRenditionSettings, logger: Logger, animationEngine: AnimationEngine, boundsCache: BoundsCache);
     /**
      * Render a hint for an operation.
      *
@@ -35,7 +33,7 @@ export declare class HintRenderer {
      * @param viewportHeight - Height of the visible viewport (for prolog)
      * @returns Promise that resolves when rendering completes
      */
-    renderHint(hintId: string, hint: OperationHint, referenceNodes: CharNode[], rootSvg: SVGElement, variables: Map<string, string>, operationId: string, hintOrdinal: number, allBaseNodes: CharNode[], versionTag: string, hintOverrides?: Map<string, HintOverrides>, panZoomInstance?: any, viewportWidth?: number, viewportHeight?: number): Promise<void>;
+    renderHint(hintId: string, hint: OperationHint, referenceNodes: CharNode[], rootSvg: SVGElement, variables: Map<string, string>, operationId: string, hintOrdinal: number, allBaseNodes: CharNode[], versionTag: string, hintOverrides?: Map<string | number, HintOverrides>, panZoomInstance?: any, viewportWidth?: number, viewportHeight?: number): Promise<void>;
     /**
      * Calculate Reference Bounding Rectangles (RBRs) from reference nodes.
      * Nodes on different lines create separate RBRs.
@@ -86,18 +84,14 @@ export declare class HintRenderer {
      * This is the point on the EBR that should align with the RBR alignment point.
      */
     private calculateEBRAlignmentPoint;
-    /**
-     * Handle spreading for solid hints.
-     * @param versionTag - Version tag for tracking spreading history
-     */
-    private handleSpreading;
     /**
      * Apply r_h-* overrides to hint properties.
-     * Overrides can target specific hints or all hints ("*").
+     * Priority (lowest to highest): wildcard ("*") < key-based < ordinal-based.
      *
      * @param hint - Original hint design
-     * @param hintId - ID of the hint being rendered
-     * @param hintOverrides - Map of overrides from r_h-* features
+     * @param hintId - ID (key) of the hint being rendered
+     * @param hintOrdinal - 1-based ordinal position of this hint within the operation
+     * @param hintOverrides - Map of overrides from r_h-* features (keyed by ID string or ordinal number)
      * @param allBaseNodes - All base nodes for displaced span resolution
      * @returns Modified hint with overrides applied
      */

package/dist/rendering/text-layout.d.ts

@@ -1,6 +1,7 @@
 import { CharNode } from "../models";
 import { GveRenditionSettings } from "../settings/settings";
 import { Logger } from "../core/logger";
+import { RenditionConfig } from "./feature-resolver";
 /**
  * Position information for a character node.
  */
@@ -58,7 +59,7 @@ export declare class TextLayout {
     calculateBaseTextPositions(nodes: CharNode[], charOffsets?: Map<number, {
         x?: number | string;
         y?: number | string;
-    }>): CharPosition[];
+    }>, nodeConfigs?: Map<number, RenditionConfig>): CharPosition[];
     /**
      * Calculate position for a single additional text node.
      * Additional text positioning is driven by rendition features.

package/dist/rendering/text-renderer.d.ts

@@ -3,7 +3,6 @@ import { GveRenditionSettings } from "../settings/settings";
 import { Logger } from "../core/logger";
 import { AnimationEngine } from "../animation/animation-engine";
 import { BoundsCache } from "./bounds-cache";
-import { SpreadingEngine } from "./spreading-engine";
 import { RenditionConfig } from "./feature-resolver";
 /**
  * Text renderer handles rendering of base text and additional text.
@@ -13,9 +12,7 @@ export declare class TextRenderer {
     private _logger;
     private _animationEngine;
     private _boundsCache;
-    private _spreadingEngine;
     private _textLayout;
-    private _featureResolver;
     /**
      * Reference to the root SVG element for text width measurements.
      * This ensures measurements happen in the same CSS context as rendering,
@@ -23,7 +20,7 @@ export declare class TextRenderer {
      * that apply global CSS styles to document.body.
      */
     private _measurementRoot?;
-    constructor(settings: GveRenditionSettings, logger: Logger, animationEngine: AnimationEngine, boundsCache: BoundsCache, spreadingEngine: SpreadingEngine);
+    constructor(settings: GveRenditionSettings, logger: Logger, animationEngine: AnimationEngine, boundsCache: BoundsCache);
     /**
      * Render base text (v0).
      *
@@ -35,7 +32,7 @@ export declare class TextRenderer {
     renderBaseText(nodes: CharNode[], rootSvg: SVGElement, charOffsets?: Map<number, {
         x?: number | string;
         y?: number | string;
-    }>): Promise<void>;
+    }>, nodeConfigs?: Map<number, RenditionConfig>): Promise<void>;
     /**
      * Render a single character node.
      */
@@ -58,21 +55,25 @@ export declare class TextRenderer {
     /**
      * Calculate positions for additional text characters.
      * Additional text flows left to right from the base position.
+     * When config is provided its font metrics are used for character width
+     * measurement, matching what applyTextStyle will actually render.
      */
     private calculateAdditionalTextPositions;
     /**
-     * Calculate RBRs from reference nodes.
-     * Nodes on different lines create separate RBRs.
+     * Calculate the RBR anchor point for a given position type.
+     * This is the point on the RBR where the corresponding EBR point will land.
      */
-    private calculateRBRs;
+    private calculateRBRAlignmentPoint;
     /**
-     * Calculate target position on the RBR based on position type.
+     * Calculate the EBR anchor point for a given position type.
+     * This is the point on the EBR that should coincide with the RBR anchor point.
      */
-    private calculateTargetPosition;
+    private calculateEBRAlignmentPoint;
     /**
-     * Calculate bounding rectangle for a set of positioned characters.
+     * Calculate RBRs from reference nodes.
+     * Nodes on different lines create separate RBRs.
      */
-    private calculateTextBounds;
+    private calculateRBRs;
     /**
      * Update settings.
      */

package/dist/settings/hint-models.d.ts

@@ -46,11 +46,6 @@ export interface OperationHint {
      * Rotation is applied with reference to the origin of the reference bounding rectangle.
      */
     rotation: number;
-    /**
-     * Whether this hint is "solid" and requires spreading.
-     * Default: false (most hints are overlays that don't need spreading)
-     */
-    solid?: boolean;
     /**
      * JS code for animating the hint's entrance via GSAP.
      * If it starts with "#", it references an animation from settings.animations.

package/dist/settings/settings.d.ts

@@ -78,8 +78,6 @@ export interface GveRenditionSettings {
     animations: Record<string, string>;
     /** ID of animation to use for each character (from animations catalog) */
     charAnimationId?: string;
-    /** Duration in milliseconds for spreading animation (0=no animation) */
-    spreadTime: number;
     /** Duration in milliseconds for element fade-out animation
      * (backward navigation only): 0=no animation */
     backwardFadeOutTime: number;
@@ -88,8 +86,6 @@ export interface GveRenditionSettings {
     prologDuration: number;
     /** Dictionary of hints, keyed by hint ID */
     hints: Record<string, OperationHint>;
-    /** Margin around each rendered hint in pixels */
-    hintMargin: number;
     /** Design-time width used when creating hints */
     hintDesignWidth: number;
     /** Design-time height used when creating hints */

package/dist/ui/details-area.d.ts

@@ -71,6 +71,7 @@ export declare class DetailsArea {
     updateHoveredElements(hoveredElements: Array<{
         element: SVGTextElement;
         node: CharNode;
+        versionTag: string;
     }>): void;
     /**
      * Render hovered elements with pin button.
@@ -83,7 +84,7 @@ export declare class DetailsArea {
     /**
      * Pin a specific element (triggered by click).
      */
-    pinElement(element: SVGTextElement, node: CharNode): void;
+    pinElement(element: SVGTextElement, node: CharNode, versionTag: string): void;
     /**
      * Filter features based on hidden features setting.
      */

package/dist/ui/hilites.d.ts

@@ -1,5 +1,4 @@
 import { Logger } from "../core/logger";
-import { CharChainResult } from "../models";
 /**
  * Hilites manager - handles creating and animating hilite rectangles.
  */
@@ -21,20 +20,15 @@ export declare class Hilites {
     updateSettings(hilitePadding: number, hiliteFadeTime: number): void;
     /**
      * Show hilites for a specific version.
-     * @param data - The CharChainResult data
-     * @param versionTag - Version tag to hilite
+     * @param nodeIds - IDs of nodes to hilite (from versionNodeIds[versionTag])
+     * @param versionTag - Version tag label (for logging)
      * @param color - Hilite color
      */
-    showHilites(data: CharChainResult, versionTag: string, color: string): Promise<void>;
+    showHilites(nodeIds: number[], versionTag: string, color: string): Promise<void>;
     /**
      * Clear all hilites.
      */
     clearHilites(): Promise<void>;
-    /**
-     * Get node IDs for a specific version.
-     * For v0, if not found in taggedNodes, falls back to extracting from base text.
-     */
-    private getVersionNodeIds;
     /**
      * Create a hilite rectangle for a text element.
      *

package/dist/ui/operation-summary-service.d.ts

@@ -32,17 +32,14 @@ export declare class OperationSummaryService {
      */
     getNodeText(nodeId: number, versionTag: string): string;
     /**
-     * Get a node by ID, searching in version tagged nodes.
-     *
-     * Searches backwards from the specified version to v0. Since v0 is normalized
-     * and added to taggedNodes by the component during data processing, no special
-     * handling is needed.
+     * Get a node by ID from the flat nodes array.
+     * All nodes (including deleted ones) are always present.
      *
      * @param nodeId - Node ID
-     * @param versionTag - Version tag to search in (searches backwards if not found)
+     * @param versionTag - Unused in new model; kept for API compatibility
      * @returns The node, or null
      */
-    getNode(nodeId: number, versionTag: string): CharNode | null;
+    getNode(nodeId: number, versionTag?: string): CharNode | null;
     /**
      * Get text from a span of nodes.
      * @param nodeIds - Array of node IDs

package/package.json

@@ -1,73 +1,82 @@
-{
-  "name": "@myrmidon/gve-snapshot-rendition",
-  "version": "2.0.4",
-  "homepage": "https://github.com/vedph/gve-snapshot-rendition",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/vedph/gve-snapshot-rendition"
-  },
-  "author": "Daniele Fusi",
-  "license": "",
-  "description": "Web components for rendering interactive text transformations with hint designer. This package is an early version published for internal evaluation and staging use only. A final open-source license will be published later.",
-  "keywords": [
-    "snapshot",
-    "rendition",
-    "VEdition",
-    "genetic-philology",
-    "hint-designer",
-    "text-transformation"
-  ],
-  "main": "./dist/index.js",
-  "type": "module",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
-    }
-  },
-  "files": [
-    "dist",
-    "README.md",
-    "LICENSE"
-  ],
-  "dependencies": {
-    "fast-diff": "^1.3.0",
-    "feather-icons": "^4.29.2",
-    "golden-layout": "^2.6.0",
-    "gsap": "^3.15.0",
-    "highlight.js": "^11.11.1",
-    "svg-pan-zoom": "^3.6.2",
-    "tslib": "^2.8.1",
-    "typescript": "^6.0.3"
-  },
-  "devDependencies": {
-    "@rollup/plugin-commonjs": "^29.0.2",
-    "@rollup/plugin-node-resolve": "^16.0.3",
-    "@rollup/plugin-replace": "^6.0.3",
-    "@rollup/plugin-terser": "^1.0.0",
-    "@rollup/plugin-typescript": "^12.3.0",
-    "@vitest/ui": "^4.1.6",
-    "concurrency": "^0.1.4",
-    "concurrently": "^9.2.1",
-    "lite-server": "^2.6.1",
-    "rollup": "^4.60.3",
-    "source-map-loader": "^5.0.0",
-    "ts-loader": "^9.5.7",
-    "typescript": "^6.0.3",
-    "vitest": "^4.1.6"
-  },
-  "optionalDependencies": {
-    "@rollup/rollup-win32-arm64-msvc": "^4.60.3"
-  },
-  "scripts": {
-    "build": "rollup -c",
-    "watch": "rollup -c -w",
-    "start": "concurrently \"rollup -c -w\" \"lite-server\"",
-    "start:designer": "concurrently \"rollup -c -w\" \"lite-server -c bs-config.designer.json\"",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test-ui": "vitest --ui",
-    "publish:public": "npm publish --access=public"
-  }
-}
+{
+  "name": "@myrmidon/gve-snapshot-rendition",
+  "version": "2.0.6",
+  "homepage": "https://github.com/vedph/gve-snapshot-rendition",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vedph/gve-snapshot-rendition"
+  },
+  "author": "Daniele Fusi",
+  "license": "",
+  "description": "Web components for rendering interactive text transformations with hint designer. This package is an early version published for internal evaluation and staging use only. A final open-source license will be published later.",
+  "keywords": [
+    "snapshot",
+    "rendition",
+    "VEdition",
+    "genetic-philology",
+    "hint-designer",
+    "text-transformation"
+  ],
+  "main": "./dist/index.js",
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "clean": "node -e \"require('fs').rmSync('dist', {recursive:true, force:true})\"",
+    "build": "pnpm run clean && rollup -c",
+    "watch": "rollup -c -w",
+    "start": "concurrently \"rollup -c -w\" \"lite-server\"",
+    "start:designer": "concurrently \"rollup -c -w\" \"lite-server -c bs-config.designer.json\"",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test-ui": "vitest --ui",
+    "prepublishOnly": "pnpm run test && pnpm run build",
+    "prepack": "pnpm run build",
+    "publish:public": "npm publish --access=public"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "packageManager": "pnpm@11.9.0",
+  "dependencies": {
+    "fast-diff": "^1.3.0",
+    "feather-icons": "^4.29.2",
+    "golden-layout": "^2.6.0",
+    "gsap": "^3.15.0",
+    "highlight.js": "^11.11.1",
+    "svg-pan-zoom": "^3.6.2",
+    "tslib": "^2.8.1",
+    "typescript": "^6.0.3"
+  },
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "^29.0.3",
+    "@rollup/plugin-node-resolve": "^16.0.3",
+    "@rollup/plugin-replace": "^6.0.3",
+    "@rollup/plugin-terser": "^1.0.0",
+    "@rollup/plugin-typescript": "^12.3.0",
+    "@vitest/ui": "^4.1.9",
+    "concurrency": "^0.1.4",
+    "concurrently": "^10.0.3",
+    "lite-server": "^2.6.1",
+    "rollup": "^4.62.2",
+    "source-map-loader": "^5.0.0",
+    "ts-loader": "^9.6.2",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.9"
+  },
+  "optionalDependencies": {
+    "@rollup/rollup-win32-arm64-msvc": "^4.62.2"
+  },
+  "pnpm": {
+    "overrides": {
+      "rollup": "npm:@rollup/wasm-node"
+    }
+  }
+}

package/dist/rendering/spreading-engine.d.ts

@@ -1,98 +0,0 @@
-import { BoundsCache, BoundingRect } from "./bounds-cache";
-import { Logger } from "../core/logger";
-/**
- * Result of spreading calculation.
- */
-export interface SpreadingResult {
-    /** Map of element ID to its horizontal shift amount */
-    horizontalShifts: Map<string, number>;
-    /** Map of element ID to its vertical shift amount */
-    verticalShifts: Map<string, number>;
-    /** Whether any spreading was needed */
-    hasShifts: boolean;
-}
-/**
- * Metadata about spreading applied to an element for a specific version.
- */
-export interface SpreadingMetadata {
-    /** Version index that caused this spreading */
-    versionIndex: number;
-    /** Horizontal shift applied (in pixels) */
-    horizontalShift: number;
-    /** Vertical shift applied (in pixels) */
-    verticalShift: number;
-}
-/**
- * Engine for calculating spreading (making room for new elements).
- * Implements the "stone in pond" ripple effect to preserve layout.
- */
-export declare class SpreadingEngine {
-    private _boundsCache;
-    private _logger;
-    /**
-     * Map of element ID to array of spreading metadata (one per version).
-     * Each element can be shifted multiple times by different versions.
-     */
-    private _spreadingHistory;
-    constructor(boundsCache: BoundsCache, logger: Logger);
-    /**
-     * Track spreading metadata for elements affected by a version.
-     * Called after spreading is applied to record what happened.
-     *
-     * @param versionIndex - Version index that caused the spreading
-     * @param horizontalShifts - Map of element IDs to horizontal shifts
-     * @param verticalShifts - Map of element IDs to vertical shifts
-     */
-    trackSpreading(versionIndex: number, horizontalShifts: Map<string, number>, verticalShifts: Map<string, number>): void;
-    /**
-     * Get spreading metadata for elements affected by a specific version.
-     * Used when reversing spreading during backward navigation.
-     *
-     * @param versionIndex - Version index to get spreading for
-     * @returns Map of element ID to spreading metadata
-     */
-    getSpreadingForVersion(versionIndex: number): Map<string, SpreadingMetadata>;
-    /**
-     * Remove spreading history for a specific version.
-     * Called after spreading is reversed during backward navigation.
-     *
-     * @param versionIndex - Version index to remove history for
-     */
-    clearSpreadingForVersion(versionIndex: number): void;
-    /**
-     * Calculate spreading required to make room for a new element.
-     *
-     * @param newElementBounds - Bounds of the element to be added
-     * @param excludeIds - Element IDs to exclude from shifting (e.g., the new element itself)
-     * @returns Spreading result with shift amounts for each affected element
-     */
-    calculateSpreading(newElementBounds: BoundingRect, excludeIds?: string[]): SpreadingResult;
-    /**
-     * Calculate horizontal spreading.
-     * Elements overlapping on the left are shifted left, those on the right are shifted right.
-     */
-    private calculateHorizontalSpreading;
-    /**
-     * Calculate vertical spreading.
-     * Elements overlapping from above are shifted up, those from below are shifted down.
-     */
-    private calculateVerticalSpreading;
-    /**
-     * Calculate the horizontal overlap between two bounding rectangles.
-     * Returns 0 if there is no overlap.
-     */
-    private calculateHorizontalOverlap;
-    /**
-     * Calculate the vertical overlap between two bounding rectangles.
-     * Returns 0 if there is no overlap.
-     */
-    private calculateVerticalOverlap;
-    /**
-     * Check if two bounding rectangles overlap.
-     */
-    checkOverlap(rect1: BoundingRect, rect2: BoundingRect): boolean;
-    /**
-     * Find all elements that overlap with given bounds.
-     */
-    findOverlappingElements(bounds: BoundingRect, excludeIds?: string[]): string[];
-}