@instruments/taxonomy 1.8.0 → 1.9.0

package/dist/axes/pattern-figure.d.ts

@@ -0,0 +1,8 @@
+import type { Term } from "../term.js";
+/**
+ * The natural variation of a stone, stone-effect or timber surface, independent of motif. See
+ * ADR 0008. Unranked, for the reason type is: veined is not more figured than speckled, only
+ * differently so. Evidenced from the Material Bank PIM's surface-figure column (non-Samplize
+ * SKUs, 2026-09-26); the PIM's own spelling is preserved in `seenAs`.
+ */
+export declare const PATTERN_FIGURE_TERMS: readonly Term[];

package/dist/axes/pattern-tax57.d.ts

@@ -0,0 +1,10 @@
+import type { Term } from "../term.js";
+export declare const TAX57_DATE = "2026-09-26";
+export declare const TAX57_SOURCE = "Linear TAX-57 visual-vocabulary review";
+export declare const PIM_MOTIF_SOURCE = "the pattern-motif column in a materials-marketplace catalogue (src-04), non-Samplize SKUs";
+export declare const PIM_FIGURE_SOURCE = "the surface-figure column in a materials-marketplace catalogue (src-04), non-Samplize SKUs";
+/** Evidenced from the Material Bank PIM at the TAX-57 snapshot. */
+export declare const pimTerm: (slug: string, label: string, definition: string, source: string, extra?: Partial<Term>) => Term;
+/** Written for TAX-57 with no public authority or catalogue column behind it. */
+export declare const authoredTax57: (slug: string, label: string, definition: string, extra?: Partial<Term>) => Term;
+export declare const wikidata: (id: string, label: string) => string;

package/dist/axes/pattern.d.ts

@@ -1,4 +1,5 @@
 import type { Term } from "../term.js";
+export { PATTERN_FIGURE_TERMS } from "./pattern-figure.js";
 /** The motif itself. Unordered: a damask is not more than a stripe. */
 export declare const PATTERN_TYPE_TERMS: readonly Term[];
 /** How big the repeat is. Ordered, micro to oversized. */
@@ -9,12 +10,5 @@ export declare const PATTERN_DENSITY_TERMS: readonly Term[];
 export declare const PATTERN_REGULARITY_TERMS: readonly Term[];
 /** Which way the pattern runs. Unordered: see the header on why this is not a ladder. */
 export declare const PATTERN_DIRECTIONALITY_TERMS: readonly Term[];
-/**
- * The natural variation of a stone, stone-effect or timber surface, independent of motif. See
- * ADR 0008. Unranked, for the reason type is: veined is not more figured than speckled, only
- * differently so. Evidenced from the Material Bank PIM's surface-figure column (non-Samplize
- * SKUs, 2026-09-26); the PIM's own spelling is preserved in `seenAs`.
- */
-export declare const PATTERN_FIGURE_TERMS: readonly Term[];
 /** Kept for consumers importing the axis as one list; prefer the facets. */
 export declare const PATTERN_TERMS: readonly Term[];

package/dist/index.js

@@ -1921,6 +1921,8 @@ var FORMAT_TERMS = [
 var REVIEW_DATE5 = "2026-08-31";
 var REVIEW_SOURCE4 = "@instruments/taxonomy TAX-45 reviewed implementation contract";
 var ZIGZAG_EVIDENCE_SOURCE = "Linear TAX-45 reviewed implementation contract; herringbone and chevron product-language audit in a materials-retrieval system (src-05)";
+var MG_LAYOUT_DATE = "2026-09-27";
+var MG_LAYOUT_SOURCE = "MG-2218 reconciliation: MaterialGraph plank_layout extensions evidenced against Material Bank's catalogue feed";
 var term5 = (slug, label, definition, extra = {}) => ({
   definition,
   introducedAt: REVIEW_DATE5,
@@ -1930,6 +1932,19 @@ var term5 = (slug, label, definition, extra = {}) => ({
   slug,
   ...extra
 });
+var mgLayoutTerm = (slug, label, definition, extra = {}) => ({
+  definition,
+  introducedAt: MG_LAYOUT_DATE,
+  label,
+  provenance: {
+    basis: "evidenced",
+    snapshot: MG_LAYOUT_DATE,
+    source: MG_LAYOUT_SOURCE
+  },
+  reviewedAt: MG_LAYOUT_DATE,
+  slug,
+  ...extra
+});
 var INSTALLATION_LAYOUT_TERMS = [
   term5(
     "stack-bond",
@@ -2010,6 +2025,33 @@ var INSTALLATION_LAYOUT_TERMS = [
     "irregular-field",
     "Irregular field",
     "Discrete units form a positively observed non-periodic field with persistent real joints."
+  ),
+  // MG-2218. Named French parquet panel layouts, each an assembled panel of real joints rather than
+  // a printed or woven motif.
+  mgLayoutTerm(
+    "versailles",
+    "Versailles parquet",
+    "Framed square panels, each filled with an interlocking diagonal basketweave lattice, repeat across the surface."
+  ),
+  mgLayoutTerm(
+    "chantilly",
+    "Chantilly parquet",
+    "Framed square panels, each filled with an interlaced lattice of diamond or cross-shaped units, repeat across the surface."
+  ),
+  // MG-2218. Narrower than herringbone: every double herringbone installation is also a broken
+  // zigzag of alternating angled units, just doubled in width and cut from narrower stock.
+  mgLayoutTerm(
+    "double-herringbone",
+    "Double herringbone",
+    "Two herringbone courses laid together so each zigzag arm reads at double width, using narrower units than a single herringbone layout at the same scale.",
+    { broaderSlug: "herringbone" }
+  ),
+  // MG-2218. `hexagon-block` rather than `hexagon`, which unit-shape already holds for the outline
+  // of one six-sided unit; this is the layout six elongated units make together, not that outline.
+  mgLayoutTerm(
+    "hexagon-block",
+    "Hexagonal parquet block",
+    "Elongated units arranged radially in groups of six form repeating hexagonal parquet blocks across the surface."
   )
 ];
 
@@ -4526,6 +4568,8 @@ var MATERIAL_POLYMERS_TERMS = [
 var WOOD_HANDBOOK3 = "USDA Wood Handbook (2021), chapter 2";
 var EN_13556 = "EN 13556:2003";
 var WOOD_HANDBOOK_IMPORTED = "USDA Wood Handbook (2021), chapter 2, imported woods section";
+var TAX59_DATE = "2026-09-27";
+var TAX59_SOURCE = "Linear TAX-59 wood species review; MG-2218 reconciliation against Material Bank's wood_species column";
 var MATERIAL_TIMBER_SPECIES_TERMS = [
   compositionTerm(
     "prunus-serotina",
@@ -4623,6 +4667,23 @@ var MATERIAL_TIMBER_SPECIES_TERMS = [
     WOOD_HANDBOOK_IMPORTED,
     { altLabels: ["Eucalyptus marginata"], broaderSlug: "eucalyptus" }
   ),
+  compositionTerm(
+    "acacia-koa",
+    "Koa",
+    "Timber from Acacia koa, commercially cut in Hawaii.",
+    WOOD_HANDBOOK3,
+    {
+      altLabels: ["Acacia Koa"],
+      broaderSlug: "acacia",
+      introducedAt: TAX59_DATE,
+      provenance: {
+        basis: "referenced",
+        snapshot: TAX59_DATE,
+        source: `${WOOD_HANDBOOK3}; ${TAX59_SOURCE}`
+      },
+      reviewedAt: TAX59_DATE
+    }
+  ),
   compositionTerm(
     "quercus-mongolica",
     "Mongolian oak",
@@ -4672,6 +4733,18 @@ var MATERIAL_TIMBER_SPECIES_TERMS = [
     EN_13556,
     { altLabels: ["Quercus petraea"], broaderSlug: "oak" }
   ),
+  authoredTerm(
+    "fraxinus-mandshurica",
+    "Tamo",
+    "Timber from Fraxinus mandshurica, commercially cut across north-east Asia and prized for its figured grain.",
+    {
+      altLabels: ["Japanese Ash"],
+      broaderSlug: "ash",
+      introducedAt: TAX59_DATE,
+      provenance: { basis: "authored", source: TAX59_SOURCE },
+      reviewedAt: TAX59_DATE
+    }
+  ),
   compositionTerm(
     "thuja-plicata",
     "Western red cedar",
@@ -4705,6 +4778,22 @@ var MATERIAL_TIMBER_SPECIES_TERMS = [
 var WOOD_HANDBOOK4 = "USDA Wood Handbook (2021), chapter 2";
 var EN_135562 = "EN 13556:2003";
 var HARDWOOD_SLUG = "hardwood";
+var TAX59_DATE2 = "2026-09-27";
+var TAX59_SOURCE2 = "Linear TAX-59 wood species review; MG-2218 reconciliation against Material Bank's wood_species column";
+var mgWoodTerm = (slug, label, definition, extra = {}) => ({
+  broaderSlug: HARDWOOD_SLUG,
+  definition,
+  introducedAt: TAX59_DATE2,
+  label,
+  provenance: {
+    basis: "evidenced",
+    snapshot: TAX59_DATE2,
+    source: TAX59_SOURCE2
+  },
+  reviewedAt: TAX59_DATE2,
+  slug,
+  ...extra
+});
 var MATERIAL_TIMBERS_TERMS = [
   // Materials, alphabetical.
   authoredTerm(
@@ -4720,6 +4809,11 @@ var MATERIAL_TIMBERS_TERMS = [
     WOOD_HANDBOOK4,
     { broaderSlug: HARDWOOD_SLUG }
   ),
+  mgWoodTerm(
+    "anigre",
+    "Anigre",
+    "Hardwood timber from trees in the genus Aningeria (a synonym of Pouteria), commercially cut across West and Central Africa."
+  ),
   compositionTerm(
     "ash",
     "Ash",
@@ -4734,6 +4828,11 @@ var MATERIAL_TIMBERS_TERMS = [
     WOOD_HANDBOOK4,
     { broaderSlug: "poplar" }
   ),
+  mgWoodTerm(
+    "balau",
+    "Balau",
+    "Hardwood timber from a group of dense Shorea species traded together as balau, commercially cut across South-East Asia."
+  ),
   compositionTerm(
     "basswood",
     "Basswood",
@@ -4841,6 +4940,11 @@ var MATERIAL_TIMBERS_TERMS = [
     EN_135562,
     { broaderSlug: HARDWOOD_SLUG }
   ),
+  mgWoodTerm(
+    "sucupira",
+    "Sucupira",
+    "Hardwood timber traded as sucupira from Bowdichia and Diplotropis species, commercially cut across Brazil and the Guianas."
+  ),
   compositionTerm(
     "sycamore",
     "Sycamore",
@@ -4848,6 +4952,12 @@ var MATERIAL_TIMBERS_TERMS = [
     `${EN_135562}; ${WOOD_HANDBOOK4}`,
     { broaderSlug: HARDWOOD_SLUG }
   ),
+  mgWoodTerm(
+    "tigerwood",
+    "Tigerwood",
+    "Hardwood timber from Astronium fraxinifolium and Astronium graveolens, commercially cut across tropical Central and South America.",
+    { altLabels: ["Goncalo alves"] }
+  ),
   // Species, alphabetical.
   compositionTerm(
     "afromosia",
@@ -4856,6 +4966,12 @@ var MATERIAL_TIMBERS_TERMS = [
     EN_135562,
     { altLabels: ["Afromosia"], broaderSlug: HARDWOOD_SLUG }
   ),
+  // EN 13556 carries this species under code DIXX.
+  mgWoodTerm(
+    "angelique",
+    "Angelique",
+    "Hardwood timber from Dicorynia guianensis, commercially cut across French Guiana and Suriname."
+  ),
   compositionTerm(
     "balsa",
     "Balsa",
@@ -4870,6 +4986,11 @@ var MATERIAL_TIMBERS_TERMS = [
     EN_135562,
     { broaderSlug: HARDWOOD_SLUG, seenAs: ["Brazilian teak"] }
   ),
+  mgWoodTerm(
+    "garapa",
+    "Garapa",
+    "Hardwood timber from Apuleia leiocarpa, commercially cut across Brazil."
+  ),
   compositionTerm(
     "iroko",
     "Iroko",
@@ -4882,7 +5003,7 @@ var MATERIAL_TIMBERS_TERMS = [
     "Jatoba",
     "Hardwood timber from Hymenaea courbaril, commercially cut across Central and South America.",
     EN_135562,
-    { broaderSlug: HARDWOOD_SLUG, seenAs: ["Brazilian cherry"] }
+    { altLabels: ["Brazilian Cherry"], broaderSlug: HARDWOOD_SLUG }
   ),
   compositionTerm(
     "kempas",
@@ -4898,6 +5019,22 @@ var MATERIAL_TIMBERS_TERMS = [
     EN_135562,
     { altLabels: ["Korina"], broaderSlug: HARDWOOD_SLUG }
   ),
+  mgWoodTerm(
+    "madrone",
+    "Madrone",
+    "Hardwood timber from Arbutus menziesii, commercially cut across the Pacific coast of North America.",
+    { altLabels: ["Madrona"] }
+  ),
+  mgWoodTerm(
+    "makore",
+    "Makore",
+    "Hardwood timber from Tieghemella heckelii, commercially cut across West Africa."
+  ),
+  mgWoodTerm(
+    "pear",
+    "Pear",
+    "Hardwood timber from Pyrus communis, commercially cut across Europe."
+  ),
   compositionTerm(
     "rubberwood",
     "Rubberwood",
@@ -4912,6 +5049,26 @@ var MATERIAL_TIMBERS_TERMS = [
     EN_135562,
     { broaderSlug: HARDWOOD_SLUG }
   ),
+  mgWoodTerm(
+    "sweetgum",
+    "Sweetgum",
+    "Hardwood timber from Liquidambar styraciflua, commercially cut across the south-eastern United States.",
+    { seenAs: ["Gum"] }
+  ),
+  // American tulipwood, not Brazilian tulipwood (Dalbergia decipularis): the CITES-II-restricted
+  // Brazilian species trades in small veneer for inlay and marquetry, never architectural flooring,
+  // while Liriodendron tulipifera is the plantation hardwood AHEC actively markets internationally
+  // as American tulipwood for flooring, veneer and joinery. Material Bank's flooring and veneer
+  // catalogue means the American species. `poplar`'s own `seenAs: ["tulip poplar"]` names this same
+  // species under its domestic US common name; it is not touched here, but is flagged in the
+  // release notes as a likely pre-existing mislabel, since tulip poplar is Liriodendron, not the
+  // Populus genus poplar names.
+  mgWoodTerm(
+    "tulipwood",
+    "American tulipwood",
+    "Hardwood timber from Liriodendron tulipifera, commercially cut across the eastern United States and marketed internationally as American tulipwood.",
+    { altLabels: ["Liriodendron tulipifera"], seenAs: ["Tulipwood"] }
+  ),
   compositionTerm(
     "wenge",
     "Wenge",
@@ -5812,24 +5969,11 @@ var PALETTE_CHARACTER_TERMS = [
   }
 ];
 
-// src/axes/pattern.ts
-var SOURCE4 = "pattern vocabulary in a furnishings retailer (src-03)";
-var SNAPSHOT6 = "2026-08-25";
-var RETRIEVAL_SNAPSHOT2 = "2026-08-27";
-var RETRIEVAL_SCALE = "ms_pattern_scale, a dictionary in a materials-retrieval system (src-05)";
-var RETRIEVAL_DENSITY = "ms_pattern_density, a dictionary in a materials-retrieval system (src-05)";
-var RETRIEVAL_REGULARITY = "ms_pattern_regularity, a dictionary in a materials-retrieval system (src-05)";
-var RETRIEVAL_DIRECTIONALITY = "ms_directionality, a dictionary in a materials-retrieval system (src-05)";
-var GEOMETRY_REVIEW_DATE = "2026-08-31";
-var GEOMETRY_SOURCE = "Linear TAX-45 reviewed implementation contract";
-var REVIEW_DATE7 = "2026-09-11";
-var REVIEW_SOURCE6 = "everyday-interiors vocabulary review";
-var GEOMETRY_EVIDENCE_SOURCE = "Linear TAX-45 reviewed implementation contract; herringbone and chevron product-language audit in a materials-retrieval system (src-05)";
+// src/axes/pattern-tax57.ts
 var TAX57_DATE3 = "2026-09-26";
 var TAX57_SOURCE2 = "Linear TAX-57 visual-vocabulary review";
 var PIM_MOTIF_SOURCE = "the pattern-motif column in a materials-marketplace catalogue (src-04), non-Samplize SKUs";
 var PIM_FIGURE_SOURCE = "the surface-figure column in a materials-marketplace catalogue (src-04), non-Samplize SKUs";
-var ANIMAL_PRINT_SLUG = "animal-print";
 var pimTerm = (slug, label, definition, source, extra = {}) => ({
   definition,
   introducedAt: TAX57_DATE3,
@@ -5849,6 +5993,145 @@ var authoredTax57 = (slug, label, definition, extra = {}) => ({
   ...extra
 });
 var wikidata4 = (id, label) => `Wikidata ${id} ${label}, https://www.wikidata.org/wiki/${id}`;
+
+// src/axes/pattern-figure.ts
+var PATTERN_FIGURE_TERMS = [
+  pimTerm(
+    "unvaried",
+    "Unvaried",
+    "No visible natural variation across the surface.",
+    PIM_FIGURE_SOURCE,
+    { seenAs: ["No Variation"] }
+  ),
+  pimTerm(
+    "speckled",
+    "Speckled",
+    "Fine flecks and speckles scattered across the surface.",
+    PIM_FIGURE_SOURCE,
+    { seenAs: ["Flecks & Speckles"] }
+  ),
+  pimTerm(
+    "linear-veining",
+    "Linear veining",
+    "Veining running in one consistent direction across the surface.",
+    PIM_FIGURE_SOURCE,
+    { seenAs: ["Linear Veins"] }
+  ),
+  pimTerm(
+    "multi-directional-veining",
+    "Multi-directional veining",
+    "Veining running in more than one direction across the surface, with no single dominant axis.",
+    PIM_FIGURE_SOURCE,
+    { seenAs: ["Multi-Directional Veins"] }
+  ),
+  pimTerm(
+    "mottled",
+    "Mottled",
+    "Uneven patches or blotches of tone breaking up an otherwise even surface.",
+    PIM_FIGURE_SOURCE
+  ),
+  pimTerm(
+    "cloudy",
+    "Cloudy",
+    "Soft, diffuse variation in tone with no distinct veins or edges, reading as drifting cloud.",
+    PIM_FIGURE_SOURCE
+  ),
+  pimTerm(
+    "breccia",
+    "Breccia",
+    "Angular fragments of stone bound within a contrasting matrix.",
+    `${PIM_FIGURE_SOURCE}; ${wikidata4("Q191250", "breccia")}`,
+    { seenAs: ["Angular Fragments"] }
+  ),
+  pimTerm(
+    "swirling",
+    "Swirling",
+    "Variation that curls and eddies across the surface rather than running in straight lines or veins.",
+    PIM_FIGURE_SOURCE
+  ),
+  pimTerm(
+    "fossiliferous",
+    "Fossil",
+    "Visible shells or fossil forms embedded in the surface.",
+    PIM_FIGURE_SOURCE,
+    { seenAs: ["Shells & Fossils"] }
+  ),
+  pimTerm(
+    "pitted",
+    "Pitted",
+    "Surface holes and pitting left unfilled, as in unfilled travertine.",
+    PIM_FIGURE_SOURCE,
+    { seenAs: ["Holes & Pitting"] }
+  ),
+  pimTerm(
+    "brindled",
+    "Brindled",
+    "Irregular streaky variation running through the surface, as in a brindled coat.",
+    PIM_FIGURE_SOURCE,
+    { seenAs: ["Brindle"] }
+  ),
+  pimTerm(
+    "mineral-inclusions",
+    "Mineral inclusions",
+    "Visible mineral deposits embedded within the surface.",
+    PIM_FIGURE_SOURCE,
+    { seenAs: ["Mineral Deposits"] }
+  ),
+  // `rustic` is deliberately not an alt label: it names a style, and prominent knots do not make a
+  // timber rustic in the style sense, so treating the words as interchangeable would smuggle a
+  // STYLE claim into a FIGURE one.
+  pimTerm(
+    "knotty",
+    "Knotty",
+    "Timber figure carrying prominent, frequent knots.",
+    PIM_FIGURE_SOURCE,
+    { seenAs: ["Knots"] }
+  ),
+  // AUTHORED. No Material Bank PIM column value names the absence of figure; clear grain is the
+  // un-figured baseline that gives knotty, burl, fiddleback and bird's-eye something to contrast
+  // against. It is not their parent: figure is unranked and unordered, and a plain surface is not
+  // a kind of knotty one, only its absence.
+  authoredTax57(
+    "clear-grain",
+    "Clear grain",
+    "Timber figure free of knots, with an even, minimally figured grain."
+  ),
+  pimTerm(
+    "burl",
+    "Burl",
+    "A swirling, densely clustered grain figure cut from a tree's burl growth.",
+    `${PIM_FIGURE_SOURCE}; ${wikidata4("Q1483529", "burl")}`
+  ),
+  // AUTHORED. No Wikidata item for fiddleback figure on the review date.
+  authoredTax57(
+    "fiddleback",
+    "Fiddleback",
+    "A tight, uniform rippled figure running across the grain, historically prized for violin backs."
+  ),
+  pimTerm(
+    "birds-eye",
+    "Bird's eye",
+    "Small, round, eye-like figure dots scattered through the grain, as in bird's-eye maple.",
+    `${PIM_FIGURE_SOURCE}; ${wikidata4("Q164973", "bird's eye figure")}`
+  )
+];
+
+// src/axes/pattern.ts
+var SOURCE4 = "pattern vocabulary in a furnishings retailer (src-03)";
+var SNAPSHOT6 = "2026-08-25";
+var RETRIEVAL_SNAPSHOT2 = "2026-08-27";
+var RETRIEVAL_SCALE = "ms_pattern_scale, a dictionary in a materials-retrieval system (src-05)";
+var RETRIEVAL_DENSITY = "ms_pattern_density, a dictionary in a materials-retrieval system (src-05)";
+var RETRIEVAL_REGULARITY = "ms_pattern_regularity, a dictionary in a materials-retrieval system (src-05)";
+var RETRIEVAL_DIRECTIONALITY = "ms_directionality, a dictionary in a materials-retrieval system (src-05)";
+var GEOMETRY_REVIEW_DATE = "2026-08-31";
+var GEOMETRY_SOURCE = "Linear TAX-45 reviewed implementation contract";
+var REVIEW_DATE7 = "2026-09-11";
+var REVIEW_SOURCE6 = "everyday-interiors vocabulary review";
+var GEOMETRY_EVIDENCE_SOURCE = "Linear TAX-45 reviewed implementation contract; herringbone and chevron product-language audit in a materials-retrieval system (src-05)";
+var ANIMAL_PRINT_SLUG = "animal-print";
+var TAX58_DATE = "2026-09-27";
+var TAX58_SOURCE = "Linear TAX-58 visual-vocabulary review; MG-2218 reconciliation";
 var term7 = (slug, label, definition, extra = {}) => ({
   definition,
   label,
@@ -5925,6 +6208,35 @@ var PATTERN_TYPE_TERMS = [
     PIM_MOTIF_SOURCE,
     { broaderSlug: ANIMAL_PRINT_SLUG }
   ),
+  // TAX-58, sitting between abstract-organic's fluid biomorphic forms and geometric's regular
+  // grids; 5,015 records, all from Material Bank's catalogue feed crosswalk.
+  {
+    definition: "Angular, hard-edged graphic abstraction, distinct from fluid biomorphic abstraction and from regular geometric repeats.",
+    introducedAt: TAX58_DATE,
+    label: "Abstract graphic",
+    provenance: {
+      basis: "evidenced",
+      snapshot: TAX58_DATE,
+      source: TAX58_SOURCE
+    },
+    reviewedAt: TAX58_DATE,
+    slug: "abstract-graphic"
+  },
+  // TAX-58. Filed under cultural-heritage, not as a root concept: the boteh motif is explicitly
+  // drawn from a named textile tradition, which is that term's own boundary. 32 records.
+  {
+    broaderSlug: "cultural-heritage",
+    definition: "The boteh teardrop motif of Persian and South Asian textile tradition.",
+    introducedAt: TAX58_DATE,
+    label: "Paisley",
+    provenance: {
+      basis: "evidenced",
+      snapshot: TAX58_DATE,
+      source: TAX58_SOURCE
+    },
+    reviewedAt: TAX58_DATE,
+    slug: "paisley"
+  },
   term7(
     "botanical",
     "Botanical",
@@ -6271,126 +6583,6 @@ var PATTERN_DIRECTIONALITY_TERMS = [
     "Two axes of equal weight, so the material reads correctly either way up."
   )
 ];
-var PATTERN_FIGURE_TERMS = [
-  pimTerm(
-    "unvaried",
-    "Unvaried",
-    "No visible natural variation across the surface.",
-    PIM_FIGURE_SOURCE,
-    { seenAs: ["No Variation"] }
-  ),
-  pimTerm(
-    "speckled",
-    "Speckled",
-    "Fine flecks and speckles scattered across the surface.",
-    PIM_FIGURE_SOURCE,
-    { seenAs: ["Flecks & Speckles"] }
-  ),
-  pimTerm(
-    "linear-veining",
-    "Linear veining",
-    "Veining running in one consistent direction across the surface.",
-    PIM_FIGURE_SOURCE,
-    { seenAs: ["Linear Veins"] }
-  ),
-  pimTerm(
-    "multi-directional-veining",
-    "Multi-directional veining",
-    "Veining running in more than one direction across the surface, with no single dominant axis.",
-    PIM_FIGURE_SOURCE,
-    { seenAs: ["Multi-Directional Veins"] }
-  ),
-  pimTerm(
-    "mottled",
-    "Mottled",
-    "Uneven patches or blotches of tone breaking up an otherwise even surface.",
-    PIM_FIGURE_SOURCE
-  ),
-  pimTerm(
-    "cloudy",
-    "Cloudy",
-    "Soft, diffuse variation in tone with no distinct veins or edges, reading as drifting cloud.",
-    PIM_FIGURE_SOURCE
-  ),
-  pimTerm(
-    "breccia",
-    "Breccia",
-    "Angular fragments of stone bound within a contrasting matrix.",
-    `${PIM_FIGURE_SOURCE}; ${wikidata4("Q191250", "breccia")}`,
-    { seenAs: ["Angular Fragments"] }
-  ),
-  pimTerm(
-    "swirling",
-    "Swirling",
-    "Variation that curls and eddies across the surface rather than running in straight lines or veins.",
-    PIM_FIGURE_SOURCE
-  ),
-  pimTerm(
-    "fossiliferous",
-    "Fossil",
-    "Visible shells or fossil forms embedded in the surface.",
-    PIM_FIGURE_SOURCE,
-    { seenAs: ["Shells & Fossils"] }
-  ),
-  pimTerm(
-    "pitted",
-    "Pitted",
-    "Surface holes and pitting left unfilled, as in unfilled travertine.",
-    PIM_FIGURE_SOURCE,
-    { seenAs: ["Holes & Pitting"] }
-  ),
-  pimTerm(
-    "brindled",
-    "Brindled",
-    "Irregular streaky variation running through the surface, as in a brindled coat.",
-    PIM_FIGURE_SOURCE,
-    { seenAs: ["Brindle"] }
-  ),
-  pimTerm(
-    "mineral-inclusions",
-    "Mineral inclusions",
-    "Visible mineral deposits embedded within the surface.",
-    PIM_FIGURE_SOURCE,
-    { seenAs: ["Mineral Deposits"] }
-  ),
-  // `rustic` is deliberately not an alt label: it names a style, and prominent knots do not make a
-  // timber rustic in the style sense, so treating the words as interchangeable would smuggle a
-  // STYLE claim into a FIGURE one.
-  pimTerm(
-    "knotty",
-    "Knotty",
-    "Timber figure carrying prominent, frequent knots.",
-    PIM_FIGURE_SOURCE,
-    { seenAs: ["Knots"] }
-  ),
-  // AUTHORED. No Material Bank PIM column value names the absence of figure; clear grain is the
-  // un-figured baseline that gives knotty, burl, fiddleback and bird's-eye something to contrast
-  // against. It is not their parent: figure is unranked and unordered, and a plain surface is not
-  // a kind of knotty one, only its absence.
-  authoredTax57(
-    "clear-grain",
-    "Clear grain",
-    "Timber figure free of knots, with an even, minimally figured grain."
-  ),
-  pimTerm(
-    "burl",
-    "Burl",
-    "A swirling, densely clustered grain figure cut from a tree's burl growth.",
-    `${PIM_FIGURE_SOURCE}; ${wikidata4("Q1483529", "burl")}`
-  ),
-  // AUTHORED. No Wikidata item for fiddleback figure on the review date.
-  authoredTax57(
-    "fiddleback",
-    "Fiddleback",
-    "A tight, uniform rippled figure running across the grain, historically prized for violin backs."
-  ),
-  pimTerm(
-    "birds-eye",
-    "Bird's eye",
-    "Small, round, eye-like figure dots scattered through the grain, as in bird's-eye maple.",
-    `${PIM_FIGURE_SOURCE}; ${wikidata4("Q164973", "bird's eye figure")}`
-  )
-];
 var PATTERN_TERMS = [
   ...PATTERN_TYPE_TERMS,
   ...PATTERN_SCALE_TERMS,
@@ -7137,7 +7329,7 @@ var PRODUCT_CATEGORY_TERMS = [
   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.",
+    "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; an external, weather-facing panel is cladding.",
     {
       altLabels: ["wall panelling", "wall paneling"],
       broaderSlug: "wallcovering",
@@ -7215,6 +7407,48 @@ var PRODUCT_CATEGORY_TERMS = [
         )
       ]
     }
+  ),
+  // Distinct from `wall-panel` and `wallcovering`, which finish a wall's visible face without
+  // weathering it. Façade tile stays `tile` under tile's own definition. Uniclass's nearest Pr
+  // code, Pr_25_71_14 "Cladding and lining panels", names both this category and interior lining
+  // in one code, so it is not an exact match and is recorded as a dated negative instead.
+  term8(
+    "cladding",
+    "Cladding",
+    "A board or panel product supplied to form the external, weather-facing face of a building's walls, independent of its material and of the structure behind it; not a tile, a render or a glazed curtain wall.",
+    {
+      altLabels: [
+        "siding",
+        "facade cladding",
+        "fa\xE7ade cladding",
+        "exterior cladding",
+        "rainscreen cladding",
+        "facade panel"
+      ],
+      introducedAt: REVIEW_DATE8,
+      provenance: { basis: "authored", source: REVIEW_SOURCE7 },
+      reviewedAt: REVIEW_DATE8,
+      searchedWithout: [
+        searchedUniclassOnReview(
+          "cladding, facade cladding, siding, rainscreen cladding"
+        )
+      ],
+      seenAs: ["Facade", "Rainscreens", "Exterior Panel Systems"]
+    }
+  ),
+  // A sofa bed stays `sofa`. Bedding is deliberately not added yet, because MaterialGraph has no
+  // bedding products.
+  term8(
+    "bed",
+    "Bed",
+    "A furniture product supplied to sleep or lie on, or the frame or headboard made for one, independent of its material and size; not a mattress, bedding or a sofa bed.",
+    {
+      altLabels: ["bed frame"],
+      external: [uniclass2("Pr_40_50_06", "Beds", "broad")],
+      introducedAt: REVIEW_DATE8,
+      provenance: { basis: "authored", source: REVIEW_SOURCE7 },
+      reviewedAt: REVIEW_DATE8
+    }
   )
 ];
 
@@ -11522,8 +11756,8 @@ var resolveReference = (reference) => INDEX.byKey.get(canonicalKey(reference));
 
 // src/v1.ts
 var TAXONOMY_BASE_URI = "https://taxonomy.materialinstruments.com";
-var TAXONOMY_SNAPSHOT = "2026-09-26";
-var TAXONOMY_VERSION = "1.8.0";
+var TAXONOMY_SNAPSHOT = "2026-09-27";
+var TAXONOMY_VERSION = "1.9.0";
 var PUBLISHED_V1_BASELINE = "2026-08-30";
 var TAX45_REVIEW_SNAPSHOT = "2026-08-31";
 var LIMESTONE_INTRODUCED = "2026-09-01";
@@ -11827,6 +12061,11 @@ var HIERARCHY_REVIEW_LIFECYCLE = {
 };
 var AMBIGUITY_GOVERNANCE = "Taxonomy preserves the governed readings without assigning a default, role, contextual preference, or consumer route.";
 var ORDERED_READING_GOVERNANCE = "The two readings are deliberately separate; the default records trade usage and does not merge the concepts.";
+var TAXONOMY_SNAPSHOT_LIFECYCLE = {
+  introducedAt: TAXONOMY_SNAPSHOT,
+  reviewedAt: TAXONOMY_SNAPSHOT,
+  status: "active"
+};
 var TAX57_DATE4 = "2026-09-26";
 var TAX57_LIFECYCLE = {
   introducedAt: TAX57_DATE4,
@@ -12576,6 +12815,61 @@ var AUTHORED_LEXICAL_ENTRIES = [
       }
     ]
   },
+  // Two observed source spellings on the product-category axis that the inferred
+  // readings promoted to customer equivalents. Each is a department label in one
+  // catalogue; the seenAs evidence stays on the term, and only the reading is declined.
+  {
+    explanation: "Fittings is a catalogue department label for tapware in one source. As a request it names light fittings, electrical fittings and bathroom fittings just as readily, so it identifies no single product category.",
+    governance: lexicalGovernance(
+      "A source department label is crosswalk evidence, not a customer reading of one concept.",
+      { basis: "authored", source: "MaterialGraph MG-2226 category review" },
+      TAXONOMY_SNAPSHOT_LIFECYCLE
+    ),
+    outcome: "declined",
+    phrase: "fittings",
+    reason: "A trade grouping spanning tapware, lighting and electrical fittings, not a kind of product."
+  },
+  {
+    explanation: "Electrical is a catalogue department label for wiring accessories in one source. As a request it names a trade that also covers back boxes, cable management and lighting, so it identifies no single product category.",
+    governance: lexicalGovernance(
+      "A source department label is crosswalk evidence, not a customer reading of one concept.",
+      { basis: "authored", source: "MaterialGraph MG-2226 category review" },
+      TAXONOMY_SNAPSHOT_LIFECYCLE
+    ),
+    outcome: "declined",
+    phrase: "electrical",
+    reason: "Names a trade, not a kind of product."
+  },
+  // Two more declined readings, added alongside `cladding` for the same reason `fittings` and
+  // `electrical` were declined: each phrase spans more than the one product category it might name.
+  {
+    explanation: "Wall cladding also names interior stone and tile cladding, so as a request it does not settle between the exterior product category and an interior surface finish.",
+    governance: lexicalGovernance(
+      "A compound phrase spanning an exterior product category and an interior finish is not one customer reading.",
+      {
+        basis: "authored",
+        source: "@instruments/taxonomy 1.9.0 vocabulary review"
+      },
+      TAXONOMY_SNAPSHOT_LIFECYCLE
+    ),
+    outcome: "declined",
+    phrase: "wall cladding",
+    reason: "Names both the exterior cladding product category and interior stone or tile cladding; the bare phrase does not settle which."
+  },
+  {
+    explanation: "Facade names the building element - the whole external wall face - not a purchasable product. A request for a product names a kind of thing to buy, and a facade is not itself a product.",
+    governance: lexicalGovernance(
+      "A building element is not a product category, whatever a source calls it.",
+      {
+        basis: "authored",
+        source: "@instruments/taxonomy 1.9.0 vocabulary review"
+      },
+      TAXONOMY_SNAPSHOT_LIFECYCLE
+    ),
+    outcome: "declined",
+    phrase: "facade",
+    reason: "Names the building element, not a kind of product."
+  },
   {
     explanation: "The phrase makes an environmental performance claim that needs product evidence, not a terminology-only mapping.",
     governance: lexicalGovernance(

package/dist/v1.d.ts

@@ -1,7 +1,7 @@
 import type { ElementPlacement, ExternalMapping, ExternalScheme, PeriodSpan, RelationPredicate, SearchedWithout, StyleKind, TermProvenance, TermUsage, UsageWithheld } from "./term.js";
 export declare const TAXONOMY_BASE_URI: "https://taxonomy.materialinstruments.com";
-export declare const TAXONOMY_SNAPSHOT: "2026-09-26";
-export declare const TAXONOMY_VERSION: "1.8.0";
+export declare const TAXONOMY_SNAPSHOT: "2026-09-27";
+export declare const TAXONOMY_VERSION: "1.9.0";
 export type CanonicalConceptUri = `${typeof TAXONOMY_BASE_URI}/id/${string}`;
 export type LifecycleStatus = "active" | "deprecated";
 export interface Lifecycle {
@@ -135,7 +135,7 @@ export declare const TAXONOMY_CORPUS_METADATA: {
     readonly lexicalEntryCount: number;
     readonly nodeCount: number;
     readonly revision: string;
-    readonly snapshot: "2026-09-26";
-    readonly version: "1.8.0";
+    readonly snapshot: "2026-09-27";
+    readonly version: "1.9.0";
 };
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@instruments/taxonomy",
-  "version": "1.8.0",
+  "version": "1.9.0",
   "description": "Canonical data-only interiors and architecture knowledge graph and lexical corpus.",
   "license": "SEE LICENSE IN LICENSE",
   "repository": {