@singi-labs/sifa-sdk 0.12.69 → 0.12.71

package/dist/jsonld/index.d.ts

@@ -1,13 +1,29 @@
 import { L as LocationValue } from '../index-a3xqWsNm.js';
 
+var vocabularies = {
+	schema: "https://schema.org/",
+	bibo: "http://purl.org/ontology/bibo/",
+	dcterms: "http://purl.org/dc/terms/",
+	foaf: "http://xmlns.com/foaf/0.1/",
+	org: "http://www.w3.org/ns/org#",
+	prism: "http://prismstandard.org/namespaces/basic/2.1/",
+	event: "http://purl.org/NET/c4dm/event.owl#",
+	skos: "http://www.w3.org/2004/02/skos/core#"
+};
+var document = {
+	vocabularies: vocabularies};
+
 /**
  * Reconciliation between `id.sifa.*` lexicon terms and existing RDF
  * vocabularies.
  *
- * This table is the single source of truth for "what does this lexicon field
- * mean in somebody else's vocabulary". It drives the JSON-LD emitters in this
- * module and is intended to also back a published machine-readable mapping
- * document, so the two cannot drift.
+ * The facts live in sifa-lexicons, as `x-skos:*` annotations on the lexicon
+ * defs and properties. Those annotations are published to the authority PDS,
+ * so a third party resolving `id.sifa.*` already reads them; that makes the
+ * lexicons the source of truth and `./term-mappings.json` a derived copy,
+ * refreshed by `scripts/sync-term-mappings.mjs` and drift-checked in CI.
+ *
+ * To change a mapping, change the lexicon, not this file.
  *
  * Scope note: RDF is adopted here as *vocabulary only*. Sifa records are
  * Lexicon JSON on the AT Protocol; nothing in this module changes how records
@@ -16,18 +32,10 @@ import { L as LocationValue } from '../index-a3xqWsNm.js';
  * When a term does not fit, the correct answer is `noMatch`, not a different
  * lexicon.
  */
+
 /** Vocabulary prefix -> namespace IRI. */
-declare const VOCABULARIES: {
-    readonly schema: "https://schema.org/";
-    readonly bibo: "http://purl.org/ontology/bibo/";
-    readonly dcterms: "http://purl.org/dc/terms/";
-    readonly foaf: "http://xmlns.com/foaf/0.1/";
-    readonly org: "http://www.w3.org/ns/org#";
-    readonly prism: "http://prismstandard.org/namespaces/basic/2.1/";
-    readonly event: "http://purl.org/NET/c4dm/event.owl#";
-    readonly skos: "http://www.w3.org/2004/02/skos/core#";
-};
-type VocabularyPrefix = keyof typeof VOCABULARIES;
+declare const VOCABULARIES: Readonly<Record<string, string>>;
+type VocabularyPrefix = keyof typeof document.vocabularies;
 /**
  * Strength of a mapping, using SKOS mapping relations so the table is itself
  * expressible as RDF.
@@ -47,10 +55,16 @@ interface TermMapping {
     /** CURIEs, e.g. `dcterms:title`. Empty when `match` is `noMatch`. */
     readonly terms: readonly string[];
     readonly match: MatchStrength;
-    /** Required when `match` is `noMatch`: why no term is appropriate. */
+    /** Rationale. Always present when `match` is `noMatch`. */
     readonly note?: string;
 }
-/** Every reconciliation Sifa asserts, including the deliberate non-mappings. */
+/**
+ * Every reconciliation Sifa asserts, including the deliberate non-mappings.
+ *
+ * The published document splits these into `mappings` and `unmapped`, which
+ * reads better over the wire. Callers here want one list, so they are
+ * flattened back together.
+ */
 declare const TERM_MAPPINGS: readonly TermMapping[];
 /**
  * Expand a CURIE (`dcterms:title`) to a full IRI. Returns null for an unknown