@instruments/taxonomy 0.1.0 → 0.3.0

package/dist/chunk-CTKOLWGS.js

@@ -0,0 +1,23 @@
+// src/canonicalisation.ts
+var assertionMeaningFrom = (verdict) => {
+  const source = {
+    crosswalkVersion: verdict.crosswalkVersion,
+    sourceField: verdict.sourceField,
+    sourceValue: verdict.sourceValue,
+    taxonomySnapshotVersion: verdict.taxonomySnapshotVersion
+  };
+  if (verdict.status === "resolved") {
+    return { ...source, canonical: verdict.canonical, kind: "resolved" };
+  }
+  if (verdict.status === "ambiguous") {
+    return { ...source, alternatives: verdict.alternatives, kind: "ambiguous" };
+  }
+  if (verdict.status === "unresolved") {
+    return { ...source, kind: "unresolved" };
+  }
+  return null;
+};
+
+export {
+  assertionMeaningFrom
+};

package/dist/chunk-FCMCKNQF.js

@@ -0,0 +1,103 @@
+// src/taste-assertion.ts
+var TASTE_ASSERTION_CONTRACT_VERSION = "1.0.0";
+var TAXONOMY_SNAPSHOT_VERSION = "2026-08-25";
+var FIXTURE_ACTOR_ID = "person:designer-1";
+var FIXTURE_PROJECT_ID = "project:hotel-1";
+var FIXTURE_SUBJECT_ID = "client:hotel-operator-1";
+var RESOLVED = "resolved";
+var baseFixture = {
+  actorId: FIXTURE_ACTOR_ID,
+  confirmedAt: "2026-08-25T09:00:10.000Z",
+  contractVersion: TASTE_ASSERTION_CONTRACT_VERSION,
+  observedAt: "2026-08-25T09:00:00.000Z",
+  projectId: FIXTURE_PROJECT_ID,
+  provenance: {
+    observationId: "observation:1",
+    sourceSnapshotVersion: "demo-estate-1",
+    sourceSystem: "designshop"
+  },
+  subjectId: FIXTURE_SUBJECT_ID
+};
+var PORTABLE_ASSERTION_TEST_VECTORS = [
+  {
+    assertion: {
+      ...baseFixture,
+      authority: "explicit",
+      id: "assertion:taste-plain-porcelain",
+      meaning: {
+        canonical: {
+          id: "bundle:constitutive%3Amaterial.porcelain%7Caccent%3Apattern.plain",
+          kind: "all-of",
+          members: [
+            { assertion: "material.porcelain", role: "constitutive" },
+            { assertion: "pattern.plain", role: "accent" }
+          ],
+          serialization: "constitutive:material.porcelain|accent:pattern.plain"
+        },
+        crosswalkVersion: "designshop-2026-08-25.1",
+        kind: RESOLVED,
+        sourceField: "confirmed_correction",
+        sourceValue: "porcelain stayed; pattern did not",
+        taxonomySnapshotVersion: TAXONOMY_SNAPSHOT_VERSION
+      },
+      polarity: "positive",
+      role: "taste",
+      scope: { kind: "room", roomId: "room:kitchen" }
+    },
+    expected: {
+      actorId: FIXTURE_ACTOR_ID,
+      meaningKind: RESOLVED,
+      projectId: FIXTURE_PROJECT_ID,
+      role: "taste",
+      subjectId: FIXTURE_SUBJECT_ID
+    },
+    id: "client-taste-does-not-belong-to-the-designer"
+  },
+  {
+    assertion: {
+      ...baseFixture,
+      authority: "explicit",
+      constraint: { operator: "at_least", unit: "PTV", value: 36 },
+      id: "assertion:requirement-slip",
+      meaning: {
+        canonical: {
+          id: "bundle:constitutive%3Arequirement.slip-resistance",
+          kind: "all-of",
+          members: [
+            {
+              assertion: "requirement.slip-resistance",
+              role: "constitutive"
+            }
+          ],
+          serialization: "constitutive:requirement.slip-resistance"
+        },
+        crosswalkVersion: "designshop-2026-08-25.1",
+        kind: RESOLVED,
+        sourceField: "requirement",
+        sourceValue: "Slip resistance",
+        taxonomySnapshotVersion: TAXONOMY_SNAPSHOT_VERSION
+      },
+      polarity: "positive",
+      role: "requirement",
+      scope: {
+        kind: "surface",
+        roomId: "room:lobby",
+        surfaceId: "surface:floor"
+      }
+    },
+    expected: {
+      actorId: FIXTURE_ACTOR_ID,
+      meaningKind: RESOLVED,
+      projectId: FIXTURE_PROJECT_ID,
+      role: "requirement",
+      subjectId: FIXTURE_SUBJECT_ID
+    },
+    id: "commercial-requirement-uses-the-same-envelope"
+  }
+];
+
+export {
+  TASTE_ASSERTION_CONTRACT_VERSION,
+  TAXONOMY_SNAPSHOT_VERSION,
+  PORTABLE_ASSERTION_TEST_VECTORS
+};

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

@@ -0,0 +1,33 @@
+import { CanonicalisationInput, CanonicalisationVerdict } from '../taste.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 = 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
+ * category error instead of its evidence.
+ */
+declare const DESIGNSHOP_CROSSWALK: Readonly<Record<DesignShopSourceField, Readonly<Record<string, Mapping>>>>;
+interface DesignShopCanonicalisationInput extends Omit<CanonicalisationInput, "sourceSystem" | "sourceField"> {
+    sourceField: DesignShopSourceField;
+}
+/** Unknown values are unresolved, never declined. Declines require an explicit curated row. */
+declare const canonicaliseDesignShop: (input: DesignShopCanonicalisationInput) => CanonicalisationVerdict;
+interface DesignShopAppearanceTestVector {
+    expectedAssertions: readonly string[];
+    facets: readonly {
+        sourceField: DesignShopSourceField;
+        sourceValue: string;
+    }[];
+    id: string;
+    market: "residential" | "commercial";
+}
+/** Shared fixtures prove axes compose instead of welding material identity to appearance. */
+declare const DESIGNSHOP_APPEARANCE_TEST_VECTORS: readonly DesignShopAppearanceTestVector[];
+
+export { DESIGNSHOP_APPEARANCE_TEST_VECTORS, DESIGNSHOP_CROSSWALK, DESIGNSHOP_CROSSWALK_VERSION, DESIGNSHOP_SOURCE_FIELDS, DESIGNSHOP_SOURCE_SYSTEM, type DesignShopAppearanceTestVector, type DesignShopCanonicalisationInput, type DesignShopSourceField, canonicaliseDesignShop };

package/dist/crosswalks/designshop.js

@@ -0,0 +1,363 @@
+import {
+  ambiguous,
+  approximates,
+  constitutive,
+  declined,
+  resolved
+} from "../chunk-WIRA24HM.js";
+import {
+  TAXONOMY_SNAPSHOT_VERSION
+} from "../chunk-FCMCKNQF.js";
+import {
+  defineAlternatives,
+  defineBundle
+} from "../chunk-4ECRPD2I.js";
+
+// src/crosswalks/designshop.ts
+var DESIGNSHOP_CROSSWALK_VERSION = "designshop-2026-08-25.1";
+var DESIGNSHOP_SOURCE_SYSTEM = "designshop";
+var DESIGNSHOP_SOURCE_FIELDS = [
+  "product_category",
+  "material",
+  "pattern",
+  "finish",
+  "format",
+  "construction",
+  "scheme_style",
+  "product_style",
+  "mood",
+  "space",
+  "requirement"
+];
+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. */
+  construction: {
+    Encaustic: constitutive("construction.encaustic"),
+    "Engineered Hardwood": constitutive("construction.engineered-hardwood"),
+    Handcrafted: constitutive("construction.handcrafted"),
+    Handmade: constitutive("construction.handmade"),
+    Handwoven: constitutive("construction.handwoven"),
+    "High Pressure Laminate": constitutive(
+      "construction.high-pressure-laminate"
+    ),
+    Laminated: constitutive("construction.laminated"),
+    "Loop Pile": constitutive("construction.loop-pile"),
+    "Luxury Vinyl": constitutive("construction.luxury-vinyl"),
+    "Non-Woven": constitutive("construction.non-woven"),
+    "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"
+    ),
+    Sintered: constitutive("construction.sintered"),
+    "Through Body": constitutive("construction.through-body"),
+    Woven: constitutive("construction.woven")
+  },
+  finish: {
+    Glazed: constitutive("finish.glazed"),
+    // `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"),
+    Polished: constitutive("finish.polished")
+  },
+  format: {
+    "Area Rug": constitutive("format.area-rug"),
+    Hide: constitutive("format.hide"),
+    Liquid: constitutive("format.liquid"),
+    Modular: constitutive("format.modular"),
+    Mural: constitutive("format.mural"),
+    Panel: constitutive("format.panel"),
+    Plank: constitutive("format.plank"),
+    Roll: constitutive("format.roll"),
+    Slab: constitutive("format.slab"),
+    Tile: constitutive("format.tile"),
+    "Wide Plank": constitutive("format.wide-plank")
+  },
+  material: {
+    "Carpet Tiles": resolved(
+      "product-category.carpet-and-rug",
+      "format.modular"
+    ),
+    Ceramic: constitutive("material.ceramic"),
+    "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: 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"),
+    Stone: constitutive("material.stone"),
+    Vinyl: constitutive("material.vinyl")
+  },
+  mood: {
+    Airy: constitutive("mood.airy"),
+    Calm: constitutive("mood.calm"),
+    Dramatic: constitutive("mood.dramatic"),
+    Sheltering: constitutive("mood.sheltering")
+  },
+  pattern: {
+    "Abstract / Organic": constitutive("pattern.abstract-organic"),
+    "Animal Print": constitutive("pattern.animal-print"),
+    Botanical: constitutive("pattern.botanical"),
+    "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"),
+    "Herringbone / Chevron": constitutive("pattern.herringbone-chevron"),
+    "Leather Effect": constitutive("pattern.leather-effect"),
+    Marbleized: constitutive("pattern.marbleised"),
+    "Metal Effect": constitutive("pattern.metal-effect"),
+    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": 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": 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"),
+    "Whimsy & Character": constitutive("pattern.character"),
+    "Woodgrain Effect": constitutive("pattern.woodgrain-effect"),
+    "Woven Effect": constitutive("pattern.woven-effect")
+  },
+  product_category: {
+    "Carpets & Rugs": constitutive("product-category.carpet-and-rug"),
+    Countertops: constitutive("product-category.countertop"),
+    Flooring: constitutive("product-category.flooring"),
+    Tile: constitutive("product-category.tile"),
+    Wallcovering: constitutive("product-category.wallcovering")
+  },
+  product_style: {
+    "Art Deco": constitutive("style.art-deco"),
+    "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": 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: 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("close", "style.modernism", "style.contemporary"),
+    Rustic: constitutive("style.rustic"),
+    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: {
+    "Acoustic performance": constitutive("requirement.acoustic-performance"),
+    Availability: constitutive("requirement.availability"),
+    Budget: constitutive("requirement.budget"),
+    "Fire performance": constitutive("requirement.fire-performance"),
+    "Indoor air quality": constitutive("requirement.indoor-air-quality"),
+    "Installation method": constitutive("requirement.installation-method"),
+    "Lead time": constitutive("requirement.lead-time"),
+    Maintenance: constitutive("requirement.maintenance"),
+    "Slip resistance": constitutive("requirement.slip-resistance"),
+    "Wet-area suitability": constitutive("requirement.wet-area-suitability")
+  },
+  scheme_style: {
+    Coastal: constitutive("evokes(place.landscape.coastal)"),
+    Contemporary: constitutive("style.contemporary"),
+    Country: ambiguous(
+      "close",
+      "evokes(place.region.english-country)",
+      "evokes(typology.farmhouse)"
+    ),
+    Eclectic: constitutive("style.eclectic"),
+    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("close", "style.modernism", "style.contemporary"),
+    Traditional: constitutive("style.traditional"),
+    Transitional: constitutive("style.transitional")
+  },
+  space: {
+    Bathroom: constitutive("room.bathroom"),
+    Kitchen: constitutive("room.kitchen"),
+    Lobby: constitutive("space.lobby"),
+    Restaurant: constitutive("room.restaurant")
+  }
+  /* oxlint-enable sonarjs/no-duplicate-string */
+};
+var canonicaliseDesignShop = (input) => {
+  const base = {
+    crosswalkVersion: DESIGNSHOP_CROSSWALK_VERSION,
+    provenance: input.provenance,
+    sourceField: input.sourceField,
+    sourceSystem: DESIGNSHOP_SOURCE_SYSTEM,
+    sourceValue: input.sourceValue,
+    taxonomySnapshotVersion: TAXONOMY_SNAPSHOT_VERSION
+  };
+  const mapping = DESIGNSHOP_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 DESIGNSHOP_APPEARANCE_TEST_VECTORS = [
+  {
+    expectedAssertions: [
+      "material.porcelain",
+      "pattern.plain",
+      "product-category.tile"
+    ],
+    facets: [
+      { sourceField: "product_category", sourceValue: "Tile" },
+      { sourceField: "material", sourceValue: "Porcelain" },
+      { sourceField: "pattern", sourceValue: "Solid" }
+    ],
+    id: "residential-plain-porcelain",
+    market: "residential"
+  },
+  {
+    expectedAssertions: [
+      "material.porcelain",
+      "pattern.geometric",
+      "product-category.tile"
+    ],
+    facets: [
+      { sourceField: "product_category", sourceValue: "Tile" },
+      { sourceField: "material", sourceValue: "Porcelain" },
+      { sourceField: "pattern", sourceValue: "Geometric" }
+    ],
+    id: "residential-patterned-porcelain",
+    market: "residential"
+  },
+  {
+    expectedAssertions: [
+      "material.porcelain",
+      "pattern.stone-effect",
+      "product-category.tile"
+    ],
+    facets: [
+      { sourceField: "product_category", sourceValue: "Tile" },
+      { sourceField: "material", sourceValue: "Porcelain" },
+      { sourceField: "pattern", sourceValue: "Stone Effect" }
+    ],
+    id: "residential-stone-effect-porcelain",
+    market: "residential"
+  },
+  {
+    expectedAssertions: [
+      "construction.loop-pile",
+      "format.modular",
+      "pattern.geometric",
+      "product-category.carpet-and-rug"
+    ],
+    facets: [
+      { sourceField: "product_category", sourceValue: "Carpets & Rugs" },
+      { sourceField: "format", sourceValue: "Modular" },
+      { sourceField: "construction", sourceValue: "Loop Pile" },
+      { sourceField: "pattern", sourceValue: "Geometric" }
+    ],
+    id: "commercial-patterned-carpet",
+    market: "commercial"
+  },
+  {
+    expectedAssertions: [
+      "construction.non-woven",
+      "format.roll",
+      "material.paper",
+      "pattern.botanical",
+      "product-category.wallcovering"
+    ],
+    facets: [
+      { sourceField: "product_category", sourceValue: "Wallcovering" },
+      { sourceField: "material", sourceValue: "Paper" },
+      { sourceField: "format", sourceValue: "Roll" },
+      { sourceField: "construction", sourceValue: "Non-Woven" },
+      { sourceField: "pattern", sourceValue: "Botanical" }
+    ],
+    id: "residential-patterned-wallcovering",
+    market: "residential"
+  }
+];
+export {
+  DESIGNSHOP_APPEARANCE_TEST_VECTORS,
+  DESIGNSHOP_CROSSWALK,
+  DESIGNSHOP_CROSSWALK_VERSION,
+  DESIGNSHOP_SOURCE_FIELDS,
+  DESIGNSHOP_SOURCE_SYSTEM,
+  canonicaliseDesignShop
+};

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 };