@instruments/taxonomy 4.8.4 → 5.0.0
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.
- package/dist/application-shared.d.ts +5 -0
- package/dist/assertions.d.ts +0 -9
- package/dist/assessment-policy.d.ts +1 -1
- package/dist/authoring.d.ts +5 -5
- package/dist/axes/added-nov08.d.ts +4 -2
- package/dist/axes/authoring-shared.d.ts +18 -0
- package/dist/axes/axis.d.ts +2 -6
- package/dist/axes/construction-rigid-core.d.ts +6 -0
- package/dist/axes/construction-textile.d.ts +3 -0
- package/dist/axes/element-shared.d.ts +8 -2
- package/dist/axes/external-search.d.ts +13 -0
- package/dist/axes/finish-coatings.d.ts +5 -0
- package/dist/axes/finish-edge-profiles.d.ts +3 -0
- package/dist/axes/finish-shared.d.ts +1 -1
- package/dist/axes/finish-worked.d.ts +3 -0
- package/dist/axes/index.d.ts +3 -3
- package/dist/axes/installation-layout-matching.d.ts +3 -0
- package/dist/axes/material-composition.d.ts +2 -0
- package/dist/axes/material-coverage.d.ts +2 -0
- package/dist/axes/material-polymers-shared.d.ts +6 -1
- package/dist/axes/palette.d.ts +2 -15
- package/dist/axes/pattern-wood-figure.d.ts +3 -0
- package/dist/axes/period-before-1837.d.ts +2 -0
- package/dist/axes/period-from-1837.d.ts +2 -0
- package/dist/axes/period-shared.d.ts +5 -0
- package/dist/axes/period.d.ts +22 -7
- package/dist/axes/procurement.d.ts +11 -5
- package/dist/axes/product-category-flooring.d.ts +2 -0
- package/dist/axes/product-category-furnishings.d.ts +2 -0
- package/dist/axes/product-category-light-and-shade.d.ts +2 -0
- package/dist/axes/product-category-shared.d.ts +12 -1
- package/dist/axes/space/shared.d.ts +21 -2
- package/dist/axes/space.d.ts +1 -1
- package/dist/axes/style-from-other-axes.d.ts +2 -0
- package/dist/axes/style-named.d.ts +2 -0
- package/dist/axes/tier.d.ts +3 -9
- package/dist/axes/typology-shared.d.ts +2 -0
- package/dist/axes/typology-worship.d.ts +2 -0
- package/dist/canonicalization.d.ts +1 -1
- package/dist/crosswalks/mapping.d.ts +1 -1
- package/dist/estate/concepts.d.ts +1 -1
- package/dist/estate/decomposition.d.ts +1 -1
- package/dist/estate/residue-report.d.ts +1 -1
- package/dist/index.d.ts +1 -1
- package/dist/index.js +6655 -3218
- package/dist/match.d.ts +1 -1
- package/dist/meaning-priority.d.ts +12 -0
- package/dist/no-priority-rule-fits.d.ts +8 -0
- package/dist/spelling-key.d.ts +6 -0
- package/dist/term.d.ts +20 -16
- package/dist/v1.d.ts +11 -7
- package/package.json +1 -1
- 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
|
|
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 label rule applies only when neither names a material.
|
|
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
|
|
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
|
-
|
|
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
|
-
/**
|
|
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.
|
|
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
|
|
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
|
|
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
|
-
/**
|
|
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: "
|
|
6
|
+
export declare const TAXONOMY_VERSION: "5.0.0";
|
|
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
|
-
/**
|
|
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: "
|
|
167
|
+
readonly version: "5.0.0";
|
|
164
168
|
};
|
package/package.json
CHANGED