@instruments/taxonomy 2.2.1 → 2.5.0

package/dist/application-children-rest.d.ts

@@ -0,0 +1,2 @@
+import type { Term } from "./term.js";
+export declare const APPLICATION_CHILDREN_REST: readonly Term[];

package/dist/application-children.d.ts

@@ -0,0 +1,2 @@
+import type { Term } from "./term.js";
+export declare const APPLICATION_CHILDREN: readonly Term[];

package/dist/application-shared.d.ts

@@ -0,0 +1,20 @@
+import type { ExternalMapping, MatchStrength, SearchedWithout, TermRelation } from "./term.js";
+/**
+ * "This term is a material-suitability claim about that space." The edge runs FROM the claim TO the
+ * space, so it sits here and not on the SPACE axis (see the comment on `space.bathroom`).
+ */
+export declare const suitableFor: (...spaces: readonly string[]) => TermRelation[];
+/** "Typically found in that space": a claim of habit, never of exclusivity. */
+export declare const typicallyIn: (...spaces: readonly string[]) => TermRelation[];
+/**
+ * Association with no stronger claim available, to a fully qualified target. Authored from the
+ * APPLICATION side only where the other term comes later in the direction order.
+ */
+export declare const relatedTo: (...targets: readonly string[]) => TermRelation[];
+export declare const uniclass: (identifier: string, label: string, match: MatchStrength) => ExternalMapping;
+export declare const aat: (identifier: string, label: string, match: MatchStrength) => ExternalMapping;
+export declare const wikidata: (identifier: string, label: string, match: MatchStrength) => ExternalMapping;
+type SearchedScheme = "aat" | "uniclass" | "wikidata";
+/** Dated negatives for one term: the same query, run against each scheme that had nothing for it. */
+export declare const searched: (query: string, ...schemes: readonly SearchedScheme[]) => SearchedWithout[];
+export {};

package/dist/application-terms.d.ts

@@ -0,0 +1,2 @@
+import type { Term } from "./term.js";
+export declare const APPLICATION_TERMS: readonly Term[];

package/dist/assertions.d.ts

@@ -1,6 +1,6 @@
 import type { RelationPredicate, Term } from "./term.js";
 /** The relation predicates, at runtime. TypeScript cannot enumerate a union, so this is by hand. */
-export declare const RELATION_PREDICATES: readonly ["blend-of", "evokes", "influenced-by", "part-of", "reads-as", "related-to", "serves", "suitable-for", "typically-in"];
+export declare const RELATION_PREDICATES: readonly ["blend-of", "evokes", "filed-under", "influenced-by", "part-of", "reads-as", "related-to", "serves", "suitable-for", "typically-in"];
 type AssertNever<T extends never> = T;
 /**
  * The totality guard, and it is load-bearing rather than decorative: a predicate added to `term.ts`

package/dist/authoring.d.ts

@@ -23,7 +23,7 @@ export { KNOWLEDGE_GRAPH, PHRASE_ENTRIES, TAXONOMY_BASE_URI, type AxisNode, type
 export declare const MATERIAL_FAMILIES: readonly ["paint", "wall-finish", "wallcovering", "textile", "upholstery", "carpet", "wood", "stone", "tile", "terrazzo", "metal", "glass", "resilient-flooring", "composite", "concrete", "leather", "other"];
 export type MaterialFamily = (typeof MATERIAL_FAMILIES)[number];
 export declare const isMaterialFamily: (value: string) => value is MaterialFamily;
-export declare const SECTORS: readonly ["hospitality", "healthcare", "workplace", "residential", "retail", "education", "civic", "mixed-use", "transportation", "other", "commercial", "industrial", "senior-living", "government", "science-technology", "cultural", "sports-recreation", "marine", "urban-design-planning", "energy-utilities", "mission-critical-data-centres"];
+export declare const SECTORS: readonly ["hospitality", "healthcare", "workplace", "residential", "retail", "education", "civic", "mixed-use", "transportation", "other", "commercial", "industrial", "senior-living", "government", "science-technology", "cultural", "sports-recreation", "marine", "urban-design-planning", "energy-utilities", "mission-critical-data-centres", "aviation"];
 export type Sector = (typeof SECTORS)[number];
 export declare const isSector: (value: string) => value is Sector;
 export 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", "upholstery", "trim", "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"];

package/dist/axes/element-shared.d.ts

@@ -11,3 +11,4 @@ export declare const WINDOW = "window";
 export declare const EF_EXTERNAL_WALLS = "External walls";
 export declare const EF_FRAMED_STRUCTURES = "Framed structures";
 export declare const partOf: (elementId: string) => TermRelation;
+export declare const typicallyIn: (spaceId: string) => TermRelation;

package/dist/axes/external-search.d.ts

@@ -0,0 +1,12 @@
+/** The day the Uniclass and Getty AAT searches behind the `searchedWithout` records were run. */
+export declare const SEARCHED_ON = "2026-10-21";
+/** The day the TAX-66 searches ran: the terms TAX-65 left unsearched, and its AAT and Wikidata retries. */
+export declare const SEARCHED_ON_TAX66 = "2026-10-22";
+/** The Wikidata entity search API, paced at one request a second. */
+export declare const WIKIDATA_SEARCH = "https://www.wikidata.org/w/api.php?action=wbsearchentities";
+/** Getty's SPARQL endpoint, queried for AAT preferred labels and scope notes. */
+export declare const GETTY_SPARQL = "https://vocab.getty.edu/sparql";
+/** The NBS Uniclass site search. */
+export declare const UNICLASS_SEARCH = "https://uniclass.thenbs.com/search";
+/** The published NBS Uniclass tables, searched by title. */
+export declare const UNICLASS_DOWNLOAD = "https://uniclass.thenbs.com/download";

package/dist/axes/finish-shared.d.ts

@@ -0,0 +1,8 @@
+import type { Term, UsageBand } from "../term.js";
+export declare const reviewed: (slug: string, label: string, definition: string, source: string, extra?: Partial<Term>) => Term;
+export declare const authored: (slug: string, label: string, definition: string, extra?: Partial<Term>) => Term;
+export declare const term: (slug: string, label: string, definition: string) => Term;
+/** Vendored verbatim from a materials-retrieval dictionary; `rank` carries the ladder's order. */
+export declare const vendored: (source: string, slug: string, label: string, definition: string, rank?: number) => Term;
+/** Restored from the source column a normalisation dropped it from; `usage` carries the band. */
+export declare const repaired: (slug: string, label: string, definition: string, band: UsageBand, note: string) => Term;

package/dist/axes/finish-texture.d.ts

@@ -0,0 +1,3 @@
+import type { Term } from "../term.js";
+/** What the surface feels like, or reads as under a raking light. Unordered. */
+export declare const FINISH_TEXTURE_TERMS: readonly Term[];

package/dist/axes/finish.d.ts

@@ -1,9 +1,8 @@
 import type { Term } from "../term.js";
+export { FINISH_TEXTURE_TERMS } from "./finish-texture.js";
 /** How the exposed surface was produced. Unordered. */
 export declare const FINISH_TREATMENT_TERMS: readonly Term[];
 /** Ordered sheen grades plus unranked broader descriptions; see the header. */
 export declare const FINISH_SHEEN_TERMS: readonly Term[];
-/** What the surface feels like, or reads as under a raking light. Unordered. */
-export declare const FINISH_TEXTURE_TERMS: readonly Term[];
 /** Kept for consumers importing the axis as one list; prefer the facets. */
 export declare const FINISH_TERMS: readonly Term[];

package/dist/axes/material-composition.d.ts

@@ -1,4 +1,4 @@
-import type { ExternalMapping, ExternalScheme, MatchStrength, SourceBasis, Term } from "../term.js";
+import type { ExternalMapping, ExternalScheme, MatchStrength, SearchedWithout, SourceBasis, Term, TermRelation } from "../term.js";
 export declare const COMPOSITION_REVIEW_DATE = "2026-09-22";
 /** The standard argument of a term no public reference defines; it is `authored`, not referenced. */
 export declare const IN_HOUSE_DEFINITION = "in-house definition";
@@ -16,4 +16,10 @@ export declare const authoredTerm: (slug: string, label: string, definition: str
  * carries its term's lifecycle, so the review date is what marks the re-parenting.
  */
 export declare const reparented: (term: Term) => Term;
+/** Shelves a material under a material family for retrieval. Read down the material hierarchy. */
+export declare const filedUnder: (family: string) => TermRelation;
+/** Places a material in a space the trade expects to meet it: a habit, never an exclusivity. */
+export declare const typicallyIn: (space: string) => TermRelation;
 export declare const externalMapping: (scheme: ExternalScheme, identifier: string, label: string, match?: MatchStrength) => ExternalMapping;
+export declare const searchedAat: (query: string) => SearchedWithout;
+export declare const searchedWikidata: (query: string) => SearchedWithout;

package/dist/axes/material-everyday-natural.d.ts

@@ -0,0 +1,2 @@
+import type { Term } from "../term.js";
+export declare const MATERIAL_EVERYDAY_NATURAL_TERMS: readonly Term[];

package/dist/axes/material-everyday-shared.d.ts

@@ -0,0 +1,7 @@
+import type { Term } from "../term.js";
+export declare const REVIEW_DATE = "2026-09-11";
+export declare const REVIEW_SOURCE = "everyday-interiors vocabulary review";
+export declare const STONE_TARGET = "material.stone";
+export declare const wikidata: (id: string, label: string) => string;
+export declare const reviewed: (slug: string, label: string, definition: string, source: string, extra?: Partial<Term>) => Term;
+export declare const authored: (slug: string, label: string, definition: string, extra?: Partial<Term>) => Term;

package/dist/axes/material-polymers-shared.d.ts

@@ -0,0 +1,15 @@
+import type { ExternalScheme, SearchedWithout } from "../term.js";
+export declare const searchedUniclass: (query: string) => readonly SearchedWithout[];
+export declare const EU_1007_2011: ExternalScheme;
+export declare const FTC_16CFR303: ExternalScheme;
+export declare const ISO_1043_1: ExternalScheme;
+export declare const ISO_1629: ExternalScheme;
+export declare const ISO_2076: ExternalScheme;
+export declare const STANDARD_ISO_1043_1 = "ISO 1043-1:2011+Amd 1:2016";
+export declare const STANDARD_ISO_1629_RUBBER = "ISO 1629:2025";
+export declare const STANDARD_FTC = "US FTC 16 CFR 303.7";
+export declare const NARROW = "narrow";
+export declare const BROAD = "broad";
+export declare const POLYMER_SLUG = "polymer";
+export declare const PLASTIC_SLUG = "plastic";
+export declare const PLASTIC_DATE = "2026-10-14";

package/dist/axes/material-polymers-variants.d.ts

@@ -0,0 +1,2 @@
+import type { Term } from "../term.js";
+export declare const MATERIAL_POLYMER_VARIANT_TERMS: readonly Term[];

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

@@ -0,0 +1,4 @@
+import type { Term } from "../term.js";
+export declare const ANIMAL_PRINT_SLUG = "animal-print";
+/** The skin and hide motifs beneath `animal-print`, split out of pattern.ts so that file stays under the line budget. */
+export declare const PATTERN_ANIMAL_TERMS: readonly Term[];

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

@@ -0,0 +1,9 @@
+import type { Term } from "../term.js";
+/** How big the repeat is. Ordered, micro to oversized. */
+export declare const PATTERN_SCALE_TERMS: readonly Term[];
+/** How much of the field the motif occupies. Ordered, none to dense. */
+export declare const PATTERN_DENSITY_TERMS: readonly Term[];
+/** How strictly the repeat is governed. Ordered, uniform to organic. */
+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[];

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

@@ -1,4 +1,8 @@
-import type { Term } from "../term.js";
+import type { SearchedWithout, Term, TermRelation } from "../term.js";
+/** An association with no stronger predicate, read the same on every pattern and finish term. */
+export declare const relatedTo: (target: string) => TermRelation;
+/** A surface that reads as a material it is not made of. */
+export declare const readsAs: (target: string) => TermRelation;
 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";
@@ -8,3 +12,5 @@ export declare const pimTerm: (slug: string, label: string, definition: string,
 /** 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;
+/** Completed NBS searches from the TAX-65 external-vocabulary review. */
+export declare const searchedUniclass: (query: string) => SearchedWithout;

package/dist/axes/pattern.d.ts

@@ -1,14 +1,7 @@
 import type { Term } from "../term.js";
 export { PATTERN_FIGURE_TERMS } from "./pattern-figure.js";
+export { PATTERN_DENSITY_TERMS, PATTERN_DIRECTIONALITY_TERMS, PATTERN_REGULARITY_TERMS, PATTERN_SCALE_TERMS, } from "./pattern-grades.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. */
-export declare const PATTERN_SCALE_TERMS: readonly Term[];
-/** How much of the field the motif occupies. Ordered, none to dense. */
-export declare const PATTERN_DENSITY_TERMS: readonly Term[];
-/** How strictly the repeat is governed. Ordered, uniform to organic. */
-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[];
 /** Kept for consumers importing the axis as one list; prefer the facets. */
 export declare const PATTERN_TERMS: readonly Term[];

package/dist/axes/space/shared.d.ts

@@ -18,6 +18,12 @@ export declare const PROGRAM_SPACES: TermProvenance;
  * predicate has to read the same on all of them.
  */
 export declare const relatedTo: (target: string) => TermRelation;
+/**
+ * A room that sits in a kind of building as a matter of habit: a classroom in a school, a ballroom
+ * in a hotel. A claim of occurrence, never of identity (that is `serves`) and never of
+ * exclusivity. The argument is a TYPOLOGY slug.
+ */
+export declare const typicallyIn: (typology: string) => TermRelation;
 /**
  * The market this space exists to serve, wherever the building that contains it stands.
  *
@@ -28,3 +34,5 @@ export declare const relatedTo: (target: string) => TermRelation;
  * fails to compile rather than dangling at test time.
  */
 export declare const serves: (market: Sector) => TermRelation;
+/** Current NBS titles are referenced verbatim, without adapting the classification. */
+export declare const uniclass: (identifier: string, label: string, match: MatchStrength) => ExternalMapping;

package/dist/axes/style-architectural.d.ts

@@ -0,0 +1,2 @@
+import type { Term } from "../term.js";
+export declare const STYLE_ARCHITECTURAL_TERMS: readonly Term[];

package/dist/axes/style-shared.d.ts

@@ -0,0 +1,8 @@
+import type { ExternalMapping, MatchStrength, StyleKind, TermRelation } from "../term.js";
+export declare const PLATFORM_STYLES_SOURCE = "STYLES in an architecture-projects platform (src-01)";
+export declare const SNAPSHOT = "2026-08-21";
+export declare const MOVEMENT: StyleKind;
+export declare const aat: (slug: string, label: string, match: MatchStrength) => ExternalMapping;
+export declare const evokes: (target: string) => TermRelation;
+export declare const influencedBy: (target: string) => TermRelation;
+export declare const relatedTo: (target: string) => TermRelation;

package/dist/axes/typology-commercial.d.ts

@@ -0,0 +1,2 @@
+import type { Term } from "../term.js";
+export declare const TYPOLOGY_COMMERCIAL_AND_CIVIC_TERMS: readonly Term[];

package/dist/axes/typology-shared.d.ts

@@ -0,0 +1,3 @@
+import type { TermProvenance } from "../term.js";
+/** Attested by an architecture-projects platform's subtype vocabulary; the definition is authored here. */
+export declare const PROJECTS_PLATFORM: TermProvenance;

package/dist/dictionaries.d.ts

@@ -1,4 +1,4 @@
 import type { Term } from "./term.js";
 export declare const MATERIAL_FAMILY_TERMS: readonly Term[];
-export declare const SECTOR_TERMS: readonly Term[];
-export declare const APPLICATION_TERMS: readonly Term[];
+export { SECTOR_TERMS } from "./sector-terms.js";
+export { APPLICATION_TERMS } from "./application-terms.js";