@instruments/materialgraph 3.1.0 → 3.3.0

package/association-types.d.ts

@@ -22,24 +22,24 @@ import type { SearchCatalogSubset } from "./search-catalog-subset-types.js";
  * score or used to rank. Declared associations carry no ranking at all: that is
  * the point of them.
  */
-export type DeclaredProvenance = {
+export interface DeclaredProvenance {
     /** The stored convention value (0.9 today). Never a per-edge measurement. */
     confidence: number;
     /** The brand enumerated this association in its own catalog data. */
     basis: "manufacturer_declared";
     /** The provenance recorded on the edge - the brand catalog feed. */
     source: "warehouse";
-};
+}
 /** The material the question was asked about, resolved to its identity. */
-export type DeclaredAssociationSubject = {
+export interface DeclaredAssociationSubject {
     variantId: VariantId;
     brand: string;
     product: string;
     /** The variant's own name; null when it is unnamed. */
     variantName: string | null;
-};
+}
 /** One declared association, plus why it is believed. */
-export type DeclaredAssociation = {
+export interface DeclaredAssociation {
     variantId: VariantId;
     brand: string;
     product: string;
@@ -65,7 +65,7 @@ export type DeclaredAssociation = {
      * pages. Absent when the product has no eligible variant.
      */
     colorwayCount?: number;
-};
+}
 /**
  * One page of declared associations.
  *
@@ -74,7 +74,7 @@ export type DeclaredAssociation = {
  * is the whole set for this subject, direction and corpus scope. A page is not a
  * corpus — walk `nextCursor` before making any claim about the full set.
  */
-export type DeclaredAssociationsResponse = {
+export interface DeclaredAssociationsResponse {
     subject: DeclaredAssociationSubject;
     /**
      * Constant discriminator. Its presence is how a caller tells a declared fact
@@ -88,9 +88,9 @@ export type DeclaredAssociationsResponse = {
     returnedCount: number;
     /** Present only when another page exists; pass back verbatim as `cursor`. */
     nextCursor?: Cursor;
-};
+}
 /** Options for a declared-association read. */
-export type AssociatedOptions = {
+export interface AssociatedOptions {
     /**
      * Page size, 1–48 inclusive (default 24). The server rejects (400), not
      * clamps, values outside this range.
@@ -111,7 +111,7 @@ export type AssociatedOptions = {
      * different one is a 400, never a silently different page.
      */
     cursor?: Cursor;
-};
+}
 export type ApplicabilitySubject = {
     kind: "product";
     id: string;
@@ -120,15 +120,15 @@ export type ApplicabilitySubject = {
     id: VariantId;
 };
 export type ApplicabilityCoverageState = "available" | "partial" | "none_declared" | "not_ingested" | "source_not_applicable" | "unavailable";
-export type ApplicabilityCoverage = {
+export interface ApplicabilityCoverage {
     state: ApplicabilityCoverageState;
     countKind: "exact" | "partial";
     declaredCount: number | null;
     sourceAuthority: string;
     sourceLocator: string;
     sourceRevision: string;
-};
-export type ApplicabilityFact = {
+}
+export interface ApplicabilityFact {
     id: string;
     subject: ApplicabilitySubject;
     finish: {
@@ -144,8 +144,8 @@ export type ApplicabilityFact = {
         revision: string;
     };
     lifecycle: "active";
-};
-export type ApplicabilitySourceEntry = {
+}
+export interface ApplicabilitySourceEntry {
     scope: {
         sourceAuthority: string;
         sourceLocator: string;
@@ -158,8 +158,8 @@ export type ApplicabilitySourceEntry = {
     facts: ApplicabilityFact[];
     /** Source endpoints that could not be resolved during reconciliation. */
     unresolved: UnresolvedApplicabilityEndpoint[];
-};
-export type UnresolvedApplicabilityEndpoint = {
+}
+export interface UnresolvedApplicabilityEndpoint {
     subjectLocator: string;
     subjectKind: "product" | "variant" | "unknown";
     finishLocator: string;
@@ -171,14 +171,14 @@ export type UnresolvedApplicabilityEndpoint = {
         locator: string;
         revision: string;
     };
-};
+}
 /** Source-grained response; sources are never merged or given hidden precedence. */
-export type ApplicabilityResponse = {
+export interface ApplicabilityResponse {
     kind: "manufacturer_declared_applicability";
     requestedSubject: ApplicabilitySubject;
     direction: "forward" | "reverse";
     sources: ApplicabilitySourceEntry[];
-};
+}
 export type ApplicabilityOptions = {
     subjectKind: "product";
     subjectId: string;

package/baseline-types.d.ts

@@ -0,0 +1,112 @@
+/**
+ * @module baseline-types
+ * @description Hand-maintained mirror of the Performance Baseline reads' wire
+ * shapes (`list_baselines`, `check_baselines`). The source of truth is
+ * `packages/search/src/baselines/baselines-contract.ts`; this SDK has no
+ * runtime dependency on `@materialgraph/search`, so the shapes are copied
+ * here and `contract-parity.test.ts` keeps them honest.
+ */
+import type { OpenEnum } from "./types.js";
+/** Why a baseline exists. How binding it is on a project, the project decides. */
+export type BaselineStrength = OpenEnum<"code_driven" | "industry_guideline" | "common_practice">;
+/** The published source a baseline was read from. */
+export interface BaselineSource {
+    citation: string;
+    edition: string;
+    publisher: string;
+    /** The day the page at `url` was read (ISO date). */
+    readOn: string;
+    url: string;
+}
+/** One way to meet a baseline: a `listVariants()` `filters` value. */
+export type BaselineWayToMeet = {
+    terms: {
+        field: string;
+        op: "in";
+        values: string[];
+    }[];
+} | {
+    numbers: {
+        field: string;
+        op: "gte";
+        value: number;
+    }[];
+};
+/**
+ * What a kind of material is normally expected to achieve in a kind of
+ * project. A typical expectation with its published source, never a code
+ * determination.
+ */
+export interface Baseline {
+    /** What it asks for, in a specifier's words. */
+    expects: string;
+    id: string;
+    note: string;
+    productTypeIds: string[];
+    sources: BaselineSource[];
+    /** The rooms it is for; null when it holds anywhere in the project. */
+    spaces: string[] | null;
+    strength: BaselineStrength;
+    /** A variant matching any one of these meets the baseline. */
+    waysToMeet: BaselineWayToMeet[];
+}
+/** Options for `listBaselines()` (GET `/api/v1/baselines`). */
+export interface ListBaselinesOptions {
+    /** Keep baselines for these product types; omit for all. */
+    productTypeIds?: readonly string[];
+    /** A `sector` dictionary term that has baselines, e.g. `hospitality`. */
+    sector: string;
+    /** A room from the `use` dictionary, e.g. `corridor`. Omit for anywhere. */
+    space?: string;
+}
+export interface ListBaselinesResult {
+    baselines: Baseline[];
+    /** Show this wherever a baseline is shown. */
+    caveat: string;
+    sector: string;
+    space: string | null;
+    /** Rooms in this sector that have baselines of their own. */
+    spacesWithBaselines: string[];
+}
+/** Input for `checkBaselines()` (POST `/api/v1/baselines/check`). */
+export interface CheckBaselinesInput {
+    sector: string;
+    space?: string;
+    /** 1 to 50 variant ids. */
+    variantIds: readonly string[];
+}
+/** `not_stated`: the brand states no value on that scale. A gap, never a fail. */
+export type BaselineResult = OpenEnum<"matches" | "does_not_match" | "not_stated">;
+export interface CheckBaselinesResult {
+    /** The baselines applied, each with how many variants fell under each result. */
+    baselines: (Baseline & {
+        counts: {
+            doesNotMatch: number;
+            matches: number;
+            notStated: number;
+        };
+    })[];
+    /** Show this wherever a result is shown. */
+    caveat: string;
+    sector: string;
+    space: string | null;
+    unavailableVariantIds?: string[];
+    unresolvedVariantIds?: string[];
+    variants: {
+        brand: string;
+        name: string;
+        product: string;
+        productType: string | null;
+        /** Empty: no baseline covers this product type here. */
+        results: {
+            baselineId: string;
+            result: BaselineResult;
+            /** What the brand states for the attributes the baseline reads. */
+            stated: {
+                attributeId: string;
+                value: string;
+            }[];
+        }[];
+        variantId: string;
+    }[];
+}

package/baseline-types.js

@@ -0,0 +1 @@
+export {};

package/brand-types.d.ts

@@ -4,7 +4,7 @@
  * `list_brands` tool and the `mg brand list` command take.
  */
 import type { SearchCatalogSubset } from "./search-catalog-subset-types.js";
-export type BrandsOptions = {
+export interface BrandsOptions {
     /**
      * A brand name, alias or misspelling, e.g. `"Kvadrat"`. Omit to browse the
      * list by name. Every brand the text matches comes back, so an ambiguous name
@@ -26,8 +26,8 @@ export type BrandsOptions = {
     limit?: number;
     /** The previous page's `pageInfo.endCursor`, with the same `query`, `categoryId` and `searchCatalogSubset`. */
     cursor?: string;
-};
-export type BrandItem = {
+}
+export interface BrandItem {
     /**
      * The brand's slug: the value `listVariants()`' `brand` filter and
      * `resolveVariant()`' `brandId` take. Never a display name.
@@ -36,8 +36,8 @@ export type BrandItem = {
     name: string;
     /** The brand's homepage, or null when none is on record. */
     website: string | null;
-};
-export type ListBrandsPage = {
+}
+export interface ListBrandsPage {
     /** THIS PAGE. Follow `pageInfo.endCursor` for the rest; a page is not a total. */
     items: BrandItem[];
     pageInfo: {
@@ -45,4 +45,4 @@ export type ListBrandsPage = {
         endCursor: string | null;
         hasNextPage: boolean;
     };
-};
+}

package/by-spec-types.d.ts

@@ -22,7 +22,7 @@ export type BySpecVerdictState = "matched" | "deviated" | "failed" | "unverified
  * Hand-mirrors the `AttributeVerdict` contract from `@materialgraph/contracts`;
  * the OpenAPI `CatalogBySpecResponse` schema is the source of truth on the wire.
  */
-export type BySpecVerdictCell = {
+export interface BySpecVerdictCell {
     attributeId: string;
     state: BySpecVerdictState;
     strength: "required" | "preferred";
@@ -57,7 +57,7 @@ export type BySpecVerdictCell = {
      *  - `basis_unmet` — the value's source is weaker than the criterion demanded.
      */
     trustGap: "below_confidence" | "basis_unmet" | null;
-};
+}
 /**
  * A match's full report card: every cell, the rolled-up grade, weakest confidence.
  *
@@ -70,11 +70,11 @@ export type BySpecVerdictCell = {
  * `minConfidence` is the WEAKEST cell's confidence — the honest ceiling on the
  * whole card, not an average. Quote it alongside the grade.
  */
-export type BySpecVerdict = {
+export interface BySpecVerdict {
     cells: BySpecVerdictCell[];
     grade: "meets_all" | "close" | "hard_no";
     minConfidence: number | null;
-};
+}
 /**
  * The verdict a materials-search hit carries (MG-625). It IS the shared
  * {@link BySpecVerdict} shape — the single CandidateVerdict mirror — aliased here
@@ -99,7 +99,7 @@ export type MaterialVerdict = BySpecVerdict;
  * EVERY miss is reported, not just the first, so one round trip is enough to fix
  * a whole spec.
  */
-export type BySpecUnresolvedCriterion = {
+export interface BySpecUnresolvedCriterion {
     /** The parsed attribute id, after the route's surrounding-whitespace trim. */
     attributeId: string;
     /** The parsed value — never overwritten by the attribute id when that id is unknown. */
@@ -108,4 +108,4 @@ export type BySpecUnresolvedCriterion = {
     reason?: "unknown_attribute_or_term" | "not_a_specification";
     /** Ranked candidates for whichever half failed. See {@link ValueResolution}. */
     resolution: ValueResolution;
-};
+}

package/catalog-discovery-types.d.ts

@@ -11,7 +11,7 @@ import type { OpenEnum } from "./types.js";
  * first: `exact_id` > `exact_alias` > `lexical` > `semantic`. A `semantic` hit
  * is a guess worth confirming, not an equivalence.
  */
-export type ResolveValueCandidate = {
+export interface ResolveValueCandidate {
     id: string;
     label: string;
     dictionaryId?: string;
@@ -19,7 +19,7 @@ export type ResolveValueCandidate = {
     tier: OpenEnum<"exact_id" | "exact_alias" | "lexical" | "semantic">;
     /** Present only for a color_family candidate resolved via the colorscope fallback. */
     via?: OpenEnum<"colorscope">;
-};
+}
 /**
  * The resolver's verdict on ONE free-text token — the single shape every
  * resolving surface speaks, so a caller learns to read it once. Carried per bad
@@ -40,10 +40,10 @@ export type ResolveValueCandidate = {
  * `query` is the trimmed token that was actually resolved, which is how you tell
  * WHICH half of a failed `attribute:value` pair was the problem.
  */
-export type ValueResolution = {
+export interface ValueResolution {
     status: OpenEnum<"resolved" | "ambiguous" | "unresolved">;
     query: string;
     best: ResolveValueCandidate | null;
     candidates: ResolveValueCandidate[];
     recommendedAction: OpenEnum<"use_best" | "choose_from_candidates" | "ask_user" | "none_found">;
-};
+}

package/categories-client.d.ts

@@ -19,9 +19,9 @@ import type { CategoriesGetResult, CategoriesListInput, CategoriesListResult } f
 import type { QueryParams } from "./http-transport.js";
 import type { JsonOperationId, OperationResponses } from "./operation-responses.js";
 /** The client's own request primitive, handed down so this file owns no transport. */
-export type CategoriesTransport = {
-    get<K extends JsonOperationId>(operationId: K, query?: QueryParams, signal?: AbortSignal, pathParams?: Readonly<Record<string, string>>): Promise<OperationResponses[K]>;
-};
+export interface CategoriesTransport {
+    get: <K extends JsonOperationId>(operationId: K, query?: QueryParams, signal?: AbortSignal, pathParams?: Readonly<Record<string, string>>) => Promise<OperationResponses[K]>;
+}
 export declare class CategoriesClient {
     #private;
     constructor(transport: CategoriesTransport);

package/category-types.d.ts

@@ -12,22 +12,22 @@
  */
 import type { OpenEnum } from "./types.js";
 /** A category named by id, as in `ancestors` and `children`. */
-export type CategoryRef = {
+export interface CategoryRef {
     id: string;
     name: string;
-};
+}
 export type CategoryKind = OpenEnum<"category">;
 /** How a query matched source category names or exact paths through the lexical matcher. */
-export type CategoryMatch = {
+export interface CategoryMatch {
     /** The name or source path that matched. */
     matchedText: string | null;
     method: OpenEnum<"exact" | "alias" | "fuzzy">;
-};
+}
 /**
  * One item on a `categories.list` page: what picks the next call. `get(id)`
  * has the source path, depth, ancestors and children.
  */
-export type CategoryItem = {
+export interface CategoryItem {
     /** Whether `categories.list({ parentId: this.id })` lists anything. */
     hasChildren: boolean;
     /** A source category identity, also used in product_category memberships. */
@@ -39,14 +39,14 @@ export type CategoryItem = {
     parentId: string | null;
     path: string;
     depth: number;
-};
-export type CategoriesPageInfo = {
+}
+export interface CategoriesPageInfo {
     /** Pass back as `cursor` with the same `query` and `parentId` for the next page. */
     nextCursor: string | null;
     returnedCount: number;
     totalMatches: number;
-};
-export type CategoriesListInput = {
+}
+export interface CategoriesListInput {
     /** `pageInfo.nextCursor` from the previous page, with the same `query` and `parentId`. */
     cursor?: string;
     /** Items per page, 1 to 50. Default 20. */
@@ -55,21 +55,21 @@ export type CategoriesListInput = {
     parentId?: string;
     /** A category name or description, e.g. `"wallpaper"` or `"beds"`. */
     query?: string;
-};
-export type CategoriesListResult = {
+}
+export interface CategoriesListResult {
     items: CategoryItem[];
     /** Present only when the query is refused as a category, and says why. */
     notice?: string;
     pageInfo: CategoriesPageInfo;
-};
+}
 /** Independent semantic mapping metadata; it does not assert source category membership. */
-export type CategoryConcept = {
+export interface CategoryConcept {
     label: string;
     match?: OpenEnum<"exact" | "close" | "broad" | "narrow">;
     termId: string;
     uri: string;
-};
-export type CategoryProductCategory = {
+}
+export interface CategoryProductCategory {
     concepts: CategoryConcept[];
     /** Legacy semantic mapping value, separate from source product_category enum[] values. */
     recordValue: string | null;
@@ -79,8 +79,8 @@ export type CategoryProductCategory = {
      * fits yet.
      */
     status: OpenEnum<"mapped" | "conditional" | "unmapped">;
-};
-export type CategoriesGetResult = {
+}
+export interface CategoriesGetResult {
     /** Phrases that name this category in a `query`. */
     aliases: string[];
     /** The categories above this one, root first. Empty for a top-level category. */
@@ -98,4 +98,4 @@ export type CategoriesGetResult = {
     path: string;
     /** Zero-based depth in the source hierarchy. */
     depth: number;
-};
+}

package/client-config.d.ts

@@ -5,7 +5,7 @@
  */
 /** The hosted API origin the client talks to unless `baseUrl` overrides it. */
 export declare const DEFAULT_BASE_URL = "https://beta.materialgraph.com";
-export type MaterialGraphClientOptions = {
+export interface MaterialGraphClientOptions {
     /** A `mg_read_*` API key, presented as `Authorization: Bearer <key>`. */
     apiKey: string;
     /** Override the API origin. Defaults to {@link DEFAULT_BASE_URL}. */
@@ -19,4 +19,4 @@ export type MaterialGraphClientOptions = {
      * they end or the caller aborts. Absent means no deadline.
      */
     timeoutMs?: number;
-};
+}

package/client-response-schema.d.ts

@@ -1,3 +1,3 @@
-import type { JsonSchema } from "./response-schemas.js";
+import type { JsonObject } from "./json.js";
 /** Adapt a fresh producer schema to the SDK's existing open string enums. */
-export declare const openClientResponseEnums: (schema: JsonSchema) => void;
+export declare const openClientResponseEnums: (schema: JsonObject) => void;

package/client-response-schema.js

@@ -1,4 +1,4 @@
-const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+import { isJsonObject } from "./json.js";
 // Only the fields declared as OpenEnum in the SDK are open here. Union
 // discriminants stay closed so their associated object shapes remain true.
 const openStrings = new Set([
@@ -14,7 +14,7 @@ const openStrings = new Set([
     "MaterialTile.imageSource",
     "PairingItem.availability",
     "PairingItem.imageSource",
-    "PairingItem.demand.momentum.state",
+    "PairingItem.demand.trend",
     "PairingItem.ranking.basis",
     "PairingOrdering.anchorColorBasis",
     "PairingOrdering.applied",
@@ -47,19 +47,19 @@ const openStrings = new Set([
 /** Adapt a fresh producer schema to the SDK's existing open string enums. */
 export const openClientResponseEnums = (schema) => {
     const visit = (node, path) => {
-        if (!isRecord(node)) {
+        if (!isJsonObject(node)) {
             return;
         }
         if (node.type === "string" && openStrings.has(path)) {
             delete node.enum;
             delete node.const;
         }
-        if (isRecord(node.$defs)) {
+        if (isJsonObject(node.$defs)) {
             for (const [name, definition] of Object.entries(node.$defs)) {
                 visit(definition, name);
             }
         }
-        if (isRecord(node.properties)) {
+        if (isJsonObject(node.properties)) {
             for (const [name, property] of Object.entries(node.properties)) {
                 visit(property, `${path}.${name}`);
             }

package/client-vocabulary.d.ts

@@ -1,6 +1,8 @@
+import type { ListBaselinesOptions, ListBaselinesResult } from "./baseline-types.js";
 import type { HttpTransport } from "./http-transport.js";
 import type { ListEnumValuesOptions, ListEnumValuesResult } from "./list-enum-values-types.js";
 import type { ListAttributesOptions, ListAttributesResult, ResolveColorOptions, ResolveColorResponse } from "./types.js";
 export declare const resolveColor: (transport: HttpTransport, name: string, signal?: AbortSignal, options?: ResolveColorOptions) => Promise<ResolveColorResponse>;
 export declare const listAttributes: (transport: HttpTransport, options?: ListAttributesOptions, signal?: AbortSignal) => Promise<ListAttributesResult>;
 export declare const listEnumValues: (transport: HttpTransport, options?: ListEnumValuesOptions, signal?: AbortSignal) => Promise<ListEnumValuesResult>;
+export declare const listBaselines: (transport: HttpTransport, options: ListBaselinesOptions, signal?: AbortSignal) => Promise<ListBaselinesResult>;

package/client-vocabulary.js

@@ -1,6 +1,6 @@
 import { resolveOperation } from "./operations.js";
 export const resolveColor = async (transport, name, signal, options) => await transport.requestJson(resolveOperation("resolve_color_name"), {
-    query: { searchCatalogSubset: options?.searchCatalogSubset, name },
+    query: { name, searchCatalogSubset: options?.searchCatalogSubset },
     signal,
 });
 /**
@@ -28,3 +28,11 @@ export const listEnumValues = async (transport, options, signal) => await transp
     },
     signal,
 });
+export const listBaselines = async (transport, options, signal) => await transport.requestJson(resolveOperation("list_baselines"), {
+    query: {
+        productTypeIds: commaList(options.productTypeIds),
+        sector: options.sector,
+        space: options.space,
+    },
+    signal,
+});

package/client.d.ts

@@ -1,4 +1,5 @@
 import type { ApplicabilityOptions, AssociatedOptions } from "./association-types.js";
+import type { CheckBaselinesInput, CheckBaselinesResult, ListBaselinesOptions, ListBaselinesResult } from "./baseline-types.js";
 import type { BrandsOptions } from "./brand-types.js";
 import { CategoriesClient } from "./categories-client.js";
 import type { MaterialGraphClientOptions } from "./client-config.js";
@@ -8,6 +9,7 @@ import type { RateLimit } from "./errors.js";
 import type { FindSampledTogetherInput, FindSampledTogetherOutput } from "./find-sampled-together-types.js";
 import type { FindVariantsByColorInput, FindVariantsByColorOutput } from "./find-variants-by-color-types.js";
 import type { FindVariantsByVectorInput, FindVariantsByVectorOutput } from "./find-variants-by-vector-types.js";
+import type { GetVariantDemandInput, GetVariantDemandOutput, ListRisingVariantsInput, ListRisingVariantsOutput } from "./get-variant-demand-types.js";
 import type { GetVariantOptions, GetVariantOutput } from "./get-variant-types.js";
 import type { VariantId } from "./identifiers.js";
 import type { ListEnumValuesOptions, ListEnumValuesResult } from "./list-enum-values-types.js";
@@ -113,6 +115,19 @@ export declare class MaterialGraphClient {
      * never a guess. The submitted URL is never persisted.
      */
     resolveVariant(input: ResolveVariantInput, signal?: AbortSignal): Promise<ResolveVariantOutput>;
+    /**
+     * How much each of 1 to 48 variants is sampled by Material Bank members
+     * (POST `/api/v1/demand`): `samplePercentile` within its category, with a
+     * `trend` and the `change` of this year against the year before. Results
+     * keep request order. No count is returned.
+     */
+    getVariantDemand(input: GetVariantDemandInput, signal?: AbortSignal): Promise<GetVariantDemandOutput>;
+    /**
+     * The variants of one category sampled at least 15% more this year than
+     * the year before (GET `/api/v1/demand/rising`), largest `change` first.
+     * No count is returned.
+     */
+    listRisingVariants(input: ListRisingVariantsInput, signal?: AbortSignal): Promise<ListRisingVariantsOutput>;
     /**
      * THE QUESTION: "tell me about THIS variant" (GET
      * `/api/v1/variants/{variantId}`, `get_variant`).
@@ -229,9 +244,9 @@ export declare class MaterialGraphClient {
     /**
      * Every Sampled Together pair in the current generation (GET
      * `/api/v1/variants/sampled-together/pairs`), trailing 36 months, sampled,
-     * each pair once with `a < b`. `aProjects` and `bProjects` are each side's
-     * own project total, so a sample pack can be dropped without one call per
-     * variant. Follow `nextCursor` until it is null; a page is not a total.
+     * each pair once with `a < b`. `packShare` is the pair's share of the rarer
+     * side's own sampled projects, so a sample pack can be dropped without one
+     * call per variant. Follow `nextCursor` until it is null; a page is not a total.
      */
     listSampledTogetherPairs(input?: ListSampledTogetherPairsInput, signal?: AbortSignal): Promise<ListSampledTogetherPairsOutput>;
     /**
@@ -269,6 +284,20 @@ export declare class MaterialGraphClient {
      * `pageInfo.endCursor` for the next page.
      */
     listEnumValues(options?: ListEnumValuesOptions, signal?: AbortSignal): Promise<ListEnumValuesResult>;
+    /**
+     * The Performance Baselines for a sector, and for a room within it when one
+     * is named: what a kind of material is normally expected to achieve, each
+     * with why it exists and its published source. Each `waysToMeet` entry is a
+     * `filters` value for {@link MaterialGraphClient.listVariants}. A typical
+     * expectation, never a code determination: show `caveat` with it.
+     */
+    listBaselines(options: ListBaselinesOptions, signal?: AbortSignal): Promise<ListBaselinesResult>;
+    /**
+     * Up to 50 variants read against a sector's Performance Baselines. Each
+     * result is `matches`, `does_not_match` or `not_stated`, with what the brand
+     * states; `not_stated` is a gap in the data and never a failure.
+     */
+    checkBaselines(input: CheckBaselinesInput, signal?: AbortSignal): Promise<CheckBaselinesResult>;
     /**
      * THE QUESTION: "what is this key allowed to do?" Check `scopes` before
      * offering a capability: the write surfaces need `mg:ingest` / `mg:compose`,