@instruments/materialgraph 1.2.0 → 1.3.0

package/find-sampled-together-types.d.ts

@@ -48,6 +48,8 @@ export type FindSampledTogetherRow = {
         proportion: number;
     }[];
     variantId: string;
+    /** The trimmed source variant label; null when unknown or for a paint color sample. Separate from surface finish, color family and derived color names. */
+    variantLabel: string | null;
     variantName: string | null;
 };
 export type FindSampledTogetherOutput = {
@@ -63,6 +65,8 @@ export type FindSampledTogetherOutput = {
         /** The id or name this seed came from. */
         resolvedFrom: string;
         variantId: string;
+        /** The trimmed source variant label; null when unknown or for a paint color sample. Separate from surface finish, color family and derived color names. */
+        variantLabel: string | null;
         variantName: string | null;
     }[];
     /** Seed ids outside the materials catalog; present only when at least one was. */

package/find-variants-by-color-types.d.ts

@@ -91,6 +91,8 @@ export type UnresolvedColor = {
     input: string | null;
 };
 export type ColorVariantMatch = {
+    /** The trimmed source variant label; null when unknown or for a paint color sample. Separate from surface finish, color family and derived color names. */
+    variantLabel: string | null;
     productType: {
         id: string;
         name: string;
@@ -156,6 +158,8 @@ export type ColorRankedSeed = {
 };
 /** RERANK's own card — the same shape `ColorVariantMatch` above (`brandId`, `code`), plus its perceptual distance. */
 export type ColorRankMatch = {
+    /** The trimmed source variant label; null when unknown or for a paint color sample. Separate from surface finish, color family and derived color names. */
+    variantLabel: string | null;
     brand: string;
     brandId: string;
     code: string | null;

package/get-variant-types.d.ts

@@ -94,7 +94,7 @@ export type GetVariantOutput = {
     /** The variant's Material Bank SKU. Absent means none is recorded. */
     materialBankId?: string;
     name: string;
-    /** The trimmed source variant label; null when unknown. Separate from surface finish and derived color names. */
+    /** The trimmed source variant label; null when unknown or for a paint color sample, whose own name identifies its color. Separate from surface finish, color family and derived color names. */
     variantLabel: string | null;
     /** Requested blocks or attributes the variant's product type does not carry. */
     notApplicable?: ListVariantsNotApplicable;

package/list-variants-types.d.ts

@@ -207,7 +207,7 @@ export type ListVariantsItem = {
     /** The variant's Material Bank SKU. Absent means none is recorded. */
     materialBankId?: string;
     name: string;
-    /** The trimmed source variant label; null when unknown. Separate from surface finish and derived color names. */
+    /** The trimmed source variant label; null when unknown or for a paint color sample, whose own name identifies its color. Separate from surface finish, color family and derived color names. */
     variantLabel: string | null;
     notApplicable?: ListVariantsNotApplicable;
     preference?: ListVariantsPreference;

package/package.json

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