@instruments/materialgraph 0.24.0 → 0.26.0

package/material-query-plan-types.d.ts

@@ -4,21 +4,21 @@ import type { ResolvedMeaning } from "./resolve-types.js";
 import type { SearchInput } from "./search-request-types.js";
 import type { OpenEnum } from "./types.js";
 export type MaterialQueryVocabularyKind = OpenEnum<"attribute" | "dictionary_term" | "inline_enum" | "product_type" | "product_type_group">;
-export interface MaterialQuerySpan {
+export type MaterialQuerySpan = {
     start: number;
     end: number;
     text: string;
-}
-export interface MaterialQueryOwner {
+};
+export type MaterialQueryOwner = {
     attributeId: string;
     attributeName: string;
-}
-export interface MaterialQueryLifecycle {
+};
+export type MaterialQueryLifecycle = {
     status: string;
     introducedIn?: string;
     deprecatedIn?: string;
     supersededBy?: string;
-}
+};
 export type MaterialQueryOntologyContext = {
     description: string;
     valueKind: string;
@@ -26,10 +26,10 @@ export type MaterialQueryOntologyContext = {
 } | {
     dictionaryId: string;
     dictionaryName: string;
-    owningAttributes: Array<{
+    owningAttributes: {
         id: string;
         name: string;
-    }>;
+    }[];
     lifecycle: MaterialQueryLifecycle;
 } | {
     attributeId: string;
@@ -41,23 +41,23 @@ export type MaterialQueryOntologyContext = {
 } | {
     description: string;
 };
-export interface MaterialQueryApplicability {
+export type MaterialQueryApplicability = {
     status: OpenEnum<"all" | "some" | "none" | "unknown">;
     categoryId?: string;
     productTypeIds: string[];
     applicableProductTypeIds: string[];
-}
-export interface MaterialQueryCoverage {
+};
+export type MaterialQueryCoverage = {
     variants: number;
     basis: OpenEnum<"facet_index">;
     scope: OpenEnum<"corpus">;
-}
-export interface MaterialQueryReachability {
+};
+export type MaterialQueryReachability = {
     status: OpenEnum<"positive" | "zero" | "unknown">;
     categoryId: string;
     basis: OpenEnum<"bounded_probe" | "unmeasured">;
-}
-export interface MaterialQueryCandidate {
+};
+export type MaterialQueryCandidate = {
     kind: MaterialQueryVocabularyKind;
     subjectType: MaterialQueryVocabularyKind;
     subjectId: string;
@@ -76,8 +76,8 @@ export interface MaterialQueryCandidate {
     coverage?: MaterialQueryCoverage;
     reachability?: MaterialQueryReachability;
     reason?: string;
-}
-export interface MaterialQueryCriterion {
+};
+export type MaterialQueryCriterion = {
     source: {
         subjectType: MaterialQueryVocabularyKind;
         subjectId: string;
@@ -95,7 +95,7 @@ export interface MaterialQueryCriterion {
     coverage: MaterialQueryCoverage;
     applicability: MaterialQueryApplicability;
     reachability?: MaterialQueryReachability;
-}
+};
 export type MaterialQueryStandardMeaning = ResolvedMeaning | QuerySense;
 export type MaterialQueryAmbiguityAlternative = (MaterialQueryOwner & {
     kind: OpenEnum<"owner">;
@@ -108,7 +108,7 @@ export type MaterialQueryAmbiguityAlternative = (MaterialQueryOwner & {
     kind: OpenEnum<"standard_meaning">;
     meaning: MaterialQueryStandardMeaning;
 };
-export interface MaterialQueryPlan {
+export type MaterialQueryPlan = {
     version: OpenEnum<"1">;
     verdict: OpenEnum<"executable" | "partial" | "refused">;
     rawQuery: string;
@@ -135,20 +135,20 @@ export interface MaterialQueryPlan {
         undertone?: string;
     } | null;
     residualText: string;
-    unspentSpans: Array<MaterialQuerySpan & {
+    unspentSpans: (MaterialQuerySpan & {
         reason: OpenEnum<"residual" | "ambiguous" | "refused">;
-    }>;
-    ambiguities: Array<{
+    })[];
+    ambiguities: {
         subjectType: MaterialQueryVocabularyKind;
         subjectId: string;
         span: MaterialQuerySpan;
         reason: string;
         alternatives: MaterialQueryAmbiguityAlternative[];
-    }>;
-    standardMeanings: Array<{
+    }[];
+    standardMeanings: {
         span: MaterialQuerySpan;
         meanings: MaterialQueryStandardMeaning[];
-    }>;
+    }[];
     /** Complete ordinary-search requests authored by MaterialGraph. Execute verbatim. */
     requests: SearchInput[];
-}
+};

package/material-resources-client.d.ts

@@ -1,18 +1,18 @@
 /** Material blocks, safe assets, and technical documents over one shared transport. */
-import { HttpTransport } from "./http-transport.js";
+import type { HttpTransport } from "./http-transport.js";
 import type { VariantId } from "./identifiers.js";
 import type { MaterialAssetProjection, MaterialDocumentPage, MaterialDocumentPageOptions } from "./material-asset-types.js";
 import type { MaterialBlockProjection } from "./material-block-types.js";
 import type { MaterialRenderAssets } from "./render-assets-types.js";
 /** Read known and explicitly unobserved canonical material fields. */
-export declare function materialBlocks(transport: HttpTransport, variantId: VariantId, signal?: AbortSignal): Promise<MaterialBlockProjection>;
+export declare const materialBlocks: (transport: HttpTransport, variantId: VariantId, signal?: AbortSignal) => Promise<MaterialBlockProjection>;
 /** Read only redistribution-safe images and downloads for a material. */
-export declare function materialAssets(transport: HttpTransport, variantId: VariantId, signal?: AbortSignal): Promise<MaterialAssetProjection>;
+export declare const materialAssets: (transport: HttpTransport, variantId: VariantId, signal?: AbortSignal) => Promise<MaterialAssetProjection>;
 /** Read the accepted render-ready appearance projection, or an explicit unavailable reason. */
-export declare function materialRenderAssets(transport: HttpTransport, variantId: VariantId, signal?: AbortSignal): Promise<MaterialRenderAssets>;
+export declare const materialRenderAssets: (transport: HttpTransport, variantId: VariantId, signal?: AbortSignal) => Promise<MaterialRenderAssets>;
 /**
  * Read the owning Product's URL-deduplicated document page. Variant declarations
  * retain exact attribution; consumers inspect `appliesToRequestedVariant`
  * before presenting a sibling Variant declaration as applicable.
  */
-export declare function materialDocuments(transport: HttpTransport, variantId: VariantId, options?: MaterialDocumentPageOptions, signal?: AbortSignal): Promise<MaterialDocumentPage>;
+export declare const materialDocuments: (transport: HttpTransport, variantId: VariantId, options?: MaterialDocumentPageOptions, signal?: AbortSignal) => Promise<MaterialDocumentPage>;

package/material-resources-client.js

@@ -1,29 +1,19 @@
-/** Material blocks, safe assets, and technical documents over one shared transport. */
-import { HttpTransport } from "./http-transport.js";
 import { resolveOperation } from "./operations.js";
 /** Read known and explicitly unobserved canonical material fields. */
-export function materialBlocks(transport, variantId, signal) {
-    return transport.requestJson(resolveOperation("list_material_blocks"), { signal, pathParams: { variantId } });
-}
+export const materialBlocks = async (transport, variantId, signal) => await transport.requestJson(resolveOperation("list_material_blocks"), { pathParams: { variantId }, signal });
 /** Read only redistribution-safe images and downloads for a material. */
-export function materialAssets(transport, variantId, signal) {
-    return transport.requestJson(resolveOperation("list_material_assets"), { signal, pathParams: { variantId } });
-}
+export const materialAssets = async (transport, variantId, signal) => await transport.requestJson(resolveOperation("list_material_assets"), { pathParams: { variantId }, signal });
 /** Read the accepted render-ready appearance projection, or an explicit unavailable reason. */
-export function materialRenderAssets(transport, variantId, signal) {
-    return transport.requestJson(resolveOperation("get_material_render_assets"), { signal, pathParams: { variantId } });
-}
+export const materialRenderAssets = async (transport, variantId, signal) => await transport.requestJson(resolveOperation("get_material_render_assets"), { pathParams: { variantId }, signal });
 /**
  * Read the owning Product's URL-deduplicated document page. Variant declarations
  * retain exact attribution; consumers inspect `appliesToRequestedVariant`
  * before presenting a sibling Variant declaration as applicable.
  */
-export function materialDocuments(transport, variantId, options, signal) {
-    return transport.requestJson(resolveOperation("list_material_documents"), {
-        query: options
-            ? { cursor: options.cursor, limit: options.limit }
-            : undefined,
-        signal,
-        pathParams: { variantId },
-    });
-}
+export const materialDocuments = async (transport, variantId, options, signal) => await transport.requestJson(resolveOperation("list_material_documents"), {
+    pathParams: { variantId },
+    query: options
+        ? { cursor: options.cursor, limit: options.limit }
+        : undefined,
+    signal,
+});

package/material-types.d.ts

@@ -41,7 +41,7 @@ export type MaterialAvailability = OpenEnum<"available" | "discontinued" | "supe
  * successor that has itself been superseded reports `discontinued`/`unknown`
  * here; follow `variantId` for the next link in the chain.
  */
-export interface MaterialSuccessor {
+export type MaterialSuccessor = {
     /** Opaque — round-trip verbatim to read the successor. */
     variantId: VariantId;
     brandSlug: string;
@@ -51,12 +51,12 @@ export interface MaterialSuccessor {
     variant: string;
     color: string | null;
     availability: MaterialAvailability;
-}
+};
 /**
  * The grid-card projection of a material. Tiles carry `availability` but not the
  * successor record — read the detail projection for that.
  */
-export interface MaterialTile {
+export type MaterialTile = {
     /** Accepted sampleability fact. Absent means unknown, never false. */
     sampleable?: boolean;
     /** Opaque — round-trip verbatim into every other material read. */
@@ -77,7 +77,7 @@ export interface MaterialTile {
      * the attribute is absent — never render a missing key as "unnamed".
      */
     colourName?: string;
-}
+};
 /**
  * A sibling card: the tile, plus — when another variant of the same product
  * shares both its `variantName` and its `colourName` — the one attribute that
@@ -86,11 +86,11 @@ export interface MaterialTile {
  * code. The two fields arrive together or not at all; absent means nothing
  * collides, or neither attribute separates every look-alike.
  */
-export interface SiblingTile extends MaterialTile {
+export type SiblingTile = {
     distinguishedBy?: OpenEnum<"size" | "code">;
     /** This sibling's value of `distinguishedBy`, e.g. `"3.5 in"`. */
     distinction?: string;
-}
+} & MaterialTile;
 /**
  * A canonical attribute/term pair carried on a detail record.
  *
@@ -99,7 +99,7 @@ export interface SiblingTile extends MaterialTile {
  * `specificationFacets()` and `attributeValues()`. An attribute absent from
  * `facets` is unrecorded, never known-false.
  */
-export interface MaterialFacet {
+export type MaterialFacet = {
     attributeId: string;
     term: string;
     /**
@@ -108,9 +108,9 @@ export interface MaterialFacet {
      * payloads. Only `specification` facets are valid inputs to `bySpec`.
      */
     role?: "identity" | "specification";
-}
+};
 /** A retained product-type proposal. It is review evidence, never a category. */
-export interface ProposedProductType {
+export type ProposedProductType = {
     id: string;
     displayName: string;
     confidence: number | null;
@@ -118,12 +118,12 @@ export interface ProposedProductType {
     sourceUrl: string | null;
     isPrimary: boolean;
     scope: "variant" | "product";
-}
+};
 /** Accepted display categories remain separate from this review-state receipt. */
-export interface ProductTypeReceipt {
+export type ProductTypeReceipt = {
     state: "accepted" | "proposed" | "unknown";
     proposedProductTypes: ProposedProductType[];
-}
+};
 /**
  * One dimensional configuration of a material. Numeric fields are millimetres
  * (mass in kilograms); string fields are the source's own descriptors. The

package/ndjson.js

@@ -32,8 +32,9 @@ export class NdjsonDecoder {
         const lines = [];
         for (;;) {
             const index = this.#buffer.indexOf("\n");
-            if (index === -1)
+            if (index === -1) {
                 break;
+            }
             lines.push(this.#buffer.slice(0, index));
             this.#buffer = this.#buffer.slice(index + 1);
         }
@@ -46,8 +47,9 @@ export class NdjsonDecoder {
      * raise, not this decoder's fragment to discard.
      */
     flush() {
-        if (this.#buffer.length === 0)
+        if (this.#buffer.length === 0) {
             return [];
+        }
         const remainder = this.#buffer;
         this.#buffer = "";
         return [remainder];
@@ -66,34 +68,40 @@ export async function* readNdjsonLines(body, signal) {
     const ndjson = new NdjsonDecoder();
     try {
         for (;;) {
-            if (signal?.aborted)
+            if (signal?.aborted) {
                 return;
+            }
             let result;
             try {
                 result = await reader.read();
             }
             catch (error) {
-                if (signal?.aborted)
+                if (signal?.aborted) {
                     return;
+                }
                 throw error;
             }
             if (result.done) {
                 // `decode()` with no argument flushes any dangling multi-byte sequence.
                 for (const line of ndjson.push(decoder.decode())) {
-                    if (line.trim().length > 0)
+                    if (line.trim().length > 0) {
                         yield line;
+                    }
                 }
                 for (const line of ndjson.flush()) {
-                    if (line.trim().length > 0)
+                    if (line.trim().length > 0) {
                         yield line;
+                    }
                 }
                 return;
             }
             for (const line of ndjson.push(decoder.decode(result.value, { stream: true }))) {
-                if (signal?.aborted)
+                if (signal?.aborted) {
                     return;
-                if (line.trim().length > 0)
+                }
+                if (line.trim().length > 0) {
                     yield line;
+                }
             }
         }
     }

package/operations.d.ts

@@ -1,5 +1,5 @@
 export declare const MATERIALGRAPH_API_VERSION = "0.7.0";
-declare const OPERATION_DEFINITIONS: readonly [readonly ["brandMostSampled", "GET", "/api/v1/brands/most-sampled", "brands.most_sampled"], readonly ["colours.complete", "POST", "/api/v1/colours/palettes/complete", "complete_interior_palette"], readonly ["colours.discover", "GET", "/api/v1/colours/palettes", "discover_interior_palettes"], readonly ["samplizeColorVecCache", "GET", "/api/v1/catalogues/samplize/colorvec", "samplize_colorvec_cache"], readonly ["samplizeCatalogueSearch", "POST", "/api/v1/catalogues/samplize/search", "samplize_catalogue_search"], readonly ["scheduleReferences.list", "GET", "/api/v1/schedules/{scheduleId}/references", "list_schedule_reference_feedback"], readonly ["scheduleReferences.put", "PUT", "/api/v1/schedules/{scheduleId}/references/{referenceId}", "put_schedule_reference_feedback"], readonly ["catalogs", "GET", "/api/v1/catalogs", "list_catalog_documents"], readonly ["catalogPages", "GET", "/api/v1/catalogs/{catalogId}/pages", "list_catalog_pages"], readonly ["catalogPageRepresentation", "GET", "/api/v1/catalog-pages/{pageId}/representation", "get_catalog_page_representation"], readonly ["catalogReferences", "GET", "/api/v1/catalogs/{catalogId}/references", "list_catalog_product_references"], readonly ["search", "POST", "/api/v1/search", "search_materials_post"], readonly ["identify", "POST", "/api/v1/identify", "retrieval.identify"], readonly ["compare", "POST", "/api/v1/compare", "retrieval.compare"], readonly ["createCorrection", "POST", "/api/v1/corrections", "corrections.create"], readonly ["getCorrection", "GET", "/api/v1/corrections/{correctionId}", "corrections.get"], readonly ["listCorrections", "GET", "/api/v1/corrections", "corrections.list"], readonly ["planQuery", "POST", "/api/v1/search/plan", "plan_material_query"], readonly ["samplizeCatalogue", "GET", "/api/v1/catalogues/samplize/products", "samplize_catalogue_products"], readonly ["searchGet", "GET", "/api/v1/search", "search_materials_get"], readonly ["match", "POST", "/api/v1/search/match", "match_material"], readonly ["rejectMatchResult", "POST", "/api/v1/search/match/{responseId}/rejections", "reject_match_result"], readonly ["matchRejections", "GET", "/api/v1/search/match/{responseId}/rejections", "list_match_rejections"], readonly ["byColour", "GET", "/api/v1/search/colours", "search_by_colour"], readonly ["material", "GET", "/api/v1/materials/{variantId}", "get_material"], readonly ["catalogueReferences", "POST", "/api/v1/catalogues/references", "get_catalogue_references_batch"], readonly ["catalogueCollections", "GET", "/api/v1/catalogues/collections", "list_catalogue_channel_collections"], readonly ["catalogueDocumentAccess", "GET", "/api/v1/catalogues/documents/{documentId}", "get_catalogue_document_access"], readonly ["siblings", "GET", "/api/v1/materials/{variantId}/siblings", "get_material_siblings"], readonly ["materialBlocks", "GET", "/api/v1/materials/{variantId}/blocks", "list_material_blocks"], readonly ["materialAssets", "GET", "/api/v1/materials/{variantId}/assets", "list_material_assets"], readonly ["materialRenderAssets", "GET", "/api/v1/materials/{variantId}/render-assets", "get_material_render_assets"], readonly ["materialDocuments", "GET", "/api/v1/materials/{variantId}/documents", "list_material_documents"], readonly ["exploration.operators", "GET", "/api/v1/materials/{variantId}/operators", "list_material_operators"], readonly ["exploration.candidates", "POST", "/api/v1/materials/{variantId}/candidates", "read_material_candidates"], readonly ["schema", "GET", "/api/v1/schema/blocks", "list_schema_blocks"], readonly ["schema", "GET", "/api/v1/schema/attributes", "list_schema_attributes"], readonly ["schema", "GET", "/api/v1/schema/verticals", "list_schema_verticals"], readonly ["schema", "GET", "/api/v1/schema/product-types", "list_schema_product_types"], readonly ["schema", "GET", "/api/v1/schema/units", "list_schema_units"], readonly ["schema", "GET", "/api/v1/schema/value-dictionaries", "list_schema_value_dictionaries"], readonly ["schema", "GET", "/api/v1/schema/source-requirements", "list_schema_source_requirements"], readonly ["schema", "GET", "/api/v1/schema/product-type-templates", "list_schema_product_type_templates"], readonly ["schema", "GET", "/api/v1/schema/mappings", "list_schema_mappings"], readonly ["pairings", "GET", "/api/v1/materials/{variantId}/pairings", "get_material_pairings"], readonly ["findSubstitutes", "POST", "/api/v1/materials/{variantId}/substitutes", "find_material_substitutes"], readonly ["associatedFinishes", "GET", "/api/v1/associated/finishes", "list_associated_finishes"], readonly ["associatedProducts", "GET", "/api/v1/associated/products", "list_associated_products"], readonly ["applicability", "GET", "/api/v1/applicability", "get_applicability"], readonly ["materials", "POST", "/api/v1/materials/batch", "get_materials_batch_post"], readonly ["materialsCached", "GET", "/api/v1/materials/batch", "get_materials_batch_get"], readonly ["browse", "GET", "/api/v1/search/browse", "search_browse_by_colour"], readonly ["colourFacets", "GET", "/api/v1/colours/facets", "get_colour_facets"], readonly ["colours.profiles", "GET", "/api/v1/colours/profiles", "get_category_colour_profiles"], readonly ["colours.stats", "GET", "/api/v1/colours/stats", "get_colour_stats"], readonly ["resolveColour", "GET", "/api/v1/search/colours/resolve", "resolve_colour_name"], readonly ["suggestColour", "GET", "/api/v1/search/colours/suggest", "suggest_colour_names"], readonly ["suggest", "GET", "/api/v1/search/suggest", "search_suggest"], readonly ["resolveAttribute", "GET", "/api/v1/catalog/attributes/resolve", "catalog_resolve_attribute"], readonly ["resolveAttributeValue", "GET", "/api/v1/catalog/attributes/{attributeId}/values/resolve", "catalog_resolve_value"], readonly ["searchVocabulary", "GET", "/api/v1/catalog/vocabulary/search", "catalog_vocabulary_search"], readonly ["resolve", "POST", "/api/v1/resolve", "resolve_phrases"], readonly ["bySpec", "GET", "/api/v1/search/specifications", "catalog_by_spec"], readonly ["taxonomy", "GET", "/api/v1/taxonomy/categories", "get_category_taxonomy"], readonly ["productTypeCoverage", "GET", "/api/v1/taxonomy/coverage", "get_product_type_status_coverage"], readonly ["whoami", "GET", "/api/v1/whoami", "whoami"], readonly ["coordinate", "POST", "/api/v1/pairings/coordinate", "coordinate_materials"], readonly ["demand", "GET", "/api/v1/demand", "get_material_demand"], readonly ["colours.palette", "POST", "/api/v1/search/palettes", "search_by_palette"], readonly ["extractPalette", "POST", "/api/v1/search/palettes/extract", "extract_image_palette"], readonly ["colours.gradient", "POST", "/api/v1/search/gradients", "search_by_gradient"], readonly ["specificationFacets", "GET", "/api/v1/catalog/specifications/facets", "list_spec_facets"], readonly ["attributeValues", "GET", "/api/v1/catalog/attributes/{attributeId}/values", "list_attribute_values"], readonly ["applicableSpecs", "GET", "/api/v1/taxonomy/categories/{key}/specs", "get_applicable_specs"], readonly ["glossary", "GET", "/api/v1/glossary/{term}", "explain_material_term"], readonly ["brands", "GET", "/api/v1/brands", "list_brands"], readonly ["brand", "GET", "/api/v1/brands/{brandSlug}", "get_brand_profile"], readonly ["brandColourDeck", "GET", "/api/v1/brands/{brandSlug}/colours", "brand_colour_deck"], readonly ["uploadSourceMaterial", "POST", "/api/v1/source-material", "upload_source_material"], readonly ["sourceMaterialBatch", "GET", "/api/v1/source-material/{batchId}", "get_source_material_batch"], readonly ["sourceMaterialComments.list", "GET", "/api/v1/source-material/{batchId}/sources/{sourceId}/comments", "list_source_material_comments"], readonly ["sourceMaterialComments.post", "POST", "/api/v1/source-material/{batchId}/sources/{sourceId}/comments", "post_source_material_comment"], readonly ["capabilities", "GET", "/api/v1/capabilities", "list_public_capabilities"], readonly ["createRun", "POST", "/api/v1/runs", "create_public_run"], readonly ["listRuns", "GET", "/api/v1/runs", "list_public_runs"], readonly ["run", "GET", "/api/v1/runs/{runId}", "get_public_run"], readonly ["runSchedule", "GET", "/api/v1/runs/{runId}/schedule", "get_run_finish_schedule"], readonly ["citation", "GET", "/api/v1/citations/{citationId}", "get_verdict_citation"], readonly ["streamRunEvents", "GET", "/api/v1/runs/{runId}/events", "list_public_run_events"], readonly ["resumeRun", "POST", "/api/v1/runs/{runId}/resume", "resume_public_run"], readonly ["cancelRun", "POST", "/api/v1/runs/{runId}/cancel", "cancel_public_run"], readonly ["varyScheme", "POST", "/api/v1/schemes/vary", "vary_schemes"], readonly ["slotPools", "POST", "/api/v1/schemes/pools", "slot_pools"], readonly ["createProject", "POST", "/api/v1/projects", "create_box_project"], readonly ["listProjects", "GET", "/api/v1/projects", "list_box_projects"], readonly ["getProject", "GET", "/api/v1/projects/{projectId}", "get_box_project"], readonly ["appendProjectEvent", "POST", "/api/v1/projects/{projectId}/events", "append_box_project_event"], readonly ["demandBatch", "POST", "/api/v1/demand/batch", "get_demand_batch"], readonly ["codeAdvisory", "POST", "/api/v1/codes/advisory", "resolveCodeAdvisory"], readonly ["codes.context", "GET", "/api/v1/codes/context", "list_code_context"], readonly ["codes.requirements", "GET", "/api/v1/codes/requirements", "list_code_requirements"]];
+declare const OPERATION_DEFINITIONS: readonly [readonly ["brandMostSampled", "GET", "/api/v1/brands/most-sampled", "brands.most_sampled"], readonly ["colours.complete", "POST", "/api/v1/colours/palettes/complete", "complete_interior_palette"], readonly ["colours.discover", "GET", "/api/v1/colours/palettes", "discover_interior_palettes"], readonly ["samplizeColorVecCache", "GET", "/api/v1/catalogues/samplize/colorvec", "samplize_colorvec_cache"], readonly ["samplizeCatalogueSearch", "POST", "/api/v1/catalogues/samplize/search", "samplize_catalogue_search"], readonly ["catalogs", "GET", "/api/v1/catalogs", "list_catalog_documents"], readonly ["catalogPages", "GET", "/api/v1/catalogs/{catalogId}/pages", "list_catalog_pages"], readonly ["catalogPageRepresentation", "GET", "/api/v1/catalog-pages/{pageId}/representation", "get_catalog_page_representation"], readonly ["catalogReferences", "GET", "/api/v1/catalogs/{catalogId}/references", "list_catalog_product_references"], readonly ["search", "POST", "/api/v1/search", "search_materials_post"], readonly ["identify", "POST", "/api/v1/identify", "retrieval.identify"], readonly ["compare", "POST", "/api/v1/compare", "retrieval.compare"], readonly ["createCorrection", "POST", "/api/v1/corrections", "corrections.create"], readonly ["getCorrection", "GET", "/api/v1/corrections/{correctionId}", "corrections.get"], readonly ["listCorrections", "GET", "/api/v1/corrections", "corrections.list"], readonly ["planQuery", "POST", "/api/v1/search/plan", "plan_material_query"], readonly ["samplizeCatalogue", "GET", "/api/v1/catalogues/samplize/products", "samplize_catalogue_products"], readonly ["searchGet", "GET", "/api/v1/search", "search_materials_get"], readonly ["match", "POST", "/api/v1/search/match", "match_material"], readonly ["rejectMatchResult", "POST", "/api/v1/search/match/{responseId}/rejections", "reject_match_result"], readonly ["matchRejections", "GET", "/api/v1/search/match/{responseId}/rejections", "list_match_rejections"], readonly ["byColour", "GET", "/api/v1/search/colours", "search_by_colour"], readonly ["material", "GET", "/api/v1/materials/{variantId}", "get_material"], readonly ["catalogueReferences", "POST", "/api/v1/catalogues/references", "get_catalogue_references_batch"], readonly ["catalogueCollections", "GET", "/api/v1/catalogues/collections", "list_catalogue_channel_collections"], readonly ["catalogueDocumentAccess", "GET", "/api/v1/catalogues/documents/{documentId}", "get_catalogue_document_access"], readonly ["siblings", "GET", "/api/v1/materials/{variantId}/siblings", "get_material_siblings"], readonly ["materialBlocks", "GET", "/api/v1/materials/{variantId}/blocks", "list_material_blocks"], readonly ["materialAssets", "GET", "/api/v1/materials/{variantId}/assets", "list_material_assets"], readonly ["materialRenderAssets", "GET", "/api/v1/materials/{variantId}/render-assets", "get_material_render_assets"], readonly ["materialDocuments", "GET", "/api/v1/materials/{variantId}/documents", "list_material_documents"], readonly ["exploration.operators", "GET", "/api/v1/materials/{variantId}/operators", "list_material_operators"], readonly ["exploration.candidates", "POST", "/api/v1/materials/{variantId}/candidates", "read_material_candidates"], readonly ["schema", "GET", "/api/v1/schema/blocks", "list_schema_blocks"], readonly ["schema", "GET", "/api/v1/schema/attributes", "list_schema_attributes"], readonly ["schema", "GET", "/api/v1/schema/verticals", "list_schema_verticals"], readonly ["schema", "GET", "/api/v1/schema/product-types", "list_schema_product_types"], readonly ["schema", "GET", "/api/v1/schema/units", "list_schema_units"], readonly ["schema", "GET", "/api/v1/schema/value-dictionaries", "list_schema_value_dictionaries"], readonly ["schema", "GET", "/api/v1/schema/source-requirements", "list_schema_source_requirements"], readonly ["schema", "GET", "/api/v1/schema/product-type-templates", "list_schema_product_type_templates"], readonly ["schema", "GET", "/api/v1/schema/mappings", "list_schema_mappings"], readonly ["pairings", "GET", "/api/v1/materials/{variantId}/pairings", "get_material_pairings"], readonly ["findSubstitutes", "POST", "/api/v1/materials/{variantId}/substitutes", "find_material_substitutes"], readonly ["associatedFinishes", "GET", "/api/v1/associated/finishes", "list_associated_finishes"], readonly ["associatedProducts", "GET", "/api/v1/associated/products", "list_associated_products"], readonly ["applicability", "GET", "/api/v1/applicability", "get_applicability"], readonly ["materials", "POST", "/api/v1/materials/batch", "get_materials_batch_post"], readonly ["materialsCached", "GET", "/api/v1/materials/batch", "get_materials_batch_get"], readonly ["browse", "GET", "/api/v1/search/browse", "search_browse_by_colour"], readonly ["colourFacets", "GET", "/api/v1/colours/facets", "get_colour_facets"], readonly ["colours.profiles", "GET", "/api/v1/colours/profiles", "get_category_colour_profiles"], readonly ["colours.stats", "GET", "/api/v1/colours/stats", "get_colour_stats"], readonly ["resolveColour", "GET", "/api/v1/search/colours/resolve", "resolve_colour_name"], readonly ["suggestColour", "GET", "/api/v1/search/colours/suggest", "suggest_colour_names"], readonly ["suggest", "GET", "/api/v1/search/suggest", "search_suggest"], readonly ["resolveAttribute", "GET", "/api/v1/catalog/attributes/resolve", "catalog_resolve_attribute"], readonly ["resolveAttributeValue", "GET", "/api/v1/catalog/attributes/{attributeId}/values/resolve", "catalog_resolve_value"], readonly ["searchVocabulary", "GET", "/api/v1/catalog/vocabulary/search", "catalog_vocabulary_search"], readonly ["resolve", "POST", "/api/v1/resolve", "resolve_phrases"], readonly ["bySpec", "GET", "/api/v1/search/specifications", "catalog_by_spec"], readonly ["taxonomy", "GET", "/api/v1/taxonomy/categories", "get_category_taxonomy"], readonly ["productTypeCoverage", "GET", "/api/v1/taxonomy/coverage", "get_product_type_status_coverage"], readonly ["whoami", "GET", "/api/v1/whoami", "whoami"], readonly ["coordinate", "POST", "/api/v1/pairings/coordinate", "coordinate_materials"], readonly ["demand", "GET", "/api/v1/demand", "get_material_demand"], readonly ["colours.palette", "POST", "/api/v1/search/palettes", "search_by_palette"], readonly ["extractPalette", "POST", "/api/v1/search/palettes/extract", "extract_image_palette"], readonly ["colours.gradient", "POST", "/api/v1/search/gradients", "search_by_gradient"], readonly ["specificationFacets", "GET", "/api/v1/catalog/specifications/facets", "list_spec_facets"], readonly ["attributeValues", "GET", "/api/v1/catalog/attributes/{attributeId}/values", "list_attribute_values"], readonly ["applicableSpecs", "GET", "/api/v1/taxonomy/categories/{key}/specs", "get_applicable_specs"], readonly ["glossary", "GET", "/api/v1/glossary/{term}", "explain_material_term"], readonly ["brands", "GET", "/api/v1/brands", "list_brands"], readonly ["brand", "GET", "/api/v1/brands/{brandSlug}", "get_brand_profile"], readonly ["brandColourDeck", "GET", "/api/v1/brands/{brandSlug}/colours", "brand_colour_deck"], readonly ["uploadSourceMaterial", "POST", "/api/v1/source-material", "upload_source_material"], readonly ["sourceMaterialBatch", "GET", "/api/v1/source-material/{batchId}", "get_source_material_batch"], readonly ["sourceMaterialComments.list", "GET", "/api/v1/source-material/{batchId}/sources/{sourceId}/comments", "list_source_material_comments"], readonly ["sourceMaterialComments.post", "POST", "/api/v1/source-material/{batchId}/sources/{sourceId}/comments", "post_source_material_comment"], readonly ["capabilities", "GET", "/api/v1/capabilities", "list_public_capabilities"], readonly ["createRun", "POST", "/api/v1/runs", "create_public_run"], readonly ["listRuns", "GET", "/api/v1/runs", "list_public_runs"], readonly ["run", "GET", "/api/v1/runs/{runId}", "get_public_run"], readonly ["citation", "GET", "/api/v1/citations/{citationId}", "get_verdict_citation"], readonly ["streamRunEvents", "GET", "/api/v1/runs/{runId}/events", "list_public_run_events"], readonly ["resumeRun", "POST", "/api/v1/runs/{runId}/resume", "resume_public_run"], readonly ["cancelRun", "POST", "/api/v1/runs/{runId}/cancel", "cancel_public_run"], readonly ["varyScheme", "POST", "/api/v1/schemes/vary", "vary_schemes"], readonly ["slotPools", "POST", "/api/v1/schemes/pools", "slot_pools"], readonly ["demandBatch", "POST", "/api/v1/demand/batch", "get_demand_batch"], readonly ["codeAdvisory", "POST", "/api/v1/codes/advisory", "resolveCodeAdvisory"], readonly ["codes.context", "GET", "/api/v1/codes/context", "list_code_context"], readonly ["codes.requirements", "GET", "/api/v1/codes/requirements", "list_code_requirements"]];
 export type SdkOperationId = (typeof OPERATION_DEFINITIONS)[number][3];
 export type SdkOperation = Readonly<{
     clientMethod: (typeof OPERATION_DEFINITIONS)[number][0];
@@ -9,13 +9,13 @@ export type SdkOperation = Readonly<{
 }>;
 export declare const SDK_OPERATIONS: readonly SdkOperation[];
 /** Look up a registered operation by its OpenAPI `operationId`. */
-export declare function findSdkOperation(operationId: SdkOperationId): SdkOperation | undefined;
+export declare const findSdkOperation: (operationId: SdkOperationId) => SdkOperation | undefined;
 /**
  * Look up a registered operation, or throw. The lookup every caller that holds
- * a literal `operationId` wants — lived as a private copy in `client.ts` and
- * `projects.ts` before the association lens would have made it a third.
+ * a literal `operationId` wants — lived as a private copy in `client.ts`
+ * before the association lens would have made it a second.
  */
-export declare function resolveOperation(operationId: SdkOperationId): SdkOperation;
+export declare const resolveOperation: (operationId: SdkOperationId) => SdkOperation;
 /** Substitute `{param}` path placeholders with percent-encoded values. */
-export declare function operationPath(sdkOperation: SdkOperation, pathParams?: Readonly<Record<string, string>>): string;
+export declare const operationPath: (sdkOperation: SdkOperation, pathParams?: Readonly<Record<string, string>>) => string;
 export {};

package/operations.js

@@ -31,18 +31,6 @@ const OPERATION_DEFINITIONS = [
         "/api/v1/catalogues/samplize/search",
         "samplize_catalogue_search",
     ],
-    [
-        "scheduleReferences.list",
-        "GET",
-        "/api/v1/schedules/{scheduleId}/references",
-        "list_schedule_reference_feedback",
-    ],
-    [
-        "scheduleReferences.put",
-        "PUT",
-        "/api/v1/schedules/{scheduleId}/references/{referenceId}",
-        "put_schedule_reference_feedback",
-    ],
     ["catalogs", "GET", "/api/v1/catalogs", "list_catalog_documents"],
     [
         "catalogPages",
@@ -337,12 +325,6 @@ const OPERATION_DEFINITIONS = [
     ["createRun", "POST", "/api/v1/runs", "create_public_run"],
     ["listRuns", "GET", "/api/v1/runs", "list_public_runs"],
     ["run", "GET", "/api/v1/runs/{runId}", "get_public_run"],
-    [
-        "runSchedule",
-        "GET",
-        "/api/v1/runs/{runId}/schedule",
-        "get_run_finish_schedule",
-    ],
     ["citation", "GET", "/api/v1/citations/{citationId}", "get_verdict_citation"],
     [
         "streamRunEvents",
@@ -354,15 +336,6 @@ const OPERATION_DEFINITIONS = [
     ["cancelRun", "POST", "/api/v1/runs/{runId}/cancel", "cancel_public_run"],
     ["varyScheme", "POST", "/api/v1/schemes/vary", "vary_schemes"],
     ["slotPools", "POST", "/api/v1/schemes/pools", "slot_pools"],
-    ["createProject", "POST", "/api/v1/projects", "create_box_project"],
-    ["listProjects", "GET", "/api/v1/projects", "list_box_projects"],
-    ["getProject", "GET", "/api/v1/projects/{projectId}", "get_box_project"],
-    [
-        "appendProjectEvent",
-        "POST",
-        "/api/v1/projects/{projectId}/events",
-        "append_box_project_event",
-    ],
     ["demandBatch", "POST", "/api/v1/demand/batch", "get_demand_batch"],
     ["codeAdvisory", "POST", "/api/v1/codes/advisory", "resolveCodeAdvisory"],
     ["codes.context", "GET", "/api/v1/codes/context", "list_code_context"],
@@ -373,23 +346,20 @@ const OPERATION_DEFINITIONS = [
         "list_code_requirements",
     ],
 ];
-export const SDK_OPERATIONS = Object.freeze(OPERATION_DEFINITIONS.map(([clientMethod, method, path, operationId]) => Object.freeze({ clientMethod, method, path, operationId })));
+export const SDK_OPERATIONS = Object.freeze(OPERATION_DEFINITIONS.map(([clientMethod, method, path, operationId]) => Object.freeze({ clientMethod, method, operationId, path })));
 /** Look up a registered operation by its OpenAPI `operationId`. */
-export function findSdkOperation(operationId) {
-    return SDK_OPERATIONS.find((candidate) => candidate.operationId === operationId);
-}
+export const findSdkOperation = (operationId) => SDK_OPERATIONS.find((candidate) => candidate.operationId === operationId);
 /**
  * Look up a registered operation, or throw. The lookup every caller that holds
- * a literal `operationId` wants — lived as a private copy in `client.ts` and
- * `projects.ts` before the association lens would have made it a third.
+ * a literal `operationId` wants — lived as a private copy in `client.ts`
+ * before the association lens would have made it a second.
  */
-export function resolveOperation(operationId) {
+export const resolveOperation = (operationId) => {
     const match = findSdkOperation(operationId);
-    if (!match)
+    if (!match) {
         throw MaterialGraphError.unexpected(`Unknown SDK operation: ${operationId}`);
+    }
     return match;
-}
+};
 /** Substitute `{param}` path placeholders with percent-encoded values. */
-export function operationPath(sdkOperation, pathParams = {}) {
-    return Object.entries(pathParams).reduce((path, [name, value]) => path.replace(`{${name}}`, encodeURIComponent(value)), sdkOperation.path);
-}
+export const operationPath = (sdkOperation, pathParams = {}) => Object.entries(pathParams).reduce((path, [name, value]) => path.replace(`{${name}}`, encodeURIComponent(value)), sdkOperation.path);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@instruments/materialgraph",
-  "version": "0.24.0",
+  "version": "0.26.0",
   "type": "module",
   "exports": {
     ".": {
@@ -17,7 +17,7 @@
     }
   },
   "dependencies": {
-    "@instruments/colorscope": "7.6.0"
+    "@instruments/colorscope": "9.0.1"
   },
   "license": "Proprietary",
   "engines": {

package/palette-completion-types.d.ts

@@ -1,26 +1,26 @@
 /** Public wire types; the SDK does not load the producer corpus. */
 export type CompositionalRole = "Foundation" | "Supporting" | "Accent";
-export interface RetainedColor {
+export type RetainedColor = {
     readonly id: string;
     readonly hex: string;
     readonly role?: CompositionalRole;
     readonly paintVariantId?: string;
-}
-export interface CompletionRequest {
+};
+export type CompletionRequest = {
     readonly inputs: readonly RetainedColor[];
     readonly maxDistance?: number;
     readonly limit?: number;
     readonly white?: "published" | "perceptual";
     readonly memberCount?: number;
     readonly excludeHexes?: readonly string[];
-}
-export interface CompletionAssignment {
+};
+export type CompletionAssignment = {
     readonly input: RetainedColor;
     readonly referenceIndex: number;
     readonly referenceHex: string;
     readonly distance: number;
-}
-export interface CompletionMember {
+};
+export type CompletionMember = {
     readonly hex: string;
     readonly referenceHex: string;
     readonly referenceIndex: number;
@@ -29,8 +29,8 @@ export interface CompletionMember {
     readonly proportion: number;
     readonly sourceRole: string | null;
     readonly sourceRelation: string | null;
-}
-export interface PaletteCompletion {
+};
+export type PaletteCompletion = {
     readonly uses?: readonly {
         readonly inputId: string;
         readonly role: CompositionalRole;
@@ -52,20 +52,20 @@ export interface PaletteCompletion {
     readonly proportionBasis: "sourced" | "proposed";
     readonly worstDistance: number;
     readonly totalDistance: number;
-}
+};
 export type PaletteCompleteInput = CompletionRequest & {
     sourceVersion: string;
 };
-export interface PaletteDiscoverInput {
+export type PaletteDiscoverInput = {
     sourceVersion: string;
     character?: "warm" | "cool" | "very-light" | "light" | "dark" | "muted" | "soft" | "vivid";
     moreLike?: string;
     cursor?: string;
     limit?: number;
-}
-export interface MaterializedPalette {
+};
+export type MaterializedPalette = {
     completion: PaletteCompletion;
-    samples: Array<{
+    samples: {
         retainedPaint?: {
             variantId: string;
             name: string;
@@ -87,15 +87,15 @@ export interface MaterializedPalette {
         status: string;
         distance: number | null;
         units: "oklab-euclidean";
-    }>;
-}
-interface PaletteVersions {
+    }[];
+};
+type PaletteVersions = {
     sourceVersion: string;
     corpusVersion: string;
     algorithmVersion: string;
     transport: "colorscope-package";
-}
-export interface PaletteCompleteResponse extends PaletteVersions {
+};
+export type PaletteCompleteResponse = {
     results: MaterializedPalette[];
     coverage: {
         status: string;
@@ -106,10 +106,10 @@ export interface PaletteCompleteResponse extends PaletteVersions {
         units: string;
         policy: string;
     };
-}
-export interface PaletteDiscoverResponse extends PaletteVersions {
+} & PaletteVersions;
+export type PaletteDiscoverResponse = {
     results: MaterializedPalette[];
     total: number;
     nextCursor: string | null;
-}
+} & PaletteVersions;
 export {};