@thehammer/template-verification 0.2.6 → 0.2.8

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 the disclosure's header is itself a
+ * `<button>`, and the view/download controls here are buttons too.
+ *
+ * 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/TvDisclosure.vue.d.ts

@@ -0,0 +1,61 @@
+/**
+ * A minimal, accessible collapsible-section list — the package's own, on purpose.
+ *
+ * danx-ui ships `DanxAccordion`, but a template app does NOT resolve danx-ui from
+ * this package's node_modules: the danxbot build marks it external and the browser
+ * resolves it at load time from the shell's vendor chunk, which pins
+ * `@thehammer/danx-ui: ^0.8.17` (see danxbot `spa-template-shell/package.json`).
+ * `DanxAccordion` does not exist there, and importing it fails the template's vite
+ * build with a Rollup "not exported" error — which is exactly what happened on the
+ * first attempt to ship this feature.
+ *
+ * The rule this encodes: this package must only use danx-ui surface that exists at
+ * the FLOOR of its declared peer range, never whatever the local install happens to
+ * resolve. A ~40-line disclosure is a much cheaper guarantee than a version bump
+ * coordinated across the shell and every template.
+ *
+ * The header is a `<button>` (its own accessible toggle), so slot content placed in
+ * it must not itself be interactive — put actions in the `panel` slot.
+ */
+type __VLS_Props = {
+    /** Sections to render, in order. `value` is the open/closed key. */
+    items: Array<{
+        value: string;
+        label?: string;
+    }>;
+    /** Open section keys. Any number may be open at once. */
+    modelValue: string[];
+    /** Prefix for the generated aria ids — unique per usage on a page. */
+    idPrefix?: string;
+};
+declare var __VLS_1: {
+    item: {
+        value: string;
+        label?: string | undefined;
+    };
+    isOpen: boolean;
+}, __VLS_3: {
+    item: {
+        value: string;
+        label?: string | undefined;
+    };
+    isOpen: boolean;
+};
+type __VLS_Slots = {} & {
+    header?: (props: typeof __VLS_1) => any;
+} & {
+    panel?: (props: typeof __VLS_3) => any;
+};
+declare const _default: __VLS_WithSlots<import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: string[]) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: string[]) => any) | undefined;
+}>, {
+    idPrefix: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

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/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;