@instruments/taxonomy 5.2.0 → 5.4.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/term.d.ts CHANGED
@@ -26,7 +26,30 @@ export type ExternalScheme =
26
26
  /** Unified Numbering System for metals and alloys. Referenced by number. */
27
27
  | "uns"
28
28
  /** EN 10027-2 steel numbers and EN 573-3 aluminum designations. Referenced by designation. */
29
- | "en";
29
+ | "en"
30
+ /**
31
+ * LEED 2009 credits, by the numbered code USGBC's 2009 rating systems give them, such as MRc4.
32
+ * USGBC's copyright; referenced by code and credit name, never adapted.
33
+ */
34
+ | "leed-2009"
35
+ /**
36
+ * LEED v4 credits. USGBC numbers no v4 credit, so the identifier is the category-and-type prefix
37
+ * USGBC writes before the credit name, with that name: `MRc Building Life-Cycle Impact
38
+ * Reduction`. USGBC's copyright; referenced by name, never adapted.
39
+ */
40
+ | "leed-v4"
41
+ /**
42
+ * LEED v4.1 credits, identified as LEED v4 credits are, and the product categories a credit counts,
43
+ * identified by the credit, a slash and the category's name: `EQc Low-Emitting Materials /
44
+ * Wall panels`. USGBC's copyright; referenced by name, never adapted.
45
+ */
46
+ | "leed-v4.1"
47
+ /**
48
+ * LEED v5 credits, by the numbered code USGBC's v5 rating systems give them, such as MRc4, and the
49
+ * product categories a credit counts, by the code, a slash and the category's name: `MRc3 /
50
+ * Walls`. USGBC's copyright; referenced by code and name, never adapted.
51
+ */
52
+ | "leed-v5";
30
53
  /**
31
54
  * SKOS mapping strength, using SKOS's own vocabulary so the published RDF is a direct rendering
32
55
  * rather than a translation. `exact` asserts the two terms are interchangeable in retrieval;
@@ -286,7 +309,9 @@ export type RelationPredicate =
286
309
  * This term is physically a component of that one: a cornice of a wall on the ELEMENT axis, a
287
310
  * tread of a stair on the APPLICATION axis. On the PLACE axis, this place lies within that one:
288
311
  * the Cotswolds within England. On the MATERIAL axis it is a constituent that material is made
289
- * of: cellulose is part of paper. A component is never a kind of its whole.
312
+ * of: cellulose is part of paper. On the CERTIFICATION axis it is a credit of the rating system
313
+ * that awards it: Low-emitting materials is part of LEED. A component is never a kind of its
314
+ * whole.
290
315
  */
291
316
  "part-of"
292
317
  /**
package/dist/v1.d.ts CHANGED
@@ -2,7 +2,7 @@ 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_SNAPSHOT: "2026-10-02";
5
- export declare const TAXONOMY_VERSION: "5.2.0";
5
+ export declare const TAXONOMY_VERSION: "5.4.0";
6
6
  export declare const COLORSCOPE_BASE_URI: "https://colorscope.materialinstruments.com";
7
7
  export type ConceptId = string;
8
8
  /** ColorScope's permanent URI for a concept it owns. */
@@ -158,5 +158,5 @@ export declare const TAXONOMY_CORPUS_METADATA: {
158
158
  readonly phraseEntryCount: number;
159
159
  readonly revision: string;
160
160
  readonly snapshot: "2026-10-02";
161
- readonly version: "5.2.0";
161
+ readonly version: "5.4.0";
162
162
  };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@instruments/taxonomy",
3
- "version": "5.2.0",
3
+ "version": "5.4.0",
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,44 +0,0 @@
1
- import type { CanonicalAlternatives, CanonicalBundle } from "./match.js";
2
- import type { AssertionMeaning, AssertionProvenance } from "./taste-assertion.js";
3
- import type { MatchStrength } from "./term.js";
4
- export interface CanonicalizationInput {
5
- sourceSystem: string;
6
- sourceField: string;
7
- sourceValue: string;
8
- provenance: AssertionProvenance;
9
- }
10
- interface CanonicalizationBase extends CanonicalizationInput {
11
- crosswalkVersion: string;
12
- taxonomySnapshotVersion: string;
13
- }
14
- export interface ResolvedCanonicalization extends CanonicalizationBase {
15
- status: "resolved";
16
- canonical: CanonicalBundle;
17
- /**
18
- * How strongly the canonical bundle stands for the source value, in SKOS's own vocabulary. A
19
- * consumer may treat `exact` as an identity and must treat everything else as an approximation
20
- * it has been told about. See `crosswalks/strength.ts` for the direction convention.
21
- */
22
- match: MatchStrength;
23
- /** Why the row is not exact. Present whenever `match` is not `exact`. */
24
- note?: string;
25
- }
26
- export interface AmbiguousCanonicalization extends CanonicalizationBase {
27
- status: "ambiguous";
28
- alternatives: CanonicalAlternatives;
29
- /** How strongly each alternative would stand for the source value, were it the right reading. */
30
- match: MatchStrength;
31
- note?: string;
32
- }
33
- export interface UnresolvedCanonicalization extends CanonicalizationBase {
34
- status: "unresolved";
35
- }
36
- export interface DeclinedCanonicalization extends CanonicalizationBase {
37
- status: "declined";
38
- reason: string;
39
- }
40
- /** Four honest outcomes: absence of a mapping is never silently treated as a decline or a match. */
41
- export type CanonicalizationVerdict = ResolvedCanonicalization | AmbiguousCanonicalization | UnresolvedCanonicalization | DeclinedCanonicalization;
42
- /** Convert a usable verdict to assertion meaning; a declined value does not assert anything. */
43
- export declare const assertionMeaningFrom: (verdict: CanonicalizationVerdict) => AssertionMeaning | null;
44
- export {};
@@ -1,112 +0,0 @@
1
- import type { CanonicalAlternatives, CanonicalBundle } from "./match.js";
2
- export declare const TASTE_ASSERTION_CONTRACT_VERSION: "1.0.0";
3
- export declare const TAXONOMY_SNAPSHOT_VERSION: "2026-08-31";
4
- export type AssertionRole = "taste" | "project_context" | "requirement";
5
- export type AssertionAuthority = "explicit" | "behavioral" | "inferred";
6
- export type AssertionPolarity = "positive" | "negative" | "never";
7
- export type AssertionScope = {
8
- kind: "person";
9
- } | {
10
- kind: "household";
11
- householdId: string;
12
- } | {
13
- kind: "project";
14
- projectId: string;
15
- } | {
16
- kind: "room_type";
17
- roomTypeId: string;
18
- } | {
19
- kind: "room";
20
- roomId: string;
21
- } | {
22
- kind: "surface";
23
- roomId: string;
24
- surfaceId: string;
25
- };
26
- export interface AssertionProvenance {
27
- /** The application, import or instrument that produced the observation. */
28
- sourceSystem: string;
29
- /** Version of the source data, prompt, fixture or export used when the evidence was observed. */
30
- sourceSnapshotVersion: string;
31
- sourceRecordId?: string;
32
- sourceUrl?: string;
33
- /** Optional id for the observation from which this assertion was proposed. */
34
- observationId?: string;
35
- }
36
- interface SourceMeaning {
37
- /** Source vocabulary field, before canonicalization. */
38
- sourceField: string;
39
- /** Verbatim source value; never replaced by the canonical label. */
40
- sourceValue: string;
41
- /** Version of the source-specific mapping policy. */
42
- crosswalkVersion: string;
43
- /** Version of the canonical vocabulary against which mapping ran. */
44
- taxonomySnapshotVersion: string;
45
- }
46
- export interface ResolvedAssertionMeaning extends SourceMeaning {
47
- kind: "resolved";
48
- canonical: CanonicalBundle;
49
- }
50
- export interface AmbiguousAssertionMeaning extends SourceMeaning {
51
- kind: "ambiguous";
52
- alternatives: CanonicalAlternatives;
53
- }
54
- export interface UnresolvedAssertionMeaning extends SourceMeaning {
55
- kind: "unresolved";
56
- }
57
- export type AssertionMeaning = ResolvedAssertionMeaning | AmbiguousAssertionMeaning | UnresolvedAssertionMeaning;
58
- interface PortableAssertionBase {
59
- /** Stable application-owned identifier for this assertion event. */
60
- id: string;
61
- contractVersion: typeof TASTE_ASSERTION_CONTRACT_VERSION;
62
- actorId: string;
63
- /** Whose taste or project view the assertion describes; never inferred from actorId. */
64
- subjectId: string;
65
- /** Project context is explicit even when the assertion's scope is durable and personal. */
66
- projectId: string;
67
- authority: AssertionAuthority;
68
- polarity: AssertionPolarity;
69
- scope: AssertionScope;
70
- meaning: AssertionMeaning;
71
- provenance: AssertionProvenance;
72
- observedAt: string;
73
- confirmedAt?: string;
74
- validFrom?: string;
75
- validUntil?: string;
76
- /** Logical withdrawal is append-only; physical privacy deletion is an application concern. */
77
- retractedAt?: string;
78
- supersedesAssertionId?: string;
79
- }
80
- export interface TasteAssertion extends PortableAssertionBase {
81
- role: "taste";
82
- }
83
- export interface ProjectContextAssertion extends PortableAssertionBase {
84
- role: "project_context";
85
- }
86
- export type RequirementOperator = "equals" | "not_equals" | "at_least" | "at_most" | "includes" | "excludes";
87
- export interface RequirementConstraint {
88
- operator: RequirementOperator;
89
- value: boolean | number | string;
90
- unit?: string;
91
- }
92
- export interface RequirementAssertion extends PortableAssertionBase {
93
- role: "requirement";
94
- /** The dimension is canonical meaning; the source-owned required value remains typed here. */
95
- constraint: RequirementConstraint;
96
- }
97
- /** Portable evidence semantics only. Ranking weights and serving policy belong to each consumer. */
98
- export type PortableTasteAssertion = TasteAssertion | ProjectContextAssertion | RequirementAssertion;
99
- export interface PortableAssertionTestVector {
100
- assertion: PortableTasteAssertion;
101
- id: string;
102
- expected: {
103
- actorId: string;
104
- subjectId: string;
105
- projectId: string;
106
- role: AssertionRole;
107
- meaningKind: AssertionMeaning["kind"];
108
- };
109
- }
110
- /** Executable fixtures for consumers serializing the portable envelope in another repository. */
111
- export declare const PORTABLE_ASSERTION_TEST_VECTORS: readonly PortableAssertionTestVector[];
112
- export {};
package/dist/taste.d.ts DELETED
@@ -1,2 +0,0 @@
1
- export { assertionMeaningFrom, type AmbiguousCanonicalization, type CanonicalizationInput, type CanonicalizationVerdict, type DeclinedCanonicalization, type ResolvedCanonicalization, type UnresolvedCanonicalization, } from "./canonicalization.js";
2
- export { type AmbiguousAssertionMeaning, type AssertionAuthority, type AssertionMeaning, type AssertionPolarity, type AssertionProvenance, type AssertionRole, type AssertionScope, type PortableAssertionTestVector, type PortableTasteAssertion, PORTABLE_ASSERTION_TEST_VECTORS, type ProjectContextAssertion, type RequirementAssertion, type RequirementConstraint, type RequirementOperator, type ResolvedAssertionMeaning, TAXONOMY_SNAPSHOT_VERSION, TASTE_ASSERTION_CONTRACT_VERSION, type TasteAssertion, type UnresolvedAssertionMeaning, } from "./taste-assertion.js";