@instruments/materialgraph 0.11.0 → 0.12.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -105,6 +105,22 @@ export interface MatchSurfaceResult {
105
105
  inferredCategories: MatchCategoryInference[];
106
106
  /** What this surface compared against. Absent means the server did not report it. */
107
107
  comparison?: MatchComparison;
108
+ /**
109
+ * When `results` is empty, WHICH STAGE is responsible. Absent when the
110
+ * surface returned rows, and absent on servers older than this field.
111
+ *
112
+ * - `empty_pool` — nothing eligible was retrieved. A fact about the
113
+ * catalogue under the corpus scope in force.
114
+ * - `quality_floor` — candidates WERE retrieved and every one was rejected.
115
+ * A fact about the engine, not the catalogue.
116
+ * - `unattributed` — no comparison receipt survived to attribute from.
117
+ *
118
+ * The distinction is the point: "we found nothing you can buy" and "we found
119
+ * things and declined them all" are the same empty list and different
120
+ * findings, and only the first belongs on a "nothing available here yet"
121
+ * state.
122
+ */
123
+ emptyReason?: "empty_pool" | "quality_floor" | "unattributed";
108
124
  /**
109
125
  * The verifier's reading of each candidate, when it ran.
110
126
  *
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@instruments/materialgraph",
3
- "version": "0.11.0",
3
+ "version": "0.12.0",
4
4
  "type": "module",
5
5
  "exports": {
6
6
  ".": {