@instruments/materialgraph 0.25.0 → 0.27.0

package/codes-client.d.ts

@@ -27,10 +27,10 @@ import type { CodeAdvisoryInput, CodeAdvisoryResponse, CodeContextRequest, CodeC
 import type { QueryParams } from "./http-transport.js";
 import type { SdkOperationId } from "./operations.js";
 /** The client's own request primitives, handed down so this file owns no transport. */
-export interface CodesTransport {
+export type CodesTransport = {
     get<T>(operationId: SdkOperationId, query?: QueryParams, signal?: AbortSignal): Promise<T>;
     post<T>(operationId: SdkOperationId, body: unknown, signal?: AbortSignal): Promise<T>;
-}
+};
 export declare class CodesClient {
     #private;
     constructor(transport: CodesTransport);

package/codes-client.js

@@ -27,8 +27,8 @@ export class CodesClient {
      * // `model_baseline` means unamended model IBC stood in for this AHJ's own table.
      * console.log(texas?.coverage, texas?.adoptionNote);
      */
-    context(signal) {
-        return this.#transport.get("list_code_context", undefined, signal);
+    async context(signal) {
+        return await this.#transport.get("list_code_context", undefined, signal);
     }
     /**
      * THE QUESTION: "what does this space DEMAND?" — before any candidate exists.
@@ -53,13 +53,13 @@ export class CodesClient {
      * });
      * requirements.map((r) => `${r.dimension}: ${r.label} (${r.section})`);
      */
-    requirements(input, signal) {
-        return this.#transport.get("list_code_requirements", {
+    async requirements(input, signal) {
+        return await this.#transport.get("list_code_requirements", {
             jurisdiction: input.jurisdictionId,
-            sprinklered: input.sprinklered,
             occupancy: input.occupancyGroup,
-            space: input.spaceType,
             room: input.roomType,
+            space: input.spaceType,
+            sprinklered: input.sprinklered,
         }, signal);
     }
     /**
@@ -93,7 +93,7 @@ export class CodesClient {
      * // `unverified` means no comparable rating is on file — common, never a pass.
      * const blocked = advisory.results.filter((r) => r.summary?.status === "shortfall");
      */
-    advisory(input, signal) {
-        return this.#transport.post("resolveCodeAdvisory", input, signal);
+    async advisory(input, signal) {
+        return await this.#transport.post("resolveCodeAdvisory", input, signal);
     }
 }

package/codes-types.d.ts

@@ -14,6 +14,7 @@
  * model code as adopted, never a legal determination.
  */
 import type { VariantId } from "./identifiers.js";
+import type { FilterGroups } from "./list-variants-types.js";
 import type { OpenEnum } from "./types.js";
 /**
  * A code context: the space the registry is queried for.
@@ -47,7 +48,7 @@ import type { OpenEnum } from "./types.js";
  * locations, and the room correlations themselves — from
  * {@link CodesClient.context}. Nothing here should be hardcoded.
  */
-export interface CodeContextRequest {
+export type CodeContextRequest = {
     /** A seeded jurisdiction id (e.g. `"us-tx"`); an unknown id is a 400 listing the seeded set. */
     jurisdictionId: string;
     /**
@@ -69,29 +70,29 @@ export interface CodeContextRequest {
     roomType?: string;
     /** Whether the space is sprinklered — relaxes several fire-finish floors. No default. */
     sprinklered: boolean;
-}
-export interface CodeAdvisoryInput extends CodeContextRequest {
+};
+export type CodeAdvisoryInput = {
     /**
      * 1–100 opaque variant ids to badge, echoed back in `results` in this exact
      * order and cardinality (duplicates are echoed, never collapsed). Preserve
      * them verbatim — never parse or construct one.
      */
     variantIds: VariantId[];
-}
+} & CodeContextRequest;
 /** The resolved jurisdiction the verdicts were evaluated against. */
-export interface CodeAdvisoryJurisdiction {
+export type CodeAdvisoryJurisdiction = {
     id: string;
     name: string;
     codeFamily: string;
     edition: string;
     adoptionNote: string;
-}
+};
 /** The echoed evaluation context (the space the badges apply to). */
-export interface CodeAdvisoryContext {
+export type CodeAdvisoryContext = {
     occupancyGroup: string;
     spaceType: string;
     sprinklered: boolean;
-}
+};
 /**
  * What one material is, and therefore what it was held to. `dimensions` are the
  * regulatory dimensions the material can be scored on; `basis` names which
@@ -104,7 +105,7 @@ export interface CodeAdvisoryContext {
  * list under `product_type` / `application` / `both` is a genuine intersection;
  * a full list under `unresolved` is the map falling short.
  */
-export interface MaterialCodeProfile {
+export type MaterialCodeProfile = {
     /** The variant's accepted primary product type, or null if it has none. */
     productTypeId: string | null;
     /** The variant's accepted `applications` terms, as stored. */
@@ -112,17 +113,17 @@ export interface MaterialCodeProfile {
     /** Regulatory dimensions this material can be held to. Empty ONLY when `basis` is `unresolved`. */
     dimensions: OpenEnum<"fire" | "floor" | "slip" | "decorative">[];
     basis: OpenEnum<"product_type" | "application" | "both" | "unresolved">;
-}
+};
 /** Why one requirement the space imposes was excluded from this material's `requirements`. */
-export interface CodeRequirementExclusion {
+export type CodeRequirementExclusion = {
     requirementId: string;
     dimension: OpenEnum<"fire" | "floor" | "slip" | "decorative">;
     reason: OpenEnum<"not_a_material_dimension">;
     /** One readable line, e.g. `"Slip resistance is not a dimension wallcovering answers for."`. */
     detail: string;
-}
+};
 /** The threshold one requirement imposes: a class floor and/or a numeric floor. */
-export interface CodeRequirementThreshold {
+export type CodeRequirementThreshold = {
     /** The IBC classification scale this requirement is measured on (open id). */
     scale: string;
     /** The minimum acceptable class on `scale`, or null when only a numeric floor applies. */
@@ -133,7 +134,7 @@ export interface CodeRequirementThreshold {
         value: number;
         unit: string;
     } | null;
-}
+};
 /**
  * The accepted fact a verdict was decided from — null when the material carried
  * none, which is exactly the case that produces `verdict: "unknown"`.
@@ -143,14 +144,14 @@ export interface CodeRequirementThreshold {
  * `derived` value at low confidence is a materially different statement from one
  * resting on a `tested` figure.
  */
-export interface CodeRequirementEvidence {
+export type CodeRequirementEvidence = {
     attributeId: OpenEnum<"fire_classifications" | "slip_resistance_dcof">;
     value: string;
     confidence: number | null;
     sourceBasis: string | null;
-}
+};
 /** One requirement badged against one material. */
-export interface CodeRequirementVerdict {
+export type CodeRequirementVerdict = {
     requirementId: string;
     dimension: OpenEnum<"fire" | "floor" | "slip" | "decorative">;
     section: string;
@@ -167,13 +168,13 @@ export interface CodeRequirementVerdict {
     evidence: CodeRequirementEvidence | null;
     /** The AHJ advisory caveat — model code as adopted, never a legal determination. */
     caveat: string;
-}
+};
 /**
  * One candidate's requirement verdicts folded into a single status and sentence.
  * A shortfall outranks an unknown, and an unknown NEVER rolls up to a pass:
  * `not_applicable` (nothing applied) is deliberately distinct from `meets`.
  */
-export interface CodeAdvisorySummary {
+export type CodeAdvisorySummary = {
     /**
      * The rolled-up card, and what each token licenses:
      *  - `meets` — every applicable requirement was `meets`. Advisory pass.
@@ -189,9 +190,9 @@ export interface CodeAdvisorySummary {
     headline: string;
     shortfallDimensions: OpenEnum<"fire" | "floor" | "slip" | "decorative">[];
     unverifiedDimensions: OpenEnum<"fire" | "floor" | "slip" | "decorative">[];
-}
+};
 /** Per-variant advisory outcome, in input order. */
-export interface CodeAdvisoryVariantResult {
+export type CodeAdvisoryVariantResult = {
     /** Opaque — echoed verbatim from `variantIds`, in that position. */
     variantId: VariantId;
     /** `evaluated` when the id resolved; `unknown_variant` (with `requirements: []`) when it did not. */
@@ -204,9 +205,9 @@ export interface CodeAdvisoryVariantResult {
     notApplicable: CodeRequirementExclusion[];
     /** The rolled-up card, or null for an id that resolved to nothing. */
     summary: CodeAdvisorySummary | null;
-}
+};
 /** The `POST /api/v1/codes/advisory` envelope — per-variant, per-requirement verdicts. */
-export interface CodeAdvisoryResponse {
+export type CodeAdvisoryResponse = {
     jurisdiction: CodeAdvisoryJurisdiction;
     /** The context AS SUPPLIED, echoed verbatim. */
     context: CodeAdvisoryContext;
@@ -215,9 +216,9 @@ export interface CodeAdvisoryResponse {
     /** The AHJ advisory caveat, at the envelope level too. */
     caveat: string;
     results: CodeAdvisoryVariantResult[];
-}
+};
 /** Where a resolved axis came from: stated outright, or correlated from a room type. */
-export interface ResolvedCodeContext {
+export type ResolvedCodeContext = {
     jurisdictionId: string;
     occupancyGroup: string;
     /** The canonical finish-location term id the registry was queried with. */
@@ -226,7 +227,7 @@ export interface ResolvedCodeContext {
     basis: OpenEnum<"explicit" | "derived_from_room">;
     /** The `room` term the axes were correlated from, or null. */
     roomType: string | null;
-}
+};
 /**
  * How far a jurisdiction's rows have been reviewed against that AHJ's own tables.
  *
@@ -236,7 +237,7 @@ export interface ResolvedCodeContext {
  *    say "per model IBC" rather than naming the jurisdiction as the authority.
  */
 export type CodeCoverageTier = OpenEnum<"thorough" | "model_baseline">;
-export interface CodeJurisdictionSummary {
+export type CodeJurisdictionSummary = {
     id: string;
     name: string;
     codeFamily: string;
@@ -244,9 +245,9 @@ export interface CodeJurisdictionSummary {
     coverage: CodeCoverageTier;
     /** One honest line on how the model code actually applies in this jurisdiction. */
     adoptionNote: string;
-}
+};
 /** The `GET /api/v1/codes/context` envelope — the vocabulary for stating a context. */
-export interface CodeContextResponse {
+export type CodeContextResponse = {
     jurisdictions: CodeJurisdictionSummary[];
     occupancyGroups: {
         id: string;
@@ -280,9 +281,9 @@ export interface CodeContextResponse {
     }[];
     /** The AHJ advisory caveat. */
     caveat: string;
-}
+};
 /** One requirement a context imposes, independent of any candidate material. */
-export interface CodeRequirementListing {
+export type CodeRequirementListing = {
     requirementId: string;
     dimension: OpenEnum<"fire" | "floor" | "slip" | "decorative">;
     /** The code section this demand is cited from. */
@@ -291,14 +292,34 @@ export interface CodeRequirementListing {
     requirement: CodeRequirementThreshold;
     /** One readable line, e.g. `"Class A or better · ASTM E84 / UL 723"`. */
     label: string;
-}
+};
+/** Why one requirement the context imposes could not become a `list_variants` filter predicate. */
+export type CodeSpecFilterUnexpressible = {
+    requirementId: string;
+    dimension: OpenEnum<"fire" | "floor" | "slip" | "decorative">;
+    reason: OpenEnum<"no_matchable_tokens" | "unsupported_scale" | "no_floor">;
+    /** One readable line naming why, e.g. `"Scale ... has no ordinal definition..."`. */
+    detail: string;
+};
 /**
  * The `GET /api/v1/codes/requirements` envelope. An empty `requirements` array
  * means the registry holds nothing for this context — it is not a pass.
  */
-export interface CodeRequirementsResponse {
+export type CodeRequirementsResponse = {
     jurisdiction: CodeJurisdictionSummary;
     context: ResolvedCodeContext;
     requirements: CodeRequirementListing[];
+    /**
+     * The same requirements as a ready-to-use `list_variants` `filters` group
+     * (MG-2222, `{terms, numbers, presence}`) — pass it straight through as
+     * `listVariants({ filters })`.
+     * `null` when nothing here is filterable; read `specFilterUnexpressible`
+     * for why, not an empty `requirements` list.
+     */
+    specFilter: FilterGroups | null;
+    /** The dimensions `specFilter` actually narrows on — a subset of `requirements`' dimensions. */
+    specFilterApplied: OpenEnum<"fire" | "floor" | "slip" | "decorative">[];
+    /** Requirements that could not be turned into a filter predicate, and why. */
+    specFilterUnexpressible: CodeSpecFilterUnexpressible[];
     caveat: string;
-}
+};

package/colour-aggregate-types.d.ts

@@ -17,7 +17,7 @@ export type CategoryTier = OpenEnum<"group" | "type" | "merged">;
 /** How the endpoint picks which colours to keep. */
 export type ColourProfileSelect = OpenEnum<"frequency" | "diverse">;
 /** One representative colour bucket of a category. */
-export interface CategoryColour {
+export type CategoryColour = {
     hex: string;
     oklab: {
         l: number;
@@ -27,8 +27,8 @@ export interface CategoryColour {
     variantCount: number;
     /** This bucket's share of the category's coloured variants, 0–1. */
     proportion: number;
-}
-export interface CategoryColourProfile {
+};
+export type CategoryColourProfile = {
     categoryKey: string;
     level: CategoryTier;
     name: string;
@@ -42,22 +42,22 @@ export interface CategoryColourProfile {
     avgLightness: number;
     avgChroma: number;
     colours: CategoryColour[];
-}
+};
 /**
  * The snapshot a profile response was computed from. Compare `variantCount`
  * against `colours/stats`' `corpus.withColour` to see how complete the
  * underlying materialized view currently is, and `refreshedAt` for its age.
  */
-export interface CategoryColourProfilesBasis {
+export type CategoryColourProfilesBasis = {
     variantCount: number;
     refreshedAt: string | null;
-}
-export interface CategoryColourProfilesResponse {
+};
+export type CategoryColourProfilesResponse = {
     profiles: CategoryColourProfile[];
     basis: CategoryColourProfilesBasis;
-}
+};
 /** Request parameters for `colours.profiles()`. */
-export interface ColourProfilesParams {
+export type ColourProfilesParams = {
     /** 1–8 category keys, at the tier named by `groupBy`. */
     productTypeIds: readonly string[];
     /**
@@ -69,31 +69,31 @@ export interface ColourProfilesParams {
     topN?: number;
     /** `"diverse"` maximises visual distinctness instead of frequency. */
     select?: "frequency" | "diverse";
-}
-export interface ColourStatsCorpus {
+};
+export type ColourStatsCorpus = {
     variants: number;
     withColour: number;
     /** `withColour / variants`, 0–1. */
     coverage: number;
-}
-export interface ColourStatsFamily {
+};
+export type ColourStatsFamily = {
     id: string;
     label: string;
     variants: number;
     brands: number;
-}
-export interface ColourStatsGroup {
+};
+export type ColourStatsGroup = {
     key: string;
     name: string;
     productTypes: number;
     variants: number;
-}
+};
 /**
  * One cell of the brand x category x colour-family matrix — the shape that
  * answers questions no single dimension can, such as "how many whites does
  * Benjamin Moore offer in paint".
  */
-export interface ColourStatsRow {
+export type ColourStatsRow = {
     /** Opaque brand id — the join key for brand reads. Never parse it. */
     brandId: string;
     brandSlug: string;
@@ -110,9 +110,9 @@ export interface ColourStatsRow {
      * `colour_family`. Not every variant of the brand.
      */
     variants: number;
-}
+};
 /** How to narrow the matrix. Passing ANY of these asks for `rows`. */
-export interface ColourStatsParams {
+export type ColourStatsParams = {
     /** `"brand,category"` — ask for the whole matrix, unscoped. */
     groupBy?: string;
     brandId?: string;
@@ -124,9 +124,9 @@ export interface ColourStatsParams {
     categoryKey?: string;
     family?: string;
     limit?: number;
-}
+};
 /** Where each section came from, how fresh it is, and what it does NOT answer. */
-export interface ColourStatsBasis {
+export type ColourStatsBasis = {
     corpus: string;
     families: string;
     groups: string;
@@ -139,8 +139,8 @@ export interface ColourStatsBasis {
      */
     rows?: string;
     omissions: string[];
-}
-export interface ColourStatsResponse {
+};
+export type ColourStatsResponse = {
     corpus: ColourStatsCorpus;
     families: ColourStatsFamily[];
     groups: ColourStatsGroup[];
@@ -160,4 +160,4 @@ export interface ColourStatsResponse {
     /** TRUE when the matrix exceeded the cap and `rows` is a prefix. */
     rowsTruncated?: boolean;
     basis: ColourStatsBasis;
-}
+};

package/colours-client.d.ts

@@ -9,8 +9,8 @@ import type { SdkOperationId } from "./operations.js";
  * client facade: "how much colour does the graph hold at all" (`stats`), "what
  * colours does this category come in" (`profiles`), "what goes with these
  * colours" (`palette`), and "what moves from this colour to that one"
- * (`gradient`). `mg.codes` and `mg.browse` set the precedent for a namespace
- * when a capability is a family rather than a single verb.
+ * (`gradient`). `mg.codes` sets the precedent for a namespace when a
+ * capability is a family rather than a single verb.
  *
  * The namespace holds no transport of its own: the client hands it a bound
  * `get`/`post`, so auth, rate-limit accounting and error shaping stay in one
@@ -28,27 +28,22 @@ import type { SdkOperationId } from "./operations.js";
  *   convenience wrapper.
  * - A colour NAME rather than a hex → `mg.resolveColour(name)` first.
  * - Colour WORDS (families, moods, undertones) → `mg.colourFacets()`.
- * - Walking the corpus by lightness/vividness → `mg.browse({ sort })`.
- * - Colour as one signal among words, a seed and a mood → `mg.search(...)`.
+ * - Walking the corpus by lightness/vividness → `mg.listVariants({ orderBy })`.
+ * - Colour as one signal among words and a seed → `mg.search(...)`.
  *
  * And the honesty rule the whole lens rests on: every colour here is DERIVED
  * FROM PRODUCT IMAGERY, not declared by the manufacturer. Report visual
  * likeness, never a stated colour specification.
  */
-import type { PaletteCompleteInput, PaletteCompleteResponse, PaletteDiscoverInput, PaletteDiscoverResponse } from "./palette-completion-types.js";
 import type { SearchGradientInput, SearchGradientResponse, SearchPaletteInput, SearchPaletteResponse } from "./palette-search-types.js";
 /** The client's own request primitives, handed down so this file owns no transport. */
-export interface ColoursTransport {
+export type ColoursTransport = {
     get<T>(operationId: SdkOperationId, query?: QueryParams, signal?: AbortSignal): Promise<T>;
     post<T>(operationId: SdkOperationId, body: unknown, signal?: AbortSignal): Promise<T>;
-}
+};
 export declare class ColoursClient {
     #private;
     constructor(transport: ColoursTransport);
-    /** Complete exact retained colors against a shared published interior reference. No Cart mutation. */
-    complete(input: PaletteCompleteInput, signal?: AbortSignal): Promise<PaletteCompleteResponse>;
-    /** Browse diverse published interior compositions against a version-pinned eligible catalogue. */
-    discover(input: PaletteDiscoverInput, signal?: AbortSignal): Promise<PaletteDiscoverResponse>;
     /**
      * THE QUESTION: "what colours does this CATEGORY come in?" — the representative
      * palette of 1–8 categories in ONE call (GET `/api/v1/colours/profiles`).

package/colours-client.js

@@ -3,14 +3,6 @@ export class ColoursClient {
     constructor(transport) {
         this.#transport = transport;
     }
-    /** Complete exact retained colors against a shared published interior reference. No Cart mutation. */
-    complete(input, signal) {
-        return this.#transport.post("complete_interior_palette", input, signal);
-    }
-    /** Browse diverse published interior compositions against a version-pinned eligible catalogue. */
-    discover(input, signal) {
-        return this.#transport.get("discover_interior_palettes", { ...input }, signal);
-    }
     /**
      * THE QUESTION: "what colours does this CATEGORY come in?" — the representative
      * palette of 1–8 categories in ONE call (GET `/api/v1/colours/profiles`).
@@ -39,12 +31,12 @@ export class ColoursClient {
      * A selected category with no colour data comes back as a zero-count profile,
      * not a missing key.
      */
-    profiles(params, signal) {
-        return this.#transport.get("get_category_colour_profiles", {
-            productTypeIds: params.productTypeIds.join(","),
+    async profiles(params, signal) {
+        return await this.#transport.get("get_category_colour_profiles", {
             groupBy: params.groupBy,
-            topN: params.topN,
+            productTypeIds: params.productTypeIds.join(","),
             select: params.select,
+            topN: params.topN,
         }, signal);
     }
     /**
@@ -68,13 +60,13 @@ export class ColoursClient {
      * `brandSlug` to join on. Without any of those parameters the payload is the
      * platform-wide one and `rows` is absent. `families` is never scoped by them.
      */
-    stats(params = {}, signal) {
-        return this.#transport.get("get_colour_stats", {
-            groupBy: params.groupBy,
+    async stats(params = {}, signal) {
+        return await this.#transport.get("get_colour_stats", {
             brandId: params.brandId,
             brandSlug: params.brandSlug,
             categoryKey: params.categoryKey,
             family: params.family,
+            groupBy: params.groupBy,
             limit: params.limit,
         }, signal);
     }
@@ -109,8 +101,8 @@ export class ColoursClient {
      *   ],
      * });
      */
-    palette(input, signal) {
-        return this.#transport.post("search_by_palette", input, signal);
+    async palette(input, signal) {
+        return await this.#transport.post("search_by_palette", input, signal);
     }
     /**
      * THE QUESTION: "what moves from this colour to that one?" — materials that
@@ -124,7 +116,7 @@ export class ColoursClient {
      * one that travels the whole way, and a flat single-colour material is
      * rejected outright however close its hue sits to the path.
      */
-    gradient(input, signal) {
-        return this.#transport.post("search_by_gradient", input, signal);
+    async gradient(input, signal) {
+        return await this.#transport.post("search_by_gradient", input, signal);
     }
 }

package/coordinate-client.d.ts

@@ -7,7 +7,7 @@
  * limit, in the same per-lens shape as `brands-client` / `codes-client` /
  * `colours-client`. Behaviour is unchanged.
  */
-import { HttpTransport } from "./http-transport.js";
+import type { HttpTransport } from "./http-transport.js";
 import type { CoordinateInput, CoordinateResponse } from "./types.js";
 /**
  * THE QUESTION: "here is my whole scheme so far — what completes it?" The
@@ -20,4 +20,4 @@ import type { CoordinateInput, CoordinateResponse } from "./types.js";
  * scheme is COLOURS rather than materials. Check `unresolved` before presenting:
  * a reference that resolved to nothing is named there, not dropped.
  */
-export declare function coordinate(transport: HttpTransport, input: CoordinateInput, signal?: AbortSignal): Promise<CoordinateResponse>;
+export declare const coordinate: (transport: HttpTransport, input: CoordinateInput, signal?: AbortSignal) => Promise<CoordinateResponse>;

package/coordinate-client.js

@@ -1,13 +1,3 @@
-/**
- * The COORDINATION lens: given several materials already chosen, what completes
- * them. A thin wrapper over the shared {@link HttpTransport};
- * `MaterialGraphClient.coordinate` delegates here.
- *
- * Extracted from `client.ts`, which sits above the repository's source-size
- * limit, in the same per-lens shape as `brands-client` / `codes-client` /
- * `colours-client`. Behaviour is unchanged.
- */
-import { HttpTransport } from "./http-transport.js";
 import { resolveOperation } from "./operations.js";
 /**
  * THE QUESTION: "here is my whole scheme so far — what completes it?" The
@@ -20,6 +10,4 @@ import { resolveOperation } from "./operations.js";
  * scheme is COLOURS rather than materials. Check `unresolved` before presenting:
  * a reference that resolved to nothing is named there, not dropped.
  */
-export function coordinate(transport, input, signal) {
-    return transport.requestJson(resolveOperation("coordinate_materials"), { body: input, signal });
-}
+export const coordinate = async (transport, input, signal) => await transport.requestJson(resolveOperation("coordinate_materials"), { body: input, signal });

package/corpus-scope-types.d.ts

@@ -22,7 +22,7 @@
  * and this build does not, so a new scope is not a compile error in a client
  * that simply has not been republished yet.
  */
-import { type OpenEnum } from "./types.js";
+import type { OpenEnum } from "./types.js";
 /**
  * Every corpus a caller may ask for.
  *
@@ -50,8 +50,8 @@ export type CorpusScope = OpenEnum<"samplizeCatalogue" | "all" | "designShopOrde
  * the counts: a short page under a scope is a small SCOPED corpus, never a
  * truncated one.
  */
-export interface CorpusScopeReceipt {
+export type CorpusScopeReceipt = {
     scope: CorpusScope;
     /** What the scope admits, in one sentence, for a human reader. */
     description: string;
-}
+};

package/corpus-scope-types.js

@@ -1,25 +1 @@
-/**
- * The corpus scope vocabulary, declared ONCE for the whole client.
- *
- * ── Why this file exists ──
- * Until MG-1168 the union was spelled inline at six places across the SDK, and
- * five of them had gone stale: `designShopOrderable` shipped in MG-1144 and
- * reached only the search request type, so a TypeScript consumer could send the
- * scope to `/search` and not to `/browse` — against a server that had accepted
- * it on both since the day it landed. The narrowed RECEIPT types were worse
- * than the request ones, because a caller could not even name the scope it got
- * back.
- *
- * That is the third hop of the reachability checklist failing quietly: server
- * correct, published client unable to reach the surface. One alias means the
- * next member is one edit here rather than six edits nobody is reminded to
- * make. `corpus-scope-parity.test.ts` in `apps/web/config` fails if this file
- * falls behind `CORPUS_SCOPES`.
- *
- * ── Why `OpenEnum` ──
- * The server may add a scope before a consumer upgrades. `OpenEnum` keeps the
- * known members as autocomplete while still accepting a string the server knows
- * and this build does not, so a new scope is not a compile error in a client
- * that simply has not been republished yet.
- */
-import {} from "./types.js";
+export {};