@myrmidon/gve-snapshot-rendition 2.0.5 → 2.0.6

package/dist/adapter/data-feature-adapter.d.ts

@@ -16,9 +16,8 @@ export declare class DataFeatureAdapter {
      * Returns a new copy of the data with adapted features.
      *
      * Features adapted:
-     * - steps[i].featureSet.features (global features)
-     * - steps[i].featureSet.nodeFeatures (node-specific features)
-     * - taggedNodes[version][i].features (features on nodes)
+     * - globalFeatures[tag][i] (global features per version)
+     * - nodes[i].features[tag][j] (per-node, per-version features)
      *
      * Features NOT adapted:
      * - steps[i].operation.features (operation metadata)

package/dist/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/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;
@@ -30,13 +29,26 @@ export declare class GveSnapshotRendition extends HTMLElement {
     private _hilites?;
     private _panZoomInstance?;
     private _keyboardHandler?;
+    private _goldenLayout?;
+    private _versionsListEl?;
+    private _svgContainerEl?;
+    private _versionTextEl?;
+    private _detailsEl?;
+    /**
+     * Get the library version.
+     * This value is injected at build time via @rollup/plugin-replace
+     * from package.json. It allows consumers to verify which version
+     * of the web component is loaded.
+     */
+    static get version(): string;
     private _baseNodes;
-    private _versionPalette;
+    private _nodeMap;
     private _slideshowTimerId;
     private _currentVersion;
     private _currentVersionIndex;
     private _autoForwardEnabled;
     private _autoForwardTimerId;
+    private _renderScheduled;
     constructor();
     /**
      * Observed attributes for the web component.
@@ -81,6 +93,36 @@ export declare class GveSnapshotRendition extends HTMLElement {
      * Render the component UI.
      */
     private render;
+    /**
+     * Wire up the drag-to-resize handle at the bottom of the component.
+     * Dragging it adjusts the host element's inline height, which overrides
+     * the --gve-height CSS variable while keeping GL's ResizeObserver in sync.
+     */
+    private setupBottomResizeHandle;
+    /**
+     * Initialize Golden Layout with the four resizable panels.
+     * The SVG rendition panel has no header and acts as the fixed background.
+     */
+    private initializeGoldenLayout;
+    /**
+     * Default layout: mirrors the original Split.js arrangement.
+     *  Column:
+     *    Row (60 %): VersionsList (15 %) | TextRendition (85 %, no header)
+     *    Row (40 %): VersionText (60 %)  | Details (40 %)
+     */
+    private getDefaultLayout;
+    /**
+     * Reset layout to default panel sizes by reloading the default config.
+     */
+    resetLayout(): void;
+    /**
+     * Coalesce concurrent render requests into a single call.
+     * Multiple same-turn invocations (e.g. settings setter + data setter both
+     * firing in the same Angular expression) collapse into one microtask render,
+     * always running after all synchronous assignments have completed so the
+     * latest data is used.
+     */
+    private scheduleRenderContent;
     /**
      * Render content (base text only - starts at v0).
      * Use goToVersionIndex() to navigate to specific versions.
@@ -91,11 +133,6 @@ export declare class GveSnapshotRendition extends HTMLElement {
      * Enables mouse wheel zoom, click-and-drag pan, with configurable limits.
      */
     private initializePanZoom;
-    /**
-     * Process operations to render text transformations.
-     * Processes operations in order, rendering hints and additional text.
-     */
-    private processOperations;
     /**
      * Process a single operation step.
      */
@@ -105,34 +142,18 @@ export declare class GveSnapshotRendition extends HTMLElement {
      */
     private processOperationInternal;
     /**
-     * Get reference nodes for an operation using node IDs from trace features.
-     * Reference nodes are the nodes affected by the operation.
-     *
-     * According to the snapshot model, deleted nodes are not included in subsequent
-     * versions' taggedNodes. To find a deleted node, we must search backwards through
-     * previous versions until we find it.
+     * Get reference nodes for an operation from the flat node map.
+     * All nodes (including deleted ones) are always present in the map.
      *
-     * @param nodeIds - Array of node IDs from step.refNodeIds (extracted from trace features)
-     * @param inputTag - The input version tag to look for nodes (e.g., "v11")
+     * @param nodeIds - Array of node IDs from step.refNodeIds
+     * @param inputTag - Kept for API compatibility; unused in new model
      * @returns Array of CharNode objects matching the IDs
      */
     private getReferenceNodes;
-    /**
-     * Find a node by ID, searching backwards through versions if needed.
-     * This handles the case where a node was deleted in a previous version but
-     * is still referenced by a later operation (e.g., to add a hint to a deleted node).
-     *
-     * Searches backwards from the specified version to v0. Since v0 is now normalized
-     * and added to taggedNodes during data processing, no special handling is needed.
-     *
-     * @param nodeId - The node ID to find
-     * @param startTag - The version tag to start searching from (e.g., "v11")
-     * @returns The node if found, undefined otherwise
-     */
-    private findNodeById;
     /**
      * Get nodes added by a specific operation.
-     * These are nodes with opid feature matching the operation ID.
+     * Nodes added by an operation carry an `opid` feature in their per-version
+     * features for the output tag.
      *
      * @param operationId - The operation ID to match
      * @param outputTag - The output version tag (e.g., "v3") where the nodes were added
@@ -162,6 +183,11 @@ export declare class GveSnapshotRendition extends HTMLElement {
      * Set up hover listeners on all text elements to update details area.
      */
     private setupTextElementHoverListeners;
+    /**
+     * Get the node from the node map by its SVG element ID.
+     * Returns the node and the version tag at which to read its features.
+     */
+    private getNodeForElement;
     /**
      * Handle hover over a text element.
      */
@@ -170,6 +196,10 @@ export declare class GveSnapshotRendition extends HTMLElement {
      * Handle leaving a text element.
      */
     private handleTextElementLeave;
+    /**
+     * Handle click on a text element (for pinning).
+     */
+    private handleTextElementClick;
     /**
      * Navigate forward by processing operations one by one.
      * Each operation adds hints and/or text that persist for all future versions.
@@ -189,6 +219,12 @@ export declare class GveSnapshotRendition extends HTMLElement {
      * Extract char offsets from first operation if it's an annotate.
      */
     private extractCharOffsets;
+    /**
+     * Extract per-node rendition configs from the first operation if it's an annotate.
+     * This allows init features like r_font-size, r_fore-color, etc. to override
+     * the component-wide settings for specific base text nodes.
+     */
+    private extractInitNodeConfigs;
     /**
      * Zoom in by configured step amount.
      */
@@ -217,6 +253,11 @@ export declare class GveSnapshotRendition extends HTMLElement {
      * Handle toolbar navigation actions.
      */
     private handleToolbarNavigation;
+    /**
+     * Returns true when the given version tag is a staged version.
+     * Checks globalFeatures (from new API) for a "version" feature.
+     */
+    private isStagedVersion;
     /**
      * Navigate to previous staged version.
      */
@@ -312,7 +353,7 @@ export declare class GveSnapshotRendition extends HTMLElement {
      */
     private toggleHilites;
     /**
-     * Get component styles.
+     * Get component styles (includes inlined GL CSS for Shadow DOM compatibility).
      */
     private getStyles;
 }

package/dist/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?;
@@ -280,6 +279,10 @@ export declare class GveHintDesigner extends HTMLElement {
      * Clear all data.
      */
     private clearData;
+    /**
+     * Export the current hint as an InkScape-compatible SVG file.
+     */
+    private exportToInkscape;
     /**
      * Load animation code from catalog.
      */
@@ -315,6 +318,13 @@ export declare class GveHintDesigner extends HTMLElement {
      * Refresh the variables table.
      */
     private refreshVariablesTable;
+    /**
+     * Update the highlighted state of all Hint Properties form rows.
+     * Rows whose value differs from the default get the form-row--modified class.
+     */
+    private updateFormFieldHighlights;
+    private isOffsetModified;
+    private setFormRowModified;
     /**
      * Show a message in the message panel.
      */