@myrmidon/gve-snapshot-rendition 1.0.2 → 2.0.2

package/dist/src/animation/animation-engine.d.ts

@@ -21,19 +21,6 @@ export declare class AnimationEngine {
      * @returns Promise that resolves when animation completes
      */
     animate(element: SVGElement, animation: AnimationFunction, rootElement: SVGElement): Promise<void>;
-    /**
-     * Animate multiple elements with spreading transitions.
-     * All elements are animated in parallel with GSAP.
-     *
-     * @param shifts - Map of element IDs to their shift amounts {x, y}
-     * @param duration - Duration in milliseconds
-     * @param rootElement - The root SVG element containing all elements
-     * @returns Promise that resolves when all animations complete
-     */
-    animateSpreading(shifts: Map<string, {
-        x: number;
-        y: number;
-    }>, duration: number, rootElement: SVGElement): Promise<void>;
     /**
      * Fade in multiple elements (used for hilites).
      *

package/dist/src/core/gve-snapshot-rendition.d.ts

@@ -16,7 +16,6 @@ export declare class GveSnapshotRendition extends HTMLElement {
     private _logger;
     private _animationEngine?;
     private _boundsCache;
-    private _spreadingEngine;
     private _textRenderer?;
     private _hintRenderer?;
     private _featureResolver;

package/dist/src/hint-designer/gve-hint-designer.d.ts

@@ -34,7 +34,6 @@ export declare class GveHintDesigner extends HTMLElement {
     private _scaleXInput?;
     private _scaleYInput?;
     private _rotationInput?;
-    private _solidCheckbox?;
     private _displacedRefSpanInput?;
     private _variablesTable?;
     private _playButton?;

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

@@ -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>;
 }
 /**
@@ -88,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/src/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/src/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).
      *
@@ -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/src/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/src/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@myrmidon/gve-snapshot-rendition",
-  "version": "1.0.2",
+  "version": "2.0.2",
   "homepage": "https://github.com/vedph/gve-snapshot-rendition",
   "repository": {
     "type": "git",
@@ -47,18 +47,18 @@
     "@rollup/plugin-replace": "^6.0.3",
     "@rollup/plugin-terser": "^1.0.0",
     "@rollup/plugin-typescript": "^12.3.0",
-    "@vitest/ui": "^4.1.5",
+    "@vitest/ui": "^4.1.6",
     "concurrency": "^0.1.4",
     "concurrently": "^9.2.1",
     "lite-server": "^2.6.1",
-    "rollup": "^4.60.2",
+    "rollup": "^4.60.3",
     "source-map-loader": "^5.0.0",
     "ts-loader": "^9.5.7",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.5"
+    "vitest": "^4.1.6"
   },
   "optionalDependencies": {
-    "@rollup/rollup-win32-arm64-msvc": "^4.60.2"
+    "@rollup/rollup-win32-arm64-msvc": "^4.60.3"
   },
   "scripts": {
     "build": "rollup -c",