@memberjunction/ng-core-entity-forms 5.32.0 → 5.34.0

package/dist/lib/custom/SearchScopes/searchscope-form.component.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Custom SearchScope form (P2D.7 Angular half).
+ *
+ * Adds a "Reranker" custom section that:
+ *   - Renders a dropdown of registered rerankers — currently a hardcoded list
+ *     mirroring `BaseReRanker.GetAvailableRerankers()` server-side, with each
+ *     option's HasCost flag surfaced inline so authors can see at a glance
+ *     which options will incur API spend.
+ *   - Reads / writes the current selection from `record.ScopeConfig` JSON's
+ *     `reRanker.driverClass` key — same path the SearchEngine reads at runtime.
+ *
+ * **Discovery follow-up:** the canonical source of available rerankers is
+ * `BaseReRanker.GetAvailableRerankers()` in `@memberjunction/search-engine`,
+ * but that's a Node-only package and can't be imported in the browser.
+ * A small GraphQL query (e.g. `AvailableRerankers`) on MJServer that calls
+ * the helper server-side would let this dropdown auto-discover any
+ * third-party reranker registered with ClassFactory. Tracked as a follow-up
+ * — for now the hardcoded list covers the 5 rerankers shipped in Phase 2D.
+ *
+ * The CodeGen-generated `RerankerBudgetCents` numeric input is already on
+ * the form (in the "Details" section); we don't need to recreate it.
+ * The dropdown above + budget input below give scope authors the full
+ * Phase 2D configuration surface.
+ */
+import { OnDestroy } from '@angular/core';
+import { MJSearchScopeEntity } from '@memberjunction/core-entities';
+import { SearchResultItem, StreamingProviderStatus } from '@memberjunction/ng-search';
+import { MJSearchScopeFormComponent } from '../../generated/Entities/MJSearchScope/mjsearchscope.form.component';
+import * as i0 from "@angular/core";
+interface FusionWeightRow {
+    /** Source-type key the SearchEngine matches against (e.g. 'vector', 'fulltext'). */
+    Key: string;
+    /** Friendly label for the slider — same value as Key today, kept separate for future i18n. */
+    Label: string;
+    /** Working value of the slider (1-decimal precision) — bound via two-way. */
+    Weight: number;
+}
+interface RerankerOption {
+    DriverClass: string;
+    Name: string;
+    HasCost: boolean;
+}
+export declare class MJSearchScopeFormComponentExtended extends MJSearchScopeFormComponent implements OnDestroy {
+    record: MJSearchScopeEntity;
+    readonly AvailableRerankers: RerankerOption[];
+    /** Live-preview state (P4.1). */
+    PreviewQuery: string;
+    PreviewIsRunning: boolean;
+    PreviewResults: SearchResultItem[];
+    PreviewProviders: StreamingProviderStatus[];
+    PreviewElapsedMs: number | null;
+    PreviewError: string | null;
+    private previewSubscription;
+    private searchService;
+    /**
+     * P4.3 — A/B comparison via Kendall-tau between consecutive preview runs.
+     * After RunPreview completes, the previous run's RecordIDs are diffed
+     * against the current run and the rank-correlation similarity is shown
+     * inline ("82% similar to last run"). Authors use this to immediately
+     * see how much a reranker swap or fusion-weight tweak shifted the ranking.
+     */
+    private PreviousRunRecordIDs;
+    LastRunSimilarityPercent: number | null;
+    ngOnDestroy(): void;
+    /**
+     * P4.1 — run a streaming preview against this scope. Uses the same
+     * SearchService.StreamSearch path the production search UI uses, scoped
+     * to just this scope's ID. Renders progressively as each provider
+     * reports back so authors can see chip-by-chip what each tuning change
+     * actually affects.
+     */
+    RunPreview(): void;
+    CancelPreview(): void;
+    /**
+     * Compute Kendall-tau rank correlation on the items present in both lists.
+     * Items only in one list are ignored (partial-overlap handling). Returns
+     * null when the shared overlap is too small (< 2 items) to be meaningful.
+     *
+     * Tau formula: (concordant - discordant) / (N * (N-1) / 2)
+     * where concordant = pairs ranked in the same order in both lists,
+     * discordant = pairs ranked in opposite order, N = shared item count.
+     */
+    private static kendallTauOnSharedItems;
+    /**
+     * Override the section list to include the new "Reranker" section before
+     * "Details". The generated `initSections()` doesn't know about our custom
+     * section so we replace the list. Order matches the template's render order.
+     */
+    ngOnInit(): Promise<void>;
+    /**
+     * Currently-selected reranker driver class, parsed from `record.ScopeConfig`.
+     * Empty string means "no reranker explicitly chosen" — runtime defaults
+     * to NoopReRanker. Stored as `ScopeConfig.reRanker.driverClass`.
+     */
+    get SelectedRerankerDriverClass(): string;
+    set SelectedRerankerDriverClass(value: string);
+    /**
+     * Whether the currently-selected reranker incurs API cost — used to render
+     * an inline cost-warning indicator next to the dropdown.
+     */
+    get SelectedRerankerHasCost(): boolean;
+    /**
+     * Whether the CSV export is currently running. Drives the button's disabled
+     * state + spinner.
+     */
+    IsExportingTuningCsv: boolean;
+    /**
+     * P4.2 — fusion weight sliders for each canonical SearchEngine source type.
+     * Backed by `SearchScope.ScopeConfig.fusionWeights` JSON (the runtime path
+     * — see plans/search-scopes-rag-plus/RAG_plan.md §8 Multi-Scope RRF Fusion). Plan task originally
+     * proposed `SearchScopeProvider.Weight` but that column doesn't exist in
+     * Phase 1; the JSON path is the actual contract the SearchEngine reads.
+     */
+    private _fusionWeights;
+    get FusionWeights(): FusionWeightRow[];
+    /**
+     * Persist a fusion weight change back to `ScopeConfig.fusionWeights`. The
+     * caller is the slider's `(change)` event so writes happen only on
+     * slide-end, not on every drag tick.
+     */
+    OnFusionWeightChanged(row: FusionWeightRow, raw: number | string): void;
+    /**
+     * P3.4 — export the last 500 SearchExecutionLog rows for this scope as CSV.
+     * Used by scope authors for offline tuning analysis (open in a spreadsheet,
+     * pivot by reranker / status / latency, etc.). Filtered to this scope's ID
+     * so multi-tenant deployments don't leak other scopes' query history.
+     */
+    ExportTuningCsv(): Promise<void>;
+    private downloadCsv;
+    private escapeCsv;
+    private parseScopeConfig;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MJSearchScopeFormComponentExtended, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MJSearchScopeFormComponentExtended, "mj-searchscope-form-extended", never, {}, {}, never, never, false, never>;
+}
+export declare function LoadMJSearchScopeFormComponentExtended(): void;
+export {};
+//# sourceMappingURL=searchscope-form.component.d.ts.map

package/dist/lib/custom/SearchScopes/searchscope-form.component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchscope-form.component.d.ts","sourceRoot":"","sources":["../../../../src/lib/custom/SearchScopes/searchscope-form.component.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,EAAa,SAAS,EAAE,MAAM,eAAe,CAAC;AAGrD,OAAO,EAAE,mBAAmB,EAAkC,MAAM,+BAA+B,CAAC;AAGpG,OAAO,EAAiB,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACrG,OAAO,EAAE,0BAA0B,EAAE,MAAM,qEAAqE,CAAC;;AAEjH,UAAU,eAAe;IACrB,oFAAoF;IACpF,GAAG,EAAE,MAAM,CAAC;IACZ,8FAA8F;IAC9F,KAAK,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,MAAM,EAAE,MAAM,CAAC;CAClB;AAUD,UAAU,cAAc;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CACpB;AAeD,qBAOa,kCAAmC,SAAQ,0BAA2B,YAAW,SAAS;IACnF,MAAM,EAAG,mBAAmB,CAAC;IAE7C,SAAgB,kBAAkB,EAAE,cAAc,EAAE,CAAsB;IAE1E,iCAAiC;IAC1B,YAAY,SAAM;IAClB,gBAAgB,UAAS;IACzB,cAAc,EAAE,gBAAgB,EAAE,CAAM;IACxC,gBAAgB,EAAE,uBAAuB,EAAE,CAAM;IACjD,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAQ;IACvC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC1C,OAAO,CAAC,mBAAmB,CAA6B;IACxD,OAAO,CAAC,aAAa,CAAuB;IAE5C;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB,CAAgB;IACrC,wBAAwB,EAAE,MAAM,GAAG,IAAI,CAAQ;IAEtC,WAAW,IAAI,IAAI;IAKnC;;;;;;OAMG;IACI,UAAU,IAAI,IAAI;IAiElB,aAAa,IAAI,IAAI;IAM5B;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM,CAAC,uBAAuB;IAuBtC;;;;OAIG;IACmB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAuB/C;;;;OAIG;IACH,IAAW,2BAA2B,IAAI,MAAM,CAG/C;IAED,IAAW,2BAA2B,CAAC,KAAK,EAAE,MAAM,EAUnD;IAED;;;OAGG;IACH,IAAW,uBAAuB,IAAI,OAAO,CAG5C;IAED;;;OAGG;IACI,oBAAoB,UAAS;IAEpC;;;;;;OAMG;IACH,OAAO,CAAC,cAAc,CAAkC;IAExD,IAAW,aAAa,IAAI,eAAe,EAAE,CAW5C;IAED;;;;OAIG;IACI,qBAAqB,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAsB9E;;;;;OAKG;IACU,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IA6B7C,OAAO,CAAC,WAAW;IAkCnB,OAAO,CAAC,SAAS;IAWjB,OAAO,CAAC,gBAAgB;yCA9Uf,kCAAkC;2CAAlC,kCAAkC;CAuV9C;AAED,wBAAgB,sCAAsC,IAAI,IAAI,CAI7D"}