@instruments/taxonomy 2.6.0 → 2.8.0

package/dist/term.d.ts

@@ -74,20 +74,28 @@ export interface TermProvenance {
 /**
  * A canonical identity governed by ColorScope rather than Taxonomy.
  *
- * This is authored data, not an inference from provenance prose. A vendored source explains where
- * a row came from; it does not by itself decide which package owns the durable identifier.
+ * This is data copied from ColorScope, not an inference from provenance prose. A term carrying it
+ * has ColorScope's own permanent URI as its identity: Taxonomy lists the term so that anything in
+ * the graph can relate to it, and never defines it.
  */
 export interface ColorScopeAuthority {
     authority: "colorscope";
     authorityUri: "https://colorscope.materialinstruments.com";
     identifier: string;
     referenceKind: keyof ColorScopeReferenceKinds;
+    /** ColorScope's permanent URI for the concept. */
+    uri: string;
 }
 interface ColorScopeReferenceKinds {
+    /** ColorScope's `basic-tone` concepts: light, mid, dark, muted, vivid. */
+    "basic-tone": true;
     "chroma-level": true;
     "color-family": true;
     "lightness-level": true;
+    /** ColorScope's `modifier` concepts, such as washed. */
+    modifier: true;
     "named-color": true;
+    /** ColorScope's `palette` concepts, which read as palette compositions. */
     "palette-mood": true;
     "temperature-level": true;
 }
@@ -231,6 +239,8 @@ export interface Term {
     label: string;
     /** Present when another package, currently ColorScope, owns this term's canonical identity. */
     canonicalAuthority?: ColorScopeAuthority;
+    /** A representative sRGB colour, copied from the owning authority. Present on some ColorScope terms only. */
+    hex?: string;
     /**
      * Parent term id. Carries TAXONOMIC SUBSUMPTION ONLY - every instance of this term must be an
      * instance of the parent. Part-of, used-in, typically-found-in and evokes are relations, and
@@ -291,7 +301,11 @@ export interface Term {
      */
     usageWithheld?: UsageWithheld;
     status?: TermStatus;
-    /** The term that replaced this one. Required when status is "deprecated". */
+    /**
+     * The term that replaced this one. Required when status is "deprecated". Either a qualified
+     * reference to a term in this corpus or, where the successor lives with another authority such
+     * as ColorScope, that authority's permanent URI.
+     */
     supersededByReference?: string;
     /** Why the term is deprecated, or any other governance note a reader needs. */
     note?: string;

package/dist/v1.d.ts

@@ -3,20 +3,26 @@ import type { ElementPlacement, ExternalMapping, ExternalScheme, PeriodSpan, Rel
 export type { FacetHolds } from "./axes/index.js";
 export declare const TAXONOMY_BASE_URI: "https://taxonomy.materialinstruments.com";
 export declare const TAXONOMY_SNAPSHOT: "2026-10-02";
-export declare const TAXONOMY_VERSION: "2.6.0";
+export declare const TAXONOMY_VERSION: "2.8.0";
+export declare const COLORSCOPE_BASE_URI: "https://colorscope.materialinstruments.com";
 export type CanonicalConceptUri = `${typeof TAXONOMY_BASE_URI}/id/${string}`;
+/** ColorScope's permanent URI for a concept it owns. */
+export type ColorScopeConceptUri = `${typeof COLORSCOPE_BASE_URI}/id/${string}`;
+/** The identity of a concept node: this corpus's own URI, or the owning authority's. */
+export type ConceptUri = CanonicalConceptUri | ColorScopeConceptUri;
 export type LifecycleStatus = "active" | "deprecated";
 export interface Lifecycle {
     introducedAt: string;
     reviewedAt: string;
     status: LifecycleStatus;
-    supersededBy?: CanonicalConceptUri;
+    supersededBy?: ConceptUri;
 }
 export interface Governance {
     explanation: string;
     lifecycle: Lifecycle;
     provenance: TermProvenance;
-    steward: "@instruments/taxonomy";
+    /** Who owns the thing described: Taxonomy, or ColorScope for the colour concepts it lists. */
+    steward: "@instruments/taxonomy" | "@materialinstruments/colorscope";
 }
 export interface AxisNode {
     boundary: string;
@@ -58,7 +64,13 @@ export interface ConceptNode {
     externalReferences?: readonly ExternalReference[];
     facet: string;
     governance: Governance;
-    governedBy: "taxonomy";
+    /**
+     * Who owns the concept. `colorscope` marks a colour concept Taxonomy lists but does not define:
+     * its `uri` is ColorScope's own permanent URI, and its meaning is ColorScope's.
+     */
+    governedBy: "taxonomy" | "colorscope";
+    /** A representative sRGB colour, copied from ColorScope. Present on colour families only. */
+    hex?: string;
     kind: "concept";
     label: string;
     lifecycle: Lifecycle;
@@ -72,7 +84,7 @@ export interface ConceptNode {
     slug: string;
     span?: PeriodSpan;
     styleKind?: StyleKind;
-    uri: CanonicalConceptUri;
+    uri: ConceptUri;
     usage?: TermUsage;
     usageWithheld?: UsageWithheld;
 }
@@ -100,14 +112,20 @@ export interface TaxonomyTarget {
     meaningPriority?: MeaningPriority;
     uri: CanonicalConceptUri;
 }
-export declare const COLOR_SCOPE_REFERENCE_KINDS: readonly ["chroma-level", "color-family", "lightness-level", "named-color", "palette-mood", "temperature-level"];
+export declare const COLOR_SCOPE_REFERENCE_KINDS: readonly ["basic-tone", "chroma-level", "color-family", "lightness-level", "modifier", "named-color", "palette-mood", "temperature-level"];
 export type ColorScopeReferenceKind = (typeof COLOR_SCOPE_REFERENCE_KINDS)[number];
 export interface ColorScopeTarget {
     authority: "colorscope";
-    authorityUri: "https://colorscope.materialinstruments.com";
+    authorityUri: typeof COLORSCOPE_BASE_URI;
     identifier: string;
     referenceKind: ColorScopeReferenceKind;
     meaningPriority?: MeaningPriority;
+    /**
+     * ColorScope's permanent URI for the concept. For a family, temperature level, basic tone or
+     * palette composition this is also the URI of a node in this graph; a named colour has no node
+     * here and is read at ColorScope.
+     */
+    uri: ColorScopeConceptUri;
 }
 export type PhraseMeaning = TaxonomyTarget | ColorScopeTarget;
 export type MeaningContext = "color" | "material";
@@ -142,5 +160,5 @@ export declare const TAXONOMY_CORPUS_METADATA: {
     readonly phraseEntryCount: number;
     readonly revision: string;
     readonly snapshot: "2026-10-02";
-    readonly version: "2.6.0";
+    readonly version: "2.8.0";
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@instruments/taxonomy",
-  "version": "2.6.0",
+  "version": "2.8.0",
   "description": "Canonical data-only interiors and architecture knowledge graph and lexical corpus.",
   "license": "SEE LICENSE IN LICENSE",
   "repository": {
@@ -25,7 +25,7 @@
   },
   "devDependencies": {
     "@howells/lint": "^3.5.1",
-    "@materialinstruments/colorscope": "10.2.1",
+    "@materialinstruments/colorscope": "10.4.0",
     "@taxonomy/lint-policy": "npm:@howells/lint@1.0.0",
     "@types/node": "^26.6.2",
     "tsup": "^8.5.1",
@@ -34,6 +34,7 @@
   },
   "scripts": {
     "build": "tsup && tsc -p tsconfig.build.json && node ../../scripts/finalize-declarations.mjs dist",
+    "generate:colour-layer": "node scripts/generate-colour-layer.mjs",
     "lint": "node node_modules/@howells/lint/bin/howells-check.mjs .",
     "lint:fix": "node node_modules/@howells/lint/bin/howells-fix.mjs .",
     "test": "vitest run",