@instruments/taxonomy 1.1.6 → 1.3.0

package/dist/v1.d.ts

@@ -0,0 +1,141 @@
+import type { ElementPlacement, ExternalMapping, PeriodSpan, RelationPredicate, SearchedWithout, StyleKind, TermProvenance, TermUsage, UsageWithheld } from "./term.js";
+export declare const TAXONOMY_BASE_URI: "https://taxonomy.materialinstruments.com";
+export declare const TAXONOMY_SNAPSHOT: "2026-09-11";
+export declare const TAXONOMY_VERSION: "1.3.0";
+export type CanonicalConceptUri = `${typeof TAXONOMY_BASE_URI}/id/${string}`;
+export type LifecycleStatus = "active" | "deprecated";
+export interface Lifecycle {
+    introducedAt: string;
+    reviewedAt: string;
+    status: LifecycleStatus;
+    supersededBy?: CanonicalConceptUri;
+}
+export interface Governance {
+    explanation: string;
+    lifecycle: Lifecycle;
+    provenance: TermProvenance;
+    steward: "@instruments/taxonomy";
+}
+export interface AxisNode {
+    boundary: string;
+    gap?: string;
+    governance: Governance;
+    kind: "axis";
+    label: string;
+    lifecycle: Lifecycle;
+    order: number;
+    provenance: TermProvenance;
+    question: string;
+    slug: string;
+    status: "authored" | "declared";
+    uri: string;
+}
+export interface FacetNode {
+    axis: string;
+    governance: Governance;
+    kind: "facet";
+    label: string;
+    lifecycle: Lifecycle;
+    order: number;
+    provenance: TermProvenance;
+    slug: string;
+    uri: string;
+}
+export interface ExternalReference {
+    authority: "aat" | "uniclass" | "wikidata";
+    identifier: string;
+    label: string;
+    match: ExternalMapping["match"];
+}
+export interface ConceptNode {
+    altLabels?: readonly string[];
+    axis: string;
+    definition?: string;
+    externalReferences?: readonly ExternalReference[];
+    facet: string;
+    governance: Governance;
+    governedBy: "taxonomy";
+    kind: "concept";
+    label: string;
+    lifecycle: Lifecycle;
+    note?: string;
+    order: number;
+    placement?: ElementPlacement;
+    provenance: TermProvenance;
+    rank?: number;
+    searchedWithout?: readonly SearchedWithout[];
+    seenAs?: readonly string[];
+    slug: string;
+    span?: PeriodSpan;
+    styleKind?: StyleKind;
+    uri: CanonicalConceptUri;
+    usage?: TermUsage;
+    usageWithheld?: UsageWithheld;
+}
+export type KnowledgeGraphNode = AxisNode | FacetNode | ConceptNode;
+export type GraphPredicate = RelationPredicate | "belongs-to-axis" | "belongs-to-facet" | "broader" | "narrower" | "has-concept" | "has-facet" | "has-part" | "typically-contains" | "supported-by" | "served-by" | "evoked-by" | "influences" | "blended-into" | "reading-of";
+export interface KnowledgeGraphEdge {
+    assertion: "asserted" | "inverse";
+    from: string;
+    governance: Governance;
+    lifecycle: Lifecycle;
+    predicate: GraphPredicate;
+    provenance: TermProvenance;
+    role?: "constitutive" | "accent";
+    to: string;
+}
+export interface KnowledgeGraph {
+    edges: readonly KnowledgeGraphEdge[];
+    nodes: readonly KnowledgeGraphNode[];
+}
+export declare const KNOWLEDGE_GRAPH: KnowledgeGraph;
+export interface TaxonomyTarget {
+    authority: "taxonomy";
+    role?: "primary" | "secondary";
+    uri: CanonicalConceptUri;
+}
+export declare const COLOR_SCOPE_REFERENCE_KINDS: readonly ["chroma-level", "color-family", "lightness-level", "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";
+    identifier: string;
+    referenceKind: ColorScopeReferenceKind;
+    role?: "primary" | "secondary";
+}
+export type LexicalTarget = TaxonomyTarget | ColorScopeTarget;
+export type LexicalContext = "colour" | "material";
+interface LexicalBase {
+    explanation: string;
+    governance: Governance;
+    phrase: string;
+}
+export type LexicalEntry = (LexicalBase & {
+    outcome: "equivalent";
+    target: LexicalTarget;
+}) | (LexicalBase & {
+    contextualPreferences?: readonly {
+        context: LexicalContext;
+        target: LexicalTarget;
+    }[];
+    /** An explicitly authored default reading; never inferred from array order. */
+    defaultTarget?: LexicalTarget;
+    outcome: "ambiguous";
+    readings: readonly [LexicalTarget, LexicalTarget, ...LexicalTarget[]];
+}) | (LexicalBase & {
+    outcome: "declined";
+    reason: string;
+});
+/** Declarative readings only. Consumers choose indexing and application behaviour. */
+export declare const LEXICAL_ENTRIES: readonly LexicalEntry[];
+/** Content address for CI drift checks; changes whenever the public corpus representation changes. */
+export declare const TAXONOMY_CORPUS_REVISION: string;
+export declare const TAXONOMY_CORPUS_METADATA: {
+    readonly edgeCount: number;
+    readonly lexicalEntryCount: number;
+    readonly nodeCount: number;
+    readonly revision: string;
+    readonly snapshot: "2026-09-11";
+    readonly version: "1.3.0";
+};
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@instruments/taxonomy",
-  "version": "1.1.6",
+  "version": "1.3.0",
   "description": "Canonical data-only interiors and architecture knowledge graph and lexical corpus.",
   "license": "SEE LICENSE IN LICENSE",
   "repository": {
@@ -23,21 +23,21 @@
   "publishConfig": {
     "access": "public"
   },
+  "devDependencies": {
+    "@howells/lint": "^2.2.0",
+    "@instruments/colorscope": "7.6.0",
+    "@taxonomy/lint-policy": "npm:@howells/lint@1.0.0",
+    "@types/node": "^26.4.1",
+    "tsup": "^8.5.1",
+    "typescript": "^7.0.2",
+    "vitest": "^5.0.0"
+  },
   "scripts": {
-    "build": "rm -rf dist && tsup",
-    "lint": "howells-check .",
-    "prepare": "pnpm build",
+    "build": "tsup && tsc -p tsconfig.build.json && node ../../scripts/finalize-declarations.mjs dist",
+    "lint": "node node_modules/@howells/lint/bin/howells-check.mjs .",
     "smoke:packed": "node --experimental-strip-types scripts/smoke-packed-core.ts",
     "sync:colorscope": "vitest run src/colorscope-sync.test.ts",
     "test": "vitest run",
     "typecheck": "tsc --noEmit"
-  },
-  "devDependencies": {
-    "@howells/lint": "^1.0.0",
-    "@instruments/colorscope": "7.3.0",
-    "@types/node": "^24.0.0",
-    "tsup": "^8.5.1",
-    "typescript": "^5.7.0",
-    "vitest": "^4.0.0"
   }
-}
+}