@instruments/materialgraph 0.6.1 → 0.7.0

package/client.js

@@ -294,7 +294,9 @@ export class MaterialGraphClient {
      * you how much of the rail is real order evidence.
      */
     pairings(variantId, options, signal) {
-        return this.#get("get_material_pairings", { categories: options?.categories, limit: options?.limit }, signal, { variantId });
+        return this.#get("get_material_pairings", { ...options }, signal, {
+            variantId,
+        });
     }
     materials(ids, options, signal) {
         if (ids.length > MAX_BATCH_IDS) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@instruments/materialgraph",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "type": "module",
   "exports": {
     ".": {

package/types.d.ts

@@ -395,6 +395,8 @@ export interface CospecPairing {
     liftLabel: string;
     demand: CompanionDemand | null;
     topProjectTypes: ProjectTypeShare[];
+    /** Graph-owned colour ranking facts, present only for an explicitly ordered rail. */
+    ranking?: PairingRanking;
 }
 /**
  * A pairing item topped up from colour palette-similarity — a LOOK-ALIKE, not
@@ -405,6 +407,30 @@ export interface CospecPairing {
 export interface ColourPairing extends MaterialTile {
     source: "colour";
     score: number;
+    /** Graph-owned colour ranking facts, present only for an explicitly ordered rail. */
+    ranking?: PairingRanking;
+}
+export type PairingOrderMode = "relevance" | "lightness_asc" | "lightness_desc";
+export type PairingCorpus = "all" | "material_bank";
+export interface PairingRanking {
+    anchorColourSimilarity: number | null;
+    lightness: number | null;
+    anchorColourSimilarityMeasurable: boolean;
+    lightnessMeasurable: boolean;
+    basis: OpenEnum<"dominant_colour_oklab">;
+}
+export interface PairingOrdering {
+    requested: OpenEnum<PairingOrderMode>;
+    applied: OpenEnum<PairingOrderMode>;
+    direction: OpenEnum<"ascending" | "descending">;
+    anchorColourBasis: OpenEnum<"one_minus_oklab_euclidean_distance">;
+    colourSpace: OpenEnum<"oklab">;
+    lightnessRange: {
+        min: 0;
+        max: 1;
+    };
+    missingValues: OpenEnum<"last">;
+    tieBreak: OpenEnum<"variantId_asc">;
 }
 /**
  * One pairing, discriminated by `source` into three tiers of very different
@@ -422,6 +448,10 @@ export interface PairingsResponse {
      * check it before presenting the rail as demand evidence.
      */
     cospecCount: number;
+    /** Present only when `order` was requested. Evidence tiers remain independent. */
+    ordering?: PairingOrdering;
+    /** Opaque continuation bound to the seed, filters, corpus, and order. */
+    nextCursor?: Cursor;
 }
 export interface MaterialResponse {
     material: MaterialDetail;
@@ -666,6 +696,12 @@ export interface PairingsOptions {
     /** Comma-separated coarse category display names; filters both arms. */
     categories?: string;
     limit?: number;
+    /** Graph-owned order applied within fixed cospec → considered → colour tiers. */
+    order?: PairingOrderMode;
+    /** Optional Material Bank/orderable gate; requires an explicit `order`. */
+    corpus?: PairingCorpus;
+    /** The previous response's `nextCursor`, passed back verbatim. */
+    cursor?: Cursor;
 }
 /** Options for `catalog/attributes/resolve`. */
 export interface ResolveAttributeOptions {