@instruments/taxonomy 0.1.0 → 0.2.0

package/README.md

@@ -6,6 +6,10 @@ The canonical materials taxonomy for the Material Instruments ecosystem: the gov
 is the single publishable home of the Material Semantics vocabularies that were previously vendored
 per-repo as drifting local copies.
 
+It also publishes appearance concepts and a portable taste-assertion contract. Applications own
+their evidence stores and ranking policy; this package owns shared meaning, source crosswalk
+verdicts, and the envelope that lets evidence travel without turning a source label into fact.
+
 ## Install
 
 ```sh
@@ -51,6 +55,77 @@ miuFamilyToCanonical("greenery_planting"); // null (declines to classify)
 MIU_SURFACE_APPLICATION_TO_CANONICAL.railing; // "stair_railing"
 ```
 
+### Canonical bundles and match semantics
+
+Consumers compose qualified assertions into canonical bundles rather than minting app-specific
+compound tags. Every constitutive assertion is required; matched constitutive assertions score 2
+and matched accents score 1. Unroled assertions default to accent, extra candidate annotations are
+not penalised, and the package publishes residential and commercial test vectors so another
+language can reproduce the ranking exactly.
+
+```ts
+import { defineBundle, matchBundle } from "@instruments/taxonomy";
+
+const quietKitchen = defineBundle([
+  { assertion: "space.kitchen", role: "constitutive" },
+  { assertion: "mood.calm" },
+  { assertion: "style.minimalism" },
+]);
+
+matchBundle(quietKitchen, ["space.kitchen", "mood.calm"]);
+// { eligible: true, score: 0.75, ... }
+```
+
+`defineAlternatives` preserves a source term known to have one of several readings without
+guessing. The DesignShop and materia `Modern` crosswalk rows now carry an explicit any-of between
+`style.modernism` and `style.contemporary` instead of disappearing from downstream joins.
+
+### Appearance axes
+
+Product category, specific material, pattern, finish, format and construction are independent
+axes. That separation is deliberate: plain porcelain, geometric porcelain and stone-effect
+porcelain share `material.porcelain` while carrying different pattern concepts. A commercial
+carpet and residential wallcovering use the same pattern semantics; there is no “commercial
+style” branch.
+
+Requirement concepts name dimensions such as slip resistance, availability and fire performance.
+The assertion envelope carries the operator and required value separately, because a taxonomy can
+name the question but cannot assert that a particular product passes it.
+
+### `@instruments/taxonomy/crosswalks/designshop`
+
+The frozen DesignShop vocabulary resolves through a versioned four-state crosswalk:
+
+```ts
+import { canonicaliseDesignShop } from "@instruments/taxonomy/crosswalks/designshop";
+
+canonicaliseDesignShop({
+  provenance: {
+    sourceRecordId: "scheme:123",
+    sourceSnapshotVersion: "designshop-estate-1",
+    sourceSystem: "designshop",
+  },
+  sourceField: "pattern",
+  sourceValue: "Solid",
+});
+// resolved -> pattern.plain
+```
+
+`resolved`, `ambiguous`, `unresolved` and `declined` are different results. Unknown input remains
+unresolved with its raw value intact; only a curated row can decline. `Modern` remains an ambiguous
+choice between contemporary and modernism until another source or a person confirms one reading.
+`DESIGNSHOP_APPEARANCE_TEST_VECTORS` is the executable consumer contract.
+
+### `@instruments/taxonomy/taste`
+
+`PortableTasteAssertion` separates actor, taste subject and project; taste, context and
+requirement roles; canonical and unresolved meaning; scope, authority, polarity, time and
+provenance. It intentionally contains no boost, rank or serving weight. Those are application
+policy, not portable meaning. Requirement assertions additionally carry a typed constraint.
+
+`PORTABLE_ASSERTION_TEST_VECTORS` gives TypeScript and non-TypeScript consumers stable fixtures for
+serialization and contract tests.
+
 ## Provenance and the re-sync ritual
 
 The dictionaries are lifted **verbatim** from materialgraph —

package/dist/chunk-C2ZPDTOU.js

@@ -0,0 +1,151 @@
+// src/match.ts
+var ROLE_WEIGHT = {
+  accent: 1,
+  constitutive: 2
+};
+var MATCH_WEIGHTS = ROLE_WEIGHT;
+var DEFAULT_BUNDLE_ROLE = "accent";
+var checkedAssertion = (assertion) => {
+  const normalized = assertion.trim();
+  if (normalized.length === 0) {
+    throw new Error("a canonical assertion cannot be empty");
+  }
+  return normalized;
+};
+var defineBundle = (inputs) => {
+  if (inputs.length === 0) {
+    throw new Error("a canonical bundle must contain at least one assertion");
+  }
+  const byAssertion = /* @__PURE__ */ new Map();
+  for (const input of inputs) {
+    const assertion = checkedAssertion(input.assertion);
+    const role = input.role ?? DEFAULT_BUNDLE_ROLE;
+    const previous = byAssertion.get(assertion);
+    byAssertion.set(assertion, previous === "constitutive" ? previous : role);
+  }
+  const members = [...byAssertion].map(([assertion, role]) => ({ assertion, role })).toSorted((a, b) => a.assertion.localeCompare(b.assertion) || a.role.localeCompare(b.role));
+  const serialization = members.map(({ assertion, role }) => `${role}:${assertion}`).join("|");
+  return {
+    id: `bundle:${encodeURIComponent(serialization)}`,
+    kind: "all-of",
+    members,
+    serialization
+  };
+};
+var defineAlternatives = (inputs, reason) => {
+  const bySerialization = /* @__PURE__ */ new Map();
+  for (const input of inputs) {
+    const bundle = "kind" in input ? input : defineBundle(input);
+    bySerialization.set(bundle.serialization, bundle);
+  }
+  const alternatives = [...bySerialization.values()].toSorted(
+    (a, b) => a.serialization.localeCompare(b.serialization)
+  );
+  if (alternatives.length < 2) {
+    throw new Error("canonical alternatives must contain at least two distinct bundles");
+  }
+  const serialization = alternatives.map(({ id }) => id).join("||");
+  return {
+    alternatives,
+    id: `alternatives:${encodeURIComponent(serialization)}`,
+    kind: "any-of",
+    reason,
+    serialization
+  };
+};
+var matchBundle = (bundle, candidateAssertions) => {
+  const candidate = new Set(candidateAssertions);
+  const matched = bundle.members.filter(({ assertion }) => candidate.has(assertion));
+  const missing = bundle.members.filter(({ assertion }) => !candidate.has(assertion));
+  const missingConstitutive = missing.filter(({ role }) => role === "constitutive").map(({ assertion }) => assertion);
+  const missingAccents = missing.filter(({ role }) => role === "accent").map(({ assertion }) => assertion);
+  const eligible = missingConstitutive.length === 0;
+  const availableWeight = bundle.members.reduce((sum, { role }) => sum + ROLE_WEIGHT[role], 0);
+  const matchedWeight = matched.reduce((sum, { role }) => sum + ROLE_WEIGHT[role], 0);
+  return {
+    eligible,
+    matched: matched.map(({ assertion }) => assertion),
+    missingAccents,
+    missingConstitutive,
+    score: eligible ? matchedWeight / availableWeight : 0
+  };
+};
+var matchAlternatives = (alternatives, candidateAssertions) => {
+  const assertions = [...candidateAssertions];
+  const ranked = alternatives.alternatives.map((alternative) => ({ alternative, match: matchBundle(alternative, assertions) })).toSorted(
+    (a, b) => Number(b.match.eligible) - Number(a.match.eligible) || b.match.score - a.match.score || a.alternative.id.localeCompare(b.alternative.id)
+  );
+  const [strongest] = ranked;
+  if (strongest === void 0) {
+    throw new Error("canonical alternatives contain no bundles");
+  }
+  return strongest;
+};
+var COTTAGE = "evokes(typology.cottage)";
+var COTSWOLDS = "evokes(place.region.cotswolds)";
+var SHELTERING = "mood.sheltering";
+var GREEN = "palette.hue.green";
+var RESTAURANT = "space.restaurant";
+var INDUSTRIAL = "style.industrial";
+var MOODY = "mood.moody";
+var COOL = "palette.temperature.cool";
+var MATCH_TEST_VECTORS = [
+  {
+    candidates: [
+      {
+        assertions: [COTTAGE, COTSWOLDS, SHELTERING, GREEN],
+        id: "residential-exact"
+      },
+      {
+        assertions: [COTTAGE, SHELTERING, GREEN],
+        id: "residential-near"
+      },
+      {
+        assertions: [COTSWOLDS, SHELTERING, GREEN],
+        id: "residential-wrong-building"
+      }
+    ],
+    expectedEligibleOrder: ["residential-exact", "residential-near"],
+    id: "cotswolds-green-cosy-cottage",
+    query: defineBundle([
+      { assertion: COTTAGE, role: "constitutive" },
+      { assertion: COTSWOLDS },
+      { assertion: SHELTERING },
+      { assertion: GREEN }
+    ])
+  },
+  {
+    candidates: [
+      {
+        assertions: [RESTAURANT, INDUSTRIAL, MOODY, COOL],
+        id: "commercial-exact"
+      },
+      {
+        assertions: [RESTAURANT, INDUSTRIAL, MOODY],
+        id: "commercial-near"
+      },
+      {
+        assertions: ["typology.restaurant", INDUSTRIAL, MOODY],
+        id: "commercial-wrong-scale"
+      }
+    ],
+    expectedEligibleOrder: ["commercial-exact", "commercial-near"],
+    id: "moody-industrial-restaurant",
+    query: defineBundle([
+      { assertion: RESTAURANT, role: "constitutive" },
+      { assertion: INDUSTRIAL, role: "constitutive" },
+      { assertion: MOODY },
+      { assertion: COOL }
+    ])
+  }
+];
+
+export {
+  MATCH_WEIGHTS,
+  DEFAULT_BUNDLE_ROLE,
+  defineBundle,
+  defineAlternatives,
+  matchBundle,
+  matchAlternatives,
+  MATCH_TEST_VECTORS
+};

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-XLUE3IC2.js

@@ -0,0 +1,94 @@
+// 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/crosswalks/designshop.d.ts

@@ -0,0 +1,41 @@
+import { CanonicalisationInput, CanonicalisationVerdict } from '../taste.js';
+import { B as BundleMemberInput } from '../match-BDI6Evro.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;
+};
+/**
+ * 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,281 @@
+import {
+  TAXONOMY_SNAPSHOT_VERSION
+} from "../chunk-XLUE3IC2.js";
+import {
+  defineAlternatives,
+  defineBundle
+} from "../chunk-C2ZPDTOU.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 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. */
+  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"),
+    Gloss: constitutive("finish.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": constitutive("material.composite"),
+    Interior: {
+      reason: "A catalogue location masquerading as a material value.",
+      status: "declined"
+    },
+    Laminate: constitutive("material.laminate"),
+    Mosaic: constitutive("format.modular"),
+    Natural: constitutive("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": constitutive("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: constitutive("pattern.natural-motif"),
+    Novelty: constitutive("pattern.novelty"),
+    "Plaid / Check / Houndstooth": constitutive("pattern.plaid-check"),
+    Scenic: constitutive("pattern.scenic"),
+    Solid: constitutive("pattern.plain"),
+    "Stone Effect": constitutive("pattern.stone-effect"),
+    "Strie / Ombre / Gradient": constitutive("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": constitutive("style.traditional"),
+    Coastal: constitutive("evokes(place.landscape.coastal)"),
+    Contemporary: constitutive("style.contemporary"),
+    "Country/ Cottage": resolved("evokes(typology.cottage)", "style.traditional"),
+    Eclectic: constitutive("style.eclectic"),
+    Farmhouse: resolved("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"),
+    Rustic: constitutive("style.rustic"),
+    Scandinavian: constitutive("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("evokes(place.region.english-country)", "evokes(typology.farmhouse)"),
+    Eclectic: constitutive("style.eclectic"),
+    Farmhouse: resolved("evokes(typology.farmhouse)", "style.rustic"),
+    Minimalist: constitutive("style.minimalism"),
+    Modern: ambiguous("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"),
+      status: "ambiguous"
+    };
+  }
+  return { ...base, canonical: defineBundle(mapping.assertions), status: "resolved" };
+};
+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
+};