@myrmidon/gve-snapshot-rendition 2.0.5 → 2.0.6

package/package.json

@@ -1,73 +1,82 @@
-{
-  "name": "@myrmidon/gve-snapshot-rendition",
-  "version": "2.0.5",
-  "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.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"
-  },
-  "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[];
-}

package/dist/src/adapter/adapter-models.d.ts

@@ -1,171 +0,0 @@
-/**
- * Models and types for the feature adapter system.
- */
-import { Feature } from "../models.js";
-/**
- * Comparison operator for feature matching.
- */
-export declare enum ComparisonOperator {
-    /** Equals (string) */
-    EQUALS = "=",
-    /** Not equals (string) */
-    NOT_EQUALS = "!=",
-    /** Starts with */
-    STARTS_WITH = "^=",
-    /** Ends with */
-    ENDS_WITH = "$=",
-    /** Contains */
-    CONTAINS = "*=",
-    /** Matches wildcards (? and *) */
-    MATCHES_WILDCARDS = "?=",
-    /** Matches regular expression */
-    MATCHES_REGEX = "~",
-    /** Numeric equals */
-    NUMERIC_EQUALS = "==",
-    /** Numeric not equals */
-    NUMERIC_NOT_EQUALS = "<>",
-    /** Numeric greater than */
-    NUMERIC_GT = ">",
-    /** Numeric less than */
-    NUMERIC_LT = "<",
-    /** Numeric greater than or equal */
-    NUMERIC_GTE = ">=",
-    /** Numeric less than or equal */
-    NUMERIC_LTE = "<="
-}
-/**
- * Logical operator for combining clauses.
- */
-export declare enum LogicalOperator {
-    AND = "AND",
-    OR = "OR",
-    AND_NOT = "AND NOT",
-    OR_NOT = "OR NOT"
-}
-/**
- * Token type for DSL parsing.
- */
-export declare enum TokenType {
-    /** Feature name */
-    NAME = 0,
-    /** Comparison operator */
-    OPERATOR = 1,
-    /** Value (quoted or unquoted) */
-    VALUE = 2,
-    /** Logical operator (AND, OR, AND NOT, OR NOT) */
-    LOGICAL = 3,
-    /** Left parenthesis */
-    LPAREN = 4,
-    /** Right parenthesis */
-    RPAREN = 5,
-    /** Left square bracket for group capture */
-    LBRACKET = 6,
-    /** Right square bracket for group capture */
-    RBRACKET = 7,
-    /** Colon (used in named groups) */
-    COLON = 8,
-    /** End of input */
-    EOF = 9
-}
-/**
- * Token from DSL parsing.
- */
-export interface Token {
-    type: TokenType;
-    value: string;
-    position: number;
-}
-/**
- * A single clause in a pattern (e.g., "name=value").
- */
-export interface Clause {
-    /** Feature name to match */
-    name: string;
-    /** Comparison operator (optional if just matching by name) */
-    operator?: ComparisonOperator;
-    /** Value to compare against (optional if just matching by name) */
-    value?: string;
-    /** Whether this clause should be captured as a group */
-    capture?: boolean;
-    /** Group name (if named capture), or undefined for numbered capture */
-    groupName?: string;
-}
-/**
- * Pattern expression node (for AST representation).
- */
-export interface PatternExpression {
-    type: "clause" | "logical";
-}
-/**
- * Clause expression node.
- */
-export interface ClauseExpression extends PatternExpression {
-    type: "clause";
-    clause: Clause;
-}
-/**
- * Logical expression node (binary operation).
- */
-export interface LogicalExpression extends PatternExpression {
-    type: "logical";
-    operator: LogicalOperator;
-    left: PatternExpression;
-    right: PatternExpression;
-}
-/**
- * Result of matching a pattern against features.
- */
-export interface MatchResult {
-    /** Whether the pattern matched */
-    matched: boolean;
-    /** Captured groups (keyed by group name or number as string) */
-    captures: Map<string, CapturedGroup>;
-    /** Features that were matched */
-    matchedFeatures: Feature[];
-}
-/**
- * A captured group from pattern matching.
- */
-export interface CapturedGroup {
-    name: string;
-    value: string;
-}
-/**
- * Mode for feature processing.
- */
-export declare enum ProcessingMode {
-    /** Add features without removing matched ones */
-    ADD = "add",
-    /** Replace: remove matched features, then add new ones */
-    REPLACE = "replace"
-}
-/**
- * A single adapter operation configuration.
- */
-export interface AdapterOperation {
-    /** Pattern DSL string to match features */
-    pattern: string;
-    /** Features to add (with format "name=value", can include placeholders) */
-    features: string[];
-    /** Processing mode (default: add) */
-    mode?: ProcessingMode;
-}
-/**
- * Configuration for the feature adapter.
- */
-export interface FeatureAdapterSettings {
-    /** List of adapter operations to apply in order */
-    operations: AdapterOperation[];
-}
-/**
- * Error thrown during DSL parsing or pattern matching.
- */
-export declare class AdapterError extends Error {
-    position?: number | undefined;
-    context?: string | undefined;
-    constructor(message: string, position?: number | undefined, context?: string | undefined);
-    /**
-     * Format error message with context.
-     */
-    toString(): string;
-}

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

@@ -1,30 +0,0 @@
-/**
- * Data feature adapter for applying feature transformations to CharChainResult data.
- */
-import { CharChainResult } from "../models";
-import { FeatureAdapterSettings } from "./adapter-models";
-/**
- * Adapter service that applies feature transformations to CharChainResult data.
- * This service creates a copy of the data and adapts all features except those
- * belonging to operation metadata.
- */
-export declare class DataFeatureAdapter {
-    private featureAdapter;
-    constructor(settings: FeatureAdapterSettings);
-    /**
-     * Adapt all features in the CharChainResult data.
-     * Returns a new copy of the data with adapted features.
-     *
-     * Features adapted:
-     * - 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)
-     */
-    adaptData(data: CharChainResult): CharChainResult;
-    /**
-     * Deep copy the CharChainResult data structure.
-     */
-    private deepCopyData;
-}

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

@@ -1,34 +0,0 @@
-/**
- * Feature adapter service for transforming feature sets.
- */
-import { FeatureAdapterSettings } from "./adapter-models";
-import { Feature } from "../models";
-/**
- * Service for adapting features based on configured operations.
- */
-export declare class FeatureAdapter {
-    private settings;
-    private compiledPatterns;
-    private matcher;
-    constructor(settings: FeatureAdapterSettings);
-    /**
-     * Adapt a feature array by applying all configured operations.
-     */
-    adapt(features: Feature[]): Feature[];
-    /**
-     * Apply a single operation to a feature array.
-     */
-    private applyOperation;
-    /**
-     * Create features from feature specifications, resolving placeholders.
-     */
-    private createFeatures;
-    /**
-     * Resolve placeholders in a string (e.g., $1.value, $color.name).
-     */
-    private resolvePlaceholders;
-    /**
-     * Pre-compile all patterns to detect errors early.
-     */
-    private compilePatterns;
-}

package/dist/src/adapter/index.d.ts

@@ -1,6 +0,0 @@
-/**
- * Feature adapter module - public API.
- */
-export { FeatureAdapter } from "./feature-adapter.js";
-export { DataFeatureAdapter } from "./data-feature-adapter.js";
-export type { FeatureAdapterSettings, AdapterOperation, ProcessingMode, ComparisonOperator, LogicalOperator, AdapterError, } from "./adapter-models.js";

package/dist/src/adapter/matcher.d.ts

@@ -1,38 +0,0 @@
-/**
- * Feature matching engine for the adapter.
- */
-import { PatternExpression, MatchResult } from "./adapter-models";
-import { Feature } from "../models";
-/**
- * Matches features against a pattern expression.
- */
-export declare class FeatureMatcher {
-    /**
-     * Match features against a parsed pattern expression.
-     */
-    match(features: Feature[], expression: PatternExpression): MatchResult;
-    /**
-     * Evaluate a pattern expression against features.
-     */
-    private evaluateExpression;
-    /**
-     * Evaluate a clause against features.
-     */
-    private evaluateClause;
-    /**
-     * Check if a single feature matches a clause.
-     */
-    private matchFeature;
-    /**
-     * Compare values using the specified operator.
-     */
-    private compareValues;
-    /**
-     * Match a value against a wildcard pattern (? and *).
-     */
-    private matchWildcard;
-    /**
-     * Compare numeric values.
-     */
-    private compareNumeric;
-}

package/dist/src/adapter/parser.d.ts

@@ -1,58 +0,0 @@
-/**
- * Parser for the feature adapter DSL.
- * Implements recursive descent parsing with operator precedence:
- * 1. NOT (highest)
- * 2. AND
- * 3. OR (lowest)
- */
-import { PatternExpression } from "./adapter-models";
-/**
- * Parser for DSL patterns.
- */
-export declare class Parser {
-    private input;
-    private tokens;
-    private position;
-    private current;
-    private groupCounter;
-    constructor(input: string);
-    /**
-     * Parse the pattern and return the AST.
-     */
-    parse(): PatternExpression;
-    /**
-     * Parse OR expression (lowest precedence).
-     * or_expr := and_expr (OR and_expr | OR NOT and_expr)*
-     */
-    private parseOrExpression;
-    /**
-     * Parse AND expression (middle precedence).
-     * and_expr := primary (AND primary | AND NOT primary)*
-     */
-    private parseAndExpression;
-    /**
-     * Parse primary expression (clause or grouped expression).
-     * primary := clause | '(' or_expr ')' | '[' clause ']' | '[' NAME ':' clause ']'
-     */
-    private parsePrimary;
-    /**
-     * Parse a captured clause: [name:clause] or [clause]
-     */
-    private parseCapturedClause;
-    /**
-     * Parse a clause: name [operator value]
-     */
-    private parseClause;
-    /**
-     * Advance to the next token.
-     */
-    private advance;
-    /**
-     * Peek at the next token without consuming it.
-     */
-    private peek;
-    /**
-     * Get context around a position for error messages.
-     */
-    private getContext;
-}

package/dist/src/adapter/tokenizer.d.ts

@@ -1,55 +0,0 @@
-/**
- * Tokenizer for the feature adapter DSL.
- */
-import { Token } from "./adapter-models";
-/**
- * Tokenizes a DSL pattern string into tokens.
- */
-export declare class Tokenizer {
-    private input;
-    private position;
-    private current;
-    private expectValue;
-    constructor(input: string);
-    /**
-     * Tokenize the entire input.
-     */
-    tokenize(): Token[];
-    /**
-     * Get the next token from input.
-     */
-    private nextToken;
-    /**
-     * Try to read a comparison operator.
-     */
-    private tryReadOperator;
-    /**
-     * Read a quoted string (handles escape sequences).
-     */
-    private readQuotedString;
-    /**
-     * Read a word (name or keyword).
-     */
-    private readWord;
-    /**
-     * Read an unquoted value (after an operator).
-     * Values can include special characters like *, ?, ^, $, etc.
-     */
-    private readUnquotedValue;
-    /**
-     * Peek at the next word without consuming it.
-     */
-    private peekWord;
-    /**
-     * Skip whitespace.
-     */
-    private skipWhitespace;
-    /**
-     * Advance to next character.
-     */
-    private advance;
-    /**
-     * Get context around current position for error messages.
-     */
-    private getContext;
-}