@instruments/taxonomy 0.1.0

package/LICENSE

@@ -0,0 +1,7 @@
+Copyright © 2026 Material Technologies, LLC. All rights reserved.
+
+This software and associated documentation files are the proprietary
+property of Material Technologies, LLC. No license, express or implied,
+is granted to use, copy, modify, merge, publish, distribute, sublicense,
+or sell copies of this software except under a separate written
+agreement with Material Technologies, LLC.

package/README.md

@@ -0,0 +1,85 @@
+# @instruments/taxonomy
+
+The canonical materials taxonomy for the Material Instruments ecosystem: the governed
+**dictionaries** (material families, sectors, and the hierarchical application zones) plus the
+**consumer crosswalks** that map an external vendor's local vocabulary onto the canon. This package
+is the single publishable home of the Material Semantics vocabularies that were previously vendored
+per-repo as drifting local copies.
+
+## Install
+
+```sh
+pnpm add @instruments/taxonomy
+```
+
+## Import paths
+
+### `@instruments/taxonomy` — the dictionaries
+
+The pinned public vocabularies: `MATERIAL_FAMILIES` (17), `SECTORS` (10), `APPLICATIONS` (88 — 30
+top-level zones plus 58 children). Each ships a `*_TERMS` array of labelled `TaxonomyTerm`s, an
+`as const` id tuple, a string-literal type, and a `Set`-backed guard.
+
+```ts
+import {
+  APPLICATIONS,
+  MATERIAL_FAMILIES,
+  applicationTopLevelOf,
+  isMaterialFamily,
+  type Application,
+} from "@instruments/taxonomy";
+
+isMaterialFamily("wood"); // true
+applicationTopLevelOf("stair_tread"); // "stair_elevator"
+applicationTopLevelOf("wall"); // "wall" (already top-level)
+```
+
+### `@instruments/taxonomy/crosswalks/miu` — the MIU consumer crosswalk
+
+Maps the Materials In Use (MIU) local vocabularies onto the canonical dictionaries. Total,
+compile-time-checked `Record` maps plus string accessors that resolve unknown input to `null`
+instead of throwing.
+
+```ts
+import {
+  miuFamilyToCanonical,
+  MIU_SURFACE_APPLICATION_TO_CANONICAL,
+} from "@instruments/taxonomy/crosswalks/miu";
+
+miuFamilyToCanonical("ceramic_porcelain"); // "tile"
+miuFamilyToCanonical("greenery_planting"); // null (declines to classify)
+MIU_SURFACE_APPLICATION_TO_CANONICAL.railing; // "stair_railing"
+```
+
+## Provenance and the re-sync ritual
+
+The dictionaries are lifted **verbatim** from materialgraph —
+`packages/schema/src/registry/value-dictionaries.ts`, snapshot `2026-07-08` (see the exported
+`PROVENANCE` constant). Every term was lifecycle-active at that snapshot; lifecycle fields are
+deferred from the published shape until governance needs them.
+
+To re-sync: re-read the upstream file, re-check the terms list, the `broaderTermId` edges, and the
+lifecycle fields, then bump this package. `src/materialgraph-sync.test.ts` mechanises the check — it
+reads a sibling `~/Sites/materialgraph` checkout and asserts every id is still present upstream
+(skipping only when that checkout is absent).
+
+## The other-vs-null policy
+
+For families and sectors, `other` is a **positive** classification — the canon's own dictionary
+would file the term under `other`. `null` **declines** to classify: it is not a member at all, it
+spans members, or any claim (including `other`) would be false. `unknown` therefore always maps to
+`null`, never `other` — unknown is epistemic ("we couldn't identify it") while other is ontological
+("identified; fits no bucket"); the application crosswalk has no `other` term at all, so there its
+policy collapses to mapped-or-`null`.
+
+## Versioning
+
+Semver; changesets will drive releases later. Consumers should keep a **single pin** of this
+package. The anti-pattern to avoid is the colorscope `3.6.0` / `3.7.1` split, where two pinned
+copies of the same taxonomy drifted apart inside one dependency graph — the exact fragmentation this
+package exists to end.
+
+## Roadmap
+
+Additive minors, all backward-compatible: an exported Material Bank category tree artifact, and
+per-term lifecycle fields (status, deprecation, successor pointers) once governance requires them.

package/dist/crosswalks/miu.d.ts

@@ -0,0 +1,16 @@
+import { MaterialFamily, Sector, Application } from '../index.js';
+
+declare const MIU_MATERIAL_FAMILIES: readonly ["wood", "wood_veneer", "engineered_wood", "bamboo", "cork", "natural_stone", "terrazzo", "ceramic_porcelain", "glass", "metal", "concrete", "plaster", "clay", "brick", "paint_coating", "wallcovering", "laminate", "solid_surface", "mineral_composite", "resin", "linoleum", "vinyl", "rubber", "carpet", "rug", "textile", "leather", "acoustic_felt", "acoustic_composite", "recycled_composite", "paper_cardboard", "biobased_composite", "greenery_planting", "lighting", "hardware", "digital_media", "water_feature", "mixed_material", "color_palette_only", "unknown"];
+type MiuMaterialFamily = (typeof MIU_MATERIAL_FAMILIES)[number];
+declare const MIU_FAMILY_TO_CANONICAL: Readonly<Record<MiuMaterialFamily, MaterialFamily | null>>;
+declare const MIU_PROJECT_SECTORS: readonly ["hospitality", "food_and_beverage", "workplace", "residential", "multifamily", "retail_and_showroom", "healthcare", "wellness", "education", "civic", "cultural", "community", "sports_recreation", "entertainment", "industrial", "logistics", "maker", "transportation", "landscape_public_realm", "mixed_use", "master_planning", "temporary_exhibition", "religious", "senior_living", "student_housing", "unknown"];
+type MiuProjectSector = (typeof MIU_PROJECT_SECTORS)[number];
+declare const MIU_SECTOR_TO_CANONICAL: Readonly<Record<MiuProjectSector, Sector | null>>;
+declare const MIU_SURFACE_APPLICATIONS: readonly ["flooring", "floor_inlay", "stair_tread", "stair_riser", "wall_finish", "wall_panel", "wainscot", "baseboard", "trim", "ceiling_finish", "ceiling_cloud", "column_wrap", "door_finish", "frame_finish", "shower_wall", "shower_floor", "backsplash", "vanity_top", "toilet_partition", "commercial_kitchen_floor", "kitchen_wall", "food_service_counter", "laundry_floor", "pool_deck_surface", "reception_desk", "bar_front", "bar_top", "back_bar", "banquette_base", "cabinet_front", "shelving", "display_fixture", "closet_system", "workstation_casework", "checkout_counter", "upholstery", "loose_furniture", "built_in_seating", "banquette_upholstery", "drapery", "window_treatment", "rug", "carpet_tile", "bedding", "privacy_curtain", "acoustic_fabric_panel", "lighting_fixture", "acoustic_treatment", "partition", "operable_wall", "signage", "wayfinding", "hardware", "plumbing_fixture", "decorative_screen", "art_installation", "green_wall", "facade_cladding", "soffit", "exterior_screen", "paving", "decking", "outdoor_furniture", "planter", "pool_coping", "shade_structure", "railing", "fence_screen", "unknown"];
+type MiuSurfaceApplication = (typeof MIU_SURFACE_APPLICATIONS)[number];
+declare const MIU_SURFACE_APPLICATION_TO_CANONICAL: Readonly<Record<MiuSurfaceApplication, Application | null>>;
+declare const miuFamilyToCanonical: (value: string) => MaterialFamily | null;
+declare const miuSectorToCanonical: (value: string) => Sector | null;
+declare const miuSurfaceApplicationToCanonical: (value: string) => Application | null;
+
+export { MIU_FAMILY_TO_CANONICAL, MIU_MATERIAL_FAMILIES, MIU_PROJECT_SECTORS, MIU_SECTOR_TO_CANONICAL, MIU_SURFACE_APPLICATIONS, MIU_SURFACE_APPLICATION_TO_CANONICAL, type MiuMaterialFamily, type MiuProjectSector, type MiuSurfaceApplication, miuFamilyToCanonical, miuSectorToCanonical, miuSurfaceApplicationToCanonical };

package/dist/crosswalks/miu.js

@@ -0,0 +1,400 @@
+// src/crosswalks/miu.ts
+var MIU_MATERIAL_FAMILIES = [
+  "wood",
+  "wood_veneer",
+  "engineered_wood",
+  "bamboo",
+  "cork",
+  "natural_stone",
+  "terrazzo",
+  "ceramic_porcelain",
+  "glass",
+  "metal",
+  "concrete",
+  "plaster",
+  "clay",
+  "brick",
+  "paint_coating",
+  "wallcovering",
+  "laminate",
+  "solid_surface",
+  "mineral_composite",
+  "resin",
+  "linoleum",
+  "vinyl",
+  "rubber",
+  "carpet",
+  "rug",
+  "textile",
+  "leather",
+  "acoustic_felt",
+  "acoustic_composite",
+  "recycled_composite",
+  "paper_cardboard",
+  "biobased_composite",
+  "greenery_planting",
+  "lighting",
+  "hardware",
+  "digital_media",
+  "water_feature",
+  "mixed_material",
+  "color_palette_only",
+  "unknown"
+];
+var MIU_FAMILY_TO_CANONICAL = {
+  wood: "wood",
+  // Veneer and engineered constructions are wood at family grain; construction is sub-family detail.
+  wood_veneer: "wood",
+  engineered_wood: "wood",
+  // Botanically a grass, but sold, specified, and finished as wood (flooring, ply, veneer).
+  bamboo: "wood",
+  // Trade classification: cork is a canonical resilient flooring type alongside linoleum and rubber.
+  cork: "resilient_flooring",
+  natural_stone: "stone",
+  terrazzo: "terrazzo",
+  // MS has no ceramic family; in interiors ceramic/porcelain IS the tile family (materialgraph's
+  // own tile_material_family dictionary leads with ceramic and porcelain).
+  ceramic_porcelain: "tile",
+  glass: "glass",
+  metal: "metal",
+  concrete: "concrete",
+  // Plaster, venetian plaster, and limewash are the archetypal MS wall finishes.
+  plaster: "wall_finish",
+  // With ceramic_porcelain and brick as separate MIU families, clay denotes unfired clay finishes
+  // (clay plaster and kin) — wall finish.
+  clay: "wall_finish",
+  // Real masonry material with no canonical family (no masonry term; fired clay is not `stone`).
+  brick: "other",
+  paint_coating: "paint",
+  wallcovering: "wallcovering",
+  // HPL is a paper/resin layered composite; worksurface/wall are roles, not the material family.
+  laminate: "composite",
+  // Acrylic + mineral-filler blend — the definition of an engineered composite.
+  solid_surface: "composite",
+  mineral_composite: "composite",
+  // Architectural resin panels (ecoresin, encapsulated-layer) are composites in practice.
+  resin: "composite",
+  linoleum: "resilient_flooring",
+  // In a list where textile and wallcovering are separate families, MIU vinyl means sheet/LVT flooring.
+  vinyl: "resilient_flooring",
+  // Rubber flooring is trade-canonical resilient flooring.
+  rubber: "resilient_flooring",
+  carpet: "carpet",
+  // A rug is loose-laid carpet; installation is not family.
+  rug: "carpet",
+  textile: "textile",
+  leather: "leather",
+  // PET felt is a nonwoven textile; "acoustic" is the role (MATERIAL_ROLES), not the family.
+  acoustic_felt: "textile",
+  // Layered/engineered acoustic panels; composite is the material-truth home.
+  acoustic_composite: "composite",
+  recycled_composite: "composite",
+  // Genuine architectural material (paper wall finishes, cardboard construction) with no canonical
+  // family; not textile, not composite.
+  paper_cardboard: "other",
+  biobased_composite: "composite",
+  // Living matter, not a material family; even `other` would falsely assert material-hood.
+  greenery_planting: null,
+  // FF&E product category; classifying the fixture's constituent materials would be a guess.
+  lighting: null,
+  // FF&E product category; usually metal, but asserting `metal` is a guess — never guess.
+  hardware: null,
+  // Screens/projected content — an experience layer, not a material.
+  digital_media: null,
+  // An assembly/element, not a material family.
+  water_feature: null,
+  // Spans multiple families; materialgraph models families as a multi-valued array, so a
+  // single-valued crosswalk cannot honestly pick one.
+  mixed_material: null,
+  // Granularity sentinel (it also appears in MATERIAL_GRANULARITIES), not a material identity.
+  color_palette_only: null,
+  // Epistemic sentinel — explicitly NOT `other` (unidentified is not identified-but-unclassifiable).
+  unknown: null
+};
+var MIU_PROJECT_SECTORS = [
+  "hospitality",
+  "food_and_beverage",
+  "workplace",
+  "residential",
+  "multifamily",
+  "retail_and_showroom",
+  "healthcare",
+  "wellness",
+  "education",
+  "civic",
+  "cultural",
+  "community",
+  "sports_recreation",
+  "entertainment",
+  "industrial",
+  "logistics",
+  "maker",
+  "transportation",
+  "landscape_public_realm",
+  "mixed_use",
+  "master_planning",
+  "temporary_exhibition",
+  "religious",
+  "senior_living",
+  "student_housing",
+  "unknown"
+];
+var MIU_SECTOR_TO_CANONICAL = {
+  hospitality: "hospitality",
+  // Restaurants and F&B venues are the hospitality sector at MG grain (MB's own analytics files
+  // "Hospitality: Restaurant").
+  food_and_beverage: "hospitality",
+  workplace: "workplace",
+  residential: "residential",
+  // Multi-unit housing is residential; MG mixed_use means mixed-use developments, not multifamily.
+  multifamily: "residential",
+  // Showrooms are retail environments.
+  retail_and_showroom: "retail",
+  healthcare: "healthcare",
+  // Spans hospitality spas, healthcare clinics, and fitness; no honest single sector term.
+  wellness: "other",
+  education: "education",
+  civic: "civic",
+  // Museums, galleries, and theatres are civic-cultural institutions at MG grain.
+  cultural: "civic",
+  // Community centres are civic infrastructure.
+  community: "civic",
+  // No sports sector; spans civic recreation and commercial venues.
+  sports_recreation: "other",
+  // Cinemas and venues; no canonical term.
+  entertainment: "other",
+  // Real sector with no canonical term.
+  industrial: "other",
+  // Real sector with no canonical term.
+  logistics: "other",
+  // Fabrication studios and workshops; nearer industrial than office workplace.
+  maker: "other",
+  transportation: "transportation",
+  // Parks and plazas are civic public realm.
+  landscape_public_realm: "civic",
+  mixed_use: "mixed_use",
+  // Spans sectors by definition — a single-valued crosswalk cannot honestly pick one (mirrors
+  // mixed_material in the family crosswalk).
+  master_planning: null,
+  // Exhibitions and installations; no canonical term.
+  temporary_exhibition: "other",
+  // Religious buildings are not civic government; real sector, no term.
+  religious: "other",
+  // A housing typology; the healthcare-adjacent bleed is accepted.
+  senior_living: "residential",
+  // A housing typology.
+  student_housing: "residential",
+  // Epistemic sentinel — explicitly NOT `other` (unidentified is not identified-but-unclassifiable).
+  unknown: null
+};
+var MIU_SURFACE_APPLICATIONS = [
+  "flooring",
+  "floor_inlay",
+  "stair_tread",
+  "stair_riser",
+  "wall_finish",
+  "wall_panel",
+  "wainscot",
+  "baseboard",
+  "trim",
+  "ceiling_finish",
+  "ceiling_cloud",
+  "column_wrap",
+  "door_finish",
+  "frame_finish",
+  "shower_wall",
+  "shower_floor",
+  "backsplash",
+  "vanity_top",
+  "toilet_partition",
+  "commercial_kitchen_floor",
+  "kitchen_wall",
+  "food_service_counter",
+  "laundry_floor",
+  "pool_deck_surface",
+  "reception_desk",
+  "bar_front",
+  "bar_top",
+  "back_bar",
+  "banquette_base",
+  "cabinet_front",
+  "shelving",
+  "display_fixture",
+  "closet_system",
+  "workstation_casework",
+  "checkout_counter",
+  "upholstery",
+  "loose_furniture",
+  "built_in_seating",
+  "banquette_upholstery",
+  "drapery",
+  "window_treatment",
+  "rug",
+  "carpet_tile",
+  "bedding",
+  "privacy_curtain",
+  "acoustic_fabric_panel",
+  "lighting_fixture",
+  "acoustic_treatment",
+  "partition",
+  "operable_wall",
+  "signage",
+  "wayfinding",
+  "hardware",
+  "plumbing_fixture",
+  "decorative_screen",
+  "art_installation",
+  "green_wall",
+  "facade_cladding",
+  "soffit",
+  "exterior_screen",
+  "paving",
+  "decking",
+  "outdoor_furniture",
+  "planter",
+  "pool_coping",
+  "shade_structure",
+  "railing",
+  "fence_screen",
+  "unknown"
+];
+var MIU_SURFACE_APPLICATION_TO_CANONICAL = {
+  flooring: "flooring",
+  // A decorative flooring detail.
+  floor_inlay: "flooring",
+  stair_tread: "stair_tread",
+  stair_riser: "stair_riser",
+  wall_finish: "wall",
+  // Panelised wall surface; still the wall zone.
+  wall_panel: "wall",
+  // Lower-wall treatment.
+  wainscot: "wall",
+  // Wall-base trim reads as the wall zone, not flooring.
+  baseboard: "wall",
+  // Architectural trim is millwork/joinery.
+  trim: "millwork",
+  ceiling_finish: "ceiling",
+  // A suspended ceiling element.
+  ceiling_cloud: "ceiling",
+  // Vertical surface cladding.
+  column_wrap: "wall",
+  door_finish: "door",
+  // Spans door, window, and facade frames; no honest single term.
+  frame_finish: null,
+  shower_wall: "wall_wet_shower",
+  // Wet-area flooring.
+  shower_floor: "flooring_wet_area",
+  backsplash: "wall_backsplash",
+  // A bathroom counter.
+  vanity_top: "countertop",
+  toilet_partition: "partition_toilet",
+  // Kitchen-zone application; MG's oil/wet flooring leaves would over-assume the condition.
+  commercial_kitchen_floor: "kitchen",
+  // Kitchen-zone application.
+  kitchen_wall: "kitchen",
+  // A service counter.
+  food_service_counter: "countertop",
+  // Wet-area flooring.
+  laundry_floor: "flooring_wet_area",
+  pool_deck_surface: "pool_decking",
+  // Reception desks are casework.
+  reception_desk: "millwork",
+  // The bar zone.
+  bar_front: "bar",
+  // The bar zone term is more specific than countertop.
+  bar_top: "bar",
+  // The bar zone.
+  back_bar: "bar",
+  // Built-in joinery base.
+  banquette_base: "millwork",
+  cabinet_front: "cabinetry",
+  // Built-in shelving is millwork.
+  shelving: "millwork",
+  // Retail display fixtures are casework.
+  display_fixture: "millwork",
+  // Closet systems are cabinetry.
+  closet_system: "cabinetry",
+  // Office systems furniture.
+  workstation_casework: "furniture_systems",
+  // A service counter.
+  checkout_counter: "countertop",
+  // Seating upholstery; upholstered walls have their own MIU entries.
+  upholstery: "furniture_seating",
+  loose_furniture: "furniture",
+  // Built-in seating.
+  built_in_seating: "furniture_seating",
+  // Banquette seating upholstery.
+  banquette_upholstery: "furniture_seating",
+  drapery: "vh_drapery",
+  // Generic; the shade/curtain leaves would over-assume the type.
+  window_treatment: "vertically_hanging",
+  // Loose floor covering.
+  rug: "flooring",
+  // Modular floor covering.
+  carpet_tile: "flooring",
+  bedding: "bedding",
+  privacy_curtain: "vh_privacy_curtain",
+  // An upholstered wall panel.
+  acoustic_fabric_panel: "wall_upholstered",
+  lighting_fixture: "lighting",
+  // Spans wall, ceiling, and baffle treatments; no honest single term.
+  acoustic_treatment: null,
+  partition: "partition",
+  // A movable partition.
+  operable_wall: "partition",
+  // No signage term; decor or ornamentation would be false.
+  signage: null,
+  // No wayfinding term.
+  wayfinding: null,
+  // Spans door, cabinet, and bath hardware — never guess.
+  hardware: null,
+  // Predominantly sanitary fixtures; the kitchen-sink bleed is accepted.
+  plumbing_fixture: "bath",
+  // A freestanding room divider.
+  decorative_screen: "partition",
+  // Artwork is decor at MG grain.
+  art_installation: "decor",
+  // A planted wall system is still a wall application.
+  green_wall: "wall",
+  facade_cladding: "facade",
+  // The underside plane; exterior soffits accepted as bleed.
+  soffit: "ceiling",
+  // Envelope screening.
+  exterior_screen: "facade",
+  paving: "paving_deck",
+  // General decking; pool decking has its own MIU entry.
+  decking: "paving_deck",
+  // The application vocabulary has no outdoor bucket.
+  outdoor_furniture: "furniture",
+  // Pots and planters are decor.
+  planter: "decor",
+  pool_coping: "pool_coping",
+  // Awning/tensile family; a specific leaf would over-assume.
+  shade_structure: "awning_umbrella",
+  // Railings and balustrades live under stair & elevator.
+  railing: "stair_railing",
+  // Exterior fencing; no canonical term.
+  fence_screen: null,
+  // Epistemic sentinel.
+  unknown: null
+};
+var MIU_MATERIAL_FAMILY_SET = new Set(MIU_MATERIAL_FAMILIES);
+var MIU_PROJECT_SECTOR_SET = new Set(MIU_PROJECT_SECTORS);
+var MIU_SURFACE_APPLICATION_SET = new Set(MIU_SURFACE_APPLICATIONS);
+var isMiuMaterialFamily = (value) => MIU_MATERIAL_FAMILY_SET.has(value);
+var isMiuProjectSector = (value) => MIU_PROJECT_SECTOR_SET.has(value);
+var isMiuSurfaceApplication = (value) => MIU_SURFACE_APPLICATION_SET.has(value);
+var miuFamilyToCanonical = (value) => isMiuMaterialFamily(value) ? MIU_FAMILY_TO_CANONICAL[value] : null;
+var miuSectorToCanonical = (value) => isMiuProjectSector(value) ? MIU_SECTOR_TO_CANONICAL[value] : null;
+var miuSurfaceApplicationToCanonical = (value) => isMiuSurfaceApplication(value) ? MIU_SURFACE_APPLICATION_TO_CANONICAL[value] : null;
+export {
+  MIU_FAMILY_TO_CANONICAL,
+  MIU_MATERIAL_FAMILIES,
+  MIU_PROJECT_SECTORS,
+  MIU_SECTOR_TO_CANONICAL,
+  MIU_SURFACE_APPLICATIONS,
+  MIU_SURFACE_APPLICATION_TO_CANONICAL,
+  miuFamilyToCanonical,
+  miuSectorToCanonical,
+  miuSurfaceApplicationToCanonical
+};

package/dist/index.d.ts

@@ -0,0 +1,28 @@
+interface TaxonomyTerm {
+    id: string;
+    label: string;
+    /** Explicitly authored Material Semantics id (dashed); absent where upstream authored none. */
+    semanticId?: string;
+    /** Parent term id for hierarchical dictionaries (applications). */
+    broaderTermId?: string;
+}
+declare const PROVENANCE: {
+    readonly snapshot: "2026-07-08";
+    readonly source: "materialgraph packages/schema/src/registry/value-dictionaries.ts";
+};
+declare const MATERIAL_FAMILY_TERMS: readonly TaxonomyTerm[];
+declare const MATERIAL_FAMILIES: readonly ["paint", "wall_finish", "wallcovering", "textile", "upholstery", "carpet", "wood", "stone", "tile", "terrazzo", "metal", "glass", "resilient_flooring", "composite", "concrete", "leather", "other"];
+type MaterialFamily = (typeof MATERIAL_FAMILIES)[number];
+declare const isMaterialFamily: (value: string) => value is MaterialFamily;
+declare const SECTOR_TERMS: readonly TaxonomyTerm[];
+declare const SECTORS: readonly ["hospitality", "healthcare", "workplace", "residential", "retail", "education", "civic", "mixed_use", "transportation", "other"];
+type Sector = (typeof SECTORS)[number];
+declare const isSector: (value: string) => value is Sector;
+declare const APPLICATION_TERMS: readonly TaxonomyTerm[];
+declare const APPLICATIONS: readonly ["wall", "flooring", "ceiling", "bath", "kitchen", "furniture", "lighting", "door", "window", "facade", "countertop", "fireplace", "stair_elevator", "bedding", "decor", "vertically_hanging", "transportation", "pool_fountain", "paving_deck", "partition", "millwork", "cabinetry", "masonry", "roof", "garage", "bar", "awning_umbrella", "recreation_sport", "ornamentation", "aquatic_environments", "wall_backsplash", "wall_upholstered", "wall_wet_shower", "flooring_wet_area", "flooring_entrance", "flooring_radiant_heat", "flooring_or_lab", "flooring_anti_fatigue", "flooring_esd", "flooring_safety_slip", "flooring_raised_access", "flooring_rigid_core", "flooring_dining_area", "flooring_subject_oil", "flooring_walk_in_freezer", "flooring_ramps_inclines", "furniture_seating", "furniture_headboard", "furniture_slipcover", "furniture_systems", "furniture_tackboard", "furniture_throw_pillow", "fireplace_firebox", "fireplace_hearth", "fireplace_mantel", "fireplace_surround", "bedding_bed_scarf", "bedding_sheets", "bedding_skirt", "bedding_bedspread", "bedding_box_spring_cover", "stair_riser", "stair_tread", "stair_railing", "stair_elevator_cladding", "vh_drapery", "vh_privacy_curtain", "vh_shower_curtain", "vh_theatrical_curtain", "vh_window_shade", "transportation_automotive", "transportation_aviation", "transportation_marine", "pool_coping", "pool_decking", "pool_lining", "paving_covered_areas", "paving_patio", "partition_toilet", "masonry_structural", "masonry_veneer", "recreation_gymnasium", "recreation_playground", "recreation_weightlifting", "awning", "tensile_structure", "umbrella", "countertop_chemical_resistant"];
+type Application = (typeof APPLICATIONS)[number];
+declare const isApplication: (value: string) => value is Application;
+declare const APPLICATION_PARENTS: Readonly<Partial<Record<Application, Application>>>;
+declare const applicationTopLevelOf: (application: Application) => Application;
+
+export { APPLICATIONS, APPLICATION_PARENTS, APPLICATION_TERMS, type Application, MATERIAL_FAMILIES, MATERIAL_FAMILY_TERMS, type MaterialFamily, PROVENANCE, SECTORS, SECTOR_TERMS, type Sector, type TaxonomyTerm, applicationTopLevelOf, isApplication, isMaterialFamily, isSector };

package/dist/index.js

@@ -0,0 +1,350 @@
+// src/index.ts
+var PROVENANCE = {
+  snapshot: "2026-07-08",
+  source: "materialgraph packages/schema/src/registry/value-dictionaries.ts"
+};
+var MATERIAL_FAMILY_TERMS = [
+  { id: "paint", label: "Paint", semanticId: "material-family.paint" },
+  { id: "wall_finish", label: "Wall Finish", semanticId: "material-family.wall-finish" },
+  { id: "wallcovering", label: "Wallcovering", semanticId: "material-family.wallcovering" },
+  { id: "textile", label: "Textile", semanticId: "material-family.textile" },
+  { id: "upholstery", label: "Upholstery", semanticId: "material-family.upholstery" },
+  { id: "carpet", label: "Carpet", semanticId: "material-family.carpet" },
+  { id: "wood", label: "Wood", semanticId: "material-family.wood" },
+  { id: "stone", label: "Stone", semanticId: "material-family.stone" },
+  { id: "tile", label: "Tile", semanticId: "material-family.tile" },
+  { id: "terrazzo", label: "Terrazzo", semanticId: "material-family.terrazzo" },
+  { id: "metal", label: "Metal", semanticId: "material-family.metal" },
+  { id: "glass", label: "Glass", semanticId: "material-family.glass" },
+  {
+    id: "resilient_flooring",
+    label: "Resilient Flooring",
+    semanticId: "material-family.resilient-flooring"
+  },
+  { id: "composite", label: "Composite", semanticId: "material-family.composite" },
+  { id: "concrete", label: "Concrete", semanticId: "material-family.concrete" },
+  { id: "leather", label: "Leather", semanticId: "material-family.leather" },
+  { id: "other", label: "Other", semanticId: "material-family.other" }
+];
+var MATERIAL_FAMILIES = [
+  "paint",
+  "wall_finish",
+  "wallcovering",
+  "textile",
+  "upholstery",
+  "carpet",
+  "wood",
+  "stone",
+  "tile",
+  "terrazzo",
+  "metal",
+  "glass",
+  "resilient_flooring",
+  "composite",
+  "concrete",
+  "leather",
+  "other"
+];
+var MATERIAL_FAMILY_SET = new Set(MATERIAL_FAMILIES);
+var isMaterialFamily = (value) => MATERIAL_FAMILY_SET.has(value);
+var SECTOR_TERMS = [
+  { id: "hospitality", label: "Hospitality", semanticId: "sector.hospitality" },
+  { id: "healthcare", label: "Healthcare", semanticId: "sector.healthcare" },
+  { id: "workplace", label: "Workplace", semanticId: "sector.workplace" },
+  { id: "residential", label: "Residential", semanticId: "sector.residential" },
+  { id: "retail", label: "Retail", semanticId: "sector.retail" },
+  { id: "education", label: "Education", semanticId: "sector.education" },
+  { id: "civic", label: "Civic", semanticId: "sector.civic" },
+  { id: "mixed_use", label: "Mixed-Use", semanticId: "sector.mixed-use" },
+  { id: "transportation", label: "Transportation", semanticId: "sector.transportation" },
+  { id: "other", label: "Other", semanticId: "sector.other" }
+];
+var SECTORS = [
+  "hospitality",
+  "healthcare",
+  "workplace",
+  "residential",
+  "retail",
+  "education",
+  "civic",
+  "mixed_use",
+  "transportation",
+  "other"
+];
+var SECTOR_SET = new Set(SECTORS);
+var isSector = (value) => SECTOR_SET.has(value);
+var APPLICATION_TERMS = [
+  { id: "wall", label: "Wall" },
+  { id: "flooring", label: "Flooring" },
+  { id: "ceiling", label: "Ceiling" },
+  { id: "bath", label: "Bath" },
+  { id: "kitchen", label: "Kitchen" },
+  { id: "furniture", label: "Furniture" },
+  { id: "lighting", label: "Lighting" },
+  { id: "door", label: "Door" },
+  { id: "window", label: "Window" },
+  { id: "facade", label: "Facade" },
+  { id: "countertop", label: "Countertop" },
+  { id: "fireplace", label: "Fireplace" },
+  { id: "stair_elevator", label: "Stair & Elevator" },
+  { id: "bedding", label: "Bedding" },
+  { id: "decor", label: "Decor" },
+  { id: "vertically_hanging", label: "Vertically Hanging" },
+  { id: "transportation", label: "Transportation" },
+  { id: "pool_fountain", label: "Pool & Fountain" },
+  { id: "paving_deck", label: "Paving & Deck" },
+  { id: "partition", label: "Partition" },
+  { id: "millwork", label: "Millwork" },
+  { id: "cabinetry", label: "Cabinetry" },
+  { id: "masonry", label: "Masonry" },
+  { id: "roof", label: "Roof" },
+  { id: "garage", label: "Garage" },
+  { id: "bar", label: "Bar" },
+  { id: "awning_umbrella", label: "Awning & Umbrella" },
+  { id: "recreation_sport", label: "Recreation & Sport" },
+  { id: "ornamentation", label: "Ornamentation" },
+  { id: "aquatic_environments", label: "Aquatic Environments" },
+  { id: "wall_backsplash", label: "Backsplash", broaderTermId: "wall" },
+  { id: "wall_upholstered", label: "Upholstered Wall", broaderTermId: "wall" },
+  { id: "wall_wet_shower", label: "Wet Wall & Shower Wall", broaderTermId: "wall" },
+  { id: "flooring_wet_area", label: "Wet Area Flooring", broaderTermId: "flooring" },
+  { id: "flooring_entrance", label: "Entrance & Walk-Off Flooring", broaderTermId: "flooring" },
+  {
+    id: "flooring_radiant_heat",
+    label: "Flooring for Radiant Heat Systems",
+    broaderTermId: "flooring"
+  },
+  { id: "flooring_or_lab", label: "Operating Rooms & Labs", broaderTermId: "flooring" },
+  { id: "flooring_anti_fatigue", label: "Anti-Fatigue Flooring", broaderTermId: "flooring" },
+  { id: "flooring_esd", label: "Electrostatic Dissipative Flooring", broaderTermId: "flooring" },
+  {
+    id: "flooring_safety_slip",
+    label: "Safety & Slip-Resistant Flooring",
+    broaderTermId: "flooring"
+  },
+  { id: "flooring_raised_access", label: "Raised Access Flooring", broaderTermId: "flooring" },
+  { id: "flooring_rigid_core", label: "Rigid Core Flooring", broaderTermId: "flooring" },
+  { id: "flooring_dining_area", label: "Dining Area Flooring", broaderTermId: "flooring" },
+  { id: "flooring_subject_oil", label: "Subject to Oil Flooring", broaderTermId: "flooring" },
+  { id: "flooring_walk_in_freezer", label: "Walk-In Freezer", broaderTermId: "flooring" },
+  { id: "flooring_ramps_inclines", label: "Ramps & Inclines", broaderTermId: "flooring" },
+  { id: "furniture_seating", label: "Seating", broaderTermId: "furniture" },
+  { id: "furniture_headboard", label: "Headboard", broaderTermId: "furniture" },
+  { id: "furniture_slipcover", label: "Slipcover", broaderTermId: "furniture" },
+  { id: "furniture_systems", label: "Systems Furniture", broaderTermId: "furniture" },
+  { id: "furniture_tackboard", label: "Tackboard", broaderTermId: "furniture" },
+  { id: "furniture_throw_pillow", label: "Throw Pillow", broaderTermId: "furniture" },
+  { id: "fireplace_firebox", label: "Firebox", broaderTermId: "fireplace" },
+  { id: "fireplace_hearth", label: "Fireplace Hearth", broaderTermId: "fireplace" },
+  { id: "fireplace_mantel", label: "Fireplace Mantel", broaderTermId: "fireplace" },
+  { id: "fireplace_surround", label: "Fireplace Surround", broaderTermId: "fireplace" },
+  { id: "bedding_bed_scarf", label: "Bed Scarf", broaderTermId: "bedding" },
+  { id: "bedding_sheets", label: "Bed Sheets", broaderTermId: "bedding" },
+  { id: "bedding_skirt", label: "Bed Skirt", broaderTermId: "bedding" },
+  { id: "bedding_bedspread", label: "Bedspread", broaderTermId: "bedding" },
+  { id: "bedding_box_spring_cover", label: "Box Spring Cover", broaderTermId: "bedding" },
+  { id: "stair_riser", label: "Stair Riser", broaderTermId: "stair_elevator" },
+  { id: "stair_tread", label: "Stair Tread", broaderTermId: "stair_elevator" },
+  { id: "stair_railing", label: "Railing", broaderTermId: "stair_elevator" },
+  { id: "stair_elevator_cladding", label: "Elevator Cladding", broaderTermId: "stair_elevator" },
+  { id: "vh_drapery", label: "Drapery", broaderTermId: "vertically_hanging" },
+  { id: "vh_privacy_curtain", label: "Privacy Curtain", broaderTermId: "vertically_hanging" },
+  { id: "vh_shower_curtain", label: "Shower Curtain", broaderTermId: "vertically_hanging" },
+  { id: "vh_theatrical_curtain", label: "Theatrical Curtain", broaderTermId: "vertically_hanging" },
+  { id: "vh_window_shade", label: "Window Shade", broaderTermId: "vertically_hanging" },
+  { id: "transportation_automotive", label: "Automotive", broaderTermId: "transportation" },
+  { id: "transportation_aviation", label: "Aviation", broaderTermId: "transportation" },
+  { id: "transportation_marine", label: "Marine", broaderTermId: "transportation" },
+  { id: "pool_coping", label: "Pool Coping", broaderTermId: "pool_fountain" },
+  { id: "pool_decking", label: "Pool Decking", broaderTermId: "pool_fountain" },
+  { id: "pool_lining", label: "Pool Lining", broaderTermId: "pool_fountain" },
+  { id: "paving_covered_areas", label: "Covered Areas", broaderTermId: "paving_deck" },
+  { id: "paving_patio", label: "Patio", broaderTermId: "paving_deck" },
+  { id: "partition_toilet", label: "Toilet Partition", broaderTermId: "partition" },
+  { id: "masonry_structural", label: "Structural Masonry", broaderTermId: "masonry" },
+  { id: "masonry_veneer", label: "Veneer Masonry", broaderTermId: "masonry" },
+  { id: "recreation_gymnasium", label: "Gymnasium", broaderTermId: "recreation_sport" },
+  { id: "recreation_playground", label: "Playground", broaderTermId: "recreation_sport" },
+  {
+    id: "recreation_weightlifting",
+    label: "Weightlifting Room",
+    broaderTermId: "recreation_sport"
+  },
+  { id: "awning", label: "Awning", broaderTermId: "awning_umbrella" },
+  { id: "tensile_structure", label: "Tensile Structure", broaderTermId: "awning_umbrella" },
+  { id: "umbrella", label: "Umbrella", broaderTermId: "awning_umbrella" },
+  {
+    id: "countertop_chemical_resistant",
+    label: "Chemical Resistant Top",
+    broaderTermId: "countertop"
+  }
+];
+var APPLICATIONS = [
+  // Top-level (30)
+  "wall",
+  "flooring",
+  "ceiling",
+  "bath",
+  "kitchen",
+  "furniture",
+  "lighting",
+  "door",
+  "window",
+  "facade",
+  "countertop",
+  "fireplace",
+  "stair_elevator",
+  "bedding",
+  "decor",
+  "vertically_hanging",
+  "transportation",
+  "pool_fountain",
+  "paving_deck",
+  "partition",
+  "millwork",
+  "cabinetry",
+  "masonry",
+  "roof",
+  "garage",
+  "bar",
+  "awning_umbrella",
+  "recreation_sport",
+  "ornamentation",
+  "aquatic_environments",
+  // Children (58)
+  "wall_backsplash",
+  "wall_upholstered",
+  "wall_wet_shower",
+  "flooring_wet_area",
+  "flooring_entrance",
+  "flooring_radiant_heat",
+  "flooring_or_lab",
+  "flooring_anti_fatigue",
+  "flooring_esd",
+  "flooring_safety_slip",
+  "flooring_raised_access",
+  "flooring_rigid_core",
+  "flooring_dining_area",
+  "flooring_subject_oil",
+  "flooring_walk_in_freezer",
+  "flooring_ramps_inclines",
+  "furniture_seating",
+  "furniture_headboard",
+  "furniture_slipcover",
+  "furniture_systems",
+  "furniture_tackboard",
+  "furniture_throw_pillow",
+  "fireplace_firebox",
+  "fireplace_hearth",
+  "fireplace_mantel",
+  "fireplace_surround",
+  "bedding_bed_scarf",
+  "bedding_sheets",
+  "bedding_skirt",
+  "bedding_bedspread",
+  "bedding_box_spring_cover",
+  "stair_riser",
+  "stair_tread",
+  "stair_railing",
+  "stair_elevator_cladding",
+  "vh_drapery",
+  "vh_privacy_curtain",
+  "vh_shower_curtain",
+  "vh_theatrical_curtain",
+  "vh_window_shade",
+  "transportation_automotive",
+  "transportation_aviation",
+  "transportation_marine",
+  "pool_coping",
+  "pool_decking",
+  "pool_lining",
+  "paving_covered_areas",
+  "paving_patio",
+  "partition_toilet",
+  "masonry_structural",
+  "masonry_veneer",
+  "recreation_gymnasium",
+  "recreation_playground",
+  "recreation_weightlifting",
+  "awning",
+  "tensile_structure",
+  "umbrella",
+  "countertop_chemical_resistant"
+];
+var APPLICATION_SET = new Set(APPLICATIONS);
+var isApplication = (value) => APPLICATION_SET.has(value);
+var APPLICATION_PARENTS = {
+  wall_backsplash: "wall",
+  wall_upholstered: "wall",
+  wall_wet_shower: "wall",
+  flooring_wet_area: "flooring",
+  flooring_entrance: "flooring",
+  flooring_radiant_heat: "flooring",
+  flooring_or_lab: "flooring",
+  flooring_anti_fatigue: "flooring",
+  flooring_esd: "flooring",
+  flooring_safety_slip: "flooring",
+  flooring_raised_access: "flooring",
+  flooring_rigid_core: "flooring",
+  flooring_dining_area: "flooring",
+  flooring_subject_oil: "flooring",
+  flooring_walk_in_freezer: "flooring",
+  flooring_ramps_inclines: "flooring",
+  furniture_seating: "furniture",
+  furniture_headboard: "furniture",
+  furniture_slipcover: "furniture",
+  furniture_systems: "furniture",
+  furniture_tackboard: "furniture",
+  furniture_throw_pillow: "furniture",
+  fireplace_firebox: "fireplace",
+  fireplace_hearth: "fireplace",
+  fireplace_mantel: "fireplace",
+  fireplace_surround: "fireplace",
+  bedding_bed_scarf: "bedding",
+  bedding_sheets: "bedding",
+  bedding_skirt: "bedding",
+  bedding_bedspread: "bedding",
+  bedding_box_spring_cover: "bedding",
+  stair_riser: "stair_elevator",
+  stair_tread: "stair_elevator",
+  stair_railing: "stair_elevator",
+  stair_elevator_cladding: "stair_elevator",
+  vh_drapery: "vertically_hanging",
+  vh_privacy_curtain: "vertically_hanging",
+  vh_shower_curtain: "vertically_hanging",
+  vh_theatrical_curtain: "vertically_hanging",
+  vh_window_shade: "vertically_hanging",
+  transportation_automotive: "transportation",
+  transportation_aviation: "transportation",
+  transportation_marine: "transportation",
+  pool_coping: "pool_fountain",
+  pool_decking: "pool_fountain",
+  pool_lining: "pool_fountain",
+  paving_covered_areas: "paving_deck",
+  paving_patio: "paving_deck",
+  partition_toilet: "partition",
+  masonry_structural: "masonry",
+  masonry_veneer: "masonry",
+  recreation_gymnasium: "recreation_sport",
+  recreation_playground: "recreation_sport",
+  recreation_weightlifting: "recreation_sport",
+  awning: "awning_umbrella",
+  tensile_structure: "awning_umbrella",
+  umbrella: "awning_umbrella",
+  countertop_chemical_resistant: "countertop"
+};
+var applicationTopLevelOf = (application) => APPLICATION_PARENTS[application] ?? application;
+export {
+  APPLICATIONS,
+  APPLICATION_PARENTS,
+  APPLICATION_TERMS,
+  MATERIAL_FAMILIES,
+  MATERIAL_FAMILY_TERMS,
+  PROVENANCE,
+  SECTORS,
+  SECTOR_TERMS,
+  applicationTopLevelOf,
+  isApplication,
+  isMaterialFamily,
+  isSector
+};

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@instruments/taxonomy",
+  "version": "0.1.0",
+  "description": "Canonical materials taxonomy for the Material Instruments ecosystem — governed dictionaries (material families, sectors, applications) and consumer crosswalks.",
+  "license": "SEE LICENSE IN LICENSE",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/materialinstruments/taxonomy.git"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./crosswalks/miu": {
+      "types": "./dist/crosswalks/miu.d.ts",
+      "import": "./dist/crosswalks/miu.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@howells/lint": "^1.0.0",
+    "@types/node": "^24.0.0",
+    "tsup": "^8.5.1",
+    "typescript": "^5.7.0",
+    "vitest": "^4.0.0"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsup",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "lint": "howells-check ."
+  }
+}