@thehammer/template-verification 0.2.5 → 0.2.7

package/dist/components/CitationEvidence.vue.d.ts

@@ -0,0 +1,33 @@
+import { type CitationEvidence } from "../lib/citations";
+/**
+ * The evidence behind one value: why the pipeline chose it, and every source page
+ * it cited with that page's own verbatim quotes.
+ *
+ * Replaces the retired single-blockquote treatment, which flattened every quote
+ * from every page into one string joined with ellipses — page attribution, the
+ * one thing a citation exists to establish, was unrecoverable from it.
+ *
+ * Reused by both the Inspector's Citations tab (collapsible, full size) and each
+ * History attempt's panel (`dense` + flat), so a losing attempt's citations read
+ * exactly like the winner's.
+ */
+type __VLS_Props = {
+    evidence: CitationEvidence;
+    /** Why the pipeline chose this value. Null renders no reasoning card. */
+    reasoning?: string | null;
+    /** verbatim = the value appears as-is in a quote; inferred = derived from it. */
+    basis?: "verbatim" | "inferred" | null;
+    /** SG-189: extraction/citation-correction failed — `reasoning` is the failure. */
+    failed?: boolean;
+    /** Collapse pages behind an accordion (off inside a History panel). */
+    collapsible?: boolean;
+    dense?: boolean;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    failed: boolean;
+    collapsible: boolean;
+    dense: boolean;
+    reasoning: string | null;
+    basis: "verbatim" | "inferred" | null;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/CitationPage.vue.d.ts

@@ -0,0 +1,27 @@
+import type { CitationPage } from "../lib/citations";
+/**
+ * The expanded body of one cited page: its page image on the left, its own
+ * ordered verbatim quotes on the right, and the page-level actions.
+ *
+ * Renders ONLY the body — the collapsed header row lives in
+ * {@link CitationPageList} because `DanxAccordion` renders its header as a
+ * `<button>`, and the view/download controls here are themselves buttons.
+ *
+ * The thumbnail is a `DanxFile` in `downloadable` mode: hovering it exposes
+ * danx-ui's own download control, and clicking it opens the full-screen viewer.
+ * A page whose file the host never resolved still renders its quotes; only the
+ * image and its actions are withheld.
+ */
+type __VLS_Props = {
+    page: CitationPage;
+    /** Compact treatment for the History tab's per-attempt citations. */
+    dense?: boolean;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    view: () => any;
+    document: () => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onView?: (() => any) | undefined;
+    onDocument?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/CitationPageList.vue.d.ts

@@ -0,0 +1,26 @@
+import type { CitationPage as CitationPageModel } from "../lib/citations";
+/**
+ * The cited-page list — one collapsible section per source page, each showing that
+ * page's own verbatim quotes, with a full-screen viewer behind every page and
+ * every parent document.
+ *
+ * Progressive disclosure is the point: a data point can cite many pages, so a
+ * collapsed row carries only what you need to decide whether to open it (page
+ * number, document, quote count, and the first quote truncated). Opening a row
+ * reveals the page image and the full quote list.
+ *
+ * `collapsible: false` renders the same content flat, for the History tab's
+ * per-attempt citations where the list is short and already inside a panel.
+ */
+type __VLS_Props = {
+    pages: CitationPageModel[];
+    /** Collapse pages behind an accordion. Off = every page always expanded. */
+    collapsible?: boolean;
+    /** Compact treatment, passed through to each page body. */
+    dense?: boolean;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    collapsible: boolean;
+    dense: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/components/VerificationModal.vue.d.ts

@@ -1,15 +1,19 @@
 import type { DataPointMeta, SourceChoice } from "../types";
 /**
  * The Inspector — per-data-point detail dialog. 90vw × 90vh danx-ui DanxDialog
- * with a hero strip (resolved value, confidence meter, source-of-truth chips,
- * discrepancy alert) over three tabs:
+ * with a hero strip (resolved value, confidence meter, source of truth,
+ * discrepancy alert) over four tabs:
  *
- *  - Evidence: reasoning (readonly MarkdownEditor), cited text, and an embedded
- *    DanxFileViewer over the cited source pages, plus per-distinct-document
- *    "view full document" drill-downs (stacked DanxDialogs — breadcrumb back-nav
- *    comes free from danx-ui's dialog stack).
+ *  - Citations: why this value, then one collapsible section per cited SOURCE
+ *    PAGE carrying that page's own verbatim quotes, each openable full screen
+ *    (zoomable, downloadable) with the page's quotes alongside. Replaces the
+ *    retired treatment that flattened every quote from every page into one
+ *    blockquote, which made page attribution unrecoverable.
  *  - Candidates: the resolution flow — one card per candidate with an Accept
  *    action, plus custom-value entry. Saving toasts + flips the in-document pill.
+ *  - History: the live value's confidence + reasoning above the full extraction
+ *    history; every attempt (winner, losers, FAILED) collapses to a summary row
+ *    and expands to its own reasoning and page-grouped citations.
  *  - Audit trail: lazily fetched LLM calls (token-sealed host endpoint) rendered
  *    as AuditCallCards; hidden entirely when the host minted no audit_url.
  *

package/dist/index.d.ts

@@ -14,13 +14,16 @@ export { default as VerificationChrome } from "./components/VerificationChrome.v
 export { default as ConfidenceIcon } from "./components/ConfidenceIcon.vue";
 export { default as VerificationModal } from "./components/VerificationModal.vue";
 export { default as ComparisonPage } from "./components/ComparisonPage.vue";
+export { default as CitationEvidence } from "./components/CitationEvidence.vue";
+export { default as CitationPageList } from "./components/CitationPageList.vue";
+export { default as CitationPage } from "./components/CitationPage.vue";
 export { bucketConfidence, STATUS_COLORS, STATUS_LABELS, } from "./lib/confidence";
-export { resolveDataPoint, resolveCandidates, reasoningOf, citedTextOf, RESOLUTION_PRIORITY, } from "./lib/resolveDataPoint";
+export { resolveDataPoint, resolveCandidates, reasoningOf, RESOLUTION_PRIORITY, } from "./lib/resolveDataPoint";
 export { hasDiscrepancy, candidatesDisagree } from "./lib/discrepancy";
 export { walkDataPoints } from "./lib/walk";
 export type { WalkedDataPoint } from "./lib/walk";
-export { groupSources, sourceRowLabel } from "./lib/sources";
-export type { SourceGroup } from "./lib/sources";
+export { citationEvidence, citationSummary } from "./lib/citations";
+export type { CitationPage as CitationPageModel, CitationEvidence as CitationEvidenceModel } from "./lib/citations";
 export { computeProgress } from "./lib/progress";
 export type { VerificationProgress } from "./lib/progress";
 export { fetchDataPointAudit } from "./lib/audit";

package/dist/lib/citations.d.ts

@@ -0,0 +1,84 @@
+import type { PreviewFile } from "@thehammer/danx-ui";
+import type { VerificationSource } from "../types";
+/**
+ * One cited PAGE of a source document, with the verbatim quotes taken from it.
+ *
+ * This is the unit the extraction pipeline actually records: `sources[]` holds one
+ * row per cited page, and that row carries its OWN ordered `texts[]` (SG-181). The
+ * retired `groupSources()` model grouped by "file identity" and left the quotes
+ * flattened across the whole candidate, so a reviewer could never tell which page a
+ * given quote came from — the defect this model exists to remove.
+ *
+ * Two source rows that cite the SAME page image merge into one page, their quotes
+ * concatenated in source order.
+ */
+export interface CitationPage {
+    /** Stable merge/render key — same page image ⇒ same key. */
+    key: string;
+    /** Page position inside the parent document, when the host resolved one. */
+    pageNumber: number | null;
+    /** Human label: "Page 4", else the file name, else a neutral fallback. */
+    label: string;
+    /** The parent document's name, when known — shown as the page's context. */
+    documentName: string | null;
+    /**
+     * The page image itself, danx-ui `PreviewFile`-shaped, carrying `page_number`
+     * so the viewer's own `sortByPageNumber()` orders a multi-page citation
+     * correctly. Null when the host did not resolve a file for this source — the
+     * quotes still render, the view/download affordances do not.
+     */
+    file: PreviewFile | null;
+    /**
+     * A direct URL to this page, from either host shape (`file.url`, else the
+     * idealized `file_url`). Null when the host resolved neither — a plain-text
+     * listing then names the page without linking it.
+     */
+    url: string | null;
+    /** The FULL parent document (the whole PDF), when this page is a transcode child. */
+    document: PreviewFile | null;
+    /** This page's ordered verbatim quotes, duplicates removed. */
+    quotes: string[];
+    /** Any non-empty `explanation` recorded against this page. */
+    explanations: string[];
+    /** The source row ids that merged into this page. */
+    sourceIds: Array<number | string>;
+}
+/** The full citation picture for one candidate (or one history attempt). */
+export interface CitationEvidence {
+    /** Cited pages, ordered by page number, then by input order. */
+    pages: CitationPage[];
+    /** Distinct parent documents across every cited page. */
+    documents: PreviewFile[];
+    /** The LLM calls that produced this citation — the audit-trail anchor. */
+    apiLogIds: Array<number | string>;
+    /**
+     * Citation sources the correction loop could never resolve to a real page
+     * (`source_type: 'failed_file'`). Surfaced rather than dropped — recording
+     * them instead of discarding them is the whole point of that source type.
+     */
+    unresolved: VerificationSource[];
+    pageCount: number;
+    quoteCount: number;
+    /** True when there is nothing at all to show — no page, no unresolved citation. */
+    isEmpty: boolean;
+}
+/**
+ * Build the citation picture for a candidate's `sources[]`.
+ *
+ * Sources are classified by kind before anything is grouped, so provenance rows
+ * never masquerade as evidence:
+ *
+ *  - `failed_file`  → `unresolved` (an unresolvable citation, shown as a warning)
+ *  - `api_log`      → `apiLogIds` (the LLM call behind the citation)
+ *  - `user`         → dropped (a human override is not a citation)
+ *  - anything else  → a cited page, merged by page identity
+ *
+ * A source with quotes but no resolvable file still becomes a page, so a quote is
+ * never silently discarded for want of a thumbnail.
+ *
+ * Tolerates both host shapes: the live gpt-manager payload (`file` + `page_number`)
+ * and the idealized document-page shape (`file_url` / `file_name` / `page`).
+ */
+export declare function citationEvidence(sources?: VerificationSource[] | null): CitationEvidence;
+/** "2 pages · 5 quotes" — the one-line summary used in tab badges and headers. */
+export declare function citationSummary(evidence: CitationEvidence): string;

package/dist/lib/hostBridge.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Outbound signal to the embedding consumer (gpt-manager's `TemplatePreview.vue`)
+ * telling it a nested pan/zoom surface — the Evidence tab's `DanxFileViewer` — is
+ * currently visible and wants exclusive ownership of Ctrl/Cmd+drag.
+ *
+ * Why this exists: the consumer's own preview canvas ALSO binds Ctrl/Cmd+drag to
+ * pan the whole rendered document, and it activates that gesture the instant it
+ * sees a relayed Ctrl/Cmd keydown from anywhere inside this iframe (the danxbot
+ * host-bridge relays raw keyboard events regardless of what's focused inside).
+ * Its pan overlay is a transparent `position: absolute; inset: 0` div stacked
+ * ABOVE the iframe in the PARENT's own DOM — once it renders, every subsequent
+ * mouse event over the iframe's whole bounding box (including this dialog's
+ * nested file viewer) is captured by that parent-level div instead of reaching
+ * anything inside the iframe. The nested viewer's own Ctrl+drag-to-pan-the-image
+ * gesture then never receives its mousedown at all. Posting this message lets
+ * the consumer gate its overlay off while a nested viewer wants the gesture,
+ * without either side needing to know the other's internal DOM structure.
+ *
+ * Message type is namespaced under the same `source: "danxbot-template"`
+ * envelope the danxbot host-bridge already uses for keyboard/wheel relays (see
+ * danxbot's `scaffold.ts` → `buildHostBridgeScript`), sent directly via
+ * `window.top.postMessage` — this call runs as ordinary Vue code already
+ * executing inside the iframe, so it needs no relay of its own.
+ */
+export declare function notifyNestedViewerActive(active: boolean): void;

package/dist/lib/resolveDataPoint.d.ts

@@ -22,8 +22,3 @@ export declare function resolveCandidates(candidates?: CandidateSet | null): Res
  * Reasoning is frequently `""`/null — callers render a quiet empty state, never throw.
  */
 export declare function reasoningOf(meta?: DataPointMeta | null): string | null;
-/**
- * The extracted candidate's cited text, normalized to a non-empty string or null.
- * Like reasoning, cited_text is graceful-empty.
- */
-export declare function citedTextOf(meta?: DataPointMeta | null): string | null;