@naniteninja/profile-comparison-lib 1.0.3 → 1.0.6

package/index.d.ts

@@ -1,10 +1,39 @@
 import * as i0 from '@angular/core';
 import { InjectionToken, OnInit, AfterViewInit, OnChanges, EventEmitter, ElementRef, Renderer2, ChangeDetectorRef, SimpleChanges } from '@angular/core';
 import { Observable, BehaviorSubject } from 'rxjs';
+import * as i2 from '@angular/common';
 import * as i3 from '@angular/common/http';
 import { HttpClient } from '@angular/common/http';
-import * as i2 from '@angular/common';
 import * as i4 from '@angular/forms';
+import * as i5 from '@naniteninja/ionic-lib';
+
+/** Backend mode for the profile comparison component. */
+declare enum BackendMode {
+    /** Use the real deployed backend (default). */
+    Real = 0,
+    /** Use a local mock server at localhost:3000. */
+    Mock = 1
+}
+declare const BACKEND_MODE_URLS: Record<BackendMode, string>;
+/** Either a static base URL or a getter that returns the current base URL (for runtime toggle). */
+type ProfileComparisonApiBaseUrl = string | (() => string | null);
+/**
+ * Legacy injection token for the backend base URL.
+ * Prefer using the [backendMode] or [backendUrl] @Input on the component instead.
+ * Kept for backward compatibility — lowest priority when resolving the URL.
+ */
+declare const PROFILE_COMPARISON_API_BASE_URL: InjectionToken<ProfileComparisonApiBaseUrl | null>;
+/** Optional getter: when true, lib and backend service log steps to console for diagnosis. */
+declare const PROFILE_COMPARISON_VERBOSE_LOGGING: InjectionToken<() => boolean>;
+/**
+ * Resolves the active backend URL from inputs, with fallback to injection token.
+ *
+ * Priority:
+ * 1. Explicit backendUrl (custom URL string)
+ * 2. BackendMode enum (Real or Mock)
+ * 3. Legacy PROFILE_COMPARISON_API_BASE_URL token
+ */
+declare function resolveBackendUrl(backendUrl: string | null | undefined, backendMode: BackendMode, legacyTokenUrl: string | null | undefined): string | null;
 
 interface IProfileConfig {
     person1Interests: string[];
@@ -12,6 +41,8 @@ interface IProfileConfig {
     person3Interests: string[];
     user1Image: string;
     user2Image: string;
+    edgeShading?: boolean;
+    shadingColor?: string;
 }
 
 interface IBoundingBox {
@@ -177,6 +208,7 @@ interface IComparisonPayload {
     centerItem: string[];
     matrixData: IMatrixData | null;
     rawLLMOutput?: string;
+    debug?: any;
 }
 
 declare const STORE_NAMES: readonly ["openai-spacer", "openai-alignment", "openai-similarity", "openai-embeddings", "profile-face", "profile-compare"];
@@ -204,53 +236,6 @@ declare class CachePersistenceService {
     static ɵprov: i0.ɵɵInjectableDeclaration<CachePersistenceService>;
 }
 
-declare class EmbeddingService {
-    private model$;
-    getEmbedding(text: string): Observable<Float32Array>;
-    /**
-     * Group-align two lists based on semantic similarity, allowing one-to-many relationships.
-     *
-     * Design goals:
-     * - Semantic relevance takes priority over original order or spacing.
-     * - Each term in listB is assigned to the single most similar anchor in listA (if above threshold).
-     * - For an anchor in listA with multiple highly related listB terms, they are emitted as consecutive rows:
-     *   [A, B1], ['-', B2], ['-', B3], ... so they render adjacently and remain visually connected.
-     * - Low-similarity/unassigned terms from either side are appended at the end and never break groups.
-     */
-    groupAlignLists(listA: string[], listB: string[], threshold?: number, preserveLeftOrder?: boolean, exclusivityMargin?: number, leftCohesion?: number): Observable<IAlignmentRow[]>;
-    cosineSimilarity(a: Float32Array, b: Float32Array): number;
-    /**
-     * Align words in listA with their most semantically similar words in listB
-     *
-     * Algorithm:
-     * 1. Generate embeddings for all words in both lists using Universal Sentence Encoder
-     * 2. For each word in listA, compare its embedding with all words in listB
-     * 3. Find the word in listB with highest cosine similarity score
-     * 4. Return alignment results with similarity scores
-     *
-     * @param listA - Source list of words to align
-     * @param listB - Target list of words to find matches in
-     * @returns Observable of alignment results with word, alignedWith, score, and index
-     */
-    alignLists(listA: string[], listB: string[]): Observable<IWordAlignment[]>;
-    /**
-     * Find best matching pairs between two lists above a similarity threshold
-     *
-     * @param listA - Source list of words
-     * @param listB - Target list of words to match against
-     * @param threshold - Minimum similarity score (0-1, default: 0.15)
-     * @returns Observable of word pairs with similarity scores
-     */
-    findBestMatchingPairs(listA: string[], listB: string[], threshold?: number): Observable<IWordPair[]>;
-    calculateSimilarity(primaryText: string, comparisonText: string): Observable<number>;
-    testWordSimilarity(word1: string, word2: string): Observable<void>;
-    private domainCompatibilityCap;
-    private computeLexicalBoost;
-    private loadModel;
-    static ɵfac: i0.ɵɵFactoryDeclaration<EmbeddingService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<EmbeddingService>;
-}
-
 declare class FileConversionService {
     private static readonly MIME_TYPE_JPEG;
     private static readonly MIME_TYPE_PNG;
@@ -281,18 +266,6 @@ declare class ImageCompressionService {
     static ɵprov: i0.ɵɵInjectableDeclaration<ImageCompressionService>;
 }
 
-/** Either a static base URL or a getter that returns the current base URL (for runtime toggle). */
-type ProfileComparisonApiBaseUrl = string | (() => string | null);
-/**
- * When provided, ProfileService and OpenAIEmbeddingService call this backend base URL
- * (e.g. 'http://localhost:3000/api') for all profile/embedding endpoints instead of
- * calling external APIs directly with keys. Can be a string or a getter function for runtime toggle.
- * When not provided or getter returns null, the lib uses the direct path with keys.
- */
-declare const PROFILE_COMPARISON_API_BASE_URL: InjectionToken<ProfileComparisonApiBaseUrl | null>;
-/** Optional getter: when true, lib and backend service log steps to console for diagnosis. */
-declare const PROFILE_COMPARISON_VERBOSE_LOGGING: InjectionToken<() => boolean>;
-
 /**
  * OpenAI Alignment Service
  * Uses OpenAI Chat Completions API to align two lists of text in a single request.
@@ -417,12 +390,16 @@ declare class ProfileService {
 declare class ProfileComparisonBackendService {
     private http;
     private apiBaseUrl;
-    private getVerboseLogging?;
-    constructor(http: HttpClient, apiBaseUrl: ProfileComparisonApiBaseUrl | null, getVerboseLogging?: (() => boolean) | undefined);
+    private getVerboseLogging;
+    constructor();
+    static extractErrorMessage(err: unknown): string;
     private log;
+    /** Returns the legacy token URL (for backward compat fallback). */
+    getLegacyTokenUrl(): string | null;
+    /** @deprecated Use getLegacyTokenUrl(). Kept for backward compat. */
     getBaseUrl(): string | null;
-    getComparison(config: IProfileConfig): Observable<IComparisonPayload>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<ProfileComparisonBackendService, [null, { optional: true; }, { optional: true; }]>;
+    getComparison(config: IProfileConfig, baseUrl?: string | null): Observable<IComparisonPayload>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ProfileComparisonBackendService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<ProfileComparisonBackendService>;
 }
 
@@ -447,6 +424,7 @@ declare class ProfileComparisonLibComponent implements OnInit, AfterViewInit, On
     private static readonly DEFAULT_MAX_HEIGHT;
     private static readonly SPACER_SMALL;
     private static readonly SPACER_LARGE;
+    private static readonly PLACEHOLDER;
     private static readonly CONSOLIDATION_SEPARATOR_X;
     private static readonly CONSOLIDATION_SEPARATOR_SLASH;
     private static readonly FACEPP_RATE_LIMIT_DELAY_MS;
@@ -465,6 +443,8 @@ declare class ProfileComparisonLibComponent implements OnInit, AfterViewInit, On
     private static readonly TRANSFORM_RESET;
     private static readonly TRANSITION_RESET_DELAY_MS;
     config: IProfileConfig;
+    backendMode: BackendMode;
+    backendUrl: string | null;
     fadeAllEdges: boolean;
     matrixDataChange: EventEmitter<IMatrixData>;
     rawLLMOutputChange: EventEmitter<string>;
@@ -505,6 +485,8 @@ declare class ProfileComparisonLibComponent implements OnInit, AfterViewInit, On
     alignedPerson2Interests: string[];
     leftProfileClicked: boolean;
     rightProfileClicked: boolean;
+    leftShapeAnimating: boolean;
+    rightShapeAnimating: boolean;
     sortedA: {
         item: string;
         score: number;
@@ -522,21 +504,19 @@ declare class ProfileComparisonLibComponent implements OnInit, AfterViewInit, On
     matrixData: IMatrixData | null;
     /** When false, backend URL is not provided — show "Configure backend". */
     backendConfigured: boolean;
+    /** The resolved backend URL computed from inputs and legacy token. */
+    private resolvedBackendUrl;
     compressionConfig: IImageCompressionConfig;
     private computeSub?;
     /** Incremented on each fetchComparison(); used to ignore stale success/error from an older request. */
     private fetchRequestId;
     leftContainer: ElementRef;
     rightContainer: ElementRef;
-    profileFlex: ElementRef<HTMLElement>;
-    profileImgLeft: ElementRef<HTMLElement>;
-    profileImgRight: ElementRef<HTMLElement>;
+    leftFrame: ElementRef<HTMLElement>;
+    rightFrame: ElementRef<HTMLElement>;
+    leftBgFrame: ElementRef<HTMLElement>;
+    rightBgFrame: ElementRef<HTMLElement>;
     shapeContainer: ElementRef<HTMLElement>;
-    shapeBg: ElementRef<HTMLElement>;
-    shapeBg1: ElementRef<SVGElement>;
-    shapeBg2: ElementRef<SVGElement>;
-    shapeTextLeft: ElementRef<HTMLElement>;
-    shapeTextRight: ElementRef<HTMLElement>;
     shapeTextCenter: ElementRef<HTMLElement>;
     constructor(backendService: ProfileComparisonBackendService, renderer: Renderer2, fileConversionService: FileConversionService, imageCompressionService: ImageCompressionService, cdr: ChangeDetectorRef, getVerboseLogging?: (() => boolean) | undefined);
     private log;
@@ -547,6 +527,27 @@ declare class ProfileComparisonLibComponent implements OnInit, AfterViewInit, On
     ngOnChanges(changes: SimpleChanges): void;
     /** Use for template: hide left/right item when it's a shared (center) item. Compares case-insensitively. */
     isInCenter(interest: string): boolean;
+    /**
+     * Returns true if the value is a placeholder string consisting only of one or more dashes.
+     * Handles variations like "-", "---", "----", etc.
+     */
+    /**
+     * Returns true if we should show a dash on the side instead of the text.
+     * This happens if:
+     * 1. The interest is a placeholder (----).
+     * 2. The interest exactly matches the center label at that index (to avoid redundancy).
+     */
+    shouldShowDash(interest: string, index: number): boolean;
+    /**
+     * Returns true if the center label at the current index is a repeat of the one above it.
+     * This is used to "collapse" repeating categories into dashes.
+     */
+    isCenterRedundant(index: number): boolean;
+    /**
+     * Reorders the aligned results so that items with identical center labels follow each other.
+     */
+    private regroupByCenterLabel;
+    isPlaceholder(val: unknown): boolean;
     private fetchComparison;
     private updateConfigProperties;
     private buildConfigWithDefaults;
@@ -558,6 +559,7 @@ declare class ProfileComparisonLibComponent implements OnInit, AfterViewInit, On
     waitForImagesAndInitDrag(): void;
     initDrag(): void;
     onViewProfile(side: 'left' | 'right'): void;
+    onShapeClick(side: 'left' | 'right'): void;
     private compressConfigImagesIfNeeded;
     private compressImageStringToDataUrl;
     getEyeCoordinatesFromBBox(bbox: IBoundingBox): {
@@ -582,14 +584,14 @@ declare class ProfileComparisonLibComponent implements OnInit, AfterViewInit, On
     applyDefaultAlignment(): void;
     isValidFaceData(face: IBoundingBox): boolean;
     static ɵfac: i0.ɵɵFactoryDeclaration<ProfileComparisonLibComponent, [null, null, null, null, null, { optional: true; }]>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<ProfileComparisonLibComponent, "lib-profile-comparison", never, { "config": { "alias": "config"; "required": false; }; "fadeAllEdges": { "alias": "fadeAllEdges"; "required": false; }; }, { "matrixDataChange": "matrixDataChange"; "rawLLMOutputChange": "rawLLMOutputChange"; "viewProfileClick": "viewProfileClick"; }, never, never, false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ProfileComparisonLibComponent, "lib-profile-comparison", never, { "config": { "alias": "config"; "required": false; }; "backendMode": { "alias": "backendMode"; "required": false; }; "backendUrl": { "alias": "backendUrl"; "required": false; }; "fadeAllEdges": { "alias": "fadeAllEdges"; "required": false; }; }, { "matrixDataChange": "matrixDataChange"; "rawLLMOutputChange": "rawLLMOutputChange"; "viewProfileClick": "viewProfileClick"; }, never, never, false, never>;
 }
 
 declare class ProfileComparisonLibModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<ProfileComparisonLibModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<ProfileComparisonLibModule, [typeof ProfileComparisonLibComponent], [typeof i2.CommonModule, typeof i3.HttpClientModule, typeof i4.FormsModule, typeof i4.ReactiveFormsModule], [typeof ProfileComparisonLibComponent]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<ProfileComparisonLibModule, [typeof ProfileComparisonLibComponent], [typeof i2.CommonModule, typeof i3.HttpClientModule, typeof i4.FormsModule, typeof i4.ReactiveFormsModule, typeof i5.LibMarqueeModule], [typeof ProfileComparisonLibComponent]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<ProfileComparisonLibModule>;
 }
 
-export { CachePersistenceService, EmbeddingService, FileConversionService, ImageCompressionService, OpenAIEmbeddingService, PROFILE_COMPARISON_API_BASE_URL, PROFILE_COMPARISON_VERBOSE_LOGGING, ProfileComparisonBackendService, ProfileComparisonLibComponent, ProfileComparisonLibModule, ProfileComparisonLibService, ProfileService };
+export { BACKEND_MODE_URLS, BackendMode, CachePersistenceService, FileConversionService, ImageCompressionService, OpenAIEmbeddingService, PROFILE_COMPARISON_API_BASE_URL, PROFILE_COMPARISON_VERBOSE_LOGGING, ProfileComparisonBackendService, ProfileComparisonLibComponent, ProfileComparisonLibModule, ProfileComparisonLibService, ProfileService, resolveBackendUrl };
 export type { CacheStoreName, FaceDetectionData, FaceDetectionResponse, FileInputEvent, IAlignmentRow, IBoundingBox, IComparisonPayload, IComparisonResult, IEnvironment, IFaceBoxWithLandmarks, IFaceDetectionResult, IFaceLandmarks, IFacePlusPlusFace, IFacePlusPlusResponse, IFaceRectangle, IImageCompressionConfig, IMatrixData, IMatrixLegendItem, IMatrixRow, IOpenAIEmbeddingItem, IOpenAIResponse, IPoint, IProfileConfig, ISimilarityResponse, ISimilarityThreshold, IWordAlignment, IWordPair };

package/package.json

@@ -1,14 +1,12 @@
 {
   "name": "@naniteninja/profile-comparison-lib",
-  "version": "1.0.3",
+  "version": "1.0.6",
   "peerDependencies": {
     "@angular/common": "^20.0.0",
     "@angular/core": "^20.0.0"
   },
   "dependencies": {
-    "tslib": "^2.3.0",
-    "@tensorflow-models/universal-sentence-encoder": "^1.3.3",
-    "@tensorflow/tfjs": "^4.22.0"
+    "tslib": "^2.3.0"
   },
   "module": "fesm2022/naniteninja-profile-comparison-lib.mjs",
   "typings": "index.d.ts",