@kontourai/survey 1.10.0 → 1.12.0

package/dist/src/review-workbench/review-workbench-data.d.ts

@@ -41,6 +41,7 @@ export declare const publicDirectoryReviewItemExample: {
                 confidence: number;
                 extractor: string;
                 extractedAt: string;
+                model?: undefined;
             };
             claimTarget: {
                 claimId: string;
@@ -92,6 +93,7 @@ export declare const publicDirectoryReviewItemExample: {
                 target: string;
                 confidence: number;
                 extractor: string;
+                model: string;
                 extractedAt: string;
             };
             claimTarget: {
@@ -467,6 +469,7 @@ export declare const reviewWorkbenchQueueExamples: (ReviewItem | {
                 confidence: number;
                 extractor: string;
                 extractedAt: string;
+                model?: undefined;
             };
             claimTarget: {
                 claimId: string;
@@ -518,6 +521,7 @@ export declare const reviewWorkbenchQueueExamples: (ReviewItem | {
                 target: string;
                 confidence: number;
                 extractor: string;
+                model: string;
                 extractedAt: string;
             };
             claimTarget: {

package/dist/src/review-workbench/review-workbench-data.js

@@ -94,6 +94,7 @@ export const publicDirectoryReviewItemExample = {
                     target: "availabilityStatus",
                     confidence: 0.82,
                     extractor: "example-crawl",
+                    model: "example-extraction-model-2026-05",
                     extractedAt: "2026-05-31T15:00:00.000Z",
                 },
                 claimTarget: {
@@ -481,9 +482,180 @@ function queueFixture(name, target, currentValue, proposedValue, candidateSetSta
         },
     };
 }
+/**
+ * A field with a proposed value but no current candidate at all — the "New" field
+ * kind in the review workbench (no "Current" value to diff against, so the diff
+ * shows "Not set" and the Keep-current button reads "Leave unset").
+ */
+const dropInPriceReviewItemExample = {
+    apiVersion: reviewResourceApiVersion,
+    kind: "ReviewItem",
+    metadata: {
+        name: "public-directory-dropin-price",
+        labels: { domain: "public-directory" },
+        producer: { displayName: "Example Program", slug: "example-program" },
+    },
+    spec: {
+        target: "dropInPrice",
+        candidateSetStatus: "needs-review",
+        producerPolicy: { feedbackTags: ["pricing-field", "crawler-suggested"] },
+        rationale: "Example-backed local review queue item for dropInPrice.",
+        candidates: [
+            {
+                id: "public-directory-dropin-price:candidate:proposed",
+                role: "proposed",
+                value: "$85 / day",
+                confidence: 0.72,
+                source: {
+                    sourceId: "public-directory-dropin-price:source:proposed",
+                    sourceRef: "https://example.test/listings/example-program/pricing",
+                    kind: "web-page",
+                    observedAt: "2026-05-31T15:00:00.000Z",
+                    locatorScheme: "html",
+                },
+                locator: {
+                    scheme: "html",
+                    locator: "html:field=dropInPrice",
+                    excerpt: "Daily drop-in rate: $85 (members $70). Full-week enrollment preferred.",
+                },
+                extraction: {
+                    extractionId: "public-directory-dropin-price:extraction:proposed",
+                    target: "dropInPrice",
+                    confidence: 0.72,
+                    extractor: "example-crawl",
+                    extractedAt: "2026-05-31T15:00:00.000Z",
+                },
+                claimTarget: {
+                    claimId: "public-field.entity-123.dropin-price.proposal-457",
+                    subjectType: "public-record.entity",
+                    subjectId: "entity-123",
+                    facet: "public-record.profile",
+                    claimType: "public-data.field-candidate",
+                    fieldOrBehavior: "dropInPrice",
+                    impactLevel: "low",
+                    collectedBy: "example-crawl",
+                },
+                projection: {
+                    rawSourceId: "public-directory-dropin-price:source:proposed",
+                    extractionId: "public-directory-dropin-price:extraction:proposed",
+                    candidateSetId: "public-directory-dropin-price:candidate-set",
+                    candidateId: "public-directory-dropin-price:candidate:proposed",
+                    claimId: "public-field.entity-123.dropin-price.proposal-457",
+                },
+                producer: { proposalId: "proposal-457" },
+            },
+        ],
+    },
+    status: { observedCandidateCount: 1 },
+};
+/**
+ * A field whose proposed value has NO supporting excerpt/locator — the review
+ * workbench must show the explicit "No source — verify before accepting" flag
+ * instead of a confidence meter or a weak "none" placeholder.
+ */
+const dailyHoursNoSourceReviewItemExample = {
+    apiVersion: reviewResourceApiVersion,
+    kind: "ReviewItem",
+    metadata: {
+        name: "public-directory-daily-hours-no-source",
+        labels: { domain: "public-directory" },
+        producer: { displayName: "Example Program", slug: "example-program" },
+    },
+    spec: {
+        target: "dailyHours",
+        candidateSetStatus: "needs-review",
+        producerPolicy: { feedbackTags: ["hours-change", "unsourced-proposal"] },
+        rationale: "Example-backed local review queue item for dailyHours with no provenance.",
+        candidates: [
+            {
+                id: "public-directory-daily-hours-no-source:candidate:current",
+                role: "current",
+                value: "9:00 AM - 3:00 PM",
+                confidence: 0.9,
+                source: {
+                    sourceId: "public-directory-daily-hours-no-source:source:current",
+                    sourceRef: "https://example.test/listings/example-program",
+                    kind: "web-page",
+                    observedAt: "2026-05-30T18:00:00.000Z",
+                    locatorScheme: "html",
+                },
+                locator: {
+                    scheme: "html",
+                    locator: "html:field=dailyHours",
+                    excerpt: "Daily program hours are 9:00 AM to 3:00 PM.",
+                },
+                extraction: {
+                    extractionId: "public-directory-daily-hours-no-source:extraction:current",
+                    target: "dailyHours",
+                    confidence: 0.9,
+                    extractor: "example-field-review",
+                    extractedAt: "2026-05-30T18:00:00.000Z",
+                },
+                claimTarget: {
+                    claimId: "public-field.entity-123.daily-hours.current",
+                    subjectType: "public-record.entity",
+                    subjectId: "entity-123",
+                    facet: "public-record.profile",
+                    claimType: "public-data.field",
+                    fieldOrBehavior: "dailyHours",
+                    impactLevel: "medium",
+                    collectedBy: "example-field-review",
+                },
+                projection: {
+                    rawSourceId: "public-directory-daily-hours-no-source:source:current",
+                    extractionId: "public-directory-daily-hours-no-source:extraction:current",
+                    candidateSetId: "public-directory-daily-hours-no-source:candidate-set",
+                    candidateId: "public-directory-daily-hours-no-source:candidate:current",
+                    claimId: "public-field.entity-123.daily-hours.current",
+                },
+            },
+            {
+                // No `locator` at all — the proposed value has no supporting excerpt.
+                id: "public-directory-daily-hours-no-source:candidate:proposed",
+                role: "proposed",
+                value: "8:30 AM - 4:00 PM",
+                confidence: 0.68,
+                source: {
+                    sourceId: "public-directory-daily-hours-no-source:source:proposed",
+                    sourceRef: "manual-entry://example-program/daily-hours-update",
+                    kind: "manual-entry",
+                    observedAt: "2026-05-31T15:00:00.000Z",
+                },
+                extraction: {
+                    extractionId: "public-directory-daily-hours-no-source:extraction:proposed",
+                    target: "dailyHours",
+                    confidence: 0.68,
+                    extractor: "example-crawl",
+                    extractedAt: "2026-05-31T15:00:00.000Z",
+                },
+                claimTarget: {
+                    claimId: "public-field.entity-123.daily-hours.proposal-458",
+                    subjectType: "public-record.entity",
+                    subjectId: "entity-123",
+                    facet: "public-record.profile",
+                    claimType: "public-data.field-candidate",
+                    fieldOrBehavior: "dailyHours",
+                    impactLevel: "medium",
+                    collectedBy: "example-crawl",
+                },
+                projection: {
+                    rawSourceId: "public-directory-daily-hours-no-source:source:proposed",
+                    extractionId: "public-directory-daily-hours-no-source:extraction:proposed",
+                    candidateSetId: "public-directory-daily-hours-no-source:candidate-set",
+                    candidateId: "public-directory-daily-hours-no-source:candidate:proposed",
+                    claimId: "public-field.entity-123.daily-hours.proposal-458",
+                },
+                producer: { proposalId: "proposal-458" },
+            },
+        ],
+    },
+    status: { observedCandidateCount: 2 },
+};
 export const reviewWorkbenchQueueExamples = [
     queueFixture("public-directory-hours", "hours", "Weekdays 9am-5pm", "Weekdays 8am-6pm", "needs-review", ["hours-change", "crawler-suggested"]),
     queueFixture("public-directory-phone", "phoneNumber", "+1-555-0100", "+1-555-0199", "needs-review", ["contact-field", "source-conflict"]),
+    dropInPriceReviewItemExample,
+    dailyHoursNoSourceReviewItemExample,
     publicDirectoryReviewItemExample,
     queueFixture("public-directory-address", "streetAddress", "100 Main Street", "102 Main Street", "needs-review", ["address-change", "producer-escalation-candidate"]),
     queueFixture("public-directory-license", "licenseStatus", "ACTIVE", "EXPIRED", "escalated", ["licensing", "manual-review-required"]),

package/dist/src/review-workbench/review-workbench-element.d.ts

@@ -24,7 +24,11 @@
  *   host-page rules always win over the shadow defaults.
  *
  * Attributes:
- *   theme       — "survey" | "console" | "flow" | "surface"  (maps to theme-* class)
+ *   theme       — "survey" | "console" | "flow" | "surface" (maps to a theme-* class
+ *                 with its own brand colour) | "custom" (or any other value: no
+ *                 theme-* class at all, so a host's own --k-* overrides apply with
+ *                 nothing to fight — see the "Theming" section of
+ *                 docs/consumer-integration-guide.md for a full host-brand example)
  *   color-scheme — "dark" | "light"  (default: "dark")
  *   src          — URL to fetch a JSON-serialised ReviewQueueSessionState
  */

package/dist/src/review-workbench/review-workbench-element.js

@@ -24,7 +24,11 @@
  *   host-page rules always win over the shadow defaults.
  *
  * Attributes:
- *   theme       — "survey" | "console" | "flow" | "surface"  (maps to theme-* class)
+ *   theme       — "survey" | "console" | "flow" | "surface" (maps to a theme-* class
+ *                 with its own brand colour) | "custom" (or any other value: no
+ *                 theme-* class at all, so a host's own --k-* overrides apply with
+ *                 nothing to fight — see the "Theming" section of
+ *                 docs/consumer-integration-guide.md for a full host-brand example)
  *   color-scheme — "dark" | "light"  (default: "dark")
  *   src          — URL to fetch a JSON-serialised ReviewQueueSessionState
  */
@@ -61,20 +65,41 @@ const TOKEN_INHERIT_CSS = `/* 1. Host token defaults — literal values, not var
   --k-line: rgba(255,255,255,0.08);
   --k-line-strong: rgba(255,255,255,0.14);
   --k-brand: #5ce0c6;
+  --k-brand-contrast: #06080b;
   --k-active: #7aa2ff;
   --k-positive: #34d399;
   --k-caution: #f3b14b;
   --k-negative: #ff6f6f;
   --k-neutral: #8b93a8;
+  --k-positive-soft: rgba(52,211,153,0.14);
+  --k-caution-soft: rgba(243,177,75,0.14);
+  --k-negative-soft: rgba(255,111,111,0.14);
+  --k-active-soft: rgba(122,162,255,0.14);
   --k-radius-md: 10px;
   --k-radius-sm: 6px;
+  --k-shadow: 0 26px 60px -42px rgba(0, 0, 0, 0.95);
   --k-font-ui: "Hanken Grotesk", system-ui, sans-serif;
+  /* Field-diff card aliases (Theming section of docs/consumer-integration-guide.md).
+     Derived from the tokens above by default; a host may override any of these
+     directly for finer control without touching the base token it derives from. */
+  --k-muted: var(--k-text-muted);
+  --k-faint: var(--k-text-faint);
+  --k-raised: var(--k-panel-raised);
+  --k-sunken: color-mix(in srgb, var(--k-bg) 55%, var(--k-panel) 45%);
+  --k-brand-ink: var(--k-brand-contrast);
+  --k-brand-wash: color-mix(in srgb, var(--k-brand) 14%, transparent);
+  --k-positive-wash: var(--k-positive-soft);
+  --k-caution-wash: var(--k-caution-soft);
+  --k-negative-wash: var(--k-negative-soft);
+  --k-radius: var(--k-radius-md);
 }
 /* 2. Token inheritance delegation — re-delegate --k-* tokens on the embed root
    to inherit from :host, so external overrides set on the host element propagate
    through the shadow boundary. The [class] attribute selector raises specificity
    to (0,2,0) — matching the theme class selectors — and this sheet comes AFTER
-   the workbench defaults, so source order makes these rules win. */
+   the workbench defaults, so source order makes these rules win. Every token the
+   workbench CSS reads is listed here so a host can override ANY of them (the full
+   --k-* set, not just a fixed subset) without forking styles or picking a preset. */
 .survey-workbench-embed[class] {
   --k-bg: inherit;
   --k-panel: inherit;
@@ -85,16 +110,32 @@ const TOKEN_INHERIT_CSS = `/* 1. Host token defaults — literal values, not var
   --k-line: inherit;
   --k-line-strong: inherit;
   --k-brand: inherit;
+  --k-brand-contrast: inherit;
   --k-active: inherit;
   --k-positive: inherit;
   --k-caution: inherit;
   --k-negative: inherit;
   --k-neutral: inherit;
+  --k-positive-soft: inherit;
+  --k-caution-soft: inherit;
+  --k-negative-soft: inherit;
+  --k-active-soft: inherit;
   --k-radius-md: inherit;
   --k-radius-sm: inherit;
+  --k-shadow: inherit;
   --k-font-ui: inherit;
   --k-font-mono: inherit;
   --k-font-display: inherit;
+  --k-muted: inherit;
+  --k-faint: inherit;
+  --k-raised: inherit;
+  --k-sunken: inherit;
+  --k-brand-ink: inherit;
+  --k-brand-wash: inherit;
+  --k-positive-wash: inherit;
+  --k-caution-wash: inherit;
+  --k-negative-wash: inherit;
+  --k-radius: inherit;
 }
 /* 3. Light mode token overrides — applied when color-scheme="light" sets data-theme="light"
    on the embed root. These are literal values (not var()) to avoid self-reference cycles.
@@ -112,11 +153,16 @@ const TOKEN_INHERIT_CSS = `/* 1. Host token defaults — literal values, not var
   --k-text-muted: #5b626b;
   --k-text-faint: #707782;
   --k-brand: #16806f;
+  --k-brand-contrast: #ffffff;
   --k-positive: #168257;
   --k-caution: #8a5a00;
   --k-negative: #c83b3b;
   --k-active: #3f6fd6;
 }`;
+/** The four built-in theme presets from vendor kontourai-ui/tokens/themes.css. Any
+ *  other `theme` attribute value (including the documented `"custom"`) opts out of
+ *  presets entirely — see {@link SurveyReviewWorkbenchElement.#applyThemeClasses}. */
+const KNOWN_WORKBENCH_THEMES = new Set(["survey", "console", "flow", "surface"]);
 export class SurveyReviewWorkbenchElement extends HTMLElement {
     static observedAttributes = ["theme", "color-scheme", "src"];
     #session = null;
@@ -157,13 +203,28 @@ export class SurveyReviewWorkbenchElement extends HTMLElement {
         --k-line: rgba(255,255,255,0.08);
         --k-line-strong: rgba(255,255,255,0.14);
         --k-brand: #5ce0c6;
+        --k-brand-contrast: #06080b;
         --k-active: #7aa2ff;
         --k-positive: #34d399;
         --k-caution: #f3b14b;
         --k-negative: #ff6f6f;
+        --k-positive-soft: rgba(52,211,153,0.14);
+        --k-caution-soft: rgba(243,177,75,0.14);
+        --k-negative-soft: rgba(255,111,111,0.14);
         --k-radius-md: 10px;
         --k-radius-sm: 6px;
+        --k-shadow: 0 26px 60px -42px rgba(0, 0, 0, 0.95);
         --k-font-ui: "Hanken Grotesk", system-ui, sans-serif;
+        --k-muted: var(--k-text-muted);
+        --k-faint: var(--k-text-faint);
+        --k-raised: var(--k-panel-raised);
+        --k-sunken: color-mix(in srgb, var(--k-bg) 55%, var(--k-panel) 45%);
+        --k-brand-ink: var(--k-brand-contrast);
+        --k-brand-wash: color-mix(in srgb, var(--k-brand) 14%, transparent);
+        --k-positive-wash: var(--k-positive-soft);
+        --k-caution-wash: var(--k-caution-soft);
+        --k-negative-wash: var(--k-negative-soft);
+        --k-radius: var(--k-radius-md);
       }
       .workbench-empty, .workbench-error {
         display: flex;
@@ -194,15 +255,30 @@ export class SurveyReviewWorkbenchElement extends HTMLElement {
         --k-line: inherit;
         --k-line-strong: inherit;
         --k-brand: inherit;
+        --k-brand-contrast: inherit;
         --k-active: inherit;
         --k-positive: inherit;
         --k-caution: inherit;
         --k-negative: inherit;
+        --k-positive-soft: inherit;
+        --k-caution-soft: inherit;
+        --k-negative-soft: inherit;
         --k-radius-md: inherit;
         --k-radius-sm: inherit;
+        --k-shadow: inherit;
         --k-font-ui: inherit;
         --k-font-mono: inherit;
         --k-font-display: inherit;
+        --k-muted: inherit;
+        --k-faint: inherit;
+        --k-raised: inherit;
+        --k-sunken: inherit;
+        --k-brand-ink: inherit;
+        --k-brand-wash: inherit;
+        --k-positive-wash: inherit;
+        --k-caution-wash: inherit;
+        --k-negative-wash: inherit;
+        --k-radius: inherit;
       }
     `;
         this.#root.appendChild(hostStyle);
@@ -266,7 +342,14 @@ export class SurveyReviewWorkbenchElement extends HTMLElement {
     #applyThemeClasses() {
         const theme = this.getAttribute("theme") ?? "survey";
         const colorScheme = this.getAttribute("color-scheme") ?? "dark";
-        this.#mountRoot.className = `workbench survey-workbench-embed theme-${theme}`;
+        // Only the four built-in presets get a `theme-*` class (see vendor
+        // kontourai-ui/tokens/themes.css). `theme="custom"` — or any other value that
+        // isn't one of the four presets — deliberately gets NO theme class, so none of
+        // the presets' brand-colour overrides apply. This is the escape hatch for a
+        // host that wants to set its own full `--k-*` palette (see the "Theming"
+        // section of docs/consumer-integration-guide.md) without fighting a preset.
+        const themeClass = KNOWN_WORKBENCH_THEMES.has(theme) ? ` theme-${theme}` : "";
+        this.#mountRoot.className = `workbench survey-workbench-embed${themeClass}`;
         this.#mountRoot.setAttribute("data-color-scheme", colorScheme);
         // data-theme="light" is required by the token sheet for light mode token overrides.
         // data-dark is kept for any existing selectors that used it.