@myrmidon/gve-snapshot-rendition 2.0.5 → 2.0.7

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

@@ -1,356 +0,0 @@
-import { HintDesignerData, HintDesignerSettings, StringPair } from "./hint-designer-models";
-/**
- * GVE Hint Designer Web Component.
- * A minimalist editing environment to design hints and test their animations.
- */
-export declare class GveHintDesigner extends HTMLElement {
-    private _data;
-    private _settings;
-    private _hintId?;
-    private _hintVariables;
-    private _logger;
-    private _shadow;
-    private _svgDisplay?;
-    private _messagePanel?;
-    private _zoomLevel;
-    private _panX;
-    private _panY;
-    private _isPanning;
-    private _lastPanX;
-    private _lastPanY;
-    private _svgTextarea?;
-    private _jsTextarea?;
-    private _svgHighlightContainer?;
-    private _jsHighlightContainer?;
-    private _hintsDropdown?;
-    private _svgWordWrapEnabled;
-    private _jsWordWrapEnabled;
-    private _animationsDropdown?;
-    private _embeddedJsCheckbox?;
-    private _newAnimationCheckbox?;
-    private _positionSelect?;
-    private _offsetXInput?;
-    private _offsetYInput?;
-    private _scaleXInput?;
-    private _scaleYInput?;
-    private _rotationInput?;
-    private _displacedRefSpanInput?;
-    private _variablesTable?;
-    private _playButton?;
-    private _pauseButton?;
-    private _restartButton?;
-    private _progressBar?;
-    private _variablesValidationMsg?;
-    private _variablesPanelHeader?;
-    private _currentTimeline?;
-    private _isPlaying;
-    private _progressUpdateInterval?;
-    constructor();
-    /**
-     * Called when component is added to the DOM.
-     */
-    connectedCallback(): void;
-    /**
-     * Called when component is removed from the DOM.
-     */
-    disconnectedCallback(): void;
-    /**
-     * Data property (bindable).
-     */
-    get data(): HintDesignerData;
-    set data(value: HintDesignerData);
-    /**
-     * Settings property (bindable).
-     */
-    get settings(): HintDesignerSettings;
-    set settings(value: HintDesignerSettings);
-    /**
-     * Hint ID property (bindable).
-     */
-    get hintId(): string | undefined;
-    set hintId(value: string | undefined);
-    /**
-     * Hint variables property (bindable).
-     */
-    get hintVariables(): StringPair[];
-    set hintVariables(value: StringPair[]);
-    /**
-     * Render the component UI.
-     */
-    private render;
-    /**
-     * Create the toolbar.
-     */
-    private createToolbar;
-    /**
-     * Create the SVG display panel.
-     */
-    private createSvgDisplay;
-    /**
-     * Add grid and rulers to the SVG display as background.
-     */
-    private addGridAndRulers;
-    /**
-     * Create the timeline player.
-     */
-    private createTimelinePlayer;
-    /**
-     * Create the message panel.
-     */
-    private createMessagePanel;
-    /**
-     * Create the hint properties editor.
-     */
-    private createHintPropertiesEditor;
-    /**
-     * Create the hint variables list.
-     */
-    private createHintVariablesList;
-    /**
-     * Create a button element with a Feather icon.
-     */
-    private createButton;
-    /**
-     * Create an input element.
-     */
-    private createInput;
-    /**
-     * Create a form row with label and control.
-     */
-    private createFormRow;
-    /**
-     * Create position select dropdown.
-     */
-    private createPositionSelect;
-    /**
-     * Make a splitter resizable between two panels.
-     * @param panelAbove The panel above the splitter
-     * @param _panelBelow The panel below the splitter (unused but kept for API clarity)
-     * @param splitter The splitter element between them
-     */
-    private makeResizable;
-    /**
-     * Initialize event listeners.
-     */
-    private initializeEventListeners;
-    /**
-     * Initialize panning with mouse drag.
-     */
-    private initializePanning;
-    /**
-     * Initialize zooming with mouse wheel.
-     */
-    private initializeWheelZoom;
-    /**
-     * Add click listener to a button by ID.
-     */
-    private addClickListener;
-    /**
-     * Cleanup resources.
-     */
-    private cleanup;
-    /**
-     * Refresh the entire UI.
-     */
-    private refreshUI;
-    /**
-     * Refresh the hints dropdown.
-     */
-    private refreshHintsDropdown;
-    /**
-     * Refresh the animations dropdown.
-     */
-    private refreshAnimationsDropdown;
-    /**
-     * Load a hint for editing.
-     */
-    private loadHint;
-    /**
-     * Clear the hint form.
-     */
-    private clearHintForm;
-    /**
-     * Validate SVG code for well-formedness and structure.
-     * Returns an error message if validation fails, or null if valid.
-     */
-    private validateSvgCode;
-    /**
-     * Add a new hint.
-     */
-    private addHint;
-    /**
-     * Save the current hint.
-     */
-    private saveHint;
-    /**
-     * Delete the current hint.
-     */
-    private deleteHint;
-    /**
-     * Parse offset value (number or string with suffix).
-     */
-    private parseOffset;
-    /**
-     * Refresh the SVG display.
-     */
-    private refreshSvgDisplay;
-    /**
-     * Resolve variables in SVG code.
-     */
-    private resolveVariables;
-    /**
-     * Extract variable names from SVG code (variables in {{...}} placeholders).
-     */
-    private extractVariablesFromSvg;
-    /**
-     * Validate SVG variables and update validation message.
-     * Shows a warning if any variables used in SVG are not defined in hint variables.
-     */
-    private validateSvgVariables;
-    /**
-     * Update warning icon in variables panel header.
-     */
-    private updateVariablesHeaderWarning;
-    /**
-     * Play animation.
-     */
-    private playAnimation;
-    /**
-     * Create the GSAP timeline for the current hint.
-     */
-    private createTimeline;
-    /**
-     * Pause animation.
-     */
-    private pauseAnimation;
-    /**
-     * Restart animation.
-     */
-    private restartAnimation;
-    /**
-     * Seek animation (timeline scrubbing).
-     */
-    private seekAnimation;
-    /**
-     * Start updating progress bar.
-     */
-    private startProgressUpdate;
-    /**
-     * Stop updating progress bar.
-     */
-    private stopProgressUpdate;
-    /**
-     * Zoom in.
-     */
-    private zoomIn;
-    /**
-     * Zoom out.
-     */
-    private zoomOut;
-    /**
-     * Reset zoom.
-     */
-    private resetZoom;
-    /**
-     * Update SVG transform based on zoom and pan.
-     */
-    private updateSvgTransform;
-    /**
-     * Size to fit the SVG content.
-     */
-    private sizeToFit;
-    /**
-     * Toggle word wrap for SVG textarea.
-     */
-    private toggleSvgWordWrap;
-    /**
-     * Toggle word wrap for JS textarea.
-     */
-    private toggleJsWordWrap;
-    /**
-     * Save data to file.
-     */
-    private saveData;
-    /**
-     * Load data from file.
-     */
-    private loadData;
-    /**
-     * Clear all data.
-     */
-    private clearData;
-    /**
-     * Export the current hint as an InkScape-compatible SVG file.
-     */
-    private exportToInkscape;
-    /**
-     * Load animation code from catalog.
-     */
-    private loadAnimationCode;
-    /**
-     * Add a new variable.
-     */
-    private addVariable;
-    /**
-     * Delete a variable.
-     */
-    private deleteVariable;
-    /**
-     * Edit a variable.
-     */
-    private editVariable;
-    /**
-     * Delete all variables.
-     */
-    private deleteAllVariables;
-    /**
-     * Extract all variable names from all hints in data.
-     * Returns a sorted array of unique variable names.
-     */
-    private extractAllVariablesFromHints;
-    /**
-     * Populate hint variables from all hints.
-     * Extracts all variables from all hints' SVG code and merges them into hintVariables.
-     * Only adds variables that don't already exist.
-     */
-    private populateVariablesFromHints;
-    /**
-     * 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.
-     */
-    private showMessage;
-    /**
-     * Apply syntax highlighting to SVG textarea.
-     */
-    private highlightSvg;
-    /**
-     * Apply syntax highlighting to JS textarea.
-     */
-    private highlightJs;
-    /**
-     * Sync scroll position for SVG textarea and highlight container.
-     */
-    private syncSvgScroll;
-    /**
-     * Sync scroll position for JS textarea and highlight container.
-     */
-    private syncJsScroll;
-    /**
-     * Fire a custom event.
-     */
-    private fireEvent;
-    /**
-     * Get component styles.
-     */
-    private getStyles;
-}

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

@@ -1,32 +0,0 @@
-import { OperationHint } from "../settings/hint-models";
-/**
- * String name-value pair used for hint variables.
- */
-export interface StringPair {
-    name: string;
-    value: string;
-}
-/**
- * Data model for the hint designer component.
- */
-export interface HintDesignerData {
-    /** Dictionary of hints, keyed by hint ID */
-    hints: Record<string, OperationHint>;
-    /** Catalog of animation JS code fragments, keyed by ID */
-    animations: Record<string, string>;
-}
-/**
- * Settings for the hint designer component.
- */
-export interface HintDesignerSettings {
-    /** Width of the hint's SVG design area in the editor */
-    hintDesignWidth: number;
-    /** Height of the hint's SVG design area in the editor */
-    hintDesignHeight: number;
-    /** Debug mode for verbose logging */
-    debug: boolean;
-}
-/**
- * Default settings for the hint designer component.
- */
-export declare const DEFAULT_HINT_DESIGNER_SETTINGS: HintDesignerSettings;

package/dist/src/index.d.ts

@@ -1,17 +0,0 @@
-/**
- * GVE Snapshot Rendition Component
- *
- * A web component for rendering interactive text transformations
- * based on the GVE snapshot model.
- */
-export { GveSnapshotRendition } from "./core/gve-snapshot-rendition";
-export { GveHintDesigner } from "./hint-designer/gve-hint-designer";
-export type { RelativePosition } from "./core/gve-snapshot-rendition";
-export type { GveRenditionSettings, CustomButtonSettings, } from "./settings/settings";
-export type { OperationHint } from "./settings/hint-models";
-export { DEFAULT_SETTINGS } from "./settings/settings";
-export type { HintDesignerData, HintDesignerSettings, StringPair, } from "./hint-designer/hint-designer-models";
-export { DEFAULT_HINT_DESIGNER_SETTINGS } from "./hint-designer/hint-designer-models";
-export { OperationSummaryService } from "./ui/operation-summary-service";
-export type { Feature, OperationFeature, OperationSource, OperationDiplomatics, OperationMetadata, CharChainOperation, CharNode, ChainOperationContextStep, CharChainResult, ChainOperationTags, CharChainNode, CharChainLink, CharChain, } from "./models";
-export { FeatureSetPolicy, OperationType } from "./models";

package/dist/src/models.d.ts

@@ -1,171 +0,0 @@
-/**
- * Generic name=value feature.
- */
-export interface Feature {
-    name: string;
-    value: string;
-    setPolicy: FeatureSetPolicy;
-}
-/**
- * Operation feature set policy.
- */
-export declare enum FeatureSetPolicy {
-    multiple = 0,
-    single = 1,
-    singleFirst = 2
-}
-/**
- * Operation feature.
- */
-export interface OperationFeature extends Feature {
-    isNegated?: boolean;
-    isGlobal?: boolean;
-    isShortLived?: boolean;
-}
-/**
- * Source about a text variant. This is typically used when
- * variants come from different witnesses.
- */
-export interface OperationSource {
-    id: string;
-    type: string;
-    rank?: number;
-    note?: string;
-}
-/**
- * Diplomatic data for a text variant.
- */
-export interface OperationDiplomatics {
-    g: string;
-    isNewTextHidden?: boolean;
-    features?: Feature[];
-    elementFeatures?: Record<string, Feature[]>;
-}
-/**
- * Generic metadata about a text variant generation operation.
- */
-export interface OperationMetadata {
-    type: OperationType;
-    id: string;
-    rank?: number;
-    groupId?: string;
-    features?: OperationFeature[];
-    sources?: OperationSource[];
-    diplomatics?: OperationDiplomatics;
-}
-/**
- * Type of a text operation.
- */
-export declare enum OperationType {
-    replace = 0,
-    delete = 1,
-    addBefore = 2,
-    addAfter = 3,
-    moveBefore = 4,
-    moveAfter = 5,
-    swap = 6,
-    annotate = 7
-}
-/**
- * Metadata of a char-based chain operation.
- */
-export interface CharChainOperation extends OperationMetadata {
-    at: number;
-    atAsIndex?: boolean;
-    to?: number;
-    toAsIndex?: boolean;
-    inputTag?: string;
-    outputTag?: string;
-    run: number;
-    toRun?: number;
-    value?: string;
-    noTraceFeatures?: boolean;
-    dsl?: string;
-}
-/**
- * A single character node in an operation execution result.
- */
-export interface CharNode {
-    id: number;
-    index: number;
-    label: string;
-    data: string;
-    sourceTag?: string;
-    /** 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. */
-    operation: CharChainOperation;
-    /** The input version tag. */
-    inputTag: string;
-    /** The output version tag. */
-    outputTag: string;
-    /** The string synthetically representing the resulting text version. */
-    result?: string;
-    /** The reference node IDs of the operation which was executed. */
-    refNodeIds: number[];
-}
-/**
- * Result of execution of a char-based chain.
- */
-export interface CharChainResult {
-    /** 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[];
-    /**
-     * All character nodes in the chain (base text and added nodes).
-     * Node features are keyed by version tag.
-     */
-    nodes: CharNode[];
-    /**
-     * IDs of nodes forming each version's text, keyed by version tag.
-     * Includes v0 (base text).
-     */
-    versionNodeIds: Record<string, number[]>;
-    /**
-     * Global features accumulated up to each version, keyed by version tag.
-     * Includes v0 (empty list).
-     */
-    globalFeatures: Record<string, OperationFeature[]>;
-}
-/**
- * The input and output tags of a char-based chain operation.
- */
-export interface ChainOperationTags {
-    inputTag: string;
-    outputTag: string;
-}
-/**
- * The node of a character-based chain, used for diagnostic
- * or demonstration purposes.
- */
-export interface CharChainNode {
-    id: number;
-    label: string;
-    data: string;
-    sourceTag?: string;
-}
-/**
- * The link of a character-based chain, used for diagnostic
- * or demonstration purposes.
- */
-export interface CharChainLink {
-    tag: string;
-    sourceId: number;
-    targetId: number;
-}
-/**
- * The character-based chain, as resulting from running operations
- * on a base text, used for diagnostic or demonstration purposes.
- */
-export interface CharChain {
-    nodes: CharChainNode[];
-    links: CharChainLink[];
-}

package/dist/src/rendering/bounds-cache.d.ts

@@ -1,62 +0,0 @@
-import { Logger } from "../core/logger";
-/**
- * Bounding rectangle with position and dimensions.
- */
-export interface BoundingRect {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-    right: number;
-    bottom: number;
-}
-/**
- * Cache for storing bounding rectangles of SVG elements.
- * This avoids expensive getBBox() calls and improves spreading performance.
- */
-export declare class BoundsCache {
-    private _cache;
-    private _logger;
-    constructor(logger: Logger);
-    /**
-     * Add or update a bounding rectangle for an element.
-     */
-    set(elementId: string, bounds: DOMRect | SVGRect): void;
-    /**
-     * Get the bounding rectangle for an element.
-     */
-    get(elementId: string): BoundingRect | undefined;
-    /**
-     * Check if an element's bounds are cached.
-     */
-    has(elementId: string): boolean;
-    /**
-     * Remove bounds for an element.
-     */
-    delete(elementId: string): void;
-    /**
-     * Clear all cached bounds.
-     */
-    clear(): void;
-    /**
-     * Get all cached element IDs.
-     */
-    getAllIds(): string[];
-    /**
-     * Get all cached bounds.
-     */
-    getAllBounds(): BoundingRect[];
-    /**
-     * Update bounds for an element by ID from the DOM.
-     * Returns true if successful, false if element not found.
-     */
-    updateFromElement(element: SVGElement): boolean;
-    /**
-     * Get the bounding rectangle that encloses multiple elements.
-     */
-    getUnionBounds(elementIds: string[]): BoundingRect | undefined;
-    /**
-     * Get the number of cached items.
-     */
-    size(): number;
-}