@campfire-interactive/volume-intelligence-ui 0.9.1 → 0.11.1

package/dist/index.d.ts

@@ -90,8 +90,12 @@ declare function VolumeImport(props: VolumeImportProps): react.JSX.Element;
 
 type SourceLayout = 'wide' | 'tall';
 /** `base` = IHS/AFS historical training signal (one active per tenant);
- *  `overlay` = EDI-style additive customer-stated demand. */
-type VolumeSourceKind = 'base' | 'overlay';
+ *  `overlay` = EDI-style additive customer-stated demand;
+ *  `reference` = a second market vendor's curve, drawn beside the active base
+ *  rather than summed into it. A reference source never drives prediction,
+ *  never supplies level labels, and is never what an overlay links against —
+ *  which is why it is a kind of its own rather than a second `base`. */
+type VolumeSourceKind = 'base' | 'overlay' | 'reference';
 interface VolumeSource {
     id: string;
     code: string;
@@ -272,7 +276,18 @@ interface DetectSegmentsResult {
 interface ClearSourceDataResult {
     uploads: number;
     criteria: number;
-    cleared: true;
+    /** Whether the source is now EMPTY. False when the call hit its time budget
+     *  with rows still to delete — call again to continue.
+     *
+     *  BREAKING in 2026-09: this was the literal `true`, returned regardless of
+     *  whether anything remained. Batched clearing introduced a third outcome
+     *  (partial), and a consumer branching on `cleared` would have read it as an
+     *  empty source. */
+    cleared: boolean;
+    /** False when the call hit its time budget with rows still to delete. */
+    done?: boolean;
+    /** Criteria still to delete when `done` is false. */
+    remainingCriteria?: number;
 }
 /** Whether a source satisfies every required identity field. The dual-
  *  satisfaction rule (explicit automotive_field mapping OR the covering

package/dist/index.js

@@ -901,7 +901,8 @@ function VolumeSourcesList({ transport, onOpenSource, renderActiveSourceExtras,
             /* @__PURE__ */ jsxs4("span", { className: "cfi-vi-card-title", children: [
               /* @__PURE__ */ jsx4("button", { type: "button", className: "cfi-vi-link", onClick: () => onOpenSource(src.id), children: src.name }),
               isActive && /* @__PURE__ */ jsx4(Badge, { variant: "success", children: "Active" }),
-              src.kind === "overlay" && /* @__PURE__ */ jsx4(Badge, { variant: "purple", title: "Overlay sources are active whenever data is uploaded \u2014 no Set Active step.", children: "Overlay" })
+              src.kind === "overlay" && /* @__PURE__ */ jsx4(Badge, { variant: "purple", title: "Overlay sources are active whenever data is uploaded \u2014 no Set Active step.", children: "Overlay" }),
+              src.kind === "reference" && /* @__PURE__ */ jsx4(Badge, { variant: "outline", title: "A second vendor's curve, drawn beside the active base rather than summed into it. Never drives prediction and has no Set Active step.", children: "Reference" })
             ] }),
             /* @__PURE__ */ jsxs4("span", { className: "cfi-vi-row", children: [
               /* @__PURE__ */ jsx4(Badge, { variant: "outline", children: src.code }),
@@ -1664,6 +1665,7 @@ function VolumeSourceDetail({ transport, sourceId, onOpenSource, onBack, readOnl
   const [savingLayout, setSavingLayout] = useState7(false);
   const [editLayout, setEditLayout] = useState7("wide");
   const [editValueDateFormat, setEditValueDateFormat] = useState7("yyyy-MM-dd");
+  const [editKind, setEditKind] = useState7("base");
   const [newSegmentLabel, setNewSegmentLabel] = useState7("");
   const [newSegmentDataType, setNewSegmentDataType] = useState7("string");
   const [addingSegment, setAddingSegment] = useState7(false);
@@ -1701,6 +1703,7 @@ function VolumeSourceDetail({ transport, sourceId, onOpenSource, onBack, readOnl
       setSource(src);
       setSelectedKeyId(src.uniqueKeySegmentId ?? "__none__");
       setEditLayout(src.layout);
+      setEditKind(src.kind);
       setEditValueDateFormat(src.valueDateFormat);
       setHasData(uploads.items.some((u) => u.status === "done" || u.status === "done_with_errors"));
       setMappingKeys(keys);
@@ -1769,8 +1772,31 @@ function VolumeSourceDetail({ transport, sourceId, onOpenSource, onBack, readOnl
     setError(null);
     setClearResult(null);
     try {
-      const result = await transport.clearSourceData(id, clearConfirm);
-      setClearResult(`Cleared ${result.criteria.toLocaleString()} criteria and ${result.uploads.toLocaleString()} uploads. Configuration (segments, mappings) preserved.`);
+      let criteria = 0;
+      let uploads = 0;
+      let passes = 0;
+      const MAX_PASSES = 200;
+      for (; ; ) {
+        const result = await transport.clearSourceData(id, clearConfirm);
+        criteria += result.criteria;
+        uploads += result.uploads;
+        passes += 1;
+        if (result.done !== false || passes >= MAX_PASSES) {
+          if (result.done === false) {
+            setClearResult(
+              `Stopped after ${passes} passes with ${(result.remainingCriteria ?? 0).toLocaleString()} criteria still to delete. ${criteria.toLocaleString()} criteria and ${uploads.toLocaleString()} uploads were removed. Run Clear again to continue.`
+            );
+          } else {
+            setClearResult(
+              `Cleared ${criteria.toLocaleString()} criteria and ${uploads.toLocaleString()} uploads${passes > 1 ? ` over ${passes} passes` : ""}. Configuration (segments, mappings) preserved.`
+            );
+          }
+          break;
+        }
+        setClearResult(
+          `Clearing\u2026 ${criteria.toLocaleString()} criteria removed so far, ${(result.remainingCriteria ?? 0).toLocaleString()} to go.`
+        );
+      }
       setClearConfirm("");
       await load();
     } catch (e) {
@@ -1809,12 +1835,17 @@ function VolumeSourceDetail({ transport, sourceId, onOpenSource, onBack, readOnl
       setSavingKey(false);
     }
   }
+  const crossesMeasure = !!source && editKind !== source.kind && (editKind === "overlay" || source.kind === "overlay");
   async function saveLayoutAndRouting() {
     if (!id) return;
     setSavingLayout(true);
     setError(null);
     try {
-      await transport.updateSource(id, { layout: editLayout, valueDateFormat: editValueDateFormat });
+      await transport.updateSource(id, {
+        layout: editLayout,
+        valueDateFormat: editValueDateFormat,
+        kind: editKind
+      });
       await load();
     } catch (e) {
       setError(e instanceof Error ? e.message : "Failed to save layout");
@@ -1946,9 +1977,41 @@ function VolumeSourceDetail({ transport, sourceId, onOpenSource, onBack, readOnl
                   onChange: (e) => setEditValueDateFormat(e.target.value)
                 }
               )
+            ] }),
+            /* @__PURE__ */ jsxs8("div", { className: "cfi-vi-field", style: { flex: 1 }, children: [
+              /* @__PURE__ */ jsx8("label", { className: "cfi-vi-label", children: "Role" }),
+              /* @__PURE__ */ jsxs8(
+                "select",
+                {
+                  className: "cfi-vi-input",
+                  value: editKind,
+                  disabled: savingLayout || readOnly,
+                  onChange: (e) => setEditKind(e.target.value),
+                  children: [
+                    /* @__PURE__ */ jsx8("option", { value: "base", children: "base \u2014 the tenant's own volume" }),
+                    /* @__PURE__ */ jsx8("option", { value: "overlay", children: "overlay \u2014 customer-stated demand" }),
+                    /* @__PURE__ */ jsx8("option", { value: "reference", children: "reference \u2014 another vendor's curve" })
+                  ]
+                }
+              )
             ] })
           ] }),
-          /* @__PURE__ */ jsx8(Btn, { size: "sm", onClick: () => void saveLayoutAndRouting(), disabled: hasData || savingLayout || readOnly, children: savingLayout ? "Saving\u2026" : "Save layout" })
+          hasData && crossesMeasure && /* @__PURE__ */ jsxs8("p", { className: "cfi-vi-hint", style: { color: "#b45309" }, children: [
+            "This source has data. Changing between ",
+            source.kind,
+            " and ",
+            editKind,
+            " would reinterpret parts as vehicles or the reverse \u2014 clear its data first."
+          ] }),
+          /* @__PURE__ */ jsx8(
+            Btn,
+            {
+              size: "sm",
+              onClick: () => void saveLayoutAndRouting(),
+              disabled: savingLayout || readOnly || hasData && crossesMeasure || hasData && editKind === source.kind,
+              children: savingLayout ? "Saving\u2026" : "Save"
+            }
+          )
         ] }),
         /* @__PURE__ */ jsxs8("div", { className: "cfi-vi-panel", children: [
           /* @__PURE__ */ jsxs8("div", { className: "cfi-vi-row", children: [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@campfire-interactive/volume-intelligence-ui",
-  "version": "0.9.1",
+  "version": "0.11.1",
   "description": "Shared Volume Intelligence UI components (volume import) for the Campfire Suite — embedded by the VI webapp and by consuming apps (OMSF) so there is one import surface, not two that drift.",
   "type": "module",
   "main": "dist/index.js",