@thehammer/template-verification 0.2.21 → 0.2.23

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

@@ -0,0 +1,23 @@
+import type { ConfidenceLevel } from "@danxbot/ui/pure";
+/**
+ * THE LETTER'S CONFIDENCE BAR — the Vue twin of `@danxbot/ui`'s React
+ * `ConfidenceBar`, drawn to the same spec from the same tokens (SG-901):
+ *
+ *   not rated   dotted grey outline across the whole slot, no fill
+ *   1..5        a fill 20% of the slot long per level, in that level's colour
+ *               (dark red, light red, yellow, light green, dark green), no track
+ *
+ * The colours are the `--confidence-*` custom properties from
+ * `@danxbot/ui/confidence.css`, never a local palette. `data-theme="light"`
+ * resolves them to their light-theme values: this bar is drawn on a letter, and
+ * a letter is paper whatever the reader's OS theme is.
+ *
+ * The slot is one fixed size in every state, so a mark never changes size when a
+ * rating arrives. Each fill class is written out whole, never assembled at
+ * runtime — Tailwind finds classes by scanning source text.
+ */
+type __VLS_Props = {
+    level: ConfidenceLevel | null;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

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

@@ -1,14 +1,19 @@
-import type { VerificationStatus } from "../types";
+import type { ConfidenceState } from "../types";
 /**
- * Pure presentational confidence/status glyph. Given either a raw integer
- * confidence (1-5) or an explicit status, renders a colored glyph and optional
- * label. Buckets the INTEGER — never string-matches the confidence (see
- * {@link bucketConfidence}). No interactivity.
+ * A machine value's confidence mark in the letter — the SAME scale the Demand
+ * Desk draws (SG-901): a bar as long as the level, in the level's colour, dotted
+ * when nothing rated it. It used to be a ✔/⚠/✕ glyph in three colour buckets, so
+ * a 4 and a 5 were identical here while the screen beside the letter drew them
+ * differently.
+ *
+ * `failed` is not a level — the extraction or its citation correction did not
+ * produce an answer (SG-189) — so it keeps its own red ⊗ chip rather than a bar.
+ *
+ * Presentational only; the button around it (in `VerifiedField`) owns the
+ * interaction and the accessible name.
  */
 type __VLS_Props = {
-    confidence?: number | null;
-    status?: VerificationStatus;
-    showLabel?: boolean;
+    state: ConfidenceState;
 };
 declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 export default _default;

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

@@ -119,6 +119,28 @@ type __VLS_Props = {
     field?: string;
     original?: string | number | null;
     format?: (value: unknown) => string;
+    /**
+     * SG-974: text to render, styled as an italic placeholder, in place of the
+     * default-slot fallback when this field has no value. Rendered INSIDE
+     * `.tv-field-value` — the same box the real value would occupy — rather
+     * than left for the host template to draw beside `<VerifiedField>` as its
+     * own separate markup.
+     *
+     * That distinction is the whole point, not a style preference. The mark's
+     * anchor is a zero-size box glued to the trailing edge of whatever
+     * `.tv-field-value` rendered (see the header docblock's "ANCHORING"
+     * section) — when there is no value, that box renders NOTHING and
+     * collapses to zero width, so the anchor lands at the field's own
+     * starting point. A placeholder a host template draws AFTER
+     * `<VerifiedField>` as a sibling (`v-if="!value"`) therefore renders
+     * AFTER that zero-width point too, putting the mark to the LEFT of the
+     * placeholder it is supposed to trail — exactly the reported bug (SG-974).
+     * Accepting the placeholder text here and rendering it as the value
+     * box's own content puts it before the anchor in the same inline flow
+     * the anchor already tracks, so the mark lands to its right in every
+     * state, the same guarantee a real value already gets.
+     */
+    placeholder?: string;
 };
 declare const _default: __VLS_WithSlots<import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>, {
     default?: ((props: {

package/dist/index.d.ts

@@ -33,7 +33,7 @@ export { default as VerificationChrome } from "./components/VerificationChrome.v
 export { default as ConfidenceIcon } from "./components/ConfidenceIcon.vue";
 export { TEMPLATE_MESSAGE_SOURCE, TEMPLATE_PROTOCOL_VERSION, DATA_POINT_ACTIVATED, embedderOrigin, notifyDataPointActivated, } from "./lib/hostBridge";
 export type { DataPointActivatedMessage, DataPointActivation, } from "./lib/hostBridge";
-export { bucketConfidence, STATUS_COLORS, STATUS_LABELS, } from "./lib/confidence";
+export { ratingLevel, confidenceStateOf, confidenceStateLabel, CONFIDENCE_SCALE, } from "./lib/confidence";
 export { resolveDataPoint, resolveCandidates, RESOLUTION_PRIORITY, } from "./lib/resolveDataPoint";
 export { hasDiscrepancy, candidatesDisagree } from "./lib/discrepancy";
 export { walkDataPoints } from "./lib/walk";
@@ -41,4 +41,4 @@ export type { WalkedDataPoint } from "./lib/walk";
 export { computeProgress } from "./lib/progress";
 export type { VerificationProgress } from "./lib/progress";
 export { CHROME_CLASS, EDITABLE_CLASS, ENABLED_STORAGE_KEY } from "./constants";
-export type { VerificationStatus, ResolvedSource, SourceChoice, VerificationSource, ExtractedCandidate, HumanCitation, OverrideCandidate, ClaimCandidate, CandidateSet, DataPointAnchor, ResolvedValue, DataPointMeta, MetaCarrier, SaveOverrideArgs, SaveOverrideFn, } from "./types";
+export type { ConfidenceState, ResolvedSource, SourceChoice, VerificationSource, ExtractedCandidate, HumanCitation, OverrideCandidate, ClaimCandidate, CandidateSet, DataPointAnchor, ResolvedValue, DataPointMeta, MetaCarrier, SaveOverrideArgs, SaveOverrideFn, } from "./types";

package/dist/lib/confidence.d.ts

@@ -1,25 +1,28 @@
-import type { VerificationStatus } from "../types";
+import { type ConfidenceLevel } from "@danxbot/ui/pure";
+import type { ConfidenceState } from "../types";
 /**
- * Bucket the INTEGER confidence (1-5) into a verification status.
+ * THE LETTER'S CONFIDENCE SCALE IS THE DEMAND DESK'S — SG-901.
  *
- *   null / undefined → unverifiable   (no extraction provenance)
- *   <= 2             → low
- *   == 3             → medium
- *   >= 4             → high
- *
- * IMPORTANT: this buckets the NUMBER. The host app once shipped a confidence
- * component that string-matched "high"/"medium"/"low"; real data is the integer
- * 1-5, so that component silently fell through to "none" for every value. Do NOT
- * reintroduce string matching here — bucket the integer.
+ * The level a rating maps to and each level's words come from `@danxbot/ui/pure`,
+ * and the colours from `@danxbot/ui/confidence.css` (imported by `styles.css`).
+ * Both are bundled into this package at build time, so a template installs
+ * nothing new, and there is still exactly one copy of the scale: this overlay used
+ * to keep its own three buckets, and a 4 and a 5 read the same in the letter
+ * while the screen beside it drew them differently.
  */
-export declare function bucketConfidence(confidence?: number | null): VerificationStatus;
+/** The top of the scale the extractor self-rates on. */
+export declare const CONFIDENCE_SCALE = 5;
 /**
- * Tailwind pill-badge classes per status (bg tint + text + ring), for
- * ConfidenceIcon's soft-badge treatment. Each value's color family (green/
- * yellow/red/gray) is load-bearing — ConfidenceIcon.test.ts asserts the
- * rendered class list CONTAINS that literal color word, so any restyle must
- * keep the same family per status even if the shade/utility changes.
+ * A raw confidence to the level it draws as, or null when there is no rating.
+ *
+ * Only a real number counts. The host once shipped a component that string-matched
+ * "high"/"medium"/"low", and real data is the integer 1-5, so that component silently
+ * showed nothing for every value. A non-number is "no rating", never matched.
  */
-export declare const STATUS_COLORS: Record<VerificationStatus, string>;
-/** Human-readable status label. */
-export declare const STATUS_LABELS: Record<VerificationStatus, string>;
+export declare function ratingLevel(confidence: unknown): ConfidenceLevel | null;
+/** A machine value's mark: its failure first, else its level, else unrated. */
+export declare function confidenceStateOf(confidence: unknown, failed: boolean): ConfidenceState;
+export declare const UNRATED_LABEL = "Not rated";
+export declare const FAILED_LABEL = "Failed";
+/** The words for a mark — the level's own word, "Not rated", or "Failed". */
+export declare function confidenceStateLabel(state: ConfidenceState): string;