@instruments/materialgraph 0.24.0 → 0.26.0

package/association-types.d.ts

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

package/associations-client.d.ts

@@ -13,7 +13,7 @@
  * "available on".
  */
 import type { ApplicabilityOptions, ApplicabilityResponse, AssociatedOptions, DeclaredAssociationsResponse } from "./association-types.js";
-import { HttpTransport } from "./http-transport.js";
+import type { HttpTransport } from "./http-transport.js";
 import type { VariantId } from "./identifiers.js";
 /**
  * THE QUESTION: "what finishes can I get on THIS chair?" — the fabrics,
@@ -33,7 +33,7 @@ import type { VariantId } from "./identifiers.js";
  *
  * @param variantId The PRODUCT variant. Opaque — pass back exactly what you were given.
  */
-export declare function declaredFinishes(transport: HttpTransport, variantId: VariantId, options?: AssociatedOptions, signal?: AbortSignal): Promise<DeclaredAssociationsResponse>;
+export declare const declaredFinishes: (transport: HttpTransport, variantId: VariantId, options?: AssociatedOptions, signal?: AbortSignal) => Promise<DeclaredAssociationsResponse>;
 /**
  * THE QUESTION: "what furniture takes THIS fabric?" — the products the
  * MANUFACTURER declares a finish variant is available on (GET
@@ -48,6 +48,6 @@ export declare function declaredFinishes(transport: HttpTransport, variantId: Va
  *
  * @param variantId The FINISH variant. Opaque — pass back exactly what you were given.
  */
-export declare function declaredProducts(transport: HttpTransport, variantId: VariantId, options?: AssociatedOptions, signal?: AbortSignal): Promise<DeclaredAssociationsResponse>;
+export declare const declaredProducts: (transport: HttpTransport, variantId: VariantId, options?: AssociatedOptions, signal?: AbortSignal) => Promise<DeclaredAssociationsResponse>;
 /** Read manufacturer-declared applicability without collapsing Product/Variant grain. */
-export declare function applicability(transport: HttpTransport, options: ApplicabilityOptions, signal?: AbortSignal): Promise<ApplicabilityResponse>;
+export declare const applicability: (transport: HttpTransport, options: ApplicabilityOptions, signal?: AbortSignal) => Promise<ApplicabilityResponse>;

package/associations-client.js

@@ -1,4 +1,3 @@
-import { HttpTransport } from "./http-transport.js";
 import { resolveOperation } from "./operations.js";
 /**
  * THE QUESTION: "what finishes can I get on THIS chair?" — the fabrics,
@@ -18,9 +17,7 @@ import { resolveOperation } from "./operations.js";
  *
  * @param variantId The PRODUCT variant. Opaque — pass back exactly what you were given.
  */
-export function declaredFinishes(transport, variantId, options, signal) {
-    return transport.requestJson(resolveOperation("list_associated_finishes"), { query: { variantId, ...options }, signal });
-}
+export const declaredFinishes = async (transport, variantId, options, signal) => await transport.requestJson(resolveOperation("list_associated_finishes"), { query: { variantId, ...options }, signal });
 /**
  * THE QUESTION: "what furniture takes THIS fabric?" — the products the
  * MANUFACTURER declares a finish variant is available on (GET
@@ -35,10 +32,6 @@ export function declaredFinishes(transport, variantId, options, signal) {
  *
  * @param variantId The FINISH variant. Opaque — pass back exactly what you were given.
  */
-export function declaredProducts(transport, variantId, options, signal) {
-    return transport.requestJson(resolveOperation("list_associated_products"), { query: { variantId, ...options }, signal });
-}
+export const declaredProducts = async (transport, variantId, options, signal) => await transport.requestJson(resolveOperation("list_associated_products"), { query: { variantId, ...options }, signal });
 /** Read manufacturer-declared applicability without collapsing Product/Variant grain. */
-export function applicability(transport, options, signal) {
-    return transport.requestJson(resolveOperation("get_applicability"), { query: options, signal });
-}
+export const applicability = async (transport, options, signal) => await transport.requestJson(resolveOperation("get_applicability"), { query: options, signal });

package/attribution-types.d.ts

@@ -18,7 +18,7 @@
  * that route has no `mode`, so this is the only field its outcomes can be
  * grouped by.
  */
-export type AttributionBasis = "image" | "colour" | "text" | "lexical" | "entity-browse" | "match";
+export type AttributionBasis = "image" | "colour" | "text" | "lexical" | "entity-browse" | "agent" | "match";
 /**
  * Envelope-level attribution receipt, on every successful ranked response.
  *
@@ -37,7 +37,7 @@ export type AttributionBasis = "image" | "colour" | "text" | "lexical" | "entity
  * Both fields are optional in the SDK types for one reason only: a server
  * predating MG-1131 does not send them. Every current response does.
  */
-export interface ResponseAttribution {
+export type ResponseAttribution = {
     /**
      * This response's stable id — the same value as the `X-Request-Id` header.
      * Opaque: store it verbatim, never parse it. Group your stored outcomes by
@@ -48,4 +48,4 @@ export interface ResponseAttribution {
     basis: AttributionBasis;
     /** ISO-8601 timestamp of when the response was assembled. */
     issuedAt: string;
-}
+};

package/brand-most-sampled-types.d.ts

@@ -1,5 +1,5 @@
 import type { CandidateReadCard } from "./exploration-types.js";
-export interface BrandMostSampledResponse {
+export type BrandMostSampledResponse = {
     data: {
         brand: {
             id: string;
@@ -15,14 +15,14 @@ export interface BrandMostSampledResponse {
             windowStart: string;
             windowEnd: string;
         } | null;
-        products: Array<{
+        products: {
             rank: number;
             sampleOrderLines: number;
             representativeVariantSampleOrderLines: number;
             card: CandidateReadCard & {
                 category: string | null;
             };
-        }>;
+        }[];
     };
     meta: {
         operationId: "brands.most_sampled";
@@ -30,4 +30,4 @@ export interface BrandMostSampledResponse {
     };
     links: Record<string, never>;
     warnings: never[];
-}
+};

package/brand-types.d.ts

@@ -5,15 +5,15 @@
  * The SDK's one OFFSET-paginated surface — everything else that pages uses an
  * opaque cursor. `meta` is where the page/corpus distinction is settled here.
  */
-export interface BrandsOptions {
+export type BrandsOptions = {
     /** Fuzzy name filter. Omit for the whole collection. */
     q?: string;
     /** Page size. Never a bound on the collection. */
     limit?: number;
     /** Row offset for the next page. Paired with `meta.hasMore`. */
     offset?: number;
-}
-export interface BrandCatalogListItem {
+};
+export type BrandCatalogListItem = {
     id: string;
     slug: string;
     name: string;
@@ -23,8 +23,8 @@ export interface BrandCatalogListItem {
     productCount: number;
     /** Variants ingested into MaterialGraph. A coverage figure, not a claim about the brand. */
     variantCount: number;
-}
-export interface BrandCatalogListPage {
+};
+export type BrandCatalogListPage = {
     /** THIS PAGE. Its length is `meta.count`, never `meta.total`. */
     items: BrandCatalogListItem[];
     /**
@@ -41,4 +41,4 @@ export interface BrandCatalogListPage {
         offset: number;
         hasMore: boolean;
     };
-}
+};

package/brands-client.d.ts

@@ -10,7 +10,7 @@
  */
 import type { BrandCatalogListPage, BrandsOptions } from "./brand-types.js";
 import type { BrandFanDeck } from "./fan-deck-types.js";
-import { HttpTransport } from "./http-transport.js";
+import type { HttpTransport } from "./http-transport.js";
 import type { BrandOptions, BrandProfileResponse } from "./types.js";
 /**
  * THE QUESTION: "whose catalogs are in here, and how big is each?" The SDK's
@@ -18,14 +18,14 @@ import type { BrandOptions, BrandProfileResponse } from "./types.js";
  * `meta.hasMore` to keep walking. Instead use {@link brandProfile} for one
  * brand's profile and trade signals.
  */
-export declare function listBrands(transport: HttpTransport, options?: BrandsOptions, signal?: AbortSignal): Promise<BrandCatalogListPage>;
+export declare const listBrands: (transport: HttpTransport, options?: BrandsOptions, signal?: AbortSignal) => Promise<BrandCatalogListPage>;
 /**
  * THE QUESTION: "who is this brand, and what do they claim?" — profile plus the
  * trade/spec signals ON RECORD. `trade` is keyed by attribute id and an ABSENT
  * key means no value is held — never infer `false`. Instead use `search()` to
  * find their materials; this describes the company, not the catalog.
  */
-export declare function brandProfile(transport: HttpTransport, brandSlug: string, options?: BrandOptions, signal?: AbortSignal): Promise<BrandProfileResponse>;
+export declare const brandProfile: (transport: HttpTransport, brandSlug: string, options?: BrandOptions, signal?: AbortSignal) => Promise<BrandProfileResponse>;
 /**
  * THE QUESTION: "show me this maker's whole range, the way a fan deck reads."
  * Colours grouped by family — creams together, then greys, then browns — and
@@ -45,4 +45,4 @@ export declare function brandProfile(transport: HttpTransport, brandSlug: string
  *
  * @param brandSlug The brand's slug, as `listBrands()` reports it.
  */
-export declare function brandColourDeck(transport: HttpTransport, brandSlug: string, signal?: AbortSignal): Promise<BrandFanDeck>;
+export declare const brandColourDeck: (transport: HttpTransport, brandSlug: string, signal?: AbortSignal) => Promise<BrandFanDeck>;

package/brands-client.js

@@ -1,4 +1,3 @@
-import { HttpTransport } from "./http-transport.js";
 import { resolveOperation } from "./operations.js";
 /**
  * THE QUESTION: "whose catalogs are in here, and how big is each?" The SDK's
@@ -6,21 +5,17 @@ import { resolveOperation } from "./operations.js";
  * `meta.hasMore` to keep walking. Instead use {@link brandProfile} for one
  * brand's profile and trade signals.
  */
-export function listBrands(transport, options = {}, signal) {
-    return transport.requestJson(resolveOperation("list_brands"), {
-        query: { q: options.q, limit: options.limit, offset: options.offset },
-        signal,
-    });
-}
+export const listBrands = async (transport, options = {}, signal) => await transport.requestJson(resolveOperation("list_brands"), {
+    query: { limit: options.limit, offset: options.offset, q: options.q },
+    signal,
+});
 /**
  * THE QUESTION: "who is this brand, and what do they claim?" — profile plus the
  * trade/spec signals ON RECORD. `trade` is keyed by attribute id and an ABSENT
  * key means no value is held — never infer `false`. Instead use `search()` to
  * find their materials; this describes the company, not the catalog.
  */
-export function brandProfile(transport, brandSlug, options, signal) {
-    return transport.requestJson(resolveOperation("get_brand_profile"), { query: { q: options?.q }, pathParams: { brandSlug }, signal });
-}
+export const brandProfile = async (transport, brandSlug, options, signal) => await transport.requestJson(resolveOperation("get_brand_profile"), { pathParams: { brandSlug }, query: { q: options?.q }, signal });
 /**
  * THE QUESTION: "show me this maker's whole range, the way a fan deck reads."
  * Colours grouped by family — creams together, then greys, then browns — and
@@ -40,6 +35,7 @@ export function brandProfile(transport, brandSlug, options, signal) {
  *
  * @param brandSlug The brand's slug, as `listBrands()` reports it.
  */
-export function brandColourDeck(transport, brandSlug, signal) {
-    return transport.requestJson(resolveOperation("brand_colour_deck"), { pathParams: { brandSlug }, signal });
-}
+export const brandColourDeck = async (transport, brandSlug, signal) => await transport.requestJson(resolveOperation("brand_colour_deck"), {
+    pathParams: { brandSlug },
+    signal,
+});

package/browse-types.d.ts

@@ -17,7 +17,7 @@ import type { CorpusScope, CorpusScopeReceipt } from "./corpus-scope-types.js";
 import type { Cursor, ProductId, VariantId } from "./identifiers.js";
 import type { CountedTotal, OpenEnum, SearchFacets } from "./types.js";
 /** One item from the pure colour-scalar browse. */
-export interface BrowseResultItem {
+export type BrowseResultItem = {
     /** Opaque — round-trip verbatim. */
     variantId: VariantId;
     brand: string;
@@ -53,7 +53,7 @@ export interface BrowseResultItem {
      * attribute. Three states, all different.
      */
     attributes?: Record<string, string | string[] | null>;
-}
+};
 /**
  * The browse orders. `name` (A→Z) is the default, `name_desc` the same index
  * read Z→A, `recent` newest first; the rest are the colour ramps. `/search`
@@ -71,9 +71,9 @@ export type BrowseSort = OpenEnum<"name" | "name_desc" | "recent" | "light" | "d
  * narrowed total — you will never get a whole-graph number beside a filtered
  * page.
  */
-export interface BrowseCounts {
+export type BrowseCounts = {
     variants: CountedTotal;
-}
+};
 /**
  * A single page of the browse — the SDK's one genuinely cursor-paginated
  * surface. `results.length` is this page. Ask for `count: true` and `counts`
@@ -81,7 +81,7 @@ export interface BrowseCounts {
  * claim can only come from walking every page (`client.browse.pages(...)` does
  * the loop).
  */
-export interface BrowseResponse {
+export type BrowseResponse = {
     /** THIS PAGE. */
     results: BrowseResultItem[];
     /** Opaque keyset for the next page. Absent = the walk is finished. */
@@ -129,9 +129,9 @@ export interface BrowseResponse {
      * knows, orderable or not.
      */
     corpusScope?: CorpusScopeReceipt;
-}
+};
 /** Params for the pure colour `search/browse` surface. */
-export interface BrowseParams {
+export type BrowseParams = {
     /**
      * OPTIONAL. Defaults to `name` (A→Z); `recent` is newest first.
      *
@@ -233,4 +233,4 @@ export interface BrowseParams {
      * comma-separated `returnAttributes=` parameter.
      */
     returnAttributes?: readonly string[];
-}
+};

package/by-colour-types.d.ts

@@ -11,10 +11,10 @@ import type { VariantId } from "./identifiers.js";
 import type { QueryUnderstanding } from "./query-understanding-types.js";
 import type { OklabTriple, OpenEnum, PaletteSwatch } from "./types.js";
 /** Coarse group + fine type of a colour match's primary product type. */
-export interface MatchCategory {
+export type MatchCategory = {
     group: string | null;
     type: string | null;
-}
+};
 /**
  * One colour-palette match.
  *
@@ -23,7 +23,7 @@ export interface MatchCategory {
  * colour"), never as a stated colour specification. `hex` itself may be the
  * manufacturer's published colour — read `sourceBasis` before repeating it.
  */
-export interface ByColourMatch {
+export type ByColourMatch = {
     /** Opaque — round-trip verbatim. */
     variantId: VariantId;
     brand: string;
@@ -78,17 +78,17 @@ export interface ByColourMatch {
      * manufacturer.
      */
     palette?: ByColourSwatch[];
-}
+};
 /** A {@link PaletteSwatch} on the colour lane, where `oklab` is always derived. */
-export interface ByColourSwatch extends PaletteSwatch {
+export type ByColourSwatch = {
     /** `hex` in OKLab — guaranteed present on this surface. */
     oklab: OklabTriple;
-}
+} & PaletteSwatch;
 /**
  * Receipt for the `family` filter — ABSENT when none was asked for, so absence
  * means "no gate ran", never "a gate that dropped nothing".
  */
-export interface ColourFamilyGate {
+export type ColourFamilyGate = {
     /** The colorscope taxonomy family id the gate kept (normalised). */
     family: string;
     /** Candidates the gate examined — the retrieved pool. NOT a corpus total. */
@@ -108,30 +108,30 @@ export interface ColourFamilyGate {
      * boundary.
      */
     droppedOnPublishedHex?: number;
-}
+};
 /** Receipt for the hard category gate and its treatment of unknown typing. */
-export interface ColourCategoryGate {
+export type ColourCategoryGate = {
     /** Category names or keys the caller asked the gate to keep. */
     requested: string[];
     /** Only accepted primary product types can establish membership. */
     requiresAcceptedPrimaryProductType: true;
     /** Unknown/unclassified variants were ineligible, not proven non-members. */
     unclassifiedVariantsExcluded: true;
-}
+};
 /**
  * Receipt for the colour-identity collapse that turns a variant-grain ranking
  * into a page of TILES — one per (brand, product, dominant hex), one per stored
  * photograph. The live endpoint always sends it; it is optional here only so
  * responses captured before the collapse existed still type-check.
  */
-export interface ColourCollapse {
+export type ColourCollapse = {
     /** Ranked rows the collapse examined — this page's pool, never a corpus total. */
     considered: number;
     /** Rows dropped for repeating a better-ranked row's brand, product and hex. */
     droppedByIdentity: number;
     /** Rows dropped for resolving to a better-ranked row's stored photograph. */
     droppedBySharedImage: number;
-}
+};
 /**
  * Receipt naming which retrieval lane answered, and the colours it actually ran
  * on. The live endpoint always sends it.
@@ -144,7 +144,7 @@ export interface ColourCollapse {
  * different geometries, so `colourDistance` on a match means a different thing
  * in each and is NOT comparable across them.
  */
-export interface ColourLaneReceipt {
+export type ColourLaneReceipt = {
     /** Which lane answered. Widened so a new server lane still type-checks. */
     lane: OpenEnum<"containment" | "palette">;
     /** Why this lane, in one sentence, for a human reader. */
@@ -169,9 +169,9 @@ export interface ColourLaneReceipt {
      * result is not evidence that nothing holds them.
      */
     droppedColours: string[];
-}
+};
 /** The `search/colours` response. */
-export interface ByColourResponse {
+export type ByColourResponse = {
     query: {
         /** Raw query provenance, when supplied. */
         q?: string;
@@ -234,9 +234,9 @@ export interface ByColourResponse {
     corpusScope?: CorpusScopeReceipt;
     /** Shared standard-search query-understanding receipt. */
     understanding?: QueryUnderstanding;
-}
+};
 /** Params for `search/colours`. */
-export interface ByColourParams {
+export type ByColourParams = {
     /** Raw material-domain query provenance for shared query understanding. */
     q?: string;
     /** A single hex (with or without `#`). */
@@ -290,4 +290,4 @@ export interface ByColourParams {
     /** Narrow retrieval inside the server query; absent means the whole graph. */
     corpusScope?: CorpusScope;
     limit?: number;
-}
+};

package/by-spec-types.d.ts

@@ -8,11 +8,11 @@ import type { VariantId } from "./identifiers.js";
  * — quote them wherever the value is quoted. A `null` on either means the trust
  * is unrecorded, which is weaker than a low number, not stronger.
  */
-export interface BySpecMatchedCell {
+export type BySpecMatchedCell = {
     attributeId: string;
     confidence: number | null;
     sourceBasis: string | null;
-}
+};
 /**
  * The six states a verdict cell can report — and what each licenses you to say.
  *
@@ -36,7 +36,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 interface BySpecVerdictCell {
+export type BySpecVerdictCell = {
     attributeId: string;
     state: BySpecVerdictState;
     strength: "required" | "preferred";
@@ -73,7 +73,7 @@ export interface BySpecVerdictCell {
      */
     trustGap: "below_confidence" | "basis_unmet" | "proposed" | null;
     citation?: VerdictCitation;
-}
+};
 /**
  * A match's full report card: every cell, the rolled-up grade, weakest confidence.
  *
@@ -86,18 +86,18 @@ export interface BySpecVerdictCell {
  * `minConfidence` is the WEAKEST cell's confidence — the honest ceiling on the
  * whole card, not an average. Quote it alongside the grade.
  */
-export interface BySpecVerdict {
+export type 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
  * so search-surface code can name it for what it is rather than duplicating it.
  */
 export type MaterialVerdict = BySpecVerdict;
-export interface BySpecMatch {
+export type BySpecMatch = {
     /** Opaque — round-trip verbatim. */
     variantId: VariantId;
     brand: string;
@@ -109,7 +109,7 @@ export interface BySpecMatch {
     matched: BySpecMatchedCell[];
     minConfidence: number | null;
     verdict: BySpecVerdict;
-}
+};
 /**
  * One criterion the server could not resolve to canonical vocabulary, with the
  * resolver's ranked suggestions for it.
@@ -128,7 +128,7 @@ export interface BySpecMatch {
  * EVERY miss is reported, not just the first, so one round trip is enough to fix
  * a whole spec.
  */
-export interface BySpecUnresolvedCriterion {
+export type 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. */
@@ -137,7 +137,7 @@ export interface BySpecUnresolvedCriterion {
     reason?: "unknown_attribute_or_term" | "not_a_specification";
     /** Ranked candidates for whichever half failed. See {@link ValueResolution}. */
     resolution: ValueResolution;
-}
+};
 /**
  * The find-by-spec envelope — A PAGE, AND NOTHING BUT A PAGE.
  *
@@ -151,12 +151,12 @@ export interface BySpecUnresolvedCriterion {
  * And check `unresolvedCriteria` BEFORE reading any of that: when it is present
  * the numbers beside it describe a query that never ran.
  */
-export interface BySpecResponse {
+export type BySpecResponse = {
     /** The criteria as parsed — check them before trusting a surprising result. */
-    criteria: Array<{
+    criteria: {
         attribute: string;
         value: string;
-    }>;
+    }[];
     /** `matches.length`, i.e. THIS SAMPLE under `limit`. Never a corpus total. */
     totalMatches: number;
     /** Distinct brands in the returned sample — a lower bound on cross-brand reach. */
@@ -178,4 +178,4 @@ export interface BySpecResponse {
      * every criterion resolved and the query did run.
      */
     unresolvedCriteria?: BySpecUnresolvedCriterion[];
-}
+};