@instruments/taxonomy 4.8.5 → 5.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (53) hide show
  1. package/dist/application-shared.d.ts +5 -0
  2. package/dist/assertions.d.ts +0 -9
  3. package/dist/assessment-policy.d.ts +1 -1
  4. package/dist/authoring.d.ts +5 -5
  5. package/dist/axes/added-nov08.d.ts +4 -2
  6. package/dist/axes/authoring-shared.d.ts +18 -0
  7. package/dist/axes/axis.d.ts +2 -6
  8. package/dist/axes/construction-rigid-core.d.ts +6 -0
  9. package/dist/axes/construction-textile.d.ts +3 -0
  10. package/dist/axes/element-shared.d.ts +8 -2
  11. package/dist/axes/external-search.d.ts +13 -0
  12. package/dist/axes/finish-coatings.d.ts +5 -0
  13. package/dist/axes/finish-edge-profiles.d.ts +3 -0
  14. package/dist/axes/finish-shared.d.ts +1 -1
  15. package/dist/axes/finish-worked.d.ts +3 -0
  16. package/dist/axes/index.d.ts +3 -3
  17. package/dist/axes/installation-layout-matching.d.ts +3 -0
  18. package/dist/axes/material-composition.d.ts +2 -0
  19. package/dist/axes/material-coverage.d.ts +2 -0
  20. package/dist/axes/material-polymers-shared.d.ts +6 -1
  21. package/dist/axes/palette.d.ts +2 -15
  22. package/dist/axes/pattern-wood-figure.d.ts +3 -0
  23. package/dist/axes/period-before-1837.d.ts +2 -0
  24. package/dist/axes/period-from-1837.d.ts +2 -0
  25. package/dist/axes/period-shared.d.ts +5 -0
  26. package/dist/axes/period.d.ts +22 -7
  27. package/dist/axes/procurement.d.ts +11 -5
  28. package/dist/axes/product-category-flooring.d.ts +2 -0
  29. package/dist/axes/product-category-furnishings.d.ts +2 -0
  30. package/dist/axes/product-category-light-and-shade.d.ts +2 -0
  31. package/dist/axes/product-category-shared.d.ts +12 -1
  32. package/dist/axes/space/shared.d.ts +21 -2
  33. package/dist/axes/space.d.ts +1 -1
  34. package/dist/axes/style-from-other-axes.d.ts +2 -0
  35. package/dist/axes/style-named.d.ts +2 -0
  36. package/dist/axes/tier.d.ts +3 -9
  37. package/dist/axes/typology-shared.d.ts +2 -0
  38. package/dist/axes/typology-worship.d.ts +2 -0
  39. package/dist/canonicalization.d.ts +1 -1
  40. package/dist/crosswalks/mapping.d.ts +1 -1
  41. package/dist/estate/concepts.d.ts +1 -1
  42. package/dist/estate/decomposition.d.ts +1 -1
  43. package/dist/estate/residue-report.d.ts +1 -1
  44. package/dist/index.d.ts +1 -1
  45. package/dist/index.js +6657 -3215
  46. package/dist/match.d.ts +1 -1
  47. package/dist/meaning-priority.d.ts +12 -0
  48. package/dist/no-priority-rule-fits.d.ts +8 -0
  49. package/dist/spelling-key.d.ts +6 -0
  50. package/dist/term.d.ts +20 -16
  51. package/dist/v1.d.ts +11 -7
  52. package/package.json +1 -1
  53. package/dist/application-children-rest.d.ts +0 -2
package/dist/match.d.ts CHANGED
@@ -52,7 +52,7 @@ export interface AlternativesMatch {
52
52
  alternative: CanonicalBundle;
53
53
  match: BundleMatch;
54
54
  }
55
- /** The strongest eligible meaning wins; bundle identity makes ties deterministic. */
55
+ /** The strongest eligible reading wins; bundle identity makes ties deterministic. */
56
56
  export declare const matchAlternatives: (alternatives: CanonicalAlternatives, candidateAssertions: Iterable<string>) => AlternativesMatch;
57
57
  /** How well a candidate answered the query. `exact` matched every member, accents included. */
58
58
  export type MatchTier = "exact" | "eligible" | "relaxed";
@@ -0,0 +1,12 @@
1
+ import type { PhraseMeaning } from "./v1.js";
2
+ /** One meaning of an ambiguous phrase, and whether the phrase is that concept's own label. */
3
+ export interface MeaningCandidate {
4
+ isLabel: boolean;
5
+ target: PhraseMeaning;
6
+ }
7
+ /**
8
+ * The meaning the trade uses a phrase for first, by the corpus rules, or `undefined` when no rule
9
+ * orders the meanings. The plating exception is read before the material rule it is an exception
10
+ * to; the sheen rule comes before the label rule, which applies only when no earlier rule does.
11
+ */
12
+ export declare const primaryMeaning: (phrase: string, candidates: readonly MeaningCandidate[]) => PhraseMeaning | undefined;
@@ -0,0 +1,8 @@
1
+ /**
2
+ * Ambiguous phrases judged against the meaning-priority rules and found to fit none: no meaning
3
+ * is a material beside a color, none is a plating finish, and the phrase is the label of several
4
+ * of its concepts or of none. Listing a phrase here records that judgment, so a phrase without a
5
+ * priority is known to be decided rather than waiting. A new ambiguous phrase that no rule orders
6
+ * fails `meaning-priority.test.ts` until it is judged and added.
7
+ */
8
+ export declare const NO_PRIORITY_RULE_FITS: ReadonlySet<string>;
@@ -0,0 +1,6 @@
1
+ /**
2
+ * One key for every spelling of a phrase: accents dropped, British spelling made American, the
3
+ * last word made singular, and the words closed up, so "work surface", "work-surface" and
4
+ * "worksurface" share a key.
5
+ */
6
+ export declare const spellingKey: (phrase: string) => string;
package/dist/term.d.ts CHANGED
@@ -121,7 +121,6 @@ export interface SearchedWithout {
121
121
  /** Where the search was run, e.g. the SPARQL endpoint. */
122
122
  via: string;
123
123
  }
124
- export type TermStatus = "active" | "deprecated";
125
124
  /**
126
125
  * A band, never a count.
127
126
  *
@@ -173,7 +172,8 @@ export interface UsageWithheld {
173
172
  *
174
173
  * SIBLING SPANS ARE ALLOWED TO OVERLAP, deliberately. Georgian and Regency genuinely do. Resolving
175
174
  * "what period is 1800?" is therefore an accessor's job, not the data's - see `periodAt`, which
176
- * prefers the narrowest match and then the un-hedged one. Leaving that to each consumer would get
175
+ * prefers the narrowest match and then the un-hedged one, and takes a region where one year is a
176
+ * different period in different places. Leaving that to each consumer would get
177
177
  * it reinvented differently every time.
178
178
  */
179
179
  export interface PeriodSpan {
@@ -300,14 +300,7 @@ export interface Term {
300
300
  * term. Never set alongside `usage`.
301
301
  */
302
302
  usageWithheld?: UsageWithheld;
303
- status?: TermStatus;
304
- /**
305
- * The term that replaced this one. Required when status is "deprecated". Either a qualified
306
- * reference to a term in this corpus or, where the successor lives with another authority such
307
- * as ColorScope, that authority's permanent URI.
308
- */
309
- supersededByReference?: string;
310
- /** Why the term is deprecated, or any other governance note a reader needs. */
303
+ /** A boundary or reason a reader needs that the definition does not carry. */
311
304
  note?: string;
312
305
  }
313
306
  /**
@@ -315,7 +308,12 @@ export interface Term {
315
308
  * lives here, so `broaderSlug` never silently becomes a bag of loose associations.
316
309
  */
317
310
  export type RelationPredicate =
318
- /** This element is physically a component of that element. */
311
+ /**
312
+ * This term is physically a component of that one: a cornice of a wall on the ELEMENT axis, a
313
+ * tread of a stair on the APPLICATION axis. On the PLACE axis, this place lies within that one:
314
+ * the Cotswolds within England. On the MATERIAL axis it is a constituent that material is made
315
+ * of: cellulose is part of paper. A component is never a kind of its whole.
316
+ */
319
317
  "part-of"
320
318
  /**
321
319
  * This term is typically found in that space: a material, finish, product category, element or
@@ -323,7 +321,8 @@ export type RelationPredicate =
323
321
  * terrazzo is typically in a lobby, and a terrazzo kitchen is not a contradiction. Authored
324
322
  * where the trade would say "typically" unprompted, and absent elsewhere; absence makes no claim.
325
323
  *
326
- * A SPACE may also be typically in a TYPOLOGY: a classroom in a school, a nave in a church. It is
324
+ * A SPACE may also be typically in a TYPOLOGY: a classroom in a school, a nave in a church. A
325
+ * space carries it wherever its own definition names the building type. It is
327
326
  * the same claim one scale up, and still an occurrence, never an identity: which market a room
328
327
  * serves is `serves`, and a typology never points at a sector at all (ADR 0001).
329
328
  */
@@ -332,7 +331,7 @@ export type RelationPredicate =
332
331
  | "suitable-for"
333
332
  /**
334
333
  * The subject exists to serve that sector's market, wherever the building that contains it
335
- * stands: a hotel room in a mixed-use tower still serves hospitality, an operating room serves
334
+ * stands; a space serves a sector only when it is found there by definition: a hotel room in a mixed-use tower still serves hospitality, an operating room serves
336
335
  * healthcare whoever the landlord is. An IDENTITY claim, never an occurrence claim - "occurs
337
336
  * only in that sector" is false for almost any room (a multifamily amenity floor holds
338
337
  * restrooms, a commercial kitchen and a gym inside `sector.residential`), which is why most
@@ -341,7 +340,7 @@ export type RelationPredicate =
341
340
  * ABSENCE IS A CLAIM, NOT A GAP. A SPACE term carrying no serves edge and inheriting none
342
341
  * through `broaderSlug` asserts that no market is part of its identity: it serves whatever
343
342
  * market its project serves, and a consumer must read it as unrestricted - fail-open - never as
344
- * a restriction nobody wrote down. What makes that meaning safe is `MARKET_NEUTRAL_SPACES`
343
+ * a restriction nobody wrote down. What makes that reading safe is `MARKET_NEUTRAL_SPACES`
345
344
  * (`axes/space/market-neutral.ts`, with the authoring criterion): every SPACE term either
346
345
  * carries an edge or is registered there as reviewed-neutral, and the build fails naming any
347
346
  * term that is neither. A reviewed absence and an unreviewed one cannot be confused - the same
@@ -362,7 +361,8 @@ export type RelationPredicate =
362
361
  * This material is shelved under that material family when products made of it are retrieved.
363
362
  * A RETRIEVAL claim, never subsumption: a material family is a consumer's filter, not a level of
364
363
  * the material hierarchy, so it is never a `broaderSlug`. Authored on MATERIAL only, pointing at
365
- * MATERIAL_FAMILY only, and pinned there by test. It is authored on the highest material term it
364
+ * MATERIAL_FAMILY, or at `material.plastic`, the one grouping on the material axis that parents
365
+ * nothing, and pinned there by test. It is authored on the highest material term it
366
366
  * holds for and READ DOWN the material hierarchy: oak is shelved under Wood because wood is, and
367
367
  * oak carries no edge of its own.
368
368
  */
@@ -373,7 +373,11 @@ export type RelationPredicate =
373
373
  | "blend-of"
374
374
  /** This surface reads as a material it is not made of. */
375
375
  | "reads-as"
376
- /** Association with no stronger claim available. */
376
+ /**
377
+ * Association with no stronger claim available. SYMMETRIC: authored once, from either end, and
378
+ * published as asserted in both directions. Never authored between two terms a typed predicate
379
+ * or the hierarchy already joins.
380
+ */
377
381
  | "related-to";
378
382
  /**
379
383
  * How much of the thing a relation accounts for.
package/dist/v1.d.ts CHANGED
@@ -1,21 +1,18 @@
1
- import type { FacetHolds } from "./axes/index.js";
1
+ import type { Axis, FacetHolds } from "./axes/index.js";
2
2
  import type { ElementPlacement, ExternalMapping, ExternalScheme, PeriodSpan, RelationPredicate, SearchedWithout, StyleKind, TermProvenance, TermUsage, UsageWithheld } from "./term.js";
3
3
  export type { FacetHolds } from "./axes/index.js";
4
4
  export declare const TAXONOMY_BASE_URI: "https://taxonomy.materialinstruments.com";
5
5
  export declare const TAXONOMY_SNAPSHOT: "2026-10-02";
6
- export declare const TAXONOMY_VERSION: "4.8.5";
6
+ export declare const TAXONOMY_VERSION: "5.0.1";
7
7
  export declare const COLORSCOPE_BASE_URI: "https://colorscope.materialinstruments.com";
8
8
  export type CanonicalConceptUri = `${typeof TAXONOMY_BASE_URI}/id/${string}`;
9
9
  /** ColorScope's permanent URI for a concept it owns. */
10
10
  export type ColorScopeConceptUri = `${typeof COLORSCOPE_BASE_URI}/id/${string}`;
11
11
  /** The identity of a concept node: this corpus's own URI, or the owning authority's. */
12
12
  export type ConceptUri = CanonicalConceptUri | ColorScopeConceptUri;
13
- export type LifecycleStatus = "active" | "deprecated";
14
13
  export interface Lifecycle {
15
14
  introducedAt: string;
16
15
  reviewedAt: string;
17
- status: LifecycleStatus;
18
- supersededBy?: ConceptUri;
19
16
  }
20
17
  export interface Governance {
21
18
  explanation: string;
@@ -104,6 +101,11 @@ export interface KnowledgeGraph {
104
101
  edges: readonly KnowledgeGraphEdge[];
105
102
  nodes: readonly KnowledgeGraphNode[];
106
103
  }
104
+ /**
105
+ * Assemble the graph the given axes author. Throws, naming the edge, when a parent or a relation
106
+ * target names no concept: an edge dropped in silence is a claim nobody can read or miss.
107
+ */
108
+ export declare const buildKnowledgeGraph: (axes: readonly Axis[]) => KnowledgeGraph;
107
109
  export declare const KNOWLEDGE_GRAPH: KnowledgeGraph;
108
110
  /** Trade-usage priority; never a consumer query selection. */
109
111
  export type MeaningPriority = "primary" | "secondary";
@@ -142,9 +144,11 @@ export type PhraseEntry = (PhraseBase & {
142
144
  context: MeaningContext;
143
145
  target: PhraseMeaning;
144
146
  }[];
145
- /** An explicitly authored default meaning; never inferred from array order. */
147
+ /** The primary meaning by trade usage; never inferred from array order. */
146
148
  defaultMeaning?: PhraseMeaning;
147
149
  outcome: "ambiguous";
150
+ /** Recorded when the phrase was judged and no rule orders its meanings. */
151
+ priorityJudgment?: "no-rule-fits";
148
152
  meanings: readonly [PhraseMeaning, PhraseMeaning, ...PhraseMeaning[]];
149
153
  }) | (PhraseBase & {
150
154
  outcome: "declined";
@@ -160,5 +164,5 @@ export declare const TAXONOMY_CORPUS_METADATA: {
160
164
  readonly phraseEntryCount: number;
161
165
  readonly revision: string;
162
166
  readonly snapshot: "2026-10-02";
163
- readonly version: "4.8.5";
167
+ readonly version: "5.0.1";
164
168
  };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@instruments/taxonomy",
3
- "version": "4.8.5",
3
+ "version": "5.0.1",
4
4
  "description": "Canonical data-only interiors and architecture knowledge graph and lexical corpus.",
5
5
  "license": "SEE LICENSE IN LICENSE",
6
6
  "repository": {
@@ -1,2 +0,0 @@
1
- import type { Term } from "./term.js";
2
- export declare const APPLICATION_CHILDREN_REST: readonly Term[];