@instruments/taxonomy 0.2.0 → 0.3.0

package/dist/{chunk-XLUE3IC2.js → chunk-FCMCKNQF.js}

@@ -63,7 +63,12 @@ var PORTABLE_ASSERTION_TEST_VECTORS = [
         canonical: {
           id: "bundle:constitutive%3Arequirement.slip-resistance",
           kind: "all-of",
-          members: [{ assertion: "requirement.slip-resistance", role: "constitutive" }],
+          members: [
+            {
+              assertion: "requirement.slip-resistance",
+              role: "constitutive"
+            }
+          ],
           serialization: "constitutive:requirement.slip-resistance"
         },
         crosswalkVersion: "designshop-2026-08-25.1",
@@ -74,7 +79,11 @@ var PORTABLE_ASSERTION_TEST_VECTORS = [
       },
       polarity: "positive",
       role: "requirement",
-      scope: { kind: "surface", roomId: "room:lobby", surfaceId: "surface:floor" }
+      scope: {
+        kind: "surface",
+        roomId: "room:lobby",
+        surfaceId: "surface:floor"
+      }
     },
     expected: {
       actorId: FIXTURE_ACTOR_ID,

package/dist/chunk-WIRA24HM.js

@@ -0,0 +1,42 @@
+// src/crosswalks/mapping.ts
+var resolved = (...assertions) => ({
+  assertions: assertions.map((assertion) => ({
+    assertion,
+    role: "constitutive"
+  })),
+  match: "exact",
+  status: "resolved"
+});
+var constitutive = (assertion) => ({
+  assertions: [{ assertion, role: "constitutive" }],
+  match: "exact",
+  status: "resolved"
+});
+var approximates = (match, note, ...assertions) => ({
+  assertions: assertions.map((assertion) => ({
+    assertion,
+    role: "constitutive"
+  })),
+  match,
+  note,
+  status: "resolved"
+});
+var ambiguous = (match, ...assertions) => ({
+  alternatives: assertions.map((assertion) => [
+    { assertion, role: "constitutive" }
+  ]),
+  match,
+  status: "ambiguous"
+});
+var declined = (reason) => ({
+  reason,
+  status: "declined"
+});
+
+export {
+  resolved,
+  constitutive,
+  approximates,
+  ambiguous,
+  declined
+};

package/dist/crosswalks/designshop.d.ts

@@ -1,20 +1,12 @@
 import { CanonicalisationInput, CanonicalisationVerdict } from '../taste.js';
-import { B as BundleMemberInput } from '../match-BDI6Evro.js';
+import { C as CrosswalkMapping } from '../mapping-pvHk5VjC.js';
+import '../match-CWzTEuL-.js';
 
 declare const DESIGNSHOP_CROSSWALK_VERSION: "designshop-2026-08-25.1";
 declare const DESIGNSHOP_SOURCE_SYSTEM: "designshop";
 declare const DESIGNSHOP_SOURCE_FIELDS: readonly ["product_category", "material", "pattern", "finish", "format", "construction", "scheme_style", "product_style", "mood", "space", "requirement"];
 type DesignShopSourceField = (typeof DESIGNSHOP_SOURCE_FIELDS)[number];
-type Mapping = {
-    status: "resolved";
-    assertions: readonly BundleMemberInput[];
-} | {
-    status: "ambiguous";
-    alternatives: readonly (readonly BundleMemberInput[])[];
-} | {
-    status: "declined";
-    reason: string;
-};
+type Mapping = CrosswalkMapping;
 /**
  * Source-specific rows. Source fields are deliberately retained: DesignShop's `material:Mosaic`
  * resolves to a format, and pretending the source field was already canonical would preserve its

package/dist/crosswalks/designshop.js

@@ -1,10 +1,17 @@
+import {
+  ambiguous,
+  approximates,
+  constitutive,
+  declined,
+  resolved
+} from "../chunk-WIRA24HM.js";
 import {
   TAXONOMY_SNAPSHOT_VERSION
-} from "../chunk-XLUE3IC2.js";
+} from "../chunk-FCMCKNQF.js";
 import {
   defineAlternatives,
   defineBundle
-} from "../chunk-C2ZPDTOU.js";
+} from "../chunk-4ECRPD2I.js";
 
 // src/crosswalks/designshop.ts
 var DESIGNSHOP_CROSSWALK_VERSION = "designshop-2026-08-25.1";
@@ -22,18 +29,6 @@ var DESIGNSHOP_SOURCE_FIELDS = [
   "space",
   "requirement"
 ];
-var resolved = (...assertions) => ({
-  assertions: assertions.map((assertion) => ({ assertion, role: "constitutive" })),
-  status: "resolved"
-});
-var constitutive = (assertion) => ({
-  assertions: [{ assertion, role: "constitutive" }],
-  status: "resolved"
-});
-var ambiguous = (...assertions) => ({
-  alternatives: assertions.map((assertion) => [{ assertion, role: "constitutive" }]),
-  status: "ambiguous"
-});
 var DESIGNSHOP_CROSSWALK = {
   /* oxlint-disable sonarjs/no-duplicate-string -- canonical ids repeat across deliberately
      independent source rows; hiding them behind aliases would make the crosswalk harder to audit. */
@@ -43,7 +38,9 @@ var DESIGNSHOP_CROSSWALK = {
     Handcrafted: constitutive("construction.handcrafted"),
     Handmade: constitutive("construction.handmade"),
     Handwoven: constitutive("construction.handwoven"),
-    "High Pressure Laminate": constitutive("construction.high-pressure-laminate"),
+    "High Pressure Laminate": constitutive(
+      "construction.high-pressure-laminate"
+    ),
     Laminated: constitutive("construction.laminated"),
     "Loop Pile": constitutive("construction.loop-pile"),
     "Luxury Vinyl": constitutive("construction.luxury-vinyl"),
@@ -51,14 +48,19 @@ var DESIGNSHOP_CROSSWALK = {
     "Pre-Cast / Molded": constitutive("construction.precast-moulded"),
     Printed: constitutive("construction.printed"),
     "Red Clay Body": constitutive("construction.red-clay-body"),
-    "Rigid Core Luxury Vinyl": constitutive("construction.rigid-core-luxury-vinyl"),
+    "Rigid Core Luxury Vinyl": constitutive(
+      "construction.rigid-core-luxury-vinyl"
+    ),
     Sintered: constitutive("construction.sintered"),
     "Through Body": constitutive("construction.through-body"),
     Woven: constitutive("construction.woven")
   },
   finish: {
     Glazed: constitutive("finish.glazed"),
-    Gloss: constitutive("finish.gloss"),
+    // `finish.gloss` became the top rung of the sheen ladder when FINISH split into
+    // treatment/sheen/texture. In trade use "Gloss" IS the top rung — matte, eggshell,
+    // satin, semi-gloss, gloss — so this resolves rather than approximates.
+    Gloss: constitutive("finish.high-gloss"),
     Honed: constitutive("finish.honed"),
     Matte: constitutive("finish.matte"),
     Natural: constitutive("finish.natural"),
@@ -78,16 +80,30 @@ var DESIGNSHOP_CROSSWALK = {
     "Wide Plank": constitutive("format.wide-plank")
   },
   material: {
-    "Carpet Tiles": resolved("product-category.carpet-and-rug", "format.modular"),
+    "Carpet Tiles": resolved(
+      "product-category.carpet-and-rug",
+      "format.modular"
+    ),
     Ceramic: constitutive("material.ceramic"),
-    "Engineered & Composite": constitutive("material.composite"),
-    Interior: {
-      reason: "A catalogue location masquerading as a material value.",
-      status: "declined"
-    },
+    "Engineered & Composite": approximates(
+      "close",
+      "A two-word source value onto one canonical term. `material.composite` defines itself as an engineered material of two or more bound constituents, so it covers both halves - but the source names them separately and the canon does not, which is a substitution that holds in most contexts and not all.",
+      "material.composite"
+    ),
+    Interior: declined(
+      "A catalogue location masquerading as a material value."
+    ),
     Laminate: constitutive("material.laminate"),
-    Mosaic: constitutive("format.modular"),
-    Natural: constitutive("material.natural-fibre"),
+    Mosaic: approximates(
+      "broad",
+      "Every mosaic is supplied as repeatable units; most modular things are not mosaics. The canon is broader than the source, and the tesserae themselves have no canonical term.",
+      "format.modular"
+    ),
+    Natural: approximates(
+      "narrow",
+      "The source says natural and the canon answers natural FIBRE. Stone and clay are natural materials this row cannot reach, so the canonical term is narrower than the source value.",
+      "material.natural-fibre"
+    ),
     Paper: constitutive("material.paper"),
     Porcelain: constitutive("material.porcelain"),
     "Solid Surface": constitutive("material.solid-surface"),
@@ -104,7 +120,11 @@ var DESIGNSHOP_CROSSWALK = {
     "Abstract / Organic": constitutive("pattern.abstract-organic"),
     "Animal Print": constitutive("pattern.animal-print"),
     Botanical: constitutive("pattern.botanical"),
-    "Brocade / Damask / Moire": constitutive("pattern.damask"),
+    "Brocade / Damask / Moire": approximates(
+      "narrow",
+      "Three named motifs onto one. Moire is a watered interference figure and not a damask at all; the canon carries one member of the source's set.",
+      "pattern.damask"
+    ),
     "Concrete Effect": constitutive("pattern.concrete-effect"),
     "Cultural Heritage": constitutive("pattern.cultural-heritage"),
     Geometric: constitutive("pattern.geometric"),
@@ -112,13 +132,25 @@ var DESIGNSHOP_CROSSWALK = {
     "Leather Effect": constitutive("pattern.leather-effect"),
     Marbleized: constitutive("pattern.marbleised"),
     "Metal Effect": constitutive("pattern.metal-effect"),
-    Natural: constitutive("pattern.natural-motif"),
+    Natural: approximates(
+      "close",
+      "`natural_motif` is the canon reading of a bare `Natural` in a pattern vocabulary, and the two substitute in most retrieval - but the source word is broad enough to have meant an undecorated natural material, which is `pattern.plain` plus a material claim.",
+      "pattern.natural-motif"
+    ),
     Novelty: constitutive("pattern.novelty"),
-    "Plaid / Check / Houndstooth": constitutive("pattern.plaid-check"),
+    "Plaid / Check / Houndstooth": approximates(
+      "narrow",
+      "Houndstooth is a broken twill figure, not the orthogonal crossing bands `plaid_check` defines. Two of the source's three members land; the third does not.",
+      "pattern.plaid-check"
+    ),
     Scenic: constitutive("pattern.scenic"),
     Solid: constitutive("pattern.plain"),
     "Stone Effect": constitutive("pattern.stone-effect"),
-    "Strie / Ombre / Gradient": constitutive("pattern.gradient"),
+    "Strie / Ombre / Gradient": approximates(
+      "narrow",
+      "Strie is fine irregular striation - a stripe reading, not a transition - so the canon carries the ombre and gradient members of this set and not the first.",
+      "pattern.gradient"
+    ),
     Stripe: constitutive("pattern.stripe"),
     Texture: constitutive("pattern.texture"),
     Toile: constitutive("pattern.toile"),
@@ -135,18 +167,36 @@ var DESIGNSHOP_CROSSWALK = {
   },
   product_style: {
     "Art Deco": constitutive("style.art-deco"),
-    "Classic/ Traditional": constitutive("style.traditional"),
+    "Classic/ Traditional": approximates(
+      "close",
+      "Classic and Traditional are one prototype category in trade use and two words in the source. `style.traditional` substitutes for both without carrying the pair.",
+      "style.traditional"
+    ),
     Coastal: constitutive("evokes(place.landscape.coastal)"),
     Contemporary: constitutive("style.contemporary"),
-    "Country/ Cottage": resolved("evokes(typology.cottage)", "style.traditional"),
+    "Country/ Cottage": approximates(
+      "close",
+      "A compound reading: the cottage reference plus the traditional idiom. It carries most of what the source meant and not the rural setting, which is a place claim the source implies and never states.",
+      "evokes(typology.cottage)",
+      "style.traditional"
+    ),
     Eclectic: constitutive("style.eclectic"),
-    Farmhouse: resolved("evokes(typology.farmhouse)", "style.rustic"),
+    Farmhouse: approximates(
+      "close",
+      "The farmhouse reference plus the rustic idiom. Together they read as the source does in most retrieval; neither half nor the pair carries the agricultural building itself.",
+      "evokes(typology.farmhouse)",
+      "style.rustic"
+    ),
     Industrial: constitutive("style.industrial"),
     "Mid-Century Modern": constitutive("style.mid-century-modern"),
     Minimalist: constitutive("style.minimalism"),
-    Modern: ambiguous("style.modernism", "style.contemporary"),
+    Modern: ambiguous("close", "style.modernism", "style.contemporary"),
     Rustic: constitutive("style.rustic"),
-    Scandinavian: constitutive("evokes(place.region.nordic)"),
+    Scandinavian: approximates(
+      "broad",
+      "Nordic includes Finland and Iceland; Scandinavian does not. The canon covers more than the source claimed, and the estate carries no narrower region term.",
+      "evokes(place.region.nordic)"
+    ),
     Transitional: constitutive("style.transitional")
   },
   requirement: {
@@ -164,11 +214,20 @@ var DESIGNSHOP_CROSSWALK = {
   scheme_style: {
     Coastal: constitutive("evokes(place.landscape.coastal)"),
     Contemporary: constitutive("style.contemporary"),
-    Country: ambiguous("evokes(place.region.english-country)", "evokes(typology.farmhouse)"),
+    Country: ambiguous(
+      "close",
+      "evokes(place.region.english-country)",
+      "evokes(typology.farmhouse)"
+    ),
     Eclectic: constitutive("style.eclectic"),
-    Farmhouse: resolved("evokes(typology.farmhouse)", "style.rustic"),
+    Farmhouse: approximates(
+      "close",
+      "The farmhouse reference plus the rustic idiom. Together they read as the source does in most retrieval; neither half nor the pair carries the agricultural building itself.",
+      "evokes(typology.farmhouse)",
+      "style.rustic"
+    ),
     Minimalist: constitutive("style.minimalism"),
-    Modern: ambiguous("style.modernism", "style.contemporary"),
+    Modern: ambiguous("close", "style.modernism", "style.contemporary"),
     Traditional: constitutive("style.traditional"),
     Transitional: constitutive("style.transitional")
   },
@@ -199,15 +258,30 @@ var canonicaliseDesignShop = (input) => {
   if (mapping.status === "ambiguous") {
     return {
       ...base,
-      alternatives: defineAlternatives(mapping.alternatives, "source-ambiguous"),
-      status: "ambiguous"
+      alternatives: defineAlternatives(
+        mapping.alternatives,
+        "source-ambiguous"
+      ),
+      match: mapping.match,
+      status: "ambiguous",
+      ...mapping.note === void 0 ? {} : { note: mapping.note }
     };
   }
-  return { ...base, canonical: defineBundle(mapping.assertions), status: "resolved" };
+  return {
+    ...base,
+    canonical: defineBundle(mapping.assertions),
+    match: mapping.match,
+    status: "resolved",
+    ...mapping.note === void 0 ? {} : { note: mapping.note }
+  };
 };
 var DESIGNSHOP_APPEARANCE_TEST_VECTORS = [
   {
-    expectedAssertions: ["material.porcelain", "pattern.plain", "product-category.tile"],
+    expectedAssertions: [
+      "material.porcelain",
+      "pattern.plain",
+      "product-category.tile"
+    ],
     facets: [
       { sourceField: "product_category", sourceValue: "Tile" },
       { sourceField: "material", sourceValue: "Porcelain" },
@@ -217,7 +291,11 @@ var DESIGNSHOP_APPEARANCE_TEST_VECTORS = [
     market: "residential"
   },
   {
-    expectedAssertions: ["material.porcelain", "pattern.geometric", "product-category.tile"],
+    expectedAssertions: [
+      "material.porcelain",
+      "pattern.geometric",
+      "product-category.tile"
+    ],
     facets: [
       { sourceField: "product_category", sourceValue: "Tile" },
       { sourceField: "material", sourceValue: "Porcelain" },
@@ -227,7 +305,11 @@ var DESIGNSHOP_APPEARANCE_TEST_VECTORS = [
     market: "residential"
   },
   {
-    expectedAssertions: ["material.porcelain", "pattern.stone-effect", "product-category.tile"],
+    expectedAssertions: [
+      "material.porcelain",
+      "pattern.stone-effect",
+      "product-category.tile"
+    ],
     facets: [
       { sourceField: "product_category", sourceValue: "Tile" },
       { sourceField: "material", sourceValue: "Porcelain" },

package/dist/crosswalks/materialgraph.d.ts

@@ -0,0 +1,41 @@
+import { CanonicalisationInput, CanonicalisationVerdict } from '../taste.js';
+import { B as BundleRole } from '../match-CWzTEuL-.js';
+import { C as CrosswalkMapping } from '../mapping-pvHk5VjC.js';
+
+declare const MATERIALGRAPH_CROSSWALK_VERSION: "materialgraph-2026-08-27.1";
+declare const MATERIALGRAPH_SOURCE_SYSTEM: "materialgraph";
+declare const MATERIALGRAPH_SNAPSHOT: "2026-08-27";
+/**
+ * The two dictionaries this crosswalk covers. Both were `ms_`-prefixed until MaterialGraph renamed
+ * them on 2026-08-27; the bare names are the current ones.
+ */
+declare const MATERIALGRAPH_SOURCE_FIELDS: readonly ["role", "character"];
+type MaterialGraphSourceField = (typeof MATERIALGRAPH_SOURCE_FIELDS)[number];
+/**
+ * Two `role` values that are not product properties at all, and where they actually go.
+ *
+ * A role IN A SCHEME is what `match.ts` already calls a `BundleRole`: `accent` means present and
+ * deliberate but the scheme survives without it, `constitutive` means remove it and the thing stops
+ * being what it is. A feature surface is the second by definition. Publishing these as a mapping to
+ * the bundle role rather than as terms is what stops the same slab being permanently labelled a
+ * feature surface because one scheme once used it as one.
+ */
+declare const MATERIALGRAPH_COMPOSITIONAL_ROLES: Readonly<Record<string, BundleRole>>;
+declare const MATERIALGRAPH_CROSSWALK: Readonly<Record<MaterialGraphSourceField, Readonly<Record<string, CrosswalkMapping>>>>;
+interface MaterialGraphCanonicalisationInput extends Omit<CanonicalisationInput, "sourceSystem" | "sourceField"> {
+    sourceField: MaterialGraphSourceField;
+}
+/** Unknown values are unresolved, never declined. Declines require an explicit curated row. */
+declare const canonicaliseMaterialGraph: (input: MaterialGraphCanonicalisationInput) => CanonicalisationVerdict;
+/**
+ * The upstream dictionaries, vendored as id tuples so this file can be checked against them.
+ *
+ * Verbatim from materialgraph packages/schema/src/registry/value-dictionaries — `role` in
+ * `material-semantics-core.ts`, `character` in `material-semantics-aesthetics.ts`, both at the
+ * 2026-08-27 snapshot, after the rename that dropped their `ms_` prefixes.
+ */
+declare const MATERIALGRAPH_ROLE_VALUES: readonly ["wall_finish", "flooring", "ceiling", "joinery", "upholstery", "drapery", "accent", "worksurface", "casegoods", "feature_surface", "trim", "other"];
+declare const MATERIALGRAPH_CHARACTER_VALUES: readonly ["quiet", "expressive", "restrained", "bold", "rustic", "crafted", "refined", "formal", "casual", "natural_reading", "synthetic_reading", "soft_reading", "hard_reading"];
+declare const MATERIALGRAPH_SOURCE_VALUES: Readonly<Record<MaterialGraphSourceField, readonly string[]>>;
+
+export { MATERIALGRAPH_CHARACTER_VALUES, MATERIALGRAPH_COMPOSITIONAL_ROLES, MATERIALGRAPH_CROSSWALK, MATERIALGRAPH_CROSSWALK_VERSION, MATERIALGRAPH_ROLE_VALUES, MATERIALGRAPH_SNAPSHOT, MATERIALGRAPH_SOURCE_FIELDS, MATERIALGRAPH_SOURCE_SYSTEM, MATERIALGRAPH_SOURCE_VALUES, type MaterialGraphCanonicalisationInput, type MaterialGraphSourceField, canonicaliseMaterialGraph };

package/dist/crosswalks/materialgraph.js

@@ -0,0 +1,178 @@
+import {
+  approximates,
+  constitutive,
+  declined
+} from "../chunk-WIRA24HM.js";
+import {
+  TAXONOMY_SNAPSHOT_VERSION
+} from "../chunk-FCMCKNQF.js";
+import {
+  defineAlternatives,
+  defineBundle
+} from "../chunk-4ECRPD2I.js";
+
+// src/crosswalks/materialgraph.ts
+var MATERIALGRAPH_CROSSWALK_VERSION = "materialgraph-2026-08-27.1";
+var MATERIALGRAPH_SOURCE_SYSTEM = "materialgraph";
+var MATERIALGRAPH_SNAPSHOT = "2026-08-27";
+var MATERIALGRAPH_SOURCE_FIELDS = ["role", "character"];
+var MATERIALGRAPH_COMPOSITIONAL_ROLES = {
+  accent: "accent",
+  feature_surface: "constitutive"
+};
+var SCALE_SHIFT = "A claim about a MATERIAL answered by a term about a ROOM. The two substitute in retrieval most of the time and not always, which is what `close` says and what `resolved` could not.";
+var LADDER = "One rung of the quiet/restrained/expressive/bold presence ladder. MOOD is unordered and has no term for this rung, so the association is published and the ordering is lost. See the header.";
+var READS_AS = "A `reads-as` claim with nothing to point at. The predicate exists in `term.ts`; the target vocabulary - a natural/synthetic and soft/hard reading register - is not authored on any axis, and minting one would be a new axis. Searched 2026-08-27 across all 23 axes; absent.";
+var MATERIALGRAPH_CROSSWALK = {
+  /* oxlint-disable sort-keys -- rows follow the upstream dictionary order, so a reader can check
+     this file against `material-semantics-core.ts` and `-aesthetics.ts` without reordering. */
+  role: {
+    wall_finish: approximates(
+      "broad",
+      "`application.wall` is every use of a wall face - panelling, tiling, cladding - and the source names one of them. The canon covers more than the source claimed. Note the collision with `material-family.wall-finish`, which is the same two words asking what the thing is MADE OF; this row is about where it goes.",
+      "application.wall"
+    ),
+    flooring: constitutive("application.flooring"),
+    ceiling: constitutive("application.ceiling"),
+    // `element.millwork` already carries `joinery` and `casework` as alt labels: the canon has
+    // ruled that the British and American words name one thing, and this row follows that ruling
+    // rather than re-opening it.
+    joinery: constitutive("application.millwork"),
+    upholstery: constitutive("application.upholstery"),
+    drapery: constitutive("application.vh_drapery"),
+    // `application.countertop` gained `worksurface` as an alt label for this row. One surface, two
+    // national names, one term.
+    worksurface: constitutive("application.countertop"),
+    casegoods: approximates(
+      "close",
+      "A role answered by a product kind. `product_category.storage` carries `casegoods` as an alt label, so the words agree; the claims do not quite, because the source says what the material is DOING and the canon says what the product IS.",
+      "product_category.storage"
+    ),
+    trim: constitutive("application.trim"),
+    accent: declined(
+      "Compositional, not a product property: the same material is an accent in one scheme and the field in the next. Its destination is the bundle role `accent` in `match.ts` - see MATERIALGRAPH_COMPOSITIONAL_ROLES."
+    ),
+    feature_surface: declined(
+      "Compositional, as `accent` is. Its destination is the bundle role `constitutive`: a feature surface is the one you cannot remove without changing what the scheme is."
+    ),
+    other: declined(
+      "A routing bucket with no content. `other` on a closed axis is a positive classification; on this one it names nothing at all, and the honest canonical value is null."
+    )
+  },
+  character: {
+    quiet: approximates("close", SCALE_SHIFT, "mood.calm"),
+    expressive: approximates("related", LADDER, "mood.dramatic"),
+    restrained: approximates(
+      "related",
+      `${LADDER} \`mood.austere\` is the nearest room-scale term and it overstates: austerity is renunciation, restraint is only quietness of means.`,
+      "mood.austere"
+    ),
+    bold: approximates("related", LADDER, "mood.dramatic"),
+    // The one row in this dictionary that reads the same at both scales: a rustic material and a
+    // rustic room are the same idiom, which is what TAX-14 found and this keeps.
+    rustic: approximates("close", SCALE_SHIFT, "style.rustic"),
+    crafted: approximates(
+      "related",
+      "A READING answered by a production FACT, and the two come apart in both directions: a printed laminate can read as crafted, and a machine-finished handmade tile can read as neither. Association only.",
+      "construction.handcrafted"
+    ),
+    refined: declined(
+      "The machine-precise register has no canonical term. `mood.quiet-luxury` is about expense being legible and `finish.treatment.polished` is about a surface operation; refined is about precision of execution and is neither. Searched 2026-08-27; absent."
+    ),
+    // TAX-14 recorded this as `lossy` - "`serious` understates the social convention `formal`
+    // carries". That verdict is SKOS's `closeMatch`, reached independently and now spelled in the
+    // published vocabulary rather than in a bespoke one.
+    formal: approximates(
+      "close",
+      `${SCALE_SHIFT} \`mood.serious\` also understates the social convention \`formal\` carries.`,
+      "mood.serious"
+    ),
+    casual: approximates("close", SCALE_SHIFT, "mood.domestic"),
+    natural_reading: declined(READS_AS),
+    synthetic_reading: declined(READS_AS),
+    soft_reading: declined(READS_AS),
+    hard_reading: declined(READS_AS)
+  }
+  /* oxlint-enable sort-keys */
+};
+var canonicaliseMaterialGraph = (input) => {
+  const base = {
+    crosswalkVersion: MATERIALGRAPH_CROSSWALK_VERSION,
+    provenance: input.provenance,
+    sourceField: input.sourceField,
+    sourceSystem: MATERIALGRAPH_SOURCE_SYSTEM,
+    sourceValue: input.sourceValue,
+    taxonomySnapshotVersion: TAXONOMY_SNAPSHOT_VERSION
+  };
+  const mapping = MATERIALGRAPH_CROSSWALK[input.sourceField][input.sourceValue];
+  if (mapping === void 0) {
+    return { ...base, status: "unresolved" };
+  }
+  if (mapping.status === "declined") {
+    return { ...base, reason: mapping.reason, status: "declined" };
+  }
+  if (mapping.status === "ambiguous") {
+    return {
+      ...base,
+      alternatives: defineAlternatives(
+        mapping.alternatives,
+        "source-ambiguous"
+      ),
+      match: mapping.match,
+      status: "ambiguous",
+      ...mapping.note === void 0 ? {} : { note: mapping.note }
+    };
+  }
+  return {
+    ...base,
+    canonical: defineBundle(mapping.assertions),
+    match: mapping.match,
+    status: "resolved",
+    ...mapping.note === void 0 ? {} : { note: mapping.note }
+  };
+};
+var MATERIALGRAPH_ROLE_VALUES = [
+  "wall_finish",
+  "flooring",
+  "ceiling",
+  "joinery",
+  "upholstery",
+  "drapery",
+  "accent",
+  "worksurface",
+  "casegoods",
+  "feature_surface",
+  "trim",
+  "other"
+];
+var MATERIALGRAPH_CHARACTER_VALUES = [
+  "quiet",
+  "expressive",
+  "restrained",
+  "bold",
+  "rustic",
+  "crafted",
+  "refined",
+  "formal",
+  "casual",
+  "natural_reading",
+  "synthetic_reading",
+  "soft_reading",
+  "hard_reading"
+];
+var MATERIALGRAPH_SOURCE_VALUES = {
+  character: MATERIALGRAPH_CHARACTER_VALUES,
+  role: MATERIALGRAPH_ROLE_VALUES
+};
+export {
+  MATERIALGRAPH_CHARACTER_VALUES,
+  MATERIALGRAPH_COMPOSITIONAL_ROLES,
+  MATERIALGRAPH_CROSSWALK,
+  MATERIALGRAPH_CROSSWALK_VERSION,
+  MATERIALGRAPH_ROLE_VALUES,
+  MATERIALGRAPH_SNAPSHOT,
+  MATERIALGRAPH_SOURCE_FIELDS,
+  MATERIALGRAPH_SOURCE_SYSTEM,
+  MATERIALGRAPH_SOURCE_VALUES,
+  canonicaliseMaterialGraph
+};

package/dist/crosswalks/miu.d.ts

@@ -1,5 +1,6 @@
 import { MaterialFamily, Sector, Application } from '../index.js';
-import '../match-BDI6Evro.js';
+import '../match-CWzTEuL-.js';
+import '../mapping-pvHk5VjC.js';
 import '../taste.js';
 
 declare const MIU_MATERIAL_FAMILIES: readonly ["wood", "wood_veneer", "engineered_wood", "bamboo", "cork", "natural_stone", "terrazzo", "ceramic_porcelain", "glass", "metal", "concrete", "plaster", "clay", "brick", "paint_coating", "wallcovering", "laminate", "solid_surface", "mineral_composite", "resin", "linoleum", "vinyl", "rubber", "carpet", "rug", "textile", "leather", "acoustic_felt", "acoustic_composite", "recycled_composite", "paper_cardboard", "biobased_composite", "greenery_planting", "lighting", "hardware", "digital_media", "water_feature", "mixed_material", "color_palette_only", "unknown"];

package/dist/crosswalks/miu.js

@@ -378,9 +378,15 @@ var MIU_SURFACE_APPLICATION_TO_CANONICAL = {
   // Epistemic sentinel.
   unknown: null
 };
-var MIU_MATERIAL_FAMILY_SET = new Set(MIU_MATERIAL_FAMILIES);
-var MIU_PROJECT_SECTOR_SET = new Set(MIU_PROJECT_SECTORS);
-var MIU_SURFACE_APPLICATION_SET = new Set(MIU_SURFACE_APPLICATIONS);
+var MIU_MATERIAL_FAMILY_SET = new Set(
+  MIU_MATERIAL_FAMILIES
+);
+var MIU_PROJECT_SECTOR_SET = new Set(
+  MIU_PROJECT_SECTORS
+);
+var MIU_SURFACE_APPLICATION_SET = new Set(
+  MIU_SURFACE_APPLICATIONS
+);
 var isMiuMaterialFamily = (value) => MIU_MATERIAL_FAMILY_SET.has(value);
 var isMiuProjectSector = (value) => MIU_PROJECT_SECTOR_SET.has(value);
 var isMiuSurfaceApplication = (value) => MIU_SURFACE_APPLICATION_SET.has(value);

package/dist/estate/index.d.ts

@@ -1,4 +1,4 @@
-import { C as CanonicalAlternatives } from '../match-BDI6Evro.js';
+import { C as CanonicalAlternatives } from '../match-CWzTEuL-.js';
 
 declare const DECOMPOSITION: readonly Row[];