@instruments/taxonomy 1.1.0 → 1.1.1

package/dist/index.d.ts

@@ -201,8 +201,8 @@ type RelationPredicate =
  | "related-to";
 
 declare const TAXONOMY_BASE_URI: "https://taxonomy.materialinstruments.com";
-declare const TAXONOMY_SNAPSHOT: "2026-08-30";
-declare const TAXONOMY_VERSION: "1.1.0";
+declare const TAXONOMY_SNAPSHOT: "2026-08-31";
+declare const TAXONOMY_VERSION: "1.1.1";
 type CanonicalConceptUri = `${typeof TAXONOMY_BASE_URI}/id/${string}`;
 type LifecycleStatus = "active" | "deprecated";
 interface Lifecycle {
@@ -335,8 +335,8 @@ declare const TAXONOMY_CORPUS_METADATA: {
     readonly lexicalEntryCount: number;
     readonly nodeCount: number;
     readonly revision: string;
-    readonly snapshot: "2026-08-30";
-    readonly version: "1.1.0";
+    readonly snapshot: "2026-08-31";
+    readonly version: "1.1.1";
 };
 
 export { type AxisNode, COLOR_SCOPE_REFERENCE_KINDS, type CanonicalConceptUri, type ColorScopeReferenceKind, type ColorScopeTarget, type ConceptNode, type ExternalReference, type FacetNode, type Governance, type GraphPredicate, KNOWLEDGE_GRAPH, type KnowledgeGraph, type KnowledgeGraphEdge, type KnowledgeGraphNode, LEXICAL_ENTRIES, type LexicalContext, type LexicalEntry, type LexicalTarget, type Lifecycle, type LifecycleStatus, type PeriodSpan, type SearchedWithout, type StyleKind, TAXONOMY_BASE_URI, TAXONOMY_CORPUS_METADATA, TAXONOMY_CORPUS_REVISION, TAXONOMY_SNAPSHOT, TAXONOMY_VERSION, type TaxonomyTarget, type TermProvenance, type TermUsage, type UsageWithheld };

package/dist/index.js

@@ -1251,14 +1251,28 @@ var FINISH_TERMS = [
   ...FINISH_TEXTURE_TERMS
 ];
 
+// src/search-corpus-source.ts
+var MATERIALGRAPH_SEARCH_CORPUS_COMMIT = "53df40868bfb09bfe69bc66c455c051e34005ae1";
+var MATERIALGRAPH_SEARCH_CORPUS_PATH = "packages/products/src/benchmark/fixtures/benchmark-cases-2026-07-31.1.json";
+var MATERIALGRAPH_SEARCH_CORPUS_SNAPSHOT = "2026-07-31";
+var MATERIALGRAPH_SEARCH_CORPUS = `materialgraph@${MATERIALGRAPH_SEARCH_CORPUS_COMMIT}:${MATERIALGRAPH_SEARCH_CORPUS_PATH}`;
+var searchCorpusEvidence = (phrases) => `${MATERIALGRAPH_SEARCH_CORPUS} (244-query external search corpus; phrase and admission evidence: ${phrases}; canonical boundary authored by Taxonomy)`;
+
 // src/axes/format.ts
 var SOURCE2 = "DesignShop frozen estate format vocabulary";
 var SNAPSHOT2 = "2026-08-25";
-var term3 = (slug, label, definition) => ({
+var SEARCH_REVIEW_DATE = "2026-08-31";
+var searchCorpusProvenance = (evidence) => ({
+  basis: "evidenced",
+  snapshot: MATERIALGRAPH_SEARCH_CORPUS_SNAPSHOT,
+  source: searchCorpusEvidence(evidence)
+});
+var term3 = (slug, label, definition, extra = {}) => ({
   definition,
   label,
   provenance: { basis: "evidenced", snapshot: SNAPSHOT2, source: SOURCE2 },
-  slug
+  slug,
+  ...extra
 });
 var FORMAT_TERMS = [
   term3("area-rug", "Area rug", "A bounded loose-laid textile floor covering."),
@@ -1282,6 +1296,16 @@ var FORMAT_TERMS = [
     "Mural",
     "Supplied as a multi-panel image composed into one continuous scene."
   ),
+  term3(
+    "mosaic",
+    "Mosaic",
+    "Supplied as small pieces assembled or mounted together to install as one composed field, independent of material and visible motif.",
+    {
+      introducedAt: SEARCH_REVIEW_DATE,
+      provenance: searchCorpusProvenance("mosaic"),
+      reviewedAt: SEARCH_REVIEW_DATE
+    }
+  ),
   term3(
     "panel",
     "Panel",
@@ -1303,6 +1327,28 @@ var FORMAT_TERMS = [
     "A large rigid sheet intended to minimise joints or be fabricated to shape."
   ),
   term3("tile", "Tile", "A discrete modular surface unit."),
+  term3(
+    "penny-round",
+    "Penny round",
+    "A small round tile unit supplied for installation as a field, independent of its material and the layout made from it.",
+    {
+      altLabels: ["penny tile"],
+      broaderSlug: "tile",
+      introducedAt: SEARCH_REVIEW_DATE,
+      provenance: searchCorpusProvenance("penny-tile"),
+      reviewedAt: SEARCH_REVIEW_DATE
+    }
+  ),
+  term3(
+    "veneer",
+    "Veneer",
+    "A thin facing layer supplied to be bonded or fixed to a substrate, independent of the material from which the facing is made.",
+    {
+      introducedAt: SEARCH_REVIEW_DATE,
+      provenance: searchCorpusProvenance("veneer"),
+      reviewedAt: SEARCH_REVIEW_DATE
+    }
+  ),
   term3(
     "wide-plank",
     "Wide plank",
@@ -1341,6 +1387,19 @@ var standardCrossoverTerm = (slug, label, definition, source) => ({
     source
   }
 });
+var searchCorpusMaterial = (slug, label, definition, broaderSlug, referenceSource) => ({
+  broaderSlug,
+  definition,
+  introducedAt: "2026-08-31",
+  label,
+  provenance: {
+    basis: "evidenced",
+    snapshot: MATERIALGRAPH_SEARCH_CORPUS_SNAPSHOT,
+    source: `${searchCorpusEvidence(label)}; ${referenceSource}`
+  },
+  reviewedAt: "2026-08-31",
+  slug
+});
 var MATERIAL_TERMS = [
   crossoverTerm(
     "brass",
@@ -1433,6 +1492,13 @@ var MATERIAL_TERMS = [
     "An iron-carbon alloy family spanning many grades rather than one uniform product.",
     CROSSOVER_DEFINITION_SOURCES.steel
   ),
+  searchCorpusMaterial(
+    "stainless-steel",
+    "Stainless steel",
+    "A corrosion-resistant steel alloy family containing sufficient chromium to form a protective passive layer, named as a bulk material rather than a surface finish or colour.",
+    "steel",
+    CROSSOVER_DEFINITION_SOURCES.steel
+  ),
   crossoverTerm(
     "wood",
     "Wood",
@@ -1446,6 +1512,13 @@ var MATERIAL_TERMS = [
     CROSSOVER_DEFINITION_SOURCES.oak,
     "wood"
   ),
+  searchCorpusMaterial(
+    "white-oak",
+    "White oak",
+    "Timber from the white-oak species group within the genus Quercus, named as a wood material rather than a colour or surface finish.",
+    "oak",
+    CROSSOVER_DEFINITION_SOURCES.oak
+  ),
   crossoverTerm(
     "teak",
     "Teak",
@@ -2673,8 +2746,8 @@ var uniclass2 = (slug, label, match) => ({
   match,
   scheme: "uniclass"
 });
-var searchedUniclass = (query) => ({
-  date: "2026-08-27",
+var searchedUniclass = (query, date = "2026-08-27") => ({
+  date,
   query,
   scheme: "uniclass",
   via: "uniclass.thenbs.com/taxon, Pr table walked from Pr_20 to Pr_90"
@@ -2683,6 +2756,7 @@ var ESTATE2 = "DesignShop frozen estate and Material Instruments product vocabul
 var ESTATE_SNAPSHOT2 = "2026-08-25";
 var CORPUS2 = "Material Bank catalogue, us_hierarchy_category_v2 level-2 rollup";
 var CORPUS_SNAPSHOT2 = "2026-08-27";
+var SEARCH_REVIEW_DATE2 = "2026-08-31";
 var term6 = (slug, label, definition, extra = {}) => ({
   definition,
   label,
@@ -2697,6 +2771,19 @@ var fromCorpus = (slug, label, definition, extra = {}) => ({
   slug,
   ...extra
 });
+var fromSearchCorpus = (slug, label, definition, extra = {}) => ({
+  definition,
+  introducedAt: SEARCH_REVIEW_DATE2,
+  label,
+  provenance: {
+    basis: "evidenced",
+    snapshot: MATERIALGRAPH_SEARCH_CORPUS_SNAPSHOT,
+    source: searchCorpusEvidence(label)
+  },
+  reviewedAt: SEARCH_REVIEW_DATE2,
+  slug,
+  ...extra
+});
 var PRODUCT_CATEGORY_TERMS = [
   term6(
     "tile",
@@ -2711,13 +2798,16 @@ var PRODUCT_CATEGORY_TERMS = [
     "Carpet and rug",
     "A textile floor covering, fixed or loose laid.",
     {
+      altLabels: ["carpet", "rug"],
       external: [
         uniclass2(
           "Pr_35_57_11",
           "Carpets, carpet tiles, coverings, underlays and mats",
           "exact"
         )
-      ]
+      ],
+      introducedAt: "2026-08-30",
+      reviewedAt: "2026-08-31"
     }
   ),
   term6(
@@ -2886,6 +2976,113 @@ var PRODUCT_CATEGORY_TERMS = [
     "Ceiling system",
     "A suspended or applied ceiling product supplied with its own grid, carrier or fixing method.",
     { external: [uniclass2("Pr_35_93_13", "Ceiling infill units", "close")] }
+  ),
+  fromSearchCorpus(
+    "sconce",
+    "Sconce",
+    "A wall-mounted luminaire supplied as a complete light fitting, not the wall it mounts to or the light effect it produces.",
+    {
+      altLabels: ["wall sconce", "wall light"],
+      broaderSlug: "luminaire",
+      searchedWithout: [
+        searchedUniclass("sconce, wall sconce, wall light", SEARCH_REVIEW_DATE2)
+      ]
+    }
+  ),
+  fromSearchCorpus(
+    "chandelier",
+    "Chandelier",
+    "A suspended decorative luminaire with multiple arms, branches or light sources, independent of the ceiling system supporting it.",
+    {
+      broaderSlug: "luminaire",
+      external: [uniclass2("Pr_70_70_48_13", "Chandeliers", "exact")]
+    }
+  ),
+  fromSearchCorpus(
+    "pendant-luminaire",
+    "Pendant luminaire",
+    "A luminaire suspended from above as an individual fitting, distinct from its cable, track or ceiling support.",
+    {
+      altLabels: ["pendant", "pendant light"],
+      broaderSlug: "luminaire",
+      external: [uniclass2("Pr_70_70_48_62", "Pendant luminaires", "exact")]
+    }
+  ),
+  fromSearchCorpus(
+    "track-luminaire",
+    "Track luminaire",
+    "A luminaire made to attach to and draw power from a lighting track, distinct from the track and its electrical accessories.",
+    {
+      altLabels: ["track lighting", "track light"],
+      broaderSlug: "luminaire",
+      searchedWithout: [
+        searchedUniclass("track luminaire, track light", SEARCH_REVIEW_DATE2)
+      ]
+    }
+  ),
+  fromSearchCorpus(
+    "sofa",
+    "Sofa",
+    "An upholstered seating product for two or more people, independent of its upholstery material or room placement.",
+    {
+      altLabels: ["couch"],
+      broaderSlug: "seating",
+      external: [uniclass2("Pr_40_50_12_81", "Sofas", "exact")]
+    }
+  ),
+  fromSearchCorpus(
+    "mosaic-tile",
+    "Mosaic tile",
+    "A tile product composed of small tesserae supplied loose or mounted for installation as a field, independent of their material or visible motif.",
+    {
+      altLabels: ["mosaic"],
+      broaderSlug: "tile",
+      external: [uniclass2("Pr_35_93_96_53", "Mosaic tiles", "exact")]
+    }
+  ),
+  fromSearchCorpus(
+    "wall-panel",
+    "Wall panel",
+    "A panel product supplied to form or cover the visible face of a wall, independent of the panel material and the wall element behind it.",
+    {
+      altLabels: ["wall panelling", "wall paneling"],
+      broaderSlug: "wallcovering",
+      searchedWithout: [
+        searchedUniclass(
+          "wall panel, wall panelling, wall paneling",
+          SEARCH_REVIEW_DATE2
+        )
+      ]
+    }
+  ),
+  fromSearchCorpus(
+    "acoustic-ceiling-system",
+    "Acoustic ceiling system",
+    "A ceiling system specified to absorb or control sound, independent of the material, module format or space in which it is installed.",
+    {
+      altLabels: ["acoustic ceiling"],
+      broaderSlug: "ceiling-system",
+      searchedWithout: [
+        searchedUniclass(
+          "acoustic ceiling system, acoustic ceiling",
+          SEARCH_REVIEW_DATE2
+        )
+      ]
+    }
+  ),
+  fromSearchCorpus(
+    "upholstery-textile",
+    "Upholstery textile",
+    "A textile product supplied for covering furniture, distinct from the furniture, the upholstery application and the fibre or hide material.",
+    {
+      broaderSlug: "textile",
+      searchedWithout: [
+        searchedUniclass(
+          "upholstery textile, upholstery fabric",
+          SEARCH_REVIEW_DATE2
+        )
+      ]
+    }
   )
 ];
 
@@ -6916,8 +7113,9 @@ var resolveReference = (reference) => INDEX.byKey.get(canonicalKey(reference));
 
 // src/v1.ts
 var TAXONOMY_BASE_URI = "https://taxonomy.materialinstruments.com";
-var TAXONOMY_SNAPSHOT = "2026-08-30";
-var TAXONOMY_VERSION = "1.1.0";
+var TAXONOMY_SNAPSHOT = "2026-08-31";
+var TAXONOMY_VERSION = "1.1.1";
+var PUBLISHED_V1_BASELINE = "2026-08-30";
 var compareText = (left, right) => {
   if (left < right) {
     return -1;
@@ -6952,8 +7150,8 @@ var lifecycleFor = (term8) => {
     successorAxis.facets.length > 1 || successorAxis.facets[0]?.slug !== successorAxis.slug
   );
   return {
-    introducedAt: TAXONOMY_SNAPSHOT,
-    reviewedAt: TAXONOMY_SNAPSHOT,
+    introducedAt: term8?.introducedAt ?? PUBLISHED_V1_BASELINE,
+    reviewedAt: term8?.reviewedAt ?? term8?.introducedAt ?? PUBLISHED_V1_BASELINE,
     status: term8?.status ?? "active",
     ...supersededBy === void 0 ? {} : { supersededBy }
   };
@@ -7172,9 +7370,9 @@ var COLOR_SCOPE_REFERENCE_KINDS = [
   "palette-mood",
   "temperature-level"
 ];
-var lexicalGovernance = (explanation, provenance) => ({
+var lexicalGovernance = (explanation, provenance, lifecycle = lifecycleFor()) => ({
   explanation,
-  lifecycle: lifecycleFor(),
+  lifecycle,
   provenance,
   steward: "@instruments/taxonomy"
 });
@@ -7199,7 +7397,7 @@ var crossoverAmbiguity = (phrase, taxonomyUri, colorScopeIdentifier, explanation
     "Taxonomy preserves the evidenced readings without assigning a default, role, contextual preference, or consumer route.",
     {
       basis: "evidenced",
-      snapshot: TAXONOMY_SNAPSHOT,
+      snapshot: PUBLISHED_V1_BASELINE,
       source
     }
   ),
@@ -7220,7 +7418,7 @@ var crossoverEquivalent = (phrase, taxonomyUri, explanation, source) => ({
     "Taxonomy records the evidenced material reading without assigning a consumer route.",
     {
       basis: "evidenced",
-      snapshot: TAXONOMY_SNAPSHOT,
+      snapshot: PUBLISHED_V1_BASELINE,
       source
     }
   ),
@@ -7228,7 +7426,7 @@ var crossoverEquivalent = (phrase, taxonomyUri, explanation, source) => ({
   phrase,
   target: { authority: "taxonomy", uri: taxonomyUri }
 });
-var crossoverTaxonomyAmbiguity = (phrase, readings, explanation, source) => {
+var crossoverTaxonomyAmbiguity = (phrase, readings, explanation, source, snapshot = PUBLISHED_V1_BASELINE, lifecycle = lifecycleFor()) => {
   const [first, second] = readings;
   return {
     explanation,
@@ -7236,9 +7434,10 @@ var crossoverTaxonomyAmbiguity = (phrase, readings, explanation, source) => {
       "Taxonomy preserves the evidenced readings without assigning a default, role, contextual preference, or consumer route.",
       {
         basis: "evidenced",
-        snapshot: TAXONOMY_SNAPSHOT,
+        snapshot,
         source
-      }
+      },
+      lifecycle
     ),
     outcome: "ambiguous",
     phrase,
@@ -7249,13 +7448,28 @@ var crossoverTaxonomyAmbiguity = (phrase, readings, explanation, source) => {
   };
 };
 var AUTHORED_LEXICAL_ENTRIES = [
+  crossoverTaxonomyAmbiguity(
+    "mosaic",
+    [
+      `${TAXONOMY_BASE_URI}/id/product-category/mosaic-tile`,
+      `${TAXONOMY_BASE_URI}/id/format/mosaic`
+    ],
+    "Mosaic can name a purchasable mosaic-tile product or the small-piece supply format; it is neither inherently a pattern nor a substance. Consumers must union any exact ColorScope named-paint reading with these domain readings rather than let an exact Taxonomy phrase shadow the external identity.",
+    `${searchCorpusEvidence("mosaic")}; Uniclass Pr_35_93_96_53 Mosaic tiles; consumer authority-union boundary reviewed 2026-08-31`,
+    MATERIALGRAPH_SEARCH_CORPUS_SNAPSHOT,
+    {
+      introducedAt: TAXONOMY_SNAPSHOT,
+      reviewedAt: TAXONOMY_SNAPSHOT,
+      status: "active"
+    }
+  ),
   {
     explanation: "Blue is a ColorScope colour-family reading; Taxonomy references that authority rather than minting a rival colour identity.",
     governance: lexicalGovernance(
       "The ColorScope family is the single governed reading of the unqualified colour word.",
       {
         basis: "vendored",
-        snapshot: TAXONOMY_SNAPSHOT,
+        snapshot: PUBLISHED_V1_BASELINE,
         source: "@instruments/colorscope COLOR_FAMILIES"
       }
     ),
@@ -7553,7 +7767,7 @@ var AUTHORED_LEXICAL_ENTRIES = [
       "The two readings are deliberately separate and context may select only the preference declared here.",
       {
         basis: "evidenced",
-        snapshot: TAXONOMY_SNAPSHOT,
+        snapshot: PUBLISHED_V1_BASELINE,
         source: crossoverSource("walnut")
       }
     ),
@@ -7595,6 +7809,17 @@ var lexicalPhrases = (term8) => [term8.slug, term8.label, ...term8.altLabels ??
   (phrase, index, phrases) => phrase.length > 0 && phrases.indexOf(phrase) === index
 );
 var targetKey = (target) => target.authority === "taxonomy" ? `taxonomy:${target.uri}` : `colorscope:${target.referenceKind}:${target.identifier}`;
+var inferredLifecycle = (readings) => {
+  const terms = readings.flatMap((reading) => reading.terms);
+  const [introducedAt] = terms.map((term8) => term8.introducedAt ?? PUBLISHED_V1_BASELINE).toSorted(compareText);
+  const reviewedAt = terms.map(
+    (term8) => term8.reviewedAt ?? term8.introducedAt ?? PUBLISHED_V1_BASELINE
+  ).toSorted(compareText).at(-1);
+  if (introducedAt === void 0 || reviewedAt === void 0) {
+    throw new Error("Inferred lexical reading has no source term lifecycle.");
+  }
+  return { introducedAt, reviewedAt, status: "active" };
+};
 var inferredLexicalEntries = () => {
   const authored = new Set(
     AUTHORED_LEXICAL_ENTRIES.map((entry) => entry.phrase)
@@ -7603,18 +7828,24 @@ var inferredLexicalEntries = () => {
   for (const location of AUTHORING_LOCATIONS) {
     const target = targetForLocation(location);
     for (const phrase of lexicalPhrases(location.term)) {
-      const targets = targetsByPhrase.get(phrase) ?? [];
-      if (!targets.some((candidate) => targetKey(candidate) === targetKey(target))) {
-        targets.push(target);
+      const readings = targetsByPhrase.get(phrase) ?? [];
+      const existing = readings.find(
+        (candidate) => targetKey(candidate.target) === targetKey(target)
+      );
+      if (existing === void 0) {
+        readings.push({ target, terms: [location.term] });
+      } else {
+        existing.terms.push(location.term);
       }
-      targetsByPhrase.set(phrase, targets);
+      targetsByPhrase.set(phrase, readings);
     }
   }
-  return [...targetsByPhrase].filter(([phrase]) => !authored.has(phrase)).map(([phrase, targets]) => {
-    const [first, second, ...rest] = targets;
+  return [...targetsByPhrase].filter(([phrase]) => !authored.has(phrase)).map(([phrase, readings]) => {
+    const [first, second, ...rest] = readings;
     if (first === void 0) {
       throw new Error(`Lexical phrase "${phrase}" has no reading.`);
     }
+    const lifecycle = inferredLifecycle(readings);
     if (second === void 0) {
       return {
         explanation: `The published spelling \u201C${phrase}\u201D has one governed reading.`,
@@ -7622,13 +7853,14 @@ var inferredLexicalEntries = () => {
           "The reading is derived from a canonical label, slug, alternate label, or observed source spelling.",
           {
             basis: "evidenced",
-            snapshot: TAXONOMY_SNAPSHOT,
+            snapshot: lifecycle.reviewedAt,
             source: "Taxonomy V1 authored term dictionaries"
-          }
+          },
+          lifecycle
         ),
         outcome: "equivalent",
         phrase,
-        target: first
+        target: first.target
       };
     }
     return {
@@ -7637,13 +7869,18 @@ var inferredLexicalEntries = () => {
         "No context-independent primary reading has been governed.",
         {
           basis: "evidenced",
-          snapshot: TAXONOMY_SNAPSHOT,
+          snapshot: lifecycle.reviewedAt,
           source: "Colliding Taxonomy V1 authored term spellings"
-        }
+        },
+        lifecycle
       ),
       outcome: "ambiguous",
       phrase,
-      readings: [first, second, ...rest]
+      readings: [
+        first.target,
+        second.target,
+        ...rest.map(({ target }) => target)
+      ]
     };
   });
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@instruments/taxonomy",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "Canonical data-only interiors and architecture knowledge graph and lexical corpus.",
   "license": "SEE LICENSE IN LICENSE",
   "repository": {
@@ -23,14 +23,6 @@
   "publishConfig": {
     "access": "public"
   },
-  "scripts": {
-    "build": "rm -rf dist && tsup",
-    "lint": "howells-check .",
-    "prepare": "[ -d dist ] || pnpm build",
-    "sync:colorscope": "vitest run src/colorscope-sync.test.ts",
-    "test": "vitest run",
-    "typecheck": "tsc --noEmit"
-  },
   "devDependencies": {
     "@howells/lint": "^1.0.0",
     "@instruments/colorscope": "7.3.0",
@@ -38,5 +30,13 @@
     "tsup": "^8.5.1",
     "typescript": "^5.7.0",
     "vitest": "^4.0.0"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsup",
+    "lint": "howells-check .",
+    "smoke:packed": "node --experimental-strip-types scripts/smoke-packed-core.ts",
+    "sync:colorscope": "vitest run src/colorscope-sync.test.ts",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
   }
-}
+}