@instruments/taxonomy 1.1.6 → 1.2.0

package/dist/index.js

@@ -470,6 +470,7 @@ var ELEMENT_FABRIC_TERMS = [
       uniclass("EF_25_10", "Walls", "exact")
     ],
     label: "Wall",
+    placement: "field",
     provenance: AUTHORED2,
     slug: "wall"
   },
@@ -482,6 +483,7 @@ var ELEMENT_FABRIC_TERMS = [
       uniclass("EF_25_10_25", EF_EXTERNAL_WALLS, "exact")
     ],
     label: "External Wall",
+    placement: "field",
     provenance: AUTHORED2,
     slug: "external-wall"
   },
@@ -494,6 +496,7 @@ var ELEMENT_FABRIC_TERMS = [
       uniclass("EF_25_10_40", "Internal walls", "exact")
     ],
     label: "Internal Wall",
+    placement: "field",
     provenance: AUTHORED2,
     slug: "internal-wall"
   },
@@ -505,6 +508,7 @@ var ELEMENT_FABRIC_TERMS = [
       uniclass("EF_25_10_40", "Internal walls", "broad")
     ],
     label: "Partition",
+    placement: "field",
     provenance: AUTHORED2,
     slug: "partition"
   },
@@ -513,6 +517,7 @@ var ELEMENT_FABRIC_TERMS = [
     external: [uniclass("EF_25_10_25", EF_EXTERNAL_WALLS, "related")],
     label: "Cladding",
     note: "No AAT mapping. AAT 300014860 `cladding` is the metal-coating process, a different thing entirely, and a plausible wrong mapping is worse than none.",
+    placement: "field",
     provenance: AUTHORED2,
     related: [partOf("external-wall")],
     slug: "cladding"
@@ -523,6 +528,7 @@ var ELEMENT_FABRIC_TERMS = [
     external: [aat("300002691", "wainscoting", "narrow")],
     label: "Panelling",
     note: "AAT's nearest term, `wainscoting`, is panelling carried only to dado height; this term covers full-height panelling too, so the AAT concept is narrower.",
+    placement: "joinery",
     provenance: AUTHORED2,
     related: [partOf(INTERNAL_WALL)],
     slug: "panelling"
@@ -534,6 +540,7 @@ var ELEMENT_FABRIC_TERMS = [
       uniclass("EF_25_10_60", "Parapet walls", "exact")
     ],
     label: "Parapet",
+    placement: "field",
     provenance: AUTHORED2,
     related: [partOf("external-wall")],
     slug: "parapet"
@@ -546,6 +553,7 @@ var ELEMENT_FABRIC_TERMS = [
       uniclass("EF_30_20", "Floors", "exact")
     ],
     label: "Floor",
+    placement: "underfoot",
     provenance: AUTHORED2,
     slug: "floor"
   },
@@ -553,6 +561,7 @@ var ELEMENT_FABRIC_TERMS = [
     definition: "The wearing layer laid on a floor, replaceable without touching the floor beneath it.",
     external: [aat("300014866", "flooring", "close")],
     label: "Floor Finish",
+    placement: "underfoot",
     provenance: AUTHORED2,
     related: [partOf("floor")],
     slug: "floor-finish"
@@ -566,6 +575,7 @@ var ELEMENT_FABRIC_TERMS = [
       uniclass("EF_30_20", "Floors", "broad")
     ],
     label: "Raised Floor",
+    placement: "underfoot",
     provenance: AUTHORED2,
     slug: "raised-floor"
   },
@@ -577,6 +587,7 @@ var ELEMENT_FABRIC_TERMS = [
       uniclass("EF_30_25_12", "Ceilings", "exact")
     ],
     label: "Ceiling",
+    placement: "overhead",
     provenance: AUTHORED2,
     slug: "ceiling"
   },
@@ -589,6 +600,7 @@ var ELEMENT_FABRIC_TERMS = [
       uniclass("EF_30_25_12", "Ceilings", "broad")
     ],
     label: "Suspended Ceiling",
+    placement: "overhead",
     provenance: AUTHORED2,
     slug: "suspended-ceiling"
   },
@@ -599,6 +611,7 @@ var ELEMENT_FABRIC_TERMS = [
       uniclass("EF_30_25_80", "Soffits", "exact")
     ],
     label: "Soffit",
+    placement: "overhead",
     provenance: AUTHORED2,
     slug: "soffit"
   },
@@ -610,6 +623,7 @@ var ELEMENT_FABRIC_TERMS = [
       uniclass("EF_30_10", "Roofs", "exact")
     ],
     label: "Roof",
+    placement: "overhead",
     provenance: AUTHORED2,
     slug: "roof"
   },
@@ -621,6 +635,7 @@ var ELEMENT_FABRIC_TERMS = [
       uniclass("EF_30_10_30", "Flat roofs", "exact")
     ],
     label: "Flat Roof",
+    placement: "overhead",
     provenance: AUTHORED2,
     slug: "flat-roof"
   },
@@ -632,6 +647,7 @@ var ELEMENT_FABRIC_TERMS = [
       uniclass("EF_30_10_64", "Pitched roofs", "exact")
     ],
     label: "Pitched Roof",
+    placement: "overhead",
     provenance: AUTHORED2,
     slug: "pitched-roof"
   },
@@ -640,6 +656,7 @@ var ELEMENT_FABRIC_TERMS = [
     definition: "A glazed opening in a roof plane, admitting daylight from above rather than from a wall.",
     external: [aat("300003062", "skylights", "exact")],
     label: "Rooflight",
+    placement: "unpainted",
     provenance: AUTHORED2,
     related: [partOf(ROOF)],
     slug: "rooflight"
@@ -652,6 +669,7 @@ var ELEMENT_FABRIC_TERMS = [
       uniclass("EF_25_30_25", "Doors", "exact")
     ],
     label: "Door",
+    placement: "joinery",
     provenance: AUTHORED2,
     slug: "door"
   },
@@ -662,6 +680,7 @@ var ELEMENT_FABRIC_TERMS = [
       uniclass("EF_25_30_97", "Windows", "exact")
     ],
     label: "Window",
+    placement: "trim",
     provenance: AUTHORED2,
     slug: "window"
   },
@@ -669,6 +688,7 @@ var ELEMENT_FABRIC_TERMS = [
     definition: "The transparent infill held in an opening or frame: the glass, not the opening it fills.",
     label: "Glazing",
     note: "No AAT mapping. AAT carries `glazing` only as processes and `glass` only as a material, and neither of those is this element.",
+    placement: "unpainted",
     provenance: AUTHORED2,
     related: [partOf(WINDOW), partOf("curtain-walling")],
     slug: "glazing"
@@ -682,13 +702,16 @@ var ELEMENT_FABRIC_TERMS = [
       uniclass("EF_25_10_25", EF_EXTERNAL_WALLS, "broad")
     ],
     label: "Curtain Walling",
+    placement: "unpainted",
     provenance: AUTHORED2,
     slug: "curtain-walling"
   },
   {
+    altLabels: ["shutters"],
     definition: "A hinged or sliding cover to a window opening, working by moving rather than by drawing.",
     external: [aat("300003173", "shutters (opening covers)", "exact")],
     label: "Shutter",
+    placement: "trim",
     provenance: AUTHORED2,
     related: [partOf(WINDOW)],
     slug: "shutter"
@@ -701,6 +724,7 @@ var ELEMENT_FABRIC_TERMS = [
       aat("300045375", "door hardware", "narrow")
     ],
     label: "Ironmongery",
+    placement: "unpainted",
     provenance: AUTHORED2,
     related: [partOf(DOOR), partOf(WINDOW)],
     slug: "ironmongery"
@@ -715,6 +739,7 @@ var ELEMENT_FABRIC_TERMS = [
       uniclass("EF_35_10", "Stairs", "exact")
     ],
     label: "Stair",
+    placement: "underfoot",
     provenance: AUTHORED2,
     slug: "stair"
   },
@@ -722,6 +747,7 @@ var ELEMENT_FABRIC_TERMS = [
     definition: "The horizontal face of a step, which is the surface the foot lands on.",
     external: [aat("300003326", "treads", "exact")],
     label: "Stair Tread",
+    placement: "underfoot",
     provenance: AUTHORED2,
     related: [partOf(STAIR)],
     slug: "stair-tread"
@@ -730,6 +756,7 @@ var ELEMENT_FABRIC_TERMS = [
     definition: "The vertical face between one tread and the next, absent on an open-riser stair.",
     external: [aat("300003325", "risers (step components)", "exact")],
     label: "Stair Riser",
+    placement: "underfoot",
     provenance: AUTHORED2,
     related: [partOf(STAIR)],
     slug: "stair-riser"
@@ -743,6 +770,7 @@ var ELEMENT_FABRIC_TERMS = [
       uniclass("EF_25_55", "Barriers", "broad")
     ],
     label: "Balustrade",
+    placement: "trim",
     provenance: AUTHORED2,
     related: [partOf(STAIR)],
     slug: "balustrade"
@@ -751,6 +779,7 @@ var ELEMENT_FABRIC_TERMS = [
     definition: "The continuous rail sized to be gripped while moving, on a balustrade or fixed to a wall.",
     external: [aat("300002022", "handrails", "exact")],
     label: "Handrail",
+    placement: "trim",
     provenance: AUTHORED2,
     related: [partOf(BALUSTRADE)],
     slug: "handrail"
@@ -760,6 +789,7 @@ var ELEMENT_FABRIC_TERMS = [
     definition: "The post terminating or turning a balustrade, taking the load the handrail cannot.",
     external: [aat("300003296", "newels", "exact")],
     label: "Newel",
+    placement: "trim",
     provenance: AUTHORED2,
     related: [partOf(BALUSTRADE)],
     slug: "newel"
@@ -777,6 +807,7 @@ var ELEMENT_FITOUT_TERMS = [
       uniclass("EF_40_20", "Fittings", "broad")
     ],
     label: "Millwork",
+    placement: "joinery",
     provenance: AUTHORED2,
     slug: "millwork"
   },
@@ -790,6 +821,7 @@ var ELEMENT_FITOUT_TERMS = [
       uniclass("EF_40_20", "Fittings", "broad")
     ],
     label: "Cabinetry",
+    placement: "joinery",
     provenance: AUTHORED2,
     slug: "cabinetry"
   },
@@ -798,6 +830,7 @@ var ELEMENT_FITOUT_TERMS = [
     definition: "The working surface spanning a run of cabinetry, specified for what is done on it.",
     external: [aat("300375691", "countertops", "exact")],
     label: "Worktop",
+    placement: "joinery",
     provenance: AUTHORED2,
     related: [partOf("cabinetry")],
     slug: "worktop"
@@ -809,6 +842,7 @@ var ELEMENT_FITOUT_TERMS = [
       uniclass("EF_40_20", "Fittings", "broad")
     ],
     label: "Shelving",
+    placement: "joinery",
     provenance: AUTHORED2,
     slug: "shelving"
   },
@@ -819,6 +853,7 @@ var ELEMENT_FITOUT_TERMS = [
     external: [aat("300040157", "built-in furniture", "broad")],
     label: "Wardrobe",
     note: "AAT splits `wardrobes` into a room sense and a loose-furniture sense, and a fitted wardrobe is neither, so the broader `built-in furniture` is carried instead.",
+    placement: "joinery",
     provenance: AUTHORED2,
     slug: "wardrobe"
   },
@@ -831,6 +866,7 @@ var ELEMENT_FITOUT_TERMS = [
     ],
     label: "Radiator",
     note: "The Uniclass match is `related`, not `broad`: EF_60_40_37 is the heating FUNCTION, and a radiator is not a kind of function.",
+    placement: "field",
     provenance: AUTHORED2,
     slug: "radiator"
   },
@@ -842,6 +878,7 @@ var ELEMENT_FITOUT_TERMS = [
       uniclass("EF_70_80", "Lighting", "related")
     ],
     label: "Luminaire",
+    placement: "unpainted",
     provenance: AUTHORED2,
     slug: "luminaire"
   },
@@ -850,6 +887,7 @@ var ELEMENT_FITOUT_TERMS = [
     definition: "The plumbed-in vessels of a wet room: basin, WC pan, cistern, bath, shower tray.",
     external: [aat("300052575", "plumbing fixtures", "close")],
     label: "Sanitaryware",
+    placement: "unpainted",
     provenance: AUTHORED2,
     slug: "sanitaryware"
   },
@@ -861,6 +899,7 @@ var ELEMENT_FITOUT_TERMS = [
       uniclass("EF_55_70_38", "Hot and cold water supply", "related")
     ],
     label: "Tapware",
+    placement: "unpainted",
     provenance: AUTHORED2,
     related: [partOf("sanitaryware")],
     slug: "tapware"
@@ -873,6 +912,7 @@ var ELEMENT_FITOUT_TERMS = [
       uniclass("EF_70_30_80", "Small power supply", "related")
     ],
     label: "Socket & Switch",
+    placement: "unpainted",
     provenance: AUTHORED2,
     slug: "socket-outlet"
   },
@@ -882,6 +922,7 @@ var ELEMENT_FITOUT_TERMS = [
     definition: "The board closing the wall-to-floor junction, protecting the base and hiding tolerance.",
     external: [aat("300002681", "baseboards", "exact")],
     label: "Skirting",
+    placement: "trim",
     provenance: AUTHORED2,
     related: [partOf(INTERNAL_WALL)],
     slug: "skirting"
@@ -892,6 +933,7 @@ var ELEMENT_FITOUT_TERMS = [
     external: [aat("300003429", "moldings (object components)", "broad")],
     label: "Architrave",
     note: "AAT 300001780 `architraves (entablature)` is the classical member and not this term, despite the shared word; the broader `moldings` concept is carried instead.",
+    placement: "trim",
     provenance: AUTHORED2,
     related: [partOf(DOOR)],
     slug: "architrave"
@@ -901,6 +943,7 @@ var ELEMENT_FITOUT_TERMS = [
     definition: "The moulded band at the wall-to-ceiling junction; a plain quadrant in that position is coving.",
     external: [aat("300001788", "cornices", "exact")],
     label: "Cornice",
+    placement: "overhead",
     provenance: AUTHORED2,
     related: [partOf(INTERNAL_WALL)],
     slug: "cornice"
@@ -910,6 +953,7 @@ var ELEMENT_FITOUT_TERMS = [
     definition: "The horizontal moulding at chair-back height, splitting the wall into dado and field.",
     external: [aat("300002684", "chair rails", "exact")],
     label: "Dado Rail",
+    placement: "trim",
     provenance: AUTHORED2,
     related: [partOf(INTERNAL_WALL)],
     slug: "dado-rail"
@@ -918,6 +962,7 @@ var ELEMENT_FITOUT_TERMS = [
     definition: "The high horizontal moulding profiled to take hanging hooks, so pictures move undrilled.",
     external: [aat("300002687", "picture rails", "exact")],
     label: "Picture Rail",
+    placement: "trim",
     provenance: AUTHORED2,
     related: [partOf(INTERNAL_WALL)],
     slug: "picture-rail"
@@ -932,6 +977,7 @@ var ELEMENT_FITOUT_TERMS = [
     ],
     label: "Column",
     note: "The Uniclass match is `related`: a column is a component of a framed structure, not a kind of one. The same holds for `beam` and `truss`.",
+    placement: "field",
     provenance: AUTHORED2,
     slug: "column"
   },
@@ -943,6 +989,7 @@ var ELEMENT_FITOUT_TERMS = [
       uniclass("EF_20_10_30", EF_FRAMED_STRUCTURES, "related")
     ],
     label: "Beam",
+    placement: "overhead",
     provenance: AUTHORED2,
     slug: "beam"
   },
@@ -953,6 +1000,7 @@ var ELEMENT_FITOUT_TERMS = [
       uniclass("EF_20_10_30", EF_FRAMED_STRUCTURES, "related")
     ],
     label: "Truss",
+    placement: "overhead",
     provenance: AUTHORED2,
     related: [partOf(ROOF)],
     slug: "truss"
@@ -962,6 +1010,7 @@ var ELEMENT_FITOUT_TERMS = [
     definition: "The built opening and hearth holding a fire, taken with the flue it discharges into.",
     external: [aat("300052267", "fireplaces", "exact")],
     label: "Fireplace",
+    placement: "joinery",
     provenance: AUTHORED2,
     slug: "fireplace"
   },
@@ -970,6 +1019,7 @@ var ELEMENT_FITOUT_TERMS = [
     definition: "The surround and shelf framing a fireplace opening, replaceable without touching it.",
     external: [aat("300052347", "mantels (fireplace components)", "exact")],
     label: "Chimneypiece",
+    placement: "joinery",
     provenance: AUTHORED2,
     related: [partOf("fireplace")],
     slug: "chimneypiece"
@@ -7460,7 +7510,7 @@ var resolveReference = (reference) => INDEX.byKey.get(canonicalKey(reference));
 // src/v1.ts
 var TAXONOMY_BASE_URI = "https://taxonomy.materialinstruments.com";
 var TAXONOMY_SNAPSHOT = "2026-09-01";
-var TAXONOMY_VERSION = "1.1.6";
+var TAXONOMY_VERSION = "1.2.0";
 var PUBLISHED_V1_BASELINE = "2026-08-30";
 var TAX45_REVIEW_SNAPSHOT = "2026-08-31";
 var compareText = (left, right) => {
@@ -7591,6 +7641,7 @@ var addTermNodes = (assembly, axis, axisUri) => {
         lifecycle: governance.lifecycle,
         ...term10.note === void 0 ? {} : { note: term10.note },
         order: termOrder,
+        ...term10.placement === void 0 ? {} : { placement: term10.placement },
         provenance: governance.provenance,
         ...term10.rank === void 0 ? {} : { rank: term10.rank },
         ...term10.searchedWithout === void 0 ? {} : { searchedWithout: term10.searchedWithout },

package/dist/match.d.ts

@@ -0,0 +1,107 @@
+import type { RelationRole } from "./term.js";
+/** The role an assertion plays inside a compound expression. */
+export type BundleRole = RelationRole;
+export interface BundleMemberInput {
+    /** A qualified canonical term or typed relation, e.g. `style.minimalism`. */
+    assertion: string;
+    /** Defaults to accent: an unspecified role is evidence of presence, not necessity. */
+    role?: BundleRole;
+}
+export interface BundleMember {
+    assertion: string;
+    role: BundleRole;
+}
+export interface CanonicalBundle {
+    kind: "all-of";
+    /** Stable, reversible identity derived from the canonical serialization. */
+    id: string;
+    members: readonly BundleMember[];
+    serialization: string;
+}
+export type AlternativeReason = "query-alternative" | "source-ambiguous";
+export interface CanonicalAlternatives {
+    kind: "any-of";
+    /** Stable, reversible identity derived from the sorted alternative bundle identities. */
+    id: string;
+    alternatives: readonly CanonicalBundle[];
+    reason: AlternativeReason;
+    serialization: string;
+}
+export declare const MATCH_WEIGHTS: Readonly<Record<RelationRole, number>>;
+export declare const DEFAULT_BUNDLE_ROLE: BundleRole;
+/**
+ * Give a bundle one canonical spelling. Duplicate assertions collapse; constitutive wins when the
+ * same assertion was supplied in both roles because removing it would otherwise change identity.
+ */
+export declare const defineBundle: (inputs: readonly BundleMemberInput[]) => CanonicalBundle;
+export declare const defineAlternatives: (inputs: readonly (CanonicalBundle | readonly BundleMemberInput[])[], reason: AlternativeReason) => CanonicalAlternatives;
+export interface BundleMatch {
+    eligible: boolean;
+    matched: readonly string[];
+    missingAccents: readonly string[];
+    missingConstitutive: readonly string[];
+    /** Fixed-weight score in [0, 1]. Ineligible matches always score zero. */
+    score: number;
+}
+/**
+ * Match without penalising extra candidate annotations. Richer annotation should not make an
+ * otherwise identical subject rank lower.
+ */
+export declare const matchBundle: (bundle: CanonicalBundle, candidateAssertions: Iterable<string>) => BundleMatch;
+export interface AlternativesMatch {
+    alternative: CanonicalBundle;
+    match: BundleMatch;
+}
+/** The strongest eligible reading wins; bundle identity makes ties deterministic. */
+export declare const matchAlternatives: (alternatives: CanonicalAlternatives, candidateAssertions: Iterable<string>) => AlternativesMatch;
+/** How well a candidate answered the query. `exact` matched every member, accents included. */
+export type MatchTier = "exact" | "eligible" | "relaxed";
+/** A subject to rank: an opaque id and the assertions annotating it. */
+export interface CandidateAnnotations {
+    id: string;
+    assertions: readonly string[];
+}
+export interface RankedCandidate {
+    id: string;
+    tier: MatchTier;
+    match: BundleMatch;
+}
+export interface BundleSearch {
+    /** The strongest tier present. Absent when no candidate carried even one member. */
+    tier?: MatchTier;
+    results: readonly RankedCandidate[];
+    /** True when nothing was eligible and the relaxed tier was served in its place. */
+    relaxed: boolean;
+    /**
+     * Constitutive members NO candidate in this corpus carries. Populated only when nothing was
+     * eligible, because that is when it is the answer: these are the conjuncts the corpus cannot
+     * satisfy, and naming them is what turns an empty result into a usable one.
+     */
+    blocking: readonly string[];
+}
+export interface SearchOptions {
+    /** Refuse the relaxed tier: return nothing rather than a labelled partial answer. */
+    strict?: boolean;
+    /** Truncate the ranked list. Applied after ordering, so it never changes which result is first. */
+    limit?: number;
+}
+/**
+ * Rank a corpus against a bundle under the published rule. Deterministic: the same corpus in any
+ * input order returns the same list.
+ */
+export declare const searchBundle: (bundle: CanonicalBundle, candidates: Iterable<CandidateAnnotations>, options?: SearchOptions) => BundleSearch;
+export interface MatchTestCandidate {
+    assertions: readonly string[];
+    id: string;
+}
+export interface MatchTestVector {
+    candidates: readonly MatchTestCandidate[];
+    expectedEligibleOrder: readonly string[];
+    id: string;
+    query: CanonicalBundle;
+}
+/**
+ * Executable test vectors published for consumers implementing the same rule in another language.
+ * One is residential, one commercial; the matcher itself has no market branch.
+ */
+export declare const MATCH_TEST_VECTORS: readonly MatchTestVector[];

package/dist/materialgraph-crossover-sources.d.ts

@@ -0,0 +1,52 @@
+export declare const MATERIALGRAPH_CROSSOVER_SOURCE = "materialgraph@b55d7ad33807d9653bd4838b7908fb1d100440a8:packages/products/src/search/colour-material-lexicon.ts:46-102";
+export declare const COLORSCOPE_CROSSOVER_SOURCE = "materialinstruments/colorscope@c0662caabe7cd8604241a8a7b2608fa5bc71de51:packages/core/data/reference/v1/taxonomy.json";
+export declare const BRASS_MATERIAL_SOURCE = "https://archive.copper.org/applications/industrial/DesignGuide/terms.php";
+export declare const BRASS_FINISH_SOURCE = "https://nickelinstitute.org/media/lxxh1zwr/2023-nickelplatinghandbooka5_printablepdf.pdf section 5";
+export declare const NICKEL_MATERIAL_SOURCE = "https://nickelinstitute.org/en/nickel-applications/";
+export declare const NICKEL_FINISH_SOURCE = "https://nickelinstitute.org/en/nickel-applications/plating";
+export declare const CROSSOVER_DEFINITION_SOURCES: {
+    readonly alabaster: "https://webapps.bgs.ac.uk/memoirs/docs/B06070.html";
+    readonly brass: "https://archive.copper.org/applications/industrial/DesignGuide/terms.php; https://nickelinstitute.org/media/lxxh1zwr/2023-nickelplatinghandbooka5_printablepdf.pdf section 5";
+    readonly bronze: "https://archive.copper.org/applications/industrial/DesignGuide/terms.php; https://archive.copper.org/applications/architecture/arch_dhb/technical-discussion/copper_alloys/";
+    readonly cherry: "https://research.fs.usda.gov/download/treesearch/37440.pdf";
+    readonly chestnut: "https://research.fs.usda.gov/download/treesearch/37440.pdf";
+    readonly chrome: "ISO 1456:2009, https://www.iso.org/standard/50237.html; ISO 6158:2018, https://www.iso.org/standard/72269.html";
+    readonly clay: "https://pubs.usgs.gov/info/clays/";
+    readonly concrete: "https://www.concrete.org/frequentlyaskedquestions.aspx?faqid=640";
+    readonly copper: "https://archive.copper.org/applications/industrial/DesignGuide/selection/elect02.php";
+    readonly cork: "https://apcor.pt/en/what-it-is";
+    readonly cotton: "https://www.fao.org/docrep/pdf/012/i0987e/i0987e00.pdf";
+    readonly denim: "https://cottonworks.com/encyclopedia-item/denim/";
+    readonly ebony: "https://research.fs.usda.gov/download/treesearch/37440.pdf";
+    readonly gold: "https://www.usgs.gov/centers/national-minerals-information-center/gold-statistics-and-information";
+    readonly gunmetal: "https://live.copper.org/applications/marine/cuni/alloys/pub-206-copper-alloys-for-marine-environments.pdf";
+    readonly iron: "https://www.usgs.gov/centers/national-minerals-information-center/iron-and-steel-statistics-and-information";
+    readonly jade: "https://www.gia.edu/jade-description";
+    readonly jute: "https://www.fao.org/markets-and-trade/commodities-overview/fibres/jute-and-hard-fibres/";
+    readonly leather: "ISO 15115, https://www.iso.org/obp/ui?_escaped_fragment_=iso%3Astd%3Aiso%3A15115%3Aed-1%3Av1%3Aen";
+    readonly limestone: "https://pubs.usgs.gov/fs/2008/3089/";
+    readonly linen: "https://allianceflaxlinenhemp.eu/en/document_resources/35/download";
+    readonly mahogany: "https://research.fs.usda.gov/download/treesearch/37440.pdf";
+    readonly marble: "https://www.naturalstoneinstitute.org/designprofessionals/varieties/definition/; ASTM C503 via https://www.naturalstoneinstitute.org/stoneprofessionals/astm/";
+    readonly nickel: "https://nickelinstitute.org/en/nickel-applications/; https://nickelinstitute.org/en/nickel-applications/plating";
+    readonly oak: "https://research.fs.usda.gov/download/treesearch/37440.pdf";
+    readonly obsidian: "https://www.usgs.gov/glossary/volcano-hazards-program-glossary";
+    readonly onyx: "https://www.naturalstoneinstitute.org/consumers/varieties/marble/";
+    readonly pewter: "Getty AAT 300010979, https://www.getty.edu/vow/AATFullDisplay?find=&logic=AND&note=&page=1&subjectid=300010979";
+    readonly platinum: "https://www.usgs.gov/centers/national-minerals-information-center/platinum-group-metals-statistics-and-information";
+    readonly rosewood: "https://research.fs.usda.gov/download/treesearch/37440.pdf";
+    readonly silver: "https://silverinstitute.org/silver-element-essentials/";
+    readonly sisal: "https://www.fao.org/docrep/pdf/012/i0987e/i0987e00.pdf";
+    readonly slate: "ASTM C629 via https://www.naturalstoneinstitute.org/stoneprofessionals/astm/";
+    readonly steel: "https://worldsteel.org/about-steel/what-is-steel/";
+    readonly stone: "https://www.naturalstoneinstitute.org/about/sponsorship-and-advertising/sponsored-content-guidelines/";
+    readonly suede: "ISO 15115, https://www.iso.org/obp/ui?_escaped_fragment_=iso%3Astd%3Aiso%3A15115%3Aed-1%3Av1%3Aen";
+    readonly teak: "https://research.fs.usda.gov/download/treesearch/37440.pdf";
+    readonly terracotta: "Getty AAT 300047296, https://www.getty.edu/vow/AATFullDisplay?find=building&logic=AND&note=&subjectid=300047296";
+    readonly travertine: "https://www.naturalstoneinstitute.org/about/sponsorship-and-advertising/sponsored-content-guidelines/";
+    readonly walnut: "https://research.fs.usda.gov/treesearch/32210";
+    readonly wood: "https://research.fs.usda.gov/download/treesearch/37440.pdf";
+    readonly wool: "https://www.fao.org/docrep/pdf/012/i0987e/i0987e00.pdf";
+};
+export type MaterialGraphCrossoverPhrase = keyof typeof CROSSOVER_DEFINITION_SOURCES;
+export declare const crossoverSource: (phrase: MaterialGraphCrossoverPhrase) => string;

package/dist/search-corpus-source.d.ts

@@ -0,0 +1,8 @@
+export declare const MATERIALGRAPH_SEARCH_CORPUS_COMMIT: "53df40868bfb09bfe69bc66c455c051e34005ae1";
+export declare const MATERIALGRAPH_SEARCH_CORPUS_PATH: "packages/products/src/benchmark/fixtures/benchmark-cases-2026-07-31.1.json";
+export declare const MATERIALGRAPH_SEARCH_CORPUS_SNAPSHOT: "2026-07-31";
+/**
+ * The fixture evidences searched language and admission need. Taxonomy authors the concept boundary;
+ * neither an individual phrase nor the 244-query fixture as a whole is treated as that definition.
+ */
+export declare const searchCorpusEvidence: (phrases: string) => string;

package/dist/taste-assertion.d.ts

@@ -0,0 +1,112 @@
+import type { CanonicalAlternatives, CanonicalBundle } from "./match.js";
+export declare const TASTE_ASSERTION_CONTRACT_VERSION: "1.0.0";
+export declare const TAXONOMY_SNAPSHOT_VERSION: "2026-08-31";
+export type AssertionRole = "taste" | "project_context" | "requirement";
+export type AssertionAuthority = "explicit" | "behavioral" | "inferred";
+export type AssertionPolarity = "positive" | "negative" | "never";
+export type AssertionScope = {
+    kind: "person";
+} | {
+    kind: "household";
+    householdId: string;
+} | {
+    kind: "project";
+    projectId: string;
+} | {
+    kind: "room_type";
+    roomTypeId: string;
+} | {
+    kind: "room";
+    roomId: string;
+} | {
+    kind: "surface";
+    roomId: string;
+    surfaceId: string;
+};
+export interface AssertionProvenance {
+    /** The application, import or instrument that produced the observation. */
+    sourceSystem: string;
+    /** Version of the source data, prompt, fixture or export used when the evidence was observed. */
+    sourceSnapshotVersion: string;
+    sourceRecordId?: string;
+    sourceUrl?: string;
+    /** Optional id for the observation from which this assertion was proposed. */
+    observationId?: string;
+}
+interface SourceMeaning {
+    /** Source vocabulary field, before canonicalisation. */
+    sourceField: string;
+    /** Verbatim source value; never replaced by the canonical label. */
+    sourceValue: string;
+    /** Version of the source-specific mapping policy. */
+    crosswalkVersion: string;
+    /** Version of the canonical vocabulary against which mapping ran. */
+    taxonomySnapshotVersion: string;
+}
+export interface ResolvedAssertionMeaning extends SourceMeaning {
+    kind: "resolved";
+    canonical: CanonicalBundle;
+}
+export interface AmbiguousAssertionMeaning extends SourceMeaning {
+    kind: "ambiguous";
+    alternatives: CanonicalAlternatives;
+}
+export interface UnresolvedAssertionMeaning extends SourceMeaning {
+    kind: "unresolved";
+}
+export type AssertionMeaning = ResolvedAssertionMeaning | AmbiguousAssertionMeaning | UnresolvedAssertionMeaning;
+interface PortableAssertionBase {
+    /** Stable application-owned identifier for this assertion event. */
+    id: string;
+    contractVersion: typeof TASTE_ASSERTION_CONTRACT_VERSION;
+    actorId: string;
+    /** Whose taste or project view the assertion describes; never inferred from actorId. */
+    subjectId: string;
+    /** Project context is explicit even when the assertion's scope is durable and personal. */
+    projectId: string;
+    authority: AssertionAuthority;
+    polarity: AssertionPolarity;
+    scope: AssertionScope;
+    meaning: AssertionMeaning;
+    provenance: AssertionProvenance;
+    observedAt: string;
+    confirmedAt?: string;
+    validFrom?: string;
+    validUntil?: string;
+    /** Logical withdrawal is append-only; physical privacy deletion is an application concern. */
+    retractedAt?: string;
+    supersedesAssertionId?: string;
+}
+export interface TasteAssertion extends PortableAssertionBase {
+    role: "taste";
+}
+export interface ProjectContextAssertion extends PortableAssertionBase {
+    role: "project_context";
+}
+export type RequirementOperator = "equals" | "not_equals" | "at_least" | "at_most" | "includes" | "excludes";
+export interface RequirementConstraint {
+    operator: RequirementOperator;
+    value: boolean | number | string;
+    unit?: string;
+}
+export interface RequirementAssertion extends PortableAssertionBase {
+    role: "requirement";
+    /** The dimension is canonical meaning; the source-owned required value remains typed here. */
+    constraint: RequirementConstraint;
+}
+/** Portable evidence semantics only. Ranking weights and serving policy belong to each consumer. */
+export type PortableTasteAssertion = TasteAssertion | ProjectContextAssertion | RequirementAssertion;
+export interface PortableAssertionTestVector {
+    assertion: PortableTasteAssertion;
+    id: string;
+    expected: {
+        actorId: string;
+        subjectId: string;
+        projectId: string;
+        role: AssertionRole;
+        meaningKind: AssertionMeaning["kind"];
+    };
+}
+/** Executable fixtures for consumers serialising the portable envelope in another repository. */
+export declare const PORTABLE_ASSERTION_TEST_VECTORS: readonly PortableAssertionTestVector[];
+export {};